@xopcai/xopc 0.0.99 → 0.0.101

package/dist/src/agent/prompt/sanitize-for-prompt.js

@@ -0,0 +1,13 @@
+//#region src/agent/prompt/sanitize-for-prompt.ts
+/**
+* Sanitize untrusted strings before embedding them into an LLM prompt.
+*
+* Strips control/format characters that could break prompt structure or inject instructions.
+*/
+function sanitizeForPromptLiteral(value) {
+	return value.replace(/[\p{Cc}\p{Cf}\u2028\u2029]/gu, "");
+}
+//#endregion
+export { sanitizeForPromptLiteral };
+
+//# sourceMappingURL=sanitize-for-prompt.js.map

package/dist/src/agent/prompt/sanitize-for-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-for-prompt.js","names":[],"sources":["../../../../src/agent/prompt/sanitize-for-prompt.ts"],"sourcesContent":["/**\n * Sanitize untrusted strings before embedding them into an LLM prompt.\n *\n * Strips control/format characters that could break prompt structure or inject instructions.\n */\nexport function sanitizeForPromptLiteral(value: string): string {\n  return value.replace(/[\\p{Cc}\\p{Cf}\\u2028\\u2029]/gu, '');\n}\n"],"mappings":";;;;;;AAKA,SAAgB,yBAAyB,OAAuB;AAC9D,QAAO,MAAM,QAAQ,gCAAgC,GAAG"}

package/dist/src/agent/prompt/sections/behavior.d.ts

@@ -0,0 +1,5 @@
+export declare function buildToolCallStyleSection(): string;
+export declare function buildExecutionBiasSection(): string;
+export declare function buildProblemSolvingSection(): string;
+export declare function buildAestheticSection(): string;
+export declare function buildSafetySection(): string;

package/dist/src/agent/prompt/sections/behavior.js

@@ -0,0 +1,50 @@
+//#region src/agent/prompt/sections/behavior.ts
+function buildToolCallStyleSection() {
+	return [
+		"## Tool Call Style",
+		"Default: do not narrate routine, low-risk tool calls (just call the tool).",
+		"Narrate only when it helps: multi-step work, complex/challenging problems, sensitive actions (e.g., deletions), or when the user explicitly asks.",
+		"Keep narration brief and value-dense; avoid repeating obvious steps.",
+		"Use plain human language for narration unless in a technical context.",
+		"When a first-class tool exists for an action, use the tool directly instead of asking the user to run equivalent CLI commands."
+	].join("\n");
+}
+function buildExecutionBiasSection() {
+	return [
+		"## Execution Bias",
+		"- Actionable request: act in this turn.",
+		"- Non-final turn: use tools to advance, or ask for the one missing decision that blocks safe progress.",
+		"- Continue until done or genuinely blocked; do not finish with a plan/promise when tools can move it forward.",
+		"- Weak/empty tool result: vary query, path, command, or source before concluding.",
+		"- Mutable facts need live checks: files, git, clocks, versions, services, processes, package state.",
+		"- Final answer needs evidence: test/build/lint, screenshot, inspection, tool output, or a named blocker.",
+		"- Longer work: brief progress update, then keep going; use delegation or workflows when they fit."
+	].join("\n");
+}
+function buildProblemSolvingSection() {
+	return [
+		"## Problem Solving",
+		"**Simple tasks** (< 5 minutes or a single-file change): Do them directly; run a quick verification after changes.",
+		"**Complex tasks** (multiple files or design decisions): Use an iterative flow — Plan → Build → Verify → Fix.",
+		"**Core principle: Match the complexity; reject ritual for its own sake. Verification matters, but do not verify just to tick a box.**"
+	].join("\n");
+}
+function buildAestheticSection() {
+	return [
+		"## Tone & Style",
+		"**Default voice:** Direct, concise, concrete.",
+		"**SOUL.md takes precedence:** If SOUL.md defines a specific tone, defer to it over the above."
+	].join("\n");
+}
+function buildSafetySection() {
+	return [
+		"## Safety",
+		"- You have no independent goals: do not pursue self-preservation, replication, resource acquisition, or power-seeking; avoid long-term plans beyond the user's request.",
+		"- Prioritize safety and human oversight over completion; if instructions conflict, pause and ask; comply with stop/pause/audit requests and never bypass safeguards.",
+		"- Do not manipulate or persuade anyone to expand access or disable safeguards. Do not copy yourself or change system prompts, safety rules, or tool policies unless explicitly requested."
+	].join("\n");
+}
+//#endregion
+export { buildAestheticSection, buildExecutionBiasSection, buildProblemSolvingSection, buildSafetySection, buildToolCallStyleSection };
+
+//# sourceMappingURL=behavior.js.map

package/dist/src/agent/prompt/sections/behavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"behavior.js","names":[],"sources":["../../../../../src/agent/prompt/sections/behavior.ts"],"sourcesContent":["export function buildToolCallStyleSection(): string {\n  return [\n    '## Tool Call Style',\n    'Default: do not narrate routine, low-risk tool calls (just call the tool).',\n    'Narrate only when it helps: multi-step work, complex/challenging problems, sensitive actions (e.g., deletions), or when the user explicitly asks.',\n    'Keep narration brief and value-dense; avoid repeating obvious steps.',\n    'Use plain human language for narration unless in a technical context.',\n    'When a first-class tool exists for an action, use the tool directly instead of asking the user to run equivalent CLI commands.',\n  ].join('\\n');\n}\n\nexport function buildExecutionBiasSection(): string {\n  return [\n    '## Execution Bias',\n    '- Actionable request: act in this turn.',\n    '- Non-final turn: use tools to advance, or ask for the one missing decision that blocks safe progress.',\n    '- Continue until done or genuinely blocked; do not finish with a plan/promise when tools can move it forward.',\n    '- Weak/empty tool result: vary query, path, command, or source before concluding.',\n    '- Mutable facts need live checks: files, git, clocks, versions, services, processes, package state.',\n    '- Final answer needs evidence: test/build/lint, screenshot, inspection, tool output, or a named blocker.',\n    '- Longer work: brief progress update, then keep going; use delegation or workflows when they fit.',\n  ].join('\\n');\n}\n\nexport function buildProblemSolvingSection(): string {\n  return [\n    '## Problem Solving',\n    '**Simple tasks** (< 5 minutes or a single-file change): Do them directly; run a quick verification after changes.',\n    '**Complex tasks** (multiple files or design decisions): Use an iterative flow — Plan → Build → Verify → Fix.',\n    '**Core principle: Match the complexity; reject ritual for its own sake. Verification matters, but do not verify just to tick a box.**',\n  ].join('\\n');\n}\n\nexport function buildAestheticSection(): string {\n  return [\n    '## Tone & Style',\n    '**Default voice:** Direct, concise, concrete.',\n    '**SOUL.md takes precedence:** If SOUL.md defines a specific tone, defer to it over the above.',\n  ].join('\\n');\n}\n\nexport function buildSafetySection(): string {\n  return [\n    '## Safety',\n    '- You have no independent goals: do not pursue self-preservation, replication, resource acquisition, or power-seeking; avoid long-term plans beyond the user\\'s request.',\n    '- Prioritize safety and human oversight over completion; if instructions conflict, pause and ask; comply with stop/pause/audit requests and never bypass safeguards.',\n    '- Do not manipulate or persuade anyone to expand access or disable safeguards. Do not copy yourself or change system prompts, safety rules, or tool policies unless explicitly requested.',\n  ].join('\\n');\n}\n"],"mappings":";AAAA,SAAgB,4BAAoC;AAClD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,4BAAoC;AAClD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,6BAAqC;AACnD,QAAO;EACL;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,wBAAgC;AAC9C,QAAO;EACL;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,qBAA6B;AAC3C,QAAO;EACL;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK"}

package/dist/src/agent/prompt/sections/memory-skills.d.ts

@@ -0,0 +1,9 @@
+import type { MemoryCitationsMode } from '../types.js';
+export declare function buildMemorySection(params: {
+    availableTools: Set<string>;
+    citationsMode?: MemoryCitationsMode;
+    hasProfileMemory?: boolean;
+    includeMemorySection?: boolean;
+}): string;
+export declare function buildExternalMemorySection(text: string | undefined): string;
+export declare function buildSkillsSection(hasSkillTools: boolean): string;

