@actiondock/builder 2.0.11 → 2.0.12

package/dist/archive.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 将目录打包为标准 zip 归档（PKZIP APPNOTE 结构）。
+ * 直接流式分块写入磁盘，避免在内存中积压全量归档内容。
+ *
+ * @param dir 待打包目录（目录名即归档内根文件夹名）
+ * @param outPath 输出 zip 文件路径
+ */
+export declare function createZipArchive(dir: string, outPath: string): void;
+/**
+ * 异步标准 zip 归档。
+ */
+export declare function createZipArchiveAsync(dir: string, outPath: string): Promise<void>;
+/**
+ * 将目录打包为标准 tar.gz 归档（USTAR + gzip）。
+ *
+ * @param dir 待打包目录（目录名即归档内根文件夹名）
+ * @param outPath 输出 tar.gz 文件路径
+ */
+export declare function createTarGzArchive(dir: string, outPath: string): void;
+/**
+ * 将目录异步流式打包为标准 tar.gz 归档（USTAR + gzip 流），避免把超大二进制和归档缓冲在内存中。
+ *
+ * @param dir 待打包目录
+ * @param outPath 输出 tar.gz 文件路径
+ */
+export declare function createTarGzArchiveAsync(dir: string, outPath: string): Promise<void>;

package/dist/build.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 独立二进制可执行文件构建选项。
+ */
+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 declare function buildProject(options: BuildOptions): Promise<BuildResult>;

package/dist/compiler.d.ts

@@ -0,0 +1,22 @@
+import type { BunCompilerOptions, BunCompilerResult } from "./types";
+/**
+ * Bun 独立二进制编译器。
+ * 封装 bun build --compile 调用，提前校验选项组合，收集构建产物与元数据。
+ */
+export declare class BunCompiler {
+    /**
+     * 执行独立二进制编译。
+     *
+     * @param options 编译参数
+     * @returns 编译产物元数据结果
+     */
+    compile(options: BunCompilerOptions): Promise<BunCompilerResult>;
+    /**
+     * 静态辅助调用方法。
+     */
+    static compile(options: BunCompilerOptions): Promise<BunCompilerResult>;
+}
+/**
+ * 快捷独立二进制编译函数。
+ */
+export declare function compileBinary(options: BunCompilerOptions): Promise<BunCompilerResult>;

package/dist/errors.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Builder 模块基础错误类。
+ */
+export declare class BuilderError extends Error {
+    constructor(message: string);
+}
+/**
+ * 构建规划阶段抛出的错误。
+ */
+export declare class PlannerError extends BuilderError {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * 编译器参数与目标平台校验错误。
+ */
+export declare class CompilerValidationError extends BuilderError {
+    readonly code: string;
+    readonly target?: string;
+    constructor(message: string, options?: {
+        code?: string;
+        target?: string;
+    });
+}
+/**
+ * 编译器调用执行失败错误。包含标准化错误码与详情。
+ */
+export declare class CompilerError extends BuilderError {
+    readonly code: string;
+    readonly exitCode: number;
+    readonly rawError: string;
+    readonly details: string[];
+    readonly target?: string;
+    constructor(message: string, options: {
+        code: string;
+        exitCode: number;
+        rawError: string;
+        details?: string[];
+        target?: string;
+    });
+}

package/dist/exporter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 获取内部 @actiondock/* 依赖的版本号规则。
+ * 若为主干预发布版本（包含破折号如 -beta / -rc），直接对齐精确版本；普通正式版采用 ^ 范围约束。
+ */
+export declare function getInternalDependencyVersion(version?: string): string;
+import type { BatchSkillExportOptions, BatchSkillExportResult, CompositeSkillExportOptions, CompositeSkillExportResult, SkillExporterOptions, SkillExportResult } from "./types";
+/**
+ * 检索单个 Action 项目目录中已存在的 SKILL.md 文件。
+ */
+export declare function findExistingSingleSkillMd(projectRoot: string, explicitPath?: string, pkgSlug?: string): string | undefined;
+/**
+ * 检索复合套件工作区中已存在的 SKILL.md 文件。
+ */
+export declare function findExistingCompositeSkillMd(options: CompositeSkillExportOptions): string | undefined;
+/**
+ * Agent Skill 导出器。
+ * 负责源码型 Skill 与独立二进制型 Skill 的构建、打包与归档分发。
+ */
+export declare class SkillExporter {
+    /**
+     * 导出 Skill 产物包。
+     *
+     * @param options 导出配置
+     * @returns 导出产物详细描述
+     */
+    export(options: SkillExporterOptions): Promise<SkillExportResult>;
+    /**
+     * 批量导出多个 Skill。
+     */
+    exportBatch(options: BatchSkillExportOptions): Promise<BatchSkillExportResult>;
+    /**
+     * 静态辅助调用批量导出方法。
+     */
+    static exportBatch(options: BatchSkillExportOptions): Promise<BatchSkillExportResult>;
+    /**
+     * 复合模式导出：将多个包聚合为一个统一的复合技能目录。
+     */
+    exportComposite(options: CompositeSkillExportOptions): Promise<CompositeSkillExportResult>;
+    /**
+     * 静态辅助调用复合导出方法。
+     */
+    static exportComposite(options: CompositeSkillExportOptions): Promise<CompositeSkillExportResult>;
+    /**
+     * 静态辅助调用方法。
+     */
+    static export(options: SkillExporterOptions): Promise<SkillExportResult>;
+}
+/**
+ * 快捷导出 Skill 产物函数。
+ */
+export declare function exportSkill(options: SkillExporterOptions): Promise<SkillExportResult>;
+/**
+ * 快捷批量导出多个 Skill 产物函数。
+ */
+export declare function exportSkillBatch(options: BatchSkillExportOptions): Promise<BatchSkillExportResult>;
+/**
+ * 快捷复合模式导出 Skill 产物函数。
+ */
+export declare function exportCompositeSkill(options: CompositeSkillExportOptions): Promise<CompositeSkillExportResult>;

package/{src/index.ts → dist/index.d.ts}

@@ -4,3 +4,4 @@ export * from "./build";
 export * from "./planner";
 export * from "./compiler";
 export * from "./exporter";
+export * from "./archive";