@xopcai/xopc 0.0.116 → 0.0.118

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

@@ -5,9 +5,7 @@ type StarterAgent = {
     displayName: string;
     description: string;
     emoji: string;
-    tools?: {
-        disable?: string[];
-    };
+    tools?: NonNullable<Config['agents']['list']>[number]['tools'];
     profileFiles: Record<string, string>;
 };
 export declare const STARTER_AGENTS: readonly StarterAgent[];

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

@@ -1,12 +1,15 @@
 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 { existsSync, mkdirSync, writeFileSync } from "node:fs";
 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 denyTools(names) {
+	return { builtin: Object.fromEntries(names.map((name) => [name, { mode: "deny" }])) };
+}
 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`;
 }
@@ -32,12 +35,12 @@ const STARTER_AGENTS = [
 		displayName: "Coder",
 		description: "Software development, debugging, refactoring, and tests.",
 		emoji: "💻",
-		tools: { disable: [
+		tools: denyTools([
 			"image_generate",
 			"send_message",
 			"send_media",
 			"cronjob"
-		] },
+		]),
 		profileFiles: {
 			[WORKSPACE_FILES.IDENTITY]: identity({
 				name: "Coder",
@@ -54,14 +57,14 @@ const STARTER_AGENTS = [
 		displayName: "Writer",
 		description: "Drafting, editing, rewriting, and audience-aware content.",
 		emoji: "✍️",
-		tools: { disable: [
+		tools: denyTools([
 			"shell",
 			"browser_use",
 			"send_message",
 			"send_media",
 			"cronjob",
 			"bundle-mcp"
-		] },
+		]),
 		profileFiles: {
 			[WORKSPACE_FILES.IDENTITY]: identity({
 				name: "Writer",
@@ -78,14 +81,14 @@ const STARTER_AGENTS = [
 		displayName: "Researcher",
 		description: "Deep research, source comparison, and fact synthesis.",
 		emoji: "🔍",
-		tools: { disable: [
+		tools: denyTools([
 			"shell",
 			"write_file",
 			"edit_file",
 			"send_message",
 			"send_media",
 			"cronjob"
-		] },
+		]),
 		profileFiles: {
 			[WORKSPACE_FILES.IDENTITY]: identity({
 				name: "Researcher",
@@ -102,12 +105,12 @@ const STARTER_AGENTS = [
 		displayName: "Data Analyst",
 		description: "Data cleaning, analysis, visualization, and reproducible reports.",
 		emoji: "📊",
-		tools: { disable: [
+		tools: denyTools([
 			"browser_use",
 			"send_message",
 			"send_media",
 			"cronjob"
-		] },
+		]),
 		profileFiles: {
 			[WORKSPACE_FILES.IDENTITY]: identity({
 				name: "Data Analyst",
@@ -124,12 +127,12 @@ const STARTER_AGENTS = [
 		displayName: "Creative",
 		description: "Visual direction, image prompts, design critique, and creative options.",
 		emoji: "🎨",
-		tools: { disable: [
+		tools: denyTools([
 			"shell",
 			"send_message",
 			"send_media",
 			"cronjob"
-		] },
+		]),
 		profileFiles: {
 			[WORKSPACE_FILES.IDENTITY]: identity({
 				name: "Creative",
@@ -159,10 +162,6 @@ function materializeStarterAgentFiles(cfg) {
 	}
 }
 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;
@@ -171,13 +170,6 @@ function ensureStarterAgentsInitialized(cfg) {
 			...starter.tools ? { tools: starter.tools } : {}
 		});
 	}
-	next = {
-		...next,
-		agents: {
-			...next.agents,
-			starterAgentsInitializedVersion: 1
-		}
-	};
 	materializeStarterAgentFiles(next);
 	return {
 		config: next,

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

@@ -1 +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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"}
+{"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?: NonNullable<Config['agents']['list']>[number]['tools'];\n  profileFiles: Record<string, string>;\n};\n\nfunction denyTools(names: string[]): NonNullable<Config['agents']['list']>[number]['tools'] {\n  return { builtin: Object.fromEntries(names.map((name) => [name, { mode: 'deny' as const }])) };\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: denyTools(['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: denyTools(['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: denyTools(['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: denyTools(['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: denyTools(['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  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  materializeStarterAgentFiles(next);\n  return { config: next, changed: next !== cfg };\n}\n"],"mappings":";;;;;;YAIqD;kBAM3B;AAE1B,MAAa,qCAAqC;AAWlD,SAAS,UAAU,OAAyE;AAC1F,QAAO,EAAE,SAAS,OAAO,YAAY,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,MAAM,QAAiB,CAAC,CAAC,CAAC,EAAE;;AAGhG,SAAS,SAAS,QAAwF;AACxG,QAAO,4CAA4C,OAAO,KAAK,uBAAuB,OAAO,YAAY,wCAAwC,OAAO,SAAS,iBAAiB,OAAO,MAAM;;AAGjM,MAAa,iBAA0C;CACrD;EACE,IAAI;EACJ,aAAa;EACb,aAAa;EACb,OAAO;EACP,cAAc;IACX,gBAAgB,WAAW,SAAS;IACnC,MAAM;IACN,aAAa;IACb,UAAU;IACV,OAAO;IACR,CAAC;IACD,gBAAgB,OAAO;IACvB,gBAAgB,QAAQ;GAC1B;EACF;CACD;EACE,IAAI;EACJ,aAAa;EACb,aAAa;EACb,OAAO;EACP,OAAO,UAAU;GAAC;GAAkB;GAAgB;GAAc;GAAU,CAAC;EAC7E,cAAc;IACX,gBAAgB,WAAW,SAAS;IACnC,MAAM;IACN,aAAa;IACb,UAAU;IACV,OAAO;IACR,CAAC;IACD,gBAAgB,OAAO;IACvB,gBAAgB,QAAQ;GAC1B;EACF;CACD;EACE,IAAI;EACJ,aAAa;EACb,aAAa;EACb,OAAO;EACP,OAAO,UAAU;GAAC;GAAS;GAAe;GAAgB;GAAc;GAAW;GAAa,CAAC;EACjG,cAAc;IACX,gBAAgB,WAAW,SAAS;IACnC,MAAM;IACN,aAAa;IACb,UAAU;IACV,OAAO;IACR,CAAC;IACD,gBAAgB,OAAO;IACvB,gBAAgB,QAAQ;GAC1B;EACF;CACD;EACE,IAAI;EACJ,aAAa;EACb,aAAa;EACb,OAAO;EACP,OAAO,UAAU;GAAC;GAAS;GAAc;GAAa;GAAgB;GAAc;GAAU,CAAC;EAC/F,cAAc;IACX,gBAAgB,WAAW,SAAS;IACnC,MAAM;IACN,aAAa;IACb,UAAU;IACV,OAAO;IACR,CAAC;IACD,gBAAgB,OAAO;IACvB,gBAAgB,QAAQ;GAC1B;EACF;CACD;EACE,IAAI;EACJ,aAAa;EACb,aAAa;EACb,OAAO;EACP,OAAO,UAAU;GAAC;GAAe;GAAgB;GAAc;GAAU,CAAC;EAC1E,cAAc;IACX,gBAAgB,WAAW,SAAS;IACnC,MAAM;IACN,aAAa;IACb,UAAU;IACV,OAAO;IACR,CAAC;IACD,gBAAgB,OAAO;IACvB,gBAAgB,QAAQ;GAC1B;EACF;CACD;EACE,IAAI;EACJ,aAAa;EACb,aAAa;EACb,OAAO;EACP,OAAO,UAAU;GAAC;GAAS;GAAgB;GAAc;GAAU,CAAC;EACpE,cAAc;IACX,gBAAgB,WAAW,SAAS;IACnC,MAAM;IACN,aAAa;IACb,UAAU;IACV,OAAO;IACR,CAAC;IACD,gBAAgB,OAAO;IACvB,gBAAgB,QAAQ;GAC1B;EACF;CACF;AAED,SAAS,cAAc,KAAa,SAA0B;CAC5D,MAAM,KAAK,iBAAiB,QAAQ;AACpC,QAAO,iBAAiB,IAAI,CAAC,MAAM,UAAU,iBAAiB,MAAM,GAAG,KAAK,GAAG;;AAGjF,SAAS,mBAAmB,MAAc,SAAuB;AAC/D,KAAI,CAAC,WAAW,KAAK,CACnB,eAAc,MAAM,SAAS,QAAQ;;AAIzC,SAAgB,6BAA6B,KAAmB;AAC9D,MAAK,MAAM,WAAW,gBAAgB;EACpC,MAAM,aAAa,uBAAuB,KAAK,QAAQ,GAAG;EAC1D,MAAM,eAAe,yBAAyB,KAAK,QAAQ,GAAG;AAC9D,YAAU,YAAY,EAAE,WAAW,MAAM,CAAC;AAC1C,YAAU,cAAc,EAAE,WAAW,MAAM,CAAC;AAC5C,OAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,QAAQ,aAAa,CAChE,oBAAmB,KAAK,YAAY,KAAK,EAAE,QAAQ;;;AAKzD,SAAgB,+BAA+B,KAAmD;CAChG,IAAI,OAAO;AACX,MAAK,MAAM,WAAW,gBAAgB;AACpC,MAAI,cAAc,MAAM,QAAQ,GAAG,CAAE;AACrC,SAAO,iBAAiB,MAAM;GAC5B,SAAS,QAAQ;GACjB,GAAI,QAAQ,QAAQ,EAAE,OAAO,QAAQ,OAAO,GAAG,EAAE;GAClD,CAAC;;AAGJ,8BAA6B,KAAK;AAClC,QAAO;EAAE,QAAQ;EAAM,SAAS,SAAS;EAAK"}

package/dist/src/agent/tools/browser/tool/browser-use-tool.js

@@ -100,8 +100,7 @@ function createBrowserUseTool(deps) {
 				await mgr.ensureConnected();
 				const ext = mgr.getExtensionProvider();
 				if (ext) {
-					const timeout = deps.getConfig?.()?.agents?.defaults?.browser?.commandTimeout;
-					const timeoutMs = typeof timeout === "number" && Number.isFinite(timeout) && timeout > 0 ? Math.floor(timeout * 1e3) : 3e4;
+					const timeoutMs = 3e4;
 					const urlRes = await ext.sendCommand("get_url", {}, { timeout: timeoutMs });
 					const titleRes = await ext.sendCommand("get_title", {}, { timeout: timeoutMs });
 					const snapRes = await ext.sendCommand("snapshot", {}, { timeout: timeoutMs });

package/dist/src/agent/tools/browser/tool/browser-use-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-use-tool.js","names":[],"sources":["../../../../../../src/agent/tools/browser/tool/browser-use-tool.ts"],"sourcesContent":["/**\n * browser_use — unified browser AgentTool.\n *\n * Modes: command | pipeline | inspect | close.\n * Replaces the 14 fine-grained browser_* tools with a single entry point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { createLogger } from '../../../../utils/logger.js';\nimport type { Config } from '../../../../config/schema.js';\nimport type { BrowserManager } from '../../../../browser/manager.js';\nimport type { CdpSupervisor } from '../../../../browser/cdp-supervisor.js';\nimport type { Page } from 'playwright-core';\n\nimport { BrowserUseSchema } from './schemas.js';\nimport { createBrowserActionRegistry } from '../../../../browser/actions/registry.js';\nimport type { BrowserActionContext, BrowserActionResult } from '../../../../browser/actions/types.js';\nimport { loadBrowserPipelineSource } from '../../../../browser/pipeline/source.js';\nimport type { BrowserNotReadyError, BrowserSetupHint } from '../../../../browser/readiness.js';\n\nconst log = createLogger('Agent:BrowserUse');\n\nexport interface CreateBrowserUseToolDeps {\n  getManager: () => BrowserManager;\n  getPageForTask: () => Promise<Page>;\n  getTaskId: () => string;\n  getConfig: () => Config | undefined;\n  getSupervisor?: () => CdpSupervisor | undefined;\n  notifyBrowserPageClosed?: (taskId: string) => void;\n  /**\n   * Preflight readiness check. Returns `null` when the configured backend is\n   * usable, otherwise a structured hint the chat surface renders as a setup\n   * card. Cache the result upstream (~30s) so back-to-back calls don't reprobe.\n   */\n  getReadiness?: () => Promise<BrowserNotReadyError | null>;\n  /** Pipeline runner (injected to avoid circular deps; lazy-loaded if not provided). */\n  runPipeline?: (\n    yaml: string,\n    args: Record<string, unknown>,\n    ctx: BrowserActionContext,\n    options: { dryRun?: boolean; sourceLocation?: string },\n  ) => Promise<BrowserActionResult>;\n}\n\nexport function createBrowserUseTool(deps: CreateBrowserUseToolDeps): AgentTool<any, any> {\n  const registry = createBrowserActionRegistry();\n\n  function buildContext(page: Page, signal?: AbortSignal): BrowserActionContext {\n    return {\n      page,\n      manager: deps.getManager(),\n      config: deps.getConfig(),\n      taskId: deps.getTaskId(),\n      supervisor: deps.getSupervisor?.(),\n      signal,\n    };\n  }\n\n  /**\n   * Render a {@link BrowserSetupHint} as a tool result. The text body is a\n   * JSON envelope (`kind: 'browser_setup_required'`) so the chat surface can\n   * detect it and render a Setup card; the embedded `message` keeps the\n   * payload human-readable for the LLM so it stops the browser attempt and\n   * tells the user to finish setup.\n   */\n  function formatNotReady(hint: BrowserSetupHint): { content: { type: 'text'; text: string }[]; details: Record<string, unknown> } {\n    const message =\n      `⚠ Browser is not ready (backend=${hint.backend}, reason=${hint.reason}). ` +\n      `Do NOT retry. Tell the user to open Settings → Browser to finish setup, ` +\n      `then ask them to confirm before running any browser action again.`;\n    const payload = {\n      kind: 'browser_setup_required' as const,\n      backend: hint.backend,\n      reason: hint.reason,\n      deepLink: hint.deepLink,\n      detail: hint.detail,\n      message,\n    };\n    return {\n      content: [{ type: 'text', text: JSON.stringify(payload) }],\n      details: {\n        ok: false,\n        kind: 'browser_setup_required',\n        backend: hint.backend,\n        reason: hint.reason,\n        deepLink: hint.deepLink,\n      },\n    };\n  }\n\n  function formatResult(result: BrowserActionResult): { content: { type: 'text'; text: string }[]; details: Record<string, unknown> } {\n    if (result.ok) {\n      const parts: string[] = [];\n      if (result.text) parts.push(result.text);\n      if (result.data && !result.text) parts.push(JSON.stringify(result.data, null, 2));\n      return {\n        content: [{ type: 'text', text: parts.join('\\n') || 'OK' }],\n        details: { ok: true, action: result.action, ...(result.artifacts?.length ? { artifacts: result.artifacts.length } : {}) },\n      };\n    }\n    const parts: string[] = [];\n    if (result.error) parts.push(`[${result.error.code}] ${result.error.message}`);\n    if (result.diagnostics?.url) parts.push(`URL: ${result.diagnostics.url}`);\n    if (result.diagnostics?.snapshot) parts.push(`Snapshot: ${result.diagnostics.snapshot.slice(0, 2000)}`);\n    return {\n      content: [{ type: 'text', text: parts.join('\\n') || 'Failed' }],\n      details: { ok: false, action: result.action, error: result.error },\n    };\n  }\n\n  const tool: any = {\n    name: 'browser_use',\n    label: '🌐 Browser',\n    description:\n      'Use a persistent browser for web navigation, page inspection, interaction, screenshots, network capture, and scripted browser pipelines. For non-trivial browser tasks, load the built-in manual first with tool_manual({ tool: \"browser_use\" }).',\n    parameters: BrowserUseSchema,\n\n    async execute(_toolCallId, params: any, signal, _onUpdate) {\n      const { mode, command, args: cmdArgs, pipeline: pipelineParams, options: _options } = params as {\n        mode: string;\n        command?: string;\n        args?: Record<string, unknown>;\n        pipeline?: { yaml?: string; path?: string; args?: Record<string, unknown>; dryRun?: boolean };\n        options?: { timeout?: number; headless?: boolean };\n      };\n\n      // ─── readiness preflight ────────────────────────────────────────────\n      // Probes the configured backend (doctor + WS bridge / CDP / cloud key)\n      // before any launch attempt. On failure we short-circuit with a setup\n      // hint the chat renders as a card — the agent should stop and ask the\n      // user to finish setup instead of looping on launch errors.\n      if (deps.getReadiness) {\n        try {\n          const notReady = await deps.getReadiness();\n          if (notReady) {\n            return formatNotReady(notReady.hint);\n          }\n        } catch (e) {\n          log.warn({ err: e }, 'Readiness preflight threw; continuing with launch attempt');\n        }\n      }\n\n      // ─── inspect ────────────────────────────────────────────────────────\n      if (mode === 'inspect') {\n        const mgr = deps.getManager();\n        await mgr.ensureConnected();\n        const ext = mgr.getExtensionProvider();\n        if (ext) {\n          const timeout = deps.getConfig?.()?.agents?.defaults?.browser?.commandTimeout;\n          const timeoutMs =\n            typeof timeout === 'number' && Number.isFinite(timeout) && timeout > 0\n              ? Math.floor(timeout * 1000)\n              : 30_000;\n          const urlRes = await ext.sendCommand('get_url', {}, { timeout: timeoutMs });\n          const titleRes = await ext.sendCommand('get_title', {}, { timeout: timeoutMs });\n          const snapRes = await ext.sendCommand('snapshot', {}, { timeout: timeoutMs });\n          const url = urlRes.ok && urlRes.data ? String((urlRes.data as { url?: string }).url ?? '') : '';\n          const title =\n            titleRes.ok && titleRes.data ? String((titleRes.data as { title?: string }).title ?? '') : '';\n          let snapText = '';\n          if (snapRes.ok && snapRes.data) {\n            const nodes = (snapRes.data as { nodes?: Array<{ role?: string; name?: string }> }).nodes ?? [];\n            snapText = nodes.map((n) => `${n.role ?? '?'}: ${n.name ?? ''}`).join('\\n');\n            if (snapText.length > 8000) snapText = `${snapText.slice(0, 8000)}\\n... (truncated)`;\n          }\n          const text = `URL: ${url}\\nTitle: ${title}\\n${snapText ? `--- Page Snapshot ---\\n${snapText}` : ''}`;\n          return {\n            content: [{ type: 'text', text }],\n            details: { ok: true, mode: 'inspect', url, title },\n          };\n        }\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n        const result = await registry.execute('state', ctx, {});\n        // Augment with URL / title\n        const url = page.url();\n        const title = await page.title().catch(() => '');\n        const text = `URL: ${url}\\nTitle: ${title}\\n${result.text ?? ''}`;\n        return {\n          content: [{ type: 'text', text }],\n          details: { ok: true, mode: 'inspect', url, title },\n        };\n      }\n\n      // ─── close ──────────────────────────────────────────────────────────\n      if (mode === 'close') {\n        const taskId = deps.getTaskId();\n        await deps.getManager().ensureConnected();\n        await deps.getManager().closePage(taskId);\n        deps.notifyBrowserPageClosed?.(taskId);\n        return {\n          content: [{ type: 'text', text: 'Browser page closed.' }],\n          details: { ok: true, mode: 'close' },\n        };\n      }\n\n      // ─── command ────────────────────────────────────────────────────────\n      if (mode === 'command') {\n        if (!command) {\n          return {\n            content: [{ type: 'text', text: 'Missing `command` parameter for command mode.' }],\n            details: { ok: false, mode: 'command' },\n          };\n        }\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n        const args = cmdArgs ?? {};\n        const result = await registry.execute(command, ctx, args);\n        return formatResult(result);\n      }\n\n      // ─── pipeline ──────────────────────────────────────────────────────\n      if (mode === 'pipeline') {\n        if (!pipelineParams) {\n          return {\n            content: [{ type: 'text', text: 'Missing `pipeline` parameter for pipeline mode.' }],\n            details: { ok: false, mode: 'pipeline' },\n          };\n        }\n\n        let yamlSource = pipelineParams.yaml ?? '';\n        let sourceLocation: string | undefined;\n\n        if (!yamlSource && pipelineParams.path) {\n          try {\n            const loaded = await loadBrowserPipelineSource(pipelineParams.path);\n            yamlSource = loaded.source;\n            sourceLocation = loaded.location;\n          } catch (e) {\n            const msg = e instanceof Error ? e.message : String(e);\n            return {\n              content: [{ type: 'text', text: `Failed to read pipeline source: ${msg}` }],\n              details: { ok: false, mode: 'pipeline', error: msg },\n            };\n          }\n        }\n\n        if (!yamlSource) {\n          return {\n            content: [{ type: 'text', text: 'Pipeline mode requires `yaml`, `script`, or `path`.' }],\n            details: { ok: false, mode: 'pipeline' },\n          };\n        }\n\n        const pipelineArgs = (pipelineParams.args as Record<string, unknown>) ?? {};\n        const dryRun = pipelineParams.dryRun === true;\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n\n        // Use injected runner or lazy-load\n        if (deps.runPipeline) {\n          const result = await deps.runPipeline(yamlSource, pipelineArgs, ctx, { dryRun, sourceLocation });\n          return formatResult(result);\n        }\n\n        // Lazy import pipeline runner\n        try {\n          const { runBrowserPipeline } = await import('../../../../browser/pipeline/runner.js');\n          const result = await runBrowserPipeline(yamlSource, pipelineArgs, ctx, registry, { dryRun, sourceLocation });\n          return formatResult(result);\n        } catch (e) {\n          const msg = e instanceof Error ? e.message : String(e);\n          log.error({ err: e }, `Pipeline execution failed: ${msg}`);\n          return {\n            content: [{ type: 'text', text: `Pipeline failed: ${msg}` }],\n            details: { ok: false, mode: 'pipeline', error: msg },\n          };\n        }\n      }\n\n      return {\n        content: [{ type: 'text', text: `Unknown mode: ${mode}` }],\n        details: { ok: false },\n      };\n    },\n  };\n  return tool;\n}\n"],"mappings":"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"}
+{"version":3,"file":"browser-use-tool.js","names":[],"sources":["../../../../../../src/agent/tools/browser/tool/browser-use-tool.ts"],"sourcesContent":["/**\n * browser_use — unified browser AgentTool.\n *\n * Modes: command | pipeline | inspect | close.\n * Replaces the 14 fine-grained browser_* tools with a single entry point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { createLogger } from '../../../../utils/logger.js';\nimport type { Config } from '../../../../config/schema.js';\nimport type { BrowserManager } from '../../../../browser/manager.js';\nimport type { CdpSupervisor } from '../../../../browser/cdp-supervisor.js';\nimport type { Page } from 'playwright-core';\n\nimport { BrowserUseSchema } from './schemas.js';\nimport { createBrowserActionRegistry } from '../../../../browser/actions/registry.js';\nimport type { BrowserActionContext, BrowserActionResult } from '../../../../browser/actions/types.js';\nimport { loadBrowserPipelineSource } from '../../../../browser/pipeline/source.js';\nimport type { BrowserNotReadyError, BrowserSetupHint } from '../../../../browser/readiness.js';\n\nconst log = createLogger('Agent:BrowserUse');\n\nexport interface CreateBrowserUseToolDeps {\n  getManager: () => BrowserManager;\n  getPageForTask: () => Promise<Page>;\n  getTaskId: () => string;\n  getConfig: () => Config | undefined;\n  getSupervisor?: () => CdpSupervisor | undefined;\n  notifyBrowserPageClosed?: (taskId: string) => void;\n  /**\n   * Preflight readiness check. Returns `null` when the configured backend is\n   * usable, otherwise a structured hint the chat surface renders as a setup\n   * card. Cache the result upstream (~30s) so back-to-back calls don't reprobe.\n   */\n  getReadiness?: () => Promise<BrowserNotReadyError | null>;\n  /** Pipeline runner (injected to avoid circular deps; lazy-loaded if not provided). */\n  runPipeline?: (\n    yaml: string,\n    args: Record<string, unknown>,\n    ctx: BrowserActionContext,\n    options: { dryRun?: boolean; sourceLocation?: string },\n  ) => Promise<BrowserActionResult>;\n}\n\nexport function createBrowserUseTool(deps: CreateBrowserUseToolDeps): AgentTool<any, any> {\n  const registry = createBrowserActionRegistry();\n\n  function buildContext(page: Page, signal?: AbortSignal): BrowserActionContext {\n    return {\n      page,\n      manager: deps.getManager(),\n      config: deps.getConfig(),\n      taskId: deps.getTaskId(),\n      supervisor: deps.getSupervisor?.(),\n      signal,\n    };\n  }\n\n  /**\n   * Render a {@link BrowserSetupHint} as a tool result. The text body is a\n   * JSON envelope (`kind: 'browser_setup_required'`) so the chat surface can\n   * detect it and render a Setup card; the embedded `message` keeps the\n   * payload human-readable for the LLM so it stops the browser attempt and\n   * tells the user to finish setup.\n   */\n  function formatNotReady(hint: BrowserSetupHint): { content: { type: 'text'; text: string }[]; details: Record<string, unknown> } {\n    const message =\n      `⚠ Browser is not ready (backend=${hint.backend}, reason=${hint.reason}). ` +\n      `Do NOT retry. Tell the user to open Settings → Browser to finish setup, ` +\n      `then ask them to confirm before running any browser action again.`;\n    const payload = {\n      kind: 'browser_setup_required' as const,\n      backend: hint.backend,\n      reason: hint.reason,\n      deepLink: hint.deepLink,\n      detail: hint.detail,\n      message,\n    };\n    return {\n      content: [{ type: 'text', text: JSON.stringify(payload) }],\n      details: {\n        ok: false,\n        kind: 'browser_setup_required',\n        backend: hint.backend,\n        reason: hint.reason,\n        deepLink: hint.deepLink,\n      },\n    };\n  }\n\n  function formatResult(result: BrowserActionResult): { content: { type: 'text'; text: string }[]; details: Record<string, unknown> } {\n    if (result.ok) {\n      const parts: string[] = [];\n      if (result.text) parts.push(result.text);\n      if (result.data && !result.text) parts.push(JSON.stringify(result.data, null, 2));\n      return {\n        content: [{ type: 'text', text: parts.join('\\n') || 'OK' }],\n        details: { ok: true, action: result.action, ...(result.artifacts?.length ? { artifacts: result.artifacts.length } : {}) },\n      };\n    }\n    const parts: string[] = [];\n    if (result.error) parts.push(`[${result.error.code}] ${result.error.message}`);\n    if (result.diagnostics?.url) parts.push(`URL: ${result.diagnostics.url}`);\n    if (result.diagnostics?.snapshot) parts.push(`Snapshot: ${result.diagnostics.snapshot.slice(0, 2000)}`);\n    return {\n      content: [{ type: 'text', text: parts.join('\\n') || 'Failed' }],\n      details: { ok: false, action: result.action, error: result.error },\n    };\n  }\n\n  const tool: any = {\n    name: 'browser_use',\n    label: '🌐 Browser',\n    description:\n      'Use a persistent browser for web navigation, page inspection, interaction, screenshots, network capture, and scripted browser pipelines. For non-trivial browser tasks, load the built-in manual first with tool_manual({ tool: \"browser_use\" }).',\n    parameters: BrowserUseSchema,\n\n    async execute(_toolCallId, params: any, signal, _onUpdate) {\n      const { mode, command, args: cmdArgs, pipeline: pipelineParams, options: _options } = params as {\n        mode: string;\n        command?: string;\n        args?: Record<string, unknown>;\n        pipeline?: { yaml?: string; path?: string; args?: Record<string, unknown>; dryRun?: boolean };\n        options?: { timeout?: number; headless?: boolean };\n      };\n\n      // ─── readiness preflight ────────────────────────────────────────────\n      // Probes the configured backend (doctor + WS bridge / CDP / cloud key)\n      // before any launch attempt. On failure we short-circuit with a setup\n      // hint the chat renders as a card — the agent should stop and ask the\n      // user to finish setup instead of looping on launch errors.\n      if (deps.getReadiness) {\n        try {\n          const notReady = await deps.getReadiness();\n          if (notReady) {\n            return formatNotReady(notReady.hint);\n          }\n        } catch (e) {\n          log.warn({ err: e }, 'Readiness preflight threw; continuing with launch attempt');\n        }\n      }\n\n      // ─── inspect ────────────────────────────────────────────────────────\n      if (mode === 'inspect') {\n        const mgr = deps.getManager();\n        await mgr.ensureConnected();\n        const ext = mgr.getExtensionProvider();\n        if (ext) {\n          const timeoutMs = 30_000;\n          const urlRes = await ext.sendCommand('get_url', {}, { timeout: timeoutMs });\n          const titleRes = await ext.sendCommand('get_title', {}, { timeout: timeoutMs });\n          const snapRes = await ext.sendCommand('snapshot', {}, { timeout: timeoutMs });\n          const url = urlRes.ok && urlRes.data ? String((urlRes.data as { url?: string }).url ?? '') : '';\n          const title =\n            titleRes.ok && titleRes.data ? String((titleRes.data as { title?: string }).title ?? '') : '';\n          let snapText = '';\n          if (snapRes.ok && snapRes.data) {\n            const nodes = (snapRes.data as { nodes?: Array<{ role?: string; name?: string }> }).nodes ?? [];\n            snapText = nodes.map((n) => `${n.role ?? '?'}: ${n.name ?? ''}`).join('\\n');\n            if (snapText.length > 8000) snapText = `${snapText.slice(0, 8000)}\\n... (truncated)`;\n          }\n          const text = `URL: ${url}\\nTitle: ${title}\\n${snapText ? `--- Page Snapshot ---\\n${snapText}` : ''}`;\n          return {\n            content: [{ type: 'text', text }],\n            details: { ok: true, mode: 'inspect', url, title },\n          };\n        }\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n        const result = await registry.execute('state', ctx, {});\n        // Augment with URL / title\n        const url = page.url();\n        const title = await page.title().catch(() => '');\n        const text = `URL: ${url}\\nTitle: ${title}\\n${result.text ?? ''}`;\n        return {\n          content: [{ type: 'text', text }],\n          details: { ok: true, mode: 'inspect', url, title },\n        };\n      }\n\n      // ─── close ──────────────────────────────────────────────────────────\n      if (mode === 'close') {\n        const taskId = deps.getTaskId();\n        await deps.getManager().ensureConnected();\n        await deps.getManager().closePage(taskId);\n        deps.notifyBrowserPageClosed?.(taskId);\n        return {\n          content: [{ type: 'text', text: 'Browser page closed.' }],\n          details: { ok: true, mode: 'close' },\n        };\n      }\n\n      // ─── command ────────────────────────────────────────────────────────\n      if (mode === 'command') {\n        if (!command) {\n          return {\n            content: [{ type: 'text', text: 'Missing `command` parameter for command mode.' }],\n            details: { ok: false, mode: 'command' },\n          };\n        }\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n        const args = cmdArgs ?? {};\n        const result = await registry.execute(command, ctx, args);\n        return formatResult(result);\n      }\n\n      // ─── pipeline ──────────────────────────────────────────────────────\n      if (mode === 'pipeline') {\n        if (!pipelineParams) {\n          return {\n            content: [{ type: 'text', text: 'Missing `pipeline` parameter for pipeline mode.' }],\n            details: { ok: false, mode: 'pipeline' },\n          };\n        }\n\n        let yamlSource = pipelineParams.yaml ?? '';\n        let sourceLocation: string | undefined;\n\n        if (!yamlSource && pipelineParams.path) {\n          try {\n            const loaded = await loadBrowserPipelineSource(pipelineParams.path);\n            yamlSource = loaded.source;\n            sourceLocation = loaded.location;\n          } catch (e) {\n            const msg = e instanceof Error ? e.message : String(e);\n            return {\n              content: [{ type: 'text', text: `Failed to read pipeline source: ${msg}` }],\n              details: { ok: false, mode: 'pipeline', error: msg },\n            };\n          }\n        }\n\n        if (!yamlSource) {\n          return {\n            content: [{ type: 'text', text: 'Pipeline mode requires `yaml`, `script`, or `path`.' }],\n            details: { ok: false, mode: 'pipeline' },\n          };\n        }\n\n        const pipelineArgs = (pipelineParams.args as Record<string, unknown>) ?? {};\n        const dryRun = pipelineParams.dryRun === true;\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n\n        // Use injected runner or lazy-load\n        if (deps.runPipeline) {\n          const result = await deps.runPipeline(yamlSource, pipelineArgs, ctx, { dryRun, sourceLocation });\n          return formatResult(result);\n        }\n\n        // Lazy import pipeline runner\n        try {\n          const { runBrowserPipeline } = await import('../../../../browser/pipeline/runner.js');\n          const result = await runBrowserPipeline(yamlSource, pipelineArgs, ctx, registry, { dryRun, sourceLocation });\n          return formatResult(result);\n        } catch (e) {\n          const msg = e instanceof Error ? e.message : String(e);\n          log.error({ err: e }, `Pipeline execution failed: ${msg}`);\n          return {\n            content: [{ type: 'text', text: `Pipeline failed: ${msg}` }],\n            details: { ok: false, mode: 'pipeline', error: msg },\n          };\n        }\n      }\n\n      return {\n        content: [{ type: 'text', text: `Unknown mode: ${mode}` }],\n        details: { ok: false },\n      };\n    },\n  };\n  return tool;\n}\n"],"mappings":"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"}

package/dist/src/agent/tools/curated-memory-tool.d.ts

@@ -1,6 +1,3 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
-import type { BuiltinMemoryStore } from '../memory/builtin-memory-store.js';
-export interface CuratedMemoryToolOptions {
-    onMemoryWrite?: (action: 'add' | 'replace' | 'remove', target: 'memory' | 'user', content: string) => void;
-}
-export declare function createCuratedMemoryTool(getStore: () => BuiltinMemoryStore, options?: CuratedMemoryToolOptions): AgentTool;
+import type { MemoryManager } from '../memory/manager.js';
+export declare function createCuratedMemoryTool(getMemoryManager: () => MemoryManager): AgentTool;

package/dist/src/agent/tools/curated-memory-tool.js

@@ -3,33 +3,49 @@ import { Type } from "@sinclair/typebox";
 const CuratedMemorySchema = Type.Object({
 	action: Type.Union([
 		Type.Literal("add"),
+		Type.Literal("propose"),
 		Type.Literal("replace"),
 		Type.Literal("remove"),
 		Type.Literal("read")
 	]),
 	target: Type.Union([Type.Literal("memory"), Type.Literal("user")]),
+	kind: Type.Optional(Type.Union([
+		Type.Literal("user_profile"),
+		Type.Literal("agent_note"),
+		Type.Literal("workspace_fact"),
+		Type.Literal("daily_note"),
+		Type.Literal("session_summary"),
+		Type.Literal("derived_insight"),
+		Type.Literal("task_lesson"),
+		Type.Literal("tool_preference"),
+		Type.Literal("long_term_goal")
+	])),
+	sensitivity: Type.Optional(Type.Union([
+		Type.Literal("normal"),
+		Type.Literal("personal"),
+		Type.Literal("secret"),
+		Type.Literal("regulated")
+	])),
+	confidence: Type.Optional(Type.Number({
+		minimum: 0,
+		maximum: 1
+	})),
+	source_text: Type.Optional(Type.String({ description: "Short evidence excerpt supporting a proposed memory." })),
 	content: Type.Optional(Type.String({ description: "Required for add; new text for replace." })),
 	old_text: Type.Optional(Type.String({ description: "Substring to match one entry for replace/remove." }))
 });
-function createCuratedMemoryTool(getStore, options) {
+function createCuratedMemoryTool(getMemoryManager) {
 	return {
 		name: "curated_memory",
-		label: "🧠 Curated memory",
-		description: "Read or edit bounded curated memory under agent home `memories/` (MEMORY.md = agent notes, USER.md = user profile). Entries are separated by a section-sign delimiter (see store format). System prompt shows a frozen snapshot from session start; this tool reads/writes live state on disk. Use add/replace/remove for structured updates; use read to inspect current entries.",
+		label: "Curated memory",
+		description: "Read, edit, or propose bounded curated memory (MEMORY.md = agent notes, user/MEMORY.md = global user memory). Use propose when a memory should be reviewed by the user before it becomes active recall context. Entries are separated by a section-sign delimiter (see store format). System prompt shows a frozen snapshot from session start; this tool reads/writes live state on disk. Use add/replace/remove for structured updates; use read to inspect current entries.",
 		parameters: CuratedMemorySchema,
 		async execute(_toolCallId, params, _signal) {
-			const store = getStore();
+			const memoryManager = getMemoryManager();
 			const { action, target } = params;
 			try {
-				if (target === "user" && !store.isUserProfileEnabled() && action !== "read") return {
-					content: [{
-						type: "text",
-						text: "User profile (USER.md) is disabled in config (`agents.defaults.memory.userProfileEnabled`)."
-					}],
-					details: { error: "user_profile_disabled" }
-				};
 				if (action === "read") {
-					const entries = store.getLiveEntries(target);
+					const entries = (await memoryManager.list({ target })).map((record) => record.content);
 					return {
 						content: [{
 							type: "text",
@@ -44,7 +60,11 @@ function createCuratedMemoryTool(getStore, options) {
 				}
 				if (action === "add") {
 					const content = params.content?.trim() ?? "";
-					const result = await store.add(target, content);
+					const result = await memoryManager.write({
+						kind: target === "user" ? "user_profile" : "agent_note",
+						target,
+						content
+					});
 					if (!result.success) return {
 						content: [{
 							type: "text",
@@ -52,7 +72,7 @@ function createCuratedMemoryTool(getStore, options) {
 						}],
 						details: { error: result.error }
 					};
-					options?.onMemoryWrite?.("add", target, content);
+					memoryManager.onMemoryWrite("add", target, content);
 					return {
 						content: [{
 							type: "text",
@@ -61,10 +81,46 @@ function createCuratedMemoryTool(getStore, options) {
 						details: { success: true }
 					};
 				}
+				if (action === "propose") {
+					const p = params;
+					const content = p.content?.trim() ?? "";
+					const sourceText = p.source_text?.trim();
+					const result = await memoryManager.write({
+						kind: p.kind ?? (target === "user" ? "user_profile" : "agent_note"),
+						target,
+						content,
+						status: "candidate",
+						sensitivity: p.sensitivity ?? (target === "user" ? "personal" : "normal"),
+						confidence: p.confidence,
+						evidence: sourceText ? [{ sourceText }] : void 0
+					});
+					if (!result.success) return {
+						content: [{
+							type: "text",
+							text: result.error ?? "Unknown error"
+						}],
+						details: { error: result.error }
+					};
+					return {
+						content: [{
+							type: "text",
+							text: result.message ?? "Memory candidate added to inbox"
+						}],
+						details: {
+							success: true,
+							recordId: result.record?.id,
+							status: result.record?.status
+						}
+					};
+				}
 				if (action === "replace") {
 					const oldText = params.old_text?.trim() ?? "";
 					const newContent = params.content?.trim() ?? "";
-					const result = await store.replace(target, oldText, newContent);
+					const result = await memoryManager.update({
+						target,
+						matchText: oldText,
+						content: newContent
+					});
 					if (!result.success) return {
 						content: [{
 							type: "text",
@@ -72,7 +128,7 @@ function createCuratedMemoryTool(getStore, options) {
 						}],
 						details: { error: result.error }
 					};
-					options?.onMemoryWrite?.("replace", target, newContent);
+					memoryManager.onMemoryWrite("replace", target, newContent);
 					return {
 						content: [{
 							type: "text",
@@ -82,7 +138,10 @@ function createCuratedMemoryTool(getStore, options) {
 					};
 				}
 				const oldText = params.old_text?.trim() ?? "";
-				const result = await store.remove(target, oldText);
+				const result = await memoryManager.delete({
+					target,
+					matchText: oldText
+				});
 				if (!result.success) return {
 					content: [{
 						type: "text",
@@ -90,7 +149,7 @@ function createCuratedMemoryTool(getStore, options) {
 					}],
 					details: { error: result.error }
 				};
-				options?.onMemoryWrite?.("remove", target, oldText);
+				memoryManager.onMemoryWrite("remove", target, oldText);
 				return {
 					content: [{
 						type: "text",

package/dist/src/agent/tools/curated-memory-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"curated-memory-tool.js","names":[],"sources":["../../../../src/agent/tools/curated-memory-tool.ts"],"sourcesContent":["// Curated memory tool — agent home `memories/MEMORY.md` + `USER.md` (session snapshot + live edits)\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport type { BuiltinMemoryStore } from '../memory/builtin-memory-store.js';\n\nexport interface CuratedMemoryToolOptions {\n  onMemoryWrite?: (\n    action: 'add' | 'replace' | 'remove',\n    target: 'memory' | 'user',\n    content: string,\n  ) => void;\n}\n\nconst CuratedMemorySchema = Type.Object({\n  action: Type.Union([\n    Type.Literal('add'),\n    Type.Literal('replace'),\n    Type.Literal('remove'),\n    Type.Literal('read'),\n  ]),\n  target: Type.Union([Type.Literal('memory'), Type.Literal('user')]),\n  content: Type.Optional(Type.String({ description: 'Required for add; new text for replace.' })),\n  old_text: Type.Optional(\n    Type.String({ description: 'Substring to match one entry for replace/remove.' }),\n  ),\n});\n\ntype CuratedMemoryParams = {\n  action: 'add' | 'replace' | 'remove' | 'read';\n  target: 'memory' | 'user';\n  content?: string;\n  old_text?: string;\n};\n\nexport function createCuratedMemoryTool(\n  getStore: () => BuiltinMemoryStore,\n  options?: CuratedMemoryToolOptions,\n): AgentTool {\n  return {\n    name: 'curated_memory',\n    label: '🧠 Curated memory',\n    description:\n      'Read or edit bounded curated memory under agent home `memories/` (MEMORY.md = agent notes, USER.md = user profile). Entries are separated by a section-sign delimiter (see store format). System prompt shows a frozen snapshot from session start; this tool reads/writes live state on disk. Use add/replace/remove for structured updates; use read to inspect current entries.',\n    parameters: CuratedMemorySchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const store = getStore();\n      const { action, target } = params as CuratedMemoryParams;\n\n      try {\n        if (target === 'user' && !store.isUserProfileEnabled() && action !== 'read') {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: 'User profile (USER.md) is disabled in config (`agents.defaults.memory.userProfileEnabled`).',\n              },\n            ],\n            details: { error: 'user_profile_disabled' },\n          };\n        }\n\n        if (action === 'read') {\n          const entries = store.getLiveEntries(target);\n          const text = JSON.stringify(\n            { target, entries, count: entries.length },\n            null,\n            2,\n          );\n          return {\n            content: [{ type: 'text', text }],\n            details: { entries },\n          };\n        }\n\n        if (action === 'add') {\n          const content = (params as CuratedMemoryParams).content?.trim() ?? '';\n          const result = await store.add(target, content);\n          if (!result.success) {\n            return {\n              content: [{ type: 'text', text: result.error ?? 'Unknown error' }],\n              details: { error: result.error },\n            };\n          }\n          options?.onMemoryWrite?.('add', target, content);\n          return {\n            content: [{ type: 'text', text: result.message ?? 'OK' }],\n            details: { success: true },\n          };\n        }\n\n        if (action === 'replace') {\n          const oldText = (params as CuratedMemoryParams).old_text?.trim() ?? '';\n          const newContent = (params as CuratedMemoryParams).content?.trim() ?? '';\n          const result = await store.replace(target, oldText, newContent);\n          if (!result.success) {\n            return {\n              content: [{ type: 'text', text: result.error ?? 'Unknown error' }],\n              details: { error: result.error },\n            };\n          }\n          options?.onMemoryWrite?.('replace', target, newContent);\n          return {\n            content: [{ type: 'text', text: result.message ?? 'OK' }],\n            details: { success: true },\n          };\n        }\n\n        const oldText = (params as CuratedMemoryParams).old_text?.trim() ?? '';\n        const result = await store.remove(target, oldText);\n        if (!result.success) {\n          return {\n            content: [{ type: 'text', text: result.error ?? 'Unknown error' }],\n            details: { error: result.error },\n          };\n        }\n        options?.onMemoryWrite?.('remove', target, oldText);\n        return {\n          content: [{ type: 'text', text: result.message ?? 'OK' }],\n          details: { success: true },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `curated_memory error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}
+{"version":3,"file":"curated-memory-tool.js","names":[],"sources":["../../../../src/agent/tools/curated-memory-tool.ts"],"sourcesContent":["// Curated memory tool — agent home `memories/MEMORY.md` + global `user/MEMORY.md` (session snapshot + live edits)\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport type { MemoryManager } from '../memory/manager.js';\n\nconst CuratedMemorySchema = Type.Object({\n  action: Type.Union([\n    Type.Literal('add'),\n    Type.Literal('propose'),\n    Type.Literal('replace'),\n    Type.Literal('remove'),\n    Type.Literal('read'),\n  ]),\n  target: Type.Union([Type.Literal('memory'), Type.Literal('user')]),\n  kind: Type.Optional(Type.Union([\n    Type.Literal('user_profile'),\n    Type.Literal('agent_note'),\n    Type.Literal('workspace_fact'),\n    Type.Literal('daily_note'),\n    Type.Literal('session_summary'),\n    Type.Literal('derived_insight'),\n    Type.Literal('task_lesson'),\n    Type.Literal('tool_preference'),\n    Type.Literal('long_term_goal'),\n  ])),\n  sensitivity: Type.Optional(Type.Union([\n    Type.Literal('normal'),\n    Type.Literal('personal'),\n    Type.Literal('secret'),\n    Type.Literal('regulated'),\n  ])),\n  confidence: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),\n  source_text: Type.Optional(Type.String({ description: 'Short evidence excerpt supporting a proposed memory.' })),\n  content: Type.Optional(Type.String({ description: 'Required for add; new text for replace.' })),\n  old_text: Type.Optional(\n    Type.String({ description: 'Substring to match one entry for replace/remove.' }),\n  ),\n});\n\ntype CuratedMemoryParams = {\n  action: 'add' | 'propose' | 'replace' | 'remove' | 'read';\n  target: 'memory' | 'user';\n  kind?: 'user_profile' | 'agent_note' | 'workspace_fact' | 'daily_note' | 'session_summary' | 'derived_insight' | 'task_lesson' | 'tool_preference' | 'long_term_goal';\n  sensitivity?: 'normal' | 'personal' | 'secret' | 'regulated';\n  confidence?: number;\n  source_text?: string;\n  content?: string;\n  old_text?: string;\n};\n\nexport function createCuratedMemoryTool(\n  getMemoryManager: () => MemoryManager,\n): AgentTool {\n  return {\n    name: 'curated_memory',\n    label: 'Curated memory',\n    description:\n      'Read, edit, or propose bounded curated memory (MEMORY.md = agent notes, user/MEMORY.md = global user memory). Use propose when a memory should be reviewed by the user before it becomes active recall context. Entries are separated by a section-sign delimiter (see store format). System prompt shows a frozen snapshot from session start; this tool reads/writes live state on disk. Use add/replace/remove for structured updates; use read to inspect current entries.',\n    parameters: CuratedMemorySchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const memoryManager = getMemoryManager();\n      const { action, target } = params as CuratedMemoryParams;\n\n      try {\n        if (action === 'read') {\n          const records = await memoryManager.list({ target });\n          const entries = records.map((record) => record.content);\n          const text = JSON.stringify(\n            { target, entries, count: entries.length },\n            null,\n            2,\n          );\n          return {\n            content: [{ type: 'text', text }],\n            details: { entries },\n          };\n        }\n\n        if (action === 'add') {\n          const content = (params as CuratedMemoryParams).content?.trim() ?? '';\n          const result = await memoryManager.write({\n            kind: target === 'user' ? 'user_profile' : 'agent_note',\n            target,\n            content,\n          });\n          if (!result.success) {\n            return {\n              content: [{ type: 'text', text: result.error ?? 'Unknown error' }],\n              details: { error: result.error },\n            };\n          }\n          memoryManager.onMemoryWrite('add', target, content);\n          return {\n            content: [{ type: 'text', text: result.message ?? 'OK' }],\n            details: { success: true },\n          };\n        }\n\n        if (action === 'propose') {\n          const p = params as CuratedMemoryParams;\n          const content = p.content?.trim() ?? '';\n          const sourceText = p.source_text?.trim();\n          const result = await memoryManager.write({\n            kind: p.kind ?? (target === 'user' ? 'user_profile' : 'agent_note'),\n            target,\n            content,\n            status: 'candidate',\n            sensitivity: p.sensitivity ?? (target === 'user' ? 'personal' : 'normal'),\n            confidence: p.confidence,\n            evidence: sourceText ? [{ sourceText }] : undefined,\n          });\n          if (!result.success) {\n            return {\n              content: [{ type: 'text', text: result.error ?? 'Unknown error' }],\n              details: { error: result.error },\n            };\n          }\n          return {\n            content: [{ type: 'text', text: result.message ?? 'Memory candidate added to inbox' }],\n            details: { success: true, recordId: result.record?.id, status: result.record?.status },\n          };\n        }\n\n        if (action === 'replace') {\n          const oldText = (params as CuratedMemoryParams).old_text?.trim() ?? '';\n          const newContent = (params as CuratedMemoryParams).content?.trim() ?? '';\n          const result = await memoryManager.update({ target, matchText: oldText, content: newContent });\n          if (!result.success) {\n            return {\n              content: [{ type: 'text', text: result.error ?? 'Unknown error' }],\n              details: { error: result.error },\n            };\n          }\n          memoryManager.onMemoryWrite('replace', target, newContent);\n          return {\n            content: [{ type: 'text', text: result.message ?? 'OK' }],\n            details: { success: true },\n          };\n        }\n\n        const oldText = (params as CuratedMemoryParams).old_text?.trim() ?? '';\n        const result = await memoryManager.delete({ target, matchText: oldText });\n        if (!result.success) {\n          return {\n            content: [{ type: 'text', text: result.error ?? 'Unknown error' }],\n            details: { error: result.error },\n          };\n        }\n        memoryManager.onMemoryWrite('remove', target, oldText);\n        return {\n          content: [{ type: 'text', text: result.message ?? 'OK' }],\n          details: { success: true },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `curated_memory error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\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.d.ts

@@ -10,7 +10,6 @@ import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { Model, Api } from '@earendil-works/pi-ai';
 import type { Config } from '../../config/schema.js';
 import type { MessageBus } from '../../infra/bus/index.js';
-import type { BuiltinMemoryStore } from '../memory/builtin-memory-store.js';
 import type { MemoryManager } from '../memory/manager.js';
 import type { SessionStore } from '../../session/store.js';
 import type { GatewayClarifyRequestFn } from './clarify-tool.js';
@@ -33,8 +32,6 @@ export interface ToolFactoryDeps {
     getConfig?: () => Config | undefined;
     /** Session / default chat model for vision tool description. */
     getPrimaryModel?: () => Model<Api>;
-    /** Built-in curated memory store (agent home `memories/`). */
-    getBuiltinMemoryStore?: () => BuiltinMemoryStore;
     /** Memory orchestration (prefetch/sync + external tools). */
     getMemoryManager?: () => MemoryManager;
     /** Session store for `session_search`. */
@@ -68,7 +65,6 @@ export interface CreateCoreToolsOptions {
     disabledTools?: Set<string>;
     /** Optional primary model for image tool heuristics. */
     getPrimaryModel?: () => Model<Api>;
-    getBuiltinMemoryStore?: () => BuiltinMemoryStore;
     getMemoryManager?: () => MemoryManager;
     /** When set, registers `skills_list` and `skill_view` bound to this workspace\'s skills. */
     getSkillManager?: () => SkillManager;