@codemation/core 1.0.1 → 2.0.0

package/src/triggers/polling/PollingTriggerLogger.ts

@@ -0,0 +1,18 @@
+/**
+ * Minimal logger surface for the polling-trigger runtime.
+ * Hosts supply this via {@link EngineDeps.pollingTriggerLogger};
+ * when absent the runtime is silent.
+ */
+export interface PollingTriggerLogger {
+  info(message: string): void;
+  warn(message: string): void;
+  error(message: string, exception?: Error): void;
+  debug(message: string): void;
+}
+
+export class NoOpPollingTriggerLogger implements PollingTriggerLogger {
+  info(): void {}
+  warn(): void {}
+  error(): void {}
+  debug(): void {}
+}

package/src/triggers/polling/PollingTriggerRuntime.ts

@@ -0,0 +1,122 @@
+import type { Items, TriggerInstanceId, TriggerSetupStateRepository } from "../../types";
+import type { PollingTriggerLogger } from "./PollingTriggerLogger";
+
+export interface PollingRunCycleArgs<TState> {
+  previousState: TState | undefined;
+  signal: AbortSignal;
+}
+
+export interface PollingRunCycleResult<TState, TItem> {
+  items: Items<TItem>;
+  nextState: TState;
+}
+
+export interface PollingTriggerStartArgs<TState, TItem> {
+  trigger: TriggerInstanceId;
+  intervalMs: number;
+  seedState?: TState;
+  runCycle: (cycleCtx: PollingRunCycleArgs<TState>) => Promise<PollingRunCycleResult<TState, TItem>>;
+  emit: (items: Items) => Promise<void>;
+}
+
+/**
+ * Generic polling-trigger runtime. Owns the set-interval loop, overlap guard, and persistence.
+ * Constructed by {@link import("../../runtime/EngineFactory").EngineFactory} and exposed to plugin
+ * authors via {@link import("../../contracts/runtimeTypes").TriggerSetupContext}.polling.
+ */
+export class PollingTriggerRuntime {
+  private readonly activeTriggers = new Set<string>();
+  private readonly intervalsByTrigger = new Map<string, ReturnType<typeof setInterval>>();
+  private readonly busyTriggers = new Set<string>();
+
+  constructor(
+    private readonly triggerSetupStateRepository: TriggerSetupStateRepository,
+    private readonly logger: PollingTriggerLogger,
+  ) {}
+
+  async start<TState, TItem>(args: PollingTriggerStartArgs<TState, TItem>): Promise<TState | undefined> {
+    let first: TState | undefined;
+    try {
+      first = await this.runCycle(args, { seedState: args.seedState });
+    } catch (err: unknown) {
+      this.logError(`Polling trigger initial cycle failed for ${this.describe(args.trigger)}`, err);
+    }
+    this.ensureLoop(args);
+    return first;
+  }
+
+  async stop(trigger: TriggerInstanceId): Promise<void> {
+    const key = this.toKey(trigger);
+    const interval = this.intervalsByTrigger.get(key);
+    if (interval !== undefined) {
+      clearInterval(interval);
+      this.intervalsByTrigger.delete(key);
+    }
+    this.busyTriggers.delete(key);
+    this.activeTriggers.delete(key);
+    this.logger.debug(`Polling trigger stopped for ${this.describe(trigger)}`);
+  }
+
+  private ensureLoop<TState, TItem>(args: PollingTriggerStartArgs<TState, TItem>): void {
+    const key = this.toKey(args.trigger);
+    if (this.activeTriggers.has(key)) {
+      this.logger.debug(`Polling trigger already active for ${this.describe(args.trigger)}`);
+      return;
+    }
+    this.activeTriggers.add(key);
+    const intervalMs = Math.max(args.intervalMs, 25);
+    const interval = setInterval(() => {
+      void this.runCycle(args, { seedState: undefined }).catch((err: unknown) => {
+        this.logError(`Polling trigger cycle failed for ${this.describe(args.trigger)}`, err);
+      });
+    }, intervalMs);
+    this.intervalsByTrigger.set(key, interval);
+    this.logger.info(`Polling trigger started for ${this.describe(args.trigger)} (interval ${intervalMs}ms)`);
+  }
+
+  private async runCycle<TState, TItem>(
+    args: PollingTriggerStartArgs<TState, TItem>,
+    opts: { seedState: TState | undefined },
+  ): Promise<TState | undefined> {
+    const key = this.toKey(args.trigger);
+    if (this.busyTriggers.has(key)) {
+      this.logger.debug(`Polling trigger skipping overlapping tick for ${this.describe(args.trigger)}`);
+      return undefined;
+    }
+    this.busyTriggers.add(key);
+    try {
+      const loaded = await this.triggerSetupStateRepository.load(args.trigger);
+      const previousState = loaded !== undefined ? (loaded.state as TState | undefined) : opts.seedState;
+      const controller = new AbortController();
+      const { items, nextState } = await args.runCycle({ previousState, signal: controller.signal });
+      await this.triggerSetupStateRepository.save({
+        trigger: args.trigger,
+        updatedAt: new Date().toISOString(),
+        state: nextState as never,
+      });
+      if (items.length > 0) {
+        this.logger.info(`Polling trigger emitting ${items.length} item(s) for ${this.describe(args.trigger)}`);
+        await args.emit(items);
+      }
+      return nextState;
+    } finally {
+      this.busyTriggers.delete(key);
+    }
+  }
+
+  private toKey(trigger: TriggerInstanceId): string {
+    return `${trigger.workflowId}:${trigger.nodeId}`;
+  }
+
+  private describe(trigger: TriggerInstanceId): string {
+    return `${trigger.workflowId}.${trigger.nodeId}`;
+  }
+
+  private logError(message: string, error: unknown): void {
+    if (error instanceof Error) {
+      this.logger.error(message, error);
+      return;
+    }
+    this.logger.error(`${message}: ${String(error)}`);
+  }
+}

