agents-relay 1.0.133 → 1.0.134

package/README.md

@@ -23,11 +23,10 @@ cat > task.md <<'EOF'
 Implement this phase using the Job objective as context.
 EOF
 npx agents-relay task create --repo OWNER/REPO --pr 12 --id job-1 \
-  --task-id initial --adapter codex --provider openai --model MODEL --output task-pr \
-  --input-file task.md
+  --task-id initial --output task-pr --input-file task.md
 
 npx agents-relay task create --repo OWNER/REPO --pr 12 --id job-1 \
-  --task-id child --adapter codex --provider openai --model MODEL --output task-pr \
+  --task-id child --output task-pr \
   --input "Implement the described child task and publish a terminal event."
 
 npx agents-relay reconcile --repo OWNER/REPO --pr 12 --id job-1
@@ -132,7 +131,7 @@ For explicit local demo/test mode:
 npm install
 npm run build
 node dist/cli.js init --file .agents-relay.json --title "Dogfood" --id demo
-node dist/cli.js task create --file .agents-relay.json --task-id hello --adapter codex --provider openai --model MODEL --output task-pr --input "Complete the described task"
+node dist/cli.js task create --file .agents-relay.json --task-id hello --output task-pr --input "Complete the described task"
 node dist/cli.js reconcile --file .agents-relay.json
 npx agents-relay serve --file .agents-relay.json
 ~~~
@@ -163,7 +162,7 @@ For automation, Agents Relay can use GitHub App installation authentication via
 
 V1 assumes one active runner/daemon per job. Use a distributed atomic lease before running multiple reconcilers. Do not put secrets, credentials, private prompts, or large private payloads in the PR-body Job marker or PR-comment Task markers; store only summaries and artifact references.
 
-Codex/model-backed tasks require --provider and --model (or equivalent routing metadata) before launch. See [docs/architecture.md](docs/architecture.md) and [skills/agents-relay/SKILL.md](skills/agents-relay/SKILL.md).
+Model-backed tasks are routed by Relay before launch. Normal task producers omit adapter/provider/model; explicit routing flags remain compatibility/debug constraints. See [docs/architecture.md](docs/architecture.md) and [skills/agents-relay/SKILL.md](skills/agents-relay/SKILL.md).
 
 XChat and other orchestrators can consume Relay's exact shared discovery implementation without duplicating filesystem search logic:
 

package/dist/cli-help.js

@@ -98,12 +98,12 @@ Actions:
   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.