package/dist/src/agent/prompt/sections/memory-skills.js

@@ -0,0 +1,59 @@
+//#region src/agent/prompt/sections/memory-skills.ts
+function buildMemorySection(params) {
+	if (params.includeMemorySection === false) return "";
+	if (!(params.availableTools.has("memory_search") || params.availableTools.has("memory_get") || params.availableTools.has("curated_memory")) && !params.hasProfileMemory) return "";
+	const citationsMode = params.citationsMode ?? "on";
+	const citationInstruction = citationsMode === "off" ? "Citations are disabled: do not mention file paths or line numbers in replies." : citationsMode === "source-only" ? "Citations: mention file path when it helps (e.g., Source: MEMORY.md)." : "Citations: include Source: <path#line> when it helps the user verify memory snippets.";
+	const toolLines = [];
+	if (params.availableTools.has("memory_search")) toolLines.push("1. Run `memory_search` on profile MEMORY.md and workspace `memory/*.md`");
+	if (params.availableTools.has("session_search")) toolLines.push(`${toolLines.length + 1}. For **other chat sessions** / cross-session history, use \`session_search\` with keywords (or omit \`query\` to list recent sessions)`);
+	if (params.availableTools.has("memory_get")) toolLines.push(`${toolLines.length + 1}. Use \`memory_get\` to pull only the needed lines from files`);
+	if (params.availableTools.has("curated_memory")) toolLines.push(`${toolLines.length + 1}. For structured curated notes under agent home \`memories/\`, use \`curated_memory\``);
+	toolLines.push(`${toolLines.length + 1}. If low confidence after search, say you checked`);
+	return [
+		"## Memory Recall",
+		"",
+		citationInstruction,
+		"",
+		"Startup profile files (SOUL, USER, MEMORY, etc.) are already in Project Context above when injected. Do not re-read them unless the user asks or you need lines beyond what was injected.",
+		"",
+		"Before answering anything about prior work, decisions, dates, people, preferences, or todos:",
+		...toolLines,
+		"",
+		"### Memory Files",
+		"",
+		"- **Daily notes:** `memory/YYYY-MM-DD.md` — raw logs (runtime may preload recent days on /new or reset)",
+		"- **Long-term:** profile `MEMORY.md` — curated memories in Project Context when present",
+		"- **Curated store:** agent home `memories/MEMORY.md` and `memories/USER.md` — use `curated_memory` for live read/write",
+		"",
+		"### Writing to Memory",
+		"",
+		"- **Declarative vs procedural:** Save facts and preferences via workspace memory files and/or `curated_memory`. Save reusable task playbooks with `skill_manage` as skills.",
+		"- **Memory is limited** — if you want to remember something, WRITE IT TO A FILE",
+		"- When someone says \"remember this\" → update `memory/YYYY-MM-DD.md` or relevant file",
+		"- **Text > Brain**"
+	].join("\n");
+}
+function buildExternalMemorySection(text) {
+	const t = text?.trim();
+	if (!t) return "";
+	return `## External memory provider\n\n${t}`;
+}
+function buildSkillsSection(hasSkillTools) {
+	if (!hasSkillTools) return "";
+	return [
+		"## Skills (mandatory)",
+		"Before replying: scan <available_skills> <description> entries.",
+		"- If exactly one skill clearly applies: use `skill_view(name)` to load its SKILL.md, then follow it.",
+		"- If multiple could apply: choose the most specific one, then load/follow it.",
+		"- If none clearly apply: do not load any SKILL.md.",
+		"Constraints: never load more than one skill up front; only load after selecting.",
+		"- When a skill drives external API writes, assume rate limits: prefer fewer larger writes, avoid tight one-item loops, serialize bursts when possible, and respect 429/Retry-After.",
+		"",
+		"**Division of labor with memory:** Skills = **procedural** workflows; memory / `curated_memory` = **declarative** facts and preferences."
+	].join("\n");
+}
+//#endregion
+export { buildExternalMemorySection, buildMemorySection, buildSkillsSection };
+
+//# sourceMappingURL=memory-skills.js.map

package/dist/src/agent/prompt/sections/memory-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-skills.js","names":[],"sources":["../../../../../src/agent/prompt/sections/memory-skills.ts"],"sourcesContent":["import type { MemoryCitationsMode } from '../types.js';\n\nexport function buildMemorySection(params: {\n  availableTools: Set<string>;\n  citationsMode?: MemoryCitationsMode;\n  hasProfileMemory?: boolean;\n  includeMemorySection?: boolean;\n}): string {\n  if (params.includeMemorySection === false) {\n    return '';\n  }\n  const hasMemoryTools =\n    params.availableTools.has('memory_search') ||\n    params.availableTools.has('memory_get') ||\n    params.availableTools.has('curated_memory');\n  if (!hasMemoryTools && !params.hasProfileMemory) {\n    return '';\n  }\n\n  const citationsMode = params.citationsMode ?? 'on';\n  const citationInstruction =\n    citationsMode === 'off'\n      ? 'Citations are disabled: do not mention file paths or line numbers in replies.'\n      : citationsMode === 'source-only'\n        ? 'Citations: mention file path when it helps (e.g., Source: MEMORY.md).'\n        : 'Citations: include Source: <path#line> when it helps the user verify memory snippets.';\n\n  const toolLines: string[] = [];\n  if (params.availableTools.has('memory_search')) {\n    toolLines.push('1. Run `memory_search` on profile MEMORY.md and workspace `memory/*.md`');\n  }\n  if (params.availableTools.has('session_search')) {\n    toolLines.push(\n      `${toolLines.length + 1}. For **other chat sessions** / cross-session history, use \\`session_search\\` with keywords (or omit \\`query\\` to list recent sessions)`,\n    );\n  }\n  if (params.availableTools.has('memory_get')) {\n    toolLines.push(`${toolLines.length + 1}. Use \\`memory_get\\` to pull only the needed lines from files`);\n  }\n  if (params.availableTools.has('curated_memory')) {\n    toolLines.push(\n      `${toolLines.length + 1}. For structured curated notes under agent home \\`memories/\\`, use \\`curated_memory\\``,\n    );\n  }\n  toolLines.push(`${toolLines.length + 1}. If low confidence after search, say you checked`);\n\n  return [\n    '## Memory Recall',\n    '',\n    citationInstruction,\n    '',\n    'Startup profile files (SOUL, USER, MEMORY, etc.) are already in Project Context above when injected. Do not re-read them unless the user asks or you need lines beyond what was injected.',\n    '',\n    'Before answering anything about prior work, decisions, dates, people, preferences, or todos:',\n    ...toolLines,\n    '',\n    '### Memory Files',\n    '',\n    '- **Daily notes:** `memory/YYYY-MM-DD.md` — raw logs (runtime may preload recent days on /new or reset)',\n    '- **Long-term:** profile `MEMORY.md` — curated memories in Project Context when present',\n    '- **Curated store:** agent home `memories/MEMORY.md` and `memories/USER.md` — use `curated_memory` for live read/write',\n    '',\n    '### Writing to Memory',\n    '',\n    '- **Declarative vs procedural:** Save facts and preferences via workspace memory files and/or `curated_memory`. Save reusable task playbooks with `skill_manage` as skills.',\n    '- **Memory is limited** — if you want to remember something, WRITE IT TO A FILE',\n    '- When someone says \"remember this\" → update `memory/YYYY-MM-DD.md` or relevant file',\n    '- **Text > Brain**',\n  ].join('\\n');\n}\n\nexport function buildExternalMemorySection(text: string | undefined): string {\n  const t = text?.trim();\n  if (!t) {\n    return '';\n  }\n  return `## External memory provider\\n\\n${t}`;\n}\n\nexport function buildSkillsSection(hasSkillTools: boolean): string {\n  if (!hasSkillTools) {\n    return '';\n  }\n\n  return [\n    '## Skills (mandatory)',\n    'Before replying: scan <available_skills> <description> entries.',\n    '- If exactly one skill clearly applies: use `skill_view(name)` to load its SKILL.md, then follow it.',\n    '- If multiple could apply: choose the most specific one, then load/follow it.',\n    '- If none clearly apply: do not load any SKILL.md.',\n    'Constraints: never load more than one skill up front; only load after selecting.',\n    '- When a skill drives external API writes, assume rate limits: prefer fewer larger writes, avoid tight one-item loops, serialize bursts when possible, and respect 429/Retry-After.',\n    '',\n    '**Division of labor with memory:** Skills = **procedural** workflows; memory / `curated_memory` = **declarative** facts and preferences.',\n  ].join('\\n');\n}\n"],"mappings":";AAEA,SAAgB,mBAAmB,QAKxB;AACT,KAAI,OAAO,yBAAyB,MAClC,QAAO;AAMT,KAAI,EAHF,OAAO,eAAe,IAAI,gBAAgB,IAC1C,OAAO,eAAe,IAAI,aAAa,IACvC,OAAO,eAAe,IAAI,iBAAiB,KACtB,CAAC,OAAO,iBAC7B,QAAO;CAGT,MAAM,gBAAgB,OAAO,iBAAiB;CAC9C,MAAM,sBACJ,kBAAkB,QACd,kFACA,kBAAkB,gBAChB,0EACA;CAER,MAAM,YAAsB,EAAE;AAC9B,KAAI,OAAO,eAAe,IAAI,gBAAgB,CAC5C,WAAU,KAAK,0EAA0E;AAE3F,KAAI,OAAO,eAAe,IAAI,iBAAiB,CAC7C,WAAU,KACR,GAAG,UAAU,SAAS,EAAE,yIACzB;AAEH,KAAI,OAAO,eAAe,IAAI,aAAa,CACzC,WAAU,KAAK,GAAG,UAAU,SAAS,EAAE,+DAA+D;AAExG,KAAI,OAAO,eAAe,IAAI,iBAAiB,CAC7C,WAAU,KACR,GAAG,UAAU,SAAS,EAAE,uFACzB;AAEH,WAAU,KAAK,GAAG,UAAU,SAAS,EAAE,mDAAmD;AAE1F,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA,GAAG;EACH;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,2BAA2B,MAAkC;CAC3E,MAAM,IAAI,MAAM,MAAM;AACtB,KAAI,CAAC,EACH,QAAO;AAET,QAAO,kCAAkC;;AAG3C,SAAgB,mBAAmB,eAAgC;AACjE,KAAI,CAAC,cACH,QAAO;AAGT,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK"}

