agents-relay 1.0.138 → 1.0.140

package/dist/dashboard-html.js

@@ -373,7 +373,7 @@ function formatCredit(value,currency){if(value===null||value===undefined||!Numbe
 function creditProvider(provider){const row=element('section','usage-provider');row.append(element('h3','',text(provider.label)));const credits=provider.credits||{};if(!credits.available||!Array.isArray(credits.balances)||!credits.balances.length){row.append(element('p','empty',text(credits.reason||'Credit balance is unavailable.')));return row;}const balance=credits.balances[0];row.append(element('div','detail-value',text(formatCredit(balance.remaining,balance.currency))));return row;}
 function githubBucket(label,bucket){const row=element('div','usage-row');const heading=element('div','usage-label');heading.append(element('span','',text(label)),element('span','',text(bucket.remaining+' remaining')));row.append(heading);row.append(element('div','subtle',text(bucket.used+' used / '+bucket.limit+' limit')));const reset=resetText({resetsAt:bucket.reset});if(reset)row.append(element('div','subtle',text(reset)));return row;}
 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 githubUsageCard(snapshot,status){const card=element('section','usage-provider');card.append(element('h3','',text('GitHub API')));const resources=snapshot?.resources||{};const bars=element('div','usage-bars');if(resources.core)bars.append(githubBucket('REST core',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('GitHub quota telemetry is unavailable.')));if(status?.limited)bars.append(element('div','error-state',text('Relay cooldown active'+(status.cooldownUntil?' until '+new Date(status.cooldownUntil).toLocaleString():''))));else bars.append(element('div','subtle',text('Relay cooldown inactive')));if(status?.calls)bars.append(element('div','subtle',text('Calls since start · 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)bars.append(operations);const contexts=githubCounterLine('GraphQL contexts',status?.graphql?.contexts);if(contexts)bars.append(contexts);if(status?.readPaths)bars.append(element('div','subtle',text('Read paths · workspace scans '+(status.readPaths.workspaceScans||0)+' · PR refreshes '+(status.readPaths.prRefreshes||0))));card.append(bars);return card;}
+function githubUsageCard(snapshot,status){const card=element('section','usage-provider');card.append(element('h3','',text('GitHub API')));const resources=snapshot?.resources||{};const bars=element('div','usage-bars');if(resources.core)bars.append(githubBucket('REST core',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('GitHub quota telemetry is unavailable.')));if(status?.limited)bars.append(element('div','error-state',text('Relay cooldown active'+(status.cooldownUntil?' until '+new Date(status.cooldownUntil).toLocaleString():''))));else bars.append(element('div','subtle',text('Relay cooldown inactive')));if(status?.calls)bars.append(element('div','subtle',text('Calls since start · 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)bars.append(operations);const contexts=githubCounterLine('GraphQL contexts',status?.graphql?.contexts);if(contexts)bars.append(contexts);if(status?.readPaths){bars.append(element('div','subtle',text('Read paths · workspace scans '+(status.readPaths.workspaceScans||0)+' · PR refreshes '+(status.readPaths.prRefreshes||0)+' · coalesced '+(status.readPaths.prRefreshCoalesced||0))));const triggers=githubCounterLine('PR refresh triggers',status.readPaths.prRefreshesByTrigger);if(triggers)bars.append(triggers);const coalesced=githubCounterLine('Coalesced refresh triggers',status.readPaths.prRefreshCoalescedByTrigger);if(coalesced)bars.append(coalesced);}card.append(bars);return card;}
 async function drawUsage(){try{const overview=await loadJSON('/api/usage');usageRoot.replaceChildren();usageMeta.textContent='Real account telemetry when available';const providers=Array.isArray(overview.providers)?overview.providers:[];const credits=Array.isArray(overview.credits)?overview.credits:[];const grid=element('div','usage-providers');if(overview.github||overview.githubStatus)grid.append(githubUsageCard(overview.github,overview.githubStatus));for(const provider of providers)grid.append(usageProvider(provider));for(const provider of credits)grid.append(creditProvider(provider));if(!grid.children.length){usageRoot.append(element('p','empty',text('Usage telemetry is unavailable.')));return;}usageRoot.append(grid);}catch(error){usageMeta.textContent='Unavailable';usageRoot.replaceChildren(element('p','error-state',text('Usage unavailable: '+error.message)));}}
 async function drawRules(){rulesStatus.textContent='';try{const rules=await loadJSON('/api/model-router-rules');rulesText.value=typeof rules.text==='string'?rules.text:'';rulesMeta.textContent=rules.hash&&rules.hash!=='none'?'Loaded · '+rules.hash.slice(0,12):'No custom rules saved';}catch(error){rulesMeta.textContent='Unavailable';rulesStatus.textContent='Could not load rules: '+error.message;}}
 async function saveRules(){rulesSave.disabled=true;rulesStatus.textContent='Saving…';try{const response=await fetch('/api/model-router-rules',{method:'PUT',headers:{'content-type':'text/plain; charset=utf-8'},body:rulesText.value});if(!response.ok)throw new Error(response.status+' '+await response.text());const rules=await response.json();rulesMeta.textContent='Saved · '+rules.hash.slice(0,12);rulesStatus.textContent='Saved. New routing decisions will load these rules.';}catch(error){rulesStatus.textContent='Save failed: '+error.message;}finally{rulesSave.disabled=false;}}

package/dist/dashboard.js

@@ -68,7 +68,7 @@ export function serveDashboard(store, port = 8787, bus, refreshMs = 300000, jobI
     const discoveredJobs = async (forceRefresh = false) => {
         try {
             const jobs = overviewProvider
-                ? (await overviewProvider(forceRefresh)).map(item => ({ ...item.job, githubState: item.githubState, runtimeStatus: deriveJobRuntimeStatus(item.job, item.githubState), mergedAt: item.mergedAt, closedAt: item.closedAt, draft: item.draft, publication: item.publication }))
+                ? (await overviewProvider(forceRefresh, forceRefresh ? 'dashboard.jobs-refresh' : 'internal.unknown')).map(item => ({ ...item.job, githubState: item.githubState, runtimeStatus: deriveJobRuntimeStatus(item.job, item.githubState), mergedAt: item.mergedAt, closedAt: item.closedAt, draft: item.draft, publication: item.publication }))
                 : jobId ? [await store.load(jobId)] : [];
             lastKnownJobs = jobs;
             return jobs;

package/dist/pool.js

@@ -28,6 +28,7 @@ export class RepositoryWorkerPool {
     reconcileLocks = new Map();
     targetedReconcileFlights = new Map();
     jobTargets = new Map();
+    targetSeeds = new Map();
     constructor(client, repository, trustedAuthors, concurrency, makeReconciler, isRateLimited = () => false) {
         this.client = client;
         this.trustedAuthors = trustedAuthors;
@@ -99,6 +100,11 @@ export class RepositoryWorkerPool {
             this.running = false;
         }
     }
+    seedTargetSnapshot(repository, prNumber, jobId, seed) {
+        if (!this.repositories.includes(repository))
+            return;
+        this.targetSeeds.set(`${repository}#${prNumber}:${jobId}`, seed);
+    }
     async reconcileTarget(repository, prNumber, jobId) {
         if (this.isRateLimited() || !this.repositories.includes(repository))
             return;
@@ -108,8 +114,11 @@ export class RepositoryWorkerPool {
         if (existing)
             return existing;
         const flight = this.reconcileExclusive(jobId, async () => {
-            const store = new GitHubStore(this.client, repository, prNumber, this.trustedAuthors);
-            await withGitHubRequestContext(this.client, 'pool.targeted-reconcile', () => this.makeReconciler(store, Math.max(1, this.concurrency)).reconcile(jobId));
+            const seedKey = `${repository}#${prNumber}:${jobId}`;
+            const seed = this.targetSeeds.get(seedKey) ?? null;
+            this.targetSeeds.delete(seedKey);
+            const store = new GitHubStore(this.client, repository, prNumber, this.trustedAuthors, seed);
+            await withGitHubRequestContext(this.client, seed ? 'pool.targeted-reconcile.seeded' : 'pool.targeted-reconcile', () => this.makeReconciler(store, Math.max(1, this.concurrency)).reconcile(jobId));
         });
         this.targetedReconcileFlights.set(key, flight);
         try {

package/dist/relayd.js

@@ -9,7 +9,7 @@ import { serveDashboard } from './dashboard.js';
 import { NatsEventBus } from './events.js';
 import { RepositoryWorkerPool, aggregateManagedGitHubJobs } from './pool.js';
 import { Reconciler } from './reconciler.js';
-import { dashboardManagedJobs, GitHubStore, InMemoryStore, loadManagedGitHubPullRequestGraphql, withGitHubRequestContext } from './store.js';
+import { dashboardManagedJobs, GitHubStore, InMemoryStore, loadManagedGitHubPullRequestSnapshotGraphql, withGitHubRequestContext } from './store.js';
 import { githubAuthContext } from './github-auth.js';
 import { dashboardJobAction, isEntrypoint, runtimePlanner, runtimeReviewer, startService, SERVICE_DEFAULTS } from './cli.js';
 import { dashboardTaskAction, dashboardTaskSetState } from './dashboard-actions.js';
@@ -19,6 +19,10 @@ import { deriveJobRuntimeStatus } from './runtime-status.js';
 import { decisionMode, LayaCliDecisionEngine } from './decision.js';
 import { JsonlDecisionAuditStore } from './decision-audit.js';
 import { summarizeRuntime } from './runtime-summary.js';
+const PR_REFRESH_COALESCE_MS = 1000;
+export function shouldCoalescePullRequestRefresh(completedAt, now = Date.now(), force = false) {
+    return !force && completedAt !== null && now >= completedAt && now - completedAt < PR_REFRESH_COALESCE_MS;
+}
 export const daemonHelp = `Agents Relay daemon runs the dashboard and worker pool.
 
 Usage:
@@ -97,7 +101,7 @@ export async function runDaemon(argv) {
     const usageRegistry = codexAndZaiUsageRegistry();
     const decisionAuditStore = new JsonlDecisionAuditStore(process.env.AGENTS_RELAY_DECISION_AUDIT_PATH ?? join(homedir(), '.agents-relay', 'decision-audit.jsonl'));
     let cachedOverviews = [];
-    const githubReadPaths = { workspaceScans: 0, prRefreshes: 0 };
+    const githubReadPaths = { workspaceScans: 0, prRefreshes: 0, prRefreshesByTrigger: {}, prRefreshCoalesced: 0, prRefreshCoalescedByTrigger: {} };
     let dormantProbeIndex = 0;
     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)
@@ -134,7 +138,7 @@ export async function runDaemon(argv) {
             return cachedOverviews;
         }
     };
-    const overviews = async (forceRefresh = false) => forceRefresh ? refreshAll(true) : cachedOverviews;
+    const overviews = async (forceRefresh = false, _trigger = 'internal.unknown') => forceRefresh ? refreshAll(true) : cachedOverviews;
     const persistCache = async () => {
         try {
             await mkdir(cacheDirectory, { recursive: true });
@@ -143,21 +147,34 @@ export async function runDaemon(argv) {
         catch { /* cache is best effort */ }
     };
     const pullRequestRefreshFlights = new Map();
-    const refreshPullRequest = async (repository, prNumber) => {
+    const pullRequestRefreshCache = new Map();
+    const incrementTrigger = (counts, trigger) => { counts[trigger] = (counts[trigger] ?? 0) + 1; };
+    const refreshPullRequestSnapshot = async (repository, prNumber, trigger = 'internal', options = {}) => {
         if (client.rateLimitStatus().limited)
-            return cachedOverviews.filter(item => item.job.repository === repository && item.job.prNumber === prNumber);
+            return { overviews: cachedOverviews.filter(item => item.job.repository === repository && item.job.prNumber === prNumber), seed: { prNode: {}, comments: null } };
         const key = `${repository}#${prNumber}`;
+        incrementTrigger(githubReadPaths.prRefreshesByTrigger, trigger);
         const existing = pullRequestRefreshFlights.get(key);
-        if (existing)
+        if (existing) {
+            githubReadPaths.prRefreshCoalesced += 1;
+            incrementTrigger(githubReadPaths.prRefreshCoalescedByTrigger, trigger);
             return existing;
+        }
+        const cached = pullRequestRefreshCache.get(key);
+        if (cached && shouldCoalescePullRequestRefresh(cached.completedAt, Date.now(), options.force === true)) {
+            githubReadPaths.prRefreshCoalesced += 1;
+            incrementTrigger(githubReadPaths.prRefreshCoalescedByTrigger, trigger);
+            return cached.snapshot;
+        }
         const flight = (async () => {
             githubReadPaths.prRefreshes += 1;
-            const refreshed = await withGitHubRequestContext(client, 'relayd.pr-refresh', () => loadManagedGitHubPullRequestGraphql(client, repository, prNumber, trusted));
+            const snapshot = await withGitHubRequestContext(client, `relayd.pr-refresh:${trigger}`, () => loadManagedGitHubPullRequestSnapshotGraphql(client, repository, prNumber, trusted));
             cachedOverviews = cachedOverviews.filter(item => item.job.repository !== repository || item.job.prNumber !== prNumber);
-            cachedOverviews.push(...refreshed);
+            cachedOverviews.push(...snapshot.overviews);
             cachedOverviews = dashboardManagedJobs(cachedOverviews);
             await persistCache();
-            return refreshed;
+            pullRequestRefreshCache.set(key, { snapshot, completedAt: Date.now() });
+            return snapshot;
         })();
         pullRequestRefreshFlights.set(key, flight);
         try {
@@ -168,6 +185,7 @@ export async function runDaemon(argv) {
                 pullRequestRefreshFlights.delete(key);
         }
     };
+    const refreshPullRequest = async (repository, prNumber, trigger, options) => (await refreshPullRequestSnapshot(repository, prNumber, trigger, options)).overviews;
     const initial = cachedOverviews;
     const fallback = initial[0]?.job;
     const dashboardStore = fallback ? new GitHubStore(client, fallback.repository, fallback.prNumber, trusted) : new InMemoryStore();
@@ -195,7 +213,7 @@ export async function runDaemon(argv) {
             throw new Error(`Managed job ${jobId} not found`);
         const store = new GitHubStore(client, overview.job.repository, overview.job.prNumber, trusted);
         const result = await dashboardTaskSetState(store)(jobId, taskId, state);
-        await refreshPullRequest(overview.job.repository, overview.job.prNumber);
+        await refreshPullRequest(overview.job.repository, overview.job.prNumber, 'dashboard.task-state', { force: true });
         return result;
     };
     const secretFile = value(argv, '--github-webhook-secret-file');
@@ -206,8 +224,10 @@ export async function runDaemon(argv) {
         refresh: async (event) => {
             if (!event.repository || !event.pullRequest)
                 return [];
-            const refreshed = await refreshPullRequest(event.repository, event.pullRequest);
-            return refreshed.map(item => item.job.id);
+            const snapshot = await refreshPullRequestSnapshot(event.repository, event.pullRequest, `github.webhook:${event.event}${event.action ? ':' + event.action : ''}`);
+            for (const item of snapshot.overviews)
+                pool.seedTargetSnapshot(event.repository, event.pullRequest, item.job.id, snapshot.seed);
+            return snapshot.overviews.map(item => item.job.id);
         },
         wake: async (event) => {
             if (!event.repository || !event.pullRequest)
@@ -230,7 +250,7 @@ export async function runDaemon(argv) {
         if (client.rateLimitStatus().limited)
             return cachedJob();
         try {
-            const refreshed = (await refreshPullRequest(cached.job.repository, cached.job.prNumber)).find(item => item.job.id === jobId);
+            const refreshed = (await refreshPullRequest(cached.job.repository, cached.job.prNumber, 'dashboard.selected-job', { force: true })).find(item => item.job.id === jobId);
             if (!refreshed)
                 return null;
             return { ...refreshed.job, githubState: refreshed.githubState, runtimeStatus: deriveJobRuntimeStatus(refreshed.job, refreshed.githubState), mergedAt: refreshed.mergedAt, closedAt: refreshed.closedAt, draft: refreshed.draft, publication: refreshed.publication };

package/dist/store-github.js

@@ -11,11 +11,17 @@ export class GitHubStore {
     commentsCache = null;
     commentsFlight = null;
     clearReadSnapshot() { this.prNodeCache = null; this.commentsCache = null; this.commentsFlight = null; }
-    constructor(client, repository, prNumber, trustedAuthors = new Set()) {
+    constructor(client, repository, prNumber, trustedAuthors = new Set(), seed = null) {
         this.client = client;
         this.repository = repository;
         this.prNumber = prNumber;
         this.trustedAuthors = trustedAuthors;
+        if (seed) {
+            if (Object.keys(seed.prNode).length > 0)
+                this.prNodeCache = Promise.resolve(seed.prNode);
+            if (seed.comments)
+                this.commentsCache = [...seed.comments];
+        }
     }
     taskKey(task) { return `${this.repository}#${this.prNumber}:${task.jobId ?? ''}/${task.id}`; }
     taskKeyFromBody(body) { const task = parseTask(body); return task ? this.taskKey(task) : null; }

package/dist/store.js

@@ -12,28 +12,39 @@ function publicationFromComments(rows, trustedAuthors) {
     });
     return allowed.map(item => parsePackagePublicationMarker(String(item.body ?? ''))).filter((item) => item !== null).at(-1) ?? null;
 }
-export async function loadManagedGitHubPullRequestGraphql(client, repository, prNumber, trustedAuthors) {
+export async function loadManagedGitHubPullRequestSnapshotGraphql(client, repository, prNumber, trustedAuthors) {
     const [owner, name] = repository.split('/', 2);
     if (!owner || !name || !Number.isInteger(prNumber) || prNumber <= 0 || !client.graphql)
-        return [];
-    const query = 'query($owner:String!,$name:String!,$number:Int!){repository(owner:$owner,name:$name){pullRequest(number:$number){state isDraft merged mergedAt closedAt body comments(last:100){nodes{databaseId url author{login} body}}}}}';
+        return { overviews: [], seed: { prNode: {}, comments: null } };
+    const query = 'query($owner:String!,$name:String!,$number:Int!){repository(owner:$owner,name:$name){pullRequest(number:$number){id state isDraft merged mergedAt closedAt body headRefName headRefOid comments(last:100){totalCount nodes{id databaseId url updatedAt author{login} body}}}}}';
     const data = await client.graphql(query, { owner, name, number: prNumber });
     const repo = data.repository;
     const pr = repo?.pullRequest;
     if (!pr)
-        return [];
-    const comments = pr.comments?.nodes;
-    const trusted = (Array.isArray(comments) ? comments : []).filter(item => {
-        const row = item;
+        return { overviews: [], seed: { prNode: {}, comments: null } };
+    const commentConnection = pr.comments;
+    const commentRows = (Array.isArray(commentConnection?.nodes) ? commentConnection.nodes : []);
+    const totalCount = Number(commentConnection?.totalCount ?? commentRows.length);
+    const seedComments = Number.isFinite(totalCount) && totalCount <= commentRows.length ? commentRows.map(row => {
         const author = row.author;
+        return {
+            id: Number(row.databaseId ?? 0),
+            nodeId: typeof row.id === 'string' ? row.id : undefined,
+            url: typeof row.url === 'string' ? row.url : undefined,
+            body: String(row.body ?? ''),
+            updatedAt: String(row.updatedAt ?? ''),
+            authorLogin: typeof author?.login === 'string' ? author.login : null,
+        };
+    }) : null;
+    const trusted = commentRows.filter(item => {
+        const author = item.author;
         return typeof author?.login === 'string' && trustedAuthors.has(author.login);
     });
     const bodyJob = parseJob(typeof pr.body === 'string' ? pr.body : '');
     const commentJobs = trusted.map(item => parseJob(String(item.body ?? ''))).filter((item) => item !== null);
     const jobs = bodyJob ? [bodyJob] : commentJobs;
-    const publication = publicationFromComments((Array.isArray(comments) ? comments : []), trustedAuthors);
-    const tasks = trusted.map(item => {
-        const row = item;
+    const publication = publicationFromComments(commentRows, trustedAuthors);
+    const tasks = trusted.map(row => {
         const task = parseTask(String(row.body ?? ''));
         if (!task)
             return null;
@@ -42,12 +53,18 @@ export async function loadManagedGitHubPullRequestGraphql(client, repository, pr
     }).filter((item) => item !== null);
     const state = String(pr.state ?? '').toUpperCase();
     const githubState = pr.merged === true ? 'MERGED' : state === 'CLOSED' ? 'CLOSED' : 'OPEN';
-    return jobs.map(job => {
+    const overviews = jobs.map(job => {
         job.tasks = tasks.filter(task => task.jobId === job.id || (!task.jobId && jobs.length === 1));
         if (!job.description && typeof pr.body === 'string' && pr.body)
             job.description = pr.body;
+        if (typeof pr.headRefOid === 'string' && pr.headRefOid)
+            job.headSha = pr.headRefOid;
         return { job, githubState, draft: pr.isDraft === true, mergedAt: typeof pr.mergedAt === 'string' ? pr.mergedAt : null, closedAt: typeof pr.closedAt === 'string' ? pr.closedAt : null, publication };
     });
+    return { overviews, seed: { prNode: pr, comments: seedComments } };
+}
+export async function loadManagedGitHubPullRequestGraphql(client, repository, prNumber, trustedAuthors) {
+    return (await loadManagedGitHubPullRequestSnapshotGraphql(client, repository, prNumber, trustedAuthors)).overviews;
 }
 export async function loadManagedGitHubJobGraphql(client, repository, prNumber, jobId, trustedAuthors) {
     return (await loadManagedGitHubPullRequestGraphql(client, repository, prNumber, trustedAuthors)).find(item => item.job.id === jobId) ?? null;

package/package.json

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