@opengeni/db 1.0.1 → 3.1.0-canary.0

package/dist/task-notes-schema.d.ts

@@ -922,3 +922,597 @@ export declare const taskNoteWriteCapabilities: import("drizzle-orm/pg-core").Pg
     };
     dialect: 'pg';
 }>;
+export declare const taskNoteKnowledgePromotionCapabilities: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "task_note_knowledge_promotion_capabilities";
+    schema: undefined;
+    columns: {
+        backendPid: import("drizzle-orm/pg-core").PgColumn<{
+            name: "backend_pid";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        transactionId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "transaction_id";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "custom";
+            columnType: "PgCustomColumn";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            pgColumnBuilderBrand: 'PgCustomColumnBuilderBrand';
+        }>;
+        capabilityId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "capability_id";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        accountId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "account_id";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        workspaceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "workspace_id";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        noteId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "note_id";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        rootSessionId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "root_session_id";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        noteVersion: import("drizzle-orm/pg-core").PgColumn<{
+            name: "note_version";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        noteTextHash: import("drizzle-orm/pg-core").PgColumn<{
+            name: "note_text_hash";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        evidenceOperationId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "evidence_operation_id";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        claimOperationId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "claim_operation_id";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        actorSubjectId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "actor_subject_id";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        initiatingHumanSubjectId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "initiating_human_subject_id";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        learningPolicySnapshotId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "learning_policy_snapshot_id";
+            tableName: "task_note_knowledge_promotion_capabilities";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'pg';
+}>;
+export declare const taskNoteReplacementReceipts: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "task_note_replacement_receipts";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        accountId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "account_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        workspaceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "workspace_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        rootSessionId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "root_session_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        operationId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "operation_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        inputHash: import("drizzle-orm/pg-core").PgColumn<{
+            name: "input_hash";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        replacedNoteId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "replaced_note_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        replacedNoteVersion: import("drizzle-orm/pg-core").PgColumn<{
+            name: "replaced_note_version";
+            tableName: "task_note_replacement_receipts";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        replacementNoteId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "replacement_note_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        replacementNoteVersion: import("drizzle-orm/pg-core").PgColumn<{
+            name: "replacement_note_version";
+            tableName: "task_note_replacement_receipts";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        archiveOperationId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "archive_operation_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createOperationId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "create_operation_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        actorKind: import("drizzle-orm/pg-core").PgColumn<{
+            name: "actor_kind";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        actorSubjectId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "actor_subject_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        initiatingHumanSubjectId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "initiating_human_subject_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        actorSessionId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "actor_session_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        actorTurnId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "actor_turn_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        actorAttemptId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "actor_attempt_id";
+            tableName: "task_note_replacement_receipts";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        actorExecutionGeneration: import("drizzle-orm/pg-core").PgColumn<{
+            name: "actor_execution_generation";
+            tableName: "task_note_replacement_receipts";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "task_note_replacement_receipts";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'pg';
+}>;

package/dist/task-notes.d.ts

@@ -20,6 +20,15 @@ export type ArchiveTaskNoteInput = TaskNoteAttemptClaims & {
     expectedVersion: number;
     reason: string;
 };
+export type ReplaceTaskNoteInput = TaskNoteAttemptClaims & {
+    operationId: string;
+    replacedNoteId: string;
+    expectedReplacedVersion: number;
+    replacementKind: TaskNoteKindType;
+    replacementText: string;
+    replacementExpiresInDays: number;
+    reason: string;
+};
 export type ListTaskNotesInput = TaskNoteAttemptClaims & {
     includeArchived?: boolean;
     limit?: number;
@@ -64,6 +73,36 @@ export declare function archiveTaskNote(db: Database, input: ArchiveTaskNoteInpu
     };
     replayed: boolean;
 }>;
+/**
+ * Atomically archive one exact active note and create its immutable replacement.
+ * Exact retries return the original linked receipt; changed input or authority fails.
+ */
+export declare function replaceTaskNote(db: Database, input: ReplaceTaskNoteInput): Promise<{
+    operationId: string;
+    inputHash: string;
+    replaces: {
+        noteId: string;
+        archivedVersion: 2;
+    };
+    replacement: {
+        id: string;
+        rootSessionId: string;
+        kind: "artifact" | "blocker" | "decision" | "finding" | "handoff" | "ownership";
+        text: string;
+        status: "active" | "archived";
+        version: number;
+        expiresAt: string;
+        createdAt: string;
+        updatedAt: string;
+        archivedAt: string | null;
+        provenance: {
+            actorKind: "human" | "service";
+            sourceSessionId: string;
+            sourceTurnId: string;
+        };
+    };
+    replayed: boolean;
+}>;
 export declare function listTaskNotes(db: Database, input: ListTaskNotesInput): Promise<{
     notes: {
         id: string;

package/dist/turn-initiator.d.ts

@@ -5,6 +5,8 @@ export declare const UNATTRIBUTED_LEGACY_INITIATOR: TurnInitiator;
 export type FrozenTurnInitiator = {
     initiator: TurnInitiator;
     context: TurnInitiatorContext;
+    /** Exact causal human frozen only after the caller/attempt authority is validated. */
+    initiatingHumanSubjectId?: string | null;
 };
 /**
  * Bound agent provenance without discarding its causal authority. Once the