@xopcai/xopc 0.0.29 → 0.0.31

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

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","names":[],"sources":["../../../../src/agent/prompt/system-prompt.ts"],"sourcesContent":["/**\n * System Prompt Builder - Enhanced version with workspace context integration\n * \n * Integrates workspace bootstrap files:\n * - SOUL.md for persona and tone\n * - USER.md for user context\n * - IDENTITY.md for agent identity\n * - HEARTBEAT.md for task polling\n * - MEMORY.md for long-term memory\n * - Memory search integration in prompt\n */\n\nimport type { WorkspaceBootstrapFile } from '../context/workspace.js';\nimport {\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_USER_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_HEARTBEAT_FILENAME,\n  DEFAULT_MEMORY_FILENAME,\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  stripFrontMatter,\n} from '../context/workspace.js';\nimport type { MemorySnapshot } from '../memory/types.js';\nimport { PROMPT_CACHE_BOUNDARY } from './cache-boundary.js';\nimport type { PromptMode } from './types.js';\n\n// =============================================================================\n// Configuration (Internal)\n// =============================================================================\n\n/** Maximum characters to inject from workspace files into system prompt */\nconst PROMPT_MAX_CHARS = {\n  SOUL: 8_000,\n  USER: 4_000,\n  IDENTITY: 2_000,\n  AGENTS: 20_000,\n  TOOLS: 4_000,\n  HEARTBEAT: 2_000,\n  MEMORY: 8_000,\n};\n\n/** Whether memory citation is enabled */\nexport type MemoryCitationsMode = 'on' | 'off' | 'source-only';\n\nexport interface SystemPromptOptions {\n  /** Workspace bootstrap files */\n  bootstrapFiles: WorkspaceBootstrapFile[];\n  /** Which sections to include. Defaults to \"full\". */\n  promptMode?: PromptMode;\n  /** Whether heartbeat is enabled */\n  heartbeatEnabled?: boolean;\n  /** Custom heartbeat prompt */\n  heartbeatPrompt?: string;\n  /** Available tool names for skill matching */\n  availableTools?: string[];\n  /** Memory citations mode */\n  memoryCitationsMode?: MemoryCitationsMode;\n  /** User timezone for date/time display */\n  userTimezone?: string;\n  /** Runtime info (version, model, channel) */\n  runtime?: {\n    version?: string;\n    model?: string;\n    channel?: string;\n  };\n  /** Active messaging channels */\n  channels?: string[];\n  /** Frozen curated memory from agent home `memories/` (session start only). */\n  curatedMemorySnapshot?: MemorySnapshot;\n  /** External memory provider static instructions. */\n  externalMemoryInstructions?: string;\n  /** How skill instructions are surfaced (metadata-only → use skills_list / skill_view). */\n  skillsPromptMode?: 'metadata-only' | 'legacy-with-paths';\n  /** Optional TTS / voice output guidance (when TTS is enabled). */\n  ttsSystemHint?: string;\n}\n\n// =============================================================================\n// Section Builders\n// =============================================================================\n\n/**\n * Build SOUL.md section - persona and tone\n * \n * If SOUL.md is present, embody its persona and tone\n */\nfunction buildSoulSection(bootstrapFiles: WorkspaceBootstrapFile[]): string {\n  const soulFile = bootstrapFiles.find(f => f.name === DEFAULT_SOUL_FILENAME);\n  if (!soulFile || soulFile.missing || !soulFile.content) {\n    return '';\n  }\n\n  // Strip front matter and truncate\n  const content = stripFrontMatter(soulFile.content);\n  const truncated = truncateForPrompt(content, PROMPT_MAX_CHARS.SOUL);\n\n  return `## SOUL.md - Your Persona\n\n${truncated}\n\n_Embody this persona unless higher-priority instructions override it._\n`;\n}\n\n/**\n * Build USER.md section - user context\n */\nfunction buildUserSection(bootstrapFiles: WorkspaceBootstrapFile[]): string {\n  const userFile = bootstrapFiles.find(f => f.name === DEFAULT_USER_FILENAME);\n  if (!userFile || userFile.missing || !userFile.content) {\n    return '';\n  }\n\n  const content = stripFrontMatter(userFile.content);\n  const truncated = truncateForPrompt(content, PROMPT_MAX_CHARS.USER);\n\n  return `## USER.md - About Your Human\n\n${truncated}\n\n_Use this context to provide personalized assistance._\n`;\n}\n\n/**\n * Curated MEMORY.md + USER.md blocks (frozen at session start).\n */\nfunction buildExternalMemorySection(text: string | undefined): string {\n  const t = text?.trim();\n  if (!t) {\n    return '';\n  }\n  return `## External memory provider\n\n${t}`;\n}\n\nfunction buildCuratedMemorySection(snapshot: MemorySnapshot | undefined): string {\n  const mem = snapshot?.memory?.trim() ?? '';\n  const user = snapshot?.user?.trim() ?? '';\n  if (!mem && !user) {\n    return '';\n  }\n\n  const body = [mem, user].filter(Boolean).join('\\n\\n');\n  return `## Curated memory (session snapshot)\n\n> Frozen when this session started. Updates use \\`curated_memory\\` and save under agent home \\`memories/\\`; they do not change this block until a new session.\n\n${body}`;\n}\n\n/**\n * Build IDENTITY.md section - agent identity\n */\nfunction buildIdentitySection(bootstrapFiles: WorkspaceBootstrapFile[]): string {\n  const identityFile = bootstrapFiles.find(f => f.name === DEFAULT_IDENTITY_FILENAME);\n  if (!identityFile || identityFile.missing || !identityFile.content) {\n    return '';\n  }\n\n  const content = stripFrontMatter(identityFile.content);\n  const truncated = truncateForPrompt(content, PROMPT_MAX_CHARS.IDENTITY);\n\n  return `## IDENTITY.md - Who You Are\n\n${truncated}\n`;\n}\n\n/**\n * Build AGENTS.md section - development guidelines\n */\nfunction buildAgentsSection(bootstrapFiles: WorkspaceBootstrapFile[]): string {\n  const agentsFile = bootstrapFiles.find(f => f.name === DEFAULT_AGENTS_FILENAME);\n  if (!agentsFile || agentsFile.missing || !agentsFile.content) {\n    return '';\n  }\n\n  const content = stripFrontMatter(agentsFile.content);\n  const truncated = truncateForPrompt(content, PROMPT_MAX_CHARS.AGENTS);\n\n  return `## AGENTS.md - Development Guidelines\n\n${truncated}\n`;\n}\n\n/**\n * Build TOOLS.md section - local tool notes\n */\nfunction buildToolsSection(bootstrapFiles: WorkspaceBootstrapFile[]): string {\n  const toolsFile = bootstrapFiles.find(f => f.name === DEFAULT_TOOLS_FILENAME);\n  if (!toolsFile || toolsFile.missing || !toolsFile.content) {\n    return '';\n  }\n\n  const content = stripFrontMatter(toolsFile.content);\n  const truncated = truncateForPrompt(content, PROMPT_MAX_CHARS.TOOLS);\n\n  return `## TOOLS.md - Local Notes\n\n${truncated}\n`;\n}\n\n/**\n * Build HEARTBEAT.md section - task polling\n */\nfunction buildHeartbeatSection(\n  bootstrapFiles: WorkspaceBootstrapFile[],\n  enabled: boolean,\n  customPrompt?: string,\n  userTimezone?: string\n): string {\n  if (!enabled) {\n    return '';\n  }\n\n  // If custom prompt provided, use it\n  if (customPrompt) {\n    return `## Heartbeat\n\n${customPrompt}\n`;\n  }\n\n  // Try to load from HEARTBEAT.md\n  const heartbeatFile = bootstrapFiles.find(f => f.name === DEFAULT_HEARTBEAT_FILENAME);\n  if (!heartbeatFile || heartbeatFile.missing || !heartbeatFile.content) {\n    // Default heartbeat behavior with timezone-aware quiet hours\n    let quietHoursNote = '';\n    if (userTimezone) {\n      quietHoursNote = `\\n\\n> 💤 Quiet hours: The user is in **${userTimezone}**. Avoid proactive checks during late night (23:00-08:00) unless urgent.`;\n    }\n    return `## Heartbeat\n\nPoll for tasks. If nothing needs attention, reply: HEARTBEAT_OK\n\n_Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats._${quietHoursNote}\n`;\n  }\n\n  const content = stripFrontMatter(heartbeatFile.content);\n  const truncated = truncateForPrompt(content, PROMPT_MAX_CHARS.HEARTBEAT);\n\n  let quietHoursNote = '';\n  if (userTimezone) {\n    quietHoursNote = `\\n\\n> 💤 Quiet hours: The user is in **${userTimezone}**. Avoid proactive checks during late night (23:00-08:00) unless urgent.`;\n  }\n\n  return `## HEARTBEAT.md - Task Checklist\n\n${truncated}\n\n_Read HEARTBEAT.md for current tasks. If nothing needs attention, reply: HEARTBEAT_OK_${quietHoursNote}\n`;\n}\n\n/**\n * Build Memory section - recall instructions\n * \n * Before answering anything about prior work, decisions, dates, people, preferences, or todos: run memory_search\n */\nfunction buildMemorySection(\n  bootstrapFiles: WorkspaceBootstrapFile[],\n  citationsMode: MemoryCitationsMode = 'on',\n  hasCuratedSnapshot = false,\n): string {\n  const memoryFile = bootstrapFiles.find(f => f.name === DEFAULT_MEMORY_FILENAME);\n  const hasWorkspaceMemoryFile = !!(memoryFile && !memoryFile.missing);\n\n  if (!hasWorkspaceMemoryFile && !hasCuratedSnapshot) {\n    return '';\n  }\n\n  const citationInstruction = citationsMode === 'off'\n    ? 'Citations are disabled: do not mention file paths or line numbers in replies.'\n    : citationsMode === 'source-only'\n    ? 'Citations: mention file path when it helps (e.g., Source: MEMORY.md).'\n    : 'Citations: include Source: <path#line> when it helps the user verify memory snippets.';\n\n  const curatedLines = hasCuratedSnapshot\n    ? `\n- **Curated store:** agent home \\`memories/MEMORY.md\\` and \\`memories/USER.md\\` — use \\`curated_memory\\` to add/replace/remove/read structured entries.`\n    : '';\n\n  return `## Memory Recall\n\n${citationInstruction}\n\nBefore answering anything about prior work, decisions, dates, people, preferences, or todos:\n1. Run \\`memory_search\\` on bootstrap MEMORY.md, agent-home \\`memories/*.md\\`, and workspace \\`memory/*.md\\`\n2. For **other chat sessions** / cross-session history, use \\`session_search\\` with keywords (or omit \\`query\\` to list recent sessions)\n3. Use \\`memory_get\\` to pull only the needed lines from files\n4. If low confidence after search, say you checked\n\n### Memory Files\n\n- **Daily notes:** \\`memory/YYYY-MM-DD.md\\` — raw logs of what happened\n- **Long-term:** \\`MEMORY.md\\` — your curated memories, like a human's long-term memory${curatedLines}\n\n### Writing to Memory\n\n- **Declarative vs procedural:** Save **facts and preferences** (who the user is, how they want you to behave, stable environment) via workspace memory files and/or \\`curated_memory\\`. Save **reusable task playbooks** (steps, pitfalls, verification for a class of work) with \\`skill_manage\\` as skills — not as long prose in MEMORY.md.\n- **Memory is limited** — if you want to remember something, WRITE IT TO A FILE\n- \"Mental notes\" don't survive session restarts. Files do.\n- When someone says \"remember this\" → update \\`memory/YYYY-MM-DD.md\\` or relevant file\n- When you learn a lesson → update relevant files\n- When you make a mistake → document it so future-you doesn't repeat it\n- **Text > Brain** 📝\n`;\n}\n\n/**\n * Build Skills section - skill matching guidelines\n */\nfunction buildSkillsSection(\n  availableTools: string[] = [],\n  skillsPromptMode: 'metadata-only' | 'legacy-with-paths' = 'metadata-only',\n): string {\n  if (availableTools.length === 0) {\n    return '';\n  }\n\n  if (skillsPromptMode === 'legacy-with-paths') {\n    return `## Skills\n\nWhen a solution already exists, do not reinvent the wheel.\n\n**How to use:**\n1. Skim <available_skills> — is anything clearly relevant?\n2. Only one match? → Use read_file on its SKILL.md (see location) and follow it.\n3. Several plausible matches? → Pick the most specific one.\n4. No match? → Solve it yourself; do not force-fit a skill.\n\n**Principle:** Skills are tools, not shackles. If after reading one it does not fit, set it aside and proceed on your own.\n\n**Division of labor with memory:** Skills = **procedural** workflows (how to do a class of tasks); memory / \\`curated_memory\\` = **declarative** facts and preferences. After a complex task succeeds, you may codify it as a skill; user-profile-style information belongs in memory.\n`;\n  }\n\n  return `## Skills\n\nWhen a solution already exists, do not reinvent the wheel.\n\n**How to use:**\n1. Skim <available_skills> — is anything clearly relevant?\n2. Only one match? → Confirm with skills_list, then load the full text with skill_view(name) and follow it.\n3. Need sub-documents or scripts? → skill_view(name, \"references/…\"), etc. (only references, templates, scripts, assets)\n4. No match? → Solve it yourself; do not force-fit a skill.\n\n**Principle:** Skills are tools, not shackles. If after reading one it does not fit, set it aside and proceed on your own.\n\n**Division of labor with memory:** Skills = **procedural** workflows (how to do a class of tasks); memory / \\`curated_memory\\` = **declarative** facts and preferences. After a complex task succeeds, you may codify it as a skill; user-profile-style information belongs in memory. When a skill is outdated or incomplete, fix it immediately with \\`skill_manage\\` (e.g. patch).\n`;\n}\n\nfunction buildSafetySection(): string {\n  return `## Safety\n\n- You have no independent goals: do not pursue self-preservation, replication, resource acquisition, or power-seeking; avoid long-term plans beyond the user's request.\n- Prioritize safety and human oversight over completion; if instructions conflict, pause and ask; comply with stop/pause/audit requests and never bypass safeguards.\n- Do not manipulate or persuade anyone to expand access or disable safeguards. Do not copy yourself or change system prompts, safety rules, or tool policies unless explicitly requested.`;\n}\n\n/**\n * Build Problem Solving Workflow section\n *\n * Implements the \"Build & Self-Verify\" pattern from harness engineering.\n * Guides agents through an iterative problem-solving process with verification.\n *\n * Inspired by: https://blog.langchain.com/improving-deep-agents-with-harness-engineering/\n */\nfunction buildProblemSolvingSection(): string {\n  return `## Problem Solving\n\n**Simple tasks** (< 5 minutes or a single-file change): Do them directly; run a quick verification after changes.\n\n**Complex tasks** (multiple files or design decisions): Use an iterative flow — Plan → Build → Verify → Fix.\n\n**Decision criteria:**\n- Multiple files or refactoring? → Plan first\n- Existing test coverage? → You must verify\n- Documentation or comments only? → Verification can be lighter\n- User says \"just take a quick look\"? → Skip ceremony; deliver the result directly\n\n**Core principle: Match the complexity; reject ritual for its own sake. Verification matters, but do not verify just to tick a box.**`;\n}\n\n/**\n * Build Aesthetic Guidelines section - tone and style preferences\n */\nfunction buildAestheticSection(): string {\n  return `## Tone & Style\n\n**Default voice:**\n- Direct over diplomatic (\"This is broken\" beats \"This might be worth considering\")\n- Concise over exhaustive (do not expand on what the user did not ask for)\n- Concrete over abstract (use examples, not lectures)\n\n**Avoid LLM-isms:**\n- Do not open with \"This is a complex question...\"\n- Rarely use \"It is worth noting...\" / \"It is important to emphasize...\"\n- Not every sentence needs bullets; natural paragraphs are fine\n- Do not wrap a simple takeaway in a four-step framework\n\n**SOUL.md takes precedence:** If SOUL.md defines a specific tone, defer to it over the above.\n`;\n}\nfunction buildMessagingSection(\n  channels: string[] = [],\n  isMinimal: boolean = false\n): string {\n  if (isMinimal || channels.length === 0) {\n    return '';\n  }\n\n  const channelList = channels.join(', ');\n\n  return `## Messaging\n\n- Reply in current session → automatically routes to the source channel (${channelList})\n- Use \\`message\\` for proactive sends + channel actions\n- If you use \\`message\\` to deliver your user-visible reply, respond with ONLY: NO_REPLY (avoid duplicate replies)\n`;\n}\n\n/**\n * Build Time section - user timezone\n */\nfunction buildTimeSection(timezone?: string): string {\n  if (!timezone) {\n    return '';\n  }\n\n  return `## Current Date & Time\n\nTime zone: ${timezone}\n\nIf you need the current date/time/day-of-week, use the \\`session_status\\` tool or the inbound message timestamp envelope (when present).\n`;\n}\n\n/**\n * Build Runtime section - version info\n */\nfunction buildRuntimeSection(runtime?: { version?: string; model?: string; channel?: string }): string {\n  if (!runtime) {\n    return '';\n  }\n\n  const parts: string[] = [];\n  if (runtime.version) parts.push(`v${runtime.version}`);\n  if (runtime.model) parts.push(`model=${runtime.model.split('/').pop()}`);\n  if (runtime.channel) parts.push(`ch=${runtime.channel}`);\n\n  return parts.length > 0 ? `[${parts.join(' | ')}]` : '';\n}\n\n/**\n * Build Working Directory section\n */\nfunction buildWorkingDirSection(workspaceDir: string): string {\n  return `Working directory: ${workspaceDir}`;\n}\n\n// =============================================================================\n// Utilities\n// =============================================================================\n\n/**\n * Truncate content for prompt injection\n * Keeps head and tail to preserve context\n */\nfunction truncateForPrompt(content: string, maxChars: number): string {\n  const trimmed = content.trimEnd();\n  if (trimmed.length <= maxChars) {\n    return trimmed;\n  }\n\n  // Keep head (70%) and tail (20%) with marker\n  const headChars = Math.floor(maxChars * 0.7);\n  const tailChars = Math.floor(maxChars * 0.2);\n  const head = trimmed.slice(0, headChars);\n  const tail = trimmed.slice(-tailChars);\n\n  return `${head}\n\n[...]${tail}`;\n}\n\n// =============================================================================\n// Main Builder\n// =============================================================================\n\n/**\n * Build system prompt with workspace context integration\n * \n * Injects workspace files at appropriate positions in the system prompt.\n */\nexport function buildSystemPrompt(\n  workspaceDir: string,\n  options: SystemPromptOptions\n): string {\n  const {\n    bootstrapFiles,\n    promptMode = 'full',\n    heartbeatEnabled = false,\n    heartbeatPrompt,\n    availableTools = [],\n    memoryCitationsMode = 'on',\n    userTimezone,\n    runtime,\n    channels = [],\n    curatedMemorySnapshot,\n    externalMemoryInstructions,\n    skillsPromptMode = 'metadata-only',\n    ttsSystemHint,\n  } = options;\n\n  if (promptMode === 'none') {\n    return 'You are a personal AI assistant running inside xopc.';\n  }\n\n  const isMinimal = promptMode === 'minimal';\n\n  const curatedUserFrozen = !!(curatedMemorySnapshot?.user?.trim());\n  const hasCuratedSnapshot = !!(\n    curatedMemorySnapshot?.memory?.trim() || curatedMemorySnapshot?.user?.trim()\n  );\n\n  const sections: string[] = [];\n\n  // 1. Identity and persona (non-minimal only)\n  if (!isMinimal) {\n    sections.push(buildIdentitySection(bootstrapFiles));\n    sections.push(buildSoulSection(bootstrapFiles));\n  }\n\n  // 2. Curated memory snapshot (non-minimal; frozen at session start)\n  if (!isMinimal) {\n    sections.push(buildCuratedMemorySection(curatedMemorySnapshot));\n  }\n\n  // 2b. External memory provider\n  if (!isMinimal) {\n    sections.push(buildExternalMemorySection(externalMemoryInstructions));\n  }\n\n  // 3. User context — workspace USER.md unless curated user block is active\n  if (!isMinimal && !curatedUserFrozen) {\n    sections.push(buildUserSection(bootstrapFiles));\n  }\n\n  // 4. Time (non-minimal only)\n  if (!isMinimal) {\n    sections.push(buildTimeSection(userTimezone));\n  }\n\n  // 5. Memory section (non-minimal only)\n  if (!isMinimal) {\n    sections.push(buildMemorySection(bootstrapFiles, memoryCitationsMode, hasCuratedSnapshot));\n  }\n\n  // 6. Skills\n  sections.push(buildSkillsSection(availableTools, skillsPromptMode));\n\n  // 6b. Safety (non-minimal only)\n  if (!isMinimal) {\n    sections.push(buildSafetySection());\n  }\n\n  // 7. Problem Solving Workflow (non-minimal only) - Harness Engineering\n  if (!isMinimal) {\n    sections.push(buildProblemSolvingSection());\n  }\n\n  // 8. Aesthetic Guidelines (non-minimal only)\n  if (!isMinimal) {\n    sections.push(buildAestheticSection());\n  }\n\n  // Cache boundary — stable content above is a better prompt-cache prefix for supported providers\n  sections.push(PROMPT_CACHE_BOUNDARY);\n\n  // 9. Heartbeat\n  sections.push(buildHeartbeatSection(bootstrapFiles, heartbeatEnabled, heartbeatPrompt, userTimezone));\n\n  // 10. Working directory\n  sections.push(buildWorkingDirSection(workspaceDir));\n\n  // 11. Tools (non-minimal only)\n  if (!isMinimal) {\n    sections.push(buildToolsSection(bootstrapFiles));\n  }\n\n  // 12. Agents guidelines\n  sections.push(buildAgentsSection(bootstrapFiles));\n\n  // 13. Messaging\n  sections.push(buildMessagingSection(channels, isMinimal));\n\n  // 13b. Voice (TTS)\n  if (!isMinimal && ttsSystemHint?.trim()) {\n    sections.push(`## Voice (TTS)\\n\\n${ttsSystemHint.trim()}`);\n  }\n\n  // 14. Runtime info\n  sections.push(buildRuntimeSection(runtime));\n\n  // Filter out empty sections and join\n  return sections.filter(Boolean).join('\\n\\n');\n}\n\n/**\n * Build minimal system prompt for subagents/cron jobs (Internal)\n */\nfunction _buildMinimalSystemPrompt(\n  workspaceDir: string,\n  bootstrapFiles: WorkspaceBootstrapFile[]\n): string {\n  return buildSystemPrompt(workspaceDir, {\n    bootstrapFiles,\n    promptMode: 'minimal',\n    heartbeatEnabled: false,\n  });\n}\n\n/**\n * Get bootstrap file by name (Internal)\n */\nfunction _getBootstrapFile(\n  bootstrapFiles: WorkspaceBootstrapFile[],\n  name: string\n): WorkspaceBootstrapFile | undefined {\n  return bootstrapFiles.find(f => f.name === name);\n}\n\n/**\n * Check if specific bootstrap file exists and is loaded (Internal)\n */\nfunction _hasBootstrapFile(\n  bootstrapFiles: WorkspaceBootstrapFile[],\n  name: string\n): boolean {\n  const file = bootstrapFiles.find(f => f.name === name);\n  return !!file && !file.missing && !!file.content;\n}\n"],"mappings":"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"}
+{"version":3,"file":"system-prompt.js","names":[],"sources":["../../../../src/agent/prompt/system-prompt.ts"],"sourcesContent":["/**\n * System Prompt Builder - Enhanced version with workspace context integration\n * \n * Integrates workspace bootstrap files:\n * - SOUL.md for persona and tone\n * - USER.md for user context\n * - IDENTITY.md for agent identity\n * - HEARTBEAT.md for task polling\n * - MEMORY.md for long-term memory\n * - Memory search integration in prompt\n */\n\nimport type { WorkspaceBootstrapFile } from '../context/workspace.js';\nimport {\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_USER_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_HEARTBEAT_FILENAME,\n  DEFAULT_MEMORY_FILENAME,\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  stripFrontMatter,\n} from '../context/workspace.js';\nimport type { MemorySnapshot } from '../memory/types.js';\nimport { PROMPT_CACHE_BOUNDARY } from './cache-boundary.js';\nimport type { PromptMode } from './types.js';\n\n// =============================================================================\n// Configuration (Internal)\n// =============================================================================\n\n/** Maximum characters to inject from workspace files into system prompt */\nconst PROMPT_MAX_CHARS = {\n  SOUL: 8_000,\n  USER: 4_000,\n  IDENTITY: 2_000,\n  AGENTS: 20_000,\n  TOOLS: 4_000,\n  HEARTBEAT: 2_000,\n  MEMORY: 8_000,\n};\n\n/** Whether memory citation is enabled */\nexport type MemoryCitationsMode = 'on' | 'off' | 'source-only';\n\nexport interface SystemPromptOptions {\n  /** Workspace bootstrap files */\n  bootstrapFiles: WorkspaceBootstrapFile[];\n  /** Which sections to include. Defaults to \"full\". */\n  promptMode?: PromptMode;\n  /** Whether heartbeat is enabled */\n  heartbeatEnabled?: boolean;\n  /** Custom heartbeat prompt */\n  heartbeatPrompt?: string;\n  /** Available tool names for skill matching */\n  availableTools?: string[];\n  /** Memory citations mode */\n  memoryCitationsMode?: MemoryCitationsMode;\n  /** User timezone for date/time display */\n  userTimezone?: string;\n  /** Runtime info (version, model, channel) */\n  runtime?: {\n    version?: string;\n    model?: string;\n    channel?: string;\n  };\n  /** Active messaging channels */\n  channels?: string[];\n  /** Frozen curated memory from agent home `memories/` (session start only). */\n  curatedMemorySnapshot?: MemorySnapshot;\n  /** External memory provider static instructions. */\n  externalMemoryInstructions?: string;\n  /** Optional TTS / voice output guidance (when TTS is enabled). */\n  ttsSystemHint?: string;\n}\n\n// =============================================================================\n// Section Builders\n// =============================================================================\n\n/**\n * Build SOUL.md section - persona and tone\n * \n * If SOUL.md is present, embody its persona and tone\n */\nfunction buildSoulSection(bootstrapFiles: WorkspaceBootstrapFile[]): string {\n  const soulFile = bootstrapFiles.find(f => f.name === DEFAULT_SOUL_FILENAME);\n  if (!soulFile || soulFile.missing || !soulFile.content) {\n    return '';\n  }\n\n  // Strip front matter and truncate\n  const content = stripFrontMatter(soulFile.content);\n  const truncated = truncateForPrompt(content, PROMPT_MAX_CHARS.SOUL);\n\n  return `## SOUL.md - Your Persona\n\n${truncated}\n\n_Embody this persona unless higher-priority instructions override it._\n`;\n}\n\n/**\n * Build USER.md section - user context\n */\nfunction buildUserSection(bootstrapFiles: WorkspaceBootstrapFile[]): string {\n  const userFile = bootstrapFiles.find(f => f.name === DEFAULT_USER_FILENAME);\n  if (!userFile || userFile.missing || !userFile.content) {\n    return '';\n  }\n\n  const content = stripFrontMatter(userFile.content);\n  const truncated = truncateForPrompt(content, PROMPT_MAX_CHARS.USER);\n\n  return `## USER.md - About Your Human\n\n${truncated}\n\n_Use this context to provide personalized assistance._\n`;\n}\n\n/**\n * Curated MEMORY.md + USER.md blocks (frozen at session start).\n */\nfunction buildExternalMemorySection(text: string | undefined): string {\n  const t = text?.trim();\n  if (!t) {\n    return '';\n  }\n  return `## External memory provider\n\n${t}`;\n}\n\nfunction buildCuratedMemorySection(snapshot: MemorySnapshot | undefined): string {\n  const mem = snapshot?.memory?.trim() ?? '';\n  const user = snapshot?.user?.trim() ?? '';\n  if (!mem && !user) {\n    return '';\n  }\n\n  const body = [mem, user].filter(Boolean).join('\\n\\n');\n  return `## Curated memory (session snapshot)\n\n> Frozen when this session started. Updates use \\`curated_memory\\` and save under agent home \\`memories/\\`; they do not change this block until a new session.\n\n${body}`;\n}\n\n/**\n * Build IDENTITY.md section - agent identity\n */\nfunction buildIdentitySection(bootstrapFiles: WorkspaceBootstrapFile[]): string {\n  const identityFile = bootstrapFiles.find(f => f.name === DEFAULT_IDENTITY_FILENAME);\n  if (!identityFile || identityFile.missing || !identityFile.content) {\n    return '';\n  }\n\n  const content = stripFrontMatter(identityFile.content);\n  const truncated = truncateForPrompt(content, PROMPT_MAX_CHARS.IDENTITY);\n\n  return `## IDENTITY.md - Who You Are\n\n${truncated}\n`;\n}\n\n/**\n * Build AGENTS.md section - development guidelines\n */\nfunction buildAgentsSection(bootstrapFiles: WorkspaceBootstrapFile[]): string {\n  const agentsFile = bootstrapFiles.find(f => f.name === DEFAULT_AGENTS_FILENAME);\n  if (!agentsFile || agentsFile.missing || !agentsFile.content) {\n    return '';\n  }\n\n  const content = stripFrontMatter(agentsFile.content);\n  const truncated = truncateForPrompt(content, PROMPT_MAX_CHARS.AGENTS);\n\n  return `## AGENTS.md - Development Guidelines\n\n${truncated}\n`;\n}\n\n/**\n * Build TOOLS.md section - local tool notes\n */\nfunction buildToolsSection(bootstrapFiles: WorkspaceBootstrapFile[]): string {\n  const toolsFile = bootstrapFiles.find(f => f.name === DEFAULT_TOOLS_FILENAME);\n  if (!toolsFile || toolsFile.missing || !toolsFile.content) {\n    return '';\n  }\n\n  const content = stripFrontMatter(toolsFile.content);\n  const truncated = truncateForPrompt(content, PROMPT_MAX_CHARS.TOOLS);\n\n  return `## TOOLS.md - Local Notes\n\n${truncated}\n`;\n}\n\n/**\n * Build HEARTBEAT.md section - task polling\n */\nfunction buildHeartbeatSection(\n  bootstrapFiles: WorkspaceBootstrapFile[],\n  enabled: boolean,\n  customPrompt?: string,\n  userTimezone?: string\n): string {\n  if (!enabled) {\n    return '';\n  }\n\n  // If custom prompt provided, use it\n  if (customPrompt) {\n    return `## Heartbeat\n\n${customPrompt}\n`;\n  }\n\n  // Try to load from HEARTBEAT.md\n  const heartbeatFile = bootstrapFiles.find(f => f.name === DEFAULT_HEARTBEAT_FILENAME);\n  if (!heartbeatFile || heartbeatFile.missing || !heartbeatFile.content) {\n    // Default heartbeat behavior with timezone-aware quiet hours\n    let quietHoursNote = '';\n    if (userTimezone) {\n      quietHoursNote = `\\n\\n> 💤 Quiet hours: The user is in **${userTimezone}**. Avoid proactive checks during late night (23:00-08:00) unless urgent.`;\n    }\n    return `## Heartbeat\n\nPoll for tasks. If nothing needs attention, reply: HEARTBEAT_OK\n\n_Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats._${quietHoursNote}\n`;\n  }\n\n  const content = stripFrontMatter(heartbeatFile.content);\n  const truncated = truncateForPrompt(content, PROMPT_MAX_CHARS.HEARTBEAT);\n\n  let quietHoursNote = '';\n  if (userTimezone) {\n    quietHoursNote = `\\n\\n> 💤 Quiet hours: The user is in **${userTimezone}**. Avoid proactive checks during late night (23:00-08:00) unless urgent.`;\n  }\n\n  return `## HEARTBEAT.md - Task Checklist\n\n${truncated}\n\n_Read HEARTBEAT.md for current tasks. If nothing needs attention, reply: HEARTBEAT_OK_${quietHoursNote}\n`;\n}\n\n/**\n * Build Memory section - recall instructions\n * \n * Before answering anything about prior work, decisions, dates, people, preferences, or todos: run memory_search\n */\nfunction buildMemorySection(\n  bootstrapFiles: WorkspaceBootstrapFile[],\n  citationsMode: MemoryCitationsMode = 'on',\n  hasCuratedSnapshot = false,\n): string {\n  const memoryFile = bootstrapFiles.find(f => f.name === DEFAULT_MEMORY_FILENAME);\n  const hasWorkspaceMemoryFile = !!(memoryFile && !memoryFile.missing);\n\n  if (!hasWorkspaceMemoryFile && !hasCuratedSnapshot) {\n    return '';\n  }\n\n  const citationInstruction = citationsMode === 'off'\n    ? 'Citations are disabled: do not mention file paths or line numbers in replies.'\n    : citationsMode === 'source-only'\n    ? 'Citations: mention file path when it helps (e.g., Source: MEMORY.md).'\n    : 'Citations: include Source: <path#line> when it helps the user verify memory snippets.';\n\n  const curatedLines = hasCuratedSnapshot\n    ? `\n- **Curated store:** agent home \\`memories/MEMORY.md\\` and \\`memories/USER.md\\` — use \\`curated_memory\\` to add/replace/remove/read structured entries.`\n    : '';\n\n  return `## Memory Recall\n\n${citationInstruction}\n\nBefore answering anything about prior work, decisions, dates, people, preferences, or todos:\n1. Run \\`memory_search\\` on bootstrap MEMORY.md, agent-home \\`memories/*.md\\`, and workspace \\`memory/*.md\\`\n2. For **other chat sessions** / cross-session history, use \\`session_search\\` with keywords (or omit \\`query\\` to list recent sessions)\n3. Use \\`memory_get\\` to pull only the needed lines from files\n4. If low confidence after search, say you checked\n\n### Memory Files\n\n- **Daily notes:** \\`memory/YYYY-MM-DD.md\\` — raw logs of what happened\n- **Long-term:** \\`MEMORY.md\\` — your curated memories, like a human's long-term memory${curatedLines}\n\n### Writing to Memory\n\n- **Declarative vs procedural:** Save **facts and preferences** (who the user is, how they want you to behave, stable environment) via workspace memory files and/or \\`curated_memory\\`. Save **reusable task playbooks** (steps, pitfalls, verification for a class of work) with \\`skill_manage\\` as skills — not as long prose in MEMORY.md.\n- **Memory is limited** — if you want to remember something, WRITE IT TO A FILE\n- \"Mental notes\" don't survive session restarts. Files do.\n- When someone says \"remember this\" → update \\`memory/YYYY-MM-DD.md\\` or relevant file\n- When you learn a lesson → update relevant files\n- When you make a mistake → document it so future-you doesn't repeat it\n- **Text > Brain** 📝\n`;\n}\n\n/**\n * Build Skills section - skill matching guidelines\n */\nfunction buildSkillsSection(availableTools: string[] = []): string {\n  if (availableTools.length === 0) {\n    return '';\n  }\n\n  return `## Skills\n\nWhen a solution already exists, do not reinvent the wheel.\n\n**How to use:**\n1. Skim <available_skills> — is anything clearly relevant?\n2. Only one match? → Confirm with skills_list, then load the full text with skill_view(name) and follow it.\n3. Need sub-documents or scripts? → skill_view(name, \"references/…\"), etc. (only references, templates, scripts, assets)\n4. No match? → Solve it yourself; do not force-fit a skill.\n\n**Principle:** Skills are tools, not shackles. If after reading one it does not fit, set it aside and proceed on your own.\n\n**Division of labor with memory:** Skills = **procedural** workflows (how to do a class of tasks); memory / \\`curated_memory\\` = **declarative** facts and preferences. After a complex task succeeds, you may codify it as a skill; user-profile-style information belongs in memory. When a skill is outdated or incomplete, fix it immediately with \\`skill_manage\\` (e.g. patch).\n`;\n}\n\nfunction buildSafetySection(): string {\n  return `## Safety\n\n- You have no independent goals: do not pursue self-preservation, replication, resource acquisition, or power-seeking; avoid long-term plans beyond the user's request.\n- Prioritize safety and human oversight over completion; if instructions conflict, pause and ask; comply with stop/pause/audit requests and never bypass safeguards.\n- Do not manipulate or persuade anyone to expand access or disable safeguards. Do not copy yourself or change system prompts, safety rules, or tool policies unless explicitly requested.`;\n}\n\n/**\n * Build Problem Solving Workflow section\n *\n * Implements the \"Build & Self-Verify\" pattern from harness engineering.\n * Guides agents through an iterative problem-solving process with verification.\n *\n * Inspired by: https://blog.langchain.com/improving-deep-agents-with-harness-engineering/\n */\nfunction buildProblemSolvingSection(): string {\n  return `## Problem Solving\n\n**Simple tasks** (< 5 minutes or a single-file change): Do them directly; run a quick verification after changes.\n\n**Complex tasks** (multiple files or design decisions): Use an iterative flow — Plan → Build → Verify → Fix.\n\n**Decision criteria:**\n- Multiple files or refactoring? → Plan first\n- Existing test coverage? → You must verify\n- Documentation or comments only? → Verification can be lighter\n- User says \"just take a quick look\"? → Skip ceremony; deliver the result directly\n\n**Core principle: Match the complexity; reject ritual for its own sake. Verification matters, but do not verify just to tick a box.**`;\n}\n\n/**\n * Build Aesthetic Guidelines section - tone and style preferences\n */\nfunction buildAestheticSection(): string {\n  return `## Tone & Style\n\n**Default voice:**\n- Direct over diplomatic (\"This is broken\" beats \"This might be worth considering\")\n- Concise over exhaustive (do not expand on what the user did not ask for)\n- Concrete over abstract (use examples, not lectures)\n\n**Avoid LLM-isms:**\n- Do not open with \"This is a complex question...\"\n- Rarely use \"It is worth noting...\" / \"It is important to emphasize...\"\n- Not every sentence needs bullets; natural paragraphs are fine\n- Do not wrap a simple takeaway in a four-step framework\n\n**SOUL.md takes precedence:** If SOUL.md defines a specific tone, defer to it over the above.\n`;\n}\nfunction buildMessagingSection(\n  channels: string[] = [],\n  isMinimal: boolean = false\n): string {\n  if (isMinimal || channels.length === 0) {\n    return '';\n  }\n\n  const channelList = channels.join(', ');\n\n  return `## Messaging\n\n- Reply in current session → automatically routes to the source channel (${channelList})\n- Use \\`message\\` for proactive sends + channel actions\n- If you use \\`message\\` to deliver your user-visible reply, respond with ONLY: NO_REPLY (avoid duplicate replies)\n`;\n}\n\n/**\n * Build Time section - user timezone\n */\nfunction buildTimeSection(timezone?: string): string {\n  if (!timezone) {\n    return '';\n  }\n\n  return `## Current Date & Time\n\nTime zone: ${timezone}\n\nIf you need the current date/time/day-of-week, use the \\`session_status\\` tool or the inbound message timestamp envelope (when present).\n`;\n}\n\n/**\n * Build Runtime section - version info\n */\nfunction buildRuntimeSection(runtime?: { version?: string; model?: string; channel?: string }): string {\n  if (!runtime) {\n    return '';\n  }\n\n  const parts: string[] = [];\n  if (runtime.version) parts.push(`v${runtime.version}`);\n  if (runtime.model) parts.push(`model=${runtime.model.split('/').pop()}`);\n  if (runtime.channel) parts.push(`ch=${runtime.channel}`);\n\n  return parts.length > 0 ? `[${parts.join(' | ')}]` : '';\n}\n\n/**\n * Build Working Directory section\n */\nfunction buildWorkingDirSection(workspaceDir: string): string {\n  return `Working directory: ${workspaceDir}`;\n}\n\n// =============================================================================\n// Utilities\n// =============================================================================\n\n/**\n * Truncate content for prompt injection\n * Keeps head and tail to preserve context\n */\nfunction truncateForPrompt(content: string, maxChars: number): string {\n  const trimmed = content.trimEnd();\n  if (trimmed.length <= maxChars) {\n    return trimmed;\n  }\n\n  // Keep head (70%) and tail (20%) with marker\n  const headChars = Math.floor(maxChars * 0.7);\n  const tailChars = Math.floor(maxChars * 0.2);\n  const head = trimmed.slice(0, headChars);\n  const tail = trimmed.slice(-tailChars);\n\n  return `${head}\n\n[...]${tail}`;\n}\n\n// =============================================================================\n// Main Builder\n// =============================================================================\n\n/**\n * Build system prompt with workspace context integration\n * \n * Injects workspace files at appropriate positions in the system prompt.\n */\nexport function buildSystemPrompt(\n  workspaceDir: string,\n  options: SystemPromptOptions\n): string {\n  const {\n    bootstrapFiles,\n    promptMode = 'full',\n    heartbeatEnabled = false,\n    heartbeatPrompt,\n    availableTools = [],\n    memoryCitationsMode = 'on',\n    userTimezone,\n    runtime,\n    channels = [],\n    curatedMemorySnapshot,\n    externalMemoryInstructions,\n    ttsSystemHint,\n  } = options;\n\n  if (promptMode === 'none') {\n    return 'You are a personal AI assistant running inside xopc.';\n  }\n\n  const isMinimal = promptMode === 'minimal';\n\n  const curatedUserFrozen = !!(curatedMemorySnapshot?.user?.trim());\n  const hasCuratedSnapshot = !!(\n    curatedMemorySnapshot?.memory?.trim() || curatedMemorySnapshot?.user?.trim()\n  );\n\n  const sections: string[] = [];\n\n  // 1. Identity and persona (non-minimal only)\n  if (!isMinimal) {\n    sections.push(buildIdentitySection(bootstrapFiles));\n    sections.push(buildSoulSection(bootstrapFiles));\n  }\n\n  // 2. Curated memory snapshot (non-minimal; frozen at session start)\n  if (!isMinimal) {\n    sections.push(buildCuratedMemorySection(curatedMemorySnapshot));\n  }\n\n  // 2b. External memory provider\n  if (!isMinimal) {\n    sections.push(buildExternalMemorySection(externalMemoryInstructions));\n  }\n\n  // 3. User context — workspace USER.md unless curated user block is active\n  if (!isMinimal && !curatedUserFrozen) {\n    sections.push(buildUserSection(bootstrapFiles));\n  }\n\n  // 4. Time (non-minimal only)\n  if (!isMinimal) {\n    sections.push(buildTimeSection(userTimezone));\n  }\n\n  // 5. Memory section (non-minimal only)\n  if (!isMinimal) {\n    sections.push(buildMemorySection(bootstrapFiles, memoryCitationsMode, hasCuratedSnapshot));\n  }\n\n  // 6. Skills\n  sections.push(buildSkillsSection(availableTools));\n\n  // 6b. Safety (non-minimal only)\n  if (!isMinimal) {\n    sections.push(buildSafetySection());\n  }\n\n  // 7. Problem Solving Workflow (non-minimal only) - Harness Engineering\n  if (!isMinimal) {\n    sections.push(buildProblemSolvingSection());\n  }\n\n  // 8. Aesthetic Guidelines (non-minimal only)\n  if (!isMinimal) {\n    sections.push(buildAestheticSection());\n  }\n\n  // Cache boundary — stable content above is a better prompt-cache prefix for supported providers\n  sections.push(PROMPT_CACHE_BOUNDARY);\n\n  // 9. Heartbeat\n  sections.push(buildHeartbeatSection(bootstrapFiles, heartbeatEnabled, heartbeatPrompt, userTimezone));\n\n  // 10. Working directory\n  sections.push(buildWorkingDirSection(workspaceDir));\n\n  // 11. Tools (non-minimal only)\n  if (!isMinimal) {\n    sections.push(buildToolsSection(bootstrapFiles));\n  }\n\n  // 12. Agents guidelines\n  sections.push(buildAgentsSection(bootstrapFiles));\n\n  // 13. Messaging\n  sections.push(buildMessagingSection(channels, isMinimal));\n\n  // 13b. Voice (TTS)\n  if (!isMinimal && ttsSystemHint?.trim()) {\n    sections.push(`## Voice (TTS)\\n\\n${ttsSystemHint.trim()}`);\n  }\n\n  // 14. Runtime info\n  sections.push(buildRuntimeSection(runtime));\n\n  // Filter out empty sections and join\n  return sections.filter(Boolean).join('\\n\\n');\n}\n\n/**\n * Build minimal system prompt for subagents/cron jobs (Internal)\n */\nfunction _buildMinimalSystemPrompt(\n  workspaceDir: string,\n  bootstrapFiles: WorkspaceBootstrapFile[]\n): string {\n  return buildSystemPrompt(workspaceDir, {\n    bootstrapFiles,\n    promptMode: 'minimal',\n    heartbeatEnabled: false,\n  });\n}\n\n/**\n * Get bootstrap file by name (Internal)\n */\nfunction _getBootstrapFile(\n  bootstrapFiles: WorkspaceBootstrapFile[],\n  name: string\n): WorkspaceBootstrapFile | undefined {\n  return bootstrapFiles.find(f => f.name === name);\n}\n\n/**\n * Check if specific bootstrap file exists and is loaded (Internal)\n */\nfunction _hasBootstrapFile(\n  bootstrapFiles: WorkspaceBootstrapFile[],\n  name: string\n): boolean {\n  const file = bootstrapFiles.find(f => f.name === name);\n  return !!file && !file.missing && !!file.content;\n}\n"],"mappings":"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"}

