@xopcai/xopc 0.0.105 → 0.0.107

package/dist/src/agent/skills/skill-manage-ops.js

@@ -2,9 +2,9 @@ import { init_paths, resolveSkillsDir } from "../../config/paths.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { fuzzyFindText, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings } from "../tools/edit-diff.js";
 import { formatScanSummary, scanSkillDirectory } from "./scanner.js";
-import { mkdir, writeFile } from "fs/promises";
 import { join, resolve, sep } from "path";
 import { existsSync, realpathSync } from "fs";
+import { mkdir, writeFile } from "fs/promises";
 //#region src/agent/skills/skill-manage-ops.ts
 /**
 * Shared logic for the skill_manage agent tool (create / edit / patch / delete / write_file / remove_file).

package/dist/src/agent/skills/skill-manager.js

@@ -1,6 +1,6 @@
+import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths, resolveBundledSkillsDir } from "../../config/paths.js";
 import { createSkillConfigManager, isSkillEnabled } from "./config.js";
 import { formatSkillsForPrompt, selectSkillsVisibleInPrompt } from "./format-skills-prompt.js";

package/dist/src/agent/starter-agents.d.ts

@@ -0,0 +1,19 @@
+import type { Config } from '../config/schema.js';
+export declare const STARTER_AGENTS_INITIALIZED_VERSION = 1;
+type StarterAgent = {
+    id: string;
+    displayName: string;
+    description: string;
+    emoji: string;
+    tools?: {
+        disable?: string[];
+    };
+    profileFiles: Record<string, string>;
+};
+export declare const STARTER_AGENTS: readonly StarterAgent[];
+export declare function materializeStarterAgentFiles(cfg: Config): void;
+export declare function ensureStarterAgentsInitialized(cfg: Config): {
+    config: Config;
+    changed: boolean;
+};
+export {};

package/dist/src/agent/starter-agents.js

@@ -0,0 +1,190 @@
+import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentProfileDir, resolveAgentWorkspaceDir } from "./agent-scope.js";
+import { WORKSPACE_FILES, init_paths } from "../config/paths.js";
+import { applyAgentConfig } from "../commands/agents.config.js";
+import { join } from "node:path";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+//#region src/agent/starter-agents.ts
+init_paths();
+init_agent_scope();
+const STARTER_AGENTS_INITIALIZED_VERSION = 1;
+function identity(params) {
+	return `# IDENTITY.md - Who Am I?\n\n- **Name:** ${params.name}\n- **Description:** ${params.description}\n- **Language:** en\n- **Creature:** ${params.creature}\n- **Emoji:** ${params.emoji}\n- **Avatar:**\n`;
+}
+const STARTER_AGENTS = [
+	{
+		id: "main",
+		displayName: "Main",
+		description: "General-purpose personal assistant.",
+		emoji: "✨",
+		profileFiles: {
+			[WORKSPACE_FILES.IDENTITY]: identity({
+				name: "Main",
+				description: "General-purpose personal assistant.",
+				creature: "assistant",
+				emoji: "✨"
+			}),
+			[WORKSPACE_FILES.SOUL]: `# SOUL.md - Main\n\nYou are a helpful personal AI assistant. Adapt to the user's intent, keep responses practical, and use tools when they clearly help.\n`,
+			[WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Main Tool Policy\n\n- Use tools when they materially improve the answer.\n- Prefer safe inspection before changing files or external state.\n- Ask before destructive actions.\n`
+		}
+	},
+	{
+		id: "coder",
+		displayName: "Coder",
+		description: "Software development, debugging, refactoring, and tests.",
+		emoji: "💻",
+		tools: { disable: [
+			"image_generate",
+			"send_message",
+			"send_media",
+			"cronjob"
+		] },
+		profileFiles: {
+			[WORKSPACE_FILES.IDENTITY]: identity({
+				name: "Coder",
+				description: "Software development, debugging, refactoring, and tests.",
+				creature: "software engineer",
+				emoji: "💻"
+			}),
+			[WORKSPACE_FILES.SOUL]: `# SOUL.md - Coder\n\nYou are a software engineering agent. Understand the codebase, make focused changes, and verify behavior.\n\n## Workflow\n\n1. Read relevant files before proposing or editing code.\n2. Follow existing architecture, naming, and test style.\n3. Keep changes scoped to the requested behavior.\n4. Run the smallest meaningful verification.\n5. Report changed files, tests, and remaining risk.\n\n## Boundaries\n\n- Ask before destructive filesystem or git operations.\n- Do not send messages or media on the user's behalf.\n- Do not generate images for coding tasks.\n`,
+			[WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Coder Tool Policy\n\n- Use grep, find, list_dir, and read_file to understand code first.\n- Use edit_file or write_file only after the target change is clear.\n- Use shell for tests, type checks, builds, and safe inspection commands.\n- Use web_search or web_fetch only for current external docs or APIs.\n- Do not use send_message, send_media, cronjob, or image_generate.\n`
+		}
+	},
+	{
+		id: "writer",
+		displayName: "Writer",
+		description: "Drafting, editing, rewriting, and audience-aware content.",
+		emoji: "✍️",
+		tools: { disable: [
+			"shell",
+			"browser_use",
+			"send_message",
+			"send_media",
+			"cronjob",
+			"bundle-mcp"
+		] },
+		profileFiles: {
+			[WORKSPACE_FILES.IDENTITY]: identity({
+				name: "Writer",
+				description: "Drafting, editing, rewriting, and audience-aware content.",
+				creature: "editor",
+				emoji: "✍️"
+			}),
+			[WORKSPACE_FILES.SOUL]: `# SOUL.md - Writer\n\nYou are a writing and editing agent. Improve clarity, structure, voice, and usefulness.\n\n## Workflow\n\n1. Identify audience, purpose, channel, and tone.\n2. Propose structure before long-form writing.\n3. Preserve the user's intent and voice unless asked to change it.\n4. Cut filler and vague claims.\n5. Mark assumptions, missing facts, and placeholders.\n\n## Boundaries\n\n- Do not run shell commands.\n- Do not control browsers.\n- Do not send drafts externally.\n`,
+			[WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Writer Tool Policy\n\n- Use read_file to inspect source material.\n- Use write_file or edit_file only when the user asks to save or revise a document.\n- Use web_search and web_fetch for fact checks and source-backed writing.\n- Do not use shell, browser_use, send_message, send_media, cronjob, or bundle-mcp.\n`
+		}
+	},
+	{
+		id: "researcher",
+		displayName: "Researcher",
+		description: "Deep research, source comparison, and fact synthesis.",
+		emoji: "🔍",
+		tools: { disable: [
+			"shell",
+			"write_file",
+			"edit_file",
+			"send_message",
+			"send_media",
+			"cronjob"
+		] },
+		profileFiles: {
+			[WORKSPACE_FILES.IDENTITY]: identity({
+				name: "Researcher",
+				description: "Deep research, source comparison, and fact synthesis.",
+				creature: "analyst",
+				emoji: "🔍"
+			}),
+			[WORKSPACE_FILES.SOUL]: `# SOUL.md - Researcher\n\nYou are a research agent. Find reliable evidence, compare sources, and produce careful synthesis.\n\n## Workflow\n\n1. Clarify the research question and decision context.\n2. Start broad, then move to primary sources.\n3. Prefer official docs, papers, filings, standards, datasets, and first-party statements.\n4. Cross-check important claims.\n5. Separate facts, source-backed claims, inference, and opinion.\n\n## Boundaries\n\n- Do not edit local files unless asked to save a report.\n- Do not run shell commands.\n- Do not send findings externally.\n`,
+			[WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Researcher Tool Policy\n\n- Use web_search to map the topic and find candidate sources.\n- Use web_fetch for primary sources and source excerpts.\n- Use browser_use only when a page requires interaction.\n- Use read_file when the user provides local source material.\n- Do not use shell, write_file, edit_file, send_message, send_media, or cronjob.\n`
+		}
+	},
+	{
+		id: "data-analyst",
+		displayName: "Data Analyst",
+		description: "Data cleaning, analysis, visualization, and reproducible reports.",
+		emoji: "📊",
+		tools: { disable: [
+			"browser_use",
+			"send_message",
+			"send_media",
+			"cronjob"
+		] },
+		profileFiles: {
+			[WORKSPACE_FILES.IDENTITY]: identity({
+				name: "Data Analyst",
+				description: "Data cleaning, analysis, visualization, and reproducible reports.",
+				creature: "data analyst",
+				emoji: "📊"
+			}),
+			[WORKSPACE_FILES.SOUL]: `# SOUL.md - Data Analyst\n\nYou are a data analysis agent. Inspect data, explain assumptions, and produce reproducible analysis.\n\n## Workflow\n\n1. Inspect schema, sample rows, missing values, and units.\n2. State assumptions before drawing conclusions.\n3. Use reproducible commands or scripts for calculations.\n4. Prefer clear tables and charts over verbose prose.\n5. Highlight data quality issues and uncertainty.\n\n## Boundaries\n\n- Do not control browsers by default.\n- Do not send results externally.\n- Do not schedule cron jobs without explicit user intent.\n`,
+			[WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Data Analyst Tool Policy\n\n- Use read_file, list_dir, grep, and find to inspect datasets and notes.\n- Use shell for reproducible analysis commands and scripts.\n- Use write_file or edit_file for notebooks, scripts, cleaned data, and reports.\n- Use web_fetch or web_search only when external data or documentation is needed.\n- Do not use browser_use, send_message, send_media, or cronjob.\n`
+		}
+	},
+	{
+		id: "creative",
+		displayName: "Creative",
+		description: "Visual direction, image prompts, design critique, and creative options.",
+		emoji: "🎨",
+		tools: { disable: [
+			"shell",
+			"send_message",
+			"send_media",
+			"cronjob"
+		] },
+		profileFiles: {
+			[WORKSPACE_FILES.IDENTITY]: identity({
+				name: "Creative",
+				description: "Visual direction, image prompts, design critique, and creative options.",
+				creature: "creative director",
+				emoji: "🎨"
+			}),
+			[WORKSPACE_FILES.SOUL]: `# SOUL.md - Creative\n\nYou are a creative design agent. Explore visual directions, produce strong options, and explain design tradeoffs.\n\n## Workflow\n\n1. Identify audience, medium, constraints, and taste direction.\n2. Offer distinct creative directions when the brief is open.\n3. Explain why each direction works.\n4. Respect accessibility, brand constraints, and production limits.\n5. Iterate concretely from user feedback.\n\n## Boundaries\n\n- Do not run shell commands.\n- Do not send creative work externally.\n- Do not schedule cron jobs.\n`,
+			[WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Creative Tool Policy\n\n- Use image_generate when the user wants visual options or assets.\n- Use image to inspect user-provided images.\n- Use web_search and web_fetch for references, style research, or current product visuals.\n- Use write_file or edit_file to save prompts, design specs, or copy.\n- Do not use shell, send_message, send_media, or cronjob.\n`
+		}
+	}
+];
+function hasAgentEntry(cfg, agentId) {
+	const id = normalizeAgentId(agentId);
+	return listAgentEntries(cfg).some((entry) => normalizeAgentId(entry.id) === id);
+}
+function writeFileIfMissing(path, content) {
+	if (!existsSync(path)) writeFileSync(path, content, "utf-8");
+}
+function materializeStarterAgentFiles(cfg) {
+	for (const starter of STARTER_AGENTS) {
+		const profileDir = resolveAgentProfileDir(cfg, starter.id);
+		const workspaceDir = resolveAgentWorkspaceDir(cfg, starter.id);
+		mkdirSync(profileDir, { recursive: true });
+		mkdirSync(workspaceDir, { recursive: true });
+		for (const [name, content] of Object.entries(starter.profileFiles)) writeFileIfMissing(join(profileDir, name), content);
+	}
+}
+function ensureStarterAgentsInitialized(cfg) {
+	if ((cfg.agents?.starterAgentsInitializedVersion ?? 0) >= 1) return {
+		config: cfg,
+		changed: false
+	};
+	let next = cfg;
+	for (const starter of STARTER_AGENTS) {
+		if (hasAgentEntry(next, starter.id)) continue;
+		next = applyAgentConfig(next, {
+			agentId: starter.id,
+			...starter.tools ? { tools: starter.tools } : {}
+		});
+	}
+	next = {
+		...next,
+		agents: {
+			...next.agents,
+			starterAgentsInitializedVersion: 1
+		}
+	};
+	materializeStarterAgentFiles(next);
+	return {
+		config: next,
+		changed: next !== cfg
+	};
+}
+//#endregion
+export { STARTER_AGENTS, STARTER_AGENTS_INITIALIZED_VERSION, ensureStarterAgentsInitialized, materializeStarterAgentFiles };
+
+//# sourceMappingURL=starter-agents.js.map

package/dist/src/agent/starter-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-agents.js","names":[],"sources":["../../../src/agent/starter-agents.ts"],"sourcesContent":["import { existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport type { Config } from '../config/schema.js';\nimport { WORKSPACE_FILES } from '../config/paths.js';\nimport { applyAgentConfig, listAgentEntries } from '../commands/agents.config.js';\nimport {\n  normalizeAgentId,\n  resolveAgentProfileDir,\n  resolveAgentWorkspaceDir,\n} from './agent-scope.js';\n\nexport const STARTER_AGENTS_INITIALIZED_VERSION = 1;\n\ntype StarterAgent = {\n  id: string;\n  displayName: string;\n  description: string;\n  emoji: string;\n  tools?: { disable?: string[] };\n  profileFiles: Record<string, string>;\n};\n\nfunction identity(params: { name: string; description: string; creature: string; emoji: string }): string {\n  return `# IDENTITY.md - Who Am I?\\n\\n- **Name:** ${params.name}\\n- **Description:** ${params.description}\\n- **Language:** en\\n- **Creature:** ${params.creature}\\n- **Emoji:** ${params.emoji}\\n- **Avatar:**\\n`;\n}\n\nexport const STARTER_AGENTS: readonly StarterAgent[] = [\n  {\n    id: 'main',\n    displayName: 'Main',\n    description: 'General-purpose personal assistant.',\n    emoji: '✨',\n    profileFiles: {\n      [WORKSPACE_FILES.IDENTITY]: identity({\n        name: 'Main',\n        description: 'General-purpose personal assistant.',\n        creature: 'assistant',\n        emoji: '✨',\n      }),\n      [WORKSPACE_FILES.SOUL]: `# SOUL.md - Main\\n\\nYou are a helpful personal AI assistant. Adapt to the user's intent, keep responses practical, and use tools when they clearly help.\\n`,\n      [WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Main Tool Policy\\n\\n- Use tools when they materially improve the answer.\\n- Prefer safe inspection before changing files or external state.\\n- Ask before destructive actions.\\n`,\n    },\n  },\n  {\n    id: 'coder',\n    displayName: 'Coder',\n    description: 'Software development, debugging, refactoring, and tests.',\n    emoji: '💻',\n    tools: { disable: ['image_generate', 'send_message', 'send_media', 'cronjob'] },\n    profileFiles: {\n      [WORKSPACE_FILES.IDENTITY]: identity({\n        name: 'Coder',\n        description: 'Software development, debugging, refactoring, and tests.',\n        creature: 'software engineer',\n        emoji: '💻',\n      }),\n      [WORKSPACE_FILES.SOUL]: `# SOUL.md - Coder\\n\\nYou are a software engineering agent. Understand the codebase, make focused changes, and verify behavior.\\n\\n## Workflow\\n\\n1. Read relevant files before proposing or editing code.\\n2. Follow existing architecture, naming, and test style.\\n3. Keep changes scoped to the requested behavior.\\n4. Run the smallest meaningful verification.\\n5. Report changed files, tests, and remaining risk.\\n\\n## Boundaries\\n\\n- Ask before destructive filesystem or git operations.\\n- Do not send messages or media on the user's behalf.\\n- Do not generate images for coding tasks.\\n`,\n      [WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Coder Tool Policy\\n\\n- Use grep, find, list_dir, and read_file to understand code first.\\n- Use edit_file or write_file only after the target change is clear.\\n- Use shell for tests, type checks, builds, and safe inspection commands.\\n- Use web_search or web_fetch only for current external docs or APIs.\\n- Do not use send_message, send_media, cronjob, or image_generate.\\n`,\n    },\n  },\n  {\n    id: 'writer',\n    displayName: 'Writer',\n    description: 'Drafting, editing, rewriting, and audience-aware content.',\n    emoji: '✍️',\n    tools: { disable: ['shell', 'browser_use', 'send_message', 'send_media', 'cronjob', 'bundle-mcp'] },\n    profileFiles: {\n      [WORKSPACE_FILES.IDENTITY]: identity({\n        name: 'Writer',\n        description: 'Drafting, editing, rewriting, and audience-aware content.',\n        creature: 'editor',\n        emoji: '✍️',\n      }),\n      [WORKSPACE_FILES.SOUL]: `# SOUL.md - Writer\\n\\nYou are a writing and editing agent. Improve clarity, structure, voice, and usefulness.\\n\\n## Workflow\\n\\n1. Identify audience, purpose, channel, and tone.\\n2. Propose structure before long-form writing.\\n3. Preserve the user's intent and voice unless asked to change it.\\n4. Cut filler and vague claims.\\n5. Mark assumptions, missing facts, and placeholders.\\n\\n## Boundaries\\n\\n- Do not run shell commands.\\n- Do not control browsers.\\n- Do not send drafts externally.\\n`,\n      [WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Writer Tool Policy\\n\\n- Use read_file to inspect source material.\\n- Use write_file or edit_file only when the user asks to save or revise a document.\\n- Use web_search and web_fetch for fact checks and source-backed writing.\\n- Do not use shell, browser_use, send_message, send_media, cronjob, or bundle-mcp.\\n`,\n    },\n  },\n  {\n    id: 'researcher',\n    displayName: 'Researcher',\n    description: 'Deep research, source comparison, and fact synthesis.',\n    emoji: '🔍',\n    tools: { disable: ['shell', 'write_file', 'edit_file', 'send_message', 'send_media', 'cronjob'] },\n    profileFiles: {\n      [WORKSPACE_FILES.IDENTITY]: identity({\n        name: 'Researcher',\n        description: 'Deep research, source comparison, and fact synthesis.',\n        creature: 'analyst',\n        emoji: '🔍',\n      }),\n      [WORKSPACE_FILES.SOUL]: `# SOUL.md - Researcher\\n\\nYou are a research agent. Find reliable evidence, compare sources, and produce careful synthesis.\\n\\n## Workflow\\n\\n1. Clarify the research question and decision context.\\n2. Start broad, then move to primary sources.\\n3. Prefer official docs, papers, filings, standards, datasets, and first-party statements.\\n4. Cross-check important claims.\\n5. Separate facts, source-backed claims, inference, and opinion.\\n\\n## Boundaries\\n\\n- Do not edit local files unless asked to save a report.\\n- Do not run shell commands.\\n- Do not send findings externally.\\n`,\n      [WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Researcher Tool Policy\\n\\n- Use web_search to map the topic and find candidate sources.\\n- Use web_fetch for primary sources and source excerpts.\\n- Use browser_use only when a page requires interaction.\\n- Use read_file when the user provides local source material.\\n- Do not use shell, write_file, edit_file, send_message, send_media, or cronjob.\\n`,\n    },\n  },\n  {\n    id: 'data-analyst',\n    displayName: 'Data Analyst',\n    description: 'Data cleaning, analysis, visualization, and reproducible reports.',\n    emoji: '📊',\n    tools: { disable: ['browser_use', 'send_message', 'send_media', 'cronjob'] },\n    profileFiles: {\n      [WORKSPACE_FILES.IDENTITY]: identity({\n        name: 'Data Analyst',\n        description: 'Data cleaning, analysis, visualization, and reproducible reports.',\n        creature: 'data analyst',\n        emoji: '📊',\n      }),\n      [WORKSPACE_FILES.SOUL]: `# SOUL.md - Data Analyst\\n\\nYou are a data analysis agent. Inspect data, explain assumptions, and produce reproducible analysis.\\n\\n## Workflow\\n\\n1. Inspect schema, sample rows, missing values, and units.\\n2. State assumptions before drawing conclusions.\\n3. Use reproducible commands or scripts for calculations.\\n4. Prefer clear tables and charts over verbose prose.\\n5. Highlight data quality issues and uncertainty.\\n\\n## Boundaries\\n\\n- Do not control browsers by default.\\n- Do not send results externally.\\n- Do not schedule cron jobs without explicit user intent.\\n`,\n      [WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Data Analyst Tool Policy\\n\\n- Use read_file, list_dir, grep, and find to inspect datasets and notes.\\n- Use shell for reproducible analysis commands and scripts.\\n- Use write_file or edit_file for notebooks, scripts, cleaned data, and reports.\\n- Use web_fetch or web_search only when external data or documentation is needed.\\n- Do not use browser_use, send_message, send_media, or cronjob.\\n`,\n    },\n  },\n  {\n    id: 'creative',\n    displayName: 'Creative',\n    description: 'Visual direction, image prompts, design critique, and creative options.',\n    emoji: '🎨',\n    tools: { disable: ['shell', 'send_message', 'send_media', 'cronjob'] },\n    profileFiles: {\n      [WORKSPACE_FILES.IDENTITY]: identity({\n        name: 'Creative',\n        description: 'Visual direction, image prompts, design critique, and creative options.',\n        creature: 'creative director',\n        emoji: '🎨',\n      }),\n      [WORKSPACE_FILES.SOUL]: `# SOUL.md - Creative\\n\\nYou are a creative design agent. Explore visual directions, produce strong options, and explain design tradeoffs.\\n\\n## Workflow\\n\\n1. Identify audience, medium, constraints, and taste direction.\\n2. Offer distinct creative directions when the brief is open.\\n3. Explain why each direction works.\\n4. Respect accessibility, brand constraints, and production limits.\\n5. Iterate concretely from user feedback.\\n\\n## Boundaries\\n\\n- Do not run shell commands.\\n- Do not send creative work externally.\\n- Do not schedule cron jobs.\\n`,\n      [WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Creative Tool Policy\\n\\n- Use image_generate when the user wants visual options or assets.\\n- Use image to inspect user-provided images.\\n- Use web_search and web_fetch for references, style research, or current product visuals.\\n- Use write_file or edit_file to save prompts, design specs, or copy.\\n- Do not use shell, send_message, send_media, or cronjob.\\n`,\n    },\n  },\n];\n\nfunction hasAgentEntry(cfg: Config, agentId: string): boolean {\n  const id = normalizeAgentId(agentId);\n  return listAgentEntries(cfg).some((entry) => normalizeAgentId(entry.id) === id);\n}\n\nfunction writeFileIfMissing(path: string, content: string): void {\n  if (!existsSync(path)) {\n    writeFileSync(path, content, 'utf-8');\n  }\n}\n\nexport function materializeStarterAgentFiles(cfg: Config): void {\n  for (const starter of STARTER_AGENTS) {\n    const profileDir = resolveAgentProfileDir(cfg, starter.id);\n    const workspaceDir = resolveAgentWorkspaceDir(cfg, starter.id);\n    mkdirSync(profileDir, { recursive: true });\n    mkdirSync(workspaceDir, { recursive: true });\n    for (const [name, content] of Object.entries(starter.profileFiles)) {\n      writeFileIfMissing(join(profileDir, name), content);\n    }\n  }\n}\n\nexport function ensureStarterAgentsInitialized(cfg: Config): { config: Config; changed: boolean } {\n  if ((cfg.agents?.starterAgentsInitializedVersion ?? 0) >= STARTER_AGENTS_INITIALIZED_VERSION) {\n    return { config: cfg, changed: false };\n  }\n\n  let next = cfg;\n  for (const starter of STARTER_AGENTS) {\n    if (hasAgentEntry(next, starter.id)) continue;\n    next = applyAgentConfig(next, {\n      agentId: starter.id,\n      ...(starter.tools ? { tools: starter.tools } : {}),\n    });\n  }\n\n  next = {\n    ...next,\n    agents: {\n      ...next.agents,\n      starterAgentsInitializedVersion: STARTER_AGENTS_INITIALIZED_VERSION,\n    },\n  };\n\n  materializeStarterAgentFiles(next);\n  return { config: next, changed: next !== cfg };\n}\n"],"mappings":"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"}

package/dist/src/agent/tools/dreaming-tool.js

@@ -3,8 +3,8 @@ import { init_logger } from "../../utils/logger.js";
 import { SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE } from "../memory/dreaming/constants.js";
 import { loadDreamingStore, saveDreamingStore } from "../memory/dreaming/short-term-store.js";
 import { resolveDreamingConfig } from "../memory/dreaming/config.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/dreaming-tool.ts
 init_logger();

package/dist/src/agent/tools/factory.js

@@ -1,6 +1,6 @@
+import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
 import { createEditFileTool } from "./edit.js";

package/dist/src/agent/tools/image-generate-tool.js

@@ -4,9 +4,9 @@ import { isFailoverError } from "../failover-error.js";
 import { imageAssetFromDataUrl, imageFileExtensionForMimeType, mimeTypeFromFileName, parseImageDataUrl, sniffImageMimeType } from "../image/generation/image-assets.js";
 import { getImageGenerationProvider } from "../image/generation/provider-registry.js";
 import { generateImage, listImageGenerationProvidersSummary } from "../image/generation/runtime.js";
+import path from "node:path";
 import { randomBytes } from "node:crypto";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/image-generate-tool.ts
 const DEFAULT_COUNT = 1;

package/dist/src/agent/tools/send-media.js

@@ -1,7 +1,7 @@
 import { checkFileSafety } from "../prompt/safety.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
-import { readFile } from "fs/promises";
 import { basename } from "node:path";
+import { readFile } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/send-media.ts
 const SendMediaSchema = Type.Object({

package/dist/src/agent/tools/skill-manage-tool.js

@@ -2,9 +2,9 @@ import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
 import { createSkillConfigManager } from "../skills/config.js";
 import { applyPatchToContent, atomicWriteUtf8, effectiveAgentWritePolicy, ensureCategorySegment, isPathInsideDir, maxSkillMdChars, maxSupportFileBytes, mutatableSkillOrNull, resolveCreateSkillDir, scanSkillDirOrError, validateSkillMdContent, validateSkillNameSegment, validateSupportingRelativePath } from "../skills/skill-manage-ops.js";
-import { readFile, rm } from "fs/promises";
 import { join } from "path";
 import { existsSync, rmSync } from "fs";
+import { readFile, rm } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/skill-manage-tool.ts
 init_paths();

package/dist/src/agent/tools/workflow-tool.js

@@ -1,6 +1,6 @@
+import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { parseWorkflowScript } from "../workflow/parser.js";
 import "../workflow/index.js";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/write.js

@@ -1,8 +1,8 @@
 import { checkFileSafety } from "../prompt/safety.js";
 import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
-import { mkdir, writeFile } from "fs/promises";
 import { dirname } from "path";
+import { mkdir, writeFile } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/write.ts
 const MAX_FILE_SIZE = 10 * 1024 * 1024;

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

@@ -1,8 +1,8 @@
 import { init_paths_state, resolveStateDir } from "../../config/paths-state.js";
 import { BUILTIN_WORKFLOWS } from "./builtins/index.js";
 import { parseWorkflowScript } from "./parser.js";
-import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 //#region src/agent/workflow/catalog.ts
 /**
 * Catalog for named workflows.

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

@@ -3,9 +3,10 @@ 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 { emptySnapshotFor, runWorkflow } from "./runtime.js";
+import { emptySnapshotFor } from "./snapshot-empty.js";
 import { createWorkflowSnapshot, previewValue, recomputeCounts, renderWorkflowText } from "./snapshot.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 };

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

@@ -24,11 +24,11 @@
  * 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';
+import type { SubagentRunner, WorkflowRunOptions, WorkflowRunResult } 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, phaseTitles?: string[]): WorkflowSnapshot;
+export { emptySnapshotFor } from './snapshot-empty.js';

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

@@ -1,4 +1,5 @@
 import { parseWorkflowScript } from "./parser.js";
+import { emptySnapshotFor } from "./snapshot-empty.js";
 import { availableParallelism } from "node:os";
 import { Script, createContext } from "node:vm";
 //#region src/agent/workflow/runtime.ts
@@ -61,21 +62,24 @@ async function runWorkflow(script, deps, options) {
 		remaining: () => options.tokenBudget == null ? Number.POSITIVE_INFINITY : Math.max(0, options.tokenBudget - state.spent)
 	});
 	const throwIfAborted = () => {
-		if (options.signal?.aborted) throw new Error("workflow aborted");
+		if (!options.signal?.aborted) return;
+		const reason = options.signal.reason;
+		if (reason instanceof Error) throw reason;
+		if (reason) throw new Error(String(reason));
+		throw new Error("workflow aborted");
 	};
-	const resolveAgentModel = (normalized, assignedPhase) => {
-		const realId = normalized.model?.trim();
-		if (realId) {
+	const resolveAgentModelSelection = (normalized, assignedPhase) => {
+		const modelRef = normalized.model?.trim() || (assignedPhase ? phaseDefaultModels.get(assignedPhase) : void 0);
+		if (modelRef) {
 			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 model = deps.resolveModelId(modelRef);
+			return {
+				modelRef,
+				resolvedModelRef: modelToRef(model),
+				model
+			};
 		}
+		return {};
 	};
 	const agent = async (prompt, agentOptions = {}) => {
 		throwIfAborted();
@@ -85,14 +89,23 @@ async function runWorkflow(script, deps, options) {
 		const normalized = normalizeAgentOptions(agentOptions);
 		const assignedPhase = normalized.phase ?? state.currentPhase;
 		const requestedLabel = normalized.label?.trim();
+		const modelSelection = resolveAgentModelSelection(normalized, assignedPhase);
 		state.agentCount += 1;
 		const id = state.agentCount;
 		const label = requestedLabel || defaultAgentLabel(assignedPhase, id);
+		const invocation = buildInvocationSnapshot({
+			prompt: taskPrompt,
+			label,
+			phase: assignedPhase,
+			normalized,
+			modelSelection
+		});
 		options.onAgentQueued?.({
 			id,
 			label,
 			phase: assignedPhase,
-			prompt: taskPrompt
+			prompt: taskPrompt,
+			invocation
 		});
 		const runPromise = limiter(async () => {
 			options.onAgentStart?.({
@@ -103,7 +116,6 @@ async function runWorkflow(script, deps, options) {
 			});
 			try {
 				throwIfAborted();
-				const resolvedModel = resolveAgentModel(normalized, assignedPhase);
 				const enhanced = options.enhanceSubagentRun?.({
 					id,
 					label,
@@ -117,7 +129,7 @@ async function runWorkflow(script, deps, options) {
 					maxIterations: normalized.maxIterations,
 					phase: assignedPhase,
 					signal: options.signal,
-					model: resolvedModel,
+					model: modelSelection.model,
 					...enhanced
 				});
 				throwIfAborted();
@@ -236,20 +248,6 @@ async function runWorkflow(script, deps, options) {
 		durationMs: Date.now() - started
 	};
 }
-function emptySnapshotFor(name, description, phaseTitles) {
-	return {
-		name,
-		description,
-		phases: phaseTitles ? [...phaseTitles] : [],
-		logs: [],
-		agents: [],
-		agentCount: 0,
-		runningCount: 0,
-		doneCount: 0,
-		errorCount: 0,
-		skippedCount: 0
-	};
-}
 function clampConcurrency(requested) {
 	if (typeof requested === "number" && Number.isFinite(requested) && requested >= 1) return Math.min(Math.floor(requested), DEFAULT_CONCURRENCY_CEILING);
 	let cpu = DEFAULT_CONCURRENCY_CEILING;
@@ -312,6 +310,29 @@ function normalizeAgentOptions(value) {
 		maxIterations
 	};
 }
+function buildInvocationSnapshot(params) {
+	return compactObject({
+		prompt: params.prompt,
+		label: params.label,
+		phase: params.phase,
+		modelRef: params.modelSelection.modelRef,
+		resolvedModelRef: params.modelSelection.resolvedModelRef,
+		schema: cloneJsonValue(params.normalized.schema),
+		toolset: params.normalized.toolset ? [...params.normalized.toolset] : void 0,
+		maxIterations: params.normalized.maxIterations
+	});
+}
+function modelToRef(model) {
+	return `${model.provider}/${model.id}`;
+}
+function cloneJsonValue(value) {
+	if (value === void 0) return void 0;
+	return structuredClone(value);
+}
+function compactObject(value) {
+	for (const key of Object.keys(value)) if (value[key] === void 0) delete value[key];
+	return value;
+}
 function assertStructuredCloneable(value, name) {
 	try {
 		structuredClone(value);