@actiondock/core 2.7.0 → 2.8.0

package/dist/errors.js

@@ -29,14 +29,8 @@ export const INPUT_NOT_JSON = "INPUT_NOT_JSON";
 export const OUTPUT_NOT_JSON = "OUTPUT_NOT_JSON";
 /** 根运行并发子任务数达到上限 */
 export const ACTION_SUBRUN_LIMIT = "ACTION_SUBRUN_LIMIT";
-/** 子任务数达限错误的别名标记（details.alias 专用，非独立错误码） */
-export const MAX_SUBRUNS_REACHED = "MAX_SUBRUNS_REACHED";
 /** Action 调用链出现环路 */
 export const ACTION_CALL_CYCLE = "ACTION_CALL_CYCLE";
-/** 调用链环路检测的别名标记（details.alias 专用，非独立错误码） */
-export const ACTION_CYCLE_DETECTED = "ACTION_CYCLE_DETECTED";
-/** 调用链深度超限的别名标记（details.alias 专用，非独立错误码） */
-export const ACTION_MAX_DEPTH_EXCEEDED = "ACTION_MAX_DEPTH_EXCEEDED";
 /** 跨包调用未在 uses 中声明依赖 */
 export const UNDECLARED_ACTION_DEPENDENCY = "UNDECLARED_ACTION_DEPENDENCY";
 /** Action 引用存在多包歧义 */
@@ -53,14 +47,22 @@ export const RUN_REPOSITORY_UNAVAILABLE = "RUN_REPOSITORY_UNAVAILABLE";
 export const RUN_PERSISTENCE_FAILED = "RUN_PERSISTENCE_FAILED";
 /** 独立单执行二进制拒绝异步启动语义 */
 export const STANDALONE_ASYNC_UNSUPPORTED = "STANDALONE_ASYNC_UNSUPPORTED";
+/** 独立运行模式不支持级联调用 */
+export const INVOCATION_UNSUPPORTED = "INVOCATION_UNSUPPORTED";
 /** 宿主子进程已退出，调用无法送达 */
 export const HOST_PROCESS_EXITED = "HOST_PROCESS_EXITED";
 /** 调用在启动前已被取消 */
 export const EXECUTION_ABORTED = "EXECUTION_ABORTED";
 /** 远程运行等待超时 */
 export const TIMEOUT = "TIMEOUT";
+/** 服务已关闭拒绝继续调用 */
+export const SERVICE_CLOSED = "SERVICE_CLOSED";
 /** 远程服务器网络连接失败 */
 export const NETWORK_ERROR = "NETWORK_ERROR";
+/** 非本地明文 HTTP 传输违规 */
+export const INSECURE_TRANSPORT = "INSECURE_TRANSPORT";
+/** 远程 HTTP 请求失败 */
+export const REMOTE_REQUEST_FAILED = "REMOTE_REQUEST_FAILED";
 /** 远程事件流全部候选路由均不可用 */
 export const REMOTE_STREAM_UNAVAILABLE = "REMOTE_STREAM_UNAVAILABLE";
 /** 远程目标未启用管理接口能力 */
@@ -92,6 +94,70 @@ export const UNAUTHORIZED = "UNAUTHORIZED";
 export const NOT_FOUND = "NOT_FOUND";
 /** HTTP 服务内部错误 */
 export const SERVER_ERROR = "SERVER_ERROR";
