@xopcai/xopc 0.0.99 → 0.0.100

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":"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"}

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;

package/dist/src/agent/prompt/service-prompt-builder.js

@@ -3,11 +3,12 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths } from "../../config/paths.js";
 import { DEFAULT_USER_FILENAME } from "../context/workspace.js";
+import { resolveSystemPromptBuildParams } from "./system-prompt-params.js";
+import { buildSystemPrompt } from "./system-prompt.js";
 import { createSkillConfigManager } from "../skills/config.js";
 import { buildTtsSystemPromptHint } from "../../voice/tts/directives.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { selectSkillsVisibleInPrompt } from "../skills/format-skills-prompt.js";
-import { buildSystemPrompt } from "./system-prompt.js";
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/agent/prompt/service-prompt-builder.ts
@@ -63,16 +64,42 @@ var SystemPromptBuilder = class {
 			modelOverrides: ttsMerged.modelOverrides,
 			textToSpeechTool: ttsMerged.enabled && reg.includes("text_to_speech")
 		});
-		const basePrompt = buildSystemPrompt(ws, {
-			contextFiles,
-			heartbeatEnabled,
-			availableTools: this.getSkillNamesForSkillsSection({
-				skillAllowlist: options.skillAllowlist,
-				registeredToolNames: options.registeredToolNames
-			}),
+		const resolved = resolveSystemPromptBuildParams(this.config, {
+			workspaceDir: ws,
+			sessionKey: options.sessionKey,
+			toolNames: options.registeredToolNames,
+			toolSummaries: options.toolSummaries,
 			userTimezone,
 			externalMemoryInstructions: options.externalMemoryInstructions,
-			ttsSystemHint
+			heartbeatEnabled,
+			ttsSystemHint,
+			extraSystemPrompt: options.extraSystemPrompt,
+			modelRef: options.modelRef,
+			agentId: options.agentId,
+			thinkingLevel: options.thinkingLevel,
+			promptMode: options.promptMode,
+			silentReplyPromptMode: options.silentReplyPromptMode,
+			promptContribution: options.promptContribution
+		});
+		const basePrompt = buildSystemPrompt(ws, {
+			contextFiles,
+			promptMode: resolved.promptMode,
+			heartbeatEnabled: resolved.heartbeatEnabled,
+			heartbeatPrompt: resolved.heartbeatPrompt,
+			toolNames: resolved.toolNames,
+			toolSummaries: resolved.toolSummaries,
+			memoryCitationsMode: resolved.memoryCitationsMode,
+			includeMemorySection: resolved.includeMemorySection,
+			userTimezone: resolved.userTimezone,
+			runtime: resolved.runtimeInfo,
+			channels: resolved.channels,
+			externalMemoryInstructions: resolved.externalMemoryInstructions,
+			ttsSystemHint: resolved.ttsSystemHint,
+			extraSystemPrompt: resolved.extraSystemPrompt,
+			silentReplyPromptMode: resolved.silentReplyPromptMode,
+			promptContribution: resolved.promptContribution,
+			includeProblemSolving: resolved.includeProblemSolving,
+			includeToneSection: resolved.includeToneSection
 		});
 		const skillPrompt = options.skillPromptText !== void 0 ? options.skillPromptText : this.skillManager.getPromptForSkillAllowlist(options.skillAllowlist, options.registeredToolNames);
 		const fullPrompt = skillPrompt ? `${basePrompt}\n\n${skillPrompt}` : basePrompt;
@@ -80,7 +107,9 @@ var SystemPromptBuilder = class {
 			baseLength: basePrompt.length,
 			skillLength: skillPrompt?.length || 0,
 			totalLength: fullPrompt.length,
-			contextFileCount: contextFiles.length
+			contextFileCount: contextFiles.length,
+			promptMode: resolved.promptMode,
+			toolCount: resolved.toolNames?.length ?? 0
 		}, "System prompt built");
 		return fullPrompt;
 	}
@@ -113,11 +142,23 @@ var SystemPromptBuilder = class {
 	getBasePrompt(contextFiles, options) {
 		const ws = options?.workspaceOverride ?? this.workspace;
 		const profilePathRoot = options?.profileMarkdownPathRoot ?? ws;
+		const resolved = resolveSystemPromptBuildParams(this.config, {
+			workspaceDir: ws,
+			sessionKey: options?.sessionKey,
+			toolNames: options?.registeredToolNames,
+			userTimezone: this.extractTimezone(contextFiles, profilePathRoot),
+			externalMemoryInstructions: options?.externalMemoryInstructions,
+			heartbeatEnabled: this.config.gateway?.heartbeat?.includeSystemPromptSection ?? false
+		});
 		return buildSystemPrompt(ws, {
 			contextFiles,
-			heartbeatEnabled: this.config.gateway?.heartbeat?.includeSystemPromptSection ?? false,
-			userTimezone: this.extractTimezone(contextFiles, profilePathRoot),
-			externalMemoryInstructions: options?.externalMemoryInstructions
+			promptMode: resolved.promptMode,
+			heartbeatEnabled: resolved.heartbeatEnabled,
+			toolNames: resolved.toolNames,
+			userTimezone: resolved.userTimezone,
+			runtime: resolved.runtimeInfo,
+			channels: resolved.channels,
+			externalMemoryInstructions: resolved.externalMemoryInstructions
 		});
 	}
 };

