agents-relay 1.0.62 → 1.0.64

package/dist/markers.js

@@ -20,9 +20,22 @@ export function parseMarker(body, label) {
     }
     return null;
 }
+const JOB_OBJECTIVE_END = '<!-- agents-relay:objective:end -->';
+const TASK_INPUT_END = '<!-- agents-relay:task-input:end -->';
+function contentBeforeDelimiter(body, heading, end) {
+    const startAt = body.indexOf(heading);
+    if (startAt < 0)
+        return undefined;
+    const contentStart = startAt + heading.length;
+    const endAt = body.indexOf(`\n${end}`, contentStart);
+    if (endAt < 0)
+        return undefined;
+    return body.slice(contentStart, endAt);
+}
 export function renderJobComment(job) {
     const objective = job.objective?.trim() || '_No objective recorded._';
-    return `${marker(JOB_MARKER, { ...job, tasks: undefined })}
+    const { objective: _objective, tasks: _tasks, ...metadata } = job;
+    return `${marker(JOB_MARKER, metadata)}
 # Agents Relay job: ${job.title}
 
 - **State:** ${job.state}
@@ -30,15 +43,13 @@ export function renderJobComment(job) {
 
 ## Objective
 
-${objective}`;
+${objective}
+${JOB_OBJECTIVE_END}`;
 }
 export function renderTaskComment(task) {
-    const result = task.result?.summary?.trim() ? `
-
-### Result
-
-${task.result.summary.trim()}` : '';
-    return `${marker(TASK_MARKER, task)}
+    const result = task.result?.summary?.trim() ? `\n\n### Result\n\n${task.result.summary.trim()}` : '';
+    const { input: _input, ...metadata } = task;
+    return `${marker(TASK_MARKER, metadata)}
 ## Task: ${task.id}
 
 - **State:** ${task.state}
@@ -46,23 +57,40 @@ ${task.result.summary.trim()}` : '';
 
 ### Work
 
-${task.input}${result}`;
+${task.input}
+${TASK_INPUT_END}${result}`;
+}
+function markdownSection(body, heading) {
+    const start = body.indexOf(heading);
+    if (start < 0)
+        return undefined;
+    return body.slice(start + heading.length).trim();
 }
 export function parseJob(body) {
     const job = parseMarker(body, JOB_MARKER);
     if (!job)
         return null;
-    if (job.executionMode === undefined)
-        return { ...job, executionMode: 'fixed' };
-    if (job.executionMode !== 'fixed' && job.executionMode !== 'autonomous')
+    const objective = job.objective ?? contentBeforeDelimiter(body, '\n## Objective\n\n', JOB_OBJECTIVE_END) ?? markdownSection(body, '\n## Objective\n');
+    const parsed = { ...job, objective };
+    if (parsed.executionMode === undefined)
+        return { ...parsed, executionMode: 'fixed' };
+    if (parsed.executionMode !== 'fixed' && parsed.executionMode !== 'autonomous')
         return null;
-    return job;
+    return parsed;
 }
 export function parseTask(body) {
     const task = parseMarker(body, TASK_MARKER);
     if (!task)
         return null;
-    return { ...task, kind: task.kind === 'planner' ? 'planner' : 'work' };
+    let input = task.input ?? contentBeforeDelimiter(body, '\n### Work\n\n', TASK_INPUT_END);
+    if (input === undefined) {
+        const work = markdownSection(body, '\n### Work\n');
+        const suffix = task.result?.summary?.trim() ? `\n\n### Result\n\n${task.result.summary.trim()}`.trim() : undefined;
+        input = work && suffix && work.endsWith(suffix) ? work.slice(0, -suffix.length).trimEnd() : work;
+    }
+    if (input === undefined)
+        return null;
+    return { ...task, input, kind: task.kind === 'planner' ? 'planner' : 'work' };
 }
 export function renderAgentComment(agent) { return `${marker(AGENT_MARKER, agent)}\n## Registered agent ${agent.name}\nRole: ${agent.role}\nAvailability: ${agent.availability}`; }
 export function parseAgent(body) { return parseMarker(body, AGENT_MARKER); }

package/package.json

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

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

@@ -4,7 +4,9 @@ This contract is the shared protocol for every component that creates, schedules
 
 ## Job and Task authoring format
 
-Job objectives and Task inputs are **Markdown** and are durable execution context, not short labels. When the work has a workflow, state model, architecture, dependency graph, or relationship that is clearer visually, put a Mermaid block first and follow it with Markdown details. Otherwise use structured Markdown text directly.
+Job objectives and Task inputs are **Markdown** and are durable execution context, not short labels. Use Mermaid where a diagram materially explains a workflow, state model, architecture, dependency graph, relationship, or other visual structure. **Mermaid-first applies to that explanation/section, not to the entire Job objective or Task input.** Put the diagram before the prose that explains that visual model, but keep normal document structure: start with the goal/context when that is what the reader needs first. Do not force a Mermaid block at the top of every objective/input, and do not add decorative or redundant diagrams when Markdown is clearer.
+
+The trusted machine-readable Job/Task marker stores lifecycle and execution metadata only. Do **not** duplicate the Job objective or Task input inside the JSON marker; those long-form Markdown bodies remain the human-readable durable content rendered by the Job/Task comment (and, for a Job objective, the PR body). Readers reconstruct `objective` / `input` from that visible Markdown while remaining backward-compatible with legacy markers that embedded them.
 
 For long-form content, use files instead of shell-quoted arguments: