import type { HttpClient } from "../core/http.js";
import type { Peer, PeerWithFacts, CreatePeerRequest, PeerContextResponse, PredictApprovalRequest, PredictApprovalResponse, OneclawResponse } from "../types.js";
/**
 * Peer memory — a shared model of one human, across the agents serving them.
 *
 * An agent reaches a peer only by being named in its observer list. Being in
 * the same organisation, or the same platform connection, grants nothing.
 */
export declare class PeersResource {
    private readonly http;
    constructor(http: HttpClient);
    /**
     * Create a peer and name its observers. Human users only — this decides
     * which agents may read a model of a person.
     *
     * Idempotent by `(peer_type, peer_ref)`; observers merge rather than
     * replace, so a second call does not revoke agents already watching.
     */
    create(body: CreatePeerRequest): Promise<OneclawResponse<{
        peer: Peer;
    }>>;
    get(peerId: string): Promise<OneclawResponse<PeerWithFacts>>;
    /**
     * A blob for prompt injection. Best-supported facts first, so a tight
     * budget drops the least-supported beliefs — and a human-corrected fact is
     * the last thing cut.
     *
     * Empty when nothing has been derived yet, rather than a header describing
     * nobody.
     */
    getContext(peerId: string, budget?: number): Promise<OneclawResponse<PeerContextResponse>>;
    /** Record something observed: a message, an approval, an action. */
    recordEvent(peerId: string, eventType: "message" | "approval" | "action" | "observation", content: Record<string, unknown>): Promise<OneclawResponse<{
        event_id: string;
    }>>;
    /**
     * How has this person decided this before, and does policy already permit
     * it automatically?
     *
     * These are two different questions. `likelihood` is an observation about a
     * person; `suggest_auto` is a statement about your own
     * `action_approval_policy`. A confident prediction never becomes new
     * authority — if no rule covers the action, `suggest_auto` is false with
     * `blocked_reason: "no_matching_rule"`.
     */
    predictApproval(peerId: string, body: PredictApprovalRequest): Promise<OneclawResponse<PredictApprovalResponse>>;
    /** Resolve the peer for a platform connection. */
    getByConnection(connectionId: string): Promise<OneclawResponse<{
        peer: Peer;
    }>>;
    /**
     * An agent's own peer context, resolved from its platform connection.
     * An agent may only ask for its own.
     */
    getAgentContext(agentId: string, budget?: number): Promise<OneclawResponse<PeerContextResponse & {
        peer_id: string;
    }>>;
}
//# sourceMappingURL=peers.d.ts.map