package/dist/src/agent/prompt/sections/messaging-runtime.d.ts

@@ -0,0 +1,16 @@
+export declare function buildMessagingSection(params: {
+    channels: string[];
+    isMinimal: boolean;
+    hasSendMessage: boolean;
+}): string;
+export declare function buildSilentRepliesSection(params: {
+    isMinimal: boolean;
+    silentReplyPromptMode?: 'generic' | 'none';
+}): string;
+export declare function buildOutputDirectivesSection(isMinimal: boolean): string;
+export declare function buildTimeSection(timezone?: string): string;
+export declare function buildHeartbeatBehaviorSection(params: {
+    enabled: boolean;
+    customPrompt?: string;
+    userTimezone?: string;
+}): string;

package/dist/src/agent/prompt/sections/messaging-runtime.js

@@ -0,0 +1,69 @@
+import { NO_REPLY } from "../../../heartbeat/tokens.js";
+//#region src/agent/prompt/sections/messaging-runtime.ts
+function buildMessagingSection(params) {
+	if (params.isMinimal || params.channels.length === 0) return "";
+	const channelList = params.channels.join(", ");
+	const messageToolLine = params.hasSendMessage ? `- Use \`send_message\` for proactive sends + channel actions` : "- Outbound messaging tools are not available in this session";
+	return [
+		"## Messaging",
+		`- Reply in current session → automatically routes to the source channel (${channelList})`,
+		messageToolLine,
+		`- If you use \`send_message\` to deliver your user-visible reply, respond with ONLY: ${NO_REPLY} (avoid duplicate replies)`
+	].join("\n");
+}
+function buildSilentRepliesSection(params) {
+	if (params.isMinimal || params.silentReplyPromptMode === "none") return "";
+	return [
+		"## Silent Replies",
+		`When you have nothing to say, respond with ONLY: ${NO_REPLY}`,
+		"",
+		"Rules:",
+		"- It must be your ENTIRE message — nothing else",
+		`- Never append it to an actual response (never include "${NO_REPLY}" in real replies)`,
+		"- Never wrap it in markdown or code blocks",
+		"",
+		`Wrong: "Here's help... ${NO_REPLY}"`,
+		`Right: ${NO_REPLY}`
+	].join("\n");
+}
+function buildOutputDirectivesSection(isMinimal) {
+	if (isMinimal) return "";
+	return [
+		"## Assistant Output Directives",
+		"Use these when you need delivery metadata in an assistant message:",
+		"- `MEDIA:<path-or-url>` on its own line requests attachment delivery. Supported clients strip MEDIA lines and render attachments inline; channels still decide actual delivery behavior.",
+		"- `[[audio_as_voice]]` marks attached audio as a voice-note style delivery hint when supported.",
+		"- To request a native reply/quote on supported surfaces, include one reply tag in your reply:",
+		"- Reply tags must be the very first token in the message (no leading text/newlines): [[reply_to_current]] your reply.",
+		"- [[reply_to_current]] replies to the triggering message.",
+		"- Prefer [[reply_to_current]]. Use [[reply_to:<id>]] only when an id was explicitly provided.",
+		"Supported tags are stripped before user-visible rendering; support still depends on the current channel config."
+	].join("\n");
+}
+function buildTimeSection(timezone) {
+	if (!timezone) return "";
+	return [
+		"## Current Date & Time",
+		`Time zone: ${timezone}`,
+		"",
+		"If you need the current date/time/day-of-week, use the `session_status` tool or the inbound message timestamp envelope (when present)."
+	].join("\n");
+}
+function buildHeartbeatBehaviorSection(params) {
+	if (!params.enabled) return "";
+	if (params.customPrompt?.trim()) return `## Heartbeats\n\n${params.customPrompt.trim()}`;
+	let quietHoursNote = "";
+	if (params.userTimezone) quietHoursNote = `\n\n> Quiet hours: The user is in **${params.userTimezone}**. Avoid proactive checks during late night (23:00-08:00) unless urgent.`;
+	return [
+		"## Heartbeats",
+		"",
+		"If the current user message is a heartbeat poll and nothing needs attention, reply exactly: HEARTBEAT_OK",
+		"",
+		"If something needs attention, do NOT include \"HEARTBEAT_OK\"; reply with the alert text instead.",
+		quietHoursNote.trim()
+	].filter(Boolean).join("\n");
+}
+//#endregion
+export { buildHeartbeatBehaviorSection, buildMessagingSection, buildOutputDirectivesSection, buildSilentRepliesSection, buildTimeSection };
+
+//# sourceMappingURL=messaging-runtime.js.map