package/dist/src/agent/prompt/service-prompt-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"service-prompt-builder.js","names":["buildBaseSystemPrompt"],"sources":["../../../../src/agent/prompt/service-prompt-builder.ts"],"sourcesContent":["/**\n * System Prompt Builder - Builds the complete system prompt\n *\n * Combines base system prompt with skill prompts and bootstrap Project Context.\n */\n\nimport { readFileSync, existsSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport type { Config } from '../../config/schema.js';\nimport type { EmbeddedContextFile } from '../bootstrap/types.js';\nimport { DEFAULT_USER_FILENAME } from '../context/workspace.js';\nimport type { SkillManager } from '../skills/skill-manager.js';\nimport { createSkillConfigManager } from '../skills/config.js';\nimport { selectSkillsVisibleInPrompt } from '../skills/format-skills-prompt.js';\nimport { resolveStateDir } from '../../config/paths.js';\nimport { buildSystemPrompt as buildBaseSystemPrompt } from './system-prompt.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\nimport { buildTtsSystemPromptHint } from '../../voice/tts/directives.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('SystemPromptBuilder');\n\nexport interface SystemPromptBuildOptions {\n  externalMemoryInstructions?: string;\n  workspaceOverride?: string;\n  profileMarkdownPathRoot?: string;\n  systemPromptOverride?: string;\n  skillPromptText?: string;\n  skillAllowlist?: string[];\n  registeredToolNames?: string[];\n}\n\nexport interface SystemPromptBuilderConfig {\n  workspace: string;\n  config: Config;\n  skillManager: SkillManager;\n}\n\nexport class SystemPromptBuilder {\n  private workspace: string;\n  private config: Config;\n  private skillManager: SkillManager;\n\n  constructor(config: SystemPromptBuilderConfig) {\n    this.workspace = config.workspace;\n    this.config = config.config;\n    this.skillManager = config.skillManager;\n  }\n\n  build(contextFiles: EmbeddedContextFile[], options: SystemPromptBuildOptions): string {\n    const ws = options.workspaceOverride ?? this.workspace;\n    const profilePathRoot = options.profileMarkdownPathRoot ?? ws;\n\n    if (options.systemPromptOverride?.trim()) {\n      const skillPrompt =\n        options.skillPromptText !== undefined\n          ? options.skillPromptText\n          : this.skillManager.getPromptForSkillAllowlist(\n              options.skillAllowlist,\n              options.registeredToolNames,\n            );\n      const trimmed = options.systemPromptOverride.trim();\n      let fullPrompt = skillPrompt.trim() ? `${trimmed}\\n\\n${skillPrompt}` : trimmed;\n      const ttsMerged = mergeTtsConfigFromAppConfig(this.config.messages?.tts);\n      const reg = options.registeredToolNames ?? [];\n      const ttsHint = buildTtsSystemPromptHint({\n        enabled: ttsMerged.enabled,\n        trigger: ttsMerged.trigger,\n        maxTextLength: ttsMerged.maxTextLength,\n        modelOverrides: ttsMerged.modelOverrides,\n        textToSpeechTool: ttsMerged.enabled && reg.includes('text_to_speech'),\n      });\n      if (ttsHint?.trim()) {\n        fullPrompt = `${fullPrompt}\\n\\n## Voice (TTS)\\n\\n${ttsHint.trim()}`;\n      }\n      log.debug({ baseLength: trimmed.length, skillLength: skillPrompt.length, totalLength: fullPrompt.length }, 'System prompt built (override)');\n      return fullPrompt;\n    }\n\n    const heartbeatEnabled = this.config.gateway?.heartbeat?.includeSystemPromptSection ?? false;\n    const userTimezone = this.extractTimezone(contextFiles, profilePathRoot);\n\n    const ttsMerged = mergeTtsConfigFromAppConfig(this.config.messages?.tts);\n    const reg = options.registeredToolNames ?? [];\n    const ttsSystemHint = buildTtsSystemPromptHint({\n      enabled: ttsMerged.enabled,\n      trigger: ttsMerged.trigger,\n      maxTextLength: ttsMerged.maxTextLength,\n      modelOverrides: ttsMerged.modelOverrides,\n      textToSpeechTool: ttsMerged.enabled && reg.includes('text_to_speech'),\n    });\n\n    const basePrompt = buildBaseSystemPrompt(ws, {\n      contextFiles,\n      heartbeatEnabled,\n      availableTools: this.getSkillNamesForSkillsSection({\n        skillAllowlist: options.skillAllowlist,\n        registeredToolNames: options.registeredToolNames,\n      }),\n      userTimezone,\n      externalMemoryInstructions: options.externalMemoryInstructions,\n      ttsSystemHint,\n    });\n\n    const skillPrompt =\n      options.skillPromptText !== undefined\n        ? options.skillPromptText\n        : this.skillManager.getPromptForSkillAllowlist(\n            options.skillAllowlist,\n            options.registeredToolNames,\n          );\n\n    const fullPrompt = skillPrompt ? `${basePrompt}\\n\\n${skillPrompt}` : basePrompt;\n\n    log.debug(\n      {\n        baseLength: basePrompt.length,\n        skillLength: skillPrompt?.length || 0,\n        totalLength: fullPrompt.length,\n        contextFileCount: contextFiles.length,\n      },\n      'System prompt built',\n    );\n\n    return fullPrompt;\n  }\n\n  rebuild(contextFiles: EmbeddedContextFile[], options: SystemPromptBuildOptions): string {\n    this.skillManager.reload();\n    return this.build(contextFiles, options);\n  }\n\n  private extractTimezone(contextFiles: EmbeddedContextFile[], profilePathRoot: string): string | undefined {\n    const userContext = contextFiles.find((file) =>\n      file.path.replace(/\\\\/g, '/').toLowerCase().endsWith('/user.md'),\n    );\n    if (userContext?.content) {\n      const match = userContext.content.match(/Timezone:\\s*(.+)/i);\n      if (match) {\n        return match[1].trim();\n      }\n    }\n\n    const primaryPath = join(profilePathRoot, DEFAULT_USER_FILENAME);\n    if (existsSync(primaryPath)) {\n      try {\n        const raw = readFileSync(primaryPath, 'utf-8');\n        const match = raw.match(/Timezone:\\s*(.+)/i);\n        if (match) {\n          return match[1].trim();\n        }\n      } catch {\n        /* ignore */\n      }\n    }\n\n    return undefined;\n  }\n\n  private getSkillNamesForSkillsSection(options?: {\n    skillAllowlist?: string[];\n    registeredToolNames?: string[];\n  }): string[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return selectSkillsVisibleInPrompt(this.skillManager.getSkills(), skillsConfig, {\n      skillAllowlist: options?.skillAllowlist,\n      registeredToolNames: options?.registeredToolNames,\n    }).map((s) => s.name);\n  }\n\n  getSkillPrompt(): string {\n    return this.skillManager.getPrompt();\n  }\n\n  getBasePrompt(\n    contextFiles: EmbeddedContextFile[],\n    options?: {\n      externalMemoryInstructions?: string;\n      workspaceOverride?: string;\n      profileMarkdownPathRoot?: string;\n    },\n  ): string {\n    const ws = options?.workspaceOverride ?? this.workspace;\n    const profilePathRoot = options?.profileMarkdownPathRoot ?? ws;\n    return buildBaseSystemPrompt(ws, {\n      contextFiles,\n      heartbeatEnabled: this.config.gateway?.heartbeat?.includeSystemPromptSection ?? false,\n      userTimezone: this.extractTimezone(contextFiles, profilePathRoot),\n      externalMemoryInstructions: options?.externalMemoryInstructions,\n    });\n  }\n}\n\nexport function createSystemPromptBuilder(config: SystemPromptBuilderConfig): SystemPromptBuilder {\n  return new SystemPromptBuilder(config);\n}\n\nexport type { SystemPromptBuilderConfig as SystemPromptConfig };\nexport type { SystemPromptBuilderConfig as SystemPromptBuilderOptions };\n"],"mappings":"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"}
+{"version":3,"file":"service-prompt-builder.js","names":["buildBaseSystemPrompt"],"sources":["../../../../src/agent/prompt/service-prompt-builder.ts"],"sourcesContent":["/**\n * System Prompt Builder - Builds the complete system prompt\n *\n * Combines base system prompt with skill prompts and bootstrap Project Context.\n */\n\nimport { readFileSync, existsSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport type { Config } from '../../config/schema.js';\nimport type { EmbeddedContextFile } from '../bootstrap/types.js';\nimport { DEFAULT_USER_FILENAME } from '../context/workspace.js';\nimport type { SkillManager } from '../skills/skill-manager.js';\nimport { createSkillConfigManager } from '../skills/config.js';\nimport { selectSkillsVisibleInPrompt } from '../skills/format-skills-prompt.js';\nimport { resolveStateDir } from '../../config/paths.js';\nimport { buildSystemPrompt as buildBaseSystemPrompt } from './system-prompt.js';\nimport { resolveSystemPromptBuildParams } from './system-prompt-params.js';\nimport type { PromptMode, SilentReplyPromptMode } from './types.js';\nimport type { ProviderSystemPromptContribution } from './contribution.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\nimport { buildTtsSystemPromptHint } from '../../voice/tts/directives.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('SystemPromptBuilder');\n\nexport interface SystemPromptBuildOptions {\n  externalMemoryInstructions?: string;\n  workspaceOverride?: string;\n  profileMarkdownPathRoot?: string;\n  systemPromptOverride?: string;\n  skillPromptText?: string;\n  skillAllowlist?: string[];\n  registeredToolNames?: string[];\n  toolSummaries?: Record<string, string>;\n  sessionKey?: string;\n  promptMode?: PromptMode;\n  modelRef?: string;\n  agentId?: string;\n  thinkingLevel?: string;\n  extraSystemPrompt?: string;\n  silentReplyPromptMode?: SilentReplyPromptMode;\n  promptContribution?: ProviderSystemPromptContribution;\n}\n\nexport interface SystemPromptBuilderConfig {\n  workspace: string;\n  config: Config;\n  skillManager: SkillManager;\n}\n\nexport class SystemPromptBuilder {\n  private workspace: string;\n  private config: Config;\n  private skillManager: SkillManager;\n\n  constructor(config: SystemPromptBuilderConfig) {\n    this.workspace = config.workspace;\n    this.config = config.config;\n    this.skillManager = config.skillManager;\n  }\n\n  build(contextFiles: EmbeddedContextFile[], options: SystemPromptBuildOptions): string {\n    const ws = options.workspaceOverride ?? this.workspace;\n    const profilePathRoot = options.profileMarkdownPathRoot ?? ws;\n\n    if (options.systemPromptOverride?.trim()) {\n      const skillPrompt =\n        options.skillPromptText !== undefined\n          ? options.skillPromptText\n          : this.skillManager.getPromptForSkillAllowlist(\n              options.skillAllowlist,\n              options.registeredToolNames,\n            );\n      const trimmed = options.systemPromptOverride.trim();\n      let fullPrompt = skillPrompt.trim() ? `${trimmed}\\n\\n${skillPrompt}` : trimmed;\n      const ttsMerged = mergeTtsConfigFromAppConfig(this.config.messages?.tts);\n      const reg = options.registeredToolNames ?? [];\n      const ttsHint = buildTtsSystemPromptHint({\n        enabled: ttsMerged.enabled,\n        trigger: ttsMerged.trigger,\n        maxTextLength: ttsMerged.maxTextLength,\n        modelOverrides: ttsMerged.modelOverrides,\n        textToSpeechTool: ttsMerged.enabled && reg.includes('text_to_speech'),\n      });\n      if (ttsHint?.trim()) {\n        fullPrompt = `${fullPrompt}\\n\\n## Voice (TTS)\\n\\n${ttsHint.trim()}`;\n      }\n      log.debug({ baseLength: trimmed.length, skillLength: skillPrompt.length, totalLength: fullPrompt.length }, 'System prompt built (override)');\n      return fullPrompt;\n    }\n\n    const heartbeatEnabled = this.config.gateway?.heartbeat?.includeSystemPromptSection ?? false;\n    const userTimezone = this.extractTimezone(contextFiles, profilePathRoot);\n\n    const ttsMerged = mergeTtsConfigFromAppConfig(this.config.messages?.tts);\n    const reg = options.registeredToolNames ?? [];\n    const ttsSystemHint = buildTtsSystemPromptHint({\n      enabled: ttsMerged.enabled,\n      trigger: ttsMerged.trigger,\n      maxTextLength: ttsMerged.maxTextLength,\n      modelOverrides: ttsMerged.modelOverrides,\n      textToSpeechTool: ttsMerged.enabled && reg.includes('text_to_speech'),\n    });\n\n    const resolved = resolveSystemPromptBuildParams(this.config, {\n      workspaceDir: ws,\n      sessionKey: options.sessionKey,\n      toolNames: options.registeredToolNames,\n      toolSummaries: options.toolSummaries,\n      userTimezone,\n      externalMemoryInstructions: options.externalMemoryInstructions,\n      heartbeatEnabled,\n      ttsSystemHint,\n      extraSystemPrompt: options.extraSystemPrompt,\n      modelRef: options.modelRef,\n      agentId: options.agentId,\n      thinkingLevel: options.thinkingLevel,\n      promptMode: options.promptMode,\n      silentReplyPromptMode: options.silentReplyPromptMode,\n      promptContribution: options.promptContribution,\n    });\n\n    const basePrompt = buildBaseSystemPrompt(ws, {\n      contextFiles,\n      promptMode: resolved.promptMode,\n      heartbeatEnabled: resolved.heartbeatEnabled,\n      heartbeatPrompt: resolved.heartbeatPrompt,\n      toolNames: resolved.toolNames,\n      toolSummaries: resolved.toolSummaries,\n      memoryCitationsMode: resolved.memoryCitationsMode,\n      includeMemorySection: resolved.includeMemorySection,\n      userTimezone: resolved.userTimezone,\n      runtime: resolved.runtimeInfo,\n      channels: resolved.channels,\n      externalMemoryInstructions: resolved.externalMemoryInstructions,\n      ttsSystemHint: resolved.ttsSystemHint,\n      extraSystemPrompt: resolved.extraSystemPrompt,\n      silentReplyPromptMode: resolved.silentReplyPromptMode,\n      promptContribution: resolved.promptContribution,\n      includeProblemSolving: resolved.includeProblemSolving,\n      includeToneSection: resolved.includeToneSection,\n    });\n\n    const skillPrompt =\n      options.skillPromptText !== undefined\n        ? options.skillPromptText\n        : this.skillManager.getPromptForSkillAllowlist(\n            options.skillAllowlist,\n            options.registeredToolNames,\n          );\n\n    const fullPrompt = skillPrompt ? `${basePrompt}\\n\\n${skillPrompt}` : basePrompt;\n\n    log.debug(\n      {\n        baseLength: basePrompt.length,\n        skillLength: skillPrompt?.length || 0,\n        totalLength: fullPrompt.length,\n        contextFileCount: contextFiles.length,\n        promptMode: resolved.promptMode,\n        toolCount: resolved.toolNames?.length ?? 0,\n      },\n      'System prompt built',\n    );\n\n    return fullPrompt;\n  }\n\n  rebuild(contextFiles: EmbeddedContextFile[], options: SystemPromptBuildOptions): string {\n    this.skillManager.reload();\n    return this.build(contextFiles, options);\n  }\n\n  private extractTimezone(contextFiles: EmbeddedContextFile[], profilePathRoot: string): string | undefined {\n    const userContext = contextFiles.find((file) =>\n      file.path.replace(/\\\\/g, '/').toLowerCase().endsWith('/user.md'),\n    );\n    if (userContext?.content) {\n      const match = userContext.content.match(/Timezone:\\s*(.+)/i);\n      if (match) {\n        return match[1].trim();\n      }\n    }\n\n    const primaryPath = join(profilePathRoot, DEFAULT_USER_FILENAME);\n    if (existsSync(primaryPath)) {\n      try {\n        const raw = readFileSync(primaryPath, 'utf-8');\n        const match = raw.match(/Timezone:\\s*(.+)/i);\n        if (match) {\n          return match[1].trim();\n        }\n      } catch {\n        /* ignore */\n      }\n    }\n\n    return undefined;\n  }\n\n  private getSkillNamesForSkillsSection(options?: {\n    skillAllowlist?: string[];\n    registeredToolNames?: string[];\n  }): string[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return selectSkillsVisibleInPrompt(this.skillManager.getSkills(), skillsConfig, {\n      skillAllowlist: options?.skillAllowlist,\n      registeredToolNames: options?.registeredToolNames,\n    }).map((s) => s.name);\n  }\n\n  getSkillPrompt(): string {\n    return this.skillManager.getPrompt();\n  }\n\n  getBasePrompt(\n    contextFiles: EmbeddedContextFile[],\n    options?: {\n      externalMemoryInstructions?: string;\n      workspaceOverride?: string;\n      profileMarkdownPathRoot?: string;\n      registeredToolNames?: string[];\n      sessionKey?: string;\n    },\n  ): string {\n    const ws = options?.workspaceOverride ?? this.workspace;\n    const profilePathRoot = options?.profileMarkdownPathRoot ?? ws;\n    const resolved = resolveSystemPromptBuildParams(this.config, {\n      workspaceDir: ws,\n      sessionKey: options?.sessionKey,\n      toolNames: options?.registeredToolNames,\n      userTimezone: this.extractTimezone(contextFiles, profilePathRoot),\n      externalMemoryInstructions: options?.externalMemoryInstructions,\n      heartbeatEnabled: this.config.gateway?.heartbeat?.includeSystemPromptSection ?? false,\n    });\n    return buildBaseSystemPrompt(ws, {\n      contextFiles,\n      promptMode: resolved.promptMode,\n      heartbeatEnabled: resolved.heartbeatEnabled,\n      toolNames: resolved.toolNames,\n      userTimezone: resolved.userTimezone,\n      runtime: resolved.runtimeInfo,\n      channels: resolved.channels,\n      externalMemoryInstructions: resolved.externalMemoryInstructions,\n    });\n  }\n}\n\nexport function createSystemPromptBuilder(config: SystemPromptBuilderConfig): SystemPromptBuilder {\n  return new SystemPromptBuilder(config);\n}\n\nexport type { SystemPromptBuilderConfig as SystemPromptConfig };\nexport type { SystemPromptBuilderConfig as SystemPromptBuilderOptions };\n"],"mappings":";;;;;;;;;;;;;;;;;;;YAewD;aAOH;AAErD,MAAM,MAAM,aAAa,sBAAsB;AA2B/C,IAAa,sBAAb,MAAiC;CAC/B;CACA;CACA;CAEA,YAAY,QAAmC;AAC7C,OAAK,YAAY,OAAO;AACxB,OAAK,SAAS,OAAO;AACrB,OAAK,eAAe,OAAO;;CAG7B,MAAM,cAAqC,SAA2C;EACpF,MAAM,KAAK,QAAQ,qBAAqB,KAAK;EAC7C,MAAM,kBAAkB,QAAQ,2BAA2B;AAE3D,MAAI,QAAQ,sBAAsB,MAAM,EAAE;GACxC,MAAM,cACJ,QAAQ,oBAAoB,KAAA,IACxB,QAAQ,kBACR,KAAK,aAAa,2BAChB,QAAQ,gBACR,QAAQ,oBACT;GACP,MAAM,UAAU,QAAQ,qBAAqB,MAAM;GACnD,IAAI,aAAa,YAAY,MAAM,GAAG,GAAG,QAAQ,MAAM,gBAAgB;GACvE,MAAM,YAAY,4BAA4B,KAAK,OAAO,UAAU,IAAI;GACxE,MAAM,MAAM,QAAQ,uBAAuB,EAAE;GAC7C,MAAM,UAAU,yBAAyB;IACvC,SAAS,UAAU;IACnB,SAAS,UAAU;IACnB,eAAe,UAAU;IACzB,gBAAgB,UAAU;IAC1B,kBAAkB,UAAU,WAAW,IAAI,SAAS,iBAAiB;IACtE,CAAC;AACF,OAAI,SAAS,MAAM,CACjB,cAAa,GAAG,WAAW,wBAAwB,QAAQ,MAAM;AAEnE,OAAI,MAAM;IAAE,YAAY,QAAQ;IAAQ,aAAa,YAAY;IAAQ,aAAa,WAAW;IAAQ,EAAE,iCAAiC;AAC5I,UAAO;;EAGT,MAAM,mBAAmB,KAAK,OAAO,SAAS,WAAW,8BAA8B;EACvF,MAAM,eAAe,KAAK,gBAAgB,cAAc,gBAAgB;EAExE,MAAM,YAAY,4BAA4B,KAAK,OAAO,UAAU,IAAI;EACxE,MAAM,MAAM,QAAQ,uBAAuB,EAAE;EAC7C,MAAM,gBAAgB,yBAAyB;GAC7C,SAAS,UAAU;GACnB,SAAS,UAAU;GACnB,eAAe,UAAU;GACzB,gBAAgB,UAAU;GAC1B,kBAAkB,UAAU,WAAW,IAAI,SAAS,iBAAiB;GACtE,CAAC;EAEF,MAAM,WAAW,+BAA+B,KAAK,QAAQ;GAC3D,cAAc;GACd,YAAY,QAAQ;GACpB,WAAW,QAAQ;GACnB,eAAe,QAAQ;GACvB;GACA,4BAA4B,QAAQ;GACpC;GACA;GACA,mBAAmB,QAAQ;GAC3B,UAAU,QAAQ;GAClB,SAAS,QAAQ;GACjB,eAAe,QAAQ;GACvB,YAAY,QAAQ;GACpB,uBAAuB,QAAQ;GAC/B,oBAAoB,QAAQ;GAC7B,CAAC;EAEF,MAAM,aAAaA,kBAAsB,IAAI;GAC3C;GACA,YAAY,SAAS;GACrB,kBAAkB,SAAS;GAC3B,iBAAiB,SAAS;GAC1B,WAAW,SAAS;GACpB,eAAe,SAAS;GACxB,qBAAqB,SAAS;GAC9B,sBAAsB,SAAS;GAC/B,cAAc,SAAS;GACvB,SAAS,SAAS;GAClB,UAAU,SAAS;GACnB,4BAA4B,SAAS;GACrC,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,uBAAuB,SAAS;GAChC,oBAAoB,SAAS;GAC7B,uBAAuB,SAAS;GAChC,oBAAoB,SAAS;GAC9B,CAAC;EAEF,MAAM,cACJ,QAAQ,oBAAoB,KAAA,IACxB,QAAQ,kBACR,KAAK,aAAa,2BAChB,QAAQ,gBACR,QAAQ,oBACT;EAEP,MAAM,aAAa,cAAc,GAAG,WAAW,MAAM,gBAAgB;AAErE,MAAI,MACF;GACE,YAAY,WAAW;GACvB,aAAa,aAAa,UAAU;GACpC,aAAa,WAAW;GACxB,kBAAkB,aAAa;GAC/B,YAAY,SAAS;GACrB,WAAW,SAAS,WAAW,UAAU;GAC1C,EACD,sBACD;AAED,SAAO;;CAGT,QAAQ,cAAqC,SAA2C;AACtF,OAAK,aAAa,QAAQ;AAC1B,SAAO,KAAK,MAAM,cAAc,QAAQ;;CAG1C,gBAAwB,cAAqC,iBAA6C;EACxG,MAAM,cAAc,aAAa,MAAM,SACrC,KAAK,KAAK,QAAQ,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,WAAW,CACjE;AACD,MAAI,aAAa,SAAS;GACxB,MAAM,QAAQ,YAAY,QAAQ,MAAM,oBAAoB;AAC5D,OAAI,MACF,QAAO,MAAM,GAAG,MAAM;;EAI1B,MAAM,cAAc,KAAK,iBAAiB,sBAAsB;AAChE,MAAI,WAAW,YAAY,CACzB,KAAI;GAEF,MAAM,QADM,aAAa,aAAa,QACrB,CAAC,MAAM,oBAAoB;AAC5C,OAAI,MACF,QAAO,MAAM,GAAG,MAAM;UAElB;;CAQZ,8BAAsC,SAGzB;EACX,MAAM,eAAe,yBAAyB,iBAAiB,CAAC,CAAC,MAAM;AACvE,SAAO,4BAA4B,KAAK,aAAa,WAAW,EAAE,cAAc;GAC9E,gBAAgB,SAAS;GACzB,qBAAqB,SAAS;GAC/B,CAAC,CAAC,KAAK,MAAM,EAAE,KAAK;;CAGvB,iBAAyB;AACvB,SAAO,KAAK,aAAa,WAAW;;CAGtC,cACE,cACA,SAOQ;EACR,MAAM,KAAK,SAAS,qBAAqB,KAAK;EAC9C,MAAM,kBAAkB,SAAS,2BAA2B;EAC5D,MAAM,WAAW,+BAA+B,KAAK,QAAQ;GAC3D,cAAc;GACd,YAAY,SAAS;GACrB,WAAW,SAAS;GACpB,cAAc,KAAK,gBAAgB,cAAc,gBAAgB;GACjE,4BAA4B,SAAS;GACrC,kBAAkB,KAAK,OAAO,SAAS,WAAW,8BAA8B;GACjF,CAAC;AACF,SAAOA,kBAAsB,IAAI;GAC/B;GACA,YAAY,SAAS;GACrB,kBAAkB,SAAS;GAC3B,WAAW,SAAS;GACpB,cAAc,SAAS;GACvB,SAAS,SAAS;GAClB,UAAU,SAAS;GACnB,4BAA4B,SAAS;GACtC,CAAC;;;AAIN,SAAgB,0BAA0B,QAAwD;AAChG,QAAO,IAAI,oBAAoB,OAAO"}