+/** HTTP 服务请求非法 */
+export const BAD_REQUEST = "BAD_REQUEST";
+/** 目标包未列入允许白名单（403 禁止访问） */
+export const PACKAGE_FORBIDDEN = "PACKAGE_FORBIDDEN";
+/** 目标规程未找到 */
+export const PLAYBOOK_NOT_FOUND = "PLAYBOOK_NOT_FOUND";
+/** 请求体体积超出安全限制 */
+export const REQUEST_TOO_LARGE = "REQUEST_TOO_LARGE";
+/** 动作异步启动失败 */
+export const ACTION_START_FAILED = "ACTION_START_FAILED";
+/** 动作执行发生内部错误 */
+export const ACTION_EXECUTION_ERROR = "ACTION_EXECUTION_ERROR";
+/** 动作列表检索失败 */
+export const ACTIONS_LIST_ERROR = "ACTIONS_LIST_ERROR";
+/** 规程列表检索失败 */
+export const PLAYBOOKS_LIST_ERROR = "PLAYBOOKS_LIST_ERROR";
+/** 运行记录列表检索失败 */
+export const RUNS_LIST_ERROR = "RUNS_LIST_ERROR";
+/** 运行记录清空操作失败 */
+export const RUNS_CLEAR_ERROR = "RUNS_CLEAR_ERROR";
+/** 服务大纲信息自省失败 */
+export const INFO_ERROR = "INFO_ERROR";
+/** 包信息检索失败 */
+export const PACKAGES_INFO_ERROR = "PACKAGES_INFO_ERROR";
+/** 环境诊断体检执行失败 */
+export const DOCTOR_ERROR = "DOCTOR_ERROR";
+/** 运行由于服务中断或异常退出被置为中断态 */
+export const RUN_INTERRUPTED = "RUN_INTERRUPTED";
+/** 配置项环境变量生成失败 */
+export const CONFIG_ENV_ERROR = "CONFIG_ENV_ERROR";
+/** 配置项列表检索失败 */
+export const CONFIG_LIST_ERROR = "CONFIG_LIST_ERROR";
+/** 配置项写入失败 */
+export const CONFIG_SET_ERROR = "CONFIG_SET_ERROR";
+/** 配置项删除失败 */
+export const CONFIG_DELETE_ERROR = "CONFIG_DELETE_ERROR";
+/** 状态条目列表检索失败 */
+export const STATE_LIST_ERROR = "STATE_LIST_ERROR";
+/** 状态清空操作失败 */
+export const STATE_CLEAR_ERROR = "STATE_CLEAR_ERROR";
+/** 状态键操作异常 */
+export const STATE_KEY_ERROR = "STATE_KEY_ERROR";
+/** 数据目录已被其他活跃会话持有 */
+export const DATA_DIR_IN_USE = "DATA_DIR_IN_USE";
+/** 数据目录存在未完成的事务，需执行恢复 */
+export const DATA_DIR_RECOVERY_REQUIRED = "DATA_DIR_RECOVERY_REQUIRED";
+/** 存储底层 Schema 版本不受支持 */
+export const UNSUPPORTED_STORAGE_SCHEMA = "UNSUPPORTED_STORAGE_SCHEMA";
+/** 持久化运行错误对象反序列化解码失败 */
+export const STORED_ERROR_DECODE_FAILED = "STORED_ERROR_DECODE_FAILED";
+/** 子进程执行失败终结 */
+export const PROCESS_FAILED = "PROCESS_FAILED";
+/** 生成的类型定义已过期 */
+export const GENERATED_TYPES_OUTDATED = "GENERATED_TYPES_OUTDATED";
+/** 通信协议版本或格式不受支持 */
+export const PROTOCOL_UNSUPPORTED = "PROTOCOL_UNSUPPORTED";
+/** 服务调用结果未知 */
+export const SERVICE_RESULT_UNKNOWN = "SERVICE_RESULT_UNKNOWN";
+/** MCP 工具命名发生冲突 */
+export const MCP_TOOL_NAME_COLLISION = "MCP_TOOL_NAME_COLLISION";
+/** 跨进程 IPC 通信或调用异常 */
+export const IPC_ERROR = "IPC_ERROR";
+/** 服务调用层内部异常回退错误码 */
+export const SERVICE_ERROR = "SERVICE_ERROR";
 /**
  * 判定错误消息根因是否为依赖模块缺失。
  * 兼容 Node.js 与打包器（Bun 等）两类加载器的报错文案。
@@ -173,17 +239,44 @@ export const INPUT_CONFLICT = "INPUT_CONFLICT";
 export const INPUT_FILE_NOT_FOUND = "INPUT_FILE_NOT_FOUND";
 /** 输入文件或流读取失败 */
 export const INPUT_FILE_READ_FAILED = "INPUT_FILE_READ_FAILED";
+/** 命令参数或选项非法 */
+export const INVALID_ARGUMENT = "INVALID_ARGUMENT";
+/** 目标包未列入白名单 */
+export const PACKAGE_NOT_ALLOWED = "PACKAGE_NOT_ALLOWED";
+/** 包标识符格式非法或包含越界字符 */
+export const INVALID_PACKAGE_ID = "INVALID_PACKAGE_ID";
+/** 路径越界违规访问 */
+export const PATH_TRAVERSAL = "PATH_TRAVERSAL";
+/** 状态键存在多命名空间歧义 */
+export const AMBIGUOUS_STATE_KEY = "AMBIGUOUS_STATE_KEY";
+/** 目标运行记录未找到 */
+export const RUN_NOT_FOUND = "RUN_NOT_FOUND";
+/** 目标运行已进入终态不可操作 */
+export const RUN_ALREADY_FINISHED = "RUN_ALREADY_FINISHED";
 /**
- * 进程领域结构化异常类。
+ * ActionDock 统一基础结构化异常类。
+ * 全仓各领域异常与跨层透传异常的统一事实源基类。
  */
