agents-relay 2.0.174 → 2.0.176

package/dist/cli-artifact.js

@@ -0,0 +1,40 @@
+import { readFile } from 'node:fs/promises';
+import { Ajv } from 'ajv';
+/** Explicit, read-only validation. Projects own schemas and decide when to call it. */
+export async function validateArtifact(artifactPath, schemaPath) {
+    if (!artifactPath || !schemaPath)
+        throw new Error('artifact validate requires --artifact and --schema');
+    const [artifactText, schemaText] = await Promise.all([
+        readFile(artifactPath, 'utf8'),
+        readFile(schemaPath, 'utf8'),
+    ]);
+    const artifact = JSON.parse(artifactText);
+    const schema = JSON.parse(schemaText);
+    if (!schema || typeof schema !== 'object' || Array.isArray(schema))
+        throw new Error('Schema must be a JSON object');
+    if ('$async' in schema)
+        throw new Error('Async schemas are not supported');
+    const validate = new Ajv({ allErrors: true, strict: false }).compile(schema);
+    const valid = validate(artifact);
+    if (typeof valid !== 'boolean')
+        throw new Error('Async validation is not supported');
+    return {
+        valid,
+        errors: (validate.errors ?? []).map(error => ({
+            path: error.instancePath || '/',
+            message: error.message ?? 'invalid value',
+        })),
+    };
+}
+export async function runArtifactCommand(action, args) {
+    if (action !== 'validate')
+        throw new Error('artifact supports only validate');
+    const value = (flag) => {
+        const index = args.indexOf(flag);
+        return index < 0 ? '' : args[index + 1] ?? '';
+    };
+    const result = await validateArtifact(value('--artifact'), value('--schema'));
+    console.log(JSON.stringify(result, null, 2));
+    if (!result.valid)
+        throw new Error('Artifact validation failed');
+}

package/dist/cli-help.js

