@opengeni/db 0.28.9 → 0.36.0

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

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

@@ -1,6 +1,6 @@
 import type { HumanInputQuestion, HumanInputResponse } from "@opengeni/contracts";
-import type { Database } from "./database";
-import * as schema from "./schema";
+import type { Database } from "./database.js";
+import * as schema from "./schema.js";
 export type SessionRealtimeMirrorChannel = "speakable" | "commentary" | null;
 export type MirrorSessionRealtimeContextInput = {
     accountId: string;

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

@@ -1,2 +1,2 @@
-import type { Database } from "./database";
+import type { Database } from "./database.js";
 export declare function sessionRealtimeIsActiveInTransaction(db: Database, workspaceId: string, sessionId: string, now?: Date): Promise<boolean>;

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

@@ -1,4 +1,4 @@
-import type { Database } from "./database";
+import type { Database } from "./database.js";
 export type ProjectSessionRealtimeDelegationTerminalInput = {
     accountId: string;
     workspaceId: string;

package/dist/session-realtime.d.ts

@@ -1,7 +1,7 @@
 import type { SessionRealtimeEndReason, SessionRealtimeMode, SessionRealtimeModel } from "@opengeni/contracts";
-import type { Database } from "./database";
-import * as schema from "./schema";
-export { sessionRealtimeIsActiveInTransaction } from "./session-realtime-state";
+import type { Database, SessionActivityDatabase } from "./database.js";
+import * as schema from "./schema.js";
+export { sessionRealtimeIsActiveInTransaction } from "./session-realtime-state.js";
 export declare const SESSION_REALTIME_LEASE_MS = 30000;
 export type SessionRealtimeConflictCode = "SESSION_CANCELLED" | "CONTROL_NOT_ACTIVE" | "REALTIME_ACTIVE" | "REALTIME_NOT_FOUND" | "REALTIME_NOT_ACTIVE" | "REALTIME_OWNER_MISMATCH" | "REALTIME_VERSION_CHANGED" | "REALTIME_CONNECTION_CHANGED" | "REALTIME_CONNECTION_ACTIVE" | "REALTIME_CONNECTION_NOT_FOUND" | "REALTIME_CONNECTION_STATE_CHANGED" | "REALTIME_PROVIDER_NOT_STARTED" | "REALTIME_DELEGATION_CHANGED" | "REALTIME_ENTRY_CHANGED" | "REALTIME_ACK_INVALID";
 export declare class SessionRealtimeConflictError extends Error {
@@ -46,14 +46,14 @@ export type SessionRealtimeMutationResult = {
 export type RenewSessionRealtimeResult = SessionRealtimeMutationResult & {
     expired: boolean;
 };
-export declare function beginSessionRealtimeInTransaction(db: Database, input: BeginSessionRealtimeInput): Promise<SessionRealtimeMutationResult>;
+export declare function beginSessionRealtimeInTransaction(db: SessionActivityDatabase, input: BeginSessionRealtimeInput): Promise<SessionRealtimeMutationResult>;
 /**
  * Fence a provider connection to the exact active authenticated browser owner.
  * The caller must finish this transaction before contacting the provider; owner
  * proof is authorization material and must never cross that boundary.
  */
 export declare function assertSessionRealtimeOwnerInTransaction(db: Database, input: AssertSessionRealtimeOwnerInput): Promise<SessionRealtimeMode>;
-export declare function renewSessionRealtimeInTransaction(db: Database, input: RenewSessionRealtimeInput): Promise<RenewSessionRealtimeResult>;
-export declare function endSessionRealtimeInTransaction(db: Database, input: EndSessionRealtimeInput): Promise<SessionRealtimeMutationResult>;
+export declare function renewSessionRealtimeInTransaction(db: SessionActivityDatabase, input: RenewSessionRealtimeInput): Promise<RenewSessionRealtimeResult>;
+export declare function endSessionRealtimeInTransaction(db: SessionActivityDatabase, input: EndSessionRealtimeInput): Promise<SessionRealtimeMutationResult>;
 /** Lazily settle an expired voice lease under the canonical session lock. */
-export declare function settleExpiredSessionRealtimeInTransaction(db: Database, session: SessionRow, now?: Date): Promise<SessionRow>;
+export declare function settleExpiredSessionRealtimeInTransaction(db: SessionActivityDatabase, session: SessionRow, now?: Date): Promise<SessionRow>;

package/dist/session-tenancy.d.ts

@@ -0,0 +1,44 @@
+import { type Database } from "./database.js";
+export type SessionTenancyVisibility = "user_private" | "workspace_shared";
+export type TransitionSessionVisibilityInput = {
+    workspaceId: string;
+    sessionId: string;
+    actorSubjectId: string;
+    targetVisibility: SessionTenancyVisibility;
+    expectedAuthorityEpoch: number;
+    operationKey: string;
+};
+export type TransitionSessionVisibilityResult = {
+    operationId: string;
+    visibility: SessionTenancyVisibility;
+    authorityEpoch: number;
+    ownerOrganizationMembershipId: string | null;
+    changed: boolean;
+    replay: boolean;
+    interruptedAttemptCount: number;
+    cancelledTurnCount: number;
+    cancelledUpdateCount: number;
+    pausedGoalCount: number;
+    revokedGrantCount: number;
+};
+export type ForkSessionContentInput = {
+    sourceWorkspaceId: string;
+    sourceSessionId: string;
+    actorSubjectId: string;
+    destinationWorkspaceId: string;
+    destinationVisibility: SessionTenancyVisibility;
+    operationKey: string;
+};
+export type ForkSessionContentResult = {
+    operationId: string;
+    sessionId: string;
+    workspaceId: string;
+    visibility: SessionTenancyVisibility;
+    authorityEpoch: number;
+    copiedHistoryItemCount: number;
+    replay: boolean;
+};
+export declare function canonicalSessionVisibilityTransitionHash(input: Pick<TransitionSessionVisibilityInput, "sessionId" | "targetVisibility" | "expectedAuthorityEpoch">): string;
+export declare function canonicalSessionForkHash(input: Pick<ForkSessionContentInput, "sourceSessionId" | "destinationWorkspaceId" | "destinationVisibility">): string;
+export declare function transitionSessionVisibility(db: Database, input: TransitionSessionVisibilityInput): Promise<TransitionSessionVisibilityResult>;
+export declare function forkSessionContent(db: Database, input: ForkSessionContentInput): Promise<ForkSessionContentResult>;

package/dist/session-tenancy.js

@@ -0,0 +1,16 @@
+import {
+  canonicalSessionForkHash,
+  canonicalSessionVisibilityTransitionHash,
+  forkSessionContent,
+  transitionSessionVisibility
+} from "./chunk-F32YT7MP.js";
+import "./chunk-JC5QPLUM.js";
+import "./chunk-5KTIEDX7.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  canonicalSessionForkHash,
+  canonicalSessionVisibilityTransitionHash,
+  forkSessionContent,
+  transitionSessionVisibility
+};
+//# sourceMappingURL=session-tenancy.js.map

package/dist/session-tenancy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/session-tool-call-settlement.d.ts

@@ -1,5 +1,5 @@
 import type { SessionEvent } from "@opengeni/contracts";
-import type { Database } from "./database";
+import type { Database } from "./database.js";
 export declare const TOOL_RESULT_TYPE_BY_CALL_TYPE: Readonly<Record<string, string>>;
 export declare function historyCallId(item: Record<string, unknown>): string | null;
 export declare function historyItemType(item: Record<string, unknown>): string | null;