@winmatrix/protocol 1.0.4 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. package/dist/agent-engine-host-wire-fixtures.json +95 -0
  2. package/dist/agent-engine-host-wire-schema.json +1063 -0
  3. package/dist/agentEngine.d.ts +7491 -0
  4. package/dist/agentEngine.d.ts.map +1 -0
  5. package/dist/agentEngine.js +649 -0
  6. package/dist/agentEngine.js.map +1 -0
  7. package/dist/constants.d.ts +13 -0
  8. package/dist/constants.d.ts.map +1 -1
  9. package/dist/constants.js +15 -0
  10. package/dist/constants.js.map +1 -1
  11. package/dist/helpers.d.ts +20 -0
  12. package/dist/helpers.d.ts.map +1 -1
  13. package/dist/helpers.js +64 -0
  14. package/dist/helpers.js.map +1 -1
  15. package/dist/index.d.ts +1 -0
  16. package/dist/index.d.ts.map +1 -1
  17. package/dist/index.js +1 -0
  18. package/dist/index.js.map +1 -1
  19. package/dist/schemas.d.ts +605 -37
  20. package/dist/schemas.d.ts.map +1 -1
  21. package/dist/schemas.js +108 -1
  22. package/dist/schemas.js.map +1 -1
  23. package/package.json +6 -3
package/dist/schemas.d.ts CHANGED
@@ -339,7 +339,91 @@ export type TaskAssignParams = z.infer<typeof TaskAssignParamsSchema>;
339
339
  export declare const EngineIdSchema: z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>;
340
340
  export declare const HostKindSchema: z.ZodEnum<["workstation", "external_computer"]>;
341
341
  export declare const HostProfileSchema: z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>;
