@winmatrix/protocol 1.0.4 → 1.0.6

package/dist/schemas.d.ts

@@ -288,6 +288,23 @@ export declare const TaskAssignParamsSchema: z.ZodObject<{
     sessionId: z.ZodOptional<z.ZodString>;
     /** When true, adapter SHALL resume the session identified by sessionId */
     resumeSession: z.ZodOptional<z.ZodBoolean>;
+    /** 当前 turn 上下文预算（可选；V2 信封里由 launchSpec.contextBudget 覆盖）。 */
+    contextBudget: z.ZodOptional<z.ZodObject<{
+        maxInputChars: z.ZodOptional<z.ZodNumber>;
+        maxSystemChars: z.ZodOptional<z.ZodNumber>;
+        maxContextChars: z.ZodOptional<z.ZodNumber>;
+        compression: z.ZodOptional<z.ZodEnum<["none", "truncate_head", "truncate_tail"]>>;
+    }, "strip", z.ZodTypeAny, {
+        maxInputChars?: number | undefined;
+        maxSystemChars?: number | undefined;
+        maxContextChars?: number | undefined;
+        compression?: "none" | "truncate_head" | "truncate_tail" | undefined;
+    }, {
+        maxInputChars?: number | undefined;
+        maxSystemChars?: number | undefined;
+        maxContextChars?: number | undefined;
+        compression?: "none" | "truncate_head" | "truncate_tail" | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     streaming: boolean;
     taskId: string;
@@ -310,6 +327,12 @@ export declare const TaskAssignParamsSchema: z.ZodObject<{
     mcpToken?: string | undefined;
     sessionId?: string | undefined;
     resumeSession?: boolean | undefined;
+    contextBudget?: {
+        maxInputChars?: number | undefined;
+        maxSystemChars?: number | undefined;
+        maxContextChars?: number | undefined;
+        compression?: "none" | "truncate_head" | "truncate_tail" | undefined;
+    } | undefined;
 }, {
     streaming: boolean;
     taskId: string;
@@ -332,6 +355,12 @@ export declare const TaskAssignParamsSchema: z.ZodObject<{
     mcpToken?: string | undefined;
     sessionId?: string | undefined;
     resumeSession?: boolean | undefined;
+    contextBudget?: {
+        maxInputChars?: number | undefined;
+        maxSystemChars?: number | undefined;
+        maxContextChars?: number | undefined;
+        compression?: "none" | "truncate_head" | "truncate_tail" | undefined;
+    } | undefined;
 }>;
 export type TaskContext = z.infer<typeof TaskContextSchema>;
 export type TaskConstraints = z.infer<typeof TaskConstraintsSchema>;
@@ -339,7 +368,91 @@ export type TaskAssignParams = z.infer<typeof TaskAssignParamsSchema>;
 export declare const EngineIdSchema: z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>;
 export declare const HostKindSchema: z.ZodEnum<["workstation", "external_computer"]>;
 export declare const HostProfileSchema: z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>;
-export declare const EngineToolNameSchema: z.ZodEnum<["coding_task", "sre_skill_task", "workstation_execute", "external_agent_task"]>;
+export declare const EngineToolNameSchema: z.ZodEnum<["coding_task", "sre_skill_task", "workstation_execute", "external_agent_task", "execute_task"]>;
+/** 本次 Run 实际协商出的执行耐久等级（静态 capability 只表达最大可能集合）。 */
+export declare const ExecutionDurabilitySchema: z.ZodEnum<["connection_bound", "host_persistent"]>;
+/** 事件恢复等级（递进能力）：live_only < replay < snapshot_fallback。 */
+export declare const EventStreamModeSchema: z.ZodEnum<["live_only", "replay", "snapshot_fallback"]>;
+export declare const EventRetentionSchema: z.ZodObject<{
+    maxEvents: z.ZodOptional<z.ZodNumber>;
+    maxAgeSeconds: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    maxEvents?: number | undefined;
+    maxAgeSeconds?: number | undefined;
+}, {
+    maxEvents?: number | undefined;
+    maxAgeSeconds?: number | undefined;
+}>;
+export declare const EngineContentBlockKindSchema: z.ZodEnum<["text", "image_ref", "file_ref", "resource_ref"]>;
+/** 跨 Engine 标准 Hook 阶段；Engine Adapter 只声明真实支持的映射。 */
+export declare const AgentEngineHookPointSchema: z.ZodEnum<["session.start", "prompt.beforeSubmit", "tool.beforeExecute", "permission.request", "tool.completed", "tool.failed", "subagent.started", "subagent.beforeComplete", "turn.beforeComplete", "session.end", "context.beforeCompact", "context.compacted"]>;
+/** 内部受治理 Hook Profile 引用；只允许出现在 canonical LaunchSpec 与 Host wire DTO。 */
+export declare const EngineHookProfileRefSchema: z.ZodObject<{
+    profileId: z.ZodString;
+    version: z.ZodString;
+    policyRevision: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    profileId: string;
+    version: string;
+    policyRevision: string;
+}, {
+    profileId: string;
+    version: string;
+    policyRevision: string;
+}>;
+/** Host/daemon 内部 capability 声明用：已安装的 Profile 及策略版本。 */
+export declare const EngineHookProfileDescriptorSchema: z.ZodObject<{
+    ref: z.ZodObject<{
+        profileId: z.ZodString;
+        version: z.ZodString;
+        policyRevision: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        profileId: string;
+        version: string;
+        policyRevision: string;
+    }, {
+        profileId: string;
+        version: string;
+        policyRevision: string;
+    }>;
+    hookPoints: z.ZodArray<z.ZodEnum<["session.start", "prompt.beforeSubmit", "tool.beforeExecute", "permission.request", "tool.completed", "tool.failed", "subagent.started", "subagent.beforeComplete", "turn.beforeComplete", "session.end", "context.beforeCompact", "context.compacted"]>, "many">;
+    blocking: z.ZodEnum<["never", "allow_deny", "interaction"]>;
+    timeoutMs: z.ZodNumber;
+    failureMode: z.ZodEnum<["fail_closed", "fail_open", "report_only"]>;
+}, "strip", z.ZodTypeAny, {
+    ref: {
+        profileId: string;
+        version: string;
+        policyRevision: string;
+    };
+    hookPoints: ("session.start" | "prompt.beforeSubmit" | "tool.beforeExecute" | "permission.request" | "tool.completed" | "tool.failed" | "subagent.started" | "subagent.beforeComplete" | "turn.beforeComplete" | "session.end" | "context.beforeCompact" | "context.compacted")[];
+    blocking: "never" | "allow_deny" | "interaction";
+    timeoutMs: number;
+    failureMode: "fail_closed" | "fail_open" | "report_only";
+}, {
+    ref: {
+        profileId: string;
+        version: string;
+        policyRevision: string;
+    };
+    hookPoints: ("session.start" | "prompt.beforeSubmit" | "tool.beforeExecute" | "permission.request" | "tool.completed" | "tool.failed" | "subagent.started" | "subagent.beforeComplete" | "turn.beforeComplete" | "session.end" | "context.beforeCompact" | "context.compacted")[];
+    blocking: "never" | "allow_deny" | "interaction";
+    timeoutMs: number;
+    failureMode: "fail_closed" | "fail_open" | "report_only";
+}>;
+export declare const EngineInteractionOptionSchema: z.ZodObject<{
+    optionId: z.ZodString;
+    label: z.ZodString;
+    semantic: z.ZodOptional<z.ZodEnum<["allow_once", "allow_session", "deny", "custom"]>>;
+}, "strip", z.ZodTypeAny, {
+    optionId: string;
+    label: string;
+    semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
+}, {
+    optionId: string;
+    label: string;
+    semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
+}>;
 export declare const EngineCapabilityProfileSchema: z.ZodObject<{
     engineId: z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>;
     hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
@@ -360,6 +473,74 @@ export declare const EngineCapabilityProfileSchema: z.ZodObject<{
         resume?: string | undefined;
     }>>;
     unavailableReason: z.ZodOptional<z.ZodString>;
+    /** 最大静态耐久能力集合；具体 Run 的实际 durability 由 launch ack/snapshot 表达。 */
+    supportedExecutionDurability: z.ZodOptional<z.ZodArray<z.ZodEnum<["connection_bound", "host_persistent"]>, "many">>;
+    supportsInteractionResponse: z.ZodOptional<z.ZodBoolean>;
+    /** 只描述 startRun() 初始输入 block 类型，不表示支持运行中追加普通消息。 */
+    supportedInputKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["text", "image_ref", "file_ref", "resource_ref"]>, "many">>;
+    permissionModes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
+    supportsModelSelection: z.ZodOptional<z.ZodBoolean>;
+    supportsEngineOptionDiscovery: z.ZodOptional<z.ZodBoolean>;
+    /** 内部启动协商用，不属于用户可选 Engine options。 */
+    supportedEngineHookProfiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ref: z.ZodObject<{
+            profileId: z.ZodString;
+            version: z.ZodString;
+            policyRevision: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            profileId: string;
+            version: string;
+            policyRevision: string;
+        }, {
+            profileId: string;
+            version: string;
+            policyRevision: string;
+        }>;
+        hookPoints: z.ZodArray<z.ZodEnum<["session.start", "prompt.beforeSubmit", "tool.beforeExecute", "permission.request", "tool.completed", "tool.failed", "subagent.started", "subagent.beforeComplete", "turn.beforeComplete", "session.end", "context.beforeCompact", "context.compacted"]>, "many">;
+        blocking: z.ZodEnum<["never", "allow_deny", "interaction"]>;
+        timeoutMs: z.ZodNumber;
+        failureMode: z.ZodEnum<["fail_closed", "fail_open", "report_only"]>;
+    }, "strip", z.ZodTypeAny, {
+        ref: {
+            profileId: string;
+            version: string;
+            policyRevision: string;
+        };
+        hookPoints: ("session.start" | "prompt.beforeSubmit" | "tool.beforeExecute" | "permission.request" | "tool.completed" | "tool.failed" | "subagent.started" | "subagent.beforeComplete" | "turn.beforeComplete" | "session.end" | "context.beforeCompact" | "context.compacted")[];
+        blocking: "never" | "allow_deny" | "interaction";
+        timeoutMs: number;
+        failureMode: "fail_closed" | "fail_open" | "report_only";
+    }, {
+        ref: {
+            profileId: string;
+            version: string;
+            policyRevision: string;
+        };
+        hookPoints: ("session.start" | "prompt.beforeSubmit" | "tool.beforeExecute" | "permission.request" | "tool.completed" | "tool.failed" | "subagent.started" | "subagent.beforeComplete" | "turn.beforeComplete" | "session.end" | "context.beforeCompact" | "context.compacted")[];
+        blocking: "never" | "allow_deny" | "interaction";
+        timeoutMs: number;
+        failureMode: "fail_closed" | "fail_open" | "report_only";
+    }>, "many">>;
+    eventStreamMode: z.ZodOptional<z.ZodEnum<["live_only", "replay", "snapshot_fallback"]>>;
+    eventRetention: z.ZodOptional<z.ZodObject<{
+        maxEvents: z.ZodOptional<z.ZodNumber>;
+        maxAgeSeconds: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxEvents?: number | undefined;
+        maxAgeSeconds?: number | undefined;
+    }, {
+        maxEvents?: number | undefined;
+        maxAgeSeconds?: number | undefined;
+    }>>;
+    supportsSessionList: z.ZodOptional<z.ZodBoolean>;
+    supportsSessionGet: z.ZodOptional<z.ZodBoolean>;
+    supportsSessionSearch: z.ZodOptional<z.ZodBoolean>;
+    supportsSessionDelete: z.ZodOptional<z.ZodBoolean>;
+    supportsSessionResume: z.ZodOptional<z.ZodBoolean>;
+    supportsSessionFork: z.ZodOptional<z.ZodBoolean>;
+    /** 旧字段：兼容期仅映射为 eventStreamMode='live_only'，不得据此宣称 replay。 */
+    supportsReconnectableStream: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     streaming: boolean;
     toolCall: boolean;
@@ -374,6 +555,36 @@ export declare const EngineCapabilityProfileSchema: z.ZodObject<{
         resume?: string | undefined;
     } | undefined;
     unavailableReason?: string | undefined;
+    supportedExecutionDurability?: ("connection_bound" | "host_persistent")[] | undefined;
+    supportsInteractionResponse?: boolean | undefined;
+    supportedInputKinds?: ("text" | "image_ref" | "file_ref" | "resource_ref")[] | undefined;
+    permissionModes?: string[] | undefined;
+    supportsReasoningEffort?: boolean | undefined;
+    supportsModelSelection?: boolean | undefined;
+    supportsEngineOptionDiscovery?: boolean | undefined;
+    supportedEngineHookProfiles?: {
+        ref: {
+            profileId: string;
+            version: string;
+            policyRevision: string;
+        };
+        hookPoints: ("session.start" | "prompt.beforeSubmit" | "tool.beforeExecute" | "permission.request" | "tool.completed" | "tool.failed" | "subagent.started" | "subagent.beforeComplete" | "turn.beforeComplete" | "session.end" | "context.beforeCompact" | "context.compacted")[];
+        blocking: "never" | "allow_deny" | "interaction";
+        timeoutMs: number;
+        failureMode: "fail_closed" | "fail_open" | "report_only";
+    }[] | undefined;
+    eventStreamMode?: "live_only" | "replay" | "snapshot_fallback" | undefined;
+    eventRetention?: {
+        maxEvents?: number | undefined;
+        maxAgeSeconds?: number | undefined;
+    } | undefined;
+    supportsSessionList?: boolean | undefined;
+    supportsSessionGet?: boolean | undefined;
+    supportsSessionSearch?: boolean | undefined;
+    supportsSessionDelete?: boolean | undefined;
+    supportsSessionResume?: boolean | undefined;
+    supportsSessionFork?: boolean | undefined;
+    supportsReconnectableStream?: boolean | undefined;
 }, {
     streaming: boolean;
     toolCall: boolean;
@@ -388,13 +599,48 @@ export declare const EngineCapabilityProfileSchema: z.ZodObject<{
         resume?: string | undefined;
     } | undefined;
     unavailableReason?: string | undefined;
+    supportedExecutionDurability?: ("connection_bound" | "host_persistent")[] | undefined;
+    supportsInteractionResponse?: boolean | undefined;
+    supportedInputKinds?: ("text" | "image_ref" | "file_ref" | "resource_ref")[] | undefined;
+    permissionModes?: string[] | undefined;
+    supportsReasoningEffort?: boolean | undefined;
+    supportsModelSelection?: boolean | undefined;
+    supportsEngineOptionDiscovery?: boolean | undefined;
+    supportedEngineHookProfiles?: {
+        ref: {
+            profileId: string;
+            version: string;
+            policyRevision: string;
+        };
+        hookPoints: ("session.start" | "prompt.beforeSubmit" | "tool.beforeExecute" | "permission.request" | "tool.completed" | "tool.failed" | "subagent.started" | "subagent.beforeComplete" | "turn.beforeComplete" | "session.end" | "context.beforeCompact" | "context.compacted")[];
+        blocking: "never" | "allow_deny" | "interaction";
+        timeoutMs: number;
+        failureMode: "fail_closed" | "fail_open" | "report_only";
+    }[] | undefined;
+    eventStreamMode?: "live_only" | "replay" | "snapshot_fallback" | undefined;
+    eventRetention?: {
+        maxEvents?: number | undefined;
+        maxAgeSeconds?: number | undefined;
+    } | undefined;
+    supportsSessionList?: boolean | undefined;
+    supportsSessionGet?: boolean | undefined;
+    supportsSessionSearch?: boolean | undefined;
+    supportsSessionDelete?: boolean | undefined;
+    supportsSessionResume?: boolean | undefined;
+    supportsSessionFork?: boolean | undefined;
+    supportsReconnectableStream?: boolean | undefined;
 }>;
-export declare const EngineInvocationPlanSchema: z.ZodObject<{
+/**
+ * V1 调用计划（字符串 input）。现有 shape 固定为 V1，不得原地改成对象；
+ * 结构化输入请使用 EngineInvocationPlanV2Schema（见 agentEngine.ts）。
+ * env 仅允许非敏感、可序列化配置；secret 走 Host 私有 binding。
+ */
+export declare const EngineInvocationPlanV1Schema: z.ZodObject<{
     taskId: z.ZodString;
     engineId: z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>;
     hostKind: z.ZodEnum<["workstation", "external_computer"]>;
     hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
-    toolName: z.ZodEnum<["coding_task", "sre_skill_task", "workstation_execute", "external_agent_task"]>;
+    toolName: z.ZodEnum<["coding_task", "sre_skill_task", "workstation_execute", "external_agent_task", "execute_task"]>;
     input: z.ZodString;
     workDir: z.ZodOptional<z.ZodString>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -408,13 +654,13 @@ export declare const EngineInvocationPlanSchema: z.ZodObject<{
     input: string;
     engineId: "custom" | "claude-code" | "codex" | "hermes" | "openclaw";
     hostKind: "workstation" | "external_computer";
-    toolName: "coding_task" | "sre_skill_task" | "workstation_execute" | "external_agent_task";
+    toolName: "coding_task" | "sre_skill_task" | "workstation_execute" | "external_agent_task" | "execute_task";
     allowedTools?: string[] | undefined;
     sessionId?: string | undefined;
+    timeoutMs?: number | undefined;
     hostProfile?: string | undefined;
     resume?: boolean | undefined;
     workDir?: string | undefined;
-    timeoutMs?: number | undefined;
     env?: Record<string, string> | undefined;
     artifactPolicy?: Record<string, unknown> | undefined;
 }, {
@@ -422,29 +668,74 @@ export declare const EngineInvocationPlanSchema: z.ZodObject<{
     input: string;
     engineId: "custom" | "claude-code" | "codex" | "hermes" | "openclaw";
     hostKind: "workstation" | "external_computer";
-    toolName: "coding_task" | "sre_skill_task" | "workstation_execute" | "external_agent_task";
+    toolName: "coding_task" | "sre_skill_task" | "workstation_execute" | "external_agent_task" | "execute_task";
     allowedTools?: string[] | undefined;
     sessionId?: string | undefined;
+    timeoutMs?: number | undefined;
     hostProfile?: string | undefined;
     resume?: boolean | undefined;
     workDir?: string | undefined;
-    timeoutMs?: number | undefined;
     env?: Record<string, string> | undefined;
     artifactPolicy?: Record<string, unknown> | undefined;
 }>;
-export declare const EngineProgressEventTypeSchema: z.ZodEnum<["status", "content_delta", "thinking_delta", "tool_call", "tool_result_delta", "stderr_delta", "artifact", "usage", "result", "error"]>;
+export declare const EngineProgressEventTypeSchema: z.ZodEnum<["status", "content_delta", "thinking_delta", "tool_call", "tool_result_delta", "stderr_delta", "artifact", "usage", "result", "error", "interaction_requested", "interaction_resolved"]>;
 export declare const EngineUsageSchema: z.ZodObject<{
     inputTokens: z.ZodOptional<z.ZodNumber>;
     outputTokens: z.ZodOptional<z.ZodNumber>;
     thinkingTokens: z.ZodOptional<z.ZodNumber>;
+    cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+    totalTokens: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    inputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+    thinkingTokens?: number | undefined;
+    cacheReadInputTokens?: number | undefined;
+    cacheCreationInputTokens?: number | undefined;
+    totalTokens?: number | undefined;
+}, {
+    inputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+    thinkingTokens?: number | undefined;
+    cacheReadInputTokens?: number | undefined;
+    cacheCreationInputTokens?: number | undefined;
+    totalTokens?: number | undefined;
+}>;
+/**
+ * D11.4: Token usage with acquisition source tracking.
+ * Each PodEngineDriver tries multiple paths (primary_event → session_log_scan → unknown)
+ * and records which path succeeded.
+ */
+export declare const EngineTokenUsageSchema: z.ZodObject<{
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    thinkingTokens: z.ZodOptional<z.ZodNumber>;
+    cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+    totalTokens: z.ZodOptional<z.ZodNumber>;
+} & {
+    /** How this usage was obtained */
+    source: z.ZodDefault<z.ZodEnum<["primary_event", "session_log_scan", "unknown"]>>;
+    /** Engine-specific raw usage data for diagnostics */
+    raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
+    source: "unknown" | "primary_event" | "session_log_scan";
     inputTokens?: number | undefined;
     outputTokens?: number | undefined;
     thinkingTokens?: number | undefined;
+    cacheReadInputTokens?: number | undefined;
+    cacheCreationInputTokens?: number | undefined;
+    totalTokens?: number | undefined;
+    raw?: Record<string, unknown> | undefined;
 }, {
     inputTokens?: number | undefined;
     outputTokens?: number | undefined;
     thinkingTokens?: number | undefined;
+    cacheReadInputTokens?: number | undefined;
+    cacheCreationInputTokens?: number | undefined;
+    totalTokens?: number | undefined;
+    source?: "unknown" | "primary_event" | "session_log_scan" | undefined;
+    raw?: Record<string, unknown> | undefined;
 }>;
 export declare const EngineFinalResultSchema: z.ZodObject<{
     success: z.ZodBoolean;
@@ -455,14 +746,23 @@ export declare const EngineFinalResultSchema: z.ZodObject<{
         inputTokens: z.ZodOptional<z.ZodNumber>;
         outputTokens: z.ZodOptional<z.ZodNumber>;
         thinkingTokens: z.ZodOptional<z.ZodNumber>;
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
         thinkingTokens?: number | undefined;
+        cacheReadInputTokens?: number | undefined;
+        cacheCreationInputTokens?: number | undefined;
+        totalTokens?: number | undefined;
     }, {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
         thinkingTokens?: number | undefined;
+        cacheReadInputTokens?: number | undefined;
+        cacheCreationInputTokens?: number | undefined;
+        totalTokens?: number | undefined;
     }>>;
     error: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -470,24 +770,30 @@ export declare const EngineFinalResultSchema: z.ZodObject<{
     success: boolean;
     error?: string | undefined;
     sessionId?: string | undefined;
+    text?: string | undefined;
     usage?: {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
         thinkingTokens?: number | undefined;
+        cacheReadInputTokens?: number | undefined;
+        cacheCreationInputTokens?: number | undefined;
+        totalTokens?: number | undefined;
     } | undefined;
-    text?: string | undefined;
     artifacts?: Record<string, unknown>[] | undefined;
     metadata?: Record<string, unknown> | undefined;
 }, {
     success: boolean;
     error?: string | undefined;
     sessionId?: string | undefined;
+    text?: string | undefined;
     usage?: {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
         thinkingTokens?: number | undefined;
+        cacheReadInputTokens?: number | undefined;
+        cacheCreationInputTokens?: number | undefined;
+        totalTokens?: number | undefined;
     } | undefined;
-    text?: string | undefined;
     artifacts?: Record<string, unknown>[] | undefined;
     metadata?: Record<string, unknown> | undefined;
 }>;
@@ -554,6 +860,8 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
     hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
 } & {
     type: z.ZodLiteral<"tool_call">;
+    /** 同一轮多个同名工具调用的稳定展示身份。 */
+    callId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
     input: z.ZodOptional<z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
@@ -563,6 +871,7 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
     engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
     hostKind?: "workstation" | "external_computer" | undefined;
     hostProfile?: string | undefined;
+    callId?: string | undefined;
 }, {
     type: "tool_call";
     name: string;
@@ -570,12 +879,15 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
     engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
     hostKind?: "workstation" | "external_computer" | undefined;
     hostProfile?: string | undefined;
+    callId?: string | undefined;
 }>, z.ZodObject<{
     engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
     hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
     hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
 } & {
     type: z.ZodLiteral<"tool_result_delta">;
+    /** 与 tool_call 配对；旧 runtime 未提供时允许服务端降级。 */
+    callId: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
     text: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -585,6 +897,7 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
     engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
     hostKind?: "workstation" | "external_computer" | undefined;
     hostProfile?: string | undefined;
+    callId?: string | undefined;
 }, {
     type: "tool_result_delta";
     text: string;
@@ -592,6 +905,7 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
     engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
     hostKind?: "workstation" | "external_computer" | undefined;
     hostProfile?: string | undefined;
+    callId?: string | undefined;
 }>, z.ZodObject<{
     engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
     hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
@@ -622,17 +936,17 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
 }, "strip", z.ZodTypeAny, {
     type: "artifact";
     path: string;
+    label?: string | undefined;
     engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
     hostKind?: "workstation" | "external_computer" | undefined;
     hostProfile?: string | undefined;
-    label?: string | undefined;
 }, {
     type: "artifact";
     path: string;
+    label?: string | undefined;
     engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
     hostKind?: "workstation" | "external_computer" | undefined;
     hostProfile?: string | undefined;
-    label?: string | undefined;
 }>, z.ZodObject<{
     engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
     hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
@@ -643,14 +957,23 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
         inputTokens: z.ZodOptional<z.ZodNumber>;
         outputTokens: z.ZodOptional<z.ZodNumber>;
         thinkingTokens: z.ZodOptional<z.ZodNumber>;
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
         thinkingTokens?: number | undefined;
+        cacheReadInputTokens?: number | undefined;
+        cacheCreationInputTokens?: number | undefined;
+        totalTokens?: number | undefined;
     }, {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
         thinkingTokens?: number | undefined;
+        cacheReadInputTokens?: number | undefined;
+        cacheCreationInputTokens?: number | undefined;
+        totalTokens?: number | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     type: "usage";
@@ -658,6 +981,9 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
         thinkingTokens?: number | undefined;
+        cacheReadInputTokens?: number | undefined;
+        cacheCreationInputTokens?: number | undefined;
+        totalTokens?: number | undefined;
     };
     engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
     hostKind?: "workstation" | "external_computer" | undefined;
@@ -668,6 +994,9 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
         thinkingTokens?: number | undefined;
+        cacheReadInputTokens?: number | undefined;
+        cacheCreationInputTokens?: number | undefined;
+        totalTokens?: number | undefined;
     };
     engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
     hostKind?: "workstation" | "external_computer" | undefined;
@@ -687,14 +1016,23 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
             inputTokens: z.ZodOptional<z.ZodNumber>;
             outputTokens: z.ZodOptional<z.ZodNumber>;
             thinkingTokens: z.ZodOptional<z.ZodNumber>;
+            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+            totalTokens: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
             thinkingTokens?: number | undefined;
+            cacheReadInputTokens?: number | undefined;
+            cacheCreationInputTokens?: number | undefined;
+            totalTokens?: number | undefined;
         }, {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
             thinkingTokens?: number | undefined;
+            cacheReadInputTokens?: number | undefined;
+            cacheCreationInputTokens?: number | undefined;
+            totalTokens?: number | undefined;
         }>>;
         error: z.ZodOptional<z.ZodString>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -702,24 +1040,30 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
         success: boolean;
         error?: string | undefined;
         sessionId?: string | undefined;
+        text?: string | undefined;
         usage?: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
             thinkingTokens?: number | undefined;
+            cacheReadInputTokens?: number | undefined;
+            cacheCreationInputTokens?: number | undefined;
+            totalTokens?: number | undefined;
         } | undefined;
-        text?: string | undefined;
         artifacts?: Record<string, unknown>[] | undefined;
         metadata?: Record<string, unknown> | undefined;
     }, {
         success: boolean;
         error?: string | undefined;
         sessionId?: string | undefined;
+        text?: string | undefined;
         usage?: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
             thinkingTokens?: number | undefined;
+            cacheReadInputTokens?: number | undefined;
+            cacheCreationInputTokens?: number | undefined;
+            totalTokens?: number | undefined;
         } | undefined;
-        text?: string | undefined;
         artifacts?: Record<string, unknown>[] | undefined;
         metadata?: Record<string, unknown> | undefined;
     }>;
