opencode-model-price-intel 0.0.0-stage → 1.0.0

package/LICENSE

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

@@ -0,0 +1,37 @@
+NOTICE
+======
+
+Artificial Analysis data
+------------------------
+
+This package bundles a fallback snapshot of the Artificial Analysis Intelligence
+Index (v5.0) captured on 2026-10-31 from the public model pages at:
+
+  https://artificialanalysis.ai/
+
+At runtime the plugin prefers live data from the Artificial Analysis Data API
+(when a key is configured) or the public Artificial Analysis pages. The bundled
+snapshot is used only when live data and the plugin cache are unavailable.
+
+Intelligence Index scores and related model data are produced by Artificial
+Analysis. Attribution is provided in the plugin output and in this NOTICE.
+Use of Artificial Analysis data is subject to their terms:
+
+  https://artificialanalysis.ai/terms
+
+The snapshot is derived data and is not a substitute for the live Artificial
+Analysis service. Do not remove this NOTICE or the attribution when
+redistributing the package.
+
+Some source comments in `src/aa-snapshot.ts` record that individual scores were
+cross-checked against a third-party "llmcompare snapshot 2026-10-12". Those
+comments are retained for provenance/traceability only; the authoritative
+source and attribution for the bundled Intelligence Index data remains
+Artificial Analysis.
+
+Test fixtures
+-------------
+
+`test/fixtures/aa-payload.txt` is a capture of public Artificial Analysis model
+data used only by the repository test suite. Fixtures are not included in the
+published npm package. See `test/fixtures/README.md` for capture details.

package/README.md

