@xopcai/xopc 0.0.142 → 0.0.144

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

@@ -1,200 +1,204 @@
 import { init_paths_state, resolveStateDir } from "../../config/paths-state.js";
+import { buildWorkflowDefinition } from "../../workflows/domain/definition-utils.js";
+import { validateWorkflowGraph } from "../../workflows/domain/validation.js";
 import { BUILTIN_WORKFLOWS } from "./builtins/index.js";
-import { parseWorkflowScript } from "./parser.js";
 import { join } from "node:path";
-import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { randomUUID } from "node:crypto";
 //#region src/agent/workflow/catalog.ts
-/**
-* Catalog for named workflows.
-*
-* Resolution order (built-ins are starting points, user workflows win):
-*   1. `~/.xopc/workflows/<name>/workflow.js` (+ optional `manifest.json`)
-*   2. `~/.xopc/workflows/<name>.js` (or `<name>.workflow.js`)
-*   3. {@link BUILTIN_WORKFLOWS}
-*
-* The user dir is discovered via {@link resolveStateDir}, so `XOPC_STATE_DIR`
-* overrides apply automatically (matches how skills / extensions are wired).
-*
-* Listing is filesystem-cheap (single `readdir`) and runs synchronously — the
-* `/workflows` slash command is interactive and should return immediately.
-*
-* Validation: on load we re-parse the script to make sure `meta.name` matches
-* the filename. This prevents copy-pasted scripts from being silently
-* mis-addressed when invoked by name.
-*/
 init_paths_state();
 const NAME_RE = /^[a-z][a-z0-9_-]*$/;
 function createWorkflowCatalog(opts = {}) {
 	const userDir = opts.userDir ?? defaultUserDir();
+	const loadUser = (name) => {
+		const path = join(userDir, `${name}.json`);
+		if (!existsSync(path)) return null;
+		const parsed = JSON.parse(readFileSync(path, "utf-8"));
+		assertStoredDefinition(parsed, name, path);
+		return parsed;
+	};
 	const list = () => {
-		const entries = /* @__PURE__ */ new Map();
-		for (const b of BUILTIN_WORKFLOWS) {
-			const meta = safeMeta(b.script);
-			entries.set(b.name, {
-				name: b.name,
-				source: "builtin",
-				path: null,
-				description: meta?.description ?? "(unparseable)",
-				whenToUse: meta?.whenToUse,
-				tags: meta?.tags,
-				estimatedAgents: meta?.estimatedAgents
-			});
-		}
-		for (const entry of safeListUserEntries(userDir)) {
-			const meta = safeMeta(readScript(entry.path));
-			const manifest = readManifest(entry.manifestPath);
-			entries.set(entry.name, {
-				name: entry.name,
-				source: "user",
-				path: entry.path,
-				description: manifest?.description ?? meta?.description ?? "(unparseable)",
-				title: manifest?.title,
-				version: manifest?.version,
-				whenToUse: manifest?.whenToUse ?? meta?.whenToUse,
-				tags: manifest?.tags ?? meta?.tags,
-				estimatedAgents: meta?.estimatedAgents
+		const definitions = /* @__PURE__ */ new Map();
+		for (const definition of BUILTIN_WORKFLOWS) definitions.set(definition.name, {
+			definition,
+			path: null
+		});
+		for (const name of listUserNames(userDir)) try {
+			const definition = loadUser(name);
+			if (definition) definitions.set(name, {
+				definition,
+				path: join(userDir, `${name}.json`)
 			});
-		}
-		return [...entries.values()].sort((a, b) => a.name.localeCompare(b.name));
+		} catch {}
+		return [...definitions.values()].map(({ definition, path }) => toCatalogEntry(definition, path)).sort((left, right) => left.name.localeCompare(right.name));
 	};
 	const load = (name) => {
 		requireValidName(name);
-		const userEntry = findUserEntry(userDir, name);
-		if (userEntry) {
-			const script = readScript(userEntry.path);
-			const { meta } = parseWorkflowScript(script);
-			ensureMetaNameMatches(meta, name, userEntry.path);
-			return {
-				name,
-				source: "user",
-				script,
-				meta,
-				path: userEntry.path,
-				manifest: readManifest(userEntry.manifestPath)
-			};
-		}
-		const builtin = BUILTIN_WORKFLOWS.find((b) => b.name === name);
-		if (builtin) {
-			const { meta } = parseWorkflowScript(builtin.script);
-			ensureMetaNameMatches(meta, name, "<builtin>");
-			return {
-				name,
-				source: "builtin",
-				script: builtin.script,
-				meta,
-				path: null
-			};
-		}
-		throw new Error(`workflow not found: ${name}. Drop a script at ${join(userDir, `${name}.js`)} or pick one of: ${list().map((e) => e.name).join(", ")}`);
+		const user = loadUser(name);
+		if (user) return structuredClone(user);
+		const builtin = BUILTIN_WORKFLOWS.find((definition) => definition.name === name);
+		if (builtin) return structuredClone(builtin);
+		throw new Error(`workflow not found: ${name}`);
 	};
-	const save = (name, script) => {
+	const save = (input) => {
+		const name = input.name.trim();
 		requireValidName(name);
-		const { meta } = parseWorkflowScript(script);
-		if (meta.name !== name) throw new Error(`meta.name "${meta.name}" does not match save name "${name}". Adjust one to match the other.`);
+		const validation = validateWorkflowGraph(input.graph);
+		if (!validation.valid) throw new Error(validation.errors.map((issue) => issue.message).join(" "));
+		const existing = loadUser(name);
+		const builtin = BUILTIN_WORKFLOWS.find((definition) => definition.name === name);
+		if (input.intent === "create" && (existing || builtin)) throw new WorkflowNameConflictError(name, existing?.revision ?? builtin?.revision ?? 0);
+		if (input.expectedRevision !== void 0 && input.expectedRevision !== (existing?.revision ?? 0)) throw new WorkflowRevisionConflictError(existing?.revision ?? 0);
+		const definition = buildWorkflowDefinition({
+			name,
+			source: "user",
+			graph: input.graph,
+			manifest: input.manifest,
+			revision: (existing?.revision ?? 0) + 1,
+			createdAtMs: existing?.metadata.createdAtMs
+		});
 		if (!existsSync(userDir)) mkdirSync(userDir, { recursive: true });
-		const path = join(userDir, `${name}.js`);
-		writeFileSync(path, normalizeNewlines(script), "utf-8");
-		return { path };
+		const path = join(userDir, `${name}.json`);
+		const revisionsDir = join(userDir, ".revisions", name);
+		mkdirSync(revisionsDir, { recursive: true });
+		writeJsonAtomic(join(revisionsDir, `${definition.revision}.json`), definition);
+		writeJsonAtomic(path, definition);
+		return {
+			path,
+			definition
+		};
+	};
+	const listRevisions = (name) => {
+		requireValidName(name);
+		const dir = join(userDir, ".revisions", name);
+		if (!existsSync(dir)) return [];
+		return readdirSync(dir).filter((file) => /^\d+\.json$/.test(file)).map((file) => {
+			try {
+				const definition = JSON.parse(readFileSync(join(dir, file), "utf-8"));
+				assertStoredDefinition(definition, name, join(dir, file));
+				return {
+					revision: definition.revision,
+					title: definition.title,
+					contentHash: definition.contentHash,
+					createdAtMs: definition.metadata.updatedAtMs
+				};
+			} catch {
+				return null;
+			}
+		}).filter((item) => item !== null).sort((left, right) => right.revision - left.revision);
+	};
+	const loadRevision = (name, revision) => {
+		requireValidName(name);
+		if (!Number.isSafeInteger(revision) || revision < 1) throw new Error("invalid workflow revision");
+		const path = join(userDir, ".revisions", name, `${revision}.json`);
+		if (!existsSync(path)) throw new Error(`workflow revision not found: ${name}@${revision}`);
+		const definition = JSON.parse(readFileSync(path, "utf-8"));
+		assertStoredDefinition(definition, name, path);
+		return structuredClone(definition);
+	};
+	const restore = (name, revision, expectedRevision) => {
+		const selected = loadRevision(name, revision);
+		return save({
+			name,
+			graph: selected.graph,
+			manifest: definitionToManifest(selected),
+			expectedRevision
+		});
 	};
 	const remove = (name) => {
 		requireValidName(name);
-		const userEntry = findUserEntry(userDir, name);
-		if (!userEntry) return false;
-		unlinkSync(userEntry.path);
+		const path = join(userDir, `${name}.json`);
+		if (!existsSync(path)) return false;
+		unlinkSync(path);
+		const revisionsDir = join(userDir, ".revisions", name);
+		if (existsSync(revisionsDir)) rmSync(revisionsDir, {
+			recursive: true,
+			force: true
+		});
 		return true;
 	};
 	return {
 		list,
 		load,
 		save,
+		listRevisions,
+		loadRevision,
+		restore,
 		remove,
 		userDir
 	};
 }
+var WorkflowRevisionConflictError = class extends Error {
+	constructor(currentRevision) {
+		super(`workflow revision conflict; current revision is ${currentRevision}`);
+		this.currentRevision = currentRevision;
+		this.name = "WorkflowRevisionConflictError";
+	}
+};
+var WorkflowNameConflictError = class extends Error {
+	constructor(workflowName, currentRevision) {
+		super(`workflow name already exists: ${workflowName}`);
+		this.workflowName = workflowName;
+		this.currentRevision = currentRevision;
+		this.name = "WorkflowNameConflictError";
+	}
+};
 function defaultUserDir() {
 	return join(resolveStateDir(), "workflows");
 }
-function safeListUserEntries(dir) {
+function listUserNames(dir) {
 	try {
-		if (!existsSync(dir)) return [];
-		if (!statSync(dir).isDirectory()) return [];
-		const entries = [];
-		for (const file of readdirSync(dir)) {
-			const full = join(dir, file);
-			if (statSync(full).isDirectory()) {
-				const workflowPath = join(full, "workflow.js");
-				if (existsSync(workflowPath) && isValidName(file)) entries.push({
-					name: file,
-					path: workflowPath,
-					manifestPath: join(full, "manifest.json")
-				});
-				continue;
-			}
-			if (!/\.(js|workflow\.js)$/i.test(file)) continue;
-			const name = stripExt(file);
-			if (!isValidName(name)) continue;
-			entries.push({
-				name,
-				path: full
-			});
-		}
-		return entries;
+		if (!existsSync(dir) || !statSync(dir).isDirectory()) return [];
+		return readdirSync(dir).filter((file) => file.endsWith(".json")).map((file) => file.slice(0, -5)).filter((name) => NAME_RE.test(name));
 	} catch {
 		return [];
 	}
 }
-function findUserEntry(dir, name) {
-	const dirWorkflowPath = join(dir, name, "workflow.js");
-	if (existsSync(dirWorkflowPath)) return {
-		name,
-		path: dirWorkflowPath,
-		manifestPath: join(dir, name, "manifest.json")
-	};
-	for (const candidate of [`${name}.js`, `${name}.workflow.js`]) {
-		const full = join(dir, candidate);
-		if (existsSync(full)) return {
-			name,
-			path: full
-		};
-	}
-	return null;
+function assertStoredDefinition(value, name, path) {
+	if (!value || typeof value !== "object" || value.name !== name || value.metadata?.source !== "user") throw new Error(`invalid workflow definition: ${path}`);
+	if (!validateWorkflowGraph(value.graph).valid) throw new Error(`invalid workflow graph: ${path}`);
 }
-function readScript(path) {
-	return readFileSync(path, "utf-8");
-}
-function readManifest(path) {
-	if (!path || !existsSync(path)) return void 0;
-	try {
-		const value = JSON.parse(readFileSync(path, "utf-8"));
-		if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
-		return value;
-	} catch {
-		return;
-	}
-}
-function safeMeta(script) {
-	try {
-		return parseWorkflowScript(script).meta;
-	} catch {
-		return null;
-	}
-}
-function stripExt(filename) {
-	return filename.replace(/\.workflow\.js$/i, "").replace(/\.js$/i, "");
-}
-function isValidName(name) {
-	return NAME_RE.test(name);
+function toCatalogEntry(definition, path) {
+	return {
+		name: definition.name,
+		source: definition.metadata.source,
+		path,
+		description: definition.description,
+		title: definition.title,
+		version: definition.version,
+		revision: definition.revision,
+		whenToUse: definition.metadata.whenToUse,
+		tags: definition.metadata.tags,
+		estimatedAgents: definition.metadata.estimatedAgents
+	};
 }
 function requireValidName(name) {
-	if (!isValidName(name)) throw new Error(`invalid workflow name "${name}". Use lowercase snake_case, e.g. "audit_repo".`);
+	if (!NAME_RE.test(name)) throw new Error(`invalid workflow name "${name}"; use lowercase letters, numbers, underscores, or hyphens`);
 }
-function ensureMetaNameMatches(meta, name, locator) {
-	if (meta.name !== name) throw new Error(`workflow ${locator}: meta.name "${meta.name}" disagrees with addressable name "${name}". Rename the file or the meta.name to match.`);
+function writeJsonAtomic(path, value) {
+	const temporaryPath = `${path}.${randomUUID()}.tmp`;
+	writeFileSync(temporaryPath, `${JSON.stringify(value, null, 2)}\n`, "utf-8");
+	renameSync(temporaryPath, path);
 }
-function normalizeNewlines(s) {
-	return s.endsWith("\n") ? s : `${s}\n`;
+function definitionToManifest(definition) {
+	return {
+		title: definition.title,
+		description: definition.description,
+		version: definition.version,
+		inputSchema: definition.inputSchema,
+		outputSchema: definition.outputSchema,
+		defaults: definition.defaults,
+		tags: definition.metadata.tags,
+		whenToUse: definition.metadata.whenToUse,
+		estimatedAgents: definition.metadata.estimatedAgents,
+		examplePrompts: definition.metadata.examplePrompts,
+		i18n: definition.metadata.i18n,
+		permissions: definition.permissions,
+		resources: definition.resources,
+		connectors: definition.connectors
+	};
 }
 //#endregion
-export { createWorkflowCatalog, defaultUserDir };
+export { WorkflowNameConflictError, WorkflowRevisionConflictError, createWorkflowCatalog, defaultUserDir };
 
 //# sourceMappingURL=catalog.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","names":[],"sources":["../../../../src/agent/workflow/catalog.ts"],"sourcesContent":["/**\n * Catalog for named workflows.\n *\n * Resolution order (built-ins are starting points, user workflows win):\n *   1. `~/.xopc/workflows/<name>/workflow.js` (+ optional `manifest.json`)\n *   2. `~/.xopc/workflows/<name>.js` (or `<name>.workflow.js`)\n *   3. {@link BUILTIN_WORKFLOWS}\n *\n * The user dir is discovered via {@link resolveStateDir}, so `XOPC_STATE_DIR`\n * overrides apply automatically (matches how skills / extensions are wired).\n *\n * Listing is filesystem-cheap (single `readdir`) and runs synchronously — the\n * `/workflows` slash command is interactive and should return immediately.\n *\n * Validation: on load we re-parse the script to make sure `meta.name` matches\n * the filename. This prevents copy-pasted scripts from being silently\n * mis-addressed when invoked by name.\n */\n\nimport {\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  statSync,\n  unlinkSync,\n  writeFileSync,\n} from 'node:fs';\nimport { join } from 'node:path';\n\nimport type { WorkflowDefinitionManifest } from '../../workflows/domain/definition.js';\n\nimport { resolveStateDir } from '../../config/paths-state.js';\n\nimport { BUILTIN_WORKFLOWS } from './builtins/index.js';\nimport { parseWorkflowScript } from './parser.js';\nimport type { WorkflowMeta } from './types.js';\n\nexport type WorkflowSource = 'user' | 'builtin';\n\nexport interface CatalogEntry {\n  name: string;\n  source: WorkflowSource;\n  /** Absolute path for user entries; null for built-ins (in-memory). */\n  path: string | null;\n  description: string;\n  title?: string;\n  version?: string;\n  whenToUse?: string;\n  tags?: string[];\n  estimatedAgents?: { min: number; max: number };\n}\n\nexport interface LoadedWorkflow {\n  name: string;\n  source: WorkflowSource;\n  script: string;\n  meta: WorkflowMeta;\n  path: string | null;\n  manifest?: WorkflowDefinitionManifest;\n}\n\nexport interface WorkflowCatalog {\n  list(): CatalogEntry[];\n  /** Load a named workflow. Throws if missing or meta.name disagrees with filename. */\n  load(name: string): LoadedWorkflow;\n  /** Save a script as a user workflow. Throws if the script fails to parse. */\n  save(name: string, script: string): { path: string };\n  /** Remove a user workflow. No-op if absent. Built-ins are never removed. */\n  remove(name: string): boolean;\n  /** Absolute path to the user workflows directory (created lazily on save). */\n  userDir: string;\n}\n\nconst NAME_RE = /^[a-z][a-z0-9_-]*$/;\n\nexport function createWorkflowCatalog(opts: { userDir?: string } = {}): WorkflowCatalog {\n  const userDir = opts.userDir ?? defaultUserDir();\n\n  const list = (): CatalogEntry[] => {\n    const entries = new Map<string, CatalogEntry>();\n    for (const b of BUILTIN_WORKFLOWS) {\n      const meta = safeMeta(b.script);\n      entries.set(b.name, {\n        name: b.name,\n        source: 'builtin',\n        path: null,\n        description: meta?.description ?? '(unparseable)',\n        whenToUse: meta?.whenToUse,\n        tags: meta?.tags,\n        estimatedAgents: meta?.estimatedAgents,\n      });\n    }\n    for (const entry of safeListUserEntries(userDir)) {\n      const meta = safeMeta(readScript(entry.path));\n      const manifest = readManifest(entry.manifestPath);\n      // User wins on collision.\n      entries.set(entry.name, {\n        name: entry.name,\n        source: 'user',\n        path: entry.path,\n        description: manifest?.description ?? meta?.description ?? '(unparseable)',\n        title: manifest?.title,\n        version: manifest?.version,\n        whenToUse: manifest?.whenToUse ?? meta?.whenToUse,\n        tags: manifest?.tags ?? meta?.tags,\n        estimatedAgents: meta?.estimatedAgents,\n      });\n    }\n    return [...entries.values()].sort((a, b) => a.name.localeCompare(b.name));\n  };\n\n  const load = (name: string): LoadedWorkflow => {\n    requireValidName(name);\n    const userEntry = findUserEntry(userDir, name);\n    if (userEntry) {\n      const script = readScript(userEntry.path);\n      const { meta } = parseWorkflowScript(script);\n      ensureMetaNameMatches(meta, name, userEntry.path);\n      return {\n        name,\n        source: 'user',\n        script,\n        meta,\n        path: userEntry.path,\n        manifest: readManifest(userEntry.manifestPath),\n      };\n    }\n    const builtin = BUILTIN_WORKFLOWS.find((b) => b.name === name);\n    if (builtin) {\n      const { meta } = parseWorkflowScript(builtin.script);\n      ensureMetaNameMatches(meta, name, '<builtin>');\n      return { name, source: 'builtin', script: builtin.script, meta, path: null };\n    }\n    throw new Error(\n      `workflow not found: ${name}. Drop a script at ${join(userDir, `${name}.js`)} or pick one of: ${list()\n        .map((e) => e.name)\n        .join(', ')}`,\n    );\n  };\n\n  const save = (name: string, script: string): { path: string } => {\n    requireValidName(name);\n    const { meta } = parseWorkflowScript(script);\n    if (meta.name !== name) {\n      throw new Error(\n        `meta.name \"${meta.name}\" does not match save name \"${name}\". Adjust one to match the other.`,\n      );\n    }\n    if (!existsSync(userDir)) {\n      mkdirSync(userDir, { recursive: true });\n    }\n    const path = join(userDir, `${name}.js`);\n    writeFileSync(path, normalizeNewlines(script), 'utf-8');\n    return { path };\n  };\n\n  const remove = (name: string): boolean => {\n    requireValidName(name);\n    const userEntry = findUserEntry(userDir, name);\n    if (!userEntry) return false;\n    unlinkSync(userEntry.path);\n    return true;\n  };\n\n  return { list, load, save, remove, userDir };\n}\n\n// ---------------------------------------------------------------------------\n\nexport function defaultUserDir(): string {\n  return join(resolveStateDir(), 'workflows');\n}\n\ninterface UserWorkflowEntry {\n  name: string;\n  path: string;\n  manifestPath?: string;\n}\n\nfunction safeListUserEntries(dir: string): UserWorkflowEntry[] {\n  try {\n    if (!existsSync(dir)) return [];\n    const st = statSync(dir);\n    if (!st.isDirectory()) return [];\n    const entries: UserWorkflowEntry[] = [];\n    for (const file of readdirSync(dir)) {\n      const full = join(dir, file);\n      const fileStat = statSync(full);\n      if (fileStat.isDirectory()) {\n        const workflowPath = join(full, 'workflow.js');\n        if (existsSync(workflowPath) && isValidName(file)) {\n          entries.push({ name: file, path: workflowPath, manifestPath: join(full, 'manifest.json') });\n        }\n        continue;\n      }\n      if (!/\\.(js|workflow\\.js)$/i.test(file)) continue;\n      const name = stripExt(file);\n      if (!isValidName(name)) continue;\n      entries.push({ name, path: full });\n    }\n    return entries;\n  } catch {\n    return [];\n  }\n}\n\nfunction findUserEntry(dir: string, name: string): UserWorkflowEntry | null {\n  const dirWorkflowPath = join(dir, name, 'workflow.js');\n  if (existsSync(dirWorkflowPath)) {\n    return { name, path: dirWorkflowPath, manifestPath: join(dir, name, 'manifest.json') };\n  }\n  for (const candidate of [`${name}.js`, `${name}.workflow.js`]) {\n    const full = join(dir, candidate);\n    if (existsSync(full)) return { name, path: full };\n  }\n  return null;\n}\n\nfunction readScript(path: string): string {\n  return readFileSync(path, 'utf-8');\n}\n\nfunction readManifest(path: string | undefined): WorkflowDefinitionManifest | undefined {\n  if (!path || !existsSync(path)) return undefined;\n  try {\n    const value = JSON.parse(readFileSync(path, 'utf-8')) as WorkflowDefinitionManifest;\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return undefined;\n    return value;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction safeMeta(script: string): WorkflowMeta | null {\n  try {\n    return parseWorkflowScript(script).meta;\n  } catch {\n    return null;\n  }\n}\n\nfunction stripExt(filename: string): string {\n  return filename.replace(/\\.workflow\\.js$/i, '').replace(/\\.js$/i, '');\n}\n\nfunction isValidName(name: string): boolean {\n  return NAME_RE.test(name);\n}\n\nfunction requireValidName(name: string): void {\n  if (!isValidName(name)) {\n    throw new Error(`invalid workflow name \"${name}\". Use lowercase snake_case, e.g. \"audit_repo\".`);\n  }\n}\n\nfunction ensureMetaNameMatches(meta: WorkflowMeta, name: string, locator: string): void {\n  if (meta.name !== name) {\n    throw new Error(\n      `workflow ${locator}: meta.name \"${meta.name}\" disagrees with addressable name \"${name}\". ` +\n        'Rename the file or the meta.name to match.',\n    );\n  }\n}\n\nfunction normalizeNewlines(s: string): string {\n  return s.endsWith('\\n') ? s : `${s}\\n`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"catalog.js","names":[],"sources":["../../../../src/agent/workflow/catalog.ts"],"sourcesContent":["import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';\nimport { randomUUID } from 'node:crypto';\nimport { join } from 'node:path';\n\nimport type { WorkflowDefinition, WorkflowDefinitionManifest, WorkflowGraph } from '../../workflows/domain/definition.js';\nimport { buildWorkflowDefinition } from '../../workflows/domain/definition-utils.js';\nimport { validateWorkflowGraph } from '../../workflows/domain/validation.js';\nimport { resolveStateDir } from '../../config/paths-state.js';\n\nimport { BUILTIN_WORKFLOWS } from './builtins/index.js';\n\nexport type WorkflowSource = 'user' | 'builtin';\n\nexport interface CatalogEntry {\n  name: string;\n  source: WorkflowSource;\n  path: string | null;\n  description: string;\n  title: string;\n  version: string;\n  revision: number;\n  whenToUse?: string;\n  tags?: string[];\n  estimatedAgents?: { min: number; max: number };\n}\n\nexport interface SaveWorkflowInput {\n  name: string;\n  graph: WorkflowGraph;\n  manifest?: WorkflowDefinitionManifest;\n  expectedRevision?: number;\n  intent?: 'create' | 'update';\n}\n\nexport interface WorkflowRevisionSummary {\n  revision: number;\n  title: string;\n  contentHash?: string;\n  createdAtMs: number;\n}\n\nexport interface WorkflowCatalog {\n  list(): CatalogEntry[];\n  load(name: string): WorkflowDefinition;\n  save(input: SaveWorkflowInput): { path: string; definition: WorkflowDefinition };\n  listRevisions(name: string): WorkflowRevisionSummary[];\n  loadRevision(name: string, revision: number): WorkflowDefinition;\n  restore(name: string, revision: number, expectedRevision: number): { path: string; definition: WorkflowDefinition };\n  remove(name: string): boolean;\n  userDir: string;\n}\n\nconst NAME_RE = /^[a-z][a-z0-9_-]*$/;\n\nexport function createWorkflowCatalog(opts: { userDir?: string } = {}): WorkflowCatalog {\n  const userDir = opts.userDir ?? defaultUserDir();\n\n  const loadUser = (name: string): WorkflowDefinition | null => {\n    const path = join(userDir, `${name}.json`);\n    if (!existsSync(path)) return null;\n    const parsed = JSON.parse(readFileSync(path, 'utf-8')) as WorkflowDefinition;\n    assertStoredDefinition(parsed, name, path);\n    return parsed;\n  };\n\n  const list = (): CatalogEntry[] => {\n    const definitions = new Map<string, { definition: WorkflowDefinition; path: string | null }>();\n    for (const definition of BUILTIN_WORKFLOWS) definitions.set(definition.name, { definition, path: null });\n    for (const name of listUserNames(userDir)) {\n      try {\n        const definition = loadUser(name);\n        if (definition) definitions.set(name, { definition, path: join(userDir, `${name}.json`) });\n      } catch {\n        // Invalid files are not addressable workflows.\n      }\n    }\n    return [...definitions.values()]\n      .map(({ definition, path }) => toCatalogEntry(definition, path))\n      .sort((left, right) => left.name.localeCompare(right.name));\n  };\n\n  const load = (name: string): WorkflowDefinition => {\n    requireValidName(name);\n    const user = loadUser(name);\n    if (user) return structuredClone(user);\n    const builtin = BUILTIN_WORKFLOWS.find((definition) => definition.name === name);\n    if (builtin) return structuredClone(builtin);\n    throw new Error(`workflow not found: ${name}`);\n  };\n\n  const save = (input: SaveWorkflowInput): { path: string; definition: WorkflowDefinition } => {\n    const name = input.name.trim();\n    requireValidName(name);\n    const validation = validateWorkflowGraph(input.graph);\n    if (!validation.valid) throw new Error(validation.errors.map((issue) => issue.message).join(' '));\n    const existing = loadUser(name);\n    const builtin = BUILTIN_WORKFLOWS.find((definition) => definition.name === name);\n    if (input.intent === 'create' && (existing || builtin)) {\n      throw new WorkflowNameConflictError(name, existing?.revision ?? builtin?.revision ?? 0);\n    }\n    if (input.expectedRevision !== undefined && input.expectedRevision !== (existing?.revision ?? 0)) {\n      throw new WorkflowRevisionConflictError(existing?.revision ?? 0);\n    }\n    const definition = buildWorkflowDefinition({\n      name,\n      source: 'user',\n      graph: input.graph,\n      manifest: input.manifest,\n      revision: (existing?.revision ?? 0) + 1,\n      createdAtMs: existing?.metadata.createdAtMs,\n    });\n    if (!existsSync(userDir)) mkdirSync(userDir, { recursive: true });\n    const path = join(userDir, `${name}.json`);\n    const revisionsDir = join(userDir, '.revisions', name);\n    mkdirSync(revisionsDir, { recursive: true });\n    writeJsonAtomic(join(revisionsDir, `${definition.revision}.json`), definition);\n    writeJsonAtomic(path, definition);\n    return { path, definition };\n  };\n\n  const listRevisions = (name: string): WorkflowRevisionSummary[] => {\n    requireValidName(name);\n    const dir = join(userDir, '.revisions', name);\n    if (!existsSync(dir)) return [];\n    return readdirSync(dir)\n      .filter((file) => /^\\d+\\.json$/.test(file))\n      .map((file): WorkflowRevisionSummary | null => {\n        try {\n          const definition = JSON.parse(readFileSync(join(dir, file), 'utf-8')) as WorkflowDefinition;\n          assertStoredDefinition(definition, name, join(dir, file));\n          return { revision: definition.revision, title: definition.title, contentHash: definition.contentHash, createdAtMs: definition.metadata.updatedAtMs };\n        } catch {\n          return null;\n        }\n      })\n      .filter((item): item is WorkflowRevisionSummary => item !== null)\n      .sort((left, right) => right.revision - left.revision);\n  };\n\n  const loadRevision = (name: string, revision: number): WorkflowDefinition => {\n    requireValidName(name);\n    if (!Number.isSafeInteger(revision) || revision < 1) throw new Error('invalid workflow revision');\n    const path = join(userDir, '.revisions', name, `${revision}.json`);\n    if (!existsSync(path)) throw new Error(`workflow revision not found: ${name}@${revision}`);\n    const definition = JSON.parse(readFileSync(path, 'utf-8')) as WorkflowDefinition;\n    assertStoredDefinition(definition, name, path);\n    return structuredClone(definition);\n  };\n\n  const restore = (name: string, revision: number, expectedRevision: number) => {\n    const selected = loadRevision(name, revision);\n    return save({ name, graph: selected.graph, manifest: definitionToManifest(selected), expectedRevision });\n  };\n\n  const remove = (name: string): boolean => {\n    requireValidName(name);\n    const path = join(userDir, `${name}.json`);\n    if (!existsSync(path)) return false;\n    unlinkSync(path);\n    const revisionsDir = join(userDir, '.revisions', name);\n    if (existsSync(revisionsDir)) rmSync(revisionsDir, { recursive: true, force: true });\n    return true;\n  };\n\n  return { list, load, save, listRevisions, loadRevision, restore, remove, userDir };\n}\n\nexport class WorkflowRevisionConflictError extends Error {\n  constructor(readonly currentRevision: number) {\n    super(`workflow revision conflict; current revision is ${currentRevision}`);\n    this.name = 'WorkflowRevisionConflictError';\n  }\n}\n\nexport class WorkflowNameConflictError extends Error {\n  constructor(readonly workflowName: string, readonly currentRevision: number) {\n    super(`workflow name already exists: ${workflowName}`);\n    this.name = 'WorkflowNameConflictError';\n  }\n}\n\nexport function defaultUserDir(): string {\n  return join(resolveStateDir(), 'workflows');\n}\n\nfunction listUserNames(dir: string): string[] {\n  try {\n    if (!existsSync(dir) || !statSync(dir).isDirectory()) return [];\n    return readdirSync(dir)\n      .filter((file) => file.endsWith('.json'))\n      .map((file) => file.slice(0, -5))\n      .filter((name) => NAME_RE.test(name));\n  } catch {\n    return [];\n  }\n}\n\nfunction assertStoredDefinition(value: WorkflowDefinition, name: string, path: string): void {\n  if (!value || typeof value !== 'object' || value.name !== name || value.metadata?.source !== 'user') {\n    throw new Error(`invalid workflow definition: ${path}`);\n  }\n  const validation = validateWorkflowGraph(value.graph);\n  if (!validation.valid) throw new Error(`invalid workflow graph: ${path}`);\n}\n\nfunction toCatalogEntry(definition: WorkflowDefinition, path: string | null): CatalogEntry {\n  return {\n    name: definition.name,\n    source: definition.metadata.source,\n    path,\n    description: definition.description,\n    title: definition.title,\n    version: definition.version,\n    revision: definition.revision,\n    whenToUse: definition.metadata.whenToUse,\n    tags: definition.metadata.tags,\n    estimatedAgents: definition.metadata.estimatedAgents,\n  };\n}\n\nfunction requireValidName(name: string): void {\n  if (!NAME_RE.test(name)) throw new Error(`invalid workflow name \"${name}\"; use lowercase letters, numbers, underscores, or hyphens`);\n}\n\nfunction writeJsonAtomic(path: string, value: unknown): void {\n  const temporaryPath = `${path}.${randomUUID()}.tmp`;\n  writeFileSync(temporaryPath, `${JSON.stringify(value, null, 2)}\\n`, 'utf-8');\n  renameSync(temporaryPath, path);\n}\n\nfunction definitionToManifest(definition: WorkflowDefinition): WorkflowDefinitionManifest {\n  return {\n    title: definition.title,\n    description: definition.description,\n    version: definition.version,\n    inputSchema: definition.inputSchema,\n    outputSchema: definition.outputSchema,\n    defaults: definition.defaults,\n    tags: definition.metadata.tags,\n    whenToUse: definition.metadata.whenToUse,\n    estimatedAgents: definition.metadata.estimatedAgents,\n    examplePrompts: definition.metadata.examplePrompts,\n    i18n: definition.metadata.i18n,\n    permissions: definition.permissions,\n    resources: definition.resources,\n    connectors: definition.connectors,\n  };\n}\n"],"mappings":"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"}

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

@@ -1,12 +1,10 @@
 export { applySubagentProgress } from './agent-progress.js';
-export { BUILTIN_WORKFLOWS, type BuiltinWorkflow } from './builtins/index.js';
-export { createWorkflowCatalog, defaultUserDir, type CatalogEntry, type LoadedWorkflow, type WorkflowCatalog, type WorkflowSource, } from './catalog.js';
-export { getLastWorkflowMemory, _resetLastWorkflowMemoryForTests, type LastWorkflowEntry, type LastWorkflowMemory, } from './last-run-memory.js';
+export { BUILTIN_WORKFLOWS } from './builtins/index.js';
+export { createWorkflowCatalog, defaultUserDir, type CatalogEntry, type SaveWorkflowInput, type WorkflowCatalog, type WorkflowSource, } from './catalog.js';
 export type { ChannelProgressCapability, WorkflowProgressMode, WorkflowProgressPostInput, WorkflowProgressPostResult, } from './channel-capability.js';
-export { parseWorkflowScript, type ParsedWorkflow } from './parser.js';
 export { WorkflowProgressBroker, getWorkflowProgressBroker, _resetWorkflowProgressBrokerForTests, type BrokerListenerHandle, type SessionBusLike, } from './progress-broker.js';
-export { emptySnapshotFor, runWorkflow, type RunWorkflowDeps, } from './runtime.js';
+export { emptySnapshotFor } from './snapshot-empty.js';
 export { createWorkflowSnapshot, previewValue, recomputeCounts, renderWorkflowText, type RenderOptions, } from './snapshot.js';
 export { createStructuredOutputTool, STRUCTURED_OUTPUT_TOOL_NAME, type CreateStructuredOutputToolOptions, type StructuredOutputCapture, } from './structured-output-tool.js';
 export { DelegateSubagentRunner, type DelegateSubagentRunnerDeps, } from './subagent-runner.js';
-export type { AgentScriptOptions, JsonSchema, SubagentRunner, SubagentRunOptions, SubagentProgressEvent, WorkflowAgentSnapshot, WorkflowAgentStatus, WorkflowAgentStep, WorkflowMeta, WorkflowMetaEstimatedAgents, WorkflowMetaPhase, WorkflowRunOptions, WorkflowRunResult, WorkflowSnapshot, } from './types.js';
+export type { JsonSchema, SubagentRunner, SubagentRunOptions, SubagentProgressEvent, WorkflowAgentSnapshot, WorkflowAgentStatus, WorkflowAgentStep, WorkflowRunOptions, WorkflowRunResult, WorkflowSnapshot, WorkflowSnapshotDefinition, } from './types.js';

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

@@ -1,12 +1,9 @@
 import { emptySnapshotFor } from "./snapshot-empty.js";
 import { createWorkflowSnapshot, previewValue, recomputeCounts, renderWorkflowText } from "./snapshot.js";
-import { applySubagentProgress } from "./agent-progress.js";
 import { BUILTIN_WORKFLOWS } from "./builtins/index.js";
-import { parseWorkflowScript } from "./parser.js";
 import { createWorkflowCatalog, defaultUserDir } from "./catalog.js";
-import { _resetLastWorkflowMemoryForTests, getLastWorkflowMemory } from "./last-run-memory.js";
+import { applySubagentProgress } from "./agent-progress.js";
 import { WorkflowProgressBroker, _resetWorkflowProgressBrokerForTests, getWorkflowProgressBroker } from "./progress-broker.js";
-import { runWorkflow } from "./runtime.js";
 import { STRUCTURED_OUTPUT_TOOL_NAME, createStructuredOutputTool } from "./structured-output-tool.js";
 import { DelegateSubagentRunner } from "./subagent-runner.js";
-export { BUILTIN_WORKFLOWS, DelegateSubagentRunner, STRUCTURED_OUTPUT_TOOL_NAME, WorkflowProgressBroker, _resetLastWorkflowMemoryForTests, _resetWorkflowProgressBrokerForTests, applySubagentProgress, createStructuredOutputTool, createWorkflowCatalog, createWorkflowSnapshot, defaultUserDir, emptySnapshotFor, getLastWorkflowMemory, getWorkflowProgressBroker, parseWorkflowScript, previewValue, recomputeCounts, renderWorkflowText, runWorkflow };
+export { BUILTIN_WORKFLOWS, DelegateSubagentRunner, STRUCTURED_OUTPUT_TOOL_NAME, WorkflowProgressBroker, _resetWorkflowProgressBrokerForTests, applySubagentProgress, createStructuredOutputTool, createWorkflowCatalog, createWorkflowSnapshot, defaultUserDir, emptySnapshotFor, getWorkflowProgressBroker, previewValue, recomputeCounts, renderWorkflowText };

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

@@ -6,8 +6,8 @@
  * a text rendering through `onUpdate` — keeping TUI / Gateway / IM consumers in
  * lock-step from a single source of truth.
  */
-import type { WorkflowMeta, WorkflowSnapshot } from './types.js';
-export declare function createWorkflowSnapshot(meta: WorkflowMeta): WorkflowSnapshot;
+import type { WorkflowSnapshotDefinition, WorkflowSnapshot } from './types.js';
+export declare function createWorkflowSnapshot(definition: WorkflowSnapshotDefinition): WorkflowSnapshot;
 export declare function recomputeCounts(snapshot: WorkflowSnapshot): void;
 export interface RenderOptions {
     maxAgentsPerPhase?: number;

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

@@ -1,7 +1,7 @@
 import { emptySnapshotFor } from "./snapshot-empty.js";
 //#region src/agent/workflow/snapshot.ts
-function createWorkflowSnapshot(meta) {
-	return emptySnapshotFor(meta.name, meta.description, meta.phases?.map((p) => p.title));
+function createWorkflowSnapshot(definition) {
+	return emptySnapshotFor(definition.name, definition.description, definition.phases?.map((phase) => phase.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';\nimport { emptySnapshotFor } from './snapshot-empty.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 type WorkflowPanelStatus =\n  | 'queued'\n  | 'running'\n  | 'succeeded'\n  | 'failed'\n  | 'cancelled'\n  | 'timeout'\n  | string;\n\nexport interface WorkflowPanelOptions {\n  status?: WorkflowPanelStatus;\n  maxActiveAgents?: number;\n  maxRecentAgents?: number;\n  maxErrors?: number;\n  nowMs?: number;\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\nexport function renderWorkflowPanel(\n  snapshot: WorkflowSnapshot,\n  options: WorkflowPanelOptions = {},\n): string {\n  const status = options.status ?? inferPanelStatus(snapshot);\n  const activeAgents = snapshot.agents.filter((agent) => agent.status === 'running');\n  const queuedAgents = snapshot.agents.filter((agent) => agent.status === 'queued');\n  const activeLimit = options.maxActiveAgents ?? 4;\n  const recentLimit = options.maxRecentAgents ?? 4;\n  const durationText = formatDuration(resolveElapsedMs(snapshot, options.nowMs));\n  const counts = formatRunCounts(snapshot);\n\n  const lines = [\n    `◆ ${snapshot.name} ${statusText(status)} ${counts}${durationText ? ` ${durationText}` : ''}`,\n  ];\n\n  const phaseLines = renderPanelPhaseLines(snapshot);\n  if (phaseLines.length > 0) {\n    lines.push('', 'Phase', ...phaseLines);\n  }\n\n  const visibleActive = activeAgents.length > 0 ? activeAgents : queuedAgents;\n  if (visibleActive.length > 0) {\n    lines.push('', activeAgents.length > 0 ? 'Active' : 'Queued');\n    for (const agent of visibleActive.slice(0, activeLimit)) {\n      lines.push(...renderActiveAgentLines(agent));\n    }\n    if (visibleActive.length > activeLimit) {\n      lines.push(`  … ${visibleActive.length - activeLimit} more`);\n    }\n  }\n\n  const recent = recentCompletedAgents(snapshot).slice(0, recentLimit);\n  if (recent.length > 0) {\n    lines.push('', 'Recent');\n    for (const agent of recent) {\n      lines.push(renderRecentAgentLine(agent));\n    }\n  }\n\n  const errors = snapshot.agents.filter((agent) => agent.status === 'error' || agent.error);\n  if (errors.length > 0) {\n    lines.push('', 'Errors');\n    for (const agent of errors.slice(0, options.maxErrors ?? 3)) {\n      lines.push(\n        `  ✗ #${agent.id} ${shorten(agent.label, 28)}${\n          agent.error ? `: ${shorten(agent.error, 96)}` : ''\n        }`,\n      );\n    }\n    if (errors.length > (options.maxErrors ?? 3)) {\n      lines.push(`  … ${errors.length - (options.maxErrors ?? 3)} more`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nexport function renderWorkflowFinalSummary(\n  snapshot: WorkflowSnapshot,\n  options: WorkflowPanelOptions = {},\n): string {\n  const status = options.status ?? inferPanelStatus(snapshot);\n  const durationText = formatDuration(resolveElapsedMs(snapshot, options.nowMs));\n  const lines = [\n    `◆ ${snapshot.name} ${statusText(status)} ${formatRunCounts(snapshot)}${durationText ? ` ${durationText}` : ''}`,\n  ];\n\n  const result = previewValue(snapshot.result, 280);\n  if (result) {\n    lines.push('', 'Result', `  ${result}`);\n  } else {\n    const fallback = recentCompletedAgents(snapshot)\n      .map((agent) => agent.resultPreview)\n      .find((value): value is string => Boolean(value));\n    if (fallback) {\n      lines.push('', 'Result', `  ${shorten(fallback, 280)}`);\n    }\n  }\n\n  const errors = snapshot.agents.filter((agent) => agent.status === 'error' || agent.error);\n  if (errors.length > 0) {\n    lines.push('', 'Errors');\n    for (const agent of errors.slice(0, options.maxErrors ?? 5)) {\n      lines.push(\n        `  ✗ #${agent.id} ${shorten(agent.label, 32)}${\n          agent.error ? `: ${shorten(agent.error, 120)}` : ''\n        }`,\n      );\n    }\n  }\n\n  const recent = recentCompletedAgents(snapshot).slice(0, options.maxRecentAgents ?? 5);\n  if (recent.length > 0) {\n    lines.push('', 'Completed');\n    for (const agent of recent) {\n      lines.push(renderRecentAgentLine(agent));\n    }\n  }\n\n  return lines.join('\\n');\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 statusText(status: WorkflowPanelStatus): string {\n  switch (status) {\n    case 'queued':\n      return 'queued';\n    case 'running':\n      return 'running';\n    case 'succeeded':\n      return '✓ completed';\n    case 'failed':\n      return '✗ failed';\n    case 'cancelled':\n      return 'cancelled';\n    case 'timeout':\n      return 'timeout';\n    default:\n      return String(status || 'running');\n  }\n}\n\nfunction inferPanelStatus(snapshot: WorkflowSnapshot): WorkflowPanelStatus {\n  if (snapshot.errorCount > 0) return 'failed';\n  if (snapshot.runningCount > 0) return 'running';\n  if (snapshot.doneCount + snapshot.skippedCount >= snapshot.agentCount && snapshot.agentCount > 0) {\n    return 'succeeded';\n  }\n  return 'queued';\n}\n\nfunction formatRunCounts(snapshot: WorkflowSnapshot): string {\n  const parts = [`${snapshot.doneCount}/${snapshot.agentCount} done`];\n  if (snapshot.runningCount > 0) parts.push(`${snapshot.runningCount} running`);\n  if (snapshot.errorCount > 0) parts.push(`${snapshot.errorCount} errors`);\n  if (snapshot.skippedCount > 0) parts.push(`${snapshot.skippedCount} skipped`);\n  return parts.join(' · ');\n}\n\nfunction resolveElapsedMs(snapshot: WorkflowSnapshot, nowMs = Date.now()): number | undefined {\n  if (snapshot.durationMs != null) return snapshot.durationMs;\n  const starts = snapshot.agents\n    .map((agent) => agent.startedAtMs)\n    .filter((value): value is number => typeof value === 'number' && Number.isFinite(value));\n  if (starts.length === 0) return undefined;\n  return Math.max(0, nowMs - Math.min(...starts));\n}\n\nfunction formatDuration(ms: number | undefined): string {\n  if (ms == null || !Number.isFinite(ms)) return '';\n  const totalSeconds = Math.max(0, Math.floor(ms / 1000));\n  const minutes = Math.floor(totalSeconds / 60);\n  const seconds = totalSeconds % 60;\n  if (minutes < 60) return `${minutes}:${String(seconds).padStart(2, '0')}`;\n  const hours = Math.floor(minutes / 60);\n  const restMinutes = minutes % 60;\n  return `${hours}:${String(restMinutes).padStart(2, '0')}:${String(seconds).padStart(2, '0')}`;\n}\n\nfunction renderPanelPhaseLines(snapshot: WorkflowSnapshot): string[] {\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 out: string[] = [];\n  for (const phase of phaseNames) {\n    const agents = snapshot.agents.filter((agent) => agent.phase === phase);\n    const counts = countAgents(agents);\n    const complete = agents.length > 0 && counts.done + counts.error + counts.skipped === agents.length;\n    const marker =\n      counts.running > 0 || (!complete && snapshot.currentPhase === phase)\n        ? '▶'\n        : complete\n          ? '✓'\n          : '○';\n    const tail = [\n      counts.running > 0 ? `${counts.running} running` : '',\n      counts.error > 0 ? `${counts.error} errors` : '',\n      counts.skipped > 0 ? `${counts.skipped} skipped` : '',\n    ].filter(Boolean).join(' · ');\n    out.push(`  ${marker} ${phase} ${counts.done}/${agents.length}${tail ? ` · ${tail}` : ''}`);\n  }\n  return out;\n}\n\nfunction renderActiveAgentLines(agent: WorkflowAgentSnapshot): string[] {\n  const step = agent.currentStep || latestStepSummary(agent);\n  const iteration =\n    agent.iteration != null && agent.maxIterations != null\n      ? ` [${agent.iteration}/${agent.maxIterations}]`\n      : '';\n  const head = `  ${agent.status === 'running' ? '●' : '○'} #${agent.id} ${shorten(agent.label, 32)}${iteration}`;\n  return step ? [head, `     ${shorten(step, 96)}`] : [head];\n}\n\nfunction renderRecentAgentLine(agent: WorkflowAgentSnapshot): string {\n  const preview = agent.error || agent.resultPreview || latestStepResult(agent);\n  return `  ${statusIcon(agent.status)} #${agent.id} ${shorten(agent.label, 32)}${\n    preview ? ` — ${shorten(preview, 96)}` : ''\n  }`;\n}\n\nfunction recentCompletedAgents(snapshot: WorkflowSnapshot): WorkflowAgentSnapshot[] {\n  return [...snapshot.agents]\n    .filter((agent) => agent.status === 'done' || agent.status === 'error' || agent.status === 'skipped')\n    .reverse();\n}\n\nfunction latestStepSummary(agent: WorkflowAgentSnapshot): string {\n  const step =\n    [...(agent.steps ?? [])].reverse().find((entry) => entry.status === 'running') ??\n    agent.steps?.[agent.steps.length - 1];\n  if (!step) return '';\n  return step.detail ? `${step.label}: ${step.detail}` : step.label;\n}\n\nfunction latestStepResult(agent: WorkflowAgentSnapshot): string {\n  const step = [...(agent.steps ?? [])].reverse().find((entry) => entry.resultPreview || entry.error);\n  return step?.error || step?.resultPreview || '';\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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"}
+{"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  WorkflowSnapshotDefinition,\n  WorkflowSnapshot,\n} from './types.js';\nimport { emptySnapshotFor } from './snapshot-empty.js';\n\nexport function createWorkflowSnapshot(definition: WorkflowSnapshotDefinition): WorkflowSnapshot {\n  return emptySnapshotFor(\n    definition.name,\n    definition.description,\n    definition.phases?.map((phase) => phase.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 type WorkflowPanelStatus =\n  | 'queued'\n  | 'running'\n  | 'succeeded'\n  | 'failed'\n  | 'cancelled'\n  | 'timeout'\n  | string;\n\nexport interface WorkflowPanelOptions {\n  status?: WorkflowPanelStatus;\n  maxActiveAgents?: number;\n  maxRecentAgents?: number;\n  maxErrors?: number;\n  nowMs?: number;\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\nexport function renderWorkflowPanel(\n  snapshot: WorkflowSnapshot,\n  options: WorkflowPanelOptions = {},\n): string {\n  const status = options.status ?? inferPanelStatus(snapshot);\n  const activeAgents = snapshot.agents.filter((agent) => agent.status === 'running');\n  const queuedAgents = snapshot.agents.filter((agent) => agent.status === 'queued');\n  const activeLimit = options.maxActiveAgents ?? 4;\n  const recentLimit = options.maxRecentAgents ?? 4;\n  const durationText = formatDuration(resolveElapsedMs(snapshot, options.nowMs));\n  const counts = formatRunCounts(snapshot);\n\n  const lines = [\n    `◆ ${snapshot.name} ${statusText(status)} ${counts}${durationText ? ` ${durationText}` : ''}`,\n  ];\n\n  const phaseLines = renderPanelPhaseLines(snapshot);\n  if (phaseLines.length > 0) {\n    lines.push('', 'Phase', ...phaseLines);\n  }\n\n  const visibleActive = activeAgents.length > 0 ? activeAgents : queuedAgents;\n  if (visibleActive.length > 0) {\n    lines.push('', activeAgents.length > 0 ? 'Active' : 'Queued');\n    for (const agent of visibleActive.slice(0, activeLimit)) {\n      lines.push(...renderActiveAgentLines(agent));\n    }\n    if (visibleActive.length > activeLimit) {\n      lines.push(`  … ${visibleActive.length - activeLimit} more`);\n    }\n  }\n\n  const recent = recentCompletedAgents(snapshot).slice(0, recentLimit);\n  if (recent.length > 0) {\n    lines.push('', 'Recent');\n    for (const agent of recent) {\n      lines.push(renderRecentAgentLine(agent));\n    }\n  }\n\n  const errors = snapshot.agents.filter((agent) => agent.status === 'error' || agent.error);\n  if (errors.length > 0) {\n    lines.push('', 'Errors');\n    for (const agent of errors.slice(0, options.maxErrors ?? 3)) {\n      lines.push(\n        `  ✗ #${agent.id} ${shorten(agent.label, 28)}${\n          agent.error ? `: ${shorten(agent.error, 96)}` : ''\n        }`,\n      );\n    }\n    if (errors.length > (options.maxErrors ?? 3)) {\n      lines.push(`  … ${errors.length - (options.maxErrors ?? 3)} more`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nexport function renderWorkflowFinalSummary(\n  snapshot: WorkflowSnapshot,\n  options: WorkflowPanelOptions = {},\n): string {\n  const status = options.status ?? inferPanelStatus(snapshot);\n  const durationText = formatDuration(resolveElapsedMs(snapshot, options.nowMs));\n  const lines = [\n    `◆ ${snapshot.name} ${statusText(status)} ${formatRunCounts(snapshot)}${durationText ? ` ${durationText}` : ''}`,\n  ];\n\n  const result = previewValue(snapshot.result, 280);\n  if (result) {\n    lines.push('', 'Result', `  ${result}`);\n  } else {\n    const fallback = recentCompletedAgents(snapshot)\n      .map((agent) => agent.resultPreview)\n      .find((value): value is string => Boolean(value));\n    if (fallback) {\n      lines.push('', 'Result', `  ${shorten(fallback, 280)}`);\n    }\n  }\n\n  const errors = snapshot.agents.filter((agent) => agent.status === 'error' || agent.error);\n  if (errors.length > 0) {\n    lines.push('', 'Errors');\n    for (const agent of errors.slice(0, options.maxErrors ?? 5)) {\n      lines.push(\n        `  ✗ #${agent.id} ${shorten(agent.label, 32)}${\n          agent.error ? `: ${shorten(agent.error, 120)}` : ''\n        }`,\n      );\n    }\n  }\n\n  const recent = recentCompletedAgents(snapshot).slice(0, options.maxRecentAgents ?? 5);\n  if (recent.length > 0) {\n    lines.push('', 'Completed');\n    for (const agent of recent) {\n      lines.push(renderRecentAgentLine(agent));\n    }\n  }\n\n  return lines.join('\\n');\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 statusText(status: WorkflowPanelStatus): string {\n  switch (status) {\n    case 'queued':\n      return 'queued';\n    case 'running':\n      return 'running';\n    case 'succeeded':\n      return '✓ completed';\n    case 'failed':\n      return '✗ failed';\n    case 'cancelled':\n      return 'cancelled';\n    case 'timeout':\n      return 'timeout';\n    default:\n      return String(status || 'running');\n  }\n}\n\nfunction inferPanelStatus(snapshot: WorkflowSnapshot): WorkflowPanelStatus {\n  if (snapshot.errorCount > 0) return 'failed';\n  if (snapshot.runningCount > 0) return 'running';\n  if (snapshot.doneCount + snapshot.skippedCount >= snapshot.agentCount && snapshot.agentCount > 0) {\n    return 'succeeded';\n  }\n  return 'queued';\n}\n\nfunction formatRunCounts(snapshot: WorkflowSnapshot): string {\n  const parts = [`${snapshot.doneCount}/${snapshot.agentCount} done`];\n  if (snapshot.runningCount > 0) parts.push(`${snapshot.runningCount} running`);\n  if (snapshot.errorCount > 0) parts.push(`${snapshot.errorCount} errors`);\n  if (snapshot.skippedCount > 0) parts.push(`${snapshot.skippedCount} skipped`);\n  return parts.join(' · ');\n}\n\nfunction resolveElapsedMs(snapshot: WorkflowSnapshot, nowMs = Date.now()): number | undefined {\n  if (snapshot.durationMs != null) return snapshot.durationMs;\n  const starts = snapshot.agents\n    .map((agent) => agent.startedAtMs)\n    .filter((value): value is number => typeof value === 'number' && Number.isFinite(value));\n  if (starts.length === 0) return undefined;\n  return Math.max(0, nowMs - Math.min(...starts));\n}\n\nfunction formatDuration(ms: number | undefined): string {\n  if (ms == null || !Number.isFinite(ms)) return '';\n  const totalSeconds = Math.max(0, Math.floor(ms / 1000));\n  const minutes = Math.floor(totalSeconds / 60);\n  const seconds = totalSeconds % 60;\n  if (minutes < 60) return `${minutes}:${String(seconds).padStart(2, '0')}`;\n  const hours = Math.floor(minutes / 60);\n  const restMinutes = minutes % 60;\n  return `${hours}:${String(restMinutes).padStart(2, '0')}:${String(seconds).padStart(2, '0')}`;\n}\n\nfunction renderPanelPhaseLines(snapshot: WorkflowSnapshot): string[] {\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 out: string[] = [];\n  for (const phase of phaseNames) {\n    const agents = snapshot.agents.filter((agent) => agent.phase === phase);\n    const counts = countAgents(agents);\n    const complete = agents.length > 0 && counts.done + counts.error + counts.skipped === agents.length;\n    const marker =\n      counts.running > 0 || (!complete && snapshot.currentPhase === phase)\n        ? '▶'\n        : complete\n          ? '✓'\n          : '○';\n    const tail = [\n      counts.running > 0 ? `${counts.running} running` : '',\n      counts.error > 0 ? `${counts.error} errors` : '',\n      counts.skipped > 0 ? `${counts.skipped} skipped` : '',\n    ].filter(Boolean).join(' · ');\n    out.push(`  ${marker} ${phase} ${counts.done}/${agents.length}${tail ? ` · ${tail}` : ''}`);\n  }\n  return out;\n}\n\nfunction renderActiveAgentLines(agent: WorkflowAgentSnapshot): string[] {\n  const step = agent.currentStep || latestStepSummary(agent);\n  const iteration =\n    agent.iteration != null && agent.maxIterations != null\n      ? ` [${agent.iteration}/${agent.maxIterations}]`\n      : '';\n  const head = `  ${agent.status === 'running' ? '●' : '○'} #${agent.id} ${shorten(agent.label, 32)}${iteration}`;\n  return step ? [head, `     ${shorten(step, 96)}`] : [head];\n}\n\nfunction renderRecentAgentLine(agent: WorkflowAgentSnapshot): string {\n  const preview = agent.error || agent.resultPreview || latestStepResult(agent);\n  return `  ${statusIcon(agent.status)} #${agent.id} ${shorten(agent.label, 32)}${\n    preview ? ` — ${shorten(preview, 96)}` : ''\n  }`;\n}\n\nfunction recentCompletedAgents(snapshot: WorkflowSnapshot): WorkflowAgentSnapshot[] {\n  return [...snapshot.agents]\n    .filter((agent) => agent.status === 'done' || agent.status === 'error' || agent.status === 'skipped')\n    .reverse();\n}\n\nfunction latestStepSummary(agent: WorkflowAgentSnapshot): string {\n  const step =\n    [...(agent.steps ?? [])].reverse().find((entry) => entry.status === 'running') ??\n    agent.steps?.[agent.steps.length - 1];\n  if (!step) return '';\n  return step.detail ? `${step.label}: ${step.detail}` : step.label;\n}\n\nfunction latestStepResult(agent: WorkflowAgentSnapshot): string {\n  const step = [...(agent.steps ?? [])].reverse().find((entry) => entry.resultPreview || entry.error);\n  return step?.error || step?.resultPreview || '';\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/structured-output-tool.d.ts

@@ -1,8 +1,8 @@
 /**
  * `structured_output` — terminating tool used to capture a subagent's final result.
  *
- * Injected into a subagent's toolset only when the workflow script asked for
- * structured output via `agent(prompt, { schema })`. The subagent is instructed
+ * Injected into a workflow agent node only when its output schema requires
+ * structured data. The subagent is instructed
  * to invoke this tool exactly once with its final result; the tool sets
  * `terminate: true` so the agent loop stops without paying for an extra
  * assistant turn.

package/dist/src/agent/workflow/structured-output-tool.js

@@ -3,8 +3,8 @@ import Ajv from "ajv";
 /**
 * `structured_output` — terminating tool used to capture a subagent's final result.
 *
-* Injected into a subagent's toolset only when the workflow script asked for
-* structured output via `agent(prompt, { schema })`. The subagent is instructed
+* Injected into a workflow agent node only when its output schema requires
+* structured data. The subagent is instructed
 * to invoke this tool exactly once with its final result; the tool sets
 * `terminate: true` so the agent loop stops without paying for an extra
 * assistant turn.