agents-relay 1.0.90 → 1.0.92

package/dist/cli-help.js

@@ -0,0 +1,192 @@
+export const usage = 'agents-relay <job|task|context|init|record|agent-register|agent-discover|reconcile|tick|serve> [options]';
+const help = {
+    root: `Agents Relay coordinates durable asynchronous agent jobs through GitHub pull requests.
+
+Usage:
+  npx agents-relay <command> [options]
+
+Commands:
+  job create|update|show|list|merge|cancel  Manage durable GitHub-backed jobs
+  task create|update|show|list|complete|retry|cancel  Manage durable tasks
+  context resolve          Resolve shared project instructions, skills, agents, and runtimes
+  init                     Create a local demo job or initialize a GitHub job
+  record                   Backfill a completed task into durable history
+  agent-register           Register an agent role and its capabilities
+  agent-discover           Find registered agents matching hard filters
+  reconcile                Run reconciliation once
+  tick                     Run the indexed autonomous scheduler heartbeat
+  serve                    Run the dashboard and reconciliation service
+
+Run 'npx agents-relay <command> --help' for command options and examples.
+Use 'node dist/cli.js' only for explicit local development/demo mode.`,
+    job: `Manage GitHub-backed durable jobs.
+
+Usage:
+  npx agents-relay job <create|update|show|list|merge|cancel> [options]
+
+Actions:
+  create  Create a durable Job, optionally binding an existing unmanaged PR
+  update  Partially update mutable metadata on a healthy existing Job
+  show    Show one durable Job
+  list    List managed Jobs in a repository
+  merge   Merge the backing PR and complete the Job
+  cancel  Close the backing PR and cancel the Job
+
+Common options:
+  --repo OWNER/REPO       GitHub repository
+  --id JOB_ID             Durable job identifier
+  --pr NUMBER             Existing PR number
+
+Example:
+  npx agents-relay job show --repo OWNER/REPO --pr 12 --id job-1`,
+    'job create': `Create a durable Job and its trusted marker.
+
+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.
+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:
+  npx agents-relay job create --repo OWNER/REPO --head feat/example --base main --id job-1 --title "Objective" --objective-file job.md`,
+    '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.
+Unspecified fields are preserved. Marker/binding corruption is never repaired implicitly; update fails with a precise diagnostic instead.
+
+Example:
+  npx agents-relay job update --repo OWNER/REPO --pr 12 --id job-1 --priority P0 --no-auto-merge`,
+    'job show': `Show one durable Job.
+
+Required: --repo OWNER/REPO, --pr NUMBER, and --id JOB_ID.
+
+Example:
+  npx agents-relay job show --repo OWNER/REPO --pr 12 --id job-1`,
+    'job list': `List managed Jobs in a repository.
+
+Required: --repo OWNER/REPO.
+
+Example:
+  npx agents-relay job list --repo OWNER/REPO`,
+    'job merge': `Merge the backing pull request and complete the durable Job.
+
+Required: --repo OWNER/REPO, --pr NUMBER, and --id JOB_ID. The current PR head SHA is pinned into the merge request.`,
+    'job cancel': `Cancel the durable Job and close its backing pull request.
+
+Required: --repo OWNER/REPO, --pr NUMBER, and --id JOB_ID. Nonterminal Tasks are cancelled before the PR is closed.`,
+    task: `Manage durable tasks.
+
+Usage:
+  npx agents-relay task <create|update|show|list|retry|cancel> [options]
+
+Actions:
+  create  Create one durable Task under an existing Job
+  update  Update mutable Task fields
+  show    Show one Task
+  list    List Tasks for a Job
+  retry   Retry a failed or blocked Task
+  complete Complete an orchestrator-owned Task
+  cancel  Cancel a Task`,
+    'task create': `Create one durable Task under an existing Job.
+
+Required: normal Job storage options plus --input-file PATH|- (preferred) or --input MARKDOWN, and --output task-pr|file. --input and --input-file are mutually exclusive. Codex/ChatGPT tasks also require --model MODEL.
+Common: --task-id ID, --adapter codex|chatgpt|orchestrator, --priority P0|P1|P2|P3, --story-size S|M|L, --agent NAME, --agent-graph-file PATH|-, --deps a,b, --parent ID, --draft.\nTasks with dependencies start DRAFT; tasks without dependencies start QUEUED unless --draft is given.
+Directly-created Tasks are not wrapped in a synthetic Plan. Planner-generated Tasks are created internally by Relay from planner output.
+
+Example:
+  npx agents-relay task create --repo OWNER/REPO --pr 12 --id job-1 --task-id build --adapter codex --provider openai --model MODEL --output task-pr --input-file task.md`,
+    'task update': `Update mutable durable Task fields in place.
+
+Required: --task-id ID and the normal Job storage options.
+Mutable while not RUNNING/SUCCEEDED/CANCELLED: --adapter, --priority, --story-size, --input-file PATH|- or --input MARKDOWN, --project, --agent, --agent-graph-file PATH|-, --parent, --deps, --capabilities, --timeout, --max-attempts, --provider, --model, --profile, --reasoning, --cwd, --chatgpt-project, --chatgpt-tab-close-policy, --draft, --queue.
+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 show': `Show one durable Task.
+
+Required: --task-id ID and the normal Job storage options.`,
+    'task list': `List durable Tasks for one Job.
+
+Required: the normal Job storage options.`,
+    'task complete': `Complete one orchestrator-owned Task after the creating orchestrator has finished the work.
+
+Required: --task-id ID, --summary TEXT, and the normal Job storage options. The Task must use adapter=orchestrator and be QUEUED or RUNNING. This command is for the same orchestrator turn that created the self-task; it is not a deferred handoff mechanism.`,
+    'task retry': `Retry one durable Task.
+
+Required: --task-id ID and the normal Job storage options.`,
+    'task cancel': `Cancel one durable Task.
+
+Required: --task-id ID and the normal Job storage options.`,
+    context: `Resolve the shared execution context used by XChat and Relay.
+
+Usage:
+  npx agents-relay context resolve --project-path PATH --role ROLE [options]
+
+Actions:
+  resolve  Resolve instructions, visible skills/agents, and runtime/delegation metadata`,
+    'context resolve': `Resolve shared execution context without creating durable state.
+
+Required: --project-path PATH.
+Common: --role orchestrator|planner|reviewer|worker|nested-worker, --skills a,b, --agents a,b.
+Root overrides for testing/configuration: --workspace-root PATH, --neo-root PATH|none, --global-root PATH.
+
+Example:
+  npx agents-relay context resolve --project-path ~/Workspace/agents-relay --role orchestrator`,
+    record: `Backfill work completed outside the relay into durable history.
+
+Required: --file PATH or --repo/--pr/--id, plus --summary TEXT.
+Common: --task-id ID, --commit SHA, --project NAME.
+
+Example:
+  npx agents-relay record --file .agents-relay.json --summary "Built release" --commit abc123`,
+    reconcile: `Reconcile a job once, launching ready tasks and persisting results.
+
+Required: --file PATH for local demo mode, or --repo OWNER/REPO --pr NUMBER --id JOB_ID.
+
+Example:
+  npx agents-relay reconcile --repo OWNER/REPO --pr 12 --id job-1`,
+    tick: `Process autonomous jobs indexed into current/recent GitHub next-run buckets.
+
+Required: --repo OWNER/REPO.
+Common: --lookback-buckets N (default 3).
+
+Example:
+  npx agents-relay tick --repo OWNER/REPO`,
+    init: `Initialize a new job. GitHub mode requires --repo and --pr; local mode requires explicit --file.
+
+Common: --id ID, --title TEXT, --objective TEXT, --mode fixed|autonomous, --priority P0|P1|P2|P3.
+
+Example:
+  npx agents-relay init --repo OWNER/REPO --pr 12 --id job-1 --title "Objective"`,
+    serve: `Run the dashboard and reconciliation service for a managed job.
+
+Required: --file PATH for local demo mode, or --repo OWNER/REPO --pr NUMBER --id JOB_ID.
+Common: --port PORT, --interval MS, --events nats.
+
+Example:
+  npx agents-relay serve --repo OWNER/REPO --pr 12 --id job-1`,
+    'agent-register': `Register an agent role and its execution endpoint.
+
+Required: --file PATH or managed GitHub options, plus --name NAME --responsibility TEXT --role ROLE --endpoint TARGET.
+Common: --capabilities a,b, --runtime shell|codex|chatgpt, --provider NAME, --model NAME.
+
+Example:
+  npx agents-relay agent-register --file .agents-relay.json --name builder --responsibility "Build code" --role engineer --endpoint shell`,
+    'agent-discover': `Find registered agents using hard filters.
+
+Required: --file PATH or managed GitHub options.
+Common: --capabilities a,b, --runtime NAME, --availability available,busy, --task-kind NAME, --explore.
+
+Example:
+  npx agents-relay agent-discover --file .agents-relay.json --capabilities shell`,
+};
+export function helpText(command, action) {
+    if (command === 'job')
+        return action ? help[`job ${action}`] ?? help.job : help.job;
+    if (command === 'task')
+        return action ? help[`task ${action}`] ?? help.task : help.task;
+    if (command === 'context')
+        return action ? help[`context ${action}`] ?? help.context : help.context;
+    return command ? help[command] ?? help.root : help.root;
+}

package/dist/cli-support.js

@@ -0,0 +1,103 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { InMemoryStore, GitHubStore } from './store.js';
+import { githubAuthContext } from './github-auth.js';
+import { NatsEventBus, eventFor } from './events.js';
+import { parseJobSchedule } from './scheduler.js';
+export const SERVICE_DEFAULTS = { port: 8787, watchdogMs: 300000, webhookWatchdogMs: 1800000, dashboardRefreshMs: 300000 };
+export class ServiceEventBus {
+    upstream;
+    unsubscribers = new Set();
+    constructor(upstream) {
+        this.upstream = upstream;
+    }
+    async publish(event) { await this.upstream.publish(event); }
+    async subscribe(jobId, wake) {
+        const unsubscribe = await this.upstream.subscribe(jobId, wake);
+        this.unsubscribers.add(unsubscribe);
+        return async () => { this.unsubscribers.delete(unsubscribe); await unsubscribe(); };
+    }
+    async subscribeAll(wake) {
+        const unsubscribe = await this.upstream.subscribeAll(wake);
+        this.unsubscribers.add(unsubscribe);
+        return async () => { this.unsubscribers.delete(unsubscribe); await unsubscribe(); };
+    }
+    async close() {
+        const pending = [...this.unsubscribers].map(unsubscribe => unsubscribe());
+        this.unsubscribers.clear();
+        await Promise.all(pending);
+    }
+}
+export function arg(args, name, fallback = '') { const index = args.indexOf(name); return index >= 0 ? args[index + 1] ?? fallback : fallback; }
+export function hasArg(args, name) { return args.includes(name); }
+async function readStdinText() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
+    return Buffer.concat(chunks).toString('utf8');
+}
+export async function textOption(args, inlineFlag, fileFlag) {
+    if (hasArg(args, inlineFlag) && hasArg(args, fileFlag))
+        throw new Error(`${inlineFlag} and ${fileFlag} are mutually exclusive`);
+    if (hasArg(args, fileFlag)) {
+        const path = arg(args, fileFlag);
+        if (!path)
+            throw new Error(`${fileFlag} requires a path or - for stdin`);
+        return path === '-' ? readStdinText() : readFile(path, 'utf8');
+    }
+    return arg(args, inlineFlag);
+}
+export function integerArg(args, name, fallback) { if (!hasArg(args, name))
+    return fallback; const value = Number(arg(args, name)); if (!Number.isInteger(value) || value < 0)
+    throw new Error(`${name} must be a non-negative integer`); return value; }
+export function repository(args) { const value = arg(args, '--repo'); if (!value)
+    throw new Error('--repo is required for GitHub-backed operation'); return value; }
+export function pullRequest(args) { const value = Number(arg(args, '--pr')); if (!Number.isInteger(value) || value <= 0)
+    throw new Error('--pr is required for GitHub-backed operation'); return value; }
+async function localStore(file) { const parsed = JSON.parse(await readFile(file, 'utf8')); const store = new InMemoryStore(parsed); return { store, job: await store.load(parsed.id) }; }
+export async function githubStore(args) { const auth = await githubAuthContext(args); return new GitHubStore(auth.client, repository(args), pullRequest(args), auth.trustedAuthors); }
+export async function storeFor(args) { const repo = arg(args, '--repo'); const pr = arg(args, '--pr'); if (repo && pr) {
+    const store = await githubStore(args);
+    const jobId = arg(args, '--id');
+    if (!jobId)
+        throw new Error('--id is required for GitHub-backed operation');
+    return { store, job: await store.load(jobId), localFile: null };
+} const file = arg(args, '--file'); if (!file)
+    throw new Error('Local mode is demo/test only; pass --file explicitly'); const loaded = await localStore(file); return { store: loaded.store, job: loaded.job, localFile: file }; }
+export async function saveLocal(file, job) { if (file)
+    await writeFile(file, JSON.stringify(job, null, 2)); }
+export function eventBus(args) { if (arg(args, '--events') !== 'nats')
+    return undefined; return new NatsEventBus(arg(args, '--nats-url', 'nats://127.0.0.1:4222'), arg(args, '--subject-prefix', 'neo.events.job')); }
+export async function publishWake(bus, job, taskId, message) { if (!bus)
+    return; try {
+    await bus.publish(eventFor(job.id, taskId, null, 'job.wake', 'queued', message, 'orchestrator', { repository: job.repository, prNumber: job.prNumber }));
+}
+catch (error) {
+    process.stderr.write(`warning: event wake unavailable: ${error instanceof Error ? error.message : String(error)}\n`);
+} }
+export function priority(args, fallback = 'P2') { const value = arg(args, '--priority', fallback); if (!['P0', 'P1', 'P2', 'P3'].includes(value))
+    throw new Error('--priority must be P0, P1, P2, or P3'); return value; }
+export function storySize(args, fallback = 'M') { const value = arg(args, '--story-size', fallback).toUpperCase(); if (!['S', 'M', 'L'].includes(value))
+    throw new Error('--story-size must be S, M, or L'); return value; }
+export function executionMode(args, fallback = 'fixed') { const value = arg(args, '--mode', arg(args, '--execution-mode', fallback)); if (value !== 'fixed' && value !== 'autonomous')
+    throw new Error('--mode must be fixed or autonomous'); return value; }
+export function chatGptTabClosePolicy(args) {
+    const value = arg(args, '--chatgpt-tab-close-policy', process.env.AGENTS_RELAY_CHATGPT_TAB_CLOSE_POLICY || 'after-start');
+    if (!['after-start', 'never', 'after-terminal'].includes(value))
+        throw new Error('--chatgpt-tab-close-policy must be after-start, never, or after-terminal');
+    return value;
+}
+export function requestedExecutionMode(args) { const value = arg(args, '--mode', arg(args, '--execution-mode')); return value ? executionMode(args) : undefined; }
+export function continuation(args) { const kind = arg(args, '--continue-kind'); const target = arg(args, '--continue-target'); return kind && target ? { kind: kind, target, input: arg(args, '--continue-input') || undefined } : null; }
+export function scheduleFromArgs(args) {
+    const cron = arg(args, '--schedule');
+    if (!cron)
+        return undefined;
+    const nextRunAt = arg(args, '--schedule-next-run') || undefined;
+    return parseJobSchedule({
+        cron,
+        timezone: arg(args, '--schedule-timezone', 'UTC'),
+        nextRunAt,
+        missedRunPolicy: arg(args, '--missed-run-policy', 'skip'),
+        concurrencyPolicy: arg(args, '--schedule-concurrency', 'skip'),
+    });
+}

package/dist/cli.js

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-import { readFile, writeFile } from 'node:fs/promises';
 import { realpathSync } from 'node:fs';
 import { once } from 'node:events';
 import { fileURLToPath } from 'node:url';
@@ -10,305 +9,19 @@ import { taskOverallTimeoutMs } from './types.js';
 import { Reconciler } from './reconciler.js';
 import { CodexAdapter, ChatGptAdapter } from './adapters.js';
 import { CodexThreadContinuation, CommandContinuation, WebhookContinuation } from './continuation.js';
-import { NatsEventBus, eventFor } from './events.js';
+import { eventFor } from './events.js';
 import { serveDashboard } from './dashboard.js';
 import { codexAndZaiUsageRegistry } from './usage.js';
 import { discoverAgents } from './registry.js';
 import { AgentObjectivePlanner, CommandObjectivePlanner } from './planner.js';
-import { extendRetryBudget, parseJobSchedule, transitionJobEvent, transitionTaskEvent } from './scheduler.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';
-const usage = 'agents-relay <job|task|context|init|record|agent-register|agent-discover|reconcile|tick|serve> [options]';
-const help = {
-    root: `Agents Relay coordinates durable asynchronous agent jobs through GitHub pull requests.
-
-Usage:
-  npx agents-relay <command> [options]
-
-Commands:
-  job create|update|show|list|merge|cancel  Manage durable GitHub-backed jobs
-  task create|update|show|list|complete|retry|cancel  Manage durable tasks
-  context resolve          Resolve shared project instructions, skills, agents, and runtimes
-  init                     Create a local demo job or initialize a GitHub job
-  record                   Backfill a completed task into durable history
-  agent-register           Register an agent role and its capabilities
-  agent-discover           Find registered agents matching hard filters
-  reconcile                Run reconciliation once
-  tick                     Run the indexed autonomous scheduler heartbeat
-  serve                    Run the dashboard and reconciliation service
-
-Run 'npx agents-relay <command> --help' for command options and examples.
-Use 'node dist/cli.js' only for explicit local development/demo mode.`,
-    job: `Manage GitHub-backed durable jobs.
-
-Usage:
-  npx agents-relay job <create|update|show|list|merge|cancel> [options]
-
-Actions:
-  create  Create a durable Job, optionally binding an existing unmanaged PR
-  update  Partially update mutable metadata on a healthy existing Job
-  show    Show one durable Job
-  list    List managed Jobs in a repository
-  merge   Merge the backing PR and complete the Job
-  cancel  Close the backing PR and cancel the Job
-
-Common options:
-  --repo OWNER/REPO       GitHub repository
-  --id JOB_ID             Durable job identifier
-  --pr NUMBER             Existing PR number
-
-Example:
-  npx agents-relay job show --repo OWNER/REPO --pr 12 --id job-1`,
-    'job create': `Create a durable Job and its trusted marker.
-
-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.
-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:
-  npx agents-relay job create --repo OWNER/REPO --head feat/example --base main --id job-1 --title "Objective" --objective-file job.md`,
-    '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.
-Unspecified fields are preserved. Marker/binding corruption is never repaired implicitly; update fails with a precise diagnostic instead.
-
-Example:
-  npx agents-relay job update --repo OWNER/REPO --pr 12 --id job-1 --priority P0 --no-auto-merge`,
-    'job show': `Show one durable Job.
-
-Required: --repo OWNER/REPO, --pr NUMBER, and --id JOB_ID.
-
-Example:
-  npx agents-relay job show --repo OWNER/REPO --pr 12 --id job-1`,
-    'job list': `List managed Jobs in a repository.
-
-Required: --repo OWNER/REPO.
-
-Example:
-  npx agents-relay job list --repo OWNER/REPO`,
-    'job merge': `Merge the backing pull request and complete the durable Job.
-
-Required: --repo OWNER/REPO, --pr NUMBER, and --id JOB_ID. The current PR head SHA is pinned into the merge request.`,
-    'job cancel': `Cancel the durable Job and close its backing pull request.
-
-Required: --repo OWNER/REPO, --pr NUMBER, and --id JOB_ID. Nonterminal Tasks are cancelled before the PR is closed.`,
-    task: `Manage durable tasks.
-
-Usage:
-  npx agents-relay task <create|update|show|list|retry|cancel> [options]
-
-Actions:
-  create  Create one durable Task under an existing Job
-  update  Update mutable Task fields
-  show    Show one Task
-  list    List Tasks for a Job
-  retry   Retry a failed or blocked Task
-  complete Complete an orchestrator-owned Task
-  cancel  Cancel a Task`,
-    'task create': `Create one durable Task under an existing Job.
-
-Required: normal Job storage options plus --input-file PATH|- (preferred) or --input MARKDOWN, and --output task-pr|file. --input and --input-file are mutually exclusive. Codex/ChatGPT tasks also require --model MODEL.
-Common: --task-id ID, --adapter codex|chatgpt|orchestrator, --priority P0|P1|P2|P3, --story-size S|M|L, --agent NAME, --agent-graph-file PATH|-, --deps a,b, --parent ID, --draft.\nTasks with dependencies start DRAFT; tasks without dependencies start QUEUED unless --draft is given.
-Directly-created Tasks are not wrapped in a synthetic Plan. Planner-generated Tasks are created internally by Relay from planner output.
-
-Example:
-  npx agents-relay task create --repo OWNER/REPO --pr 12 --id job-1 --task-id build --adapter codex --provider openai --model MODEL --output task-pr --input-file task.md`,
-    'task update': `Update mutable durable Task fields in place.
-
-Required: --task-id ID and the normal Job storage options.
-Mutable while not RUNNING/SUCCEEDED/CANCELLED: --adapter, --priority, --story-size, --input-file PATH|- or --input MARKDOWN, --project, --agent, --agent-graph-file PATH|-, --parent, --deps, --capabilities, --timeout, --max-attempts, --provider, --model, --profile, --reasoning, --cwd, --chatgpt-project, --chatgpt-tab-close-policy, --draft, --queue.
-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 show': `Show one durable Task.
-
-Required: --task-id ID and the normal Job storage options.`,
-    'task list': `List durable Tasks for one Job.
-
-Required: the normal Job storage options.`,
-    'task complete': `Complete one orchestrator-owned Task after the creating orchestrator has finished the work.
-
-Required: --task-id ID, --summary TEXT, and the normal Job storage options. The Task must use adapter=orchestrator and be QUEUED or RUNNING. This command is for the same orchestrator turn that created the self-task; it is not a deferred handoff mechanism.`,
-    'task retry': `Retry one durable Task.
-
-Required: --task-id ID and the normal Job storage options.`,
-    'task cancel': `Cancel one durable Task.
-
-Required: --task-id ID and the normal Job storage options.`,
-    context: `Resolve the shared execution context used by XChat and Relay.
-
-Usage:
-  npx agents-relay context resolve --project-path PATH --role ROLE [options]
-
-Actions:
-  resolve  Resolve instructions, visible skills/agents, and runtime/delegation metadata`,
-    'context resolve': `Resolve shared execution context without creating durable state.
-
-Required: --project-path PATH.
-Common: --role orchestrator|planner|reviewer|worker|nested-worker, --skills a,b, --agents a,b.
-Root overrides for testing/configuration: --workspace-root PATH, --neo-root PATH|none, --global-root PATH.
-
-Example:
-  npx agents-relay context resolve --project-path ~/Workspace/agents-relay --role orchestrator`,
-    record: `Backfill work completed outside the relay into durable history.
-
-Required: --file PATH or --repo/--pr/--id, plus --summary TEXT.
-Common: --task-id ID, --commit SHA, --project NAME.
-
-Example:
-  npx agents-relay record --file .agents-relay.json --summary "Built release" --commit abc123`,
-    reconcile: `Reconcile a job once, launching ready tasks and persisting results.
-
-Required: --file PATH for local demo mode, or --repo OWNER/REPO --pr NUMBER --id JOB_ID.
-
-Example:
-  npx agents-relay reconcile --repo OWNER/REPO --pr 12 --id job-1`,
-    tick: `Process autonomous jobs indexed into current/recent GitHub next-run buckets.
-
-Required: --repo OWNER/REPO.
-Common: --lookback-buckets N (default 3).
-
-Example:
-  npx agents-relay tick --repo OWNER/REPO`,
-    init: `Initialize a new job. GitHub mode requires --repo and --pr; local mode requires explicit --file.
-
-Common: --id ID, --title TEXT, --objective TEXT, --mode fixed|autonomous, --priority P0|P1|P2|P3.
-
-Example:
-  npx agents-relay init --repo OWNER/REPO --pr 12 --id job-1 --title "Objective"`,
-    serve: `Run the dashboard and reconciliation service for a managed job.
-
-Required: --file PATH for local demo mode, or --repo OWNER/REPO --pr NUMBER --id JOB_ID.
-Common: --port PORT, --interval MS, --events nats.
-
-Example:
-  npx agents-relay serve --repo OWNER/REPO --pr 12 --id job-1`,
-    'agent-register': `Register an agent role and its execution endpoint.
-
-Required: --file PATH or managed GitHub options, plus --name NAME --responsibility TEXT --role ROLE --endpoint TARGET.
-Common: --capabilities a,b, --runtime shell|codex|chatgpt, --provider NAME, --model NAME.
-
-Example:
-  npx agents-relay agent-register --file .agents-relay.json --name builder --responsibility "Build code" --role engineer --endpoint shell`,
-    'agent-discover': `Find registered agents using hard filters.
-
-Required: --file PATH or managed GitHub options.
-Common: --capabilities a,b, --runtime NAME, --availability available,busy, --task-kind NAME, --explore.
-
-Example:
-  npx agents-relay agent-discover --file .agents-relay.json --capabilities shell`,
-};
-export function helpText(command, action) {
-    if (command === 'job')
-        return action ? help[`job ${action}`] ?? help.job : help.job;
-    if (command === 'task')
-        return action ? help[`task ${action}`] ?? help.task : help.task;
-    if (command === 'context')
-        return action ? help[`context ${action}`] ?? help.context : help.context;
-    return command ? help[command] ?? help.root : help.root;
-}
-export const SERVICE_DEFAULTS = { port: 8787, watchdogMs: 300000, webhookWatchdogMs: 1800000, dashboardRefreshMs: 300000 };
-class ServiceEventBus {
-    upstream;
-    unsubscribers = new Set();
-    constructor(upstream) {
-        this.upstream = upstream;
-    }
-    async publish(event) { await this.upstream.publish(event); }
-    async subscribe(jobId, wake) {
-        const unsubscribe = await this.upstream.subscribe(jobId, wake);
-        this.unsubscribers.add(unsubscribe);
-        return async () => { this.unsubscribers.delete(unsubscribe); await unsubscribe(); };
-    }
-    async subscribeAll(wake) {
-        const unsubscribe = await this.upstream.subscribeAll(wake);
-        this.unsubscribers.add(unsubscribe);
-        return async () => { this.unsubscribers.delete(unsubscribe); await unsubscribe(); };
-    }
-    async close() {
-        const pending = [...this.unsubscribers].map(unsubscribe => unsubscribe());
-        this.unsubscribers.clear();
-        await Promise.all(pending);
-    }
-}
-function arg(args, name, fallback = '') { const index = args.indexOf(name); return index >= 0 ? args[index + 1] ?? fallback : fallback; }
-function hasArg(args, name) { return args.includes(name); }
-async function readStdinText() {
-    const chunks = [];
-    for await (const chunk of process.stdin)
-        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
-    return Buffer.concat(chunks).toString('utf8');
-}
-async function textOption(args, inlineFlag, fileFlag) {
-    if (hasArg(args, inlineFlag) && hasArg(args, fileFlag))
-        throw new Error(`${inlineFlag} and ${fileFlag} are mutually exclusive`);
-    if (hasArg(args, fileFlag)) {
-        const path = arg(args, fileFlag);
-        if (!path)
-            throw new Error(`${fileFlag} requires a path or - for stdin`);
-        return path === '-' ? readStdinText() : readFile(path, 'utf8');
-    }
-    return arg(args, inlineFlag);
-}
-function integerArg(args, name, fallback) { if (!hasArg(args, name))
-    return fallback; const value = Number(arg(args, name)); if (!Number.isInteger(value) || value < 0)
-    throw new Error(`${name} must be a non-negative integer`); return value; }
-function repository(args) { const value = arg(args, '--repo'); if (!value)
-    throw new Error('--repo is required for GitHub-backed operation'); return value; }
-function pullRequest(args) { const value = Number(arg(args, '--pr')); if (!Number.isInteger(value) || value <= 0)
-    throw new Error('--pr is required for GitHub-backed operation'); return value; }
-async function localStore(file) { const parsed = JSON.parse(await readFile(file, 'utf8')); const store = new InMemoryStore(parsed); return { store, job: await store.load(parsed.id) }; }
-async function githubStore(args) { const auth = await githubAuthContext(args); return new GitHubStore(auth.client, repository(args), pullRequest(args), auth.trustedAuthors); }
-async function storeFor(args) { const repo = arg(args, '--repo'); const pr = arg(args, '--pr'); if (repo && pr) {
-    const store = await githubStore(args);
-    const jobId = arg(args, '--id');
-    if (!jobId)
-        throw new Error('--id is required for GitHub-backed operation');
-    return { store, job: await store.load(jobId), localFile: null };
-} const file = arg(args, '--file'); if (!file)
-    throw new Error('Local mode is demo/test only; pass --file explicitly'); const loaded = await localStore(file); return { store: loaded.store, job: loaded.job, localFile: file }; }
-async function saveLocal(file, job) { if (file)
-    await writeFile(file, JSON.stringify(job, null, 2)); }
-export function eventBus(args) { if (arg(args, '--events') !== 'nats')
-    return undefined; return new NatsEventBus(arg(args, '--nats-url', 'nats://127.0.0.1:4222'), arg(args, '--subject-prefix', 'neo.events.job')); }
-async function publishWake(bus, job, taskId, message) { if (!bus)
-    return; try {
-    await bus.publish(eventFor(job.id, taskId, null, 'job.wake', 'queued', message, 'orchestrator', { repository: job.repository, prNumber: job.prNumber }));
-}
-catch (error) {
-    process.stderr.write(`warning: event wake unavailable: ${error instanceof Error ? error.message : String(error)}\n`);
-} }
-function priority(args, fallback = 'P2') { const value = arg(args, '--priority', fallback); if (!['P0', 'P1', 'P2', 'P3'].includes(value))
-    throw new Error('--priority must be P0, P1, P2, or P3'); return value; }
-function storySize(args, fallback = 'M') { const value = arg(args, '--story-size', fallback).toUpperCase(); if (!['S', 'M', 'L'].includes(value))
-    throw new Error('--story-size must be S, M, or L'); return value; }
-export function executionMode(args, fallback = 'fixed') { const value = arg(args, '--mode', arg(args, '--execution-mode', fallback)); if (value !== 'fixed' && value !== 'autonomous')
-    throw new Error('--mode must be fixed or autonomous'); return value; }
-export function chatGptTabClosePolicy(args) {
-    const value = arg(args, '--chatgpt-tab-close-policy', process.env.AGENTS_RELAY_CHATGPT_TAB_CLOSE_POLICY || 'after-start');
-    if (!['after-start', 'never', 'after-terminal'].includes(value))
-        throw new Error('--chatgpt-tab-close-policy must be after-start, never, or after-terminal');
-    return value;
-}
-function requestedExecutionMode(args) { const value = arg(args, '--mode', arg(args, '--execution-mode')); return value ? executionMode(args) : undefined; }
-function continuation(args) { const kind = arg(args, '--continue-kind'); const target = arg(args, '--continue-target'); return kind && target ? { kind: kind, target, input: arg(args, '--continue-input') || undefined } : null; }
-function scheduleFromArgs(args) {
-    const cron = arg(args, '--schedule');
-    if (!cron)
-        return undefined;
-    const nextRunAt = arg(args, '--schedule-next-run') || undefined;
-    return parseJobSchedule({
-        cron,
-        timezone: arg(args, '--schedule-timezone', 'UTC'),
-        nextRunAt,
-        missedRunPolicy: arg(args, '--missed-run-policy', 'skip'),
-        concurrencyPolicy: arg(args, '--schedule-concurrency', 'skip'),
-    });
-}
+import { helpText, usage } from './cli-help.js';
+export { helpText } from './cli-help.js';
+import { SERVICE_DEFAULTS, ServiceEventBus, arg, hasArg, textOption, integerArg, repository, storeFor, saveLocal, githubStore, eventBus, publishWake, priority, storySize, executionMode, chatGptTabClosePolicy, requestedExecutionMode, continuation, scheduleFromArgs, } from './cli-support.js';
+export { SERVICE_DEFAULTS, eventBus, executionMode, chatGptTabClosePolicy } from './cli-support.js';
 export async function ensureManagedGitHubJob(client, repositoryName, trustedAuthors, options) {
     if (!options.id)
         throw new Error('--id is required for managed GitHub jobs');