import { ChatApiError } from "./chat-api-errors.js";
import type { ChatApiMeta } from "./chat-api-types.js";
import type { ChatActor, ChatThread, ChatProvenance, ChatReference, ChatScope } from "./types/chat.js";
export declare function requestIdFor(requestId: string | undefined): string;
export declare function requireText(value: string | undefined, field: string, requestId: string): string;
export declare function notFound(code: string, requestId: string): ChatApiError;
export declare function hashBody(text: string): string;
export declare function idempotentMessageId(scope: ChatScope, threadId: string, action: string, idempotencyKey: string): string;
export declare function provenance(sourceKind: "user_input", sourceId: string, createdAt: string, policyDecisionId?: string): ChatProvenance;
export declare function retention(decidedAt: string): {
    policyId: string;
    status: "redacted_only";
    rawPersistence: "forbidden";
    decidedAt: string;
};
export declare function exportPolicy(decidedAt: string): {
    status: "redacted_only";
    rawContentExportable: boolean;
    policyId: string;
    decidedAt: string;
};
export declare function referencesFor(scope: ChatScope): ChatReference[];
export declare function actorId(actor: ChatActor): string;
export declare function listOptions(limit?: number, cursor?: string): {
    cursor?: string;
    limit?: number;
};
export declare function apiMeta(requestId: string, options?: Omit<ChatApiMeta, "requestId">): ChatApiMeta;
export declare function buildChatThread(input: {
    scope: ChatScope;
    title: string;
    actor: ChatActor;
    requestId: string;
    now: string;
}): ChatThread;