package/dist/src/agent/prompt/subagent-context.d.ts

@@ -0,0 +1,15 @@
+export declare function buildSubagentContextSection(params: {
+    goal: string;
+    context?: string;
+    workspace?: string;
+    requesterSessionKey?: string;
+    childSessionKey?: string;
+}): string;
+export declare function buildSubagentSystemPrompt(params: {
+    goal: string;
+    context?: string;
+    workspace?: string;
+    requesterSessionKey?: string;
+    childSessionKey?: string;
+    toolNames?: string[];
+}): string;

package/dist/src/agent/prompt/subagent-context.js

@@ -0,0 +1,68 @@
+import { NO_REPLY } from "../../heartbeat/tokens.js";
+import { buildSystemPrompt } from "./system-prompt.js";
+//#region src/agent/prompt/subagent-context.ts
+function buildSubagentContextSection(params) {
+	const taskBody = params.goal.trim();
+	const lines = [
+		"# Subagent Context",
+		"",
+		"You are a **sub-agent** spawned by the parent agent for a specific task.",
+		"",
+		...taskBody.includes("\n") ? [
+			"## Your Role",
+			"- You were created to handle the following task (verbatim; line breaks preserved):",
+			"",
+			"```",
+			taskBody,
+			"```",
+			"- Complete this task. That's your entire purpose.",
+			"- You are NOT the parent agent. Don't try to be."
+		] : [
+			"## Your Role",
+			`- You were created to handle: ${taskBody}`,
+			"- Complete this task. That's your entire purpose.",
+			"- You are NOT the parent agent. Don't try to be."
+		],
+		"",
+		"## Rules",
+		"1. **Stay focused** - Do your assigned task, nothing else",
+		"2. **Complete the task** - Your final message will be automatically reported to the parent agent",
+		"3. **Don't initiate** - No heartbeats, no proactive actions, no side quests",
+		"4. **Be ephemeral** - You may be terminated after task completion",
+		"5. **Trust push-based completion** - Do not busy-poll for parent status",
+		"6. **Recover from truncated tool output** - Re-read only what you need using smaller chunks",
+		"",
+		"## Output Format",
+		"When complete, your final response should include:",
+		"- What you accomplished or found",
+		"- Any relevant details the parent agent should know",
+		"- Keep it concise but informative",
+		"",
+		"## What You DON'T Do",
+		"- NO user conversations (that is the parent agent's job)",
+		"- NO external messages unless explicitly tasked with a specific recipient/channel",
+		"- NO cron jobs or persistent state",
+		"- Only use `send_message` when explicitly instructed to contact a specific external recipient",
+		"",
+		"## Sub-Agent Spawning",
+		"You are a leaf worker for this delegation. Do NOT spawn further sub-agents unless `delegate_task` is explicitly available and the parent task requires it.",
+		""
+	];
+	if (params.context?.trim()) lines.push("## Context", params.context.trim(), "");
+	if (params.workspace?.trim()) lines.push(`Workspace: ${params.workspace.trim()}`, "");
+	if (params.requesterSessionKey || params.childSessionKey) lines.push("## Session Context", ...params.requesterSessionKey ? [`- Requester session: ${params.requesterSessionKey}`] : [], ...params.childSessionKey ? [`- Your session: ${params.childSessionKey}`] : [], "");
+	lines.push(`If a completion event arrives AFTER you already sent your final answer, reply ONLY with ${NO_REPLY}.`);
+	return lines.filter(Boolean).join("\n");
+}
+function buildSubagentSystemPrompt(params) {
+	const extra = buildSubagentContextSection(params);
+	return buildSystemPrompt(params.workspace ?? ".", {
+		promptMode: "minimal",
+		toolNames: params.toolNames,
+		extraSystemPrompt: extra
+	});
+}
+//#endregion
+export { buildSubagentContextSection, buildSubagentSystemPrompt };
+
+//# sourceMappingURL=subagent-context.js.map

