@geminixiang/mama 0.1.10 → 0.2.0-beta.1

package/README.md

@@ -45,14 +45,22 @@ We actively track the upstream `pi-mom` and plan to:
 ## Features
 
 - **Multi-platform** — Slack, Telegram, and Discord adapters out of the box
-- **Thread sessions** — each thread / reply chain gets its own isolated conversation context
-- **Concurrent threads** — multiple threads in the same channel run independently
-- **Sandbox execution** — run agent commands on host or inside a Docker container
+- **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 shared containers, per-user containers, or Firecracker VMs (see [docs/sandbox.md](docs/sandbox.md))
 - **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
 - **Multi-provider** — configure any provider/model supported by `pi-ai`
 
+## 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                |
+
 ## Requirements
 
 - Node.js >= 20
@@ -161,10 +169,14 @@ Or import this **App Manifest** directly (Settings → App Manifest → paste JS
 export MOM_SLACK_APP_TOKEN=xapp-...
 export MOM_SLACK_BOT_TOKEN=xoxb-...
 
-mama [--sandbox=host|docker:<container>] <working-directory>
+mama [--sandbox=host|container:<container>] <working-directory>
 ```
 
-The bot responds when `@mentioned` in any channel or via DM. Each Slack thread is a separate session.
+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.
 
 ---
 
@@ -172,11 +184,12 @@ The bot responds when `@mentioned` in any channel or via DM. Each Slack thread i
 
 1. Message [@BotFather](https://t.me/BotFather) → `/newbot` to create a bot and get the **Bot Token**.
 2. Optionally disable privacy mode (`/setprivacy → Disable`) so the bot can read group messages without being `@mentioned`.
+3. For OAuth login setup, see [docs/oauth/github.md](docs/oauth/github.md) and [docs/oauth/google-workspace.md](docs/oauth/google-workspace.md).
 
 ```bash
 export MOM_TELEGRAM_BOT_TOKEN=123456:ABC-...
 
-mama [--sandbox=host|docker:<container>] <working-directory>
+mama [--sandbox=host|container:<container>] <working-directory>
 ```
 
 - **Private chats** — every message is forwarded to the bot automatically.
@@ -196,7 +209,7 @@ mama [--sandbox=host|docker:<container>] <working-directory>
 ```bash
 export MOM_DISCORD_BOT_TOKEN=MTI...
 
-mama [--sandbox=host|docker:<container>] <working-directory>
+mama [--sandbox=host|container:<container>] <working-directory>
 ```
 
 - **Server channels** — the bot responds when `@mentioned`.
@@ -209,12 +222,20 @@ mama [--sandbox=host|docker:<container>] <working-directory>
 
 ## Options
 
-| Option                                 | Default | Description                                              |
-| -------------------------------------- | ------- | -------------------------------------------------------- |
-| `--sandbox=host`                       | ✓       | Run commands directly on host                            |
-| `--sandbox=docker:<name>`              |         | Run commands inside a Docker container                   |
-| `--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                                                             |
+| -------------------------------------- | --------- | ----------------------------------------------------------------------- |
+| `--sandbox=host`                       | ✓         | Run commands directly on host                                           |
+| `--sandbox=container:<name>`           |           | Run commands in a shared container (mama does not manage lifecycle)     |
+| `--sandbox=image:<image>`              |           | Auto-provision one Docker container per platform user from an image     |
+| `--sandbox=firecracker:<vm-id>:<path>` |           | Run commands inside a Firecracker microVM                               |
+| `--state-dir <path>`                   | `~/.mama` | Store operator-managed settings, vaults, and bindings outside workspace |
+| `--download <channel-id>`              |           | Download channel history to stdout and exit (Slack only)                |
+
+### Container Mode Semantics
+
+- `container:*` uses one shared container for all sessions/users. mama does not create/start/stop/delete this container.
+- `image:*` creates and restarts per-user containers named from the platform/user id. mama manages this container lifecycle.
+- `docker:*` is not supported; use `container:*` for a shared existing container or `image:*` for mama-managed per-user containers.
 
 ### Download channel history (Slack)
 
@@ -224,27 +245,31 @@ mama --download C0123456789
 
 ## Configuration
 
-Create `settings.json` in your working directory to override defaults:
+mama stores operator-managed configuration in `~/.mama` by default. Use `--state-dir <path>` to choose another location. Create or edit `settings.json` there:
 
 ```json
 {
   "provider": "anthropic",
-  "model": "claude-sonnet-4-5",
+  "model": "claude-sonnet-4-6",
   "thinkingLevel": "off",
   "sessionScope": "thread",
   "logFormat": "console",
-  "logLevel": "info"
+  "logLevel": "info",
+  "sentryDsn": "https://examplePublicKey@o0.ingest.sentry.io/0"
 }
 ```
 
 | Field           | Default             | Description                                              |
 | --------------- | ------------------- | -------------------------------------------------------- |
 | `provider`      | `anthropic`         | AI provider (env: `MOM_AI_PROVIDER`)                     |
-| `model`         | `claude-sonnet-4-5` | Model name (env: `MOM_AI_MODEL`)                         |
+| `model`         | `claude-sonnet-4-6` | 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`)             |
+
+When `sentryDsn` is set, mama sends Sentry events with sensitive prompt/tool content redacted before upload.
 
 ### GCP Cloud Logging (Compute Engine)
 
@@ -274,7 +299,6 @@ Logs appear in Cloud Logging under **Log name: `mama`**. Console output (stdout)
 
 ```
 <working-directory>/
-├── settings.json          # AI provider/model config
 ├── MEMORY.md              # Global memory (all channels)
 ├── SYSTEM.md              # Installed packages / env changes log
 ├── skills/                # Global skills (CLI tools)
@@ -286,11 +310,22 @@ Logs appear in Cloud Logging under **Log name: `mama`**. Console output (stdout)
     ├── scratch/           # Agent working directory
     ├── skills/            # Channel-specific skills
     └── sessions/
-        └── <thread-ts>/
-            └── context.jsonl   # LLM conversation context
+        ├── current                      # Pointer for the current channel session file
+        ├── 2026-04-05T18-04-31-010Z_1d92b3ad.jsonl
+        └── <thread-ts>.jsonl            # Fixed-path thread session file
+```
+
+Operator-managed state lives outside the workspace:
+
+```
+<state-dir>/
+├── settings.json          # AI provider/model/Sentry config
+└── vaults/
+    ├── vault.json         # Per-user vault routing
+    └── bindings.json      # Optional platform-user to vault mapping
 ```
 
-## Docker Sandbox
+## Container Sandbox
 
 ```bash
 # Create a container (mount your working directory to /workspace)
@@ -298,10 +333,32 @@ docker run -d --name mama-sandbox \
   -v /path/to/workspace:/workspace \
   alpine:latest sleep infinity
 
-# Start mama with Docker sandbox
-mama --sandbox=docker:mama-sandbox /path/to/workspace
+# Start mama with container sandbox
+mama --sandbox=container:mama-sandbox /path/to/workspace
+```
+
+## Managed Per-User Container Sandbox
+
+```bash
+# Build the bundled sandbox image once
+docker build -f docker/mama-sandbox.Dockerfile -t mama-sandbox:tools .
+
+# Then use it for per-user managed containers
+mama --sandbox=image:mama-sandbox:tools /path/to/workspace
 ```
 
+In this mode mama creates one container per platform user, mounts the workspace at `/workspace`, injects that user's vault environment variables into tool execution, and stops idle containers after the configured idle window. Containers are labeled for management (`mama.managed=true`, `mama.sandbox=image`, `mama.vault-id=<id>`), and mama reconciles managed containers on startup/restart (including legacy `mama-sandbox-*` containers).
+
+The bundled image at `docker/mama-sandbox.Dockerfile` starts from `ubuntu:24.04` and installs:
+
+- `gh`
+- `nvm` with Node.js and npm
+- `uv`
+- `gcloud`, `gsutil`, `bq`
+- `gws` via `npm install -g @googleworkspace/cli`
+
+The image symlinks those tools into `/usr/local/bin` so they remain available when mama executes commands with `sh -c` inside the sandbox container.
+
 ## Firecracker Sandbox
 
 Firecracker provides lightweight VM isolation with the security benefits of a hypervisor. Unlike Docker containers, Firecracker runs a full Linux kernel, providing stronger isolation.

package/dist/adapter.d.ts

@@ -44,8 +44,8 @@ export interface ChatAdapter {
  */
 export interface BotEvent {
     type: string;
-    /** Platform-specific channel/chat identifier */
-    channel: string;
+    /** Internal conversation identifier used by the shared runtime */
+    conversationId: string;
     /** Message timestamp or ID as string */
     ts: string;
     /** Parent message ID for threaded replies (optional) */
@@ -59,6 +59,8 @@ export interface BotEvent {
         name: string;
         localPath: string;
     }[];
+    /** Platform-computed session key; overrides default conversation:thread_ts computation */
+    sessionKey?: string;
 }
 /**
  * Minimum interface that every platform bot must implement,
@@ -66,8 +68,8 @@ export interface BotEvent {
  */
 export interface Bot {
     start(): Promise<void>;
-    postMessage(channel: string, text: string): Promise<string>;
-    updateMessage(channel: string, ts: string, text: string): Promise<void>;
+    postMessage(conversationId: string, text: string): Promise<string>;
+    updateMessage(conversationId: string, ts: string, text: string): Promise<void>;
     enqueueEvent(event: BotEvent): boolean;
     getPlatformInfo(): PlatformInfo;
 }
@@ -93,13 +95,13 @@ export interface BotHandler {
     isRunning(sessionKey: string): boolean;
     getRunningSessions(): RunningSession[];
     handleEvent(event: BotEvent, bot: Bot, adapters: BotAdapters, isEvent?: boolean): Promise<void>;
-    handleStop(sessionKey: string, channelId: string, bot: Bot): Promise<void>;
+    handleStop(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;
     /** Force stop a running session (bypass normal stop mechanism) */
     forceStop(sessionKey: string): void;
-    /** Resolve a raw session key through thread aliases (returns input if no alias exists) */
-    resolveSessionKey(rawKey: string): string;
-    /** Register an alias so that "channel:botReplyTs" resolves to the original sessionKey */
-    registerThreadAlias(aliasKey: string, sessionKey: string): void;
+    /** Reset a session: abort if running, delete history, remove from cache */
+    handleNew(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;
+    /** Handle credential onboarding for a user login command. */
+    handleLogin(platform: string, platformUserId: string, conversationId: string, bot: Bot, commandText: string, isPrivateConversation: boolean): Promise<void>;
 }
 /** @deprecated Use BotHandler */
 export type MomHandler = BotHandler;

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 interface ChatMessage {\n  id: string;\n  sessionKey: string;\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 channel/chat identifier */\n  channel: string;\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}\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, channelId: string, bot: Bot): Promise<void>;\n  /** Force stop a running session (bypass normal stop mechanism) */\n  forceStop(sessionKey: string): void;\n  /** Resolve a raw session key through thread aliases (returns input if no alias exists) */\n  resolveSessionKey(rawKey: string): string;\n  /** Register an alias so that \"channel:botReplyTs\" resolves to the original sessionKey */\n  registerThreadAlias(aliasKey: string, sessionKey: string): 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 interface ChatMessage {\n  id: string;\n  sessionKey: string;\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  /** Internal conversation identifier used by the shared runtime */\n  conversationId: string;\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 conversation: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(conversationId: string, text: string): Promise<string>;\n  updateMessage(conversationId: 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  /** Handle credential onboarding for a user login command. */\n  handleLogin(\n    platform: string,\n    platformUserId: string,\n    conversationId: string,\n    bot: Bot,\n    commandText: string,\n    isPrivateConversation: boolean,\n  ): Promise<void>;\n}\n\n/** @deprecated Use BotHandler */\nexport type MomHandler = BotHandler;\n"]}

package/dist/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"","sourcesContent":["export interface ChatMessage {\n  id: string;\n  sessionKey: string;\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 channel/chat identifier */\n  channel: string;\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}\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, channelId: string, bot: Bot): Promise<void>;\n  /** Force stop a running session (bypass normal stop mechanism) */\n  forceStop(sessionKey: string): void;\n  /** Resolve a raw session key through thread aliases (returns input if no alias exists) */\n  resolveSessionKey(rawKey: string): string;\n  /** Register an alias so that \"channel:botReplyTs\" resolves to the original sessionKey */\n  registerThreadAlias(aliasKey: string, sessionKey: string): 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 interface ChatMessage {\n  id: string;\n  sessionKey: string;\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  /** Internal conversation identifier used by the shared runtime */\n  conversationId: string;\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 conversation: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(conversationId: string, text: string): Promise<string>;\n  updateMessage(conversationId: 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  /** Handle credential onboarding for a user login command. */\n  handleLogin(\n    platform: string,\n    platformUserId: string,\n    conversationId: string,\n    bot: Bot,\n    commandText: string,\n    isPrivateConversation: boolean,\n  ): Promise<void>;\n}\n\n/** @deprecated Use BotHandler */\nexport type MomHandler = BotHandler;\n"]}

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

@@ -18,8 +18,8 @@ export declare class DiscordBot implements Bot {
         workingDir: string;
     });
     start(): Promise<void>;
-    postMessage(channel: string, text: string): Promise<string>;
-    updateMessage(channel: string, ts: string, text: string): Promise<void>;
+    postMessage(conversationId: string, text: string): Promise<string>;
+    updateMessage(conversationId: string, ts: string, text: string): Promise<void>;
     enqueueEvent(event: BotEvent): boolean;
     getPlatformInfo(): PlatformInfo;
     updateMessageRaw(channelId: string, messageId: string, text: string): Promise<void>;

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 { 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 queue = this.getQueue(event.channel);\n    if (queue.size() >= 5) {\n      log.logWarning(\n        `Event queue full for ${event.channel}, discarding: ${event.text.substring(0, 50)}`,\n      );\n      return false;\n    }\n    log.logInfo(`Enqueueing event for ${event.channel}: ${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        channel: channelId,\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, \"_Nothing running_\");\n        }\n        return;\n      }\n\n      if (this.handler.isRunning(sessionKey)) {\n        await this.postMessage(channelId, \"_Already working. Say `stop` to cancel._\");\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 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 { parseLoginCommand } from \"../../login.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(conversationId: string, text: string): Promise<string> {\n    const ch = await this.fetchTextChannel(conversationId);\n    const msg = await ch.send(text);\n    return msg.id;\n  }\n\n  async updateMessage(conversationId: string, ts: string, text: string): Promise<void> {\n    await this.updateMessageRaw(conversationId, ts, text);\n  }\n\n  enqueueEvent(event: BotEvent): boolean {\n    const queue = this.getQueue(event.conversationId);\n    if (queue.size() >= 5) {\n      log.logWarning(\n        `Event queue full for ${event.conversationId}, discarding: ${event.text.substring(0, 50)}`,\n      );\n      return false;\n    }\n    log.logInfo(`Enqueueing event for ${event.conversationId}: ${event.text.substring(0, 50)}`);\n    queue.enqueue(() => {\n      const discordEvent: DiscordEvent = {\n        ...event,\n        type: \"mention\",\n        conversationId: event.conversationId,\n      };\n      const adapters = createDiscordAdapters(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 channelDir = join(this.workingDir, channelId);\n    if (!existsSync(channelDir)) mkdirSync(channelDir, { recursive: true });\n    appendFileSync(join(channelDir, \"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 attachmentsDir = 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(attachmentsDir, 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(\n    attachmentsDir: string,\n    filename: string,\n    url: string,\n  ): Promise<void> {\n    if (!existsSync(attachmentsDir)) mkdirSync(attachmentsDir, { 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(attachmentsDir, 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        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      // Handle login command\n      if (parseLoginCommand(cleanedText)) {\n        await this.handler.handleLogin(\"discord\", userId, channelId, this, cleanedText, isDM);\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"]}