342
- export declare const EngineToolNameSchema: z.ZodEnum<["coding_task", "sre_skill_task", "workstation_execute", "external_agent_task"]>;
342
+ export declare const EngineToolNameSchema: z.ZodEnum<["coding_task", "sre_skill_task", "workstation_execute", "external_agent_task", "execute_task"]>;
343
+ /** 本次 Run 实际协商出的执行耐久等级（静态 capability 只表达最大可能集合）。 */
344
+ export declare const ExecutionDurabilitySchema: z.ZodEnum<["connection_bound", "host_persistent"]>;
345
+ /** 事件恢复等级（递进能力）：live_only < replay < snapshot_fallback。 */
346
+ export declare const EventStreamModeSchema: z.ZodEnum<["live_only", "replay", "snapshot_fallback"]>;
347
+ export declare const EventRetentionSchema: z.ZodObject<{
348
+ maxEvents: z.ZodOptional<z.ZodNumber>;
349
+ maxAgeSeconds: z.ZodOptional<z.ZodNumber>;
350
+ }, "strip", z.ZodTypeAny, {
351
+ maxEvents?: number | undefined;
352
+ maxAgeSeconds?: number | undefined;
353
+ }, {
354
+ maxEvents?: number | undefined;
355
+ maxAgeSeconds?: number | undefined;
356
+ }>;
357
+ export declare const EngineContentBlockKindSchema: z.ZodEnum<["text", "image_ref", "file_ref", "resource_ref"]>;
358
+ /** 跨 Engine 标准 Hook 阶段；Engine Adapter 只声明真实支持的映射。 */
359
+ 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"]>;
360
+ /** 内部受治理 Hook Profile 引用；只允许出现在 canonical LaunchSpec 与 Host wire DTO。 */
361
+ export declare const EngineHookProfileRefSchema: z.ZodObject<{
362
+ profileId: z.ZodString;
363
+ version: z.ZodString;
364
+ policyRevision: z.ZodString;
365
+ }, "strip", z.ZodTypeAny, {
366
+ profileId: string;
367
+ version: string;
368
+ policyRevision: string;
369
+ }, {
370
+ profileId: string;
371
+ version: string;
372
+ policyRevision: string;
373
+ }>;
374
+ /** Host/daemon 内部 capability 声明用：已安装的 Profile 及策略版本。 */
375
+ export declare const EngineHookProfileDescriptorSchema: z.ZodObject<{
376
+ ref: z.ZodObject<{
377
+ profileId: z.ZodString;
378
+ version: z.ZodString;
379
+ policyRevision: z.ZodString;
380
+ }, "strip", z.ZodTypeAny, {
381
+ profileId: string;
382
+ version: string;
383
+ policyRevision: string;
384
+ }, {
385
+ profileId: string;
386
+ version: string;
387
+ policyRevision: string;
388
+ }>;
389
+ 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">;
390
+ blocking: z.ZodEnum<["never", "allow_deny", "interaction"]>;
391
+ timeoutMs: z.ZodNumber;
392
+ failureMode: z.ZodEnum<["fail_closed", "fail_open", "report_only"]>;
393
+ }, "strip", z.ZodTypeAny, {
394
+ ref: {
395
+ profileId: string;
396
+ version: string;
397
+ policyRevision: string;
398
+ };
399
+ 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")[];
400
+ blocking: "never" | "allow_deny" | "interaction";
401
+ timeoutMs: number;
402
+ failureMode: "fail_closed" | "fail_open" | "report_only";
403
+ }, {
404
+ ref: {
405
+ profileId: string;
406
+ version: string;
407
+ policyRevision: string;
408
+ };
409
+ 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")[];
410
+ blocking: "never" | "allow_deny" | "interaction";
411
+ timeoutMs: number;
412
+ failureMode: "fail_closed" | "fail_open" | "report_only";
413
+ }>;
414
+ export declare const EngineInteractionOptionSchema: z.ZodObject<{
415
+ optionId: z.ZodString;
416
+ label: z.ZodString;
417
+ semantic: z.ZodOptional<z.ZodEnum<["allow_once", "allow_session", "deny", "custom"]>>;
418
+ }, "strip", z.ZodTypeAny, {
419
+ optionId: string;
420
+ label: string;
421
+ semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
422
+ }, {
423
+ optionId: string;
424
+ label: string;
425
+ semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
426
+ }>;
343
427
  export declare const EngineCapabilityProfileSchema: z.ZodObject<{
344
428
  engineId: z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>;
345
429
  hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
@@ -360,6 +444,74 @@ export declare const EngineCapabilityProfileSchema: z.ZodObject<{
360
444
  resume?: string | undefined;
361
445
  }>>;
362
446
  unavailableReason: z.ZodOptional<z.ZodString>;
447
+ /** 最大静态耐久能力集合；具体 Run 的实际 durability 由 launch ack/snapshot 表达。 */
448
+ supportedExecutionDurability: z.ZodOptional<z.ZodArray<z.ZodEnum<["connection_bound", "host_persistent"]>, "many">>;
449
+ supportsInteractionResponse: z.ZodOptional<z.ZodBoolean>;
450
+ /** 只描述 startRun() 初始输入 block 类型，不表示支持运行中追加普通消息。 */
451
+ supportedInputKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["text", "image_ref", "file_ref", "resource_ref"]>, "many">>;
452
+ permissionModes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
453
+ supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
454
+ supportsModelSelection: z.ZodOptional<z.ZodBoolean>;
455
+ supportsEngineOptionDiscovery: z.ZodOptional<z.ZodBoolean>;
456
+ /** 内部启动协商用，不属于用户可选 Engine options。 */
457
+ supportedEngineHookProfiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
458
+ ref: z.ZodObject<{
459
+ profileId: z.ZodString;
460
+ version: z.ZodString;
461
+ policyRevision: z.ZodString;
462
+ }, "strip", z.ZodTypeAny, {
463
+ profileId: string;
464
+ version: string;
465
+ policyRevision: string;
466
+ }, {
467
+ profileId: string;
468
+ version: string;
469
+ policyRevision: string;
470
+ }>;
471
+ 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">;
472
+ blocking: z.ZodEnum<["never", "allow_deny", "interaction"]>;
473
+ timeoutMs: z.ZodNumber;
474
+ failureMode: z.ZodEnum<["fail_closed", "fail_open", "report_only"]>;
475
+ }, "strip", z.ZodTypeAny, {
476
+ ref: {
477
+ profileId: string;
478
+ version: string;
479
+ policyRevision: string;
480
+ };
481
+ 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")[];
482
+ blocking: "never" | "allow_deny" | "interaction";
483
+ timeoutMs: number;
484
+ failureMode: "fail_closed" | "fail_open" | "report_only";
485
+ }, {
486
+ ref: {
487
+ profileId: string;
488
+ version: string;
489
+ policyRevision: string;
490
+ };
491
+ 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")[];
492
+ blocking: "never" | "allow_deny" | "interaction";
493
+ timeoutMs: number;
494
+ failureMode: "fail_closed" | "fail_open" | "report_only";
495
+ }>, "many">>;
496
+ eventStreamMode: z.ZodOptional<z.ZodEnum<["live_only", "replay", "snapshot_fallback"]>>;
497
+ eventRetention: z.ZodOptional<z.ZodObject<{
498
+ maxEvents: z.ZodOptional<z.ZodNumber>;
499
+ maxAgeSeconds: z.ZodOptional<z.ZodNumber>;
500
+ }, "strip", z.ZodTypeAny, {
501
+ maxEvents?: number | undefined;
502
+ maxAgeSeconds?: number | undefined;
503
+ }, {
504
+ maxEvents?: number | undefined;
505
+ maxAgeSeconds?: number | undefined;
506
+ }>>;
507
+ supportsSessionList: z.ZodOptional<z.ZodBoolean>;
508
+ supportsSessionGet: z.ZodOptional<z.ZodBoolean>;
509
+ supportsSessionSearch: z.ZodOptional<z.ZodBoolean>;
510
+ supportsSessionDelete: z.ZodOptional<z.ZodBoolean>;
511
+ supportsSessionResume: z.ZodOptional<z.ZodBoolean>;
512
+ supportsSessionFork: z.ZodOptional<z.ZodBoolean>;
513
+ /** 旧字段：兼容期仅映射为 eventStreamMode='live_only'，不得据此宣称 replay。 */
514
+ supportsReconnectableStream: z.ZodOptional<z.ZodBoolean>;
363
515
  }, "strip", z.ZodTypeAny, {
364
516
  streaming: boolean;
365
517
  toolCall: boolean;
@@ -374,6 +526,36 @@ export declare const EngineCapabilityProfileSchema: z.ZodObject<{
374
526
  resume?: string | undefined;
375
527
  } | undefined;
376
528
  unavailableReason?: string | undefined;
529
+ supportedExecutionDurability?: ("connection_bound" | "host_persistent")[] | undefined;
530
+ supportsInteractionResponse?: boolean | undefined;
531
+ supportedInputKinds?: ("text" | "image_ref" | "file_ref" | "resource_ref")[] | undefined;
532
+ permissionModes?: string[] | undefined;
533
+ supportsReasoningEffort?: boolean | undefined;
534
+ supportsModelSelection?: boolean | undefined;
535
+ supportsEngineOptionDiscovery?: boolean | undefined;
536
+ supportedEngineHookProfiles?: {
537
+ ref: {
538
+ profileId: string;
539
+ version: string;
540
+ policyRevision: string;
541
+ };
542
+ 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")[];
543
+ blocking: "never" | "allow_deny" | "interaction";
544
+ timeoutMs: number;
545
+ failureMode: "fail_closed" | "fail_open" | "report_only";
546
+ }[] | undefined;
547
+ eventStreamMode?: "live_only" | "replay" | "snapshot_fallback" | undefined;
548
+ eventRetention?: {
549
+ maxEvents?: number | undefined;
550
+ maxAgeSeconds?: number | undefined;
551
+ } | undefined;
552
+ supportsSessionList?: boolean | undefined;
553
+ supportsSessionGet?: boolean | undefined;
554
+ supportsSessionSearch?: boolean | undefined;
555
+ supportsSessionDelete?: boolean | undefined;
556
+ supportsSessionResume?: boolean | undefined;
557
+ supportsSessionFork?: boolean | undefined;
558
+ supportsReconnectableStream?: boolean | undefined;
377
559
  }, {
378
560
  streaming: boolean;
379
561
  toolCall: boolean;
@@ -388,13 +570,48 @@ export declare const EngineCapabilityProfileSchema: z.ZodObject<{
388
570
  resume?: string | undefined;
389
571
  } | undefined;
390
572
  unavailableReason?: string | undefined;
573
+ supportedExecutionDurability?: ("connection_bound" | "host_persistent")[] | undefined;
574
+ supportsInteractionResponse?: boolean | undefined;
575
+ supportedInputKinds?: ("text" | "image_ref" | "file_ref" | "resource_ref")[] | undefined;
576
+ permissionModes?: string[] | undefined;
577
+ supportsReasoningEffort?: boolean | undefined;
578
+ supportsModelSelection?: boolean | undefined;
579
+ supportsEngineOptionDiscovery?: boolean | undefined;
580
+ supportedEngineHookProfiles?: {
581
+ ref: {
582
+ profileId: string;
583
+ version: string;
584
+ policyRevision: string;
585
+ };
586
+ 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")[];
587
+ blocking: "never" | "allow_deny" | "interaction";
588
+ timeoutMs: number;
589
+ failureMode: "fail_closed" | "fail_open" | "report_only";
590
+ }[] | undefined;
591
+ eventStreamMode?: "live_only" | "replay" | "snapshot_fallback" | undefined;
592
+ eventRetention?: {
593
+ maxEvents?: number | undefined;
594
+ maxAgeSeconds?: number | undefined;
595
+ } | undefined;
596
+ supportsSessionList?: boolean | undefined;
597
+ supportsSessionGet?: boolean | undefined;
598
+ supportsSessionSearch?: boolean | undefined;
599
+ supportsSessionDelete?: boolean | undefined;
600
+ supportsSessionResume?: boolean | undefined;
601
+ supportsSessionFork?: boolean | undefined;
602
+ supportsReconnectableStream?: boolean | undefined;
391
603
  }>;