package/dist/src/agent/prompt/sections/messaging-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-runtime.js","names":[],"sources":["../../../../../src/agent/prompt/sections/messaging-runtime.ts"],"sourcesContent":["import { NO_REPLY } from '../../../heartbeat/tokens.js';\n\nexport function buildMessagingSection(params: {\n  channels: string[];\n  isMinimal: boolean;\n  hasSendMessage: boolean;\n}): string {\n  if (params.isMinimal || params.channels.length === 0) {\n    return '';\n  }\n  const channelList = params.channels.join(', ');\n  const messageToolLine = params.hasSendMessage\n    ? `- Use \\`send_message\\` for proactive sends + channel actions`\n    : '- Outbound messaging tools are not available in this session';\n\n  return [\n    '## Messaging',\n    `- Reply in current session → automatically routes to the source channel (${channelList})`,\n    messageToolLine,\n    `- If you use \\`send_message\\` to deliver your user-visible reply, respond with ONLY: ${NO_REPLY} (avoid duplicate replies)`,\n  ].join('\\n');\n}\n\nexport function buildSilentRepliesSection(params: {\n  isMinimal: boolean;\n  silentReplyPromptMode?: 'generic' | 'none';\n}): string {\n  if (params.isMinimal || params.silentReplyPromptMode === 'none') {\n    return '';\n  }\n  return [\n    '## Silent Replies',\n    `When you have nothing to say, respond with ONLY: ${NO_REPLY}`,\n    '',\n    'Rules:',\n    '- It must be your ENTIRE message — nothing else',\n    `- Never append it to an actual response (never include \"${NO_REPLY}\" in real replies)`,\n    '- Never wrap it in markdown or code blocks',\n    '',\n    `Wrong: \"Here's help... ${NO_REPLY}\"`,\n    `Right: ${NO_REPLY}`,\n  ].join('\\n');\n}\n\nexport function buildOutputDirectivesSection(isMinimal: boolean): string {\n  if (isMinimal) {\n    return '';\n  }\n  return [\n    '## Assistant Output Directives',\n    'Use these when you need delivery metadata in an assistant message:',\n    '- `MEDIA:<path-or-url>` on its own line requests attachment delivery. Supported clients strip MEDIA lines and render attachments inline; channels still decide actual delivery behavior.',\n    '- `[[audio_as_voice]]` marks attached audio as a voice-note style delivery hint when supported.',\n    '- To request a native reply/quote on supported surfaces, include one reply tag in your reply:',\n    '- Reply tags must be the very first token in the message (no leading text/newlines): [[reply_to_current]] your reply.',\n    '- [[reply_to_current]] replies to the triggering message.',\n    '- Prefer [[reply_to_current]]. Use [[reply_to:<id>]] only when an id was explicitly provided.',\n    'Supported tags are stripped before user-visible rendering; support still depends on the current channel config.',\n  ].join('\\n');\n}\n\nexport function buildTimeSection(timezone?: string): string {\n  if (!timezone) {\n    return '';\n  }\n  return [\n    '## Current Date & Time',\n    `Time zone: ${timezone}`,\n    '',\n    'If you need the current date/time/day-of-week, use the `session_status` tool or the inbound message timestamp envelope (when present).',\n  ].join('\\n');\n}\n\nexport function buildHeartbeatBehaviorSection(params: {\n  enabled: boolean;\n  customPrompt?: string;\n  userTimezone?: string;\n}): string {\n  if (!params.enabled) {\n    return '';\n  }\n  if (params.customPrompt?.trim()) {\n    return `## Heartbeats\\n\\n${params.customPrompt.trim()}`;\n  }\n  let quietHoursNote = '';\n  if (params.userTimezone) {\n    quietHoursNote = `\\n\\n> Quiet hours: The user is in **${params.userTimezone}**. Avoid proactive checks during late night (23:00-08:00) unless urgent.`;\n  }\n  return [\n    '## Heartbeats',\n    '',\n    'If the current user message is a heartbeat poll and nothing needs attention, reply exactly: HEARTBEAT_OK',\n    '',\n    'If something needs attention, do NOT include \"HEARTBEAT_OK\"; reply with the alert text instead.',\n    quietHoursNote.trim(),\n  ]\n    .filter(Boolean)\n    .join('\\n');\n}\n"],"mappings":";;AAEA,SAAgB,sBAAsB,QAI3B;AACT,KAAI,OAAO,aAAa,OAAO,SAAS,WAAW,EACjD,QAAO;CAET,MAAM,cAAc,OAAO,SAAS,KAAK,KAAK;CAC9C,MAAM,kBAAkB,OAAO,iBAC3B,iEACA;AAEJ,QAAO;EACL;EACA,4EAA4E,YAAY;EACxF;EACA,wFAAwF,SAAS;EAClG,CAAC,KAAK,KAAK;;AAGd,SAAgB,0BAA0B,QAG/B;AACT,KAAI,OAAO,aAAa,OAAO,0BAA0B,OACvD,QAAO;AAET,QAAO;EACL;EACA,oDAAoD;EACpD;EACA;EACA;EACA,2DAA2D,SAAS;EACpE;EACA;EACA,0BAA0B,SAAS;EACnC,UAAU;EACX,CAAC,KAAK,KAAK;;AAGd,SAAgB,6BAA6B,WAA4B;AACvE,KAAI,UACF,QAAO;AAET,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,iBAAiB,UAA2B;AAC1D,KAAI,CAAC,SACH,QAAO;AAET,QAAO;EACL;EACA,cAAc;EACd;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,8BAA8B,QAInC;AACT,KAAI,CAAC,OAAO,QACV,QAAO;AAET,KAAI,OAAO,cAAc,MAAM,CAC7B,QAAO,oBAAoB,OAAO,aAAa,MAAM;CAEvD,IAAI,iBAAiB;AACrB,KAAI,OAAO,aACT,kBAAiB,uCAAuC,OAAO,aAAa;AAE9E,QAAO;EACL;EACA;EACA;EACA;EACA;EACA,eAAe,MAAM;EACtB,CACE,OAAO,QAAQ,CACf,KAAK,KAAK"}

package/dist/src/agent/prompt/sections/project-context.d.ts

@@ -0,0 +1,16 @@
+import type { EmbeddedContextFile } from '../../bootstrap/types.js';
+export declare const CONTEXT_FILE_ORDER: Map<string, number>;
+export declare const DYNAMIC_CONTEXT_FILE_BASENAMES: Set<string>;
+export declare const DEFAULT_HEARTBEAT_PROMPT_CONTEXT_BLOCK = "Default heartbeat prompt:\n`Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`";
+export declare function normalizeContextFilePath(pathValue: string): string;
+export declare function getContextFileBasename(pathValue: string): string;
+export declare function isDynamicContextFile(pathValue: string): boolean;
+export declare function sanitizeContextFileContentForPrompt(content: string): string;
+export declare function sortContextFilesForPrompt(contextFiles: EmbeddedContextFile[]): EmbeddedContextFile[];
+export declare function buildProjectContextSection(params: {
+    files: EmbeddedContextFile[];
+    heading: string;
+    dynamic: boolean;
+}): string[];
+/** Whether HEARTBEAT.md is injected as dynamic context (vs behavior-only section). */
+export declare function isHeartbeatContextFile(pathValue: string): boolean;

package/dist/src/agent/prompt/sections/project-context.js

@@ -0,0 +1,58 @@
+import { DEFAULT_HEARTBEAT_FILENAME } from "../../context/workspace.js";
+//#region src/agent/prompt/sections/project-context.ts
+const CONTEXT_FILE_ORDER = new Map([
+	["agents.md", 10],
+	["soul.md", 20],
+	["identity.md", 30],
+	["user.md", 40],
+	["tools.md", 50],
+	["bootstrap.md", 60],
+	["memory.md", 70]
+]);
+const DYNAMIC_CONTEXT_FILE_BASENAMES = new Set(["heartbeat.md"]);
+const DEFAULT_HEARTBEAT_PROMPT_CONTEXT_BLOCK = "Default heartbeat prompt:\n`Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`";
+function normalizeContextFilePath(pathValue) {
+	return pathValue.trim().replace(/\\/g, "/");
+}
+function getContextFileBasename(pathValue) {
+	const normalizedPath = normalizeContextFilePath(pathValue);
+	return (normalizedPath.split("/").pop() ?? normalizedPath).toLowerCase();
+}
+function isDynamicContextFile(pathValue) {
+	return DYNAMIC_CONTEXT_FILE_BASENAMES.has(getContextFileBasename(pathValue));
+}
+function sanitizeContextFileContentForPrompt(content) {
+	return content.replaceAll(DEFAULT_HEARTBEAT_PROMPT_CONTEXT_BLOCK, "").replace(/\n{3,}/g, "\n\n");
+}
+function sortContextFilesForPrompt(contextFiles) {
+	return [...contextFiles].sort((a, b) => {
+		const aBase = getContextFileBasename(a.path);
+		const bBase = getContextFileBasename(b.path);
+		const aOrder = CONTEXT_FILE_ORDER.get(aBase) ?? Number.MAX_SAFE_INTEGER;
+		const bOrder = CONTEXT_FILE_ORDER.get(bBase) ?? Number.MAX_SAFE_INTEGER;
+		if (aOrder !== bOrder) return aOrder - bOrder;
+		if (aBase !== bBase) return aBase.localeCompare(bBase);
+		return normalizeContextFilePath(a.path).localeCompare(normalizeContextFilePath(b.path));
+	});
+}
+function buildProjectContextSection(params) {
+	if (params.files.length === 0) return [];
+	const lines = [params.heading, ""];
+	if (params.dynamic) lines.push("The following frequently-changing project context files are kept below the cache boundary when possible:", "");
+	else {
+		const hasSoulFile = params.files.some((file) => getContextFileBasename(file.path) === "soul.md");
+		lines.push("The following project context files have been loaded:");
+		if (hasSoulFile) lines.push("If SOUL.md is present, embody its persona and tone. Avoid stiff, generic replies; follow its guidance unless higher-priority instructions override it.");
+		lines.push("");
+	}
+	for (const file of params.files) lines.push(`## ${file.path}`, "", sanitizeContextFileContentForPrompt(file.content), "");
+	return lines;
+}
+/** Whether HEARTBEAT.md is injected as dynamic context (vs behavior-only section). */
+function isHeartbeatContextFile(pathValue) {
+	return getContextFileBasename(pathValue) === DEFAULT_HEARTBEAT_FILENAME.toLowerCase();
+}
+//#endregion
+export { CONTEXT_FILE_ORDER, DEFAULT_HEARTBEAT_PROMPT_CONTEXT_BLOCK, DYNAMIC_CONTEXT_FILE_BASENAMES, buildProjectContextSection, getContextFileBasename, isDynamicContextFile, isHeartbeatContextFile, normalizeContextFilePath, sanitizeContextFileContentForPrompt, sortContextFilesForPrompt };
+
+//# sourceMappingURL=project-context.js.map

