@opengeni/db 0.14.0 → 0.16.2

package/dist/preference-registry.d.ts

@@ -0,0 +1,878 @@
+import { PreferenceRegistryDescriptor, type CreatePreferenceRegistryProposalRequest, type PreferenceRegistryConflictStrategy, type PreferenceRegistryScope, type PreferenceRegistryStatus } from "@opengeni/contracts";
+import type { Database } from "./index";
+export declare class PreferenceRegistryNotFoundError extends Error {
+    readonly name = "PreferenceRegistryNotFoundError";
+}
+export declare class PreferenceRegistryInvalidOperationError extends Error {
+    readonly name = "PreferenceRegistryInvalidOperationError";
+}
+export declare class PreferenceRegistryConflictError extends Error {
+    readonly currentRevisionId: string | null;
+    readonly scopeVersion: number | null;
+    readonly name = "PreferenceRegistryConflictError";
+    readonly code = "PREFERENCE_REGISTRY_CONFLICT";
+    constructor(message: string, currentRevisionId: string | null, scopeVersion: number | null);
+}
+export declare class PreferenceRegistryInitiatorError extends Error {
+    readonly name = "PreferenceRegistryInitiatorError";
+}
+export declare class PreferenceRegistryStableKeyConflictError extends Error {
+    readonly name = "PreferenceRegistryStableKeyConflictError";
+    readonly code = "PREFERENCE_REGISTRY_STABLE_KEY_CONFLICT";
+}
+export type PreferenceRegistryAttemptClaims = {
+    accountId: string;
+    workspaceId: string;
+    sessionId: string;
+    turnId: string;
+    attemptId: string;
+    executionGeneration: number;
+};
+export type PreferenceRegistryScopeAuthorizer = (scope: PreferenceRegistryScope) => void;
+/** Plain one-line descriptor text; never include full imported source content. */
+export declare function sanitizePreferenceDescriptorText(value: string): string;
+export declare function createPreferenceRegistryProposal(db: Database, input: CreatePreferenceRegistryProposalRequest & {
+    accountId: string;
+    workspaceId: string;
+    actorSubjectId: string;
+    principalKind: string | undefined;
+}): Promise<{
+    id: string;
+    accountId: string;
+    stableKey: string;
+    target: {
+        scope: "organization" | "user" | "workspace";
+        workspaceId: string | null;
+        subjectId: string | null;
+    };
+    status: "active" | "expired" | "inactive" | "proposed" | "rejected" | "superseded";
+    scopeVersion: number;
+    activationVersion: number;
+    activeRevision: {
+        id: string;
+        preferenceId: string;
+        revision: number;
+        contentHash: string;
+        title: string;
+        description: string;
+        precedence: {
+            tier: "organization" | "user" | "workspace";
+            rank: number;
+            conflictStrategy: "inform" | "merge" | "override" | "reject";
+            conflictsWith: string[];
+        };
+        provenance: {
+            source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+            sourceId: string | null;
+            trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+        };
+        expiresAt: string | null;
+        correctsRevisionId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+    } | null;
+    supersededByPreferenceId: string | null;
+    createdBySubjectId: string;
+    createdAt: string;
+    updatedAt: string;
+}>;
+type PreferenceRegistryListInput = {
+    scope?: PreferenceRegistryScope | undefined;
+    status?: PreferenceRegistryStatus | undefined;
+    limit: number;
+};
+export declare function listPreferenceRegistry(db: Database, input: {
+    workspaceId: string;
+    subjectId: string;
+} & PreferenceRegistryListInput): Promise<{
+    preferences: {
+        id: string;
+        accountId: string;
+        stableKey: string;
+        target: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        };
+        status: "active" | "expired" | "inactive" | "proposed" | "rejected" | "superseded";
+        scopeVersion: number;
+        activationVersion: number;
+        activeRevision: {
+            id: string;
+            preferenceId: string;
+            revision: number;
+            contentHash: string;
+            title: string;
+            description: string;
+            precedence: {
+                tier: "organization" | "user" | "workspace";
+                rank: number;
+                conflictStrategy: "inform" | "merge" | "override" | "reject";
+                conflictsWith: string[];
+            };
+            provenance: {
+                source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+                sourceId: string | null;
+                trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+            };
+            expiresAt: string | null;
+            correctsRevisionId: string | null;
+            createdBySubjectId: string;
+            createdAt: string;
+        } | null;
+        supersededByPreferenceId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+}>;
+export declare function listPreferenceRegistryForAttempt(db: Database, input: PreferenceRegistryAttemptClaims & PreferenceRegistryListInput): Promise<{
+    preferences: {
+        id: string;
+        accountId: string;
+        stableKey: string;
+        target: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        };
+        status: "active" | "expired" | "inactive" | "proposed" | "rejected" | "superseded";
+        scopeVersion: number;
+        activationVersion: number;
+        activeRevision: {
+            id: string;
+            preferenceId: string;
+            revision: number;
+            contentHash: string;
+            title: string;
+            description: string;
+            precedence: {
+                tier: "organization" | "user" | "workspace";
+                rank: number;
+                conflictStrategy: "inform" | "merge" | "override" | "reject";
+                conflictsWith: string[];
+            };
+            provenance: {
+                source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+                sourceId: string | null;
+                trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+            };
+            expiresAt: string | null;
+            correctsRevisionId: string | null;
+            createdBySubjectId: string;
+            createdAt: string;
+        } | null;
+        supersededByPreferenceId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+}>;
+export declare function getPreferenceRegistryDetail(db: Database, input: {
+    workspaceId: string;
+    subjectId: string;
+    preferenceId: string;
+}): Promise<{
+    preference: {
+        id: string;
+        accountId: string;
+        stableKey: string;
+        target: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        };
+        status: "active" | "expired" | "inactive" | "proposed" | "rejected" | "superseded";
+        scopeVersion: number;
+        activationVersion: number;
+        activeRevision: {
+            id: string;
+            preferenceId: string;
+            revision: number;
+            contentHash: string;
+            title: string;
+            description: string;
+            precedence: {
+                tier: "organization" | "user" | "workspace";
+                rank: number;
+                conflictStrategy: "inform" | "merge" | "override" | "reject";
+                conflictsWith: string[];
+            };
+            provenance: {
+                source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+                sourceId: string | null;
+                trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+            };
+            expiresAt: string | null;
+            correctsRevisionId: string | null;
+            createdBySubjectId: string;
+            createdAt: string;
+        } | null;
+        supersededByPreferenceId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+        updatedAt: string;
+    };
+    revisions: {
+        id: string;
+        preferenceId: string;
+        revision: number;
+        contentHash: string;
+        title: string;
+        description: string;
+        precedence: {
+            tier: "organization" | "user" | "workspace";
+            rank: number;
+            conflictStrategy: "inform" | "merge" | "override" | "reject";
+            conflictsWith: string[];
+        };
+        provenance: {
+            source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+            sourceId: string | null;
+            trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+        };
+        expiresAt: string | null;
+        correctsRevisionId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+    }[];
+    events: {
+        id: string;
+        accountId: string;
+        preferenceId: string;
+        type: "activated" | "corrected" | "deactivated" | "proposal_created" | "rejected" | "scope_changed" | "superseded";
+        version: number;
+        oldRevisionId: string | null;
+        newRevisionId: string | null;
+        oldTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        newTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        relatedPreferenceId: string | null;
+        actorSubjectId: string;
+        reason: string;
+        createdAt: string;
+    }[];
+}>;
+export declare function getPreferenceRegistryDetailForAttempt(db: Database, input: PreferenceRegistryAttemptClaims & {
+    preferenceId: string;
+}): Promise<{
+    preference: {
+        id: string;
+        accountId: string;
+        stableKey: string;
+        target: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        };
+        status: "active" | "expired" | "inactive" | "proposed" | "rejected" | "superseded";
+        scopeVersion: number;
+        activationVersion: number;
+        activeRevision: {
+            id: string;
+            preferenceId: string;
+            revision: number;
+            contentHash: string;
+            title: string;
+            description: string;
+            precedence: {
+                tier: "organization" | "user" | "workspace";
+                rank: number;
+                conflictStrategy: "inform" | "merge" | "override" | "reject";
+                conflictsWith: string[];
+            };
+            provenance: {
+                source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+                sourceId: string | null;
+                trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+            };
+            expiresAt: string | null;
+            correctsRevisionId: string | null;
+            createdBySubjectId: string;
+            createdAt: string;
+        } | null;
+        supersededByPreferenceId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+        updatedAt: string;
+    };
+    revisions: {
+        id: string;
+        preferenceId: string;
+        revision: number;
+        contentHash: string;
+        title: string;
+        description: string;
+        precedence: {
+            tier: "organization" | "user" | "workspace";
+            rank: number;
+            conflictStrategy: "inform" | "merge" | "override" | "reject";
+            conflictsWith: string[];
+        };
+        provenance: {
+            source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+            sourceId: string | null;
+            trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+        };
+        expiresAt: string | null;
+        correctsRevisionId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+    }[];
+    events: {
+        id: string;
+        accountId: string;
+        preferenceId: string;
+        type: "activated" | "corrected" | "deactivated" | "proposal_created" | "rejected" | "scope_changed" | "superseded";
+        version: number;
+        oldRevisionId: string | null;
+        newRevisionId: string | null;
+        oldTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        newTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        relatedPreferenceId: string | null;
+        actorSubjectId: string;
+        reason: string;
+        createdAt: string;
+    }[];
+}>;
+export declare function activatePreferenceRegistryRevision(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    actorSubjectId: string;
+    principalKind: string | undefined;
+    preferenceId: string;
+    revisionId: string;
+    expectedCurrentRevisionId: string | null;
+    expectedScopeVersion: number;
+    authorizeScope: PreferenceRegistryScopeAuthorizer;
+    reason: string;
+    eventType?: "activated" | "corrected";
+}): Promise<{
+    preference: {
+        id: string;
+        accountId: string;
+        stableKey: string;
+        target: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        };
+        status: "active" | "expired" | "inactive" | "proposed" | "rejected" | "superseded";
+        scopeVersion: number;
+        activationVersion: number;
+        activeRevision: {
+            id: string;
+            preferenceId: string;
+            revision: number;
+            contentHash: string;
+            title: string;
+            description: string;
+            precedence: {
+                tier: "organization" | "user" | "workspace";
+                rank: number;
+                conflictStrategy: "inform" | "merge" | "override" | "reject";
+                conflictsWith: string[];
+            };
+            provenance: {
+                source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+                sourceId: string | null;
+                trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+            };
+            expiresAt: string | null;
+            correctsRevisionId: string | null;
+            createdBySubjectId: string;
+            createdAt: string;
+        } | null;
+        supersededByPreferenceId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+        updatedAt: string;
+    };
+    event: {
+        id: string;
+        accountId: string;
+        preferenceId: string;
+        type: "activated" | "corrected" | "deactivated" | "proposal_created" | "rejected" | "scope_changed" | "superseded";
+        version: number;
+        oldRevisionId: string | null;
+        newRevisionId: string | null;
+        oldTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        newTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        relatedPreferenceId: string | null;
+        actorSubjectId: string;
+        reason: string;
+        createdAt: string;
+    };
+}>;
+export declare function correctPreferenceRegistry(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    actorSubjectId: string;
+    principalKind: string | undefined;
+    preferenceId: string;
+    expectedCurrentRevisionId: string;
+    expectedScopeVersion: number;
+    authorizeScope: PreferenceRegistryScopeAuthorizer;
+    title: string;
+    description: string;
+    content: string;
+    precedenceRank: number;
+    conflictStrategy: PreferenceRegistryConflictStrategy;
+    conflictsWith: string[];
+    expiresAt: string | null;
+    reason: string;
+}): Promise<{
+    preference: {
+        id: string;
+        accountId: string;
+        stableKey: string;
+        target: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        };
+        status: "active" | "expired" | "inactive" | "proposed" | "rejected" | "superseded";
+        scopeVersion: number;
+        activationVersion: number;
+        activeRevision: {
+            id: string;
+            preferenceId: string;
+            revision: number;
+            contentHash: string;
+            title: string;
+            description: string;
+            precedence: {
+                tier: "organization" | "user" | "workspace";
+                rank: number;
+                conflictStrategy: "inform" | "merge" | "override" | "reject";
+                conflictsWith: string[];
+            };
+            provenance: {
+                source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+                sourceId: string | null;
+                trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+            };
+            expiresAt: string | null;
+            correctsRevisionId: string | null;
+            createdBySubjectId: string;
+            createdAt: string;
+        } | null;
+        supersededByPreferenceId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+        updatedAt: string;
+    };
+    event: {
+        id: string;
+        accountId: string;
+        preferenceId: string;
+        type: "activated" | "corrected" | "deactivated" | "proposal_created" | "rejected" | "scope_changed" | "superseded";
+        version: number;
+        oldRevisionId: string | null;
+        newRevisionId: string | null;
+        oldTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        newTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        relatedPreferenceId: string | null;
+        actorSubjectId: string;
+        reason: string;
+        createdAt: string;
+    };
+}>;
+export declare function changePreferenceRegistryScope(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    actorSubjectId: string;
+    principalKind: string | undefined;
+    preferenceId: string;
+    scope: PreferenceRegistryScope;
+    expectedScopeVersion: number;
+    authorizeScope: PreferenceRegistryScopeAuthorizer;
+    reason: string;
+}): Promise<{
+    preference: {
+        id: string;
+        accountId: string;
+        stableKey: string;
+        target: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        };
+        status: "active" | "expired" | "inactive" | "proposed" | "rejected" | "superseded";
+        scopeVersion: number;
+        activationVersion: number;
+        activeRevision: {
+            id: string;
+            preferenceId: string;
+            revision: number;
+            contentHash: string;
+            title: string;
+            description: string;
+            precedence: {
+                tier: "organization" | "user" | "workspace";
+                rank: number;
+                conflictStrategy: "inform" | "merge" | "override" | "reject";
+                conflictsWith: string[];
+            };
+            provenance: {
+                source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+                sourceId: string | null;
+                trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+            };
+            expiresAt: string | null;
+            correctsRevisionId: string | null;
+            createdBySubjectId: string;
+            createdAt: string;
+        } | null;
+        supersededByPreferenceId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+        updatedAt: string;
+    };
+    event: {
+        id: string;
+        accountId: string;
+        preferenceId: string;
+        type: "activated" | "corrected" | "deactivated" | "proposal_created" | "rejected" | "scope_changed" | "superseded";
+        version: number;
+        oldRevisionId: string | null;
+        newRevisionId: string | null;
+        oldTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        newTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        relatedPreferenceId: string | null;
+        actorSubjectId: string;
+        reason: string;
+        createdAt: string;
+    };
+}>;
+export declare function deactivatePreferenceRegistry(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    actorSubjectId: string;
+    principalKind: string | undefined;
+    preferenceId: string;
+    expectedCurrentRevisionId: string;
+    expectedScopeVersion: number;
+    authorizeScope: PreferenceRegistryScopeAuthorizer;
+    reason: string;
+}): Promise<{
+    preference: {
+        id: string;
+        accountId: string;
+        stableKey: string;
+        target: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        };
+        status: "active" | "expired" | "inactive" | "proposed" | "rejected" | "superseded";
+        scopeVersion: number;
+        activationVersion: number;
+        activeRevision: {
+            id: string;
+            preferenceId: string;
+            revision: number;
+            contentHash: string;
+            title: string;
+            description: string;
+            precedence: {
+                tier: "organization" | "user" | "workspace";
+                rank: number;
+                conflictStrategy: "inform" | "merge" | "override" | "reject";
+                conflictsWith: string[];
+            };
+            provenance: {
+                source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+                sourceId: string | null;
+                trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+            };
+            expiresAt: string | null;
+            correctsRevisionId: string | null;
+            createdBySubjectId: string;
+            createdAt: string;
+        } | null;
+        supersededByPreferenceId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+        updatedAt: string;
+    };
+    event: {
+        id: string;
+        accountId: string;
+        preferenceId: string;
+        type: "activated" | "corrected" | "deactivated" | "proposal_created" | "rejected" | "scope_changed" | "superseded";
+        version: number;
+        oldRevisionId: string | null;
+        newRevisionId: string | null;
+        oldTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        newTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        relatedPreferenceId: string | null;
+        actorSubjectId: string;
+        reason: string;
+        createdAt: string;
+    };
+}>;
+export declare function supersedePreferenceRegistry(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    actorSubjectId: string;
+    principalKind: string | undefined;
+    preferenceId: string;
+    replacementPreferenceId: string;
+    expectedCurrentRevisionId: string;
+    expectedScopeVersion: number;
+    authorizeScope: PreferenceRegistryScopeAuthorizer;
+    reason: string;
+}): Promise<{
+    preference: {
+        id: string;
+        accountId: string;
+        stableKey: string;
+        target: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        };
+        status: "active" | "expired" | "inactive" | "proposed" | "rejected" | "superseded";
+        scopeVersion: number;
+        activationVersion: number;
+        activeRevision: {
+            id: string;
+            preferenceId: string;
+            revision: number;
+            contentHash: string;
+            title: string;
+            description: string;
+            precedence: {
+                tier: "organization" | "user" | "workspace";
+                rank: number;
+                conflictStrategy: "inform" | "merge" | "override" | "reject";
+                conflictsWith: string[];
+            };
+            provenance: {
+                source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+                sourceId: string | null;
+                trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+            };
+            expiresAt: string | null;
+            correctsRevisionId: string | null;
+            createdBySubjectId: string;
+            createdAt: string;
+        } | null;
+        supersededByPreferenceId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+        updatedAt: string;
+    };
+    event: {
+        id: string;
+        accountId: string;
+        preferenceId: string;
+        type: "activated" | "corrected" | "deactivated" | "proposal_created" | "rejected" | "scope_changed" | "superseded";
+        version: number;
+        oldRevisionId: string | null;
+        newRevisionId: string | null;
+        oldTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        newTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        relatedPreferenceId: string | null;
+        actorSubjectId: string;
+        reason: string;
+        createdAt: string;
+    };
+}>;
+export declare function rejectPreferenceRegistryProposal(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    actorSubjectId: string;
+    principalKind: string | undefined;
+    preferenceId: string;
+    revisionId: string;
+    expectedScopeVersion: number;
+    authorizeScope: PreferenceRegistryScopeAuthorizer;
+    reason: string;
+}): Promise<{
+    preference: {
+        id: string;
+        accountId: string;
+        stableKey: string;
+        target: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        };
+        status: "active" | "expired" | "inactive" | "proposed" | "rejected" | "superseded";
+        scopeVersion: number;
+        activationVersion: number;
+        activeRevision: {
+            id: string;
+            preferenceId: string;
+            revision: number;
+            contentHash: string;
+            title: string;
+            description: string;
+            precedence: {
+                tier: "organization" | "user" | "workspace";
+                rank: number;
+                conflictStrategy: "inform" | "merge" | "override" | "reject";
+                conflictsWith: string[];
+            };
+            provenance: {
+                source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+                sourceId: string | null;
+                trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+            };
+            expiresAt: string | null;
+            correctsRevisionId: string | null;
+            createdBySubjectId: string;
+            createdAt: string;
+        } | null;
+        supersededByPreferenceId: string | null;
+        createdBySubjectId: string;
+        createdAt: string;
+        updatedAt: string;
+    };
+    event: {
+        id: string;
+        accountId: string;
+        preferenceId: string;
+        type: "activated" | "corrected" | "deactivated" | "proposal_created" | "rejected" | "scope_changed" | "superseded";
+        version: number;
+        oldRevisionId: string | null;
+        newRevisionId: string | null;
+        oldTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        newTarget: {
+            scope: "organization" | "user" | "workspace";
+            workspaceId: string | null;
+            subjectId: string | null;
+        } | null;
+        relatedPreferenceId: string | null;
+        actorSubjectId: string;
+        reason: string;
+        createdAt: string;
+    };
+}>;
+export declare function boundPreferenceRegistryDescriptors(descriptors: readonly PreferenceRegistryDescriptor[]): {
+    descriptors: PreferenceRegistryDescriptor[];
+    truncated: boolean;
+};
+export declare function getOrCreatePreferenceRegistrySnapshot(db: Database, claims: PreferenceRegistryAttemptClaims): Promise<{
+    id: string;
+    workspaceId: string;
+    sessionId: string;
+    turnId: string;
+    attemptId: string;
+    executionGeneration: number;
+    initiatingHumanSubjectId: string;
+    descriptorHash: string;
+    descriptors: {
+        id: string;
+        stableKey: string;
+        title: string;
+        description: string;
+        scope: "organization" | "user" | "workspace";
+        activeVersion: number;
+        revisionId: string;
+        contentHash: string;
+        precedence: {
+            tier: "organization" | "user" | "workspace";
+            rank: number;
+            conflictStrategy: "inform" | "merge" | "override" | "reject";
+            conflictsWith: string[];
+        };
+        provenance: {
+            source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+            sourceIdHash: string | null;
+            trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+        };
+        expiresAt: string | null;
+        retrievalHandle: string;
+    }[];
+    truncated: boolean;
+    createdAt: string;
+}>;
+export declare function getPreferenceRegistryFullContent(db: Database, claims: PreferenceRegistryAttemptClaims, handle: string): Promise<{
+    descriptor: {
+        id: string;
+        stableKey: string;
+        title: string;
+        description: string;
+        scope: "organization" | "user" | "workspace";
+        activeVersion: number;
+        revisionId: string;
+        contentHash: string;
+        precedence: {
+            tier: "organization" | "user" | "workspace";
+            rank: number;
+            conflictStrategy: "inform" | "merge" | "override" | "reject";
+            conflictsWith: string[];
+        };
+        provenance: {
+            source: "call_transcript" | "human" | "imported_document" | "knowledge_proposal" | "meeting_transcript" | "onboarding" | "slack";
+            sourceIdHash: string | null;
+            trust: "organization_managed" | "personal" | "untrusted_proposal" | "workspace_managed";
+        };
+        expiresAt: string | null;
+        retrievalHandle: string;
+    };
+    content: string;
+}>;
+export {};