@@ -729,12 +1073,15 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
         success: boolean;
         error?: string | undefined;
         sessionId?: string | undefined;
+        text?: string | undefined;
         usage?: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
             thinkingTokens?: number | undefined;
+            cacheReadInputTokens?: number | undefined;
+            cacheCreationInputTokens?: number | undefined;
+            totalTokens?: number | undefined;
         } | undefined;
-        text?: string | undefined;
         artifacts?: Record<string, unknown>[] | undefined;
         metadata?: Record<string, unknown> | undefined;
     };
@@ -747,12 +1094,15 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
         success: boolean;
         error?: string | undefined;
         sessionId?: string | undefined;
+        text?: string | undefined;
         usage?: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
             thinkingTokens?: number | undefined;
+            cacheReadInputTokens?: number | undefined;
+            cacheCreationInputTokens?: number | undefined;
+            totalTokens?: number | undefined;
         } | undefined;
-        text?: string | undefined;
         artifacts?: Record<string, unknown>[] | undefined;
         metadata?: Record<string, unknown> | undefined;
     };
@@ -781,6 +1131,83 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
     engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
     hostKind?: "workstation" | "external_computer" | undefined;
     hostProfile?: string | undefined;
+}>, z.ZodObject<{
+    engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
+    hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
+    hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
+} & {
+    type: z.ZodLiteral<"interaction_requested">;
+    interactionId: z.ZodString;
+    interactionType: z.ZodEnum<["permission", "confirmation", "question", "selection"]>;
+    /** 最小必要的用户决策说明；不得包含 Engine 内部思考或 secret。 */
+    prompt: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+        optionId: z.ZodString;
+        label: z.ZodString;
+        semantic: z.ZodOptional<z.ZodEnum<["allow_once", "allow_session", "deny", "custom"]>>;
+    }, "strip", z.ZodTypeAny, {
+        optionId: string;
+        label: string;
+        semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
+    }, {
+        optionId: string;
+        label: string;
+        semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
+    }>, "many">;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "interaction_requested";
+    options: {
+        optionId: string;
+        label: string;
+        semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
+    }[];
+    interactionId: string;
+    interactionType: "permission" | "confirmation" | "question" | "selection";
+    prompt: string;
+    timeoutMs?: number | undefined;
+    engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
+    hostKind?: "workstation" | "external_computer" | undefined;
+    hostProfile?: string | undefined;
+}, {
+    type: "interaction_requested";
+    options: {
+        optionId: string;
+        label: string;
+        semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
+    }[];
+    interactionId: string;
+    interactionType: "permission" | "confirmation" | "question" | "selection";
+    prompt: string;
+    timeoutMs?: number | undefined;
+    engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
+    hostKind?: "workstation" | "external_computer" | undefined;
+    hostProfile?: string | undefined;
+}>, z.ZodObject<{
+    engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
+    hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
+    hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
+} & {
+    type: z.ZodLiteral<"interaction_resolved">;
+    interactionId: z.ZodString;
+    responseId: z.ZodOptional<z.ZodString>;
+    resolution: z.ZodEnum<["accepted", "rejected", "answered", "expired"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "interaction_resolved";
+    interactionId: string;
+    resolution: "accepted" | "rejected" | "answered" | "expired";
+    engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
+    hostKind?: "workstation" | "external_computer" | undefined;
+    hostProfile?: string | undefined;
+    responseId?: string | undefined;
+}, {
+    type: "interaction_resolved";
+    interactionId: string;
+    resolution: "accepted" | "rejected" | "answered" | "expired";
+    engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
+    hostKind?: "workstation" | "external_computer" | undefined;
+    hostProfile?: string | undefined;
+    responseId?: string | undefined;
 }>]>;
 export declare const TaskDeltaEventSchema: z.ZodObject<{
     taskId: z.ZodString;
@@ -849,6 +1276,8 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
         hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
     } & {
         type: z.ZodLiteral<"tool_call">;
+        /** 同一轮多个同名工具调用的稳定展示身份。 */
+        callId: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         input: z.ZodOptional<z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
@@ -858,6 +1287,7 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
+        callId?: string | undefined;
     }, {
         type: "tool_call";
         name: string;
@@ -865,12 +1295,15 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
+        callId?: string | undefined;
     }>, z.ZodObject<{
         engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
         hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
         hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
     } & {
         type: z.ZodLiteral<"tool_result_delta">;
+        /** 与 tool_call 配对；旧 runtime 未提供时允许服务端降级。 */
+        callId: z.ZodOptional<z.ZodString>;
         name: z.ZodOptional<z.ZodString>;
         text: z.ZodString;
     }, "strip", z.ZodTypeAny, {
@@ -880,6 +1313,7 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
+        callId?: string | undefined;
     }, {
         type: "tool_result_delta";
         text: string;
@@ -887,6 +1321,7 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
+        callId?: string | undefined;
     }>, z.ZodObject<{
         engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
         hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
@@ -917,17 +1352,17 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         type: "artifact";
         path: string;
+        label?: string | undefined;
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
-        label?: string | undefined;
     }, {
         type: "artifact";
         path: string;
+        label?: string | undefined;
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
-        label?: string | undefined;
     }>, z.ZodObject<{
         engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
         hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
@@ -938,14 +1373,23 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
             inputTokens: z.ZodOptional<z.ZodNumber>;
             outputTokens: z.ZodOptional<z.ZodNumber>;
             thinkingTokens: z.ZodOptional<z.ZodNumber>;
+            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+            totalTokens: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
             thinkingTokens?: number | undefined;
+            cacheReadInputTokens?: number | undefined;
+            cacheCreationInputTokens?: number | undefined;
+            totalTokens?: number | undefined;
         }, {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
             thinkingTokens?: number | undefined;
+            cacheReadInputTokens?: number | undefined;
+            cacheCreationInputTokens?: number | undefined;
+            totalTokens?: number | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
         type: "usage";
@@ -953,6 +1397,9 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
             thinkingTokens?: number | undefined;
+            cacheReadInputTokens?: number | undefined;
+            cacheCreationInputTokens?: number | undefined;
+            totalTokens?: number | undefined;
         };
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
@@ -963,6 +1410,9 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
             thinkingTokens?: number | undefined;