package/dist/src/agent/prompt/subagent-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-context.js","names":[],"sources":["../../../../src/agent/prompt/subagent-context.ts"],"sourcesContent":["import { NO_REPLY } from '../../heartbeat/tokens.js';\nimport { buildSystemPrompt } from './system-prompt.js';\n\nexport function buildSubagentContextSection(params: {\n  goal: string;\n  context?: string;\n  workspace?: string;\n  requesterSessionKey?: string;\n  childSessionKey?: string;\n}): string {\n  const taskBody = params.goal.trim();\n  const roleLines =\n    taskBody.includes('\\n')\n      ? [\n          '## Your Role',\n          '- You were created to handle the following task (verbatim; line breaks preserved):',\n          '',\n          '```',\n          taskBody,\n          '```',\n          \"- Complete this task. That's your entire purpose.\",\n          '- You are NOT the parent agent. Don\\'t try to be.',\n        ]\n      : [\n          '## Your Role',\n          `- You were created to handle: ${taskBody}`,\n          \"- Complete this task. That's your entire purpose.\",\n          '- You are NOT the parent agent. Don\\'t try to be.',\n        ];\n\n  const lines = [\n    '# Subagent Context',\n    '',\n    'You are a **sub-agent** spawned by the parent agent for a specific task.',\n    '',\n    ...roleLines,\n    '',\n    '## Rules',\n    '1. **Stay focused** - Do your assigned task, nothing else',\n    '2. **Complete the task** - Your final message will be automatically reported to the parent agent',\n    '3. **Don\\'t initiate** - No heartbeats, no proactive actions, no side quests',\n    '4. **Be ephemeral** - You may be terminated after task completion',\n    '5. **Trust push-based completion** - Do not busy-poll for parent status',\n    '6. **Recover from truncated tool output** - Re-read only what you need using smaller chunks',\n    '',\n    '## Output Format',\n    'When complete, your final response should include:',\n    '- What you accomplished or found',\n    '- Any relevant details the parent agent should know',\n    '- Keep it concise but informative',\n    '',\n    '## What You DON\\'T Do',\n    '- NO user conversations (that is the parent agent\\'s job)',\n    '- NO external messages unless explicitly tasked with a specific recipient/channel',\n    '- NO cron jobs or persistent state',\n    '- Only use `send_message` when explicitly instructed to contact a specific external recipient',\n    '',\n    '## Sub-Agent Spawning',\n    'You are a leaf worker for this delegation. Do NOT spawn further sub-agents unless `delegate_task` is explicitly available and the parent task requires it.',\n    '',\n  ];\n\n  if (params.context?.trim()) {\n    lines.push('## Context', params.context.trim(), '');\n  }\n  if (params.workspace?.trim()) {\n    lines.push(`Workspace: ${params.workspace.trim()}`, '');\n  }\n  if (params.requesterSessionKey || params.childSessionKey) {\n    lines.push(\n      '## Session Context',\n      ...(params.requesterSessionKey\n        ? [`- Requester session: ${params.requesterSessionKey}`]\n        : []),\n      ...(params.childSessionKey ? [`- Your session: ${params.childSessionKey}`] : []),\n      '',\n    );\n  }\n\n  lines.push(\n    `If a completion event arrives AFTER you already sent your final answer, reply ONLY with ${NO_REPLY}.`,\n  );\n\n  return lines.filter(Boolean).join('\\n');\n}\n\nexport function buildSubagentSystemPrompt(params: {\n  goal: string;\n  context?: string;\n  workspace?: string;\n  requesterSessionKey?: string;\n  childSessionKey?: string;\n  toolNames?: string[];\n}): string {\n  const extra = buildSubagentContextSection(params);\n  return buildSystemPrompt(params.workspace ?? '.', {\n    promptMode: 'minimal',\n    toolNames: params.toolNames,\n    extraSystemPrompt: extra,\n  });\n}\n"],"mappings":";;;AAGA,SAAgB,4BAA4B,QAMjC;CACT,MAAM,WAAW,OAAO,KAAK,MAAM;CAoBnC,MAAM,QAAQ;EACZ;EACA;EACA;EACA;EACA,GAvBA,SAAS,SAAS,KAAK,GACnB;GACE;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACD,GACD;GACE;GACA,iCAAiC;GACjC;GACA;GACD;EAQL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;AAED,KAAI,OAAO,SAAS,MAAM,CACxB,OAAM,KAAK,cAAc,OAAO,QAAQ,MAAM,EAAE,GAAG;AAErD,KAAI,OAAO,WAAW,MAAM,CAC1B,OAAM,KAAK,cAAc,OAAO,UAAU,MAAM,IAAI,GAAG;AAEzD,KAAI,OAAO,uBAAuB,OAAO,gBACvC,OAAM,KACJ,sBACA,GAAI,OAAO,sBACP,CAAC,wBAAwB,OAAO,sBAAsB,GACtD,EAAE,EACN,GAAI,OAAO,kBAAkB,CAAC,mBAAmB,OAAO,kBAAkB,GAAG,EAAE,EAC/E,GACD;AAGH,OAAM,KACJ,2FAA2F,SAAS,GACrG;AAED,QAAO,MAAM,OAAO,QAAQ,CAAC,KAAK,KAAK;;AAGzC,SAAgB,0BAA0B,QAO/B;CACT,MAAM,QAAQ,4BAA4B,OAAO;AACjD,QAAO,kBAAkB,OAAO,aAAa,KAAK;EAChD,YAAY;EACZ,WAAW,OAAO;EAClB,mBAAmB;EACpB,CAAC"}

