@actiondock/core 2.0.12 → 2.2.1

package/dist/target/target.d.ts

@@ -0,0 +1,6 @@
+import type { ActionDockTarget, TargetOptions } from "./types.js";
+/**
+ * 工厂函数：统一创建 ActionDockTarget 实例。
+ * 依据传入参数自动决策创建 LocalActionDockTarget 或 RemoteActionDockTarget。
+ */
+export declare function createActionDockTarget(options?: TargetOptions): Promise<ActionDockTarget>;

package/dist/target/target.js

@@ -0,0 +1,35 @@
+import { createActionDockApp } from "../app/app.js";
+import { createActionDockHost } from "../host/host.js";
+import { LocalActionDockTarget } from "./local.js";
+import { RemoteActionDockTarget } from "./remote.js";
+/**
+ * 工厂函数：统一创建 ActionDockTarget 实例。
+ * 依据传入参数自动决策创建 LocalActionDockTarget 或 RemoteActionDockTarget。
+ */
+export async function createActionDockTarget(options = {}) {
+    if (options.type === "ipc") {
+        const { IpcActionDockTarget } = await import("../ipc/target.js");
+        return new IpcActionDockTarget(options);
+    }
+    if (options.type === "remote" ||
+        ("serverUrl" in options && Boolean(options.serverUrl))) {
+        return new RemoteActionDockTarget(options);
+    }
+    const localOpts = options;
+    if (localOpts.host) {
+        return new LocalActionDockTarget(localOpts.host);
+    }
+    if (localOpts.app) {
+        return new LocalActionDockTarget(localOpts.app);
+    }
+    if (localOpts.appOptions) {
+        const app = await createActionDockApp(localOpts.appOptions);
+        return new LocalActionDockTarget(app);
+    }
+    const host = await createActionDockHost({
+        scanLinkedPackages: localOpts.scanLinkedPackages ?? true,
+        ...localOpts,
+        ...(localOpts.hostOptions || {}),
+    });
+    return new LocalActionDockTarget(host);
+}

package/dist/target/types.d.ts

