@xopcai/xopc 0.0.99 → 0.0.101

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

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;

package/dist/src/agent/prompt/system-prompt-params.js

@@ -0,0 +1,74 @@
+import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
+import { isCronSessionKey, isSubagentSessionKey } from "../../routing/session-key-utils.js";
+import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
+import { normalizePromptSection } from "./cache-boundary.js";
+import { listChannelPlugins } from "../../channels/plugins/registry.js";
+//#region src/agent/prompt/system-prompt-params.ts
+init_package_version();
+init_session_key();
+function resolvePromptMode(sessionKey) {
+	if (!sessionKey) return "full";
+	if (isSubagentSessionKey(sessionKey) || isCronSessionKey(sessionKey)) return "minimal";
+	return "full";
+}
+function resolveRuntimeChannel(sessionKey) {
+	if (!sessionKey) return;
+	return parseSessionKey(sessionKey)?.source;
+}
+function resolveDeliverableChannels(config) {
+	const channels = new Set(["webchat", "cli"]);
+	const configured = config.channels;
+	if (configured) {
+		for (const [id, section] of Object.entries(configured)) if (section?.enabled !== false) channels.add(id);
+	}
+	for (const plugin of listChannelPlugins()) {
+		const id = plugin.id;
+		const section = configured?.[id];
+		if (section?.enabled !== false && section !== void 0) channels.add(id);
+	}
+	return [...channels].sort();
+}
+function normalizeProviderPromptBlock(value) {
+	if (typeof value !== "string") return;
+	return normalizePromptSection(value) || void 0;
+}
+function buildOverridablePromptSection(params) {
+	const override = normalizeProviderPromptBlock(params.override);
+	if (override) return override;
+	return params.fallback;
+}
+function resolveSystemPromptBuildParams(config, params) {
+	const sessionKey = params.sessionKey;
+	const channel = resolveRuntimeChannel(sessionKey);
+	return {
+		workspaceDir: params.workspaceDir,
+		sessionKey,
+		promptMode: params.promptMode ?? resolvePromptMode(sessionKey),
+		toolNames: params.toolNames,
+		toolSummaries: params.toolSummaries,
+		runtimeInfo: {
+			version: PACKAGE_VERSION,
+			model: params.modelRef,
+			channel,
+			agentId: params.agentId,
+			thinkingLevel: params.thinkingLevel
+		},
+		userTimezone: params.userTimezone,
+		channels: resolveDeliverableChannels(config),
+		memoryCitationsMode: params.memoryCitationsMode,
+		includeMemorySection: params.includeMemorySection,
+		heartbeatEnabled: params.heartbeatEnabled,
+		heartbeatPrompt: params.heartbeatPrompt,
+		externalMemoryInstructions: params.externalMemoryInstructions,
+		ttsSystemHint: params.ttsSystemHint,
+		extraSystemPrompt: params.extraSystemPrompt,
+		silentReplyPromptMode: params.silentReplyPromptMode,
+		promptContribution: params.promptContribution,
+		includeProblemSolving: true,
+		includeToneSection: true
+	};
+}
+//#endregion
+export { buildOverridablePromptSection, normalizeProviderPromptBlock, resolveDeliverableChannels, resolvePromptMode, resolveRuntimeChannel, resolveSystemPromptBuildParams };
+
+//# sourceMappingURL=system-prompt-params.js.map