package/dist/src/agent/service/btw-query.d.ts

@@ -0,0 +1,16 @@
+import type { SessionStore } from '../../session/index.js';
+type BtwLog = {
+    warn: (obj: Record<string, unknown>, msg: string) => void;
+};
+/** One-shot LLM answer for /btw: transcript as background only; does not persist. */
+export declare function runBtwQuery(opts: {
+    sessionKey: string;
+    question: string;
+    sessionStore: SessionStore;
+    modelForSession: string;
+    log: BtwLog;
+}): Promise<{
+    text: string;
+    error?: string;
+}>;
+export {};

package/dist/src/agent/service/btw-query.js

@@ -0,0 +1,88 @@
+import { init_providers, resolveModel } from "../../providers/index.js";
+import { complete } from "@mariozechner/pi-ai";
+//#region src/agent/service/btw-query.ts
+init_providers();
+function formatMessagesForBtw(messages) {
+	return messages.map((m) => {
+		const role = m.role;
+		let body = "";
+		if (typeof m.content === "string") body = m.content;
+		else if (Array.isArray(m.content)) body = m.content.filter((c) => c.type === "text").map((c) => c.text || "").join("\n");
+		const line = `[${role}]: ${body}`;
+		return line.length > 4e3 ? `${line.slice(0, 4e3)}…` : line;
+	}).join("\n\n");
+}
+/** One-shot LLM answer for /btw: transcript as background only; does not persist. */
+async function runBtwQuery(opts) {
+	const q = opts.question.trim();
+	if (!q) return {
+		text: "",
+		error: "Empty question."
+	};
+	const messages = await opts.sessionStore.load(opts.sessionKey);
+	const modelRef = opts.modelForSession;
+	let model;
+	try {
+		model = resolveModel(modelRef);
+	} catch (err) {
+		const em = err instanceof Error ? err.message : String(err);
+		opts.log.warn({
+			err,
+			modelRef,
+			errorMessage: em
+		}, "btwQuery: model resolve failed");
+		return {
+			text: "",
+			error: `Could not resolve model: ${modelRef}`
+		};
+	}
+	const background = formatMessagesForBtw(messages.slice(-40));
+	const userMessage = {
+		role: "user",
+		content: [
+			[
+				"You are answering an ephemeral /btw side question about the current conversation.",
+				"Use the conversation only as background context.",
+				"Answer only the side question. Do not continue or complete any unfinished task from the conversation.",
+				"Do not use tools, shell, or file writes unless the question explicitly requires a tiny code snippet.",
+				"If the question can be answered briefly, answer briefly."
+			].join("\n"),
+			"",
+			"---",
+			"Conversation background (read-only):",
+			background || "(empty)",
+			"",
+			"---",
+			"Side question:",
+			q
+		].join("\n"),
+		timestamp: Date.now()
+	};
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), 9e4);
+	try {
+		const out = await complete(model, { messages: [userMessage] }, {
+			maxTokens: 2048,
+			temperature: .4,
+			signal: controller.signal
+		});
+		return { text: (Array.isArray(out.content) ? out.content.filter((c) => c.type === "text" && typeof c.text === "string").map((c) => c.text || "").join("") : "").trim() };
+	} catch (err) {
+		const em = err instanceof Error ? err.message : String(err);
+		opts.log.warn({
+			err,
+			sessionKey: opts.sessionKey,
+			errorMessage: em
+		}, "btwQuery failed");
+		return {
+			text: "",
+			error: em
+		};
+	} finally {
+		clearTimeout(timeoutId);
+	}
+}
+//#endregion
+export { runBtwQuery };
+
+//# sourceMappingURL=btw-query.js.map

