agents-relay 1.0.104 → 1.0.106

package/dist/dashboard-html.js

@@ -14,6 +14,9 @@ export const dashboardHtml = `<!doctype html>
     header { position:sticky; top:0; z-index:3; background:var(--surface); border-bottom:1px solid var(--border); padding:.8rem 1rem; }
     .brand { display:flex; align-items:baseline; gap:.65rem; min-width:0; }
     .version { margin-left:auto; color:var(--muted); font-size:.72rem; font-family:ui-monospace,SFMono-Regular,Menlo,monospace; white-space:nowrap; }
+    .runtime-summary { display:flex; gap:.4rem; align-items:center; flex-wrap:wrap; margin-top:.55rem; }
+    .runtime-stat { padding:.18rem .45rem; border:1px solid var(--border); border-radius:999px; background:var(--surface2); color:var(--muted); font-size:.72rem; white-space:nowrap; }
+    .runtime-stat strong { color:var(--text); }
     h1 { margin:0; font-size:1.08rem; letter-spacing:-.02em; }
     .tagline,.subtle { color:var(--muted); font-size:.78rem; }
     .warning-banner { margin:.65rem 0 0; padding:.5rem .65rem; border:1px solid #e6bf62; border-radius:.4rem; background:#fff4d6; color:#6f4b00; font-size:.78rem; font-weight:700; }
@@ -86,7 +89,7 @@ export const dashboardHtml = `<!doctype html>
     .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; }
-    #usage-view,#rules-view { grid-column:1 / -1; }
+    #usage-view,#rules-view,#worker-rules-view { grid-column:1 / -1; }
     .rules-editor { display:grid; gap:.65rem; }
     .rules-help { margin:0; color:var(--muted); font-size:.8rem; }
     .rules-textarea { width:100%; min-height:55vh; resize:vertical; border:1px solid var(--border); border-radius:.45rem; background:var(--surface2); color:var(--text); padding:.8rem; font:13px/1.55 ui-monospace,SFMono-Regular,Menlo,monospace; }
@@ -113,11 +116,13 @@ export const dashboardHtml = `<!doctype html>
 <body>
 <header>
   <div class="brand"><h1>Agents Relay Console</h1><p class="tagline">Durable PR state is authoritative; events are observability.</p><span class="version">v${packageVersion}</span></div>
+  <div id="runtime-summary" class="runtime-summary" aria-label="Runtime summary"></div>
   <div id="rate-limit-warning" class="warning-banner" role="status" hidden></div>
   <nav role="tablist" aria-label="Console views">
     <button id="jobs-tab" type="button" role="tab" aria-selected="true" aria-controls="jobs-view">Jobs</button>
     <button id="usage-tab" type="button" role="tab" aria-selected="false" aria-controls="usage-view">Usage</button>
     <button id="rules-tab" type="button" role="tab" aria-selected="false" aria-controls="rules-view">Model Router Rules</button>
+    <button id="worker-rules-tab" type="button" role="tab" aria-selected="false" aria-controls="worker-rules-view">Worker Router Rules</button>
   </nav>
 </header>
 <main>
@@ -159,6 +164,18 @@ export const dashboardHtml = `<!doctype html>
       </div>
     </div>
   </section>
+  <section id="worker-rules-view" role="tabpanel" aria-labelledby="worker-rules-tab" hidden>
+    <div class="panel">
+      <div class="panel-head"><h2>Worker Router Rules</h2><span id="worker-rules-meta" class="subtle"></span></div>
+      <div class="panel-body">
+        <div class="rules-editor">
+          <p class="rules-help">Free-text guidance loaded by the worker decider when choosing ChatGPT versus Codex. Use this for local preferences; worker legality and Model Router remain separate.</p>
+          <textarea id="worker-rules-text" class="rules-textarea" spellcheck="true" aria-label="Worker router rules" placeholder="Example: Prefer ChatGPT unless the task requires native local execution or computer-use that ChatGPT plus MacBridge cannot perform."></textarea>
+          <div class="rules-footer"><span id="worker-rules-status" class="subtle" aria-live="polite"></span><button id="worker-rules-save" class="rules-save" type="button">Save rules</button></div>
+        </div>
+      </div>
+    </div>
+  </section>
 </main>
 <script>
 'use strict';
@@ -178,9 +195,11 @@ const MAX_EVENTS=60;
 const jobsTab=document.querySelector('#jobs-tab');
 const usageTab=document.querySelector('#usage-tab');
 const rulesTab=document.querySelector('#rules-tab');
+const workerRulesTab=document.querySelector('#worker-rules-tab');
 const jobsView=document.querySelector('#jobs-view');
 const usageView=document.querySelector('#usage-view');
 const rulesView=document.querySelector('#rules-view');
+const workerRulesView=document.querySelector('#worker-rules-view');
 const jobsWorkspace=document.querySelector('#jobs-workspace');
 const jobList=document.querySelector('#job-list');
 const jobsRefresh=document.querySelector('#jobs-refresh');
@@ -204,7 +223,12 @@ const rulesText=document.querySelector('#rules-text');
 const rulesMeta=document.querySelector('#rules-meta');
 const rulesStatus=document.querySelector('#rules-status');
 const rulesSave=document.querySelector('#rules-save');
