@layorixinc/axterm 0.1.0 → 0.3.0

package/dist/cli.js

@@ -684,7 +684,8 @@ usage:
   axterm fanout --count 3 [--prefix try] "prompt"
   axterm worktree list|rm <branch> [--force]
   axterm diff <id> [--base REF]
-  axterm telegram link|doctor|status
+  axterm telegram link|doctor|status|discover
+                                   discover lists the group and user ids your bot can see
   axterm setup                     interactive configuration (runs automatically on first use)
   axterm doctor                    diagnose the silent failures: agent binaries, hook configs, codex trust, the bridge
   axterm config list|get <path>|set <path> <v>|unset <path>|path|import-env [file]
@@ -745,7 +746,7 @@ locale: set AXTERM_LANG=en|ko, or \`axterm config set locale ko\`
     "cli.usage.worktree": "usage: axterm worktree list|rm <branch> [--force]",
     "cli.usage.worktreeRm": "usage: axterm worktree rm <branch> [--force]",
     "cli.usage.daemon": "usage: axterm daemon status|stop",
-    "cli.usage.telegram": "usage: axterm telegram link|doctor|status",
+    "cli.usage.telegram": "usage: axterm telegram link|doctor|status|discover",
     "cli.usage.fanout": "usage: axterm fanout --count N <prompt>",
     "cli.config.set": "set {path}",
     "cli.config.unset": "unset {path}",
@@ -762,6 +763,13 @@ locale: set AXTERM_LANG=en|ko, or \`axterm config set locale ko\`
     "cli.daemon.stopping": "daemon stopping",
     "cli.daemon.notReady": "daemon did not become ready within 15s (see {log})",
     "cli.telegram.missingSettings": "telegram link: no token/group/user found. Provide --token/--group/--user flags, TELEGRAM_* environment variables, or a .env file in the current directory.",
+    "cli.telegram.discoverHint": "Create a group with Topics enabled, add your bot to it, then run this again. Being added is enough \u2014 you do not have to send anything.",
+    "cli.telegram.discoverNone": "the bot cannot see any group yet.",
+    "cli.telegram.discoverChats": "groups this bot can see (use the id as --group):",
+    "cli.telegram.discoverUsers": "people it has seen (use the id as --user):",
+    "cli.telegram.topicsOff": "Topics are OFF \u2014 axterm needs them; enable Topics in the group settings",
+    "err.telegram.discoverWhileRunning": "the telegram channel is already running, and Telegram allows one reader per bot token \u2014 stop it with `axterm config set channels.telegram.enabled false` before discovering, or read the ids from `axterm telegram status`",
+    "err.telegram.noToken": "no bot token is configured \u2014 run `axterm setup` or pass --token",
     "tg.help.general.header": "axterm commands (General topic):",
     "tg.help.general.projects": "/projects \u2014 registered projects",
     "tg.help.general.new": "/new <project> [name] \u2014 new omp session",
@@ -895,8 +903,8 @@ usage: /fanout <project> <count|branches> <prompt>`,
     "wizard.prompt.agent": "Default agent command",
     "wizard.prompt.telegram": "Set up Telegram control now?",
     "wizard.prompt.telegramToken": "Bot token from @BotFather",
-    "wizard.prompt.telegramGroup": "Group id (negative, starts with -100)",
-    "wizard.prompt.telegramUsers": "Telegram user ids allowed to control axterm (comma separated)",
+    "wizard.prompt.telegramGroup": "Group id (negative, starts with -100; `axterm telegram discover` lists them)",
+    "wizard.prompt.telegramUsers": "Telegram user ids allowed to control axterm (comma separated; `axterm telegram discover` lists them)",
     "wizard.prompt.review": "Save this configuration?",
     "wizard.error.locale": "pick one of the offered languages",
     "wizard.error.machine": "letters, digits, dot, dash and underscore only",
