@selesai/code 0.5.29 → 0.6.1

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to `@selesai/code` will be documented in this file.
+
+## [Unreleased]
+
+## [0.6.1] - 2026-08-05
+
+### Added
+- **Delegation contract and dynamic agent catalog.** `subagent({ action: "list" })` now exposes the runtime-resolved catalog as human text — executable/restricted status, source, aliases, role, normalized context, declared tools, and description — and as versioned machine metadata (`details.catalog` with `version`, `agents`, and `chains`). Delegation targets are selected from live discovery, not static prompt text.
+- **Task-aware advisory routing.** An optional `task` on `action: "list"` appends a text-only recommendation for one canonical agent (implementation or read-only) based on the task intent, declared/inferred roles, and write-tool safety, or recovery guidance when intent is unknown or no safe candidate exists. The advice never launches, schedules, or persists work; execution remains an explicit separate call with the recommended canonical agent name.
+- **Reference-first delegated results.** Normal completion now returns saved-output references plus status/lifecycle information instead of child prose. Full output is inspected through the saved output path, async status/transcript, or `resume`. Explicit `outputMode: "inline"` restores legacy full-output delivery, `output: false` disables durable output persistence with a bounded fallback, and per-child debug artifacts remain opt-in via `artifacts: true`.
+- **Always-visible delegation guidance.** Default and custom system prompts now carry the active-tool delegation contract: inspect the delegation catalog before selecting, keep tiny targeted reads and simple answers local, delegate broad local investigation, external research, and mutation/implementation work, and keep the parent as decision-maker and normally the sole writer.
+
+### Changed
+- The parent `subagent` tool description now requires catalog-first, executable-only agent selection and no longer hardcodes bundled agent names in management examples; the routing contract is embedded in mandatory safety guidance so custom descriptions cannot remove it.
+- Bundled agents now declare accurate descriptions and `acceptanceRole` (`writer` for `builder`, `read-only` for the advisory roles) so catalog output communicates routing capability without granting tools.
+
+### Fixed
+- Corrected impossible and stale bundled-agent contracts: the architect no longer relies on unavailable question/subagent tools, the builder's `contact_supervisor` use is conditional on bridge-injected instructions, and the researcher's grep.app tools are declared as MCP tools.
+- Aligned bundled-agent documentation with runtime: exactly six builtin roles with accurate fresh/fork context defaults (only `architect` and `recapper` fork; `builder`, `commentator`, `explorer`, and `researcher` are fresh) and `.selesai` discovery paths instead of stale `.pi` references.
+
+### Not included
+- Phase 4 of the subagent-delegation program (optional enforcement of delegation policy) is intentionally omitted from 0.6.1. Routing remains advisory, and launch-time preflight remains the enforcement point.

package/README.md

@@ -124,7 +124,7 @@ Selesai also bundles small extensions that solve common coding-agent failures:
 
 Skills are shipped with Selesai and loaded at boot. They include:
 
-- `ponytail` and `caveman` for minimal and compressed communication modes
+- `ponytail` for minimal implementation mode and review helpers
 - `grill-me` for requirement and design stress-testing
 - `planger` and `implanger` for decomposed planning and execution
 - `handoff` and `handoff-text` for session continuity

