@lostgradient/weft 0.16.0 → 0.18.0

package/README.md

@@ -1,6 +1,6 @@
 # Weft
 
-A Bun-native durable execution engine. Current release: `0.16.0`.
+A Bun-native durable execution engine. Current release: `0.18.0`.
 
 Install the library from npm as `@lostgradient/weft`:
 

package/dist/alerting/alert-manager.d.ts

@@ -5,7 +5,7 @@
  *
  * @module alerting/alert-manager
  */
-import type { AlertState, AlertingOptions } from './types';
+import type { AlertStateSnapshot, AlertingOptions } from './types';
 /**
  * Event-driven alert manager that evaluates metric-based rules against sliding
  * time windows and fires `alert:fired` / `alert:resolved` lifecycle events.
@@ -38,9 +38,9 @@ export declare class AlertManager implements Disposable {
     constructor(target: EventTarget, options: AlertingOptions, getNow?: () => number, startBackgroundTick?: boolean);
     /** Re-evaluate every rule once, for hosts that drive maintenance explicitly. */
     tick(): void;
-    /** Get current state of all alert rules (for debugging/testing). */
-    get states(): readonly AlertState[];
-    /** Get the alert rules that are currently firing. */
-    get activeStates(): readonly AlertState[];
+    /** Get a detached snapshot of all alert rules (for debugging/testing). */
+    get states(): readonly AlertStateSnapshot[];
+    /** Get detached snapshots of the alert rules that are currently firing. */
+    get activeStates(): readonly AlertStateSnapshot[];
     [Symbol.dispose](): void;
 }

package/dist/alerting/alert-manager.js

