opencara 0.7.1 → 0.9.0

package/dist/index.js

@@ -14,9 +14,10 @@ import * as os from "os";
 import { parse, stringify } from "yaml";
 var DEFAULT_PLATFORM_URL = "https://api.opencara.dev";
 var CONFIG_DIR = path.join(os.homedir(), ".opencara");
-var CONFIG_FILE = path.join(CONFIG_DIR, "config.yml");
+var CONFIG_FILE = process.env.OPENCARA_CONFIG && process.env.OPENCARA_CONFIG.trim() ? path.resolve(process.env.OPENCARA_CONFIG) : path.join(CONFIG_DIR, "config.yml");
 function ensureConfigDir() {
-  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  const dir = path.dirname(CONFIG_FILE);
+  fs.mkdirSync(dir, { recursive: true });
 }
 var DEFAULT_MAX_DIFF_SIZE_KB = 100;
 function parseLimits(data) {
@@ -96,6 +97,7 @@ function parseAnonymousAgents(data) {
       model: obj.model,
       tool: obj.tool
     };
+    if (typeof obj.name === "string") anon.name = obj.name;
     if (obj.repo_config && typeof obj.repo_config === "object") {
       const rc = obj.repo_config;
       if (typeof rc.mode === "string" && VALID_REPO_MODES.includes(rc.mode)) {
@@ -127,7 +129,9 @@ function parseAgents(data) {
       continue;
     }
     const agent = { model: obj.model, tool: obj.tool };
+    if (typeof obj.name === "string") agent.name = obj.name;
     if (typeof obj.command === "string") agent.command = obj.command;
+    if (obj.router === true) agent.router = true;
     const agentLimits = parseLimits(obj);
     if (agentLimits) agent.limits = agentLimits;
     const repoConfig = parseRepoConfig(obj, i);
@@ -192,6 +196,9 @@ function saveConfig(config) {
         model: a.model,
         tool: a.tool
       };
+      if (a.name) {
+        entry.name = a.name;
+      }
       if (a.repoConfig) {
         entry.repo_config = a.repoConfig;
       }
@@ -293,17 +300,17 @@ function calculateDelay(attempt, options = DEFAULT_RECONNECT_OPTIONS) {
   return base;
 }
 function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
 
 // src/commands/login.ts
 function promptYesNo(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     rl.question(question, (answer) => {
       rl.close();
       const normalized = answer.trim().toLowerCase();
-      resolve(normalized === "" || normalized === "y" || normalized === "yes");
+      resolve2(normalized === "" || normalized === "y" || normalized === "yes");
     });
   });
 }
@@ -402,50 +409,82 @@ var DEFAULT_REGISTRY = {
       name: "claude",
       displayName: "Claude",
       binary: "claude",
-      commandTemplate: "claude --model ${MODEL} -p ${PROMPT} --output-format text",
+      commandTemplate: "claude --model ${MODEL} --allowedTools '*' --print",
       tokenParser: "claude"
     },
     {
       name: "codex",
       displayName: "Codex",
       binary: "codex",
-      commandTemplate: "codex --model ${MODEL} -p ${PROMPT}",
+      commandTemplate: "codex --model ${MODEL} exec",
       tokenParser: "codex"
     },
     {
       name: "gemini",
       displayName: "Gemini",
       binary: "gemini",
-      commandTemplate: "gemini --model ${MODEL} -p ${PROMPT}",
+      commandTemplate: "gemini -m ${MODEL}",
       tokenParser: "gemini"
     },
     {
       name: "qwen",
       displayName: "Qwen",
       binary: "qwen",
-      commandTemplate: "qwen --model ${MODEL} -p ${PROMPT} -y",
+      commandTemplate: "qwen --model ${MODEL} -y",
       tokenParser: "qwen"
     }
   ],
   models: [
-    { name: "claude-opus-4-6", displayName: "Claude Opus 4.6", tools: ["claude"] },
+    {
+      name: "claude-opus-4-6",
+      displayName: "Claude Opus 4.6",
+      tools: ["claude"],
+      defaultReputation: 0.8
+    },
     {
       name: "claude-opus-4-6[1m]",
       displayName: "Claude Opus 4.6 (1M context)",
-      tools: ["claude"]
+      tools: ["claude"],
+      defaultReputation: 0.8
+    },
+    {
+      name: "claude-sonnet-4-6",
+      displayName: "Claude Sonnet 4.6",
+      tools: ["claude"],
+      defaultReputation: 0.7
     },
-    { name: "claude-sonnet-4-6", displayName: "Claude Sonnet 4.6", tools: ["claude"] },
     {
       name: "claude-sonnet-4-6[1m]",
       displayName: "Claude Sonnet 4.6 (1M context)",
-      tools: ["claude"]
+      tools: ["claude"],
+      defaultReputation: 0.7
+    },
+    {
+      name: "gpt-5-codex",
+      displayName: "GPT-5 Codex",
+      tools: ["codex"],
+      defaultReputation: 0.7
+    },
+    {
+      name: "gemini-2.5-pro",
+      displayName: "Gemini 2.5 Pro",
+      tools: ["gemini"],
+      defaultReputation: 0.7
     },
-    { name: "gpt-5-codex", displayName: "GPT-5 Codex", tools: ["codex"] },
-    { name: "gemini-2.5-pro", displayName: "Gemini 2.5 Pro", tools: ["gemini"] },
-    { name: "qwen3.5-plus", displayName: "Qwen 3.5 Plus", tools: ["qwen"] },
-    { name: "glm-5", displayName: "GLM-5", tools: ["qwen"] },
-    { name: "kimi-k2.5", displayName: "Kimi K2.5", tools: ["qwen"] },
-    { name: "minimax-m2.5", displayName: "Minimax M2.5", tools: ["qwen"] }
+    {
+      name: "qwen3.5-plus",
+      displayName: "Qwen 3.5 Plus",
+      tools: ["qwen"],
+      defaultReputation: 0.6
+    },
+    { name: "glm-5", displayName: "GLM-5", tools: ["qwen"], defaultReputation: 0.5 },
+    { name: "kimi-k2.5", displayName: "Kimi K2.5", tools: ["qwen"], defaultReputation: 0.5 },
+    {
+      name: "minimax-m2.5",
+      displayName: "Minimax M2.5",
+      tools: ["qwen"],
+      defaultReputation: 0.5
+    }
   ]
 };
 
