agents-relay 1.0.111 → 1.0.113

package/dist/cli-help.js

@@ -44,7 +44,7 @@ Example:
 
 Required: --repo OWNER/REPO, --id JOB_ID, and either --head BRANCH or --pr NUMBER.
 With --head, reuse/create the PR for that head. With --pr, bind an existing unmanaged PR.
-Common: --base BRANCH (default: main), --title TEXT, --objective-file PATH|- (preferred), --objective MARKDOWN (short/simple only), --priority P0|P1|P2|P3, --mode fixed|autonomous, --no-auto-merge, --no-review. --objective and --objective-file are mutually exclusive. For a new --head Job, one is required and must contain enough standalone context to complete the Job without the originating chat/thread. Objective Markdown is also the default PR body; --body is an explicit override.
+Common: --base BRANCH (default: main), --title TEXT, --objective-file PATH|- (preferred), --objective MARKDOWN (short/simple only), --project-path RELATIVE_PATH, --priority P0|P1|P2|P3, --mode fixed|autonomous, --no-auto-merge, --no-review. --objective and --objective-file are mutually exclusive. For a new --head Job, one is required and must contain enough standalone context to complete the Job without the originating chat/thread. Objective Markdown is also the default PR body; --body is an explicit override.
 Job creation never creates executable tasks. The orchestrator decides the initial task batch separately. Re-running create against an already healthy Job is idempotent and does not mutate its metadata.
 
 Example:
