agents-relay 2.0.89 → 2.0.91

package/dist/adapters.js

@@ -4,6 +4,7 @@ import { pathToFileURL } from 'node:url';
 import { randomUUID } from 'node:crypto';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { withTestInjection } from './e2e-injection.js';
+import { taskReferencePrompt } from './task-context.js';
 import { spawnOwnedProcess, terminateOwnedProcess, ownedProcessTerminationReason } from './owned-process.js';
 export function buildCodexArgs(route, input) {
     const args = ['exec', '--json'];
@@ -372,7 +373,8 @@ export class ChatGptAdapter {
                 throw new Error('browser-worker execution aborted');
             const policy = chatGptTabClosePolicy(task.chatgptTabClosePolicy, this.tabClosePolicy);
             const submit = () => (this.runner ?? browserWorkerRunner())(definition, {
-                prompt: task.input,
+                prompt: task.chatgptThreadDelivery?.threadSource === 'implementation' && task.chatgptThreadDelivery.repository && task.chatgptThreadDelivery.executionId
+                    ? taskReferencePrompt(task.chatgptThreadDelivery.repository, task.chatgptThreadDelivery.jobId, task.id, task.chatgptThreadDelivery.executionId) : task.input,
                 ...(task.attachments?.length ? { files: task.attachments } : {}),
                 ...(task.chatgptThreadDelivery ? { thread: task.chatgptThreadDelivery } : {}),
                 tabClosePolicy: policy,

package/dist/cli-help.js

@@ -129,6 +129,15 @@ Use --clear-routing to remove routing metadata.
 
 Example:
   npx agents-relay task update --repo OWNER/REPO --pr 12 --id job-1 --task-id build --adapter chatgpt --provider chatgpt --model gpt-5.6-sol --reasoning high`,
+    'task comment': `Append an immutable Task comment. Does not retry or change Task state.
+
+Required: --repo OWNER/REPO --id JOB_ID --task-id TASK_ID and --message TEXT or --message-file FILE.`,
+    'task comments': `List append-only Task comments.
+
+Required: --repo OWNER/REPO --id JOB_ID --task-id TASK_ID.`,
+    'task context': `Read the authoritative execution-scoped Task contract.
+
+Required: --repo OWNER/REPO --id JOB_ID --task-id TASK_ID --execution-id EXECUTION_ID. Fails closed on stale execution.`,
     'task show': `Show one durable Task.
 
 Required: --task-id ID and the normal Job storage options.`,

package/dist/cli.js

@@ -40,6 +40,7 @@ export { runtimeReviewer } from './reviewer-thread.js';
 import { SERVICE_DEFAULTS, ServiceEventBus, arg, hasArg, textOption, integerArg, repository, storeFor, saveLocal, eventBus, publishWake, priority, storySize, executionMode, chatGptTabClosePolicy, requestedExecutionMode, continuation, scheduleFromArgs, jobTagFromArgs, requestManagedReconciliation, relayControlJob, relayControlCommand, relayJobList, relayJobStateCommand, relayTaskCommand, withEventBus } from './cli-support.js';
 export { SERVICE_DEFAULTS, eventBus, executionMode, chatGptTabClosePolicy } from './cli-support.js';
 import { workerTaskFromArgs } from './cli-worker-task.js';
+import { taskExecutionContext } from './task-context.js';
 export { ensureManagedGitHubJob } from './cli-job-create.js';
 async function runManagedTaskCommand(action, args) {
     const jobId = arg(args, '--id');
@@ -67,7 +68,7 @@ async function runManagedTaskCommand(action, args) {
     console.log(JSON.stringify(task, null, 2));
 }
 async function runTaskCommand(action, args) {
-    if (!['create', 'update', 'show', 'list', 'retry', 'recover', 'unblock', 'cancel', 'supersede'].includes(action))
+    if (!['create', 'update', 'show', 'context', 'comment', 'comments', 'list', 'retry', 'recover', 'unblock', 'cancel', 'supersede'].includes(action))
         throw new Error(usage);
     const managed = !arg(args, '--file') && Boolean(arg(args, '--repo') && arg(args, '--id'));
     if (managed) {
@@ -78,6 +79,30 @@ async function runTaskCommand(action, args) {
             return;
         }
         const taskId = arg(args, '--task-id');
+        if (action === 'comment') {
+            if (!taskId)
+                throw new Error('task comment requires --task-id');
+            const message = await textOption(args, '--message', '--message-file');
+            console.log(JSON.stringify(await relayControlCommand(args, { command: 'task.comment', jobId, taskId, message }), null, 2));
+            return;
+        }
+        if (action === 'comments') {
+            if (!taskId)
+                throw new Error('task comments requires --task-id');
+            const job = await relayControlJob(args, jobId);
+            const task = job.tasks.find(item => item.id === taskId);
+            if (!task)
+                throw new Error(`Task ${taskId} not found`);
+            console.log(JSON.stringify(task.comments ?? [], null, 2));
+            return;
+        }
+        if (action === 'context') {
+            if (!taskId)
+                throw new Error('task context requires --task-id');
+            const job = await relayControlJob(args, jobId);
+            console.log(JSON.stringify(taskExecutionContext(job, taskId, arg(args, '--execution-id')), null, 2));
+            return;
+        }
         if (action === 'show') {
             if (!taskId)
                 throw new Error('task show requires --task-id');

package/dist/local-authority-store.js

@@ -260,7 +260,7 @@ export class LocalAuthorityDurableStore {
             if (current.attempt === task.attempt && current.updatedAt === task.updatedAt
                 && TASK_STATE_ORDER[current.state] >= TASK_STATE_ORDER[task.state])
                 return job;
-            job.tasks[index] = structuredClone(task);
+            job.tasks[index] = { ...structuredClone(task), comments: current.comments ?? task.comments };
             return job;
         });
     }

package/dist/reconciler.js

@@ -1,3 +1,4 @@
+import { taskCommentContext } from './task-comments.js';
 import { cancelActiveTasks } from './reconciler-cancellation.js';
 import { authorizedInjection } from './e2e-injection.js';
 import { implementationComplete } from './runtime-status.js';
@@ -375,7 +376,7 @@ export class Reconciler extends ReconcilerReviewBase {
                 freshTask.chatgptThreadDelivery = {
                     kind: 'new-turn', threadId: implementationThread, threadSource: 'implementation',
                     requestId: `${freshJob.id}:${freshTask.id}:${freshTask.executionId}`,
-                    jobId: freshJob.id, prNumber: freshJob.prNumber, executionId: freshTask.executionId,
+                    jobId: freshJob.id, repository: freshJob.repository, taskId: freshTask.id, prNumber: freshJob.prNumber, executionId: freshTask.executionId,
                     projectId: freshTask.routing?.projectId ?? null, deliveredAt: null,
                 };
             }
@@ -404,7 +405,7 @@ export class Reconciler extends ReconcilerReviewBase {
                         durable.chatgptThreadDelivery = {
                             kind: 'new-turn', threadId: implementationThread, threadSource: 'implementation',
                             requestId: `${current.id}:${durable.id}:${durable.executionId}`,
-                            jobId: current.id, prNumber: current.prNumber, executionId: durable.executionId,
+                            jobId: current.id, repository: current.repository, taskId: durable.id, prNumber: current.prNumber, executionId: durable.executionId,
                             projectId: durable.routing?.projectId ?? null, deliveredAt: null,
                         };
                     }
@@ -450,7 +451,7 @@ export class Reconciler extends ReconcilerReviewBase {
         const workerInput = canonicalProjectRun
             ? `${baseWorkerInput}\n\n[Canonical Neo project run]\nExecution cwd: ${executionContext.project.path}\nKeep generated artifacts under runs/.`
             : baseWorkerInput;
-        const workerTask = { ...task, input: workerInput, routing: task.routing ? { ...task.routing, cwd: executionContext.project.path } : task.routing };
+        const workerTask = { ...task, input: workerInput + taskCommentContext(task), routing: task.routing ? { ...task.routing, cwd: executionContext.project.path } : task.routing };
         const startAckSetup = task.adapter === 'chatgpt' ? await this.startAck(job.id, task.id, sourceId, Date.now(), this.options.startAckTimeoutMs ?? chatGptStartAckTimeoutMs(task.timeoutMs)) : null;
         const closePolicy = task.chatgptTabClosePolicy ?? this.options.chatgptTabClosePolicy ?? adapter.tabClosePolicy ?? 'after-start';
         const terminalWait = task.adapter === 'chatgpt' && closePolicy === 'after-terminal' ? this.terminalWait(task.id, durableExecutionId, startedAt - 1) : null;

package/dist/relayd-control.js

@@ -1,3 +1,4 @@
+import { appendTaskComment } from './task-comments.js';
 import { normalizeThreadId } from './reviewer-thread.js';
 import { supersedeCancelledTask } from './task-actions.js';
 export function createWorkspaceControl(deps) {
@@ -107,6 +108,15 @@ export function createWorkspaceControl(deps) {
             await pool.reconcileLocalJob(jobId, 'control.job.unblock');
             return await store.load(jobId);
         }
+        if (command === 'task.comment') {
+            const taskId = typeof body.taskId === 'string' ? body.taskId : '';
+            const message = typeof body.message === 'string' ? body.message : '';
+            if (!taskId || !message.trim())
+                throw new Error('task comment requires taskId and message');
+            let appended;
+            await store.mutateJob(jobId, (current) => { appended = appendTaskComment(current, taskId, message); return current; });
+            return appended;
+        }
         if (command === 'task.supersede') {
             const taskId = typeof body.taskId === 'string' ? body.taskId : '';
             const reason = typeof body.reason === 'string' ? body.reason : '';

package/dist/task-comments.js

@@ -0,0 +1,16 @@
+import { randomUUID } from 'node:crypto';
+export function appendTaskComment(job, taskId, message, author = 'cli') {
+    const task = job.tasks.find(item => item.id === taskId);
+    if (!task)
+        throw new Error(`Task ${taskId} not found`);
+    if (!message.trim())
+        throw new Error('task comment requires nonempty --message');
+    const comment = { id: randomUUID(), text: message.trim(), author, createdAt: new Date().toISOString() };
+    task.comments = [...(task.comments ?? []), comment];
+    return comment;
+}
+export function taskCommentContext(task) {
+    if (!task.comments?.length)
+        return '';
+    return '\n\n[Task comments — append-only supplementary context]\n' + task.comments.map(c => `${c.createdAt} (${c.author}, ${c.id}): ${c.text}`).join('\n');
+}

package/dist/task-context.js

@@ -0,0 +1,16 @@
+/** Resolve the execution-scoped contract from the authoritative Job snapshot. */
+export function taskExecutionContext(job, taskId, executionId) {
+    if (!executionId)
+        throw new Error('task context requires --execution-id');
+    const task = job.tasks.find(item => item.id === taskId);
+    if (!task)
+        throw new Error(`Task ${taskId} not found`);
+    if (task.executionId !== executionId || !['QUEUED', 'RUNNING'].includes(task.state))
+        throw new Error(`Stale Task execution ${taskId}/${executionId}; current state ${task.state}`);
+    return { job: { id: job.id, repository: job.repository, title: job.title, objective: job.objective,
+            projectPath: job.projectPath, state: job.state }, task, comments: task.comments ?? [], dependencies: task.dependencies.map(id => job.tasks.find(item => item.id === id) ?? { id, missing: true }),
+        plan: job.plans?.find(plan => plan.id === task.planningDecisionId) ?? null };
+}
+export function taskReferencePrompt(repository, jobId, taskId, executionId) {
+    return `[Agents Relay managed task]\nRepository: ${repository}\nJob ID: ${jobId}\nTask ID: ${taskId}\nExecution ID: ${executionId}\n\nRetrieve the authoritative task contract using the connected NeoY shell/Agents Relay CLI:\n  agents-relay task context --repo ${repository} --id ${jobId} --task-id ${taskId} --execution-id ${executionId}\nRead the returned Task input, dependencies, Plan, project context, and output requirements before execution. Check that the execution ID matches. If the CLI or context is unavailable, report blocked; never guess or execute from this envelope. Continue in this thread; Relay owns completion and review. Do not create another Job.`;
+}

package/package.json

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