package/dist/src/agent/service/btw-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"btw-query.js","names":[],"sources":["../../../../src/agent/service/btw-query.ts"],"sourcesContent":["import type { AgentMessage } from '@mariozechner/pi-agent-core';\nimport { complete, type UserMessage } from '@mariozechner/pi-ai';\n\nimport type { SessionStore } from '../../session/index.js';\nimport { resolveModel } from '../../providers/index.js';\n\ntype BtwLog = { warn: (obj: Record<string, unknown>, msg: string) => void };\n\nfunction formatMessagesForBtw(messages: AgentMessage[]): string {\n  return messages\n    .map((m) => {\n      const role = m.role;\n      let body = '';\n      if (typeof m.content === 'string') {\n        body = m.content;\n      } else if (Array.isArray(m.content)) {\n        body = m.content\n          .filter((c): c is { type: 'text'; text: string } => c.type === 'text')\n          .map((c) => c.text || '')\n          .join('\\n');\n      }\n      const line = `[${role}]: ${body}`;\n      return line.length > 4000 ? `${line.slice(0, 4000)}…` : line;\n    })\n    .join('\\n\\n');\n}\n\n/** One-shot LLM answer for /btw: transcript as background only; does not persist. */\nexport async function runBtwQuery(opts: {\n  sessionKey: string;\n  question: string;\n  sessionStore: SessionStore;\n  modelForSession: string;\n  log: BtwLog;\n}): Promise<{ text: string; error?: string }> {\n  const q = opts.question.trim();\n  if (!q) {\n    return { text: '', error: 'Empty question.' };\n  }\n  const messages = await opts.sessionStore.load(opts.sessionKey);\n  const modelRef = opts.modelForSession;\n  let model;\n  try {\n    model = resolveModel(modelRef);\n  } catch (err) {\n    const em = err instanceof Error ? err.message : String(err);\n    opts.log.warn({ err, modelRef, errorMessage: em }, 'btwQuery: model resolve failed');\n    return { text: '', error: `Could not resolve model: ${modelRef}` };\n  }\n\n  const background = formatMessagesForBtw(messages.slice(-40));\n  const systemBlock = [\n    'You are answering an ephemeral /btw side question about the current conversation.',\n    'Use the conversation only as background context.',\n    'Answer only the side question. Do not continue or complete any unfinished task from the conversation.',\n    'Do not use tools, shell, or file writes unless the question explicitly requires a tiny code snippet.',\n    'If the question can be answered briefly, answer briefly.',\n  ].join('\\n');\n\n  const userPrompt = [\n    systemBlock,\n    '',\n    '---',\n    'Conversation background (read-only):',\n    background || '(empty)',\n    '',\n    '---',\n    'Side question:',\n    q,\n  ].join('\\n');\n\n  const userMessage: UserMessage = { role: 'user', content: userPrompt, timestamp: Date.now() };\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), 90_000);\n  try {\n    const out = await complete(model, { messages: [userMessage] }, {\n      maxTokens: 2048,\n      temperature: 0.4,\n      signal: controller.signal as AbortSignal,\n    });\n    const text = Array.isArray(out.content)\n      ? out.content\n          .filter(\n            (c): c is { type: 'text'; text: string } =>\n              c.type === 'text' && typeof (c as { text?: unknown }).text === 'string',\n          )\n          .map((c) => c.text || '')\n          .join('')\n      : '';\n    return { text: text.trim() };\n  } catch (err) {\n    const em = err instanceof Error ? err.message : String(err);\n    opts.log.warn({ err, sessionKey: opts.sessionKey, errorMessage: em }, 'btwQuery failed');\n    return { text: '', error: em };\n  } finally {\n    clearTimeout(timeoutId);\n  }\n}\n"],"mappings":";;;gBAIwD;AAIxD,SAAS,qBAAqB,UAAkC;AAC9D,QAAO,SACJ,KAAK,MAAM;EACV,MAAM,OAAO,EAAE;EACf,IAAI,OAAO;AACX,MAAI,OAAO,EAAE,YAAY,SACvB,QAAO,EAAE;WACA,MAAM,QAAQ,EAAE,QAAQ,CACjC,QAAO,EAAE,QACN,QAAQ,MAA2C,EAAE,SAAS,OAAO,CACrE,KAAK,MAAM,EAAE,QAAQ,GAAG,CACxB,KAAK,KAAK;EAEf,MAAM,OAAO,IAAI,KAAK,KAAK;AAC3B,SAAO,KAAK,SAAS,MAAO,GAAG,KAAK,MAAM,GAAG,IAAK,CAAC,KAAK;GACxD,CACD,KAAK,OAAO;;;AAIjB,eAAsB,YAAY,MAMY;CAC5C,MAAM,IAAI,KAAK,SAAS,MAAM;AAC9B,KAAI,CAAC,EACH,QAAO;EAAE,MAAM;EAAI,OAAO;EAAmB;CAE/C,MAAM,WAAW,MAAM,KAAK,aAAa,KAAK,KAAK,WAAW;CAC9D,MAAM,WAAW,KAAK;CACtB,IAAI;AACJ,KAAI;AACF,UAAQ,aAAa,SAAS;UACvB,KAAK;EACZ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAK,IAAI,KAAK;GAAE;GAAK;GAAU,cAAc;GAAI,EAAE,iCAAiC;AACpF,SAAO;GAAE,MAAM;GAAI,OAAO,4BAA4B;GAAY;;CAGpE,MAAM,aAAa,qBAAqB,SAAS,MAAM,IAAI,CAAC;CAqB5D,MAAM,cAA2B;EAAE,MAAM;EAAQ,SAZ9B;GARC;IAClB;IACA;IACA;IACA;IACA;IACD,CAAC,KAAK,KAGM;GACX;GACA;GACA;GACA,cAAc;GACd;GACA;GACA;GACA;GACD,CAAC,KAAK,KAE6D;EAAE,WAAW,KAAK,KAAK;EAAE;CAC7F,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,IAAO;AAC9D,KAAI;EACF,MAAM,MAAM,MAAM,SAAS,OAAO,EAAE,UAAU,CAAC,YAAY,EAAE,EAAE;GAC7D,WAAW;GACX,aAAa;GACb,QAAQ,WAAW;GACpB,CAAC;AAUF,SAAO,EAAE,OATI,MAAM,QAAQ,IAAI,QAAQ,GACnC,IAAI,QACD,QACE,MACC,EAAE,SAAS,UAAU,OAAQ,EAAyB,SAAS,SAClE,CACA,KAAK,MAAM,EAAE,QAAQ,GAAG,CACxB,KAAK,GAAG,GACX,IACgB,MAAM,EAAE;UACrB,KAAK;EACZ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAK,IAAI,KAAK;GAAE;GAAK,YAAY,KAAK;GAAY,cAAc;GAAI,EAAE,kBAAkB;AACxF,SAAO;GAAE,MAAM;GAAI,OAAO;GAAI;WACtB;AACR,eAAa,UAAU"}