@@ -946,7 +954,8 @@ usage: /fanout <project> <count|branches> <prompt>`,
   axterm fanout --count 3 [--prefix try] "\uD504\uB86C\uD504\uD2B8"
   axterm worktree list|rm <\uBE0C\uB79C\uCE58> [--force]
   axterm diff <id> [--base REF]
-  axterm telegram link|doctor|status
+  axterm telegram link|doctor|status|discover
+                                   discover \u2014 \uBD07\uC774 \uBCFC \uC218 \uC788\uB294 \uADF8\uB8F9\xB7\uC0AC\uC6A9\uC790 id \uBAA9\uB85D
   axterm setup                     \uB300\uD654\uD615 \uC124\uC815 (\uCD5C\uCD08 \uC2E4\uD589 \uC2DC \uC790\uB3D9)
   axterm doctor                    \uCE68\uBB35\uD558\uB294 \uC2E4\uD328\uB97C \uC9C4\uB2E8: \uC5D0\uC774\uC804\uD2B8 \uBC14\uC774\uB108\uB9AC, \uD6C5 \uC124\uC815, codex \uC2E0\uB8B0, \uBE0C\uB9AC\uC9C0
   axterm config list|get <\uACBD\uB85C>|set <\uACBD\uB85C> <\uAC12>|unset <\uACBD\uB85C>|path|import-env [\uD30C\uC77C]
@@ -1007,7 +1016,7 @@ usage: /fanout <project> <count|branches> <prompt>`,
     "cli.usage.worktree": "\uC0AC\uC6A9\uBC95: axterm worktree list|rm <\uBE0C\uB79C\uCE58> [--force]",
     "cli.usage.worktreeRm": "\uC0AC\uC6A9\uBC95: axterm worktree rm <\uBE0C\uB79C\uCE58> [--force]",
     "cli.usage.daemon": "\uC0AC\uC6A9\uBC95: axterm daemon status|stop",
-    "cli.usage.telegram": "\uC0AC\uC6A9\uBC95: axterm telegram link|doctor|status",
+    "cli.usage.telegram": "\uC0AC\uC6A9\uBC95: axterm telegram link|doctor|status|discover",
     "cli.usage.fanout": "\uC0AC\uC6A9\uBC95: axterm fanout --count N <\uD504\uB86C\uD504\uD2B8>",
     "cli.config.set": "{path} \uC124\uC815\uB428",
     "cli.config.unset": "{path} \uD574\uC81C\uB428",