+const workerRulesText=document.querySelector('#worker-rules-text');
+const workerRulesMeta=document.querySelector('#worker-rules-meta');
+const workerRulesStatus=document.querySelector('#worker-rules-status');
+const workerRulesSave=document.querySelector('#worker-rules-save');
 const rateLimitWarning=document.querySelector('#rate-limit-warning');
+const runtimeSummary=document.querySelector('#runtime-summary');
 let jobs=[];
 let selectedJob=sessionStorage.getItem('agents-relay:selected-job');
 let selectedTaskId=sessionStorage.getItem('agents-relay:selected-task');
@@ -283,8 +307,10 @@ function renderRateLimitStatus(status){
   rateLimitWarning.textContent='GitHub API rate limit reached. Showing cached job data.'+suffix;
   rateLimitWarning.hidden=false;
 }
+function runtimePill(label,value){const pill=element('span','runtime-stat');pill.append(document.createTextNode(label+' '),element('strong','',text(value)));return pill;}
+async function drawRuntimeSummary(){try{const summary=await loadJSON('/api/runtime-summary');runtimeSummary.replaceChildren(runtimePill('Active Jobs',summary.activeJobs||0),runtimePill('Running Tasks',summary.runningTasks||0),runtimePill('ChatGPT',summary.workers?.chatgpt||0),runtimePill('Codex',summary.workers?.codex||0));for(const item of Array.isArray(summary.models)?summary.models:[])runtimeSummary.append(runtimePill(item.model,item.count));}catch{runtimeSummary.replaceChildren();}}
 async function refreshStatus(){try{renderRateLimitStatus(await loadJSON('/api/status'));}catch{renderRateLimitStatus(null);}}