+            cacheReadInputTokens?: number | undefined;
+            cacheCreationInputTokens?: number | undefined;
+            totalTokens?: number | undefined;
         };
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
@@ -982,14 +1432,23 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
                 inputTokens: z.ZodOptional<z.ZodNumber>;
                 outputTokens: z.ZodOptional<z.ZodNumber>;
                 thinkingTokens: z.ZodOptional<z.ZodNumber>;
+                cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+                cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+                totalTokens: z.ZodOptional<z.ZodNumber>;
             }, "strip", z.ZodTypeAny, {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
                 thinkingTokens?: number | undefined;
+                cacheReadInputTokens?: number | undefined;
+                cacheCreationInputTokens?: number | undefined;
+                totalTokens?: number | undefined;
             }, {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
                 thinkingTokens?: number | undefined;
+                cacheReadInputTokens?: number | undefined;
+                cacheCreationInputTokens?: number | undefined;
+                totalTokens?: number | undefined;
             }>>;
             error: z.ZodOptional<z.ZodString>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -997,24 +1456,30 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
             success: boolean;
             error?: string | undefined;
             sessionId?: string | undefined;
+            text?: string | undefined;
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
                 thinkingTokens?: number | undefined;
+                cacheReadInputTokens?: number | undefined;
+                cacheCreationInputTokens?: number | undefined;
+                totalTokens?: number | undefined;
             } | undefined;
