@openacp/cli 0.5.0 → 0.5.1

package/README.md

@@ -12,7 +12,7 @@ One message, any channel, any agent.
 [![npm](https://img.shields.io/npm/v/@openacp/cli.svg)](https://www.npmjs.com/package/@openacp/cli)
 [![Twitter Follow](https://img.shields.io/twitter/follow/Open_ACP?style=social)](https://x.com/Open_ACP)
 
-[Getting Started](docs/guide/getting-started.md) | [Usage](docs/guide/usage.md) | [Configuration](docs/guide/configuration.md) | [Tunnel](docs/guide/tunnel.md) | [Plugins](docs/guide/plugins.md) | [Development](docs/guide/development.md)
+[Getting Started](docs/guide/getting-started.md) | [Agents](docs/guide/agents.md) | [Usage](docs/guide/usage.md) | [Configuration](docs/guide/configuration.md) | [Tunnel](docs/guide/tunnel.md) | [Plugins](docs/guide/plugins.md) | [Development](docs/guide/development.md)
 
 </div>
 

package/dist/{agent-catalog-4IAJ7HEG.js → agent-catalog-LAAVBVLY.js}

@@ -1,10 +1,10 @@
 import {
   AgentCatalog
-} from "./chunk-S3DRLJPM.js";
+} from "./chunk-5MH66WUY.js";
 import "./chunk-5HGXUCMX.js";
-import "./chunk-XJJ7LPXP.js";
+import "./chunk-GUHCS6X7.js";
 import "./chunk-ESOPMQAY.js";
 export {
   AgentCatalog
 };
-//# sourceMappingURL=agent-catalog-4IAJ7HEG.js.map
+//# sourceMappingURL=agent-catalog-LAAVBVLY.js.map

package/dist/agent-dependencies-FCLRGMZM.js

@@ -0,0 +1,23 @@
+import {
+  REGISTRY_AGENT_ALIASES,
+  checkDependencies,
+  checkRuntimeAvailable,
+  commandExists,
+  getAgentAlias,
+  getAgentCapabilities,
+  getAgentDependencies,
+  getAgentSetup,
+  listAgentsWithIntegration
+} from "./chunk-GUHCS6X7.js";
+export {
+  REGISTRY_AGENT_ALIASES,
+  checkDependencies,
+  checkRuntimeAvailable,
+  commandExists,
+  getAgentAlias,
+  getAgentCapabilities,
+  getAgentDependencies,
+  getAgentSetup,
+  listAgentsWithIntegration
+};
+//# sourceMappingURL=agent-dependencies-FCLRGMZM.js.map

package/dist/{agent-registry-B5YAMA4T.js → agent-registry-KZANAFXQ.js}

@@ -1,8 +1,8 @@
 import "./chunk-NAMYZIS5.js";
 import {
   getAgentCapabilities
-} from "./chunk-XJJ7LPXP.js";
+} from "./chunk-GUHCS6X7.js";
 export {
   getAgentCapabilities
 };
-//# sourceMappingURL=agent-registry-B5YAMA4T.js.map
+//# sourceMappingURL=agent-registry-KZANAFXQ.js.map

package/dist/{chunk-S3DRLJPM.js → chunk-5MH66WUY.js}

@@ -4,8 +4,9 @@ import {
 import {
   checkDependencies,
   checkRuntimeAvailable,
-  getAgentAlias
-} from "./chunk-XJJ7LPXP.js";
+  getAgentAlias,
+  getAgentSetup
+} from "./chunk-GUHCS6X7.js";
 import {
   createChildLogger
 } from "./chunk-ESOPMQAY.js";
@@ -130,8 +131,9 @@ Install it with: pip install uv`;
   }
   const installed = buildInstalledAgent(agent.id, agent.name, agent.version, dist, binaryPath);
   store.addAgent(agentKey, installed);
+  const setup = getAgentSetup(agent.id);
   await progress?.onSuccess(agent.name);
-  return { ok: true, agentKey };
+  return { ok: true, agentKey, setupSteps: setup?.setupSteps };
 }
 async function downloadAndExtract(agentId, archiveUrl, progress) {
   const destDir = path.join(AGENTS_DIR, agentId);
@@ -419,4 +421,4 @@ var AgentCatalog = class {
 export {
   AgentCatalog
 };
-//# sourceMappingURL=chunk-S3DRLJPM.js.map
+//# sourceMappingURL=chunk-5MH66WUY.js.map

package/dist/chunk-5MH66WUY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/agent-catalog.ts","../../src/core/agent-installer.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport * as os from \"node:os\";\nimport { AgentStore } from \"./agent-store.js\";\nimport { installAgent, uninstallAgent, resolveDistribution } from \"./agent-installer.js\";\nimport { getAgentAlias, checkDependencies } from \"./agent-dependencies.js\";\nimport type {\n  AgentDefinition,\n  RegistryAgent,\n  AgentListItem,\n  AvailabilityResult,\n  InstallProgress,\n  InstallResult,\n  InstalledAgent,\n} from \"./types.js\";\nimport { createChildLogger } from \"./log.js\";\n\nconst log = createChildLogger({ module: \"agent-catalog\" });\n\nconst REGISTRY_URL = \"https://cdn.agentclientprotocol.com/registry/v1/latest/registry.json\";\nconst CACHE_PATH = path.join(os.homedir(), \".openacp\", \"registry-cache.json\");\nconst DEFAULT_TTL_HOURS = 24;\n\ninterface RegistryCache {\n  fetchedAt: string;\n  ttlHours: number;\n  data: { agents: RegistryAgent[] };\n}\n\nexport class AgentCatalog {\n  private store: AgentStore;\n  private registryAgents: RegistryAgent[] = [];\n\n  constructor(store?: AgentStore) {\n    this.store = store ?? new AgentStore();\n  }\n\n  load(): void {\n    this.store.load();\n    this.loadRegistryFromCacheOrSnapshot();\n  }\n\n  // --- Registry ---\n\n  async fetchRegistry(): Promise<void> {\n    try {\n      log.info(\"Fetching agent registry from CDN...\");\n      const response = await fetch(REGISTRY_URL);\n      if (!response.ok) throw new Error(`HTTP ${response.status}`);\n      const data = await response.json() as { agents: RegistryAgent[] };\n      this.registryAgents = data.agents ?? [];\n\n      const cache: RegistryCache = {\n        fetchedAt: new Date().toISOString(),\n        ttlHours: DEFAULT_TTL_HOURS,\n        data,\n      };\n      fs.mkdirSync(path.dirname(CACHE_PATH), { recursive: true });\n      fs.writeFileSync(CACHE_PATH, JSON.stringify(cache, null, 2));\n      log.info({ count: this.registryAgents.length }, \"Registry updated\");\n    } catch (err) {\n      log.warn({ err }, \"Failed to fetch registry, using cached data\");\n    }\n  }\n\n  async refreshRegistryIfStale(): Promise<void> {\n    if (this.isCacheStale()) {\n      await this.fetchRegistry();\n    }\n  }\n\n  getRegistryAgents(): RegistryAgent[] {\n    return this.registryAgents;\n  }\n\n  getRegistryAgent(registryId: string): RegistryAgent | undefined {\n    return this.registryAgents.find((a) => a.id === registryId);\n  }\n\n  findRegistryAgent(keyOrId: string): RegistryAgent | undefined {\n    const byId = this.registryAgents.find((a) => a.id === keyOrId);\n    if (byId) return byId;\n    return this.registryAgents.find((a) => getAgentAlias(a.id) === keyOrId);\n  }\n\n  // --- Installed ---\n\n  getInstalled(): InstalledAgent[] {\n    return Object.values(this.store.getInstalled());\n  }\n\n  getInstalledEntries(): Record<string, InstalledAgent> {\n    return this.store.getInstalled();\n  }\n\n  getInstalledAgent(key: string): InstalledAgent | undefined {\n    return this.store.getAgent(key);\n  }\n\n  // --- Discovery ---\n\n  getAvailable(): AgentListItem[] {\n    const installed = this.store.getInstalled();\n    const items: AgentListItem[] = [];\n    const seenKeys = new Set<string>();\n\n    for (const [key, agent] of Object.entries(installed)) {\n      seenKeys.add(key);\n      const availability = agent.registryId\n        ? checkDependencies(agent.registryId)\n        : { available: true };\n      const registryEntry = agent.registryId\n        ? this.registryAgents.find((a) => a.id === agent.registryId)\n        : undefined;\n      items.push({\n        key,\n        registryId: agent.registryId ?? key,\n        name: agent.name,\n        version: agent.version,\n        description: registryEntry?.description,\n        distribution: agent.distribution,\n        installed: true,\n        available: availability.available,\n        missingDeps: availability.missing?.map((m) => m.label),\n      });\n    }\n\n    for (const agent of this.registryAgents) {\n      const alias = getAgentAlias(agent.id);\n      if (seenKeys.has(alias)) continue;\n      seenKeys.add(alias);\n\n      const dist = resolveDistribution(agent);\n      const availability = checkDependencies(agent.id);\n\n      items.push({\n        key: alias,\n        registryId: agent.id,\n        name: agent.name,\n        version: agent.version,\n        description: agent.description,\n        distribution: dist?.type ?? \"binary\",\n        installed: false,\n        available: dist !== null && availability.available,\n        missingDeps: availability.missing?.map((m) => m.label),\n      });\n    }\n\n    return items;\n  }\n\n  checkAvailability(keyOrId: string): AvailabilityResult {\n    const agent = this.findRegistryAgent(keyOrId);\n    if (!agent) return { available: false, reason: \"Not found in the agent registry.\" };\n\n    const dist = resolveDistribution(agent);\n    if (!dist) {\n      return { available: false, reason: `Not available for your system. Check ${agent.website ?? agent.repository ?? \"their website\"} for other options.` };\n    }\n\n    return checkDependencies(agent.id);\n  }\n\n  // --- Install/Uninstall ---\n\n  async install(keyOrId: string, progress?: InstallProgress, force?: boolean): Promise<InstallResult> {\n    const agent = this.findRegistryAgent(keyOrId);\n    if (!agent) {\n      const msg = `\"${keyOrId}\" was not found in the agent registry. Run \"openacp agents\" to see what's available.`;\n      await progress?.onError(msg);\n      return { ok: false, agentKey: keyOrId, error: msg };\n    }\n\n    const agentKey = getAgentAlias(agent.id);\n    if (this.store.hasAgent(agentKey) && !force) {\n      const existing = this.store.getAgent(agentKey)!;\n      const msg = `${agent.name} is already installed (v${existing.version}). Use --force to reinstall.`;\n      await progress?.onError(msg);\n      return { ok: false, agentKey, error: msg };\n    }\n\n    return installAgent(agent, this.store, progress);\n  }\n\n  async uninstall(key: string): Promise<{ ok: boolean; error?: string }> {\n    if (!this.store.hasAgent(key)) {\n      return { ok: false, error: `\"${key}\" is not installed.` };\n    }\n    await uninstallAgent(key, this.store);\n    return { ok: true };\n  }\n\n  // --- Resolution (for AgentManager) ---\n\n  resolve(key: string): AgentDefinition | undefined {\n    const agent = this.store.getAgent(key);\n    if (!agent) return undefined;\n    return {\n      name: key,\n      command: agent.command,\n      args: agent.args,\n      workingDirectory: agent.workingDirectory,\n      env: agent.env,\n    };\n  }\n\n  // --- Internal ---\n\n  private isCacheStale(): boolean {\n    if (!fs.existsSync(CACHE_PATH)) return true;\n    try {\n      const raw = JSON.parse(fs.readFileSync(CACHE_PATH, \"utf-8\") as string) as RegistryCache;\n      const fetchedAt = new Date(raw.fetchedAt).getTime();\n      const ttlMs = (raw.ttlHours ?? DEFAULT_TTL_HOURS) * 60 * 60 * 1000;\n      return Date.now() - fetchedAt > ttlMs;\n    } catch {\n      return true;\n    }\n  }\n\n  private loadRegistryFromCacheOrSnapshot(): void {\n    // Try cache first\n    if (fs.existsSync(CACHE_PATH)) {\n      try {\n        const raw = JSON.parse(fs.readFileSync(CACHE_PATH, \"utf-8\") as string) as RegistryCache;\n        if (raw.data?.agents) {\n          this.registryAgents = raw.data.agents;\n          log.debug({ count: this.registryAgents.length }, \"Loaded registry from cache\");\n          return;\n        }\n      } catch {\n        log.warn(\"Failed to load registry cache\");\n      }\n    }\n\n    // Fallback: bundled snapshot\n    try {\n      // Try multiple paths for tsc and tsup builds\n      const candidates = [\n        path.join(import.meta.dirname, \"data\", \"registry-snapshot.json\"),\n        path.join(import.meta.dirname, \"..\", \"data\", \"registry-snapshot.json\"),\n        path.join(import.meta.dirname, \"..\", \"..\", \"data\", \"registry-snapshot.json\"),\n      ];\n\n      for (const candidate of candidates) {\n        if (fs.existsSync(candidate)) {\n          const raw = JSON.parse(fs.readFileSync(candidate, \"utf-8\") as string);\n          this.registryAgents = raw.agents ?? [];\n          log.debug({ count: this.registryAgents.length }, \"Loaded registry from bundled snapshot\");\n          return;\n        }\n      }\n\n      log.warn(\"No registry data available (no cache, no snapshot)\");\n    } catch {\n      log.warn(\"Failed to load bundled registry snapshot\");\n    }\n  }\n}\n","import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport * as os from \"node:os\";\nimport { createChildLogger } from \"./log.js\";\nimport type { InstalledAgent, RegistryAgent, InstallProgress, InstallResult } from \"./types.js\";\nimport { getAgentAlias, checkDependencies, checkRuntimeAvailable, getAgentSetup } from \"./agent-dependencies.js\";\nimport { AgentStore } from \"./agent-store.js\";\n\nconst log = createChildLogger({ module: \"agent-installer\" });\n\nconst AGENTS_DIR = path.join(os.homedir(), \".openacp\", \"agents\");\n\nconst ARCH_MAP: Record<string, string> = {\n  arm64: \"aarch64\",\n  x64: \"x86_64\",\n};\n\nconst PLATFORM_MAP: Record<string, string> = {\n  darwin: \"darwin\",\n  linux: \"linux\",\n  win32: \"windows\",\n};\n\nexport function getPlatformKey(): string {\n  const platform = PLATFORM_MAP[process.platform] ?? process.platform;\n  const arch = ARCH_MAP[process.arch] ?? process.arch;\n  return `${platform}-${arch}`;\n}\n\nexport type ResolvedDistribution =\n  | { type: \"npx\"; package: string; args: string[]; env?: Record<string, string> }\n  | { type: \"uvx\"; package: string; args: string[]; env?: Record<string, string> }\n  | { type: \"binary\"; archive: string; cmd: string; args: string[]; env?: Record<string, string> };\n\nexport function resolveDistribution(agent: RegistryAgent): ResolvedDistribution | null {\n  const dist = agent.distribution;\n\n  if (dist.npx) {\n    return { type: \"npx\", package: dist.npx.package, args: dist.npx.args ?? [], env: dist.npx.env };\n  }\n  if (dist.uvx) {\n    return { type: \"uvx\", package: dist.uvx.package, args: dist.uvx.args ?? [], env: dist.uvx.env };\n  }\n  if (dist.binary) {\n    const platformKey = getPlatformKey();\n    const target = dist.binary[platformKey];\n    if (!target) return null;\n    return { type: \"binary\", archive: target.archive, cmd: target.cmd, args: target.args ?? [], env: target.env };\n  }\n  return null;\n}\n\nexport function buildInstalledAgent(\n  registryId: string,\n  name: string,\n  version: string,\n  dist: ResolvedDistribution,\n  binaryPath?: string,\n): InstalledAgent {\n  if (dist.type === \"npx\") {\n    return {\n      registryId, name, version, distribution: \"npx\",\n      command: \"npx\", args: [dist.package, ...dist.args],\n      env: dist.env ?? {}, installedAt: new Date().toISOString(), binaryPath: null,\n    };\n  }\n  if (dist.type === \"uvx\") {\n    return {\n      registryId, name, version, distribution: \"uvx\",\n      command: \"uvx\", args: [dist.package, ...dist.args],\n      env: dist.env ?? {}, installedAt: new Date().toISOString(), binaryPath: null,\n    };\n  }\n  // binary\n  const absCmd = path.resolve(binaryPath!, dist.cmd);\n  return {\n    registryId, name, version, distribution: \"binary\",\n    command: absCmd, args: dist.args,\n    env: dist.env ?? {}, installedAt: new Date().toISOString(), binaryPath: binaryPath!,\n  };\n}\n\nexport async function installAgent(\n  agent: RegistryAgent,\n  store: AgentStore,\n  progress?: InstallProgress,\n): Promise<InstallResult> {\n  const agentKey = getAgentAlias(agent.id);\n  await progress?.onStart(agent.id, agent.name);\n\n  // 1. Check dependencies\n  await progress?.onStep(\"Checking requirements...\");\n  const depResult = checkDependencies(agent.id);\n  if (!depResult.available) {\n    const hints = depResult.missing!.map((m) => `  ${m.label}: ${m.installHint}`).join(\"\\n\");\n    const msg = `${agent.name} needs some tools installed first:\\n${hints}`;\n    await progress?.onError(msg);\n    return { ok: false, agentKey, error: msg };\n  }\n\n  // 2. Resolve distribution\n  const dist = resolveDistribution(agent);\n  if (!dist) {\n    const platformKey = getPlatformKey();\n    const msg = `${agent.name} is not available for your system (${platformKey}). Check their website for other install options.`;\n    await progress?.onError(msg);\n    return { ok: false, agentKey, error: msg };\n  }\n\n  // 3. Check runtime\n  if (dist.type === \"uvx\" && !checkRuntimeAvailable(\"uvx\")) {\n    const msg = `${agent.name} requires Python's uvx tool.\\nInstall it with: pip install uv`;\n    await progress?.onError(msg, \"pip install uv\");\n    return { ok: false, agentKey, error: msg, hint: \"pip install uv\" };\n  }\n\n  // 4. Install based on type\n  let binaryPath: string | undefined;\n\n  if (dist.type === \"binary\") {\n    try {\n      binaryPath = await downloadAndExtract(agent.id, dist.archive, progress);\n    } catch (err) {\n      const msg = `Failed to download ${agent.name}. Please try again or install manually.`;\n      await progress?.onError(msg);\n      return { ok: false, agentKey, error: msg };\n    }\n  } else {\n    await progress?.onStep(\"Setting up... (will download on first use)\");\n  }\n\n  // 5. Save to store\n  const installed = buildInstalledAgent(agent.id, agent.name, agent.version, dist, binaryPath);\n  store.addAgent(agentKey, installed);\n\n  const setup = getAgentSetup(agent.id);\n  await progress?.onSuccess(agent.name);\n  return { ok: true, agentKey, setupSteps: setup?.setupSteps };\n}\n\nasync function downloadAndExtract(\n  agentId: string,\n  archiveUrl: string,\n  progress?: InstallProgress,\n): Promise<string> {\n  const destDir = path.join(AGENTS_DIR, agentId);\n  fs.mkdirSync(destDir, { recursive: true });\n\n  await progress?.onStep(\"Downloading...\");\n  log.info({ agentId, url: archiveUrl }, \"Downloading agent binary\");\n\n  const response = await fetch(archiveUrl);\n  if (!response.ok) {\n    throw new Error(`Download failed: ${response.status} ${response.statusText}`);\n  }\n\n  const contentLength = Number(response.headers.get(\"content-length\") || 0);\n  const buffer = await readResponseWithProgress(response, contentLength, progress);\n\n  await progress?.onStep(\"Extracting...\");\n\n  if (archiveUrl.endsWith(\".zip\")) {\n    await extractZip(buffer, destDir);\n  } else {\n    await extractTarGz(buffer, destDir);\n  }\n\n  await progress?.onStep(\"Ready!\");\n  return destDir;\n}\n\nasync function readResponseWithProgress(\n  response: Response,\n  contentLength: number,\n  progress?: InstallProgress,\n): Promise<Buffer> {\n  if (!response.body || contentLength === 0) {\n    const arrayBuffer = await response.arrayBuffer();\n    return Buffer.from(arrayBuffer);\n  }\n\n  const reader = response.body.getReader();\n  const chunks: Uint8Array[] = [];\n  let received = 0;\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    chunks.push(value);\n    received += value.length;\n    if (contentLength > 0) {\n      await progress?.onDownloadProgress(Math.round((received / contentLength) * 100));\n    }\n  }\n\n  return Buffer.concat(chunks);\n}\n\nfunction validateExtractedPaths(destDir: string): void {\n  const realDest = fs.realpathSync(destDir);\n  const entries = fs.readdirSync(destDir, { recursive: true, withFileTypes: true });\n  for (const entry of entries) {\n    const parentPath = (entry as unknown as { parentPath?: string; path?: string }).parentPath ?? (entry as unknown as { path: string }).path;\n    const fullPath = path.join(parentPath, entry.name);\n    let realPath: string;\n    try {\n      realPath = fs.realpathSync(fullPath);\n    } catch {\n      // Broken symlink — check where it points\n      const linkTarget = fs.readlinkSync(fullPath);\n      realPath = path.resolve(path.dirname(fullPath), linkTarget);\n    }\n    if (!realPath.startsWith(realDest + path.sep) && realPath !== realDest) {\n      fs.rmSync(destDir, { recursive: true, force: true });\n      throw new Error(`Archive contains unsafe path: ${entry.name}`);\n    }\n  }\n}\n\nasync function extractTarGz(buffer: Buffer, destDir: string): Promise<void> {\n  const { execFileSync } = await import(\"node:child_process\");\n  const tmpFile = path.join(destDir, \"_archive.tar.gz\");\n  fs.writeFileSync(tmpFile, buffer);\n  try {\n    execFileSync(\"tar\", [\"xzf\", tmpFile, \"-C\", destDir], { stdio: \"pipe\" });\n  } finally {\n    fs.unlinkSync(tmpFile);\n  }\n  validateExtractedPaths(destDir);\n}\n\nasync function extractZip(buffer: Buffer, destDir: string): Promise<void> {\n  const { execFileSync } = await import(\"node:child_process\");\n  const tmpFile = path.join(destDir, \"_archive.zip\");\n  fs.writeFileSync(tmpFile, buffer);\n  try {\n    execFileSync(\"unzip\", [\"-o\", tmpFile, \"-d\", destDir], { stdio: \"pipe\" });\n  } finally {\n    fs.unlinkSync(tmpFile);\n  }\n  validateExtractedPaths(destDir);\n}\n\nexport async function uninstallAgent(\n  agentKey: string,\n  store: AgentStore,\n): Promise<void> {\n  const agent = store.getAgent(agentKey);\n  if (!agent) return;\n\n  if (agent.binaryPath && fs.existsSync(agent.binaryPath)) {\n    fs.rmSync(agent.binaryPath, { recursive: true, force: true });\n    log.info({ agentKey, binaryPath: agent.binaryPath }, \"Deleted agent binary\");\n  }\n\n  store.removeAgent(agentKey);\n}\n"],"mappings":"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","names":["fs","path","os","log"]}

package/dist/{chunk-LAFKARV3.js → chunk-776VAU3T.js}

@@ -7,7 +7,7 @@ import {
 import {
   validateBotToken,
   validateChatId
-} from "./chunk-D73LCTPF.js";
+} from "./chunk-QODDJ4PH.js";
 import {
   expandHome
 } from "./chunk-JRF4G4X7.js";
@@ -561,4 +561,4 @@ function flattenToPaths(obj, prefix = "") {
 export {
   runConfigEditor
 };
-//# sourceMappingURL=chunk-LAFKARV3.js.map
+//# sourceMappingURL=chunk-776VAU3T.js.map

package/dist/chunk-GUHCS6X7.js

@@ -0,0 +1,282 @@
+// src/core/agent-dependencies.ts
+import { execFileSync } from "child_process";
+import * as fs from "fs";
+import * as path from "path";
+var AGENT_DEPENDENCIES = {
+  "claude-acp": [
+    {
+      command: "claude",
+      label: "Claude CLI",
+      installHint: "npm install -g @anthropic-ai/claude-code"
+    }
+  ],
+  "codex-acp": [
+    {
+      command: "codex",
+      label: "Codex CLI",
+      installHint: "npm install -g @openai/codex"
+    }
+  ]
+};
+var AGENT_SETUP = {
+  // --- Agents requiring their own CLI installed first ---
+  "claude-acp": {
+    setupSteps: [
+      "Install Claude CLI: npm install -g @anthropic-ai/claude-code",
+      "Login: claude login (opens browser for Anthropic account)"
+    ],
+    loginCommand: "claude login"
+  },
+  "codex-acp": {
+    setupSteps: [
+      "Install Codex CLI: npm install -g @openai/codex",
+      "Login: codex (select 'Sign in with ChatGPT')",
+      "Or set API key: export OPENAI_API_KEY=<your-key>"
+    ],
+    loginCommand: "codex"
+  },
+  // --- Agents with built-in auth (npx handles download) ---
+  "gemini": {
+    setupSteps: [
+      "Login with Google: openacp agents run gemini (select 'Sign in with Google')",
+      "Or set API key: export GEMINI_API_KEY=<key> (get from aistudio.google.com/apikey)",
+      "Free tier: 60 requests/min, 1000 requests/day"
+    ],
+    loginCommand: "openacp agents run gemini"
+  },
+  "github-copilot-cli": {
+    setupSteps: [
+      "Requires active GitHub Copilot subscription",
+      "Login: openacp agents run copilot (use /login command inside CLI)",
+      "Or set token: export GITHUB_TOKEN=<personal-access-token>"
+    ],
+    loginCommand: "openacp agents run copilot"
+  },
+  "cline": {
+    setupSteps: [
+      "Login: openacp agents run cline -- auth (guided API key setup)",
+      "Supports: Anthropic, OpenAI, Gemini, AWS Bedrock, Azure, Ollama, and more",
+      "Or set env: export ANTHROPIC_API_KEY=<key> (or OPENAI_API_KEY, etc.)"
+    ],
+    loginCommand: "openacp agents run cline -- auth"
+  },
+  "auggie": {
+    setupSteps: [
+      "Login: openacp agents run auggie -- login (opens browser for Augment account)"
+    ],
+    loginCommand: "openacp agents run auggie -- login"
+  },
+  "qwen-code": {
+    setupSteps: [
+      "Login: openacp agents run qwen (use /auth command, select 'Qwen OAuth')",
+      "Free: 1000 requests/day with Qwen OAuth",
+      "Or set API key: export OPENAI_API_KEY=<key> in ~/.qwen/settings.json"
+    ],
+    loginCommand: "openacp agents run qwen"
+  },
+  // --- Agents requiring API keys via env vars ---
+  "kimi": {
+    setupSteps: [
+      "Login: openacp agents run kimi (use /login command inside CLI)",
+      "Recommended: select 'Kimi Code' for browser-based OAuth",
+      "Or select another provider and enter API key manually"
+    ],
+    loginCommand: "openacp agents run kimi"
+  },
+  "cursor": {
+    setupSteps: [
+      "Requires active Cursor subscription",
+      "Login: openacp agents run cursor (opens browser for Cursor account)"
+    ],
+    loginCommand: "openacp agents run cursor"
+  },
+  // --- Agents with provider selection on first run ---
+  "goose": {
+    setupSteps: [
+      "First run auto-enters setup mode \u2014 choose your LLM provider",
+      "Options: OpenAI, Anthropic, Google Gemini, OpenRouter, or local models",
+      "Set provider API key: export OPENAI_API_KEY=<key> (or other provider)",
+      "Reconfigure anytime: goose configure"
+    ]
+  },
+  "junie": {
+    setupSteps: [
+      "Bring Your Own Key (BYOK) \u2014 provide API key from any supported provider",
+      "Supports: OpenAI, Anthropic, Gemini, xAI, OpenRouter",
+      "Free tier: up to $50 with Gemini 3 Flash included",
+      "Set key via env or first-run setup prompt"
+    ]
+  },
+  "kilo": {
+    setupSteps: [
+      "Options: bring your own API keys (Anthropic, OpenAI, Google) or use Kilo Gateway",
+      "Kilo Gateway: pay-as-you-go, includes free models \u2014 no API key needed",
+      "BYOK: set provider key, e.g. export ANTHROPIC_API_KEY=<key>"
+    ]
+  },
+  "mistral-vibe": {
+    setupSteps: [
+      "Get API key from console.mistral.ai/codestral/cli",
+      "Or sign up for Free/Pro/Team plan at mistral.ai",
+      "Set key when prompted on first run"
+    ]
+  },
+  "deepagents": {
+    setupSteps: [
+      "Powered by LangChain \u2014 set your LLM provider API key",
+      "Example: export OPENAI_API_KEY=<key> or export ANTHROPIC_API_KEY=<key>"
+    ]
+  },
+  // --- Agents that work out of the box (no setup / minimal setup) ---
+  "crow-cli": {
+    setupSteps: [
+      "Requires uvx (Python package runner): pip install uv",
+      "Bring your own API key for your chosen LLM provider"
+    ]
+  },
+  "fast-agent": {
+    setupSteps: [
+      "Requires uvx (Python package runner): pip install uv",
+      "Configure LLM provider in agent config file"
+    ]
+  }
+};
+function getAgentSetup(registryId) {
+  return AGENT_SETUP[registryId];
+}
+var AGENT_CAPABILITIES = {
+  claude: {
+    supportsResume: true,
+    resumeCommand: (sid) => `claude --resume ${sid}`,
+    integration: {
+      hookEvent: "UserPromptSubmit",
+      settingsPath: "~/.claude/settings.json",
+      settingsFormat: "settings_json",
+      hooksDirPath: "~/.claude/hooks/",
+      outputFormat: "plaintext",
+      sessionIdField: ".session_id",
+      commandsPath: "~/.claude/commands/",
+      handoffCommandName: "openacp:handoff",
+      commandFormat: "markdown",
+      sessionIdVar: "CLAUDE_SESSION_ID",
+      workingDirVar: "CLAUDE_WORKING_DIR"
+    }
+  },
+  cursor: {
+    supportsResume: true,
+    resumeCommand: (sid) => `cursor --resume ${sid}`,
+    integration: {
+      hookEvent: "beforeSubmitPrompt",
+      settingsPath: "~/.cursor/hooks.json",
+      settingsFormat: "hooks_json",
+      hooksDirPath: "~/.cursor/hooks/",
+      outputFormat: "json",
+      sessionIdField: ".conversation_id",
+      commandsPath: "~/.cursor/skills/",
+      handoffCommandName: "openacp-handoff",
+      commandFormat: "skill"
+    }
+  },
+  gemini: {
+    supportsResume: true,
+    resumeCommand: (sid) => `gemini --resume ${sid}`,
+    integration: {
+      hookEvent: "BeforeAgent",
+      settingsPath: "~/.gemini/settings.json",
+      settingsFormat: "settings_json",
+      hooksDirPath: "~/.gemini/hooks/",
+      outputFormat: "json",
+      sessionIdField: ".session_id"
+    }
+  },
+  cline: {
+    supportsResume: true,
+    resumeCommand: () => `cline --continue`,
+    integration: {
+      hookEvent: "TaskStart",
+      settingsPath: "~/.cline/settings.json",
+      settingsFormat: "settings_json",
+      hooksDirPath: "~/.cline/hooks/",
+      outputFormat: "json",
+      sessionIdField: ".session_id"
+    }
+  },
+  codex: {
+    supportsResume: true,
+    resumeCommand: (sid) => `codex resume ${sid}`
+  },
+  kilo: {
+    supportsResume: true,
+    resumeCommand: () => `kilo --continue`
+  },
+  amp: {
+    supportsResume: true,
+    resumeCommand: (sid) => `amp threads continue ${sid}`
+  }
+};
+var REGISTRY_AGENT_ALIASES = {
+  "claude-acp": "claude",
+  "codex-acp": "codex",
+  "gemini": "gemini",
+  "cursor": "cursor",
+  "github-copilot-cli": "copilot",
+  "cline": "cline",
+  "goose": "goose",
+  "kilo": "kilo",
+  "qwen-code": "qwen"
+};
+function getAgentAlias(registryId) {
+  return REGISTRY_AGENT_ALIASES[registryId] ?? registryId;
+}
+function getAgentDependencies(registryId) {
+  return AGENT_DEPENDENCIES[registryId] ?? [];
+}
+function getAgentCapabilities(agentName) {
+  return AGENT_CAPABILITIES[agentName] ?? { supportsResume: false };
+}
+function listAgentsWithIntegration() {
+  return Object.entries(AGENT_CAPABILITIES).filter(([, cap]) => cap.integration != null).map(([key]) => key);
+}
+function commandExists(cmd) {
+  try {
+    execFileSync("which", [cmd], { stdio: "pipe" });
+    return true;
+  } catch {
+  }
+  let dir = process.cwd();
+  while (true) {
+    const binPath = path.join(dir, "node_modules", ".bin", cmd);
+    if (fs.existsSync(binPath)) return true;
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return false;
+}
+function checkDependencies(registryId) {
+  const deps = getAgentDependencies(registryId);
+  if (deps.length === 0) return { available: true };
+  const missing = deps.filter((d) => !commandExists(d.command));
+  if (missing.length === 0) return { available: true };
+  return {
+    available: false,
+    reason: `Requires: ${missing.map((m) => m.label).join(", ")}`,
+    missing: missing.map((m) => ({ label: m.label, installHint: m.installHint }))
+  };
+}
+function checkRuntimeAvailable(runtime) {
+  return commandExists(runtime);
+}
+
+export {
+  getAgentSetup,
+  REGISTRY_AGENT_ALIASES,
+  getAgentAlias,
+  getAgentDependencies,
+  getAgentCapabilities,
+  listAgentsWithIntegration,
+  commandExists,
+  checkDependencies,
+  checkRuntimeAvailable
+};
+//# sourceMappingURL=chunk-GUHCS6X7.js.map

package/dist/chunk-GUHCS6X7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/agent-dependencies.ts"],"sourcesContent":["import { execFileSync } from \"node:child_process\";\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { AvailabilityResult } from \"./types.js\";\n\nexport interface AgentDependency {\n  command: string;\n  label: string;\n  installHint: string;\n}\n\nexport interface AgentSetupInfo {\n  setupSteps: string[];\n  loginCommand?: string;\n}\n\nexport interface AgentIntegrationSpec {\n  hookEvent: string;\n  settingsPath: string;\n  settingsFormat: \"settings_json\" | \"hooks_json\";\n  hooksDirPath: string;\n  outputFormat: \"plaintext\" | \"json\";\n  sessionIdField: string;\n  commandsPath?: string;\n  handoffCommandName?: string;\n  commandFormat?: \"markdown\" | \"skill\";\n  sessionIdVar?: string;\n  workingDirVar?: string;\n}\n\nexport interface AgentCapability {\n  supportsResume: boolean;\n  resumeCommand?: (sessionId: string) => string;\n  integration?: AgentIntegrationSpec;\n}\n\nconst AGENT_DEPENDENCIES: Record<string, AgentDependency[]> = {\n  \"claude-acp\": [\n    {\n      command: \"claude\",\n      label: \"Claude CLI\",\n      installHint: \"npm install -g @anthropic-ai/claude-code\",\n    },\n  ],\n  \"codex-acp\": [\n    {\n      command: \"codex\",\n      label: \"Codex CLI\",\n      installHint: \"npm install -g @openai/codex\",\n    },\n  ],\n};\n\nconst AGENT_SETUP: Record<string, AgentSetupInfo> = {\n  // --- Agents requiring their own CLI installed first ---\n  \"claude-acp\": {\n    setupSteps: [\n      \"Install Claude CLI: npm install -g @anthropic-ai/claude-code\",\n      \"Login: claude login (opens browser for Anthropic account)\",\n    ],\n    loginCommand: \"claude login\",\n  },\n  \"codex-acp\": {\n    setupSteps: [\n      \"Install Codex CLI: npm install -g @openai/codex\",\n      \"Login: codex (select 'Sign in with ChatGPT')\",\n      \"Or set API key: export OPENAI_API_KEY=<your-key>\",\n    ],\n    loginCommand: \"codex\",\n  },\n\n  // --- Agents with built-in auth (npx handles download) ---\n  \"gemini\": {\n    setupSteps: [\n      \"Login with Google: openacp agents run gemini (select 'Sign in with Google')\",\n      \"Or set API key: export GEMINI_API_KEY=<key> (get from aistudio.google.com/apikey)\",\n      \"Free tier: 60 requests/min, 1000 requests/day\",\n    ],\n    loginCommand: \"openacp agents run gemini\",\n  },\n  \"github-copilot-cli\": {\n    setupSteps: [\n      \"Requires active GitHub Copilot subscription\",\n      \"Login: openacp agents run copilot (use /login command inside CLI)\",\n      \"Or set token: export GITHUB_TOKEN=<personal-access-token>\",\n    ],\n    loginCommand: \"openacp agents run copilot\",\n  },\n  \"cline\": {\n    setupSteps: [\n      \"Login: openacp agents run cline -- auth (guided API key setup)\",\n      \"Supports: Anthropic, OpenAI, Gemini, AWS Bedrock, Azure, Ollama, and more\",\n      \"Or set env: export ANTHROPIC_API_KEY=<key> (or OPENAI_API_KEY, etc.)\",\n    ],\n    loginCommand: \"openacp agents run cline -- auth\",\n  },\n  \"auggie\": {\n    setupSteps: [\n      \"Login: openacp agents run auggie -- login (opens browser for Augment account)\",\n    ],\n    loginCommand: \"openacp agents run auggie -- login\",\n  },\n  \"qwen-code\": {\n    setupSteps: [\n      \"Login: openacp agents run qwen (use /auth command, select 'Qwen OAuth')\",\n      \"Free: 1000 requests/day with Qwen OAuth\",\n      \"Or set API key: export OPENAI_API_KEY=<key> in ~/.qwen/settings.json\",\n    ],\n    loginCommand: \"openacp agents run qwen\",\n  },\n\n  // --- Agents requiring API keys via env vars ---\n  \"kimi\": {\n    setupSteps: [\n      \"Login: openacp agents run kimi (use /login command inside CLI)\",\n      \"Recommended: select 'Kimi Code' for browser-based OAuth\",\n      \"Or select another provider and enter API key manually\",\n    ],\n    loginCommand: \"openacp agents run kimi\",\n  },\n  \"cursor\": {\n    setupSteps: [\n      \"Requires active Cursor subscription\",\n      \"Login: openacp agents run cursor (opens browser for Cursor account)\",\n    ],\n    loginCommand: \"openacp agents run cursor\",\n  },\n\n  // --- Agents with provider selection on first run ---\n  \"goose\": {\n    setupSteps: [\n      \"First run auto-enters setup mode — choose your LLM provider\",\n      \"Options: OpenAI, Anthropic, Google Gemini, OpenRouter, or local models\",\n      \"Set provider API key: export OPENAI_API_KEY=<key> (or other provider)\",\n      \"Reconfigure anytime: goose configure\",\n    ],\n  },\n  \"junie\": {\n    setupSteps: [\n      \"Bring Your Own Key (BYOK) — provide API key from any supported provider\",\n      \"Supports: OpenAI, Anthropic, Gemini, xAI, OpenRouter\",\n      \"Free tier: up to $50 with Gemini 3 Flash included\",\n      \"Set key via env or first-run setup prompt\",\n    ],\n  },\n  \"kilo\": {\n    setupSteps: [\n      \"Options: bring your own API keys (Anthropic, OpenAI, Google) or use Kilo Gateway\",\n      \"Kilo Gateway: pay-as-you-go, includes free models — no API key needed\",\n      \"BYOK: set provider key, e.g. export ANTHROPIC_API_KEY=<key>\",\n    ],\n  },\n  \"mistral-vibe\": {\n    setupSteps: [\n      \"Get API key from console.mistral.ai/codestral/cli\",\n      \"Or sign up for Free/Pro/Team plan at mistral.ai\",\n      \"Set key when prompted on first run\",\n    ],\n  },\n  \"deepagents\": {\n    setupSteps: [\n      \"Powered by LangChain — set your LLM provider API key\",\n      \"Example: export OPENAI_API_KEY=<key> or export ANTHROPIC_API_KEY=<key>\",\n    ],\n  },\n\n  // --- Agents that work out of the box (no setup / minimal setup) ---\n  \"crow-cli\": {\n    setupSteps: [\n      \"Requires uvx (Python package runner): pip install uv\",\n      \"Bring your own API key for your chosen LLM provider\",\n    ],\n  },\n  \"fast-agent\": {\n    setupSteps: [\n      \"Requires uvx (Python package runner): pip install uv\",\n      \"Configure LLM provider in agent config file\",\n    ],\n  },\n};\n\nexport function getAgentSetup(registryId: string): AgentSetupInfo | undefined {\n  return AGENT_SETUP[registryId];\n}\n\nconst AGENT_CAPABILITIES: Record<string, AgentCapability> = {\n  claude: {\n    supportsResume: true,\n    resumeCommand: (sid) => `claude --resume ${sid}`,\n    integration: {\n      hookEvent: \"UserPromptSubmit\",\n      settingsPath: \"~/.claude/settings.json\",\n      settingsFormat: \"settings_json\",\n      hooksDirPath: \"~/.claude/hooks/\",\n      outputFormat: \"plaintext\",\n      sessionIdField: \".session_id\",\n      commandsPath: \"~/.claude/commands/\",\n      handoffCommandName: \"openacp:handoff\",\n      commandFormat: \"markdown\",\n      sessionIdVar: \"CLAUDE_SESSION_ID\",\n      workingDirVar: \"CLAUDE_WORKING_DIR\",\n    },\n  },\n  cursor: {\n    supportsResume: true,\n    resumeCommand: (sid) => `cursor --resume ${sid}`,\n    integration: {\n      hookEvent: \"beforeSubmitPrompt\",\n      settingsPath: \"~/.cursor/hooks.json\",\n      settingsFormat: \"hooks_json\",\n      hooksDirPath: \"~/.cursor/hooks/\",\n      outputFormat: \"json\",\n      sessionIdField: \".conversation_id\",\n      commandsPath: \"~/.cursor/skills/\",\n      handoffCommandName: \"openacp-handoff\",\n      commandFormat: \"skill\",\n    },\n  },\n  gemini: {\n    supportsResume: true,\n    resumeCommand: (sid) => `gemini --resume ${sid}`,\n    integration: {\n      hookEvent: \"BeforeAgent\",\n      settingsPath: \"~/.gemini/settings.json\",\n      settingsFormat: \"settings_json\",\n      hooksDirPath: \"~/.gemini/hooks/\",\n      outputFormat: \"json\",\n      sessionIdField: \".session_id\",\n    },\n  },\n  cline: {\n    supportsResume: true,\n    resumeCommand: () => `cline --continue`,\n    integration: {\n      hookEvent: \"TaskStart\",\n      settingsPath: \"~/.cline/settings.json\",\n      settingsFormat: \"settings_json\",\n      hooksDirPath: \"~/.cline/hooks/\",\n      outputFormat: \"json\",\n      sessionIdField: \".session_id\",\n    },\n  },\n  codex: {\n    supportsResume: true,\n    resumeCommand: (sid) => `codex resume ${sid}`,\n  },\n  kilo: {\n    supportsResume: true,\n    resumeCommand: () => `kilo --continue`,\n  },\n  amp: {\n    supportsResume: true,\n    resumeCommand: (sid) => `amp threads continue ${sid}`,\n  },\n};\n\nexport const REGISTRY_AGENT_ALIASES: Record<string, string> = {\n  \"claude-acp\": \"claude\",\n  \"codex-acp\": \"codex\",\n  \"gemini\": \"gemini\",\n  \"cursor\": \"cursor\",\n  \"github-copilot-cli\": \"copilot\",\n  \"cline\": \"cline\",\n  \"goose\": \"goose\",\n  \"kilo\": \"kilo\",\n  \"qwen-code\": \"qwen\",\n};\n\nexport function getAgentAlias(registryId: string): string {\n  return REGISTRY_AGENT_ALIASES[registryId] ?? registryId;\n}\n\nexport function getAgentDependencies(registryId: string): AgentDependency[] {\n  return AGENT_DEPENDENCIES[registryId] ?? [];\n}\n\nexport function getAgentCapabilities(agentName: string): AgentCapability {\n  return AGENT_CAPABILITIES[agentName] ?? { supportsResume: false };\n}\n\nexport function listAgentsWithIntegration(): string[] {\n  return Object.entries(AGENT_CAPABILITIES)\n    .filter(([, cap]) => cap.integration != null)\n    .map(([key]) => key);\n}\n\nexport function commandExists(cmd: string): boolean {\n  try {\n    execFileSync(\"which\", [cmd], { stdio: \"pipe\" });\n    return true;\n  } catch {\n    // not in PATH\n  }\n  // Check node_modules/.bin (walks up from cwd)\n  let dir = process.cwd();\n  while (true) {\n    const binPath = path.join(dir, \"node_modules\", \".bin\", cmd);\n    if (fs.existsSync(binPath)) return true;\n    const parent = path.dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return false;\n}\n\nexport function checkDependencies(registryId: string): AvailabilityResult {\n  const deps = getAgentDependencies(registryId);\n  if (deps.length === 0) return { available: true };\n\n  const missing = deps.filter((d) => !commandExists(d.command));\n  if (missing.length === 0) return { available: true };\n\n  return {\n    available: false,\n    reason: `Requires: ${missing.map((m) => m.label).join(\", \")}`,\n    missing: missing.map((m) => ({ label: m.label, installHint: m.installHint })),\n  };\n}\n\nexport function checkRuntimeAvailable(runtime: \"npx\" | \"uvx\"): boolean {\n  return commandExists(runtime);\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-UG6X672R.js → chunk-IURZ4QHG.js}

@@ -23,7 +23,8 @@ Each session gets its own topic \u2014 chat there to work with the agent.
 /cancel \u2014 Cancel session (in session topic)
 /status \u2014 Show session or system status
 /sessions \u2014 List all sessions
-/agents \u2014 List available agents
+/agents \u2014 Browse & install agents
+/install <name> \u2014 Install an agent
 
 \u2699\uFE0F <b>System</b>
 /restart \u2014 Restart OpenACP
@@ -87,4 +88,4 @@ export {
   handleClear,
   buildSkillMessages
 };
-//# sourceMappingURL=chunk-UG6X672R.js.map
+//# sourceMappingURL=chunk-IURZ4QHG.js.map

package/dist/chunk-IURZ4QHG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/telegram/commands/menu.ts"],"sourcesContent":["import type { Context } from \"grammy\";\nimport { InlineKeyboard } from \"grammy\";\nimport type { AgentCommand } from \"../../../core/index.js\";\nimport type { CommandsAssistantContext } from \"../types.js\";\n\nexport function buildMenuKeyboard(): InlineKeyboard {\n  return new InlineKeyboard()\n    .text(\"🆕 New Session\", \"m:new\")\n    .text(\"📋 Sessions\", \"m:topics\")\n    .row()\n    .text(\"📊 Status\", \"m:status\")\n    .text(\"🤖 Agents\", \"m:agents\")\n    .row()\n    .text(\"⚙️ Settings\", \"m:settings\")\n    .text(\"🔗 Integrate\", \"m:integrate\")\n    .row()\n    .text(\"🔄 Restart\", \"m:restart\")\n    .text(\"⬆️ Update\", \"m:update\")\n    .row()\n    .text(\"❓ Help\", \"m:help\")\n    .text(\"🩺 Doctor\", \"m:doctor\");\n}\n\nexport async function handleMenu(ctx: Context): Promise<void> {\n  await ctx.reply(`<b>OpenACP Menu</b>\\nChoose an action:`, {\n    parse_mode: \"HTML\",\n    reply_markup: buildMenuKeyboard(),\n  });\n}\n\nexport async function handleHelp(ctx: Context): Promise<void> {\n  await ctx.reply(\n    `📖 <b>OpenACP Help</b>\\n\\n` +\n      `🚀 <b>Getting Started</b>\\n` +\n      `Tap 🆕 New Session to start coding with AI.\\n` +\n      `Each session gets its own topic — chat there to work with the agent.\\n\\n` +\n      `💡 <b>Common Tasks</b>\\n` +\n      `/new [agent] [workspace] — Create new session\\n` +\n      `/cancel — Cancel session (in session topic)\\n` +\n      `/status — Show session or system status\\n` +\n      `/sessions — List all sessions\\n` +\n      `/agents — Browse & install agents\\n` +\n      `/install <name> — Install an agent\\n\\n` +\n      `⚙️ <b>System</b>\\n` +\n      `/restart — Restart OpenACP\\n` +\n      `/update — Update to latest version\\n` +\n      `/integrate — Manage agent integrations\\n` +\n      `/menu — Show action menu\\n\\n` +\n      `🔒 <b>Session Options</b>\\n` +\n      `/enable_dangerous — Auto-approve permissions\\n` +\n      `/disable_dangerous — Restore permission prompts\\n` +\n      `/handoff — Continue session in terminal\\n` +\n      `/clear — Clear assistant history\\n\\n` +\n      `💬 Need help? Just ask me in this topic!`,\n    { parse_mode: \"HTML\" },\n  );\n}\n\nexport async function handleClear(ctx: Context, assistant?: CommandsAssistantContext): Promise<void> {\n  if (!assistant) {\n    await ctx.reply(\"⚠️ Assistant is not available.\", { parse_mode: \"HTML\" });\n    return;\n  }\n\n  const threadId = ctx.message?.message_thread_id;\n  if (threadId !== assistant.topicId) {\n    await ctx.reply(\"ℹ️ /clear only works in the Assistant topic.\", { parse_mode: \"HTML\" });\n    return;\n  }\n\n  await ctx.reply(\"🔄 Clearing assistant history...\", { parse_mode: \"HTML\" });\n\n  try {\n    await assistant.respawn();\n    await ctx.reply(\"✅ Assistant history cleared.\", { parse_mode: \"HTML\" });\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    await ctx.reply(`❌ Failed to clear: <code>${message}</code>`, { parse_mode: \"HTML\" });\n  }\n}\n\nconst TELEGRAM_MSG_LIMIT = 4096;\n\n/**\n * Build plain-text skill command messages. Each command is on its own line\n * wrapped in <code> for tap-to-copy. If the list exceeds Telegram's message\n * limit, it is split into multiple messages (cut at line boundaries).\n */\nexport function buildSkillMessages(commands: AgentCommand[]): string[] {\n  const sorted = [...commands].sort((a, b) => a.name.localeCompare(b.name));\n  const header = \"🛠 <b>Available Skills</b>\\n\";\n  const lines = sorted.map((c) => `<code>/${c.name}</code>`);\n\n  const messages: string[] = [];\n  let current = header;\n\n  for (const line of lines) {\n    const candidate = current + \"\\n\" + line;\n    if (candidate.length > TELEGRAM_MSG_LIMIT) {\n      messages.push(current);\n      current = line;\n    } else {\n      current = candidate;\n    }\n  }\n  if (current) messages.push(current);\n  return messages;\n}\n"],"mappings":";AACA,SAAS,sBAAsB;AAIxB,SAAS,oBAAoC;AAClD,SAAO,IAAI,eAAe,EACvB,KAAK,yBAAkB,OAAO,EAC9B,KAAK,sBAAe,UAAU,EAC9B,IAAI,EACJ,KAAK,oBAAa,UAAU,EAC5B,KAAK,oBAAa,UAAU,EAC5B,IAAI,EACJ,KAAK,yBAAe,YAAY,EAChC,KAAK,uBAAgB,aAAa,EAClC,IAAI,EACJ,KAAK,qBAAc,WAAW,EAC9B,KAAK,uBAAa,UAAU,EAC5B,IAAI,EACJ,KAAK,eAAU,QAAQ,EACvB,KAAK,oBAAa,UAAU;AACjC;AAEA,eAAsB,WAAW,KAA6B;AAC5D,QAAM,IAAI,MAAM;AAAA,oBAA0C;AAAA,IACxD,YAAY;AAAA,IACZ,cAAc,kBAAkB;AAAA,EAClC,CAAC;AACH;AAEA,eAAsB,WAAW,KAA6B;AAC5D,QAAM,IAAI;AAAA,IACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAsBA,EAAE,YAAY,OAAO;AAAA,EACvB;AACF;AAEA,eAAsB,YAAY,KAAc,WAAqD;AACnG,MAAI,CAAC,WAAW;AACd,UAAM,IAAI,MAAM,4CAAkC,EAAE,YAAY,OAAO,CAAC;AACxE;AAAA,EACF;AAEA,QAAM,WAAW,IAAI,SAAS;AAC9B,MAAI,aAAa,UAAU,SAAS;AAClC,UAAM,IAAI,MAAM,0DAAgD,EAAE,YAAY,OAAO,CAAC;AACtF;AAAA,EACF;AAEA,QAAM,IAAI,MAAM,2CAAoC,EAAE,YAAY,OAAO,CAAC;AAE1E,MAAI;AACF,UAAM,UAAU,QAAQ;AACxB,UAAM,IAAI,MAAM,qCAAgC,EAAE,YAAY,OAAO,CAAC;AAAA,EACxE,SAAS,KAAK;AACZ,UAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC/D,UAAM,IAAI,MAAM,iCAA4B,OAAO,WAAW,EAAE,YAAY,OAAO,CAAC;AAAA,EACtF;AACF;AAEA,IAAM,qBAAqB;AAOpB,SAAS,mBAAmB,UAAoC;AACrE,QAAM,SAAS,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AACxE,QAAM,SAAS;AACf,QAAM,QAAQ,OAAO,IAAI,CAAC,MAAM,UAAU,EAAE,IAAI,SAAS;AAEzD,QAAM,WAAqB,CAAC;AAC5B,MAAI,UAAU;AAEd,aAAW,QAAQ,OAAO;AACxB,UAAM,YAAY,UAAU,OAAO;AACnC,QAAI,UAAU,SAAS,oBAAoB;AACzC,eAAS,KAAK,OAAO;AACrB,gBAAU;AAAA,IACZ,OAAO;AACL,gBAAU;AAAA,IACZ;AAAA,EACF;AACA,MAAI,QAAS,UAAS,KAAK,OAAO;AAClC,SAAO;AACT;","names":[]}