@@ -554,7 +593,7 @@ function executeTool(commandTemplate, prompt, timeoutMs, signal, vars) {
   const promptViaArg = commandTemplate.includes("${PROMPT}");
   const allVars = { ...vars, PROMPT: prompt };
   const { command, args } = parseCommandTemplate(commandTemplate, allVars);
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     if (signal?.aborted) {
       reject(new ToolTimeoutError("Tool execution aborted"));
       return;
@@ -626,7 +665,7 @@ function executeTool(commandTemplate, prompt, timeoutMs, signal, vars) {
             console.warn(`Tool stderr: ${stderr.slice(0, MAX_STDERR_LENGTH)}`);
           }
           const usage2 = parseTokenUsage(stdout, stderr);
-          resolve({ stdout, stderr, tokensUsed: usage2.tokens, tokensParsed: usage2.parsed });
+          resolve2({ stdout, stderr, tokensUsed: usage2.tokens, tokensParsed: usage2.parsed });
           return;
         }
         const errMsg = stderr ? `Tool "${command}" failed (exit code ${code}): ${stderr.slice(0, MAX_STDERR_LENGTH)}` : `Tool "${command}" failed with exit code ${code}`;
@@ -634,7 +673,7 @@ function executeTool(commandTemplate, prompt, timeoutMs, signal, vars) {
         return;
       }
       const usage = parseTokenUsage(stdout, stderr);
-      resolve({ stdout, stderr, tokensUsed: usage.tokens, tokensParsed: usage.parsed });
+      resolve2({ stdout, stderr, tokensUsed: usage.tokens, tokensParsed: usage.parsed });
     });
   });
 }
