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

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"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"]}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EAGnB,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;AAC/C,OAAO,EAIL,KAAK,oBAAoB,EAE1B,MAAM,oBAAoB,CAAC;AAI5B,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;AA0WD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,oBAAoB,EAClC,YAAY,CAAC,EAAE,YAAY,EAC3B,YAAY,CAAC,EAAE,gBAAgB,EAC/B,WAAW,CAAC,EAAE,sBAAsB,GACnC,OAAO,CAAC,WAAW,CAAC,CAssBtB","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  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  ChatToolResult,\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  extractSessionSuffix,\n  extractSessionUuid,\n  openManagedSession,\n  type ResolvedSessionScope,\n  type ThreadRootMessage,\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\nfunction buildThreadSessionName(message: ThreadRootMessage | null): string | undefined {\n  const text = message?.text?.trim();\n  if (!text) return undefined;\n  const userLabel = message?.userName || message?.user || \"unknown\";\n  return `[${userLabel}]: ${text}`;\n}\n\nasync function getMemory(conversationDir: string): Promise<string> {\n  const parts: string[] = [];\n\n  // Read workspace-level memory (shared across all conversations)\n  const workspaceMemoryPath = join(conversationDir, \"..\", \"MEMORY.md\");\n  if (existsSync(workspaceMemoryPath)) {\n    try {\n      const content = (await readFile(workspaceMemoryPath, \"utf-8\")).trim();\n      if (content) {\n        parts.push(`### Global Workspace Memory\\n${content}`);\n      }\n    } catch (error) {\n      log.logWarning(\"Failed to read workspace memory\", `${workspaceMemoryPath}: ${error}`);\n    }\n  }\n\n  // Read conversation-specific memory\n  const conversationMemoryPath = join(conversationDir, \"MEMORY.md\");\n  if (existsSync(conversationMemoryPath)) {\n    try {\n      const content = (await readFile(conversationMemoryPath, \"utf-8\")).trim();\n      if (content) {\n        parts.push(`### Conversation-Specific Memory\\n${content}`);\n      }\n    } catch (error) {\n      log.logWarning(\"Failed to read conversation memory\", `${conversationMemoryPath}: ${error}`);\n    }\n  }\n\n  if (parts.length === 0) {\n    return \"(no working memory yet)\";\n  }\n\n  return parts.join(\"\\n\\n\");\n}\n\nfunction 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 human-readable history beyond your context, search \\`log.jsonl\\` (contains user messages and your final responses, but not tool results).\n- Structured session history with tool results lives in \\`${conversationPath}/sessions/\\`.\n- The active top-level session is selected by \\`${conversationPath}/sessions/current\\`, which points to a timestamped \\`.jsonl\\` file in the same directory.\n- Scoped/thread sessions use fixed files at \\`${conversationPath}/sessions/<scope_id>.jsonl\\` (for example \\`${conversationPath}/sessions/1777386320.800769.jsonl\\`).\n- User messages include a \\`[in-thread:TS]\\` marker when sent from within a platform thread/reply (TS is the thread or parent message identifier). Without this marker, the message is a top-level conversation message.\n\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                # Human-readable message history (no tool results)\n    ├── sessions/                # Structured session history used for context reconstruction\n    │   ├── current              # Active top-level session pointer\n    │   ├── <timestamp>_<id>.jsonl  # Top-level session files\n    │   └── <scope_id>.jsonl        # Scoped thread/reply session files\n    ├── attachments/             # User-shared files\n    ├── scratch/                 # 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). Include it explicitly 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 (apt install, npm install, uv pip install)\n- Environment variables set\n- Config files modified (~/.gitconfig, cron jobs, etc.)\n- Skill dependencies installed\n\nUpdate this file whenever you modify the environment. On fresh container, read it first to restore your setup.\n\n## Log Queries (for older history)\nFormat: \\`{\"date\":\"...\",\"ts\":\"...\",\"user\":\"...\",\"userName\":\"...\",\"text\":\"...\",\"isBot\":false}\\`\nThe log contains user messages and your final responses (not tool calls/results).\nUse \\`log.jsonl\\` for quick grep-style history. Use \\`${conversationPath}/sessions/\\` when you need structured turns, tool outputs, or branch lineage.\n${isContainer ? \"Install jq: apt-get install 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# Inspect top-level session pointer and available session files\ncat sessions/current\nls -1 sessions/\n\\`\\`\\`\n\n## Tools\n- bash: Run shell commands (primary tool). Install packages as needed.\n- read: Read files\n- write: Create/overwrite files\n- edit: Surgical file edits\n- 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\n// Tools whose output is interesting in the structured session log but too noisy\n// to surface as a per-tool diagnostic to the user.\nconst QUIET_TOOLS = new Set([\"read\", \"write\", \"edit\"]);\n\n// Cap raw tool output before handing it to adapters. Bash output can be MB; without\n// this each adapter's splitter would fan it out into many sequential platform posts.\nconst TOOL_RESULT_DIAGNOSTIC_CAP = 8000;\n\nfunction extractToolResultText(result: unknown): string {\n  if (typeof result === \"string\") {\n    return result;\n  }\n\n  if (\n    result &&\n    typeof result === \"object\" &&\n    \"content\" in result &&\n    Array.isArray((result as { content: unknown }).content)\n  ) {\n    const content = (result as { content: Array<{ type: string; text?: string }> }).content;\n    const textParts: string[] = [];\n    for (const part of content) {\n      if (part.type === \"text\" && part.text) {\n        textParts.push(part.text);\n      }\n    }\n    if (textParts.length > 0) {\n      return textParts.join(\"\\n\");\n    }\n  }\n\n  return JSON.stringify(result);\n}\n\n// ============================================================================\n// 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  sessionScope: ResolvedSessionScope,\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: \"chat\",\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. Top-level/private sessions\n  // use the conversation's current pointer; scoped sessions use fixed files.\n  // Platform-specific branch/fork behavior is resolved before runner creation.\n  const isThread = sessionKey.includes(\":\");\n  const rootTs = extractSessionSuffix(sessionKey);\n  const { sessionDir, contextFile, threadRootMessage } = sessionScope;\n  const sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);\n  const threadSessionName = buildThreadSessionName(threadRootMessage);\n  if (isThread && threadSessionName && sessionManager.getSessionName() !== threadSessionName) {\n    sessionManager.appendSessionInfo(threadSessionName);\n  }\n\n  const sessionUuid = extractSessionUuid(contextFile);\n  const 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    } | 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    } 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      if (!QUIET_TOOLS.has(agentEvent.toolName)) {\n        const toolResult: ChatToolResult = {\n          toolName: agentEvent.toolName,\n          label: pending?.args ? (pending.args as { label?: string }).label : undefined,\n          args: pending?.args as Record<string, unknown> | undefined,\n          result: truncate(resultStr, TOOL_RESULT_DIAGNOSTIC_CAP),\n          isError: agentEvent.isError,\n          durationMs,\n        };\n        queue.enqueue(() => responseCtx.respondToolResult(toolResult), \"tool result diagnostic\");\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.enqueue(() => responseCtx.respond(`_${thinking}_`), \"thinking main\");\n          queue.enqueue(\n            () => responseCtx.respondDiagnostic(`_${thinking}_`),\n            \"thinking diagnostic\",\n          );\n        }\n\n        if (text.trim()) {\n          log.logResponse(logCtx, text);\n          queue.enqueue(() => responseCtx.respond(text), \"response main\");\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  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        sessionKey: message.sessionKey,\n        // For Slack scheduled events, preserve thread targeting only when the\n        // request was created inside an existing thread. Top-level reminders\n        // should come back as top-level messages.\n        threadTs: message.threadTs,\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                await responseCtx.respondDiagnostic(`Error: ${errMsg}`, { style: \"error\" });\n              } catch {\n                // Ignore\n              }\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          await responseCtx.respondDiagnostic(`Error: ${runState.errorMessage}`, {\n            style: \"error\",\n          });\n        } catch (err) {\n          const errMsg = err instanceof Error ? err.message : String(err);\n          log.logWarning(\"Failed to post error message\", errMsg);\n        }\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            await responseCtx.replaceResponse(finalText);\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        if (platform.diagnostics?.showUsageSummary === true) {\n          runState.queue!.enqueue(\n            () => responseCtx.respondDiagnostic(summary, { style: \"muted\" }),\n            \"usage summary\",\n          );\n          await queueChain;\n        }\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

@@ -11,7 +11,7 @@ import { ActorExecutionResolver } from "./execution-resolver.js";
 import * as log from "./log.js";
 import { createExecutor } from "./sandbox.js";
 import { addLifecycleBreadcrumb, metricAttributes } from "./sentry.js";
-import { createManagedSessionFileAtPath, extractSessionSuffix, extractSessionUuid, forkThreadSessionFile, getChannelSessionDir, getThreadSessionFile, openManagedSession, resolveChannelSessionFile, resolveManagedSessionFile, tryResolveThreadSession, } from "./session-store.js";
+import { extractSessionSuffix, extractSessionUuid, openManagedSession, } from "./session-store.js";
 import { createMamaTools } from "./tools/index.js";
 import * as Sentry from "@sentry/node";
 const IMAGE_MIME_TYPES = {
@@ -24,6 +24,13 @@ const IMAGE_MIME_TYPES = {
 function getImageMimeType(filename) {
     return IMAGE_MIME_TYPES[filename.toLowerCase().split(".").pop() || ""];
 }
+function buildThreadSessionName(message) {
+    const text = message?.text?.trim();
+    if (!text)
+        return undefined;
+    const userLabel = message?.userName || message?.user || "unknown";
+    return `[${userLabel}]: ${text}`;
+}
 async function getMemory(conversationDir) {
     const parts = [];
     // Read workspace-level memory (shared across all conversations)
@@ -123,8 +130,11 @@ function buildSystemPrompt(workspacePath, conversationId, conversationKind, curr
 ## Context
 - For current date/time, use: date
 - You have access to previous conversation context including tool results from prior turns.
-- For older history beyond your context, search log.jsonl (contains user messages and your final responses, but not tool results).
-- 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.
+- For older human-readable history beyond your context, search \`log.jsonl\` (contains user messages and your final responses, but not tool results).
+- Structured session history with tool results lives in \`${conversationPath}/sessions/\`.
+- The active top-level session is selected by \`${conversationPath}/sessions/current\`, which points to a timestamped \`.jsonl\` file in the same directory.
+- Scoped/thread sessions use fixed files at \`${conversationPath}/sessions/<scope_id>.jsonl\` (for example \`${conversationPath}/sessions/1777386320.800769.jsonl\`).
+- User messages include a \`[in-thread:TS]\` marker when sent from within a platform thread/reply (TS is the thread or parent message identifier). Without this marker, the message is a top-level conversation message.
 
 ${platform.formattingGuide}
 
@@ -144,7 +154,11 @@ ${workspacePath}/
 ├── skills/                      # Global CLI tools you create
 └── ${conversationId}/           # This conversation
     ├── MEMORY.md                # Conversation-specific memory
-    ├── log.jsonl                # Message history (no tool results)
+    ├── log.jsonl                # Human-readable message history (no tool results)
+    ├── sessions/                # Structured session history used for context reconstruction
+    │   ├── current              # Active top-level session pointer
+    │   ├── <timestamp>_<id>.jsonl  # Top-level session files
+    │   └── <scope_id>.jsonl        # Scoped thread/reply session files
     ├── attachments/             # User-shared files
     ├── scratch/                 # Your working directory
     └── skills/                  # Conversation-specific tools
@@ -204,7 +218,7 @@ You can schedule events that wake you up at specific times or when external thin
 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 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.
+Set \`platform\` to the target bot platform (\`${platform.name}\` for this conversation). Include it explicitly to avoid ambiguity.
 
 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.
 
@@ -251,7 +265,7 @@ ${memory}
 
 ## System Configuration Log
 Maintain ${workspacePath}/SYSTEM.md to log all environment modifications:
-- Installed packages (apk add, npm install, pip install)
+- Installed packages (apt install, npm install, uv pip install)
 - Environment variables set
 - Config files modified (~/.gitconfig, cron jobs, etc.)
 - Skill dependencies installed
@@ -261,7 +275,8 @@ Update this file whenever you modify the environment. On fresh container, read i
 ## Log Queries (for older history)
 Format: \`{"date":"...","ts":"...","user":"...","userName":"...","text":"...","isBot":false}\`
 The log contains user messages and your final responses (not tool calls/results).
-${isContainer ? "Install jq: apk add jq" : ""}
+Use \`log.jsonl\` for quick grep-style history. Use \`${conversationPath}/sessions/\` when you need structured turns, tool outputs, or branch lineage.
+${isContainer ? "Install jq: apt-get install jq" : ""}
 ${isFirecracker ? "Install jq: apt-get install jq" : ""}
 
 \`\`\`bash
@@ -273,6 +288,10 @@ grep -i "topic" log.jsonl | jq -c '{date: .date[0:19], user: (.userName // .user
 
 # Messages from specific user
 grep '"userName":"mario"' log.jsonl | tail -20 | jq -c '{date: .date[0:19], text}'
+
+# Inspect top-level session pointer and available session files
+cat sessions/current
+ls -1 sessions/
 \`\`\`
 
 ## Tools
@@ -290,6 +309,12 @@ function truncate(text, maxLen) {
         return text;
     return `${text.substring(0, maxLen - 3)}...`;
 }
+// Tools whose output is interesting in the structured session log but too noisy
+// to surface as a per-tool diagnostic to the user.
+const QUIET_TOOLS = new Set(["read", "write", "edit"]);
+// Cap raw tool output before handing it to adapters. Bash output can be MB; without
+// this each adapter's splitter would fan it out into many sequential platform posts.
+const TOOL_RESULT_DIAGNOSTIC_CAP = 8000;
 function extractToolResultText(result) {
     if (typeof result === "string") {
         return result;
@@ -311,33 +336,6 @@ function extractToolResultText(result) {
     }
     return JSON.stringify(result);
 }
-function formatToolArgsForSlack(_toolName, args) {
-    const lines = [];
-    for (const [key, value] of Object.entries(args)) {
-        if (key === "label")
-            continue;
-        if (key === "path" && typeof value === "string") {
-            const offset = args.offset;
-            const limit = args.limit;
-            if (offset !== undefined && limit !== undefined) {
-                lines.push(`${value}:${offset}-${offset + limit}`);
-            }
-            else {
-                lines.push(value);
-            }
-            continue;
-        }
-        if (key === "offset" || key === "limit")
-            continue;
-        if (typeof value === "string") {
-            lines.push(value);
-        }
-        else {
-            lines.push(JSON.stringify(value));
-        }
-    }
-    return lines.join("\n");
-}
 // ============================================================================
 // Agent runner
 // ============================================================================
@@ -348,7 +346,7 @@ function formatToolArgsForSlack(_toolName, args) {
  * 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) {
+export async function createRunner(sandboxConfig, sessionKey, conversationId, conversationDir, workspaceDir, sessionScope, vaultManager, bindingStore, provisioner) {
     const agentConfig = loadAgentConfig(workspaceDir);
     // Initialize logger with settings from config
     log.initLogger({
@@ -391,52 +389,24 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
     const memory = await getMemory(conversationDir);
     const skills = loadMamaSkills(conversationDir, workspacePath);
     const emptyPlatform = {
-        name: "slack",
+        name: "chat",
         formattingGuide: "",
         channels: [],
         users: [],
     };
     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);
+    // Create session manager and settings manager. Top-level/private sessions
+    // use the conversation's current pointer; scoped sessions use fixed files.
+    // Platform-specific branch/fork behavior is resolved before runner creation.
     const isThread = sessionKey.includes(":");
-    let sessionManager;
-    let contextFile;
-    if (isThread) {
-        const threadFile = getThreadSessionFile(conversationDir, sessionKey);
-        const existing = tryResolveThreadSession(threadFile);
-        if (existing) {
-            contextFile = existing;
-            sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);
-        }
-        else {
-            const conversationSource = resolveChannelSessionFile(conversationDir);
-            if (conversationSource) {
-                try {
-                    contextFile = forkThreadSessionFile(conversationSource, threadFile, conversationDir);
-                    sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);
-                }
-                catch {
-                    contextFile = createManagedSessionFileAtPath(threadFile, conversationDir);
-                    sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);
-                }
-            }
-            else {
-                contextFile = createManagedSessionFileAtPath(threadFile, conversationDir);
-                sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);
-            }
-        }
-    }
-    else {
-        // Direct/shared session: normal resolve
-        contextFile = resolveManagedSessionFile(sessionDir, conversationDir);
-        sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);
+    const rootTs = extractSessionSuffix(sessionKey);
+    const { sessionDir, contextFile, threadRootMessage } = sessionScope;
+    const sessionManager = openManagedSession(contextFile, sessionDir, conversationDir);
+    const threadSessionName = buildThreadSessionName(threadRootMessage);
+    if (isThread && threadSessionName && sessionManager.getSessionName() !== threadSessionName) {
+        sessionManager.appendSessionInfo(threadSessionName);
     }
     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, ".."));
     // Create AuthStorage and ModelRegistry
     // Auth stored outside workspace so agent can't access it
@@ -534,8 +504,6 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
                 ...baseAttrs,
             });
             log.logToolStart(logCtx, agentEvent.toolName, label, agentEvent.args);
-            // Tool labels are omitted from the main message to reduce Slack noise.
-            // Tool execution details are still posted to the thread (see tool_execution_end).
         }
         else if (event.type === "tool_execution_end") {
             const agentEvent = event;
@@ -569,24 +537,16 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
             else {
                 log.logToolSuccess(logCtx, agentEvent.toolName, durationMs, resultStr);
             }
-            // Post args + result to thread
-            const label = pending?.args ? pending.args.label : undefined;
-            const argsFormatted = pending
-                ? formatToolArgsForSlack(agentEvent.toolName, pending.args)
-                : "(args not found)";
-            const duration = (durationMs / 1000).toFixed(1);
-            let threadMessage = `*${agentEvent.isError ? "✗" : "✓"} ${agentEvent.toolName}*`;
-            if (label)
-                threadMessage += `: ${label}`;
-            threadMessage += ` (${duration}s)\n`;
-            if (argsFormatted)
-                threadMessage += `\`\`\`\n${argsFormatted}\n\`\`\`\n`;
-            threadMessage += `*Result:*\n\`\`\`\n${resultStr}\n\`\`\``;
-            // Only post thread details for tools with meaningful output (bash, attach).
-            // Skip read/write/edit to reduce Slack noise — their results are in the log.
-            const quietTools = new Set(["read", "write", "edit"]);
-            if (!quietTools.has(agentEvent.toolName)) {
-                queue.enqueueMessage(threadMessage, "thread", "tool result thread", false);
+            if (!QUIET_TOOLS.has(agentEvent.toolName)) {
+                const toolResult = {
+                    toolName: agentEvent.toolName,
+                    label: pending?.args ? pending.args.label : undefined,
+                    args: pending?.args,
+                    result: truncate(resultStr, TOOL_RESULT_DIAGNOSTIC_CAP),
+                    isError: agentEvent.isError,
+                    durationMs,
+                };
+                queue.enqueue(() => responseCtx.respondToolResult(toolResult), "tool result diagnostic");
             }
             if (agentEvent.isError) {
                 queue.enqueue(() => responseCtx.respond(`_Error: ${truncate(resultStr, 200)}_`), "tool error");
@@ -678,16 +638,12 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
                 const text = textParts.join("\n");
                 for (const thinking of thinkingParts) {
                     log.logThinking(logCtx, thinking);
-                    queue.enqueueMessage(`_${thinking}_`, "main", "thinking main");
-                    queue.enqueueMessage(`_${thinking}_`, "thread", "thinking thread", false);
+                    queue.enqueue(() => responseCtx.respond(`_${thinking}_`), "thinking main");
+                    queue.enqueue(() => responseCtx.respondDiagnostic(`_${thinking}_`), "thinking diagnostic");
                 }
                 if (text.trim()) {
                     log.logResponse(logCtx, text);
-                    queue.enqueueMessage(text, "main", "response main");
-                    // Only overflow to thread for texts that will be truncated in main
-                    if (text.length > SLACK_MAX_LENGTH) {
-                        queue.enqueueMessage(text, "thread", "response thread", false);
-                    }
+                    queue.enqueue(() => responseCtx.respond(text), "response main");
                 }
             }
         }
@@ -710,23 +666,6 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
             queue.enqueue(() => responseCtx.respond(`_Retrying (${retryEvent.attempt}/${retryEvent.maxAttempts})..._`), "retry");
         }
     });
-    // Message limit constant
-    const SLACK_MAX_LENGTH = 40000;
-    const splitForSlack = (text) => {
-        if (text.length <= SLACK_MAX_LENGTH)
-            return [text];
-        const parts = [];
-        let remaining = text;
-        let partNum = 1;
-        while (remaining.length > 0) {
-            const chunk = remaining.substring(0, SLACK_MAX_LENGTH - 50);
-            remaining = remaining.substring(SLACK_MAX_LENGTH - 50);
-            const suffix = remaining.length > 0 ? `\n_(continued ${partNum}...)_` : "";
-            parts.push(chunk + suffix);
-            partNum++;
-        }
-        return parts;
-    };
     return {
         async run(message, responseCtx, platform) {
             // Extract conversationId from sessionKey (format: "conversationId:rootTs" or just "conversationId")
@@ -769,6 +708,11 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
                 conversationId,
                 conversationKind: message.conversationKind,
                 userId: message.userId,
+                sessionKey: message.sessionKey,
+                // For Slack scheduled events, preserve thread targeting only when the
+                // request was created inside an existing thread. Top-level reminders
+                // should come back as top-level messages.
+                threadTs: message.threadTs,
             });
             // Set up file upload function
             setUploadFunction(async (filePath, title) => {
@@ -806,11 +750,7 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
                             const errMsg = err instanceof Error ? err.message : String(err);
                             log.logWarning(`API error (${errorContext})`, errMsg);
                             try {
-                                // Split long error messages to avoid msg_too_long
-                                const errParts = splitForSlack(`_Error: ${errMsg}_`);
-                                for (const part of errParts) {
-                                    await responseCtx.respondInThread(part);
-                                }
+                                await responseCtx.respondDiagnostic(`Error: ${errMsg}`, { style: "error" });
                             }
                             catch {
                                 // Ignore
@@ -818,12 +758,6 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
                         }
                     });
                 },
-                enqueueMessage(text, target, errorContext, _doLog = true) {
-                    const parts = splitForSlack(text);
-                    for (const part of parts) {
-                        this.enqueue(() => target === "main" ? responseCtx.respond(part) : responseCtx.respondInThread(part), errorContext);
-                    }
-                },
             };
             // Log context info
             log.logInfo(`Context sizes - system: ${systemPrompt.length} chars, memory: ${memory.length} chars`);