@@ -1030,6 +1039,13 @@ usage: /fanout <project> <count|branches> <prompt>`,
     "tg.help.general.wt": "/wt <\uD504\uB85C\uC81D\uD2B8> <\uBE0C\uB79C\uCE58> \u2014 worktree \uC138\uC158",
     "tg.help.general.fanout": "/fanout <\uD504\uB85C\uC81D\uD2B8> <\uAC1C\uC218|\uBE0C\uB79C\uCE58\uB4E4> <\uD504\uB86C\uD504\uD2B8> \u2014 \uBCD1\uB82C \uC2E4\uD589",
     "tg.help.general.worktrees": "/worktrees <\uD504\uB85C\uC81D\uD2B8> \xB7 /rm <\uD504\uB85C\uC81D\uD2B8> <\uBE0C\uB79C\uCE58> [force]",
+    "cli.telegram.discoverHint": "\uD1A0\uD53D\uC744 \uCF20 \uADF8\uB8F9\uC744 \uB9CC\uB4E4\uACE0 \uBD07\uC744 \uCD08\uB300\uD55C \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694. \uCD08\uB300\uB9CC \uD558\uBA74 \uCDA9\uBD84\uD569\uB2C8\uB2E4 \u2014 \uBA54\uC2DC\uC9C0\uB97C \uBCF4\uB0BC \uD544\uC694\uB294 \uC5C6\uC2B5\uB2C8\uB2E4.",
+    "cli.telegram.discoverNone": "\uBD07\uC774 \uC544\uC9C1 \uC5B4\uB5A4 \uADF8\uB8F9\uB3C4 \uBCFC \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
+    "cli.telegram.discoverChats": "\uBD07\uC774 \uBCFC \uC218 \uC788\uB294 \uADF8\uB8F9 (\uC774 id\uB97C --group \uC5D0 \uC0AC\uC6A9):",
+    "cli.telegram.discoverUsers": "\uBD07\uC774 \uBCF8 \uC0AC\uC6A9\uC790 (\uC774 id\uB97C --user \uC5D0 \uC0AC\uC6A9):",
+    "cli.telegram.topicsOff": "\uD1A0\uD53D\uC774 \uAEBC\uC838 \uC788\uC2B5\uB2C8\uB2E4 \u2014 axterm\uC5D0 \uD544\uC694\uD569\uB2C8\uB2E4. \uADF8\uB8F9 \uC124\uC815\uC5D0\uC11C \uD1A0\uD53D\uC744 \uCF1C\uC138\uC694",
+    "err.telegram.discoverWhileRunning": "\uD154\uB808\uADF8\uB7A8 \uCC44\uB110\uC774 \uC774\uBBF8 \uC2E4\uD589 \uC911\uC774\uACE0, \uD154\uB808\uADF8\uB7A8\uC740 \uBD07 \uD1A0\uD070\uB2F9 \uB9AC\uB354\uB97C \uD558\uB098\uB9CC \uD5C8\uC6A9\uD569\uB2C8\uB2E4 \u2014 `axterm config set channels.telegram.enabled false` \uB85C \uBA48\uCD98 \uB4A4 \uD0D0\uC0C9\uD558\uAC70\uB098, `axterm telegram status` \uC5D0\uC11C id\uB97C \uD655\uC778\uD558\uC138\uC694",
+    "err.telegram.noToken": "\uBD07 \uD1A0\uD070\uC774 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4 \u2014 `axterm setup` \uC744 \uC2E4\uD589\uD558\uAC70\uB098 --token \uC744 \uB118\uAE30\uC138\uC694",
     "tg.help.general.sessions": "/sessions \u2014 \uC138\uC158 \uBAA9\uB85D",
     "tg.help.topic.header": "\uC138\uC158 \uD1A0\uD53D \uC548\uC5D0\uC11C\uB294 \uC77C\uBC18 \uBA54\uC2DC\uC9C0\uAC00 \uD504\uB86C\uD504\uD2B8\uB85C \uC804\uB2EC\uB429\uB2C8\uB2E4.",
     "tg.help.topic.commands": "/esc \uC911\uB2E8 \xB7 /screen \uD654\uBA74 \xB7 /diff \uBCC0\uACBD\uC694\uC57D \xB7 /resume \uB300\uD654 \uC774\uC5B4\uC11C \uC7AC\uC2DC\uC791 \xB7 /kill \uC885\uB8CC",
@@ -1157,8 +1173,8 @@ usage: /fanout <project> <count|branches> <prompt>`,
     "wizard.prompt.agent": "\uAE30\uBCF8 \uC5D0\uC774\uC804\uD2B8 \uBA85\uB839",
     "wizard.prompt.telegram": "\uC9C0\uAE08 Telegram \uC81C\uC5B4\uB97C \uC124\uC815\uD560\uAE4C\uC694?",
     "wizard.prompt.telegramToken": "@BotFather \uC5D0\uC11C \uBC1B\uC740 \uBD07 \uD1A0\uD070",
-    "wizard.prompt.telegramGroup": "\uADF8\uB8F9 id (\uC74C\uC218, \uBCF4\uD1B5 -100 \uC73C\uB85C \uC2DC\uC791)",
-    "wizard.prompt.telegramUsers": "axterm \uC870\uC791\uC744 \uD5C8\uC6A9\uD560 Telegram user id (\uC27C\uD45C\uB85C \uAD6C\uBD84)",
+    "wizard.prompt.telegramGroup": "\uADF8\uB8F9 id (\uC74C\uC218, \uBCF4\uD1B5 -100 \uC73C\uB85C \uC2DC\uC791. `axterm telegram discover` \uB85C \uD655\uC778 \uAC00\uB2A5)",
+    "wizard.prompt.telegramUsers": "axterm \uC870\uC791\uC744 \uD5C8\uC6A9\uD560 Telegram user id (\uC27C\uD45C\uB85C \uAD6C\uBD84. `axterm telegram discover` \uB85C \uD655\uC778 \uAC00\uB2A5)",
     "wizard.prompt.review": "\uC774 \uC124\uC815\uC744 \uC800\uC7A5\uD560\uAE4C\uC694?",
     "wizard.error.locale": "\uC81C\uC2DC\uB41C \uC5B8\uC5B4 \uC911\uC5D0\uC11C \uACE0\uB974\uC138\uC694",
     "wizard.error.machine": "\uC601\uBB38\xB7\uC22B\uC790\uC640 . - _ \uB9CC \uC4F8 \uC218 \uC788\uC2B5\uB2C8\uB2E4",
@@ -2215,6 +2231,85 @@ function productVersion() {
 }
 var product = "";
 