392
- export declare const EngineInvocationPlanSchema: z.ZodObject<{
604
+ /**
605
+ * V1 调用计划（字符串 input）。现有 shape 固定为 V1，不得原地改成对象；
606
+ * 结构化输入请使用 EngineInvocationPlanV2Schema（见 agentEngine.ts）。
607
+ * env 仅允许非敏感、可序列化配置；secret 走 Host 私有 binding。
608
+ */
609
+ export declare const EngineInvocationPlanV1Schema: z.ZodObject<{
393
610
  taskId: z.ZodString;
394
611
  engineId: z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>;
395
612
  hostKind: z.ZodEnum<["workstation", "external_computer"]>;
396
613
  hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
397
- toolName: z.ZodEnum<["coding_task", "sre_skill_task", "workstation_execute", "external_agent_task"]>;
614
+ toolName: z.ZodEnum<["coding_task", "sre_skill_task", "workstation_execute", "external_agent_task", "execute_task"]>;
398
615
  input: z.ZodString;
399
616
  workDir: z.ZodOptional<z.ZodString>;
400
617
  timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -408,13 +625,13 @@ export declare const EngineInvocationPlanSchema: z.ZodObject<{
408
625
  input: string;
409
626
  engineId: "custom" | "claude-code" | "codex" | "hermes" | "openclaw";
410
627
  hostKind: "workstation" | "external_computer";
411
- toolName: "coding_task" | "sre_skill_task" | "workstation_execute" | "external_agent_task";
628
+ toolName: "coding_task" | "sre_skill_task" | "workstation_execute" | "external_agent_task" | "execute_task";
412
629
  allowedTools?: string[] | undefined;
413
630
  sessionId?: string | undefined;
631
+ timeoutMs?: number | undefined;
414
632
  hostProfile?: string | undefined;
415
633
  resume?: boolean | undefined;
416
634
  workDir?: string | undefined;
417
- timeoutMs?: number | undefined;
418
635
  env?: Record<string, string> | undefined;
419
636
  artifactPolicy?: Record<string, unknown> | undefined;
420
637
  }, {
@@ -422,29 +639,74 @@ export declare const EngineInvocationPlanSchema: z.ZodObject<{
422
639
  input: string;
423
640
  engineId: "custom" | "claude-code" | "codex" | "hermes" | "openclaw";
424
641
  hostKind: "workstation" | "external_computer";
425
- toolName: "coding_task" | "sre_skill_task" | "workstation_execute" | "external_agent_task";
642
+ toolName: "coding_task" | "sre_skill_task" | "workstation_execute" | "external_agent_task" | "execute_task";
426
643
  allowedTools?: string[] | undefined;
427
644
  sessionId?: string | undefined;
645
+ timeoutMs?: number | undefined;
428
646
  hostProfile?: string | undefined;
429
647
  resume?: boolean | undefined;
430
648
  workDir?: string | undefined;
431
- timeoutMs?: number | undefined;
432
649
  env?: Record<string, string> | undefined;
433
650
  artifactPolicy?: Record<string, unknown> | undefined;
434
651
  }>;
435
- export declare const EngineProgressEventTypeSchema: z.ZodEnum<["status", "content_delta", "thinking_delta", "tool_call", "tool_result_delta", "stderr_delta", "artifact", "usage", "result", "error"]>;
652
+ 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"]>;
436
653
  export declare const EngineUsageSchema: z.ZodObject<{
437
654
  inputTokens: z.ZodOptional<z.ZodNumber>;
438
655
  outputTokens: z.ZodOptional<z.ZodNumber>;
439
656
  thinkingTokens: z.ZodOptional<z.ZodNumber>;
657
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
658
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
659
+ totalTokens: z.ZodOptional<z.ZodNumber>;
660
+ }, "strip", z.ZodTypeAny, {
661
+ inputTokens?: number | undefined;
662
+ outputTokens?: number | undefined;
663
+ thinkingTokens?: number | undefined;
664
+ cacheReadInputTokens?: number | undefined;
665
+ cacheCreationInputTokens?: number | undefined;
666
+ totalTokens?: number | undefined;
667
+ }, {
668
+ inputTokens?: number | undefined;
669
+ outputTokens?: number | undefined;
670
+ thinkingTokens?: number | undefined;
671
+ cacheReadInputTokens?: number | undefined;
672
+ cacheCreationInputTokens?: number | undefined;
673
+ totalTokens?: number | undefined;
674
+ }>;
675
+ /**
676
+ * D11.4: Token usage with acquisition source tracking.
677
+ * Each PodEngineDriver tries multiple paths (primary_event → session_log_scan → unknown)
678
+ * and records which path succeeded.
679
+ */
680
+ export declare const EngineTokenUsageSchema: z.ZodObject<{
681
+ inputTokens: z.ZodOptional<z.ZodNumber>;
682
+ outputTokens: z.ZodOptional<z.ZodNumber>;
683
+ thinkingTokens: z.ZodOptional<z.ZodNumber>;
684
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
685
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
686
+ totalTokens: z.ZodOptional<z.ZodNumber>;
687
+ } & {
688
+ /** How this usage was obtained */
689
+ source: z.ZodDefault<z.ZodEnum<["primary_event", "session_log_scan", "unknown"]>>;
690
+ /** Engine-specific raw usage data for diagnostics */
691
+ raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
440
692
  }, "strip", z.ZodTypeAny, {
693
+ source: "unknown" | "primary_event" | "session_log_scan";
441
694
  inputTokens?: number | undefined;
442
695
  outputTokens?: number | undefined;
443
696
  thinkingTokens?: number | undefined;
697
+ cacheReadInputTokens?: number | undefined;
698
+ cacheCreationInputTokens?: number | undefined;
699
+ totalTokens?: number | undefined;
700
+ raw?: Record<string, unknown> | undefined;
444
701
  }, {
445
702
  inputTokens?: number | undefined;
446
703
  outputTokens?: number | undefined;
447
704
  thinkingTokens?: number | undefined;
705
+ cacheReadInputTokens?: number | undefined;
706
+ cacheCreationInputTokens?: number | undefined;
707
+ totalTokens?: number | undefined;
708
+ source?: "unknown" | "primary_event" | "session_log_scan" | undefined;
709
+ raw?: Record<string, unknown> | undefined;
448
710
  }>;
449
711
  export declare const EngineFinalResultSchema: z.ZodObject<{
450
712
  success: z.ZodBoolean;
@@ -455,14 +717,23 @@ export declare const EngineFinalResultSchema: z.ZodObject<{
455
717
  inputTokens: z.ZodOptional<z.ZodNumber>;
456
718
  outputTokens: z.ZodOptional<z.ZodNumber>;
457
719
  thinkingTokens: z.ZodOptional<z.ZodNumber>;
720
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
721
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
722
+ totalTokens: z.ZodOptional<z.ZodNumber>;
458
723
  }, "strip", z.ZodTypeAny, {
459
724
  inputTokens?: number | undefined;
460
725
  outputTokens?: number | undefined;
461
726
  thinkingTokens?: number | undefined;
727
+ cacheReadInputTokens?: number | undefined;
728
+ cacheCreationInputTokens?: number | undefined;
729
+ totalTokens?: number | undefined;
462
730
  }, {
463
731
  inputTokens?: number | undefined;
464
732
  outputTokens?: number | undefined;
465
733
  thinkingTokens?: number | undefined;
734
+ cacheReadInputTokens?: number | undefined;
735
+ cacheCreationInputTokens?: number | undefined;
736
+ totalTokens?: number | undefined;
466
737
  }>>;
467
738
  error: z.ZodOptional<z.ZodString>;
468
739
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -470,24 +741,30 @@ export declare const EngineFinalResultSchema: z.ZodObject<{
470
741
  success: boolean;
471
742
  error?: string | undefined;
472
743
  sessionId?: string | undefined;
744
+ text?: string | undefined;
473
745
  usage?: {
474
746
  inputTokens?: number | undefined;
475
747
  outputTokens?: number | undefined;
476
748
  thinkingTokens?: number | undefined;
749
+ cacheReadInputTokens?: number | undefined;
750
+ cacheCreationInputTokens?: number | undefined;
751
+ totalTokens?: number | undefined;
477
752
  } | undefined;
478
- text?: string | undefined;
479
753
  artifacts?: Record<string, unknown>[] | undefined;
480
754
  metadata?: Record<string, unknown> | undefined;
481
755
  }, {
482
756
  success: boolean;
483
757
  error?: string | undefined;
484
758
  sessionId?: string | undefined;
759
+ text?: string | undefined;
485
760
  usage?: {
486
761
  inputTokens?: number | undefined;
487
762
  outputTokens?: number | undefined;
488
763
  thinkingTokens?: number | undefined;
764
+ cacheReadInputTokens?: number | undefined;
765
+ cacheCreationInputTokens?: number | undefined;
766
+ totalTokens?: number | undefined;
489
767
  } | undefined;
490
- text?: string | undefined;
491
768
  artifacts?: Record<string, unknown>[] | undefined;
492
769
  metadata?: Record<string, unknown> | undefined;
493
770
  }>;
@@ -622,17 +899,17 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
622
899
  }, "strip", z.ZodTypeAny, {
623
900
  type: "artifact";
624
901
  path: string;
902
+ label?: string | undefined;
625
903
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
626
904
  hostKind?: "workstation" | "external_computer" | undefined;
627
905
  hostProfile?: string | undefined;
628
- label?: string | undefined;
629
906
  }, {
630
907
  type: "artifact";
631
908
  path: string;
909
+ label?: string | undefined;
632
910
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
633
911
  hostKind?: "workstation" | "external_computer" | undefined;
634
912
  hostProfile?: string | undefined;
635
- label?: string | undefined;
636
913
  }>, z.ZodObject<{
637
914
  engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
638
915
  hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
@@ -643,14 +920,23 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
643
920
  inputTokens: z.ZodOptional<z.ZodNumber>;
644
921
  outputTokens: z.ZodOptional<z.ZodNumber>;
645
922
  thinkingTokens: z.ZodOptional<z.ZodNumber>;
923
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
924
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
925
+ totalTokens: z.ZodOptional<z.ZodNumber>;
646
926
  }, "strip", z.ZodTypeAny, {
647
927
  inputTokens?: number | undefined;
648
928
  outputTokens?: number | undefined;
649
929
  thinkingTokens?: number | undefined;
930
+ cacheReadInputTokens?: number | undefined;
931
+ cacheCreationInputTokens?: number | undefined;
932
+ totalTokens?: number | undefined;
650
933
  }, {
651
934
  inputTokens?: number | undefined;
652
935
  outputTokens?: number | undefined;
653
936
  thinkingTokens?: number | undefined;
937
+ cacheReadInputTokens?: number | undefined;
938
+ cacheCreationInputTokens?: number | undefined;
939
+ totalTokens?: number | undefined;
654
940
  }>;
655
941
  }, "strip", z.ZodTypeAny, {
656
942
  type: "usage";
@@ -658,6 +944,9 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
658
944
  inputTokens?: number | undefined;
659
945
  outputTokens?: number | undefined;
660
946
  thinkingTokens?: number | undefined;
947
+ cacheReadInputTokens?: number | undefined;
948
+ cacheCreationInputTokens?: number | undefined;
949
+ totalTokens?: number | undefined;
661
950
  };
662
951
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
663
952
  hostKind?: "workstation" | "external_computer" | undefined;
@@ -668,6 +957,9 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
668
957
  inputTokens?: number | undefined;
669
958
  outputTokens?: number | undefined;
670
959
  thinkingTokens?: number | undefined;
960
+ cacheReadInputTokens?: number | undefined;
961
+ cacheCreationInputTokens?: number | undefined;
962
+ totalTokens?: number | undefined;
671
963
  };
672
964
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
673
965
  hostKind?: "workstation" | "external_computer" | undefined;
@@ -687,14 +979,23 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
687
979
  inputTokens: z.ZodOptional<z.ZodNumber>;
688
980
  outputTokens: z.ZodOptional<z.ZodNumber>;
689
981
  thinkingTokens: z.ZodOptional<z.ZodNumber>;
982
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
983
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
984
+ totalTokens: z.ZodOptional<z.ZodNumber>;
690
985
  }, "strip", z.ZodTypeAny, {
691
986
  inputTokens?: number | undefined;
692
987
  outputTokens?: number | undefined;
693
988
  thinkingTokens?: number | undefined;
989
+ cacheReadInputTokens?: number | undefined;
990
+ cacheCreationInputTokens?: number | undefined;
991
+ totalTokens?: number | undefined;
694
992
  }, {
695
993
  inputTokens?: number | undefined;
696
994
  outputTokens?: number | undefined;
697
995
  thinkingTokens?: number | undefined;
996
+ cacheReadInputTokens?: number | undefined;
997
+ cacheCreationInputTokens?: number | undefined;
998
+ totalTokens?: number | undefined;
698
999
  }>>;
