@agentproto/adapter-opencode 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agentproto contributors
+
+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/OPENCODE.md

@@ -0,0 +1,93 @@
+---
+name: opencode
+id: opencode
+description: sst/opencode — open-source coding agent with first-party ACP mode. Spawned as `npx -y opencode-ai acp`, drives the agent over stdio JSON-RPC. Multi-provider (Anthropic, OpenAI, Groq, OpenRouter, OpenCode-hosted, …) — operator picks the underlying model via env-keyed provider auth.
+version: 0.1.0
+bin: npx
+bin_args: ["-y", "opencode-ai", "acp"]
+install:
+  - method: npm
+    package: opencode-ai
+    global: true
+  - method: curl
+    url: https://opencode.ai/install
+version_check:
+  cmd: npm view opencode-ai version
+  parse: "(\\d+\\.\\d+\\.\\d+)"
+  range: ">=1.0.0"
+  timeout_ms: 15000
+auth:
+  ref: ./SECRETS.md
+  state:
+    env: [OPENCODE_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY, GROQ_API_KEY]
+sandbox: ./SANDBOX.md
+protocol: acp
+acp: ./opencode-acp.ACP.md
+session:
+  mode: persistent
+  idle_timeout_ms: 1800000
+  context_carryover: true
+models:
+  default: anthropic/claude-sonnet-4-6
+  allowed:
+    - anthropic/claude-sonnet-4-6
+    - anthropic/claude-opus-4-7
+    - anthropic/claude-haiku-4-5
+    - openai/gpt-5
+    - openai/gpt-5-mini
+    - openrouter/anthropic/claude-sonnet-4-6
+  env:
+    anthropic: ANTHROPIC_API_KEY
+    openai: OPENAI_API_KEY
+    openrouter: OPENROUTER_API_KEY
+    opencode: OPENCODE_API_KEY
+    groq: GROQ_API_KEY
+capabilities:
+  streaming: true
+  tool_calls: true
+  sub_agents: false
+  file_io: true
+  multimodal: true
+  resumable: true
+  bidirectional: true
+tags: ["opencode", "sst", "acp", "agent-runtime", "coding"]
+---
+
+# OpenCode adapter
+
+`@agentproto/adapter-opencode` wraps **sst/opencode** as an AIP-45 agent
+CLI. OpenCode ships its own ACP server — no third-party wrapper is
+needed; the adapter spawns `npx -y opencode-ai acp` and drives the
+agent over stdio JSON-RPC.
+
+## Why OpenCode
+
+- Multi-provider (Anthropic, OpenAI, OpenRouter, Groq, OpenCode hosted)
+- First-party ACP mode (vs claude-code which needs a wrapper)
+- MIT-licensed, broad community plugin surface
+
+## Install
+
+```bash
+# npm (global)
+npm install -g opencode-ai
+
+# or curl bootstrap
+curl -fsSL https://opencode.ai/install | bash
+```
+
+The npx form `npx -y opencode-ai acp` works without a global install
+— the adapter prefers this for ephemeral / sandboxed spawns.
+
+## Auth
+
+OpenCode reads provider keys from the environment. Set whichever
+provider the operator's `models.default` is pinned to:
+
+| Provider     | Env var               |
+|--------------|-----------------------|
+| Anthropic    | `ANTHROPIC_API_KEY`   |
+| OpenAI       | `OPENAI_API_KEY`      |
+| OpenRouter   | `OPENROUTER_API_KEY`  |
+| Groq         | `GROQ_API_KEY`        |
+| OpenCode SaaS| `OPENCODE_API_KEY`    |

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { AgentCliHandle, AgentCliRuntime } from '@agentproto/driver-agent-cli';
+export { AgentCliHandle, AgentCliRuntime } from '@agentproto/driver-agent-cli';
+
+/**
+ * @agentproto/adapter-opencode — AIP-45 adapter for sst/opencode.
+ *
+ * OpenCode ships first-party ACP support (`opencode acp`) so no
+ * third-party wrapper is needed. We spawn it via `npx -y opencode-ai
+ * acp` and drive it over stdio JSON-RPC the same way the claude-code
+ * adapter drives @agentclientprotocol/claude-agent-acp.
+ *
+ *   import { opencode, opencodeRuntime } from "@agentproto/adapter-opencode"
+ *   const session = await opencodeRuntime().start({
+ *     env: { ANTHROPIC_API_KEY: "sk-..." },
+ *   })
+ *   for await (const evt of session.send({ role: "user", content: "..." })) {
+ *     console.log(evt)
+ *   }
+ *   await session.close()
+ */
+
+declare const opencode: AgentCliHandle;
+declare function opencodeRuntime(): AgentCliRuntime;
+
+export { opencode, opencodeRuntime };

package/dist/index.mjs

