agents-relay 1.0.32 → 1.0.34

package/README.md

@@ -114,7 +114,7 @@ The minimal agent-network surface is machine-driven registration and discovery.
 
 Managed tasks are descriptive work for agents, not shell commands. Use `codex` or `chatgpt` for worker tasks. Commands such as tests, build tools, Markad Vision, ffmpeg, and other CLIs are invoked by the orchestrator or by an executing agent; they are not worker adapters.
 
-Every model-backed task declares a durable output with `--output task-pr` or `--output file --output-path PATH`. Agents Relay enriches the prompt with the PR URL, job/task identity, output contract, and mandatory terminal-event contract.
+Every model-backed task declares a durable output with `--output task-pr` or `--output file --output-path PATH`. Agents Relay bootstraps workers with the managed PR URL, durable task-comment URL, job/task identity, project, output contract, and mandatory terminal-event contract; workers retrieve the task intent from GitHub rather than receiving a duplicate copy of the stored task prompt.
 
 For Codex and ChatGPT, **events are authoritative task state**. Event publication uses the canonical Neo `events-bus` surface (`events__publish` for sandboxed/hosted workers, or `NEO_EVENTS_EMIT` for direct local workers); Agents Relay only subscribes and reconciles. Relay publishes `task.process.launched` only after successful adapter launch; `task.started` is worker-owned and must be a new, correlated start acknowledgement. Codex publishes `task.process.exited` when its synchronous runtime exits, while ChatGPT publishes `task.process.async_exited` after its submission runtime exits; neither substitutes for `task.completed`, `task.failed`, `task.blocked`, or `task.cancelled`. The ChatGPT worker-owned tab follows the configured close policy: `after-start` waits for the correlated start acknowledgement, `never` keeps it open for debug, and `after-terminal` waits for a new exact-task terminal event; start-ack failure closes only the owned tab after 60 seconds. The executing agent must publish exactly one correlated terminal event. Relay persists the matching durable state only from that terminal event. Model-backed tasks require an event bus and time out explicitly if no terminal event arrives.
 

package/dist/cli.js

@@ -65,7 +65,7 @@ Example:
     'job create': `Create or reuse an open PR and persist one durable job marker.
 
 Required: --repo OWNER/REPO, --id JOB_ID, and --head BRANCH.
-Common: --base BRANCH (default: main), --title TEXT, --body TEXT, --mode fixed|autonomous, --no-auto-merge.
+Common: --base BRANCH (default: main), --title TEXT, --body TEXT, --mode fixed|autonomous, --no-auto-merge, --no-review.
 With --start, also require --adapter codex|chatgpt, --model MODEL, --output task-pr|file,
 and --input TEXT. The initial task ID defaults to 'initial'; use --task-id to override it.
 
@@ -270,7 +270,7 @@ export async function ensureManagedGitHubJob(client, repositoryName, trustedAuth
         if (!(error instanceof Error) || !error.message.includes('has no durable'))
             throw error;
         const now = new Date().toISOString();
-        job = { id: options.id, title: options.title || pr.title || 'Agents Relay job', objective: options.objective || pr.body || undefined, description: pr.body || undefined, priority: options.priority ?? 'P2', executionMode: options.executionMode ?? 'fixed', autoMerge: options.autoMerge ?? true, prNumber: pr.number, repository: repositoryName, state: 'OPEN', continuation: options.continuation ?? null, initialPlanning: options.initialTasks?.length ? { status: 'pending', decisionId: 'planner-0' } : undefined, createdAt: now, updatedAt: now, tasks: [] };
+        job = { id: options.id, title: options.title || pr.title || 'Agents Relay job', objective: options.objective || pr.body || undefined, description: pr.body || undefined, priority: options.priority ?? 'P2', executionMode: options.executionMode ?? 'fixed', autoMerge: options.autoMerge ?? true, reviewEnabled: options.reviewEnabled ?? true, prNumber: pr.number, repository: repositoryName, state: 'OPEN', continuation: options.continuation ?? null, initialPlanning: options.initialTasks?.length ? { status: 'pending', decisionId: 'planner-0' } : undefined, createdAt: now, updatedAt: now, tasks: [] };
     }
     if (!job.description && pr.body)
         job.description = pr.body;
@@ -280,6 +280,8 @@ export async function ensureManagedGitHubJob(client, repositoryName, trustedAuth
         job.executionMode = options.executionMode;
     if (options.autoMerge !== undefined)
         job.autoMerge = options.autoMerge;
+    if (options.reviewEnabled !== undefined)
+        job.reviewEnabled = options.reviewEnabled;
     if (options.priority)
         job.priority = options.priority;
     else if (!job.priority)
@@ -492,6 +494,7 @@ async function runJobCommand(action, args) {
         priority: priority(args),
         executionMode: requestedExecutionMode(args),
         autoMerge: !hasArg(args, '--no-auto-merge'),
+        reviewEnabled: !hasArg(args, '--no-review'),
         continuation: continuation(args),
         prNumber,
         head: arg(args, '--head') || undefined,
@@ -603,7 +606,7 @@ async function main() {
     }
     if (command === 'init') {
         const now = new Date().toISOString();
-        const job = { id: arg(args, '--id', randomUUID()), title: arg(args, '--title', 'Agents Relay job'), objective: arg(args, '--objective') || undefined, priority: priority(args), executionMode: executionMode(args), autoMerge: !hasArg(args, '--no-auto-merge'), prNumber: Number(arg(args, '--pr', '0')), repository: arg(args, '--repo'), state: 'OPEN', continuation: continuation(args), createdAt: now, updatedAt: now, tasks: [] };
+        const job = { id: arg(args, '--id', randomUUID()), title: arg(args, '--title', 'Agents Relay job'), objective: arg(args, '--objective') || undefined, priority: priority(args), executionMode: executionMode(args), autoMerge: !hasArg(args, '--no-auto-merge'), reviewEnabled: !hasArg(args, '--no-review'), prNumber: Number(arg(args, '--pr', '0')), repository: arg(args, '--repo'), state: 'OPEN', continuation: continuation(args), createdAt: now, updatedAt: now, tasks: [] };
         let store;
         let file = null;
         if (arg(args, '--repo') && arg(args, '--pr'))

package/dist/reconciler.js

@@ -13,17 +13,20 @@ export function managedWorkerInput(job, task, context) {
     if (!task.output)
         throw new Error(`Task ${task.id} requires an explicit output contract`);
     const prUrl = `https://github.com/${job.repository}/pull/${job.prNumber}`;
