import * as s from '../schemas';
import type { Transport } from './transport';
/**
 * The client-facing write body for a state declaration (`PUT /api/states/{name}`), the
 * wire shape of `tai42_contract.states.StateDeclaration` minus the platform-computed
 * `effective_schema`/`regimes` (those are read-only, refused on a write). `schema` is the
 * `TemplatedText | dict` union: an inline JSON-schema object, or a stored template reference
 * (`id` + render `kwargs`) the platform renders to the schema. `retention_days` is `null` to
 * keep records forever.
 */
export interface StateDeclarationBody {
    readonly name: string;
    readonly description?: string;
    readonly schema: s.TemplatedText | Record<string, unknown>;
    readonly subject_kinds: readonly string[];
    readonly default_subject_kind: string;
    readonly retention_days?: number | null;
}
/**
 * A state-template document write body (`PUT /api/state-templates/{name}`, the platform half).
 * `schema` is the `TemplatedText | dict` union — an inline fragment schema, or a stored
 * template reference the platform renders to the fragment.
 */
export interface StateTemplateBody {
    readonly name: string;
    readonly description?: string;
    readonly parameters?: Record<string, unknown>;
    readonly schema: s.TemplatedText | Record<string, unknown>;
    readonly regimes?: Record<string, unknown>[];
    readonly declarations?: Record<string, unknown> | null;
    readonly trace?: Record<string, unknown>;
}
/** A template attach / re-attach body (`PUT|PATCH /api/states/{name}/attachments/{template}`). */
export interface StateAttachmentBody {
    readonly path?: string[];
    readonly parameters?: Record<string, unknown>;
    readonly declarations?: Record<string, unknown>;
    readonly options?: Record<string, unknown>;
}
/** The four-part subject a record route addresses in its path. */
export interface StateSubjectRef {
    readonly target_kind: string;
    readonly target_name: string;
    readonly kind: string;
    readonly key: string;
}
/** A keyset page request: an optional size and the opaque cursor a prior page returned. */
export interface StatePageQuery {
    readonly limit?: number;
    readonly cursor?: string;
}
export declare function statesClient(t: Transport): {
    listStates: (signal?: AbortSignal) => Promise<{
        default_subject_kind: string;
        description: string;
        effective_schema: Record<string, unknown> | null;
        name: string;
        regimes: Record<string, unknown>[] | null;
        retention_days: number | null;
        subject_kinds: string[];
        updated_at: string | null;
        schema?: Record<string, unknown> | {
            content?: string | undefined;
            id?: string | undefined;
            kwargs?: Record<string, unknown> | undefined;
        } | undefined;
    }[]>;
    getState: (name: string, signal?: AbortSignal) => Promise<{
        default_subject_kind: string;
        description: string;
        effective_schema: Record<string, unknown> | null;
        name: string;
        regimes: Record<string, unknown>[] | null;
        retention_days: number | null;
        subject_kinds: string[];
        updated_at: string | null;
        attachments: {
            template: string;
            path: string[];
            parameters: Record<string, unknown>;
            declarations: Record<string, unknown>;
        }[];
        schema?: Record<string, unknown> | {
            content?: string | undefined;
            id?: string | undefined;
            kwargs?: Record<string, unknown> | undefined;
        } | undefined;
    }>;
    putState: (name: string, body: StateDeclarationBody) => Promise<{
        default_subject_kind: string;
        description: string;
        effective_schema: Record<string, unknown> | null;
        name: string;
        regimes: Record<string, unknown>[] | null;
        retention_days: number | null;
        subject_kinds: string[];
        updated_at: string | null;
        attachments: {
            template: string;
            path: string[];
            parameters: Record<string, unknown>;
            declarations: Record<string, unknown>;
        }[];
        schema?: Record<string, unknown> | {
            content?: string | undefined;
            id?: string | undefined;
            kwargs?: Record<string, unknown> | undefined;
        } | undefined;
    }>;
    deleteState: (name: string) => Promise<{
        name: string;
        deleted: true;
    }>;
    getStateStats: (name: string, signal?: AbortSignal) => Promise<{
        records: number;
        per_field: Record<string, number>;
        per_kind: Record<string, number>;
        consumers: number;
    }>;
    listStateAttachments: (name: string, signal?: AbortSignal) => Promise<{
        template: string;
        path: string[];
        parameters: Record<string, unknown>;
        declarations: Record<string, unknown>;
    }[]>;
    getStateAttachment: (name: string, template: string, signal?: AbortSignal) => Promise<{
        template: string;
        path: string[];
        parameters: Record<string, unknown>;
        declarations: Record<string, unknown>;
    }>;
    attachStateTemplate: (name: string, template: string, body: StateAttachmentBody) => Promise<{
        attached: true;
        state: string;
        template: string;
    }>;
    patchStateAttachment: (name: string, template: string, body: StateAttachmentBody) => Promise<{
        updated: true;
        state: string;
        template: string;
    }>;
    detachStateTemplate: (name: string, template: string) => Promise<{
        detached: true;
        state: string;
        template: string;
    }>;
    listStateSubjects: (name: string, params: {
        kind?: string;
    } & StatePageQuery, signal?: AbortSignal) => Promise<{
        subjects: {
            subject: {
                target_kind: "tool" | "agent";
                target_name: string;
                kind: string;
                key: string;
            };
            updated_at: number;
        }[];
        next_cursor: string | null;
    }>;
    searchStateRecords: (name: string, body: {
        filters: Record<string, unknown>;
    } & StatePageQuery, signal?: AbortSignal) => Promise<{
        matches: {
            subject: {
                target_kind: "tool" | "agent";
                target_name: string;
                kind: string;
                key: string;
            };
            updated_at: number;
        }[];
        next_cursor: string | null;
    }>;
    getStateRecord: (name: string, subject: StateSubjectRef, signal?: AbortSignal) => Promise<{
        state: string;
        subject: {
            target_kind: "tool" | "agent";
            target_name: string;
            kind: string;
            key: string;
        };
        data: Record<string, unknown>;
        seq: number;
        canonical_subject: {
            target_kind: "tool" | "agent";
            target_name: string;
            kind: string;
            key: string;
        };
        folded_from: {
            target_kind: "tool" | "agent";
            target_name: string;
            kind: string;
            key: string;
        }[];
    } | null>;
    putStateRecord: (name: string, subject: StateSubjectRef, data: Record<string, unknown>) => Promise<{
        state: string;
        subject: {
            target_kind: "tool" | "agent";
            target_name: string;
            kind: string;
            key: string;
        };
        data: Record<string, unknown>;
        seq: number;
        canonical_subject: {
            target_kind: "tool" | "agent";
            target_name: string;
            kind: string;
            key: string;
        };
        folded_from: {
            target_kind: "tool" | "agent";
            target_name: string;
            kind: string;
            key: string;
        }[];
    }>;
    patchStateRecord: (name: string, subject: StateSubjectRef, data: Record<string, unknown>) => Promise<{
        state: string;
        subject: {
            target_kind: "tool" | "agent";
            target_name: string;
            kind: string;
            key: string;
        };
        data: Record<string, unknown>;
        seq: number;
        canonical_subject: {
            target_kind: "tool" | "agent";
            target_name: string;
            kind: string;
            key: string;
        };
        folded_from: {
            target_kind: "tool" | "agent";
            target_name: string;
            kind: string;
            key: string;
        }[];
    }>;
    applyStateRecord: (name: string, subject: StateSubjectRef, ops: readonly Record<string, unknown>[]) => Promise<{
        applied: boolean;
        data: Record<string, unknown> | null;
        seq: number | null;
        skipped: Record<string, unknown>[];
    }>;
    evalTemplateJq: (name: string, subject: StateSubjectRef, jqName: string, params?: Record<string, unknown>, signal?: AbortSignal) => Promise<{
        name: string;
        purpose: "input";
        value: unknown;
    }>;
    applyTemplateJq: (name: string, subject: StateSubjectRef, jqName: string, body?: {
        input?: unknown;
        op_id?: string;
    }) => Promise<{
        name: string;
        applied: boolean;
        data: Record<string, unknown> | null;
        seq: number | null;
        skipped: Record<string, unknown>[];
    }>;
    deleteStateRecord: (name: string, subject: StateSubjectRef) => Promise<{
        erased: true;
    }>;
    foldStateRecord: (name: string, subject: StateSubjectRef, into: StateSubjectRef, mode: "switch" | "merge") => Promise<{
        mode: "switch" | "merge";
        from: {
            kind: string;
            key: string;
        };
        into: {
            kind: string;
            key: string;
        };
        already: boolean;
        flattened: number;
    }>;
    listStateWrites: (name: string, subject: StateSubjectRef, params?: StatePageQuery, signal?: AbortSignal) => Promise<{
        items: {
            seq: number;
            at: string;
            origin: {
                consumer: string | null;
                meta: Record<string, unknown> | null;
                run_id: string | null;
                op_id: string | null;
                door: string;
                actor: string | null;
                turn_id: string | null;
                inbound_id: string | null;
            };
            paths: (string | number)[][];
        }[];
        next_cursor: string | null;
    }>;
    stateConsumers: (name: string, signal?: AbortSignal) => Promise<{
        kind: string;
        name: string | null;
        detail: string | null;
        link: {
            token: string | null;
            plugin_path: string | null;
            search: Record<string, unknown> | null;
        } | null;
        unavailable: string | null;
    }[]>;
    listStateTemplates: (signal?: AbortSignal) => Promise<{
        declarations: {
            check: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            } | null;
            schema: Record<string, unknown>;
        } | null;
        description: string;
        kind: "state-template";
        name: string;
        parameters: Record<string, unknown>;
        reconcile: {
            close: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            };
            orphans: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            };
            resolutions: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            };
        } | null;
        regimes: Record<string, unknown>[];
        template_jq: Record<string, {
            description: string;
            jq: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            };
            params: string[];
            purpose: "input" | "update";
            reads: string[][];
            writes: string[][];
        }> | null;
        trace: Record<string, unknown>;
        attached_to: number;
        shipped_default: boolean;
        schema?: Record<string, unknown> | {
            content?: string | undefined;
            id?: string | undefined;
            kwargs?: Record<string, unknown> | undefined;
        } | undefined;
    }[]>;
    getStateTemplate: (name: string, signal?: AbortSignal) => Promise<{
        declarations: {
            check: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            } | null;
            schema: Record<string, unknown>;
        } | null;
        description: string;
        kind: "state-template";
        name: string;
        parameters: Record<string, unknown>;
        reconcile: {
            close: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            };
            orphans: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            };
            resolutions: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            };
        } | null;
        regimes: Record<string, unknown>[];
        template_jq: Record<string, {
            description: string;
            jq: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            };
            params: string[];
            purpose: "input" | "update";
            reads: string[][];
            writes: string[][];
        }> | null;
        trace: Record<string, unknown>;
        schema?: Record<string, unknown> | {
            content?: string | undefined;
            id?: string | undefined;
            kwargs?: Record<string, unknown> | undefined;
        } | undefined;
    }>;
    putStateTemplate: (name: string, body: StateTemplateBody, replace?: boolean) => Promise<{
        declarations: {
            check: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            } | null;
            schema: Record<string, unknown>;
        } | null;
        description: string;
        kind: "state-template";
        name: string;
        parameters: Record<string, unknown>;
        reconcile: {
            close: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            };
            orphans: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            };
            resolutions: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            };
        } | null;
        regimes: Record<string, unknown>[];
        template_jq: Record<string, {
            description: string;
            jq: {
                content?: string | undefined;
                id?: string | undefined;
                kwargs?: Record<string, unknown> | undefined;
            };
            params: string[];
            purpose: "input" | "update";
            reads: string[][];
            writes: string[][];
        }> | null;
        trace: Record<string, unknown>;
        schema?: Record<string, unknown> | {
            content?: string | undefined;
            id?: string | undefined;
            kwargs?: Record<string, unknown> | undefined;
        } | undefined;
    }>;
    deleteStateTemplate: (name: string) => Promise<{
        name: string;
        deleted: true;
    }>;
    pruneStateRetention: () => Promise<{
        pruned: Record<string, number>;
    }>;
};
//# sourceMappingURL=states-client.d.ts.map