@xopcai/xopc 0.0.86 → 0.0.88

package/dist/src/agent/workflow/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","names":[],"sources":["../../../../src/agent/workflow/parser.ts"],"sourcesContent":["/**\n * Workflow script parser.\n *\n * Responsibilities:\n *   1. Parse the script with acorn (latest ECMA, top-level await + return allowed).\n *   2. Enforce determinism — reject `Date.now()`, `Math.random()`, `new Date()`,\n *      `require`, `import`, dynamic eval. This keeps future resume/replay possible\n *      and surfaces non-deterministic mistakes early.\n *   3. Require the first statement to be `export const meta = <literal>`, validate\n *      the literal shape, and strip that line from the body returned to the runtime.\n *\n * Returning a `{ meta, body }` pair means the runtime can `vm.Script(body)` without\n * any further AST work.\n */\n\nimport { parse } from 'acorn';\nimport type { Node } from 'acorn';\n\nimport type { WorkflowMeta, WorkflowMetaPhase } from './types.js';\n\ntype AnyNode = Node & { [key: string]: any; start: number; end: number };\n\nconst NONDETERMINISM_ERROR =\n  'Workflow scripts must be deterministic: Date.now()/Math.random()/new Date() are unavailable. ' +\n  'Pass timestamps via args or stamp them after the workflow returns.';\n\nexport interface ParsedWorkflow {\n  meta: WorkflowMeta;\n  body: string;\n}\n\nexport function parseWorkflowScript(script: string): ParsedWorkflow {\n  let ast: AnyNode;\n  try {\n    ast = parse(script, {\n      ecmaVersion: 'latest',\n      sourceType: 'module',\n      allowAwaitOutsideFunction: true,\n      allowReturnOutsideFunction: true,\n      ranges: false,\n    }) as AnyNode;\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    throw new Error(`Workflow script parse error: ${msg}`);\n  }\n\n  assertDeterministicAst(ast);\n  assertNoDangerousImports(ast);\n\n  const first = ast.body?.[0] as AnyNode | undefined;\n  if (first?.type !== 'ExportNamedDeclaration') {\n    throw new Error(\n      '`export const meta = { name, description }` must be the first statement in the script',\n    );\n  }\n\n  const declaration = first.declaration as AnyNode | null;\n  if (declaration?.type !== 'VariableDeclaration' || declaration.kind !== 'const') {\n    throw new Error('meta export must be `export const meta = ...`');\n  }\n  if (declaration.declarations.length !== 1) {\n    throw new Error('meta export must declare only `meta`');\n  }\n  const declarator = declaration.declarations[0] as AnyNode;\n  if (declarator.id?.type !== 'Identifier' || declarator.id.name !== 'meta') {\n    throw new Error('meta export must declare `meta`');\n  }\n  if (!declarator.init) {\n    throw new Error('meta must have a literal value');\n  }\n\n  const meta = evaluateLiteral(declarator.init, 'meta');\n  validateMeta(meta);\n\n  return {\n    meta,\n    body: script.slice(0, first.start) + script.slice(first.end),\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Determinism / safety guards\n// ---------------------------------------------------------------------------\n\nfunction assertDeterministicAst(node: AnyNode): void {\n  if (isDateNowCall(node) || isMathRandomCall(node) || isNewDateExpression(node)) {\n    throw new Error(NONDETERMINISM_ERROR);\n  }\n  for (const child of astChildren(node)) {\n    assertDeterministicAst(child);\n  }\n}\n\nfunction assertNoDangerousImports(node: AnyNode): void {\n  if (node.type === 'ImportDeclaration' || node.type === 'ImportExpression') {\n    throw new Error(\n      \"Workflow scripts cannot use `import` — only the exposed globals (agent, parallel, pipeline, phase, log, args, cwd, budget) are available.\",\n    );\n  }\n  if (node.type === 'CallExpression') {\n    const callee = node.callee as AnyNode | undefined;\n    if (callee?.type === 'Identifier' && (callee.name === 'require' || callee.name === 'eval')) {\n      throw new Error(`Workflow scripts cannot call \\`${callee.name}\\`.`);\n    }\n  }\n  for (const child of astChildren(node)) {\n    assertNoDangerousImports(child);\n  }\n}\n\nfunction astChildren(node: AnyNode): AnyNode[] {\n  const children: AnyNode[] = [];\n  for (const value of Object.values(node)) {\n    if (Array.isArray(value)) {\n      for (const v of value) {\n        if (isAstNode(v)) children.push(v);\n      }\n    } else if (isAstNode(value)) {\n      children.push(value);\n    }\n  }\n  return children;\n}\n\nfunction isAstNode(value: unknown): value is AnyNode {\n  return !!value && typeof value === 'object' && typeof (value as AnyNode).type === 'string';\n}\n\nfunction isDateNowCall(node: AnyNode): boolean {\n  return node.type === 'CallExpression' && isMemberExpression(node.callee, 'Date', 'now');\n}\n\nfunction isMathRandomCall(node: AnyNode): boolean {\n  return node.type === 'CallExpression' && isMemberExpression(node.callee, 'Math', 'random');\n}\n\nfunction isNewDateExpression(node: AnyNode): boolean {\n  return (\n    node.type === 'NewExpression' &&\n    (node.callee as AnyNode | undefined)?.type === 'Identifier' &&\n    (node.callee as AnyNode).name === 'Date'\n  );\n}\n\nfunction isMemberExpression(\n  node: AnyNode | undefined,\n  objectName: string,\n  propertyName: string,\n): boolean {\n  if (\n    node?.type !== 'MemberExpression' ||\n    (node.object as AnyNode | undefined)?.type !== 'Identifier' ||\n    (node.object as AnyNode).name !== objectName\n  ) {\n    return false;\n  }\n  const prop = node.property as AnyNode | undefined;\n  if (!node.computed && prop?.type === 'Identifier') return prop.name === propertyName;\n  if (prop?.type === 'Literal' && typeof prop.value === 'string') return prop.value === propertyName;\n  return false;\n}\n\n// ---------------------------------------------------------------------------\n// Literal evaluator (meta must be a pure literal)\n// ---------------------------------------------------------------------------\n\nfunction evaluateLiteral(node: AnyNode, path: string): any {\n  switch (node.type) {\n    case 'ObjectExpression': {\n      const out: Record<string, unknown> = {};\n      for (const prop of node.properties as AnyNode[]) {\n        if (prop.type === 'SpreadElement') {\n          throw new Error(`spread not allowed in ${path}`);\n        }\n        if (prop.type !== 'Property') {\n          throw new Error(`only plain properties allowed in ${path}`);\n        }\n        if (prop.computed) {\n          throw new Error(`computed keys not allowed in ${path}`);\n        }\n        if (prop.kind !== 'init' || prop.method) {\n          throw new Error(`methods/accessors not allowed in ${path}`);\n        }\n        const key = propertyKey(prop.key as AnyNode, path);\n        if (key === '__proto__' || key === 'constructor' || key === 'prototype') {\n          throw new Error(`reserved key name not allowed in ${path}: ${key}`);\n        }\n        out[key] = evaluateLiteral(prop.value as AnyNode, `${path}.${key}`);\n      }\n      return out;\n    }\n    case 'ArrayExpression':\n      return (node.elements as Array<AnyNode | null>).map((element, index) => {\n        if (!element) throw new Error(`sparse arrays not allowed in ${path}`);\n        if (element.type === 'SpreadElement') {\n          throw new Error(`spread not allowed in ${path}`);\n        }\n        return evaluateLiteral(element, `${path}[${index}]`);\n      });\n    case 'Literal':\n      return node.value;\n    case 'TemplateLiteral':\n      if (node.expressions.length > 0) {\n        throw new Error(`template interpolation not allowed in ${path}`);\n      }\n      return node.quasis\n        .map((quasi: AnyNode) => quasi.value.cooked ?? quasi.value.raw)\n        .join('');\n    case 'UnaryExpression':\n      if (\n        node.operator === '-' &&\n        node.argument?.type === 'Literal' &&\n        typeof node.argument.value === 'number'\n      ) {\n        return -node.argument.value;\n      }\n      throw new Error(`only negative-number unary allowed in ${path}`);\n    default:\n      throw new Error(`non-literal node type in ${path}: ${node.type}`);\n  }\n}\n\nfunction propertyKey(node: AnyNode, path: string): string {\n  if (node.type === 'Identifier') return node.name;\n  if (node.type === 'Literal' && (typeof node.value === 'string' || typeof node.value === 'number')) {\n    return String(node.value);\n  }\n  throw new Error(`unsupported key type in ${path}: ${node.type}`);\n}\n\nfunction validateMeta(meta: unknown): asserts meta is WorkflowMeta {\n  if (!meta || typeof meta !== 'object') {\n    throw new Error('meta must be an object');\n  }\n  const value = meta as WorkflowMeta;\n  if (typeof value.name !== 'string' || !value.name.trim()) {\n    throw new Error('meta.name must be a non-empty string');\n  }\n  if (!/^[a-z][a-z0-9_-]*$/.test(value.name)) {\n    throw new Error(\n      `meta.name must be lowercase snake_case (got \"${value.name}\"). Example: \"audit_repo\".`,\n    );\n  }\n  if (typeof value.description !== 'string' || !value.description.trim()) {\n    throw new Error('meta.description must be a non-empty string');\n  }\n  if (value.whenToUse !== undefined && typeof value.whenToUse !== 'string') {\n    throw new Error('meta.whenToUse must be a string');\n  }\n  if (value.phases !== undefined) {\n    if (!Array.isArray(value.phases)) {\n      throw new Error('meta.phases must be an array');\n    }\n    for (const phase of value.phases) {\n      if (!phase || typeof phase !== 'object' || typeof (phase as WorkflowMetaPhase).title !== 'string') {\n        throw new Error('each meta phase must have a title string');\n      }\n    }\n  }\n  if (value.tags !== undefined) {\n    if (!Array.isArray(value.tags) || value.tags.some((tag) => typeof tag !== 'string' || !tag.trim())) {\n      throw new Error('meta.tags must be an array of non-empty strings');\n    }\n  }\n  if (value.estimatedAgents !== undefined) {\n    const est = value.estimatedAgents;\n    if (!est || typeof est !== 'object') {\n      throw new Error('meta.estimatedAgents must be an object');\n    }\n    if (typeof est.min !== 'number' || typeof est.max !== 'number' || !Number.isFinite(est.min) || !Number.isFinite(est.max)) {\n      throw new Error('meta.estimatedAgents.min and .max must be finite numbers');\n    }\n    if (est.min < 1 || est.max < est.min) {\n      throw new Error('meta.estimatedAgents requires min >= 1 and max >= min');\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"parser.js","names":[],"sources":["../../../../src/agent/workflow/parser.ts"],"sourcesContent":["/**\n * Workflow script parser.\n *\n * Responsibilities:\n *   1. Parse the script with acorn (latest ECMA, top-level await + return allowed).\n *   2. Enforce determinism — reject `Date.now()`, `Math.random()`, `new Date()`,\n *      `require`, `import`, dynamic eval. This keeps future resume/replay possible\n *      and surfaces non-deterministic mistakes early.\n *   3. Require the first statement to be `export const meta = <literal>`, validate\n *      the literal shape, and strip that line from the body returned to the runtime.\n *\n * Returning a `{ meta, body }` pair means the runtime can `vm.Script(body)` without\n * any further AST work.\n */\n\nimport { parse } from 'acorn';\nimport type { Node } from 'acorn';\n\nimport { lintAwaits } from './lint.js';\nimport { validateExamplePrompts, validateMetaI18n } from './meta-locale.js';\nimport type { WorkflowMeta, WorkflowMetaPhase } from './types.js';\n\ntype AnyNode = Node & { [key: string]: any; start: number; end: number };\n\nconst NONDETERMINISM_ERROR =\n  'Workflow scripts must be deterministic: Date.now()/Math.random()/new Date() are unavailable. ' +\n  'Pass timestamps via args or stamp them after the workflow returns.';\n\nexport interface ParsedWorkflow {\n  meta: WorkflowMeta;\n  body: string;\n}\n\nexport function parseWorkflowScript(script: string): ParsedWorkflow {\n  let ast: AnyNode;\n  try {\n    ast = parse(script, {\n      ecmaVersion: 'latest',\n      sourceType: 'module',\n      allowAwaitOutsideFunction: true,\n      allowReturnOutsideFunction: true,\n      ranges: false,\n      locations: true,\n    }) as AnyNode;\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    throw new Error(`Workflow script parse error: ${msg}`);\n  }\n\n  assertDeterministicAst(ast);\n  assertNoDangerousImports(ast);\n  lintAwaits(ast);\n\n  const first = ast.body?.[0] as AnyNode | undefined;\n  if (first?.type !== 'ExportNamedDeclaration') {\n    throw new Error(\n      '`export const meta = { name, description }` must be the first statement in the script',\n    );\n  }\n\n  const declaration = first.declaration as AnyNode | null;\n  if (declaration?.type !== 'VariableDeclaration' || declaration.kind !== 'const') {\n    throw new Error('meta export must be `export const meta = ...`');\n  }\n  if (declaration.declarations.length !== 1) {\n    throw new Error('meta export must declare only `meta`');\n  }\n  const declarator = declaration.declarations[0] as AnyNode;\n  if (declarator.id?.type !== 'Identifier' || declarator.id.name !== 'meta') {\n    throw new Error('meta export must declare `meta`');\n  }\n  if (!declarator.init) {\n    throw new Error('meta must have a literal value');\n  }\n\n  const meta = evaluateLiteral(declarator.init, 'meta');\n  validateMeta(meta);\n\n  return {\n    meta,\n    body: script.slice(0, first.start) + script.slice(first.end),\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Determinism / safety guards\n// ---------------------------------------------------------------------------\n\nfunction assertDeterministicAst(node: AnyNode): void {\n  if (isDateNowCall(node) || isMathRandomCall(node) || isNewDateExpression(node)) {\n    throw new Error(NONDETERMINISM_ERROR);\n  }\n  for (const child of astChildren(node)) {\n    assertDeterministicAst(child);\n  }\n}\n\nfunction assertNoDangerousImports(node: AnyNode): void {\n  if (node.type === 'ImportDeclaration' || node.type === 'ImportExpression') {\n    throw new Error(\n      \"Workflow scripts cannot use `import` — only the exposed globals (agent, parallel, pipeline, phase, log, args, cwd, budget) are available.\",\n    );\n  }\n  if (node.type === 'CallExpression') {\n    const callee = node.callee as AnyNode | undefined;\n    if (callee?.type === 'Identifier' && (callee.name === 'require' || callee.name === 'eval')) {\n      throw new Error(`Workflow scripts cannot call \\`${callee.name}\\`.`);\n    }\n  }\n  for (const child of astChildren(node)) {\n    assertNoDangerousImports(child);\n  }\n}\n\nfunction astChildren(node: AnyNode): AnyNode[] {\n  const children: AnyNode[] = [];\n  for (const value of Object.values(node)) {\n    if (Array.isArray(value)) {\n      for (const v of value) {\n        if (isAstNode(v)) children.push(v);\n      }\n    } else if (isAstNode(value)) {\n      children.push(value);\n    }\n  }\n  return children;\n}\n\nfunction isAstNode(value: unknown): value is AnyNode {\n  return !!value && typeof value === 'object' && typeof (value as AnyNode).type === 'string';\n}\n\nfunction isDateNowCall(node: AnyNode): boolean {\n  return node.type === 'CallExpression' && isMemberExpression(node.callee, 'Date', 'now');\n}\n\nfunction isMathRandomCall(node: AnyNode): boolean {\n  return node.type === 'CallExpression' && isMemberExpression(node.callee, 'Math', 'random');\n}\n\nfunction isNewDateExpression(node: AnyNode): boolean {\n  return (\n    node.type === 'NewExpression' &&\n    (node.callee as AnyNode | undefined)?.type === 'Identifier' &&\n    (node.callee as AnyNode).name === 'Date'\n  );\n}\n\nfunction isMemberExpression(\n  node: AnyNode | undefined,\n  objectName: string,\n  propertyName: string,\n): boolean {\n  if (\n    node?.type !== 'MemberExpression' ||\n    (node.object as AnyNode | undefined)?.type !== 'Identifier' ||\n    (node.object as AnyNode).name !== objectName\n  ) {\n    return false;\n  }\n  const prop = node.property as AnyNode | undefined;\n  if (!node.computed && prop?.type === 'Identifier') return prop.name === propertyName;\n  if (prop?.type === 'Literal' && typeof prop.value === 'string') return prop.value === propertyName;\n  return false;\n}\n\n// ---------------------------------------------------------------------------\n// Literal evaluator (meta must be a pure literal)\n// ---------------------------------------------------------------------------\n\nfunction evaluateLiteral(node: AnyNode, path: string): any {\n  switch (node.type) {\n    case 'ObjectExpression': {\n      const out: Record<string, unknown> = {};\n      for (const prop of node.properties as AnyNode[]) {\n        if (prop.type === 'SpreadElement') {\n          throw new Error(`spread not allowed in ${path}`);\n        }\n        if (prop.type !== 'Property') {\n          throw new Error(`only plain properties allowed in ${path}`);\n        }\n        if (prop.computed) {\n          throw new Error(`computed keys not allowed in ${path}`);\n        }\n        if (prop.kind !== 'init' || prop.method) {\n          throw new Error(`methods/accessors not allowed in ${path}`);\n        }\n        const key = propertyKey(prop.key as AnyNode, path);\n        if (key === '__proto__' || key === 'constructor' || key === 'prototype') {\n          throw new Error(`reserved key name not allowed in ${path}: ${key}`);\n        }\n        out[key] = evaluateLiteral(prop.value as AnyNode, `${path}.${key}`);\n      }\n      return out;\n    }\n    case 'ArrayExpression':\n      return (node.elements as Array<AnyNode | null>).map((element, index) => {\n        if (!element) throw new Error(`sparse arrays not allowed in ${path}`);\n        if (element.type === 'SpreadElement') {\n          throw new Error(`spread not allowed in ${path}`);\n        }\n        return evaluateLiteral(element, `${path}[${index}]`);\n      });\n    case 'Literal':\n      return node.value;\n    case 'TemplateLiteral':\n      if (node.expressions.length > 0) {\n        throw new Error(`template interpolation not allowed in ${path}`);\n      }\n      return node.quasis\n        .map((quasi: AnyNode) => quasi.value.cooked ?? quasi.value.raw)\n        .join('');\n    case 'UnaryExpression':\n      if (\n        node.operator === '-' &&\n        node.argument?.type === 'Literal' &&\n        typeof node.argument.value === 'number'\n      ) {\n        return -node.argument.value;\n      }\n      throw new Error(`only negative-number unary allowed in ${path}`);\n    default:\n      throw new Error(`non-literal node type in ${path}: ${node.type}`);\n  }\n}\n\nfunction propertyKey(node: AnyNode, path: string): string {\n  if (node.type === 'Identifier') return node.name;\n  if (node.type === 'Literal' && (typeof node.value === 'string' || typeof node.value === 'number')) {\n    return String(node.value);\n  }\n  throw new Error(`unsupported key type in ${path}: ${node.type}`);\n}\n\nfunction validateMeta(meta: unknown): asserts meta is WorkflowMeta {\n  if (!meta || typeof meta !== 'object') {\n    throw new Error('meta must be an object');\n  }\n  const value = meta as WorkflowMeta;\n  if (typeof value.name !== 'string' || !value.name.trim()) {\n    throw new Error('meta.name must be a non-empty string');\n  }\n  if (!/^[a-z][a-z0-9_-]*$/.test(value.name)) {\n    throw new Error(\n      `meta.name must be lowercase snake_case (got \"${value.name}\"). Example: \"audit_repo\".`,\n    );\n  }\n  if (typeof value.description !== 'string' || !value.description.trim()) {\n    throw new Error('meta.description must be a non-empty string');\n  }\n  if (value.whenToUse !== undefined && typeof value.whenToUse !== 'string') {\n    throw new Error('meta.whenToUse must be a string');\n  }\n  if (value.phases !== undefined) {\n    if (!Array.isArray(value.phases)) {\n      throw new Error('meta.phases must be an array');\n    }\n    for (const phase of value.phases) {\n      if (!phase || typeof phase !== 'object' || typeof (phase as WorkflowMetaPhase).title !== 'string') {\n        throw new Error('each meta phase must have a title string');\n      }\n    }\n  }\n  if (value.tags !== undefined) {\n    if (!Array.isArray(value.tags) || value.tags.some((tag) => typeof tag !== 'string' || !tag.trim())) {\n      throw new Error('meta.tags must be an array of non-empty strings');\n    }\n  }\n  if (value.estimatedAgents !== undefined) {\n    const est = value.estimatedAgents;\n    if (!est || typeof est !== 'object') {\n      throw new Error('meta.estimatedAgents must be an object');\n    }\n    if (typeof est.min !== 'number' || typeof est.max !== 'number' || !Number.isFinite(est.min) || !Number.isFinite(est.max)) {\n      throw new Error('meta.estimatedAgents.min and .max must be finite numbers');\n    }\n    if (est.min < 1 || est.max < est.min) {\n      throw new Error('meta.estimatedAgents requires min >= 1 and max >= min');\n    }\n  }\n  validateExamplePrompts(value.examplePrompts, 'meta.examplePrompts');\n  validateMetaI18n(value.i18n);\n}\n"],"mappings":"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"}

package/dist/src/agent/workflow/runtime.d.ts

@@ -23,9 +23,12 @@
  * carries no LLM dependency, and is fully driven by injected callbacks — that
  * means the workflow tool, tests, and any future runner share one runtime.
  */
+import type { Api, Model } from '@earendil-works/pi-ai';
 import type { SubagentRunner, WorkflowRunOptions, WorkflowRunResult, WorkflowSnapshot } from './types.js';
 export interface RunWorkflowDeps {
     runner: SubagentRunner;
+    /** Resolve a model ref (`provider/model` or configured typed id) to a {@link Model}. Throws on unknown ref. */
+    resolveModelId?: (modelId: string) => Model<Api>;
 }
 export declare function runWorkflow<T = unknown>(script: string, deps: RunWorkflowDeps, options: WorkflowRunOptions): Promise<WorkflowRunResult<T>>;
-export declare function emptySnapshotFor(name: string, description?: string): WorkflowSnapshot;
+export declare function emptySnapshotFor(name: string, description?: string, phaseTitles?: string[]): WorkflowSnapshot;

package/dist/src/agent/workflow/runtime.js

@@ -43,6 +43,7 @@ async function runWorkflow(script, deps, options) {
 	const maxSubagents = Math.max(1, options.maxSubagents ?? DEFAULT_MAX_SUBAGENTS);
 	const limiter = createLimiter(concurrency);
 	const pendingAgentRuns = /* @__PURE__ */ new Set();
+	const phaseDefaultModels = buildPhaseModelMap(meta.phases);
 	const log = (message) => {
 		const text = String(message);
 		state.logs.push(text);
@@ -62,6 +63,20 @@ async function runWorkflow(script, deps, options) {
 	const throwIfAborted = () => {
 		if (options.signal?.aborted) throw new Error("workflow aborted");
 	};
+	const resolveAgentModel = (normalized, assignedPhase) => {
+		const realId = normalized.model?.trim();
+		if (realId) {
+			if (!deps.resolveModelId) throw new Error("workflow runtime missing resolveModelId; cannot resolve real model id");
+			return deps.resolveModelId(realId);
+		}
+		if (assignedPhase) {
+			const phaseRef = phaseDefaultModels.get(assignedPhase);
+			if (phaseRef) {
+				if (!deps.resolveModelId) return void 0;
+				return deps.resolveModelId(phaseRef);
+			}
+		}
+	};
 	const agent = async (prompt, agentOptions = {}) => {
 		throwIfAborted();
 		if (budget.total !== null && budget.remaining() <= 0) throw new Error("workflow token budget exhausted");
@@ -70,10 +85,16 @@ async function runWorkflow(script, deps, options) {
 		const normalized = normalizeAgentOptions(agentOptions);
 		const assignedPhase = normalized.phase ?? state.currentPhase;
 		const requestedLabel = normalized.label?.trim();
+		state.agentCount += 1;
+		const id = state.agentCount;
+		const label = requestedLabel || defaultAgentLabel(assignedPhase, id);
+		options.onAgentQueued?.({
+			id,
+			label,
+			phase: assignedPhase,
+			prompt: taskPrompt
+		});
 		const runPromise = limiter(async () => {
-			state.agentCount += 1;
-			const id = state.agentCount;
-			const label = requestedLabel || defaultAgentLabel(assignedPhase, id);
 			options.onAgentStart?.({
 				id,
 				label,
@@ -82,6 +103,13 @@ async function runWorkflow(script, deps, options) {
 			});
 			try {
 				throwIfAborted();
+				const resolvedModel = resolveAgentModel(normalized, assignedPhase);
+				const enhanced = options.enhanceSubagentRun?.({
+					id,
+					label,
+					phase: assignedPhase,
+					prompt: taskPrompt
+				});
 				const result = await deps.runner.run(taskPrompt, {
 					label,
 					schema: normalized.schema,
@@ -89,7 +117,8 @@ async function runWorkflow(script, deps, options) {
 					maxIterations: normalized.maxIterations,
 					phase: assignedPhase,
 					signal: options.signal,
-					instructions: normalized.model ? `The parent workflow requested model "${normalized.model}".` : void 0
+					model: resolvedModel,
+					...enhanced
 				});
 				throwIfAborted();
 				const status = result === null ? "error" : "done";
@@ -195,7 +224,7 @@ async function runWorkflow(script, deps, options) {
 		await Promise.allSettled([...pendingAgentRuns]);
 	} catch (e) {
 		await Promise.allSettled([...pendingAgentRuns]);
-		throw e;
+		throw rewriteScriptError(e);
 	}
 	assertStructuredCloneable(result, "workflow result");
 	return {
@@ -207,11 +236,11 @@ async function runWorkflow(script, deps, options) {
 		durationMs: Date.now() - started
 	};
 }
-function emptySnapshotFor(name, description) {
+function emptySnapshotFor(name, description, phaseTitles) {
 	return {
 		name,
 		description,
-		phases: [],
+		phases: phaseTitles ? [...phaseTitles] : [],
 		logs: [],
 		agents: [],
 		agentCount: 0,
@@ -247,6 +276,12 @@ function createLimiter(limit) {
 		}
 	};
 }
+function buildPhaseModelMap(phases) {
+	const out = /* @__PURE__ */ new Map();
+	if (!phases) return out;
+	for (const p of phases) if (p && typeof p.title === "string" && typeof p.model === "string" && p.model.trim()) out.set(p.title, p.model.trim());
+	return out;
+}
 function requireString(value, name) {
 	if (typeof value !== "string") throw new TypeError(`${name} must be a string`);
 	return value;
@@ -267,11 +302,12 @@ function normalizeAgentOptions(value) {
 	if (maxIterations !== void 0) {
 		if (typeof maxIterations !== "number" || !Number.isFinite(maxIterations) || maxIterations < 1) throw new TypeError("agent maxIterations must be a positive number");
 	}
+	const modelStr = optionalString(options.model, "agent model");
 	return {
 		label: optionalString(options.label, "agent label"),
 		phase: optionalString(options.phase, "agent phase"),
 		schema: options.schema,
-		model: optionalString(options.model, "agent model"),
+		model: modelStr,
 		toolset,
 		maxIterations
 	};
@@ -280,10 +316,54 @@ function assertStructuredCloneable(value, name) {
 	try {
 		structuredClone(value);
 	} catch (e) {
+		const promisePath = findPromisePath(value, "");
+		if (promisePath !== null) throw new Error(`${name} contains a Promise at \`${promisePath || "<root>"}\` — missing 'await' before parallel()/pipeline()/agent(). Async return auto-unwraps a bare Promise, but a Promise nested in an object/array is returned as-is.`);
 		const detail = e instanceof Error ? ` ${e.message}` : "";
 		throw new Error(`${name} must be structured-cloneable; did you forget to await agent(), parallel(), or pipeline()?${detail}`);
 	}
 }
+/**
+* Find the first Promise lurking in `value`, returning a JS-path like
+* "results[0].pending". Returns null when no Promise is found. Bounded
+* depth/breadth so it never explodes on weird user shapes.
+*/
+function findPromisePath(value, path, depth = 0) {
+	if (depth > 4) return null;
+	if (isThenable(value)) return path;
+	if (Array.isArray(value)) {
+		for (let i = 0; i < Math.min(value.length, 32); i++) {
+			const inner = findPromisePath(value[i], `${path}[${i}]`, depth + 1);
+			if (inner !== null) return inner;
+		}
+		return null;
+	}
+	if (value !== null && typeof value === "object") {
+		let count = 0;
+		for (const [key, child] of Object.entries(value)) {
+			if (count++ > 32) break;
+			const inner = findPromisePath(child, path ? `${path}.${key}` : key, depth + 1);
+			if (inner !== null) return inner;
+		}
+	}
+	return null;
+}
+function isThenable(value) {
+	return value !== null && typeof value === "object" && typeof value.then === "function";
+}
+/**
+* Rewrite TypeErrors that look like "called .map on a Promise" with an
+* await-shaped hint. Static lint catches the obvious form at parse time;
+* this is the safety net for cases lint can't see (dynamic indirection,
+* values stashed in helper closures).
+*/
+const PROMISE_METHOD_ERROR = /\.(map|filter|forEach|flat|flatMap|find|some|every|reduce|join|length|then)\b is not a function/;
+function rewriteScriptError(error) {
+	const asError = error;
+	if (!(asError?.name === "TypeError" && typeof asError.message === "string")) return error instanceof Error ? error : new Error(String(error));
+	const message = asError.message;
+	if (!PROMISE_METHOD_ERROR.test(message)) return error instanceof Error ? error : new Error(message);
+	return /* @__PURE__ */ new Error(`${message}\n\nHint: parallel()/pipeline()/agent() return a Promise — 'await' the call before using its result.\n  ❌ const r = parallel(...); r.map(...)\n  ✅ const r = await parallel(...); r.map(...)`);
+}
 function defaultAgentLabel(phase, index) {
 	return phase ? `${phase} agent ${index}` : `agent ${index}`;
 }

package/dist/src/agent/workflow/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","names":[],"sources":["../../../../src/agent/workflow/runtime.ts"],"sourcesContent":["/**\n * Sandboxed workflow runtime.\n *\n * Parses the script via {@link parseWorkflowScript} (which strips the `meta`\n * export), wraps the remaining body in an async IIFE, and runs it inside a\n * Node `vm` context with a curated set of globals:\n *\n *   - `agent(prompt, opts)` — spawns a subagent through the injected\n *     {@link SubagentRunner} and returns its result (string, or schema-validated\n *     object). Failures resolve to `null`.\n *   - `parallel(thunks)` — concurrent fan-out; thunks (not promises!) so the\n *     limiter sees each agent() call.\n *   - `pipeline(items, ...stages)` — per-item sequential stages, items run\n *     concurrently (no stage barrier). Each stage receives\n *     `(prevResult, originalItem, index)`. A stage that throws drops that item\n *     to `null` and skips remaining stages.\n *   - `phase(title)` — marks the current phase; surfaces through `onPhase`.\n *   - `log(message)` — appends to the workflow log.\n *   - `budget` — `{ total, spent(), remaining() }` for self-pacing scripts.\n *   - `args`, `cwd`, `process.cwd()`.\n *\n * The runtime is the only code that touches `vm`. It exposes no IO surface,\n * carries no LLM dependency, and is fully driven by injected callbacks — that\n * means the workflow tool, tests, and any future runner share one runtime.\n */\n\nimport { availableParallelism } from 'node:os';\nimport { createContext, Script } from 'node:vm';\n\nimport { parseWorkflowScript } from './parser.js';\nimport type {\n  AgentScriptOptions,\n  SubagentRunner,\n  WorkflowRunOptions,\n  WorkflowRunResult,\n  WorkflowSnapshot,\n  WorkflowAgentStatus,\n} from './types.js';\n\nconst DEFAULT_CONCURRENCY_FLOOR = 1;\nconst DEFAULT_CONCURRENCY_CEILING = 16;\nconst DEFAULT_MAX_SUBAGENTS = 1000;\n\ninterface RuntimeState {\n  currentPhase?: string;\n  logs: string[];\n  phases: string[];\n  agentCount: number;\n  spent: number;\n}\n\nexport interface RunWorkflowDeps {\n  runner: SubagentRunner;\n}\n\nexport async function runWorkflow<T = unknown>(\n  script: string,\n  deps: RunWorkflowDeps,\n  options: WorkflowRunOptions,\n): Promise<WorkflowRunResult<T>> {\n  const started = Date.now();\n  const { meta, body } = parseWorkflowScript(script);\n\n  const state: RuntimeState = { logs: [], phases: [], agentCount: 0, spent: 0 };\n  const concurrency = clampConcurrency(options.concurrency);\n  const maxSubagents = Math.max(1, options.maxSubagents ?? DEFAULT_MAX_SUBAGENTS);\n  const limiter = createLimiter(concurrency);\n  const pendingAgentRuns = new Set<Promise<unknown>>();\n\n  const log = (message: unknown) => {\n    const text = String(message);\n    state.logs.push(text);\n    options.onLog?.(text);\n  };\n\n  const phase = (title: unknown) => {\n    const text = requireString(title, 'phase title');\n    state.currentPhase = text;\n    if (!state.phases.includes(text)) state.phases.push(text);\n    options.onPhase?.(text);\n  };\n\n  const budget = Object.freeze({\n    total: options.tokenBudget ?? null,\n    spent: () => state.spent,\n    remaining: () =>\n      options.tokenBudget == null\n        ? Number.POSITIVE_INFINITY\n        : Math.max(0, options.tokenBudget - state.spent),\n  });\n\n  const throwIfAborted = () => {\n    if (options.signal?.aborted) throw new Error('workflow aborted');\n  };\n\n  const agent = async (prompt: unknown, agentOptions: unknown = {}) => {\n    throwIfAborted();\n    if (budget.total !== null && budget.remaining() <= 0) {\n      throw new Error('workflow token budget exhausted');\n    }\n    if (state.agentCount >= maxSubagents) {\n      throw new Error(`workflow agent quota exhausted (max ${maxSubagents})`);\n    }\n\n    const taskPrompt = requireString(prompt, 'agent prompt');\n    const normalized = normalizeAgentOptions(agentOptions);\n    const assignedPhase = normalized.phase ?? state.currentPhase;\n    const requestedLabel = normalized.label?.trim();\n\n    const runPromise = limiter(async () => {\n      // Counter increments inside the limiter — id reflects start order, not enqueue order.\n      state.agentCount += 1;\n      const id = state.agentCount;\n      const label = requestedLabel || defaultAgentLabel(assignedPhase, id);\n      options.onAgentStart?.({ id, label, phase: assignedPhase, prompt: taskPrompt });\n\n      try {\n        throwIfAborted();\n        const result = await deps.runner.run<unknown>(taskPrompt, {\n          label,\n          schema: normalized.schema,\n          allowedToolNames: normalized.toolset,\n          maxIterations: normalized.maxIterations,\n          phase: assignedPhase,\n          signal: options.signal,\n          instructions: normalized.model\n            ? `The parent workflow requested model \"${normalized.model}\".`\n            : undefined,\n        });\n        throwIfAborted();\n\n        const status: WorkflowAgentStatus = result === null ? 'error' : 'done';\n        state.spent += estimateTokens(result);\n        options.onAgentEnd?.({ id, label, phase: assignedPhase, result, status });\n        return result;\n      } catch (e) {\n        if (options.signal?.aborted) {\n          options.onAgentEnd?.({ id, label, phase: assignedPhase, result: null, status: 'skipped' });\n          throw e;\n        }\n        const message = e instanceof Error ? e.message : String(e);\n        log(`agent ${label} failed: ${message}`);\n        options.onAgentEnd?.({ id, label, phase: assignedPhase, result: null, status: 'error' });\n        return null;\n      }\n    });\n\n    pendingAgentRuns.add(runPromise);\n    // `then` (not `finally`) keeps the bookkeeping promise from re-throwing into\n    // the unhandled-rejection channel when `runPromise` rejects on abort.\n    runPromise.then(\n      () => pendingAgentRuns.delete(runPromise),\n      () => pendingAgentRuns.delete(runPromise),\n    );\n    return runPromise;\n  };\n\n  const parallel = async (thunks: unknown) => {\n    throwIfAborted();\n    if (!Array.isArray(thunks)) throw new TypeError('parallel() expects an array of functions');\n    for (const t of thunks) {\n      if (typeof t !== 'function') {\n        throw new TypeError(\n          'parallel() expects an array of functions, not promises. Wrap each call: () => agent(...)',\n        );\n      }\n    }\n    return Promise.all(\n      thunks.map(async (thunk, index) => {\n        try {\n          return await (thunk as () => unknown)();\n        } catch (e) {\n          if (options.signal?.aborted) throw e;\n          const message = e instanceof Error ? e.message : String(e);\n          log(`parallel[${index}] failed: ${message}`);\n          return null;\n        }\n      }),\n    );\n  };\n\n  const pipeline = async (items: unknown, ...stages: Array<unknown>) => {\n    throwIfAborted();\n    if (!Array.isArray(items)) {\n      throw new TypeError('pipeline() expects an array as the first argument');\n    }\n    for (const stage of stages) {\n      if (typeof stage !== 'function') {\n        throw new TypeError(\n          'pipeline() stages must be functions: pipeline(items, item => ..., result => ...)',\n        );\n      }\n    }\n    const typedStages = stages as Array<\n      (prev: unknown, original: unknown, index: number) => unknown\n    >;\n    return Promise.all(\n      items.map(async (item, index) => {\n        let value: unknown = item;\n        for (const stage of typedStages) {\n          try {\n            throwIfAborted();\n            value = await stage(value, item, index);\n            throwIfAborted();\n          } catch (e) {\n            if (options.signal?.aborted) throw e;\n            const message = e instanceof Error ? e.message : String(e);\n            log(`pipeline[${index}] failed: ${message}`);\n            return null;\n          }\n        }\n        return value;\n      }),\n    );\n  };\n\n  const context = createContext({\n    agent,\n    parallel,\n    pipeline,\n    log,\n    phase,\n    args: options.args,\n    cwd: options.cwd,\n    process: Object.freeze({ cwd: () => options.cwd }),\n    budget,\n    console: {\n      log,\n      info: log,\n      warn: (m: unknown) => log(`[warn] ${String(m)}`),\n      error: (m: unknown) => log(`[error] ${String(m)}`),\n    },\n    JSON,\n    Math,\n    Array,\n    Object,\n    String,\n    Number,\n    Boolean,\n    Set,\n    Map,\n    Promise,\n  });\n\n  const wrapped = `(async () => {\\n${body}\\n})()`;\n  const script$ = new Script(wrapped, { filename: `${meta.name}.workflow.js` });\n\n  let result: unknown;\n  try {\n    result = await script$.runInContext(context);\n    // Wait for any agent() runs the script forgot to await before declaring success.\n    await Promise.allSettled([...pendingAgentRuns]);\n  } catch (e) {\n    // Drain pending agent calls before propagating, so the snapshot reflects final state.\n    await Promise.allSettled([...pendingAgentRuns]);\n    throw e;\n  }\n\n  assertStructuredCloneable(result, 'workflow result');\n\n  return {\n    meta,\n    result: result as T,\n    logs: state.logs,\n    phases: state.phases,\n    agentCount: state.agentCount,\n    durationMs: Date.now() - started,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Initial snapshot helper — kept here so the runtime is the single source of\n// truth for \"what a fresh snapshot looks like for this workflow\".\n// ---------------------------------------------------------------------------\n\nexport function emptySnapshotFor(name: string, description?: string): WorkflowSnapshot {\n  return {\n    name,\n    description,\n    phases: [],\n    logs: [],\n    agents: [],\n    agentCount: 0,\n    runningCount: 0,\n    doneCount: 0,\n    errorCount: 0,\n    skippedCount: 0,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Internals\n// ---------------------------------------------------------------------------\n\nfunction clampConcurrency(requested?: number): number {\n  if (typeof requested === 'number' && Number.isFinite(requested) && requested >= 1) {\n    return Math.min(Math.floor(requested), DEFAULT_CONCURRENCY_CEILING);\n  }\n  let cpu = DEFAULT_CONCURRENCY_CEILING;\n  try {\n    cpu = availableParallelism();\n  } catch {\n    // Some sandboxes throw; fall back to the ceiling.\n  }\n  return Math.max(DEFAULT_CONCURRENCY_FLOOR, Math.min(DEFAULT_CONCURRENCY_CEILING, cpu - 2));\n}\n\nfunction createLimiter(limit: number) {\n  let active = 0;\n  const queue: Array<() => void> = [];\n  const next = () => {\n    active -= 1;\n    const resume = queue.shift();\n    if (resume) resume();\n  };\n  return async <T>(fn: () => Promise<T>): Promise<T> => {\n    if (active >= limit) {\n      await new Promise<void>((resolve) => queue.push(resolve));\n    }\n    active += 1;\n    try {\n      return await fn();\n    } finally {\n      next();\n    }\n  };\n}\n\nfunction requireString(value: unknown, name: string): string {\n  if (typeof value !== 'string') throw new TypeError(`${name} must be a string`);\n  return value;\n}\n\nfunction optionalString(value: unknown, name: string): string | undefined {\n  if (value === undefined) return undefined;\n  return requireString(value, name);\n}\n\nfunction normalizeAgentOptions(value: unknown): AgentScriptOptions {\n  if (value === undefined || value === null) return {};\n  if (typeof value !== 'object') throw new TypeError('agent options must be an object');\n  const options = value as AgentScriptOptions;\n  const toolset = options.toolset;\n  if (toolset !== undefined) {\n    if (!Array.isArray(toolset) || toolset.some((t) => typeof t !== 'string')) {\n      throw new TypeError('agent toolset must be an array of strings');\n    }\n  }\n  const maxIterations = options.maxIterations;\n  if (maxIterations !== undefined) {\n    if (typeof maxIterations !== 'number' || !Number.isFinite(maxIterations) || maxIterations < 1) {\n      throw new TypeError('agent maxIterations must be a positive number');\n    }\n  }\n  return {\n    label: optionalString(options.label, 'agent label'),\n    phase: optionalString(options.phase, 'agent phase'),\n    schema: options.schema,\n    model: optionalString(options.model, 'agent model'),\n    toolset,\n    maxIterations,\n  };\n}\n\nfunction assertStructuredCloneable(value: unknown, name: string): void {\n  try {\n    structuredClone(value);\n  } catch (e) {\n    const detail = e instanceof Error ? ` ${e.message}` : '';\n    throw new Error(\n      `${name} must be structured-cloneable; did you forget to await agent(), parallel(), or pipeline()?${detail}`,\n    );\n  }\n}\n\nfunction defaultAgentLabel(phase: string | undefined, index: number): string {\n  return phase ? `${phase} agent ${index}` : `agent ${index}`;\n}\n\nfunction estimateTokens(value: unknown): number {\n  if (value === null || value === undefined) return 0;\n  try {\n    return Math.ceil(JSON.stringify(value).length / 4);\n  } catch {\n    return Math.ceil(String(value).length / 4);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"runtime.js","names":[],"sources":["../../../../src/agent/workflow/runtime.ts"],"sourcesContent":["/**\n * Sandboxed workflow runtime.\n *\n * Parses the script via {@link parseWorkflowScript} (which strips the `meta`\n * export), wraps the remaining body in an async IIFE, and runs it inside a\n * Node `vm` context with a curated set of globals:\n *\n *   - `agent(prompt, opts)` — spawns a subagent through the injected\n *     {@link SubagentRunner} and returns its result (string, or schema-validated\n *     object). Failures resolve to `null`.\n *   - `parallel(thunks)` — concurrent fan-out; thunks (not promises!) so the\n *     limiter sees each agent() call.\n *   - `pipeline(items, ...stages)` — per-item sequential stages, items run\n *     concurrently (no stage barrier). Each stage receives\n *     `(prevResult, originalItem, index)`. A stage that throws drops that item\n *     to `null` and skips remaining stages.\n *   - `phase(title)` — marks the current phase; surfaces through `onPhase`.\n *   - `log(message)` — appends to the workflow log.\n *   - `budget` — `{ total, spent(), remaining() }` for self-pacing scripts.\n *   - `args`, `cwd`, `process.cwd()`.\n *\n * The runtime is the only code that touches `vm`. It exposes no IO surface,\n * carries no LLM dependency, and is fully driven by injected callbacks — that\n * means the workflow tool, tests, and any future runner share one runtime.\n */\n\nimport { availableParallelism } from 'node:os';\nimport { createContext, Script } from 'node:vm';\n\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport { parseWorkflowScript } from './parser.js';\nimport type {\n  AgentScriptOptions,\n  SubagentRunner,\n  WorkflowMetaPhase,\n  WorkflowRunOptions,\n  WorkflowRunResult,\n  WorkflowSnapshot,\n  WorkflowAgentStatus,\n} from './types.js';\n\nconst DEFAULT_CONCURRENCY_FLOOR = 1;\nconst DEFAULT_CONCURRENCY_CEILING = 16;\nconst DEFAULT_MAX_SUBAGENTS = 1000;\n\ninterface RuntimeState {\n  currentPhase?: string;\n  logs: string[];\n  phases: string[];\n  agentCount: number;\n  spent: number;\n}\n\nexport interface RunWorkflowDeps {\n  runner: SubagentRunner;\n  /** Resolve a model ref (`provider/model` or configured typed id) to a {@link Model}. Throws on unknown ref. */\n  resolveModelId?: (modelId: string) => Model<Api>;\n}\n\nexport async function runWorkflow<T = unknown>(\n  script: string,\n  deps: RunWorkflowDeps,\n  options: WorkflowRunOptions,\n): Promise<WorkflowRunResult<T>> {\n  const started = Date.now();\n  const { meta, body } = parseWorkflowScript(script);\n\n  const state: RuntimeState = { logs: [], phases: [], agentCount: 0, spent: 0 };\n  const concurrency = clampConcurrency(options.concurrency);\n  const maxSubagents = Math.max(1, options.maxSubagents ?? DEFAULT_MAX_SUBAGENTS);\n  const limiter = createLimiter(concurrency);\n  const pendingAgentRuns = new Set<Promise<unknown>>();\n  const phaseDefaultModels = buildPhaseModelMap(meta.phases);\n\n  const log = (message: unknown) => {\n    const text = String(message);\n    state.logs.push(text);\n    options.onLog?.(text);\n  };\n\n  const phase = (title: unknown) => {\n    const text = requireString(title, 'phase title');\n    state.currentPhase = text;\n    if (!state.phases.includes(text)) state.phases.push(text);\n    options.onPhase?.(text);\n  };\n\n  const budget = Object.freeze({\n    total: options.tokenBudget ?? null,\n    spent: () => state.spent,\n    remaining: () =>\n      options.tokenBudget == null\n        ? Number.POSITIVE_INFINITY\n        : Math.max(0, options.tokenBudget - state.spent),\n  });\n\n  const throwIfAborted = () => {\n    if (options.signal?.aborted) throw new Error('workflow aborted');\n  };\n\n  const resolveAgentModel = (\n    normalized: AgentScriptOptions,\n    assignedPhase: string | undefined,\n  ): Model<Api> | undefined => {\n    const realId = normalized.model?.trim();\n    if (realId) {\n      if (!deps.resolveModelId) {\n        throw new Error('workflow runtime missing resolveModelId; cannot resolve real model id');\n      }\n      return deps.resolveModelId(realId);\n    }\n    if (assignedPhase) {\n      const phaseRef = phaseDefaultModels.get(assignedPhase);\n      if (phaseRef) {\n        if (!deps.resolveModelId) return undefined;\n        return deps.resolveModelId(phaseRef);\n      }\n    }\n    return undefined;\n  };\n\n  const agent = async (prompt: unknown, agentOptions: unknown = {}) => {\n    throwIfAborted();\n    if (budget.total !== null && budget.remaining() <= 0) {\n      throw new Error('workflow token budget exhausted');\n    }\n    if (state.agentCount >= maxSubagents) {\n      throw new Error(`workflow agent quota exhausted (max ${maxSubagents})`);\n    }\n\n    const taskPrompt = requireString(prompt, 'agent prompt');\n    const normalized = normalizeAgentOptions(agentOptions);\n    const assignedPhase = normalized.phase ?? state.currentPhase;\n    const requestedLabel = normalized.label?.trim();\n\n    state.agentCount += 1;\n    const id = state.agentCount;\n    const label = requestedLabel || defaultAgentLabel(assignedPhase, id);\n    options.onAgentQueued?.({ id, label, phase: assignedPhase, prompt: taskPrompt });\n\n    const runPromise = limiter(async () => {\n      options.onAgentStart?.({ id, label, phase: assignedPhase, prompt: taskPrompt });\n\n      try {\n        throwIfAborted();\n        const resolvedModel = resolveAgentModel(normalized, assignedPhase);\n        const enhanced = options.enhanceSubagentRun?.({\n          id,\n          label,\n          phase: assignedPhase,\n          prompt: taskPrompt,\n        });\n        const result = await deps.runner.run<unknown>(taskPrompt, {\n          label,\n          schema: normalized.schema,\n          allowedToolNames: normalized.toolset,\n          maxIterations: normalized.maxIterations,\n          phase: assignedPhase,\n          signal: options.signal,\n          model: resolvedModel,\n          ...enhanced,\n        });\n        throwIfAborted();\n\n        const status: WorkflowAgentStatus = result === null ? 'error' : 'done';\n        state.spent += estimateTokens(result);\n        options.onAgentEnd?.({ id, label, phase: assignedPhase, result, status });\n        return result;\n      } catch (e) {\n        if (options.signal?.aborted) {\n          options.onAgentEnd?.({ id, label, phase: assignedPhase, result: null, status: 'skipped' });\n          throw e;\n        }\n        const message = e instanceof Error ? e.message : String(e);\n        log(`agent ${label} failed: ${message}`);\n        options.onAgentEnd?.({ id, label, phase: assignedPhase, result: null, status: 'error' });\n        return null;\n      }\n    });\n\n    pendingAgentRuns.add(runPromise);\n    // `then` (not `finally`) keeps the bookkeeping promise from re-throwing into\n    // the unhandled-rejection channel when `runPromise` rejects on abort.\n    runPromise.then(\n      () => pendingAgentRuns.delete(runPromise),\n      () => pendingAgentRuns.delete(runPromise),\n    );\n    return runPromise;\n  };\n\n  const parallel = async (thunks: unknown) => {\n    throwIfAborted();\n    if (!Array.isArray(thunks)) throw new TypeError('parallel() expects an array of functions');\n    for (const t of thunks) {\n      if (typeof t !== 'function') {\n        throw new TypeError(\n          'parallel() expects an array of functions, not promises. Wrap each call: () => agent(...)',\n        );\n      }\n    }\n    return Promise.all(\n      thunks.map(async (thunk, index) => {\n        try {\n          return await (thunk as () => unknown)();\n        } catch (e) {\n          if (options.signal?.aborted) throw e;\n          const message = e instanceof Error ? e.message : String(e);\n          log(`parallel[${index}] failed: ${message}`);\n          return null;\n        }\n      }),\n    );\n  };\n\n  const pipeline = async (items: unknown, ...stages: Array<unknown>) => {\n    throwIfAborted();\n    if (!Array.isArray(items)) {\n      throw new TypeError('pipeline() expects an array as the first argument');\n    }\n    for (const stage of stages) {\n      if (typeof stage !== 'function') {\n        throw new TypeError(\n          'pipeline() stages must be functions: pipeline(items, item => ..., result => ...)',\n        );\n      }\n    }\n    const typedStages = stages as Array<\n      (prev: unknown, original: unknown, index: number) => unknown\n    >;\n    return Promise.all(\n      items.map(async (item, index) => {\n        let value: unknown = item;\n        for (const stage of typedStages) {\n          try {\n            throwIfAborted();\n            value = await stage(value, item, index);\n            throwIfAborted();\n          } catch (e) {\n            if (options.signal?.aborted) throw e;\n            const message = e instanceof Error ? e.message : String(e);\n            log(`pipeline[${index}] failed: ${message}`);\n            return null;\n          }\n        }\n        return value;\n      }),\n    );\n  };\n\n  const context = createContext({\n    agent,\n    parallel,\n    pipeline,\n    log,\n    phase,\n    args: options.args,\n    cwd: options.cwd,\n    process: Object.freeze({ cwd: () => options.cwd }),\n    budget,\n    console: {\n      log,\n      info: log,\n      warn: (m: unknown) => log(`[warn] ${String(m)}`),\n      error: (m: unknown) => log(`[error] ${String(m)}`),\n    },\n    JSON,\n    Math,\n    Array,\n    Object,\n    String,\n    Number,\n    Boolean,\n    Set,\n    Map,\n    Promise,\n  });\n\n  const wrapped = `(async () => {\\n${body}\\n})()`;\n  const script$ = new Script(wrapped, { filename: `${meta.name}.workflow.js` });\n\n  let result: unknown;\n  try {\n    result = await script$.runInContext(context);\n    // Wait for any agent() runs the script forgot to await before declaring success.\n    await Promise.allSettled([...pendingAgentRuns]);\n  } catch (e) {\n    // Drain pending agent calls before propagating, so the snapshot reflects final state.\n    await Promise.allSettled([...pendingAgentRuns]);\n    throw rewriteScriptError(e);\n  }\n\n  assertStructuredCloneable(result, 'workflow result');\n\n  return {\n    meta,\n    result: result as T,\n    logs: state.logs,\n    phases: state.phases,\n    agentCount: state.agentCount,\n    durationMs: Date.now() - started,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Initial snapshot helper — kept here so the runtime is the single source of\n// truth for \"what a fresh snapshot looks like for this workflow\".\n// ---------------------------------------------------------------------------\n\nexport function emptySnapshotFor(\n  name: string,\n  description?: string,\n  phaseTitles?: string[],\n): WorkflowSnapshot {\n  return {\n    name,\n    description,\n    phases: phaseTitles ? [...phaseTitles] : [],\n    logs: [],\n    agents: [],\n    agentCount: 0,\n    runningCount: 0,\n    doneCount: 0,\n    errorCount: 0,\n    skippedCount: 0,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Internals\n// ---------------------------------------------------------------------------\n\nfunction clampConcurrency(requested?: number): number {\n  if (typeof requested === 'number' && Number.isFinite(requested) && requested >= 1) {\n    return Math.min(Math.floor(requested), DEFAULT_CONCURRENCY_CEILING);\n  }\n  let cpu = DEFAULT_CONCURRENCY_CEILING;\n  try {\n    cpu = availableParallelism();\n  } catch {\n    // Some sandboxes throw; fall back to the ceiling.\n  }\n  return Math.max(DEFAULT_CONCURRENCY_FLOOR, Math.min(DEFAULT_CONCURRENCY_CEILING, cpu - 2));\n}\n\nfunction createLimiter(limit: number) {\n  let active = 0;\n  const queue: Array<() => void> = [];\n  const next = () => {\n    active -= 1;\n    const resume = queue.shift();\n    if (resume) resume();\n  };\n  return async <T>(fn: () => Promise<T>): Promise<T> => {\n    if (active >= limit) {\n      await new Promise<void>((resolve) => queue.push(resolve));\n    }\n    active += 1;\n    try {\n      return await fn();\n    } finally {\n      next();\n    }\n  };\n}\n\nfunction buildPhaseModelMap(phases: WorkflowMetaPhase[] | undefined): Map<string, string> {\n  const out = new Map<string, string>();\n  if (!phases) return out;\n  for (const p of phases) {\n    if (p && typeof p.title === 'string' && typeof p.model === 'string' && p.model.trim()) {\n      out.set(p.title, p.model.trim());\n    }\n  }\n  return out;\n}\n\nfunction requireString(value: unknown, name: string): string {\n  if (typeof value !== 'string') throw new TypeError(`${name} must be a string`);\n  return value;\n}\n\nfunction optionalString(value: unknown, name: string): string | undefined {\n  if (value === undefined) return undefined;\n  return requireString(value, name);\n}\n\nfunction normalizeAgentOptions(value: unknown): AgentScriptOptions {\n  if (value === undefined || value === null) return {};\n  if (typeof value !== 'object') throw new TypeError('agent options must be an object');\n  const options = value as AgentScriptOptions;\n  const toolset = options.toolset;\n  if (toolset !== undefined) {\n    if (!Array.isArray(toolset) || toolset.some((t) => typeof t !== 'string')) {\n      throw new TypeError('agent toolset must be an array of strings');\n    }\n  }\n  const maxIterations = options.maxIterations;\n  if (maxIterations !== undefined) {\n    if (typeof maxIterations !== 'number' || !Number.isFinite(maxIterations) || maxIterations < 1) {\n      throw new TypeError('agent maxIterations must be a positive number');\n    }\n  }\n  const modelStr = optionalString(options.model, 'agent model');\n  return {\n    label: optionalString(options.label, 'agent label'),\n    phase: optionalString(options.phase, 'agent phase'),\n    schema: options.schema,\n    model: modelStr,\n    toolset,\n    maxIterations,\n  };\n}\n\nfunction assertStructuredCloneable(value: unknown, name: string): void {\n  try {\n    structuredClone(value);\n  } catch (e) {\n    const promisePath = findPromisePath(value, '');\n    if (promisePath !== null) {\n      throw new Error(\n        `${name} contains a Promise at \\`${promisePath || '<root>'}\\` — missing 'await' before parallel()/pipeline()/agent(). ` +\n          `Async return auto-unwraps a bare Promise, but a Promise nested in an object/array is returned as-is.`,\n      );\n    }\n    const detail = e instanceof Error ? ` ${e.message}` : '';\n    throw new Error(\n      `${name} must be structured-cloneable; did you forget to await agent(), parallel(), or pipeline()?${detail}`,\n    );\n  }\n}\n\n/**\n * Find the first Promise lurking in `value`, returning a JS-path like\n * \"results[0].pending\". Returns null when no Promise is found. Bounded\n * depth/breadth so it never explodes on weird user shapes.\n */\nfunction findPromisePath(value: unknown, path: string, depth = 0): string | null {\n  if (depth > 4) return null;\n  if (isThenable(value)) return path;\n  if (Array.isArray(value)) {\n    for (let i = 0; i < Math.min(value.length, 32); i++) {\n      const inner = findPromisePath(value[i], `${path}[${i}]`, depth + 1);\n      if (inner !== null) return inner;\n    }\n    return null;\n  }\n  if (value !== null && typeof value === 'object') {\n    let count = 0;\n    for (const [key, child] of Object.entries(value as Record<string, unknown>)) {\n      if (count++ > 32) break;\n      const inner = findPromisePath(child, path ? `${path}.${key}` : key, depth + 1);\n      if (inner !== null) return inner;\n    }\n  }\n  return null;\n}\n\nfunction isThenable(value: unknown): boolean {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as { then?: unknown }).then === 'function'\n  );\n}\n\n/**\n * Rewrite TypeErrors that look like \"called .map on a Promise\" with an\n * await-shaped hint. Static lint catches the obvious form at parse time;\n * this is the safety net for cases lint can't see (dynamic indirection,\n * values stashed in helper closures).\n */\nconst PROMISE_METHOD_ERROR =\n  /\\.(map|filter|forEach|flat|flatMap|find|some|every|reduce|join|length|then)\\b is not a function/;\n\nfunction rewriteScriptError(error: unknown): Error {\n  // VM-context errors aren't `instanceof` host classes (the vm has its own\n  // global constructors), so check by name + duck-typing message.\n  const asError = error as { name?: string; message?: string } | null | undefined;\n  const isTypeError = asError?.name === 'TypeError' && typeof asError.message === 'string';\n  if (!isTypeError) {\n    return error instanceof Error ? error : new Error(String(error));\n  }\n  const message = (asError as { message: string }).message;\n  if (!PROMISE_METHOD_ERROR.test(message)) {\n    return error instanceof Error ? error : new Error(message);\n  }\n  return new Error(\n    `${message}\\n\\nHint: parallel()/pipeline()/agent() return a Promise — 'await' the call before using its result.\\n` +\n      `  ❌ const r = parallel(...); r.map(...)\\n` +\n      `  ✅ const r = await parallel(...); r.map(...)`,\n  );\n}\n\nfunction defaultAgentLabel(phase: string | undefined, index: number): string {\n  return phase ? `${phase} agent ${index}` : `agent ${index}`;\n}\n\nfunction estimateTokens(value: unknown): number {\n  if (value === null || value === undefined) return 0;\n  try {\n    return Math.ceil(JSON.stringify(value).length / 4);\n  } catch {\n    return Math.ceil(String(value).length / 4);\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/workflow/snapshot.js

@@ -1,17 +1,7 @@
+import { emptySnapshotFor } from "./runtime.js";
 //#region src/agent/workflow/snapshot.ts
 function createWorkflowSnapshot(meta) {
-	return {
-		name: meta.name,
-		description: meta.description,
-		phases: [],
-		logs: [],
-		agents: [],
-		agentCount: 0,
-		runningCount: 0,
-		doneCount: 0,
-		errorCount: 0,
-		skippedCount: 0
-	};
+	return emptySnapshotFor(meta.name, meta.description, meta.phases?.map((p) => p.title));
 }
 function recomputeCounts(snapshot) {
 	let running = 0;

package/dist/src/agent/workflow/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","names":[],"sources":["../../../../src/agent/workflow/snapshot.ts"],"sourcesContent":["/**\n * Workflow progress snapshot model + text renderers.\n *\n * The runtime emits per-event callbacks (`onPhase`, `onAgentStart`, `onAgentEnd`,\n * `onLog`). The workflow tool wraps those callbacks to mutate a snapshot and push\n * a text rendering through `onUpdate` — keeping TUI / Gateway / IM consumers in\n * lock-step from a single source of truth.\n */\n\nimport type {\n  WorkflowAgentSnapshot,\n  WorkflowAgentStatus,\n  WorkflowMeta,\n  WorkflowSnapshot,\n} from './types.js';\n\nexport function createWorkflowSnapshot(meta: WorkflowMeta): WorkflowSnapshot {\n  return {\n    name: meta.name,\n    description: meta.description,\n    phases: [],\n    logs: [],\n    agents: [],\n    agentCount: 0,\n    runningCount: 0,\n    doneCount: 0,\n    errorCount: 0,\n    skippedCount: 0,\n  };\n}\n\nexport function recomputeCounts(snapshot: WorkflowSnapshot): void {\n  let running = 0;\n  let done = 0;\n  let error = 0;\n  let skipped = 0;\n  for (const agent of snapshot.agents) {\n    switch (agent.status) {\n      case 'running':\n        running++;\n        break;\n      case 'done':\n        done++;\n        break;\n      case 'error':\n        error++;\n        break;\n      case 'skipped':\n        skipped++;\n        break;\n    }\n  }\n  snapshot.agentCount = snapshot.agents.length;\n  snapshot.runningCount = running;\n  snapshot.doneCount = done;\n  snapshot.errorCount = error;\n  snapshot.skippedCount = skipped;\n}\n\nexport interface RenderOptions {\n  maxAgentsPerPhase?: number;\n  maxLogs?: number;\n  showResultPreviews?: boolean;\n}\n\nexport function renderWorkflowText(\n  snapshot: WorkflowSnapshot,\n  completed = false,\n  options: RenderOptions = {},\n): string {\n  const maxAgentsPerPhase = options.maxAgentsPerPhase ?? 6;\n  const maxLogs = options.maxLogs ?? 2;\n  const showPreviews = options.showResultPreviews ?? false;\n\n  const state = stateSuffix(snapshot);\n  const header = completed\n    ? `◆ workflow ✓ ${snapshot.name} (${snapshot.doneCount}/${snapshot.agentCount} done${state})`\n    : `◆ workflow: ${snapshot.name} (${snapshot.doneCount}/${snapshot.agentCount} done${state})`;\n  const lines = [header];\n\n  const phaseNames = uniqueOrdered([\n    ...snapshot.phases,\n    ...(snapshot.currentPhase ? [snapshot.currentPhase] : []),\n    ...snapshot.agents.map((a) => a.phase).filter((p): p is string => Boolean(p)),\n  ]);\n  const rendered = new Set<WorkflowAgentSnapshot>();\n\n  for (const phase of phaseNames) {\n    const agents = snapshot.agents.filter((a) => a.phase === phase);\n    if (agents.length === 0 && snapshot.currentPhase !== phase) continue;\n    for (const a of agents) rendered.add(a);\n\n    const counts = countAgents(agents);\n    const completeHere = agents.length > 0 && counts.done + counts.error + counts.skipped === agents.length;\n    const marker =\n      counts.running > 0 || (!completeHere && snapshot.currentPhase === phase)\n        ? '▶'\n        : completeHere\n          ? '✓'\n          : ' ';\n\n    const tail =\n      (counts.running ? ` · ${counts.running} running` : '') +\n      (counts.error ? ` · ${counts.error} errors` : '') +\n      (counts.skipped ? ` · ${counts.skipped} skipped` : '');\n    lines.push(`  ${marker} ${phase} ${counts.done}/${agents.length}${tail}`);\n\n    const visible = agents.slice(-maxAgentsPerPhase);\n    for (const agent of visible) {\n      const previewText = showPreviews && agent.resultPreview ? ` — ${agent.resultPreview}` : '';\n      lines.push(\n        `    #${agent.id} ${statusIcon(agent.status)} ${shorten(agent.label, 56)}${previewText}`,\n      );\n    }\n    if (agents.length > visible.length) {\n      lines.push(`    … ${agents.length - visible.length} earlier agents`);\n    }\n  }\n\n  const unphased = snapshot.agents.filter((a) => !rendered.has(a));\n  if (unphased.length > 0) {\n    lines.push('  unphased');\n    for (const agent of unphased.slice(-maxAgentsPerPhase)) {\n      const previewText = showPreviews && agent.resultPreview ? ` — ${agent.resultPreview}` : '';\n      lines.push(\n        `    #${agent.id} ${statusIcon(agent.status)} ${shorten(agent.label, 56)}${previewText}`,\n      );\n    }\n  }\n\n  const visibleLogs = snapshot.logs.slice(-maxLogs);\n  if (visibleLogs.length > 0) {\n    lines.push('');\n    for (const log of visibleLogs) {\n      lines.push(`  log: ${shorten(log, 80)}`);\n    }\n  }\n  return lines.join('\\n');\n}\n\nexport function previewValue(value: unknown, max = 80): string {\n  if (value === null || value === undefined) return '';\n  const text = typeof value === 'string' ? value : safeStringify(value);\n  if (!text) return '';\n  return text.length > max ? `${text.slice(0, max - 1)}…` : text;\n}\n\n// ---------------------------------------------------------------------------\n\nfunction countAgents(agents: WorkflowAgentSnapshot[]) {\n  let done = 0;\n  let running = 0;\n  let error = 0;\n  let skipped = 0;\n  for (const a of agents) {\n    if (a.status === 'done') done++;\n    else if (a.status === 'running') running++;\n    else if (a.status === 'error') error++;\n    else if (a.status === 'skipped') skipped++;\n  }\n  return { done, running, error, skipped };\n}\n\nfunction statusIcon(status: WorkflowAgentStatus): string {\n  switch (status) {\n    case 'queued':\n      return '○';\n    case 'running':\n      return '●';\n    case 'done':\n      return '✓';\n    case 'error':\n      return '✗';\n    case 'skipped':\n      return '-';\n  }\n}\n\nfunction stateSuffix(snapshot: WorkflowSnapshot): string {\n  if (snapshot.errorCount > 0) return `, ${snapshot.errorCount} errors`;\n  if (snapshot.skippedCount > 0) return `, ${snapshot.skippedCount} skipped`;\n  if (snapshot.runningCount > 0) return `, ${snapshot.runningCount} running`;\n  return '';\n}\n\nfunction uniqueOrdered(values: string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const v of values) {\n    if (!seen.has(v)) {\n      seen.add(v);\n      out.push(v);\n    }\n  }\n  return out;\n}\n\nfunction shorten(value: string, max: number): string {\n  const text = value.replace(/\\s+/g, ' ').trim();\n  return text.length > max ? `${text.slice(0, max - 1)}…` : text;\n}\n\nfunction safeStringify(value: unknown): string {\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n"],"mappings":";AAgBA,SAAgB,uBAAuB,MAAsC;AAC3E,QAAO;EACL,MAAM,KAAK;EACX,aAAa,KAAK;EAClB,QAAQ,EAAE;EACV,MAAM,EAAE;EACR,QAAQ,EAAE;EACV,YAAY;EACZ,cAAc;EACd,WAAW;EACX,YAAY;EACZ,cAAc;EACf;;AAGH,SAAgB,gBAAgB,UAAkC;CAChE,IAAI,UAAU;CACd,IAAI,OAAO;CACX,IAAI,QAAQ;CACZ,IAAI,UAAU;AACd,MAAK,MAAM,SAAS,SAAS,OAC3B,SAAQ,MAAM,QAAd;EACE,KAAK;AACH;AACA;EACF,KAAK;AACH;AACA;EACF,KAAK;AACH;AACA;EACF,KAAK;AACH;AACA;;AAGN,UAAS,aAAa,SAAS,OAAO;AACtC,UAAS,eAAe;AACxB,UAAS,YAAY;AACrB,UAAS,aAAa;AACtB,UAAS,eAAe;;AAS1B,SAAgB,mBACd,UACA,YAAY,OACZ,UAAyB,EAAE,EACnB;CACR,MAAM,oBAAoB,QAAQ,qBAAqB;CACvD,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,eAAe,QAAQ,sBAAsB;CAEnD,MAAM,QAAQ,YAAY,SAAS;CAInC,MAAM,QAAQ,CAHC,YACX,gBAAgB,SAAS,KAAK,IAAI,SAAS,UAAU,GAAG,SAAS,WAAW,OAAO,MAAM,KACzF,eAAe,SAAS,KAAK,IAAI,SAAS,UAAU,GAAG,SAAS,WAAW,OAAO,MAAM,GACtE;CAEtB,MAAM,aAAa,cAAc;EAC/B,GAAG,SAAS;EACZ,GAAI,SAAS,eAAe,CAAC,SAAS,aAAa,GAAG,EAAE;EACxD,GAAG,SAAS,OAAO,KAAK,MAAM,EAAE,MAAM,CAAC,QAAQ,MAAmB,QAAQ,EAAE,CAAC;EAC9E,CAAC;CACF,MAAM,2BAAW,IAAI,KAA4B;AAEjD,MAAK,MAAM,SAAS,YAAY;EAC9B,MAAM,SAAS,SAAS,OAAO,QAAQ,MAAM,EAAE,UAAU,MAAM;AAC/D,MAAI,OAAO,WAAW,KAAK,SAAS,iBAAiB,MAAO;AAC5D,OAAK,MAAM,KAAK,OAAQ,UAAS,IAAI,EAAE;EAEvC,MAAM,SAAS,YAAY,OAAO;EAClC,MAAM,eAAe,OAAO,SAAS,KAAK,OAAO,OAAO,OAAO,QAAQ,OAAO,YAAY,OAAO;EACjG,MAAM,SACJ,OAAO,UAAU,KAAM,CAAC,gBAAgB,SAAS,iBAAiB,QAC9D,MACA,eACE,MACA;EAER,MAAM,QACH,OAAO,UAAU,MAAM,OAAO,QAAQ,YAAY,OAClD,OAAO,QAAQ,MAAM,OAAO,MAAM,WAAW,OAC7C,OAAO,UAAU,MAAM,OAAO,QAAQ,YAAY;AACrD,QAAM,KAAK,KAAK,OAAO,GAAG,MAAM,GAAG,OAAO,KAAK,GAAG,OAAO,SAAS,OAAO;EAEzE,MAAM,UAAU,OAAO,MAAM,CAAC,kBAAkB;AAChD,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,cAAc,gBAAgB,MAAM,gBAAgB,MAAM,MAAM,kBAAkB;AACxF,SAAM,KACJ,QAAQ,MAAM,GAAG,GAAG,WAAW,MAAM,OAAO,CAAC,GAAG,QAAQ,MAAM,OAAO,GAAG,GAAG,cAC5E;;AAEH,MAAI,OAAO,SAAS,QAAQ,OAC1B,OAAM,KAAK,SAAS,OAAO,SAAS,QAAQ,OAAO,iBAAiB;;CAIxE,MAAM,WAAW,SAAS,OAAO,QAAQ,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;AAChE,KAAI,SAAS,SAAS,GAAG;AACvB,QAAM,KAAK,aAAa;AACxB,OAAK,MAAM,SAAS,SAAS,MAAM,CAAC,kBAAkB,EAAE;GACtD,MAAM,cAAc,gBAAgB,MAAM,gBAAgB,MAAM,MAAM,kBAAkB;AACxF,SAAM,KACJ,QAAQ,MAAM,GAAG,GAAG,WAAW,MAAM,OAAO,CAAC,GAAG,QAAQ,MAAM,OAAO,GAAG,GAAG,cAC5E;;;CAIL,MAAM,cAAc,SAAS,KAAK,MAAM,CAAC,QAAQ;AACjD,KAAI,YAAY,SAAS,GAAG;AAC1B,QAAM,KAAK,GAAG;AACd,OAAK,MAAM,OAAO,YAChB,OAAM,KAAK,UAAU,QAAQ,KAAK,GAAG,GAAG;;AAG5C,QAAO,MAAM,KAAK,KAAK;;AAGzB,SAAgB,aAAa,OAAgB,MAAM,IAAY;AAC7D,KAAI,UAAU,QAAQ,UAAU,KAAA,EAAW,QAAO;CAClD,MAAM,OAAO,OAAO,UAAU,WAAW,QAAQ,cAAc,MAAM;AACrE,KAAI,CAAC,KAAM,QAAO;AAClB,QAAO,KAAK,SAAS,MAAM,GAAG,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK;;AAK5D,SAAS,YAAY,QAAiC;CACpD,IAAI,OAAO;CACX,IAAI,UAAU;CACd,IAAI,QAAQ;CACZ,IAAI,UAAU;AACd,MAAK,MAAM,KAAK,OACd,KAAI,EAAE,WAAW,OAAQ;UAChB,EAAE,WAAW,UAAW;UACxB,EAAE,WAAW,QAAS;UACtB,EAAE,WAAW,UAAW;AAEnC,QAAO;EAAE;EAAM;EAAS;EAAO;EAAS;;AAG1C,SAAS,WAAW,QAAqC;AACvD,SAAQ,QAAR;EACE,KAAK,SACH,QAAO;EACT,KAAK,UACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,KAAK,QACH,QAAO;EACT,KAAK,UACH,QAAO;;;AAIb,SAAS,YAAY,UAAoC;AACvD,KAAI,SAAS,aAAa,EAAG,QAAO,KAAK,SAAS,WAAW;AAC7D,KAAI,SAAS,eAAe,EAAG,QAAO,KAAK,SAAS,aAAa;AACjE,KAAI,SAAS,eAAe,EAAG,QAAO,KAAK,SAAS,aAAa;AACjE,QAAO;;AAGT,SAAS,cAAc,QAA4B;CACjD,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,MAAgB,EAAE;AACxB,MAAK,MAAM,KAAK,OACd,KAAI,CAAC,KAAK,IAAI,EAAE,EAAE;AAChB,OAAK,IAAI,EAAE;AACX,MAAI,KAAK,EAAE;;AAGf,QAAO;;AAGT,SAAS,QAAQ,OAAe,KAAqB;CACnD,MAAM,OAAO,MAAM,QAAQ,QAAQ,IAAI,CAAC,MAAM;AAC9C,QAAO,KAAK,SAAS,MAAM,GAAG,KAAK,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK;;AAG5D,SAAS,cAAc,OAAwB;AAC7C,KAAI;AACF,SAAO,KAAK,UAAU,MAAM;SACtB;AACN,SAAO,OAAO,MAAM"}
+{"version":3,"file":"snapshot.js","names":[],"sources":["../../../../src/agent/workflow/snapshot.ts"],"sourcesContent":["/**\n * Workflow progress snapshot model + text renderers.\n *\n * The runtime emits per-event callbacks (`onPhase`, `onAgentStart`, `onAgentEnd`,\n * `onLog`). The workflow tool wraps those callbacks to mutate a snapshot and push\n * a text rendering through `onUpdate` — keeping TUI / Gateway / IM consumers in\n * lock-step from a single source of truth.\n */\n\nimport type {\n  WorkflowAgentSnapshot,\n  WorkflowAgentStatus,\n  WorkflowMeta,\n  WorkflowSnapshot,\n} from './types.js';\nimport { emptySnapshotFor } from './runtime.js';\n\nexport function createWorkflowSnapshot(meta: WorkflowMeta): WorkflowSnapshot {\n  return emptySnapshotFor(\n    meta.name,\n    meta.description,\n    meta.phases?.map((p) => p.title),\n  );\n}\n\nexport function recomputeCounts(snapshot: WorkflowSnapshot): void {\n  let running = 0;\n  let done = 0;\n  let error = 0;\n  let skipped = 0;\n  for (const agent of snapshot.agents) {\n    switch (agent.status) {\n      case 'running':\n        running++;\n        break;\n      case 'done':\n        done++;\n        break;\n      case 'error':\n        error++;\n        break;\n      case 'skipped':\n        skipped++;\n        break;\n    }\n  }\n  snapshot.agentCount = snapshot.agents.length;\n  snapshot.runningCount = running;\n  snapshot.doneCount = done;\n  snapshot.errorCount = error;\n  snapshot.skippedCount = skipped;\n}\n\nexport interface RenderOptions {\n  maxAgentsPerPhase?: number;\n  maxLogs?: number;\n  showResultPreviews?: boolean;\n}\n\nexport function renderWorkflowText(\n  snapshot: WorkflowSnapshot,\n  completed = false,\n  options: RenderOptions = {},\n): string {\n  const maxAgentsPerPhase = options.maxAgentsPerPhase ?? 6;\n  const maxLogs = options.maxLogs ?? 2;\n  const showPreviews = options.showResultPreviews ?? false;\n\n  const state = stateSuffix(snapshot);\n  const header = completed\n    ? `◆ workflow ✓ ${snapshot.name} (${snapshot.doneCount}/${snapshot.agentCount} done${state})`\n    : `◆ workflow: ${snapshot.name} (${snapshot.doneCount}/${snapshot.agentCount} done${state})`;\n  const lines = [header];\n\n  const phaseNames = uniqueOrdered([\n    ...snapshot.phases,\n    ...(snapshot.currentPhase ? [snapshot.currentPhase] : []),\n    ...snapshot.agents.map((a) => a.phase).filter((p): p is string => Boolean(p)),\n  ]);\n  const rendered = new Set<WorkflowAgentSnapshot>();\n\n  for (const phase of phaseNames) {\n    const agents = snapshot.agents.filter((a) => a.phase === phase);\n    if (agents.length === 0 && snapshot.currentPhase !== phase) continue;\n    for (const a of agents) rendered.add(a);\n\n    const counts = countAgents(agents);\n    const completeHere = agents.length > 0 && counts.done + counts.error + counts.skipped === agents.length;\n    const marker =\n      counts.running > 0 || (!completeHere && snapshot.currentPhase === phase)\n        ? '▶'\n        : completeHere\n          ? '✓'\n          : ' ';\n\n    const tail =\n      (counts.running ? ` · ${counts.running} running` : '') +\n      (counts.error ? ` · ${counts.error} errors` : '') +\n      (counts.skipped ? ` · ${counts.skipped} skipped` : '');\n    lines.push(`  ${marker} ${phase} ${counts.done}/${agents.length}${tail}`);\n\n    const visible = agents.slice(-maxAgentsPerPhase);\n    for (const agent of visible) {\n      const previewText = showPreviews && agent.resultPreview ? ` — ${agent.resultPreview}` : '';\n      lines.push(\n        `    #${agent.id} ${statusIcon(agent.status)} ${shorten(agent.label, 56)}${previewText}`,\n      );\n    }\n    if (agents.length > visible.length) {\n      lines.push(`    … ${agents.length - visible.length} earlier agents`);\n    }\n  }\n\n  const unphased = snapshot.agents.filter((a) => !rendered.has(a));\n  if (unphased.length > 0) {\n    lines.push('  unphased');\n    for (const agent of unphased.slice(-maxAgentsPerPhase)) {\n      const previewText = showPreviews && agent.resultPreview ? ` — ${agent.resultPreview}` : '';\n      lines.push(\n        `    #${agent.id} ${statusIcon(agent.status)} ${shorten(agent.label, 56)}${previewText}`,\n      );\n    }\n  }\n\n  const visibleLogs = snapshot.logs.slice(-maxLogs);\n  if (visibleLogs.length > 0) {\n    lines.push('');\n    for (const log of visibleLogs) {\n      lines.push(`  log: ${shorten(log, 80)}`);\n    }\n  }\n  return lines.join('\\n');\n}\n\nexport function previewValue(value: unknown, max = 80): string {\n  if (value === null || value === undefined) return '';\n  const text = typeof value === 'string' ? value : safeStringify(value);\n  if (!text) return '';\n  return text.length > max ? `${text.slice(0, max - 1)}…` : text;\n}\n\n// ---------------------------------------------------------------------------\n\nfunction countAgents(agents: WorkflowAgentSnapshot[]) {\n  let done = 0;\n  let running = 0;\n  let error = 0;\n  let skipped = 0;\n  for (const a of agents) {\n    if (a.status === 'done') done++;\n    else if (a.status === 'running') running++;\n    else if (a.status === 'error') error++;\n    else if (a.status === 'skipped') skipped++;\n  }\n  return { done, running, error, skipped };\n}\n\nfunction statusIcon(status: WorkflowAgentStatus): string {\n  switch (status) {\n    case 'queued':\n      return '○';\n    case 'running':\n      return '●';\n    case 'done':\n      return '✓';\n    case 'error':\n      return '✗';\n    case 'skipped':\n      return '-';\n  }\n}\n\nfunction stateSuffix(snapshot: WorkflowSnapshot): string {\n  if (snapshot.errorCount > 0) return `, ${snapshot.errorCount} errors`;\n  if (snapshot.skippedCount > 0) return `, ${snapshot.skippedCount} skipped`;\n  if (snapshot.runningCount > 0) return `, ${snapshot.runningCount} running`;\n  return '';\n}\n\nfunction uniqueOrdered(values: string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const v of values) {\n    if (!seen.has(v)) {\n      seen.add(v);\n      out.push(v);\n    }\n  }\n  return out;\n}\n\nfunction shorten(value: string, max: number): string {\n  const text = value.replace(/\\s+/g, ' ').trim();\n  return text.length > max ? `${text.slice(0, max - 1)}…` : text;\n}\n\nfunction safeStringify(value: unknown): string {\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/workflow/step-labels.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Human-readable labels for workflow subagent tool steps (server-side snapshot).
+ * Mirrors the web `tool-friendly-title` rules so IM/TUI and gateway stay aligned.
+ */
+export declare function workflowStepLabel(toolName: string, args: Record<string, unknown>): {
+    label: string;
+    detail?: string;
+};

package/dist/src/agent/workflow/step-labels.js

@@ -0,0 +1,48 @@
+//#region src/agent/workflow/step-labels.ts
+/**
+* Human-readable labels for workflow subagent tool steps (server-side snapshot).
+* Mirrors the web `tool-friendly-title` rules so IM/TUI and gateway stay aligned.
+*/
+const MAX_DETAIL_LEN = 120;
+function workflowStepLabel(toolName, args) {
+	const n = toolName.toLowerCase().replace(/-/g, "_").trim();
+	let label = toolName.trim() || "tool";
+	if (n === "shell") label = "Run command";
+	else if (n === "list_dir" || n === "ls") label = "List directory";
+	else if (n === "write_file") label = "Write file";
+	else if (n === "edit_file") label = "Edit file";
+	else if (n === "web_fetch") label = "Fetch URL";
+	else if (n === "open_url") label = "Open URL";
+	else if (n === "web_search" || n === "brave_search" || n.includes("search")) label = "Search web";
+	else if (n === "read_file" || n.includes("read_file") || n.includes("file_read")) label = "Read file";
+	else if (n === "grep" || n === "rg") label = "Search files";
+	else if (n === "delegate_task" || n === "workflow") label = toolName;
+	const detail = extractStepDetail(n, args);
+	return detail ? {
+		label,
+		detail
+	} : { label };
+}
+function extractStepDetail(toolKey, args) {
+	for (const key of [
+		"path",
+		"file_path",
+		"filePath",
+		"target_file",
+		"targetFile"
+	]) {
+		const v = args[key];
+		if (typeof v === "string" && v.trim()) return truncate(v.trim());
+	}
+	if (toolKey === "shell" && typeof args.command === "string" && args.command.trim()) return truncate(args.command.trim());
+	if ((toolKey.includes("search") || toolKey === "grep" || toolKey === "rg") && typeof args.query === "string" && args.query.trim()) return truncate(args.query.trim());
+	if (typeof args.url === "string" && args.url.trim()) return truncate(args.url.trim());
+}
+function truncate(text) {
+	if (text.length <= MAX_DETAIL_LEN) return text;
+	return `${text.slice(0, MAX_DETAIL_LEN - 1)}…`;
+}
+//#endregion
+export { workflowStepLabel };
+
+//# sourceMappingURL=step-labels.js.map

package/dist/src/agent/workflow/step-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-labels.js","names":[],"sources":["../../../../src/agent/workflow/step-labels.ts"],"sourcesContent":["/**\n * Human-readable labels for workflow subagent tool steps (server-side snapshot).\n * Mirrors the web `tool-friendly-title` rules so IM/TUI and gateway stay aligned.\n */\n\nconst MAX_DETAIL_LEN = 120;\n\nexport function workflowStepLabel(\n  toolName: string,\n  args: Record<string, unknown>,\n): { label: string; detail?: string } {\n  const n = toolName.toLowerCase().replace(/-/g, '_').trim();\n  let label = toolName.trim() || 'tool';\n  if (n === 'shell') label = 'Run command';\n  else if (n === 'list_dir' || n === 'ls') label = 'List directory';\n  else if (n === 'write_file') label = 'Write file';\n  else if (n === 'edit_file') label = 'Edit file';\n  else if (n === 'web_fetch') label = 'Fetch URL';\n  else if (n === 'open_url') label = 'Open URL';\n  else if (n === 'web_search' || n === 'brave_search' || n.includes('search')) label = 'Search web';\n  else if (n === 'read_file' || n.includes('read_file') || n.includes('file_read')) label = 'Read file';\n  else if (n === 'grep' || n === 'rg') label = 'Search files';\n  else if (n === 'delegate_task' || n === 'workflow') label = toolName;\n\n  const detail = extractStepDetail(n, args);\n  return detail ? { label, detail } : { label };\n}\n\nfunction extractStepDetail(toolKey: string, args: Record<string, unknown>): string | undefined {\n  const pathKeys = ['path', 'file_path', 'filePath', 'target_file', 'targetFile'];\n  for (const key of pathKeys) {\n    const v = args[key];\n    if (typeof v === 'string' && v.trim()) return truncate(v.trim());\n  }\n  if (toolKey === 'shell' && typeof args.command === 'string' && args.command.trim()) {\n    return truncate(args.command.trim());\n  }\n  if (\n    (toolKey.includes('search') || toolKey === 'grep' || toolKey === 'rg') &&\n    typeof args.query === 'string' &&\n    args.query.trim()\n  ) {\n    return truncate(args.query.trim());\n  }\n  if (typeof args.url === 'string' && args.url.trim()) return truncate(args.url.trim());\n  return undefined;\n}\n\nfunction truncate(text: string): string {\n  if (text.length <= MAX_DETAIL_LEN) return text;\n  return `${text.slice(0, MAX_DETAIL_LEN - 1)}…`;\n}\n"],"mappings":";;;;;AAKA,MAAM,iBAAiB;AAEvB,SAAgB,kBACd,UACA,MACoC;CACpC,MAAM,IAAI,SAAS,aAAa,CAAC,QAAQ,MAAM,IAAI,CAAC,MAAM;CAC1D,IAAI,QAAQ,SAAS,MAAM,IAAI;AAC/B,KAAI,MAAM,QAAS,SAAQ;UAClB,MAAM,cAAc,MAAM,KAAM,SAAQ;UACxC,MAAM,aAAc,SAAQ;UAC5B,MAAM,YAAa,SAAQ;UAC3B,MAAM,YAAa,SAAQ;UAC3B,MAAM,WAAY,SAAQ;UAC1B,MAAM,gBAAgB,MAAM,kBAAkB,EAAE,SAAS,SAAS,CAAE,SAAQ;UAC5E,MAAM,eAAe,EAAE,SAAS,YAAY,IAAI,EAAE,SAAS,YAAY,CAAE,SAAQ;UACjF,MAAM,UAAU,MAAM,KAAM,SAAQ;UACpC,MAAM,mBAAmB,MAAM,WAAY,SAAQ;CAE5D,MAAM,SAAS,kBAAkB,GAAG,KAAK;AACzC,QAAO,SAAS;EAAE;EAAO;EAAQ,GAAG,EAAE,OAAO;;AAG/C,SAAS,kBAAkB,SAAiB,MAAmD;AAE7F,MAAK,MAAM,OAAO;EADA;EAAQ;EAAa;EAAY;EAAe;EACxC,EAAE;EAC1B,MAAM,IAAI,KAAK;AACf,MAAI,OAAO,MAAM,YAAY,EAAE,MAAM,CAAE,QAAO,SAAS,EAAE,MAAM,CAAC;;AAElE,KAAI,YAAY,WAAW,OAAO,KAAK,YAAY,YAAY,KAAK,QAAQ,MAAM,CAChF,QAAO,SAAS,KAAK,QAAQ,MAAM,CAAC;AAEtC,MACG,QAAQ,SAAS,SAAS,IAAI,YAAY,UAAU,YAAY,SACjE,OAAO,KAAK,UAAU,YACtB,KAAK,MAAM,MAAM,CAEjB,QAAO,SAAS,KAAK,MAAM,MAAM,CAAC;AAEpC,KAAI,OAAO,KAAK,QAAQ,YAAY,KAAK,IAAI,MAAM,CAAE,QAAO,SAAS,KAAK,IAAI,MAAM,CAAC;;AAIvF,SAAS,SAAS,MAAsB;AACtC,KAAI,KAAK,UAAU,eAAgB,QAAO;AAC1C,QAAO,GAAG,KAAK,MAAM,GAAG,iBAAiB,EAAE,CAAC"}

package/dist/src/agent/workflow/subagent-runner.js

@@ -25,6 +25,7 @@ var DelegateSubagentRunner = class {
 			return null;
 		}
 		const fullPrompt = buildPrompt(prompt, opts, wantStructured);
+		const streamMode = resolveSubagentStreamMode(this.deps.getConfig);
 		const handle = createDelegateChildHandle({
 			workspace: this.deps.workspace,
 			goal: fullPrompt,
@@ -41,7 +42,13 @@ var DelegateSubagentRunner = class {
 					schema: opts.schema,
 					capture
 				})];
-			}
+			},
+			progressHooks: opts.onProgress && streamMode !== "off" ? {
+				mode: streamMode === "full" ? "full" : "steps",
+				onProgress: (event) => {
+					opts.onProgress?.(mapChildProgressEvent(event));
+				}
+			} : void 0
 		});
 		const onAbort = () => handle.abort();
 		opts.signal?.addEventListener("abort", onAbort, { once: true });
@@ -98,6 +105,44 @@ function safeResolveDefaultModel(get) {
 		return null;
 	}
 }
+function resolveSubagentStreamMode(getConfig) {
+	const mode = getConfig()?.agents?.defaults?.workflow?.subagentStream;
+	if (mode === "off" || mode === "steps" || mode === "full") return mode;
+	return "steps";
+}
+function mapChildProgressEvent(event) {
+	switch (event.type) {
+		case "tool_start": return {
+			type: "tool_start",
+			toolCallId: event.toolCallId ?? "",
+			toolName: event.toolName ?? "tool",
+			args: event.args ?? {}
+		};
+		case "tool_end": return {
+			type: "tool_end",
+			toolCallId: event.toolCallId ?? "",
+			toolName: event.toolName ?? "tool",
+			isError: Boolean(event.isError)
+		};
+		case "iteration": return {
+			type: "iteration",
+			count: event.count ?? 0,
+			max: event.max ?? 0
+		};
+		case "text_delta": return {
+			type: "text_delta",
+			delta: event.delta ?? ""
+		};
+		case "thinking_delta": return {
+			type: "thinking_delta",
+			delta: event.delta ?? ""
+		};
+		default: return {
+			type: "text_delta",
+			delta: ""
+		};
+	}
+}
 //#endregion
 export { DelegateSubagentRunner };