@@ -0,0 +1,116 @@
+import { defineAgentCli, createAgentCliRuntime } from '@agentproto/driver-agent-cli';
+
+/**
+ * @agentproto/adapter-opencode v0.1.0-alpha
+ * AIP-45 adapter for sst/opencode via its built-in `opencode acp` mode.
+ */
+
+var opencode = defineAgentCli({
+  name: "opencode",
+  id: "opencode",
+  description: "sst/opencode \u2014 open-source coding agent with first-party ACP mode. Spawned via `npx -y opencode-ai acp` and driven over stdio JSON-RPC. Multi-provider (Anthropic / OpenAI / OpenRouter / Groq / OpenCode hosted).",
+  version: "0.1.0",
+  bin: "npx",
+  bin_args: ["-y", "opencode-ai", "acp"],
+  install: [
+    { method: "npm", package: "opencode-ai", global: true },
+    { method: "curl", url: "https://opencode.ai/install" }
+  ],
+  version_check: {
+    cmd: "npm view opencode-ai version",
+    parse: "(\\d+\\.\\d+\\.\\d+)",
+    range: ">=1.0.0",
+    timeout_ms: 15e3
+  },
+  auth: {
+    ref: "./SECRETS.md",
+    state: {
+      env: [
+        "OPENCODE_API_KEY",
+        "ANTHROPIC_API_KEY",
+        "OPENAI_API_KEY",
+        "OPENROUTER_API_KEY",
+        "GROQ_API_KEY"
+      ]
+    }
+  },
+  sandbox: "./SANDBOX.md",
+  protocol: "acp",
+  acp: "./opencode-acp.ACP.md",
+  session: {
+    mode: "persistent",
+    idle_timeout_ms: 18e5,
+    context_carryover: true
+  },
+  models: {
+    default: "anthropic/claude-sonnet-4-6",
+    allowed: [
+      "anthropic/claude-sonnet-4-6",
+      "anthropic/claude-opus-4-7",
+      "anthropic/claude-haiku-4-5",
+      "openai/gpt-5",
+      "openai/gpt-5-mini",
+      "openrouter/anthropic/claude-sonnet-4-6"
+    ],
+    env: {
+      anthropic: "ANTHROPIC_API_KEY",
+      openai: "OPENAI_API_KEY",
+      openrouter: "OPENROUTER_API_KEY",
+      opencode: "OPENCODE_API_KEY",
+      groq: "GROQ_API_KEY"
+    }
+  },
+  capabilities: {
+    streaming: true,
+    tool_calls: true,
+    sub_agents: false,
+    file_io: true,
+    // OpenCode forwards ACP image content blocks to the underlying
+    // provider (Anthropic Messages API for Claude models, OpenAI vision
+    // for GPT-5). Hosts SHOULD send `{type: "image", data, mimeType}`
+    // blocks alongside text in `session.send`.
+    multimodal: true,
+    // OpenCode persists session state internally and the ACP server
+    // implements newSession/loadSession/resumeSession. Pair with the
+    // `native-resume` continuation strategy for cold-start reattach.
+    resumable: true,
+    bidirectional: true
+  },
+  modes: [
+    { id: "default", description: "Standard interactive mode." },
+    {
+      id: "plan",
+      description: "Plan-only mode \u2014 reasoning + proposals, no edits or shell calls.",
+      bin_args_append: ["--mode", "plan"]
+    },
+    {
+      id: "build",
+      description: "Auto-execute mode \u2014 file edits and shell commands run without per-step prompts.",
+      bin_args_append: ["--mode", "build"]
+    }
+  ],
+  options: [
+    {
+      id: "model",
+      type: "string",
+      description: "Provider/model override for this operator binding (e.g. `openrouter/anthropic/claude-sonnet-4-6`).",
+      bin_args_template: ["--model", "{value}"]
+    }
+  ],
+  continuation: {
+    default: "native-resume",
+    supported: ["native-resume", "pinned-session", "transcript", "none"],
+    pinned_session: {
+      idle_timeout_ms: 18e5,
+      key_scope: ["conversation", "operator"]
+    }
+  },
+  tags: ["opencode", "sst", "acp", "agent-runtime", "coding"]
+});
+function opencodeRuntime() {
+  return createAgentCliRuntime(opencode);
+}
+
+export { opencode, opencodeRuntime };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * @agentproto/adapter-opencode — AIP-45 adapter for sst/opencode.\n *\n * OpenCode ships first-party ACP support (`opencode acp`) so no\n * third-party wrapper is needed. We spawn it via `npx -y opencode-ai\n * acp` and drive it over stdio JSON-RPC the same way the claude-code\n * adapter drives @agentclientprotocol/claude-agent-acp.\n *\n *   import { opencode, opencodeRuntime } from \"@agentproto/adapter-opencode\"\n *   const session = await opencodeRuntime().start({\n *     env: { ANTHROPIC_API_KEY: \"sk-...\" },\n *   })\n *   for await (const evt of session.send({ role: \"user\", content: \"...\" })) {\n *     console.log(evt)\n *   }\n *   await session.close()\n */\n\nimport {\n  createAgentCliRuntime,\n  defineAgentCli,\n  type AgentCliHandle,\n  type AgentCliRuntime,\n} from \"@agentproto/driver-agent-cli\"\n\nexport const opencode: AgentCliHandle = defineAgentCli({\n  name: \"opencode\",\n  id: \"opencode\",\n  description:\n    \"sst/opencode — open-source coding agent with first-party ACP mode. Spawned via `npx -y opencode-ai acp` and driven over stdio JSON-RPC. Multi-provider (Anthropic / OpenAI / OpenRouter / Groq / OpenCode hosted).\",\n  version: \"0.1.0\",\n  bin: \"npx\",\n  bin_args: [\"-y\", \"opencode-ai\", \"acp\"],\n  install: [\n    { method: \"npm\", package: \"opencode-ai\", global: true },\n    { method: \"curl\", url: \"https://opencode.ai/install\" },\n  ],\n  version_check: {\n    cmd: \"npm view opencode-ai version\",\n    parse: \"(\\\\d+\\\\.\\\\d+\\\\.\\\\d+)\",\n    range: \">=1.0.0\",\n    timeout_ms: 15_000,\n  },\n  auth: {\n    ref: \"./SECRETS.md\",\n    state: {\n      env: [\n        \"OPENCODE_API_KEY\",\n        \"ANTHROPIC_API_KEY\",\n        \"OPENAI_API_KEY\",\n        \"OPENROUTER_API_KEY\",\n        \"GROQ_API_KEY\",\n      ],\n    },\n  },\n  sandbox: \"./SANDBOX.md\",\n  protocol: \"acp\",\n  acp: \"./opencode-acp.ACP.md\",\n  session: {\n    mode: \"persistent\",\n    idle_timeout_ms: 1_800_000,\n    context_carryover: true,\n  },\n  models: {\n    default: \"anthropic/claude-sonnet-4-6\",\n    allowed: [\n      \"anthropic/claude-sonnet-4-6\",\n      \"anthropic/claude-opus-4-7\",\n      \"anthropic/claude-haiku-4-5\",\n      \"openai/gpt-5\",\n      \"openai/gpt-5-mini\",\n      \"openrouter/anthropic/claude-sonnet-4-6\",\n    ],\n    env: {\n      anthropic: \"ANTHROPIC_API_KEY\",\n      openai: \"OPENAI_API_KEY\",\n      openrouter: \"OPENROUTER_API_KEY\",\n      opencode: \"OPENCODE_API_KEY\",\n      groq: \"GROQ_API_KEY\",\n    },\n  },\n  capabilities: {\n    streaming: true,\n    tool_calls: true,\n    sub_agents: false,\n    file_io: true,\n    // OpenCode forwards ACP image content blocks to the underlying\n    // provider (Anthropic Messages API for Claude models, OpenAI vision\n    // for GPT-5). Hosts SHOULD send `{type: \"image\", data, mimeType}`\n    // blocks alongside text in `session.send`.\n    multimodal: true,\n    // OpenCode persists session state internally and the ACP server\n    // implements newSession/loadSession/resumeSession. Pair with the\n    // `native-resume` continuation strategy for cold-start reattach.\n    resumable: true,\n    bidirectional: true,\n  },\n  modes: [\n    { id: \"default\", description: \"Standard interactive mode.\" },\n    {\n      id: \"plan\",\n      description:\n        \"Plan-only mode — reasoning + proposals, no edits or shell calls.\",\n      bin_args_append: [\"--mode\", \"plan\"],\n    },\n    {\n      id: \"build\",\n      description:\n        \"Auto-execute mode — file edits and shell commands run without per-step prompts.\",\n      bin_args_append: [\"--mode\", \"build\"],\n    },\n  ],\n  options: [\n    {\n      id: \"model\",\n      type: \"string\",\n      description:\n        \"Provider/model override for this operator binding (e.g. `openrouter/anthropic/claude-sonnet-4-6`).\",\n      bin_args_template: [\"--model\", \"{value}\"],\n    },\n  ],\n  continuation: {\n    default: \"native-resume\",\n    supported: [\"native-resume\", \"pinned-session\", \"transcript\", \"none\"],\n    pinned_session: {\n      idle_timeout_ms: 1_800_000,\n      key_scope: [\"conversation\", \"operator\"],\n    },\n  },\n  tags: [\"opencode\", \"sst\", \"acp\", \"agent-runtime\", \"coding\"],\n})\n\nexport function opencodeRuntime(): AgentCliRuntime {\n  return createAgentCliRuntime(opencode)\n}\n\nexport type { AgentCliHandle, AgentCliRuntime }\n"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@agentproto/adapter-opencode",
+  "version": "0.1.0-alpha.0",
+  "description": "@agentproto/adapter-opencode — AIP-45 AGENT-CLI adapter for sst/opencode. Spawns `opencode acp` (via npx -y opencode-ai) and drives OpenCode as an agentproto agent CLI over stdio JSON-RPC.",
+  "keywords": [
+    "agentproto",
+    "aip-45",
+    "opencode",
+    "sst",
+    "acp",
+    "agent-cli",
+    "adapter"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-45",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "adapters/opencode"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./OPENCODE.md": "./OPENCODE.md",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "OPENCODE.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agentproto/driver-agent-cli": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@agentproto/tooling": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}