-            text?: string | undefined;
             artifacts?: Record<string, unknown>[] | undefined;
             metadata?: Record<string, unknown> | undefined;
         }, {
             success: boolean;
             error?: string | undefined;
             sessionId?: string | undefined;
+            text?: string | undefined;
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
                 thinkingTokens?: number | undefined;
+                cacheReadInputTokens?: number | undefined;
+                cacheCreationInputTokens?: number | undefined;
+                totalTokens?: number | undefined;
             } | undefined;
-            text?: string | undefined;
             artifacts?: Record<string, unknown>[] | undefined;
             metadata?: Record<string, unknown> | undefined;
         }>;
@@ -1024,12 +1489,15 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
             success: boolean;
             error?: string | undefined;
             sessionId?: string | undefined;
+            text?: string | undefined;
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
                 thinkingTokens?: number | undefined;
+                cacheReadInputTokens?: number | undefined;
+                cacheCreationInputTokens?: number | undefined;
+                totalTokens?: number | undefined;
             } | undefined;
-            text?: string | undefined;
             artifacts?: Record<string, unknown>[] | undefined;
             metadata?: Record<string, unknown> | undefined;
         };
@@ -1042,12 +1510,15 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
             success: boolean;
             error?: string | undefined;
             sessionId?: string | undefined;
