opencommand-plugin 0.0.11 → 0.0.13

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenCommand
+
+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

@@ -1,21 +1,58 @@
-# OpenCommand Plugin
+# OpenCommand
 
-OpenCode plugin for CommandCode. It starts the local OpenCommand proxy, stores CommandCode auth locally, registers the `opencommand` provider, and loads the right model list for the active CommandCode plan.
+OpenCommand is één OpenCode/NPM-plugin voor CommandCode. De plugin registreert de provider `opencommand`, start lokaal een OpenAI-compatible proxy en bundelt die proxy-binaries zelf in het NPM-package.
 
-## Features
+Er is dus geen losse proxy-installatie of lokale repo-checkout meer nodig in OpenCode. De Go-code staat nog wel in `proxy/`, maar alleen als broncode: bij `npm run build:proxy` worden de binaries naar `dist/proxy/` gebouwd en met `opencommand-plugin` gepubliceerd.
 
-- Starts/stops the Go proxy automatically.
-- Ships the proxy binaries in the NPM package for normal OpenCode installs.
-- Uses a dynamic local port and exposes `http://localhost:<port>/v1` to OpenCode.
-- Stores the CommandCode API token locally in `~/.opencommand/opencommand-secrets.json`.
-- Supports `COMMAND_CODE_TOKEN` and `COMMANDCODE_API_KEY` environment overrides.
-- Attempts local browser cookie discovery for CommandCode Studio usage scraping.
-- Registers OpenCode provider `opencommand` using `@ai-sdk/openai-compatible`.
-- Detects the active CommandCode plan and registers the matching OpenCode model list.
+## Huidige structuur
 
-## Auth
+```text
+.
+├── bin/opencode-plugin.js        # OpenCode plugin entrypoint
+├── src/index.ts                  # plugin runtime/provider/proxy manager
+├── proxy/                        # Go source voor de lokale proxy
+├── scripts/build-proxy-binaries.mjs
+├── tests/                        # Jest tests voor plugin/runtime
+├── package.json                  # NPM package: opencommand-plugin
+└── dist/                         # build output, niet getrackt
+```
+
+## Gebruik met OpenCode
+
+Gebruik na publicatie:
+
+```jsonc
+{
+  "plugin": ["opencommand-plugin@latest"],
+  "model": "opencommand/deepseek/deepseek-v4-flash",
+  "small_model": "opencommand/deepseek/deepseek-v4-flash"
+}
+```
+
+Voor een vaste versie kun je `opencommand-plugin@0.0.12` pinnen.
+
+Bij OpenCode-start doet de plugin dit automatisch:
+
+1. kiest de juiste gebundelde proxybinary voor macOS/Linux/Windows;
+2. start de proxy op een lokale poort;
+3. schrijft `~/.opencommand/proxy-config.json` met de actieve URL;
+4. registreert provider `opencommand` met `http://localhost:<port>/v1`;
+5. detecteert het actieve CommandCode-plan en registreert de bijpassende modellen.
+
+OpenCode moet opnieuw worden gestart nadat `opencode.jsonc` of de pluginversie is gewijzigd, want plugin-config wordt bij startup geladen.
+
+## Auth-model
 
-Primary token key:
+Gebruik primair een CommandCode token (`user_...`). Zet secrets niet in gesyncte `opencode.jsonc`.
+
+Prioriteit:
+
+1. inkomende `Authorization: Bearer user_...` requests;
+2. `COMMAND_CODE_TOKEN`;
+3. alias `COMMANDCODE_API_KEY`;
+4. lokale secret `~/.opencommand/opencommand-secrets.json` met sleutel `opencommand.command_code_token`.
+
+Voorbeeld:
 
 ```json
 {
@@ -23,45 +60,125 @@ Primary token key:
 }
 ```
 
-Do not put this token in synced `opencode.jsonc`.
+De plugin maakt `~/.opencommand` met `0700` permissies en schrijft secrets met `0600`. `CC_SESSION_COOKIE` is alleen bedoeld voor CommandCode Studio usage scraping, niet als primaire model-auth.
 
-## Models in v0.0.11
+## Lokale bestanden
 
-The proxy detects the active CommandCode subscription through `/alpha/billing/subscriptions` and filters models:
+OpenCommand gebruikt alleen lokale bestanden buiten de repo:
 
-- Go: open-source models only.
-- Pro: open-source + premium, excluding Opus.
-- Max / Ultra / Teams Pro: open-source + premium including Opus.
+- `~/.opencommand/opencommand-secrets.json` — CommandCode token en optionele Studio-cookie.
+- `~/.opencommand/proxy-config.json` — actieve proxy URL/poort.
+- `~/.opencommand/model-cache.json` — laatst bekende plan/model-lijst.
+
+Voorbeeld `proxy-config.json`:
+
+```json
+{
+  "url": "http://localhost:3000",
+  "port": 3000,
+  "updatedAt": "2026-05-19T20:00:00.000Z"
+}
+```
 
-If detection fails, the plugin falls back to the local proxy model endpoint and then to the Go/open-source model list.
+## Browser-cookie extractie
 