package/dist/core/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACxC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,yBAAyB;IACzB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,oCAAoC;IACpC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CA6I3E","sourcesContent":["/**\n * System prompt construction and project context loading\n */\n\nimport { getDocsPath, getExamplesPath, getReadmePath } from \"../config.ts\";\nimport { formatAgentsForPrompt, type AgentPersona } from \"./agents.ts\";\nimport { formatSkillsForPrompt, type Skill } from \"./skills.ts\";\n\nexport interface BuildSystemPromptOptions {\n\t/** Custom system prompt (replaces default). */\n\tcustomPrompt?: string;\n\t/** Tools to include in prompt. Default: [read, bash, edit, write] */\n\tselectedTools?: string[];\n\t/** Optional one-line tool snippets keyed by tool name. */\n\ttoolSnippets?: Record<string, string>;\n\t/** Additional guideline bullets appended to the default system prompt guidelines. */\n\tpromptGuidelines?: string[];\n\t/** Text to append to system prompt. */\n\tappendSystemPrompt?: string;\n\t/** Working directory. */\n\tcwd: string;\n\t/** Pre-loaded context files. */\n\tcontextFiles?: Array<{ path: string; content: string }>;\n\t/** Pre-loaded skills. */\n\tskills?: Skill[];\n\t/** Pre-loaded subagent personas. */\n\tagents?: AgentPersona[];\n}\n\n/** Build the system prompt with tools, guidelines, and context */\nexport function buildSystemPrompt(options: BuildSystemPromptOptions): string {\n\tconst {\n\t\tcustomPrompt,\n\t\tselectedTools,\n\t\ttoolSnippets,\n\t\tpromptGuidelines,\n\t\tappendSystemPrompt,\n\t\tcwd,\n\t\tcontextFiles: providedContextFiles,\n\t\tskills: providedSkills,\n\t} = options;\n\tconst promptCwd = cwd.replace(/\\\\/g, \"/\");\n\n\tconst appendSection = appendSystemPrompt ? `\\n\\n${appendSystemPrompt}` : \"\";\n\n\tconst contextFiles = providedContextFiles ?? [];\n\tconst skills = providedSkills ?? [];\n\tconst agents = options.agents ?? [];\n\n\tif (customPrompt) {\n\t\tlet prompt = customPrompt;\n\n\t\tif (appendSection) {\n\t\t\tprompt += appendSection;\n\t\t}\n\n\t\t// Append project context files\n\t\tif (contextFiles.length > 0) {\n\t\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t\t}\n\t\t\tprompt += \"</project_context>\\n\";\n\t\t}\n\n\t\t// Append skills section (only if read tool is available)\n\t\tconst customPromptHasRead = !selectedTools || selectedTools.includes(\"read\");\n\t\tif (customPromptHasRead && skills.length > 0) {\n\t\t\tprompt += formatSkillsForPrompt(skills);\n\t\t}\n\t\tif (customPromptHasRead && agents.length > 0) {\n\t\t\tprompt += formatAgentsForPrompt(agents);\n\t\t}\n\n\t\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\t\treturn prompt;\n\t}\n\n\t// Get absolute paths to documentation and examples\n\tconst readmePath = getReadmePath();\n\tconst docsPath = getDocsPath();\n\tconst examplesPath = getExamplesPath();\n\n\t// Build tools list based on selected tools.\n\t// A tool appears in Available tools only when the caller provides a one-line snippet.\n\tconst tools = selectedTools || [\"read\", \"bash\", \"edit\", \"write\"];\n\tconst visibleTools = tools.filter((name) => !!toolSnippets?.[name]);\n\tconst toolsList =\n\t\tvisibleTools.length > 0 ? visibleTools.map((name) => `- ${name}: ${toolSnippets![name]}`).join(\"\\n\") : \"(none)\";\n\n\t// Build guidelines based on which tools are actually available\n\tconst guidelinesList: string[] = [];\n\tconst guidelinesSet = new Set<string>();\n\tconst addGuideline = (guideline: string): void => {\n\t\tif (guidelinesSet.has(guideline)) {\n\t\t\treturn;\n\t\t}\n\t\tguidelinesSet.add(guideline);\n\t\tguidelinesList.push(guideline);\n\t};\n\n\tconst hasBash = tools.includes(\"bash\");\n\tconst hasGrep = tools.includes(\"grep\");\n\tconst hasFind = tools.includes(\"find\");\n\tconst hasLs = tools.includes(\"ls\");\n\tconst hasRead = tools.includes(\"read\");\n\n\t// File exploration guidelines\n\tif (hasBash && !hasGrep && !hasFind && !hasLs) {\n\t\taddGuideline(\"Use bash for file operations like ls, rg, find\");\n\t}\n\n\tfor (const guideline of promptGuidelines ?? []) {\n\t\tconst normalized = guideline.trim();\n\t\tif (normalized.length > 0) {\n\t\t\taddGuideline(normalized);\n\t\t}\n\t}\n\n\t// Always include these\n\taddGuideline(\"Be concise in your responses\");\n\taddGuideline(\"Show file paths clearly when working with files\");\n\n\tconst guidelines = guidelinesList.map((g) => `- ${g}`).join(\"\\n\");\n\n\tlet prompt = `You are an expert coding assistant operating inside SelesaiCode fork of Pi, a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.\n\nAvailable tools:\n${toolsList}\n\nIn addition to the tools above, you may have access to other custom tools depending on the project.\n\nGuidelines:\n${guidelines}\n\nPi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):\n- Main documentation: ${readmePath}\n- Additional docs: ${docsPath}\n- Examples: ${examplesPath} (extensions, custom tools, SDK)\n- When reading pi docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), pi packages (docs/packages.md), environment variables (docs/environment-variables.md)\n- When working on pi topics, read the docs and examples, and follow .md cross-references before implementing\n- Always read pi .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;\n\n\tif (appendSection) {\n\t\tprompt += appendSection;\n\t}\n\n\t// Append project context files\n\tif (contextFiles.length > 0) {\n\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t}\n\t\tprompt += \"</project_context>\\n\";\n\t}\n\n\t// Append skills section (only if read tool is available)\n\tif (hasRead && skills.length > 0) {\n\t\tprompt += formatSkillsForPrompt(skills);\n\t}\n\tif (hasRead && agents.length > 0) {\n\t\tprompt += formatAgentsForPrompt(agents);\n\t}\n\n\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\treturn prompt;\n}\n"]}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAUhE,MAAM,WAAW,wBAAwB;IACxC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,yBAAyB;IACzB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,oCAAoC;IACpC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CA0J3E","sourcesContent":["/**\n * System prompt construction and project context loading\n */\n\nimport { getDocsPath, getExamplesPath, getReadmePath } from \"../config.ts\";\nimport { formatAgentsForPrompt, type AgentPersona } from \"./agents.ts\";\nimport { formatSkillsForPrompt, type Skill } from \"./skills.ts\";\n\n/**\n * Generic delegation-routing threshold for main sessions. The text is\n * self-conditioning (\"when a delegation/subagent tool is available\"), so\n * sessions without such a tool are unaffected.\n */\nconst DELEGATION_ROUTING_GUIDELINE =\n\t\"When a delegation/subagent tool is available: keep tiny targeted reads and simple answers local; send broad local investigation, external research, and mutation/implementation work to a capable delegated agent, inspecting the delegation catalog/list before selecting; the parent remains the decision-maker and normally the sole writer.\";\n\nexport interface BuildSystemPromptOptions {\n\t/** Custom system prompt (replaces default). */\n\tcustomPrompt?: string;\n\t/** Tools to include in prompt. Default: [read, bash, edit, write] */\n\tselectedTools?: string[];\n\t/** Optional one-line tool snippets keyed by tool name. */\n\ttoolSnippets?: Record<string, string>;\n\t/** Additional guideline bullets appended to the default system prompt guidelines. */\n\tpromptGuidelines?: string[];\n\t/** Text to append to system prompt. */\n\tappendSystemPrompt?: string;\n\t/** Working directory. */\n\tcwd: string;\n\t/** Pre-loaded context files. */\n\tcontextFiles?: Array<{ path: string; content: string }>;\n\t/** Pre-loaded skills. */\n\tskills?: Skill[];\n\t/** Pre-loaded subagent personas. */\n\tagents?: AgentPersona[];\n}\n\n/** Build the system prompt with tools, guidelines, and context */\nexport function buildSystemPrompt(options: BuildSystemPromptOptions): string {\n\tconst {\n\t\tcustomPrompt,\n\t\tselectedTools,\n\t\ttoolSnippets,\n\t\tpromptGuidelines,\n\t\tappendSystemPrompt,\n\t\tcwd,\n\t\tcontextFiles: providedContextFiles,\n\t\tskills: providedSkills,\n\t} = options;\n\tconst promptCwd = cwd.replace(/\\\\/g, \"/\");\n\n\tconst appendSection = appendSystemPrompt ? `\\n\\n${appendSystemPrompt}` : \"\";\n\n\tconst contextFiles = providedContextFiles ?? [];\n\tconst skills = providedSkills ?? [];\n\tconst agents = options.agents ?? [];\n\n\tif (customPrompt) {\n\t\tlet prompt = customPrompt;\n\n\t\tif (appendSection) {\n\t\t\tprompt += appendSection;\n\t\t}\n\n\t\t// Append project context files\n\t\tif (contextFiles.length > 0) {\n\t\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t\t}\n\t\t\tprompt += \"</project_context>\\n\";\n\t\t}\n\n\t\t// Append skills section (only if read tool is available)\n\t\tconst customPromptHasRead = !selectedTools || selectedTools.includes(\"read\");\n\t\tif (customPromptHasRead && skills.length > 0) {\n\t\t\tprompt += formatSkillsForPrompt(skills);\n\t\t}\n\t\tif (customPromptHasRead && agents.length > 0) {\n\t\t\tprompt += formatAgentsForPrompt(agents);\n\t\t}\n\n\t\t// Render active-tool guidelines (e.g., mandatory delegation contracts) in\n\t\t// custom-prompt sessions too, without requiring the read tool. The caller's\n\t\t// custom prompt text stays unchanged; a clearly delimited section is appended\n\t\t// only when non-empty guidelines exist.\n\t\tconst activeGuidelines = (promptGuidelines ?? [])\n\t\t\t.map((guideline) => guideline.trim())\n\t\t\t.filter((guideline) => guideline.length > 0)\n\t\t\t.filter((guideline, index, all) => all.indexOf(guideline) === index);\n\t\tif (activeGuidelines.length > 0) {\n\t\t\tprompt += `\\n\\nActive tool guidelines:\\n${activeGuidelines.map((guideline) => `- ${guideline}`).join(\"\\n\")}`;\n\t\t}\n\n\t\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\t\treturn prompt;\n\t}\n\n\t// Get absolute paths to documentation and examples\n\tconst readmePath = getReadmePath();\n\tconst docsPath = getDocsPath();\n\tconst examplesPath = getExamplesPath();\n\n\t// Build tools list based on selected tools.\n\t// A tool appears in Available tools only when the caller provides a one-line snippet.\n\tconst tools = selectedTools || [\"read\", \"bash\", \"edit\", \"write\"];\n\tconst visibleTools = tools.filter((name) => !!toolSnippets?.[name]);\n\tconst toolsList =\n\t\tvisibleTools.length > 0 ? visibleTools.map((name) => `- ${name}: ${toolSnippets![name]}`).join(\"\\n\") : \"(none)\";\n\n\t// Build guidelines based on which tools are actually available\n\tconst guidelinesList: string[] = [];\n\tconst guidelinesSet = new Set<string>();\n\tconst addGuideline = (guideline: string): void => {\n\t\tif (guidelinesSet.has(guideline)) {\n\t\t\treturn;\n\t\t}\n\t\tguidelinesSet.add(guideline);\n\t\tguidelinesList.push(guideline);\n\t};\n\n\tconst hasBash = tools.includes(\"bash\");\n\tconst hasGrep = tools.includes(\"grep\");\n\tconst hasFind = tools.includes(\"find\");\n\tconst hasLs = tools.includes(\"ls\");\n\tconst hasRead = tools.includes(\"read\");\n\n\t// File exploration guidelines\n\tif (hasBash && !hasGrep && !hasFind && !hasLs) {\n\t\taddGuideline(\"Use bash for file operations like ls, rg, find\");\n\t}\n\n\tfor (const guideline of promptGuidelines ?? []) {\n\t\tconst normalized = guideline.trim();\n\t\tif (normalized.length > 0) {\n\t\t\taddGuideline(normalized);\n\t\t}\n\t}\n\n\t// Always include these\n\taddGuideline(DELEGATION_ROUTING_GUIDELINE);\n\taddGuideline(\"Be concise in your responses\");\n\taddGuideline(\"Show file paths clearly when working with files\");\n\n\tconst guidelines = guidelinesList.map((g) => `- ${g}`).join(\"\\n\");\n\n\tlet prompt = `You are an expert coding assistant operating inside SelesaiCode fork of Pi, a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.\n\nAvailable tools:\n${toolsList}\n\nIn addition to the tools above, you may have access to other custom tools depending on the project.\n\nGuidelines:\n${guidelines}\n\nPi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):\n- Main documentation: ${readmePath}\n- Additional docs: ${docsPath}\n- Examples: ${examplesPath} (extensions, custom tools, SDK)\n- When reading pi docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), pi packages (docs/packages.md), environment variables (docs/environment-variables.md)\n- When working on pi topics, read the docs and examples, and follow .md cross-references before implementing\n- Always read pi .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;\n\n\tif (appendSection) {\n\t\tprompt += appendSection;\n\t}\n\n\t// Append project context files\n\tif (contextFiles.length > 0) {\n\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t}\n\t\tprompt += \"</project_context>\\n\";\n\t}\n\n\t// Append skills section (only if read tool is available)\n\tif (hasRead && skills.length > 0) {\n\t\tprompt += formatSkillsForPrompt(skills);\n\t}\n\tif (hasRead && agents.length > 0) {\n\t\tprompt += formatAgentsForPrompt(agents);\n\t}\n\n\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\treturn prompt;\n}\n"]}