+            text?: string | undefined;
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
                 thinkingTokens?: number | undefined;
+                cacheReadInputTokens?: number | undefined;
+                cacheCreationInputTokens?: number | undefined;
+                totalTokens?: number | undefined;
             } | undefined;
-            text?: string | undefined;
             artifacts?: Record<string, unknown>[] | undefined;
             metadata?: Record<string, unknown> | undefined;
         };
@@ -1076,6 +1547,83 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
+    }>, z.ZodObject<{
+        engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
+        hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
+        hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
+    } & {
+        type: z.ZodLiteral<"interaction_requested">;
+        interactionId: z.ZodString;
+        interactionType: z.ZodEnum<["permission", "confirmation", "question", "selection"]>;
+        /** 最小必要的用户决策说明；不得包含 Engine 内部思考或 secret。 */
+        prompt: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+            optionId: z.ZodString;
+            label: z.ZodString;
+            semantic: z.ZodOptional<z.ZodEnum<["allow_once", "allow_session", "deny", "custom"]>>;
+        }, "strip", z.ZodTypeAny, {
+            optionId: string;
+            label: string;
+            semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
+        }, {
+            optionId: string;
+            label: string;
+            semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
+        }>, "many">;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "interaction_requested";
+        options: {
+            optionId: string;
+            label: string;
+            semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
+        }[];
+        interactionId: string;
+        interactionType: "permission" | "confirmation" | "question" | "selection";
+        prompt: string;
+        timeoutMs?: number | undefined;
+        engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
+        hostKind?: "workstation" | "external_computer" | undefined;
+        hostProfile?: string | undefined;
+    }, {
+        type: "interaction_requested";
+        options: {
+            optionId: string;
+            label: string;
+            semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
+        }[];
+        interactionId: string;
+        interactionType: "permission" | "confirmation" | "question" | "selection";
+        prompt: string;
+        timeoutMs?: number | undefined;
+        engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
+        hostKind?: "workstation" | "external_computer" | undefined;
+        hostProfile?: string | undefined;
+    }>, z.ZodObject<{
+        engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
+        hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
+        hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
+    } & {
+        type: z.ZodLiteral<"interaction_resolved">;
+        interactionId: z.ZodString;
+        responseId: z.ZodOptional<z.ZodString>;
+        resolution: z.ZodEnum<["accepted", "rejected", "answered", "expired"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "interaction_resolved";
+        interactionId: string;
+        resolution: "accepted" | "rejected" | "answered" | "expired";
+        engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
+        hostKind?: "workstation" | "external_computer" | undefined;
+        hostProfile?: string | undefined;
+        responseId?: string | undefined;
+    }, {
+        type: "interaction_resolved";
+        interactionId: string;
+        resolution: "accepted" | "rejected" | "answered" | "expired";
+        engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
+        hostKind?: "workstation" | "external_computer" | undefined;
+        hostProfile?: string | undefined;
+        responseId?: string | undefined;
     }>]>>;
 }, "strip", z.ZodTypeAny, {
     taskId: string;
@@ -1106,6 +1654,7 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
+        callId?: string | undefined;
     } | {
         type: "tool_result_delta";
         text: string;
@@ -1113,6 +1662,7 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
+        callId?: string | undefined;
     } | {
         type: "stderr_delta";
         text: string;
@@ -1122,16 +1672,19 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
     } | {
         type: "artifact";
         path: string;
+        label?: string | undefined;
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
-        label?: string | undefined;
     } | {
         type: "usage";
         usage: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
             thinkingTokens?: number | undefined;
+            cacheReadInputTokens?: number | undefined;
+            cacheCreationInputTokens?: number | undefined;
+            totalTokens?: number | undefined;
         };
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
@@ -1142,12 +1695,15 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
             success: boolean;
             error?: string | undefined;
             sessionId?: string | undefined;
