agents-relay 2.0.3 → 2.0.5

package/README.md

@@ -160,7 +160,7 @@ reconcile leases and launches ready tasks without waiting inside the runtime sch
 
 `agents-relayd` without `--pr`/`--id` runs in workspace mode by default: it discovers nested Git repositories under `~/Workspace`, keeps only GitHub `origin` remotes, and aggregates their managed PR jobs into one dashboard and worker pool. Pass `--workspace PATH` to use another root. `--repo OWNER/REPO` remains the single-repository pool mode.
 
-For automation, Agents Relay can use GitHub App installation authentication via `AGENTS_RELAY_GITHUB_APP_ID`, `AGENTS_RELAY_GITHUB_APP_INSTALLATION_ID`, and `AGENTS_RELAY_GITHUB_APP_PRIVATE_KEY_FILE` (or matching CLI flags). Webhook mode is cache-first: targeted webhook reconciliation is primary, dashboard auto-refresh reads cached job state, and the broad watchdog drops to a 30-minute fallback. See [docs/github-app-rate-limit.md](docs/github-app-rate-limit.md).
+For automation, Agents Relay can use GitHub App installation authentication via `AGENTS_RELAY_GITHUB_APP_ID`, `AGENTS_RELAY_GITHUB_APP_INSTALLATION_ID`, and `AGENTS_RELAY_GITHUB_APP_PRIVATE_KEY_FILE` (or matching CLI flags). Webhook mode is local-first: targeted webhook reconciliation is primary, dashboard auto-refresh reads the disposable in-process view restored from SQLite RelayStore state, and the broad watchdog drops to a 30-minute fallback. No separate persisted dashboard Job cache is maintained. See [docs/github-app-rate-limit.md](docs/github-app-rate-limit.md).
 
 V1 assumes one active runner/daemon per job. Use a distributed atomic lease before running multiple reconcilers. Do not put secrets, credentials, private prompts, or large private payloads in the PR-body Job marker or PR-comment Task markers; store only summaries and artifact references.
 

package/dist/dashboard-html.js

