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

package/README.md

@@ -47,7 +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 shared containers, per-user containers, or Firecracker VMs (see [docs/sandbox.md](docs/sandbox.md))
+- **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
@@ -55,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
 
@@ -99,7 +101,8 @@ npm run build
    - `assistant_thread_context_changed`, `assistant_thread_started`
    - `message.channels`, `message.groups`, `message.im`
 5. Enable **Interactivity** (Settings → Interactivity & Shortcuts → toggle on).
-6. Copy the **App-Level Token** (`xapp-…`) and **Bot Token** (`xoxb-…`).
+6. (Optional) Add **Slash Commands** such as `/pi-login` and `/pi-new` in the Slack app settings if you want dedicated commands with less naming conflict. `/pi-new` is intended for DM use only.
+7. Copy the **App-Level Token** (`xapp-…`) and **Bot Token** (`xoxb-…`).
 
 Or import this **App Manifest** directly (Settings → App Manifest → paste JSON):
 
@@ -169,14 +172,16 @@ 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|container:<container>] <working-directory>
+mama [--state-dir=~/.mama] [--sandbox=host|container:<container>|image:<image>|firecracker:<vm-id>:<path>] <working-directory>
 ```
 
 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.
 
 ---
 
@@ -184,17 +189,18 @@ The bot responds when `@mentioned` in any channel or via DM.
 
 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|container:<container>] <working-directory>
+mama [--state-dir=~/.mama] [--sandbox=host|container:<container>|image:<image>|firecracker:<vm-id>:<path>] <working-directory>
 ```
 
 - **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.
 
 ---
@@ -209,33 +215,38 @@ mama [--sandbox=host|container:<container>] <working-directory>
 ```bash
 export MOM_DISCORD_BOT_TOKEN=MTI...
 
-mama [--sandbox=host|container:<container>] <working-directory>
+mama [--state-dir=~/.mama] [--sandbox=host|container:<container>|image:<image>|firecracker:<vm-id>:<path>] <working-directory>
 ```
 
 - **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                                                             |
-| -------------------------------------- | --------- | ----------------------------------------------------------------------- |
-| `--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)                |
+| 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)           |
 
-### Container Mode Semantics
+### Sandbox and Vault 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.
+- `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. 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.
 
 ### Download channel history (Slack)
 
@@ -243,14 +254,51 @@ mama [--sandbox=host|container:<container>] <working-directory>
 mama --download C0123456789
 ```
 
+## `/login` Credential Onboarding
+
+For normal deployments, set `MOM_LINK_URL` to the externally reachable base URL of the web credential onboarding flow:
+
+```bash
+export MOM_LINK_URL="https://mama.example.com"
+# optional; defaults to 8181 when MOM_LINK_URL is set
+export MOM_LINK_PORT=8181
+```
+
+For local-only testing, you can set `MOM_LINK_PORT` without `MOM_LINK_URL`; mama will use `http://localhost:<port>` for the onboarding link.
+
+Users can then run `/login` in a private conversation with the bot. mama returns a 15-minute link for storing API keys or using built-in OAuth providers. `/login` is rejected in shared channels to avoid leaking onboarding links.
+
+On Slack, you can also register native slash commands such as `/pi-login` and `/pi-new`.
+
+- `/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)
+- [Google Workspace CLI OAuth](docs/oauth/google-workspace.md)
+
+Credentials are stored under `<state-dir>/vaults` (default `~/.mama/vaults`). Runtime env injection only happens in `container`, `image`, and `firecracker` modes.
+
 ## Configuration
 
-mama stores operator-managed configuration in `~/.mama` by default. Use `--state-dir <path>` to choose another location. Create or edit `settings.json` there:
+mama loads settings from `<state-dir>/settings.json` first, then falls back to `<working-directory>/settings.json` if the state-dir file is absent. For shared bot deployments, prefer the state-dir copy:
 
 ```json
 {
   "provider": "anthropic",
-  "model": "claude-sonnet-4-6",
+  "model": "claude-sonnet-4-5",
   "thinkingLevel": "off",
   "sessionScope": "thread",
   "logFormat": "console",
@@ -259,15 +307,15 @@ mama stores operator-managed configuration in `~/.mama` by default. Use `--state
 }
 ```
 
-| Field           | Default             | Description                                              |
-| --------------- | ------------------- | -------------------------------------------------------- |
-| `provider`      | `anthropic`         | AI provider (env: `MOM_AI_PROVIDER`)                     |
-| `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`)             |
+| 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.
 
