@telsoncc/opencode-commandcode 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,212 @@
+# 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).
+
+## [Unreleased]
+
+## [1.0.0] - 2026-09-21
+
+## [0.7.73] - 2026-09-21
+
+## [0.7.72] - 2026-09-20
+
+## [0.7.71] - 2026-09-19
+
+## [0.7.70] - 2026-09-19
+
+## [0.7.69] - 2026-09-18
+
+## [0.7.68] - 2026-09-18
+
+## [0.7.67] - 2026-09-18
+
+## [0.7.66] - 2026-09-17
+
+## [0.7.65] - 2026-09-16
+
+## [0.7.64] - 2026-09-16
+
+## [0.7.63] - 2026-09-14
+
+## [0.7.62] - 2026-09-12
+
+## [0.7.61] - 2026-09-10
+
+## [0.7.60] - 2026-09-09
+
+## [0.7.59] - 2026-09-09
+
+## [0.7.58] - 2026-09-09
+
+## [0.7.57] - 2026-09-08
+
+## [0.7.56] - 2026-09-08
+
+## [0.7.55] - 2026-09-06
+
+## [0.7.54] - 2026-09-05
+
+## [0.7.53] - 2026-09-05
+
+## [0.7.52] - 2026-09-04
+
+## [0.7.51] - 2026-09-04
+
+## [0.7.50] - 2026-09-03
+
+## [0.7.49] - 2026-09-03
+
+## [0.7.48] - 2026-09-02
+
+## [0.7.47] - 2026-09-02
+
+## [0.7.46] - 2026-09-02
+
+## [0.7.45] - 2026-09-02
+
+## [0.7.44] - 2026-09-02
+
+## [0.7.43] - 2026-09-02
+
+## [0.7.42] - 2026-09-02
+
+## [0.7.41] - 2026-09-02
+
+## [0.7.40] - 2026-09-02
+
+## [0.7.39] - 2026-09-02
+
+## [0.7.38] - 2026-09-02
+
+## [0.7.37] - 2026-09-02
+
+## [0.7.36] - 2026-09-02
+
+## [0.7.35] - 2026-09-02
+
+## [0.7.34] - 2026-09-02
+
+## [0.7.33] - 2026-09-02
+
+## [0.7.32] - 2026-09-02
+
+## [0.7.31] - 2026-09-02
+
+## [0.7.30] - 2026-09-02
+
+## [0.7.29] - 2026-09-02
+
+## [0.7.28] - 2026-09-02
+
+## [0.7.27] - 2026-09-02
+
+## [0.7.26] - 2026-09-02
+
+## [0.7.25] - 2026-09-02
+
+## [0.7.24] - 2026-09-02
+
+## [0.7.23] - 2026-09-02
+
+## [0.7.21] - 2026-09-02
+
+## [0.7.20] - 2026-09-02
+
+## [0.7.19] - 2026-09-02
+
+## [0.7.18] - 2026-09-02
+
+## [0.7.17] - 2026-09-02
+
+## [0.7.16] - 2026-09-02
+
+## [0.7.15] - 2026-09-02
+
+## [0.7.14] - 2026-09-02
+
+## [0.7.13] - 2026-09-02
+
+## [0.7.12] - 2026-09-02
+
+## [0.7.11] - 2026-09-02
+
+## [0.7.10] - 2026-09-02
+
+## [0.7.9] - 2026-09-02
+
+## [0.7.8] - 2026-09-02
+
+## [0.7.7] - 2026-09-02
+
+## [0.7.6] - 2026-09-02
+
+## [0.7.5] - 2026-09-02
+
+## [0.7.4] - 2026-09-01
+
+## [0.7.3] - 2026-09-01
+
+## [0.7.2] - 2026-08-31
+
+## [0.7.1] - 2026-08-29
+
+### Changed
+
+- Catalog refresh and post-release manifest PRs auto-merge when required CI is green.
+
+### Fixed
+
+- Startup summary test reads the bundled command-code version from the manifest instead of pinning one release.
+
+## [0.7.0] - 2026-08-28
+
+### Changed
+
+- npm publishes only when plugin or catalog files change since the last tag — CI, tests, and scripts-only merges skip a release.
+
+### Added
+
+- Catalog models include vision vs text-only from the Command Code CLI `inputModalities` field on every SKU. models.dev only adds extra inputs (video/audio/pdf) on matches.
+
+## [0.6.1] - 2026-08-28
+
+### Added
+
+- semantic-release now cuts Keep a Changelog `[Unreleased]` into `## [version]` on publish and includes `CHANGELOG.md` in the post-release sync PR.
+
+### Fixed
+
+- Catalog GitHub release notes table no longer renders a blank header row above Plugin.
+- Credits sentence no longer mentions Command Code wiring or restates MIT copyright.
+
+## [0.6.0] - 2026-08-28
+
+### Changed
+
+- Renamed the published package and GitHub repository to `@brainervirus/opencode-commandcode`.
+
+## [0.5.1] - 2026-08-28
+
+### Fixed
+
+- Price Command Code free SKUs at `$0` before models.dev, and fill remaining paid gaps from models.dev.
+
+## [0.5.0] - 2026-08-28
+
+### Added
+
+- GitHub flow: PR-gated `main`, CI matrix (`check (test|typecheck|pack)`), semantic-release on merge, catalog updates as PRs.
+- Release notes open with a catalog summary table and collapsed lists of fallback / unpriced models.
+- `manifest.json` describing the bundled catalog (status, cost sources, command-code version).
+- First publish of `@brainervirus/commandcode-go-opencode-provider`.
+- Last-good catalog cache and silent `startup.json` diagnostics under the plugin state dir.
+
+### Fixed
+
+- Load the Command Code model catalog when CLI cost extraction fails (`command-code@1.38.x`).
+- Stop plugin `console.log` / `console.warn` from leaking into the OpenCode loading UI.
+- Default to bundled `models.json` (no local `command-code` install). Opt-in local scrape via `commandCodePackagePath` or `COMMANDCODE_PACKAGE_PATH`.
+- Refresh bundled catalog from `command-code@1.38.1` and fill missing costs from official docs.

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Brent Weatherall
+Copyright (c) 2026 telsoncc
+
+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,122 @@
+# @telsoncc/opencode-commandcode
+
+[![npm version](https://img.shields.io/npm/v/@telsoncc/opencode-commandcode)](https://www.npmjs.com/package/@telsoncc/opencode-commandcode)
+[![CI](https://img.shields.io/github/actions/workflow/status/telsoncc/opencode-commandcode/ci.yml?branch=main&label=CI)](https://github.com/telsoncc/opencode-commandcode/actions)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+[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.
+
+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`.
+
+Previously published as `@brainervirus/opencode-commandcode` (and before that `@brainervirus/commandcode-go-opencode-provider`). This fork publishes as `@telsoncc/opencode-commandcode` — use this name instead.
+
+## Credits
+
+This package is based on **[FanFan4204/opencode-commandcode-provider](https://github.com/FanFan4204/opencode-commandcode-provider)**. That work started from **[brent-weatherall/opencode-commandcode-provider](https://github.com/brent-weatherall/opencode-commandcode-provider)** by **[Brent Weatherall](https://github.com/brent-weatherall)**. Thank you both — FanFan for the OpenCode provider this repo continues, and Brent for the original plugin, catalog extraction.
+
+Forked and currently maintained by **[telsoncc](https://github.com/telsoncc)** (OpenCode 2.x support and ongoing catalog updates).
+
+### What this package adds
+
+- Bundled `models.json` is the default runtime catalog (no local CLI scrape).
+- CLI cost extraction can fail (as on `command-code@1.38.x`) without dropping models.
+- Official docs fill missing costs; remaining paid gaps use [models.dev](https://models.dev) as a reference. Command Code free SKUs stay `$0`.
+- 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.
+- Reasoning effort **variants** on models that declare `reasoningEfforts`.
+- Quiet OpenCode startup (diagnostics go to `startup.json`, not stdout).
+- Native **OpenCode 2.x** entrypoint (`plugin/opencode2`, also served as `server`):
+  in-memory provider inventory via `ctx.provider.transform` (no config writes)
+  plus a `commandcode` integration for `/connect`. See `docs/opencode-2.md`.
+
+## Quick Start
+
+Use one entrypoint per host. OpenCode 1.x loads the classic plugin;
+OpenCode 2.x loads the 2.0 entrypoint from the same package.
+
+### OpenCode 1.x — install the plugin
+
+```json
+{
+  "plugin": ["@telsoncc/opencode-commandcode@latest"]
+}
+```
+
+Pin a version instead of `@latest` if you do not want automatic catalog patches.
+
+`file://` checkouts are **not** updated by npm; `git pull` after CI commits, or switch to the npm plugin line.
+
+### OpenCode 1.x — provider transport (Command Code Provider API)
+
+This plugin supplies model metadata. Point OpenCode at Command Code's documented Provider API:
+
+```json
+{
+  "plugin": ["@telsoncc/opencode-commandcode@latest"],
+  "provider": {
+    "commandcode": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "Command Code GOAT",
+      "env": ["COMMANDCODE_API_KEY"],
+      "options": {
+        "baseURL": "https://api.commandcode.ai/provider/v1"
+      }
+    }
+  }
+}
+```
+
+### OpenCode 2.x — install the plugin (no provider block needed)
+
+```jsonc
+{
+  "plugins": ["@telsoncc/opencode-commandcode/plugin/opencode2"],
+}
+```
+
+The 2.0 entrypoint registers the `commandcode` provider (native
+`openai-compatible` runtime, Provider API base URL) and its 71-model catalog
+in memory — do **not** keep a hand-written `provider`/`providers.commandcode`
+block (including models dumped by `bun run sync -- --update-global`): it
+fights the plugin-owned inventory. `sync --update-global` is 1.x-only.
+Full guide plus local-clone loading: `docs/opencode-2.md`.
+
+Pin a version instead (insert `@<version>` before `/plugin/opencode2`) if you do not
+want automatic catalog patches.
+
+### Connect
+
+Run `/connect` in opencode, search for **Command Code**, and enter your API key, or set `COMMANDCODE_API_KEY`.
+
+### Select a model
+
+```
+/models
+```
+
+On 2.x the catalog carries no release dates, so filter the picker by provider
+**Command Code** if the global list looks empty.
+
+## Optional local CLI override
+
+Maintainers only. OpenCode will scrape a local `command-code` install when `COMMANDCODE_PACKAGE_PATH` or `commandCodePackagePath` in `~/.config/opencode/opencode-commandcode.json` is set.
+
+## Development
+
+```bash
+git clone https://github.com/telsoncc/opencode-commandcode.git
+cd opencode-commandcode
+bun install
+bun run check            # oxlint + oxfmt + bun test + tsc (same stack as workit)
+```
+
+```bash
+bun run sync -- --remote  # refresh models.json + manifest.json from command-code@latest
+```
+
+CI (`.github/workflows/catalog-sync.yml`) opens a PR every 6 hours when Command Code ships a new catalog. That PR, and the post-release `chore/manifest-sync-v*` PR, auto-merge 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`.
+
+The GitHub Actions secret name is `NPMJS` (same as workit). 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` (or `CATALOG_PUSH_TOKEN`) is a PAT; `GITHUB_TOKEN` can open the PR but GitHub will not start workflows from that event.
+
+## License
+
+MIT — see [LICENSE](LICENSE). Original copyright [Brent Weatherall](https://github.com/brent-weatherall); modifications copyright [telsoncc](https://github.com/telsoncc).

package/_version.txt

@@ -0,0 +1 @@
+1.58.1

package/index.ts

@@ -0,0 +1,32 @@
+import { resolveApiKey } from "./src/auth.js";
+import { CommandCodeLanguageModel } from "./src/model.js";
+
+export interface CommandCodeProviderOptions {
+  name?: string;
+  apiKey?: string;
+  baseURL?: string;
+  headers?: Record<string, string>;
+  authPaths?: string[];
+}
+
+export function createCommandCode(options: CommandCodeProviderOptions = {}) {
+  const apiKey = resolveApiKey({ apiKey: options.apiKey, authPaths: options.authPaths });
+  if (!apiKey) {
+    throw new Error(
+      "Command Code API key not found. Set COMMANDCODE_API_KEY env var, create ~/.commandcode/auth.json, or pass apiKey option.",
+    );
+  }
+
+  return {
+    languageModel(modelId: string): CommandCodeLanguageModel {
+      return new CommandCodeLanguageModel(modelId, {
+        apiKey,
+        baseURL: typeof options.baseURL === "string" ? options.baseURL : undefined,
+        headers:
+          typeof options.headers === "object" && options.headers !== null
+            ? (options.headers as Record<string, string>)
+            : undefined,
+      });
+    },
+  };
+}

package/manifest.json

@@ -0,0 +1,58 @@
+{
+  "schemaVersion": 1,
+  "generatedAt": "2026-09-20T16:38:04.091Z",
+  "pluginVersion": "1.0.0",
+  "commandCodeVersion": "1.58.1",
+  "commandCodeTarball": "https://registry.npmjs.org/command-code/-/command-code-1.58.1.tgz",
+  "modelCount": 71,
+  "reasoningModelCount": 61,
+  "extraction": {
+    "modelCatalog": "ok",
+    "costCatalog": "cli",
+    "costCatalogError": null
+  },
+  "costSources": {
+    "cli": 21,
+    "officialDocs": 50,
+    "thirdParty": 0,
+    "free": 0,
+    "fallback": 0,
+    "unmatched": 0
+  },
+  "review": {
+    "thirdParty": [],
+    "free": [],
+    "unmatched": [],
+    "unavailable": [
+      {
+        "id": "MiniMaxAI/MiniMax-M3-Free",
+        "reason": "not-listed-by-provider-api"
+      },
+      {
+        "id": "gpt-6-astra",
+        "reason": "not-listed-by-provider-api"
+      },
+      {
+        "id": "inclusionai/ling-3.0-flash-free",
+        "reason": "not-listed-by-provider-api"
+      },
+      {
+        "id": "meituan/LongCat-2.0:free",
+        "reason": "not-listed-by-provider-api"
+      },
+      {
+        "id": "minimax/minimax-m2.7-free",
+        "reason": "not-listed-by-provider-api"
+      },
+      {
+        "id": "minimax/minimax-m3-free",
+        "reason": "not-listed-by-provider-api"
+      },
+      {
+        "id": "tencent/Hy3",
+        "reason": "not-listed-by-provider-api"
+      }
+    ]
+  },
+  "status": "healthy"
+}