@@ -52,7 +52,7 @@ Example:
     'job update': `Partially update mutable metadata on a healthy existing Job.
 
 Required: --repo OWNER/REPO, --pr NUMBER, and --id JOB_ID.
-Mutable: --title, --objective-file PATH|- (preferred) or --objective MARKDOWN, --priority, --mode fixed|autonomous, --schedule, --auto-merge|--no-auto-merge, --review|--no-review, and continuation options. Updating the objective also updates the PR body.
+Mutable: --title, --objective-file PATH|- (preferred) or --objective MARKDOWN, --project-path RELATIVE_PATH, --priority, --mode fixed|autonomous, --schedule, --auto-merge|--no-auto-merge, --review|--no-review, and continuation options. Updating the objective also updates the PR body.
 Unspecified fields are preserved. Marker/binding corruption is never repaired implicitly; update fails with a precise diagnostic instead.
 
 Example:

package/dist/cli.js

@@ -18,7 +18,7 @@ import { AgentObjectivePlanner, CommandObjectivePlanner } from './planner.js';
 import { extendRetryBudget, transitionJobEvent, transitionTaskEvent } from './scheduler.js';
 import { dueBuckets, processDueScheduledJobs, syncScheduleLabels } from './scheduled-jobs.js';
 import { resolveExecutionContext } from './execution-context.js';
-import { defaultWorkspaceRoot, resolveManagedProjectPath } from './workspace.js';
+import { defaultWorkspaceRoot, resolveManagedProjectPath, resolveRepositoryProjectPath } from './workspace.js';
 import { runBlockerCommand } from './cli-blocker.js';
 import { helpText, usage } from './cli-help.js';
 export { helpText } from './cli-help.js';
@@ -44,6 +44,7 @@ export async function ensureManagedGitHubJob(client, repositoryName, trustedAuth
         id: options.id,
         title: options.title || pr.title || 'Agents Relay job',
         objective: options.objective || pr.body || undefined,
+        projectPath: options.projectPath,
         description: pr.body || undefined,
         priority: options.priority ?? 'P2',
         executionMode: options.executionMode ?? 'fixed',
@@ -179,8 +180,11 @@ async function runTaskCommand(action, args) {
         return;
     }
     if (action === 'retry' || action === 'cancel') {
-        if (action === 'retry')
+        if (action === 'retry') {
             task.maxAttempts = extendRetryBudget(task);
+            if (task.kind === 'planner' && task.error)
+                task.plannerRetryFeedback = task.error;
+        }
         await transitionTaskEvent(task, action === 'retry' ? 'retry' : task.state === 'RUNNING' ? 'task.cancelled' : 'cancel');
         task.error = action === 'retry' ? null : 'Cancelled by user';
         task.leaseOwner = null;
@@ -323,6 +327,7 @@ async function runJobCommand(action, args) {
             id,
             title: arg(args, '--title') || undefined,
             objective: objective || undefined,
+            projectPath: arg(args, '--project-path') || undefined,
             priority: priority(args),
             executionMode: requestedExecutionMode(args),
             schedule: scheduleFromArgs(args),
@@ -382,6 +387,8 @@ async function runJobCommand(action, args) {
             throw new Error('Job objective cannot be empty');
         job.objective = objective;
     }
+    if (hasArg(args, '--project-path'))
+        job.projectPath = arg(args, '--project-path') || undefined;
     if (hasArg(args, '--priority'))
         job.priority = priority(args, job.priority ?? 'P2');
     if (hasArg(args, '--mode') || hasArg(args, '--execution-mode'))
@@ -414,7 +421,7 @@ async function runJobCommand(action, args) {
 }
 export function runtimePlanner(args) { const plannerCommand = arg([...args], '--planner-command'); const modelRuntime = arg([...args], '--codex', 'codex'); return plannerCommand ? new CommandObjectivePlanner(plannerCommand) : new AgentObjectivePlanner(modelRuntime); }
 export function runtimeReviewer() { return { requirements: { capabilities: ['model'] } }; }
-export function runtime(store, args, bus, usageRegistry = codexAndZaiUsageRegistry()) { const emit = (event) => { process.stderr.write(`${JSON.stringify(event)}\n`); }; const modelRuntime = arg(args, '--codex', 'codex'); const policy = chatGptTabClosePolicy(args); const planner = runtimePlanner(args); return new Reconciler(store, { owner: arg(args, '--owner', `cli-${process.pid}`), maxConcurrent: Number(arg(args, '--concurrency', '4')), leaseMs: Number(arg(args, '--lease-ms', '300000')), adapters: [new CodexAdapter(modelRuntime), new ChatGptAdapter({ tabClosePolicy: policy })], continuations: [new CodexThreadContinuation(modelRuntime), new CommandContinuation(), new WebhookContinuation()], planner, usageSnapshotProvider: () => usageRegistry.snapshot(), decisionEngine: new LayaCliDecisionEngine(), decisionMode: decisionMode(), reviewer: runtimeReviewer(), eventBus: bus, emit, chatgptTabClosePolicy: policy, projectPathForJob: job => resolveManagedProjectPath(job.repository, arg(args, '--project-path'), arg(args, '--workspace-root') || defaultWorkspaceRoot()) }); }
+export function runtime(store, args, bus, usageRegistry = codexAndZaiUsageRegistry()) { const emit = (event) => { process.stderr.write(`${JSON.stringify(event)}\n`); }; const modelRuntime = arg(args, '--codex', 'codex'); const policy = chatGptTabClosePolicy(args); const planner = runtimePlanner(args); return new Reconciler(store, { owner: arg(args, '--owner', `cli-${process.pid}`), maxConcurrent: Number(arg(args, '--concurrency', '4')), leaseMs: Number(arg(args, '--lease-ms', '300000')), adapters: [new CodexAdapter(modelRuntime), new ChatGptAdapter({ tabClosePolicy: policy })], continuations: [new CodexThreadContinuation(modelRuntime), new CommandContinuation(), new WebhookContinuation()], planner, usageSnapshotProvider: () => usageRegistry.snapshot(), decisionEngine: new LayaCliDecisionEngine(), decisionMode: decisionMode(), reviewer: runtimeReviewer(), eventBus: bus, emit, chatgptTabClosePolicy: policy, projectPathForJob: async (job) => resolveRepositoryProjectPath(await resolveManagedProjectPath(job.repository, arg(args, '--project-path'), arg(args, '--workspace-root') || defaultWorkspaceRoot()), job.projectPath) }); }
 export function dashboardTaskAction(store, reconciler, action) {
     return async (jobId, taskId) => {
         const job = await store.load(jobId);

package/dist/planner.js

@@ -147,7 +147,7 @@ export function plannerInput(context) {
         boundaries: agent.restrictions,
         runtime: agent.runtime,
     }));
-    return JSON.stringify({ objective: context.objective, 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 })) });
+    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 })) });
 }
 export class CommandObjectivePlanner {
     command;

package/dist/reconciler.js

@@ -444,7 +444,10 @@ export class Reconciler extends ReconcilerReviewBase {
         let promise;
         try {
             const executionContext = await this.resolvedContext(job, task, 'planner');
-            promise = planner.plan({ job, tasks: job.tasks, objective: job.objective ?? job.description ?? job.title, previousPlannerTaskId: task.parentTaskId, executionContext }, controller.signal);
+            const context = { job, tasks: job.tasks, objective: job.objective ?? job.description ?? job.title, previousPlannerTaskId: task.parentTaskId, executionContext, retryFeedback: task.plannerRetryFeedback };
+            task.input = plannerInput(context);
+            await this.store.saveTask(task);
+            promise = planner.plan(context, controller.signal);
         }
         catch (error) {
             await this.finishPlanner(job.id, task.id, executionId, error instanceof Error ? error : new Error(String(error)));
@@ -465,6 +468,7 @@ export class Reconciler extends ReconcilerReviewBase {
         if (task.state === 'CANCELLED')
             return;
         if (error) {
+            task.plannerRetryFeedback = error.message;
             task.error = error.message;
             task.leaseOwner = null;
             task.leaseExpiresAt = null;
@@ -490,6 +494,7 @@ export class Reconciler extends ReconcilerReviewBase {
             task.plannerResult = result;
             task.result = { summary: result.assessment, data: { objective_status: result.objective_status, next_tasks: result.next_tasks } };
             task.error = null;
+            task.plannerRetryFeedback = undefined;
             task.leaseOwner = null;
             task.leaseExpiresAt = null;
             task.executionId = null;
@@ -508,6 +513,7 @@ export class Reconciler extends ReconcilerReviewBase {
                 await this.emit(eventFor(job.id, task.id, task.parentTaskId, 'planner.children_failed', 'failed', `Planner ${task.id} child materialization failed: ${message}`, 'user'));
             }
             else {
+                task.plannerRetryFeedback = message;
                 task.error = message;
                 task.leaseOwner = null;
                 task.leaseExpiresAt = null;

package/dist/relayd.js

@@ -13,7 +13,7 @@ import { dashboardManagedJobs, GitHubStore, InMemoryStore, loadManagedGitHubPull
 import { githubAuthContext } from './github-auth.js';
 import { dashboardJobAction, dashboardTaskAction, isEntrypoint, runtimePlanner, runtimeReviewer, startService, SERVICE_DEFAULTS } from './cli.js';
 import { codexAndZaiUsageRegistry } from './usage.js';
-import { defaultWorkspaceRoot, discoverWorkspaceRepositories, resolveManagedProjectPath } from './workspace.js';
+import { defaultWorkspaceRoot, discoverWorkspaceRepositories, resolveManagedProjectPath, resolveRepositoryProjectPath } from './workspace.js';
 import { deriveJobRuntimeStatus } from './runtime-status.js';
 import { decisionMode, LayaCliDecisionEngine } from './decision.js';
 import { JsonlDecisionAuditStore } from './decision-audit.js';
@@ -76,7 +76,7 @@ export async function runDaemon(argv) {
     const usageRegistry = codexAndZaiUsageRegistry();
     const decisionAuditStore = new JsonlDecisionAuditStore(process.env.AGENTS_RELAY_DECISION_AUDIT_PATH ?? join(homedir(), '.agents-relay', 'decision-audit.jsonl'));
     let cachedOverviews = [];
-    const makeReconciler = (store, maxConcurrent) => new Reconciler(store, { owner: `relayd-${process.pid}`, maxConcurrent, leaseMs: Number(value(argv, '--lease-ms', '300000')), adapters: [new CodexAdapter(value(argv, '--codex', 'codex')), new ChatGptAdapter()], continuations: [new CodexThreadContinuation(value(argv, '--codex', 'codex')), new CommandContinuation(), new WebhookContinuation()], planner: runtimePlanner(argv), usageSnapshotProvider: () => usageRegistry.snapshot(), runtimeSummaryProvider: () => ({ chatgptRunning: summarizeRuntime(cachedOverviews.map(item => item.job)).workers.chatgpt }), decisionEngine: new LayaCliDecisionEngine(), decisionMode: decisionMode(), decisionAuditStore, eventBus: bus, reviewer: runtimeReviewer(), projectPathForJob: job => repositoryPaths.get(job.repository) ?? resolveManagedProjectPath(job.repository, explicitProjectPath, workspaceRoot) });
+    const makeReconciler = (store, maxConcurrent) => new Reconciler(store, { owner: `relayd-${process.pid}`, maxConcurrent, leaseMs: Number(value(argv, '--lease-ms', '300000')), adapters: [new CodexAdapter(value(argv, '--codex', 'codex')), new ChatGptAdapter()], continuations: [new CodexThreadContinuation(value(argv, '--codex', 'codex')), new CommandContinuation(), new WebhookContinuation()], planner: runtimePlanner(argv), usageSnapshotProvider: () => usageRegistry.snapshot(), runtimeSummaryProvider: () => ({ chatgptRunning: summarizeRuntime(cachedOverviews.map(item => item.job)).workers.chatgpt }), decisionEngine: new LayaCliDecisionEngine(), decisionMode: decisionMode(), decisionAuditStore, eventBus: bus, reviewer: runtimeReviewer(), projectPathForJob: async (job) => resolveRepositoryProjectPath(repositoryPaths.get(job.repository) ?? await resolveManagedProjectPath(job.repository, explicitProjectPath, workspaceRoot), job.projectPath) });
     if (repositories.length === 0)
         throw new Error(`No Git repositories with GitHub origins found under ${normalized.workspaceRoot ?? defaultWorkspaceRoot()}`);
     const pool = new RepositoryWorkerPool(client, repositories, trusted, concurrency, makeReconciler);

package/dist/workspace.js

@@ -1,5 +1,5 @@
 import { mkdir, readdir, stat } from 'node:fs/promises';
-import { dirname, join, relative, resolve } from 'node:path';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
 import { homedir } from 'node:os';
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
@@ -75,11 +75,24 @@ export async function resolveManagedProjectPath(repository, explicitProjectPath
         return resolve(explicitProjectPath);
     return repository ? resolveWorkspaceRepositoryPath(repository, root) : resolve(cwd);
 }
+export function resolveRepositoryProjectPath(repositoryRoot, projectPath) {
+    const root = resolve(repositoryRoot);
+    if (!projectPath)
+        return root;
+    if (isAbsolute(projectPath))
+        throw new Error('Job projectPath must be repository-relative');
+    const target = resolve(root, projectPath);
+    const rel = relative(root, target);
+    if (rel === '..' || rel.startsWith('..' + sep) || isAbsolute(rel))
+        throw new Error('Job projectPath escapes repository root');
+    return target;
+}
 async function git(path, args) {
     return (await execFileAsync('git', ['-C', path, ...args])).stdout.trim();
 }
 export async function prepareManagedExecutionWorktree(projectPath, repository, prNumber, head, executionId) {
     const primary = await git(projectPath, ['rev-parse', '--show-toplevel']);
+    const projectRelative = (await git(projectPath, ['rev-parse', '--show-prefix'])).replace(/\/$/, '');
     const remote = await git(primary, ['config', '--get', 'remote.origin.url']);
     if (githubRepositoryFromRemote(remote) !== repository)
         throw new Error(`Primary checkout ${primary} does not match ${repository}`);
@@ -96,7 +109,7 @@ export async function prepareManagedExecutionWorktree(projectPath, repository, p
         const existingHead = await git(worktree, ['rev-parse', 'HEAD']);
         if (resolve(existingRoot) !== resolve(worktree) || existingHead !== head.sha)
             throw new Error(`Existing execution worktree ${worktree} is not the expected PR head`);
-        return worktree;
+        return projectRelative ? join(worktree, projectRelative) : worktree;
     }
     catch (error) {
         try {
@@ -104,7 +117,7 @@ export async function prepareManagedExecutionWorktree(projectPath, repository, p
         }
         catch {
             await git(primary, ['worktree', 'add', '--detach', worktree, head.sha]);
-            return worktree;
+            return projectRelative ? join(worktree, projectRelative) : worktree;
         }
         throw error;
     }

package/package.json

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