@winmatrix/protocol 1.0.3 → 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.
package/dist/schemas.d.ts CHANGED
@@ -102,16 +102,22 @@ export declare const RegisterParamsSchema: z.ZodObject<{
102
102
  streaming: z.ZodBoolean;
103
103
  toolCall: z.ZodBoolean;
104
104
  cancellation: z.ZodBoolean;
105
+ supportsCancel: z.ZodOptional<z.ZodBoolean>;
106
+ supportsResume: z.ZodOptional<z.ZodBoolean>;
105
107
  maxConcurrentTasks: z.ZodOptional<z.ZodNumber>;
106
108
  }, "strip", z.ZodTypeAny, {
107
109
  streaming: boolean;
108
110
  toolCall: boolean;
109
111
  cancellation: boolean;
112
+ supportsCancel?: boolean | undefined;
113
+ supportsResume?: boolean | undefined;
110
114
  maxConcurrentTasks?: number | undefined;
111
115
  }, {
112
116
  streaming: boolean;
113
117
  toolCall: boolean;
114
118
  cancellation: boolean;
119
+ supportsCancel?: boolean | undefined;
120
+ supportsResume?: boolean | undefined;
115
121
  maxConcurrentTasks?: number | undefined;
116
122
  }>;
117
123
  }, "strip", z.ZodTypeAny, {
@@ -123,6 +129,8 @@ export declare const RegisterParamsSchema: z.ZodObject<{
123
129
  streaming: boolean;
124
130
  toolCall: boolean;
125
131
  cancellation: boolean;
132
+ supportsCancel?: boolean | undefined;
133
+ supportsResume?: boolean | undefined;
126
134
  maxConcurrentTasks?: number | undefined;
127
135
  };
128
136
  }, {
@@ -134,6 +142,8 @@ export declare const RegisterParamsSchema: z.ZodObject<{
134
142
  streaming: boolean;
135
143
  toolCall: boolean;
136
144
  cancellation: boolean;
145
+ supportsCancel?: boolean | undefined;
146
+ supportsResume?: boolean | undefined;
137
147
  maxConcurrentTasks?: number | undefined;
138
148
  };
139
149
  }>;
@@ -274,6 +284,10 @@ export declare const TaskAssignParamsSchema: z.ZodObject<{
274
284
  streaming: z.ZodBoolean;
275
285
  systemPrompt: z.ZodOptional<z.ZodString>;
276
286
  mcpToken: z.ZodOptional<z.ZodString>;
287
+ /** Adapter session id for resume (hermes/claude/codex thread_id/openclaw sessionKey) */
288
+ sessionId: z.ZodOptional<z.ZodString>;
289
+ /** When true, adapter SHALL resume the session identified by sessionId */
290
+ resumeSession: z.ZodOptional<z.ZodBoolean>;
277
291
  }, "strip", z.ZodTypeAny, {
278
292
  streaming: boolean;
279
293
  taskId: string;
@@ -294,6 +308,8 @@ export declare const TaskAssignParamsSchema: z.ZodObject<{
294
308
  };
295
309
  systemPrompt?: string | undefined;
296
310
  mcpToken?: string | undefined;
311
+ sessionId?: string | undefined;
312
+ resumeSession?: boolean | undefined;
297
313
  }, {
298
314
  streaming: boolean;
299
315
  taskId: string;
@@ -314,22 +330,1482 @@ export declare const TaskAssignParamsSchema: z.ZodObject<{
314
330
  };
315
331
  systemPrompt?: string | undefined;
316
332
  mcpToken?: string | undefined;
333
+ sessionId?: string | undefined;
334
+ resumeSession?: boolean | undefined;
317
335
  }>;
318
336
  export type TaskContext = z.infer<typeof TaskContextSchema>;
319
337
  export type TaskConstraints = z.infer<typeof TaskConstraintsSchema>;
320
338
  export type TaskAssignParams = z.infer<typeof TaskAssignParamsSchema>;
