@bastani/atomic 0.9.44-alpha.4 → 0.9.44-alpha.5

package/dist/builtin/workflows/src/index.js

@@ -58084,6 +58084,27 @@ var init_sql_pool_queue = __esm(() => {
   init_values();
 });
 
+// dist/builtin/workflows/src/engine/session-closed-error.ts
+import { isStaleExtensionContextError as isStaleExtensionContextError2 } from "@bastani/atomic";
+function reportsClosedSession(error) {
+  return "code" in error && error.code === "SessionClosed" || isStaleExtensionContextError2(error);
+}
+function isSessionClosedError(error) {
+  let current = error;
+  for (let depth = 0;depth < MAX_CAUSE_DEPTH && current !== undefined; depth++) {
+    try {
+      if (reportsClosedSession(current))
+        return true;
+      current = current.cause instanceof Error ? current.cause : undefined;
+    } catch {
+      return false;
+    }
+  }
+  return false;
+}
+var MAX_CAUSE_DEPTH = 8;
+var init_session_closed_error = () => {};
+
 // dist/builtin/workflows/src/shared/external-run-routes.ts
 function claimExternalRunRoute(store, runId, owner) {
   let owners = registry.owners.get(store);
@@ -58578,7 +58599,10 @@ function registerPendingStageIntercomBridge(pi, activeStore, ownsRun = () => tru
   };
   const announcedRoutes = new Map;
   const routeCompletions = new Map;
-  const disposeReadiness = registerWorkflowPendingStageRouteReadiness(activeStore, (runId) => routeCompletions.get(runId));
+  const disposeReadiness = registerWorkflowPendingStageRouteReadiness(activeStore, (runId) => {
+    announceIfPending();
+    return routeCompletions.get(runId);
+  });
   const announceRoutes = () => {
     if (disposed)
       return;
@@ -58675,11 +58699,53 @@ function registerPendingStageIntercomBridge(pi, activeStore, ownsRun = () => tru
       return;
     }).catch((error) => reportWarning(`atomic-workflows: pending stage delivery sweep failed: ${error.message}`));
   };