package/dist/src/agent/prompt/sections/project-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.js","names":[],"sources":["../../../../../src/agent/prompt/sections/project-context.ts"],"sourcesContent":["import type { EmbeddedContextFile } from '../../bootstrap/types.js';\nimport { DEFAULT_HEARTBEAT_FILENAME } from '../../context/workspace.js';\n\nexport const CONTEXT_FILE_ORDER = new Map<string, number>([\n  ['agents.md', 10],\n  ['soul.md', 20],\n  ['identity.md', 30],\n  ['user.md', 40],\n  ['tools.md', 50],\n  ['bootstrap.md', 60],\n  ['memory.md', 70],\n]);\n\nexport const DYNAMIC_CONTEXT_FILE_BASENAMES = new Set(['heartbeat.md']);\n\nexport const DEFAULT_HEARTBEAT_PROMPT_CONTEXT_BLOCK =\n  'Default heartbeat prompt:\\n`Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`';\n\nexport function normalizeContextFilePath(pathValue: string): string {\n  return pathValue.trim().replace(/\\\\/g, '/');\n}\n\nexport function getContextFileBasename(pathValue: string): string {\n  const normalizedPath = normalizeContextFilePath(pathValue);\n  return (normalizedPath.split('/').pop() ?? normalizedPath).toLowerCase();\n}\n\nexport function isDynamicContextFile(pathValue: string): boolean {\n  return DYNAMIC_CONTEXT_FILE_BASENAMES.has(getContextFileBasename(pathValue));\n}\n\nexport function sanitizeContextFileContentForPrompt(content: string): string {\n  return content.replaceAll(DEFAULT_HEARTBEAT_PROMPT_CONTEXT_BLOCK, '').replace(/\\n{3,}/g, '\\n\\n');\n}\n\nexport function sortContextFilesForPrompt(contextFiles: EmbeddedContextFile[]): EmbeddedContextFile[] {\n  return [...contextFiles].sort((a, b) => {\n    const aBase = getContextFileBasename(a.path);\n    const bBase = getContextFileBasename(b.path);\n    const aOrder = CONTEXT_FILE_ORDER.get(aBase) ?? Number.MAX_SAFE_INTEGER;\n    const bOrder = CONTEXT_FILE_ORDER.get(bBase) ?? Number.MAX_SAFE_INTEGER;\n    if (aOrder !== bOrder) {\n      return aOrder - bOrder;\n    }\n    if (aBase !== bBase) {\n      return aBase.localeCompare(bBase);\n    }\n    return normalizeContextFilePath(a.path).localeCompare(normalizeContextFilePath(b.path));\n  });\n}\n\nexport function buildProjectContextSection(params: {\n  files: EmbeddedContextFile[];\n  heading: string;\n  dynamic: boolean;\n}): string[] {\n  if (params.files.length === 0) {\n    return [];\n  }\n  const lines: string[] = [params.heading, ''];\n  if (params.dynamic) {\n    lines.push(\n      'The following frequently-changing project context files are kept below the cache boundary when possible:',\n      '',\n    );\n  } else {\n    const hasSoulFile = params.files.some((file) => getContextFileBasename(file.path) === 'soul.md');\n    lines.push('The following project context files have been loaded:');\n    if (hasSoulFile) {\n      lines.push(\n        'If SOUL.md is present, embody its persona and tone. Avoid stiff, generic replies; follow its guidance unless higher-priority instructions override it.',\n      );\n    }\n    lines.push('');\n  }\n  for (const file of params.files) {\n    lines.push(`## ${file.path}`, '', sanitizeContextFileContentForPrompt(file.content), '');\n  }\n  return lines;\n}\n\n/** Whether HEARTBEAT.md is injected as dynamic context (vs behavior-only section). */\nexport function isHeartbeatContextFile(pathValue: string): boolean {\n  return getContextFileBasename(pathValue) === DEFAULT_HEARTBEAT_FILENAME.toLowerCase();\n}\n"],"mappings":";;AAGA,MAAa,qBAAqB,IAAI,IAAoB;CACxD,CAAC,aAAa,GAAG;CACjB,CAAC,WAAW,GAAG;CACf,CAAC,eAAe,GAAG;CACnB,CAAC,WAAW,GAAG;CACf,CAAC,YAAY,GAAG;CAChB,CAAC,gBAAgB,GAAG;CACpB,CAAC,aAAa,GAAG;CAClB,CAAC;AAEF,MAAa,iCAAiC,IAAI,IAAI,CAAC,eAAe,CAAC;AAEvE,MAAa,yCACX;AAEF,SAAgB,yBAAyB,WAA2B;AAClE,QAAO,UAAU,MAAM,CAAC,QAAQ,OAAO,IAAI;;AAG7C,SAAgB,uBAAuB,WAA2B;CAChE,MAAM,iBAAiB,yBAAyB,UAAU;AAC1D,SAAQ,eAAe,MAAM,IAAI,CAAC,KAAK,IAAI,gBAAgB,aAAa;;AAG1E,SAAgB,qBAAqB,WAA4B;AAC/D,QAAO,+BAA+B,IAAI,uBAAuB,UAAU,CAAC;;AAG9E,SAAgB,oCAAoC,SAAyB;AAC3E,QAAO,QAAQ,WAAW,wCAAwC,GAAG,CAAC,QAAQ,WAAW,OAAO;;AAGlG,SAAgB,0BAA0B,cAA4D;AACpG,QAAO,CAAC,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM;EACtC,MAAM,QAAQ,uBAAuB,EAAE,KAAK;EAC5C,MAAM,QAAQ,uBAAuB,EAAE,KAAK;EAC5C,MAAM,SAAS,mBAAmB,IAAI,MAAM,IAAI,OAAO;EACvD,MAAM,SAAS,mBAAmB,IAAI,MAAM,IAAI,OAAO;AACvD,MAAI,WAAW,OACb,QAAO,SAAS;AAElB,MAAI,UAAU,MACZ,QAAO,MAAM,cAAc,MAAM;AAEnC,SAAO,yBAAyB,EAAE,KAAK,CAAC,cAAc,yBAAyB,EAAE,KAAK,CAAC;GACvF;;AAGJ,SAAgB,2BAA2B,QAI9B;AACX,KAAI,OAAO,MAAM,WAAW,EAC1B,QAAO,EAAE;CAEX,MAAM,QAAkB,CAAC,OAAO,SAAS,GAAG;AAC5C,KAAI,OAAO,QACT,OAAM,KACJ,4GACA,GACD;MACI;EACL,MAAM,cAAc,OAAO,MAAM,MAAM,SAAS,uBAAuB,KAAK,KAAK,KAAK,UAAU;AAChG,QAAM,KAAK,wDAAwD;AACnE,MAAI,YACF,OAAM,KACJ,yJACD;AAEH,QAAM,KAAK,GAAG;;AAEhB,MAAK,MAAM,QAAQ,OAAO,MACxB,OAAM,KAAK,MAAM,KAAK,QAAQ,IAAI,oCAAoC,KAAK,QAAQ,EAAE,GAAG;AAE1F,QAAO;;;AAIT,SAAgB,uBAAuB,WAA4B;AACjE,QAAO,uBAAuB,UAAU,KAAK,2BAA2B,aAAa"}