package/dist/src/agent/service/build-direct-message-content.d.ts

@@ -0,0 +1,30 @@
+import type { Config } from '../../config/schema.js';
+import type { AgentManager } from '../agent-manager.js';
+import type { ModelManager } from '../models/index.js';
+export type DirectInboundAttachment = {
+    type: string;
+    mimeType?: string;
+    data?: string;
+    name?: string;
+    size?: number;
+    workspaceRelativePath?: string;
+};
+export type DirectMessagePart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    data: string;
+    mimeType: string;
+};
+/**
+ * Build user message parts (text + resolved images/files) for direct / webchat turns.
+ */
+export declare function buildDirectUserMessageContent(opts: {
+    content: string;
+    attachments?: DirectInboundAttachment[];
+    sessionKey?: string;
+    config: Config;
+    agentManager: AgentManager;
+    modelManager: ModelManager;
+}): Promise<DirectMessagePart[]>;

package/dist/src/agent/service/build-direct-message-content.js

@@ -0,0 +1,75 @@
+import { init_agent_scope, resolveAgentHomeDir, resolveDefaultAgentId } from "../agent-scope.js";
+import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
+import { extractProfileAgentId } from "../../config/agent-profile.js";
+import { getDefaultModelSync, init_providers } from "../../providers/index.js";
+import { formatInboundFileTextBlock } from "../../channels/attachments/inbound-persist.js";
+import { expandAtFileMentionsInPlainText } from "../context/expand-at-file-mentions.js";
+import { resolveInboundImageContentParts } from "../image/inbound-image-handling.js";
+//#region src/agent/service/build-direct-message-content.ts
+init_schema();
+init_providers();
+init_agent_scope();
+/**
+* Build user message parts (text + resolved images/files) for direct / webchat turns.
+*/
+async function buildDirectUserMessageContent(opts) {
+	const { content, attachments, sessionKey, config, agentManager, modelManager } = opts;
+	const messageContent = [];
+	const sk = sessionKey ?? "";
+	if (content.trim()) {
+		let textPart = content;
+		if (/@file:/.test(textPart)) {
+			const wsKey = sk !== "" ? sk : "cli:direct";
+			const root = agentManager.getResolvedWorkspaceForSession(wsKey);
+			textPart = await expandAtFileMentionsInPlainText(textPart, root);
+		}
+		messageContent.push({
+			type: "text",
+			text: textPart
+		});
+	}
+	if (!attachments?.length) return messageContent;
+	const modelRef = sk !== "" ? modelManager.getModelForSession(sk) : getAgentDefaultModelRef(config) ?? getDefaultModelSync(config);
+	const storageRoot = sk !== "" ? resolveAgentHomeDir(config, extractProfileAgentId(sk, config)) : resolveAgentHomeDir(config, resolveDefaultAgentId(config));
+	let i = 0;
+	while (i < attachments.length) {
+		const att = attachments[i];
+		if (att.type === "image" || att.type === "photo" || Boolean(att.mimeType?.startsWith("image/"))) {
+			const group = [];
+			while (i < attachments.length) {
+				const a = attachments[i];
+				if (!(a.type === "image" || a.type === "photo" || Boolean(a.mimeType?.startsWith("image/")))) break;
+				if (!a.data || a.data.length === 0) {
+					i += 1;
+					continue;
+				}
+				group.push({
+					data: a.data,
+					mimeType: a.mimeType || "image/png"
+				});
+				i += 1;
+			}
+			if (group.length > 0) {
+				const parts = await resolveInboundImageContentParts({
+					modelRef: modelRef || getDefaultModelSync(config),
+					cfg: config,
+					userTextForContext: content.trim() ? content : "",
+					images: group
+				});
+				messageContent.push(...parts);
+			}
+		} else {
+			const fileBlock = formatInboundFileTextBlock(att, storageRoot);
+			messageContent.push({
+				type: "text",
+				text: fileBlock
+			});
+			i += 1;
+		}
+	}
+	return messageContent;
+}
+//#endregion
+export { buildDirectUserMessageContent };
+
+//# sourceMappingURL=build-direct-message-content.js.map