+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.
+Common: --task-id ID, --priority P0|P1|P2|P3, --story-size S|M|L, --agent NAME, --agent-graph-file PATH|-, --deps a,b, --parent ID, --draft. Normal model-backed Tasks omit adapter/provider/model so Relay runs worker-router then model-router. Use --adapter orchestrator only for synchronous self-work; explicit adapter/provider/model remain compatibility/debug constraints.\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`,
+  npx agents-relay task create --repo OWNER/REPO --pr 12 --id job-1 --task-id build --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.

package/dist/cli.js

@@ -79,17 +79,18 @@ async function workerTaskFromArgs(job, args, now) {
         throw new Error('task create requires --input-file PATH|- or --input MARKDOWN');
     if (!['codex', 'chatgpt', 'orchestrator'].includes(adapter))
         throw new Error('task create --adapter must be codex, chatgpt, or orchestrator');
-    if (adapter !== 'orchestrator' && !model)
-        throw new Error('task create requires --model for codex/chatgpt tasks');
     if (outputKind !== 'task-pr' && outputKind !== 'file')
         throw new Error('task create requires --output task-pr|file');
     if (outputKind === 'file' && !outputPath)
         throw new Error('--output file requires --output-path');
-    const routing = adapter === 'orchestrator' ? undefined : { provider: arg(args, '--provider', 'openai'), model, profile: arg(args, '--profile') || undefined, reasoning: arg(args, '--reasoning') || undefined, cwd: arg(args, '--cwd') || undefined, projectId: arg(args, '--chatgpt-project') || undefined, decidedBy: 'cli', decidedAt: now };
+    if (adapter !== 'orchestrator' && ['--provider', '--profile', '--reasoning', '--cwd', '--chatgpt-project'].some(flag => hasArg(args, flag)) && !model)
+        throw new Error('task create explicit routing requires --model');
+    const routing = adapter === 'orchestrator' || !model ? undefined : { provider: arg(args, '--provider', 'openai'), model, profile: arg(args, '--profile') || undefined, reasoning: arg(args, '--reasoning') || undefined, cwd: arg(args, '--cwd') || undefined, projectId: arg(args, '--chatgpt-project') || undefined, decidedBy: 'cli', decidedAt: now };
+    const workerRequirements = adapter === 'orchestrator' || routing ? undefined : { capabilities: [], runtime: adapterValue ? adapter : undefined };
     const closePolicy = hasArg(args, '--chatgpt-tab-close-policy') ? chatGptTabClosePolicy(args) : undefined;
     const size = storySize(args);
     const dependencies = arg(args, '--deps').split(',').filter(Boolean);
-    const timeoutMs = adapter === 'orchestrator' ? 0 : hasArg(args, '--timeout') ? integerArg(args, '--timeout', taskOverallTimeoutMs(size, routing?.reasoning)) : taskOverallTimeoutMs(size, routing?.reasoning);
+    const timeoutMs = adapter === 'orchestrator' ? 0 : hasArg(args, '--timeout') ? integerArg(args, '--timeout', taskOverallTimeoutMs(size, routing?.reasoning)) : routing ? taskOverallTimeoutMs(size, routing.reasoning) : 0;
     return {
         jobId: job.id,
         id: arg(args, '--task-id', 'initial'),
@@ -101,6 +102,7 @@ async function workerTaskFromArgs(job, args, now) {
         parentTaskId: arg(args, '--parent') || null,
         dependencies,
         capabilities: arg(args, '--capabilities').split(',').filter(Boolean),
+        workerRequirements,
         adapter,
         chatgptTabClosePolicy: closePolicy,
         input: input || 'true',

package/package.json

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

package/skills/agents-relay/SKILL.md

@@ -21,14 +21,15 @@ Normal worker tasks use an agent runtime:
 
 Shell commands, tests, Markad Vision, ffmpeg, build tools, and similar CLIs are tools used inside an agent or directly by the orchestrator. They are not Agents Relay worker tasks.
 
-Every model-backed task must declare:
+Every model-backed task producer normally declares:
 - its descriptive `input`;
-- its adapter (`codex` or `chatgpt`);
-- routing metadata;
+- semantic requirements such as capabilities/runtime only when known;
 - exactly one durable output contract:
   - `task_pr`: the managed task/PR is the authoritative result; or
   - `file`: an exact file path is the authoritative result.
 
+Relay then runs worker-router followed by model-router and persists the selected worker/adapter and model routing before launch. Explicit adapter/provider/model values are compatibility/debug constraints, not normal producer requirements.
+
 ## Lifecycle contract
 
 Events are authoritative for model-backed task state.
@@ -62,7 +63,7 @@ Example:
 ~~~sh
 npx agents-relay job create --repo OWNER/REPO --head feat/example --base main   --id JOB_ID --title "Objective"
 
-npx agents-relay task create --repo OWNER/REPO --pr 12 --id JOB_ID   --task-id implement   --adapter codex   --provider openai --model MODEL   --output task-pr   --input "Implement the requested change, validate it, and update the managed task/PR."
+npx agents-relay task create --repo OWNER/REPO --pr 12 --id JOB_ID   --task-id implement   --output task-pr   --input "Implement the requested change, validate it, and update the managed task/PR."
 
 npx agents-relayd --repo OWNER/REPO --events nats
 ~~~