agents-relay 2.0.68 → 2.0.70

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.publication?.version)states.append(element('span','badge SUCCEEDED',text('v'+job.publication.version)));if(job.publicationFailure)states.append(element('span','badge FAILED',text('PUBLISH FAILED: '+value(job.publicationFailure.stage))));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

@@ -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-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) {
@@ -74,7 +75,7 @@ function pullRequestFacts(payload, action) {
 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 {
@@ -86,26 +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 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;
+        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: number, publication,
+        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')

package/dist/local-authority-store.js

@@ -262,11 +262,20 @@ export class LocalAuthorityDurableStore {
             return job;
         });
     }
-    async mutate(jobId, mutation) {
+    /**
+     * Apply all related lifecycle changes to one freshly loaded Job snapshot.
+     * RelayStore owns the SQLite transaction; callers must not call saveJob,
+     * savePlan, or saveTask from inside this callback.
+     */
+    async mutateJob(jobId, mutation) {
         if (!this.authority.mutateJob)
             throw new Error('Atomic SQLite mutation is required for local lifecycle authority');
         const changed = await this.authority.mutateJob(jobId, mutation);
         publishLocalCommit(changed);
+        return structuredClone(changed);
+    }
+    async mutate(jobId, mutation) {
+        await this.mutateJob(jobId, mutation);
     }
     async listAgents() {
         return structuredClone(await this.authority.loadAgents() ?? []);

package/dist/local-commit-events.js

@@ -1,6 +1,8 @@
 const listeners = new Set();
 /** Notify dashboard listeners only after authoritative SQLite state is committed. */
 export function publishLocalCommit(job) {
+    // Notify after commit. A listener failure may be surfaced to the caller,
+    // but it can never roll back the already-committed SQLite snapshot.
     for (const listener of listeners)
         listener(structuredClone(job));
 }

package/dist/local-git-merge.js

@@ -29,6 +29,14 @@ export function localMergeEligible(job) {
         implementationComplete(job) && completionGateSatisfied(job) &&
         (job.reviewEnabled === false || job.review?.outcome === 'approved');
 }
+export function localMergeCommitMessage(request, sourceSha) {
+    const lines = ['Agents Relay local merge', '', `Agents-Relay-Source-SHA: ${sourceSha}`];
+    if (request.correlationJobId)
+        lines.push(`Agents-Relay-Job: ${request.correlationJobId}`);
+    if (Number.isInteger(request.displayPrNumber) && Number(request.displayPrNumber) > 0)
+        lines.push(`Agents-Relay-Display-PR: ${request.displayPrNumber}`);
+    return lines.join('\n');
+}
 function checkedOutTarget(repoPath, targetRef) {
     const records = git(repoPath, 'worktree', 'list', '--porcelain').split(/\n\n/);
     const paths = records.filter(record => record.split('\n').includes('branch ' + targetRef))
@@ -39,7 +47,7 @@ function checkedOutTarget(repoPath, targetRef) {
     return paths[0] ?? null;
 }
 /** Merge a checked-out branch using Git porcelain so its worktree and index stay coherent. */
-function mergeCheckedOutTarget(repoPath, targetRef, sourceSha, targetSha) {
+function mergeCheckedOutTarget(repoPath, targetRef, sourceSha, targetSha, message) {
     const worktree = checkedOutTarget(repoPath, targetRef);
     if (!worktree)
         throw new Error('Target worktree disappeared before local merge');
@@ -47,8 +55,8 @@ function mergeCheckedOutTarget(repoPath, targetRef, sourceSha, targetSha) {
         || git(worktree, 'rev-parse', 'HEAD') !== targetSha) {
         throw new Error('Local merge target moved before delivery');
     }
-    if (git(worktree, 'status', '--porcelain', '--untracked-files=all')) {
-        throw new Error('Local merge target worktree is not clean');
+    if (git(worktree, 'status', '--porcelain', '--untracked-files=no')) {
+        throw new Error('Local merge target worktree has tracked or index changes');
     }
     if (existsSync(resolve(worktree, git(worktree, 'rev-parse', '--git-path', 'MERGE_HEAD')))) {
         throw new Error('Existing MERGE_HEAD is not owned by Relay; manual resolution required');
@@ -56,7 +64,7 @@ function mergeCheckedOutTarget(repoPath, targetRef, sourceSha, targetSha) {
     // No checkout, reset or force update. Git controls index and working tree,
     // reports conflicts and leaves a recoverable merge state when interrupted.
     try {
-        git(worktree, 'merge', '--no-ff', '--no-edit', '-m', 'Agents Relay local merge', sourceSha);
+        git(worktree, 'merge', '--no-ff', '--no-edit', '-m', message, sourceSha);
     }
     catch (error) {
         // Only a MERGE_HEAD matching our exact source SHA can be attributed to
@@ -86,6 +94,8 @@ function mergeCheckedOutTarget(repoPath, targetRef, sourceSha, targetSha) {
 /** Deliver to a Git ref without ever updating a checked-out ref behind Git's back. */
 export function deliverLocalMerge(repoPath, request) {
     const sourceRef = ref(request.sourceRef), targetRef = ref(request.targetRef);
+    if (targetRef !== 'refs/heads/main')
+        throw new Error('Local Git merge target must always be refs/heads/main');
     if (sourceRef === targetRef)
         throw new Error('Local merge source and target must differ');
     const commonDir = resolve(repoPath, git(repoPath, 'rev-parse', '--git-common-dir'));
@@ -99,14 +109,15 @@ export function deliverLocalMerge(repoPath, request) {
             return { sourceSha, mergedCommitSha: targetSha }; // Idempotent after acknowledged or crashed delivery.
         }
         catch { /* merge required */ }
+        const message = localMergeCommitMessage(request, sourceSha);
         if (checkedOutTarget(repoPath, targetRef)) {
-            return { sourceSha, mergedCommitSha: mergeCheckedOutTarget(repoPath, targetRef, sourceSha, targetSha) };
+            return { sourceSha, mergedCommitSha: mergeCheckedOutTarget(repoPath, targetRef, sourceSha, targetSha, message) };
         }
         // Unchecked-out refs can be updated atomically without touching any worktree.
         const tree = git(repoPath, 'merge-tree', '--write-tree', targetSha, sourceSha).split('\n')[0];
         if (!/^[0-9a-f]{40,64}$/.test(tree))
             throw new Error('Local merge-tree returned no valid tree');
-        const mergedCommitSha = git(repoPath, 'commit-tree', tree, '-p', targetSha, '-p', sourceSha, '-m', 'Agents Relay local merge');
+        const mergedCommitSha = git(repoPath, 'commit-tree', tree, '-p', targetSha, '-p', sourceSha, '-m', message);
         git(repoPath, 'update-ref', targetRef, mergedCommitSha, targetSha);
         return { sourceSha, mergedCommitSha };
     });

package/dist/local-job-path.js

@@ -1,7 +1,12 @@
 import { createHash } from 'node:crypto';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
 /** Primary local store key is immutable Job ID, independent of a PR number. */
 export function relayJobStorePath(directory, jobId) {
     if (!jobId.trim() || jobId.length > 1024)
         throw new Error('Invalid immutable Job ID');
     return directory + '/job-' + createHash('sha256').update(jobId).digest('hex') + '.db';
 }
+export function relayStoreDirectory(env = process.env) {
+    return env.AGENTS_RELAY_STORE_DIR || join(homedir(), '.agents-relay', 'stores');
+}

package/dist/local-job-registry.js

@@ -1,8 +1,8 @@
-import { InMemoryStore } from './store.js';
+import { GitHubStore, InMemoryStore } from './store.js';
 import { LocalAuthorityDurableStore } from './local-authority-store.js';
 import { discoverLocalRelayStoreSnapshots, SQLiteRelayStore } from './relay-store.js';
 /** Resolve exactly one SQLite-backed Job from its immutable ID, independent of PR binding. */
-export function createJobIdRegistryResolver(directory, openStores) {
+export function createJobIdRegistryResolver(directory, openStores, options = {}) {
     return async (jobId) => {
         const snapshots = await discoverLocalRelayStoreSnapshots(directory);
         const matches = snapshots.flatMap(snapshot => snapshot.jobs.filter(job => job.id === jobId).map(job => ({ snapshot, job })));
@@ -17,7 +17,13 @@ export function createJobIdRegistryResolver(directory, openStores) {
             relay = new SQLiteRelayStore(snapshot.path);
             openStores.set(snapshot.path, relay);
         }
-        // The GitHub adapter cannot enter the lifecycle execution store.
-        return { job, relay, store: new LocalAuthorityDurableStore(relay, new InMemoryStore(), undefined, true) };
+        // SQLite remains lifecycle authority. A positive PR binding only enables
+        // the external collaboration adapter for projection/merge side effects.
+        const externalPrNumber = job.externalPrNumber ?? (job.prNumber > 0 ? job.prNumber : 0);
+        const githubEnabled = !options.noGitHub && externalPrNumber > 0 && options.client;
+        const github = githubEnabled
+            ? new GitHubStore(options.client, job.repository, externalPrNumber, options.trustedAuthors ?? new Set())
+            : new InMemoryStore();
+        return { job, relay, store: new LocalAuthorityDurableStore(relay, github, undefined, !githubEnabled) };
     };
 }

package/dist/local-managed-store.js

@@ -1,16 +1,14 @@
-import { homedir } from 'node:os';
-import { join } from 'node:path';
 import { GhApiClient } from './github-client.js';
 import { DisabledGitHubClient, noGitHubMode } from './no-github.js';
 import { GitHubStore } from './store.js';
 import { LocalAuthorityDurableStore } from './local-authority-store.js';
-import { relayStorePath, relayJobStorePath, SQLiteRelayStore } from './relay-store.js';
+import { relayStoreDirectory, relayStorePath, relayJobStorePath, SQLiteRelayStore } from './relay-store.js';
 /** Open the canonical V2 SQLite authority without making any GitHub request. */
 export function openLocalManagedStore(repository, prNumber, options = {}) {
     if (!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(repository) || repository.includes('..') || !Number.isInteger(prNumber) || prNumber < 0 || (prNumber === 0 && !options.jobId)) {
         throw new Error('Local managed store requires a repository and either a positive PR number or immutable jobId');
     }
-    const directory = options.directory ?? join(homedir(), '.agents-relay', 'stores');
+    const directory = options.directory ?? relayStoreDirectory();
     const relay = new SQLiteRelayStore(prNumber === 0 ? relayJobStorePath(directory, options.jobId) : relayStorePath(directory, repository, prNumber));
     const client = prNumber === 0 || options.noGitHub || noGitHubMode() ? new DisabledGitHubClient() : options.client ?? new GhApiClient();
     const github = new GitHubStore(client, repository, prNumber, options.trustedAuthors ?? new Set());