agents-relay 2.0.14 → 2.0.15

package/dist/cli-blocker.js

@@ -19,7 +19,7 @@ export async function runBlockerCommand(action, args) {
     }
     if (action === 'resolve') {
         const summary = await blockerStore.resolveBlockerDependents(id, 'verified');
-        await publishDependentUnblocked(eventBus(args), summary.unblocked, `Blocker Job ${id} resolved (verified)`);
+        await publishDependentUnblocked(await eventBus(args), summary.unblocked, `Blocker Job ${id} resolved (verified)`);
         console.log(JSON.stringify({ blocker: id, resolution: 'verified', ...summary }, null, 2));
         return;
     }

package/dist/cli-help.js

@@ -179,7 +179,7 @@ Example:
 
 Required: --file PATH for local demo mode, or --repo OWNER/REPO --pr NUMBER --id JOB_ID.
 
-Managed GitHub jobs are reconciled by agents-relayd. The CLI publishes a job.wake request and does not launch workers; use --events nats.
+Managed GitHub jobs are reconciled by agents-relayd. The CLI publishes a job.wake request and does not launch workers; NATS is auto-detected when reachable; use --events nats to require it explicitly.
 
 Example:
   npx agents-relay reconcile --repo OWNER/REPO --pr 12 --id job-1`,
@@ -192,7 +192,7 @@ Example:
     serve: `Run the dashboard and reconciliation service for a managed job.
 
 Required: --file PATH for local demo mode, or --repo OWNER/REPO --pr NUMBER --id JOB_ID.
