agents-relay 1.0.17 → 1.0.19

package/dist/dashboard.js

@@ -241,7 +241,8 @@ function taskNode(task,children,depth){const li=element('li');const row=document
 function buildTree(tasks){taskTree.replaceChildren();if(!Array.isArray(tasks)||!tasks.length){taskTree.append(element('li','empty',text('No tasks in durable state.')));return;}const known=new Set(tasks.map(task=>task.id));const children=new Map();const roots=[];for(const task of tasks){if(!task.parentTaskId||!known.has(task.parentTaskId))roots.push(task);else{const siblings=children.get(task.parentTaskId)||[];siblings.push(task);children.set(task.parentTaskId,siblings);}}for(const task of roots)taskTree.append(taskNode(task,children,0));}
 function attemptBudget(task){const attempt=Number(task?.attempt)||0;const max=Number(task?.maxAttempts)||0;if(max>=3&&max%3===0){const effectiveMax=Math.max(max,Math.ceil(attempt/3)*3);return attempt+' / 3×'+(effectiveMax/3);}return attempt+' / '+max;}
 function renderTaskDetail(task){taskDetailRoot.replaceChildren();if(!task){taskDetailRoot.append(element('p','empty',text('Select a task to inspect execution details.')));return;}const routing=task.routing||{};const groups=element('div','detail-groups');groups.append(field('Task',task.id),field('Kind',task.kind||'work'),field('State',task.state),field('Project / agent',value(task.projectName)+' / '+value(task.agentName)),field('Parent task',task.parentTaskId||'root'),field('Adapter',task.adapter),field('Provider / model',value(routing.provider)+' / '+value(routing.model)),field('Reasoning / profile',value(routing.reasoning||routing.profile)),field('Attempt',attemptBudget(task)),field('Dependencies',Array.isArray(task.dependencies)&&task.dependencies.length?task.dependencies.join(', '):'none'),chatField(task));if(task.plannerResult)groups.append(field('Objective status',task.plannerResult.objective_status),markdownField('Assessment',task.plannerResult.assessment));if(task.error)groups.append(field('Error',task.error));taskDetailRoot.append(groups);}
-function renderSelectedJob(){jobDetail.replaceChildren();const job=selected();if(!job){selectedJobTitle.textContent='';jobDetail.append(element('div','empty',text('No durable jobs discovered.')));buildTree([]);renderTaskDetail(null);return;}selectedJobTitle.textContent='— '+value(job.title||job.id);if(job.id!==selectedJob){selectedJob=job.id;selectedTaskId=null;eventTaskId=null;clearEvents();rememberSelection();}const summary=element('div','job-summary');summary.append(field('GitHub state',job.githubState||'UNKNOWN'),field('Durable state',job.state),field('Execution mode',job.executionMode||'fixed'),field('Status',awaitingInitialTask(job)?'Awaiting initial task':job.state),field('Objective',job.objective||job.description||job.title),prField(job),field('Repository',job.repository||'—'),field('Last activity',relativeTime(job.updatedAt)),field('Task states',compactCounts(counts(job.tasks))));jobDetail.append(summary);const selectedTask=(job.tasks||[]).find(task=>task.id===selectedTaskId)||null;if(selectedTaskId&&!selectedTask){selectedTaskId=null;eventTaskId=null;clearEvents();rememberSelection();}buildTree(job.tasks||[]);renderTaskDetail(selectedTask);renderEventScope();}
+function reviewStatus(job){const review=job?.review;if(!review)return 'Not started';if(review.outcome==='approved'&&review.headSha===job.headSha)return 'MERGE READY · approved';const stale=Array.isArray(job?.tasks)&&job.tasks.some(task=>task.agentName==='reviewer'&&task.reviewHeadSha&&job.headSha&&task.reviewHeadSha!==job.headSha);if(stale)return 'STALE · awaiting review';return String(review.outcome||'pending').replace('_',' ').toUpperCase();}
+function renderSelectedJob(){jobDetail.replaceChildren();const job=selected();if(!job){selectedJobTitle.textContent='';jobDetail.append(element('div','empty',text('No durable jobs discovered.')));buildTree([]);renderTaskDetail(null);return;}selectedJobTitle.textContent='— '+value(job.title||job.id);if(job.id!==selectedJob){selectedJob=job.id;selectedTaskId=null;eventTaskId=null;clearEvents();rememberSelection();}const summary=element('div','job-summary');summary.append(field('GitHub state',job.githubState||'UNKNOWN'),field('Durable state',job.state),field('Execution mode',job.executionMode||'fixed'),field('Status',awaitingInitialTask(job)?'Awaiting initial task':job.state),field('Review',reviewStatus(job)),field('Review head SHA',job.review?.headSha||job.headSha||'—'),field('Objective',job.objective||job.description||job.title),prField(job),field('Repository',job.repository||'—'),field('Last activity',relativeTime(job.updatedAt)),field('Task states',compactCounts(job.tasks)));jobDetail.append(summary);const selectedTask=(job.tasks||[]).find(task=>task.id===selectedTaskId)||null;if(selectedTaskId&&!selectedTask){selectedTaskId=null;eventTaskId=null;clearEvents();rememberSelection();}buildTree(job.tasks||[]);renderTaskDetail(selectedTask);renderEventScope();}
 function renderAll(){jobs.sort(compareJobs);syncFilters();renderJobList();renderSelectedJob();}
 function isCompleteUnmerged(job){return job.state==='COMPLETED'&&job.githubState==='OPEN';}
 function isTerminalJob(job){return ['COMPLETED','CANCELLED'].includes(job.state)||['MERGED','CLOSED'].includes(job.githubState);}
@@ -257,7 +258,7 @@ function renderRateLimitStatus(status){
 async function refreshStatus(){try{renderRateLimitStatus(await loadJSON('/api/status'));}catch{renderRateLimitStatus(null);}}
 async function refresh(force=false){jobsRefresh.disabled=true;jobsRefresh.textContent='Refreshing…';try{const discovered=await loadJSON('/api/jobs'+(force?'?refresh=1':''));jobs=Array.isArray(discovered)?discovered:[];jobs.sort(compareJobs);if(selectedJob&&!jobs.some(job=>job.id===selectedJob)){selectedJob=null;selectedTaskId=null;}if(!selectedJob){const match=location.hash.match(/^#\\/jobs\\/(.+)$/);const fromHash=match?decodeURIComponent(match[1]):null;selectedJob=jobs.some(job=>job.id===fromHash)?fromHash:(jobs[0]?.id||null);}rememberSelection();renderAll();void loadEventHistory();connection.textContent='Live · durable state connected';connection.className='status-pill ok';}catch(error){connection.textContent='Error · durable state unavailable';connection.className='status-pill bad';jobList.replaceChildren(element('li','error-state',text('Could not load jobs: '+error.message)));}finally{jobsRefresh.disabled=false;jobsRefresh.textContent='Refresh';}}
 function renderEventScope(){const task=eventTaskId&&selected()?.tasks?.find(candidate=>candidate.id===eventTaskId);eventsAllTasks.disabled=!task;eventsAllTasks.setAttribute('aria-pressed',String(!task));eventsScope.textContent=task?'Task '+task.id+' · newest first · 60 max':'Job-wide · newest first · 60 max';}
-function eventLabel(type){return ({'task.process.launched':'Process launched','task.started':'Worker started','task.process.exited':'Sync process exited','task.process.async_exited':'Async process exited','task.completed':'Worker completed','task.failed':'Worker failed','task.blocked':'Worker blocked'})[type]||type||'Event';}
+function eventLabel(type){return ({'task.process.launched':'Process launched','task.started':'Worker started','task.process.exited':'Sync process exited','task.process.async_exited':'Async process exited','task.completed':'Worker completed','task.failed':'Worker failed','task.blocked':'Worker blocked','review.started':'Review started','review.approved':'Review approved','review.changes_required':'Review changes required','review.blocked':'Review blocked'})[type]||type||'Event';}
 function addEvent(event,level){if(!event||selectedJob&&event.job_id&&event.job_id!==selectedJob||eventTaskId&&event.task_id!==eventTaskId)return;if(event.event_id&&displayedEventIds.has(event.event_id))return;if(event.event_id)displayedEventIds.add(event.event_id);const item=element('li','event-item');const meta=element('div','event-meta');meta.append(element('span','event-kind',text(eventLabel(event.type))),element('span','event-type',text(event.type||'event')),element('span','',text(relativeTime(event.timestamp))),element('span','',text('task: '+value(event.task_id))));item.append(meta);const message=element('p','event-message',text(event.message||'Event received'));if(level==='error'||event.level==='error')message.classList.add('error-text');item.append(message);eventFeed.querySelector('.empty')?.remove();eventFeed.prepend(item);while(eventFeed.children.length>MAX_EVENTS)eventFeed.lastElementChild?.remove();}
 function usageBar(label,windowData){const percent=Math.max(0,Math.min(100,100-windowData.usedPercent));const row=element('div','usage-row');const heading=element('div','usage-label');heading.append(element('span','',text(label)),element('span','',text(Math.round(percent)+'%')));const track=element('div','usage-track');track.setAttribute('role','progressbar');track.setAttribute('aria-label',label+' available');track.setAttribute('aria-valuemin','0');track.setAttribute('aria-valuemax','100');track.setAttribute('aria-valuenow',String(percent));const fill=element('div','usage-fill');fill.style.width=percent+'%';track.append(fill);row.append(heading,track);return row;}
 function usageProvider(provider){const card=element('section','usage-provider');card.append(element('h3','',text(provider.label)));const usage=provider.usage||{};if(!usage.available||!usage.fiveHour||!usage.weekly){card.append(element('p','empty',text(usage.reason||'Account usage telemetry is unavailable.')));return card;}const bars=element('div','usage-bars');bars.append(usageBar('5-hour remaining',usage.fiveHour),usageBar('Weekly remaining',usage.weekly));card.append(bars);return card;}
@@ -353,6 +354,12 @@ export function serveDashboard(store, port = 8787, bus, refreshMs = 300000, jobI
             throw new Error(`Managed job ${requestedJobId ?? ''} not found`);
         return { id: jobId, json: JSON.stringify(await store.load(jobId)) };
     };
+    const broadcastSnapshots = async (jobIds = []) => {
+        const snapshots = await Promise.all((jobIds.length > 0 ? jobIds : [undefined]).map(requestedJobId => snapshot(requestedJobId)));
+        for (const value of snapshots)
+            for (const client of clients)
+                client.write(`data: ${value.json}\n\n`);
+    };
     const usage = async () => {
         if (!usageRegistry)
             throw new Error('Account usage telemetry is unavailable');
@@ -393,7 +400,13 @@ export function serveDashboard(store, port = 8787, bus, refreshMs = 300000, jobI
             }
             res.writeHead(202);
             res.end('Accepted');
-            queueMicrotask(() => { void webhook.wake(event); });
+            queueMicrotask(() => {
+                void (webhook.refresh ? webhook.refresh(event) : Promise.resolve([]))
+                    .then(jobIds => broadcastSnapshots(jobIds))
+                    .catch(error => process.stderr.write(`warning: webhook dashboard snapshot unavailable: ${error instanceof Error ? error.message : String(error)}\n`))
+                    .then(() => webhook.wake(event))
+                    .catch(error => process.stderr.write(`warning: webhook wake unavailable: ${error instanceof Error ? error.message : String(error)}\n`));
+            });
             return;
         }
         if (new URL(req.url ?? '/', 'http://127.0.0.1').pathname === '/api/jobs') {

package/dist/pool.js

@@ -92,7 +92,7 @@ export class RepositoryWorkerPool {
     }
     async watch(bus) {
         return bus.subscribeAll(async (event) => {
-            if (['task.completed', 'task.failed', 'task.blocked'].includes(event.type)) {
+            if (['task.completed', 'task.failed', 'task.blocked', 'review.started', 'review.approved', 'review.changes_required', 'review.blocked'].includes(event.type)) {
                 await this.handleTerminalEvent(event);
                 return;
             }

package/dist/reconciler.js

@@ -56,6 +56,10 @@ export class Reconciler {
             await this.applyTerminalEvent(event);
             return;
         }
+        if (['review.started', 'review.approved', 'review.changes_required', 'review.blocked'].includes(event.type)) {
+            await this.applyReviewEvent(event);
+            return;
+        }
         if (event.type === 'job.wake' || event.type === 'github.webhook')
             await this.reconcile(event.job_id);
     }
@@ -81,6 +85,10 @@ export class Reconciler {
             const job = await this.store.load(jobId);
             const previousState = job.state;
             const prState = await this.store.pullRequestState?.() ?? 'OPEN';
+            const headSha = prState === 'OPEN' ? await this.currentHeadSha(job) : null;
+            if (headSha)
+                job.headSha = headSha;
+            await this.invalidateStaleReview(job, headSha);
             const now = (this.options.now ?? new Date()).getTime();
             if (prState !== 'OPEN') {
                 const reason = prState === 'MERGED' ? 'Pull request merged' : 'Pull request closed';
@@ -136,12 +144,76 @@ export class Reconciler {
             }
             if (finalState.state !== scheduled.state || finalState.updatedAt !== scheduled.updatedAt)
                 await this.store.saveJob(finalState);
+            await this.ensureFinalReview(finalState, prState, headSha);
             return this.store.load(jobId);
         }
         finally {
             this.reconciling = false;
         }
     }
+    async currentHeadSha(job) { return await this.store.headSha?.() ?? job.headSha ?? job.review?.headSha ?? null; }
+    async invalidateStaleReview(job, headSha) {
+        if (!headSha || !job.review || job.review.headSha === headSha || job.review.outcome === 'stale')
+            return;
+        job.review = { ...job.review, outcome: 'stale', updatedAt: new Date().toISOString() };
+        const staleTask = job.review.taskId ? job.tasks.find(task => task.id === job.review?.taskId) : undefined;
+        if (staleTask && ['QUEUED', 'READY', 'RUNNING', 'WAITING'].includes(staleTask.state)) {
+            this.live.get(staleTask.id)?.execution.cancel();
+            transitionTask(staleTask, 'CANCELLED');
+            staleTask.error = 'Review evidence became stale after the PR head changed';
+            staleTask.leaseOwner = null;
+            staleTask.leaseExpiresAt = null;
+            await this.store.saveTask(staleTask);
+        }
+        await this.store.saveJob(job);
+    }
+    async ensureFinalReview(job, prState, headSha) {
+        if (prState !== 'OPEN' || job.state !== 'COMPLETED' || !headSha)
+            return;
+        if (!this.preReviewGatesPass(job))
+            return;
+        const review = job.review;
+        if (review?.headSha === headSha && ['started', 'approved', 'changes_required', 'blocked'].includes(review.outcome))
+            return;
+        const reviewTasks = job.tasks.filter(task => task.agentName === 'reviewer' && task.reviewHeadSha === headSha);
+        if (reviewTasks.some(task => ['QUEUED', 'READY', 'RUNNING', 'WAITING'].includes(task.state)))
+            return;
+        if (reviewTasks.some(task => task.state === 'SUCCEEDED' && review?.headSha === headSha && review.outcome === 'approved'))
+            return;
+        const id = `final-review-${headSha.slice(0, 12)}`;
+        const now = new Date().toISOString();
+        const task = { jobId: job.id, id, kind: 'work', priority: job.priority, projectName: job.title, agentName: 'reviewer', parentTaskId: null, dependencies: job.tasks.filter(item => item.agentName !== 'reviewer').map(item => item.id), capabilities: ['review'], adapter: this.options.reviewer?.adapter ?? 'codex', input: `Review PR #${job.prNumber} at head SHA ${headSha}. Objective: ${job.objective ?? job.description ?? job.title}. First verify the deterministic pre-review gates have passed, then inspect the completed work. Emit review.started, then exactly one of review.approved, review.changes_required, or review.blocked with data.review.headSha set to ${headSha}. Do not modify code and do not merge.`, output: { kind: 'task_pr' }, routing: this.options.reviewer?.routing, continuation: null, continuationDeliveredAt: null, reviewHeadSha: headSha, state: 'QUEUED', attempt: 0, maxAttempts: this.options.reviewer?.maxAttempts ?? 2, leaseOwner: null, leaseExpiresAt: null, executionId: null, threadId: null, result: null, plannerResult: null, error: null, timeoutMs: this.options.reviewer?.timeoutMs ?? 300000, createdAt: now, updatedAt: now };
+        await this.store.appendTask(task);
+        job.review = { outcome: 'pending', headSha, taskId: id, evidence: null, updatedAt: now };
+        job.state = 'RUNNING';
+        job.updatedAt = now;
+        await this.store.saveJob(job);
+        await this.emit(eventFor(job.id, id, null, 'review.created', 'queued', `Final review task ${id} created for ${headSha}`, 'orchestrator', { headSha, agentName: 'reviewer' }));
+        const ready = schedule(await this.store.load(job.id));
+        await this.store.saveJob(ready);
+        const reviewTask = ready.tasks.find(item => item.id === id && item.state === 'READY');
+        if (reviewTask && (this.options.maxConcurrent ?? 4) > this.live.size + this.plannerLive.size)
+            await this.launch(ready, reviewTask);
+    }
+    preReviewGatesPass(job) {
+        return job.tasks.filter(task => task.agentName !== 'reviewer').every(task => task.state === 'SUCCEEDED');
+    }
+    async applyReviewEvent(event) {
+        const job = await this.store.load(event.job_id);
+        const task = job.tasks.find(item => item.id === event.task_id && item.agentName === 'reviewer');
+        const reviewData = event.data?.review && typeof event.data.review === 'object' ? event.data.review : undefined;
+        const headSha = typeof reviewData?.headSha === 'string' ? reviewData.headSha : typeof event.data?.headSha === 'string' ? event.data.headSha : task?.reviewHeadSha;
+        if (!task || !headSha || task.reviewHeadSha !== headSha)
+            return;
+        const outcome = event.type === 'review.started' ? 'started' : event.type === 'review.approved' ? 'approved' : event.type === 'review.changes_required' ? 'changes_required' : 'blocked';
+        const currentHeadSha = await this.store.headSha?.();
+        if ((currentHeadSha && currentHeadSha !== headSha) || (job.headSha && job.headSha !== headSha))
+            return;
+        const evidence = { summary: event.message || `Review ${outcome}`, data: { ...(event.data ?? {}), review: reviewData ?? { headSha }, headSha, outcome } };
+        job.review = { outcome, headSha, taskId: task.id, evidence, updatedAt: event.timestamp || new Date().toISOString() };
+        job.updatedAt = job.review.updatedAt;
+        await this.store.saveJob(job);
+    }
     async recoverLostExecutions(job, now) {
         for (const task of job.tasks.filter(item => item.state === 'RUNNING')) {
             const expired = task.leaseExpiresAt !== null && new Date(task.leaseExpiresAt).getTime() <= now;

package/dist/relayd.js

@@ -121,16 +121,22 @@ export async function runDaemon(argv) {
     const webhook = secret ? {
         secret,
         repositories: new Set(repositories),
+        refresh: async (event) => {
+            if (!event.repository || !event.pullRequest)
+                return [];
+            const refreshed = await refreshPullRequest(event.repository, event.pullRequest);
+            return refreshed.map(item => item.job.id);
+        },
         wake: async (event) => {
             if (!event.repository || !event.pullRequest)
                 return;
             try {
-                const refreshed = await refreshPullRequest(event.repository, event.pullRequest);
+                const refreshed = cachedOverviews.filter(item => item.job.repository === event.repository && item.job.prNumber === event.pullRequest);
                 for (const item of refreshed)
                     await pool.webhookWake(bus, item.job, event.deliveryId, event.event, event.action);
             }
             catch (error) {
-                process.stderr.write(`warning: webhook PR refresh unavailable: ${error instanceof Error ? error.message : String(error)}\n`);
+                process.stderr.write(`warning: webhook wake unavailable: ${error instanceof Error ? error.message : String(error)}\n`);
             }
         }
     } : undefined;

package/dist/store.js

@@ -65,6 +65,7 @@ export class InMemoryStore {
         this.values.set(key, renderTaskComment(task));
     }
     async saveTask(task) { this.values.set(`${TASK_MARKER}:${task.jobId ?? ''}:${task.id}`, renderTaskComment(task)); }
+    async headSha() { const jobs = [...this.values.values()].map(parseJob).filter((x) => x !== null); return jobs[0]?.headSha ?? jobs[0]?.review?.headSha ?? null; }
     async listAgents() { return [...this.values.values()].map(parseAgent).filter((x) => x !== null); }
     async saveAgent(agent) { this.values.set(`${AGENT_MARKER}:${agent.id}`, renderAgentComment(agent)); }
     async comments() { return [...this.values.values()].map((body, i) => ({ id: i + 1, body, updatedAt: new Date().toISOString(), authorLogin: 'local' })); }
@@ -460,6 +461,13 @@ export class GitHubStore {
             return 'MERGED';
         return String(pr.state ?? '').toUpperCase() === 'CLOSED' ? 'CLOSED' : 'OPEN';
     }
+    async headSha() {
+        const { owner, name } = this.repoParts();
+        const data = await this.graphql('query($owner:String!,$name:String!,$number:Int!){repository(owner:$owner,name:$name){pullRequest(number:$number){headRefOid}}}', { owner, name, number: this.prNumber });
+        const repository = data.repository;
+        const pr = repository?.pullRequest;
+        return typeof pr?.headRefOid === 'string' ? pr.headRefOid : null;
+    }
     async load(jobId) {
         const comments = (await this.list()).filter(comment => this.isTrusted(comment));
         const jobs = comments.map(x => parseJob(x.body)).filter((x) => x !== null && typeof x.id === 'string' && x.id.length > 0);

package/package.json

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