@lostgradient/weft 0.12.0 → 0.13.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/operation-catalog-snapshot.d.ts

@@ -1,5 +1,12 @@
-import type { OperationKind, TransportAvailability } from '../server/operation-catalog.ts';
+import type { ErasedOperation, OperationKind, TransportAvailability } from '../server/operation-catalog.ts';
 import type { FaultCode } from '../server/operation-fault.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/client/client-storage.d.ts

@@ -0,0 +1,24 @@
+import { type BatchOperation, type ConditionalBatchCondition, type ScanOptions, type Storage } from '../storage/interface.ts';
+/**
+ * Byte-oriented raw storage surface shared by local and HTTP clients.
+ *
+ * @example
+ * ```ts
+ * import { Engine, LocalClient, MemoryStorage, type WeftClientStorage } from '@lostgradient/weft';
+ *
+ * await using engine = new Engine({ storage: new MemoryStorage() });
+ * const client = new LocalClient(engine);
+ * const storage: WeftClientStorage = client.storage;
+ * await storage.put('example:key', new TextEncoder().encode('value'));
+ * ```
+ */
+export interface WeftClientStorage {
+    get(key: string): Promise<Uint8Array | null>;
+    put(key: string, value: Uint8Array): Promise<void>;
+    delete(key: string): Promise<void>;
+    scan(prefix: string, options?: ScanOptions): AsyncIterable<[string, Uint8Array]>;
+    batch(operations: BatchOperation[]): Promise<void>;
+    conditionalBatch(conditions: ConditionalBatchCondition[], operations: BatchOperation[]): Promise<boolean>;
+}
+/** Adapt an engine-owned storage backend without exposing adapter-only methods. */
+export declare function createLocalClientStorage(storage: Storage): WeftClientStorage;

package/dist/client/client-storage.js

@@ -0,0 +1,14 @@
+import {
+  storageBatch,
+  storageConditionalBatch
+} from "../storage/interface.js";
+export function createLocalClientStorage(storage) {
+  return {
+    get: (key) => storage.get(key),
+    put: (key, value) => storage.put(key, value),
+    delete: (key) => storage.delete(key),
+    scan: (prefix, options) => storage.scan(prefix, options),
+    batch: (operations) => storageBatch(storage, operations),
+    conditionalBatch: (conditions, operations) => storageConditionalBatch(storage, conditions, operations)
+  };
+}

package/dist/client/handle-delegation.d.ts

@@ -1,5 +1,5 @@
 import type { WeftEventMap } from '../core/events.ts';
