@blockrun/clawrouter 0.12.286 → 0.12.287

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.
Files changed (5) hide show
  1. package/README.md +35 -0
  2. package/dist/cli.js +47567 -41123
  3. package/dist/index.d.ts +124 -123
  4. package/dist/index.js +6783 -365
  5. package/package.json +2 -1
package/README.md CHANGED
@@ -994,3 +994,38 @@ ClawRouter itself is free and MIT licensed. You pay only for the LLM API calls r
994
994
  ⭐ If ClawRouter powers your agents, consider starring the repo!
995
995
 
996
996
  </div>
997
+
998
+ ### Shared model catalog
999
+
1000
+ ClawRouter refreshes model metadata through `@blockrun/model-catalog`, pinned to
1001
+ an immutable commit and bundled into the plugin. The active Base, Solana or
1002
+ API-key gateway supplies live chat model IDs, prices and limits. A background
1003
+ refresh at startup and every five minutes updates `/v1/models`, price estimates,
1004
+ and the plugin's OpenClaw provider/allowlist and per-agent model caches. Newly discovered chat models become
1005
+ explicit picker choices without rebuilding ClawRouter. OpenClaw must reload its
1006
+ provider configuration to display a changed list; the proxy serves the updated
1007
+ list immediately.
1008
+
1009
+ Restart an already-running proxy once after installing this integration. Reusing
1010
+ an older external proxy cannot give that process the new refresh behavior.
1011
+
1012
+ The public picker policy defaults to
1013
+ `https://raw.githubusercontent.com/BlockRunAI/model-catalog/main/dist/snapshot.v1.json`.
1014
+ Set `BLOCKRUN_MODEL_CATALOG_URL` to another policy URL, or an empty string to use
1015
+ the bundled policy with live gateway rows. Policy requests never receive the API
1016
+ key; catalog redirects are refused. Each proxy owns its cache. Network failures
1017
+ retain the last complete view, and offline startup retains the existing bundled
1018
+ ClawRouter catalog. Invalid policy keeps the last good policy while valid gateway
1019
+ rows can still refresh.
1020
+
1021
+ Existing aliases, curated legacy entries, virtual routes, free fallback order,
1022
+ and Auto routing candidates remain product policy. Live rows update prices for
1023
+ known models and add new chat choices; they do not promote a new model into Auto
1024
+ or assume that a `coding` category proves structured tool support. Known
1025
+ capability overrides remain in place. A gateway update cannot reclassify a pinned
1026
+ `free/` choice as paid. Models absent from a later refresh lose newly discovered
1027
+ picker entries; legacy pinned IDs remain available for gateway redirects.
1028
+
1029
+ This integrates metadata, not payment signing or upstream protocol support.
1030
+ New protocols still require gateway compatibility. Gateway payment quotes and
1031
+ account settlement remain authoritative; catalog prices are estimates.