@aggc/or-info 0.2.16 → 0.2.18

package/README.md

@@ -352,33 +352,7 @@ Additional entry points:
 
 ## Release
 
-Releases are published automatically to npm from GitHub Actions when a version tag is pushed.
-The package is public under the `@aggc` npm scope.
-
-Release checklist:
-
-1. Update `CHANGELOG.md`.
-2. Bump `version` in `package.json` **and** `manifest.json` (must match).
-3. Run `npm test`.
-4. Commit and push to `main`.
-5. Create and push a matching tag:
-
-```bash
-git tag v0.x.0
-git push origin v0.x.0
-```
-
-The publish workflow runs `npm ci`, `npm run test:local`, then
-`npm publish --provenance --access public`.
-
-Repository release requirements:
-
-- GitHub secret `NPM_TOKEN` must exist for `jmtrs/or-info`.
-- The token must have npm publish permission for `@aggc/or-info`.
-- `id-token: write` is enabled so npm provenance is attached to published versions.
-
-After the initial package bootstrap, prefer migrating to npm Trusted Publishing and then
-remove `NPM_TOKEN` from the repository secrets.
+See [CHANGELOG.md](CHANGELOG.md) for release history and details.
 
 ## Contributing
 

package/bin/or-info.mjs

@@ -4,7 +4,7 @@ import { InvalidArgumentError, program } from 'commander';
 import chalk from 'chalk';
 
 const { version } = createRequire(import.meta.url)('../package.json');
-import { fetchModels, findModel, pricePerMillion, contextLength } from '../lib/openrouter.mjs';
+import { fetchModels, findModel, pricePerMillion, contextLength, isFree } from '../lib/openrouter.mjs';
 import { getElo, getAllElo, loadLeaderboard } from '../lib/lmarena.mjs';
 import { rankModels } from '../lib/scorer.mjs';
 import { clearAll, status } from '../lib/cache.mjs';

package/lib/formatter.mjs

@@ -18,6 +18,15 @@ function fmtPrice(n) {
   return RED(`$${n.toFixed(4)}`);
 }
 
+function maybeFreeWarning(model, price) {
+  // OpenRouter sometimes reports pricing="0" for non-free models (e.g. z-ai/glm-5.1).
+  // Show a warning so users don't get surprised by charges.
+  if (price.input === 0 && price.output === 0 && !model?.id?.endsWith(':free') && model?.id !== 'openrouter/free') {
+    return YELLOW('  ⚠ reported free — may incur charges on OpenRouter');
+  }
+  return null;
+}
+
 function fmtCtx(n) {
   if (!n) return DIM('n/a');
   if (n >= 1_000_000) return CYAN(`${(n / 1_000_000).toFixed(1)}M`);
@@ -46,8 +55,9 @@ export function modelTable(models, { showTags = false } = {}) {
     const price = pricePerMillion(m);
     const ctx = contextLength(m);
     const tags = showTags ? modelTags(m) : [];
+    const idLabel = maybeFreeWarning(m, price) ? m.id + YELLOW(' ⚠') : m.id;
     return {
-      id: m.id,
+      id: idLabel,
       name: m.name ?? m.id,
       input: fmtPrice(price.input),
       output: fmtPrice(price.output),
@@ -95,6 +105,9 @@ export function modelDetail(model, bench = null) {
     `  Output  ${fmtPrice(price.output)} per 1M tokens`,
   ];
 
+  const freeWarn = maybeFreeWarning(model, price);
+  if (freeWarn) lines.push(freeWarn);
+
   if (price.image !== null) lines.push(`  Image   ${fmtPrice(price.image)} per 1M tokens`);
   if (price.cacheRead !== null) lines.push(`  Cache↓  ${fmtPrice(price.cacheRead)} per 1M tokens`);
   if (price.cacheWrite !== null) lines.push(`  Cache↑  ${fmtPrice(price.cacheWrite)} per 1M tokens`);

package/lib/openrouter.mjs

@@ -135,6 +135,11 @@ export function modelTags(model) {
 }
 
 export function isFree(model) {
-  const p = pricePerMillion(model);
-  return p.input === 0 && p.output === 0;
+  // A model is genuinely free only if it carries the :free suffix
+  // or is a known free-tier model. OpenRouter sometimes reports
+  // pricing.prompt="0" & pricing.completion="0" for models that are NOT free
+  // (e.g. z-ai/glm-5.1) — a known API inconsistency.
+  if (model?.id?.endsWith(':free')) return true;
+  if (model?.id === 'openrouter/free') return true;
+  return false;
 }

package/mcp/server.mjs

@@ -3,7 +3,7 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { fetchModels, findModel, pricePerMillion, contextLength, modelTags } from '../lib/openrouter.mjs';
+import { fetchModels, findModel, pricePerMillion, contextLength, modelTags, isFree } from '../lib/openrouter.mjs';
 import { getElo, getAllElo, loadLeaderboard } from '../lib/lmarena.mjs';
 import { rankModels } from '../lib/scorer.mjs';
 import { getApiKey } from '../lib/secrets.mjs';
@@ -294,7 +294,7 @@ async function handleTool(name, args) {
 
     let models = await fetchModels({ apiKey: key });
     if (filter) models = models.filter((m) => m.id.toLowerCase().includes(filter) || (m.name ?? '').toLowerCase().includes(filter));
-    if (freeOnly) models = models.filter((m) => { const p = pricePerMillion(m); return p.input === 0 && p.output === 0; });
+    if (freeOnly) models = models.filter(isFree);
 
     if (sortBy === 'price') models.sort((a, b) => (pricePerMillion(a).output ?? Infinity) - (pricePerMillion(b).output ?? Infinity));
     else if (sortBy === 'context') models.sort((a, b) => (contextLength(b) ?? 0) - (contextLength(a) ?? 0));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aggc/or-info",
-  "version": "0.2.16",
+  "version": "0.2.18",
   "description": "CLI + MCP server for OpenRouter models: prices, benchmarks, context and comparisons",
   "type": "module",
   "engines": {