@actiondock/builder 2.0.8 → 2.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actiondock/builder",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "description": "ActionDock Build Planner, Bun standalone compiler, and Skill exporter",
   "type": "module",
   "main": "./src/index.ts",
@@ -27,15 +27,21 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@actiondock/core": "^2.0.0",
-    "@actiondock/sdk": "^2.0.0",
+    "@actiondock/core": "^2.0.10",
+    "@actiondock/sdk": "^2.0.10",
     "yaml": "^2.7.0"
   },
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"
   },
-  "keywords": ["actiondock", "builder", "compiler", "skill", "export"],
+  "keywords": [
+    "actiondock",
+    "builder",
+    "compiler",
+    "skill",
+    "export"
+  ],
   "author": "team4u",
   "license": "Apache-2.0",
   "repository": {

package/src/build.ts

@@ -0,0 +1,106 @@
+import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { generateStandaloneEntrypoint, getPackageSlug } from "@actiondock/core";
+import { BunCompiler } from "./compiler";
+import { BuilderError } from "./errors";
+import { BuildPlanner } from "./planner";
+
+/**
+ * 独立二进制可执行文件构建选项。
+ */
+export interface BuildOptions {
+  /** 目标项目根目录 */
+  projectRoot: string;
+  /** 目标架构（如 "bun-linux-x64", "bun-darwin-arm64", "bun-windows-x64" 等） */
+  target?: string;
+  /** 输出可执行文件的目标路径（默认输出到 dist/ 目录） */
+  outfile?: string;
+  /** 是否开启代码压缩混淆（默认 true） */
+  minify?: boolean;
+  /** 是否编译为 V8/JavaScriptCore 字节码（默认 true） */
+  bytecode?: boolean;
+  /** 显式挑选打包的 Action ID 清单（用于按需子集打包） */
+  actions?: string[];
+}
+
+/**
+ * 独立二进制构建完成后的元数据结果对象。
+ */
+export interface BuildResult {
+  /** 所属 Package ID */
+  packageId: string;
+  /** 打包的项目版本号 */
+  version: string;
+  /** 编译的目标平台架构 */
+  target: string;
+  /** 生成的独立二进制可执行文件绝对路径 */
+  executablePath: string;
+  /** 生成的 sidecar 元数据 JSON 文件绝对路径 */
+  metadataPath: string;
+  /** 打包内置的 Action ID 列表 */
+  actions: string[];
+}
+
+/**
+ * 调用 Bun 原生编译引擎（Bun.build --compile）将 Action Package 打包为零外部依赖的独立二进制可执行文件。
+ *
+ * @param options 构建参数
+ * @returns 构建产物结果元数据
+ */
+export async function buildProject(options: BuildOptions): Promise<BuildResult> {
+  const root = resolve(options.projectRoot);
+  const plan = BuildPlanner.plan({
+    projectRoot: root,
+    actions: options.actions,
+  });
+
+  if (plan.actions.length === 0) {
+    throw new BuilderError("No actions resolved for standalone compilation");
+  }
+
+  const buildDir = join(root, ".actiondock", ".build");
+  mkdirSync(buildDir, { recursive: true });
+
+  const entryCode = generateStandaloneEntrypoint(
+    plan.packageId,
+    plan.version,
+    plan.description,
+    plan.actions.map((a) => ({ id: a.id, filePath: a.resolvedPath })),
+    plan.configDefs
+  );
+
+  const entryFileName = `entry-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.ts`;
+  const entryPath = join(buildDir, entryFileName);
+  writeFileSync(entryPath, entryCode, "utf-8");
+
+  const binaryName = getPackageSlug(plan.packageId);
+  const defaultOutfile = join(root, "dist", binaryName);
+  const outfile = resolve(options.outfile || defaultOutfile);
+
+  try {
+    const result = await BunCompiler.compile({
+      entrypoint: entryPath,
+      outfile,
+      target: options.target,
+      minify: options.minify,
+      bytecode: options.bytecode,
+      cwd: root,
+      packageId: plan.packageId,
+      version: plan.version,
+      actions: plan.actions.map((a) => a.id),
+    });
+
+    return {
+      packageId: result.packageId || plan.packageId,
+      version: result.version || plan.version,
+      target: result.target,
+      executablePath: result.executablePath,
+      metadataPath: result.metadataPath || "",
+      actions: plan.actions.map((a) => a.id),
+    };
+  } finally {
+    if (existsSync(entryPath)) {
+      rmSync(entryPath, { force: true });
+    }
+  }
+}

package/src/exporter.ts

@@ -130,32 +130,17 @@ export class SkillExporter {
       writeFileSync(join(skillDir, "SKILL.md"), skillMd, "utf-8");
 
       // 2. 生成 actiondock.skill.json 工具清单
-      const skillJsonContent = {
-        schemaVersion: "2.0.0",
-        packageId: plan.packageId,
-        name: plan.packageName,
-        version: plan.version,
-        description: plan.description,
-        mode: "source",
-        actions: plan.actions.map((a) => ({
-          id: a.id,
-          entry: a.entry,
-          description: a.description,
-          inputSchema: a.inputSchema,
-          outputSchema: a.outputSchema,
-          uses: a.uses,
-          tags: a.tags,
-        })),
-        playbooks: plan.playbooks.map((p) => ({
-          id: p.id,
-          description: p.description,
-          entry: `playbooks/${basename(p.filePath)}`,
-        })),
-        exportedAt: new Date().toISOString(),
-      };
+      const skillJsonContent = generateSkillJson(
+        configForTemplates,
+        plan.actions as any,
+        {
+          mode: "source",
+          playbooks: plan.playbooks as any,
+        }
+      );
       writeFileSync(
         join(skillDir, "actiondock.skill.json"),
-        JSON.stringify(skillJsonContent, null, 2) + "\n",
+        skillJsonContent,
         "utf-8"
       );
 
@@ -329,17 +314,19 @@ export class SkillExporter {
       writeFileSync(join(skillDir, "SKILL.md"), skillMd, "utf-8");
 
       // 2. 生成 actiondock.skill.json
-      const rawSkillJson = generateSkillJson(
+      const skillJsonContent = generateSkillJson(
         configForTemplates,
         plan.actions as any,
-        actualBinaryName,
-        target
+        {
+          mode: "standalone",
+          executable: `./bin/${actualBinaryName}`,
+          target,
+          playbooks: plan.playbooks as any,
+        }
       );
-      const parsedSkillJson = JSON.parse(rawSkillJson);
-      parsedSkillJson.mode = "standalone";
       writeFileSync(
         join(skillDir, "actiondock.skill.json"),
-        JSON.stringify(parsedSkillJson, null, 2) + "\n",
+        skillJsonContent,
         "utf-8"
       );
 

package/src/index.ts

@@ -1,5 +1,6 @@
 export * from "./types";
 export * from "./errors";
+export * from "./build";
 export * from "./planner";
 export * from "./compiler";
 export * from "./exporter";