699
1000
  error: z.ZodOptional<z.ZodString>;
700
1001
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -702,24 +1003,30 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
702
1003
  success: boolean;
703
1004
  error?: string | undefined;
704
1005
  sessionId?: string | undefined;
1006
+ text?: string | undefined;
705
1007
  usage?: {
706
1008
  inputTokens?: number | undefined;
707
1009
  outputTokens?: number | undefined;
708
1010
  thinkingTokens?: number | undefined;
1011
+ cacheReadInputTokens?: number | undefined;
1012
+ cacheCreationInputTokens?: number | undefined;
1013
+ totalTokens?: number | undefined;
709
1014
  } | undefined;
710
- text?: string | undefined;
711
1015
  artifacts?: Record<string, unknown>[] | undefined;
712
1016
  metadata?: Record<string, unknown> | undefined;
713
1017
  }, {
714
1018
  success: boolean;
715
1019
  error?: string | undefined;
716
1020
  sessionId?: string | undefined;
1021
+ text?: string | undefined;
717
1022
  usage?: {
718
1023
  inputTokens?: number | undefined;
719
1024
  outputTokens?: number | undefined;
720
1025
  thinkingTokens?: number | undefined;
1026
+ cacheReadInputTokens?: number | undefined;
1027
+ cacheCreationInputTokens?: number | undefined;
1028
+ totalTokens?: number | undefined;
721
1029
  } | undefined;
722
- text?: string | undefined;
723
1030
  artifacts?: Record<string, unknown>[] | undefined;
724
1031
  metadata?: Record<string, unknown> | undefined;
725
1032
  }>;