package/dist/core/system-prompt.js

@@ -4,6 +4,12 @@
 import { getDocsPath, getExamplesPath, getReadmePath } from "../config.js";
 import { formatAgentsForPrompt } from "./agents.js";
 import { formatSkillsForPrompt } from "./skills.js";
+/**
+ * Generic delegation-routing threshold for main sessions. The text is
+ * self-conditioning ("when a delegation/subagent tool is available"), so
+ * sessions without such a tool are unaffected.
+ */
+const DELEGATION_ROUTING_GUIDELINE = "When a delegation/subagent tool is available: keep tiny targeted reads and simple answers local; send broad local investigation, external research, and mutation/implementation work to a capable delegated agent, inspecting the delegation catalog/list before selecting; the parent remains the decision-maker and normally the sole writer.";
 /** Build the system prompt with tools, guidelines, and context */
 export function buildSystemPrompt(options) {
     const { customPrompt, selectedTools, toolSnippets, promptGuidelines, appendSystemPrompt, cwd, contextFiles: providedContextFiles, skills: providedSkills, } = options;
@@ -34,6 +40,17 @@ export function buildSystemPrompt(options) {
         if (customPromptHasRead && agents.length > 0) {
             prompt += formatAgentsForPrompt(agents);
         }
+        // Render active-tool guidelines (e.g., mandatory delegation contracts) in
+        // custom-prompt sessions too, without requiring the read tool. The caller's
+        // custom prompt text stays unchanged; a clearly delimited section is appended
+        // only when non-empty guidelines exist.
+        const activeGuidelines = (promptGuidelines ?? [])
+            .map((guideline) => guideline.trim())
+            .filter((guideline) => guideline.length > 0)
+            .filter((guideline, index, all) => all.indexOf(guideline) === index);
+        if (activeGuidelines.length > 0) {
+            prompt += `\n\nActive tool guidelines:\n${activeGuidelines.map((guideline) => `- ${guideline}`).join("\n")}`;
+        }
         prompt += `\nCurrent working directory: ${promptCwd}`;
         return prompt;
     }
@@ -72,6 +89,7 @@ export function buildSystemPrompt(options) {
         }
     }
     // Always include these
+    addGuideline(DELEGATION_ROUTING_GUIDELINE);
     addGuideline("Be concise in your responses");
     addGuideline("Show file paths clearly when working with files");
     const guidelines = guidelinesList.map((g) => `- ${g}`).join("\n");