package/src/triggers/polling/index.ts

@@ -0,0 +1,5 @@
+export { PollingTriggerDedupWindow } from "./PollingTriggerDedupWindow";
+export { PollingTriggerRuntime } from "./PollingTriggerRuntime";
+export type { PollingTriggerLogger } from "./PollingTriggerLogger";
+export { NoOpPollingTriggerLogger } from "./PollingTriggerLogger";
+export type { PollingRunCycleArgs, PollingRunCycleResult, PollingTriggerStartArgs } from "./PollingTriggerRuntime";

package/src/types/index.ts

@@ -1,22 +1,25 @@
+// Re-export pure-type contracts first (available via @codemation/core/contracts subpath)
+export * from "../contracts";
+export type { CollectionStore, CollectionsContext } from "../contracts/collectionTypes";
+
+// Additional runtime exports not included in contracts (factory classes, DSL builders, etc.)
 export * from "../contracts/emitPorts";
 export * from "../contracts/itemMeta";
-export * from "../contracts/params";
 export * from "../contracts/itemExpr";
-export * from "../contracts/retryPolicySpec.types";
 export * from "../contracts/NoRetryPolicy";
 export * from "../contracts/RetryPolicy";
 export * from "../contracts/ExpRetryPolicy";
 export * from "../contracts/credentialTypes";
-export * from "../contracts/CostCatalogContract";
 export * from "../contracts/CostTrackingTelemetryContract";
 export * from "../contracts/NoOpCostTrackingTelemetry";
 export * from "../contracts/NoOpCostTrackingTelemetryFactory";
-export * from "../contracts/executionPersistenceContracts";
-export * from "../contracts/runtimeTypes";
-export * from "../contracts/telemetryTypes";
+export * from "../contracts/NoOpExecutionTelemetryFactory";
 export * from "../contracts/runFinishedAtFactory";
-export * from "../contracts/runTypes";
-export * from "../contracts/webhookTypes";
-export * from "../contracts/workflowTypes";
 export * from "../contracts/workflowActivationPolicy";
+// telemetryTypes and workflowTypes also have runtime exports (No-Op telemetry classes,
+// attribute-name registries, `nodeRef` factory, unique-symbol type tags) — `contracts.ts`
+// already re-exports them with `export type *` for the slim subpath; re-export with the
+// full `export *` here so back-compat for `@codemation/core` (root) consumers is preserved.
+export * from "../contracts/telemetryTypes";
+export * from "../contracts/workflowTypes";
 export * from "../workflow";

package/src/workflow/dsl/NodeIdSlugifier.ts

