agents-relay 2.0.67 → 2.0.69

package/dist/dashboard-html.js

@@ -1,6 +1,5 @@
 import { createRequire } from 'node:module';
-const packageVersion = createRequire(import.meta.url)('../package.json').version;
-export const dashboardVersion = packageVersion;
+export const dashboardVersion = createRequire(import.meta.url)('../package.json').version;
 export const dashboardHtml = `<!doctype html>
 <html lang="en" data-dashboard-contract="safe-dom,named-relay-events,snapshot-events,bounded-event-history">
 <head>
@@ -87,7 +86,11 @@ export const dashboardHtml = `<!doctype html>
     .agent-arrow { color:var(--muted); font-weight:800; }
     .agent-graph-source { margin:.1rem 0 0; padding:.45rem; border-radius:.35rem; background:var(--surface); color:var(--muted); font:.7rem/1.45 ui-monospace,SFMono-Regular,Menlo,monospace; white-space:pre; overflow:auto; }
     .event-list { display:grid; gap:.45rem; }
-    .event-item { padding-bottom:.4rem; border-bottom:1px solid var(--border); }
+    .event-item { padding:.34rem .42rem .42rem; border-left:3px solid transparent; border-bottom:1px solid var(--border); border-radius:.28rem; }
+    .event-item.event-error { border-left-color:var(--bad); background:#fff4f4; }
+    .event-item.event-error .event-kind,.event-item.event-error .event-message { color:var(--bad); }
+    .event-item.event-warn { border-left-color:var(--warn); background:#fff9eb; }
+    .event-item.event-warn .event-kind { color:var(--warn); }
     .event-meta { display:flex; flex-wrap:wrap; gap:.4rem; color:var(--muted); font-size:.68rem; }
     .event-kind { color:var(--accent); font-weight:800; }
     .event-message { margin:.12rem 0 0; overflow-wrap:anywhere; }
@@ -176,7 +179,6 @@ export const dashboardHtml = `<!doctype html>
       .tagline { display:none; }
     }
     @media (prefers-reduced-motion:reduce) { .skeleton { animation:none; } .usage-fill { transition:none; } }
-
   .router-rules-workspace{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);gap:16px;align-items:start;min-width:0}.router-rules-pane{min-width:0;max-width:100%;overflow:hidden}.rules-editor .rules-textarea{min-height:420px}.audit-log{display:flex;flex-direction:column;gap:8px;max-height:500px;overflow:auto;min-width:0}.audit-entry{border:1px solid var(--border);border-radius:10px;padding:10px;background:var(--surface)}.audit-entry-head{display:flex;justify-content:space-between;gap:8px;align-items:center}.audit-entry pre{white-space:pre-wrap;word-break:break-word;margin:8px 0 0;font-size:11px}.router-test-panel{margin-top:16px;border-top:1px solid var(--border);padding-top:12px}.router-test-results{margin-top:8px;display:flex;flex-direction:column;gap:6px;max-height:480px;overflow:auto;min-width:0}.router-test-results pre{white-space:pre;overflow:auto;max-width:100%;font-size:11px;line-height:1.45;background:var(--surface);border:1px solid var(--border);border-radius:10px;padding:12px}.router-test-row{display:grid;grid-template-columns:minmax(0,1fr) auto auto;gap:8px;padding:7px 0;border-bottom:1px solid var(--border)}@media(max-width:900px){.router-rules-workspace{grid-template-columns:1fr}.router-rules-pane{max-height:none}.router-test-results{max-height:420px}}@media(max-width:650px){#rules-view .panel-head .subtle{display:none}#rules-view .panel-body{max-height:none;overflow:visible;padding:.6rem}#rules-view .router-rules-workspace{gap:.9rem}#rules-view .rules-help{font-size:.74rem;line-height:1.4}#rules-view .rules-textarea{min-height:52vh;padding:.65rem;font-size:12px}#rules-view .rules-footer{align-items:stretch}#rules-view .rules-footer>.subtle{width:100%}#rules-view .rules-footer>div{width:100%;display:grid;grid-template-columns:1fr 1fr;gap:.5rem}#rules-view .rules-save{min-height:44px;width:100%;padding:.55rem .7rem}#rules-view .router-rules-pane>.panel-head{padding:.55rem 0}#rules-view .audit-log{max-height:none}#rules-view .audit-entry-head{align-items:flex-start}#rules-view .audit-entry-head .subtle{display:block;flex:0 0 auto}#rules-view .router-test-panel{min-width:0;max-width:100%;overflow:hidden}#rules-view .router-test-results{max-height:none;width:100%;max-width:100%;overflow-x:hidden}#rules-view .router-test-results>*{min-width:0;max-width:100%}#rules-view .router-test-results pre{width:100%;box-sizing:border-box;white-space:pre-wrap;overflow-wrap:anywhere;word-break:break-word;font-size:11px;padding:.65rem}#rules-view .router-test-row{grid-template-columns:1fr}}
 </style>
 </head>
@@ -263,7 +265,6 @@ export const dashboardHtml = `<!doctype html>
 // link.textContent = 'PR #' + job.prNumber;
 // while (eventFeed.children.length > MAX_EVENTS)
 // function usageBar(label, window)
-
 const MAX_EVENTS=60;
 const DASHBOARD_VERSION=${JSON.stringify(dashboardVersion)};
 const jobsTab=document.querySelector('#jobs-tab');
@@ -325,7 +326,6 @@ let eventTaskId=selectedTaskId;
 const collapsedTasks=new Set();
 const expandedTasks=new Set();
 const displayedEventIds=new Set();
-
 function value(input){return input===null||input===undefined||input===''?'—':String(input);}
 function text(input){return document.createTextNode(value(input));}
 function element(name,className,child){const node=document.createElement(name);if(className)node.className=className;if(child)node.append(child);return node;}
@@ -345,7 +345,7 @@ function cadence(job){const schedule=job?.schedule;if(!schedule?.cron)return '
 function safePrUrl(repository,prNumber){if(typeof repository!=='string'||!Number.isInteger(prNumber)||prNumber<=0)return null;const parts=repository.split('/');if(parts.length!==2)return null;const [owner,repo]=parts;if(!owner||!repo||owner==='.'||owner==='..'||repo==='.'||repo==='..')return null;if(!/^[A-Za-z0-9-]+$/.test(owner)||!/^[A-Za-z0-9._-]+$/.test(repo))return null;return 'https://github.com/'+owner+'/'+repo+'/pull/'+prNumber;}
 function safeCommitUrl(repository,sha){if(typeof repository!=='string'||typeof sha!=='string'||!/^[0-9a-f]{7,64}$/i.test(sha))return null;const parts=repository.split('/');if(parts.length!==2||!parts[0]||!parts[1])return null;return 'https://github.com/'+parts[0]+'/'+parts[1]+'/commit/'+sha;}
 function commitField(label,job,sha){const box=element('div','detail-group');box.append(element('p','detail-label',text(label)));const line=element('p','detail-value');const url=safeCommitUrl(job?.repository,sha);if(url){const link=document.createElement('a');link.href=url;link.target='_blank';link.rel='noopener noreferrer';link.textContent=sha.slice(0,7);line.append(link);}else line.append(text(sha||'—'));box.append(line);return box;}
-function prField(job){const box=element('div','detail-group');box.append(element('p','detail-label',text('GitHub PR')));const line=element('p','detail-value');const url=safePrUrl(job.repository,job.prNumber);if(url){const link=document.createElement('a');link.href=url;link.target='_blank';link.rel='noopener noreferrer';link.textContent='PR #'+job.prNumber;line.append(link);}else line.append(text('unavailable'));box.append(line);return box;}
+function prField(job){const box=element('div','detail-group');box.append(element('p','detail-label',text('GitHub PR')));const line=element('p','detail-value');const prNumber=Number(job.externalPrNumber||job.prNumber||0);const url=safePrUrl(job.repository,prNumber);if(url){const link=document.createElement('a');link.href=url;link.target='_blank';link.rel='noopener noreferrer';link.textContent='PR #'+prNumber;line.append(link);}else line.append(text('unavailable'));box.append(line);return box;}
 function chatField(task){const box=element('div','detail-group');box.append(element('p','detail-label',text('Chat')));const line=element('p','detail-value');if(task.adapter==='chatgpt'&&typeof task.threadId==='string'&&task.threadId){const link=document.createElement('a');link.href='https://chatgpt.com/c/'+encodeURIComponent(task.threadId);link.target='_blank';link.rel='noopener noreferrer';link.textContent='Open chat';line.append(link);}else line.append(text('—'));box.append(line);return box;}
 function taskCommentField(task){const box=element('div','detail-group');box.append(element('p','detail-label',text('PR comment')));const line=element('p','detail-value');if(typeof task.taskUrl==='string'&&task.taskUrl.startsWith('https://github.com/')){const link=document.createElement('a');link.className='task-link';link.href=task.taskUrl;link.target='_blank';link.rel='noopener noreferrer';link.textContent='Open task comment';line.append(link);}else line.append(text('—'));box.append(line);return box;}
 function parseAgentGraphSource(source){if(typeof source!=='string'||!source.trim())return null;const agents=new Map(),edges=[];for(const raw of source.split(/\\r?\\n/)){const line=raw.trim();if(!line||line.startsWith('%%')||line.startsWith('flowchart '))continue;let match=line.match(/^([A-Za-z_][A-Za-z0-9_.-]*)(?:\\[agent:([A-Za-z_][A-Za-z0-9_.-]*)\\])?\\s*-->\\s*([A-Za-z_][A-Za-z0-9_.-]*)(?:\\[agent:([A-Za-z_][A-Za-z0-9_.-]*)\\])?$/);if(match){agents.set(match[1],match[2]||agents.get(match[1])||match[1]);agents.set(match[3],match[4]||agents.get(match[3])||match[3]);edges.push([match[1],match[3]]);continue;}match=line.match(/^([A-Za-z_][A-Za-z0-9_.-]*)\\[agent:([A-Za-z_][A-Za-z0-9_.-]*)\\]$/);if(match){agents.set(match[1],match[2]);continue;}return null;}const incoming=new Map([...agents.keys()].map(id=>[id,0]));for(const [,to] of edges)incoming.set(to,(incoming.get(to)||0)+1);const remaining=new Map(incoming),waves=[];let ready=[...remaining].filter(([,degree])=>degree===0).map(([id])=>id).sort();while(ready.length){waves.push(ready);const next=[];for(const id of ready)for(const [from,to] of edges)if(from===id){const degree=(remaining.get(to)||0)-1;remaining.set(to,degree);if(degree===0)next.push(to);}ready=[...new Set(next)].sort();}return {agents,waves};}
@@ -388,7 +388,7 @@ function jobChatRef(job){return repoName(job?.repository)+'/pr#'+value(job?.prNu
 function chatShortcutUrl(prompt){return 'https://chatgpt.com/?prompt='+encodeURIComponent(prompt);}
 const CHAT_SHORTCUT_TARGET='agents-relay-shortcut';
 function chatShortcutField(job){const box=element('div','detail-group');box.append(element('p','detail-label',text('ChatGPT shortcut')));const select=document.createElement('select');select.className='job-filter job-chat-shortcut-select';select.setAttribute('aria-label','ChatGPT shortcut');select.append(new Option('',''));for(const item of parseChatShortcuts(chatShortcutText()))select.append(new Option(item.name,item.prompt));select.value='';select.addEventListener('change',()=>{if(!select.value)return;const prompt=select.value.replaceAll('%1',jobChatRef(job));window.open(chatShortcutUrl(prompt),CHAT_SHORTCUT_TARGET,'noopener');select.value='';});box.append(select);return box;}
-function renderJobList(){jobList.replaceChildren();const visible=filteredJobs();if(!jobs.length){jobList.append(element('li','empty',text('No durable jobs discovered.')));return;}if(!visible.length){jobList.append(element('li','empty',text('No jobs match the selected repo.')));return;}for(const job of visible){const row=element('div','job-row'+(isCompleteUnmerged(job)?' complete-unmerged':''));row.setAttribute('aria-current',String(jobSelectionKey(job)===selectedJob));row.addEventListener('click',()=>selectJob(job));const content=element('div','job-content');const select=document.createElement('button');select.type='button';select.className='job-button';select.setAttribute('aria-current',String(jobSelectionKey(job)===selectedJob));select.title=job.title||job.id;select.addEventListener('click',event=>{event.stopPropagation();selectJob(job);});select.append(element('span','job-title',text(repoName(job.repository)+'/PR#'+value(job.prNumber)+': '+value(job.title||job.id))));const states=element('span','job-status-line');states.append(element('span','badge '+value(job.state),text(value(job.state))),element('span','badge '+value(job.runtimeStatus||'IDLE'),text(value(job.runtimeStatus||'IDLE'))));if(job.executionMode==='autonomous')states.append(element('span','badge flag-autonomous',text('AUTONOMOUS')));if(job.reviewEnabled!==false&&job.githubState!=='MERGED')states.append(element('span','badge flag-review',text('REVIEW REQUIRED')));if(job.githubState==='MERGED'&&job.publication?.version)states.append(element('span','badge SUCCEEDED',text('v'+job.publication.version)));if(isCompleteUnmerged(job))states.append(element('span','badge MERGE_PENDING',text('MERGE PENDING')));const primary=element('div','job-primary');primary.append(states);const lastLine=element('div','job-last-line');lastLine.append(element('span','subtle',text(compactCounts(counts(job.tasks)))),element('span','subtle',text(relativeTime(job.updatedAt))));content.append(select,primary,lastLine);row.append(content);jobList.append(element('li','',row));}}
+function renderJobList(){jobList.replaceChildren();const visible=filteredJobs();if(!jobs.length){jobList.append(element('li','empty',text('No durable jobs discovered.')));return;}if(!visible.length){jobList.append(element('li','empty',text('No jobs match the selected repo.')));return;}for(const job of visible){const row=element('div','job-row'+(isCompleteUnmerged(job)?' complete-unmerged':''));row.setAttribute('aria-current',String(jobSelectionKey(job)===selectedJob));row.addEventListener('click',()=>selectJob(job));const content=element('div','job-content');const select=document.createElement('button');select.type='button';select.className='job-button';select.setAttribute('aria-current',String(jobSelectionKey(job)===selectedJob));select.title=job.title||job.id;select.addEventListener('click',event=>{event.stopPropagation();selectJob(job);});select.append(element('span','job-title',text(repoName(job.repository)+'/'+(Number(job.externalPrNumber||job.prNumber||0)>0?'PR#'+value(job.externalPrNumber||job.prNumber):'Job '+value(job.id))+': '+value(job.title||job.id))));const states=element('span','job-status-line');states.append(element('span','badge '+value(job.state),text(value(job.state))),element('span','badge '+value(job.runtimeStatus||'IDLE'),text(value(job.runtimeStatus||'IDLE'))));if(job.publicationFailure)states.append(element('span','badge FAILED',text('PUBLISH FAILED: '+value(job.publicationFailure.stage))));else if(job.publication?.version)states.append(element('span','badge SUCCEEDED',text('v'+job.publication.version)));else if(Number(job.externalPrNumber||0)>0&&job.githubState==='MERGED')states.append(element('span','badge MERGED',text('PR Merged')));else if(job.state==='COMPLETED'&&job.githubState==='CLOSED')states.append(element('span','badge SUCCEEDED',text('PR Archived')));if(job.executionMode==='autonomous')states.append(element('span','badge flag-autonomous',text('AUTONOMOUS')));if(job.state==='ACTIVE'&&job.reviewEnabled!==false)states.append(element('span','badge flag-review',text('REVIEW REQUIRED')));if(isCompleteUnmerged(job))states.append(element('span','badge MERGE_PENDING',text('MERGE PENDING')));const primary=element('div','job-primary');primary.append(states);const lastLine=element('div','job-last-line');lastLine.append(element('span','subtle',text(compactCounts(counts(job.tasks)))),element('span','subtle',text(relativeTime(job.updatedAt))));content.append(select,primary,lastLine);row.append(content);jobList.append(element('li','',row));}}
 function taskTagDisplay(job,task){const display=task.tag&&job?.tag?.values?.[task.tag];return typeof display==='string'&&display?display:null;}
 function taskSubtreeComplete(task,children){return ['SUCCEEDED','CANCELLED'].includes(task.state)&&(children.get(task.id)||[]).every(child=>taskSubtreeComplete(child,children));}
 function taskNode(task,children,depth){const li=element('li');const nested=children.get(task.id)||[];const line=element('div','task-line');if(nested.length){const key=(selectedJob||'')+':'+task.id;const collapsed=collapsedTasks.has(key)||(!expandedTasks.has(key)&&taskSubtreeComplete(task,children));const fold=document.createElement('button');fold.type='button';fold.className='task-fold';fold.setAttribute('aria-expanded',String(!collapsed));fold.setAttribute('aria-label',(collapsed?'Expand ':'Collapse ')+task.id);fold.textContent=collapsed?'▸':'▾';line.append(fold);const ul=element('ul','tree');ul.hidden=collapsed;for(const child of nested)ul.append(taskNode(child,children,depth+1));fold.addEventListener('click',()=>{const next=!ul.hidden;ul.hidden=next;fold.setAttribute('aria-expanded',String(!next));fold.setAttribute('aria-label',(next?'Expand ':'Collapse ')+task.id);fold.textContent=next?'▸':'▾';if(next){collapsedTasks.add(key);expandedTasks.delete(key);}else{collapsedTasks.delete(key);expandedTasks.add(key);}});li.append(line,ul);}else li.append(line);const row=document.createElement('button');row.type='button';row.className='task-row';row.setAttribute('aria-current',String(task.id===selectedTaskId));row.title=task.id;row.addEventListener('click',()=>{const deselect=selectedTaskId===task.id;selectedTaskId=deselect?null:task.id;eventTaskId=deselect?null:task.id;rememberSelection();clearEvents();renderAll();void loadEventHistory();});const id=element('span','task-id',text(task.id));id.style.paddingLeft=Math.min(depth,4)*6+'px';row.append(id,element('span','badge '+value(task.state),text(task.state)));const tag=taskTagDisplay(selected(),task);if(tag){const badge=element('span','task-tag',text(tag));badge.title=(selected()?.tag?.description||'Task tag')+': '+task.tag;row.append(badge);}line.append(row);return li;}
@@ -424,7 +424,8 @@ async function refreshStatus(){try{renderRateLimitStatus(await loadJSON('/api/st
 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:[];void drawRuntimeSummary();jobs.sort(compareJobs);if(selectedJob&&!jobForSelection(selectedJob)){selectedJob=null;selectedTaskId=null;}if(!selectedJob){const match=location.hash.match(/^#\\/jobs\\/(.+)$/);const fromHash=match?decodeURIComponent(match[1]):null;const fromRoute=jobForSelection(fromHash);selectedJob=jobSelectionKey(fromRoute||jobs[0]);}rememberSelection();renderAll();void loadEventHistory();connection.textContent='';connection.setAttribute('aria-label','Live durable state connected');connection.className='status-pill ok';}catch(error){connection.textContent='';connection.setAttribute('aria-label','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','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){const current=selected();if(!event||current&&event.job_id&&event.job_id!==current.id||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 eventSeverity(event,level){const type=String(event?.type||'').toLowerCase(),eventLevel=String(event?.level||level||'').toLowerCase(),outcome=String(event?.outcome||event?.status||'').toLowerCase();if(eventLevel==='error'||outcome==='failed'||type.endsWith('.failed')||type==='task.failed')return 'error';if(eventLevel==='warn'||outcome==='blocked'||type.endsWith('.blocked')||type==='task.blocked'||type==='review.blocked')return 'warn';return 'normal';}
+function addEvent(event,level){const current=selected();if(!event||current&&event.job_id&&event.job_id!==current.id||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 severity=eventSeverity(event,level);const item=element('li','event-item'+(severity==='error'?' event-error':severity==='warn'?' event-warn':''));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'));item.append(message);eventFeed.querySelector('.empty')?.remove();eventFeed.prepend(item);while(eventFeed.children.length>MAX_EVENTS)eventFeed.lastElementChild?.remove();}
 function resetText(windowData){if(!Number.isFinite(windowData.resetsAt))return '';const at=new Date(windowData.resetsAt*1000);const minutes=Math.max(0,Math.ceil((at.getTime()-Date.now())/60000));const relative=minutes<60?minutes+'m':minutes<1440?Math.floor(minutes/60)+'h '+minutes%60+'m':Math.floor(minutes/1440)+'d '+Math.floor((minutes%1440)/60)+'h';return 'Resets '+at.toLocaleString()+' · in '+relative;}
 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);const reset=resetText(windowData);if(reset)row.append(element('div','subtle',text(reset)));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;}
@@ -481,12 +482,14 @@ auditRefresh.addEventListener('click',()=>void drawAudit());
 shortcutsSave.addEventListener('click',saveShortcuts);
 window.addEventListener('keydown',event=>{if(event.key==='Tab'&&event.altKey){event.preventDefault();const views=['jobs','usage','graphs','rules','shortcuts'];const current=location.hash==='#/usage'?'usage':location.hash==='#/graphs'?'graphs':location.hash==='#/execution-router-rules'?'rules':location.hash==='#/shortcuts'?'shortcuts':'jobs';const next=views[(views.indexOf(current)+1)%views.length];location.hash=next==='usage'?'#/usage':next==='graphs'?'#/graphs':next==='rules'?'#/execution-router-rules':next==='shortcuts'?'#/shortcuts':(selectedJob?'#/jobs/'+encodeURIComponent(selectedJob):'#/jobs');showView(next);}});
 function parseMessage(message){try{return JSON.parse(message.data);}catch{return null;}}
-function applyStatePatch(patch){if(!patch?.jobId)return false;const job=jobs.find(candidate=>candidate.id===patch.jobId);if(!job)return false;if(patch.jobState)job['state']=patch.jobState;if(patch.jobUpdatedAt)job.updatedAt=patch.jobUpdatedAt;if(patch.taskId&&patch.taskState){const task=(job.tasks||[]).find(candidate=>candidate.id===patch.taskId);if(task){task['state']=patch.taskState;if(patch.taskUpdatedAt)task.updatedAt=patch.taskUpdatedAt;}}return true;}
+function isFreshEnough(incoming,current){const a=Date.parse(incoming||''),b=Date.parse(current||'');return !Number.isFinite(b)||!Number.isFinite(a)||a>=b;}
+function applyStatePatch(patch){if(!patch?.jobId)return false;const job=jobs.find(candidate=>candidate.id===patch.jobId);if(!job)return false;if(patch.jobState&&isFreshEnough(patch.jobUpdatedAt,job.updatedAt)){job['state']=patch.jobState;if(patch.jobUpdatedAt)job.updatedAt=patch.jobUpdatedAt;}if(patch.taskId&&patch.taskState){const task=(job.tasks||[]).find(candidate=>candidate.id===patch.taskId);if(task&&isFreshEnough(patch.taskUpdatedAt,task.updatedAt)){task['state']=patch.taskState;if(patch.taskUpdatedAt)task.updatedAt=patch.taskUpdatedAt;}}return true;}
+function upsertFreshJob(incoming){if(!incoming)return;const index=jobs.findIndex(job=>jobSelectionKey(job)===jobSelectionKey(incoming));if(index<0){jobs.push(incoming);return;}if(isFreshEnough(incoming.updatedAt,jobs[index].updatedAt))jobs[index]=incoming;}
 const stream=new EventSource('/events');
 stream.onopen=()=>{connection.textContent='';connection.setAttribute('aria-label','Event stream connected');connection.className='status-pill ok';};
 stream.onerror=()=>{connection.textContent='';connection.setAttribute('aria-label','Event stream reconnecting');connection.className='status-pill warn';};
-stream.onmessage=message=>{const payload=parseMessage(message);if(payload?.job){const index=jobs.findIndex(job=>jobSelectionKey(job)===jobSelectionKey(payload.job));if(index>=0)jobs[index]=payload.job;else jobs.push(payload.job);renderAll();void drawRuntimeSummary();}};
-stream.addEventListener('relay',message=>{const payload=parseMessage(message);if(payload?.job){const index=jobs.findIndex(job=>jobSelectionKey(job)===jobSelectionKey(payload.job));if(index>=0)jobs[index]=payload.job;else jobs.push(payload.job);}else if(payload?.statePatch)applyStatePatch(payload.statePatch);if(payload?.event)addEvent(payload.event);renderAll();void drawRuntimeSummary();});
+stream.onmessage=message=>{const payload=parseMessage(message);if(payload?.job){upsertFreshJob(payload.job);renderAll();void drawRuntimeSummary();}};
+stream.addEventListener('relay',message=>{const payload=parseMessage(message);if(payload?.job)upsertFreshJob(payload.job);else if(payload?.statePatch)applyStatePatch(payload.statePatch);if(payload?.event)addEvent(payload.event);renderAll();void drawRuntimeSummary();});
 if(location.hash==='#/usage')showView('usage');else if(location.hash==='#/graphs')showView('graphs');else if(location.hash==='#/execution-router-rules')showView('rules');else if(location.hash==='#/shortcuts')showView('shortcuts');else showView('jobs');
 setInterval(()=>{if(location.hash==='#/usage')void drawUsage();},30000);
 setInterval(()=>void refreshVersion(),30000);

package/dist/dashboard.js

@@ -71,7 +71,7 @@ export function serveDashboard(store, port = 8787, bus, refreshMs = 300000, jobI
     const discoveredJobs = async (forceRefresh = false) => {
         try {
             const jobs = overviewProvider
-                ? (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 }))
+                ? (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, publicationFailure: item.publicationFailure }))
                 : jobId ? [await store.load(jobId)] : [];
             lastKnownJobs = jobs;
             return jobs;
@@ -202,7 +202,7 @@ export function serveDashboard(store, port = 8787, bus, refreshMs = 300000, jobI
                 res.end('Ignored');
                 return;
             }
-            if (!event.repository || !webhook.repositories.has(event.repository) || (webhook.pullRequest !== undefined && event.pullRequest !== null && event.pullRequest !== webhook.pullRequest)) {
+            if (!event.repository || !webhook.repositories.has(event.repository) || (webhook.jobId !== undefined && event.jobId !== undefined && event.jobId !== null && event.jobId !== webhook.jobId) || (webhook.pullRequest !== undefined && event.pullRequest !== null && event.pullRequest !== webhook.pullRequest)) {
                 res.writeHead(202);
                 res.end('Ignored');
                 return;
@@ -238,6 +238,31 @@ export function serveDashboard(store, port = 8787, bus, refreshMs = 300000, jobI
             }
             return;
         }
+        if (new URL(req.url ?? '/', 'http://127.0.0.1').pathname === '/api/control') {
+            if (req.method !== 'POST' || !resolvedActions?.control) {
+                res.writeHead(404);
+                res.end('Control API unavailable');
+                return;
+            }
+            try {
+                const chunks = [];
+                for await (const chunk of req)
+                    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+                const body = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+                const result = await resolvedActions.control(body);
+                if (!res.headersSent)
+                    res.writeHead(200, { 'content-type': 'application/json' });
+                if (!res.writableEnded)
+                    res.end(JSON.stringify(result));
+            }
+            catch (error) {
+                if (!res.headersSent)
+                    res.writeHead(409);
+                if (!res.writableEnded)
+                    res.end(error instanceof Error ? error.message : String(error));
+            }
+            return;
+        }
         if (new URL(req.url ?? '/', 'http://127.0.0.1').pathname === '/api/job-action') {
             const url = new URL(req.url ?? '/', 'http://127.0.0.1');
             const requestedJobId = url.searchParams.get('id') ?? '';

package/dist/e2e-injection.js

@@ -0,0 +1,76 @@
+const legacy = {
+    quota_exceeded: { method: 'worker.codex.launch', action: 'return', execution: 'skip', mock: 'worker_quota' },
+    model_not_found: { method: 'worker.codex.launch', action: 'return', execution: 'skip', mock: 'worker_model_not_found' },
+    provider_unavailable: { method: 'worker.codex.launch', action: 'return', execution: 'skip', mock: 'worker_provider_unavailable' },
+    github_projection_failure: { method: 'github.projectLocalMerge', action: 'throw', execution: 'skip', error: { code: 'SERVICE_UNAVAILABLE', message: 'E2E transient GitHub projection transport failure', status: 503 } },
+};
+export function parseTestInjection(value) {
+    if (typeof value === 'string')
+        return legacy[value];
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const v = value;
+    if (v.method !== 'worker.codex.launch' && v.method !== 'github.projectLocalMerge' && v.method !== 'browserWorkspace.command')
+        return undefined;
+    if (v.action !== 'throw' && v.action !== 'return' && v.action !== 'pass')
+        return undefined;
+    if (v.execution !== 'skip' && v.execution !== 'after' && v.execution !== 'run')
+        return undefined;
+    const error = v.error;
+    if (v.action === 'throw' && (!error || typeof error !== 'object' || typeof error.message !== 'string' || typeof error.code !== 'string'))
+        return undefined;
+    const mock = v.mock;
+    if (v.action === 'return' && (v.method !== 'worker.codex.launch' || !['worker_quota', 'worker_model_not_found', 'worker_provider_unavailable'].includes(String(mock))))
+        return undefined;
+    if (v.method === 'worker.codex.launch' && v.action !== 'pass' && (v.action !== 'return' || v.execution !== 'skip'))
+        return undefined;
+    if (v.action === 'pass' && v.execution !== 'run')
+        return undefined;
+    if (v.action !== 'pass' && v.execution === 'run')
+        return undefined;
+    return { method: v.method, action: v.action, execution: v.execution, error: error, mock: mock };
+}
+export function authorizedInjection(repository, raw, env = process.env) {
+    return env.E2E_REPO && repository === env.E2E_REPO ? parseTestInjection(raw) : undefined;
+}
+function mockWorker(name) {
+    const message = name === 'worker_quota' ? 'rate_limit_exceeded: usage limit reached' : name === 'worker_model_not_found' ? 'model_not_found: model is unavailable' : 'provider_unavailable: provider refused the request';
+    const promise = Promise.reject(new Error(message));
+    promise.catch(() => { });
+    return { id: 'e2e-injected', launched: Promise.resolve(), promise, cancel: () => { }, processExit: { exitCode: 1, signal: null, stderr: message, terminationReason: null } };
+}
+/** Caller must supply a configuration already consumed durably before this invocation. */
+export function withTestInjection(method, config, execute) {
+    if (!config || config.method !== method || config.action === 'pass')
+        return execute();
+    const apply = (original) => {
+        if (config.action === 'throw') {
+            const error = Object.assign(new Error(config.error.message), { code: config.error.code, status: config.error.status });
+            throw error;
+        }
+        if (method === 'worker.codex.launch' && config.mock)
+            return mockWorker(config.mock);
+        return original;
+    };
+    return config.execution === 'after' ? Promise.resolve(execute()).then(apply) : apply();
+}
+/** Shared atomic consumer, scoped solely by E2E_REPO and exact method. */
+export async function consumeMethodInjection(relay, repository, jobId, method) {
+    if (!process.env.E2E_REPO || process.env.E2E_REPO !== repository || !relay.mutateJob)
+        return undefined;
+    let config;
+    await relay.mutateJob(jobId, job => {
+        if (job.repository !== repository)
+            return job;
+        const task = job.tasks.find(t => authorizedInjection(job.repository, t.testInjection)?.method === method);
+        if (!task)
+            return job;
+        config = authorizedInjection(job.repository, task.testInjection);
+        delete task.testInjection;
+        task.updatedAt = new Date(Math.max(Date.now(), Date.parse(task.updatedAt) + 1)).toISOString();
+        return job;
+    });
+    if (config && (await relay.loadJob(jobId))?.tasks.some(t => authorizedInjection(repository, t.testInjection)?.method === method))
+        throw Error(`E2E injection consumption not committed: ${jobId}`);
+    return config;
+}

package/dist/github-auth.js

@@ -15,17 +15,18 @@ export function githubAppConfig(args, env = process.env) {
         throw new Error('GitHub App auth requires app id, installation id, and private key file');
     return { appId, installationId, privateKeyFile };
 }
-export async function githubAuthContext(args, env = process.env) {
+export async function githubAuthContext(args, env = process.env, probeLogin = true) {
     const config = githubAppConfig(args, env);
     let options = null;
     if (config)
         options = { appId: config.appId, installationId: config.installationId, privateKey: await readFile(config.privateKeyFile, 'utf8') };
     const client = new GhApiClient(options);
     const trustedAuthors = new Set();
-    trustedAuthors.add(await client.currentLogin());
+    if (probeLogin)
+        trustedAuthors.add(await client.currentLogin());
     for (const author of (value(args, '--trusted-authors') || env.AGENTS_RELAY_TRUSTED_AUTHORS || '').split(',').map(item => item.trim()).filter(Boolean))
         trustedAuthors.add(author);
-    if (options) {
+    if (options && probeLogin) {
         const local = await client.localLogin();
         if (local)
             trustedAuthors.add(local);

package/dist/github-binding-order.js

@@ -0,0 +1,15 @@
+/** Fresh unbound ACTIVE jobs are highest priority; terminal projection debt is last. */
+export function orderGitHubBindingCandidates(items) {
+    return [...items].sort((a, b) => score(a.job) - score(b.job) || a.job.createdAt.localeCompare(b.job.createdAt));
+}
+function score(job) {
+    const bound = (job.externalPrNumber ?? (job.prNumber > 0 ? job.prNumber : 0)) > 0;
+    const terminal = ['COMPLETED', 'CANCELLED'].includes(job.state);
+    if (!terminal && !bound)
+        return 0;
+    if (!terminal && bound)
+        return 1;
+    if (terminal && bound)
+        return 2;
+    return 3;
+}

package/dist/github-client.js

@@ -241,13 +241,18 @@ export class GhApiClient {
             let stdout = '';
             child.stdout?.on('data', (chunk) => { stdout += chunk.toString(); });
             child.on('error', () => resolve(null));
-            child.on('close', () => {
+            child.on('close', (code) => {
+                if (code !== 0) {
+                    resolve(null);
+                    return;
+                }
                 try {
                     const value = JSON.parse(stdout);
                     const hosts = value.hosts;
                     const github = hosts?.['github.com'];
                     const active = Array.isArray(github) ? github.find(item => item.active === true) : undefined;
-                    resolve(typeof active?.login === 'string' && active.login.length > 0 ? active.login : null);
+                    const healthy = active && active.state !== 'error' && typeof active.error !== 'string';
+                    resolve(healthy && typeof active?.login === 'string' && active.login.length > 0 ? active.login : null);
                 }
                 catch {
                     resolve(null);

package/dist/github-pr-archive.js

@@ -0,0 +1,22 @@
+/** A PR is a read-only collaboration record after authoritative local completion. */
+export async function archiveDisplayPullRequest(client, repository, number, jobId, publishedSha, state) {
+    if (state !== 'OPEN')
+        return 'already_closed';
+    const marker = `Agents Relay local completion: ${jobId}`;
+    const path = `repos/${repository}/issues/${number}/comments?per_page=100`;
+    const comments = await client.request(path);
+    if (!Array.isArray(comments))
+        throw new Error('Cannot verify PR archive comment idempotency');
+    const alreadyCommented = comments.some(item => item && typeof item === 'object'
+        && 'body' in item && typeof item.body === 'string' && item.body.includes(marker));
+    if (!alreadyCommented) {
+        await client.request(`repos/${repository}/issues/${number}/comments`, {
+            method: 'POST',
+            body: JSON.stringify({ body: `${marker}\nPublished local main commit: ${publishedSha}.\nThis PR is closed as a review record; GitHub did not perform a merge.` }),
+        });
+    }
+    await client.request(`repos/${repository}/pulls/${number}`, {
+        method: 'PATCH', body: JSON.stringify({ state: 'closed' }),
+    });
+    return 'archived';
+}

package/dist/github-webhook.js

@@ -14,7 +14,7 @@ export function parsePackagePublishFailureMarker(body) {
         const data = JSON.parse(body.slice(start + prefix.length, end));
         if (typeof data.runId !== 'string' || !/^\d+$/.test(data.runId) || !Number.isInteger(data.attempt) || Number(data.attempt) < 1 || typeof data.sha !== 'string' || !/^[a-f0-9]{7,40}$/i.test(data.sha) || typeof data.stage !== 'string' || !data.stage)
             return null;
-        return { runId: data.runId, attempt: Number(data.attempt), sha: data.sha, stage: data.stage };
+        return { runId: data.runId, attempt: Number(data.attempt), sha: data.sha, stage: data.stage, ...(typeof data.jobId === 'string' && data.jobId ? { jobId: data.jobId } : {}) };
     }
     catch {
         return null;
@@ -45,6 +45,7 @@ export function parsePackagePublicationMarker(body) {
         version: value.version,
         registry: typeof value.registry === 'string' ? value.registry : null,
         sha: typeof value.sha === 'string' ? value.sha : null,
+        ...(typeof value.jobId === 'string' && value.jobId ? { jobId: value.jobId } : {}),
     };
 }
 export function verifyGitHubWebhook(secret, body, signature) {
@@ -65,14 +66,16 @@ function pullRequestFacts(payload, action) {
     const sha = typeof head?.sha === 'string' ? head.sha : null;
     if (!ref || !sha)
         return null;
+    const updated = typeof pr.updated_at === 'string' && Number.isFinite(Date.parse(pr.updated_at))
+        ? { observedAt: new Date(pr.updated_at).toISOString() } : {};
     if (action === 'closed')
-        return { state: pr.merged === true ? 'MERGED' : 'CLOSED', head: { ref, sha } };
-    return { state: 'OPEN', head: { ref, sha } };
+        return { state: pr.merged === true ? 'MERGED' : 'CLOSED', head: { ref, sha }, ...updated };
+    return { state: 'OPEN', head: { ref, sha }, ...updated };
 }
 export function parseGitHubWebhook(headers, body) {
     const deliveryId = String(headers['x-github-delivery'] ?? '');
     const event = String(headers['x-github-event'] ?? '');
-    if (!deliveryId || (event !== 'pull_request' && event !== 'issue_comment'))
+    if (!deliveryId || (event !== 'pull_request' && event !== 'issue_comment' && event !== 'commit_comment'))
         return null;
     let payload;
     try {
@@ -84,20 +87,50 @@ export function parseGitHubWebhook(headers, body) {
     const repository = payload.repository;
     const repositoryName = typeof repository?.full_name === 'string' ? repository.full_name : null;
     const action = typeof payload.action === 'string' ? payload.action : null;
+    if (!repositoryName)
+        return null;
+    if (event === 'commit_comment') {
+        const comment = payload.comment;
+        const trustedPublisher = comment?.user?.login === 'github-actions[bot]';
+        const publication = trustedPublisher ? parsePackagePublicationMarker(comment?.body) : null;
+        const publishFailure = trustedPublisher ? parsePackagePublishFailureMarker(comment?.body) : null;
+        const jobId = publication?.jobId ?? publishFailure?.jobId;
+        if ((!publication && !publishFailure) || !jobId)
+            return null;
+        const commentTime = comment?.created_at;
+        const publicationObservedAt = typeof commentTime === 'string' && Number.isFinite(Date.parse(commentTime))
+            ? new Date(commentTime).toISOString() : undefined;
+        return { deliveryId, event, action, repository: repositoryName, pullRequest: null, jobId, publication,
+            ...(publicationObservedAt ? { publicationObservedAt } : {}),
+            ...(publishFailure ? { publishFailure } : {}), pullRequestFacts: null };
+    }
     const pr = payload.pull_request;
     const issue = payload.issue;
-    const number = Number(pr?.number ?? (issue?.pull_request ? issue.number : 0));
-    if (!repositoryName || !Number.isInteger(number) || number <= 0)
-        return null;
     if (event === 'issue_comment') {
+        const issueNumber = Number(issue?.number ?? 0);
+        if (!Number.isInteger(issueNumber) || issueNumber <= 0)
+            return null;
         const comment = payload.comment;
-        const publication = parsePackagePublicationMarker(comment?.body);
-        const publishFailure = comment?.user?.login === 'github-actions[bot]'
+        const trustedPublisher = comment?.user?.login === 'github-actions[bot]';
+        const publication = trustedPublisher ? parsePackagePublicationMarker(comment?.body) : null;
+        const publishFailure = trustedPublisher
             ? parsePackagePublishFailureMarker(comment?.body) : null;
+        const jobId = publication?.jobId ?? publishFailure?.jobId;
         if (!publication && !publishFailure)
             return null;
-        return { deliveryId, event, action, repository: repositoryName, pullRequest: number, publication, ...(publishFailure ? { publishFailure } : {}), pullRequestFacts: null };
+        if (!issue?.pull_request && !jobId)
+            return null;
+        const commentTime = comment?.created_at;
+        const publicationObservedAt = typeof commentTime === 'string' && Number.isFinite(Date.parse(commentTime))
+            ? new Date(commentTime).toISOString() : undefined;
+        return { deliveryId, event, action, repository: repositoryName,
+            pullRequest: issue?.pull_request ? issueNumber : null, ...(jobId ? { jobId } : {}), publication,
+            ...(publicationObservedAt ? { publicationObservedAt } : {}),
+            ...(publishFailure ? { publishFailure } : {}), pullRequestFacts: null };
     }
+    const number = Number(pr?.number ?? 0);
+    if (!Number.isInteger(number) || number <= 0)
+        return null;
     const facts = pullRequestFacts(payload, action);
     if (!facts)
         return null;

package/dist/job-actions.js

@@ -1,5 +1,6 @@
 import { transitionJobEvent } from './scheduler.js';
 import { tryApplyTaskCancelAction } from './task-actions.js';
+import { decideJobLifecycle, dispatchJobLifecycleSync } from './workflow/lifecycle.js';
 export const JOB_ACTIVATE_ACTION = 'job.activate';
 export const JOB_CANCEL_ACTION = 'job.cancel';
 async function transitionJobAction(job, event, action) {
@@ -34,8 +35,36 @@ async function cancelActiveWork(store, job, reason) {
         await store.saveTask(task);
     }
 }
+function cancelActiveWorkSnapshot(job, reason) {
+    for (const plan of (job.plans ?? []).filter(item => item.status === 'PLANNING')) {
+        plan.status = 'FAILED';
+        plan.error = reason;
+        plan.assessment = `Planning failed: ${reason}`;
+        plan.leaseOwner = null;
+        plan.leaseExpiresAt = null;
+        plan.executionId = null;
+        plan.updatedAt = new Date().toISOString();
+    }
+    for (const task of job.tasks)
+        tryApplyTaskCancelAction(task, reason);
+}
 export async function applyJobCancelAction(store, job, reason = 'Job cancelled') {
     const from = job.state;
+    if (store.mutateJob) {
+        const updated = await store.mutateJob(job.id, current => {
+            const decision = decideJobLifecycle(current, 'cancel');
+            if (!decision.accepted)
+                throw new Error(`Job ${current.id} is not cancellable (${current.state})`);
+            dispatchJobLifecycleSync(current, 'cancel');
+            if (!decision.actions.includes('effect.cancelActiveTasks'))
+                throw new Error('Unsupported job.cancel effect');
+            cancelActiveWorkSnapshot(current, reason);
+            current.updatedAt = new Date().toISOString();
+            return current;
+        });
+        Object.assign(job, structuredClone(updated));
+        return job;
+    }
     try {
         await transitionJobEvent(job, 'cancel', {}, async (actionId) => {
             if (actionId !== 'effect.cancelActiveTasks')