@geminixiang/mama 0.2.0-beta.1 → 0.2.0-beta.2

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAKnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiB/C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CACD,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,KAAK,IAAI,IAAI,CAAC;IACd,6DAA6D;IAC7D,cAAc,IAAI;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACrE;AA4WD;;;;;;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,CAAC,EAAE,YAAY,EAC3B,YAAY,CAAC,EAAE,gBAAgB,EAC/B,WAAW,CAAC,EAAE,sBAAsB,EACpC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,CAyxBtB","sourcesContent":["import { Agent, type AgentEvent } from \"@mariozechner/pi-agent-core\";\nimport { getModel, type ImageContent } from \"@mariozechner/pi-ai\";\nimport {\n  AgentSession,\n  AuthStorage,\n  convertToLlm,\n  DefaultResourceLoader,\n  formatSkillsForPrompt,\n  getAgentDir,\n  loadSkillsFromDir,\n  ModelRegistry,\n  SessionManager,\n  type Skill,\n} from \"@mariozechner/pi-coding-agent\";\nimport { existsSync, readFileSync } from \"fs\";\nimport { mkdir, readFile, writeFile } from \"fs/promises\";\nimport { homedir } from \"os\";\nimport { join } from \"path\";\nimport type { ChatMessage, ChatResponseContext, PlatformInfo } from \"./adapter.js\";\nimport { loadAgentConfig } from \"./config.js\";\nimport { createMamaSettingsManager, syncLogToSessionManager } from \"./context.js\";\nimport { ActorExecutionResolver } from \"./execution-resolver.js\";\nimport * as log from \"./log.js\";\nimport type { UserBindingStore } from \"./bindings.js\";\nimport type { DockerContainerManager } from \"./provisioner.js\";\nimport { createExecutor, type Executor, type SandboxConfig } from \"./sandbox.js\";\nimport type { VaultManager } from \"./vault.js\";\nimport { addLifecycleBreadcrumb, metricAttributes } from \"./sentry.js\";\nimport {\n  createManagedSessionFileAtPath,\n  extractSessionSuffix,\n  extractSessionUuid,\n  forkThreadSessionFile,\n  getChannelSessionDir,\n  getThreadSessionFile,\n  openManagedSession,\n  resolveChannelSessionFile,\n  resolveManagedSessionFile,\n  tryResolveThreadSession,\n} from \"./session-store.js\";\nimport { createMamaTools } from \"./tools/index.js\";\nimport * as Sentry from \"@sentry/node\";\n\nexport interface PendingMessage {\n  userName: string;\n  text: string;\n  attachments: { localPath: string }[];\n  timestamp: number;\n}\n\nexport interface AgentRunner {\n  run(\n    message: ChatMessage,\n    responseCtx: ChatResponseContext,\n    platform: PlatformInfo,\n  ): Promise<{ stopReason: string; errorMessage?: string }>;\n  abort(): void;\n  /** Get current step info (tool name, label) for debugging */\n  getCurrentStep(): { toolName?: string; label?: string } | undefined;\n}\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\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 loadMamaSkills(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 buildSystemPrompt(\n  workspacePath: string,\n  conversationId: string,\n  currentUserId: string | undefined,\n  memory: string,\n  sandboxConfig: SandboxConfig,\n  platform: PlatformInfo,\n  skills: Skill[],\n): string {\n  const conversationPath = `${workspacePath}/${conversationId}`;\n  const isContainer = sandboxConfig.type === \"container\" || sandboxConfig.type === \"image\";\n  const isFirecracker = sandboxConfig.type === \"firecracker\";\n\n  // Format platform conversation 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 = isContainer\n    ? `You are running inside a container (Docker runtime, Alpine Linux).\n- Bash working directory: / (use cd or absolute paths)\n- Install tools with: apk add <package>\n- Your changes persist across sessions`\n    : isFirecracker\n      ? `You are running inside a Firecracker microVM.\n- Bash working directory: / (use cd or absolute paths)\n- Install tools with: apt-get install <package> (Debian-based)\n- Your changes persist across sessions`\n      : `You are running directly on the host machine.\n- Bash working directory: ${process.cwd()}\n- Be careful with system modifications`;\n\n  return `You are mama, 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 history beyond your context, search log.jsonl (contains user messages and your final responses, but not tool results).\n- User messages include a \\`[in-thread:TS]\\` marker when sent from within a Slack thread (TS is the root message timestamp). Without this marker, the message is a top-level channel message.\n\n${platform.formattingGuide}\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\n## Workspace Layout\n${workspacePath}/\n├── MEMORY.md                    # Global memory (all channels)\n├── skills/                      # Global CLI tools you create\n└── ${conversationId}/           # This conversation\n    ├── MEMORY.md                # Conversation-specific memory\n    ├── log.jsonl                # Message history (no tool results)\n    ├── attachments/             # User-shared files\n    ├── scratch/                 # Your working directory\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 \\`${workspacePath}/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\nYou can schedule events that wake you up at specific times or when external things happen. Events are JSON files in \\`${workspacePath}/events/\\`.\n\n### Event Types\n\n**Immediate** - Triggers as soon as harness sees the file. Use in scripts/webhooks to signal external events.\n\\`\\`\\`json\n{\"type\": \"immediate\", \"platform\": \"${platform.name}\", \"channelId\": \"${conversationId}\", \"userId\": \"<requester userId>\", \"text\": \"New GitHub issue opened\"}\n\\`\\`\\`\n\n**One-shot** - Triggers once at a specific time. Use for reminders.\n\\`\\`\\`json\n{\"type\": \"one-shot\", \"platform\": \"${platform.name}\", \"channelId\": \"${conversationId}\", \"userId\": \"<requester userId>\", \"text\": \"Remind Mario about dentist\", \"at\": \"2025-12-15T09:00:00+01:00\"}\n\\`\\`\\`\n\n**Periodic** - Triggers on a cron schedule. Use for recurring tasks.\n\\`\\`\\`json\n{\"type\": \"periodic\", \"platform\": \"${platform.name}\", \"channelId\": \"${conversationId}\", \"userId\": \"<requester userId>\", \"text\": \"Check inbox and summarize\", \"schedule\": \"0 9 * * 1-5\", \"timezone\": \"${Intl.DateTimeFormat().resolvedOptions().timeZone}\"}\n\\`\\`\\`\n\nSet \\`userId\\` to the platform userId of whoever asked for the event (look it up in the user mappings above). When the event fires, tool execution will route to the sandbox vault selection for that user so the right credentials are available. In shared container mode, all events use the container's single shared vault.\n\n### Cron Format\n\\`minute hour day-of-month month day-of-week\\`\n- \\`0 9 * * *\\` = daily at 9:00\n- \\`0 9 * * 1-5\\` = weekdays at 9:00\n- \\`30 14 * * 1\\` = Mondays at 14:30\n- \\`0 0 1 * *\\` = first of each month at midnight\n\n### Timezones\nAll \\`at\\` timestamps must include offset (e.g., \\`+01:00\\`). Periodic events use IANA timezone names. The harness runs in ${Intl.DateTimeFormat().resolvedOptions().timeZone}. When users mention times without timezone, assume ${Intl.DateTimeFormat().resolvedOptions().timeZone}.\n\n### Platform Routing\nSet \\`platform\\` to the target bot platform (\\`${platform.name}\\` for this conversation). When only one platform is running, omitting \\`platform\\` is allowed for backward compatibility, but include it by default to avoid ambiguity.\n\n### Creating Events\nPrefer the \\`event\\` tool. It automatically writes to the correct events directory and fills the current \\`platform\\`, \\`channelId\\`, and requester \\`userId\\`.\nDo not use \\`bash\\` or \\`write\\` to hand-create JSON files in \\`/events\\` unless the user explicitly asks for manual file editing.\n\nCurrent conversation defaults:\n- \\`platform\\`: \\`${platform.name}\\`\n- \\`channelId\\`: \\`${conversationId}\\`\n- \\`userId\\`: \\`${currentUserId ?? \"unknown\"}\\`\n\nManual file creation is fallback only:\nUse unique filenames to avoid overwriting existing events. Include a timestamp or random suffix:\n\\`\\`\\`bash\ncat > ${workspacePath}/events/dentist-reminder-$(date +%s).json << 'EOF'\n{\"type\": \"one-shot\", \"platform\": \"${platform.name}\", \"channelId\": \"${conversationId}\", \"userId\": \"<requester userId>\", \"text\": \"Dentist tomorrow\", \"at\": \"2025-12-14T09:00:00+01:00\"}\nEOF\n\\`\\`\\`\nOr check if file exists first before creating.\n\n### Managing Events\n- List: \\`ls ${workspacePath}/events/\\`\n- View: \\`cat ${workspacePath}/events/foo.json\\`\n- Delete/cancel: \\`rm ${workspacePath}/events/foo.json\\`\n\n### When Events Trigger\nYou receive a message like:\n\\`\\`\\`\n[EVENT:dentist-reminder.json:one-shot:2025-12-14T09:00:00+01:00] Dentist tomorrow\n\\`\\`\\`\nImmediate and one-shot events auto-delete after triggering. Periodic events persist until you delete them.\n\n### Silent Completion\nFor periodic events where there's nothing to report, respond with just \\`[SILENT]\\` (no other text). This deletes the status message and posts nothing to the platform. Use this to avoid spamming the channel when periodic checks find nothing actionable.\n\n### Debouncing\nWhen writing programs that create immediate events (email watchers, webhook handlers, etc.), always debounce. If 50 emails arrive in a minute, don't create 50 immediate events. Instead collect events over a window and create ONE immediate event summarizing what happened, or just signal \"new activity, check inbox\" rather than per-item events. Or simpler: use a periodic event to check for new items every N minutes instead of immediate events.\n\n### Limits\nMaximum 5 events can be queued. Don't create excessive immediate or periodic events.\n\n## Memory\nWrite to MEMORY.md files to persist context across conversations.\n- Global (${workspacePath}/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 ${workspacePath}/SYSTEM.md to log all environment modifications:\n- Installed packages (apk add, npm install, 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).\n${isContainer ? \"Install jq: apk add jq\" : \"\"}\n${isFirecracker ? \"Install jq: apt-get install jq\" : \"\"}\n\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\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- 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\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\nfunction formatToolArgsForSlack(_toolName: string, args: Record<string, unknown>): string {\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(args)) {\n    if (key === \"label\") continue;\n\n    if (key === \"path\" && typeof value === \"string\") {\n      const offset = args.offset as number | undefined;\n      const limit = args.limit as number | undefined;\n      if (offset !== undefined && limit !== undefined) {\n        lines.push(`${value}:${offset}-${offset + limit}`);\n      } else {\n        lines.push(value);\n      }\n      continue;\n    }\n\n    if (key === \"offset\" || key === \"limit\") continue;\n\n    if (typeof value === \"string\") {\n      lines.push(value);\n    } else {\n      lines.push(JSON.stringify(value));\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n\n// ============================================================================\n// Agent runner\n// ============================================================================\n\n/**\n * Create a new AgentRunner for a conversation.\n * Sets up the session and subscribes to events once.\n *\n * Runner caching is handled by the caller (conversationStates 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  vaultManager?: VaultManager,\n  bindingStore?: UserBindingStore,\n  provisioner?: DockerContainerManager,\n  stateDir?: string,\n): Promise<AgentRunner> {\n  const agentConfig = loadAgentConfig(stateDir ?? workspaceDir);\n\n  // Initialize logger with settings from config\n  log.initLogger({\n    logFormat: agentConfig.logFormat,\n    logLevel: agentConfig.logLevel,\n  });\n\n  const executionResolver =\n    vaultManager &&\n    (vaultManager.isEnabled() ||\n      !!bindingStore ||\n      sandboxConfig.type === \"image\" ||\n      sandboxConfig.type === \"container\")\n      ? new ActorExecutionResolver(sandboxConfig, vaultManager, bindingStore, provisioner)\n      : undefined;\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  };\n  const workspaceBase = conversationDir.replace(`/${conversationId}`, \"\");\n  // Compute workspace path from the current executor. This may change per run.\n  const getWorkspacePath = () => executor.getWorkspacePath(workspaceBase);\n  let workspacePath = getWorkspacePath();\n\n  // Create tools (per-runner, with per-runner upload function setter)\n  const { tools, setUploadFunction, setEventContext } = createMamaTools(executor, workspaceDir);\n\n  // Resolve model from config\n  // Use 'as any' cast because agentConfig.provider/model are plain strings,\n  // while getModel() has constrained generic types for known providers.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const model = (getModel as any)(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 = loadMamaSkills(conversationDir, workspacePath);\n  const emptyPlatform: PlatformInfo = {\n    name: \"slack\",\n    formattingGuide: \"\",\n    channels: [],\n    users: [],\n  };\n  const systemPrompt = buildSystemPrompt(\n    workspacePath,\n    conversationId,\n    undefined,\n    memory,\n    sandboxConfig,\n    emptyPlatform,\n    skills,\n  );\n\n  // Create session manager and settings manager.\n  // Top-level conversation sessions use {conversationDir}/sessions/current.\n  // Thread sessions use fixed files: {conversationDir}/sessions/{threadTs}.jsonl.\n  const sessionDir = getChannelSessionDir(conversationDir);\n  const isThread = sessionKey.includes(\":\");\n\n  let sessionManager!: SessionManager;\n  let sessionFile!: string;\n\n  if (isThread) {\n    const threadFile = getThreadSessionFile(conversationDir, sessionKey);\n    const existing = tryResolveThreadSession(threadFile);\n    if (existing) {\n      sessionFile = existing;\n      sessionManager = openManagedSession(sessionFile, sessionDir, conversationDir);\n    } else {\n      const conversationSource = resolveChannelSessionFile(conversationDir);\n      if (conversationSource) {\n        try {\n          sessionFile = forkThreadSessionFile(conversationSource, threadFile, conversationDir);\n          sessionManager = openManagedSession(sessionFile, sessionDir, conversationDir);\n        } catch {\n          sessionFile = createManagedSessionFileAtPath(threadFile, conversationDir);\n          sessionManager = openManagedSession(sessionFile, sessionDir, conversationDir);\n        }\n      } else {\n        sessionFile = createManagedSessionFileAtPath(threadFile, conversationDir);\n        sessionManager = openManagedSession(sessionFile, sessionDir, conversationDir);\n      }\n    }\n  } else {\n    // Top-level conversation session: resolve the current session file.\n    sessionFile = resolveManagedSessionFile(sessionDir, conversationDir);\n    sessionManager = openManagedSession(sessionFile, sessionDir, conversationDir);\n  }\n  const sessionUuid = extractSessionUuid(sessionFile);\n  // Used for Slack thread filtering — for non-Slack platforms this is effectively a no-op\n  const rootTs = extractSessionSuffix(sessionKey);\n  const settingsManager = createMamaSettingsManager(join(conversationDir, \"..\"));\n\n  // Create AuthStorage and ModelRegistry\n  // Auth stored outside workspace so agent can't access it\n  const authStorage = AuthStorage.create(join(homedir(), \".pi\", \"mama\", \"auth.json\"));\n  const modelRegistry = ModelRegistry.create(authStorage);\n\n  // Create agent\n  const agent = new Agent({\n    initialState: {\n      systemPrompt,\n      model,\n      thinkingLevel:\n        (agentConfig.thinkingLevel as \"off\" | \"low\" | \"medium\" | \"high\" | undefined) ?? \"off\",\n      tools,\n    },\n    convertToLlm,\n    getApiKey: async () => {\n      const key = await modelRegistry.getApiKeyForProvider(model.provider);\n      if (!key)\n        throw new Error(\n          `No API key for provider \"${model.provider}\". Set the appropriate environment variable or configure via auth.json`,\n        );\n      return key;\n    },\n  });\n\n  // Load existing messages\n  const loadedSession = sessionManager.buildSessionContext();\n  if (loadedSession.messages.length > 0) {\n    agent.state.messages = loadedSession.messages;\n    log.logInfo(\n      `[${conversationId}] Loaded ${loadedSession.messages.length} messages from session file`,\n    );\n  }\n\n  // Load extensions, skills, prompts, themes via DefaultResourceLoader\n  // This reads ~/.pi/agent/settings.json (packages, extensions enable/disable)\n  // and discovers resources from standard locations + npm/git packages.\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((e) => e.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\n  // Create AgentSession wrapper\n  const session = new AgentSession({\n    agent,\n    sessionManager,\n    settingsManager,\n    cwd: workspaceDir,\n    modelRegistry,\n    resourceLoader,\n    baseToolsOverride,\n  });\n\n  // Mutable per-run state - event handler references this\n  const runState = {\n    responseCtx: null as ChatResponseContext | null,\n    logCtx: null as {\n      conversationId: string;\n      userName?: string;\n      conversationName?: string;\n      sessionId?: string;\n    } | null,\n    queue: null as {\n      enqueue(fn: () => Promise<void>, errorContext: string): void;\n      enqueueMessage(\n        text: string,\n        target: \"main\" | \"thread\",\n        errorContext: string,\n        doLog?: boolean,\n      ): void;\n    } | null,\n    pendingTools: new Map<string, { toolName: string; args: unknown; startTime: number }>(),\n    totalUsage: {\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    llmCallCount: 0,\n    stopReason: \"stop\",\n    errorMessage: undefined as string | undefined,\n  };\n\n  // Subscribe to events ONCE\n  session.subscribe(async (event) => {\n    // Skip if no active run\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 agentEvent = event as AgentEvent & { type: \"tool_execution_start\" };\n      const args = agentEvent.args as { label?: string };\n      const label = args.label || agentEvent.toolName;\n\n      pendingTools.set(agentEvent.toolCallId, {\n        toolName: agentEvent.toolName,\n        args: agentEvent.args,\n        startTime: Date.now(),\n      });\n      addLifecycleBreadcrumb(\"agent.tool.started\", {\n        tool: agentEvent.toolName,\n        ...baseAttrs,\n      });\n\n      log.logToolStart(\n        logCtx,\n        agentEvent.toolName,\n        label,\n        agentEvent.args as Record<string, unknown>,\n      );\n      // Tool labels are omitted from the main message to reduce Slack noise.\n      // Tool execution details are still posted to the thread (see tool_execution_end).\n    } else if (event.type === \"tool_execution_end\") {\n      const agentEvent = event as AgentEvent & { type: \"tool_execution_end\" };\n      const resultStr = extractToolResultText(agentEvent.result);\n      const pending = pendingTools.get(agentEvent.toolCallId);\n      pendingTools.delete(agentEvent.toolCallId);\n\n      const durationMs = pending ? Date.now() - pending.startTime : 0;\n\n      Sentry.metrics.count(\"agent.tool.calls\", 1, {\n        attributes: metricAttributes({\n          tool: agentEvent.toolName,\n          error: String(agentEvent.isError),\n          ...baseAttrs,\n        }),\n      });\n      Sentry.metrics.distribution(\"agent.tool.duration\", durationMs, {\n        unit: \"millisecond\",\n        attributes: metricAttributes({\n          tool: agentEvent.toolName,\n          ...baseAttrs,\n        }),\n      });\n      addLifecycleBreadcrumb(\"agent.tool.completed\", {\n        tool: agentEvent.toolName,\n        error: agentEvent.isError,\n        duration_ms: durationMs,\n        ...baseAttrs,\n      });\n\n      if (agentEvent.isError) {\n        log.logToolError(logCtx, agentEvent.toolName, durationMs, resultStr);\n      } else {\n        log.logToolSuccess(logCtx, agentEvent.toolName, durationMs, resultStr);\n      }\n\n      // Post args + result to thread\n      const label = pending?.args ? (pending.args as { label?: string }).label : undefined;\n      const argsFormatted = pending\n        ? formatToolArgsForSlack(agentEvent.toolName, pending.args as Record<string, unknown>)\n        : \"(args not found)\";\n      const duration = (durationMs / 1000).toFixed(1);\n      let threadMessage = `*${agentEvent.isError ? \"✗\" : \"✓\"} ${agentEvent.toolName}*`;\n      if (label) threadMessage += `: ${label}`;\n      threadMessage += ` (${duration}s)\\n`;\n      if (argsFormatted) threadMessage += `\\`\\`\\`\\n${argsFormatted}\\n\\`\\`\\`\\n`;\n      threadMessage += `*Result:*\\n\\`\\`\\`\\n${resultStr}\\n\\`\\`\\``;\n\n      // Only post thread details for tools with meaningful output (bash, attach).\n      // Skip read/write/edit to reduce Slack noise — their results are in the log.\n      const quietTools = new Set([\"read\", \"write\", \"edit\"]);\n      if (!quietTools.has(agentEvent.toolName)) {\n        queue.enqueueMessage(threadMessage, \"thread\", \"tool result thread\", false);\n      }\n\n      if (agentEvent.isError) {\n        queue.enqueue(\n          () => responseCtx.respond(`_Error: ${truncate(resultStr, 200)}_`),\n          \"tool error\",\n        );\n      }\n    } else if (event.type === \"message_start\") {\n      const agentEvent = event as AgentEvent & { type: \"message_start\" };\n      if (agentEvent.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    } else if (event.type === \"message_end\") {\n      const agentEvent = event as AgentEvent & { type: \"message_end\" };\n      if (agentEvent.message.role === \"assistant\") {\n        const assistantMsg = agentEvent.message as any;\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          // Per-turn LLM metrics\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 content = agentEvent.message.content;\n        const thinkingParts: string[] = [];\n        const textParts: string[] = [];\n        for (const part of content) {\n          if (part.type === \"thinking\") {\n            thinkingParts.push((part as any).thinking);\n          } else if (part.type === \"text\") {\n            textParts.push((part as any).text);\n          }\n        }\n\n        const text = textParts.join(\"\\n\");\n\n        for (const thinking of thinkingParts) {\n          log.logThinking(logCtx, thinking);\n          queue.enqueueMessage(`_${thinking}_`, \"main\", \"thinking main\");\n          queue.enqueueMessage(`_${thinking}_`, \"thread\", \"thinking thread\", false);\n        }\n\n        if (text.trim()) {\n          log.logResponse(logCtx, text);\n          queue.enqueueMessage(text, \"main\", \"response main\");\n          // Only overflow to thread for texts that will be truncated in main\n          if (text.length > SLACK_MAX_LENGTH) {\n            queue.enqueueMessage(text, \"thread\", \"response thread\", false);\n          }\n        }\n      }\n    } else if (event.type === \"compaction_start\") {\n      log.logInfo(`Auto-compaction started (reason: ${(event as any).reason})`);\n      queue.enqueue(() => responseCtx.respond(\"_Compacting context..._\"), \"compaction start\");\n    } else if (event.type === \"compaction_end\") {\n      const compEvent = event as any;\n      if (compEvent.result) {\n        log.logInfo(`Auto-compaction complete: ${compEvent.result.tokensBefore} tokens compacted`);\n      } else if (compEvent.aborted) {\n        log.logInfo(\"Auto-compaction aborted\");\n      }\n    } else if (event.type === \"auto_retry_start\") {\n      const retryEvent = event as any;\n      log.logWarning(\n        `Retrying (${retryEvent.attempt}/${retryEvent.maxAttempts})`,\n        retryEvent.errorMessage,\n      );\n      queue.enqueue(\n        () =>\n          responseCtx.respond(`_Retrying (${retryEvent.attempt}/${retryEvent.maxAttempts})..._`),\n        \"retry\",\n      );\n    }\n  });\n\n  // Message limit constant\n  const SLACK_MAX_LENGTH = 40000;\n  const splitForSlack = (text: string): string[] => {\n    if (text.length <= SLACK_MAX_LENGTH) return [text];\n    const parts: string[] = [];\n    let remaining = text;\n    let partNum = 1;\n    while (remaining.length > 0) {\n      const chunk = remaining.substring(0, SLACK_MAX_LENGTH - 50);\n      remaining = remaining.substring(SLACK_MAX_LENGTH - 50);\n      const suffix = remaining.length > 0 ? `\\n_(continued ${partNum}...)_` : \"\";\n      parts.push(chunk + suffix);\n      partNum++;\n    }\n    return parts;\n  };\n\n  return {\n    async run(\n      message: ChatMessage,\n      responseCtx: ChatResponseContext,\n      platform: PlatformInfo,\n    ): Promise<{ stopReason: string; errorMessage?: string }> {\n      // Extract conversationId from sessionKey (format: \"conversationId:rootTs\" or just \"conversationId\")\n      const sessionConversationId = message.sessionKey.split(\":\")[0];\n\n      // Ensure the conversation directory exists\n      await mkdir(conversationDir, { recursive: true });\n\n      // Refresh vault config and clear executor cache so credential changes\n      // (env file updates, vault.json edits, token rotations) take effect.\n      // Then set the active actor BEFORE building system prompt, so workspacePath\n      // reflects the actor's sandbox type.\n      if (executionResolver) {\n        executionResolver.refresh();\n        activeExecutor = await executionResolver.resolve({\n          platform: platform.name,\n          userId: message.userId,\n        });\n        workspacePath = getWorkspacePath();\n      }\n\n      // Sync messages from log.jsonl that arrived while we were offline or busy\n      // Exclude the current message (it will be added via prompt())\n      // Default sync range is 10 days (handled by syncLogToSessionManager)\n      // Thread filter ensures only messages from this session's thread are synced\n      const threadFilter = message.sessionKey.includes(\":\")\n        ? { scope: \"thread\" as const, rootTs, threadTs: message.threadTs }\n        : { scope: \"top-level\" as const, rootTs };\n      const syncedCount = await syncLogToSessionManager(\n        sessionManager,\n        conversationDir,\n        message.id,\n        undefined,\n        threadFilter,\n      );\n      if (syncedCount > 0) {\n        log.logInfo(`[${conversationId}] Synced ${syncedCount} messages from log.jsonl`);\n      }\n\n      // Reload messages from the session file.\n      // This picks up any messages synced above.\n      const reloadedSession = sessionManager.buildSessionContext();\n      if (reloadedSession.messages.length > 0) {\n        agent.state.messages = reloadedSession.messages;\n        log.logInfo(\n          `[${conversationId}] Reloaded ${reloadedSession.messages.length} messages from context`,\n        );\n      }\n\n      // Update system prompt with fresh memory, channel/user info, and skills\n      // Use the actual executor's sandbox config, not the initial config,\n      // to ensure accurate environment description for the model\n      const memory = await getMemory(conversationDir);\n      const skills = loadMamaSkills(conversationDir, workspacePath);\n      const actualSandboxConfig = executor.getSandboxConfig();\n      const systemPrompt = buildSystemPrompt(\n        workspacePath,\n        conversationId,\n        message.userId,\n        memory,\n        actualSandboxConfig,\n        platform,\n        skills,\n      );\n      session.agent.state.systemPrompt = systemPrompt;\n\n      // Set up file upload function\n      setUploadFunction(async (filePath: string, title?: string) => {\n        const hostPath = translateToHostPath(\n          filePath,\n          conversationDir,\n          workspacePath,\n          conversationId,\n        );\n        await responseCtx.uploadFile(hostPath, title);\n      });\n      setEventContext({\n        platform: platform.name,\n        conversationId,\n        userId: message.userId,\n      });\n\n      // Reset per-run state\n      runState.responseCtx = responseCtx;\n      runState.logCtx = {\n        conversationId: sessionConversationId,\n        userName: message.userName,\n        conversationName: undefined,\n        sessionId: sessionUuid,\n      };\n      runState.pendingTools.clear();\n      runState.totalUsage = {\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      runState.llmCallCount = 0;\n      runState.stopReason = \"stop\";\n      runState.errorMessage = undefined;\n\n      // Create queue for this run\n      let queueChain = Promise.resolve();\n      runState.queue = {\n        enqueue(fn: () => Promise<void>, errorContext: string): void {\n          queueChain = queueChain.then(async () => {\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                // Split long error messages to avoid msg_too_long\n                const errParts = splitForSlack(`_Error: ${errMsg}_`);\n                for (const part of errParts) {\n                  await responseCtx.respondInThread(part);\n                }\n              } catch {\n                // Ignore\n              }\n            }\n          });\n        },\n        enqueueMessage(\n          text: string,\n          target: \"main\" | \"thread\",\n          errorContext: string,\n          _doLog = true,\n        ): void {\n          const parts = splitForSlack(text);\n          for (const part of parts) {\n            this.enqueue(\n              () =>\n                target === \"main\" ? responseCtx.respond(part) : responseCtx.respondInThread(part),\n              errorContext,\n            );\n          }\n        },\n      };\n\n      // Log context info\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      // Build user message with timestamp and username prefix\n      // Format: \"[YYYY-MM-DD HH:MM:SS+HH:MM] [username]: message\" so LLM knows when and who\n      const now = new Date();\n      const pad = (n: number) => n.toString().padStart(2, \"0\");\n      const offset = -now.getTimezoneOffset();\n      const offsetSign = offset >= 0 ? \"+\" : \"-\";\n      const offsetHours = pad(Math.floor(Math.abs(offset) / 60));\n      const offsetMins = pad(Math.abs(offset) % 60);\n      const timestamp = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())} ${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}${offsetSign}${offsetHours}:${offsetMins}`;\n      const threadContext = message.threadTs ? ` [in-thread:${message.threadTs}]` : \"\";\n      let userMessage = `[${timestamp}] [${message.userName || \"unknown\"}]${threadContext}: ${message.text}`;\n\n      const imageAttachments: ImageContent[] = [];\n      const nonImagePaths: string[] = [];\n\n      for (const a of message.attachments || []) {\n        // a.localPath is the path relative to the workspace\n        const fullPath = `${workspacePath}/${a.localPath}`;\n        const mimeType = getImageMimeType(a.localPath);\n\n        if (mimeType && existsSync(fullPath)) {\n          try {\n            imageAttachments.push({\n              type: \"image\",\n              mimeType,\n              data: readFileSync(fullPath).toString(\"base64\"),\n            });\n          } catch {\n            nonImagePaths.push(fullPath);\n          }\n        } else {\n          nonImagePaths.push(fullPath);\n        }\n      }\n\n      if (nonImagePaths.length > 0) {\n        userMessage += `\\n\\n<slack_attachments>\\n${nonImagePaths.join(\"\\n\")}\\n</slack_attachments>`;\n      }\n\n      // Debug: write context to last_prompt.jsonl\n      const debugContext = {\n        systemPrompt,\n        messages: session.messages,\n        newUserMessage: userMessage,\n        imageAttachmentCount: imageAttachments.length,\n      };\n      await writeFile(\n        join(conversationDir, \"last_prompt.jsonl\"),\n        JSON.stringify(debugContext, null, 2),\n      );\n      addLifecycleBreadcrumb(\"agent.prompt.sent\", {\n        provider: model.provider,\n        model: agentConfig.model,\n        channel_id: sessionConversationId,\n        session_id: sessionUuid,\n        attachment_count: message.attachments?.length ?? 0,\n        image_attachment_count: imageAttachments.length,\n      });\n\n      await session.prompt(\n        userMessage,\n        imageAttachments.length > 0 ? { images: imageAttachments } : undefined,\n      );\n\n      // Wait for queued messages\n      await queueChain;\n\n      // Handle error case - update main message and post error to thread\n      if (runState.stopReason === \"error\" && runState.errorMessage) {\n        try {\n          await responseCtx.replaceResponse(\"_Sorry, something went wrong_\");\n          // Split long error messages to avoid msg_too_long\n          const errorParts = splitForSlack(`_Error: ${runState.errorMessage}_`);\n          for (const part of errorParts) {\n            await responseCtx.respondInThread(part);\n          }\n        } catch (err) {\n          const errMsg = err instanceof Error ? err.message : String(err);\n          log.logWarning(\"Failed to post error message\", errMsg);\n        }\n      } else {\n        // Final message update\n        const messages = session.messages;\n        const lastAssistant = messages.filter((m) => m.role === \"assistant\").pop();\n        const finalText =\n          lastAssistant?.content\n            .filter((c): c is { type: \"text\"; text: string } => c.type === \"text\")\n            .map((c) => c.text)\n            .join(\"\\n\") || \"\";\n\n        // Check for [SILENT] marker - delete message and thread instead of posting\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        } else if (finalText.trim()) {\n          try {\n            const mainText =\n              finalText.length > SLACK_MAX_LENGTH\n                ? `${finalText.substring(0, SLACK_MAX_LENGTH - 50)}\\n\\n_(see thread for full response)_`\n                : finalText;\n            await responseCtx.replaceResponse(mainText);\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          }\n        }\n      }\n\n      // Log usage summary with context info\n      if (runState.totalUsage.cost.total > 0) {\n        // Get last non-aborted assistant message for context calculation\n        const messages = session.messages;\n        const lastAssistantMessage = messages\n          .slice()\n          .reverse()\n          .find((m) => m.role === \"assistant\" && (m as any).stopReason !== \"aborted\") as any;\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        // Run-level Sentry metrics\n        const { totalUsage } = runState;\n        const runMetricAttributes = metricAttributes({\n          provider: model.provider,\n          model: agentConfig.model,\n          channel_id: sessionConversationId,\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        // Split long summaries to avoid msg_too_long\n        const summaryParts = splitForSlack(summary);\n        for (const part of summaryParts) {\n          runState.queue!.enqueue(\n            () => responseCtx.respondInThread(part, { style: \"muted\" }),\n            \"usage summary\",\n          );\n        }\n        await queueChain;\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\n/**\n * Translate container path back to host path for file operations\n */\nfunction translateToHostPath(\n  containerPath: string,\n  conversationDir: string,\n  workspacePath: string,\n  conversationId: string,\n): string {\n  if (workspacePath === \"/workspace\") {\n    const prefix = `/workspace/${conversationId}/`;\n    if (containerPath.startsWith(prefix)) {\n      return join(conversationDir, containerPath.slice(prefix.length));\n    }\n    if (containerPath.startsWith(\"/workspace/\")) {\n      return join(conversationDir, \"..\", containerPath.slice(\"/workspace/\".length));\n    }\n  }\n  return containerPath;\n}\n"]}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EAEnB,YAAY,EACb,MAAM,cAAc,CAAC;AAKtB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAEjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAgB/C,MAAM,WAAW,WAAW;IAC1B,GAAG,CACD,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,KAAK,IAAI,IAAI,CAAC;IACd,6DAA6D;IAC7D,cAAc,IAAI;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACrE;AA4WD;;;;;;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,CAAC,EAAE,YAAY,EAC3B,YAAY,CAAC,EAAE,gBAAgB,EAC/B,WAAW,CAAC,EAAE,sBAAsB,GACnC,OAAO,CAAC,WAAW,CAAC,CAsxBtB","sourcesContent":["import { Agent, type AgentEvent } from \"@mariozechner/pi-agent-core\";\nimport { getModel, type ImageContent } from \"@mariozechner/pi-ai\";\nimport {\n  AgentSession,\n  AuthStorage,\n  convertToLlm,\n  DefaultResourceLoader,\n  formatSkillsForPrompt,\n  getAgentDir,\n  loadSkillsFromDir,\n  ModelRegistry,\n  SessionManager,\n  type Skill,\n} from \"@mariozechner/pi-coding-agent\";\nimport { existsSync, readFileSync } from \"fs\";\nimport { mkdir, readFile, writeFile } from \"fs/promises\";\nimport { homedir } from \"os\";\nimport { join } from \"path\";\nimport type {\n  ChatMessage,\n  ChatResponseContext,\n  ConversationKind,\n  PlatformInfo,\n} from \"./adapter.js\";\nimport { loadAgentConfig } from \"./config.js\";\nimport { createMamaSettingsManager, syncLogToSessionManager } from \"./context.js\";\nimport { ActorExecutionResolver } from \"./execution-resolver.js\";\nimport * as log from \"./log.js\";\nimport type { UserBindingStore } from \"./bindings.js\";\nimport type { DockerContainerManager } from \"./provisioner.js\";\nimport { createExecutor, type Executor, type SandboxConfig } from \"./sandbox.js\";\nimport { addLifecycleBreadcrumb, metricAttributes } from \"./sentry.js\";\nimport type { VaultManager } from \"./vault.js\";\nimport {\n  createManagedSessionFileAtPath,\n  extractSessionSuffix,\n  extractSessionUuid,\n  forkThreadSessionFile,\n  getChannelSessionDir,\n  getThreadSessionFile,\n  openManagedSession,\n  resolveChannelSessionFile,\n  resolveManagedSessionFile,\n  tryResolveThreadSession,\n} from \"./session-store.js\";\nimport { createMamaTools } from \"./tools/index.js\";\nimport * as Sentry from \"@sentry/node\";\n\nexport interface AgentRunner {\n  run(\n    message: ChatMessage,\n    responseCtx: ChatResponseContext,\n    platform: PlatformInfo,\n  ): Promise<{ stopReason: string; errorMessage?: string }>;\n  abort(): void;\n  /** Get current step info (tool name, label) for debugging */\n  getCurrentStep(): { toolName?: string; label?: string } | undefined;\n}\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\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 loadMamaSkills(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 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): string {\n  const conversationPath = `${workspacePath}/${conversationId}`;\n  const isContainer = sandboxConfig.type === \"container\" || sandboxConfig.type === \"image\";\n  const isImageSandbox = sandboxConfig.type === \"image\";\n  const isFirecracker = sandboxConfig.type === \"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 = isImageSandbox\n    ? `You are running inside a managed per-user container.\n- Bash working directory: / (use cd or absolute paths)\n- Install tools with the image's package manager\n- Your changes persist for this user's container until it is recreated`\n    : isContainer\n      ? `You are running inside a shared container.\n- Bash working directory: / (use cd or absolute paths)\n- Install tools with the container's package manager\n- Your changes persist across sessions`\n      : isFirecracker\n        ? `You are running inside a Firecracker microVM.\n- Bash working directory: / (use cd or absolute paths)\n- Install tools with: apt-get install <package> (Debian-based)\n- Your changes persist across sessions`\n        : `You are running directly on the host machine.\n- Bash working directory: ${process.cwd()}\n- Be careful with system modifications`;\n\n  return `You are mama, 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 history beyond your context, search log.jsonl (contains user messages and your final responses, but not tool results).\n- User messages include a \\`[in-thread:TS]\\` marker when sent from within a Slack thread (TS is the root message timestamp). Without this marker, the message is a top-level channel message.\n\n${platform.formattingGuide}\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\n## Workspace Layout\n${workspacePath}/\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                # Message history (no tool results)\n    ├── attachments/             # User-shared files\n    ├── scratch/                 # Your working directory\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 \\`${workspacePath}/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\nYou can schedule events that wake you up at specific times or when external things happen. Events are JSON files in \\`${workspacePath}/events/\\`.\n\n### Event Types\n\n**Immediate** - Triggers as soon as harness sees the file. Use in scripts/webhooks to signal external events.\n\\`\\`\\`json\n{\"type\": \"immediate\", \"platform\": \"${platform.name}\", \"conversationId\": \"${conversationId}\", \"conversationKind\": \"${conversationKind}\", \"userId\": \"${currentUserId ?? \"<requester userId>\"}\", \"text\": \"New GitHub issue opened\"}\n\\`\\`\\`\n\n**One-shot** - Triggers once at a specific time. Use for reminders.\n\\`\\`\\`json\n{\"type\": \"one-shot\", \"platform\": \"${platform.name}\", \"conversationId\": \"${conversationId}\", \"conversationKind\": \"${conversationKind}\", \"userId\": \"${currentUserId ?? \"<requester userId>\"}\", \"text\": \"Remind Mario about dentist\", \"at\": \"2025-12-15T09:00:00+01:00\"}\n\\`\\`\\`\n\n**Periodic** - Triggers on a cron schedule. Use for recurring tasks.\n\\`\\`\\`json\n{\"type\": \"periodic\", \"platform\": \"${platform.name}\", \"conversationId\": \"${conversationId}\", \"conversationKind\": \"${conversationKind}\", \"userId\": \"${currentUserId ?? \"<requester userId>\"}\", \"text\": \"Check inbox and summarize\", \"schedule\": \"0 9 * * 1-5\", \"timezone\": \"${Intl.DateTimeFormat().resolvedOptions().timeZone}\"}\n\\`\\`\\`\n\n### Cron Format\n\\`minute hour day-of-month month day-of-week\\`\n- \\`0 9 * * *\\` = daily at 9:00\n- \\`0 9 * * 1-5\\` = weekdays at 9:00\n- \\`30 14 * * 1\\` = Mondays at 14:30\n- \\`0 0 1 * *\\` = first of each month at midnight\n\n### Timezones\nAll \\`at\\` timestamps must include offset (e.g., \\`+01:00\\`). Periodic events use IANA timezone names. The harness runs in ${Intl.DateTimeFormat().resolvedOptions().timeZone}. When users mention times without timezone, assume ${Intl.DateTimeFormat().resolvedOptions().timeZone}.\n\n### Platform and Credential Routing\nSet \\`platform\\` to the target bot platform (\\`${platform.name}\\` for this conversation). When only one platform is running, omitting \\`platform\\` is allowed for backward compatibility, but include it by default to avoid ambiguity.\n\nSet \\`userId\\` to the platform userId of whoever asked for the event. When the event fires, tool execution routes using that user's vault selection in per-user modes. In \\`container:<name>\\`, events use the container's single shared vault.\n\nPrefer the \\`event\\` tool over manually writing JSON files; it fills \\`platform\\`, \\`conversationId\\`, \\`conversationKind\\`, and \\`userId\\` for the current conversation automatically.\n\n### Creating Events\nUse unique filenames to avoid overwriting existing events. Include a timestamp or random suffix:\n\\`\\`\\`bash\ncat > ${workspacePath}/events/dentist-reminder-$(date +%s).json << 'EOF'\n{\"type\": \"one-shot\", \"platform\": \"${platform.name}\", \"conversationId\": \"${conversationId}\", \"conversationKind\": \"${conversationKind}\", \"userId\": \"${currentUserId ?? \"<requester userId>\"}\", \"text\": \"Dentist tomorrow\", \"at\": \"2025-12-14T09:00:00+01:00\"}\nEOF\n\\`\\`\\`\nOr check if file exists first before creating.\n\n### Managing Events\n- List: \\`ls ${workspacePath}/events/\\`\n- View: \\`cat ${workspacePath}/events/foo.json\\`\n- Delete/cancel: \\`rm ${workspacePath}/events/foo.json\\`\n\n### When Events Trigger\nYou receive a message like:\n\\`\\`\\`\n[EVENT:dentist-reminder.json:one-shot:2025-12-14T09:00:00+01:00] Dentist tomorrow\n\\`\\`\\`\nImmediate and one-shot events auto-delete after triggering. Periodic events persist until you delete them.\n\n### Silent Completion\nFor periodic events where there's nothing to report, respond with just \\`[SILENT]\\` (no other text). This deletes the status message and posts nothing to the platform. Use this to avoid spamming the channel when periodic checks find nothing actionable.\n\n### Debouncing\nWhen writing programs that create immediate events (email watchers, webhook handlers, etc.), always debounce. If 50 emails arrive in a minute, don't create 50 immediate events. Instead collect events over a window and create ONE immediate event summarizing what happened, or just signal \"new activity, check inbox\" rather than per-item events. Or simpler: use a periodic event to check for new items every N minutes instead of immediate events.\n\n### Limits\nMaximum 5 events can be queued. Don't create excessive immediate or periodic events.\n\n## Memory\nWrite to MEMORY.md files to persist context across conversations.\n- Global (${workspacePath}/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 ${workspacePath}/SYSTEM.md to log all environment modifications:\n- Installed packages (apk add, npm install, 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).\n${isContainer ? \"Install jq: apk add jq\" : \"\"}\n${isFirecracker ? \"Install jq: apt-get install jq\" : \"\"}\n\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\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- 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\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\nfunction formatToolArgsForSlack(_toolName: string, args: Record<string, unknown>): string {\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(args)) {\n    if (key === \"label\") continue;\n\n    if (key === \"path\" && typeof value === \"string\") {\n      const offset = args.offset as number | undefined;\n      const limit = args.limit as number | undefined;\n      if (offset !== undefined && limit !== undefined) {\n        lines.push(`${value}:${offset}-${offset + limit}`);\n      } else {\n        lines.push(value);\n      }\n      continue;\n    }\n\n    if (key === \"offset\" || key === \"limit\") continue;\n\n    if (typeof value === \"string\") {\n      lines.push(value);\n    } else {\n      lines.push(JSON.stringify(value));\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n\n// ============================================================================\n// Agent runner\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  vaultManager?: VaultManager,\n  bindingStore?: UserBindingStore,\n  provisioner?: DockerContainerManager,\n): Promise<AgentRunner> {\n  const agentConfig = loadAgentConfig(workspaceDir);\n\n  // Initialize logger with settings from config\n  log.initLogger({\n    logFormat: agentConfig.logFormat,\n    logLevel: agentConfig.logLevel,\n  });\n\n  const executionResolver =\n    vaultManager &&\n    sandboxConfig.type !== \"host\" &&\n    (vaultManager.isEnabled() ||\n      !!bindingStore ||\n      sandboxConfig.type === \"container\" ||\n      sandboxConfig.type === \"image\")\n      ? new ActorExecutionResolver(sandboxConfig, vaultManager, bindingStore, provisioner)\n      : undefined;\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  };\n  const workspaceBase = conversationDir.replace(`/${conversationId}`, \"\");\n  const getWorkspacePath = () => executor.getWorkspacePath(workspaceBase);\n  let workspacePath = getWorkspacePath();\n\n  // Create tools (per-runner, with per-runner upload function setter)\n  const { tools, setUploadFunction, setEventContext } = createMamaTools(executor, workspaceDir);\n\n  // Resolve model from config\n  // Use 'as any' cast because agentConfig.provider/model are plain strings,\n  // while getModel() has constrained generic types for known providers.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const model = (getModel as any)(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 = loadMamaSkills(conversationDir, workspacePath);\n  const emptyPlatform: PlatformInfo = {\n    name: \"slack\",\n    formattingGuide: \"\",\n    channels: [],\n    users: [],\n  };\n  const systemPrompt = buildSystemPrompt(\n    workspacePath,\n    conversationId,\n    \"shared\",\n    undefined,\n    memory,\n    sandboxConfig,\n    emptyPlatform,\n    skills,\n  );\n\n  // Create session manager and settings manager\n  // Conversation sessions use {conversationDir}/sessions/current.\n  // Thread sessions use fixed files: {conversationDir}/sessions/{threadTs}.jsonl\n  const sessionDir = getChannelSessionDir(conversationDir);\n  const isThread = sessionKey.includes(\":\");\n\n  let sessionManager!: SessionManager;\n  let contextFile!: string;\n\n  if (isThread) {\n    const threadFile = getThreadSessionFile(conversationDir, sessionKey);\n    const existing = tryResolveThreadSession(threadFile);\n    if (existing) {\n      contextFile = existing;\n      sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);\n    } else {\n      const conversationSource = resolveChannelSessionFile(conversationDir);\n      if (conversationSource) {\n        try {\n          contextFile = forkThreadSessionFile(conversationSource, threadFile, conversationDir);\n          sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);\n        } catch {\n          contextFile = createManagedSessionFileAtPath(threadFile, conversationDir);\n          sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);\n        }\n      } else {\n        contextFile = createManagedSessionFileAtPath(threadFile, conversationDir);\n        sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);\n      }\n    }\n  } else {\n    // Direct/shared session: normal resolve\n    contextFile = resolveManagedSessionFile(sessionDir, conversationDir);\n    sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);\n  }\n  const sessionUuid = extractSessionUuid(contextFile);\n  // Used for Slack thread filtering — for non-Slack platforms this is effectively a no-op\n  const rootTs = extractSessionSuffix(sessionKey);\n  const settingsManager = createMamaSettingsManager(join(conversationDir, \"..\"));\n\n  // Create AuthStorage and ModelRegistry\n  // Auth stored outside workspace so agent can't access it\n  const authStorage = AuthStorage.create(join(homedir(), \".pi\", \"mama\", \"auth.json\"));\n  const modelRegistry = ModelRegistry.create(authStorage);\n\n  // Create agent\n  const agent = new Agent({\n    initialState: {\n      systemPrompt,\n      model,\n      thinkingLevel:\n        (agentConfig.thinkingLevel as \"off\" | \"low\" | \"medium\" | \"high\" | undefined) ?? \"off\",\n      tools,\n    },\n    convertToLlm,\n    getApiKey: async () => {\n      const key = await modelRegistry.getApiKeyForProvider(model.provider);\n      if (!key)\n        throw new Error(\n          `No API key for provider \"${model.provider}\". Set the appropriate environment variable or configure via auth.json`,\n        );\n      return key;\n    },\n  });\n\n  // Load existing messages\n  const loadedSession = sessionManager.buildSessionContext();\n  if (loadedSession.messages.length > 0) {\n    agent.state.messages = loadedSession.messages;\n    log.logInfo(\n      `[${conversationId}] Loaded ${loadedSession.messages.length} messages from context.jsonl`,\n    );\n  }\n\n  // Load extensions, skills, prompts, themes via DefaultResourceLoader\n  // This reads ~/.pi/agent/settings.json (packages, extensions enable/disable)\n  // and discovers resources from standard locations + npm/git packages.\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((e) => e.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\n  // Create AgentSession wrapper\n  const session = new AgentSession({\n    agent,\n    sessionManager,\n    settingsManager,\n    cwd: workspaceDir,\n    modelRegistry,\n    resourceLoader,\n    baseToolsOverride,\n  });\n\n  // Mutable per-run state - event handler references this\n  const runState = {\n    responseCtx: null as ChatResponseContext | null,\n    logCtx: null as {\n      conversationId: string;\n      userName?: string;\n      conversationName?: string;\n      sessionId?: string;\n    } | null,\n    queue: null as {\n      enqueue(fn: () => Promise<void>, errorContext: string): void;\n      enqueueMessage(\n        text: string,\n        target: \"main\" | \"thread\",\n        errorContext: string,\n        doLog?: boolean,\n      ): void;\n    } | null,\n    pendingTools: new Map<string, { toolName: string; args: unknown; startTime: number }>(),\n    totalUsage: {\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    llmCallCount: 0,\n    stopReason: \"stop\",\n    errorMessage: undefined as string | undefined,\n  };\n\n  // Subscribe to events ONCE\n  session.subscribe(async (event) => {\n    // Skip if no active run\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 agentEvent = event as AgentEvent & { type: \"tool_execution_start\" };\n      const args = agentEvent.args as { label?: string };\n      const label = args.label || agentEvent.toolName;\n\n      pendingTools.set(agentEvent.toolCallId, {\n        toolName: agentEvent.toolName,\n        args: agentEvent.args,\n        startTime: Date.now(),\n      });\n      addLifecycleBreadcrumb(\"agent.tool.started\", {\n        tool: agentEvent.toolName,\n        ...baseAttrs,\n      });\n\n      log.logToolStart(\n        logCtx,\n        agentEvent.toolName,\n        label,\n        agentEvent.args as Record<string, unknown>,\n      );\n      // Tool labels are omitted from the main message to reduce Slack noise.\n      // Tool execution details are still posted to the thread (see tool_execution_end).\n    } else if (event.type === \"tool_execution_end\") {\n      const agentEvent = event as AgentEvent & { type: \"tool_execution_end\" };\n      const resultStr = extractToolResultText(agentEvent.result);\n      const pending = pendingTools.get(agentEvent.toolCallId);\n      pendingTools.delete(agentEvent.toolCallId);\n\n      const durationMs = pending ? Date.now() - pending.startTime : 0;\n\n      Sentry.metrics.count(\"agent.tool.calls\", 1, {\n        attributes: metricAttributes({\n          tool: agentEvent.toolName,\n          error: String(agentEvent.isError),\n          ...baseAttrs,\n        }),\n      });\n      Sentry.metrics.distribution(\"agent.tool.duration\", durationMs, {\n        unit: \"millisecond\",\n        attributes: metricAttributes({\n          tool: agentEvent.toolName,\n          ...baseAttrs,\n        }),\n      });\n      addLifecycleBreadcrumb(\"agent.tool.completed\", {\n        tool: agentEvent.toolName,\n        error: agentEvent.isError,\n        duration_ms: durationMs,\n        ...baseAttrs,\n      });\n\n      if (agentEvent.isError) {\n        log.logToolError(logCtx, agentEvent.toolName, durationMs, resultStr);\n      } else {\n        log.logToolSuccess(logCtx, agentEvent.toolName, durationMs, resultStr);\n      }\n\n      // Post args + result to thread\n      const label = pending?.args ? (pending.args as { label?: string }).label : undefined;\n      const argsFormatted = pending\n        ? formatToolArgsForSlack(agentEvent.toolName, pending.args as Record<string, unknown>)\n        : \"(args not found)\";\n      const duration = (durationMs / 1000).toFixed(1);\n      let threadMessage = `*${agentEvent.isError ? \"✗\" : \"✓\"} ${agentEvent.toolName}*`;\n      if (label) threadMessage += `: ${label}`;\n      threadMessage += ` (${duration}s)\\n`;\n      if (argsFormatted) threadMessage += `\\`\\`\\`\\n${argsFormatted}\\n\\`\\`\\`\\n`;\n      threadMessage += `*Result:*\\n\\`\\`\\`\\n${resultStr}\\n\\`\\`\\``;\n\n      // Only post thread details for tools with meaningful output (bash, attach).\n      // Skip read/write/edit to reduce Slack noise — their results are in the log.\n      const quietTools = new Set([\"read\", \"write\", \"edit\"]);\n      if (!quietTools.has(agentEvent.toolName)) {\n        queue.enqueueMessage(threadMessage, \"thread\", \"tool result thread\", false);\n      }\n\n      if (agentEvent.isError) {\n        queue.enqueue(\n          () => responseCtx.respond(`_Error: ${truncate(resultStr, 200)}_`),\n          \"tool error\",\n        );\n      }\n    } else if (event.type === \"message_start\") {\n      const agentEvent = event as AgentEvent & { type: \"message_start\" };\n      if (agentEvent.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    } else if (event.type === \"message_end\") {\n      const agentEvent = event as AgentEvent & { type: \"message_end\" };\n      if (agentEvent.message.role === \"assistant\") {\n        const assistantMsg = agentEvent.message as any;\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          // Per-turn LLM metrics\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 content = agentEvent.message.content;\n        const thinkingParts: string[] = [];\n        const textParts: string[] = [];\n        for (const part of content) {\n          if (part.type === \"thinking\") {\n            thinkingParts.push((part as any).thinking);\n          } else if (part.type === \"text\") {\n            textParts.push((part as any).text);\n          }\n        }\n\n        const text = textParts.join(\"\\n\");\n\n        for (const thinking of thinkingParts) {\n          log.logThinking(logCtx, thinking);\n          queue.enqueueMessage(`_${thinking}_`, \"main\", \"thinking main\");\n          queue.enqueueMessage(`_${thinking}_`, \"thread\", \"thinking thread\", false);\n        }\n\n        if (text.trim()) {\n          log.logResponse(logCtx, text);\n          queue.enqueueMessage(text, \"main\", \"response main\");\n          // Only overflow to thread for texts that will be truncated in main\n          if (text.length > SLACK_MAX_LENGTH) {\n            queue.enqueueMessage(text, \"thread\", \"response thread\", false);\n          }\n        }\n      }\n    } else if (event.type === \"compaction_start\") {\n      log.logInfo(`Auto-compaction started (reason: ${(event as any).reason})`);\n      queue.enqueue(() => responseCtx.respond(\"_Compacting context..._\"), \"compaction start\");\n    } else if (event.type === \"compaction_end\") {\n      const compEvent = event as any;\n      if (compEvent.result) {\n        log.logInfo(`Auto-compaction complete: ${compEvent.result.tokensBefore} tokens compacted`);\n      } else if (compEvent.aborted) {\n        log.logInfo(\"Auto-compaction aborted\");\n      }\n    } else if (event.type === \"auto_retry_start\") {\n      const retryEvent = event as any;\n      log.logWarning(\n        `Retrying (${retryEvent.attempt}/${retryEvent.maxAttempts})`,\n        retryEvent.errorMessage,\n      );\n      queue.enqueue(\n        () =>\n          responseCtx.respond(`_Retrying (${retryEvent.attempt}/${retryEvent.maxAttempts})..._`),\n        \"retry\",\n      );\n    }\n  });\n\n  // Message limit constant\n  const SLACK_MAX_LENGTH = 40000;\n  const splitForSlack = (text: string): string[] => {\n    if (text.length <= SLACK_MAX_LENGTH) return [text];\n    const parts: string[] = [];\n    let remaining = text;\n    let partNum = 1;\n    while (remaining.length > 0) {\n      const chunk = remaining.substring(0, SLACK_MAX_LENGTH - 50);\n      remaining = remaining.substring(SLACK_MAX_LENGTH - 50);\n      const suffix = remaining.length > 0 ? `\\n_(continued ${partNum}...)_` : \"\";\n      parts.push(chunk + suffix);\n      partNum++;\n    }\n    return parts;\n  };\n\n  return {\n    async run(\n      message: ChatMessage,\n      responseCtx: ChatResponseContext,\n      platform: PlatformInfo,\n    ): Promise<{ stopReason: string; errorMessage?: string }> {\n      // Extract conversationId from sessionKey (format: \"conversationId:rootTs\" or just \"conversationId\")\n      const sessionConversation = message.sessionKey.split(\":\")[0];\n\n      // Ensure conversation directory exists\n      await mkdir(conversationDir, { recursive: true });\n\n      if (executionResolver) {\n        executionResolver.refresh();\n        activeExecutor = await executionResolver.resolve({\n          platform: platform.name,\n          userId: message.userId,\n        });\n        workspacePath = getWorkspacePath();\n      }\n\n      // Sync messages from log.jsonl that arrived while we were offline or busy\n      // Exclude the current message (it will be added via prompt())\n      // Default sync range is 10 days (handled by syncLogToSessionManager)\n      // Thread filter ensures only messages from this session's thread are synced\n      const threadFilter = message.sessionKey.includes(\":\")\n        ? { scope: \"thread\" as const, rootTs, threadTs: message.threadTs }\n        : { scope: \"top-level\" as const, rootTs };\n      const syncedCount = await syncLogToSessionManager(\n        sessionManager,\n        conversationDir,\n        message.id,\n        undefined,\n        threadFilter,\n      );\n      if (syncedCount > 0) {\n        log.logInfo(`[${conversationId}] Synced ${syncedCount} messages from log.jsonl`);\n      }\n\n      // Reload messages from context.jsonl\n      // This picks up any messages synced above\n      const reloadedSession = sessionManager.buildSessionContext();\n      if (reloadedSession.messages.length > 0) {\n        agent.state.messages = reloadedSession.messages;\n        log.logInfo(\n          `[${conversationId}] Reloaded ${reloadedSession.messages.length} messages from context`,\n        );\n      }\n\n      // Update system prompt with fresh memory, channel/user info, and skills\n      const memory = await getMemory(conversationDir);\n      const skills = loadMamaSkills(conversationDir, workspacePath);\n      const systemPrompt = buildSystemPrompt(\n        workspacePath,\n        conversationId,\n        message.conversationKind,\n        message.userId,\n        memory,\n        executor.getSandboxConfig(),\n        platform,\n        skills,\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\n      // Set up file upload function\n      setUploadFunction(async (filePath: string, title?: string) => {\n        const hostPath = translateToHostPath(\n          filePath,\n          conversationDir,\n          workspacePath,\n          conversationId,\n        );\n        await responseCtx.uploadFile(hostPath, title);\n      });\n\n      // Reset per-run state\n      runState.responseCtx = responseCtx;\n      runState.logCtx = {\n        conversationId: sessionConversation,\n        userName: message.userName,\n        conversationName: undefined,\n        sessionId: sessionUuid,\n      };\n      runState.pendingTools.clear();\n      runState.totalUsage = {\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      runState.llmCallCount = 0;\n      runState.stopReason = \"stop\";\n      runState.errorMessage = undefined;\n\n      // Create queue for this run\n      let queueChain = Promise.resolve();\n      runState.queue = {\n        enqueue(fn: () => Promise<void>, errorContext: string): void {\n          queueChain = queueChain.then(async () => {\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                // Split long error messages to avoid msg_too_long\n                const errParts = splitForSlack(`_Error: ${errMsg}_`);\n                for (const part of errParts) {\n                  await responseCtx.respondInThread(part);\n                }\n              } catch {\n                // Ignore\n              }\n            }\n          });\n        },\n        enqueueMessage(\n          text: string,\n          target: \"main\" | \"thread\",\n          errorContext: string,\n          _doLog = true,\n        ): void {\n          const parts = splitForSlack(text);\n          for (const part of parts) {\n            this.enqueue(\n              () =>\n                target === \"main\" ? responseCtx.respond(part) : responseCtx.respondInThread(part),\n              errorContext,\n            );\n          }\n        },\n      };\n\n      // Log context info\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      // Build user message with timestamp and username prefix\n      // Format: \"[YYYY-MM-DD HH:MM:SS+HH:MM] [username]: message\" so LLM knows when and who\n      const now = new Date();\n      const pad = (n: number) => n.toString().padStart(2, \"0\");\n      const offset = -now.getTimezoneOffset();\n      const offsetSign = offset >= 0 ? \"+\" : \"-\";\n      const offsetHours = pad(Math.floor(Math.abs(offset) / 60));\n      const offsetMins = pad(Math.abs(offset) % 60);\n      const timestamp = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())} ${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}${offsetSign}${offsetHours}:${offsetMins}`;\n      const threadContext = message.threadTs ? ` [in-thread:${message.threadTs}]` : \"\";\n      let userMessage = `[${timestamp}] [${message.userName || \"unknown\"}]${threadContext}: ${message.text}`;\n\n      const imageAttachments: ImageContent[] = [];\n      const nonImagePaths: string[] = [];\n\n      for (const a of message.attachments || []) {\n        // a.localPath is the path relative to the workspace.\n        const fullPath = `${workspacePath}/${a.localPath}`;\n        const mimeType = getImageMimeType(a.localPath);\n\n        if (mimeType && existsSync(fullPath)) {\n          try {\n            imageAttachments.push({\n              type: \"image\",\n              mimeType,\n              data: readFileSync(fullPath).toString(\"base64\"),\n            });\n          } catch {\n            nonImagePaths.push(fullPath);\n          }\n        } else {\n          nonImagePaths.push(fullPath);\n        }\n      }\n\n      if (nonImagePaths.length > 0) {\n        userMessage += `\\n\\n<slack_attachments>\\n${nonImagePaths.join(\"\\n\")}\\n</slack_attachments>`;\n      }\n\n      // Debug: write context to last_prompt.jsonl\n      const debugContext = {\n        systemPrompt,\n        messages: session.messages,\n        newUserMessage: userMessage,\n        imageAttachmentCount: imageAttachments.length,\n      };\n      await writeFile(\n        join(conversationDir, \"last_prompt.jsonl\"),\n        JSON.stringify(debugContext, null, 2),\n      );\n      addLifecycleBreadcrumb(\"agent.prompt.sent\", {\n        provider: model.provider,\n        model: agentConfig.model,\n        channel_id: sessionConversation,\n        session_id: sessionUuid,\n        attachment_count: message.attachments?.length ?? 0,\n        image_attachment_count: imageAttachments.length,\n      });\n\n      await session.prompt(\n        userMessage,\n        imageAttachments.length > 0 ? { images: imageAttachments } : undefined,\n      );\n\n      // Wait for queued messages\n      await queueChain;\n\n      // Handle error case - update main message and post error to thread\n      if (runState.stopReason === \"error\" && runState.errorMessage) {\n        try {\n          await responseCtx.replaceResponse(\"_Sorry, something went wrong_\");\n          // Split long error messages to avoid msg_too_long\n          const errorParts = splitForSlack(`_Error: ${runState.errorMessage}_`);\n          for (const part of errorParts) {\n            await responseCtx.respondInThread(part);\n          }\n        } catch (err) {\n          const errMsg = err instanceof Error ? err.message : String(err);\n          log.logWarning(\"Failed to post error message\", errMsg);\n        }\n      } else {\n        // Final message update\n        const messages = session.messages;\n        const lastAssistant = messages.filter((m) => m.role === \"assistant\").pop();\n        const finalText =\n          lastAssistant?.content\n            .filter((c): c is { type: \"text\"; text: string } => c.type === \"text\")\n            .map((c) => c.text)\n            .join(\"\\n\") || \"\";\n\n        // Check for [SILENT] marker - delete message and thread instead of posting\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        } else if (finalText.trim()) {\n          try {\n            const mainText =\n              finalText.length > SLACK_MAX_LENGTH\n                ? `${finalText.substring(0, SLACK_MAX_LENGTH - 50)}\\n\\n_(see thread for full response)_`\n                : finalText;\n            await responseCtx.replaceResponse(mainText);\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          }\n        }\n      }\n\n      // Log usage summary with context info\n      if (runState.totalUsage.cost.total > 0) {\n        // Get last non-aborted assistant message for context calculation\n        const messages = session.messages;\n        const lastAssistantMessage = messages\n          .slice()\n          .reverse()\n          .find((m) => m.role === \"assistant\" && (m as any).stopReason !== \"aborted\") as any;\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        // Run-level Sentry metrics\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        // Split long summaries to avoid msg_too_long\n        const summaryParts = splitForSlack(summary);\n        for (const part of summaryParts) {\n          runState.queue!.enqueue(\n            () => responseCtx.respondInThread(part, { style: \"muted\" }),\n            \"usage summary\",\n          );\n        }\n        await queueChain;\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\n/**\n * Translate container path back to host path for file operations\n */\nfunction translateToHostPath(\n  containerPath: string,\n  conversationDir: string,\n  workspacePath: string,\n  conversationId: string,\n): string {\n  if (workspacePath === \"/workspace\") {\n    const prefix = `/workspace/${conversationId}/`;\n    if (containerPath.startsWith(prefix)) {\n      return join(conversationDir, containerPath.slice(prefix.length));\n    }\n    if (containerPath.startsWith(\"/workspace/\")) {\n      return join(conversationDir, \"..\", containerPath.slice(\"/workspace/\".length));\n    }\n  }\n  return containerPath;\n}\n"]}