package/dist/core/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * System prompt construction and project context loading\n */\n\nimport { getDocsPath, getExamplesPath, getReadmePath } from \"../config.ts\";\nimport { formatAgentsForPrompt, type AgentPersona } from \"./agents.ts\";\nimport { formatSkillsForPrompt, type Skill } from \"./skills.ts\";\n\nexport interface BuildSystemPromptOptions {\n\t/** Custom system prompt (replaces default). */\n\tcustomPrompt?: string;\n\t/** Tools to include in prompt. Default: [read, bash, edit, write] */\n\tselectedTools?: string[];\n\t/** Optional one-line tool snippets keyed by tool name. */\n\ttoolSnippets?: Record<string, string>;\n\t/** Additional guideline bullets appended to the default system prompt guidelines. */\n\tpromptGuidelines?: string[];\n\t/** Text to append to system prompt. */\n\tappendSystemPrompt?: string;\n\t/** Working directory. */\n\tcwd: string;\n\t/** Pre-loaded context files. */\n\tcontextFiles?: Array<{ path: string; content: string }>;\n\t/** Pre-loaded skills. */\n\tskills?: Skill[];\n\t/** Pre-loaded subagent personas. */\n\tagents?: AgentPersona[];\n}\n\n/** Build the system prompt with tools, guidelines, and context */\nexport function buildSystemPrompt(options: BuildSystemPromptOptions): string {\n\tconst {\n\t\tcustomPrompt,\n\t\tselectedTools,\n\t\ttoolSnippets,\n\t\tpromptGuidelines,\n\t\tappendSystemPrompt,\n\t\tcwd,\n\t\tcontextFiles: providedContextFiles,\n\t\tskills: providedSkills,\n\t} = options;\n\tconst promptCwd = cwd.replace(/\\\\/g, \"/\");\n\n\tconst appendSection = appendSystemPrompt ? `\\n\\n${appendSystemPrompt}` : \"\";\n\n\tconst contextFiles = providedContextFiles ?? [];\n\tconst skills = providedSkills ?? [];\n\tconst agents = options.agents ?? [];\n\n\tif (customPrompt) {\n\t\tlet prompt = customPrompt;\n\n\t\tif (appendSection) {\n\t\t\tprompt += appendSection;\n\t\t}\n\n\t\t// Append project context files\n\t\tif (contextFiles.length > 0) {\n\t\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t\t}\n\t\t\tprompt += \"</project_context>\\n\";\n\t\t}\n\n\t\t// Append skills section (only if read tool is available)\n\t\tconst customPromptHasRead = !selectedTools || selectedTools.includes(\"read\");\n\t\tif (customPromptHasRead && skills.length > 0) {\n\t\t\tprompt += formatSkillsForPrompt(skills);\n\t\t}\n\t\tif (customPromptHasRead && agents.length > 0) {\n\t\t\tprompt += formatAgentsForPrompt(agents);\n\t\t}\n\n\t\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\t\treturn prompt;\n\t}\n\n\t// Get absolute paths to documentation and examples\n\tconst readmePath = getReadmePath();\n\tconst docsPath = getDocsPath();\n\tconst examplesPath = getExamplesPath();\n\n\t// Build tools list based on selected tools.\n\t// A tool appears in Available tools only when the caller provides a one-line snippet.\n\tconst tools = selectedTools || [\"read\", \"bash\", \"edit\", \"write\"];\n\tconst visibleTools = tools.filter((name) => !!toolSnippets?.[name]);\n\tconst toolsList =\n\t\tvisibleTools.length > 0 ? visibleTools.map((name) => `- ${name}: ${toolSnippets![name]}`).join(\"\\n\") : \"(none)\";\n\n\t// Build guidelines based on which tools are actually available\n\tconst guidelinesList: string[] = [];\n\tconst guidelinesSet = new Set<string>();\n\tconst addGuideline = (guideline: string): void => {\n\t\tif (guidelinesSet.has(guideline)) {\n\t\t\treturn;\n\t\t}\n\t\tguidelinesSet.add(guideline);\n\t\tguidelinesList.push(guideline);\n\t};\n\n\tconst hasBash = tools.includes(\"bash\");\n\tconst hasGrep = tools.includes(\"grep\");\n\tconst hasFind = tools.includes(\"find\");\n\tconst hasLs = tools.includes(\"ls\");\n\tconst hasRead = tools.includes(\"read\");\n\n\t// File exploration guidelines\n\tif (hasBash && !hasGrep && !hasFind && !hasLs) {\n\t\taddGuideline(\"Use bash for file operations like ls, rg, find\");\n\t}\n\n\tfor (const guideline of promptGuidelines ?? []) {\n\t\tconst normalized = guideline.trim();\n\t\tif (normalized.length > 0) {\n\t\t\taddGuideline(normalized);\n\t\t}\n\t}\n\n\t// Always include these\n\taddGuideline(\"Be concise in your responses\");\n\taddGuideline(\"Show file paths clearly when working with files\");\n\n\tconst guidelines = guidelinesList.map((g) => `- ${g}`).join(\"\\n\");\n\n\tlet prompt = `You are an expert coding assistant operating inside SelesaiCode fork of Pi, a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.\n\nAvailable tools:\n${toolsList}\n\nIn addition to the tools above, you may have access to other custom tools depending on the project.\n\nGuidelines:\n${guidelines}\n\nPi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):\n- Main documentation: ${readmePath}\n- Additional docs: ${docsPath}\n- Examples: ${examplesPath} (extensions, custom tools, SDK)\n- When reading pi docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), pi packages (docs/packages.md), environment variables (docs/environment-variables.md)\n- When working on pi topics, read the docs and examples, and follow .md cross-references before implementing\n- Always read pi .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;\n\n\tif (appendSection) {\n\t\tprompt += appendSection;\n\t}\n\n\t// Append project context files\n\tif (contextFiles.length > 0) {\n\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t}\n\t\tprompt += \"</project_context>\\n\";\n\t}\n\n\t// Append skills section (only if read tool is available)\n\tif (hasRead && skills.length > 0) {\n\t\tprompt += formatSkillsForPrompt(skills);\n\t}\n\tif (hasRead && agents.length > 0) {\n\t\tprompt += formatAgentsForPrompt(agents);\n\t}\n\n\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\treturn prompt;\n}\n"]}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * System prompt construction and project context loading\n */\n\nimport { getDocsPath, getExamplesPath, getReadmePath } from \"../config.ts\";\nimport { formatAgentsForPrompt, type AgentPersona } from \"./agents.ts\";\nimport { formatSkillsForPrompt, type Skill } from \"./skills.ts\";\n\n/**\n * Generic delegation-routing threshold for main sessions. The text is\n * self-conditioning (\"when a delegation/subagent tool is available\"), so\n * sessions without such a tool are unaffected.\n */\nconst DELEGATION_ROUTING_GUIDELINE =\n\t\"When a delegation/subagent tool is available: keep tiny targeted reads and simple answers local; send broad local investigation, external research, and mutation/implementation work to a capable delegated agent, inspecting the delegation catalog/list before selecting; the parent remains the decision-maker and normally the sole writer.\";\n\nexport interface BuildSystemPromptOptions {\n\t/** Custom system prompt (replaces default). */\n\tcustomPrompt?: string;\n\t/** Tools to include in prompt. Default: [read, bash, edit, write] */\n\tselectedTools?: string[];\n\t/** Optional one-line tool snippets keyed by tool name. */\n\ttoolSnippets?: Record<string, string>;\n\t/** Additional guideline bullets appended to the default system prompt guidelines. */\n\tpromptGuidelines?: string[];\n\t/** Text to append to system prompt. */\n\tappendSystemPrompt?: string;\n\t/** Working directory. */\n\tcwd: string;\n\t/** Pre-loaded context files. */\n\tcontextFiles?: Array<{ path: string; content: string }>;\n\t/** Pre-loaded skills. */\n\tskills?: Skill[];\n\t/** Pre-loaded subagent personas. */\n\tagents?: AgentPersona[];\n}\n\n/** Build the system prompt with tools, guidelines, and context */\nexport function buildSystemPrompt(options: BuildSystemPromptOptions): string {\n\tconst {\n\t\tcustomPrompt,\n\t\tselectedTools,\n\t\ttoolSnippets,\n\t\tpromptGuidelines,\n\t\tappendSystemPrompt,\n\t\tcwd,\n\t\tcontextFiles: providedContextFiles,\n\t\tskills: providedSkills,\n\t} = options;\n\tconst promptCwd = cwd.replace(/\\\\/g, \"/\");\n\n\tconst appendSection = appendSystemPrompt ? `\\n\\n${appendSystemPrompt}` : \"\";\n\n\tconst contextFiles = providedContextFiles ?? [];\n\tconst skills = providedSkills ?? [];\n\tconst agents = options.agents ?? [];\n\n\tif (customPrompt) {\n\t\tlet prompt = customPrompt;\n\n\t\tif (appendSection) {\n\t\t\tprompt += appendSection;\n\t\t}\n\n\t\t// Append project context files\n\t\tif (contextFiles.length > 0) {\n\t\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t\t}\n\t\t\tprompt += \"</project_context>\\n\";\n\t\t}\n\n\t\t// Append skills section (only if read tool is available)\n\t\tconst customPromptHasRead = !selectedTools || selectedTools.includes(\"read\");\n\t\tif (customPromptHasRead && skills.length > 0) {\n\t\t\tprompt += formatSkillsForPrompt(skills);\n\t\t}\n\t\tif (customPromptHasRead && agents.length > 0) {\n\t\t\tprompt += formatAgentsForPrompt(agents);\n\t\t}\n\n\t\t// Render active-tool guidelines (e.g., mandatory delegation contracts) in\n\t\t// custom-prompt sessions too, without requiring the read tool. The caller's\n\t\t// custom prompt text stays unchanged; a clearly delimited section is appended\n\t\t// only when non-empty guidelines exist.\n\t\tconst activeGuidelines = (promptGuidelines ?? [])\n\t\t\t.map((guideline) => guideline.trim())\n\t\t\t.filter((guideline) => guideline.length > 0)\n\t\t\t.filter((guideline, index, all) => all.indexOf(guideline) === index);\n\t\tif (activeGuidelines.length > 0) {\n\t\t\tprompt += `\\n\\nActive tool guidelines:\\n${activeGuidelines.map((guideline) => `- ${guideline}`).join(\"\\n\")}`;\n\t\t}\n\n\t\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\t\treturn prompt;\n\t}\n\n\t// Get absolute paths to documentation and examples\n\tconst readmePath = getReadmePath();\n\tconst docsPath = getDocsPath();\n\tconst examplesPath = getExamplesPath();\n\n\t// Build tools list based on selected tools.\n\t// A tool appears in Available tools only when the caller provides a one-line snippet.\n\tconst tools = selectedTools || [\"read\", \"bash\", \"edit\", \"write\"];\n\tconst visibleTools = tools.filter((name) => !!toolSnippets?.[name]);\n\tconst toolsList =\n\t\tvisibleTools.length > 0 ? visibleTools.map((name) => `- ${name}: ${toolSnippets![name]}`).join(\"\\n\") : \"(none)\";\n\n\t// Build guidelines based on which tools are actually available\n\tconst guidelinesList: string[] = [];\n\tconst guidelinesSet = new Set<string>();\n\tconst addGuideline = (guideline: string): void => {\n\t\tif (guidelinesSet.has(guideline)) {\n\t\t\treturn;\n\t\t}\n\t\tguidelinesSet.add(guideline);\n\t\tguidelinesList.push(guideline);\n\t};\n\n\tconst hasBash = tools.includes(\"bash\");\n\tconst hasGrep = tools.includes(\"grep\");\n\tconst hasFind = tools.includes(\"find\");\n\tconst hasLs = tools.includes(\"ls\");\n\tconst hasRead = tools.includes(\"read\");\n\n\t// File exploration guidelines\n\tif (hasBash && !hasGrep && !hasFind && !hasLs) {\n\t\taddGuideline(\"Use bash for file operations like ls, rg, find\");\n\t}\n\n\tfor (const guideline of promptGuidelines ?? []) {\n\t\tconst normalized = guideline.trim();\n\t\tif (normalized.length > 0) {\n\t\t\taddGuideline(normalized);\n\t\t}\n\t}\n\n\t// Always include these\n\taddGuideline(DELEGATION_ROUTING_GUIDELINE);\n\taddGuideline(\"Be concise in your responses\");\n\taddGuideline(\"Show file paths clearly when working with files\");\n\n\tconst guidelines = guidelinesList.map((g) => `- ${g}`).join(\"\\n\");\n\n\tlet prompt = `You are an expert coding assistant operating inside SelesaiCode fork of Pi, a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.\n\nAvailable tools:\n${toolsList}\n\nIn addition to the tools above, you may have access to other custom tools depending on the project.\n\nGuidelines:\n${guidelines}\n\nPi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):\n- Main documentation: ${readmePath}\n- Additional docs: ${docsPath}\n- Examples: ${examplesPath} (extensions, custom tools, SDK)\n- When reading pi docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), pi packages (docs/packages.md), environment variables (docs/environment-variables.md)\n- When working on pi topics, read the docs and examples, and follow .md cross-references before implementing\n- Always read pi .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;\n\n\tif (appendSection) {\n\t\tprompt += appendSection;\n\t}\n\n\t// Append project context files\n\tif (contextFiles.length > 0) {\n\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t}\n\t\tprompt += \"</project_context>\\n\";\n\t}\n\n\t// Append skills section (only if read tool is available)\n\tif (hasRead && skills.length > 0) {\n\t\tprompt += formatSkillsForPrompt(skills);\n\t}\n\tif (hasRead && agents.length > 0) {\n\t\tprompt += formatAgentsForPrompt(agents);\n\t}\n\n\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\treturn prompt;\n}\n"]}