@@ -0,0 +1,246 @@
+import type { ActionRef, ExecutionEvent, ExecutionResult, JsonValue, RunRecord } from "@actiondock/sdk";
+import type { ActionDockApp, ActionDockAppOptions, ActionSpec, ActionSummary, ListActionsOptions, PackageInfo, PlaybookSpec, PlaybookSummary } from "../app/types.js";
+import type { CancelResult, ExecuteOptions, ExecutionTicket } from "../execution/types.js";
+import type { ActionDockHost, ActionDockHostOptions } from "../host/types.js";
+import type { RuntimePlatform } from "../platform/types.js";
+import type { StateEntry } from "../storage/types.js";
+/**
+ * 统一协议版本常量。
+ */
+export declare const ACTIONDOCK_PROTOCOL_VERSION = "2.0";
+/**
+ * Target 错误码常量。
+ */
+export declare const TARGET_PROTOCOL_UNSUPPORTED = "TARGET_PROTOCOL_UNSUPPORTED";
+export declare const TARGET_CAPABILITY_UNAVAILABLE = "TARGET_CAPABILITY_UNAVAILABLE";
+export declare const TARGET_RESULT_UNKNOWN = "TARGET_RESULT_UNKNOWN";
+/**
+ * 结构化 Target 异常类。
+ */
+export declare class TargetError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+}
+/**
+ * 关闭超时异常类。
+ */
+export declare class CloseTimeoutError extends Error {
+    readonly runIds?: string[];
+    constructor(message?: string, runIds?: string[]);
+}
+/**
+ * 幂等性保留策略。
+ */
+export interface IdempotencyPolicy {
+    /** 去重记录保留时长（毫秒） */
+    retentionMs?: number;
+    /** 去重请求头标识字段名 */
+    header?: string;
+    [key: string]: unknown;
+}
+/**
+ * 统一目标自省元数据信息。
+ */
+export interface TargetInfo {
+    /** 目标宿主唯一标识 */
+    id: string;
+    /** 目标宿主名称 */
+    name: string;
+    /** 统一通信协议版本 */
+    protocolVersion: string;
+    /** 已加载或已发现的包清单 */
+    packages: PackageInfo[];
+    /** 服务端声明的能力集合 */
+    capabilities: string[];
+    /** 去重记录保留与幂等策略 */
+    idempotencyPolicy?: IdempotencyPolicy;
+    [key: string]: unknown;
+}
+/**
+ * 配置项安全视图契约。
+ * 屏蔽敏感配置原文，仅暴露是否已配置、是否为秘密及实际解析来源。
+ */
+export interface ConfigValueView {
+    /** 配置项键名 */
+    key: string;
+    /** 是否已显式配置或存在有效值 */
+    configured: boolean;
+    /** 是否为秘密敏感配置 */
+    secret: boolean;
+    /** 配置值实际解析来源 */
+    source: string;
+    /** 非秘密配置的实际数据值 */
+    value?: JsonValue;
+}
+/**
+ * 状态作用域与筛选控制选项。
+ */
+export interface StateScopeOptions {
+    /** 显式绑定的 Action 标识（可选，用于在扁平调用时直接定位 Action 命名空间） */
+    actionId?: string;
+    /** 显式子命名空间（相对于 Action 根命名空间） */
+    namespace?: string;
+    /** 存活有效期（秒），仅在写入状态时生效 */
+    ttl?: number;
+    /** 键名前缀过滤匹配 */
+    prefix?: string;
+    /** 是否清空所有条目 */
+    all?: boolean;
+    /** 是否返回完整条目详情 */
+    detail?: boolean;
+}
+/**
+ * ActionDockTarget 统一调用门面契约。
+ * 为 CLI、SDK 及扩展系统屏蔽本地执行与远程调用的物理拓扑差异。
+ */
+export interface ActionDockTarget {
+    /** 获取统一目标自省元数据信息 */
+    info(): Promise<TargetInfo>;
+    /** 列出目标所有已加载的包清单 */
+    listPackages(): Promise<PackageInfo[]>;
+    /** 静态列出目标所有可用的 Action 摘要 */
+    listActions(options?: ListActionsOptions): Promise<ActionSummary[]>;
+    /** 静态查询并返回指定 Action 的规范结构与模式定义 */
+    describeAction(ref: ActionRef | string): Promise<ActionSpec>;
+    /** 静态列出目标所有可用的 Playbook 规程摘要 */
+    listPlaybooks(options?: {
+        intent?: string;
+        package?: string;
+    }): Promise<PlaybookSummary[]>;
+    /** 静态查询并返回指定 Playbook 的规范内容与操作指南 */
+    describePlaybook(id: string): Promise<PlaybookSpec>;
+    /** 同步执行指定 Action 并等待终态结果 */
+    runAction(ref: ActionRef | string, input: JsonValue, options?: ExecuteOptions): Promise<ExecutionResult>;
+    /** 异步启动指定 Action 并立即返回任务执行票据 */
+    startAction(ref: ActionRef | string, input: JsonValue, options?: ExecuteOptions): Promise<ExecutionTicket>;
+    /** 查询最近的任务执行记录列表 */
+    listRuns(options?: ListRunsOptions): Promise<RunRecord[]>;
+    /** 查询指定运行标识的记录详情 */
+    getRun(runId: string): Promise<RunRecord | undefined>;
+    /** 取消指定在运行的任务 */
+    cancelRun(runId: string, reason?: string): Promise<CancelResult>;
+    /** 清空历史任务运行记录 */
+    clearRuns?(options?: {
+        packageId?: string;
+        actionId?: string;
+        status?: string;
+    }): Promise<number>;
+    /** 订阅指定运行的事件流 */
+    events(runId: string, options?: {
+        after?: number | string;
+        signal?: AbortSignal;
+        maxQueueSize?: number;
+    }): AsyncIterable<ExecutionEvent>;
+    /** 获取指定包的单项配置安全视图 */
+    getConfig(packageId: string, key: string): Promise<ConfigValueView>;
+    /** 写入或覆盖指定包的配置项 */
+    setConfig(packageId: string, key: string, value: JsonValue): Promise<void>;
+    /** 删除指定包的指定配置项 */
+    deleteConfig(packageId: string, key: string): Promise<boolean>;
+    /** 列出指定包所有配置项的安全视图列表 */
+    listConfig(packageId: string): Promise<ConfigValueView[]>;
+    /** 获取指定包指定动作的作用域状态值 */
+    getState<T extends JsonValue = JsonValue>(packageId: string, actionId: string, key: string, options?: StateScopeOptions): Promise<T | undefined>;
+    /** 写入指定包指定动作的作用域状态值 */
+    setState<T extends JsonValue = JsonValue>(packageId: string, actionId: string, key: string, value: T, options?: StateScopeOptions): Promise<void>;
+    /** 删除指定包指定动作的作用域状态项 */
+    deleteState(packageId: string, actionId: string, key: string, options?: StateScopeOptions): Promise<boolean>;
+    /** 列出指定包指定动作在存储中的状态键名列表 */
+    listStateKeys(packageId: string, actionId: string, options?: StateScopeOptions): Promise<string[]>;
+    /** 清空指定包指定动作在存储中的状态条目 */
+    clearState(packageId: string, actionId: string, options?: StateScopeOptions): Promise<number>;
+    /** 列出指定包在存储中的状态条目（含完整元数据） */
+    listStateEntries?(packageId: string, options?: any): Promise<StateEntry[]>;
+    /** 解包被包装的内部宿主或应用实例（仅本地包装型目标存在） */
+    unwrap?(): ActionDockHost | ActionDockApp | undefined;
+    /** 关闭目标连接并清理底层资源 */
+    close(options?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+}
+/**
+ * 历史任务执行记录检索查询选项。
+ */
+export interface ListRunsOptions {
+    /** 目标包唯一标识 */
+    packageId?: string;
+    /** Action 动作唯一标识 */
+    actionId?: string;
+    /** 运行终态状态筛选 */
+    status?: string;
+    /** 模糊意图检索模式 */
+    intent?: string;
+    /** 最大返回记录条数限制 */
+    limit?: number;
+}
+/**
+ * 本地 Target 初始化选项。
+ */
+export interface LocalTargetOptions {
+    type?: "local";
+    /** 包装的 ActionDockHost 实例 */
+    host?: ActionDockHost;
+    /** 包装的 ActionDockApp 实例 */
+    app?: ActionDockApp;
+    /** 单包 App 初始化配置（若未提供 host/app） */
+    appOptions?: ActionDockAppOptions;
+    /** 宿主 Host 初始化配置 */
+    hostOptions?: ActionDockHostOptions;
+    /** 当前工程根目录绝对路径 */
+    projectRoot?: string;
+    /** 预注册包配置列表 */
+    packages?: Array<ActionDockApp | ActionDockAppOptions>;
+    /** 自定义 ActionDock 家目录 */
+    customHome?: string;
+    /** 是否采用纯内存运行模式 */
+    inMemory?: boolean;
+    /** 自定义全局数据存储目录 */
+    dataDir?: string;
+    /** 是否扫描已软链接的外部包 */
+    scanLinkedPackages?: boolean;
+    /** 运行时平台适配 */
+    platform?: RuntimePlatform;
+}
+/**
+ * 远程 Target 初始化选项。
+ */
+export interface RemoteTargetOptions {
+    type?: "remote";
+    /** 远端 ActionDock 服务 HTTP 根地址 */
+    serverUrl: string;
+    /** 鉴权 Bearer Token（可选） */
+    token?: string;
+    /** 是否允许向非回环地址发送明文 HTTP 请求（默认 false） */
+    allowInsecureHttp?: boolean;
+    /** 请求超时时间（毫秒） */
+    timeoutMs?: number;
+    /** 轮询等待基准底线超时时间（毫秒，默认 60000ms） */
+    baseTimeoutMs?: number;
+}
+/**
+ * 监督进程 IPC 目标初始化选项。
+ */
+export interface IpcTargetOptions {
+    type?: "ipc";
+    /** 已启动的子进程实例（需具备 IPC 通道） */
+    childProcess?: any;
+    /** 待启动的脚本物理路径 */
+    scriptPath?: string;
+    /** 启动参数 */
+    scriptArgs?: string[];
+    /** 工作目录 */
+    cwd?: string;
+    /** 环境变量 */
+    env?: Record<string, string | undefined>;
+    /** 诊断流单流最大转发字节数 */
+    maxDiagnosticBytes?: number;
+    /** 诊断流每秒最大字节速率 */
+    maxDiagnosticRate?: number;
+    /** 诊断流目标输出 */
+    diagnosticTarget?: any;
+}
+/**
+ * Target 统一工厂选项参数。
+ */
+export type TargetOptions = LocalTargetOptions | RemoteTargetOptions | IpcTargetOptions;

package/dist/target/types.js

@@ -0,0 +1,34 @@
+/**
+ * 统一协议版本常量。
+ */
+export const ACTIONDOCK_PROTOCOL_VERSION = "2.0";
+/**
+ * Target 错误码常量。
+ */
+export const TARGET_PROTOCOL_UNSUPPORTED = "TARGET_PROTOCOL_UNSUPPORTED";
+export const TARGET_CAPABILITY_UNAVAILABLE = "TARGET_CAPABILITY_UNAVAILABLE";
+export const TARGET_RESULT_UNKNOWN = "TARGET_RESULT_UNKNOWN";
+/**
+ * 结构化 Target 异常类。
+ */
+export class TargetError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "TargetError";
+        this.code = code;
+        this.details = details;
+    }
+}
+/**
+ * 关闭超时异常类。
+ */
+export class CloseTimeoutError extends Error {
+    runIds;
+    constructor(message = "Target close operation timed out", runIds) {
+        super(message);
+        this.name = "CloseTimeoutError";
+        this.runIds = runIds;
+    }
+}