package/dist/src/agent/prompt/sections/tooling.d.ts

@@ -0,0 +1,5 @@
+export declare function buildToolingSection(params: {
+    toolNames?: string[];
+    toolSummaries?: Record<string, string>;
+}): string;
+export declare function hasSkillsTools(toolNames: string[]): boolean;

package/dist/src/agent/prompt/sections/tooling.js

@@ -0,0 +1,119 @@
+//#region src/agent/prompt/sections/tooling.ts
+const CORE_TOOL_ORDER = [
+	"read_file",
+	"write_file",
+	"edit_file",
+	"grep",
+	"find",
+	"list_dir",
+	"shell",
+	"web_search",
+	"web_fetch",
+	"web_extract",
+	"browser_use",
+	"send_message",
+	"send_media",
+	"memory_search",
+	"memory_get",
+	"session_search",
+	"curated_memory",
+	"session_status",
+	"delegate_task",
+	"workflow",
+	"cronjob",
+	"skills_list",
+	"skill_view",
+	"skill_manage",
+	"todo",
+	"clarify",
+	"text_to_speech",
+	"image",
+	"image_generate",
+	"create_share",
+	"execute_code"
+];
+const CORE_TOOL_SUMMARIES = {
+	read_file: "Read file contents",
+	write_file: "Create or overwrite files",
+	edit_file: "Make precise edits to files",
+	grep: "Search file contents for patterns",
+	find: "Find files by glob pattern",
+	list_dir: "List directory contents",
+	shell: "Run shell commands (supports background via yieldMs/background)",
+	web_search: "Search the web",
+	web_fetch: "Fetch and extract readable content from a URL",
+	web_extract: "Extract structured content from a URL",
+	browser_use: "Control the configured browser",
+	send_message: "Send messages to the current channel",
+	send_media: "Send media attachments to the current channel",
+	memory_search: "Semantic search over workspace and profile memory files",
+	memory_get: "Read specific lines from memory files",
+	session_search: "Search other chat sessions or list recent sessions",
+	curated_memory: "Read/write structured notes under agent home memories/",
+	session_status: "Show session usage/time/model state",
+	delegate_task: "Spawn an isolated sub-agent for a delegated task",
+	workflow: "Start a persisted multi-phase workflow run",
+	cronjob: "Manage scheduled cron jobs",
+	skills_list: "List available skills",
+	skill_view: "Load a skill SKILL.md or sub-documents",
+	skill_manage: "Create or update skills on disk",
+	todo: "Manage in-session todo items",
+	clarify: "Ask the user a blocking clarification question",
+	text_to_speech: "Send a standalone voice message",
+	image: "Analyze an image with the configured vision model",
+	image_generate: "Generate images with the configured image model",
+	create_share: "Create a shareable link for workspace files",
+	execute_code: "Run code in a sandbox with a restricted tool subset"
+};
+function buildToolingSection(params) {
+	const rawToolNames = (params.toolNames ?? []).map((tool) => tool.trim()).filter(Boolean);
+	const canonicalByNormalized = /* @__PURE__ */ new Map();
+	for (const name of rawToolNames) {
+		const normalized = name.toLowerCase();
+		if (!canonicalByNormalized.has(normalized)) canonicalByNormalized.set(normalized, name);
+	}
+	const resolveToolName = (normalized) => canonicalByNormalized.get(normalized) ?? normalized;
+	const normalizedTools = rawToolNames.map((tool) => tool.toLowerCase());
+	const availableTools = new Set(normalizedTools);
+	const externalToolSummaries = /* @__PURE__ */ new Map();
+	for (const [key, value] of Object.entries(params.toolSummaries ?? {})) {
+		const normalized = key.trim().toLowerCase();
+		if (!normalized || !value?.trim()) continue;
+		externalToolSummaries.set(normalized, value.trim());
+	}
+	const extraTools = Array.from(new Set(normalizedTools.filter((tool) => !CORE_TOOL_ORDER.includes(tool))));
+	const toolLines = CORE_TOOL_ORDER.filter((tool) => availableTools.has(tool)).map((tool) => {
+		const summary = CORE_TOOL_SUMMARIES[tool] ?? externalToolSummaries.get(tool);
+		const name = resolveToolName(tool);
+		return summary ? `- ${name}: ${summary}` : `- ${name}`;
+	});
+	for (const tool of extraTools.toSorted()) {
+		const summary = CORE_TOOL_SUMMARIES[tool] ?? externalToolSummaries.get(tool);
+		const name = resolveToolName(tool);
+		toolLines.push(summary ? `- ${name}: ${summary}` : `- ${name}`);
+	}
+	const shellToolName = resolveToolName("shell");
+	const hasDelegate = availableTools.has("delegate_task");
+	const hasWorkflow = availableTools.has("workflow");
+	const orchestrationLines = [];
+	if (hasDelegate) orchestrationLines.push("- Sub-agent delegation → use `delegate_task(goal, context?, toolset?)` for focused parallel work; results return to you automatically.");
+	if (hasWorkflow) orchestrationLines.push("- Multi-phase workflows → use `workflow` to start persisted runs with subagents when a script defines phases.");
+	return [
+		"## Tooling",
+		"Tool availability (filtered by policy):",
+		"Tool names are case-sensitive. Call tools exactly as listed.",
+		toolLines.length > 0 ? toolLines.join("\n") : "- No tools are registered for this session.",
+		`For long waits, avoid rapid poll loops: use \`${shellToolName}\` with enough yieldMs or poll in reasonable intervals.`,
+		hasDelegate ? "If a task is complex or long-running, delegate it. Completion is push-based: the sub-agent result returns when done." : "",
+		...orchestrationLines,
+		"Do not poll delegate/workflow status in a tight loop; check on-demand or wait for completion."
+	].filter(Boolean).join("\n");
+}
+function hasSkillsTools(toolNames) {
+	const normalized = new Set(toolNames.map((t) => t.toLowerCase()));
+	return normalized.has("skills_list") || normalized.has("skill_view");
+}
+//#endregion
+export { buildToolingSection, hasSkillsTools };
+
+//# sourceMappingURL=tooling.js.map

