import { type Operation, type Owner } from './types.js';
import type { DeliveryTransport } from './delivery.js';
export interface RecalledMemory {
    uri: string;
    text: string;
    score: number;
}
/** No management key, caller-controlled headers or owner overrides are exposed. */
export declare class OwnerMemoryClient implements DeliveryTransport {
    #private;
    readonly owner: Owner;
    readonly scope: string | null;
    constructor(options: {
        owner: Owner;
        baseUrl: string;
        apiKey: string;
        scope?: string | null;
        timeoutMs: number;
    });
    verifyIdentity(): Promise<void>;
    createSession(id: string): Promise<void>;
    sessionExists(id: string): Promise<boolean>;
    append(operation: Readonly<Operation>): Promise<void>;
    hasSource(operation: Readonly<Operation>): Promise<boolean>;
    commit(id: string): Promise<{
        taskId: string;
        archiveId?: string;
    }>;
    findCommit(id: string): Promise<{
        taskId: string;
    } | null>;
    inspect(operation: Readonly<Operation>): ReturnType<DeliveryTransport['inspect']>;
    /** Read-only evidence that a pre-barrier writer can no longer generate data. */
    writerSettled(operation: Readonly<Operation>): Promise<boolean>;
    /** Account retirement must drain writers from every trusted peer scope. */
    writerSettledAny(operation: Readonly<Operation>): Promise<boolean>;
    /** USER keys cannot remove the namespace root. Remove verified content
     * subtrees and every global source session; peers include scoped sessions. */
    clearOwnerData(): Promise<void>;
    /** Clear only the client-bound memory tree, including its derived indexes. */
    clearMemoryScope(): Promise<void>;
    /** Transport only: the host must persist its governance barrier and drain writers first. */
    replaceMemory(uri: string, content: string): Promise<void>;
    /** Remove one document, never a caller-selected directory or derived metadata file. */
    removeMemory(uri: string): Promise<void>;
    /** A source can be removed only through an owner/scope-bound durable operation. */
    removeSource(operation: Readonly<Operation>): Promise<void>;
    readMemory(uri: string): Promise<string>;
    /** Bound the HTTP response before decoding JSON; stat is only a preflight hint. */
    readMemoryLimited(uri: string, maxBytes: number): Promise<string>;
    memoryDocumentSize(uri: string): Promise<number>;
    /** Enumerate only document URIs under this credential's trusted scope. */
    listMemoryDocuments(): Promise<string[]>;
    recall(query: string, limit: number, signal?: AbortSignal): Promise<RecalledMemory[]>;
}