@@ -1,3 +1,147 @@
-# Temporary Holding Version
+# opencode-model-price-intel
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![CI](https://github.com/chris15joseph/opencode-model-price-intel/actions/workflows/ci.yml/badge.svg)](https://github.com/chris15joseph/opencode-model-price-intel/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/opencode-model-price-intel)](LICENSE)
+
+An OpenCode 2 plugin that puts **prices and the Artificial Analysis
+Intelligence Index** next to every model in `/models`, and adds a full
+`/model-pricing` table when you need the details.
+
+```text
+/models
+  GPT 6 Astra · in $2.5 out $15 · cache read $0.25 write $0 (2 tiers) · AA 56.9
+  Kimi K3 · in $3 out $15 · cache read $0.3 write $3 · AA n/a
+  Big Pickle · free · AA n/a
+```
+
+Prices are USD per 1M tokens, read from the live OpenCode model registry. Scores
+come from Artificial Analysis and refresh in the background. Scores are cached,
+so the first `/models` render is instant and the network never blocks it.
+
+## Install
+
+Requires OpenCode 2.2.x (the plugin pins `@opencode/plugin` to `2.2.5`) and
+Node.js 20 or newer.
+
+> **npm status:** the package is staged but not yet published. Until it appears
+> on npm, install from Git:
+>
+> ```sh
+> opencode plugin add github:chris15joseph/opencode-model-price-intel
+> ```
+
+```sh
+opencode plugin add opencode-model-price-intel
+```
+
+Or add it to `opencode.json(c)` yourself:
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": ["opencode-model-price-intel"]
+}
+```
+
+Local checkout:
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": ["/absolute/path/to/opencode-model-price-intel"]
+}
+```
+
+A plugin directory under `.opencode/plugins/` also loads automatically. Do not
+list the same plugin twice.
+
+### Options
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": [
+    {
+      "package": "opencode-model-price-intel",
+      "options": {
+        "decorateNames": true,
+        "costFormat": "compact",
+        "aaApiKey": "{env:ARTIFICIALANALYSIS_API_KEY}",
+        "refreshHours": 12
+      }
+    }
+  ]
+}
+```
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `decorateNames` | `true` | Append the price/score summary to `/models` names. The `/model-pricing` table still works when this is off. |
+| `costFormat` | `"detailed"` | `"detailed"` renders `in $2.5 out $15 · cache read $0.25 write $0`; `"compact"` renders `$2.5/$15/$0.25/$0`. |
+| `aaApiKey` | unset | Artificial Analysis API key. Falls back to `ARTIFICIALANALYSIS_API_KEY`. Without either, the public model-list page is used. |
+| `refreshHours` | `12` | Score cache TTL and refresh interval, clamped to `1..596` hours. |
+
+Invalid option values log one warning and fall back to the defaults.
+
+## Commands
+
+| Command | What it does |
+| --- | --- |
+| `/model-pricing` | Prints a Markdown table with every model, provider, price tier, cache price, and AA score. |
+| `/prices` | Alias of `/model-pricing`. |
+| `/models` | The native picker, now decorated with the one-line summary. |
+
+The table is a synthetic session message; no model call is made. Multi-tier
+models get one row per price entry (`base`, then `>N` for context overrides).
+
+## How it works
+
+- Prices come from `Model.Info.cost` in the live OpenCode registry. The plugin
+  does not bundle a price table and does not convert currencies.
+- Scores are fetched from the Artificial Analysis Free Data API when a key is
+  configured, otherwise from the public model-list page.
+- A bundled v5.0 snapshot (captured 2026-10-31) is registered before any
+  network or storage work, so the first render is immediate. It is only merged
+  with live data from the same **major** index version.
+- The last good result is cached in OpenCode plugin storage for `refreshHours`.
+  A cache older than 30 days is ignored.
+- The model registry reloads only when the score data actually changes.
+- Unscored models show `AA n/a`. A model with no registry cost shows
+  `pricing n/a` (or `n/a` in compact mode).
+
+## Limitations
+
+- The built-in picker has no plugin column API, so the summary is appended to
+  the model **name**. Set `decorateNames: false` to leave names untouched.
+- Prices are catalog prices, not your invoice. Providers can add surcharges,
+  discounts, or regional pricing that the registry does not carry.
+- AA scores are comparative within one index major version. The plugin never
+  mixes a v5 snapshot into a v6 result.
+- The plugin only decorates the list and prints a table. It does not route
+  requests or change model selection.
+
+## Development
+
+Requires Node.js 20 or newer.
+
+```sh
+npm ci
+npm run typecheck
+npm test
+npm pack --dry-run
+```
+
+The package exports raw TypeScript (`src/index.ts`); OpenCode 2.2.x transpiles
+it at load. Plain Node cannot import the installed package from `node_modules`.
+
+## Attribution
+
+Scores and related model data are produced by
+[Artificial Analysis](https://artificialanalysis.ai/). The `/model-pricing`
+header carries the source, index version, capture/fetch date, and attribution
+link. See [`NOTICE`](NOTICE) and [`SNAPSHOT-NOTICE.md`](SNAPSHOT-NOTICE.md) for
+provenance.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "opencode-model-price-intel",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "OpenCode 2 plugin that adds input/output/cache prices and Artificial Analysis Intelligence Index scores to /models, plus a full /model-pricing table.",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "types": "./src/index.ts",
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@opencode/plugin": "2.2.5"
+  },
+  "devDependencies": {
+    "@types/node": "22.20.5",
+    "typescript": "5.9.3"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "node --import ./scripts/register-ts.mjs --test test/*.test.ts",
+    "prepublishOnly": "npm run typecheck && npm test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chris15joseph/opencode-model-price-intel.git"
+  },
+  "author": "Christopher Joseph <chrisjoseph15496@gmail.com>",
+  "homepage": "https://github.com/chris15joseph/opencode-model-price-intel#readme",
+  "bugs": {
+    "url": "https://github.com/chris15joseph/opencode-model-price-intel/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "pricing",
+    "model-pricing",
+    "model-cost",
+    "artificial-analysis",
+    "intelligence-index",
+    "llm",
+    "cost"
+  ],
+  "license": "MIT"
+}