@@ -0,0 +1,18 @@
+/**
+ * Converts a human-readable node label into a stable, URL-safe identifier segment.
+ *
+ * Rules:
+ * - Lowercase the entire string.
+ * - Replace every run of characters outside `[a-z0-9]` with a single `-`.
+ * - Strip any leading or trailing `-` characters.
+ * - Return `""` for blank/empty input.
+ */
+export const NodeIdSlugifier = {
+  slugify(label: string): string {
+    if (!label) return "";
+    return label
+      .toLowerCase()
+      .replace(/[^a-z0-9]+/g, "-")
+      .replace(/^-+|-+$/g, "");
+  },
+};

package/src/workflow/dsl/WorkflowBuilder.ts

@@ -10,13 +10,22 @@ import type {
   WorkflowId,
 } from "../../types";
 
+import { AgentConfigInspector } from "../../ai/AgentConfigInspectorFactory";
+import { AgentConnectionNodeCollector } from "../../ai/AgentConnectionNodeCollector";
 import { ChainCursor } from "./ChainCursorResolver";
+import { NodeIdSlugifier } from "./NodeIdSlugifier";
+import { WorkflowDefinitionError } from "./WorkflowDefinitionError";
 import type { AnyRunnableNodeConfig, AnyTriggerNodeConfig } from "./workflowBuilderTypes";
 
+type NodeIdEntry = Readonly<{
+  nodeId: string;
+  tokenName: string;
+  label: string;
+}>;
+
 export class WorkflowBuilder {
   private readonly nodes: NodeDefinition[] = [];
   private readonly edges: WorkflowDefinition["edges"] = [];
-  private seq = 0;
 
   constructor(
     private readonly meta: { id: WorkflowId; name: string },
@@ -24,8 +33,7 @@ export class WorkflowBuilder {
   ) {}
 
   private add(config: NodeConfigBase): NodeRef {
-    const tokenName = typeof config.type === "function" ? config.type.name : String(config.type);
-    const id = config.id ?? `${tokenName}:${++this.seq}`;
+    const id = config.id ?? NodeIdSlugifier.slugify(config.name ?? "");
     this.nodes.push({ id, kind: config.kind, type: config.type, name: config.name, config });
     return { id, kind: config.kind, name: config.name };
   }
@@ -45,8 +53,68 @@ export class WorkflowBuilder {
   }
 
   build(): WorkflowDefinition {
+    this.validateNodeIds();
     return { ...this.meta, nodes: this.nodes, edges: this.edges };
   }
+
+  private validateNodeIds(): void {
+    const entries: NodeIdEntry[] = [];
+
+    for (const node of this.nodes) {
+      const tokenName = typeof node.type === "function" ? node.type.name : String(node.type);
+      entries.push({ nodeId: node.id, tokenName, label: node.name ?? "" });
+
+      if (AgentConfigInspector.isAgentNodeConfig(node.config)) {
+        for (const child of AgentConnectionNodeCollector.collect(node.id, node.config)) {
+          entries.push({ nodeId: child.nodeId, tokenName: child.typeName, label: child.name });
+        }
+      }
+    }
+
+    const emptyIds: NodeIdEntry[] = [];
+    const seenIds = new Map<string, NodeIdEntry>();
+    const duplicateIds: NodeIdEntry[] = [];
+
+    for (const entry of entries) {
+      if (!entry.nodeId) {
+        emptyIds.push(entry);
+        continue;
+      }
+      const existing = seenIds.get(entry.nodeId);
+      if (existing) {
+        if (!duplicateIds.includes(existing)) {
+          duplicateIds.push(existing);
+        }
+        duplicateIds.push(entry);
+      } else {
+        seenIds.set(entry.nodeId, entry);
+      }
+    }
+
+    if (emptyIds.length === 0 && duplicateIds.length === 0) {
+      return;
+    }
+
+    const lines: string[] = ["WorkflowBuilder.build() found invalid node ids:"];
+
+    if (emptyIds.length > 0) {
+      lines.push("  Empty ids (label is blank and no explicit id was given):");
+      for (const e of emptyIds) {
+        lines.push(`    - type "${e.tokenName}" label "${e.label}"`);
+      }
+    }
+
+    if (duplicateIds.length > 0) {
+      lines.push("  Duplicate ids:");
+      for (const e of duplicateIds) {
+        lines.push(`    - id "${e.nodeId}" type "${e.tokenName}" label "${e.label}"`);
+      }
+    }
+
+    lines.push("  Fix: set an explicit `id:` on each offending node config.");
+
+    throw new WorkflowDefinitionError(lines.join("\n"));
+  }
 }
 
 export { ChainCursor } from "./ChainCursorResolver";

package/src/workflow/dsl/WorkflowDefinitionError.ts

@@ -0,0 +1,15 @@
+/**
+ * Thrown by {@link WorkflowBuilder.build} when the workflow definition is structurally invalid.
+ *
+ * Common causes:
+ * - A node has an empty effective id (label is blank and no explicit `id` was given).
+ * - Two or more nodes share the same effective id (label slugs collide or explicit ids clash).
+ *
+ * Fix: provide an explicit `id:` on the offending node configs.
+ */
+export class WorkflowDefinitionError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "WorkflowDefinitionError";
+  }
+}

