npm - @xopcai/xopc - Versions diffs - 0.0.106 → 0.0.108 - Mend

@xopcai/xopc 0.0.106 → 0.0.108

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (183) hide show

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

	@@ -1 +1 @@
1	- {"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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"}
1	+ {"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 { validateWorkflowJsonSchema } from '../domain/schema-validation.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';\nimport type { WorkflowAgentInvocationSnapshot } from '../domain/index.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 timeoutSec?: number;\n}\n\nexport interface WorkflowReplayAgentTarget {\n agentId: string;\n label: string;\n phaseId?: string;\n phaseTitle?: string;\n prompt: string;\n invocation?: WorkflowAgentInvocationSnapshot;\n}\n\nexport interface StartWorkflowReplayRunOptions extends StartWorkflowRunOptions {\n sourceRunId: string;\n replayScope: 'failed_agents' \| 'failed_phases';\n targets: WorkflowReplayAgentTarget[];\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 withWorkflowTimeout(\n 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 invocation: event.invocation,\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 options.timeoutSec ?? definition.defaults.timeoutSec,\n );\n\n await eventQueue;\n if (currentPhaseId) {\n await appendEvent('phase_completed', { phaseId: currentPhaseId });\n }\n assertWorkflowOutput(definition, runtimeResult.result);\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, options.signal?.reason);\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 async startReplayRun(definition: WorkflowDefinition, options: StartWorkflowReplayRunOptions): Promise<WorkflowRunView> {\n const runId = options.runId ?? randomUUID();\n const createdAtMs = Date.now();\n let eventQueue = Promise.resolve();\n const progressRecorders = new Map<string, AgentProgressRecorder>();\n\n const run: WorkflowRun = {\n id: runId,\n definitionId: definition.id,\n definitionVersion: definition.version,\n title: `${definition.title} replay`,\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 result = await withWorkflowTimeout(\n this.runReplayTargets({\n definition,\n runId,\n targets: options.targets,\n signal: options.signal,\n appendEvent,\n progressRecorders,\n }),\n options.timeoutSec ?? definition.defaults.timeoutSec,\n );\n\n await eventQueue;\n if (result.errors.length > 0) {\n await appendEvent('run_failed', {\n error: {\n code: 'runtime_error',\n message: `Replay completed with ${result.errors.length} failed target${result.errors.length === 1 ? '' : 's'}.`,\n detail: result.errors.join('\\n'),\n recoverable: true,\n },\n });\n await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'failed' }));\n } else {\n await appendEvent('run_completed', { result: buildReplayResultEnvelope(options, result.results) });\n await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'succeeded' }));\n }\n } catch (err) {\n await eventQueue;\n const error = toWorkflowRunError(err, options.signal?.aborted === true, options.signal?.reason);\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 replay run view was not created for ${runId}`);\n }\n return view;\n }\n\n private async runReplayTargets(params: {\n definition: WorkflowDefinition;\n runId: string;\n targets: WorkflowReplayAgentTarget[];\n signal?: AbortSignal;\n appendEvent: AppendWorkflowEvent;\n progressRecorders: Map<string, AgentProgressRecorder>;\n }): Promise<{ results: WorkflowReplayTargetResult[]; errors: string[] }> {\n const results: WorkflowReplayTargetResult[] = [];\n const errors: string[] = [];\n const targetsByPhase = groupReplayTargetsByPhase(params.targets);\n\n for (const group of targetsByPhase) {\n throwIfSignalAborted(params.signal);\n if (group.phaseId && group.phaseTitle) {\n await params.appendEvent('phase_started', { phaseId: group.phaseId, title: group.phaseTitle });\n }\n\n const phaseResults = await Promise.all(\n group.targets.map((target) => this.runReplayTarget({ ...params, target })),\n );\n results.push(...phaseResults);\n errors.push(...phaseResults.filter((item) => item.status === 'error').map((item) => `${item.label}: ${item.error ?? 'failed'}`));\n\n if (group.phaseId && phaseResults.every((item) => item.status === 'done')) {\n await params.appendEvent('phase_completed', { phaseId: group.phaseId });\n }\n }\n\n return { results, errors };\n }\n\n private async runReplayTarget(params: {\n definition: WorkflowDefinition;\n runId: string;\n target: WorkflowReplayAgentTarget;\n signal?: AbortSignal;\n appendEvent: AppendWorkflowEvent;\n progressRecorders: Map<string, AgentProgressRecorder>;\n }): Promise<WorkflowReplayTargetResult> {\n const { target } = params;\n const invocation = normalizeReplayInvocation(target);\n const sessionKey = this.options.subagentSessionKeyFactory?.({ runId: params.runId, agentId: target.agentId })\n ?? defaultSubagentSessionKey(params.runId, target.agentId);\n await this.callHooks((hook) => hook.beforeAgent?.({\n runId: params.runId,\n agentId: target.agentId,\n label: invocation.label,\n phaseId: target.phaseId,\n prompt: invocation.prompt,\n }));\n await params.appendEvent('agent_queued', {\n agentId: target.agentId,\n label: invocation.label,\n phaseId: target.phaseId,\n prompt: invocation.prompt,\n sessionKey,\n invocation,\n });\n await params.appendEvent('agent_started', { agentId: target.agentId });\n\n const recorder = new AgentProgressRecorder({\n agentId: target.agentId,\n appendEvent: params.appendEvent,\n });\n params.progressRecorders.set(target.agentId, recorder);\n\n try {\n throwIfSignalAborted(params.signal);\n const model = resolveReplayModel(invocation, this.options.resolveModelId);\n const result = await this.options.runner.run<unknown>(invocation.prompt, {\n label: invocation.label,\n schema: invocation.schema as never,\n allowedToolNames: invocation.toolset,\n maxIterations: invocation.maxIterations,\n phase: invocation.phase ?? target.phaseTitle,\n signal: params.signal,\n model,\n sessionKey,\n sessionMetadata: {\n parentSessionKey: this.options.parentSessionKey,\n workflowRunId: params.runId,\n workflowDefinitionId: params.definition.id,\n workflowAgentId: target.agentId,\n workflowAgentLabel: invocation.label,\n },\n onProgress: (event) => recorder.onProgress(event),\n });\n throwIfSignalAborted(params.signal);\n const status = result === null ? 'error' : 'done';\n const resultPreview = previewWorkflowValue(result);\n recorder.completeOpenSteps(status === 'done' ? 'done' : 'error');\n await params.appendEvent('agent_completed', {\n agentId: target.agentId,\n status,\n resultPreview,\n error: status === 'error' ? 'Replay target failed' : undefined,\n });\n await this.callHooks((hook) => hook.afterAgent?.({\n runId: params.runId,\n agentId: target.agentId,\n status,\n resultPreview,\n }));\n return { agentId: target.agentId, label: invocation.label, phaseId: target.phaseId, status, resultPreview };\n } catch (err) {\n if (params.signal?.aborted) throw err;\n const message = err instanceof Error ? err.message : String(err);\n recorder.completeOpenSteps('error');\n await params.appendEvent('agent_completed', {\n agentId: target.agentId,\n status: 'error',\n error: message,\n });\n await this.callHooks((hook) => hook.afterAgent?.({\n runId: params.runId,\n agentId: target.agentId,\n status: 'error',\n }));\n return { agentId: target.agentId, label: invocation.label, phaseId: target.phaseId, status: 'error', error: message };\n } finally {\n params.progressRecorders.delete(target.agentId);\n }\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\ninterface WorkflowReplayTargetResult {\n agentId: string;\n label: string;\n phaseId?: string;\n status: 'done' \| 'error';\n resultPreview?: string;\n error?: string;\n}\n\nclass WorkflowEngineRunError extends Error {\n constructor(\n readonly code: WorkflowRunError['code'],\n message: string,\n readonly recoverable: boolean,\n readonly detail?: string,\n ) {\n super(message);\n this.name = 'WorkflowEngineRunError';\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 withWorkflowTimeout<T>(promise: Promise<T>, timeoutSec: number \| undefined): Promise<T> {\n if (typeof timeoutSec !== 'number' \|\| !Number.isFinite(timeoutSec) \|\| timeoutSec <= 0) {\n return promise;\n }\n\n let timeout: ReturnType<typeof setTimeout> \| undefined;\n const timeoutPromise = new Promise<never>((_resolve, reject) => {\n timeout = setTimeout(() => {\n reject(new Error(`workflow timed out after ${timeoutSec}s`));\n }, timeoutSec * 1000);\n });\n\n return Promise.race([promise, timeoutPromise]).finally(() => {\n if (timeout) clearTimeout(timeout);\n });\n}\n\nfunction throwIfSignalAborted(signal: AbortSignal \| undefined): void {\n if (!signal?.aborted) return;\n const reason = signal.reason;\n if (reason instanceof Error) throw reason;\n if (reason) throw new Error(String(reason));\n throw new Error('workflow aborted');\n}\n\nfunction groupReplayTargetsByPhase(targets: WorkflowReplayAgentTarget[]): Array<{\n phaseId?: string;\n phaseTitle?: string;\n targets: WorkflowReplayAgentTarget[];\n}> {\n const groups: Array<{\n key: string;\n phaseId?: string;\n phaseTitle?: string;\n targets: WorkflowReplayAgentTarget[];\n }> = [];\n\n for (const target of targets) {\n const key = target.phaseId ?? '';\n let group = groups.find((item) => item.key === key);\n if (!group) {\n group = {\n key,\n phaseId: target.phaseId,\n phaseTitle: target.phaseTitle,\n targets: [],\n };\n groups.push(group);\n }\n group.targets.push(target);\n }\n\n return groups.map(({ key: _key, ...group }) => group);\n}\n\nfunction buildReplayResultEnvelope(\n options: StartWorkflowReplayRunOptions,\n results: WorkflowReplayTargetResult[],\n): WorkflowResultEnvelope {\n const done = results.filter((item) => item.status === 'done').length;\n return {\n summary: `Replay completed for ${done}/${results.length} target${results.length === 1 ? '' : 's'}.`,\n sections: [\n {\n kind: 'json',\n title: 'Replay targets',\n value: {\n sourceRunId: options.sourceRunId,\n scope: options.replayScope,\n targets: results,\n },\n },\n ],\n structuredOutput: {\n replay: {\n sourceRunId: options.sourceRunId,\n scope: options.replayScope,\n targets: results,\n },\n },\n };\n}\n\nfunction normalizeReplayInvocation(target: WorkflowReplayAgentTarget): WorkflowAgentInvocationSnapshot {\n return {\n prompt: target.invocation?.prompt ?? target.prompt,\n label: target.invocation?.label ?? target.label,\n phase: target.invocation?.phase ?? target.phaseTitle,\n modelRef: target.invocation?.modelRef,\n resolvedModelRef: target.invocation?.resolvedModelRef,\n schema: target.invocation?.schema,\n toolset: target.invocation?.toolset ? [...target.invocation.toolset] : undefined,\n maxIterations: target.invocation?.maxIterations,\n };\n}\n\nfunction resolveReplayModel(\n invocation: WorkflowAgentInvocationSnapshot,\n resolveModelId: ((modelId: string) => Model<Api>) \| undefined,\n): Model<Api> \| undefined {\n const modelRef = invocation.resolvedModelRef ?? invocation.modelRef;\n if (!modelRef) return undefined;\n if (!resolveModelId) {\n throw new Error(`workflow replay missing resolveModelId; cannot resolve model '${modelRef}'`);\n }\n return resolveModelId(modelRef);\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 assertWorkflowOutput(definition: WorkflowDefinition, value: unknown): void {\n const validation = validateWorkflowJsonSchema(definition.outputSchema, value);\n if (validation.ok) return;\n throw new WorkflowEngineRunError(\n 'result_validation_failed',\n validation.message ?? 'Workflow result did not match output schema',\n false,\n JSON.stringify(validation.errors ?? []),\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, abortReason?: unknown): WorkflowRunError {\n if (err instanceof WorkflowEngineRunError) {\n return {\n code: err.code,\n message: err.message,\n detail: err.detail,\n recoverable: err.recoverable,\n };\n }\n const abortMessage = abortReason instanceof Error ? abortReason.message : abortReason ? String(abortReason) : '';\n const message = abortMessage \|\| (err instanceof Error ? err.message : String(err));\n if (/timeout\|timed out/i.test(message)) {\n return {\n code: 'timeout',\n message,\n recoverable: true,\n };\n }\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 (/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.js CHANGED Viewed

@@ -1,8 +1,9 @@
 import { parseWorkflowScript } from "../agent/workflow/parser.js";
 import { runWorkflow } from "../agent/workflow/runtime.js";
-import { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle } from "./domain/definition-utils.js";
+import { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, hashWorkflowStableValue, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle } from "./domain/definition-utils.js";
 import { isTerminalWorkflowRunStatus } from "./domain/run.js";
 import { validateWorkflowDefinitionInput } from "./domain/validation.js";
+import { validateWorkflowJsonSchema } from "./domain/schema-validation.js";
 import "./domain/index.js";
 import { runViewToSnapshot } from "./service/run-view-to-snapshot.js";
 import { CatalogWorkflowDefinitionRegistry } from "./registry/catalog-workflow-definition-registry.js";
@@ -13,9 +14,9 @@ import "./engine/index.js";
 import { resolveWorkflowRootDir, resolveWorkflowRunArtifactsDir, resolveWorkflowRunDir, resolveWorkflowRunEventsPath, resolveWorkflowRunViewPath, resolveWorkflowRunsDir } from "./store/paths.js";
 import { WorkflowEventStore, createWorkflowEventStore } from "./store/event-store.js";
 import { WorkflowRunStore, createWorkflowRunStore } from "./store/run-store.js";
-import { WorkflowRunService, buildWorkflowRunDefinitionSnapshot, buildWorkflowRunInputEnvelope, buildWorkflowRunMetadata, extractWorkflowRunSessionKey } from "./service/workflow-run-service.js";
+import { WorkflowRunService, buildWorkflowRunDefinitionSnapshot, buildWorkflowRunInputEnvelope, buildWorkflowRunMetadata, extractWorkflowRunSessionKey, resolveWorkflowReplayTargets } from "./service/workflow-run-service.js";
 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";
 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 };