+            text?: string | undefined;
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
                 thinkingTokens?: number | undefined;
+                cacheReadInputTokens?: number | undefined;
+                cacheCreationInputTokens?: number | undefined;
+                totalTokens?: number | undefined;
             } | undefined;
-            text?: string | undefined;
             artifacts?: Record<string, unknown>[] | undefined;
             metadata?: Record<string, unknown> | undefined;
         };
@@ -1161,6 +1717,28 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
+    } | {
+        type: "interaction_requested";
+        options: {
+            optionId: string;
+            label: string;
+            semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
+        }[];
+        interactionId: string;
+        interactionType: "permission" | "confirmation" | "question" | "selection";
+        prompt: string;
+        timeoutMs?: number | undefined;
+        engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
+        hostKind?: "workstation" | "external_computer" | undefined;
+        hostProfile?: string | undefined;
+    } | {
+        type: "interaction_resolved";
+        interactionId: string;
+        resolution: "accepted" | "rejected" | "answered" | "expired";
+        engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
+        hostKind?: "workstation" | "external_computer" | undefined;
+        hostProfile?: string | undefined;
+        responseId?: string | undefined;
     } | undefined;
 }, {
     taskId: string;
@@ -1191,6 +1769,7 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
+        callId?: string | undefined;
     } | {
         type: "tool_result_delta";
         text: string;
@@ -1198,6 +1777,7 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
+        callId?: string | undefined;
     } | {
         type: "stderr_delta";
         text: string;
@@ -1207,16 +1787,19 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
     } | {
         type: "artifact";
         path: string;
+        label?: string | undefined;
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
-        label?: string | undefined;
     } | {
         type: "usage";
         usage: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
             thinkingTokens?: number | undefined;
+            cacheReadInputTokens?: number | undefined;
+            cacheCreationInputTokens?: number | undefined;
+            totalTokens?: number | undefined;
         };
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
@@ -1227,12 +1810,15 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
             success: boolean;
             error?: string | undefined;
             sessionId?: string | undefined;
