@ycodium-ai/plugin-im 0.2.3250 → 0.2.3252

package/README.md

@@ -260,9 +260,9 @@ is sent to the chat. `chat_type` (1 single, 2 group) comes from the last inbound
 conversation and is left out when none has arrived since the plugin started, as plain text does.
 A picture goes as `image` only when it is PNG, JPEG or GIF within 10 MB (`imageMimeTypes`).
 
-Chat commands: `/stop`, `/continue`, `/status`, `/new`, `/sessions`, `/resume`, `/history [count]`, `/model`,
+Chat commands: `/stop`, `/continue`, `/status`, `/version`, `/new`, `/sessions`, `/resume`, `/history [count]`, `/model`,
 `/plan`, `/repo`, `/group`, `/team`, `/thread`, `/help`, `/panel`. In a chat with no project
-`/sessions`, `/resume` and the team commands answer with the project picker. `/sessions` and `/resume` only list and
+`/sessions`, `/resume` and the team commands answer with the project picker. `/version` still answers. `/sessions` and `/resume` only list and
 switch threads this plugin opened, since the host lets a plugin send only into
 its own threads. `/continue` calls `threads.turnQueue.resume` for the chat's thread
 when its queue is paused (a `/stop` or a failure pauses it), which is how WeCom
@@ -270,6 +270,8 @@ resumes a paused queue from the chat; it is not `/resume`, which already switche
 
 `/history [count]` previews the current session's recent user and assistant messages in private chats only (default 3, maximum 5), oldest first. It does not start a turn or change the session. Images and files appear as placeholders; long text is split for the platform, with a notice when the preview text is incomplete. Type the command in the chat; panels and native command menus do not list it. With the reply language set to Chinese, `会话历史 [数量]` works too.
 
+`/version` answers with one line, the plugin name and its version. It takes no arguments; if anything follows it, the reply is a usage reminder. It works in private chats and groups, does not read the session, and does not start a turn. Type it; panels and native command menus do not list it. There is no Chinese alias.
+
 On Lark, Telegram, and the WeCom smart bot, `/panel` sends a command panel, and `/help` stays text and ends with a pointer to it. WeCom App does not implement the panel surface, so `/panel` answers with the text list and `/help` does not mention `/panel`. Lark cards and Telegram inline keyboards show all command buttons. The WeCom smart bot uses a template card from `src/wecomPanel.ts`; its main menu is limited to six buttons. Commands that do not fit are listed in `/help` and can be typed into the chat. Commands that take an argument (a thread, a project, a model) open a second view on the same message with a Back button. These lists let you reach every option by paging: Lark and Telegram show eight items per page, and WeCom shows three, leaving room for Back, Previous, and Next. A tap on the WeCom card updates that same card; when the update cannot be applied, `src/panelController.ts` posts a new card and the old one stops accepting taps. A busy placeholder is not drawn on that card: it stays as it is until the next interactive view. Telegram buttons carry only a short `pn:<version>:<index>` token (`callback_data` is capped at 64 bytes); the action stays in memory and a tap on an older keyboard version counts as expired. Each card keeps its own view stack in memory (`src/panelController.ts`), so after a restart an old card only answers that it has expired. A tap runs the same handler as the typed command and waits in the same per-chat queue as typed messages. Another platform opts in by implementing the optional `panel` surface on its adapter (`src/adapter.ts`).
 
 `/team` uses the chat's selected project. It reads the roster from the `team` plugin and

package/dist/index.js

