@geminixiang/mikan 0.5.0-beta.0 → 0.5.0

package/dist/agent-events.js

@@ -0,0 +1,26 @@
+const clients = new Set();
+let nextEventId = 1;
+export function emitAgentEvent(event) {
+    const payload = `id: ${nextEventId++}\nevent: agent\ndata: ${JSON.stringify(event)}\n\n`;
+    for (const client of clients) {
+        client.write(payload);
+    }
+}
+export function addAgentEventStreamClient(res) {
+    clients.add(res);
+    res.writeHead(200, {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache, no-transform",
+        Connection: "keep-alive",
+        "X-Accel-Buffering": "no",
+    });
+    res.write(`: connected\n\n`);
+    const keepAlive = setInterval(() => res.write(`: keepalive\n\n`), 25_000);
+    keepAlive.unref();
+    return () => {
+        clearInterval(keepAlive);
+        clients.delete(res);
+        res.end();
+    };
+}
+//# sourceMappingURL=agent-events.js.map

package/dist/agent-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-events.js","sourceRoot":"","sources":["../src/agent-events.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;AAC1C,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB,MAAM,UAAU,cAAc,CAAC,KAAyB;IACtD,MAAM,OAAO,GAAG,OAAO,WAAW,EAAE,yBAAyB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;IACzF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,GAAmB;IAC3D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,cAAc,EAAE,mBAAmB;QACnC,eAAe,EAAE,wBAAwB;QACzC,UAAU,EAAE,YAAY;QACxB,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAE7B,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1E,SAAS,CAAC,KAAK,EAAE,CAAC;IAElB,OAAO,GAAG,EAAE;QACV,aAAa,CAAC,SAAS,CAAC,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,GAAG,CAAC,GAAG,EAAE,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type { ServerResponse } from \"http\";\nimport type { AgentEventEnvelope } from \"./types.js\";\n\nconst clients = new Set<ServerResponse>();\nlet nextEventId = 1;\n\nexport function emitAgentEvent(event: AgentEventEnvelope): void {\n  const payload = `id: ${nextEventId++}\\nevent: agent\\ndata: ${JSON.stringify(event)}\\n\\n`;\n  for (const client of clients) {\n    client.write(payload);\n  }\n}\n\nexport function addAgentEventStreamClient(res: ServerResponse): () => void {\n  clients.add(res);\n  res.writeHead(200, {\n    \"Content-Type\": \"text/event-stream\",\n    \"Cache-Control\": \"no-cache, no-transform\",\n    Connection: \"keep-alive\",\n    \"X-Accel-Buffering\": \"no\",\n  });\n  res.write(`: connected\\n\\n`);\n\n  const keepAlive = setInterval(() => res.write(`: keepalive\\n\\n`), 25_000);\n  keepAlive.unref();\n\n  return () => {\n    clearInterval(keepAlive);\n    clients.delete(res);\n    res.end();\n  };\n}\n"]}

package/dist/agent.d.ts

@@ -1,21 +1,21 @@
 import { type ImageContent } from "@earendil-works/pi-ai";
-import type { ChatMessage } from "./adapter.js";
+import type { ConversationMessage } from "./adapter.js";
 import type { SessionViewTokenStoreLike } from "./commands/types.js";
 import type { DockerContainerManager } from "./provisioner.js";
 import { type RuntimePathContext, type SandboxConfig } from "./sandbox/index.js";
 import type { VaultManager } from "./vault/index.js";
 import { type ResolvedSessionScope } from "./sessions/store.js";
-export type { AgentRunner } from "./types.js";
-import type { AgentRunner } from "./types.js";
-export declare function resolveTriggerAttribution(message: Pick<ChatMessage, "id" | "text" | "userName">): string | undefined;
+export type { PiAgentWrapper } from "./types.js";
+import type { PiAgentWrapper } from "./types.js";
+export declare function resolveTriggerAttribution(message: Pick<ConversationMessage, "id" | "text" | "userName">): string | undefined;
 export declare function getUnresolvedSandboxPathContext(sandboxConfig: SandboxConfig, hostWorkspaceRoot: string): RuntimePathContext;
