@codemation/core 0.0.18 → 0.2.0

package/dist/workflowActivationPolicy-B8HzTk3o.js

@@ -0,0 +1,201 @@
+//#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, cursor, cursorOutput) {
+		this.wf = wf;
+		this.cursor = cursor;
+		this.cursorOutput = cursorOutput;
+	}
+	then(config) {
+		const next = this.wf.add(config);
+		this.wf.connect(this.cursor, next, this.cursorOutput);
+		return new ChainCursor(this.wf, next, "main");
+	}
+	when = ((arg1, steps, ...more) => {
+		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, this.cursor, port);
+			b.addBranch(list);
+			return b;
+		}
+		const branches = arg1;
+		const makeMerge = this.wf.options?.makeMergeNode;
+		if (!makeMerge) throw new Error("WorkflowBuilder is missing options.makeMergeNode (required for when({true,false}). Use createWorkflowBuilder from \"@codemation/core-nodes\".");
+		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(this.cursor, ref, port, "in");
+				else wfAny.connect(prev, ref, "main", "in");
+				prev = ref;
+			}
+			if (!prev) return {
+				end: this.cursor,
+				endOutput: port
+			};
+			return {
+				end: prev,
+				endOutput: "main"
+			};
+		};
+		const t = buildBranch("true", branches.true);
+		const f = buildBranch("false", branches.false);
+		const merge = wfAny.add(makeMerge("Merge (auto)"));
+		wfAny.connect(t.end, merge, t.endOutput, "true");
+		wfAny.connect(f.end, merge, f.endOutput, "false");
+		return new ChainCursor(this.wf, merge, "main");
+	});
+	build() {
+		return this.wf.build();
+	}
+};
+
+//#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, ref, "main");
+	}
+	start(config) {
+		const ref = this.add(config);
+		return new ChainCursor(this, ref, "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
+//#region src/contracts/workflowActivationPolicy.ts
+/** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */
+var AllWorkflowsActiveWorkflowActivationPolicy = class {
+	isActive(_workflowId) {
+		return true;
+	}
+};
+
+//#endregion
+export { WhenBuilder as a, ChainCursor as i, InMemoryRunEventBus as n, WorkflowBuilder as r, AllWorkflowsActiveWorkflowActivationPolicy as t };
+//# sourceMappingURL=workflowActivationPolicy-B8HzTk3o.js.map

package/dist/workflowActivationPolicy-B8HzTk3o.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowActivationPolicy-B8HzTk3o.js","names":["wf: WorkflowBuilder","from: NodeRef","branchPort: OutputPortKey","created: NodeRef[]","prev: NodeRef | null","port: OutputPortKey","wf: WorkflowBuilder","cursor: NodeRef","cursorOutput: OutputPortKey","port: OutputPortKey","prev: NodeRef | null","meta: { id: WorkflowId; name: string }","options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>","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","../src/contracts/workflowActivationPolicy.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  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 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 cursor: NodeRef,\n    private readonly cursorOutput: OutputPortKey,\n  ) {}\n\n  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    (this.wf as any).connect(this.cursor, next, this.cursorOutput);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, next, \"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 (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, this.cursor, port);\n      b.addBranch(list);\n      return b;\n    }\n\n    const branches = arg1;\n    const makeMerge = (this.wf as any).options?.makeMergeNode as ((name: string) => AnyRunnableNodeConfig) | undefined;\n    if (!makeMerge) {\n      throw new Error(\n        'WorkflowBuilder is missing options.makeMergeNode (required for when({true,false}). Use createWorkflowBuilder from \"@codemation/core-nodes\".',\n      );\n    }\n\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 }> => {\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(this.cursor, ref, port, \"in\");\n        else wfAny.connect(prev, ref, \"main\", \"in\");\n        prev = ref;\n      }\n      if (!prev) return { end: this.cursor, endOutput: port };\n      return { end: prev, endOutput: \"main\" };\n    };\n\n    const t = buildBranch(\"true\", branches.true);\n    const f = buildBranch(\"false\", branches.false);\n\n    const merge = wfAny.add(makeMerge(\"Merge (auto)\")) as NodeRef;\n    wfAny.connect(t.end, merge, t.endOutput, \"true\");\n    wfAny.connect(f.end, merge, f.endOutput, \"false\");\n\n    return new ChainCursor<TCurrentJson>(this.wf, merge, \"main\");\n  }) as ChainCursorWhenOverloads<TCurrentJson>;\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\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<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>,\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, ref, \"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, ref, \"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","import type { WorkflowId } from \"./workflowTypes\";\n\n/**\n * Host-controlled policy: when false, trigger {@link TriggerNode} setup is skipped and webhook routes\n * for that workflow are not registered (see engine trigger runtime + webhook matcher).\n */\nexport interface WorkflowActivationPolicy {\n  isActive(workflowId: WorkflowId): boolean;\n}\n\n/** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */\nexport class AllWorkflowsActiveWorkflowActivationPolicy implements WorkflowActivationPolicy {\n  isActive(_workflowId: WorkflowId): boolean {\n    return true;\n  }\n}\n"],"mappings":"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"}