package/src/workflow/index.ts

@@ -1,4 +1,6 @@
 export { WorkflowBuilder } from "./dsl/WorkflowBuilder";
+export { WorkflowDefinitionError } from "./dsl/WorkflowDefinitionError";
+export { NodeIdSlugifier } from "./dsl/NodeIdSlugifier";
 export { ChainCursor } from "./dsl/ChainCursorResolver";
 export { WhenBuilder } from "./dsl/WhenBuilder";
 export * from "./dsl/workflowBuilderTypes";

package/dist/InMemoryRunEventBusRegistry-B0_C4OnP.cjs

@@ -1,262 +0,0 @@
-
-//#region src/workflow/dsl/WhenBuilder.ts
-var WhenBuilder = class WhenBuilder {
-	constructor(wf, from, branchPort) {
-		this.wf = wf;
-		this.from = from;
-		this.branchPort = branchPort;
-	}
-	addBranch(steps) {
-		const created = [];
-		let prev = null;
-		for (const cfg of steps) {
-			const ref = this.wf.add(cfg);
-			created.push(ref);
-			if (!prev) this.wf.connect(this.from, ref, this.branchPort, "in");
-			else this.wf.connect(prev, ref, "main", "in");
-			prev = ref;
-		}
-		for (const cfg of steps) {
-			const maybe = cfg;
-			if (!Array.isArray(maybe.upstreamRefs) || maybe.upstreamRefs.length === 0) continue;
-			maybe.upstreamRefs = maybe.upstreamRefs.map((r) => {
-				if (typeof r !== "string") return r;
-				const nodeId = created[parseInt(r.slice(1), 10)]?.id;
-				return nodeId ? { nodeId } : { nodeId: r };
-			});
-		}
-		return this;
-	}
-	when = (branch, steps, ...more) => {
-		const list = Array.isArray(steps) ? steps : [steps, ...more];
-		const port = branch ? "true" : "false";
-		const b = new WhenBuilder(this.wf, this.from, port);
-		b.addBranch(list);
-		return b;
-	};
-	build() {
-		return this.wf.build();
-	}
-};
-
-//#endregion
-//#region src/workflow/dsl/ChainCursorResolver.ts
-var ChainCursor = class ChainCursor {
-	constructor(wf, endpoints) {
-		this.wf = wf;
-		this.endpoints = endpoints;
-	}
-	then(config) {
-		const next = this.wf.add(config);
-		const inputPortHint = this.resolveSharedInputPortHint();
-		for (const e of this.endpoints) this.wf.connect(e.node, next, e.output);
-		return new ChainCursor(this.wf, [{
-			node: next,
-			output: "main",
-			...inputPortHint ? { inputPortHint } : {}
-		}]);
-	}
-	thenIntoInputHints(config) {
-		const next = this.wf.add(config);
-		for (const e of this.endpoints) this.wf.connect(e.node, next, e.output, e.inputPortHint ?? "in");
-		return new ChainCursor(this.wf, [{
-			node: next,
-			output: "main"
-		}]);
-	}
-	when = ((arg1, steps, ...more) => {
-		if (this.endpoints.length !== 1) throw new Error("ChainCursor.when(...) is only supported from a single cursor endpoint");
-		const cursor = this.endpoints[0].node;
-		if (typeof arg1 === "boolean") {
-			const list = Array.isArray(steps) ? steps : steps ? [steps, ...more] : more;
-			const port = arg1 ? "true" : "false";
-			const b = new WhenBuilder(this.wf, cursor, port);
-			b.addBranch(list);
-			return b;
-		}
-		const branches = arg1;
-		const wfAny = this.wf;
-		const buildBranch = (port, branchSteps) => {
-			const list = branchSteps ?? [];
-			let prev = null;
-			for (const cfg of list) {
-				const ref = wfAny.add(cfg);
-				if (!prev) wfAny.connect(cursor, ref, port, "in");
-				else wfAny.connect(prev, ref, "main", "in");
-				prev = ref;
-			}
-			if (!prev) return {
-				end: cursor,
-				endOutput: port,
-				inputPortHint: port
-			};
-			return {
-				end: prev,
-				endOutput: "main",
-				inputPortHint: port
-			};
-		};
-		const t = buildBranch("true", branches.true);
-		const f = buildBranch("false", branches.false);
-		return new ChainCursor(this.wf, [{
-			node: t.end,
-			output: t.endOutput,
-			inputPortHint: t.inputPortHint
-		}, {
-			node: f.end,
-			output: f.endOutput,
-			inputPortHint: f.inputPortHint
-		}]);
-	});
-	route(branches) {
-		if (this.endpoints.length !== 1) throw new Error("ChainCursor.route(...) is only supported from a single cursor endpoint");
-		const cursor = this.endpoints[0];
-		const nextEndpoints = [];
-		for (const [port, branchFactory] of Object.entries(branches)) {
-			if (!branchFactory) continue;
-			const builtBranch = branchFactory(new ChainCursor(this.wf, [{
-				node: cursor.node,
-				output: port,
-				inputPortHint: port
-			}]));
-			if (!builtBranch) continue;
-			nextEndpoints.push(...builtBranch.endpoints);
-		}
-		return new ChainCursor(this.wf, nextEndpoints);
-	}
-	build() {
-		return this.wf.build();
-	}
-	resolveSharedInputPortHint() {
-		const first = this.endpoints[0]?.inputPortHint;
-		if (!first) return;
-		return this.endpoints.every((endpoint) => endpoint.inputPortHint === first) ? first : void 0;
-	}
-};
-
-//#endregion
-//#region src/workflow/dsl/WorkflowBuilder.ts
-var WorkflowBuilder = class {
-	nodes = [];
-	edges = [];
-	seq = 0;
-	constructor(meta, options) {
-		this.meta = meta;
-		this.options = options;
-	}
-	add(config) {
-		const tokenName = typeof config.type === "function" ? config.type.name : String(config.type);
-		const id = config.id ?? `${tokenName}:${++this.seq}`;
-		this.nodes.push({
-			id,
-			kind: config.kind,
-			type: config.type,
-			name: config.name,
-			config
-		});
-		return {
-			id,
-			kind: config.kind,
-			name: config.name
-		};
-	}
-	connect(from, to, fromOutput = "main", toInput = "in") {
-		this.edges.push({
-			from: {
-				nodeId: from.id,
-				output: fromOutput
-			},
-			to: {
-				nodeId: to.id,
-				input: toInput
-			}
-		});
-	}
-	trigger(config) {
-		const ref = this.add(config);
-		return new ChainCursor(this, [{
-			node: ref,
-			output: "main"
-		}]);
-	}
-	start(config) {
-		const ref = this.add(config);
-		return new ChainCursor(this, [{
-			node: ref,
-			output: "main"
-		}]);
-	}
-	build() {
-		return {
-			...this.meta,
-			nodes: this.nodes,
-			edges: this.edges
-		};
-	}
-};
-
-//#endregion
-//#region src/events/InMemoryRunEventSubscription.ts
-var InMemoryRunEventSubscription = class {
-	constructor(onClose) {
-		this.onClose = onClose;
-	}
-	async close() {
-		this.onClose();
-	}
-};
-
-//#endregion
-//#region src/events/InMemoryRunEventBusRegistry.ts
-var InMemoryRunEventBus = class {
-	globalListeners = /* @__PURE__ */ new Set();
-	listenersByWorkflowId = /* @__PURE__ */ new Map();
-	async publish(event) {
-		for (const listener of this.globalListeners) listener(event);
-		for (const listener of this.listenersByWorkflowId.get(event.workflowId) ?? []) listener(event);
-	}
-	async subscribe(onEvent) {
-		this.globalListeners.add(onEvent);
-		return new InMemoryRunEventSubscription(() => {
-			this.globalListeners.delete(onEvent);
-		});
-	}
-	async subscribeToWorkflow(workflowId, onEvent) {
-		const existing = this.listenersByWorkflowId.get(workflowId) ?? /* @__PURE__ */ new Set();
-		existing.add(onEvent);
-		this.listenersByWorkflowId.set(workflowId, existing);
-		return new InMemoryRunEventSubscription(() => {
-			const listeners = this.listenersByWorkflowId.get(workflowId);
-			if (!listeners) return;
-			listeners.delete(onEvent);
-			if (listeners.size === 0) this.listenersByWorkflowId.delete(workflowId);
-		});
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'ChainCursor', {
-  enumerable: true,
-  get: function () {
-    return ChainCursor;
-  }
-});
-Object.defineProperty(exports, 'InMemoryRunEventBus', {
-  enumerable: true,
-  get: function () {
-    return InMemoryRunEventBus;
-  }
-});
-Object.defineProperty(exports, 'WhenBuilder', {
-  enumerable: true,
-  get: function () {
-    return WhenBuilder;
-  }
-});
-Object.defineProperty(exports, 'WorkflowBuilder', {
-  enumerable: true,
-  get: function () {
-    return WorkflowBuilder;
-  }
-});
-//# sourceMappingURL=InMemoryRunEventBusRegistry-B0_C4OnP.cjs.map

package/dist/InMemoryRunEventBusRegistry-B0_C4OnP.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"InMemoryRunEventBusRegistry-B0_C4OnP.cjs","names":["wf: WorkflowBuilder","from: NodeRef","branchPort: OutputPortKey","created: NodeRef[]","prev: NodeRef | null","port: OutputPortKey","wf: WorkflowBuilder","endpoints: ReadonlyArray<ChainCursorEndpoint>","port: OutputPortKey","prev: NodeRef | null","nextEndpoints: ChainCursorEndpoint[]","meta: { id: WorkflowId; name: string }","options?: Readonly<Record<string, never>>","onClose: () => void"],"sources":["../src/workflow/dsl/WhenBuilder.ts","../src/workflow/dsl/ChainCursorResolver.ts","../src/workflow/dsl/WorkflowBuilder.ts","../src/events/InMemoryRunEventSubscription.ts","../src/events/InMemoryRunEventBusRegistry.ts"],"sourcesContent":["import type { NodeId, NodeRef, OutputPortKey, UpstreamRefPlaceholder, WorkflowDefinition } from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport type { AnyRunnableNodeConfig, BooleanWhenOverloads, ValidStepSequence } from \"./workflowBuilderTypes\";\n\nexport class WhenBuilder<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly from: NodeRef,\n    private readonly branchPort: OutputPortKey,\n  ) {}\n\n  addBranch<TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(\n    steps: TSteps & ValidStepSequence<TCurrentJson, TSteps>,\n  ): this {\n    const created: NodeRef[] = [];\n\n    let prev: NodeRef | null = null;\n    for (const cfg of steps) {\n      const ref = (this.wf as any).add(cfg) as NodeRef;\n      created.push(ref);\n      if (!prev) (this.wf as any).connect(this.from, ref, this.branchPort, \"in\");\n      else (this.wf as any).connect(prev, ref, \"main\", \"in\");\n      prev = ref;\n    }\n\n    for (const cfg of steps) {\n      const maybe = cfg as unknown as { upstreamRefs?: Array<{ nodeId: NodeId } | UpstreamRefPlaceholder> };\n      if (!Array.isArray(maybe.upstreamRefs) || maybe.upstreamRefs.length === 0) continue;\n\n      maybe.upstreamRefs = maybe.upstreamRefs.map((r) => {\n        if (typeof r !== \"string\") return r;\n        const idx = parseInt(r.slice(1), 10);\n        const nodeId = created[idx]?.id;\n        return nodeId ? { nodeId } : { nodeId: r };\n      });\n    }\n\n    return this;\n  }\n\n  readonly when: BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> = (\n    branch: boolean,\n    steps: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> => {\n    const list = Array.isArray(steps) ? steps : [steps, ...more];\n    const port: OutputPortKey = branch ? \"true\" : \"false\";\n    const b = new WhenBuilder<TCurrentJson>(this.wf, this.from, port);\n    b.addBranch(list);\n    return b;\n  };\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  InputPortKey,\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeConfig,\n  RunnableNodeOutputJson,\n  WorkflowDefinition,\n} from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport { WhenBuilder } from \"./WhenBuilder\";\nimport type {\n  AnyRunnableNodeConfig,\n  BooleanWhenOverloads,\n  BranchOutputGuard,\n  BranchStepsArg,\n  StepSequenceOutput,\n} from \"./workflowBuilderTypes\";\n\ntype ChainCursorEndpoint = Readonly<{ node: NodeRef; output: OutputPortKey; inputPortHint?: InputPortKey }>;\n\ntype ChainCursorWhenOverloads<TCurrentJson> = BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> & {\n  <\n    TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n  >(\n    branches: Readonly<{\n      true?: TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TTrueSteps> : never;\n      false?: TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig>\n        ? BranchStepsArg<TCurrentJson, TFalseSteps>\n        : never;\n    }> &\n      BranchOutputGuard<TCurrentJson, TTrueSteps, TFalseSteps>,\n  ): ChainCursor<StepSequenceOutput<TCurrentJson, TTrueSteps>>;\n};\n\nexport class ChainCursor<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly endpoints: ReadonlyArray<ChainCursorEndpoint>,\n  ) {}\n\n  then<TOutputJson, TConfig extends RunnableNodeConfig<TCurrentJson, TOutputJson>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    const inputPortHint = this.resolveSharedInputPortHint();\n    for (const e of this.endpoints) {\n      (this.wf as any).connect(e.node, next, e.output);\n    }\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, [\n      { node: next, output: \"main\", ...(inputPortHint ? { inputPortHint } : {}) },\n    ]);\n  }\n\n  thenIntoInputHints<TOutputJson, TConfig extends RunnableNodeConfig<any, TOutputJson>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    for (const e of this.endpoints) {\n      (this.wf as any).connect(e.node, next, e.output, e.inputPortHint ?? \"in\");\n    }\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, [{ node: next, output: \"main\" }]);\n  }\n\n  readonly when: ChainCursorWhenOverloads<TCurrentJson> = ((\n    arg1:\n      | boolean\n      | Readonly<{ true?: ReadonlyArray<AnyRunnableNodeConfig>; false?: ReadonlyArray<AnyRunnableNodeConfig> }>,\n    steps?: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> | ChainCursor<TCurrentJson> => {\n    if (this.endpoints.length !== 1) {\n      throw new Error(\"ChainCursor.when(...) is only supported from a single cursor endpoint\");\n    }\n    const cursor = this.endpoints[0]!.node;\n\n    if (typeof arg1 === \"boolean\") {\n      const list = Array.isArray(steps) ? steps : steps ? [steps, ...more] : more;\n      const port: OutputPortKey = arg1 ? \"true\" : \"false\";\n      const b = new WhenBuilder<TCurrentJson>(this.wf, cursor, port);\n      b.addBranch(list);\n      return b;\n    }\n\n    const branches = arg1;\n    const wfAny = this.wf as any;\n\n    const buildBranch = (\n      port: OutputPortKey,\n      branchSteps: ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    ): Readonly<{ end: NodeRef; endOutput: OutputPortKey; inputPortHint: InputPortKey }> => {\n      const list = branchSteps ?? [];\n      let prev: NodeRef | null = null;\n      for (const cfg of list) {\n        const ref = wfAny.add(cfg) as NodeRef;\n        if (!prev) wfAny.connect(cursor, ref, port, \"in\");\n        else wfAny.connect(prev, ref, \"main\", \"in\");\n        prev = ref;\n      }\n      if (!prev) return { end: cursor, endOutput: port, inputPortHint: port };\n      return { end: prev, endOutput: \"main\", inputPortHint: port };\n    };\n\n    const t = buildBranch(\"true\", branches.true);\n    const f = buildBranch(\"false\", branches.false);\n    return new ChainCursor<TCurrentJson>(this.wf, [\n      { node: t.end, output: t.endOutput, inputPortHint: t.inputPortHint },\n      { node: f.end, output: f.endOutput, inputPortHint: f.inputPortHint },\n    ]);\n  }) as ChainCursorWhenOverloads<TCurrentJson>;\n\n  route<TNextJson>(\n    branches: Readonly<\n      Record<OutputPortKey, (branch: ChainCursor<TCurrentJson>) => ChainCursor<TNextJson> | undefined>\n    >,\n  ): ChainCursor<TNextJson> {\n    if (this.endpoints.length !== 1) {\n      throw new Error(\"ChainCursor.route(...) is only supported from a single cursor endpoint\");\n    }\n    const cursor = this.endpoints[0]!;\n    const nextEndpoints: ChainCursorEndpoint[] = [];\n    for (const [port, branchFactory] of Object.entries(branches)) {\n      if (!branchFactory) {\n        continue;\n      }\n      const branch = new ChainCursor<TCurrentJson>(this.wf, [{ node: cursor.node, output: port, inputPortHint: port }]);\n      const builtBranch = branchFactory(branch);\n      if (!builtBranch) {\n        continue;\n      }\n      nextEndpoints.push(...builtBranch.endpoints);\n    }\n    return new ChainCursor<TNextJson>(this.wf, nextEndpoints);\n  }\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n\n  private resolveSharedInputPortHint(): InputPortKey | undefined {\n    const first = this.endpoints[0]?.inputPortHint;\n    if (!first) {\n      return undefined;\n    }\n    return this.endpoints.every((endpoint) => endpoint.inputPortHint === first) ? first : undefined;\n  }\n}\n","import type {\n  InputPortKey,\n  NodeConfigBase,\n  NodeDefinition,\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeOutputJson,\n  TriggerNodeOutputJson,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"../../types\";\n\nimport { ChainCursor } from \"./ChainCursorResolver\";\nimport type { AnyRunnableNodeConfig, AnyTriggerNodeConfig } from \"./workflowBuilderTypes\";\n\nexport class WorkflowBuilder {\n  private readonly nodes: NodeDefinition[] = [];\n  private readonly edges: WorkflowDefinition[\"edges\"] = [];\n  private seq = 0;\n\n  constructor(\n    private readonly meta: { id: WorkflowId; name: string },\n    private readonly options?: Readonly<Record<string, never>>,\n  ) {}\n\n  private add(config: NodeConfigBase): NodeRef {\n    const tokenName = typeof config.type === \"function\" ? config.type.name : String(config.type);\n    const id = config.id ?? `${tokenName}:${++this.seq}`;\n    this.nodes.push({ id, kind: config.kind, type: config.type, name: config.name, config });\n    return { id, kind: config.kind, name: config.name };\n  }\n\n  private connect(from: NodeRef, to: NodeRef, fromOutput: OutputPortKey = \"main\", toInput: InputPortKey = \"in\"): void {\n    this.edges.push({ from: { nodeId: from.id, output: fromOutput }, to: { nodeId: to.id, input: toInput } });\n  }\n\n  trigger<TConfig extends AnyTriggerNodeConfig>(config: TConfig): ChainCursor<TriggerNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<TriggerNodeOutputJson<TConfig>>(this, [{ node: ref, output: \"main\" }]);\n  }\n\n  start<TConfig extends AnyRunnableNodeConfig>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this, [{ node: ref, output: \"main\" }]);\n  }\n\n  build(): WorkflowDefinition {\n    return { ...this.meta, nodes: this.nodes, edges: this.edges };\n  }\n}\n\nexport { ChainCursor } from \"./ChainCursorResolver\";\nexport { WhenBuilder } from \"./WhenBuilder\";\n","import type { RunEventSubscription } from \"./runEvents\";\n\nexport class InMemoryRunEventSubscription implements RunEventSubscription {\n  constructor(private readonly onClose: () => void) {}\n\n  async close(): Promise<void> {\n    this.onClose();\n  }\n}\n","import type { WorkflowId } from \"../types\";\n\nimport type { RunEvent, RunEventBus, RunEventSubscription } from \"./runEvents\";\n\nimport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n\nexport class InMemoryRunEventBus implements RunEventBus {\n  private readonly globalListeners = new Set<(event: RunEvent) => void>();\n  private readonly listenersByWorkflowId = new Map<WorkflowId, Set<(event: RunEvent) => void>>();\n\n  async publish(event: RunEvent): Promise<void> {\n    for (const listener of this.globalListeners) listener(event);\n    for (const listener of this.listenersByWorkflowId.get(event.workflowId) ?? []) listener(event);\n  }\n\n  async subscribe(onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    this.globalListeners.add(onEvent);\n    return new InMemoryRunEventSubscription(() => {\n      this.globalListeners.delete(onEvent);\n    });\n  }\n\n  async subscribeToWorkflow(workflowId: WorkflowId, onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    const existing = this.listenersByWorkflowId.get(workflowId) ?? new Set<(event: RunEvent) => void>();\n    existing.add(onEvent);\n    this.listenersByWorkflowId.set(workflowId, existing);\n\n    return new InMemoryRunEventSubscription(() => {\n      const listeners = this.listenersByWorkflowId.get(workflowId);\n      if (!listeners) return;\n      listeners.delete(onEvent);\n      if (listeners.size === 0) this.listenersByWorkflowId.delete(workflowId);\n    });\n  }\n}\n\nexport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n"],"mappings":"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"}