@anjieyang/uncommon-route 0.2.8 → 0.3.0

package/README.md

@@ -1,6 +1,8 @@
+<p align="right"><strong>English</strong> | <a href="https://github.com/CommonstackAI/UncommonRoute/blob/main/README.zh-CN.md">简体中文</a></p>
+
 # @anjieyang/uncommon-route
 
-OpenClaw plugin for [UncommonRoute](https://github.com/anjieyang/UncommonRoute), the local LLM router that sends easy requests to cheaper models and saves stronger models for harder work.
+OpenClaw plugin for [UncommonRoute](https://github.com/CommonstackAI/UncommonRoute), the local LLM router that sends easy requests to cheaper models and saves stronger models for harder work.
 
 If you use OpenClaw and want one local endpoint with smart routing behind it, this plugin is the shortest path.
 
@@ -15,7 +17,7 @@ This plugin:
 - installs the Python `uncommon-route` package if needed
 - starts `uncommon-route serve`
 - registers the local provider with OpenClaw
-- exposes the virtual routing profiles like `uncommon-route/auto`
+- exposes the virtual routing modes like `uncommon-route/auto`
 
 ## Install
 
@@ -48,32 +50,32 @@ plugins:
 Common upstream choices:
 
 | Provider | URL |
-|---|---|
+| --- | --- |
+| [Parallax](https://github.com/GradientHQ/parallax) | `http://127.0.0.1:3001/v1` |
 | [Commonstack](https://commonstack.ai) | `https://api.commonstack.ai/v1` |
 | OpenAI | `https://api.openai.com/v1` |
 | Local Ollama / vLLM | `http://127.0.0.1:11434/v1` |
 
 If your upstream needs a key, set `UNCOMMON_ROUTE_API_KEY` in the environment where OpenClaw runs.
 
+Parallax is best treated as an experimental local upstream for now: its public docs show `POST /v1/chat/completions`, but UncommonRoute model discovery may be limited because a public `/v1/models` route was not obvious in the repo.
+
 ## What You Get
 
+- a local OpenClaw provider backed by `http://127.0.0.1:8403/v1`
 - `uncommon-route/auto` for balanced smart routing
-- `uncommon-route/eco` for cheapest capable routing
-- `uncommon-route/premium` for quality-first routing
-- `uncommon-route/free` for free-first routing
-- `uncommon-route/agentic` for tool-heavy workflows
+- hardcoded additional virtual modes: `uncommon-route/fast` and `uncommon-route/best`
 
-The router also keeps a fallback chain, applies session-aware routing, and exposes a local dashboard at `http://127.0.0.1:8403/dashboard/`.
+The router also keeps a fallback chain, records local feedback, and exposes a local dashboard at `http://127.0.0.1:8403/dashboard/`.
 
 ## OpenClaw Commands
 
 | Command | Description |
-|---|---|
+| --- | --- |
 | `/route <prompt>` | Preview which model the router would pick |
 | `/spend status` | Show current spending and limits |
 | `/spend set hourly 5.00` | Set an hourly spend limit |
-| `/feedback ok\|weak\|strong` | Rate the last routing decision |
-| `/sessions` | Show active routing sessions |
+| `/feedback <signal>` | Use `ok`, `weak`, `strong`, `status`, or `rollback` to rate the last routing decision or inspect feedback state |
 
 ## Troubleshooting
 
@@ -94,9 +96,9 @@ Current repo benchmarks:
 
 ## Links
 
-- [GitHub](https://github.com/anjieyang/UncommonRoute)
+- [GitHub](https://github.com/CommonstackAI/UncommonRoute)
 - [PyPI](https://pypi.org/project/uncommon-route/)
-- [Full README](https://github.com/anjieyang/UncommonRoute#readme)
+- [Full README](https://github.com/CommonstackAI/UncommonRoute#readme)
 
 ## License
 

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "@anjieyang/uncommon-route",
   "name": "UncommonRoute",
-  "description": "Local LLM router that cuts premium-model spend with smart routing, sessions, and spend control",
+  "description": "Local LLM router that cuts premium-model spend with smart routing, local feedback, and spend control",
   "configSchema": {
     "type": "object",
     "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anjieyang/uncommon-route",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "description": "OpenClaw plugin for UncommonRoute, the local LLM router that cuts premium-model spend",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -10,13 +10,13 @@
  *     → ensures `uncommon-route` Python package is installed (pipx/uv/pip)
  *     → spawns `uncommon-route serve` as a managed subprocess
  *     → registerProvider pointing at localhost proxy
- *     → registerCommand for /route, /spend, /sessions
+ *     → registerCommand for /route, /spend, /feedback
  */
 
 import { spawn, execSync } from "node:child_process";
 import { setTimeout as sleep } from "node:timers/promises";
 
-const VERSION = "0.2.8";
+const VERSION = "0.3.0";
 const DEFAULT_PORT = 8403;
 const DEFAULT_UPSTREAM = "";
 const HEALTH_TIMEOUT_MS = 15_000;
@@ -25,10 +25,8 @@ const PY_PACKAGE = "uncommon-route";
 
 const MODELS = [
   { id: "uncommon-route/auto", name: "UncommonRoute Auto", reasoning: false, input: 0, output: 0, ctx: 200_000, max: 16_384 },
-  { id: "uncommon-route/eco", name: "UncommonRoute Eco", reasoning: false, input: 0, output: 0, ctx: 200_000, max: 16_384 },
-  { id: "uncommon-route/premium", name: "UncommonRoute Premium", reasoning: true, input: 0, output: 0, ctx: 200_000, max: 16_384 },
-  { id: "uncommon-route/free", name: "UncommonRoute Free", reasoning: false, input: 0, output: 0, ctx: 200_000, max: 16_384 },
-  { id: "uncommon-route/agentic", name: "UncommonRoute Agentic", reasoning: true, input: 0, output: 0, ctx: 200_000, max: 16_384 },
+  { id: "uncommon-route/fast", name: "UncommonRoute Fast", reasoning: false, input: 0, output: 0, ctx: 200_000, max: 16_384 },
+  { id: "uncommon-route/best", name: "UncommonRoute Best", reasoning: true, input: 0, output: 0, ctx: 200_000, max: 16_384 },
   { id: "moonshot/kimi-k2.5", name: "Kimi K2.5", reasoning: false, input: 0.60, output: 3.00, ctx: 128_000, max: 8_192 },
   { id: "google/gemini-3.1-pro", name: "Gemini 3.1 Pro", reasoning: false, input: 2.00, output: 12.00, ctx: 200_000, max: 16_384 },
   { id: "xai/grok-4-1-fast-reasoning", name: "Grok 4.1 Fast", reasoning: true, input: 0.20, output: 0.50, ctx: 200_000, max: 16_384 },
@@ -220,7 +218,7 @@ const plugin = {
     api.registerProvider({
       id: "uncommon-route",
       label: "UncommonRoute",
-      docsPath: "https://github.com/anjieyang/UncommonRoute",
+      docsPath: "https://github.com/CommonstackAI/UncommonRoute",
       aliases: ["ur", "uncommon"],
       envVars: [],
       get models() { return buildModels(baseUrl); },
@@ -350,23 +348,6 @@ const plugin = {
       },
     });
 
-    api.registerCommand({
-      name: "sessions",
-      description: "View active routing sessions",
-      acceptsArgs: false,
-      requireAuth: false,
-      handler: async () => {
-        const data = await fetchJson(`http://127.0.0.1:${port}/v1/sessions`);
-        if (!data) return { text: "Proxy not running.", isError: true };
-        if (data.count === 0) return { text: "No active sessions" };
-        const lines = [`**Active Sessions** (${data.count})`, ""];
-        for (const s of data.sessions) {
-          lines.push(`• \`${s.id}\`  model=${s.model}  tier=${s.tier}  requests=${s.requests}  age=${s.age_s}s`);
-        }
-        return { text: lines.join("\n") };
-      },
-    });
-
     // 3. Register service for lifecycle
     api.registerService({
       id: "uncommon-route-proxy",