@@ -133557,7 +133557,10 @@ var PlanCommandMode = Literals(["toggle", "on", "off", "invalid"]);
 var ParsedChatCommand = Union2([
   SimpleChatCommand,
   Struct({ kind: Literal2("sessions"), arg: optionalKey2(String4) }),
-  Struct({ kind: Literals(["resume", "model", "repo"]), arg: String4 }),
+  Struct({
+    kind: Literals(["resume", "model", "repo", "version"]),
+    arg: String4
+  }),
   Struct({ kind: Literal2("history"), count: NullOr(Number5) }),
   Struct({
     kind: Literal2("preset"),
@@ -133603,6 +133606,8 @@ var parseChatCommand = (input) => {
   if (/^\/stop$/i.test(trimmed)) return { kind: "stop" };
   if (/^\/continue$/i.test(trimmed)) return { kind: "continue" };
   if (/^\/status$/i.test(trimmed)) return { kind: "status" };
+  const versionArg = trimmed.match(/^\/version(?:\s+([\s\S]*))?$/iu);
+  if (versionArg !== null) return { kind: "version", arg: (versionArg[1] ?? "").trim() };
   if (/^\/new$/i.test(trimmed)) return { kind: "new" };
   if (/^\/help$/i.test(trimmed)) return { kind: "help" };
   if (/^\/panel$/i.test(trimmed)) return { kind: "panel" };
@@ -133656,6 +133661,7 @@ var helpText = (t, options = {}) => [
   t("help.stop"),
   t("help.continue"),
   t("help.status"),
+  t("help.version"),
   t("help.new"),
   t("help.sessions"),
   t("help.resume"),
@@ -133841,6 +133847,98 @@ ${body}`);
   };
 };
 
+// package.json
+var package_default = {
+  name: "@ycodium-ai/plugin-im",
+  version: "0.2.3252",
+  description: "Talk to your agents from Telegram, WeCom, Lark, or WeChat (experimental).",
+  keywords: [
+    "im",
+    "lark",
+    "telegram",
+    "wechat",
+    "wecom",
+    "wecom-app",
+    "ycodium",
+    "ycodium-plugin"
+  ],
+  license: "UNLICENSED",
+  files: [
+    "dist",
+    "assets",
+    "locales"
+  ],
+  type: "module",
+  publishConfig: {
+    access: "public"
+  },
+  scripts: {
+    build: "node build.mjs",
+    prepack: "pnpm run build",
+    typecheck: "tsgo --noEmit && tsgo --noEmit -p tsconfig.ui.json",
+    test: "vp test run"
+  },
+  devDependencies: {
+    "@effect/vitest": "catalog:",
+    "@larksuiteoapi/node-sdk": "^1.73.0",
+    "@types/markdown-it": "^14.2.0",
+    "@types/react": "~19.2.14",
+    "@ycodium-ai/plugin-api": "workspace:*",
+    effect: "catalog:",
+    esbuild: "catalog:",
+    "markdown-it": "^15.0.2",
+    react: "19.2.6",
+    "vite-plus": "catalog:",
+    "ycodium-react-test-harness": "workspace:*"
+  },
+  ycodium: {
+    plugin: "./dist/index.js",
+    displayName: "Chat bridge",
+    description: "Talk to your agents from Telegram, WeCom, Lark, or WeChat (experimental).",
+    icon: "messageCircle",
+    permissions: [
+      {
+        kind: "sessionProjection"
+      },
+      {
+        kind: "threads.user"
+      },
+      {
+        kind: "workspace.read"
+      },
+      {
+        kind: "commands.dispatch",
+        commands: [
+          "thread.create",
+          "thread.meta.update",
+          "thread.external-messages.append",
+          "thread.turn.start",
+          "thread.turn.interrupt",
+          "thread.approval.respond",
+          "thread.user-input.respond",
+          "thread.turn-intent.run",
+          "thread.turn-intent.cancel",
+          "thread.turn-queue.resume"
+        ]
+      },
+      {
+        kind: "ui.seats",
+        seats: [
+          "settings.section"
+        ]
+      }
+    ],
+    ui: {
+      assets: "./assets",
+      entry: "ui.js"
+    }
+  }
+};
+
+// src/versionCommand.ts
+var pluginVersion = package_default.version;
+var versionReply = (t, arg) => arg === "" ? t("version.current", { version: pluginVersion }) : t("version.usage");
+
 // src/commands.ts
 var NEEDS_PROJECT_COMMANDS = /* @__PURE__ */ new Set(["sessions", "resume", "selectTeam", "selectThread"]);
 var makeCommands = (core, deps) => {
@@ -133922,6 +134020,9 @@ var makeCommands = (core, deps) => {
         bindChat(chatKey, null);
         await deliver(binding, t("command.newSession"));
         return;
+      case "version":
+        await deliver(binding, versionReply(t, command.arg));
+        return;
       case "status": {
         const threadId = chatOf(core.state, chatKey).threadId ?? void 0;
         const routed = targetOf(binding);
@@ -146251,11 +146352,16 @@ var en_default = {
     project: "Project: {{title}}",
     noProject: "No project picked yet. Send /repo to pick one."
   },
+  version: {
+    current: "Ycodium Chat bridge v{{version}}",
+    usage: "Usage: /version (no arguments)."
+  },
   help: {
     title: "Commands:",
     continue: "\xB7 /continue \u2014 resume sending after /stop or a failure paused it; the waiting messages go out",
     stop: "\xB7 /stop \u2014 stop the turn that is running; the session stays",
     status: "\xB7 /status \u2014 what is going on right now",
+    version: "\xB7 /version \u2014 the chat bridge's version (no arguments)",
     new: "\xB7 /new \u2014 forget the current session; the next message starts a new one",
     team: "\xB7 /team \u2014 give this project's team a goal with each message; use /repo to pick the project first",
     thread: "\xB7 /thread \u2014 go back to a normal session",
@@ -147176,11 +147282,16 @@ var zh_CN_default = {
     project: "\u9879\u76EE\uFF1A{{title}}",
     noProject: "\u8FD8\u6CA1\u9009\u9879\u76EE\u3002\u53D1 /repo \u9009\u4E00\u4E2A\u3002"
   },
+  version: {
+    current: "Ycodium \u804A\u5929\u6865 v{{version}}",
+    usage: "\u7528\u6CD5\uFF1A/version\uFF08\u4E0D\u5E26\u53C2\u6570\uFF09\u3002"
+  },
   help: {
     title: "\u80FD\u7528\u7684\u547D\u4EE4\uFF1A",
     continue: "\xB7 /continue \u2014\u2014 /stop \u6216\u51FA\u9519\u6682\u505C\u4E86\u53D1\u9001\u4E4B\u540E\uFF0C\u7528\u5B83\u6062\u590D\uFF0C\u6392\u7740\u7684\u6D88\u606F\u7EE7\u7EED\u53D1\u51FA",
     stop: "\xB7 /stop \u2014\u2014 \u505C\u6389\u6B63\u5728\u8DD1\u7684\u8FD9\u4E00\u8F6E\uFF0C\u4F1A\u8BDD\u7559\u7740",
     status: "\xB7 /status \u2014\u2014 \u73B0\u5728\u5728\u5E72\u4EC0\u4E48",
+    version: "\xB7 /version \u2014\u2014 \u804A\u5929\u6865\u7684\u7248\u672C\uFF08\u4E0D\u5E26\u53C2\u6570\uFF09",
     new: "\xB7 /new \u2014\u2014 \u5FD8\u6389\u5F53\u524D\u4F1A\u8BDD\uFF0C\u4E0B\u4E00\u53E5\u5F00\u65B0\u7684",
     team: "\xB7 /team \u2014\u2014 \u6BCF\u6761\u6D88\u606F\u90FD\u7ED9\u8FD9\u4E2A\u9879\u76EE\u7684\u56E2\u961F\u5F00\u4E00\u4E2A\u76EE\u6807\uFF1B\u5148\u7528 /repo \u9009\u9879\u76EE",
     thread: "\xB7 /thread \u2014\u2014 \u5207\u56DE\u666E\u901A\u4F1A\u8BDD",
@@ -155597,7 +155708,7 @@ var makeWecomAppAdapter = (deps) => {
 // src/index.ts
 var definition = {
   id: "im",
-  apiVersion: 28,
+  apiVersion: 29,
   // 第二个参数只给插件自己的测试夹具：换掉文件 IO 与派发重试的等待。宿主只传 ctx。
   activate: async (ctx, testing = {}) => {
     const { dispatchSleep } = testing;

package/locales/en.json

@@ -340,11 +340,16 @@
     "project": "Project: {{title}}",
     "noProject": "No project picked yet. Send /repo to pick one."
   },
+  "version": {
+    "current": "Ycodium Chat bridge v{{version}}",
+    "usage": "Usage: /version (no arguments)."
+  },
   "help": {
     "title": "Commands:",
     "continue": "· /continue — resume sending after /stop or a failure paused it; the waiting messages go out",
     "stop": "· /stop — stop the turn that is running; the session stays",
     "status": "· /status — what is going on right now",
+    "version": "· /version — the chat bridge's version (no arguments)",
     "new": "· /new — forget the current session; the next message starts a new one",
     "team": "· /team — give this project's team a goal with each message; use /repo to pick the project first",
     "thread": "· /thread — go back to a normal session",

package/locales/zh-CN.json

@@ -340,11 +340,16 @@
     "project": "项目：{{title}}",
     "noProject": "还没选项目。发 /repo 选一个。"
   },
+  "version": {
+    "current": "Ycodium 聊天桥 v{{version}}",
+    "usage": "用法：/version（不带参数）。"
+  },
   "help": {
     "title": "能用的命令：",
     "continue": "· /continue —— /stop 或出错暂停了发送之后，用它恢复，排着的消息继续发出",
     "stop": "· /stop —— 停掉正在跑的这一轮，会话留着",
     "status": "· /status —— 现在在干什么",
+    "version": "· /version —— 聊天桥的版本（不带参数）",
     "new": "· /new —— 忘掉当前会话，下一句开新的",
     "team": "· /team —— 每条消息都给这个项目的团队开一个目标；先用 /repo 选项目",
     "thread": "· /thread —— 切回普通会话",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/plugin-im",
-  "version": "0.2.3250",
+  "version": "0.2.3252",
   "description": "Talk to your agents from Telegram, WeCom, Lark, or WeChat (experimental).",
   "keywords": [
     "im",
@@ -33,7 +33,7 @@
     "react": "19.2.6",
     "vite-plus": "0.2.2",
     "ycodium-react-test-harness": "0.0.0",
-    "@ycodium-ai/plugin-api": "0.2.3250"
+    "@ycodium-ai/plugin-api": "0.2.3252"
   },
   "ycodium": {
     "plugin": "./dist/index.js",