339
+ export declare const EngineIdSchema: z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>;
340
+ export declare const HostKindSchema: z.ZodEnum<["workstation", "external_computer"]>;
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", "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
+ }>;
427
+ export declare const EngineCapabilityProfileSchema: z.ZodObject<{
428
+ engineId: z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>;
429
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
430
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
431
+ streaming: z.ZodBoolean;
432
+ toolCall: z.ZodBoolean;
433
+ session: z.ZodBoolean;
434
+ supportsCancel: z.ZodBoolean;
435
+ supportsResume: z.ZodBoolean;
436
+ controlReasons: z.ZodOptional<z.ZodObject<{
437
+ cancel: z.ZodOptional<z.ZodString>;
438
+ resume: z.ZodOptional<z.ZodString>;
439
+ }, "strip", z.ZodTypeAny, {
440
+ cancel?: string | undefined;
441
+ resume?: string | undefined;
442
+ }, {
443
+ cancel?: string | undefined;
444
+ resume?: string | undefined;
445
+ }>>;
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>;
515
+ }, "strip", z.ZodTypeAny, {
516
+ streaming: boolean;
517
+ toolCall: boolean;
518
+ supportsCancel: boolean;
519
+ supportsResume: boolean;
520
+ engineId: "custom" | "claude-code" | "codex" | "hermes" | "openclaw";
521
+ session: boolean;
522
+ hostKind?: "workstation" | "external_computer" | undefined;
523
+ hostProfile?: string | undefined;
524
+ controlReasons?: {
525
+ cancel?: string | undefined;
526
+ resume?: string | undefined;
527
+ } | undefined;
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;
559
+ }, {
560
+ streaming: boolean;
561
+ toolCall: boolean;
562
+ supportsCancel: boolean;
563
+ supportsResume: boolean;
564
+ engineId: "custom" | "claude-code" | "codex" | "hermes" | "openclaw";
565
+ session: boolean;
566
+ hostKind?: "workstation" | "external_computer" | undefined;
567
+ hostProfile?: string | undefined;
568
+ controlReasons?: {
569
+ cancel?: string | undefined;
570
+ resume?: string | undefined;
571
+ } | undefined;
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;
603
+ }>;
604
+ /**
605
+ * V1 调用计划(字符串 input)。现有 shape 固定为 V1,不得原地改成对象;
606
+ * 结构化输入请使用 EngineInvocationPlanV2Schema(见 agentEngine.ts)。
607
+ * env 仅允许非敏感、可序列化配置;secret 走 Host 私有 binding。
608
+ */
609
+ export declare const EngineInvocationPlanV1Schema: z.ZodObject<{
610
+ taskId: z.ZodString;
611
+ engineId: z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>;
612
+ hostKind: z.ZodEnum<["workstation", "external_computer"]>;
613
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
614
+ toolName: z.ZodEnum<["coding_task", "sre_skill_task", "workstation_execute", "external_agent_task", "execute_task"]>;
615
+ input: z.ZodString;
616
+ workDir: z.ZodOptional<z.ZodString>;
617
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
618
+ env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
619
+ allowedTools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
620
+ sessionId: z.ZodOptional<z.ZodString>;
621
+ resume: z.ZodOptional<z.ZodBoolean>;
622
+ artifactPolicy: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
623
+ }, "strip", z.ZodTypeAny, {
624
+ taskId: string;
625
+ input: string;
626
+ engineId: "custom" | "claude-code" | "codex" | "hermes" | "openclaw";
627
+ hostKind: "workstation" | "external_computer";
628
+ toolName: "coding_task" | "sre_skill_task" | "workstation_execute" | "external_agent_task" | "execute_task";
629
+ allowedTools?: string[] | undefined;
630
+ sessionId?: string | undefined;
631
+ timeoutMs?: number | undefined;
632
+ hostProfile?: string | undefined;
633
+ resume?: boolean | undefined;
634
+ workDir?: string | undefined;
635
+ env?: Record<string, string> | undefined;
636
+ artifactPolicy?: Record<string, unknown> | undefined;
637
+ }, {
638
+ taskId: string;
639
+ input: string;
640
+ engineId: "custom" | "claude-code" | "codex" | "hermes" | "openclaw";
641
+ hostKind: "workstation" | "external_computer";
642
+ toolName: "coding_task" | "sre_skill_task" | "workstation_execute" | "external_agent_task" | "execute_task";
643
+ allowedTools?: string[] | undefined;
644
+ sessionId?: string | undefined;
645
+ timeoutMs?: number | undefined;
646
+ hostProfile?: string | undefined;
647
+ resume?: boolean | undefined;
648
+ workDir?: string | undefined;
649
+ env?: Record<string, string> | undefined;
650
+ artifactPolicy?: Record<string, unknown> | undefined;
651
+ }>;
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"]>;
653
+ export declare const EngineUsageSchema: z.ZodObject<{
654
+ inputTokens: z.ZodOptional<z.ZodNumber>;
655
+ outputTokens: z.ZodOptional<z.ZodNumber>;
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>>;
692
+ }, "strip", z.ZodTypeAny, {
693
+ source: "unknown" | "primary_event" | "session_log_scan";
694
+ inputTokens?: number | undefined;
695
+ outputTokens?: number | undefined;
696
+ thinkingTokens?: number | undefined;
697
+ cacheReadInputTokens?: number | undefined;
698
+ cacheCreationInputTokens?: number | undefined;
699
+ totalTokens?: number | undefined;
700
+ raw?: Record<string, unknown> | undefined;
701
+ }, {
702
+ inputTokens?: number | undefined;
703
+ outputTokens?: number | undefined;
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;
710
+ }>;
711
+ export declare const EngineFinalResultSchema: z.ZodObject<{
712
+ success: z.ZodBoolean;
713
+ text: z.ZodOptional<z.ZodString>;
714
+ sessionId: z.ZodOptional<z.ZodString>;
715
+ artifacts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
716
+ usage: z.ZodOptional<z.ZodObject<{
717
+ inputTokens: z.ZodOptional<z.ZodNumber>;
718
+ outputTokens: z.ZodOptional<z.ZodNumber>;
719
+ thinkingTokens: z.ZodOptional<z.ZodNumber>;
720
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
721
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
722
+ totalTokens: z.ZodOptional<z.ZodNumber>;
723
+ }, "strip", z.ZodTypeAny, {
724
+ inputTokens?: number | undefined;
725
+ outputTokens?: number | undefined;
726
+ thinkingTokens?: number | undefined;
727
+ cacheReadInputTokens?: number | undefined;
728
+ cacheCreationInputTokens?: number | undefined;
729
+ totalTokens?: number | undefined;
730
+ }, {
731
+ inputTokens?: number | undefined;
732
+ outputTokens?: number | undefined;
733
+ thinkingTokens?: number | undefined;
734
+ cacheReadInputTokens?: number | undefined;
735
+ cacheCreationInputTokens?: number | undefined;
736
+ totalTokens?: number | undefined;
737
+ }>>;
738
+ error: z.ZodOptional<z.ZodString>;
739
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
740
+ }, "strip", z.ZodTypeAny, {
741
+ success: boolean;
742
+ error?: string | undefined;
743
+ sessionId?: string | undefined;
744
+ text?: string | undefined;
745
+ usage?: {
746
+ inputTokens?: number | undefined;
747
+ outputTokens?: number | undefined;
748
+ thinkingTokens?: number | undefined;
749
+ cacheReadInputTokens?: number | undefined;
750
+ cacheCreationInputTokens?: number | undefined;
751
+ totalTokens?: number | undefined;
752
+ } | undefined;
753
+ artifacts?: Record<string, unknown>[] | undefined;
754
+ metadata?: Record<string, unknown> | undefined;
755
+ }, {
756
+ success: boolean;
757
+ error?: string | undefined;
758
+ sessionId?: string | undefined;
759
+ text?: string | undefined;
760
+ usage?: {
761
+ inputTokens?: number | undefined;
762
+ outputTokens?: number | undefined;
763
+ thinkingTokens?: number | undefined;
764
+ cacheReadInputTokens?: number | undefined;
765
+ cacheCreationInputTokens?: number | undefined;
766
+ totalTokens?: number | undefined;
767
+ } | undefined;
768
+ artifacts?: Record<string, unknown>[] | undefined;
769
+ metadata?: Record<string, unknown> | undefined;
770
+ }>;
771
+ export declare const EngineProgressEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
772
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
773
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
774
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
775
+ } & {
776
+ type: z.ZodLiteral<"status">;
777
+ text: z.ZodString;
778
+ }, "strip", z.ZodTypeAny, {
779
+ type: "status";
780
+ text: string;
781
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
782
+ hostKind?: "workstation" | "external_computer" | undefined;
783
+ hostProfile?: string | undefined;
784
+ }, {
785
+ type: "status";
786
+ text: string;
787
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
788
+ hostKind?: "workstation" | "external_computer" | undefined;
789
+ hostProfile?: string | undefined;
790
+ }>, z.ZodObject<{
791
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
792
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
793
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
794
+ } & {
795
+ type: z.ZodLiteral<"content_delta">;
796
+ text: z.ZodString;
797
+ }, "strip", z.ZodTypeAny, {
798
+ type: "content_delta";
799
+ text: string;
800
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
801
+ hostKind?: "workstation" | "external_computer" | undefined;
802
+ hostProfile?: string | undefined;
803
+ }, {
804
+ type: "content_delta";
805
+ text: string;
806
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
807
+ hostKind?: "workstation" | "external_computer" | undefined;
808
+ hostProfile?: string | undefined;
809
+ }>, z.ZodObject<{
810
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
811
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
812
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
813
+ } & {
814
+ type: z.ZodLiteral<"thinking_delta">;
815
+ text: z.ZodString;
816
+ }, "strip", z.ZodTypeAny, {
817
+ type: "thinking_delta";
818
+ text: string;
819
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
820
+ hostKind?: "workstation" | "external_computer" | undefined;
821
+ hostProfile?: string | undefined;
822
+ }, {
823
+ type: "thinking_delta";
824
+ text: string;
825
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
826
+ hostKind?: "workstation" | "external_computer" | undefined;
827
+ hostProfile?: string | undefined;
828
+ }>, z.ZodObject<{
829
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
830
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
831
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
832
+ } & {
833
+ type: z.ZodLiteral<"tool_call">;
834
+ name: z.ZodString;
835
+ input: z.ZodOptional<z.ZodUnknown>;
836
+ }, "strip", z.ZodTypeAny, {
837
+ type: "tool_call";
838
+ name: string;
839
+ input?: unknown;
840
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
841
+ hostKind?: "workstation" | "external_computer" | undefined;
842
+ hostProfile?: string | undefined;
843
+ }, {
844
+ type: "tool_call";
845
+ name: string;
846
+ input?: unknown;
847
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
848
+ hostKind?: "workstation" | "external_computer" | undefined;
849
+ hostProfile?: string | undefined;
850
+ }>, z.ZodObject<{
851
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
852
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
853
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
854
+ } & {
855
+ type: z.ZodLiteral<"tool_result_delta">;
856
+ name: z.ZodOptional<z.ZodString>;
857
+ text: z.ZodString;
858
+ }, "strip", z.ZodTypeAny, {
859
+ type: "tool_result_delta";
860
+ text: string;
861
+ name?: string | undefined;
862
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
863
+ hostKind?: "workstation" | "external_computer" | undefined;
864
+ hostProfile?: string | undefined;
865
+ }, {
866
+ type: "tool_result_delta";
867
+ text: string;
868
+ name?: string | undefined;
869
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
870
+ hostKind?: "workstation" | "external_computer" | undefined;
871
+ hostProfile?: string | undefined;
872
+ }>, z.ZodObject<{
873
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
874
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
875
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
876
+ } & {
877
+ type: z.ZodLiteral<"stderr_delta">;
878
+ text: z.ZodString;
879
+ }, "strip", z.ZodTypeAny, {
880
+ type: "stderr_delta";
881
+ text: string;
882
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
883
+ hostKind?: "workstation" | "external_computer" | undefined;
884
+ hostProfile?: string | undefined;
885
+ }, {
886
+ type: "stderr_delta";
887
+ text: string;
888
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
889
+ hostKind?: "workstation" | "external_computer" | undefined;
890
+ hostProfile?: string | undefined;
891
+ }>, z.ZodObject<{
892
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
893
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
894
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
895
+ } & {
896
+ type: z.ZodLiteral<"artifact">;
897
+ path: z.ZodString;
898
+ label: z.ZodOptional<z.ZodString>;
899
+ }, "strip", z.ZodTypeAny, {
900
+ type: "artifact";
901
+ path: string;
902
+ label?: string | undefined;
903
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
904
+ hostKind?: "workstation" | "external_computer" | undefined;
905
+ hostProfile?: string | undefined;
906
+ }, {
907
+ type: "artifact";
908
+ path: string;
909
+ label?: string | undefined;
910
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
911
+ hostKind?: "workstation" | "external_computer" | undefined;
912
+ hostProfile?: string | undefined;
913
+ }>, z.ZodObject<{
914
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
915
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
916
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
917
+ } & {
918
+ type: z.ZodLiteral<"usage">;
919
+ usage: z.ZodObject<{
920
+ inputTokens: z.ZodOptional<z.ZodNumber>;
921
+ outputTokens: z.ZodOptional<z.ZodNumber>;
922
+ thinkingTokens: z.ZodOptional<z.ZodNumber>;
923
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
924
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
925
+ totalTokens: z.ZodOptional<z.ZodNumber>;
926
+ }, "strip", z.ZodTypeAny, {
927
+ inputTokens?: number | undefined;
928
+ outputTokens?: number | undefined;
929
+ thinkingTokens?: number | undefined;
930
+ cacheReadInputTokens?: number | undefined;
931
+ cacheCreationInputTokens?: number | undefined;
932
+ totalTokens?: number | undefined;
933
+ }, {
934
+ inputTokens?: number | undefined;
935
+ outputTokens?: number | undefined;
936
+ thinkingTokens?: number | undefined;
937
+ cacheReadInputTokens?: number | undefined;
938
+ cacheCreationInputTokens?: number | undefined;
939
+ totalTokens?: number | undefined;
940
+ }>;
941
+ }, "strip", z.ZodTypeAny, {
942
+ type: "usage";
943
+ usage: {
944
+ inputTokens?: number | undefined;
945
+ outputTokens?: number | undefined;
946
+ thinkingTokens?: number | undefined;
947
+ cacheReadInputTokens?: number | undefined;
948
+ cacheCreationInputTokens?: number | undefined;
949
+ totalTokens?: number | undefined;
950
+ };
951
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
952
+ hostKind?: "workstation" | "external_computer" | undefined;
953
+ hostProfile?: string | undefined;
954
+ }, {
955
+ type: "usage";
956
+ usage: {
957
+ inputTokens?: number | undefined;
958
+ outputTokens?: number | undefined;
959
+ thinkingTokens?: number | undefined;
960
+ cacheReadInputTokens?: number | undefined;
961
+ cacheCreationInputTokens?: number | undefined;
962
+ totalTokens?: number | undefined;
963
+ };
964
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
965
+ hostKind?: "workstation" | "external_computer" | undefined;
966
+ hostProfile?: string | undefined;
967
+ }>, z.ZodObject<{
968
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
969
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
970
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
971
+ } & {
972
+ type: z.ZodLiteral<"result">;
973
+ result: z.ZodObject<{
974
+ success: z.ZodBoolean;
975
+ text: z.ZodOptional<z.ZodString>;
976
+ sessionId: z.ZodOptional<z.ZodString>;
977
+ artifacts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
978
+ usage: z.ZodOptional<z.ZodObject<{
979
+ inputTokens: z.ZodOptional<z.ZodNumber>;
980
+ outputTokens: z.ZodOptional<z.ZodNumber>;
981
+ thinkingTokens: z.ZodOptional<z.ZodNumber>;
982
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
983
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
984
+ totalTokens: z.ZodOptional<z.ZodNumber>;
985
+ }, "strip", z.ZodTypeAny, {
986
+ inputTokens?: number | undefined;
987
+ outputTokens?: number | undefined;
988
+ thinkingTokens?: number | undefined;
989
+ cacheReadInputTokens?: number | undefined;
990
+ cacheCreationInputTokens?: number | undefined;
991
+ totalTokens?: number | undefined;
992
+ }, {
993
+ inputTokens?: number | undefined;
994
+ outputTokens?: number | undefined;
995
+ thinkingTokens?: number | undefined;
996
+ cacheReadInputTokens?: number | undefined;
997
+ cacheCreationInputTokens?: number | undefined;
998
+ totalTokens?: number | undefined;
999
+ }>>;
1000
+ error: z.ZodOptional<z.ZodString>;
1001
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1002
+ }, "strip", z.ZodTypeAny, {
1003
+ success: boolean;
1004
+ error?: string | undefined;
1005
+ sessionId?: string | undefined;
1006
+ text?: string | undefined;
1007
+ usage?: {
1008
+ inputTokens?: number | undefined;
1009
+ outputTokens?: number | undefined;
1010
+ thinkingTokens?: number | undefined;
1011
+ cacheReadInputTokens?: number | undefined;
1012
+ cacheCreationInputTokens?: number | undefined;
1013
+ totalTokens?: number | undefined;
1014
+ } | undefined;
1015
+ artifacts?: Record<string, unknown>[] | undefined;
1016
+ metadata?: Record<string, unknown> | undefined;
1017
+ }, {
1018
+ success: boolean;
1019
+ error?: string | undefined;
1020
+ sessionId?: string | undefined;
1021
+ text?: string | undefined;
1022
+ usage?: {
1023
+ inputTokens?: number | undefined;
1024
+ outputTokens?: number | undefined;
1025
+ thinkingTokens?: number | undefined;
1026
+ cacheReadInputTokens?: number | undefined;
1027
+ cacheCreationInputTokens?: number | undefined;
1028
+ totalTokens?: number | undefined;
1029
+ } | undefined;
1030
+ artifacts?: Record<string, unknown>[] | undefined;
1031
+ metadata?: Record<string, unknown> | undefined;
1032
+ }>;
1033
+ }, "strip", z.ZodTypeAny, {
1034
+ type: "result";
1035
+ result: {
1036
+ success: boolean;
1037
+ error?: string | undefined;
1038
+ sessionId?: string | undefined;
1039
+ text?: string | undefined;
1040
+ usage?: {
1041
+ inputTokens?: number | undefined;
1042
+ outputTokens?: number | undefined;
1043
+ thinkingTokens?: number | undefined;
1044
+ cacheReadInputTokens?: number | undefined;
1045
+ cacheCreationInputTokens?: number | undefined;
1046
+ totalTokens?: number | undefined;
1047
+ } | undefined;
1048
+ artifacts?: Record<string, unknown>[] | undefined;
1049
+ metadata?: Record<string, unknown> | undefined;
1050
+ };
1051
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1052
+ hostKind?: "workstation" | "external_computer" | undefined;
1053
+ hostProfile?: string | undefined;
1054
+ }, {
1055
+ type: "result";
1056
+ result: {
1057
+ success: boolean;
1058
+ error?: string | undefined;
1059
+ sessionId?: string | undefined;
1060
+ text?: string | undefined;
1061
+ usage?: {
1062
+ inputTokens?: number | undefined;
1063
+ outputTokens?: number | undefined;
1064
+ thinkingTokens?: number | undefined;
1065
+ cacheReadInputTokens?: number | undefined;
1066
+ cacheCreationInputTokens?: number | undefined;
1067
+ totalTokens?: number | undefined;
1068
+ } | undefined;
1069
+ artifacts?: Record<string, unknown>[] | undefined;
1070
+ metadata?: Record<string, unknown> | undefined;
1071
+ };
1072
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1073
+ hostKind?: "workstation" | "external_computer" | undefined;
1074
+ hostProfile?: string | undefined;
1075
+ }>, z.ZodObject<{
1076
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1077
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1078
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1079
+ } & {
1080
+ type: z.ZodLiteral<"error">;
1081
+ error: z.ZodString;
1082
+ code: z.ZodOptional<z.ZodString>;
1083
+ }, "strip", z.ZodTypeAny, {
1084
+ type: "error";
1085
+ error: string;
1086
+ code?: string | undefined;
1087
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1088
+ hostKind?: "workstation" | "external_computer" | undefined;
1089
+ hostProfile?: string | undefined;
1090
+ }, {
1091
+ type: "error";
1092
+ error: string;
1093
+ code?: string | undefined;
1094
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1095
+ hostKind?: "workstation" | "external_computer" | undefined;
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;
1174
+ }>]>;
321
1175
  export declare const TaskDeltaEventSchema: z.ZodObject<{
322
1176
  taskId: z.ZodString;
323
1177
  content: z.ZodString;
324
1178
  meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1179
+ engineEvent: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
1180
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1181
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1182
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1183
+ } & {
1184
+ type: z.ZodLiteral<"status">;
1185
+ text: z.ZodString;
1186
+ }, "strip", z.ZodTypeAny, {
1187
+ type: "status";
1188
+ text: string;
1189
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1190
+ hostKind?: "workstation" | "external_computer" | undefined;
1191
+ hostProfile?: string | undefined;
1192
+ }, {
1193
+ type: "status";
1194
+ text: string;
1195
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1196
+ hostKind?: "workstation" | "external_computer" | undefined;
1197
+ hostProfile?: string | undefined;
1198
+ }>, z.ZodObject<{
1199
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1200
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1201
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1202
+ } & {
1203
+ type: z.ZodLiteral<"content_delta">;
1204
+ text: z.ZodString;
1205
+ }, "strip", z.ZodTypeAny, {
1206
+ type: "content_delta";
1207
+ text: string;
1208
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1209
+ hostKind?: "workstation" | "external_computer" | undefined;
1210
+ hostProfile?: string | undefined;
1211
+ }, {
1212
+ type: "content_delta";
1213
+ text: string;
1214
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1215
+ hostKind?: "workstation" | "external_computer" | undefined;
1216
+ hostProfile?: string | undefined;
1217
+ }>, z.ZodObject<{
1218
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1219
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1220
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1221
+ } & {
1222
+ type: z.ZodLiteral<"thinking_delta">;
1223
+ text: z.ZodString;
1224
+ }, "strip", z.ZodTypeAny, {
1225
+ type: "thinking_delta";
1226
+ text: string;
1227
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1228
+ hostKind?: "workstation" | "external_computer" | undefined;
1229
+ hostProfile?: string | undefined;
1230
+ }, {
1231
+ type: "thinking_delta";
1232
+ text: string;
1233
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1234
+ hostKind?: "workstation" | "external_computer" | undefined;
1235
+ hostProfile?: string | undefined;
1236
+ }>, z.ZodObject<{
1237
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1238
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1239
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1240
+ } & {
1241
+ type: z.ZodLiteral<"tool_call">;
1242
+ name: z.ZodString;
1243
+ input: z.ZodOptional<z.ZodUnknown>;
1244
+ }, "strip", z.ZodTypeAny, {
1245
+ type: "tool_call";
1246
+ name: string;
1247
+ input?: unknown;
1248
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1249
+ hostKind?: "workstation" | "external_computer" | undefined;
1250
+ hostProfile?: string | undefined;
1251
+ }, {
1252
+ type: "tool_call";
1253
+ name: string;
1254
+ input?: unknown;
1255
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1256
+ hostKind?: "workstation" | "external_computer" | undefined;
1257
+ hostProfile?: string | undefined;
1258
+ }>, z.ZodObject<{
1259
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1260
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1261
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1262
+ } & {
1263
+ type: z.ZodLiteral<"tool_result_delta">;
1264
+ name: z.ZodOptional<z.ZodString>;
1265
+ text: z.ZodString;
1266
+ }, "strip", z.ZodTypeAny, {
1267
+ type: "tool_result_delta";
1268
+ text: string;
1269
+ name?: string | undefined;
1270
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1271
+ hostKind?: "workstation" | "external_computer" | undefined;
1272
+ hostProfile?: string | undefined;
1273
+ }, {
1274
+ type: "tool_result_delta";
1275
+ text: string;
1276
+ name?: string | undefined;
1277
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1278
+ hostKind?: "workstation" | "external_computer" | undefined;
1279
+ hostProfile?: string | undefined;
1280
+ }>, z.ZodObject<{
1281
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1282
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1283
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1284
+ } & {
1285
+ type: z.ZodLiteral<"stderr_delta">;
1286
+ text: z.ZodString;
1287
+ }, "strip", z.ZodTypeAny, {
1288
+ type: "stderr_delta";
1289
+ text: string;
1290
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1291
+ hostKind?: "workstation" | "external_computer" | undefined;
1292
+ hostProfile?: string | undefined;
1293
+ }, {
1294
+ type: "stderr_delta";
1295
+ text: string;
1296
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1297
+ hostKind?: "workstation" | "external_computer" | undefined;
1298
+ hostProfile?: string | undefined;
1299
+ }>, z.ZodObject<{
1300
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1301
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1302
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1303
+ } & {
1304
+ type: z.ZodLiteral<"artifact">;
1305
+ path: z.ZodString;
1306
+ label: z.ZodOptional<z.ZodString>;
1307
+ }, "strip", z.ZodTypeAny, {
1308
+ type: "artifact";
1309
+ path: string;
1310
+ label?: string | undefined;
1311
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1312
+ hostKind?: "workstation" | "external_computer" | undefined;
1313
+ hostProfile?: string | undefined;
1314
+ }, {
1315
+ type: "artifact";
1316
+ path: string;
1317
+ label?: string | undefined;
1318
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1319
+ hostKind?: "workstation" | "external_computer" | undefined;
1320
+ hostProfile?: string | undefined;
1321
+ }>, z.ZodObject<{
1322
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1323
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1324
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1325
+ } & {
1326
+ type: z.ZodLiteral<"usage">;
1327
+ usage: z.ZodObject<{
1328
+ inputTokens: z.ZodOptional<z.ZodNumber>;
1329
+ outputTokens: z.ZodOptional<z.ZodNumber>;
1330
+ thinkingTokens: z.ZodOptional<z.ZodNumber>;
1331
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
1332
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
1333
+ totalTokens: z.ZodOptional<z.ZodNumber>;
1334
+ }, "strip", z.ZodTypeAny, {
1335
+ inputTokens?: number | undefined;
1336
+ outputTokens?: number | undefined;
1337
+ thinkingTokens?: number | undefined;
1338
+ cacheReadInputTokens?: number | undefined;
1339
+ cacheCreationInputTokens?: number | undefined;
1340
+ totalTokens?: number | undefined;
1341
+ }, {
1342
+ inputTokens?: number | undefined;
1343
+ outputTokens?: number | undefined;
1344
+ thinkingTokens?: number | undefined;
1345
+ cacheReadInputTokens?: number | undefined;
1346
+ cacheCreationInputTokens?: number | undefined;
1347
+ totalTokens?: number | undefined;
1348
+ }>;
1349
+ }, "strip", z.ZodTypeAny, {
1350
+ type: "usage";
1351
+ usage: {
1352
+ inputTokens?: number | undefined;
1353
+ outputTokens?: number | undefined;
1354
+ thinkingTokens?: number | undefined;
1355
+ cacheReadInputTokens?: number | undefined;
1356
+ cacheCreationInputTokens?: number | undefined;
1357
+ totalTokens?: number | undefined;
1358
+ };
1359
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1360
+ hostKind?: "workstation" | "external_computer" | undefined;
1361
+ hostProfile?: string | undefined;
1362
+ }, {
1363
+ type: "usage";
1364
+ usage: {
1365
+ inputTokens?: number | undefined;
1366
+ outputTokens?: number | undefined;
1367
+ thinkingTokens?: number | undefined;
1368
+ cacheReadInputTokens?: number | undefined;
1369
+ cacheCreationInputTokens?: number | undefined;
1370
+ totalTokens?: number | undefined;
1371
+ };
1372
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1373
+ hostKind?: "workstation" | "external_computer" | undefined;
1374
+ hostProfile?: string | undefined;
1375
+ }>, z.ZodObject<{
1376
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1377
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1378
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1379
+ } & {
1380
+ type: z.ZodLiteral<"result">;
1381
+ result: z.ZodObject<{
1382
+ success: z.ZodBoolean;
1383
+ text: z.ZodOptional<z.ZodString>;
1384
+ sessionId: z.ZodOptional<z.ZodString>;
1385
+ artifacts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
1386
+ usage: z.ZodOptional<z.ZodObject<{
1387
+ inputTokens: z.ZodOptional<z.ZodNumber>;
1388
+ outputTokens: z.ZodOptional<z.ZodNumber>;
1389
+ thinkingTokens: z.ZodOptional<z.ZodNumber>;
1390
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
1391
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
1392
+ totalTokens: z.ZodOptional<z.ZodNumber>;
1393
+ }, "strip", z.ZodTypeAny, {
1394
+ inputTokens?: number | undefined;
1395
+ outputTokens?: number | undefined;
1396
+ thinkingTokens?: number | undefined;
1397
+ cacheReadInputTokens?: number | undefined;
1398
+ cacheCreationInputTokens?: number | undefined;
1399
+ totalTokens?: number | undefined;
1400
+ }, {
1401
+ inputTokens?: number | undefined;
1402
+ outputTokens?: number | undefined;
1403
+ thinkingTokens?: number | undefined;
1404
+ cacheReadInputTokens?: number | undefined;
1405
+ cacheCreationInputTokens?: number | undefined;
1406
+ totalTokens?: number | undefined;
1407
+ }>>;
1408
+ error: z.ZodOptional<z.ZodString>;
1409
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1410
+ }, "strip", z.ZodTypeAny, {
1411
+ success: boolean;
1412
+ error?: string | undefined;
1413
+ sessionId?: string | undefined;
1414
+ text?: string | undefined;
1415
+ usage?: {
1416
+ inputTokens?: number | undefined;
1417
+ outputTokens?: number | undefined;
1418
+ thinkingTokens?: number | undefined;
1419
+ cacheReadInputTokens?: number | undefined;
1420
+ cacheCreationInputTokens?: number | undefined;
1421
+ totalTokens?: number | undefined;
1422
+ } | undefined;
1423
+ artifacts?: Record<string, unknown>[] | undefined;
1424
+ metadata?: Record<string, unknown> | undefined;
1425
+ }, {
1426
+ success: boolean;
1427
+ error?: string | undefined;
1428
+ sessionId?: string | undefined;
1429
+ text?: string | undefined;
1430
+ usage?: {
1431
+ inputTokens?: number | undefined;
1432
+ outputTokens?: number | undefined;
1433
+ thinkingTokens?: number | undefined;
1434
+ cacheReadInputTokens?: number | undefined;
1435
+ cacheCreationInputTokens?: number | undefined;
1436
+ totalTokens?: number | undefined;
1437
+ } | undefined;
1438
+ artifacts?: Record<string, unknown>[] | undefined;
1439
+ metadata?: Record<string, unknown> | undefined;
1440
+ }>;
1441
+ }, "strip", z.ZodTypeAny, {
1442
+ type: "result";
1443
+ result: {
1444
+ success: boolean;
1445
+ error?: string | undefined;
1446
+ sessionId?: string | undefined;
1447
+ text?: string | undefined;
1448
+ usage?: {
1449
+ inputTokens?: number | undefined;
1450
+ outputTokens?: number | undefined;
1451
+ thinkingTokens?: number | undefined;
1452
+ cacheReadInputTokens?: number | undefined;
1453
+ cacheCreationInputTokens?: number | undefined;
1454
+ totalTokens?: number | undefined;
1455
+ } | undefined;
1456
+ artifacts?: Record<string, unknown>[] | undefined;
1457
+ metadata?: Record<string, unknown> | undefined;
1458
+ };
1459
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1460
+ hostKind?: "workstation" | "external_computer" | undefined;
1461
+ hostProfile?: string | undefined;
1462
+ }, {
1463
+ type: "result";
1464
+ result: {
1465
+ success: boolean;
1466
+ error?: string | undefined;
1467
+ sessionId?: string | undefined;
1468
+ text?: string | undefined;
1469
+ usage?: {
1470
+ inputTokens?: number | undefined;
1471
+ outputTokens?: number | undefined;
1472
+ thinkingTokens?: number | undefined;
1473
+ cacheReadInputTokens?: number | undefined;
1474
+ cacheCreationInputTokens?: number | undefined;
1475
+ totalTokens?: number | undefined;
1476
+ } | undefined;
1477
+ artifacts?: Record<string, unknown>[] | undefined;
1478
+ metadata?: Record<string, unknown> | undefined;
1479
+ };
1480
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1481
+ hostKind?: "workstation" | "external_computer" | undefined;
1482
+ hostProfile?: string | undefined;
1483
+ }>, z.ZodObject<{
1484
+ engineId: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "hermes", "openclaw", "custom"]>>;
1485
+ hostKind: z.ZodOptional<z.ZodEnum<["workstation", "external_computer"]>>;
1486
+ hostProfile: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["coding", "sre"]>, z.ZodString]>>;
1487
+ } & {
1488
+ type: z.ZodLiteral<"error">;
1489
+ error: z.ZodString;
1490
+ code: z.ZodOptional<z.ZodString>;
1491
+ }, "strip", z.ZodTypeAny, {
1492
+ type: "error";
1493
+ error: string;
1494
+ code?: string | undefined;
1495
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1496
+ hostKind?: "workstation" | "external_computer" | undefined;
1497
+ hostProfile?: string | undefined;
1498
+ }, {
1499
+ type: "error";
1500
+ error: string;
1501
+ code?: string | undefined;
1502
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1503
+ hostKind?: "workstation" | "external_computer" | undefined;
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;
1582
+ }>]>>;
325
1583
  }, "strip", z.ZodTypeAny, {
326
1584
  taskId: string;
327
1585
  content: string;
328
1586
  meta?: Record<string, unknown> | undefined;
1587
+ engineEvent?: {
1588
+ type: "status";
1589
+ text: string;
1590
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1591
+ hostKind?: "workstation" | "external_computer" | undefined;
1592
+ hostProfile?: string | undefined;
1593
+ } | {
1594
+ type: "content_delta";
1595
+ text: string;
1596
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1597
+ hostKind?: "workstation" | "external_computer" | undefined;
1598
+ hostProfile?: string | undefined;
1599
+ } | {
1600
+ type: "thinking_delta";
1601
+ text: string;
1602
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1603
+ hostKind?: "workstation" | "external_computer" | undefined;
1604
+ hostProfile?: string | undefined;
1605
+ } | {
1606
+ type: "tool_call";
1607
+ name: string;
1608
+ input?: unknown;
1609
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1610
+ hostKind?: "workstation" | "external_computer" | undefined;
1611
+ hostProfile?: string | undefined;
1612
+ } | {
1613
+ type: "tool_result_delta";
1614
+ text: string;
1615
+ name?: string | undefined;
1616
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1617
+ hostKind?: "workstation" | "external_computer" | undefined;
1618
+ hostProfile?: string | undefined;
1619
+ } | {
1620
+ type: "stderr_delta";
1621
+ text: string;
1622
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1623
+ hostKind?: "workstation" | "external_computer" | undefined;
1624
+ hostProfile?: string | undefined;
1625
+ } | {
1626
+ type: "artifact";
1627
+ path: string;
1628
+ label?: string | undefined;
1629
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1630
+ hostKind?: "workstation" | "external_computer" | undefined;
1631
+ hostProfile?: string | undefined;
1632
+ } | {
1633
+ type: "usage";
1634
+ usage: {
1635
+ inputTokens?: number | undefined;
1636
+ outputTokens?: number | undefined;
1637
+ thinkingTokens?: number | undefined;
1638
+ cacheReadInputTokens?: number | undefined;
1639
+ cacheCreationInputTokens?: number | undefined;
1640
+ totalTokens?: number | undefined;
1641
+ };
1642
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1643
+ hostKind?: "workstation" | "external_computer" | undefined;
1644
+ hostProfile?: string | undefined;
1645
+ } | {
1646
+ type: "result";
1647
+ result: {
1648
+ success: boolean;
1649
+ error?: string | undefined;
1650
+ sessionId?: string | undefined;
1651
+ text?: string | undefined;
1652
+ usage?: {
1653
+ inputTokens?: number | undefined;
1654
+ outputTokens?: number | undefined;
1655
+ thinkingTokens?: number | undefined;
1656
+ cacheReadInputTokens?: number | undefined;
1657
+ cacheCreationInputTokens?: number | undefined;
1658
+ totalTokens?: number | undefined;
1659
+ } | undefined;
1660
+ artifacts?: Record<string, unknown>[] | undefined;
1661
+ metadata?: Record<string, unknown> | undefined;
1662
+ };
1663
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1664
+ hostKind?: "workstation" | "external_computer" | undefined;
1665
+ hostProfile?: string | undefined;
1666
+ } | {
1667
+ type: "error";
1668
+ error: string;
1669
+ code?: string | undefined;
1670
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1671
+ hostKind?: "workstation" | "external_computer" | undefined;
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;
1695
+ } | undefined;
329
1696
  }, {
330
1697
  taskId: string;
331
1698
  content: string;
332
1699
  meta?: Record<string, unknown> | undefined;
1700
+ engineEvent?: {
1701
+ type: "status";
1702
+ text: string;
1703
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1704
+ hostKind?: "workstation" | "external_computer" | undefined;
1705
+ hostProfile?: string | undefined;
1706
+ } | {
1707
+ type: "content_delta";
1708
+ text: string;
1709
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1710
+ hostKind?: "workstation" | "external_computer" | undefined;
1711
+ hostProfile?: string | undefined;
1712
+ } | {
1713
+ type: "thinking_delta";
1714
+ text: string;
1715
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1716
+ hostKind?: "workstation" | "external_computer" | undefined;
1717
+ hostProfile?: string | undefined;
1718
+ } | {
1719
+ type: "tool_call";
1720
+ name: string;
1721
+ input?: unknown;
1722
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1723
+ hostKind?: "workstation" | "external_computer" | undefined;
1724
+ hostProfile?: string | undefined;
1725
+ } | {
1726
+ type: "tool_result_delta";
1727
+ text: string;
1728
+ name?: string | undefined;
1729
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1730
+ hostKind?: "workstation" | "external_computer" | undefined;
1731
+ hostProfile?: string | undefined;
1732
+ } | {
1733
+ type: "stderr_delta";
1734
+ text: string;
1735
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1736
+ hostKind?: "workstation" | "external_computer" | undefined;
1737
+ hostProfile?: string | undefined;
1738
+ } | {
1739
+ type: "artifact";
1740
+ path: string;
1741
+ label?: string | undefined;
1742
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1743
+ hostKind?: "workstation" | "external_computer" | undefined;
1744
+ hostProfile?: string | undefined;
1745
+ } | {
1746
+ type: "usage";
1747
+ usage: {
1748
+ inputTokens?: number | undefined;
1749
+ outputTokens?: number | undefined;
1750
+ thinkingTokens?: number | undefined;
1751
+ cacheReadInputTokens?: number | undefined;
1752
+ cacheCreationInputTokens?: number | undefined;
1753
+ totalTokens?: number | undefined;
1754
+ };
1755
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1756
+ hostKind?: "workstation" | "external_computer" | undefined;
1757
+ hostProfile?: string | undefined;
1758
+ } | {
1759
+ type: "result";
1760
+ result: {
1761
+ success: boolean;
1762
+ error?: string | undefined;
1763
+ sessionId?: string | undefined;
1764
+ text?: string | undefined;
1765
+ usage?: {
1766
+ inputTokens?: number | undefined;
1767
+ outputTokens?: number | undefined;
1768
+ thinkingTokens?: number | undefined;
1769
+ cacheReadInputTokens?: number | undefined;
1770
+ cacheCreationInputTokens?: number | undefined;
1771
+ totalTokens?: number | undefined;
1772
+ } | undefined;
1773
+ artifacts?: Record<string, unknown>[] | undefined;
1774
+ metadata?: Record<string, unknown> | undefined;
1775
+ };
1776
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1777
+ hostKind?: "workstation" | "external_computer" | undefined;
1778
+ hostProfile?: string | undefined;
1779
+ } | {
1780
+ type: "error";
1781
+ error: string;
1782
+ code?: string | undefined;
1783
+ engineId?: "custom" | "claude-code" | "codex" | "hermes" | "openclaw" | undefined;
1784
+ hostKind?: "workstation" | "external_computer" | undefined;
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;
1808
+ } | undefined;
333
1809
  }>;