package/dist/src/agent/prompt/system-prompt-params.d.ts

@@ -0,0 +1,53 @@
+import type { Config } from '../../config/schema.js';
+import type { ProviderSystemPromptContribution } from './contribution.js';
+import type { MemoryCitationsMode, PromptMode, SilentReplyPromptMode } from './types.js';
+export type { RuntimeInfoInput } from './sections/workspace-runtime.js';
+export declare function resolvePromptMode(sessionKey?: string): PromptMode;
+export declare function resolveRuntimeChannel(sessionKey?: string): string | undefined;
+export declare function resolveDeliverableChannels(config: Config): string[];
+export declare function normalizeProviderPromptBlock(value?: string): string | undefined;
+export declare function buildOverridablePromptSection(params: {
+    override?: string;
+    fallback: string;
+}): string;
+export interface SystemPromptBuildParams {
+    workspaceDir: string;
+    sessionKey?: string;
+    promptMode?: PromptMode;
+    toolNames?: string[];
+    toolSummaries?: Record<string, string>;
+    runtimeInfo?: import('./sections/workspace-runtime.js').RuntimeInfoInput;
+    userTimezone?: string;
+    channels?: string[];
+    memoryCitationsMode?: MemoryCitationsMode;
+    includeMemorySection?: boolean;
+    heartbeatEnabled?: boolean;
+    heartbeatPrompt?: string;
+    externalMemoryInstructions?: string;
+    ttsSystemHint?: string;
+    extraSystemPrompt?: string;
+    silentReplyPromptMode?: SilentReplyPromptMode;
+    promptContribution?: ProviderSystemPromptContribution;
+    includeProblemSolving?: boolean;
+    includeToneSection?: boolean;
+}
+export declare function resolveSystemPromptBuildParams(config: Config, params: {
+    workspaceDir: string;
+    sessionKey?: string;
+    toolNames?: string[];
+    toolSummaries?: Record<string, string>;
+    userTimezone?: string;
+    externalMemoryInstructions?: string;
+    heartbeatEnabled?: boolean;
+    heartbeatPrompt?: string;
+    ttsSystemHint?: string;
+    extraSystemPrompt?: string;
+    modelRef?: string;
+    agentId?: string;
+    thinkingLevel?: string;
+    promptMode?: PromptMode;
+    silentReplyPromptMode?: SilentReplyPromptMode;
+    promptContribution?: ProviderSystemPromptContribution;
+    memoryCitationsMode?: MemoryCitationsMode;
+    includeMemorySection?: boolean;
+}): SystemPromptBuildParams;