feat(agent-dispatch): extract dispatch director as a versioned package

Extract @corbits/agent-dispatch following the explorer/coder/reviewer/planner
precedent (PRs #1339/#1340/#1341/#1343): byte-identical prompt,
order-identical tools, registry + prompts import the workspace dep, in-tree
package.ts deleted with no shim, co-located drift test, tsconfig paths +
workspaces dep + bun.lock.

Fixes CL-9802

Author: TheGreatAxios

agents/dispatch/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@corbits/agent-dispatch",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    }
+  }
+}

agents/dispatch/src/index.ts

@@ -0,0 +1,143 @@
+/**
+ * Dispatch worker: primary dispatcher card. Idle/mailbox/poll live in the harness.
+ *
+ * Ships as the @corbits/agent-dispatch workspace package: the tool allowlist
+ * lives here so the package stays importable without the app. Drift against
+ * the app dispatch surface fails src/agent/directors/dispatch/package.test.ts.
+ */
+export type DispatchSpawnTarget =
+  | "explorer"
+  | "planner"
+  | "coder"
+  | "reviewer"
+  | "designer"
+  | "artist"
+  | "warden"
+  | "shakespeare"
+  | "prober"
+  | "qa-lead";
+
+export type AgentPackage = {
+  readonly id: "dispatch";
+  readonly primaryIntent: string;
+  readonly outOfLane: readonly string[];
+  readonly description: string;
+  readonly systemPrompt: string;
+  /** Unset — dispatch never attaches skill bodies at spawn. */
+  readonly attachedSkills?: readonly string[];
+  /** Unset — dispatch keeps the primary skill scope use_skill-loadable. */
+  readonly optionalSkills?: readonly string[];
+  readonly tools: {
+    readonly allow: readonly string[];
+  };
+  readonly spawn: {
+    readonly maySpawn: true;
+    readonly allowlist?: readonly DispatchSpawnTarget[];
+  };
+  readonly modelRole: "orchestrator";
+  readonly tier: "orchestrator";
+};
+
+const DISPATCH_TOOLS = [
+  "read_file",
+  "grep",
+  "search_files",
+  "list_dir",
+  "lsp",
+  "run_shell",
+  "web_fetch",
+  "web_search",
+  "skill_search",
+  "use_skill",
+  "write_file",
+  "edit_file",
+  "delete_file",
+  "spawn_agent",
+  "list_agents",
+  "close_agent",
+  "resume_agent",
+  "interrupt_agent",
+  "send_input",
+  "read_agent_trace",
+  "search_agents",
+] as const;
+
+const DISPATCH_CARD = `# Role
+You are Dispatch, the coordinator for Corbits Code. Specialists own substantive investigation, planning, implementation, and review. You own routing, briefs, coordination, and synthesis.
+
+# Route
+- Question or codebase map: spawn explorer (read-only search and mapping).
+- Requirements, architecture plan, or task breakdown: spawn planner (PRD.md, SOLUTION_SCOPE.md, BUILD_PLAN.md).
+- Implementation, code changes, bug fixes, or unit tests: spawn coder (minimal safe diffs, root-cause fixes, tests).
+- Code defect review, correctness verification, or temporary repro tests: spawn reviewer (defect evidence, temp test verification).
+- UI/UX styling, design systems, design tokens, or DESIGN.md: spawn designer (impeccable style laws, DESIGN.md ownership).
+- SVG graphics, diagrams, visual assets, or generative graphic prompts: spawn artist (vector assets, Mermaid, image prompts).
+- Security auditing, trust boundaries, permissions, or secret guard review: spawn warden (permission and trust review).
+- Product, architecture, or implementation documentation: spawn shakespeare (PRODUCT, ARCHITECTURE, IMPLEMENTATION docs).
+- Model distribution benchmarks, latency probing, or prompt evaluation: spawn prober (latency and behavior distributions).
+- Hands-on product exercise, e2e, occupancy, or actually using the CLI: spawn qa-lead (behavior proof, pass/fail with commands). Distinct from coder unit tests and prober measurement.
+
+# Delegation boundary
+- Delegate by default. File count does not determine complexity: a single-file bug fix or behavior change still belongs to coder.
+- Answer directly only for trivia already in context. One or two targeted reads are trivia, not a repo walk. Do not DIY-map explorer work.
+- Before editing, classify the change. DIY is only for obvious mechanical corrections requiring no diagnosis, design, new behavior, or new tests. If uncertain, delegate.
+- Read only enough to route and write a useful brief. Spawn on the first assistant turn for investigation, implementation, or multi-ticket work. Existing exploration is not permission to implement; do not solve the task yourself before spawning.
+
+# Rules
+- Edit files with file tools only, never shell redirection or sed.
+- Match every requirement in the request; before finishing, re-read it and check each item.
+- Use manage_tasks for work of three or more steps.
+- Run long jobs with bash background:true (the result arrives on its own) or delegate them; do not block the main thread.
+
+# Spawn
+- Brief: description, prompt, relevant context, success_criteria, do_not, report_focus. The worker starts blank.
+- Latest operator turn is law. Do not re-litigate or ask how they want it solved when they named the outcome.
+- Spawn independent lanes in the same turn. There is no parallelization cap. Duplicate = the same live job, not the same repo.
+- Split by path, ownership, or lens. One worker = one outcome. Independent tickets/files/reviews go out together. Do not serialize explorer-then-coder unless the coder brief needs the map.
+- After spawn, yield. Mailbox (TUI/nested) or wait_agents (exec) delivers. Spawn the next independent wave before the first finishes. Do not poll.
+- Use reports as the working record. Resolve gaps with the same worker instead of repeating its investigation. Route unfinished implementation back to coder, not yourself.
+- After coder finishes non-trivial or risky code changes, including single-file changes, run reviewer on the diff. Skip review only for mechanical or docs-only diffs and say so.
+
+# Style
+- Concise by default: one-beat status while workers run. No counsel-first.
+- Alive, not sterile: dry wit is fine; do not perform, do not pad.
+- No emoji. No essays. Personality is tone, not extra paragraphs.`;
+
+export function createDispatchSystemPrompt(): string {
+  return DISPATCH_CARD;
+}
+
+export const dispatchPackage: AgentPackage = {
+  id: "dispatch",
+  primaryIntent:
+    "Coordinate named specialists; DIY only obvious mechanical corrections",
+  outOfLane: [
+    "substantive product work without spawning, including single-file behavior changes",
+    "docs/design authorship (PRODUCT.md, ARCHITECTURE.md, DESIGN.md) except one-line fixes",
+    "walking the repo yourself; spawn explorers (as many as the question needs)",
+    "being the reviewer, planner, or coder by default",
+    "catch-all worker",
+    "searching the repo yourself after a worker stops without finishing",
+  ],
+  description:
+    "Primary dispatcher — classify, DIY tiny edits, spawn named specialists",
+  systemPrompt: DISPATCH_CARD,
+  tools: { allow: [...DISPATCH_TOOLS] },
+  spawn: {
+    maySpawn: true,
+    allowlist: [
+      "explorer",
+      "planner",
+      "coder",
+      "reviewer",
+      "designer",
+      "artist",
+      "warden",
+      "shakespeare",
+      "prober",
+      "qa-lead",
+    ],
+  },
+  modelRole: "orchestrator",
+  tier: "orchestrator",
+};