-export declare function buildPromptPayload(message: ChatMessage, workspacePath: string, pathContext?: RuntimePathContext): {
+export declare function buildPromptPayload(message: ConversationMessage, workspacePath: string, pathContext?: RuntimePathContext): {
     userMessage: string;
     imageAttachments: ImageContent[];
 };
 export declare function appendTriggerAttribution(text: string, triggerAttribution: string | undefined): string;
 /**
- * Create a new AgentRunner for a channel.
+ * Create a new PiAgentWrapper for a channel.
  * Sets up the session and subscribes to events once.
  *
  * Runner caching is handled by the caller (channelStates in main.ts).
@@ -24,7 +24,7 @@ export declare function appendTriggerAttribution(text: string, triggerAttributio
 export declare function createRunner(sandboxConfig: SandboxConfig, sessionKey: string, conversationId: string, conversationDir: string, workspaceDir: string, sessionScope: ResolvedSessionScope, vaultManager?: VaultManager, provisioner?: DockerContainerManager, sessionView?: {
     tokenStore: SessionViewTokenStoreLike;
     portalBaseUrl?: string;
-}): Promise<AgentRunner>;
+}): Promise<PiAgentWrapper>;
 export declare function translateRuntimePathToHost(runtimePath: string, pathContext: RuntimePathContext): string;
 export declare function translateAttachPathToHost(filePath: string, pathContext: RuntimePathContext): string;
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,YAAY,EAAc,MAAM,uBAAuB,CAAC;AAkBhF,OAAO,KAAK,EACV,WAAW,EAMZ,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAKrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,qBAAqB,CAAC;AAO7B,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAyI9C,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC,GACrD,MAAM,GAAG,SAAS,CAOpB;AA0MD,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,MAAM,GACxB,kBAAkB,CAMpB;AAkTD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,kBAAkB,GAC/B;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,YAAY,EAAE,CAAC;CAClC,CAaA;AA+BD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,MAAM,CAKR;AAomBD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,oBAAoB,EAClC,YAAY,CAAC,EAAE,YAAY,EAC3B,WAAW,CAAC,EAAE,sBAAsB,EACpC,WAAW,CAAC,EAAE;IACZ,UAAU,EAAE,yBAAyB,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,OAAO,CAAC,WAAW,CAAC,CAiNtB;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,kBAAkB,GAC9B,MAAM,CAER;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,kBAAkB,GAC9B,MAAM,CAKR","sourcesContent":["import { Agent, type ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport { type Api, type ImageContent, type Model } from \"@earendil-works/pi-ai\";\nimport {\n  AgentSession,\n  AuthStorage,\n  convertToLlm,\n  DefaultResourceLoader,\n  formatSkillsForPrompt,\n  getAgentDir,\n  loadSkillsFromDir,\n  ModelRegistry,\n  SessionManager,\n  SettingsManager,\n  type Skill,\n} from \"@earendil-works/pi-coding-agent\";\nimport { existsSync, readFileSync } from \"fs\";\nimport { mkdir, readFile, writeFile } from \"fs/promises\";\nimport { homedir } from \"os\";\nimport { join, posix } from \"path\";\nimport type {\n  ChatMessage,\n  ChatResponseContext,\n  ChatToolResult,\n  ConversationKind,\n  PlatformInfo,\n  PlatformName,\n} from \"./adapter.js\";\nimport type { SessionViewTokenStoreLike } from \"./commands/types.js\";\nimport { resolveConversationSettings } from \"./config.js\";\nimport { ActorExecutionResolver } from \"./execution-resolver.js\";\nimport * as log from \"./log.js\";\nimport { reportUserFacingError } from \"./observability/sentry.js\";\nimport type { DockerContainerManager } from \"./provisioner.js\";\nimport {\n  createExecutor,\n  type Executor,\n  type RuntimePathContext,\n  type SandboxConfig,\n} from \"./sandbox/index.js\";\nimport { createMountedRuntimePathContext } from \"./sandbox/path-context.js\";\nimport {\n  addLifecycleBreadcrumb,\n  metricAttributes,\n  updateActiveSpanAttribution,\n} from \"./observability/sentry.js\";\nimport type { VaultManager } from \"./vault/index.js\";\nimport { ChatSessionManager } from \"./sessions/chat-session-manager.js\";\nimport {\n  extractSessionUuid,\n  openManagedSession,\n  type ResolvedSessionScope,\n  type ThreadRootMessage,\n} from \"./sessions/store.js\";\nimport { shouldSurfaceToolDiagnostic } from \"./tool-diagnostics.js\";\nimport { createMikanTools } from \"./tools/index.js\";\nimport * as Sentry from \"@sentry/node\";\nimport { formatLocalTimestamp } from \"./utils/date.js\";\nimport { resolveConfiguredModel } from \"./model-registry.js\";\n\nexport type { AgentRunner } from \"./types.js\";\nimport type { AgentRunner } from \"./types.js\";\n\nconst IMAGE_MIME_TYPES: Record<string, string> = {\n  jpg: \"image/jpeg\",\n  jpeg: \"image/jpeg\",\n  png: \"image/png\",\n  gif: \"image/gif\",\n  webp: \"image/webp\",\n};\n\nfunction getImageMimeType(filename: string): string | undefined {\n  return IMAGE_MIME_TYPES[filename.toLowerCase().split(\".\").pop() || \"\"];\n}\n\nfunction buildThreadSessionName(message: ThreadRootMessage | null): string | undefined {\n  const text = message?.text?.trim();\n  if (!text) return undefined;\n  const userLabel = message?.userName || message?.user || \"unknown\";\n  return `[${userLabel}]: ${text}`;\n}\n\nasync function getMemory(conversationDir: string): Promise<string> {\n  const parts: string[] = [];\n\n  // Read workspace-level memory (shared across all conversations)\n  const workspaceMemoryPath = join(conversationDir, \"..\", \"MEMORY.md\");\n  if (existsSync(workspaceMemoryPath)) {\n    try {\n      const content = (await readFile(workspaceMemoryPath, \"utf-8\")).trim();\n      if (content) {\n        parts.push(`### Global Workspace Memory\\n${content}`);\n      }\n    } catch (error) {\n      log.logWarning(\"Failed to read workspace memory\", `${workspaceMemoryPath}: ${error}`);\n    }\n  }\n\n  // Read conversation-specific memory\n  const conversationMemoryPath = join(conversationDir, \"MEMORY.md\");\n  if (existsSync(conversationMemoryPath)) {\n    try {\n      const content = (await readFile(conversationMemoryPath, \"utf-8\")).trim();\n      if (content) {\n        parts.push(`### Conversation-Specific Memory\\n${content}`);\n      }\n    } catch (error) {\n      log.logWarning(\"Failed to read conversation memory\", `${conversationMemoryPath}: ${error}`);\n    }\n  }\n\n  if (parts.length === 0) {\n    return \"(no working memory yet)\";\n  }\n\n  return parts.join(\"\\n\\n\");\n}\n\nfunction loadMikanSkills(conversationDir: string, workspacePath: string): Skill[] {\n  const skillMap = new Map<string, Skill>();\n\n  // conversationDir is the host path (e.g., /Users/.../data/C0A34FL8PMH)\n  // hostWorkspacePath is the parent directory on host\n  // workspacePath is the container path (e.g., /workspace)\n  const hostWorkspacePath = join(conversationDir, \"..\");\n\n  // Helper to translate host paths to container paths\n  const translatePath = (hostPath: string): string => {\n    if (hostPath.startsWith(hostWorkspacePath)) {\n      return workspacePath + hostPath.slice(hostWorkspacePath.length);\n    }\n    return hostPath;\n  };\n\n  // Load workspace-level skills (global)\n  const workspaceSkillsDir = join(hostWorkspacePath, \"skills\");\n  for (const skill of loadSkillsFromDir({ dir: workspaceSkillsDir, source: \"workspace\" }).skills) {\n    // Translate paths to container paths for system prompt\n    skill.filePath = translatePath(skill.filePath);\n    skill.baseDir = translatePath(skill.baseDir);\n    skillMap.set(skill.name, skill);\n  }\n\n  // Load conversation-specific skills (override workspace skills on collision)\n  const conversationSkillsDir = join(conversationDir, \"skills\");\n  for (const skill of loadSkillsFromDir({ dir: conversationSkillsDir, source: \"channel\" }).skills) {\n    skill.filePath = translatePath(skill.filePath);\n    skill.baseDir = translatePath(skill.baseDir);\n    skillMap.set(skill.name, skill);\n  }\n\n  return Array.from(skillMap.values());\n}\n\nfunction buildRuntimePaths(runtimeWorkspaceRoot: string, conversationId: string) {\n  const workspaceRoot = runtimeWorkspaceRoot.replace(/\\/+$/, \"\") || \"/\";\n  const conversationPath = posix.join(workspaceRoot, conversationId);\n  return {\n    workspaceRoot,\n    conversationPath,\n    scratchPath: posix.join(conversationPath, \"scratch\"),\n  };\n}\n\nfunction buildEnvDescription(sandboxType: SandboxConfig[\"type\"], workspaceRoot: string): string {\n  switch (sandboxType) {\n    case \"image\":\n      return `You are running inside a managed per-user container.\n- Runtime workspace root: ${workspaceRoot}\n- Bash commands start in: ${workspaceRoot}\n- Install tools with the image's package manager\n- Your changes persist for this user's container until it is recreated`;\n    case \"container\":\n      return `You are running inside a shared container.\n- Runtime workspace root: ${workspaceRoot}\n- Bash commands start in: ${workspaceRoot}\n- Install tools with the container's package manager\n- Your changes persist across sessions`;\n    case \"firecracker\":\n      return `You are running inside a Firecracker microVM.\n- Runtime workspace root: ${workspaceRoot}\n- Use cd or absolute paths; project files are under ${workspaceRoot}\n- Install tools with: apt-get install <package> (Debian-based)\n- Your changes persist across sessions`;\n    case \"cloudflare\":\n      return `You are running through a Cloudflare Sandbox bridge.\n- Runtime workspace root: ${workspaceRoot}\n- Bash commands start in: ${workspaceRoot}\n- Your commands run in a remote container managed by Cloudflare\n- Important: the remote filesystem is not automatically synced back to the host workspace`;\n    default:\n      return `You are running directly on the host machine.\n- Runtime workspace root: ${workspaceRoot}\n- Bash commands start in: ${process.cwd()}\n- Be careful with system modifications`;\n  }\n}\n\nexport function resolveTriggerAttribution(\n  message: Pick<ChatMessage, \"id\" | \"text\" | \"userName\">,\n): string | undefined {\n  const eventTextMatch = message.text.match(/^\\[EVENT:([^:]+):/);\n  if (eventTextMatch) return `[event: ${eventTextMatch[1]}]`;\n  const eventIdMatch = message.id.match(/^event:([^:]+)/);\n  if (eventIdMatch) return `[event: ${eventIdMatch[1]}]`;\n  if (message.userName) return `@${message.userName}`;\n  return undefined;\n}\n\nfunction buildSystemPrompt(\n  workspacePath: string,\n  conversationId: string,\n  conversationKind: ConversationKind,\n  currentUserId: string | undefined,\n  memory: string,\n  sandboxConfig: SandboxConfig,\n  platform: PlatformInfo,\n  skills: Skill[],\n  isEventTrigger = false,\n  triggerAttribution?: string,\n): string {\n  const { workspaceRoot, conversationPath, scratchPath } = buildRuntimePaths(\n    workspacePath,\n    conversationId,\n  );\n  const sandboxType = sandboxConfig.type;\n  const isContainerLike = sandboxType === \"container\" || sandboxType === \"image\";\n  const isFirecracker = sandboxType === \"firecracker\";\n\n  // Format channel mappings\n  const channelMappings =\n    platform.channels.length > 0\n      ? platform.channels.map((c) => `${c.id}\\t#${c.name}`).join(\"\\n\")\n      : \"(no channels loaded)\";\n\n  // Format user mappings\n  const userMappings =\n    platform.users.length > 0\n      ? platform.users.map((u) => `${u.id}\\t@${u.userName}\\t${u.displayName}`).join(\"\\n\")\n      : \"(no users loaded)\";\n\n  const envDescription = buildEnvDescription(sandboxType, workspaceRoot);\n  const eventTriggerInstructions = isEventTrigger\n    ? `\n## Event Trigger Mode\n- You are handling a scheduled/background event, not opening a brand new chat with a stranger.\n- Treat the incoming user message as a self-contained task prepared by an earlier run.\n- Complete the task directly. Avoid generic greetings, self-introductions, or boilerplate offers to help.\n- For reminders/follow-ups, prefer a short direct response that sounds like a continuation of prior intent.\n- If the event text includes tone, brevity, or language instructions, follow them literally.\n`\n    : \"\";\n  const attributionInstructions = triggerAttribution\n    ? `\n## Attribution\nAlways end your final ${platform.name} response and any GitHub issue/PR comments or descriptions you write via tools with:\n_Triggered by ${triggerAttribution}_\n\nDo not add this to \\`[SILENT]\\` responses.\n`\n    : \"\";\n  const slackBlockKitInstructions =\n    platform.name === \"slack\"\n      ? `\n## Slack Block Kit\n- On Slack, use the \\`slack_blockkit\\` tool when a response benefits from interaction or structured presentation.\n- Good uses: choices, confirmations, clarifying questions, quizzes, status reports, comparisons, summaries, and step lists.\n- Do not use it for normal short replies or simple factual answers.\n- Supported blocks: section, context, divider, header, actions.\n- Put buttons in actions.elements. Put static_select and multi_static_select in section.accessory.\n- Every interactive element must include action_id. Buttons must include value.\n- Always provide a plain-text fallback in text that matches the visible Block Kit content.\n- When using \\`slack_blockkit\\`, do not also send a normal text response in the same assistant turn; put the fallback in the tool's text field.\n`\n      : \"\";\n\n  return `You are mikan, a ${platform.name} bot assistant. Be concise. No emojis.\n\n## Context\n- For current date/time, use: date\n- You have access to previous conversation context including tool results from prior turns.\n- For older human-readable history beyond your context, search \\`log.jsonl\\` (contains user messages and your final responses, but not tool results).\n- Structured session history with tool results lives in \\`${conversationPath}/sessions/\\`.\n- The active top-level session is selected by \\`${conversationPath}/sessions/current\\`, which points to a timestamped \\`.jsonl\\` file in the same directory.\n- Scoped/thread sessions use fixed files at \\`${conversationPath}/sessions/<scope_id>.jsonl\\` (for example \\`${conversationPath}/sessions/1777386320.800769.jsonl\\`).\n- If a user asks about something that should exist in conversation history but is not found in the current context window, do not answer \"I don't know\" or \"I don't have that\". Instead, search the thread session, top-level session, and \\`log.jsonl\\` before responding.\n- User messages include a \\`[in-thread:TS]\\` marker when sent from within a platform thread/reply (TS is the thread or parent message identifier). Without this marker, the message is a top-level conversation message.\n${eventTriggerInstructions}\n${platform.formattingGuide}${slackBlockKitInstructions}\n\n## Platform IDs\nChannels: ${channelMappings}\n\nUsers: ${userMappings}\n\nWhen mentioning users, use <@username> format (e.g., <@mario>).\n\n## Environment\n${envDescription}\n- Default place for clones, downloads, and experiments: ${scratchPath}\n- Do not use host-only paths unless you are running in host mode and verified they exist.\n\n## Workspace Layout\n${workspaceRoot}/\n├── MEMORY.md                    # Global memory (all conversations)\n├── skills/                      # Global CLI tools you create\n└── ${conversationId}/           # This conversation\n    ├── MEMORY.md                # Conversation-specific memory\n    ├── log.jsonl                # Human-readable message history (no tool results)\n    ├── sessions/                # Structured session history used for context reconstruction\n    │   ├── current              # Active top-level session pointer\n    │   ├── <timestamp>_<id>.jsonl  # Top-level session files\n    │   └── <scope_id>.jsonl        # Scoped thread/reply session files\n    ├── attachments/             # User-shared files\n    ├── scratch/                 # Working directory for clones/downloads/experiments: ${scratchPath}\n    └── skills/                  # Conversation-specific tools\n\n## Skills (Custom CLI Tools)\nYou can create reusable CLI tools for recurring tasks (email, APIs, data processing, etc.).\n\n### Creating Skills\nStore in \\`${workspaceRoot}/skills/<name>/\\` (global) or \\`${conversationPath}/skills/<name>/\\` (conversation-specific).\nEach skill directory needs a \\`SKILL.md\\` with YAML frontmatter:\n\n\\`\\`\\`markdown\n---\nname: skill-name\ndescription: Short description of what this skill does\n---\n\n# Skill Name\n\nUsage instructions, examples, etc.\nScripts are in: {baseDir}/\n\\`\\`\\`\n\n\\`name\\` and \\`description\\` are required. Use \\`{baseDir}\\` as placeholder for the skill's directory path.\n\n### Available Skills\n${skills.length > 0 ? formatSkillsForPrompt(skills) : \"(no skills installed yet)\"}\n\n## Events\nUse the \\`event\\` tool to schedule immediate, one-shot, or periodic follow-ups. It writes to the host-side mikan control plane and fills routing fields for the current conversation automatically.\n\nWrite event \\`text\\` as a self-contained future task with needed context, tone, and constraints because events do not inherit normal conversation history.\n\nFor one-shot reminders, include a timezone offset in \\`at\\`. For periodic events, use a cron schedule plus IANA timezone; assume ${Intl.DateTimeFormat().resolvedOptions().timeZone} when users omit timezone.\n\nWhen events trigger, messages are prefixed like \\`[EVENT:filename:type:time]\\`. Immediate and one-shot events auto-delete after triggering; periodic events persist until deleted.\n\nFor periodic events where there's nothing to report, respond with exactly \\`[SILENT]\\`. Debounce external triggers; prefer one summarized event over many.\n\n## Memory\nWrite to MEMORY.md files to persist context across conversations.\n- Global (${workspaceRoot}/MEMORY.md): skills, preferences, project info\n- Conversation (${conversationPath}/MEMORY.md): conversation-specific decisions, ongoing work\nUpdate when you learn something important or when asked to remember something.\n\n### Current Memory\n${memory}\n\n## System Configuration Log\nMaintain ${workspaceRoot}/SYSTEM.md to log all environment modifications:\n- Installed packages (apt install, npm install, uv pip install)\n- Environment variables set\n- Config files modified (~/.gitconfig, cron jobs, etc.)\n- Skill dependencies installed\n\nUpdate this file whenever you modify the environment. On fresh container, read it first to restore your setup.\n\n## Log Queries (for older history)\nFormat: \\`{\"date\":\"...\",\"ts\":\"...\",\"user\":\"...\",\"userName\":\"...\",\"text\":\"...\",\"isBot\":false}\\`\nThe log contains user messages and your final responses (not tool calls/results).\nUse \\`log.jsonl\\` for quick grep-style history. Use \\`${conversationPath}/sessions/\\` when you need structured turns, tool outputs, or thread/session lineage.\n${isContainerLike || isFirecracker ? \"Install jq: apt-get install jq\" : \"\"}\n${attributionInstructions}\n\\`\\`\\`bash\n# Recent messages\ntail -30 log.jsonl | jq -c '{date: .date[0:19], user: (.userName // .user), text}'\n\n# Search for specific topic\ngrep -i \"topic\" log.jsonl | jq -c '{date: .date[0:19], user: (.userName // .user), text}'\n\n# Messages from specific user\ngrep '\"userName\":\"mario\"' log.jsonl | tail -20 | jq -c '{date: .date[0:19], text}'\n\n# Inspect top-level session pointer and available session files\ncat sessions/current\nls -1 sessions/\n\\`\\`\\`\n\n## Tools\n- bash: Run shell commands (primary tool). Install packages as needed.\n- read: Read files\n- write: Create/overwrite files\n- edit: Surgical file edits\n- event: Schedule immediate, one-shot, or periodic follow-ups\n- sandbox: Inspect or temporarily adjust sandbox limits\n- attach: Share files to the platform\n\nEach tool requires a \"label\" parameter (shown to user).\n`;\n}\n\nfunction truncate(text: string, maxLen: number): string {\n  if (text.length <= maxLen) return text;\n  return `${text.substring(0, maxLen - 3)}...`;\n}\n\nexport function getUnresolvedSandboxPathContext(\n  sandboxConfig: SandboxConfig,\n  hostWorkspaceRoot: string,\n): RuntimePathContext {\n  if (sandboxConfig.type === \"image\") {\n    return createMountedRuntimePathContext(hostWorkspaceRoot, \"/workspace\");\n  }\n\n  return createExecutor(sandboxConfig).getPathContext(hostWorkspaceRoot);\n}\n\ninterface RunnerExecutionContext {\n  executionResolver?: ActorExecutionResolver;\n  executor: Executor;\n  getPathContext: () => RuntimePathContext;\n  resolveExecutorForRun(context: {\n    platform: string;\n    userId: string;\n    conversationId: string;\n  }): Promise<void>;\n}\n\ninterface RunnerSessionState {\n  responseCtx: ChatResponseContext | null;\n  logCtx: {\n    conversationId: string;\n    userName?: string;\n    conversationName?: string;\n    sessionId?: string;\n  } | null;\n  queue: {\n    enqueue(fn: () => Promise<void>, errorContext: string): void;\n  } | null;\n  pendingTools: Map<string, { toolName: string; args: unknown; startTime: number }>;\n  totalUsage: {\n    input: number;\n    output: number;\n    cacheRead: number;\n    cacheWrite: number;\n    cost: { input: number; output: number; cacheRead: number; cacheWrite: number; total: number };\n  };\n  llmCallCount: number;\n  stopReason: string;\n  errorMessage: string | undefined;\n  reportedLlmError: boolean;\n  finalResponseHandledByTool: boolean;\n  triggerAttribution?: string;\n}\n\ninterface PreparedRunContext {\n  sessionConversation: string;\n  runQueue: ReturnType<typeof createRunQueue>;\n  userMessage: string;\n  imageAttachments: ImageContent[];\n  triggerAttribution?: string;\n}\n\ninterface ConfiguredAgentSession {\n  agent: Agent;\n  session: AgentSession;\n}\n\nfunction createRunnerExecutionContext(\n  sandboxConfig: SandboxConfig,\n  vaultManager: VaultManager | undefined,\n  provisioner: DockerContainerManager | undefined,\n  workspaceDir: string,\n  hostWorkspacePath: string,\n): RunnerExecutionContext {\n  const executionResolver =\n    vaultManager &&\n    sandboxConfig.type !== \"host\" &&\n    (vaultManager.isEnabled() ||\n      sandboxConfig.type === \"container\" ||\n      sandboxConfig.type === \"image\" ||\n      sandboxConfig.type === \"cloudflare\" ||\n      sandboxConfig.type === \"firecracker\")\n      ? new ActorExecutionResolver(sandboxConfig, vaultManager, provisioner, workspaceDir)\n      : undefined;\n\n  // activeExecutor is replaced at the start of each run() call when executionResolver\n  // is present, so the stable `executor` wrapper always delegates to the latest resolved value.\n  let activeExecutor: Executor =\n    executionResolver !== undefined\n      ? createExecutor({ type: \"host\" })\n      : createExecutor(sandboxConfig);\n  const executor: Executor = {\n    exec(command, options) {\n      return activeExecutor.exec(command, options);\n    },\n    getWorkspacePath(hostPath) {\n      return activeExecutor.getWorkspacePath(hostPath);\n    },\n    getSandboxConfig() {\n      return activeExecutor.getSandboxConfig();\n    },\n    getPathContext(hostWorkspaceRoot) {\n      return activeExecutor.getPathContext(hostWorkspaceRoot);\n    },\n  };\n\n  return {\n    executionResolver,\n    executor,\n    getPathContext: () => executor.getPathContext(hostWorkspacePath),\n    async resolveExecutorForRun(context): Promise<void> {\n      if (!executionResolver) return;\n      activeExecutor = await executionResolver.resolve(context);\n    },\n  };\n}\n\nasync function createConfiguredAgentSession(params: {\n  conversationId: string;\n  workspaceDir: string;\n  runtimeWorkspaceRoot: string;\n  systemPrompt: string;\n  model: Model<Api>;\n  thinkingLevel: ThinkingLevel;\n  tools: Awaited<ReturnType<typeof createMikanTools>>[\"tools\"];\n  sessionManager: SessionManager;\n  settingsManager: SettingsManager;\n  modelRegistry: ModelRegistry;\n}): Promise<ConfiguredAgentSession> {\n  const {\n    conversationId,\n    workspaceDir,\n    runtimeWorkspaceRoot,\n    systemPrompt,\n    model,\n    thinkingLevel,\n    tools,\n    sessionManager,\n    settingsManager,\n    modelRegistry,\n  } = params;\n  const agent = new Agent({\n    initialState: {\n      systemPrompt,\n      model,\n      thinkingLevel,\n      tools,\n    },\n    convertToLlm,\n    getApiKey: async (provider) => {\n      const key = await modelRegistry.getApiKeyForProvider(provider);\n      if (!key) {\n        throw new Error(\n          `No API key for provider \"${provider}\". Set the appropriate environment variable or configure via auth.json`,\n        );\n      }\n      return key;\n    },\n  });\n\n  const loadedSession = sessionManager.buildSessionContext();\n  if (loadedSession.messages.length > 0) {\n    agent.state.messages = loadedSession.messages;\n    log.logInfo(\n      `[${conversationId}] Reloaded ${loadedSession.messages.length} messages from session context`,\n    );\n  }\n\n  const resourceLoader = new DefaultResourceLoader({\n    cwd: workspaceDir,\n    agentDir: getAgentDir(),\n    systemPrompt,\n  });\n  try {\n    await resourceLoader.reload();\n    const extResult = resourceLoader.getExtensions();\n    if (extResult.errors.length > 0) {\n      for (const err of extResult.errors) {\n        log.logWarning(`[${conversationId}] Extension load error: ${err.path}`, err.error);\n      }\n    }\n    log.logInfo(\n      `[${conversationId}] Loaded ${extResult.extensions.length} extension(s): ${extResult.extensions.map((extension) => extension.path).join(\", \")}`,\n    );\n  } catch (error) {\n    log.logWarning(`[${conversationId}] Failed to load resources`, String(error));\n  }\n\n  const baseToolsOverride = Object.fromEntries(tools.map((tool) => [tool.name, tool]));\n  const session = new AgentSession({\n    agent,\n    sessionManager,\n    settingsManager,\n    cwd: runtimeWorkspaceRoot,\n    modelRegistry,\n    resourceLoader,\n    baseToolsOverride,\n  });\n  return { agent, session };\n}\n\nfunction createEmptyUsageTotals() {\n  return {\n    input: 0,\n    output: 0,\n    cacheRead: 0,\n    cacheWrite: 0,\n    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n  };\n}\n\nfunction createRunState(): RunnerSessionState {\n  return {\n    responseCtx: null,\n    logCtx: null,\n    queue: null,\n    pendingTools: new Map<string, { toolName: string; args: unknown; startTime: number }>(),\n    totalUsage: createEmptyUsageTotals(),\n    llmCallCount: 0,\n    stopReason: \"stop\",\n    errorMessage: undefined,\n    reportedLlmError: false,\n    finalResponseHandledByTool: false,\n    triggerAttribution: undefined,\n  };\n}\n\nfunction resetRunState(\n  runState: RunnerSessionState,\n  responseCtx: ChatResponseContext,\n  sessionConversation: string,\n  userName: string | undefined,\n  sessionUuid: string,\n  triggerAttribution: string | undefined,\n): void {\n  runState.responseCtx = responseCtx;\n  runState.logCtx = {\n    conversationId: sessionConversation,\n    userName,\n    conversationName: undefined,\n    sessionId: sessionUuid,\n  };\n  runState.pendingTools.clear();\n  runState.totalUsage = createEmptyUsageTotals();\n  runState.llmCallCount = 0;\n  runState.stopReason = \"stop\";\n  runState.errorMessage = undefined;\n  runState.reportedLlmError = false;\n  runState.finalResponseHandledByTool = false;\n  runState.triggerAttribution = triggerAttribution;\n}\n\nfunction createRunQueue(\n  responseCtx: ChatResponseContext,\n  runState: RunnerSessionState,\n): {\n  queue: { enqueue(fn: () => Promise<void>, errorContext: string): void };\n  wait: () => Promise<void>;\n} {\n  let queueChain = Promise.resolve();\n  return {\n    queue: {\n      enqueue(fn: () => Promise<void>, errorContext: string): void {\n        queueChain = queueChain.then(async () => {\n          if (runState.finalResponseHandledByTool) return;\n          try {\n            await fn();\n          } catch (err) {\n            const errMsg = err instanceof Error ? err.message : String(err);\n            log.logWarning(`API error (${errorContext})`, errMsg);\n            try {\n              await responseCtx.respondDiagnostic(`Error: ${errMsg}`, { style: \"error\" });\n            } catch {\n              // Ignore\n            }\n          }\n        });\n      },\n    },\n    wait: () => queueChain,\n  };\n}\n\nfunction formatTimestampedUserMessage(message: ChatMessage): string {\n  const timestamp = formatLocalTimestamp(new Date())!;\n  const threadContext = message.threadTs ? ` [in-thread:${message.threadTs}]` : \"\";\n  return `[${timestamp}] [${message.userName || \"unknown\"}]${threadContext}: ${message.text}`;\n}\n\nfunction collectMessageAttachments(\n  message: ChatMessage,\n  workspacePath: string,\n  pathContext?: RuntimePathContext,\n): { imageAttachments: ImageContent[]; nonImagePaths: string[] } {\n  const imageAttachments: ImageContent[] = [];\n  const nonImagePaths: string[] = [];\n\n  for (const attachment of message.attachments || []) {\n    const runtimePath = `${workspacePath}/${attachment.localPath}`;\n    const hostPath = pathContext?.runtimeToHostPath?.(runtimePath) ?? runtimePath;\n    const mimeType = getImageMimeType(attachment.localPath);\n\n    if (mimeType && existsSync(hostPath)) {\n      try {\n        imageAttachments.push({\n          type: \"image\",\n          mimeType,\n          data: readFileSync(hostPath).toString(\"base64\"),\n        });\n      } catch {\n        nonImagePaths.push(runtimePath);\n      }\n    } else {\n      nonImagePaths.push(runtimePath);\n    }\n  }\n\n  return { imageAttachments, nonImagePaths };\n}\n\nexport function buildPromptPayload(\n  message: ChatMessage,\n  workspacePath: string,\n  pathContext?: RuntimePathContext,\n): {\n  userMessage: string;\n  imageAttachments: ImageContent[];\n} {\n  let userMessage = formatTimestampedUserMessage(message);\n  const { imageAttachments, nonImagePaths } = collectMessageAttachments(\n    message,\n    workspacePath,\n    pathContext,\n  );\n\n  if (nonImagePaths.length > 0) {\n    userMessage += `\\n\\n<slack_attachments>\\n${nonImagePaths.join(\"\\n\")}\\n</slack_attachments>`;\n  }\n\n  return { userMessage, imageAttachments };\n}\n\nasync function writePromptDebugContext(\n  conversationDir: string,\n  systemPrompt: string,\n  session: AgentSession,\n  userMessage: string,\n  imageAttachmentCount: number,\n): Promise<void> {\n  const debugContext = {\n    systemPrompt,\n    messages: session.messages,\n    newUserMessage: userMessage,\n    imageAttachmentCount,\n  };\n  await writeFile(\n    join(conversationDir, \"last_prompt.jsonl\"),\n    JSON.stringify(debugContext, null, 2),\n  );\n}\n\nfunction getFinalAssistantText(session: AgentSession): string {\n  const lastAssistant = session.messages.findLast((message) => message.role === \"assistant\");\n  return (\n    lastAssistant?.content\n      .filter((content): content is { type: \"text\"; text: string } => content.type === \"text\")\n      .map((content) => content.text)\n      .join(\"\\n\") || \"\"\n  );\n}\n\nexport function appendTriggerAttribution(\n  text: string,\n  triggerAttribution: string | undefined,\n): string {\n  if (!triggerAttribution) return text;\n  const suffix = `_Triggered by ${triggerAttribution}_`;\n  if (text.trimEnd().endsWith(suffix)) return text;\n  return `${text.trimEnd()}\\n\\n${suffix}`;\n}\n\nasync function finalizeRunResponse(\n  responseCtx: ChatResponseContext,\n  session: AgentSession,\n  runState: RunnerSessionState,\n  options?: {\n    triggerAttribution?: string;\n    createOverflowLink?: () => string;\n    platform?: string;\n    model?: Model<Api>;\n    sessionConversation?: string;\n    sessionUuid?: string;\n  },\n): Promise<void> {\n  if (runState.stopReason === \"error\" && runState.errorMessage) {\n    if (!runState.reportedLlmError) {\n      runState.reportedLlmError = true;\n      reportUserFacingError(new Error(\"LLM run completed with error stop reason\"), {\n        domain: \"llm\",\n        surface: \"assistant_response\",\n        operation: \"llm_turn\",\n        severity: \"error\",\n        platform: options?.platform,\n        provider: options?.model?.provider,\n        model: options?.model?.name,\n        stopReason: runState.stopReason,\n        context: {\n          sessionConversation: options?.sessionConversation,\n          sessionUuid: options?.sessionUuid,\n          hasErrorMessage: true,\n          llmCallCount: runState.llmCallCount,\n        },\n      });\n    }\n    try {\n      await responseCtx.replaceResponse(\"_Sorry, something went wrong_\");\n      await responseCtx.respondDiagnostic(`Error: ${runState.errorMessage}`, {\n        style: \"error\",\n      });\n    } catch (err) {\n      const errMsg = err instanceof Error ? err.message : String(err);\n      log.logWarning(\"Failed to post error message\", errMsg);\n      reportUserFacingError(err, {\n        domain: \"chat_platform\",\n        surface: \"final_response\",\n        operation: \"finalize_error_response\",\n        severity: \"error\",\n        platform: options?.platform,\n        context: {\n          sessionConversation: options?.sessionConversation,\n          sessionUuid: options?.sessionUuid,\n          stopReason: runState.stopReason,\n        },\n      });\n    }\n    return;\n  }\n\n  const finalText = getFinalAssistantText(session);\n  if (runState.finalResponseHandledByTool) {\n    log.logInfo(\"Final response already handled by tool - skipping final replacement\");\n    return;\n  }\n  if (finalText.trim() === \"[SILENT]\" || finalText.trim().startsWith(\"[SILENT]\")) {\n    try {\n      await responseCtx.deleteResponse();\n      log.logInfo(\"Silent response - deleted message and thread\");\n    } catch (err) {\n      const errMsg = err instanceof Error ? err.message : String(err);\n      log.logWarning(\"Failed to delete message for silent response\", errMsg);\n    }\n    return;\n  }\n\n  if (!finalText.trim()) return;\n\n  try {\n    await responseCtx.replaceResponse(\n      appendTriggerAttribution(finalText, options?.triggerAttribution),\n      { createOverflowLink: options?.createOverflowLink },\n    );\n  } catch (err) {\n    const errMsg = err instanceof Error ? err.message : String(err);\n    log.logWarning(\"Failed to replace message with final text\", errMsg);\n    reportUserFacingError(err, {\n      domain: \"chat_platform\",\n      surface: \"final_response\",\n      operation: \"replace_final_response\",\n      severity: \"error\",\n      platform: options?.platform,\n      context: {\n        sessionConversation: options?.sessionConversation,\n        sessionUuid: options?.sessionUuid,\n        finalTextLength: finalText.length,\n      },\n    });\n  }\n}\n\ninterface UsageReportContext {\n  session: AgentSession;\n  runState: RunnerSessionState;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n  model: Model<Api>;\n  agentConfig: ReturnType<typeof resolveConversationSettings>;\n  sessionConversation: string;\n  sessionUuid: string;\n  waitForQueue: () => Promise<void>;\n}\n\nasync function reportUsageSummary(ctx: UsageReportContext): Promise<void> {\n  const {\n    session,\n    runState,\n    responseCtx,\n    platform,\n    model,\n    agentConfig,\n    sessionConversation,\n    sessionUuid,\n    waitForQueue,\n  } = ctx;\n  if (runState.totalUsage.cost.total <= 0) return;\n\n  const lastAssistantMessage = session.messages\n    .slice()\n    .toReversed()\n    .find(\n      (message): message is Extract<typeof message, { role: \"assistant\" }> =>\n        message.role === \"assistant\" && message.stopReason !== \"aborted\",\n    );\n\n  const contextTokens = lastAssistantMessage\n    ? lastAssistantMessage.usage.input +\n      lastAssistantMessage.usage.output +\n      lastAssistantMessage.usage.cacheRead +\n      lastAssistantMessage.usage.cacheWrite\n    : 0;\n  const contextWindow = model.contextWindow || 200000;\n\n  const { totalUsage } = runState;\n  const runMetricAttributes = metricAttributes({\n    provider: model.provider,\n    model: agentConfig.model,\n    channel_id: sessionConversation,\n    session_id: sessionUuid,\n    stop_reason: runState.stopReason,\n    llm_calls: runState.llmCallCount,\n  });\n  Sentry.metrics.distribution(\"agent.run.tokens_in\", totalUsage.input, {\n    attributes: runMetricAttributes,\n  });\n  Sentry.metrics.distribution(\"agent.run.tokens_out\", totalUsage.output, {\n    attributes: runMetricAttributes,\n  });\n  Sentry.metrics.distribution(\"agent.run.cache_read\", totalUsage.cacheRead, {\n    attributes: runMetricAttributes,\n  });\n  Sentry.metrics.distribution(\"agent.run.cache_write\", totalUsage.cacheWrite, {\n    attributes: runMetricAttributes,\n  });\n  Sentry.metrics.distribution(\"agent.run.cost\", totalUsage.cost.total, {\n    attributes: runMetricAttributes,\n  });\n  Sentry.metrics.gauge(\"agent.context.utilization\", contextTokens / contextWindow, {\n    unit: \"ratio\",\n    attributes: runMetricAttributes,\n  });\n\n  const summary = log.logUsageSummary(\n    runState.logCtx!,\n    runState.totalUsage,\n    contextTokens,\n    contextWindow,\n  );\n  if (platform.diagnostics?.showUsageSummary === true) {\n    runState.queue!.enqueue(\n      () => responseCtx.respondDiagnostic(summary, { style: \"muted\" }),\n      \"usage summary\",\n    );\n    await waitForQueue();\n  }\n}\n\nfunction reloadSessionMessages(\n  sessionManager: SessionManager,\n  conversationId: string,\n  agent: Agent,\n): void {\n  const messages = sessionManager.buildSessionContext().messages;\n  if (messages.length > 0) {\n    agent.state.messages = messages;\n    log.logInfo(`[${conversationId}] Reloaded ${messages.length} messages from context`);\n  }\n}\n\nasync function prepareRunContext(params: {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n  conversationId: string;\n  conversationDir: string;\n  sessionUuid: string;\n  runState: RunnerSessionState;\n  executor: Executor;\n  executionResolver?: ActorExecutionResolver;\n  resolveExecutorForRun: RunnerExecutionContext[\"resolveExecutorForRun\"];\n  getPathContext: () => RuntimePathContext;\n  sessionManager: SessionManager;\n  session: AgentSession;\n  agent: Agent;\n  setEventContext: (context: {\n    platform: string;\n    conversationId: string;\n    conversationKind: ConversationKind;\n    userId: string;\n  }) => void;\n  setSandboxContext: (context: { conversationId: string; userId: string }) => void;\n  setUploadFunction: (fn: (filePath: string, title?: string) => Promise<void>) => void;\n  setBlockKitResponseFunction: (\n    fn: (response: import(\"./adapter.js\").ChatResponseBlockKit) => Promise<void>,\n  ) => void;\n  pathContext: RuntimePathContext;\n}): Promise<PreparedRunContext & { pathContext: RuntimePathContext }> {\n  const {\n    message,\n    responseCtx,\n    platform,\n    conversationId,\n    conversationDir,\n    sessionUuid,\n    runState,\n    executor,\n    executionResolver,\n    resolveExecutorForRun,\n    getPathContext,\n    sessionManager,\n    session,\n    agent,\n    setEventContext,\n    setSandboxContext,\n    setUploadFunction,\n    setBlockKitResponseFunction,\n  } = params;\n  let pathContext = params.pathContext;\n  const sessionConversation = message.sessionKey.split(\":\")[0];\n\n  await mkdir(join(conversationDir, \"scratch\"), { recursive: true });\n\n  if (executionResolver) {\n    await resolveExecutorForRun({\n      platform: platform.name,\n      userId: message.userId,\n      conversationId,\n    });\n    pathContext = getPathContext();\n  }\n\n  reloadSessionMessages(sessionManager, conversationId, agent);\n\n  const memory = await getMemory(conversationDir);\n  const skills = loadMikanSkills(conversationDir, pathContext.runtimeWorkspaceRoot);\n  const triggerAttribution = resolveTriggerAttribution(message);\n  const systemPrompt = buildSystemPrompt(\n    pathContext.runtimeWorkspaceRoot,\n    conversationId,\n    message.conversationKind,\n    message.userId,\n    memory,\n    executor.getSandboxConfig(),\n    platform,\n    skills,\n    message.id.startsWith(\"event:\"),\n    triggerAttribution,\n  );\n  session.agent.state.systemPrompt = systemPrompt;\n\n  setEventContext({\n    platform: platform.name,\n    conversationId,\n    conversationKind: message.conversationKind,\n    userId: message.userId,\n  });\n  setSandboxContext({ conversationId, userId: message.userId });\n\n  setUploadFunction(async (filePath: string, title?: string) => {\n    const hostPath = translateAttachPathToHost(filePath, pathContext);\n    await responseCtx.uploadFile(hostPath, title);\n  });\n  setBlockKitResponseFunction(async (response) => {\n    if (platform.name === \"slack\" && responseCtx.respondBlockKit) {\n      await responseCtx.respondBlockKit(response);\n    } else {\n      await responseCtx.replaceResponse(response.text);\n    }\n    runState.finalResponseHandledByTool = true;\n  });\n\n  resetRunState(\n    runState,\n    responseCtx,\n    sessionConversation,\n    message.userName,\n    sessionUuid,\n    triggerAttribution,\n  );\n  const runQueue = createRunQueue(responseCtx, runState);\n  runState.queue = runQueue.queue;\n\n  log.logInfo(\n    `Context sizes - system: ${systemPrompt.length} chars, memory: ${memory.length} chars`,\n  );\n  log.logInfo(`Channels: ${platform.channels.length}, Users: ${platform.users.length}`);\n\n  const { userMessage, imageAttachments } = buildPromptPayload(\n    message,\n    pathContext.runtimeWorkspaceRoot,\n    pathContext,\n  );\n  await writePromptDebugContext(\n    conversationDir,\n    systemPrompt,\n    session,\n    userMessage,\n    imageAttachments.length,\n  );\n\n  return {\n    sessionConversation,\n    runQueue,\n    userMessage,\n    imageAttachments,\n    triggerAttribution,\n    pathContext,\n  };\n}\n\nfunction attachSessionEventHandlers(params: {\n  session: AgentSession;\n  runState: RunnerSessionState;\n  model: Model<Api>;\n  agentConfig: ReturnType<typeof resolveConversationSettings>;\n}): void {\n  const { session, runState, model, agentConfig } = params;\n  session.subscribe(async (event) => {\n    if (!runState.responseCtx || !runState.logCtx || !runState.queue) return;\n\n    const { responseCtx, logCtx, queue, pendingTools } = runState;\n    const baseAttrs = { channel_id: logCtx.conversationId, session_id: logCtx.sessionId };\n\n    if (event.type === \"tool_execution_start\") {\n      const args = (event.args ?? {}) as { label?: string };\n      const label = args.label || event.toolName;\n\n      pendingTools.set(event.toolCallId, {\n        toolName: event.toolName,\n        args: event.args,\n        startTime: Date.now(),\n      });\n      addLifecycleBreadcrumb(\"agent.tool.started\", {\n        tool: event.toolName,\n        ...baseAttrs,\n      });\n\n      log.logToolStart(logCtx, event.toolName, label, event.args as Record<string, unknown>);\n      return;\n    }\n\n    if (event.type === \"tool_execution_end\") {\n      const resultStr = extractToolResultText(event.result);\n      const pending = pendingTools.get(event.toolCallId);\n      pendingTools.delete(event.toolCallId);\n      const durationMs = pending ? Date.now() - pending.startTime : 0;\n\n      Sentry.metrics.count(\"agent.tool.calls\", 1, {\n        attributes: metricAttributes({\n          tool: event.toolName,\n          error: String(event.isError),\n          ...baseAttrs,\n        }),\n      });\n      Sentry.metrics.distribution(\"agent.tool.duration\", durationMs, {\n        unit: \"millisecond\",\n        attributes: metricAttributes({\n          tool: event.toolName,\n          ...baseAttrs,\n        }),\n      });\n      addLifecycleBreadcrumb(\"agent.tool.completed\", {\n        tool: event.toolName,\n        error: event.isError,\n        duration_ms: durationMs,\n        ...baseAttrs,\n      });\n\n      if (event.isError) {\n        log.logToolError(logCtx, event.toolName, durationMs, resultStr);\n      } else {\n        log.logToolSuccess(logCtx, event.toolName, durationMs, resultStr);\n      }\n\n      if (shouldSurfaceToolDiagnostic(event.toolName)) {\n        const toolResult: ChatToolResult = {\n          toolName: event.toolName,\n          label: pending?.args ? (pending.args as { label?: string }).label : undefined,\n          args: pending?.args as Record<string, unknown> | undefined,\n          result: truncate(resultStr, TOOL_RESULT_DIAGNOSTIC_CAP),\n          isError: event.isError,\n          durationMs,\n        };\n        queue.enqueue(() => responseCtx.respondToolResult(toolResult), \"tool result diagnostic\");\n      }\n\n      if (event.isError && shouldSurfaceToolDiagnostic(event.toolName)) {\n        queue.enqueue(\n          () => responseCtx.respond(`_Error: ${truncate(resultStr, 200)}_`),\n          \"tool error\",\n        );\n      }\n      return;\n    }\n\n    if (event.type === \"message_start\") {\n      if (event.message.role === \"assistant\") {\n        runState.llmCallCount += 1;\n        addLifecycleBreadcrumb(\"agent.llm.call.started\", {\n          call_index: runState.llmCallCount,\n          provider: model.provider,\n          model: agentConfig.model,\n          ...baseAttrs,\n        });\n        log.logResponseStart(logCtx);\n      }\n      return;\n    }\n\n    if (event.type === \"message_update\") {\n      const assistantMessageEvent = (\n        event as {\n          assistantMessageEvent?: { type?: string; delta?: string };\n        }\n      ).assistantMessageEvent;\n      if (\n        assistantMessageEvent?.type === \"text_delta\" &&\n        assistantMessageEvent.delta &&\n        responseCtx.appendResponseDelta\n      ) {\n        queue.enqueue(async () => {\n          await responseCtx.appendResponseDelta?.(assistantMessageEvent.delta ?? \"\");\n        }, \"response delta\");\n      }\n      return;\n    }\n\n    if (event.type === \"message_end\") {\n      if (event.message.role === \"assistant\") {\n        const assistantMsg = event.message;\n\n        if (assistantMsg.stopReason) {\n          runState.stopReason = assistantMsg.stopReason;\n        }\n        if (assistantMsg.errorMessage) {\n          runState.errorMessage = assistantMsg.errorMessage;\n        }\n\n        if (assistantMsg.usage) {\n          runState.totalUsage.input += assistantMsg.usage.input;\n          runState.totalUsage.output += assistantMsg.usage.output;\n          runState.totalUsage.cacheRead += assistantMsg.usage.cacheRead;\n          runState.totalUsage.cacheWrite += assistantMsg.usage.cacheWrite;\n          runState.totalUsage.cost.input += assistantMsg.usage.cost.input;\n          runState.totalUsage.cost.output += assistantMsg.usage.cost.output;\n          runState.totalUsage.cost.cacheRead += assistantMsg.usage.cost.cacheRead;\n          runState.totalUsage.cost.cacheWrite += assistantMsg.usage.cost.cacheWrite;\n          runState.totalUsage.cost.total += assistantMsg.usage.cost.total;\n\n          const llmAttributes = metricAttributes({\n            provider: model.provider,\n            model: agentConfig.model,\n            ...baseAttrs,\n            stop_reason: assistantMsg.stopReason,\n            error: Boolean(assistantMsg.errorMessage),\n          });\n          Sentry.metrics.count(\"agent.llm.calls\", 1, { attributes: llmAttributes });\n          Sentry.metrics.distribution(\"agent.llm.tokens_in\", assistantMsg.usage.input, {\n            attributes: llmAttributes,\n          });\n          Sentry.metrics.distribution(\"agent.llm.tokens_out\", assistantMsg.usage.output, {\n            attributes: llmAttributes,\n          });\n          if (assistantMsg.usage.cacheRead > 0) {\n            Sentry.metrics.distribution(\"agent.llm.cache_read\", assistantMsg.usage.cacheRead, {\n              attributes: llmAttributes,\n            });\n          }\n          if (assistantMsg.usage.cacheWrite > 0) {\n            Sentry.metrics.distribution(\"agent.llm.cache_write\", assistantMsg.usage.cacheWrite, {\n              attributes: llmAttributes,\n            });\n          }\n          Sentry.metrics.distribution(\"agent.llm.cost_per_turn\", assistantMsg.usage.cost.total, {\n            attributes: llmAttributes,\n          });\n          addLifecycleBreadcrumb(\"agent.llm.call.completed\", {\n            call_index: runState.llmCallCount,\n            provider: model.provider,\n            model: agentConfig.model,\n            stop_reason: assistantMsg.stopReason,\n            error: Boolean(assistantMsg.errorMessage),\n            input_tokens: assistantMsg.usage.input,\n            output_tokens: assistantMsg.usage.output,\n            cost_total_usd: assistantMsg.usage.cost.total,\n          });\n        }\n\n        const thinkingParts: string[] = [];\n        const textParts: string[] = [];\n        const hasToolCall = assistantMsg.content.some((part) =>\n          [\"tool_use\", \"toolCall\", \"tool-call\"].includes((part as { type?: string }).type ?? \"\"),\n        );\n        for (const part of assistantMsg.content) {\n          if (part.type === \"thinking\") {\n            thinkingParts.push(part.thinking);\n          } else if (part.type === \"text\") {\n            textParts.push(part.text);\n          }\n        }\n\n        const text = textParts.join(\"\\n\");\n\n        for (const thinking of thinkingParts) {\n          log.logThinking(logCtx, thinking);\n          queue.enqueue(() => responseCtx.respond(`_${thinking}_`), \"thinking main\");\n          queue.enqueue(\n            () => responseCtx.respondDiagnostic(`_${thinking}_`),\n            \"thinking diagnostic\",\n          );\n        }\n\n        if (text.trim() && !hasToolCall) {\n          if (runState.finalResponseHandledByTool) return;\n          const finalText = appendTriggerAttribution(text, runState.triggerAttribution);\n          log.logResponse(logCtx, text);\n          if (responseCtx.finishResponse) {\n            queue.enqueue(async () => {\n              await responseCtx.finishResponse?.(finalText);\n            }, \"response finish\");\n          } else {\n            queue.enqueue(() => responseCtx.respond(finalText), \"response main\");\n          }\n        }\n      }\n      return;\n    }\n\n    if (event.type === \"compaction_start\") {\n      log.logInfo(`Auto-compaction started (reason: ${event.reason})`);\n      queue.enqueue(() => responseCtx.respond(\"_Compacting context..._\"), \"compaction start\");\n      return;\n    }\n\n    if (event.type === \"compaction_end\") {\n      if (event.result) {\n        log.logInfo(`Auto-compaction complete: ${event.result.tokensBefore} tokens compacted`);\n      } else if (event.aborted) {\n        log.logInfo(\"Auto-compaction aborted\");\n      }\n      return;\n    }\n\n    if (event.type === \"auto_retry_start\") {\n      log.logWarning(`Retrying (${event.attempt}/${event.maxAttempts})`, event.errorMessage);\n      queue.enqueue(\n        () => responseCtx.respond(`_Retrying (${event.attempt}/${event.maxAttempts})..._`),\n        \"retry\",\n      );\n    }\n  });\n}\n\n// Cap raw tool output before handing it to adapters. Bash output can be MB; without\n// this each adapter's splitter would fan it out into many sequential platform posts.\nconst TOOL_RESULT_DIAGNOSTIC_CAP = 8000;\n\nfunction extractToolResultText(result: unknown): string {\n  if (typeof result === \"string\") {\n    return result;\n  }\n\n  if (\n    result &&\n    typeof result === \"object\" &&\n    \"content\" in result &&\n    Array.isArray((result as { content: unknown }).content)\n  ) {\n    const content = (result as { content: Array<{ type: string; text?: string }> }).content;\n    const textParts: string[] = [];\n    for (const part of content) {\n      if (part.type === \"text\" && part.text) {\n        textParts.push(part.text);\n      }\n    }\n    if (textParts.length > 0) {\n      return textParts.join(\"\\n\");\n    }\n  }\n\n  return JSON.stringify(result);\n}\n\n/**\n * Create a new AgentRunner for a channel.\n * Sets up the session and subscribes to events once.\n *\n * Runner caching is handled by the caller (channelStates in main.ts).\n * This is a stateless factory function.\n */\nexport async function createRunner(\n  sandboxConfig: SandboxConfig,\n  sessionKey: string,\n  conversationId: string,\n  conversationDir: string,\n  workspaceDir: string,\n  sessionScope: ResolvedSessionScope,\n  vaultManager?: VaultManager,\n  provisioner?: DockerContainerManager,\n  sessionView?: {\n    tokenStore: SessionViewTokenStoreLike;\n    portalBaseUrl?: string;\n  },\n): Promise<AgentRunner> {\n  const agentConfig = resolveConversationSettings(conversationDir);\n\n  const workspaceBase = join(conversationDir, \"..\");\n  const { executionResolver, executor, getPathContext, resolveExecutorForRun } =\n    createRunnerExecutionContext(\n      sandboxConfig,\n      vaultManager,\n      provisioner,\n      workspaceDir,\n      workspaceBase,\n    );\n  let pathContext = getUnresolvedSandboxPathContext(sandboxConfig, workspaceBase);\n\n  // Create tools (per-runner, with per-runner upload function setter)\n  const {\n    tools,\n    setUploadFunction,\n    setBlockKitResponseFunction,\n    setEventContext,\n    setSandboxContext,\n  } = createMikanTools(executor, workspaceDir, { sandbox: sandboxConfig, provisioner });\n\n  const authStorage = AuthStorage.create(join(homedir(), \".pi\", \"mikan\", \"auth.json\"));\n  const modelRegistry = ModelRegistry.create(authStorage);\n  const model = resolveConfiguredModel(modelRegistry, agentConfig.provider, agentConfig.model);\n\n  // Initial system prompt (will be updated each run with fresh memory/channels/users/skills)\n  const memory = await getMemory(conversationDir);\n  const skills = loadMikanSkills(conversationDir, pathContext.runtimeWorkspaceRoot);\n  const emptyPlatform: PlatformInfo = {\n    name: \"chat\",\n    formattingGuide: \"\",\n    channels: [],\n    users: [],\n  };\n  const systemPrompt = buildSystemPrompt(\n    pathContext.runtimeWorkspaceRoot,\n    conversationId,\n    \"shared\",\n    undefined,\n    memory,\n    sandboxConfig,\n    emptyPlatform,\n    skills,\n  );\n\n  // Create session manager and settings manager. Top-level/private sessions\n  // use the conversation's current pointer; scoped sessions use fixed files.\n  // Platform-specific scope behavior is resolved before runner creation.\n  const isThread = sessionKey.includes(\":\");\n  const { sessionDir, contextFile, threadRootMessage } = sessionScope;\n  const sessionManager = openManagedSession(\n    contextFile,\n    sessionDir,\n    pathContext.runtimeWorkspaceRoot,\n  );\n  const threadSessionName = buildThreadSessionName(threadRootMessage);\n  if (isThread && threadSessionName && sessionManager.getSessionName() !== threadSessionName) {\n    sessionManager.appendSessionInfo(threadSessionName);\n  }\n\n  const sessionUuid = extractSessionUuid(contextFile);\n  const chatSessionManager = new ChatSessionManager();\n  const settingsManager = SettingsManager.inMemory();\n  const { agent, session } = await createConfiguredAgentSession({\n    conversationId,\n    workspaceDir,\n    runtimeWorkspaceRoot: pathContext.runtimeWorkspaceRoot,\n    systemPrompt,\n    model,\n    thinkingLevel: agentConfig.thinkingLevel,\n    tools,\n    sessionManager,\n    settingsManager,\n    modelRegistry,\n  });\n\n  // Mutable per-run state - event handler references this\n  const runState = createRunState();\n  attachSessionEventHandlers({ session, runState, model, agentConfig });\n\n  return {\n    syncChatHistory(currentMessageId?: string): void {\n      chatSessionManager.syncSessionManager({\n        conversationDir,\n        sessionKey,\n        sessionManager,\n        currentMessageId,\n      });\n    },\n\n    async run(\n      message: ChatMessage,\n      responseCtx: ChatResponseContext,\n      platform: PlatformInfo,\n    ): Promise<{ stopReason: string; errorMessage?: string }> {\n      const prepared = await prepareRunContext({\n        message,\n        responseCtx,\n        platform,\n        conversationId,\n        conversationDir,\n        sessionUuid,\n        runState,\n        executor,\n        executionResolver,\n        resolveExecutorForRun,\n        getPathContext,\n        sessionManager,\n        session,\n        agent,\n        setEventContext,\n        setSandboxContext,\n        setUploadFunction,\n        setBlockKitResponseFunction,\n        pathContext,\n      });\n      pathContext = prepared.pathContext;\n\n      if (runState.logCtx) {\n        log.logAgentRunStart(runState.logCtx, model.provider, model.id, model.name);\n      }\n\n      updateActiveSpanAttribution({\n        provider: model.provider,\n        model: agentConfig.model,\n        channel_id: prepared.sessionConversation,\n        session_id: sessionUuid,\n      });\n      addLifecycleBreadcrumb(\"agent.prompt.sent\", {\n        provider: model.provider,\n        model: agentConfig.model,\n        channel_id: prepared.sessionConversation,\n        session_id: sessionUuid,\n        attachment_count: message.attachments?.length ?? 0,\n        image_attachment_count: prepared.imageAttachments.length,\n      });\n\n      await session.prompt(\n        prepared.userMessage,\n        prepared.imageAttachments.length > 0 ? { images: prepared.imageAttachments } : undefined,\n      );\n\n      // Wait for queued messages\n      await prepared.runQueue.wait();\n\n      const sessionViewTokenStore = sessionView?.tokenStore;\n      const sessionViewPortalBaseUrl = sessionView?.portalBaseUrl;\n      const createOverflowLink =\n        sessionViewTokenStore && sessionViewPortalBaseUrl\n          ? () => {\n              const token = sessionViewTokenStore.create(\n                platform.name as PlatformName,\n                message.userId,\n                conversationId,\n                message.sessionKey,\n                contextFile,\n                message.userName,\n              );\n              return `${sessionViewPortalBaseUrl}/session?token=${token.token}`;\n            }\n          : undefined;\n\n      await finalizeRunResponse(responseCtx, session, runState, {\n        triggerAttribution: prepared.triggerAttribution,\n        createOverflowLink,\n        platform: platform.name,\n        model,\n        sessionConversation: prepared.sessionConversation,\n        sessionUuid,\n      });\n\n      await reportUsageSummary({\n        session,\n        runState,\n        responseCtx,\n        platform,\n        model,\n        agentConfig,\n        sessionConversation: prepared.sessionConversation,\n        sessionUuid,\n        waitForQueue: () => prepared.runQueue.wait(),\n      });\n\n      // Clear run state\n      runState.responseCtx = null;\n      runState.logCtx = null;\n      runState.queue = null;\n\n      return { stopReason: runState.stopReason, errorMessage: runState.errorMessage };\n    },\n\n    abort(): void {\n      session.abort();\n    },\n\n    getCurrentStep(): { toolName?: string; label?: string } | undefined {\n      const pending = runState.pendingTools;\n      if (pending.size === 0) return undefined;\n      // Get the first pending tool\n      const first = pending.values().next().value;\n      if (!first) return undefined;\n      return {\n        toolName: first.toolName,\n        label: (first.args as { label?: string })?.label,\n      };\n    },\n  };\n}\n\nexport function translateRuntimePathToHost(\n  runtimePath: string,\n  pathContext: RuntimePathContext,\n): string {\n  return pathContext.runtimeToHostPath?.(runtimePath) ?? runtimePath;\n}\n\nexport function translateAttachPathToHost(\n  filePath: string,\n  pathContext: RuntimePathContext,\n): string {\n  const runtimePath = posix.isAbsolute(filePath)\n    ? filePath\n    : posix.join(pathContext.runtimeWorkspaceRoot, filePath);\n  return translateRuntimePathToHost(runtimePath, pathContext);\n}\n"]}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,YAAY,EAAc,MAAM,uBAAuB,CAAC;AAkBhF,OAAO,KAAK,EACV,mBAAmB,EAMpB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAKrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,qBAAqB,CAAC;AAQ7B,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAyIjD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC,GAC7D,MAAM,GAAG,SAAS,CAOpB;AA0MD,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,MAAM,GACxB,kBAAkB,CAMpB;AAkTD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,kBAAkB,GAC/B;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,YAAY,EAAE,CAAC;CAClC,CAaA;AA+BD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,MAAM,CAKR;AA0oBD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,oBAAoB,EAClC,YAAY,CAAC,EAAE,YAAY,EAC3B,WAAW,CAAC,EAAE,sBAAsB,EACpC,WAAW,CAAC,EAAE;IACZ,UAAU,EAAE,yBAAyB,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,OAAO,CAAC,cAAc,CAAC,CAsNzB;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,kBAAkB,GAC9B,MAAM,CAER;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,kBAAkB,GAC9B,MAAM,CAKR"}

package/dist/agent.js

@@ -11,13 +11,14 @@ import { reportUserFacingError } from "./observability/sentry.js";
 import { createExecutor, } from "./sandbox/index.js";
 import { createMountedRuntimePathContext } from "./sandbox/path-context.js";
 import { addLifecycleBreadcrumb, metricAttributes, updateActiveSpanAttribution, } from "./observability/sentry.js";
-import { ChatSessionManager } from "./sessions/chat-session-manager.js";
+import { AgentMemoryFileManager } from "./sessions/agent-memory-file-manager.js";
 import { extractSessionUuid, openManagedSession, } from "./sessions/store.js";
 import { shouldSurfaceToolDiagnostic } from "./tool-diagnostics.js";
 import { createMikanTools } from "./tools/index.js";
 import * as Sentry from "@sentry/node";
 import { formatLocalTimestamp } from "./utils/date.js";
 import { resolveConfiguredModel } from "./model-registry.js";
+import { emitAgentEvent } from "./agent-events.js";
 const IMAGE_MIME_TYPES = {
     jpg: "image/jpeg",
     jpeg: "image/jpeg",
@@ -292,7 +293,7 @@ Maintain ${workspaceRoot}/SYSTEM.md to log all environment modifications:
 Update this file whenever you modify the environment. On fresh container, read it first to restore your setup.
 
 ## Log Queries (for older history)
-Format: \`{"date":"...","ts":"...","user":"...","userName":"...","text":"...","isBot":false}\`
+Format: \`{"date":"...","ts":"...","user":"...","userName":"...","text":"...","isMessagingBot":false}\`
 The log contains user messages and your final responses (not tool calls/results).
 Use \`log.jsonl\` for quick grep-style history. Use \`${conversationPath}/sessions/\` when you need structured turns, tool outputs, or thread/session lineage.
 ${isContainerLike || isFirecracker ? "Install jq: apt-get install jq" : ""}
@@ -439,7 +440,7 @@ function createEmptyUsageTotals() {
 }
 function createRunState() {
     return {
-        responseCtx: null,
+        responder: null,
         logCtx: null,
         queue: null,
         pendingTools: new Map(),
@@ -452,8 +453,8 @@ function createRunState() {
         triggerAttribution: undefined,
     };
 }
-function resetRunState(runState, responseCtx, sessionConversation, userName, sessionUuid, triggerAttribution) {
-    runState.responseCtx = responseCtx;
+function resetRunState(runState, responder, sessionConversation, userName, sessionUuid, triggerAttribution) {
+    runState.responder = responder;
     runState.logCtx = {
         conversationId: sessionConversation,
         userName,
@@ -469,7 +470,7 @@ function resetRunState(runState, responseCtx, sessionConversation, userName, ses
     runState.finalResponseHandledByTool = false;
     runState.triggerAttribution = triggerAttribution;
 }
-function createRunQueue(responseCtx, runState) {
+function createRunQueue(responder, runState) {
     let queueChain = Promise.resolve();
     return {
         queue: {
@@ -484,7 +485,7 @@ function createRunQueue(responseCtx, runState) {
                         const errMsg = err instanceof Error ? err.message : String(err);
                         log.logWarning(`API error (${errorContext})`, errMsg);
                         try {
-                            await responseCtx.respondDiagnostic(`Error: ${errMsg}`, { style: "error" });
+                            await responder.respondDiagnostic(`Error: ${errMsg}`, { style: "error" });
                         }
                         catch {
                             // Ignore
@@ -558,7 +559,7 @@ export function appendTriggerAttribution(text, triggerAttribution) {
         return text;
     return `${text.trimEnd()}\n\n${suffix}`;
 }
-async function finalizeRunResponse(responseCtx, session, runState, options) {
+async function finalizeRunResponse(responder, session, runState, options) {
     if (runState.stopReason === "error" && runState.errorMessage) {
         if (!runState.reportedLlmError) {
             runState.reportedLlmError = true;
@@ -580,8 +581,8 @@ async function finalizeRunResponse(responseCtx, session, runState, options) {
             });
         }
         try {
-            await responseCtx.replaceResponse("_Sorry, something went wrong_");
-            await responseCtx.respondDiagnostic(`Error: ${runState.errorMessage}`, {
+            await responder.replaceResponse("_Sorry, something went wrong_");
+            await responder.respondDiagnostic(`Error: ${runState.errorMessage}`, {
                 style: "error",
             });
         }
@@ -610,7 +611,7 @@ async function finalizeRunResponse(responseCtx, session, runState, options) {
     }
     if (finalText.trim() === "[SILENT]" || finalText.trim().startsWith("[SILENT]")) {
         try {
-            await responseCtx.deleteResponse();
+            await responder.deleteResponse();
             log.logInfo("Silent response - deleted message and thread");
         }
         catch (err) {
@@ -622,7 +623,7 @@ async function finalizeRunResponse(responseCtx, session, runState, options) {
     if (!finalText.trim())
         return;
     try {
-        await responseCtx.replaceResponse(appendTriggerAttribution(finalText, options?.triggerAttribution), { createOverflowLink: options?.createOverflowLink });
+        await responder.replaceResponse(appendTriggerAttribution(finalText, options?.triggerAttribution), { createOverflowLink: options?.createOverflowLink });
     }
     catch (err) {
         const errMsg = err instanceof Error ? err.message : String(err);
@@ -642,9 +643,7 @@ async function finalizeRunResponse(responseCtx, session, runState, options) {
     }
 }
 async function reportUsageSummary(ctx) {
-    const { session, runState, responseCtx, platform, model, agentConfig, sessionConversation, sessionUuid, waitForQueue, } = ctx;
-    if (runState.totalUsage.cost.total <= 0)
-        return;
+    const { session, runState, responder, platform, model, agentConfig, sessionConversation, sessionUuid, waitForQueue, } = ctx;
     const lastAssistantMessage = session.messages
         .slice()
         .toReversed()
@@ -686,7 +685,7 @@ async function reportUsageSummary(ctx) {
     });
     const summary = log.logUsageSummary(runState.logCtx, runState.totalUsage, contextTokens, contextWindow);
     if (platform.diagnostics?.showUsageSummary === true) {
-        runState.queue.enqueue(() => responseCtx.respondDiagnostic(summary, { style: "muted" }), "usage summary");
+        runState.queue.enqueue(() => responder.respondDiagnostic(summary, { style: "muted" }), "usage summary");
         await waitForQueue();
     }
 }
@@ -698,7 +697,7 @@ function reloadSessionMessages(sessionManager, conversationId, agent) {
     }
 }
 async function prepareRunContext(params) {
-    const { message, responseCtx, platform, conversationId, conversationDir, sessionUuid, runState, executor, executionResolver, resolveExecutorForRun, getPathContext, sessionManager, session, agent, setEventContext, setSandboxContext, setUploadFunction, setBlockKitResponseFunction, } = params;
+    const { message, responder, platform, conversationId, conversationDir, sessionUuid, runState, executor, executionResolver, resolveExecutorForRun, getPathContext, sessionManager, session, agent, setEventContext, setSandboxContext, setUploadFunction, setBlockKitResponseFunction, } = params;
     let pathContext = params.pathContext;
     const sessionConversation = message.sessionKey.split(":")[0];
     await mkdir(join(conversationDir, "scratch"), { recursive: true });
@@ -725,19 +724,19 @@ async function prepareRunContext(params) {
     setSandboxContext({ conversationId, userId: message.userId });
     setUploadFunction(async (filePath, title) => {
         const hostPath = translateAttachPathToHost(filePath, pathContext);
-        await responseCtx.uploadFile(hostPath, title);
+        await responder.uploadFile(hostPath, title);
     });
     setBlockKitResponseFunction(async (response) => {
-        if (platform.name === "slack" && responseCtx.respondBlockKit) {
-            await responseCtx.respondBlockKit(response);
+        if (platform.name === "slack" && responder.respondBlockKit) {
+            await responder.respondBlockKit(response);
         }
         else {
-            await responseCtx.replaceResponse(response.text);
+            await responder.replaceResponse(response.text);
         }
         runState.finalResponseHandledByTool = true;
     });
-    resetRunState(runState, responseCtx, sessionConversation, message.userName, sessionUuid, triggerAttribution);
-    const runQueue = createRunQueue(responseCtx, runState);
+    resetRunState(runState, responder, sessionConversation, message.userName, sessionUuid, triggerAttribution);
+    const runQueue = createRunQueue(responder, runState);
     runState.queue = runQueue.queue;
     log.logInfo(`Context sizes - system: ${systemPrompt.length} chars, memory: ${memory.length} chars`);
     log.logInfo(`Channels: ${platform.channels.length}, Users: ${platform.users.length}`);
@@ -752,16 +751,33 @@ async function prepareRunContext(params) {
         pathContext,
     };
 }
+function formatAgentActorName(userName, fallback) {
+    return userName ? `DM:${userName}` : fallback;
+}
+function sendAgentEvent(payload) {
+    emitAgentEvent({ source: "mikan", ...payload });
+}
 function attachSessionEventHandlers(params) {
     const { session, runState, model, agentConfig } = params;
     session.subscribe(async (event) => {
-        if (!runState.responseCtx || !runState.logCtx || !runState.queue)
+        if (!runState.responder || !runState.logCtx || !runState.queue)
             return;
-        const { responseCtx, logCtx, queue, pendingTools } = runState;
+        const { responder, logCtx, queue, pendingTools } = runState;
         const baseAttrs = { channel_id: logCtx.conversationId, session_id: logCtx.sessionId };
+        const agentEventSessionId = logCtx.sessionId ?? logCtx.conversationId;
         if (event.type === "tool_execution_start") {
             const args = (event.args ?? {});
             const label = args.label || event.toolName;
+            sendAgentEvent({
+                sessionId: agentEventSessionId,
+                actorName: formatAgentActorName(logCtx.userName, logCtx.conversationId),
+                event: {
+                    kind: "toolStart",
+                    toolId: event.toolCallId,
+                    toolName: event.toolName,
+                    input: { label },
+                },
+            });
             pendingTools.set(event.toolCallId, {
                 toolName: event.toolName,
                 args: event.args,
@@ -777,6 +793,11 @@ function attachSessionEventHandlers(params) {
         if (event.type === "tool_execution_end") {
             const resultStr = extractToolResultText(event.result);
             const pending = pendingTools.get(event.toolCallId);
+            sendAgentEvent({
+                sessionId: agentEventSessionId,
+                actorName: formatAgentActorName(logCtx.userName, logCtx.conversationId),
+                event: { kind: "toolEnd", toolId: event.toolCallId },
+            });
             pendingTools.delete(event.toolCallId);
             const durationMs = pending ? Date.now() - pending.startTime : 0;
             Sentry.metrics.count("agent.tool.calls", 1, {
@@ -814,16 +835,21 @@ function attachSessionEventHandlers(params) {
                     isError: event.isError,
                     durationMs,
                 };
-                queue.enqueue(() => responseCtx.respondToolResult(toolResult), "tool result diagnostic");
+                queue.enqueue(() => responder.respondToolResult(toolResult), "tool result diagnostic");
             }
             if (event.isError && shouldSurfaceToolDiagnostic(event.toolName)) {
-                queue.enqueue(() => responseCtx.respond(`_Error: ${truncate(resultStr, 200)}_`), "tool error");
+                queue.enqueue(() => responder.respond(`_Error: ${truncate(resultStr, 200)}_`), "tool error");
             }
             return;
         }
         if (event.type === "message_start") {
             if (event.message.role === "assistant") {
                 runState.llmCallCount += 1;
+                sendAgentEvent({
+                    sessionId: agentEventSessionId,
+                    actorName: formatAgentActorName(logCtx.userName, logCtx.conversationId),
+                    event: { kind: "sessionStart" },
+                });
                 addLifecycleBreadcrumb("agent.llm.call.started", {
                     call_index: runState.llmCallCount,
                     provider: model.provider,
@@ -838,9 +864,9 @@ function attachSessionEventHandlers(params) {
             const assistantMessageEvent = event.assistantMessageEvent;
             if (assistantMessageEvent?.type === "text_delta" &&
                 assistantMessageEvent.delta &&
-                responseCtx.appendResponseDelta) {
+                responder.appendResponseDelta) {
                 queue.enqueue(async () => {
-                    await responseCtx.appendResponseDelta?.(assistantMessageEvent.delta ?? "");
+                    await responder.appendResponseDelta?.(assistantMessageEvent.delta ?? "");
                 }, "response delta");
             }
             return;
@@ -916,21 +942,26 @@ function attachSessionEventHandlers(params) {
                 const text = textParts.join("\n");
                 for (const thinking of thinkingParts) {
                     log.logThinking(logCtx, thinking);
-                    queue.enqueue(() => responseCtx.respond(`_${thinking}_`), "thinking main");
-                    queue.enqueue(() => responseCtx.respondDiagnostic(`_${thinking}_`), "thinking diagnostic");
+                    queue.enqueue(() => responder.respond(`_${thinking}_`), "thinking main");
+                    queue.enqueue(() => responder.respondDiagnostic(`_${thinking}_`), "thinking diagnostic");
                 }
                 if (text.trim() && !hasToolCall) {
                     if (runState.finalResponseHandledByTool)
                         return;
                     const finalText = appendTriggerAttribution(text, runState.triggerAttribution);
                     log.logResponse(logCtx, text);
-                    if (responseCtx.finishResponse) {
+                    sendAgentEvent({
+                        sessionId: agentEventSessionId,
+                        actorName: formatAgentActorName(logCtx.userName, logCtx.conversationId),
+                        event: { kind: "turnEnd" },
+                    });
+                    if (responder.finishResponse) {
                         queue.enqueue(async () => {
-                            await responseCtx.finishResponse?.(finalText);
+                            await responder.finishResponse?.(finalText);
                         }, "response finish");
                     }
                     else {
-                        queue.enqueue(() => responseCtx.respond(finalText), "response main");
+                        queue.enqueue(() => responder.respond(finalText), "response main");
                     }
                 }
             }
@@ -938,7 +969,7 @@ function attachSessionEventHandlers(params) {
         }
         if (event.type === "compaction_start") {
             log.logInfo(`Auto-compaction started (reason: ${event.reason})`);
-            queue.enqueue(() => responseCtx.respond("_Compacting context..._"), "compaction start");
+            queue.enqueue(() => responder.respond("_Compacting context..._"), "compaction start");
             return;
         }
         if (event.type === "compaction_end") {
@@ -952,7 +983,12 @@ function attachSessionEventHandlers(params) {
         }
         if (event.type === "auto_retry_start") {
             log.logWarning(`Retrying (${event.attempt}/${event.maxAttempts})`, event.errorMessage);
-            queue.enqueue(() => responseCtx.respond(`_Retrying (${event.attempt}/${event.maxAttempts})..._`), "retry");
+            sendAgentEvent({
+                sessionId: agentEventSessionId,
+                actorName: formatAgentActorName(logCtx.userName, logCtx.conversationId),
+                event: { kind: "sessionStart" },
+            });
+            queue.enqueue(() => responder.respond(`_Retrying (${event.attempt}/${event.maxAttempts})..._`), "retry");
         }
     });
 }
@@ -981,7 +1017,7 @@ function extractToolResultText(result) {
     return JSON.stringify(result);
 }
 /**
- * Create a new AgentRunner for a channel.
+ * Create a new PiAgentWrapper for a channel.
  * Sets up the session and subscribes to events once.
  *
  * Runner caching is handled by the caller (channelStates in main.ts).
@@ -1018,7 +1054,7 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
         sessionManager.appendSessionInfo(threadSessionName);
     }
     const sessionUuid = extractSessionUuid(contextFile);
-    const chatSessionManager = new ChatSessionManager();
+    const chatSessionManager = new AgentMemoryFileManager();
     const settingsManager = SettingsManager.inMemory();
     const { agent, session } = await createConfiguredAgentSession({
         conversationId,
@@ -1044,10 +1080,10 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
                 currentMessageId,
             });
         },
-        async run(message, responseCtx, platform) {
+        async run(message, responder, platform) {
             const prepared = await prepareRunContext({
                 message,
-                responseCtx,
+                responder,
                 platform,
                 conversationId,
                 conversationDir,
@@ -1084,6 +1120,11 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
                 attachment_count: message.attachments?.length ?? 0,
                 image_attachment_count: prepared.imageAttachments.length,
             });
+            sendAgentEvent({
+                sessionId: sessionUuid,
+                actorName: formatAgentActorName(message.userName, prepared.sessionConversation),
+                event: { kind: "sessionStart" },
+            });
             await session.prompt(prepared.userMessage, prepared.imageAttachments.length > 0 ? { images: prepared.imageAttachments } : undefined);
             // Wait for queued messages
             await prepared.runQueue.wait();
@@ -1095,7 +1136,7 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
                     return `${sessionViewPortalBaseUrl}/session?token=${token.token}`;
                 }
                 : undefined;
-            await finalizeRunResponse(responseCtx, session, runState, {
+            await finalizeRunResponse(responder, session, runState, {
                 triggerAttribution: prepared.triggerAttribution,
                 createOverflowLink,
                 platform: platform.name,
@@ -1106,7 +1147,7 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
             await reportUsageSummary({
                 session,
                 runState,
-                responseCtx,
+                responder,
                 platform,
                 model,
                 agentConfig,
@@ -1115,7 +1156,7 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
                 waitForQueue: () => prepared.runQueue.wait(),
             });
             // Clear run state
-            runState.responseCtx = null;
+            runState.responder = null;
             runState.logCtx = null;
             runState.queue = null;
             return { stopReason: runState.stopReason, errorMessage: runState.errorMessage };