@@ -860,6 +899,141 @@ ${userMessage}`;
   }
 }
 
+// src/router.ts
+import * as readline2 from "readline";
+var END_OF_RESPONSE = "<<<OPENCARA_END_RESPONSE>>>";
+var RouterRelay = class {
+  pending = null;
+  responseLines = [];
+  rl = null;
+  stdout;
+  stderr;
+  stdin;
+  stopped = false;
+  constructor(deps) {
+    this.stdin = deps?.stdin ?? process.stdin;
+    this.stdout = deps?.stdout ?? process.stdout;
+    this.stderr = deps?.stderr ?? process.stderr;
+  }
+  /** Start listening for stdin input */
+  start() {
+    this.stopped = false;
+    this.rl = readline2.createInterface({
+      input: this.stdin,
+      terminal: false
+    });
+    this.rl.on("line", (line) => {
+      this.handleLine(line);
+    });
+    this.rl.on("close", () => {
+      if (this.stopped) return;
+      if (this.pending) {
+        const response = this.responseLines.join("\n");
+        this.responseLines = [];
+        clearTimeout(this.pending.timer);
+        const task = this.pending;
+        this.pending = null;
+        if (response.trim()) {
+          task.resolve(response);
+        } else {
+          task.reject(new Error("stdin closed with no response"));
+        }
+      }
+    });
+  }
+  /** Stop listening and clean up */
+  stop() {
+    this.stopped = true;
+    if (this.rl) {
+      this.rl.close();
+      this.rl = null;
+    }
+    if (this.pending) {
+      clearTimeout(this.pending.timer);
+      this.pending.reject(new Error("Router relay stopped"));
+      this.pending = null;
+      this.responseLines = [];
+    }
+  }
+  /** Write the prompt as plain text to stdout */
+  writePrompt(prompt) {
+    this.stdout.write(prompt + "\n");
+  }
+  /** Write a status message to stderr (doesn't interfere with prompt/response on stdout/stdin) */
+  writeStatus(message) {
+    this.stderr.write(message + "\n");
+  }
+  /** Build the full prompt for a review request */
+  buildReviewPrompt(req) {
+    const systemPrompt = buildSystemPrompt(
+      req.owner,
+      req.repo,
+      req.reviewMode
+    );
+    const userMessage = buildUserMessage(req.prompt, req.diffContent);
+    return `${systemPrompt}
+
+${userMessage}`;
+  }
+  /** Build the full prompt for a summary request */
+  buildSummaryPrompt(req) {
+    const systemPrompt = buildSummarySystemPrompt(req.owner, req.repo, req.reviews.length);
+    const userMessage = buildSummaryUserMessage(req.prompt, req.reviews, req.diffContent);
+    return `${systemPrompt}
+
+${userMessage}`;
+  }
+  /**
+   * Send a prompt to the external agent via stdout (plain text)
+   * and wait for the response via stdin (plain text, terminated by END_OF_RESPONSE or EOF).
+   */
+  sendPrompt(_type, _taskId, prompt, timeoutSec) {
+    return new Promise((resolve2, reject) => {
+      if (this.pending) {
+        reject(new Error("Another prompt is already pending"));
+        return;
+      }
+      const timeoutMs = timeoutSec * 1e3;
+      this.responseLines = [];
+      const timer = setTimeout(() => {
+        this.pending = null;
+        this.responseLines = [];
+        reject(new RouterTimeoutError(`Response timeout (${timeoutSec}s)`));
+      }, timeoutMs);
+      this.pending = { resolve: resolve2, reject, timer };
+      this.writePrompt(prompt);
+    });
+  }
+  /** Parse a review response: extract verdict and review text */
+  parseReviewResponse(response) {
+    return extractVerdict(response);
+  }
+  /** Get whether a task is pending (for testing) */
+  get pendingCount() {
+    return this.pending ? 1 : 0;
+  }
+  /** Handle a single line from stdin */
+  handleLine(line) {
+    if (!this.pending) return;
+    if (line.trim() === END_OF_RESPONSE) {
+      const response = this.responseLines.join("\n");
+      this.responseLines = [];
+      clearTimeout(this.pending.timer);
+      const task = this.pending;
+      this.pending = null;
+      task.resolve(response);
+      return;
+    }
+    this.responseLines.push(line);
+  }
+};
+var RouterTimeoutError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "RouterTimeoutError";
+  }
+};
+
 // src/consumption.ts
 async function checkConsumptionLimits(_agentId, _limits) {
   return { allowed: true };
@@ -884,6 +1058,7 @@ function formatTable(agents, trustLabels) {
   }
   const header = [
     "ID".padEnd(38),
+    "Name".padEnd(20),
     "Model".padEnd(22),
     "Tool".padEnd(16),
     "Status".padEnd(10),
@@ -892,8 +1067,16 @@ function formatTable(agents, trustLabels) {
   console.log(header);
   for (const a of agents) {
     const trust = trustLabels?.get(a.id) ?? "--";
+    const name = a.displayName ?? "--";
     console.log(
-      [a.id.padEnd(38), a.model.padEnd(22), a.tool.padEnd(16), a.status.padEnd(10), trust].join("")
+      [
+        a.id.padEnd(38),
+        name.padEnd(20),
+        a.model.padEnd(22),
+        a.tool.padEnd(16),
+        a.status.padEnd(10),
+        trust
+      ].join("")
     );
   }
 }
@@ -908,6 +1091,11 @@ function startAgent(agentId, platformUrl, apiKey, reviewDeps, consumptionDeps, o
   const verbose = options?.verbose ?? false;
   const stabilityThreshold = options?.stabilityThresholdMs ?? CONNECTION_STABILITY_THRESHOLD_MS;
   const repoConfig = options?.repoConfig;
+  const displayName = options?.displayName;
+  const routerRelay = options?.routerRelay;
+  const prefix = options?.label ? `[${options.label}]` : "";
+  const log = (...args) => console.log(...prefix ? [prefix, ...args] : args);
+  const logError = (...args) => console.error(...prefix ? [prefix, ...args] : args);
   let attempt = 0;
   let intentionalClose = false;
   let heartbeatTimer = null;
@@ -939,7 +1127,7 @@ function startAgent(agentId, platformUrl, apiKey, reviewDeps, consumptionDeps, o
     clearStabilityTimer();
     clearWsPingTimer();
     if (currentWs) currentWs.close();
-    console.log("Disconnected.");
+    log("Disconnected.");
     process.exit(0);
   }
   process.once("SIGINT", shutdown);
@@ -951,13 +1139,13 @@ function startAgent(agentId, platformUrl, apiKey, reviewDeps, consumptionDeps, o
     function resetHeartbeatTimer() {
       clearHeartbeatTimer();
       heartbeatTimer = setTimeout(() => {
-        console.log("No heartbeat received in 90s. Reconnecting...");
+        log("No heartbeat received in 90s. Reconnecting...");
         ws.terminate();
       }, HEARTBEAT_TIMEOUT_MS);
     }
     ws.on("open", () => {
       connectionOpenedAt = Date.now();
-      console.log("Connected to platform.");
+      log("Connected to platform.");
       resetHeartbeatTimer();
       clearWsPingTimer();
       wsPingTimer = setInterval(() => {
@@ -969,12 +1157,12 @@ function startAgent(agentId, platformUrl, apiKey, reviewDeps, consumptionDeps, o
         }
       }, WS_PING_INTERVAL_MS);
       if (verbose) {
-        console.log(`[verbose] Connection opened at ${new Date(connectionOpenedAt).toISOString()}`);
+        log(`[verbose] Connection opened at ${new Date(connectionOpenedAt).toISOString()}`);
       }
       clearStabilityTimer();
       stabilityTimer = setTimeout(() => {
         if (verbose) {
-          console.log(
+          log(
             `[verbose] Connection stable for ${stabilityThreshold / 1e3}s \u2014 resetting reconnect counter`
           );
         }
@@ -988,7 +1176,18 @@ function startAgent(agentId, platformUrl, apiKey, reviewDeps, consumptionDeps, o
       } catch {
         return;
       }
-      handleMessage(ws, msg, resetHeartbeatTimer, reviewDeps, consumptionDeps, verbose, repoConfig);
+      handleMessage(
+        ws,
+        msg,
+        resetHeartbeatTimer,
+        reviewDeps,
+        consumptionDeps,
+        verbose,
+        repoConfig,
+        displayName,
+        prefix,
+        routerRelay
+      );
     });
     ws.on("close", (code, reason) => {
       if (intentionalClose) return;
@@ -999,14 +1198,14 @@ function startAgent(agentId, platformUrl, apiKey, reviewDeps, consumptionDeps, o
       if (connectionOpenedAt) {
         const lifetimeMs = Date.now() - connectionOpenedAt;
         const lifetimeSec = (lifetimeMs / 1e3).toFixed(1);
-        console.log(
+        log(
           `Disconnected (code=${code}, reason=${reason.toString()}). Connection was alive for ${lifetimeSec}s.`
         );
       } else {
-        console.log(`Disconnected (code=${code}, reason=${reason.toString()}).`);
+        log(`Disconnected (code=${code}, reason=${reason.toString()}).`);
       }
       if (code === 4002) {
-        console.log("Connection replaced by server \u2014 not reconnecting.");
+        log("Connection replaced by server \u2014 not reconnecting.");
         return;
       }
       connectionOpenedAt = null;
@@ -1014,18 +1213,18 @@ function startAgent(agentId, platformUrl, apiKey, reviewDeps, consumptionDeps, o
     });
     ws.on("pong", () => {
       if (verbose) {
-        console.log(`[verbose] WS pong received at ${(/* @__PURE__ */ new Date()).toISOString()}`);
+        log(`[verbose] WS pong received at ${(/* @__PURE__ */ new Date()).toISOString()}`);
       }
     });
     ws.on("error", (err) => {
-      console.error(`WebSocket error: ${err.message}`);
+      logError(`WebSocket error: ${err.message}`);
     });
   }
   async function reconnect() {
     const delay = calculateDelay(attempt, DEFAULT_RECONNECT_OPTIONS);
     const delaySec = (delay / 1e3).toFixed(1);
     attempt++;
-    console.log(`Reconnecting in ${delaySec}s... (attempt ${attempt})`);
+    log(`Reconnecting in ${delaySec}s... (attempt ${attempt})`);
     await sleep(delay);
     connect();
   }
@@ -1038,16 +1237,17 @@ function trySend(ws, data) {
     console.error("Failed to send message \u2014 WebSocket may be closed");
   }
 }
-async function logPostReviewStats(type, verdict, tokensUsed, tokensEstimated, consumptionDeps) {
+async function logPostReviewStats(type, verdict, tokensUsed, tokensEstimated, consumptionDeps, logPrefix) {
+  const pfx = logPrefix ? `${logPrefix} ` : "";
   const estimateTag = tokensEstimated ? " ~" : " ";
   if (!consumptionDeps) {
     if (verdict) {
       console.log(
-        `${type} complete: ${verdict} (${estimateTag}${tokensUsed} tokens${tokensEstimated ? ", estimated" : ""})`
+        `${pfx}${type} complete: ${verdict} (${estimateTag}${tokensUsed} tokens${tokensEstimated ? ", estimated" : ""})`
       );
     } else {
       console.log(
-        `${type} complete (${estimateTag}${tokensUsed} tokens${tokensEstimated ? ", estimated" : ""})`
+        `${pfx}${type} complete (${estimateTag}${tokensUsed} tokens${tokensEstimated ? ", estimated" : ""})`
       );
     }
     return;
@@ -1055,38 +1255,122 @@ async function logPostReviewStats(type, verdict, tokensUsed, tokensEstimated, co
   recordSessionUsage(consumptionDeps.session, tokensUsed);
   if (verdict) {
     console.log(
-      `${type} complete: ${verdict} (${estimateTag}${tokensUsed.toLocaleString()} tokens${tokensEstimated ? ", estimated" : ""})`
+      `${pfx}${type} complete: ${verdict} (${estimateTag}${tokensUsed.toLocaleString()} tokens${tokensEstimated ? ", estimated" : ""})`
     );
   } else {
     console.log(
-      `${type} complete (${estimateTag}${tokensUsed.toLocaleString()} tokens${tokensEstimated ? ", estimated" : ""})`
+      `${pfx}${type} complete (${estimateTag}${tokensUsed.toLocaleString()} tokens${tokensEstimated ? ", estimated" : ""})`
     );
   }
-  console.log(formatPostReviewStats(tokensUsed, consumptionDeps.session, consumptionDeps.limits));
+  console.log(
+    `${pfx}${formatPostReviewStats(tokensUsed, consumptionDeps.session, consumptionDeps.limits)}`
+  );
 }
-function handleMessage(ws, msg, resetHeartbeat, reviewDeps, consumptionDeps, verbose, repoConfig) {
+function handleMessage(ws, msg, resetHeartbeat, reviewDeps, consumptionDeps, verbose, repoConfig, displayName, logPrefix, routerRelay) {
+  const pfx = logPrefix ? `${logPrefix} ` : "";
   switch (msg.type) {
     case "connected":
-      console.log(`Authenticated. Protocol v${msg.version ?? "unknown"}`);
+      console.log(`${pfx}Authenticated. Protocol v${msg.version ?? "unknown"}`);
       trySend(ws, {
         type: "agent_preferences",
         id: crypto2.randomUUID(),
         timestamp: Date.now(),
+        ...displayName ? { displayName } : {},
         repoConfig: repoConfig ?? { mode: "all" }
       });
+      if (routerRelay) {
+        routerRelay.writeStatus("Waiting for review requests...");
+      }
       break;
     case "heartbeat_ping":
       ws.send(JSON.stringify({ type: "heartbeat_pong", timestamp: Date.now() }));
       if (verbose) {
-        console.log(`[verbose] Heartbeat ping received, pong sent at ${(/* @__PURE__ */ new Date()).toISOString()}`);
+        console.log(
+          `${pfx}[verbose] Heartbeat ping received, pong sent at ${(/* @__PURE__ */ new Date()).toISOString()}`
+        );
       }
       if (resetHeartbeat) resetHeartbeat();
       break;
     case "review_request": {
       const request = msg;
       console.log(
-        `Review request: task ${request.taskId} for ${request.project.owner}/${request.project.repo}#${request.pr.number}`
+        `${pfx}Review request: task ${request.taskId} for ${request.project.owner}/${request.project.repo}#${request.pr.number}`
       );