+    const taskUrl = task.taskUrl ?? `${prUrl}#issuecomment-${task.id}`;
     const output = task.output.kind === 'file'
         ? `file\nPath: ${task.output.path}`
         : `task/PR\nPR: ${prUrl}\nTask: ${task.id}`;
     return `[Agents Relay managed task]
-PR: ${prUrl}
-Job: ${job.id}
-Task: ${task.id}
-Parent task: ${task.parentTaskId ?? 'none'}
+Job URL: ${prUrl}
+Job ID: ${job.id}
+Task URL: ${taskUrl}
+Task ID: ${task.id}
 Project: ${task.projectName ?? context?.project.name ?? 'unspecified'}
 
-${context ? executionContextPrompt(context) + '\n\n' : ''}${task.input}${task.parentTaskId ? '\n\n[Nested delegation contract]\nAny sub-work must be created as a durable Agents Relay child task with parentTaskId=' + task.id + '; do not directly spawn arbitrary child agents.' : ''}
+Retrieve the durable job and task from GitHub before doing the work. Use whatever GitHub access this environment provides: the URLs, a GitHub integration/tool, or GitHub CLI/API. GitHub is the source of truth for task intent and declared output.
+
+${context ? executionContextPrompt(context) + '\n\n' : ''}Follow the resolved project instructions and Agents Relay/events-bus worker contracts.
 
 [Output contract]
 ${output}
@@ -196,7 +199,7 @@ export class Reconciler {
         await this.store.saveJob(job);
     }
     async ensureFinalReview(job, prState, headSha) {
-        if (prState !== 'OPEN' || job.state !== 'COMPLETED' || !headSha)
+        if (job.reviewEnabled === false || prState !== 'OPEN' || job.state !== 'COMPLETED' || !headSha)
             return;
         if (!this.preReviewGatesPass(job))
             return;

package/dist/store.js

@@ -434,7 +434,7 @@ export class GitHubStore {
         const all = [];
         let cursor = null;
         do {
-            const data = await this.graphql('query($owner:String!,$name:String!,$number:Int!,$cursor:String){repository(owner:$owner,name:$name){pullRequest(number:$number){comments(first:100,after:$cursor){nodes{id databaseId body updatedAt author{login}} pageInfo{hasNextPage endCursor}}}}}', { owner, name, number: this.prNumber, cursor });
+            const data = await this.graphql('query($owner:String!,$name:String!,$number:Int!,$cursor:String){repository(owner:$owner,name:$name){pullRequest(number:$number){comments(first:100,after:$cursor){nodes{id databaseId url body updatedAt author{login}} pageInfo{hasNextPage endCursor}}}}}', { owner, name, number: this.prNumber, cursor });
             const repository = data.repository;
             const pr = repository?.pullRequest;
             const comments = pr?.comments;
@@ -444,6 +444,7 @@ export class GitHubStore {
                 all.push({
                     id: Number(value.databaseId ?? 0),
                     nodeId: typeof value.id === 'string' ? value.id : undefined,
+                    url: typeof value.url === 'string' ? value.url : undefined,
                     body: String(value.body ?? ''),
                     updatedAt: String(value.updatedAt ?? ''),
                     authorLogin: typeof author?.login === 'string' ? author.login : null
@@ -486,7 +487,13 @@ export class GitHubStore {
         if (!job)
             throw new Error(`Managed GitHub job ${jobId} has no durable ${JOB_MARKER} marker in PR #${this.prNumber}; run agents-relay job adopt --repo ${this.repository} --pr ${this.prNumber} --id ${jobId}`);
         const soleTrustedJob = jobs.length === 1;
-        job.tasks = comments.map(x => parseTask(x.body)).filter((x) => x !== null).filter(task => isTaskForJob(task, jobId, soleTrustedJob));
+        job.tasks = comments.map(comment => {
+            const task = parseTask(comment.body);
+            if (!task)
+                return null;
+            const taskUrl = comment.url ?? (comment.id > 0 ? `https://github.com/${this.repository}/pull/${this.prNumber}#issuecomment-${comment.id}` : undefined);
+            return taskUrl ? { ...task, taskUrl } : task;
+        }).filter((x) => x !== null).filter(task => isTaskForJob(task, jobId, soleTrustedJob));
         return job;
     }
     async listAgents() { return (await this.list()).filter(comment => this.isTrusted(comment)).map(x => parseAgent(x.body)).filter((x) => x !== null); }

package/package.json

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