-Common: --port PORT, --interval MS, --events nats.
+Common: --port PORT, --interval MS, --events nats (optional; reachable NATS is auto-detected).
 
 Example:
   npx agents-relay serve --repo OWNER/REPO --pr 12 --id job-1`,

package/dist/cli-support.js

@@ -98,8 +98,32 @@ export async function relayTaskCommand(args, body) {
         throw new Error(`Agents Relay task command failed: ${await response.text() || `HTTP ${response.status}`}`);
     return await response.json();
 }
-export function eventBus(args) { if (arg(args, '--events') !== 'nats')
-    return undefined; return new NatsEventBus(arg(args, '--nats-url', 'nats://127.0.0.1:4222'), arg(args, '--subject-prefix', 'neo.events.job')); }
+export async function resolveEventBus(args, probe) {
+    const explicit = hasArg(args, '--events');
+    const requested = arg(args, '--events');
+    const natsUrl = arg(args, '--nats-url', process.env.NEO_NATS_URL || 'nats://127.0.0.1:4222');
+    if (explicit && requested !== 'nats')
+        return { bus: undefined, transport: 'none', source: 'explicit', natsUrl };
+    const bus = new NatsEventBus(natsUrl, arg(args, '--subject-prefix', 'neo.events.job'));
+    if (explicit)
+        return { bus, transport: 'nats', source: 'explicit', natsUrl };
+    const reachable = probe ? await probe(bus) : await bus.ping().then(() => true, () => false);
+    if (!reachable) {
+        await bus.close().catch(() => undefined);
+        return { bus: undefined, transport: 'none', source: 'unavailable', natsUrl };
+    }
+    return { bus, transport: 'nats', source: 'auto', natsUrl };
+}
+export function eventBusResolutionMessage(resolution) {
+    if (resolution.transport === 'nats')
+        return `event transport: nats (${resolution.source === 'auto' ? 'auto-detected' : 'explicit'})`;
+    return resolution.source === 'explicit' ? 'event transport: none (explicit)' : 'event transport: none (NATS unavailable)';
+}
+export async function eventBus(args) {
+    const resolution = await resolveEventBus(args);
+    process.stderr.write(`${eventBusResolutionMessage(resolution)}\n`);
+    return resolution.bus;
+}
 export async function publishWake(bus, job, taskId, message) { if (!bus)
     return; try {
     await bus.publish(eventFor(job.id, taskId, null, 'job.wake', 'queued', message, 'orchestrator', { repository: job.repository, prNumber: job.prNumber }));
@@ -125,7 +149,7 @@ export async function publishDependentUnblocked(bus, targets, reason) { if (!bus
 } }
 export async function requestManagedReconciliation(bus, job) {
     if (!bus)
-        throw new Error('Managed GitHub reconciliation requires --events nats so agents-relayd can execute the job');
+        throw new Error('Managed GitHub reconciliation requires a reachable NATS event bus (auto-detected when available, or explicit with --events nats)');
     try {
         await bus.publish(eventFor(job.id, 'reconcile', null, 'job.wake', 'queued', `Reconcile requested for ${job.id}`, 'orchestrator', { repository: job.repository, prNumber: job.prNumber }));
     }

package/dist/cli-unblock.js

@@ -7,7 +7,7 @@ export async function runTaskUnblockCommand(args, store, job, task, localFile) {
     const result = await unblockTask({ store, job, task, trigger: { source: 'cli', reason } });
     const refreshed = await store.load(job.id);
     await saveLocal(localFile, refreshed);
-    const bus = eventBus(args);
+    const bus = await eventBus(args);
     await publishTaskUnblocked(bus, refreshed, task.id, reason);
     await publishWake(bus, refreshed, task.id, `Task ${task.id} unblocked${result.replanning ? ' for replanning' : ''}`);
     console.log(JSON.stringify({ taskId: task.id, ...result, task: refreshed.tasks.find(item => item.id === task.id) }, null, 2));
@@ -22,7 +22,7 @@ export async function runJobUnblockCommand(args, store, job) {
     if (job.executionMode === 'autonomous') {
         const planTrigger = await unblockAutonomousTasks({ store, job, tasks: blocked, trigger: { source: 'cli', reason } });
         const refreshed = await store.load(job.id);
-        const bus = eventBus(args);
+        const bus = await eventBus(args);
         for (const task of blocked)
             await publishTaskUnblocked(bus, refreshed, task.id, reason);
         await publishWake(bus, refreshed, 'job', `Job ${job.id} unblocked for replanning`);
@@ -32,7 +32,7 @@ export async function runJobUnblockCommand(args, store, job) {
     for (const task of blocked)
         await unblockTask({ store, job, task, trigger: { source: 'cli', reason } });
     const refreshed = await store.load(job.id);
-    const bus = eventBus(args);
+    const bus = await eventBus(args);
     for (const task of blocked)
         await publishTaskUnblocked(bus, refreshed, task.id, reason);
     await publishWake(bus, refreshed, 'job', `Job ${job.id} unblocked`);

package/dist/cli.js

@@ -184,7 +184,7 @@ async function runTaskCommand(action, args) {
         }
         const durableTask = (await store.load(job.id)).tasks.find(item => item.id === task.id) ?? task;
         await saveLocal(localFile, await store.load(job.id));
-        await publishWake(eventBus(args), refreshed, task.id, `Task ${task.id} created`);
+        await publishWake(await eventBus(args), refreshed, task.id, `Task ${task.id} created`);
         console.log(JSON.stringify(durableTask, null, 2));
         return;
     }
@@ -227,7 +227,7 @@ async function runTaskCommand(action, args) {
             outputTask = outputJob.tasks.find(item => item.id === id) ?? result.task;
         }
         await saveLocal(localFile, outputJob);
-        await publishWake(eventBus(args), outputJob, outputTask.id, `${outputTask.id} ${action} requested`);
+        await publishWake(await eventBus(args), outputJob, outputTask.id, `${outputTask.id} ${action} requested`);
         console.log(JSON.stringify(outputTask, null, 2));
         return;
     }
@@ -395,7 +395,7 @@ async function runJobCommand(action, args) {
         await transitionJobEvent(job, 'pr.merged');
         await store.saveJob(job);
         const resolved = await store.resolveBlockerDependents(id, 'merge');
-        await publishDependentUnblocked(eventBus(args), resolved.unblocked, `Blocker Job ${id} resolved (merge)`);
+        await publishDependentUnblocked(await eventBus(args), resolved.unblocked, `Blocker Job ${id} resolved (merge)`);
         console.log(JSON.stringify(await store.load(id), null, 2));
         return;
     }
@@ -465,7 +465,7 @@ export function dashboardJobAction(store, reconciler, action) {
 }
 export async function createService(args) {
     const loaded = await storeFor(args);
-    const upstream = eventBus(args);
+    const upstream = await eventBus(args);
     const bus = upstream ? new ServiceEventBus(upstream) : undefined;
     const requestedUsageDays = Number(arg(args, '--usage-window-days', '1'));
     const usageWindowDays = Number.isInteger(requestedUsageDays) && requestedUsageDays > 0 ? requestedUsageDays : 1;
@@ -590,7 +590,7 @@ async function main() {
         console.log(`Initialized ${job.id}`);
         return;
     }
-    const bus = eventBus(args);
+    const bus = await eventBus(args);
     if (command === 'status') {
         const host = arg(args, '--host', '127.0.0.1');
         const port = Number(arg(args, '--port', String(SERVICE_DEFAULTS.port)));

package/dist/dashboard-html.js

@@ -392,7 +392,8 @@ function chatShortcutText(){return localStorage.getItem(CHAT_SHORTCUTS_KEY)||DEF
 function parseChatShortcuts(source){return String(source||'').split(/\\r?\\n/).map(line=>line.trim()).filter(Boolean).map(line=>{const split=line.indexOf(':');return split>0?{name:line.slice(0,split).trim(),prompt:line.slice(split+1).trim()}:null;}).filter(item=>item&&item.name&&item.prompt);}
 function jobChatRef(job){return repoName(job?.repository)+'/pr#'+value(job?.prNumber);}
 function chatShortcutUrl(prompt){return 'https://chatgpt.com/?prompt='+encodeURIComponent(prompt);}
-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),'_blank','noopener');select.value='';});box.append(select);return box;}
+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(job.id===selectedJob));row.addEventListener('click',()=>selectJob(job.id));const content=element('div','job-content');const select=document.createElement('button');select.type='button';select.className='job-button';select.setAttribute('aria-current',String(job.id===selectedJob));select.title=job.title||job.id;select.addEventListener('click',event=>{event.stopPropagation();selectJob(job.id);});select.append(element('span','job-title',text(repoName(job.repository)+'/PR#'+value(job.prNumber)+': '+value(job.title||job.id))));const states=element('span','job-status-line');states.append(element('span','badge '+value(job.state),text(value(job.state))),element('span','badge '+value(job.runtimeStatus||'IDLE'),text(value(job.runtimeStatus||'IDLE'))));if(job.executionMode==='autonomous')states.append(element('span','badge flag-autonomous',text('AUTONOMOUS')));if(job.reviewEnabled!==false&&job.githubState!=='MERGED')states.append(element('span','badge flag-review',text('REVIEW REQUIRED')));if(job.githubState==='MERGED'&&job.publication?.version)states.append(element('span','badge SUCCEEDED',text('v'+job.publication.version)));if(isCompleteUnmerged(job))states.append(element('span','badge MERGE_PENDING',text('MERGE PENDING')));const primary=element('div','job-primary');primary.append(states);const lastLine=element('div','job-last-line');lastLine.append(element('span','subtle',text(compactCounts(counts(job.tasks)))),element('span','subtle',text(relativeTime(job.updatedAt))));content.append(select,primary,lastLine);row.append(content);jobList.append(element('li','',row));}}
 function 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));}

package/dist/events.js

@@ -20,7 +20,8 @@ export class NatsEventBus {
             throw new Error(`Unsafe event subject prefix: ${subjectPrefix}`);
     }
     async moduleLoaded() { this.module ??= await import('nats'); return this.module; }
-    async client() { const nats = await this.moduleLoaded(); this.connection ??= await nats.connect({ servers: this.url }); return this.connection; }
+    async client() { const nats = await this.moduleLoaded(); this.connection ??= await nats.connect({ servers: this.url, timeout: 1000 }); return this.connection; }
+    async ping() { await (await this.client()).flush(); }
     async publish(event) { const nats = await this.moduleLoaded(); const subject = `${this.subjectPrefix}.${subjectToken(event.job_id)}.${event.type}`; (await this.client()).publish(subject, nats.StringCodec().encode(JSON.stringify(event))); }
     async subscribe(jobId, wake) { return this.subscribeSubject(`${this.subjectPrefix}.${subjectToken(jobId)}.>`, wake); }
     async subscribeAll(wake) { return this.subscribeSubject(`${this.subjectPrefix}.>`, wake); }

package/dist/relayd.js

@@ -6,7 +6,6 @@ import { join } from 'node:path';
 import { ChatGptAdapter, CodexAdapter } from './adapters.js';
 import { CodexThreadContinuation, CommandContinuation, WebhookContinuation } from './continuation.js';
 import { serveDashboard } from './dashboard.js';
-import { NatsEventBus } from './events.js';
 import { RepositoryWorkerPool, aggregateManagedGitHubJobs } from './pool.js';
 import { Reconciler } from './reconciler.js';
 import { dashboardManagedJobs, GitHubStore, InMemoryStore, loadManagedGitHubPullRequestSnapshotGraphql, withGitHubRequestContext } from './store.js';
@@ -14,6 +13,7 @@ import { ProjectedDurableStore } from './projected-store.js';
 import { discoverLocalRelayStoreSnapshots, SQLiteRelayStore } from './relay-store.js';
 import { githubAuthContext } from './github-auth.js';
 import { dashboardJobAction, isEntrypoint, runtimePlanner, runtimeReviewer, startService, SERVICE_DEFAULTS } from './cli.js';
+import { eventBusResolutionMessage, resolveEventBus } from './cli-support.js';
 import { applyJobActivateAction } from './job-actions.js';
 import { applyOrchestratorCompleteAction } from './task-actions.js';
 import { dashboardJobSetState, dashboardTaskAction, dashboardTaskSetState } from './dashboard-actions.js';
@@ -54,7 +54,7 @@ Options:
   --projection-ms MS      GitHub projection flush interval (default: 1000)
   --execution-router-rules PATH
                          Router Rules file (default: ~/.agents-relay/execution-router-rules.md)
-  --events nats            Enable event wakeups
+  --events nats            Require NATS event wakeups (otherwise auto-detect reachable NATS)
 
 Legacy single-job mode also accepts --repo OWNER/REPO --pr NUMBER --id JOB_ID.
 
@@ -119,7 +119,9 @@ export async function runDaemon(argv) {
     const client = auth.client;
     const trusted = auth.trustedAuthors;
     const concurrency = Number(value(argv, '--concurrency', '4'));
-    const bus = value(argv, '--events') === 'nats' ? new NatsEventBus(value(argv, '--nats-url', 'nats://127.0.0.1:4222'), value(argv, '--subject-prefix', 'neo.events.job')) : undefined;
+    const eventResolution = await resolveEventBus([...argv]);
+    const bus = eventResolution.bus;
+    process.stderr.write(`${eventBusResolutionMessage(eventResolution)}\n`);
     const workspaceRoot = normalized.workspaceRoot ?? defaultWorkspaceRoot();
     const discoveredRepositories = normalized.repository ? [] : await discoverWorkspaceRepositories(workspaceRoot);
     const repositories = normalized.repository ? [normalized.repository] : discoveredRepositories.map(item => item.repository);

package/package.json

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