@xopcai/xopc 0.0.142 → 0.0.143

package/dist/src/workflows/domain/definition.d.ts

@@ -9,21 +9,87 @@ export interface JsonSchema {
     description?: string;
     [key: string]: unknown;
 }
+export type WorkflowNodeKind = 'input' | 'agent' | 'decision' | 'merge' | 'output';
+export interface WorkflowCanvasPosition {
+    x: number;
+    y: number;
+}
+export interface WorkflowGraphNodeBase {
+    id: string;
+    kind: WorkflowNodeKind;
+    title: string;
+    description?: string;
+    phaseId?: string;
+    position: WorkflowCanvasPosition;
+}
+export interface WorkflowInputNode extends WorkflowGraphNodeBase {
+    kind: 'input';
+    config: {
+        schema?: JsonSchema;
+    };
+}
+export interface WorkflowAgentNode extends WorkflowGraphNodeBase {
+    kind: 'agent';
+    config: {
+        prompt: string;
+        model?: string;
+        toolset?: string[];
+        maxIterations?: number;
+        outputSchema?: JsonSchema;
+    };
+}
+export interface WorkflowDecisionRule {
+    path: string;
+    operator: 'exists' | 'equals' | 'not_equals' | 'contains';
+    value?: unknown;
+}
+export interface WorkflowDecisionNode extends WorkflowGraphNodeBase {
+    kind: 'decision';
+    config: {
+        rule: WorkflowDecisionRule;
+    };
+}
+export interface WorkflowMergeNode extends WorkflowGraphNodeBase {
+    kind: 'merge';
+    config: {
+        mode: 'array' | 'object';
+    };
+}
+export interface WorkflowOutputNode extends WorkflowGraphNodeBase {
+    kind: 'output';
+    config: {
+        summary?: string;
+        title?: string;
+    };
+}
+export type WorkflowGraphNode = WorkflowInputNode | WorkflowAgentNode | WorkflowDecisionNode | WorkflowMergeNode | WorkflowOutputNode;
+export interface WorkflowGraphEdge {
+    id: string;
+    source: string;
+    target: string;
+    sourcePort?: 'true' | 'false' | 'default';
+}
+export interface WorkflowGraph {
+    schemaVersion: 1;
+    nodes: WorkflowGraphNode[];
+    edges: WorkflowGraphEdge[];
+}
 export interface WorkflowDefinition {
     id: string;
     name: string;
     title: string;
     description: string;
     version: string;
+    revision: number;
     contentHash?: string;
-    runtimeHash?: string;
     inputSchema?: JsonSchema;
     outputSchema?: JsonSchema;
     phases: WorkflowPhaseDefinition[];
-    runtime: WorkflowRuntimeDefinition;
+    graph: WorkflowGraph;
     defaults: WorkflowDefinitionDefaults;
     permissions?: WorkflowPermissionPolicy;
     resources?: WorkflowResourceRefs;
+    connectors?: WorkflowConnectorRequirement[];
     metadata: WorkflowDefinitionMetadata;
 }
 export interface WorkflowDefinitionManifest {
@@ -35,8 +101,19 @@ export interface WorkflowDefinitionManifest {
     defaults?: Partial<WorkflowDefinitionDefaults>;
     tags?: string[];
     whenToUse?: string;
+    estimatedAgents?: WorkflowDefinitionEstimatedAgents;
+    examplePrompts?: WorkflowDefinitionExamplePrompt[];
+    i18n?: Record<string, WorkflowDefinitionLocale>;
     permissions?: WorkflowPermissionPolicy;
     resources?: WorkflowResourceRefs;
+    connectors?: WorkflowConnectorRequirement[];
+}
+export interface WorkflowConnectorRequirement {
+    connectorId: string;
+    scope?: 'read' | 'write' | 'admin';
+    connectionRequired?: boolean;
+    optional?: boolean;
+    reason?: string;
 }
 export interface WorkflowPermissionPolicy {
     tools?: string[];
@@ -54,10 +131,6 @@ export interface WorkflowPhaseDefinition {
     title: string;
     description?: string;
 }
-export interface WorkflowRuntimeDefinition {
-    kind: 'script';
-    source: string;
-}
 export interface WorkflowDefinitionDefaults {
     concurrency: number;
     timeoutSec: number;

package/dist/src/workflows/domain/event.d.ts

@@ -1,6 +1,6 @@
 import type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';
 import type { WorkflowAgentInvocationSnapshot, WorkflowRun, WorkflowRunError } from './run.js';
-export type WorkflowEventType = 'run_queued' | 'run_started' | 'phase_started' | 'phase_completed' | 'agent_queued' | 'agent_started' | 'agent_step_started' | 'agent_step_completed' | 'agent_completed' | 'log_appended' | 'artifact_created' | 'run_completed' | 'run_failed' | 'run_cancelled';
+export type WorkflowEventType = 'run_queued' | 'run_started' | 'phase_started' | 'phase_completed' | 'node_started' | 'node_completed' | 'agent_queued' | 'agent_started' | 'agent_step_started' | 'agent_step_completed' | 'agent_completed' | 'log_appended' | 'artifact_created' | 'run_completed' | 'run_failed' | 'run_cancelled';
 export interface WorkflowEventEnvelope<T = WorkflowEventPayload> {
     id: string;
     runId: string;
@@ -9,7 +9,7 @@ export interface WorkflowEventEnvelope<T = WorkflowEventPayload> {
     payload: T;
     createdAtMs: number;
 }
-export type WorkflowEventPayload = RunQueuedPayload | RunStartedPayload | PhaseStartedPayload | PhaseCompletedPayload | AgentQueuedPayload | AgentStartedPayload | AgentStepStartedPayload | AgentStepCompletedPayload | AgentCompletedPayload | LogAppendedPayload | ArtifactCreatedPayload | RunCompletedPayload | RunFailedPayload | RunCancelledPayload;
+export type WorkflowEventPayload = RunQueuedPayload | RunStartedPayload | PhaseStartedPayload | PhaseCompletedPayload | NodeStartedPayload | NodeCompletedPayload | AgentQueuedPayload | AgentStartedPayload | AgentStepStartedPayload | AgentStepCompletedPayload | AgentCompletedPayload | LogAppendedPayload | ArtifactCreatedPayload | RunCompletedPayload | RunFailedPayload | RunCancelledPayload;
 export interface RunQueuedPayload {
     run: WorkflowRun;
 }
@@ -23,8 +23,22 @@ export interface PhaseStartedPayload {
 export interface PhaseCompletedPayload {
     phaseId: string;
 }
+export interface NodeStartedPayload {
+    nodeId: string;
+    kind: string;
+    title: string;
+}
+export interface NodeCompletedPayload {
+    nodeId: string;
+    kind: string;
+    title: string;
+    status: 'done' | 'error' | 'skipped';
+    resultPreview?: string;
+    error?: string;
+}
 export interface AgentQueuedPayload {
     agentId: string;
+    nodeId: string;
     label: string;
     phaseId?: string;
     prompt?: string;
@@ -33,6 +47,7 @@ export interface AgentQueuedPayload {
 }
 export interface AgentStartedPayload {
     agentId: string;
+    nodeId?: string;
 }
 export interface AgentStepStartedPayload {
     agentId: string;
@@ -51,6 +66,7 @@ export interface AgentStepCompletedPayload {
 }
 export interface AgentCompletedPayload {
     agentId: string;
+    nodeId?: string;
     status: 'done' | 'error' | 'skipped';
     resultPreview?: string;
     error?: string;

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

@@ -1,5 +1,5 @@
-import { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, hashWorkflowStableValue, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle } from "./definition-utils.js";
+import { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, deriveWorkflowPhases, hashWorkflowStableValue, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle } from "./definition-utils.js";
+import { validateWorkflowDefinitionInput, validateWorkflowGraph } from "./validation.js";
 import { validateWorkflowJsonSchema } from "./schema-validation.js";
 import { isTerminalWorkflowRunStatus } from "./run.js";
-import { validateWorkflowDefinitionInput } from "./validation.js";
-export { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, hashWorkflowStableValue, isTerminalWorkflowRunStatus, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle, validateWorkflowDefinitionInput, validateWorkflowJsonSchema };
+export { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, deriveWorkflowPhases, hashWorkflowStableValue, isTerminalWorkflowRunStatus, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle, validateWorkflowDefinitionInput, validateWorkflowGraph, validateWorkflowJsonSchema };

package/dist/src/workflows/domain/run.d.ts

@@ -1,4 +1,4 @@
-import type { WorkflowDefinitionDefaults, WorkflowDefinitionEstimatedAgents, WorkflowPermissionPolicy, WorkflowResourceRefs } from './definition.js';
+import type { WorkflowDefinitionDefaults, WorkflowDefinitionEstimatedAgents, WorkflowGraph, WorkflowPermissionPolicy, WorkflowResourceRefs } from './definition.js';
 import type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';
 export type WorkflowRunStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'timeout';
 export declare function isTerminalWorkflowRunStatus(status: WorkflowRunStatus): boolean;
@@ -91,7 +91,8 @@ export interface WorkflowRunDefinitionSnapshot {
     title: string;
     version: string;
     contentHash?: string;
-    runtimeHash?: string;
+    revision: number;
+    graph: WorkflowGraph;
     source: 'builtin' | 'user';
     tags: string[];
     phaseCount: number;
@@ -160,11 +161,22 @@ export interface WorkflowRunView {
     run: WorkflowRun;
     phases: WorkflowPhaseView[];
     agents: WorkflowAgentView[];
+    nodes: WorkflowNodeView[];
     logs: WorkflowLogEntry[];
     artifacts: WorkflowArtifactRef[];
     timeline: WorkflowTimelineItem[];
     controls: WorkflowRunControls;
 }
+export interface WorkflowNodeView {
+    id: string;
+    kind: string;
+    title: string;
+    status: 'pending' | 'running' | 'done' | 'error' | 'skipped';
+    resultPreview?: string;
+    error?: string;
+    startedAtMs?: number;
+    completedAtMs?: number;
+}
 export type WorkflowPhaseStatus = 'pending' | 'running' | 'completed' | 'failed';
 export interface WorkflowPhaseView {
     id: string;
@@ -177,6 +189,7 @@ export interface WorkflowPhaseView {
 export type WorkflowAgentStatus = 'queued' | 'running' | 'done' | 'error' | 'skipped';
 export interface WorkflowAgentView {
     id: string;
+    nodeId?: string;
     label: string;
     phaseId?: string;
     status: WorkflowAgentStatus;
@@ -192,6 +205,7 @@ export interface WorkflowAgentView {
     steps: WorkflowAgentStepView[];
 }
 export interface WorkflowAgentInvocationSnapshot {
+    nodeId?: string;
     prompt: string;
     label: string;
     phase?: string;

package/dist/src/workflows/domain/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","names":[],"sources":["../../../../src/workflows/domain/run.ts"],"sourcesContent":["import type { WorkflowDefinitionDefaults, WorkflowDefinitionEstimatedAgents, WorkflowPermissionPolicy, WorkflowResourceRefs } from './definition.js';\nimport type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';\n\nexport type WorkflowRunStatus =\n  | 'queued'\n  | 'running'\n  | 'succeeded'\n  | 'failed'\n  | 'cancelled'\n  | 'timeout';\n\nconst TERMINAL_WORKFLOW_RUN_STATUSES = new Set<WorkflowRunStatus>([\n  'succeeded',\n  'failed',\n  'cancelled',\n  'timeout',\n]);\n\nexport function isTerminalWorkflowRunStatus(status: WorkflowRunStatus): boolean {\n  return TERMINAL_WORKFLOW_RUN_STATUSES.has(status);\n}\n\nexport interface WorkflowRun {\n  id: string;\n  definitionId: string;\n  definitionVersion: string;\n  title: string;\n  goal: string;\n  input: unknown;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  result?: WorkflowResultEnvelope;\n  error?: WorkflowRunError;\n  metrics: WorkflowRunMetrics;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowRunMetadata {\n  sessionKey: string;\n  triggerSource: WorkflowRunSource['kind'];\n  agentId?: string;\n  projectId?: string;\n  workItemId?: string;\n  contextRefs?: WorkflowRunContextRef[];\n  writebackPolicy?: WorkflowRunWritebackPolicy;\n  retryOfRunId?: string;\n  replay?: WorkflowRunReplayMetadata;\n  definition: WorkflowRunDefinitionSnapshot;\n  input?: WorkflowRunInputEnvelope;\n  correlation?: WorkflowRunCorrelation;\n  origin?: WorkflowRunOrigin;\n  schedule?: WorkflowRunScheduleMetadata;\n  goalId?: string;\n}\n\nexport type WorkflowRunReplayScope = 'failed_agents' | 'failed_phases';\n\nexport interface WorkflowRunContextRef {\n  kind: 'project' | 'goal' | 'work_item' | 'session' | 'attachment' | 'memory';\n  id: string;\n  role?: string;\n  title?: string;\n}\n\nexport interface WorkflowRunWritebackPolicy {\n  targets: WorkflowRunWritebackTarget[];\n}\n\nexport interface WorkflowRunWritebackTarget {\n  kind: 'project' | 'goal' | 'work_item';\n  id: string;\n  mode: 'record' | 'suggest' | 'evaluate';\n}\n\nexport interface WorkflowRunReplayMetadata {\n  sourceRunId: string;\n  scope: WorkflowRunReplayScope;\n  phaseIds?: string[];\n  agentIds: string[];\n  targetCount: number;\n  createdAtMs: number;\n}\n\nexport interface WorkflowRunInputEnvelope {\n  payload: unknown;\n  goal?: string;\n  variables?: Record<string, unknown>;\n  context?: Record<string, unknown>;\n}\n\nexport interface WorkflowRunCorrelation {\n  idempotencyKey?: string;\n  requestId?: string;\n  traceId?: string;\n  parentRunId?: string;\n}\n\nexport interface WorkflowRunOrigin {\n  channel: string;\n  sessionKey?: string;\n  chatId?: string;\n  messageId?: string;\n  automationId?: string;\n  runId?: string;\n  requestId?: string;\n}\n\nexport interface WorkflowRunScheduleMetadata {\n  automationId: string;\n  runId?: string;\n  scheduledAtMs?: number;\n}\n\nexport interface WorkflowRunDefinitionSnapshot {\n  id: string;\n  name: string;\n  title: string;\n  version: string;\n  contentHash?: string;\n  runtimeHash?: string;\n  source: 'builtin' | 'user';\n  tags: string[];\n  phaseCount: number;\n  defaults?: WorkflowDefinitionDefaults;\n  permissions?: WorkflowPermissionPolicy;\n  resources?: WorkflowResourceRefs;\n  estimatedAgents?: WorkflowDefinitionEstimatedAgents;\n}\n\nexport type WorkflowRunSource =\n  | { kind: 'chat'; sessionKey: string; messageId?: string }\n  | { kind: 'webui'; sessionKey?: string; requestId?: string }\n  | { kind: 'automation'; automationId: string; runId?: string; scheduledAtMs?: number }\n  | { kind: 'api'; requestId?: string; idempotencyKey?: string }\n  | { kind: 'im'; channel: string; chatId: string; messageId?: string; userId?: string };\n\nexport interface WorkflowRunMetrics {\n  agentCount: number;\n  doneAgentCount: number;\n  errorAgentCount: number;\n  skippedAgentCount: number;\n  artifactCount: number;\n  durationMs?: number;\n}\n\nexport interface WorkflowRunError {\n  code: WorkflowRunErrorCode;\n  message: string;\n  detail?: string;\n  recoverable: boolean;\n}\n\nexport type WorkflowRunErrorCode =\n  | 'definition_not_found'\n  | 'invalid_input'\n  | 'runtime_error'\n  | 'timeout'\n  | 'cancelled'\n  | 'result_validation_failed'\n  | 'agent_quota_exceeded';\n\nexport interface WorkflowRunControls {\n  canCancel: boolean;\n  canRetry: boolean;\n  canArchive: boolean;\n}\n\nexport interface WorkflowRunSummary {\n  id: string;\n  definitionId: string;\n  title: string;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  metrics: WorkflowRunMetrics;\n}\n\nexport interface WorkflowRunView {\n  run: WorkflowRun;\n  phases: WorkflowPhaseView[];\n  agents: WorkflowAgentView[];\n  logs: WorkflowLogEntry[];\n  artifacts: WorkflowArtifactRef[];\n  timeline: WorkflowTimelineItem[];\n  controls: WorkflowRunControls;\n}\n\nexport type WorkflowPhaseStatus = 'pending' | 'running' | 'completed' | 'failed';\n\nexport interface WorkflowPhaseView {\n  id: string;\n  title: string;\n  status: WorkflowPhaseStatus;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  agentIds: string[];\n}\n\nexport type WorkflowAgentStatus = 'queued' | 'running' | 'done' | 'error' | 'skipped';\n\nexport interface WorkflowAgentView {\n  id: string;\n  label: string;\n  phaseId?: string;\n  status: WorkflowAgentStatus;\n  prompt?: string;\n  invocation?: WorkflowAgentInvocationSnapshot;\n  sessionKey: string;\n  transcriptMessageCount: number;\n  currentStep?: string;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  steps: WorkflowAgentStepView[];\n}\n\nexport interface WorkflowAgentInvocationSnapshot {\n  prompt: string;\n  label: string;\n  phase?: string;\n  modelRef?: string;\n  resolvedModelRef?: string;\n  schema?: unknown;\n  toolset?: string[];\n  maxIterations?: number;\n}\n\nexport type WorkflowAgentStepStatus = 'running' | 'done' | 'error';\n\nexport interface WorkflowAgentStepView {\n  id: string;\n  label: string;\n  kind: 'tool' | 'llm' | 'thinking';\n  toolName?: string;\n  detail?: string;\n  status: WorkflowAgentStepStatus;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowLogEntry {\n  sequence: number;\n  message: string;\n  createdAtMs: number;\n}\n\nexport interface WorkflowTimelineItem {\n  sequence: number;\n  type: string;\n  title: string;\n  createdAtMs: number;\n}\n"],"mappings":";AAWA,MAAM,iCAAiC,IAAI,IAAuB;CAChE;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,4BAA4B,QAAoC;AAC9E,QAAO,+BAA+B,IAAI,OAAO"}
+{"version":3,"file":"run.js","names":[],"sources":["../../../../src/workflows/domain/run.ts"],"sourcesContent":["import type { WorkflowDefinitionDefaults, WorkflowDefinitionEstimatedAgents, WorkflowGraph, WorkflowPermissionPolicy, WorkflowResourceRefs } from './definition.js';\nimport type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';\n\nexport type WorkflowRunStatus =\n  | 'queued'\n  | 'running'\n  | 'succeeded'\n  | 'failed'\n  | 'cancelled'\n  | 'timeout';\n\nconst TERMINAL_WORKFLOW_RUN_STATUSES = new Set<WorkflowRunStatus>([\n  'succeeded',\n  'failed',\n  'cancelled',\n  'timeout',\n]);\n\nexport function isTerminalWorkflowRunStatus(status: WorkflowRunStatus): boolean {\n  return TERMINAL_WORKFLOW_RUN_STATUSES.has(status);\n}\n\nexport interface WorkflowRun {\n  id: string;\n  definitionId: string;\n  definitionVersion: string;\n  title: string;\n  goal: string;\n  input: unknown;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  result?: WorkflowResultEnvelope;\n  error?: WorkflowRunError;\n  metrics: WorkflowRunMetrics;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowRunMetadata {\n  sessionKey: string;\n  triggerSource: WorkflowRunSource['kind'];\n  agentId?: string;\n  projectId?: string;\n  workItemId?: string;\n  contextRefs?: WorkflowRunContextRef[];\n  writebackPolicy?: WorkflowRunWritebackPolicy;\n  retryOfRunId?: string;\n  replay?: WorkflowRunReplayMetadata;\n  definition: WorkflowRunDefinitionSnapshot;\n  input?: WorkflowRunInputEnvelope;\n  correlation?: WorkflowRunCorrelation;\n  origin?: WorkflowRunOrigin;\n  schedule?: WorkflowRunScheduleMetadata;\n  goalId?: string;\n}\n\nexport type WorkflowRunReplayScope = 'failed_agents' | 'failed_phases';\n\nexport interface WorkflowRunContextRef {\n  kind: 'project' | 'goal' | 'work_item' | 'session' | 'attachment' | 'memory';\n  id: string;\n  role?: string;\n  title?: string;\n}\n\nexport interface WorkflowRunWritebackPolicy {\n  targets: WorkflowRunWritebackTarget[];\n}\n\nexport interface WorkflowRunWritebackTarget {\n  kind: 'project' | 'goal' | 'work_item';\n  id: string;\n  mode: 'record' | 'suggest' | 'evaluate';\n}\n\nexport interface WorkflowRunReplayMetadata {\n  sourceRunId: string;\n  scope: WorkflowRunReplayScope;\n  phaseIds?: string[];\n  agentIds: string[];\n  targetCount: number;\n  createdAtMs: number;\n}\n\nexport interface WorkflowRunInputEnvelope {\n  payload: unknown;\n  goal?: string;\n  variables?: Record<string, unknown>;\n  context?: Record<string, unknown>;\n}\n\nexport interface WorkflowRunCorrelation {\n  idempotencyKey?: string;\n  requestId?: string;\n  traceId?: string;\n  parentRunId?: string;\n}\n\nexport interface WorkflowRunOrigin {\n  channel: string;\n  sessionKey?: string;\n  chatId?: string;\n  messageId?: string;\n  automationId?: string;\n  runId?: string;\n  requestId?: string;\n}\n\nexport interface WorkflowRunScheduleMetadata {\n  automationId: string;\n  runId?: string;\n  scheduledAtMs?: number;\n}\n\nexport interface WorkflowRunDefinitionSnapshot {\n  id: string;\n  name: string;\n  title: string;\n  version: string;\n  contentHash?: string;\n  revision: number;\n  graph: WorkflowGraph;\n  source: 'builtin' | 'user';\n  tags: string[];\n  phaseCount: number;\n  defaults?: WorkflowDefinitionDefaults;\n  permissions?: WorkflowPermissionPolicy;\n  resources?: WorkflowResourceRefs;\n  estimatedAgents?: WorkflowDefinitionEstimatedAgents;\n}\n\nexport type WorkflowRunSource =\n  | { kind: 'chat'; sessionKey: string; messageId?: string }\n  | { kind: 'webui'; sessionKey?: string; requestId?: string }\n  | { kind: 'automation'; automationId: string; runId?: string; scheduledAtMs?: number }\n  | { kind: 'api'; requestId?: string; idempotencyKey?: string }\n  | { kind: 'im'; channel: string; chatId: string; messageId?: string; userId?: string };\n\nexport interface WorkflowRunMetrics {\n  agentCount: number;\n  doneAgentCount: number;\n  errorAgentCount: number;\n  skippedAgentCount: number;\n  artifactCount: number;\n  durationMs?: number;\n}\n\nexport interface WorkflowRunError {\n  code: WorkflowRunErrorCode;\n  message: string;\n  detail?: string;\n  recoverable: boolean;\n}\n\nexport type WorkflowRunErrorCode =\n  | 'definition_not_found'\n  | 'invalid_input'\n  | 'runtime_error'\n  | 'timeout'\n  | 'cancelled'\n  | 'result_validation_failed'\n  | 'agent_quota_exceeded';\n\nexport interface WorkflowRunControls {\n  canCancel: boolean;\n  canRetry: boolean;\n  canArchive: boolean;\n}\n\nexport interface WorkflowRunSummary {\n  id: string;\n  definitionId: string;\n  title: string;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  metrics: WorkflowRunMetrics;\n}\n\nexport interface WorkflowRunView {\n  run: WorkflowRun;\n  phases: WorkflowPhaseView[];\n  agents: WorkflowAgentView[];\n  nodes: WorkflowNodeView[];\n  logs: WorkflowLogEntry[];\n  artifacts: WorkflowArtifactRef[];\n  timeline: WorkflowTimelineItem[];\n  controls: WorkflowRunControls;\n}\n\nexport interface WorkflowNodeView {\n  id: string;\n  kind: string;\n  title: string;\n  status: 'pending' | 'running' | 'done' | 'error' | 'skipped';\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport type WorkflowPhaseStatus = 'pending' | 'running' | 'completed' | 'failed';\n\nexport interface WorkflowPhaseView {\n  id: string;\n  title: string;\n  status: WorkflowPhaseStatus;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  agentIds: string[];\n}\n\nexport type WorkflowAgentStatus = 'queued' | 'running' | 'done' | 'error' | 'skipped';\n\nexport interface WorkflowAgentView {\n  id: string;\n  nodeId?: string;\n  label: string;\n  phaseId?: string;\n  status: WorkflowAgentStatus;\n  prompt?: string;\n  invocation?: WorkflowAgentInvocationSnapshot;\n  sessionKey: string;\n  transcriptMessageCount: number;\n  currentStep?: string;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  steps: WorkflowAgentStepView[];\n}\n\nexport interface WorkflowAgentInvocationSnapshot {\n  nodeId?: string;\n  prompt: string;\n  label: string;\n  phase?: string;\n  modelRef?: string;\n  resolvedModelRef?: string;\n  schema?: unknown;\n  toolset?: string[];\n  maxIterations?: number;\n}\n\nexport type WorkflowAgentStepStatus = 'running' | 'done' | 'error';\n\nexport interface WorkflowAgentStepView {\n  id: string;\n  label: string;\n  kind: 'tool' | 'llm' | 'thinking';\n  toolName?: string;\n  detail?: string;\n  status: WorkflowAgentStepStatus;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowLogEntry {\n  sequence: number;\n  message: string;\n  createdAtMs: number;\n}\n\nexport interface WorkflowTimelineItem {\n  sequence: number;\n  type: string;\n  title: string;\n  createdAtMs: number;\n}\n"],"mappings":";AAWA,MAAM,iCAAiC,IAAI,IAAuB;CAChE;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,4BAA4B,QAAoC;AAC9E,QAAO,+BAA+B,IAAI,OAAO"}

package/dist/src/workflows/domain/validation.d.ts

@@ -1,10 +1,11 @@
-import type { WorkflowDefinition } from './definition.js';
-export type WorkflowDefinitionValidationIssueCode = 'name_required' | 'script_required' | 'parse_failed' | 'meta_name_mismatch' | 'unknown_error';
+import type { WorkflowDefinition, WorkflowGraph } from './definition.js';
+export type WorkflowDefinitionValidationIssueCode = 'name_required' | 'invalid_name' | 'graph_required' | 'invalid_schema_version' | 'duplicate_node' | 'missing_input' | 'multiple_inputs' | 'missing_output' | 'multiple_outputs' | 'unknown_edge_node' | 'duplicate_edge' | 'self_edge' | 'cycle_detected' | 'unreachable_node' | 'dead_end_node' | 'missing_prompt' | 'invalid_node_config';
 export interface WorkflowDefinitionValidationIssue {
     code: WorkflowDefinitionValidationIssueCode;
     message: string;
-    line?: number;
-    column?: number;
+    nodeId?: string;
+    edgeId?: string;
+    field?: string;
 }
 export interface WorkflowDefinitionValidationResult {
     valid: boolean;
@@ -14,6 +15,9 @@ export interface WorkflowDefinitionValidationResult {
 }
 export interface ValidateWorkflowDefinitionInput {
     name?: string;
-    script?: string;
+    graph?: WorkflowGraph;
+    title?: string;
+    description?: string;
 }
 export declare function validateWorkflowDefinitionInput(input: ValidateWorkflowDefinitionInput): WorkflowDefinitionValidationResult;
+export declare function validateWorkflowGraph(graph: WorkflowGraph, errors?: WorkflowDefinitionValidationIssue[], warnings?: WorkflowDefinitionValidationIssue[]): WorkflowDefinitionValidationResult;

package/dist/src/workflows/domain/validation.js

@@ -1,66 +1,209 @@
-import { parseWorkflowScript } from "../../agent/workflow/parser.js";
 import { buildWorkflowDefinition } from "./definition-utils.js";
 //#region src/workflows/domain/validation.ts
 const NAME_RE = /^[a-z][a-z0-9_-]*$/;
 function validateWorkflowDefinitionInput(input) {
 	const name = input.name?.trim() ?? "";
-	const script = input.script ?? "";
 	const errors = [];
 	const warnings = [];
 	if (!name) errors.push({
 		code: "name_required",
-		message: "Workflow name is required."
+		message: "Workflow name is required.",
+		field: "name"
 	});
 	else if (!NAME_RE.test(name)) errors.push({
-		code: "parse_failed",
-		message: `Invalid workflow name "${name}". Use lowercase snake_case, e.g. "audit_repo".`
+		code: "invalid_name",
+		message: `Invalid workflow name "${name}". Use lowercase snake_case.`,
+		field: "name"
 	});
-	if (!script.trim()) errors.push({
-		code: "script_required",
-		message: "Workflow script is required."
+	if (!input.graph) errors.push({
+		code: "graph_required",
+		message: "Workflow graph is required.",
+		field: "graph"
 	});
-	if (errors.length > 0) return {
+	else validateWorkflowGraph(input.graph, errors, warnings);
+	if (errors.length > 0 || !input.graph) return {
 		valid: false,
 		errors,
 		warnings
 	};
-	try {
-		const { meta } = parseWorkflowScript(script);
-		if (meta.name !== name) {
+	return {
+		valid: true,
+		errors,
+		warnings,
+		definition: buildWorkflowDefinition({
+			name,
+			source: "user",
+			graph: input.graph,
+			manifest: {
+				title: input.title,
+				description: input.description
+			}
+		})
+	};
+}
+function validateWorkflowGraph(graph, errors = [], warnings = []) {
+	if (graph.schemaVersion !== 1) errors.push({
+		code: "invalid_schema_version",
+		message: "Workflow graph schemaVersion must be 1.",
+		field: "schemaVersion"
+	});
+	const nodes = /* @__PURE__ */ new Map();
+	for (const node of graph.nodes) {
+		if (nodes.has(node.id)) {
 			errors.push({
-				code: "meta_name_mismatch",
-				message: `meta.name "${meta.name}" does not match workflow name "${name}".`
+				code: "duplicate_node",
+				message: `Duplicate node id "${node.id}".`,
+				nodeId: node.id
 			});
-			return {
-				valid: false,
-				errors,
-				warnings
-			};
+			continue;
 		}
-		return {
-			valid: true,
-			errors,
-			warnings,
-			definition: buildWorkflowDefinition({
-				name,
-				source: "user",
-				script,
-				meta
-			})
-		};
-	} catch (err) {
-		errors.push({
-			code: "parse_failed",
-			message: err instanceof Error ? err.message : String(err)
+		nodes.set(node.id, node);
+		validateNode(node, errors);
+	}
+	const inputs = graph.nodes.filter((node) => node.kind === "input");
+	const outputs = graph.nodes.filter((node) => node.kind === "output");
+	if (inputs.length === 0) errors.push({
+		code: "missing_input",
+		message: "Workflow needs one input node."
+	});
+	if (inputs.length > 1) errors.push({
+		code: "multiple_inputs",
+		message: "Workflow can only have one input node."
+	});
+	if (outputs.length === 0) errors.push({
+		code: "missing_output",
+		message: "Workflow needs one output node."
+	});
+	if (outputs.length > 1) errors.push({
+		code: "multiple_outputs",
+		message: "Workflow can only have one output node."
+	});
+	const edgeKeys = /* @__PURE__ */ new Set();
+	const outgoing = /* @__PURE__ */ new Map();
+	const incoming = /* @__PURE__ */ new Map();
+	const indegree = new Map(graph.nodes.map((node) => [node.id, 0]));
+	for (const edge of graph.edges) {
+		const key = `${edge.source}:${edge.target}:${edge.sourcePort ?? "default"}`;
+		if (edgeKeys.has(key)) errors.push({
+			code: "duplicate_edge",
+			message: `Duplicate edge ${edge.source} → ${edge.target}.`,
+			edgeId: edge.id
 		});
-		return {
-			valid: false,
-			errors,
-			warnings
-		};
+		edgeKeys.add(key);
+		if (!nodes.has(edge.source) || !nodes.has(edge.target)) {
+			errors.push({
+				code: "unknown_edge_node",
+				message: `Edge "${edge.id}" references a missing node.`,
+				edgeId: edge.id
+			});
+			continue;
+		}
+		if (edge.source === edge.target) {
+			errors.push({
+				code: "self_edge",
+				message: `Node "${edge.source}" cannot connect to itself.`,
+				edgeId: edge.id
+			});
+			continue;
+		}
+		outgoing.set(edge.source, [...outgoing.get(edge.source) ?? [], edge.target]);
+		incoming.set(edge.target, [...incoming.get(edge.target) ?? [], edge.source]);
+		indegree.set(edge.target, (indegree.get(edge.target) ?? 0) + 1);
+		const sourceNode = nodes.get(edge.source);
+		if (sourceNode.kind === "decision" && edge.sourcePort !== "true" && edge.sourcePort !== "false") errors.push({
+			code: "invalid_node_config",
+			message: `Decision edge "${edge.id}" must use a true or false branch.`,
+			edgeId: edge.id
+		});
+		if (sourceNode.kind !== "decision" && edge.sourcePort && edge.sourcePort !== "default") errors.push({
+			code: "invalid_node_config",
+			message: `Only decision nodes can use branch edges.`,
+			edgeId: edge.id
+		});
+	}
+	if (nodes.size > 0 && !isAcyclic(indegree, outgoing)) errors.push({
+		code: "cycle_detected",
+		message: "Workflow graph must not contain a cycle."
+	});
+	if (inputs.length === 1) {
+		const reachable = collectReachable(inputs[0].id, outgoing);
+		for (const node of graph.nodes) if (!reachable.has(node.id)) errors.push({
+			code: "unreachable_node",
+			message: `Node "${node.title}" is not connected to the workflow input.`,
+			nodeId: node.id
+		});
+	}
+	if (outputs.length === 1) {
+		const reachesOutput = collectReachable(outputs[0].id, incoming);
+		for (const node of graph.nodes) if (!reachesOutput.has(node.id)) errors.push({
+			code: "dead_end_node",
+			message: `Node "${node.title}" does not lead to the workflow output.`,
+			nodeId: node.id
+		});
+	}
+	for (const node of graph.nodes) {
+		if (node.kind !== "decision") continue;
+		const ports = graph.edges.filter((edge) => edge.source === node.id).map((edge) => edge.sourcePort);
+		if (!ports.includes("true") || !ports.includes("false")) errors.push({
+			code: "invalid_node_config",
+			message: `Decision node "${node.title}" needs both true and false branches.`,
+			nodeId: node.id
+		});
+	}
+	return {
+		valid: errors.length === 0,
+		errors,
+		warnings
+	};
+}
+function validateNode(node, errors) {
+	if (!node.id.trim() || !node.title.trim()) errors.push({
+		code: "invalid_node_config",
+		message: "Every node needs a stable id and title.",
+		nodeId: node.id
+	});
+	if (node.kind === "agent" && !node.config.prompt.trim()) errors.push({
+		code: "missing_prompt",
+		message: `Agent node "${node.title}" needs an instruction.`,
+		nodeId: node.id,
+		field: "config.prompt"
+	});
+	if (node.kind === "agent" && node.config.maxIterations !== void 0) {
+		if (!Number.isFinite(node.config.maxIterations) || node.config.maxIterations < 1) errors.push({
+			code: "invalid_node_config",
+			message: `Agent node "${node.title}" has an invalid iteration limit.`,
+			nodeId: node.id,
+			field: "config.maxIterations"
+		});
+	}
+}
+function isAcyclic(indegreeInput, outgoing) {
+	const indegree = new Map(indegreeInput);
+	const queue = [...indegree.entries()].filter(([, count]) => count === 0).map(([id]) => id);
+	let visited = 0;
+	while (queue.length > 0) {
+		const id = queue.shift();
+		visited += 1;
+		for (const target of outgoing.get(id) ?? []) {
+			const next = (indegree.get(target) ?? 0) - 1;
+			indegree.set(target, next);
+			if (next === 0) queue.push(target);
+		}
+	}
+	return visited === indegree.size;
+}
+function collectReachable(start, outgoing) {
+	const seen = /* @__PURE__ */ new Set();
+	const queue = [start];
+	while (queue.length > 0) {
+		const id = queue.shift();
+		if (seen.has(id)) continue;
+		seen.add(id);
+		queue.push(...outgoing.get(id) ?? []);
 	}
+	return seen;
 }
 //#endregion
-export { validateWorkflowDefinitionInput };
+export { validateWorkflowDefinitionInput, validateWorkflowGraph };
 
 //# sourceMappingURL=validation.js.map

package/dist/src/workflows/domain/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","names":[],"sources":["../../../../src/workflows/domain/validation.ts"],"sourcesContent":["import { parseWorkflowScript } from '../../agent/workflow/parser.js';\n\nimport type { WorkflowDefinition } from './definition.js';\nimport { buildWorkflowDefinition } from './definition-utils.js';\n\nexport type WorkflowDefinitionValidationIssueCode =\n  | 'name_required'\n  | 'script_required'\n  | 'parse_failed'\n  | 'meta_name_mismatch'\n  | 'unknown_error';\n\nexport interface WorkflowDefinitionValidationIssue {\n  code: WorkflowDefinitionValidationIssueCode;\n  message: string;\n  line?: number;\n  column?: number;\n}\n\nexport interface WorkflowDefinitionValidationResult {\n  valid: boolean;\n  errors: WorkflowDefinitionValidationIssue[];\n  warnings: WorkflowDefinitionValidationIssue[];\n  definition?: WorkflowDefinition;\n}\n\nexport interface ValidateWorkflowDefinitionInput {\n  name?: string;\n  script?: string;\n}\n\nconst NAME_RE = /^[a-z][a-z0-9_-]*$/;\n\nexport function validateWorkflowDefinitionInput(\n  input: ValidateWorkflowDefinitionInput,\n): WorkflowDefinitionValidationResult {\n  const name = input.name?.trim() ?? '';\n  const script = input.script ?? '';\n  const errors: WorkflowDefinitionValidationIssue[] = [];\n  const warnings: WorkflowDefinitionValidationIssue[] = [];\n\n  if (!name) {\n    errors.push({ code: 'name_required', message: 'Workflow name is required.' });\n  } else if (!NAME_RE.test(name)) {\n    errors.push({\n      code: 'parse_failed',\n      message: `Invalid workflow name \"${name}\". Use lowercase snake_case, e.g. \"audit_repo\".`,\n    });\n  }\n\n  if (!script.trim()) {\n    errors.push({ code: 'script_required', message: 'Workflow script is required.' });\n  }\n\n  if (errors.length > 0) {\n    return { valid: false, errors, warnings };\n  }\n\n  try {\n    const { meta } = parseWorkflowScript(script);\n    if (meta.name !== name) {\n      errors.push({\n        code: 'meta_name_mismatch',\n        message: `meta.name \"${meta.name}\" does not match workflow name \"${name}\".`,\n      });\n      return { valid: false, errors, warnings };\n    }\n\n    return {\n      valid: true,\n      errors,\n      warnings,\n      definition: buildWorkflowDefinition({\n        name,\n        source: 'user',\n        script,\n        meta,\n      }),\n    };\n  } catch (err) {\n    errors.push({\n      code: 'parse_failed',\n      message: err instanceof Error ? err.message : String(err),\n    });\n    return { valid: false, errors, warnings };\n  }\n}\n"],"mappings":";;;AA+BA,MAAM,UAAU;AAEhB,SAAgB,gCACd,OACoC;CACpC,MAAM,OAAO,MAAM,MAAM,MAAM,IAAI;CACnC,MAAM,SAAS,MAAM,UAAU;CAC/B,MAAM,SAA8C,EAAE;CACtD,MAAM,WAAgD,EAAE;AAExD,KAAI,CAAC,KACH,QAAO,KAAK;EAAE,MAAM;EAAiB,SAAS;EAA8B,CAAC;UACpE,CAAC,QAAQ,KAAK,KAAK,CAC5B,QAAO,KAAK;EACV,MAAM;EACN,SAAS,0BAA0B,KAAK;EACzC,CAAC;AAGJ,KAAI,CAAC,OAAO,MAAM,CAChB,QAAO,KAAK;EAAE,MAAM;EAAmB,SAAS;EAAgC,CAAC;AAGnF,KAAI,OAAO,SAAS,EAClB,QAAO;EAAE,OAAO;EAAO;EAAQ;EAAU;AAG3C,KAAI;EACF,MAAM,EAAE,SAAS,oBAAoB,OAAO;AAC5C,MAAI,KAAK,SAAS,MAAM;AACtB,UAAO,KAAK;IACV,MAAM;IACN,SAAS,cAAc,KAAK,KAAK,kCAAkC,KAAK;IACzE,CAAC;AACF,UAAO;IAAE,OAAO;IAAO;IAAQ;IAAU;;AAG3C,SAAO;GACL,OAAO;GACP;GACA;GACA,YAAY,wBAAwB;IAClC;IACA,QAAQ;IACR;IACA;IACD,CAAC;GACH;UACM,KAAK;AACZ,SAAO,KAAK;GACV,MAAM;GACN,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;GAC1D,CAAC;AACF,SAAO;GAAE,OAAO;GAAO;GAAQ;GAAU"}
+{"version":3,"file":"validation.js","names":[],"sources":["../../../../src/workflows/domain/validation.ts"],"sourcesContent":["import type { WorkflowDefinition, WorkflowGraph, WorkflowGraphNode } from './definition.js';\nimport { buildWorkflowDefinition } from './definition-utils.js';\n\nexport type WorkflowDefinitionValidationIssueCode =\n  | 'name_required'\n  | 'invalid_name'\n  | 'graph_required'\n  | 'invalid_schema_version'\n  | 'duplicate_node'\n  | 'missing_input'\n  | 'multiple_inputs'\n  | 'missing_output'\n  | 'multiple_outputs'\n  | 'unknown_edge_node'\n  | 'duplicate_edge'\n  | 'self_edge'\n  | 'cycle_detected'\n  | 'unreachable_node'\n  | 'dead_end_node'\n  | 'missing_prompt'\n  | 'invalid_node_config';\n\nexport interface WorkflowDefinitionValidationIssue {\n  code: WorkflowDefinitionValidationIssueCode;\n  message: string;\n  nodeId?: string;\n  edgeId?: string;\n  field?: string;\n}\n\nexport interface WorkflowDefinitionValidationResult {\n  valid: boolean;\n  errors: WorkflowDefinitionValidationIssue[];\n  warnings: WorkflowDefinitionValidationIssue[];\n  definition?: WorkflowDefinition;\n}\n\nexport interface ValidateWorkflowDefinitionInput {\n  name?: string;\n  graph?: WorkflowGraph;\n  title?: string;\n  description?: string;\n}\n\nconst NAME_RE = /^[a-z][a-z0-9_-]*$/;\n\nexport function validateWorkflowDefinitionInput(\n  input: ValidateWorkflowDefinitionInput,\n): WorkflowDefinitionValidationResult {\n  const name = input.name?.trim() ?? '';\n  const errors: WorkflowDefinitionValidationIssue[] = [];\n  const warnings: WorkflowDefinitionValidationIssue[] = [];\n\n  if (!name) {\n    errors.push({ code: 'name_required', message: 'Workflow name is required.', field: 'name' });\n  } else if (!NAME_RE.test(name)) {\n    errors.push({\n      code: 'invalid_name',\n      message: `Invalid workflow name \"${name}\". Use lowercase snake_case.`,\n      field: 'name',\n    });\n  }\n\n  if (!input.graph) {\n    errors.push({ code: 'graph_required', message: 'Workflow graph is required.', field: 'graph' });\n  } else {\n    validateWorkflowGraph(input.graph, errors, warnings);\n  }\n\n  if (errors.length > 0 || !input.graph) return { valid: false, errors, warnings };\n\n  return {\n    valid: true,\n    errors,\n    warnings,\n    definition: buildWorkflowDefinition({\n      name,\n      source: 'user',\n      graph: input.graph,\n      manifest: {\n        title: input.title,\n        description: input.description,\n      },\n    }),\n  };\n}\n\nexport function validateWorkflowGraph(\n  graph: WorkflowGraph,\n  errors: WorkflowDefinitionValidationIssue[] = [],\n  warnings: WorkflowDefinitionValidationIssue[] = [],\n): WorkflowDefinitionValidationResult {\n  if (graph.schemaVersion !== 1) {\n    errors.push({\n      code: 'invalid_schema_version',\n      message: 'Workflow graph schemaVersion must be 1.',\n      field: 'schemaVersion',\n    });\n  }\n\n  const nodes = new Map<string, WorkflowGraphNode>();\n  for (const node of graph.nodes) {\n    if (nodes.has(node.id)) {\n      errors.push({ code: 'duplicate_node', message: `Duplicate node id \"${node.id}\".`, nodeId: node.id });\n      continue;\n    }\n    nodes.set(node.id, node);\n    validateNode(node, errors);\n  }\n\n  const inputs = graph.nodes.filter((node) => node.kind === 'input');\n  const outputs = graph.nodes.filter((node) => node.kind === 'output');\n  if (inputs.length === 0) errors.push({ code: 'missing_input', message: 'Workflow needs one input node.' });\n  if (inputs.length > 1) errors.push({ code: 'multiple_inputs', message: 'Workflow can only have one input node.' });\n  if (outputs.length === 0) errors.push({ code: 'missing_output', message: 'Workflow needs one output node.' });\n  if (outputs.length > 1) errors.push({ code: 'multiple_outputs', message: 'Workflow can only have one output node.' });\n\n  const edgeKeys = new Set<string>();\n  const outgoing = new Map<string, string[]>();\n  const incoming = new Map<string, string[]>();\n  const indegree = new Map<string, number>(graph.nodes.map((node) => [node.id, 0]));\n  for (const edge of graph.edges) {\n    const key = `${edge.source}:${edge.target}:${edge.sourcePort ?? 'default'}`;\n    if (edgeKeys.has(key)) {\n      errors.push({ code: 'duplicate_edge', message: `Duplicate edge ${edge.source} → ${edge.target}.`, edgeId: edge.id });\n    }\n    edgeKeys.add(key);\n    if (!nodes.has(edge.source) || !nodes.has(edge.target)) {\n      errors.push({\n        code: 'unknown_edge_node',\n        message: `Edge \"${edge.id}\" references a missing node.`,\n        edgeId: edge.id,\n      });\n      continue;\n    }\n    if (edge.source === edge.target) {\n      errors.push({ code: 'self_edge', message: `Node \"${edge.source}\" cannot connect to itself.`, edgeId: edge.id });\n      continue;\n    }\n    outgoing.set(edge.source, [...(outgoing.get(edge.source) ?? []), edge.target]);\n    incoming.set(edge.target, [...(incoming.get(edge.target) ?? []), edge.source]);\n    indegree.set(edge.target, (indegree.get(edge.target) ?? 0) + 1);\n\n    const sourceNode = nodes.get(edge.source)!;\n    if (sourceNode.kind === 'decision' && edge.sourcePort !== 'true' && edge.sourcePort !== 'false') {\n      errors.push({ code: 'invalid_node_config', message: `Decision edge \"${edge.id}\" must use a true or false branch.`, edgeId: edge.id });\n    }\n    if (sourceNode.kind !== 'decision' && edge.sourcePort && edge.sourcePort !== 'default') {\n      errors.push({ code: 'invalid_node_config', message: `Only decision nodes can use branch edges.`, edgeId: edge.id });\n    }\n  }\n\n  if (nodes.size > 0 && !isAcyclic(indegree, outgoing)) {\n    errors.push({ code: 'cycle_detected', message: 'Workflow graph must not contain a cycle.' });\n  }\n\n  if (inputs.length === 1) {\n    const reachable = collectReachable(inputs[0].id, outgoing);\n    for (const node of graph.nodes) {\n      if (!reachable.has(node.id)) {\n        errors.push({\n          code: 'unreachable_node',\n          message: `Node \"${node.title}\" is not connected to the workflow input.`,\n          nodeId: node.id,\n        });\n      }\n    }\n  }\n\n  if (outputs.length === 1) {\n    const reachesOutput = collectReachable(outputs[0].id, incoming);\n    for (const node of graph.nodes) {\n      if (!reachesOutput.has(node.id)) {\n        errors.push({ code: 'dead_end_node', message: `Node \"${node.title}\" does not lead to the workflow output.`, nodeId: node.id });\n      }\n    }\n  }\n\n  for (const node of graph.nodes) {\n    if (node.kind !== 'decision') continue;\n    const ports = graph.edges.filter((edge) => edge.source === node.id).map((edge) => edge.sourcePort);\n    if (!ports.includes('true') || !ports.includes('false')) {\n      errors.push({ code: 'invalid_node_config', message: `Decision node \"${node.title}\" needs both true and false branches.`, nodeId: node.id });\n    }\n  }\n\n  return { valid: errors.length === 0, errors, warnings };\n}\n\nfunction validateNode(node: WorkflowGraphNode, errors: WorkflowDefinitionValidationIssue[]): void {\n  if (!node.id.trim() || !node.title.trim()) {\n    errors.push({\n      code: 'invalid_node_config',\n      message: 'Every node needs a stable id and title.',\n      nodeId: node.id,\n    });\n  }\n  if (node.kind === 'agent' && !node.config.prompt.trim()) {\n    errors.push({\n      code: 'missing_prompt',\n      message: `Agent node \"${node.title}\" needs an instruction.`,\n      nodeId: node.id,\n      field: 'config.prompt',\n    });\n  }\n  if (node.kind === 'agent' && node.config.maxIterations !== undefined) {\n    if (!Number.isFinite(node.config.maxIterations) || node.config.maxIterations < 1) {\n      errors.push({\n        code: 'invalid_node_config',\n        message: `Agent node \"${node.title}\" has an invalid iteration limit.`,\n        nodeId: node.id,\n        field: 'config.maxIterations',\n      });\n    }\n  }\n}\n\nfunction isAcyclic(indegreeInput: Map<string, number>, outgoing: Map<string, string[]>): boolean {\n  const indegree = new Map(indegreeInput);\n  const queue = [...indegree.entries()].filter(([, count]) => count === 0).map(([id]) => id);\n  let visited = 0;\n  while (queue.length > 0) {\n    const id = queue.shift()!;\n    visited += 1;\n    for (const target of outgoing.get(id) ?? []) {\n      const next = (indegree.get(target) ?? 0) - 1;\n      indegree.set(target, next);\n      if (next === 0) queue.push(target);\n    }\n  }\n  return visited === indegree.size;\n}\n\nfunction collectReachable(start: string, outgoing: Map<string, string[]>): Set<string> {\n  const seen = new Set<string>();\n  const queue = [start];\n  while (queue.length > 0) {\n    const id = queue.shift()!;\n    if (seen.has(id)) continue;\n    seen.add(id);\n    queue.push(...(outgoing.get(id) ?? []));\n  }\n  return seen;\n}\n"],"mappings":";;AA4CA,MAAM,UAAU;AAEhB,SAAgB,gCACd,OACoC;CACpC,MAAM,OAAO,MAAM,MAAM,MAAM,IAAI;CACnC,MAAM,SAA8C,EAAE;CACtD,MAAM,WAAgD,EAAE;AAExD,KAAI,CAAC,KACH,QAAO,KAAK;EAAE,MAAM;EAAiB,SAAS;EAA8B,OAAO;EAAQ,CAAC;UACnF,CAAC,QAAQ,KAAK,KAAK,CAC5B,QAAO,KAAK;EACV,MAAM;EACN,SAAS,0BAA0B,KAAK;EACxC,OAAO;EACR,CAAC;AAGJ,KAAI,CAAC,MAAM,MACT,QAAO,KAAK;EAAE,MAAM;EAAkB,SAAS;EAA+B,OAAO;EAAS,CAAC;KAE/F,uBAAsB,MAAM,OAAO,QAAQ,SAAS;AAGtD,KAAI,OAAO,SAAS,KAAK,CAAC,MAAM,MAAO,QAAO;EAAE,OAAO;EAAO;EAAQ;EAAU;AAEhF,QAAO;EACL,OAAO;EACP;EACA;EACA,YAAY,wBAAwB;GAClC;GACA,QAAQ;GACR,OAAO,MAAM;GACb,UAAU;IACR,OAAO,MAAM;IACb,aAAa,MAAM;IACpB;GACF,CAAC;EACH;;AAGH,SAAgB,sBACd,OACA,SAA8C,EAAE,EAChD,WAAgD,EAAE,EACd;AACpC,KAAI,MAAM,kBAAkB,EAC1B,QAAO,KAAK;EACV,MAAM;EACN,SAAS;EACT,OAAO;EACR,CAAC;CAGJ,MAAM,wBAAQ,IAAI,KAAgC;AAClD,MAAK,MAAM,QAAQ,MAAM,OAAO;AAC9B,MAAI,MAAM,IAAI,KAAK,GAAG,EAAE;AACtB,UAAO,KAAK;IAAE,MAAM;IAAkB,SAAS,sBAAsB,KAAK,GAAG;IAAK,QAAQ,KAAK;IAAI,CAAC;AACpG;;AAEF,QAAM,IAAI,KAAK,IAAI,KAAK;AACxB,eAAa,MAAM,OAAO;;CAG5B,MAAM,SAAS,MAAM,MAAM,QAAQ,SAAS,KAAK,SAAS,QAAQ;CAClE,MAAM,UAAU,MAAM,MAAM,QAAQ,SAAS,KAAK,SAAS,SAAS;AACpE,KAAI,OAAO,WAAW,EAAG,QAAO,KAAK;EAAE,MAAM;EAAiB,SAAS;EAAkC,CAAC;AAC1G,KAAI,OAAO,SAAS,EAAG,QAAO,KAAK;EAAE,MAAM;EAAmB,SAAS;EAA0C,CAAC;AAClH,KAAI,QAAQ,WAAW,EAAG,QAAO,KAAK;EAAE,MAAM;EAAkB,SAAS;EAAmC,CAAC;AAC7G,KAAI,QAAQ,SAAS,EAAG,QAAO,KAAK;EAAE,MAAM;EAAoB,SAAS;EAA2C,CAAC;CAErH,MAAM,2BAAW,IAAI,KAAa;CAClC,MAAM,2BAAW,IAAI,KAAuB;CAC5C,MAAM,2BAAW,IAAI,KAAuB;CAC5C,MAAM,WAAW,IAAI,IAAoB,MAAM,MAAM,KAAK,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AACjF,MAAK,MAAM,QAAQ,MAAM,OAAO;EAC9B,MAAM,MAAM,GAAG,KAAK,OAAO,GAAG,KAAK,OAAO,GAAG,KAAK,cAAc;AAChE,MAAI,SAAS,IAAI,IAAI,CACnB,QAAO,KAAK;GAAE,MAAM;GAAkB,SAAS,kBAAkB,KAAK,OAAO,KAAK,KAAK,OAAO;GAAI,QAAQ,KAAK;GAAI,CAAC;AAEtH,WAAS,IAAI,IAAI;AACjB,MAAI,CAAC,MAAM,IAAI,KAAK,OAAO,IAAI,CAAC,MAAM,IAAI,KAAK,OAAO,EAAE;AACtD,UAAO,KAAK;IACV,MAAM;IACN,SAAS,SAAS,KAAK,GAAG;IAC1B,QAAQ,KAAK;IACd,CAAC;AACF;;AAEF,MAAI,KAAK,WAAW,KAAK,QAAQ;AAC/B,UAAO,KAAK;IAAE,MAAM;IAAa,SAAS,SAAS,KAAK,OAAO;IAA8B,QAAQ,KAAK;IAAI,CAAC;AAC/G;;AAEF,WAAS,IAAI,KAAK,QAAQ,CAAC,GAAI,SAAS,IAAI,KAAK,OAAO,IAAI,EAAE,EAAG,KAAK,OAAO,CAAC;AAC9E,WAAS,IAAI,KAAK,QAAQ,CAAC,GAAI,SAAS,IAAI,KAAK,OAAO,IAAI,EAAE,EAAG,KAAK,OAAO,CAAC;AAC9E,WAAS,IAAI,KAAK,SAAS,SAAS,IAAI,KAAK,OAAO,IAAI,KAAK,EAAE;EAE/D,MAAM,aAAa,MAAM,IAAI,KAAK,OAAO;AACzC,MAAI,WAAW,SAAS,cAAc,KAAK,eAAe,UAAU,KAAK,eAAe,QACtF,QAAO,KAAK;GAAE,MAAM;GAAuB,SAAS,kBAAkB,KAAK,GAAG;GAAqC,QAAQ,KAAK;GAAI,CAAC;AAEvI,MAAI,WAAW,SAAS,cAAc,KAAK,cAAc,KAAK,eAAe,UAC3E,QAAO,KAAK;GAAE,MAAM;GAAuB,SAAS;GAA6C,QAAQ,KAAK;GAAI,CAAC;;AAIvH,KAAI,MAAM,OAAO,KAAK,CAAC,UAAU,UAAU,SAAS,CAClD,QAAO,KAAK;EAAE,MAAM;EAAkB,SAAS;EAA4C,CAAC;AAG9F,KAAI,OAAO,WAAW,GAAG;EACvB,MAAM,YAAY,iBAAiB,OAAO,GAAG,IAAI,SAAS;AAC1D,OAAK,MAAM,QAAQ,MAAM,MACvB,KAAI,CAAC,UAAU,IAAI,KAAK,GAAG,CACzB,QAAO,KAAK;GACV,MAAM;GACN,SAAS,SAAS,KAAK,MAAM;GAC7B,QAAQ,KAAK;GACd,CAAC;;AAKR,KAAI,QAAQ,WAAW,GAAG;EACxB,MAAM,gBAAgB,iBAAiB,QAAQ,GAAG,IAAI,SAAS;AAC/D,OAAK,MAAM,QAAQ,MAAM,MACvB,KAAI,CAAC,cAAc,IAAI,KAAK,GAAG,CAC7B,QAAO,KAAK;GAAE,MAAM;GAAiB,SAAS,SAAS,KAAK,MAAM;GAA0C,QAAQ,KAAK;GAAI,CAAC;;AAKpI,MAAK,MAAM,QAAQ,MAAM,OAAO;AAC9B,MAAI,KAAK,SAAS,WAAY;EAC9B,MAAM,QAAQ,MAAM,MAAM,QAAQ,SAAS,KAAK,WAAW,KAAK,GAAG,CAAC,KAAK,SAAS,KAAK,WAAW;AAClG,MAAI,CAAC,MAAM,SAAS,OAAO,IAAI,CAAC,MAAM,SAAS,QAAQ,CACrD,QAAO,KAAK;GAAE,MAAM;GAAuB,SAAS,kBAAkB,KAAK,MAAM;GAAwC,QAAQ,KAAK;GAAI,CAAC;;AAI/I,QAAO;EAAE,OAAO,OAAO,WAAW;EAAG;EAAQ;EAAU;;AAGzD,SAAS,aAAa,MAAyB,QAAmD;AAChG,KAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,MAAM,MAAM,CACvC,QAAO,KAAK;EACV,MAAM;EACN,SAAS;EACT,QAAQ,KAAK;EACd,CAAC;AAEJ,KAAI,KAAK,SAAS,WAAW,CAAC,KAAK,OAAO,OAAO,MAAM,CACrD,QAAO,KAAK;EACV,MAAM;EACN,SAAS,eAAe,KAAK,MAAM;EACnC,QAAQ,KAAK;EACb,OAAO;EACR,CAAC;AAEJ,KAAI,KAAK,SAAS,WAAW,KAAK,OAAO,kBAAkB,KAAA;MACrD,CAAC,OAAO,SAAS,KAAK,OAAO,cAAc,IAAI,KAAK,OAAO,gBAAgB,EAC7E,QAAO,KAAK;GACV,MAAM;GACN,SAAS,eAAe,KAAK,MAAM;GACnC,QAAQ,KAAK;GACb,OAAO;GACR,CAAC;;;AAKR,SAAS,UAAU,eAAoC,UAA0C;CAC/F,MAAM,WAAW,IAAI,IAAI,cAAc;CACvC,MAAM,QAAQ,CAAC,GAAG,SAAS,SAAS,CAAC,CAAC,QAAQ,GAAG,WAAW,UAAU,EAAE,CAAC,KAAK,CAAC,QAAQ,GAAG;CAC1F,IAAI,UAAU;AACd,QAAO,MAAM,SAAS,GAAG;EACvB,MAAM,KAAK,MAAM,OAAO;AACxB,aAAW;AACX,OAAK,MAAM,UAAU,SAAS,IAAI,GAAG,IAAI,EAAE,EAAE;GAC3C,MAAM,QAAQ,SAAS,IAAI,OAAO,IAAI,KAAK;AAC3C,YAAS,IAAI,QAAQ,KAAK;AAC1B,OAAI,SAAS,EAAG,OAAM,KAAK,OAAO;;;AAGtC,QAAO,YAAY,SAAS;;AAG9B,SAAS,iBAAiB,OAAe,UAA8C;CACrF,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,QAAQ,CAAC,MAAM;AACrB,QAAO,MAAM,SAAS,GAAG;EACvB,MAAM,KAAK,MAAM,OAAO;AACxB,MAAI,KAAK,IAAI,GAAG,CAAE;AAClB,OAAK,IAAI,GAAG;AACZ,QAAM,KAAK,GAAI,SAAS,IAAI,GAAG,IAAI,EAAE,CAAE;;AAEzC,QAAO"}

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

@@ -1,17 +1,16 @@
+import type { WorkflowGraph } from '../domain/definition.js';
 import type { WorkflowDraftConstraints, WorkflowDraftMode } from './workflow-draft.types.js';
 export interface WorkflowDraftRepairIssue {
     source: 'parse' | 'validation' | 'lint';
     severity: 'error' | 'warning';
     code: string;
     message: string;
-    line?: number;
-    column?: number;
 }
 export declare function buildWorkflowDraftPrompt(params: {
     prompt: string;
     language?: 'en' | 'zh';
     mode: WorkflowDraftMode;
-    existingScript?: string;
+    existingGraph?: WorkflowGraph;
     constraints?: WorkflowDraftConstraints;
 }): string;
 export declare function buildWorkflowDraftRepairPrompt(params: {