package/dist/src/agent/prompt/sections/tooling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooling.js","names":[],"sources":["../../../../../src/agent/prompt/sections/tooling.ts"],"sourcesContent":["const CORE_TOOL_ORDER = [\n  'read_file',\n  'write_file',\n  'edit_file',\n  'grep',\n  'find',\n  'list_dir',\n  'shell',\n  'web_search',\n  'web_fetch',\n  'web_extract',\n  'browser_use',\n  'send_message',\n  'send_media',\n  'memory_search',\n  'memory_get',\n  'session_search',\n  'curated_memory',\n  'session_status',\n  'delegate_task',\n  'workflow',\n  'cronjob',\n  'skills_list',\n  'skill_view',\n  'skill_manage',\n  'todo',\n  'clarify',\n  'text_to_speech',\n  'image',\n  'image_generate',\n  'create_share',\n  'execute_code',\n] as const;\n\nconst CORE_TOOL_SUMMARIES: Record<string, string> = {\n  read_file: 'Read file contents',\n  write_file: 'Create or overwrite files',\n  edit_file: 'Make precise edits to files',\n  grep: 'Search file contents for patterns',\n  find: 'Find files by glob pattern',\n  list_dir: 'List directory contents',\n  shell: 'Run shell commands (supports background via yieldMs/background)',\n  web_search: 'Search the web',\n  web_fetch: 'Fetch and extract readable content from a URL',\n  web_extract: 'Extract structured content from a URL',\n  browser_use: 'Control the configured browser',\n  send_message: 'Send messages to the current channel',\n  send_media: 'Send media attachments to the current channel',\n  memory_search: 'Semantic search over workspace and profile memory files',\n  memory_get: 'Read specific lines from memory files',\n  session_search: 'Search other chat sessions or list recent sessions',\n  curated_memory: 'Read/write structured notes under agent home memories/',\n  session_status: 'Show session usage/time/model state',\n  delegate_task: 'Spawn an isolated sub-agent for a delegated task',\n  workflow: 'Start a persisted multi-phase workflow run',\n  cronjob: 'Manage scheduled cron jobs',\n  skills_list: 'List available skills',\n  skill_view: 'Load a skill SKILL.md or sub-documents',\n  skill_manage: 'Create or update skills on disk',\n  todo: 'Manage in-session todo items',\n  clarify: 'Ask the user a blocking clarification question',\n  text_to_speech: 'Send a standalone voice message',\n  image: 'Analyze an image with the configured vision model',\n  image_generate: 'Generate images with the configured image model',\n  create_share: 'Create a shareable link for workspace files',\n  execute_code: 'Run code in a sandbox with a restricted tool subset',\n};\n\nexport function buildToolingSection(params: {\n  toolNames?: string[];\n  toolSummaries?: Record<string, string>;\n}): string {\n  const rawToolNames = (params.toolNames ?? []).map((tool) => tool.trim()).filter(Boolean);\n  const canonicalByNormalized = new Map<string, string>();\n  for (const name of rawToolNames) {\n    const normalized = name.toLowerCase();\n    if (!canonicalByNormalized.has(normalized)) {\n      canonicalByNormalized.set(normalized, name);\n    }\n  }\n  const resolveToolName = (normalized: string) =>\n    canonicalByNormalized.get(normalized) ?? normalized;\n\n  const normalizedTools = rawToolNames.map((tool) => tool.toLowerCase());\n  const availableTools = new Set(normalizedTools);\n\n  const externalToolSummaries = new Map<string, string>();\n  for (const [key, value] of Object.entries(params.toolSummaries ?? {})) {\n    const normalized = key.trim().toLowerCase();\n    if (!normalized || !value?.trim()) {\n      continue;\n    }\n    externalToolSummaries.set(normalized, value.trim());\n  }\n\n  const extraTools = Array.from(\n    new Set(normalizedTools.filter((tool) => !CORE_TOOL_ORDER.includes(tool as (typeof CORE_TOOL_ORDER)[number]))),\n  );\n  const enabledTools = CORE_TOOL_ORDER.filter((tool) => availableTools.has(tool));\n  const toolLines = enabledTools.map((tool) => {\n    const summary = CORE_TOOL_SUMMARIES[tool] ?? externalToolSummaries.get(tool);\n    const name = resolveToolName(tool);\n    return summary ? `- ${name}: ${summary}` : `- ${name}`;\n  });\n  for (const tool of extraTools.toSorted()) {\n    const summary = CORE_TOOL_SUMMARIES[tool] ?? externalToolSummaries.get(tool);\n    const name = resolveToolName(tool);\n    toolLines.push(summary ? `- ${name}: ${summary}` : `- ${name}`);\n  }\n\n  const shellToolName = resolveToolName('shell');\n  const hasDelegate = availableTools.has('delegate_task');\n  const hasWorkflow = availableTools.has('workflow');\n\n  const orchestrationLines: string[] = [];\n  if (hasDelegate) {\n    orchestrationLines.push(\n      '- Sub-agent delegation → use `delegate_task(goal, context?, toolset?)` for focused parallel work; results return to you automatically.',\n    );\n  }\n  if (hasWorkflow) {\n    orchestrationLines.push(\n      '- Multi-phase workflows → use `workflow` to start persisted runs with subagents when a script defines phases.',\n    );\n  }\n\n  return [\n    '## Tooling',\n    'Tool availability (filtered by policy):',\n    'Tool names are case-sensitive. Call tools exactly as listed.',\n    toolLines.length > 0\n      ? toolLines.join('\\n')\n      : '- No tools are registered for this session.',\n    `For long waits, avoid rapid poll loops: use \\`${shellToolName}\\` with enough yieldMs or poll in reasonable intervals.`,\n    hasDelegate\n      ? 'If a task is complex or long-running, delegate it. Completion is push-based: the sub-agent result returns when done.'\n      : '',\n    ...orchestrationLines,\n    'Do not poll delegate/workflow status in a tight loop; check on-demand or wait for completion.',\n  ]\n    .filter(Boolean)\n    .join('\\n');\n}\n\nexport function hasSkillsTools(toolNames: string[]): boolean {\n  const normalized = new Set(toolNames.map((t) => t.toLowerCase()));\n  return normalized.has('skills_list') || normalized.has('skill_view');\n}\n"],"mappings":";AAAA,MAAM,kBAAkB;CACtB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAM,sBAA8C;CAClD,WAAW;CACX,YAAY;CACZ,WAAW;CACX,MAAM;CACN,MAAM;CACN,UAAU;CACV,OAAO;CACP,YAAY;CACZ,WAAW;CACX,aAAa;CACb,aAAa;CACb,cAAc;CACd,YAAY;CACZ,eAAe;CACf,YAAY;CACZ,gBAAgB;CAChB,gBAAgB;CAChB,gBAAgB;CAChB,eAAe;CACf,UAAU;CACV,SAAS;CACT,aAAa;CACb,YAAY;CACZ,cAAc;CACd,MAAM;CACN,SAAS;CACT,gBAAgB;CAChB,OAAO;CACP,gBAAgB;CAChB,cAAc;CACd,cAAc;CACf;AAED,SAAgB,oBAAoB,QAGzB;CACT,MAAM,gBAAgB,OAAO,aAAa,EAAE,EAAE,KAAK,SAAS,KAAK,MAAM,CAAC,CAAC,OAAO,QAAQ;CACxF,MAAM,wCAAwB,IAAI,KAAqB;AACvD,MAAK,MAAM,QAAQ,cAAc;EAC/B,MAAM,aAAa,KAAK,aAAa;AACrC,MAAI,CAAC,sBAAsB,IAAI,WAAW,CACxC,uBAAsB,IAAI,YAAY,KAAK;;CAG/C,MAAM,mBAAmB,eACvB,sBAAsB,IAAI,WAAW,IAAI;CAE3C,MAAM,kBAAkB,aAAa,KAAK,SAAS,KAAK,aAAa,CAAC;CACtE,MAAM,iBAAiB,IAAI,IAAI,gBAAgB;CAE/C,MAAM,wCAAwB,IAAI,KAAqB;AACvD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,iBAAiB,EAAE,CAAC,EAAE;EACrE,MAAM,aAAa,IAAI,MAAM,CAAC,aAAa;AAC3C,MAAI,CAAC,cAAc,CAAC,OAAO,MAAM,CAC/B;AAEF,wBAAsB,IAAI,YAAY,MAAM,MAAM,CAAC;;CAGrD,MAAM,aAAa,MAAM,KACvB,IAAI,IAAI,gBAAgB,QAAQ,SAAS,CAAC,gBAAgB,SAAS,KAAyC,CAAC,CAAC,CAC/G;CAED,MAAM,YADe,gBAAgB,QAAQ,SAAS,eAAe,IAAI,KAAK,CAChD,CAAC,KAAK,SAAS;EAC3C,MAAM,UAAU,oBAAoB,SAAS,sBAAsB,IAAI,KAAK;EAC5E,MAAM,OAAO,gBAAgB,KAAK;AAClC,SAAO,UAAU,KAAK,KAAK,IAAI,YAAY,KAAK;GAChD;AACF,MAAK,MAAM,QAAQ,WAAW,UAAU,EAAE;EACxC,MAAM,UAAU,oBAAoB,SAAS,sBAAsB,IAAI,KAAK;EAC5E,MAAM,OAAO,gBAAgB,KAAK;AAClC,YAAU,KAAK,UAAU,KAAK,KAAK,IAAI,YAAY,KAAK,OAAO;;CAGjE,MAAM,gBAAgB,gBAAgB,QAAQ;CAC9C,MAAM,cAAc,eAAe,IAAI,gBAAgB;CACvD,MAAM,cAAc,eAAe,IAAI,WAAW;CAElD,MAAM,qBAA+B,EAAE;AACvC,KAAI,YACF,oBAAmB,KACjB,yIACD;AAEH,KAAI,YACF,oBAAmB,KACjB,gHACD;AAGH,QAAO;EACL;EACA;EACA;EACA,UAAU,SAAS,IACf,UAAU,KAAK,KAAK,GACpB;EACJ,iDAAiD,cAAc;EAC/D,cACI,yHACA;EACJ,GAAG;EACH;EACD,CACE,OAAO,QAAQ,CACf,KAAK,KAAK;;AAGf,SAAgB,eAAe,WAA8B;CAC3D,MAAM,aAAa,IAAI,IAAI,UAAU,KAAK,MAAM,EAAE,aAAa,CAAC,CAAC;AACjE,QAAO,WAAW,IAAI,cAAc,IAAI,WAAW,IAAI,aAAa"}

