bazilion 0.2.1 → 0.4.0

package/dist/cli.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { defineCommand as defineCommand20, runCommand, showUsage } from "citty";
+import { defineCommand as defineCommand22, runCommand, showUsage } from "citty";
 
 // package.json
 var package_default = {
   name: "bazilion",
-  version: "0.2.1",
+  version: "0.4.0",
   description: "Multi-agent runtime CLI \u2014 spawn LLM agents, manage profiles/groups/skills, and run the local daemon.",
   license: "MIT",
   repository: {
@@ -49,18 +49,19 @@ var package_default = {
     access: "public"
   },
   dependencies: {
-    "@earendil-works/pi-agent-core": "^0.75.4",
-    "@earendil-works/pi-ai": "^0.75.4",
-    "@earendil-works/pi-coding-agent": "^0.75.4",
-    "@hono/node-server": "^2.0.3",
+    "@earendil-works/pi-agent-core": "^0.77.0",
+    "@earendil-works/pi-ai": "^0.77.0",
+    "@earendil-works/pi-coding-agent": "^0.77.0",
+    "@hono/node-server": "^2.0.4",
     "@mozilla/readability": "^0.6.0",
-    "@tobilu/qmd": "^2.5.2",
+    "@tobilu/qmd": "^2.5.3",
     "adm-zip": "^0.5.17",
     citty: "^0.2.2",
-    hono: "^4.12.22",
+    hono: "^4.12.23",
     linkedom: "^0.18.12",
+    playwright: "^1.60.0",
     "qrcode-terminal": "^0.12.0",
-    typebox: "^1.1.38",
+    typebox: "^1.1.39",
     undici: "^8.3.0",
     yaml: "^2.9.0"
   },
@@ -209,6 +210,8 @@ function createClient2(cfg = loadClientConfig()) {
 }
 
 // src/commands/agent.ts
+import { readFileSync as readFileSync2, writeFileSync } from "fs";
+import { basename, extname } from "path";
 import { stdin, stdout } from "process";
 import { createInterface } from "readline/promises";
 import { defineCommand } from "citty";
@@ -234,6 +237,39 @@ function columnize(rows, gap = "  ") {
 }
 
 // src/commands/agent.ts
+var IMAGE_MIME = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp"
+};
+function loadImages(paths) {
+  return paths.map((p) => {
+    const mimeType = IMAGE_MIME[extname(p).toLowerCase()];
+    if (!mimeType) throw new Error(`unsupported image type: ${p} (png/jpg/gif/webp only)`);
+    return { name: basename(p), mimeType, data: readFileSync2(p).toString("base64") };
+  });
+}
+var FILE_MIME = {
+  ".pdf": "application/pdf",
+  ".txt": "text/plain",
+  ".md": "text/markdown",
+  ".csv": "text/csv",
+  ".json": "application/json",
+  ".html": "text/html",
+  ".zip": "application/zip"
+};
+function loadFiles(paths) {
+  return paths.map((p) => ({
+    name: basename(p),
+    mimeType: FILE_MIME[extname(p).toLowerCase()] ?? "application/octet-stream",
+    data: readFileSync2(p).toString("base64")
+  }));
+}
+function asPaths(v) {
+  return v ? Array.isArray(v) ? v : [v] : [];
+}
 var spawnCmd = defineCommand({
   meta: { name: "spawn", description: "Spawn an agent from a profile into a group" },
   args: {
@@ -266,7 +302,7 @@ var spawnCmd = defineCommand({
 var editCmd = defineCommand({
   meta: {
     name: "edit",
-    description: "Edit agent settings (name, model override, reasoning level)"
+    description: "Edit agent settings (name, model override, reasoning level, telegram mirror)"
   },
   args: {
     id: { type: "positional", required: true, description: "Agent id or prefix" },
@@ -275,11 +311,21 @@ var editCmd = defineCommand({
     reasoning: {
       type: "string",
       description: "Reasoning level: off|minimal|low|medium|high|xhigh"
+    },
+    mirror: {
+      type: "string",
+      description: "Telegram mirror verbosity: minimal|verbose"
+    },
+    "topic-icon": {
+      type: "string",
+      description: 'Telegram topic emoji (e.g. \u{1F4DA}). Use --topic-icon "" to clear.'
     }
   },
   async run({ args }) {
-    if (args.name === void 0 && args.model === void 0 && args.reasoning === void 0) {
-      console.error("agent edit: specify at least one of --name, --model, or --reasoning");
+    if (args.name === void 0 && args.model === void 0 && args.reasoning === void 0 && args.mirror === void 0 && args["topic-icon"] === void 0) {
+      console.error(
+        "agent edit: specify at least one of --name, --model, --reasoning, --mirror, --topic-icon"
+      );
       process.exit(2);
     }
     const client = createClient2();
@@ -289,6 +335,16 @@ var editCmd = defineCommand({
       body.modelOverride = args.model === "" ? null : args.model;
     }
     if (args.reasoning !== void 0) body.reasoningLevel = args.reasoning;
+    if (args.mirror !== void 0) {
+      if (args.mirror !== "minimal" && args.mirror !== "verbose") {
+        console.error(`agent edit: --mirror must be 'minimal' or 'verbose'`);
+        process.exit(2);
+      }
+      body.telegramMirrorMode = args.mirror;
+    }
+    if (args["topic-icon"] !== void 0) {
+      body.telegramIconEmoji = args["topic-icon"] === "" ? null : args["topic-icon"];
+    }
     const agent = await client.patch(`/api/agents/${args.id}`, body);
     console.log(`updated agent ${agent.id} (${agent.name})`);
   }
@@ -399,6 +455,16 @@ function printEvent(e, state) {
     case "tool_error":
       console.log(`  [tool error: ${e.name} \u2014 ${e.error}]`);
       break;
+    case "file": {
+      if (state.inDeltaStream) {
+        process.stdout.write("\n");
+        state.inDeltaStream = false;
+      }
+      const out = basename(e.name).replace(/[^\w.-]/g, "_") || "file";
+      writeFileSync(out, Buffer.from(e.data, "base64"));
+      console.log(`  [file received: saved to ./${out} (${e.mimeType})]`);
+      break;
+    }
     case "error":
       if (state.inDeltaStream) {
         process.stdout.write("\n");
@@ -408,10 +474,11 @@ function printEvent(e, state) {
       break;
   }
 }
-async function streamTurn(client, agentId, message) {
+async function streamTurn(client, agentId, message, attachments) {
   const state = { inDeltaStream: false };
   for await (const frame of client.stream("POST", `/api/agents/${agentId}/chat`, {
-    message
+    message,
+    ...attachments && attachments.length > 0 ? { attachments } : {}
   })) {
     if (frame.kind === "event") {
       if (frame.event.type !== "user_message") printEvent(frame.event, state);
@@ -428,13 +495,25 @@ var chatCmd = defineCommand({
     message: {
       type: "string",
       description: "Send a single message and exit (one-shot mode)"
+    },
+    image: {
+      type: "string",
+      description: "Attach an image file (png/jpg/gif/webp; repeatable). One-shot mode."
+    },
+    file: {
+      type: "string",
+      description: "Attach any file \u2014 the agent gets a path reference (repeatable). One-shot mode."
     }
   },
   async run({ args }) {
     const client = createClient2();
     const resolved = await client.get(`/api/agents/${args.id}`);
-    if (args.message) {
-      await streamTurn(client, resolved.agent.id, args.message);
+    const attachments = [
+      ...loadImages(asPaths(args.image)),
+      ...loadFiles(asPaths(args.file))
+    ];
+    if (args.message || attachments.length > 0) {
+      await streamTurn(client, resolved.agent.id, args.message ?? "", attachments);
       return;
     }
     console.log(`chatting with ${resolved.agent.name} (${resolved.model})`);
@@ -788,7 +867,7 @@ var openaiLoginCmd = defineCommand2({
     console.log(`access token expires: ${formatExpiry(status.expiresAt)}`);
     console.log("");
     console.log(`enable the 'openai-codex' provider on /config and add at least one model`);
-    console.log("(e.g. gpt-5.1-codex-max, gpt-5.2, gpt-5.3-codex) to start using it.");
+    console.log("(e.g. gpt-5.3-codex, gpt-5.4, gpt-5.5) to start using it.");
   }
 });
 var openaiLogoutCmd = defineCommand2({
@@ -1275,7 +1354,7 @@ var doctorCommand = defineCommand6({
 });
 
 // src/commands/group.ts
-import { readFileSync as readFileSync2 } from "fs";
+import { readFileSync as readFileSync3 } from "fs";
 import { stdin as stdin2 } from "process";
 import { defineCommand as defineCommand7 } from "citty";
 var addCmd = defineCommand7({
@@ -1355,7 +1434,7 @@ var userMdSetCmd = defineCommand7({
   async run({ args }) {
     let content;
     if (args["from-stdin"]) content = await readStdin();
-    else if (args.file) content = readFileSync2(args.file, "utf8");
+    else if (args.file) content = readFileSync3(args.file, "utf8");
     else if (args.text !== void 0) content = args.text;
     else {
       console.error("group user-md set: provide --file, --from-stdin, or --text");
@@ -1385,13 +1464,64 @@ var userMdCmd = defineCommand7({
     clear: userMdClearCmd
   }
 });
+var topicFormatShowCmd = defineCommand7({
+  meta: { name: "show", description: "Print the group's Telegram topic-name template" },
+  args: { id: { type: "positional", required: true } },
+  async run({ args }) {
+    const client = createClient2();
+    const g = await client.get(`/api/groups/${args.id}`);
+    console.log(g.telegramTopicNameFormat ?? "(default naming)");
+  }
+});
+var topicFormatSetCmd = defineCommand7({
+  meta: {
+    name: "set",
+    description: "Set the topic-name template. Tokens: {agent.name} {group.name} {group.slug} (must include {agent.name})"
+  },
+  args: {
+    id: { type: "positional", required: true },
+    format: {
+      type: "positional",
+      required: true,
+      description: 'e.g. "{group.name} / {agent.name}"'
+    }
+  },
+  async run({ args }) {
+    const client = createClient2();
+    const body = { format: args.format };
+    const g = await client.put(`/api/groups/${args.id}/topic-format`, body);
+    console.log(`set topic-name template for group ${args.id}: ${g.telegramTopicNameFormat}`);
+  }
+});
+var topicFormatClearCmd = defineCommand7({
+  meta: { name: "clear", description: "Clear the template (revert to built-in naming)" },
+  args: { id: { type: "positional", required: true } },
+  async run({ args }) {
+    const client = createClient2();
+    const body = { format: null };
+    await client.put(`/api/groups/${args.id}/topic-format`, body);
+    console.log(`cleared topic-name template for group ${args.id}`);
+  }
+});
+var topicFormatCmd = defineCommand7({
+  meta: {
+    name: "topic-format",
+    description: "View or edit a group's Telegram forum-topic name template"
+  },
+  subCommands: {
+    show: topicFormatShowCmd,
+    set: topicFormatSetCmd,
+    clear: topicFormatClearCmd
+  }
+});
 var groupCommand = defineCommand7({
   meta: { name: "group", description: "Manage groups (collaboration contexts)" },
   subCommands: {
     add: addCmd,
     list: listCmd3,
     rm: rmCmd2,
-    "user-md": userMdCmd
+    "user-md": userMdCmd,
+    "topic-format": topicFormatCmd
   }
 });
 
@@ -1472,7 +1602,7 @@ var inboxCommand = defineCommand8({
 });
 
 // src/commands/login.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
 import { defineCommand as defineCommand9 } from "citty";
 function normalizeServer(raw) {
   let url;
@@ -1511,14 +1641,14 @@ var loginCommand = defineCommand9({
         `${paths.authFile} not found. Start the daemon with "bazilion serve" first \u2014 login stores the remote there.`
       );
     }
-    const auth = JSON.parse(readFileSync3(paths.authFile, "utf8"));
+    const auth = JSON.parse(readFileSync4(paths.authFile, "utf8"));
     if (args.clear) {
       if (!auth.remote) {
         console.log("no remote stored \u2014 nothing to clear");
         return;
       }
       delete auth.remote;
-      writeFileSync(paths.authFile, `${JSON.stringify(auth, null, 2)}
+      writeFileSync2(paths.authFile, `${JSON.stringify(auth, null, 2)}
 `, { mode: 384 });
       console.log("cleared stored remote; CLI will fall back to the local daemon");
       return;
@@ -1533,19 +1663,138 @@ var loginCommand = defineCommand9({
       await verifyToken(server, args.token);
     }
     auth.remote = { server, token: args.token };
-    writeFileSync(paths.authFile, `${JSON.stringify(auth, null, 2)}
+    writeFileSync2(paths.authFile, `${JSON.stringify(auth, null, 2)}
 `, { mode: 384 });
     console.log(`saved remote: ${server}`);
     console.log("CLI will now target this server unless BAZILION_SERVER is set in the env.");
   }
 });
 
-// src/commands/memory.ts
+// src/commands/mcp.ts
 import { defineCommand as defineCommand10 } from "citty";
+function serverRow(s) {
+  const where = s.transport === "stdio" ? `${s.command} ${s.args.join(" ")}`.trim() : s.url ?? "";
+  return [
+    s.id,
+    s.enabled ? "enabled" : "disabled",
+    s.transport,
+    s.hasAuthToken ? "auth" : "-",
+    s.name,
+    where
+  ];
+}
+var addCmd2 = defineCommand10({
+  meta: { name: "add", description: "Register an MCP server" },
+  args: {
+    name: { type: "positional", required: true, description: "Unique name ([a-zA-Z0-9_])" },
+    transport: { type: "string", description: "stdio | http | sse (default stdio)" },
+    command: { type: "string", description: "stdio: executable to run (e.g. npx)" },
+    args: { type: "string", description: "stdio: space-separated args (quote the whole string)" },
+    url: { type: "string", description: "http/sse: endpoint URL" },
+    token: { type: "string", description: "http/sse: bearer token (stored encrypted)" },
+    disabled: { type: "boolean", description: "Create disabled" }
+  },
+  async run({ args }) {
+    const transport = args.transport ?? "stdio";
+    const body = {
+      name: args.name,
+      transport,
+      command: args.command ?? null,
+      args: args.args ? args.args.split(" ").filter(Boolean) : [],
+      url: args.url ?? null,
+      authToken: args.token ?? void 0,
+      enabled: !args.disabled
+    };
+    const client = createClient2();
+    const { server } = await client.post("/api/mcp-servers", body);
+    console.log(`${server.id}	${server.name}	${server.transport}`);
+  }
+});
+var listCmd5 = defineCommand10({
+  meta: { name: "list", description: "List MCP servers" },
+  async run() {
+    const client = createClient2();
+    const { servers } = await client.get("/api/mcp-servers");
+    if (servers.length === 0) {
+      console.log("(no MCP servers)");
+      return;
+    }
+    for (const line of columnize(servers.map(serverRow))) console.log(line);
+  }
+});
+var showCmd3 = defineCommand10({
+  meta: { name: "show", description: "Show one MCP server" },
+  args: { id: { type: "positional", required: true } },
+  async run({ args }) {
+    const client = createClient2();
+    const { server } = await client.get(`/api/mcp-servers/${args.id}`);
+    console.log(JSON.stringify(server, null, 2));
+  }
+});
+var rmCmd3 = defineCommand10({
+  meta: { name: "rm", description: "Delete an MCP server" },
+  args: { id: { type: "positional", required: true } },
+  async run({ args }) {
+    const client = createClient2();
+    await client.del(`/api/mcp-servers/${args.id}`);
+    console.log(`removed MCP server ${args.id}`);
+  }
+});
+var enableCmd = defineCommand10({
+  meta: { name: "enable", description: "Enable an MCP server" },
+  args: { id: { type: "positional", required: true } },
+  async run({ args }) {
+    const client = createClient2();
+    await client.patch(`/api/mcp-servers/${args.id}`, { enabled: true });
+    console.log(`enabled MCP server ${args.id}`);
+  }
+});
+var disableCmd = defineCommand10({
+  meta: { name: "disable", description: "Disable an MCP server" },
+  args: { id: { type: "positional", required: true } },
+  async run({ args }) {
+    const client = createClient2();
+    await client.patch(`/api/mcp-servers/${args.id}`, { enabled: false });
+    console.log(`disabled MCP server ${args.id}`);
+  }
+});
+var testCmd = defineCommand10({
+  meta: { name: "test", description: "Connect to a server and list its tools" },
+  args: { id: { type: "positional", required: true } },
+  async run({ args }) {
+    const client = createClient2();
+    const res = await client.post(
+      `/api/mcp-servers/${args.id}/test`
+    );
+    if (!res.ok) {
+      console.error(`connection failed: ${res.error}`);
+      process.exitCode = 1;
+      return;
+    }
+    const tools = res.tools ?? [];
+    console.log(`connected \u2014 ${tools.length} tool(s):`);
+    for (const t of tools) console.log(`  ${t.name}	${t.description}`);
+  }
+});
+var mcpCommand = defineCommand10({
+  meta: { name: "mcp", description: "Manage MCP servers" },
+  subCommands: {
+    add: addCmd2,
+    list: listCmd5,
+    show: showCmd3,
+    rm: rmCmd3,
+    enable: enableCmd,
+    disable: disableCmd,
+    test: testCmd
+  }
+});
+
+// src/commands/memory.ts
+import { defineCommand as defineCommand11 } from "citty";
 function encodeKey(key) {
   return key.split("/").map(encodeURIComponent).join("/");
 }
-var writeCmd = defineCommand10({
+var writeCmd = defineCommand11({
   meta: { name: "write", description: "Write an entry into a group's shared memory" },
   args: {
     group: { type: "positional", required: true, description: "Group slug" },
@@ -1561,7 +1810,7 @@ var writeCmd = defineCommand10({
     console.log(`wrote ${entry2.key} (${entry2.content.length} bytes)`);
   }
 });
-var readCmd2 = defineCommand10({
+var readCmd2 = defineCommand11({
   meta: { name: "read", description: "Read an entry from a group's shared memory" },
   args: {
     group: { type: "positional", required: true, description: "Group slug" },
@@ -1575,7 +1824,7 @@ var readCmd2 = defineCommand10({
     console.log(entry2.content);
   }
 });
-var searchCmd = defineCommand10({
+var searchCmd = defineCommand11({
   meta: { name: "search", description: "Search a group's shared memory" },
   args: {
     group: { type: "positional", required: true, description: "Group slug" },
@@ -1596,7 +1845,7 @@ var searchCmd = defineCommand10({
     }
   }
 });
-var listCmd5 = defineCommand10({
+var listCmd6 = defineCommand11({
   meta: { name: "list", description: "List all entries in a group's shared memory" },
   args: {
     group: { type: "positional", required: true, description: "Group slug" }
@@ -1613,7 +1862,7 @@ var listCmd5 = defineCommand10({
     }
   }
 });
-var rmCmd3 = defineCommand10({
+var rmCmd4 = defineCommand11({
   meta: { name: "rm", description: "Remove an entry from a group's shared memory" },
   args: {
     group: { type: "positional", required: true, description: "Group slug" },
@@ -1625,7 +1874,7 @@ var rmCmd3 = defineCommand10({
     console.log(`removed ${args.key}`);
   }
 });
-var memoryCommand = defineCommand10({
+var memoryCommand = defineCommand11({
   meta: {
     name: "memory",
     description: "Manage a group's shared memory (BM25-indexed markdown notes)"
@@ -1634,15 +1883,15 @@ var memoryCommand = defineCommand10({
     write: writeCmd,
     read: readCmd2,
     search: searchCmd,
-    list: listCmd5,
-    rm: rmCmd3
+    list: listCmd6,
+    rm: rmCmd4
   }
 });
 
 // src/commands/profile.ts
 import { spawn as spawn2 } from "child_process";
 import { randomBytes } from "crypto";
-import { readFileSync as readFileSync4, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
+import { readFileSync as readFileSync5, rmSync as rmSync2, writeFileSync as writeFileSync3 } from "fs";
 import { tmpdir } from "os";
 import { join as join2 } from "path";
 
@@ -1658,7 +1907,7 @@ var PROFILE_FILES = [
 ];
 
 // src/commands/profile.ts
-import { defineCommand as defineCommand11 } from "citty";
+import { defineCommand as defineCommand12 } from "citty";
 function splitCsv(v) {
   if (!v) return void 0;
   const out = v.split(",").map((s) => s.trim()).filter(Boolean);
@@ -1669,7 +1918,7 @@ function parseSkillsMode(v) {
   if (v === "all" || v === "selected") return v;
   throw new Error(`--skills-mode must be 'all' or 'selected', got '${v}'`);
 }
-var createCmd2 = defineCommand11({
+var createCmd2 = defineCommand12({
   meta: { name: "create", description: "Create a new profile" },
   args: {
     id: { type: "positional", required: true, description: "Profile slug" },
@@ -1677,7 +1926,7 @@ var createCmd2 = defineCommand11({
     model: {
       type: "string",
       required: true,
-      description: "Default model, e.g. anthropic:claude-opus-4-6"
+      description: "Default model, e.g. anthropic:claude-opus-4-8"
     },
     "skills-mode": {
       type: "string",
@@ -1718,7 +1967,7 @@ var createCmd2 = defineCommand11({
   },
   async run({ args }) {
     const skillsMode = parseSkillsMode(args["skills-mode"]);
-    const readTemplate = (path) => path ? readFileSync4(path, "utf8") : void 0;
+    const readTemplate = (path) => path ? readFileSync5(path, "utf8") : void 0;
     const body = {
       id: args.id,
       name: args.name,
@@ -1737,7 +1986,7 @@ var createCmd2 = defineCommand11({
     console.log(`created profile ${profile.id} at ${profile.dir}`);
   }
 });
-var listCmd6 = defineCommand11({
+var listCmd7 = defineCommand12({
   meta: { name: "list", description: "List profiles" },
   async run() {
     const client = createClient2();
@@ -1750,7 +1999,7 @@ var listCmd6 = defineCommand11({
     for (const line of columnize(rows)) console.log(line);
   }
 });
-var showCmd3 = defineCommand11({
+var showCmd4 = defineCommand12({
   meta: { name: "show", description: "Show profile details" },
   args: {
     id: { type: "positional", required: true }
@@ -1776,7 +2025,7 @@ var showCmd3 = defineCommand11({
     }
   }
 });
-var editCmd2 = defineCommand11({
+var editCmd2 = defineCommand12({
   meta: { name: "edit", description: "Open a profile file in $EDITOR" },
   args: {
     id: { type: "positional", required: true },
@@ -1796,7 +2045,7 @@ var editCmd2 = defineCommand11({
       `/api/profiles/${args.id}/files/${file}`
     );
     const tmpPath = join2(tmpdir(), `bazilion-${args.id}-${file}-${randomBytes(4).toString("hex")}`);
-    writeFileSync2(tmpPath, content);
+    writeFileSync3(tmpPath, content);
     try {
       const editor = process.env.EDITOR ?? process.env.VISUAL ?? "vi";
       const code = await new Promise((resolve3, reject) => {
@@ -1805,7 +2054,7 @@ var editCmd2 = defineCommand11({
         child.on("close", (c) => resolve3(c ?? 0));
       });
       if (code !== 0) throw new Error(`editor exited with code ${code}`);
-      const updated = readFileSync4(tmpPath, "utf8");
+      const updated = readFileSync5(tmpPath, "utf8");
       if (updated === content) {
         console.log("(no changes)");
         return;
@@ -1821,7 +2070,7 @@ var editCmd2 = defineCommand11({
     }
   }
 });
-var updateCmd = defineCommand11({
+var updateCmd = defineCommand12({
   meta: {
     name: "update",
     description: "Update profile settings (name, model, skills-mode, skills)"
@@ -1855,7 +2104,7 @@ var updateCmd = defineCommand11({
     console.log(`updated profile ${profile.id}`);
   }
 });
-var deleteCmd2 = defineCommand11({
+var deleteCmd2 = defineCommand12({
   meta: { name: "delete", description: "Permanently delete a profile and its files" },
   args: {
     id: { type: "positional", required: true }
@@ -1866,12 +2115,12 @@ var deleteCmd2 = defineCommand11({
     console.log(`deleted profile ${args.id}`);
   }
 });
-var profileCommand = defineCommand11({
+var profileCommand = defineCommand12({
   meta: { name: "profile", description: "Manage profiles" },
   subCommands: {
     create: createCmd2,
-    list: listCmd6,
-    show: showCmd3,
+    list: listCmd7,
+    show: showCmd4,
     edit: editCmd2,
     update: updateCmd,
     delete: deleteCmd2
@@ -1881,11 +2130,11 @@ var profileCommand = defineCommand11({
 // src/commands/profile-group.ts
 import { spawn as spawn3 } from "child_process";
 import { randomBytes as randomBytes2 } from "crypto";
-import { readFileSync as readFileSync5, rmSync as rmSync3, writeFileSync as writeFileSync3 } from "fs";
+import { readFileSync as readFileSync6, rmSync as rmSync3, writeFileSync as writeFileSync4 } from "fs";
 import { tmpdir as tmpdir2 } from "os";
 import { join as join3 } from "path";
-import { defineCommand as defineCommand12 } from "citty";
-var createCmd3 = defineCommand12({
+import { defineCommand as defineCommand13 } from "citty";
+var createCmd3 = defineCommand13({
   meta: { name: "create", description: "Create a new profile group (team template)" },
   args: {
     id: { type: "positional", required: true, description: "Profile group slug" },
@@ -1898,13 +2147,13 @@ var createCmd3 = defineCommand12({
   async run({ args }) {
     const body = { id: args.id };
     if (args.name) body.name = args.name;
-    if (args["user-md-file"]) body.userMd = readFileSync5(args["user-md-file"], "utf8");
+    if (args["user-md-file"]) body.userMd = readFileSync6(args["user-md-file"], "utf8");
     const client = createClient2();
     const created = await client.post("/api/profile-groups", body);
     console.log(`created profile group ${created.id}`);
   }
 });
-var listCmd7 = defineCommand12({
+var listCmd8 = defineCommand13({
   meta: { name: "list", description: "List profile groups" },
   async run() {
     const client = createClient2();
@@ -1917,7 +2166,7 @@ var listCmd7 = defineCommand12({
     for (const line of columnize(rows)) console.log(line);
   }
 });
-var showCmd4 = defineCommand12({
+var showCmd5 = defineCommand13({
   meta: { name: "show", description: "Show profile group details + members" },
   args: {
     id: { type: "positional", required: true },
@@ -1954,7 +2203,7 @@ var showCmd4 = defineCommand12({
     for (const line of columnize(rows)) console.log(`  ${line}`);
   }
 });
-var updateCmd2 = defineCommand12({
+var updateCmd2 = defineCommand13({
   meta: { name: "update", description: "Update profile group basics (name, user-md)" },
   args: {
     id: { type: "positional", required: true },
@@ -1968,7 +2217,7 @@ var updateCmd2 = defineCommand12({
     const body = {};
     if (args.name !== void 0) body.name = args.name;
     if (args["user-md-file"] !== void 0) {
-      body.userMd = args["user-md-file"] === "" ? null : readFileSync5(args["user-md-file"], "utf8");
+      body.userMd = args["user-md-file"] === "" ? null : readFileSync6(args["user-md-file"], "utf8");
     }
     if (Object.keys(body).length === 0) {
       throw new Error("nothing to update \u2014 pass at least one of --name/--user-md-file");
@@ -1978,7 +2227,7 @@ var updateCmd2 = defineCommand12({
     console.log(`updated profile group ${updated.id}`);
   }
 });
-var editCmd3 = defineCommand12({
+var editCmd3 = defineCommand13({
   meta: { name: "edit", description: "Edit the member array in $EDITOR (JSON)" },
   args: {
     id: { type: "positional", required: true }
@@ -1998,7 +2247,7 @@ var editCmd3 = defineCommand12({
       tmpdir2(),
       `bazilion-profile-group-${args.id}-${randomBytes2(4).toString("hex")}.json`
     );
-    writeFileSync3(tmpPath, before);
+    writeFileSync4(tmpPath, before);
     try {
       const editor = process.env.EDITOR ?? process.env.VISUAL ?? "vi";
       const code = await new Promise((resolve3, reject) => {
@@ -2007,7 +2256,7 @@ var editCmd3 = defineCommand12({
         child.on("close", (c) => resolve3(c ?? 0));
       });
       if (code !== 0) throw new Error(`editor exited with code ${code}`);
-      const after = readFileSync5(tmpPath, "utf8");
+      const after = readFileSync6(tmpPath, "utf8");
       if (after === before) {
         console.log("(no changes)");
         return;
@@ -2045,7 +2294,7 @@ var editCmd3 = defineCommand12({
     }
   }
 });
-var deleteCmd3 = defineCommand12({
+var deleteCmd3 = defineCommand13({
   meta: { name: "delete", description: "Delete a profile group (does not affect spawned agents)" },
   args: {
     id: { type: "positional", required: true }
@@ -2056,7 +2305,7 @@ var deleteCmd3 = defineCommand12({
     console.log(`deleted profile group ${args.id}`);
   }
 });
-var spawnCmd2 = defineCommand12({
+var spawnCmd2 = defineCommand13({
   meta: { name: "spawn", description: "Spawn the whole team into a group (transactional)" },
   args: {
     id: { type: "positional", required: true },
@@ -2072,7 +2321,7 @@ var spawnCmd2 = defineCommand12({
   async run({ args }) {
     const body = {};
     if (args.group) body.groupSlug = args.group;
-    if (args["user-md-file"]) body.userMd = readFileSync5(args["user-md-file"], "utf8");
+    if (args["user-md-file"]) body.userMd = readFileSync6(args["user-md-file"], "utf8");
     const client = createClient2();
     const result = await client.post(
       `/api/profile-groups/${args.id}/spawn`,
@@ -2089,12 +2338,12 @@ var spawnCmd2 = defineCommand12({
     }
   }
 });
-var profileGroupCommand = defineCommand12({
+var profileGroupCommand = defineCommand13({
   meta: { name: "profile-group", description: "Manage profile groups" },
   subCommands: {
     create: createCmd3,
-    list: listCmd7,
-    show: showCmd4,
+    list: listCmd8,
+    show: showCmd5,
     update: updateCmd2,
     edit: editCmd3,
     delete: deleteCmd3,
@@ -2103,8 +2352,8 @@ var profileGroupCommand = defineCommand12({
 });
 
 // src/commands/provider.ts
-import { defineCommand as defineCommand13 } from "citty";
-var listCmd8 = defineCommand13({
+import { defineCommand as defineCommand14 } from "citty";
+var listCmd9 = defineCommand14({
   meta: {
     name: "list",
     description: "List all providers with enabled/disabled state and curated model counts"
@@ -2130,7 +2379,7 @@ var listCmd8 = defineCommand13({
     for (const line of columnize(rows)) console.log(line);
   }
 });
-var modelsCmd = defineCommand13({
+var modelsCmd = defineCommand14({
   meta: {
     name: "models",
     description: "Show curated + catalog + live models for one provider"
@@ -2162,7 +2411,7 @@ var modelsCmd = defineCommand13({
     }
   }
 });
-var modelsSetCmd = defineCommand13({
+var modelsSetCmd = defineCommand14({
   meta: {
     name: "models-set",
     description: "Replace the curated model list for a provider (comma-separated)"
@@ -2187,7 +2436,7 @@ var modelsSetCmd = defineCommand13({
     for (const m of saved.models) console.log(`  ${m}`);
   }
 });
-var enableCmd = defineCommand13({
+var enableCmd2 = defineCommand14({
   meta: { name: "enable", description: "Toggle a provider on so agents can use it" },
   args: {
     name: { type: "positional", required: true, description: "Provider id (e.g. anthropic)" }
@@ -2201,7 +2450,7 @@ var enableCmd = defineCommand13({
     console.log(`${res.name}: enabled`);
   }
 });
-var disableCmd = defineCommand13({
+var disableCmd2 = defineCommand14({
   meta: {
     name: "disable",
     description: "Toggle a provider off \u2014 agents will refuse its model strings"
@@ -2218,13 +2467,13 @@ var disableCmd = defineCommand13({
     console.log(`${res.name}: disabled`);
   }
 });
-var testCmd = defineCommand13({
+var testCmd2 = defineCommand14({
   meta: { name: "test", description: "Send a single chat to a model and print the reply" },
   args: {
     model: {
       type: "positional",
       required: true,
-      description: "Model string, e.g. anthropic:claude-opus-4-6"
+      description: "Model string, e.g. anthropic:claude-opus-4-8"
     },
     message: { type: "string", description: 'Message text (default "say hi briefly")' }
   },
@@ -2239,21 +2488,21 @@ var testCmd = defineCommand13({
     }
   }
 });
-var providerCommand = defineCommand13({
+var providerCommand = defineCommand14({
   meta: { name: "provider", description: "Manage and test LLM providers" },
   subCommands: {
-    list: listCmd8,
-    enable: enableCmd,
-    disable: disableCmd,
+    list: listCmd9,
+    enable: enableCmd2,
+    disable: disableCmd2,
     models: modelsCmd,
     "models-set": modelsSetCmd,
-    test: testCmd
+    test: testCmd2
   }
 });
 
 // src/commands/send.ts
-import { defineCommand as defineCommand14 } from "citty";
-var sendCommand = defineCommand14({
+import { defineCommand as defineCommand15 } from "citty";
+var sendCommand = defineCommand15({
   meta: {
     name: "send",
     description: "Send a message from one agent to another"
@@ -2278,11 +2527,11 @@ var sendCommand = defineCommand14({
 import { spawn as spawn4 } from "child_process";
 import { existsSync as existsSync4 } from "fs";
 import { join as join4 } from "path";
-import { defineCommand as defineCommand15 } from "citty";
+import { defineCommand as defineCommand16 } from "citty";
 var bundledDaemonEntry = join4(import.meta.dirname, "daemon.js");
 var sourceDaemonEntry = join4(import.meta.dirname, "..", "..", "..", "daemon", "src", "index.ts");
 var daemonEntry = existsSync4(bundledDaemonEntry) ? bundledDaemonEntry : sourceDaemonEntry;
-var serveCommand = defineCommand15({
+var serveCommand = defineCommand16({
   meta: {
     name: "serve",
     description: "Start the bazilion daemon (HTTP API)"
@@ -2349,10 +2598,10 @@ var serveCommand = defineCommand15({
 });
 
 // src/commands/skill.ts
-import { existsSync as existsSync5, readFileSync as readFileSync6, statSync } from "fs";
-import { basename, resolve as resolve2 } from "path";
-import { defineCommand as defineCommand16 } from "citty";
-var listCmd9 = defineCommand16({
+import { existsSync as existsSync5, readFileSync as readFileSync7, statSync } from "fs";
+import { basename as basename2, resolve as resolve2 } from "path";
+import { defineCommand as defineCommand17 } from "citty";
+var listCmd10 = defineCommand17({
   meta: { name: "list", description: "List installed skills (or those attached to an agent)" },
   args: {
     agent: { type: "string", description: "Filter to skills attached to this agent" }
@@ -2384,7 +2633,7 @@ var listCmd9 = defineCommand16({
     for (const line of columnize(rows)) console.log(line);
   }
 });
-var importCmd = defineCommand16({
+var importCmd = defineCommand17({
   meta: {
     name: "import",
     description: "Import skills from openclaw, a directory, or a local .zip archive"
@@ -2403,8 +2652,8 @@ var importCmd = defineCommand16({
     const isLocalZip = args.from.toLowerCase().endsWith(".zip") && existsSync5(absFrom) && statSync(absFrom).isFile();
     let result;
     if (isLocalZip) {
-      const bytes = readFileSync6(absFrom);
-      const file = new File([bytes], basename(absFrom), { type: "application/zip" });
+      const bytes = readFileSync7(absFrom);
+      const file = new File([bytes], basename2(absFrom), { type: "application/zip" });
       const fd = new FormData();
       fd.set("file", file);
       if (args.force) fd.set("force", "true");
@@ -2428,7 +2677,7 @@ var importCmd = defineCommand16({
     }
   }
 });
-var rmCmd4 = defineCommand16({
+var rmCmd5 = defineCommand17({
   meta: { name: "rm", description: "Remove an installed skill" },
   args: {
     name: { type: "positional", required: true }
@@ -2439,18 +2688,292 @@ var rmCmd4 = defineCommand16({
     console.log(`removed skill ${args.name}`);
   }
 });
-var skillCommand = defineCommand16({
+var skillCommand = defineCommand17({
   meta: { name: "skill", description: "Manage the skill library" },
   subCommands: {
-    list: listCmd9,
+    list: listCmd10,
     import: importCmd,
-    rm: rmCmd4
+    rm: rmCmd5
+  }
+});
+
+// src/commands/telegram.ts
+import { defineCommand as defineCommand18 } from "citty";
+var setCmd2 = defineCommand18({
+  meta: {
+    name: "set",
+    description: "Save bot token + supergroup chat ID (paired write)"
+  },
+  args: {
+    token: { type: "string", required: true, description: "Bot token from @BotFather" },
+    chat: { type: "string", required: true, description: "Numeric supergroup chat ID" }
+  },
+  async run({ args }) {
+    const client = createClient2();
+    const state = await client.put("/api/config/telegram", {
+      botToken: args.token,
+      chatId: args.chat
+    });
+    console.log(`saved \xB7 token ${state.botTokenPreview} \xB7 chat ${state.chatId}`);
+  }
+});
+var clearCmd = defineCommand18({
+  meta: {
+    name: "clear",
+    description: "Remove stored bot token + chat ID"
+  },
+  async run() {
+    const client = createClient2();
+    await client.del("/api/config/telegram");
+    console.log("cleared");
+  }
+});
+var showCmd6 = defineCommand18({
+  meta: {
+    name: "show",
+    description: "Show what credentials are stored (token is masked)"
+  },
+  async run() {
+    const client = createClient2();
+    const state = await client.get("/api/config/telegram");
+    if (!state.configured) {
+      console.log("(no credentials saved \u2014 run `bazilion telegram config set --token \u2026 --chat \u2026`)");
+      return;
+    }
+    console.log(`token: ${state.botTokenPreview}`);
+    console.log(`chat:  ${state.chatId}`);
+    if (state.migratedChatId) {
+      console.log(
+        `\u26A0 supergroup migrated \u2192 ${state.migratedChatId}. Run \`bazilion telegram reconnect\` to apply.`
+      );
+    }
+  }
+});
+var reconnectCmd = defineCommand18({
+  meta: {
+    name: "reconnect",
+    description: "Apply a pending supergroup chat-id migration + re-activate the bot"
+  },
+  async run() {
+    const client = createClient2();
+    const state = await client.post("/api/config/telegram/reconnect");
+    console.log(`reconnected \xB7 chat ${state.chatId}`);
+  }
+});
+var configCmd = defineCommand18({
+  meta: {
+    name: "config",
+    description: "Manage Telegram credentials (bot token + chat ID)"
+  },
+  subCommands: {
+    set: setCmd2,
+    clear: clearCmd,
+    show: showCmd6
+  }
+});
+var healthCmd = defineCommand18({
+  meta: {
+    name: "health",
+    description: "Run the four-step preflight against the Telegram Bot API"
+  },
+  async run() {
+    const client = createClient2();
+    const h = await client.get("/api/config/telegram/health");
+    if (!h.configured) {
+      console.log("not configured \u2014 run `bazilion telegram config set` first");
+      process.exitCode = 1;
+      return;
+    }
+    if (h.error) {
+      console.error(`error at ${h.error.step}: ${h.error.message}`);
+      process.exitCode = 1;
+      return;
+    }
+    if (!h.preflight) {
+      console.error("preflight returned no data");
+      process.exitCode = 1;
+      return;
+    }
+    const p = h.preflight;
+    const line = (ok, label, detail) => `${ok ? "\u2713" : "\u2715"} ${label.padEnd(30)} ${detail}`;
+    console.log(line(p.botUsername.length > 0, "bot identity", `@${p.botUsername}`));
+    console.log(line(p.chatTitle.length > 0, "supergroup reachable", p.chatTitle));
+    console.log(line(p.isForum, "forum topics enabled", String(p.isForum)));
+    console.log(line(p.hasManageTopics, "can_manage_topics", String(p.hasManageTopics)));
+    console.log(line(p.privacyModeOff, "Privacy Mode is OFF", String(p.privacyModeOff)));
+    const allOk = p.botUsername.length > 0 && p.chatTitle.length > 0 && p.isForum && p.hasManageTopics && p.privacyModeOff;
+    if (!allOk) process.exitCode = 1;
+  }
+});
+var botStatusCmd = defineCommand18({
+  meta: {
+    name: "status",
+    description: "Show polling state of the live bot"
+  },
+  async run() {
+    const client = createClient2();
+    const h = await client.get("/api/config/telegram/health");
+    if (!h.polling) {
+      console.log("bot: not running");
+      process.exitCode = 1;
+      return;
+    }
+    const p = h.polling;
+    const startedAt = p.startedAt ? new Date(p.startedAt).toISOString() : "(never)";
+    const lastPoll = p.lastSuccessfulPollAt ? new Date(p.lastSuccessfulPollAt).toISOString() : "(never)";
+    console.log(`running:            ${p.running}`);
+    console.log(`activated:          ${p.activated}`);
+    console.log(`started at:         ${startedAt}`);
+    console.log(`last update id:     ${p.lastUpdateId ?? "(none)"}`);
+    console.log(`last successful:    ${lastPoll}`);
+    if (p.error) console.log(`error:              ${p.error}`);
+    if (!p.running) process.exitCode = 1;
+  }
+});
+var botRestartCmd = defineCommand18({
+  meta: {
+    name: "restart",
+    description: "Force-restart the bot (tears down + brings up from current creds)"
+  },
+  async run() {
+    const client = createClient2();
+    await client.post("/api/config/telegram/restart");
+    console.log("restart requested");
+  }
+});
+var botCmd = defineCommand18({
+  meta: {
+    name: "bot",
+    description: "Inspect / control the live polling bot"
+  },
+  subCommands: {
+    status: botStatusCmd,
+    restart: botRestartCmd
+  }
+});
+var bindCmd = defineCommand18({
+  meta: {
+    name: "bind",
+    description: "Create a Telegram topic for an agent (manual fallback for /talk)"
+  },
+  args: {
+    agent: { type: "positional", required: true, description: "Agent id or prefix" }
+  },
+  async run({ args }) {
+    const client = createClient2();
+    const result = await client.post(
+      `/api/agents/${args.agent}/telegram/bind`
+    );
+    const verb = result.created ? "created topic" : "already bound to";
+    console.log(`${verb} #${result.topicId} for agent ${result.agent.name} (${result.agent.id})`);
+    console.log(`  ${result.deepLink}`);
+  }
+});
+var unbindCmd = defineCommand18({
+  meta: {
+    name: "unbind",
+    description: "Clear an agent's Telegram topic binding (topic stays in Telegram as orphan)"
+  },
+  args: {
+    agent: { type: "positional", required: true, description: "Agent id or prefix" }
+  },
+  async run({ args }) {
+    const client = createClient2();
+    await client.del(`/api/agents/${args.agent}/telegram/binding`);
+    console.log(`unbound agent ${args.agent}`);
+  }
+});
+var listBindingsCmd = defineCommand18({
+  meta: {
+    name: "list",
+    description: "List agents and their Telegram topic bindings"
+  },
+  async run() {
+    const client = createClient2();
+    const agents = await client.get("/api/agents");
+    const bound = agents.filter((a) => a.telegramTopicId !== null);
+    const unbound = agents.filter((a) => a.telegramTopicId === null);
+    if (bound.length === 0 && unbound.length === 0) {
+      console.log("(no agents)");
+      return;
+    }
+    if (bound.length > 0) {
+      console.log("bound:");
+      for (const a of bound) {
+        console.log(`  #${a.telegramTopicId}	${a.name}	(group: ${a.groupId})`);
+      }
+    }
+    if (unbound.length > 0) {
+      console.log("unbound:");
+      for (const a of unbound) {
+        console.log(`  \u2014	${a.name}	(group: ${a.groupId})`);
+      }
+    }
+  }
+});
+var allowCmd = defineCommand18({
+  meta: { name: "allow", description: "Add a Telegram user id to the allowlist" },
+  args: {
+    userId: { type: "positional", required: true, description: "Numeric Telegram user id" },
+    label: { type: "string", description: "Optional human label" },
+    owner: { type: "boolean", description: "Grant owner role (can manage the allowlist)" }
+  },
+  async run({ args }) {
+    const client = createClient2();
+    const u = await client.post("/api/config/telegram/acl", {
+      userId: Number(args.userId),
+      label: args.label ?? null,
+      role: args.owner ? "owner" : "member"
+    });
+    console.log(`allowed ${u.userId} (${u.role})`);
+  }
+});
+var denyCmd = defineCommand18({
+  meta: { name: "deny", description: "Remove a Telegram user id from the allowlist" },
+  args: { userId: { type: "positional", required: true } },
+  async run({ args }) {
+    const client = createClient2();
+    await client.del(`/api/config/telegram/acl/${Number(args.userId)}`);
+    console.log(`removed ${args.userId}`);
+  }
+});
+var allowedCmd = defineCommand18({
+  meta: { name: "allowed", description: "List allowlisted Telegram users" },
+  async run() {
+    const client = createClient2();
+    const users = await client.get("/api/config/telegram/acl");
+    if (users.length === 0) {
+      console.log("(allowlist empty \u2014 open; first user to message becomes owner)");
+      return;
+    }
+    for (const u of users) {
+      const who = u.label ?? (u.username ? `@${u.username}` : "\u2014");
+      console.log(`${u.userId}	${u.role}	${who}`);
+    }
+  }
+});
+var telegramCommand = defineCommand18({
+  meta: {
+    name: "telegram",
+    description: "Telegram integration: credentials, health, bot lifecycle, bindings, access"
+  },
+  subCommands: {
+    config: configCmd,
+    health: healthCmd,
+    bot: botCmd,
+    reconnect: reconnectCmd,
+    bind: bindCmd,
+    unbind: unbindCmd,
+    list: listBindingsCmd,
+    allow: allowCmd,
+    deny: denyCmd,
+    allowed: allowedCmd
   }
 });
 
 // src/commands/token.ts
 import { networkInterfaces } from "os";
-import { defineCommand as defineCommand17 } from "citty";
+import { defineCommand as defineCommand19 } from "citty";
 import qrcode from "qrcode-terminal";
 function tokenRow(t) {
   const last = t.lastUsedAt ? new Date(t.lastUsedAt).toISOString() : "(never)";
@@ -2484,7 +3007,7 @@ function resolveQrServer(override) {
   if (detected.warning) console.warn(`\u26A0 ${detected.warning}`);
   return detected.origin;
 }
-var createCmd4 = defineCommand17({
+var createCmd4 = defineCommand19({
   meta: { name: "create", description: "Mint a new web token (shown once)" },
   args: {
     label: { type: "positional", required: true, description: "Human-readable label" },
@@ -2515,7 +3038,7 @@ var createCmd4 = defineCommand17({
     qrcode.generate(pairUrl, { small: true }, (qr) => console.log(qr));
   }
 });
-var listCmd10 = defineCommand17({
+var listCmd11 = defineCommand19({
   meta: { name: "list", description: "List web tokens" },
   args: {
     all: { type: "boolean", description: "Include revoked tokens" }
@@ -2531,7 +3054,7 @@ var listCmd10 = defineCommand17({
     for (const line of columnize(tokens.map(tokenRow))) console.log(line);
   }
 });
-var showLocalCmd = defineCommand17({
+var showLocalCmd = defineCommand19({
   meta: {
     name: "show-local",
     description: "Print the bootstrap web token stored in ~/.bazilion/auth.json"
@@ -2541,7 +3064,7 @@ var showLocalCmd = defineCommand17({
     console.log(readAuthFile(paths.authFile).token);
   }
 });
-var revokeCmd = defineCommand17({
+var revokeCmd = defineCommand19({
   meta: { name: "revoke", description: "Revoke a web token" },
   args: {
     id: { type: "positional", required: true }
@@ -2552,19 +3075,19 @@ var revokeCmd = defineCommand17({
     console.log(`revoked token ${args.id}`);
   }
 });
-var tokenCommand = defineCommand17({
+var tokenCommand = defineCommand19({
   meta: { name: "token", description: "Manage web tokens for API/CLI clients" },
   subCommands: {
     create: createCmd4,
-    list: listCmd10,
+    list: listCmd11,
     revoke: revokeCmd,
     "show-local": showLocalCmd
   }
 });
 
 // src/commands/trigger.ts
-import { defineCommand as defineCommand18 } from "citty";
-var addCmd2 = defineCommand18({
+import { defineCommand as defineCommand20 } from "citty";
+var addCmd3 = defineCommand20({
   meta: { name: "add", description: "Add a heartbeat / cron trigger to an agent" },
   args: {
     agent: { type: "positional", required: true },
@@ -2612,7 +3135,7 @@ function triggerRow(t) {
   const msgPreview = t.message.length > 60 ? `${t.message.slice(0, 60)}\u2026` : t.message;
   return [t.id, state, spec, `last: ${last}`, `"${msgPreview}"`];
 }
-var listCmd11 = defineCommand18({
+var listCmd12 = defineCommand20({
   meta: { name: "list", description: "List triggers for an agent" },
   args: {
     agent: { type: "positional", required: true }
@@ -2629,7 +3152,7 @@ var listCmd11 = defineCommand18({
     for (const line of columnize(triggers.map(triggerRow))) console.log(line);
   }
 });
-var rmCmd5 = defineCommand18({
+var rmCmd6 = defineCommand20({
   meta: { name: "rm", description: "Delete a trigger" },
   args: {
     id: { type: "positional", required: true }
@@ -2640,7 +3163,7 @@ var rmCmd5 = defineCommand18({
     console.log(`removed trigger ${args.id}`);
   }
 });
-var enableCmd2 = defineCommand18({
+var enableCmd3 = defineCommand20({
   meta: { name: "enable", description: "Enable a trigger" },
   args: {
     id: { type: "positional", required: true }
@@ -2652,7 +3175,7 @@ var enableCmd2 = defineCommand18({
     console.log(`enabled trigger ${args.id}`);
   }
 });
-var disableCmd2 = defineCommand18({
+var disableCmd3 = defineCommand20({
   meta: { name: "disable", description: "Disable a trigger" },
   args: {
     id: { type: "positional", required: true }
@@ -2664,21 +3187,21 @@ var disableCmd2 = defineCommand18({
     console.log(`disabled trigger ${args.id}`);
   }
 });
-var triggerCommand = defineCommand18({
+var triggerCommand = defineCommand20({
   meta: { name: "trigger", description: "Manage agent heartbeats / cron triggers" },
   subCommands: {
-    add: addCmd2,
-    list: listCmd11,
-    rm: rmCmd5,
-    enable: enableCmd2,
-    disable: disableCmd2
+    add: addCmd3,
+    list: listCmd12,
+    rm: rmCmd6,
+    enable: enableCmd3,
+    disable: disableCmd3
   }
 });
 
 // src/commands/uninstall.ts
 import { existsSync as existsSync6, readdirSync as readdirSync2, rmSync as rmSync4 } from "fs";
 import { join as join5 } from "path";
-import { defineCommand as defineCommand19 } from "citty";
+import { defineCommand as defineCommand21 } from "citty";
 function makeLineReader() {
   let buffer = "";
   let ended = false;
@@ -2726,7 +3249,7 @@ function removePath(p) {
   rmSync4(p, { recursive: true, force: true });
   return true;
 }
-var uninstallCommand = defineCommand19({
+var uninstallCommand = defineCommand21({
   meta: {
     name: "uninstall",
     description: "Wipe bazilion state from ~/.bazilion (or BAZILION_HOME)"
@@ -2804,7 +3327,7 @@ var uninstallCommand = defineCommand19({
 
 // src/index.ts
 var VERSION = package_default.version;
-var main = defineCommand20({
+var main = defineCommand22({
   meta: {
     name: "bazilion",
     version: VERSION,
@@ -2818,6 +3341,7 @@ var main = defineCommand20({
     agent: agentCommand,
     skill: skillCommand,
     memory: memoryCommand,
+    mcp: mcpCommand,
     provider: providerCommand,
     send: sendCommand,
     inbox: inboxCommand,
@@ -2828,6 +3352,7 @@ var main = defineCommand20({
     trigger: triggerCommand,
     token: tokenCommand,
     auth: authCommand,
+    telegram: telegramCommand,
     uninstall: uninstallCommand
   }
 });
@@ -2903,6 +3428,10 @@ function printTopLevelHelp() {
         ["trigger", "Manage agent heartbeats / cron triggers"]
       ]
     },
+    {
+      title: "integrations",
+      items: [["telegram", "Telegram bot setup, health, lifecycle"]]
+    },
     {
       title: "ops",
       items: [["backup", "Download a tar.gz backup of ~/.bazilion"]]