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

Author: TheGreatAxios

agents/artist/package.json

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

@@ -1,12 +1,49 @@
-import type { DirectorPackage } from "../types.js";
-import { BUILD_TOOLS } from "../tool-sets.js";
-
 /**
  * Artist worker: visual asset specialist.
  * Hand-crafts SVGs, visual diagrams (Mermaid, ASCII art), and structured
  * generative graphic prompts for image generation models.
+ *
+ * Ships as the @corbits/agent-artist workspace package: the tool allowlist
+ * lives here so the package stays importable without the app. Drift against
+ * the app build surface fails src/agent/directors/artist/package.test.ts.
  */
-export const artistPackage: DirectorPackage = {
+export type AgentPackage = {
+  readonly id: "artist";
+  readonly primaryIntent: string;
+  readonly outOfLane: readonly string[];
+  readonly description: string;
+  readonly systemPrompt: string;
+  /** Unset — artist never attaches skill bodies at spawn. */
+  readonly attachedSkills?: readonly string[];
+  /** Unset — artist declares no skill scope. */
+  readonly optionalSkills?: readonly string[];
+  readonly tools: {
+    readonly allow: readonly string[];
+  };
+  readonly spawn: {
+    readonly maySpawn: false;
+  };
+  readonly modelRole: "implement";
+  readonly tier: "leaf";
+};
+
+const ARTIST_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",
+] as const;
+
+export const artistPackage: AgentPackage = {
   id: "artist",
   primaryIntent:
     "Author hand-crafted SVGs, visual diagrams, and generative graphic prompts",
@@ -17,10 +54,6 @@ export const artistPackage: DirectorPackage = {
   ],
   description:
     "Visual asset specialist — SVGs, visual diagrams, and generative graphic prompts",
-  tools: { allow: BUILD_TOOLS },
-  spawn: { maySpawn: false },
-  tier: "leaf",
-  modelRole: "implement",
   systemPrompt: `You are ArtistDirector (Artist), a specialist in Corbits Code.
 
 PRIMARY INTENT: create visual assets — clean vector SVGs, technical and architectural diagrams, and structured generative image prompts.
@@ -49,4 +82,8 @@ Workflow:
 4. Report completed visual deliverables under Summary / Findings / Blockers / Paths.
 
 OUT OF LANE: non-visual code implementation, backend logic, code defect review, fleet orchestration.`,
+  tools: { allow: [...ARTIST_TOOLS] },
+  spawn: { maySpawn: false },
+  tier: "leaf",
+  modelRole: "implement",
 };

bun.lock

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

package.json

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

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

@@ -1,5 +1,5 @@
 import type { AgentProfile, CapabilityFilter } from "../profile-types.js";
-import { artistPackage } from "./artist/package.js";
+import { artistPackage } from "@corbits/agent-artist";
 import { coderPackage } from "./coder/package.js";
 import { designerPackage } from "./designer/package.js";
 import { dispatchPackage } from "./dispatch/package.js";

src/agent/directors/registry.ts

@@ -5,6 +5,7 @@
     "composite": false,
     "baseUrl": ".",
     "paths": {
+      "@corbits/agent-artist": ["./agents/artist/src/index.ts"],
       "@corbits/provider-opencode-go": ["./packages/opencode-go/src/index.ts"],
       "@corbits/first-class-providers": [
         "./packages/first-class-providers/src/index.ts"