@botconnector/bccli 0.4.0-beta.9 → 0.4.1

package/README.en.md

@@ -0,0 +1,253 @@
+# BCCLI
+
+[English](README.en.md) · **Bahasa Indonesia**
+
+[![npm](https://img.shields.io/npm/v/@botconnector/bccli?label=@botconnector/bccli)](https://www.npmjs.com/package/@botconnector/bccli?activeTab=versions)
+[![npm downloads](https://img.shields.io/npm/dm/@botconnector/bccli)](https://www.npmjs.com/package/@botconnector/bccli)
+[![Node.js](https://img.shields.io/node/v/@botconnector/bccli?label=Node.js)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Website](https://img.shields.io/badge/website-botconnector.id-06305A)](https://botconnector.id/id/download)
+
+An AI coding agent from [BotConnector](https://botconnector.id/) that works in your terminal: it reads code,
+edits files, and runs commands — with your permission.
+
+![BCCLI creating hello.js and running it with node](docs/demo.gif)
+
+*Real session recording: BCCLI creates `hello.js` and runs it with `node`.*
+
+```bash
+# one-line install (macOS / Linux / WSL2) — provisions a portable Node if needed, no sudo
+curl -fsSL https://raw.githubusercontent.com/farijarifriyanto-debug/bccli/main/install.sh | bash
+
+# Windows (PowerShell 5.1+) — needs Node.js 22+ already installed
+irm https://raw.githubusercontent.com/farijarifriyanto-debug/bccli/main/install.ps1 | iex
+
+# or manual, if you already have Node.js 22+
+npm i -g @botconnector/bccli        # latest stable, requires Node.js 22+
+npm i -g @botconnector/bccli@next   # …or the next prerelease
+bccli login                         # store your BotConnector Cloud API key
+cd your-project && bccli
+```
+
+## Usage
+
+| Command | What it does |
+|---|---|
+| `bccli` | interactive mode |
+| `bccli -p "task"` | one-shot task (scripts/CI) |
+| `bccli -p "task" --output-format json` | final result as a single JSON object; `stream-json` = JSONL events per stage (tool_use/tool_result/message/result) for CI |
+| `bccli -c` / `bccli -r` | continue last session / pick a session |
+| `bccli -m provider/model` | choose a model |
+| `bccli --reasoning <auto\|off\|low\|medium\|high\|max>` | set reasoning level for this invocation |
+| `bccli models` | list models |
+
+In-session commands (type `/` for suggestions, ↑↓ to select, Enter to run):
+
+| Command | What it does |
+|---|---|
+| `/help` | list commands and shortcuts |
+| `/model` | switch model |
+| `/reasoning` | pick Auto / Off / Low / Medium / High / Max |
+| `/provider` | add/select an AI provider |
+| `/language` | change display language (`en` / `id`) |
+| `/mcp` | install/manage MCP servers |
+| `/new` | new session (old sessions are kept) |
+| `/resume` | continue another session in this folder |
+| `/session` | info about this session |
+| `/status` | version, model, permission mode, MCP, context |
+| `/permissions` | view/revoke permissions |
+| `/pr` | review a pull request (`/pr <n\|url\|branch>`) |
+| `/worktree` | list git worktrees; create one with `bccli -w <name>` |
+| `/undo` | undo the last file-edit turn |
+| `/redo` | re-apply the file edits that /undo just reverted |
+| `/rewind` | step back turns: conversation + file edits (`/rewind 2`) |
+| `/diff` | git diff of the project |
+| `/copy` | copy the last answer |
+| `/export` | save the conversation to markdown |
+| `/memory` | project instructions (/memory <text>, /memory global <text>) |
+| `/init` | create/update AGENTS.md for this project |
+| `/agents` | list subagents |
+| `/tasks` | list background tasks |
+| `/skills` | list skills and custom commands |
+| `/doctor` | check installation health |
+| `/login` | store the active provider's API key |
+| `/logout` | remove the active provider's API key |
+| `/clear` | start a fresh conversation |
+| `/compact` | compact the conversation |
+| `/cost` | token usage for this session |
+| `/exit` | quit |
+
+`/undo` only reverts file edit/write tool changes (not bash commands), one turn at a time, up to 20 turns back.
+Shift+Tab cycles permission modes: `default` → `acceptEdits` → `plan` → `allowAll`.
+
+Reading a secret file (`.env`, `.ssh`, `.aws`, `id_rsa`, `*.pem`, `*.key`, `secret*`,
+`credential*`) always asks for approval; `allowAll` is the only mode that does not, and the
+approval cannot be granted "for this session".
+
+`-p` mode never prompts: permission-requiring tools are refused unless you pass
+`--allow-all` or `--allowed-tools bash,edit,fetch`.
+
+## Language
+
+BCCLI's UI (help, messages, permission prompts) is **English by default**. Indonesian stays available:
+
+```bash
+bccli --lang id          # one-off
+BCCLI_LANG=id bccli      # via environment
+/language id             # inside a session; stored in ~/.bccli/config.json ("language")
+```
+
+Priority order: `--lang`, then `BCCLI_LANG`, then `language` in config, then English. The model answers in
+the language you write; tool messages the model reads (tool output, errors) are always English so they
+don't distort the reply language.
+
+## Providers
+
+`/provider` in a session (or `bccli provider add <id>`) adds a provider with just an API key:
+
+| Id | Provider |
+|---|---|
+| `bc-cloud` | BotConnector Cloud (default) |
+| `openrouter` | OpenRouter |
+| `openai` | OpenAI |
+| `gemini` | Google Gemini |
+| `deepseek` | DeepSeek |
+| `groq` | Groq |
+| `ollama-cloud` | Ollama Cloud |
+| `ollama` | local Ollama (no key) |
+| `lmstudio` | local LM Studio (no key) |
+
+Any other OpenAI-compatible provider: pick **Custom…** in `/provider`, or
+`bccli provider add corp --url https://corp.example/v1 --name "Corp"`.
+
+`/model` lists models from **every** provider that has a key, grouped by provider;
+type to filter. Your choice is saved as the default.
+
+Reasoning can be set via `bccli --reasoning <auto|off|low|medium|high|max>` or `/reasoning`.
+**Auto** uses the model/provider default and BCCLI sends no reasoning override. BCCLI never
+silently lowers or raises reasoning effort. Manual levels pass through when the provider/model
+contract supports them; unsupported levels produce a clear error instead of a silent downgrade.
+
+`.bccli/config.json` inside a project may only pick a `model` and add new keyless providers —
+the `reasoning` preference is read only from the user config `~/.bccli/config.json`, never from a
+cloned repo — permissions (`permissionMode`, `allow`) and existing providers are configured only
+from `~/.bccli/config.json`, so a cloned repo cannot grant itself full permissions or steal API keys.
+
+Every key of `~/.bccli/config.json` with its values and scope: [`docs/config.md`](docs/config.md).
+
+## External agent integrations
+
+BCCLI can set up BotConnector as a provider for other agents:
+
+| Command | What it does |
+|---|---|
+| `bccli integrations` | show integration status |
+| `bccli connect opencode` | connect OpenCode to BotConnector |
+| `bccli connect aider` | connect Aider to BotConnector |
+| `bccli connect cline` | connect Cline CLI to BotConnector |
+| `bccli connect deepseek-harness` / `bccli connect dsh` | connect DeepSeek Harness to BotConnector |
+| `bccli connect codex` | create Codex Responses API profile + BotConnector launcher |
+| `bccli connect claude-code` | create a Claude Code launcher via Anthropic Messages compatibility |
+| `bccli connect cursor` | guided Cursor setup + Base URL override warning |
+| `bccli connect openai-cli` | create an OpenAI CLI launcher for BotConnector |
+| `bccli connect openai-sdk` | create an env profile for the OpenAI Python/Node SDK |
+| `bccli connect openai-compatible` | create a universal OpenAI-compatible env profile |
+| `bccli disconnect <agent>` | restore the config from before the integration |
+
+OpenCode uses the global config `~/.config/opencode/opencode.json`. BCCLI fetches the BotConnector
+model catalog on connect, preserves other providers' config, and stores secrets in a separate file
+under `~/.bccli/integrations/`.
+Aider uses `~/.aider.conf.yml` pointing at a separate BCCLI env file; BCCLI refuses to overwrite
+existing Aider OpenAI/env-file settings.
+
+Cline uses an `openai-compatible` provider in `~/.cline/data/settings/providers.json`. If that slot
+is taken by another endpoint, BCCLI refuses to overwrite it. Cline itself stores provider API keys
+in that file.
+
+DeepSeek Harness uses a custom `botconnector` provider in `$DSH_HOME/settings.yaml` with
+`api: openai-completions` and `apiKeyEnv: BOTCONNECTOR_API_KEY`; the key goes in the BCCLI block of
+`$DSH_HOME/.env`. Other DSH providers are kept. After connecting, run the web profile with
+`dsh web` (same as `dsh --profile web`); bare `dsh` without a profile is rejected by DSH 0.1.x.
+
+Codex uses a profile `$CODEX_HOME/botconnector.config.toml` with `wire_api = "responses"` and a BCCLI
+launcher that reads the key from BCCLI storage at runtime. Claude Code gets an isolated launcher with
+`ANTHROPIC_BASE_URL=https://api.botconnector.id` and the `/v1/messages` compatibility endpoint +
+token counting. Codex and Claude Code primary login/config are not overwritten.
+
+External agents call BotConnector directly, so model discovery does not use BCCLI-specific identity.
+Access restricted to BCCLI/Web App (for example Luna launch access) is not automatically inherited.
+Before changing external config, BCCLI makes a backup so `disconnect` can restore it.
+
+## Internet
+
+- `web_search`: web search with no permission prompt. Uses your BotConnector Cloud account when a key
+  is present, otherwise goes straight to Keenable (free, no key). Results are titles, URLs, and short
+  snippets, so they are token-efficient.
+- `fetch`: open one URL from this machine (permission required per host).
+
+## MCP
+
+`/mcp` (or `bccli mcp add <name>`) installs servers from the catalog:
+`playwright`, `context7`, `fetch`, `filesystem`, `git`, `github`. Other remote servers:
+`bccli mcp add name --url https://…`. Stored in `~/.bccli/mcp.json` (`mcpServers` format, same as
+Claude Code). All MCP tools always require permission.
+
+A `.bccli/mcp.json` inside a repo is not executed until you approve it (asked once per folder).
+
+`bccli mcp serve` runs a stdio MCP server with your BotConnector tools
+(`bc_search`, `bc_fetch`, `bc_models`, `bc_chat`) for Claude Code, Cursor, opencode, and other MCP
+hosts. Requires `bccli login` (or `BOTCONNECTOR_API_KEY`):
+
+```bash
+claude mcp add botconnector -- npx -y @botconnector/bccli mcp serve
+```
+
+## Subagents
+
+The agent can delegate work via the `task` tool:
+- `explore` — read & search only, can run in parallel;
+- `general` — all tools (edits/commands still ask permission);
+- custom — `.bccli/agents/name.md` or `.claude/agents/name.md`:
+
+```markdown
+---
+name: reviewer
+description: review code changes
+tools: [read, grep, glob]
+model: openrouter/qwen/qwen3-coder
+---
+You are a code reviewer. Report real bugs only.
+```
+
+## Skills & custom commands
+
+- Skills: folders containing `SKILL.md` in `~/.bccli/skills/`, `.bccli/skills/`, `~/.claude/skills/`,
+  `.claude/skills/` — used automatically when relevant, or via `/skill-name`.
+- Commands: `commands/name.md` in the same folders → `/name arguments` (`$ARGUMENTS` is replaced).
+
+## Todos & plan mode
+
+Tasks with ≥ 3 steps show a checklist above the input box. In plan mode (Shift+Tab),
+the agent only reads and then proposes a plan; `[a]` approves with automatic edits,
+`[y]` approves asking at each step, `[n]` asks for revisions.
+
+Project instructions are read from `AGENTS.md`, `CLAUDE.md`, and `BCCLI.md`.
+
+## Development
+
+```bash
+npm install
+npm test && npm run typecheck && npm run lint && npm run build
+npm run coverage   # coverage gate (also enforced on Linux CI)
+```
+
+CI (`ci.yml`) runs the same on Linux, macOS, and Windows, plus the coverage gate on Linux.
+Releases: bump `version` in `package.json`, then push a `v<version>` tag — `release.yml`
+runs tests, a smoke test against BotConnector Cloud, and `npm publish --provenance`.
+
+## Learn more
+
+- [Download & BCCLI guide](https://botconnector.id/id/download)
+- [BotConnector Developer API](https://botconnector.id/id/developers/api) — OpenAI SDK-compatible endpoint
+- [Switchboard](https://github.com/farijarifriyanto-debug/switchboard) — BotConnector's open source agent harness
+- [Contributing](CONTRIBUTING.md)

package/README.md

@@ -1,11 +1,31 @@
 # BCCLI
 
-Agent AI coding dari BotConnector yang bekerja di terminal: membaca kode, mengedit file,
+**Bahasa Indonesia** · [English](README.en.md)
+
+[![npm](https://img.shields.io/npm/v/@botconnector/bccli?label=@botconnector/bccli)](https://www.npmjs.com/package/@botconnector/bccli?activeTab=versions)
+[![npm downloads](https://img.shields.io/npm/dm/@botconnector/bccli)](https://www.npmjs.com/package/@botconnector/bccli)
+[![Node.js](https://img.shields.io/node/v/@botconnector/bccli?label=Node.js)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Website](https://img.shields.io/badge/website-botconnector.id-06305A)](https://botconnector.id/id/download)
+
+Agent AI coding dari [BotConnector](https://botconnector.id/) yang bekerja di terminal: membaca kode, mengedit file,
 dan menjalankan perintah — dengan izin kamu.
 
+![BCCLI membuat hello.js dan menjalankannya dengan node](docs/demo.gif)
+
+*Rekaman sesi asli: BCCLI membuat file `hello.js` lalu menjalankannya dengan `node`.*
+
 ```bash
-npm i -g @botconnector/bccli@next    # beta terbaru, butuh Node.js 22+
-bccli login                     # simpan API key BotConnector Cloud
+# install satu baris (macOS / Linux / WSL2) — pasang Node portable bila perlu, tanpa sudo
+curl -fsSL https://raw.githubusercontent.com/farijarifriyanto-debug/bccli/main/install.sh | bash
+
+# Windows (PowerShell 5.1+) — butuh Node.js 22+ terpasang lebih dulu
+irm https://raw.githubusercontent.com/farijarifriyanto-debug/bccli/main/install.ps1 | iex
+
+# atau manual, bila Node.js 22+ sudah terpasang
+npm i -g @botconnector/bccli        # rilis stabil terbaru, butuh Node.js 22+
+npm i -g @botconnector/bccli@next   # …atau pra-rilis berikutnya
+bccli login                         # simpan API key BotConnector Cloud
 cd project-kamu && bccli
 ```
 
@@ -15,6 +35,7 @@ cd project-kamu && bccli
 |---|---|
 | `bccli` | mode interaktif |
 | `bccli -p "tugas"` | satu tugas tanpa interaksi (skrip/CI) |
+| `bccli -p "tugas" --output-format json` | hasil akhir sebagai satu objek JSON; `stream-json` = event JSONL per tahap (tool_use/tool_result/message/result) untuk CI |
 | `bccli -c` / `bccli -r` | lanjutkan sesi terakhir / pilih sesi |
 | `bccli -m provider/model` | pilih model |
 | `bccli --reasoning <auto|off|low|medium|high|max>` | pilih level reasoning untuk invocation ini |
@@ -28,19 +49,25 @@ Perintah di dalam sesi (ketik `/` untuk saran, ↑↓ pilih, Enter jalankan):
 | `/model` | ganti model |
 | `/reasoning` | pilih Auto / Off / Low / Medium / High / Max |
 | `/provider` | tambah/pilih provider AI |
+| `/language` | ganti bahasa tampilan (`en` / `id`) |
 | `/mcp` | pasang/kelola server MCP |
 | `/new` | sesi baru (sesi lama tetap tersimpan) |
 | `/resume` | lanjutkan sesi lain di folder ini |
 | `/session` | info sesi ini |
 | `/status` | versi, model, mode izin, MCP, konteks |
 | `/permissions` | lihat/cabut izin |
+| `/pr` | review pull request (`/pr <n\|url\|branch>`) |
+| `/worktree` | daftar git worktree; buat dengan `bccli -w <nama>` |
 | `/undo` | batalkan edit file giliran terakhir |
+| `/redo` | terapkan ulang edit file yang baru dibatalkan `/undo` |
+| `/rewind` | mundur beberapa giliran: percakapan + edit file (`/rewind 2`) |
 | `/diff` | git diff project |
 | `/copy` | salin jawaban terakhir |
 | `/export` | simpan percakapan ke markdown |
 | `/memory` | instruksi project (/memory <teks>, /memory global <teks>) |
 | `/init` | buat/perbarui AGENTS.md untuk project ini |
 | `/agents` | daftar subagent |
+| `/tasks` | daftar tugas latar belakang |
 | `/skills` | daftar skill dan perintah custom |
 | `/doctor` | cek kesehatan instalasi |
 | `/login` | simpan API key provider aktif |
@@ -53,9 +80,26 @@ Perintah di dalam sesi (ketik `/` untuk saran, ↑↓ pilih, Enter jalankan):
 `/undo` hanya membatalkan perubahan lewat alat edit/tulis (bukan perintah bash), per giliran, sampai 20 giliran ke belakang.
 Shift+Tab ganti mode izin: `default` → `acceptEdits` → `plan` → `allowAll`.
 
+Membaca file rahasia (`.env`, `.ssh`, `.aws`, `id_rsa`, `*.pem`, `*.key`, `secret*`,
+`credential*`) selalu meminta izin; `allowAll` satu-satunya mode yang tidak bertanya, dan
+izin itu tidak bisa diberikan "untuk sesi ini".
+
 Mode `-p` tidak pernah bertanya: alat yang butuh izin ditolak, kecuali memakai
 `--allow-all` atau `--allowed-tools bash,edit,fetch`.
 
+## Bahasa
+
+Tampilan BCCLI (bantuan, pesan, prompt izin) memakai **bahasa Inggris secara default**. Bahasa Indonesia tetap tersedia:
+
+```bash
+bccli --lang id          # hanya untuk satu kali jalan
+BCCLI_LANG=id bccli      # lewat environment
+/language id             # di dalam sesi; disimpan di ~/.bccli/config.json ("language")
+```
+
+Urutan prioritas: `--lang`, lalu `BCCLI_LANG`, lalu `language` di config, lalu Inggris. Bahasa jawaban model mengikuti bahasa yang kamu tulis, dan
+pesan alat yang dibaca model (hasil tool, galat) selalu berbahasa Inggris supaya tidak mengganggu bahasa jawabannya.
+
 ## Provider
 
 `/provider` di dalam sesi (atau `bccli provider add <id>`) memasang provider hanya dengan API key:
@@ -88,6 +132,8 @@ preference `reasoning` hanya dibaca dari config user `~/.bccli/config.json`, buk
 izin (`permissionMode`, `allow`) dan provider yang sudah ada hanya diatur dari `~/.bccli/config.json`,
 supaya repo yang kamu clone tidak bisa memberi dirinya izin penuh atau mencuri API key.
 
+Daftar lengkap kunci `~/.bccli/config.json` beserta nilai dan cakupannya: [`docs/config.md`](docs/config.md).
+
 ## Integrasi agent eksternal
 
 BCCLI dapat memasang BotConnector sebagai provider untuk agent lain:
@@ -97,12 +143,37 @@ BCCLI dapat memasang BotConnector sebagai provider untuk agent lain:
 | `bccli integrations` | lihat status integrasi |
 | `bccli connect opencode` | hubungkan OpenCode ke BotConnector |
 | `bccli connect aider` | hubungkan Aider ke BotConnector |
+| `bccli connect cline` | hubungkan Cline CLI ke BotConnector |
+| `bccli connect deepseek-harness` / `bccli connect dsh` | hubungkan DeepSeek Harness ke BotConnector |
+| `bccli connect codex` | buat profile Codex Responses API + launcher BotConnector |
+| `bccli connect claude-code` | buat launcher Claude Code via Anthropic Messages compatibility |
+| `bccli connect cursor` | buat guided setup Cursor + warning override Base URL |
+| `bccli connect openai-cli` | buat launcher OpenAI CLI khusus BotConnector |
+| `bccli connect openai-sdk` | buat env profile untuk OpenAI Python/Node SDK |
+| `bccli connect openai-compatible` | buat env profile universal OpenAI-compatible |
 | `bccli disconnect <agent>` | pulihkan config sebelum integrasi |
 
 OpenCode memakai config global `~/.config/opencode/opencode.json`. BCCLI mengambil katalog model BotConnector saat connect,
 menjaga config provider lain, dan menyimpan secret di file terpisah di `~/.bccli/integrations/`.
 Aider memakai `~/.aider.conf.yml` yang menunjuk ke env file BCCLI terpisah; BCCLI menolak menimpa setting
-OpenAI/env-file Aider yang sudah ada. Sebelum mengubah config eksternal, BCCLI membuat backup agar disconnect dapat memulihkannya.
+OpenAI/env-file Aider yang sudah ada.
+
+Cline memakai provider `openai-compatible` di `~/.cline/data/settings/providers.json`. Jika slot itu sudah dipakai
+endpoint lain, BCCLI menolak menimpanya. Cline sendiri menyimpan API key provider di file tersebut.
+
+DeepSeek Harness memakai custom provider `botconnector` di `$DSH_HOME/settings.yaml` dengan
+`api: openai-completions` dan `apiKeyEnv: BOTCONNECTOR_API_KEY`; key diletakkan pada blok BCCLI di
+`$DSH_HOME/.env`. Provider DSH lain tetap dipertahankan. Setelah connect, jalankan profile web dengan
+`dsh web` (setara dengan `dsh --profile web`); `dsh` tanpa profile memang ditolak oleh DSH 0.1.x.
+
+Codex memakai profile `$CODEX_HOME/botconnector.config.toml` dengan `wire_api = "responses"` dan launcher
+BCCLI yang membaca key dari storage BCCLI saat dijalankan. Claude Code memakai launcher terisolasi dengan
+`ANTHROPIC_BASE_URL=https://api.botconnector.id` dan endpoint kompatibilitas `/v1/messages` + token counting.
+Login/config utama Codex dan Claude Code tidak ditimpa.
+
+External agent memanggil BotConnector langsung, jadi discovery model tidak memakai identitas khusus BCCLI.
+Akses yang memang dibatasi ke BCCLI/Web App (misalnya Luna launch access) tidak otomatis diwariskan.
+Sebelum mengubah config eksternal, BCCLI membuat backup agar disconnect dapat memulihkannya.
 
 ## Internet
 
@@ -120,6 +191,14 @@ seperti Claude Code). Semua alat MCP selalu minta izin.
 
 `.bccli/mcp.json` di dalam repo tidak dijalankan sebelum kamu setujui (ditanya sekali per folder).
 
+`bccli mcp serve` menjalankan MCP server stdio dengan tools BotConnector milikmu
+(`bc_search`, `bc_fetch`, `bc_models`, `bc_chat`) untuk dipakai Claude Code, Cursor,
+opencode, dan host MCP lain. Butuh `bccli login` (atau `BOTCONNECTOR_API_KEY`):
+
+```bash
+claude mcp add botconnector -- npx -y @botconnector/bccli mcp serve
+```
+
 ## Subagent
 
 Agent bisa mendelegasikan pekerjaan lewat alat `task`:
@@ -149,15 +228,23 @@ Tugas ≥ 3 langkah menampilkan checklist di atas kotak input. Di mode plan (Shi
 agent hanya membaca lalu mengajukan rencana; `[a]` setujui dengan edit otomatis,
 `[y]` setujui dengan tanya tiap langkah, `[n]` minta perbaikan.
 
-Instruksi project dibaca dari `AGENTS.md` dan `BCCLI.md`.
+Instruksi project dibaca dari `AGENTS.md`, `CLAUDE.md`, dan `BCCLI.md`.
 
 ## Pengembangan
 
 ```bash
 npm install
 npm test && npm run typecheck && npm run lint && npm run build
+npm run coverage   # gerbang coverage (juga dijalankan di CI Linux)
 ```
 
-CI (`ci.yml`) menjalankan hal yang sama di Linux, macOS, dan Windows.
+CI (`ci.yml`) menjalankan hal yang sama di Linux, macOS, dan Windows, plus gerbang coverage di Linux.
 Rilis: naikkan `version` di `package.json`, lalu push tag `v<version>` — `release.yml`
 menjalankan test, smoke test ke BotConnector Cloud, dan `npm publish --provenance`.
+
+## Pelajari lebih lanjut
+
+- [Unduh & panduan BCCLI](https://botconnector.id/id/download)
+- [Developer API BotConnector](https://botconnector.id/id/developers/api) — endpoint kompatibel OpenAI SDK
+- [Switchboard](https://github.com/farijarifriyanto-debug/switchboard) — harness agent open source dari BotConnector
+- [Berkontribusi](CONTRIBUTING.md)

package/dist/abort.d.ts

@@ -0,0 +1,5 @@
+export declare const ABORTED: unique symbol;
+/** Resolves with the promise's value, or with ABORTED as soon as the signal fires. */
+export declare function raceAbort<T>(promise: Promise<T>, signal: AbortSignal): Promise<T | typeof ABORTED>;
+/** Collects an async iterable, giving up (and telling the iterator to stop) as soon as the signal fires. */
+export declare function collectUntilAbort<T>(iterable: AsyncIterable<T>, signal: AbortSignal | undefined, onItem: (item: T) => void): Promise<boolean>;

package/dist/acp-3PHBAI64.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+
+// src/acp.ts
+var ACP_PROTOCOL_VERSION = 1;
+var TOOL_KINDS = {
+  read: "read",
+  repo_map: "read",
+  edit: "edit",
+  write: "edit",
+  grep: "search",
+  glob: "search",
+  bash: "execute",
+  powershell: "execute",
+  fetch: "fetch",
+  web_search: "fetch"
+};
+var kindOf = (tool) => TOOL_KINDS[tool] ?? "other";
+var titleOf = (tool, target) => (target ? `${tool}: ${target}` : tool).slice(0, 200);
+var MAX_OUTPUT = 4e3;
+var PERMISSION_OPTIONS = [
+  { optionId: "allow", name: "Allow", kind: "allow_once" },
+  { optionId: "allow_session", name: "Allow for this session", kind: "allow_always" },
+  { optionId: "reject", name: "Reject", kind: "reject_once" }
+];
+var ANSWERS = { allow: "yes", allow_session: "session", reject: "no" };
+function runAcp(input, output, opts) {
+  const sessions = /* @__PURE__ */ new Map();
+  const awaiting = /* @__PURE__ */ new Map();
+  let nextSession = 1;
+  let nextRequest = 1;
+  const write = (msg) => {
+    output.write(`${JSON.stringify(msg)}
+`);
+  };
+  const reply = (id, result) => write({ jsonrpc: "2.0", id, result });
+  const replyError = (id, code, message) => write({ jsonrpc: "2.0", id, error: { code, message } });
+  const update = (sessionId, body) => write({ jsonrpc: "2.0", method: "session/update", params: { sessionId, update: body } });
+  const ioFor = (sid, session) => ({
+    toolStart(id, tool, target) {
+      session.open.push({ id, tool, target });
+      update(sid, { sessionUpdate: "tool_call", toolCallId: id, title: titleOf(tool, target), kind: kindOf(tool), status: "in_progress", rawInput: { target } });
+    },
+    toolEnd(id, output2, isError) {
+      session.open = session.open.filter((c) => c.id !== id);
+      const text = output2.length > MAX_OUTPUT ? `${output2.slice(0, MAX_OUTPUT)}
+[truncated]` : output2;
+      update(sid, {
+        sessionUpdate: "tool_call_update",
+        toolCallId: id,
+        status: isError ? "failed" : "completed",
+        ...text ? { content: [{ type: "content", content: { type: "text", text } }] } : {}
+      });
+    },
+    askPermission(req) {
+      return new Promise((resolve) => {
+        const requestId = nextRequest++;
+        const call = [...session.open].reverse().find((c) => c.tool === req.tool && c.target === req.target);
+        const settle = (answer) => {
+          session.pending.delete(settle);
+          awaiting.delete(requestId);
+          resolve(answer);
+        };
+        session.pending.add(settle);
+        awaiting.set(requestId, (message) => {
+          const outcome = message.result?.outcome;
+          settle(outcome?.outcome === "selected" ? ANSWERS[outcome.optionId ?? ""] ?? "no" : "no");
+        });
+        write({
+          jsonrpc: "2.0",
+          id: requestId,
+          method: "session/request_permission",
+          params: {
+            sessionId: sid,
+            toolCall: { toolCallId: call?.id ?? `permission-${requestId}`, title: titleOf(req.tool, req.target), kind: kindOf(req.tool), status: "pending" },
+            options: PERMISSION_OPTIONS
+          }
+        });
+      });
+    }
+  });
+  const handle = async (msg) => {
+    const { id, method, params } = msg ?? {};
+    if (method === void 0 && id !== void 0 && (msg.result !== void 0 || msg.error !== void 0)) {
+      awaiting.get(id)?.(msg);
+      return;
+    }
+    if (method === "initialize") {
+      return reply(id, {
+        protocolVersion: ACP_PROTOCOL_VERSION,
+        agentCapabilities: {
+          loadSession: false,
+          promptCapabilities: { image: false, audio: false, embeddedContext: false }
+        }
+      });
+    }
+    if (method === "session/new") {
+      const sessionId = `s${nextSession++}`;
+      sessions.set(sessionId, { controller: null, pending: /* @__PURE__ */ new Set(), open: [] });
+      return reply(id, { sessionId });
+    }
+    if (method === "session/cancel") {
+      const session = sessions.get(params?.sessionId ?? "");
+      session?.controller?.abort();
+      for (const settle of [...session?.pending ?? []]) settle("no");
+      return;
+    }
+    if (method === "session/prompt") {
+      const sid = params?.sessionId ?? "";
+      const session = sessions.get(sid);
+      if (!session) return replyError(id, -32602, "Unknown session");
+      const text = (params?.prompt ?? []).filter((p) => p?.type === "text").map((p) => String(p.text ?? "")).join("\n");
+      const controller = new AbortController();
+      session.controller = controller;
+      let cancelled = false;
+      controller.signal.addEventListener("abort", () => {
+        cancelled = true;
+      });
+      try {
+        session.agent ??= opts.newAgent(params?.cwd ?? opts.cwd);
+        await session.agent.run(text, (chunk) => update(sid, { sessionUpdate: "agent_message_chunk", content: { type: "text", text: chunk } }), controller.signal, ioFor(sid, session));
+      } catch (e) {
+        if (cancelled) return reply(id, { stopReason: "cancelled" });
+        return replyError(id, -32603, e.message);
+      } finally {
+        session.controller = null;
+        session.open = [];
+      }
+      return reply(id, { stopReason: cancelled ? "cancelled" : "end_turn" });
+    }
+    if (id !== void 0) return replyError(id, -32601, "Method not found");
+  };
+  return new Promise((resolve) => {
+    let buf = "";
+    const onData = (chunk) => {
+      buf += chunk.toString();
+      let idx = buf.indexOf("\n");
+      while (idx >= 0) {
+        const line = buf.slice(0, idx);
+        buf = buf.slice(idx + 1);
+        idx = buf.indexOf("\n");
+        if (!line.trim()) continue;
+        let msg;
+        try {
+          msg = JSON.parse(line);
+        } catch {
+          continue;
+        }
+        void handle(msg);
+      }
+    };
+    const onEnd = () => {
+      input.removeListener("data", onData);
+      resolve();
+    };
+    input.on("data", onData);
+    input.on("end", onEnd);
+  });
+}
+function runtimeAgent(cwd, allowAll = false) {
+  let rt;
+  return {
+    async run(text, onChunk, signal, io) {
+      if (!rt) {
+        const { parseCliArgs } = await import("./args-W6BNKY7K.js");
+        const { createRuntime } = await import("./setup-OV3NWQN5.js");
+        rt = createRuntime({ cwd, args: { ...parseCliArgs([]), allowAll } });
+      }
+      if (io && !allowAll) rt.agent.askPermission = (req) => io.askPermission(req);
+      rt.agent.onEvent = (event) => {
+        if (event.type === "text") onChunk(event.delta);
+        else if (event.type === "toolStart") io?.toolStart(event.id, event.tool, event.target);
+        else if (event.type === "toolEnd") io?.toolEnd(event.id, event.output, event.isError);
+      };
+      await rt.agent.run(text, signal);
+    }
+  };
+}
+export {
+  ACP_PROTOCOL_VERSION,
+  runAcp,
+  runtimeAgent
+};

package/dist/acp.d.ts

@@ -0,0 +1,27 @@
+import type { PermissionAnswer, PermissionAsk } from './agent';
+export declare const ACP_PROTOCOL_VERSION = 1;
+/** What the agent reports to the editor besides text: tool calls, and permission questions the editor answers. */
+export interface AcpIo {
+    toolStart(id: string, tool: string, target: string): void;
+    toolEnd(id: string, output: string, isError: boolean): void;
+    askPermission(req: PermissionAsk): Promise<PermissionAnswer>;
+}
+/** The minimum an ACP client needs: run one prompt, stream text chunks, allow cancellation. */
+export interface AcpAgent {
+    run(text: string, onChunk: (text: string) => void, signal: AbortSignal, io?: AcpIo): Promise<void>;
+}
+/**
+ * Agent Client Protocol over newline-delimited JSON-RPC (the transport editors like Zed use).
+ * Implements the subset: initialize, session/new, session/prompt (streaming session/update
+ * notifications: text chunks and tool calls), session/request_permission, session/cancel;
+ * anything else with an id gets -32601.
+ */
+export declare function runAcp(input: NodeJS.ReadableStream, output: NodeJS.WritableStream, opts: {
+    cwd: string;
+    newAgent: (cwd: string) => AcpAgent;
+}): Promise<void>;
+/**
+ * Production agent: one bccli runtime per ACP session. Permission questions go to the editor
+ * (session/request_permission); `allowAll` skips them and runs everything unasked.
+ */
+export declare function runtimeAgent(cwd: string, allowAll?: boolean): AcpAgent;