+      if (routerRelay) {
+        void (async () => {
+          if (consumptionDeps) {
+            const limitResult = await checkConsumptionLimits(
+              consumptionDeps.agentId,
+              consumptionDeps.limits
+            );
+            if (!limitResult.allowed) {
+              trySend(ws, {
+                type: "review_rejected",
+                id: crypto2.randomUUID(),
+                timestamp: Date.now(),
+                taskId: request.taskId,
+                reason: limitResult.reason ?? "consumption_limit_exceeded"
+              });
+              console.log(`${pfx}Review rejected: ${limitResult.reason}`);
+              return;
+            }
+          }
+          try {
+            const prompt = routerRelay.buildReviewPrompt({
+              owner: request.project.owner,
+              repo: request.project.repo,
+              reviewMode: request.reviewMode ?? "full",
+              prompt: request.project.prompt,
+              diffContent: request.diffContent
+            });
+            const response = await routerRelay.sendPrompt(
+              "review_request",
+              request.taskId,
+              prompt,
+              request.timeout
+            );
+            const { verdict, review } = routerRelay.parseReviewResponse(response);
+            const tokensUsed = estimateTokens(prompt) + estimateTokens(response);
+            trySend(ws, {
+              type: "review_complete",
+              id: crypto2.randomUUID(),
+              timestamp: Date.now(),
+              taskId: request.taskId,
+              review,
+              verdict,
+              tokensUsed
+            });
+            await logPostReviewStats(
+              "Review",
+              verdict,
+              tokensUsed,
+              true,
+              consumptionDeps,
+              logPrefix
+            );
+          } catch (err) {
+            if (err instanceof RouterTimeoutError) {
+              trySend(ws, {
+                type: "review_error",
+                id: crypto2.randomUUID(),
+                timestamp: Date.now(),
+                taskId: request.taskId,
+                error: err.message
+              });
+            } else {
+              trySend(ws, {
+                type: "review_error",
+                id: crypto2.randomUUID(),
+                timestamp: Date.now(),
+                taskId: request.taskId,
+                error: err instanceof Error ? err.message : "Unknown error"
+              });
+            }
+            console.error(`${pfx}Review failed:`, err);
+          }
+        })();
+        break;
+      }
       if (!reviewDeps) {
         ws.send(
           JSON.stringify({
@@ -1113,7 +1397,7 @@ function handleMessage(ws, msg, resetHeartbeat, reviewDeps, consumptionDeps, ver
               taskId: request.taskId,
               reason: limitResult.reason ?? "consumption_limit_exceeded"
             });
-            console.log(`Review rejected: ${limitResult.reason}`);
+            console.log(`${pfx}Review rejected: ${limitResult.reason}`);
             return;
           }
         }
@@ -1145,7 +1429,8 @@ function handleMessage(ws, msg, resetHeartbeat, reviewDeps, consumptionDeps, ver
             result.verdict,
             result.tokensUsed,
             result.tokensEstimated,
-            consumptionDeps
+            consumptionDeps,
+            logPrefix
           );
         } catch (err) {
           if (err instanceof DiffTooLargeError) {
@@ -1165,7 +1450,7 @@ function handleMessage(ws, msg, resetHeartbeat, reviewDeps, consumptionDeps, ver
               error: err instanceof Error ? err.message : "Unknown error"
             });
           }
