agents-relay 1.0.114 → 1.0.116

package/dist/planner.js

@@ -11,9 +11,9 @@ export function planningSpec(task) {
         throw new Error(`Initial task ${task.id} requires a supported adapter`);
     return { id: task.id, input: task.input, priority: task.priority, storySize: task.storySize, projectName: task.projectName, agentName: task.agentName, agentGraph: task.agentGraph, dependencies: task.dependencies, capabilities: task.capabilities, workerRequirements: task.workerRequirements, adapter: task.adapter, output: task.output ?? { kind: 'task_pr' }, routing: task.routing, continuation: task.continuation, maxAttempts: task.maxAttempts, timeoutMs: task.timeoutMs };
 }
-function record(value) {
+function record(value, field = 'result') {
     if (!value || typeof value !== 'object' || Array.isArray(value))
-        throw new Error('Planner result must be an object');
+        throw new Error(`Planner ${field} must be an object`);
     return value;
 }
 function optionalString(value, field) {
@@ -33,7 +33,7 @@ function stringArray(value, field, fallback = []) {
 function workerRequirements(value, field) {
     if (value === undefined || value === null)
         return undefined;
-    const root = record(value);
+    const root = record(value, field);
     const capabilities = stringArray(root.capabilities, `${field}.capabilities`);
     const optional = (name) => optionalString(root[name], `${field}.${name}`);
     const labelsValue = root.labels;
@@ -77,14 +77,14 @@ export function normalizePlannerPriority(value, field) {
 function routing(value, field) {
     if (value === undefined || value === null)
         return undefined;
-    const route = record(value);
+    const route = record(value, field);
     for (const key of ['provider', 'model', 'decidedBy', 'decidedAt'])
         if (typeof route[key] !== 'string' || String(route[key]).length === 0)
             throw new Error(`Planner ${field}.${key} is required`);
     return { provider: route.provider, model: route.model, profile: optionalString(route.profile, `${field}.profile`), reasoning: optionalString(route.reasoning, `${field}.reasoning`), cwd: optionalString(route.cwd, `${field}.cwd`), projectId: optionalString(route.projectId, `${field}.projectId`), decidedBy: route.decidedBy, decidedAt: route.decidedAt };
 }
 export function parsePlannerResult(value) {
-    const root = record(value);
+    const root = record(value, 'result');
     const status = root.objective_status;
     if (status !== 'in_progress' && status !== 'satisfied')
         throw new Error('Planner objective_status must be in_progress or satisfied');
@@ -94,7 +94,7 @@ export function parsePlannerResult(value) {
         throw new Error('Planner next_tasks must be an array');
     const ids = new Set();
     const next_tasks = root.next_tasks.map((item, index) => {
-        const task = record(item);
+        const task = record(item, `next_tasks[${index}]`);
         const id = task.id;
         if (typeof id !== 'string' || id.length === 0)
             throw new Error(`Planner next_tasks[${index}].id is required`);
@@ -106,7 +106,7 @@ export function parsePlannerResult(value) {
         const adapter = task.adapter;
         if (adapter !== undefined && !['codex', 'chatgpt'].includes(String(adapter)))
             throw new Error(`Planner next_tasks[${index}].adapter must be codex or chatgpt when provided`);
-        const output = task.output === undefined ? undefined : record(task.output);
+        const output = task.output === undefined ? undefined : record(task.output, `next_tasks[${index}].output`);
         if (!output || (output.kind !== 'task_pr' && output.kind !== 'file'))
             throw new Error(`Planner next_tasks[${index}].output is required`);
         if (output.kind === 'file' && (typeof output.path !== 'string' || output.path.length === 0))
@@ -139,15 +139,41 @@ export function parsePlannerOutput(output) {
     const candidate = trimmed.replace(/^```(?:json)?\s*/i, '').replace(/\s*```$/, '').trim();
     return parsePlannerResult(JSON.parse(candidate));
 }
+function boundedText(value, max = 4000) {
+    if (value === null || value === undefined || value.length <= max)
+        return value;
+    return value.slice(0, max) + `\n...[truncated ${value.length - max} chars]`;
+}
 export function plannerInput(context) {
     const visibleAgents = context.executionContext?.agents.map(agent => ({
         name: agent.name,
-        description: agent.description,
+        description: boundedText(agent.description, 1000),
         capabilities: agent.capabilities,
         boundaries: agent.restrictions,
         runtime: agent.runtime,
     }));
-    return JSON.stringify({ objective: context.objective, retry_feedback: context.retryFeedback, previous_planner_task_id: context.previousPlannerTaskId, visible_agents: visibleAgents ?? [], execution_context: context.executionContext, tasks: context.tasks.map(task => ({ id: task.id, kind: task.kind ?? 'work', parent_task_id: task.parentTaskId, state: task.state, input: task.input, result: task.result, planner_result: task.plannerResult, error: task.error })) });
+    const project = context.executionContext?.project;
+    return JSON.stringify({
+        objective: context.objective,
+        retry_feedback: context.retryFeedback,
+        previous_planner_task_id: context.previousPlannerTaskId,
+        project: project ? { name: project.name, path: project.path } : undefined,
+        visible_agents: visibleAgents ?? [],
+        tasks: context.tasks.map(task => ({
+            id: task.id,
+            kind: task.kind ?? 'work',
+            parent_task_id: task.parentTaskId,
+            state: task.state,
+            input: task.kind === 'planner' ? undefined : boundedText(task.input),
+            result_summary: boundedText(task.result?.summary),
+            planner_result: task.plannerResult ? {
+                objective_status: task.plannerResult.objective_status,
+                assessment: boundedText(task.plannerResult.assessment),
+                next_task_ids: task.plannerResult.next_tasks.map(item => item.id),
+            } : undefined,
+            error: boundedText(task.error, 2000),
+        })),
+    });
 }
 export class CommandObjectivePlanner {
     command;

package/package.json

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

package/skills/agents-relay/agents/planner.agent.md

@@ -87,3 +87,36 @@ For `objective_status: "in_progress"`, `assessment` must be Markdown containing:
 For `objective_status: "satisfied"`, `assessment` may be a concise evidence-based completion assessment without a graph.
 
 Each item in next_tasks contains id, input, output, and storySize. It may also contain priority, projectName, agentName, dependencies, capabilities, workerRequirements, maxAttempts, and timeoutMs. Adapter/routing fields are selected by Relay after planning; do not invent them.
+
+### Exact `next_tasks` serialization
+
+Use these exact serialized forms:
+
+- `output` is always an object, never a string:
+  - PR-backed work: `{"kind":"task_pr"}`
+  - File artifact: `{"kind":"file","path":"runs/2026-09-26/example/output.md"}`
+- `agentGraph`, when present, is one Mermaid graph **string**, for example `"graph LR\n  build-log-editor --> build-log-producer"`. Do not emit an object with `nodes` or `edges`.
+- `priority`, when present, is exactly `"P0"`, `"P1"`, `"P2"`, or `"P3"`; otherwise omit it.
+- `storySize` is exactly `"S"`, `"M"`, or `"L"`.
+
+A valid non-satisfied response:
+
+```json
+{
+  "objective_status": "in_progress",
+  "assessment": "```mermaid\nflowchart LR\n  A[Evidence] --> B[Content package]\n```\nOne daily package is the durable Task boundary.",
+  "next_tasks": [
+    {
+      "id": "episode-2026-09-26",
+      "input": "Produce and verify the dated content package.",
+      "output": {"kind": "file", "path": "runs/2026-09-26/package.md"},
+      "storySize": "L",
+      "priority": "P1",
+      "agentName": "build-log-editor",
+      "agentGraph": "graph LR\n  build-log-editor --> build-log-producer"
+    }
+  ]
+}
+```
+
+Return this JSON object directly. Do not wrap the whole result in another JSON string.