package/dist/core/system-prompt.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=system-prompt.test.d.ts.map

package/dist/core/system-prompt.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.test.d.ts","sourceRoot":"","sources":["../../src/core/system-prompt.test.ts"],"names":[],"mappings":"","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { buildSystemPrompt } from \"./system-prompt.ts\";\nimport type { AgentPersona } from \"./agents.ts\";\nimport type { Skill } from \"./skills.ts\";\n\ndescribe(\"buildSystemPrompt\", () => {\n\tit(\"includes the generic delegation-routing threshold in the default prompt\", () => {\n\t\tconst prompt = buildSystemPrompt({ cwd: \"/tmp/project\" });\n\n\t\texpect(prompt).toMatch(/When a delegation\\/subagent tool is available/i);\n\t\texpect(prompt).toMatch(/keep tiny targeted reads and simple answers local/i);\n\t\texpect(prompt).toMatch(/broad local investigation, external research, and mutation\\/implementation work/i);\n\t\texpect(prompt).toMatch(/capable delegated agent/i);\n\t\texpect(prompt).toMatch(/inspecting the delegation catalog\\/list before selecting/i);\n\t\texpect(prompt).toMatch(/parent remains the decision-maker and normally the sole writer/i);\n\t\texpect(prompt).toMatch(/Guidelines:/);\n\t\texpect(prompt).toContain(\"Current working directory: /tmp/project\");\n\t});\n\n\tit(\"keeps the default tool snippets, skills, and agents XML read-gated\", () => {\n\t\tconst skill: Skill = {\n\t\t\tname: \"test-skill\",\n\t\t\tdescription: \"Test skill description\",\n\t\t\tfilePath: \"/tmp/skills/test-skill/SKILL.md\",\n\t\t\tbaseDir: \"/tmp/skills/test-skill\",\n\t\t\tsourceInfo: { type: \"file\", path: \"/tmp/skills/test-skill/SKILL.md\" } as never,\n\t\t\tdisableModelInvocation: false,\n\t\t};\n\t\tconst agent: AgentPersona = {\n\t\t\tname: \"test-agent\",\n\t\t\tdescription: \"Test agent description\",\n\t\t\tfilePath: \"/tmp/agents/test-agent.md\",\n\t\t\tbaseDir: \"/tmp/agents\",\n\t\t\tsourceInfo: { type: \"file\", path: \"/tmp/agents/test-agent.md\" } as never,\n\t\t\tfrontmatter: {} as never,\n\t\t};\n\n\t\tconst withoutRead = buildSystemPrompt({\n\t\t\tcwd: \"/tmp/project\",\n\t\t\tselectedTools: [\"bash\"],\n\t\t\tskills: [skill],\n\t\t\tagents: [agent],\n\t\t});\n\t\texpect(withoutRead).not.toContain(\"<available_skills>\");\n\t\texpect(withoutRead).not.toContain(\"<available_agents>\");\n\t\texpect(withoutRead).toContain(\"Current working directory: /tmp/project\");\n\n\t\tconst withRead = buildSystemPrompt({\n\t\t\tcwd: \"/tmp/project\",\n\t\t\tselectedTools: [\"read\", \"bash\"],\n\t\t\tskills: [skill],\n\t\t\tagents: [agent],\n\t\t});\n\t\texpect(withRead).toContain(\"<available_skills>\");\n\t\texpect(withRead).toContain(\"<available_agents>\");\n\t\texpect(withRead).toContain(\"test-skill\");\n\t\texpect(withRead).toContain(\"test-agent\");\n\t});\n\n\tit(\"appends active promptGuidelines to a custom system prompt unchanged\", () => {\n\t\tconst prompt = buildSystemPrompt({\n\t\t\tcwd: \"/tmp/project\",\n\t\t\tcustomPrompt: \"You are my custom assistant.\",\n\t\t\tpromptGuidelines: ['Before executing, call { action: \"list\" }.'],\n\t\t});\n\n\t\texpect(prompt).toContain(\"You are my custom assistant.\");\n\t\texpect(prompt).toContain(\"Active tool guidelines:\");\n\t\texpect(prompt).toContain('- Before executing, call { action: \"list\" }.');\n\t\texpect(prompt).toContain(\"Current working directory: /tmp/project\");\n\t});\n\n\tit(\"deduplicates and trims active promptGuidelines in custom prompts\", () => {\n\t\tconst prompt = buildSystemPrompt({\n\t\t\tcwd: \"/tmp/project\",\n\t\t\tcustomPrompt: \"Custom.\",\n\t\t\tpromptGuidelines: [\"  Same guideline  \", \"Same guideline\", \"\", \"   \"],\n\t\t});\n\n\t\texpect(prompt).toContain(\"Active tool guidelines:\");\n\t\texpect(prompt.match(/- Same guideline/g)).toHaveLength(1);\n\t});\n\n\tit(\"does not add an empty guideline section when no promptGuidelines are supplied\", () => {\n\t\tconst prompt = buildSystemPrompt({ cwd: \"/tmp/project\", customPrompt: \"Custom text.\" });\n\n\t\texpect(prompt).toContain(\"Custom text.\");\n\t\texpect(prompt).not.toContain(\"Active tool guidelines:\");\n\t\texpect(prompt).toContain(\"Current working directory: /tmp/project\");\n\t});\n\n\tit(\"renders active promptGuidelines in custom prompts without requiring read\", () => {\n\t\tconst prompt = buildSystemPrompt({\n\t\t\tcwd: \"/tmp/project\",\n\t\t\tcustomPrompt: \"Custom.\",\n\t\t\tselectedTools: [\"bash\"],\n\t\t\tpromptGuidelines: [\"Mandatory active-tool guidance.\"],\n\t\t});\n\n\t\texpect(prompt).toContain(\"- Mandatory active-tool guidance.\");\n\t\texpect(prompt).not.toContain(\"<available_agents>\");\n\t});\n});\n"]}

