trantor 0.17.45 → 0.17.47

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Trantor — the hub-world for AI agent crews: live message bus, presence, project Kanban/flow board + context-handoff for independent AI coding agents (Claude, Codex, Gemini, …)",
-    "version": "0.17.45"
+    "version": "0.17.47"
   },
   "plugins": [
     {
       "name": "trantor",
       "source": "./",
       "description": "The hub-world for AI agent crews. Say \"fire up the crew\" and Claude becomes the architect: a plan-aware Advisor routes the work (solo / cheap inline calls / live crew of Codex, GLM, Kimi & DeepSeek in their own terminal windows), a Kanban/flow command center with a testing gate tracks it, and an economics brain (Scrooge) keeps the receipts. Includes the relay MCP, a SessionStart auto-discovery hook, and a PreCompact context-handoff so a fresh session can take over a full window instead of compacting.",
-      "version": "0.17.45",
+      "version": "0.17.47",
       "author": {
         "name": "Sasha Bogojevic"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.45",
+  "version": "0.17.47",
   "description": "Trantor — the hub-world for AI agent crews: live message bus, presence, project Kanban/flow board + crew orchestration for independent AI coding agents (Claude, Codex, Gemini, Kimi, DeepSeek)",
   "mcpServers": {
     "relay": {

package/bin/advise.mjs

@@ -19,52 +19,73 @@ import { pathToFileURL } from "node:url";
 const H = homedir();
 const read = (p, fb) => { try { return JSON.parse(readFileSync(p, "utf8")); } catch { return fb; } };
 
-// ---- canonical crew roster (single source of truth, mirrors bin/doctor.mjs) ----
-// Each token maps to: the CLI binary that must exist · the `trantor up` LAUNCH spec the
-// orchestrator runs · the bus SESSION name (= spec's agent part) · the profile PROVIDER
-// key that gates the seat and supplies the tier.
+// ---- crew roster: BUILT-IN seats + ANY opencode provider the user has brought (BYOM) ----
+// Each seat: the CLI binary that must exist (`cli`) · the `trantor up` LAUNCH spec · the bus
+// SESSION label (its identity on the board) · the profile PROVIDER key (tier/cost) · for
+// opencode-driven seats, the opencode PROVIDER id (`providerOc`) used to enumerate models + auth.
 //
-// GEMINI is deliberately ABSENT: Google retired the free Gemini CLI seat (2026-06-18), so
-// even though the `gemini` binary is usually still on PATH, `gemini --yolo` crashes (exit 1)
-// for everyone without a paid enterprise key. Its replacement seat is GLM via opencode.
-// (Gemini still works as a Scrooge cheap-model via GEMINI_API_KEY — a separate path.) A
-// paid-key holder can still force it with an explicit `trantor up gemini`; we just never
-// auto-recommend a dead seat.
-export const ROSTER = {
-  codex:    { cli: "codex",    launch: "codex",                  session: "codex",    provider: "codex" },
-  kimi:     { cli: "kimi",     launch: "kimi",                   session: "kimi",     provider: "kimi" },
-  deepseek: { cli: "opencode", launch: "deepseek:deepseek",      session: "deepseek", provider: "deepseek" },
-  glm:      { cli: "opencode", launch: "opencode:zai-coding-plan", session: "opencode", provider: "zai" },
-  // OpenRouter = the BYOM on-ramp: one key fronts hundreds of models (incl. vendors with no
-  // CLI of their own). Rides the opencode runner like glm/deepseek, but under its OWN bus label
-  // `openrouter` (distinct session, never collides with the glm `opencode` seat). The launcher
-  // live-selects the best OpenRouter model for the work's difficulty (or pin one:
-  // `openrouter:openrouter/<vendor>/<model>`). The model picked is what determines its strength,
-  // so it sits LAST in every CREW_PREF tier — a wildcard that fills once the proven native seats
-  // are taken, and the ONLY seat for a user who brought nothing but an OpenRouter key.
-  openrouter: { cli: "opencode", launch: "openrouter:openrouter", session: "openrouter", provider: "openrouter" },
+// GEMINI is deliberately absent: Google retired the free CLI seat (2026-06-18) → `gemini --yolo`
+// crashes exit 1. Its replacement is GLM via opencode.
+//
+// The opencode-driven seats are the BYOM substrate: opencode is a UNIVERSAL adapter, so any
+// provider the user configures in opencode (or declares in their profile) becomes a crew seat
+// with ZERO code change here — `buildRoster()` discovers them at runtime. The built-ins below are
+// just the curated defaults + the two opencode seats with non-obvious mappings (glm: profile key
+// `zai` ↔ opencode provider `zai-coding-plan`).
+export const BUILTIN_ROSTER = {
+  codex:      { cli: "codex",    launch: "codex",                   session: "codex",      provider: "codex" },
+  kimi:       { cli: "kimi",     launch: "kimi",                    session: "kimi",       provider: "kimi" },
+  deepseek:   { cli: "opencode", launch: "deepseek:deepseek",       session: "deepseek",   provider: "deepseek",   providerOc: "deepseek" },
+  glm:        { cli: "opencode", launch: "opencode:zai-coding-plan", session: "opencode",  provider: "zai",        providerOc: "zai-coding-plan" },
+  openrouter: { cli: "opencode", launch: "openrouter:openrouter",   session: "openrouter", provider: "openrouter", providerOc: "openrouter" },
 };
+// opencode provider ids already claimed by a built-in (so discovery never duplicates them) + the
+// names that are native CLIs / built-in profile aliases (never opencode-driven seats).
+const BUILTIN_OC = new Set(Object.values(BUILTIN_ROSTER).filter(s => s.providerOc).map(s => s.providerOc));
+const NEVER_DISCOVER = new Set(["claude", "codex", "kimi", "gemini", "zai", "opencode"]);
+
+// Discover opencode providers the user has configured — from opencode.json `provider` keys AND
+// from profile providers declared via `trantor provider add` — that aren't already built-in. Each
+// becomes an opencode-driven seat under its OWN bus label (distinct session, no collisions). THIS
+// is what lets a brought provider (Inception, a Japanese model, any opencode vendor) light up a
+// seat with no code edit. T2's capability ingestion then makes it route well by difficulty.
+export function discoverSeats(profile, ocConfig) {
+  const out = {};
+  const provKeys = new Set([...Object.keys(ocConfig?.provider || {}), ...Object.keys(profile?.providers || {})]);
+  for (const p of provKeys) {
+    if (BUILTIN_OC.has(p) || NEVER_DISCOVER.has(p)) continue;
+    const label = String(p).toLowerCase().replace(/[^a-z0-9-]/g, "-");
+    out[label] = { cli: "opencode", launch: `${label}:${p}`, session: label, provider: p, providerOc: p, discovered: true };
+  }
+  return out;
+}
+
+export function buildRoster(profile, ocConfig) {
+  return { ...BUILTIN_ROSTER, ...discoverSeats(profile, ocConfig) };
+}
 
 export function loadWorld() {
   const profile = read(join(H, ".agent-bus", "profile.json"), { providers: {} });
   const registry = read(join(H, ".token-scrooge", "registry.json"), { models: {}, tasks: {} });
   const caps = read(join(H, ".token-scrooge", "capabilities.json"), {});
+  const ocConfig = read(join(H, ".config", "opencode", "opencode.json"), {});
+  const roster = buildRoster(profile, ocConfig);
   const has = (c) => { try { execSync(`command -v ${c}`, { stdio: "ignore", shell: "/bin/sh" }); return true; } catch { return false; } };
-  const opencodeKey = (prov) => !!read(join(H, ".config", "opencode", "opencode.json"), {})?.provider?.[prov]?.options?.apiKey;
+  const opencodeKey = (prov) => !!ocConfig?.provider?.[prov]?.options?.apiKey;
   // a key the user already has for Scrooge counts too — the opencode runner sources these .env
-  // files, so OPENROUTER_API_KEY in ~/.token-scrooge/.env lights up the crew seat with no extra setup.
+  // files, so e.g. OPENROUTER_API_KEY in ~/.token-scrooge/.env lights up the seat with no extra setup.
   const envHasKey = (k) => !!process.env[k] || [join(H, ".token-scrooge", ".env"), join(H, ".agent-bus", ".env")]
     .some(f => { try { return readFileSync(f, "utf8").includes(k); } catch { return false; } });
-  // a seat is available only if its CLI exists AND its provider is actually set up — a present
-  // binary with a dead/missing seat (gemini, or opencode with no provider key) must NOT be recommended.
+  // a seat is available only if its CLI exists AND (for opencode-driven seats) the provider is
+  // actually set up — a present binary with a dead/missing seat must NOT be recommended.
   const hasSeat = (tok) => {
-    const r = ROSTER[tok]; if (!r || !has(r.cli)) return false;
-    if (tok === "glm") return !!profile?.providers?.zai || opencodeKey("zai-coding-plan");
-    if (tok === "openrouter") return !!profile?.providers?.openrouter || opencodeKey("openrouter") || envHasKey("OPENROUTER_API_KEY");
-    return true;
+    const s = roster[tok]; if (!s || !has(s.cli)) return false;
+    if (s.cli !== "opencode") return true;                       // native CLI present = ready
+    const envKey = `${String(s.providerOc).toUpperCase().replace(/[^A-Z0-9]/g, "_")}_API_KEY`;
+    return opencodeKey(s.providerOc) || envHasKey(envKey) || !!profile?.providers?.[s.provider];
   };
-  const agents = Object.keys(ROSTER).filter(hasSeat);
-  return { profile, registry, caps, agents, scrooge: has("scrooge") };
+  const agents = Object.keys(roster).filter(hasSeat);
+  return { profile, registry, caps, roster, agents, scrooge: has("scrooge") };
 }
 
 const tierOf = (profile, prov) => profile?.providers?.[prov]?.tier || "api";
@@ -86,7 +107,11 @@ const FORECAST = { easy: 0.3e6, medium: 1.5e6, hard: 6e6 };  // tokens
 const CREW_PREF = { hard: ["codex", "glm", "kimi", "deepseek", "openrouter"], medium: ["kimi", "glm", "codex", "deepseek", "openrouter"], easy: ["deepseek", "kimi", "glm", "codex", "openrouter"] };
 
 export function advise(input, world = loadWorld()) {
-  const { profile, registry, caps, agents, scrooge } = world;
+  const { profile, registry, caps, agents, scrooge, roster = BUILTIN_ROSTER } = world;
+  // brought (discovered) opencode providers extend the preference list — appended LAST in every
+  // tier (unknown strength a priori, like openrouter), so they fill once the curated seats are
+  // taken, and are the only option for a user who brought nothing but a custom provider.
+  const broughtPref = Object.keys(roster).filter(t => roster[t].discovered && !CREW_PREF.hard.includes(t));
   const pkgs = (input.packages || []).map(p => ({ title: p.title || "work", difficulty: ["easy", "medium", "hard"].includes(p.difficulty) ? p.difficulty : "medium", kind: p.kind || "code", owner: p.owner === "self" ? "self" : (/(foundation|integration|scaffold)/i.test(p.title) ? "self" : "") }));
   const horizon = input.horizon || (pkgs.length >= 4 ? "long" : pkgs.length >= 2 ? "medium" : "short");
   const orchTier = tierOf(profile, "claude");
@@ -121,10 +146,10 @@ export function advise(input, world = loadWorld()) {
     }
     if (p.owner === "self") return { ...p, executor: "orchestrator", pool: tierOf(profile, "claude"), reason: "architect-owned (foundation/integration doctrine) — the orchestrator keeps the shared contract in its own hands" };
     if (mode === "solo") return { ...p, executor: "orchestrator", pool: tierOf(profile, "claude"), reason: "small enough to do inline" };
-    const pref = CREW_PREF[p.difficulty].filter(a => agents.includes(a));
+    const pref = [...CREW_PREF[p.difficulty], ...broughtPref].filter(a => agents.includes(a));
     const agent = pref.sort((a, b) => (used[a] || 0) - (used[b] || 0))[0] || agents[0] || "deepseek";
     used[agent] = (used[agent] || 0) + 1;
-    const pool = tierOf(profile, ROSTER[agent]?.provider || agent);
+    const pool = tierOf(profile, roster[agent]?.provider || agent);
     let est = null;
     if (pool === "api") { // deepseek API etc — estimate real $ via registry
       const m = registry.models?.["deepseek-v4-flash"] || { cost_in: 0.14, cost_out: 0.28 };
@@ -135,10 +160,10 @@ export function advise(input, world = loadWorld()) {
       : p.difficulty === "medium"
         ? `medium → solid mid-tier (${agent}) keeps frontier seats free for hard work; ${pool === "api" ? "metered" : "quota"} pool`
         : `easy → cheapest seat (${agent})`;
-    // OpenRouter live-select ranks by COST only (the 335-model catalog has no capability scores
-    // yet — that's the capability-ingestion follow-up), so for HARD work it can land a cheap model.
-    // Flag it: pin a strong model explicitly (openrouter:openrouter/<vendor>/<model>) for hard work.
-    if (agent === "openrouter" && p.difficulty === "hard") why_r += ` — ⚠️ live-select ranks by cost; PIN a strong model (e.g. openrouter:openrouter/anthropic/claude-opus-latest) for hard work until capability data lands`;
+    // OpenRouter live-select ranks capability×cost ACROSS the catalog once `scrooge-capabilities`
+    // has scored it (AA scores + price proxy + per-difficulty cost weighting → hard escalates to a
+    // strong model, easy stays cheap). If it hasn't been run, routing falls back to cost-only.
+    if (agent === "openrouter" && p.difficulty === "hard") why_r += ` — OpenRouter ranks capability×cost; run \`scrooge-capabilities\` to keep the catalog scored (or pin openrouter:openrouter/<vendor>/<model>)`;
     return { ...p, executor: agent, pool, est_cost_usd: est, reason: why_r };
   });
   // crew-size rationale: seats are EMERGENT from the work, and we say so
@@ -165,7 +190,7 @@ export function advise(input, world = loadWorld()) {
   const selfPkgs = routing.filter(r => r.executor === "orchestrator");
   const foundationIdx = selfPkgs.length ? [1] : [];
   const cards = routing.map((r, i) => {
-    const seat = ROSTER[r.executor];
+    const seat = roster[r.executor];
     return {
     order: i + 1, title: r.title, difficulty: r.difficulty,
     // bus identity = the runner's session name (spec's agent part) — glm rides the `opencode`

package/bin/cli.mjs

@@ -18,6 +18,8 @@ switch (cmd) {
   case "doctor":  run("bin/doctor.mjs"); break;
   case "connect": run("bin/connect.mjs"); break;
   case "profile": run("bin/profile.mjs"); break;
+  case "provider": case "providers": run("bin/provider.mjs"); break;
+  case "models": run("bin/models.mjs"); break;
   case "advise":  run("bin/advise.mjs"); break;
   case "verify":  run("bin/crew-verify.mjs"); break;
   case "up":      process.argv.splice(2, 1); spawn("/bin/bash", [join(ROOT, "bin/crew.sh"), "up", ...args], { stdio: "inherit", cwd: process.cwd() }).on("exit", c => process.exit(c ?? 0)); break;
@@ -49,6 +51,8 @@ switch (cmd) {
   trantor doctor      where do I stand? hub/plugin/CLIs/auth/keys/profile, with copy-paste fixes
   trantor connect     (re)wire every installed AI CLI to the bus
   trantor profile     declare your plans:  trantor profile set claude=max codex=plus deepseek=api
+  trantor provider    bring ANY model (BYOM): list seats · add <name> --key … · remove <name>
+  trantor models      browse live models behind each seat + the router's pick per difficulty
   trantor up …        spawn a crew here:   trantor up codex kimi deepseek:deepseek opencode:zai-coding-plan
   trantor down        tear the crew down (kills processes, closes windows, no dialogs)
   trantor ui          open the live dashboard (board + flow views)

package/bin/crew-runner.mjs

@@ -78,8 +78,14 @@ const CLI = {
   claude:   { first: `claude{M} -p "$(cat {P})" --dangerously-skip-permissions`,
               next:  `claude -c{M} -p "$(cat {P})" --dangerously-skip-permissions`, mflag: " --model " },
 };
-const cli = CLI[AGENT];
-if (!cli) { console.error(`unknown agent '${AGENT}' (known: ${Object.keys(CLI).join(", ")})`); process.exit(1); }
+// BYOM: any agent label that isn't a known native CLI is treated as an opencode-driven provider
+// seat (opencode is the universal adapter). This is what lets a BROUGHT provider — `trantor up
+// <label>:<provider>` for any opencode vendor the user configured — run with no per-provider code
+// here; its model id arrives pre-qualified (`<provider>/<model>`) as CREW_MODEL.
+const NATIVE = new Set(["codex", "gemini", "kimi", "claude"]);
+const cli = CLI[AGENT] || (NATIVE.has(AGENT) ? null : CLI.opencode);
+if (!cli) { console.error(`unknown agent '${AGENT}' (native: ${[...NATIVE].join(", ")}; any other name = an opencode provider seat)`); process.exit(1); }
+if (!CLI[AGENT]) log(`'${AGENT}' is not a built-in seat — running it as an opencode provider (BYOM)`);
 
 const RULES = `Rules: you are ${SESSION} on the trantor crew. Work your assigned file(s), report on the bus (relay_send, <280 chars), move your Kanban card as you go (doing -> testing -> done; run the tests in 'testing', use 'failed' + a report if they break). When your work for THIS message is finished, END YOUR TURN — do NOT park, do NOT loop relay_wait; the runner waits for you and will wake you with the next message.`;
 

package/bin/crew.sh

@@ -70,18 +70,18 @@ SCROOGE="$BUS_DIR/engine/bin/scrooge"
 [ -f "$SCROOGE" ] || SCROOGE="$(command -v scrooge 2>/dev/null || echo scrooge)"
 
 # resolve_model <agent> <provider> <task> <diff> -> echoes a runner-ready model id, or empty
-# (→ CLI default). Enumeration is CLI-aware and never guesses an endpoint: opencode-managed
-# agents list via `opencode models <provider>`; others self-enumerate via the provider's /models.
+# (→ CLI default). PROVIDER-AGNOSTIC: if opencode knows the provider (ANY of its vendors — built-in
+# or BROUGHT), enumerate via `opencode models <provider>`; else self-enumerate via the provider's
+# OpenAI-compatible /models. No hardcoded provider list — a newly-brought opencode provider routes
+# with zero change here. Never guesses an endpoint.
 resolve_model() {
   local agent="$1" provider="$2" task="$3" diff="$4" cands="" out=""
-  case "$agent" in
-    opencode|deepseek|openrouter)
-      cands="$(opencode models "$provider" 2>/dev/null | tr '\n' ' ')"
-      [ -n "$cands" ] || { echo "[crew] no live models via 'opencode models $provider' — CLI default" >&2; return 0; }
-      out="$(python3 "$SCROOGE" route --candidates "$cands" -t "$task" -d "$diff" --json 2>/dev/null)" ;;
-    *)
-      out="$(python3 "$SCROOGE" route --provider "$provider" -t "$task" -d "$diff" --json 2>/dev/null)" ;;
-  esac
+  cands="$(opencode models "$provider" 2>/dev/null | tr '\n' ' ')"
+  if [ -n "$cands" ]; then
+    out="$(python3 "$SCROOGE" route --candidates "$cands" -t "$task" -d "$diff" --json 2>/dev/null)"
+  else
+    out="$(python3 "$SCROOGE" route --provider "$provider" -t "$task" -d "$diff" --json 2>/dev/null)"
+  fi
   [ -n "$out" ] || { echo "[crew] live model selection failed for $agent:$provider — CLI default" >&2; return 0; }
   printf '%s' "$out" | python3 -c 'import json,sys
 try: print(json.load(sys.stdin).get("qualified") or "")

package/bin/doctor.mjs

@@ -64,7 +64,7 @@ const CLIS = [
   // OpenRouter — the BYOM on-ramp: ONE key fronts hundreds of models. Rides opencode; the same
   // OPENROUTER_API_KEY Scrooge already uses authenticates the crew seat (the runner sources the
   // .env files). Available the moment the key exists in env/opencode + declared `openrouter=api`.
-  { name: "openrouter (via opencode · BYOM, hundreds of models)", bin: "opencode", wired: () => !!read(join(H, ".config", "opencode", "opencode.json"))?.mcp?.relay, auth: () => !!process.env.OPENROUTER_API_KEY || !!read(join(H, ".config", "opencode", "opencode.json"))?.provider?.openrouter?.options?.apiKey || [join(H, ".token-scrooge", ".env"), join(H, ".agent-bus", ".env")].some(f => { try { return readFileSync(f, "utf8").includes("OPENROUTER_API_KEY"); } catch { return false; } }), login: `get a key at openrouter.ai/keys, then: echo 'OPENROUTER_API_KEY=sk-or-…' >> ~/.agent-bus/.env && trantor profile set openrouter=api. Seat: trantor up openrouter (live-selects) or pin trantor up openrouter:openrouter/<vendor>/<model>` },
+  { name: "openrouter (via opencode · BYOM, hundreds of models)", bin: "opencode", wired: () => !!read(join(H, ".config", "opencode", "opencode.json"))?.mcp?.relay, auth: () => !!process.env.OPENROUTER_API_KEY || !!read(join(H, ".config", "opencode", "opencode.json"))?.provider?.openrouter?.options?.apiKey || [join(H, ".token-scrooge", ".env"), join(H, ".agent-bus", ".env")].some(f => { try { return readFileSync(f, "utf8").includes("OPENROUTER_API_KEY"); } catch { return false; } }), login: `get a key at openrouter.ai/keys, then: echo 'OPENROUTER_API_KEY=sk-or-…' >> ~/.agent-bus/.env && trantor profile set openrouter=api && scrooge-capabilities (scores the catalog so the crew routes it by difficulty). Seat: trantor up openrouter (live-selects) or pin trantor up openrouter:openrouter/<vendor>/<model>` },
 ];
 let installed = 0;
 for (const c of CLIS) {

package/bin/models.mjs

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+// trantor models — browse the live models behind your crew seats (opencode is the adapter).
+//
+//   trantor models                # every opencode-driven seat + how many live models it serves
+//   trantor models <provider>     # list that provider's live models + what the router picks per
+//                                 # difficulty (so you can see hard→strong, easy→cheap at a glance)
+import { execSync } from "node:child_process";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+import { existsSync } from "node:fs";
+import { pathToFileURL, fileURLToPath } from "node:url";
+import { buildRoster, loadWorld } from "./advise.mjs";
+
+const H = homedir();
+const C = { dim: "\x1b[2m", grn: "\x1b[32m", gold: "\x1b[38;5;208m", off: "\x1b[0m" };
+const has = (c) => { try { execSync(`command -v ${c}`, { stdio: "ignore", shell: "/bin/sh" }); return true; } catch { return false; } };
+const SCROOGE = (() => {
+  const bundled = join(dirname(dirname(fileURLToPath(import.meta.url))), "engine", "bin", "scrooge");
+  if (existsSync(bundled)) return bundled;
+  try { return execSync("command -v scrooge", { encoding: "utf8" }).trim(); } catch { return "scrooge"; }
+})();
+
+const liveModels = (providerOc) => {
+  try { return execSync(`opencode models ${providerOc} 2>/dev/null`, { encoding: "utf8" }).split("\n").filter(Boolean); }
+  catch { return []; }
+};
+
+function routePick(candList, diff) {
+  try {
+    const out = execSync(`python3 ${SCROOGE} route --candidates ${JSON.stringify(candList.join(" "))} -t code -d ${diff} --json 2>/dev/null`, { encoding: "utf8" });
+    return JSON.parse(out).qualified || "?";
+  } catch { return "?"; }
+}
+
+function listAll() {
+  const { roster, agents } = loadWorld();
+  if (!has("opencode")) { console.log("opencode not on PATH — it's the adapter that serves crew models. Install it, then re-run."); return; }
+  console.log("CREW MODELS — opencode-driven seats (● available now)\n");
+  for (const [label, s] of Object.entries(roster)) {
+    if (s.cli !== "opencode") continue;
+    const n = liveModels(s.providerOc).length;
+    const dot = agents.includes(label) ? `${C.grn}●${C.off}` : `${C.dim}○${C.off}`;
+    console.log(`  ${dot} ${label.padEnd(14)} ${C.dim}${s.providerOc}${C.off}  ${n} live models   ${C.dim}trantor models ${label}${C.off}`);
+  }
+  console.log(`\n${C.dim}detail + routing preview:${C.off} trantor models <provider>`);
+}
+
+function detail(name) {
+  const { roster } = loadWorld();
+  const seat = roster[name] || Object.values(roster).find(s => s.providerOc === name);
+  const providerOc = seat?.providerOc || name;
+  const models = liveModels(providerOc);
+  if (!models.length) { console.log(`No live models for '${providerOc}' (opencode offline / no key / unknown provider).`); return; }
+  console.log(`${C.gold}${providerOc}${C.off} — ${models.length} live models\n`);
+  for (const m of models.slice(0, 60)) console.log(`  ${m}`);
+  if (models.length > 60) console.log(`  ${C.dim}… +${models.length - 60} more${C.off}`);
+  if (existsSync(SCROOGE) || has("scrooge")) {
+    console.log(`\n${C.gold}router picks (code task):${C.off}`);
+    for (const d of ["easy", "medium", "hard"]) console.log(`  ${d.padEnd(7)} → ${routePick(models, d)}`);
+    console.log(`${C.dim}(run scrooge-capabilities to (re)score the catalog for accurate difficulty routing)${C.off}`);
+  }
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  const arg = process.argv[2];
+  if (!arg) listAll(); else detail(arg.toLowerCase());
+}

package/bin/provider.mjs

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+// trantor provider — bring ANY model to the crew (BYOM). opencode is a universal adapter, so a
+// provider you configure there (or declare here) becomes a crew seat with no code change.
+//
+//   trantor provider                 # list seats: built-in + discovered, with availability + tier
+//   trantor provider add <name> [--key sk-…] [--plan api|coding-plan|max] [--label <bus-name>]
+//   trantor provider remove <name>   # drop it from your profile (leaves the key in place)
+//
+// `add` writes <NAME>_API_KEY to ~/.agent-bus/.env (if --key given), declares the plan in your
+// quota profile, verifies opencode can see the provider's models, and prints the seat spec. The
+// Advisor then routes to it automatically; run `scrooge-capabilities` so it routes well by difficulty.
+import { readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync, appendFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
+import { pathToFileURL } from "node:url";
+import { buildRoster, loadWorld } from "./advise.mjs";
+
+const H = homedir();
+const ENV = join(H, ".agent-bus", ".env");
+const read = (p, fb) => { try { return JSON.parse(readFileSync(p, "utf8")); } catch { return fb; } };
+const has = (c) => { try { execSync(`command -v ${c}`, { stdio: "ignore", shell: "/bin/sh" }); return true; } catch { return false; } };
+const C = { dim: "\x1b[2m", grn: "\x1b[32m", red: "\x1b[31m", yel: "\x1b[33m", gold: "\x1b[38;5;208m", off: "\x1b[0m" };
+const envKeyName = (p) => `${String(p).toUpperCase().replace(/[^A-Z0-9]/g, "_")}_API_KEY`;
+
+function opencodeModelCount(providerOc) {
+  if (!has("opencode")) return null;
+  try { return execSync(`opencode models ${providerOc} 2>/dev/null`, { encoding: "utf8" }).split("\n").filter(Boolean).length; }
+  catch { return 0; }
+}
+
+function listSeats() {
+  const world = loadWorld();
+  const { roster, agents, profile } = world;
+  console.log("CREW SEATS — built-in + brought (BYOM). ● = available now\n");
+  for (const [label, s] of Object.entries(roster)) {
+    const live = agents.includes(label);
+    const tier = profile?.providers?.[s.provider]?.tier || (s.cli === "opencode" ? "—" : "");
+    const kind = s.discovered ? "brought " : "built-in";
+    const models = s.cli === "opencode" ? opencodeModelCount(s.providerOc) : null;
+    const mtxt = models == null ? "" : `${models} models`;
+    const dot = live ? `${C.grn}●${C.off}` : `${C.dim}○${C.off}`;
+    console.log(`  ${dot} ${label.padEnd(14)} ${C.dim}${kind}${C.off}  launch: ${s.launch.padEnd(26)} ${tier ? `tier=${tier}` : ""} ${C.dim}${mtxt}${C.off}`);
+  }
+  console.log(`\n${C.dim}add one:${C.off} trantor provider add <name> --key sk-… --plan api`);
+  console.log(`${C.dim}browse models:${C.off} trantor models [<provider>]`);
+}
+
+function addProvider(name, opts) {
+  if (!name) { console.error("usage: trantor provider add <name> [--key sk-…] [--plan api] [--label <bus-name>]"); process.exit(1); }
+  const provider = name.toLowerCase();
+  const label = (opts.label || provider).toLowerCase().replace(/[^a-z0-9-]/g, "-");
+  const plan = (opts.plan || "api").toLowerCase();
+
+  // 1) key → ~/.agent-bus/.env (the runner sources it; opencode reads <NAME>_API_KEY for known providers)
+  if (opts.key) {
+    mkdirSync(dirname(ENV), { recursive: true });
+    const k = envKeyName(provider);
+    let cur = existsSync(ENV) ? readFileSync(ENV, "utf8") : "";
+    if (new RegExp(`^${k}=`, "m").test(cur)) {
+      cur = cur.replace(new RegExp(`^${k}=.*$`, "m"), `${k}=${opts.key}`);
+      writeFileSync(ENV, cur);
+    } else {
+      appendFileSync(ENV, `${cur && !cur.endsWith("\n") ? "\n" : ""}# ${provider} — brought via 'trantor provider add'\n${k}=${opts.key}\n`);
+    }
+    try { chmodSync(ENV, 0o600); } catch {}
+    console.log(`${C.grn}✓${C.off} wrote ${envKeyName(provider)} → ~/.agent-bus/.env (chmod 600)`);
+  }
+
+  // 2) declare the plan in the quota profile (drives the Advisor's tier/cost reasoning)
+  try {
+    execSync(`node ${join(dirname(new URL(import.meta.url).pathname), "profile.mjs")} set ${provider}=${plan}`, { stdio: "ignore" });
+    console.log(`${C.grn}✓${C.off} profile: ${provider}=${plan}`);
+  } catch (e) { console.log(`${C.yel}⚠${C.off} could not set profile (run: trantor profile set ${provider}=${plan})`); }
+
+  // 3) verify opencode can see the provider's models
+  const n = opencodeModelCount(provider);
+  if (n == null) console.log(`${C.yel}⚠${C.off} opencode not on PATH — install it to run this seat (it's the universal adapter)`);
+  else if (n === 0) console.log(`${C.yel}⚠${C.off} opencode lists 0 models for '${provider}'. If it's a known provider, the key above is enough; for a custom endpoint, add it to ~/.config/opencode/opencode.json (provider config). Then re-check: trantor models ${provider}`);
+  else console.log(`${C.grn}✓${C.off} opencode sees ${n} models for '${provider}'`);
+
+  // 4) score it for difficulty-aware routing + show the seat
+  console.log(`\n${C.gold}Seat ready.${C.off} Launch it:`);
+  console.log(`  trantor up ${label === provider ? label : `${label}:${provider}`}            ${C.dim}# live-selects the best model for the work${C.off}`);
+  console.log(`  trantor up ${label}:${provider}/<model>     ${C.dim}# pin a specific model${C.off}`);
+  console.log(`${C.dim}For difficulty-aware routing across its catalog, score it once (weekly):${C.off} scrooge-capabilities`);
+}
+
+function removeProvider(name) {
+  if (!name) { console.error("usage: trantor provider remove <name>"); process.exit(1); }
+  const FILE = join(H, ".agent-bus", "profile.json");
+  const prof = read(FILE, { providers: {} });
+  if (prof.providers && prof.providers[name.toLowerCase()]) {
+    delete prof.providers[name.toLowerCase()];
+    writeFileSync(FILE, JSON.stringify(prof, null, 2) + "\n");
+    console.log(`${C.grn}✓${C.off} removed '${name}' from your profile (the ${envKeyName(name)} key is left in place; delete it from ~/.agent-bus/.env if you want it gone)`);
+  } else {
+    console.log(`'${name}' is not in your profile.`);
+  }
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  const [, , sub, ...rest] = process.argv;
+  const opts = {}; const pos = [];
+  for (let i = 0; i < rest.length; i++) {
+    if (rest[i] === "--key") opts.key = rest[++i];
+    else if (rest[i] === "--plan") opts.plan = rest[++i];
+    else if (rest[i] === "--label") opts.label = rest[++i];
+    else pos.push(rest[i]);
+  }
+  if (!sub || sub === "list") listSeats();
+  else if (sub === "add") addProvider(pos[0], opts);
+  else if (sub === "remove" || sub === "rm") removeProvider(pos[0]);
+  else { console.error(`unknown subcommand '${sub}' — use: list | add | remove`); process.exit(1); }
+}

package/engine/bin/scrooge

@@ -171,8 +171,11 @@ def model_quality(caps, mid, metric):
         v = c.get("intelligence")          # fall back to the general index
     return float(v) if isinstance(v, (int, float)) else 0.0
 
-def blended_cost(reg, mid):
-    m = reg["models"].get(mid, {})
+def blended_cost(reg, caps, mid):
+    # The curated registry carries cost for its own models; for CATALOG models (OpenRouter's
+    # hundreds, brought via --candidates) the per-model price rides on the capability entry
+    # instead — so a brought model is ranked on its real price without bloating the registry.
+    m = reg["models"].get(mid) or (caps.get(mid) if isinstance(caps, dict) else None) or {}
     return max(1e-6, 0.3 * m.get("cost_in", 0) + 0.7 * m.get("cost_out", 0))
 
 def weigh_candidates(reg, caps, cand_ids, task, difficulty):
@@ -187,8 +190,16 @@ def weigh_candidates(reg, caps, cand_ids, task, difficulty):
         floor = scored_q[min(len(scored_q) - 1, int(round(pct * (len(scored_q) - 1))))]
     survivors = [(mid, q) for mid, q in quals if q >= floor] or quals
     rw = reg.get("routing") or {}
-    qw, cw = rw.get("q_weight", 1.5), rw.get("c_weight", 0.5)
-    out = [(mid, (max(q, 1e-6) ** qw) / (blended_cost(reg, mid) ** cw)) for mid, q in survivors]
+    qw = rw.get("q_weight", 1.5)
+    # cost-weight scales DOWN as difficulty rises: EASY work optimizes price (cheap wins), HARD
+    # work prioritizes capability so it can escalate to a genuinely strong model instead of the
+    # cheapest-that-clears-the-floor (the "deepseek-flash wins everything" trap on a huge catalog).
+    # It still weighs cost (hard picks a strong *value* model, not a blind frontier overpay).
+    # Per-difficulty override via registry.routing.c_weight_<difficulty>; legacy c_weight still honored.
+    CW_BY_DIFF = {"easy": 0.65, "medium": 0.5, "hard": 0.1}
+    cw_key = "c_weight_" + str(difficulty)
+    cw = rw[cw_key] if cw_key in rw else (CW_BY_DIFF[difficulty] if difficulty in CW_BY_DIFF else rw.get("c_weight", 0.5))
+    out = [(mid, (max(q, 1e-6) ** qw) / (blended_cost(reg, caps, mid) ** cw)) for mid, q in survivors]
     out.sort(key=lambda x: -x[1])
     return out
 

package/engine/bin/scrooge-capabilities

@@ -22,7 +22,7 @@ Usage:  scrooge-capabilities            # refresh from AA (+OpenRouter), show a
         scrooge-capabilities --dry-run  # fetch + match, print, but don't write
 Exit: 0 updated · 1 nothing fetched (no key / network) · 2 error.
 """
-import sys, os, json, argparse, urllib.request, urllib.error
+import sys, os, json, argparse, math, urllib.request, urllib.error
 
 HOME = os.path.expanduser("~")
 SCROOGE_DIR = os.environ.get("SCROOGE_HOME", os.path.join(HOME, ".token-scrooge"))
@@ -122,13 +122,35 @@ def fetch_openrouter():
         if not mid:
             continue
         arch = m.get("architecture") or {}
-        out[norm(mid.split("/")[-1])] = {
+        pr = m.get("pricing") or {}
+        def _per_m(v):                       # OpenRouter prices are USD PER TOKEN → $/1M tokens
+            try:
+                return round(float(v) * 1e6, 4)
+            except Exception:
+                return None
+        # KEY BY THE RAW LAST SEGMENT (dots intact) — this is exactly what `scrooge route` uses to
+        # look a candidate up (by_bare = id.split("/")[-1], no normalisation), so the keys must match.
+        out[mid.split("/")[-1]] = {
+            "full": mid,
             "context": m.get("context_length"),
             "modalities": arch.get("input_modalities"),
+            "cost_in": _per_m(pr.get("prompt")),
+            "cost_out": _per_m(pr.get("completion")),
         }
-    sys.stderr.write(DIM("  OpenRouter: %d models fetched (context/modality).\n" % len(out)))
+    sys.stderr.write(DIM("  OpenRouter: %d models fetched (pricing/context/modality).\n" % len(out)))
     return out
 
+def price_proxy_capability(cost_out):
+    """A transparent fallback capability when AA has no score for a brought model: price is a
+    decent proxy for tier (frontier models cost more). Monotonic in cost_out ($/1M), with an
+    HONEST ceiling — never claim frontier capability from price alone. Gives every catalog model
+    a non-zero, rank-able score so the difficulty floor can separate hard from easy work; a later
+    AA refresh upgrades it to a real score."""
+    if not isinstance(cost_out, (int, float)) or cost_out <= 0:
+        return 8.0                            # free / unknown price → low floor
+    cap = 30.0 + 20.0 * math.log10(cost_out + 0.1)
+    return round(max(5.0, min(72.0, cap)), 1)
+
 def aa_scores(m):
     ev = m.get("evaluations") or {}
     g = ev.get("gpqa")
@@ -162,6 +184,7 @@ def main():
         return 1
 
     today = __import__("time").strftime("%Y-%m-%d")
+    by_or_norm = {norm(k): v for k, v in by_or.items()}   # by_or is raw-keyed; registry ids are dash-form
     matched, unmatched = [], []
     for mid in reg["models"]:
         existing = caps.get(mid) if isinstance(caps.get(mid), dict) else {}
@@ -175,7 +198,7 @@ def main():
             matched.append(mid)
         elif by_slug:
             unmatched.append(mid)
-        orx = by_or.get(norm(mid))
+        orx = by_or_norm.get(norm(mid))
         if orx:
             if orx.get("context"):
                 rec["context"] = orx["context"]
@@ -184,10 +207,53 @@ def main():
         if rec:
             caps[mid] = rec
 
+    # ---- OpenRouter CATALOG ingestion: make every brought model routable by difficulty -------
+    # The crew passes OpenRouter's hundreds of models as candidates; the router ranks by
+    # capability (gated by a difficulty floor) ÷ price. Write each catalog model as a first-class
+    # entry keyed by its RAW bare name (matching `scrooge route`'s lookup): a REAL AA score when
+    # the model matches a slug, else a transparent price-tier PROXY — plus its real price so cost
+    # ranking works. Registry-curated models are never shadowed. Marked `_src` for honesty; a
+    # later AA refresh upgrades proxies in place.
+    or_real = or_proxy = 0
+    for bare, info in by_or.items():
+        if bare in reg["models"]:                     # curated registry model — leave it authoritative
+            continue
+        existing = caps.get(bare) if isinstance(caps.get(bare), dict) else {}
+        rec = dict(existing)
+        if info.get("cost_in") is not None:
+            rec["cost_in"] = info["cost_in"]
+        if info.get("cost_out") is not None:
+            rec["cost_out"] = info["cost_out"]
+        if info.get("context"):
+            rec.setdefault("context", info["context"])
+        has_real = isinstance(rec.get("coding"), (int, float)) or isinstance(rec.get("intelligence"), (int, float))
+        am = None
+        if by_slug:
+            full = info.get("full", "")
+            am = by_slug.get(norm(full)) or by_slug.get(norm(full.split("/")[-1])) or by_slug.get(bare)
+        if am:
+            rec.update({k: v for k, v in aa_scores(am).items() if v is not None})
+            rec["updated"] = today
+            rec["source"] = "artificialanalysis"
+            rec.pop("_src", None)
+            or_real += 1
+        elif not has_real or rec.get("_src") == "openrouter-price-proxy":
+            p = price_proxy_capability(rec.get("cost_out"))
+            if p is not None:
+                rec["coding"] = rec["intelligence"] = rec["reasoning"] = p
+                rec["_src"] = "openrouter-price-proxy"
+                rec["updated"] = today
+                or_proxy += 1
+        if rec:
+            caps[bare] = rec
+
     caps["_meta"].update({"source": "artificialanalysis.ai + openrouter", "refreshed": today,
-                          "attribution": "https://artificialanalysis.ai/"})
+                          "attribution": "https://artificialanalysis.ai/",
+                          "openrouter_catalog": {"aa_scored": or_real, "price_proxy": or_proxy}})
 
     sys.stderr.write(GOLD("🪙 scrooge-capabilities — %d matched, %d unmatched\n" % (len(matched), len(unmatched))))
+    if by_or:
+        sys.stderr.write(GOLD("   OpenRouter catalog — %d AA-scored, %d price-proxy (now routable by difficulty)\n" % (or_real, or_proxy)))
     for mid in matched:
         c = caps[mid]
         sys.stderr.write("  %s %-24s intel=%-5s code=%-5s reason=%-5s %st/s\n" % (

package/engine/test-routing.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+"""Regression test for capability×cost routing — difficulty-aware escalation + catalog cost.
+
+Runs the real weigh_candidates/blended_cost out of bin/scrooge against SYNTHETIC capability
+data (no network, no key), asserting:
+  1. catalog cost rides on the capability entry (blended_cost falls back to caps when the
+     registry doesn't have the model) — the OpenRouter-routing fix,
+  2. cost-weight is difficulty-aware: a cheap-but-decent model wins EASY, while HARD escalates
+     to a genuinely stronger model instead of the cheapest-that-clears-the-floor.
+
+Exit 0 = all pass. Used to verify the T2 OpenRouter-routes-by-difficulty change.
+"""
+import os, sys
+
+HERE = os.path.dirname(os.path.realpath(__file__))
+SCROOGE = os.path.join(HERE, "bin", "scrooge")
+g = {"__name__": "scr", "__file__": SCROOGE}
+exec(compile(open(SCROOGE).read(), "scrooge", "exec"), g)
+
+# Synthetic registry has NO catalog models — cost must come from caps (the OpenRouter case).
+reg = {"models": {}, "routing": {}}
+caps = {
+    "cheap-weak":   {"coding": 20, "cost_in": 0.05, "cost_out": 0.10},   # junk-tier
+    "cheap-strong": {"coding": 56, "cost_in": 0.14, "cost_out": 0.28},   # deepseek-flash-like
+    "mid-strong":   {"coding": 69, "cost_in": 0.60, "cost_out": 2.40},   # glm-5.2-like
+    "frontier":     {"coding": 75, "cost_in": 5.00, "cost_out": 22.50},  # gpt-5.5-like
+}
+cands = list(caps.keys())
+
+fails = []
+def ok(name, cond):
+    print(("  ✓ " if cond else "  ✗ ") + name)
+    if not cond:
+        fails.append(name)
+
+# 1. catalog cost via caps fallback (model absent from registry)
+ok("blended_cost falls back to the capability entry for catalog models",
+   abs(g["blended_cost"](reg, caps, "frontier") - (0.3 * 5.0 + 0.7 * 22.5)) < 1e-6)
+ok("blended_cost is 1e-6 for an entirely unknown model (no crash)",
+   g["blended_cost"](reg, caps, "does-not-exist") == 1e-6)
+
+def winner(diff):
+    return g["weigh_candidates"](reg, caps, cands, "code", diff)[0][0]
+
+easy, medium, hard = winner("easy"), winner("medium"), winner("hard")
+print("  picks → easy=%s medium=%s hard=%s" % (easy, medium, hard))
+
+# 2. difficulty-aware escalation
+ok("easy prefers a cheap model (cost-optimized)", caps[easy]["coding"] <= caps["mid-strong"]["coding"])
+ok("hard escalates to a stronger model than easy", caps[hard]["coding"] > caps[easy]["coding"])
+ok("hard reaches genuine strength (>= mid-strong tier)", caps[hard]["coding"] >= caps["mid-strong"]["coding"])
+ok("the junk-tier model never wins any difficulty", "cheap-weak" not in (easy, medium, hard))
+
+print(("\nALL PASS" if not fails else "\nFAILED: %d" % len(fails)))
+sys.exit(1 if fails else 0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.45",
+  "version": "0.17.47",
   "type": "module",
   "bin": {
     "trantor": "bin/cli.mjs"
@@ -10,9 +10,9 @@
     "zod": "^4.4.3"
   },
   "scripts": {
-    "test": "node test.mjs && node test-scenarios.mjs && node test-failure.mjs && node test-handoff.mjs && node test-agents.mjs && node test-update.mjs && node test-handoff-guard.mjs && node test-balances.mjs && node test-subagent-cost.mjs && node test-inbox.mjs && node test-inflight.mjs && node test-focus.mjs"
+    "test": "node test.mjs && node test-scenarios.mjs && node test-failure.mjs && node test-handoff.mjs && node test-agents.mjs && node test-update.mjs && node test-handoff-guard.mjs && node test-balances.mjs && node test-subagent-cost.mjs && node test-inbox.mjs && node test-inflight.mjs && node test-focus.mjs && python3 engine/test-routing.py"
   },
-  "description": "The hub-world for AI agent crews — orchestrate Claude Code, Codex, Gemini, Kimi & DeepSeek as live crews with a plan-aware Advisor, a Kanban/flow command center, a testing gate, and an economics brain (Scrooge).",
+  "description": "The hub-world for AI agent crews — orchestrate Claude Code, Codex, GLM, Kimi, DeepSeek & any OpenRouter model as live crews with a plan-aware Advisor, a Kanban/flow command center, a testing gate, and an economics brain (Scrooge).",
   "files": [
     "hub.mjs",
     "mcp.mjs",

package/skills/crew/SKILL.md

@@ -54,11 +54,15 @@ EXACT launch spec per provider (do not improvise these):
 
 `agent:provider` live-selects the best model now; `agent:provider/model` pins one. Example:
 `trantor up codex kimi deepseek:deepseek opencode:zai-coding-plan --task code --difficulty hard`.
-**Whatever the advisor's `launch` field says, run that verbatim** — the roster above is the menu,
-but the advisor already picked the right seats and specs for THIS work (a user who's only brought
-an OpenRouter key, for instance, gets `openrouter` for everything; one who brought five providers
-gets a load-balanced spread). New providers a user brings (OpenRouter today; any opencode-supported
-vendor next) appear automatically once declared via `trantor profile set <name>=api` + a key.
+**Whatever the advisor's `launch` field says, run that verbatim** — the roster above is just the
+built-in menu, but the advisor picks the right seats/specs for THIS work (a user who's only brought
+an OpenRouter key gets `openrouter` for everything; one who brought five providers gets a
+load-balanced spread). **BYOM is fully general:** the roster is DERIVED, not hardcoded — ANY
+opencode-supported provider the user configures becomes a seat with its own bus label, no code
+change. A user adds one with `trantor provider add <name> --key … --plan api` (then
+`scrooge-capabilities` to score it for difficulty routing); `trantor provider` lists all seats and
+`trantor models [<provider>]` browses the live models + the router's pick per difficulty. If the
+advisor routes to a brought provider you don't recognize, that's expected — run its `launch` spec.
 
 ⚠️ **Gemini CLI is RETIRED (Google killed the free seat 2026-06-18).** The advisor no longer
 offers it and you must NOT fire up `gemini` — `gemini --yolo` exits 1 and crash-loops on the