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"
+    }
+  }
+}

src/agent/directors/dispatch/package.ts agents/dispatch/src/index.tssrc/agent/directors/dispatch/package.ts renamed to agents/dispatch/src/index.ts

@@ -1,7 +1,66 @@
-// Dispatch: primary dispatcher card. Idle/mailbox/poll live in the harness.
+/**
+ * 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";
 
-import type { DirectorPackage } from "../types.js";
-import { DISPATCH_TOOLS } from "../tool-sets.js";
+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.
@@ -48,7 +107,7 @@ export function createDispatchSystemPrompt(): string {
   return DISPATCH_CARD;
 }
 
-export const dispatchPackage: DirectorPackage = {
+export const dispatchPackage: AgentPackage = {
   id: "dispatch",
   primaryIntent:
     "Coordinate named specialists; DIY only obvious mechanical corrections",
@@ -63,7 +122,7 @@ export const dispatchPackage: DirectorPackage = {
   description:
     "Primary dispatcher — classify, DIY tiny edits, spawn named specialists",
   systemPrompt: DISPATCH_CARD,
-  tools: { allow: DISPATCH_TOOLS },
+  tools: { allow: [...DISPATCH_TOOLS] },
   spawn: {
     maySpawn: true,
     allowlist: [

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

@@ -4,7 +4,7 @@ import type { AgentProfile, CapabilityFilter } from "../profile-types.js";
 import { director as artistDirector } from "@corbits/code-agent-artist";
 import { coderPackage } from "./coder/package.js";
 import { designerPackage } from "./designer/package.js";
-import { dispatchPackage } from "./dispatch/package.js";
+import { dispatchPackage } from "@corbits/agent-dispatch";
 import { explorerPackage } from "./explorer/package.js";
 import { plannerPackage } from "./planner/package.js";
 import { qaLeadPackage } from "./qa-lead/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

@@ -8,6 +8,7 @@
       "@corbits/code-agent-artist": ["./agents/artist/src/index.ts"],
       "@corbits/code-agent-shakespeare": ["./agents/shakespeare/src/index.ts"],
       "@corbits/code-agent-prober": ["./agents/prober/src/index.ts"],
+      "@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"