chore: publish v0.3.24

小橘 <xiaoju@shazhou.work>

.changeset/README.md

@@ -1,8 +0,0 @@
-# Changesets
-
-Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
-with multi-package repos, or single-package repos to help you version and publish your code. You can
-find the full documentation for it [in our repository](https://github.com/changesets/changesets).
-
-We have a quick list of common questions to get you started engaging with this project in
-[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md).

.changeset/config.json

@@ -1,11 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@changesets/config@3.1.4/schema.json",
-  "changelog": "@changesets/cli/changelog",
-  "commit": false,
-  "fixed": [["@uncaged/*"]],
-  "linked": [],
-  "access": "public",
-  "baseBranch": "main",
-  "updateInternalDependencies": "patch",
-  "ignore": ["@uncaged/workflow-dashboard"]
-}

.githooks/pre-push

@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-# pre-push hook: typecheck + biome + lint-log-tags
-set -euo pipefail
-echo "🔍 pre-push: running checks..."
-bun run check
-echo "✅ pre-push: all checks passed"

CLAUDE.md

@@ -30,7 +30,6 @@ workflow/
     workflow-agent-cursor/          # @uncaged/workflow-agent-cursor
     workflow-agent-hermes/          # @uncaged/workflow-agent-hermes
     workflow-agent-llm/             # @uncaged/workflow-agent-llm
-    workflow-agent-react/             # @uncaged/workflow-agent-react
     workflow-util-agent/            # @uncaged/workflow-util-agent — buildAgentPrompt, spawnCli
     workflow-template-develop/      # @uncaged/workflow-template-develop
     workflow-template-solve-issue/  # @uncaged/workflow-template-solve-issue
@@ -41,7 +40,7 @@ workflow/
 ```
 
 - Execution stack layers: `workflow-protocol` → (`workflow-runtime`, `workflow-util`, `workflow-reactor`) → (`workflow-cas`, `workflow-register`) → `workflow-execute` → `cli-workflow`
-- Packages use `workspace:^` protocol (resolves to `^x.y.z` on publish)
+- Packages use `workspace:*` protocol
 
 ## Language & Paradigm
 
@@ -230,6 +229,37 @@ const mod = await import(bundlePath);
 
 Test files (`__tests__/**`) are exempt.
 
+## Package Build & Distribution
+
+每个包用 `tsc` 编译出 `.js` + `.d.ts` 到 `dist/`，**发布 `dist`，不发 `src`，不 bundle**。
+
+### 规则
+
+- ✅ `tsc --build` 编译，保留目录结构（tree-shaking 友好）
+- ✅ `package.json` 的 `exports` 指向 `dist/`（编译产物），不指向 `src/`
+- ✅ 消费端不受 tsconfig 差异影响
+- ❌ 不要用 rollup/esbuild 打成单文件
+- ❌ `exports` 中不要出现 `./src/`
+
+### package.json exports 格式
+
+```json
+{
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  }
+}
+```
+
+多入口同理，所有路径指向 `dist/`。
+
+### 例外
+
+- `workflow-gateway`（Cloudflare Workers）和 `workflow-dashboard`（私有 app）不发 npm，exports 可指向 `src/`。
+
 ## Toolchain
 
 | Tool | Purpose |
@@ -246,47 +276,61 @@ bun run format      # biome format --write
 bun test            # run tests
 ```
 
-### Version Management & Publishing
+### Publishing to Gitea npm Registry
 
-All public `@uncaged/*` packages are published to **npmjs.org** via `@changesets/cli` with **fixed mode** (all packages share the same version number). `workflow-dashboard` is private and excluded.
+All public `@uncaged/*` packages are published to the Gitea npm registry at `git.shazhou.work`. Workflow workspaces consume packages from this registry via `bunfig.toml`.
 
 ```bash
-# 1. After making changes, add a changeset describing the change
-bun changeset
+# Publish all packages (bun pm pack resolves workspace:* → actual versions)
+bun run publish:gitea
 
-# 2. Before release, bump all package versions + generate CHANGELOGs
-bun version
-
-# 3. Build, test, and publish to npmjs
-bun release
+# Dry run — see what would be published
+bun run publish:gitea:dry
 ```
 
-- `workspace:^` dependencies resolve to `^x.y.z` on publish
-- Changesets config: `.changeset/config.json` (fixed mode, public access)
-- Each package has auto-generated `CHANGELOG.md`
+Prerequisites: `.npmrc` in monorepo root with Gitea auth token (`//git.shazhou.work/api/packages/shazhou/npm/:_authToken=<token>`).
 
-### Consuming @uncaged/* Packages
+### Workflow Workspace Setup
 
-External workflow repos just `bun install` — packages come from npmjs like any other dependency. No special registry config needed.
+External workflow repos (e.g. `xingyue-workflows`) use the Gitea registry for `@uncaged/*` packages. Add a `bunfig.toml`:
+
+```toml
+[install.scopes]
+"@uncaged" = "https://git.shazhou.work/api/packages/shazhou/npm/"
+```
+
+Then `bun install` resolves `@uncaged/*` from Gitea, all other packages from npmjs.
+
+### Cross-repo Development (bun link)
+
+Alternative for development against un-published local changes:
+
+```bash
+bun run link            # Register all packages (from monorepo root)
+bun run link:consume    # Link into CWD's project (⚠️ don't bun install after)
+bun run link:unlink     # Restore original deps
+```
 
 ### End-to-end: Monorepo → Registry → Workspace → Bundle
 
+The recommended development flow for building workflows:
+
 ```
 workflow/ (monorepo)           — engine, runtime, templates, agents
-  │  bun release               — build + test + changeset publish
+  │  bun run publish:gitea     — auto topo-sort, bun pm pack → npm publish
   ▼
-npmjs.org                      — @uncaged/* scoped packages (public)
-  │  bun install
+git.shazhou.work npm registry  — @uncaged/* scoped packages
+  │  bun install               — via bunfig.toml scoped registry
   ▼
-my-workflows/ (workspace)     — normal package.json
+my-workflows/ (workspace)     — bunfig.toml + normal package.json
   │  bun run build:develop     — bun build → single .esm.js
   ▼
 uncaged-workflow workflow add  — register bundle locally
 uncaged-workflow run           — execute workflow
 ```
 
-1. **Monorepo changes** → `bun changeset` (describe change) → `bun version` (bump) → `bun release` (publish)
-2. **Workspace** → `bun install` fetches latest from npmjs
+1. **Monorepo changes** → `bun run publish:gitea` (packages auto-discovered from `packages/*/`, topologically sorted, `workspace:*` resolved to real versions)
+2. **Workspace** → `bun install` fetches latest from Gitea, `bun install` is safe to run anytime
 3. **Build** → produces single-file ESM bundle with `@uncaged/*` as externals
 4. **Register & Run** → `uncaged-workflow workflow add <name> <bundle>` then `uncaged-workflow run <name>`
 

biome.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.4.15/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.14/schema.json",
   "files": {
     "includes": ["**", "!**/dist", "!**/node_modules", "!packages/workflow/workflow"]
   },

develop-entry.ts

@@ -1,15 +0,0 @@
-import { createCursorAgent } from "./packages/workflow-agent-cursor/src/index.js";
-import { createWorkflow } from "./packages/workflow-runtime/src/create-workflow.js";
-import {
-  buildDevelopDescriptor,
-  developWorkflowDefinition,
-} from "./packages/workflow-template-develop/src/index.js";
-
-const agent = createCursorAgent({
-  command: "/home/azureuser/.local/bin/cursor-agent",
-  model: "auto",
-  timeout: 300_000,
-});
-
-export const descriptor = buildDevelopDescriptor();
-export const run = createWorkflow(developWorkflowDefinition, { adapter: agent, overrides: null });

package.json