@@ -1,4 +1,4 @@
-export const usage = 'agents-relay <job|task|review|plan|blocker|projection|escalation|context|init|record|agent-register|agent-discover|status|reconcile|serve> [options]';
+export const usage = 'agents-relay <job|task|review|artifact|plan|blocker|projection|escalation|context|init|record|agent-register|agent-discover|status|reconcile|serve> [options]';
 const help = {
     root: `Agents Relay coordinates durable asynchronous agent jobs through local SQLite and workflow graphs.
 
@@ -11,6 +11,7 @@ Commands:
   job create|update|show|list|merge|unblock|cancel|pause|resume  Manage SQLite-authoritative jobs with optional GitHub PRs
   task create|update|show|list|classify|complete|retry|unblock|cancel  Manage durable tasks
   review request           Request graph-owned review (optional thread override)
+  artifact validate        Check a JSON artifact against a project-owned JSON Schema
   plan                     Invoke the Planner for an existing managed Job
   plan apply               Submit a validated Task Tree within one active Plan
   blocker add|resolve|show  Manage cross-Job blocker dependencies
@@ -60,6 +61,10 @@ Request a new SHA-bound reviewer turn through the existing Relay lifecycle.
 Usage: npx agents-relay review request --repo OWNER/REPO --pr NUMBER --id JOB_ID [--thread-id THREAD_ID]
 
 When provided, --thread-id persists a reviewer destination; otherwise the Job reviewer thread, then creator thread, then legacy review route is used. The command wakes Relay. Review Task creation, idempotency, routing and delivery remain graph/daemon-owned. Rejects in-flight/queued reviews; does not itself mark review delivered.`,
+    artifact: `Check a JSON artifact against a project-owned JSON Schema. Read-only; does not affect Task state or planning.
+
+Usage: agents-relay artifact validate --artifact PATH --schema PATH
+Exit 0 on PASS, 1 on schema mismatch or invalid input. Returns JSON { valid, errors }.`,
     'review run': `Evaluate the calling Agent's requested outcome inside its Worker. A generic Outcome Reviewer runs by default; --agents adds comma-separated professional roles found in the project or shared agent catalog. Does not create Relay Tasks or trigger Final Review.
 
 Usage: agents-relay review run (--prompt TEXT | --prompt-file PATH) [--project-path DIR] [--agents role,role] [--output PATH]

package/dist/cli.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { runArtifactCommand } from './cli-artifact.js';
 import { runWorkflowAction } from './cli-workflow-action.js';
 import { workflowCliResult } from './cli-workflow.js';
 import { configureLocalGitMerge } from './cli-local-merge-config.js';
@@ -743,6 +744,11 @@ async function main() {
         await runJobCommand(action ?? '', jobArgs);
         return;
     }
+    if (command === 'artifact') {
+        const [action, ...artifactArgs] = args;
+        await runArtifactCommand(action ?? '', artifactArgs);
+        return;
+    }
     if (command === 'task') {
         const [action, ...taskArgs] = args;
         await runTaskCommand(action ?? '', taskArgs);

package/dist/planner.js

@@ -106,7 +106,6 @@ export function materializePlannerChild(job, planner, spec, executionContext) {
     const round = 'round' in planner ? planner.round : planner.planningRound ?? 1;
     const plannerHeadSha = 'round' in planner ? planner.headSha : undefined;
     const reviewHeadSha = spec.agentName === 'reviewer' && !(spec.dependencies?.length) ? plannerHeadSha ?? job.headSha : undefined;
-    const objectiveRoot = spec.agentName === 'reviewer' ? job.tasks.find(task => task.kind !== 'planner' && task.agentName !== 'reviewer' && task.agentName !== 'troubleshooter' && !task.parentTaskId) : undefined;
     const resolution = spec.resolution;
     if (resolution) {
         const target = resolution.targetTaskId ? job.tasks.find(task => task.id === resolution.targetTaskId) : undefined;
@@ -114,7 +113,7 @@ export function materializePlannerChild(job, planner, spec, executionContext) {
             throw new Error(`Planner resolution for ${spec.id} must target one unresolved durable Task`);
     }
     const reviewerThread = spec.agentName === 'reviewer' ? prepareReviewerThreadDelivery(job, { id: spec.id, agentName: spec.agentName, reviewHeadSha }) : undefined, implementationThread = (spec.agentName === 'implementation' || spec.agentName == null) && job.implementationThreadId ? job.implementationThreadId : undefined, threadOwned = Boolean(reviewerThread || implementationThread);
-    return createTaskEntity(job, { jobId: job.id, id: spec.id, title: spec.agentName === 'reviewer' ? 'Review' : spec.title, kind: 'work', priority: spec.priority ?? job.priority, storySize: spec.storySize ?? 'M', projectName: spec.projectName, agentName: spec.agentName, agentGraph: spec.agentGraph, review: spec.review, parentTaskId: objectiveRoot?.id ?? spec.parentTaskId ?? null, dependencies: spec.dependencies ?? [], capabilities: spec.capabilities ?? [], workerRequirements: threadOwned ? chatgptThreadRequirements(spec.workerRequirements) : spec.workerRequirements, adapter: threadOwned ? 'chatgpt' : (spec.adapter ?? 'codex'), chatgptThreadDelivery: reviewerThread, input: spec.input, output: spec.output, continuation: spec.continuation ?? null, continuationDeliveredAt: null, attempt: 0, maxAttempts: spec.maxAttempts ?? 3, leaseOwner: null, leaseExpiresAt: null, executionId: null, threadId: null, result: null, plannerResult: null, error: null, timeoutMs: spec.timeoutMs ?? taskOverallTimeoutMs(spec.storySize ?? 'M'), createdAt: now, updatedAt: now, planningDecisionId: decisionId, planningSource: source, planningRound: round, reviewHeadSha, resolution: resolution ? { ...resolution, state: 'proposed', owner: 'planner', updatedAt: now } : undefined });
+    return createTaskEntity(job, { jobId: job.id, id: spec.id, title: spec.agentName === 'reviewer' ? 'Review' : spec.title, kind: 'work', priority: spec.priority ?? job.priority, storySize: spec.storySize ?? 'M', projectName: spec.projectName, agentName: spec.agentName, agentGraph: spec.agentGraph, review: spec.review, parentTaskId: spec.agentName === 'reviewer' ? null : spec.parentTaskId ?? null, dependencies: spec.dependencies ?? [], capabilities: spec.capabilities ?? [], workerRequirements: threadOwned ? chatgptThreadRequirements(spec.workerRequirements) : spec.workerRequirements, adapter: threadOwned ? 'chatgpt' : (spec.adapter ?? 'codex'), chatgptThreadDelivery: reviewerThread, input: spec.input, output: spec.output, continuation: spec.continuation ?? null, continuationDeliveredAt: null, attempt: 0, maxAttempts: spec.maxAttempts ?? 3, leaseOwner: null, leaseExpiresAt: null, executionId: null, threadId: null, result: null, plannerResult: null, error: null, timeoutMs: spec.timeoutMs ?? taskOverallTimeoutMs(spec.storySize ?? 'M'), createdAt: now, updatedAt: now, planningDecisionId: decisionId, planningSource: source, planningRound: round, reviewHeadSha, resolution: resolution ? { ...resolution, state: 'proposed', owner: 'planner', updatedAt: now } : undefined });
 }
 export function planningSpec(task) {
     if (!task.output)

package/dist/reconciler-review.js

@@ -153,7 +153,7 @@ export class ReconcilerReviewBase extends ReconcilerRuntimeBase {
         ].join('\n\n');
         const task = createTaskEntity(job, {
             jobId: job.id, id, title: 'Review', kind: 'work', priority: job.priority, storySize: 'M', projectName: job.title, agentName: 'reviewer',
-            parentTaskId: reviewGateTasks.find(item => !item.parentTaskId)?.id ?? null, dependencies: reviewGateTasks.map(item => item.id), capabilities: ['review'],
+            parentTaskId: null, dependencies: reviewGateTasks.map(item => item.id), capabilities: ['review'],
             workerSelection: reviewerRouting.selection, adapter: reviewerRouting.candidate.adapter,
             input,
             output: { kind: 'task_pr' }, routing: reviewerRouting.candidate.routing, continuation: null, continuationDeliveredAt: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-relay",
-  "version": "2.0.174",
+  "version": "2.0.176",
   "description": "Durable async agent jobs coordinated through GitHub pull requests",
   "repository": {
     "type": "git",
@@ -45,5 +45,8 @@
     "workflow",
     "README.md",
     "LICENSE"
-  ]
+  ],
+  "dependencies": {
+    "ajv": "^8.20.0"
+  }
 }