+// packages/core/src/telegram-discovery.ts
+function readChat(value) {
+  if (!isRecord(value))
+    return;
+  const id = value["id"];
+  const type = value["type"];
+  if (typeof id !== "number" || typeof type !== "string")
+    return;
+  const title = value["title"];
+  const isForum = value["is_forum"];
+  return {
+    id,
+    type,
+    ...typeof title === "string" ? { title } : {},
+    ...isForum === true ? { isForum: true } : {}
+  };
+}
+function readUser(value) {
+  if (!isRecord(value))
+    return;
+  const id = value["id"];
+  if (typeof id !== "number")
+    return;
+  if (value["is_bot"] === true)
+    return;
+  const username = value["username"];
+  const name = value["first_name"];
+  return {
+    id,
+    ...typeof username === "string" ? { username } : {},
+    ...typeof name === "string" ? { name } : {}
+  };
+}
+function detail(candidate) {
+  return (candidate.title !== undefined ? 1 : 0) + (candidate.isForum !== undefined ? 1 : 0);
+}
+function discoverTelegramTargets(updates) {
+  const chats = new Map;
+  const users = new Map;
+  if (!Array.isArray(updates))
+    return { chats: [], users: [] };
+  const noteChat = (raw) => {
+    const chat = readChat(raw);
+    if (chat === undefined || !chat.type.includes("group"))
+      return;
+    const seen = chats.get(chat.id);
+    if (seen === undefined || detail(chat) > detail(seen))
+      chats.set(chat.id, chat);
+  };
+  const noteUser = (raw) => {
+    const user = readUser(raw);
+    if (user !== undefined && !users.has(user.id))
+      users.set(user.id, user);
+  };
+  for (const update of updates) {
+    if (!isRecord(update))
+      continue;
+    for (const key of CHAT_CARRIERS) {
+      const carrier = update[key];
+      if (!isRecord(carrier))
+        continue;
+      noteChat(carrier["chat"]);
+      noteUser(carrier["from"]);
+    }
+    const callback = update["callback_query"];
+    if (isRecord(callback)) {
+      noteUser(callback["from"]);
+      const message = callback["message"];
+      if (isRecord(message))
+        noteChat(message["chat"]);
+    }
+  }
+  return { chats: [...chats.values()], users: [...users.values()] };
+}
+var CHAT_CARRIERS;
+var init_telegram_discovery = __esm(() => {
+  CHAT_CARRIERS = ["message", "edited_message", "channel_post", "edited_channel_post", "my_chat_member"];
+});
+
 // packages/core/src/codex-hooks.ts
 import { createHash } from "crypto";
 function quoteToken(token) {
@@ -2667,6 +2762,7 @@ var init_src = __esm(() => {
   init_claude_hooks();
   init_gemini_onboarding();
   init_doctor();
+  init_telegram_discovery();
   init_codex_hooks();
   init_gemini_hooks();
   init_agent_launch();
@@ -4700,6 +4796,8 @@ function startRpcServer(options) {
         }
         case "telegram.doctor":
           return telegram.doctor();
+        case "telegram.discover":
+          return telegram.discover(p["botToken"]);
         case "telegram.status":
           return telegram.status();
         case "doctor.report":
@@ -12204,6 +12302,16 @@ class TelegramService {
       hasToken: s.botToken !== undefined
     };
   }
+  async discover(botToken) {
+    if (this.channel !== undefined)
+      throw new AxtermError("err.telegram.discoverWhileRunning");
+    const token = botToken ?? this.readSettings().botToken;
+    if (!token)
+      throw new AxtermError("err.telegram.noToken");
+    const api = new FetchTelegramApi(token);
+    const updates = await api.call("getUpdates", { timeout: 0 });
+    return discoverTelegramTargets(updates);
+  }
   start() {
     const s = this.readSettings();
     if (!s.botToken || s.groupId === undefined || s.allowUserId === undefined) {
@@ -13140,7 +13248,7 @@ import { stdin as stdin2, stdout as stdout2 } from "process";
 // packages/cli/package.json
 var package_default = {
   name: "@layorixinc/axterm",
-  version: "0.1.0",
+  version: "0.3.0",
   type: "module",
   bin: {
     axterm: "dist/cli.js"
@@ -13525,9 +13633,9 @@ async function main2() {
   if (health !== undefined && shouldOfferSetup(health, command, flags)) {
     const header2 = health.status === "invalid" ? "wizard.invalid" : health.status === "incomplete" ? "wizard.incomplete" : "wizard.needed";
     console.log(t(header2));
-    const detail = describeHealth(health);
-    if (detail.length > 0)
-      console.log(detail);
+    const detail2 = describeHealth(health);
+    if (detail2.length > 0)
+      console.log(detail2);
     console.log(t("wizard.hint"));
     await runSetup(client, await client.call("config.raw"));
   }
@@ -13913,6 +14021,28 @@ async function main2() {
           console.log(JSON.stringify(await client.call("telegram.doctor"), null, 2));
         } else if (sub === "status") {
           console.log(JSON.stringify(await client.call("telegram.status"), null, 2));
+        } else if (sub === "discover") {
+          const token = flags.get("token");
+          const found = await client.call("telegram.discover", {
+            ...token !== undefined ? { botToken: token } : {}
+          });
+          if (found.chats.length > 0) {
+            console.log(t("cli.telegram.discoverChats"));
+            for (const chat of found.chats) {
+              const marks = [chat.type, chat.isForum ? undefined : t("cli.telegram.topicsOff")].filter((m) => m !== undefined).join(" \u2014 ");
+              console.log(`  ${String(chat.id).padEnd(16)} ${(chat.title ?? "").padEnd(24)} ${marks}`);
+            }
+          } else {
+            console.log(t("cli.telegram.discoverNone"));
+            console.log(t("cli.telegram.discoverHint"));
+          }
+          if (found.users.length > 0) {
+            console.log(t("cli.telegram.discoverUsers"));
+            for (const user of found.users) {
+              const label = [user.username !== undefined ? `@${user.username}` : undefined, user.name].filter((part) => part !== undefined).join(" ");
+              console.log(`  ${String(user.id).padEnd(16)} ${label}`);
+            }
+          }
         } else {
           throw new Error(t("cli.usage.telegram"));
         }

package/package.json

@@ -1,50 +1,50 @@
-{
-  "name": "@layorixinc/axterm",
-  "version": "0.1.0",
-  "type": "module",
-  "bin": {
-    "axterm": "dist/cli.js"
-  },
-  "scripts": {
-    "bundle": "bun ../../scripts/bundle-cli.ts",
-    "prepack": "bun ../../scripts/bundle-cli.ts && node ../../scripts/prepack.mjs"
-  },
-  "devDependencies": {
-    "@axterm/core": "0.1.0",
-    "@axterm/daemon": "0.1.0",
-    "typescript": "^5.6.0",
-    "@types/node": "^22.0.0"
-  },
-  "license": "MIT",
-  "description": "Run CLI coding agents as managed background sessions, and drive them from a messenger",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/layorixinc/axterm.git"
-  },
-  "homepage": "https://github.com/layorixinc/axterm#readme",
-  "bugs": {
-    "url": "https://github.com/layorixinc/axterm/issues"
-  },
-  "engines": {
-    "bun": ">=1.3.14"
-  },
-  "files": [
-    "dist/cli.js",
-    "LICENSE",
-    "README.md"
-  ],
-  "keywords": [
-    "cli",
-    "agent",
-    "pty",
-    "terminal",
-    "telegram",
-    "git-worktree",
-    "ai",
-    "coding-agent"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "author": "Layorix Inc."
-}
+{
+  "name": "@layorixinc/axterm",
+  "version": "0.3.0",
+  "type": "module",
+  "bin": {
+    "axterm": "dist/cli.js"
+  },
+  "scripts": {
+    "bundle": "bun ../../scripts/bundle-cli.ts",
+    "prepack": "bun ../../scripts/bundle-cli.ts && node ../../scripts/prepack.mjs"
+  },
+  "devDependencies": {
+    "@axterm/core": "0.1.0",
+    "@axterm/daemon": "0.1.0",
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  },
+  "license": "MIT",
+  "description": "Run CLI coding agents as managed background sessions, and drive them from a messenger",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/layorixinc/axterm.git"
+  },
+  "homepage": "https://github.com/layorixinc/axterm#readme",
+  "bugs": {
+    "url": "https://github.com/layorixinc/axterm/issues"
+  },
+  "engines": {
+    "bun": ">=1.3.14"
+  },
+  "files": [
+    "dist/cli.js",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "cli",
+    "agent",
+    "pty",
+    "terminal",
+    "telegram",
+    "git-worktree",
+    "ai",
+    "coding-agent"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Layorix Inc."
+}