@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 +4 -0
- package/README.md +23 -9
- package/dist/index.d.ts +12 -0
- package/dist/plugin.d.ts +45 -0
- package/dist/plugin.js +21116 -0
- package/dist/src/auth.d.ts +5 -0
- package/dist/src/catalog-break.d.ts +12 -0
- package/dist/src/catalog-release-notes.d.ts +30 -0
- package/dist/src/catalog.d.ts +116 -0
- package/dist/src/convert.d.ts +71 -0
- package/dist/src/costs-docs.d.ts +13 -0
- package/dist/src/costs-models-dev.d.ts +53 -0
- package/dist/src/cut-changelog.d.ts +1 -0
- package/dist/src/entry.d.ts +3 -0
- package/dist/src/env.d.ts +13 -0
- package/dist/src/load-result.d.ts +17 -0
- package/dist/src/manifest.d.ts +54 -0
- package/dist/src/model.d.ts +18 -0
- package/dist/src/paths.d.ts +14 -0
- package/dist/src/publish-policy.d.ts +17 -0
- package/dist/src/schemas.d.ts +123 -0
- package/dist/src/startup.d.ts +22 -0
- package/dist/src/stream.d.ts +2 -0
- package/dist/src/v2models.d.ts +43 -0
- package/manifest.json +2 -2
- package/models.json +688 -130
- package/package.json +2 -2
- package/plugin.ts +18 -4
- package/src/catalog.ts +82 -7
- package/src/costs-models-dev.ts +161 -14
- package/src/publish-policy.ts +3 -4
- package/src/schemas.ts +33 -1
- package/src/v2models.ts +42 -8
package/CHANGELOG.md
CHANGED
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
|
-
-
|
|
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
|
-
|
|
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
|
-
- **
|
|
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
|
-
- **
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
package/dist/index.d.ts
ADDED
|
@@ -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
|
+
};
|
package/dist/plugin.d.ts
ADDED
|
@@ -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;
|