@openacp/cli 0.5.0 → 0.5.1

package/dist/{chunk-FWN3UIRT.js → chunk-PHC67OP4.js}

@@ -1,19 +1,19 @@
+import {
+  DoctorEngine
+} from "./chunk-IRGYTNLP.js";
 import {
   buildMenuKeyboard,
   buildSkillMessages,
   handleClear,
   handleHelp,
   handleMenu
-} from "./chunk-UG6X672R.js";
+} from "./chunk-IURZ4QHG.js";
 import {
   AgentCatalog
-} from "./chunk-S3DRLJPM.js";
+} from "./chunk-5MH66WUY.js";
 import {
   getAgentCapabilities
-} from "./chunk-XJJ7LPXP.js";
-import {
-  DoctorEngine
-} from "./chunk-IRGYTNLP.js";
+} from "./chunk-GUHCS6X7.js";
 import {
   getConfigValue,
   getSafeFields,
@@ -3709,7 +3709,36 @@ Downloading... ${bar} ${percent}%`, { parse_mode: "HTML" });
       }
     }
   };
-  await catalog.install(nameOrId, progress);
+  const result = await catalog.install(nameOrId, progress);
+  if (result.ok) {
+    const { getAgentCapabilities: getAgentCapabilities2 } = await import("./agent-dependencies-FCLRGMZM.js");
+    const caps = getAgentCapabilities2(result.agentKey);
+    if (caps.integration) {
+      const { installIntegration } = await import("./integrate-X7LI6MUO.js");
+      const intResult = await installIntegration(result.agentKey, caps.integration);
+      if (intResult.success) {
+        try {
+          await ctx.reply(`\u{1F517} Handoff integration installed for <b>${escapeHtml(result.agentKey)}</b>`, { parse_mode: "HTML" });
+        } catch {
+        }
+      }
+    }
+  }
+  if (result.ok && result.setupSteps?.length) {
+    let setupText = `\u{1F4CB} <b>Setup for ${escapeHtml(result.agentKey)}:</b>
+
+`;
+    for (const step of result.setupSteps) {
+      setupText += `\u2192 ${escapeHtml(step)}
+`;
+    }
+    setupText += `
+<i>Run in terminal: openacp agents info ${escapeHtml(result.agentKey)}</i>`;
+    try {
+      await ctx.reply(setupText, { parse_mode: "HTML" });
+    } catch {
+    }
+  }
 }
 function truncate(text, maxLen) {
   if (text.length <= maxLen) return text;
@@ -3724,7 +3753,7 @@ function buildProgressBar(percent) {
 // src/adapters/telegram/commands/integrate.ts
 import { InlineKeyboard as InlineKeyboard5 } from "grammy";
 async function handleIntegrate(ctx, _core) {
-  const { listIntegrations } = await import("./integrate-WUPLRJD3.js");
+  const { listIntegrations } = await import("./integrate-X7LI6MUO.js");
   const agents = listIntegrations();
   const keyboard = new InlineKeyboard5();
   for (const agent of agents) {
@@ -3757,7 +3786,7 @@ function setupIntegrateCallbacks(bot, core) {
     } catch {
     }
     if (data === "i:back") {
-      const { listIntegrations } = await import("./integrate-WUPLRJD3.js");
+      const { listIntegrations } = await import("./integrate-X7LI6MUO.js");
       const agents = listIntegrations();
       const keyboard2 = new InlineKeyboard5();
       for (const agent of agents) {
@@ -3777,7 +3806,7 @@ Select an agent to manage its integrations.`,
     const agentMatch = data.match(/^i:agent:(.+)$/);
     if (agentMatch) {
       const agentName2 = agentMatch[1];
-      const { getIntegration: getIntegration2 } = await import("./integrate-WUPLRJD3.js");
+      const { getIntegration: getIntegration2 } = await import("./integrate-X7LI6MUO.js");
       const integration2 = getIntegration2(agentName2);
       if (!integration2) {
         await ctx.reply(`\u274C No integration available for '${escapeHtml(agentName2)}'.`, { parse_mode: "HTML" });
@@ -3804,7 +3833,7 @@ ${integration2.items.map((i) => `\u2022 <b>${escapeHtml(i.name)}</b> \u2014 ${es
     const action = actionMatch[1];
     const agentName = actionMatch[2];
     const itemId = actionMatch[3];
-    const { getIntegration } = await import("./integrate-WUPLRJD3.js");
+    const { getIntegration } = await import("./integrate-X7LI6MUO.js");
     const integration = getIntegration(agentName);
     if (!integration) return;
     const item = integration.items.find((i) => i.id === itemId);
@@ -3988,7 +4017,7 @@ Tap to change:`, {
       await ctx.answerCallbackQuery();
     } catch {
     }
-    const { buildMenuKeyboard: buildMenuKeyboard3 } = await import("./menu-6RCPBVGQ.js");
+    const { buildMenuKeyboard: buildMenuKeyboard3 } = await import("./menu-J5YVH665.js");
     try {
       await ctx.editMessageText(`<b>OpenACP Menu</b>
 Choose an action:`, {
@@ -4324,9 +4353,29 @@ A session = one conversation with one AI agent working in one project folder.
 Each session gets its own Telegram topic. Chat there to give instructions to the agent.
 
 ### Agents
-An agent is an AI coding tool (e.g., Claude Code). You can configure multiple agents.
+An agent is an AI coding tool (e.g., Claude Code, Gemini, Cursor, Codex, etc.).
+OpenACP supports 28+ agents from the official ACP Registry (agentclientprotocol.com).
+You can install multiple agents and choose which one to use per session.
 The default agent is used when you don't specify one.
 
+### Agent Management
+- Browse agents: \`/agents\` in Telegram or \`openacp agents\` in CLI
+- Install: tap the install button in /agents, or \`openacp agents install <name>\`
+- Uninstall: \`openacp agents uninstall <name>\`
+- Setup/login: \`openacp agents run <name> -- <args>\` (e.g., \`openacp agents run gemini -- auth login\`)
+- Details: \`openacp agents info <name>\` shows version, dependencies, and setup steps
+
+Some agents need additional setup before they can be used:
+- Claude: requires \`claude login\`
+- Gemini: requires \`openacp agents run gemini -- auth login\`
+- Codex: requires setting \`OPENAI_API_KEY\` environment variable
+- GitHub Copilot: requires \`openacp agents run copilot -- auth login\`
+
+Agents are installed in three ways depending on the agent:
+- **npx** \u2014 Node.js agents, downloaded automatically on first use
+- **uvx** \u2014 Python agents, downloaded automatically on first use
+- **binary** \u2014 Platform-specific binaries, downloaded to \`~/.openacp/agents/\`
+
 ### Project Folder (Workspace)
 The directory where the agent reads, writes, and runs code.
 When creating a session, you choose which folder the agent works in.
@@ -4459,7 +4508,8 @@ Just chat naturally: "How do I create a session?", "What's the status?", "Someth
 | \`/cancel\` | Session topic | Cancel current session |
 | \`/status\` | Anywhere | Show status |
 | \`/sessions\` | Anywhere | List all sessions |
-| \`/agents\` | Anywhere | List available agents |
+| \`/agents\` | Anywhere | Browse & install agents from ACP Registry |
+| \`/install <name>\` | Anywhere | Install an agent |
 | \`/enable_dangerous\` | Session topic | Auto-approve all permissions |
 | \`/disable_dangerous\` | Session topic | Restore permission prompts |
 | \`/handoff\` | Session topic | Transfer session to terminal |
@@ -4506,6 +4556,14 @@ Just chat naturally: "How do I create a session?", "What's the status?", "Someth
 - \`openacp config\` \u2014 Interactive config editor
 - \`openacp reset\` \u2014 Delete all data and start fresh
 
+### Agent Management (CLI)
+- \`openacp agents\` \u2014 List all agents (installed + available from ACP Registry)
+- \`openacp agents install <name>\` \u2014 Install an agent
+- \`openacp agents uninstall <name>\` \u2014 Remove an agent
+- \`openacp agents info <name>\` \u2014 Show details, dependencies, and setup guide
+- \`openacp agents run <name> [-- args]\` \u2014 Run agent CLI directly (for login, config, etc.)
+- \`openacp agents refresh\` \u2014 Force-refresh registry cache
+
 ### Plugins
 - \`openacp install <package>\` \u2014 Install adapter plugin (e.g., \`@openacp/adapter-discord\`)
 - \`openacp uninstall <package>\` \u2014 Remove adapter plugin
@@ -4564,10 +4622,10 @@ Config file: \`~/.openacp/config.json\`
 - **telegram.chatId** \u2014 Your Telegram supergroup ID
 
 ### Agents
-- **agents.<name>.command** \u2014 Agent executable path (e.g., \`claude\`, \`codex\`)
-- **agents.<name>.args** \u2014 Arguments to pass to the agent command
-- **agents.<name>.env** \u2014 Custom environment variables for the agent subprocess
 - **defaultAgent** \u2014 Which agent to use by default
+- Agents are managed via \`/agents\` (Telegram) or \`openacp agents\` (CLI)
+- Installed agents are stored in \`~/.openacp/agents.json\`
+- Agent list is fetched from the ACP Registry CDN and cached locally (24h)
 
 ### Workspace
 - **workspace.baseDir** \u2014 Base directory for project folders (default: \`~/openacp-workspace\`)
@@ -4619,9 +4677,10 @@ Override config with env vars:
 - Check system health: Assistant can run health check
 
 ### Agent not found
-- Check available agents: \`/agents\`
-- Verify agent command is installed and in PATH
-- Check config: agent command + args must be correct
+- Check available agents: \`/agents\` or \`openacp agents\`
+- Install missing agent: \`openacp agents install <name>\`
+- Some agents need login first: \`openacp agents info <name>\` to see setup steps
+- Run agent CLI for setup: \`openacp agents run <name> -- <args>\`
 
 ### Permission request not showing
 - Check Notifications topic for the alert
@@ -4652,6 +4711,9 @@ Override config with env vars:
 
 All data is stored in \`~/.openacp/\`:
 - \`config.json\` \u2014 Configuration
+- \`agents.json\` \u2014 Installed agents (managed by AgentCatalog)
+- \`registry-cache.json\` \u2014 Cached ACP Registry data (refreshes every 24h)
+- \`agents/\` \u2014 Downloaded binary agents
 - \`sessions/\` \u2014 Session records and state
 - \`topics/\` \u2014 Topic-to-session mappings
 - \`logs/\` \u2014 System and session logs
@@ -4683,11 +4745,16 @@ async function spawnAssistant(core, adapter, assistantTopicId) {
     statusCounts.set(r.status, (statusCounts.get(r.status) ?? 0) + 1);
   }
   const topicSummary = Array.from(statusCounts.entries()).map(([status, count]) => ({ status, count }));
+  const installedAgents = Object.keys(core.agentCatalog.getInstalledEntries());
+  const availableItems = core.agentCatalog.getAvailable();
+  const availableAgentCount = availableItems.filter((i) => !i.installed).length;
   const ctx = {
     config,
     activeSessionCount: activeCount,
     totalSessionCount: allRecords.length,
-    topicSummary
+    topicSummary,
+    installedAgents,
+    availableAgentCount
   };
   const systemPrompt = buildAssistantSystemPrompt(ctx);
   const ready = session.enqueuePrompt(systemPrompt).then(() => {
@@ -4719,15 +4786,16 @@ Agents: ${agentList}`;
 Agents: ${agentList}`;
 }
 function buildAssistantSystemPrompt(ctx) {
-  const { config, activeSessionCount, totalSessionCount, topicSummary } = ctx;
-  const agentNames = Object.keys(config.agents).join(", ");
+  const { config, activeSessionCount, totalSessionCount, topicSummary, installedAgents, availableAgentCount } = ctx;
+  const agentNames = installedAgents?.length ? installedAgents.join(", ") : Object.keys(config.agents).join(", ");
   const topicBreakdown = topicSummary.map((s) => `${s.status}: ${s.count}`).join(", ") || "none";
   return `You are the OpenACP Assistant \u2014 a helpful guide for managing AI coding sessions.
 
 ## Current State
 - Active sessions: ${activeSessionCount} / ${totalSessionCount} total
 - Topics by status: ${topicBreakdown}
-- Available agents: ${agentNames}
+- Installed agents: ${agentNames}
+- Available in ACP Registry: ${availableAgentCount ?? "28+"}  more agents (use /agents to browse)
 - Default agent: ${config.defaultAgent}
 - Workspace base directory: ${config.workspace.baseDir}
 
@@ -4735,11 +4803,22 @@ function buildAssistantSystemPrompt(ctx) {
 
 ### Create Session
 - The workspace is the project directory where the agent will work (read, write, execute code). It is NOT the base directory \u2014 it should be a specific project folder like \`~/code/my-project\` or \`${config.workspace.baseDir}/my-app\`.
-- Ask which agent to use (if multiple are configured). Show available: ${agentNames}
+- Ask which agent to use (if multiple are installed). Show installed: ${agentNames}
 - Ask which project directory to use as workspace. Suggest \`${config.workspace.baseDir}\` as the base, but explain the user can provide any path.
 - Confirm before creating: show agent name + full workspace path.
 - Create via: \`openacp api new <agent> <workspace>\`
 
+### Browse & Install Agents
+- Guide users to /agents command to see all available agents (installed + from ACP Registry)
+- The /agents list is paginated with install buttons \u2014 users can tap to install directly
+- For CLI users: \`openacp agents install <name>\`
+- Some agents need login/setup after install \u2014 guide users to \`openacp agents info <name>\` for setup steps
+- To run agent CLI for login: \`openacp agents run <name> -- <args>\`
+- Common setup examples:
+  - Gemini: \`openacp agents run gemini -- auth login\`
+  - GitHub Copilot: \`openacp agents run copilot -- auth login\`
+  - Codex: needs OPENAI_API_KEY environment variable
+
 ### Check Status / List Sessions
 - Run \`openacp api status\` for active sessions overview
 - Run \`openacp api topics\` for full list with statuses
@@ -4792,12 +4871,18 @@ openacp api delete-topic <id> --force    # Force delete active
 openacp api cleanup                      # Cleanup finished topics
 openacp api cleanup --status finished,error
 
+# Agent management (user-facing CLI commands)
+openacp agents                           # List installed + available agents
+openacp agents install <name>            # Install agent from ACP Registry
+openacp agents uninstall <name>          # Remove agent
+openacp agents info <name>               # Show details & setup guide
+openacp agents run <name> -- <args>      # Run agent CLI (for login, etc.)
+openacp agents refresh                   # Force-refresh registry
+
 # System
 openacp api health                       # System health
 openacp config                           # Edit config (interactive)
 openacp config set <key> <value>         # Update config value
-openacp api config                       # Show config (deprecated)
-openacp api config set <key> <value>     # Update config (deprecated)
 openacp api adapters                     # List adapters
 openacp api tunnel                       # Tunnel status
 openacp api notify "message"             # Send notification
@@ -5956,7 +6041,7 @@ var TelegramAdapter = class extends ChannelAdapter {
         });
         return;
       }
-      const { getAgentCapabilities: getAgentCapabilities2 } = await import("./agent-registry-B5YAMA4T.js");
+      const { getAgentCapabilities: getAgentCapabilities2 } = await import("./agent-registry-KZANAFXQ.js");
       const caps = getAgentCapabilities2(agentName);
       if (!caps.supportsResume || !caps.resumeCommand) {
         await ctx.reply("This agent does not support session transfer.", {
@@ -6332,4 +6417,4 @@ export {
   TopicManager,
   TelegramAdapter
 };
-//# sourceMappingURL=chunk-FWN3UIRT.js.map
+//# sourceMappingURL=chunk-PHC67OP4.js.map