@mekareteriker/opencode-mcp 1.10.2-mekareteriker.0

package/CHANGELOG.md

@@ -0,0 +1,204 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Fork notation: entries tagged `[upstream]` were cherry-picked or carried forward from
+[AlaeddineMessadi/opencode-mcp](https://github.com/AlaeddineMessadi/opencode-mcp).
+Entries tagged `[fork]` are specific to `@mekareteriker/opencode-mcp`.
+
+## [1.10.2-mekareteriker.0] - 2026-05-16
+
+First release of the `@mekareteriker/opencode-mcp` fork. Re-publishes upstream `main` HEAD
+(three commits sitting unreleased on master since `v1.10.1`, including the critical
+Windows path fix), adds CI matrix for Linux/Windows/macOS, and changes nothing about
+the wire protocol or tool surface — drop-in replacement for `opencode-mcp@1.10.1`.
+
+### Fixed
+
+- `[upstream]` Accept Windows absolute paths in `normalizeDirectory` ([upstream commit `e8e6cfe`](https://github.com/AlaeddineMessadi/opencode-mcp/commit/e8e6cfe), [PR #6](https://github.com/AlaeddineMessadi/opencode-mcp/pull/6) by [@samuelgudi](https://github.com/samuelgudi)). Previously the validator required the resolved path to start with `"/"`, which broke every tool that accepts `directory` on Windows clients. Now uses platform-aware `path.isAbsolute`.
+
+### Added
+
+- `[upstream]` `OPENCODE_SERVE_ARGS` env var for passing custom args to `opencode serve` ([upstream commit `0f1e1f6`](https://github.com/AlaeddineMessadi/opencode-mcp/commit/0f1e1f6), PR #7/#9).
+- `[upstream]` `variant` parameter for model selection in tools ([upstream commit `4756a36`](https://github.com/AlaeddineMessadi/opencode-mcp/commit/4756a36), PR #8/#10).
+- `[fork]` GitHub Actions CI: matrix `os: [ubuntu-latest, windows-latest, macos-latest]` × `node: [18, 20, 22]`, plus an npm-pack smoke job.
+- `[fork]` `release.yml` workflow: publishes to npm on `v*` tag push with provenance.
+- `[fork]` `sync-upstream.yml` workflow: daily cron mirrors upstream `main` into `upstream-tracking` branch and opens an issue if new commits land.
+- `[fork]` `publishConfig.access: "public"` so the scoped package publishes without an extra `--access` flag.
+
+### Changed
+
+- `[fork]` Package name: `opencode-mcp` → `@mekareteriker/opencode-mcp`.
+- `[fork]` `repository`/`homepage`/`bugs` URLs now point at `MekaretEriker/opencode-mcp`.
+- `[fork]` `postbuild` script guards `chmod +x` with `|| true` so it doesn't fail on Windows runners (no chmod).
+- `[fork]` LICENSE: dual copyright line preserving Alaeddine Messadi's original attribution alongside the fork maintainer's.
+- `[fork]` Tests `tests/helpers.test.ts`, `tests/client.test.ts`, `tests/tools.test.ts` — hardcoded `/tmp` replaced by `os.tmpdir()` so the suite is platform-agnostic and Windows CI runner can pass. Addresses the "13 Linux-only failures" called out in upstream commit `e8e6cfe`. See `SPEC-fork.md` §4 patch #5.
+
+### Patches pending upstream
+
+- The `os.tmpdir()` test fix above is fork-only for now. Will submit to upstream as a PR; if merged it drops from the fork on the next rebase.
+
+## [1.10.1] - 2026-04-10
+
+### Changed
+
+- Instruction examples now use discovered/default provider and model values instead of hardcoded Anthropic examples. This avoids steering MCP clients toward unavailable providers and aligns the startup guidance with `opencode_setup`.
+
+### Fixed
+
+- Health checks for authenticated OpenCode servers now propagate HTTP basic auth through the full auto-start path, including startup polling and reconnection flows.
+- `ensureServer()` now forwards configured server credentials during startup so remote protected servers no longer fail the health probe while coming online.
+
+### Stats
+
+- Tool count: 79
+- Tests: 320
+
+## [1.10.0] - 2026-02-10
+
+### Added
+
+- **`opencode_permission_list` tool** — lists all pending permission requests across sessions, showing permission type, session ID, patterns, and tool name. Helps detect and unblock sessions stuck waiting for approval in headless mode.
+- **`OPENCODE_DEFAULT_PROVIDER` / `OPENCODE_DEFAULT_MODEL` env vars** — set default provider and model for all tool calls. Three-tier resolution: explicit params → env defaults → server fallback. Implemented via `applyModelDefaults()` across all 8 model-accepting tools.
+- **`normalizeDirectory()` path validation** — resolves paths to absolute, strips trailing slashes, resolves `..`, and rejects non-existent directories with descriptive errors.
+- **Lazy server reconnection** — on `ECONNREFUSED`/`ENOTFOUND` after all retries, auto-restarts the OpenCode server (max 3 reconnection attempts per MCP session).
+- **Enhanced `diagnoseError()`** — 6 new error patterns with contextual suggestions (empty response, model errors, permission issues, config problems).
+- **Directory display in workflow responses** — `opencode_run`, `opencode_fire`, `opencode_check`, `opencode_status` now show the active project directory.
+- **Session-directory consistency warnings** — warns when a session was created for a different directory than the current request.
+- **Permissions guidance in instructions** — recommends `"permission": "allow"` in `opencode.json` for headless use, documents permission tools.
+
+### Changed
+
+- **`opencode_session_permission` updated** — now uses the new API (`POST /permission/{requestID}/reply`) with automatic fallback to the deprecated endpoint. `reply` parameter changed from free string to enum: `"once"` | `"always"` | `"reject"`. Removed the old `remember` parameter.
+
+### Fixed
+
+- **Directory validation errors swallowed by `.catch(() => null)`** — `opencode_status`, `opencode_context`, and `opencode_check` used `Promise.all` with `.catch(() => null)` which silently ate validation errors (showing "UNREACHABLE" instead of "directory not found"). Fixed by adding early `normalizeDirectory()` before `Promise.all` in all 3 tools.
+
+### Removed
+
+- Demo projects (`projects/snake-game/`, `projects/nextjs-todo-app/`) — these were test artifacts.
+
+### Stats
+
+- Tool count: 79 (up from 78)
+- Tests: 316 (up from 275)
+
+## [1.9.0] - 2026-02-10
+
+### Added
+
+- **`opencode_run` workflow tool** — one-call solution for complex tasks: creates a session, sends the prompt, polls until completion, and returns the result with todo progress. Supports `maxDurationSeconds` (default 10 min) and session reuse via `sessionId`.
+- **`opencode_fire` workflow tool** — fire-and-forget: creates a session, dispatches the task, and returns immediately with the session ID and monitoring instructions. Best for long-running tasks where you want to do other work in parallel.
+- **`opencode_check` workflow tool** — compact progress report for a session: status, todo progress (completed/total), current task, file change count. Much cheaper than `opencode_conversation`. Supports `detailed` mode for last message text.
+- Tool count: 78 (up from 75)
+- Tests: 275 (up from 267) — 8 new tests covering `opencode_run` (polling, error, session reuse), `opencode_fire` (dispatch, session reuse), and `opencode_check` (progress, completion, detailed mode)
+
+### Changed
+
+- Instructions updated with new Tier 2 tools (`opencode_run`, `opencode_fire`, `opencode_check`) and simplified recommended workflows
+- Best-practices prompt updated with new tool selection table
+
+## [1.8.0] - 2026-02-10
+
+### Added
+
+- **`instructions` field** — the MCP server now provides a comprehensive structured guide via the `instructions` option in the `McpServer` constructor. This helps LLM clients understand tool tiers (5 levels from essential to dangerous), recommended workflows, and the async `message_send_async` + `wait` pattern for long tasks.
+- **Tool annotations** — all tools now carry MCP `readOnlyHint` / `destructiveHint` annotations so clients can auto-approve safe read-only operations and warn before destructive ones (e.g. `session_delete`, `instance_dispose`)
+- **`opencode-best-practices` prompt** — new prompt template (6th prompt) covering setup, provider/model selection, tool selection table, prompt writing tips, monitoring, error recovery, and common pitfalls
+- **Honest wake-up documentation** — `opencode_wait` description now explains that most MCP clients do NOT interrupt the LLM for log notifications, and suggests `opencode_session_todo` for monitoring very long tasks
+
+### Changed
+
+- `opencode_instance_dispose` description now includes a WARNING about permanent shutdown
+- Prompts: 6 (up from 5)
+- Tests: 267 (up from 266)
+
+## [1.6.0] - 2026-02-09
+
+### Fixed
+
+- **Empty message display** — `formatMessageList()` no longer shows blank output for assistant messages that performed tool calls but had no text content. It now shows concise tool action summaries like `Agent performed 3 action(s): Write: /src/App.tsx, Bash: npm install`
+- **Session status `[object Object]`** — `opencode_sessions_overview` and `opencode_session_status` now correctly resolve status objects (e.g. `{ state: "running" }`) to readable strings instead of displaying `[object Object]`
+- **`opencode_wait` timeout message** — now includes actionable recovery suggestions (`opencode_conversation` to check progress, `opencode_session_abort` to stop) and correctly resolves object-shaped status values during polling
+- **`toolError()` contextual suggestions** — common error patterns (401/403 auth, timeout, rate limit, connection refused, session not found) now include helpful follow-up tool suggestions instead of bare error text
+
+### Added
+
+- `resolveSessionStatus()` exported helper in `src/helpers.ts` — normalizes status from string, object (`{ state, status, type }`), or boolean flags into a readable string
+- `summarizeToolInput()` helper — extracts the most useful arg (path, command, query, url) from tool input objects for compact display
+- `extractCostMeta()` helper — extracts cost/token metadata from `step-finish` message parts
+- `diagnoseError()` private helper — pattern-matches common errors and returns contextual suggestions
+- 11 new tool handler tests for `opencode_sessions_overview`, `opencode_session_status`, and `opencode_wait` covering object status resolution, timeout messages, and edge cases
+- Tests: 266 total (up from 255)
+
+## [1.5.0] - 2026-02-09
+
+### Added
+
+- `opencode_status` workflow tool for a fast health/providers/sessions/VCS dashboard
+- `opencode_provider_test` workflow tool to quickly validate a provider/model actually responds (creates a temp session, sends a tiny prompt, cleans up)
+- `opencode_session_search` to find sessions by keyword in title (also matches session ID)
+- `scripts/mcp-smoke-test.mjs` end-to-end smoke test runner (spawns opencode-mcp over stdio and exercises most tools/workflows against a running OpenCode server)
+
+### Changed
+
+- Provider configuration detection is now shared via `isProviderConfigured()` (used consistently across provider listing and setup workflows)
+- Multiple tool outputs are more token-efficient and user-friendly (compact provider list/model listing, session formatting, and warning surfacing)
+- Tool count: 75 (up from 72)
+- Tests: 255 total
+
+### Fixed
+
+- `opencode_message_send` no longer silently returns empty output for empty responses; it now appends actionable warnings like `opencode_ask`/`opencode_reply`
+- `opencode_session_share` / `opencode_session_unshare` now return formatted confirmations instead of raw JSON dumps
+- `opencode_events_poll` no longer crashes on timeout when the SSE stream is idle (abort now cancels the stream safely)
+
+## [1.4.0] - 2025-02-09
+
+### Added
+
+- **Auth error detection** — `opencode_ask` and `opencode_reply` now analyze AI responses for signs of failure (empty response, missing text content, error keywords like "unauthorized" or "invalid key") and append a clear `--- WARNING ---` with actionable guidance instead of silently returning nothing
+- **`analyzeMessageResponse()` helper** — new diagnostic function in `src/helpers.ts` that detects empty, error, and auth-related response issues
+- **Provider probing in `opencode_setup`** — connected providers are now verified with a lightweight "Reply with OK" probe to distinguish between WORKING, CONNECTED BUT NOT RESPONDING (bad API key), and could-not-verify states. Unconfigured providers now show available auth methods.
+- **`opencode_provider_models` tool** — new tool to list models for a single provider, replacing the previous approach of dumping all providers and all models in one massive response
+- **164 tests** (up from 140) — new tests for `analyzeMessageResponse`, auth warning in ask/reply, provider probe statuses, compact provider list, and per-provider model listing
+
+### Changed
+
+- **`opencode_provider_list` is now compact** — returns only provider names, connection status, and model count (not the full model list). This dramatically reduces token usage for MCP clients. Use `opencode_provider_models` with a provider ID to drill into a specific provider's models.
+- Tool count: 72 (up from 71)
+
+## [1.3.0] - 2025-02-08
+
+### Added
+
+- **Auto-serve** — the MCP server now automatically detects whether `opencode serve` is running and starts it as a child process if not. No more manual "start opencode serve" step before using the MCP server.
+  - Checks the `/global/health` endpoint on startup
+  - Finds the `opencode` binary via `which`/`where`
+  - Spawns `opencode serve --port <port>` and polls until healthy
+  - Graceful shutdown: kills the managed child process on SIGINT/SIGTERM/exit
+  - Clear error messages with install instructions if the binary is not found
+- **`OPENCODE_AUTO_SERVE` env var** — set to `"false"` to disable auto-start for users who prefer manual control
+- **`src/server-manager.ts` module** — new module with `findBinary()`, `isServerRunning()`, `startServer()`, `stopServer()`, `ensureServer()`
+- **140 tests** (up from 117) — 23 new tests for the server manager covering health checks, binary detection, auto-start, error cases, and shutdown
+
+### Changed
+
+- Startup flow in `src/index.ts` now calls `ensureServer()` before connecting the MCP transport
+- Updated README: removed manual "start opencode serve" step, added auto-serve documentation, updated env vars table and architecture section
+
+## [1.2.0] - 2025-02-08
+
+### Added
+
+- **Per-tool project directory targeting** — every tool now accepts an optional `directory` parameter that scopes the request to a specific project directory via the `x-opencode-directory` header. This enables working with multiple projects simultaneously from a single MCP connection without restarting the server.
+- **`opencode_setup` workflow tool** — new high-level onboarding tool that checks server health, lists provider configuration status, and shows project info. Use it as the first step when starting work.
+- **117 tests** (up from 102) — new tests for directory header propagation, `opencode_setup` handler, and `directoryParam` validation
+
+### Changed
+
+- `opencode_find_file` tool: renamed the search-root override parameter from `directory` to `searchDirectory` to avoid collision with t

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Alaeddine Messadi (upstream author)
+Copyright (c) 2026 Mekaret (fork maintainer)
+
+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/README.md

@@ -0,0 +1,174 @@
+# @mekareteriker/opencode-mcp
+
+[![npm version](https://img.shields.io/npm/v/@mekareteriker/opencode-mcp)](https://www.npmjs.com/package/@mekareteriker/opencode-mcp)
+[![license](https://img.shields.io/github/license/MekaretEriker/opencode-mcp)](https://github.com/MekaretEriker/opencode-mcp/blob/main/LICENSE)
+[![node](https://img.shields.io/node/v/@mekareteriker/opencode-mcp)](https://nodejs.org/)
+[![ci](https://github.com/MekaretEriker/opencode-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/MekaretEriker/opencode-mcp/actions/workflows/ci.yml)
+
+> **This is a hardened fork of [AlaeddineMessadi/opencode-mcp](https://github.com/AlaeddineMessadi/opencode-mcp).**
+> The upstream package is unmaintained on npm (latest release `v1.10.1` is 5+ weeks old and missing a Windows-blocking fix already merged on master). This fork re-publishes upstream `main` HEAD, adds CI for Linux/Windows/macOS, and ships further hardening — structured errors, idempotency, SSE streaming — on a regular release cadence. Drop-in replacement: same wire protocol, same 79 tools.
+>
+> **Patches pending upstream** are tracked in [CHANGELOG.md](./CHANGELOG.md) and submitted upstream as PRs. When upstream merges, we rebase and the patch leaves the fork. We aim to stay as close to upstream as possible.
+
+**Give any MCP client the power of [OpenCode](https://opencode.ai/).**
+
+opencode-mcp is an MCP server that bridges your AI tools (Claude, Cursor, Windsurf, VS Code, etc.) to OpenCode's headless API. It lets your AI delegate real coding work — building features, debugging, refactoring, running tests — to OpenCode sessions that autonomously read, write, and execute code in your project.
+
+**79 tools** | **10 resources** | **6 prompts** | **Multi-project** | **Auto-start** | **Windows-tested**
+
+## Why Use This?
+
+- **Delegate coding tasks** — Tell Claude "build me a REST API" and it delegates to OpenCode, which creates files, installs packages, writes tests, and reports back.
+- **Parallel work** — Fire off multiple tasks to OpenCode while your primary AI keeps working on something else.
+- **Any MCP client** — Works with Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, Cline, Continue, Zed, Amazon Q, and any other MCP-compatible tool.
+- **Zero setup** — The server auto-starts `opencode serve` if it's not already running. No manual steps.
+- **Windows-first CI** — Every release is tested on Linux, Windows, and macOS across Node 18/20/22.
+
+## Quick Start
+
+> **Prerequisite:** [OpenCode](https://opencode.ai/) must be installed.
+> `curl -fsSL https://opencode.ai/install | bash` or `npm i -g opencode-ai` or `brew install sst/tap/opencode`
+
+**Claude Code:**
+
+```bash
+claude mcp add opencode -- npx -y @mekareteriker/opencode-mcp
+```
+
+**Claude Desktop / Cursor / Windsurf / Cline / Continue** (add to your MCP config):
+
+```json
+{
+  "mcpServers": {
+    "opencode": {
+      "command": "npx",
+      "args": ["-y", "@mekareteriker/opencode-mcp"]
+    }
+  }
+}
+```
+
+That's it. Restart your client and OpenCode's tools will be available.
+
+### Migrating from upstream `opencode-mcp`
+
+If you have the upstream package in your MCP config, change `"opencode-mcp"` to `"@mekareteriker/opencode-mcp"` in the `args` array. Nothing else changes — same tool names, same parameters, same behavior. To go back, just swap the name back.
+
+> See [Configuration](docs/configuration.md) for all client configs (VS Code Copilot, Zed, Amazon Q, etc.) and environment variables.
+
+## How It Works
+
+```
+MCP Client  <--stdio-->  opencode-mcp  <--HTTP-->  OpenCode Server
+(Claude, Cursor, etc.)   (this package)            (opencode serve)
+```
+
+Your MCP client calls tools over stdio. This server translates them into HTTP requests to the OpenCode headless API. If the OpenCode server isn't running, it's started automatically.
+
+## Key Tools
+
+The 79 tools are organized into tiers. Start with the workflow tools — they handle the common patterns in a single call.
+
+### Workflow Tools (13) — Start Here
+
+| Tool | What it does |
+|---|---|
+| `opencode_setup` | Check server health, providers, and project status. Use first. |
+| `opencode_ask` | Create session + send prompt + get answer. One call. |
+| `opencode_reply` | Follow-up message in an existing session |
+| `opencode_run` | Send a task and wait for completion (session + async send + polling) |
+| `opencode_fire` | Fire-and-forget: dispatch a task, return immediately |
+| `opencode_check` | Compact progress report for a running session (status, todos, files changed) |
+| `opencode_conversation` | Get formatted conversation history |
+| `opencode_sessions_overview` | Quick overview of all sessions |
+| `opencode_context` | Project + VCS + config + agents in one call |
+| `opencode_review_changes` | Formatted diff summary for a session |
+| `opencode_wait` | Poll an async session until it finishes |
+| `opencode_provider_test` | Quick-test whether a provider is working |
+| `opencode_status` | Health + providers + sessions + VCS dashboard |
+
+### Recommended Patterns
+
+**Quick question:**
+```
+opencode_ask({ prompt: "Explain the auth flow in this project" })
+```
+
+**Build something and wait:**
+```
+opencode_run({ prompt: "Add input validation to POST /api/users", maxDurationSeconds: 300 })
+```
+
+**Parallel background tasks:**
+```
+opencode_fire({ prompt: "Refactor the auth module to use JWT" })
+→ returns sessionId immediately
+opencode_check({ sessionId: "..." })
+→ check progress anytime
+```
+
+### All Tool Categories
+
+| Category | Count | Description |
+|---|---|---|
+| [Workflow](docs/tools.md#workflow-tools) | 13 | High-level composite operations |
+| [Session](docs/tools.md#session-tools) | 20 | Create, list, fork, share, abort, revert, permissions |
+| [Message](docs/tools.md#message-tools) | 6 | Send prompts, execute commands, run shell |
+| [File & Search](docs/tools.md#file--search-tools) | 6 | Search text/regex, find files/symbols, read files |
+| [System](docs/tools.md#system--monitoring-tools) | 13 | Health, VCS, LSP, MCP servers, agents, logging |
+| [TUI Control](docs/tools.md#tui-control-tools) | 9 | Remote-control the OpenCode terminal UI |
+| [Provider & Auth](docs/tools.md#provider--auth-tools) | 6 | List providers/models, set API keys, OAuth |
+| [Config](docs/tools.md#config-tools) | 3 | Get/update configuration |
+| [Project](docs/tools.md#project-tools) | 2 | List and inspect projects |
+| [Events](docs/tools.md#event-tools) | 1 | Poll real-time SSE events |
+
+### Resources (10)
+
+Browseable data endpoints — your client can read these without tool calls:
+
+| URI | Description |
+|---|---|
+| `opencode://project/current` | Current active project |
+| `opencode://config` | Current configuration |
+| `opencode://providers` | Providers with models |
+| `opencode://agents` | Available agents |
+| `opencode://commands` | Available commands |
+| `opencode://health` | Server health and version |
+| `opencode://vcs` | Version control info |
+| `opencode://sessions` | All sessions |
+| `opencode://mcp-servers` | MCP server status |
+| `opencode://file-status` | VCS file status |
+
+### Prompts (6)
+
+Guided workflow templates your client can offer as selectable actions:
+
+| Prompt | Description |
+|---|---|
+| `opencode-code-review` | Review diffs from a session |
+| `opencode-debug` | Step-by-step debugging workflow |
+| `opencode-project-setup` | Get oriented in a new project |
+| `opencode-implement` | Have OpenCode build a feature |
+| `opencode-best-practices` | Setup, tool selection, monitoring, and pitfalls |
+| `opencode-session-summary` | Summarize what happened in a session |
+
+## Multi-Project Support
+
+Every tool accepts an optional `directory` parameter to target a different project. No restarts needed.
+
+```
+opencode_ask({ directory: "/home/user/mobile-app", prompt: "Add navigation" })
+opencode_ask({ directory: "/home/user/web-app", prompt: "Add auth" })
+```
+
+## Environment Variables
+
+All optional. Only needed if you've changed defaults on the OpenCode server.
+
+| Variable | Default | Description |
+|---|---|---|
+| `OPENCODE_BASE_URL` | `http://127.0.0.1:4096` | OpenCode server URL |
+| `OPENCODE_SERVER_USERNAME` | `opencode` | HTTP basic auth username |
+| `OPENCODE_SERVER_PASSWORD` | *(none)* | HTTP basic auth password (enables auth when set) |
+| `OPENCODE_AUTO_SERVE` | `true` | Auto-start `opencode serve` if not running |
+| `OPENCODE_DEFAULT_PROVIDER` | *(none)* | Default provider ID when not specified p

package/dist/client.d.ts

@@ -0,0 +1,60 @@
+/**
+ * HTTP client wrapper for the OpenCode server API.
+ *
+ * Features:
+ *  - Basic auth support
+ *  - Automatic retry with exponential backoff for transient errors
+ *  - Proper 204 No Content handling on all methods
+ *  - SSE streaming support
+ *  - Error categorization (transient vs permanent)
+ *  - Directory path normalization and validation
+ *  - Lazy server reconnection on connection failure
+ */
+export interface OpenCodeClientOptions {
+    baseUrl: string;
+    username?: string;
+    password?: string;
+    /** Enable lazy server reconnection when connection fails. */
+    autoServe?: boolean;
+}
+export declare class OpenCodeError extends Error {
+    readonly status: number;
+    readonly method: string;
+    readonly path: string;
+    readonly body: string;
+    constructor(message: string, status: number, method: string, path: string, body: string);
+    get isTransient(): boolean;
+    get isNotFound(): boolean;
+    get isAuth(): boolean;
+}
+export declare class OpenCodeClient {
+    private baseUrl;
+    private authHeader?;
+    private autoServe;
+    private reconnectAttempts;
+    private username?;
+    private password?;
+    constructor(options: OpenCodeClientOptions);
+    getBaseUrl(): string;
+    private buildUrl;
+    private headers;
+    private request;
+    get<T = unknown>(path: string, query?: Record<string, string>, directory?: string): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown, opts?: {
+        timeout?: number;
+        directory?: string;
+    }): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown, directory?: string): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown, directory?: string): Promise<T>;
+    delete<T = unknown>(path: string, query?: Record<string, string>, directory?: string): Promise<T>;
+    /**
+     * Subscribe to SSE events. Returns an async iterable of parsed events.
+     * The caller should break out of the loop when done.
+     */
+    subscribeSSE(path: string, opts?: {
+        signal?: AbortSignal;
+    }): AsyncGenerator<{
+        event: string;
+        data: string;
+    }, void, undefined>;
+}