trantor 0.17.44 → 0.17.45

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.44"
+    "version": "0.17.45"
   },
   "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.44",
+      "version": "0.17.45",
       "author": {
         "name": "Sasha Bogojevic"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.44",
+  "version": "0.17.45",
   "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

@@ -35,6 +35,14 @@ export const ROSTER = {
   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" },
 };
 
 export function loadWorld() {
@@ -42,12 +50,17 @@ export function loadWorld() {
   const registry = read(join(H, ".token-scrooge", "registry.json"), { models: {}, tasks: {} });
   const caps = read(join(H, ".token-scrooge", "capabilities.json"), {});
   const has = (c) => { try { execSync(`command -v ${c}`, { stdio: "ignore", shell: "/bin/sh" }); return true; } catch { return false; } };
-  const opencodeKey = () => !!read(join(H, ".config", "opencode", "opencode.json"), {})?.provider?.["zai-coding-plan"]?.options?.apiKey;
+  const opencodeKey = (prov) => !!read(join(H, ".config", "opencode", "opencode.json"), {})?.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.
+  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 zai key) must NOT be recommended.
+  // binary with a dead/missing seat (gemini, or opencode with no provider key) 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();
+    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 agents = Object.keys(ROSTER).filter(hasSeat);
@@ -70,7 +83,7 @@ export function scroogeModelFor(registry, caps, kind = "code", difficulty = "eas
 const FORECAST = { easy: 0.3e6, medium: 1.5e6, hard: 6e6 };  // tokens
 // crew agent preference per difficulty: frontier subs take hard, cheap takes easy.
 // (gemini retired → its slot goes to glm, a strong coding-plan seat on $0 marginal quota.)
-const CREW_PREF = { hard: ["codex", "glm", "kimi", "deepseek"], medium: ["kimi", "glm", "codex", "deepseek"], easy: ["deepseek", "kimi", "glm", "codex"] };
+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;
@@ -117,11 +130,15 @@ export function advise(input, world = loadWorld()) {
       const m = registry.models?.["deepseek-v4-flash"] || { cost_in: 0.14, cost_out: 0.28 };
       est = +((FORECAST[p.difficulty] * 0.85 * m.cost_in + FORECAST[p.difficulty] * 0.15 * m.cost_out) / 1e6).toFixed(2);
     }
-    const why_r = p.difficulty === "hard"
+    let why_r = p.difficulty === "hard"
       ? `hard → strongest available coder (${agent}); its ${pool} pool means ${pool === "api" ? "real $ but cheapest capable" : "$0 marginal on existing quota"}`
       : 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`;
     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

package/bin/crew-runner.mjs

@@ -69,6 +69,12 @@ const CLI = {
               next:  `opencode run -c{M} "$(cat {P})"`, mflag: " -m ", env: join(homedir(), ".token-scrooge", ".env") },
   opencode: { first: `opencode run{M} "$(cat {P})"`,
               next:  `opencode run -c{M} "$(cat {P})"`, mflag: " -m ", env: join(homedir(), ".token-scrooge", ".env") },
+  // OpenRouter rides the opencode CLI exactly like deepseek/glm, but under its OWN agent label so
+  // its bus identity is `openrouter:<project>` (RELAY_AGENT is set per-spawn) — never colliding with
+  // the glm `opencode` seat. Model ids come pre-qualified (`openrouter/<vendor>/<model>`). Sources
+  // the token-scrooge .env so an existing OPENROUTER_API_KEY authenticates with no extra wiring.
+  openrouter: { first: `opencode run{M} "$(cat {P})"`,
+              next:  `opencode run -c{M} "$(cat {P})"`, mflag: " -m ", env: join(homedir(), ".token-scrooge", ".env") },
   claude:   { first: `claude{M} -p "$(cat {P})" --dangerously-skip-permissions`,
               next:  `claude -c{M} -p "$(cat {P})" --dangerously-skip-permissions`, mflag: " --model " },
 };

package/bin/crew.sh

@@ -75,7 +75,7 @@ SCROOGE="$BUS_DIR/engine/bin/scrooge"
 resolve_model() {
   local agent="$1" provider="$2" task="$3" diff="$4" cands="" out=""
   case "$agent" in
-    opencode|deepseek)
+    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)" ;;
@@ -133,6 +133,9 @@ spawn_grid() {  # $@ = agents — (re)computes the grid for THIS batch and spawn
   for SPEC in "$@"; do
     AGENT="${SPEC%%:*}"                       # agent[:provider[/model]] — model rides in as CREW_MODEL
     FIELD=""; [ "$SPEC" != "$AGENT" ] && FIELD="${SPEC#*:}"
+    # `trantor up openrouter` (no provider) → default the opencode provider to openrouter so it
+    # live-selects from the OpenRouter catalog instead of falling back to opencode's default model.
+    [ "$AGENT" = "openrouter" ] && [ -z "$FIELD" ] && FIELD="openrouter"
     MODEL=""
     if [ -n "$FIELD" ]; then
       case "$FIELD" in

package/bin/doctor.mjs

@@ -61,6 +61,10 @@ const CLIS = [
   { name: "kimi",   bin: "kimi",     wired: () => !!read(join(H, ".kimi", "mcp.json"))?.mcpServers?.relay, auth: () => existsSync(join(H, ".kimi", "credentials")), login: "kimi → /login   (Kimi account or Moonshot API key)" },
   { name: "deepseek (via opencode)", bin: "opencode", wired: () => !!read(join(H, ".config", "opencode", "opencode.json"))?.mcp?.relay, auth: () => !!process.env.DEEPSEEK_API_KEY || (existsSync(join(H, ".agent-bus", ".env")) && readFileSync(join(H, ".agent-bus", ".env"), "utf8").includes("DEEPSEEK_API_KEY")) || !!read(join(H, ".local", "share", "opencode", "auth.json")), login: `get a key at platform.deepseek.com, then: echo 'DEEPSEEK_API_KEY=sk-…' >> ~/.agent-bus/.env` },
   { name: "glm (via opencode · coding plan)", bin: "opencode", wired: () => !!read(join(H, ".config", "opencode", "opencode.json"))?.mcp?.relay, auth: () => !!read(join(H, ".config", "opencode", "opencode.json"))?.provider?.["zai-coding-plan"]?.options?.apiKey, login: `put your Z.ai coding-plan key at ~/.config/opencode/opencode.json → provider["zai-coding-plan"].options.apiKey, then seat: trantor up opencode:zai-coding-plan/glm-5.1` },
+  // 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>` },
 ];
 let installed = 0;
 for (const c of CLIS) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.44",
+  "version": "0.17.45",
   "type": "module",
   "bin": {
     "trantor": "bin/cli.mjs"

package/skills/crew/SKILL.md

@@ -50,9 +50,15 @@ EXACT launch spec per provider (do not improvise these):
 | Kimi | `kimi` | Moonshot coding-plan |
 | DeepSeek | `deepseek:deepseek` | runs via opencode; `deepseek` alone = CLI default |
 | **GLM (Z.ai)** | **`opencode:zai-coding-plan`** | **runs via opencode, NOT a bare `glm`/`zai` terminal command.** `opencode:zai-coding-plan/glm-5.2` pins a model; `opencode:zai-coding-plan` live-selects. |
+| **OpenRouter (BYOM)** | **`openrouter`** | **the bring-your-own-model on-ramp — one key fronts hundreds of vendors (incl. ones with no CLI).** Bare `openrouter` live-selects the best OpenRouter model for the difficulty; pin one with `openrouter:openrouter/<vendor>/<model>`. Its own bus identity `openrouter:<project>` (never collides with the GLM `opencode` seat). |
 
 `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.
 
 ⚠️ **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