@lostgradient/weft 0.12.0 → 0.14.0

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

@@ -1,7 +1,25 @@
 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.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.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.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.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.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];
-type SharedAttributesBulkConcurrenc_73ecbca6 = {
+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 type ClientOperationName = (typeof CLIENT_OPERATION_NAMES)[number];
+export declare const CLIENT_REST_OPERATION_BINDINGS: {
+    readonly 'weft.tasks.diagnostics.deadletters.clear': {
+        readonly method: "DELETE";
+        readonly path: "/tasks/diagnostics/dead-letter/:operationId";
+        readonly inputSources: {
+            readonly operationId: {
+                readonly kind: "path";
+                readonly pathParam: "operationId";
+            };
+        };
+        readonly success: {
+            readonly kind: "json";
+            readonly status: 200;
+        };
+    };
+};
+type SharedAttributesBulkConcurrenc_f62debcf = {
     readonly attributes?: ReadonlyArray<SharedGtGteKey_896a0c41>;
     readonly bulkConcurrency?: number;
     readonly confirmationToken?: string;
@@ -12,13 +30,16 @@ type SharedAttributesBulkConcurrenc_73ecbca6 = {
     readonly idPrefix?: string;
     readonly limit?: number;
     readonly offset?: number;
+    readonly parentWorkflowExecutionToken?: string;
+    readonly parentWorkflowId?: string;
     readonly requestId?: string;
+    readonly scheduleId?: string;
     readonly status?: unknown;
     readonly tags?: ReadonlyArray<string>;
     readonly type?: string;
     readonly updatedAt?: SharedGtGteLt_d9a61361;
 };
-type SharedAttributesCreatedAtExecu_c9ba5dc6 = {
+type SharedAttributesCreatedAtExecu_2af7f9ff = {
     readonly attributes?: ReadonlyArray<SharedGtGteKey_896a0c41>;
     readonly createdAt?: SharedGtGteLt_d9a61361;
     readonly executionDeadline?: SharedGtGteLt_d9a61361;
@@ -26,6 +47,9 @@ type SharedAttributesCreatedAtExecu_c9ba5dc6 = {
     readonly idPrefix?: string;
     readonly limit?: number;
     readonly offset?: number;
+    readonly parentWorkflowExecutionToken?: string;
+    readonly parentWorkflowId?: string;
+    readonly scheduleId?: string;
     readonly status?: unknown;
     readonly tags?: ReadonlyArray<string>;
     readonly type?: string;
@@ -45,7 +69,7 @@ type SharedGtGteLt_d9a61361 = {
     readonly lt?: number;
     readonly lte?: number;
 };
-export type CatalogOperationTypes = {
+export type ClientOperationTypes = {
     'weft.activities.complete': {
         readonly input: {
             readonly result?: unknown;
@@ -171,12 +195,43 @@ export type CatalogOperationTypes = {
     };
     'weft.schedules.update': {
         readonly input: {
+            readonly backfill?: unknown;
             readonly cronExpression?: unknown;
+            readonly description?: unknown;
             readonly every?: unknown;
+            readonly jitter?: unknown;
+            readonly overlap?: unknown;
             readonly scheduleId: string;
         };
         readonly output: null;
-        readonly faults: 'Conflict' | 'NotFound';
+        readonly faults: 'Conflict' | 'InvalidParams' | 'NotFound';
+    };
+    'weft.storage.capabilities': {
+        readonly input: {};
+        readonly output: {
+            readonly atomicBatch: boolean;
+            readonly boundedRangeDelete: boolean;
+            readonly conditionalBatch: boolean;
+            readonly persistence: 'ephemeral' | 'local' | 'remote';
+            readonly readAfterWrite: 'linearizable' | 'session' | 'eventual';
+            readonly scanConsistency: 'snapshot' | 'best-effort';
+        };
+        readonly faults: never;
+    };
+    'weft.system.lease': {
+        readonly input: {};
+        readonly output: {
+            readonly expiresAt?: number;
+            readonly fencingEpoch?: number;
+            readonly heldSince?: number;
+            readonly holderId?: string;
+            readonly holdsLease: boolean;
+            readonly lastRenewedAt?: number;
+            readonly lossReason?: 'deposed' | 'renewal-unconfirmable';
+            readonly mode: 'none' | 'lease';
+            readonly status: 'disabled' | 'healthy' | 'no-lease' | 'contested';
+        };
+        readonly faults: never;
     };
     'weft.system.metrics': {
         readonly input: {};
@@ -251,6 +306,15 @@ export type CatalogOperationTypes = {
         };
         readonly faults: never;
     };
+    'weft.tasks.diagnostics.deadletters.clear': {
+        readonly input: {
+            readonly operationId: string;
+        };
+        readonly output: {
+            readonly ok: boolean;
+        };
+        readonly faults: never;
+    };
     'weft.updates.result.get': {
         readonly input: {
             readonly updateId: string;
@@ -326,6 +390,25 @@ export type CatalogOperationTypes = {
         readonly output: unknown;
         readonly faults: 'NotFound';
     };
+    'weft.workflows.activities.pending.list': {
+        readonly input: {
+            readonly cursor?: string;
+            readonly limit: number;
+            readonly workflowId: string;
+        };
+        readonly output: {
+            readonly items: ReadonlyArray<{
+                readonly activityName: string;
+                readonly attempt: number;
+                readonly createdAt: number;
+                readonly operationId: string;
+                readonly step: number;
+                readonly token: string;
+            }>;
+            readonly nextCursor?: string;
+        };
+        readonly faults: 'InvalidParams' | 'NotFound';
+    };
     'weft.workflows.aggregate': {
         readonly input: {
             readonly attributes?: ReadonlyArray<{
@@ -342,6 +425,9 @@ export type CatalogOperationTypes = {
             readonly groupBy: unknown;
             readonly idPrefix?: string;
             readonly limit?: number;
+            readonly parentWorkflowExecutionToken?: string;
+            readonly parentWorkflowId?: string;
+            readonly scheduleId?: string;
             readonly status?: unknown;
             readonly tags?: ReadonlyArray<string>;
             readonly type?: string;
@@ -375,17 +461,17 @@ export type CatalogOperationTypes = {
         readonly faults: never;
     };
     'weft.workflows.bulk.cancel': {
-        readonly input: SharedAttributesBulkConcurrenc_73ecbca6;
+        readonly input: SharedAttributesBulkConcurrenc_f62debcf;
         readonly output: unknown;
         readonly faults: never;
     };
     'weft.workflows.bulk.delete': {
-        readonly input: SharedAttributesBulkConcurrenc_73ecbca6;
+        readonly input: SharedAttributesBulkConcurrenc_f62debcf;
         readonly output: unknown;
         readonly faults: 'Unprocessable';
     };
     'weft.workflows.bulk.retryfailed': {
-        readonly input: SharedAttributesBulkConcurrenc_73ecbca6;
+        readonly input: SharedAttributesBulkConcurrenc_f62debcf;
         readonly output: unknown;
         readonly faults: never;
     };
@@ -402,8 +488,11 @@ export type CatalogOperationTypes = {
             readonly limit?: number;
             readonly name: string;
             readonly offset?: number;
+            readonly parentWorkflowExecutionToken?: string;
+            readonly parentWorkflowId?: string;
             readonly payload?: unknown;
             readonly requestId?: string;
+            readonly scheduleId?: string;
             readonly status?: unknown;
             readonly tags?: ReadonlyArray<string>;
             readonly type?: string;
@@ -417,7 +506,7 @@ export type CatalogOperationTypes = {
             readonly bulkConcurrency?: number;
             readonly confirmationToken?: string;
             readonly dryRun?: boolean;
-            readonly filter?: SharedAttributesCreatedAtExecu_c9ba5dc6;
+            readonly filter?: SharedAttributesCreatedAtExecu_2af7f9ff;
             readonly operation: 'add' | 'remove';
             readonly requestId?: string;
             readonly tags: ReadonlyArray<string>;
@@ -454,6 +543,13 @@ export type CatalogOperationTypes = {
         readonly output: unknown;
         readonly faults: 'NotFound';
     };
+    'weft.workflows.finalizer.get': {
+        readonly input: {
+            readonly workflowId: string;
+        };
+        readonly output: unknown;
+        readonly faults: never;
+    };
     'weft.workflows.fork': {
         readonly input: {
             readonly fromStep?: unknown;
@@ -481,6 +577,9 @@ export type CatalogOperationTypes = {
             readonly include?: unknown;
             readonly limit?: number;
             readonly offset?: number;
+            readonly parentWorkflowExecutionToken?: string;
+            readonly parentWorkflowId?: string;
+            readonly scheduleId?: string;
             readonly status?: unknown;
             readonly tags?: ReadonlyArray<string>;
             readonly type?: string;
@@ -490,7 +589,7 @@ export type CatalogOperationTypes = {
         readonly faults: 'Unprocessable';
     };
     'weft.workflows.purge': {
-        readonly input: SharedAttributesCreatedAtExecu_c9ba5dc6;
+        readonly input: SharedAttributesCreatedAtExecu_2af7f9ff;
         readonly output: unknown;
         readonly faults: never;
     };
@@ -527,6 +626,13 @@ export type CatalogOperationTypes = {
         };
         readonly faults: 'Conflict' | 'NotFound';
     };
+    'weft.workflows.scheduleprovenance.get': {
+        readonly input: {
+            readonly workflowId: string;
+        };
+        readonly output: unknown;
+        readonly faults: never;
+    };
     'weft.workflows.signal': {
         readonly input: {
             readonly payload?: unknown;
@@ -645,6 +751,8 @@ export type CatalogOperationTypes = {
         readonly faults: 'Timeout' | 'Unprocessable';
     };
 };
+export type CatalogOperationTypes = Pick<ClientOperationTypes, CatalogOperationName>;
 export type WeftClient = CatalogWeftClient<CatalogOperationTypes>;
+export type ClientOperations = CatalogWeftClient<ClientOperationTypes>;
 export declare function createWeftClient(connection?: WeftClientConnection): WeftClient;
 export {};

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

@@ -17,6 +17,8 @@ export const CATALOG_OPERATION_NAMES = [
   "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",
@@ -27,6 +29,7 @@ export const CATALOG_OPERATION_NAMES = [
   "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",
@@ -39,6 +42,7 @@ export const CATALOG_OPERATION_NAMES = [
   "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",
@@ -47,6 +51,7 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.workflows.replay",
   "weft.workflows.result.get",
   "weft.workflows.resume",
+  "weft.workflows.scheduleprovenance.get",
   "weft.workflows.signal",
   "weft.workflows.start",
   "weft.workflows.startorsignal",
@@ -57,7 +62,75 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.workflows.timeline.get",
   "weft.workflows.timeout",
   "weft.workflows.update"
-];
+], CLIENT_OPERATION_NAMES = [
+  "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"
+], CLIENT_REST_OPERATION_BINDINGS = {
+  "weft.tasks.diagnostics.deadletters.clear": {
+    method: "DELETE",
+    path: "/tasks/diagnostics/dead-letter/:operationId",
+    inputSources: { operationId: { kind: "path", pathParam: "operationId" } },
+    success: { kind: "json", status: 200 }
+  }
+};
 export function createWeftClient(connection = {}) {
   return createCatalogWeftClient(CATALOG_OPERATION_NAMES, httpJsonRpcTransport(connection));
 }

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

@@ -1,11 +1,11 @@
-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 registrations 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  -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";
 export declare const VERSION_CHECK_HELP_TEXT = "\nweft version:check - Check workflow version compatibility\n\nUsage: weft version:check [options]\n\nOptions:\n  -d, --database <path>     Database file path (default: ./weft.db)\n  -w, --workflows <path>    Path to workflows module\n  -j, --json                Output results as JSON\n  -h, --help                Show this help message\n";
 export declare const TIMELINE_HELP_TEXT = "\nweft timeline - Inspect workflow timeline and replay history\n\nUsage:\n  weft timeline <workflowId> [options]\n  weft timeline <workflowId> --diff <fromStep> <toStep> [options]\n\nOptions:\n  -d, --database <path>     Database file path (default: ./weft.db)\n      --step <step>         Show replay details for one checkpoint step\n      --diff                Diff two checkpoint steps (requires two positional step numbers)\n  -h, --help                Show this help message\n";
-export declare const SCHEDULE_HELP_TEXT = "\nweft schedule - Manage recurring schedules\n\nUsage:\n  weft schedule list [options]\n  weft schedule create <workflowType> <cronExpression> [options]\n  weft schedule create <workflowType> --every <duration> [options]\n  weft schedule pause <scheduleId> [options]\n  weft schedule resume <scheduleId> [options]\n  weft schedule cancel <scheduleId> [options]\n\nProvide a cron expression positional OR an --every interval (e.g. \"30s\", \"1h\"),\nbut not both. Interval schedules fire one period after creation, then every\nperiod after that.\n\nOptions:\n  -d, --database <path>     Database file path (default: ./weft.db)\n  -s, --storage <backend>   Storage backend: sqlite, lmdb (default: sqlite)\n  -w, --workflows <path>    Path to workflow registrations module (required for create)\n      --every <duration>    Interval cadence for create (e.g. 30s, 5m, 1h); mutually exclusive with the cron positional\n      --input <json>        JSON input payload for create (default: null)\n      --id <id>             Custom schedule id for create\n      --overlap <policy>    Overlap policy: skip, queue, cancel-running, allow\n      --backfill            Run missed ticks on recovery\n      --jitter <duration>   Deterministic dispatch jitter for create (e.g. 30s, 5m)\n  -j, --json                Output results as JSON\n  -h, --help                Show this help message\n";
-export declare const VALIDATE_HELP_TEXT = "\nweft validate - Lint workflow registrations for design-time anti-patterns\n\nUsage: weft validate <entry.ts>... [options]\n\nArguments:\n  <entry.ts>...           One or more TypeScript modules or glob patterns that\n                          resolve to workflow registrations and/or activity\n                          definitions.\n\nOptions:\n  -j, --json              Output results as JSON\n  -h, --help              Show this help message\n\nExit codes:\n  0   No errors (warnings may be present)\n  1   One or more errors detected\n  2   Entry file could not be loaded (takes precedence over validation errors)\n\nJSON output:\n  { entries, valid, hasLoadErrors, hasValidationErrors }\n\nChecks performed:\n  unbounded-retry               Activity retry.maxAttempts is Infinity\n  stateful-without-compensator  Non-idempotent activity has no compensate fn\n";
+export declare const SCHEDULE_HELP_TEXT = "\nweft schedule - Manage recurring schedules\n\nUsage:\n  weft schedule list [options]\n  weft schedule create <workflowType> <cronExpression> [options]\n  weft schedule create <workflowType> --every <duration> [options]\n  weft schedule pause <scheduleId> [options]\n  weft schedule resume <scheduleId> [options]\n  weft schedule cancel <scheduleId> [options]\n\nProvide a cron expression positional OR an --every interval (e.g. \"30s\", \"1h\"),\nbut not both. Interval schedules fire one period after creation, then every\nperiod after that.\n\nOptions:\n  -d, --database <path>     Database file path (default: ./weft.db)\n  -s, --storage <backend>   Storage backend: sqlite, lmdb (default: sqlite)\n  -w, --workflows <path>    Path to workflow definitions module (required for create)\n      --every <duration>    Interval cadence for create (e.g. 30s, 5m, 1h); mutually exclusive with the cron positional\n      --input <json>        JSON input payload for create (default: null)\n      --id <id>             Custom schedule id for create\n      --overlap <policy>    Overlap policy: skip, queue, cancel-running, allow\n      --backfill            Run missed ticks on recovery\n      --jitter <duration>   Deterministic dispatch jitter for create (e.g. 30s, 5m)\n  -j, --json                Output results as JSON\n  -h, --help                Show this help message\n";
+export declare const VALIDATE_HELP_TEXT = "\nweft validate - Lint workflow definitions for design-time anti-patterns\n\nUsage: weft validate <entry.ts>... [options]\n\nArguments:\n  <entry.ts>...           One or more TypeScript modules or glob patterns that\n                          resolve to workflow definitions and/or activity\n                          definitions.\n\nOptions:\n  -j, --json              Output results as JSON\n  -h, --help              Show this help message\n\nExit codes:\n  0   No errors (warnings may be present)\n  1   One or more errors detected\n  2   Entry file could not be loaded (takes precedence over validation errors)\n\nJSON output:\n  { entries, valid, hasLoadErrors, hasValidationErrors }\n\nChecks performed:\n  unbounded-retry               Activity retry.maxAttempts is Infinity\n  stateful-without-compensator  Non-idempotent activity has no compensate fn\n";
 export declare const SERVER_HELP_TEXT = "\nweft server - Inspect a running server's health and operation surface\n\nUsage:\n  weft server health [options]\n  weft server info [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\n      --wait               (health) Poll until the server is reachable\n      --wait-timeout <ms>  (health) Maximum time to wait, in milliseconds (default: 30000)\n  -j, --json               Emit machine-readable JSON output\n  -q, --quiet              Suppress success/error text (use the exit code)\n  -h, --help               Show this help message\n\nExit codes:\n  0   Healthy\n  1   Unreachable / unhealthy\n  2   Connection error\n";
 export declare const WORKFLOW_HELP_TEXT = "\nweft workflow - List, inspect, start, signal, and cancel workflows on a server\n\nUsage:\n  weft workflow ls [--type <type>] [--status <status>] [--limit <n>] [options]\n  weft workflow get <workflow-id> [options]\n  weft workflow events <workflow-id> [options]\n  weft workflow start <workflow-type> [--input <json> | --input-file <path|->] [--id <id>] [options]\n  weft workflow cancel <workflow-id> [--yes] [--dry-run] [options]\n  weft workflow signal <workflow-id> <signal-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\n      --type <type>        (ls) Filter by workflow type\n      --status <status>    (ls) Filter by workflow status\n      --limit <n>          (ls) Maximum number of rows\n      --input <json>       (start/signal) JSON input payload\n      --input-file <path>  (start/signal) Read JSON input from a file, or '-' for stdin\n      --id <id>            (start) Explicit workflow id\n  -y, --yes                (cancel) Confirm without prompting\n      --dry-run            (cancel) Print affected count without cancelling\n  -j, --json               Emit machine-readable output (NDJSON for lists)\n  -q, --quiet              Print ids only / suppress success text\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 error\n  4   Operation unavailable on this server (version skew)\n";
 export declare const TAIL_HELP_TEXT = "\nweft tail - Stream a workflow's events as Server-Sent Events\n\nUsage:\n  weft tail <workflow-id> [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\n  -j, --json               Emit one JSON object per line (NDJSON)\n  -q, --quiet              Do not echo events to stdout\n  -h, --help               Show this help message\n\nPress Ctrl-C to stop tailing; the stream ends cleanly with exit code 0.\n";

package/dist/cli/help-text.js

@@ -10,7 +10,7 @@ Commands:
   schedule        Manage recurring schedules
   timeline        Inspect workflow timeline and replay history
   version:check   Check workflow version compatibility
-  validate        Lint workflow registrations for design-time anti-patterns
+  validate        Lint workflow definitions for design-time anti-patterns
   codegen         Generate TypeScript declarations from a registry snapshot
   api             Inspect and invoke catalog operations on a running server
   server          Inspect a running server's health and operation surface
@@ -117,7 +117,7 @@ period after that.
 Options:
   -d, --database <path>     Database file path (default: ./weft.db)
   -s, --storage <backend>   Storage backend: sqlite, lmdb (default: sqlite)
-  -w, --workflows <path>    Path to workflow registrations module (required for create)
+  -w, --workflows <path>    Path to workflow definitions module (required for create)
       --every <duration>    Interval cadence for create (e.g. 30s, 5m, 1h); mutually exclusive with the cron positional
       --input <json>        JSON input payload for create (default: null)
       --id <id>             Custom schedule id for create
@@ -127,13 +127,13 @@ Options:
   -j, --json                Output results as JSON
   -h, --help                Show this help message
 `, VALIDATE_HELP_TEXT = `
-weft validate - Lint workflow registrations for design-time anti-patterns
+weft validate - Lint workflow definitions for design-time anti-patterns
 
 Usage: weft validate <entry.ts>... [options]
 
 Arguments:
   <entry.ts>...           One or more TypeScript modules or glob patterns that
-                          resolve to workflow registrations and/or activity
+                          resolve to workflow definitions and/or activity
                           definitions.
 
 Options:

package/dist/cli/operation-catalog-snapshot.d.ts

@@ -1,5 +1,12 @@
-import type { OperationKind, TransportAvailability } from '../server/operation-catalog.ts';
-import type { FaultCode } from '../server/operation-fault.ts';
+import type { FaultCode } from '../core/fault-code.ts';
+import type { ErasedOperation, OperationKind, TransportAvailability } from '../server/operation-catalog.ts';
+import type { ParamSource, ResponseShape } from '../server/rest-binding.ts';
+export type CatalogRestBindingSnapshot = {
+    readonly method: string;
+    readonly path: string;
+    readonly inputSources: Readonly<Record<string, ParamSource>>;
+    readonly success: ResponseShape;
+};
 export type CatalogAccessSnapshot = {
     readonly kind: 'public';
 } | {
@@ -36,11 +43,13 @@ export type CatalogOperationSnapshot = {
     readonly inputSchema: Record<string, unknown>;
     readonly outputSchema: Record<string, unknown>;
     readonly eventSchema?: Record<string, unknown>;
+    /** Declarative REST route metadata for generated client transports. */
+    readonly rest?: CatalogRestBindingSnapshot;
 };
 export type CatalogSnapshot = {
     readonly generatedBy: 'weft catalog snapshot';
     readonly version: 1;
     readonly operations: ReadonlyArray<CatalogOperationSnapshot>;
 };
-export declare function createCatalogSnapshot(): CatalogSnapshot;
+export declare function createCatalogSnapshot(sourceOperations?: ReadonlyArray<ErasedOperation>): CatalogSnapshot;
 export declare function stringifyCatalogSnapshot(snapshot: CatalogSnapshot): string;

package/dist/cli/operation-catalog-snapshot.js

@@ -1,18 +1,19 @@
 import { definitionSchemaToJsonSchema } from "../core/types/definition-schema-to-json.js";
 import { compareStrings, normalizeJsonObject } from "../server/json-schema-utilities.js";
-import { createLiveOperationRegistry } from "../server/rest-bindings.js";
-export function createCatalogSnapshot() {
+import { createLiveOperationRegistry, createLiveRestBindings } from "../server/rest-bindings.js";
+export function createCatalogSnapshot(sourceOperations = createLiveOperationRegistry().list()) {
+  const restBindings = new Map(createLiveRestBindings().map((binding) => [binding.operationName, binding]));
   return {
     generatedBy: "weft catalog snapshot",
     version: 1,
-    operations: createLiveOperationRegistry().list().map(operationToSnapshot).toSorted((left, right) => compareStrings(left.name, right.name))
+    operations: sourceOperations.map((operation) => operationToSnapshot(operation, (operation.kind ?? "unary") === "unary" && operation.transports.http && !operation.transports.jsonRpcHttp && !operation.tags.includes("Storage") ? restBindings.get(operation.name) : void 0)).toSorted((left, right) => compareStrings(left.name, right.name))
   };
 }
 export function stringifyCatalogSnapshot(snapshot) {
   return `${JSON.stringify(snapshot, null, 2)}
 `;
 }
-function operationToSnapshot(operation) {
+function operationToSnapshot(operation, restBinding) {
   const eventSchema = operation.eventSchema;
   return {
     name: operation.name,
@@ -27,7 +28,15 @@ function operationToSnapshot(operation) {
     producibleFaults: [...operation.producibleFaults ?? []].toSorted(compareStrings),
     inputSchema: normalizeJsonObject(definitionSchemaToJsonSchema(operation.inputSchema, "input")),
     outputSchema: normalizeJsonObject(definitionSchemaToJsonSchema(operation.outputSchema, "output")),
-    ...eventSchema === void 0 ? {} : { eventSchema: normalizeJsonObject(definitionSchemaToJsonSchema(eventSchema, "output")) }
+    ...eventSchema === void 0 ? {} : { eventSchema: normalizeJsonObject(definitionSchemaToJsonSchema(eventSchema, "output")) },
+    ...restBinding === void 0 ? {} : {
+      rest: {
+        method: restBinding.method,
+        path: restBinding.path,
+        inputSources: Object.fromEntries(Object.entries(restBinding.inputSources).filter((entry) => entry[1] !== void 0)),
+        success: { ...restBinding.success }
+      }
+    }
   };
 }
 function parameterizedAccessToSnapshot(hint) {

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

@@ -33,6 +33,35 @@ export type WeftClientConnection = ConnectionOptions;
  * one generated surface instead of drifting apart.
  */
 export type CatalogTransport = (operationName: string, input: unknown) => Promise<unknown>;
+/** Generated metadata needed to map a typed client operation onto REST. */
+export type ClientRestOperationBinding = {
+    readonly method: string;
+    readonly path: string;
+    readonly inputSources: Readonly<Record<string, {
+        readonly kind: 'path';
+        readonly pathParam: string;
+    } | {
+        readonly kind: 'query';
+        readonly queryParam: string;
+        readonly repeating?: boolean;
+    } | {
+        readonly kind: 'header';
+        readonly headerName: string;
+    } | {
+        readonly kind: 'body';
+        readonly mediaType?: 'application/json';
+    } | {
+        readonly kind: 'body-field';
+        readonly bodyField: string;
+    }>>;
+    readonly success: {
+        readonly kind: 'json';
+        readonly status: number;
+    } | {
+        readonly kind: 'empty';
+        readonly status: number;
+    };
+};
 /**
  * Build a catalog client from a list of operation names and a transport. Each
  * name becomes a method that forwards its input through the transport, so the

package/dist/cli/schedule.js

@@ -51,10 +51,8 @@ function parseScheduleInput(input) {
 }
 async function registerScheduleWorkflows(engine, workflowsPath, loadRegistrationsFromModule) {
   const loaded = await loadRegistrationsFromModule(workflowsPath);
-  for (const [workflowType, registration] of Object.entries(loaded.registrations)) {
-    const definition = { ...registration, name: workflowType };
+  for (const definition of Object.values(loaded.registrations))
     registerOnRuntimeEngine(runtimeWorkflowEngine(engine), definition);
-  }
 }
 async function executeScheduleCreate(options, engine, loadRegistrationsFromModule) {
   const validationError = getScheduleCreateValidationError(options);

package/dist/cli/serve-registrations.d.ts

@@ -1,6 +1,6 @@
 import type { ActivityDefinition } from '../core/activity.ts';
 import type { Engine } from '../core/engine.ts';
-import type { WorkflowRegistration } from '../diagnostics/validate.ts';
+import type { WorkflowDefinition } from '../core/types.ts';
 /**
  * Convert a plain-object `ActivityDefinition` into a callable function that
  * satisfies the engine's `isActivityDefinition` check (which requires a
@@ -8,8 +8,8 @@ import type { WorkflowRegistration } from '../diagnostics/validate.ts';
  */
 export declare function toActivityCallable(definition: ActivityDefinition): (...args: unknown[]) => unknown;
 /**
- * Register a map of workflow registrations and a list of activity definitions
+ * Register a map of workflow definitions and a list of activity definitions
  * on an engine instance. Plain-object activities are normalized to callables
  * before registration.
  */
-export declare function registerModuleExports(engine: Engine, registrations: Record<string, WorkflowRegistration>, activities: ActivityDefinition[]): void;
+export declare function registerModuleExports(engine: Engine, registrations: Record<string, WorkflowDefinition>, activities: ActivityDefinition[]): void;

package/dist/cli/serve-registrations.js

@@ -13,8 +13,8 @@ export function toActivityCallable(definition) {
 }
 export function registerModuleExports(engine, registrations, activities) {
   const runtime = runtimeWorkflowEngine(engine);
-  for (const [workflowType, registration] of Object.entries(registrations))
-    registerOnRuntimeEngine(runtime, { ...registration, name: workflowType });
+  for (const definition of Object.values(registrations))
+    registerOnRuntimeEngine(runtime, definition);
   for (const activity of activities)
     if (typeof activity === "function")
       engine.register(activity);

package/dist/cli/shutdown.d.ts

@@ -0,0 +1,11 @@
+export declare const CLI_SHUTDOWN_SIGNALS: readonly ["SIGINT", "SIGTERM"];
+export type CliShutdownSignal = (typeof CLI_SHUTDOWN_SIGNALS)[number];
+export type CliShutdownDependencies = {
+    readonly stopServer: () => Promise<void>;
+    readonly removeRunLockfile: () => Promise<void>;
+    readonly disposeStorage: () => void;
+    readonly log: (message: string) => void;
+    readonly reportError: (message: string, error: unknown) => void;
+    readonly exit: (code: 0 | 1) => void;
+};
+export declare function createCliShutdownHandler(dependencies: CliShutdownDependencies): (signal: CliShutdownSignal) => Promise<void>;

package/dist/cli/shutdown.js

@@ -0,0 +1,25 @@
+export const CLI_SHUTDOWN_SIGNALS = ["SIGINT", "SIGTERM"];
+async function runCliShutdown(signal, dependencies) {
+  dependencies.log(`
+Received ${signal}; shutting down...`);
+  try {
+    await dependencies.stopServer();
+    try {
+      await dependencies.removeRunLockfile();
+    } catch (error) {
+      dependencies.reportError("[weft] Failed to remove run lockfile:", error);
+    }
+    dependencies.disposeStorage();
+    dependencies.exit(0);
+  } catch (error) {
+    dependencies.reportError("[weft] Shutdown error:", error);
+    dependencies.exit(1);
+  }
+}
+export function createCliShutdownHandler(dependencies) {
+  let shutdownPromise;
+  return (signal) => {
+    shutdownPromise ??= runCliShutdown(signal, dependencies);
+    return shutdownPromise;
+  };
+}

package/dist/cli/validate.d.ts

@@ -1,5 +1,5 @@
 import type { CommandOutput } from './types.ts';
-/** Validates workflow registration modules and reports load or design-time errors. */
+/** Validates workflow definition modules and reports load or design-time errors. */
 export declare function executeValidate(options: {
     entryPaths: string[];
     json: boolean;