@@ -397,36 +397,53 @@ function githubBucket(label,bucket){const row=element('div','usage-row');const h
 function githubCounterLine(label,values){const entries=Object.entries(values||{}).sort((a,b)=>Number(b[1])-Number(a[1])).slice(0,8);return entries.length?element('div','subtle',text(label+' · '+entries.map(([key,count])=>key+' '+count).join(' · '))):null;}
 function githubObserved(label,observed){
   if(!observed)return null;
+  if(Number.isFinite(observed.limit)&&Number.isFinite(observed.remaining)){const row=githubBucket(label,observed);if(observed.reason)row.title=observed.reason;return row;}
   const state=observed.throttled?'Throttled':observed.available===true?'Available':observed.available===false?'Unavailable':'Unknown';
   const parts=[label+' observed',state];
   if(observed.status!==null)parts.push('status '+observed.status);
-  if(observed.remaining!==null)parts.push('remaining '+observed.remaining);
-  if(observed.headersCaptured&&observed.reset!==null)parts.push(shortReset(observed.reset));
   if(observed.retryAfterSeconds!==null)parts.push('retry '+observed.retryAfterSeconds+'s');
   const row=element('div',observed.throttled?'usage-row error-state':'usage-row subtle');
   row.textContent=parts.filter(Boolean).join(' · ');
   if(observed.reason)row.title=observed.reason;
   return row;
 }
+function githubSecondary(status){
+  const rejection=status?.runtimeRateUsage?.rejection;
+  const row=element('div','usage-row');
+  const heading=element('div','usage-label');
+  if(rejection?.kind!=='secondary'){heading.append(element('span','',text('Secondary protection')),element('span','',text('No active cooldown')));row.append(heading);return row;}
+  const start=Date.parse(rejection.observedAt);
+  const until=Date.parse(rejection.cooldownUntil||status?.cooldownUntil||'');
+  if(!Number.isFinite(start)||!Number.isFinite(until)||until<=start){heading.append(element('span','',text('Secondary protection')),element('span','',text('Throttled')));row.classList.add('error-state');row.append(heading);return row;}
+  const total=until-start;
+  const remaining=Math.max(0,until-Date.now());
+  const percent=Math.max(0,Math.min(100,100*remaining/total));
+  heading.append(element('span','',text('Secondary cooldown')),element('span','',text(Math.ceil(remaining/1000)+'s')));
+  const track=element('div','usage-track');track.setAttribute('role','progressbar');track.setAttribute('aria-label','Secondary cooldown remaining');track.setAttribute('aria-valuemin','0');track.setAttribute('aria-valuemax','100');track.setAttribute('aria-valuenow',String(Math.round(percent)));const fill=element('div','usage-fill');fill.style.width=percent+'%';track.append(fill);
+  const hint=element('div','subtle',text('Retry '+new Date(until).toLocaleString()));hint.title=new Date(until).toLocaleString();
+  row.append(heading,track,hint);
+  return row;
+}
 function githubDiagnostics(status){const body=element('div','usage-details-body');if(status?.calls)body.append(element('div','subtle',text('Calls · GraphQL '+(status.calls.graphql||0)+' · REST '+(status.calls.rest||0)+' · quota '+(status.calls.rateLimit||0))));const operations=githubCounterLine('GraphQL operations',status?.graphql?.operations);if(operations)body.append(operations);const contexts=githubCounterLine('GraphQL contexts',status?.graphql?.contexts);if(contexts)body.append(contexts);if(status?.readPaths){body.append(element('div','subtle',text('Reads · scans '+(status.readPaths.workspaceScans||0)+' · PR '+(status.readPaths.prRefreshes||0)+' · coalesced '+(status.readPaths.prRefreshCoalesced||0))));const triggers=githubCounterLine('Refresh triggers',status.readPaths.prRefreshesByTrigger);if(triggers)body.append(triggers);const coalesced=githubCounterLine('Coalesced',status.readPaths.prRefreshCoalescedByTrigger);if(coalesced)body.append(coalesced);}if(!body.children.length)return null;const details=element('details','usage-details');details.append(element('summary','',text('Diagnostics')),body);return details;}
 function githubUsageCard(snapshot,status){
   const card=element('section','usage-provider');
   card.append(element('h3','',text('GitHub API')));
   const resources=snapshot?.resources||{};
+  const observed=status?.runtimeRateUsage?.resources||{};
   const bars=element('div','usage-bars');
+  bars.append(githubSecondary(status),element('div','usage-label',text('Request-time X-RateLimit headers')));
+  let observedCount=0;
+  for(const row of [githubObserved('REST',observed.core),githubObserved('GraphQL',observed.graphql),githubObserved('Search',observed.search)])if(row){bars.append(row);observedCount++;}
+  if(!observedCount)bars.append(element('p','empty',text('No request-time headers observed')));
   bars.append(element('div','usage-label',text('Primary quota (/rate_limit)')));
-  if(resources.core)bars.append(githubBucket('REST',resources.core));
-  if(resources.graphql)bars.append(githubBucket('GraphQL',resources.graphql));
-  if(resources.search)bars.append(githubBucket('Search',resources.search));
-  if(!bars.children.length)bars.append(element('p','empty',text('Quota unavailable')));
-  const observed=status?.runtimeRateUsage?.resources||{};
-  for(const row of [githubObserved('REST',observed.core),githubObserved('GraphQL',observed.graphql),githubObserved('Search',observed.search)])if(row)bars.append(row);
-  if(status?.runtimeRateUsage?.rejection){
+  let quotaCount=0;
+  for(const pair of [['REST',resources.core],['GraphQL',resources.graphql],['Search',resources.search]])if(pair[1]){bars.append(githubBucket(pair[0],pair[1]));quotaCount++;}
+  if(!quotaCount)bars.append(element('p','empty',text('Quota unavailable')));
+  if(status?.runtimeRateUsage?.rejection&&status.runtimeRateUsage.rejection.kind!=='secondary'){
     const rejection=status.runtimeRateUsage.rejection;
-    const cooldown=rejection.cooldownUntil?' · cooldown '+new Date(rejection.cooldownUntil).toLocaleTimeString():'';
-    bars.append(element('div','error-state',text('Throttled · '+(rejection.kind==='unknown'?'rate limit':rejection.kind)+' limit'+cooldown)));
+    bars.append(element('div','error-state',text('Throttled · '+(rejection.kind==='unknown'?'rate limit':rejection.kind)+' limit')));
   }
-  if(status?.limited){
+  if(status?.limited&&status?.runtimeRateUsage?.rejection?.kind!=='secondary'){
     const until=status.cooldownUntil?' until '+new Date(status.cooldownUntil).toLocaleTimeString():'';
     bars.append(element('div','error-state',text('Cooldown active'+until)));
   }

package/dist/github-runtime-usage.js

@@ -14,12 +14,13 @@ function transportResource(requestChannel, headers) {
     return requestChannel === 'graphql' ? 'graphql' : 'core';
 }
 function rejectionKind(headers, reason) {
-    if (/secondary rate|graphql_rate_limit/i.test(reason))
+    const remaining = headerNumber(headers['x-ratelimit-remaining']);
+    if (remaining === 0)
+        return 'primary';
+    if (/secondary rate/i.test(reason) || headerNumber(headers['retry-after']) !== null)
         return 'secondary';
-    if (/rate limit/i.test(reason) && headerNumber(headers['x-ratelimit-remaining']) !== 0)
+    if (/rate limit/i.test(reason) && remaining !== null && remaining > 0)
         return 'secondary';
-    if (/rate limit/i.test(reason))
-        return 'primary';
     return 'unknown';
 }
 function isThrottled(status, reason) {
@@ -51,6 +52,8 @@ export function runtimeRejection(observation) {
     const headers = {};
     if (observation.remaining !== null)
         headers['x-ratelimit-remaining'] = String(observation.remaining);
+    if (observation.retryAfterSeconds !== null)
+        headers['retry-after'] = String(observation.retryAfterSeconds);
     const retryAfterSeconds = observation.retryAfterSeconds;
     return {
         resource: observation.resource,

package/dist/relayd.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { once } from 'node:events';
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { readFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { ChatGptAdapter, CodexAdapter } from './adapters.js';
@@ -134,17 +134,18 @@ export async function runDaemon(argv) {
         projectionWriters.set(key, projected.projection);
         return projected;
     };
-    const makeReconciler = (store, maxConcurrent) => new Reconciler(store, { owner: `relayd-${process.pid}`, maxConcurrent, leaseMs: Number(value(argv, '--lease-ms', '300000')), adapters: [new CodexAdapter(value(argv, '--codex', 'codex')), new ChatGptAdapter()], continuations: [new CodexThreadContinuation(value(argv, '--codex', 'codex')), new CommandContinuation(), new WebhookContinuation()], planner: runtimePlanner(argv), usageSnapshotProvider: () => usageRegistry.snapshot(), runtimeSummaryProvider: () => ({ chatgptRunning: summarizeRuntime(cachedOverviews.map(item => item.job)).workers.chatgpt }), decisionEngine: new LayaCliDecisionEngine(), decisionMode: decisionMode(), decisionAuditStore, eventBus: bus, reviewer: runtimeReviewer(), projectPathForJob: async (job) => resolveRepositoryProjectPath(repositoryPaths.get(job.repository) ?? await resolveManagedProjectPath(job.repository, explicitProjectPath, workspaceRoot), job.projectPath) });
     if (repositories.length === 0)
         throw new Error(`No Git repositories with GitHub origins found under ${normalized.workspaceRoot ?? defaultWorkspaceRoot()}`);
-    const cacheDirectory = join(homedir(), '.agents-relay');
-    const cacheFile = join(cacheDirectory, 'dashboard-jobs.json');
-    try {
-        const parsed = JSON.parse(await readFile(cacheFile, 'utf8'));
-        if (Array.isArray(parsed))
-            cachedOverviews = parsed;
-    }
-    catch { /* first run or invalid cache */ }
+    const localSnapshots = await discoverLocalRelayStoreSnapshots(join(homedir(), '.agents-relay', 'stores'));
+    const knownRepositories = new Set(repositories);
+    cachedOverviews = dashboardManagedJobs(localSnapshots.flatMap(snapshot => {
+        if (!snapshot.facts)
+            return [];
+        return snapshot.jobs.filter(job => knownRepositories.has(job.repository)).map(job => ({
+            job, githubState: snapshot.facts.state, draft: false, mergedAt: null, closedAt: null, publication: null,
+        }));
+    }));
+    const makeReconciler = (store, maxConcurrent) => new Reconciler(store, { owner: `relayd-${process.pid}`, maxConcurrent, leaseMs: Number(value(argv, '--lease-ms', '300000')), adapters: [new CodexAdapter(value(argv, '--codex', 'codex')), new ChatGptAdapter()], continuations: [new CodexThreadContinuation(value(argv, '--codex', 'codex')), new CommandContinuation(), new WebhookContinuation()], planner: runtimePlanner(argv), usageSnapshotProvider: () => usageRegistry.snapshot(), runtimeSummaryProvider: () => ({ chatgptRunning: summarizeRuntime(cachedOverviews.map(item => item.job)).workers.chatgpt }), decisionEngine: new LayaCliDecisionEngine(), decisionMode: decisionMode(), decisionAuditStore, eventBus: bus, reviewer: runtimeReviewer(), projectPathForJob: async (job) => resolveRepositoryProjectPath(repositoryPaths.get(job.repository) ?? await resolveManagedProjectPath(job.repository, explicitProjectPath, workspaceRoot), job.projectPath) });
     const refreshAll = async (full = false) => {
         if (client.rateLimitStatus().limited)
             return cachedOverviews;
@@ -157,11 +158,6 @@ export async function runDaemon(argv) {
             const scanned = new Set(scanRepositories);
             const merged = dashboardManagedJobs([...cachedOverviews.filter(item => !scanned.has(item.job.repository)), ...refreshed]);
             cachedOverviews = await overlayOperationalOverviews(merged, (repository, prNumber) => runtimeStore(repository, prNumber));
-            try {
-                await mkdir(cacheDirectory, { recursive: true });
-                await writeFile(cacheFile, JSON.stringify(cachedOverviews), 'utf8');
-            }
-            catch { /* cache is best effort */ }
             return cachedOverviews;
         }
         catch (error) {
@@ -175,13 +171,6 @@ export async function runDaemon(argv) {
         cachedOverviews = await overlayOperationalOverviews(cachedOverviews, (repository, prNumber) => runtimeStore(repository, prNumber));
         return cachedOverviews;
     };
-    const persistCache = async () => {
-        try {
-            await mkdir(cacheDirectory, { recursive: true });
-            await writeFile(cacheFile, JSON.stringify(cachedOverviews), 'utf8');
-        }
-        catch { /* cache is best effort */ }
-    };
     const pullRequestRefreshFlights = new Map();
     const pullRequestRefreshCache = new Map();
     const incrementTrigger = (counts, trigger) => { counts[trigger] = (counts[trigger] ?? 0) + 1; };
@@ -209,7 +198,6 @@ export async function runDaemon(argv) {
             cachedOverviews = cachedOverviews.filter(item => item.job.repository !== repository || item.job.prNumber !== prNumber);
             cachedOverviews.push(...operational);
             cachedOverviews = dashboardManagedJobs(cachedOverviews);
-            await persistCache();
             const operationalSnapshot = { ...snapshot, overviews: operational };
             pullRequestRefreshCache.set(key, { snapshot: operationalSnapshot, completedAt: Date.now() });
             return operationalSnapshot;
@@ -384,21 +372,6 @@ export async function runDaemon(argv) {
         store.close(); server.close(() => process.exit(0)); }); };
     process.once('SIGINT', stop);
     process.once('SIGTERM', stop);
-    const localSnapshots = await discoverLocalRelayStoreSnapshots(join(homedir(), '.agents-relay', 'stores'));
-    const knownRepositories = new Set(repositories);
-    const localOverviews = localSnapshots.flatMap(snapshot => {
-        if (!snapshot.facts)
-            return [];
-        return snapshot.jobs.filter(job => knownRepositories.has(job.repository)).map(job => ({
-            job, githubState: snapshot.facts.state, draft: false, mergedAt: null, closedAt: null, publication: null,
-        }));
-    });
-    const byJob = new Map();
-    for (const item of cachedOverviews)
-        byJob.set(item.job.repository + '#' + item.job.prNumber + ':' + item.job.id, item);
-    for (const item of localOverviews)
-        byJob.set(item.job.repository + '#' + item.job.prNumber + ':' + item.job.id, item);
-    cachedOverviews = dashboardManagedJobs([...byJob.values()]);
     await pool.reconcileKnown(cachedOverviews);
     await scheduleHeartbeatSafely();
     await flushProjectionsSafely();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-relay",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "Durable async agent jobs coordinated through GitHub pull requests",
   "type": "module",
   "bin": {