@geminixiang/mikan 1.0.0-beta.7 → 1.0.0-beta.71

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="src/content/docs/assets/mikan.png" alt="mikan — multi-platform AI coding agent" width="100%">
+  <img src="src/content/docs/assets/mikan-office-hero.png" alt="mikan office architecture — conversation-scoped workspaces and sandbox execution" width="100%">
 </p>
 
 # @geminixiang/mikan
@@ -7,28 +7,35 @@
 [![npm version](https://img.shields.io/npm/v/@geminixiang/mikan.svg)](https://www.npmjs.com/package/@geminixiang/mikan)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A multi-platform AI coding agent for Slack, Telegram, and Discord.
+Self-hosted AI coding agent for organizations: every Slack channel and DM gets its own sandboxed workspace, credentials, and memory. Also speaks Telegram, Discord, and GitHub.
+
+> [!WARNING]
+> **Pre-1.0 status** — the overall framework stabilizes at 1.0.0. Until then, releases may change settings and on-disk data formats without migrations: upgrading between pre-1.0 versions can require resetting or manually adjusting existing state and workspace data.
 
 ## Architecture
 
 mikan keeps the chat record, agent session, and execution runtime separate:
 
-![mikan architecture](src/content/docs/assets/architecture.png)
+[![mikan architecture — runtime ownership, Pi v4 sessions, authorized execution, and response delivery](src/content/docs/assets/architecture.png)](docs/architecture.html)
+
+[Download the HTML/SVG source](docs/architecture.html) to view the full architecture diagram locally.
 
+- **Conversation office** is the unit everything else hangs off: one conversation's working area plus its own sandbox runtime. An office is identified by its platform and raw conversation id, and its directory is named by an office key (`v1-<platform>-<readable-id>-<hash>`), so two platforms can never collide on the same raw id.
 - **Chat / conversation data** is the platform-facing record: `log.jsonl`, attachments, and conversation files.
 - **Session orchestration** turns platform events into agent runs, handles top-level/thread scopes, and persists structured context under `sessions/*.jsonl`.
-- **mikan agent harness** (`src/harness/`, built on pi-agent-core and pi-ai) runs the model loop, session persistence, compaction, and calls mikan tools.
-- **Sandbox runtime** is where tool commands execute: host, Docker container/image, Firecracker, or Cloudflare bridge.
+- **mikan agent harness** (`src/harness/`, built on pi-agent-core and pi-ai) owns run preparation, authorized prompts/tools, response presentation, and native Pi session integration. Pi handles the model/tool loop, persistence, compaction, retries, and cancellation.
+- **Sandbox runtime** is where tool commands execute: host, Docker container/image, or the experimental Cloudflare bridge.
 - **Vault** provides runtime credentials as env vars and mounted secret files.
 
 ## Features
 
-- **Multi-platform** — Slack, Telegram, Discord adapters
+- **Multi-platform** — Slack, Telegram, Discord, and GitHub adapters
 - **Concurrent conversations** — Slack threads, Discord replies/threads, and Telegram reply chains run as independent sessions
-- **Sandbox execution** — host, shared container, per-user managed container, Firecracker (alpha), or Cloudflare bridge (experimental)
+- **Conversation offices** — one office directory and one sandbox runtime per conversation, with public/private visibility derived from the platform conversation type
+- **Sandbox execution** — host, shared container, per-conversation managed container, or Cloudflare bridge (experimental)
 - **Credential vaults** — `/login` stores credentials under `--state-dir` and injects env into sandbox runs
 - **Web session viewer** — read-only web view of the current session via `session` / `/session`
-- **Persistent memory** — workspace-level and channel-level `MEMORY.md`
+- **Persistent memory** — workspace-level and per-office `MEMORY.md`
 - **Skills** — drop CLI tools into `skills/`
 - **Events** — schedule one-shot or recurring tasks via JSON files
 - **Multi-provider** — any provider/model supported by `pi-ai`
@@ -51,57 +58,99 @@ npm install && npm run build
 
 ## Quick Start
 
-All platforms share the same CLI:
+Run mikan under [PM2](https://pm2.keymetrics.io/) so it stays up, restarts after failures, and starts on boot:
+
+```bash
+npm i -g @geminixiang/mikan pm2
+
+# One-time setup: create the state directory and settings
+mikan --onboard --state-dir=~/.mikan
+
+# Secrets live in ~/.mikan/mikan.env (0600), outside any repo tree
+curl -o ~/.mikan/mikan.env https://raw.githubusercontent.com/geminixiang/mikan/main/deploy/pm2/mikan.env.example
+chmod 600 ~/.mikan/mikan.env   # then fill in your tokens
+
+# Pull the sandbox image the default deployment runs tools in
+docker pull ghcr.io/geminixiang/mikan-sandbox:latest
+
+# Grab the maintained ecosystem file (supervision only), edit `args`
+curl -O https://raw.githubusercontent.com/geminixiang/mikan/main/deploy/pm2/ecosystem.config.cjs
+
+pm2 start ecosystem.config.cjs
+pm2 save
+pm2 startup   # run the printed command to enable boot autostart
+```
+
+Each file has one job: `settings.json` holds behavior (model, sandbox limits, reply modes — the Admin surface), `~/.mikan/mikan.env` holds secrets and platform tokens, and `ecosystem.config.cjs` holds process supervision only. In `ecosystem.config.cjs`, point `args` at your state dir, sandbox mode, and working directory (`mikan --help` documents the flags):
+
+```js
+args: "--state-dir=/srv/mikan/state --sandbox=image:ghcr.io/geminixiang/mikan-sandbox:latest /srv/mikan/workspace",
+```
+
+Set the platform tokens you need in `~/.mikan/mikan.env`; you can run multiple platforms at once. `mikan env` prints the full inventory and what is currently set:
 
 ```bash
-mikan [--state-dir=~/.mikan] [--sandbox=<mode>] <working-directory>
+SLACK_APP_TOKEN=xapp-...
+SLACK_BOT_TOKEN=xoxb-...
+TELEGRAM_BOT_TOKEN=123456:ABC-...
+DISCORD_BOT_TOKEN=MTI...
+GITHUB_APP_ID=123456
+GITHUB_INSTALLATION_ID=12345678
+GITHUB_APP_PRIVATE_KEY_PATH=/srv/mikan/github-app.pem
 ```
 
-Set the platform tokens you need; you can run multiple platforms at once:
+Tail logs with `pm2 logs mikan`; upgrade with `npm i -g @geminixiang/mikan && pm2 reload mikan`. See [the deployment guide](src/content/docs/deployment.mdx) for sandbox images, graceful shutdown, and the health endpoint.
+
+For a one-off foreground run, the same CLI works directly:
 
 ```bash
-export SLACK_APP_TOKEN=xapp-...
-export SLACK_BOT_TOKEN=xoxb-...
-export TELEGRAM_BOT_TOKEN=123456:ABC-...
-export DISCORD_BOT_TOKEN=MTI...
+mikan [--state-dir=~/.mikan] [--sandbox=<mode>] [<working-directory>]
 ```
 
+The working directory is optional: it defaults to `<state-dir>/workspace` (so `~/.mikan/workspace` with the default state dir) and is created on first run.
+
 ## Platforms
 
 - **Slack** — create a Socket Mode app using [src/content/docs/slack-bot-minimal-guide.md](src/content/docs/slack-bot-minimal-guide.md). The bot responds when `@mentioned` in channels and to all DMs.
 - **Telegram** — create a bot via [@BotFather](https://t.me/BotFather). The bot responds to private messages, `@mention`, and reply chains in groups.
 - **Discord** — create an application in the [Discord Developer Portal](https://discord.com/developers/applications), enable **Message Content Intent**, and invite it with message/file permissions.
+- **GitHub** — install a GitHub App (polling, no webhooks) and set `GITHUB_APP_ID`, `GITHUB_INSTALLATION_ID`, and a private key. One issue or PR is one conversation. See [src/content/docs/platform-adapters/github.md](src/content/docs/platform-adapters/github.md).
 
-Slack threads, Discord replies/threads, and Telegram reply chains are mapped to independent session scopes. See [src/content/docs/sessions.md](src/content/docs/sessions.md).
+Slack threads, Discord replies/threads, and Telegram reply chains are mapped to independent session scopes. See [src/content/docs/sessions.mdx](src/content/docs/sessions.mdx).
 
 ## Sandbox
 
-| Mode                         | Description                                                            |
-| ---------------------------- | ---------------------------------------------------------------------- |
-| `host` (default)             | Run on host; no vault env injection                                    |
-| `container:<name>`           | Run in an existing shared container; uses vault key `container-<name>` |
-| `image:<image>`              | Auto-provision one Docker container per resolved vault/user            |
-| `firecracker:<vm-id>:<path>` | Firecracker microVM (alpha; not recommended)                           |
-| `cloudflare:<sandbox-id>`    | Cloudflare Worker bridge (experimental; no auto workspace sync)        |
+| Mode                      | Description                                                                   |
+| ------------------------- | ----------------------------------------------------------------------------- |
+| `host` (default)          | Run on host; no vault env injection                                           |
+| `container:<name>`        | Run in an existing shared container; everyone sharing it shares its one vault |
+| `image:<image>`           | Auto-provision one Docker container and one vault per conversation office     |
+| `cloudflare:<sandbox-id>` | Cloudflare Worker bridge (experimental; no auto workspace sync)               |
+
+Each office is **public** or **private**, following the Slack conversation type: public channels are public — every other office can read them (read-only, under `/workspace/public/`) and they may write the shared `MEMORY.md` and `skills/`. Private channels, DMs, group DMs, and externally shared channels are private — visible only to themselves, reading shared knowledge and public offices without writing back. Unknown conversation kinds are private. The admin portal or `/pi-sandbox visibility private` can narrow a public channel; nothing can widen beyond Slack. Visibility governs data access only; execution isolation is unaffected.
+
+Only `image:*` enforces visibility. `host`, `container:*`, and `cloudflare:*` share one filesystem and are trusted deployments; a private office there is served with a logged warning.
 
-For routing, mounts, vault behavior, managed container details, and Firecracker/Cloudflare notes, see [src/content/docs/sandbox.md](src/content/docs/sandbox.md).
+For routing, mounts, vault behavior, managed container details, and Cloudflare notes, see [src/content/docs/sandbox.mdx](src/content/docs/sandbox.mdx).
 
 ## Chat commands
 
-| Command                                                    | Purpose                                          |
-| ---------------------------------------------------------- | ------------------------------------------------ |
-| `/login` / `/pi-login`                                     | Store API keys or run built-in OAuth flows       |
-| `session` / `/session`                                     | Open a read-only web view of the current session |
-| `new` / `/new`                                             | Reset the current session                        |
-| `model` / `/model` / `/pi-model provider/model[:thinking]` | Switch the LLM for the current conversation      |
-| `auto-reply` / `/pi-auto-reply on\|off\|status`            | Control group/channel auto-reply                 |
-| `stop` / `/stop`                                           | Stop the current run                             |
+| Command                                          | Purpose                                                        |
+| ------------------------------------------------ | -------------------------------------------------------------- |
+| `/login` / `/pi-login`                           | Store API keys or run built-in OAuth flows                     |
+| `session` / `/session`                           | Open a read-only web view of the current session               |
+| `/new` / `/pi-new`                               | Reset the current session                                      |
+| `/model` / `/pi-model provider/model[:thinking]` | Switch the LLM for the current conversation                    |
+| `/sandbox` / `/pi-sandbox [boost\|visibility …]` | Show sandbox status, boost limits, or narrow office visibility |
+| `/pi-auto-reply <on\|off>`                       | Toggle mention-free replies for the current Slack channel      |
+| `/admin` / `/pi-admin`                           | Open the admin portal                                          |
+| `stop` / `/stop`                                 | Stop the current run (works on every platform)                 |
 
-See [src/content/docs/commands.md](src/content/docs/commands.md) for command details and web session viewer setup.
+`session` is the only command accepted without a leading slash. See [src/content/docs/commands.mdx](src/content/docs/commands.mdx) for the full command reference and web session viewer setup.
 
 ## Configuration
 
-mikan reads global settings from `<state-dir>/settings.json`; per-conversation overrides live at `<working-directory>/<conversationId>/settings.json`.
+mikan reads global settings from `<state-dir>/settings.json`; host-only per-conversation overrides live at `<state-dir>/conversations/<office-key>/settings.json`. Legacy workspace settings are migrated once, then ignored.
 
 ```json
 {
@@ -120,14 +169,20 @@ See [src/content/docs/configuration.md](src/content/docs/configuration.md) for a
 ```text
 <state-dir>/
 ├── settings.json
+├── office-registry.json
+├── conversations/
+│   └── <office-key>/
+│       └── settings.json
 └── vaults/
 
 <working-directory>/
 ├── MEMORY.md
-├── SYSTEM.md
 ├── skills/
 ├── events/
-└── <conversation-id>/
+├── agents/
+└── <office-key>/
+    ├── MEMORY.md
+    ├── SYSTEM.md
     ├── log.jsonl
     ├── attachments/
     ├── scratch/
@@ -135,13 +190,16 @@ See [src/content/docs/configuration.md](src/content/docs/configuration.md) for a
     └── sessions/
 ```
 
+Office directories are named by office key (`v1-<platform>-<readable-id>-<hash>`) and are not reversible to a raw platform id, so `office-registry.json` records each office's `(platform, conversationId)`. `mikan office list` prints the registered offices; deployments created before the office layout are migrated on the next boot, and `mikan office claim <conversationId> <platform>` names the owner when boot cannot infer it.
+
 ## More docs
 
 - [Events](src/content/docs/events.md)
 - [Skills](src/content/docs/skills.md)
-- [Deployment](src/content/docs/deployment.md)
+- [Deployment](src/content/docs/deployment.mdx)
 - [Development](src/content/docs/development.md)
-- [Sandbox](src/content/docs/sandbox.md)
+- [Sandbox](src/content/docs/sandbox.mdx)
+- [Embedding mikan](deploy/examples/embedder/README.md) — build your own agent on the published package interface
 
 ## Slack: Download channel history
 
@@ -168,3 +226,5 @@ PRs welcome — see [CONTRIBUTING.md](CONTRIBUTING.md) for dev setup, commit sty
 ## License
 
 MIT — see [LICENSE](LICENSE).
+
+Slack auto-reply uses the conversation's `auto-reply` / `auto-reply.disabled` marker files. File contents are ignored: only the on/off marker name matters; rules and `llm.autoReply` judge-model settings remain retired.

package/dist/adapters/commands/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../src/adapters/commands/admin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjE,qBAAa,mBAAoB,YAAW,cAAc;IAClD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CA8BzD;CACF"}

package/dist/{commands → adapters/commands}/admin.js

@@ -1,15 +1,18 @@
-import { matchCommand } from "./parse.js";
-import { formatCommandSummary, replyPrivatelyWithContext } from "./utils.js";
-const ADMIN_COMMANDS = ["/admin", "/pi-admin"];
+import { slashForms, matchCommand } from "./manifest.js";
+import { portalNotConfiguredLines, replySummary, replySummaryPrivately } from "./utils.js";
+const ADMIN_COMMANDS = slashForms("admin");
 export class AdminCommandHandler {
     async tryHandle(context) {
         if (!matchCommand(context.commandText, ADMIN_COMMANDS, { stripMention: true }))
             return false;
+        if (!context.privateConversation && !context.bot.postPrivate) {
+            await replySummary(context, "Admin", [
+                "For privacy, open a direct conversation with mikan and run `/admin` there.",
+            ]);
+            return true;
+        }
         if (!context.services.portalBaseUrl) {
-            await replyPrivatelyWithContext(context, formatCommandSummary("Admin", [
-                "Admin portal is not configured.",
-                "Set `MIKAN_LINK_URL` or `MIKAN_LINK_PORT` on the server.",
-            ]), { style: "muted" });
+            await replySummaryPrivately(context, "Admin", portalNotConfiguredLines("Admin portal"));
             return true;
         }
         const platformUser = context.bot
@@ -23,7 +26,7 @@ export class AdminCommandHandler {
             ...(platformUserName ? { platformUserName } : {}),
         });
         const url = `${context.services.portalBaseUrl}/admin?token=${token.token}`;
-        await replyPrivatelyWithContext(context, formatCommandSummary("Admin", [url, "Expires: 30 minutes"]), { style: "muted" });
+        await replySummaryPrivately(context, "Admin", [url, "Expires: 30 minutes"]);
         return true;
     }
 }

package/dist/adapters/commands/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../../src/adapters/commands/admin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE3F,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;AAE3C,MAAM,OAAO,mBAAmB;IAC9B,KAAK,CAAC,SAAS,CAAC,OAAuB;QACrC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QAE7F,IAAI,CAAC,OAAO,CAAC,mBAAmB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YAC7D,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE;gBACnC,4EAA4E;aAC7E,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;YACpC,MAAM,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,wBAAwB,CAAC,cAAc,CAAC,CAAC,CAAC;YACxF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG;aAC7B,gBAAgB,EAAE;aAClB,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;QAC5D,MAAM,gBAAgB,GAAG,YAAY,EAAE,QAAQ,IAAI,YAAY,EAAE,WAAW,CAAC;QAE7E,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC;YACpD,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAC;QAC3E,MAAM,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC;IACd,CAAC;CACF","sourcesContent":["import { slashForms, matchCommand } from \"./manifest.js\";\nimport type { CommandContext, CommandHandler } from \"./types.js\";\nimport { portalNotConfiguredLines, replySummary, replySummaryPrivately } from \"./utils.js\";\n\nconst ADMIN_COMMANDS = slashForms(\"admin\");\n\nexport class AdminCommandHandler implements CommandHandler {\n  async tryHandle(context: CommandContext): Promise<boolean> {\n    if (!matchCommand(context.commandText, ADMIN_COMMANDS, { stripMention: true })) return false;\n\n    if (!context.privateConversation && !context.bot.postPrivate) {\n      await replySummary(context, \"Admin\", [\n        \"For privacy, open a direct conversation with mikan and run `/admin` there.\",\n      ]);\n      return true;\n    }\n\n    if (!context.services.portalBaseUrl) {\n      await replySummaryPrivately(context, \"Admin\", portalNotConfiguredLines(\"Admin portal\"));\n      return true;\n    }\n\n    const platformUser = context.bot\n      .getMessagingInfo()\n      .users.find((user) => user.id === context.platformUserId);\n    const platformUserName = platformUser?.userName || platformUser?.displayName;\n\n    const token = context.services.adminTokenStore.create({\n      platform: context.platform,\n      platformUserId: context.platformUserId,\n      conversationId: context.conversationId,\n      ...(platformUserName ? { platformUserName } : {}),\n    });\n\n    const url = `${context.services.portalBaseUrl}/admin?token=${token.token}`;\n    await replySummaryPrivately(context, \"Admin\", [url, \"Expires: 30 minutes\"]);\n    return true;\n  }\n}\n"]}

package/dist/{commands → adapters/commands}/auto-reply.d.ts

@@ -1,7 +1,4 @@
 import type { CommandContext, CommandHandler } from "./types.js";
-/**
- * @deprecated Auto-reply is kept for compatibility while its future is undecided.
- */
 export declare class AutoReplyCommandHandler implements CommandHandler {
     tryHandle(context: CommandContext): Promise<boolean>;
 }

package/dist/adapters/commands/auto-reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-reply.d.ts","sourceRoot":"","sources":["../../../src/adapters/commands/auto-reply.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAoBjE,qBAAa,uBAAwB,YAAW,cAAc;IACtD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BzD;CACF"}

package/dist/adapters/commands/auto-reply.js

@@ -0,0 +1,47 @@
+import { setSlackConversationAutoReply, slackConversationAutoReplyMode, } from "../../settings/index.js";
+import { slashForms, matchCommand } from "./manifest.js";
+import { replySummary } from "./utils.js";
+const AUTO_REPLY_COMMANDS = slashForms("autoreply");
+function isAutoReplyMode(value) {
+    return value === "on" || value === "off" || value === "jev";
+}
+function describeAutoReplyMode(mode) {
+    switch (mode) {
+        case "on":
+            return "Enabled. New messages in this channel will trigger mikan without a mention.";
+        case "jev":
+            return "Jev-assisted. Jev decides per message whether it addresses mikan.";
+        case "off":
+            return "Disabled. New messages in this channel must address mikan explicitly.";
+    }
+}
+export class AutoReplyCommandHandler {
+    async tryHandle(context) {
+        const matched = matchCommand(context.commandText, AUTO_REPLY_COMMANDS);
+        if (!matched)
+            return false;
+        if (context.platform !== "slack") {
+            await replySummary(context, "Auto-reply", [
+                "Auto-reply is currently available on Slack only.",
+            ]);
+            return true;
+        }
+        if (context.privateConversation) {
+            await replySummary(context, "Auto-reply", [
+                "Auto-reply only applies to shared channels. Direct messages already reply automatically.",
+            ]);
+            return true;
+        }
+        const value = matched.args[0]?.toLowerCase();
+        if (!isAutoReplyMode(value) || matched.args.length !== 1) {
+            await replySummary(context, "Auto-reply", ["Usage: `/pi-auto-reply <on|off|jev>`"]);
+            return true;
+        }
+        const office = context.services.workspace.office(context.address);
+        setSlackConversationAutoReply(office, value);
+        const mode = slackConversationAutoReplyMode(office);
+        await replySummary(context, "Auto-reply", [describeAutoReplyMode(mode)]);
+        return true;
+    }
+}
+//# sourceMappingURL=auto-reply.js.map

package/dist/adapters/commands/auto-reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-reply.js","sourceRoot":"","sources":["../../../src/adapters/commands/auto-reply.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,GAE/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,mBAAmB,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;AAEpD,SAAS,eAAe,CAAC,KAAyB;IAChD,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK,CAAC;AAC9D,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAwB;IACrD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,IAAI;YACP,OAAO,6EAA6E,CAAC;QACvF,KAAK,KAAK;YACR,OAAO,mEAAmE,CAAC;QAC7E,KAAK,KAAK;YACR,OAAO,uEAAuE,CAAC;IACnF,CAAC;AACH,CAAC;AAED,MAAM,OAAO,uBAAuB;IAClC,KAAK,CAAC,SAAS,CAAC,OAAuB;QACrC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;QACvE,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAE3B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE;gBACxC,kDAAkD;aACnD,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;YAChC,MAAM,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE;gBACxC,0FAA0F;aAC3F,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QAC7C,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,sCAAsC,CAAC,CAAC,CAAC;YACpF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClE,6BAA6B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,8BAA8B,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;CACF","sourcesContent":["import {\n  setSlackConversationAutoReply,\n  slackConversationAutoReplyMode,\n  type SlackAutoReplyMode,\n} from \"../../settings/index.js\";\nimport { slashForms, matchCommand } from \"./manifest.js\";\nimport type { CommandContext, CommandHandler } from \"./types.js\";\nimport { replySummary } from \"./utils.js\";\n\nconst AUTO_REPLY_COMMANDS = slashForms(\"autoreply\");\n\nfunction isAutoReplyMode(value: string | undefined): value is SlackAutoReplyMode {\n  return value === \"on\" || value === \"off\" || value === \"jev\";\n}\n\nfunction describeAutoReplyMode(mode: SlackAutoReplyMode): string {\n  switch (mode) {\n    case \"on\":\n      return \"Enabled. New messages in this channel will trigger mikan without a mention.\";\n    case \"jev\":\n      return \"Jev-assisted. Jev decides per message whether it addresses mikan.\";\n    case \"off\":\n      return \"Disabled. New messages in this channel must address mikan explicitly.\";\n  }\n}\n\nexport class AutoReplyCommandHandler implements CommandHandler {\n  async tryHandle(context: CommandContext): Promise<boolean> {\n    const matched = matchCommand(context.commandText, AUTO_REPLY_COMMANDS);\n    if (!matched) return false;\n\n    if (context.platform !== \"slack\") {\n      await replySummary(context, \"Auto-reply\", [\n        \"Auto-reply is currently available on Slack only.\",\n      ]);\n      return true;\n    }\n\n    if (context.privateConversation) {\n      await replySummary(context, \"Auto-reply\", [\n        \"Auto-reply only applies to shared channels. Direct messages already reply automatically.\",\n      ]);\n      return true;\n    }\n\n    const value = matched.args[0]?.toLowerCase();\n    if (!isAutoReplyMode(value) || matched.args.length !== 1) {\n      await replySummary(context, \"Auto-reply\", [\"Usage: `/pi-auto-reply <on|off|jev>`\"]);\n      return true;\n    }\n\n    const office = context.services.workspace.office(context.address);\n    setSlackConversationAutoReply(office, value);\n    const mode = slackConversationAutoReplyMode(office);\n    await replySummary(context, \"Auto-reply\", [describeAutoReplyMode(mode)]);\n    return true;\n  }\n}\n"]}

package/dist/adapters/commands/login.d.ts

@@ -0,0 +1,6 @@
+import type { CommandContext, CommandHandler, ParsedLoginCommand } from "./types.js";
+export declare function parseLoginCommand(text: string): ParsedLoginCommand | null;
+export declare class LoginCommandHandler implements CommandHandler {
+    tryHandle(context: CommandContext): Promise<boolean>;
+}
+//# sourceMappingURL=login.d.ts.map

package/dist/adapters/commands/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../../src/adapters/commands/login.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQrF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAazE;AAkDD,qBAAa,mBAAoB,YAAW,cAAc;IAClD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBzD;CACF"}

package/dist/adapters/commands/login.js

@@ -0,0 +1,166 @@
+import * as log from "../../log.js";
+import { credentialAuthorizationKey, runtimeResourceKey } from "../../sandbox/identity.js";
+import { sharedVaultKey } from "../../vault/index.js";
+import { slashForms, matchCommand } from "./manifest.js";
+import { portalNotConfiguredLines, replySummary } from "./utils.js";
+import { createOfficeAddress } from "../../office/index.js";
+const LOGIN_COMMANDS = slashForms("login");
+const SHARED_OPERATIONS = ["create", "update", "delete"];
+export function parseLoginCommand(text) {
+    const matched = matchCommand(text, LOGIN_COMMANDS);
+    if (!matched)
+        return null;
+    const [subcommand, operation, name, ...extra] = matched.args;
+    if (!subcommand)
+        return { action: "setup" };
+    if (extra.length > 0)
+        return null;
+    const verb = subcommand.toLowerCase();
+    if (verb === "shared")
+        return parseSharedLogin(operation?.toLowerCase(), name);
+    if (verb === "copy" && operation && !name)
+        return { action: "copy_shared", name: operation };
+    // Backward-compatible provider arguments open the generic login page.
+    return operation ? null : { action: "setup" };
+}
+function parseSharedLogin(operation, name) {
+    if (operation === "list")
+        return name ? null : { action: "shared_list" };
+    const matched = SHARED_OPERATIONS.find((candidate) => candidate === operation);
+    if (!matched || !name)
+        return null;
+    return { action: `shared_${matched}`, name };
+}
+function ensureLoginVault(context) {
+    const { services, platformUserId, conversationId, vaultConversationId } = context;
+    // The vault target is a conversation on the same platform; a command may
+    // aim at another conversation's vault via vaultConversationId.
+    return credentialAuthorizationKey(services.sandbox, {
+        userId: platformUserId,
+        address: createOfficeAddress(context.address.platform, vaultConversationId ?? conversationId),
+    });
+}
+async function refreshCopiedVaultRuntime(context) {
+    if (context.services.sandbox.type !== "image")
+        return undefined;
+    const targetAddress = createOfficeAddress(context.address.platform, context.vaultConversationId ?? context.conversationId);
+    const cleared = context.services.runtime?.refreshConversationEnvironment(targetAddress);
+    if (cleared === false) {
+        return "A session is currently running, so the sandbox was not restarted. The copied credentials will be applied after the run finishes and the sandbox is recreated.";
+    }
+    if (!context.services.provisioner) {
+        return "The cached session was refreshed. The sandbox will pick up copied credentials on the next provision.";
+    }
+    // The provisioner names containers by runtime resource key, not by the
+    // credential key the vault copy used — the two identities differ in image
+    // mode (office key vs raw-conversation key). Removing by the wrong key
+    // would silently leave the real container running with stale mounts.
+    const resourceKey = runtimeResourceKey(context.services.sandbox, {
+        userId: context.platformUserId,
+        address: targetAddress,
+    });
+    await context.services.provisioner.remove(resourceKey);
+    return "The sandbox container was removed and will be recreated with the copied env and file mounts on the next message.";
+}
+export class LoginCommandHandler {
+    async tryHandle(context) {
+        const parsed = parseLoginCommand(context.commandText);
+        if (!parsed)
+            return false;
+        if (!context.privateConversation) {
+            await replySummary(context, "Vault", [
+                "為了保護你的憑證，`/login` 只能在與機器人的私訊中使用。",
+                "請先私訊機器人，再重新執行 `/login`。",
+            ]);
+            return true;
+        }
+        if (parsed.action === "shared_list")
+            await listSharedProfiles(context);
+        else if (parsed.action === "shared_delete")
+            await deleteSharedProfile(context, parsed.name);
+        else if (parsed.action === "copy_shared")
+            await copySharedProfile(context, parsed.name);
+        else
+            await startLoginSetup(context, parsed);
+        return true;
+    }
+}
+/** Surface a vault-manager failure to the user without failing the command. */
+async function replyVaultError(context, error) {
+    await replySummary(context, "Vault", [error instanceof Error ? error.message : String(error)]);
+}
+async function listSharedProfiles(context) {
+    const profiles = context.services.vaultManager.listSharedVaults();
+    await replySummary(context, "Vault", profiles.length > 0
+        ? ["Shared login profiles:", ...profiles.map((name) => `- ${name}`)]
+        : ["No shared login profiles found."]);
+}
+async function deleteSharedProfile(context, name) {
+    try {
+        const deleted = context.services.vaultManager.deleteSharedVault(name);
+        await replySummary(context, "Vault", [
+            deleted
+                ? `Deleted shared login profile \`${name}\`.`
+                : `Shared login profile \`${name}\` does not exist.`,
+        ]);
+    }
+    catch (error) {
+        await replyVaultError(context, error);
+    }
+}
+async function copySharedProfile(context, name) {
+    try {
+        const vaultId = ensureLoginVault(context);
+        const result = context.services.vaultManager.copySharedVaultTo(name, vaultId);
+        const refreshNote = await refreshCopiedVaultRuntime(context);
+        await replySummary(context, "Vault", [
+            `Copied shared login profile \`${name}\` into this conversation.`,
+            "Shared values overwrite matching conversation values; conversation-only values are kept.",
+            `Copied: ${result.envKeysCopied} env key(s), ${result.filesCopied} file(s).`,
+            ...(refreshNote ? [refreshNote] : []),
+        ]);
+    }
+    catch (error) {
+        await replyVaultError(context, error);
+    }
+}
+/** Issue a portal link for this conversation's vault, or for a shared profile. */
+async function startLoginSetup(context, parsed) {
+    if (!context.services.portalBaseUrl) {
+        await replySummary(context, "Vault", portalNotConfiguredLines("Login"));
+        return;
+    }
+    let vaultId;
+    try {
+        vaultId = resolveLoginVaultId(context, parsed);
+    }
+    catch (error) {
+        log.logWarning(`[${context.conversationId}] Failed to prepare login vault for ${context.platform}/${context.platformUserId}`, error instanceof Error ? error.message : String(error));
+        await replySummary(context, "Vault", [
+            "Login setup failed on the server.",
+            "請稍後重試，或聯絡管理員檢查 vault 儲存權限。",
+        ]);
+        return;
+    }
+    const token = context.services.linkTokenStore.create(context.platform, context.platformUserId, context.conversationId, vaultId, "");
+    await replySummary(context, "Vault", [
+        `${context.services.portalBaseUrl}/link?token=${token.token}`,
+        `Target: ${loginVaultLabel(context, parsed, vaultId)} · Expires: 15 minutes`,
+    ]);
+}
+function resolveLoginVaultId(context, parsed) {
+    const isSharedSetup = parsed.action === "shared_create" || parsed.action === "shared_update";
+    const vaultId = isSharedSetup ? (sharedVaultKey(parsed.name) ?? "") : ensureLoginVault(context);
+    if (vaultId)
+        return vaultId;
+    throw new Error(isSharedSetup ? `Invalid shared login profile name: ${parsed.name}` : "Invalid vault id");
+}
+function loginVaultLabel(context, parsed, vaultId) {
+    if (parsed.action === "shared_create" || parsed.action === "shared_update") {
+        return `shared login profile (${parsed.name})`;
+    }
+    return context.services.sandbox.type === "container"
+        ? `container vault (${vaultId})`
+        : "your vault";
+}
+//# sourceMappingURL=login.js.map

package/dist/adapters/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../../src/adapters/commands/login.ts"],"names":[],"mappings":"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","sourcesContent":["import * as log from \"../../log.js\";\nimport { credentialAuthorizationKey, runtimeResourceKey } from \"../../sandbox/identity.js\";\nimport { sharedVaultKey } from \"../../vault/index.js\";\nimport { slashForms, matchCommand } from \"./manifest.js\";\nimport type { CommandContext, CommandHandler, ParsedLoginCommand } from \"./types.js\";\nimport { portalNotConfiguredLines, replySummary } from \"./utils.js\";\nimport { createOfficeAddress } from \"../../office/index.js\";\n\nconst LOGIN_COMMANDS = slashForms(\"login\");\n\nconst SHARED_OPERATIONS = [\"create\", \"update\", \"delete\"] as const;\n\nexport function parseLoginCommand(text: string): ParsedLoginCommand | null {\n  const matched = matchCommand(text, LOGIN_COMMANDS);\n  if (!matched) return null;\n\n  const [subcommand, operation, name, ...extra] = matched.args;\n  if (!subcommand) return { action: \"setup\" };\n  if (extra.length > 0) return null;\n\n  const verb = subcommand.toLowerCase();\n  if (verb === \"shared\") return parseSharedLogin(operation?.toLowerCase(), name);\n  if (verb === \"copy\" && operation && !name) return { action: \"copy_shared\", name: operation };\n  // Backward-compatible provider arguments open the generic login page.\n  return operation ? null : { action: \"setup\" };\n}\n\nfunction parseSharedLogin(\n  operation: string | undefined,\n  name: string | undefined,\n): ParsedLoginCommand | null {\n  if (operation === \"list\") return name ? null : { action: \"shared_list\" };\n  const matched = SHARED_OPERATIONS.find((candidate) => candidate === operation);\n  if (!matched || !name) return null;\n  return { action: `shared_${matched}`, name };\n}\n\nfunction ensureLoginVault(context: CommandContext): string {\n  const { services, platformUserId, conversationId, vaultConversationId } = context;\n  // The vault target is a conversation on the same platform; a command may\n  // aim at another conversation's vault via vaultConversationId.\n  return credentialAuthorizationKey(services.sandbox, {\n    userId: platformUserId,\n    address: createOfficeAddress(context.address.platform, vaultConversationId ?? conversationId),\n  });\n}\n\nasync function refreshCopiedVaultRuntime(context: CommandContext): Promise<string | undefined> {\n  if (context.services.sandbox.type !== \"image\") return undefined;\n\n  const targetAddress = createOfficeAddress(\n    context.address.platform,\n    context.vaultConversationId ?? context.conversationId,\n  );\n  const cleared = context.services.runtime?.refreshConversationEnvironment(targetAddress);\n  if (cleared === false) {\n    return \"A session is currently running, so the sandbox was not restarted. The copied credentials will be applied after the run finishes and the sandbox is recreated.\";\n  }\n\n  if (!context.services.provisioner) {\n    return \"The cached session was refreshed. The sandbox will pick up copied credentials on the next provision.\";\n  }\n\n  // The provisioner names containers by runtime resource key, not by the\n  // credential key the vault copy used — the two identities differ in image\n  // mode (office key vs raw-conversation key). Removing by the wrong key\n  // would silently leave the real container running with stale mounts.\n  const resourceKey = runtimeResourceKey(context.services.sandbox, {\n    userId: context.platformUserId,\n    address: targetAddress,\n  });\n  await context.services.provisioner.remove(resourceKey);\n  return \"The sandbox container was removed and will be recreated with the copied env and file mounts on the next message.\";\n}\n\nexport class LoginCommandHandler implements CommandHandler {\n  async tryHandle(context: CommandContext): Promise<boolean> {\n    const parsed = parseLoginCommand(context.commandText);\n    if (!parsed) return false;\n\n    if (!context.privateConversation) {\n      await replySummary(context, \"Vault\", [\n        \"為了保護你的憑證，`/login` 只能在與機器人的私訊中使用。\",\n        \"請先私訊機器人，再重新執行 `/login`。\",\n      ]);\n      return true;\n    }\n\n    if (parsed.action === \"shared_list\") await listSharedProfiles(context);\n    else if (parsed.action === \"shared_delete\") await deleteSharedProfile(context, parsed.name);\n    else if (parsed.action === \"copy_shared\") await copySharedProfile(context, parsed.name);\n    else await startLoginSetup(context, parsed);\n    return true;\n  }\n}\n\n/** Surface a vault-manager failure to the user without failing the command. */\nasync function replyVaultError(context: CommandContext, error: unknown): Promise<void> {\n  await replySummary(context, \"Vault\", [error instanceof Error ? error.message : String(error)]);\n}\n\nasync function listSharedProfiles(context: CommandContext): Promise<void> {\n  const profiles = context.services.vaultManager.listSharedVaults();\n  await replySummary(\n    context,\n    \"Vault\",\n    profiles.length > 0\n      ? [\"Shared login profiles:\", ...profiles.map((name) => `- ${name}`)]\n      : [\"No shared login profiles found.\"],\n  );\n}\n\nasync function deleteSharedProfile(context: CommandContext, name: string): Promise<void> {\n  try {\n    const deleted = context.services.vaultManager.deleteSharedVault(name);\n    await replySummary(context, \"Vault\", [\n      deleted\n        ? `Deleted shared login profile \\`${name}\\`.`\n        : `Shared login profile \\`${name}\\` does not exist.`,\n    ]);\n  } catch (error) {\n    await replyVaultError(context, error);\n  }\n}\n\nasync function copySharedProfile(context: CommandContext, name: string): Promise<void> {\n  try {\n    const vaultId = ensureLoginVault(context);\n    const result = context.services.vaultManager.copySharedVaultTo(name, vaultId);\n    const refreshNote = await refreshCopiedVaultRuntime(context);\n    await replySummary(context, \"Vault\", [\n      `Copied shared login profile \\`${name}\\` into this conversation.`,\n      \"Shared values overwrite matching conversation values; conversation-only values are kept.\",\n      `Copied: ${result.envKeysCopied} env key(s), ${result.filesCopied} file(s).`,\n      ...(refreshNote ? [refreshNote] : []),\n    ]);\n  } catch (error) {\n    await replyVaultError(context, error);\n  }\n}\n\n/** Issue a portal link for this conversation's vault, or for a shared profile. */\nasync function startLoginSetup(context: CommandContext, parsed: ParsedLoginCommand): Promise<void> {\n  if (!context.services.portalBaseUrl) {\n    await replySummary(context, \"Vault\", portalNotConfiguredLines(\"Login\"));\n    return;\n  }\n\n  let vaultId: string;\n  try {\n    vaultId = resolveLoginVaultId(context, parsed);\n  } catch (error) {\n    log.logWarning(\n      `[${context.conversationId}] Failed to prepare login vault for ${context.platform}/${context.platformUserId}`,\n      error instanceof Error ? error.message : String(error),\n    );\n    await replySummary(context, \"Vault\", [\n      \"Login setup failed on the server.\",\n      \"請稍後重試，或聯絡管理員檢查 vault 儲存權限。\",\n    ]);\n    return;\n  }\n\n  const token = context.services.linkTokenStore.create(\n    context.platform,\n    context.platformUserId,\n    context.conversationId,\n    vaultId,\n    \"\",\n  );\n  await replySummary(context, \"Vault\", [\n    `${context.services.portalBaseUrl}/link?token=${token.token}`,\n    `Target: ${loginVaultLabel(context, parsed, vaultId)} · Expires: 15 minutes`,\n  ]);\n}\n\nfunction resolveLoginVaultId(context: CommandContext, parsed: ParsedLoginCommand): string {\n  const isSharedSetup = parsed.action === \"shared_create\" || parsed.action === \"shared_update\";\n  const vaultId = isSharedSetup ? (sharedVaultKey(parsed.name) ?? \"\") : ensureLoginVault(context);\n  if (vaultId) return vaultId;\n  throw new Error(\n    isSharedSetup ? `Invalid shared login profile name: ${parsed.name}` : \"Invalid vault id\",\n  );\n}\n\nfunction loginVaultLabel(\n  context: CommandContext,\n  parsed: ParsedLoginCommand,\n  vaultId: string,\n): string {\n  if (parsed.action === \"shared_create\" || parsed.action === \"shared_update\") {\n    return `shared login profile (${parsed.name})`;\n  }\n  return context.services.sandbox.type === \"container\"\n    ? `container vault (${vaultId})`\n    : \"your vault\";\n}\n"]}