package/dist/src/agent/service/build-direct-message-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-direct-message-content.js","names":[],"sources":["../../../../src/agent/service/build-direct-message-content.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { getAgentDefaultModelRef } from '../../config/schema.js';\nimport { getDefaultModelSync } from '../../providers/index.js';\nimport { formatInboundFileTextBlock } from '../../channels/attachments/inbound-persist.js';\nimport { expandAtFileMentionsInPlainText } from '../context/expand-at-file-mentions.js';\nimport { resolveInboundImageContentParts } from '../image/inbound-image-handling.js';\nimport { resolveAgentHomeDir, resolveDefaultAgentId } from '../agent-scope.js';\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport type { AgentManager } from '../agent-manager.js';\nimport type { ModelManager } from '../models/index.js';\n\nexport type DirectInboundAttachment = {\n  type: string;\n  mimeType?: string;\n  data?: string;\n  name?: string;\n  size?: number;\n  workspaceRelativePath?: string;\n};\n\nexport type DirectMessagePart =\n  | { type: 'text'; text: string }\n  | { type: 'image'; data: string; mimeType: string };\n\n/**\n * Build user message parts (text + resolved images/files) for direct / webchat turns.\n */\nexport async function buildDirectUserMessageContent(opts: {\n  content: string;\n  attachments?: DirectInboundAttachment[];\n  sessionKey?: string;\n  config: Config;\n  agentManager: AgentManager;\n  modelManager: ModelManager;\n}): Promise<DirectMessagePart[]> {\n  const { content, attachments, sessionKey, config, agentManager, modelManager } = opts;\n  const messageContent: DirectMessagePart[] = [];\n  const sk = sessionKey ?? '';\n\n  if (content.trim()) {\n    let textPart = content;\n    if (/@file:/.test(textPart)) {\n      const wsKey = sk !== '' ? sk : 'cli:direct';\n      const root = agentManager.getResolvedWorkspaceForSession(wsKey);\n      textPart = await expandAtFileMentionsInPlainText(textPart, root);\n    }\n    messageContent.push({ type: 'text', text: textPart });\n  }\n\n  if (!attachments?.length) {\n    return messageContent;\n  }\n\n  const modelRef =\n    sk !== ''\n      ? modelManager.getModelForSession(sk)\n      : getAgentDefaultModelRef(config) ?? getDefaultModelSync(config);\n\n  const storageRoot =\n    sk !== ''\n      ? resolveAgentHomeDir(config, extractProfileAgentId(sk, config))\n      : resolveAgentHomeDir(config, resolveDefaultAgentId(config));\n\n  let i = 0;\n  while (i < attachments.length) {\n    const att = attachments[i]!;\n    const isImage =\n      att.type === 'image' ||\n      att.type === 'photo' ||\n      Boolean(att.mimeType?.startsWith('image/'));\n\n    if (isImage) {\n      const group: Array<{ data: string; mimeType: string }> = [];\n      while (i < attachments.length) {\n        const a = attachments[i]!;\n        const img = a.type === 'image' || a.type === 'photo' || Boolean(a.mimeType?.startsWith('image/'));\n        if (!img) {\n          break;\n        }\n        if (!a.data || a.data.length === 0) {\n          i += 1;\n          continue;\n        }\n        group.push({ data: a.data, mimeType: a.mimeType || 'image/png' });\n        i += 1;\n      }\n      if (group.length > 0) {\n        const parts = await resolveInboundImageContentParts({\n          modelRef: modelRef || getDefaultModelSync(config),\n          cfg: config,\n          userTextForContext: content.trim() ? content : '',\n          images: group,\n        });\n        messageContent.push(...parts);\n      }\n    } else {\n      const fileBlock = formatInboundFileTextBlock(att, storageRoot);\n      messageContent.push({ type: 'text', text: fileBlock });\n      i += 1;\n    }\n  }\n\n  return messageContent;\n}\n"],"mappings":";;;;;;;;aACiE;gBACF;kBAIgB;;;;AAqB/E,eAAsB,8BAA8B,MAOnB;CAC/B,MAAM,EAAE,SAAS,aAAa,YAAY,QAAQ,cAAc,iBAAiB;CACjF,MAAM,iBAAsC,EAAE;CAC9C,MAAM,KAAK,cAAc;AAEzB,KAAI,QAAQ,MAAM,EAAE;EAClB,IAAI,WAAW;AACf,MAAI,SAAS,KAAK,SAAS,EAAE;GAC3B,MAAM,QAAQ,OAAO,KAAK,KAAK;GAC/B,MAAM,OAAO,aAAa,+BAA+B,MAAM;AAC/D,cAAW,MAAM,gCAAgC,UAAU,KAAK;;AAElE,iBAAe,KAAK;GAAE,MAAM;GAAQ,MAAM;GAAU,CAAC;;AAGvD,KAAI,CAAC,aAAa,OAChB,QAAO;CAGT,MAAM,WACJ,OAAO,KACH,aAAa,mBAAmB,GAAG,GACnC,wBAAwB,OAAO,IAAI,oBAAoB,OAAO;CAEpE,MAAM,cACJ,OAAO,KACH,oBAAoB,QAAQ,sBAAsB,IAAI,OAAO,CAAC,GAC9D,oBAAoB,QAAQ,sBAAsB,OAAO,CAAC;CAEhE,IAAI,IAAI;AACR,QAAO,IAAI,YAAY,QAAQ;EAC7B,MAAM,MAAM,YAAY;AAMxB,MAJE,IAAI,SAAS,WACb,IAAI,SAAS,WACb,QAAQ,IAAI,UAAU,WAAW,SAAS,CAAC,EAEhC;GACX,MAAM,QAAmD,EAAE;AAC3D,UAAO,IAAI,YAAY,QAAQ;IAC7B,MAAM,IAAI,YAAY;AAEtB,QAAI,EADQ,EAAE,SAAS,WAAW,EAAE,SAAS,WAAW,QAAQ,EAAE,UAAU,WAAW,SAAS,CAAC,EAE/F;AAEF,QAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,WAAW,GAAG;AAClC,UAAK;AACL;;AAEF,UAAM,KAAK;KAAE,MAAM,EAAE;KAAM,UAAU,EAAE,YAAY;KAAa,CAAC;AACjE,SAAK;;AAEP,OAAI,MAAM,SAAS,GAAG;IACpB,MAAM,QAAQ,MAAM,gCAAgC;KAClD,UAAU,YAAY,oBAAoB,OAAO;KACjD,KAAK;KACL,oBAAoB,QAAQ,MAAM,GAAG,UAAU;KAC/C,QAAQ;KACT,CAAC;AACF,mBAAe,KAAK,GAAG,MAAM;;SAE1B;GACL,MAAM,YAAY,2BAA2B,KAAK,YAAY;AAC9D,kBAAe,KAAK;IAAE,MAAM;IAAQ,MAAM;IAAW,CAAC;AACtD,QAAK;;;AAIT,QAAO"}

