@opengeni/db 0.28.1 → 0.31.1

package/dist/schema.js

@@ -1,17 +1,44 @@
 import {
   agentRunStates,
   apiKeys,
+  attachedBrowserDevices,
+  attachedBrowserInventories,
   auditEvents,
+  authRuns,
   billingCustomers,
+  browserIdentities,
+  browserRevisionComponents,
+  browserRevisions,
+  browserSessionAssociations,
+  browserSessions,
+  browserStateArtifacts,
+  capabilityApiFacets,
   capabilityCatalogItems,
+  capabilityComponentOwners,
+  capabilityFacetInstallations,
+  capabilityFacets,
   capabilityInstallations,
+  capabilityIntegrationFacets,
+  capabilityMcpFacets,
+  capabilityOperations,
+  capabilityPluginInstallations,
+  capabilityPluginVersions,
+  capabilityPlugins,
+  capabilitySkillFacets,
+  capabilitySkillFiles,
   codexAppsSettings,
   codexCapacityWaiters,
   codexCredentialLeases,
   codexResetRedemptionAttempts,
   codexRotationSettings,
   codexSubscriptionCredentials,
+  companyProfileActivationEvents,
+  companyProfileHeads,
+  companyProfileRevisions,
+  companyProfileSnapshots,
   composerDrafts,
+  computerSessionAssociations,
+  computerSessions,
   connectionDisconnectOperations,
   connections,
   connectorActionPolicies,
@@ -22,12 +49,29 @@ import {
   documentBases,
   documentChunks,
   documents,
+  editableArtifactBlobRefs,
+  editableArtifactIdempotencyReceipts,
+  editableArtifactLiveOutbox,
+  editableArtifactLiveTickets,
+  editableArtifactMaterializationJobs,
+  editableArtifactMaterializationResults,
+  editableArtifactOperations,
+  editableArtifactReplicaLeases,
+  editableArtifactScopeAuthorizationHeads,
+  editableArtifactSequenceCheckpoints,
+  editableArtifactSnapshots,
+  editableArtifactTransactions,
+  editableArtifactUndoClaims,
+  editableArtifactVersions,
+  editableArtifacts,
   enrollmentExposureValues,
   enrollmentOsValues,
   enrollmentStatusValues,
   enrollments,
   fileUploads,
   files,
+  generatedImageArtifacts,
+  generatedVideoArtifacts,
   githubInstallationRepositories,
   githubInstallations,
   hostExportConfig,
@@ -35,9 +79,21 @@ import {
   hostExportCursorState,
   hostExportDeadLetters,
   hostExportOutbox,
+  imageGenerationOperations,
   importBatches,
+  integrationFeatureBindingOwners,
+  integrationFeatureBindings,
+  integrationFeatureFacets,
   integrationOauthClients,
   integrationOauthStateNonces,
+  integrationSpecRevisions,
+  integrationTools,
+  interactionInterventions,
+  interactionLifecycleValues,
+  interactionOperationKindValues,
+  interactionOperationStateValues,
+  interactionOperations,
+  interactionResourceOperations,
   knowledgeChangeProposals,
   knowledgeClaimEvidence,
   knowledgeClaimRelations,
@@ -55,19 +111,32 @@ import {
   knowledgeProviders,
   knowledgeSourceAclVersions,
   knowledgeSourceObjects,
+  knowledgeSourceSyncIndexObligations,
+  knowledgeSourceSyncItemOutcomes,
+  knowledgeSourceSyncObjectObservations,
+  knowledgeSourceSyncStates,
+  knowledgeSourceSyncWakes,
   knowledgeSources,
   knowledgeSyncRuns,
   machineMetricsLatest,
   machineMetricsSeries,
+  machineRemovalOperationOutcomeValues,
+  machineRemovalOperations,
   managedAccounts,
+  memorySlackPublicationConfigurations,
+  memorySlackPublicationReceipts,
+  memorySlackPublications,
   modelCallFacts,
   nestedAgentDepthConfiguration,
+  networkRoutes,
   newSessionDrafts,
+  packInstallationComponents,
   packInstallations,
   preferenceRegistryEvents,
   preferenceRegistryPreferences,
   preferenceRegistryRevisions,
   preferenceRegistrySnapshots,
+  retainedScreenshotArtifacts,
   rigChanges,
   rigVersions,
   rigs,
@@ -87,7 +156,9 @@ import {
   sandboxes,
   scheduledTaskRuns,
   scheduledTasks,
+  sessionAttemptCodemodeCalls,
   sessionAttemptInterruptions,
+  sessionAttemptToolCatalogs,
   sessionCommandReceipts,
   sessionEvents,
   sessionGoals,
@@ -112,15 +183,20 @@ import {
   sessionTurns,
   sessionWorkflowWakeOutbox,
   sessions,
+  siteAuthConnections,
   slackBotDeleteOperations,
   slackBotPostOperations,
   slackBotUserLinks,
+  slackInstallationBindings,
   slackInteractionInbox,
   slackInteractionProgressDeliveries,
   slackInteractions,
+  slackUserLinkAccessRequestOperations,
+  slackUserLinkAccessRequests,
   socialConnections,
   socialPosts,
   stripeWebhookEvents,
+  temporalScheduleCleanupOutbox,
   transcriptionRecordingChunkStateValues,
   transcriptionRecordingChunks,
   transcriptionRecordingObjectKindValues,
@@ -130,6 +206,8 @@ import {
   transcriptionRecordingStateValues,
   transcriptionRecordings,
   usageEvents,
+  videoGenerationOperations,
+  videoGenerationReferences,
   workspaceArtifactEvents,
   workspaceArtifactVersions,
   workspaceArtifacts,
@@ -141,29 +219,64 @@ import {
   workspaceInstructionPolicyOnboardingProposals,
   workspaceInstructionPolicyRevisions,
   workspaceInstructionPolicySnapshots,
+  workspaceInteractionRevisions,
+  workspaceLearningPolicyActivationEvents,
+  workspaceLearningPolicyHeads,
+  workspaceLearningPolicyRevisions,
+  workspaceLearningPolicySnapshots,
   workspaceMemberships,
   workspaceModelPolicies,
   workspacePacks,
+  workspaceScreenshotQuotas,
   workspaceSessionActivityRevisions,
   workspaceVariableSetVariables,
   workspaceVariableSets,
+  workspaceVideoGenerationPolicies,
+  workspaceVideoGenerationQuotas,
   workspaces
-} from "./chunk-HT5T62CC.js";
+} from "./chunk-MWDVXQOL.js";
 import "./chunk-PZ5AY32C.js";
 export {
   agentRunStates,
   apiKeys,
+  attachedBrowserDevices,
+  attachedBrowserInventories,
   auditEvents,
+  authRuns,
   billingCustomers,
+  browserIdentities,
+  browserRevisionComponents,
+  browserRevisions,
+  browserSessionAssociations,
+  browserSessions,
+  browserStateArtifacts,
+  capabilityApiFacets,
   capabilityCatalogItems,
+  capabilityComponentOwners,
+  capabilityFacetInstallations,
+  capabilityFacets,
   capabilityInstallations,
+  capabilityIntegrationFacets,
+  capabilityMcpFacets,
+  capabilityOperations,
+  capabilityPluginInstallations,
+  capabilityPluginVersions,
+  capabilityPlugins,
+  capabilitySkillFacets,
+  capabilitySkillFiles,
   codexAppsSettings,
   codexCapacityWaiters,
   codexCredentialLeases,
   codexResetRedemptionAttempts,
   codexRotationSettings,
   codexSubscriptionCredentials,
+  companyProfileActivationEvents,
+  companyProfileHeads,
+  companyProfileRevisions,
+  companyProfileSnapshots,
   composerDrafts,
+  computerSessionAssociations,
+  computerSessions,
   connectionDisconnectOperations,
   connections,
   connectorActionPolicies,
@@ -174,12 +287,29 @@ export {
   documentBases,
   documentChunks,
   documents,
+  editableArtifactBlobRefs,
+  editableArtifactIdempotencyReceipts,
+  editableArtifactLiveOutbox,
+  editableArtifactLiveTickets,
+  editableArtifactMaterializationJobs,
+  editableArtifactMaterializationResults,
+  editableArtifactOperations,
+  editableArtifactReplicaLeases,
+  editableArtifactScopeAuthorizationHeads,
+  editableArtifactSequenceCheckpoints,
+  editableArtifactSnapshots,
+  editableArtifactTransactions,
+  editableArtifactUndoClaims,
+  editableArtifactVersions,
+  editableArtifacts,
   enrollmentExposureValues,
   enrollmentOsValues,
   enrollmentStatusValues,
   enrollments,
   fileUploads,
   files,
+  generatedImageArtifacts,
+  generatedVideoArtifacts,
   githubInstallationRepositories,
   githubInstallations,
   hostExportConfig,
@@ -187,9 +317,21 @@ export {
   hostExportCursorState,
   hostExportDeadLetters,
   hostExportOutbox,
+  imageGenerationOperations,
   importBatches,
+  integrationFeatureBindingOwners,
+  integrationFeatureBindings,
+  integrationFeatureFacets,
   integrationOauthClients,
   integrationOauthStateNonces,
+  integrationSpecRevisions,
+  integrationTools,
+  interactionInterventions,
+  interactionLifecycleValues,
+  interactionOperationKindValues,
+  interactionOperationStateValues,
+  interactionOperations,
+  interactionResourceOperations,
   knowledgeChangeProposals,
   knowledgeClaimEvidence,
   knowledgeClaimRelations,
@@ -207,19 +349,32 @@ export {
   knowledgeProviders,
   knowledgeSourceAclVersions,
   knowledgeSourceObjects,
+  knowledgeSourceSyncIndexObligations,
+  knowledgeSourceSyncItemOutcomes,
+  knowledgeSourceSyncObjectObservations,
+  knowledgeSourceSyncStates,
+  knowledgeSourceSyncWakes,
   knowledgeSources,
   knowledgeSyncRuns,
   machineMetricsLatest,
   machineMetricsSeries,
+  machineRemovalOperationOutcomeValues,
+  machineRemovalOperations,
   managedAccounts,
+  memorySlackPublicationConfigurations,
+  memorySlackPublicationReceipts,
+  memorySlackPublications,
   modelCallFacts,
   nestedAgentDepthConfiguration,
+  networkRoutes,
   newSessionDrafts,
+  packInstallationComponents,
   packInstallations,
   preferenceRegistryEvents,
   preferenceRegistryPreferences,
   preferenceRegistryRevisions,
   preferenceRegistrySnapshots,
+  retainedScreenshotArtifacts,
   rigChanges,
   rigVersions,
   rigs,
@@ -239,7 +394,9 @@ export {
   sandboxes,
   scheduledTaskRuns,
   scheduledTasks,
+  sessionAttemptCodemodeCalls,
   sessionAttemptInterruptions,
+  sessionAttemptToolCatalogs,
   sessionCommandReceipts,
   sessionEvents,
   sessionGoals,
@@ -264,15 +421,20 @@ export {
   sessionTurns,
   sessionWorkflowWakeOutbox,
   sessions,
+  siteAuthConnections,
   slackBotDeleteOperations,
   slackBotPostOperations,
   slackBotUserLinks,
+  slackInstallationBindings,
   slackInteractionInbox,
   slackInteractionProgressDeliveries,
   slackInteractions,
+  slackUserLinkAccessRequestOperations,
+  slackUserLinkAccessRequests,
   socialConnections,
   socialPosts,
   stripeWebhookEvents,
+  temporalScheduleCleanupOutbox,
   transcriptionRecordingChunkStateValues,
   transcriptionRecordingChunks,
   transcriptionRecordingObjectKindValues,
@@ -282,6 +444,8 @@ export {
   transcriptionRecordingStateValues,
   transcriptionRecordings,
   usageEvents,
+  videoGenerationOperations,
+  videoGenerationReferences,
   workspaceArtifactEvents,
   workspaceArtifactVersions,
   workspaceArtifacts,
@@ -293,12 +457,20 @@ export {
   workspaceInstructionPolicyOnboardingProposals,
   workspaceInstructionPolicyRevisions,
   workspaceInstructionPolicySnapshots,
+  workspaceInteractionRevisions,
+  workspaceLearningPolicyActivationEvents,
+  workspaceLearningPolicyHeads,
+  workspaceLearningPolicyRevisions,
+  workspaceLearningPolicySnapshots,
   workspaceMemberships,
   workspaceModelPolicies,
   workspacePacks,
+  workspaceScreenshotQuotas,
   workspaceSessionActivityRevisions,
   workspaceVariableSetVariables,
   workspaceVariableSets,
+  workspaceVideoGenerationPolicies,
+  workspaceVideoGenerationQuotas,
   workspaces
 };
 //# sourceMappingURL=schema.js.map

package/dist/scoped-knowledge.d.ts

@@ -1,5 +1,5 @@
 import type { EligibleKnowledgeClaim, KnowledgeChangeProposalRecord, KnowledgeClaimEvidencePolarity, KnowledgeClaimOrigin, KnowledgeClaimRecord, KnowledgeClaimRelationType, KnowledgeClaimReviewState, KnowledgeDocumentVersionRecord, KnowledgeFactObjectKind, KnowledgeFactRecord, KnowledgeLifecycleEventType, KnowledgeLifecycleState, KnowledgeProviderRecord, KnowledgeSourceAclVersionRecord, KnowledgeSourceObjectRecord, KnowledgeSourceRecord, KnowledgeSyncRunRecord, ScopedKnowledgeActor, ScopedKnowledgeScope } from "@opengeni/contracts";
-import type { Database } from "./database";
+import type { Database } from "./database.js";
 type KnowledgeWriteContext = {
     accountId: string;
     workspaceId: string;
@@ -30,6 +30,16 @@ export declare class ScopedKnowledgeInvalidOperationError extends Error {
 export declare class ScopedKnowledgeAuthorityError extends Error {
     readonly name = "ScopedKnowledgeAuthorityError";
 }
+export declare class KnowledgeSourceSyncObservationFenceError extends Error {
+    readonly name = "KnowledgeSourceSyncObservationFenceError";
+    readonly code = "KNOWLEDGE_SOURCE_SYNC_OBSERVATION_FENCE";
+}
+export type KnowledgeSourceSyncVersionObservationFence = {
+    scheduledTaskRunId: string;
+    scanGeneration: number;
+    providerRevision: string | null;
+    metadataHash: string | null;
+};
 export declare function scopedKnowledgeInputHash(value: unknown): string;
 export declare function normalizeScopedKnowledgeKey(value: string): string;
 export declare function scopedKnowledgeScopeKey(scope: ScopedKnowledgeScope): string;
@@ -43,6 +53,54 @@ export declare function upsertKnowledgeSource(db: Database, input: KnowledgeWrit
     sourceKind: string;
     sourceUri?: string | null;
 }): Promise<KnowledgeSourceRecord>;
+export declare function getKnowledgeSourceForSyncAuthority(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    sourceId: string;
+    initiatingSubjectId: string;
+}): Promise<{
+    source: KnowledgeSourceRecord;
+    provider: KnowledgeProviderRecord;
+} | null>;
+export declare function getKnowledgeSourceByExternalIdentityForSyncAuthority(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    providerId: string;
+    externalSourceId: string;
+    initiatingSubjectId: string;
+}): Promise<KnowledgeSourceRecord | null>;
+export declare function getKnowledgeSourceAclForSyncAuthority(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    sourceId: string;
+    generation: number;
+    initiatingSubjectId: string;
+}): Promise<KnowledgeSourceAclVersionRecord | null>;
+export declare function getKnowledgeSourceObjectForSyncAuthority(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    sourceId: string;
+    externalObjectId: string;
+    initiatingSubjectId: string;
+}): Promise<KnowledgeSourceObjectRecord | null>;
+export declare function getKnowledgeDocumentVersionForSyncAuthority(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    versionId: string;
+    initiatingSubjectId: string;
+}): Promise<KnowledgeDocumentVersionRecord | null>;
+export declare function getKnowledgeDocumentVersionObservationForSyncAuthority(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    versionId: string;
+    initiatingSubjectId: string;
+}): Promise<{
+    version: KnowledgeDocumentVersionRecord;
+    sourceMetadata: Record<string, unknown>;
+    sourceUpdatedAt: string | null;
+    locationMetadata: Record<string, unknown>;
+    documentChunkCount: number;
+} | null>;
 export declare function appendKnowledgeSourceAclVersion(db: Database, input: Omit<KnowledgeWriteContext, "scope"> & {
     sourceId: string;
     audience: ScopedKnowledgeScope;
@@ -52,12 +110,42 @@ export declare function appendKnowledgeSourceAclVersion(db: Database, input: Omi
     agentAccess: boolean;
     reasonCode: string;
 }): Promise<KnowledgeSourceAclVersionRecord>;
+/** Atomically advance the source ACL to a deny generation and revoke every
+ * materialized retrieval path. Delivery pause alone is never authorization. */
+export declare function deauthorizeKnowledgeSourceRetrieval(db: Database, input: Omit<KnowledgeWriteContext, "scope"> & {
+    sourceId: string;
+    audience: ScopedKnowledgeScope;
+    reasonCode: string;
+}): Promise<KnowledgeSourceAclVersionRecord>;
+export declare function updateKnowledgeSourceDocumentObservationMetadata(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    initiatingSubjectId: string;
+    sourceId: string;
+    expectedSourceLifecycleGeneration: number;
+    objectId: string;
+    expectedObjectLifecycleGeneration: number;
+    versionId: string;
+    documentId: string;
+    title: string;
+    sourceUri: string;
+    sourceVersion: string;
+    sourceUpdatedAt: string | null;
+    syncObservation?: KnowledgeSourceSyncVersionObservationFence;
+}): Promise<void>;
 export declare function beginKnowledgeSyncRun(db: Database, input: Omit<KnowledgeWriteContext, "scope"> & {
     sourceId: string;
     expectedSourceLifecycleGeneration: number;
     expectedSyncGeneration: number;
     inputCursor: string | null;
 }): Promise<KnowledgeSyncRunRecord>;
+export declare function getKnowledgeSyncRunForSyncAuthority(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    sourceId: string;
+    operationId: string;
+    initiatingSubjectId: string;
+}): Promise<KnowledgeSyncRunRecord | null>;
 export declare function completeKnowledgeSyncRun(db: Database, input: {
     accountId: string;
     workspaceId: string;
@@ -77,6 +165,7 @@ export declare function upsertKnowledgeSourceObject(db: Database, input: Omit<Kn
 }): Promise<KnowledgeSourceObjectRecord>;
 export declare function appendKnowledgeDocumentVersion(db: Database, input: Omit<KnowledgeWriteContext, "scope"> & {
     objectId: string;
+    expectedSourceLifecycleGeneration: number;
     expectedObjectLifecycleGeneration: number;
     expectedVersionGeneration: number;
     externalVersionId: string;
@@ -91,6 +180,13 @@ export declare function appendKnowledgeDocumentVersion(db: Database, input: Omit
     documentId?: string | null;
     fileId?: string | null;
     locationMetadata?: Record<string, unknown> | undefined;
+    documentObservationMetadata?: {
+        title: string;
+        sourceUri: string;
+        sourceVersion: string;
+        sourceUpdatedAt: string | null;
+    };
+    syncObservation?: KnowledgeSourceSyncVersionObservationFence;
     reasonCode: string;
 }): Promise<KnowledgeDocumentVersionRecord>;
 export declare function recordKnowledgeLifecycleEvent(db: Database, input: Omit<KnowledgeWriteContext, "scope"> & {

package/dist/session-control.d.ts

@@ -1,6 +1,6 @@
 import { type SessionMcpApprovalPolicy, type TurnInitiatorContext } from "@opengeni/contracts";
-import type { Database } from "./database";
-import * as schema from "./schema";
+import type { Database, SessionActivityDatabase } from "./database.js";
+import * as schema from "./schema.js";
 export declare const SESSION_ANCESTRY_LIMIT = 10000;
 export type WorkspaceControlLockMode = "none" | "share" | "update";
 export type EffectiveControlState = "active" | "paused";
@@ -297,7 +297,7 @@ export type SessionControlMutationResult = {
     }>;
     replay: boolean;
 };
-export declare function mutateSessionControlInTransaction(db: Database, input: {
+export declare function mutateSessionControlInTransaction(db: SessionActivityDatabase, input: {
     accountId: string;
     workspaceId: string;
     sessionId: string;
@@ -307,7 +307,7 @@ export declare function mutateSessionControlInTransaction(db: Database, input: {
     reason?: string | null;
     expectedControlEtag?: string | null;
 }): Promise<SessionControlMutationResult>;
-export declare function autoResumeSessionBranchInTransaction(db: Database, input: {
+export declare function autoResumeSessionBranchInTransaction(db: SessionActivityDatabase, input: {
     workspaceId: string;
     sessionId: string;
     actor: string;

package/dist/session-queue-commands.d.ts

@@ -1,7 +1,7 @@
-import { ResourceRef, type McpPersonalConnectionDelegation, type LatencyMode, type ReasoningEffort, type TurnExecutionPolicyV1 } from "@opengeni/contracts";
-import type { Database } from "./database";
-import { type SessionCommandActor, type SessionCommandReceiptRow } from "./session-control";
-import * as schema from "./schema";
+import { ResourceRef, type McpPersonalConnectionDelegation, type DraftTimelineAnnotation, type LatencyMode, type ReasoningEffort, type SessionEvent, type SessionTurn, type TurnExecutionPolicyV1, type TimelineAnnotation } from "@opengeni/contracts";
+import type { Database, SessionActivityDatabase } from "./database.js";
+import { type SessionCommandActor, type SessionCommandReceiptRow } from "./session-control.js";
+import * as schema from "./schema.js";
 export type QueueCommandConflictCode = "QUEUE_VERSION_CHANGED" | "QUEUE_PROMPT_STARTED" | "QUEUE_ANCHOR_CHANGED" | "PROMPT_CHANGED" | "DRAFT_CHANGED" | "DRAFT_NOT_EMPTY" | "EDIT_SOURCE_CHANGED";
 export declare class QueueCommandConflictError extends Error {
     readonly code: QueueCommandConflictCode;
@@ -36,6 +36,10 @@ export type SteerQueueCommandResult = QueueCommandResult & {
 export type SubmitHumanPromptResult = {
     receipt: SessionCommandReceiptRow;
     queueVersion: number;
+    accepted: SessionEvent;
+    events: SessionEvent[];
+    turn: SessionTurn;
+    /** Backward-compatible row identities for lower-level callers. */
     acceptedEventId: string;
     eventIds: string[];
     turnId: string;
@@ -90,12 +94,13 @@ export declare function saveComposerDraftInTransaction(db: Database, input: {
     subjectId: string;
     expectedRevision: number;
     text: string;
+    annotations?: DraftTimelineAnnotation[];
     resources: ResourceRef[];
     model: string;
     reasoningEffort: ReasoningEffort;
     latencyMode?: LatencyMode;
 }): Promise<ComposerDraftRow>;
-export declare function moveQueuedTurnInTransaction(db: Database, input: {
+export declare function moveQueuedTurnInTransaction(db: SessionActivityDatabase, input: {
     accountId: string;
     workspaceId: string;
     sessionId: string;
@@ -105,7 +110,7 @@ export declare function moveQueuedTurnInTransaction(db: Database, input: {
     actor: SessionCommandActor;
     operationKey: string;
 }): Promise<QueueCommandResult>;
-export declare function deleteSessionQueueItemInTransaction(db: Database, input: {
+export declare function deleteSessionQueueItemInTransaction(db: SessionActivityDatabase, input: {
     accountId: string;
     workspaceId: string;
     sessionId: string;
@@ -115,7 +120,7 @@ export declare function deleteSessionQueueItemInTransaction(db: Database, input:
     operationKey: string;
     reason?: string | null;
 }): Promise<QueueCommandResult>;
-export declare function editQueuedTurnInTransaction(db: Database, input: {
+export declare function editQueuedTurnInTransaction(db: SessionActivityDatabase, input: {
     accountId: string;
     workspaceId: string;
     sessionId: string;
@@ -127,7 +132,7 @@ export declare function editQueuedTurnInTransaction(db: Database, input: {
     actor: SessionCommandActor;
     operationKey: string;
 }): Promise<EditQueueCommandResult>;
-export declare function steerQueuedTurnInTransaction(db: Database, input: {
+export declare function steerQueuedTurnInTransaction(db: SessionActivityDatabase, input: {
     accountId: string;
     workspaceId: string;
     sessionId: string;
@@ -137,7 +142,7 @@ export declare function steerQueuedTurnInTransaction(db: Database, input: {
     actor: SessionCommandActor;
     operationKey: string;
 }): Promise<SteerQueueCommandResult>;
-export declare function submitHumanPromptInTransaction(db: Database, input: {
+export declare function submitHumanPromptInTransaction(db: SessionActivityDatabase, input: {
     accountId: string;
     workspaceId: string;
     sessionId: string;
@@ -149,6 +154,7 @@ export declare function submitHumanPromptInTransaction(db: Database, input: {
     controlEtag?: string | null;
     expectedDraftRevision?: number | null;
     text: string;
+    annotations?: TimelineAnnotation[];
     turnInstructions?: string | null;
     resources: ResourceRef[];
     model?: string | null;
@@ -166,13 +172,15 @@ export declare function submitHumanPromptInTransaction(db: Database, input: {
         context: string;
     };
     source: "user" | "api";
+    /** Record the admitted run's durable usage fact in this transaction. */
+    recordAgentRunUsage?: boolean;
     personalConnectionDelegations?: McpPersonalConnectionDelegation[];
     mcpCredentialUpdates?: Array<{
         id: string;
         headersEncrypted: Record<string, string>;
     }>;
 }): Promise<SubmitHumanPromptResult>;
-export declare function sendAgentMessageInTransaction(db: Database, input: {
+export declare function sendAgentMessageInTransaction(db: SessionActivityDatabase, input: {
     accountId: string;
     workspaceId: string;
     targetSessionId: string;
@@ -182,7 +190,7 @@ export declare function sendAgentMessageInTransaction(db: Database, input: {
     operationKey: string;
     text: string;
 }): Promise<AgentInternalUpdateCommandResult>;
-export declare function steerAgentSessionInTransaction(db: Database, input: {
+export declare function steerAgentSessionInTransaction(db: SessionActivityDatabase, input: {
     accountId: string;
     workspaceId: string;
     targetSessionId: string;

package/dist/session-realtime-context.d.ts

@@ -1,4 +1,4 @@
-import type { Database } from "./database";
+import type { Database, SessionActivityDatabase } from "./database.js";
 export declare const SESSION_REALTIME_CONTEXT_MAX_BYTES = 65536;
 export declare const SESSION_REALTIME_TAIL_SOURCE = "transcript_tail_flush";
 export declare const SESSION_REALTIME_TAIL_INSTRUCTION = "The user just ended the realtime voice session but remains reachable by text. Ending voice changes only the communication mode; it does not stop, pause, or complete existing work. Treat the remaining transcript tail as additional context. If work was already underway, continue it from the current state. Change or stop that work only if the user explicitly requested it. If nothing was underway and the transcript contains no unhandled request, acknowledge briefly; otherwise handle any unhandled request.";
@@ -40,7 +40,7 @@ export declare function renderSessionRealtimeTail(entries: readonly SessionRealt
  * Codex-style end fence: route only finalized voice transcript after the last
  * delegation into the same canonical Steer-or-start path used by a human.
  */
-export declare function flushSessionRealtimeTranscriptTailInTransaction(db: Database, input: {
+export declare function flushSessionRealtimeTranscriptTailInTransaction(db: SessionActivityDatabase, input: {
     accountId: string;
     workspaceId: string;
     sessionId: string;

package/dist/session-realtime-ledger.d.ts

@@ -1,6 +1,6 @@
 import { type SessionRealtimeMode } from "@opengeni/contracts";
-import type { Database } from "./database";
-import { type AssertSessionRealtimeOwnerInput } from "./session-realtime";
+import type { Database, SessionActivityDatabase } from "./database.js";
+import { type AssertSessionRealtimeOwnerInput } from "./session-realtime.js";
 export declare const SESSION_REALTIME_LEDGER_MAX_BATCH = 64;
 export declare const SESSION_REALTIME_LEDGER_MAX_TEXT_BYTES = 131072;
 export declare const SESSION_REALTIME_LEDGER_MAX_PAYLOAD_BYTES = 131072;
@@ -146,7 +146,7 @@ export type AppendSessionRealtimeOutboundResult = {
     entry: SessionRealtimeLedgerEntry;
     replay: boolean;
 };
-export { projectSessionRealtimeDelegationTerminalInTransaction, type ProjectSessionRealtimeDelegationTerminalInput, type ProjectSessionRealtimeDelegationTerminalResult, } from "./session-realtime-terminal";
+export { projectSessionRealtimeDelegationTerminalInTransaction, type ProjectSessionRealtimeDelegationTerminalInput, type ProjectSessionRealtimeDelegationTerminalResult, } from "./session-realtime-terminal.js";
 export type ProjectSessionRealtimeDelegationProgressInput = {
     accountId: string;
     workspaceId: string;
@@ -169,7 +169,7 @@ export declare function claimSessionRealtimeConnectionInTransaction(db: Database
 export declare function completeSessionRealtimeConnectionInTransaction(db: Database, input: CompleteSessionRealtimeConnectionInput): Promise<CompleteSessionRealtimeConnectionResult>;
 export declare function activateSessionRealtimeConnectionInTransaction(db: Database, input: ActivateSessionRealtimeConnectionInput): Promise<ActivateSessionRealtimeConnectionResult>;
 export declare function failSessionRealtimeConnectionInTransaction(db: Database, input: FailSessionRealtimeConnectionInput): Promise<FailSessionRealtimeConnectionResult>;
-export declare function syncSessionRealtimeLedgerInTransaction(db: Database, input: SyncSessionRealtimeLedgerInput, hooks?: SyncSessionRealtimeLedgerHooks): Promise<SyncSessionRealtimeLedgerResult>;
+export declare function syncSessionRealtimeLedgerInTransaction(db: SessionActivityDatabase, input: SyncSessionRealtimeLedgerInput, hooks?: SyncSessionRealtimeLedgerHooks): Promise<SyncSessionRealtimeLedgerResult>;
 export declare function appendSessionRealtimeOutboundInTransaction(db: Database, input: AppendSessionRealtimeOutboundInput): Promise<AppendSessionRealtimeOutboundResult>;
 /**
  * Under the caller's canonical session/turn fence, mirror accepted assistant