@n1creator/openacp-cli 2026.712.10 → 2026.712.12

package/dist/cli.js

@@ -2276,18 +2276,17 @@ This file provides context for AI coding agents (Claude, Cursor, etc.) working o
 
 OpenACP is an open-source platform that bridges AI coding agents (Claude Code, Codex, etc.) to messaging platforms (Telegram, Discord, Slack) and custom UIs via the Agent Client Protocol (ACP). It features a microkernel plugin architecture where all features \u2014 adapters, services, commands \u2014 are plugins.
 
-- **Website & Docs**: https://openacp.gitbook.io/docs
+- **Documentation**: https://github.com/an1creator/OpenACP/tree/main/docs/gitbook
 - **GitHub**: https://github.com/an1creator/OpenACP
-- **Plugin Registry**: https://github.com/Open-ACP/plugin-registry
 
 Key documentation pages:
-- [Getting Started](https://openacp.gitbook.io/docs/getting-started) \u2014 What is OpenACP, quickstart
-- [Plugin Development](https://openacp.gitbook.io/docs/extending/building-plugins) \u2014 How to build plugins
-- [Architecture](https://openacp.gitbook.io/docs/extending/architecture) \u2014 System design, plugin lifecycle
-- [Dev Mode](https://openacp.gitbook.io/docs/extending/dev-mode) \u2014 Hot-reload development workflow
-- [CLI Commands](https://openacp.gitbook.io/docs/api-reference/cli-commands) \u2014 Full CLI reference
-- [Platform Setup](https://openacp.gitbook.io/docs/platform-setup) \u2014 Telegram, Discord, Slack guides
-- [Configuration](https://openacp.gitbook.io/docs/self-hosting/configuration) \u2014 Config and settings reference
+- [Getting Started](https://github.com/an1creator/OpenACP/tree/main/docs/gitbook/getting-started) \u2014 What is OpenACP, quickstart
+- [Plugin Development](https://github.com/an1creator/OpenACP/blob/main/docs/gitbook/extending/getting-started-plugin.md) \u2014 How to build plugins
+- [Architecture](https://github.com/an1creator/OpenACP/tree/main/docs/gitbook/architecture) \u2014 System design, plugin lifecycle
+- [Dev Mode](https://github.com/an1creator/OpenACP/blob/main/docs/gitbook/extending/dev-mode.md) \u2014 Hot-reload development workflow
+- [CLI Commands](https://github.com/an1creator/OpenACP/blob/main/docs/gitbook/api-reference/cli-commands.md) \u2014 Full CLI reference
+- [Platform Setup](https://github.com/an1creator/OpenACP/tree/main/docs/gitbook/platform-setup) \u2014 Telegram, Discord, Slack guides
+- [Configuration](https://github.com/an1creator/OpenACP/blob/main/docs/gitbook/self-hosting/configuration.md) \u2014 Config and settings reference
 
 ## Project Overview
 
@@ -2876,16 +2875,16 @@ const ctx = createTestContext({
    \`\`\`bash
    openacp plugin install ${params.pluginName}
    \`\`\`
-5. Submit to the [OpenACP Plugin Registry](https://github.com/Open-ACP/plugin-registry) for discoverability.
+5. Verify installation by the complete npm package name from a clean environment.
 
 ## Useful Links
 
-- [Architecture: Plugin System](https://docs.openacp.dev/architecture/plugin-system)
-- [Architecture: Writing Plugins](https://docs.openacp.dev/architecture/writing-plugins)
-- [Architecture: Command System](https://docs.openacp.dev/architecture/command-system)
-- [Plugin SDK Reference](https://docs.openacp.dev/extending/plugin-sdk-reference)
-- [Getting Started: Your First Plugin](https://docs.openacp.dev/extending/getting-started-plugin)
-- [Dev Mode](https://docs.openacp.dev/extending/dev-mode)
+- [Architecture: Plugin System](https://github.com/an1creator/OpenACP/blob/main/docs/gitbook/architecture/plugin-system.md)
+- [Architecture: Writing Plugins](https://github.com/an1creator/OpenACP/blob/main/docs/gitbook/architecture/writing-plugins.md)
+- [Architecture: Command System](https://github.com/an1creator/OpenACP/blob/main/docs/gitbook/architecture/command-system.md)
+- [Plugin SDK Reference](https://github.com/an1creator/OpenACP/blob/main/docs/gitbook/extending/plugin-sdk-reference.md)
+- [Getting Started: Your First Plugin](https://github.com/an1creator/OpenACP/blob/main/docs/gitbook/extending/getting-started-plugin.md)
+- [Dev Mode](https://github.com/an1creator/OpenACP/blob/main/docs/gitbook/extending/dev-mode.md)
 - [Contributing](https://github.com/an1creator/OpenACP/blob/main/CONTRIBUTING.md)
 `;
 }
@@ -16676,6 +16675,37 @@ var init_resume = __esm({
   }
 });
 
+// src/plugins/telegram/callback-navigation.ts
+function contextualCommandCallback(command2, target) {
+  if (!command2.startsWith("/")) throw new Error("Telegram navigation commands must start with /");
+  const data = target === "settings" ? `${SETTINGS_PREFIX}${command2}` : void 0;
+  return data && Buffer.byteLength(data, "utf8") <= 64 ? data : void 0;
+}
+function settingsCommandCallback(command2) {
+  const data = contextualCommandCallback(command2, "settings");
+  if (!data) throw new Error("Telegram navigation callback exceeds 64 bytes");
+  return data;
+}
+function decodeCommandCallback(data) {
+  if (data.startsWith(SETTINGS_PREFIX)) {
+    return { command: data.slice(SETTINGS_PREFIX.length), returnTarget: "settings" };
+  }
+  return { command: data.slice(2) };
+}
+function returnButton(target) {
+  switch (target) {
+    case "settings":
+      return { text: "\u25C0\uFE0F Back to Settings", callback_data: "s:back:refresh" };
+  }
+}
+var SETTINGS_PREFIX;
+var init_callback_navigation = __esm({
+  "src/plugins/telegram/callback-navigation.ts"() {
+    "use strict";
+    SETTINGS_PREFIX = "c/@settings:";
+  }
+});
+
 // src/plugins/telegram/commands/menu.ts
 var menu_exports = {};
 __export(menu_exports, {
@@ -16788,6 +16818,7 @@ async function buildSettingsKeyboard(core) {
       kb.text(`${label}`, `s:input:${field.path}`).row();
     }
   }
+  kb.text("\u{1F310} Proxy Management", settingsCommandCallback("/proxy")).row();
   kb.text("\u25C0\uFE0F Back to Menu", "s:back");
   return kb;
 }
@@ -16980,6 +17011,7 @@ var init_settings = __esm({
     "use strict";
     init_config_registry();
     init_log();
+    init_callback_navigation();
     log21 = createChildLogger({ module: "telegram-settings" });
   }
 });
@@ -20790,6 +20822,9 @@ function stalePolicyResponse(reopen) {
     options: [{ label: "Refresh", command: reopen }, { label: "Proxy menu", command: "/proxy status" }]
   };
 }
+function proxyCapabilityError() {
+  return { type: "error", message: PROXY_CAPABILITY_ERROR };
+}
 function registerProxyCommand(registry, _core) {
   const core = _core;
   registry.register({
@@ -20821,8 +20856,9 @@ function registerProxyCommand(registry, _core) {
         "wizard-auth",
         "wizard-review"
       ]);
+      if (!await canManageProxy(core, args2)) return proxyCapabilityError();
       if (action && mutations.has(action) && !await canManageProxy(core, args2)) {
-        return { type: "error", message: "This action requires network:proxy:manage capability." };
+        return proxyCapabilityError();
       }
       if (!action || action === "status") {
         return {
@@ -21306,10 +21342,14 @@ Credentials: ${profile.hasCredentials ? "configured" : "none"} \xB7 failClosed:
 async function canManageProxy(core, args2) {
   const identity = core.lifecycleManager?.serviceRegistry?.get("identity");
   if (!identity) return false;
-  const user = await identity.getUserByIdentity(formatIdentityId(args2.channelId, args2.userId));
-  return Boolean(user && hasIdentityCapability(user.role, "network:proxy:manage"));
+  try {
+    const user = await identity.getUserByIdentity(formatIdentityId(args2.channelId, args2.userId));
+    return Boolean(user && hasIdentityCapability(user.role, "network:proxy:manage"));
+  } catch {
+    return false;
+  }
 }
-var DRAFT_TTL_MS, drafts;
+var DRAFT_TTL_MS, drafts, PROXY_CAPABILITY_ERROR;
 var init_proxy3 = __esm({
   "src/core/commands/proxy.ts"() {
     "use strict";
@@ -21319,6 +21359,7 @@ var init_proxy3 = __esm({
     init_proxy_service();
     DRAFT_TTL_MS = 10 * 6e4;
     drafts = /* @__PURE__ */ new Map();
+    PROXY_CAPABILITY_ERROR = "Proxy management requires network:proxy:manage capability.";
   }
 });
 
@@ -21519,6 +21560,7 @@ var init_adapter2 = __esm({
     init_command_sync();
     init_command_ownership_store();
     init_instance_context();
+    init_callback_navigation();
     log29 = createChildLogger({ module: "telegram" });
     HISTORICAL_OPENACP_COMMAND_NAMES = /* @__PURE__ */ new Set([
       ...STATIC_COMMANDS.map((command2) => command2.command),
@@ -21847,7 +21889,13 @@ var init_adapter2 = __esm({
               }
             });
             if (response.type !== "silent" && response.type !== "delegated") {
-              await this.renderCommandResponse(response, ctx.chat.id, topicIdForInput, String(ctx.from?.id));
+              await this.renderCommandResponse(
+                response,
+                ctx.chat.id,
+                topicIdForInput,
+                String(ctx.from?.id),
+                pending.returnTarget
+              );
             }
             return;
           }
@@ -21930,7 +21978,8 @@ var init_adapter2 = __esm({
             return;
           }
           const data = ctx.callbackQuery.data;
-          const command2 = this.fromCallbackData(data);
+          const callback = this.fromCallbackData(data);
+          const command2 = callback.command;
           const registry = this.core.lifecycleManager?.serviceRegistry?.get(
             "command-registry"
           );
@@ -21959,16 +22008,23 @@ var init_adapter2 = __esm({
             await ctx.answerCallbackQuery();
             if (response.type !== "silent" && response.type !== "delegated") {
               if (response.type === "input") {
-                await this.renderCommandResponse(response, chatId, topicId, String(ctx.from?.id));
+                await this.renderCommandResponse(
+                  response,
+                  chatId,
+                  topicId,
+                  String(ctx.from?.id),
+                  callback.returnTarget
+                );
                 return;
               }
               if (response.type === "menu") {
                 const keyboard = response.options.map((opt) => [
                   {
                     text: `${opt.label}${opt.hint ? ` \u2014 ${opt.hint}` : ""}`,
-                    callback_data: this.toCallbackData(opt.command)
+                    callback_data: this.toCallbackData(opt.command, callback.returnTarget)
                   }
                 ]);
+                this.appendReturnButton(keyboard, callback.returnTarget);
                 try {
                   await ctx.editMessageText(response.title, {
                     reply_markup: { inline_keyboard: keyboard }
@@ -21987,7 +22043,11 @@ var init_adapter2 = __esm({
                   parseMode = "Markdown";
                 }
                 try {
-                  await ctx.editMessageText(text5, { ...parseMode && { parse_mode: parseMode } });
+                  const returnMarkup = this.returnMarkup(callback.returnTarget);
+                  await ctx.editMessageText(text5, {
+                    ...parseMode && { parse_mode: parseMode },
+                    ...returnMarkup && { reply_markup: returnMarkup }
+                  });
                 } catch {
                 }
               }
@@ -22588,11 +22648,13 @@ System topics have been created. Tap${assistantTopicLink} to get started.`,
         log29.info("Telegram bot stopped");
       }
       // --- CommandRegistry response rendering ---
-      async renderCommandResponse(response, chatId, topicId, userId) {
+      async renderCommandResponse(response, chatId, topicId, userId, returnTarget) {
+        const returnMarkup = this.returnMarkup(returnTarget);
         switch (response.type) {
           case "text":
             await this.bot.api.sendMessage(chatId, response.text, {
-              message_thread_id: topicId
+              message_thread_id: topicId,
+              ...returnMarkup && { reply_markup: returnMarkup }
             });
             break;
           case "adaptive": {
@@ -22600,7 +22662,8 @@ System topics have been created. Tap${assistantTopicLink} to get started.`,
             const text5 = variant?.text ?? response.fallback;
             await this.bot.api.sendMessage(chatId, text5, {
               message_thread_id: topicId,
-              ...variant?.parse_mode && { parse_mode: variant.parse_mode }
+              ...variant?.parse_mode && { parse_mode: variant.parse_mode },
+              ...returnMarkup && { reply_markup: returnMarkup }
             });
             break;
           }
@@ -22608,16 +22671,17 @@ System topics have been created. Tap${assistantTopicLink} to get started.`,
             await this.bot.api.sendMessage(
               chatId,
               `\u26A0\uFE0F ${response.message}`,
-              { message_thread_id: topicId }
+              { message_thread_id: topicId, ...returnMarkup && { reply_markup: returnMarkup } }
             );
             break;
           case "menu": {
             const keyboard = response.options.map((opt) => [
               {
                 text: `${opt.label}${opt.hint ? ` \u2014 ${opt.hint}` : ""}`,
-                callback_data: this.toCallbackData(opt.command)
+                callback_data: this.toCallbackData(opt.command, returnTarget)
               }
             ]);
+            this.appendReturnButton(keyboard, returnTarget);
             await this.bot.api.sendMessage(chatId, response.title, {
               message_thread_id: topicId,
               reply_markup: { inline_keyboard: keyboard }
@@ -22631,7 +22695,8 @@ System topics have been created. Tap${assistantTopicLink} to get started.`,
             const text5 = `${response.title}
 ${lines.join("\n")}`;
             await this.bot.api.sendMessage(chatId, text5, {
-              message_thread_id: topicId
+              message_thread_id: topicId,
+              ...returnMarkup && { reply_markup: returnMarkup }
             });
             break;
           }
@@ -22640,16 +22705,17 @@ ${lines.join("\n")}`;
               [
                 {
                   text: "\u2705 Yes",
-                  callback_data: this.toCallbackData(response.onYes)
+                  callback_data: this.toCallbackData(response.onYes, returnTarget)
                 }
               ]
             ];
             if (response.onNo) {
               buttons[0].push({
                 text: "\u274C No",
-                callback_data: this.toCallbackData(response.onNo)
+                callback_data: this.toCallbackData(response.onNo, returnTarget)
               });
             }
+            this.appendReturnButton(buttons, returnTarget);
             await this.bot.api.sendMessage(chatId, response.question, {
               message_thread_id: topicId,
               reply_markup: { inline_keyboard: buttons }
@@ -22658,7 +22724,10 @@ ${lines.join("\n")}`;
           }
           case "input": {
             if (!userId) {
-              await this.bot.api.sendMessage(chatId, response.fallback, { message_thread_id: topicId });
+              await this.bot.api.sendMessage(chatId, response.fallback, {
+                message_thread_id: topicId,
+                ...returnMarkup && { reply_markup: returnMarkup }
+              });
               break;
             }
             const key = `${chatId}:${userId}:${topicId ?? 0}`;
@@ -22680,7 +22749,8 @@ ${lines.join("\n")}`;
               sensitive: response.sensitive === true,
               fallback: response.fallback,
               expiresAt: Date.now() + (response.expiresInMs ?? 10 * 6e4),
-              promptMessageId: promptMessage.message_id
+              promptMessageId: promptMessage.message_id,
+              returnTarget
             });
             break;
           }
@@ -22688,11 +22758,15 @@ ${lines.join("\n")}`;
             break;
         }
       }
-      toCallbackData(command2) {
+      toCallbackData(command2, returnTarget) {
         const data = `c/${command2}`;
-        if (data.length <= 64) return data;
+        if (!returnTarget && Buffer.byteLength(data, "utf8") <= 64) return data;
+        if (returnTarget) {
+          const contextual = contextualCommandCallback(command2, returnTarget);
+          if (contextual) return contextual;
+        }
         const id = String(++this.callbackCounter);
-        this.callbackCache.set(id, command2);
+        this.callbackCache.set(id, { command: command2, returnTarget });
         if (this.callbackCache.size > 1e3) {
           const first = this.callbackCache.keys().next().value;
           if (first) this.callbackCache.delete(first);
@@ -22701,9 +22775,15 @@ ${lines.join("\n")}`;
       }
       fromCallbackData(data) {
         if (data.startsWith("c/#")) {
-          return this.callbackCache.get(data.slice(3)) ?? data.slice(2);
+          return this.callbackCache.get(data.slice(3)) ?? { command: data.slice(2) };
         }
-        return data.slice(2);
+        return decodeCommandCallback(data);
+      }
+      returnMarkup(returnTarget) {
+        return returnTarget ? { inline_keyboard: [[returnButton(returnTarget)]] } : void 0;
+      }
+      appendReturnButton(keyboard, returnTarget) {
+        if (returnTarget) keyboard.push([returnButton(returnTarget)]);
       }
       setupRoutes() {
         this.bot.on("message:text", async (ctx) => {
@@ -31405,7 +31485,9 @@ function registerCoreMenuItems(registry) {
     label: "\u{1F310} Proxy Routing",
     priority: 32,
     group: "config",
-    action: { type: "command", command: "/proxy" }
+    action: { type: "command", command: "/proxy" },
+    // Keep already-sent m:core:proxy buttons valid while nesting new entry points under Settings.
+    visible: () => false
   });
   registry.register({
     id: "core:restart",