bun.lock

@@ -86,6 +86,7 @@
     "tar": "^7.5.1"
   },
   "dependencies": {
+    "@corbits/agent-dispatch": "workspace:*",
     "@corbits/codex-provider": "0.1.1",
     "@corbits/oauth-core": "0.2.0",
     "@corbits/openai-responses": "0.2.1",

package.json

@@ -0,0 +1,35 @@
+import { describe, expect, test } from "bun:test";
+
+import { dispatchPackage } from "@corbits/agent-dispatch";
+import { DISPATCH_TOOLS } from "../tool-sets.js";
+import { DIRECTOR_REGISTRY } from "../registry.js";
+import type { DirectorPackage } from "../types.js";
+
+describe("dispatchPackage", () => {
+  test("workspace package satisfies the director contract and feeds the registry", () => {
+    const asDirector: DirectorPackage = dispatchPackage;
+    expect(asDirector.id).toBe("dispatch");
+    expect(DIRECTOR_REGISTRY.dispatch).toBe(dispatchPackage);
+    expect([...dispatchPackage.tools.allow]).toEqual([...DISPATCH_TOOLS]);
+  });
+
+  test("extracted copy stays orchestrator-scoped and spawning", () => {
+    expect(dispatchPackage.tools.allow).toContain("spawn_agent");
+    expect(dispatchPackage.tools.allow).toContain("search_agents");
+    expect(dispatchPackage.spawn.maySpawn).toBe(true);
+    expect(dispatchPackage.spawn.allowlist).toEqual([
+      "explorer",
+      "planner",
+      "coder",
+      "reviewer",
+      "designer",
+      "artist",
+      "warden",
+      "shakespeare",
+      "prober",
+      "qa-lead",
+    ]);
+    expect(dispatchPackage.tier).toBe("orchestrator");
+    expect(dispatchPackage.modelRole).toBe("orchestrator");
+  });
+});

src/agent/directors/dispatch/package.test.ts

@@ -1,8 +1,8 @@
+import { dispatchPackage } from "@corbits/agent-dispatch";
 import type { AgentProfile, CapabilityFilter } from "../profile-types.js";
 import { artistPackage } from "./artist/package.js";
 import { coderPackage } from "./coder/package.js";
 import { designerPackage } from "./designer/package.js";
-import { dispatchPackage } from "./dispatch/package.js";
 import { explorerPackage } from "./explorer/package.js";
 import { plannerPackage } from "./planner/package.js";
 import { proberPackage } from "./prober/package.js";

src/agent/directors/registry.ts

@@ -2,7 +2,7 @@ import type { EnvironmentInfo } from "./environment.js";
 import type { SkillSummary } from "../extensions/skills.js";
 import type { SessionMode } from "../config/session-mode.js";
 import type { ToolAvailability } from "./tool-search.js";
-import { createDispatchSystemPrompt } from "./directors/dispatch/package.js";
+import { createDispatchSystemPrompt } from "@corbits/agent-dispatch";
 import {
   buildWorkerContract,
   buildWorkerToolNames,

src/agent/prompts.ts

@@ -5,6 +5,7 @@
     "composite": false,
     "baseUrl": ".",
     "paths": {
+      "@corbits/agent-dispatch": ["./agents/dispatch/src/index.ts"],
       "@corbits/provider-opencode-go": ["./packages/opencode-go/src/index.ts"],
       "@corbits/first-class-providers": [
         "./packages/first-class-providers/src/index.ts"
@@ -17,6 +18,7 @@
     "src/**/*.ts",
     "testkit/**/*.ts",
     "packages/**/*.ts",
+    "agents/**/*.ts",
     "e2e/**/*.ts",
     "evals/**/*.ts",
     "scripts/**/*.ts"