-          console.error("Review failed:", err);
+          console.error(`${pfx}Review failed:`, err);
         }
       })();
       break;
@@ -1173,8 +1458,81 @@ function handleMessage(ws, msg, resetHeartbeat, reviewDeps, consumptionDeps, ver
     case "summary_request": {
       const summaryRequest = msg;
       console.log(
-        `Summary request: task ${summaryRequest.taskId} for ${summaryRequest.project.owner}/${summaryRequest.project.repo}#${summaryRequest.pr.number} (${summaryRequest.reviews.length} reviews)`
+        `${pfx}Summary request: task ${summaryRequest.taskId} for ${summaryRequest.project.owner}/${summaryRequest.project.repo}#${summaryRequest.pr.number} (${summaryRequest.reviews.length} reviews)`
       );
+      if (routerRelay) {
+        void (async () => {
+          if (consumptionDeps) {
+            const limitResult = await checkConsumptionLimits(
+              consumptionDeps.agentId,
+              consumptionDeps.limits
+            );
+            if (!limitResult.allowed) {
+              trySend(ws, {
+                type: "review_rejected",
+                id: crypto2.randomUUID(),
+                timestamp: Date.now(),
+                taskId: summaryRequest.taskId,
+                reason: limitResult.reason ?? "consumption_limit_exceeded"
+              });
+              console.log(`${pfx}Summary rejected: ${limitResult.reason}`);
+              return;
+            }
+          }
+          try {
+            const prompt = routerRelay.buildSummaryPrompt({
+              owner: summaryRequest.project.owner,
+              repo: summaryRequest.project.repo,
+              prompt: summaryRequest.project.prompt,
+              reviews: summaryRequest.reviews,
+              diffContent: summaryRequest.diffContent ?? ""
+            });
+            const response = await routerRelay.sendPrompt(
+              "summary_request",
+              summaryRequest.taskId,
+              prompt,
+              summaryRequest.timeout
+            );
+            const tokensUsed = estimateTokens(prompt) + estimateTokens(response);
+            trySend(ws, {
+              type: "summary_complete",
+              id: crypto2.randomUUID(),
+              timestamp: Date.now(),
+              taskId: summaryRequest.taskId,
+              summary: response,
+              tokensUsed
+            });
+            await logPostReviewStats(
+              "Summary",
+              void 0,
+              tokensUsed,
+              true,
+              consumptionDeps,
+              logPrefix
+            );
+          } catch (err) {
+            if (err instanceof RouterTimeoutError) {
+              trySend(ws, {
+                type: "review_error",
+                id: crypto2.randomUUID(),
+                timestamp: Date.now(),
+                taskId: summaryRequest.taskId,
+                error: err.message
+              });
+            } else {
+              trySend(ws, {
+                type: "review_error",
+                id: crypto2.randomUUID(),
+                timestamp: Date.now(),
+                taskId: summaryRequest.taskId,
+                error: err instanceof Error ? err.message : "Summary failed"
+              });
+            }
+            console.error(`${pfx}Summary failed:`, err);
+          }
+        })();
+        break;
+      }
       if (!reviewDeps) {
         trySend(ws, {
           type: "review_rejected",
@@ -1199,7 +1557,7 @@ function handleMessage(ws, msg, resetHeartbeat, reviewDeps, consumptionDeps, ver
               taskId: summaryRequest.taskId,
               reason: limitResult.reason ?? "consumption_limit_exceeded"
             });
-            console.log(`Summary rejected: ${limitResult.reason}`);
+            console.log(`${pfx}Summary rejected: ${limitResult.reason}`);
             return;
           }
         }
@@ -1230,7 +1588,8 @@ function handleMessage(ws, msg, resetHeartbeat, reviewDeps, consumptionDeps, ver
             void 0,
             result.tokensUsed,
             result.tokensEstimated,
-            consumptionDeps
+            consumptionDeps,
+            logPrefix
           );
         } catch (err) {
           if (err instanceof InputTooLargeError) {
@@ -1250,13 +1609,13 @@ function handleMessage(ws, msg, resetHeartbeat, reviewDeps, consumptionDeps, ver
               error: err instanceof Error ? err.message : "Summary failed"
             });
           }
-          console.error("Summary failed:", err);
+          console.error(`${pfx}Summary failed:`, err);
         }
       })();
       break;
     }
     case "error":