package/dist/adapters/discord/bot.js

@@ -1,7 +1,9 @@
 import { Client, Events, GatewayIntentBits, Partials, } from "discord.js";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { basename, join } from "path";
+import { parseLoginCommand } from "../../login.js";
 import * as log from "../../log.js";
+import { formatAlreadyWorking, formatNothingRunning } from "../../ui-copy.js";
 import { createDiscordAdapters } from "./context.js";
 class ChannelQueue {
     constructor() {
@@ -70,23 +72,28 @@ export class DiscordBot {
             this.client.login(process.env.MOM_DISCORD_BOT_TOKEN).catch(reject);
         });
     }
-    async postMessage(channel, text) {
-        const ch = await this.fetchTextChannel(channel);
+    async postMessage(conversationId, text) {
+        const ch = await this.fetchTextChannel(conversationId);
         const msg = await ch.send(text);
         return msg.id;
     }
-    async updateMessage(channel, ts, text) {
-        await this.updateMessageRaw(channel, ts, text);
+    async updateMessage(conversationId, ts, text) {
+        await this.updateMessageRaw(conversationId, ts, text);
     }
     enqueueEvent(event) {
-        const queue = this.getQueue(event.channel);
+        const queue = this.getQueue(event.conversationId);
         if (queue.size() >= 5) {
-            log.logWarning(`Event queue full for ${event.channel}, discarding: ${event.text.substring(0, 50)}`);
+            log.logWarning(`Event queue full for ${event.conversationId}, discarding: ${event.text.substring(0, 50)}`);
             return false;
         }
-        log.logInfo(`Enqueueing event for ${event.channel}: ${event.text.substring(0, 50)}`);
+        log.logInfo(`Enqueueing event for ${event.conversationId}: ${event.text.substring(0, 50)}`);
         queue.enqueue(() => {
-            const adapters = createDiscordAdapters(event, this, true);
+            const discordEvent = {
+                ...event,
+                type: "mention",
+                conversationId: event.conversationId,
+            };
+            const adapters = createDiscordAdapters(discordEvent, this, true);
             return this.handler.handleEvent(event, this, adapters, true);
         });
         return true;
@@ -159,10 +166,10 @@ export class DiscordBot {
         return Array.from(this.users.values());
     }
     logToFile(channelId, entry) {
-        const dir = join(this.workingDir, channelId);
-        if (!existsSync(dir))
-            mkdirSync(dir, { recursive: true });
-        appendFileSync(join(dir, "log.jsonl"), `${JSON.stringify(entry)}\n`);
+        const channelDir = join(this.workingDir, channelId);
+        if (!existsSync(channelDir))
+            mkdirSync(channelDir, { recursive: true });
+        appendFileSync(join(channelDir, "log.jsonl"), `${JSON.stringify(entry)}\n`);
     }
     logBotResponse(channelId, text, ts) {
         this.logToFile(channelId, {
@@ -192,13 +199,13 @@ export class DiscordBot {
             const sanitizedName = attachment.name.replace(/[^a-zA-Z0-9._-]/g, "_");
             const filename = `${ts}_${sanitizedName}`;
             const localPath = `${channelId}/attachments/${filename}`;
-            const fullDir = join(this.workingDir, channelId, "attachments");
+            const attachmentsDir = join(this.workingDir, channelId, "attachments");
             result.push({
                 name: attachment.name,
                 localPath: localPath,
             });
             // Download in background (fire and forget)
-            this.downloadAttachment(fullDir, filename, attachment.url).catch((err) => {
+            this.downloadAttachment(attachmentsDir, filename, attachment.url).catch((err) => {
                 log.logWarning(`Failed to download Discord attachment`, `${filename}: ${err}`);
             });
         }
@@ -207,16 +214,16 @@ export class DiscordBot {
     /**
      * Download an attachment from URL to local file
      */
-    async downloadAttachment(dir, filename, url) {
-        if (!existsSync(dir))
-            mkdirSync(dir, { recursive: true });
+    async downloadAttachment(attachmentsDir, filename, url) {
+        if (!existsSync(attachmentsDir))
+            mkdirSync(attachmentsDir, { recursive: true });
         try {
             const response = await fetch(url);
             if (!response.ok) {
                 throw new Error(`HTTP ${response.status}: ${response.statusText}`);
             }
             const buffer = await response.arrayBuffer();
-            writeFileSync(join(dir, filename), Buffer.from(buffer));
+            writeFileSync(join(attachmentsDir, filename), Buffer.from(buffer));
         }
         catch (err) {
             throw new Error(`Download failed: ${err instanceof Error ? err.message : String(err)}`);
@@ -292,7 +299,7 @@ export class DiscordBot {
             const processedAttachments = this.processAttachments(channelId, msg.attachments, msgId);
             const event = {
                 type: isDM ? "dm" : "mention",
-                channel: channelId,
+                conversationId: channelId,
                 ts: msgId,
                 thread_ts: threadTs,
                 user: userId,
@@ -316,12 +323,17 @@ export class DiscordBot {
                     this.handler.handleStop(sessionKey, channelId, this);
                 }
                 else {
-                    await this.postMessage(channelId, "_Nothing running_");
+                    await this.postMessage(channelId, formatNothingRunning("discord"));
                 }
                 return;
             }
+            // Handle login command
+            if (parseLoginCommand(cleanedText)) {
+                await this.handler.handleLogin("discord", userId, channelId, this, cleanedText, isDM);
+                return;
+            }
             if (this.handler.isRunning(sessionKey)) {
-                await this.postMessage(channelId, "_Already working. Say `stop` to cancel._");
+                await this.postMessage(channelId, formatAlreadyWorking("discord", "stop"));
             }
             else {
                 this.getQueue(sessionKey).enqueue(() => {