package/dist/core/system-prompt.test.js

@@ -0,0 +1,89 @@
+import { describe, expect, it } from "vitest";
+import { buildSystemPrompt } from "./system-prompt.js";
+describe("buildSystemPrompt", () => {
+    it("includes the generic delegation-routing threshold in the default prompt", () => {
+        const prompt = buildSystemPrompt({ cwd: "/tmp/project" });
+        expect(prompt).toMatch(/When a delegation\/subagent tool is available/i);
+        expect(prompt).toMatch(/keep tiny targeted reads and simple answers local/i);
+        expect(prompt).toMatch(/broad local investigation, external research, and mutation\/implementation work/i);
+        expect(prompt).toMatch(/capable delegated agent/i);
+        expect(prompt).toMatch(/inspecting the delegation catalog\/list before selecting/i);
+        expect(prompt).toMatch(/parent remains the decision-maker and normally the sole writer/i);
+        expect(prompt).toMatch(/Guidelines:/);
+        expect(prompt).toContain("Current working directory: /tmp/project");
+    });
+    it("keeps the default tool snippets, skills, and agents XML read-gated", () => {
+        const skill = {
+            name: "test-skill",
+            description: "Test skill description",
+            filePath: "/tmp/skills/test-skill/SKILL.md",
+            baseDir: "/tmp/skills/test-skill",
+            sourceInfo: { type: "file", path: "/tmp/skills/test-skill/SKILL.md" },
+            disableModelInvocation: false,
+        };
+        const agent = {
+            name: "test-agent",
+            description: "Test agent description",
+            filePath: "/tmp/agents/test-agent.md",
+            baseDir: "/tmp/agents",
+            sourceInfo: { type: "file", path: "/tmp/agents/test-agent.md" },
+            frontmatter: {},
+        };
+        const withoutRead = buildSystemPrompt({
+            cwd: "/tmp/project",
+            selectedTools: ["bash"],
+            skills: [skill],
+            agents: [agent],
+        });
+        expect(withoutRead).not.toContain("<available_skills>");
+        expect(withoutRead).not.toContain("<available_agents>");
+        expect(withoutRead).toContain("Current working directory: /tmp/project");
+        const withRead = buildSystemPrompt({
+            cwd: "/tmp/project",
+            selectedTools: ["read", "bash"],
+            skills: [skill],
+            agents: [agent],
+        });
+        expect(withRead).toContain("<available_skills>");
+        expect(withRead).toContain("<available_agents>");
+        expect(withRead).toContain("test-skill");
+        expect(withRead).toContain("test-agent");
+    });
+    it("appends active promptGuidelines to a custom system prompt unchanged", () => {
+        const prompt = buildSystemPrompt({
+            cwd: "/tmp/project",
+            customPrompt: "You are my custom assistant.",
+            promptGuidelines: ['Before executing, call { action: "list" }.'],
+        });
+        expect(prompt).toContain("You are my custom assistant.");
+        expect(prompt).toContain("Active tool guidelines:");
+        expect(prompt).toContain('- Before executing, call { action: "list" }.');
+        expect(prompt).toContain("Current working directory: /tmp/project");
+    });
+    it("deduplicates and trims active promptGuidelines in custom prompts", () => {
+        const prompt = buildSystemPrompt({
+            cwd: "/tmp/project",
+            customPrompt: "Custom.",
+            promptGuidelines: ["  Same guideline  ", "Same guideline", "", "   "],
+        });
+        expect(prompt).toContain("Active tool guidelines:");
+        expect(prompt.match(/- Same guideline/g)).toHaveLength(1);
+    });
+    it("does not add an empty guideline section when no promptGuidelines are supplied", () => {
+        const prompt = buildSystemPrompt({ cwd: "/tmp/project", customPrompt: "Custom text." });
+        expect(prompt).toContain("Custom text.");
+        expect(prompt).not.toContain("Active tool guidelines:");
+        expect(prompt).toContain("Current working directory: /tmp/project");
+    });
+    it("renders active promptGuidelines in custom prompts without requiring read", () => {
+        const prompt = buildSystemPrompt({
+            cwd: "/tmp/project",
+            customPrompt: "Custom.",
+            selectedTools: ["bash"],
+            promptGuidelines: ["Mandatory active-tool guidance."],
+        });
+        expect(prompt).toContain("- Mandatory active-tool guidance.");
+        expect(prompt).not.toContain("<available_agents>");
+    });
+});
+//# sourceMappingURL=system-prompt.test.js.map