package/dist/agent.js

@@ -87,11 +87,12 @@ function loadMamaSkills(conversationDir, workspacePath) {
     }
     return Array.from(skillMap.values());
 }
-function buildSystemPrompt(workspacePath, conversationId, currentUserId, memory, sandboxConfig, platform, skills) {
+function buildSystemPrompt(workspacePath, conversationId, conversationKind, currentUserId, memory, sandboxConfig, platform, skills) {
     const conversationPath = `${workspacePath}/${conversationId}`;
     const isContainer = sandboxConfig.type === "container" || sandboxConfig.type === "image";
+    const isImageSandbox = sandboxConfig.type === "image";
     const isFirecracker = sandboxConfig.type === "firecracker";
-    // Format platform conversation mappings
+    // Format channel mappings
     const channelMappings = platform.channels.length > 0
         ? platform.channels.map((c) => `${c.id}\t#${c.name}`).join("\n")
         : "(no channels loaded)";
@@ -99,17 +100,22 @@ function buildSystemPrompt(workspacePath, conversationId, currentUserId, memory,
     const userMappings = platform.users.length > 0
         ? platform.users.map((u) => `${u.id}\t@${u.userName}\t${u.displayName}`).join("\n")
         : "(no users loaded)";
-    const envDescription = isContainer
-        ? `You are running inside a container (Docker runtime, Alpine Linux).
+    const envDescription = isImageSandbox
+        ? `You are running inside a managed per-user container.
 - Bash working directory: / (use cd or absolute paths)
-- Install tools with: apk add <package>
+- Install tools with the image's package manager
+- Your changes persist for this user's container until it is recreated`
+        : isContainer
+            ? `You are running inside a shared container.
+- Bash working directory: / (use cd or absolute paths)
+- Install tools with the container's package manager
 - Your changes persist across sessions`
-        : isFirecracker
-            ? `You are running inside a Firecracker microVM.
+            : isFirecracker
+                ? `You are running inside a Firecracker microVM.
 - Bash working directory: / (use cd or absolute paths)
 - Install tools with: apt-get install <package> (Debian-based)
 - Your changes persist across sessions`
-            : `You are running directly on the host machine.
+                : `You are running directly on the host machine.
 - Bash working directory: ${process.cwd()}
 - Be careful with system modifications`;
     return `You are mama, a ${platform.name} bot assistant. Be concise. No emojis.
@@ -134,7 +140,7 @@ ${envDescription}
 
 ## Workspace Layout
 ${workspacePath}/
-├── MEMORY.md                    # Global memory (all channels)
+├── MEMORY.md                    # Global memory (all conversations)
 ├── skills/                      # Global CLI tools you create
 └── ${conversationId}/           # This conversation
     ├── MEMORY.md                # Conversation-specific memory
@@ -174,21 +180,19 @@ You can schedule events that wake you up at specific times or when external thin
 
 **Immediate** - Triggers as soon as harness sees the file. Use in scripts/webhooks to signal external events.
 \`\`\`json
-{"type": "immediate", "platform": "${platform.name}", "channelId": "${conversationId}", "userId": "<requester userId>", "text": "New GitHub issue opened"}
+{"type": "immediate", "platform": "${platform.name}", "conversationId": "${conversationId}", "conversationKind": "${conversationKind}", "userId": "${currentUserId ?? "<requester userId>"}", "text": "New GitHub issue opened"}
 \`\`\`
 
 **One-shot** - Triggers once at a specific time. Use for reminders.
 \`\`\`json
-{"type": "one-shot", "platform": "${platform.name}", "channelId": "${conversationId}", "userId": "<requester userId>", "text": "Remind Mario about dentist", "at": "2025-12-15T09:00:00+01:00"}
+{"type": "one-shot", "platform": "${platform.name}", "conversationId": "${conversationId}", "conversationKind": "${conversationKind}", "userId": "${currentUserId ?? "<requester userId>"}", "text": "Remind Mario about dentist", "at": "2025-12-15T09:00:00+01:00"}
 \`\`\`
 
 **Periodic** - Triggers on a cron schedule. Use for recurring tasks.
 \`\`\`json
-{"type": "periodic", "platform": "${platform.name}", "channelId": "${conversationId}", "userId": "<requester userId>", "text": "Check inbox and summarize", "schedule": "0 9 * * 1-5", "timezone": "${Intl.DateTimeFormat().resolvedOptions().timeZone}"}
+{"type": "periodic", "platform": "${platform.name}", "conversationId": "${conversationId}", "conversationKind": "${conversationKind}", "userId": "${currentUserId ?? "<requester userId>"}", "text": "Check inbox and summarize", "schedule": "0 9 * * 1-5", "timezone": "${Intl.DateTimeFormat().resolvedOptions().timeZone}"}
 \`\`\`
 
-Set \`userId\` to the platform userId of whoever asked for the event (look it up in the user mappings above). When the event fires, tool execution will route to the sandbox vault selection for that user so the right credentials are available. In shared container mode, all events use the container's single shared vault.
-
 ### Cron Format
 \`minute hour day-of-month month day-of-week\`
 - \`0 9 * * *\` = daily at 9:00
@@ -199,23 +203,18 @@ Set \`userId\` to the platform userId of whoever asked for the event (look it up
 ### Timezones
 All \`at\` timestamps must include offset (e.g., \`+01:00\`). Periodic events use IANA timezone names. The harness runs in ${Intl.DateTimeFormat().resolvedOptions().timeZone}. When users mention times without timezone, assume ${Intl.DateTimeFormat().resolvedOptions().timeZone}.
 
-### Platform Routing
+### Platform and Credential Routing
 Set \`platform\` to the target bot platform (\`${platform.name}\` for this conversation). When only one platform is running, omitting \`platform\` is allowed for backward compatibility, but include it by default to avoid ambiguity.
 
-### Creating Events
-Prefer the \`event\` tool. It automatically writes to the correct events directory and fills the current \`platform\`, \`channelId\`, and requester \`userId\`.
-Do not use \`bash\` or \`write\` to hand-create JSON files in \`/events\` unless the user explicitly asks for manual file editing.
+Set \`userId\` to the platform userId of whoever asked for the event. When the event fires, tool execution routes using that user's vault selection in per-user modes. In \`container:<name>\`, events use the container's single shared vault.
 
-Current conversation defaults:
-- \`platform\`: \`${platform.name}\`
-- \`channelId\`: \`${conversationId}\`
-- \`userId\`: \`${currentUserId ?? "unknown"}\`
+Prefer the \`event\` tool over manually writing JSON files; it fills \`platform\`, \`conversationId\`, \`conversationKind\`, and \`userId\` for the current conversation automatically.
 
-Manual file creation is fallback only:
+### Creating Events
 Use unique filenames to avoid overwriting existing events. Include a timestamp or random suffix:
 \`\`\`bash
 cat > ${workspacePath}/events/dentist-reminder-$(date +%s).json << 'EOF'
-{"type": "one-shot", "platform": "${platform.name}", "channelId": "${conversationId}", "userId": "<requester userId>", "text": "Dentist tomorrow", "at": "2025-12-14T09:00:00+01:00"}
+{"type": "one-shot", "platform": "${platform.name}", "conversationId": "${conversationId}", "conversationKind": "${conversationKind}", "userId": "${currentUserId ?? "<requester userId>"}", "text": "Dentist tomorrow", "at": "2025-12-14T09:00:00+01:00"}
 EOF
 \`\`\`
 Or check if file exists first before creating.
@@ -343,24 +342,25 @@ function formatToolArgsForSlack(_toolName, args) {
 // Agent runner
 // ============================================================================
 /**
- * Create a new AgentRunner for a conversation.
+ * Create a new AgentRunner for a channel.
  * Sets up the session and subscribes to events once.
  *
- * Runner caching is handled by the caller (conversationStates in main.ts).
+ * Runner caching is handled by the caller (channelStates in main.ts).
  * This is a stateless factory function.
  */
-export async function createRunner(sandboxConfig, sessionKey, conversationId, conversationDir, workspaceDir, vaultManager, bindingStore, provisioner, stateDir) {
-    const agentConfig = loadAgentConfig(stateDir ?? workspaceDir);
+export async function createRunner(sandboxConfig, sessionKey, conversationId, conversationDir, workspaceDir, vaultManager, bindingStore, provisioner) {
+    const agentConfig = loadAgentConfig(workspaceDir);
     // Initialize logger with settings from config
     log.initLogger({
         logFormat: agentConfig.logFormat,
         logLevel: agentConfig.logLevel,
     });
     const executionResolver = vaultManager &&
+        sandboxConfig.type !== "host" &&
         (vaultManager.isEnabled() ||
             !!bindingStore ||
-            sandboxConfig.type === "image" ||
-            sandboxConfig.type === "container")
+            sandboxConfig.type === "container" ||
+            sandboxConfig.type === "image")
         ? new ActorExecutionResolver(sandboxConfig, vaultManager, bindingStore, provisioner)
         : undefined;
     let activeExecutor = executionResolver !== undefined
@@ -378,7 +378,6 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
         },
     };
     const workspaceBase = conversationDir.replace(`/${conversationId}`, "");
-    // Compute workspace path from the current executor. This may change per run.
     const getWorkspacePath = () => executor.getWorkspacePath(workspaceBase);
     let workspacePath = getWorkspacePath();
     // Create tools (per-runner, with per-runner upload function setter)
@@ -397,45 +396,45 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
         channels: [],
         users: [],
     };
-    const systemPrompt = buildSystemPrompt(workspacePath, conversationId, undefined, memory, sandboxConfig, emptyPlatform, skills);
-    // Create session manager and settings manager.
-    // Top-level conversation sessions use {conversationDir}/sessions/current.
-    // Thread sessions use fixed files: {conversationDir}/sessions/{threadTs}.jsonl.
+    const systemPrompt = buildSystemPrompt(workspacePath, conversationId, "shared", undefined, memory, sandboxConfig, emptyPlatform, skills);
+    // Create session manager and settings manager
+    // Conversation sessions use {conversationDir}/sessions/current.
+    // Thread sessions use fixed files: {conversationDir}/sessions/{threadTs}.jsonl
     const sessionDir = getChannelSessionDir(conversationDir);
     const isThread = sessionKey.includes(":");
     let sessionManager;
-    let sessionFile;
+    let contextFile;
     if (isThread) {
         const threadFile = getThreadSessionFile(conversationDir, sessionKey);
         const existing = tryResolveThreadSession(threadFile);
         if (existing) {
-            sessionFile = existing;
-            sessionManager = openManagedSession(sessionFile, sessionDir, conversationDir);
+            contextFile = existing;
+            sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);
         }
         else {
             const conversationSource = resolveChannelSessionFile(conversationDir);
             if (conversationSource) {
                 try {
-                    sessionFile = forkThreadSessionFile(conversationSource, threadFile, conversationDir);
-                    sessionManager = openManagedSession(sessionFile, sessionDir, conversationDir);
+                    contextFile = forkThreadSessionFile(conversationSource, threadFile, conversationDir);
+                    sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);
                 }
                 catch {
-                    sessionFile = createManagedSessionFileAtPath(threadFile, conversationDir);
-                    sessionManager = openManagedSession(sessionFile, sessionDir, conversationDir);
+                    contextFile = createManagedSessionFileAtPath(threadFile, conversationDir);
+                    sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);
                 }
             }
             else {
-                sessionFile = createManagedSessionFileAtPath(threadFile, conversationDir);
-                sessionManager = openManagedSession(sessionFile, sessionDir, conversationDir);
+                contextFile = createManagedSessionFileAtPath(threadFile, conversationDir);
+                sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);
             }
         }
     }
     else {
-        // Top-level conversation session: resolve the current session file.
-        sessionFile = resolveManagedSessionFile(sessionDir, conversationDir);
-        sessionManager = openManagedSession(sessionFile, sessionDir, conversationDir);
+        // Direct/shared session: normal resolve
+        contextFile = resolveManagedSessionFile(sessionDir, conversationDir);
+        sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);
     }
-    const sessionUuid = extractSessionUuid(sessionFile);
+    const sessionUuid = extractSessionUuid(contextFile);
     // Used for Slack thread filtering — for non-Slack platforms this is effectively a no-op
     const rootTs = extractSessionSuffix(sessionKey);
     const settingsManager = createMamaSettingsManager(join(conversationDir, ".."));
@@ -463,7 +462,7 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
     const loadedSession = sessionManager.buildSessionContext();
     if (loadedSession.messages.length > 0) {
         agent.state.messages = loadedSession.messages;
-        log.logInfo(`[${conversationId}] Loaded ${loadedSession.messages.length} messages from session file`);
+        log.logInfo(`[${conversationId}] Loaded ${loadedSession.messages.length} messages from context.jsonl`);
     }
     // Load extensions, skills, prompts, themes via DefaultResourceLoader
     // This reads ~/.pi/agent/settings.json (packages, extensions enable/disable)
@@ -731,13 +730,9 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
     return {
         async run(message, responseCtx, platform) {
             // Extract conversationId from sessionKey (format: "conversationId:rootTs" or just "conversationId")
-            const sessionConversationId = message.sessionKey.split(":")[0];
-            // Ensure the conversation directory exists
+            const sessionConversation = message.sessionKey.split(":")[0];
+            // Ensure conversation directory exists
             await mkdir(conversationDir, { recursive: true });
-            // Refresh vault config and clear executor cache so credential changes
-            // (env file updates, vault.json edits, token rotations) take effect.
-            // Then set the active actor BEFORE building system prompt, so workspacePath
-            // reflects the actor's sandbox type.
             if (executionResolver) {
                 executionResolver.refresh();
                 activeExecutor = await executionResolver.resolve({
@@ -757,35 +752,33 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
             if (syncedCount > 0) {
                 log.logInfo(`[${conversationId}] Synced ${syncedCount} messages from log.jsonl`);
             }
-            // Reload messages from the session file.
-            // This picks up any messages synced above.
+            // Reload messages from context.jsonl
+            // This picks up any messages synced above
             const reloadedSession = sessionManager.buildSessionContext();
             if (reloadedSession.messages.length > 0) {
                 agent.state.messages = reloadedSession.messages;
                 log.logInfo(`[${conversationId}] Reloaded ${reloadedSession.messages.length} messages from context`);
             }
             // Update system prompt with fresh memory, channel/user info, and skills
-            // Use the actual executor's sandbox config, not the initial config,
-            // to ensure accurate environment description for the model
             const memory = await getMemory(conversationDir);
             const skills = loadMamaSkills(conversationDir, workspacePath);
-            const actualSandboxConfig = executor.getSandboxConfig();
-            const systemPrompt = buildSystemPrompt(workspacePath, conversationId, message.userId, memory, actualSandboxConfig, platform, skills);
+            const systemPrompt = buildSystemPrompt(workspacePath, conversationId, message.conversationKind, message.userId, memory, executor.getSandboxConfig(), platform, skills);
             session.agent.state.systemPrompt = systemPrompt;
-            // Set up file upload function
-            setUploadFunction(async (filePath, title) => {
-                const hostPath = translateToHostPath(filePath, conversationDir, workspacePath, conversationId);
-                await responseCtx.uploadFile(hostPath, title);
-            });
             setEventContext({
                 platform: platform.name,
                 conversationId,
+                conversationKind: message.conversationKind,
                 userId: message.userId,
             });
+            // Set up file upload function
+            setUploadFunction(async (filePath, title) => {
+                const hostPath = translateToHostPath(filePath, conversationDir, workspacePath, conversationId);
+                await responseCtx.uploadFile(hostPath, title);
+            });
             // Reset per-run state
             runState.responseCtx = responseCtx;
             runState.logCtx = {
-                conversationId: sessionConversationId,
+                conversationId: sessionConversation,
                 userName: message.userName,
                 conversationName: undefined,
                 sessionId: sessionUuid,
@@ -849,7 +842,7 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
             const imageAttachments = [];
             const nonImagePaths = [];
             for (const a of message.attachments || []) {
-                // a.localPath is the path relative to the workspace
+                // a.localPath is the path relative to the workspace.
                 const fullPath = `${workspacePath}/${a.localPath}`;
                 const mimeType = getImageMimeType(a.localPath);
                 if (mimeType && existsSync(fullPath)) {
@@ -882,7 +875,7 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
             addLifecycleBreadcrumb("agent.prompt.sent", {
                 provider: model.provider,
                 model: agentConfig.model,
-                channel_id: sessionConversationId,
+                channel_id: sessionConversation,
                 session_id: sessionUuid,
                 attachment_count: message.attachments?.length ?? 0,
                 image_attachment_count: imageAttachments.length,
@@ -957,7 +950,7 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
                 const runMetricAttributes = metricAttributes({
                     provider: model.provider,
                     model: agentConfig.model,
-                    channel_id: sessionConversationId,
+                    channel_id: sessionConversation,
                     session_id: sessionUuid,
                     stop_reason: runState.stopReason,
                     llm_calls: runState.llmCallCount,