package/dist/workflowActivationPolicy-BzyzXLa_.cjs

@@ -0,0 +1,231 @@
+
+//#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, cursor, cursorOutput) {
+		this.wf = wf;
+		this.cursor = cursor;
+		this.cursorOutput = cursorOutput;
+	}
+	then(config) {
+		const next = this.wf.add(config);
+		this.wf.connect(this.cursor, next, this.cursorOutput);
+		return new ChainCursor(this.wf, next, "main");
+	}
+	when = ((arg1, steps, ...more) => {
+		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, this.cursor, port);
+			b.addBranch(list);
+			return b;
+		}
+		const branches = arg1;
+		const makeMerge = this.wf.options?.makeMergeNode;
+		if (!makeMerge) throw new Error("WorkflowBuilder is missing options.makeMergeNode (required for when({true,false}). Use createWorkflowBuilder from \"@codemation/core-nodes\".");
+		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(this.cursor, ref, port, "in");
+				else wfAny.connect(prev, ref, "main", "in");
+				prev = ref;
+			}
+			if (!prev) return {
+				end: this.cursor,
+				endOutput: port
+			};
+			return {
+				end: prev,
+				endOutput: "main"
+			};
+		};
+		const t = buildBranch("true", branches.true);
+		const f = buildBranch("false", branches.false);
+		const merge = wfAny.add(makeMerge("Merge (auto)"));
+		wfAny.connect(t.end, merge, t.endOutput, "true");
+		wfAny.connect(f.end, merge, f.endOutput, "false");
+		return new ChainCursor(this.wf, merge, "main");
+	});
+	build() {
+		return this.wf.build();
+	}
+};
+
+//#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, ref, "main");
+	}
+	start(config) {
+		const ref = this.add(config);
+		return new ChainCursor(this, ref, "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
+//#region src/contracts/workflowActivationPolicy.ts
+/** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */
+var AllWorkflowsActiveWorkflowActivationPolicy = class {
+	isActive(_workflowId) {
+		return true;
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'AllWorkflowsActiveWorkflowActivationPolicy', {
+  enumerable: true,
+  get: function () {
+    return AllWorkflowsActiveWorkflowActivationPolicy;
+  }
+});
+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=workflowActivationPolicy-BzyzXLa_.cjs.map

package/dist/workflowActivationPolicy-BzyzXLa_.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowActivationPolicy-BzyzXLa_.cjs","names":["wf: WorkflowBuilder","from: NodeRef","branchPort: OutputPortKey","created: NodeRef[]","prev: NodeRef | null","port: OutputPortKey","wf: WorkflowBuilder","cursor: NodeRef","cursorOutput: OutputPortKey","port: OutputPortKey","prev: NodeRef | null","meta: { id: WorkflowId; name: string }","options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>","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","../src/contracts/workflowActivationPolicy.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  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 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 cursor: NodeRef,\n    private readonly cursorOutput: OutputPortKey,\n  ) {}\n\n  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    (this.wf as any).connect(this.cursor, next, this.cursorOutput);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, next, \"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 (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, this.cursor, port);\n      b.addBranch(list);\n      return b;\n    }\n\n    const branches = arg1;\n    const makeMerge = (this.wf as any).options?.makeMergeNode as ((name: string) => AnyRunnableNodeConfig) | undefined;\n    if (!makeMerge) {\n      throw new Error(\n        'WorkflowBuilder is missing options.makeMergeNode (required for when({true,false}). Use createWorkflowBuilder from \"@codemation/core-nodes\".',\n      );\n    }\n\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 }> => {\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(this.cursor, ref, port, \"in\");\n        else wfAny.connect(prev, ref, \"main\", \"in\");\n        prev = ref;\n      }\n      if (!prev) return { end: this.cursor, endOutput: port };\n      return { end: prev, endOutput: \"main\" };\n    };\n\n    const t = buildBranch(\"true\", branches.true);\n    const f = buildBranch(\"false\", branches.false);\n\n    const merge = wfAny.add(makeMerge(\"Merge (auto)\")) as NodeRef;\n    wfAny.connect(t.end, merge, t.endOutput, \"true\");\n    wfAny.connect(f.end, merge, f.endOutput, \"false\");\n\n    return new ChainCursor<TCurrentJson>(this.wf, merge, \"main\");\n  }) as ChainCursorWhenOverloads<TCurrentJson>;\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\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<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>,\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, ref, \"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, ref, \"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","import type { WorkflowId } from \"./workflowTypes\";\n\n/**\n * Host-controlled policy: when false, trigger {@link TriggerNode} setup is skipped and webhook routes\n * for that workflow are not registered (see engine trigger runtime + webhook matcher).\n */\nexport interface WorkflowActivationPolicy {\n  isActive(workflowId: WorkflowId): boolean;\n}\n\n/** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */\nexport class AllWorkflowsActiveWorkflowActivationPolicy implements WorkflowActivationPolicy {\n  isActive(_workflowId: WorkflowId): boolean {\n    return true;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemation/core",
-  "version": "0.0.18",
+  "version": "0.2.0",
   "publishConfig": {
     "access": "public"
   },

package/src/ai/AgentConnectionNodeCollector.ts

@@ -0,0 +1,99 @@
+import type { CredentialRequirement } from "../contracts/credentialTypes";
+import type { NodeConfigBase, NodeConnectionName, NodeId } from "../types";
+import { ConnectionNodeIdFactory } from "../workflow/definition/ConnectionNodeIdFactory";
+import { AgentConfigInspector } from "./AgentConfigInspectorFactory";
+import type { AgentNodeConfig, ToolConfig } from "./AiHost";
+import { NodeBackedToolConfig } from "./NodeBackedToolConfig";
+
+export type AgentConnectionNodeRole = "languageModel" | "tool" | "nestedAgent";
+
+export type AgentConnectionCredentialSource = Readonly<{
+  getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;
+}>;
+
+export type AgentConnectionNodeDescriptor = Readonly<{
+  nodeId: NodeId;
+  parentNodeId: NodeId;
+  connectionName: NodeConnectionName;
+  role: AgentConnectionNodeRole;
+  name: string;
+  typeName: string;
+  icon?: string;
+  credentialSource: AgentConnectionCredentialSource;
+}>;
+
+type AgentConnectionNodeCollectorApi = Readonly<{
+  collect(parentNodeId: NodeId, agentConfig: AgentNodeConfig<any, any>): ReadonlyArray<AgentConnectionNodeDescriptor>;
+}>;
+
+export const AgentConnectionNodeCollector: AgentConnectionNodeCollectorApi = new (class {
+  collect(parentNodeId: NodeId, agentConfig: AgentNodeConfig<any, any>): ReadonlyArray<AgentConnectionNodeDescriptor> {
+    const collected: AgentConnectionNodeDescriptor[] = [];
+    this.collectInto(parentNodeId, agentConfig, collected);
+    return collected;
+  }
+
+  private collectInto(
+    parentNodeId: NodeId,
+    agentConfig: AgentNodeConfig<any, any>,
+    collected: AgentConnectionNodeDescriptor[],
+  ): void {
+    collected.push({
+      nodeId: ConnectionNodeIdFactory.languageModelConnectionNodeId(parentNodeId),
+      parentNodeId,
+      connectionName: "llm",
+      role: "languageModel",
+      name: agentConfig.chatModel.presentation?.label ?? agentConfig.chatModel.name,
+      typeName: agentConfig.chatModel.name,
+      icon: agentConfig.chatModel.presentation?.icon,
+      credentialSource: agentConfig.chatModel,
+    });
+
+    for (const tool of agentConfig.tools ?? []) {
+      const toolNodeId = ConnectionNodeIdFactory.toolConnectionNodeId(parentNodeId, tool.name);
+      const isNestedAgent = this.isNodeBackedAgentTool(tool);
+      collected.push({
+        nodeId: toolNodeId,
+        parentNodeId,
+        connectionName: "tools",
+        role: isNestedAgent ? "nestedAgent" : "tool",
+        name: tool.presentation?.label ?? tool.name,
+        typeName: tool.name,
+        icon: tool.presentation?.icon,
+        credentialSource: tool,
+      });
+      this.collectNestedAgentTools(toolNodeId, tool, collected);
+    }
+  }
+
+  private collectNestedAgentTools(
+    toolNodeId: NodeId,
+    tool: ToolConfig,
+    collected: AgentConnectionNodeDescriptor[],
+  ): void {
+    if (!this.isNodeBackedAgentTool(tool)) {
+      return;
+    }
+    const innerAgent =
+      tool instanceof NodeBackedToolConfig ? tool.node : (tool as unknown as { node: AgentNodeConfig<any, any> }).node;
+    this.collectInto(toolNodeId, innerAgent, collected);
+  }
+
+  /**
+   * After JSON round-trip (persisted snapshots), tools are plain objects — `instanceof NodeBackedToolConfig` fails.
+   * Detect node-backed tools structurally via {@link NodeBackedToolConfig#toolKind}.
+   */
+  private isNodeBackedAgentTool(tool: ToolConfig): boolean {
+    if (tool instanceof NodeBackedToolConfig) {
+      return AgentConfigInspector.isAgentNodeConfig(tool.node);
+    }
+    if (!tool || typeof tool !== "object") {
+      return false;
+    }
+    const t = tool as unknown as Record<string, unknown>;
+    if (t.toolKind !== "nodeBacked") {
+      return false;
+    }
+    return AgentConfigInspector.isAgentNodeConfig(t.node as NodeConfigBase);
+  }
+})();

package/src/ai/AgentToolFactory.ts

@@ -1,5 +1,6 @@
-import type { RunnableNodeConfig } from "../types";
+import type { Item, RunnableNodeConfig } from "../types";
 import type { NodeBackedToolConfigOptions, ZodSchemaAny } from "./AiHost";
+import { AgentConfigInspector } from "./AgentConfigInspectorFactory";
 import { NodeBackedToolConfig } from "./NodeBackedToolConfig";
 
 class AgentToolFactoryImpl {
@@ -11,7 +12,42 @@ class AgentToolFactoryImpl {
     node: TNodeConfig,
     options: Readonly<{ name?: string } & NodeBackedToolConfigOptions<TNodeConfig, TInputSchema, TOutputSchema>>,
   ): NodeBackedToolConfig<TNodeConfig, TInputSchema, TOutputSchema> {
-    return new NodeBackedToolConfig(options.name ?? node.name ?? "tool", node, options);
+    return new NodeBackedToolConfig(
+      options.name ?? node.name ?? "tool",
+      node,
+      this.withDefaultAgentInputMapper(node, options),
+    );
+  }
+
+  private withDefaultAgentInputMapper<
+    TNodeConfig extends RunnableNodeConfig<any, any>,
+    TInputSchema extends ZodSchemaAny,
+    TOutputSchema extends ZodSchemaAny,
+  >(
+    node: TNodeConfig,
+    options: Readonly<{ name?: string } & NodeBackedToolConfigOptions<TNodeConfig, TInputSchema, TOutputSchema>>,
+  ): Readonly<{ name?: string } & NodeBackedToolConfigOptions<TNodeConfig, TInputSchema, TOutputSchema>> {
+    if (options.mapInput || !AgentConfigInspector.isAgentNodeConfig(node)) {
+      return options;
+    }
+    return {
+      ...options,
+      mapInput: ({ input, item }) => this.mergeAgentToolInputWithCurrentItem(input, item) as never,
+    };
+  }
+
+  private mergeAgentToolInputWithCurrentItem(input: unknown, item: Item): unknown {
+    if (!this.isMergeableRecord(input) || !this.isMergeableRecord(item.json)) {
+      return input;
+    }
+    return {
+      ...item.json,
+      ...input,
+    };
+  }
+
+  private isMergeableRecord(value: unknown): value is Record<string, unknown> {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
   }
 }
 

package/src/ai/AiHost.ts

@@ -207,7 +207,7 @@ export interface AgentNodeConfig<TInputJson = unknown, TOutputJson = unknown> ex
   readonly guardrails?: AgentGuardrailConfig;
 }
 
-export type AgentAttachmentRole = "languageModel" | "tool";
+export type AgentAttachmentRole = "languageModel" | "tool" | "nestedAgent";
 
 export { NodeBackedToolConfig } from "./NodeBackedToolConfig";
 export { AgentToolFactory } from "./AgentToolFactory";