@xopcai/xopc 0.0.103 → 0.0.104

package/dist/src/workflows/engine/workflow-engine.js

@@ -1,6 +1,5 @@
 import { workflowStepLabel } from "../../agent/workflow/step-labels.js";
-import { runWorkflow } from "../../agent/workflow/runtime.js";
-import "../runtime/script-runtime.js";
+import { createScriptWorkflowRuntime } from "../runtime/script-workflow-runtime.js";
 import { randomUUID } from "node:crypto";
 //#region src/workflows/engine/workflow-engine.ts
 var WorkflowEngine = class {
@@ -14,6 +13,7 @@ var WorkflowEngine = class {
 		let currentPhaseId;
 		let eventQueue = Promise.resolve();
 		const progressRecorders = /* @__PURE__ */ new Map();
+		const subagentSessionKeys = /* @__PURE__ */ new Map();
 		const run = {
 			id: runId,
 			definitionId: definition.id,
@@ -47,9 +47,13 @@ var WorkflowEngine = class {
 			return eventQueue;
 		};
 		await appendEvent("run_queued", { run }, createdAtMs);
+		await this.callHooks((hook) => hook.beforeRun?.({
+			definition,
+			run
+		}));
 		await appendEvent("run_started", { startedAtMs: Date.now() });
 		try {
-			const runtimeResult = await runWorkflow(definition.runtime.source, {
+			const runtimeResult = await (this.options.runtime ?? createScriptWorkflowRuntime()).run(definition.runtime.source, {
 				runner: this.options.runner,
 				resolveModelId: this.options.resolveModelId
 			}, {
@@ -72,27 +76,48 @@ var WorkflowEngine = class {
 					appendEvent("log_appended", { message });
 				},
 				onAgentQueued: (event) => {
+					const agentId = formatRuntimeAgentId(event.id);
+					const subagentSessionKey = this.options.subagentSessionKeyFactory?.({
+						runId,
+						agentId
+					}) ?? defaultSubagentSessionKey(runId, agentId);
+					subagentSessionKeys.set(event.id, subagentSessionKey);
 					const phaseId = event.phase ? phaseTitleToId.get(event.phase) ?? normalizePhaseId(event.phase) : currentPhaseId;
-					appendEvent("agent_queued", {
-						agentId: formatRuntimeAgentId(event.id),
+					this.callHooks((hook) => hook.beforeAgent?.({
+						runId,
+						agentId,
 						label: event.label,
 						phaseId,
 						prompt: event.prompt
+					}));
+					appendEvent("agent_queued", {
+						agentId,
+						label: event.label,
+						phaseId,
+						prompt: event.prompt,
+						sessionKey: subagentSessionKey
 					});
 				},
 				onAgentStart: (event) => {
 					appendEvent("agent_started", { agentId: formatRuntimeAgentId(event.id) });
 				},
 				onAgentEnd: (event) => {
+					const agentId = formatRuntimeAgentId(event.id);
 					const completedStatus = normalizeCompletedAgentStatus(event.status);
+					const resultPreview = previewWorkflowValue(event.result);
 					progressRecorders.get(event.id)?.completeOpenSteps(completedStatus === "done" ? "done" : "error");
 					progressRecorders.delete(event.id);
 					appendEvent("agent_completed", {
-						agentId: formatRuntimeAgentId(event.id),
+						agentId,
 						status: completedStatus,
-						resultPreview: previewWorkflowValue(event.result),
+						resultPreview,
 						error: completedStatus === "error" ? "Subagent failed" : void 0
-					});
+					}).then(() => this.callHooks((hook) => hook.afterAgent?.({
+						runId,
+						agentId,
+						status: completedStatus,
+						resultPreview
+					})).catch(() => void 0));
 				},
 				enhanceSubagentRun: (ctx) => {
 					const recorder = new AgentProgressRecorder({
@@ -100,22 +125,58 @@ var WorkflowEngine = class {
 						appendEvent
 					});
 					progressRecorders.set(ctx.id, recorder);
-					return { onProgress: (event) => recorder.onProgress(event) };
+					const agentId = formatRuntimeAgentId(ctx.id);
+					const sessionKey = subagentSessionKeys.get(ctx.id) ?? this.options.subagentSessionKeyFactory?.({
+						runId,
+						agentId
+					}) ?? defaultSubagentSessionKey(runId, agentId);
+					subagentSessionKeys.set(ctx.id, sessionKey);
+					return {
+						sessionKey,
+						sessionMetadata: {
+							parentSessionKey: this.options.parentSessionKey,
+							workflowRunId: runId,
+							workflowDefinitionId: definition.id,
+							workflowAgentId: agentId,
+							workflowAgentLabel: ctx.label
+						},
+						onProgress: (event) => recorder.onProgress(event)
+					};
 				}
 			});
 			await eventQueue;
 			if (currentPhaseId) await appendEvent("phase_completed", { phaseId: currentPhaseId });
 			await appendEvent("run_completed", { result: toWorkflowResultEnvelope(runtimeResult.result) });
+			await this.callHooks((hook) => hook.afterRun?.({
+				runId,
+				status: "succeeded"
+			}));
 		} catch (err) {
 			await eventQueue;
 			const error = toWorkflowRunError(err, options.signal?.aborted === true);
-			if (error.code === "cancelled") await appendEvent("run_cancelled", { reason: error.message });
-			else await appendEvent("run_failed", { error });
+			if (error.code === "cancelled") {
+				await appendEvent("run_cancelled", { reason: error.message });
+				await this.callHooks((hook) => hook.afterRun?.({
+					runId,
+					status: "cancelled"
+				}));
+			} else {
+				await appendEvent("run_failed", { error });
+				await this.callHooks((hook) => hook.afterRun?.({
+					runId,
+					status: "failed"
+				}));
+			}
 		}
 		const view = await this.options.runStore.readRunView(runId);
 		if (!view) throw new Error(`workflow run view was not created for ${runId}`);
 		return view;
 	}
+	async callHooks(call) {
+		for (const hook of this.options.hooks ?? []) try {
+			await call(hook);
+		} catch {}
+	}
 };
 var AgentProgressRecorder = class {
 	activeToolStepIds = /* @__PURE__ */ new Map();
@@ -243,6 +304,9 @@ function normalizePhaseId(title) {
 function formatRuntimeAgentId(id) {
 	return `agent-${id}`;
 }
+function defaultSubagentSessionKey(runId, agentId) {
+	return `workflow:${runId}:subagent:${agentId}`;
+}
 function normalizeCompletedAgentStatus(status) {
 	if (status === "done" || status === "error" || status === "skipped") return status;
 	return "error";

package/dist/src/workflows/engine/workflow-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-engine.js","names":["runWorkflowScript"],"sources":["../../../../src/workflows/engine/workflow-engine.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { WorkflowDefinition } from '../domain/definition.js';\nimport type { WorkflowEventEnvelope, WorkflowEventPayload, WorkflowEventType } from '../domain/event.js';\nimport type { WorkflowRun, WorkflowRunError, WorkflowRunMetadata, WorkflowRunSource, WorkflowRunView } from '../domain/run.js';\nimport type { WorkflowResultEnvelope } from '../domain/result.js';\nimport { WorkflowEventStore } from '../store/event-store.js';\nimport { WorkflowRunStore } from '../store/run-store.js';\nimport { runWorkflowScript } from '../runtime/script-runtime.js';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport { workflowStepLabel } from '../../agent/workflow/step-labels.js';\nimport type { SubagentProgressEvent } from '../../agent/workflow/types.js';\nimport type { WorkflowScriptSubagentRunner } from '../runtime/script-runtime.js';\n\nexport interface WorkflowEngineOptions {\n  cwd: string;\n  eventStore: WorkflowEventStore;\n  runStore: WorkflowRunStore;\n  runner: WorkflowScriptSubagentRunner;\n  onEventAppended?: (event: WorkflowEventEnvelope) => void;\n  onRunViewUpdated?: (view: WorkflowRunView) => void;\n  resolveModelId?: (modelId: string) => Model<Api>;\n}\n\nexport interface StartWorkflowRunOptions {\n  input?: unknown;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  goal?: string;\n  runId?: string;\n  signal?: AbortSignal;\n  concurrency?: number;\n  maxSubagents?: number;\n  tokenBudget?: number | null;\n}\n\nexport class WorkflowEngine {\n  constructor(private readonly options: WorkflowEngineOptions) {}\n\n  async startRun(definition: WorkflowDefinition, options: StartWorkflowRunOptions): Promise<WorkflowRunView> {\n    const runId = options.runId ?? randomUUID();\n    const createdAtMs = Date.now();\n    const phaseTitleToId = buildPhaseTitleToId(definition);\n    let currentPhaseId: string | undefined;\n    let eventQueue = Promise.resolve();\n    const progressRecorders = new Map<number, AgentProgressRecorder>();\n\n    const run: WorkflowRun = {\n      id: runId,\n      definitionId: definition.id,\n      definitionVersion: definition.version,\n      title: definition.title,\n      goal: options.goal ?? definition.description,\n      input: options.input ?? {},\n      status: 'queued',\n      source: options.source,\n      metadata: options.metadata,\n      metrics: {\n        agentCount: 0,\n        doneAgentCount: 0,\n        errorAgentCount: 0,\n        skippedAgentCount: 0,\n        artifactCount: 0,\n      },\n      createdAtMs,\n    };\n\n    const appendEvent = (type: WorkflowEventType, payload: WorkflowEventPayload, createdAtMsOverride?: number) => {\n      eventQueue = eventQueue\n        .then(() =>\n          this.options.eventStore.append({\n            runId,\n            type,\n            payload,\n            createdAtMs: createdAtMsOverride,\n          }),\n        )\n        .then(async (event) => {\n          this.options.onEventAppended?.(event);\n          const view = await this.options.runStore.rebuildRunView(runId);\n          if (view) {\n            this.options.onRunViewUpdated?.(view);\n          }\n        });\n      return eventQueue;\n    };\n\n    await appendEvent('run_queued', { run }, createdAtMs);\n    await appendEvent('run_started', { startedAtMs: Date.now() });\n\n    try {\n      const runtimeResult = await runWorkflowScript<unknown>(\n        definition.runtime.source,\n        {\n          runner: this.options.runner,\n          resolveModelId: this.options.resolveModelId,\n        },\n        {\n          cwd: this.options.cwd,\n          args: options.input,\n          signal: options.signal,\n          concurrency: options.concurrency ?? definition.defaults.concurrency,\n          maxSubagents: options.maxSubagents ?? definition.defaults.maxSubagents,\n          tokenBudget: options.tokenBudget,\n          onPhase: (title) => {\n            const nextPhaseId = phaseTitleToId.get(title) ?? normalizePhaseId(title);\n            if (currentPhaseId && currentPhaseId !== nextPhaseId) {\n              void appendEvent('phase_completed', { phaseId: currentPhaseId });\n            }\n            currentPhaseId = nextPhaseId;\n            void appendEvent('phase_started', { phaseId: nextPhaseId, title });\n          },\n          onLog: (message) => {\n            void appendEvent('log_appended', { message });\n          },\n          onAgentQueued: (event) => {\n            const phaseId = event.phase ? (phaseTitleToId.get(event.phase) ?? normalizePhaseId(event.phase)) : currentPhaseId;\n            void appendEvent('agent_queued', {\n              agentId: formatRuntimeAgentId(event.id),\n              label: event.label,\n              phaseId,\n              prompt: event.prompt,\n            });\n          },\n          onAgentStart: (event) => {\n            void appendEvent('agent_started', { agentId: formatRuntimeAgentId(event.id) });\n          },\n          onAgentEnd: (event) => {\n            const completedStatus = normalizeCompletedAgentStatus(event.status);\n            progressRecorders.get(event.id)?.completeOpenSteps(completedStatus === 'done' ? 'done' : 'error');\n            progressRecorders.delete(event.id);\n            void appendEvent('agent_completed', {\n              agentId: formatRuntimeAgentId(event.id),\n              status: completedStatus,\n              resultPreview: previewWorkflowValue(event.result),\n              error: completedStatus === 'error' ? 'Subagent failed' : undefined,\n            });\n          },\n          enhanceSubagentRun: (ctx) => {\n            const recorder = new AgentProgressRecorder({\n              agentId: formatRuntimeAgentId(ctx.id),\n              appendEvent,\n            });\n            progressRecorders.set(ctx.id, recorder);\n            return { onProgress: (event) => recorder.onProgress(event) };\n          },\n        },\n      );\n\n      await eventQueue;\n      if (currentPhaseId) {\n        await appendEvent('phase_completed', { phaseId: currentPhaseId });\n      }\n      await appendEvent('run_completed', { result: toWorkflowResultEnvelope(runtimeResult.result) });\n    } catch (err) {\n      await eventQueue;\n      const error = toWorkflowRunError(err, options.signal?.aborted === true);\n      if (error.code === 'cancelled') {\n        await appendEvent('run_cancelled', { reason: error.message });\n      } else {\n        await appendEvent('run_failed', { error });\n      }\n    }\n\n    const view = await this.options.runStore.readRunView(runId);\n    if (!view) {\n      throw new Error(`workflow run view was not created for ${runId}`);\n    }\n    return view;\n  }\n}\n\ntype AppendWorkflowEvent = (\n  type: WorkflowEventType,\n  payload: WorkflowEventPayload,\n  createdAtMsOverride?: number,\n) => Promise<void>;\n\nclass AgentProgressRecorder {\n  private readonly activeToolStepIds = new Map<string, string>();\n  private activeIterationStepId: string | null = null;\n  private activeThinkingStepId: string | null = null;\n  private activeLlmStepId: string | null = null;\n  private sequence = 0;\n\n  constructor(\n    private readonly options: {\n      agentId: string;\n      appendEvent: AppendWorkflowEvent;\n    },\n  ) {}\n\n  onProgress(event: SubagentProgressEvent): void {\n    switch (event.type) {\n      case 'tool_start':\n        this.startToolStep(event);\n        return;\n      case 'tool_end':\n        this.completeToolStep(event);\n        return;\n      case 'iteration':\n        this.replaceSingletonStep('iteration', this.buildIterationLabel(event.count, event.max), 'llm');\n        return;\n      case 'thinking_delta':\n        this.ensureSingletonStep('thinking', 'Thinking', 'thinking');\n        return;\n      case 'text_delta':\n        this.ensureSingletonStep('llm', 'Writing response', 'llm');\n        return;\n      default:\n        return;\n    }\n  }\n\n  completeOpenSteps(status: 'done' | 'error'): void {\n    for (const stepId of this.activeToolStepIds.values()) {\n      void this.options.appendEvent('agent_step_completed', {\n        agentId: this.options.agentId,\n        stepId,\n        status,\n      });\n    }\n    this.activeToolStepIds.clear();\n    this.completeSingletonStep('iteration', status);\n    this.completeSingletonStep('thinking', status);\n    this.completeSingletonStep('llm', status);\n  }\n\n  private startToolStep(event: Extract<SubagentProgressEvent, { type: 'tool_start' }>): void {\n    const stepId = this.nextStepId('tool');\n    const { label, detail } = workflowStepLabel(event.toolName, event.args);\n    this.activeToolStepIds.set(event.toolCallId, stepId);\n    void this.options.appendEvent('agent_step_started', {\n      agentId: this.options.agentId,\n      stepId,\n      label,\n      kind: 'tool',\n      toolName: event.toolName,\n      detail: detail ?? previewWorkflowValue(event.args),\n    });\n  }\n\n  private completeToolStep(event: Extract<SubagentProgressEvent, { type: 'tool_end' }>): void {\n    const stepId = this.activeToolStepIds.get(event.toolCallId);\n    if (!stepId) return;\n    this.activeToolStepIds.delete(event.toolCallId);\n    void this.options.appendEvent('agent_step_completed', {\n      agentId: this.options.agentId,\n      stepId,\n      status: event.isError ? 'error' : 'done',\n      resultPreview: event.resultPreview,\n      error: event.error,\n    });\n  }\n\n  private replaceSingletonStep(\n    slot: 'iteration' | 'thinking' | 'llm',\n    label: string,\n    kind: 'tool' | 'llm' | 'thinking',\n  ): void {\n    this.completeSingletonStep(slot, 'done');\n    this.ensureSingletonStep(slot, label, kind);\n  }\n\n  private ensureSingletonStep(\n    slot: 'iteration' | 'thinking' | 'llm',\n    label: string,\n    kind: 'tool' | 'llm' | 'thinking',\n  ): void {\n    if (this.getSingletonStepId(slot)) return;\n    const stepId = this.nextStepId(slot);\n    this.setSingletonStepId(slot, stepId);\n    void this.options.appendEvent('agent_step_started', {\n      agentId: this.options.agentId,\n      stepId,\n      label,\n      kind,\n    });\n  }\n\n  private completeSingletonStep(slot: 'iteration' | 'thinking' | 'llm', status: 'done' | 'error'): void {\n    const stepId = this.getSingletonStepId(slot);\n    if (!stepId) return;\n    this.setSingletonStepId(slot, null);\n    void this.options.appendEvent('agent_step_completed', {\n      agentId: this.options.agentId,\n      stepId,\n      status,\n    });\n  }\n\n  private getSingletonStepId(slot: 'iteration' | 'thinking' | 'llm'): string | null {\n    if (slot === 'iteration') return this.activeIterationStepId;\n    if (slot === 'thinking') return this.activeThinkingStepId;\n    return this.activeLlmStepId;\n  }\n\n  private setSingletonStepId(slot: 'iteration' | 'thinking' | 'llm', stepId: string | null): void {\n    if (slot === 'iteration') {\n      this.activeIterationStepId = stepId;\n      return;\n    }\n    if (slot === 'thinking') {\n      this.activeThinkingStepId = stepId;\n      return;\n    }\n    this.activeLlmStepId = stepId;\n  }\n\n  private buildIterationLabel(count: number, max: number): string {\n    if (max > 0) return `Iteration ${count}/${max}`;\n    return `Iteration ${count}`;\n  }\n\n  private nextStepId(kind: string): string {\n    this.sequence += 1;\n    return `${this.options.agentId}-${kind}-${this.sequence}`;\n  }\n}\n\nfunction buildPhaseTitleToId(definition: WorkflowDefinition): Map<string, string> {\n  const phaseTitleToId = new Map<string, string>();\n  for (const phase of definition.phases) {\n    phaseTitleToId.set(phase.title, phase.id);\n  }\n  return phaseTitleToId;\n}\n\nfunction normalizePhaseId(title: string): string {\n  const normalized = title\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n  return normalized || 'phase';\n}\n\nfunction formatRuntimeAgentId(id: number): string {\n  return `agent-${id}`;\n}\n\nfunction normalizeCompletedAgentStatus(status: string): 'done' | 'error' | 'skipped' {\n  if (status === 'done' || status === 'error' || status === 'skipped') {\n    return status;\n  }\n  return 'error';\n}\n\nfunction previewWorkflowValue(value: unknown): string | undefined {\n  if (value === null || value === undefined) {\n    return undefined;\n  }\n  if (typeof value === 'string') {\n    return truncate(value, 300);\n  }\n  try {\n    return truncate(JSON.stringify(value), 300);\n  } catch {\n    return truncate(String(value), 300);\n  }\n}\n\nfunction truncate(value: string, maxLength: number): string {\n  const trimmed = value.trim();\n  if (trimmed.length <= maxLength) {\n    return trimmed;\n  }\n  return `${trimmed.slice(0, maxLength - 1)}…`;\n}\n\nfunction toWorkflowResultEnvelope(value: unknown): WorkflowResultEnvelope {\n  if (isWorkflowResultEnvelope(value)) {\n    return value;\n  }\n  if (typeof value === 'string') {\n    return {\n      summary: truncate(value, 800),\n      sections: [{ kind: 'text', title: 'Result', content: value }],\n      raw: value,\n    };\n  }\n  return {\n    summary: 'Workflow completed.',\n    sections: [{ kind: 'json', title: 'Result', value }],\n    raw: value,\n  };\n}\n\nfunction isWorkflowResultEnvelope(value: unknown): value is WorkflowResultEnvelope {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return false;\n  }\n  const record = value as Partial<WorkflowResultEnvelope>;\n  return typeof record.summary === 'string' && Array.isArray(record.sections);\n}\n\nfunction toWorkflowRunError(err: unknown, wasAborted: boolean): WorkflowRunError {\n  const message = err instanceof Error ? err.message : String(err);\n  if (wasAborted || /aborted|cancelled/i.test(message)) {\n    return {\n      code: 'cancelled',\n      message: message || 'Workflow run cancelled',\n      recoverable: true,\n    };\n  }\n  if (/timeout/i.test(message)) {\n    return {\n      code: 'timeout',\n      message,\n      recoverable: true,\n    };\n  }\n  if (/quota/i.test(message)) {\n    return {\n      code: 'agent_quota_exceeded',\n      message,\n      recoverable: true,\n    };\n  }\n  return {\n    code: 'runtime_error',\n    message,\n    recoverable: false,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflow-engine.js","names":[],"sources":["../../../../src/workflows/engine/workflow-engine.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { WorkflowDefinition } from '../domain/definition.js';\nimport type { WorkflowEventEnvelope, WorkflowEventPayload, WorkflowEventType } from '../domain/event.js';\nimport type { WorkflowRun, WorkflowRunError, WorkflowRunMetadata, WorkflowRunSource, WorkflowRunView } from '../domain/run.js';\nimport type { WorkflowResultEnvelope } from '../domain/result.js';\nimport { WorkflowEventStore } from '../store/event-store.js';\nimport { WorkflowRunStore } from '../store/run-store.js';\nimport { createScriptWorkflowRuntime } from '../runtime/script-workflow-runtime.js';\nimport type { WorkflowRuntime } from '../runtime/workflow-runtime-port.js';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport { workflowStepLabel } from '../../agent/workflow/step-labels.js';\nimport type { SubagentProgressEvent } from '../../agent/workflow/types.js';\nimport type { WorkflowScriptSubagentRunner } from '../runtime/script-runtime.js';\n\nexport interface WorkflowEngineOptions {\n  cwd: string;\n  eventStore: WorkflowEventStore;\n  runStore: WorkflowRunStore;\n  runner: WorkflowScriptSubagentRunner;\n  runtime?: WorkflowRuntime;\n  hooks?: WorkflowEngineHook[];\n  subagentSessionKeyFactory?: (ctx: { runId: string; agentId: string }) => string;\n  parentSessionKey?: string;\n  onEventAppended?: (event: WorkflowEventEnvelope) => void;\n  onRunViewUpdated?: (view: WorkflowRunView) => void;\n  resolveModelId?: (modelId: string) => Model<Api>;\n}\n\nexport interface WorkflowEngineHook {\n  beforeRun?(ctx: WorkflowRunHookContext): Promise<void> | void;\n  beforeAgent?(ctx: WorkflowAgentHookContext): Promise<void> | void;\n  afterAgent?(ctx: WorkflowAgentCompletedHookContext): Promise<void> | void;\n  afterRun?(ctx: WorkflowRunCompletedHookContext): Promise<void> | void;\n}\n\nexport interface WorkflowRunHookContext {\n  definition: WorkflowDefinition;\n  run: WorkflowRun;\n}\n\nexport interface WorkflowAgentHookContext {\n  runId: string;\n  agentId: string;\n  label: string;\n  phaseId?: string;\n  prompt: string;\n}\n\nexport interface WorkflowAgentCompletedHookContext {\n  runId: string;\n  agentId: string;\n  status: 'done' | 'error' | 'skipped';\n  resultPreview?: string;\n}\n\nexport interface WorkflowRunCompletedHookContext {\n  runId: string;\n  status: 'succeeded' | 'failed' | 'cancelled';\n}\n\nexport interface StartWorkflowRunOptions {\n  input?: unknown;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  goal?: string;\n  runId?: string;\n  signal?: AbortSignal;\n  concurrency?: number;\n  maxSubagents?: number;\n  tokenBudget?: number | null;\n}\n\nexport class WorkflowEngine {\n  constructor(private readonly options: WorkflowEngineOptions) {}\n\n  async startRun(definition: WorkflowDefinition, options: StartWorkflowRunOptions): Promise<WorkflowRunView> {\n    const runId = options.runId ?? randomUUID();\n    const createdAtMs = Date.now();\n    const phaseTitleToId = buildPhaseTitleToId(definition);\n    let currentPhaseId: string | undefined;\n    let eventQueue = Promise.resolve();\n    const progressRecorders = new Map<number, AgentProgressRecorder>();\n    const subagentSessionKeys = new Map<number, string>();\n\n    const run: WorkflowRun = {\n      id: runId,\n      definitionId: definition.id,\n      definitionVersion: definition.version,\n      title: definition.title,\n      goal: options.goal ?? definition.description,\n      input: options.input ?? {},\n      status: 'queued',\n      source: options.source,\n      metadata: options.metadata,\n      metrics: {\n        agentCount: 0,\n        doneAgentCount: 0,\n        errorAgentCount: 0,\n        skippedAgentCount: 0,\n        artifactCount: 0,\n      },\n      createdAtMs,\n    };\n\n    const appendEvent = (type: WorkflowEventType, payload: WorkflowEventPayload, createdAtMsOverride?: number) => {\n      eventQueue = eventQueue\n        .then(() =>\n          this.options.eventStore.append({\n            runId,\n            type,\n            payload,\n            createdAtMs: createdAtMsOverride,\n          }),\n        )\n        .then(async (event) => {\n          this.options.onEventAppended?.(event);\n          const view = await this.options.runStore.rebuildRunView(runId);\n          if (view) {\n            this.options.onRunViewUpdated?.(view);\n          }\n        });\n      return eventQueue;\n    };\n\n    await appendEvent('run_queued', { run }, createdAtMs);\n    await this.callHooks((hook) => hook.beforeRun?.({ definition, run }));\n    await appendEvent('run_started', { startedAtMs: Date.now() });\n\n    try {\n      const runtime = this.options.runtime ?? createScriptWorkflowRuntime();\n      const runtimeResult = await runtime.run<unknown>(\n        definition.runtime.source,\n        {\n          runner: this.options.runner,\n          resolveModelId: this.options.resolveModelId,\n        },\n        {\n          cwd: this.options.cwd,\n          args: options.input,\n          signal: options.signal,\n          concurrency: options.concurrency ?? definition.defaults.concurrency,\n          maxSubagents: options.maxSubagents ?? definition.defaults.maxSubagents,\n          tokenBudget: options.tokenBudget,\n          onPhase: (title) => {\n            const nextPhaseId = phaseTitleToId.get(title) ?? normalizePhaseId(title);\n            if (currentPhaseId && currentPhaseId !== nextPhaseId) {\n              void appendEvent('phase_completed', { phaseId: currentPhaseId });\n            }\n            currentPhaseId = nextPhaseId;\n            void appendEvent('phase_started', { phaseId: nextPhaseId, title });\n          },\n          onLog: (message) => {\n            void appendEvent('log_appended', { message });\n          },\n          onAgentQueued: (event) => {\n            const agentId = formatRuntimeAgentId(event.id);\n            const subagentSessionKey = this.options.subagentSessionKeyFactory?.({ runId, agentId }) ?? defaultSubagentSessionKey(runId, agentId);\n            subagentSessionKeys.set(event.id, subagentSessionKey);\n            const phaseId = event.phase ? (phaseTitleToId.get(event.phase) ?? normalizePhaseId(event.phase)) : currentPhaseId;\n            void this.callHooks((hook) => hook.beforeAgent?.({\n              runId,\n              agentId,\n              label: event.label,\n              phaseId,\n              prompt: event.prompt,\n            }));\n            void appendEvent('agent_queued', {\n              agentId,\n              label: event.label,\n              phaseId,\n              prompt: event.prompt,\n              sessionKey: subagentSessionKey,\n            });\n          },\n          onAgentStart: (event) => {\n            void appendEvent('agent_started', { agentId: formatRuntimeAgentId(event.id) });\n          },\n          onAgentEnd: (event) => {\n            const agentId = formatRuntimeAgentId(event.id);\n            const completedStatus = normalizeCompletedAgentStatus(event.status);\n            const resultPreview = previewWorkflowValue(event.result);\n            progressRecorders.get(event.id)?.completeOpenSteps(completedStatus === 'done' ? 'done' : 'error');\n            progressRecorders.delete(event.id);\n            void appendEvent('agent_completed', {\n              agentId,\n              status: completedStatus,\n              resultPreview,\n              error: completedStatus === 'error' ? 'Subagent failed' : undefined,\n            }).then(() => this.callHooks((hook) => hook.afterAgent?.({\n              runId,\n              agentId,\n              status: completedStatus,\n              resultPreview,\n            })).catch(() => undefined));\n          },\n          enhanceSubagentRun: (ctx) => {\n            const recorder = new AgentProgressRecorder({\n              agentId: formatRuntimeAgentId(ctx.id),\n              appendEvent,\n            });\n            progressRecorders.set(ctx.id, recorder);\n            const agentId = formatRuntimeAgentId(ctx.id);\n            const sessionKey = subagentSessionKeys.get(ctx.id)\n              ?? this.options.subagentSessionKeyFactory?.({ runId, agentId })\n              ?? defaultSubagentSessionKey(runId, agentId);\n            subagentSessionKeys.set(ctx.id, sessionKey);\n            return {\n              sessionKey,\n              sessionMetadata: {\n                parentSessionKey: this.options.parentSessionKey,\n                workflowRunId: runId,\n                workflowDefinitionId: definition.id,\n                workflowAgentId: agentId,\n                workflowAgentLabel: ctx.label,\n              },\n              onProgress: (event) => recorder.onProgress(event),\n            };\n          },\n        },\n      );\n\n      await eventQueue;\n      if (currentPhaseId) {\n        await appendEvent('phase_completed', { phaseId: currentPhaseId });\n      }\n      await appendEvent('run_completed', { result: toWorkflowResultEnvelope(runtimeResult.result) });\n      await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'succeeded' }));\n    } catch (err) {\n      await eventQueue;\n      const error = toWorkflowRunError(err, options.signal?.aborted === true);\n      if (error.code === 'cancelled') {\n        await appendEvent('run_cancelled', { reason: error.message });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'cancelled' }));\n      } else {\n        await appendEvent('run_failed', { error });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'failed' }));\n      }\n    }\n\n    const view = await this.options.runStore.readRunView(runId);\n    if (!view) {\n      throw new Error(`workflow run view was not created for ${runId}`);\n    }\n    return view;\n  }\n\n  private async callHooks(call: (hook: WorkflowEngineHook) => Promise<void> | void | undefined): Promise<void> {\n    for (const hook of this.options.hooks ?? []) {\n      try {\n        await call(hook);\n      } catch {\n        // Hooks are extension points; workflow execution remains authoritative.\n      }\n    }\n  }\n}\n\ntype AppendWorkflowEvent = (\n  type: WorkflowEventType,\n  payload: WorkflowEventPayload,\n  createdAtMsOverride?: number,\n) => Promise<void>;\n\nclass AgentProgressRecorder {\n  private readonly activeToolStepIds = new Map<string, string>();\n  private activeIterationStepId: string | null = null;\n  private activeThinkingStepId: string | null = null;\n  private activeLlmStepId: string | null = null;\n  private sequence = 0;\n\n  constructor(\n    private readonly options: {\n      agentId: string;\n      appendEvent: AppendWorkflowEvent;\n    },\n  ) {}\n\n  onProgress(event: SubagentProgressEvent): void {\n    switch (event.type) {\n      case 'tool_start':\n        this.startToolStep(event);\n        return;\n      case 'tool_end':\n        this.completeToolStep(event);\n        return;\n      case 'iteration':\n        this.replaceSingletonStep('iteration', this.buildIterationLabel(event.count, event.max), 'llm');\n        return;\n      case 'thinking_delta':\n        this.ensureSingletonStep('thinking', 'Thinking', 'thinking');\n        return;\n      case 'text_delta':\n        this.ensureSingletonStep('llm', 'Writing response', 'llm');\n        return;\n      default:\n        return;\n    }\n  }\n\n  completeOpenSteps(status: 'done' | 'error'): void {\n    for (const stepId of this.activeToolStepIds.values()) {\n      void this.options.appendEvent('agent_step_completed', {\n        agentId: this.options.agentId,\n        stepId,\n        status,\n      });\n    }\n    this.activeToolStepIds.clear();\n    this.completeSingletonStep('iteration', status);\n    this.completeSingletonStep('thinking', status);\n    this.completeSingletonStep('llm', status);\n  }\n\n  private startToolStep(event: Extract<SubagentProgressEvent, { type: 'tool_start' }>): void {\n    const stepId = this.nextStepId('tool');\n    const { label, detail } = workflowStepLabel(event.toolName, event.args);\n    this.activeToolStepIds.set(event.toolCallId, stepId);\n    void this.options.appendEvent('agent_step_started', {\n      agentId: this.options.agentId,\n      stepId,\n      label,\n      kind: 'tool',\n      toolName: event.toolName,\n      detail: detail ?? previewWorkflowValue(event.args),\n    });\n  }\n\n  private completeToolStep(event: Extract<SubagentProgressEvent, { type: 'tool_end' }>): void {\n    const stepId = this.activeToolStepIds.get(event.toolCallId);\n    if (!stepId) return;\n    this.activeToolStepIds.delete(event.toolCallId);\n    void this.options.appendEvent('agent_step_completed', {\n      agentId: this.options.agentId,\n      stepId,\n      status: event.isError ? 'error' : 'done',\n      resultPreview: event.resultPreview,\n      error: event.error,\n    });\n  }\n\n  private replaceSingletonStep(\n    slot: 'iteration' | 'thinking' | 'llm',\n    label: string,\n    kind: 'tool' | 'llm' | 'thinking',\n  ): void {\n    this.completeSingletonStep(slot, 'done');\n    this.ensureSingletonStep(slot, label, kind);\n  }\n\n  private ensureSingletonStep(\n    slot: 'iteration' | 'thinking' | 'llm',\n    label: string,\n    kind: 'tool' | 'llm' | 'thinking',\n  ): void {\n    if (this.getSingletonStepId(slot)) return;\n    const stepId = this.nextStepId(slot);\n    this.setSingletonStepId(slot, stepId);\n    void this.options.appendEvent('agent_step_started', {\n      agentId: this.options.agentId,\n      stepId,\n      label,\n      kind,\n    });\n  }\n\n  private completeSingletonStep(slot: 'iteration' | 'thinking' | 'llm', status: 'done' | 'error'): void {\n    const stepId = this.getSingletonStepId(slot);\n    if (!stepId) return;\n    this.setSingletonStepId(slot, null);\n    void this.options.appendEvent('agent_step_completed', {\n      agentId: this.options.agentId,\n      stepId,\n      status,\n    });\n  }\n\n  private getSingletonStepId(slot: 'iteration' | 'thinking' | 'llm'): string | null {\n    if (slot === 'iteration') return this.activeIterationStepId;\n    if (slot === 'thinking') return this.activeThinkingStepId;\n    return this.activeLlmStepId;\n  }\n\n  private setSingletonStepId(slot: 'iteration' | 'thinking' | 'llm', stepId: string | null): void {\n    if (slot === 'iteration') {\n      this.activeIterationStepId = stepId;\n      return;\n    }\n    if (slot === 'thinking') {\n      this.activeThinkingStepId = stepId;\n      return;\n    }\n    this.activeLlmStepId = stepId;\n  }\n\n  private buildIterationLabel(count: number, max: number): string {\n    if (max > 0) return `Iteration ${count}/${max}`;\n    return `Iteration ${count}`;\n  }\n\n  private nextStepId(kind: string): string {\n    this.sequence += 1;\n    return `${this.options.agentId}-${kind}-${this.sequence}`;\n  }\n}\n\nfunction buildPhaseTitleToId(definition: WorkflowDefinition): Map<string, string> {\n  const phaseTitleToId = new Map<string, string>();\n  for (const phase of definition.phases) {\n    phaseTitleToId.set(phase.title, phase.id);\n  }\n  return phaseTitleToId;\n}\n\nfunction normalizePhaseId(title: string): string {\n  const normalized = title\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n  return normalized || 'phase';\n}\n\nfunction formatRuntimeAgentId(id: number): string {\n  return `agent-${id}`;\n}\n\nfunction defaultSubagentSessionKey(runId: string, agentId: string): string {\n  return `workflow:${runId}:subagent:${agentId}`;\n}\n\nfunction normalizeCompletedAgentStatus(status: string): 'done' | 'error' | 'skipped' {\n  if (status === 'done' || status === 'error' || status === 'skipped') {\n    return status;\n  }\n  return 'error';\n}\n\nfunction previewWorkflowValue(value: unknown): string | undefined {\n  if (value === null || value === undefined) {\n    return undefined;\n  }\n  if (typeof value === 'string') {\n    return truncate(value, 300);\n  }\n  try {\n    return truncate(JSON.stringify(value), 300);\n  } catch {\n    return truncate(String(value), 300);\n  }\n}\n\nfunction truncate(value: string, maxLength: number): string {\n  const trimmed = value.trim();\n  if (trimmed.length <= maxLength) {\n    return trimmed;\n  }\n  return `${trimmed.slice(0, maxLength - 1)}…`;\n}\n\nfunction toWorkflowResultEnvelope(value: unknown): WorkflowResultEnvelope {\n  if (isWorkflowResultEnvelope(value)) {\n    return value;\n  }\n  if (typeof value === 'string') {\n    return {\n      summary: truncate(value, 800),\n      sections: [{ kind: 'text', title: 'Result', content: value }],\n      raw: value,\n    };\n  }\n  return {\n    summary: 'Workflow completed.',\n    sections: [{ kind: 'json', title: 'Result', value }],\n    raw: value,\n  };\n}\n\nfunction isWorkflowResultEnvelope(value: unknown): value is WorkflowResultEnvelope {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return false;\n  }\n  const record = value as Partial<WorkflowResultEnvelope>;\n  return typeof record.summary === 'string' && Array.isArray(record.sections);\n}\n\nfunction toWorkflowRunError(err: unknown, wasAborted: boolean): WorkflowRunError {\n  const message = err instanceof Error ? err.message : String(err);\n  if (wasAborted || /aborted|cancelled/i.test(message)) {\n    return {\n      code: 'cancelled',\n      message: message || 'Workflow run cancelled',\n      recoverable: true,\n    };\n  }\n  if (/timeout/i.test(message)) {\n    return {\n      code: 'timeout',\n      message,\n      recoverable: true,\n    };\n  }\n  if (/quota/i.test(message)) {\n    return {\n      code: 'agent_quota_exceeded',\n      message,\n      recoverable: true,\n    };\n  }\n  return {\n    code: 'runtime_error',\n    message,\n    recoverable: false,\n  };\n}\n"],"mappings":"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"}

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

@@ -1,6 +1,7 @@
 export * from './domain/index.js';
 export * from './engine/index.js';
 export * from './runtime/index.js';
+export * from './registry/index.js';
 export * from './service/workflow-run-service.js';
 export * from './service/workflow-session-bridge.js';
 export * from './service/workflow-session-key.js';

package/dist/src/workflows/index.js

@@ -5,7 +5,9 @@ import { isTerminalWorkflowRunStatus } from "./domain/run.js";
 import { validateWorkflowDefinitionInput } from "./domain/validation.js";
 import "./domain/index.js";
 import { runViewToSnapshot } from "./service/run-view-to-snapshot.js";
+import { CatalogWorkflowDefinitionRegistry } from "./registry/catalog-workflow-definition-registry.js";
 import { projectWorkflowRunView } from "./engine/projector.js";
+import { ScriptWorkflowRuntime, createScriptWorkflowRuntime } from "./runtime/script-workflow-runtime.js";
 import { WorkflowEngine } from "./engine/workflow-engine.js";
 import "./engine/index.js";
 import { resolveWorkflowRootDir, resolveWorkflowRunArtifactsDir, resolveWorkflowRunDir, resolveWorkflowRunEventsPath, resolveWorkflowRunViewPath, resolveWorkflowRunsDir } from "./store/paths.js";
@@ -15,4 +17,5 @@ import { WorkflowRunService, buildWorkflowRunDefinitionSnapshot, buildWorkflowRu
 import { buildWorkflowRunSessionKey, readWorkflowRunIdFromSessionCustomData } from "./service/workflow-session-key.js";
 import { WORKFLOW_RUN_LINK_CONTEXT_KIND, WORKFLOW_SESSION_TYPE, WorkflowSessionBridge, formatParentRunLinkText } from "./service/workflow-session-bridge.js";
 import "./runtime/index.js";
-export { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, WORKFLOW_RUN_LINK_CONTEXT_KIND, WORKFLOW_SESSION_TYPE, WorkflowEngine, WorkflowEventStore, WorkflowRunService, WorkflowRunStore, WorkflowSessionBridge, buildWorkflowDefinition, buildWorkflowRunDefinitionSnapshot, buildWorkflowRunInputEnvelope, buildWorkflowRunMetadata, buildWorkflowRunSessionKey, createWorkflowEventStore, createWorkflowRunStore, extractWorkflowRunSessionKey, formatParentRunLinkText, isTerminalWorkflowRunStatus, normalizeWorkflowDefinitionId, parseWorkflowScript, projectWorkflowRunView, readWorkflowRunIdFromSessionCustomData, resolveWorkflowRootDir, resolveWorkflowRunArtifactsDir, resolveWorkflowRunDir, resolveWorkflowRunEventsPath, resolveWorkflowRunViewPath, resolveWorkflowRunsDir, runViewToSnapshot, runWorkflow as runWorkflowScript, toWorkflowDefinitionTitle, validateWorkflowDefinitionInput };
+import "./registry/index.js";
+export { CatalogWorkflowDefinitionRegistry, DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, ScriptWorkflowRuntime, WORKFLOW_RUN_LINK_CONTEXT_KIND, WORKFLOW_SESSION_TYPE, WorkflowEngine, WorkflowEventStore, WorkflowRunService, WorkflowRunStore, WorkflowSessionBridge, buildWorkflowDefinition, buildWorkflowRunDefinitionSnapshot, buildWorkflowRunInputEnvelope, buildWorkflowRunMetadata, buildWorkflowRunSessionKey, createScriptWorkflowRuntime, createWorkflowEventStore, createWorkflowRunStore, extractWorkflowRunSessionKey, formatParentRunLinkText, isTerminalWorkflowRunStatus, normalizeWorkflowDefinitionId, parseWorkflowScript, projectWorkflowRunView, readWorkflowRunIdFromSessionCustomData, resolveWorkflowRootDir, resolveWorkflowRunArtifactsDir, resolveWorkflowRunDir, resolveWorkflowRunEventsPath, resolveWorkflowRunViewPath, resolveWorkflowRunsDir, runViewToSnapshot, runWorkflow as runWorkflowScript, toWorkflowDefinitionTitle, validateWorkflowDefinitionInput };

package/dist/src/workflows/registry/catalog-workflow-definition-registry.d.ts

@@ -0,0 +1,9 @@
+import { type WorkflowCatalog } from '../../agent/workflow/catalog.js';
+import type { WorkflowDefinition } from '../domain/definition.js';
+import type { WorkflowDefinitionRegistry, WorkflowDefinitionSummary } from './workflow-definition-registry.js';
+export declare class CatalogWorkflowDefinitionRegistry implements WorkflowDefinitionRegistry {
+    private readonly catalog;
+    constructor(catalog?: WorkflowCatalog);
+    list(): Promise<WorkflowDefinitionSummary[]>;
+    get(id: string): Promise<WorkflowDefinition | null>;
+}

package/dist/src/workflows/registry/catalog-workflow-definition-registry.js

@@ -0,0 +1,40 @@
+import { createWorkflowCatalog } from "../../agent/workflow/catalog.js";
+import { buildWorkflowDefinition } from "../domain/definition-utils.js";
+//#region src/workflows/registry/catalog-workflow-definition-registry.ts
+var CatalogWorkflowDefinitionRegistry = class {
+	constructor(catalog = createWorkflowCatalog()) {
+		this.catalog = catalog;
+	}
+	async list() {
+		return this.catalog.list().map((entry) => ({
+			id: entry.name,
+			name: entry.name,
+			title: entry.title ?? toTitle(entry.name),
+			description: entry.description,
+			source: entry.source,
+			tags: entry.tags,
+			whenToUse: entry.whenToUse
+		}));
+	}
+	async get(id) {
+		try {
+			const loaded = this.catalog.load(id);
+			return buildWorkflowDefinition({
+				name: loaded.name,
+				source: loaded.source,
+				script: loaded.script,
+				meta: loaded.meta,
+				manifest: loaded.manifest
+			});
+		} catch {
+			return null;
+		}
+	}
+};
+function toTitle(value) {
+	return value.split(/[_-]+/g).filter(Boolean).map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`).join(" ");
+}
+//#endregion
+export { CatalogWorkflowDefinitionRegistry };
+
+//# sourceMappingURL=catalog-workflow-definition-registry.js.map

package/dist/src/workflows/registry/catalog-workflow-definition-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-workflow-definition-registry.js","names":[],"sources":["../../../../src/workflows/registry/catalog-workflow-definition-registry.ts"],"sourcesContent":["import { createWorkflowCatalog, type WorkflowCatalog } from '../../agent/workflow/catalog.js';\nimport { buildWorkflowDefinition } from '../domain/definition-utils.js';\nimport type { WorkflowDefinition } from '../domain/definition.js';\nimport type { WorkflowDefinitionRegistry, WorkflowDefinitionSummary } from './workflow-definition-registry.js';\n\nexport class CatalogWorkflowDefinitionRegistry implements WorkflowDefinitionRegistry {\n  constructor(private readonly catalog: WorkflowCatalog = createWorkflowCatalog()) {}\n\n  async list(): Promise<WorkflowDefinitionSummary[]> {\n    return this.catalog.list().map((entry) => ({\n      id: entry.name,\n      name: entry.name,\n      title: entry.title ?? toTitle(entry.name),\n      description: entry.description,\n      source: entry.source,\n      tags: entry.tags,\n      whenToUse: entry.whenToUse,\n    }));\n  }\n\n  async get(id: string): Promise<WorkflowDefinition | null> {\n    try {\n      const loaded = this.catalog.load(id);\n      return buildWorkflowDefinition({\n        name: loaded.name,\n        source: loaded.source,\n        script: loaded.script,\n        meta: loaded.meta,\n        manifest: loaded.manifest,\n      });\n    } catch {\n      return null;\n    }\n  }\n}\n\nfunction toTitle(value: string): string {\n  return value\n    .split(/[_-]+/g)\n    .filter(Boolean)\n    .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)\n    .join(' ');\n}\n"],"mappings":";;;AAKA,IAAa,oCAAb,MAAqF;CACnF,YAAY,UAA4C,uBAAuB,EAAE;AAApD,OAAA,UAAA;;CAE7B,MAAM,OAA6C;AACjD,SAAO,KAAK,QAAQ,MAAM,CAAC,KAAK,WAAW;GACzC,IAAI,MAAM;GACV,MAAM,MAAM;GACZ,OAAO,MAAM,SAAS,QAAQ,MAAM,KAAK;GACzC,aAAa,MAAM;GACnB,QAAQ,MAAM;GACd,MAAM,MAAM;GACZ,WAAW,MAAM;GAClB,EAAE;;CAGL,MAAM,IAAI,IAAgD;AACxD,MAAI;GACF,MAAM,SAAS,KAAK,QAAQ,KAAK,GAAG;AACpC,UAAO,wBAAwB;IAC7B,MAAM,OAAO;IACb,QAAQ,OAAO;IACf,QAAQ,OAAO;IACf,MAAM,OAAO;IACb,UAAU,OAAO;IAClB,CAAC;UACI;AACN,UAAO;;;;AAKb,SAAS,QAAQ,OAAuB;AACtC,QAAO,MACJ,MAAM,SAAS,CACf,OAAO,QAAQ,CACf,KAAK,SAAS,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,GAAG,CAClE,KAAK,IAAI"}

package/dist/src/workflows/registry/index.d.ts

@@ -0,0 +1,2 @@
+export * from './workflow-definition-registry.js';
+export * from './catalog-workflow-definition-registry.js';

package/dist/src/workflows/registry/index.js

@@ -0,0 +1,2 @@
+import { CatalogWorkflowDefinitionRegistry } from "./catalog-workflow-definition-registry.js";
+export { CatalogWorkflowDefinitionRegistry };

package/dist/src/workflows/registry/workflow-definition-registry.d.ts

@@ -0,0 +1,15 @@
+import type { WorkflowDefinition } from '../domain/definition.js';
+export interface WorkflowDefinitionSummary {
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    source: 'builtin' | 'user';
+    tags?: string[];
+    whenToUse?: string;
+}
+/** Definition source port: filesystem, built-ins, remote packages, extensions. */
+export interface WorkflowDefinitionRegistry {
+    list(): Promise<WorkflowDefinitionSummary[]>;
+    get(id: string): Promise<WorkflowDefinition | null>;
+}

package/dist/src/workflows/registry/workflow-definition-registry.js

@@ -0,0 +1 @@
+export {};

package/dist/src/workflows/runtime/index.d.ts

@@ -1 +1,3 @@
 export * from './script-runtime.js';
+export * from './workflow-runtime-port.js';
+export * from './script-workflow-runtime.js';

package/dist/src/workflows/runtime/index.js

@@ -1,4 +1,5 @@
 import { parseWorkflowScript } from "../../agent/workflow/parser.js";
 import { runWorkflow } from "../../agent/workflow/runtime.js";
 import "./script-runtime.js";
-export { parseWorkflowScript, runWorkflow as runWorkflowScript };
+import { ScriptWorkflowRuntime, createScriptWorkflowRuntime } from "./script-workflow-runtime.js";
+export { ScriptWorkflowRuntime, createScriptWorkflowRuntime, parseWorkflowScript, runWorkflow as runWorkflowScript };

package/dist/src/workflows/runtime/script-workflow-runtime.d.ts

@@ -0,0 +1,5 @@
+import type { WorkflowRuntime, WorkflowRuntimeDeps, WorkflowRuntimeRunOptions, WorkflowRuntimeRunResult } from './workflow-runtime-port.js';
+export declare class ScriptWorkflowRuntime implements WorkflowRuntime {
+    run<T = unknown>(script: string, deps: WorkflowRuntimeDeps, options: WorkflowRuntimeRunOptions): Promise<WorkflowRuntimeRunResult<T>>;
+}
+export declare function createScriptWorkflowRuntime(): WorkflowRuntime;

package/dist/src/workflows/runtime/script-workflow-runtime.js

@@ -0,0 +1,15 @@
+import { runWorkflow } from "../../agent/workflow/runtime.js";
+import "./script-runtime.js";
+//#region src/workflows/runtime/script-workflow-runtime.ts
+var ScriptWorkflowRuntime = class {
+	run(script, deps, options) {
+		return runWorkflow(script, deps, options);
+	}
+};
+function createScriptWorkflowRuntime() {
+	return new ScriptWorkflowRuntime();
+}
+//#endregion
+export { ScriptWorkflowRuntime, createScriptWorkflowRuntime };
+
+//# sourceMappingURL=script-workflow-runtime.js.map

package/dist/src/workflows/runtime/script-workflow-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-workflow-runtime.js","names":["runWorkflowScript"],"sources":["../../../../src/workflows/runtime/script-workflow-runtime.ts"],"sourcesContent":["import { runWorkflowScript } from './script-runtime.js';\nimport type {\n  WorkflowRuntime,\n  WorkflowRuntimeDeps,\n  WorkflowRuntimeRunOptions,\n  WorkflowRuntimeRunResult,\n} from './workflow-runtime-port.js';\n\nexport class ScriptWorkflowRuntime implements WorkflowRuntime {\n  run<T = unknown>(\n    script: string,\n    deps: WorkflowRuntimeDeps,\n    options: WorkflowRuntimeRunOptions,\n  ): Promise<WorkflowRuntimeRunResult<T>> {\n    return runWorkflowScript<T>(script, deps, options);\n  }\n}\n\nexport function createScriptWorkflowRuntime(): WorkflowRuntime {\n  return new ScriptWorkflowRuntime();\n}\n"],"mappings":";;;AAQA,IAAa,wBAAb,MAA8D;CAC5D,IACE,QACA,MACA,SACsC;AACtC,SAAOA,YAAqB,QAAQ,MAAM,QAAQ;;;AAItD,SAAgB,8BAA+C;AAC7D,QAAO,IAAI,uBAAuB"}

package/dist/src/workflows/runtime/workflow-runtime-port.d.ts

@@ -0,0 +1,16 @@
+import type { Api, Model } from '@earendil-works/pi-ai';
+import type { SubagentRunner, WorkflowRunOptions as ScriptWorkflowRunOptions, WorkflowRunResult as ScriptWorkflowRunResult } from '../../agent/workflow/types.js';
+export type WorkflowRuntimeSubagentRunner = SubagentRunner;
+export type WorkflowRuntimeRunOptions = ScriptWorkflowRunOptions;
+export type WorkflowRuntimeRunResult<T = unknown> = ScriptWorkflowRunResult<T>;
+export interface WorkflowRuntimeDeps {
+    runner: WorkflowRuntimeSubagentRunner;
+    resolveModelId?: (modelId: string) => Model<Api>;
+}
+/**
+ * Stable workflow execution port. Product services depend on this interface,
+ * not on a concrete script/vm implementation.
+ */
+export interface WorkflowRuntime {
+    run<T = unknown>(script: string, deps: WorkflowRuntimeDeps, options: WorkflowRuntimeRunOptions): Promise<WorkflowRuntimeRunResult<T>>;
+}

package/dist/src/workflows/runtime/workflow-runtime-port.js

@@ -0,0 +1 @@
+export {};

package/dist/src/workflows/service/run-view-to-snapshot.js

@@ -21,6 +21,8 @@ function runViewToSnapshot(view) {
 		label: agent.label,
 		phase: agent.phaseId ? phaseTitleById.get(agent.phaseId) : void 0,
 		prompt: agent.prompt ?? "",
+		sessionKey: agent.sessionKey,
+		transcriptMessageCount: agent.transcriptMessageCount,
 		status: agent.status,
 		resultPreview: agent.resultPreview,
 		error: agent.error,
@@ -42,6 +44,7 @@ function runViewToSnapshot(view) {
 	}));
 	const { metrics } = view.run;
 	return {
+		runId: view.run.id,
 		name: view.run.definitionId,
 		description: view.run.goal || view.run.title,
 		phases: view.phases.map((phase) => phase.title),

package/dist/src/workflows/service/run-view-to-snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-view-to-snapshot.js","names":[],"sources":["../../../../src/workflows/service/run-view-to-snapshot.ts"],"sourcesContent":["import type { WorkflowSnapshot } from '../../agent/workflow/types.js';\nimport type { WorkflowRunView } from '../domain/index.js';\n\nfunction agentNumericId(id: string, index: number): number {\n  const parsed = Number.parseInt(id, 10);\n  if (Number.isFinite(parsed)) return parsed;\n  return index + 1;\n}\n\nfunction resolveResultPayload(result: WorkflowRunView['run']['result']): unknown {\n  if (result == null) return undefined;\n  if (typeof result === 'object' && result !== null && 'raw' in result) {\n    const raw = (result as { raw?: unknown }).raw;\n    return raw !== undefined ? raw : result;\n  }\n  return result;\n}\n\n/** Map persisted {@link WorkflowRunView} into chat {@link WorkflowSnapshot}. */\nexport function runViewToSnapshot(view: WorkflowRunView): WorkflowSnapshot {\n  const phaseTitleById = new Map(view.phases.map((phase) => [phase.id, phase.title]));\n  const runningPhase = view.phases.find((phase) => phase.status === 'running');\n\n  const agents = view.agents.map((agent, index) => ({\n    id: agentNumericId(agent.id, index),\n    label: agent.label,\n    phase: agent.phaseId ? phaseTitleById.get(agent.phaseId) : undefined,\n    prompt: agent.prompt ?? '',\n    status: agent.status,\n    resultPreview: agent.resultPreview,\n    error: agent.error,\n    startedAtMs: agent.startedAtMs,\n    durationMs:\n      agent.startedAtMs != null && agent.completedAtMs != null\n        ? agent.completedAtMs - agent.startedAtMs\n        : undefined,\n    currentStep: agent.currentStep,\n    steps: agent.steps?.map((step) => ({\n      id: step.id,\n      kind: step.kind,\n      toolName: step.toolName,\n      label: step.label,\n      detail: step.detail,\n      status: step.status,\n      resultPreview: step.resultPreview,\n      error: step.error,\n      startedAtMs: step.startedAtMs,\n      durationMs:\n        step.startedAtMs != null && step.completedAtMs != null\n          ? step.completedAtMs - step.startedAtMs\n          : undefined,\n    })),\n  }));\n\n  const { metrics } = view.run;\n  return {\n    name: view.run.definitionId,\n    description: view.run.goal || view.run.title,\n    phases: view.phases.map((phase) => phase.title),\n    currentPhase: runningPhase?.title,\n    logs: view.logs.map((entry) => entry.message),\n    agents,\n    agentCount: metrics.agentCount,\n    runningCount: Math.max(\n      0,\n      metrics.agentCount - metrics.doneAgentCount - metrics.errorAgentCount - metrics.skippedAgentCount,\n    ),\n    doneCount: metrics.doneAgentCount,\n    errorCount: metrics.errorAgentCount,\n    skippedCount: metrics.skippedAgentCount,\n    durationMs: metrics.durationMs,\n    result: resolveResultPayload(view.run.result),\n  };\n}\n"],"mappings":";AAGA,SAAS,eAAe,IAAY,OAAuB;CACzD,MAAM,SAAS,OAAO,SAAS,IAAI,GAAG;AACtC,KAAI,OAAO,SAAS,OAAO,CAAE,QAAO;AACpC,QAAO,QAAQ;;AAGjB,SAAS,qBAAqB,QAAmD;AAC/E,KAAI,UAAU,KAAM,QAAO,KAAA;AAC3B,KAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,SAAS,QAAQ;EACpE,MAAM,MAAO,OAA6B;AAC1C,SAAO,QAAQ,KAAA,IAAY,MAAM;;AAEnC,QAAO;;;AAIT,SAAgB,kBAAkB,MAAyC;CACzE,MAAM,iBAAiB,IAAI,IAAI,KAAK,OAAO,KAAK,UAAU,CAAC,MAAM,IAAI,MAAM,MAAM,CAAC,CAAC;CACnF,MAAM,eAAe,KAAK,OAAO,MAAM,UAAU,MAAM,WAAW,UAAU;CAE5E,MAAM,SAAS,KAAK,OAAO,KAAK,OAAO,WAAW;EAChD,IAAI,eAAe,MAAM,IAAI,MAAM;EACnC,OAAO,MAAM;EACb,OAAO,MAAM,UAAU,eAAe,IAAI,MAAM,QAAQ,GAAG,KAAA;EAC3D,QAAQ,MAAM,UAAU;EACxB,QAAQ,MAAM;EACd,eAAe,MAAM;EACrB,OAAO,MAAM;EACb,aAAa,MAAM;EACnB,YACE,MAAM,eAAe,QAAQ,MAAM,iBAAiB,OAChD,MAAM,gBAAgB,MAAM,cAC5B,KAAA;EACN,aAAa,MAAM;EACnB,OAAO,MAAM,OAAO,KAAK,UAAU;GACjC,IAAI,KAAK;GACT,MAAM,KAAK;GACX,UAAU,KAAK;GACf,OAAO,KAAK;GACZ,QAAQ,KAAK;GACb,QAAQ,KAAK;GACb,eAAe,KAAK;GACpB,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,YACE,KAAK,eAAe,QAAQ,KAAK,iBAAiB,OAC9C,KAAK,gBAAgB,KAAK,cAC1B,KAAA;GACP,EAAE;EACJ,EAAE;CAEH,MAAM,EAAE,YAAY,KAAK;AACzB,QAAO;EACL,MAAM,KAAK,IAAI;EACf,aAAa,KAAK,IAAI,QAAQ,KAAK,IAAI;EACvC,QAAQ,KAAK,OAAO,KAAK,UAAU,MAAM,MAAM;EAC/C,cAAc,cAAc;EAC5B,MAAM,KAAK,KAAK,KAAK,UAAU,MAAM,QAAQ;EAC7C;EACA,YAAY,QAAQ;EACpB,cAAc,KAAK,IACjB,GACA,QAAQ,aAAa,QAAQ,iBAAiB,QAAQ,kBAAkB,QAAQ,kBACjF;EACD,WAAW,QAAQ;EACnB,YAAY,QAAQ;EACpB,cAAc,QAAQ;EACtB,YAAY,QAAQ;EACpB,QAAQ,qBAAqB,KAAK,IAAI,OAAO;EAC9C"}
+{"version":3,"file":"run-view-to-snapshot.js","names":[],"sources":["../../../../src/workflows/service/run-view-to-snapshot.ts"],"sourcesContent":["import type { WorkflowSnapshot } from '../../agent/workflow/types.js';\nimport type { WorkflowRunView } from '../domain/index.js';\n\nfunction agentNumericId(id: string, index: number): number {\n  const parsed = Number.parseInt(id, 10);\n  if (Number.isFinite(parsed)) return parsed;\n  return index + 1;\n}\n\nfunction resolveResultPayload(result: WorkflowRunView['run']['result']): unknown {\n  if (result == null) return undefined;\n  if (typeof result === 'object' && result !== null && 'raw' in result) {\n    const raw = (result as { raw?: unknown }).raw;\n    return raw !== undefined ? raw : result;\n  }\n  return result;\n}\n\n/** Map persisted {@link WorkflowRunView} into chat {@link WorkflowSnapshot}. */\nexport function runViewToSnapshot(view: WorkflowRunView): WorkflowSnapshot {\n  const phaseTitleById = new Map(view.phases.map((phase) => [phase.id, phase.title]));\n  const runningPhase = view.phases.find((phase) => phase.status === 'running');\n\n  const agents = view.agents.map((agent, index) => ({\n    id: agentNumericId(agent.id, index),\n    label: agent.label,\n    phase: agent.phaseId ? phaseTitleById.get(agent.phaseId) : undefined,\n    prompt: agent.prompt ?? '',\n    sessionKey: agent.sessionKey,\n    transcriptMessageCount: agent.transcriptMessageCount,\n    status: agent.status,\n    resultPreview: agent.resultPreview,\n    error: agent.error,\n    startedAtMs: agent.startedAtMs,\n    durationMs:\n      agent.startedAtMs != null && agent.completedAtMs != null\n        ? agent.completedAtMs - agent.startedAtMs\n        : undefined,\n    currentStep: agent.currentStep,\n    steps: agent.steps?.map((step) => ({\n      id: step.id,\n      kind: step.kind,\n      toolName: step.toolName,\n      label: step.label,\n      detail: step.detail,\n      status: step.status,\n      resultPreview: step.resultPreview,\n      error: step.error,\n      startedAtMs: step.startedAtMs,\n      durationMs:\n        step.startedAtMs != null && step.completedAtMs != null\n          ? step.completedAtMs - step.startedAtMs\n          : undefined,\n    })),\n  }));\n\n  const { metrics } = view.run;\n  return {\n    runId: view.run.id,\n    name: view.run.definitionId,\n    description: view.run.goal || view.run.title,\n    phases: view.phases.map((phase) => phase.title),\n    currentPhase: runningPhase?.title,\n    logs: view.logs.map((entry) => entry.message),\n    agents,\n    agentCount: metrics.agentCount,\n    runningCount: Math.max(\n      0,\n      metrics.agentCount - metrics.doneAgentCount - metrics.errorAgentCount - metrics.skippedAgentCount,\n    ),\n    doneCount: metrics.doneAgentCount,\n    errorCount: metrics.errorAgentCount,\n    skippedCount: metrics.skippedAgentCount,\n    durationMs: metrics.durationMs,\n    result: resolveResultPayload(view.run.result),\n  };\n}\n"],"mappings":";AAGA,SAAS,eAAe,IAAY,OAAuB;CACzD,MAAM,SAAS,OAAO,SAAS,IAAI,GAAG;AACtC,KAAI,OAAO,SAAS,OAAO,CAAE,QAAO;AACpC,QAAO,QAAQ;;AAGjB,SAAS,qBAAqB,QAAmD;AAC/E,KAAI,UAAU,KAAM,QAAO,KAAA;AAC3B,KAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,SAAS,QAAQ;EACpE,MAAM,MAAO,OAA6B;AAC1C,SAAO,QAAQ,KAAA,IAAY,MAAM;;AAEnC,QAAO;;;AAIT,SAAgB,kBAAkB,MAAyC;CACzE,MAAM,iBAAiB,IAAI,IAAI,KAAK,OAAO,KAAK,UAAU,CAAC,MAAM,IAAI,MAAM,MAAM,CAAC,CAAC;CACnF,MAAM,eAAe,KAAK,OAAO,MAAM,UAAU,MAAM,WAAW,UAAU;CAE5E,MAAM,SAAS,KAAK,OAAO,KAAK,OAAO,WAAW;EAChD,IAAI,eAAe,MAAM,IAAI,MAAM;EACnC,OAAO,MAAM;EACb,OAAO,MAAM,UAAU,eAAe,IAAI,MAAM,QAAQ,GAAG,KAAA;EAC3D,QAAQ,MAAM,UAAU;EACxB,YAAY,MAAM;EAClB,wBAAwB,MAAM;EAC9B,QAAQ,MAAM;EACd,eAAe,MAAM;EACrB,OAAO,MAAM;EACb,aAAa,MAAM;EACnB,YACE,MAAM,eAAe,QAAQ,MAAM,iBAAiB,OAChD,MAAM,gBAAgB,MAAM,cAC5B,KAAA;EACN,aAAa,MAAM;EACnB,OAAO,MAAM,OAAO,KAAK,UAAU;GACjC,IAAI,KAAK;GACT,MAAM,KAAK;GACX,UAAU,KAAK;GACf,OAAO,KAAK;GACZ,QAAQ,KAAK;GACb,QAAQ,KAAK;GACb,eAAe,KAAK;GACpB,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,YACE,KAAK,eAAe,QAAQ,KAAK,iBAAiB,OAC9C,KAAK,gBAAgB,KAAK,cAC1B,KAAA;GACP,EAAE;EACJ,EAAE;CAEH,MAAM,EAAE,YAAY,KAAK;AACzB,QAAO;EACL,OAAO,KAAK,IAAI;EAChB,MAAM,KAAK,IAAI;EACf,aAAa,KAAK,IAAI,QAAQ,KAAK,IAAI;EACvC,QAAQ,KAAK,OAAO,KAAK,UAAU,MAAM,MAAM;EAC/C,cAAc,cAAc;EAC5B,MAAM,KAAK,KAAK,KAAK,UAAU,MAAM,QAAQ;EAC7C;EACA,YAAY,QAAQ;EACpB,cAAc,KAAK,IACjB,GACA,QAAQ,aAAa,QAAQ,iBAAiB,QAAQ,kBAAkB,QAAQ,kBACjF;EACD,WAAW,QAAQ;EACnB,YAAY,QAAQ;EACpB,cAAc,QAAQ;EACtB,YAAY,QAAQ;EACpB,QAAQ,qBAAqB,KAAK,IAAI,OAAO;EAC9C"}

package/dist/src/workflows/service/workflow-run-service.d.ts

@@ -1,6 +1,7 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { BuildChildToolsOptions } from '../../agent/child-agent-factory.js';
 import type { GatewayWorkflowHost } from '../../gateway/gateway-workflow-host.types.js';
+import type { WorkflowDefinitionRegistry } from '../registry/workflow-definition-registry.js';
 import type { WorkflowDefinition, WorkflowRunDefinitionSnapshot, WorkflowRunInputEnvelope, WorkflowRunMetadata, WorkflowRunSource } from '../domain/index.js';
 import { WorkflowRunStore } from '../store/run-store.js';
 import type { WorkflowSessionBridge } from './workflow-session-bridge.js';
@@ -10,10 +11,12 @@ export interface WorkflowRunServiceOptions {
     service: GatewayWorkflowHost;
     sessionBridge: WorkflowSessionBridge;
     buildChildTools: (childOptions: BuildChildToolsOptions) => AgentTool<any, any>[];
+    definitionRegistry?: WorkflowDefinitionRegistry;
 }
 export declare class WorkflowRunService {
     private readonly options;
     private readonly activeRuns;
+    private readonly definitionRegistry;
     constructor(options: WorkflowRunServiceOptions);
     startWorkflowRun(params: StartWorkflowRunServiceParams): Promise<WorkflowRunServiceResult>;
     retryWorkflowRun(params: RetryWorkflowRunServiceParams): Promise<WorkflowRunServiceResult>;

package/dist/src/workflows/service/workflow-run-service.js

@@ -1,11 +1,10 @@
 import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
-import { createWorkflowCatalog } from "../../agent/workflow/catalog.js";
 import { DelegateSubagentRunner } from "../../agent/workflow/subagent-runner.js";
-import { buildWorkflowDefinition } from "../domain/definition-utils.js";
 import { isTerminalWorkflowRunStatus } from "../domain/run.js";
 import "../domain/index.js";
 import { resolveModelRef } from "../../config/agent-typed-models.js";
+import { CatalogWorkflowDefinitionRegistry } from "../registry/catalog-workflow-definition-registry.js";
 import { WorkflowEngine } from "../engine/workflow-engine.js";
 import "../engine/index.js";
 import { WorkflowEventStore } from "../store/event-store.js";
@@ -15,11 +14,13 @@ import { randomUUID } from "node:crypto";
 init_providers();
 var WorkflowRunService = class {
 	activeRuns = /* @__PURE__ */ new Map();
+	definitionRegistry;
 	constructor(options) {
 		this.options = options;
+		this.definitionRegistry = options.definitionRegistry ?? new CatalogWorkflowDefinitionRegistry();
 	}
 	async startWorkflowRun(params) {
-		const definition = this.loadDefinition(params.definitionId);
+		const definition = await this.loadDefinition(params.definitionId);
 		if (!definition) return {
 			ok: false,
 			code: "definition_not_found",
@@ -147,18 +148,7 @@ var WorkflowRunService = class {
 		return this.createRunStore(agentId).readRunView(runId);
 	}
 	loadDefinition(definitionId) {
-		const catalog = createWorkflowCatalog();
-		try {
-			const loaded = catalog.load(definitionId);
-			return buildWorkflowDefinition({
-				name: loaded.name,
-				source: loaded.source,
-				script: loaded.script,
-				meta: loaded.meta
-			});
-		} catch {
-			return null;
-		}
+		return this.definitionRegistry.get(definitionId);
 	}
 	createWorkflowEngine(params) {
 		const gatewayService = this.options.service;
@@ -167,6 +157,7 @@ var WorkflowRunService = class {
 			bus: gatewayService.messageBusInstance,
 			getDefaultModel: () => resolveModel(gatewayService.agentService.getModelForSession(params.sessionKey)),
 			getConfig: () => gatewayService.currentConfig,
+			sessionStore: gatewayService.sessionIndexInstance.getStore(),
 			buildChildTools: (childOptions) => this.options.buildChildTools(childOptions)
 		});
 		return new WorkflowEngine({
@@ -178,6 +169,10 @@ var WorkflowRunService = class {
 				const agentId = extractProfileAgentId(params.sessionKey, gatewayService.currentConfig);
 				return resolveModel(resolveModelRef(gatewayService.currentConfig, agentId, modelId));
 			},
+			parentSessionKey: params.sessionKey,
+			subagentSessionKeyFactory: ({ runId, agentId }) => {
+				return `agent:${extractProfileAgentId(params.sessionKey, gatewayService.currentConfig)}:workflow:${runId}:subagent:${agentId}`;
+			},
 			onEventAppended: (event) => {
 				gatewayService.emit("workflow.event.appended", {
 					runId: event.runId,