@zhushanwen/subagent-engine-sdk 0.6.1 → 0.7.1

package/dist/error-codes-CFTOAxva.d.cts

@@ -1,118 +0,0 @@
-import { b as AgentEvent, E as EngineCapabilities } from './contract-types-DaULkdpG.cjs';
-
-/** 协议错误对象（error 帧载荷与反向请求错误应答共用形态）。 */
-interface ProtocolError {
-    /** 错误码（error-codes.ts 词表 + 其余 engine_* 引擎自报透传）。 */
-    code: string;
-    /** 人类可读详情。 */
-    message: string;
-    /** 恢复指引：指向具体下一步（命令 / 配置路径 / 升级动作），非安慰性文案。 */
-    recovery: string;
-    /** 结构化附参（如 engine_protocol_mismatch 的双方版本）。 */
-    data?: Record<string, unknown>;
-}
-interface RequestFrame {
-    id: number;
-    method: string;
-    params: unknown;
-}
-interface SuccessResponseFrame {
-    id: number | string;
-    result: unknown;
-}
-interface ErrorResponseFrame {
-    id: number | string;
-    error: ProtocolError;
-}
-type ResponseFrame = SuccessResponseFrame | ErrorResponseFrame;
-/** event 通知载荷：runId 关联在途 run；seq 单调递增（基线①结构等价断言对象）。 */
-interface EventNotificationParams {
-    runId: string;
-    seq: number;
-    event: AgentEvent;
-}
-interface NotificationFrame {
-    method: "event";
-    params: EventNotificationParams;
-}
-interface ReverseRequestFrame {
-    id: string;
-    method: string;
-    params: unknown;
-}
-/** 反向请求的应答（core → 引擎，沿 ResponseFrame 通道回传；id = 反向请求 id 原样）。 */
-type ReverseResponseResult = 
-/** 数据面类：处理确认。 */
-{
-    ok: true;
-}
-/** 人机交互类（askUser）两阶段第一阶段：已受理，结果异步到达（R9-2）。 */
- | {
-    ack: true;
-}
-/** 未实现或宿主未知的通道（宽容语义③：由 askUser 语境泛化到全通道——宿主对未知 host/* 通道回 unsupported，引擎自行降级）。 */
- | {
-    unsupported: true;
-};
-/** ① 请求：有数字 id + method + params，且无 result/error（与②应答区分）。 */
-declare function isRequestFrame(frame: unknown): frame is RequestFrame;
-/** ② 应答：有 id（number|string）且 result/error 二选一。 */
-declare function isResponseFrame(frame: unknown): frame is ResponseFrame;
-/** ③ 通知：无 id，method === "event"，params 含 runId/seq/event。 */
-declare function isNotificationFrame(frame: unknown): frame is NotificationFrame;
-/** ④ 反向请求：有字符串 id + host/* method + params（与①的区别 = id 形态与 method 前缀）。 */
-declare function isReverseRequestFrame(frame: unknown): frame is ReverseRequestFrame;
-
-/** 协议核心错误码（引擎 error 帧 + core 同步拦截共用的固定词表）。 */
-declare const ENGINE_PROTOCOL_ERROR_CODES: readonly ["engine_not_found", "engine_protocol_mismatch", "engine_capability_unsupported", "engine_capability_mismatch", "engine_model_unknown", "engine_model_mismatch", "engine_handshake_timeout", "engine_crashed", "engine_probe_failed"];
-type EngineProtocolErrorCode = (typeof ENGINE_PROTOCOL_ERROR_CODES)[number];
-/** unknown → 协议错误码收窄（外部输入携带错误码时的运行时 guard；其余 engine_* 走透传）。 */
-declare function isEngineProtocolErrorCode(value: unknown): value is EngineProtocolErrorCode;
-/** 其余引擎自报错误码的前缀契约（透传面；core 不解释文案）。 */
-declare const ENGINE_ERROR_CODE_PREFIX = "engine_";
-declare function isEngineErrorPassthroughCode(value: string): boolean;
-
-/**
- * 结构化引擎错误（message 恒为 `<code>: <detail>` 前缀格式——AgentOutcome.error 与
- * 协议 error 帧共用的错误码前缀约定）；recovery 指向恢复动作。
- * toStructured() 产出即协议 ProtocolError 形态（error 帧载荷直用）。
- */
-declare class EngineSdkError extends Error {
-    readonly code: string;
-    readonly recovery: string;
-    readonly data?: Record<string, unknown>;
-    constructor(code: string, detail: string, recovery: string, data?: Record<string, unknown>);
-    /** 协议 error 帧载荷投影。 */
-    toStructured(): ProtocolError;
-}
-declare function engineProtocolMismatchError(engineVersion: number): EngineSdkError;
-/**
- * 引擎 conversation 位拒绝的具名错误（[modeless 波2] 语义：无 resume 续聊通道的
- * 引擎，message 续聊资格被拒——manifest conversation 能力轴消费；[modeless 波5
- * 收尾] core capability-gate 的显式参数分支随派发参数删除退役，本构造器消费方 =
- * 引擎侧 resume gate（assertChatConversationSupported）与 message 资格门）。
- * 文案契约：错误码 engine_capability_unsupported + 「换引擎续聊 / 修 manifest /
- * 升级引擎包」恢复指引，两侧一致防漂移。
- */
-declare function engineConversationUnsupportedError(engineId: string): EngineSdkError;
-/**
- * resume 会话形态（run.params.resume——唯一会话形态键）派发前的同步 gate：
- * manifest conversation 位 unsupported 即抛 engineConversationUnsupportedError
- * ——进程/record 创建前同步拒（A6 方向防御：manifest/实装漂移时引擎侧自拒，
- * 与 core capability-gate 同一能力位，防两侧判据漂移）。[modeless 波2] 协议
- * task 的 conversation 键已删，本 gate 只对 resume 形态键生效。
- */
-declare function assertChatConversationSupported(engineId: string, capabilities: Pick<EngineCapabilities, "conversation">): void;
-/** stdout 尾部回显上限（engine_timeout / engine_run_failed 的错误规格载体系数）。 */
-declare const STDOUT_TAIL_ECHO_CHARS = 2000;
-/** engine_timeout 的恢复指引（kill-chain 超时杀链收尾文案）。 */
-declare const ENGINE_TIMEOUT_RECOVERY: string;
-/**
- * engine_timeout 的 outcome.error 文案：含 stdout 尾部 2000 字 + 恢复指引
- * （kill-chain synthesizeTimeoutOutcome 消费；与 core errors.ts engineTimeoutDetail 逐字等价）。
- */
-declare function engineTimeoutDetail(stdoutTail: string): string;
-/** schema_emulation_failed 的终报文案（宿主编排层「重试一次仍失败」后消费）。 */
-declare function schemaEmulationFailedDetail(error: string, tail: string): string;
-
-export { ENGINE_ERROR_CODE_PREFIX as E, type NotificationFrame as N, type ProtocolError as P, type RequestFrame as R, STDOUT_TAIL_ECHO_CHARS as S, ENGINE_PROTOCOL_ERROR_CODES as a, ENGINE_TIMEOUT_RECOVERY as b, type EngineProtocolErrorCode as c, EngineSdkError as d, type ErrorResponseFrame as e, type EventNotificationParams as f, type ResponseFrame as g, type ReverseRequestFrame as h, type ReverseResponseResult as i, type SuccessResponseFrame as j, assertChatConversationSupported as k, engineConversationUnsupportedError as l, engineProtocolMismatchError as m, engineTimeoutDetail as n, isEngineErrorPassthroughCode as o, isEngineProtocolErrorCode as p, isNotificationFrame as q, isRequestFrame as r, isResponseFrame as s, isReverseRequestFrame as t, schemaEmulationFailedDetail as u };