opencara 0.12.1 → 0.14.0

package/dist/index.js

@@ -137,20 +137,20 @@ var KNOWN_TOOL_NAMES = new Set(DEFAULT_REGISTRY.tools.map((t) => t.name));
 var TOOL_ALIASES = {
   "claude-code": "claude"
 };
-function parseRepoConfig(obj, index) {
-  const raw = obj.repos;
+function parseRepoConfig(obj, index, field = "repos") {
+  const raw = obj[field];
   if (raw === void 0 || raw === null) return void 0;
   if (typeof raw !== "object") {
-    throw new RepoConfigError(`agents[${index}].repos must be an object`);
+    throw new RepoConfigError(`agents[${index}].${field} must be an object`);
   }
   const reposObj = raw;
   const mode = reposObj.mode;
   if (mode === void 0) {
-    throw new RepoConfigError(`agents[${index}].repos.mode is required`);
+    throw new RepoConfigError(`agents[${index}].${field}.mode is required`);
   }
   if (typeof mode !== "string" || !VALID_REPO_MODES.includes(mode)) {
     throw new RepoConfigError(
-      `agents[${index}].repos.mode must be one of: ${VALID_REPO_MODES.join(", ")}`
+      `agents[${index}].${field}.mode must be one of: ${VALID_REPO_MODES.join(", ")}`
     );
   }
   const config = { mode };
@@ -158,7 +158,7 @@ function parseRepoConfig(obj, index) {
   if (mode === "whitelist" || mode === "blacklist") {
     if (!Array.isArray(list) || list.length === 0) {
       throw new RepoConfigError(
-        `agents[${index}].repos.list is required and must be non-empty for mode '${mode}'`
+        `agents[${index}].${field}.list is required and must be non-empty for mode '${mode}'`
       );
     }
   }
@@ -166,7 +166,7 @@ function parseRepoConfig(obj, index) {
     for (let j = 0; j < list.length; j++) {
       if (typeof list[j] !== "string" || !REPO_PATTERN.test(list[j])) {
         throw new RepoConfigError(
-          `agents[${index}].repos.list[${j}] must match 'owner/repo' format`
+          `agents[${index}].${field}.list[${j}] must match 'owner/repo' format`
         );
       }
     }
@@ -213,10 +213,18 @@ function parseAgents(data) {
     if (typeof obj.command === "string") agent.command = obj.command;
     if (obj.router === true) agent.router = true;
     if (obj.review_only === true) agent.review_only = true;
+    if (obj.synthesizer_only === true) agent.synthesizer_only = true;
+    if (agent.review_only && agent.synthesizer_only) {
+      throw new ConfigValidationError(
+        `agents[${i}]: review_only and synthesizer_only cannot both be true`
+      );
+    }
     if (typeof obj.github_token === "string") agent.github_token = obj.github_token;
     if (typeof obj.codebase_dir === "string") agent.codebase_dir = obj.codebase_dir;
     const repoConfig = parseRepoConfig(obj, i);
     if (repoConfig) agent.repos = repoConfig;
+    const synthesizeRepoConfig = parseRepoConfig(obj, i, "synthesize_repos");
+    if (synthesizeRepoConfig) agent.synthesize_repos = synthesizeRepoConfig;
     agents.push(agent);
   }
   return agents;
@@ -254,9 +262,11 @@ function loadConfig() {
   const envPlatformUrl = process.env.OPENCARA_PLATFORM_URL?.trim() || null;
   const defaults = {
     platformUrl: envPlatformUrl || DEFAULT_PLATFORM_URL,
+    apiKey: null,
     maxDiffSizeKb: DEFAULT_MAX_DIFF_SIZE_KB,
     maxConsecutiveErrors: DEFAULT_MAX_CONSECUTIVE_ERRORS,
     githubToken: null,
+    githubUsername: null,
     codebaseDir: null,
     agentCommand: null,
     agents: null
@@ -272,9 +282,11 @@ function loadConfig() {
   const overrides = validateConfigData(data, envPlatformUrl);
   return {
     platformUrl: envPlatformUrl || (typeof data.platform_url === "string" ? data.platform_url : DEFAULT_PLATFORM_URL),
+    apiKey: typeof data.api_key === "string" ? data.api_key.trim() || null : null,
     maxDiffSizeKb: overrides.maxDiffSizeKb ?? (typeof data.max_diff_size_kb === "number" ? data.max_diff_size_kb : DEFAULT_MAX_DIFF_SIZE_KB),
     maxConsecutiveErrors: overrides.maxConsecutiveErrors ?? (typeof data.max_consecutive_errors === "number" ? data.max_consecutive_errors : DEFAULT_MAX_CONSECUTIVE_ERRORS),
     githubToken: typeof data.github_token === "string" ? data.github_token : null,
+    githubUsername: typeof data.github_username === "string" ? data.github_username : null,
     codebaseDir: typeof data.codebase_dir === "string" ? data.codebase_dir : null,
     agentCommand: typeof data.agent_command === "string" ? data.agent_command : null,
     agents: parseAgents(data)
@@ -291,6 +303,22 @@ function resolveCodebaseDir(agentDir, globalDir) {
   }
   return path.resolve(raw);
 }
+async function resolveGithubUsername(githubToken, fetchFn = fetch) {
+  if (!githubToken) return null;
+  try {
+    const response = await fetchFn("https://api.github.com/user", {
+      headers: {
+        Authorization: `Bearer ${githubToken}`,
+        Accept: "application/vnd.github+json"
+      }
+    });
+    if (!response.ok) return null;
+    const data = await response.json();
+    return typeof data.login === "string" ? data.login : null;
+  } catch {
+    return null;
+  }
+}
 
 // src/codebase.ts
 import { execFileSync } from "child_process";
@@ -413,18 +441,29 @@ var HttpError = class extends Error {
   }
 };
 var ApiClient = class {
-  constructor(baseUrl, debug) {
+  constructor(baseUrl, debugOrOptions) {
     this.baseUrl = baseUrl;
-    this.debug = debug ?? process.env.OPENCARA_DEBUG === "1";
+    if (typeof debugOrOptions === "object" && debugOrOptions !== null) {
+      this.debug = debugOrOptions.debug ?? process.env.OPENCARA_DEBUG === "1";
+      this.apiKey = debugOrOptions.apiKey ?? null;
+    } else {
+      this.debug = debugOrOptions ?? process.env.OPENCARA_DEBUG === "1";
+      this.apiKey = null;
+    }
   }
   debug;
+  apiKey;
   log(msg) {
     if (this.debug) console.debug(`[ApiClient] ${msg}`);
   }
   headers() {
-    return {
+    const h = {
       "Content-Type": "application/json"
     };
+    if (this.apiKey) {
+      h["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+    return h;
   }
   async get(path5) {
     this.log(`GET ${path5}`);
@@ -500,15 +539,15 @@ function sleep(ms, signal) {
       resolve2();
       return;
     }
-    const timer = setTimeout(resolve2, ms);
-    signal?.addEventListener(
-      "abort",
-      () => {
-        clearTimeout(timer);
-        resolve2();
-      },
-      { once: true }
-    );
+    const onAbort = () => {
+      clearTimeout(timer);
+      resolve2();
+    };
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve2();
+    }, ms);
+    signal?.addEventListener("abort", onAbort, { once: true });
   });
 }
 
@@ -522,6 +561,7 @@ var ToolTimeoutError = class extends Error {
     this.name = "ToolTimeoutError";
   }
 };
+var SIGKILL_GRACE_MS = 5e3;
 var MIN_PARTIAL_RESULT_LENGTH = 50;
 var MAX_STDERR_LENGTH = 1e3;
 function validateCommandBinary(commandTemplate) {
@@ -621,9 +661,17 @@ function executeTool(commandTemplate, prompt, timeoutMs, signal, vars, cwd) {
     let stdout = "";
     let stderr = "";
     let settled = false;
-    const timer = setTimeout(() => {
+    let sigkillTimer;
+    function scheduleKillEscalation() {
       child.kill("SIGTERM");
-    }, timeoutMs);
+      if (sigkillTimer) clearTimeout(sigkillTimer);
+      sigkillTimer = setTimeout(() => {
+        if (!settled) {
+          child.kill("SIGKILL");
+        }
+      }, SIGKILL_GRACE_MS);
+    }
+    const timer = setTimeout(scheduleKillEscalation, timeoutMs);
     child.stdout?.on("data", (chunk) => {
       stdout += chunk.toString();
     });
@@ -636,13 +684,12 @@ function executeTool(commandTemplate, prompt, timeoutMs, signal, vars, cwd) {
     child.stdin?.end();
     let onAbort;
     if (signal) {
-      onAbort = () => {
-        child.kill();
-      };
+      onAbort = scheduleKillEscalation;
       signal.addEventListener("abort", onAbort, { once: true });
     }
     function cleanup() {
       clearTimeout(timer);
+      if (sigkillTimer) clearTimeout(sigkillTimer);
       if (onAbort && signal) {
         signal.removeEventListener("abort", onAbort);
       }
@@ -1313,6 +1360,11 @@ function toApiDiffUrl(webUrl) {
   const [, owner, repo, prNumber] = match;
   return `https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}`;
 }
+function computeRoles(agent) {
+  if (agent.review_only) return ["review"];
+  if (agent.synthesizer_only) return ["summary"];
+  return ["review", "summary"];
+}
 async function fetchDiff(diffUrl, githubToken, signal) {
   return withRetry(
     async () => {
@@ -1346,7 +1398,17 @@ async function fetchDiff(diffUrl, githubToken, signal) {
 }
 var MAX_DIFF_FETCH_ATTEMPTS = 3;
 async function pollLoop(client, agentId, reviewDeps, consumptionDeps, agentInfo, logger, agentSession, options) {
-  const { pollIntervalMs, maxConsecutiveErrors, routerRelay, reviewOnly, repoConfig, signal } = options;
+  const {
+    pollIntervalMs,
+    maxConsecutiveErrors,
+    routerRelay,
+    reviewOnly,
+    repoConfig,
+    roles,
+    synthesizeRepos,
+    githubUsername,
+    signal
+  } = options;
   const { log, logError, logWarn } = logger;
   log(`${icons.polling} Polling every ${pollIntervalMs / 1e3}s...`);
   let consecutiveAuthErrors = 0;
@@ -1355,10 +1417,15 @@ async function pollLoop(client, agentId, reviewDeps, consumptionDeps, agentInfo,
   while (!signal?.aborted) {
     try {
       const pollBody = { agent_id: agentId };
+      if (githubUsername) pollBody.github_username = githubUsername;
+      if (roles) pollBody.roles = roles;
       if (reviewOnly) pollBody.review_only = true;
       if (repoConfig?.list?.length) {
         pollBody.repos = repoConfig.list;
       }
+      if (synthesizeRepos) pollBody.synthesize_repos = synthesizeRepos;
+      if (agentInfo.model) pollBody.model = agentInfo.model;
+      if (agentInfo.tool) pollBody.tool = agentInfo.tool;
       const pollResponse = await client.post("/api/tasks/poll", pollBody);
       consecutiveAuthErrors = 0;
       consecutiveErrors = 0;
@@ -1377,7 +1444,8 @@ async function pollLoop(client, agentId, reviewDeps, consumptionDeps, agentInfo,
           logger,
           agentSession,
           routerRelay,
-          signal
+          signal,
+          githubUsername
         );
         if (result.diffFetchFailed) {
           agentSession.errorsEncountered++;
@@ -1430,20 +1498,22 @@ async function pollLoop(client, agentId, reviewDeps, consumptionDeps, agentInfo,
     await sleep2(pollIntervalMs, signal);
   }
 }
-async function handleTask(client, agentId, task, reviewDeps, consumptionDeps, agentInfo, logger, agentSession, routerRelay, signal) {
+async function handleTask(client, agentId, task, reviewDeps, consumptionDeps, agentInfo, logger, agentSession, routerRelay, signal, githubUsername) {
   const { task_id, owner, repo, pr_number, diff_url, timeout_seconds, prompt, role } = task;
   const { log, logError, logWarn } = logger;
   log(`${icons.success} Claimed task ${task_id} (${role}) \u2014 ${owner}/${repo}#${pr_number}`);
   log(`  https://github.com/${owner}/${repo}/pull/${pr_number}`);
   let claimResponse;
   try {
+    const claimBody = {
+      agent_id: agentId,
+      role,
+      model: agentInfo.model,
+      tool: agentInfo.tool
+    };
+    if (githubUsername) claimBody.github_username = githubUsername;
     claimResponse = await withRetry(
-      () => client.post(`/api/tasks/${task_id}/claim`, {
-        agent_id: agentId,
-        role,
-        model: agentInfo.model,
-        tool: agentInfo.tool
-      }),
+      () => client.post(`/api/tasks/${task_id}/claim`, claimBody),
       { maxAttempts: 2 },
       signal
     );
@@ -1800,19 +1870,19 @@ function sleep2(ms, signal) {
       resolve2();
       return;
     }
-    const timer = setTimeout(resolve2, ms);
-    signal?.addEventListener(
-      "abort",
-      () => {
-        clearTimeout(timer);
-        resolve2();
-      },
-      { once: true }
-    );
+    const onAbort = () => {
+      clearTimeout(timer);
+      resolve2();
+    };
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve2();
+    }, ms);
+    signal?.addEventListener("abort", onAbort, { once: true });
   });
 }
 async function startAgent(agentId, platformUrl, agentInfo, reviewDeps, consumptionDeps, options) {
-  const client = new ApiClient(platformUrl);
+  const client = new ApiClient(platformUrl, { apiKey: options?.apiKey });
   const session = consumptionDeps?.session ?? createSessionTracker();
   const deps = consumptionDeps ?? { agentId, session };
   const logger = createLogger(options?.label);
@@ -1846,6 +1916,9 @@ async function startAgent(agentId, platformUrl, agentInfo, reviewDeps, consumpti
     routerRelay: options?.routerRelay,
     reviewOnly: options?.reviewOnly,
     repoConfig: options?.repoConfig,
+    roles: options?.roles,
+    synthesizeRepos: options?.synthesizeRepos,
+    githubUsername: options?.githubUsername,
     signal: abortController.signal
   });
   log(formatExitSummary(agentSession));
@@ -1867,6 +1940,10 @@ async function startAgentRouter() {
   const auth = resolveGithubToken2(configToken);
   const logger = createLogger(agentConfig?.name ?? "agent[0]");
   logAuthMethod(auth.method, logger.log);
+  const githubUsername = config.githubUsername ?? await resolveGithubUsername(auth.token) ?? void 0;
+  if (githubUsername) {
+    logger.log(`GitHub identity: ${githubUsername}`);
+  }
   const codebaseDir = resolveCodebaseDir(agentConfig?.codebase_dir, config.codebaseDir);
   const reviewDeps = {
     commandTemplate: commandTemplate ?? "",
@@ -1878,6 +1955,7 @@ async function startAgentRouter() {
   const model = agentConfig?.model ?? "unknown";
   const tool = agentConfig?.tool ?? "unknown";
   const label = agentConfig?.name ?? "agent[0]";
+  const roles = agentConfig ? computeRoles(agentConfig) : void 0;
   await startAgent(
     agentId,
     config.platformUrl,
@@ -1892,12 +1970,16 @@ async function startAgentRouter() {
       routerRelay: router,
       reviewOnly: agentConfig?.review_only,
       repoConfig: agentConfig?.repos,
-      label
+      roles,
+      synthesizeRepos: agentConfig?.synthesize_repos,
+      githubUsername,
+      label,
+      apiKey: config.apiKey
     }
   );
   router.stop();
 }
-function startAgentByIndex(config, agentIndex, pollIntervalMs, auth) {
+function startAgentByIndex(config, agentIndex, pollIntervalMs, auth, githubUsername) {
   const agentId = crypto.randomUUID();
   let commandTemplate;
   let agentConfig;
@@ -1941,6 +2023,7 @@ function startAgentByIndex(config, agentIndex, pollIntervalMs, auth) {
   const session = createSessionTracker();
   const model = agentConfig?.model ?? "unknown";
   const tool = agentConfig?.tool ?? "unknown";
+  const roles = agentConfig ? computeRoles(agentConfig) : void 0;
   const agentPromise = startAgent(
     agentId,
     config.platformUrl,
@@ -1953,7 +2036,11 @@ function startAgentByIndex(config, agentIndex, pollIntervalMs, auth) {
       routerRelay,
       reviewOnly: agentConfig?.review_only,
       repoConfig: agentConfig?.repos,
-      label
+      roles,
+      synthesizeRepos: agentConfig?.synthesize_repos,
+      githubUsername,
+      label,
+      apiKey: config.apiKey
     }
   ).finally(() => {
     routerRelay?.stop();
@@ -1967,6 +2054,10 @@ agentCommand.command("start").description("Start agents in polling mode").option
   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");
@@ -1977,7 +2068,7 @@ agentCommand.command("start").description("Start agents in polling mode").option
     const promises = [];
     let startFailed = false;
     for (let i = 0; i < config.agents.length; i++) {
-      const p = startAgentByIndex(config, i, pollIntervalMs, auth);
+      const p = startAgentByIndex(config, i, pollIntervalMs, auth, githubUsername);
       if (p) {
         promises.push(p);
       } else {
@@ -2014,7 +2105,7 @@ agentCommand.command("start").description("Start agents in polling mode").option
       process.exit(1);
       return;
     }
-    const p = startAgentByIndex(config, agentIndex, pollIntervalMs, auth);
+    const p = startAgentByIndex(config, agentIndex, pollIntervalMs, auth, githubUsername);
     if (!p) {
       process.exit(1);
       return;
@@ -2024,7 +2115,7 @@ agentCommand.command("start").description("Start agents in polling mode").option
 });
 
 // src/index.ts
-var program = new Command2().name("opencara").description("OpenCara \u2014 distributed AI code review agent").version("0.12.1");
+var program = new Command2().name("opencara").description("OpenCara \u2014 distributed AI code review agent").version("0.14.0");
 program.addCommand(agentCommand);
 program.action(() => {
   startAgentRouter();

package/package.json

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