package/dist/src/agent/prompt/system-prompt-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt-params.js","names":[],"sources":["../../../../src/agent/prompt/system-prompt-params.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { listChannelPlugins } from '../../channels/plugins/registry.js';\nimport { PACKAGE_VERSION } from '../../package-version.js';\nimport { isCronSessionKey, isSubagentSessionKey, parseSessionKey } from '../../routing/session-key.js';\nimport type { ProviderSystemPromptContribution } from './contribution.js';\nimport { normalizePromptSection } from './cache-boundary.js';\nimport type { MemoryCitationsMode, PromptMode, SilentReplyPromptMode } from './types.js';\n\nexport type { RuntimeInfoInput } from './sections/workspace-runtime.js';\n\nexport function resolvePromptMode(sessionKey?: string): PromptMode {\n  if (!sessionKey) {\n    return 'full';\n  }\n  if (isSubagentSessionKey(sessionKey) || isCronSessionKey(sessionKey)) {\n    return 'minimal';\n  }\n  return 'full';\n}\n\nexport function resolveRuntimeChannel(sessionKey?: string): string | undefined {\n  if (!sessionKey) {\n    return undefined;\n  }\n  const parsed = parseSessionKey(sessionKey);\n  return parsed?.source;\n}\n\nexport function resolveDeliverableChannels(config: Config): string[] {\n  const channels = new Set<string>(['webchat', 'cli']);\n  const configured = config.channels as Record<string, { enabled?: boolean }> | undefined;\n  if (configured) {\n    for (const [id, section] of Object.entries(configured)) {\n      if (section?.enabled !== false) {\n        channels.add(id);\n      }\n    }\n  }\n  for (const plugin of listChannelPlugins()) {\n    const id = plugin.id;\n    const section = configured?.[id];\n    if (section?.enabled !== false && section !== undefined) {\n      channels.add(id);\n    }\n  }\n  return [...channels].sort();\n}\n\nexport function normalizeProviderPromptBlock(value?: string): string | undefined {\n  if (typeof value !== 'string') {\n    return undefined;\n  }\n  const normalized = normalizePromptSection(value);\n  return normalized || undefined;\n}\n\nexport function buildOverridablePromptSection(params: {\n  override?: string;\n  fallback: string;\n}): string {\n  const override = normalizeProviderPromptBlock(params.override);\n  if (override) {\n    return override;\n  }\n  return params.fallback;\n}\n\nexport interface SystemPromptBuildParams {\n  workspaceDir: string;\n  sessionKey?: string;\n  promptMode?: PromptMode;\n  toolNames?: string[];\n  toolSummaries?: Record<string, string>;\n  runtimeInfo?: import('./sections/workspace-runtime.js').RuntimeInfoInput;\n  userTimezone?: string;\n  channels?: string[];\n  memoryCitationsMode?: MemoryCitationsMode;\n  includeMemorySection?: boolean;\n  heartbeatEnabled?: boolean;\n  heartbeatPrompt?: string;\n  externalMemoryInstructions?: string;\n  ttsSystemHint?: string;\n  extraSystemPrompt?: string;\n  silentReplyPromptMode?: SilentReplyPromptMode;\n  promptContribution?: ProviderSystemPromptContribution;\n  includeProblemSolving?: boolean;\n  includeToneSection?: boolean;\n}\n\nexport function resolveSystemPromptBuildParams(\n  config: Config,\n  params: {\n    workspaceDir: string;\n    sessionKey?: string;\n    toolNames?: string[];\n    toolSummaries?: Record<string, string>;\n    userTimezone?: string;\n    externalMemoryInstructions?: string;\n    heartbeatEnabled?: boolean;\n    heartbeatPrompt?: string;\n    ttsSystemHint?: string;\n    extraSystemPrompt?: string;\n    modelRef?: string;\n    agentId?: string;\n    thinkingLevel?: string;\n    promptMode?: PromptMode;\n    silentReplyPromptMode?: SilentReplyPromptMode;\n    promptContribution?: ProviderSystemPromptContribution;\n    memoryCitationsMode?: MemoryCitationsMode;\n    includeMemorySection?: boolean;\n  },\n): SystemPromptBuildParams {\n  const sessionKey = params.sessionKey;\n  const channel = resolveRuntimeChannel(sessionKey);\n  return {\n    workspaceDir: params.workspaceDir,\n    sessionKey,\n    promptMode: params.promptMode ?? resolvePromptMode(sessionKey),\n    toolNames: params.toolNames,\n    toolSummaries: params.toolSummaries,\n    runtimeInfo: {\n      version: PACKAGE_VERSION,\n      model: params.modelRef,\n      channel,\n      agentId: params.agentId,\n      thinkingLevel: params.thinkingLevel,\n    },\n    userTimezone: params.userTimezone,\n    channels: resolveDeliverableChannels(config),\n    memoryCitationsMode: params.memoryCitationsMode,\n    includeMemorySection: params.includeMemorySection,\n    heartbeatEnabled: params.heartbeatEnabled,\n    heartbeatPrompt: params.heartbeatPrompt,\n    externalMemoryInstructions: params.externalMemoryInstructions,\n    ttsSystemHint: params.ttsSystemHint,\n    extraSystemPrompt: params.extraSystemPrompt,\n    silentReplyPromptMode: params.silentReplyPromptMode,\n    promptContribution: params.promptContribution,\n    includeProblemSolving: true,\n    includeToneSection: true,\n  };\n}\n"],"mappings":";;;;;;sBAE2D;kBAC4C;AAOvG,SAAgB,kBAAkB,YAAiC;AACjE,KAAI,CAAC,WACH,QAAO;AAET,KAAI,qBAAqB,WAAW,IAAI,iBAAiB,WAAW,CAClE,QAAO;AAET,QAAO;;AAGT,SAAgB,sBAAsB,YAAyC;AAC7E,KAAI,CAAC,WACH;AAGF,QADe,gBAAgB,WAClB,EAAE;;AAGjB,SAAgB,2BAA2B,QAA0B;CACnE,MAAM,WAAW,IAAI,IAAY,CAAC,WAAW,MAAM,CAAC;CACpD,MAAM,aAAa,OAAO;AAC1B,KAAI;OACG,MAAM,CAAC,IAAI,YAAY,OAAO,QAAQ,WAAW,CACpD,KAAI,SAAS,YAAY,MACvB,UAAS,IAAI,GAAG;;AAItB,MAAK,MAAM,UAAU,oBAAoB,EAAE;EACzC,MAAM,KAAK,OAAO;EAClB,MAAM,UAAU,aAAa;AAC7B,MAAI,SAAS,YAAY,SAAS,YAAY,KAAA,EAC5C,UAAS,IAAI,GAAG;;AAGpB,QAAO,CAAC,GAAG,SAAS,CAAC,MAAM;;AAG7B,SAAgB,6BAA6B,OAAoC;AAC/E,KAAI,OAAO,UAAU,SACnB;AAGF,QADmB,uBAAuB,MACzB,IAAI,KAAA;;AAGvB,SAAgB,8BAA8B,QAGnC;CACT,MAAM,WAAW,6BAA6B,OAAO,SAAS;AAC9D,KAAI,SACF,QAAO;AAET,QAAO,OAAO;;AAyBhB,SAAgB,+BACd,QACA,QAoByB;CACzB,MAAM,aAAa,OAAO;CAC1B,MAAM,UAAU,sBAAsB,WAAW;AACjD,QAAO;EACL,cAAc,OAAO;EACrB;EACA,YAAY,OAAO,cAAc,kBAAkB,WAAW;EAC9D,WAAW,OAAO;EAClB,eAAe,OAAO;EACtB,aAAa;GACX,SAAS;GACT,OAAO,OAAO;GACd;GACA,SAAS,OAAO;GAChB,eAAe,OAAO;GACvB;EACD,cAAc,OAAO;EACrB,UAAU,2BAA2B,OAAO;EAC5C,qBAAqB,OAAO;EAC5B,sBAAsB,OAAO;EAC7B,kBAAkB,OAAO;EACzB,iBAAiB,OAAO;EACxB,4BAA4B,OAAO;EACnC,eAAe,OAAO;EACtB,mBAAmB,OAAO;EAC1B,uBAAuB,OAAO;EAC9B,oBAAoB,OAAO;EAC3B,uBAAuB;EACvB,oBAAoB;EACrB"}

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

