agents-relay 2.0.145 → 2.0.146

package/dist/cli.js

@@ -618,6 +618,7 @@ export async function createService(args) {
         },
     } : undefined;
     const dashboardServer = serveDashboard(loaded.store, Number(arg(args, '--port', String(SERVICE_DEFAULTS.port))), bus, Number(arg(args, '--refresh-ms', String(SERVICE_DEFAULTS.dashboardRefreshMs))), loaded.job.id, usageRegistry, overviewProvider, webhook, undefined, undefined, undefined, {
+        control: await (await import('./single-job-task-control.js')).createSingleJobTaskControl(loaded.job.id, loaded.store, reconciler, bus),
         start: dashboardJobAction(loaded.store, reconciler, 'start'),
         reconcile: dashboardJobAction(loaded.store, reconciler, 'reconcile'),
         cancel: dashboardJobAction(loaded.store, reconciler, 'cancel'),

package/dist/single-job-task-control.js

@@ -0,0 +1,28 @@
+import { dispatchTaskAction } from './task-actions.js';
+export async function createSingleJobTaskControl(jobId, store, reconciler, bus) {
+    const { createWorkspaceControl } = await import('./relayd-control.js');
+    const unblock = await import('./unblock.js');
+    const { publishTaskUnblocked } = await import('./cli-support.js');
+    const canonicalControl = createWorkspaceControl({
+        requireLocalJobBinding: async (id) => {
+            if (id !== jobId)
+                throw new Error('Control request outside bound Job');
+            return { store };
+        },
+        pool: { reconcileLocalJob: async (id) => {
+                await reconciler.reconcile(id);
+                await reconciler.idle();
+            } },
+        bus, isEffectivelyBlocked: unblock.isEffectivelyBlocked,
+        unblockAutonomousTasks: unblock.unblockAutonomousTasks, unblockTask: unblock.unblockTask,
+        publishTaskUnblocked, dispatchTaskAction,
+    });
+    const allowed = new Set(['task.unblock', 'task.recover', 'task.escalate', 'task.resume-troubleshooter']);
+    return async (body) => {
+        if (!allowed.has(String(body.command ?? '')))
+            throw new Error('Single-Job control command not supported');
+        if (body.jobId !== jobId)
+            throw new Error('Control request outside bound Job');
+        return canonicalControl(body);
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-relay",
-  "version": "2.0.145",
+  "version": "2.0.146",
   "description": "Durable async agent jobs coordinated through GitHub pull requests",
   "repository": {
     "type": "git",

package/workflow/main.mmd

@@ -44,10 +44,14 @@ flowchart LR
     escalation -->|resolved: reconcile and resume| trouble
 
     subgraph principles["Contract / Graph / Code — principal rules"]
-      contractNote["contract: Event schema + authority + permissions"]
-      graphNote["graph: Transitions + Guards + Action ordering"]
-      codeNote["code: Facts + SQLite + guarded effects"]
+      contractNote["contract: Schemas + owner + permissions"]
+      graphNote["graph: Transitions + action ordering"]
+      codeNote["code: Facts + SQLite + effect executors"]
+      guardNote["guard: Read authoritative facts; no mutation"]
+      actionNote["action: Graph-selected operation only"]
+      effectNote["effect: Side effect + receipt; never policy"]
       contractNote ~~~ graphNote ~~~ codeNote
+      guardNote ~~~ actionNote ~~~ effectNote
     end
 
 
@@ -66,7 +70,7 @@ flowchart LR
     classDef normal fill:#eff6ff,stroke:#2563eb,color:#1e40af
     class trouble,recover,escalation exception
     class objective,planner,worker,reviewer,delivery,verify,completed,fix normal
-    class contractNote,graphNote,codeNote normal
+    class contractNote,graphNote,codeNote,guardNote,actionNote,effectNote normal
 
     %% Failed/unknown transitions are red; verified retries remain blue.
     linkStyle 8,9,10,11,12,18 stroke:#be3030,stroke-width:2px