@brainervirus/opencode-commandcode 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.10.0] - 2026-09-28
11
+
12
+ ## [0.9.1] - 2026-09-27
13
+
10
14
  ## [0.9.0] - 2026-09-26
11
15
 
12
16
  ## [0.8.0] - 2026-09-26
package/README.md CHANGED
@@ -6,6 +6,8 @@
6
6
 
7
7
  [Command Code](https://commandcode.ai) API provider for [opencode](https://opencode.ai). Use Claude, GPT, Gemini, DeepSeek, Qwen, Kimi, GLM, MiniMax, Step, and other models through a single API key.
8
8
 
9
+ This plugin is for Command Code accounts with Provider API access. GOAT is the live-tested baseline; other API-enabled plans can use models their account is entitled to. The $1 Go plan has no Provider API access. The catalog follows the provider-wide model list, so a model appearing in OpenCode does not imply that every account can call it. See [GOAT plan details](https://commandcode.ai/docs/plans/goat) and [Provider API docs](https://commandcode.ai/docs/provider).
10
+
9
11
  This package keeps a **bundled** model catalog current via CI. You do **not** need a local `command-code` CLI. Catalog patches publish automatically after a green PR merges to `main`.
10
12
 
11
13
  Previously published as `@brainervirus/commandcode-go-opencode-provider`. Use this name instead.
@@ -17,44 +19,56 @@ This package is based on **[FanFan4204/opencode-commandcode-provider](https://gi
17
19
  ### What this package adds
18
20
 
19
21
  - Bundled `models.json` is the default runtime catalog (no local CLI scrape).
20
- - Dual OpenCode entry: V2 `setup` injects the provider plus models via transforms; V1 `server` fills `provider.commandcode` defaults plus models and registers API-key auth (auth stays V1-only).
22
+ - V1 and V2 use their native plugin and provider surfaces. V1 `server()` fills `provider.commandcode` and registers API-key auth; V2 `setup()` registers provider/model transforms and a key/env integration for `/connect` and `opencode auth login`.
21
23
  - Validation at the boundaries via `src/schemas.ts` (zod): bundled `models.json` / `manifest.json` reads, provider availability payloads, and the plugin config file.
22
24
  - CLI cost extraction can fail without dropping models; official docs fill missing costs, remaining paid gaps use [models.dev](https://models.dev) as a reference price at sync time. Command Code free SKUs stay `$0`.
23
25
  - Vision vs text-only comes from the Command Code CLI catalog (`inputModalities` on every SKU). [models.dev](https://models.dev) only adds extra inputs (video/audio/pdf) when it matches.
24
26
  - Reasoning effort **variants** on models that declare `reasoningEfforts`.
27
+ - Release date, family, input limits, model status, vendor context limits, and matched context-price tiers flow through the bundled catalog. V2 gets native release, family, input, status, and tier fields; V1 keeps its supported fields and base prices, with `context_over_200k` where representable.
28
+ - The provider's `supported_endpoints` metadata chooses each model's API route. Responses-capable models use `@ai-sdk/openai` on V1 and `aisdk:@ai-sdk/openai` on V2; Claude falls back to Anthropic Messages when endpoint metadata is absent. The V1 and V2 Responses mappings passed official Docker checks against a local mock stream, and a GOAT-key DeepSeek control request succeeded in OpenCode V2. Claude Sonnet 4.6 returned `MODEL_NOT_IN_PLAN` with the message “available in Pro and above plans or extra on-demand usage”; this confirms the account restriction, not successful Anthropic routing. Entitled Claude access has not been live-verified. If a model fails on an account entitled to use it, please [open an issue](https://github.com/BrainerVirus/opencode-commandcode/issues) with the model ID and OpenCode version, or submit a PR with a reproducible fix.
25
29
  - Quiet OpenCode startup (diagnostics go to `startup.json`, not stdout).
26
30
 
27
31
  ## How it works
28
32
 
29
- Each CI sync extracts the model catalog from the latest `command-code` npm bundle, merges costs, and commits versioned artifacts; at startup the plugin loads those artifacts and registers them with OpenCode — never the other way around.
33
+ For published plugin versions, the six-hour CI schedule extracts the latest `command-code` npm bundle and refreshes callable models plus endpoint metadata, even when the CLI version is unchanged. It opens a catalog PR only when generated artifacts change; at startup the plugin loads those artifacts and registers them with OpenCode — never the other way around.
30
34
 
31
35
  - **Extract + filter** — model entries (ids, names, reasoning, `inputModalities`, limits) are evaluated out of the minified CLI bundle (`src/catalog.ts`), then intersected with the callable IDs reported by the provider API.
32
- - **Costs merge** — per model, first hit wins: CLI bundle costs → official Command Code docs → free SKUs (`$0`) → [models.dev](https://models.dev) reference prices → unmatched placeholder. Anything still unmatched marks the catalog `degraded`. This runs at sync time only; runtime never fetches prices.
36
+ - **Metadata + costs merge** — vendor context length tightens only a fallback context limit, while `supported_endpoints` selects Chat Completions, Responses, or Messages per model; missing endpoint metadata preserves the last known route data. models.dev contributes release date, family, input limit, status, modalities, and cost tiers when present. Tier rows are accepted only when their base prices match this Command Code catalog. Base costs use CLI bundle → official Command Code docs → free SKUs (`$0`) → [models.dev](https://models.dev) reference prices → unmatched placeholder. Anything still unmatched marks the catalog `degraded`. This runs at sync time only; runtime never fetches metadata or prices.
33
37
  - **Artifacts** — `models.json` (the catalog), `_version.txt` (upstream version), `manifest.json` (counts, per-source cost stats, `healthy`/`degraded`/`broken` status).
34
- - **V1 injection + V2 transform** — V1 `server()` fills `provider.commandcode` defaults and the models map; V2 `setup()` adds/updates the provider inventory (baseURL, API key binding) and sets models through `ctx.provider.transform`.
38
+ - **Version-specific registration** — V1 uses the `plugin` config key, `server()` provider map, and V1 auth callback. V2 uses `plugins`, provider/model transforms, and a `commandcode` integration with key and `COMMANDCODE_API_KEY` environment methods. Both retain the Command Code wire model ID. V2 exposes tiered context pricing; V1 emits its supported `context_over_200k` field and keeps flat pricing for other tiers.
35
39
  - **Degraded/cache fallbacks** — a `degraded`/`broken` manifest sets the degraded flag with a reason; an unreadable bundled `models.json` falls back to the last-good cache; auth/connect still registers even with an empty catalog.
36
40
 
37
41
  ## Quick Start
38
42
 
39
43
  ### 1. Install the plugin
40
44
 
45
+ OpenCode V2:
46
+
47
+ ```json
48
+ {
49
+ "plugins": ["@brainervirus/opencode-commandcode@latest"]
50
+ }
51
+ ```
52
+
53
+ OpenCode V1:
54
+
41
55
  ```json
42
56
  {
43
57
  "plugin": ["@brainervirus/opencode-commandcode@latest"]
44
58
  }
45
59
  ```
46
60
 
47
- Pin a version instead of `@latest` if you do not want automatic catalog patches. The config key stays `plugin` in OpenCode V2 — there is no `plugins` key.
61
+ Pin a version instead of `@latest` if you do not want automatic catalog patches.
48
62
 
49
63
  `file://` checkouts are **not** updated by npm; `git pull` after CI commits, or switch to the npm plugin line.
50
64
 
51
65
  ### 2. No provider block needed
52
66
 
53
- On OpenCode V2 the plugin registers the `commandcode` provider itself (Provider API base URL plus `COMMANDCODE_API_KEY` binding) and its models. On V1 the `server` hook fills the same `provider.commandcode` defaults — `npm: "@ai-sdk/openai-compatible"` plus the Provider API `baseURL`; the plugin package itself is never the SDK `npm` field. Only add a manual `provider.commandcode` entry if you need non-default transport options.
67
+ On OpenCode V2 the plugin registers the `commandcode` provider, its models, and its API base URL through the V2 provider API. On V1 the `server` hook fills `provider.commandcode` defaults — `npm: "@ai-sdk/openai-compatible"` plus the Provider API `baseURL`; the plugin package itself is never the SDK `npm` field. Only add a manual provider entry if you need non-default transport options.
54
68
 
55
69
  ### 3. Connect
56
70
 
57
- Set `COMMANDCODE_API_KEY`, or on OpenCode V1 run `/connect`, search for **Command Code**, and enter your API key. V2 registers the provider with the env binding; the `/connect` API-key method is V1-only.
71
+ Set `COMMANDCODE_API_KEY`, or connect interactively. OpenCode V1 provides **Command Code** through `/connect`; OpenCode V2 registers key and environment methods for `/connect` and `opencode auth login commandcode`. V2 uses OpenCode's automatic provider activation and preserves an explicit activation setting. Connect before running a model; an explicit run while disconnected still returns an authorization error from the API.
58
72
 
59
73
  ### 4. Select a model
60
74
 
@@ -97,9 +111,9 @@ bun run generate-readme # reports catalog counts only; README is hand-edited
97
111
  bun run catalog:ci # entry used by the catalog-sync workflow
98
112
  ```
99
113
 
100
- Entry points: `plugin.ts` owns all config-hook logic (dual default `{ id, setup }` plus `server`); `index.ts` re-exports the plugin plus the `createCommandCode` SDK factory; `src/entry.ts` is bundle glue for `scripts/build-plugin.ts` only — it produces `dist/plugin.js`.
114
+ Entry points: `plugin.ts` owns both config surfaces (V2 `id`/`setup` plus V1 `server`); `index.ts` re-exports the plugin plus the `createCommandCode` SDK factory; `src/entry.ts` is bundle glue for `scripts/build-plugin.ts` only — it produces `dist/plugin.js`.
101
115
 
102
- CI (`.github/workflows/catalog-sync.yml`) opens a `fix(catalog)` PR every 6 hours when Command Code ships a new catalog; if extraction fails it opens a `catalog-break` issue instead. The PR auto-merges after **check (test)**, **check (typecheck)**, **check (lint)**, **check (format)**, and **check (pack)** are green. `.github/workflows/release.yml` then runs **semantic-release** (npm publish + GitHub Release + tag). Do not push to `main`.
116
+ CI (`.github/workflows/catalog-sync.yml`) checks every 6 hours for CLI catalog changes and provider availability/endpoint metadata changes; it opens a `fix(catalog)` PR only when generated files change. If extraction fails or the model-count safety floor is breached, it opens a `catalog-break` issue and leaves the last-good files intact. The PR auto-merges after **check (test)**, **check (typecheck)**, **check (lint)**, **check (format)**, and **check (pack)** are green. `.github/workflows/release.yml` then runs **semantic-release** (build + verified npm publish + GitHub Release + tag). Do not push to `main`.
103
117
 
104
118
  The GitHub Actions secret name is `NPMJS`. It is mapped to both `NPM_TOKEN` and `NODE_AUTH_TOKEN`. Use an npm **Automation** token (bypasses 2FA). A login token from `~/.npmrc` fails CI with `EOTP`. Catalog PRs get a real CI run when `RELEASE_SYNC_TOKEN` is a PAT; `GITHUB_TOKEN` can open the PR but GitHub will not start workflows from that event.
105
119
 
@@ -0,0 +1,12 @@
1
+ import { CommandCodeLanguageModel } from "./src/model.js";
2
+ export { default, server } from "./plugin.js";
3
+ export interface CommandCodeProviderOptions {
4
+ name?: string;
5
+ apiKey?: string;
6
+ baseURL?: string;
7
+ headers?: Record<string, string>;
8
+ authPaths?: string[];
9
+ }
10
+ export declare function createCommandCode(options?: CommandCodeProviderOptions): {
11
+ languageModel(modelId: string): CommandCodeLanguageModel;
12
+ };
@@ -0,0 +1,45 @@
1
+ import { type ModelEntry } from "./src/catalog.js";
2
+ import { type EnvDeps } from "./src/env.js";
3
+ export type { ModelEntry };
4
+ export type CatalogLoad = {
5
+ models: ModelEntry[];
6
+ catalogSource: "bundled" | "cache" | "opt-in-local";
7
+ commandCodeVersion: string | null;
8
+ degraded: boolean;
9
+ degradedReason: string | null;
10
+ };
11
+ export declare function loadCatalogEntries(deps?: EnvDeps): CatalogLoad;
12
+ /** V1 entrypoint (OpenCode 1.18.29+ also accepts it via `server`). */
13
+ export declare function server(): Promise<{
14
+ config: (config: Record<string, unknown>) => Promise<void>;
15
+ auth: {
16
+ provider: string;
17
+ methods: {
18
+ type: string;
19
+ label: string;
20
+ authorize: (inputs: Record<string, unknown> | undefined) => Promise<{
21
+ type: "failed";
22
+ key?: undefined;
23
+ } | {
24
+ type: "success";
25
+ key: string;
26
+ }>;
27
+ }[];
28
+ loader: (getAuth: () => Promise<{
29
+ type: string;
30
+ key?: string;
31
+ } | null>) => Promise<{
32
+ apiKey?: undefined;
33
+ } | {
34
+ apiKey: string;
35
+ }>;
36
+ };
37
+ }>;
38
+ /** V2 setup: provider inventory, models, and API-key integration through transforms. */
39
+ declare function setup(ctx: any): Promise<void>;
40
+ declare const _default: {
41
+ server: typeof server;
42
+ id: string;
43
+ setup: typeof setup;
44
+ };
45
+ export default _default;