refactor: move llmExtract, extractMeta, buildDescriptor, types to workflow-util-role

workflow-role-llm now only contains LLM-as-agent specifics:
  - createRole (wires agent + extract)
  - createLlmAdapter (OpenAI chat completions agent)

workflow-util-role now provides all role infrastructure:
  - decorators (decorateRole, withDryRun, onFail)
  - llmExtract / extractMetaOrThrow (structured extraction)
  - buildDescriptorFromRoles (zod → JSON Schema)
  - LlmProvider, LlmMessage types

packages/workflow-role-committer/__tests__/committer.test.ts

@@ -7,7 +7,7 @@ import { promisify } from "node:util";
 
 import type { AgentFn, ThreadContext } from "@uncaged/workflow";
 import { START } from "@uncaged/workflow";
-import * as roleLlm from "@uncaged/workflow-role-llm";
+import * as utilRole from "@uncaged/workflow-util-role";
 
 import { createCommitterRole } from "../src/committer.js";
 import { gitExec } from "../src/git-exec.js";
@@ -83,7 +83,7 @@ describe("createCommitterRole", () => {
     const { repo } = await setupRepoWithRemote();
     await appendFile(join(repo, "README.md"), "\nmore\n", "utf8");
 
-    const spy = spyOn(roleLlm, "extractMetaOrThrow").mockResolvedValue({
+    const spy = spyOn(utilRole, "extractMetaOrThrow").mockResolvedValue({
       branch: "feat/test-commit",
       message: "feat: add more",
     });

packages/workflow-role-committer/package.json

@@ -10,7 +10,6 @@
   },
   "dependencies": {
     "@uncaged/workflow": "workspace:*",
-    "@uncaged/workflow-role-llm": "workspace:*",
     "@uncaged/workflow-util-role": "workspace:*",
     "zod": "^4.0.0"
   }

packages/workflow-role-committer/src/committer.ts

@@ -1,7 +1,11 @@
 import type { AgentFn, Role, RoleResult, ThreadContext } from "@uncaged/workflow";
-import type { LlmProvider } from "@uncaged/workflow-role-llm";
+import {
-import { extractMetaOrThrow } from "@uncaged/workflow-role-llm";
+  decorateRole,
-import { decorateRole, onFail, withDryRun } from "@uncaged/workflow-util-role";
+  extractMetaOrThrow,
+  type LlmProvider,
+  onFail,
+  withDryRun,
+} from "@uncaged/workflow-util-role";
 import * as z from "zod/v4";
 
 import { gitExec } from "./git-exec.js";

packages/workflow-role-committer/tsconfig.json

@@ -6,9 +6,5 @@
     "composite": true
   },
   "include": ["src/**/*.ts"],
-  "references": [
+  "references": [{ "path": "../workflow" }, { "path": "../workflow-util-role" }]
-    { "path": "../workflow" },
-    { "path": "../workflow-role-llm" },
-    { "path": "../workflow-util-role" }
-  ]
 }

packages/workflow-role-llm/__tests__/create-role.test.ts

@@ -1,7 +1,7 @@
 import { afterEach, describe, expect, mock, spyOn, test } from "bun:test";
 import type { AgentFn, ThreadContext } from "@uncaged/workflow";
 import { START } from "@uncaged/workflow";
-import * as extractMetaModule from "@uncaged/workflow-role-llm";
+import * as extractMetaModule from "@uncaged/workflow-util-role";
 import * as z from "zod/v4";
 
 import { createRole } from "../src/create-role.js";

packages/workflow-role-llm/src/create-llm-adapter.ts

@@ -1,6 +1,6 @@
 import { type AgentFn, err, ok, type Result, type ThreadContext } from "@uncaged/workflow";
 
-import type { LlmMessage, LlmProvider } from "./types.js";
+import type { LlmMessage, LlmProvider } from "@uncaged/workflow-util-role";
 
 export type LlmChatError =
   | { kind: "http_error"; status: number; body: string }

packages/workflow-role-llm/src/create-role.ts

@@ -1,7 +1,6 @@
 import type { AgentFn, Role, ThreadContext } from "@uncaged/workflow";
+import { extractMetaOrThrow, type LlmProvider } from "@uncaged/workflow-util-role";
 import type * as z from "zod/v4";
-import { extractMetaOrThrow } from "./extract-meta.js";
-import type { LlmProvider } from "./types.js";
 
 export type CreateRoleArgs<M extends Record<string, unknown>> = {
   name: string;

packages/workflow-role-llm/src/index.ts

@@ -1,21 +1,21 @@
 export {
+  buildDescriptorFromRoles,
   decorateRole,
-  type OnFailOptions,
+  extractMetaOrThrow,
-  onFail,
-  type RoleDecorator,
-  type WithDryRunOptions,
-  withDryRun,
-} from "@uncaged/workflow-util-role";
-export { buildDescriptorFromRoles, type RoleDescriptorInput } from "./build-descriptor.js";
-export { chatCompletionText, createLlmAdapter, type LlmChatError } from "./create-llm-adapter.js";
-export { type CreateRoleArgs, createRole } from "./create-role.js";
-export { extractMetaOrThrow } from "./extract-meta.js";
-export {
   type LlmError,
   type LlmExtractArgs,
+  type LlmMessage,
   type LlmProvider,
   llmErrorToCause,
   llmExtract,
   llmExtractWithRetry,
-} from "./llm-extract.js";
+  type MetaExtractConfig,
-export type { LlmMessage, MetaExtractConfig } from "./types.js";
+  type OnFailOptions,
+  onFail,
+  type RoleDecorator,
+  type RoleDescriptorInput,
+  type WithDryRunOptions,
+  withDryRun,
+} from "@uncaged/workflow-util-role";
+export { chatCompletionText, createLlmAdapter, type LlmChatError } from "./create-llm-adapter.js";
+export { type CreateRoleArgs, createRole } from "./create-role.js";

packages/workflow-role-reviewer/package.json

@@ -11,6 +11,7 @@
   "dependencies": {
     "@uncaged/workflow": "workspace:*",
     "@uncaged/workflow-role-llm": "workspace:*",
+    "@uncaged/workflow-util-role": "workspace:*",
     "zod": "^4.0.0"
   }
 }