@@ -7,6 +7,15 @@ import {
 import { parseDuration } from "../core/scheduler.js";
 import { CounterWindow, HistogramWindow } from "./sliding-window.js";
 const TICK_INTERVAL_MS = 1e4;
+function snapshotAlertState(state) {
+  return {
+    rule: { ...state.rule },
+    status: state.status,
+    currentValue: state.currentValue,
+    ...state.lastFiredAt === void 0 ? {} : { lastFiredAt: state.lastFiredAt },
+    ...state.lastResolvedAt === void 0 ? {} : { lastResolvedAt: state.lastResolvedAt }
+  };
+}
 
 export class AlertManager {
   #target;
@@ -20,21 +29,30 @@ export class AlertManager {
   #tickInterval;
   constructor(target, options, getNow = Date.now, startBackgroundTick = !0) {
     this.#target = target;
-    this.#options = options;
+    this.#options = {
+      ...options,
+      rules: options.rules.map((rule) => ({ ...rule })),
+      ...options.webhooks === void 0 ? {} : {
+        webhooks: options.webhooks.map((webhook) => ({
+          ...webhook,
+          events: [...webhook.events]
+        }))
+      }
+    };
     this.#getNow = getNow;
     this.#latestStorageSize = 0;
     this.#pendingWebhooks = new Set;
     this.#listeners = [];
     this.#states = [];
-    for (const rule of options.rules)
+    for (const rule of this.#options.rules)
       this.#states.push({
         rule,
         status: "idle",
         currentValue: 0
       });
     this.#windows = new Map;
-    for (let i = 0;i < options.rules.length; i++) {
-      const rule = options.rules[i], windowMs = rule.window ? parseDuration(rule.window) : 60000;
+    for (let i = 0;i < this.#options.rules.length; i++) {
+      const rule = this.#options.rules[i], windowMs = rule.window ? parseDuration(rule.window) : 60000;
       if (rule.metric === "workflow.failure_rate")
         this.#windows.set(i, new CounterWindow(windowMs));
       else if (rule.metric === "activity.p99_duration")
@@ -153,10 +171,10 @@ export class AlertManager {
     }
   }
   get states() {
-    return this.#states;
+    return this.#states.map(snapshotAlertState);
   }
   get activeStates() {
-    return this.#states.filter((state) => state.status === "firing");
+    return this.#states.filter((state) => state.status === "firing").map(snapshotAlertState);
   }
   [Symbol.dispose]() {
     if (this.#tickInterval !== null) {

package/dist/alerting/index.d.ts

@@ -1,2 +1,2 @@
 export { AlertManager } from './alert-manager';
-export type { AlertAction, AlertMetric, AlertRule, AlertState, AlertStatus, AlertingOptions, WebhookTarget, } from './types';
+export type { AlertAction, AlertMetric, AlertRule, AlertStateSnapshot, AlertStatus, AlertingOptions, WebhookTarget, } from './types';

package/dist/alerting/types.d.ts

@@ -6,6 +6,8 @@
  * {@link WebhookTarget} URLs.
  */
 export type AlertAction = 'log' | 'webhook';
+/** Runtime vocabulary shared by alerting types and operation schemas. */
+export declare const ALERT_METRICS: readonly ["workflow.failure_rate", "activity.p99_duration", "storage.size"];
 /**
  * Which built-in metric an {@link AlertRule} monitors.
  *
@@ -30,7 +32,7 @@ export type AlertAction = 'log' | 'webhook';
  * void rule;
  * ```
  */
-export type AlertMetric = 'workflow.failure_rate' | 'activity.p99_duration' | 'storage.size';
+export type AlertMetric = (typeof ALERT_METRICS)[number];
 /**
  * Defines a single alerting threshold applied to a named metric.
  *
@@ -124,7 +126,8 @@ export type AlertingOptions = {
  *
  * Transitions from `'idle'` to `'firing'` when the metric exceeds the
  * threshold and back to `'idle'` once the metric drops below it again.
- * Read this off an {@link AlertState} object to see the current state of a rule.
+ * Read this off an {@link AlertStateSnapshot} object to see the current state
+ * of a rule.
  *
  * @example
  * ```ts
@@ -141,17 +144,18 @@ export type AlertingOptions = {
  */
 export type AlertStatus = 'idle' | 'firing';
 /**
- * Runtime tracking state for a single {@link AlertRule} managed by
- * {@link AlertManager}.
+ * Detached, deeply read-only observation of a single alert rule's runtime
+ * state. The manager returns a fresh snapshot for every getter call, so
+ * changing it cannot affect alert evaluation.
  *
- * Users observe this shape via `AlertManager.states` to see the current
- * metric value, firing status, and timestamps of the last transition.  It is
- * created and owned by the manager — callers do not construct it directly.
+ * Users observe this shape via `AlertManager.states` or
+ * `Engine.getActiveAlerts()` to see the current metric value, firing status,
+ * and timestamps of the last transition.
  */
-export type AlertState = {
-    rule: AlertRule;
-    status: AlertStatus;
-    currentValue: number;
-    lastFiredAt?: number;
-    lastResolvedAt?: number;
+export type AlertStateSnapshot = {
+    readonly rule: Readonly<AlertRule>;
+    readonly status: AlertStatus;
+    readonly currentValue: number;
+    readonly lastFiredAt?: number;
+    readonly lastResolvedAt?: number;
 };

package/dist/alerting/types.js

@@ -0,0 +1,5 @@
+export const ALERT_METRICS = [
+  "workflow.failure_rate",
+  "activity.p99_duration",
+  "storage.size"
+];

package/dist/cli/generated/operation-catalog.snapshot.json

@@ -1403,6 +1403,79 @@
       },
       "outputSchema": {}
     },
+    {
+      "name": "weft.system.principal",
+      "kind": "unary",
+      "summary": "Report the caller's resolved principal and granted scopes",
+      "description": "Report the caller's own resolved principal: the authentication method ('jwt', 'api-key', 'mtls', 'stdio-local', or 'unauthenticated'), the normalized subject when one exists, and the granted authorization scopes, sorted. Public access: an unauthenticated caller receives method 'unauthenticated' with an empty scope list rather than an error, so clients can distinguish \"no credential\" from \"credential with few scopes\" without probing other operations. Reflects only the request credential — never server auth configuration.",
+      "tags": ["System"],
+      "destructive": false,
+      "access": {
+        "kind": "public"
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": [],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {},
+        "type": "object"
+      },
+      "outputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "method": {
+            "enum": ["jwt", "api-key", "mtls", "stdio-local", "unauthenticated"],
+            "type": "string"
+          },
+          "scopes": {
+            "items": {
+              "enum": [
+                "workflows:read",
+                "workflows:write",
+                "workflows:admin",
+                "schedules:read",
+                "schedules:write",
+                "signals:write",
+                "updates:write",
+                "queries:read",
+                "reviews:read",
+                "reviews:write",
+                "attributes:read",
+                "attributes:write",
+                "tags:write",
+                "streams:read",
+                "events:read",
+                "storage:read",
+                "storage:write",
+                "storage:admin",
+                "workers:write",
+                "system:read",
+                "system:admin"
+              ],
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "subject": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": ["method", "subject", "scopes"],
+        "type": "object"
+      }
+    },
     {
       "name": "weft.system.registry",
       "kind": "unary",

package/dist/cli/generated/operation-client.generated.d.ts

@@ -1,7 +1,7 @@
 import { type CatalogWeftClient, type WeftClientConnection } from '../operation-client-runtime.ts';
-export declare const CATALOG_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
+export declare const CATALOG_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.principal", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
 export type CatalogOperationName = (typeof CATALOG_OPERATION_NAMES)[number];
-export declare const CLIENT_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.tasks.diagnostics.deadletters.clear", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
+export declare const CLIENT_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.principal", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.tasks.diagnostics.deadletters.clear", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
 export type ClientOperationName = (typeof CLIENT_OPERATION_NAMES)[number];
 export declare const CLIENT_REST_OPERATION_BINDINGS: {
     readonly 'weft.tasks.diagnostics.deadletters.clear': {
@@ -251,6 +251,15 @@ export type ClientOperationTypes = {
         readonly output: unknown;
         readonly faults: never;
     };
+    'weft.system.principal': {
+        readonly input: {};
+        readonly output: {
+            readonly method: 'jwt' | 'api-key' | 'mtls' | 'stdio-local' | 'unauthenticated';
+            readonly scopes: ReadonlyArray<'workflows:read' | 'workflows:write' | 'workflows:admin' | 'schedules:read' | 'schedules:write' | 'signals:write' | 'updates:write' | 'queries:read' | 'reviews:read' | 'reviews:write' | 'attributes:read' | 'attributes:write' | 'tags:write' | 'streams:read' | 'events:read' | 'storage:read' | 'storage:write' | 'storage:admin' | 'workers:write' | 'system:read' | 'system:admin'>;
+            readonly subject: unknown;
+        };
+        readonly faults: never;
+    };
     'weft.system.registry': {
         readonly input: {};
         readonly output: {

package/dist/cli/generated/operation-client.generated.js

@@ -21,6 +21,7 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.storage.capabilities",
   "weft.system.lease",
   "weft.system.metrics",
+  "weft.system.principal",
   "weft.system.registry",
   "weft.task.queues.list",
   "weft.tasks.diagnostics",
@@ -82,6 +83,7 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.storage.capabilities",
   "weft.system.lease",
   "weft.system.metrics",
+  "weft.system.principal",
   "weft.system.registry",
   "weft.task.queues.list",
   "weft.tasks.diagnostics",

package/dist/core/engine/disposal.js

@@ -2,6 +2,12 @@ import { disposeEngineCleanupInterval } from "./engine-runtime-helpers.js";
 import { EngineDisposedError } from "./errors.js";
 import { disposeQueuedInlineWorkflowStarts } from "./inline-launch-queue.js";
 import { rejectAllSleepTimerAcknowledgements } from "./sleep-timer-acknowledgements.js";
+function settleSleepResolverReadyWaitersForTesting(internals) {
+  for (const waiters of internals.sleepResolverReadyWaitersForTesting?.values() ?? [])
+    for (const notifyReady of waiters)
+      notifyReady();
+  internals.sleepResolverReadyWaitersForTesting?.clear();
+}
 export function disposeEngine(internals) {
   internals.disposed = !0;
   internals.alertManager?.[Symbol.dispose]();
@@ -48,6 +54,7 @@ export function disposeEngine(internals) {
   internals.pendingWebhooks.clear();
   internals.sleepResolvers.clear();
   internals.sleepResolversByWorkflow.clear();
+  settleSleepResolverReadyWaitersForTesting(internals);
   internals.sleepTimerAcknowledgementWaiters.clear();
   internals.durableInlineOperations.clear();
   internals.sleepTimersFiredWithoutResolver.clear();

package/dist/core/engine/engine-runtime-helpers.d.ts

@@ -19,7 +19,9 @@ export declare function createQueuedInlineWorkflowStartHandler<TWorkflows extend
  * `[Symbol.asyncDispose]` ahead of synchronous disposal (which aborts the signal
  * and would otherwise discard the queue).
  */
-export declare function drainQueuedInlineWorkflowStartsForEngine<TWorkflows extends object, TActivities extends object>(engine: Engine<TWorkflows, TActivities>): Promise<void>;
+export declare function drainQueuedInlineWorkflowStartsForEngine<TWorkflows extends object, TActivities extends object>(engine: Engine<TWorkflows, TActivities>, options?: {
+    abortStartedWorkflows?: boolean;
+}): Promise<void>;
 export declare function createCleanupIntervalTick<TWorkflows extends object, TActivities extends object>(weakEngine: WeakRef<Engine<TWorkflows, TActivities>>, tracker: EngineCleanupIntervalDisposalTracker): () => void;
 /**
  * Build the resolver the second-instance detection interval uses to find its live

package/dist/core/engine/engine-runtime-helpers.js

@@ -40,8 +40,8 @@ export function createQueuedInlineWorkflowStartHandler(weakEngine, channel) {
     swallowPromiseRejection(flushQueuedInlineWorkflowStarts(getInternals(engine), inlineLaunchQueueCallbacksForEngine(engine)));
   };
 }
-export async function drainQueuedInlineWorkflowStartsForEngine(engine) {
-  await drainQueuedInlineWorkflowStarts(getInternals(engine), inlineLaunchQueueCallbacksForEngine(engine));
+export async function drainQueuedInlineWorkflowStartsForEngine(engine, options) {
+  await drainQueuedInlineWorkflowStarts(getInternals(engine), inlineLaunchQueueCallbacksForEngine(engine), options);
 }
 export function createCleanupIntervalTick(weakEngine, tracker) {
   return function cleanupExpiredResponsesForLiveEngine() {

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

@@ -163,6 +163,26 @@ export declare class EngineCreateNameMismatchError extends WeftError<'EngineCrea
 export declare class EngineDisposedError extends WeftError<'EngineDisposedError'> {
     constructor();
 }
+/**
+ * Thrown when queued inline workflow draining fails during asynchronous engine
+ * disposal. The engine is still fully torn down, and `leaseReleased` reports
+ * whether the final fenced lease delete committed. The original drain failure
+ * is available as `cause`.
+ *
+ * @example
+ * ```ts
+ * import { EngineDisposalError } from '@lostgradient/weft';
+ *
+ * function releaseSucceeded(error: unknown): boolean {
+ *   return error instanceof EngineDisposalError && error.leaseReleased;
+ * }
+ * void releaseSucceeded;
+ * ```
+ */
+export declare class EngineDisposalError extends WeftError<'EngineDisposalError'> {
+    readonly leaseReleased: boolean;
+    constructor(cause: unknown, leaseReleased: boolean);
+}
 /**
  * Thrown by engine APIs that need a workflow to be present in storage but
  * cannot find one with the given ID. Inspect `workflowId` to identify the

package/dist/core/engine/errors.js

@@ -70,6 +70,14 @@ export class EngineDisposedError extends WeftError {
   }
 }
 
+export class EngineDisposalError extends WeftError {
+  leaseReleased;
+  constructor(cause, leaseReleased) {
+    super("EngineDisposalError", "Engine disposal failed while draining queued work", { cause });
+    this.leaseReleased = leaseReleased;
+  }
+}
+
 export class WorkflowNotFoundError extends WeftError {
   workflowId;
   constructor(workflowId) {

package/dist/core/engine/index.d.ts

@@ -1,4 +1,4 @@
-import type { AlertState } from '../../alerting/types.ts';
+import type { AlertStateSnapshot } from '../../alerting/types.ts';
 import { type Storage as WeftStorage } from '../../storage/interface.ts';
 import { type ActivityMetadata, type ActivityRegistrationOptions, type RegisteredActivityFunction } from '../activity-registry.ts';
 import type { StoredStreamChunk } from '../context.ts';
@@ -25,7 +25,7 @@ export { ActivityReconciliationCapabilityError, ActivityReconciliationConflictEr
 export { AsyncActivityTokenNotFoundError } from './async-activity-completion.ts';
 export type { PendingAsyncActivity } from './async-activity-records.ts';
 export type { PendingTimelineEntry, RegistrationEntry, ResolvedOptions, TrackedWaiterKeys, WorkflowResultWaiter, } from './engine-internal-types.ts';
-export { ActivityResolutionError, BulkDeleteRequiresTerminalWorkflowsError, BulkOperationConfirmationError, EngineCreateNameMismatchError, EngineDisposedError, IdempotencyKeyPurgedError, PersistedDataIncompatibleError, StartOrSignalConflictError, WorkflowAlreadyExistsError, WorkflowConcurrencyLimitExceededError, WorkflowNotFoundError, WorkflowNotRegisteredError, WorkflowSuspendNotSupportedError, WorkflowTeardownPendingError, WorkflowTypeNotRegisteredForRecoveryError, } from './errors.ts';
+export { ActivityResolutionError, BulkDeleteRequiresTerminalWorkflowsError, BulkOperationConfirmationError, EngineCreateNameMismatchError, EngineDisposalError, EngineDisposedError, IdempotencyKeyPurgedError, PersistedDataIncompatibleError, StartOrSignalConflictError, WorkflowAlreadyExistsError, WorkflowConcurrencyLimitExceededError, WorkflowNotFoundError, WorkflowNotRegisteredError, WorkflowSuspendNotSupportedError, WorkflowTeardownPendingError, WorkflowTypeNotRegisteredForRecoveryError, } from './errors.ts';
 export { HANDLE_RESULT_PROMISE, WorkflowHandle } from './handles.ts';
 export { EngineLeaseAcquisitionTimeoutError, EngineLeaseCorruptedError, EngineLeaseNotHeldError, } from './lease-errors.ts';
 export type { EngineLeaseHealth, LeaseLostReason } from './lease-health.ts';
@@ -39,6 +39,30 @@ export { assertCompatiblePersistedDataVersion };
 export declare const ENGINE_PARKED_WORKFLOW_COUNT_FOR_TESTING: unique symbol;
 export declare const ENGINE_SIGNAL_WAITER_COUNT_FOR_TESTING: unique symbol;
 export declare const ENGINE_SLEEP_RESOLVER_COUNT_FOR_TESTING: unique symbol;
+export declare const ENGINE_WAIT_FOR_SLEEP_RESOLVER_FOR_TESTING: unique symbol;
+export declare const ENGINE_SET_WORKER_TURN_TIMEOUT_RESOLVER_FOR_TESTING: unique symbol;
+/**
+ * Bound for `ENGINE_WAIT_FOR_SLEEP_RESOLVER_FOR_TESTING`.
+ *
+ * The only production-adjacent consumer awaits that hook inside the
+ * `weft:test:periodic-sync` Service Worker message handler in
+ * service-worker-browser.test.ts, and that file bounds each message round trip
+ * at 5s (`sendWorkerMessage`), each phase at 15s or whatever remains of the
+ * test budget, and each test at 30s. This bound has to be strictly tighter than
+ * the innermost of those — at 5s it would tie with the message bound and the
+ * generic "Service Worker message timed out" could win the race, hiding the
+ * diagnostic this bound exists to produce. 3s expires first, and the handler
+ * posts the rejection back over the port so the workflow-naming error is what
+ * reaches CI.
+ *
+ * The ordering holds whenever the phase bound is the 15s ceiling. It cannot
+ * hold once a test has burned all but a few seconds of its 30s budget, because
+ * no inner window survives an outer bound shorter than itself. That case is
+ * reported rather than papered over: the phase error says the bound was
+ * shortened by the remaining budget and that a nested timeout may have been
+ * preempted, which points at the earlier phases that actually consumed it.
+ */
+export declare const SLEEP_RESOLVER_READY_WAIT_TIMEOUT_MS_FOR_TESTING = 3000;
 /**
  * The `name` of the `process` warning emitted when a lease-owning engine is
  * disposed through the synchronous `[Symbol.dispose]()` path. Sync disposal can
@@ -146,8 +170,8 @@ export declare class Engine<TWorkflows extends object = DefaultWorkflowRegistry,
     removeEventListener<K extends Extract<keyof WeftEventMap, string>>(type: K, listener: (event: WeftEventMap[K]) => void, options?: boolean | EventListenerOptions): void;
     removeEventListener(type: string, listener: EventListenerOrEventListenerObject | null, options?: boolean | EventListenerOptions): void;
     get state(): EngineStateNamespace;
-    /** Return the alert rules that are currently firing. */
-    getActiveAlerts(): readonly AlertState[];
+    /** Return detached snapshots of the alert rules that are currently firing. */
+    getActiveAlerts(): readonly AlertStateSnapshot[];
     /**
      * Register a workflow by name or definition, or register an activity
      * definition. Definition overloads return this same engine with the
@@ -314,6 +338,11 @@ export declare class Engine<TWorkflows extends object = DefaultWorkflowRegistry,
     [ENGINE_PARKED_WORKFLOW_COUNT_FOR_TESTING](): number;
     [ENGINE_SIGNAL_WAITER_COUNT_FOR_TESTING](): number;
     [ENGINE_SLEEP_RESOLVER_COUNT_FOR_TESTING](): number;
+    [ENGINE_WAIT_FOR_SLEEP_RESOLVER_FOR_TESTING](workflowId: string): Promise<void>;
+    [ENGINE_SET_WORKER_TURN_TIMEOUT_RESOLVER_FOR_TESTING](resolver: (turn: {
+        workflowId: string;
+        kind: 'run' | 'resume';
+    }) => number): void;
     signal(workflowId: string, name: SignalDefinition): Promise<void>;
     signal<TInput>(workflowId: string, name: SignalDefinition<TInput>, payload: TInput, options?: SignalDeliveryOptions): Promise<void>;
     signal(workflowId: string, name: string, payload?: unknown, options?: SignalDeliveryOptions): Promise<void>;
@@ -480,11 +509,13 @@ export declare class Engine<TWorkflows extends object = DefaultWorkflowRegistry,
      *
      * Under `ownership: 'lease'`, this is the explicit prompt-handoff primitive:
      * it drains queued inline starts, tears down in-memory write paths, and awaits
-     * lease release before resolving. Synchronous disposal remains immediate and
-     * can make the next engine wait for `leaseTtl` if the process exits before its
-     * background release completes.
+     * lease release before resolving. The returned boolean is `true` when no lease
+     * needed release or the holder delete committed, and `false` when the delete
+     * did not commit. Synchronous disposal remains immediate and can make the next
+     * engine wait for `leaseTtl` if the process exits before its background release
+     * completes.
      */
-    shutdown(): Promise<void>;
+    shutdown(): Promise<boolean>;
     /**
      * Synchronous teardown (`using engine = ...`). Pending inline launches that
      * have not yet run are **discarded**, not executed. When you need queued
@@ -493,15 +524,6 @@ export declare class Engine<TWorkflows extends object = DefaultWorkflowRegistry,
      * via `await using`.
      */
     [Symbol.dispose](): void;
-    /**
-     * Async teardown (`await using engine = ...`). Drains pending inline launches
-     * so each queued workflow completes its first turn before disposal, leaving no
-     * deferred-launch macrotask to fire against torn-down state. The drain is
-     * bounded (a pass cap and the abort signal); in the pathological case where it
-     * cannot converge, anything still queued is discarded by the synchronous
-     * teardown that always follows. Prefer this over the synchronous
-     * {@link Engine[Symbol.dispose]} in async contexts and tests.
-     */
     [Symbol.asyncDispose](): Promise<void>;
     get storage(): WeftStorage;
     get scheduler(): Scheduler;