agents-relay 2.0.145 → 2.0.147

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/dist/workflow/graph-v2.js

@@ -24,11 +24,30 @@ function parseLabel(raw, line) {
 }
 export function parseGraphV2(source) {
     const lines = source.split(/\r?\n/);
+    // Mermaid YAML frontmatter is metadata only; never execute it as graph policy.
+    // Preserve original source line positions for diagnostics and coverage reports.
+    let graphStart = 0;
+    if (lines[0]?.trim() === '---') {
+        let closing = -1;
+        for (let i = 1; i < lines.length; i += 1) {
+            if (lines[i].trim() === '---') {
+                closing = i;
+                break;
+            }
+            if (!/^(title|description):\s+[^\r\n]+$/.test(lines[i]))
+                fail(i + 1, 'unsupported graph frontmatter field');
+        }
+        if (closing < 0)
+            fail(1, 'unterminated graph frontmatter');
+        if (closing === 1)
+            fail(1, 'empty graph frontmatter');
+        graphStart = closing + 1;
+    }
     let direction = null;
     let initial = null;
     const nodes = new Map();
     const edges = [];
-    for (let index = 0; index < lines.length; index += 1) {
+    for (let index = graphStart; index < lines.length; index += 1) {
         const lineNumber = index + 1;
         const line = lines[index].trim();
         if (!line)

package/package.json

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

package/workflow/authoritative-unblock.mmd

@@ -1,3 +1,7 @@
+---
+title: Authoritative Unblock
+description: Validates authoritative unblock requests and safely resumes blocked workflow work.
+---
 flowchart LR
 %% relay: initial blocked
 blocked["state: blocked"]

package/workflow/blocker-resolution.mmd

@@ -1,3 +1,7 @@
+---
+title: Blocker Resolution
+description: Resolves blockers through verified recovery evidence and graph-authorized decisions.
+---
 flowchart LR
 %% relay: initial waiting
 waiting["state: waiting"]

package/workflow/escalation.mmd

@@ -1,3 +1,7 @@
+---
+title: Escalation
+description: Routes unresolved recovery to human escalation and records response outcomes.
+---
 flowchart LR
 %% relay: initial suspected
 suspected["state: suspected_human_blocker"]

package/workflow/interactive-invocation.mmd

@@ -1,3 +1,7 @@
+---
+title: Interactive Invocation
+description: Controls interactive agent invocation through guarded lifecycle transitions.
+---
 flowchart LR
 %% relay: initial awaiting_decision
 awaiting_decision["state: awaiting_decision"]

package/workflow/job-lifecycle.mmd

@@ -1,3 +1,7 @@
+---
+title: Job Lifecycle
+description: Defines canonical Job states, completion gates, and terminal transitions.
+---
 flowchart LR
 %% relay: initial draft
 draft["state: DRAFT"]

package/workflow/main.mmd

@@ -1,3 +1,7 @@
+---
+title: Main
+description: Presentation-only entry map linking workflow graphs and explaining contract, graph, code, guard, action, and effect ownership.
+---
 %% dashboard: presentation-only — not registered with GraphRuntime or the executable Graph DSL.
 %% PRINCIPLES (this graph is a readable overview, not an executable policy):
 %% CONTRACT defines typed events, permissions and invariants; GRAPH defines legal transitions,
@@ -44,10 +48,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 +74,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

package/workflow/orchestrator-rescue.mmd

@@ -1,3 +1,7 @@
+---
+title: Orchestrator Rescue
+description: Determines when orchestration needs safe intervention or recovery.
+---
 flowchart LR
 %% relay: initial idle
 idle["state: idle"]

package/workflow/planner-orchestration.mmd

@@ -1,3 +1,7 @@
+---
+title: Planner Orchestration
+description: Guards autonomous planning rounds, interrupted plans, and planner recovery.
+---
 flowchart LR
 %% relay: initial idle
 idle["state: idle"]

package/workflow/planner-trigger.mmd

@@ -1,3 +1,7 @@
+---
+title: Planner Trigger
+description: Classifies planning requests as manual, unblock, scheduled, initial, or continuation.
+---
 flowchart LR
 %% relay: initial idle
 idle["state: idle"]

package/workflow/projection-conflict.mmd

@@ -1,3 +1,7 @@
+---
+title: Projection Conflict
+description: Detects and resolves conflicting workflow state projections against authoritative facts.
+---
 flowchart LR
 %% relay: initial classify
 classify["state: classify"]

package/workflow/review-lifecycle.mmd

@@ -1,3 +1,7 @@
+---
+title: Review Lifecycle
+description: Manages review creation, immutable verdicts, changes-required, and re-review.
+---
 flowchart LR
 %% relay: initial none
 none["state: NONE"]

package/workflow/schedule-cycle.mmd

@@ -1,3 +1,7 @@
+---
+title: Schedule Cycle
+description: Reconciles scheduled execution slots and finishes verified completed slots.
+---
 flowchart LR
 %% relay: initial idle
 idle["state: idle"]

package/workflow/scheduled-run.mmd

@@ -1,3 +1,7 @@
+---
+title: Scheduled Run
+description: Controls scheduled-run lifecycle and guarded execution.
+---
 flowchart LR
 %% relay: initial idle
 idle["state: idle"]

package/workflow/task-lifecycle.mmd

@@ -1,3 +1,7 @@
+---
+title: Task Lifecycle
+description: Defines canonical Task transitions, dispatch guards, failure, and recovery.
+---
 flowchart LR
 %% relay: initial draft
 draft["state: DRAFT"]

package/workflow/task-related-action.mmd

@@ -1,3 +1,7 @@
+---
+title: Task Related Action
+description: Authorizes task-related control actions using current workflow state.
+---
 flowchart LR
 %% relay: initial evaluate
 evaluate["state: evaluate"]

package/workflow/task-resolution.mmd

@@ -1,3 +1,7 @@
+---
+title: Task Resolution
+description: Selects and verifies resolution paths for failed or blocked Tasks.
+---
 flowchart LR
 %% relay: initial unresolved
 unresolved["state: unresolved"]

package/workflow/troubleshooter.mmd

@@ -1,3 +1,7 @@
+---
+title: Troubleshooter
+description: Coordinates diagnosis, recovery, escalation, and resolution of failed Tasks.
+---
 flowchart LR
 %% relay: initial idle
 idle["state: idle"]