chore: publish v0.3.24

小橘 <xiaoju@shazhou.work>

CLAUDE.md

@@ -229,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 |

packages/cli-workflow/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/cli-workflow",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "src",
     "dist",

packages/workflow-agent-cursor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-agent-cursor",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
@@ -22,7 +22,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./src/index.ts"
+      "import": "./dist/index.js"
     }
   }
 }

packages/workflow-agent-hermes/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-agent-hermes",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
@@ -18,7 +18,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./src/index.ts"
+      "import": "./dist/index.js"
     }
   }
 }

packages/workflow-agent-llm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-agent-llm",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
@@ -21,7 +21,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./src/index.ts"
+      "import": "./dist/index.js"
     }
   }
 }

packages/workflow-agent-react/package.json

@@ -1,17 +1,15 @@
 {
   "name": "@uncaged/workflow-agent-react",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
   ],
   "type": "module",
-  "main": "src/index.ts",
-  "types": "src/index.ts",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "default": "./src/index.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
   "scripts": {

packages/workflow-cas/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-cas",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
@@ -12,7 +12,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./src/index.ts"
+      "import": "./dist/index.js"
     }
   },
   "dependencies": {

packages/workflow-execute/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-execute",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
@@ -9,7 +9,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./src/index.ts"
+      "import": "./dist/index.js"
     }
   },
   "scripts": {

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-gateway",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"

packages/workflow-protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-protocol",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
@@ -9,11 +9,11 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./src/index.ts"
+      "import": "./dist/index.js"
     },
     "./moderator-table.js": {
       "types": "./dist/moderator-table.d.ts",
-      "import": "./src/moderator-table.ts"
+      "import": "./dist/moderator-table.js"
     }
   },
   "peerDependencies": {

packages/workflow-reactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-reactor",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
@@ -9,7 +9,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./src/index.ts"
+      "import": "./dist/index.js"
     }
   },
   "dependencies": {

packages/workflow-register/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-register",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
@@ -9,7 +9,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./src/index.ts"
+      "import": "./dist/index.js"
     }
   },
   "dependencies": {

packages/workflow-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-runtime",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
@@ -24,7 +24,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./src/index.ts"
+      "import": "./dist/index.js"
     }
   }
 }

packages/workflow-template-develop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-template-develop",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
@@ -9,7 +9,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./src/index.ts"
+      "import": "./dist/index.js"
     }
   },
   "scripts": {

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

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-template-solve-issue",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
@@ -9,7 +9,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./src/index.ts"
+      "import": "./dist/index.js"
     }
   },
   "scripts": {

packages/workflow-util-agent/package.json

@@ -1,17 +1,15 @@
 {
   "name": "@uncaged/workflow-util-agent",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
   ],
   "type": "module",
-  "main": "src/index.ts",
-  "types": "src/index.ts",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "default": "./src/index.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
   "scripts": {

packages/workflow-util/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncaged/workflow-util",
-  "version": "0.3.21",
+  "version": "0.3.24",
   "files": [
     "dist",
     "package.json"
@@ -9,7 +9,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./src/index.ts"
+      "import": "./dist/index.js"
     }
   },
   "dependencies": {