bazilion 0.2.0 → 0.3.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 defineCommand21, runCommand, showUsage } from "citty";
 
 // package.json
 var package_default = {
   name: "bazilion",
-  version: "0.2.0",
+  version: "0.3.0",
   description: "Multi-agent runtime CLI \u2014 spawn LLM agents, manage profiles/groups/skills, and run the local daemon.",
   license: "MIT",
   repository: {
@@ -266,7 +266,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 +275,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 +299,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})`);
   }
@@ -1385,13 +1405,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
   }
 });
 
@@ -2448,9 +2519,283 @@ var skillCommand = defineCommand16({
   }
 });
 
+// src/commands/telegram.ts
+import { defineCommand as defineCommand17 } from "citty";
+var setCmd2 = defineCommand17({
+  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 = defineCommand17({
+  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 showCmd5 = defineCommand17({
+  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 = defineCommand17({
+  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 = defineCommand17({
+  meta: {
+    name: "config",
+    description: "Manage Telegram credentials (bot token + chat ID)"
+  },
+  subCommands: {
+    set: setCmd2,
+    clear: clearCmd,
+    show: showCmd5
+  }
+});
+var healthCmd = defineCommand17({
+  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 = defineCommand17({
+  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 = defineCommand17({
+  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 = defineCommand17({
+  meta: {
+    name: "bot",
+    description: "Inspect / control the live polling bot"
+  },
+  subCommands: {
+    status: botStatusCmd,
+    restart: botRestartCmd
+  }
+});
+var bindCmd = defineCommand17({
+  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 = defineCommand17({
+  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 = defineCommand17({
+  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 = defineCommand17({
+  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 = defineCommand17({
+  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 = defineCommand17({
+  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 = defineCommand17({
+  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 defineCommand18 } from "citty";
 import qrcode from "qrcode-terminal";
 function tokenRow(t) {
   const last = t.lastUsedAt ? new Date(t.lastUsedAt).toISOString() : "(never)";
@@ -2484,7 +2829,7 @@ function resolveQrServer(override) {
   if (detected.warning) console.warn(`\u26A0 ${detected.warning}`);
   return detected.origin;
 }
-var createCmd4 = defineCommand17({
+var createCmd4 = defineCommand18({
   meta: { name: "create", description: "Mint a new web token (shown once)" },
   args: {
     label: { type: "positional", required: true, description: "Human-readable label" },
@@ -2515,7 +2860,7 @@ var createCmd4 = defineCommand17({
     qrcode.generate(pairUrl, { small: true }, (qr) => console.log(qr));
   }
 });
-var listCmd10 = defineCommand17({
+var listCmd10 = defineCommand18({
   meta: { name: "list", description: "List web tokens" },
   args: {
     all: { type: "boolean", description: "Include revoked tokens" }
@@ -2531,7 +2876,7 @@ var listCmd10 = defineCommand17({
     for (const line of columnize(tokens.map(tokenRow))) console.log(line);
   }
 });
-var showLocalCmd = defineCommand17({
+var showLocalCmd = defineCommand18({
   meta: {
     name: "show-local",
     description: "Print the bootstrap web token stored in ~/.bazilion/auth.json"
@@ -2541,7 +2886,7 @@ var showLocalCmd = defineCommand17({
     console.log(readAuthFile(paths.authFile).token);
   }
 });
-var revokeCmd = defineCommand17({
+var revokeCmd = defineCommand18({
   meta: { name: "revoke", description: "Revoke a web token" },
   args: {
     id: { type: "positional", required: true }
@@ -2552,7 +2897,7 @@ var revokeCmd = defineCommand17({
     console.log(`revoked token ${args.id}`);
   }
 });
-var tokenCommand = defineCommand17({
+var tokenCommand = defineCommand18({
   meta: { name: "token", description: "Manage web tokens for API/CLI clients" },
   subCommands: {
     create: createCmd4,
@@ -2563,8 +2908,8 @@ var tokenCommand = defineCommand17({
 });
 
 // src/commands/trigger.ts
-import { defineCommand as defineCommand18 } from "citty";
-var addCmd2 = defineCommand18({
+import { defineCommand as defineCommand19 } from "citty";
+var addCmd2 = defineCommand19({
   meta: { name: "add", description: "Add a heartbeat / cron trigger to an agent" },
   args: {
     agent: { type: "positional", required: true },
@@ -2612,7 +2957,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 listCmd11 = defineCommand19({
   meta: { name: "list", description: "List triggers for an agent" },
   args: {
     agent: { type: "positional", required: true }
@@ -2629,7 +2974,7 @@ var listCmd11 = defineCommand18({
     for (const line of columnize(triggers.map(triggerRow))) console.log(line);
   }
 });
-var rmCmd5 = defineCommand18({
+var rmCmd5 = defineCommand19({
   meta: { name: "rm", description: "Delete a trigger" },
   args: {
     id: { type: "positional", required: true }
@@ -2640,7 +2985,7 @@ var rmCmd5 = defineCommand18({
     console.log(`removed trigger ${args.id}`);
   }
 });
-var enableCmd2 = defineCommand18({
+var enableCmd2 = defineCommand19({
   meta: { name: "enable", description: "Enable a trigger" },
   args: {
     id: { type: "positional", required: true }
@@ -2652,7 +2997,7 @@ var enableCmd2 = defineCommand18({
     console.log(`enabled trigger ${args.id}`);
   }
 });
-var disableCmd2 = defineCommand18({
+var disableCmd2 = defineCommand19({
   meta: { name: "disable", description: "Disable a trigger" },
   args: {
     id: { type: "positional", required: true }
@@ -2664,7 +3009,7 @@ var disableCmd2 = defineCommand18({
     console.log(`disabled trigger ${args.id}`);
   }
 });
-var triggerCommand = defineCommand18({
+var triggerCommand = defineCommand19({
   meta: { name: "trigger", description: "Manage agent heartbeats / cron triggers" },
   subCommands: {
     add: addCmd2,
@@ -2678,7 +3023,7 @@ var triggerCommand = defineCommand18({
 // 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 defineCommand20 } from "citty";
 function makeLineReader() {
   let buffer = "";
   let ended = false;
@@ -2726,7 +3071,7 @@ function removePath(p) {
   rmSync4(p, { recursive: true, force: true });
   return true;
 }
-var uninstallCommand = defineCommand19({
+var uninstallCommand = defineCommand20({
   meta: {
     name: "uninstall",
     description: "Wipe bazilion state from ~/.bazilion (or BAZILION_HOME)"
@@ -2804,7 +3149,7 @@ var uninstallCommand = defineCommand19({
 
 // src/index.ts
 var VERSION = package_default.version;
-var main = defineCommand20({
+var main = defineCommand21({
   meta: {
     name: "bazilion",
     version: VERSION,
@@ -2828,6 +3173,7 @@ var main = defineCommand20({
     trigger: triggerCommand,
     token: tokenCommand,
     auth: authCommand,
+    telegram: telegramCommand,
     uninstall: uninstallCommand
   }
 });
@@ -2903,6 +3249,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"]]