@xopcai/xopc 0.0.106 → 0.0.108

package/dist/src/workflows/draft/workflow-draft.types.d.ts

@@ -0,0 +1,44 @@
+import type { WorkflowDefinitionManifest } from '../domain/definition.js';
+import type { WorkflowDefinitionValidationResult } from '../domain/validation.js';
+export type WorkflowDraftMode = 'create' | 'improve';
+export interface WorkflowDraftConstraints {
+    allowedTools?: string[];
+    allowNetwork?: boolean;
+    fileSystem?: 'none' | 'read' | 'write';
+    maxPhases?: number;
+    maxSubagents?: number;
+    outputFormat?: 'report' | 'json' | 'actions';
+}
+export interface CreateWorkflowDraftRequest {
+    prompt: string;
+    agentId: string;
+    language?: 'en' | 'zh';
+    mode?: WorkflowDraftMode;
+    existingScript?: string;
+    constraints?: WorkflowDraftConstraints;
+}
+export interface WorkflowDraftLintIssue {
+    severity: 'error' | 'warning';
+    code: 'missing_input_schema' | 'missing_output_schema' | 'unsafe_permission' | 'too_many_agents' | 'unknown_tool' | 'weak_phase_names' | 'unbounded_parallelism';
+    message: string;
+}
+export interface GeneratedWorkflowDraft {
+    name: string;
+    script: string;
+    manifest: WorkflowDefinitionManifest;
+    explanation: string;
+    assumptions: string[];
+    risks: string[];
+}
+export interface WorkflowDraftResponse extends GeneratedWorkflowDraft {
+    draftId: string;
+    repairAttempts: number;
+    permissionsSummary: string[];
+    validation: WorkflowDefinitionValidationResult;
+    lint: WorkflowDraftLintIssue[];
+    suggestedInputs?: Array<{
+        key: string;
+        label: string;
+        example: string;
+    }>;
+}

package/dist/src/workflows/draft/workflow-draft.types.js

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

package/dist/src/workflows/engine/projector.js

