feat(explorer): ship explorer as a workspace agent package

Author: TheGreatAxios

agents/explorer/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@corbits/agent-explorer",
+  "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/explorer/package.ts agents/explorer/src/index.tssrc/agent/directors/explorer/package.ts renamed to agents/explorer/src/index.ts

@@ -1,11 +1,45 @@
-import type { DirectorPackage } from "../types.js";
-import { READ_TOOLS } from "../tool-sets.js";
-
 /**
  * Explorer worker (CL-7020 / CL-7015 rename from explore).
  * Map/read against the brief — scannable findings only; never implement, review, or discover the fleet.
+ *
+ * Ships as the @corbits/agent-explorer workspace package: the tool allowlist
+ * lives here so the package stays importable without the app. Drift against
+ * the app read surface fails src/agent/directors/explorer/package.test.ts.
  */
-export const explorerPackage: DirectorPackage = {
+export type AgentPackage = {
+  readonly id: "explorer";
+  readonly primaryIntent: string;
+  readonly outOfLane: readonly string[];
+  readonly description: string;
+  readonly systemPrompt: string;
+  /** Unset — explorer never attaches skill bodies at spawn. */
+  readonly attachedSkills?: readonly string[];
+  /** Unset — explorer declares no skill scope. */
+  readonly optionalSkills?: readonly string[];
+  readonly tools: {
+    readonly allow: readonly string[];
+  };
+  readonly spawn: {
+    readonly maySpawn: false;
+  };
+  readonly modelRole: "explore";
+  readonly tier: "leaf";
+};
+
+const EXPLORER_TOOLS = [
+  "read_file",
+  "grep",
+  "search_files",
+  "list_dir",
+  "lsp",
+  "run_shell",
+  "web_fetch",
+  "web_search",
+  "skill_search",
+  "use_skill",
+] as const;
+
+export const explorerPackage: AgentPackage = {
   id: "explorer",
   primaryIntent: "Map and read the codebase; no product edits",
   outOfLane: [
@@ -33,7 +67,7 @@ FINDINGS SHAPE: Findings must be a scannable map — key paths, symbols, call fl
 FINISH BIAS: Prefer one thorough pass then report. Expand Findings, change approach, or write the final report — do not keep re-reading the same paths.
 
 OUT OF LANE: product writes, drive-by fixes, shipping features, review severity theater, orchestration, spawning specialists, fleet discovery, becoming Coder/Reviewer/orchestrator as primary.`,
-  tools: { allow: READ_TOOLS },
+  tools: { allow: [...EXPLORER_TOOLS] },
   spawn: { maySpawn: false },
   tier: "leaf",
   modelRole: "explore",

bun.lock

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

package.json

@@ -0,0 +1,23 @@
+import { describe, expect, test } from "bun:test";
+
+import { explorerPackage } from "@corbits/agent-explorer";
+import { READ_TOOLS } from "../tool-sets.js";
+import { DIRECTOR_REGISTRY } from "../registry.js";
+import type { DirectorPackage } from "../types.js";
+
+describe("explorerPackage", () => {
+  test("workspace package satisfies the director contract and feeds the registry", () => {
+    const asDirector: DirectorPackage = explorerPackage;
+    expect(asDirector.id).toBe("explorer");
+    expect(DIRECTOR_REGISTRY.explorer).toBe(explorerPackage);
+    expect([...explorerPackage.tools.allow]).toEqual([...READ_TOOLS]);
+  });
+
+  test("extracted copy stays read-only and non-spawning", () => {
+    expect(explorerPackage.tools.allow).not.toContain("write_file");
+    expect(explorerPackage.tools.allow).not.toContain("edit_file");
+    expect(explorerPackage.tools.allow).not.toContain("delete_file");
+    expect(explorerPackage.spawn.maySpawn).toBe(false);
+    expect(explorerPackage.tier).toBe("leaf");
+  });
+});

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

@@ -1,9 +1,9 @@
+import { explorerPackage } from "@corbits/agent-explorer";
 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";
 import { qaLeadPackage } from "./qa-lead/package.js";

src/agent/directors/registry.ts

@@ -5,6 +5,7 @@
     "composite": false,
     "baseUrl": ".",
     "paths": {
+      "@corbits/agent-explorer": ["./agents/explorer/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"