@actiondock/core 2.10.0 → 2.11.0

package/dist/execution/service.d.ts

@@ -1,36 +1,56 @@
-import type { ActionDefinition, ActionRef, ExecutionEvent, ExecutionResult, JsonValue, RunRecord } from "@actiondock/sdk";
+import type { ActionDefinition, ActionRef, ExecutionEvent, ExecutionResult, RunRecord } from "@actiondock/sdk";
 import { type EventSink } from "../runtime/events.js";
-import { type ExecutionHandle } from "../runtime/runner.js";
+import { type RuntimeStorage } from "../storage/types.js";
 import { type PackageIdentity } from "../runtime/identity.js";
-import type { ActionInvoker, CancelResult, ExecutionService, ExecutionServiceOptions, ExecutionTicket, InvocationContext } from "./types.js";
+import type { ActionInvoker, CancelResult, ExecutionHandle, ExecutionService, ExecutionServiceOptions, ExecutionTicket } from "./types.js";
+import { type InvocationContext, type RunOptions } from "../invocation/types.js";
 export type { ExecutionServiceOptions };
 /**
- * 统一执行协调服务实现。
+ * 在途运行心跳刷新间隔（毫秒）。
+ *
+ * 必须显著小于存活判定的宽限期（见 run-liveness 的 RUN_LIVENESS_GRACE_MS），
+ * 保证心跳正常的宿主绝不被误判过期；间隔内崩溃由进程探测兜底，
+ * 心跳只服务无进程标识的遗留记录收敛判定。
+ */
+export declare const RUN_HEARTBEAT_INTERVAL_MS = 30000;
+/**
+ * 统一执行引擎（融合原协调服务与运行器）。
+ * 消除双层 AbortController 与重复参数透传，收敛唯一生命周期与存储落库。
  */
 export declare class DefaultExecutionService implements ExecutionService {
     readonly identity: PackageIdentity;
     readonly packageId: string;
+    readonly packageInstanceId: string;
+    readonly generationId: string;
+    hostSessionId?: string;
+    /** 宿主进程标识：落库到运行记录供跨进程存活判定（并发打开同一数据目录时不误收割） */
+    readonly hostPid: number;
+    readonly eventSink: EventSink;
     private storage;
+    private globalStorage?;
     private projectConfig?;
     private projectRoot?;
+    private configOverrides;
     private moduleLoader?;
-    readonly eventSink: EventSink;
-    readonly packageInstanceId: string;
-    readonly generationId: string;
     private maxActiveRuns;
     private ownerId;
-    hostSessionId?: string;
-    private _runner;
+    private actionResolver?;
     private logger?;
-    private clock?;
+    private clock;
     private process?;
-    private actionResolver?;
-    private activeRuns;
-    private globalStorage?;
     private actionInvoker?;
+    private registry;
+    private activeRuns;
+    /** 在途运行心跳定时器：周期性刷新心跳时间戳，支撑无进程标识判定路径的兜底收敛 */
+    private heartbeatTimer?;
     private isClosing;
     private reservedSlots;
     constructor(options: ExecutionServiceOptions);
+    /** 获取运行底层存储实例 */
+    getStorage(): RuntimeStorage;
+    /** 兼容性引用，执行引擎即执行器自身 */
+    get _runner(): this;
+    get activeRunsCount(): number;
     setActionInvoker(invoker?: ActionInvoker): void;
     registerAction(id: string, action: ActionDefinition): void;
     registerAction(action: ({
@@ -40,35 +60,21 @@ export declare class DefaultExecutionService implements ExecutionService {
     getAction(id: string): ActionDefinition | undefined;
     listActions(): ActionDefinition[];
     getActiveHandle(runId: string): ExecutionHandle | undefined;
-    execute(ref: ActionRef | string, input: JsonValue, context: InvocationContext): Promise<ExecutionResult>;
-    run(ref: ActionRef | string, input: JsonValue, context: InvocationContext): Promise<ExecutionResult>;
-    get activeRunsCount(): number;
-    start(ref: ActionRef | string, input: JsonValue, context: InvocationContext): Promise<ExecutionTicket>;
-    /**
-     * 幂等门检查：digest 计算与冲突/重复分流（重复命中时直接返回已有票据）。
-     */
+    execute(ref: ActionDefinition | ActionRef | string, input?: unknown, contextOrOptions?: InvocationContext | RunOptions | Record<string, unknown>): Promise<ExecutionResult>;
+    run(ref: ActionDefinition | ActionRef | string, input?: unknown, contextOrOptions?: InvocationContext | RunOptions | Record<string, unknown>): Promise<ExecutionResult>;
+    start(ref: ActionDefinition | ActionRef | string, input?: unknown, contextOrOptions?: InvocationContext | RunOptions | Record<string, unknown>): Promise<ExecutionTicket & ExecutionHandle>;
+    private normalizeContext;
+    private raceExecution;
+    private classifyExecutionError;
+    private invokeChildAction;
     private checkIdempotencyGate;
-    /**
-     * 解析执行目标：确定目标 Action 定义。
-     * 铁律 4：Runner 不找 Package，ExecutionService 仅执行本 Package 的 Action。
-     */
     private resolveExecutionTarget;
-    /**
-     * 解析指定 Action 定义（供 PackageRuntime 或内部使用）。
-     */
     resolveAction(ref: ActionRef | string): Promise<ActionDefinition | undefined>;
-    /**
-     * 目标 Action 缺失时的失败票据：落库 failed 记录并补发 status 与 finish 事件。
-     */
     private failTicketForMissingAction;
-    /**
-     * 创建执行事件桥：事件序列号分配、进度报告器与双写日志适配器。
-     */
+    private buildPersistenceInput;
+    private checkActionInputSchema;
+    private checkActionOutputSchema;
     private createEventBridge;
-    /**
-     * 监听执行句柄终态：映射终态状态、补发 status 与 finish 事件并注销活跃运行。
-     */
-    private watchHandleCompletion;
     get(runId: string): Promise<RunRecord | undefined>;
     cancel(runId: string, reason?: string): Promise<CancelResult>;
     events(runId: string, options?: {
@@ -76,8 +82,20 @@ export declare class DefaultExecutionService implements ExecutionService {
         signal?: AbortSignal;
         maxQueueSize?: number;
     }): AsyncIterable<ExecutionEvent>;
+    /**
+     * 确保在途运行心跳定时器存在。
+     *
+     * 存活判定的第一依据是进程探测（运行记录已落库宿主进程标识），
+     * 心跳是对遗留记录（无进程标识）与其他协作场景的兜底信号：
+     * 持有进程周期性刷新在途记录的心跳时间戳，收割方仅对心跳过期的
+     * 遗留记录做宽限期判定，正常运行中的记录绝不会被误判过期。
+     * 定时器不阻塞进程退出（unref），无在途运行时不产生任何调度。
+     */
+    private ensureHeartbeatTimer;
     close(options?: {
         graceMs?: number;
     }): Promise<void>;
+    dispose(): Promise<void>;
 }
 export { DefaultExecutionService as ExecutionService };
+export { DefaultExecutionService as ActionRunner };