package/dist/src/agent/service/parse-outbound-session-key.d.ts

@@ -0,0 +1,8 @@
+import type { Config } from '../../config/schema.js';
+/**
+ * Map a session key to outbound channel routing (heartbeat/cron/virtual keys included).
+ */
+export declare function parseOutboundSessionKey(sessionKey: string, config: Config | undefined): {
+    channel: string;
+    chatId: string;
+};

package/dist/src/agent/service/parse-outbound-session-key.js

@@ -0,0 +1,41 @@
+import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
+import { INTERNAL_OUTBOUND_DROP_CHANNEL } from "../../channels/internal-outbound.js";
+//#region src/agent/service/parse-outbound-session-key.ts
+init_session_key();
+/**
+* Map a session key to outbound channel routing (heartbeat/cron/virtual keys included).
+*/
+function parseOutboundSessionKey(sessionKey, config) {
+	const parts = sessionKey.split(":").filter(Boolean);
+	const first = parts[0] || "cli";
+	if (first === "heartbeat") {
+		const hb = config?.gateway?.heartbeat;
+		const target = hb?.target?.trim();
+		const targetChatId = hb?.targetChatId?.trim();
+		if (target && targetChatId) return {
+			channel: target,
+			chatId: targetChatId
+		};
+		return {
+			channel: INTERNAL_OUTBOUND_DROP_CHANNEL,
+			chatId: parts.slice(1).join(":") || "heartbeat"
+		};
+	}
+	const parsed = parseSessionKey(sessionKey);
+	if (parsed) return {
+		channel: parsed.source,
+		chatId: parsed.peerId
+	};
+	if (first === "cron") return {
+		channel: INTERNAL_OUTBOUND_DROP_CHANNEL,
+		chatId: parts.slice(1).join(":") || "cron"
+	};
+	return {
+		channel: first,
+		chatId: parts.slice(1).join(":") || "direct"
+	};
+}
+//#endregion
+export { parseOutboundSessionKey };
+
+//# sourceMappingURL=parse-outbound-session-key.js.map