package/dist/core/system-prompt.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.test.js","sourceRoot":"","sources":["../../src/core/system-prompt.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAIvD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC;IACnC,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE,CAAC;QACnF,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,CAAC;QAE1D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,oDAAoD,CAAC,CAAC;QAC7E,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,kFAAkF,CAAC,CAAC;QAC3G,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,2DAA2D,CAAC,CAAC;QACpF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,iEAAiE,CAAC,CAAC;QAC1F,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,yCAAyC,CAAC,CAAC;IAAA,CACpE,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE,CAAC;QAC9E,MAAM,KAAK,GAAU;YACpB,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,wBAAwB;YACrC,QAAQ,EAAE,iCAAiC;YAC3C,OAAO,EAAE,wBAAwB;YACjC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iCAAiC,EAAW;YAC9E,sBAAsB,EAAE,KAAK;SAC7B,CAAC;QACF,MAAM,KAAK,GAAiB;YAC3B,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,wBAAwB;YACrC,QAAQ,EAAE,2BAA2B;YACrC,OAAO,EAAE,aAAa;YACtB,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,EAAW;YACxE,WAAW,EAAE,EAAW;SACxB,CAAC;QAEF,MAAM,WAAW,GAAG,iBAAiB,CAAC;YACrC,GAAG,EAAE,cAAc;YACnB,aAAa,EAAE,CAAC,MAAM,CAAC;YACvB,MAAM,EAAE,CAAC,KAAK,CAAC;YACf,MAAM,EAAE,CAAC,KAAK,CAAC;SACf,CAAC,CAAC;QACH,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACxD,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACxD,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,yCAAyC,CAAC,CAAC;QAEzE,MAAM,QAAQ,GAAG,iBAAiB,CAAC;YAClC,GAAG,EAAE,cAAc;YACnB,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;YAC/B,MAAM,EAAE,CAAC,KAAK,CAAC;YACf,MAAM,EAAE,CAAC,KAAK,CAAC;SACf,CAAC,CAAC;QACH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACjD,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACjD,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACzC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAAA,CACzC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE,CAAC;QAC/E,MAAM,MAAM,GAAG,iBAAiB,CAAC;YAChC,GAAG,EAAE,cAAc;YACnB,YAAY,EAAE,8BAA8B;YAC5C,gBAAgB,EAAE,CAAC,4CAA4C,CAAC;SAChE,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,8CAA8C,CAAC,CAAC;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,yCAAyC,CAAC,CAAC;IAAA,CACpE,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,iBAAiB,CAAC;YAChC,GAAG,EAAE,cAAc;YACnB,YAAY,EAAE,SAAS;YACvB,gBAAgB,EAAE,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,EAAE,EAAE,KAAK,CAAC;SACrE,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAAA,CAC1D,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE,CAAC;QACzF,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC,CAAC;QAExF,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,yCAAyC,CAAC,CAAC;IAAA,CACpE,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE,CAAC;QACpF,MAAM,MAAM,GAAG,iBAAiB,CAAC;YAChC,GAAG,EAAE,cAAc;YACnB,YAAY,EAAE,SAAS;YACvB,aAAa,EAAE,CAAC,MAAM,CAAC;YACvB,gBAAgB,EAAE,CAAC,iCAAiC,CAAC;SACrD,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAAA,CACnD,CAAC,CAAC;AAAA,CACH,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { buildSystemPrompt } from \"./system-prompt.ts\";\nimport type { AgentPersona } from \"./agents.ts\";\nimport type { Skill } from \"./skills.ts\";\n\ndescribe(\"buildSystemPrompt\", () => {\n\tit(\"includes the generic delegation-routing threshold in the default prompt\", () => {\n\t\tconst prompt = buildSystemPrompt({ cwd: \"/tmp/project\" });\n\n\t\texpect(prompt).toMatch(/When a delegation\\/subagent tool is available/i);\n\t\texpect(prompt).toMatch(/keep tiny targeted reads and simple answers local/i);\n\t\texpect(prompt).toMatch(/broad local investigation, external research, and mutation\\/implementation work/i);\n\t\texpect(prompt).toMatch(/capable delegated agent/i);\n\t\texpect(prompt).toMatch(/inspecting the delegation catalog\\/list before selecting/i);\n\t\texpect(prompt).toMatch(/parent remains the decision-maker and normally the sole writer/i);\n\t\texpect(prompt).toMatch(/Guidelines:/);\n\t\texpect(prompt).toContain(\"Current working directory: /tmp/project\");\n\t});\n\n\tit(\"keeps the default tool snippets, skills, and agents XML read-gated\", () => {\n\t\tconst skill: Skill = {\n\t\t\tname: \"test-skill\",\n\t\t\tdescription: \"Test skill description\",\n\t\t\tfilePath: \"/tmp/skills/test-skill/SKILL.md\",\n\t\t\tbaseDir: \"/tmp/skills/test-skill\",\n\t\t\tsourceInfo: { type: \"file\", path: \"/tmp/skills/test-skill/SKILL.md\" } as never,\n\t\t\tdisableModelInvocation: false,\n\t\t};\n\t\tconst agent: AgentPersona = {\n\t\t\tname: \"test-agent\",\n\t\t\tdescription: \"Test agent description\",\n\t\t\tfilePath: \"/tmp/agents/test-agent.md\",\n\t\t\tbaseDir: \"/tmp/agents\",\n\t\t\tsourceInfo: { type: \"file\", path: \"/tmp/agents/test-agent.md\" } as never,\n\t\t\tfrontmatter: {} as never,\n\t\t};\n\n\t\tconst withoutRead = buildSystemPrompt({\n\t\t\tcwd: \"/tmp/project\",\n\t\t\tselectedTools: [\"bash\"],\n\t\t\tskills: [skill],\n\t\t\tagents: [agent],\n\t\t});\n\t\texpect(withoutRead).not.toContain(\"<available_skills>\");\n\t\texpect(withoutRead).not.toContain(\"<available_agents>\");\n\t\texpect(withoutRead).toContain(\"Current working directory: /tmp/project\");\n\n\t\tconst withRead = buildSystemPrompt({\n\t\t\tcwd: \"/tmp/project\",\n\t\t\tselectedTools: [\"read\", \"bash\"],\n\t\t\tskills: [skill],\n\t\t\tagents: [agent],\n\t\t});\n\t\texpect(withRead).toContain(\"<available_skills>\");\n\t\texpect(withRead).toContain(\"<available_agents>\");\n\t\texpect(withRead).toContain(\"test-skill\");\n\t\texpect(withRead).toContain(\"test-agent\");\n\t});\n\n\tit(\"appends active promptGuidelines to a custom system prompt unchanged\", () => {\n\t\tconst prompt = buildSystemPrompt({\n\t\t\tcwd: \"/tmp/project\",\n\t\t\tcustomPrompt: \"You are my custom assistant.\",\n\t\t\tpromptGuidelines: ['Before executing, call { action: \"list\" }.'],\n\t\t});\n\n\t\texpect(prompt).toContain(\"You are my custom assistant.\");\n\t\texpect(prompt).toContain(\"Active tool guidelines:\");\n\t\texpect(prompt).toContain('- Before executing, call { action: \"list\" }.');\n\t\texpect(prompt).toContain(\"Current working directory: /tmp/project\");\n\t});\n\n\tit(\"deduplicates and trims active promptGuidelines in custom prompts\", () => {\n\t\tconst prompt = buildSystemPrompt({\n\t\t\tcwd: \"/tmp/project\",\n\t\t\tcustomPrompt: \"Custom.\",\n\t\t\tpromptGuidelines: [\"  Same guideline  \", \"Same guideline\", \"\", \"   \"],\n\t\t});\n\n\t\texpect(prompt).toContain(\"Active tool guidelines:\");\n\t\texpect(prompt.match(/- Same guideline/g)).toHaveLength(1);\n\t});\n\n\tit(\"does not add an empty guideline section when no promptGuidelines are supplied\", () => {\n\t\tconst prompt = buildSystemPrompt({ cwd: \"/tmp/project\", customPrompt: \"Custom text.\" });\n\n\t\texpect(prompt).toContain(\"Custom text.\");\n\t\texpect(prompt).not.toContain(\"Active tool guidelines:\");\n\t\texpect(prompt).toContain(\"Current working directory: /tmp/project\");\n\t});\n\n\tit(\"renders active promptGuidelines in custom prompts without requiring read\", () => {\n\t\tconst prompt = buildSystemPrompt({\n\t\t\tcwd: \"/tmp/project\",\n\t\t\tcustomPrompt: \"Custom.\",\n\t\t\tselectedTools: [\"bash\"],\n\t\t\tpromptGuidelines: [\"Mandatory active-tool guidance.\"],\n\t\t});\n\n\t\texpect(prompt).toContain(\"- Mandatory active-tool guidance.\");\n\t\texpect(prompt).not.toContain(\"<available_agents>\");\n\t});\n});\n"]}

package/dist/defaults/models.json

@@ -17,9 +17,9 @@
           "input": ["text"],
           "contextWindow": 1000000,
           "cost": {
-            "input": 0.14,
-            "output": 0.28,
-            "cacheRead": 0.0028,
+            "input": 0.15,
+            "output": 0.3,
+            "cacheRead": 0.003,
             "cacheWrite": 0
           },
           "compat": {
@@ -29,15 +29,15 @@
           }
         },
         {
-          "id": "kimi-k2.7-code",
-          "name": "Kimi K2.7 Code",
+          "id": "kimi-k3",
+          "name": "Kimi K3",
           "reasoning": true,
           "input": ["text", "image"],
           "contextWindow": 262128,
           "cost": {
-            "input": 0.95,
-            "output": 4,
-            "cacheRead": 0.2375,
+            "input": 3,
+            "output": 15,
+            "cacheRead": 1.5,
             "cacheWrite": 0
           },
           "compat": {
@@ -46,15 +46,15 @@
           }
         },
         {
-          "id": "kimi-k2.6",
-          "name": "Kimi K2.6",
+          "id": "kimi-k2.7-code",
+          "name": "Kimi K2.7 Code",
           "reasoning": true,
           "input": ["text", "image"],
           "contextWindow": 262128,
           "cost": {
-            "input": 0.69,
-            "output": 3.22,
-            "cacheRead": 0.1725,
+            "input": 0.95,
+            "output": 4,
+            "cacheRead": 0.2375,
             "cacheWrite": 0
           },
           "compat": {
@@ -96,22 +96,6 @@
             "supportsReasoningEffort": false
           }
         },
-        {
-          "id": "qwen3.6-35b-fast",
-          "name": "Qwen3.6 35B Fast",
-          "reasoning": false,
-          "input": ["text", "image"],
-          "contextWindow": 131056,
-          "cost": {
-            "input": 0.29,
-            "output": 1.15,
-            "cacheRead": 0.0725,
-            "cacheWrite": 0
-          },
-          "compat": {
-            "supportsReasoningEffort": false
-          }
-        },
         {
           "id": "glm-5.2",
           "name": "GLM-5.2",
@@ -128,22 +112,6 @@
             "supportsDeveloperRole": false,
             "supportsReasoningEffort": true
           }
