agents-relay 2.0.8 → 2.0.9

package/README.md

@@ -193,6 +193,8 @@ External product feedback uses the reusable `src/feedback.ts` contract. See [doc
 
 reconcile leases and launches ready tasks without waiting inside the runtime scheduler; the CLI waits only long enough for its launched workers to persist results. agents-relayd (or the equivalent npx agents-relay serve) is the watchdog/dashboard mode. Model-backed workers require --events nats; the event transport carries authoritative terminal worker events as well as wake/progress traffic. See [docs/service.md](docs/service.md). --file PATH is explicit local demo/test mode only.
 
+Router Rules are stored at `~/.agents-relay/execution-router-rules.md` by default. `agents-relayd --execution-router-rules PATH` selects a different file for that daemon process; the explicit CLI path takes precedence over `AGENTS_RELAY_EXECUTION_ROUTER_RULES`, which remains supported for compatibility.
+
 `agents-relayd` without `--pr`/`--id` runs in workspace mode by default: it discovers nested Git repositories under `~/Workspace`, keeps only GitHub `origin` remotes, and aggregates their managed PR jobs into one dashboard and worker pool. Pass `--workspace PATH` to use another root. `--repo OWNER/REPO` remains the single-repository pool mode.
 
 For automation, Agents Relay can use GitHub App installation authentication via `AGENTS_RELAY_GITHUB_APP_ID`, `AGENTS_RELAY_GITHUB_APP_INSTALLATION_ID`, and `AGENTS_RELAY_GITHUB_APP_PRIVATE_KEY_FILE` (or matching CLI flags). Webhook mode is local-first: targeted webhook reconciliation is primary, dashboard auto-refresh reads the disposable in-process view restored from SQLite RelayStore state, and the broad watchdog drops to a 30-minute fallback. No separate persisted dashboard Job cache is maintained. See [docs/github-app-rate-limit.md](docs/github-app-rate-limit.md).

package/dist/dashboard-html.js

@@ -187,7 +187,7 @@ export const dashboardHtml = `<!doctype html>
     <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="graphs-tab" type="button" role="tab" aria-selected="false" aria-controls="graphs-view">Graphs</button>
-    <button id="rules-tab" type="button" role="tab" aria-selected="false" aria-controls="rules-view">Execution Rules</button>
+    <button id="rules-tab" type="button" role="tab" aria-selected="false" aria-controls="rules-view">Router Rules</button>
     <button id="shortcuts-tab" type="button" role="tab" aria-selected="false" aria-controls="shortcuts-view">Shortcuts</button>
   </nav>
 </header>
@@ -235,7 +235,7 @@ export const dashboardHtml = `<!doctype html>
   </section>
   <section id="rules-view" role="tabpanel" aria-labelledby="rules-tab" hidden>
     <div class="panel">
-      <div class="panel-head"><h2>Execution Router Rules</h2><span id="rules-meta" class="subtle"></span></div>
+      <div class="panel-head"><h2>Router Rules</h2><span id="rules-meta" class="subtle"></span></div>
       <div class="panel-body">
         <div class="rules-editor">
           <p class="rules-help">Free-text soft policy loaded by the Execution Router for every worker+model routing decision. Impossible routes remain excluded by code; Codex remains the deterministic fallback if decision fails.</p>

package/dist/relayd.js

@@ -23,6 +23,7 @@ import { deriveJobRuntimeStatus } from './runtime-status.js';
 import { decisionMode, LayaCliDecisionEngine } from './decision.js';
 import { JsonlDecisionAuditStore } from './decision-audit.js';
 import { summarizeRuntime } from './runtime-summary.js';
+import { executionRouterRulesPath } from './routing-policy.js';
 export async function overlayOperationalOverviews(overviews, storeFor) {
     return await Promise.all(overviews.map(async (item) => {
         const store = storeFor(item.job.repository, item.job.prNumber);
@@ -51,6 +52,8 @@ Options:
   --concurrency N         Maximum concurrent workers (default: 4)
   --interval MS           Recovery interval
   --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
 
 Legacy single-job mode also accepts --repo OWNER/REPO --pr NUMBER --id JOB_ID.
@@ -95,11 +98,18 @@ export function recoveryScanRepositories(repositories, cached, dormantProbeIndex
         return activeOrUnknown;
     return [...activeOrUnknown, dormant[Math.abs(dormantProbeIndex) % dormant.length]];
 }
+export function configureExecutionRouterRulesPath(argv) {
+    const explicitRulesPath = value(argv, '--execution-router-rules') || undefined;
+    if (explicitRulesPath)
+        process.env.AGENTS_RELAY_EXECUTION_ROUTER_RULES = executionRouterRulesPath(explicitRulesPath);
+    return executionRouterRulesPath();
+}
 export async function runDaemon(argv) {
     if (argv.includes('--help') || argv.includes('-h')) {
         console.log(daemonHelp);
         return;
     }
+    configureExecutionRouterRulesPath(argv);
     const normalized = normalizeDaemonArguments(argv);
     if (normalized.pullRequest && normalized.jobId) {
         await startService([...argv]);

package/dist/routing-policy.js

@@ -1,5 +1,6 @@
 import { createHash } from 'node:crypto';
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 const EMPTY_POLICY = {};
 function safePolicy(value) {
@@ -45,7 +46,7 @@ async function saveRouterRules(path, text) {
     return { path, hash: createHash('sha256').update(text).digest('hex'), text };
 }
 export function executionRouterRulesPath(explicit) {
-    return explicit ?? process.env.AGENTS_RELAY_EXECUTION_ROUTER_RULES ?? join(process.cwd(), '.agents-relay-execution-router-rules.md');
+    return explicit ?? process.env.AGENTS_RELAY_EXECUTION_ROUTER_RULES ?? join(homedir(), '.agents-relay', 'execution-router-rules.md');
 }
 export async function loadExecutionRouterRules(explicit) {
     return await loadRouterRules(executionRouterRulesPath(explicit));

package/package.json

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