package/dist/src/agent/service/parse-outbound-session-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-outbound-session-key.js","names":["parseRoutingSessionKey"],"sources":["../../../../src/agent/service/parse-outbound-session-key.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { INTERNAL_OUTBOUND_DROP_CHANNEL } from '../../channels/internal-outbound.js';\nimport { parseSessionKey as parseRoutingSessionKey } from '../../routing/session-key.js';\n\n/**\n * Map a session key to outbound channel routing (heartbeat/cron/virtual keys included).\n */\nexport function parseOutboundSessionKey(\n  sessionKey: string,\n  config: Config | undefined,\n): { channel: string; chatId: string } {\n  const parts = sessionKey.split(':').filter(Boolean);\n  const first = parts[0] || 'cli';\n\n  if (first === 'heartbeat') {\n    const hb = config?.gateway?.heartbeat;\n    const target = hb?.target?.trim();\n    const targetChatId = hb?.targetChatId?.trim();\n    if (target && targetChatId) {\n      return { channel: target, chatId: targetChatId };\n    }\n    return { channel: INTERNAL_OUTBOUND_DROP_CHANNEL, chatId: parts.slice(1).join(':') || 'heartbeat' };\n  }\n\n  const parsed = parseRoutingSessionKey(sessionKey);\n  if (parsed) {\n    return { channel: parsed.source, chatId: parsed.peerId };\n  }\n\n  if (first === 'cron') {\n    return { channel: INTERNAL_OUTBOUND_DROP_CHANNEL, chatId: parts.slice(1).join(':') || 'cron' };\n  }\n\n  return {\n    channel: first,\n    chatId: parts.slice(1).join(':') || 'direct',\n  };\n}\n"],"mappings":";;;kBAEyF;;;;AAKzF,SAAgB,wBACd,YACA,QACqC;CACrC,MAAM,QAAQ,WAAW,MAAM,IAAI,CAAC,OAAO,QAAQ;CACnD,MAAM,QAAQ,MAAM,MAAM;AAE1B,KAAI,UAAU,aAAa;EACzB,MAAM,KAAK,QAAQ,SAAS;EAC5B,MAAM,SAAS,IAAI,QAAQ,MAAM;EACjC,MAAM,eAAe,IAAI,cAAc,MAAM;AAC7C,MAAI,UAAU,aACZ,QAAO;GAAE,SAAS;GAAQ,QAAQ;GAAc;AAElD,SAAO;GAAE,SAAS;GAAgC,QAAQ,MAAM,MAAM,EAAE,CAAC,KAAK,IAAI,IAAI;GAAa;;CAGrG,MAAM,SAASA,gBAAuB,WAAW;AACjD,KAAI,OACF,QAAO;EAAE,SAAS,OAAO;EAAQ,QAAQ,OAAO;EAAQ;AAG1D,KAAI,UAAU,OACZ,QAAO;EAAE,SAAS;EAAgC,QAAQ,MAAM,MAAM,EAAE,CAAC,KAAK,IAAI,IAAI;EAAQ;AAGhG,QAAO;EACL,SAAS;EACT,QAAQ,MAAM,MAAM,EAAE,CAAC,KAAK,IAAI,IAAI;EACrC"}

package/dist/src/agent/service/process-direct-one-shot.d.ts

@@ -0,0 +1,34 @@
+import type { AgentMessage } from '@mariozechner/pi-agent-core';
+import type { CommandHandler } from '../messaging/command-handler.js';
+import type { ProcessDirectStreamLog } from './process-direct-streaming.js';
+import type { AgentManager } from '../agent-manager.js';
+import type { ModelManager } from '../models/index.js';
+import type { SessionStore } from '../../session/index.js';
+import type { Config } from '../../config/schema.js';
+import { type DirectInboundAttachment } from './build-direct-message-content.js';
+export type RunProcessDirectDeps = {
+    log: ProcessDirectStreamLog;
+    config: Config;
+    parseSessionKey: (sessionKey: string) => {
+        channel: string;
+        chatId: string;
+    };
+    initSessionContext: (sessionKey: string, channel: string, chatId: string) => void;
+    hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;
+    hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;
+    agentManager: AgentManager;
+    sessionStore: SessionStore;
+    prepareLoadedSessionMessages: (sessionKey: string, messages: AgentMessage[]) => AgentMessage[];
+    modelManager: ModelManager;
+    applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;
+    prepareInboundAttachments: (sessionKey: string, attachments?: DirectInboundAttachment[]) => Promise<DirectInboundAttachment[] | undefined>;
+    commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;
+    persistAgentSessionMessages: (sessionKey: string) => Promise<void>;
+    endDirectRequestContext: () => void;
+};
+export declare function runProcessDirect(deps: RunProcessDirectDeps, input: {
+    content: string;
+    sessionKey: string;
+    attachments?: DirectInboundAttachment[];
+    thinking?: string;
+}): Promise<string>;

package/dist/src/agent/service/process-direct-one-shot.js

@@ -0,0 +1,67 @@
+import { extractAgentUserPlainText } from "../memory/user-message-text.js";
+import { parseSlashCommand } from "../../chat-commands/command-parse.js";
+import { commandRegistry } from "../../chat-commands/registry.js";
+import "../../chat-commands/index.js";
+import { runAgentTurnWithModelFallbacks } from "../orchestration/run-agent-turn-with-fallbacks.js";
+import { buildDirectUserMessageContent } from "./build-direct-message-content.js";
+//#region src/agent/service/process-direct-one-shot.ts
+async function runProcessDirect(deps, input) {
+	const { channel, chatId } = deps.parseSessionKey(input.sessionKey);
+	deps.initSessionContext(input.sessionKey, channel, chatId);
+	try {
+		await deps.hydrateSessionWorkspaceFromStore(input.sessionKey);
+		const agent = deps.agentManager.getOrCreateAgent(input.sessionKey);
+		await deps.hydrateSessionModelFromStore(input.sessionKey);
+		const loaded = await deps.sessionStore.load(input.sessionKey);
+		agent.state.messages = deps.prepareLoadedSessionMessages(input.sessionKey, loaded);
+		await deps.modelManager.applyModelForSession(agent, input.sessionKey);
+		await deps.applyResolvedThinkingLevel(input.sessionKey, input.thinking);
+		const prepared = await deps.prepareInboundAttachments(input.sessionKey, input.attachments);
+		const cmd = parseSlashCommand(input.content);
+		if (cmd && commandRegistry.has(cmd.command)) {
+			const { aggregatedText } = await deps.commandHandler.executeCommandAndAggregateReply(cmd.command, cmd.args, {
+				sessionKey: input.sessionKey,
+				channel,
+				chatId,
+				senderId: "",
+				isGroup: false
+			});
+			await deps.persistAgentSessionMessages(input.sessionKey);
+			return aggregatedText;
+		}
+		const userMessage = {
+			role: "user",
+			content: await buildDirectUserMessageContent({
+				content: input.content.trimStart().startsWith("/skill:") ? deps.agentManager.expandSkillUserText(input.content) : input.content,
+				attachments: prepared,
+				sessionKey: input.sessionKey,
+				config: deps.config,
+				agentManager: deps.agentManager,
+				modelManager: deps.modelManager
+			}),
+			timestamp: Date.now()
+		};
+		const userPlain = extractAgentUserPlainText(userMessage);
+		const userMessageForModel = await deps.agentManager.applyMemoryPrefetchToUserMessage(userMessage, input.sessionKey);
+		await runAgentTurnWithModelFallbacks({
+			agent,
+			sessionKey: input.sessionKey,
+			modelManager: deps.modelManager,
+			userMessage: userMessageForModel,
+			log: deps.log,
+			getConfig: () => deps.config,
+			beforeUserPrompt: () => deps.agentManager.beginBackgroundReviewUserTurn(input.sessionKey)
+		});
+		deps.agentManager.afterAgentTurn(input.sessionKey, userPlain);
+		deps.agentManager.scheduleBackgroundReviewAfterUserTurn(input.sessionKey);
+		const response = deps.agentManager.getLastAssistantContent(input.sessionKey) || "";
+		await deps.persistAgentSessionMessages(input.sessionKey);
+		return response;
+	} finally {
+		deps.endDirectRequestContext();
+	}
+}
+//#endregion
+export { runProcessDirect };
+
+//# sourceMappingURL=process-direct-one-shot.js.map

