@openacp/cli 0.2.19 → 0.2.23

package/README.md

@@ -1,82 +1,58 @@
+<div align="center">
+
 # OpenACP
 
-Self-hosted bridge that lets you interact with AI coding agents (Claude Code, Codex, etc.) from messaging platforms (Telegram, Discord, etc.) via the [Agent Client Protocol (ACP)](https://agentclientprotocol.org/).
+**Self-hosted bridge between messaging platforms and AI coding agents**
 
-**One message, any channel, any agent.**
+One message, any channel, any agent.
 
-## How It Works
+[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
+[![Node.js >= 20](https://img.shields.io/badge/Node.js-%3E%3D%2020-green.svg)](https://nodejs.org/)
+[![ACP Protocol](https://img.shields.io/badge/Protocol-ACP-purple.svg)](https://agentclientprotocol.org/)
 
-```
-You (Telegram / Discord / ...)
-  │
-  ▼
-OpenACP (ChannelAdapter)
-  │
-  ▼
-ACP Protocol (JSON-RPC over stdio)
-  │
-  ▼
-AI Agent subprocess (Claude Code, Codex, ...)
-```
+[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)
 
-You send a message in Telegram → OpenACP forwards it to an AI coding agent via ACP → agent responds with text, code, tool calls → OpenACP streams the response back to your chat.
+</div>
 
-## Features
+---
 
-- **Multi-agent** — Switch between Claude Code, Codex, or any ACP-compatible agent
-- **Telegram integration** — Forum topics per session, real-time streaming, inline permission buttons
-- **Session management** — Multiple parallel sessions, prompt queue, auto-naming
-- **Assistant topic** — AI-powered help bot that guides you through creating sessions
-- **Notification topic** — Aggregated notifications with deep links
-- **Workspace management** — Named workspaces or custom paths
-- **Self-hosted** — Your keys, your data, your machine
-
-## Quick Start
+Send a message in Telegram. An AI coding agent picks it up, writes code, runs commands, and streams everything back — in real time.
 
-### Prerequisites
+OpenACP connects messaging platforms (Telegram, Discord, ...) to AI coding agents (Claude Code, Codex, ...) via the [Agent Client Protocol (ACP)](https://agentclientprotocol.org/). You host it, you own the data.
 
-- Node.js >= 20
-- pnpm
-- A Telegram bot token (from [@BotFather](https://t.me/BotFather))
-- A Telegram Supergroup with **Forum/Topics enabled**
-- At least one ACP agent installed (e.g., `claude-agent-acp`)
+## Architecture
 
-### Install
-
-```bash
-npm install -g @openacp/cli
-openacp
+```
+You (Telegram / Discord / ...)
+  ↓
+OpenACP ─── ChannelAdapter ─── Session Manager ─── Session Store
+  ↓                                                     ↓
+ACP Protocol (JSON-RPC / stdio)                  Tunnel Service
+  ↓                                                     ↓
+AI Agent (Claude Code, Codex, ...)            File/Diff Viewer (Monaco)
 ```
 
-### Setup Telegram
+## Highlights
 
-1. Create a Supergroup in Telegram
-2. Enable **Topics** in group settings
-3. Add your bot as **admin** with **Manage Topics** permission
-4. Get the chat ID (use [@raw_data_bot](https://t.me/raw_data_bot) or similar)
+- [**Multi-agent**](docs/guide/configuration.md#agents) — Claude Code, Codex, or any ACP-compatible agent
+- [**Telegram**](docs/guide/telegram-setup.md) — Forum topics, real-time streaming, permission buttons, skill commands
+- [**Tunnel & Viewer**](docs/guide/tunnel.md) — Public file/diff viewer via Cloudflare, ngrok, bore, Tailscale
+- [**Session persistence**](docs/guide/usage.md#session-persistence--resume) — Lazy resume across restarts
+- [**Setup wizard**](docs/guide/getting-started.md) — Interactive first-run setup with bot validation and auto-detect
+- [**Plugin system**](docs/guide/plugins.md) — Install channel adapters as npm packages
+- [**Structured logging**](docs/guide/configuration.md#logging) — Pino with rotation, per-session log files
+- **Self-hosted** — Your keys, your data, your machine
 
-### Run
+## Quick Start
 
 ```bash
+npm install -g @openacp/cli
 openacp
 ```
 
-On first run (no config file), an **interactive setup wizard** walks you through:
-
-1. **Telegram** — bot token + chat ID (validated against Telegram API)
-2. **Agents** — auto-detects installed agents, select which to enable
-3. **Workspace** — base directory for project workspaces
-4. **Security** — allowed users, session limits, timeout
-
-Config is saved to `~/.openacp/config.json`. See [docs/setup-guide.md](docs/setup-guide.md) for details.
-
-OpenACP will auto-create two topics in your group:
-- Notifications — aggregated alerts with deep links
-- Assistant — AI helper for managing sessions
+First run launches an [interactive setup wizard](docs/guide/getting-started.md) that validates your bot token, auto-detects your Telegram group, and finds installed agents.
 
-## Usage
-
-### Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
@@ -85,169 +61,29 @@ OpenACP will auto-create two topics in your group:
 | `/cancel` | Cancel current session |
 | `/status` | Show session or system status |
 | `/agents` | List available agents |
-| `/help` | Show help |
-
-### Examples
-
-```
-/new claude my-app          → New session with Claude in ~/openacp-workspace/my-app/
-/new codex api-server       → New session with Codex in ~/openacp-workspace/api-server/
-/new claude ~/code/project  → New session with absolute path
-/new                        → New session with default agent and workspace
-```
-
-### Session Flow
-
-1. Type `/new claude my-project` — bot creates a new topic
-2. Send your coding request in the topic
-3. Agent responds with streaming text, tool calls, and code
-4. When agent needs permission (run command, edit file) → inline buttons appear
-5. Click Allow/Deny → agent continues
-6. `/cancel` to stop, or start a new topic with `/new`
-
-## Configuration
-
-Config file: `~/.openacp/config.json`
-
-```json
-{
-  "channels": {
-    "telegram": {
-      "enabled": true,
-      "botToken": "...",
-      "chatId": -1001234567890,
-      "notificationTopicId": null,
-      "assistantTopicId": null
-    }
-  },
-  "agents": {
-    "claude": {
-      "command": "claude-agent-acp",
-      "args": [],
-      "env": {}
-    },
-    "codex": {
-      "command": "codex",
-      "args": ["--acp"],
-      "env": {}
-    }
-  },
-  "defaultAgent": "claude",
-  "workspace": {
-    "baseDir": "~/openacp-workspace"
-  },
-  "security": {
-    "allowedUserIds": [],
-    "maxConcurrentSessions": 5,
-    "sessionTimeoutMinutes": 60
-  }
-}
-```
-
-### Environment Variables
-
-| Variable | Overrides |
-|----------|-----------|
-| `OPENACP_CONFIG_PATH` | Config file location |
-| `OPENACP_TELEGRAM_BOT_TOKEN` | `channels.telegram.botToken` |
-| `OPENACP_TELEGRAM_CHAT_ID` | `channels.telegram.chatId` |
-| `OPENACP_DEFAULT_AGENT` | `defaultAgent` |
-| `OPENACP_DEBUG` | Enable debug logging (set to `1`) |
-
-## Plugins
-
-Install additional adapters:
-
-```bash
-openacp install @openacp/adapter-discord
-openacp plugins                              # list installed
-openacp uninstall @openacp/adapter-discord   # remove
-```
-
-Configure in `~/.openacp/config.json`:
-
-```json
-{
-  "channels": {
-    "discord": {
-      "enabled": true,
-      "adapter": "@openacp/adapter-discord",
-      "botToken": "..."
-    }
-  }
-}
-```
-
-## Project Structure
-
-```
-src/
-  cli.ts                         → CLI entry point
-  main.ts                        → Server startup
-  index.ts                       → Public API exports
-  core/
-    core.ts                      → OpenACPCore orchestrator
-    config.ts                    → ConfigManager + Zod validation
-    setup.ts                     → Interactive setup wizard
-    session.ts                   → Session (prompt queue, auto-name)
-    agent-instance.ts            → ACP SDK integration
-    channel.ts                   → ChannelAdapter abstract class
-    plugin-manager.ts            → Plugin install/uninstall/load
-    types.ts                     → Shared types
-  adapters/
-    telegram/
-      adapter.ts                 → TelegramAdapter
-      streaming.ts               → Real-time message streaming
-      commands.ts                → Bot commands
-      permissions.ts             → Permission inline buttons
-      assistant.ts               → AI assistant topic
-      formatting.ts              → Markdown → Telegram HTML
-      topics.ts                  → Forum topic management
-```
 
 ## Roadmap
 
-- **Phase 1** ✅ Core + Telegram + ACP agents
-- **Phase 2** — Web UI, CLI, Discord adapter, tunnel/file viewer
-- **Phase 3** — Agent skills as commands, session persistence
-- **Phase 4** — Voice control, file sharing
+- **Phase 1** — Core + Telegram + ACP agents
+- **Phase 2** — Tunnel/file viewer, session persistence, logging, plugin system
+- **Phase 3** — Agent skills as commands, Discord adapter, Web UI
+- **Phase 4** — Voice control, file/image sharing
 - **Phase 5** — WhatsApp, agent chaining, plugin marketplace
 
-See [docs/specs/01-roadmap.md](docs/specs/01-roadmap.md) for details.
-
-## Adding a Channel Adapter
-
-Extend `ChannelAdapter` from `@openacp/cli`:
-
-```typescript
-import { ChannelAdapter } from '@openacp/cli'
-
-class MyAdapter extends ChannelAdapter {
-  async start() { /* connect to platform */ }
-  async stop() { /* disconnect */ }
-  async sendMessage(sessionId, content) { /* send to user */ }
-  async sendPermissionRequest(sessionId, request) { /* show buttons */ }
-  async sendNotification(notification) { /* notify user */ }
-  async createSessionThread(sessionId, name) { /* create thread */ }
-  async renameSessionThread(sessionId, name) { /* rename thread */ }
-}
-```
-
-## Development
+## Star History
 
-```bash
-git clone https://github.com/nicepkg/OpenACP.git
-cd OpenACP
-pnpm install
-pnpm build
-```
+<a href="https://star-history.com/#Open-ACP/OpenACP&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Open-ACP/OpenACP&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Open-ACP/OpenACP&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Open-ACP/OpenACP&type=Date" />
+ </picture>
+</a>
 
-Run locally:
+## Contributing
 
-```bash
-pnpm start
-```
+See [development guide](docs/guide/development.md).
 
 ## License
 
-AGPL-3.0
+[AGPL-3.0](LICENSE)

package/dist/{chunk-HTXK4NLG.js → chunk-EIBLQU3H.js}

@@ -1949,6 +1949,19 @@ function redirectToAssistant(chatId, assistantTopicId) {
 
 // src/adapters/telegram/adapter.ts
 var log7 = createChildLogger({ module: "telegram" });
+function patchedFetch(input, init) {
+  if (init?.signal && !(init.signal instanceof AbortSignal)) {
+    const nativeController = new AbortController();
+    const polyfillSignal = init.signal;
+    if (polyfillSignal.aborted) {
+      nativeController.abort();
+    } else {
+      polyfillSignal.addEventListener("abort", () => nativeController.abort());
+    }
+    init = { ...init, signal: nativeController.signal };
+  }
+  return fetch(input, init);
+}
 var TelegramAdapter = class extends ChannelAdapter {
   bot;
   telegramConfig;
@@ -1966,7 +1979,7 @@ var TelegramAdapter = class extends ChannelAdapter {
     this.telegramConfig = config;
   }
   async start() {
-    this.bot = new Bot(this.telegramConfig.botToken, { client: { fetch } });
+    this.bot = new Bot(this.telegramConfig.botToken, { client: { fetch: patchedFetch } });
     this.bot.catch((err) => {
       const rootCause = err.error instanceof Error ? err.error : err;
       log7.error({ err: rootCause }, "Telegram bot error");
@@ -2389,4 +2402,4 @@ export {
   ChannelAdapter,
   TelegramAdapter
 };
-//# sourceMappingURL=chunk-HTXK4NLG.js.map
+//# sourceMappingURL=chunk-EIBLQU3H.js.map