@orkestrel/workflow 0.0.6 → 0.0.7

package/dist/src/core/index.d.cts

@@ -1006,11 +1006,11 @@ export declare function parkSignal(signal: AbortSignal): Promise<void>;
  */
 export declare class Phase implements PhaseInterface {
     #private;
+    readonly description?: string;
     constructor(snapshot: PhaseSnapshot, workflow: WorkflowInterface, escalate: () => void, options?: PhaseOptions, bail?: boolean, functions?: WorkflowFunctions);
     get emitter(): EmitterInterface<PhaseEventMap>;
     get id(): string;
     get name(): string;
-    get description(): string | undefined;
     get context(): PhaseContext;
     get workflow(): WorkflowInterface;
     get bail(): boolean;
@@ -1985,7 +1985,7 @@ export declare interface RunnerUnit<TInput> {
  * }
  * ```
  */
-export declare class Scheduler implements SchedulerInterface {
+declare class Scheduler_2 implements SchedulerInterface {
     #private;
     /**
      * Yield control back to the host so other tasks (I/O, timers, rendering) can
@@ -2004,6 +2004,7 @@ export declare class Scheduler implements SchedulerInterface {
      */
     delay(ms: number, options?: SchedulerOptions): Promise<void>;
 }
+export { Scheduler_2 as Scheduler }
 
 /**
  * A cooperative host-yield primitive: a loop decides WHAT to do; the scheduler
@@ -2085,11 +2086,11 @@ export declare function success<T>(value: T): Success<T>;
  */
 export declare class Task implements TaskInterface {
     #private;
+    readonly description?: string;
     constructor(context: TaskContext, phase: PhaseInterface, workflow: WorkflowInterface, recompute: () => void, options?: TaskOptions, status?: TaskStatus, result?: TaskResult, run?: string, retries?: number, timeout?: number, handler?: WorkflowFunction);
     get emitter(): EmitterInterface<TaskEventMap>;
     get id(): string;
     get name(): string;
-    get description(): string | undefined;
     get context(): TaskContext;
     get phase(): PhaseInterface;
     get workflow(): WorkflowInterface;
@@ -2184,7 +2185,7 @@ export declare interface TaskContext extends WorkflowContext {
  * - **Event-free.** Like the runner `Controller`, the per-task handle carries no Emitter;
  *   observe the W-b entities' own emitters (`task.emitter` / `phase.emitter`) instead.
  */
-export declare class TaskController implements TaskControllerInterface {
+declare class TaskController_2 implements TaskControllerInterface {
     #private;
     readonly signal: AbortSignal;
     readonly input: Readonly<Record<string, unknown>>;
@@ -2193,6 +2194,7 @@ export declare class TaskController implements TaskControllerInterface {
     get aborted(): boolean;
     results(): readonly TaskResult[];
 }
+export { TaskController_2 as TaskController }
 
 /**
  * The per-task handle a {@link WorkflowFunction} receives — the running task's
@@ -2728,11 +2730,11 @@ export declare type UnitOutcome<TResult> = {
  */
 export declare class Workflow implements WorkflowInterface {
     #private;
+    readonly description?: string;
     constructor(snapshot: WorkflowSnapshot, options?: WorkflowOptions);
     get emitter(): EmitterInterface<WorkflowEventMap>;
     get id(): string;
     get name(): string;
-    get description(): string | undefined;
     get context(): WorkflowContext;
     get bail(): boolean;
     get paused(): boolean;

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

@@ -1006,11 +1006,11 @@ export declare function parkSignal(signal: AbortSignal): Promise<void>;
  */
 export declare class Phase implements PhaseInterface {
     #private;
+    readonly description?: string;
     constructor(snapshot: PhaseSnapshot, workflow: WorkflowInterface, escalate: () => void, options?: PhaseOptions, bail?: boolean, functions?: WorkflowFunctions);
     get emitter(): EmitterInterface<PhaseEventMap>;
     get id(): string;
     get name(): string;
-    get description(): string | undefined;
     get context(): PhaseContext;
     get workflow(): WorkflowInterface;
     get bail(): boolean;
@@ -1985,7 +1985,7 @@ export declare interface RunnerUnit<TInput> {
  * }
  * ```
  */
-export declare class Scheduler implements SchedulerInterface {
+declare class Scheduler_2 implements SchedulerInterface {
     #private;
     /**
      * Yield control back to the host so other tasks (I/O, timers, rendering) can
@@ -2004,6 +2004,7 @@ export declare class Scheduler implements SchedulerInterface {
      */
     delay(ms: number, options?: SchedulerOptions): Promise<void>;
 }
+export { Scheduler_2 as Scheduler }
 
 /**
  * A cooperative host-yield primitive: a loop decides WHAT to do; the scheduler
@@ -2085,11 +2086,11 @@ export declare function success<T>(value: T): Success<T>;
  */
 export declare class Task implements TaskInterface {
     #private;
+    readonly description?: string;
     constructor(context: TaskContext, phase: PhaseInterface, workflow: WorkflowInterface, recompute: () => void, options?: TaskOptions, status?: TaskStatus, result?: TaskResult, run?: string, retries?: number, timeout?: number, handler?: WorkflowFunction);
     get emitter(): EmitterInterface<TaskEventMap>;
     get id(): string;
     get name(): string;
-    get description(): string | undefined;
     get context(): TaskContext;
     get phase(): PhaseInterface;
     get workflow(): WorkflowInterface;
@@ -2184,7 +2185,7 @@ export declare interface TaskContext extends WorkflowContext {
  * - **Event-free.** Like the runner `Controller`, the per-task handle carries no Emitter;
  *   observe the W-b entities' own emitters (`task.emitter` / `phase.emitter`) instead.
  */
-export declare class TaskController implements TaskControllerInterface {
+declare class TaskController_2 implements TaskControllerInterface {
     #private;
     readonly signal: AbortSignal;
     readonly input: Readonly<Record<string, unknown>>;
@@ -2193,6 +2194,7 @@ export declare class TaskController implements TaskControllerInterface {
     get aborted(): boolean;
     results(): readonly TaskResult[];
 }
+export { TaskController_2 as TaskController }
 
 /**
  * The per-task handle a {@link WorkflowFunction} receives — the running task's
@@ -2728,11 +2730,11 @@ export declare type UnitOutcome<TResult> = {
  */
 export declare class Workflow implements WorkflowInterface {
     #private;
+    readonly description?: string;
     constructor(snapshot: WorkflowSnapshot, options?: WorkflowOptions);
     get emitter(): EmitterInterface<WorkflowEventMap>;
     get id(): string;
     get name(): string;
-    get description(): string | undefined;
     get context(): WorkflowContext;
     get bail(): boolean;
     get paused(): boolean;

package/dist/src/core/index.js

@@ -64,17 +64,18 @@ var Scheduler = class {
 	#sleep(ms, signal) {
 		if (signal?.aborted === true) return Promise.reject(signal.reason);
 		return new Promise((resolve, reject) => {
-			const onAbort = () => {
-				clearTimeout(handle);
-				reject(signal?.reason);
-			};
 			const handle = setTimeout(() => {
 				signal?.removeEventListener("abort", onAbort);
 				resolve();
 			}, ms);
+			const onAbort = this.#abort.bind(this, handle, reject, signal);
 			signal?.addEventListener("abort", onAbort, { once: true });
 		});
 	}
+	#abort(handle, reject, signal) {
+		clearTimeout(handle);
+		reject(signal?.reason);
+	}
 };
 //#endregion
 //#region src/core/constants.ts
@@ -200,7 +201,7 @@ var WorkflowError = class extends Error {
 		super(message);
 		this.name = "WorkflowError";
 		this.code = code;
-		this.context = context;
+		if (context !== void 0) this.context = context;
 	}
 };
 /**
@@ -660,16 +661,7 @@ function moveEntry(entries, key, index) {
 * @returns A deferred `promise` plus its `resolve` / `reject`
 */
 function createDeferred() {
-	let resolve = () => {};
-	let reject = () => {};
-	return {
-		promise: new Promise((res, rej) => {
-			resolve = res;
-			reject = rej;
-		}),
-		resolve,
-		reject
-	};
+	return Promise.withResolvers();
 }
 /**
 * Park until `signal` aborts — a promise-parked wait (AGENTS §21), never a timer or
@@ -983,7 +975,6 @@ var Task = class {
 	#status;
 	#result;
 	#name;
-	#description;
 	#run;
 	#retries;
 	#timeout;
@@ -995,13 +986,16 @@ var Task = class {
 		this.#recompute = recompute;
 		this.#metadata = options?.metadata ?? {};
 		this.#emitter = new Emitter({
-			on: options?.on,
-			error: options?.error
+			...options?.on === void 0 ? {} : { on: options.on },
+			...options?.error === void 0 ? {} : { error: options.error }
 		});
 		this.#status = status;
 		this.#result = result;
 		this.#name = context.name;
-		this.#description = context.description;
+		if (context.description !== void 0) Object.defineProperty(this, "description", {
+			configurable: true,
+			value: context.description
+		});
 		this.#run = run;
 		this.#retries = retries;
 		this.#timeout = timeout;
@@ -1016,9 +1010,6 @@ var Task = class {
 	get name() {
 		return this.#name;
 	}
-	get description() {
-		return this.#description;
-	}
 	get context() {
 		return this.#context;
 	}
@@ -1101,7 +1092,10 @@ var Task = class {
 			status: this.#status
 		});
 		if (value.name !== void 0) this.#name = value.name;
-		if (value.description !== void 0) this.#description = value.description;
+		if (value.description !== void 0) Object.defineProperty(this, "description", {
+			configurable: true,
+			value: value.description
+		});
 	}
 	snapshot() {
 		return {
@@ -1274,7 +1268,6 @@ var TaskManager = class {
 var Phase = class {
 	#id;
 	#name;
-	#description;
 	#workflow;
 	#escalateUp;
 	#tasks = new TaskManager();
@@ -1289,15 +1282,18 @@ var Phase = class {
 	constructor(snapshot, workflow, escalate, options, bail, functions) {
 		this.#id = snapshot.id;
 		this.#name = snapshot.name;
-		this.#description = snapshot.description;
+		if (snapshot.description !== void 0) Object.defineProperty(this, "description", {
+			configurable: true,
+			value: snapshot.description
+		});
 		this.#workflow = workflow;
 		this.#escalateUp = escalate;
 		this.#functions = functions;
 		this.#bail = bail ?? snapshot.bail;
 		this.#concurrency = snapshot.concurrency;
 		this.#emitter = new Emitter({
-			on: options?.on,
-			error: options?.error
+			...options?.on === void 0 ? {} : { on: options.on },
+			...options?.error === void 0 ? {} : { error: options.error }
 		});
 		for (const task of snapshot.tasks) this.#append(task, options);
 		this.#override = snapshot.override;
@@ -1314,14 +1310,11 @@ var Phase = class {
 	get name() {
 		return this.#name;
 	}
-	get description() {
-		return this.#description;
-	}
 	get context() {
 		return buildPhaseContext(this.#workflow.context, {
 			id: this.#id,
 			name: this.#name,
-			...this.#description === void 0 ? {} : { description: this.#description }
+			...this.description === void 0 ? {} : { description: this.description }
 		});
 	}
 	get workflow() {
@@ -1423,7 +1416,10 @@ var Phase = class {
 			status: this.status
 		});
 		if (value.name !== void 0) this.#name = value.name;
-		if (value.description !== void 0) this.#description = value.description;
+		if (value.description !== void 0) Object.defineProperty(this, "description", {
+			configurable: true,
+			value: value.description
+		});
 		if (value.concurrency !== void 0) this.#concurrency = value.concurrency;
 		if (value.bail !== void 0) this.#bail = value.bail;
 	}
@@ -1630,12 +1626,13 @@ var Workflow = class {
 	#destroyed;
 	constructor(snapshot, options) {
 		this.#context = buildWorkflowContext(snapshot);
+		if (snapshot.description !== void 0) Object.defineProperty(this, "description", { value: snapshot.description });
 		this.#bail = options?.bail ?? snapshot.bail;
 		this.#bailOverride = options?.bail;
 		this.#functions = options?.functions;
 		this.#emitter = new Emitter({
-			on: options?.on,
-			error: options?.error
+			...options?.on === void 0 ? {} : { on: options.on },
+			...options?.error === void 0 ? {} : { error: options.error }
 		});
 		this.#created = snapshot.created;
 		this.#updated = snapshot.updated;
@@ -1656,9 +1653,6 @@ var Workflow = class {
 	get name() {
 		return this.#context.name;
 	}
-	get description() {
-		return this.#context.description;
-	}
 	get context() {
 		return this.#context;
 	}
@@ -1895,7 +1889,7 @@ var WorkflowManager = class {
 		return [...this.#workflows.values()];
 	}
 	add(definition) {
-		const workflow = createWorkflow(definition, { functions: this.#functions });
+		const workflow = createWorkflow(definition, { ...this.#functions === void 0 ? {} : { functions: this.#functions } });
 		this.#workflows.set(workflow.id, workflow);
 		return workflow;
 	}
@@ -1905,7 +1899,7 @@ var WorkflowManager = class {
 		if (this.#store === void 0) return void 0;
 		const snapshot = await this.#store.get(id);
 		if (snapshot === void 0) return void 0;
-		const workflow = restoreWorkflow(snapshot, { functions: this.#functions });
+		const workflow = restoreWorkflow(snapshot, { ...this.#functions === void 0 ? {} : { functions: this.#functions } });
 		this.#workflows.set(workflow.id, workflow);
 		return workflow;
 	}
@@ -2055,14 +2049,14 @@ var Runner = class {
 		this.#handler = options.handler;
 		this.#entries = options.entries;
 		this.#emitter = new Emitter({
-			on: options?.on,
-			error: options?.error
+			...options.on === void 0 ? {} : { on: options.on },
+			...options.error === void 0 ? {} : { error: options.error }
 		});
 		this.#queue = createQueue({
-			handler: (unit, execution) => this.#dispatch(unit, execution),
-			concurrency: options.concurrency,
-			retries: options.retries,
-			timeout: options.timeout
+			handler: this.#dispatch.bind(this),
+			...options.concurrency === void 0 ? {} : { concurrency: options.concurrency },
+			...options.retries === void 0 ? {} : { retries: options.retries },
+			...options.timeout === void 0 ? {} : { timeout: options.timeout }
 		});
 	}
 	get emitter() {
@@ -2393,7 +2387,7 @@ var WorkflowRunner = class {
 		options?.budget?.start();
 		const runSignal = this.#fold(workflow, options, timeout);
 		const holder = { runner: void 0 };
-		const onCancel = () => holder.runner?.abort(runSignal.reason);
+		const onCancel = this.#abortActive.bind(this, holder, runSignal);
 		if (runSignal.aborted) onCancel();
 		else runSignal.addEventListener("abort", onCancel, { once: true });
 		try {
@@ -2441,12 +2435,7 @@ var WorkflowRunner = class {
 	}
 	async #runPhase(workflow, phase, runSignal, holder) {
 		const launched = /* @__PURE__ */ new Set();
-		let runner;
-		const onAdd = (task) => {
-			if (launched.has(task.id)) return;
-			launched.add(task.id);
-			runner?.spawn(task);
-		};
+		const onAdd = this.#spawnAdded.bind(this, launched, holder);
 		phase.emitter.on("add", onAdd);
 		try {
 			const tasks = phase.tasks.tasks();
@@ -2457,13 +2446,9 @@ var WorkflowRunner = class {
 			const attempts = /* @__PURE__ */ new Map();
 			const created = new Runner({
 				concurrency,
-				entries: (task) => ({
-					retries: task.retries,
-					timeout: task.timeout
-				}),
-				handler: (controller) => this.#runTask(workflow, controller.input, controller, runSignal, bail, attempts)
+				entries: this.#entry.bind(this),
+				handler: this.#runUnit.bind(this, workflow, runSignal, bail, attempts)
 			});
-			runner = created;
 			holder.runner = created;
 			try {
 				await created.execute(tasks);
@@ -2480,6 +2465,23 @@ var WorkflowRunner = class {
 			for (const task of phase.tasks.tasks()) this.#skip(task);
 		}
 	}
+	#abortActive(holder, runSignal) {
+		holder.runner?.abort(runSignal.reason);
+	}
+	#spawnAdded(launched, holder, task) {
+		if (launched.has(task.id)) return;
+		launched.add(task.id);
+		holder.runner?.spawn(task);
+	}
+	#entry(task) {
+		return {
+			...task.retries === void 0 ? {} : { retries: task.retries },
+			...task.timeout === void 0 ? {} : { timeout: task.timeout }
+		};
+	}
+	#runUnit(workflow, runSignal, bail, attempts, controller) {
+		return this.#runTask(workflow, controller.input, controller, runSignal, bail, attempts);
+	}
 	async #runTask(workflow, task, controller, runSignal, bail, attempts) {
 		const signal = this.#taskSignal(controller.signal, runSignal);
 		const attempt = (attempts.get(task.id) ?? 0) + 1;
@@ -2530,7 +2532,7 @@ var WorkflowRunner = class {
 		if (runSignal.aborted) return;
 		let onAbort;
 		const cancelled = new Promise((resolve) => {
-			onAbort = () => resolve();
+			onAbort = resolve.bind(void 0, void 0);
 			runSignal.addEventListener("abort", onAbort, { once: true });
 		});
 		try {
@@ -2547,7 +2549,7 @@ var WorkflowRunner = class {
 		if (options?.signal !== void 0) signals.push(options.signal);
 		if (timeout !== void 0) signals.push(timeout.signal);
 		if (options?.budget !== void 0) signals.push(options.budget.signal);
-		return signals.length === 1 ? signals[0] : AbortSignal.any(signals);
+		return signals.length === 1 ? workflow.signal : AbortSignal.any(signals);
 	}
 	#haltFrom(phases, index, workflow, runSignal) {
 		if (this.#cancelled(runSignal) && this.#stoppable(workflow)) workflow.stop();
@@ -2618,14 +2620,7 @@ var WorkflowRunner = class {
 * ```
 */
 function createWorkflowContract() {
-	const contract = createContract(workflowShape);
-	return {
-		schema: contract.schema,
-		is: contract.is,
-		generate: (random) => contract.generate(random),
-		parse: (value) => contract.parse(value),
-		explain: (value) => contract.explain(value)
-	};
+	return createContract(workflowShape);
 }
 /**
 * Build the live W-b entity tree from a {@link WorkflowDefinition} — the whole