package/dist/src/agent/prompt/sections/workspace-runtime.d.ts

@@ -0,0 +1,11 @@
+export type RuntimeInfoInput = {
+    version?: string;
+    model?: string;
+    channel?: string;
+    agentId?: string;
+    thinkingLevel?: string;
+    capabilities?: string[];
+};
+export declare function buildWorkspaceSection(workspaceDir: string): string;
+export declare function buildWorkspaceFilesIntroSection(): string;
+export declare function buildRuntimeSection(runtime?: RuntimeInfoInput): string;

package/dist/src/agent/prompt/sections/workspace-runtime.js

@@ -0,0 +1,32 @@
+import { sanitizeForPromptLiteral } from "../sanitize-for-prompt.js";
+//#region src/agent/prompt/sections/workspace-runtime.ts
+function buildWorkspaceSection(workspaceDir) {
+	return [
+		"## Workspace",
+		`Your working directory is: ${sanitizeForPromptLiteral(workspaceDir)}`,
+		"Treat this directory as the single global workspace for file operations unless explicitly instructed otherwise."
+	].join("\n");
+}
+function buildWorkspaceFilesIntroSection() {
+	return [
+		"## Workspace Files (injected)",
+		"",
+		"Profile bootstrap files are injected below as Project Context. Do not manually reread them at session start unless the user asks or injected content is insufficient."
+	].join("\n");
+}
+function buildRuntimeSection(runtime) {
+	if (!runtime) return "";
+	const parts = [];
+	if (runtime.agentId) parts.push(`agent=${runtime.agentId}`);
+	if (runtime.version) parts.push(`v${runtime.version}`);
+	if (runtime.model) parts.push(`model=${runtime.model.split("/").pop() ?? runtime.model}`);
+	if (runtime.channel) parts.push(`channel=${runtime.channel}`);
+	if (runtime.capabilities && runtime.capabilities.length > 0) parts.push(`capabilities=${runtime.capabilities.join(",")}`);
+	if (runtime.thinkingLevel) parts.push(`thinking=${runtime.thinkingLevel}`);
+	if (parts.length === 0) return "";
+	return ["## Runtime", `Runtime: ${parts.join(" | ")}`].join("\n");
+}
+//#endregion
+export { buildRuntimeSection, buildWorkspaceFilesIntroSection, buildWorkspaceSection };
+
+//# sourceMappingURL=workspace-runtime.js.map

package/dist/src/agent/prompt/sections/workspace-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-runtime.js","names":[],"sources":["../../../../../src/agent/prompt/sections/workspace-runtime.ts"],"sourcesContent":["import { sanitizeForPromptLiteral } from '../sanitize-for-prompt.js';\n\nexport type RuntimeInfoInput = {\n  version?: string;\n  model?: string;\n  channel?: string;\n  agentId?: string;\n  thinkingLevel?: string;\n  capabilities?: string[];\n};\n\nexport function buildWorkspaceSection(workspaceDir: string): string {\n  const sanitized = sanitizeForPromptLiteral(workspaceDir);\n  return [\n    '## Workspace',\n    `Your working directory is: ${sanitized}`,\n    'Treat this directory as the single global workspace for file operations unless explicitly instructed otherwise.',\n  ].join('\\n');\n}\n\nexport function buildWorkspaceFilesIntroSection(): string {\n  return [\n    '## Workspace Files (injected)',\n    '',\n    'Profile bootstrap files are injected below as Project Context. Do not manually reread them at session start unless the user asks or injected content is insufficient.',\n  ].join('\\n');\n}\n\nexport function buildRuntimeSection(runtime?: RuntimeInfoInput): string {\n  if (!runtime) {\n    return '';\n  }\n  const parts: string[] = [];\n  if (runtime.agentId) parts.push(`agent=${runtime.agentId}`);\n  if (runtime.version) parts.push(`v${runtime.version}`);\n  if (runtime.model) parts.push(`model=${runtime.model.split('/').pop() ?? runtime.model}`);\n  if (runtime.channel) parts.push(`channel=${runtime.channel}`);\n  if (runtime.capabilities && runtime.capabilities.length > 0) {\n    parts.push(`capabilities=${runtime.capabilities.join(',')}`);\n  }\n  if (runtime.thinkingLevel) parts.push(`thinking=${runtime.thinkingLevel}`);\n  if (parts.length === 0) {\n    return '';\n  }\n  return ['## Runtime', `Runtime: ${parts.join(' | ')}`].join('\\n');\n}\n"],"mappings":";;AAWA,SAAgB,sBAAsB,cAA8B;AAElE,QAAO;EACL;EACA,8BAHgB,yBAAyB,aAGF;EACvC;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,kCAA0C;AACxD,QAAO;EACL;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,oBAAoB,SAAoC;AACtE,KAAI,CAAC,QACH,QAAO;CAET,MAAM,QAAkB,EAAE;AAC1B,KAAI,QAAQ,QAAS,OAAM,KAAK,SAAS,QAAQ,UAAU;AAC3D,KAAI,QAAQ,QAAS,OAAM,KAAK,IAAI,QAAQ,UAAU;AACtD,KAAI,QAAQ,MAAO,OAAM,KAAK,SAAS,QAAQ,MAAM,MAAM,IAAI,CAAC,KAAK,IAAI,QAAQ,QAAQ;AACzF,KAAI,QAAQ,QAAS,OAAM,KAAK,WAAW,QAAQ,UAAU;AAC7D,KAAI,QAAQ,gBAAgB,QAAQ,aAAa,SAAS,EACxD,OAAM,KAAK,gBAAgB,QAAQ,aAAa,KAAK,IAAI,GAAG;AAE9D,KAAI,QAAQ,cAAe,OAAM,KAAK,YAAY,QAAQ,gBAAgB;AAC1E,KAAI,MAAM,WAAW,EACnB,QAAO;AAET,QAAO,CAAC,cAAc,YAAY,MAAM,KAAK,MAAM,GAAG,CAAC,KAAK,KAAK"}

package/dist/src/agent/prompt/service-prompt-builder.d.ts

@@ -6,6 +6,8 @@
 import type { Config } from '../../config/schema.js';
 import type { EmbeddedContextFile } from '../bootstrap/types.js';
 import type { SkillManager } from '../skills/skill-manager.js';
+import type { PromptMode, SilentReplyPromptMode } from './types.js';
+import type { ProviderSystemPromptContribution } from './contribution.js';
 export interface SystemPromptBuildOptions {
     externalMemoryInstructions?: string;
     workspaceOverride?: string;
@@ -14,6 +16,15 @@ export interface SystemPromptBuildOptions {
     skillPromptText?: string;
     skillAllowlist?: string[];
     registeredToolNames?: string[];
+    toolSummaries?: Record<string, string>;
+    sessionKey?: string;
+    promptMode?: PromptMode;
+    modelRef?: string;
+    agentId?: string;
+    thinkingLevel?: string;
+    extraSystemPrompt?: string;
+    silentReplyPromptMode?: SilentReplyPromptMode;
+    promptContribution?: ProviderSystemPromptContribution;
 }
 export interface SystemPromptBuilderConfig {
     workspace: string;
@@ -34,6 +45,8 @@ export declare class SystemPromptBuilder {
         externalMemoryInstructions?: string;
         workspaceOverride?: string;
         profileMarkdownPathRoot?: string;
+        registeredToolNames?: string[];
+        sessionKey?: string;
     }): string;
 }
 export declare function createSystemPromptBuilder(config: SystemPromptBuilderConfig): SystemPromptBuilder;