@actiondock/core 2.10.0 → 2.11.0

package/dist/host/routing.js

@@ -1,7 +1,7 @@
 import { existsSync } from "node:fs";
 import { DefaultActionCatalog, DefaultPackageGraph, parseActionRef, resolveAction, resolvePlaybook, } from "../catalog/index.js";
 import { InvocationPolicy } from "../invocation/policy.js";
-import { ActionDockError, PACKAGE_NOT_FOUND } from "../errors.js";
+import { ActionDockError, PACKAGE_NOT_FOUND, UNDECLARED_ACTION_DEPENDENCY } from "../errors.js";
 /**
  * 宽松解析引用：优先结构化解析，失败时按对象或裸短标识符回退。
  * 委派纯领域解析 parseActionRef 单一事实源。
@@ -92,12 +92,12 @@ export async function describeVisiblePlaybook(runtimes, id, visibility) {
     if (!isPublic && visibility.graph) {
         const rootNode = visibility.graph.root ? visibility.graph.getNode(visibility.graph.root.id) : undefined;
         if (!rootNode?.directDependencies.has(resolved.packageId)) {
-            throw new Error(`UNDECLARED_ACTION_DEPENDENCY: Playbook '${id}' belongs to undeclared transitive package '${resolved.packageId}'`);
+            throw new ActionDockError(UNDECLARED_ACTION_DEPENDENCY, `UNDECLARED_ACTION_DEPENDENCY: Playbook '${id}' belongs to undeclared transitive package '${resolved.packageId}'`);
         }
     }
     const runtime = runtimes.find((a) => a.packageId === resolved.packageId);
     if (!runtime) {
-        throw new Error(`Package '${resolved.packageId}' not found in host`);
+        throw new ActionDockError(PACKAGE_NOT_FOUND, `Package '${resolved.packageId}' not found in host`);
     }
     return runtime.describePlaybook(resolved.playbookId);
 }
@@ -123,7 +123,7 @@ export function buildRuntimeError(code, message, details) {
 export async function describeActionAcrossRuntimes(ref, runtimes, visibility, failedLinkedPackages, catalog, graph) {
     const parsed = parseRefLoose(ref);
     if (parsed.packageId && failedLinkedPackages.has(parsed.packageId)) {
-        throw new Error(packageNotFoundMessage(parsed.packageId, failedLinkedPackages));
+        throw new ActionDockError(PACKAGE_NOT_FOUND, packageNotFoundMessage(parsed.packageId, failedLinkedPackages));
     }
     const effectiveGraph = graph || visibility.graph || buildFallbackGraph(runtimes);
     const effectiveCatalog = catalog ||
@@ -145,11 +145,11 @@ export async function describeActionAcrossRuntimes(ref, runtimes, visibility, fa
         throw err;
     }
     if (!isRootCallVisible(resolved.package.id, resolved.ref.actionId, visibility.hostPublicPackageIds, effectiveGraph)) {
-        throw new Error(`UNDECLARED_ACTION_DEPENDENCY: Action '${resolved.package.id}/${resolved.ref.actionId}' is not declared as a direct dependency in actiondock.json and is not delegated by a visible playbook`);
+        throw new ActionDockError(UNDECLARED_ACTION_DEPENDENCY, `UNDECLARED_ACTION_DEPENDENCY: Action '${resolved.package.id}/${resolved.ref.actionId}' is not declared as a direct dependency in actiondock.json and is not delegated by a visible playbook`);
     }
     const runtime = runtimes.find((a) => a.packageId === resolved.package.id);
     if (!runtime) {
-        throw new Error(packageNotFoundMessage(resolved.package.id, failedLinkedPackages));
+        throw new ActionDockError(PACKAGE_NOT_FOUND, packageNotFoundMessage(resolved.package.id, failedLinkedPackages));
     }
     const spec = await runtime.describeAction(resolved.ref.actionId);
     return {

package/dist/host/types.d.ts

@@ -2,11 +2,21 @@ import type { ActionRef, ExecutionEvent, ExecutionResult, JsonValue, Logger, Pro
 import type { PackageInfo, PackageRuntime, PackageRuntimeOptions, ActionSpec, ActionSummary, ListActionsOptions, PlaybookSpec, PlaybookSummary } from "../package/types.js";
 import type { CancelResult, ExecutionTicket } from "../execution/types.js";
 import type { RunOptions } from "../invocation/types.js";
-import type { Clock } from "../runtime/clock.js";
+import type { Clock } from "../storage/clock.js";
 import type { EventSink } from "../runtime/events.js";
 import type { RuntimePlatform } from "../platform/types.js";
-import type { ConfigValueView, ListRunsOptions, StateScopeOptions } from "../service/types.js";
+import type { ActionDockService, ConfigValueView, EventsPort, ListRunsOptions, StateScopeOptions } from "../service/types.js";
 import type { StateEntry } from "../storage/types.js";
+/**
+ * 宿主事件服务端口（既作为独立方法调用，又满足 EventsPort 规范）。
+ */
+export interface HostEventsPort extends EventsPort {
+    (runId: string, options?: {
+        after?: number | string;
+        signal?: AbortSignal;
+        maxQueueSize?: number;
+    }): AsyncIterable<ExecutionEvent>;
+}
 /**
  * ActionDock 宿主容器初始化配置选项。
  */
@@ -45,14 +55,19 @@ export interface ActionDockHostOptions {
     inMemory?: boolean;
     /** 事件接收器 */
     eventSink?: EventSink;
+    /** 是否开启配置与状态管理端口（默认 true） */
+    enableManagement?: boolean;
 }
 /**
  * ActionDock 多包宿主容器领域契约。
  * 作为多包环境下的全局协调中枢，负责多包生命周期、完全限定引用路由、依赖校验与配额管理。
+ * 同时作为本地默认 ActionDockService 实现，直接挂载 discovery/execution/runs/management 服务端口。
  */