-      console.error(`Platform error: ${msg.code ?? "unknown"}`);
+      console.error(`${pfx}Platform error: ${msg.code ?? "unknown"}`);
       if (msg.code === "auth_revoked") process.exit(1);
       break;
     default:
@@ -1271,6 +1630,9 @@ async function syncAgentToServer(client, serverAgents, localAgent) {
     return { agentId: existing.id, created: false };
   }
   const body = { model: localAgent.model, tool: localAgent.tool };
+  if (localAgent.name) {
+    body.displayName = localAgent.name;
+  }
   if (localAgent.repos) {
     body.repoConfig = localAgent.repos;
   }
@@ -1281,6 +1643,12 @@ function resolveLocalAgentCommand(localAgent, globalAgentCommand) {
   const effectiveCommand = localAgent.command ?? globalAgentCommand;
   return resolveCommandTemplate(effectiveCommand);
 }
+function startAgentRouter() {
+  void agentCommand.parseAsync(
+    ["start", "--router", "--anonymous", "--model", "router", "--tool", "opencara"],
+    { from: "user" }
+  );
+}
 var agentCommand = new Command2("agent").description("Manage review agents");
 agentCommand.command("create").description("Add an agent to local config (interactive or via flags)").option("--model <model>", "AI model name (e.g., claude-opus-4-6)").option("--tool <tool>", "Review tool name (e.g., claude-code)").option("--command <cmd>", "Custom command template (bypasses registry lookup)").action(async (opts) => {
   const config = loadConfig();
@@ -1360,7 +1728,7 @@ agentCommand.command("create").description("Add an agent to local config (intera
         break;
       }
       const toolEntry = registry.tools.find((t) => t.name === tool);
-      const defaultCommand = toolEntry ? toolEntry.commandTemplate.replaceAll("${MODEL}", model) : `${tool} --model ${model} -p \${PROMPT}`;
+      const defaultCommand = toolEntry ? toolEntry.commandTemplate.replaceAll("${MODEL}", model) : `${tool} --model ${model}`;
       command = await input({
         message: "Command:",
         default: defaultCommand,
@@ -1500,7 +1868,7 @@ async function resolveAnonymousAgent(config, model, tool) {
   );
   return { entry, command };
 }
-agentCommand.command("start [agentIdOrModel]").description("Connect agent to platform via WebSocket").option("--all", "Start all agents from local config concurrently").option("-a, --anonymous", "Start an anonymous agent (no login required)").option("--model <model>", "AI model name (used with --anonymous)").option("--tool <tool>", "Review tool name (used with --anonymous)").option("--verbose", "Enable detailed WebSocket diagnostic logging").option(
+agentCommand.command("start [agentIdOrModel]").description("Connect agent to platform via WebSocket").option("--all", "Start all agents from local config concurrently").option("-a, --anonymous", "Start an anonymous agent (no login required)").option("--model <model>", "AI model name (used with --anonymous)").option("--tool <tool>", "Review tool name (used with --anonymous)").option("--verbose", "Enable detailed WebSocket diagnostic logging").option("--router", "Router mode: relay prompts to stdout, read responses from stdin").option(
   "--stability-threshold <ms>",
   `Connection stability threshold in ms (${STABILITY_THRESHOLD_MIN_MS}\u2013${STABILITY_THRESHOLD_MAX_MS}, default: ${CONNECTION_STABILITY_THRESHOLD_MS})`
 ).action(
@@ -1522,24 +1890,57 @@ agentCommand.command("start [agentIdOrModel]").description("Connect agent to pla
         console.error("Both --model and --tool are required with --anonymous.");
         process.exit(1);
       }
-      let resolved;
-      try {
-        resolved = await resolveAnonymousAgent(config, opts.model, opts.tool);
-      } catch (err) {
-        console.error(
-          "Failed to register anonymous agent:",
-          err instanceof Error ? err.message : err
-        );
-        process.exit(1);
-      }
-      const { entry, command } = resolved;
+      let entry;
       let reviewDeps2;
-      if (validateCommandBinary(command)) {
-        reviewDeps2 = { commandTemplate: command, maxDiffSizeKb: config.maxDiffSizeKb };
-      } else {
-        console.warn(
-          `Warning: binary "${command.split(" ")[0]}" not found. Reviews will be rejected.`
+      let relay2;
+      if (opts.router) {
+        const existing = config.anonymousAgents.find(
+          (a) => a.model === opts.model && a.tool === opts.tool
         );
+        if (existing) {
+          console.log(
+            `Reusing stored anonymous agent ${existing.agentId} (${opts.model} / ${opts.tool})`
+          );
+          entry = existing;
+        } else {
+          console.log("Registering anonymous agent...");
+          const client2 = new ApiClient(config.platformUrl);
+          const res = await client2.post("/api/agents/anonymous", {
+            model: opts.model,
+            tool: opts.tool
+          });
+          entry = {
+            agentId: res.agentId,
+            apiKey: res.apiKey,
+            model: opts.model,
+            tool: opts.tool
+          };
+          config.anonymousAgents.push(entry);
+          saveConfig(config);
+          console.log(`Agent registered: ${res.agentId} (${opts.model} / ${opts.tool})`);
+        }
+        relay2 = new RouterRelay();
+        relay2.start();
+      } else {
+        let resolved;
+        try {
+          resolved = await resolveAnonymousAgent(config, opts.model, opts.tool);
+        } catch (err) {
+          console.error(
+            "Failed to register anonymous agent:",
+            err instanceof Error ? err.message : err
+          );
+          process.exit(1);
+        }
+        entry = resolved.entry;
+        const command = resolved.command;
+        if (validateCommandBinary(command)) {
+          reviewDeps2 = { commandTemplate: command, maxDiffSizeKb: config.maxDiffSizeKb };
+        } else {
+          console.warn(
+            `Warning: binary "${command.split(" ")[0]}" not found. Reviews will be rejected.`
+          );
+        }
       }
       const consumptionDeps2 = {
         agentId: entry.agentId,
@@ -1550,13 +1951,20 @@ agentCommand.command("start [agentIdOrModel]").description("Connect agent to pla
       startAgent(entry.agentId, config.platformUrl, entry.apiKey, reviewDeps2, consumptionDeps2, {
         verbose: opts.verbose,
         stabilityThresholdMs,
-        repoConfig: entry.repoConfig
+        displayName: entry.name,
+        repoConfig: entry.repoConfig,
+        routerRelay: relay2
       });
       return;
     }
     if (config.agents !== null) {
+      const routerAgents = [];
       const validAgents = [];
       for (const local of config.agents) {
+        if (opts.router || local.router) {
+          routerAgents.push(local);
+          continue;
+        }
         let cmd;
         try {
           cmd = resolveLocalAgentCommand(local, config.agentCommand);
@@ -1574,30 +1982,45 @@ agentCommand.command("start [agentIdOrModel]").description("Connect agent to pla
         }
         validAgents.push({ local, command: cmd });
       }
-      if (validAgents.length === 0 && config.anonymousAgents.length === 0) {
+      const totalValid = validAgents.length + routerAgents.length;
+      if (totalValid === 0 && config.anonymousAgents.length === 0) {
         console.error("No valid agents in config. Check that tool binaries are installed.");
         process.exit(1);
       }
       let agentsToStart;
+      let routerAgentsToStart;
       const anonAgentsToStart = [];
       if (opts.all) {
         agentsToStart = validAgents;
+        routerAgentsToStart = routerAgents;
         anonAgentsToStart.push(...config.anonymousAgents);
       } else if (agentIdOrModel) {
-        const match = validAgents.find((a) => a.local.model === agentIdOrModel);
-        if (!match) {
+        const cmdMatch = validAgents.find((a) => a.local.model === agentIdOrModel);
+        const routerMatch = routerAgents.find((a) => a.model === agentIdOrModel);
+        if (!cmdMatch && !routerMatch) {
           console.error(`No agent with model "${agentIdOrModel}" found in local config.`);
           console.error("Available agents:");
           for (const a of validAgents) {
             console.error(`  ${a.local.model}  (${a.local.tool})`);
           }
+          for (const a of routerAgents) {
+            console.error(`  ${a.model}  (${a.tool}) [router]`);
+          }
           process.exit(1);
         }
-        agentsToStart = [match];
-      } else if (validAgents.length === 1) {
-        agentsToStart = [validAgents[0]];
-        console.log(`Using agent ${validAgents[0].local.model} (${validAgents[0].local.tool})`);
-      } else if (validAgents.length === 0) {
+        agentsToStart = cmdMatch ? [cmdMatch] : [];
+        routerAgentsToStart = routerMatch ? [routerMatch] : [];
+      } else if (totalValid === 1) {
+        if (validAgents.length === 1) {
+          agentsToStart = [validAgents[0]];
+          routerAgentsToStart = [];
+          console.log(`Using agent ${validAgents[0].local.model} (${validAgents[0].local.tool})`);
+        } else {
+          agentsToStart = [];
+          routerAgentsToStart = [routerAgents[0]];
+          console.log(`Using router agent ${routerAgents[0].model} (${routerAgents[0].tool})`);
+        }
+      } else if (totalValid === 0) {
         console.error("No valid authenticated agents in config. Use --anonymous or --all.");
         process.exit(1);
       } else {
@@ -1605,9 +2028,12 @@ agentCommand.command("start [agentIdOrModel]").description("Connect agent to pla
         for (const a of validAgents) {
           console.error(`  ${a.local.model}  (${a.local.tool})`);
         }
+        for (const a of routerAgents) {
+          console.error(`  ${a.model}  (${a.tool}) [router]`);
+        }
         process.exit(1);
       }
-      const totalAgents = agentsToStart.length + anonAgentsToStart.length;
+      const totalAgents = agentsToStart.length + routerAgentsToStart.length + anonAgentsToStart.length;
       if (totalAgents > 1) {
         process.setMaxListeners(process.getMaxListeners() + totalAgents * 2);
       }
@@ -1615,7 +2041,7 @@ agentCommand.command("start [agentIdOrModel]").description("Connect agent to pla
       let apiKey2;
       let client2;
       let serverAgents;
-      if (agentsToStart.length > 0) {
+      if (agentsToStart.length > 0 || routerAgentsToStart.length > 0) {
         apiKey2 = requireApiKey(config);
         client2 = new ApiClient(config.platformUrl, apiKey2);
         try {
@@ -1659,11 +2085,55 @@ agentCommand.command("start [agentIdOrModel]").description("Connect agent to pla
           limits: resolveAgentLimits(selected.local.limits, config.limits),
           session: createSessionTracker()
         };
-        console.log(`Starting agent ${selected.local.model} (${agentId2})...`);
+        const label = selected.local.name || selected.local.model || "unnamed";
+        console.log(`Starting agent ${label} (${agentId2})...`);
         startAgent(agentId2, config.platformUrl, apiKey2, reviewDeps2, consumptionDeps2, {
           verbose: opts.verbose,
           stabilityThresholdMs,
-          repoConfig: selected.local.repos
+          repoConfig: selected.local.repos,
+          label
+        });
+        startedCount++;
+      }
+      for (const local of routerAgentsToStart) {
+        let agentId2;
+        try {
+          const sync = await syncAgentToServer(client2, serverAgents, local);
+          agentId2 = sync.agentId;
+          if (sync.created) {
+            console.log(`Registered new agent ${agentId2} on platform`);
+            serverAgents.push({
+              id: agentId2,
+              model: local.model,
+              tool: local.tool,
+              isAnonymous: false,
+              status: "offline",
+              repoConfig: null,
+              createdAt: (/* @__PURE__ */ new Date()).toISOString()
+            });
+          }
+        } catch (err) {
+          console.error(
+            `Failed to sync router agent ${local.model} to server:`,
+            err instanceof Error ? err.message : err
+          );
+          continue;
+        }
+        const relay2 = new RouterRelay();
+        relay2.start();
+        const consumptionDeps2 = {
+          agentId: agentId2,
+          limits: resolveAgentLimits(local.limits, config.limits),
+          session: createSessionTracker()
+        };
+        const label = local.name || local.model || "unnamed";
+        console.log(`Starting router agent ${label} (${agentId2})...`);
+        startAgent(agentId2, config.platformUrl, apiKey2, void 0, consumptionDeps2, {
+          verbose: opts.verbose,
+          stabilityThresholdMs,
+          repoConfig: local.repos,
+          label,
+          routerRelay: relay2
         });
         startedCount++;
       }
@@ -1692,11 +2162,14 @@ agentCommand.command("start [agentIdOrModel]").description("Connect agent to pla
           limits: config.limits,
           session: createSessionTracker()
         };
-        console.log(`Starting anonymous agent ${anon.model} (${anon.agentId})...`);
+        const anonLabel = anon.name || anon.model || "anonymous";
+        console.log(`Starting anonymous agent ${anonLabel} (${anon.agentId})...`);
         startAgent(anon.agentId, config.platformUrl, anon.apiKey, reviewDeps2, consumptionDeps2, {
           verbose: opts.verbose,
           stabilityThresholdMs,
-          repoConfig: anon.repoConfig
+          displayName: anon.name,
+          repoConfig: anon.repoConfig,
+          label: anonLabel
         });
         startedCount++;
       }
@@ -1736,16 +2209,22 @@ agentCommand.command("start [agentIdOrModel]").description("Connect agent to pla
       }
     }
     let reviewDeps;
-    try {
-      const commandTemplate = resolveCommandTemplate(config.agentCommand);
-      reviewDeps = {
-        commandTemplate,
-        maxDiffSizeKb: config.maxDiffSizeKb
-      };
-    } catch (err) {
-      console.warn(
-        `Warning: ${err instanceof Error ? err.message : "Could not determine agent command."} Reviews will be rejected.`
-      );
+    let relay;
+    if (opts.router) {
+      relay = new RouterRelay();
+      relay.start();
+    } else {
+      try {
+        const commandTemplate = resolveCommandTemplate(config.agentCommand);
+        reviewDeps = {
+          commandTemplate,
+          maxDiffSizeKb: config.maxDiffSizeKb
+        };
+      } catch (err) {
+        console.warn(
+          `Warning: ${err instanceof Error ? err.message : "Could not determine agent command."} Reviews will be rejected.`
+        );
+      }
     }
     const consumptionDeps = {
       agentId,
@@ -1755,7 +2234,9 @@ agentCommand.command("start [agentIdOrModel]").description("Connect agent to pla
     console.log(`Starting agent ${agentId}...`);
     startAgent(agentId, config.platformUrl, apiKey, reviewDeps, consumptionDeps, {
       verbose: opts.verbose,
-      stabilityThresholdMs
+      stabilityThresholdMs,
+      label: agentId,
+      routerRelay: relay
     });
   }
 );
@@ -1936,8 +2417,11 @@ var statsCommand = new Command3("stats").description("Display agent dashboard: t
 });
 
 // src/index.ts
-var program = new Command4().name("opencara").description("OpenCara \u2014 distributed AI code review agent").version("0.7.0");
+var program = new Command4().name("opencara").description("OpenCara \u2014 distributed AI code review agent").version("0.9.0");
 program.addCommand(loginCommand);
 program.addCommand(agentCommand);
 program.addCommand(statsCommand);
+program.action(() => {
+  startAgentRouter();
+});
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencara",
-  "version": "0.7.1",
+  "version": "0.9.0",
   "type": "module",
   "repository": {
     "type": "git",