@@ -729,12 +1036,15 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
729
1036
  success: boolean;
730
1037
  error?: string | undefined;
731
1038
  sessionId?: string | undefined;
1039
+ text?: string | undefined;
732
1040
  usage?: {
733
1041
  inputTokens?: number | undefined;
734
1042
  outputTokens?: number | undefined;
735
1043
  thinkingTokens?: number | undefined;
1044
+ cacheReadInputTokens?: number | undefined;
1045
+ cacheCreationInputTokens?: number | undefined;
1046
+ totalTokens?: number | undefined;
736
1047
  } | undefined;
737
- text?: string | undefined;
738
1048
  artifacts?: Record<string, unknown>[] | undefined;
739
1049
  metadata?: Record<string, unknown> | undefined;
740
1050
  };
@@ -747,12 +1057,15 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
747
1057
  success: boolean;
748
1058
  error?: string | undefined;
749
1059
  sessionId?: string | undefined;
1060
+ text?: string | undefined;
750
1061
  usage?: {
751
1062
  inputTokens?: number | undefined;
752
1063
  outputTokens?: number | undefined;
753
1064
  thinkingTokens?: number | undefined;
1065
+ cacheReadInputTokens?: number | undefined;
1066
+ cacheCreationInputTokens?: number | undefined;
1067
+ totalTokens?: number | undefined;
754
1068
  } | undefined;
755
- text?: string | undefined;
756
1069
  artifacts?: Record<string, unknown>[] | undefined;
757
1070
  metadata?: Record<string, unknown> | undefined;
758
1071
  };
@@ -781,6 +1094,83 @@ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type",
781
1094
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
782
1095
  hostKind?: "workstation" | "external_computer" | undefined;
783
1096
  hostProfile?: string | undefined;
1097
+ }>, z.ZodObject<{
1098
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1099
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1100
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1101
+ } & {
1102
+ type: z.ZodLiteral<"interaction_requested">;
1103
+ interactionId: z.ZodString;
1104
+ interactionType: z.ZodEnum<["permission", "confirmation", "question", "selection"]>;
1105
+ /** 最小必要的用户决策说明；不得包含 Engine 内部思考或 secret。 */
1106
+ prompt: z.ZodString;
1107
+ options: z.ZodArray<z.ZodObject<{
1108
+ optionId: z.ZodString;
1109
+ label: z.ZodString;
1110
+ semantic: z.ZodOptional<z.ZodEnum<["allow_once", "allow_session", "deny", "custom"]>>;
1111
+ }, "strip", z.ZodTypeAny, {
1112
+ optionId: string;
1113
+ label: string;
1114
+ semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
1115
+ }, {
1116
+ optionId: string;
1117
+ label: string;
1118
+ semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
1119
+ }>, "many">;
1120
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
1121
+ }, "strip", z.ZodTypeAny, {
1122
+ type: "interaction_requested";
1123
+ options: {
1124
+ optionId: string;
1125
+ label: string;
1126
+ semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
1127
+ }[];
1128
+ interactionId: string;
1129
+ interactionType: "permission" | "confirmation" | "question" | "selection";
1130
+ prompt: string;
1131
+ timeoutMs?: number | undefined;
1132
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1133
+ hostKind?: "workstation" | "external_computer" | undefined;
1134
+ hostProfile?: string | undefined;
1135
+ }, {
1136
+ type: "interaction_requested";
1137
+ options: {
1138
+ optionId: string;
1139
+ label: string;
1140
+ semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
1141
+ }[];
1142
+ interactionId: string;
1143
+ interactionType: "permission" | "confirmation" | "question" | "selection";
1144
+ prompt: string;
1145
+ timeoutMs?: number | undefined;
1146
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1147
+ hostKind?: "workstation" | "external_computer" | undefined;
1148
+ hostProfile?: string | undefined;
1149
+ }>, z.ZodObject<{
1150
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1151
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1152
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1153
+ } & {
1154
+ type: z.ZodLiteral<"interaction_resolved">;
1155
+ interactionId: z.ZodString;
1156
+ responseId: z.ZodOptional<z.ZodString>;
1157
+ resolution: z.ZodEnum<["accepted", "rejected", "answered", "expired"]>;
1158
+ }, "strip", z.ZodTypeAny, {
1159
+ type: "interaction_resolved";
1160
+ interactionId: string;
1161
+ resolution: "accepted" | "rejected" | "answered" | "expired";
1162
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1163
+ hostKind?: "workstation" | "external_computer" | undefined;
1164
+ hostProfile?: string | undefined;
1165
+ responseId?: string | undefined;
1166
+ }, {
1167
+ type: "interaction_resolved";
1168
+ interactionId: string;
1169
+ resolution: "accepted" | "rejected" | "answered" | "expired";
1170
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1171
+ hostKind?: "workstation" | "external_computer" | undefined;
1172
+ hostProfile?: string | undefined;
1173
+ responseId?: string | undefined;
784
1174
  }>]>;
785
1175
  export declare const TaskDeltaEventSchema: z.ZodObject<{
786
1176
  taskId: z.ZodString;
@@ -917,17 +1307,17 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
917
1307
  }, "strip", z.ZodTypeAny, {
918
1308
  type: "artifact";
919
1309
  path: string;
1310
+ label?: string | undefined;
920
1311
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
921
1312
  hostKind?: "workstation" | "external_computer" | undefined;
922
1313
  hostProfile?: string | undefined;
923
- label?: string | undefined;
924
1314
  }, {
925
1315
  type: "artifact";
926
1316
  path: string;
1317
+ label?: string | undefined;
927
1318
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
928
1319
  hostKind?: "workstation" | "external_computer" | undefined;
929
1320
  hostProfile?: string | undefined;
930
- label?: string | undefined;
931
1321
  }>, z.ZodObject<{
932
1322
  engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
933
1323
  hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
@@ -938,14 +1328,23 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
938
1328
  inputTokens: z.ZodOptional<z.ZodNumber>;
939
1329
  outputTokens: z.ZodOptional<z.ZodNumber>;
940
1330
  thinkingTokens: z.ZodOptional<z.ZodNumber>;
1331
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
1332
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
1333
+ totalTokens: z.ZodOptional<z.ZodNumber>;
941
1334
  }, "strip", z.ZodTypeAny, {
942
1335
  inputTokens?: number | undefined;
943
1336
  outputTokens?: number | undefined;
944
1337
  thinkingTokens?: number | undefined;
1338
+ cacheReadInputTokens?: number | undefined;
1339
+ cacheCreationInputTokens?: number | undefined;
1340
+ totalTokens?: number | undefined;
945
1341
  }, {
946
1342
  inputTokens?: number | undefined;
947
1343
  outputTokens?: number | undefined;
948
1344
  thinkingTokens?: number | undefined;
1345
+ cacheReadInputTokens?: number | undefined;
1346
+ cacheCreationInputTokens?: number | undefined;
1347
+ totalTokens?: number | undefined;
949
1348
  }>;
