@botconnector/bccli 0.5.0-rc.4 → 0.5.0

package/cli.mjs

@@ -3,9 +3,10 @@ import { readFileSync } from 'node:fs'
 import { DEFAULT_MODEL, assertCandidateRuntimeSupported, discoverModels, launchQwen, parseArgs, resolveQwenEntrypoint, resolveTrustedMcpConfig, selectModel } from './core.mjs'
 import { prepareBrandedQwen } from './branding.mjs'
 import { botConnectorCredentialStatus } from './credentials.mjs'
-import { resolveProvider, selectedProvider, providerDefinition } from './providers.mjs'
+import { resolveProvider, selectedProvider, providerDefinition, isConfigured } from './providers.mjs'
 import { runProviderCommand } from './provider-cli.mjs'
 import { startupMenu, autoSelectStartup, PROVIDER_SWITCH_EXIT } from './startup-menu.mjs'
+import { legacyCompatibilityMode, runLegacyCli } from './legacy-compat.mjs'
 
 function help() {
   console.log([
@@ -20,6 +21,10 @@ function help() {
     '  bccli -c [-m MODEL] [prompt]  (resume latest current-project session)',
     '  bccli -r [SESSION_UUID] [-m MODEL]  (native Qwen session picker or specific session)',
     '  bccli auth status  (offline; does not print API key)',
+    '  bccli provider add botconnector  (enter a new Cloud key securely)',
+    '  bccli provider remove botconnector  (remove only the newly saved key)',
+    '  bccli mcp|connect|acp|serve|plugins|completion|stats  (legacy-compatible)',
+    '  bccli -p "task" --output-format json|stream-json  (legacy-compatible)',
     '  bccli provider list|add|use|remove [ID]  (manage provider keys)',
     '  bccli models --provider ID  (list models for provider)',
     '  bccli chat --provider ID --model MODEL_ID',
@@ -27,9 +32,9 @@ function help() {
     '  bccli --choose  (open provider/model picker explicitly)',
     '  During chat: /provider or /auth to reopen provider and key picker.',
     '',
-    'Credentials: existing BotConnector login or encrypted per-user provider API keys (Windows).',
+    'Credentials: hidden in-terminal input; Windows DPAPI encrypted per-user storage, or existing login/env.',
     'Provider choices: botconnector, openai, openrouter, deepseek, groq, xai.',
-    'Key entry: bccli provider add openrouter (hidden terminal prompt).',
+    'Key entry: bccli --choose or bccli provider add botconnector (hidden terminal prompt).',
     'Model choice: --model; BotConnector defaults to ling-3.0-flash. Other providers need --model.',
     'Security: allowlisted provider endpoints, ephemeral local token, --bare and default approvals.',
     'MCP: explicit JSON only, directly under ~/.bccli-preview/ (no project configs).',
@@ -40,6 +45,7 @@ function help() {
 
 async function main() {
   const argv = process.argv.slice(2)
+  if (legacyCompatibilityMode(argv)) return runLegacyCli(argv)
   if (argv.length === 0 && !process.stdin.isTTY) { help(); return 2 }
   if (argv[0] === '--help' || argv[0] === '-h' || argv[0] === 'help') { help(); return 0 }
   if (argv.length === 1 && (argv[0] === '--version' || argv[0] === '-v')) {
@@ -53,14 +59,16 @@ async function main() {
   if (args.command === 'provider') return runProviderCommand(args.prompt.trim() ? args.prompt.trim().split(/\s+/) : [])
   if (args.command === 'auth') {
     const status = botConnectorCredentialStatus()
-    if (status.configured) {
+    if (isConfigured('botconnector')) {
       console.log('BotConnector credential configured via ' +
-        (status.source === 'environment' ? 'BOTCONNECTOR_API_KEY environment variable.' : 'existing public BCCLI bc-cloud login.') +
+        (status.configured
+          ? (status.source === 'environment' ? 'BOTCONNECTOR_API_KEY environment variable.' : 'existing public BCCLI bc-cloud login or new protected BCCLI key.')
+          : 'protected BCCLI provider storage.') +
         ' Not verified online. No AI request was sent.')
       return 0
     }
     console.error('BotConnector credential not configured or unreadable. ' +
-      'Use the existing legacy login via "bccli-legacy login bc-cloud" or set BOTCONNECTOR_API_KEY. ' +
+      'Run "bccli provider add botconnector" or set BOTCONNECTOR_API_KEY. ' +
       'No credential was changed and no AI request was sent.')
     return 1
   }

package/legacy/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BotConnector
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/legacy/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/legacy/README.md

@@ -0,0 +1,250 @@
+# BCCLI
+
+**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
+# 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
+```
+
+## Pemakaian
+
+| Perintah | Fungsi |
+|---|---|
+| `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 |
+| `bccli models` | daftar model |
+
+Perintah di dalam sesi (ketik `/` untuk saran, ↑↓ pilih, Enter jalankan):
+
+| Perintah | Fungsi |
+|---|---|
+| `/help` | daftar perintah dan pintasan |
+| `/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 |
+| `/logout` | hapus API key provider aktif |
+| `/clear` | mulai percakapan baru |
+| `/compact` | ringkas percakapan |
+| `/cost` | pemakaian token sesi ini |
+| `/exit` | keluar |
+
+`/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:
+
+| Id | Provider |
+|---|---|
+| `bc-cloud` | BotConnector Cloud (default) |
+| `openrouter` | OpenRouter |
+| `openai` | OpenAI |
+| `gemini` | Google Gemini |
+| `deepseek` | DeepSeek |
+| `groq` | Groq |
+| `ollama-cloud` | Ollama Cloud |
+| `ollama` | Ollama lokal (tanpa key) |
+| `lmstudio` | LM Studio lokal (tanpa key) |
+
+Provider lain yang OpenAI-compatible: pilih **Custom…** di `/provider`, atau
+`bccli provider add corp --url https://corp.example/v1 --name "Corp"`.
+
+`/model` menampilkan model dari **semua** provider yang sudah punya key, dikelompokkan
+per provider; ketik untuk menyaring. Pilihan tersimpan sebagai default.
+
+Reasoning dapat dipilih lewat `bccli --reasoning <auto|off|low|medium|high|max>` atau `/reasoning`.
+**Auto** memakai default model/provider dan BCCLI tidak mengirim override reasoning apa pun. BCCLI tidak
+otomatis menurunkan atau menaikkan reasoning effort. Level manual diteruskan bila kontrak provider/model
+mendukungnya; level yang tidak didukung menghasilkan error yang jelas dan tidak di-downgrade diam-diam.
+
+`.bccli/config.json` di dalam project hanya boleh memilih `model` dan menambah provider baru tanpa API key —
+preference `reasoning` hanya dibaca dari config user `~/.bccli/config.json`, bukan dari repo yang di-clone —
+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:
+
+| Perintah | Fungsi |
+|---|---|
+| `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.
+
+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
+
+- `web_search`: mencari di web tanpa perlu izin. Memakai akun BotConnector Cloud
+  bila ada key, kalau tidak langsung ke Keenable (gratis, tanpa key). Hasilnya
+  judul, URL, dan cuplikan singkat, jadi hemat token.
+- `fetch`: membuka satu URL dari komputer ini (butuh izin per host).
+
+## MCP
+
+`/mcp` (atau `bccli mcp add <nama>`) memasang server dari katalog:
+`playwright`, `context7`, `fetch`, `filesystem`, `git`, `github`. Server remote lain:
+`bccli mcp add nama --url https://…`. Tersimpan di `~/.bccli/mcp.json` (format `mcpServers`
+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`:
+- `explore` — hanya baca & cari, bisa jalan paralel;
+- `general` — semua alat (edit/perintah tetap minta izin);
+- custom — `.bccli/agents/nama.md` atau `.claude/agents/nama.md`:
+
+```markdown
+---
+name: reviewer
+description: review perubahan kode
+tools: [read, grep, glob]
+model: openrouter/qwen/qwen3-coder
+---
+Kamu reviewer kode. Laporkan bug nyata saja.
+```
+
+## Skill & perintah custom
+
+- Skill: folder berisi `SKILL.md` di `~/.bccli/skills/`, `.bccli/skills/`, `~/.claude/skills/`,
+  `.claude/skills/` — dipakai agent otomatis bila cocok, atau `/nama-skill`.
+- Perintah: `commands/nama.md` di folder yang sama → `/nama argumen` (`$ARGUMENTS` diganti argumen).
+
+## Todo & mode plan
+
+Tugas ≥ 3 langkah menampilkan checklist di atas kotak input. Di mode plan (Shift+Tab),
+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`, `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, 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/legacy/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>;