@lostgradient/weft 0.14.0 → 0.16.0

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.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.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.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.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': {
@@ -19,8 +19,8 @@ export declare const CLIENT_REST_OPERATION_BINDINGS: {
         };
     };
 };
-type SharedAttributesBulkConcurrenc_f62debcf = {
-    readonly attributes?: ReadonlyArray<SharedGtGteKey_896a0c41>;
+type SharedAttributesBulkConcurrenc_ff397168 = {
+    readonly attributes?: ReadonlyArray<SharedGtGteKey_e658e64c>;
     readonly bulkConcurrency?: number;
     readonly confirmationToken?: string;
     readonly createdAt?: SharedGtGteLt_d9a61361;
@@ -39,8 +39,8 @@ type SharedAttributesBulkConcurrenc_f62debcf = {
     readonly type?: string;
     readonly updatedAt?: SharedGtGteLt_d9a61361;
 };
-type SharedAttributesCreatedAtExecu_2af7f9ff = {
-    readonly attributes?: ReadonlyArray<SharedGtGteKey_896a0c41>;
+type SharedAttributesCreatedAtExecu_0caddefc = {
+    readonly attributes?: ReadonlyArray<SharedGtGteKey_e658e64c>;
     readonly createdAt?: SharedGtGteLt_d9a61361;
     readonly executionDeadline?: SharedGtGteLt_d9a61361;
     readonly failureCategory?: unknown;
@@ -55,10 +55,10 @@ type SharedAttributesCreatedAtExecu_2af7f9ff = {
     readonly type?: string;
     readonly updatedAt?: SharedGtGteLt_d9a61361;
 };
-type SharedGtGteKey_896a0c41 = {
+type SharedGtGteKey_e658e64c = {
     readonly gt?: unknown;
     readonly gte?: unknown;
-    readonly key: string;
+    readonly key: unknown;
     readonly lt?: unknown;
     readonly lte?: unknown;
     readonly value?: unknown;
@@ -93,6 +93,19 @@ export type ClientOperationTypes = {
         };
         readonly faults: 'InvalidParams' | 'NotFound';
     };
+    'weft.alerts.list': {
+        readonly input: {};
+        readonly output: {
+            readonly items: ReadonlyArray<{
+                readonly currentValue: number;
+                readonly firedAt: unknown;
+                readonly metric: 'workflow.failure_rate' | 'activity.p99_duration' | 'storage.size';
+                readonly threshold: number;
+                readonly window: unknown;
+            }>;
+        };
+        readonly faults: never;
+    };
     'weft.recover.all': {
         readonly input: {};
         readonly output: {
@@ -411,14 +424,7 @@ export type ClientOperationTypes = {
     };
     'weft.workflows.aggregate': {
         readonly input: {
-            readonly attributes?: ReadonlyArray<{
-                readonly gt?: unknown;
-                readonly gte?: unknown;
-                readonly key: unknown;
-                readonly lt?: unknown;
-                readonly lte?: unknown;
-                readonly value?: unknown;
-            }>;
+            readonly attributes?: ReadonlyArray<SharedGtGteKey_e658e64c>;
             readonly createdAt?: SharedGtGteLt_d9a61361;
             readonly executionDeadline?: SharedGtGteLt_d9a61361;
             readonly failureCategory?: unknown;
@@ -461,23 +467,23 @@ export type ClientOperationTypes = {
         readonly faults: never;
     };
     'weft.workflows.bulk.cancel': {
-        readonly input: SharedAttributesBulkConcurrenc_f62debcf;
+        readonly input: SharedAttributesBulkConcurrenc_ff397168;
         readonly output: unknown;
         readonly faults: never;
     };
     'weft.workflows.bulk.delete': {
-        readonly input: SharedAttributesBulkConcurrenc_f62debcf;
+        readonly input: SharedAttributesBulkConcurrenc_ff397168;
         readonly output: unknown;
         readonly faults: 'Unprocessable';
     };
     'weft.workflows.bulk.retryfailed': {
-        readonly input: SharedAttributesBulkConcurrenc_f62debcf;
+        readonly input: SharedAttributesBulkConcurrenc_ff397168;
         readonly output: unknown;
         readonly faults: never;
     };
     'weft.workflows.bulk.signal': {
         readonly input: {
-            readonly attributes?: ReadonlyArray<SharedGtGteKey_896a0c41>;
+            readonly attributes?: ReadonlyArray<SharedGtGteKey_e658e64c>;
             readonly bulkConcurrency?: number;
             readonly confirmationToken?: string;
             readonly createdAt?: SharedGtGteLt_d9a61361;
@@ -506,7 +512,7 @@ export type ClientOperationTypes = {
             readonly bulkConcurrency?: number;
             readonly confirmationToken?: string;
             readonly dryRun?: boolean;
-            readonly filter?: SharedAttributesCreatedAtExecu_2af7f9ff;
+            readonly filter?: SharedAttributesCreatedAtExecu_0caddefc;
             readonly operation: 'add' | 'remove';
             readonly requestId?: string;
             readonly tags: ReadonlyArray<string>;
@@ -569,7 +575,7 @@ export type ClientOperationTypes = {
     };
     'weft.workflows.list': {
         readonly input: {
-            readonly attributes?: ReadonlyArray<SharedGtGteKey_896a0c41>;
+            readonly attributes?: ReadonlyArray<SharedGtGteKey_e658e64c>;
             readonly createdAt?: SharedGtGteLt_d9a61361;
             readonly executionDeadline?: SharedGtGteLt_d9a61361;
             readonly failureCategory?: unknown;
@@ -589,7 +595,7 @@ export type ClientOperationTypes = {
         readonly faults: 'Unprocessable';
     };
     'weft.workflows.purge': {
-        readonly input: SharedAttributesCreatedAtExecu_2af7f9ff;
+        readonly input: SharedAttributesCreatedAtExecu_0caddefc;
         readonly output: unknown;
         readonly faults: never;
     };

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

@@ -5,6 +5,7 @@ import {
 export const CATALOG_OPERATION_NAMES = [
   "weft.activities.complete",
   "weft.activities.fail",
+  "weft.alerts.list",
   "weft.recover.all",
   "weft.retention.get",
   "weft.reviews.decision.submit",
@@ -65,6 +66,7 @@ export const CATALOG_OPERATION_NAMES = [
 ], CLIENT_OPERATION_NAMES = [
   "weft.activities.complete",
   "weft.activities.fail",
+  "weft.alerts.list",
   "weft.recover.all",
   "weft.retention.get",
   "weft.reviews.decision.submit",

package/dist/cli/help-text.d.ts

@@ -1,4 +1,4 @@
-export declare const HELP_TEXT = "\nweft - Bun-native durable execution engine\n\nUsage: weft [command] [options]\n\nCommands:\n  serve           Start the Weft server (default)\n  doctor          Run diagnostics on the Weft database\n  conformance     Run RemoteWorker protocol conformance checks\n  schedule        Manage recurring schedules\n  timeline        Inspect workflow timeline and replay history\n  version:check   Check workflow version compatibility\n  validate        Lint workflow definitions for design-time anti-patterns\n  codegen         Generate TypeScript declarations from a registry snapshot\n  api             Inspect and invoke catalog operations on a running server\n  server          Inspect a running server's health and operation surface\n  workflow        List, inspect, start, signal, and cancel workflows on a server\n  tail            Stream a workflow's events as Server-Sent Events\n  completions     Generate or install shell completion scripts\n  version         Print the installed Weft version\n\nVersion (leading token only; a subcommand owns its own option line):\n  weft version | weft --version | weft -v   Print the installed Weft version\n\nServe Options:\n  -p, --port <port>           Server port (default: 7233)\n  -d, --database <path>       Database file path (default: ./weft.db)\n  -s, --storage <backend>     Storage backend: sqlite, lmdb, memory (default: sqlite)\n  -w, --workflows <path>      Path to workflow module to register on startup\n  -h, --help                  Show this help message\n";
+export declare const HELP_TEXT = "\nweft - Bun-native durable execution engine\n\nUsage: weft [command] [options]\n\nCommands:\n  serve           Start the Weft server (default)\n  doctor          Run diagnostics on the Weft database\n  conformance     Run RemoteWorker protocol conformance checks\n  schedule        Manage recurring schedules\n  timeline        Inspect workflow timeline and replay history\n  version:check   Check workflow version compatibility\n  validate        Lint workflow definitions for design-time anti-patterns\n  codegen         Generate TypeScript declarations from a registry snapshot\n  api             Inspect and invoke catalog operations on a running server\n  server          Inspect a running server's health and operation surface\n  workflow        List, inspect, start, signal, and cancel workflows on a server\n  tail            Stream a workflow's events as Server-Sent Events\n  completions     Generate or install shell completion scripts\n  version         Print the installed Weft version\n\nVersion (leading token only; a subcommand owns its own option line):\n  weft version | weft --version | weft -v   Print the installed Weft version\n\nServe Options:\n  -p, --port <port>           Server port (default: 7233)\n  -d, --database <path>       Database file path (default: ./weft.db)\n  -s, --storage <backend>     Storage backend: sqlite, lmdb, memory (default: sqlite)\n  -w, --workflows <path>      Path to workflow module to register on startup\n      --console               Mount @lostgradient/weft-console\n  -h, --help                  Show this help message\n";
 export declare const API_HELP_TEXT = "\nweft api - Inspect and invoke catalog operations on a running server\n\nUsage:\n  weft api --list [options]\n  weft api --describe <operation-name> [options]\n  weft api <operation-name> [--input <json> | --input-file <path|->] [options]\n\nOptions:\n      --server <url>       Server URL (default: WEFT_ADDR, profile, run lockfile, or localhost)\n      --token <token>      Bearer token (default: WEFT_TOKEN)\n      --profile <name>     Profile from ~/.weft/config (default: WEFT_PROFILE or default_profile)\n      --input <json>       JSON object input for the operation\n      --input-file <path>  Read JSON object input from a file, or '-' for stdin\n      --list               List catalog operations\n      --describe <name>    Print one operation's schema and metadata\n      --yes                Confirm destructive operations without prompting\n  -j, --json               Emit machine-readable JSON output\n  -h, --help               Show this help message\n\nExit codes:\n  0   Success\n  1   Operation failed or destructive operation was not confirmed\n  2   Connection error\n  3   Usage or input validation error\n";
 export declare const CONFORMANCE_HELP_TEXT = "\nweft conformance - Run RemoteWorker protocol conformance checks\n\nUsage: weft conformance [options] -- <worker-command> [args...]\n\nThe worker command receives:\n  WEFT_WORKER_URL\n  WEFT_WORKER_QUEUE\n  WEFT_WORKER_ACTIVITIES\n  WEFT_WORKER_PROTOCOL_VERSION\n\nOptions:\n      --timeout <ms>       Per-check timeout in milliseconds (default: 15000)\n  -j, --json               Output results as JSON\n  -h, --help               Show this help message\n";
 export declare const DOCTOR_HELP_TEXT = "\nweft doctor - Run diagnostics on the Weft database\n\nUsage: weft doctor [options]\n\nOptions:\n  -d, --database <path>   Database file path (default: ./weft.db)\n  -j, --json              Output results as JSON\n  -h, --help              Show this help message\n";

package/dist/cli/help-text.js

@@ -27,6 +27,7 @@ Serve Options:
   -d, --database <path>       Database file path (default: ./weft.db)
   -s, --storage <backend>     Storage backend: sqlite, lmdb, memory (default: sqlite)
   -w, --workflows <path>      Path to workflow module to register on startup
+      --console               Mount @lostgradient/weft-console
   -h, --help                  Show this help message
 `, API_HELP_TEXT = `
 weft api - Inspect and invoke catalog operations on a running server

package/dist/cli/index.d.ts

@@ -4,6 +4,7 @@ export { executeApi } from './api.ts';
 export { executeCodegen } from './codegen.ts';
 export { executeCompletions } from './completions.ts';
 export { executeConformance } from './conformance.ts';
+export { loadConsoleMount } from './console.ts';
 export { executeDoctor } from './doctor.ts';
 export { createWeftClient } from './generated/operation-client.generated.ts';
 export type { CatalogOperationName, WeftClient } from './generated/operation-client.generated.ts';

package/dist/cli/index.js

@@ -4,6 +4,7 @@ export { executeApi } from "./api.js";
 export { executeCodegen } from "./codegen.js";
 export { executeCompletions } from "./completions.js";
 export { executeConformance } from "./conformance.js";
+export { loadConsoleMount } from "./console.js";
 export { executeDoctor } from "./doctor.js";
 export { createWeftClient } from "./generated/operation-client.generated.js";
 export {

package/dist/cli/json-input.d.ts

@@ -0,0 +1,20 @@
+export type JsonInputFailure = {
+    readonly kind: 'invalid-json';
+    readonly detail: string;
+    readonly message: string;
+} | {
+    readonly kind: 'missing-file';
+    readonly message: string;
+    readonly path: string;
+};
+export type JsonInputResult = {
+    readonly ok: true;
+    readonly value: unknown;
+} | {
+    readonly ok: false;
+    readonly error: JsonInputFailure;
+};
+/** Parse one inline JSON source without applying a command-specific error format. */
+export declare function parseJsonInput(source: string): JsonInputResult;
+/** Load JSON from inline input, a file, or stdin without applying caller policy. */
+export declare function loadJsonInput(input: string | undefined, inputFile: string | undefined, readStdin?: () => Promise<string>): Promise<JsonInputResult>;

package/dist/cli/json-input.js

@@ -0,0 +1,33 @@
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+export function parseJsonInput(source) {
+  try {
+    return { ok: !0, value: JSON.parse(source) };
+  } catch (error) {
+    const detail = errorMessage(error);
+    return {
+      ok: !1,
+      error: { kind: "invalid-json", detail, message: `invalid JSON input: ${detail}` }
+    };
+  }
+}
+export async function loadJsonInput(input, inputFile, readStdin = () => Bun.stdin.text()) {
+  if (input !== void 0)
+    return parseJsonInput(input);
+  if (inputFile === void 0)
+    return { ok: !0, value: void 0 };
+  if (inputFile === "-")
+    return parseJsonInput(await readStdin());
+  const file = Bun.file(inputFile);
+  if (!await file.exists())
+    return {
+      ok: !1,
+      error: {
+        kind: "missing-file",
+        message: `input file not found: ${inputFile}`,
+        path: inputFile
+      }
+    };
+  return parseJsonInput(await file.text());
+}

package/dist/cli/parse-arguments.js

@@ -75,6 +75,7 @@ function parseServeArguments(args) {
       database: { type: "string", short: "d", default: "./weft.db" },
       storage: { type: "string", short: "s", default: "sqlite" },
       help: { type: "boolean", short: "h", default: !1 },
+      console: { type: "boolean", default: !1 },
       workflows: { type: "string", short: "w" }
     },
     strict: !0,
@@ -89,6 +90,7 @@ function parseServeArguments(args) {
     database: values.database ?? "./weft.db",
     storage: parseStorageBackend(values.storage),
     help: values.help ?? !1,
+    console: values.console ?? !1,
     ...values.workflows ? { workflows: values.workflows } : {}
   };
 }

package/dist/cli/schedule.js

@@ -1,4 +1,5 @@
 import { registerOnRuntimeEngine, runtimeWorkflowEngine } from "../core/runtime-workflow-engine.js";
+import { parseJsonInput } from "./json-input.js";
 import { createStorage } from "./storage-factory.js";
 function formatScheduleCadence(schedule) {
   if (schedule.intervalMs !== void 0)
@@ -42,13 +43,6 @@ function getScheduleCreateValidationError(options) {
     return "Error: provide a <cronExpression> argument or an --every <duration> flag for schedule create";
   return null;
 }
-function parseScheduleInput(input) {
-  try {
-    return { ok: !0, value: JSON.parse(input) };
-  } catch (error) {
-    return { ok: !1, message: `Error: could not parse --input JSON: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
 async function registerScheduleWorkflows(engine, workflowsPath, loadRegistrationsFromModule) {
   const loaded = await loadRegistrationsFromModule(workflowsPath);
   for (const definition of Object.values(loaded.registrations))
@@ -59,9 +53,13 @@ async function executeScheduleCreate(options, engine, loadRegistrationsFromModul
   if (validationError !== null)
     return { stdout: "", stderr: validationError, exitCode: 1 };
   await registerScheduleWorkflows(engine, options.workflows, loadRegistrationsFromModule);
-  const parsedInput = parseScheduleInput(options.input);
+  const parsedInput = parseJsonInput(options.input);
   if (!parsedInput.ok)
-    return { stdout: "", stderr: parsedInput.message, exitCode: 1 };
+    return {
+      stdout: "",
+      stderr: parsedInput.error.kind === "invalid-json" ? `Error: could not parse --input JSON: ${parsedInput.error.detail}` : `Error: ${parsedInput.error.message}`,
+      exitCode: 1
+    };
   const spec = options.every !== void 0 ? { every: options.every } : options.cronExpression, handle = await engine.schedule(options.workflowType, parsedInput.value, spec, {
     ...options.id !== void 0 ? { id: options.id } : {},
     ...options.overlap !== void 0 ? { overlap: options.overlap } : {},

package/dist/cli/types.d.ts

@@ -10,6 +10,7 @@ export type CliCommand = {
     database: string;
     storage: StorageBackend;
     help: boolean;
+    console: boolean;
     workflows?: string;
 } | {
     command: 'version';

package/dist/cli/workflow-commands.js

@@ -1,7 +1,7 @@
+import { loadJsonInput } from "./json-input.js";
 import {
   confirmDestructive,
   formatTimestamp,
-  messageOf,
   ndjson,
   prettyJson,
   truncateToWidth
@@ -105,30 +105,10 @@ async function executeWorkflowEvents(command, connection) {
   }).join(`
 `), exitCode: 0 };
 }
-async function readInlineInput(input, inputFile) {
-  if (input !== void 0)
-    return parseJson(input);
-  if (inputFile !== void 0) {
-    if (inputFile === "-")
-      return parseJson(await Bun.stdin.text());
-    const file = Bun.file(inputFile);
-    if (!await file.exists())
-      return { ok: !1, message: `input file not found: ${inputFile}` };
-    return parseJson(await file.text());
-  }
-  return { ok: !0, value: void 0 };
-}
-function parseJson(source) {
-  try {
-    return { ok: !0, value: JSON.parse(source) };
-  } catch (error) {
-    return { ok: !1, message: `invalid JSON input: ${messageOf(error)}` };
-  }
-}
 async function executeWorkflowStart(command, connection) {
-  const parsed = await readInlineInput(command.input, command.inputFile);
+  const parsed = await loadJsonInput(command.input, command.inputFile);
   if (!parsed.ok)
-    return { stdout: "", stderr: `workflow start: ${parsed.message}`, exitCode: 3 };
+    return { stdout: "", stderr: `workflow start: ${parsed.error.message}`, exitCode: 3 };
   const result = await callCatalogOperation(connection, "weft.workflows.start", {
     type: command.workflowType,
     ...parsed.value === void 0 ? {} : { input: parsed.value },
@@ -169,9 +149,9 @@ async function executeWorkflowCancel(command, connection) {
   };
 }
 async function executeWorkflowSignal(command, connection) {
-  const parsed = await readInlineInput(command.input, command.inputFile);
+  const parsed = await loadJsonInput(command.input, command.inputFile);
   if (!parsed.ok)
-    return { stdout: "", stderr: `workflow signal: ${parsed.message}`, exitCode: 3 };
+    return { stdout: "", stderr: `workflow signal: ${parsed.error.message}`, exitCode: 3 };
   const result = await callCatalogOperation(connection, "weft.workflows.signal", {
     workflowId: command.workflowId,
     signalName: command.signalName,

package/dist/cli-main.js

@@ -21,6 +21,7 @@ import {
   executeWorkflow,
   findCliSubcommandName,
   HELP_TEXT,
+  loadConsoleMount,
   parseCliArguments,
   removeRunLockfile,
   SCHEDULE_HELP_TEXT,
@@ -53,7 +54,7 @@ if (parsedArguments.command === "version") {
     console.log(HELP_TEXT);
     process.exit(0);
   }
-  const storage = await createStorage(parsedArguments.storage, parsedArguments.database), engine = new Engine({ storage });
+  const consoleMount = parsedArguments.console ? await loadConsoleMount() : void 0, storage = await createStorage(parsedArguments.storage, parsedArguments.database), engine = new Engine({ storage });
   if (parsedArguments.workflows) {
     const { loadRegistrationsFromModule } = await import("./diagnostics/validate.js"), { registerModuleExports } = await import("./cli/serve-registrations.js"), loaded = await loadRegistrationsFromModule(parsedArguments.workflows);
     registerModuleExports(engine, loaded.registrations, loaded.activities);
@@ -61,7 +62,8 @@ if (parsedArguments.command === "version") {
     console.log("No --workflows module provided; starting in inspect-only mode.");
   const server = serve({
     engine,
-    port: Number(parsedArguments.port)
+    port: Number(parsedArguments.port),
+    ...consoleMount
   });
   await writeRunLockfile(server.url);
   console.log(`Weft API running at ${new URL("/api/v1", server.url).href}`);

package/dist/core/aggregate-validation.d.ts

@@ -11,6 +11,7 @@
  * @module core/aggregate-validation
  */
 import { z } from 'zod';
+import { type ValidationIssue } from './validation-issues.ts';
 import { WeftError } from './weft-error.ts';
 /**
  * Group-by dimension for `engine.aggregate()`. Either a fixed structural
@@ -54,11 +55,7 @@ export declare const aggregateOptionsObjectSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 /** A flattened Zod issue suitable for cross-transport serialization. */
-export type AggregateOptionsValidationIssue = {
-    readonly path: ReadonlyArray<string | number>;
-    readonly message: string;
-    readonly code: string;
-};
+export type AggregateOptionsValidationIssue = ValidationIssue;
 /**
  * Thrown by {@link normalizeAggregateOptions} when input fails validation.
  * Carries flattened Zod issues so transport adapters can map directly to

package/dist/core/aggregate-validation.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { flattenZodIssue } from "./validation-issues.js";
 import { WeftError } from "./weft-error.js";
 const attributeDimensionSchema = z.object({ attribute: z.string().min(1) }).strict(), groupBySchema = z.union([
   z.literal("status"),
@@ -10,15 +11,6 @@ export const AGGREGATE_DEFAULT_LIMIT = 1000, AGGREGATE_MAX_LIMIT = 1e4, MAX_AGGR
   groupBy: groupBySchema,
   limit: z.number().int().min(1).max(AGGREGATE_MAX_LIMIT).optional()
 }).strict();
-function flattenIssue(issue) {
-  const path = [];
-  for (const segment of issue.path)
-    if (typeof segment === "string" || typeof segment === "number")
-      path.push(segment);
-    else
-      path.push(String(segment));
-  return { path, message: issue.message, code: issue.code };
-}
 
 export class AggregateOptionsValidationError extends WeftError {
   issues;
@@ -42,7 +34,7 @@ export class AggregateDistinctKeyCapExceededError extends WeftError {
 export function normalizeAggregateOptions(input) {
   const result = aggregateOptionsObjectSchema.safeParse(input ?? {});
   if (!result.success)
-    throw new AggregateOptionsValidationError(result.error.issues.map(flattenIssue));
+    throw new AggregateOptionsValidationError(result.error.issues.map(flattenZodIssue));
   const { groupBy, limit } = result.data;
   return { groupBy, ...limit !== void 0 && { limit } };
 }

package/dist/core/atomic-state.js

@@ -121,35 +121,18 @@ export class AtomicState extends EventTarget {
     return (await this.#read()).value;
   }
   async update(updater) {
-    for (let attempt = 0;attempt < this.#maxRetries; attempt++) {
-      const snapshot = await this.#read(), nextValue = updater(snapshot.value), commit = await commitAtomicStateValue(this.#storage, this.#dataKey, snapshot.version, nextValue);
-      if (commit.applied) {
-        dispatchAtomicStateEvent(this, new AtomicStateChangeEvent(nextValue, snapshot.value, commit.version));
-        return nextValue;
-      }
-      dispatchAtomicStateEvent(this, new AtomicStateConflictEvent(this.#stateKey, attempt + 1));
-      if (attempt < this.#maxRetries - 1)
-        await this.#sleep(retryDelay(attempt));
-    }
-    dispatchAtomicStateEvent(this, new AtomicStateExhaustedEvent(this.#stateKey, this.#maxRetries));
-    throw new AtomicStateConflictError(this.#stateKey, this.#maxRetries);
+    return this.#runOptimisticMutation(async (snapshot) => {
+      const nextValue = updater(snapshot.value);
+      return { commit: await commitAtomicStateValue(this.#storage, this.#dataKey, snapshot.version, nextValue), result: nextValue, eventValue: nextValue };
+    });
   }
   async set(value) {
     return this.update(() => value);
   }
   async delete() {
-    for (let attempt = 0;attempt < this.#maxRetries; attempt++) {
-      const snapshot = await this.#read(), commit = await commitAtomicStateDelete(this.#storage, this.#dataKey, snapshot.version);
-      if (commit.applied) {
-        dispatchAtomicStateEvent(this, new AtomicStateChangeEvent(void 0, snapshot.value, commit.version));
-        return;
-      }
-      dispatchAtomicStateEvent(this, new AtomicStateConflictEvent(this.#stateKey, attempt + 1));
-      if (attempt < this.#maxRetries - 1)
-        await this.#sleep(retryDelay(attempt));
-    }
-    dispatchAtomicStateEvent(this, new AtomicStateExhaustedEvent(this.#stateKey, this.#maxRetries));
-    throw new AtomicStateConflictError(this.#stateKey, this.#maxRetries);
+    await this.#runOptimisticMutation(async (snapshot) => {
+      return { commit: await commitAtomicStateDelete(this.#storage, this.#dataKey, snapshot.version), result: void 0, eventValue: void 0 };
+    });
   }
   increment(amount = 1) {
     return this.update((current) => (current ?? 0) + amount);
@@ -225,6 +208,20 @@ export class AtomicState extends EventTarget {
       this.removeEventListener("exhausted", listener);
     }
   }
+  async#runOptimisticMutation(attemptMutation) {
+    for (let attempt = 0;attempt < this.#maxRetries; attempt++) {
+      const snapshot = await this.#read(), mutation = await attemptMutation(snapshot);
+      if (mutation.commit.applied) {
+        dispatchAtomicStateEvent(this, new AtomicStateChangeEvent(mutation.eventValue, snapshot.value, mutation.commit.version));
+        return mutation.result;
+      }
+      dispatchAtomicStateEvent(this, new AtomicStateConflictEvent(this.#stateKey, attempt + 1));
+      if (attempt < this.#maxRetries - 1)
+        await this.#sleep(retryDelay(attempt));
+    }
+    dispatchAtomicStateEvent(this, new AtomicStateExhaustedEvent(this.#stateKey, this.#maxRetries));
+    throw new AtomicStateConflictError(this.#stateKey, this.#maxRetries);
+  }
   async#read() {
     return readAtomicStateSnapshot(this.#storage, this.#dataKey, this.#options);
   }

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

@@ -1,3 +1,4 @@
+import type { AlertState } 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';
@@ -145,6 +146,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[];
     /**
      * Register a workflow by name or definition, or register an activity
      * definition. Definition overloads return this same engine with the

package/dist/core/engine/index.js

@@ -522,6 +522,9 @@ export class Engine extends EventTarget {
       workflow: (workflowType, key, options) => new AtomicState(storage, KEYS.stateWorkflow(workflowType, key), options)
     };
   }
+  getActiveAlerts() {
+    return getInternals(this).alertManager?.activeStates ?? [];
+  }
   async#handleStrategyMessage(message) {
     return handleStrategyMessageFromInternals(getInternals(this), message, this.#createInlineParkingCallbacks());
   }

package/dist/core/engine/schedules.js

@@ -100,7 +100,10 @@ async function hasCurrentScheduleTimer(internals, state) {
 }
 export function toScheduleSummary(state) {
   const { input: _input, ...summary } = state;
-  return { ...summary, queuedRuns: summary.queuedRuns.map((queuedRun) => ({ ...queuedRun })) };
+  return {
+    ...summary,
+    queuedRuns: summary.queuedRuns.map((queuedRun) => ({ ...queuedRun }))
+  };
 }
 export async function pauseSchedule(internals, scheduleId) {
   const normalizedScheduleId = coerceScheduleId(scheduleId, "scheduleId"), state = await requireScheduleState(internals, normalizedScheduleId);

package/dist/core/inline-execution-strategy.js

@@ -128,11 +128,17 @@ export class InlineExecutionStrategy {
     this[Symbol.dispose]();
   }
   #driveGenerator(workflowId, generator, lastResult) {
+    return this.#advanceGenerator(workflowId, () => generator.next(lastResult), void 0);
+  }
+  #throwIntoGenerator(workflowId, generator, error, operationFailureCategory) {
+    return this.#advanceGenerator(workflowId, () => generator.throw(error), operationFailureCategory);
+  }
+  #advanceGenerator(workflowId, advance, fallbackFailureCategory) {
     return this.#trackWorkflowAdvance(workflowId, (async () => {
       try {
         if (this.#abortControllers.get(workflowId)?.signal.aborted)
           return;
-        const iterationResult = await generator.next(lastResult);
+        const iterationResult = await advance();
         if (iterationResult.done) {
           this.#cleanup(workflowId, {
             preserveTrackedAdvance: !0,
@@ -161,7 +167,7 @@ export class InlineExecutionStrategy {
           type: "failed",
           workflowId,
           error: error instanceof Error ? error.message : String(error),
-          failureCategory: classifyErrorAsFailureCategory(error, {
+          failureCategory: fallbackFailureCategory ?? classifyErrorAsFailureCategory(error, {
             defaultErrorCategory: "application"
           })
         };
@@ -171,50 +177,6 @@ export class InlineExecutionStrategy {
       }
     })());
   }
-  #throwIntoGenerator(workflowId, generator, error, operationFailureCategory) {
-    return this.#trackWorkflowAdvance(workflowId, (async () => {
-      try {
-        if (this.#abortControllers.get(workflowId)?.signal.aborted)
-          return;
-        const iterationResult = await generator.throw(error);
-        if (iterationResult.done) {
-          this.#cleanup(workflowId, {
-            preserveTrackedAdvance: !0,
-            preserveTrackedTurn: !0
-          });
-          this.#emit({
-            type: "completed",
-            workflowId,
-            result: iterationResult.value
-          });
-          return;
-        }
-        const operation = iterationResult.value;
-        this.#emit({
-          type: "checkpoint",
-          workflowId,
-          checkpoint: new ArrayBuffer(0),
-          operationRequest: operation
-        });
-      } catch (innerError) {
-        this.#cleanup(workflowId, {
-          preserveTrackedAdvance: !0,
-          preserveTrackedTurn: !0
-        });
-        const failedMessage = {
-          type: "failed",
-          workflowId,
-          error: innerError instanceof Error ? innerError.message : String(innerError),
-          failureCategory: operationFailureCategory ?? classifyErrorAsFailureCategory(innerError, {
-            defaultErrorCategory: "application"
-          })
-        };
-        if (innerError instanceof Error && innerError.stack !== void 0)
-          failedMessage.errorStack = innerError.stack;
-        this.#emit(failedMessage);
-      }
-    })());
-  }
   #trackWorkflowAdvance(workflowId, pendingAdvance) {
     const trackedAdvance = pendingAdvance.finally(() => {
       if (this.#workflowAdvances.get(workflowId) === trackedAdvance)