950
1349
  }, "strip", z.ZodTypeAny, {
951
1350
  type: "usage";
@@ -953,6 +1352,9 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
953
1352
  inputTokens?: number | undefined;
954
1353
  outputTokens?: number | undefined;
955
1354
  thinkingTokens?: number | undefined;
1355
+ cacheReadInputTokens?: number | undefined;
1356
+ cacheCreationInputTokens?: number | undefined;
1357
+ totalTokens?: number | undefined;
956
1358
  };
957
1359
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
958
1360
  hostKind?: "workstation" | "external_computer" | undefined;
@@ -963,6 +1365,9 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
963
1365
  inputTokens?: number | undefined;
964
1366
  outputTokens?: number | undefined;
965
1367
  thinkingTokens?: number | undefined;
1368
+ cacheReadInputTokens?: number | undefined;
1369
+ cacheCreationInputTokens?: number | undefined;
1370
+ totalTokens?: number | undefined;
966
1371
  };
967
1372
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
968
1373
  hostKind?: "workstation" | "external_computer" | undefined;
@@ -982,14 +1387,23 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
982
1387
  inputTokens: z.ZodOptional<z.ZodNumber>;
983
1388
  outputTokens: z.ZodOptional<z.ZodNumber>;
984
1389
  thinkingTokens: z.ZodOptional<z.ZodNumber>;
1390
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
1391
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
1392
+ totalTokens: z.ZodOptional<z.ZodNumber>;
985
1393
  }, "strip", z.ZodTypeAny, {
986
1394
  inputTokens?: number | undefined;
987
1395
  outputTokens?: number | undefined;
988
1396
  thinkingTokens?: number | undefined;
1397
+ cacheReadInputTokens?: number | undefined;
1398
+ cacheCreationInputTokens?: number | undefined;
1399
+ totalTokens?: number | undefined;
989
1400
  }, {
990
1401
  inputTokens?: number | undefined;
991
1402
  outputTokens?: number | undefined;
992
1403
  thinkingTokens?: number | undefined;
1404
+ cacheReadInputTokens?: number | undefined;
1405
+ cacheCreationInputTokens?: number | undefined;
1406
+ totalTokens?: number | undefined;
993
1407
  }>>;
994
1408
  error: z.ZodOptional<z.ZodString>;
995
1409
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -997,24 +1411,30 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
997
1411
  success: boolean;
998
1412
  error?: string | undefined;
999
1413
  sessionId?: string | undefined;
1414
+ text?: string | undefined;
1000
1415
  usage?: {
1001
1416
  inputTokens?: number | undefined;
1002
1417
  outputTokens?: number | undefined;
1003
1418
  thinkingTokens?: number | undefined;
1419
+ cacheReadInputTokens?: number | undefined;
1420
+ cacheCreationInputTokens?: number | undefined;
1421
+ totalTokens?: number | undefined;
1004
1422
  } | undefined;
1005
- text?: string | undefined;
1006
1423
  artifacts?: Record<string, unknown>[] | undefined;
1007
1424
  metadata?: Record<string, unknown> | undefined;
1008
1425
  }, {
1009
1426
  success: boolean;
1010
1427
  error?: string | undefined;
1011
1428
  sessionId?: string | undefined;
1429
+ text?: string | undefined;
1012
1430
  usage?: {
1013
1431
  inputTokens?: number | undefined;
1014
1432
  outputTokens?: number | undefined;
1015
1433
  thinkingTokens?: number | undefined;
1434
+ cacheReadInputTokens?: number | undefined;
1435
+ cacheCreationInputTokens?: number | undefined;
1436
+ totalTokens?: number | undefined;
1016
1437
  } | undefined;
1017
- text?: string | undefined;
1018
1438
  artifacts?: Record<string, unknown>[] | undefined;
1019
1439
  metadata?: Record<string, unknown> | undefined;
1020
1440
  }>;
@@ -1024,12 +1444,15 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
1024
1444
  success: boolean;
1025
1445
  error?: string | undefined;
1026
1446
  sessionId?: string | undefined;
1447
+ text?: string | undefined;
1027
1448
  usage?: {
1028
1449
  inputTokens?: number | undefined;
1029
1450
  outputTokens?: number | undefined;
1030
1451
  thinkingTokens?: number | undefined;
1452
+ cacheReadInputTokens?: number | undefined;
1453
+ cacheCreationInputTokens?: number | undefined;
1454
+ totalTokens?: number | undefined;
1031
1455
  } | undefined;
1032
- text?: string | undefined;
1033
1456
  artifacts?: Record<string, unknown>[] | undefined;
1034
1457
  metadata?: Record<string, unknown> | undefined;
1035
1458
  };
@@ -1042,12 +1465,15 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
1042
1465
  success: boolean;
1043
1466
  error?: string | undefined;
1044
1467
  sessionId?: string | undefined;
1468
+ text?: string | undefined;
1045
1469
  usage?: {
1046
1470
  inputTokens?: number | undefined;
1047
1471
  outputTokens?: number | undefined;
1048
1472
  thinkingTokens?: number | undefined;
1473
+ cacheReadInputTokens?: number | undefined;
1474
+ cacheCreationInputTokens?: number | undefined;
1475
+ totalTokens?: number | undefined;
1049
1476
  } | undefined;
1050
- text?: string | undefined;
1051
1477
  artifacts?: Record<string, unknown>[] | undefined;
1052
1478
  metadata?: Record<string, unknown> | undefined;
1053
1479
  };
@@ -1076,6 +1502,83 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
1076
1502
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1077
1503
  hostKind?: "workstation" | "external_computer" | undefined;
1078
1504
  hostProfile?: string | undefined;