package/dist/utils/index.d.ts

@@ -1,4 +1,11 @@
-export { findExecutable } from "@actiondock/sdk";
+/**
+ * 跨运行时安全查找可执行文件绝对物理路径。
+ *
+ * 注意：本函数为同步实现，内部同步遍历 PATH 逐个探测物理文件存在性；
+ * 当前全部调用方（doctor 体检与测试 CLI 桥）均为同步链路，serve 链路未使用本函数，
+ * 因此暂不提供异步版本。若后续异步链路需要，应另行新增异步实现而非改造本函数。
+ */
+export declare function findExecutable(command: string): string | null;
 /**
  * Parses duration strings like "500ms", "30s", "5m", "1h", "1d" or pure numbers into milliseconds.
  */
@@ -16,11 +23,24 @@ export declare const PACKAGE_ID_REGEX: RegExp;
  * Validates packageId to ensure it adheres to valid naming conventions and prevents path traversal.
  */
 export declare function assertValidPackageId(packageId: string): void;
+/**
+ * Resolves a path to its canonical physical location.
+ * If the path exists, calls realpathSync.
+ * If not, traverses upward to find the nearest existing ancestor, resolves its symlink,
+ * and appends the non-existent relative segments.
+ */
+export declare function canonicalizePath(targetPath: string): string;
+/**
+ * 校验相对路径是否越出根目录边界。
+ * 只有当相对路径为绝对路径、等于 ".." 或以 "..[/\\]" 起始时才判定为越界，
+ * 避免形如 ..cache、..cache/file 等在根目录内部的文件或目录被误判越界。
+ */
+export declare function isPathOutsideBoundary(rel: string): boolean;
 /**
  * Ensures that a given path stays strictly within the specified root boundary,
  * preventing relative directory escape (..) and symlink jailbreak.
  * Traverses upward to the nearest existing ancestor directory to resolve symlinks
- * even for non-existent paths.
+ * symmetrically for both root and target paths.
  */
 export declare function assertPathWithinRoot(rootDir: string, targetPath: string, fieldName?: string): void;
 /**

package/dist/utils/index.js

@@ -0,0 +1,180 @@
+import { existsSync, realpathSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, delimiter, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+/**
+ * 跨运行时安全查找可执行文件绝对物理路径。
+ *
+ * 注意：本函数为同步实现，内部同步遍历 PATH 逐个探测物理文件存在性；
+ * 当前全部调用方（doctor 体检与测试 CLI 桥）均为同步链路，serve 链路未使用本函数，
+ * 因此暂不提供异步版本。若后续异步链路需要，应另行新增异步实现而非改造本函数。
+ */
+export function findExecutable(command) {
+    if (typeof globalThis.Bun !== "undefined" && typeof globalThis.Bun.which === "function") {
+        try {
+            const bPath = globalThis.Bun.which(command);
+            if (bPath)
+                return bPath;
+        }
+        catch {
+            // ignore
+        }
+    }
+    const hasPathSep = command.includes("/") || command.includes("\\");
+    if (hasPathSep) {
+        return existsSync(command) ? command : null;
+    }
+    const pathEnv = process.env.PATH || "";
+    const dirs = pathEnv.split(delimiter);
+    const isWindows = process.platform === "win32";
+    const pathext = isWindows
+        ? (process.env.PATHEXT || ".COM;.EXE;.BAT;.CMD").split(";")
+        : [""];
+    for (const dir of dirs) {
+        if (!dir)
+            continue;
+        for (const ext of pathext) {
+            const candidate = join(dir, isWindows && !command.includes(".") ? command + ext : command);
+            if (existsSync(candidate)) {
+                return candidate;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Parses duration strings like "500ms", "30s", "5m", "1h", "1d" or pure numbers into milliseconds.
+ */
+export function parseDuration(input) {
+    if (!input || !input.trim()) {
+        return undefined;
+    }
+    const str = input.trim();
+    if (/^\d+$/.test(str)) {
+        return parseInt(str, 10);
+    }
+    const match = str.match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)$/i);
+    if (!match) {
+        throw new Error(`Invalid duration format: '${input}'. Supported formats: 500ms, 30s, 5m, 1h`);
+    }
+    const val = parseFloat(match[1]);
+    const unit = match[2].toLowerCase();
+    switch (unit) {
+        case "ms":
+            return Math.round(val);
+        case "s":
+            return Math.round(val * 1000);
+        case "m":
+            return Math.round(val * 60 * 1000);
+        case "h":
+            return Math.round(val * 60 * 60 * 1000);
+        case "d":
+            return Math.round(val * 24 * 60 * 60 * 1000);
+        default:
+            return undefined;
+    }
+}
+/**
+ * Extracts a concise slug from a package or action identifier (e.g. '@scope/pkg' -> 'pkg', 'team.action' -> 'action').
+ */
+export function getPackageSlug(id) {
+    if (id.includes("/")) {
+        return id.split("/").pop();
+    }
+    if (id.includes(".")) {
+        return id.split(".").pop();
+    }
+    return id;
+}
+/**
+ * Resolves the root ActionDock user home directory based on customHome, ACTIONDOCK_HOME, or user homedir.
+ */
+export function getActionDockHome(customHome) {
+    return customHome || process.env.ACTIONDOCK_HOME || homedir();
+}
+export const PACKAGE_ID_REGEX = /^[a-z0-9][a-z0-9.-]*$/;
+/**
+ * Validates packageId to ensure it adheres to valid naming conventions and prevents path traversal.
+ */
+export function assertValidPackageId(packageId) {
+    if (packageId === "__global__" || packageId === ":memory:") {
+        return;
+    }
+    const isScopedLegacy = /^@[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/.test(packageId);
+    if (!packageId ||
+        typeof packageId !== "string" ||
+        packageId.includes("..") ||
+        (!PACKAGE_ID_REGEX.test(packageId) && !isScopedLegacy)) {
+        throw new Error(`Invalid packageId '${packageId}': must match ${PACKAGE_ID_REGEX} and not contain path traversal characters`);
+    }
+}
+/**
+ * Resolves a path to its canonical physical location.
+ * If the path exists, calls realpathSync.
+ * If not, traverses upward to find the nearest existing ancestor, resolves its symlink,
+ * and appends the non-existent relative segments.
+ */
+export function canonicalizePath(targetPath) {
+    let curr = resolve(targetPath);
+    const missingSegments = [];
+    while (!existsSync(curr)) {
+        const parent = dirname(curr);
+        if (parent === curr) {
+            break;
+        }
+        missingSegments.unshift(basename(curr));
+        curr = parent;
+    }
+    if (existsSync(curr)) {
+        try {
+            const realCurr = realpathSync(curr);
+            return missingSegments.length > 0
+                ? resolve(realCurr, ...missingSegments)
+                : realCurr;
+        }
+        catch {
+            return resolve(targetPath);
+        }
+    }
+    return resolve(targetPath);
+}
+/**
+ * 校验相对路径是否越出根目录边界。
+ * 只有当相对路径为绝对路径、等于 ".." 或以 "..[/\\]" 起始时才判定为越界，
+ * 避免形如 ..cache、..cache/file 等在根目录内部的文件或目录被误判越界。
+ */
+export function isPathOutsideBoundary(rel) {
+    return (isAbsolute(rel) ||
+        rel === ".." ||
+        rel.startsWith(".." + sep) ||
+        rel.startsWith("../") ||
+        rel.startsWith("..\\"));
+}
+/**
+ * Ensures that a given path stays strictly within the specified root boundary,
+ * preventing relative directory escape (..) and symlink jailbreak.
+ * Traverses upward to the nearest existing ancestor directory to resolve symlinks
+ * symmetrically for both root and target paths.
+ */
+export function assertPathWithinRoot(rootDir, targetPath, fieldName = "path") {
+    const resolvedRoot = resolve(rootDir);
+    const resolvedTarget = resolve(rootDir, targetPath);
+    const rel = relative(resolvedRoot, resolvedTarget);
+    if (isPathOutsideBoundary(rel)) {
+        throw new Error(`'${fieldName}' escapes boundary '${rootDir}': ${targetPath}`);
+    }
+    const canonicalRoot = canonicalizePath(resolvedRoot);
+    const canonicalTarget = canonicalizePath(resolvedTarget);
+    const relReal = relative(canonicalRoot, canonicalTarget);
+    if (isPathOutsideBoundary(relReal)) {
+        throw new Error(`'${fieldName}' symlink resolves outside boundary '${rootDir}': ${targetPath}`);
+    }
+}
+/**
+ * Backwards-compatible alias for assertPathWithinRoot targeting project roots.
+ */
+export function assertWithinProjectRoot(projectRoot, subDir, fieldName) {
+    if (isAbsolute(subDir)) {
+        throw new Error(`'${fieldName}' cannot be an absolute path: ${subDir}`);
+    }
+    assertPathWithinRoot(projectRoot, subDir, fieldName);
+}

package/dist/version.d.ts

@@ -1,4 +1,4 @@
 /**
  * ActionDock 核心版本号单一事实源。
  */
-export declare const ACTIONDOCK_VERSION = "2.0.12";
+export declare const ACTIONDOCK_VERSION = "2.2.1";

package/dist/version.js

@@ -0,0 +1,4 @@
+/**
+ * ActionDock 核心版本号单一事实源。
+ */
+export const ACTIONDOCK_VERSION = "2.2.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actiondock/core",
-  "version": "2.0.12",
+  "version": "2.2.1",
   "description": "ActionDock Core Engine - Project loader, runtime execution, SQLite storage, standalone builder, and skill exporter",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,21 +18,20 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=22.13.0"
+    "node": ">=24.12.0"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build": "bun run ../../scripts/build.ts",
-    "test": "bun test"
+    "build": "node ../../scripts/build.ts",
+    "test": "node ../../scripts/run-tests.ts"
   },
   "dependencies": {
-    "@actiondock/sdk": "^2.0.12",
+    "@actiondock/sdk": "^2.2.1",
     "ajv": "^8.17.1",
-    "ajv-formats": "^3.0.1",
-    "yaml": "^2.7.0"
+    "ajv-formats": "^3.0.1"
   },
   "devDependencies": {
     "typescript": "^5.7.0"

package/dist/build/index.d.ts

@@ -1 +0,0 @@
-export * from "./templates";

package/dist/build/templates.d.ts

@@ -1,19 +0,0 @@
-/**
- * 构建时 Action 导入映射。
- */
-export interface ActionImport {
-    /** Action 唯一标识符 */
-    id: string;
-    /** Action 源码文件物理路径 */
-    filePath: string;
-}
-/**
- * 动态生成 Standalone 独立可执行文件的 TypeScript 入口文件源码。
- *
- * @param packageId 所属 Package ID
- * @param version 版本号
- * @param description 描述
- * @param actions 待打包 Action 列表
- * @param configDefs 声明的配置定义字典
- */
-export declare function generateStandaloneEntrypoint(packageId: string, version: string, description: string | undefined, actions: ActionImport[], configDefs?: Record<string, unknown>): string;