@@ -284,7 +332,7 @@ Set `logFormat: "json"` to send structured logs directly to Cloud Logging via AP
 GOOGLE_CLOUD_PROJECT=<your-project-id> mama <working-directory>
 ```
 
-`settings.json`:
+In `<state-dir>/settings.json` (or `<working-directory>/settings.json` as a fallback):
 
 ```json
 {
@@ -295,72 +343,79 @@ GOOGLE_CLOUD_PROJECT=<your-project-id> mama <working-directory>
 
 Logs appear in Cloud Logging under **Log name: `mama`**. Console output (stdout) is unaffected and continues to work alongside Cloud Logging.
 
+## State Directory Layout
+
+```
+<state-dir>/
+├── settings.json          # Preferred provider/model/logging/Sentry config
+└── vaults/
+    ├── bindings.json      # Platform user -> vault mapping
+    ├── vault.json         # Vault metadata
+    └── <vault-id>/
+        ├── env            # Injected env vars
+        └── ...            # Credential files (e.g. gws.json, .ssh/)
+```
+
 ## Working Directory Layout
 
 ```
 <working-directory>/
+├── settings.json          # Optional fallback config if <state-dir>/settings.json is absent
 ├── MEMORY.md              # Global memory (all channels)
 ├── 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 current channel session file
+        ├── current                      # Pointer for the persistent top-level / direct session
         ├── 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
+        └── <session-suffix>.jsonl       # Fixed-path scoped session (thread / reply root)
 ```
 
 ## Container Sandbox
 
 ```bash
 # Create a container (mount your working directory to /workspace)
-docker run -d --name mama-sandbox \
+docker run -d --name mama-tools \
   -v /path/to/workspace:/workspace \
   alpine:latest sleep infinity
 
 # Start mama with container sandbox
-mama --sandbox=container:mama-sandbox /path/to/workspace
+mama --sandbox=container:mama-tools /path/to/workspace
 ```
 
+`container:mama-tools` uses vault key `container-mama-tools`. If multiple users share the same container, they share that container vault.
+
 ## Managed Per-User Container Sandbox
 
 ```bash
-# Build the bundled sandbox 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
 
-# Then use it for per-user managed containers
-mama --sandbox=image:mama-sandbox:tools /path/to/workspace
+# Start mama with managed image sandboxes
+mama --sandbox=image:ghcr.io/geminixiang/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).
+Or build the bundled image locally:
 
-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`
+```bash
+docker build -f docker/mama-sandbox.Dockerfile -t mama-sandbox:tools .
+mama --sandbox=image:mama-sandbox:tools /path/to/workspace
+```
 
-The image symlinks those tools into `/usr/local/bin` so they remain available when mama executes commands with `sh -c` inside the sandbox container.
+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
@@ -432,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", "channelId": "C0123456789", "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", "channelId": "C0123456789", "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", "channelId": "C0123456789", "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
@@ -473,12 +528,12 @@ npm run build   # production build
 
 ## 📦 Dependencies & Versions
 
-| Package                         | mama Version | pi-mom Synced Version         |
-| ------------------------------- | ------------ | ----------------------------- |
-| `@mariozechner/pi-agent-core`   | `^0.57.1`    | ✅ Synchronized               |
-| `@mariozechner/pi-ai`           | `^0.57.1`    | ✅ Synchronized               |
-| `@mariozechner/pi-coding-agent` | `^0.57.1`    | ✅ Synchronized               |
-| `@anthropic-ai/sandbox-runtime` | `^0.0.40`    | ⚠️ Newer (pi-mom uses 0.0.16) |
+| Package                         | mama Version | pi-mom Synced Version            |
+| ------------------------------- | ------------ | -------------------------------- |
+| `@mariozechner/pi-agent-core`   | `^0.69.0`    | ✅ Synchronized                  |
+| `@mariozechner/pi-ai`           | `^0.69.0`    | ✅ Synchronized                  |
+| `@mariozechner/pi-coding-agent` | `^0.69.0`    | ✅ Synchronized                  |
+| `@anthropic-ai/sandbox-runtime` | `^0.0.49`    | ⚠️ Newer than original fork base |
 
 ## License
 

package/dist/adapter.d.ts

@@ -1,6 +1,8 @@
+export type ConversationKind = "direct" | "shared";
 export interface ChatMessage {
     id: string;
     sessionKey: string;
+    conversationKind: ConversationKind;
     userId: string;
     userName?: string;
     text: string;
@@ -10,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>;
@@ -33,6 +44,9 @@ export interface PlatformInfo {
         userName: string;
         displayName: string;
     }[];
+    diagnostics?: {
+        showUsageSummary?: boolean;
+    };
 }
 export interface ChatAdapter {
     start(): Promise<void>;
@@ -44,8 +58,10 @@ export interface ChatAdapter {
  */
 export interface BotEvent {
     type: string;
-    /** Internal conversation identifier used by the shared runtime */
+    /** Platform-specific raw conversation/channel/chat identifier */
     conversationId: string;
+    /** Cross-platform conversation shape: direct message vs shared space */
+    conversationKind: ConversationKind;
     /** Message timestamp or ID as string */
     ts: string;
     /** Parent message ID for threaded replies (optional) */
@@ -59,7 +75,7 @@ export interface BotEvent {
         name: string;
         localPath: string;
     }[];
-    /** Platform-computed session key; overrides default conversation:thread_ts computation */
+    /** Platform-computed session key; overrides default conversationId:thread_ts computation */
     sessionKey?: string;
 }
 /**
@@ -68,8 +84,8 @@ export interface BotEvent {
  */
 export interface Bot {
     start(): Promise<void>;
-    postMessage(conversationId: string, text: string): Promise<string>;
-    updateMessage(conversationId: string, ts: string, text: string): Promise<void>;
+    postMessage(channel: string, text: string): Promise<string>;
+    updateMessage(channel: string, ts: string, text: string): Promise<void>;
     enqueueEvent(event: BotEvent): boolean;
     getPlatformInfo(): PlatformInfo;
 }
@@ -100,9 +116,5 @@ export interface BotHandler {
     forceStop(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;
 //# 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 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"]}
+{"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 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"]}
+{"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

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