1505
+ }>, z.ZodObject<{
1506
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1507
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1508
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1509
+ } & {
1510
+ type: z.ZodLiteral<"interaction_requested">;
1511
+ interactionId: z.ZodString;
1512
+ interactionType: z.ZodEnum<["permission", "confirmation", "question", "selection"]>;
1513
+ /** 最小必要的用户决策说明；不得包含 Engine 内部思考或 secret。 */
1514
+ prompt: z.ZodString;
1515
+ options: z.ZodArray<z.ZodObject<{
1516
+ optionId: z.ZodString;
1517
+ label: z.ZodString;
1518
+ semantic: z.ZodOptional<z.ZodEnum<["allow_once", "allow_session", "deny", "custom"]>>;
1519
+ }, "strip", z.ZodTypeAny, {
1520
+ optionId: string;
1521
+ label: string;
1522
+ semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
1523
+ }, {
1524
+ optionId: string;
1525
+ label: string;
1526
+ semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
1527
+ }>, "many">;
1528
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
1529
+ }, "strip", z.ZodTypeAny, {
1530
+ type: "interaction_requested";
1531
+ options: {
1532
+ optionId: string;
1533
+ label: string;
1534
+ semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
1535
+ }[];
1536
+ interactionId: string;
1537
+ interactionType: "permission" | "confirmation" | "question" | "selection";
1538
+ prompt: string;
1539
+ timeoutMs?: number | undefined;
1540
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1541
+ hostKind?: "workstation" | "external_computer" | undefined;
1542
+ hostProfile?: string | undefined;
1543
+ }, {
1544
+ type: "interaction_requested";
1545
+ options: {
1546
+ optionId: string;
1547
+ label: string;
1548
+ semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
1549
+ }[];
1550
+ interactionId: string;
1551
+ interactionType: "permission" | "confirmation" | "question" | "selection";
1552
+ prompt: string;
1553
+ timeoutMs?: number | undefined;
1554
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1555
+ hostKind?: "workstation" | "external_computer" | undefined;
1556
+ hostProfile?: string | undefined;
1557
+ }>, z.ZodObject<{
1558
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1559
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1560
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1561
+ } & {
1562
+ type: z.ZodLiteral<"interaction_resolved">;
1563
+ interactionId: z.ZodString;
1564
+ responseId: z.ZodOptional<z.ZodString>;
1565
+ resolution: z.ZodEnum<["accepted", "rejected", "answered", "expired"]>;
1566
+ }, "strip", z.ZodTypeAny, {
1567
+ type: "interaction_resolved";
1568
+ interactionId: string;
1569
+ resolution: "accepted" | "rejected" | "answered" | "expired";
1570
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1571
+ hostKind?: "workstation" | "external_computer" | undefined;
1572
+ hostProfile?: string | undefined;
1573
+ responseId?: string | undefined;
1574
+ }, {
1575
+ type: "interaction_resolved";
1576
+ interactionId: string;
1577
+ resolution: "accepted" | "rejected" | "answered" | "expired";
1578
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1579
+ hostKind?: "workstation" | "external_computer" | undefined;
1580
+ hostProfile?: string | undefined;
1581
+ responseId?: string | undefined;
1079
1582
  }>]>>;
1080
1583
  }, "strip", z.ZodTypeAny, {
1081
1584
  taskId: string;
@@ -1122,16 +1625,19 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
1122
1625
  } | {
1123
1626
  type: "artifact";
1124
1627
  path: string;
1628
+ label?: string | undefined;
1125
1629
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1126
1630
  hostKind?: "workstation" | "external_computer" | undefined;
1127
1631
  hostProfile?: string | undefined;
1128
- label?: string | undefined;
1129
1632
  } | {
1130
1633
  type: "usage";
1131
1634
  usage: {
1132
1635
  inputTokens?: number | undefined;
1133
1636
  outputTokens?: number | undefined;
1134
1637
  thinkingTokens?: number | undefined;
1638
+ cacheReadInputTokens?: number | undefined;
1639
+ cacheCreationInputTokens?: number | undefined;
1640
+ totalTokens?: number | undefined;
1135
1641
  };
1136
1642
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1137
1643
  hostKind?: "workstation" | "external_computer" | undefined;
@@ -1142,12 +1648,15 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
1142
1648
  success: boolean;
1143
1649
  error?: string | undefined;
1144
1650
  sessionId?: string | undefined;
1651
+ text?: string | undefined;
1145
1652
  usage?: {
1146
1653
  inputTokens?: number | undefined;
1147
1654
  outputTokens?: number | undefined;
1148
1655
  thinkingTokens?: number | undefined;
1656
+ cacheReadInputTokens?: number | undefined;
1657
+ cacheCreationInputTokens?: number | undefined;
1658
+ totalTokens?: number | undefined;
1149
1659
  } | undefined;
1150
- text?: string | undefined;
1151
1660
  artifacts?: Record<string, unknown>[] | undefined;
1152
1661
  metadata?: Record<string, unknown> | undefined;
1153
1662
  };
@@ -1161,6 +1670,28 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
1161
1670
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1162
1671
  hostKind?: "workstation" | "external_computer" | undefined;
1163
1672
  hostProfile?: string | undefined;
1673
+ } | {
1674
+ type: "interaction_requested";
1675
+ options: {
1676
+ optionId: string;
1677
+ label: string;
1678
+ semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
1679
+ }[];
1680
+ interactionId: string;
1681
+ interactionType: "permission" | "confirmation" | "question" | "selection";
1682
+ prompt: string;
1683
+ timeoutMs?: number | undefined;
1684
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1685
+ hostKind?: "workstation" | "external_computer" | undefined;
1686
+ hostProfile?: string | undefined;
1687
+ } | {
1688
+ type: "interaction_resolved";
1689
+ interactionId: string;
1690
+ resolution: "accepted" | "rejected" | "answered" | "expired";
1691
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1692
+ hostKind?: "workstation" | "external_computer" | undefined;
1693
+ hostProfile?: string | undefined;
1694
+ responseId?: string | undefined;
1164
1695
  } | undefined;
1165
1696
  }, {
1166
1697
  taskId: string;
@@ -1207,16 +1738,19 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
1207
1738
  } | {
1208
1739
  type: "artifact";
1209
1740
  path: string;
1741
+ label?: string | undefined;
1210
1742
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1211
1743
  hostKind?: "workstation" | "external_computer" | undefined;
1212
1744
  hostProfile?: string | undefined;
1213
- label?: string | undefined;
1214
1745
  } | {
1215
1746
  type: "usage";
1216
1747
  usage: {
1217
1748
  inputTokens?: number | undefined;
1218
1749
  outputTokens?: number | undefined;
1219
1750
  thinkingTokens?: number | undefined;
1751
+ cacheReadInputTokens?: number | undefined;
1752
+ cacheCreationInputTokens?: number | undefined;
1753
+ totalTokens?: number | undefined;
1220
1754
  };
1221
1755
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1222
1756
  hostKind?: "workstation" | "external_computer" | undefined;
@@ -1227,12 +1761,15 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
1227
1761
  success: boolean;
1228
1762
  error?: string | undefined;
1229
1763
  sessionId?: string | undefined;
1764
+ text?: string | undefined;
1230
1765
  usage?: {
1231
1766
  inputTokens?: number | undefined;
1232
1767
  outputTokens?: number | undefined;
1233
1768
  thinkingTokens?: number | undefined;
1769
+ cacheReadInputTokens?: number | undefined;
1770
+ cacheCreationInputTokens?: number | undefined;
1771
+ totalTokens?: number | undefined;
1234
1772
  } | undefined;
1235
- text?: string | undefined;
1236
1773
  artifacts?: Record<string, unknown>[] | undefined;
1237
1774
  metadata?: Record<string, unknown> | undefined;
1238
1775
  };