packages/workflow-role-reviewer/src/reviewer.ts

@@ -1,5 +1,6 @@
 import type { AgentFn, Role, ThreadContext } from "@uncaged/workflow";
-import { createRole, type LlmProvider } from "@uncaged/workflow-role-llm";
+import { createRole } from "@uncaged/workflow-role-llm";
+import type { LlmProvider } from "@uncaged/workflow-util-role";
 import * as z from "zod/v4";
 
 export const reviewerMetaSchema = z.object({

packages/workflow-role-reviewer/tsconfig.json

@@ -6,5 +6,9 @@
     "composite": true
   },
   "include": ["src/**/*.ts"],
-  "references": [{ "path": "../workflow" }, { "path": "../workflow-role-llm" }]
+  "references": [
+    { "path": "../workflow" },
+    { "path": "../workflow-role-llm" },
+    { "path": "../workflow-util-role" }
+  ]
 }

packages/workflow-template-solve-issue/package.json

@@ -14,6 +14,7 @@
     "@uncaged/workflow-role-committer": "workspace:*",
     "@uncaged/workflow-role-llm": "workspace:*",
     "@uncaged/workflow-role-reviewer": "workspace:*",
+    "@uncaged/workflow-util-role": "workspace:*",
     "zod": "^4.0.0"
   }
 }

packages/workflow-template-solve-issue/src/descriptor.ts

@@ -1,6 +1,6 @@
 import { committerMetaSchema } from "@uncaged/workflow-role-committer";
-import { buildDescriptorFromRoles } from "@uncaged/workflow-role-llm";
 import { reviewerMetaSchema } from "@uncaged/workflow-role-reviewer";
+import { buildDescriptorFromRoles } from "@uncaged/workflow-util-role";
 
 import { coderMetaSchema, plannerMetaSchema } from "./roles.js";
 

packages/workflow-template-solve-issue/src/roles.ts

@@ -4,8 +4,9 @@ import {
   type CommitterPlanMeta,
   createCommitterRole,
 } from "@uncaged/workflow-role-committer";
-import { createRole, type LlmProvider } from "@uncaged/workflow-role-llm";
+import { createRole } from "@uncaged/workflow-role-llm";
 import { createReviewerRole, type ReviewerMeta } from "@uncaged/workflow-role-reviewer";
+import type { LlmProvider } from "@uncaged/workflow-util-role";
 import * as z from "zod/v4";
 
 const DRY_RUN_PROVIDER: LlmProvider = {

packages/workflow-template-solve-issue/tsconfig.json

@@ -6,5 +6,9 @@
     "composite": true
   },
   "include": ["src/**/*.ts"],
-  "references": [{ "path": "../workflow" }, { "path": "../workflow-role-llm" }]
+  "references": [
+    { "path": "../workflow" },
+    { "path": "../workflow-role-llm" },
+    { "path": "../workflow-util-role" }
+  ]
 }

packages/workflow-util-role/src/index.ts

@@ -1,3 +1,4 @@
+export { buildDescriptorFromRoles, type RoleDescriptorInput } from "./build-descriptor.js";
 export {
   decorateRole,
   type OnFailOptions,
@@ -6,3 +7,12 @@ export {
   type WithDryRunOptions,
   withDryRun,
 } from "./decorators.js";
+export { extractMetaOrThrow } from "./extract-meta.js";
+export {
+  type LlmError,
+  type LlmExtractArgs,
+  llmErrorToCause,
+  llmExtract,
+  llmExtractWithRetry,
+} from "./llm-extract.js";
+export type { LlmMessage, LlmProvider, MetaExtractConfig } from "./types.js";

packages/workflow-util-role/src/llm-extract.ts

@@ -2,8 +2,6 @@ import { err, ok, type Result } from "@uncaged/workflow";
 import * as z from "zod/v4";
 import type { LlmProvider } from "./types.js";
 
-export type { LlmProvider } from "./types.js";
-
 export type LlmExtractArgs<T> = {
   text: string;
   schema: z.ZodType<T>;