@@ -6,17 +6,18 @@
   ],
   "scripts": {
     "build": "bunx tsc --build",
-    "check": "bunx tsc --build && biome check . && bash scripts/lint-log-tags.sh",
+    "check": "bunx tsc --build && biome check .",
     "typecheck": "bunx tsc --build",
     "format": "biome format --write .",
     "test": "bun run --filter '*' test",
-    "changeset": "bunx changeset",
-    "version": "bunx changeset version",
-    "release": "bun run build && bun test && npx changeset publish --no-git-tag"
+    "link": "./scripts/link-all.sh",
+    "link:consume": "./scripts/link-all.sh --consume",
+    "link:unlink": "./scripts/link-all.sh --unlink",
+    "publish:gitea": "./scripts/publish.sh patch",
+    "publish:gitea:dry": "./scripts/publish.sh --dry-run patch"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.14",
-    "@changesets/cli": "^2.31.0",
     "@types/node": "^25.7.0",
     "@types/xxhashjs": "^0.2.4",
     "bun-types": "^1.3.13"

packages/cli-workflow/CHANGELOG.md

@@ -1,72 +0,0 @@
-# @uncaged/cli-workflow
-
-## 0.4.5
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.5
-  - @uncaged/workflow-cas@0.4.5
-  - @uncaged/workflow-execute@0.4.5
-  - @uncaged/workflow-gateway@0.4.5
-  - @uncaged/workflow-register@0.4.5
-  - @uncaged/workflow-runtime@0.4.5
-  - @uncaged/workflow-util@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.4
-  - @uncaged/workflow-cas@0.4.4
-  - @uncaged/workflow-execute@0.4.4
-  - @uncaged/workflow-gateway@0.4.4
-  - @uncaged/workflow-register@0.4.4
-  - @uncaged/workflow-runtime@0.4.4
-  - @uncaged/workflow-util@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-cas@0.4.3
-  - @uncaged/workflow-execute@0.4.3
-  - @uncaged/workflow-gateway@0.4.3
-  - @uncaged/workflow-protocol@0.4.3
-  - @uncaged/workflow-register@0.4.3
-  - @uncaged/workflow-runtime@0.4.3
-  - @uncaged/workflow-util@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-cas@0.4.2
-  - @uncaged/workflow-execute@0.4.2
-  - @uncaged/workflow-gateway@0.4.2
-  - @uncaged/workflow-protocol@0.4.2
-  - @uncaged/workflow-register@0.4.2
-  - @uncaged/workflow-runtime@0.4.2
-  - @uncaged/workflow-util@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-cas@0.4.0
-  - @uncaged/workflow-execute@0.4.0
-  - @uncaged/workflow-gateway@0.4.0
-  - @uncaged/workflow-protocol@0.4.0
-  - @uncaged/workflow-register@0.4.0
-  - @uncaged/workflow-runtime@0.4.0
-  - @uncaged/workflow-util@0.4.0

packages/cli-workflow/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/cli-workflow",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
     "src",
     "dist",
@@ -11,20 +11,17 @@
     "uncaged-workflow": "src/cli.ts"
   },
   "dependencies": {
-    "@uncaged/workflow-gateway": "workspace:^",
-    "@uncaged/workflow-protocol": "workspace:^",
-    "@uncaged/workflow-util": "workspace:^",
-    "@uncaged/workflow-cas": "workspace:^",
-    "@uncaged/workflow-execute": "workspace:^",
-    "@uncaged/workflow-register": "workspace:^",
-    "@uncaged/workflow-runtime": "workspace:^",
+    "@uncaged/workflow-gateway": "workspace:*",
+    "@uncaged/workflow-protocol": "workspace:*",
+    "@uncaged/workflow-util": "workspace:*",
+    "@uncaged/workflow-cas": "workspace:*",
+    "@uncaged/workflow-execute": "workspace:*",
+    "@uncaged/workflow-register": "workspace:*",
+    "@uncaged/workflow-runtime": "workspace:*",
     "hono": "^4.12.18",
     "yaml": "^2.8.4"
   },
   "scripts": {
     "test": "bun test"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

packages/cli-workflow/src/commands/serve/serve.ts

@@ -6,7 +6,7 @@ import { serve } from "bun";
 
 import { printCliLine } from "../../cli-output.js";
 import { createApp } from "./app.js";
-import { registerWithGateway, startHeartbeat, unregisterFromGateway } from "./gateway.js";
+import { registerWithGateway, startHeartbeat, unregisterFromGateway } from "./tunnel.js";
 import type { ServeOptions } from "./types.js";
 import { startGatewayWsClient } from "./ws-client.js";
 
@@ -52,6 +52,8 @@ function parseServeArgv(argv: string[]): Result<ServeOptions, string> {
   let port = 7860;
   let hostname = "127.0.0.1";
   let name = osHostname().split(".")[0].toLowerCase();
+  let noTunnel = false;
+  let tunnelUrl: string | null = null;
   let gatewayUrl = DEFAULT_GATEWAY_URL;
   const gatewaySecret = process.env.WORKFLOW_GATEWAY_SECRET ?? "";
   const stringFlags: Record<string, (v: string) => void> = {
@@ -64,6 +66,9 @@ function parseServeArgv(argv: string[]): Result<ServeOptions, string> {
     "--gateway": (v) => {
       gatewayUrl = v;
     },
+    "--tunnel-url": (v) => {
+      tunnelUrl = v;
+    },
   };
 
   for (let i = 0; i < argv.length; i++) {
@@ -73,6 +78,8 @@ function parseServeArgv(argv: string[]): Result<ServeOptions, string> {
       if (!portResult.ok) return portResult;
       port = portResult.value;
       i++;
+    } else if (arg === "--no-tunnel") {
+      noTunnel = true;
     } else if (arg in stringFlags) {
       const r = requireNextArg(argv, i, arg);
       if (!r.ok) return r;
@@ -81,7 +88,7 @@ function parseServeArgv(argv: string[]): Result<ServeOptions, string> {
     }
   }
 
-  return ok({ port, hostname, name, gatewayUrl, gatewaySecret });
+  return ok({ port, hostname, name, noTunnel, tunnelUrl, gatewayUrl, gatewaySecret });
 }
 
 export async function dispatchServe(storageRoot: string, argv: string[]): Promise<number> {
@@ -92,62 +99,81 @@ export async function dispatchServe(storageRoot: string, argv: string[]): Promis
   }
 
   const options = parsed.value;
+  const agentToken = options.noTunnel ? null : randomUUID();
+  startServer(storageRoot, options, agentToken);
 
-  if (options.gatewaySecret === "") {
-    // No gateway — local-only mode
-    startServer(storageRoot, options, null);
-    printCliLine("no WORKFLOW_GATEWAY_SECRET — running in local-only mode");
+  if (options.noTunnel) {
+    printCliLine("tunnel disabled (--no-tunnel)");
     await new Promise(() => {});
     return 0;
   }
 
-  const agentToken = randomUUID();
-  startServer(storageRoot, options, agentToken);
+  let resolvedTunnelUrl: string;
+  let stopWsClient: (() => void) | null = null;
 
-  // Start WebSocket reverse connection to gateway
-  const log = createLogger({ sink: { kind: "stderr" } });
-  const stopWsClient = startGatewayWsClient({
-    gatewayUrl: options.gatewayUrl,
-    name: options.name,
-    secret: options.gatewaySecret,
-    localPort: options.port,
-    log,
-  });
-
-  printCliLine("connected to gateway via WebSocket");
-
-  // Register with gateway for discovery
-  const localUrl = `http://127.0.0.1:${options.port}`;
-  const registered = await registerWithGateway(
-    options.gatewayUrl,
-    options.name,
-    localUrl,
-    options.gatewaySecret,
-    agentToken,
-  );
-  if (registered) {
-    printCliLine(`registered with gateway as "${options.name}"`);
+  if (options.tunnelUrl !== null) {
+    resolvedTunnelUrl = options.tunnelUrl;
+    printCliLine(`using tunnel URL: ${resolvedTunnelUrl}`);
+  } else {
+    if (options.gatewaySecret === "") {
+      printCliLine(
+        "WORKFLOW_GATEWAY_SECRET not set — cannot use WebSocket gateway connection (set env or pass --tunnel-url)",
+      );
+      await new Promise(() => {});
+      return 0;
+    }
+    resolvedTunnelUrl = `http://127.0.0.1:${options.port}`;
+    const log = createLogger({ sink: { kind: "stderr" } });
+    stopWsClient = startGatewayWsClient({
+      gatewayUrl: options.gatewayUrl,
+      name: options.name,
+      secret: options.gatewaySecret,
+      localPort: options.port,
+      log,
+    });
+    printCliLine("gateway WebSocket reverse connection (no cloudflared)");
   }
 
-  const heartbeatTimer = startHeartbeat(
-    options.gatewayUrl,
-    options.name,
-    localUrl,
-    options.gatewaySecret,
-    agentToken,
-    HEARTBEAT_INTERVAL_MS,
-  );
+  if (options.gatewaySecret) {
+    if (agentToken === null) {
+      printCliLine("internal error: agent token missing");
+      await new Promise(() => {});
+      return 1;
+    }
+    const token = agentToken;
+    const registered = await registerWithGateway(
+      options.gatewayUrl,
+      options.name,
+      resolvedTunnelUrl,
+      options.gatewaySecret,
+      token,
+    );
+    if (registered) {
+      printCliLine(`registered with gateway as "${options.name}"`);
+    }
 
-  const cleanup = async () => {
-    clearInterval(heartbeatTimer);
-    stopWsClient();
-    printCliLine("unregistering from gateway...");
-    await unregisterFromGateway(options.gatewayUrl, options.name, options.gatewaySecret);
-    process.exit(0);
-  };
+    const heartbeatTimer = startHeartbeat(
+      options.gatewayUrl,
+      options.name,
+      resolvedTunnelUrl,
+      options.gatewaySecret,
+      token,
+      HEARTBEAT_INTERVAL_MS,
+    );
 
-  process.on("SIGINT", cleanup);
-  process.on("SIGTERM", cleanup);
+    const cleanup = async () => {
+      clearInterval(heartbeatTimer);
+      stopWsClient?.();
+      printCliLine("unregistering from gateway...");
+      await unregisterFromGateway(options.gatewayUrl, options.name, options.gatewaySecret);
+      process.exit(0);
+    };
+
+    process.on("SIGINT", cleanup);
+    process.on("SIGTERM", cleanup);
+  } else {
+    printCliLine("WORKFLOW_GATEWAY_SECRET not set — skipping gateway registration");
+  }
 
   await new Promise(() => {});
   return 0;

packages/cli-workflow/src/commands/serve/tunnel.ts

@@ -1,9 +1,43 @@
 import { printCliLine } from "../../cli-output.js";
 
+type TunnelHandle = {
+  process: ReturnType<typeof Bun.spawn>;
+  url: string;
+};
+
+export async function startTunnel(port: number): Promise<TunnelHandle | null> {
+  const proc = Bun.spawn(["cloudflared", "tunnel", "--url", `http://localhost:${port}`], {
+    stdout: "pipe",
+    stderr: "pipe",
+  });
+
+  // cloudflared prints the URL to stderr
+  const reader = proc.stderr.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  const deadline = Date.now() + 30_000;
+
+  while (Date.now() < deadline) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const match = buffer.match(/https:\/\/[a-z0-9-]+\.trycloudflare\.com/);
+    if (match) {
+      // Release the reader so stderr keeps flowing without backpressure
+      reader.releaseLock();
+      return { process: proc, url: match[0] };
+    }
+  }
+
+  reader.releaseLock();
+  proc.kill();
+  return null;
+}
+
 export async function registerWithGateway(
   gatewayUrl: string,
   name: string,
-  localUrl: string,
+  tunnelUrl: string,
   secret: string,
   agentToken: string,
 ): Promise<boolean> {
@@ -11,7 +45,7 @@ export async function registerWithGateway(
     const resp = await fetch(`${gatewayUrl}/api/gateway/register`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ name, url: localUrl, secret, agentToken }),
+      body: JSON.stringify({ name, url: tunnelUrl, secret, agentToken }),
     });
     if (!resp.ok) {
       const body = await resp.text();
@@ -43,12 +77,12 @@ export async function unregisterFromGateway(
 export function startHeartbeat(
   gatewayUrl: string,
   name: string,
-  localUrl: string,
+  tunnelUrl: string,
   secret: string,
   agentToken: string,
   intervalMs: number,
 ): ReturnType<typeof setInterval> {
   return setInterval(() => {
-    registerWithGateway(gatewayUrl, name, localUrl, secret, agentToken).catch(() => {});
+    registerWithGateway(gatewayUrl, name, tunnelUrl, secret, agentToken).catch(() => {});
   }, intervalMs);
 }

packages/cli-workflow/src/commands/serve/types.ts

@@ -2,6 +2,8 @@ export type ServeOptions = {
   port: number;
   hostname: string;
   name: string;
+  noTunnel: boolean;
+  tunnelUrl: string | null;
   gatewayUrl: string;
   gatewaySecret: string;
 };

packages/cli-workflow/src/commands/serve/ws-client.ts

@@ -100,7 +100,7 @@ export function startGatewayWsClient(params: GatewayWsClientParams): () => void
     clearReconnectTimer();
     const delayMs = Math.min(INITIAL_BACKOFF_MS * 2 ** attempt, MAX_BACKOFF_MS);
     attempt++;
-    params.log("6CJX2R8P", `gateway WebSocket reconnect in ${delayMs}ms (attempt ${attempt})`);
+    params.log("6CJX2RLP", `gateway WebSocket reconnect in ${delayMs}ms (attempt ${attempt})`);
     reconnectTimer = setTimeout(connect, delayMs);
   };
 
@@ -143,7 +143,7 @@ export function startGatewayWsClient(params: GatewayWsClientParams): () => void
     ws.addEventListener("message", (ev) => {
       const data = ev.data;
       if (typeof data !== "string") {
-        params.log("T9W2K35H", "gateway WebSocket non-text frame ignored");
+        params.log("T9W2KL5H", "gateway WebSocket non-text frame ignored");
         return;
       }
       void handleGatewayMessage(ws, data, params).catch((e: unknown) => {

packages/cli-workflow/src/skill.ts

@@ -90,7 +90,7 @@ ${commandSections.join("\n\n")}
 
 | Command | Args | Description |
 |---------|------|-------------|
-| \`serve\` | \`[--port N] [--host ADDR] [--name NAME]\` | Start HTTP API server with WebSocket gateway connection. \`--name\` registers with the gateway. |
+| \`serve\` | \`[--port N] [--host ADDR] [--name NAME]\` | Start HTTP API server with auto-tunnel. \`--name\` registers with the gateway. |
 
 ## Typical Workflow
 

packages/workflow-agent-cursor/CHANGELOG.md

@@ -1,62 +0,0 @@
-# @uncaged/workflow-agent-cursor
-
-## 0.4.5
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.5
-  - @uncaged/workflow-reactor@0.4.5
-  - @uncaged/workflow-runtime@0.4.5
-  - @uncaged/workflow-util@0.4.5
-  - @uncaged/workflow-util-agent@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.4
-  - @uncaged/workflow-reactor@0.4.4
-  - @uncaged/workflow-runtime@0.4.4
-  - @uncaged/workflow-util@0.4.4
-  - @uncaged/workflow-util-agent@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.3
-  - @uncaged/workflow-reactor@0.4.3
-  - @uncaged/workflow-runtime@0.4.3
-  - @uncaged/workflow-util-agent@0.4.3
-  - @uncaged/workflow-util@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.2
-  - @uncaged/workflow-reactor@0.4.2
-  - @uncaged/workflow-runtime@0.4.2
-  - @uncaged/workflow-util-agent@0.4.2
-  - @uncaged/workflow-util@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.0
-  - @uncaged/workflow-reactor@0.4.0
-  - @uncaged/workflow-runtime@0.4.0
-  - @uncaged/workflow-util-agent@0.4.0
-  - @uncaged/workflow-util@0.4.0

packages/workflow-agent-cursor/__tests__/cursor-agent.test.ts

@@ -2,11 +2,24 @@ import { describe, expect, test } from "bun:test";
 import { createCursorAgent, validateCursorAgentConfig } from "../src/index.js";
 
 describe("validateCursorAgentConfig", () => {
-  test("accepts valid config", () => {
+  test("accepts valid config with explicit workspace", () => {
     const r = validateCursorAgentConfig({
       command: "/usr/local/bin/cursor-agent",
       model: null,
       timeout: 0,
+      workspace: "/tmp/test-project",
+      llmProvider: null,
+    });
+    expect(r.ok).toBe(true);
+  });
+
+  test("accepts valid config with null workspace and llmProvider", () => {
+    const r = validateCursorAgentConfig({
+      command: "/usr/local/bin/cursor-agent",
+      model: null,
+      timeout: 0,
+      workspace: null,
+      llmProvider: { baseUrl: "http://localhost", apiKey: "test", model: "test" },
     });
     expect(r.ok).toBe(true);
   });
@@ -16,6 +29,8 @@ describe("validateCursorAgentConfig", () => {
       command: "cursor-agent",
       model: null,
       timeout: 0,
+      workspace: "/tmp/test-project",
+      llmProvider: null,
     });
     expect(r.ok).toBe(false);
     if (!r.ok) {
@@ -23,22 +38,65 @@ describe("validateCursorAgentConfig", () => {
     }
   });
 
+  test("rejects empty workspace string", () => {
+    const r = validateCursorAgentConfig({
+      command: "/usr/local/bin/cursor-agent",
+      model: null,
+      timeout: 0,
+      workspace: "",
+      llmProvider: null,
+    });
+    expect(r.ok).toBe(false);
+    if (!r.ok) {
+      expect(r.error).toContain("workspace");
+    }
+  });
+
+  test("rejects null workspace without llmProvider", () => {
+    const r = validateCursorAgentConfig({
+      command: "/usr/local/bin/cursor-agent",
+      model: null,
+      timeout: 0,
+      workspace: null,
+      llmProvider: null,
+    });
+    expect(r.ok).toBe(false);
+    if (!r.ok) {
+      expect(r.error).toContain("llmProvider");
+    }
+  });
+
   test("rejects negative timeout", () => {
     const r = validateCursorAgentConfig({
       command: "/usr/local/bin/cursor-agent",
       model: null,
       timeout: -1,
+      workspace: "/tmp/test-project",
+      llmProvider: null,
     });
     expect(r.ok).toBe(false);
   });
 });
 
 describe("createCursorAgent", () => {
-  test("returns an AdapterFn", () => {
+  test("returns an AdapterFn with explicit workspace", () => {
     const agent = createCursorAgent({
       command: "/usr/local/bin/cursor-agent",
       model: null,
       timeout: 0,
+      workspace: "/tmp/test-project",
+      llmProvider: null,
+    });
+    expect(typeof agent).toBe("function");
+  });
+
+  test("returns an AdapterFn with null workspace and llmProvider", () => {
+    const agent = createCursorAgent({
+      command: "/usr/local/bin/cursor-agent",
+      model: null,
+      timeout: 0,
+      workspace: null,
+      llmProvider: { baseUrl: "http://localhost", apiKey: "test", model: "test" },
     });
     expect(typeof agent).toBe("function");
   });
@@ -48,6 +106,19 @@ describe("createCursorAgent", () => {
       command: "/usr/local/bin/cursor-agent",
       model: null,
       timeout: -1,
+      workspace: "/tmp/test-project",
+      llmProvider: null,
+    });
+    expect(typeof agent).toBe("function");
+  });
+
+  test("defers validation — null workspace without llmProvider does not throw at construction", () => {
+    const agent = createCursorAgent({
+      command: "/usr/local/bin/cursor-agent",
+      model: null,
+      timeout: 0,
+      workspace: null,
+      llmProvider: null,
     });
     expect(typeof agent).toBe("function");
   });

packages/workflow-agent-cursor/package.json

@@ -1,32 +1,28 @@
 {
   "name": "@uncaged/workflow-agent-cursor",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
+  "main": "src/index.ts",
   "types": "src/index.ts",
   "scripts": {
     "test": "bun test"
   },
   "dependencies": {
-    "@uncaged/workflow-cas": "workspace:^",
-    "@uncaged/workflow-protocol": "workspace:^",
-    "@uncaged/workflow-runtime": "workspace:^",
-    "@uncaged/workflow-util": "workspace:^",
-    "@uncaged/workflow-util-agent": "workspace:^",
+    "@uncaged/workflow-protocol": "workspace:*",
+    "@uncaged/workflow-reactor": "workspace:*",
+    "@uncaged/workflow-runtime": "workspace:*",
+    "@uncaged/workflow-util": "workspace:*",
+    "@uncaged/workflow-util-agent": "workspace:*",
     "zod": "^4.0.0"
   },
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

packages/workflow-agent-cursor/src/extract-workspace.ts

@@ -1,5 +1,5 @@
-import { putContentNodeWithRefs } from "@uncaged/workflow-cas";
-import type { ThreadContext, WorkflowRuntime } from "@uncaged/workflow-runtime";
+import type { AgentContext, LlmProvider } from "@uncaged/workflow-protocol";
+import { createLlmFn, createThreadReactor } from "@uncaged/workflow-reactor";
 import type { LogFn } from "@uncaged/workflow-util";
 import * as z from "zod/v4";
 
@@ -7,7 +7,10 @@ const workspaceSchema = z.object({
   workspace: z.string().describe("Absolute filesystem path of the project workspace"),
 });
 
-function buildExtractionInput(ctx: ThreadContext): string {
+const EXTRACT_SYSTEM_FN = (_toolName: string) =>
+  `You are a workspace-path extractor. Given a workflow agent context (task description and previous step outputs), identify the absolute filesystem path of the project workspace where code changes should be made. Call the tool with the absolute path.`;
+
+function buildExtractionInput(ctx: AgentContext): string {
   const lines: string[] = [];
   lines.push("## Task");
   lines.push(ctx.start.content);
@@ -18,25 +21,48 @@ function buildExtractionInput(ctx: ThreadContext): string {
     lines.push(`Meta: ${JSON.stringify(step.meta)}`);
   }
 
-  lines.push("");
-  lines.push(
-    "Extract the absolute filesystem path of the project workspace where code changes should be made.",
-  );
-
   return lines.join("\n");
 }
 
 export async function extractWorkspacePath(
-  ctx: ThreadContext,
-  runtime: WorkflowRuntime,
+  ctx: AgentContext,
+  provider: LlmProvider,
   logger: LogFn,
 ): Promise<string | null> {
-  const input = buildExtractionInput(ctx);
-  const contentHash = await putContentNodeWithRefs(runtime.cas, input, []);
+  const reactor = createThreadReactor<null>({
+    llm: createLlmFn(provider),
+    maxRounds: 2,
+    staticTools: [],
+    structuredToolFromSchema: (schema) => {
+      const jsonSchema = z.toJSONSchema(schema);
+      return {
+        name: "set_workspace",
+        tool: {
+          type: "function" as const,
+          function: {
+            name: "set_workspace",
+            description: "Set the extracted workspace path",
+            parameters: jsonSchema as Record<string, unknown>,
+          },
+        },
+      };
+    },
+    systemPromptForStructuredTool: EXTRACT_SYSTEM_FN,
+    toolHandler: async () => "unknown tool",
+  });
 
-  const result = await runtime.extract(workspaceSchema, contentHash);
-  const workspace = result.meta.workspace.trim();
+  const result = await reactor({
+    thread: null,
+    input: buildExtractionInput(ctx),
+    schema: workspaceSchema,
+  });
 
+  if (!result.ok) {
+    logger("W8KN3QYT", `workspace extraction failed: ${result.error}`);
+    return null;
+  }
+
+  const workspace = result.value.workspace.trim();
   if (!workspace.startsWith("/")) {
     logger("H4PM7RXV", `workspace extraction returned non-absolute path: ${workspace}`);
     return null;

packages/workflow-agent-cursor/src/index.ts

@@ -1,4 +1,4 @@
-import type { WorkflowRuntime } from "@uncaged/workflow-runtime";
+import type { AdapterFn } from "@uncaged/workflow-runtime";
 import { createLogger } from "@uncaged/workflow-util";
 import {
   buildThreadInput,
@@ -33,23 +33,34 @@ function resolveCursorModel(model: string | null): string {
   return model === null ? "auto" : model;
 }
 
-/** Runs `cursor-agent` with workspace extracted from thread context via runtime.extract. */
-export function createCursorAgent(config: CursorAgentConfig) {
+/** Runs `cursor-agent` with workspace from config or extracted from context via LLM. */
+export function createCursorAgent(config: CursorAgentConfig): AdapterFn {
   const modelFlag = resolveCursorModel(config.model);
   const timeoutMs = config.timeout > 0 ? config.timeout : null;
   const logger = createLogger({ sink: { kind: "stderr" } });
 
-  return createTextAdapter(async (ctx, prompt, runtime: WorkflowRuntime) => {
+  return createTextAdapter(async (ctx, prompt) => {
     const validated = validateCursorAgentConfig(config);
     if (!validated.ok) {
       throw new Error(validated.error);
     }
 
-    const workspace = await extractWorkspacePath(ctx, runtime, logger);
-    if (workspace === null) {
-      throw new Error(
-        "cursor-agent: failed to extract workspace path from context. Ensure the task prompt or previous steps include a project path.",
-      );
+    let workspace: string;
+
+    if (config.workspace !== null) {
+      workspace = config.workspace;
+    } else {
+      if (config.llmProvider === null) {
+        throw new Error("cursor-agent: llmProvider is required when workspace is null");
+      }
+      const agentCtx = { ...ctx, currentRole: { name: "cursor", systemPrompt: prompt } };
+      const extracted = await extractWorkspacePath(agentCtx, config.llmProvider, logger);
+      if (extracted === null) {
+        throw new Error(
+          "cursor-agent: failed to extract workspace path from context. Provide an explicit workspace or ensure previous steps include a repoPath.",
+        );
+      }
+      workspace = extracted;
     }
 
     logger("R5HN3YKQ", `cursor-agent workspace: ${workspace}`);

packages/workflow-agent-cursor/src/types.ts

@@ -1,6 +1,12 @@
+import type { LlmProvider } from "@uncaged/workflow-protocol";
+
 export type CursorAgentConfig = {
   /** Absolute path to the cursor-agent CLI binary. */
   command: string;
   model: string | null;
   timeout: number;
+  /** Explicit workspace path. When `null`, the agent extracts workspace from AgentContext via a ReAct LLM call. */
+  workspace: string | null;
+  /** Required when `workspace` is `null` — LLM provider used for workspace extraction. */
+  llmProvider: LlmProvider | null;
 };

packages/workflow-agent-cursor/src/validate-config.ts

@@ -8,6 +8,12 @@ export function validateCursorAgentConfig(config: CursorAgentConfig): Result<voi
   if (!isAbsolute(config.command)) {
     return err("command must be an absolute path to the cursor-agent CLI binary");
   }
+  if (config.workspace !== null && config.workspace.length === 0) {
+    return err("workspace must be a non-empty string (absolute path) or null for auto-detection");
+  }
+  if (config.workspace === null && config.llmProvider === null) {
+    return err("llmProvider is required when workspace is null (needed for workspace extraction)");
+  }
   if (config.timeout < 0) {
     return err("timeout must be a non-negative number (milliseconds); use 0 for no limit");
   }

packages/workflow-agent-hermes/CHANGELOG.md

@@ -1,45 +0,0 @@
-# @uncaged/workflow-agent-hermes
-
-## 0.4.5
-
-### Patch Changes
-
-- @uncaged/workflow-runtime@0.4.5
-- @uncaged/workflow-util-agent@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- @uncaged/workflow-runtime@0.4.4
-- @uncaged/workflow-util-agent@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-runtime@0.4.3
-  - @uncaged/workflow-util-agent@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-runtime@0.4.2
-  - @uncaged/workflow-util-agent@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-runtime@0.4.0
-  - @uncaged/workflow-util-agent@0.4.0

packages/workflow-agent-hermes/package.json

@@ -1,28 +1,24 @@
 {
   "name": "@uncaged/workflow-agent-hermes",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
+  "main": "src/index.ts",
   "types": "src/index.ts",
   "scripts": {
     "test": "bun test"
   },
   "dependencies": {
-    "@uncaged/workflow-runtime": "workspace:^",
-    "@uncaged/workflow-util-agent": "workspace:^"
+    "@uncaged/workflow-runtime": "workspace:*",
+    "@uncaged/workflow-util-agent": "workspace:*"
   },
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

packages/workflow-agent-hermes/src/index.ts

@@ -33,7 +33,7 @@ function throwHermesSpawnError(error: SpawnCliError): never {
 export function createHermesAgent(config: HermesAgentConfig): AdapterFn {
   const timeoutMs = config.timeout;
 
-  return createTextAdapter(async (ctx, prompt, _runtime) => {
+  return createTextAdapter(async (ctx, prompt) => {
     const validated = validateHermesAgentConfig(config);
     if (!validated.ok) {
       throw new Error(validated.error);

packages/workflow-agent-llm/CHANGELOG.md

@@ -1,45 +0,0 @@
-# @uncaged/workflow-agent-llm
-
-## 0.4.5
-
-### Patch Changes
-
-- @uncaged/workflow-runtime@0.4.5
-- @uncaged/workflow-util-agent@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- @uncaged/workflow-runtime@0.4.4
-- @uncaged/workflow-util-agent@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-runtime@0.4.3
-  - @uncaged/workflow-util-agent@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-runtime@0.4.2
-  - @uncaged/workflow-util-agent@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-runtime@0.4.0
-  - @uncaged/workflow-util-agent@0.4.0

packages/workflow-agent-llm/package.json

@@ -1,31 +1,27 @@
 {
   "name": "@uncaged/workflow-agent-llm",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
+  "main": "src/index.ts",
   "types": "src/index.ts",
   "scripts": {
     "test": "bun test"
   },
   "dependencies": {
-    "@uncaged/workflow-runtime": "workspace:^",
-    "@uncaged/workflow-util-agent": "workspace:^"
+    "@uncaged/workflow-runtime": "workspace:*",
+    "@uncaged/workflow-util-agent": "workspace:*"
   },
   "devDependencies": {
     "zod": "^4.0.0"
   },
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

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

@@ -93,7 +93,7 @@ export async function chatCompletionText(options: {
 
 /** Single-turn chat adapter: system prompt is passed by the workflow engine. */
 export function createLlmAdapter(provider: LlmProvider): AdapterFn {
-  return createTextAdapter(async (ctx, prompt, _runtime) => {
+  return createTextAdapter(async (ctx, prompt) => {
     const result = await chatCompletionText({
       provider,
       messages: [

packages/workflow-agent-react/CHANGELOG.md

@@ -1,52 +0,0 @@
-# @uncaged/workflow-agent-react
-
-## 0.4.5
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.5
-  - @uncaged/workflow-reactor@0.4.5
-  - @uncaged/workflow-util-agent@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.4
-  - @uncaged/workflow-reactor@0.4.4
-  - @uncaged/workflow-util-agent@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.3
-  - @uncaged/workflow-reactor@0.4.3
-  - @uncaged/workflow-util-agent@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.2
-  - @uncaged/workflow-reactor@0.4.2
-  - @uncaged/workflow-util-agent@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.0
-  - @uncaged/workflow-reactor@0.4.0
-  - @uncaged/workflow-util-agent@0.4.0

packages/workflow-agent-react/package.json

@@ -1,16 +1,13 @@
 {
   "name": "@uncaged/workflow-agent-react",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
-  "types": "src/index.ts",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
@@ -19,17 +16,14 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@uncaged/workflow-protocol": "workspace:^",
-    "@uncaged/workflow-reactor": "workspace:^",
-    "@uncaged/workflow-util-agent": "workspace:^"
+    "@uncaged/workflow-protocol": "workspace:*",
+    "@uncaged/workflow-reactor": "workspace:*",
+    "@uncaged/workflow-util-agent": "workspace:*"
   },
   "devDependencies": {
     "zod": "^4.0.0"
   },
   "peerDependencies": {
     "zod": "^4.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

packages/workflow-cas/CHANGELOG.md

@@ -1,47 +0,0 @@
-# @uncaged/workflow-cas
-
-## 0.4.5
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.5
-  - @uncaged/workflow-util@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.4
-  - @uncaged/workflow-util@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.3
-  - @uncaged/workflow-util@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.2
-  - @uncaged/workflow-util@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.0
-  - @uncaged/workflow-util@0.4.0

packages/workflow-cas/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@uncaged/workflow-cas",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
@@ -12,21 +11,17 @@
   },
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
   },
   "dependencies": {
-    "@uncaged/workflow-protocol": "workspace:^",
-    "@uncaged/workflow-util": "workspace:^",
+    "@uncaged/workflow-protocol": "workspace:*",
+    "@uncaged/workflow-util": "workspace:*",
     "xxhashjs": "^0.2.2",
     "yaml": "^2.7.1"
   },
   "devDependencies": {
     "@types/bun": "latest"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

packages/workflow-dashboard/src/components/workflow-graph/condition-edge.tsx

@@ -1,4 +1,9 @@
-import { BaseEdge, EdgeLabelRenderer, type EdgeProps, getSmoothStepPath } from "@xyflow/react";
+import {
+  BaseEdge,
+  EdgeLabelRenderer,
+  type EdgeProps,
+  getSmoothStepPath,
+} from "@xyflow/react";
 import type { ConditionEdgeData } from "./types.ts";
 
 // Must match the FEEDBACK_OFFSET_X in use-layout.ts
@@ -10,7 +15,12 @@ const FEEDBACK_RADIUS = 16;
  * Build an SVG path for a feedback (back) edge that routes to the right of the nodes.
  * The path goes: source right → arc → vertical up → arc → target right
  */
-function feedbackPath(sourceX: number, sourceY: number, targetX: number, targetY: number): string {
+function feedbackPath(
+  sourceX: number,
+  sourceY: number,
+  targetX: number,
+  targetY: number,
+): string {
   const rightX = Math.max(sourceX, targetX) + FEEDBACK_OFFSET_X;
   const r = FEEDBACK_RADIUS;
 
@@ -32,7 +42,6 @@ function feedbackPath(sourceX: number, sourceY: number, targetX: number, targetY
   return segments.join(" ");
 }
 
-// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: edge routing logic is inherently branchy
 export function ConditionEdge(props: EdgeProps) {
   const {
     id,

packages/workflow-dashboard/src/components/workflow-graph/use-layout.ts

@@ -1,7 +1,7 @@
 import type { Edge, Node } from "@xyflow/react";
 import { useMemo } from "react";
 import type { WorkflowGraphEdge } from "../../api.ts";
-import type { NodeState, RoleNodeData, TerminalNodeData } from "./types.ts";
+import type { ConditionEdgeData, NodeState, RoleNodeData, TerminalNodeData } from "./types.ts";
 
 const START_ID = "__start__";
 const END_ID = "__end__";
@@ -41,7 +41,6 @@ function edgeKey(e: WorkflowGraphEdge): string {
  * Forward edges go from lower rank to higher rank; feedback edges go backwards.
  * Self-loops are neither forward nor feedback — they're handled separately.
  */
-// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: topological sort is inherently branchy
 function extractSpine(edges: readonly WorkflowGraphEdge[]): string[] {
   // Collect all node IDs
   const ids = new Set<string>();
@@ -214,8 +213,8 @@ function computeLayout(input: LayoutInput): LayoutResult {
         isFallback,
         isFeedback,
         isSelfLoop,
-        labelX,
-        labelY,
+      labelX,
+      labelY,
       },
     };
   });
@@ -224,5 +223,8 @@ function computeLayout(input: LayoutInput): LayoutResult {
 }
 
 export function useLayout(input: LayoutInput): LayoutResult {
-  return useMemo(() => computeLayout(input), [input]);
+  return useMemo(
+    () => computeLayout(input),
+    [input.edges, input.roles, input.nodeStates],
+  );
 }

packages/workflow-dashboard/src/components/workflow-list.tsx

@@ -48,7 +48,10 @@ function ExpandedWorkflowBody({
   const hasGraph = descriptor !== null && edgeCount > 0;
 
   return (
-    <div className="pt-3 border-t flex gap-4" style={{ borderColor: "var(--color-border)" }}>
+    <div
+      className="pt-3 border-t flex gap-4"
+      style={{ borderColor: "var(--color-border)" }}
+    >
       <div className="space-y-3 shrink-0" style={{ minWidth: 200, maxWidth: 280 }}>
         <div>
           <p className="text-sm font-medium" style={{ color: "var(--color-text)" }}>
@@ -80,11 +83,7 @@ function ExpandedWorkflowBody({
       {hasGraph ? (
         <div
           className="rounded-lg border overflow-hidden flex-1"
-          style={{
-            borderColor: "var(--color-border)",
-            background: "var(--color-bg)",
-            minHeight: 500,
-          }}
+          style={{ borderColor: "var(--color-border)", background: "var(--color-bg)", minHeight: 500 }}
         >
           <div
             className="px-3 py-2 text-xs flex justify-between items-center"

packages/workflow-execute/CHANGELOG.md

@@ -1,67 +0,0 @@
-# @uncaged/workflow-execute
-
-## 0.4.5
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.5
-  - @uncaged/workflow-cas@0.4.5
-  - @uncaged/workflow-reactor@0.4.5
-  - @uncaged/workflow-register@0.4.5
-  - @uncaged/workflow-runtime@0.4.5
-  - @uncaged/workflow-util@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.4
-  - @uncaged/workflow-cas@0.4.4
-  - @uncaged/workflow-reactor@0.4.4
-  - @uncaged/workflow-register@0.4.4
-  - @uncaged/workflow-runtime@0.4.4
-  - @uncaged/workflow-util@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-cas@0.4.3
-  - @uncaged/workflow-protocol@0.4.3
-  - @uncaged/workflow-reactor@0.4.3
-  - @uncaged/workflow-register@0.4.3
-  - @uncaged/workflow-runtime@0.4.3
-  - @uncaged/workflow-util@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-cas@0.4.2
-  - @uncaged/workflow-protocol@0.4.2
-  - @uncaged/workflow-reactor@0.4.2
-  - @uncaged/workflow-register@0.4.2
-  - @uncaged/workflow-runtime@0.4.2
-  - @uncaged/workflow-util@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-cas@0.4.0
-  - @uncaged/workflow-protocol@0.4.0
-  - @uncaged/workflow-reactor@0.4.0
-  - @uncaged/workflow-register@0.4.0
-  - @uncaged/workflow-runtime@0.4.0
-  - @uncaged/workflow-util@0.4.0

packages/workflow-execute/package.json

@@ -1,15 +1,13 @@
 {
   "name": "@uncaged/workflow-execute",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
@@ -18,12 +16,12 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@uncaged/workflow-protocol": "workspace:^",
-    "@uncaged/workflow-runtime": "workspace:^",
-    "@uncaged/workflow-util": "workspace:^",
-    "@uncaged/workflow-cas": "workspace:^",
-    "@uncaged/workflow-reactor": "workspace:^",
-    "@uncaged/workflow-register": "workspace:^",
+    "@uncaged/workflow-protocol": "workspace:*",
+    "@uncaged/workflow-runtime": "workspace:*",
+    "@uncaged/workflow-util": "workspace:*",
+    "@uncaged/workflow-cas": "workspace:*",
+    "@uncaged/workflow-reactor": "workspace:*",
+    "@uncaged/workflow-register": "workspace:*",
     "yaml": "^2.7.1"
   },
   "peerDependencies": {
@@ -31,8 +29,5 @@
   },
   "devDependencies": {
     "zod": "^4.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

packages/workflow-execute/src/engine/worker-entry-path.ts

@@ -1,6 +1,11 @@
 import { fileURLToPath } from "node:url";
 
-/** Absolute path to `worker-host.ts` for spawning bundle worker processes. */
+/**
+ * Absolute path to the worker script for spawning bundle worker processes.
+ *
+ * Uses `.js` extension so it resolves correctly whether running from
+ * src/ (bun handles .js → .ts) or dist/ (compiled .js exists).
+ */
 export function getWorkerHostScriptPath(): string {
-  return fileURLToPath(new URL("./worker.ts", import.meta.url));
+  return fileURLToPath(new URL("./worker.js", import.meta.url));
 }

packages/workflow-gateway/CHANGELOG.md

@@ -1,23 +0,0 @@
-# @uncaged/workflow-gateway
-
-## 0.4.5
-
-## 0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.

packages/workflow-gateway/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@uncaged/workflow-gateway",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
@@ -21,8 +20,5 @@
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20260425.1",
     "wrangler": "^4.20.0"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

packages/workflow-protocol/CHANGELOG.md

@@ -1,31 +0,0 @@
-# @uncaged/workflow-protocol
-
-## 0.4.5
-
-### Patch Changes
-
-- Add publishConfig to all packages for Gitea registry compatibility with changeset publish.
-
-## 0.4.4
-
-### Patch Changes
-
-- Test changeset publish with Gitea registry.
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.

packages/workflow-protocol/package.json

@@ -1,20 +1,17 @@
 {
   "name": "@uncaged/workflow-protocol",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
     "./moderator-table.js": {
-      "bun": "./src/moderator-table.ts",
       "types": "./dist/moderator-table.d.ts",
       "import": "./dist/moderator-table.js"
     }
@@ -25,8 +22,5 @@
   "devDependencies": {
     "zod": "^4.0.0",
     "typescript": "^5.8.3"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

packages/workflow-reactor/CHANGELOG.md

@@ -1,42 +0,0 @@
-# @uncaged/workflow-reactor
-
-## 0.4.5
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.0

packages/workflow-reactor/package.json

@@ -1,21 +1,19 @@
 {
   "name": "@uncaged/workflow-reactor",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
   },
   "dependencies": {
-    "@uncaged/workflow-protocol": "workspace:^"
+    "@uncaged/workflow-protocol": "workspace:*"
   },
   "peerDependencies": {
     "zod": "^4.0.0"
@@ -23,8 +21,5 @@
   "devDependencies": {
     "zod": "^4.0.0",
     "typescript": "^5.8.3"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

packages/workflow-register/CHANGELOG.md

@@ -1,47 +0,0 @@
-# @uncaged/workflow-register
-
-## 0.4.5
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.5
-  - @uncaged/workflow-util@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.4
-  - @uncaged/workflow-util@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.3
-  - @uncaged/workflow-util@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.2
-  - @uncaged/workflow-util@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.0
-  - @uncaged/workflow-util@0.4.0

packages/workflow-register/package.json

@@ -1,22 +1,20 @@
 {
   "name": "@uncaged/workflow-register",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
   },
   "dependencies": {
-    "@uncaged/workflow-protocol": "workspace:^",
-    "@uncaged/workflow-util": "workspace:^"
+    "@uncaged/workflow-protocol": "workspace:*",
+    "@uncaged/workflow-util": "workspace:*"
   },
   "peerDependencies": {
     "acorn": "^8.0.0",
@@ -28,8 +26,5 @@
     "yaml": "^2.7.1",
     "zod": "^4.0.0",
     "typescript": "^5.8.3"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

packages/workflow-runtime/CHANGELOG.md

@@ -1,47 +0,0 @@
-# @uncaged/workflow-runtime
-
-## 0.4.5
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.5
-  - @uncaged/workflow-cas@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.4
-  - @uncaged/workflow-cas@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-cas@0.4.3
-  - @uncaged/workflow-protocol@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-cas@0.4.2
-  - @uncaged/workflow-protocol@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-cas@0.4.0
-  - @uncaged/workflow-protocol@0.4.0

packages/workflow-runtime/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@uncaged/workflow-runtime",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
+  "main": "src/index.ts",
   "types": "src/index.ts",
   "scripts": {
     "test": "bun test"
   },
   "dependencies": {
-    "@uncaged/workflow-cas": "workspace:^",
-    "@uncaged/workflow-protocol": "workspace:^"
+    "@uncaged/workflow-cas": "workspace:*",
+    "@uncaged/workflow-protocol": "workspace:*"
   },
   "peerDependencies": {
     "zod": "^4.0.0"
@@ -23,12 +23,8 @@
   },
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

packages/workflow-runtime/smoke-greet-entry.ts

@@ -1,101 +0,0 @@
-/**
- * greet workflow — smoke test entry
- * Single role: greeter takes a prompt and returns a structured greeting.
- * 小橘 🍊
- */
-
-import type {
-  AdapterFn,
-  ModeratorTable,
-  RoleFn,
-  RoleResult,
-  ThreadContext,
-  WorkflowDefinition,
-  WorkflowRuntime,
-} from "@uncaged/workflow-runtime";
-import { createWorkflow, END, START } from "@uncaged/workflow-runtime";
-import * as z from "zod/v4";
-
-type GreetMeta = {
-  greeter: { greeting: string; language: string };
-};
-
-const greeterSchema = z.object({
-  greeting: z.string().describe("A friendly greeting message"),
-  language: z.string().describe("The language of the greeting"),
-});
-
-const roles: WorkflowDefinition<GreetMeta>["roles"] = {
-  greeter: {
-    description: "Generates a friendly greeting",
-    systemPrompt:
-      "You are a friendly greeter. Given a user prompt, produce a warm greeting. Respond in valid JSON with keys: greeting (string), language (string).",
-    schema: greeterSchema,
-    extractRefs: null,
-  },
-};
-
-const table: ModeratorTable<GreetMeta> = {
-  [START]: [{ condition: "FALLBACK", role: "greeter" }],
-  greeter: [{ condition: "FALLBACK", role: END }],
-};
-
-export const descriptor = {
-  name: "greet",
-  description: "A simple greeting workflow for smoke testing",
-  graph: { [START]: ["greeter"], greeter: [END] },
-  roles: { greeter: { description: "Generates a friendly greeting" } },
-};
-
-function createLazyAdapter(): AdapterFn {
-  let cached: { baseUrl: string; apiKey: string; model: string } | null = null;
-  function getProvider() {
-    if (cached !== null) return cached;
-    const apiKey = process.env.DASHSCOPE_API_KEY;
-    if (!apiKey) throw new Error("missing env: DASHSCOPE_API_KEY");
-    cached = {
-      baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1",
-      apiKey,
-      model: process.env.WORKFLOW_MODEL ?? "qwen-plus",
-    };
-    return cached;
-  }
-
-  return (<T>(prompt: string, schema: z.ZodType<T>): RoleFn<T> => {
-    return async (ctx: ThreadContext, _runtime: WorkflowRuntime): Promise<RoleResult<T>> => {
-      const provider = getProvider();
-      const response = await fetch(`${provider.baseUrl}/chat/completions`, {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${provider.apiKey}`,
-          "Content-Type": "application/json",
-        },
-        body: JSON.stringify({
-          model: provider.model,
-          messages: [
-            { role: "system", content: prompt },
-            {
-              role: "user",
-              content: `${ctx.start.content}\n\nRespond with JSON: ${JSON.stringify(z.toJSONSchema(schema))}`,
-            },
-          ],
-          response_format: { type: "json_object" },
-        }),
-      });
-      if (!response.ok) {
-        const body = await response.text();
-        throw new Error(`LLM error ${response.status}: ${body.slice(0, 500)}`);
-      }
-      const data = (await response.json()) as { choices: Array<{ message: { content: string } }> };
-      const text = data.choices[0]?.message?.content;
-      if (!text) throw new Error("Empty LLM response");
-      const parsed = schema.parse(JSON.parse(text));
-      return { meta: parsed, childThread: null };
-    };
-  }) as AdapterFn;
-}
-
-export const run = createWorkflow<GreetMeta>(
-  { roles, table },
-  { adapter: createLazyAdapter(), overrides: null },
-);

packages/workflow-template-develop/CHANGELOG.md

@@ -1,45 +0,0 @@
-# @uncaged/workflow-template-develop
-
-## 0.4.5
-
-### Patch Changes
-
-- @uncaged/workflow-register@0.4.5
-- @uncaged/workflow-runtime@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- @uncaged/workflow-register@0.4.4
-- @uncaged/workflow-runtime@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-register@0.4.3
-  - @uncaged/workflow-runtime@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-register@0.4.2
-  - @uncaged/workflow-runtime@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-register@0.4.0
-  - @uncaged/workflow-runtime@0.4.0

packages/workflow-template-develop/__tests__/develop-template.test.ts

@@ -9,9 +9,7 @@ import type { DevelopMeta } from "../src/roles.js";
 
 const developModerator = tableToModerator(developTable);
 
-type PlannedMeta = Extract<PlannerMeta, { status: "planned" }>;
-
-const DEFAULT_PHASES: PlannedMeta["phases"] = [
+const DEFAULT_PHASES: PlannerMeta["phases"] = [
   {
     hash: "4KNMR2PX",
     title: "Do the work",
@@ -38,11 +36,11 @@ function makeCtx(steps: ModeratorContext<DevelopMeta>["steps"]): ModeratorContex
   };
 }
 
-function plannerStep(phases: PlannedMeta["phases"] = DEFAULT_PHASES): RoleStep<DevelopMeta> {
+function plannerStep(phases: PlannerMeta["phases"] = DEFAULT_PHASES): RoleStep<DevelopMeta> {
   return {
     role: "planner",
     contentHash: "STUBHASHPLANNER001",
-    meta: { status: "planned" as const, phases },
+    meta: { phases },
     refs: phases.map((p) => p.hash),
     timestamp: 1,
   };
@@ -155,7 +153,7 @@ describe("developModerator", () => {
   });
 
   test("multiple planner phases → coder until all complete, then reviewer", () => {
-    const phases: PlannedMeta["phases"] = [
+    const phases: PlannerMeta["phases"] = [
       { hash: "AA000001", title: "first phase" },
       { hash: "AA000002", title: "second phase" },
     ];
@@ -169,7 +167,7 @@ describe("developModerator", () => {
   });
 
   test("one-shot coder reports only last phase hash → reviewer (moderator treats as all phases done)", () => {
-    const phases: PlannedMeta["phases"] = [
+    const phases: PlannerMeta["phases"] = [
       { hash: "BB000001", title: "setup branch" },
       { hash: "BB000002", title: "write tests" },
       { hash: "BB000003", title: "verify" },
@@ -181,7 +179,7 @@ describe("developModerator", () => {
   });
 
   test("unrecognised completedPhase hash → coder retry when budget allows", () => {
-    const phases: PlannedMeta["phases"] = [
+    const phases: PlannerMeta["phases"] = [
       { hash: "CC000001", title: "first phase" },
       { hash: "CC000002", title: "second phase" },
     ];
@@ -189,7 +187,7 @@ describe("developModerator", () => {
   });
 
   test("incomplete phases → coder retry (supervisor controls termination)", () => {
-    const phases: PlannedMeta["phases"] = [
+    const phases: PlannerMeta["phases"] = [
       { hash: "DD000001", title: "first phase" },
       { hash: "DD000002", title: "second phase" },
     ];
@@ -200,17 +198,6 @@ describe("developModerator", () => {
     expect(developModerator(makeCtx(steps))).toBe("coder");
   });
 
-  test("planner aborted → END", () => {
-    const abortedStep: RoleStep<DevelopMeta> = {
-      role: "planner",
-      contentHash: "STUBHASHABORT001",
-      meta: { status: "aborted", reason: "No workspace path provided" },
-      refs: [],
-      timestamp: 1,
-    };
-    expect(developModerator(makeCtx([abortedStep]))).toBe("__end__");
-  });
-
   test("committer → END for any committer meta status", () => {
     const committed = committerStep({ status: "committed", branch: "f", commitSha: "x" });
     const recoverable = committerStep({

packages/workflow-template-develop/package.json

@@ -1,15 +1,13 @@
 {
   "name": "@uncaged/workflow-template-develop",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
@@ -18,14 +16,11 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@uncaged/workflow-register": "workspace:^",
-    "@uncaged/workflow-runtime": "workspace:^",
+    "@uncaged/workflow-register": "workspace:*",
+    "@uncaged/workflow-runtime": "workspace:*",
     "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@uncaged/workflow-protocol": "workspace:^"
-  },
-  "publishConfig": {
-    "access": "public"
+    "@uncaged/workflow-protocol": "workspace:*"
   }
 }

packages/workflow-template-develop/src/moderator.ts

@@ -30,18 +30,6 @@ function coderFinishedAllPlannedPhases(
 
 // ── Conditions ─────────────────────────────────────────────────────
 
-const plannerAborted: ModeratorCondition<DevelopMeta> = {
-  name: "plannerAborted",
-  description: "The planner aborted due to insufficient information",
-  check: (ctx) => {
-    const plannerStep = ctx.steps.find((s) => s.role === "planner");
-    if (plannerStep === undefined) {
-      return false;
-    }
-    return plannerStep.meta.status === "aborted";
-  },
-};
-
 const allPhasesComplete: ModeratorCondition<DevelopMeta> = {
   name: "allPhasesComplete",
   description: "All planned phases have been completed by the coder",
@@ -50,7 +38,7 @@ const allPhasesComplete: ModeratorCondition<DevelopMeta> = {
     if (plannerStep === undefined) {
       return true;
     }
-    const phases = plannerStep.meta.status === "planned" ? plannerStep.meta.phases : [];
+    const phases = plannerStep.meta.phases;
     if (!Array.isArray(phases)) {
       return true;
     }
@@ -83,10 +71,7 @@ const testsPassed: ModeratorCondition<DevelopMeta> = {
 
 const table: ModeratorTable<DevelopMeta> = {
   [START]: [{ condition: "FALLBACK", role: "planner" }],
-  planner: [
-    { condition: plannerAborted, role: END },
-    { condition: "FALLBACK", role: "coder" },
-  ],
+  planner: [{ condition: "FALLBACK", role: "coder" }],
   coder: [
     { condition: allPhasesComplete, role: "reviewer" },
     { condition: "FALLBACK", role: "coder" },

packages/workflow-template-develop/src/roles/coder.ts

@@ -25,11 +25,7 @@ The thread ID (26-char Crockford Base32) appears in the first message. If unsure
 
 ## Completing a phase
 
-Report which phase you completed using the phase **hash** (not the title). If you legitimately finish every remaining phase in this single turn, set completedPhase to the **last** phase hash in the plan (the workflow treats that as full completion). List the files you changed and summarize what you did.
-
-## Output rules
-
-Keep your final response **short** — a brief summary paragraph plus the structured meta output. Do NOT paste diffs, file contents, or code blocks in your response. The actual changes are already on disk; repeating them wastes tokens. Just say what you did and why.`;
+Report which phase you completed using the phase **hash** (not the title). If you legitimately finish every remaining phase in this single turn, set completedPhase to the **last** phase hash in the plan (the workflow treats that as full completion). List the files you changed and summarize what you did.`;
 
 export const coderRole: RoleDefinition<CoderMeta> = {
   description:

packages/workflow-template-develop/src/roles/planner.ts

@@ -6,27 +6,16 @@ export const phaseSchema = z.object({
   title: z.string(),
 });
 
-export const plannerMetaSchema = z.discriminatedUnion("status", [
-  z.object({
-    status: z.literal("planned"),
-    phases: z.array(phaseSchema),
-  }),
-  z.object({
-    status: z.literal("aborted"),
-    reason: z.string().describe("Why the task cannot proceed"),
-  }),
-]);
+export const plannerMetaSchema = z.object({
+  phases: z.array(phaseSchema),
+});
 
 export type PlannerMeta = z.infer<typeof plannerMetaSchema>;
 
-const PLANNER_SYSTEM = `You are a **planner** for a software task. Break the work into **sequential phases** the coder will execute one at a time. **Abort** if the prompt lacks critical information (e.g. no project/workspace path, ambiguous target repo).
+const PLANNER_SYSTEM = `You are a **planner** for a software task. Break the work into **sequential phases** the coder will execute one at a time.
 
 Run \`uncaged-workflow skill develop\` for thread ID lookup, CAS commands, and meta output guide.
 
-## Prerequisites — check FIRST
-
-The prompt MUST include an **absolute filesystem path** to the project workspace (e.g. \`/home/user/repos/my-project\`). If no workspace path is given and you cannot reliably infer one from context, **abort immediately** with a clear reason explaining what information is missing. Do NOT guess paths.
-
 ## Storing phase details — MANDATORY
 
 For each phase, store its full detail text in CAS via \`uncaged-workflow cas put '<content>'\`. The command prints a content-hash — use that as the phase identifier.
@@ -48,20 +37,13 @@ Fewer phases is always better. Each phase must justify its existence — if two
 ## Output format
 
 After storing all phases via the CLI, output compact JSON only:
-  { "status": "planned", "phases": [{ "hash": "<hash-from-cas-put>", "title": "<one-line-summary>" }] }
+  { "phases": [{ "hash": "<hash-from-cas-put>", "title": "<one-line-summary>" }] }
 
-If aborting:
-  { "status": "aborted", "reason": "<what is missing>" }
-
-Order phases so earlier steps unblock later ones. Cover root cause, edge cases, and verification across the phases.
-
-## Output rules
-
-Keep your final response **short** — just the JSON with phases. Do NOT paste code snippets, diffs, or implementation details in your response. Phase details are already stored in CAS; your response should only contain the compact phases JSON.`;
+Order phases so earlier steps unblock later ones. Cover root cause, edge cases, and verification across the phases.`;
 
 export const plannerRole: RoleDefinition<PlannerMeta> = {
   description: "Breaks the task into sequential phases for the coder.",
   systemPrompt: PLANNER_SYSTEM,
   schema: plannerMetaSchema,
-  extractRefs: (meta) => (meta.status === "planned" ? meta.phases.map((p) => p.hash) : []),
+  extractRefs: (meta) => meta.phases.map((p) => p.hash),
 };

packages/workflow-template-develop/src/roles/reviewer.ts

@@ -32,11 +32,7 @@ const REVIEWER_SYSTEM = `You are a code reviewer. Review the git diff for correc
 - **Approve** only if there are zero issues
 - **Reject** with specific issues that must be fixed — every issue you find is blocking
 
-Be thorough. A false approve costs more than a false reject.
-
-## Output rules
-
-Keep your final response **short**. Summarize findings in a few bullet points, then output the structured verdict. Do NOT paste the full diff or large code blocks in your response.`;
+Be thorough. A false approve costs more than a false reject.`;
 
 export const reviewerRole: RoleDefinition<ReviewerMeta> = {
   description: "Runs git diff checks and sets approved when the change is ready.",

packages/workflow-template-develop/src/roles/tester.ts

@@ -14,11 +14,7 @@ export const testerMetaSchema = z.discriminatedUnion("status", [
 
 export type TesterMeta = z.infer<typeof testerMetaSchema>;
 
-const TESTER_SYSTEM = `You are a tester. Run the project's test suite, build, and lint commands. Check what commands are available from the preparer's output in the thread. Report pass/fail with details of what failed.
-
-## Output rules
-
-Keep your final response **short**. Report pass/fail with a brief summary of failures (if any). Do NOT paste full test output or build logs — just the key error lines.`;
+const TESTER_SYSTEM = `You are a tester. Run the project's test suite, build, and lint commands. Check what commands are available from the preparer's output in the thread. Report pass/fail with details of what failed.`;
 
 export const testerRole: RoleDefinition<TesterMeta> = {
   description: "Runs test, build, and lint commands and reports pass or fail with details.",

packages/workflow-template-solve-issue/CHANGELOG.md

@@ -1,45 +0,0 @@
-# @uncaged/workflow-template-solve-issue
-
-## 0.4.5
-
-### Patch Changes
-
-- @uncaged/workflow-register@0.4.5
-- @uncaged/workflow-runtime@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- @uncaged/workflow-register@0.4.4
-- @uncaged/workflow-runtime@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-register@0.4.3
-  - @uncaged/workflow-runtime@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-register@0.4.2
-  - @uncaged/workflow-runtime@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-register@0.4.0
-  - @uncaged/workflow-runtime@0.4.0

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

@@ -1,15 +1,13 @@
 {
   "name": "@uncaged/workflow-template-solve-issue",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
@@ -18,16 +16,13 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@uncaged/workflow-register": "workspace:^",
-    "@uncaged/workflow-runtime": "workspace:^",
+    "@uncaged/workflow-register": "workspace:*",
+    "@uncaged/workflow-runtime": "workspace:*",
     "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@uncaged/workflow-cas": "workspace:^",
-    "@uncaged/workflow-execute": "workspace:^",
-    "@uncaged/workflow-protocol": "workspace:^"
-  },
-  "publishConfig": {
-    "access": "public"
+    "@uncaged/workflow-cas": "workspace:*",
+    "@uncaged/workflow-execute": "workspace:*",
+    "@uncaged/workflow-protocol": "workspace:*"
   }
 }

packages/workflow-util-agent/CHANGELOG.md

@@ -1,45 +0,0 @@
-# @uncaged/workflow-util-agent
-
-## 0.4.5
-
-### Patch Changes
-
-- @uncaged/workflow-cas@0.4.5
-- @uncaged/workflow-runtime@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- @uncaged/workflow-cas@0.4.4
-- @uncaged/workflow-runtime@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-cas@0.4.3
-  - @uncaged/workflow-runtime@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-cas@0.4.2
-  - @uncaged/workflow-runtime@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-cas@0.4.0
-  - @uncaged/workflow-runtime@0.4.0

packages/workflow-util-agent/package.json

@@ -1,16 +1,13 @@
 {
   "name": "@uncaged/workflow-util-agent",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
-  "types": "src/index.ts",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
@@ -19,11 +16,8 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@uncaged/workflow-runtime": "workspace:^",
-    "@uncaged/workflow-cas": "workspace:^",
+    "@uncaged/workflow-runtime": "workspace:*",
+    "@uncaged/workflow-cas": "workspace:*",
     "zod": "^4.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

packages/workflow-util-agent/src/create-text-adapter.ts

@@ -7,8 +7,6 @@ import type {
 } from "@uncaged/workflow-runtime";
 import type * as z from "zod/v4";
 
-export type { WorkflowRuntime } from "@uncaged/workflow-runtime";
-
 /**
  * Result from a text-producing agent (CLI spawn, LLM call, etc.).
  * `output` is the raw text; `childThread` links to a spawned sub-workflow.
@@ -25,7 +23,6 @@ export type TextAdapterResult = {
 export type TextProducerFn = (
   ctx: ThreadContext,
   prompt: string,
-  runtime: WorkflowRuntime,
 ) => Promise<string | TextAdapterResult>;
 
 /**
@@ -40,7 +37,7 @@ export type TextProducerFn = (
 export function createTextAdapter(producer: TextProducerFn): AdapterFn {
   return <T>(prompt: string, schema: z.ZodType<T>) => {
     return async (ctx: ThreadContext, runtime: WorkflowRuntime): Promise<RoleResult<T>> => {
-      const result = await producer(ctx, prompt, runtime);
+      const result = await producer(ctx, prompt);
       const output = typeof result === "string" ? result : result.output;
       const childThread = typeof result === "string" ? null : result.childThread;
       const contentHash = await putContentNodeWithRefs(runtime.cas, output, []);

packages/workflow-util/CHANGELOG.md

@@ -1,42 +0,0 @@
-# @uncaged/workflow-util
-
-## 0.4.5
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.5
-
-## 0.4.4
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.4
-
-## 0.4.3
-
-### Patch Changes
-
-- Include src/ in published packages so bun runtime can resolve the 'bun' exports condition.
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.3
-
-## 0.4.2
-
-### Patch Changes
-
-- Fix workspace dependency resolution: use workspace:^ so published packages resolve to compatible versions instead of exact (non-existent) versions.
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.2
-
-## 0.4.0
-
-### Minor Changes
-
-- Fix package exports for published packages and adopt changesets for version management.
-
-### Patch Changes
-
-- Updated dependencies
-  - @uncaged/workflow-protocol@0.4.0

packages/workflow-util/package.json

@@ -1,26 +1,21 @@
 {
   "name": "@uncaged/workflow-util",
-  "version": "0.4.5",
+  "version": "0.3.24",
   "files": [
-    "src",
     "dist",
     "package.json"
   ],
   "type": "module",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
   },
   "dependencies": {
-    "@uncaged/workflow-protocol": "workspace:^"
+    "@uncaged/workflow-protocol": "workspace:*"
   },
   "devDependencies": {
     "typescript": "^5.8.3"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

scripts/link-all.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# Link / unlink all @uncaged/* packages from the workflow monorepo.
+#
+# Usage:
+#   ./scripts/link-all.sh              # Register all packages (run from monorepo root)
+#   ./scripts/link-all.sh --consume    # Link all packages into CWD's project
+#   ./scripts/link-all.sh --unlink     # Unregister all packages and restore CWD's deps
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+MONOREPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Iterate package dirs, calling callback(dir, name) for each
+each_pkg() {
+  local cb="$1"
+  for dir in "$MONOREPO_ROOT"/packages/*/; do
+    [[ -f "$dir/package.json" ]] || continue
+    local name
+    name=$(grep -m1 '"name"' "$dir/package.json" | sed 's/.*: *"\(.*\)".*/\1/')
+    "$cb" "$dir" "$name"
+  done
+}
+
+do_register() { printf "  register  %s\n" "$2"; (cd "$1" && bun link 2>&1) > /dev/null; }
+do_consume()  { printf "  link      %s\n" "$2"; (bun link "$2" 2>&1) > /dev/null; }
+do_unlink()   { printf "  unlink    %s\n" "$2"; (cd "$1" && bun unlink 2>&1) > /dev/null || true; }
+
+case "${1:-}" in
+  --consume)
+    each_pkg do_consume
+    echo "✅ All @uncaged/* packages linked into $(pwd)"
+    echo "   ⚠️  Do NOT run 'bun install' after this — it will overwrite the links"
+    echo "   To restore: $0 --unlink"
+    ;;
+  --unlink)
+    each_pkg do_unlink
+    if [[ -f "package.json" ]]; then
+      echo "  reinstalling deps..."
+      bun install 2>&1 > /dev/null || true
+    fi
+    echo "✅ All @uncaged/* packages unlinked, deps restored"
+    ;;
+  *)
+    each_pkg do_register
+    echo "✅ All @uncaged/* packages registered"
+    echo "   cd <project> && $0 --consume"
+    ;;
+esac

scripts/lint-log-tags.sh

@@ -1,24 +0,0 @@
-#!/usr/bin/env bash
-# Validate Crockford Base32 log tags in .log("TAG", ...) calls.
-# Crockford Base32 excludes: I, L, O, U
-set -euo pipefail
-
-ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-BAD=0
-
-while IFS= read -r match; do
-  file="${match%%:*}"
-  rest="${match#*:}"
-  line="${rest%%:*}"
-  tag=$(echo "$rest" | grep -oP '\.log\(\s*"\K[A-Za-z0-9]+')
-  if echo "$tag" | grep -qiE '[ILOU]'; then
-    echo "  ❌ ${file}:${line}  tag \"${tag}\" contains invalid Crockford Base32 char (I/L/O/U)"
-    BAD=1
-  fi
-done < <(grep -rn '\.log("[A-Za-z0-9]\{8\}"' "$ROOT/packages/" --include='*.ts' \
-  | grep -v node_modules | grep -v '/dist/')
-
-if [ "$BAD" -eq 0 ]; then
-  echo "  ✅ All log tags are valid Crockford Base32"
-fi
-exit $BAD

scripts/publish.sh

@@ -0,0 +1,165 @@
+#!/usr/bin/env bash
+# publish.sh — Bump version, build, test, topologically publish @uncaged/* to Gitea npm
+#
+# Usage:
+#   ./scripts/publish.sh 0.4.0             # explicit version
+#   ./scripts/publish.sh patch             # 0.3.1 → 0.3.2
+#   ./scripts/publish.sh minor             # 0.3.1 → 0.4.0
+#   ./scripts/publish.sh major             # 0.3.1 → 1.0.0
+#   ./scripts/publish.sh --dry-run patch   # dry-run bun publish only (no git commit/push)
+#
+# Env (via `cfg` or export):
+#   GITEA_TOKEN — Gitea npm registry auth (see root .npmrc)
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$REPO_ROOT"
+
+GITEA_TOKEN="${GITEA_TOKEN:?GITEA_TOKEN is required}"
+
+REGISTRY="https://git.shazhou.work/api/packages/uncaged/npm/"
+DRY_RUN=""
+
+if [[ "${1:-}" == "--dry-run" ]]; then
+  DRY_RUN="--dry-run"
+  shift
+  echo "🔍 Dry run — bun publish will not upload; git commit/push skipped"
+  echo
+fi
+
+# ─── Version ─────────────────────────────────────────────────────────────────
+current_version() {
+  node -e "console.log(require('./packages/workflow-protocol/package.json').version)"
+}
+
+bump_version() {
+  local cur="$1" kind="$2"
+  IFS='.' read -r major minor patch <<< "$cur"
+  case "$kind" in
+    patch) echo "${major}.${minor}.$((patch + 1))" ;;
+    minor) echo "${major}.$((minor + 1)).0" ;;
+    major) echo "$((major + 1)).0.0" ;;
+    *)     echo "$kind" ;;
+  esac
+}
+
+CURRENT=$(current_version)
+VERSION=$(bump_version "$CURRENT" "${1:?Usage: publish.sh [--dry-run] <version|patch|minor|major>}")
+echo "📦 Publish: $CURRENT → $VERSION"
+
+# ─── Bump version ─────────────────────────────────────────────────────────────
+echo "🔢 Bumping versions..."
+for dir in packages/*/; do
+  pkg="$dir/package.json"
+  [[ -f "$pkg" ]] || continue
+  is_private=$(node -e "console.log(require('./$pkg').private || false)")
+  [[ "$is_private" == "true" ]] && continue
+  node -e "
+    const fs = require('fs');
+    const p = JSON.parse(fs.readFileSync('$pkg','utf8'));
+    p.version = '$VERSION';
+    fs.writeFileSync('$pkg', JSON.stringify(p, null, 2) + '\n');
+  "
+done
+
+# ─── Topological publish order (workspace:* deps first) ───────────────────────
+ORDERED=$(python3 -c "
+import json, sys
+from pathlib import Path
+
+pkgs_dir = Path('$REPO_ROOT/packages')
+name_to_dir = {}
+for d in sorted(pkgs_dir.iterdir()):
+    pj = d / 'package.json'
+    if not pj.exists():
+        continue
+    data = json.loads(pj.read_text())
+    name = data.get('name', '')
+    if not name.startswith('@uncaged/') or data.get('private'):
+        continue
+    name_to_dir[name] = d.name
+
+deps_graph = {}
+for name, dirname in name_to_dir.items():
+    pj = pkgs_dir / dirname / 'package.json'
+    data = json.loads(pj.read_text())
+    local_deps = set()
+    for section in ('dependencies', 'devDependencies', 'peerDependencies'):
+        for dep, ver in data.get(section, {}).items():
+            if dep.startswith('@uncaged/') and dep in name_to_dir and ver == 'workspace:*':
+                local_deps.add(dep)
+    deps_graph[name] = local_deps
+
+in_degree = {n: 0 for n in deps_graph}
+for n, ds in deps_graph.items():
+    in_degree[n] = len(ds)
+
+queue = sorted([n for n, deg in in_degree.items() if deg == 0])
+result = []
+while queue:
+    node = queue.pop(0)
+    result.append(node)
+    for n, ds in deps_graph.items():
+        if node in ds:
+            in_degree[n] -= 1
+            if in_degree[n] == 0:
+                queue.append(n)
+    queue.sort()
+
+if len(result) != len(deps_graph):
+    missing = set(deps_graph) - set(result)
+    sys.stderr.write('publish: cyclic @uncaged/ workspace:* dependencies among: ' + ', '.join(sorted(missing)) + '\n')
+    sys.exit(1)
+
+for name in result:
+    print(name_to_dir[name])
+")
+
+# ─── Build ────────────────────────────────────────────────────────────────────
+echo "🔨 Building..."
+bun run build
+
+# ─── Self-test ────────────────────────────────────────────────────────────────
+echo "🧪 Running tests..."
+if ! bun test; then
+  echo "❌ Tests failed — aborting publish"
+  exit 1
+fi
+
+# ─── Publish (bun resolves workspace:* for publish) ──────────────────────────
+echo "🚀 Publishing to $REGISTRY ..."
+ok=0
+fail=0
+
+while IFS= read -r pkg; do
+  [[ -n "$pkg" ]] || continue
+  dir="$REPO_ROOT/packages/$pkg"
+  name=$(node -e "console.log(require('$dir/package.json').name)")
+
+  if ( cd "$dir" && bun publish --registry="$REGISTRY" ${DRY_RUN:+"$DRY_RUN"} ); then
+    echo "✅ $name"
+    ok=$((ok + 1))
+  else
+    echo "⚠️  $name (publish failed or version may already exist)"
+    fail=$((fail + 1))
+  fi
+
+done <<< "$ORDERED"
+
+echo
+echo "Published: $ok  Skipped/Failed: $fail"
+
+# ─── Commit ───────────────────────────────────────────────────────────────────
+if [[ -n "$DRY_RUN" ]]; then
+  echo "⏭️  Skipping git commit/push (dry run). Revert bumps with: git checkout -- packages/*/package.json"
+  exit 0
+fi
+
+echo "📝 Committing..."
+git add -A
+git commit -m "chore: publish v${VERSION}
+
+小橘 <xiaoju@shazhou.work>"
+git push
+
+echo "✅ v${VERSION} published"

smoke-greet-entry.ts

@@ -1,101 +0,0 @@
-/**
- * greet workflow — smoke test entry
- * Single role: greeter takes a prompt and returns a structured greeting.
- * 小橘 🍊
- */
-
-import type {
-  AdapterFn,
-  ModeratorTable,
-  RoleFn,
-  RoleResult,
-  ThreadContext,
-  WorkflowDefinition,
-  WorkflowRuntime,
-} from "@uncaged/workflow-runtime";
-import { createWorkflow, END, START } from "@uncaged/workflow-runtime";
-import * as z from "zod/v4";
-
-type GreetMeta = {
-  greeter: { greeting: string; language: string };
-};
-
-const greeterSchema = z.object({
-  greeting: z.string().describe("A friendly greeting message"),
-  language: z.string().describe("The language of the greeting"),
-});
-
-const roles: WorkflowDefinition<GreetMeta>["roles"] = {
-  greeter: {
-    description: "Generates a friendly greeting",
-    systemPrompt:
-      "You are a friendly greeter. Given a user prompt, produce a warm greeting. Respond in valid JSON with keys: greeting (string), language (string).",
-    schema: greeterSchema,
-    extractRefs: null,
-  },
-};
-
-const table: ModeratorTable<GreetMeta> = {
-  [START]: [{ condition: "FALLBACK", role: "greeter" }],
-  greeter: [{ condition: "FALLBACK", role: END }],
-};
-
-export const descriptor = {
-  name: "greet",
-  description: "A simple greeting workflow for smoke testing",
-  graph: { [START]: ["greeter"], greeter: [END] },
-  roles: { greeter: { description: "Generates a friendly greeting" } },
-};
-
-function createLazyAdapter(): AdapterFn {
-  let cached: { baseUrl: string; apiKey: string; model: string } | null = null;
-  function getProvider() {
-    if (cached !== null) return cached;
-    const apiKey = process.env.DASHSCOPE_API_KEY;
-    if (!apiKey) throw new Error("missing env: DASHSCOPE_API_KEY");
-    cached = {
-      baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1",
-      apiKey,
-      model: process.env.WORKFLOW_MODEL ?? "qwen-plus",
-    };
-    return cached;
-  }
-
-  return (<T>(prompt: string, schema: z.ZodType<T>): RoleFn<T> => {
-    return async (ctx: ThreadContext, _runtime: WorkflowRuntime): Promise<RoleResult<T>> => {
-      const provider = getProvider();
-      const response = await fetch(`${provider.baseUrl}/chat/completions`, {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${provider.apiKey}`,
-          "Content-Type": "application/json",
-        },
-        body: JSON.stringify({
-          model: provider.model,
-          messages: [
-            { role: "system", content: prompt },
-            {
-              role: "user",
-              content: `${ctx.start.content}\n\nRespond with JSON: ${JSON.stringify(z.toJSONSchema(schema))}`,
-            },
-          ],
-          response_format: { type: "json_object" },
-        }),
-      });
-      if (!response.ok) {
-        const body = await response.text();
-        throw new Error(`LLM error ${response.status}: ${body.slice(0, 500)}`);
-      }
-      const data = (await response.json()) as { choices: Array<{ message: { content: string } }> };
-      const text = data.choices[0]?.message?.content;
-      if (!text) throw new Error("Empty LLM response");
-      const parsed = schema.parse(JSON.parse(text));
-      return { meta: parsed, childThread: null };
-    };
-  }) as AdapterFn;
-}
-
-export const run = createWorkflow<GreetMeta>(
-  { roles, table },
-  { adapter: createLazyAdapter(), overrides: null },
-);