-export interface ActionDockHost {
+export interface ActionDockHost extends ActionDockService {
     /** 宿主容器初始化配置项（只读） */
     readonly options?: ActionDockHostOptions;
+    /** 统一事件订阅端口（兼作原生订阅函数与事件服务端口） */
+    readonly events: HostEventsPort;
     /** 获取所有已注册包的元数据信息列表 */
     info(): Promise<PackageInfo[]>;
     /** 静态列出所有已注册包中可用的 Action 摘要 */
@@ -71,9 +86,11 @@ export interface ActionDockHost {
     /** 异步启动指定 Action 并立即返回任务执行票据 */
     startAction(ref: ActionRef | string, input: JsonValue, options?: RunOptions): Promise<ExecutionTicket>;
     /** 查询指定运行标识的记录详情 */
-    getRun(runId: string): Promise<RunRecord | undefined>;
+    getRun(runId: string, signal?: AbortSignal): Promise<RunRecord | undefined>;
     /** 列出运行记录 */
-    listRuns(query?: ListRunsOptions): Promise<RunRecord[]>;
+    listRuns(query?: ListRunsOptions, signal?: AbortSignal): Promise<RunRecord[]>;
+    /** 统计符合条件的运行记录总数 */
+    countRuns(query?: ListRunsOptions, signal?: AbortSignal): Promise<number>;
     /** 清理运行记录 */
     clearRuns(options?: {
         packageId?: string;
@@ -86,12 +103,6 @@ export interface ActionDockHost {
     cleanExpiredRuns(policy?: import("../storage/types.js").RunsRetentionPolicy): Promise<number>;
     /** 取消指定在运行的任务 */
     cancelRun(runId: string, reason?: string): Promise<CancelResult>;
-    /** 订阅指定运行的事件流 */
-    events(runId: string, options?: {
-        after?: number | string;
-        signal?: AbortSignal;
-        maxQueueSize?: number;
-    }): AsyncIterable<ExecutionEvent>;
     /** 获取配置项视图 */
     getConfig(packageId: string, key: string): Promise<ConfigValueView>;
     /** 设置配置项 */
@@ -107,9 +118,9 @@ export interface ActionDockHost {
     /** 删除状态项 */
     deleteState(packageId: string, actionId: string, key: string, options?: StateScopeOptions): Promise<boolean>;
     /** 列出状态项键名 */
-    listStateKeys(packageId: string, actionId: string, options?: StateScopeOptions): Promise<string[]>;
+    listStateKeys(packageId: string, actionId?: string, options?: StateScopeOptions): Promise<string[]>;
     /** 清理状态项 */
-    clearState(packageId: string, actionId: string, options?: StateScopeOptions): Promise<number>;
+    clearState(packageId: string, actionId?: string, options?: StateScopeOptions): Promise<number>;
     /** 列出状态项明细 */
     listStateEntries(packageId: string, options?: any): Promise<StateEntry[]>;
     /** 根据包唯一标识获取指定 Runtime 实例 */
@@ -120,6 +131,7 @@ export interface ActionDockHost {
     registerRuntime(runtime: PackageRuntime): void;
     /** 优雅关闭宿主容器。统一完整关闭所管理的所有 Runtime 实例并安全释放底层资源。 */
     close(options?: {
+        timeoutMs?: number;
         graceMs?: number;
     }): Promise<void>;
 }

package/dist/index.d.ts

@@ -5,19 +5,24 @@
  * 平台大对象驱动与解析器工具移至特定子路径导出（./server, ./project, ./registry,
  * ./profile, ./graph, ./package），严格杜绝在根导出泄露内部执行与平台上下文机制。
  */
+export { suppressExperimentalWarnings } from "./utils/warning.js";
 export { ACTIONDOCK_VERSION } from "./version.js";
 export { createActionDock, connectActionDock, } from "./service/factory.js";
-export type { ActionDockService, ActionDockService as ActionDock, DiscoveryPort, ExecutionPort, RunsPort, EventsPort, RunEventSubscriptionOptions, ConfigPort, StatePort, CreateActionDockOptions, ConnectActionDockOptions, RemoteServiceOptions, ConfigValueView, ListRunsOptions, StateScopeOptions, } from "./service/types.js";
-export { DEFAULT_RUNS_RETENTION_MS, DEFAULT_MAX_RUNS_PER_PACKAGE, DEFAULT_MIN_RETAIN_RUNS, type RunsRetentionPolicy, } from "./storage/types.js";
+export type { ActionDockService, ActionDockService as ActionDock, DiscoveryPort, ExecutionPort, RunsPort, EventsPort, RunEventSubscriptionOptions, ConfigPort, StatePort, CreateActionDockOptions, ConnectActionDockOptions, RemoteServiceOptions, ConfigValueView, ListRunsOptions, RunReadOptions, StateScopeOptions, } from "./service/types.js";
+export { isTerminalRunStatus, DEFAULT_RUNS_RETENTION_MS, DEFAULT_MAX_RUNS_PER_PACKAGE, DEFAULT_MIN_RETAIN_RUNS, } from "./storage/types.js";
+export { isRunHostDead } from "./storage/run-liveness.js";
+export type { TerminalRunStatus } from "./storage/types.js";
 export { parseDuration } from "./utils/index.js";
+export { toSnakeUpperCase, resolveEnvValue } from "./runtime/env.js";
+export type { ResolvedEnv } from "./runtime/env.js";
 export type { ActionRef, ResolvedActionRef, ExecutionResult, RunRecord, ExecutionEvent, } from "@actiondock/sdk";
 export type { RunOptions, ExecutionTicket, CancelResult, } from "./execution/types.js";
 export type { ActionSpec, ActionSummary, PlaybookSpec, PlaybookSummary, PackageInfo, ListActionsOptions, } from "./package/types.js";
-export { createNodePlatform, type NodePlatformOptions, } from "./platform/node.js";
+export { createNodePlatform, } from "./platform/node.js";
 export { startActionDockServer, } from "./server/server.js";
 export type { ServerOptions, ServerOptions as ActionDockServerOptions, ActionDockServerInstance, } from "./server/types.js";
 export { initProject } from "./project/init.js";
 export { loadProjectConfig, findProjectRoot, } from "./project/loader.js";
 export type { ProjectConfig, } from "./project/types.js";
 export type { PackageGraph, } from "./catalog/graph.js";
-export { ActionDockError, ProcessError, type ErrorCode, type ActionDockErrorCode, PACKAGE_NOT_FOUND, ACTION_PACKAGE_VERSION_CONFLICT, ACTION_NOT_FOUND, ACTION_LOAD_FAILED, ACTION_FAILED, ACTION_TIMEOUT, ACTION_CANCELLED, INPUT_VALIDATION_FAILED, OUTPUT_VALIDATION_FAILED, INPUT_NOT_JSON, OUTPUT_NOT_JSON, ACTION_SUBRUN_LIMIT, ACTION_CALL_CYCLE, UNDECLARED_ACTION_DEPENDENCY, INVALID_ACTION_REF, IDEMPOTENCY_CONFLICT, EXECUTION_FAILED, UNHANDLED_EXECUTION_ERROR, RUN_REPOSITORY_UNAVAILABLE, RUN_PERSISTENCE_FAILED, STANDALONE_ASYNC_UNSUPPORTED, INVOCATION_UNSUPPORTED, HOST_PROCESS_EXITED, EXECUTION_ABORTED, TIMEOUT, NETWORK_ERROR, REMOTE_STREAM_UNAVAILABLE, CAPABILITY_UNAVAILABLE, STATE_KEY_NOT_FOUND, STORAGE_BUSY, PROJECT_BUSY, PROJECT_RECOVERY_REQUIRED, STORAGE_WORKER_EXITED, EVENT_BACKPRESSURE_LIMIT, EVENT_CURSOR_EXPIRED, PROCESS_OUTPUT_LIMIT, PROCESS_SPAWN_ERROR, PROCESS_CANCELLED, PROCESS_TIMEOUT, UNAUTHORIZED, NOT_FOUND, SERVER_ERROR, BAD_REQUEST, PACKAGE_FORBIDDEN, ACTION_FORBIDDEN, PLAYBOOK_NOT_FOUND, REQUEST_TOO_LARGE, ACTION_START_FAILED, ACTION_EXECUTION_ERROR, ACTIONS_LIST_ERROR, PLAYBOOKS_LIST_ERROR, RUNS_LIST_ERROR, RUNS_CLEAR_ERROR, INFO_ERROR, PACKAGES_INFO_ERROR, DOCTOR_ERROR, RUN_INTERRUPTED, CONFIG_ENV_ERROR, CONFIG_LIST_ERROR, CONFIG_SET_ERROR, CONFIG_DELETE_ERROR, STATE_LIST_ERROR, STATE_CLEAR_ERROR, STATE_KEY_ERROR, DATA_DIR_IN_USE, DATA_DIR_RECOVERY_REQUIRED, UNSUPPORTED_STORAGE_SCHEMA, STORED_ERROR_DECODE_FAILED, PROCESS_FAILED, GENERATED_TYPES_OUTDATED, PROTOCOL_UNSUPPORTED, SERVICE_RESULT_UNKNOWN, MCP_TOOL_NAME_COLLISION, ACCESS_DENIED, UNSUPPORTED_CAPABILITY, CONTROL_BUSY, CONTROL_EXPIRED, CONTROL_REVOKED, PROCESS_QUARANTINED, PROCESS_LOST, REQUEST_CONFLICT, INPUT_OUTCOME_UNKNOWN, OUTPUT_GAP, OUTPUT_UNAVAILABLE, INVALID_CURSOR, QUEUE_FULL, QUOTA_EXCEEDED, INPUT_CLOSED, INVALID_FLAT_ARGUMENT, INVALID_JSON, INVALID_JSON_LITERAL, INPUT_PATH_CONFLICT, FLAT_INPUT_LIMIT_EXCEEDED, INPUT_LIMIT_EXCEEDED, INPUT_POLICY_VIOLATION, INPUT_CONFLICT, INPUT_FILE_NOT_FOUND, INPUT_FILE_READ_FAILED, INVALID_ARGUMENT, PACKAGE_NOT_ALLOWED, INVALID_PACKAGE_ID, PATH_TRAVERSAL, AMBIGUOUS_STATE_KEY, RUN_NOT_FOUND, RUN_ALREADY_FINISHED, IPC_ERROR, describeActionLoadFailure, type ActionLoadFailureContext, createErrorEnvelope, type ErrorEnvelope, resolveExecutionHint, } from "./errors.js";
+export { ActionDockError, ProcessError, PACKAGE_NOT_FOUND, ACTION_PACKAGE_VERSION_CONFLICT, ACTION_NOT_FOUND, ACTION_LOAD_FAILED, ACTION_FAILED, ACTION_TIMEOUT, ACTION_CANCELLED, INPUT_VALIDATION_FAILED, OUTPUT_VALIDATION_FAILED, INPUT_NOT_JSON, OUTPUT_NOT_JSON, ACTION_SUBRUN_LIMIT, ACTION_CALL_CYCLE, UNDECLARED_ACTION_DEPENDENCY, INVALID_ACTION_REF, IDEMPOTENCY_CONFLICT, EXECUTION_FAILED, UNHANDLED_EXECUTION_ERROR, RUN_REPOSITORY_UNAVAILABLE, RUN_PERSISTENCE_FAILED, STANDALONE_ASYNC_UNSUPPORTED, HOST_PROCESS_EXITED, EXECUTION_ABORTED, TIMEOUT, NETWORK_ERROR, CAPABILITY_UNAVAILABLE, STATE_KEY_NOT_FOUND, STORAGE_BUSY, PROJECT_BUSY, PROJECT_RECOVERY_REQUIRED, EVENT_BACKPRESSURE_LIMIT, EVENT_CURSOR_EXPIRED, PROCESS_OUTPUT_LIMIT, PROCESS_SPAWN_ERROR, PROCESS_CANCELLED, PROCESS_TIMEOUT, UNAUTHORIZED, NOT_FOUND, SERVER_ERROR, PACKAGE_FORBIDDEN, ACTION_FORBIDDEN, PLAYBOOK_NOT_FOUND, REQUEST_TOO_LARGE, ACTION_START_FAILED, ACTION_EXECUTION_ERROR, DATA_DIR_IN_USE, DATA_DIR_RECOVERY_REQUIRED, PROCESS_FAILED, MCP_TOOL_NAME_COLLISION, ACCESS_DENIED, INVALID_FLAT_ARGUMENT, INVALID_JSON, INVALID_JSON_LITERAL, INPUT_PATH_CONFLICT, FLAT_INPUT_LIMIT_EXCEEDED, INPUT_LIMIT_EXCEEDED, INPUT_POLICY_VIOLATION, INPUT_CONFLICT, INPUT_FILE_NOT_FOUND, INPUT_FILE_READ_FAILED, INVALID_ARGUMENT, PACKAGE_NOT_ALLOWED, INVALID_PACKAGE_ID, PATH_TRAVERSAL, AMBIGUOUS_STATE_KEY, RUN_NOT_FOUND, RUN_ALREADY_FINISHED, PROJECT_ROOT_NOT_FOUND, describeActionLoadFailure, createErrorEnvelope, resolveExecutionHint, } from "./errors.js";

package/dist/index.js

@@ -5,12 +5,15 @@
  * 平台大对象驱动与解析器工具移至特定子路径导出（./server, ./project, ./registry,
  * ./profile, ./graph, ./package），严格杜绝在根导出泄露内部执行与平台上下文机制。
  */
+export { suppressExperimentalWarnings } from "./utils/warning.js";
 // 1. 核心版本号单一事实源
 export { ACTIONDOCK_VERSION } from "./version.js";
 // 2. 统一服务门面与聚合契约接口
 export { createActionDock, connectActionDock, } from "./service/factory.js";
-export { DEFAULT_RUNS_RETENTION_MS, DEFAULT_MAX_RUNS_PER_PACKAGE, DEFAULT_MIN_RETAIN_RUNS, } from "./storage/types.js";
+export { isTerminalRunStatus, DEFAULT_RUNS_RETENTION_MS, DEFAULT_MAX_RUNS_PER_PACKAGE, DEFAULT_MIN_RETAIN_RUNS, } from "./storage/types.js";
+export { isRunHostDead } from "./storage/run-liveness.js";
 export { parseDuration } from "./utils/index.js";
+export { toSnakeUpperCase, resolveEnvValue } from "./runtime/env.js";
 // 5. 原生平台装配与服务启动
 export { createNodePlatform, } from "./platform/node.js";
 export { startActionDockServer, } from "./server/server.js";
@@ -18,4 +21,4 @@ export { startActionDockServer, } from "./server/server.js";
 export { initProject } from "./project/init.js";
 export { loadProjectConfig, findProjectRoot, } from "./project/loader.js";
 // 8. 统一错误模型与核心标准错误码常量
-export { ActionDockError, ProcessError, PACKAGE_NOT_FOUND, ACTION_PACKAGE_VERSION_CONFLICT, ACTION_NOT_FOUND, ACTION_LOAD_FAILED, ACTION_FAILED, ACTION_TIMEOUT, ACTION_CANCELLED, INPUT_VALIDATION_FAILED, OUTPUT_VALIDATION_FAILED, INPUT_NOT_JSON, OUTPUT_NOT_JSON, ACTION_SUBRUN_LIMIT, ACTION_CALL_CYCLE, UNDECLARED_ACTION_DEPENDENCY, INVALID_ACTION_REF, IDEMPOTENCY_CONFLICT, EXECUTION_FAILED, UNHANDLED_EXECUTION_ERROR, RUN_REPOSITORY_UNAVAILABLE, RUN_PERSISTENCE_FAILED, STANDALONE_ASYNC_UNSUPPORTED, INVOCATION_UNSUPPORTED, HOST_PROCESS_EXITED, EXECUTION_ABORTED, TIMEOUT, NETWORK_ERROR, REMOTE_STREAM_UNAVAILABLE, CAPABILITY_UNAVAILABLE, STATE_KEY_NOT_FOUND, STORAGE_BUSY, PROJECT_BUSY, PROJECT_RECOVERY_REQUIRED, STORAGE_WORKER_EXITED, EVENT_BACKPRESSURE_LIMIT, EVENT_CURSOR_EXPIRED, PROCESS_OUTPUT_LIMIT, PROCESS_SPAWN_ERROR, PROCESS_CANCELLED, PROCESS_TIMEOUT, UNAUTHORIZED, NOT_FOUND, SERVER_ERROR, BAD_REQUEST, PACKAGE_FORBIDDEN, ACTION_FORBIDDEN, PLAYBOOK_NOT_FOUND, REQUEST_TOO_LARGE, ACTION_START_FAILED, ACTION_EXECUTION_ERROR, ACTIONS_LIST_ERROR, PLAYBOOKS_LIST_ERROR, RUNS_LIST_ERROR, RUNS_CLEAR_ERROR, INFO_ERROR, PACKAGES_INFO_ERROR, DOCTOR_ERROR, RUN_INTERRUPTED, CONFIG_ENV_ERROR, CONFIG_LIST_ERROR, CONFIG_SET_ERROR, CONFIG_DELETE_ERROR, STATE_LIST_ERROR, STATE_CLEAR_ERROR, STATE_KEY_ERROR, DATA_DIR_IN_USE, DATA_DIR_RECOVERY_REQUIRED, UNSUPPORTED_STORAGE_SCHEMA, STORED_ERROR_DECODE_FAILED, PROCESS_FAILED, GENERATED_TYPES_OUTDATED, PROTOCOL_UNSUPPORTED, SERVICE_RESULT_UNKNOWN, MCP_TOOL_NAME_COLLISION, ACCESS_DENIED, UNSUPPORTED_CAPABILITY, CONTROL_BUSY, CONTROL_EXPIRED, CONTROL_REVOKED, PROCESS_QUARANTINED, PROCESS_LOST, REQUEST_CONFLICT, INPUT_OUTCOME_UNKNOWN, OUTPUT_GAP, OUTPUT_UNAVAILABLE, INVALID_CURSOR, QUEUE_FULL, QUOTA_EXCEEDED, INPUT_CLOSED, INVALID_FLAT_ARGUMENT, INVALID_JSON, INVALID_JSON_LITERAL, INPUT_PATH_CONFLICT, FLAT_INPUT_LIMIT_EXCEEDED, INPUT_LIMIT_EXCEEDED, INPUT_POLICY_VIOLATION, INPUT_CONFLICT, INPUT_FILE_NOT_FOUND, INPUT_FILE_READ_FAILED, INVALID_ARGUMENT, PACKAGE_NOT_ALLOWED, INVALID_PACKAGE_ID, PATH_TRAVERSAL, AMBIGUOUS_STATE_KEY, RUN_NOT_FOUND, RUN_ALREADY_FINISHED, IPC_ERROR, describeActionLoadFailure, createErrorEnvelope, resolveExecutionHint, } from "./errors.js";
+export { ActionDockError, ProcessError, PACKAGE_NOT_FOUND, ACTION_PACKAGE_VERSION_CONFLICT, ACTION_NOT_FOUND, ACTION_LOAD_FAILED, ACTION_FAILED, ACTION_TIMEOUT, ACTION_CANCELLED, INPUT_VALIDATION_FAILED, OUTPUT_VALIDATION_FAILED, INPUT_NOT_JSON, OUTPUT_NOT_JSON, ACTION_SUBRUN_LIMIT, ACTION_CALL_CYCLE, UNDECLARED_ACTION_DEPENDENCY, INVALID_ACTION_REF, IDEMPOTENCY_CONFLICT, EXECUTION_FAILED, UNHANDLED_EXECUTION_ERROR, RUN_REPOSITORY_UNAVAILABLE, RUN_PERSISTENCE_FAILED, STANDALONE_ASYNC_UNSUPPORTED, HOST_PROCESS_EXITED, EXECUTION_ABORTED, TIMEOUT, NETWORK_ERROR, CAPABILITY_UNAVAILABLE, STATE_KEY_NOT_FOUND, STORAGE_BUSY, PROJECT_BUSY, PROJECT_RECOVERY_REQUIRED, EVENT_BACKPRESSURE_LIMIT, EVENT_CURSOR_EXPIRED, PROCESS_OUTPUT_LIMIT, PROCESS_SPAWN_ERROR, PROCESS_CANCELLED, PROCESS_TIMEOUT, UNAUTHORIZED, NOT_FOUND, SERVER_ERROR, PACKAGE_FORBIDDEN, ACTION_FORBIDDEN, PLAYBOOK_NOT_FOUND, REQUEST_TOO_LARGE, ACTION_START_FAILED, ACTION_EXECUTION_ERROR, DATA_DIR_IN_USE, DATA_DIR_RECOVERY_REQUIRED, PROCESS_FAILED, MCP_TOOL_NAME_COLLISION, ACCESS_DENIED, INVALID_FLAT_ARGUMENT, INVALID_JSON, INVALID_JSON_LITERAL, INPUT_PATH_CONFLICT, FLAT_INPUT_LIMIT_EXCEEDED, INPUT_LIMIT_EXCEEDED, INPUT_POLICY_VIOLATION, INPUT_CONFLICT, INPUT_FILE_NOT_FOUND, INPUT_FILE_READ_FAILED, INVALID_ARGUMENT, PACKAGE_NOT_ALLOWED, INVALID_PACKAGE_ID, PATH_TRAVERSAL, AMBIGUOUS_STATE_KEY, RUN_NOT_FOUND, RUN_ALREADY_FINISHED, PROJECT_ROOT_NOT_FOUND, describeActionLoadFailure, createErrorEnvelope, resolveExecutionHint, } from "./errors.js";

package/dist/input/advice.d.ts

@@ -58,47 +58,3 @@ export declare function buildCliInputAdviceV1(schema: unknown): CliInputAdviceV1
  * 禁止在本文件另建独立正则分叉。
  */
 export declare const FLAT_ENCODING_GUIDELINES: readonly string[];
-/**
- * 单个字段的输入建议明细。
- */
-export interface ActionInputFieldAdvice {
-    /** 字段路径（属性名） */
-    path: string;
-    /** 字段类型字符串 */
-    type: string;
-    /** 是否为必填字段 */
-    required: boolean;
-    /** 字段名是否满足扁平编码安全规范 */
-    flatSafe: boolean;
-    /** 编码模板（如 "name=TEXT"、"age:=NUMBER"、"meta:=JSON"），非直接可执行 token */
-    assignmentTemplate?: string;
-    /** 人类说明文字，如 "大型结构建议使用 --input-file" */
-    hint?: string;
-    /** 字段描述信息 */
-    description?: string;
-}
-/**
- * Action 输入模式整体编码顾问分析报告。
- */
-export interface ActionInputAdvice {
-    /** 根模式是否支持扁平入参赋值（仅当根模式为对象且所有 required 字段均具备 flatSafe 赋值方案时为 true） */
-    flatSupported: boolean;
-    /** 是否存在至少一个可扁平化的字段 */
-    hasFlatFields: boolean;
-    /** 字段明细清单 */
-    fields: ActionInputFieldAdvice[];
-    /** 所有必填字段的编码模板数组 */
-    requiredTemplates: string[];
-    /** 可选字段的编码模板数组 */
-    optionalTemplates: string[];
-    /** 结构化提示与降级说明清单 */
-    notes: string[];
-}
-/**
- * 依据 inputSchema 构造统一的 Action 输入编码建议。
- *
- * @param schema Action 的 inputSchema 定义
- * @returns 结构化编码建议报告
- */
-export declare function buildActionInputAdvice(schema: unknown): ActionInputAdvice;
-export { formatActionDetail } from "./describe.js";

package/dist/input/advice.js

@@ -1,4 +1,4 @@
-import { isFlatSafePropertyName, isFlatPathPropertyName, isForbiddenActionInputPropertyName, } from "./flat-predicates.js";
+import { isFlatPathPropertyName, isForbiddenActionInputPropertyName, } from "./flat-predicates.js";
 const RECOGNIZED_SCHEMA_TYPES = new Set([
     "object",
     "array",
@@ -440,12 +440,12 @@ export function buildCliInputAdviceV1(schema) {
                 array: {
                     encoding: "json-array",
                     assignmentTemplate: `${key}:=JSON`,
-                    hint: "建议使用 --input-file 或标准输入传递数组结构",
+                    hint: "Using --input-file or stdin is recommended for arrays",
                 },
                 object: {
                     encoding: "json-object",
                     assignmentTemplate: `${key}:=JSON`,
-                    hint: "大型结构建议使用 --input-file",
+                    hint: "Using --input-file is recommended for large structures",
                 },
             };
             const flatSafeEntry = flatSafeTypeTable[propType];
@@ -575,142 +575,8 @@ export function buildCliInputAdviceV1(schema) {
  * 禁止在本文件另建独立正则分叉。
  */
 export const FLAT_ENCODING_GUIDELINES = [
-    "字符串: path=TEXT",
-    "JSON 标量与结构: path:=JSON (例如 count:=1, enabled:=true)",
-    "数组元素: path.INDEX=... (例如 items.0=first)",
-    "提示: 复杂嵌套或大段文本建议使用 --input 或 --input-file",
+    "Strings: path=TEXT",
+    "JSON scalars and structures: path:=JSON (e.g. count:=1, enabled:=true)",
+    "Array elements: path.INDEX=... (e.g. items.0=first)",
+    "Tip: For complex nested data or long text, using --input or --input-file is recommended",
 ];
-/**
- * 构造无扁平能力、无字段明细的空结果建议报告（各降级早退分支共用单一事实源）。
- * 键序与既有契约保持一致，禁止调整。
- */
-function createEmptyFlatAdvice(notes) {
-    return {
-        flatSupported: false,
-        hasFlatFields: false,
-        fields: [],
-        requiredTemplates: [],
-        optionalTemplates: [],
-        notes,
-    };
-}
-/**
- * 依据 inputSchema 构造统一的 Action 输入编码建议。
- *
- * @param schema Action 的 inputSchema 定义
- * @returns 结构化编码建议报告
- */
-export function buildActionInputAdvice(schema) {
-    if (typeof schema === "boolean") {
-        if (schema === false) {
-            return createEmptyFlatAdvice(["布尔模式 false：拒绝所有输入，任何调用参数均判定为非法"]);
-        }
-        return createEmptyFlatAdvice([
-            "布尔模式 true：接受任意合法 JSON 输入；调用时无需指定必填参数，非对象根输入请使用 --input-file 或 --input",
-        ]);
-    }
-    if (!schema || typeof schema !== "object") {
-        return createEmptyFlatAdvice(["根模式未声明输入字段，直接调用或使用 --input-file / --input '{}'"]);
-    }
-    const s = schema;
-    // 校验根模式是否为 object 类型
-    if (s.type !== undefined && s.type !== "object") {
-        return createEmptyFlatAdvice([
-            `根模式类型为 '${s.type}'，不支持扁平赋值，建议使用 --input-file 或 --input`,
-        ]);
-    }
-    const properties = (s.properties || {});
-    const required = Array.isArray(s.required) ? s.required : [];
-    const propKeys = Object.keys(properties);
-    if (propKeys.length === 0) {
-        return createEmptyFlatAdvice(["根模式无声明属性，不支持扁平赋值，建议使用 --input-file 或 --input '{}'"]);
-    }
-    const fields = [];
-    const requiredTemplates = [];
-    const optionalTemplates = [];
-    const notes = [];
-    for (const key of propKeys) {
-        const prop = properties[key] || {};
-        const typeStr = prop.type ? String(prop.type) : "any";
-        const isReq = required.includes(key);
-        const isFlatSafe = isFlatSafePropertyName(key);
-        let assignmentTemplate;
-        let hint;
-        if (isFlatSafe) {
-            // 数组元素标量类型到扁平元素赋值模板的参数表（共用同一守卫与拼接规则）。
-            // 命中时模板形态为 `${key}.0<operator><占位符>`，未命中回退数组整体 JSON 模板。
-            const itemsTypeTemplates = {
-                string: `${key}.0=TEXT`,
-                number: `${key}.0:=NUMBER`,
-                integer: `${key}.0:=NUMBER`,
-                boolean: `${key}.0:=BOOLEAN`,
-            };
-            const itemsTemplate = prop.type === "array" && prop.items && typeof prop.items === "object"
-                ? itemsTypeTemplates[prop.items.type]
-                : undefined;
-            if (prop.type === "string") {
-                assignmentTemplate = `${key}=TEXT`;
-            }
-            else if (prop.type === "number" || prop.type === "integer") {
-                assignmentTemplate = `${key}:=NUMBER`;
-            }
-            else if (prop.type === "boolean") {
-                assignmentTemplate = `${key}:=BOOLEAN`;
-            }
-            else if (itemsTemplate) {
-                assignmentTemplate = itemsTemplate;
-            }
-            else if (prop.type === "array") {
-                assignmentTemplate = `${key}:=JSON`;
-                hint = "数组结构建议使用 --input-file";
-            }
-            else if (prop.type === "object") {
-                assignmentTemplate = `${key}:=JSON`;
-                hint = "大型结构建议使用 --input-file";
-            }
-            else {
-                assignmentTemplate = `${key}:=JSON`;
-                hint = "复杂或未知类型建议使用 --input-file";
-            }
-            if (isReq) {
-                if (assignmentTemplate) {
-                    requiredTemplates.push(assignmentTemplate);
-                }
-            }
-            else {
-                if (assignmentTemplate) {
-                    optionalTemplates.push(assignmentTemplate);
-                }
-            }
-        }
-        else {
-            hint = "包含非安全字符，建议使用 --input-file";
-            notes.push(`属性 '${key}' 包含非安全字符，不支持扁平赋值，建议使用 --input-file`);
-        }
-        fields.push({
-            path: key,
-            type: typeStr,
-            required: isReq,
-            flatSafe: isFlatSafe,
-            assignmentTemplate,
-            hint,
-            description: prop.description,
-        });
-    }
-    const hasFlatFields = fields.some((f) => f.flatSafe && f.assignmentTemplate !== undefined);
-    // 仅当根模式为对象且所有 required 字段均具备 flatSafe 赋值方案时为 true
-    const allRequiredFlatSafe = required.every((reqKey) => {
-        const f = fields.find((field) => field.path === reqKey);
-        return f !== undefined && f.flatSafe && f.assignmentTemplate !== undefined;
-    });
-    const flatSupported = hasFlatFields && allRequiredFlatSafe;
-    return {
-        flatSupported,
-        hasFlatFields,
-        fields,
-        requiredTemplates,
-        optionalTemplates,
-        notes,
-    };
-}
-export { formatActionDetail } from "./describe.js";

package/dist/input/flat-materializer.js

@@ -1,7 +1,7 @@
 import { inputPathConflict, flatInputLimitExceeded, invalidFlatArgument, } from "./flat-errors.js";
 import { isForbiddenActionInputPropertyName } from "./flat-predicates.js";
 import { DEFAULT_MAX_MATERIALIZED_SIZE_BYTES } from "./flat-parser.js";
-import { validateJsonValue } from "../json/value-validator.js";
+import { validateJsonValue } from "../value-validator.js";
 /**
  * 节点状态枚举（四态节点模型）。
  */

package/dist/input/flat-parser.js

@@ -1,6 +1,6 @@
 import { invalidFlatArgument, invalidJsonLiteral, flatInputLimitExceeded, } from "./flat-errors.js";
 import { isFlatPathPropertyName, isForbiddenActionInputPropertyName, } from "./flat-predicates.js";
-import { validateJsonValue } from "../json/value-validator.js";
+import { validateJsonValue } from "../value-validator.js";
 /** 最大赋值表达式总数 */
 export const DEFAULT_MAX_ASSIGNMENTS = 1000;
 /** 最大路径段深度 */

package/dist/input/index.d.ts

@@ -10,5 +10,4 @@ export * from "./file-input.js";
 export * from "./stdin-input.js";
 export * from "./input-resolver.js";
 export * from "./advice.js";
-export * from "./metadata.js";
 export * from "./describe.js";

package/dist/input/index.js

@@ -10,5 +10,4 @@ export * from "./file-input.js";
 export * from "./stdin-input.js";
 export * from "./input-resolver.js";
 export * from "./advice.js";
-export * from "./metadata.js";
 export * from "./describe.js";

package/dist/input/input-resolver.js

@@ -1,6 +1,6 @@
 import { inputConflict, inputLimitExceeded, invalidJson, InputError, FlatInputError, } from "./flat-errors.js";
 import { decodeFlatInput } from "./flat-decode.js";
-import { validateJsonValue, DEFAULT_MAX_JSON_DEPTH, } from "../json/value-validator.js";
+import { validateJsonValue, DEFAULT_MAX_JSON_DEPTH, } from "../value-validator.js";
 import { scanJsonDepth } from "./json-depth-scanner.js";
 import { decodeUtf8Strict, stripBom } from "./utf8.js";
 import { readRegularFileBounded, DEFAULT_MAX_INPUT_BYTES, } from "./file-input.js";

package/dist/input/validation-mapper.d.ts

@@ -1,5 +1,5 @@
 import { InputError, type InputValidationSource } from "./flat-errors.js";
-import type { ActionInputValidationResult, JsonValueValidationResult } from "../json/value-validator.js";
+import type { ActionInputValidationResult, JsonValueValidationResult } from "../value-validator.js";
 /**
  * 校验失败结构化输入描述。
  */

package/dist/ipc/diagnostic.d.ts

@@ -1,39 +1,26 @@
 import type { Readable, Writable } from "node:stream";
 /**
- * 诊断日志限流排空转发器配置选项。
+ * 诊断日志转发器配置选项。
  */
 export interface DiagnosticForwarderOptions {
-    /** 允许转发的累计最大字节数（默认 512 KB） */
-    maxBytes?: number;
-    /** 每秒允许转发的最大字节速率（默认 64 KB/秒） */
-    maxRateBytesPerSec?: number;
     /** 目标输出流（默认 process.stderr） */
     target?: Writable;
     /** 诊断流标识前缀 */
     prefix?: string;
-    /** 触发超限截断时的回调通知 */
-    onTruncated?: (reason: "size_limit" | "rate_limit") => void;
+    /** 写入错误处理回调 */
+    onError?: (err: Error) => void;
 }
 /**
- * 诊断流受控转发与限流排空器（DiagnosticForwarder）。
+ * 诊断流极简转发器（DiagnosticForwarder）。
  *
- * 职责：
- * 1. 独占捕获子进程的标准输出与标准错误流，杜绝第三方代码污染父进程标准协议通道。
- * 2. 实时监测字节总量与秒级传输速率上限。
- * 3. 达到阈值后立即停止对外转发、向诊断通道记录截断事件。
- * 4. 持续以非阻塞方式静默排空后续数据流，避免子进程因管道背压堆积死锁。
+ * 将子进程输出流（stdout/stderr）的数据转发至目标流。
+ * 严禁静默丢数据，遇到写入异常即时透传。
  */
 export declare class DiagnosticForwarder {
-    private readonly maxBytes;
-    private readonly maxRateBytesPerSec;
     private readonly target;
     private readonly prefix;
-    private readonly onTruncated?;
-    private totalBytesEmitted;
-    private windowStartMs;
-    private bytesInCurrentWindow;
-    private truncated;
-    private attachedStreams;
+    private readonly onError?;
+    private readonly attachedStreams;
     constructor(options?: DiagnosticForwarderOptions);
     /**
      * 绑定并监听可读流（如 childProcess.stdout 或 childProcess.stderr）。

package/dist/ipc/diagnostic.js

@@ -1,29 +1,18 @@
 /**
- * 诊断流受控转发与限流排空器（DiagnosticForwarder）。
+ * 诊断流极简转发器（DiagnosticForwarder）。
  *
- * 职责：
- * 1. 独占捕获子进程的标准输出与标准错误流，杜绝第三方代码污染父进程标准协议通道。
- * 2. 实时监测字节总量与秒级传输速率上限。
- * 3. 达到阈值后立即停止对外转发、向诊断通道记录截断事件。
- * 4. 持续以非阻塞方式静默排空后续数据流，避免子进程因管道背压堆积死锁。
+ * 将子进程输出流（stdout/stderr）的数据转发至目标流。
+ * 严禁静默丢数据，遇到写入异常即时透传。
  */
 export class DiagnosticForwarder {
-    maxBytes;
-    maxRateBytesPerSec;
     target;
     prefix;
-    onTruncated;
-    totalBytesEmitted = 0;
-    windowStartMs = Date.now();
-    bytesInCurrentWindow = 0;
-    truncated = false;
+    onError;
     attachedStreams = new Map();
     constructor(options = {}) {
-        this.maxBytes = options.maxBytes ?? 512 * 1024;
-        this.maxRateBytesPerSec = options.maxRateBytesPerSec ?? 64 * 1024;
         this.target = options.target ?? process.stderr;
         this.prefix = options.prefix ?? "";
-        this.onTruncated = options.onTruncated;
+        this.onError = options.onError;
     }
     /**
      * 绑定并监听可读流（如 childProcess.stdout 或 childProcess.stderr）。
@@ -36,52 +25,30 @@ export class DiagnosticForwarder {
             return;
         const handler = (chunk) => {
             const buf = typeof chunk === "string" ? Buffer.from(chunk, "utf-8") : chunk;
-            const len = buf.length;
-            // 刷新秒级速率统计窗口
-            const now = Date.now();
-            if (now - this.windowStartMs >= 1000) {
-                this.windowStartMs = now;
-                this.bytesInCurrentWindow = 0;
-            }
-            if (this.truncated) {
-                // 已截断：仅排空丢弃数据，不转发，保持流处于读取排空状态
-                return;
-            }
-            // 检查容量与速率上限
-            let exceedReason = null;
-            if (this.totalBytesEmitted + len > this.maxBytes) {
-                exceedReason = "size_limit";
-            }
-            else if (this.bytesInCurrentWindow + len > this.maxRateBytesPerSec) {
-                exceedReason = "rate_limit";
-            }
-            if (exceedReason) {
-                this.truncated = true;
-                const tag = label ? `[${label}] ` : "";
-                const notice = `\n[Supervisor] ${tag}Diagnostic output exceeded ${exceedReason === "size_limit" ? `size limit (${this.maxBytes} bytes)` : `rate limit (${this.maxRateBytesPerSec} B/s)`}. Forwarding suspended; draining stream.\n`;
-                try {
-                    this.target.write(notice);
-                }
-                catch {
-                    // 忽略写入失败
-                }
-                this.onTruncated?.(exceedReason);
-                return;
-            }
-            // 正常转发
-            this.totalBytesEmitted += len;
-            this.bytesInCurrentWindow += len;
+            const effectivePrefix = this.prefix || (label ? `[${label}] ` : "");
+            const data = effectivePrefix
+                ? Buffer.concat([Buffer.from(effectivePrefix, "utf-8"), buf])
+                : buf;
             try {
-                if (this.prefix) {
-                    this.target.write(`${this.prefix}${buf.toString("utf-8")}`);
+                this.target.write(data, (err) => {
+                    if (err) {
+                        if (this.onError) {
+                            this.onError(err);
+                        }
+                        else {
+                            this.target.emit("error", err);
+                        }
+                    }
+                });
+            }
+            catch (err) {
+                if (this.onError) {
+                    this.onError(err);
                 }
                 else {
-                    this.target.write(buf);
+                    this.target.emit("error", err);
                 }
             }
-            catch {
-                // 忽略目标写入异常
-            }
         };
         stream.on("data", handler);
         this.attachedStreams.set(stream, handler);