-        },
-        {
-          "id": "glm-5.2-fast",
-          "name": "GLM-5.2 Fast",
-          "reasoning": false,
-          "input": ["text"],
-          "contextWindow": 1000000,
-          "cost": {
-            "input": 1.45,
-            "output": 4.5,
-            "cacheRead": 0.3625,
-            "cacheWrite": 0
-          },
-          "compat": {
-            "supportsReasoningEffort": true
-          }
         }
       ]
     }

package/dist/defaults/settings.json

@@ -25,8 +25,7 @@
   "lastChangelogVersion": "0.80.2",
   "packages": [
     "git:github.com/MasuRii/pi-tool-display",
-    "git:github.com/omaclaren/pi-markdown-preview",
-    "git:github.com/aliou/pi-guardrails"
+    "git:github.com/omaclaren/pi-markdown-preview"
   ],
   "quietStartup": true,
   "retry": {

package/dist/extensions/copy-turn.test.ts

@@ -0,0 +1,131 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import copyTurnExtension from "./copy-turn.ts";
+
+vi.mock("@selesai/code", () => ({
+	copyToClipboard: vi.fn(),
+}));
+
+import { copyToClipboard } from "@selesai/code";
+
+type AnyMessage = any;
+type Handler = (event: any, ctx: any) => any;
+type Command = { description: string; handler: (args: string, ctx: any) => Promise<void> };
+
+const MARK_RE = /\n?\n?\s*⧉ copy(?:\s+\w+)?: \/cp ([0-9a-f]{6,12})\s*$/;
+
+function hashFromMarkedText(text: string): string {
+	const m = text.match(MARK_RE);
+	if (!m) throw new Error(`no copy marker found in: ${JSON.stringify(text)}`);
+	return m[1]!;
+}
+
+function createHarness() {
+	const handlers = new Map<string, Handler>();
+	const commands = new Map<string, Command>();
+	const sent: AnyMessage[] = [];
+	const pi = {
+		on: vi.fn((event: string, handler: Handler) => {
+			handlers.set(event, handler);
+		}),
+		registerCommand: vi.fn((name: string, opts: Command) => {
+			commands.set(name, opts);
+		}),
+		registerMessageRenderer: vi.fn(),
+		sendMessage: vi.fn((msg: AnyMessage) => {
+			sent.push(msg);
+		}),
+	};
+	copyTurnExtension(pi as any);
+	return { handlers, commands, sent, pi };
+}
+
+function branchCtx(messages: AnyMessage[]) {
+	return {
+		sessionManager: { getBranch: () => messages.map((message) => ({ type: "message", message })) },
+		ui: { notify: vi.fn() },
+	};
+}
+
+describe("copy-turn hash stability", () => {
+	beforeEach(() => {
+		vi.clearAllMocks();
+	});
+
+	it("recomputes the displayed assistant hash from the persisted message despite metadata changes", async () => {
+		const { handlers, commands } = createHarness();
+		const messageEnd = handlers.get("message_end")!;
+
+		// Transient message as seen by message_end (before persistence).
+		const transient = {
+			role: "assistant",
+			content: [{ type: "text", text: "Fix the copy bug now." }],
+			stopReason: "done",
+		};
+		const result = await messageEnd({ type: "message_end", message: transient }, {});
+		const markedText = result.message.content[0].text as string;
+		const displayedHash = hashFromMarkedText(markedText);
+		expect(displayedHash).toMatch(/^[0-9a-f]{6}$/);
+
+		// Persisted variant: same content plus the copy marker and changed metadata.
+		const persisted = {
+			...result.message,
+			details: { latencyMs: 42 },
+			stopReason: "error",
+			timestamp: 1_700_000_000_000,
+			sessionId: "s-1",
+			msgId: "m-1",
+			usage: { inputTokens: 1, outputTokens: 2 },
+		};
+
+		const ctx = branchCtx([persisted]);
+		const cmd = commands.get("cp")!;
+		await cmd.handler(displayedHash, ctx);
+
+		expect(copyToClipboard).toHaveBeenCalledTimes(1);
+		expect(copyToClipboard).toHaveBeenCalledWith("Fix the copy bug now.");
+		expect(ctx.ui.notify).not.toHaveBeenCalledWith(`No message for hash ${displayedHash}`, "warning");
+		expect(ctx.ui.notify).toHaveBeenCalledWith(`Copied ${displayedHash} (21 chars)`, "info");
+	});
+
+	it("resolves the displayed user hash from the persisted user message despite metadata changes", async () => {
+		const { handlers, commands, sent } = createHarness();
+		const messageEnd = handlers.get("message_end")!;
+
+		await messageEnd({ type: "message_end", message: { role: "user", content: "show me the files" } }, {});
+		const copyRow = sent.find((m) => m.customType === "copy-turn");
+		expect(copyRow).toBeDefined();
+		const displayedHash: string = copyRow.details.hash;
+
+		// Persisted user message with metadata the transient object did not have.
+		const persisted = {
+			role: "user",
+			content: "show me the files",
+			details: { reranked: true },
+			timestamp: 42,
+		};
+
+		const ctx = branchCtx([persisted]);
+		const cmd = commands.get("cp")!;
+		await cmd.handler(displayedHash, ctx);
+
+		expect(copyToClipboard).toHaveBeenCalledTimes(1);
+		expect(copyToClipboard).toHaveBeenCalledWith("show me the files");
+		expect(ctx.ui.notify).not.toHaveBeenCalledWith(`No message for hash ${displayedHash}`, "warning");
+	});
+
+	it("strips existing copy markers before hashing", async () => {
+		const { handlers } = createHarness();
+		const messageEnd = handlers.get("message_end")!;
+
+		const plain = { role: "assistant", content: [{ type: "text", text: "Same content" }] };
+		const alreadyMarked = {
+			role: "assistant",
+			content: [{ type: "text", text: "Same content\n\n⧉ copy assistant: /cp abc123" }],
+		};
+
+		const r1 = await messageEnd({ type: "message_end", message: plain }, {});
+		const r2 = await messageEnd({ type: "message_end", message: alreadyMarked }, {});
+
+		expect(hashFromMarkedText(r1.message.content[0].text)).toBe(hashFromMarkedText(r2.message.content[0].text));
+	});
+});

package/dist/extensions/copy-turn.ts

@@ -39,7 +39,12 @@ function resultOf(message: AnyMessage): string {
 }
 
 function hashFor(m: AnyMessage): string {
-  return createHash("sha1").update(JSON.stringify(cleanMessage(m))).digest("hex").slice(0, HASH_LEN);
+  // Hash the stable copy identity (role + cleaned copy result) only, so the hash
+  // shown at display time (computed from the transient message) still matches the
+  // one /cp recomputes from the persisted message, whose metadata may have changed.
+  const role = m.role ?? "message";
+  const text = resultOf(m);
+  return createHash("sha1").update(JSON.stringify([role, text])).digest("hex").slice(0, HASH_LEN);
 }
 
 function addMarker(m: AnyMessage): AnyMessage {

package/dist/extensions/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json

@@ -0,0 +1 @@
+{"version":"4.1.9","results":[[":handoff-new.test.ts",{"duration":0,"failed":true}]]}

package/dist/extensions/package.json

@@ -5,7 +5,6 @@
 	"description": "Built-in extensions shipped with @selesai/code, loaded via additionalExtensionPaths at boot.",
 	"pi": {
 		"extensions": [
-			"./caveman/index.js",
 			"./copy-turn.ts",
 			"./context-compaction-reminder.ts",
 			"./pi-intercom/index.ts",

package/dist/extensions/pi-subagents/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## [Unreleased]
 
+### Changed
+- Made per-child debug artifacts opt-in with `artifacts: true` instead of writing prompt, output, transcript, and metadata copies for every run by default.
+
 ## [0.40.0] - 2026-08-01
 
 ### Added