agents-relay 2.0.88 → 2.0.90

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,9 @@ 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 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', '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,13 @@ async function runTaskCommand(action, args) {
             return;
         }
         const taskId = arg(args, '--task-id');
+        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/reconciler.js

@@ -375,7 +375,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 +404,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,
                         };
                     }

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, 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.88",
+  "version": "2.0.90",
   "description": "Durable async agent jobs coordinated through GitHub pull requests",
   "type": "module",
   "bin": {