@@ -887,11 +821,9 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
             if (runState.stopReason === "error" && runState.errorMessage) {
                 try {
                     await responseCtx.replaceResponse("_Sorry, something went wrong_");
-                    // Split long error messages to avoid msg_too_long
-                    const errorParts = splitForSlack(`_Error: ${runState.errorMessage}_`);
-                    for (const part of errorParts) {
-                        await responseCtx.respondInThread(part);
-                    }
+                    await responseCtx.respondDiagnostic(`Error: ${runState.errorMessage}`, {
+                        style: "error",
+                    });
                 }
                 catch (err) {
                     const errMsg = err instanceof Error ? err.message : String(err);
@@ -919,10 +851,7 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
                 }
                 else if (finalText.trim()) {
                     try {
-                        const mainText = finalText.length > SLACK_MAX_LENGTH
-                            ? `${finalText.substring(0, SLACK_MAX_LENGTH - 50)}\n\n_(see thread for full response)_`
-                            : finalText;
-                        await responseCtx.replaceResponse(mainText);
+                        await responseCtx.replaceResponse(finalText);
                     }
                     catch (err) {
                         const errMsg = err instanceof Error ? err.message : String(err);
@@ -975,12 +904,10 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
                     attributes: runMetricAttributes,
                 });
                 const summary = log.logUsageSummary(runState.logCtx, runState.totalUsage, contextTokens, contextWindow);
-                // Split long summaries to avoid msg_too_long
-                const summaryParts = splitForSlack(summary);
-                for (const part of summaryParts) {
-                    runState.queue.enqueue(() => responseCtx.respondInThread(part, { style: "muted" }), "usage summary");
+                if (platform.diagnostics?.showUsageSummary === true) {
+                    runState.queue.enqueue(() => responseCtx.respondDiagnostic(summary, { style: "muted" }), "usage summary");
+                    await queueChain;
                 }
-                await queueChain;
             }
             // Clear run state
             runState.responseCtx = null;