+            text?: string | undefined;
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
                 thinkingTokens?: number | undefined;
+                cacheReadInputTokens?: number | undefined;
+                cacheCreationInputTokens?: number | undefined;
+                totalTokens?: number | undefined;
             } | undefined;
-            text?: string | undefined;
             artifacts?: Record<string, unknown>[] | undefined;
             metadata?: Record<string, unknown> | undefined;
         };
@@ -1246,6 +1832,28 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
         engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
         hostKind?: "workstation" | "external_computer" | undefined;
         hostProfile?: string | undefined;
+    } | {
+        type: "interaction_requested";
+        options: {
+            optionId: string;
+            label: string;
+            semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
+        }[];
+        interactionId: string;
+        interactionType: "permission" | "confirmation" | "question" | "selection";
+        prompt: string;
+        timeoutMs?: number | undefined;
+        engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
+        hostKind?: "workstation" | "external_computer" | undefined;
+        hostProfile?: string | undefined;
+    } | {
+        type: "interaction_resolved";
+        interactionId: string;
+        resolution: "accepted" | "rejected" | "answered" | "expired";
+        engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
+        hostKind?: "workstation" | "external_computer" | undefined;
+        hostProfile?: string | undefined;
+        responseId?: string | undefined;
     } | undefined;
 }>;
 export declare const TaskThinkingEventSchema: z.ZodObject<{
@@ -1328,11 +1936,20 @@ export type EngineId = z.infer<typeof EngineIdSchema>;
 export type HostKind = z.infer<typeof HostKindSchema>;
 export type HostProfile = z.infer<typeof HostProfileSchema>;
 export type EngineToolName = z.infer<typeof EngineToolNameSchema>;
+export type ExecutionDurability = z.infer<typeof ExecutionDurabilitySchema>;
+export type EventStreamMode = z.infer<typeof EventStreamModeSchema>;
+export type EventRetention = z.infer<typeof EventRetentionSchema>;
+export type EngineContentBlockKind = z.infer<typeof EngineContentBlockKindSchema>;
+export type AgentEngineHookPoint = z.infer<typeof AgentEngineHookPointSchema>;
+export type EngineHookProfileRef = z.infer<typeof EngineHookProfileRefSchema>;
+export type EngineHookProfileDescriptor = z.infer<typeof EngineHookProfileDescriptorSchema>;
+export type EngineInteractionOption = z.infer<typeof EngineInteractionOptionSchema>;
 export type EngineCapabilityProfile = z.infer<typeof EngineCapabilityProfileSchema>;
-export type EngineInvocationPlan = z.infer<typeof EngineInvocationPlanSchema>;
+export type EngineInvocationPlanV1 = z.infer<typeof EngineInvocationPlanV1Schema>;
 export type EngineProgressEventType = z.infer<typeof EngineProgressEventTypeSchema>;
 export type EngineProgressEvent = z.infer<typeof EngineProgressEventSchema>;
 export type EngineFinalResult = z.infer<typeof EngineFinalResultSchema>;
+export type EngineTokenUsage = z.infer<typeof EngineTokenUsageSchema>;
 export type TaskThinkingPayload = z.infer<typeof TaskThinkingEventSchema>;
 export type TaskCompletePayload = z.infer<typeof TaskCompleteEventSchema>;
 export type TaskErrorPayload = z.infer<typeof TaskErrorEventSchema>;
@@ -1794,13 +2411,13 @@ export declare const AgentProfileSchema: z.ZodObject<{
         category: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        description?: string | undefined;
         source?: string | undefined;
+        description?: string | undefined;
         category?: string | undefined;
     }, {
         name: string;
-        description?: string | undefined;
         source?: string | undefined;
+        description?: string | undefined;
         category?: string | undefined;
     }>, "many">;
     toolCategories: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
@@ -1810,8 +2427,8 @@ export declare const AgentProfileSchema: z.ZodObject<{
     tools: string[];
     skills: {
         name: string;
-        description?: string | undefined;
         source?: string | undefined;
+        description?: string | undefined;
         category?: string | undefined;
     }[];
     toolCategories: Record<string, string[]>;
@@ -1821,8 +2438,8 @@ export declare const AgentProfileSchema: z.ZodObject<{
     tools: string[];
     skills: {
         name: string;
-        description?: string | undefined;
         source?: string | undefined;
+        description?: string | undefined;
         category?: string | undefined;
     }[];
     toolCategories: Record<string, string[]>;
@@ -1840,13 +2457,13 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
             category: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             name: string;
-            description?: string | undefined;
             source?: string | undefined;
+            description?: string | undefined;
             category?: string | undefined;
         }, {
             name: string;
-            description?: string | undefined;
             source?: string | undefined;
+            description?: string | undefined;
             category?: string | undefined;
         }>, "many">;
         toolCategories: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
@@ -1856,8 +2473,8 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
         tools: string[];
         skills: {
             name: string;
-            description?: string | undefined;
             source?: string | undefined;
+            description?: string | undefined;
             category?: string | undefined;
         }[];
         toolCategories: Record<string, string[]>;
@@ -1867,8 +2484,8 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
         tools: string[];
         skills: {
             name: string;
-            description?: string | undefined;
             source?: string | undefined;
+            description?: string | undefined;
             category?: string | undefined;
         }[];
         toolCategories: Record<string, string[]>;
@@ -1880,8 +2497,8 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
         tools: string[];
         skills: {
             name: string;
-            description?: string | undefined;
             source?: string | undefined;
+            description?: string | undefined;
             category?: string | undefined;
         }[];
         toolCategories: Record<string, string[]>;
@@ -1893,8 +2510,8 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
         tools: string[];
         skills: {
             name: string;
-            description?: string | undefined;
             source?: string | undefined;
+            description?: string | undefined;
             category?: string | undefined;
         }[];
         toolCategories: Record<string, string[]>;