-## Build
+Voor usage scraping kan de plugin op macOS proberen een CommandCode Studio-cookie te vinden in Chrome, Comet, Brave, Edge of Firefox. Gevonden cookies worden lokaal opgeslagen als:
+
+```json
+{
+  "opencommand.cc_session_cookie": "..."
+}
+```
+
+Cookie-waarden worden niet gelogd en niet in `opencode.jsonc` opgeslagen.
+
+## Model-detectie per plan
+
+De proxy/plugin vraagt `/alpha/billing/subscriptions` op en filtert modellen per plan:
+
+- `individual-go`: open-source modellen.
+- `individual-pro`: open-source + premium, zonder Opus.
+- `individual-max`, `individual-ultra`, `teams-pro`: open-source + premium inclusief Opus.
+
+Als plan-detectie faalt, valt OpenCommand terug op de lokale cached/static Go/open-source lijst zodat OpenCode alsnog kan starten.
+
+## Lokale API
+
+De proxy biedt OpenAI-compatible endpoints:
+
+- `POST /v1/chat/completions` — streaming en non-streaming chat completions.
+- `GET /v1/models` — plan-gefilterde OpenAI model-lijst.
+- `GET /v1/models/allowed` — CommandCode Studio allowed-models/usage info.
+- `GET /v1/account/usage` — usage summary.
+- `GET /healthz` — health check.
+
+De proxy vertaalt OpenAI `messages`, `tools`, `tool_choice` en streaming responses naar/van het huidige CommandCode CLI-protocol.
+
+## Development
+
+Root package:
 
 ```bash
 npm ci
+npm test -- --runInBand
 npm run build
+npm run build:proxy
+npm pack --dry-run
 ```
 
-## Test
+Go proxy tests:
 
 ```bash
-npm test -- --runInBand
+cd proxy
+go vet ./...
+go test -race ./...
+go build -o proxy main.go
 ```
 
-## v0.0.8 non-blocking OpenCode startup
+`npm pack` bevat alleen de runtimebestanden:
+
+- `README.md`
+- `package.json`
+- `bin/opencode-plugin.js`
+- `dist/index.js`
+- `dist/index.d.ts`
+- `dist/proxy/opencommand-proxy-*`
+
+De bronmappen `src/`, `tests/` en `proxy/` worden niet gepubliceerd in het NPM-package.
+
+## Publicatie
+
+Package: `opencommand-plugin`.
+
+De publish workflow staat in `.github/workflows/npm-publish.yml`. Deze workflow bouwt/test de root package, bouwt de proxybinaries en controleert dat alle vereiste bestanden in het NPM-package zitten.
+
+## Release notes
+
+### v0.0.12
+
+- OpenAI-compatible chat schema voor OpenCode requests.
+- Deterministische samenvoeging van system/developer messages naar `params.system`.
+- Conversie van OpenAI tool calls/results naar CommandCode `tool-call`/`tool-result` parts.
+- Conversie van OpenAI `tools` en `tool_choice` naar CommandCode tool schema.
+- Fixes voor CommandCode 400-errors rond `params.messages[0].role`, string content en `params.tools[0].name`.
+- Repo-layout opgeschoond: root is nu het NPM/OpenCode package; `proxy/` is alleen Go-source voor bundled binaries.
 
-`opencommand-plugin@0.0.8` keeps OpenCode startup non-blocking: provider registration uses cached/static models immediately, while proxy startup and CommandCode plan/model refresh run in the background. Pin `opencode.jsonc` to `opencommand-plugin@0.0.11` (or newer) instead of `@latest` to avoid stale plugin cache entries.
+### v0.0.11
 
-## v0.0.9 CommandCode protocol update
+- NPM-package bundelt proxybinaries voor macOS, Linux en Windows.
+- OpenCode heeft alleen `opencommand-plugin` nodig; geen losse proxy-installatie.
+- Proxy vertaalt CommandCode streaming events naar OpenAI-compatible chat-completion chunks/responses.
 
-`opencommand-plugin@0.0.9` updates the bundled proxy to the current CommandCode CLI protocol headers (`x-command-code-version: 0.26.3`, production CLI environment, and OpenCommand project slug). Older `OPENCOMMAND_COMMAND_CODE_CLIENT_VERSION` overrides can no longer downgrade the bundled protocol version.
+### v0.0.10
 
-## v0.0.11 bundled proxy
+- Plugin start de lokale proxy vanuit de OpenCode config hook.
+- Gesyncte `opencode.jsonc` heeft geen absolute lokale `file://` plugin path meer nodig.
 
-`opencommand-plugin@0.0.11` ships the Go proxy binaries inside the NPM package for macOS, Linux, and Windows. OpenCode only needs the plugin package; no separate proxy install or local repo checkout is required.
+### v0.0.9
 
-The proxy also translates CommandCode streaming events into OpenAI-compatible chat-completion chunks/responses for `@ai-sdk/openai-compatible`.
+- CommandCode protocol headers bijgewerkt naar CLI-versie `0.26.3`.
+- Productie CLI-environment en OpenCommand project slug toegevoegd.
 
-## v0.0.10 OpenCode autostart preload
+### v0.0.8
 
-`opencommand-plugin@0.0.10` starts the local proxy from the OpenCode config hook so synced `opencode.jsonc` installs do not depend on an absolute local `file://` plugin path.
+- Non-blocking OpenCode startup: cached/static models direct, proxy/plan refresh op de achtergrond.

package/dist/index.js

@@ -731,7 +731,7 @@ export function resolveProxyBinaryPath() {
     const candidates = [
         bundledProxyBinaryPath(),
         path.join(os.homedir(), ".opencommand", "proxy"),
-        path.join(process.cwd(), "packages", "proxy", "proxy"),
+        path.join(process.cwd(), "proxy", "proxy"),
         path.join(process.cwd(), "proxy"),
     ].filter((candidate) => Boolean(candidate));
     return candidates.find((candidate) => fs.existsSync(candidate)) || candidates[candidates.length - 1];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencommand-plugin",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "OpenCommand - CommandCode API Plugin for OpenCode",
   "main": "./bin/opencode-plugin.js",
   "module": "./bin/opencode-plugin.js",