@opengeni/db 6.2.0 → 6.3.0-canary.36919050519001

package/dist/archived-session-imports.d.ts

@@ -0,0 +1,115 @@
+import { AppendArchivedSessionEventsRequest, ImportArchivedSessionRequest, type ArchivedSessionImportEvent, type Session, type SessionEvent, type TurnInitiator, type TurnInitiatorContext, type Permission, type AccessGrant, type FileAsset } from "@opengeni/contracts";
+import { type Database } from "./database.js";
+type ArchivedImportDependencies = {
+    createSessionWithIdempotencyKeyResult: (db: Database, input: {
+        accountId: string;
+        workspaceId: string;
+        subjectId: string;
+        visibility: "user_private" | "workspace_shared";
+        createIdempotencyKey: string;
+        initialMessage: string;
+        resources: never[];
+        skills: never[];
+        tools: never[];
+        metadata: Record<string, unknown>;
+        createdBy: TurnInitiator;
+        createdByContext?: TurnInitiatorContext;
+        model: string;
+        reasoningEffort: "low";
+        latencyMode: "standard";
+        sandboxBackend: "none";
+        variableSetIds: string[];
+        firstPartyMcpTools: never[];
+        firstPartyMcpPermissions: never[];
+        beforeCreateCommit: (tx: Database, sessionId: string, context?: {
+            created: boolean;
+        }) => Promise<void>;
+    }) => Promise<{
+        denied: false;
+        created: boolean;
+        session: {
+            id: string;
+        };
+    } | {
+        denied: true;
+    }>;
+    getFilesForSubject: (db: Database, input: {
+        accountId: string;
+        workspaceId: string;
+        subjectId: string | null;
+        fileIds: readonly string[];
+    }) => Promise<FileAsset[]>;
+    getSession: (db: Database, workspaceId: string, sessionId: string) => Promise<Session | null>;
+    getWorkspaceGrant: (db: Database, subjectId: string, workspaceId: string) => Promise<AccessGrant | null>;
+    isCreateConflict: (error: unknown) => boolean;
+    isCreateUnavailable: (error: unknown) => boolean;
+};
+/** Bind canonical session/file helpers at the root composition, never by
+ * importing that barrel back into a reexported leaf. No permissive defaults. */
+export declare function createArchivedSessionImportPersistence(dependencies: ArchivedImportDependencies): {
+    importArchivedSession: (db: Database, input: Parameters<typeof importArchivedSession>[1]) => Promise<{
+        session: Session;
+        importId: string;
+        created: boolean;
+        nextOffset: number;
+        events: SessionEvent[];
+    }>;
+    appendArchivedSessionEvents: (db: Database, input: Parameters<typeof appendArchivedSessionEvents>[1]) => Promise<{
+        sessionId: string;
+        importId: string;
+        nextOffset: number;
+        replayed: boolean;
+        events: SessionEvent[];
+    }>;
+};
+export type ArchivedSessionImportErrorCode = "SESSION_IMPORT_CONFLICT" | "SESSION_IMPORT_OFFSET_CONFLICT" | "SESSION_IMPORT_NOT_FOUND" | "SESSION_IMPORT_INVALID_FILE" | "SESSION_IMPORTED_READ_ONLY";
+export declare class ArchivedSessionImportError extends Error {
+    readonly code: ArchivedSessionImportErrorCode;
+    readonly name = "ArchivedSessionImportError";
+    constructor(code: ArchivedSessionImportErrorCode);
+}
+export declare function assertSessionIsNotImported(session: Pick<Session, "importedArchive">): void;
+export declare function canonicalArchivedSessionImportHash(value: unknown): string;
+type ImportScope = {
+    accountId: string;
+    workspaceId: string;
+    subjectId: string;
+    /** Set only from verified request ownership, never from a payload label. */
+    fileOwnerSubjectId: string | null;
+    requireLiveSubject?: boolean;
+    apiKeyId?: string;
+    requiredPermission?: Permission;
+    beforeCommit?: (tx: Database) => Promise<void>;
+};
+/** JSON is already bounded by the contract; inspect nested resources as well as
+ * the usual top-level attachment refs. Never accept another workspace's file,
+ * even when its personal-file ACL happens to allow the importing human. */
+export declare function archivedSessionImportFileIds(events: readonly ArchivedSessionImportEvent[]): string[];
+declare function importArchivedSession(db: Database, input: ImportScope & {
+    payload: ImportArchivedSessionRequest;
+    createdBy: TurnInitiator;
+    createdByContext?: TurnInitiatorContext;
+}, dependencies: ArchivedImportDependencies): Promise<{
+    session: Session;
+    importId: string;
+    created: boolean;
+    nextOffset: number;
+    events: SessionEvent[];
+}>;
+declare function appendArchivedSessionEvents(db: Database, input: ImportScope & {
+    importId: string;
+    payload: AppendArchivedSessionEventsRequest;
+    /** A host authorization decision may happen before locking, but its target
+     * and mutable database authority are verified again after the prefix. */
+    sessionId: string;
+}, dependencies: ArchivedImportDependencies): Promise<{
+    sessionId: string;
+    importId: string;
+    nextOffset: number;
+    replayed: boolean;
+    events: SessionEvent[];
+}>;
+/** Scoped lookup only. Core authorizes the resolved target; another importer
+ * never receives a session identity just because its shared timeline is visible. */
+export declare function getArchivedSessionImportId(db: Database, workspaceId: string, subjectId: string, importId: string): Promise<string | null>;
+export {};

package/dist/browser-deadline-checkpoints.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { type Database } from "./database.js";
+declare const Target: z.ZodObject<{
+    accountId: z.ZodUUID;
+    workspaceId: z.ZodUUID;
+    sandboxGroupId: z.ZodUUID;
+    leaseId: z.ZodUUID;
+    leaseEpoch: z.ZodNumber;
+    instanceId: z.ZodString;
+    browserSessionId: z.ZodUUID;
+    controllerGeneration: z.ZodString;
+}, z.core.$strip>;
+declare const Claim: z.ZodObject<{
+    operationId: z.ZodUUID;
+    state: z.ZodEnum<{
+        completed: "completed";
+        dispatched: "dispatched";
+        prepared: "prepared";
+    }>;
+}, z.core.$strip>;
+export type BrowserDeadlineCheckpointTarget = z.infer<typeof Target>;
+export type BrowserDeadlineCheckpointClaim = z.infer<typeof Claim>;
+/** Private, bounded system inventory. It contains no user session authority or profile bytes. */
+export declare function listBrowserDeadlineCheckpoints(db: Database, limit?: number): Promise<BrowserDeadlineCheckpointTarget[]>;
+/** The definer rechecks and locks the exact lease, holder, operation and controller.
+ * Preparing is allowed only after provider rotation is already requested. */
+export declare function browserDeadlineCheckpoint(db: Database, target: BrowserDeadlineCheckpointTarget, options?: {
+    prepare?: boolean;
+    touch?: boolean;
+}): Promise<BrowserDeadlineCheckpointClaim | null>;
+export {};

package/dist/browser-sessions.d.ts

@@ -2,6 +2,7 @@ import { BrowserSession, InteractionControllerBinding, type BrowserSessionCapabi
 import { type Database } from "./database.js";
 import { type BrowserStateArtifactCommitInput } from "./browser-state-artifacts.js";
 import * as schema from "./schema.js";
+import { type BrowserDeadlineCheckpointTarget } from "./browser-deadline-checkpoints.js";
 type BrowserSessionRow = typeof schema.browserSessions.$inferSelect;
 type InteractionOperationRow = typeof schema.interactionOperations.$inferSelect;
 export declare const MANAGED_BROWSER_SESSION_CAPABILITIES: {
@@ -307,6 +308,7 @@ export declare function dispatchBrowserSessionOperation(db: Database, input: {
         objectKey: string;
         cleanupAfter: Date;
     };
+    deadlineTarget?: BrowserDeadlineCheckpointTarget;
 }): Promise<InteractionLifecycleOperationReceiptValue>;
 /** Pulse one exact dispatched lifecycle operation while its controller mutation
  * is still in flight. This is not viewer or resource activity: it exists only
@@ -363,6 +365,7 @@ export declare function commitBrowserSessionSuspension(db: Database, input: {
     browserSessionId: string;
     controllerGeneration: string;
     artifact: BrowserStateArtifactCommitInput;
+    deadlineTarget?: BrowserDeadlineCheckpointTarget;
 }): Promise<BrowserSessionMutationResponseValue>;
 export declare function clearSuspendedBrowserSessionController(db: Database, input: {
     accountId: string;

package/dist/canonical-human-identities.js

@@ -11,9 +11,9 @@ import {
   getCanonicalHumanIdentityProjection,
   synchronizeCanonicalHumanLoginBindings,
   validateCanonicalHumanSession
-} from "./chunk-73ZUIXCL.js";
-import "./chunk-RTVDWDBS.js";
-import "./chunk-VHPOPKEZ.js";
+} from "./chunk-M3TGZ7B4.js";
+import "./chunk-2X2GKAC4.js";
+import "./chunk-UAR7ZDNG.js";
 import "./chunk-S2TZ3F4L.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/capability-integrations.d.ts

@@ -1,4 +1,4 @@
-import { type IntegrationSource, type McpServerConnectionRef } from "@opengeni/contracts";
+import { type IntegrationSourceInput, type McpServerConnectionRef } from "@opengeni/contracts";
 import { type Database } from "./database.js";
 export type ApiIntegrationProtocol = "openapi" | "graphql";
 export type ApiIntegrationToolSafety = "read" | "write" | "destructive";
@@ -95,6 +95,12 @@ export type InstallApiIntegrationInput = {
     requiredScopes?: string[];
     ownership?: "workspace" | "subject" | "either";
     allowedTools?: string[];
+    /**
+     * Selected write/destructive tools that run without per-call human approval.
+     * Removing an approval requirement is never a permission reduction, so it
+     * always passes installation acquisition (organization policy) again.
+     */
+    autoApprovedTools?: string[];
     facetDefinitions?: readonly ApiIntegrationFacetDefinition[];
     revision: StoredApiIntegrationRevision;
     owner?: ApiIntegrationOwner;
@@ -199,7 +205,7 @@ export declare function getApiIntegrationReconciliationSnapshot(db: Database, in
     accountId: string;
     workspaceId: string;
     subjectId: string;
-    source: IntegrationSource;
+    source: IntegrationSourceInput;
     connectionId?: string;
     instanceKey?: string;
     expectedRevisionId: string;

package/dist/capability-reconciliation.js

@@ -1,7 +1,7 @@
 import {
   withWorkspaceRls
-} from "./chunk-RTVDWDBS.js";
-import "./chunk-VHPOPKEZ.js";
+} from "./chunk-2X2GKAC4.js";
+import "./chunk-UAR7ZDNG.js";
 import "./chunk-S2TZ3F4L.js";
 import "./chunk-PZ5AY32C.js";
 

package/dist/{chunk-WKLDMSSX.js → chunk-25DAVPRJ.js}

@@ -1,7 +1,7 @@
 import {
   nestedPostgresSqlState,
   rawRows
-} from "./chunk-RTVDWDBS.js";
+} from "./chunk-2X2GKAC4.js";
 
 // src/managed-auth-session-sets.ts
 import {
@@ -296,4 +296,4 @@ export {
   reapManagedAuthIsolatedSessions,
   reapExpiredManagedAuthSessionSets
 };
-//# sourceMappingURL=chunk-WKLDMSSX.js.map
+//# sourceMappingURL=chunk-25DAVPRJ.js.map

package/dist/{chunk-RTVDWDBS.js → chunk-2X2GKAC4.js}

@@ -3,7 +3,7 @@ import {
   sessions,
   workspaceSessionActivityRevisions,
   workspaces
-} from "./chunk-VHPOPKEZ.js";
+} from "./chunk-UAR7ZDNG.js";
 import {
   LOSSLESS_CONTENT_WRITER_APPLICATION_NAME
 } from "./chunk-S2TZ3F4L.js";
@@ -756,7 +756,7 @@ async function withWorkspaceSubjectRls(db, workspaceId, subjectId, fn, transacti
     sessionTenancyFence
   );
 }