-import type { QueryDefinition, ScheduleSpec, ScheduleSummary, SearchAttributeValue, SignalDefinition, SignalDeliveryOptions, UpdateDefinition } from '../core/types.ts';
+import type { QueryDefinition, ScheduleSpec, ScheduleSummary, ScheduleUpdateOptions, SearchAttributeValue, SignalDefinition, SignalDeliveryOptions, UpdateDefinition } from '../core/types.ts';
 import type { WorkflowEventTail } from './event-tail.ts';
 import type { ClientHandle, ClientScheduleHandle, StartOrSignalOutcome } from './interface.ts';
 export interface WorkflowHandleDelegationClient {
@@ -62,7 +62,7 @@ export interface ScheduleHandleDelegationClient {
     pauseSchedule(id: string): Promise<void>;
     resumeSchedule(id: string): Promise<void>;
     cancelSchedule(id: string): Promise<void>;
-    updateSchedule(id: string, newSpec: string | ScheduleSpec): Promise<void>;
+    updateSchedule(id: string, newSpec: string | ScheduleSpec, options?: ScheduleUpdateOptions): Promise<void>;
     getSchedule(id: string): Promise<ScheduleSummary | null>;
 }
 export declare abstract class ScheduleHandleDelegation<TClient extends ScheduleHandleDelegationClient = ScheduleHandleDelegationClient> implements ClientScheduleHandle {
@@ -72,7 +72,7 @@ export declare abstract class ScheduleHandleDelegation<TClient extends ScheduleH
     pause(): Promise<void>;
     resume(): Promise<void>;
     cancel(): Promise<void>;
-    update(newSpec: string | ScheduleSpec): Promise<void>;
+    update(newSpec: string | ScheduleSpec, options?: ScheduleUpdateOptions): Promise<void>;
     describe(): Promise<ScheduleSummary | null>;
     abstract [Symbol.dispose](): void;
 }

package/dist/client/handle-delegation.js

@@ -65,8 +65,8 @@ export class ScheduleHandleDelegation {
   async cancel() {
     return this.client.cancelSchedule(this.id);
   }
-  async update(newSpec) {
-    return this.client.updateSchedule(this.id, newSpec);
+  async update(newSpec, options) {
+    return this.client.updateSchedule(this.id, newSpec, options);
   }
   async describe() {
     return this.client.getSchedule(this.id);

package/dist/client/http-client-requests.d.ts

@@ -1,5 +1,5 @@
 import type { StoredStreamChunk } from '../core/context.ts';
-import type { BulkCancelResult, BulkDeleteResult, BulkRetryFailedResult, BulkSignalResult, BulkTagResult, CoordinatedUpdateResult, ForkOptions, ListFilter, PurgeResult, RetentionOverview, ReviewListEntry, ReviewListFilter, ScheduleSpec, ScheduleSummary, SearchAttributeValue, SignalDeliveryOptions, SubmitReviewOptions, WorkflowReplay, WorkflowState, WorkflowTimelineEntry } from '../core/types.ts';
+import type { BulkCancelResult, BulkDeleteResult, BulkRetryFailedResult, BulkSignalResult, BulkTagResult, CoordinatedUpdateResult, ForkOptions, ListFilter, PendingAsyncActivityListOptions, PendingAsyncActivityPage, PurgeResult, RetentionOverview, ReviewListEntry, ReviewListFilter, ScheduleSpec, ScheduleSummary, ScheduleUpdateOptions, SearchAttributeValue, SignalDeliveryOptions, SubmitReviewOptions, WorkflowReplay, WorkflowState, WorkflowTimelineEntry } from '../core/types.ts';
 import type { UpdateResult } from './interface.ts';
 export type HttpClientRequestContext = {
     readonly baseUrl: string;
@@ -37,6 +37,8 @@ export declare function signalWorkflowRequest(context: HttpClientRequestContext,
  * workflow with `result`. Mirrors `LocalClient.activity.complete` over HTTP.
  */
 export declare function completeAsyncActivityRequest(context: HttpClientRequestContext, token: string, result?: unknown): Promise<void>;
+/** List durable async activities awaiting completion for one workflow. */
+export declare function listPendingAsyncActivitiesRequest(context: HttpClientRequestContext, workflowId: string, options?: PendingAsyncActivityListOptions): Promise<PendingAsyncActivityPage>;
 /**
  * Fail a deferred ("async") activity by task token. A live `Error` cannot cross
  * the wire, so the error is reduced to `message` + `name` — exactly the fields
@@ -59,8 +61,8 @@ export declare function pauseScheduleRequest(context: HttpClientRequestContext,
 export declare function resumeScheduleRequest(context: HttpClientRequestContext, id: string): Promise<void>;
 /** Cancel a recurring schedule (`DELETE /v1/schedules/:id`). */
 export declare function cancelScheduleRequest(context: HttpClientRequestContext, id: string): Promise<void>;
-/** Update a schedule's recurrence specification (`PATCH /v1/schedules/:id`). */
-export declare function updateScheduleRequest(context: HttpClientRequestContext, id: string, newSpec: string | ScheduleSpec): Promise<void>;
+/** Update a schedule's cadence and mutable options (`PATCH /v1/schedules/:id`). */
+export declare function updateScheduleRequest(context: HttpClientRequestContext, id: string, newSpec: string | ScheduleSpec, options?: ScheduleUpdateOptions): Promise<void>;
 /**
  * Query a named read-only accessor on a workflow. A no-input query is a GET;
  * an input payload is sent as a POST body.

package/dist/client/http-client-requests.js

@@ -139,6 +139,15 @@ export async function completeAsyncActivityRequest(context, token, result) {
     body: JSON.stringify({ token, result })
   });
 }
+export async function listPendingAsyncActivitiesRequest(context, workflowId, options) {
+  const search = new URLSearchParams;
+  if (options?.limit !== void 0)
+    search.set("limit", String(options.limit));
+  if (options?.cursor !== void 0)
+    search.set("cursor", options.cursor);
+  const query = search.size > 0 ? `?${search.toString()}` : "";
+  return request(context.baseUrl, `/workflows/${encodeURIComponent(workflowId)}/pending-async-activities${query}`, context.headers);
+}
 export async function failAsyncActivityRequest(context, token, error) {
   const reduced = { message: error instanceof Error ? error.message : String(error) };
   if (error instanceof Error)
@@ -176,10 +185,19 @@ export function cancelScheduleRequest(context, id) {
     method: "DELETE"
   });
 }
-export function updateScheduleRequest(context, id, newSpec) {
+export function updateScheduleRequest(context, id, newSpec, options) {
+  const body = scheduleSpecToWireFields(newSpec);
+  if (options?.description !== void 0)
+    body.description = options.description;
+  if (options?.overlap !== void 0)
+    body.overlap = options.overlap;
+  if (options?.backfill !== void 0)
+    body.backfill = options.backfill;
+  if (options?.jitter !== void 0)
+    body.jitter = options.jitter;
   return request(context.baseUrl, `/schedules/${encodeURIComponent(id)}`, context.headers, {
     method: "PATCH",
-    body: JSON.stringify(scheduleSpecToWireFields(newSpec))
+    body: JSON.stringify(body)
   });
 }
 export async function queryWorkflowRequest(context, id, name, input) {

package/dist/client/http-client-storage.d.ts

@@ -0,0 +1,3 @@
+import type { WeftClientStorage } from './client-storage.ts';
+/** Build the raw-storage facade over the six specialized REST bindings. */
+export declare function createHttpClientStorage(baseUrl: string, headers: Record<string, string>): WeftClientStorage;