334
1810
  export declare const TaskThinkingEventSchema: z.ZodObject<{
335
1811
  taskId: z.ZodString;
@@ -357,20 +1833,20 @@ export declare const TaskCompleteEventSchema: z.ZodObject<{
357
1833
  }>>;
358
1834
  }, "strip", z.ZodTypeAny, {
359
1835
  taskId: string;
360
- result?: unknown;
361
1836
  sessionId?: string | undefined;
362
1837
  usage?: {
363
1838
  input: number;
364
1839
  output: number;
365
1840
  } | undefined;
1841
+ result?: unknown;
366
1842
  }, {
367
1843
  taskId: string;
368
- result?: unknown;
369
1844
  sessionId?: string | undefined;
370
1845
  usage?: {
371
1846
  input: number;
372
1847
  output: number;
373
1848
  } | undefined;
1849
+ result?: unknown;
374
1850
  }>;
375
1851
  export declare const TaskErrorEventSchema: z.ZodObject<{
376
1852
  taskId: z.ZodString;
@@ -407,6 +1883,24 @@ export declare const TaskResumeEventSchema: z.ZodObject<{
407
1883
  taskId: string;
408
1884
  }>;
409
1885
  export type TaskDeltaPayload = z.infer<typeof TaskDeltaEventSchema>;
1886
+ export type EngineId = z.infer<typeof EngineIdSchema>;
1887
+ export type HostKind = z.infer<typeof HostKindSchema>;
1888
+ export type HostProfile = z.infer<typeof HostProfileSchema>;
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>;
1898
+ export type EngineCapabilityProfile = z.infer<typeof EngineCapabilityProfileSchema>;
1899
+ export type EngineInvocationPlanV1 = z.infer<typeof EngineInvocationPlanV1Schema>;
1900
+ export type EngineProgressEventType = z.infer<typeof EngineProgressEventTypeSchema>;
1901
+ export type EngineProgressEvent = z.infer<typeof EngineProgressEventSchema>;
1902
+ export type EngineFinalResult = z.infer<typeof EngineFinalResultSchema>;
1903
+ export type EngineTokenUsage = z.infer<typeof EngineTokenUsageSchema>;
410
1904
  export type TaskThinkingPayload = z.infer<typeof TaskThinkingEventSchema>;
411
1905
  export type TaskCompletePayload = z.infer<typeof TaskCompleteEventSchema>;
412
1906
  export type TaskErrorPayload = z.infer<typeof TaskErrorEventSchema>;
@@ -419,13 +1913,13 @@ export declare const ToolCallParamsSchema: z.ZodObject<{
419
1913
  args: z.ZodUnknown;
420
1914
  taskId: z.ZodOptional<z.ZodString>;
421
1915
  }, "strip", z.ZodTypeAny, {
422
- callId: string;
423
1916
  toolName: string;
1917
+ callId: string;
424
1918
  taskId?: string | undefined;
425
1919
  args?: unknown;
426
1920
  }, {
427
- callId: string;
428
1921
  toolName: string;
1922
+ callId: string;
429
1923
  taskId?: string | undefined;
430
1924
  args?: unknown;
431
1925
  }>;
@@ -469,8 +1963,8 @@ export declare const AgentCreateParamsSchema: z.ZodObject<{
469
1963
  name: string;
470
1964
  agentType: string;
471
1965
  runtime: string;
472
- endpoint?: string | undefined;
473
1966
  workDir?: string | undefined;
1967
+ endpoint?: string | undefined;
474
1968
  endpointToken?: string | undefined;
475
1969
  hermesEndpoint?: string | undefined;
476
1970
  tools?: string[] | undefined;
@@ -482,8 +1976,8 @@ export declare const AgentCreateParamsSchema: z.ZodObject<{
482
1976
  name: string;
483
1977
  agentType: string;
484
1978
  runtime: string;
485
- endpoint?: string | undefined;
486
1979
  workDir?: string | undefined;
1980
+ endpoint?: string | undefined;
487
1981
  endpointToken?: string | undefined;
488
1982
  hermesEndpoint?: string | undefined;
489
1983
  tools?: string[] | undefined;
@@ -728,6 +2222,7 @@ export declare const SessionDetailResponseSchema: z.ZodObject<{
728
2222
  title: string;
729
2223
  createdAt: string;
730
2224
  updatedAt: string;
2225
+ metadata?: unknown;
731
2226
  messageCount?: number | undefined;
732
2227
  messages?: {
733
2228
  content: string;
@@ -736,12 +2231,12 @@ export declare const SessionDetailResponseSchema: z.ZodObject<{
736
2231
  toolUse?: unknown;
737
2232
  }[] | undefined;
738
2233
  replayGuide?: string | undefined;
739
- metadata?: unknown;
740
2234
  }, {
741
2235
  sessionId: string;
742
2236
  title: string;
743
2237
  createdAt: string;
744
2238
  updatedAt: string;
2239
+ metadata?: unknown;
745
2240
  messageCount?: number | undefined;
746
2241
  messages?: {
747
2242
  content: string;
@@ -750,7 +2245,6 @@ export declare const SessionDetailResponseSchema: z.ZodObject<{
750
2245
  toolUse?: unknown;
751
2246
  }[] | undefined;
752
2247
  replayGuide?: string | undefined;
753
- metadata?: unknown;
754
2248
  }>;
755
2249
  export type SessionListParams = z.infer<typeof SessionListParamsSchema>;
756
2250
  export type SessionListResponse = z.infer<typeof SessionListResponseSchema>;
@@ -868,13 +2362,13 @@ export declare const AgentProfileSchema: z.ZodObject<{
868
2362
  category: z.ZodOptional<z.ZodString>;
869
2363
  }, "strip", z.ZodTypeAny, {
870
2364
  name: string;
871
- description?: string | undefined;
872
2365
  source?: string | undefined;
2366
+ description?: string | undefined;
873
2367
  category?: string | undefined;
874
2368
  }, {
875
2369
  name: string;
876
- description?: string | undefined;
877
2370
  source?: string | undefined;
2371
+ description?: string | undefined;
878
2372
  category?: string | undefined;
879
2373
  }>, "many">;
880
2374
  toolCategories: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
@@ -884,8 +2378,8 @@ export declare const AgentProfileSchema: z.ZodObject<{
884
2378
  tools: string[];
885
2379
  skills: {
886
2380
  name: string;
887
- description?: string | undefined;
888
2381
  source?: string | undefined;
2382
+ description?: string | undefined;
889
2383
  category?: string | undefined;
890
2384
  }[];
891
2385
  toolCategories: Record<string, string[]>;
@@ -895,8 +2389,8 @@ export declare const AgentProfileSchema: z.ZodObject<{
895
2389
  tools: string[];
896
2390
  skills: {
897
2391
  name: string;
898
- description?: string | undefined;
899
2392
  source?: string | undefined;
2393
+ description?: string | undefined;
900
2394
  category?: string | undefined;
901
2395
  }[];
902
2396
  toolCategories: Record<string, string[]>;
@@ -914,13 +2408,13 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
914
2408
  category: z.ZodOptional<z.ZodString>;
915
2409
  }, "strip", z.ZodTypeAny, {
916
2410
  name: string;
917
- description?: string | undefined;
918
2411
  source?: string | undefined;
2412
+ description?: string | undefined;
919
2413
  category?: string | undefined;
920
2414
  }, {
921
2415
  name: string;
922
- description?: string | undefined;
923
2416
  source?: string | undefined;
2417
+ description?: string | undefined;
924
2418
  category?: string | undefined;
925
2419
  }>, "many">;
926
2420
  toolCategories: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
@@ -930,8 +2424,8 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
930
2424
  tools: string[];
931
2425
  skills: {
932
2426
  name: string;
933
- description?: string | undefined;
934
2427
  source?: string | undefined;
2428
+ description?: string | undefined;
935
2429
  category?: string | undefined;
936
2430
  }[];
937
2431
  toolCategories: Record<string, string[]>;
@@ -941,8 +2435,8 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
941
2435
  tools: string[];
942
2436
  skills: {
943
2437
  name: string;
944
- description?: string | undefined;
945
2438
  source?: string | undefined;
2439
+ description?: string | undefined;
946
2440
  category?: string | undefined;
947
2441
  }[];
948
2442
  toolCategories: Record<string, string[]>;
@@ -954,8 +2448,8 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
954
2448
  tools: string[];
955
2449
  skills: {
956
2450
  name: string;
957
- description?: string | undefined;
958
2451
  source?: string | undefined;
2452
+ description?: string | undefined;
959
2453
  category?: string | undefined;
960
2454
  }[];
961
2455
  toolCategories: Record<string, string[]>;
@@ -967,8 +2461,8 @@ export declare const ComputerHeartbeatPayloadSchema: z.ZodOptional<z.ZodObject<{
967
2461
  tools: string[];
968
2462
  skills: {
969
2463
  name: string;
970
- description?: string | undefined;
971
2464
  source?: string | undefined;
2465
+ description?: string | undefined;
972
2466
  category?: string | undefined;
973
2467
  }[];
974
2468
  toolCategories: Record<string, string[]>;