@opengeni/db 3.2.0-canary.0 → 3.4.0-canary.0

package/dist/{chunk-6HMM2R5T.js → chunk-TRBOWUG3.js}

@@ -5,7 +5,7 @@ import {
   withWorkspaceRls,
   withWorkspaceSubjectRls,
   withWorkspaceSubjectSessionActivityRls
-} from "./chunk-AZHW7R5V.js";
+} from "./chunk-H7MXYG7R.js";
 
 // src/session-tenancy.ts
 import { createHash } from "crypto";
@@ -199,6 +199,18 @@ function canonicalSessionVisibilityTransitionHash(input) {
   ).digest("hex");
 }
 function canonicalSessionForkHash(input) {
+  if (input.runtimeRequest) {
+    return createHash("sha256").update(
+      JSON.stringify({
+        version: 3,
+        sourceSessionId: input.sourceSessionId,
+        destinationWorkspaceId: input.destinationWorkspaceId,
+        destinationVisibility: input.destinationVisibility,
+        workspaceSharedAcknowledged: input.workspaceSharedAcknowledged,
+        runtime: input.runtimeRequest
+      })
+    ).digest("hex");
+  }
   const legacyCompatiblePrivateRequest = input.destinationVisibility === "user_private" && !input.workspaceSharedAcknowledged;
   return createHash("sha256").update(
     JSON.stringify(
@@ -217,6 +229,9 @@ function canonicalSessionForkHash(input) {
     )
   ).digest("hex");
 }
+function canonicalForkRuntimeConfigurationDigest(input) {
+  return createHash("sha256").update(JSON.stringify({ version: 1, ...input })).digest("hex");
+}
 async function transitionSessionVisibility(db, input) {
   if (!Number.isSafeInteger(input.expectedAuthorityEpoch) || input.expectedAuthorityEpoch < 1) {
     throw new Error("expectedAuthorityEpoch must be a positive safe integer");
@@ -275,6 +290,12 @@ async function forkSessionContent(db, input) {
   if (input.destinationWorkspaceId !== input.sourceWorkspaceId) {
     throw new Error("The first session fork contract is same-workspace only");
   }
+  if (Boolean(input.runtimeRequest) !== Boolean(input.runtimeConfiguration)) {
+    throw new Error("A fresh session fork runtime request requires its resolved configuration");
+  }
+  if (input.runtimeRequest && (input.runtimeRequest.rigId !== input.runtimeConfiguration?.rigId || JSON.stringify(input.runtimeRequest.variableSetIds) !== JSON.stringify(input.runtimeConfiguration?.variableSetIds))) {
+    throw new Error("Resolved session fork runtime configuration does not match its request");
+  }
   const { accountId } = await rlsContextForWorkspace(db, input.sourceWorkspaceId);
   await assertSessionTenancyProductActivated(db, input.sourceWorkspaceId);
   const requestHash = canonicalSessionForkHash(input);
@@ -284,6 +305,43 @@ async function forkSessionContent(db, input) {
       input.sourceWorkspaceId,
       input.actorSubjectId,
       async (scopedDb) => {
+        if (input.runtimeRequest && input.runtimeConfiguration) {
+          const runtimeDigest = canonicalForkRuntimeConfigurationDigest(input.runtimeRequest);
+          const rows2 = await rawRows(
+            scopedDb,
+            sql`select
+            operation_id as "operationId",
+            event_id as "eventId",
+            event_sequence as "eventSequence",
+            session_id as "sessionId",
+            workspace_id as "workspaceId",
+            visibility,
+            authority_epoch as "authorityEpoch",
+            copied_history_item_count as "copiedHistoryItemCount",
+            replay,
+            runtime_event_id as "runtimeEventId",
+            runtime_event_sequence as "runtimeEventSequence"
+          from fork_session_content_with_runtime(
+            ${accountId}::uuid,
+            ${input.sourceWorkspaceId}::uuid,
+            ${input.sourceSessionId}::uuid,
+            ${input.actorSubjectId},
+            ${input.destinationWorkspaceId}::uuid,
+            ${input.destinationVisibility},
+            ${input.workspaceSharedAcknowledged},
+            ${input.operationKey},
+            ${requestHash},
+            ${SESSION_TENANCY_ACTIVATION_VERSION},
+            ${JSON.stringify(input.runtimeConfiguration.variableSetIds)}::jsonb,
+            ${input.runtimeConfiguration.rigId}::uuid,
+            ${input.runtimeConfiguration.rigVersionId}::uuid,
+            ${runtimeDigest}
+          )`
+          );
+          const result2 = rows2[0];
+          if (!result2) throw new Error("Session fork returned no result");
+          return result2;
+        }
         const rows = await rawRows(
           scopedDb,
           sql`select
@@ -295,7 +353,9 @@ async function forkSessionContent(db, input) {
           visibility,
           authority_epoch as "authorityEpoch",
           copied_history_item_count as "copiedHistoryItemCount",
-          replay
+          replay,
+          null::uuid as "runtimeEventId",
+          null::integer as "runtimeEventSequence"
         from fork_session_content(
           ${accountId}::uuid,
           ${input.sourceWorkspaceId}::uuid,
@@ -337,6 +397,38 @@ async function replayAppliedSessionFork(db, input) {
       input.sourceWorkspaceId,
       input.actorSubjectId,
       async (scopedDb) => {
+        if (input.runtimeRequest) {
+          const runtimeDigest = canonicalForkRuntimeConfigurationDigest(input.runtimeRequest);
+          const rows2 = await rawRows(
+            scopedDb,
+            sql`select
+            operation_id as "operationId",
+            event_id as "eventId",
+            event_sequence as "eventSequence",
+            session_id as "sessionId",
+            workspace_id as "workspaceId",
+            visibility,
+            authority_epoch as "authorityEpoch",
+            copied_history_item_count as "copiedHistoryItemCount",
+            replay,
+            runtime_event_id as "runtimeEventId",
+            runtime_event_sequence as "runtimeEventSequence"
+          from replay_applied_session_fork_with_runtime(
+            ${accountId}::uuid,
+            ${input.sourceWorkspaceId}::uuid,
+            ${input.sourceSessionId}::uuid,
+            ${input.actorSubjectId},
+            ${input.destinationWorkspaceId}::uuid,
+            ${input.destinationVisibility},
+            ${input.workspaceSharedAcknowledged},
+            ${input.operationKey},
+            ${requestHash},
+            ${SESSION_TENANCY_ACTIVATION_VERSION},
+            ${runtimeDigest}
+          )`
+          );
+          return rows2[0] ?? null;
+        }
         const rows = await rawRows(
           scopedDb,
           sql`select
@@ -348,7 +440,9 @@ async function replayAppliedSessionFork(db, input) {
           visibility,
           authority_epoch as "authorityEpoch",
           copied_history_item_count as "copiedHistoryItemCount",
-          replay
+          replay,
+          null::uuid as "runtimeEventId",
+          null::integer as "runtimeEventSequence"
         from replay_applied_session_fork(
           ${accountId}::uuid,
           ${input.sourceWorkspaceId}::uuid,
@@ -387,4 +481,4 @@ export {
   forkSessionContent,
   replayAppliedSessionFork
 };
-//# sourceMappingURL=chunk-6HMM2R5T.js.map
+//# sourceMappingURL=chunk-TRBOWUG3.js.map

package/dist/chunk-TRBOWUG3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session-tenancy.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { sql } from \"drizzle-orm\";\nimport {\n  SessionTenancyBlocker as SessionTenancyBlockerSchema,\n  type SessionTenancyBlocker,\n} from \"@opengeni/contracts\";\nimport {\n  rawRows,\n  type Database,\n  rlsContextForWorkspace,\n  withWorkspaceRls,\n  withWorkspaceSubjectRls,\n  withWorkspaceSubjectSessionActivityRls,\n} from \"./database\";\nimport { nestedPostgresSqlState } from \"./persistence-errors\";\n\nconst SESSION_TENANCY_ACTIVATION_VERSION = 1;\n\nexport class SessionTenancyConflictError extends Error {\n  readonly name = \"SessionTenancyConflictError\";\n  constructor(\n    readonly reason: \"not_quiescent\" | \"authority_epoch\" | \"operation_reuse\",\n    readonly blocker: SessionTenancyBlocker | null = null,\n    options?: ErrorOptions,\n  ) {\n    super(\n      reason === \"not_quiescent\"\n        ? \"Session must be fully quiescent before its tenancy can change\"\n        : reason === \"authority_epoch\"\n          ? \"Session authority changed before the operation committed\"\n          : \"Session tenancy operation key was reused with different input\",\n      options,\n    );\n  }\n}\n\nexport class SessionTenancyNotActivatedError extends Error {\n  readonly name = \"SessionTenancyNotActivatedError\";\n  constructor(options?: ErrorOptions) {\n    super(\"Session tenancy product surface is not activated for this organization\", options);\n  }\n}\n\nexport class SessionTenancyAccessError extends Error {\n  readonly name = \"SessionTenancyAccessError\";\n  constructor(options?: ErrorOptions) {\n    super(\"Session tenancy target is unavailable\", options);\n  }\n}\n\nexport class SessionTenancyInvalidRequestError extends Error {\n  readonly name = \"SessionTenancyInvalidRequestError\";\n  constructor(options?: ErrorOptions) {\n    super(\"Session tenancy request is invalid\", options);\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value && typeof value === \"object\");\n}\n\n/** Extract only the fixed quiescence DETAIL vocabulary, never arbitrary driver detail. */\nexport function nestedSessionTenancyBlocker(error: unknown): SessionTenancyBlocker | null {\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    for (const key of [\"detail\", \"detailMessage\"] as const) {\n      const parsed = SessionTenancyBlockerSchema.safeParse(current[key]);\n      if (parsed.success) return parsed.data;\n    }\n    for (const key of [\"cause\", \"original\", \"driverError\", \"error\", \"errors\"] as const) {\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 null;\n}\n\nexport type SessionTenancyVisibility = \"user_private\" | \"workspace_shared\";\n\nexport type PrivateSessionCreatePolicy = {\n  personalWorkspace: boolean;\n  platformAvailable: boolean;\n  organizationEnabled: boolean;\n};\n\nexport type TransitionSessionVisibilityInput = {\n  workspaceId: string;\n  sessionId: string;\n  actorSubjectId: string;\n  targetVisibility: SessionTenancyVisibility;\n  expectedAuthorityEpoch: number;\n  operationKey: string;\n};\n\nexport type TransitionSessionVisibilityResult = {\n  operationId: string;\n  eventId: string | null;\n  eventSequence: number | null;\n  visibility: SessionTenancyVisibility;\n  authorityEpoch: number;\n  ownerOrganizationMembershipId: string | null;\n  changed: boolean;\n  replay: boolean;\n  interruptedAttemptCount: number;\n  cancelledTurnCount: number;\n  cancelledUpdateCount: number;\n  pausedGoalCount: number;\n  revokedGrantCount: number;\n};\n\nexport type ForkSessionContentInput = {\n  sourceWorkspaceId: string;\n  sourceSessionId: string;\n  actorSubjectId: string;\n  destinationWorkspaceId: string;\n  destinationVisibility: SessionTenancyVisibility;\n  workspaceSharedAcknowledged: boolean;\n  operationKey: string;\n  runtimeRequest?: ForkSessionRuntimeRequest;\n  runtimeConfiguration?: ForkSessionRuntimeConfiguration;\n};\n\nexport type ForkSessionRuntimeRequest = {\n  variableSetIds: string[];\n  rigId: string | null;\n};\n\nexport type ForkSessionRuntimeConfiguration = ForkSessionRuntimeRequest & {\n  rigVersionId: string | null;\n};\n\nexport type ForkSessionContentResult = {\n  operationId: string;\n  eventId: string;\n  eventSequence: number;\n  sessionId: string;\n  workspaceId: string;\n  visibility: SessionTenancyVisibility;\n  authorityEpoch: number;\n  copiedHistoryItemCount: number;\n  replay: boolean;\n  runtimeEventId: string | null;\n  runtimeEventSequence: number | null;\n};\n\nexport async function sessionTenancyProductActivated(\n  db: Database,\n  workspaceId: string,\n): Promise<boolean> {\n  const { accountId } = await rlsContextForWorkspace(db, workspaceId);\n  return await withWorkspaceRls(db, workspaceId, async (scopedDb) => {\n    const rows = await rawRows<{ activated: boolean }>(\n      scopedDb,\n      sql`select session_tenancy_product_activated(\n        ${accountId}::uuid,\n        ${SESSION_TENANCY_ACTIVATION_VERSION}\n      ) as activated`,\n    );\n    return rows[0]?.activated === true;\n  });\n}\n\nexport async function getPrivateSessionCreatePolicy(\n  db: Database,\n  input: { workspaceId: string; actorSubjectId: string },\n): Promise<PrivateSessionCreatePolicy> {\n  const { accountId } = await rlsContextForWorkspace(db, input.workspaceId);\n  return await withWorkspaceSubjectRls(\n    db,\n    input.workspaceId,\n    input.actorSubjectId,\n    async (scopedDb) => {\n      const rows = await rawRows<{\n        personalWorkspace: boolean;\n        platformAvailable: boolean;\n        organizationEnabled: boolean;\n      }>(\n        scopedDb,\n        sql`select\n          personal_workspace as \"personalWorkspace\",\n          platform_available as \"platformAvailable\",\n          organization_enabled as \"organizationEnabled\"\n        from get_private_session_create_policy(\n          ${accountId}::uuid,\n          ${input.workspaceId}::uuid,\n          ${input.actorSubjectId}\n        )`,\n      );\n      const policy = rows[0];\n      if (!policy) throw new SessionTenancyAccessError();\n      return policy;\n    },\n  );\n}\n\n/** Open the exact transaction-local trigger capability used by atomic private create. */\nexport async function openPrivateSessionCreateCapability(\n  db: Database,\n  input: { accountId: string; workspaceId: string; sessionId: string; actorSubjectId: string },\n): Promise<{ capabilityId: string; ownerMembershipId: string }> {\n  let rows: Array<{ capabilityId: string; ownerMembershipId: string }>;\n  try {\n    rows = await rawRows<{ capabilityId: string; ownerMembershipId: string }>(\n      db,\n      sql`select\n        capability_id as \"capabilityId\",\n        owner_membership_id as \"ownerMembershipId\"\n      from open_private_session_create_capability(\n        ${input.accountId}::uuid,\n        ${input.workspaceId}::uuid,\n        ${input.sessionId}::uuid,\n        ${input.actorSubjectId}\n      )`,\n    );\n  } catch (error) {\n    // The definer raises 55000 only when the organization owner/admin setting\n    // does not permit a new private session in this shared workspace; every\n    // authority failure remains 42501 and propagates unchanged.\n    if (nestedPostgresSqlState(error) === \"55000\") {\n      throw new SessionTenancyNotActivatedError({ cause: error });\n    }\n    throw error;\n  }\n  const capabilityId = rows[0]?.capabilityId;\n  const ownerMembershipId = rows[0]?.ownerMembershipId;\n  if (!capabilityId || !ownerMembershipId) {\n    throw new Error(\"Private session create capability was not returned\");\n  }\n  return { capabilityId, ownerMembershipId };\n}\n\n/** Open the exact transaction-local capability for one private child insert. */\nexport async function openPrivateChildSessionCreateCapability(\n  db: Database,\n  input: {\n    accountId: string;\n    workspaceId: string;\n    sessionId: string;\n    parentSessionId: string;\n    actorTurnId: string;\n    actorAttemptId: string;\n    actorExecutionGeneration: number;\n  },\n): Promise<{ capabilityId: string; ownerMembershipId: string; ownerSubjectId: string }> {\n  const rows = await rawRows<{\n    capabilityId: string;\n    ownerMembershipId: string;\n    ownerSubjectId: string;\n  }>(\n    db,\n    sql`select\n      capability_id as \"capabilityId\",\n      owner_membership_id as \"ownerMembershipId\",\n      owner_subject_id as \"ownerSubjectId\"\n    from open_private_child_session_create_capability(\n      ${input.accountId}::uuid,\n      ${input.workspaceId}::uuid,\n      ${input.sessionId}::uuid,\n      ${input.parentSessionId}::uuid,\n      ${input.actorTurnId}::uuid,\n      ${input.actorAttemptId}::uuid,\n      ${input.actorExecutionGeneration}::integer\n    )`,\n  );\n  const capabilityId = rows[0]?.capabilityId;\n  const ownerMembershipId = rows[0]?.ownerMembershipId;\n  const ownerSubjectId = rows[0]?.ownerSubjectId;\n  if (!capabilityId || !ownerMembershipId || !ownerSubjectId) {\n    throw new Error(\"Private child session create capability was not returned\");\n  }\n  return { capabilityId, ownerMembershipId, ownerSubjectId };\n}\n\nexport async function closePrivateSessionCreateCapability(\n  db: Database,\n  capabilityId: string,\n): Promise<void> {\n  await db.execute(sql`select close_private_session_create_capability(${capabilityId}::uuid)`);\n}\n\nasync function assertSessionTenancyProductActivated(\n  db: Database,\n  workspaceId: string,\n): Promise<void> {\n  if (!(await sessionTenancyProductActivated(db, workspaceId))) {\n    throw new SessionTenancyNotActivatedError();\n  }\n}\n\nfunction mapSessionTenancyPersistenceError(\n  error: unknown,\n  options: { authorityEpochConflict: boolean },\n): never {\n  const state = nestedPostgresSqlState(error);\n  if (state === \"55P03\") {\n    throw new SessionTenancyConflictError(\"not_quiescent\", nestedSessionTenancyBlocker(error), {\n      cause: error,\n    });\n  }\n  if (state === \"40001\" && options.authorityEpochConflict) {\n    throw new SessionTenancyConflictError(\"authority_epoch\", null, { cause: error });\n  }\n  if (state === \"23505\") {\n    throw new SessionTenancyConflictError(\"operation_reuse\", null, { cause: error });\n  }\n  if (state === \"55000\") {\n    throw new SessionTenancyNotActivatedError({ cause: error });\n  }\n  if (state === \"42501\" || state === \"P0002\") {\n    throw new SessionTenancyAccessError({ cause: error });\n  }\n  if (state === \"22023\") {\n    throw new SessionTenancyInvalidRequestError({ cause: error });\n  }\n  throw error;\n}\n\nexport function canonicalSessionVisibilityTransitionHash(\n  input: Pick<\n    TransitionSessionVisibilityInput,\n    \"sessionId\" | \"targetVisibility\" | \"expectedAuthorityEpoch\"\n  >,\n): string {\n  return createHash(\"sha256\")\n    .update(\n      JSON.stringify({\n        version: 1,\n        sessionId: input.sessionId,\n        targetVisibility: input.targetVisibility,\n        expectedAuthorityEpoch: input.expectedAuthorityEpoch,\n      }),\n    )\n    .digest(\"hex\");\n}\n\nexport function canonicalSessionForkHash(\n  input: Pick<\n    ForkSessionContentInput,\n    | \"sourceSessionId\"\n    | \"destinationWorkspaceId\"\n    | \"destinationVisibility\"\n    | \"workspaceSharedAcknowledged\"\n    | \"runtimeRequest\"\n  >,\n): string {\n  if (input.runtimeRequest) {\n    return createHash(\"sha256\")\n      .update(\n        JSON.stringify({\n          version: 3,\n          sourceSessionId: input.sourceSessionId,\n          destinationWorkspaceId: input.destinationWorkspaceId,\n          destinationVisibility: input.destinationVisibility,\n          workspaceSharedAcknowledged: input.workspaceSharedAcknowledged,\n          runtime: input.runtimeRequest,\n        }),\n      )\n      .digest(\"hex\");\n  }\n  const legacyCompatiblePrivateRequest =\n    input.destinationVisibility === \"user_private\" && !input.workspaceSharedAcknowledged;\n  return createHash(\"sha256\")\n    .update(\n      JSON.stringify(\n        legacyCompatiblePrivateRequest\n          ? {\n              version: 1,\n              sourceSessionId: input.sourceSessionId,\n              destinationWorkspaceId: input.destinationWorkspaceId,\n              destinationVisibility: input.destinationVisibility,\n            }\n          : {\n              version: 2,\n              sourceSessionId: input.sourceSessionId,\n              destinationWorkspaceId: input.destinationWorkspaceId,\n              destinationVisibility: input.destinationVisibility,\n              workspaceSharedAcknowledged: input.workspaceSharedAcknowledged,\n            },\n      ),\n    )\n    .digest(\"hex\");\n}\n\nfunction canonicalForkRuntimeConfigurationDigest(input: ForkSessionRuntimeRequest): string {\n  return createHash(\"sha256\")\n    .update(JSON.stringify({ version: 1, ...input }))\n    .digest(\"hex\");\n}\n\nexport async function transitionSessionVisibility(\n  db: Database,\n  input: TransitionSessionVisibilityInput,\n): Promise<TransitionSessionVisibilityResult> {\n  if (!Number.isSafeInteger(input.expectedAuthorityEpoch) || input.expectedAuthorityEpoch < 1) {\n    throw new Error(\"expectedAuthorityEpoch must be a positive safe integer\");\n  }\n  if (!input.operationKey.trim()) throw new Error(\"operationKey must not be empty\");\n  const requestHash = canonicalSessionVisibilityTransitionHash(input);\n  const { accountId } = await rlsContextForWorkspace(db, input.workspaceId);\n  await assertSessionTenancyProductActivated(db, input.workspaceId);\n  try {\n    return await withWorkspaceSubjectSessionActivityRls(\n      db,\n      input.workspaceId,\n      input.actorSubjectId,\n      async (scopedDb) => {\n        const rows = await rawRows<{\n          operationId: string;\n          eventId: string | null;\n          eventSequence: number | null;\n          visibility: SessionTenancyVisibility;\n          authorityEpoch: number;\n          ownerOrganizationMembershipId: string | null;\n          changed: boolean;\n          replay: boolean;\n          interruptedAttemptCount: number;\n          cancelledTurnCount: number;\n          cancelledUpdateCount: number;\n          pausedGoalCount: number;\n          revokedGrantCount: number;\n        }>(\n          scopedDb,\n          sql`select\n          operation_id as \"operationId\",\n          event_id as \"eventId\",\n          event_sequence as \"eventSequence\",\n          visibility,\n          authority_epoch as \"authorityEpoch\",\n          owner_organization_membership_id as \"ownerOrganizationMembershipId\",\n          changed,\n          replay,\n          interrupted_attempt_count as \"interruptedAttemptCount\",\n          cancelled_turn_count as \"cancelledTurnCount\",\n          cancelled_update_count as \"cancelledUpdateCount\",\n          paused_goal_count as \"pausedGoalCount\",\n          revoked_grant_count as \"revokedGrantCount\"\n        from transition_session_visibility(\n          ${accountId}::uuid,\n          ${input.workspaceId}::uuid,\n          ${input.sessionId}::uuid,\n          ${input.actorSubjectId},\n          ${input.targetVisibility},\n          ${input.expectedAuthorityEpoch},\n          ${input.operationKey},\n          ${requestHash},\n          ${SESSION_TENANCY_ACTIVATION_VERSION}\n        )`,\n        );\n        const result = rows[0];\n        if (!result) throw new Error(\"Session visibility transition returned no result\");\n        return result;\n      },\n      undefined,\n      \"none\",\n    );\n  } catch (error) {\n    mapSessionTenancyPersistenceError(error, { authorityEpochConflict: true });\n  }\n}\n\nexport async function forkSessionContent(\n  db: Database,\n  input: ForkSessionContentInput,\n): Promise<ForkSessionContentResult> {\n  if (!input.operationKey.trim()) throw new Error(\"operationKey must not be empty\");\n  if (input.destinationWorkspaceId !== input.sourceWorkspaceId) {\n    throw new Error(\"The first session fork contract is same-workspace only\");\n  }\n  if (Boolean(input.runtimeRequest) !== Boolean(input.runtimeConfiguration)) {\n    throw new Error(\"A fresh session fork runtime request requires its resolved configuration\");\n  }\n  if (\n    input.runtimeRequest &&\n    (input.runtimeRequest.rigId !== input.runtimeConfiguration?.rigId ||\n      JSON.stringify(input.runtimeRequest.variableSetIds) !==\n        JSON.stringify(input.runtimeConfiguration?.variableSetIds))\n  ) {\n    throw new Error(\"Resolved session fork runtime configuration does not match its request\");\n  }\n  const { accountId } = await rlsContextForWorkspace(db, input.sourceWorkspaceId);\n  await assertSessionTenancyProductActivated(db, input.sourceWorkspaceId);\n  const requestHash = canonicalSessionForkHash(input);\n  try {\n    return await withWorkspaceSubjectRls(\n      db,\n      input.sourceWorkspaceId,\n      input.actorSubjectId,\n      async (scopedDb) => {\n        if (input.runtimeRequest && input.runtimeConfiguration) {\n          const runtimeDigest = canonicalForkRuntimeConfigurationDigest(input.runtimeRequest);\n          const rows = await rawRows<ForkSessionContentResult>(\n            scopedDb,\n            sql`select\n            operation_id as \"operationId\",\n            event_id as \"eventId\",\n            event_sequence as \"eventSequence\",\n            session_id as \"sessionId\",\n            workspace_id as \"workspaceId\",\n            visibility,\n            authority_epoch as \"authorityEpoch\",\n            copied_history_item_count as \"copiedHistoryItemCount\",\n            replay,\n            runtime_event_id as \"runtimeEventId\",\n            runtime_event_sequence as \"runtimeEventSequence\"\n          from fork_session_content_with_runtime(\n            ${accountId}::uuid,\n            ${input.sourceWorkspaceId}::uuid,\n            ${input.sourceSessionId}::uuid,\n            ${input.actorSubjectId},\n            ${input.destinationWorkspaceId}::uuid,\n            ${input.destinationVisibility},\n            ${input.workspaceSharedAcknowledged},\n            ${input.operationKey},\n            ${requestHash},\n            ${SESSION_TENANCY_ACTIVATION_VERSION},\n            ${JSON.stringify(input.runtimeConfiguration.variableSetIds)}::jsonb,\n            ${input.runtimeConfiguration.rigId}::uuid,\n            ${input.runtimeConfiguration.rigVersionId}::uuid,\n            ${runtimeDigest}\n          )`,\n          );\n          const result = rows[0];\n          if (!result) throw new Error(\"Session fork returned no result\");\n          return result;\n        }\n        const rows = await rawRows<ForkSessionContentResult>(\n          scopedDb,\n          sql`select\n          operation_id as \"operationId\",\n          event_id as \"eventId\",\n          event_sequence as \"eventSequence\",\n          session_id as \"sessionId\",\n          workspace_id as \"workspaceId\",\n          visibility,\n          authority_epoch as \"authorityEpoch\",\n          copied_history_item_count as \"copiedHistoryItemCount\",\n          replay,\n          null::uuid as \"runtimeEventId\",\n          null::integer as \"runtimeEventSequence\"\n        from fork_session_content(\n          ${accountId}::uuid,\n          ${input.sourceWorkspaceId}::uuid,\n          ${input.sourceSessionId}::uuid,\n          ${input.actorSubjectId},\n          ${input.destinationWorkspaceId}::uuid,\n          ${input.destinationVisibility},\n          ${input.workspaceSharedAcknowledged},\n          ${input.operationKey},\n          ${requestHash},\n          ${SESSION_TENANCY_ACTIVATION_VERSION}\n        )`,\n        );\n        const result = rows[0];\n        if (!result) throw new Error(\"Session fork returned no result\");\n        return result;\n      },\n      undefined,\n      \"none\",\n    );\n  } catch (error) {\n    // A private destination inside a shared workspace carries the same\n    // organization owner/admin product decision the create path enforces\n    // (migration 0323), and the fork routine raises the same 55000. Surface it\n    // as the not-activated product state rather than an opaque database error.\n    if (nestedPostgresSqlState(error) === \"55000\") {\n      throw new SessionTenancyNotActivatedError({ cause: error });\n    }\n    mapSessionTenancyPersistenceError(error, { authorityEpochConflict: false });\n  }\n}\n\n/**\n * Recover one exact committed fork before mutable source-session authorization.\n *\n * The database capability requires the authenticated actor's active workspace\n * authority and matches the complete actor/workspace/source/key/request-hash\n * tuple. A fresh key returns null; changed intent raises the ordinary tenancy\n * idempotency conflict. This is receipt recovery, not session discovery.\n */\nexport async function replayAppliedSessionFork(\n  db: Database,\n  input: ForkSessionContentInput,\n): Promise<ForkSessionContentResult | null> {\n  if (!input.operationKey.trim()) throw new Error(\"operationKey must not be empty\");\n  if (input.destinationWorkspaceId !== input.sourceWorkspaceId) {\n    throw new Error(\"The first session fork contract is same-workspace only\");\n  }\n  const { accountId } = await rlsContextForWorkspace(db, input.sourceWorkspaceId);\n  await assertSessionTenancyProductActivated(db, input.sourceWorkspaceId);\n  const requestHash = canonicalSessionForkHash(input);\n  try {\n    return await withWorkspaceSubjectRls(\n      db,\n      input.sourceWorkspaceId,\n      input.actorSubjectId,\n      async (scopedDb) => {\n        if (input.runtimeRequest) {\n          const runtimeDigest = canonicalForkRuntimeConfigurationDigest(input.runtimeRequest);\n          const rows = await rawRows<ForkSessionContentResult>(\n            scopedDb,\n            sql`select\n            operation_id as \"operationId\",\n            event_id as \"eventId\",\n            event_sequence as \"eventSequence\",\n            session_id as \"sessionId\",\n            workspace_id as \"workspaceId\",\n            visibility,\n            authority_epoch as \"authorityEpoch\",\n            copied_history_item_count as \"copiedHistoryItemCount\",\n            replay,\n            runtime_event_id as \"runtimeEventId\",\n            runtime_event_sequence as \"runtimeEventSequence\"\n          from replay_applied_session_fork_with_runtime(\n            ${accountId}::uuid,\n            ${input.sourceWorkspaceId}::uuid,\n            ${input.sourceSessionId}::uuid,\n            ${input.actorSubjectId},\n            ${input.destinationWorkspaceId}::uuid,\n            ${input.destinationVisibility},\n            ${input.workspaceSharedAcknowledged},\n            ${input.operationKey},\n            ${requestHash},\n            ${SESSION_TENANCY_ACTIVATION_VERSION},\n            ${runtimeDigest}\n          )`,\n          );\n          return rows[0] ?? null;\n        }\n        const rows = await rawRows<ForkSessionContentResult>(\n          scopedDb,\n          sql`select\n          operation_id as \"operationId\",\n          event_id as \"eventId\",\n          event_sequence as \"eventSequence\",\n          session_id as \"sessionId\",\n          workspace_id as \"workspaceId\",\n          visibility,\n          authority_epoch as \"authorityEpoch\",\n          copied_history_item_count as \"copiedHistoryItemCount\",\n          replay,\n          null::uuid as \"runtimeEventId\",\n          null::integer as \"runtimeEventSequence\"\n        from replay_applied_session_fork(\n          ${accountId}::uuid,\n          ${input.sourceWorkspaceId}::uuid,\n          ${input.sourceSessionId}::uuid,\n          ${input.actorSubjectId},\n          ${input.destinationWorkspaceId}::uuid,\n          ${input.destinationVisibility},\n          ${input.workspaceSharedAcknowledged},\n          ${input.operationKey},\n          ${requestHash},\n          ${SESSION_TENANCY_ACTIVATION_VERSION}\n        )`,\n        );\n        return rows[0] ?? null;\n      },\n    );\n  } catch (error) {\n    mapSessionTenancyPersistenceError(error, { authorityEpochConflict: false });\n  }\n}\n"],"mappings":"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","names":["rows","result"]}

package/dist/{chunk-E6CLMKEE.js → chunk-V3TRUXFJ.js}

@@ -1,7 +1,7 @@
 import {
   nestedPostgresSqlState,
   rawRows
-} from "./chunk-AZHW7R5V.js";
+} from "./chunk-H7MXYG7R.js";
 
 // src/canonical-human-identities.ts
 import { createHash } from "crypto";
@@ -256,4 +256,4 @@ export {
   getCanonicalHumanIdentityProjection,
   applyCanonicalHumanIdentityOperation
 };
-//# sourceMappingURL=chunk-E6CLMKEE.js.map
+//# sourceMappingURL=chunk-V3TRUXFJ.js.map

package/dist/{chunk-2EH4WRHL.js → chunk-ZWRIPCTR.js}

@@ -1,7 +1,7 @@
 import {
   rawRows,
   withRlsContext
-} from "./chunk-AZHW7R5V.js";
+} from "./chunk-H7MXYG7R.js";
 
 // src/editable-artifacts.ts
 import { createHash } from "crypto";
@@ -3540,4 +3540,4 @@ export {
   PostgresEditableArtifactStore,
   PostgresEditableArtifactLiveReadStore
 };
-//# sourceMappingURL=chunk-2EH4WRHL.js.map
+//# sourceMappingURL=chunk-ZWRIPCTR.js.map

package/dist/editable-artifact-durable-export.js

@@ -1,8 +1,8 @@
 import {
   rawRows,
   withRlsContext
-} from "./chunk-AZHW7R5V.js";
-import "./chunk-KRLPEMLH.js";
+} from "./chunk-H7MXYG7R.js";
+import "./chunk-C2AFP7SB.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/editable-artifact-durable-export.ts

package/dist/editable-artifacts.js

@@ -8,9 +8,9 @@ import {
   PostgresEditableArtifactStore,
   listEditableArtifactIdsForSession,
   touchEditableArtifactSessionLink
-} from "./chunk-2EH4WRHL.js";
-import "./chunk-AZHW7R5V.js";
-import "./chunk-KRLPEMLH.js";
+} from "./chunk-ZWRIPCTR.js";
+import "./chunk-H7MXYG7R.js";
+import "./chunk-C2AFP7SB.js";
 import "./chunk-PZ5AY32C.js";
 export {
   EDITABLE_ARTIFACT_INTENT_MAX_BYTES,

package/dist/governed-learning-activation.d.ts

@@ -87,6 +87,22 @@ export declare function confirmRememberKnowledgeClaim(db: Database, raw: {
     };
     request: ConfirmRememberKnowledgeClaimRequestType;
 }): Promise<RememberKnowledgeConfirmationReceiptType>;
+export type RememberKnowledgeMemoryMaterialization = {
+    confirmationReceiptId: string;
+    accountId: string;
+    workspaceId: string;
+    sessionId: string;
+    memoryId: string;
+    taskNoteTextHash: string;
+    createdAt: string;
+};
+/**
+ * Materialize the exact approved Task-note text behind one completed remember
+ * confirmation. The database capability owns the insert and its immutable
+ * confirmation-to-Memory mapping, so generic deduplication cannot substitute a
+ * normalized lookalike and replay keeps the same Memory id after archival.
+ */
+export declare function materializeConfirmedRememberKnowledgeMemory(db: Database, receipt: RememberKnowledgeConfirmationReceiptType): Promise<RememberKnowledgeMemoryMaterialization>;
 /**
  * Read the initiating human bound to one workspace-scoped Knowledge claim under
  * workspace RLS. Used by `remember_confirm` for the Knowledge lane; exposes no

package/dist/index.d.ts

@@ -37,6 +37,7 @@ export * from "./company-brain-context-selection.js";
 export * from "./knowledge-source-sync.js";
 export * from "./task-notes.js";
 export * from "./managed-human-provisioning.js";
+export * from "./managed-user-setup.js";
 export * from "./organization-membership-backfill.js";
 export * from "./connection-tenancy-backfill.js";
 export * from "./generated-images.js";
@@ -57,6 +58,8 @@ export * from "./capability-integrations.js";
 export * from "./integration-bindings.js";
 export * from "./integration-facets.js";
 export * from "./insights.js";
+export * from "./insights-model-bundle.js";
+export * from "./insights-usage-bundle.js";
 export * from "./organization-membership-lifecycle.js";
 export { rlsSubjectIdOrEmpty, subjectHasLiveWorkspaceAuthorityInScope, } from "./workspace-authority.js";
 export { memoryTextForStorage } from "./memory-domain.js";
@@ -277,6 +280,7 @@ export declare function ensureManagedAccessForUser(db: Database, input: {
     email: string;
     name: string;
     emailVerified?: boolean;
+    provisionFallbackOrganization?: boolean;
 }): Promise<AccessContext>;
 export type ManagedAccessProvisioningResult = {
     accessContext: AccessContext;
@@ -287,6 +291,7 @@ export declare function ensureManagedAccessForUserWithOrganizationMemberships(db
     email: string;
     name: string;
     emailVerified?: boolean;
+    provisionFallbackOrganization?: boolean;
 }): Promise<ManagedAccessProvisioningResult>;
 export declare function getWorkspace(db: Database, workspaceId: string): Promise<Workspace | null>;
 export declare function getManagedAccount(db: Database, accountId: string): Promise<ManagedAccount | null>;
@@ -2823,7 +2828,11 @@ export declare class RigChangeAlreadyVerifyingError extends Error {
     readonly changeId: string;
     constructor(changeId: string);
 }
+export declare class RigImageOverrideUnsupportedError extends Error {
+    constructor();
+}
 export type RigVersionContentInput = {
+    /** @deprecated Rig versions always use the deployment platform sandbox image. */
     image?: string | null;
     setupScript?: string | null;
     checks?: RigCheck[];
@@ -2874,6 +2883,10 @@ export declare class ChannelNameConflictError extends Error {
 export declare class ChannelNotFoundError extends Error {
     constructor(channelId: string);
 }
+export declare class SessionVariableSetSelectionUnavailableError extends Error {
+    readonly variableSetIds: string[];
+    constructor(variableSetIds: string[], cause?: unknown);
+}
 export declare function createChannel(db: Database, input: {
     accountId: string;
     workspaceId: string;
@@ -2900,6 +2913,37 @@ export declare function setSessionChannel(db: Database, input: {
     sessionId: string;
     channelId: string | null;
 }): Promise<boolean>;
+export type UpdateSessionVariableSetsResult = {
+    status: "updated";
+    event: SessionEvent;
+} | {
+    status: "unchanged";
+} | {
+    status: "invalid_variable_sets";
+    variableSetIds: string[];
+} | {
+    status: "blocked";
+    reason: "turn_in_flight" | "shared_sandbox_group" | "live_sandbox_holders";
+} | {
+    status: "not_found";
+};
+/**
+ * Replace the complete ordered session Variable Set selection at a quiescent
+ * turn boundary. The session row + FK-backed attachment trigger + audit/event
+ * evidence commit together. A live managed box is fenced for rotation so its
+ * baked environment can never serve the next turn after a detach.
+ */
+export declare function updateSessionVariableSets(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    sessionId: string;
+    subjectId: string;
+    variableSets: Array<{
+        id: string;
+        name: string;
+        scope: VariableSet["scope"];
+    }>;
+}): Promise<UpdateSessionVariableSetsResult>;
 export declare function countRigs(db: Database, access: string | RigAccessContext, scope?: Rig["scope"]): Promise<number>;
 export declare function countSessionsUsingRig(db: Database, workspaceId: string, rigId: string): Promise<number>;
 export declare function createRigVersion(db: Database, workspaceId: string, rigId: string, input: RigVersionContentInput, options?: {
@@ -2969,9 +3013,9 @@ export type RigProviderImageBuildClaim = {
 };
 /**
  * Claim the one provider-image build slot for an existing immutable rig
- * version. A finalized ready image is never overwritten in place: if the
- * effective base/content identity changed, callers must mint/verify a new rig
- * version and runtime setup remains the truthful fallback for this one.
+ * version. The setup hash fences definition drift. Deployment base-image and
+ * provider-image protocol rotations may replace operational metadata for the
+ * same setup; late finalizers remain fenced by the build request id.
  */
 export declare function claimRigVersionProviderImageBuild(db: Database, input: {
     workspaceId: string;
@@ -4532,6 +4576,7 @@ export type SessionCreateInput = {
     reasoningEffort: ReasoningEffort;
     latencyMode: LatencyMode;
     sandboxBackend: SandboxBackend;
+    variableSetIds?: string[];
     variableSetId?: string | null;
     rigId?: string | null;
     rigVersionId?: string | null;
@@ -4652,6 +4697,8 @@ export declare function getAnySessionInGroup(db: Database, workspaceId: string,
  * whose members carry mixed variableSetIds.
  */
 export declare function listDistinctVariableSetIdsInGroup(db: Database, workspaceId: string, sandboxGroupId: string): Promise<Array<string | null>>;
+/** Ordered Variable Set selections across every member of a sandbox group. */
+export declare function listDistinctVariableSetSelectionsInGroup(db: Database, workspaceId: string, sandboxGroupId: string): Promise<string[][]>;
 export declare function listDistinctRigVersionIdsInGroup(db: Database, workspaceId: string, sandboxGroupId: string): Promise<Array<string | null>>;
 export declare function getWorkspaceDefaultRigId(db: Database, workspaceId: string): Promise<string | null>;
 export type ListSessionsOptions = {
@@ -8346,10 +8393,21 @@ export declare function recordSessionGoalProgressWithEvent(db: Database, workspa
     replay: boolean;
 }>;
 /**
- * Sets a session's display title. The clobber guard lives entirely in this
- * single atomic UPDATE: a user-set title is permanent, so agent/auto writes
- * carry an `AND title_source IS DISTINCT FROM 'user'` guard (NULL-safe in
- * Postgres) while user writes are unconditional. Never read-modify-write.
+ * Low-level row-only session-title update used by database-specific callers and
+ * tests. Public product writers should use `updateSessionTitleWithEvent` so the
+ * observable event commits atomically with this state transition. The clobber
+ * guard lives entirely in this single atomic UPDATE: a user-set title is
+ * permanent, so agent/auto writes
+ * are first normalized through the shared short/sensitive-safe automatic-title
+ * policy, then carry an `AND title_source IS DISTINCT FROM 'user'` guard
+ * (NULL-safe in Postgres) while user writes are unconditional. Automatic
+ * writes also bind the exact normalized candidate to a transaction-local
+ * database capability, so a pre-policy binary cannot bypass normalization
+ * during a rolling deployment. Never read-modify-write.
+ *
+ * `expectedCurrent`, when supplied, is an additional NULL-safe compare-and-set
+ * fence. It is used by stale/retry-prone producers such as scheduled dispatch:
+ * the write succeeds only if both the durable title and source still match.
  * Re-applying the exact title is also a no-op so a confused agent cannot churn
  * `updated_at` every turn. Returns `{ updated, title }`: `updated` is false when
  * the value was unchanged or an agent write was skipped because a user title
@@ -8361,9 +8419,39 @@ export declare function updateSessionTitle(db: Database, input: {
     sessionId: string;
     title: string;
     source: "user" | "agent";
+    expectedCurrent?: {
+        title: string | null;
+        source: "user" | "agent" | null;
+    };
+}): Promise<{
+    updated: boolean;
+    title: string | null;
+}>;
+/**
+ * Atomically set a session title and append its public `session.title_set`
+ * event under the canonical workspace/session event-write lock. The row CAS,
+ * durable sequence, and event either all commit or all roll back, so a newer
+ * title writer can never commit between the authoritative update and an older
+ * event append.
+ *
+ * Exact retries are naturally idempotent: the unchanged-title predicate (and,
+ * for stale producers, `expectedCurrent`) makes a committed retry a no-op with
+ * no duplicate event. Automatic titles retain the rolling-deployment trigger's
+ * exact transaction-local candidate capability.
+ */
+export declare function updateSessionTitleWithEvent(db: Database, input: {
+    workspaceId: string;
+    sessionId: string;
+    title: string;
+    source: "user" | "agent";
+    expectedCurrent?: {
+        title: string | null;
+        source: "user" | "agent" | null;
+    };
 }): Promise<{
     updated: boolean;
     title: string | null;
+    events: SessionEvent[];
 }>;
 /**
  * Status transition helper. Idempotent: requesting the current status returns
@@ -9074,6 +9162,19 @@ export declare function getSessionSystemUpdateOutboxByDedupeKey(db: Database, in
     dedupeKey: string;
 }): Promise<SessionSystemUpdateOutboxDelivery | null>;
 export declare function claimPendingSessionSystemUpdateOutbox(db: Database, limit?: number): Promise<SessionSystemUpdateOutboxDelivery[]>;
+export type AutomaticSessionTitleFanoutDelivery = {
+    outboxId: string;
+    event: SessionEvent;
+};
+/**
+ * Claim migration-created title events for deployment-wide NATS fanout. The
+ * function is SECURITY DEFINER because one control worker drains obligations
+ * across workspaces; callers receive only the exact already-public event
+ * projection, never arbitrary session rows.
+ */
+export declare function claimAutomaticSessionTitleFanout(db: Database, limit?: number): Promise<AutomaticSessionTitleFanoutDelivery[]>;
+export declare function markAutomaticSessionTitleFanoutDelivered(db: Database, delivery: AutomaticSessionTitleFanoutDelivery): Promise<boolean>;
+export declare function markAutomaticSessionTitleFanoutFailed(db: Database, delivery: AutomaticSessionTitleFanoutDelivery, error: string): Promise<boolean>;
 export type SessionWorkflowWake = {
     accountId: string;
     workspaceId: string;