@geminixiang/mama 0.2.0-beta.6 → 0.2.0-beta.7

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"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;AAgXD;;;;;;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,CAysBtB","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 { loadAgentConfigForConversation } 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  const isCloudflareSandbox = sandboxConfig.type === \"cloudflare\";\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        : isCloudflareSandbox\n          ? `You are running through a Cloudflare Sandbox bridge.\n- Bash working directory: /workspace\n- Your commands run in a remote container managed by Cloudflare\n- Important: the remote filesystem is not automatically synced back to the host workspace`\n          : `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 = loadAgentConfigForConversation(conversationDir);\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      sandboxConfig.type === \"container\" ||\n      sandboxConfig.type === \"image\" ||\n      sandboxConfig.type === \"cloudflare\" ||\n      sandboxConfig.type === \"firecracker\")\n      ? new ActorExecutionResolver(sandboxConfig, vaultManager, provisioner, workspaceDir)\n      : undefined;\n  // activeExecutor is replaced at the start of each run() call when executionResolver\n  // is present, so the stable `executor` wrapper always delegates to the latest resolved value.\n  let activeExecutor: Executor =\n    executionResolver !== undefined\n      ? createExecutor({ type: \"host\" })\n      : createExecutor(sandboxConfig);\n  const executor: Executor = {\n    exec(command, options) {\n      return activeExecutor.exec(command, options);\n    },\n    getWorkspacePath(hostPath) {\n      return activeExecutor.getWorkspacePath(hostPath);\n    },\n    getSandboxConfig() {\n      return activeExecutor.getSandboxConfig();\n    },\n  };\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: agentConfig.thinkingLevel,\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          conversationId,\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"]}
+{"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;AAoYD;;;;;;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,CAysBtB","sourcesContent":["import { Agent, type AgentEvent } from \"@earendil-works/pi-agent-core\";\nimport { getModel, type ImageContent } from \"@earendil-works/pi-ai\";\nimport {\n  AgentSession,\n  AuthStorage,\n  convertToLlm,\n  DefaultResourceLoader,\n  formatSkillsForPrompt,\n  getAgentDir,\n  loadSkillsFromDir,\n  ModelRegistry,\n  type Skill,\n} from \"@earendil-works/pi-coding-agent\";\nimport { existsSync, readFileSync } from \"fs\";\nimport { mkdir, readFile, writeFile } from \"fs/promises\";\nimport { homedir } from \"os\";\nimport { join, posix } from \"path\";\nimport type {\n  ChatMessage,\n  ChatResponseContext,\n  ChatToolResult,\n  ConversationKind,\n  PlatformInfo,\n} from \"./adapter.js\";\nimport { loadAgentConfigForConversation } 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 buildRuntimePaths(workspacePath: string, conversationId: string) {\n  const workspaceRoot = workspacePath.replace(/\\/+$/, \"\") || \"/\";\n  const conversationPath = posix.join(workspaceRoot, conversationId);\n  return {\n    workspaceRoot,\n    conversationPath,\n    scratchPath: posix.join(conversationPath, \"scratch\"),\n  };\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 { workspaceRoot, conversationPath, scratchPath } = buildRuntimePaths(\n    workspacePath,\n    conversationId,\n  );\n  const isContainer = sandboxConfig.type === \"container\" || sandboxConfig.type === \"image\";\n  const isImageSandbox = sandboxConfig.type === \"image\";\n  const isFirecracker = sandboxConfig.type === \"firecracker\";\n  const isCloudflareSandbox = sandboxConfig.type === \"cloudflare\";\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- Runtime workspace root: ${workspaceRoot}\n- Bash commands start in: ${workspaceRoot}\n- Install tools with the image's package manager\n- Your changes persist for this user's container until it is recreated`\n    : isContainer\n      ? `You are running inside a shared container.\n- Runtime workspace root: ${workspaceRoot}\n- Bash commands start in: ${workspaceRoot}\n- Install tools with the container's package manager\n- Your changes persist across sessions`\n      : isFirecracker\n        ? `You are running inside a Firecracker microVM.\n- Runtime workspace root: ${workspaceRoot}\n- Use cd or absolute paths; project files are under ${workspaceRoot}\n- Install tools with: apt-get install <package> (Debian-based)\n- Your changes persist across sessions`\n        : isCloudflareSandbox\n          ? `You are running through a Cloudflare Sandbox bridge.\n- Runtime workspace root: ${workspaceRoot}\n- Bash commands start in: ${workspaceRoot}\n- Your commands run in a remote container managed by Cloudflare\n- Important: the remote filesystem is not automatically synced back to the host workspace`\n          : `You are running directly on the host machine.\n- Runtime workspace root: ${workspaceRoot}\n- Bash commands start in: ${process.cwd()}\n- Be careful with system modifications`;\n\n  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- Default place for clones, downloads, and experiments: ${scratchPath}\n- Do not use host-only paths unless you are running in host mode and verified they exist.\n\n## Workspace Layout\n${workspaceRoot}/\n├── MEMORY.md                    # Global memory (all conversations)\n├── skills/                      # Global CLI tools you create\n└── ${conversationId}/           # This conversation\n    ├── MEMORY.md                # Conversation-specific memory\n    ├── log.jsonl                # Human-readable message history (no tool results)\n    ├── sessions/                # Structured session history used for context reconstruction\n    │   ├── current              # Active top-level session pointer\n    │   ├── <timestamp>_<id>.jsonl  # Top-level session files\n    │   └── <scope_id>.jsonl        # Scoped thread/reply session files\n    ├── attachments/             # User-shared files\n    ├── scratch/                 # Working directory for clones/downloads/experiments: ${scratchPath}\n    └── skills/                  # Conversation-specific tools\n\n## Skills (Custom CLI Tools)\nYou can create reusable CLI tools for recurring tasks (email, APIs, data processing, etc.).\n\n### Creating Skills\nStore in \\`${workspaceRoot}/skills/<name>/\\` (global) or \\`${conversationPath}/skills/<name>/\\` (conversation-specific).\nEach skill directory needs a \\`SKILL.md\\` with YAML frontmatter:\n\n\\`\\`\\`markdown\n---\nname: skill-name\ndescription: Short description of what this skill does\n---\n\n# Skill Name\n\nUsage instructions, examples, etc.\nScripts are in: {baseDir}/\n\\`\\`\\`\n\n\\`name\\` and \\`description\\` are required. Use \\`{baseDir}\\` as placeholder for the skill's directory path.\n\n### Available Skills\n${skills.length > 0 ? formatSkillsForPrompt(skills) : \"(no skills installed yet)\"}\n\n## Events\nYou can schedule events that wake you up at specific times or when external things happen. Events are JSON files in \\`${workspaceRoot}/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 > ${workspaceRoot}/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 ${workspaceRoot}/events/\\`\n- View: \\`cat ${workspaceRoot}/events/foo.json\\`\n- Delete/cancel: \\`rm ${workspaceRoot}/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 (${workspaceRoot}/MEMORY.md): skills, preferences, project info\n- Conversation (${conversationPath}/MEMORY.md): conversation-specific decisions, ongoing work\nUpdate when you learn something important or when asked to remember something.\n\n### Current Memory\n${memory}\n\n## System Configuration Log\nMaintain ${workspaceRoot}/SYSTEM.md to log all environment modifications:\n- Installed packages (apt install, npm install, uv pip install)\n- Environment variables set\n- Config files modified (~/.gitconfig, cron jobs, etc.)\n- Skill dependencies installed\n\nUpdate this file whenever you modify the environment. On fresh container, read it first to restore your setup.\n\n## Log Queries (for older history)\nFormat: \\`{\"date\":\"...\",\"ts\":\"...\",\"user\":\"...\",\"userName\":\"...\",\"text\":\"...\",\"isBot\":false}\\`\nThe log contains user messages and your final responses (not tool calls/results).\nUse \\`log.jsonl\\` for quick grep-style history. Use \\`${conversationPath}/sessions/\\` when you need structured turns, tool outputs, or 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 = loadAgentConfigForConversation(conversationDir);\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      sandboxConfig.type === \"container\" ||\n      sandboxConfig.type === \"image\" ||\n      sandboxConfig.type === \"cloudflare\" ||\n      sandboxConfig.type === \"firecracker\")\n      ? new ActorExecutionResolver(sandboxConfig, vaultManager, provisioner, workspaceDir)\n      : undefined;\n  // activeExecutor is replaced at the start of each run() call when executionResolver\n  // is present, so the stable `executor` wrapper always delegates to the latest resolved value.\n  let activeExecutor: Executor =\n    executionResolver !== undefined\n      ? createExecutor({ type: \"host\" })\n      : createExecutor(sandboxConfig);\n  const executor: Executor = {\n    exec(command, options) {\n      return activeExecutor.exec(command, options);\n    },\n    getWorkspacePath(hostPath) {\n      return activeExecutor.getWorkspacePath(hostPath);\n    },\n    getSandboxConfig() {\n      return activeExecutor.getSandboxConfig();\n    },\n  };\n  const workspaceBase = join(conversationDir, \"..\");\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: agentConfig.thinkingLevel,\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 workspace exists on the host side before it is mounted/routed.\n      await mkdir(join(conversationDir, \"scratch\"), { recursive: true });\n\n      if (executionResolver) {\n        executionResolver.refresh();\n        activeExecutor = await executionResolver.resolve({\n          platform: platform.name,\n          userId: message.userId,\n          conversationId,\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

@@ -1,10 +1,10 @@
-import { Agent } from "@mariozechner/pi-agent-core";
-import { getModel } from "@mariozechner/pi-ai";
-import { AgentSession, AuthStorage, convertToLlm, DefaultResourceLoader, formatSkillsForPrompt, getAgentDir, loadSkillsFromDir, ModelRegistry, } from "@mariozechner/pi-coding-agent";
+import { Agent } from "@earendil-works/pi-agent-core";
+import { getModel } from "@earendil-works/pi-ai";
+import { AgentSession, AuthStorage, convertToLlm, DefaultResourceLoader, formatSkillsForPrompt, getAgentDir, loadSkillsFromDir, ModelRegistry, } from "@earendil-works/pi-coding-agent";
 import { existsSync, readFileSync } from "fs";
 import { mkdir, readFile, writeFile } from "fs/promises";
 import { homedir } from "os";
-import { join } from "path";
+import { join, posix } from "path";
 import { loadAgentConfigForConversation } from "./config.js";
 import { createMamaSettingsManager, syncLogToSessionManager } from "./context.js";
 import { ActorExecutionResolver } from "./execution-resolver.js";
@@ -94,8 +94,17 @@ function loadMamaSkills(conversationDir, workspacePath) {
     }
     return Array.from(skillMap.values());
 }
+function buildRuntimePaths(workspacePath, conversationId) {
+    const workspaceRoot = workspacePath.replace(/\/+$/, "") || "/";
+    const conversationPath = posix.join(workspaceRoot, conversationId);
+    return {
+        workspaceRoot,
+        conversationPath,
+        scratchPath: posix.join(conversationPath, "scratch"),
+    };
+}
 function buildSystemPrompt(workspacePath, conversationId, conversationKind, currentUserId, memory, sandboxConfig, platform, skills) {
-    const conversationPath = `${workspacePath}/${conversationId}`;
+    const { workspaceRoot, conversationPath, scratchPath } = buildRuntimePaths(workspacePath, conversationId);
     const isContainer = sandboxConfig.type === "container" || sandboxConfig.type === "image";
     const isImageSandbox = sandboxConfig.type === "image";
     const isFirecracker = sandboxConfig.type === "firecracker";
@@ -110,26 +119,31 @@ function buildSystemPrompt(workspacePath, conversationId, conversationKind, curr
         : "(no users loaded)";
     const envDescription = isImageSandbox
         ? `You are running inside a managed per-user container.
-- Bash working directory: / (use cd or absolute paths)
+- Runtime workspace root: ${workspaceRoot}
+- Bash commands start in: ${workspaceRoot}
 - Install tools with the image's package manager
 - Your changes persist for this user's container until it is recreated`
         : isContainer
             ? `You are running inside a shared container.
-- Bash working directory: / (use cd or absolute paths)
+- Runtime workspace root: ${workspaceRoot}
+- Bash commands start in: ${workspaceRoot}
 - Install tools with the container's package manager
 - Your changes persist across sessions`
             : isFirecracker
                 ? `You are running inside a Firecracker microVM.
-- Bash working directory: / (use cd or absolute paths)
+- Runtime workspace root: ${workspaceRoot}
+- Use cd or absolute paths; project files are under ${workspaceRoot}
 - Install tools with: apt-get install <package> (Debian-based)
 - Your changes persist across sessions`
                 : isCloudflareSandbox
                     ? `You are running through a Cloudflare Sandbox bridge.
-- Bash working directory: /workspace
+- Runtime workspace root: ${workspaceRoot}
+- Bash commands start in: ${workspaceRoot}
 - Your commands run in a remote container managed by Cloudflare
 - Important: the remote filesystem is not automatically synced back to the host workspace`
                     : `You are running directly on the host machine.
-- Bash working directory: ${process.cwd()}
+- Runtime workspace root: ${workspaceRoot}
+- Bash commands start in: ${process.cwd()}
 - Be careful with system modifications`;
     return `You are mama, a ${platform.name} bot assistant. Be concise. No emojis.
 
@@ -153,9 +167,11 @@ When mentioning users, use <@username> format (e.g., <@mario>).
 
 ## Environment
 ${envDescription}
+- Default place for clones, downloads, and experiments: ${scratchPath}
+- Do not use host-only paths unless you are running in host mode and verified they exist.
 
 ## Workspace Layout
-${workspacePath}/
+${workspaceRoot}/
 ├── MEMORY.md                    # Global memory (all conversations)
 ├── skills/                      # Global CLI tools you create
 └── ${conversationId}/           # This conversation
@@ -166,14 +182,14 @@ ${workspacePath}/
     │   ├── <timestamp>_<id>.jsonl  # Top-level session files
     │   └── <scope_id>.jsonl        # Scoped thread/reply session files
     ├── attachments/             # User-shared files
-    ├── scratch/                 # Your working directory
+    ├── scratch/                 # Working directory for clones/downloads/experiments: ${scratchPath}
     └── skills/                  # Conversation-specific tools
 
 ## Skills (Custom CLI Tools)
 You can create reusable CLI tools for recurring tasks (email, APIs, data processing, etc.).
 
 ### Creating Skills
-Store in \`${workspacePath}/skills/<name>/\` (global) or \`${conversationPath}/skills/<name>/\` (conversation-specific).
+Store in \`${workspaceRoot}/skills/<name>/\` (global) or \`${conversationPath}/skills/<name>/\` (conversation-specific).
 Each skill directory needs a \`SKILL.md\` with YAML frontmatter:
 
 \`\`\`markdown
@@ -194,7 +210,7 @@ Scripts are in: {baseDir}/
 ${skills.length > 0 ? formatSkillsForPrompt(skills) : "(no skills installed yet)"}
 
 ## Events
-You can schedule events that wake you up at specific times or when external things happen. Events are JSON files in \`${workspacePath}/events/\`.
+You can schedule events that wake you up at specific times or when external things happen. Events are JSON files in \`${workspaceRoot}/events/\`.
 
 ### Event Types
 
@@ -233,16 +249,16 @@ Prefer the \`event\` tool over manually writing JSON files; it fills \`platform\
 ### Creating Events
 Use unique filenames to avoid overwriting existing events. Include a timestamp or random suffix:
 \`\`\`bash
-cat > ${workspacePath}/events/dentist-reminder-$(date +%s).json << 'EOF'
+cat > ${workspaceRoot}/events/dentist-reminder-$(date +%s).json << 'EOF'
 {"type": "one-shot", "platform": "${platform.name}", "conversationId": "${conversationId}", "conversationKind": "${conversationKind}", "userId": "${currentUserId ?? "<requester userId>"}", "text": "Dentist tomorrow", "at": "2025-12-14T09:00:00+01:00"}
 EOF
 \`\`\`
 Or check if file exists first before creating.
 
 ### Managing Events
-- List: \`ls ${workspacePath}/events/\`
-- View: \`cat ${workspacePath}/events/foo.json\`
-- Delete/cancel: \`rm ${workspacePath}/events/foo.json\`
+- List: \`ls ${workspaceRoot}/events/\`
+- View: \`cat ${workspaceRoot}/events/foo.json\`
+- Delete/cancel: \`rm ${workspaceRoot}/events/foo.json\`
 
 ### When Events Trigger
 You receive a message like:
@@ -262,7 +278,7 @@ Maximum 5 events can be queued. Don't create excessive immediate or periodic eve
 
 ## Memory
 Write to MEMORY.md files to persist context across conversations.
-- Global (${workspacePath}/MEMORY.md): skills, preferences, project info
+- Global (${workspaceRoot}/MEMORY.md): skills, preferences, project info
 - Conversation (${conversationPath}/MEMORY.md): conversation-specific decisions, ongoing work
 Update when you learn something important or when asked to remember something.
 
@@ -270,7 +286,7 @@ Update when you learn something important or when asked to remember something.
 ${memory}
 
 ## System Configuration Log
-Maintain ${workspacePath}/SYSTEM.md to log all environment modifications:
+Maintain ${workspaceRoot}/SYSTEM.md to log all environment modifications:
 - Installed packages (apt install, npm install, uv pip install)
 - Environment variables set
 - Config files modified (~/.gitconfig, cron jobs, etc.)
@@ -384,7 +400,7 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
             return activeExecutor.getSandboxConfig();
         },
     };
-    const workspaceBase = conversationDir.replace(`/${conversationId}`, "");
+    const workspaceBase = join(conversationDir, "..");
     const getWorkspacePath = () => executor.getWorkspacePath(workspaceBase);
     let workspacePath = getWorkspacePath();
     // Create tools (per-runner, with per-runner upload function setter)
@@ -679,8 +695,8 @@ export async function createRunner(sandboxConfig, sessionKey, conversationId, co
         async run(message, responseCtx, platform) {
             // Extract conversationId from sessionKey (format: "conversationId:rootTs" or just "conversationId")
             const sessionConversation = message.sessionKey.split(":")[0];
-            // Ensure conversation directory exists
-            await mkdir(conversationDir, { recursive: true });
+            // Ensure conversation workspace exists on the host side before it is mounted/routed.
+            await mkdir(join(conversationDir, "scratch"), { recursive: true });
             if (executionResolver) {
                 executionResolver.refresh();
                 activeExecutor = await executionResolver.resolve({