-  const unsubscribeStore = activeStore.subscribeInvalidation(announceRoutes);
-  announceRoutes();
+  let announcementPending = false;
+  let announcementTimer;
+  let announcedAt = Number.NEGATIVE_INFINITY;
+  let announcementCost = 0;
+  const announceNow = () => {
+    if (announcementTimer !== undefined)
+      clearTimeout(announcementTimer);
+    announcementTimer = undefined;
+    announcementPending = false;
+    const started = performance.now();
+    announceRoutes();
+    announcedAt = performance.now();
+    announcementCost = announcedAt - started;
+  };
+  function announceIfPending() {
+    if (announcementPending)
+      announceNow();
+  }
+  const announceBatch = () => {
+    try {
+      announceNow();
+    } catch (error) {
+      if (error instanceof Error && isSessionClosedError(error)) {
+        dispose();
+        return;
+      }
+      try {
+        reportWarning(`atomic-workflows: pending stage route announcement failed: ${String(error)}`);
+      } catch {
+        dispose();
+      }
+    }
+  };
+  const scheduleAnnouncement = () => {
+    if (disposed || announcementTimer !== undefined)
+      return;
+    const idle = announcementCost / ROUTE_ANNOUNCEMENT_EVENT_LOOP_SHARE - announcementCost;
+    const wait = Math.max(ROUTE_ANNOUNCEMENT_BATCH_MS, announcedAt + idle - performance.now());
+    announcementPending = true;
+    announcementTimer = setTimeout(announceBatch, wait);
+    announcementTimer.unref?.();
+  };
+  const unsubscribeStore = activeStore.subscribeInvalidation(scheduleAnnouncement);
+  announceNow();
   pi.on?.("session_start", () => {
     announcedRoutes.clear();
-    announceRoutes();
+    announceNow();
   });
   const routePendingStageMessage = (payload) => {
     if (disposed || !isPendingStageMessageEvent(payload) || payload.handled)
@@ -58761,6 +58827,10 @@ function registerPendingStageIntercomBridge(pi, activeStore, ownsRun = () => tru
   });
   const dispose = () => {
     disposed = true;
+    if (announcementTimer !== undefined)
+      clearTimeout(announcementTimer);
+    announcementTimer = undefined;
+    announcementPending = false;
     disposeReadiness();
     disposeRouter();
     routeCompletions.clear();
@@ -58774,10 +58844,11 @@ function registerPendingStageIntercomBridge(pi, activeStore, ownsRun = () => tru
   pi.on?.("session_shutdown", dispose);
   return Object.assign(dispose, {
     async flush() {
+      announceIfPending();
       await Promise.allSettled(routeCompletions.values());
       await sweepPromise;
     },
-    refresh: announceRoutes
+    refresh: announceNow
   });
 }
 function stageRouteTarget(runs, rootRunId, runId, stageId, resolveBoundarySegments = (id) => workflowBoundarySegments(runs, id)) {
@@ -59252,11 +59323,12 @@ async function settleUndeliverablePendingStageMessages(activeStore, notify, owns
   }
   return settled;
 }
-var PENDING_STAGE_ROUTE_EVENT = "atomic:workflow-pending-stage-route", PENDING_STAGE_MESSAGE_EVENT = "atomic:workflow-pending-stage-message", PENDING_STAGE_UNDELIVERABLE_EVENT = "atomic:workflow-pending-stage-undeliverable", STICKY_LIVE_DELIVERED_EVENT = "atomic:workflow-sticky-live-delivered", PENDING_STAGE_ASK_REFUSAL = "Cannot ask a workflow stage whose session has not initialized. Use send; Atomic will queue the message until the stage session initializes.";
+var PENDING_STAGE_ROUTE_EVENT = "atomic:workflow-pending-stage-route", PENDING_STAGE_MESSAGE_EVENT = "atomic:workflow-pending-stage-message", PENDING_STAGE_UNDELIVERABLE_EVENT = "atomic:workflow-pending-stage-undeliverable", STICKY_LIVE_DELIVERED_EVENT = "atomic:workflow-sticky-live-delivered", PENDING_STAGE_ASK_REFUSAL = "Cannot ask a workflow stage whose session has not initialized. Use send; Atomic will queue the message until the stage session initializes.", ROUTE_ANNOUNCEMENT_BATCH_MS = 25, ROUTE_ANNOUNCEMENT_EVENT_LOOP_SHARE = 0.2;
 var init_pending_stage_intercom = __esm(() => {
   init_execution_context_boundary();
   init_run_owner_backend();
   init_store_backend();
+  init_session_closed_error();
   init_external_run_routes();
   init_intercom_group();
   init_pending_stage_route_capability();
@@ -61749,7 +61821,7 @@ function isInfrastructureError(value2) {
 }
 function isRetryableWorkflowError(error) {
   let current = error;
-  for (let depth = 0;depth < MAX_CAUSE_DEPTH && current !== undefined && current !== null; depth++) {
+  for (let depth = 0;depth < MAX_CAUSE_DEPTH2 && current !== undefined && current !== null; depth++) {
     if (isInfrastructureError(current))
       return true;
     current = current instanceof Error ? current.cause : undefined;
@@ -61767,7 +61839,7 @@ function asWorkflowInfrastructureError(error) {
   const code = workflowInfrastructureFault(error.message);
   return code === undefined ? undefined : new WorkflowInfrastructureError(code, error.message, { cause: error });
 }
-var WORKFLOW_INFRASTRUCTURE_ERROR_NAME = "WorkflowInfrastructureError", MAX_CAUSE_DEPTH = 8, FAULT_PATTERNS, WorkflowInfrastructureError;
+var WORKFLOW_INFRASTRUCTURE_ERROR_NAME = "WorkflowInfrastructureError", MAX_CAUSE_DEPTH2 = 8, FAULT_PATTERNS, WorkflowInfrastructureError;
 var init_workflow_infrastructure_error = __esm(() => {
   FAULT_PATTERNS = [
     [/Local worker (?:process )?cleanup (?:was not confirmed|unconfirmed)/, "worker_cleanup_unconfirmed"],
@@ -64956,7 +65028,7 @@ function describeErrorWithCauses(error) {
   const messages = [];
   const visited = new Set;
   let current = error;
-  for (let depth = 0;current !== undefined && depth < MAX_CAUSE_DEPTH2 && !visited.has(current); depth++) {
+  for (let depth = 0;current !== undefined && depth < MAX_CAUSE_DEPTH3 && !visited.has(current); depth++) {
     visited.add(current);
     const message = current instanceof Error ? current.message : String(current);
     if (!messages.includes(message))
@@ -64965,7 +65037,7 @@ function describeErrorWithCauses(error) {
   }
   return messages.join(": ");
 }
-var MAX_CAUSE_DEPTH2 = 5;
+var MAX_CAUSE_DEPTH3 = 5;
 
 // dist/builtin/workflows/src/shared/returned-run-status.ts
 function normalizeReturnedWorkflowStatus(status) {
@@ -66490,7 +66562,7 @@ function recordedOwners(boundary, reason) {
   const pending = [{ value: reason, depth: 0 }];
   while (pending.length > 0) {
     const { value: value2, depth } = pending.pop();
-    if (depth > MAX_CAUSE_DEPTH3)
+    if (depth > MAX_CAUSE_DEPTH4)
       continue;
     if (isPrimitive(value2)) {
       if (depth === 0 || value2 !== undefined && value2 !== null) {
@@ -66812,7 +66884,7 @@ function containUiRejections(ui, scope) {
     custom: (factory, options) => scope.watch(ui.custom(factory, options))
   };
 }
-var EVENT = "unhandledRejection", BOUNDARY_KEY, FLAG = "--unhandled-rejections", MAX_CAUSE_DEPTH3 = 8, MAX_PRIMITIVES_PER_RUN = 64, MAX_STOP_STRINGS = 64, ENDED_RUN_GRACE_MS = 30000, NATIVE_REPORTING_MODES, WATCHED_STAGE_METHODS;
+var EVENT = "unhandledRejection", BOUNDARY_KEY, FLAG = "--unhandled-rejections", MAX_CAUSE_DEPTH4 = 8, MAX_PRIMITIVES_PER_RUN = 64, MAX_STOP_STRINGS = 64, ENDED_RUN_GRACE_MS = 30000, NATIVE_REPORTING_MODES, WATCHED_STAGE_METHODS;
 var init_run_rejection_boundary = __esm(() => {
   init_prompt_callsite();
   init_workflow_source();
@@ -72703,27 +72775,6 @@ var init_runtime = __esm(() => {
   init_intercom_group();
 });
 
-// dist/builtin/workflows/src/engine/session-closed-error.ts
-import { isStaleExtensionContextError as isStaleExtensionContextError2 } from "@bastani/atomic";
-function reportsClosedSession(error) {
-  return "code" in error && error.code === "SessionClosed" || isStaleExtensionContextError2(error);
-}
-function isSessionClosedError(error) {
-  let current = error;
-  for (let depth = 0;depth < MAX_CAUSE_DEPTH4 && current !== undefined; depth++) {
-    try {
-      if (reportsClosedSession(current))
-        return true;
-      current = current.cause instanceof Error ? current.cause : undefined;
-    } catch {
-      return false;
-    }
-  }
-  return false;
-}
-var MAX_CAUSE_DEPTH4 = 8;
-var init_session_closed_error = () => {};
-
 // dist/builtin/workflows/src/engine/workflow-activity.ts
 import { runCallback as runCallback4 } from "@bastani/atomic";
 function nextEventLoopTurn() {

package/dist/builtin/workflows/src/local-worker-entry.mjs

@@ -57401,6 +57401,27 @@ var init_executor = __esm(() => {
   init_executor_run();
 });
 
+// dist/builtin/workflows/src/engine/session-closed-error.ts
+import { isStaleExtensionContextError as isStaleExtensionContextError2 } from "@bastani/atomic";
+function reportsClosedSession(error) {
+  return "code" in error && error.code === "SessionClosed" || isStaleExtensionContextError2(error);
+}
+function isSessionClosedError(error) {
+  let current = error;
+  for (let depth = 0;depth < MAX_CAUSE_DEPTH && current !== undefined; depth++) {
+    try {
+      if (reportsClosedSession(current))
+        return true;
+      current = current.cause instanceof Error ? current.cause : undefined;
+    } catch {
+      return false;
+    }
+  }
+  return false;
+}
+var MAX_CAUSE_DEPTH = 8;
+var init_session_closed_error = () => {};
+
 // dist/builtin/workflows/src/shared/external-run-routes.ts
 function claimExternalRunRoute(store, runId, owner) {
   let owners = registry.owners.get(store);
@@ -57895,7 +57916,10 @@ function registerPendingStageIntercomBridge(pi, activeStore, ownsRun = () => tru
   };
   const announcedRoutes = new Map;
   const routeCompletions = new Map;
-  const disposeReadiness = registerWorkflowPendingStageRouteReadiness(activeStore, (runId) => routeCompletions.get(runId));
+  const disposeReadiness = registerWorkflowPendingStageRouteReadiness(activeStore, (runId) => {
+    announceIfPending();
+    return routeCompletions.get(runId);
+  });
   const announceRoutes = () => {
     if (disposed)
       return;
@@ -57992,11 +58016,53 @@ function registerPendingStageIntercomBridge(pi, activeStore, ownsRun = () => tru
       return;
     }).catch((error) => reportWarning(`atomic-workflows: pending stage delivery sweep failed: ${error.message}`));
   };
-  const unsubscribeStore = activeStore.subscribeInvalidation(announceRoutes);
-  announceRoutes();
+  let announcementPending = false;
+  let announcementTimer;
+  let announcedAt = Number.NEGATIVE_INFINITY;
+  let announcementCost = 0;
+  const announceNow = () => {
+    if (announcementTimer !== undefined)
+      clearTimeout(announcementTimer);
+    announcementTimer = undefined;
+    announcementPending = false;
+    const started = performance.now();
+    announceRoutes();
+    announcedAt = performance.now();
+    announcementCost = announcedAt - started;
+  };
+  function announceIfPending() {
+    if (announcementPending)
+      announceNow();
+  }
+  const announceBatch = () => {
+    try {
+      announceNow();
+    } catch (error) {
+      if (error instanceof Error && isSessionClosedError(error)) {
+        dispose();
+        return;
+      }
+      try {
+        reportWarning(`atomic-workflows: pending stage route announcement failed: ${String(error)}`);
+      } catch {
+        dispose();
+      }
+    }
+  };
+  const scheduleAnnouncement = () => {
+    if (disposed || announcementTimer !== undefined)
+      return;
+    const idle = announcementCost / ROUTE_ANNOUNCEMENT_EVENT_LOOP_SHARE - announcementCost;
+    const wait = Math.max(ROUTE_ANNOUNCEMENT_BATCH_MS, announcedAt + idle - performance.now());
+    announcementPending = true;
+    announcementTimer = setTimeout(announceBatch, wait);
+    announcementTimer.unref?.();
+  };
+  const unsubscribeStore = activeStore.subscribeInvalidation(scheduleAnnouncement);
+  announceNow();
   pi.on?.("session_start", () => {
     announcedRoutes.clear();
-    announceRoutes();
+    announceNow();
   });
   const routePendingStageMessage = (payload) => {
     if (disposed || !isPendingStageMessageEvent(payload) || payload.handled)
@@ -58078,6 +58144,10 @@ function registerPendingStageIntercomBridge(pi, activeStore, ownsRun = () => tru
   });
   const dispose = () => {
     disposed = true;
+    if (announcementTimer !== undefined)
+      clearTimeout(announcementTimer);
+    announcementTimer = undefined;
+    announcementPending = false;
     disposeReadiness();
     disposeRouter();
     routeCompletions.clear();
@@ -58091,10 +58161,11 @@ function registerPendingStageIntercomBridge(pi, activeStore, ownsRun = () => tru
   pi.on?.("session_shutdown", dispose);
   return Object.assign(dispose, {
     async flush() {
+      announceIfPending();
       await Promise.allSettled(routeCompletions.values());
       await sweepPromise;
     },
-    refresh: announceRoutes
+    refresh: announceNow
   });
 }
 function stageRouteTarget(runs, rootRunId, runId, stageId, resolveBoundarySegments = (id) => workflowBoundarySegments(runs, id)) {
@@ -58569,11 +58640,12 @@ async function settleUndeliverablePendingStageMessages(activeStore, notify, owns
   }
   return settled;
 }
-var PENDING_STAGE_ROUTE_EVENT = "atomic:workflow-pending-stage-route", PENDING_STAGE_MESSAGE_EVENT = "atomic:workflow-pending-stage-message", PENDING_STAGE_UNDELIVERABLE_EVENT = "atomic:workflow-pending-stage-undeliverable", STICKY_LIVE_DELIVERED_EVENT = "atomic:workflow-sticky-live-delivered", PENDING_STAGE_ASK_REFUSAL = "Cannot ask a workflow stage whose session has not initialized. Use send; Atomic will queue the message until the stage session initializes.";
+var PENDING_STAGE_ROUTE_EVENT = "atomic:workflow-pending-stage-route", PENDING_STAGE_MESSAGE_EVENT = "atomic:workflow-pending-stage-message", PENDING_STAGE_UNDELIVERABLE_EVENT = "atomic:workflow-pending-stage-undeliverable", STICKY_LIVE_DELIVERED_EVENT = "atomic:workflow-sticky-live-delivered", PENDING_STAGE_ASK_REFUSAL = "Cannot ask a workflow stage whose session has not initialized. Use send; Atomic will queue the message until the stage session initializes.", ROUTE_ANNOUNCEMENT_BATCH_MS = 25, ROUTE_ANNOUNCEMENT_EVENT_LOOP_SHARE = 0.2;
 var init_pending_stage_intercom = __esm(() => {
   init_execution_context_boundary();
   init_run_owner_backend();
   init_store_backend();
+  init_session_closed_error();
   init_external_run_routes();
   init_intercom_group();
   init_pending_stage_route_capability();
@@ -61130,7 +61202,7 @@ function isInfrastructureError(value2) {
 }
 function isRetryableWorkflowError(error) {
   let current = error;
-  for (let depth = 0;depth < MAX_CAUSE_DEPTH && current !== undefined && current !== null; depth++) {
+  for (let depth = 0;depth < MAX_CAUSE_DEPTH2 && current !== undefined && current !== null; depth++) {
     if (isInfrastructureError(current))
       return true;
     current = current instanceof Error ? current.cause : undefined;
@@ -61148,7 +61220,7 @@ function asWorkflowInfrastructureError(error) {
   const code = workflowInfrastructureFault(error.message);
   return code === undefined ? undefined : new WorkflowInfrastructureError(code, error.message, { cause: error });
 }
-var WORKFLOW_INFRASTRUCTURE_ERROR_NAME = "WorkflowInfrastructureError", MAX_CAUSE_DEPTH = 8, FAULT_PATTERNS, WorkflowInfrastructureError;
+var WORKFLOW_INFRASTRUCTURE_ERROR_NAME = "WorkflowInfrastructureError", MAX_CAUSE_DEPTH2 = 8, FAULT_PATTERNS, WorkflowInfrastructureError;
 var init_workflow_infrastructure_error = __esm(() => {
   FAULT_PATTERNS = [
     [/Local worker (?:process )?cleanup (?:was not confirmed|unconfirmed)/, "worker_cleanup_unconfirmed"],
@@ -65169,7 +65241,7 @@ function describeErrorWithCauses(error) {
   const messages = [];
   const visited = new Set;
   let current = error;
-  for (let depth = 0;current !== undefined && depth < MAX_CAUSE_DEPTH2 && !visited.has(current); depth++) {
+  for (let depth = 0;current !== undefined && depth < MAX_CAUSE_DEPTH3 && !visited.has(current); depth++) {
     visited.add(current);
     const message = current instanceof Error ? current.message : String(current);
     if (!messages.includes(message))
@@ -65178,7 +65250,7 @@ function describeErrorWithCauses(error) {
   }
   return messages.join(": ");
 }
-var MAX_CAUSE_DEPTH2 = 5;
+var MAX_CAUSE_DEPTH3 = 5;
 
 // dist/builtin/workflows/src/shared/returned-run-status.ts
 function normalizeReturnedWorkflowStatus(status) {
@@ -66703,7 +66775,7 @@ function recordedOwners(boundary, reason) {
   const pending = [{ value: reason, depth: 0 }];
   while (pending.length > 0) {
     const { value: value2, depth } = pending.pop();
-    if (depth > MAX_CAUSE_DEPTH3)
+    if (depth > MAX_CAUSE_DEPTH4)
       continue;
     if (isPrimitive(value2)) {
       if (depth === 0 || value2 !== undefined && value2 !== null) {
@@ -67025,7 +67097,7 @@ function containUiRejections(ui, scope) {
     custom: (factory, options) => scope.watch(ui.custom(factory, options))
   };
 }
-var EVENT = "unhandledRejection", BOUNDARY_KEY, FLAG = "--unhandled-rejections", MAX_CAUSE_DEPTH3 = 8, MAX_PRIMITIVES_PER_RUN = 64, MAX_STOP_STRINGS = 64, ENDED_RUN_GRACE_MS = 30000, NATIVE_REPORTING_MODES, WATCHED_STAGE_METHODS;
+var EVENT = "unhandledRejection", BOUNDARY_KEY, FLAG = "--unhandled-rejections", MAX_CAUSE_DEPTH4 = 8, MAX_PRIMITIVES_PER_RUN = 64, MAX_STOP_STRINGS = 64, ENDED_RUN_GRACE_MS = 30000, NATIVE_REPORTING_MODES, WATCHED_STAGE_METHODS;
 var init_run_rejection_boundary = __esm(() => {
   init_prompt_callsite();
   init_workflow_source();
@@ -72916,27 +72988,6 @@ var init_runtime = __esm(() => {
   init_intercom_group();
 });
 
-// dist/builtin/workflows/src/engine/session-closed-error.ts
-import { isStaleExtensionContextError as isStaleExtensionContextError2 } from "@bastani/atomic";
-function reportsClosedSession(error) {
-  return "code" in error && error.code === "SessionClosed" || isStaleExtensionContextError2(error);
-}
-function isSessionClosedError(error) {
-  let current = error;
-  for (let depth = 0;depth < MAX_CAUSE_DEPTH4 && current !== undefined; depth++) {
-    try {
-      if (reportsClosedSession(current))
-        return true;
-      current = current.cause instanceof Error ? current.cause : undefined;
-    } catch {
-      return false;
-    }
-  }
-  return false;
-}
-var MAX_CAUSE_DEPTH4 = 8;
-var init_session_closed_error = () => {};
-
 // dist/builtin/workflows/src/engine/workflow-activity.ts
 import { runCallback as runCallback4 } from "@bastani/atomic";
 function nextEventLoopTurn() {

package/dist/core/storage/errors.d.ts

@@ -8,7 +8,11 @@ export declare class StorageUnavailableError extends StorageError {
     readonly adapter: string;
     readonly location: string;
     readonly cause: StorageFailureCause;
-    constructor(descriptor: StorageDescriptor, cause: StorageFailureCause);
+    /**
+     * `detail` names the driver failure in the message: a worker or coordinator that relays only `message` across
+     * a process boundary keeps the reason. Adapters pass it only for causes that cannot carry credentials.
+     */
+    constructor(descriptor: StorageDescriptor, cause: StorageFailureCause, detail?: string);
 }
 export declare class StoreClosedError extends StorageError {
     readonly adapter: string;

package/dist/core/storage/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/storage/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEpE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtF,qBAAa,YAAa,SAAQ,KAAK;IACtC,SAAiB,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACpD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACD;AAED,qBAAa,uBAAwB,SAAQ,YAAY;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,SAAiB,KAAK,EAAE,mBAAmB,CAAC;IAC5C,YAAY,UAAU,EAAE,iBAAiB,EAAE,KAAK,EAAE,mBAAmB,EAIpE;CACD;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,YAAY,UAAU,EAAE,iBAAiB,EAIxC;CACD;AAED,qBAAa,6BAA8B,SAAQ,YAAY;IAC9D,cAEC;CACD;AAED,qBAAa,oBAAqB,SAAQ,YAAY;IACrD,SAAiB,KAAK,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,YAAY,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,mBAAmB,EAGzE;CACD;AAED,qBAAa,uBAAwB,SAAQ,YAAY;IACxD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,mBAAmB;IAClC,YAAY,cAAc,EAAE,MAAM,EAGjC;CACD;AAED,qBAAa,yBAA0B,SAAQ,YAAY;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,YAAY,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAKhE;CACD;AAED,qBAAa,kBAAmB,SAAQ,YAAY;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;IACxC,YAAY,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,UAAU,EAIzD;CACD;AAED,qBAAa,kBAAmB,SAAQ,YAAY;IACnD,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,YAAY,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAKpF;CACD;AAED,qBAAa,uBAAwB,SAAQ,YAAY;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,SAAiB,KAAK,EAAE,mBAAmB,CAAC;IAC5C,YAAY,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAGrD;CACD;AAED,qBAAa,0BAA2B,SAAQ,YAAY;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,YAAY,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAKlD;CACD;AAED,qBAAa,2BAA4B,SAAQ,YAAY;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,YAAY,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAIlD;CACD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/storage/errors.ts"],"names":[],"mappings":"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"}

package/dist/core/storage/errors.js

@@ -7,8 +7,14 @@ export class StorageError extends Error {
 export class StorageUnavailableError extends StorageError {
     adapter;
     location;
-    constructor(descriptor, cause) {
-        super(`Storage unavailable: ${descriptor.adapter} at ${descriptor.location}`, { cause });
+    /**
+     * `detail` names the driver failure in the message: a worker or coordinator that relays only `message` across
+     * a process boundary keeps the reason. Adapters pass it only for causes that cannot carry credentials.
+     */
+    constructor(descriptor, cause, detail) {
+        super(`Storage unavailable: ${descriptor.adapter} at ${descriptor.location}${detail ? `: ${detail}` : ""}`, {
+            cause,
+        });
         this.adapter = descriptor.adapter;
         this.location = descriptor.location;
     }

package/dist/core/storage/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/storage/errors.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SqliteValue, StorageDescriptor } from \"./database.js\";\n\nexport type StorageFailureCause = object | SqliteValue | boolean | symbol | undefined;\n\nexport class StorageError extends Error {\n\tdeclare readonly cleanupCause?: StorageFailureCause;\n\tconstructor(message: string, options?: ErrorOptions) {\n\t\tsuper(message, options);\n\t\tthis.name = new.target.name;\n\t}\n}\n\nexport class StorageUnavailableError extends StorageError {\n\treadonly adapter: string;\n\treadonly location: string;\n\tdeclare readonly cause: StorageFailureCause;\n\tconstructor(descriptor: StorageDescriptor, cause: StorageFailureCause) {\n\t\tsuper(`Storage unavailable: ${descriptor.adapter} at ${descriptor.location}`, { cause });\n\t\tthis.adapter = descriptor.adapter;\n\t\tthis.location = descriptor.location;\n\t}\n}\n\nexport class StoreClosedError extends StorageError {\n\treadonly adapter: string;\n\treadonly location: string;\n\tconstructor(descriptor: StorageDescriptor) {\n\t\tsuper(`Storage closed: ${descriptor.adapter} at ${descriptor.location}`);\n\t\tthis.adapter = descriptor.adapter;\n\t\tthis.location = descriptor.location;\n\t}\n}\n\nexport class StorageTransactionClosedError extends StorageError {\n\tconstructor() {\n\t\tsuper(\"Storage transaction is closed\");\n\t}\n}\n\nexport class StorageRollbackError extends StorageError {\n\tdeclare readonly cause: StorageFailureCause;\n\treadonly rollbackCause: StorageFailureCause;\n\tconstructor(cause: StorageFailureCause, rollbackCause: StorageFailureCause) {\n\t\tsuper(\"Storage rollback failed\", { cause });\n\t\tthis.rollbackCause = rollbackCause;\n\t}\n}\n\nexport class StorageInvalidTextError extends StorageError {\n\treadonly parameterIndex: number;\n\treadonly reason = \"nul-character\";\n\tconstructor(parameterIndex: number) {\n\t\tsuper(`Storage parameter ${parameterIndex} contains a NUL character`);\n\t\tthis.parameterIndex = parameterIndex;\n\t}\n}\n\nexport class StorageSchemaVersionError extends StorageError {\n\treadonly domain: string;\n\treadonly found: SqliteValue;\n\treadonly supported: number;\n\tconstructor(domain: string, found: SqliteValue, supported: number) {\n\t\tsuper(`Unsupported ${domain} storage schema version`);\n\t\tthis.domain = domain;\n\t\tthis.found = found;\n\t\tthis.supported = supported;\n\t}\n}\n\nexport class StoragePrefixError extends StorageError {\n\treadonly prefix: string;\n\treadonly reason: \"pattern\" | \"reserved\";\n\tconstructor(prefix: string, reason: \"pattern\" | \"reserved\") {\n\t\tsuper(`Invalid storage prefix: ${reason}`);\n\t\tthis.prefix = prefix;\n\t\tthis.reason = reason;\n\t}\n}\n\nexport class StorageConfigError extends StorageError {\n\treadonly source: \"sdk\" | \"cli\" | \"env\" | \"settings\";\n\treadonly field: string;\n\treadonly reason: string;\n\tconstructor(source: \"sdk\" | \"cli\" | \"env\" | \"settings\", field: string, reason: string) {\n\t\tsuper(`Invalid storage configuration: ${field} (${reason})`);\n\t\tthis.source = source;\n\t\tthis.field = field;\n\t\tthis.reason = reason;\n\t}\n}\n\nexport class StorageAdapterLoadError extends StorageError {\n\treadonly module: string;\n\tdeclare readonly cause: StorageFailureCause;\n\tconstructor(module: string, cause: StorageFailureCause) {\n\t\tsuper(`Could not load storage adapter: ${module}`, { cause });\n\t\tthis.module = module;\n\t}\n}\n\nexport class StorageOutcomeUnknownError extends StorageError {\n\treadonly domain: string;\n\treadonly id: string;\n\treadonly key: string;\n\tconstructor(domain: string, id: string, key: string) {\n\t\tsuper(`Storage write outcome unknown: ${domain} ${id}`);\n\t\tthis.domain = domain;\n\t\tthis.id = id;\n\t\tthis.key = key;\n\t}\n}\n\nexport class StoragePayloadTooLargeError extends StorageError {\n\treadonly limitBytes: number;\n\treadonly actualBytes: number;\n\tconstructor(limitBytes: number, actualBytes: number) {\n\t\tsuper(\"Storage payload exceeds the backend limit\");\n\t\tthis.limitBytes = limitBytes;\n\t\tthis.actualBytes = actualBytes;\n\t}\n}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/storage/errors.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SqliteValue, StorageDescriptor } from \"./database.js\";\n\nexport type StorageFailureCause = object | SqliteValue | boolean | symbol | undefined;\n\nexport class StorageError extends Error {\n\tdeclare readonly cleanupCause?: StorageFailureCause;\n\tconstructor(message: string, options?: ErrorOptions) {\n\t\tsuper(message, options);\n\t\tthis.name = new.target.name;\n\t}\n}\n\nexport class StorageUnavailableError extends StorageError {\n\treadonly adapter: string;\n\treadonly location: string;\n\tdeclare readonly cause: StorageFailureCause;\n\t/**\n\t * `detail` names the driver failure in the message: a worker or coordinator that relays only `message` across\n\t * a process boundary keeps the reason. Adapters pass it only for causes that cannot carry credentials.\n\t */\n\tconstructor(descriptor: StorageDescriptor, cause: StorageFailureCause, detail?: string) {\n\t\tsuper(`Storage unavailable: ${descriptor.adapter} at ${descriptor.location}${detail ? `: ${detail}` : \"\"}`, {\n\t\t\tcause,\n\t\t});\n\t\tthis.adapter = descriptor.adapter;\n\t\tthis.location = descriptor.location;\n\t}\n}\n\nexport class StoreClosedError extends StorageError {\n\treadonly adapter: string;\n\treadonly location: string;\n\tconstructor(descriptor: StorageDescriptor) {\n\t\tsuper(`Storage closed: ${descriptor.adapter} at ${descriptor.location}`);\n\t\tthis.adapter = descriptor.adapter;\n\t\tthis.location = descriptor.location;\n\t}\n}\n\nexport class StorageTransactionClosedError extends StorageError {\n\tconstructor() {\n\t\tsuper(\"Storage transaction is closed\");\n\t}\n}\n\nexport class StorageRollbackError extends StorageError {\n\tdeclare readonly cause: StorageFailureCause;\n\treadonly rollbackCause: StorageFailureCause;\n\tconstructor(cause: StorageFailureCause, rollbackCause: StorageFailureCause) {\n\t\tsuper(\"Storage rollback failed\", { cause });\n\t\tthis.rollbackCause = rollbackCause;\n\t}\n}\n\nexport class StorageInvalidTextError extends StorageError {\n\treadonly parameterIndex: number;\n\treadonly reason = \"nul-character\";\n\tconstructor(parameterIndex: number) {\n\t\tsuper(`Storage parameter ${parameterIndex} contains a NUL character`);\n\t\tthis.parameterIndex = parameterIndex;\n\t}\n}\n\nexport class StorageSchemaVersionError extends StorageError {\n\treadonly domain: string;\n\treadonly found: SqliteValue;\n\treadonly supported: number;\n\tconstructor(domain: string, found: SqliteValue, supported: number) {\n\t\tsuper(`Unsupported ${domain} storage schema version`);\n\t\tthis.domain = domain;\n\t\tthis.found = found;\n\t\tthis.supported = supported;\n\t}\n}\n\nexport class StoragePrefixError extends StorageError {\n\treadonly prefix: string;\n\treadonly reason: \"pattern\" | \"reserved\";\n\tconstructor(prefix: string, reason: \"pattern\" | \"reserved\") {\n\t\tsuper(`Invalid storage prefix: ${reason}`);\n\t\tthis.prefix = prefix;\n\t\tthis.reason = reason;\n\t}\n}\n\nexport class StorageConfigError extends StorageError {\n\treadonly source: \"sdk\" | \"cli\" | \"env\" | \"settings\";\n\treadonly field: string;\n\treadonly reason: string;\n\tconstructor(source: \"sdk\" | \"cli\" | \"env\" | \"settings\", field: string, reason: string) {\n\t\tsuper(`Invalid storage configuration: ${field} (${reason})`);\n\t\tthis.source = source;\n\t\tthis.field = field;\n\t\tthis.reason = reason;\n\t}\n}\n\nexport class StorageAdapterLoadError extends StorageError {\n\treadonly module: string;\n\tdeclare readonly cause: StorageFailureCause;\n\tconstructor(module: string, cause: StorageFailureCause) {\n\t\tsuper(`Could not load storage adapter: ${module}`, { cause });\n\t\tthis.module = module;\n\t}\n}\n\nexport class StorageOutcomeUnknownError extends StorageError {\n\treadonly domain: string;\n\treadonly id: string;\n\treadonly key: string;\n\tconstructor(domain: string, id: string, key: string) {\n\t\tsuper(`Storage write outcome unknown: ${domain} ${id}`);\n\t\tthis.domain = domain;\n\t\tthis.id = id;\n\t\tthis.key = key;\n\t}\n}\n\nexport class StoragePayloadTooLargeError extends StorageError {\n\treadonly limitBytes: number;\n\treadonly actualBytes: number;\n\tconstructor(limitBytes: number, actualBytes: number) {\n\t\tsuper(\"Storage payload exceeds the backend limit\");\n\t\tthis.limitBytes = limitBytes;\n\t\tthis.actualBytes = actualBytes;\n\t}\n}\n"]}

package/dist/core/storage/node-sqlite.d.ts

@@ -1,7 +1,8 @@
 import type { DatabaseSync } from "node:sqlite";
 import type { SqliteDatabase } from "./database.js";
-export declare function openNodeSqliteDatabase(path: string, { busyTimeoutMs, readOnly }?: {
+export declare function openNodeSqliteDatabase(path: string, { busyTimeoutMs, lockWaitMs, readOnly, }?: {
     busyTimeoutMs?: number;
+    lockWaitMs?: number;
     readOnly?: boolean;
 }): Promise<SqliteDatabase>;
 export declare function wrapNodeSqliteDatabase(connection: DatabaseSync): SqliteDatabase;

package/dist/core/storage/node-sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-sqlite.d.ts","sourceRoot":"","sources":["../../../src/core/storage/node-sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAA6D,MAAM,eAAe,CAAC;AAuM/G,wBAAsB,sBAAsB,CAC3C,IAAI,EAAE,MAAM,EACZ,EAAE,aAAoB,EAAE,QAAgB,EAAE,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7F,OAAO,CAAC,cAAc,CAAC,CA2BzB;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,YAAY,GAAG,cAAc,CAW/E"}
+{"version":3,"file":"node-sqlite.d.ts","sourceRoot":"","sources":["../../../src/core/storage/node-sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAA6D,MAAM,eAAe,CAAC;AA0R/G,wBAAsB,sBAAsB,CAC3C,IAAI,EAAE,MAAM,EACZ,EACC,aAAoB,EACpB,UAA6C,EAC7C,QAAgB,GAChB,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACzE,OAAO,CAAC,cAAc,CAAC,CA2BzB;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,YAAY,GAAG,cAAc,CAW/E"}