+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, hashWorkflowStableValue, isTerminalWorkflowRunStatus, normalizeWorkflowDefinitionId, parseWorkflowScript, projectWorkflowRunView, readWorkflowRunIdFromSessionCustomData, resolveWorkflowReplayTargets, resolveWorkflowRootDir, resolveWorkflowRunArtifactsDir, resolveWorkflowRunDir, resolveWorkflowRunEventsPath, resolveWorkflowRunViewPath, resolveWorkflowRunsDir, runViewToSnapshot, runWorkflow as runWorkflowScript, toWorkflowDefinitionTitle, validateWorkflowDefinitionInput, validateWorkflowJsonSchema };

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

@@ -5,8 +5,10 @@ import type { WorkflowDefinitionRegistry } from '../registry/workflow-definition
 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';
-export type { CancelWorkflowRunResult, CancelWorkflowRunServiceParams, CancelWorkflowRunServiceResult, RetryWorkflowRunServiceParams, StartWorkflowRunServiceParams, StartWorkflowRunServiceResult, WorkflowRunServiceErrorCode, WorkflowRunServiceErrorResult, WorkflowRunServiceResult, } from './workflow-run-service.types.js';
-import type { CancelWorkflowRunResult, CancelWorkflowRunServiceParams, RetryWorkflowRunServiceParams, StartWorkflowRunServiceParams, WorkflowRunServiceResult } from './workflow-run-service.types.js';
+export type { CancelWorkflowRunResult, CancelWorkflowRunServiceParams, CancelWorkflowRunServiceResult, ReplayWorkflowRunServiceParams, RetryWorkflowRunServiceParams, StartWorkflowRunServiceParams, StartWorkflowRunServiceResult, WorkflowRunServiceErrorCode, WorkflowRunServiceErrorResult, WorkflowRunServiceResult, } from './workflow-run-service.types.js';
+import type { CancelWorkflowRunResult, CancelWorkflowRunServiceParams, ReplayWorkflowRunServiceParams, RetryWorkflowRunServiceParams, StartWorkflowRunServiceParams, WorkflowRunServiceResult } from './workflow-run-service.types.js';
+import type { WorkflowRunReplayMetadata, WorkflowRunReplayScope, WorkflowRunView } from '../domain/run.js';
+import type { WorkflowReplayAgentTarget } from '../engine/index.js';
 export interface WorkflowRunServiceOptions {
     service: GatewayWorkflowHost;
     sessionBridge: WorkflowSessionBridge;
@@ -16,14 +18,18 @@ export interface WorkflowRunServiceOptions {
 export declare class WorkflowRunService {
     private readonly options;
     private readonly activeRuns;
+    private readonly timeoutHandles;
     private readonly definitionRegistry;
     constructor(options: WorkflowRunServiceOptions);
     startWorkflowRun(params: StartWorkflowRunServiceParams): Promise<WorkflowRunServiceResult>;
     retryWorkflowRun(params: RetryWorkflowRunServiceParams): Promise<WorkflowRunServiceResult>;
+    replayWorkflowRun(params: ReplayWorkflowRunServiceParams): Promise<WorkflowRunServiceResult>;
     cancelWorkflowRun(params: CancelWorkflowRunServiceParams): Promise<CancelWorkflowRunResult>;
     createRunStore(agentId: string): WorkflowRunStore;
-    readWorkflowRunView(agentId: string, runId: string): Promise<import("../index.js").WorkflowRunView>;
+    readWorkflowRunView(agentId: string, runId: string): Promise<WorkflowRunView>;
+    reconcileInterruptedRuns(agentId: string): Promise<number>;
     private loadDefinition;
+    private findRunByIdempotencyKey;
     private createWorkflowEngine;
 }
 export declare function buildWorkflowRunInputEnvelope(input: unknown, goal?: string): WorkflowRunInputEnvelope;
@@ -35,6 +41,11 @@ export declare function buildWorkflowRunMetadata(params: {
     input: WorkflowRunInputEnvelope;
     retryOfRunId?: string;
     idempotencyKey?: string;
+    replay?: WorkflowRunReplayMetadata;
 }): WorkflowRunMetadata;
+export declare function resolveWorkflowReplayTargets(view: WorkflowRunView, scope: WorkflowRunReplayScope): {
+    targets: WorkflowReplayAgentTarget[];
+    phaseIds?: string[];
+};
 export declare function buildWorkflowRunDefinitionSnapshot(definition: WorkflowDefinition): WorkflowRunDefinitionSnapshot;
 export declare function extractWorkflowRunSessionKey(source: WorkflowRunSource): string | null;

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

@@ -2,6 +2,7 @@ import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
 import { DelegateSubagentRunner } from "../../agent/workflow/subagent-runner.js";
 import { isTerminalWorkflowRunStatus } from "../domain/run.js";
+import { validateWorkflowJsonSchema } from "../domain/schema-validation.js";
 import "../domain/index.js";
 import { resolveModelRef } from "../../config/agent-typed-models.js";
 import { CatalogWorkflowDefinitionRegistry } from "../registry/catalog-workflow-definition-registry.js";
@@ -14,6 +15,7 @@ import { randomUUID } from "node:crypto";
 init_providers();
 var WorkflowRunService = class {
 	activeRuns = /* @__PURE__ */ new Map();
+	timeoutHandles = /* @__PURE__ */ new Map();
 	definitionRegistry;
 	constructor(options) {
 		this.options = options;
@@ -27,6 +29,20 @@ var WorkflowRunService = class {
 			message: "Workflow definition not found",
 			httpStatus: 404
 		};
+		const inputEnvelope = params.inputEnvelope ?? buildWorkflowRunInputEnvelope(params.input, params.goal);
+		const inputValidation = validateWorkflowJsonSchema(definition.inputSchema, inputEnvelope.payload);
+		if (!inputValidation.ok) return {
+			ok: false,
+			code: "invalid_input",
+			message: inputValidation.message ?? "Workflow input did not match input schema",
+			httpStatus: 400
+		};
+		const existingRun = params.idempotencyKey ? await this.findRunByIdempotencyKey(params.agentId, params.idempotencyKey) : null;
+		if (existingRun) return {
+			ok: true,
+			runId: existingRun.run.id,
+			sessionKey: existingRun.run.metadata?.sessionKey ?? ""
+		};
 		const runId = randomUUID();
 		const goal = params.goal ?? "";
 		const { sessionKey } = await this.options.sessionBridge.prepareRunSession({
@@ -46,8 +62,17 @@ var WorkflowRunService = class {
 			runStore,
 			sessionKey
 		});
-		const inputEnvelope = params.inputEnvelope ?? buildWorkflowRunInputEnvelope(params.input, params.goal);
+		const limits = resolveWorkflowRunLimits({
+			config: this.options.service.currentConfig,
+			definition,
+			concurrency: params.concurrency,
+			maxSubagents: params.maxSubagents
+		});
 		this.activeRuns.set(runId, abortController);
+		const timeoutHandle = setTimeout(() => {
+			abortController.abort(/* @__PURE__ */ new Error(`workflow timed out after ${limits.timeoutSec}s`));
+		}, limits.timeoutSec * 1e3);
+		this.timeoutHandles.set(runId, timeoutHandle);
 		engine.startRun(definition, {
 			runId,
 			input: inputEnvelope.payload,
@@ -63,9 +88,10 @@ var WorkflowRunService = class {
 				idempotencyKey: params.idempotencyKey
 			}),
 			signal: abortController.signal,
-			concurrency: params.concurrency,
-			maxSubagents: params.maxSubagents,
-			tokenBudget: params.tokenBudget
+			concurrency: limits.concurrency,
+			maxSubagents: limits.maxSubagents,
+			tokenBudget: params.tokenBudget,
+			timeoutSec: limits.timeoutSec
 		}).catch((err) => {
 			this.options.service.emit("workflow.run.error", {
 				runId,
@@ -73,6 +99,9 @@ var WorkflowRunService = class {
 			});
 		}).finally(() => {
 			this.activeRuns.delete(runId);
+			const handle = this.timeoutHandles.get(runId);
+			if (handle) clearTimeout(handle);
+			this.timeoutHandles.delete(runId);
 		});
 		return {
 			ok: true,
@@ -99,11 +128,111 @@ var WorkflowRunService = class {
 			retryOfRunId: existing.run.id
 		});
 	}
+	async replayWorkflowRun(params) {
+		const existing = await this.createRunStore(params.agentId).readRunView(params.runId);
+		if (!existing) return {
+			ok: false,
+			code: "run_not_found",
+			message: "Workflow run not found",
+			httpStatus: 404
+		};
+		const definition = await this.loadDefinition(existing.run.definitionId);
+		if (!definition) return {
+			ok: false,
+			code: "definition_not_found",
+			message: "Workflow definition not found",
+			httpStatus: 404
+		};
+		const targets = resolveWorkflowReplayTargets(existing, params.scope);
+		if (targets.targets.length === 0) return {
+			ok: false,
+			code: "invalid_state",
+			message: params.scope === "failed_phases" ? "No failed workflow phase is available to replay" : "No failed workflow agent is available to replay",
+			httpStatus: 409
+		};
+		const replayRunId = randomUUID();
+		const goal = buildReplayGoal(existing, params.scope, targets.targets.length);
+		const parentSessionKey = existing.run.source.kind === "chat" ? existing.run.source.sessionKey : void 0;
+		const { sessionKey } = await this.options.sessionBridge.prepareRunSession({
+			runId: replayRunId,
+			agentId: params.agentId,
+			definitionId: existing.run.definitionId,
+			definitionTitle: `${definition.title} replay`,
+			goal,
+			parentSessionKey
+		});
+		const source = normalizeWorkflowRunSourceForSession(existing.run.source, sessionKey, parentSessionKey);
+		const abortController = new AbortController();
+		const eventStore = new WorkflowEventStore(this.options.service.currentConfig, params.agentId);
+		const replayRunStore = new WorkflowRunStore(this.options.service.currentConfig, params.agentId, eventStore);
+		const engine = this.createWorkflowEngine({
+			eventStore,
+			runStore: replayRunStore,
+			sessionKey
+		});
+		const limits = resolveWorkflowRunLimits({
+			config: this.options.service.currentConfig,
+			definition
+		});
+		const inputEnvelope = existing.run.metadata?.input ?? buildWorkflowRunInputEnvelope(existing.run.input, existing.run.goal);
+		this.activeRuns.set(replayRunId, abortController);
+		const timeoutHandle = setTimeout(() => {
+			abortController.abort(/* @__PURE__ */ new Error(`workflow timed out after ${limits.timeoutSec}s`));
+		}, limits.timeoutSec * 1e3);
+		this.timeoutHandles.set(replayRunId, timeoutHandle);
+		engine.startReplayRun(definition, {
+			runId: replayRunId,
+			input: inputEnvelope.payload,
+			goal,
+			source,
+			metadata: buildWorkflowRunMetadata({
+				definition,
+				agentId: params.agentId,
+				sessionKey,
+				source,
+				input: inputEnvelope,
+				retryOfRunId: existing.run.id,
+				replay: {
+					sourceRunId: existing.run.id,
+					scope: params.scope,
+					phaseIds: targets.phaseIds,
+					agentIds: targets.targets.map((target) => target.agentId),
+					targetCount: targets.targets.length,
+					createdAtMs: Date.now()
+				}
+			}),
+			signal: abortController.signal,
+			concurrency: limits.concurrency,
+			maxSubagents: limits.maxSubagents,
+			timeoutSec: limits.timeoutSec,
+			sourceRunId: existing.run.id,
+			replayScope: params.scope,
+			targets: targets.targets
+		}).catch((err) => {
+			this.options.service.emit("workflow.run.error", {
+				runId: replayRunId,
+				error: err instanceof Error ? err.message : String(err)
+			});
+		}).finally(() => {
+			this.activeRuns.delete(replayRunId);
+			const handle = this.timeoutHandles.get(replayRunId);
+			if (handle) clearTimeout(handle);
+			this.timeoutHandles.delete(replayRunId);
+		});
+		return {
+			ok: true,
+			runId: replayRunId,
+			sessionKey
+		};
+	}
 	async cancelWorkflowRun(params) {
 		const controller = this.activeRuns.get(params.runId);
 		if (controller) {
 			controller.abort();
 			this.activeRuns.delete(params.runId);
+			const handle = this.timeoutHandles.get(params.runId);
+			if (handle) clearTimeout(handle);
+			this.timeoutHandles.delete(params.runId);
 			return {
 				ok: true,
 				cancelled: true
@@ -147,9 +276,45 @@ var WorkflowRunService = class {
 	async readWorkflowRunView(agentId, runId) {
 		return this.createRunStore(agentId).readRunView(runId);
 	}
+	async reconcileInterruptedRuns(agentId) {
+		const runStore = this.createRunStore(agentId);
+		const summaries = await runStore.listRunSummaries(500);
+		let reconciled = 0;
+		for (const summary of summaries) {
+			if (isTerminalWorkflowRunStatus(summary.status) || this.activeRuns.has(summary.id)) continue;
+			await new WorkflowEventStore(this.options.service.currentConfig, agentId).append({
+				runId: summary.id,
+				type: "run_failed",
+				payload: { error: {
+					code: "runtime_error",
+					message: "Workflow run interrupted by gateway restart",
+					recoverable: true
+				} }
+			});
+			const updated = await runStore.rebuildRunView(summary.id);
+			if (updated) {
+				this.options.service.emit("workflow.run.updated", {
+					runId: summary.id,
+					view: updated
+				});
+				this.options.sessionBridge.handleRunViewUpdated(updated);
+			}
+			reconciled += 1;
+		}
+		return reconciled;
+	}
 	loadDefinition(definitionId) {
 		return this.definitionRegistry.get(definitionId);
 	}
+	async findRunByIdempotencyKey(agentId, idempotencyKey) {
+		const runStore = this.createRunStore(agentId);
+		const summaries = await runStore.listRunSummaries(500);
+		for (const summary of summaries) {
+			if (summary.metadata?.correlation?.idempotencyKey !== idempotencyKey) continue;
+			return runStore.readRunView(summary.id);
+		}
+		return null;
+	}
 	createWorkflowEngine(params) {
 		const gatewayService = this.options.service;
 		const runner = new DelegateSubagentRunner({
@@ -214,6 +379,7 @@ function buildWorkflowRunMetadata(params) {
 		triggerSource: params.source.kind,
 		agentId: params.agentId,
 		retryOfRunId: params.retryOfRunId,
+		replay: params.replay,
 		definition: buildWorkflowRunDefinitionSnapshot(params.definition),
 		input: params.input,
 		correlation: { idempotencyKey: params.idempotencyKey },
@@ -224,8 +390,39 @@ function buildWorkflowRunMetadata(params) {
 		} : void 0
 	};
 }
-function buildWorkflowRunDefinitionSnapshot(definition) {
+function resolveWorkflowReplayTargets(view, scope) {
+	const phaseTitleById = new Map(view.phases.map((phase) => [phase.id, phase.title]));
+	const failedStatuses = new Set(["error", "skipped"]);
+	if (scope === "failed_agents") return { targets: view.agents.filter((agent) => failedStatuses.has(agent.status) && workflowAgentReplayPrompt(agent)).map((agent) => ({
+		agentId: agent.id,
+		label: agent.label,
+		phaseId: agent.phaseId,
+		phaseTitle: agent.phaseId ? phaseTitleById.get(agent.phaseId) : void 0,
+		prompt: workflowAgentReplayPrompt(agent) ?? "",
+		invocation: agent.invocation
+	})) };
+	const failedPhaseIds = view.phases.filter((phase) => phase.status === "failed").map((phase) => phase.id);
+	const phaseIds = failedPhaseIds.length > 0 ? failedPhaseIds : [...new Set(view.agents.filter((agent) => failedStatuses.has(agent.status) && agent.phaseId).map((agent) => agent.phaseId))];
+	const phaseIdSet = new Set(phaseIds);
 	return {
+		phaseIds,
+		targets: view.agents.filter((agent) => agent.phaseId && phaseIdSet.has(agent.phaseId) && workflowAgentReplayPrompt(agent)).map((agent) => ({
+			agentId: agent.id,
+			label: agent.label,
+			phaseId: agent.phaseId,
+			phaseTitle: agent.phaseId ? phaseTitleById.get(agent.phaseId) : void 0,
+			prompt: workflowAgentReplayPrompt(agent) ?? "",
+			invocation: agent.invocation
+		}))
+	};
+}
+function workflowAgentReplayPrompt(agent) {
+	const invocationPrompt = agent.invocation?.prompt?.trim();
+	if (invocationPrompt) return invocationPrompt;
+	return agent.prompt?.trim() || void 0;
+}
+function buildWorkflowRunDefinitionSnapshot(definition) {
+	const snapshot = {
 		id: definition.id,
 		name: definition.name,
 		title: definition.title,
@@ -233,8 +430,32 @@ function buildWorkflowRunDefinitionSnapshot(definition) {
 		source: definition.metadata.source,
 		tags: [...definition.metadata.tags],
 		phaseCount: definition.phases.length,
+		defaults: { ...definition.defaults },
 		estimatedAgents: definition.metadata.estimatedAgents
 	};
+	if (definition.contentHash) snapshot.contentHash = definition.contentHash;
+	if (definition.runtimeHash) snapshot.runtimeHash = definition.runtimeHash;
+	if (definition.permissions) snapshot.permissions = structuredClone(definition.permissions);
+	if (definition.resources) snapshot.resources = structuredClone(definition.resources);
+	return snapshot;
+}
+function resolveWorkflowRunLimits(params) {
+	const cfg = params.config.agents?.defaults?.workflow;
+	const configuredMaxConcurrency = normalizePositiveInt(cfg?.maxConcurrency, params.definition.defaults.concurrency);
+	const configuredMaxSubagents = normalizePositiveInt(cfg?.maxSubagents, params.definition.defaults.maxSubagents);
+	const configuredTimeoutSec = normalizePositiveInt(cfg?.defaultTimeoutSec, params.definition.defaults.timeoutSec);
+	return {
+		concurrency: Math.max(1, Math.min(normalizePositiveInt(params.concurrency, params.definition.defaults.concurrency), configuredMaxConcurrency)),
+		maxSubagents: Math.max(1, Math.min(normalizePositiveInt(params.maxSubagents, params.definition.defaults.maxSubagents), configuredMaxSubagents)),
+		timeoutSec: Math.max(1, Math.min(params.definition.defaults.timeoutSec, configuredTimeoutSec))
+	};
+}
+function normalizePositiveInt(value, fallback) {
+	if (typeof value !== "number" || !Number.isFinite(value) || value < 1) return fallback;
+	return Math.floor(value);
+}
+function buildReplayGoal(view, scope, targetCount) {
+	return `Replay ${targetCount} ${scope === "failed_phases" ? "failed phase" : "failed agent"}${targetCount === 1 ? "" : "s"} from workflow run ${view.run.id}: ${view.run.goal}`;
 }
 function extractWorkflowRunSessionKey(source) {
 	if ("sessionKey" in source && typeof source.sessionKey === "string" && source.sessionKey.trim()) return source.sessionKey.trim();
@@ -272,6 +493,6 @@ function isWorkflowRunInputEnvelope(input) {
 	return "payload" in input || "variables" in input || "context" in input;
 }
 //#endregion
-export { WorkflowRunService, buildWorkflowRunDefinitionSnapshot, buildWorkflowRunInputEnvelope, buildWorkflowRunMetadata, extractWorkflowRunSessionKey };
+export { WorkflowRunService, buildWorkflowRunDefinitionSnapshot, buildWorkflowRunInputEnvelope, buildWorkflowRunMetadata, extractWorkflowRunSessionKey, resolveWorkflowReplayTargets };
 //# sourceMappingURL=workflow-run-service.js.map