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

package/README.md

@@ -1,9 +1,9 @@
-# mama
+# mama (Multi-Agent Mischief Assistant)
 
 [![npm version](https://img.shields.io/npm/v/@geminixiang/mama.svg)](https://www.npmjs.com/package/@geminixiang/mama)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A multi-platform AI agent bot for Slack, Telegram, and Discord — based on [pi-mom](https://github.com/badlogic/pi-mono), with the goal of merging improvements back upstream.
+A multi-platform, multi-agent AI assistant for Slack, Telegram, and Discord — based on [pi-mom](https://github.com/badlogic/pi-mono), with the goal of merging improvements back upstream.
 
 ## 📜 Attribution & Origins
 
@@ -47,8 +47,9 @@ We actively track the upstream `pi-mom` and plan to:
 - **Multi-platform** — Slack, Telegram, and Discord adapters out of the box
 - **Persistent sessions** — session behavior is adapted per platform instead of forcing one thread model everywhere
 - **Concurrent conversations** — Slack threads, Discord replies/threads, and Telegram reply chains can run independently
-- **Sandbox execution** — run agent commands on host, in a shared container, in a managed per-user container, or in a Firecracker VM
+- **Sandbox execution** — run agent commands on host, in a shared container, in a managed per-user container, or experimentally in a Firecracker VM
 - **Credential vaults** — `/login` stores credentials under `--state-dir` and injects env only into container/image/Firecracker runs
+- **Web session viewer** — users can open a read-only web view of the current session via `session` / `/session`
 - **Persistent memory** — workspace-level and channel-level `MEMORY.md` files
 - **Skills** — drop custom CLI tools into `skills/` directories
 - **Event system** — schedule one-shot or recurring tasks via JSON files
@@ -56,11 +57,11 @@ We actively track the upstream `pi-mom` and plan to:
 
 ## Platform Session Model
 
-| Platform | User Interaction Structure                | `sessionKey` Rule                                                    | Default Session Model                                                                | Special Handling Needed | Notes                                                                                            |
-| -------- | ----------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ----------------------- | ------------------------------------------------------------------------------------------------ |
-| Slack    | channel top-level + thread replies        | top-level: `channelId`; thread: `channelId:threadTs`                 | channel keeps one persistent session; thread forks from channel into its own session | High                    | channel -> thread inherits context via fork; thread -> channel does not merge back automatically |
-| Discord  | normal messages, replies, thread channels | `channelId:threadTsOrMsgId`                                          | replies / thread channels naturally map to isolated sessions                         | Low                     | no aliasing layer needed; session identity is determined directly from the Discord event         |
-| Telegram | private chats, group replies              | private chat: `chatId`; group reply chain: `chatId:replyToIdOrMsgId` | private chats use one long session; groups split by reply chain                      | Medium                  | Telegram has no native thread model; group sessions are modeled from reply chains                |
+| Platform | User Interaction Structure                        | `sessionKey` Rule                                                                 | Default Session Model                                                                       | Special Handling Needed | Notes                                                                                            |
+| -------- | ------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------ |
+| Slack    | channel top-level + thread replies                | top-level / DM: `conversationId`; thread: `conversationId:threadTs`               | top-level channel and DM sessions persist; each Slack thread forks into its own session     | High                    | thread inherits parent context at fork time only; branch changes do not merge back automatically |
+| Discord  | server mentions, replies, thread channels, DMs    | DM: `channelId`; shared top-level: `channelId:messageId`; reply/thread: rooted id | DMs are one persistent session; shared spaces are scoped per top-level mention or thread    | Medium                  | replies in shared channels continue the root message session; DM replies do not fork             |
+| Telegram | private chats, group mentions, group reply chains | private: `chatId`; shared top-level: `chatId:messageId`; reply chain: root reply  | private chats are one persistent session; shared groups are scoped per mentioned reply root | Medium                  | Telegram has no native thread model; shared sessions are inferred from reply chains              |
 
 ## Requirements
 
@@ -178,7 +179,9 @@ The bot responds when `@mentioned` in any channel or via DM.
 
 - **Top-level channel messages** — share one persistent channel session.
 - **Thread replies** — fork from the channel session into an isolated thread session.
-- **Thread memory** — inherited at fork time only; thread changes do not merge back into the channel automatically.
+- **DM top-level messages** — share one persistent DM session.
+- **DM thread replies** — fork from the DM session into an isolated thread session.
+- **Thread memory** — inherited at fork time only; thread changes do not merge back into the parent session automatically.
 
 ---
 
@@ -195,7 +198,9 @@ mama [--state-dir=~/.mama] [--sandbox=host|container:<container>|image:<image>|f
 
 - **Private chats** — every message is forwarded to the bot automatically.
 - **Group chats** — the bot only responds when `@mentioned` by username.
-- **Reply chains** — replying to a previous message continues the same session.
+- **Private chat session** — one persistent session per DM.
+- **Group top-level mentions** — each mentioned message starts its own scoped session.
+- **Reply chains** — replying to a previous message continues that reply-root session.
 - Say `stop` or `/stop` to cancel a running task.
 
 ---
@@ -215,29 +220,30 @@ mama [--state-dir=~/.mama] [--sandbox=host|container:<container>|image:<image>|f
 
 - **Server channels** — the bot responds when `@mentioned`.
 - **DMs** — every message is forwarded automatically.
-- **Threads** — messages inside a Discord thread share a single session.
-- **Reply chains** — replying to a message continues that session.
+- **DM session** — one persistent session per DM channel.
+- **Top-level mentions in shared channels** — each mentioned message starts its own scoped session.
+- **Threads and reply chains** — messages inside the same thread or reply root share a session.
 - Say `stop` or `/stop` to cancel a running task.
 
 ---
 
 ## Options
 
-| Option                                 | Default   | Description                                                       |
-| -------------------------------------- | --------- | ----------------------------------------------------------------- |
-| `--state-dir=<dir>`                    | `~/.mama` | Store settings, credential vaults, and bindings outside workspace |
-| `--sandbox=host`                       | ✓         | Run commands directly on host; vault env is not injected          |
-| `--sandbox=container:<name>`           |           | Run commands in an existing shared container                      |
-| `--sandbox=image:<image>`              |           | Auto-provision one Docker container per platform user             |
-| `--sandbox=firecracker:<vm-id>:<path>` |           | Run commands inside a Firecracker microVM                         |
-| `--download <channel-id>`              |           | Download channel history to stdout and exit (Slack only)          |
+| Option                                 | Default   | Description                                                        |
+| -------------------------------------- | --------- | ------------------------------------------------------------------ |
+| `--state-dir=<dir>`                    | `~/.mama` | Store settings, credential vaults, and bindings outside workspace  |
+| `--sandbox=host`                       | ✓         | Run commands directly on host; vault env is not injected           |
+| `--sandbox=container:<name>`           |           | Run commands in an existing shared container                       |
+| `--sandbox=image:<image>`              |           | Auto-provision one Docker container per platform user              |
+| `--sandbox=firecracker:<vm-id>:<path>` |           | Experimental Firecracker microVM mode (alpha; not recommended yet) |
+| `--download <channel-id>`              |           | Download channel history to stdout and exit (Slack only)           |
 
 ### Sandbox and Vault Semantics
 
 - `host`: no vault env injection.
 - `container:<name>`: one container maps to one shared vault key: `container-<name>`.
 - `image:<image>`: mama creates one container per resolved vault/user and injects that vault's env and file mounts.
-- `firecracker:*`: per-user vault routing via `bindings.json` first, then direct userId vault.
+- `firecracker:*`: per-user vault routing via `bindings.json` first, then direct userId vault. This mode is still alpha and not recommended for normal deployments yet.
 - `docker:*` is not supported; use `container:*` or `image:*`.
 
 See [docs/sandbox.md](docs/sandbox.md) for the full sandbox/vault behavior matrix.
@@ -267,6 +273,17 @@ On Slack, you can also register native slash commands such as `/pi-login` and `/
 - `/pi-login` in a shared channel opens a DM and continues the credential flow there.
 - `/pi-new` only works in a Slack DM and resets that DM session context.
 
+## Web Session Viewer
+
+The same web portal used for `/login` can also render a read-only view of the current session.
+
+- Users can send `session`, `/session`, or `/pi-session` in a private conversation / DM.
+- mama returns an expiring read-only link to `/session?token=...`.
+- The page shows the current branch timeline, including user messages, assistant replies, tool results, and compaction / branch summary events.
+- For now, session links are only issued from private conversations to avoid leaking shared-channel history.
+
+This feature uses the same `MOM_LINK_URL` / `MOM_LINK_PORT` configuration as `/login`.
+
 Built-in OAuth guides:
 
 - [GitHub OAuth](docs/oauth/github.md)
@@ -290,15 +307,15 @@ mama loads settings from `<state-dir>/settings.json` first, then falls back to `
 }
 ```
 
-| Field           | Default             | Description                                              |
-| --------------- | ------------------- | -------------------------------------------------------- |
-| `provider`      | `anthropic`         | AI provider (env: `MOM_AI_PROVIDER`)                     |
-| `model`         | `claude-sonnet-4-5` | Model name (env: `MOM_AI_MODEL`)                         |
-| `thinkingLevel` | `off`               | `off` / `low` / `medium` / `high`                        |
-| `sessionScope`  | `thread`            | `thread` (per thread/reply chain) or `channel`           |
-| `logFormat`     | `console`           | `console` (colored stdout) or `json` (GCP Cloud Logging) |
-| `logLevel`      | `info`              | `trace` / `debug` / `info` / `warn` / `error`            |
-| `sentryDsn`     | unset               | Sentry DSN (preferred over env `SENTRY_DSN`)             |
+| Field           | Default             | Description                                                                                              |
+| --------------- | ------------------- | -------------------------------------------------------------------------------------------------------- |
+| `provider`      | `anthropic`         | AI provider (env: `MOM_AI_PROVIDER`)                                                                     |
+| `model`         | `claude-sonnet-4-5` | Model name (env: `MOM_AI_MODEL`)                                                                         |
+| `thinkingLevel` | `off`               | `off` / `low` / `medium` / `high`                                                                        |
+| `sessionScope`  | `thread`            | Legacy compatibility setting. Current session boundaries are platform-defined by adapter/session policy. |
+| `logFormat`     | `console`           | `console` (colored stdout) or `json` (GCP Cloud Logging)                                                 |
+| `logLevel`      | `info`              | `trace` / `debug` / `info` / `warn` / `error`                                                            |
+| `sentryDsn`     | unset               | Sentry DSN (preferred over env `SENTRY_DSN`)                                                             |
 
 When `sentryDsn` is set, mama sends Sentry events with sensitive prompt/tool content redacted before upload.
 
@@ -348,16 +365,16 @@ Logs appear in Cloud Logging under **Log name: `mama`**. Console output (stdout)
 ├── SYSTEM.md              # Installed packages / env changes log
 ├── skills/                # Global skills (CLI tools)
 ├── events/                # Scheduled event files
-└── <channel-id>/
-    ├── MEMORY.md          # Channel-specific memory
+└── <conversation-id>/
+    ├── MEMORY.md          # Conversation-specific memory
     ├── log.jsonl          # Full message history
     ├── attachments/       # Downloaded user files
     ├── scratch/           # Agent working directory
-    ├── skills/            # Channel-specific skills
+    ├── skills/            # Conversation-specific skills
     └── sessions/
-        ├── current                      # Pointer for the channel-level session
+        ├── current                      # Pointer for the persistent top-level / direct session
         ├── 2026-04-05T18-04-31-010Z_1d92b3ad.jsonl
-        └── <thread-ts>.jsonl            # Fixed-path thread session
+        └── <session-suffix>.jsonl       # Fixed-path scoped session (thread / reply root)
 ```
 
 ## Container Sandbox
@@ -377,17 +394,28 @@ mama --sandbox=container:mama-tools /path/to/workspace
 ## Managed Per-User Container Sandbox
 
 ```bash
-# Build the bundled image once
-docker build -f docker/mama-sandbox.Dockerfile -t mama-sandbox:tools .
+# Pull the prebuilt image from GHCR
+# Release builds publish :tools, :<version>, and :latest / :beta
+# Pushes to main also publish :edge
+docker pull ghcr.io/geminixiang/mama-sandbox:tools
 
 # Start mama with managed image sandboxes
+mama --sandbox=image:ghcr.io/geminixiang/mama-sandbox:tools /path/to/workspace
+```
+
+Or build the bundled image locally:
+
+```bash
+docker build -f docker/mama-sandbox.Dockerfile -t mama-sandbox:tools .
 mama --sandbox=image:mama-sandbox:tools /path/to/workspace
 ```
 
-In this mode mama creates one Docker container per resolved vault/user, mounts the workspace at `/workspace`, injects vault env on execution, mounts any credential files declared in the vault, and stops idle containers automatically.
+In this mode mama creates one Docker container per resolved vault/user, attaches each container to its own Docker bridge network for per-user network isolation, mounts the workspace at `/workspace`, injects vault env on execution, mounts any credential files declared in the vault, and stops idle containers automatically.
 
 ## Firecracker Sandbox
 
+Warning: Firecracker support is still in very early alpha. It is useful for experimentation, but it is not yet the recommended sandbox mode for normal development or production use. Prefer `image:<image>` unless you are actively validating Firecracker behavior.
+
 Firecracker provides lightweight VM isolation with the security benefits of a hypervisor. Unlike Docker containers, Firecracker runs a full Linux kernel, providing stronger isolation.
 
 ### Requirements
@@ -459,13 +487,13 @@ Drop JSON files into `<working-directory>/events/` to trigger the agent:
 
 ```json
 // Immediate — triggers as soon as mama sees the file
-{"type": "immediate", "conversationId": "C0123456789", "conversationKind": "shared", "text": "New deployment finished"}
+{"type": "immediate", "platform": "slack", "conversationId": "C0123456789", "conversationKind": "shared", "text": "New deployment finished"}
 
 // One-shot — triggers once at a specific time
-{"type": "one-shot", "conversationId": "C0123456789", "conversationKind": "shared", "text": "Daily standup reminder", "at": "2025-12-15T09:00:00+08:00"}
+{"type": "one-shot", "platform": "telegram", "conversationId": "574247312", "conversationKind": "direct", "text": "Daily standup reminder", "at": "2025-12-15T09:00:00+08:00"}
 
 // Periodic — triggers on a cron schedule
-{"type": "periodic", "conversationId": "C0123456789", "conversationKind": "shared", "text": "Check inbox", "schedule": "0 9 * * 1-5", "timezone": "Asia/Taipei"}
+{"type": "periodic", "platform": "discord", "conversationId": "1498975469343739948", "conversationKind": "shared", "text": "Check inbox", "schedule": "0 9 * * 1-5", "timezone": "Asia/Taipei"}
 ```
 
 ## Skills

package/dist/adapter.d.ts

@@ -12,12 +12,21 @@ export interface ChatMessage {
     }[];
     threadTs?: string;
 }
+export interface ChatToolResult {
+    toolName: string;
+    label?: string;
+    args?: Record<string, unknown>;
+    result: string;
+    isError: boolean;
+    durationMs: number;
+}
 export interface ChatResponseContext {
     respond(text: string): Promise<void>;
     replaceResponse(text: string): Promise<void>;
-    respondInThread(text: string, options?: {
-        style?: "muted";
+    respondDiagnostic(text: string, options?: {
+        style?: "muted" | "error";
     }): Promise<void>;
+    respondToolResult(result: ChatToolResult): Promise<void>;
     setTyping(isTyping: boolean): Promise<void>;
     setWorking(working: boolean): Promise<void>;
     uploadFile(filePath: string, title?: string): Promise<void>;
@@ -35,6 +44,9 @@ export interface PlatformInfo {
         userName: string;
         displayName: string;
     }[];
+    diagnostics?: {
+        showUsageSummary?: boolean;
+    };
 }
 export interface ChatAdapter {
     start(): Promise<void>;
@@ -105,6 +117,4 @@ export interface BotHandler {
     /** Reset a session: abort if running, delete history, remove from cache */
     handleNew(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;
 }
-/** @deprecated Use BotHandler */
-export type MomHandler = BotHandler;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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","sourcesContent":["export type ConversationKind = \"direct\" | \"shared\";\n\nexport interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  conversationKind: ConversationKind;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n  threadTs?: string;\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string): Promise<void>;\n  respondInThread(text: string, options?: { style?: \"muted\" }): Promise<void>;\n  setTyping(isTyping: boolean): Promise<void>;\n  setWorking(working: boolean): Promise<void>;\n  uploadFile(filePath: string, title?: string): Promise<void>;\n  deleteResponse(): Promise<void>;\n}\n\nexport interface PlatformInfo {\n  name: string;\n  formattingGuide: string;\n  channels: { id: string; name: string }[];\n  users: { id: string; userName: string; displayName: string }[];\n}\n\nexport interface ChatAdapter {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  getPlatformInfo(): PlatformInfo;\n}\n\n// ============================================================================\n// Generic cross-platform event and bot interfaces\n// ============================================================================\n\n/**\n * A platform-agnostic event (message/mention) that triggers the agent.\n */\nexport interface BotEvent {\n  type: string;\n  /** Platform-specific raw conversation/channel/chat identifier */\n  conversationId: string;\n  /** Cross-platform conversation shape: direct message vs shared space */\n  conversationKind: ConversationKind;\n  /** Message timestamp or ID as string */\n  ts: string;\n  /** Parent message ID for threaded replies (optional) */\n  thread_ts?: string;\n  /** User ID */\n  user: string;\n  /** Message text (already stripped of bot mentions) */\n  text: string;\n  /** Downloaded attachments */\n  attachments?: { name: string; localPath: string }[];\n  /** Platform-computed session key; overrides default conversationId:thread_ts computation */\n  sessionKey?: string;\n}\n\n/**\n * Minimum interface that every platform bot must implement,\n * used by the central handler in main.ts and by EventsWatcher.\n */\nexport interface Bot {\n  start(): Promise<void>;\n  postMessage(channel: string, text: string): Promise<string>;\n  updateMessage(channel: string, ts: string, text: string): Promise<void>;\n  enqueueEvent(event: BotEvent): boolean;\n  getPlatformInfo(): PlatformInfo;\n}\n\n/** Pre-created platform adapters passed to the handler */\nexport interface BotAdapters {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n}\n\n/**\n * Handler callbacks invoked by each platform bot.\n * Each bot creates platform-specific adapters before calling handleEvent.\n */\nexport interface RunningSession {\n  sessionKey: string;\n  startedAt: number; // Date.now() when run started\n  /** Last activity timestamp (for detecting hung tasks) */\n  lastActivityAt?: number;\n  /** Current tool/step being executed (if any) */\n  currentTool?: string;\n}\n\nexport interface BotHandler {\n  isRunning(sessionKey: string): boolean;\n  getRunningSessions(): RunningSession[];\n  handleEvent(event: BotEvent, bot: Bot, adapters: BotAdapters, isEvent?: boolean): Promise<void>;\n  handleStop(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n  /** Force stop a running session (bypass normal stop mechanism) */\n  forceStop(sessionKey: string): void;\n  /** Reset a session: abort if running, delete history, remove from cache */\n  handleNew(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n}\n\n/** @deprecated Use BotHandler */\nexport type MomHandler = BotHandler;\n"]}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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","sourcesContent":["export type ConversationKind = \"direct\" | \"shared\";\n\nexport interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  conversationKind: ConversationKind;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n  threadTs?: string;\n}\n\nexport interface ChatToolResult {\n  toolName: string;\n  label?: string;\n  args?: Record<string, unknown>;\n  result: string;\n  isError: boolean;\n  durationMs: number;\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string): Promise<void>;\n  respondDiagnostic(text: string, options?: { style?: \"muted\" | \"error\" }): Promise<void>;\n  respondToolResult(result: ChatToolResult): Promise<void>;\n  setTyping(isTyping: boolean): Promise<void>;\n  setWorking(working: boolean): Promise<void>;\n  uploadFile(filePath: string, title?: string): Promise<void>;\n  deleteResponse(): Promise<void>;\n}\n\nexport interface PlatformInfo {\n  name: string;\n  formattingGuide: string;\n  channels: { id: string; name: string }[];\n  users: { id: string; userName: string; displayName: string }[];\n  diagnostics?: {\n    showUsageSummary?: boolean;\n  };\n}\n\nexport interface ChatAdapter {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  getPlatformInfo(): PlatformInfo;\n}\n\n// ============================================================================\n// Generic cross-platform event and bot interfaces\n// ============================================================================\n\n/**\n * A platform-agnostic event (message/mention) that triggers the agent.\n */\nexport interface BotEvent {\n  type: string;\n  /** Platform-specific raw conversation/channel/chat identifier */\n  conversationId: string;\n  /** Cross-platform conversation shape: direct message vs shared space */\n  conversationKind: ConversationKind;\n  /** Message timestamp or ID as string */\n  ts: string;\n  /** Parent message ID for threaded replies (optional) */\n  thread_ts?: string;\n  /** User ID */\n  user: string;\n  /** Message text (already stripped of bot mentions) */\n  text: string;\n  /** Downloaded attachments */\n  attachments?: { name: string; localPath: string }[];\n  /** Platform-computed session key; overrides default conversationId:thread_ts computation */\n  sessionKey?: string;\n}\n\n/**\n * Minimum interface that every platform bot must implement,\n * used by the central handler in main.ts and by EventsWatcher.\n */\nexport interface Bot {\n  start(): Promise<void>;\n  postMessage(channel: string, text: string): Promise<string>;\n  updateMessage(channel: string, ts: string, text: string): Promise<void>;\n  enqueueEvent(event: BotEvent): boolean;\n  getPlatformInfo(): PlatformInfo;\n}\n\n/** Pre-created platform adapters passed to the handler */\nexport interface BotAdapters {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n}\n\n/**\n * Handler callbacks invoked by each platform bot.\n * Each bot creates platform-specific adapters before calling handleEvent.\n */\nexport interface RunningSession {\n  sessionKey: string;\n  startedAt: number; // Date.now() when run started\n  /** Last activity timestamp (for detecting hung tasks) */\n  lastActivityAt?: number;\n  /** Current tool/step being executed (if any) */\n  currentTool?: string;\n}\n\nexport interface BotHandler {\n  isRunning(sessionKey: string): boolean;\n  getRunningSessions(): RunningSession[];\n  handleEvent(event: BotEvent, bot: Bot, adapters: BotAdapters, isEvent?: boolean): Promise<void>;\n  handleStop(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n  /** Force stop a running session (bypass normal stop mechanism) */\n  forceStop(sessionKey: string): void;\n  /** Reset a session: abort if running, delete history, remove from cache */\n  handleNew(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n}\n"]}

package/dist/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"","sourcesContent":["export type ConversationKind = \"direct\" | \"shared\";\n\nexport interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  conversationKind: ConversationKind;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n  threadTs?: string;\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string): Promise<void>;\n  respondInThread(text: string, options?: { style?: \"muted\" }): Promise<void>;\n  setTyping(isTyping: boolean): Promise<void>;\n  setWorking(working: boolean): Promise<void>;\n  uploadFile(filePath: string, title?: string): Promise<void>;\n  deleteResponse(): Promise<void>;\n}\n\nexport interface PlatformInfo {\n  name: string;\n  formattingGuide: string;\n  channels: { id: string; name: string }[];\n  users: { id: string; userName: string; displayName: string }[];\n}\n\nexport interface ChatAdapter {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  getPlatformInfo(): PlatformInfo;\n}\n\n// ============================================================================\n// Generic cross-platform event and bot interfaces\n// ============================================================================\n\n/**\n * A platform-agnostic event (message/mention) that triggers the agent.\n */\nexport interface BotEvent {\n  type: string;\n  /** Platform-specific raw conversation/channel/chat identifier */\n  conversationId: string;\n  /** Cross-platform conversation shape: direct message vs shared space */\n  conversationKind: ConversationKind;\n  /** Message timestamp or ID as string */\n  ts: string;\n  /** Parent message ID for threaded replies (optional) */\n  thread_ts?: string;\n  /** User ID */\n  user: string;\n  /** Message text (already stripped of bot mentions) */\n  text: string;\n  /** Downloaded attachments */\n  attachments?: { name: string; localPath: string }[];\n  /** Platform-computed session key; overrides default conversationId:thread_ts computation */\n  sessionKey?: string;\n}\n\n/**\n * Minimum interface that every platform bot must implement,\n * used by the central handler in main.ts and by EventsWatcher.\n */\nexport interface Bot {\n  start(): Promise<void>;\n  postMessage(channel: string, text: string): Promise<string>;\n  updateMessage(channel: string, ts: string, text: string): Promise<void>;\n  enqueueEvent(event: BotEvent): boolean;\n  getPlatformInfo(): PlatformInfo;\n}\n\n/** Pre-created platform adapters passed to the handler */\nexport interface BotAdapters {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n}\n\n/**\n * Handler callbacks invoked by each platform bot.\n * Each bot creates platform-specific adapters before calling handleEvent.\n */\nexport interface RunningSession {\n  sessionKey: string;\n  startedAt: number; // Date.now() when run started\n  /** Last activity timestamp (for detecting hung tasks) */\n  lastActivityAt?: number;\n  /** Current tool/step being executed (if any) */\n  currentTool?: string;\n}\n\nexport interface BotHandler {\n  isRunning(sessionKey: string): boolean;\n  getRunningSessions(): RunningSession[];\n  handleEvent(event: BotEvent, bot: Bot, adapters: BotAdapters, isEvent?: boolean): Promise<void>;\n  handleStop(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n  /** Force stop a running session (bypass normal stop mechanism) */\n  forceStop(sessionKey: string): void;\n  /** Reset a session: abort if running, delete history, remove from cache */\n  handleNew(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n}\n\n/** @deprecated Use BotHandler */\nexport type MomHandler = BotHandler;\n"]}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"","sourcesContent":["export type ConversationKind = \"direct\" | \"shared\";\n\nexport interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  conversationKind: ConversationKind;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n  threadTs?: string;\n}\n\nexport interface ChatToolResult {\n  toolName: string;\n  label?: string;\n  args?: Record<string, unknown>;\n  result: string;\n  isError: boolean;\n  durationMs: number;\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string): Promise<void>;\n  respondDiagnostic(text: string, options?: { style?: \"muted\" | \"error\" }): Promise<void>;\n  respondToolResult(result: ChatToolResult): Promise<void>;\n  setTyping(isTyping: boolean): Promise<void>;\n  setWorking(working: boolean): Promise<void>;\n  uploadFile(filePath: string, title?: string): Promise<void>;\n  deleteResponse(): Promise<void>;\n}\n\nexport interface PlatformInfo {\n  name: string;\n  formattingGuide: string;\n  channels: { id: string; name: string }[];\n  users: { id: string; userName: string; displayName: string }[];\n  diagnostics?: {\n    showUsageSummary?: boolean;\n  };\n}\n\nexport interface ChatAdapter {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  getPlatformInfo(): PlatformInfo;\n}\n\n// ============================================================================\n// Generic cross-platform event and bot interfaces\n// ============================================================================\n\n/**\n * A platform-agnostic event (message/mention) that triggers the agent.\n */\nexport interface BotEvent {\n  type: string;\n  /** Platform-specific raw conversation/channel/chat identifier */\n  conversationId: string;\n  /** Cross-platform conversation shape: direct message vs shared space */\n  conversationKind: ConversationKind;\n  /** Message timestamp or ID as string */\n  ts: string;\n  /** Parent message ID for threaded replies (optional) */\n  thread_ts?: string;\n  /** User ID */\n  user: string;\n  /** Message text (already stripped of bot mentions) */\n  text: string;\n  /** Downloaded attachments */\n  attachments?: { name: string; localPath: string }[];\n  /** Platform-computed session key; overrides default conversationId:thread_ts computation */\n  sessionKey?: string;\n}\n\n/**\n * Minimum interface that every platform bot must implement,\n * used by the central handler in main.ts and by EventsWatcher.\n */\nexport interface Bot {\n  start(): Promise<void>;\n  postMessage(channel: string, text: string): Promise<string>;\n  updateMessage(channel: string, ts: string, text: string): Promise<void>;\n  enqueueEvent(event: BotEvent): boolean;\n  getPlatformInfo(): PlatformInfo;\n}\n\n/** Pre-created platform adapters passed to the handler */\nexport interface BotAdapters {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n}\n\n/**\n * Handler callbacks invoked by each platform bot.\n * Each bot creates platform-specific adapters before calling handleEvent.\n */\nexport interface RunningSession {\n  sessionKey: string;\n  startedAt: number; // Date.now() when run started\n  /** Last activity timestamp (for detecting hung tasks) */\n  lastActivityAt?: number;\n  /** Current tool/step being executed (if any) */\n  currentTool?: string;\n}\n\nexport interface BotHandler {\n  isRunning(sessionKey: string): boolean;\n  getRunningSessions(): RunningSession[];\n  handleEvent(event: BotEvent, bot: Bot, adapters: BotAdapters, isEvent?: boolean): Promise<void>;\n  handleStop(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n  /** Force stop a running session (bypass normal stop mechanism) */\n  forceStop(sessionKey: string): void;\n  /** Reset a session: abort if running, delete history, remove from cache */\n  handleNew(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n}\n"]}

package/dist/adapters/discord/bot.d.ts

@@ -28,6 +28,7 @@ export declare class DiscordBot implements Bot {
     deleteMessageRaw(channelId: string, messageId: string): Promise<void>;
     sendTyping(channelId: string): Promise<void>;
     uploadFile(channelId: string, filePath: string, title?: string): Promise<void>;
+    sendDirectMessage(userId: string, text: string): Promise<string>;
     getAllChannels(): {
         id: string;
         name: string;
@@ -40,18 +41,20 @@ export declare class DiscordBot implements Bot {
     logToFile(channelId: string, entry: object): void;
     logBotResponse(channelId: string, text: string, ts: string): void;
     /**
-     * Process attachments from a Discord message
-     * Downloads files in background and returns metadata
-     * Returns format compatible with ChatMessage: { name: string, localPath: string }[]
+     * Process attachments from a Discord message.
+     * Downloads files before returning so the agent can read them immediately.
      */
-    processAttachments(channelId: string, attachments: Collection<string, Attachment>, _messageId: string): {
+    processAttachments(channelId: string, attachments: Collection<string, Attachment>, _messageId: string): Promise<{
         name: string;
         localPath: string;
-    }[];
+    }[]>;
     private downloadAttachment;
     private getQueue;
+    private resolveStopTarget;
     private loadCachedGuildData;
     private stripBotMention;
+    private resolveConversationContext;
+    private createSessionSlashAdapters;
     private setupEventHandlers;
     private fetchTextChannel;
 }

package/dist/adapters/discord/bot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/adapters/discord/bot.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Client,\n  Events,\n  GatewayIntentBits,\n  Partials,\n  type Collection,\n  type Message,\n  type Attachment,\n  type TextChannel,\n  type DMChannel,\n  type NewsChannel,\n  type ThreadChannel,\n} from \"discord.js\";\nimport { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { basename, join } from \"path\";\n\nimport type { Bot, BotEvent, BotHandler, PlatformInfo } from \"../../adapter.js\";\nimport * as log from \"../../log.js\";\nimport { formatAlreadyWorking, formatNothingRunning } from \"../../ui-copy.js\";\nimport { createDiscordAdapters } from \"./context.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface DiscordEvent extends BotEvent {\n  type: \"mention\" | \"dm\";\n  userName?: string;\n}\n\n// ============================================================================\n// Per-channel queue for sequential processing\n// ============================================================================\n\ntype QueuedWork = () => Promise<void>;\n\nclass ChannelQueue {\n  private queue: QueuedWork[] = [];\n  private processing = false;\n\n  enqueue(work: QueuedWork): void {\n    this.queue.push(work);\n    this.processNext();\n  }\n\n  size(): number {\n    return this.queue.length;\n  }\n\n  private async processNext(): Promise<void> {\n    if (this.processing || this.queue.length === 0) return;\n    this.processing = true;\n    const work = this.queue.shift()!;\n    try {\n      await work();\n    } catch (err) {\n      log.logWarning(\"Discord queue error\", err instanceof Error ? err.message : String(err));\n    }\n    this.processing = false;\n    this.processNext();\n  }\n}\n\n// ============================================================================\n// DiscordBot\n// ============================================================================\n\nexport class DiscordBot implements Bot {\n  private client: Client;\n  private handler: BotHandler;\n  private workingDir: string;\n  private botUserId: string | null = null;\n  private queues = new Map<string, ChannelQueue>();\n  private startupTime: number = 0;\n  private channels = new Map<string, { id: string; name: string }>();\n  private users = new Map<string, { id: string; userName: string; displayName: string }>();\n\n  constructor(handler: BotHandler, config: { token: string; workingDir: string }) {\n    this.handler = handler;\n    this.workingDir = config.workingDir;\n    this.client = new Client({\n      intents: [\n        GatewayIntentBits.Guilds,\n        GatewayIntentBits.GuildMessages,\n        GatewayIntentBits.MessageContent,\n        GatewayIntentBits.DirectMessages,\n      ],\n      partials: [Partials.Channel, Partials.Message],\n    });\n  }\n\n  // ==========================================================================\n  // Public API (implements Bot)\n  // ==========================================================================\n\n  async start(): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      this.client.once(Events.ClientReady, (readyClient) => {\n        this.botUserId = readyClient.user.id;\n        this.startupTime = Date.now();\n        log.logConnected();\n        log.logInfo(`Discord bot started as ${readyClient.user.tag}`);\n        this.loadCachedGuildData();\n        this.setupEventHandlers();\n        resolve();\n      });\n      this.client.once(Events.Error, reject);\n      this.client.login(process.env.MOM_DISCORD_BOT_TOKEN!).catch(reject);\n    });\n  }\n\n  async postMessage(channel: string, text: string): Promise<string> {\n    const ch = await this.fetchTextChannel(channel);\n    const msg = await ch.send(text);\n    return msg.id;\n  }\n\n  async updateMessage(channel: string, ts: string, text: string): Promise<void> {\n    await this.updateMessageRaw(channel, ts, text);\n  }\n\n  enqueueEvent(event: BotEvent): boolean {\n    const conversationId = event.conversationId;\n    const queue = this.getQueue(conversationId);\n    if (queue.size() >= 5) {\n      log.logWarning(\n        `Event queue full for ${conversationId}, discarding: ${event.text.substring(0, 50)}`,\n      );\n      return false;\n    }\n    log.logInfo(`Enqueueing event for ${conversationId}: ${event.text.substring(0, 50)}`);\n    queue.enqueue(() => {\n      const adapters = createDiscordAdapters(event as DiscordEvent, this, true);\n      return this.handler.handleEvent(event, this, adapters, true);\n    });\n    return true;\n  }\n\n  getPlatformInfo(): PlatformInfo {\n    return {\n      name: \"discord\",\n      formattingGuide:\n        \"## Discord Formatting (Markdown)\\nBold: **text**, Italic: *text*, Code: `code`, Block: ```language\\ncode```\\nLinks: [text](url)\",\n      channels: this.getAllChannels(),\n      users: this.getAllUsers(),\n    };\n  }\n\n  // ==========================================================================\n  // Internal helpers (used by context.ts)\n  // ==========================================================================\n\n  async updateMessageRaw(channelId: string, messageId: string, text: string): Promise<void> {\n    const ch = await this.fetchTextChannel(channelId);\n    const msg = await ch.messages.fetch(messageId);\n    await msg.edit(text);\n  }\n\n  async postReply(channelId: string, replyToId: string, text: string): Promise<string> {\n    const ch = await this.fetchTextChannel(channelId);\n    const replyTarget = await ch.messages.fetch(replyToId);\n    const sent = await replyTarget.reply(text);\n    return sent.id;\n  }\n\n  async postInThread(channelId: string, threadOrMessageId: string, text: string): Promise<string> {\n    // Try as a thread channel first, then fall back to posting in the channel\n    try {\n      const thread = await this.client.channels.fetch(threadOrMessageId);\n      if (thread && (thread.isThread() || thread.isTextBased())) {\n        const msg = await (thread as ThreadChannel).send(text);\n        return msg.id;\n      }\n    } catch {\n      // Not a thread channel, treat as message ID for reply\n    }\n    return this.postReply(channelId, threadOrMessageId, text);\n  }\n\n  async deleteMessageRaw(channelId: string, messageId: string): Promise<void> {\n    try {\n      const ch = await this.fetchTextChannel(channelId);\n      const msg = await ch.messages.fetch(messageId);\n      await msg.delete();\n    } catch {\n      // Ignore if already deleted\n    }\n  }\n\n  async sendTyping(channelId: string): Promise<void> {\n    try {\n      const ch = await this.fetchTextChannel(channelId);\n      await ch.sendTyping();\n    } catch {\n      // Non-fatal\n    }\n  }\n\n  async uploadFile(channelId: string, filePath: string, title?: string): Promise<void> {\n    const ch = await this.fetchTextChannel(channelId);\n    const fileName = title ?? basename(filePath);\n    const fileContent = readFileSync(filePath);\n    await ch.send({ files: [{ attachment: fileContent, name: fileName }] });\n  }\n\n  getAllChannels(): { id: string; name: string }[] {\n    return Array.from(this.channels.values());\n  }\n\n  getAllUsers(): { id: string; userName: string; displayName: string }[] {\n    return Array.from(this.users.values());\n  }\n\n  logToFile(channelId: string, entry: object): void {\n    const dir = join(this.workingDir, channelId);\n    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n    appendFileSync(join(dir, \"log.jsonl\"), `${JSON.stringify(entry)}\\n`);\n  }\n\n  logBotResponse(channelId: string, text: string, ts: string): void {\n    this.logToFile(channelId, {\n      date: new Date().toISOString(),\n      ts,\n      user: \"bot\",\n      text,\n      attachments: [],\n      isBot: true,\n    });\n  }\n\n  /**\n   * Process attachments from a Discord message\n   * Downloads files in background and returns metadata\n   * Returns format compatible with ChatMessage: { name: string, localPath: string }[]\n   */\n  processAttachments(\n    channelId: string,\n    attachments: Collection<string, Attachment>,\n    _messageId: string,\n  ): { name: string; localPath: string }[] {\n    const result: { name: string; localPath: string }[] = [];\n\n    // Discord attachments Collection - iterate over values\n    for (const attachment of attachments.values()) {\n      if (!attachment.name) {\n        log.logWarning(\"Discord attachment missing name, skipping\", attachment.url);\n        continue;\n      }\n\n      // Generate local filename\n      const ts = Date.now();\n      const sanitizedName = attachment.name.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n      const filename = `${ts}_${sanitizedName}`;\n      const localPath = `${channelId}/attachments/${filename}`;\n      const fullDir = join(this.workingDir, channelId, \"attachments\");\n\n      result.push({\n        name: attachment.name,\n        localPath: localPath,\n      });\n\n      // Download in background (fire and forget)\n      this.downloadAttachment(fullDir, filename, attachment.url).catch((err) => {\n        log.logWarning(`Failed to download Discord attachment`, `${filename}: ${err}`);\n      });\n    }\n\n    return result;\n  }\n\n  /**\n   * Download an attachment from URL to local file\n   */\n  private async downloadAttachment(dir: string, filename: string, url: string): Promise<void> {\n    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n\n    try {\n      const response = await fetch(url);\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const buffer = await response.arrayBuffer();\n      writeFileSync(join(dir, filename), Buffer.from(buffer));\n    } catch (err) {\n      throw new Error(`Download failed: ${err instanceof Error ? err.message : String(err)}`);\n    }\n  }\n\n  // ==========================================================================\n  // Private - Event Handlers\n  // ==========================================================================\n\n  private getQueue(channelId: string): ChannelQueue {\n    let queue = this.queues.get(channelId);\n    if (!queue) {\n      queue = new ChannelQueue();\n      this.queues.set(channelId, queue);\n    }\n    return queue;\n  }\n\n  private loadCachedGuildData(): void {\n    for (const guild of this.client.guilds.cache.values()) {\n      for (const channel of guild.channels.cache.values()) {\n        if (channel.isTextBased() && \"name\" in channel) {\n          this.channels.set(channel.id, { id: channel.id, name: channel.name ?? channel.id });\n        }\n      }\n      for (const member of guild.members.cache.values()) {\n        this.users.set(member.id, {\n          id: member.id,\n          userName: member.user.username,\n          displayName: member.displayName,\n        });\n      }\n    }\n  }\n\n  private stripBotMention(text: string): string {\n    if (!this.botUserId) return text;\n    return text.replace(new RegExp(`<@!?${this.botUserId}>`, \"g\"), \"\").trim();\n  }\n\n  private setupEventHandlers(): void {\n    this.client.on(Events.MessageCreate, async (msg: Message) => {\n      // Skip messages from before startup\n      if (msg.createdTimestamp < this.startupTime) return;\n      // Skip bot messages\n      if (msg.author.bot) return;\n      // Skip if bot isn't mentioned and it's not a DM\n      const isDM = msg.channel.type === 1; // ChannelType.DM = 1\n      const isMentioned = msg.mentions.users.has(this.botUserId ?? \"\");\n      if (!isDM && !isMentioned) return;\n\n      const channelId = msg.channelId;\n      const userId = msg.author.id;\n      const userName = msg.author.username;\n      const msgId = msg.id;\n\n      // Track user\n      this.users.set(userId, {\n        id: userId,\n        userName,\n        displayName: msg.member?.displayName ?? userName,\n      });\n\n      // Track channel\n      if (!this.channels.has(channelId) && \"name\" in msg.channel) {\n        const ch = msg.channel as TextChannel | NewsChannel;\n        this.channels.set(channelId, { id: channelId, name: ch.name });\n      }\n\n      // Thread: if this message is in a thread (has parentId) or is a reply\n      const isInThread = msg.channel.isThread();\n      const referencedMsgId = msg.reference?.messageId;\n      const threadTs = isInThread ? msg.channelId : referencedMsgId;\n      const sessionKey = `${channelId}:${threadTs ?? msgId}`;\n\n      const cleanedText = this.stripBotMention(msg.content);\n\n      // Process attachments (download in background)\n      const processedAttachments = this.processAttachments(channelId, msg.attachments, msgId);\n\n      const event: DiscordEvent = {\n        type: isDM ? \"dm\" : \"mention\",\n        conversationId: channelId,\n        conversationKind: isDM ? \"direct\" : \"shared\",\n        ts: msgId,\n        thread_ts: threadTs,\n        user: userId,\n        userName,\n        text: cleanedText,\n        attachments: processedAttachments,\n      };\n\n      // Log message\n      this.logToFile(channelId, {\n        date: msg.createdAt.toISOString(),\n        ts: msgId,\n        user: userId,\n        userName,\n        text: cleanedText,\n        attachments: processedAttachments,\n        isBot: false,\n      });\n\n      // Handle stop command\n      if (cleanedText.toLowerCase() === \"stop\" || cleanedText.toLowerCase() === \"/stop\") {\n        if (this.handler.isRunning(sessionKey)) {\n          this.handler.handleStop(sessionKey, channelId, this);\n        } else {\n          await this.postMessage(channelId, formatNothingRunning(\"discord\"));\n        }\n        return;\n      }\n\n      if (this.handler.isRunning(sessionKey)) {\n        await this.postMessage(channelId, formatAlreadyWorking(\"discord\", \"stop\"));\n      } else {\n        this.getQueue(sessionKey).enqueue(() => {\n          const adapters = createDiscordAdapters(event, this, false);\n          return this.handler.handleEvent(event, this, adapters, false);\n        });\n      }\n    });\n  }\n\n  private async fetchTextChannel(\n    channelId: string,\n  ): Promise<TextChannel | DMChannel | NewsChannel | ThreadChannel> {\n    const ch = await this.client.channels.fetch(channelId);\n    if (!ch || !ch.isTextBased()) {\n      throw new Error(`Channel ${channelId} is not a text channel`);\n    }\n    return ch as TextChannel | DMChannel | NewsChannel | ThreadChannel;\n  }\n}\n"]}
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/adapters/discord/bot.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Client,\n  Events,\n  GatewayIntentBits,\n  Partials,\n  type ChatInputCommandInteraction,\n  type Collection,\n  type Message,\n  type Attachment,\n  type TextChannel,\n  type DMChannel,\n  type NewsChannel,\n  type ThreadChannel,\n} from \"discord.js\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { basename, join } from \"path\";\n\nimport type {\n  Bot,\n  BotAdapters,\n  BotEvent,\n  BotHandler,\n  ChatMessage,\n  ChatResponseContext,\n  ChatToolResult,\n  PlatformInfo,\n} from \"../../adapter.js\";\nimport * as log from \"../../log.js\";\nimport { resolveChatSessionKey } from \"../../session-policy.js\";\nimport { formatNothingRunning } from \"../../ui-copy.js\";\nimport {\n  appendBotResponseLog,\n  appendChannelLog,\n  ChannelQueue,\n  resolveOnlyScopedStopTarget,\n  resolveStopTarget,\n  withRetry,\n} from \"../shared.js\";\nimport { createDiscordAdapters } from \"./context.js\";\n\n// discord.js: DiscordAPIError exposes `.status` (HTTP status) and a `.code`.\n// RateLimitError fires when the internal queue gives up. Both should retry.\nfunction discordIsRateLimited(err: Error): boolean {\n  if ((err as { status?: number }).status === 429) return true;\n  if ((err as { httpStatus?: number }).httpStatus === 429) return true;\n  if (err.name === \"RateLimitError\") return true;\n  return false;\n}\n\nconst discordRetry = <T>(fn: () => Promise<T>): Promise<T> =>\n  withRetry(fn, { isRateLimited: discordIsRateLimited });\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface DiscordEvent extends BotEvent {\n  type: \"mention\" | \"dm\";\n  userName?: string;\n}\n\n// ============================================================================\n// DiscordBot\n// ============================================================================\n\nexport class DiscordBot implements Bot {\n  private client: Client;\n  private handler: BotHandler;\n  private workingDir: string;\n  private botUserId: string | null = null;\n  private queues = new Map<string, ChannelQueue>();\n  private startupTime: number = 0;\n  private channels = new Map<string, { id: string; name: string }>();\n  private users = new Map<string, { id: string; userName: string; displayName: string }>();\n\n  constructor(handler: BotHandler, config: { token: string; workingDir: string }) {\n    this.handler = handler;\n    this.workingDir = config.workingDir;\n    this.client = new Client({\n      intents: [\n        GatewayIntentBits.Guilds,\n        GatewayIntentBits.GuildMessages,\n        GatewayIntentBits.MessageContent,\n        GatewayIntentBits.DirectMessages,\n      ],\n      partials: [Partials.Channel, Partials.Message],\n    });\n  }\n\n  // ==========================================================================\n  // Public API (implements Bot)\n  // ==========================================================================\n\n  async start(): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      this.client.once(Events.ClientReady, async (readyClient) => {\n        this.botUserId = readyClient.user.id;\n        this.startupTime = Date.now();\n        log.logConnected();\n        log.logInfo(`Discord bot started as ${readyClient.user.tag}`);\n        this.loadCachedGuildData();\n        this.setupEventHandlers();\n        try {\n          await readyClient.application.commands.set([\n            {\n              name: \"session\",\n              description: \"Open the current session in the web viewer\",\n            },\n          ]);\n        } catch (err) {\n          log.logWarning(\n            \"Failed to register Discord slash commands\",\n            err instanceof Error ? err.message : String(err),\n          );\n        }\n        resolve();\n      });\n      this.client.once(Events.Error, reject);\n      this.client.login(process.env.MOM_DISCORD_BOT_TOKEN!).catch(reject);\n    });\n  }\n\n  async postMessage(channel: string, text: string): Promise<string> {\n    return discordRetry(async () => {\n      const ch = await this.fetchTextChannel(channel);\n      const msg = await ch.send(text);\n      return msg.id;\n    });\n  }\n\n  async updateMessage(channel: string, ts: string, text: string): Promise<void> {\n    await this.updateMessageRaw(channel, ts, text);\n  }\n\n  enqueueEvent(event: BotEvent): boolean {\n    const conversationId = event.conversationId;\n    const queue = this.getQueue(conversationId);\n    if (queue.size() >= 5) {\n      log.logWarning(\n        `Event queue full for ${conversationId}, discarding: ${event.text.substring(0, 50)}`,\n      );\n      return false;\n    }\n    log.logInfo(`Enqueueing event for ${conversationId}: ${event.text.substring(0, 50)}`);\n    queue.enqueue(() => {\n      const adapters = createDiscordAdapters(event as DiscordEvent, this, true);\n      return this.handler.handleEvent(event, this, adapters, true);\n    });\n    return true;\n  }\n\n  getPlatformInfo(): PlatformInfo {\n    return {\n      name: \"discord\",\n      formattingGuide:\n        \"## Discord Formatting (Markdown)\\nBold: **text**, Italic: *text*, Code: `code`, Block: ```language\\ncode```\\nLinks: [text](url)\",\n      channels: this.getAllChannels(),\n      users: this.getAllUsers(),\n      diagnostics: {\n        showUsageSummary: false,\n      },\n    };\n  }\n\n  // ==========================================================================\n  // Internal helpers (used by context.ts)\n  // ==========================================================================\n\n  async updateMessageRaw(channelId: string, messageId: string, text: string): Promise<void> {\n    return discordRetry(async () => {\n      const ch = await this.fetchTextChannel(channelId);\n      const msg = await ch.messages.fetch(messageId);\n      await msg.edit(text);\n    });\n  }\n\n  async postReply(channelId: string, replyToId: string, text: string): Promise<string> {\n    return discordRetry(async () => {\n      const ch = await this.fetchTextChannel(channelId);\n      const replyTarget = await ch.messages.fetch(replyToId);\n      const sent = await replyTarget.reply(text);\n      return sent.id;\n    });\n  }\n\n  async postInThread(channelId: string, threadOrMessageId: string, text: string): Promise<string> {\n    // Try as a thread channel first, then fall back to posting in the channel\n    try {\n      const thread = await this.client.channels.fetch(threadOrMessageId);\n      if (thread && (thread.isThread() || thread.isTextBased())) {\n        return discordRetry(async () => {\n          const msg = await (thread as ThreadChannel).send(text);\n          return msg.id;\n        });\n      }\n    } catch {\n      // Not a thread channel, treat as message ID for reply\n    }\n    return this.postReply(channelId, threadOrMessageId, text);\n  }\n\n  async deleteMessageRaw(channelId: string, messageId: string): Promise<void> {\n    try {\n      const ch = await this.fetchTextChannel(channelId);\n      const msg = await ch.messages.fetch(messageId);\n      await msg.delete();\n    } catch {\n      // Ignore if already deleted\n    }\n  }\n\n  async sendTyping(channelId: string): Promise<void> {\n    try {\n      const ch = await this.fetchTextChannel(channelId);\n      await ch.sendTyping();\n    } catch {\n      // Non-fatal\n    }\n  }\n\n  async uploadFile(channelId: string, filePath: string, title?: string): Promise<void> {\n    return discordRetry(async () => {\n      const ch = await this.fetchTextChannel(channelId);\n      const fileName = title ?? basename(filePath);\n      const fileContent = readFileSync(filePath);\n      await ch.send({ files: [{ attachment: fileContent, name: fileName }] });\n    });\n  }\n\n  async sendDirectMessage(userId: string, text: string): Promise<string> {\n    return discordRetry(async () => {\n      const user = await this.client.users.fetch(userId);\n      const msg = await user.send(text);\n      return msg.id;\n    });\n  }\n\n  getAllChannels(): { id: string; name: string }[] {\n    return Array.from(this.channels.values());\n  }\n\n  getAllUsers(): { id: string; userName: string; displayName: string }[] {\n    return Array.from(this.users.values());\n  }\n\n  logToFile(channelId: string, entry: object): void {\n    appendChannelLog(this.workingDir, channelId, entry);\n  }\n\n  logBotResponse(channelId: string, text: string, ts: string): void {\n    appendBotResponseLog(this.workingDir, channelId, text, ts);\n  }\n\n  /**\n   * Process attachments from a Discord message.\n   * Downloads files before returning so the agent can read them immediately.\n   */\n  async processAttachments(\n    channelId: string,\n    attachments: Collection<string, Attachment>,\n    _messageId: string,\n  ): Promise<{ name: string; localPath: string }[]> {\n    const downloads: Array<Promise<{ name: string; localPath: string } | null>> = [];\n\n    // Discord attachments Collection - iterate over values\n    for (const attachment of attachments.values()) {\n      if (!attachment.name) {\n        log.logWarning(\"Discord attachment missing name, skipping\", attachment.url);\n        continue;\n      }\n\n      const ts = Date.now();\n      const sanitizedName = attachment.name.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n      const filename = `${ts}_${sanitizedName}`;\n      const localPath = `${channelId}/attachments/${filename}`;\n      const fullDir = join(this.workingDir, channelId, \"attachments\");\n      const result = {\n        name: attachment.name,\n        localPath,\n      };\n\n      downloads.push(\n        this.downloadAttachment(fullDir, filename, attachment.url)\n          .then(() => result)\n          .catch((err) => {\n            log.logWarning(`Failed to download Discord attachment`, `${filename}: ${err}`);\n            return null;\n          }),\n      );\n    }\n\n    const results = await Promise.all(downloads);\n    return results.filter(\n      (attachment): attachment is { name: string; localPath: string } => attachment !== null,\n    );\n  }\n\n  /**\n   * Download an attachment from URL to local file\n   */\n  private async downloadAttachment(dir: string, filename: string, url: string): Promise<void> {\n    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n\n    try {\n      const response = await fetch(url);\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const buffer = await response.arrayBuffer();\n      writeFileSync(join(dir, filename), Buffer.from(buffer));\n    } catch (err) {\n      throw new Error(`Download failed: ${err instanceof Error ? err.message : String(err)}`);\n    }\n  }\n\n  // ==========================================================================\n  // Private - Event Handlers\n  // ==========================================================================\n\n  private getQueue(channelId: string): ChannelQueue {\n    let queue = this.queues.get(channelId);\n    if (!queue) {\n      queue = new ChannelQueue(\"Discord\");\n      this.queues.set(channelId, queue);\n    }\n    return queue;\n  }\n\n  private resolveStopTarget(channelId: string, sessionKey: string): string | null {\n    const directTarget = resolveStopTarget({\n      handler: this.handler,\n      conversationId: channelId,\n      sessionKey,\n    });\n    if (directTarget) return directTarget;\n    if (sessionKey !== channelId) return null;\n    return resolveOnlyScopedStopTarget(this.handler, channelId);\n  }\n\n  private loadCachedGuildData(): void {\n    for (const guild of this.client.guilds.cache.values()) {\n      for (const channel of guild.channels.cache.values()) {\n        if (channel.isTextBased() && \"name\" in channel) {\n          this.channels.set(channel.id, { id: channel.id, name: channel.name ?? channel.id });\n        }\n      }\n      for (const member of guild.members.cache.values()) {\n        this.users.set(member.id, {\n          id: member.id,\n          userName: member.user.username,\n          displayName: member.displayName,\n        });\n      }\n    }\n  }\n\n  private stripBotMention(text: string): string {\n    if (!this.botUserId) return text;\n    return text.replace(new RegExp(`<@!?${this.botUserId}>`, \"g\"), \"\").trim();\n  }\n\n  private resolveConversationContext(input: {\n    channelId: string;\n    inGuild: boolean;\n    isThread: boolean;\n    parentChannelId?: string | null;\n    referencedMsgId?: string;\n  }): { conversationId: string; threadTs?: string } {\n    if (!input.inGuild) {\n      return {\n        conversationId: input.channelId,\n        threadTs: input.referencedMsgId,\n      };\n    }\n\n    if (input.isThread) {\n      return {\n        conversationId: input.parentChannelId ?? input.channelId,\n        threadTs: input.channelId,\n      };\n    }\n\n    return {\n      conversationId: input.channelId,\n      threadTs: input.referencedMsgId,\n    };\n  }\n\n  private createSessionSlashAdapters(\n    interaction: ChatInputCommandInteraction,\n    commandText: string,\n    sessionKey: string,\n    conversationId: string,\n  ): BotAdapters {\n    const isDM = !interaction.inGuild();\n    const userId = interaction.user.id;\n    const userName = interaction.user.username;\n    const platform = this.getPlatformInfo();\n    const shouldUseEphemeral = !isDM;\n\n    const message: ChatMessage = {\n      id: interaction.id,\n      sessionKey,\n      conversationKind: isDM ? \"direct\" : \"shared\",\n      userId,\n      userName,\n      text: commandText,\n      attachments: [],\n    };\n\n    const respondPrivately = async (text: string, replace = false): Promise<void> => {\n      if (interaction.replied || interaction.deferred) {\n        if (replace) {\n          await interaction.editReply({ content: text });\n        } else {\n          await interaction.followUp({ content: text, ephemeral: shouldUseEphemeral });\n        }\n        return;\n      }\n\n      await interaction.reply({ content: text, ephemeral: shouldUseEphemeral });\n    };\n\n    const responseCtx: ChatResponseContext = {\n      respond: async (text: string) => {\n        await respondPrivately(text);\n      },\n      replaceResponse: async (text: string) => {\n        await respondPrivately(text, true);\n      },\n      respondDiagnostic: async (text: string) => {\n        await respondPrivately(text);\n      },\n      respondToolResult: async (result: ChatToolResult) => {\n        const duration = (result.durationMs / 1000).toFixed(1);\n        const formatted = `${result.isError ? \"Error\" : \"Done\"} ${result.toolName} (${duration}s)\\n${result.result}`;\n        await respondPrivately(formatted);\n      },\n      setTyping: async () => {},\n      setWorking: async () => {},\n      uploadFile: async (filePath: string, title?: string) => {\n        await this.uploadFile(conversationId, filePath, title);\n      },\n      deleteResponse: async () => {},\n    };\n\n    return { message, responseCtx, platform };\n  }\n\n  private setupEventHandlers(): void {\n    this.client.on(Events.InteractionCreate, async (interaction) => {\n      if (!interaction.isChatInputCommand() || interaction.commandName !== \"session\") return;\n\n      const isDM = !interaction.inGuild();\n      const { conversationId, threadTs } = this.resolveConversationContext({\n        channelId: interaction.channelId,\n        inGuild: interaction.inGuild(),\n        isThread: interaction.channel?.isThread() ?? false,\n        parentChannelId:\n          interaction.channel && \"parentId\" in interaction.channel\n            ? interaction.channel.parentId\n            : null,\n      });\n      const sessionKey = resolveChatSessionKey({\n        conversationId,\n        conversationKind: isDM ? \"direct\" : \"shared\",\n        messageId: interaction.id,\n        persistentTopLevel: true,\n        threadTs,\n      });\n      const commandText = \"/session\";\n\n      this.logToFile(conversationId, {\n        date: new Date(interaction.createdTimestamp).toISOString(),\n        ts: interaction.id,\n        ...(threadTs ? { threadTs } : {}),\n        user: interaction.user.id,\n        userName: interaction.user.username,\n        text: commandText,\n        attachments: [],\n        isBot: false,\n      });\n\n      const event: BotEvent = {\n        type: \"dm\",\n        conversationId,\n        conversationKind: isDM ? \"direct\" : \"shared\",\n        ts: interaction.id,\n        thread_ts: threadTs,\n        sessionKey,\n        user: interaction.user.id,\n        text: commandText,\n        attachments: [],\n      };\n\n      const adapters = this.createSessionSlashAdapters(\n        interaction,\n        commandText,\n        sessionKey,\n        conversationId,\n      );\n      try {\n        await this.handler.handleEvent(event, this, adapters, false);\n      } catch (err) {\n        log.logWarning(\n          \"Discord slash command error\",\n          err instanceof Error ? err.message : String(err),\n        );\n        if (!interaction.replied && !interaction.deferred) {\n          await interaction.reply({\n            content: \"Session command failed. Please try again later.\",\n            ephemeral: !isDM,\n          });\n        }\n      }\n    });\n\n    this.client.on(Events.MessageCreate, async (msg: Message) => {\n      // Skip messages from before startup\n      if (msg.createdTimestamp < this.startupTime) return;\n      // Skip bot messages\n      if (msg.author.bot) return;\n      const isDM = msg.channel.type === 1; // ChannelType.DM = 1\n      const isInThread = msg.channel.isThread();\n      const referencedMsgId = msg.reference?.messageId;\n      const isThreadReply = isInThread || !!referencedMsgId;\n      const isMentioned = msg.mentions.users.has(this.botUserId ?? \"\");\n      // Shared-channel top-level messages require a mention. Thread/reply follow-ups do not.\n      if (!isDM && !isMentioned && !isThreadReply) return;\n\n      const { conversationId, threadTs } = this.resolveConversationContext({\n        channelId: msg.channelId,\n        inGuild: !isDM,\n        isThread: isInThread,\n        parentChannelId: \"parentId\" in msg.channel ? msg.channel.parentId : null,\n        referencedMsgId,\n      });\n      const userId = msg.author.id;\n      const userName = msg.author.username;\n      const msgId = msg.id;\n\n      // Track user\n      this.users.set(userId, {\n        id: userId,\n        userName,\n        displayName: msg.member?.displayName ?? userName,\n      });\n\n      // Track channel\n      if (!this.channels.has(conversationId) && \"name\" in msg.channel) {\n        const ch = msg.channel as TextChannel | NewsChannel;\n        this.channels.set(conversationId, { id: conversationId, name: ch.name });\n      }\n\n      const conversationKind = isDM ? \"direct\" : \"shared\";\n      const sessionKey = resolveChatSessionKey({\n        conversationId,\n        conversationKind,\n        messageId: msgId,\n        persistentTopLevel: true,\n        threadTs,\n      });\n\n      const cleanedText = this.stripBotMention(msg.content);\n\n      const processedAttachments = await this.processAttachments(\n        conversationId,\n        msg.attachments,\n        msgId,\n      );\n\n      const event: DiscordEvent = {\n        type: isDM ? \"dm\" : \"mention\",\n        conversationId,\n        conversationKind,\n        ts: msgId,\n        thread_ts: threadTs,\n        sessionKey,\n        user: userId,\n        userName,\n        text: cleanedText,\n        attachments: processedAttachments,\n      };\n\n      // Log message\n      this.logToFile(conversationId, {\n        date: msg.createdAt.toISOString(),\n        ts: msgId,\n        ...(!isDM && threadTs ? { threadTs } : {}),\n        user: userId,\n        userName,\n        text: cleanedText,\n        attachments: processedAttachments,\n        isBot: false,\n      });\n\n      // Handle stop command\n      if (cleanedText.toLowerCase() === \"stop\" || cleanedText.toLowerCase() === \"/stop\") {\n        const stopTarget = this.resolveStopTarget(conversationId, sessionKey);\n        if (stopTarget) {\n          this.handler.handleStop(stopTarget, conversationId, this);\n        } else {\n          await this.postMessage(conversationId, formatNothingRunning(\"discord\"));\n        }\n        return;\n      }\n\n      this.getQueue(sessionKey).enqueue(() => {\n        const adapters = createDiscordAdapters(event, this, false);\n        return this.handler.handleEvent(event, this, adapters, false);\n      });\n    });\n  }\n\n  private async fetchTextChannel(\n    channelId: string,\n  ): Promise<TextChannel | DMChannel | NewsChannel | ThreadChannel> {\n    const ch = await this.client.channels.fetch(channelId);\n    if (!ch || !ch.isTextBased()) {\n      throw new Error(`Channel ${channelId} is not a text channel`);\n    }\n    return ch as TextChannel | DMChannel | NewsChannel | ThreadChannel;\n  }\n}\n"]}