@@ -6,29 +6,40 @@
  * not to manually reread startup files.
  */
 import type { EmbeddedContextFile } from '../bootstrap/types.js';
-import type { PromptMode } from './types.js';
-export type MemoryCitationsMode = 'on' | 'off' | 'source-only';
+import type { ProviderSystemPromptContribution } from './contribution.js';
+import { type RuntimeInfoInput } from './sections/workspace-runtime.js';
+import type { MemoryCitationsMode, PromptMode, SilentReplyPromptMode } from './types.js';
+export type { MemoryCitationsMode } from './types.js';
+export { getContextFileBasename, isDynamicContextFile, sortContextFilesForPrompt, } from './sections/project-context.js';
 export interface SystemPromptOptions {
-    /** Bootstrap context files from profile Markdown (Project Context). */
     contextFiles?: EmbeddedContextFile[];
     promptMode?: PromptMode;
     heartbeatEnabled?: boolean;
     heartbeatPrompt?: string;
+    /** Registered tool names for Tooling section and memory/skills gating. */
+    toolNames?: string[];
+    toolSummaries?: Record<string, string>;
+    /** @deprecated Prefer toolNames — kept for skill-section gating compatibility. */
     availableTools?: string[];
     memoryCitationsMode?: MemoryCitationsMode;
+    includeMemorySection?: boolean;
     userTimezone?: string;
-    runtime?: {
-        version?: string;
-        model?: string;
-        channel?: string;
-    };
+    runtime?: RuntimeInfoInput;
     channels?: string[];
     externalMemoryInstructions?: string;
     ttsSystemHint?: string;
+    extraSystemPrompt?: string;
+    silentReplyPromptMode?: SilentReplyPromptMode;
+    promptContribution?: ProviderSystemPromptContribution;
+    includeProblemSolving?: boolean;
+    includeToneSection?: boolean;
 }
 /**
  * Build system prompt with bootstrap Project Context integration.
  */
-export declare function buildSystemPrompt(workspaceDir: string, options: SystemPromptOptions): string;
-/** Whether HEARTBEAT.md is injected as dynamic context (vs behavior-only section). */
-export declare function isHeartbeatContextFile(pathValue: string): boolean;
+export declare function buildSystemPrompt(workspaceDir: string, options?: SystemPromptOptions): string;
+/** Split a built prompt at the cache boundary (for tests and provider adapters). */
+export declare function splitBuiltSystemPrompt(text: string): {
+    stablePrefix: string;
+    dynamicSuffix: string;
+};