@@ -1246,6 +1783,28 @@ export declare const TaskDeltaEventSchema: z.ZodObject<{
1246
1783
  engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1247
1784
  hostKind?: "workstation" | "external_computer" | undefined;
1248
1785
  hostProfile?: string | undefined;
1786
+ } | {
1787
+ type: "interaction_requested";
1788
+ options: {
1789
+ optionId: string;
1790
+ label: string;
1791
+ semantic?: "custom" | "allow_once" | "allow_session" | "deny" | undefined;
1792
+ }[];
1793
+ interactionId: string;
1794
+ interactionType: "permission" | "confirmation" | "question" | "selection";
1795
+ prompt: string;
1796
+ timeoutMs?: number | undefined;
1797
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1798
+ hostKind?: "workstation" | "external_computer" | undefined;
1799
+ hostProfile?: string | undefined;
1800
+ } | {
1801
+ type: "interaction_resolved";
1802
+ interactionId: string;
1803
+ resolution: "accepted" | "rejected" | "answered" | "expired";
1804
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1805
+ hostKind?: "workstation" | "external_computer" | undefined;
1806
+ hostProfile?: string | undefined;
1807
+ responseId?: string | undefined;
1249
1808
  } | undefined;
1250
1809
  }>;
1251
1810
  export declare const TaskThinkingEventSchema: z.ZodObject<{
@@ -1328,11 +1887,20 @@ export type EngineId = z.infer<typeof EngineIdSchema>;
1328
1887
  export type HostKind = z.infer<typeof HostKindSchema>;
1329
1888
  export type HostProfile = z.infer<typeof HostProfileSchema>;
1330
1889
  export type EngineToolName = z.infer<typeof EngineToolNameSchema>;
1890
+ export type ExecutionDurability = z.infer<typeof ExecutionDurabilitySchema>;
1891
+ export type EventStreamMode = z.infer<typeof EventStreamModeSchema>;
1892
+ export type EventRetention = z.infer<typeof EventRetentionSchema>;
1893
+ export type EngineContentBlockKind = z.infer<typeof EngineContentBlockKindSchema>;
1894
+ export type AgentEngineHookPoint = z.infer<typeof AgentEngineHookPointSchema>;
1895
+ export type EngineHookProfileRef = z.infer<typeof EngineHookProfileRefSchema>;
1896
+ export type EngineHookProfileDescriptor = z.infer<typeof EngineHookProfileDescriptorSchema>;
1897
+ export type EngineInteractionOption = z.infer<typeof EngineInteractionOptionSchema>;
1331
1898
  export type EngineCapabilityProfile = z.infer<typeof EngineCapabilityProfileSchema>;
1332
- export type EngineInvocationPlan = z.infer<typeof EngineInvocationPlanSchema>;
1899
+ export type EngineInvocationPlanV1 = z.infer<typeof EngineInvocationPlanV1Schema>;
1333
1900
  export type EngineProgressEventType = z.infer<typeof EngineProgressEventTypeSchema>;
1334
1901
  export type EngineProgressEvent = z.infer<typeof EngineProgressEventSchema>;
1335
1902
  export type EngineFinalResult = z.infer<typeof EngineFinalResultSchema>;
1903
+ export type EngineTokenUsage = z.infer<typeof EngineTokenUsageSchema>;
1336
1904
  export type TaskThinkingPayload = z.infer<typeof TaskThinkingEventSchema>;
1337
1905
  export type TaskCompletePayload = z.infer<typeof TaskCompleteEventSchema>;
1338
1906
  export type TaskErrorPayload = z.infer<typeof TaskErrorEventSchema>;
@@ -1794,13 +2362,13 @@ export declare const AgentProfileSchema: z.ZodObject<{
1794
2362
  category: z.ZodOptional<z.ZodString>;
1795
2363
  }, "strip", z.ZodTypeAny, {
1796
2364
  name: string;
1797
- description?: string | undefined;
1798
2365
  source?: string | undefined;
2366
+ description?: string | undefined;
1799
2367
  category?: string | undefined;
1800
2368
  }, {
1801
2369
  name: string;
1802
- description?: string | undefined;
1803
2370
  source?: string | undefined;
2371
+ description?: string | undefined;
1804
2372
  category?: string | undefined;
1805
2373
  }>, "many">;
1806
2374
  toolCategories: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
@@ -1810,8 +2378,8 @@ export declare const AgentProfileSchema: z.ZodObject<{
1810
2378
  tools: string[];
1811
2379
  skills: {
1812
2380
  name: string;
1813
- description?: string | undefined;
1814
2381
  source?: string | undefined;
2382
+ description?: string | undefined;
1815
2383
  category?: string | undefined;
1816
2384
  }[];
1817
2385
  toolCategories: Record<string, string[]>;
@@ -1821,8 +2389,8 @@ export declare const AgentProfileSchema: z.ZodObject<{
1821
2389
  tools: string[];
1822
2390
  skills: {
1823
2391
  name: string;
1824
- description?: string | undefined;
1825
2392
  source?: string | undefined;
2393
+ description?: string | undefined;
1826
2394
  category?: string | undefined;
1827
2395
  }[];
1828
2396
  toolCategories: Record<string, string[]>;
@@ -1840,13 +2408,13 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
1840
2408
  category: z.ZodOptional<z.ZodString>;
1841
2409
  }, "strip", z.ZodTypeAny, {
1842
2410
  name: string;
1843
- description?: string | undefined;
1844
2411
  source?: string | undefined;
2412
+ description?: string | undefined;
1845
2413
  category?: string | undefined;
1846
2414
  }, {
1847
2415
  name: string;
1848
- description?: string | undefined;
1849
2416
  source?: string | undefined;
2417
+ description?: string | undefined;
1850
2418
  category?: string | undefined;
1851
2419
  }>, "many">;
1852
2420
  toolCategories: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
@@ -1856,8 +2424,8 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
1856
2424
  tools: string[];
1857
2425
  skills: {
1858
2426
  name: string;
1859
- description?: string | undefined;
1860
2427
  source?: string | undefined;
2428
+ description?: string | undefined;
1861
2429
  category?: string | undefined;
1862
2430
  }[];
1863
2431
  toolCategories: Record<string, string[]>;
@@ -1867,8 +2435,8 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
1867
2435
  tools: string[];
1868
2436
  skills: {
1869
2437
  name: string;
1870
- description?: string | undefined;
1871
2438
  source?: string | undefined;
2439
+ description?: string | undefined;
1872
2440
  category?: string | undefined;
1873
2441
  }[];
1874
2442
  toolCategories: Record<string, string[]>;
@@ -1880,8 +2448,8 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
1880
2448
  tools: string[];
1881
2449
  skills: {
1882
2450
  name: string;
1883
- description?: string | undefined;
1884
2451
  source?: string | undefined;
2452
+ description?: string | undefined;
1885
2453
  category?: string | undefined;
1886
2454
  }[];
1887
2455
  toolCategories: Record<string, string[]>;
@@ -1893,8 +2461,8 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
1893
2461
  tools: string[];
1894
2462
  skills: {
1895
2463
  name: string;
1896
- description?: string | undefined;
1897
2464
  source?: string | undefined;
2465
+ description?: string | undefined;
1898
2466
  category?: string | undefined;
1899
2467
  }[];
1900
2468
  toolCategories: Record<string, string[]>;