@@ -71,6 +71,7 @@ function projectWorkflowRunView(events) {
 					phaseId: payload.phaseId,
 					status: "queued",
 					prompt: payload.prompt,
+					invocation: payload.invocation,
 					sessionKey: payload.sessionKey,
 					transcriptMessageCount: 0,
 					steps: []

package/dist/src/workflows/engine/projector.js.map

@@ -1 +1 @@
-{"version":3,"file":"projector.js","names":[],"sources":["../../../../src/workflows/engine/projector.ts"],"sourcesContent":["import type { WorkflowEventEnvelope } from '../domain/event.js';\nimport type {\n  WorkflowAgentStatus,\n  WorkflowAgentView,\n  WorkflowLogEntry,\n  WorkflowPhaseStatus,\n  WorkflowPhaseView,\n  WorkflowRun,\n  WorkflowRunView,\n  WorkflowTimelineItem,\n} from '../domain/run.js';\nimport { isTerminalWorkflowRunStatus } from '../domain/run.js';\nimport type { WorkflowArtifactRef } from '../domain/result.js';\n\nfunction terminalRunStatus(status: WorkflowRun['status']): boolean {\n  return isTerminalWorkflowRunStatus(status);\n}\n\nfunction phaseStatusAfterAgentStatus(agentStatuses: WorkflowAgentStatus[]): WorkflowPhaseStatus {\n  if (agentStatuses.some((status) => status === 'running')) {\n    return 'running';\n  }\n  if (agentStatuses.some((status) => status === 'error')) {\n    return 'failed';\n  }\n  if (agentStatuses.length > 0 && agentStatuses.every((status) => status === 'done' || status === 'skipped')) {\n    return 'completed';\n  }\n  return 'pending';\n}\n\nfunction buildTimelineItem(event: WorkflowEventEnvelope): WorkflowTimelineItem {\n  return {\n    sequence: event.sequence,\n    type: event.type,\n    title: event.type.replaceAll('_', ' '),\n    createdAtMs: event.createdAtMs,\n  };\n}\n\nexport function projectWorkflowRunView(events: WorkflowEventEnvelope[]): WorkflowRunView | null {\n  if (events.length === 0) {\n    return null;\n  }\n\n  const orderedEvents = [...events].sort((left, right) => left.sequence - right.sequence);\n  const firstEvent = orderedEvents[0];\n  if (firstEvent.type !== 'run_queued') {\n    return null;\n  }\n\n  const firstPayload = firstEvent.payload as { run?: WorkflowRun };\n  if (!firstPayload.run) {\n    return null;\n  }\n\n  const run: WorkflowRun = {\n    ...firstPayload.run,\n    metrics: { ...firstPayload.run.metrics },\n  };\n  const phaseIdToPhase = new Map<string, WorkflowPhaseView>();\n  const agentIdToAgent = new Map<string, WorkflowAgentView>();\n  const logs: WorkflowLogEntry[] = [];\n  const artifacts: WorkflowArtifactRef[] = [];\n  const timeline: WorkflowTimelineItem[] = [];\n\n  for (const event of orderedEvents) {\n    timeline.push(buildTimelineItem(event));\n\n    switch (event.type) {\n      case 'run_started': {\n        const payload = event.payload as { startedAtMs: number };\n        run.status = 'running';\n        run.startedAtMs = payload.startedAtMs;\n        break;\n      }\n      case 'phase_started': {\n        const payload = event.payload as { phaseId: string; title: string };\n        phaseIdToPhase.set(payload.phaseId, {\n          id: payload.phaseId,\n          title: payload.title,\n          status: 'running',\n          startedAtMs: event.createdAtMs,\n          agentIds: phaseIdToPhase.get(payload.phaseId)?.agentIds ?? [],\n        });\n        break;\n      }\n      case 'phase_completed': {\n        const payload = event.payload as { phaseId: string };\n        const existing = phaseIdToPhase.get(payload.phaseId);\n        if (existing) {\n          phaseIdToPhase.set(payload.phaseId, {\n            ...existing,\n            status: 'completed',\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_queued': {\n        const payload = event.payload as { agentId: string; label: string; phaseId?: string; prompt?: string; sessionKey: string };\n        agentIdToAgent.set(payload.agentId, {\n          id: payload.agentId,\n          label: payload.label,\n          phaseId: payload.phaseId,\n          status: 'queued',\n          prompt: payload.prompt,\n          sessionKey: payload.sessionKey,\n          transcriptMessageCount: 0,\n          steps: [],\n        });\n        if (payload.phaseId) {\n          const existingPhase = phaseIdToPhase.get(payload.phaseId);\n          if (existingPhase && !existingPhase.agentIds.includes(payload.agentId)) {\n            phaseIdToPhase.set(payload.phaseId, {\n              ...existingPhase,\n              agentIds: [...existingPhase.agentIds, payload.agentId],\n            });\n          }\n        }\n        break;\n      }\n      case 'agent_started': {\n        const payload = event.payload as { agentId: string };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: 'running',\n            startedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_step_started': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          label: string;\n          kind: 'tool' | 'llm' | 'thinking';\n          toolName?: string;\n          detail?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            currentStep: payload.label,\n            transcriptMessageCount: existing.transcriptMessageCount + 1,\n            steps: [\n              ...existing.steps,\n              {\n                id: payload.stepId,\n                label: payload.label,\n                kind: payload.kind,\n                toolName: payload.toolName,\n                detail: payload.detail,\n                status: 'running',\n                startedAtMs: event.createdAtMs,\n              },\n            ],\n          });\n        }\n        break;\n      }\n      case 'agent_step_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          status: 'done' | 'error';\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            steps: existing.steps.map((step) =>\n              step.id === payload.stepId\n                ? {\n                    ...step,\n                    status: payload.status,\n                    resultPreview: payload.resultPreview,\n                    error: payload.error,\n                    completedAtMs: event.createdAtMs,\n                  }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'agent_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          status: WorkflowAgentStatus;\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: payload.status,\n            currentStep: undefined,\n            resultPreview: payload.resultPreview,\n            error: payload.error,\n            transcriptMessageCount: existing.transcriptMessageCount + 1,\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'log_appended': {\n        const payload = event.payload as { message: string };\n        logs.push({ sequence: event.sequence, message: payload.message, createdAtMs: event.createdAtMs });\n        break;\n      }\n      case 'artifact_created': {\n        const payload = event.payload as { artifact: WorkflowArtifactRef };\n        artifacts.push(payload.artifact);\n        run.metrics.artifactCount = artifacts.length;\n        break;\n      }\n      case 'run_completed': {\n        const payload = event.payload as { result: WorkflowRun['result'] };\n        run.status = 'succeeded';\n        run.result = payload.result;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_failed': {\n        const payload = event.payload as { error: WorkflowRun['error'] };\n        run.status = payload.error?.code === 'timeout' ? 'timeout' : 'failed';\n        run.error = payload.error;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_cancelled': {\n        run.status = 'cancelled';\n        run.completedAtMs = event.createdAtMs;\n        for (const [agentId, agent] of agentIdToAgent) {\n          if (agent.status !== 'queued' && agent.status !== 'running') {\n            continue;\n          }\n          agentIdToAgent.set(agentId, {\n            ...agent,\n            status: 'skipped',\n            currentStep: undefined,\n            completedAtMs: event.createdAtMs,\n            steps: agent.steps.map((step) =>\n              step.status === 'running'\n                ? { ...step, status: 'error', completedAtMs: event.createdAtMs }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'run_queued':\n      default:\n        break;\n    }\n  }\n\n  const agents = [...agentIdToAgent.values()];\n  run.metrics.agentCount = agents.length;\n  run.metrics.doneAgentCount = agents.filter((agent) => agent.status === 'done').length;\n  run.metrics.errorAgentCount = agents.filter((agent) => agent.status === 'error').length;\n  run.metrics.skippedAgentCount = agents.filter((agent) => agent.status === 'skipped').length;\n  run.metrics.artifactCount = artifacts.length;\n  if (run.startedAtMs && run.completedAtMs) {\n    run.metrics.durationMs = run.completedAtMs - run.startedAtMs;\n  }\n\n  const phases = [...phaseIdToPhase.values()].map((phase) => {\n    if (phase.status === 'completed' || phase.status === 'failed') {\n      return phase;\n    }\n    const phaseAgents = phase.agentIds\n      .map((agentId) => agentIdToAgent.get(agentId)?.status)\n      .filter((status): status is WorkflowAgentStatus => Boolean(status));\n    return { ...phase, status: phaseStatusAfterAgentStatus(phaseAgents) };\n  });\n\n  return {\n    run,\n    phases,\n    agents,\n    logs,\n    artifacts,\n    timeline,\n    controls: {\n      canCancel: !terminalRunStatus(run.status),\n      canRetry: terminalRunStatus(run.status),\n      canArchive: terminalRunStatus(run.status),\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"projector.js","names":[],"sources":["../../../../src/workflows/engine/projector.ts"],"sourcesContent":["import type { WorkflowEventEnvelope } from '../domain/event.js';\nimport type {\n  WorkflowAgentStatus,\n  WorkflowAgentView,\n  WorkflowLogEntry,\n  WorkflowPhaseStatus,\n  WorkflowPhaseView,\n  WorkflowRun,\n  WorkflowRunView,\n  WorkflowTimelineItem,\n} from '../domain/run.js';\nimport { isTerminalWorkflowRunStatus } from '../domain/run.js';\nimport type { WorkflowArtifactRef } from '../domain/result.js';\n\nfunction terminalRunStatus(status: WorkflowRun['status']): boolean {\n  return isTerminalWorkflowRunStatus(status);\n}\n\nfunction phaseStatusAfterAgentStatus(agentStatuses: WorkflowAgentStatus[]): WorkflowPhaseStatus {\n  if (agentStatuses.some((status) => status === 'running')) {\n    return 'running';\n  }\n  if (agentStatuses.some((status) => status === 'error')) {\n    return 'failed';\n  }\n  if (agentStatuses.length > 0 && agentStatuses.every((status) => status === 'done' || status === 'skipped')) {\n    return 'completed';\n  }\n  return 'pending';\n}\n\nfunction buildTimelineItem(event: WorkflowEventEnvelope): WorkflowTimelineItem {\n  return {\n    sequence: event.sequence,\n    type: event.type,\n    title: event.type.replaceAll('_', ' '),\n    createdAtMs: event.createdAtMs,\n  };\n}\n\nexport function projectWorkflowRunView(events: WorkflowEventEnvelope[]): WorkflowRunView | null {\n  if (events.length === 0) {\n    return null;\n  }\n\n  const orderedEvents = [...events].sort((left, right) => left.sequence - right.sequence);\n  const firstEvent = orderedEvents[0];\n  if (firstEvent.type !== 'run_queued') {\n    return null;\n  }\n\n  const firstPayload = firstEvent.payload as { run?: WorkflowRun };\n  if (!firstPayload.run) {\n    return null;\n  }\n\n  const run: WorkflowRun = {\n    ...firstPayload.run,\n    metrics: { ...firstPayload.run.metrics },\n  };\n  const phaseIdToPhase = new Map<string, WorkflowPhaseView>();\n  const agentIdToAgent = new Map<string, WorkflowAgentView>();\n  const logs: WorkflowLogEntry[] = [];\n  const artifacts: WorkflowArtifactRef[] = [];\n  const timeline: WorkflowTimelineItem[] = [];\n\n  for (const event of orderedEvents) {\n    timeline.push(buildTimelineItem(event));\n\n    switch (event.type) {\n      case 'run_started': {\n        const payload = event.payload as { startedAtMs: number };\n        run.status = 'running';\n        run.startedAtMs = payload.startedAtMs;\n        break;\n      }\n      case 'phase_started': {\n        const payload = event.payload as { phaseId: string; title: string };\n        phaseIdToPhase.set(payload.phaseId, {\n          id: payload.phaseId,\n          title: payload.title,\n          status: 'running',\n          startedAtMs: event.createdAtMs,\n          agentIds: phaseIdToPhase.get(payload.phaseId)?.agentIds ?? [],\n        });\n        break;\n      }\n      case 'phase_completed': {\n        const payload = event.payload as { phaseId: string };\n        const existing = phaseIdToPhase.get(payload.phaseId);\n        if (existing) {\n          phaseIdToPhase.set(payload.phaseId, {\n            ...existing,\n            status: 'completed',\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_queued': {\n        const payload = event.payload as {\n          agentId: string;\n          label: string;\n          phaseId?: string;\n          prompt?: string;\n          sessionKey: string;\n          invocation?: WorkflowAgentView['invocation'];\n        };\n        agentIdToAgent.set(payload.agentId, {\n          id: payload.agentId,\n          label: payload.label,\n          phaseId: payload.phaseId,\n          status: 'queued',\n          prompt: payload.prompt,\n          invocation: payload.invocation,\n          sessionKey: payload.sessionKey,\n          transcriptMessageCount: 0,\n          steps: [],\n        });\n        if (payload.phaseId) {\n          const existingPhase = phaseIdToPhase.get(payload.phaseId);\n          if (existingPhase && !existingPhase.agentIds.includes(payload.agentId)) {\n            phaseIdToPhase.set(payload.phaseId, {\n              ...existingPhase,\n              agentIds: [...existingPhase.agentIds, payload.agentId],\n            });\n          }\n        }\n        break;\n      }\n      case 'agent_started': {\n        const payload = event.payload as { agentId: string };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: 'running',\n            startedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_step_started': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          label: string;\n          kind: 'tool' | 'llm' | 'thinking';\n          toolName?: string;\n          detail?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            currentStep: payload.label,\n            transcriptMessageCount: existing.transcriptMessageCount + 1,\n            steps: [\n              ...existing.steps,\n              {\n                id: payload.stepId,\n                label: payload.label,\n                kind: payload.kind,\n                toolName: payload.toolName,\n                detail: payload.detail,\n                status: 'running',\n                startedAtMs: event.createdAtMs,\n              },\n            ],\n          });\n        }\n        break;\n      }\n      case 'agent_step_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          status: 'done' | 'error';\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            steps: existing.steps.map((step) =>\n              step.id === payload.stepId\n                ? {\n                    ...step,\n                    status: payload.status,\n                    resultPreview: payload.resultPreview,\n                    error: payload.error,\n                    completedAtMs: event.createdAtMs,\n                  }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'agent_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          status: WorkflowAgentStatus;\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: payload.status,\n            currentStep: undefined,\n            resultPreview: payload.resultPreview,\n            error: payload.error,\n            transcriptMessageCount: existing.transcriptMessageCount + 1,\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'log_appended': {\n        const payload = event.payload as { message: string };\n        logs.push({ sequence: event.sequence, message: payload.message, createdAtMs: event.createdAtMs });\n        break;\n      }\n      case 'artifact_created': {\n        const payload = event.payload as { artifact: WorkflowArtifactRef };\n        artifacts.push(payload.artifact);\n        run.metrics.artifactCount = artifacts.length;\n        break;\n      }\n      case 'run_completed': {\n        const payload = event.payload as { result: WorkflowRun['result'] };\n        run.status = 'succeeded';\n        run.result = payload.result;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_failed': {\n        const payload = event.payload as { error: WorkflowRun['error'] };\n        run.status = payload.error?.code === 'timeout' ? 'timeout' : 'failed';\n        run.error = payload.error;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_cancelled': {\n        run.status = 'cancelled';\n        run.completedAtMs = event.createdAtMs;\n        for (const [agentId, agent] of agentIdToAgent) {\n          if (agent.status !== 'queued' && agent.status !== 'running') {\n            continue;\n          }\n          agentIdToAgent.set(agentId, {\n            ...agent,\n            status: 'skipped',\n            currentStep: undefined,\n            completedAtMs: event.createdAtMs,\n            steps: agent.steps.map((step) =>\n              step.status === 'running'\n                ? { ...step, status: 'error', completedAtMs: event.createdAtMs }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'run_queued':\n      default:\n        break;\n    }\n  }\n\n  const agents = [...agentIdToAgent.values()];\n  run.metrics.agentCount = agents.length;\n  run.metrics.doneAgentCount = agents.filter((agent) => agent.status === 'done').length;\n  run.metrics.errorAgentCount = agents.filter((agent) => agent.status === 'error').length;\n  run.metrics.skippedAgentCount = agents.filter((agent) => agent.status === 'skipped').length;\n  run.metrics.artifactCount = artifacts.length;\n  if (run.startedAtMs && run.completedAtMs) {\n    run.metrics.durationMs = run.completedAtMs - run.startedAtMs;\n  }\n\n  const phases = [...phaseIdToPhase.values()].map((phase) => {\n    if (phase.status === 'completed' || phase.status === 'failed') {\n      return phase;\n    }\n    const phaseAgents = phase.agentIds\n      .map((agentId) => agentIdToAgent.get(agentId)?.status)\n      .filter((status): status is WorkflowAgentStatus => Boolean(status));\n    return { ...phase, status: phaseStatusAfterAgentStatus(phaseAgents) };\n  });\n\n  return {\n    run,\n    phases,\n    agents,\n    logs,\n    artifacts,\n    timeline,\n    controls: {\n      canCancel: !terminalRunStatus(run.status),\n      canRetry: terminalRunStatus(run.status),\n      canArchive: terminalRunStatus(run.status),\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/workflows/engine/workflow-engine.d.ts

@@ -6,6 +6,7 @@ import { WorkflowRunStore } from '../store/run-store.js';
 import type { WorkflowRuntime } from '../runtime/workflow-runtime-port.js';
 import type { Api, Model } from '@earendil-works/pi-ai';
 import type { WorkflowScriptSubagentRunner } from '../runtime/script-runtime.js';
+import type { WorkflowAgentInvocationSnapshot } from '../domain/index.js';
 export interface WorkflowEngineOptions {
     cwd: string;
     eventStore: WorkflowEventStore;
@@ -59,10 +60,27 @@ export interface StartWorkflowRunOptions {
     concurrency?: number;
     maxSubagents?: number;
     tokenBudget?: number | null;
+    timeoutSec?: number;
+}
+export interface WorkflowReplayAgentTarget {
+    agentId: string;
+    label: string;
+    phaseId?: string;
+    phaseTitle?: string;
+    prompt: string;
+    invocation?: WorkflowAgentInvocationSnapshot;
+}
+export interface StartWorkflowReplayRunOptions extends StartWorkflowRunOptions {
+    sourceRunId: string;
+    replayScope: 'failed_agents' | 'failed_phases';
+    targets: WorkflowReplayAgentTarget[];
 }
 export declare class WorkflowEngine {
     private readonly options;
     constructor(options: WorkflowEngineOptions);
     startRun(definition: WorkflowDefinition, options: StartWorkflowRunOptions): Promise<WorkflowRunView>;
+    startReplayRun(definition: WorkflowDefinition, options: StartWorkflowReplayRunOptions): Promise<WorkflowRunView>;
+    private runReplayTargets;
+    private runReplayTarget;
     private callHooks;
 }

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

@@ -1,4 +1,5 @@
 import { workflowStepLabel } from "../../agent/workflow/step-labels.js";
+import { validateWorkflowJsonSchema } from "../domain/schema-validation.js";
 import { createScriptWorkflowRuntime } from "../runtime/script-workflow-runtime.js";
 import { randomUUID } from "node:crypto";
 //#region src/workflows/engine/workflow-engine.ts
@@ -53,7 +54,7 @@ var WorkflowEngine = class {
 		}));
 		await appendEvent("run_started", { startedAtMs: Date.now() });
 		try {
-			const runtimeResult = await (this.options.runtime ?? createScriptWorkflowRuntime()).run(definition.runtime.source, {
+			const runtimeResult = await withWorkflowTimeout((this.options.runtime ?? createScriptWorkflowRuntime()).run(definition.runtime.source, {
 				runner: this.options.runner,
 				resolveModelId: this.options.resolveModelId
 			}, {
@@ -95,7 +96,8 @@ var WorkflowEngine = class {
 						label: event.label,
 						phaseId,
 						prompt: event.prompt,
-						sessionKey: subagentSessionKey
+						sessionKey: subagentSessionKey,
+						invocation: event.invocation
 					});
 				},
 				onAgentStart: (event) => {
@@ -143,9 +145,10 @@ var WorkflowEngine = class {
 						onProgress: (event) => recorder.onProgress(event)
 					};
 				}
-			});
+			}), options.timeoutSec ?? definition.defaults.timeoutSec);
 			await eventQueue;
 			if (currentPhaseId) await appendEvent("phase_completed", { phaseId: currentPhaseId });
+			assertWorkflowOutput(definition, runtimeResult.result);
 			await appendEvent("run_completed", { result: toWorkflowResultEnvelope(runtimeResult.result) });
 			await this.callHooks((hook) => hook.afterRun?.({
 				runId,
@@ -153,7 +156,7 @@ var WorkflowEngine = class {
 			}));
 		} catch (err) {
 			await eventQueue;
-			const error = toWorkflowRunError(err, options.signal?.aborted === true);
+			const error = toWorkflowRunError(err, options.signal?.aborted === true, options.signal?.reason);
 			if (error.code === "cancelled") {
 				await appendEvent("run_cancelled", { reason: error.message });
 				await this.callHooks((hook) => hook.afterRun?.({
@@ -172,12 +175,233 @@ var WorkflowEngine = class {
 		if (!view) throw new Error(`workflow run view was not created for ${runId}`);
 		return view;
 	}
+	async startReplayRun(definition, options) {
+		const runId = options.runId ?? randomUUID();
+		const createdAtMs = Date.now();
+		let eventQueue = Promise.resolve();
+		const progressRecorders = /* @__PURE__ */ new Map();
+		const run = {
+			id: runId,
+			definitionId: definition.id,
+			definitionVersion: definition.version,
+			title: `${definition.title} replay`,
+			goal: options.goal ?? definition.description,
+			input: options.input ?? {},
+			status: "queued",
+			source: options.source,
+			metadata: options.metadata,
+			metrics: {
+				agentCount: 0,
+				doneAgentCount: 0,
+				errorAgentCount: 0,
+				skippedAgentCount: 0,
+				artifactCount: 0
+			},
+			createdAtMs
+		};
+		const appendEvent = (type, payload, createdAtMsOverride) => {
+			eventQueue = eventQueue.then(() => this.options.eventStore.append({
+				runId,
+				type,
+				payload,
+				createdAtMs: createdAtMsOverride
+			})).then(async (event) => {
+				this.options.onEventAppended?.(event);
+				const view = await this.options.runStore.rebuildRunView(runId);
+				if (view) this.options.onRunViewUpdated?.(view);
+			});
+			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 result = await withWorkflowTimeout(this.runReplayTargets({
+				definition,
+				runId,
+				targets: options.targets,
+				signal: options.signal,
+				appendEvent,
+				progressRecorders
+			}), options.timeoutSec ?? definition.defaults.timeoutSec);
+			await eventQueue;
+			if (result.errors.length > 0) {
+				await appendEvent("run_failed", { error: {
+					code: "runtime_error",
+					message: `Replay completed with ${result.errors.length} failed target${result.errors.length === 1 ? "" : "s"}.`,
+					detail: result.errors.join("\n"),
+					recoverable: true
+				} });
+				await this.callHooks((hook) => hook.afterRun?.({
+					runId,
+					status: "failed"
+				}));
+			} else {
+				await appendEvent("run_completed", { result: buildReplayResultEnvelope(options, result.results) });
+				await this.callHooks((hook) => hook.afterRun?.({
+					runId,
+					status: "succeeded"
+				}));
+			}
+		} catch (err) {
+			await eventQueue;
+			const error = toWorkflowRunError(err, options.signal?.aborted === true, options.signal?.reason);
+			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 replay run view was not created for ${runId}`);
+		return view;
+	}
+	async runReplayTargets(params) {
+		const results = [];
+		const errors = [];
+		const targetsByPhase = groupReplayTargetsByPhase(params.targets);
+		for (const group of targetsByPhase) {
+			throwIfSignalAborted(params.signal);
+			if (group.phaseId && group.phaseTitle) await params.appendEvent("phase_started", {
+				phaseId: group.phaseId,
+				title: group.phaseTitle
+			});
+			const phaseResults = await Promise.all(group.targets.map((target) => this.runReplayTarget({
+				...params,
+				target
+			})));
+			results.push(...phaseResults);
+			errors.push(...phaseResults.filter((item) => item.status === "error").map((item) => `${item.label}: ${item.error ?? "failed"}`));
+			if (group.phaseId && phaseResults.every((item) => item.status === "done")) await params.appendEvent("phase_completed", { phaseId: group.phaseId });
+		}
+		return {
+			results,
+			errors
+		};
+	}
+	async runReplayTarget(params) {
+		const { target } = params;
+		const invocation = normalizeReplayInvocation(target);
+		const sessionKey = this.options.subagentSessionKeyFactory?.({
+			runId: params.runId,
+			agentId: target.agentId
+		}) ?? defaultSubagentSessionKey(params.runId, target.agentId);
+		await this.callHooks((hook) => hook.beforeAgent?.({
+			runId: params.runId,
+			agentId: target.agentId,
+			label: invocation.label,
+			phaseId: target.phaseId,
+			prompt: invocation.prompt
+		}));
+		await params.appendEvent("agent_queued", {
+			agentId: target.agentId,
+			label: invocation.label,
+			phaseId: target.phaseId,
+			prompt: invocation.prompt,
+			sessionKey,
+			invocation
+		});
+		await params.appendEvent("agent_started", { agentId: target.agentId });
+		const recorder = new AgentProgressRecorder({
+			agentId: target.agentId,
+			appendEvent: params.appendEvent
+		});
+		params.progressRecorders.set(target.agentId, recorder);
+		try {
+			throwIfSignalAborted(params.signal);
+			const model = resolveReplayModel(invocation, this.options.resolveModelId);
+			const result = await this.options.runner.run(invocation.prompt, {
+				label: invocation.label,
+				schema: invocation.schema,
+				allowedToolNames: invocation.toolset,
+				maxIterations: invocation.maxIterations,
+				phase: invocation.phase ?? target.phaseTitle,
+				signal: params.signal,
+				model,
+				sessionKey,
+				sessionMetadata: {
+					parentSessionKey: this.options.parentSessionKey,
+					workflowRunId: params.runId,
+					workflowDefinitionId: params.definition.id,
+					workflowAgentId: target.agentId,
+					workflowAgentLabel: invocation.label
+				},
+				onProgress: (event) => recorder.onProgress(event)
+			});
+			throwIfSignalAborted(params.signal);
+			const status = result === null ? "error" : "done";
+			const resultPreview = previewWorkflowValue(result);
+			recorder.completeOpenSteps(status === "done" ? "done" : "error");
+			await params.appendEvent("agent_completed", {
+				agentId: target.agentId,
+				status,
+				resultPreview,
+				error: status === "error" ? "Replay target failed" : void 0
+			});
+			await this.callHooks((hook) => hook.afterAgent?.({
+				runId: params.runId,
+				agentId: target.agentId,
+				status,
+				resultPreview
+			}));
+			return {
+				agentId: target.agentId,
+				label: invocation.label,
+				phaseId: target.phaseId,
+				status,
+				resultPreview
+			};
+		} catch (err) {
+			if (params.signal?.aborted) throw err;
+			const message = err instanceof Error ? err.message : String(err);
+			recorder.completeOpenSteps("error");
+			await params.appendEvent("agent_completed", {
+				agentId: target.agentId,
+				status: "error",
+				error: message
+			});
+			await this.callHooks((hook) => hook.afterAgent?.({
+				runId: params.runId,
+				agentId: target.agentId,
+				status: "error"
+			}));
+			return {
+				agentId: target.agentId,
+				label: invocation.label,
+				phaseId: target.phaseId,
+				status: "error",
+				error: message
+			};
+		} finally {
+			params.progressRecorders.delete(target.agentId);
+		}
+	}
 	async callHooks(call) {
 		for (const hook of this.options.hooks ?? []) try {
 			await call(hook);
 		} catch {}
 	}
 };
+var WorkflowEngineRunError = class extends Error {
+	constructor(code, message, recoverable, detail) {
+		super(message);
+		this.code = code;
+		this.recoverable = recoverable;
+		this.detail = detail;
+		this.name = "WorkflowEngineRunError";
+	}
+};
 var AgentProgressRecorder = class {
 	activeToolStepIds = /* @__PURE__ */ new Map();
 	activeIterationStepId = null;
@@ -301,6 +525,80 @@ function buildPhaseTitleToId(definition) {
 function normalizePhaseId(title) {
 	return title.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "phase";
 }
+function withWorkflowTimeout(promise, timeoutSec) {
+	if (typeof timeoutSec !== "number" || !Number.isFinite(timeoutSec) || timeoutSec <= 0) return promise;
+	let timeout;
+	const timeoutPromise = new Promise((_resolve, reject) => {
+		timeout = setTimeout(() => {
+			reject(/* @__PURE__ */ new Error(`workflow timed out after ${timeoutSec}s`));
+		}, timeoutSec * 1e3);
+	});
+	return Promise.race([promise, timeoutPromise]).finally(() => {
+		if (timeout) clearTimeout(timeout);
+	});
+}
+function throwIfSignalAborted(signal) {
+	if (!signal?.aborted) return;
+	const reason = signal.reason;
+	if (reason instanceof Error) throw reason;
+	if (reason) throw new Error(String(reason));
+	throw new Error("workflow aborted");
+}
+function groupReplayTargetsByPhase(targets) {
+	const groups = [];
+	for (const target of targets) {
+		const key = target.phaseId ?? "";
+		let group = groups.find((item) => item.key === key);
+		if (!group) {
+			group = {
+				key,
+				phaseId: target.phaseId,
+				phaseTitle: target.phaseTitle,
+				targets: []
+			};
+			groups.push(group);
+		}
+		group.targets.push(target);
+	}
+	return groups.map(({ key: _key, ...group }) => group);
+}
+function buildReplayResultEnvelope(options, results) {
+	return {
+		summary: `Replay completed for ${results.filter((item) => item.status === "done").length}/${results.length} target${results.length === 1 ? "" : "s"}.`,
+		sections: [{
+			kind: "json",
+			title: "Replay targets",
+			value: {
+				sourceRunId: options.sourceRunId,
+				scope: options.replayScope,
+				targets: results
+			}
+		}],
+		structuredOutput: { replay: {
+			sourceRunId: options.sourceRunId,
+			scope: options.replayScope,
+			targets: results
+		} }
+	};
+}
+function normalizeReplayInvocation(target) {
+	return {
+		prompt: target.invocation?.prompt ?? target.prompt,
+		label: target.invocation?.label ?? target.label,
+		phase: target.invocation?.phase ?? target.phaseTitle,
+		modelRef: target.invocation?.modelRef,
+		resolvedModelRef: target.invocation?.resolvedModelRef,
+		schema: target.invocation?.schema,
+		toolset: target.invocation?.toolset ? [...target.invocation.toolset] : void 0,
+		maxIterations: target.invocation?.maxIterations
+	};
+}
+function resolveReplayModel(invocation, resolveModelId) {
+	const modelRef = invocation.resolvedModelRef ?? invocation.modelRef;
+	if (!modelRef) return void 0;
+	if (!resolveModelId) throw new Error(`workflow replay missing resolveModelId; cannot resolve model '${modelRef}'`);
+	return resolveModelId(modelRef);
+}
 function formatRuntimeAgentId(id) {
 	return `agent-${id}`;
 }
@@ -346,23 +644,34 @@ function toWorkflowResultEnvelope(value) {
 		raw: value
 	};
 }
+function assertWorkflowOutput(definition, value) {
+	const validation = validateWorkflowJsonSchema(definition.outputSchema, value);
+	if (validation.ok) return;
+	throw new WorkflowEngineRunError("result_validation_failed", validation.message ?? "Workflow result did not match output schema", false, JSON.stringify(validation.errors ?? []));
+}
 function isWorkflowResultEnvelope(value) {
 	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
 	const record = value;
 	return typeof record.summary === "string" && Array.isArray(record.sections);
 }
-function toWorkflowRunError(err, wasAborted) {
-	const message = err instanceof Error ? err.message : String(err);
-	if (wasAborted || /aborted|cancelled/i.test(message)) return {
-		code: "cancelled",
-		message: message || "Workflow run cancelled",
-		recoverable: true
+function toWorkflowRunError(err, wasAborted, abortReason) {
+	if (err instanceof WorkflowEngineRunError) return {
+		code: err.code,
+		message: err.message,
+		detail: err.detail,
+		recoverable: err.recoverable
 	};
-	if (/timeout/i.test(message)) return {
+	const message = (abortReason instanceof Error ? abortReason.message : abortReason ? String(abortReason) : "") || (err instanceof Error ? err.message : String(err));
+	if (/timeout|timed out/i.test(message)) return {
 		code: "timeout",
 		message,
 		recoverable: true
 	};
+	if (wasAborted || /aborted|cancelled/i.test(message)) return {
+		code: "cancelled",
+		message: message || "Workflow run cancelled",
+		recoverable: true
+	};
 	if (/quota/i.test(message)) return {
 		code: "agent_quota_exceeded",
 		message,