feat: Agent Coordinator — automatic profile routing and profile-aware plan execution

[Copilot]

Agent profiles had to be explicitly named by callers; there was no mechanism to auto-select a profile based on free-text input or to annotate individual plan steps with specialist profiles.

Changes

src/agents/coordinator.ts (new)

• routeRequest(request, profileRegistry, registry, llm?) — lightweight LLM subagent selects the best AgentProfile for a request; returns null on no match, unknown name, invalid JSON, or subagent failure (never throws)
• coordinatedExecute(request, options) — high-level entry point: routeRequest → generatePlan → executePlan (or single-invoke when steps.length ≤ planThreshold)
• ROUTER_SYSTEM_PROMPT — exported constant; instructs the router to respond only with { "profile": "<name>" } or { "profile": null }

src/subagents/planner.ts

• PlanStep gains optional agentProfile?: string field
• generatePlan() accepts a new optional profileRegistry? param; when present, injects profile names into the planner task and system prompt so the model can annotate each step
• JSON_SCHEMA_HINT and PLANNER_SYSTEM_PROMPT updated accordingly

src/orchestrator.ts

• ExecutionOptions gains profileRegistry?: AgentProfileRegistry
• runStep() activates the annotated profile per step: resolves model/temperature overrides and intersects activeTools with step.toolsNeeded; warns when intersection is empty

src/index.ts

• executeWithTools(): when COORDINATOR_ENABLED=true and no explicit profileName is passed, calls routeRequest() to auto-select a profile before the agent loop runs

src/config.ts / .env.example

• COORDINATOR_ENABLED (default false) — enables auto-routing in agentExecutor.invoke()
• COORDINATOR_PLAN_THRESHOLD (default 1) — step count threshold for coordinatedExecute() plan path

Usage

// Auto-routing (set COORDINATOR_ENABLED=true in env)
const result = await agentExecutor.invoke("Write a sort function");
// → coordinator selects "coder" profile automatically

// Full programmatic control
const result = await coordinatedExecute("Add a health-check endpoint", {
  registry: toolRegistry,
  profileRegistry: agentProfileRegistry,
  workspaceInfo,
  invoke: (req, profileName) => agentExecutor.invoke(req, profileName),
});
// Steps > planThreshold → generatePlan() + executePlan({ profileRegistry })
// Each plan step carries agentProfile annotation; orchestrator activates it per step

Tests

• 8 new routeRequest tests in coordinator.test.ts (correct selection, null on unknown/null/parse-error/subagent-failure, empty registry short-circuit, task content, markdown-fence parsing)
• 5 new agentProfile parsing tests in planner.test.ts
• 4 new profile-aware execution tests in orchestrator.test.ts

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• duckduckgo.com
  • Triggering command: /opt/hostedtoolcache/node/24.14.0/x64/bin/node /opt/hostedtoolcache/node/24.14.0/x64/bin/node /home/REDACTED/work/agentloop/agentloop/node_modules/jest-worker/build/processChild.js (dns block)
  • Triggering command: /opt/hostedtoolcache/node/24.14.0/x64/bin/node /opt/hostedtoolcache/node/24.14.0/x64/bin/node /home/REDACTED/work/agentloop/agentloop/node_modules/jest-worker/build/processChild.js t git bran�� -v find exist_xyz 3c6d28ffa51cb5afa21b7289b8e36e9aae6/log.json f k/_temp/ghcca-no. git conf�� (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

⚡ Quickly spin up Copilot coding agent tasks from anywhere on your macOS or Windows machine with Raycast.

[huberp]

Fix error in here https://github.com/huberp/agentloop/actions/runs/23665174063/job/68945444736#step:5:1
@copilot

[Copilot]

Fix error in here https://github.com/huberp/agentloop/actions/runs/23665174063/job/68945444736#step:5:1
@copilot

The CI failure was in src/__tests__/prompt-versioning.test.ts — a pre-existing race condition where register() triggered multiple fire-and-forget saveHistory() calls that wrote to the same file concurrently, producing truncated JSON.

Fixed in 2e711bf by serialising all writes through a promise chain (_saveChain) in PromptRegistry, and extracting the actual disk write into a private _writeToDisk() method. The public saveHistory() now awaits the chain before writing, guaranteeing sequential file access.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• duckduckgo.com
  • Triggering command: /opt/hostedtoolcache/node/24.14.0/x64/bin/node /opt/hostedtoolcache/node/24.14.0/x64/bin/node /home/REDACTED/work/agentloop/agentloop/node_modules/jest-worker/build/processChild.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)