package/dist/adapters/commands/manifest.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Platform-agnostic command manifest — the single inventory that platform
+ * adapters derive their native slash-command registration and routing from,
+ * and that `isCommandText` and the handler grammars mirror.
+ *
+ * Adding a command means adding a manifest entry plus a handler in this
+ * directory; adapters pick up registration and routing from the entry instead
+ * of hand-restating the inventory (where a missed spot used to mean a silent
+ * no-response).
+ *
+ * Per CONTEXT.md, slash commands are a minimal chat control surface: detailed
+ * or infrequent settings belong in Admin, and bare commands are limited to
+ * `session`. `stop` is listed for platform registration/UI only — it is a
+ * magic word owned by conversation intake, not a command handler.
+ */
+import type { CommandManifestEntry } from "./types.js";
+export type { CommandManifestEntry, SlackSlashRoute } from "./types.js";
+/** Entry order is the Telegram command-menu order. */
+export declare const COMMAND_MANIFEST: readonly CommandManifestEntry[];
+export declare function commandManifestEntry(name: string): CommandManifestEntry;
+/** Slash spellings of a command: `/<name>` and `/pi-<name>` for the name and each alias. */
+export declare function slashForms(name: string): readonly string[];
+/** Every accepted spelling: the bare name (when the command is bare) plus slash forms. */
+export declare function commandForms(name: string): readonly string[];
+/** Telegram `setMyCommands` payload (menu registration; routing is separate). */
+export declare function telegramCommandMenu(): {
+    command: string;
+    description: string;
+}[];
+export declare function matchCommand<Command extends string>(text: string, aliases: readonly Command[], options?: {
+    stripMention?: boolean;
+}): {
+    command: Command;
+    args: string[];
+} | null;
+export declare function isCommandText(text: string): boolean;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/adapters/commands/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/adapters/commands/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAExE,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,EAAE,SAAS,oBAAoB,EAwF3D,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAIvE;AAED,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAM1D;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAG5D;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAKhF;AAED,wBAAgB,YAAY,CAAC,OAAO,SAAS,MAAM,EACjD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAQ7C;AAkBD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD"}