-async function refresh(force=false){jobsRefresh.disabled=true;jobsRefresh.textContent='Refreshing…';try{const discovered=await loadJSON('/api/jobs'+(force?'?refresh=1':''));jobs=Array.isArray(discovered)?discovered:[];jobs.sort(compareJobs);if(selectedJob&&!jobs.some(job=>job.id===selectedJob)){selectedJob=null;selectedTaskId=null;}if(!selectedJob){const match=location.hash.match(/^#\\/jobs\\/(.+)$/);const fromHash=match?decodeURIComponent(match[1]):null;selectedJob=jobs.some(job=>job.id===fromHash)?fromHash:(jobs[0]?.id||null);}rememberSelection();renderAll();void loadEventHistory();connection.textContent='';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';}}
+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&&!jobs.some(job=>job.id===selectedJob)){selectedJob=null;selectedTaskId=null;}if(!selectedJob){const match=location.hash.match(/^#\\/jobs\\/(.+)$/);const fromHash=match?decodeURIComponent(match[1]):null;selectedJob=jobs.some(job=>job.id===fromHash)?fromHash:(jobs[0]?.id||null);}rememberSelection();renderAll();void loadEventHistory();connection.textContent='';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){if(!event||selectedJob&&event.job_id&&event.job_id!==selectedJob||eventTaskId&&event.task_id!==eventTaskId)return;if(event.event_id&&displayedEventIds.has(event.event_id))return;if(event.event_id)displayedEventIds.add(event.event_id);const item=element('li','event-item');const meta=element('div','event-meta');meta.append(element('span','event-kind',text(eventLabel(event.type))),element('span','event-type',text(event.type||'event')),element('span','',text(relativeTime(event.timestamp))),element('span','',text('task: '+value(event.task_id))));item.append(meta);const message=element('p','event-message',text(event.message||'Event received'));if(level==='error'||event.level==='error')message.classList.add('error-text');item.append(message);eventFeed.querySelector('.empty')?.remove();eventFeed.prepend(item);while(eventFeed.children.length>MAX_EVENTS)eventFeed.lastElementChild?.remove();}
@@ -296,7 +322,9 @@ function creditProvider(provider){const row=element('section','usage-provider');
 async function drawUsage(){try{const overview=await loadJSON('/api/usage');usageRoot.replaceChildren();usageMeta.textContent='Real account telemetry when available';const providers=Array.isArray(overview.providers)?overview.providers:[];const credits=Array.isArray(overview.credits)?overview.credits:[];if(!providers.length&&!credits.length){usageRoot.append(element('p','empty',text('Usage telemetry is unavailable.')));return;}const grid=element('div','usage-providers');for(const provider of providers)grid.append(usageProvider(provider));for(const provider of credits)grid.append(creditProvider(provider));usageRoot.append(grid);}catch(error){usageMeta.textContent='Unavailable';usageRoot.replaceChildren(element('p','error-state',text('Usage unavailable: '+error.message)));}}
 async function drawRules(){rulesStatus.textContent='';try{const rules=await loadJSON('/api/model-router-rules');rulesText.value=typeof rules.text==='string'?rules.text:'';rulesMeta.textContent=rules.hash&&rules.hash!=='none'?'Loaded · '+rules.hash.slice(0,12):'No custom rules saved';}catch(error){rulesMeta.textContent='Unavailable';rulesStatus.textContent='Could not load rules: '+error.message;}}
 async function saveRules(){rulesSave.disabled=true;rulesStatus.textContent='Saving…';try{const response=await fetch('/api/model-router-rules',{method:'PUT',headers:{'content-type':'text/plain; charset=utf-8'},body:rulesText.value});if(!response.ok)throw new Error(response.status+' '+await response.text());const rules=await response.json();rulesMeta.textContent='Saved · '+rules.hash.slice(0,12);rulesStatus.textContent='Saved. New routing decisions will load these rules.';}catch(error){rulesStatus.textContent='Save failed: '+error.message;}finally{rulesSave.disabled=false;}}
-function showView(view){const isJobs=view==='jobs';const isUsage=view==='usage';const isRules=view==='rules';jobsView.hidden=!isJobs;jobsWorkspace.hidden=!isJobs;usageView.hidden=!isUsage;rulesView.hidden=!isRules;jobsTab.setAttribute('aria-selected',String(isJobs));usageTab.setAttribute('aria-selected',String(isUsage));rulesTab.setAttribute('aria-selected',String(isRules));if(isJobs)void refresh();else if(isUsage)void drawUsage();else void drawRules();}
+async function drawWorkerRules(){workerRulesStatus.textContent='';try{const rules=await loadJSON('/api/worker-router-rules');workerRulesText.value=typeof rules.text==='string'?rules.text:'';workerRulesMeta.textContent=rules.hash&&rules.hash!=='none'?'Loaded · '+rules.hash.slice(0,12):'No custom rules saved';}catch(error){workerRulesMeta.textContent='Unavailable';workerRulesStatus.textContent='Could not load rules: '+error.message;}}
+async function saveWorkerRules(){workerRulesSave.disabled=true;workerRulesStatus.textContent='Saving…';try{const response=await fetch('/api/worker-router-rules',{method:'PUT',headers:{'content-type':'text/plain; charset=utf-8'},body:workerRulesText.value});if(!response.ok)throw new Error(response.status+' '+await response.text());const rules=await response.json();workerRulesMeta.textContent='Saved · '+rules.hash.slice(0,12);workerRulesStatus.textContent='Saved. New worker decisions will load these rules.';}catch(error){workerRulesStatus.textContent='Save failed: '+error.message;}finally{workerRulesSave.disabled=false;}}
+function showView(view){const isJobs=view==='jobs';const isUsage=view==='usage';const isRules=view==='rules';const isWorkerRules=view==='worker-rules';jobsView.hidden=!isJobs;jobsWorkspace.hidden=!isJobs;usageView.hidden=!isUsage;rulesView.hidden=!isRules;workerRulesView.hidden=!isWorkerRules;jobsTab.setAttribute('aria-selected',String(isJobs));usageTab.setAttribute('aria-selected',String(isUsage));rulesTab.setAttribute('aria-selected',String(isRules));workerRulesTab.setAttribute('aria-selected',String(isWorkerRules));if(isJobs)void refresh();else if(isUsage)void drawUsage();else if(isRules)void drawRules();else void drawWorkerRules();}
 jobsTab.addEventListener('click',()=>{location.hash=selectedJob?'#/jobs/'+encodeURIComponent(selectedJob):'#/jobs';showView('jobs');});
 jobsRefresh.addEventListener('click',()=>void refresh(true));
 eventsAllTasks.addEventListener('click',()=>{eventTaskId=null;clearEvents();renderEventScope();void loadEventHistory();});
@@ -308,16 +336,18 @@ quickStatus.addEventListener('change',()=>setQuickMode(quickStatus.value?'status
 selectedJobRefresh.addEventListener('click',()=>void refreshSelected());
 usageTab.addEventListener('click',()=>{location.hash='#/usage';showView('usage');});
 rulesTab.addEventListener('click',()=>{location.hash='#/model-router-rules';showView('rules');});
+workerRulesTab.addEventListener('click',()=>{location.hash='#/worker-router-rules';showView('worker-rules');});
 rulesSave.addEventListener('click',()=>void saveRules());
-window.addEventListener('keydown',event=>{if(event.key==='Tab'&&event.altKey){event.preventDefault();const next=location.hash==='#/usage'?'rules':location.hash==='#/model-router-rules'?'jobs':'usage';location.hash=next==='usage'?'#/usage':next==='rules'?'#/model-router-rules':(selectedJob?'#/jobs/'+encodeURIComponent(selectedJob):'#/jobs');showView(next);}});
+workerRulesSave.addEventListener('click',()=>void saveWorkerRules());
+window.addEventListener('keydown',event=>{if(event.key==='Tab'&&event.altKey){event.preventDefault();const next=location.hash==='#/usage'?'rules':location.hash==='#/model-router-rules'?'worker-rules':location.hash==='#/worker-router-rules'?'jobs':'usage';location.hash=next==='usage'?'#/usage':next==='rules'?'#/model-router-rules':next==='worker-rules'?'#/worker-router-rules':(selectedJob?'#/jobs/'+encodeURIComponent(selectedJob):'#/jobs');showView(next);}});
 function parseMessage(message){try{return JSON.parse(message.data);}catch{return null;}}
 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=>job.id===payload.job.id);if(index>=0)jobs[index]=payload.job;else jobs.push(payload.job);renderAll();}};
-stream.addEventListener('relay',message=>{const payload=parseMessage(message);if(payload?.job){const index=jobs.findIndex(job=>job.id===payload.job.id);if(index>=0)jobs[index]=payload.job;else jobs.push(payload.job);}if(payload?.event)addEvent(payload.event);renderAll();});
-if(location.hash==='#/usage')showView('usage');else if(location.hash==='#/model-router-rules')showView('rules');else showView('jobs');
-setInterval(()=>{if(location.hash!=='#/usage'&&location.hash!=='#/model-router-rules')void refresh();},300000);
+stream.onmessage=message=>{const payload=parseMessage(message);if(payload?.job){const index=jobs.findIndex(job=>job.id===payload.job.id);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=>job.id===payload.job.id);if(index>=0)jobs[index]=payload.job;else jobs.push(payload.job);}if(payload?.event)addEvent(payload.event);renderAll();void drawRuntimeSummary();});
+if(location.hash==='#/usage')showView('usage');else if(location.hash==='#/model-router-rules')showView('rules');else if(location.hash==='#/worker-router-rules')showView('worker-rules');else showView('jobs');
+setInterval(()=>{if(location.hash!=='#/usage'&&location.hash!=='#/model-router-rules'&&location.hash!=='#/worker-router-rules')void refresh();},300000);
 setInterval(()=>{if(location.hash==='#/usage')void drawUsage();},30000);
 async function refreshSelected(){if(!selectedJob){await refresh();return;}selectedJobRefresh.disabled=true;selectedJobRefresh.textContent='Refreshing…';try{const updated=await loadJSON('/api/job?id='+encodeURIComponent(selectedJob));const index=jobs.findIndex(job=>job.id===selectedJob);if(index>=0)jobs[index]=updated;else jobs.push(updated);rememberSelection();renderAll();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';}finally{selectedJobRefresh.disabled=false;selectedJobRefresh.textContent='Refresh';}}
 </script>

package/dist/dashboard.js

@@ -5,7 +5,8 @@ import { join } from 'node:path';
 import { readUsageSnapshot } from './usage.js';
 import { deriveJobRuntimeStatus } from './runtime-status.js';
 import { DeliveryDeduper, parseGitHubWebhook, verifyGitHubWebhook } from './github-webhook.js';
-import { loadModelRouterRules, saveModelRouterRules } from './routing-policy.js';
+import { loadModelRouterRules, loadWorkerRouterRules, saveModelRouterRules, saveWorkerRouterRules } from './routing-policy.js';
+import { summarizeRuntime } from './runtime-summary.js';
 const GITHUB_REPOSITORY_PATTERN = /^([A-Za-z0-9](?:[A-Za-z0-9-]{0,36}[A-Za-z0-9])?)\/([A-Za-z0-9._-]{1,100})$/;
 const SSE_HEARTBEAT_MS = 15000;
 const EVENTS_HISTORY_FILE = process.env.EVENTS_BUS_DATA_DIR ? join(process.env.EVENTS_BUS_DATA_DIR, 'events.jsonl') : join(homedir(), 'Library', 'Application Support', 'EventsBus', 'events.jsonl');
@@ -309,6 +310,52 @@ export function serveDashboard(store, port = 8787, bus, refreshMs = 300000, jobI
             res.end('Method not allowed');
             return;
         }
+        if (req.url === '/api/worker-router-rules') {
+            if (req.method === 'GET') {
+                try {
+                    const rules = await loadWorkerRouterRules();
+                    res.writeHead(200, { 'content-type': 'application/json' });
+                    res.end(JSON.stringify(rules));
+                }
+                catch (error) {
+                    res.writeHead(500);
+                    res.end(error instanceof Error ? error.message : String(error));
+                }
+                return;
+            }
+            if (req.method === 'PUT') {
+                const chunks = [];
+                let size = 0;
+                for await (const chunk of req) {
+                    const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                    size += buffer.length;
+                    if (size > 64 * 1024) {
+                        res.writeHead(413);
+                        res.end('Worker router rules exceed 64 KiB');
+                        return;
+                    }
+                    chunks.push(buffer);
+                }
+                try {
+                    const rules = await saveWorkerRouterRules(Buffer.concat(chunks).toString('utf8'));
+                    res.writeHead(200, { 'content-type': 'application/json' });
+                    res.end(JSON.stringify(rules));
+                }
+                catch (error) {
+                    res.writeHead(500);
+                    res.end(error instanceof Error ? error.message : String(error));
+                }
+                return;
+            }
+            res.writeHead(405, { allow: 'GET, PUT' });
+            res.end('Method not allowed');
+            return;
+        }
+        if (req.url === '/api/runtime-summary') {
+            res.writeHead(200, { 'content-type': 'application/json' });
+            res.end(JSON.stringify(summarizeRuntime(lastKnownJobs ?? [])));
+            return;
+        }
         if (req.url === '/api/status') {
             const status = statusProvider ? statusProvider() : { limited: false, cooldownUntil: null };
             res.writeHead(200, { 'content-type': 'application/json' });

package/dist/reconciler-review.js

@@ -109,9 +109,22 @@ export class ReconcilerReviewBase extends ReconcilerRuntimeBase {
         const registered = await this.store.listAgents();
         const candidates = workerCandidates(this.options.adapters, registered, usage);
         for (const task of job.tasks.filter(item => item.kind !== 'planner' && item.agentName !== 'reviewer' && item.adapter !== 'orchestrator' && ['QUEUED', 'BLOCKED'].includes(item.state) && item.output && !item.workerSelection && (item.workerRequirements || item.planningSource === 'model-planner'))) {
-            const requirements = task.workerRequirements ?? { capabilities: task.capabilities.length > 0 ? task.capabilities : ['model'] };
-            const taskFacts = { id: task.id, kind: task.kind ?? 'work', storySize: task.storySize ?? 'M', capabilities: task.capabilities };
-            const routedWorker = await routeWorker(candidates, requirements, { decisionEngine: this.options.decisionEngine, decisionMode: this.options.decisionMode, taskFacts });
+            const requirements = task.workerRequirements ?? { capabilities: [] };
+            const taskFacts = {
+                id: task.id,
+                kind: task.kind ?? 'work',
+                storySize: task.storySize ?? 'M',
+                agentName: task.agentName ?? null,
+                input: task.input,
+                attachments: task.attachments ?? [],
+                output: task.output ?? null,
+            };
+            const routedWorker = await routeWorker(candidates, requirements, {
+                decisionEngine: this.options.decisionEngine,
+                decisionMode: this.options.decisionMode,
+                taskFacts,
+                usage,
+            });
             const models = await discoverModelCandidates(routedWorker.candidate, registered, usage);
             const routingConstraints = task.routing ? { provider: task.routing.provider, model: task.routing.model, profile: task.routing.profile, reasoning: task.routing.reasoning } : undefined;
             const routedModel = await routeModel(routedWorker.candidate, models, { decisionEngine: this.options.decisionEngine, decisionMode: this.options.decisionMode, taskFacts, constraints: routingConstraints, auditStore: this.options.decisionAuditStore, auditTask: task });

package/dist/reviewer-routing.js

@@ -1,21 +1,7 @@
 function satisfies(candidate, requirements) {
-    if (candidate.availability && candidate.availability !== 'available')
+    if (candidate.availability === 'offline')
         return false;
-    if (candidate.resourceHealthy === false)
-        return false;
-    if (!requirements)
-        return true;
-    if (!requirements.capabilities.every(capability => candidate.capabilities.includes(capability)))
-        return false;
-    if (requirements.runtime && candidate.runtime !== requirements.runtime)
-        return false;
-    if (requirements.taskKind && candidate.taskKind !== requirements.taskKind)
-        return false;
-    if (requirements.trustDomain && !candidate.trustDomains?.includes(requirements.trustDomain))
-        return false;
-    if (requirements.region && candidate.region !== requirements.region)
-        return false;
-    if (requirements.labels && Object.entries(requirements.labels).some(([key, value]) => candidate.labels?.[key] !== value))
+    if (requirements?.runtime && candidate.runtime !== requirements.runtime)
         return false;
     return true;
 }
@@ -29,7 +15,7 @@ function producedRoutes(tasks) {
         .filter(task => task.agentName !== 'reviewer' && task.routing)
         .map(task => `${task.routing?.provider}\0${task.routing?.model}`));
 }
-/** Select a review worker only after hard gates, then prefer execution diversity. */
+/** Select a reviewer after authoritative worker constraints, then prefer execution diversity. */
 export function selectReviewer(candidates, implementationTasks, requirements) {
     const eligible = candidates.filter(candidate => satisfies(candidate, requirements));
     if (eligible.length === 0)

package/dist/routing-policy.js

@@ -30,11 +30,7 @@ function safePolicy(value) {
 export function policyPath(explicit) {
     return explicit ?? process.env.AGENTS_RELAY_ROUTING_POLICY ?? join(process.cwd(), '.agents-relay-routing-policy.json');
 }
-export function modelRouterRulesPath(explicit) {
-    return explicit ?? process.env.AGENTS_RELAY_MODEL_ROUTER_RULES ?? join(process.cwd(), '.agents-relay-model-router-rules.md');
-}
-export async function loadModelRouterRules(explicit) {
-    const path = modelRouterRulesPath(explicit);
+async function loadRouterRules(path) {
     try {
         const text = await readFile(path, 'utf8');
         return { path, hash: createHash('sha256').update(text).digest('hex'), text };
@@ -43,12 +39,29 @@ export async function loadModelRouterRules(explicit) {
         return { path, hash: 'none', text: '' };
     }
 }
-export async function saveModelRouterRules(text, explicit) {
-    const path = modelRouterRulesPath(explicit);
+async function saveRouterRules(path, text) {
     await mkdir(dirname(path), { recursive: true });
     await writeFile(path, text, 'utf8');
     return { path, hash: createHash('sha256').update(text).digest('hex'), text };
 }
+export function modelRouterRulesPath(explicit) {
+    return explicit ?? process.env.AGENTS_RELAY_MODEL_ROUTER_RULES ?? join(process.cwd(), '.agents-relay-model-router-rules.md');
+}
+export function workerRouterRulesPath(explicit) {
+    return explicit ?? process.env.AGENTS_RELAY_WORKER_ROUTER_RULES ?? join(process.cwd(), '.agents-relay-worker-router-rules.md');
+}
+export async function loadModelRouterRules(explicit) {
+    return await loadRouterRules(modelRouterRulesPath(explicit));
+}
+export async function saveModelRouterRules(text, explicit) {
+    return await saveRouterRules(modelRouterRulesPath(explicit), text);
+}
+export async function loadWorkerRouterRules(explicit) {
+    return await loadRouterRules(workerRouterRulesPath(explicit));
+}
+export async function saveWorkerRouterRules(text, explicit) {
+    return await saveRouterRules(workerRouterRulesPath(explicit), text);
+}
 export async function loadRoutingPolicy(explicit, explicitRules) {
     const path = policyPath(explicit);
     const rules = await loadModelRouterRules(explicitRules);

package/dist/runtime-summary.js

@@ -0,0 +1,38 @@
+function runningWorker(task) {
+    if (task.state !== 'RUNNING')
+        return null;
+    const adapter = task.workerSelection?.adapter ?? task.adapter;
+    return adapter === 'chatgpt' || adapter === 'codex' ? adapter : null;
+}
+export function summarizeRuntime(jobs) {
+    let activeJobs = 0;
+    let runningTasks = 0;
+    let chatgpt = 0;
+    let codex = 0;
+    const models = new Map();
+    for (const job of jobs) {
+        if (job.state === 'ACTIVE')
+            activeJobs += 1;
+        for (const task of job.tasks) {
+            if (task.state !== 'RUNNING')
+                continue;
+            runningTasks += 1;
+            const worker = runningWorker(task);
+            if (worker === 'chatgpt')
+                chatgpt += 1;
+            if (worker === 'codex')
+                codex += 1;
+            const model = task.routing?.model;
+            if (model)
+                models.set(model, (models.get(model) ?? 0) + 1);
+        }
+    }
+    return {
+        activeJobs,
+        runningTasks,
+        workers: { chatgpt, codex },
+        models: [...models.entries()]
+            .map(([model, count]) => ({ model, count }))
+            .sort((left, right) => right.count - left.count || left.model.localeCompare(right.model)),
+    };
+}

package/dist/worker-routing.js

@@ -1,4 +1,12 @@
 import { chooseWithDecision } from './decision.js';
+import { loadWorkerRouterRules } from './routing-policy.js';
+export const DEFAULT_WORKER_ROUTER_PRINCIPLES = [
+    'Worker Router chooses only the execution worker. Model Router chooses provider/model/profile after worker selection.',
+    'Prefer ChatGPT when both workers can execute the task because it does not consume Codex coding-plan tokens and normally has access to a stronger ChatGPT Sol model.',
+    'Prefer Codex when the task requires native/local execution or computer-use abilities that are unavailable through ChatGPT plus MacBridge.',
+    'Treat coding-plan/provider quota as decision context, not worker legality. Codex may still use another provider selected later by Model Router.',
+    'When Codex/OpenAI coding quota is scarce, prefer ChatGPT unless the Codex execution environment is necessary.',
+].join('\n');
 export function usageForProvider(snapshot, provider, now = Date.now()) {
     const usage = snapshot?.providers.find(item => item.id === provider)?.usage;
     if (usage?.available) {
@@ -39,15 +47,12 @@ export function workerCandidates(adapters, registered, snapshot) {
     return adapters.filter(adapter => adapter.name !== 'orchestrator').flatMap(adapter => {
         const workers = registered.filter(worker => worker.runtime.adapter === adapter.name);
         return (workers.length > 0 ? workers : [undefined]).map(worker => {
-            const provider = worker?.runtime.provider ?? (adapter.name === 'chatgpt' ? 'chatgpt' : 'openai');
-            const resource = usageForProvider(snapshot, provider);
+            const provider = worker?.runtime.provider ?? (adapter.name === 'chatgpt' ? 'chatgpt' : undefined);
+            const resource = provider ? usageForProvider(snapshot, provider) : {};
             return {
                 workerId: worker?.id ?? adapter.id,
                 adapter: adapter.name,
-                capabilities: worker?.capabilities ?? [
-                    ...adapter.capabilities,
-                    ...(adapter.name === 'codex' ? ['local_repo', 'iterative_tools', 'long_running'] : ['web_session', 'attachments', 'interactive_ui', 'one_shot']),
-                ],
+                capabilities: worker?.capabilities ?? [...adapter.capabilities],
                 runtime: worker?.runtime.adapter ?? adapter.name,
                 trustDomains: worker?.routing.trustDomains,
                 region: worker?.routing.regions?.[0],
@@ -64,23 +69,16 @@ export function workerCandidates(adapters, registered, snapshot) {
         });
     });
 }
+/**
+ * Worker legality is intentionally narrow. Descriptive capability labels and provider
+ * quota are facts for decide(), not hard gates. An explicit runtime is retained as a
+ * compatibility/caller-owned constraint, and an explicitly offline worker is illegal.
+ */
 export function satisfiesWorker(candidate, requirements) {
-    if (candidate.availability && candidate.availability !== 'available')
-        return false;
-    if (candidate.resourceHealthy === false)
-        return false;
-    if (!requirements.capabilities.every(capability => candidate.capabilities.includes(capability)))
+    if (candidate.availability === 'offline')
         return false;
     if (requirements.runtime && candidate.runtime !== requirements.runtime)
         return false;
-    if (requirements.taskKind && candidate.taskKind !== requirements.taskKind)
-        return false;
-    if (requirements.trustDomain && !candidate.trustDomains?.includes(requirements.trustDomain))
-        return false;
-    if (requirements.region && candidate.region !== requirements.region)
-        return false;
-    if (requirements.labels && Object.entries(requirements.labels).some(([key, value]) => candidate.labels?.[key] !== value))
-        return false;
     return true;
 }
 export function eligibleWorkerCandidates(candidates, requirements) {
@@ -88,8 +86,8 @@ export function eligibleWorkerCandidates(candidates, requirements) {
 }
 function deterministicWorker(eligible) {
     return [...eligible].map((candidate, index) => ({ candidate, index })).sort((left, right) => {
-        const pressure = (item) => item.resourceUsedPercent === undefined ? 1 : item.resourceUsedPercent >= 90 ? 2 : 0;
-        return pressure(left.candidate) - pressure(right.candidate) || left.index - right.index;
+        const preference = (item) => item.adapter === 'chatgpt' ? 0 : 1;
+        return preference(left.candidate) - preference(right.candidate) || left.index - right.index;
     })[0].candidate;
 }
 function selection(selected, selectedBy, decisionEvidence) {
@@ -113,30 +111,35 @@ function selection(selected, selectedBy, decisionEvidence) {
 export function selectWorker(candidates, requirements) {
     const eligible = eligibleWorkerCandidates(candidates, requirements);
     if (eligible.length === 0)
-        throw new Error('No eligible worker satisfies the declared requirements');
+        throw new Error('No eligible worker satisfies the authoritative worker constraints');
     const selected = deterministicWorker(eligible);
-    return { candidate: selected, selection: selection(selected, 'worker-router:requirements') };
+    return { candidate: selected, selection: selection(selected, 'worker-router:fallback') };
 }
-/** Gathered facts and hard gates stay in code; Laya only judges among legal choices. */
+/** Gather factual worker/task/resource context, then let decide() choose among legal workers. */
 export async function routeWorker(candidates, requirements, options = {}) {
     const eligible = eligibleWorkerCandidates(candidates, requirements);
     if (eligible.length === 0)
-        throw new Error('No eligible worker satisfies the declared requirements');
+        throw new Error('No eligible worker satisfies the authoritative worker constraints');
     const deterministic = deterministicWorker(eligible);
     if (eligible.length === 1) {
         const evidence = { mode: options.decisionMode ?? 'off', fallback: true };
-        return { candidate: deterministic, selection: selection(deterministic, 'worker-router:requirements', evidence) };
+        return { candidate: deterministic, selection: selection(deterministic, 'worker-router:constraint', evidence) };
     }
+    const rules = await loadWorkerRouterRules(options.rulesPath);
     const facts = JSON.parse(JSON.stringify({
         task: options.taskFacts ?? {},
-        requirements,
+        explicit_constraints: { runtime: requirements.runtime ?? null },
+        routing_principles: DEFAULT_WORKER_ROUTER_PRINCIPLES,
+        environment_rules: rules.text,
+        usage_snapshot: options.usage ?? null,
         candidates: eligible.map(item => ({
             id: item.workerId,
             adapter: item.adapter,
-            capabilities: [...item.capabilities],
             runtime: item.runtime ?? null,
-            resourceHealthy: item.resourceHealthy ?? null,
+            availability: item.availability ?? null,
+            declaredCapabilities: [...item.capabilities],
             resourceProvider: item.resourceProvider ?? null,
+            resourceHealthy: item.resourceHealthy ?? null,
             resourceUsedPercent: item.resourceUsedPercent ?? null,
             resourceRemainingPercent: item.resourceRemainingPercent ?? null,
             resourceResetAt: item.resourceResetAt ?? null,
@@ -144,8 +147,12 @@ export async function routeWorker(candidates, requirements, options = {}) {
             resourceWindows: item.resourceWindows ?? null,
         })),
     }));
-    const choice = await chooseWithDecision(options.decisionEngine, options.decisionMode ?? 'off', { facts }, { type: 'choice', question: 'Which eligible worker is best suited to execute this task?', choices: eligible.map(item => item.workerId) }, () => deterministic.workerId);
+    const choice = await chooseWithDecision(options.decisionEngine, options.decisionMode ?? 'off', { facts }, {
+        type: 'choice',
+        question: 'Choose the best execution worker for this task. Use the task description, current usage, routing principles, and environment rules. Prefer ChatGPT when both can do the work; choose Codex when native/local execution is necessary. Do not choose a provider or model here.',
+        choices: eligible.map(item => item.workerId),
+    }, () => deterministic.workerId);
     const selected = eligible.find(item => item.workerId === choice.choice) ?? deterministic;
-    const selectedBy = choice.evidence.engine && !choice.evidence.fallback ? 'worker-router:laya' : 'worker-router:requirements';
+    const selectedBy = choice.evidence.engine && !choice.evidence.fallback ? 'worker-router:laya' : 'worker-router:fallback';
     return { candidate: selected, selection: selection(selected, selectedBy, choice.evidence) };
 }

package/package.json

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

package/skills/agents-relay/agents/planner.agent.md

@@ -68,8 +68,8 @@ Do not create separate Tasks merely for "analyze", "format", "call tool", "check
 - Prefer independently verifiable Tasks with stable IDs, but do not split work solely to make Tasks smaller.
 - A Task describes what an agent must accomplish; never emit a shell command as a worker Task.
 - Use dependencies only when execution order actually matters.
-- Every child Task must declare `workerRequirements`; worker-router selects the worker and model-router selects provider/model/reasoning afterward.
-- Do not choose `codex`/`chatgpt`, provider/model, or usage probes.
+- Describe each child Task precisely enough for worker-router to decide from the Task itself. Do not invent Codex/ChatGPT capability labels. workerRequirements is optional and should normally be omitted; use an explicit runtime only when the objective already requires that runtime.
+- Do not choose codex/chatgpt, provider/model, or usage probes.
 - Every child Task must declare exactly one output: `task_pr` or `file`.
 - Every child Task must include `storySize` (`S`, `M`, or `L`); use `M` when uncertain.
 - Do not create bookkeeping, waiting, status-checking, wrapper, or planning Tasks. Your response itself is the planning round.
@@ -86,4 +86,4 @@ For `objective_status: "in_progress"`, `assessment` must be Markdown containing:
 
 For `objective_status: "satisfied"`, `assessment` may be a concise evidence-based completion assessment without a graph.
 
-Each item in `next_tasks` contains `id`, `input`, `workerRequirements`, `output`, and `storySize`. It may also contain priority, projectName, agentName, dependencies, capabilities, maxAttempts, and timeoutMs. Adapter/routing fields are selected by Relay after planning; do not invent them.
+Each item in next_tasks contains id, input, output, and storySize. It may also contain priority, projectName, agentName, dependencies, capabilities, workerRequirements, maxAttempts, and timeoutMs. Adapter/routing fields are selected by Relay after planning; do not invent them.

package/skills/agents-relay/contracts/task-job-contract.md

@@ -54,13 +54,14 @@ Keep these concepts distinct: observation is not root cause; hypothesis is not r
 
 Every new model-backed executable task follows this order:
 
-1. The planner declares `workerRequirements` (capabilities and optional runtime, task-kind, trust-domain, region, and label constraints).
-2. `worker-router` is code-driven: it gathers authoritative worker/resource facts, applies capability/availability and other hard gates, then may call the generic typed `decide(request, contract)` primitive only among eligible workers.
-3. `model-router` runs after worker selection, discovers model/profile facts usable by that worker, applies model hard gates, then may use the same typed `decide()` primitive among eligible profiles. Router judgment is not a free-form agent invocation.
-4. `decide()` owns no routing facts or legality policy. Its optional Laya implementation is a transient CLI subprocess per decision; unavailable/invalid decisions fall back to deterministic routing. `src/usage.ts` remains the shared resource-fact source.
-5. Relay persists the selected worker and model routing on the durable task before launch.
+1. The planner describes the executable Task precisely. It does not invent a capability matrix for Codex versus ChatGPT. workerRequirements is optional compatibility metadata; an explicit runtime may be used only when the caller already knows the Task must use that runtime.
+2. worker-router gathers factual Task context, discovered worker availability, the current shared usage snapshot, built-in routing principles, and optional local free-text rules. Only authoritative legality facts such as an explicitly offline worker or an explicit caller-owned runtime constraint are hard gates. Descriptive capability labels, region/trust labels, and provider quota are decision facts rather than ordinary worker hard gates.
+3. When more than one legal model-backed worker exists, worker-router calls the generic typed decide(request, contract) primitive to choose the execution worker. Its default principles prefer ChatGPT when both workers can execute the Task, prefer Codex when native/local execution is necessary, and treat Codex/OpenAI quota pressure as a preference rather than proof that the Codex worker is unusable.
+4. model-router runs only after worker selection and independently chooses provider/model/profile for that worker. In particular, an exhausted OpenAI quota must not eliminate the Codex worker before Model Router has a chance to choose another Codex provider/profile.
+5. decide() owns no routing facts or legality policy. Its optional Laya implementation is a transient CLI subprocess per decision; unavailable/invalid decisions fall back deterministically. src/usage.ts remains the shared resource-fact source.
+6. Relay persists the selected worker and model routing on the durable task before launch.
 
-Planner output must not hard-code `codex`/`chatgpt`, provider preference, or usage probes. The worker-router and model-router are separate responsibilities; usage readers remain owned by `src/usage.ts` and are not duplicated in either router. Legacy task records that already contain adapter/routing metadata remain readable, but newly produced planner tasks must carry worker requirements.
+Planner output must not hard-code codex/chatgpt, provider preference, inferred worker capabilities, or usage probes. Worker Router and Model Router are separate responsibilities. Legacy task records that already contain adapter/routing/worker-requirement metadata remain readable.
 
 ## Story size
 
@@ -131,7 +132,7 @@ Job runtime status is derived, not persisted. Relay computes it from lifecycle p
 
 A normal task never merges a PR. After all non-superseded work gates pass, Relay creates a SHA-bound final review task. The reviewer emits exactly one of `review.approved`, `review.changes_required`, or `review.blocked`. When `autoMerge` is enabled (default), Relay merges only after `review.approved`, pinned to the exact reviewed head SHA. A new task or new PR head makes earlier final-review evidence stale and requires a fresh review.
 
-Final-review routing follows the same worker-selection boundary as executable work. Capability, availability, explicit reviewer constraints, and resource health are hard gates. Among eligible workers, Relay prefers a reviewer with a different worker identity from the implementation tasks; when that is unavailable it prefers a different provider/model, then falls back to the first eligible worker. The selected worker, `selectedBy` reason, and `reviewerRouting` event data are durable evidence. No provider is a universal reviewer default.
+Final-review routing follows the same factual worker-selection boundary as executable work. Explicitly offline workers and explicit reviewer runtime constraints are hard gates; provider quota and descriptive capability labels do not by themselves make a worker illegal. Among eligible workers, Relay prefers a reviewer with a different worker identity from the implementation tasks; when that is unavailable it prefers a different provider/model, then falls back to the first eligible worker. The selected worker, selectedBy reason, and reviewerRouting event data are durable evidence. No provider is a universal reviewer default.
 
 ## Job, Task, and planner ownership