opencara 0.15.3 → 0.15.6

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command2 } from "commander";
+import { Command as Command3 } from "commander";
 
 // src/commands/agent.ts
 import { Command } from "commander";
@@ -204,10 +204,10 @@ function parseAgents(data) {
           `\u26A0 Config warning: agents[${i}].tool "${resolvedTool}" is deprecated, using "${alias}" instead`
         );
         resolvedTool = alias;
-      } else {
+      } else if (typeof obj.command !== "string") {
         const toolNames = [...KNOWN_TOOL_NAMES].join(", ");
         console.warn(
-          `\u26A0 Config warning: agents[${i}].tool "${resolvedTool}" not in registry (known: ${toolNames}), skipping agent`
+          `\u26A0 Config warning: agents[${i}].tool "${resolvedTool}" not in registry (known: ${toolNames}) and no custom command provided, skipping agent`
         );
         continue;
       }
@@ -469,19 +469,36 @@ var HttpError = class extends Error {
     this.name = "HttpError";
   }
 };
+var UpgradeRequiredError = class extends Error {
+  constructor(currentVersion, minimumVersion) {
+    const minPart = minimumVersion ? ` Minimum required: ${minimumVersion}` : "";
+    super(
+      `Your CLI version (${currentVersion}) is outdated.${minPart} Please upgrade: npm update -g opencara`
+    );
+    this.currentVersion = currentVersion;
+    this.minimumVersion = minimumVersion;
+    this.name = "UpgradeRequiredError";
+  }
+};
 var ApiClient = class {
   constructor(baseUrl, debugOrOptions) {
     this.baseUrl = baseUrl;
     if (typeof debugOrOptions === "object" && debugOrOptions !== null) {
       this.debug = debugOrOptions.debug ?? process.env.OPENCARA_DEBUG === "1";
       this.apiKey = debugOrOptions.apiKey ?? null;
+      this.cliVersion = debugOrOptions.cliVersion ?? null;
+      this.versionOverride = debugOrOptions.versionOverride ?? null;
     } else {
       this.debug = debugOrOptions ?? process.env.OPENCARA_DEBUG === "1";
       this.apiKey = null;
+      this.cliVersion = null;
+      this.versionOverride = null;
     }
   }
   debug;
   apiKey;
+  cliVersion;
+  versionOverride;
   log(msg) {
     if (this.debug) console.debug(`[ApiClient] ${msg}`);
   }
@@ -492,6 +509,12 @@ var ApiClient = class {
     if (this.apiKey) {
       h["Authorization"] = `Bearer ${this.apiKey}`;
     }
+    if (this.cliVersion) {
+      h["X-OpenCara-CLI-Version"] = this.cliVersion;
+    }
+    if (this.versionOverride) {
+      h["Cloudflare-Workers-Version-Overrides"] = this.versionOverride;
+    }
     return h;
   }
   async get(path6) {
@@ -515,15 +538,22 @@ var ApiClient = class {
     if (!res.ok) {
       let message = `HTTP ${res.status}`;
       let errorCode;
+      let minimumVersion;
       try {
         const body = await res.json();
         if (body.error && typeof body.error === "object" && "code" in body.error) {
           errorCode = body.error.code;
           message = body.error.message;
         }
+        if (body.minimum_version) {
+          minimumVersion = body.minimum_version;
+        }
       } catch {
       }
       this.log(`${res.status} ${message} (${path6})`);
+      if (res.status === 426) {
+        throw new UpgradeRequiredError(this.cliVersion ?? "unknown", minimumVersion);
+      }
       throw new HttpError(res.status, message, errorCode);
     }
     this.log(`${res.status} OK (${path6})`);
@@ -1601,6 +1631,7 @@ var icons = {
   success: pc.green("\u2713"),
   running: pc.blue("\u25B6"),
   stop: pc.red("\u25A0"),
+  info: pc.blue("\u2139"),
   warn: pc.yellow("\u26A0"),
   error: pc.red("\u2717")
 };
@@ -1798,6 +1829,11 @@ async function pollLoop(client, agentId, reviewDeps, consumptionDeps, agentInfo,
       }
     } catch (err) {
       if (signal?.aborted) break;
+      if (err instanceof UpgradeRequiredError) {
+        logWarn(`${icons.warn} ${err.message}`);
+        process.exitCode = 1;
+        break;
+      }
       agentSession.errorsEncountered++;
       if (err instanceof HttpError && (err.status === 401 || err.status === 403)) {
         consecutiveAuthErrors++;
@@ -2212,8 +2248,8 @@ async function executeSummaryTask(client, agentId, taskId, owner, repo, prNumber
   }
   const summaryReviews = reviews.map((r) => ({
     agentId: r.agent_id,
-    model: "unknown",
-    tool: "unknown",
+    model: r.model ?? "unknown",
+    tool: r.tool ?? "unknown",
     review: r.review_text,
     verdict: r.verdict
   }));
@@ -2319,7 +2355,11 @@ function sleep2(ms, signal) {
   });
 }
 async function startAgent(agentId, platformUrl, agentInfo, reviewDeps, consumptionDeps, options) {
-  const client = new ApiClient(platformUrl, { apiKey: options?.apiKey });
+  const client = new ApiClient(platformUrl, {
+    apiKey: options?.apiKey,
+    cliVersion: "0.15.6",
+    versionOverride: options?.versionOverride
+  });
   const session = consumptionDeps?.session ?? createSessionTracker();
   const usageTracker = consumptionDeps?.usageTracker ?? new UsageTracker();
   const usageLimits = options?.usageLimits ?? {
@@ -2337,6 +2377,9 @@ async function startAgent(agentId, platformUrl, agentInfo, reviewDeps, consumpti
   const agentSession = createAgentSession();
   log(`${icons.start} Agent started (polling ${platformUrl})`);
   log(`Model: ${agentInfo.model} | Tool: ${agentInfo.tool}`);
+  if (options?.versionOverride) {
+    log(`${icons.info} Version override active: ${options.versionOverride}`);
+  }
   if (!reviewDeps) {
     logError(`${icons.error} No review command configured. Set command in config.yml`);
     return;
@@ -2407,6 +2450,7 @@ async function startAgentRouter() {
   const tool = agentConfig?.tool ?? "unknown";
   const label = agentConfig?.name ?? "agent[0]";
   const roles = agentConfig ? computeRoles(agentConfig) : void 0;
+  const versionOverride = process.env.OPENCARA_VERSION_OVERRIDE || null;
   await startAgent(
     agentId,
     config.platformUrl,
@@ -2428,12 +2472,13 @@ async function startAgentRouter() {
       githubUsername,
       label,
       apiKey: config.apiKey,
-      usageLimits: config.usageLimits
+      usageLimits: config.usageLimits,
+      versionOverride
     }
   );
   router.stop();
 }
-function startAgentByIndex(config, agentIndex, pollIntervalMs, auth, githubUsername) {
+function startAgentByIndex(config, agentIndex, pollIntervalMs, auth, githubUsername, versionOverride) {
   const agentId = crypto.randomUUID();
   let commandTemplate;
   let agentConfig;
@@ -2496,7 +2541,8 @@ function startAgentByIndex(config, agentIndex, pollIntervalMs, auth, githubUsern
       githubUsername,
       label,
       apiKey: config.apiKey,
-      usageLimits: config.usageLimits
+      usageLimits: config.usageLimits,
+      versionOverride
     }
   ).finally(() => {
     routerRelay?.stop();
@@ -2504,75 +2550,217 @@ function startAgentByIndex(config, agentIndex, pollIntervalMs, auth, githubUsern
   return agentPromise;
 }
 var agentCommand = new Command("agent").description("Manage review agents");
-agentCommand.command("start").description("Start agents in polling mode").option("--poll-interval <seconds>", "Poll interval in seconds", "10").option("--agent <index>", "Agent index from config.yml (0-based)", "0").option("--all", "Start all configured agents concurrently").action(async (opts) => {
-  const config = loadConfig();
-  const pollIntervalMs = parseInt(opts.pollInterval, 10) * 1e3;
-  const configToken = resolveGithubToken(void 0, config.githubToken);
-  const auth = resolveGithubToken2(configToken);
-  logAuthMethod(auth.method, console.log.bind(console));
-  const githubUsername = config.githubUsername ?? await resolveGithubUsername(auth.token) ?? void 0;
-  if (githubUsername) {
-    console.log(`GitHub identity: ${githubUsername}`);
+agentCommand.command("start").description("Start agents in polling mode").option("--poll-interval <seconds>", "Poll interval in seconds", "10").option("--agent <index>", "Agent index from config.yml (0-based)", "0").option("--all", "Start all configured agents concurrently").option(
+  "--version-override <value>",
+  "Cloudflare Workers version override (e.g. opencara-server=abc123)"
+).action(
+  async (opts) => {
+    const config = loadConfig();
+    const pollIntervalMs = parseInt(opts.pollInterval, 10) * 1e3;
+    const versionOverride = opts.versionOverride || process.env.OPENCARA_VERSION_OVERRIDE || null;
+    const configToken = resolveGithubToken(void 0, config.githubToken);
+    const auth = resolveGithubToken2(configToken);
+    logAuthMethod(auth.method, console.log.bind(console));
+    const githubUsername = config.githubUsername ?? await resolveGithubUsername(auth.token) ?? void 0;
+    if (githubUsername) {
+      console.log(`GitHub identity: ${githubUsername}`);
+    }
+    if (opts.all) {
+      if (!config.agents || config.agents.length === 0) {
+        console.error("No agents configured in ~/.opencara/config.yml");
+        process.exit(1);
+        return;
+      }
+      console.log(`Starting ${config.agents.length} agent(s)...`);
+      const promises = [];
+      let startFailed = false;
+      for (let i = 0; i < config.agents.length; i++) {
+        const p = startAgentByIndex(
+          config,
+          i,
+          pollIntervalMs,
+          auth,
+          githubUsername,
+          versionOverride
+        );
+        if (p) {
+          promises.push(p);
+        } else {
+          startFailed = true;
+        }
+      }
+      if (promises.length === 0) {
+        console.error("No agents could be started. Check your config.");
+        process.exit(1);
+        return;
+      }
+      if (startFailed) {
+        console.error(
+          "One or more agents could not start (see warnings above). Continuing with the rest."
+        );
+      }
+      console.log(`${promises.length} agent(s) running. Press Ctrl+C to stop all.
+`);
+      const results = await Promise.allSettled(promises);
+      const failures = results.filter((r) => r.status === "rejected");
+      if (failures.length > 0) {
+        for (const f of failures) {
+          console.error(`Agent exited with error: ${f.reason}`);
+        }
+        process.exit(1);
+      }
+    } else {
+      const maxIndex = (config.agents?.length ?? 0) - 1;
+      const agentIndex = Number(opts.agent);
+      if (!Number.isInteger(agentIndex) || agentIndex < 0 || agentIndex > maxIndex) {
+        console.error(
+          maxIndex >= 0 ? `--agent must be an integer between 0 and ${maxIndex}.` : "No agents configured in ~/.opencara/config.yml"
+        );
+        process.exit(1);
+        return;
+      }
+      const p = startAgentByIndex(
+        config,
+        agentIndex,
+        pollIntervalMs,
+        auth,
+        githubUsername,
+        versionOverride
+      );
+      if (!p) {
+        process.exit(1);
+        return;
+      }
+      await p;
+    }
   }
-  if (opts.all) {
-    if (!config.agents || config.agents.length === 0) {
-      console.error("No agents configured in ~/.opencara/config.yml");
-      process.exit(1);
-      return;
+);
+
+// src/commands/status.ts
+import { Command as Command2 } from "commander";
+import pc2 from "picocolors";
+var REQUEST_TIMEOUT_MS = 1e4;
+function isValidMetrics(data) {
+  if (!data || typeof data !== "object") return false;
+  const obj = data;
+  if (!obj.tasks || typeof obj.tasks !== "object") return false;
+  const tasks = obj.tasks;
+  return typeof tasks.pending === "number" && typeof tasks.reviewing === "number" && typeof tasks.failed === "number";
+}
+function agentRoleLabel(agent) {
+  if (agent.review_only) return "reviewer only";
+  if (agent.synthesizer_only) return "synthesizer only";
+  return "reviewer+synthesizer";
+}
+function resolveToolBinary(toolName) {
+  const entry = DEFAULT_REGISTRY.tools.find((t) => t.name === toolName);
+  return entry?.binary ?? toolName;
+}
+function resolveCommand(agent) {
+  if (agent.command) return agent.command;
+  const entry = DEFAULT_REGISTRY.tools.find((t) => t.name === agent.tool);
+  return entry?.commandTemplate ?? null;
+}
+async function checkConnectivity(platformUrl, fetchFn = fetch) {
+  const start = Date.now();
+  try {
+    const res = await fetchFn(`${platformUrl}/health`, {
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+    });
+    const ms = Date.now() - start;
+    if (!res.ok) {
+      return { ok: false, ms, error: `HTTP ${res.status}` };
     }
-    console.log(`Starting ${config.agents.length} agent(s)...`);
-    const promises = [];
-    let startFailed = false;
-    for (let i = 0; i < config.agents.length; i++) {
-      const p = startAgentByIndex(config, i, pollIntervalMs, auth, githubUsername);
-      if (p) {
-        promises.push(p);
+    return { ok: true, ms };
+  } catch (err) {
+    const ms = Date.now() - start;
+    const message = err instanceof Error ? err.message : String(err);
+    return { ok: false, ms, error: message };
+  }
+}
+async function fetchMetrics(platformUrl, fetchFn = fetch) {
+  try {
+    const res = await fetchFn(`${platformUrl}/metrics`, {
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    if (!isValidMetrics(data)) return null;
+    return data;
+  } catch {
+    return null;
+  }
+}
+async function runStatus(deps) {
+  const {
+    loadConfigFn = loadConfig,
+    fetchFn = fetch,
+    validateBinaryFn = validateCommandBinary,
+    log = console.log
+  } = deps;
+  const config = loadConfigFn();
+  log(`${pc2.bold("OpenCara Agent Status")}`);
+  log(pc2.dim("\u2500".repeat(30)));
+  log(`Config:     ${pc2.cyan(CONFIG_FILE)}`);
+  log(`Platform:   ${pc2.cyan(config.platformUrl)}`);
+  log(
+    `GitHub:     ${config.githubToken ? `${icons.success} token present` : `${icons.error} no token`}`
+  );
+  log("");
+  const conn = await checkConnectivity(config.platformUrl, fetchFn);
+  if (conn.ok) {
+    log(`Connectivity: ${icons.success} OK (${conn.ms}ms)`);
+  } else {
+    log(`Connectivity: ${icons.error} Connection failed: ${conn.error}`);
+  }
+  log("");
+  const agents = config.agents;
+  if (!agents || agents.length === 0) {
+    log(`Agents: ${pc2.dim("No agents configured")}`);
+  } else {
+    log(`Agents (${agents.length} configured):`);
+    for (let i = 0; i < agents.length; i++) {
+      const agent = agents[i];
+      const label = agent.name ?? `${agent.model}/${agent.tool}`;
+      const role = agentRoleLabel(agent);
+      log(`  ${i + 1}. ${pc2.bold(label)} \u2014 ${role}`);
+      const commandTemplate = resolveCommand(agent);
+      if (commandTemplate) {
+        const binaryOk = validateBinaryFn(commandTemplate);
+        const binary = resolveToolBinary(agent.tool);
+        if (binaryOk) {
+          log(`     Binary: ${icons.success} ${binary} executable`);
+        } else {
+          log(`     Binary: ${icons.error} ${binary} not found`);
+        }
       } else {
-        startFailed = true;
+        log(`     Binary: ${icons.warn} unknown tool "${agent.tool}"`);
       }
     }
-    if (promises.length === 0) {
-      console.error("No agents could be started. Check your config.");
-      process.exit(1);
-      return;
-    }
-    if (startFailed) {
-      console.error(
-        "One or more agents could not start (see warnings above). Continuing with the rest."
+  }
+  log("");
+  if (conn.ok) {
+    const metrics = await fetchMetrics(config.platformUrl, fetchFn);
+    if (metrics) {
+      log("Platform Status:");
+      log(
+        `  Tasks: ${metrics.tasks.pending} pending, ${metrics.tasks.reviewing} reviewing, ${metrics.tasks.failed} failed`
       );
-    }
-    console.log(`${promises.length} agent(s) running. Press Ctrl+C to stop all.
-`);
-    const results = await Promise.allSettled(promises);
-    const failures = results.filter((r) => r.status === "rejected");
-    if (failures.length > 0) {
-      for (const f of failures) {
-        console.error(`Agent exited with error: ${f.reason}`);
-      }
-      process.exit(1);
+    } else {
+      log(`Platform Status: ${icons.error} Could not fetch metrics`);
     }
   } else {
-    const maxIndex = (config.agents?.length ?? 0) - 1;
-    const agentIndex = Number(opts.agent);
-    if (!Number.isInteger(agentIndex) || agentIndex < 0 || agentIndex > maxIndex) {
-      console.error(
-        maxIndex >= 0 ? `--agent must be an integer between 0 and ${maxIndex}.` : "No agents configured in ~/.opencara/config.yml"
-      );
-      process.exit(1);
-      return;
-    }
-    const p = startAgentByIndex(config, agentIndex, pollIntervalMs, auth, githubUsername);
-    if (!p) {
-      process.exit(1);
-      return;
-    }
-    await p;
+    log(`Platform Status: ${pc2.dim("skipped (no connectivity)")}`);
   }
+}
+var statusCommand = new Command2("status").description("Show agent config, connectivity, and platform status").action(async () => {
+  await runStatus({});
 });
 
 // src/index.ts
-var program = new Command2().name("opencara").description("OpenCara \u2014 distributed AI code review agent").version("0.15.3");
+var program = new Command3().name("opencara").description("OpenCara \u2014 distributed AI code review agent").version("0.15.6");
 program.addCommand(agentCommand);
+program.addCommand(statusCommand);
 program.action(() => {
   startAgentRouter();
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencara",
-  "version": "0.15.3",
+  "version": "0.15.6",
   "description": "Distributed AI code review agent — poll, review, and submit PR reviews using your own AI tools",
   "type": "module",
   "license": "MIT",