@actiondock/core 2.10.0 → 2.12.0

package/dist/runtime/module-loader.d.ts

@@ -1,2 +0,0 @@
-export type { ModuleLoader } from "../node/module-loader.js";
-export { NodeModuleLoader, unwrapDefaultExport, } from "../node/module-loader.js";

package/dist/runtime/module-loader.js

@@ -1 +0,0 @@
-export { NodeModuleLoader, unwrapDefaultExport, } from "../node/module-loader.js";

package/dist/runtime/process.d.ts

@@ -1,8 +0,0 @@
-import type { ProcessAPI } from "@actiondock/sdk";
-/**
- * 进程执行器统一契约别名。
- *
- * 面向宿主与上层服务的进程能力均以 ProcessAPI 接口为准，
- * 具体实现由各平台适配层（如 NodeProcessExecutor）提供。
- */
-export type ProcessExecutor = ProcessAPI;

package/dist/runtime/process.js

@@ -1 +0,0 @@
-export {};

package/dist/runtime/runner.d.ts

@@ -1,234 +0,0 @@
-import type { ActionDefinition, ActionRef, ExecutionResult, Logger, ProcessAPI, ProgressReporter } from "@actiondock/sdk";
-import type { ProjectConfig } from "../project/types.js";
-import type { RuntimeStorage } from "../storage/types.js";
-import type { Clock } from "./clock.js";
-import type { ProcessOwner } from "../process/index.js";
-import type { PackageIdentity } from "./identity.js";
-import type { ActionInvoker } from "../execution/types.js";
-/**
- * 局部动作解析器委托函数契约（仅限当前包内部动作）。
- */
-export type LocalActionResolver = (actionId: string) => ActionDefinition | undefined | Promise<ActionDefinition | undefined>;
-/**
- * ActionRunner 初始化配置选项。
- */
-export interface ActionRunnerOptions {
-    /** 显式注入的包物理与快照身份标识值对象（必填单一事实源） */
-    identity: PackageIdentity;
-    /** 持久化运行时存储实例（SQLite） */
-    storage: RuntimeStorage;
-    /** 全局共享持久化存储实例（SQLite，用于单例池化避免泄漏） */
-    globalStorage?: RuntimeStorage;
-    /** 项目根目录绝对路径 */
-    projectRoot?: string;
-    /** 项目元数据配置 */
-    projectConfig?: ProjectConfig;
-    /** CLI 或上层注入的临时配置覆盖项 */
-    configOverrides?: Record<string, unknown>;
-    /** 预加载的 Action 映射表 */
-    actions?: Map<string, ActionDefinition>;
-    /** 外部注入的进程执行器 */
-    process?: ProcessAPI;
-    /** 可选的时间与时钟源（默认使用存储内嵌时钟或系统时间） */
-    clock?: Clock;
-    /** 仅支持当前包局部 Action 的动态解析委托函数 */
-    actionResolver?: LocalActionResolver;
-    /** 自定义 ActionDock 用户家目录（用于测试隔离与多租户环境） */
-    customHome?: string;
-    /** 执行宿主会话标识 */
-    hostSessionId?: string;
-    /** 子任务调用委托函数 */
-    actionInvoker?: ActionInvoker;
-}
-/**
- * 启动 Action 执行时的可选控制参数。
- */
-export interface ExecutionStartOptions {
-    /** 显式指定的运行 ID */
-    runId?: string;
-    /** 根运行 ID */
-    rootRunId?: string;
-    /** 父级运行 ID（嵌套调用场景下建立调用链树） */
-    parentRunId?: string;
-    /** 包物理实例标识 */
-    packageInstanceId?: string;
-    /** 快照代次标识 */
-    generationId?: string;
-    /** 执行所有者标识 */
-    ownerId?: string;
-    /** 租户标识 */
-    tenantId?: string;
-    /** 主体标识 */
-    principalId?: string;
-    /** 显式执行归属所有者契约 */
-    owner?: ProcessOwner;
-    /** 执行宿主会话标识 */
-    hostSessionId?: string;
-    /** 调用栈数组（用于检测 A -> B -> A 环路死锁） */
-    callStack?: string[];
-    /** 外部传入的 AbortSignal 取消信号 */
-    signal?: AbortSignal;
-    /** 最大超时时间（毫秒），超时将自动中止执行并标记为 ACTION_TIMEOUT */
-    timeoutMs?: number;
-    /** 最大调用深度覆盖 */
-    maxCallDepth?: number;
-    /** 外部注入的进程执行器 */
-    process?: ProcessAPI;
-    /** 可选的时间与时钟源 */
-    clock?: Clock;
-    /** 外部注入的进度报告器 */
-    progress?: ProgressReporter;
-    /** 外部注入的日志记录器 */
-    logger?: Logger;
-    /** 执行级临时配置覆盖项 */
-    configOverrides?: Record<string, unknown>;
-    /** 子任务调用委托函数 */
-    actionInvoker?: ActionInvoker;
-}
-/**
- * 异步执行句柄，支持获取执行结果 Promise 与主动取消操作。
- */
-export interface ExecutionHandle {
-    /** 本次执行生成的全局唯一运行 ID */
-    runId: string;
-    /** 最终执行结果信封 Promise */
-    result: Promise<ExecutionResult>;
-    /**
-     * 取消当前正在执行的任务
-     * @param reason 取消原因
-     * @returns 是否成功触发取消
-     */
-    cancel(reason?: string): boolean;
-}
-/**
- * Action 解析结果判别联合类型。
- */
-export type ActionResolution = {
-    status: "found";
-    action: ActionDefinition;
-} | {
-    status: "not_found";
-    reason?: string;
-};
-/**
- * ActionDock 核心执行引擎（ActionRunner）。
- *
- * 本类为执行编排壳：负责 Action 执行的全生命周期编排（校验、深度与环路检测、
- * 超时与取消竞态、子调用 uses 授权与错误分类），并将单一职责域委托至独立模块：
- * - Action 注册与检索委托 ActionRegistry（action-registry.ts）
- * - RunRecord 构造与落库委托 run-persistence.ts
- * - 跨包动作调用委托注入的 ActionInvoker 并重返目标包执行服务
- *
- * 入参 (inputSchema) 与出参 (outputSchema) 的 JSON Schema 严格校验、嵌套 Action
- * 相互调用的环路检测（Cycle Detection）、超时 (Timeout) 与中断信号 (AbortSignal)
- * 竞态控制与运行记录持久化编排仍由本类承担。
- */
-export declare class ActionRunner {
-    readonly identity: PackageIdentity;
-    readonly packageId: string;
-    readonly packageInstanceId: string;
-    readonly generationId: string;
-    private storage;
-    private globalStorage?;
-    private projectRoot?;
-    private projectConfig?;
-    private configOverrides;
-    private registry;
-    private clock?;
-    private process?;
-    private customHome?;
-    private actionResolver?;
-    private hostSessionId?;
-    private actionInvoker?;
-    constructor(options: ActionRunnerOptions);
-    /** 本地 Action 注册表底层映射 */
-    private get actions();
-    getStorage(): RuntimeStorage;
-    /**
-     * 注册单个 Action 到当前 Runner。
-     */
-    registerAction(id: string, action: ActionDefinition): void;
-    registerAction(action: ({
-        id: string;
-        action?: ActionDefinition;
-    } & Partial<ActionDefinition>) | ActionDefinition): void;
-    /**
-     * 根据 ID 检索注册的 Action。
-     */
-    getAction(id: string): ActionDefinition | undefined;
-    /**
-     * 设置子任务动作调用委托器。
-     */
-    setActionInvoker(invoker?: ActionInvoker): void;
-    /**
-     * 动态解析 Action（支持本地注册表、自定义解析器委托与已链接包目录索引检索）。
-     *
-     * @param actionOrRef Action 定义对象、引用或标识符
-     * @returns 解析判别联合结果（found | not_found）
-     */
-    resolveAction(actionOrRef: ActionDefinition | ActionRef | string): Promise<ActionResolution>;
-    /**
-     * 获取当前 Runner 已注册的所有 Action 列表。
-     */
-    listActions(): ActionDefinition[];
-    /**
-     * 异步启动 Action 的执行并立即返回 ExecutionHandle 句柄。
-     *
-     * @param actionOrId Action 定义对象、引用或标识符
-     * @param input 传递给 Action 的输入数据
-     * @param options 执行控制选项（超时、取消信号、父运行 ID 等）
-     * @returns 包含 runId、result Promise 和 cancel 方法的执行句柄
-     */
-    start(actionOrId: ActionDefinition | ActionRef | string, input?: unknown, options?: ExecutionStartOptions): ExecutionHandle;
-    /**
-     * 计算根运行标识（优先显式 rootRunId，其次 parentRunId，最后自身 runId）。
-     */
-    private computeRootRunId;
-    /**
-     * 预解析执行目标并装配运行期共享上下文对象（runId、目标标识、时钟源与调用栈快照）。
-     */
-    private prepareRunContext;
-    /**
-     * 依据运行期上下文装配落库模块入参（RunRecord 构造领域契约）。
-     */
-    private buildRunPersistenceInput;
-    /**
-     * 输入参数 JSON Schema 校验（若 action 已就绪，返回校验错误或 undefined）。
-     */
-    private checkActionInputSchema;
-    /**
-     * 构建 ActionContext 运行时上下文（内嵌子 Action 调用委托提为私有方法）。
-     */
-    private buildActionContext;
-    /**
-     * 子 Action 调用委托：
-     * 必须委托 Host 动作调用器（走 Host 执行主链与 InvocationPolicy 鉴权）；
-     * 缺少 actionInvoker 时直接抛出 INVOCATION_UNSUPPORTED，严禁跨包或同包无约束执行逃逸。
-     */
-    private invokeChildAction;
-    /**
-     * 执行 Action 业务逻辑并与取消/超时信号进行竞态，返回执行结果信封 Promise。
-     */
-    private raceExecutionAndAbort;
-    /**
-     * 输出结果 Schema 校验（返回校验错误或 undefined）。
-     */
-    private checkActionOutputSchema;
-    /**
-     * 异常分类收敛：超时、取消与业务失败分别映射为对应终态与错误码。
-     */
-    private classifyExecutionError;
-    /**
-     * 释放 Runner 持有的资源。
-     * 铁律 4：Runner 仅执行自己所属 Package 的 Action，不管理外部包生命周期。
-     */
-    dispose(): Promise<void>;
-    /**
-     * 同步等待方式执行指定 Action，直接返回 ExecutionResult 信封结果。
-     *
-     * @param actionOrId Action 定义对象、引用或标识符
-     * @param input 输入参数
-     * @param options 执行控制选项
-     */
-    execute(actionOrId: ActionDefinition | ActionRef | string, input?: unknown, options?: ExecutionStartOptions): Promise<ExecutionResult>;
-}