-export class ProcessError extends Error {
+export class ActionDockError extends Error {
     code;
     details;
-    constructor(code, message, details) {
+    status;
+    constructor(code, message, details, status) {
         super(message);
-        this.name = "ProcessError";
+        this.name = "ActionDockError";
         this.code = code;
         this.details = details;
+        this.status = status;
+        Object.setPrototypeOf(this, ActionDockError.prototype);
+    }
+}
+/**
+ * 进程领域结构化异常类。
+ */
+export class ProcessError extends ActionDockError {
+    constructor(code, message, details) {
+        super(code, message, details);
+        this.name = "ProcessError";
         Object.setPrototypeOf(this, ProcessError.prototype);
     }
 }

package/dist/execution/service.d.ts

@@ -1,15 +1,19 @@
 import type { ActionDefinition, ActionRef, ExecutionEvent, ExecutionResult, JsonValue, RunRecord } from "@actiondock/sdk";
 import { type EventSink } from "../runtime/events.js";
-import { ActionRunner, type ExecutionHandle } from "../runtime/runner.js";
-import type { CancelResult, ExecuteOptions, ExecutionService, ExecutionServiceOptions, ExecutionTicket } from "./types.js";
+import { type ExecutionHandle } from "../runtime/runner.js";
+import { type PackageIdentity } from "../runtime/identity.js";
+import type { ActionInvoker, CancelResult, ExecutionService, ExecutionServiceOptions, ExecutionTicket, InvocationContext } from "./types.js";
 export type { ExecutionServiceOptions };
 /**
  * 统一执行协调服务实现。
  */
 export declare class DefaultExecutionService implements ExecutionService {
-    private packageId;
+    readonly identity: PackageIdentity;
+    readonly packageId: string;
     private storage;
     private projectConfig?;
+    private projectRoot?;
+    private moduleLoader?;
     readonly eventSink: EventSink;
     readonly packageInstanceId: string;
     readonly generationId: string;
@@ -20,16 +24,14 @@ export declare class DefaultExecutionService implements ExecutionService {
     private logger?;
     private clock?;
     private process?;
-    private platform?;
     private actionResolver?;
     private activeRuns;
-    private reservedSlots;
-    private isClosing;
-    private ownsStorage;
-    private ownsGlobalStorage;
     private globalStorage?;
+    private actionInvoker?;
+    private isClosing;
+    private reservedSlots;
     constructor(options: ExecutionServiceOptions);
-    get runner(): ActionRunner;
+    setActionInvoker(invoker?: ActionInvoker): void;
     registerAction(id: string, action: ActionDefinition): void;
     registerAction(action: ({
         id: string;
@@ -38,23 +40,23 @@ export declare class DefaultExecutionService implements ExecutionService {
     getAction(id: string): ActionDefinition | undefined;
     listActions(): ActionDefinition[];
     getActiveHandle(runId: string): ExecutionHandle | undefined;
-    setPackageContextResolver(resolver: any): void;
-    private resolveTargetAction;
-    execute(ref: ActionRef | string, input: JsonValue, options?: ExecuteOptions): Promise<ExecutionResult>;
+    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, options?: ExecuteOptions): Promise<ExecutionTicket>;
+    start(ref: ActionRef | string, input: JsonValue, context: InvocationContext): Promise<ExecutionTicket>;
     /**
      * 幂等门检查：digest 计算与冲突/重复分流（重复命中时直接返回已有票据）。
      */
     private checkIdempotencyGate;
     /**
-     * 解析执行目标：确定目标 Runner 并解析目标 Action 定义。
+     * 解析执行目标：确定目标 Action 定义。
+     * 铁律 4：Runner 不找 Package，ExecutionService 仅执行本 Package 的 Action。
      */
     private resolveExecutionTarget;
     /**
-     * 注册解析成功的目标 Action 至目标 Runner（收敛为单一注册入口）。
+     * 解析指定 Action 定义（供 PackageRuntime 或内部使用）。
      */
-    private registerResolvedAction;
+    resolveAction(ref: ActionRef | string): Promise<ActionDefinition | undefined>;
     /**
      * 目标 Action 缺失时的失败票据：落库 failed 记录并补发 status 与 finish 事件。
      */