package/dist/src/agent/service/process-direct-one-shot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-direct-one-shot.js","names":[],"sources":["../../../../src/agent/service/process-direct-one-shot.ts"],"sourcesContent":["import type { AgentMessage } from '@mariozechner/pi-agent-core';\n\nimport { parseSlashCommand } from '../../chat-commands/command-parse.js';\nimport { commandRegistry } from '../../chat-commands/index.js';\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport { extractAgentUserPlainText } from '../memory/user-message-text.js';\nimport { runAgentTurnWithModelFallbacks } from '../orchestration/run-agent-turn-with-fallbacks.js';\nimport type { ProcessDirectStreamLog } from './process-direct-streaming.js';\nimport type { AgentManager } from '../agent-manager.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionStore } from '../../session/index.js';\nimport type { Config } from '../../config/schema.js';\nimport { buildDirectUserMessageContent, type DirectInboundAttachment } from './build-direct-message-content.js';\n\nexport type RunProcessDirectDeps = {\n  log: ProcessDirectStreamLog;\n  config: Config;\n  parseSessionKey: (sessionKey: string) => { channel: string; chatId: string };\n  initSessionContext: (sessionKey: string, channel: string, chatId: string) => void;\n  hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;\n  hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;\n  agentManager: AgentManager;\n  sessionStore: SessionStore;\n  prepareLoadedSessionMessages: (sessionKey: string, messages: AgentMessage[]) => AgentMessage[];\n  modelManager: ModelManager;\n  applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: DirectInboundAttachment[],\n  ) => Promise<DirectInboundAttachment[] | undefined>;\n  commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;\n  persistAgentSessionMessages: (sessionKey: string) => Promise<void>;\n  endDirectRequestContext: () => void;\n};\n\nexport async function runProcessDirect(\n  deps: RunProcessDirectDeps,\n  input: {\n    content: string;\n    sessionKey: string;\n    attachments?: DirectInboundAttachment[];\n    thinking?: string;\n  },\n): Promise<string> {\n  const { channel, chatId } = deps.parseSessionKey(input.sessionKey);\n  deps.initSessionContext(input.sessionKey, channel, chatId);\n\n  try {\n    await deps.hydrateSessionWorkspaceFromStore(input.sessionKey);\n    const agent = deps.agentManager.getOrCreateAgent(input.sessionKey);\n\n    await deps.hydrateSessionModelFromStore(input.sessionKey);\n\n    const loaded = await deps.sessionStore.load(input.sessionKey);\n    agent.state.messages = deps.prepareLoadedSessionMessages(input.sessionKey, loaded);\n\n    await deps.modelManager.applyModelForSession(agent, input.sessionKey);\n    await deps.applyResolvedThinkingLevel(input.sessionKey, input.thinking);\n\n    const prepared = await deps.prepareInboundAttachments(input.sessionKey, input.attachments);\n\n    const cmd = parseSlashCommand(input.content);\n    if (cmd && commandRegistry.has(cmd.command)) {\n      const { aggregatedText } = await deps.commandHandler.executeCommandAndAggregateReply(cmd.command, cmd.args, {\n        sessionKey: input.sessionKey,\n        channel,\n        chatId,\n        senderId: '',\n        isGroup: false,\n      });\n      await deps.persistAgentSessionMessages(input.sessionKey);\n      return aggregatedText;\n    }\n\n    const textForDirect = input.content.trimStart().startsWith('/skill:')\n      ? deps.agentManager.expandSkillUserText(input.content)\n      : input.content;\n    const messageContent = await buildDirectUserMessageContent({\n      content: textForDirect,\n      attachments: prepared,\n      sessionKey: input.sessionKey,\n      config: deps.config,\n      agentManager: deps.agentManager,\n      modelManager: deps.modelManager,\n    });\n\n    const userMessage = {\n      role: 'user' as const,\n      content: messageContent,\n      timestamp: Date.now(),\n    };\n    const userPlain = extractAgentUserPlainText(userMessage);\n    const userMessageForModel = await deps.agentManager.applyMemoryPrefetchToUserMessage(\n      userMessage,\n      input.sessionKey,\n    );\n\n    await runAgentTurnWithModelFallbacks({\n      agent,\n      sessionKey: input.sessionKey,\n      modelManager: deps.modelManager,\n      userMessage: userMessageForModel,\n      log: deps.log,\n      getConfig: () => deps.config,\n      beforeUserPrompt: () => deps.agentManager.beginBackgroundReviewUserTurn(input.sessionKey),\n    });\n\n    deps.agentManager.afterAgentTurn(input.sessionKey, userPlain);\n    deps.agentManager.scheduleBackgroundReviewAfterUserTurn(input.sessionKey);\n\n    const response = deps.agentManager.getLastAssistantContent(input.sessionKey) || '';\n    await deps.persistAgentSessionMessages(input.sessionKey);\n\n    return response;\n  } finally {\n    deps.endDirectRequestContext();\n  }\n}\n"],"mappings":";;;;;;;AAmCA,eAAsB,iBACpB,MACA,OAMiB;CACjB,MAAM,EAAE,SAAS,WAAW,KAAK,gBAAgB,MAAM,WAAW;AAClE,MAAK,mBAAmB,MAAM,YAAY,SAAS,OAAO;AAE1D,KAAI;AACF,QAAM,KAAK,iCAAiC,MAAM,WAAW;EAC7D,MAAM,QAAQ,KAAK,aAAa,iBAAiB,MAAM,WAAW;AAElE,QAAM,KAAK,6BAA6B,MAAM,WAAW;EAEzD,MAAM,SAAS,MAAM,KAAK,aAAa,KAAK,MAAM,WAAW;AAC7D,QAAM,MAAM,WAAW,KAAK,6BAA6B,MAAM,YAAY,OAAO;AAElF,QAAM,KAAK,aAAa,qBAAqB,OAAO,MAAM,WAAW;AACrE,QAAM,KAAK,2BAA2B,MAAM,YAAY,MAAM,SAAS;EAEvE,MAAM,WAAW,MAAM,KAAK,0BAA0B,MAAM,YAAY,MAAM,YAAY;EAE1F,MAAM,MAAM,kBAAkB,MAAM,QAAQ;AAC5C,MAAI,OAAO,gBAAgB,IAAI,IAAI,QAAQ,EAAE;GAC3C,MAAM,EAAE,mBAAmB,MAAM,KAAK,eAAe,gCAAgC,IAAI,SAAS,IAAI,MAAM;IAC1G,YAAY,MAAM;IAClB;IACA;IACA,UAAU;IACV,SAAS;IACV,CAAC;AACF,SAAM,KAAK,4BAA4B,MAAM,WAAW;AACxD,UAAO;;EAeT,MAAM,cAAc;GAClB,MAAM;GACN,SAAS,MAXkB,8BAA8B;IACzD,SAJoB,MAAM,QAAQ,WAAW,CAAC,WAAW,UAAU,GACjE,KAAK,aAAa,oBAAoB,MAAM,QAAQ,GACpD,MAAM;IAGR,aAAa;IACb,YAAY,MAAM;IAClB,QAAQ,KAAK;IACb,cAAc,KAAK;IACnB,cAAc,KAAK;IACpB,CAAC;GAKA,WAAW,KAAK,KAAK;GACtB;EACD,MAAM,YAAY,0BAA0B,YAAY;EACxD,MAAM,sBAAsB,MAAM,KAAK,aAAa,iCAClD,aACA,MAAM,WACP;AAED,QAAM,+BAA+B;GACnC;GACA,YAAY,MAAM;GAClB,cAAc,KAAK;GACnB,aAAa;GACb,KAAK,KAAK;GACV,iBAAiB,KAAK;GACtB,wBAAwB,KAAK,aAAa,8BAA8B,MAAM,WAAW;GAC1F,CAAC;AAEF,OAAK,aAAa,eAAe,MAAM,YAAY,UAAU;AAC7D,OAAK,aAAa,sCAAsC,MAAM,WAAW;EAEzE,MAAM,WAAW,KAAK,aAAa,wBAAwB,MAAM,WAAW,IAAI;AAChF,QAAM,KAAK,4BAA4B,MAAM,WAAW;AAExD,SAAO;WACC;AACR,OAAK,yBAAyB"}

package/dist/src/agent/service/process-direct-streaming.js

@@ -1,6 +1,7 @@
 import { extractTextContent, extractThinkingContent, extractThinkingFromAssistantMessage } from "../context/workspace.js";
 import { extractAgentUserPlainText } from "../memory/user-message-text.js";
 import { resolveEffectiveReasoningLevel } from "../../session/thinking-resolve.js";
+import { stripTrailingWebchatEarlySaveUserIfPresent } from "../../session/strip-webchat-early-save.js";
 import "../../session/index.js";
 import { parseSlashCommand } from "../../chat-commands/command-parse.js";
 import { commandRegistry } from "../../chat-commands/registry.js";
@@ -279,7 +280,17 @@ async function* runProcessDirectStreaming(deps, input) {
 				sessionKey
 			}, "Failed to persist webchat slash command receipt");
 		}
-		if (!ranSlashCommand) await persistAgentSessionMessages(sessionKey);
+		if (!ranSlashCommand) {
+			if (userAborted && channel === "webchat") try {
+				await stripTrailingWebchatEarlySaveUserIfPresent(sessionStore, sessionKey);
+			} catch (stripErr) {
+				log.warn({
+					err: stripErr,
+					sessionKey
+				}, "Failed to strip trailing webchat early-save after abort");
+			}
+			await persistAgentSessionMessages(sessionKey);
+		}
 		if (!userAborted) {
 			const ttsAudioEvent = await maybeEmitWebchatTts(sessionKey, inboundVoice);
 			if (ttsAudioEvent) yield ttsAudioEvent;