opencara 0.12.0 → 0.13.0

package/dist/index.js

@@ -137,34 +137,36 @@ 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 };
+  const list = reposObj.list;
   if (mode === "whitelist" || mode === "blacklist") {
-    const list = reposObj.list;
     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}'`
       );
     }
+  }
+  if (Array.isArray(list) && list.length > 0) {
     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`
         );
       }
     }
@@ -211,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;
@@ -255,6 +265,7 @@ function loadConfig() {
     maxDiffSizeKb: DEFAULT_MAX_DIFF_SIZE_KB,
     maxConsecutiveErrors: DEFAULT_MAX_CONSECUTIVE_ERRORS,
     githubToken: null,
+    githubUsername: null,
     codebaseDir: null,
     agentCommand: null,
     agents: null
@@ -273,6 +284,7 @@ function loadConfig() {
     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)
@@ -289,6 +301,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";
@@ -498,15 +526,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 });
   });
 }
 
@@ -1311,6 +1339,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 () => {
@@ -1344,7 +1377,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;
@@ -1353,10 +1396,13 @@ 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?.mode === "whitelist" && repoConfig.list?.length) {
+      if (repoConfig?.list?.length) {
         pollBody.repos = repoConfig.list;
       }
+      if (synthesizeRepos) pollBody.synthesize_repos = synthesizeRepos;
       const pollResponse = await client.post("/api/tasks/poll", pollBody);
       consecutiveAuthErrors = 0;
       consecutiveErrors = 0;
@@ -1375,7 +1421,8 @@ async function pollLoop(client, agentId, reviewDeps, consumptionDeps, agentInfo,
           logger,
           agentSession,
           routerRelay,
-          signal
+          signal,
+          githubUsername
         );
         if (result.diffFetchFailed) {
           agentSession.errorsEncountered++;
@@ -1428,20 +1475,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
     );
@@ -1798,15 +1847,15 @@ 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) {
@@ -1844,6 +1893,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));
@@ -1865,6 +1917,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 ?? "",
@@ -1876,6 +1932,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,
@@ -1890,12 +1947,15 @@ async function startAgentRouter() {
       routerRelay: router,
       reviewOnly: agentConfig?.review_only,
       repoConfig: agentConfig?.repos,
+      roles,
+      synthesizeRepos: agentConfig?.synthesize_repos,
+      githubUsername,
       label
     }
   );
   router.stop();
 }
-function startAgentByIndex(config, agentIndex, pollIntervalMs, auth) {
+function startAgentByIndex(config, agentIndex, pollIntervalMs, auth, githubUsername) {
   const agentId = crypto.randomUUID();
   let commandTemplate;
   let agentConfig;
@@ -1939,6 +1999,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,
@@ -1951,6 +2012,9 @@ function startAgentByIndex(config, agentIndex, pollIntervalMs, auth) {
       routerRelay,
       reviewOnly: agentConfig?.review_only,
       repoConfig: agentConfig?.repos,
+      roles,
+      synthesizeRepos: agentConfig?.synthesize_repos,
+      githubUsername,
       label
     }
   ).finally(() => {
@@ -1965,6 +2029,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");
@@ -1975,7 +2043,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 {
@@ -2012,7 +2080,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;
@@ -2022,7 +2090,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.0");
+var program = new Command2().name("opencara").description("OpenCara \u2014 distributed AI code review agent").version("0.13.0");
 program.addCommand(agentCommand);
 program.action(() => {
   startAgentRouter();

package/package.json

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