-async function withWorkspaceSubjectSessionActivityRls(db, workspaceId, subjectId, fn, transactionConfig, fenceMode = "shared") {
+async function withWorkspaceSubjectSessionActivityRls(db, workspaceId, subjectId, fn, transactionConfig, fenceMode = "shared", organizationMembershipFence = false) {
   if (!subjectId.trim()) {
     throw new Error("withWorkspaceSubjectSessionActivityRls: a non-empty subjectId is required");
   }
@@ -769,7 +769,8 @@ async function withWorkspaceSubjectSessionActivityRls(db, workspaceId, subjectId
       return await fn(scopedDb);
     },
     transactionConfig,
-    fenceMode
+    fenceMode,
+    organizationMembershipFence
   );
 }
 async function setSubjectRlsContext(db, subjectId) {
@@ -837,4 +838,4 @@ export {
   withAccountRls,
   dbBindingFor
 };
-//# sourceMappingURL=chunk-RTVDWDBS.js.map
+//# sourceMappingURL=chunk-2X2GKAC4.js.map

package/dist/{chunk-RTVDWDBS.js.map → chunk-2X2GKAC4.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/persistence-errors.ts","../src/database-timing.ts","../src/database.ts"],"sourcesContent":["export type DatabaseFailureCode = \"db_deadlock\" | \"db_serialization_failure\" | \"db_failure\";\n\nexport type PersistenceRetryOutcome = \"not_retryable\" | \"exhausted\";\n\nexport type SafeDatabaseErrorFacts = {\n  severity?: string;\n  schema?: string;\n  table?: string;\n  column?: string;\n  dataType?: string;\n  constraint?: string;\n  routine?: string;\n};\n\nexport type PersistenceFailureDetails = {\n  code: DatabaseFailureCode;\n  sqlState: string | null;\n  stage: string;\n  eventTypes: string[];\n  correlationId: string;\n  attempts: number;\n  retryOutcome: PersistenceRetryOutcome;\n  database: SafeDatabaseErrorFacts;\n};\n\nconst SQLSTATE_KEYS = [\"sqlState\", \"sqlstate\", \"code\"] as const;\nconst NESTED_ERROR_KEYS = [\"cause\", \"original\", \"driverError\", \"error\", \"errors\"] as const;\nconst RETRYABLE_DATABASE_TRANSPORT_CODES = new Set([\n  // postgres.js connection lifecycle failures.\n  \"CONNECTION_CLOSED\",\n  \"CONNECTION_DESTROYED\",\n  \"CONNECTION_ENDED\",\n  \"CONNECT_TIMEOUT\",\n  // Node socket/DNS failures surfaced unchanged by postgres.js.\n  \"EAI_AGAIN\",\n  \"ECONNABORTED\",\n  \"ECONNREFUSED\",\n  \"ECONNRESET\",\n  \"EHOSTDOWN\",\n  \"EHOSTUNREACH\",\n  \"ENETDOWN\",\n  \"ENETRESET\",\n  \"ENETUNREACH\",\n  \"ENOTFOUND\",\n  \"EPIPE\",\n  \"ETIMEDOUT\",\n]);\nconst DATABASE_ERROR_NAMES = new Set([\"DatabaseError\", \"DrizzleQueryError\", \"PostgresError\"]);\nconst DATABASE_DIAGNOSTIC_KEYS = [\n  \"severity\",\n  \"schema_name\",\n  \"table_name\",\n  \"column_name\",\n  \"data_type_name\",\n  \"constraint_name\",\n  \"routine\",\n] as const;\nconst SAFE_FACT_KEYS = [\n  [\"severity\", \"severity\"],\n  [\"schema_name\", \"schema\"],\n  [\"schema\", \"schema\"],\n  [\"table_name\", \"table\"],\n  [\"table\", \"table\"],\n  [\"column_name\", \"column\"],\n  [\"column\", \"column\"],\n  [\"data_type_name\", \"dataType\"],\n  [\"dataType\", \"dataType\"],\n  [\"constraint_name\", \"constraint\"],\n  [\"constraint\", \"constraint\"],\n  [\"routine\", \"routine\"],\n] as const;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value && typeof value === \"object\");\n}\n\nfunction safeFact(value: unknown): string | undefined {\n  if (typeof value !== \"string\" || value.length === 0) return undefined;\n  return value;\n}\n\n/** Find the driver SQLSTATE even when Drizzle wrapped it under nested causes. */\nexport function nestedPostgresSqlState(error: unknown): string | null {\n  const queue: unknown[] = [error];\n  const seen = new Set<unknown>();\n  let fallback: string | null = null;\n  while (queue.length > 0 && seen.size < 64) {\n    const current = queue.shift();\n    if (!isRecord(current) || seen.has(current)) continue;\n    seen.add(current);\n    for (const key of SQLSTATE_KEYS) {\n      const value = current[key];\n      if (typeof value !== \"string\" || !/^[0-9A-Z]{5}$/i.test(value)) continue;\n      const normalized = value.toUpperCase();\n      // Node transport codes such as EPIPE happen to be five characters but\n      // are not PostgreSQL SQLSTATEs.\n      if (RETRYABLE_DATABASE_TRANSPORT_CODES.has(normalized)) continue;\n      if (normalized === \"40P01\" || normalized === \"40001\") return normalized;\n      fallback ??= normalized;\n    }\n    for (const key of NESTED_ERROR_KEYS) {\n      const nested = current[key];\n      if (Array.isArray(nested)) queue.push(...nested);\n      else if (nested !== undefined) queue.push(nested);\n    }\n  }\n  return fallback;\n}\n\nexport function databaseFailureCode(sqlState: string | null): DatabaseFailureCode {\n  if (sqlState === \"40P01\") return \"db_deadlock\";\n  if (sqlState === \"40001\") return \"db_serialization_failure\";\n  return \"db_failure\";\n}\n\nexport function isRetryablePersistenceSqlState(sqlState: string | null): boolean {\n  return sqlState === \"40P01\" || sqlState === \"40001\";\n}\n\n/**\n * Recognize only explicit postgres.js/Node transport codes, including nested\n * driver causes. These failures can arrive as plain Errors with no SQLSTATE or\n * database diagnostic fields when the connection dies before PostgreSQL can\n * answer. Messages are intentionally ignored: they are unstable and may\n * contain connection detail.\n */\nexport function isRetryableDatabaseTransportFailure(error: unknown): boolean {\n  const queue: unknown[] = [error];\n  const seen = new Set<unknown>();\n  while (queue.length > 0 && seen.size < 64) {\n    const current = queue.shift();\n    if (!isRecord(current) || seen.has(current)) continue;\n    seen.add(current);\n\n    for (const key of [\"code\", \"errno\"] as const) {\n      const value = current[key];\n      if (\n        typeof value === \"string\" &&\n        RETRYABLE_DATABASE_TRANSPORT_CODES.has(value.toUpperCase())\n      ) {\n        return true;\n      }\n    }\n\n    for (const key of NESTED_ERROR_KEYS) {\n      const nested = current[key];\n      if (Array.isArray(nested)) queue.push(...nested);\n      else if (nested !== undefined) queue.push(nested);\n    }\n  }\n  return false;\n}\n\n/**\n * Distinguish database/ORM failures from expected domain exceptions when a\n * driver omitted SQLSTATE. This checks shape only; callers retain the original\n * failure independently as canonical error evidence.\n */\nexport function isDatabasePersistenceFailure(error: unknown): boolean {\n  if (isRetryableDatabaseTransportFailure(error) || nestedPostgresSqlState(error) !== null) {\n    return true;\n  }\n\n  const queue: unknown[] = [error];\n  const seen = new Set<unknown>();\n  while (queue.length > 0 && seen.size < 64) {\n    const current = queue.shift();\n    if (!isRecord(current) || seen.has(current)) continue;\n    seen.add(current);\n\n    if (typeof current.name === \"string\" && DATABASE_ERROR_NAMES.has(current.name)) {\n      return true;\n    }\n    if (\n      typeof current.query === \"string\" &&\n      (Object.hasOwn(current, \"params\") || Object.hasOwn(current, \"parameters\"))\n    ) {\n      return true;\n    }\n    if (DATABASE_DIAGNOSTIC_KEYS.some((key) => Object.hasOwn(current, key))) {\n      return true;\n    }\n\n    for (const key of NESTED_ERROR_KEYS) {\n      const nested = current[key];\n      if (Array.isArray(nested)) queue.push(...nested);\n      else if (nested !== undefined) queue.push(nested);\n    }\n  }\n  return false;\n}\n\n/** Extract only PostgreSQL diagnostic identifiers; never query text/parameters. */\nexport function safeDatabaseErrorFacts(error: unknown): SafeDatabaseErrorFacts {\n  const queue: unknown[] = [error];\n  const seen = new Set<unknown>();\n  const facts: SafeDatabaseErrorFacts = {};\n  while (queue.length > 0 && seen.size < 64) {\n    const current = queue.shift();\n    if (!isRecord(current) || seen.has(current)) continue;\n    seen.add(current);\n    for (const [source, destination] of SAFE_FACT_KEYS) {\n      if (facts[destination] !== undefined) continue;\n      const value = safeFact(current[source]);\n      if (value !== undefined) facts[destination] = value;\n    }\n    for (const key of NESTED_ERROR_KEYS) {\n      const nested = current[key];\n      if (Array.isArray(nested)) queue.push(...nested);\n      else if (nested !== undefined) queue.push(nested);\n    }\n  }\n  return facts;\n}\n\n/**\n * Typed persistence classification that retains the exact original failure as\n * `cause` for internal diagnostics. The ordinary Error message is deliberately\n * stable and source-free so a generic presentation path can never disclose SQL,\n * parameters, or driver detail by rendering `.message`.\n */\nexport class SessionEventPersistenceError extends Error {\n  readonly name = \"SessionEventPersistenceError\";\n\n  constructor(\n    readonly details: PersistenceFailureDetails,\n    cause?: unknown,\n  ) {\n    const label =\n      details.code === \"db_deadlock\"\n        ? \"Database deadlock\"\n        : details.code === \"db_serialization_failure\"\n          ? \"Database serialization failure\"\n          : \"Database failure\";\n    const operation = `${label} while persisting ${details.eventTypes.join(\", \") || \"session events\"}`;\n    super(operation, cause === undefined ? undefined : { cause });\n  }\n\n  get code(): DatabaseFailureCode {\n    return this.details.code;\n  }\n}\n\nexport function isSessionEventPersistenceError(\n  error: unknown,\n): error is SessionEventPersistenceError {\n  return error instanceof SessionEventPersistenceError;\n}\n\nexport type IdempotentPersistenceTransactionOptions = {\n  stage: string;\n  eventTypes?: string[];\n  maxAttempts?: number;\n  correlationId?: string;\n  onRetry?: (input: { attempt: number; sqlState: \"40P01\" | \"40001\" }) => void | Promise<void>;\n};\n\n/**\n * Retry only the supplied idempotent database transaction/savepoint. Provider\n * inference, tools, NATS, and all other external effects must remain outside\n * this function. A single correlation ID follows every persistence attempt.\n */\nexport async function runIdempotentPersistenceTransaction<T>(\n  options: IdempotentPersistenceTransactionOptions,\n  transaction: (attempt: number) => Promise<T>,\n): Promise<T> {\n  const maxAttempts = options.maxAttempts ?? 3;\n  if (!Number.isInteger(maxAttempts) || maxAttempts < 1) {\n    throw new Error(\"Persistence maxAttempts must be a positive integer\");\n  }\n  const correlationId = options.correlationId ?? crypto.randomUUID();\n  const eventTypes = [...new Set(options.eventTypes ?? [])].sort();\n  for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {\n    try {\n      return await transaction(attempt);\n    } catch (error) {\n      const sqlState = nestedPostgresSqlState(error);\n      const retryable = isRetryablePersistenceSqlState(sqlState);\n      if (retryable && attempt < maxAttempts) {\n        await options.onRetry?.({\n          attempt,\n          sqlState: sqlState as \"40P01\" | \"40001\",\n        });\n        continue;\n      }\n      if (!isDatabasePersistenceFailure(error)) throw error;\n      throw new SessionEventPersistenceError(\n        {\n          code: databaseFailureCode(sqlState),\n          sqlState,\n          stage: options.stage,\n          eventTypes,\n          correlationId,\n          attempts: attempt,\n          retryOutcome: retryable ? \"exhausted\" : \"not_retryable\",\n          database: safeDatabaseErrorFacts(error),\n        },\n        error,\n      );\n    }\n  }\n  throw new Error(\"Unreachable persistence retry state\");\n}\n","import { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport type DatabaseTimingStage =\n  | \"transaction_admission\"\n  | \"savepoint_admission\"\n  | \"rls_setup\"\n  | \"scoped_callback\";\nexport type DatabaseTimingObservation = {\n  stage: DatabaseTimingStage;\n  outcome: \"completed\" | \"failed\";\n  durationMs: number;\n};\nexport type DatabaseTimingObserver = (observation: DatabaseTimingObservation) => void;\n\nconst timingObserver = new AsyncLocalStorage<DatabaseTimingObserver>();\n\n/** Opt-in, async-local diagnostics only; no identity or query payload is retained. */\nexport function withDatabaseTimingObserver<T>(\n  observer: DatabaseTimingObserver,\n  work: () => Promise<T>,\n): Promise<T> {\n  return timingObserver.run(observer, work);\n}\n\nexport function startDatabaseTiming(\n  stage: DatabaseTimingStage,\n): (outcome: DatabaseTimingObservation[\"outcome\"]) => void {\n  const observer = timingObserver.getStore();\n  if (!observer) return () => undefined;\n  const started = performance.now();\n  let finished = false;\n  return (outcome) => {\n    if (finished) return;\n    finished = true;\n    try {\n      // Do not await observers or let rejected async observers escape either.\n      const result = observer({ stage, outcome, durationMs: performance.now() - started });\n      void Promise.resolve(result).catch(() => undefined);\n    } catch {\n      // Diagnostics must not replace database results or the original error.\n    }\n  };\n}\n","import type { SessionAttachmentReadAccess } from \"./session-file-attachments\";\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport { eq, sql, type SQL } from \"drizzle-orm\";\nimport type { PgDatabase, PgTransactionConfig } from \"drizzle-orm/pg-core\";\nimport { drizzle } from \"drizzle-orm/postgres-js\";\nimport postgres from \"postgres\";\n\nimport {\n  runIdempotentPersistenceTransaction,\n  type IdempotentPersistenceTransactionOptions,\n} from \"./persistence-errors\";\nimport { LOSSLESS_CONTENT_WRITER_APPLICATION_NAME } from \"./lossless-json\";\nimport * as schema from \"./schema\";\nimport { startDatabaseTiming } from \"./database-timing\";\n\n// §7.7 driver widening (Step I). `Database` is the structural, cross-driver\n// query-layer port: every helper in this file accepts `db: Database` and uses\n// only the methods present on drizzle's base `PgDatabase` (select/insert/update/\n// delete/transaction/execute). Widening from the concrete\n// `PostgresJsDatabase<typeof schema>` to `PgDatabase<any, typeof schema>` is a\n// pure TYPE change — no runtime behavior changes — that lets an embedded host\n// inject ANY drizzle pg driver handle (node-postgres, neon-http, etc.) bound to\n// OpenGeni's schema, not just the postgres-js handle `createDb` builds. The\n// `any` for the query-result HKT is deliberate: it keeps `db.execute(sql\\`…\\`)`\n// callable across drivers whose raw-result shapes differ (postgres-js returns a\n// row array; node-postgres returns `{ rows }`). The three raw `db.execute(…)`\n// reads that index a row array (`getManagedUserByEmail` here is the only\n// host-facing one — see `userLookup`) stay postgres-js-shaped for standalone;\n// `userLookup` is the injection seam for hosts on a different driver.\n// `PostgresJsDatabase<typeof schema>` is assignable to this, so standalone is\n// unaffected.\n\nexport type Database = PgDatabase<any, typeof schema>;\n\ndeclare const sessionActivityDatabaseBrand: unique symbol;\n\n/**\n * A workspace-scoped transaction whose session activity commit gate is open.\n * Session-row writers accept this narrower handle so new call sites cannot\n * accidentally bypass the once-per-transaction revision finalizer.\n */\nexport type SessionActivityDatabase = Database & {\n  readonly [sessionActivityDatabaseBrand]: true;\n};\n\nexport type DbClient = {\n  db: Database;\n  close: () => Promise<void>;\n};\n\nexport type RlsContext = {\n  accountId: string;\n  workspaceId?: string | null;\n};\n\nexport type SessionRlsActorContext = {\n  /** Server-authorized session attachment scope; never taken from request JSON. */\n  sessionAttachmentReadAccess?: SessionAttachmentReadAccess;\n  subjectId: string;\n  /** Host-verified personal file ownership, never a request-supplied subject. */\n  privateFileOwnerSubjectId?: string | null;\n  initiatingHumanSubjectId?: string | null;\n};\n\nconst sessionRlsActorContext = new AsyncLocalStorage<SessionRlsActorContext>();\nexport function currentSessionAttachmentReadAccess(): SessionAttachmentReadAccess | undefined {\n  return sessionRlsActorContext.getStore()?.sessionAttachmentReadAccess;\n}\n\n/**\n * Stable identity of the ambient session RLS actor: every field that\n * `setRlsContext` turns into database-visible GUCs or that scoped reads\n * consult. Two callers with equal keys see exactly the same rows, so the key\n * is safe for sharing a read result between them; `null` means no actor, in\n * which case the subject GUC stays empty for every such caller.\n */\nexport function currentSessionRlsActorIdentityKey(): string | null {\n  const actor = sessionRlsActorContext.getStore();\n  if (!actor) return null;\n  return JSON.stringify([\n    actor.subjectId,\n    actor.initiatingHumanSubjectId ?? null,\n    actor.privateFileOwnerSubjectId ?? null,\n    actor.sessionAttachmentReadAccess ?? null,\n  ]);\n}\n\nexport async function withSessionRlsActorContext<T>(\n  actor: SessionRlsActorContext,\n  fn: () => Promise<T>,\n): Promise<T> {\n  if (!actor.subjectId.trim()) {\n    throw new Error(\"withSessionRlsActorContext: a non-empty subjectId is required\");\n  }\n  if (\n    actor.initiatingHumanSubjectId !== undefined &&\n    actor.initiatingHumanSubjectId !== null &&\n    !actor.initiatingHumanSubjectId.trim()\n  ) {\n    throw new Error(\n      \"withSessionRlsActorContext: initiatingHumanSubjectId must be null or non-empty\",\n    );\n  }\n  if (\n    actor.privateFileOwnerSubjectId !== undefined &&\n    actor.privateFileOwnerSubjectId !== null &&\n    !actor.privateFileOwnerSubjectId.trim()\n  ) {\n    throw new Error(\n      \"withSessionRlsActorContext: privateFileOwnerSubjectId must be null or non-empty\",\n    );\n  }\n  return await sessionRlsActorContext.run(actor, fn);\n}\n\ntype RlsContextSettings = {\n  accountId: string;\n  workspaceId: string;\n};\n\n/**\n * RLS posture for the connection OpenGeni's query layer runs over (Step I, §7.7).\n *\n * - `\"force\"` (DEFAULT — today's standalone behavior, byte-for-byte): OpenGeni\n *   connects as a NON-OWNER role (`opengeni_app`) and every table carries\n *   `FORCE ROW LEVEL SECURITY`, so the workspace/account GUCs set by\n *   `setRlsContext` are the ONLY thing that admits rows — even the table owner\n *   is subject to RLS. This is the Fork-A isolation guarantee.\n * - `\"scoped\"` (embedded Fork-B opt-in): the host runs OpenGeni's queries over a\n *   role that OWNS the dedicated schema (RLS need not be forced for that role),\n *   relying on the host's own tenant boundary. OpenGeni STILL emits the\n *   `set_config('opengeni.account_id'/'workspace_id', …)` GUCs defensively on\n *   every scoped query, so the application query path is byte-identical between\n *   the two strategies and the app code is RLS-mode-agnostic. The strategy is a\n *   declared posture (consumed by `provisionRoles` and as a documented\n *   invariant), NOT a query-path branch — there is deliberately no `if\n *   (strategy === …)` anywhere in the helpers below. Picking `\"scoped\"` does not\n *   relax any GUC; it only changes which DB role the host provisions/connects as\n *   and asserts that the host accepts owning the isolation boundary.\n */\nexport type RlsStrategy = \"force\" | \"scoped\";\n\n/**\n * Resolve a host-IdP/Better-Auth user *identifier* by email. Injected via\n * `createDb({ userLookup })` (Step I). UNSET → today's raw parameterized select\n * against Better Auth's `auth_users` table (see `getManagedUserByEmail`), which\n * relies on the postgres-js array-shaped `db.execute` result. An embedded host\n * whose identity lives elsewhere (a different IdP table, a different driver, or\n * a non-`auth_users` user store) injects this closure so OpenGeni never touches\n * `auth_users` directly. Returns the user id, or null when no such user exists.\n */\nexport type UserLookup = (db: Database, email: string) => Promise<string | null>;\n\nexport type ManagedUserProfile = {\n  id: string;\n  name: string | null;\n  email: string;\n};\n\n/** Host identity projection used by organization administration rosters. */\nexport type UserProfileLookup = (\n  db: Database,\n  userIds: readonly string[],\n) => Promise<ManagedUserProfile[]>;\n\nexport type CreateDbOptions = {\n  /**\n   * The Postgres `search_path` for this connection (Step I, §7.8 runtime half).\n   * UNSET → today's behavior: NO `search_path` startup parameter is sent, so the\n   * server default applies (`public` for standalone, where every table + the\n   * `vector` extension + `gen_random_uuid()` live). For an embedded dedicated\n   * schema, pass e.g. `\"opengeni,opengeni_private,public\"` — postgres-js sends\n   * it as a per-session startup parameter (the supported, query-param-free way;\n   * URL `?search_path=` is IGNORED by postgres-js). Keep `public` LAST so the\n   * `vector` type and `gen_random_uuid()` (which live in `public` on the\n   * pgvector image) still resolve — the schema-isolation contract live footgun.\n   */\n  searchPath?: string;\n  /** RLS posture; defaults to `\"force\"` (today's standalone). */\n  rlsStrategy?: RlsStrategy;\n  /** Host-provided user-by-email resolver; unset → today's raw `auth_users` query. */\n  userLookup?: UserLookup;\n  /** Host-provided user profile projection; unset → standalone `auth_users`. */\n  userProfileLookup?: UserProfileLookup;\n  /** postgres-js pool size; defaults to today's `10`. */\n  max?: number;\n  /**\n   * Connection-local default transaction isolation sent in the postgres-js\n   * startup parameters. This is intentionally not a role/database default:\n   * tests and embedded callers can exercise a different ambient isolation\n   * without mutating a shared PostgreSQL role or affecting other connections.\n   */\n  isolationLevel?: postgres.ConnectionParameters[\"default_transaction_isolation\"];\n};\n\n/**\n * The active RLS strategy + userLookup for an injected `Database`, recorded in a\n * side WeakMap so helpers (and `getManagedUserByEmail`) can consult the host's\n * binding without changing every call signature. A handle with no recorded\n * config (e.g. one built outside `createDb`, or in a test) falls back to the\n * standalone defaults: `rlsStrategy: \"force\"`, raw `auth_users` lookup.\n */\ntype DbBinding = {\n  rlsStrategy: RlsStrategy;\n  userLookup?: UserLookup;\n  userProfileLookup?: UserProfileLookup;\n};\n\nconst dbBindings = new WeakMap<object, DbBinding>();\n\n/** The strategy bound to a handle (or the `\"force\"` default). */\nexport function rlsStrategyFor(db: Database): RlsStrategy {\n  return dbBindings.get(db as unknown as object)?.rlsStrategy ?? \"force\";\n}\n\n/**\n * Run a raw SQL query and read its rows as a typed array.\n *\n * Why this exists: the Step I driver widening (`Database = PgDatabase<any, …>`)\n * deliberately sets the query-result HKT to `any` so `db.execute(…)` is callable\n * across drivers whose raw-result shapes differ (postgres-js → row array;\n * node-postgres → `{ rows }`). A side effect is that `db.execute<T>(…)` now\n * resolves to `any`, erasing the per-row element type at the call site. OpenGeni's\n * OWN internal raw queries usually run over the postgres-js handle `createDb`\n * builds (array result), while an embedded host may inject a node-postgres style\n * driver (`{ rows }`). Normalize those two standard shapes in one place; reject\n * an unknown driver result rather than silently treating it as an empty query.\n */\nexport async function rawRows<T extends Record<string, unknown>>(\n  executor: Pick<Database, \"execute\">,\n  query: SQL,\n): Promise<T[]> {\n  const result = await executor.execute<T>(query);\n  if (Array.isArray(result)) {\n    return result as unknown as T[];\n  }\n  const rows = (result as unknown as { rows?: unknown }).rows;\n  if (Array.isArray(rows)) {\n    return rows as T[];\n  }\n  throw new Error(\"Unsupported database execute() result shape\");\n}\n\nexport type SandboxProviderReadLockIdentity = {\n  workspaceId: string;\n  sandboxGroupId: string;\n  leaseEpoch: number;\n  instanceId: string;\n};\n\nexport class SandboxProviderReadLockUnavailableError extends Error {\n  constructor() {\n    super(\"Sandbox provider reads are temporarily busy. Retry the request.\");\n    this.name = \"SandboxProviderReadLockUnavailableError\";\n  }\n}\n\nconst SANDBOX_PROVIDER_READ_LOCK_WAIT_MS = 15_000;\nconst SANDBOX_PROVIDER_READ_LOCK_POLL_MAX_MS = 200;\n\nfunction sandboxProviderReadLockKey(identity: SandboxProviderReadLockIdentity): string {\n  return [\n    \"sandbox-provider-read\",\n    identity.workspaceId,\n    identity.sandboxGroupId,\n    identity.leaseEpoch,\n    identity.instanceId,\n  ].join(\":\");\n}\n\nasync function waitForSandboxProviderReadLockPoll(\n  delayMs: number,\n  signal?: AbortSignal | undefined,\n): Promise<void> {\n  if (signal?.aborted) {\n    throw signal.reason ?? new DOMException(\"The operation was aborted\", \"AbortError\");\n  }\n  await new Promise<void>((resolve, reject) => {\n    let settled = false;\n    let timer: ReturnType<typeof setTimeout>;\n    const cleanup = () => signal?.removeEventListener(\"abort\", abort);\n    const finish = () => {\n      if (settled) return;\n      settled = true;\n      cleanup();\n      resolve();\n    };\n    const abort = () => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      cleanup();\n      reject(signal?.reason ?? new DOMException(\"The operation was aborted\", \"AbortError\"));\n    };\n    timer = setTimeout(finish, delayMs);\n    signal?.addEventListener(\"abort\", abort, { once: true });\n    if (signal?.aborted) abort();\n  });\n}\n\n/**\n * Cross-process exclusive boundary for one exact live provider instance's\n * API-direct read request. Modal accepts concurrent commands from one attached\n * handle, but independent API replicas reconstruct different handles; issuing\n * overlapping command groups through those handles can make an otherwise valid\n * read fail transiently. Keep concurrency inside one batched request while\n * serializing only separate requests that target the same lease identity.\n *\n * The callback intentionally runs while one transaction-pinned DB connection\n * holds the advisory lock. The direct lease holder separately prevents drain,\n * and the abort-aware bounded poll prevents a disconnected HTTP request from\n * occupying the connection indefinitely.\n */\nexport async function withSandboxProviderReadLock<T>(\n  db: Database,\n  identity: SandboxProviderReadLockIdentity,\n  signal: AbortSignal | undefined,\n  fn: () => Promise<T>,\n): Promise<T> {\n  const key = sandboxProviderReadLockKey(identity);\n  const deadline = Date.now() + SANDBOX_PROVIDER_READ_LOCK_WAIT_MS;\n  return await db.transaction(async (lockedDb) => {\n    let pollMs = 20;\n    while (true) {\n      if (signal?.aborted) {\n        throw signal.reason ?? new DOMException(\"The operation was aborted\", \"AbortError\");\n      }\n      const [row] = await rawRows<{ acquired: boolean }>(\n        lockedDb,\n        sql`select pg_try_advisory_xact_lock(hashtextextended(${key}, 0)) as acquired`,\n      );\n      if (row?.acquired === true) return await fn();\n      const remainingMs = deadline - Date.now();\n      if (remainingMs <= 0) throw new SandboxProviderReadLockUnavailableError();\n      await waitForSandboxProviderReadLockPoll(Math.min(pollMs, remainingMs), signal);\n      pollMs = Math.min(pollMs * 2, SANDBOX_PROVIDER_READ_LOCK_POLL_MAX_MS);\n    }\n  });\n}\n\nexport function createDb(databaseUrl: string, options: CreateDbOptions = {}): DbClient {\n  // `prepare: false` is REQUIRED for Azure Database for PostgreSQL Flexible\n  // Server's transaction-pooling PgBouncer: postgres-js's default named prepared\n  // statements (`s_N`) are bound to one backend, but a transaction pooler hands\n  // each transaction a different backend, so a later `execute` intermittently\n  // throws `prepared statement \"s_N\" does not exist`. Every RLS read in this\n  // module (set_config + SELECT inside one db.transaction) rides on this pool, so\n  // the failure surfaces as a \"worked, then didn't\" credential/permission read.\n  // idle_timeout + max_lifetime recycle connections so a pooler-recycled backend\n  // is never reused indefinitely; application_name aids server-side diagnostics.\n  const client = postgres(databaseUrl, {\n    max: options.max ?? 10,\n    prepare: false,\n    idle_timeout: 30,\n    max_lifetime: 1800,\n    // `connection` carries per-session Postgres STARTUP parameters. The exact\n    // `application_name` is also the PgBouncer-compatible current-image receipt\n    // for migration 0352's restrictive sessions policy; arbitrary custom startup\n    // parameters are not portable through transaction poolers. `search_path`\n    // (embedded only) is the supported, query-param-free way to scope a connection\n    // to a dedicated schema — postgres-js IGNORES a URL `?search_path=`. Unset\n    // searchPath → omit it so the server default (`public`) is unchanged for\n    // standalone.\n    connection: {\n      application_name: LOSSLESS_CONTENT_WRITER_APPLICATION_NAME,\n      ...(options.searchPath ? { search_path: options.searchPath } : {}),\n      ...(options.isolationLevel ? { default_transaction_isolation: options.isolationLevel } : {}),\n    },\n  });\n  const db = drizzle(client, { schema });\n  dbBindings.set(db as unknown as object, {\n    rlsStrategy: options.rlsStrategy ?? \"force\",\n    ...(options.userLookup ? { userLookup: options.userLookup } : {}),\n    ...(options.userProfileLookup ? { userProfileLookup: options.userProfileLookup } : {}),\n  });\n  return {\n    db,\n    close: async () => {\n      await client.end();\n    },\n  };\n}\n\n/**\n * Register a host's `rlsStrategy`/`userLookup` against an externally-constructed\n * `Database` handle (e.g. one the embedded host built from its own driver and\n * injected, rather than via `createDb`). Lets the same WeakMap-backed lookups\n * work for injected handles. Standalone never calls this (it uses `createDb`).\n */\nexport function registerDbBinding(\n  db: Database,\n  binding: {\n    rlsStrategy?: RlsStrategy;\n    userLookup?: UserLookup;\n    userProfileLookup?: UserProfileLookup;\n  },\n): void {\n  dbBindings.set(db as unknown as object, {\n    rlsStrategy: binding.rlsStrategy ?? \"force\",\n    ...(binding.userLookup ? { userLookup: binding.userLookup } : {}),\n    ...(binding.userProfileLookup ? { userProfileLookup: binding.userProfileLookup } : {}),\n  });\n}\n\nexport async function setRlsContext(db: Database, context: RlsContext): Promise<void> {\n  // Fail loud on an empty/blank account id: a \"\" account would set an RLS GUC\n  // that matches no tenant row, silently returning zero rows from every scoped\n  // read (a phantom \"not found\" / \"no active subscription\"). An RLS context with\n  // no account is always a bug at the call site, never a valid query scope.\n  if (typeof context.accountId !== \"string\" || context.accountId.trim() === \"\") {\n    throw new Error(\"setRlsContext: a non-empty accountId is required to establish an RLS context\");\n  }\n  // Transaction-local writer identity covers supported injected/embedded\n  // database handles whose connection-level application_name is host-owned.\n  // Standalone createDb connections also carry version receipts in their exact\n  // application_name, while old OpenGeni binaries set neither current receipt.\n  await db.execute(sql`select\n    set_config('opengeni.account_id', ${context.accountId}, true),\n    set_config('opengeni.workspace_id', ${context.workspaceId ?? \"\"}, true),\n    set_config('opengeni.lossless_content_writer', '1', true),\n    set_config('opengeni.sandbox_recovery_protocol_v2', '1', true),\n    set_config('opengeni.pending_tool_event_output_v1', '1', true),\n    set_config('opengeni.session_variable_set_attachments_v1', '1', true)`);\n  const sessionActor = sessionRlsActorContext.getStore();\n  if (sessionActor) {\n    await setSubjectRlsContext(db, sessionActor.subjectId);\n    await db.execute(\n      sql`select set_config('opengeni.private_file_owner', ${sessionActor.privateFileOwnerSubjectId ?? \"\"}, true), set_config(\n        'opengeni.initiating_human_subject_id',\n        ${sessionActor.initiatingHumanSubjectId ?? \"\"},\n        true\n      )`,\n    );\n  }\n}\n\nasync function readRlsContextSettings(db: Database): Promise<RlsContextSettings> {\n  const [settings] = await rawRows<{\n    account_id: string | null;\n    workspace_id: string | null;\n  }>(\n    db,\n    sql`select\n      current_setting('opengeni.account_id', true) as account_id,\n      current_setting('opengeni.workspace_id', true) as workspace_id`,\n  );\n  return {\n    accountId: settings?.account_id ?? \"\",\n    workspaceId: settings?.workspace_id ?? \"\",\n  };\n}\n\nasync function assertRlsContextApplied(db: Database, context: RlsContext): Promise<void> {\n  const applied = await readRlsContextSettings(db);\n  const expectedWorkspaceId = context.workspaceId ?? \"\";\n  if (applied.accountId !== context.accountId) {\n    throw new Error(\n      `RLS context not applied on the active backend: expected account ${context.accountId}, got \"${applied.accountId}\"`,\n    );\n  }\n  if (applied.workspaceId !== expectedWorkspaceId) {\n    throw new Error(\n      `RLS context not applied on the active backend: expected workspace \"${expectedWorkspaceId}\", got \"${applied.workspaceId}\"`,\n    );\n  }\n}\n\nasync function restoreRlsContextSettings(\n  db: Database,\n  settings: RlsContextSettings,\n): Promise<void> {\n  const [restored] = await rawRows<{\n    account_id: string;\n    workspace_id: string;\n  }>(\n    db,\n    sql`select\n      set_config('opengeni.account_id', ${settings.accountId}, true) as account_id,\n      set_config('opengeni.workspace_id', ${settings.workspaceId}, true) as workspace_id`,\n  );\n  if (\n    restored?.account_id !== settings.accountId ||\n    restored.workspace_id !== settings.workspaceId\n  ) {\n    throw new Error(\"RLS context could not be restored after a nested scope\");\n  }\n}\n\nexport async function withRlsContext<T>(\n  db: Database,\n  context: RlsContext,\n  fn: (db: Database) => Promise<T>,\n  transactionConfig?: PgTransactionConfig,\n  sessionTenancyFence: \"shared\" | \"none\" = \"shared\",\n): Promise<T> {\n  const restoreParentScope = isTransactionHandle(db);\n  // Callback entry includes connection admission AND BEGIN/SAVEPOINT round-trip.\n  // This is deliberately not advertised as pure pool wait.\n  const admission = startDatabaseTiming(\n    restoreParentScope ? \"savepoint_admission\" : \"transaction_admission\",\n  );\n  try {\n    return await db.transaction(async (tx) => {\n      admission(\"completed\");\n      const setup = startDatabaseTiming(\"rls_setup\");\n      const scoped = tx as unknown as Database;\n      let parentScope: RlsContextSettings | null;\n      try {\n        parentScope = restoreParentScope ? await readRlsContextSettings(scoped) : null;\n        await setRlsContext(scoped, context);\n        if (context.workspaceId && sessionTenancyFence === \"shared\") {\n          await scoped.execute(\n            sql`select pg_advisory_xact_lock_shared(hashtextextended(${`session-tenancy:${context.workspaceId}`}, 0))`,\n          );\n        }\n        // Defense-in-depth: read the LOCAL GUC back on THIS backend BEFORE running\n        // the scoped query. The set_config and this read share one db.transaction,\n        // which a transaction pooler pins to a single backend — so a mismatch here\n        // means the context was genuinely lost (a torn transaction / pooler backend\n        // swap), not normal operation. Without this guard such an event runs the\n        // scoped read with an empty account_id and returns zero RLS-visible rows,\n        // manufacturing a phantom \"no active subscription\" from a credential that is\n        // in fact active. Convert that silent false into a loud, root-cause-bearing\n        // error so the caller can retry rather than permanently mis-decide.\n        await assertRlsContextApplied(scoped, context);\n        setup(\"completed\");\n      } catch (error) {\n        setup(\"failed\");\n        throw error;\n      }\n      const callback = startDatabaseTiming(\"scoped_callback\");\n      let value: T;\n      try {\n        value = await fn(scoped);\n        callback(\"completed\");\n      } catch (error) {\n        callback(\"failed\");\n        throw error;\n      }\n      // A nested transaction is a savepoint, and SET LOCAL survives successful\n      // savepoint release. Restore only the tenant scope the nested helper owns;\n      // writer/protocol capabilities intentionally remain transaction-wide.\n      if (parentScope) await restoreRlsContextSettings(scoped, parentScope);\n      return value;\n    }, transactionConfig);\n  } catch (error) {\n    // No-op after callback entry; only admission failures are counted here.\n    admission(\"failed\");\n    throw error;\n  }\n}\n\n/**\n * Run one bounded database operation on a transaction-pinned backend.\n *\n * Callers that also have an application deadline should check their abort\n * signal before returning from `fn`; throwing there rolls the transaction back\n * even when the application deadline won a surrounding Promise race.\n */\nexport async function withDatabaseStatementTimeout<T>(\n  db: Database,\n  timeoutMs: number,\n  fn: (db: Database) => Promise<T>,\n): Promise<T> {\n  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n    throw new Error(\"withDatabaseStatementTimeout requires a positive timeout\");\n  }\n  const boundedTimeoutMs = Math.max(1, Math.floor(timeoutMs));\n  return await db.transaction(async (tx) => {\n    const scoped = tx as unknown as Database;\n    await scoped.execute(\n      sql`select set_config('statement_timeout', ${`${boundedTimeoutMs}ms`}, true)`,\n    );\n    return await fn(scoped);\n  });\n}\n\nexport async function rlsContextForWorkspace(\n  db: Database,\n  workspaceId: string,\n): Promise<RlsContext> {\n  const [row] = await db\n    .select({ accountId: schema.workspaces.accountId })\n    .from(schema.workspaces)\n    .where(eq(schema.workspaces.id, workspaceId))\n    .limit(1);\n  if (!row) {\n    throw new Error(`Workspace not found: ${workspaceId}`);\n  }\n  return { accountId: row.accountId, workspaceId };\n}\n\nexport async function withWorkspaceRls<T>(\n  db: Database,\n  workspaceId: string,\n  fn: (db: Database) => Promise<T>,\n  transactionConfig?: PgTransactionConfig,\n): Promise<T> {\n  return await withRlsContext(\n    db,\n    await rlsContextForWorkspace(db, workspaceId),\n    fn,\n    transactionConfig,\n  );\n}\n\ntype SessionActivityGate = {\n  db: SessionActivityDatabase;\n  owner: boolean;\n};\n\nfunction isTransactionHandle(db: Database): boolean {\n  return typeof (db as Database & { rollback?: unknown }).rollback === \"function\";\n}\n\nasync function assertSessionActivityGateEntry(db: Database): Promise<void> {\n  if (!isTransactionHandle(db)) return;\n  const [gate] = await rawRows<{ state: string | null }>(\n    db,\n    sql`\n      select nullif(\n        current_setting('opengeni.session_activity_gate_state', true),\n        ''\n      ) as state\n    `,\n  );\n  if (gate?.state === null || gate === undefined) {\n    throw new Error(\"Session activity commit gate must start at the outer transaction boundary\");\n  }\n}\n\nasync function beginSessionActivityGate(\n  db: Database,\n  workspaceId: string,\n): Promise<SessionActivityGate> {\n  const [gate] = await rawRows<{\n    prior_state: string | null;\n    prior_workspace_id: string | null;\n  }>(\n    db,\n    sql`\n      with current_gate as materialized (\n        select\n          nullif(current_setting('opengeni.session_activity_gate_state', true), '') as prior_state,\n          nullif(current_setting('opengeni.session_activity_gate_workspace_id', true), '') as prior_workspace_id\n      )\n      select\n        prior_state,\n        prior_workspace_id,\n        case\n          when prior_state is null\n            then set_config('opengeni.session_activity_gate_state', 'open', true)\n          else prior_state\n        end as effective_state,\n        case\n          when prior_state is null\n            then set_config('opengeni.session_activity_gate_workspace_id', ${workspaceId}, true)\n          else prior_workspace_id\n        end as effective_workspace_id\n      from current_gate\n    `,\n  );\n  if (!gate) {\n    throw new Error(\"Session activity commit gate could not be opened\");\n  }\n  if (gate.prior_state === null) {\n    return { db: db as SessionActivityDatabase, owner: true };\n  }\n  if (gate.prior_state === \"open\" && gate.prior_workspace_id === workspaceId) {\n    return { db: db as SessionActivityDatabase, owner: false };\n  }\n  throw new Error(\"Session activity commit gate is already owned by another transaction scope\");\n}\n\nasync function finalizeSessionActivityGate(\n  db: SessionActivityDatabase,\n  workspaceId: string,\n): Promise<void> {\n  // Resolve every deferred FK/constraint before taking the shared workspace\n  // counter. The only row writes after that point stamp session rows already\n  // modified and therefore already owned by this transaction.\n  await db.execute(\n    sql`select set_config('opengeni.session_activity_gate_state', 'preparing', true)`,\n  );\n  await db.execute(sql`set constraints all immediate`);\n  // The first flush proves every pre-existing deferred obligation. Re-defer\n  // only our commit guard so the marker-clearing writes below queue a fresh\n  // proof against the final row state, then force that proof before returning.\n  await db.execute(\n    sql`set constraints sessions_activity_insert_commit_guard, sessions_activity_update_commit_guard deferred`,\n  );\n  const [result] = await rawRows<{\n    had_pending: boolean;\n    pending_count: number;\n    revision: string | null;\n    stamped_count: number;\n  }>(\n    db,\n    sql`\n      with gate as materialized (\n        select set_config('opengeni.session_activity_gate_state', 'finalizing', true) as state\n      ),\n      pending as materialized (\n        select ${schema.sessions.id}\n        from ${schema.sessions}\n        cross join gate\n        where ${schema.sessions.workspaceId} = ${workspaceId}\n          and ${schema.sessions.activityRevisionPendingXid}\n            = pg_current_xact_id()::text::bigint\n      ),\n      advanced as (\n        update ${schema.workspaceSessionActivityRevisions} as counter\n        set revision = counter.revision + 1\n        where counter.workspace_id = ${workspaceId}\n          and exists (select 1 from pending)\n        returning counter.revision\n      ),\n      stamped as (\n        update ${schema.sessions} as session\n        set\n          activity_revision = advanced.revision,\n          activity_revision_pending_xid = null\n        from advanced\n        where session.workspace_id = ${workspaceId}\n          and session.activity_revision_pending_xid\n            = pg_current_xact_id()::text::bigint\n        returning session.id\n      ),\n      stats as materialized (\n        select\n          exists (select 1 from pending) as had_pending,\n          (select count(*)::integer from pending) as pending_count,\n          (select revision::text from advanced) as revision,\n          (select count(*)::integer from stamped) as stamped_count\n      ),\n      finalized as materialized (\n        select\n          had_pending,\n          pending_count,\n          revision,\n          stamped_count,\n          set_config('opengeni.session_activity_gate_state', 'finalized', true) as state\n        from stats\n      )\n      select had_pending, pending_count, revision, stamped_count\n      from finalized\n    `,\n  );\n  if (!result) {\n    throw new Error(\"Session activity commit gate did not return a finalization result\");\n  }\n  if (result.had_pending && result.revision === null) {\n    throw new Error(\"Workspace session activity counter is unavailable\");\n  }\n  if (result.stamped_count !== result.pending_count) {\n    throw new Error(\"Session activity commit gate did not stamp every pending row\");\n  }\n  await db.execute(\n    sql`set constraints sessions_activity_insert_commit_guard, sessions_activity_update_commit_guard immediate`,\n  );\n  // A restored activity scope can be followed by another workspace scope, or\n  // by a SECURITY DEFINER lifecycle that opens and finalizes its own gate in\n  // the same outer transaction. Keep the guards deferred after proving this\n  // scope's final state so those later writes reach their own finalizer instead\n  // of firing the commit guard at the first session update.\n  await db.execute(\n    sql`set constraints sessions_activity_insert_commit_guard, sessions_activity_update_commit_guard deferred`,\n  );\n}\n\n/**\n * Run one workspace transaction with explicit once-per-transaction session\n * activity finalization. Nested callers reuse the outer gate; only its owner\n * finalizes immediately before the enclosing RLS transaction commits.\n */\nexport async function withSessionActivityRlsContext<T>(\n  db: Database,\n  context: RlsContext & { workspaceId: string },\n  fn: (db: SessionActivityDatabase) => Promise<T>,\n  transactionConfig?: PgTransactionConfig,\n  fenceMode: \"shared\" | \"none\" = \"shared\",\n  organizationMembershipFence = false,\n): Promise<T> {\n  await assertSessionActivityGateEntry(db);\n  return await withRlsContext(\n    db,\n    context,\n    async (scopedDb) => {\n      if (organizationMembershipFence) {\n        // Claim can inherit membership-fenced authority after locking sessions.\n        // Acquire membership before even a shared tenancy fence: an exclusive\n        // tenancy/control waiter can otherwise complete the same lock cycle.\n        await scopedDb.execute(sql`select pg_advisory_xact_lock(\n          hashtextextended(${`organization-membership:${context.accountId}`}, 0))`);\n        if (fenceMode === \"shared\") {\n          await scopedDb.execute(sql`select pg_advisory_xact_lock_shared(\n            hashtextextended(${`session-tenancy:${context.workspaceId}`}, 0))`);\n        }\n      }\n      const gate = await beginSessionActivityGate(scopedDb, context.workspaceId);\n      const value = await fn(gate.db);\n      // The finalizer must never trust tenant GUCs that arbitrary callback code\n      // could have changed. Nested RLS helpers restore their parent scope; this\n      // assertion is the fail-closed commit-boundary proof for every other path.\n      await assertRlsContextApplied(gate.db, context);\n      if (gate.owner) {\n        await finalizeSessionActivityGate(gate.db, context.workspaceId);\n      }\n      return value;\n    },\n    transactionConfig,\n    organizationMembershipFence ? \"none\" : fenceMode,\n  );\n}\n\nexport async function withWorkspaceSessionActivityRls<T>(\n  db: Database,\n  workspaceId: string,\n  fn: (db: SessionActivityDatabase) => Promise<T>,\n  transactionConfig?: PgTransactionConfig,\n): Promise<T> {\n  return await withSessionActivityRlsContext(\n    db,\n    { ...(await rlsContextForWorkspace(db, workspaceId)), workspaceId },\n    fn,\n    transactionConfig,\n  );\n}\n\n/**\n * Run one of several ordered workspace activity scopes inside a caller-owned\n * transaction. Each scope is fully finalized before restoring the caller's\n * gate GUCs, so the next workspace can reuse the same outer transaction.\n */\nexport async function withRestoredSessionActivityRlsContext<T>(\n  db: Database,\n  context: RlsContext & { workspaceId: string },\n  fn: (db: SessionActivityDatabase) => Promise<T>,\n): Promise<T> {\n  if (!isTransactionHandle(db)) {\n    throw new Error(\"Sequential workspace activity scopes require a caller-owned transaction\");\n  }\n  const [prior] = await rawRows<{ state: string; workspace_id: string }>(\n    db,\n    sql`select\n      coalesce(current_setting('opengeni.session_activity_gate_state', true), '') as state,\n      coalesce(\n        current_setting('opengeni.session_activity_gate_workspace_id', true), ''\n      ) as workspace_id`,\n  );\n  try {\n    return await withRlsContext(db, context, async (scopedDb) => {\n      const gate = await beginSessionActivityGate(scopedDb, context.workspaceId);\n      if (!gate.owner) {\n        throw new Error(\"Sequential workspace activity scope unexpectedly reused an open gate\");\n      }\n      const value = await fn(gate.db);\n      await assertRlsContextApplied(gate.db, context);\n      await finalizeSessionActivityGate(gate.db, context.workspaceId);\n      return value;\n    });\n  } finally {\n    await db.execute(sql`select\n      set_config('opengeni.session_activity_gate_state', ${prior?.state ?? \"\"}, true),\n      set_config(\n        'opengeni.session_activity_gate_workspace_id', ${prior?.workspace_id ?? \"\"}, true\n      )`);\n  }\n}\n\n/**\n * Open one nested savepoint without losing the gate brand. Drizzle correctly\n * preserves the backend-local gate GUCs, but its structural transaction type\n * cannot express that provenance; keep the single trusted rebrand here.\n */\nexport async function withSessionActivitySavepoint<T>(\n  db: SessionActivityDatabase,\n  fn: (db: SessionActivityDatabase) => Promise<T>,\n): Promise<T> {\n  return await db.transaction(async (tx) => await fn(tx as unknown as SessionActivityDatabase));\n}\n\nexport async function retrySessionActivityRls<T>(\n  db: Database,\n  workspaceId: string,\n  options: IdempotentPersistenceTransactionOptions & {\n    /** Claim can inherit membership-fenced causal authority after locking the\n     * session. Acquire that fence before tenancy/control/session instead. An\n     * enclosing transaction must preserve this same lock prefix. */\n    organizationMembershipFence?: boolean;\n  },\n  fn: (db: SessionActivityDatabase) => Promise<T>,\n): Promise<T> {\n  return await runIdempotentPersistenceTransaction(options, async () => {\n    if (options.organizationMembershipFence) {\n      const context = { ...(await rlsContextForWorkspace(db, workspaceId)), workspaceId };\n      return await withSessionActivityRlsContext(db, context, fn, undefined, \"shared\", true);\n    }\n    return await withWorkspaceSessionActivityRls(db, workspaceId, fn);\n  });\n}\n\nexport async function retryWorkspacePersistence<T>(\n  db: Database,\n  workspaceId: string,\n  options: IdempotentPersistenceTransactionOptions,\n  fn: (db: Database) => Promise<T>,\n): Promise<T> {\n  return await runIdempotentPersistenceTransaction(options, async () => {\n    return await withWorkspaceRls(db, workspaceId, fn);\n  });\n}\n\nexport async function retryRlsPersistence<T>(\n  db: Database,\n  context: RlsContext,\n  options: IdempotentPersistenceTransactionOptions,\n  fn: (db: Database) => Promise<T>,\n): Promise<T> {\n  return await runIdempotentPersistenceTransaction(options, async () => {\n    return await withRlsContext(db, context, fn);\n  });\n}\n\n/**\n * Personal workspace data needs both tenant and authenticated-principal GUCs.\n * `session_pins` uses this helper so FORCE RLS rejects another member's rows\n * even if a future query accidentally omits its explicit subject predicate.\n */\nexport async function withWorkspaceSubjectRls<T>(\n  db: Database,\n  workspaceId: string,\n  subjectId: string,\n  fn: (db: Database) => Promise<T>,\n  transactionConfig?: PgTransactionConfig,\n  sessionTenancyFence: \"shared\" | \"none\" = \"shared\",\n): Promise<T> {\n  if (!subjectId.trim()) {\n    throw new Error(\"withWorkspaceSubjectRls: a non-empty subjectId is required\");\n  }\n  const context = await rlsContextForWorkspace(db, workspaceId);\n  return await withRlsContext(\n    db,\n    context,\n    async (scopedDb) => {\n      await setSubjectRlsContext(scopedDb, subjectId);\n      return await fn(scopedDb);\n    },\n    transactionConfig,\n    sessionTenancyFence,\n  );\n}\n\nexport async function withWorkspaceSubjectSessionActivityRls<T>(\n  db: Database,\n  workspaceId: string,\n  subjectId: string,\n  fn: (db: SessionActivityDatabase) => Promise<T>,\n  transactionConfig?: PgTransactionConfig,\n  fenceMode: \"shared\" | \"none\" = \"shared\",\n): Promise<T> {\n  if (!subjectId.trim()) {\n    throw new Error(\"withWorkspaceSubjectSessionActivityRls: a non-empty subjectId is required\");\n  }\n  const context = await rlsContextForWorkspace(db, workspaceId);\n  return await withSessionActivityRlsContext(\n    db,\n    { ...context, workspaceId },\n    async (scopedDb) => {\n      await setSubjectRlsContext(scopedDb, subjectId);\n      return await fn(scopedDb);\n    },\n    transactionConfig,\n    fenceMode,\n  );\n}\n\n/** Apply and verify actor-private RLS on an already transaction-pinned handle. */\nexport async function setSubjectRlsContext(db: Database, subjectId: string): Promise<void> {\n  if (!subjectId.trim()) {\n    throw new Error(\"setSubjectRlsContext: a non-empty subjectId is required\");\n  }\n  await db.execute(sql`select set_config('opengeni.subject_id', ${subjectId}, true)`);\n  const applied = await db.execute<{ subject_id: string | null }>(\n    sql`select current_setting('opengeni.subject_id', true) as subject_id`,\n  );\n  if ((applied[0]?.subject_id ?? \"\") !== subjectId) {\n    throw new Error(\"Authenticated subject RLS context was not applied on the active backend\");\n  }\n}\n\nexport async function withWorkspaceUsageLock<T>(\n  db: Database,\n  workspaceId: string,\n  fn: (db: Database) => Promise<T>,\n): Promise<T> {\n  const context = await rlsContextForWorkspace(db, workspaceId);\n  return await withRlsContext(db, context, async (scopedDb) => {\n    await scopedDb.execute(sql`select pg_advisory_xact_lock(hashtext(${`usage:${workspaceId}`}))`);\n    return await fn(scopedDb);\n  });\n}\n\nexport async function withAccountRls<T>(\n  db: Database,\n  accountId: string,\n  fn: (db: Database) => Promise<T>,\n): Promise<T> {\n  return await withRlsContext(db, { accountId, workspaceId: null }, fn);\n}\n\n/** Internal lookup for the host binding attached to a database handle. */\nexport function dbBindingFor(db: Database): DbBinding | undefined {\n  return dbBindings.get(db as unknown as object);\n}\n"],"mappings":"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","names":["AsyncLocalStorage","AsyncLocalStorage"]}
+{"version":3,"sources":["../src/persistence-errors.ts","../src/database-timing.ts","../src/database.ts"],"sourcesContent":["export type DatabaseFailureCode = \"db_deadlock\" | \"db_serialization_failure\" | \"db_failure\";\n\nexport type PersistenceRetryOutcome = \"not_retryable\" | \"exhausted\";\n\nexport type SafeDatabaseErrorFacts = {\n  severity?: string;\n  schema?: string;\n  table?: string;\n  column?: string;\n  dataType?: string;\n  constraint?: string;\n  routine?: string;\n};\n\nexport type PersistenceFailureDetails = {\n  code: DatabaseFailureCode;\n  sqlState: string | null;\n  stage: string;\n  eventTypes: string[];\n  correlationId: string;\n  attempts: number;\n  retryOutcome: PersistenceRetryOutcome;\n  database: SafeDatabaseErrorFacts;\n};\n\nconst SQLSTATE_KEYS = [\"sqlState\", \"sqlstate\", \"code\"] as const;\nconst NESTED_ERROR_KEYS = [\"cause\", \"original\", \"driverError\", \"error\", \"errors\"] as const;\nconst RETRYABLE_DATABASE_TRANSPORT_CODES = new Set([\n  // postgres.js connection lifecycle failures.\n  \"CONNECTION_CLOSED\",\n  \"CONNECTION_DESTROYED\",\n  \"CONNECTION_ENDED\",\n  \"CONNECT_TIMEOUT\",\n  // Node socket/DNS failures surfaced unchanged by postgres.js.\n  \"EAI_AGAIN\",\n  \"ECONNABORTED\",\n  \"ECONNREFUSED\",\n  \"ECONNRESET\",\n  \"EHOSTDOWN\",\n  \"EHOSTUNREACH\",\n  \"ENETDOWN\",\n  \"ENETRESET\",\n  \"ENETUNREACH\",\n  \"ENOTFOUND\",\n  \"EPIPE\",\n  \"ETIMEDOUT\",\n]);\nconst DATABASE_ERROR_NAMES = new Set([\"DatabaseError\", \"DrizzleQueryError\", \"PostgresError\"]);\nconst DATABASE_DIAGNOSTIC_KEYS = [\n  \"severity\",\n  \"schema_name\",\n  \"table_name\",\n  \"column_name\",\n  \"data_type_name\",\n  \"constraint_name\",\n  \"routine\",\n] as const;\nconst SAFE_FACT_KEYS = [\n  [\"severity\", \"severity\"],\n  [\"schema_name\", \"schema\"],\n  [\"schema\", \"schema\"],\n  [\"table_name\", \"table\"],\n  [\"table\", \"table\"],\n  [\"column_name\", \"column\"],\n  [\"column\", \"column\"],\n  [\"data_type_name\", \"dataType\"],\n  [\"dataType\", \"dataType\"],\n  [\"constraint_name\", \"constraint\"],\n  [\"constraint\", \"constraint\"],\n  [\"routine\", \"routine\"],\n] as const;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value && typeof value === \"object\");\n}\n\nfunction safeFact(value: unknown): string | undefined {\n  if (typeof value !== \"string\" || value.length === 0) return undefined;\n  return value;\n}\n\n/** Find the driver SQLSTATE even when Drizzle wrapped it under nested causes. */\nexport function nestedPostgresSqlState(error: unknown): string | null {\n  const queue: unknown[] = [error];\n  const seen = new Set<unknown>();\n  let fallback: string | null = null;\n  while (queue.length > 0 && seen.size < 64) {\n    const current = queue.shift();\n    if (!isRecord(current) || seen.has(current)) continue;\n    seen.add(current);\n    for (const key of SQLSTATE_KEYS) {\n      const value = current[key];\n      if (typeof value !== \"string\" || !/^[0-9A-Z]{5}$/i.test(value)) continue;\n      const normalized = value.toUpperCase();\n      // Node transport codes such as EPIPE happen to be five characters but\n      // are not PostgreSQL SQLSTATEs.\n      if (RETRYABLE_DATABASE_TRANSPORT_CODES.has(normalized)) continue;\n      if (normalized === \"40P01\" || normalized === \"40001\") return normalized;\n      fallback ??= normalized;\n    }\n    for (const key of NESTED_ERROR_KEYS) {\n      const nested = current[key];\n      if (Array.isArray(nested)) queue.push(...nested);\n      else if (nested !== undefined) queue.push(nested);\n    }\n  }\n  return fallback;\n}\n\nexport function databaseFailureCode(sqlState: string | null): DatabaseFailureCode {\n  if (sqlState === \"40P01\") return \"db_deadlock\";\n  if (sqlState === \"40001\") return \"db_serialization_failure\";\n  return \"db_failure\";\n}\n\nexport function isRetryablePersistenceSqlState(sqlState: string | null): boolean {\n  return sqlState === \"40P01\" || sqlState === \"40001\";\n}\n\n/**\n * Recognize only explicit postgres.js/Node transport codes, including nested\n * driver causes. These failures can arrive as plain Errors with no SQLSTATE or\n * database diagnostic fields when the connection dies before PostgreSQL can\n * answer. Messages are intentionally ignored: they are unstable and may\n * contain connection detail.\n */\nexport function isRetryableDatabaseTransportFailure(error: unknown): boolean {\n  const queue: unknown[] = [error];\n  const seen = new Set<unknown>();\n  while (queue.length > 0 && seen.size < 64) {\n    const current = queue.shift();\n    if (!isRecord(current) || seen.has(current)) continue;\n    seen.add(current);\n\n    for (const key of [\"code\", \"errno\"] as const) {\n      const value = current[key];\n      if (\n        typeof value === \"string\" &&\n        RETRYABLE_DATABASE_TRANSPORT_CODES.has(value.toUpperCase())\n      ) {\n        return true;\n      }\n    }\n\n    for (const key of NESTED_ERROR_KEYS) {\n      const nested = current[key];\n      if (Array.isArray(nested)) queue.push(...nested);\n      else if (nested !== undefined) queue.push(nested);\n    }\n  }\n  return false;\n}\n\n/**\n * Distinguish database/ORM failures from expected domain exceptions when a\n * driver omitted SQLSTATE. This checks shape only; callers retain the original\n * failure independently as canonical error evidence.\n */\nexport function isDatabasePersistenceFailure(error: unknown): boolean {\n  if (isRetryableDatabaseTransportFailure(error) || nestedPostgresSqlState(error) !== null) {\n    return true;\n  }\n\n  const queue: unknown[] = [error];\n  const seen = new Set<unknown>();\n  while (queue.length > 0 && seen.size < 64) {\n    const current = queue.shift();\n    if (!isRecord(current) || seen.has(current)) continue;\n    seen.add(current);\n\n    if (typeof current.name === \"string\" && DATABASE_ERROR_NAMES.has(current.name)) {\n      return true;\n    }\n    if (\n      typeof current.query === \"string\" &&\n      (Object.hasOwn(current, \"params\") || Object.hasOwn(current, \"parameters\"))\n    ) {\n      return true;\n    }\n    if (DATABASE_DIAGNOSTIC_KEYS.some((key) => Object.hasOwn(current, key))) {\n      return true;\n    }\n\n    for (const key of NESTED_ERROR_KEYS) {\n      const nested = current[key];\n      if (Array.isArray(nested)) queue.push(...nested);\n      else if (nested !== undefined) queue.push(nested);\n    }\n  }\n  return false;\n}\n\n/** Extract only PostgreSQL diagnostic identifiers; never query text/parameters. */\nexport function safeDatabaseErrorFacts(error: unknown): SafeDatabaseErrorFacts {\n  const queue: unknown[] = [error];\n  const seen = new Set<unknown>();\n  const facts: SafeDatabaseErrorFacts = {};\n  while (queue.length > 0 && seen.size < 64) {\n    const current = queue.shift();\n    if (!isRecord(current) || seen.has(current)) continue;\n    seen.add(current);\n    for (const [source, destination] of SAFE_FACT_KEYS) {\n      if (facts[destination] !== undefined) continue;\n      const value = safeFact(current[source]);\n      if (value !== undefined) facts[destination] = value;\n    }\n    for (const key of NESTED_ERROR_KEYS) {\n      const nested = current[key];\n      if (Array.isArray(nested)) queue.push(...nested);\n      else if (nested !== undefined) queue.push(nested);\n    }\n  }\n  return facts;\n}\n\n/**\n * Typed persistence classification that retains the exact original failure as\n * `cause` for internal diagnostics. The ordinary Error message is deliberately\n * stable and source-free so a generic presentation path can never disclose SQL,\n * parameters, or driver detail by rendering `.message`.\n */\nexport class SessionEventPersistenceError extends Error {\n  readonly name = \"SessionEventPersistenceError\";\n\n  constructor(\n    readonly details: PersistenceFailureDetails,\n    cause?: unknown,\n  ) {\n    const label =\n      details.code === \"db_deadlock\"\n        ? \"Database deadlock\"\n        : details.code === \"db_serialization_failure\"\n          ? \"Database serialization failure\"\n          : \"Database failure\";\n    const operation = `${label} while persisting ${details.eventTypes.join(\", \") || \"session events\"}`;\n    super(operation, cause === undefined ? undefined : { cause });\n  }\n\n  get code(): DatabaseFailureCode {\n    return this.details.code;\n  }\n}\n\nexport function isSessionEventPersistenceError(\n  error: unknown,\n): error is SessionEventPersistenceError {\n  return error instanceof SessionEventPersistenceError;\n}\n\nexport type IdempotentPersistenceTransactionOptions = {\n  stage: string;\n  eventTypes?: string[];\n  maxAttempts?: number;\n  correlationId?: string;\n  onRetry?: (input: { attempt: number; sqlState: \"40P01\" | \"40001\" }) => void | Promise<void>;\n};\n\n/**\n * Retry only the supplied idempotent database transaction/savepoint. Provider\n * inference, tools, NATS, and all other external effects must remain outside\n * this function. A single correlation ID follows every persistence attempt.\n */\nexport async function runIdempotentPersistenceTransaction<T>(\n  options: IdempotentPersistenceTransactionOptions,\n  transaction: (attempt: number) => Promise<T>,\n): Promise<T> {\n  const maxAttempts = options.maxAttempts ?? 3;\n  if (!Number.isInteger(maxAttempts) || maxAttempts < 1) {\n    throw new Error(\"Persistence maxAttempts must be a positive integer\");\n  }\n  const correlationId = options.correlationId ?? crypto.randomUUID();\n  const eventTypes = [...new Set(options.eventTypes ?? [])].sort();\n  for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {\n    try {\n      return await transaction(attempt);\n    } catch (error) {\n      const sqlState = nestedPostgresSqlState(error);\n      const retryable = isRetryablePersistenceSqlState(sqlState);\n      if (retryable && attempt < maxAttempts) {\n        await options.onRetry?.({\n          attempt,\n          sqlState: sqlState as \"40P01\" | \"40001\",\n        });\n        continue;\n      }\n      if (!isDatabasePersistenceFailure(error)) throw error;\n      throw new SessionEventPersistenceError(\n        {\n          code: databaseFailureCode(sqlState),\n          sqlState,\n          stage: options.stage,\n          eventTypes,\n          correlationId,\n          attempts: attempt,\n          retryOutcome: retryable ? \"exhausted\" : \"not_retryable\",\n          database: safeDatabaseErrorFacts(error),\n        },\n        error,\n      );\n    }\n  }\n  throw new Error(\"Unreachable persistence retry state\");\n}\n","import { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport type DatabaseTimingStage =\n  | \"transaction_admission\"\n  | \"savepoint_admission\"\n  | \"rls_setup\"\n  | \"scoped_callback\";\nexport type DatabaseTimingObservation = {\n  stage: DatabaseTimingStage;\n  outcome: \"completed\" | \"failed\";\n  durationMs: number;\n};\nexport type DatabaseTimingObserver = (observation: DatabaseTimingObservation) => void;\n\nconst timingObserver = new AsyncLocalStorage<DatabaseTimingObserver>();\n\n/** Opt-in, async-local diagnostics only; no identity or query payload is retained. */\nexport function withDatabaseTimingObserver<T>(\n  observer: DatabaseTimingObserver,\n  work: () => Promise<T>,\n): Promise<T> {\n  return timingObserver.run(observer, work);\n}\n\nexport function startDatabaseTiming(\n  stage: DatabaseTimingStage,\n): (outcome: DatabaseTimingObservation[\"outcome\"]) => void {\n  const observer = timingObserver.getStore();\n  if (!observer) return () => undefined;\n  const started = performance.now();\n  let finished = false;\n  return (outcome) => {\n    if (finished) return;\n    finished = true;\n    try {\n      // Do not await observers or let rejected async observers escape either.\n      const result = observer({ stage, outcome, durationMs: performance.now() - started });\n      void Promise.resolve(result).catch(() => undefined);\n    } catch {\n      // Diagnostics must not replace database results or the original error.\n    }\n  };\n}\n","import type { SessionAttachmentReadAccess } from \"./session-file-attachments\";\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport { eq, sql, type SQL } from \"drizzle-orm\";\nimport type { PgDatabase, PgTransactionConfig } from \"drizzle-orm/pg-core\";\nimport { drizzle } from \"drizzle-orm/postgres-js\";\nimport postgres from \"postgres\";\n\nimport {\n  runIdempotentPersistenceTransaction,\n  type IdempotentPersistenceTransactionOptions,\n} from \"./persistence-errors\";\nimport { LOSSLESS_CONTENT_WRITER_APPLICATION_NAME } from \"./lossless-json\";\nimport * as schema from \"./schema\";\nimport { startDatabaseTiming } from \"./database-timing\";\n\n// §7.7 driver widening (Step I). `Database` is the structural, cross-driver\n// query-layer port: every helper in this file accepts `db: Database` and uses\n// only the methods present on drizzle's base `PgDatabase` (select/insert/update/\n// delete/transaction/execute). Widening from the concrete\n// `PostgresJsDatabase<typeof schema>` to `PgDatabase<any, typeof schema>` is a\n// pure TYPE change — no runtime behavior changes — that lets an embedded host\n// inject ANY drizzle pg driver handle (node-postgres, neon-http, etc.) bound to\n// OpenGeni's schema, not just the postgres-js handle `createDb` builds. The\n// `any` for the query-result HKT is deliberate: it keeps `db.execute(sql\\`…\\`)`\n// callable across drivers whose raw-result shapes differ (postgres-js returns a\n// row array; node-postgres returns `{ rows }`). The three raw `db.execute(…)`\n// reads that index a row array (`getManagedUserByEmail` here is the only\n// host-facing one — see `userLookup`) stay postgres-js-shaped for standalone;\n// `userLookup` is the injection seam for hosts on a different driver.\n// `PostgresJsDatabase<typeof schema>` is assignable to this, so standalone is\n// unaffected.\n\nexport type Database = PgDatabase<any, typeof schema>;\n\ndeclare const sessionActivityDatabaseBrand: unique symbol;\n\n/**\n * A workspace-scoped transaction whose session activity commit gate is open.\n * Session-row writers accept this narrower handle so new call sites cannot\n * accidentally bypass the once-per-transaction revision finalizer.\n */\nexport type SessionActivityDatabase = Database & {\n  readonly [sessionActivityDatabaseBrand]: true;\n};\n\nexport type DbClient = {\n  db: Database;\n  close: () => Promise<void>;\n};\n\nexport type RlsContext = {\n  accountId: string;\n  workspaceId?: string | null;\n};\n\nexport type SessionRlsActorContext = {\n  /** Server-authorized session attachment scope; never taken from request JSON. */\n  sessionAttachmentReadAccess?: SessionAttachmentReadAccess;\n  subjectId: string;\n  /** Host-verified personal file ownership, never a request-supplied subject. */\n  privateFileOwnerSubjectId?: string | null;\n  initiatingHumanSubjectId?: string | null;\n};\n\nconst sessionRlsActorContext = new AsyncLocalStorage<SessionRlsActorContext>();\nexport function currentSessionAttachmentReadAccess(): SessionAttachmentReadAccess | undefined {\n  return sessionRlsActorContext.getStore()?.sessionAttachmentReadAccess;\n}\n\n/**\n * Stable identity of the ambient session RLS actor: every field that\n * `setRlsContext` turns into database-visible GUCs or that scoped reads\n * consult. Two callers with equal keys see exactly the same rows, so the key\n * is safe for sharing a read result between them; `null` means no actor, in\n * which case the subject GUC stays empty for every such caller.\n */\nexport function currentSessionRlsActorIdentityKey(): string | null {\n  const actor = sessionRlsActorContext.getStore();\n  if (!actor) return null;\n  return JSON.stringify([\n    actor.subjectId,\n    actor.initiatingHumanSubjectId ?? null,\n    actor.privateFileOwnerSubjectId ?? null,\n    actor.sessionAttachmentReadAccess ?? null,\n  ]);\n}\n\nexport async function withSessionRlsActorContext<T>(\n  actor: SessionRlsActorContext,\n  fn: () => Promise<T>,\n): Promise<T> {\n  if (!actor.subjectId.trim()) {\n    throw new Error(\"withSessionRlsActorContext: a non-empty subjectId is required\");\n  }\n  if (\n    actor.initiatingHumanSubjectId !== undefined &&\n    actor.initiatingHumanSubjectId !== null &&\n    !actor.initiatingHumanSubjectId.trim()\n  ) {\n    throw new Error(\n      \"withSessionRlsActorContext: initiatingHumanSubjectId must be null or non-empty\",\n    );\n  }\n  if (\n    actor.privateFileOwnerSubjectId !== undefined &&\n    actor.privateFileOwnerSubjectId !== null &&\n    !actor.privateFileOwnerSubjectId.trim()\n  ) {\n    throw new Error(\n      \"withSessionRlsActorContext: privateFileOwnerSubjectId must be null or non-empty\",\n    );\n  }\n  return await sessionRlsActorContext.run(actor, fn);\n}\n\ntype RlsContextSettings = {\n  accountId: string;\n  workspaceId: string;\n};\n\n/**\n * RLS posture for the connection OpenGeni's query layer runs over (Step I, §7.7).\n *\n * - `\"force\"` (DEFAULT — today's standalone behavior, byte-for-byte): OpenGeni\n *   connects as a NON-OWNER role (`opengeni_app`) and every table carries\n *   `FORCE ROW LEVEL SECURITY`, so the workspace/account GUCs set by\n *   `setRlsContext` are the ONLY thing that admits rows — even the table owner\n *   is subject to RLS. This is the Fork-A isolation guarantee.\n * - `\"scoped\"` (embedded Fork-B opt-in): the host runs OpenGeni's queries over a\n *   role that OWNS the dedicated schema (RLS need not be forced for that role),\n *   relying on the host's own tenant boundary. OpenGeni STILL emits the\n *   `set_config('opengeni.account_id'/'workspace_id', …)` GUCs defensively on\n *   every scoped query, so the application query path is byte-identical between\n *   the two strategies and the app code is RLS-mode-agnostic. The strategy is a\n *   declared posture (consumed by `provisionRoles` and as a documented\n *   invariant), NOT a query-path branch — there is deliberately no `if\n *   (strategy === …)` anywhere in the helpers below. Picking `\"scoped\"` does not\n *   relax any GUC; it only changes which DB role the host provisions/connects as\n *   and asserts that the host accepts owning the isolation boundary.\n */\nexport type RlsStrategy = \"force\" | \"scoped\";\n\n/**\n * Resolve a host-IdP/Better-Auth user *identifier* by email. Injected via\n * `createDb({ userLookup })` (Step I). UNSET → today's raw parameterized select\n * against Better Auth's `auth_users` table (see `getManagedUserByEmail`), which\n * relies on the postgres-js array-shaped `db.execute` result. An embedded host\n * whose identity lives elsewhere (a different IdP table, a different driver, or\n * a non-`auth_users` user store) injects this closure so OpenGeni never touches\n * `auth_users` directly. Returns the user id, or null when no such user exists.\n */\nexport type UserLookup = (db: Database, email: string) => Promise<string | null>;\n\nexport type ManagedUserProfile = {\n  id: string;\n  name: string | null;\n  email: string;\n};\n\n/** Host identity projection used by organization administration rosters. */\nexport type UserProfileLookup = (\n  db: Database,\n  userIds: readonly string[],\n) => Promise<ManagedUserProfile[]>;\n\nexport type CreateDbOptions = {\n  /**\n   * The Postgres `search_path` for this connection (Step I, §7.8 runtime half).\n   * UNSET → today's behavior: NO `search_path` startup parameter is sent, so the\n   * server default applies (`public` for standalone, where every table + the\n   * `vector` extension + `gen_random_uuid()` live). For an embedded dedicated\n   * schema, pass e.g. `\"opengeni,opengeni_private,public\"` — postgres-js sends\n   * it as a per-session startup parameter (the supported, query-param-free way;\n   * URL `?search_path=` is IGNORED by postgres-js). Keep `public` LAST so the\n   * `vector` type and `gen_random_uuid()` (which live in `public` on the\n   * pgvector image) still resolve — the schema-isolation contract live footgun.\n   */\n  searchPath?: string;\n  /** RLS posture; defaults to `\"force\"` (today's standalone). */\n  rlsStrategy?: RlsStrategy;\n  /** Host-provided user-by-email resolver; unset → today's raw `auth_users` query. */\n  userLookup?: UserLookup;\n  /** Host-provided user profile projection; unset → standalone `auth_users`. */\n  userProfileLookup?: UserProfileLookup;\n  /** postgres-js pool size; defaults to today's `10`. */\n  max?: number;\n  /**\n   * Connection-local default transaction isolation sent in the postgres-js\n   * startup parameters. This is intentionally not a role/database default:\n   * tests and embedded callers can exercise a different ambient isolation\n   * without mutating a shared PostgreSQL role or affecting other connections.\n   */\n  isolationLevel?: postgres.ConnectionParameters[\"default_transaction_isolation\"];\n};\n\n/**\n * The active RLS strategy + userLookup for an injected `Database`, recorded in a\n * side WeakMap so helpers (and `getManagedUserByEmail`) can consult the host's\n * binding without changing every call signature. A handle with no recorded\n * config (e.g. one built outside `createDb`, or in a test) falls back to the\n * standalone defaults: `rlsStrategy: \"force\"`, raw `auth_users` lookup.\n */\ntype DbBinding = {\n  rlsStrategy: RlsStrategy;\n  userLookup?: UserLookup;\n  userProfileLookup?: UserProfileLookup;\n};\n\nconst dbBindings = new WeakMap<object, DbBinding>();\n\n/** The strategy bound to a handle (or the `\"force\"` default). */\nexport function rlsStrategyFor(db: Database): RlsStrategy {\n  return dbBindings.get(db as unknown as object)?.rlsStrategy ?? \"force\";\n}\n\n/**\n * Run a raw SQL query and read its rows as a typed array.\n *\n * Why this exists: the Step I driver widening (`Database = PgDatabase<any, …>`)\n * deliberately sets the query-result HKT to `any` so `db.execute(…)` is callable\n * across drivers whose raw-result shapes differ (postgres-js → row array;\n * node-postgres → `{ rows }`). A side effect is that `db.execute<T>(…)` now\n * resolves to `any`, erasing the per-row element type at the call site. OpenGeni's\n * OWN internal raw queries usually run over the postgres-js handle `createDb`\n * builds (array result), while an embedded host may inject a node-postgres style\n * driver (`{ rows }`). Normalize those two standard shapes in one place; reject\n * an unknown driver result rather than silently treating it as an empty query.\n */\nexport async function rawRows<T extends Record<string, unknown>>(\n  executor: Pick<Database, \"execute\">,\n  query: SQL,\n): Promise<T[]> {\n  const result = await executor.execute<T>(query);\n  if (Array.isArray(result)) {\n    return result as unknown as T[];\n  }\n  const rows = (result as unknown as { rows?: unknown }).rows;\n  if (Array.isArray(rows)) {\n    return rows as T[];\n  }\n  throw new Error(\"Unsupported database execute() result shape\");\n}\n\nexport type SandboxProviderReadLockIdentity = {\n  workspaceId: string;\n  sandboxGroupId: string;\n  leaseEpoch: number;\n  instanceId: string;\n};\n\nexport class SandboxProviderReadLockUnavailableError extends Error {\n  constructor() {\n    super(\"Sandbox provider reads are temporarily busy. Retry the request.\");\n    this.name = \"SandboxProviderReadLockUnavailableError\";\n  }\n}\n\nconst SANDBOX_PROVIDER_READ_LOCK_WAIT_MS = 15_000;\nconst SANDBOX_PROVIDER_READ_LOCK_POLL_MAX_MS = 200;\n\nfunction sandboxProviderReadLockKey(identity: SandboxProviderReadLockIdentity): string {\n  return [\n    \"sandbox-provider-read\",\n    identity.workspaceId,\n    identity.sandboxGroupId,\n    identity.leaseEpoch,\n    identity.instanceId,\n  ].join(\":\");\n}\n\nasync function waitForSandboxProviderReadLockPoll(\n  delayMs: number,\n  signal?: AbortSignal | undefined,\n): Promise<void> {\n  if (signal?.aborted) {\n    throw signal.reason ?? new DOMException(\"The operation was aborted\", \"AbortError\");\n  }\n  await new Promise<void>((resolve, reject) => {\n    let settled = false;\n    let timer: ReturnType<typeof setTimeout>;\n    const cleanup = () => signal?.removeEventListener(\"abort\", abort);\n    const finish = () => {\n      if (settled) return;\n      settled = true;\n      cleanup();\n      resolve();\n    };\n    const abort = () => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      cleanup();\n      reject(signal?.reason ?? new DOMException(\"The operation was aborted\", \"AbortError\"));\n    };\n    timer = setTimeout(finish, delayMs);\n    signal?.addEventListener(\"abort\", abort, { once: true });\n    if (signal?.aborted) abort();\n  });\n}\n\n/**\n * Cross-process exclusive boundary for one exact live provider instance's\n * API-direct read request. Modal accepts concurrent commands from one attached\n * handle, but independent API replicas reconstruct different handles; issuing\n * overlapping command groups through those handles can make an otherwise valid\n * read fail transiently. Keep concurrency inside one batched request while\n * serializing only separate requests that target the same lease identity.\n *\n * The callback intentionally runs while one transaction-pinned DB connection\n * holds the advisory lock. The direct lease holder separately prevents drain,\n * and the abort-aware bounded poll prevents a disconnected HTTP request from\n * occupying the connection indefinitely.\n */\nexport async function withSandboxProviderReadLock<T>(\n  db: Database,\n  identity: SandboxProviderReadLockIdentity,\n  signal: AbortSignal | undefined,\n  fn: () => Promise<T>,\n): Promise<T> {\n  const key = sandboxProviderReadLockKey(identity);\n  const deadline = Date.now() + SANDBOX_PROVIDER_READ_LOCK_WAIT_MS;\n  return await db.transaction(async (lockedDb) => {\n    let pollMs = 20;\n    while (true) {\n      if (signal?.aborted) {\n        throw signal.reason ?? new DOMException(\"The operation was aborted\", \"AbortError\");\n      }\n      const [row] = await rawRows<{ acquired: boolean }>(\n        lockedDb,\n        sql`select pg_try_advisory_xact_lock(hashtextextended(${key}, 0)) as acquired`,\n      );\n      if (row?.acquired === true) return await fn();\n      const remainingMs = deadline - Date.now();\n      if (remainingMs <= 0) throw new SandboxProviderReadLockUnavailableError();\n      await waitForSandboxProviderReadLockPoll(Math.min(pollMs, remainingMs), signal);\n      pollMs = Math.min(pollMs * 2, SANDBOX_PROVIDER_READ_LOCK_POLL_MAX_MS);\n    }\n  });\n}\n\nexport function createDb(databaseUrl: string, options: CreateDbOptions = {}): DbClient {\n  // `prepare: false` is REQUIRED for Azure Database for PostgreSQL Flexible\n  // Server's transaction-pooling PgBouncer: postgres-js's default named prepared\n  // statements (`s_N`) are bound to one backend, but a transaction pooler hands\n  // each transaction a different backend, so a later `execute` intermittently\n  // throws `prepared statement \"s_N\" does not exist`. Every RLS read in this\n  // module (set_config + SELECT inside one db.transaction) rides on this pool, so\n  // the failure surfaces as a \"worked, then didn't\" credential/permission read.\n  // idle_timeout + max_lifetime recycle connections so a pooler-recycled backend\n  // is never reused indefinitely; application_name aids server-side diagnostics.\n  const client = postgres(databaseUrl, {\n    max: options.max ?? 10,\n    prepare: false,\n    idle_timeout: 30,\n    max_lifetime: 1800,\n    // `connection` carries per-session Postgres STARTUP parameters. The exact\n    // `application_name` is also the PgBouncer-compatible current-image receipt\n    // for migration 0352's restrictive sessions policy; arbitrary custom startup\n    // parameters are not portable through transaction poolers. `search_path`\n    // (embedded only) is the supported, query-param-free way to scope a connection\n    // to a dedicated schema — postgres-js IGNORES a URL `?search_path=`. Unset\n    // searchPath → omit it so the server default (`public`) is unchanged for\n    // standalone.\n    connection: {\n      application_name: LOSSLESS_CONTENT_WRITER_APPLICATION_NAME,\n      ...(options.searchPath ? { search_path: options.searchPath } : {}),\n      ...(options.isolationLevel ? { default_transaction_isolation: options.isolationLevel } : {}),\n    },\n  });\n  const db = drizzle(client, { schema });\n  dbBindings.set(db as unknown as object, {\n    rlsStrategy: options.rlsStrategy ?? \"force\",\n    ...(options.userLookup ? { userLookup: options.userLookup } : {}),\n    ...(options.userProfileLookup ? { userProfileLookup: options.userProfileLookup } : {}),\n  });\n  return {\n    db,\n    close: async () => {\n      await client.end();\n    },\n  };\n}\n\n/**\n * Register a host's `rlsStrategy`/`userLookup` against an externally-constructed\n * `Database` handle (e.g. one the embedded host built from its own driver and\n * injected, rather than via `createDb`). Lets the same WeakMap-backed lookups\n * work for injected handles. Standalone never calls this (it uses `createDb`).\n */\nexport function registerDbBinding(\n  db: Database,\n  binding: {\n    rlsStrategy?: RlsStrategy;\n    userLookup?: UserLookup;\n    userProfileLookup?: UserProfileLookup;\n  },\n): void {\n  dbBindings.set(db as unknown as object, {\n    rlsStrategy: binding.rlsStrategy ?? \"force\",\n    ...(binding.userLookup ? { userLookup: binding.userLookup } : {}),\n    ...(binding.userProfileLookup ? { userProfileLookup: binding.userProfileLookup } : {}),\n  });\n}\n\nexport async function setRlsContext(db: Database, context: RlsContext): Promise<void> {\n  // Fail loud on an empty/blank account id: a \"\" account would set an RLS GUC\n  // that matches no tenant row, silently returning zero rows from every scoped\n  // read (a phantom \"not found\" / \"no active subscription\"). An RLS context with\n  // no account is always a bug at the call site, never a valid query scope.\n  if (typeof context.accountId !== \"string\" || context.accountId.trim() === \"\") {\n    throw new Error(\"setRlsContext: a non-empty accountId is required to establish an RLS context\");\n  }\n  // Transaction-local writer identity covers supported injected/embedded\n  // database handles whose connection-level application_name is host-owned.\n  // Standalone createDb connections also carry version receipts in their exact\n  // application_name, while old OpenGeni binaries set neither current receipt.\n  await db.execute(sql`select\n    set_config('opengeni.account_id', ${context.accountId}, true),\n    set_config('opengeni.workspace_id', ${context.workspaceId ?? \"\"}, true),\n    set_config('opengeni.lossless_content_writer', '1', true),\n    set_config('opengeni.sandbox_recovery_protocol_v2', '1', true),\n    set_config('opengeni.pending_tool_event_output_v1', '1', true),\n    set_config('opengeni.session_variable_set_attachments_v1', '1', true)`);\n  const sessionActor = sessionRlsActorContext.getStore();\n  if (sessionActor) {\n    await setSubjectRlsContext(db, sessionActor.subjectId);\n    await db.execute(\n      sql`select set_config('opengeni.private_file_owner', ${sessionActor.privateFileOwnerSubjectId ?? \"\"}, true), set_config(\n        'opengeni.initiating_human_subject_id',\n        ${sessionActor.initiatingHumanSubjectId ?? \"\"},\n        true\n      )`,\n    );\n  }\n}\n\nasync function readRlsContextSettings(db: Database): Promise<RlsContextSettings> {\n  const [settings] = await rawRows<{\n    account_id: string | null;\n    workspace_id: string | null;\n  }>(\n    db,\n    sql`select\n      current_setting('opengeni.account_id', true) as account_id,\n      current_setting('opengeni.workspace_id', true) as workspace_id`,\n  );\n  return {\n    accountId: settings?.account_id ?? \"\",\n    workspaceId: settings?.workspace_id ?? \"\",\n  };\n}\n\nasync function assertRlsContextApplied(db: Database, context: RlsContext): Promise<void> {\n  const applied = await readRlsContextSettings(db);\n  const expectedWorkspaceId = context.workspaceId ?? \"\";\n  if (applied.accountId !== context.accountId) {\n    throw new Error(\n      `RLS context not applied on the active backend: expected account ${context.accountId}, got \"${applied.accountId}\"`,\n    );\n  }\n  if (applied.workspaceId !== expectedWorkspaceId) {\n    throw new Error(\n      `RLS context not applied on the active backend: expected workspace \"${expectedWorkspaceId}\", got \"${applied.workspaceId}\"`,\n    );\n  }\n}\n\nasync function restoreRlsContextSettings(\n  db: Database,\n  settings: RlsContextSettings,\n): Promise<void> {\n  const [restored] = await rawRows<{\n    account_id: string;\n    workspace_id: string;\n  }>(\n    db,\n    sql`select\n      set_config('opengeni.account_id', ${settings.accountId}, true) as account_id,\n      set_config('opengeni.workspace_id', ${settings.workspaceId}, true) as workspace_id`,\n  );\n  if (\n    restored?.account_id !== settings.accountId ||\n    restored.workspace_id !== settings.workspaceId\n  ) {\n    throw new Error(\"RLS context could not be restored after a nested scope\");\n  }\n}\n\nexport async function withRlsContext<T>(\n  db: Database,\n  context: RlsContext,\n  fn: (db: Database) => Promise<T>,\n  transactionConfig?: PgTransactionConfig,\n  sessionTenancyFence: \"shared\" | \"none\" = \"shared\",\n): Promise<T> {\n  const restoreParentScope = isTransactionHandle(db);\n  // Callback entry includes connection admission AND BEGIN/SAVEPOINT round-trip.\n  // This is deliberately not advertised as pure pool wait.\n  const admission = startDatabaseTiming(\n    restoreParentScope ? \"savepoint_admission\" : \"transaction_admission\",\n  );\n  try {\n    return await db.transaction(async (tx) => {\n      admission(\"completed\");\n      const setup = startDatabaseTiming(\"rls_setup\");\n      const scoped = tx as unknown as Database;\n      let parentScope: RlsContextSettings | null;\n      try {\n        parentScope = restoreParentScope ? await readRlsContextSettings(scoped) : null;\n        await setRlsContext(scoped, context);\n        if (context.workspaceId && sessionTenancyFence === \"shared\") {\n          await scoped.execute(\n            sql`select pg_advisory_xact_lock_shared(hashtextextended(${`session-tenancy:${context.workspaceId}`}, 0))`,\n          );\n        }\n        // Defense-in-depth: read the LOCAL GUC back on THIS backend BEFORE running\n        // the scoped query. The set_config and this read share one db.transaction,\n        // which a transaction pooler pins to a single backend — so a mismatch here\n        // means the context was genuinely lost (a torn transaction / pooler backend\n        // swap), not normal operation. Without this guard such an event runs the\n        // scoped read with an empty account_id and returns zero RLS-visible rows,\n        // manufacturing a phantom \"no active subscription\" from a credential that is\n        // in fact active. Convert that silent false into a loud, root-cause-bearing\n        // error so the caller can retry rather than permanently mis-decide.\n        await assertRlsContextApplied(scoped, context);\n        setup(\"completed\");\n      } catch (error) {\n        setup(\"failed\");\n        throw error;\n      }\n      const callback = startDatabaseTiming(\"scoped_callback\");\n      let value: T;\n      try {\n        value = await fn(scoped);\n        callback(\"completed\");\n      } catch (error) {\n        callback(\"failed\");\n        throw error;\n      }\n      // A nested transaction is a savepoint, and SET LOCAL survives successful\n      // savepoint release. Restore only the tenant scope the nested helper owns;\n      // writer/protocol capabilities intentionally remain transaction-wide.\n      if (parentScope) await restoreRlsContextSettings(scoped, parentScope);\n      return value;\n    }, transactionConfig);\n  } catch (error) {\n    // No-op after callback entry; only admission failures are counted here.\n    admission(\"failed\");\n    throw error;\n  }\n}\n\n/**\n * Run one bounded database operation on a transaction-pinned backend.\n *\n * Callers that also have an application deadline should check their abort\n * signal before returning from `fn`; throwing there rolls the transaction back\n * even when the application deadline won a surrounding Promise race.\n */\nexport async function withDatabaseStatementTimeout<T>(\n  db: Database,\n  timeoutMs: number,\n  fn: (db: Database) => Promise<T>,\n): Promise<T> {\n  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n    throw new Error(\"withDatabaseStatementTimeout requires a positive timeout\");\n  }\n  const boundedTimeoutMs = Math.max(1, Math.floor(timeoutMs));\n  return await db.transaction(async (tx) => {\n    const scoped = tx as unknown as Database;\n    await scoped.execute(\n      sql`select set_config('statement_timeout', ${`${boundedTimeoutMs}ms`}, true)`,\n    );\n    return await fn(scoped);\n  });\n}\n\nexport async function rlsContextForWorkspace(\n  db: Database,\n  workspaceId: string,\n): Promise<RlsContext> {\n  const [row] = await db\n    .select({ accountId: schema.workspaces.accountId })\n    .from(schema.workspaces)\n    .where(eq(schema.workspaces.id, workspaceId))\n    .limit(1);\n  if (!row) {\n    throw new Error(`Workspace not found: ${workspaceId}`);\n  }\n  return { accountId: row.accountId, workspaceId };\n}\n\nexport async function withWorkspaceRls<T>(\n  db: Database,\n  workspaceId: string,\n  fn: (db: Database) => Promise<T>,\n  transactionConfig?: PgTransactionConfig,\n): Promise<T> {\n  return await withRlsContext(\n    db,\n    await rlsContextForWorkspace(db, workspaceId),\n    fn,\n    transactionConfig,\n  );\n}\n\ntype SessionActivityGate = {\n  db: SessionActivityDatabase;\n  owner: boolean;\n};\n\nfunction isTransactionHandle(db: Database): boolean {\n  return typeof (db as Database & { rollback?: unknown }).rollback === \"function\";\n}\n\nasync function assertSessionActivityGateEntry(db: Database): Promise<void> {\n  if (!isTransactionHandle(db)) return;\n  const [gate] = await rawRows<{ state: string | null }>(\n    db,\n    sql`\n      select nullif(\n        current_setting('opengeni.session_activity_gate_state', true),\n        ''\n      ) as state\n    `,\n  );\n  if (gate?.state === null || gate === undefined) {\n    throw new Error(\"Session activity commit gate must start at the outer transaction boundary\");\n  }\n}\n\nasync function beginSessionActivityGate(\n  db: Database,\n  workspaceId: string,\n): Promise<SessionActivityGate> {\n  const [gate] = await rawRows<{\n    prior_state: string | null;\n    prior_workspace_id: string | null;\n  }>(\n    db,\n    sql`\n      with current_gate as materialized (\n        select\n          nullif(current_setting('opengeni.session_activity_gate_state', true), '') as prior_state,\n          nullif(current_setting('opengeni.session_activity_gate_workspace_id', true), '') as prior_workspace_id\n      )\n      select\n        prior_state,\n        prior_workspace_id,\n        case\n          when prior_state is null\n            then set_config('opengeni.session_activity_gate_state', 'open', true)\n          else prior_state\n        end as effective_state,\n        case\n          when prior_state is null\n            then set_config('opengeni.session_activity_gate_workspace_id', ${workspaceId}, true)\n          else prior_workspace_id\n        end as effective_workspace_id\n      from current_gate\n    `,\n  );\n  if (!gate) {\n    throw new Error(\"Session activity commit gate could not be opened\");\n  }\n  if (gate.prior_state === null) {\n    return { db: db as SessionActivityDatabase, owner: true };\n  }\n  if (gate.prior_state === \"open\" && gate.prior_workspace_id === workspaceId) {\n    return { db: db as SessionActivityDatabase, owner: false };\n  }\n  throw new Error(\"Session activity commit gate is already owned by another transaction scope\");\n}\n\nasync function finalizeSessionActivityGate(\n  db: SessionActivityDatabase,\n  workspaceId: string,\n): Promise<void> {\n  // Resolve every deferred FK/constraint before taking the shared workspace\n  // counter. The only row writes after that point stamp session rows already\n  // modified and therefore already owned by this transaction.\n  await db.execute(\n    sql`select set_config('opengeni.session_activity_gate_state', 'preparing', true)`,\n  );\n  await db.execute(sql`set constraints all immediate`);\n  // The first flush proves every pre-existing deferred obligation. Re-defer\n  // only our commit guard so the marker-clearing writes below queue a fresh\n  // proof against the final row state, then force that proof before returning.\n  await db.execute(\n    sql`set constraints sessions_activity_insert_commit_guard, sessions_activity_update_commit_guard deferred`,\n  );\n  const [result] = await rawRows<{\n    had_pending: boolean;\n    pending_count: number;\n    revision: string | null;\n    stamped_count: number;\n  }>(\n    db,\n    sql`\n      with gate as materialized (\n        select set_config('opengeni.session_activity_gate_state', 'finalizing', true) as state\n      ),\n      pending as materialized (\n        select ${schema.sessions.id}\n        from ${schema.sessions}\n        cross join gate\n        where ${schema.sessions.workspaceId} = ${workspaceId}\n          and ${schema.sessions.activityRevisionPendingXid}\n            = pg_current_xact_id()::text::bigint\n      ),\n      advanced as (\n        update ${schema.workspaceSessionActivityRevisions} as counter\n        set revision = counter.revision + 1\n        where counter.workspace_id = ${workspaceId}\n          and exists (select 1 from pending)\n        returning counter.revision\n      ),\n      stamped as (\n        update ${schema.sessions} as session\n        set\n          activity_revision = advanced.revision,\n          activity_revision_pending_xid = null\n        from advanced\n        where session.workspace_id = ${workspaceId}\n          and session.activity_revision_pending_xid\n            = pg_current_xact_id()::text::bigint\n        returning session.id\n      ),\n      stats as materialized (\n        select\n          exists (select 1 from pending) as had_pending,\n          (select count(*)::integer from pending) as pending_count,\n          (select revision::text from advanced) as revision,\n          (select count(*)::integer from stamped) as stamped_count\n      ),\n      finalized as materialized (\n        select\n          had_pending,\n          pending_count,\n          revision,\n          stamped_count,\n          set_config('opengeni.session_activity_gate_state', 'finalized', true) as state\n        from stats\n      )\n      select had_pending, pending_count, revision, stamped_count\n      from finalized\n    `,\n  );\n  if (!result) {\n    throw new Error(\"Session activity commit gate did not return a finalization result\");\n  }\n  if (result.had_pending && result.revision === null) {\n    throw new Error(\"Workspace session activity counter is unavailable\");\n  }\n  if (result.stamped_count !== result.pending_count) {\n    throw new Error(\"Session activity commit gate did not stamp every pending row\");\n  }\n  await db.execute(\n    sql`set constraints sessions_activity_insert_commit_guard, sessions_activity_update_commit_guard immediate`,\n  );\n  // A restored activity scope can be followed by another workspace scope, or\n  // by a SECURITY DEFINER lifecycle that opens and finalizes its own gate in\n  // the same outer transaction. Keep the guards deferred after proving this\n  // scope's final state so those later writes reach their own finalizer instead\n  // of firing the commit guard at the first session update.\n  await db.execute(\n    sql`set constraints sessions_activity_insert_commit_guard, sessions_activity_update_commit_guard deferred`,\n  );\n}\n\n/**\n * Run one workspace transaction with explicit once-per-transaction session\n * activity finalization. Nested callers reuse the outer gate; only its owner\n * finalizes immediately before the enclosing RLS transaction commits.\n */\nexport async function withSessionActivityRlsContext<T>(\n  db: Database,\n  context: RlsContext & { workspaceId: string },\n  fn: (db: SessionActivityDatabase) => Promise<T>,\n  transactionConfig?: PgTransactionConfig,\n  fenceMode: \"shared\" | \"none\" = \"shared\",\n  organizationMembershipFence = false,\n): Promise<T> {\n  await assertSessionActivityGateEntry(db);\n  return await withRlsContext(\n    db,\n    context,\n    async (scopedDb) => {\n      if (organizationMembershipFence) {\n        // Claim can inherit membership-fenced authority after locking sessions.\n        // Acquire membership before even a shared tenancy fence: an exclusive\n        // tenancy/control waiter can otherwise complete the same lock cycle.\n        await scopedDb.execute(sql`select pg_advisory_xact_lock(\n          hashtextextended(${`organization-membership:${context.accountId}`}, 0))`);\n        if (fenceMode === \"shared\") {\n          await scopedDb.execute(sql`select pg_advisory_xact_lock_shared(\n            hashtextextended(${`session-tenancy:${context.workspaceId}`}, 0))`);\n        }\n      }\n      const gate = await beginSessionActivityGate(scopedDb, context.workspaceId);\n      const value = await fn(gate.db);\n      // The finalizer must never trust tenant GUCs that arbitrary callback code\n      // could have changed. Nested RLS helpers restore their parent scope; this\n      // assertion is the fail-closed commit-boundary proof for every other path.\n      await assertRlsContextApplied(gate.db, context);\n      if (gate.owner) {\n        await finalizeSessionActivityGate(gate.db, context.workspaceId);\n      }\n      return value;\n    },\n    transactionConfig,\n    organizationMembershipFence ? \"none\" : fenceMode,\n  );\n}\n\nexport async function withWorkspaceSessionActivityRls<T>(\n  db: Database,\n  workspaceId: string,\n  fn: (db: SessionActivityDatabase) => Promise<T>,\n  transactionConfig?: PgTransactionConfig,\n): Promise<T> {\n  return await withSessionActivityRlsContext(\n    db,\n    { ...(await rlsContextForWorkspace(db, workspaceId)), workspaceId },\n    fn,\n    transactionConfig,\n  );\n}\n\n/**\n * Run one of several ordered workspace activity scopes inside a caller-owned\n * transaction. Each scope is fully finalized before restoring the caller's\n * gate GUCs, so the next workspace can reuse the same outer transaction.\n */\nexport async function withRestoredSessionActivityRlsContext<T>(\n  db: Database,\n  context: RlsContext & { workspaceId: string },\n  fn: (db: SessionActivityDatabase) => Promise<T>,\n): Promise<T> {\n  if (!isTransactionHandle(db)) {\n    throw new Error(\"Sequential workspace activity scopes require a caller-owned transaction\");\n  }\n  const [prior] = await rawRows<{ state: string; workspace_id: string }>(\n    db,\n    sql`select\n      coalesce(current_setting('opengeni.session_activity_gate_state', true), '') as state,\n      coalesce(\n        current_setting('opengeni.session_activity_gate_workspace_id', true), ''\n      ) as workspace_id`,\n  );\n  try {\n    return await withRlsContext(db, context, async (scopedDb) => {\n      const gate = await beginSessionActivityGate(scopedDb, context.workspaceId);\n      if (!gate.owner) {\n        throw new Error(\"Sequential workspace activity scope unexpectedly reused an open gate\");\n      }\n      const value = await fn(gate.db);\n      await assertRlsContextApplied(gate.db, context);\n      await finalizeSessionActivityGate(gate.db, context.workspaceId);\n      return value;\n    });\n  } finally {\n    await db.execute(sql`select\n      set_config('opengeni.session_activity_gate_state', ${prior?.state ?? \"\"}, true),\n      set_config(\n        'opengeni.session_activity_gate_workspace_id', ${prior?.workspace_id ?? \"\"}, true\n      )`);\n  }\n}\n\n/**\n * Open one nested savepoint without losing the gate brand. Drizzle correctly\n * preserves the backend-local gate GUCs, but its structural transaction type\n * cannot express that provenance; keep the single trusted rebrand here.\n */\nexport async function withSessionActivitySavepoint<T>(\n  db: SessionActivityDatabase,\n  fn: (db: SessionActivityDatabase) => Promise<T>,\n): Promise<T> {\n  return await db.transaction(async (tx) => await fn(tx as unknown as SessionActivityDatabase));\n}\n\nexport async function retrySessionActivityRls<T>(\n  db: Database,\n  workspaceId: string,\n  options: IdempotentPersistenceTransactionOptions & {\n    /** Claim can inherit membership-fenced causal authority after locking the\n     * session. Acquire that fence before tenancy/control/session instead. An\n     * enclosing transaction must preserve this same lock prefix. */\n    organizationMembershipFence?: boolean;\n  },\n  fn: (db: SessionActivityDatabase) => Promise<T>,\n): Promise<T> {\n  return await runIdempotentPersistenceTransaction(options, async () => {\n    if (options.organizationMembershipFence) {\n      const context = { ...(await rlsContextForWorkspace(db, workspaceId)), workspaceId };\n      return await withSessionActivityRlsContext(db, context, fn, undefined, \"shared\", true);\n    }\n    return await withWorkspaceSessionActivityRls(db, workspaceId, fn);\n  });\n}\n\nexport async function retryWorkspacePersistence<T>(\n  db: Database,\n  workspaceId: string,\n  options: IdempotentPersistenceTransactionOptions,\n  fn: (db: Database) => Promise<T>,\n): Promise<T> {\n  return await runIdempotentPersistenceTransaction(options, async () => {\n    return await withWorkspaceRls(db, workspaceId, fn);\n  });\n}\n\nexport async function retryRlsPersistence<T>(\n  db: Database,\n  context: RlsContext,\n  options: IdempotentPersistenceTransactionOptions,\n  fn: (db: Database) => Promise<T>,\n): Promise<T> {\n  return await runIdempotentPersistenceTransaction(options, async () => {\n    return await withRlsContext(db, context, fn);\n  });\n}\n\n/**\n * Personal workspace data needs both tenant and authenticated-principal GUCs.\n * `session_pins` uses this helper so FORCE RLS rejects another member's rows\n * even if a future query accidentally omits its explicit subject predicate.\n */\nexport async function withWorkspaceSubjectRls<T>(\n  db: Database,\n  workspaceId: string,\n  subjectId: string,\n  fn: (db: Database) => Promise<T>,\n  transactionConfig?: PgTransactionConfig,\n  sessionTenancyFence: \"shared\" | \"none\" = \"shared\",\n): Promise<T> {\n  if (!subjectId.trim()) {\n    throw new Error(\"withWorkspaceSubjectRls: a non-empty subjectId is required\");\n  }\n  const context = await rlsContextForWorkspace(db, workspaceId);\n  return await withRlsContext(\n    db,\n    context,\n    async (scopedDb) => {\n      await setSubjectRlsContext(scopedDb, subjectId);\n      return await fn(scopedDb);\n    },\n    transactionConfig,\n    sessionTenancyFence,\n  );\n}\n\nexport async function withWorkspaceSubjectSessionActivityRls<T>(\n  db: Database,\n  workspaceId: string,\n  subjectId: string,\n  fn: (db: SessionActivityDatabase) => Promise<T>,\n  transactionConfig?: PgTransactionConfig,\n  fenceMode: \"shared\" | \"none\" = \"shared\",\n  organizationMembershipFence = false,\n): Promise<T> {\n  if (!subjectId.trim()) {\n    throw new Error(\"withWorkspaceSubjectSessionActivityRls: a non-empty subjectId is required\");\n  }\n  const context = await rlsContextForWorkspace(db, workspaceId);\n  return await withSessionActivityRlsContext(\n    db,\n    { ...context, workspaceId },\n    async (scopedDb) => {\n      await setSubjectRlsContext(scopedDb, subjectId);\n      return await fn(scopedDb);\n    },\n    transactionConfig,\n    fenceMode,\n    organizationMembershipFence,\n  );\n}\n\n/** Apply and verify actor-private RLS on an already transaction-pinned handle. */\nexport async function setSubjectRlsContext(db: Database, subjectId: string): Promise<void> {\n  if (!subjectId.trim()) {\n    throw new Error(\"setSubjectRlsContext: a non-empty subjectId is required\");\n  }\n  await db.execute(sql`select set_config('opengeni.subject_id', ${subjectId}, true)`);\n  const applied = await db.execute<{ subject_id: string | null }>(\n    sql`select current_setting('opengeni.subject_id', true) as subject_id`,\n  );\n  if ((applied[0]?.subject_id ?? \"\") !== subjectId) {\n    throw new Error(\"Authenticated subject RLS context was not applied on the active backend\");\n  }\n}\n\nexport async function withWorkspaceUsageLock<T>(\n  db: Database,\n  workspaceId: string,\n  fn: (db: Database) => Promise<T>,\n): Promise<T> {\n  const context = await rlsContextForWorkspace(db, workspaceId);\n  return await withRlsContext(db, context, async (scopedDb) => {\n    await scopedDb.execute(sql`select pg_advisory_xact_lock(hashtext(${`usage:${workspaceId}`}))`);\n    return await fn(scopedDb);\n  });\n}\n\nexport async function withAccountRls<T>(\n  db: Database,\n  accountId: string,\n  fn: (db: Database) => Promise<T>,\n): Promise<T> {\n  return await withRlsContext(db, { accountId, workspaceId: null }, fn);\n}\n\n/** Internal lookup for the host binding attached to a database handle. */\nexport function dbBindingFor(db: Database): DbBinding | undefined {\n  return dbBindings.get(db as unknown as object);\n}\n"],"mappings":"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","names":["AsyncLocalStorage","AsyncLocalStorage"]}