@compozy/extension-sdk 0.3.0-beta.9 → 0.4.0

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 (115) hide show
  1. package/dist/cjs/connectivity-provider.js +11 -24
  2. package/dist/cjs/connectivity-provider.js.map +1 -1
  3. package/dist/cjs/errors.js +6 -1
  4. package/dist/cjs/errors.js.map +1 -1
  5. package/dist/cjs/extension-context.js +2 -1
  6. package/dist/cjs/extension-context.js.map +1 -1
  7. package/dist/cjs/extension-describe.js +62 -14
  8. package/dist/cjs/extension-describe.js.map +1 -1
  9. package/dist/cjs/extension-initialize.js +5 -0
  10. package/dist/cjs/extension-initialize.js.map +1 -1
  11. package/dist/cjs/extension-session.js +3 -0
  12. package/dist/cjs/extension-session.js.map +1 -1
  13. package/dist/cjs/extension-tool-dispatch.js +35 -0
  14. package/dist/cjs/extension-tool-dispatch.js.map +1 -0
  15. package/dist/cjs/extension-tool-registration.js +1 -0
  16. package/dist/cjs/extension-tool-registration.js.map +1 -1
  17. package/dist/cjs/extension.js +41 -55
  18. package/dist/cjs/extension.js.map +1 -1
  19. package/dist/cjs/forge-provider.js +90 -0
  20. package/dist/cjs/forge-provider.js.map +1 -0
  21. package/dist/cjs/generated/contracts.js +4 -3
  22. package/dist/cjs/generated/contracts.js.map +1 -1
  23. package/dist/cjs/host-api.js +0 -33
  24. package/dist/cjs/host-api.js.map +1 -1
  25. package/dist/cjs/index.js +16 -1
  26. package/dist/cjs/index.js.map +1 -1
  27. package/dist/cjs/protocol-params.js +23 -0
  28. package/dist/cjs/protocol-params.js.map +1 -0
  29. package/dist/cjs/testing/harness.js +4 -3
  30. package/dist/cjs/testing/harness.js.map +1 -1
  31. package/dist/cjs/testing/mock-transport.js +42 -2
  32. package/dist/cjs/testing/mock-transport.js.map +1 -1
  33. package/dist/cjs/transport.js +81 -8
  34. package/dist/cjs/transport.js.map +1 -1
  35. package/dist/cjs/view-provider.js +148 -0
  36. package/dist/cjs/view-provider.js.map +1 -0
  37. package/dist/cjs/view-session-registry.js +41 -0
  38. package/dist/cjs/view-session-registry.js.map +1 -0
  39. package/dist/esm/connectivity-provider.js +4 -17
  40. package/dist/esm/connectivity-provider.js.map +1 -1
  41. package/dist/esm/errors.js +6 -1
  42. package/dist/esm/errors.js.map +1 -1
  43. package/dist/esm/extension-context.js +2 -1
  44. package/dist/esm/extension-context.js.map +1 -1
  45. package/dist/esm/extension-describe.js +61 -14
  46. package/dist/esm/extension-describe.js.map +1 -1
  47. package/dist/esm/extension-initialize.js +5 -0
  48. package/dist/esm/extension-initialize.js.map +1 -1
  49. package/dist/esm/extension-session.js +3 -0
  50. package/dist/esm/extension-session.js.map +1 -1
  51. package/dist/esm/extension-tool-dispatch.js +31 -0
  52. package/dist/esm/extension-tool-dispatch.js.map +1 -0
  53. package/dist/esm/extension-tool-registration.js +1 -0
  54. package/dist/esm/extension-tool-registration.js.map +1 -1
  55. package/dist/esm/extension.js +43 -57
  56. package/dist/esm/extension.js.map +1 -1
  57. package/dist/esm/forge-provider.js +86 -0
  58. package/dist/esm/forge-provider.js.map +1 -0
  59. package/dist/esm/generated/contracts.js +4 -3
  60. package/dist/esm/generated/contracts.js.map +1 -1
  61. package/dist/esm/host-api.js +0 -33
  62. package/dist/esm/host-api.js.map +1 -1
  63. package/dist/esm/index.js +4 -1
  64. package/dist/esm/index.js.map +1 -1
  65. package/dist/esm/protocol-params.js +18 -0
  66. package/dist/esm/protocol-params.js.map +1 -0
  67. package/dist/esm/testing/harness.js +4 -3
  68. package/dist/esm/testing/harness.js.map +1 -1
  69. package/dist/esm/testing/mock-transport.js +42 -2
  70. package/dist/esm/testing/mock-transport.js.map +1 -1
  71. package/dist/esm/transport.js +80 -7
  72. package/dist/esm/transport.js.map +1 -1
  73. package/dist/esm/view-provider.js +144 -0
  74. package/dist/esm/view-provider.js.map +1 -0
  75. package/dist/esm/view-session-registry.js +37 -0
  76. package/dist/esm/view-session-registry.js.map +1 -0
  77. package/dist/types/connectivity-provider.d.ts.map +1 -1
  78. package/dist/types/errors.d.ts +1 -0
  79. package/dist/types/errors.d.ts.map +1 -1
  80. package/dist/types/extension-context.d.ts +1 -1
  81. package/dist/types/extension-context.d.ts.map +1 -1
  82. package/dist/types/extension-contract.d.ts +2 -0
  83. package/dist/types/extension-contract.d.ts.map +1 -1
  84. package/dist/types/extension-describe.d.ts +2 -1
  85. package/dist/types/extension-describe.d.ts.map +1 -1
  86. package/dist/types/extension-initialize.d.ts.map +1 -1
  87. package/dist/types/extension-session.d.ts.map +1 -1
  88. package/dist/types/extension-tool-dispatch.d.ts +5 -0
  89. package/dist/types/extension-tool-dispatch.d.ts.map +1 -0
  90. package/dist/types/extension-tool-registration.d.ts.map +1 -1
  91. package/dist/types/extension.d.ts +2 -1
  92. package/dist/types/extension.d.ts.map +1 -1
  93. package/dist/types/forge-provider.d.ts +14 -0
  94. package/dist/types/forge-provider.d.ts.map +1 -0
  95. package/dist/types/generated/contracts.d.ts +1272 -1411
  96. package/dist/types/generated/contracts.d.ts.map +1 -1
  97. package/dist/types/host-api.d.ts +1 -31
  98. package/dist/types/host-api.d.ts.map +1 -1
  99. package/dist/types/index.d.ts +7 -2
  100. package/dist/types/index.d.ts.map +1 -1
  101. package/dist/types/protocol-params.d.ts +4 -0
  102. package/dist/types/protocol-params.d.ts.map +1 -0
  103. package/dist/types/testing/harness.d.ts +1 -1
  104. package/dist/types/testing/harness.d.ts.map +1 -1
  105. package/dist/types/testing/mock-transport.d.ts +1 -1
  106. package/dist/types/testing/mock-transport.d.ts.map +1 -1
  107. package/dist/types/transport.d.ts +8 -4
  108. package/dist/types/transport.d.ts.map +1 -1
  109. package/dist/types/types.d.ts +5 -19
  110. package/dist/types/types.d.ts.map +1 -1
  111. package/dist/types/view-provider.d.ts +18 -0
  112. package/dist/types/view-provider.d.ts.map +1 -0
  113. package/dist/types/view-session-registry.d.ts +12 -0
  114. package/dist/types/view-session-registry.d.ts.map +1 -0
  115. package/package.json +45 -45
@@ -1,5 +1,5 @@
1
1
  import type { ISODateTime, JSONValue } from "../base-types.js";
2
- export type HostAPIMethod = "agents/heartbeat/delete" | "agents/heartbeat/get" | "agents/heartbeat/history" | "agents/heartbeat/put" | "agents/heartbeat/rollback" | "agents/heartbeat/status" | "agents/heartbeat/validate" | "agents/heartbeat/wake" | "agents/soul/delete" | "agents/soul/get" | "agents/soul/history" | "agents/soul/put" | "agents/soul/rollback" | "agents/soul/validate" | "automation/jobs" | "automation/jobs/create" | "automation/jobs/delete" | "automation/jobs/get" | "automation/jobs/runs" | "automation/jobs/trigger" | "automation/jobs/update" | "automation/runs" | "automation/triggers" | "automation/triggers/create" | "automation/triggers/delete" | "automation/triggers/fire" | "automation/triggers/get" | "automation/triggers/runs" | "automation/triggers/update" | "bridges/instances/get" | "bridges/instances/list" | "bridges/instances/report_state" | "bridges/messages/ingest" | "clarify/ask" | "logs/list" | "memory/forget" | "memory/recall" | "memory/store" | "models/list" | "models/refresh" | "models/status" | "network/channels" | "network/direct/messages" | "network/direct/resolve" | "network/directs" | "network/peers" | "network/send" | "network/status" | "network/thread/get" | "network/thread/messages" | "network/threads" | "network/usage" | "network/work/get" | "observe/health" | "resources/get" | "resources/list" | "resources/snapshot" | "sandbox/exec" | "sandbox/info" | "sandbox/list" | "sessions/archive" | "sessions/create" | "sessions/events" | "sessions/health/get" | "sessions/inputs/cancel" | "sessions/inputs/list" | "sessions/inputs/promote" | "sessions/inputs/replace" | "sessions/list" | "sessions/prompt" | "sessions/runtime/clear" | "sessions/runtime/set" | "sessions/soul/refresh" | "sessions/status" | "sessions/status/get" | "sessions/stop" | "sessions/unarchive" | "skills/list" | "tasks" | "tasks/cancel" | "tasks/create" | "tasks/dashboard" | "tasks/get" | "tasks/inbox" | "tasks/runs" | "tasks/runs/attach_session" | "tasks/runs/cancel" | "tasks/runs/complete" | "tasks/runs/enqueue" | "tasks/runs/fail" | "tasks/runs/get" | "tasks/runs/start" | "tasks/timeline" | "tasks/tree" | "tasks/update";
2
+ export type HostAPIMethod = "agents/heartbeat/delete" | "agents/heartbeat/get" | "agents/heartbeat/history" | "agents/heartbeat/put" | "agents/heartbeat/rollback" | "agents/heartbeat/status" | "agents/heartbeat/validate" | "agents/heartbeat/wake" | "agents/soul/delete" | "agents/soul/get" | "agents/soul/history" | "agents/soul/put" | "agents/soul/rollback" | "agents/soul/validate" | "automation/jobs" | "automation/jobs/create" | "automation/jobs/delete" | "automation/jobs/get" | "automation/jobs/runs" | "automation/jobs/trigger" | "automation/jobs/update" | "automation/runs" | "automation/triggers" | "automation/triggers/create" | "automation/triggers/delete" | "automation/triggers/fire" | "automation/triggers/get" | "automation/triggers/runs" | "automation/triggers/update" | "clarify/ask" | "logs/list" | "models/list" | "models/refresh" | "models/status" | "observe/health" | "resources/get" | "resources/list" | "resources/snapshot" | "sessions/archive" | "sessions/create" | "sessions/events" | "sessions/health/get" | "sessions/inputs/cancel" | "sessions/inputs/list" | "sessions/inputs/promote" | "sessions/inputs/replace" | "sessions/list" | "sessions/prompt" | "sessions/runtime/clear" | "sessions/runtime/set" | "sessions/soul/refresh" | "sessions/status" | "sessions/status/get" | "sessions/stop" | "sessions/unarchive" | "skills/list" | "tasks" | "tasks/cancel" | "tasks/create" | "tasks/dashboard" | "tasks/get" | "tasks/inbox" | "tasks/runs" | "tasks/runs/attach_session" | "tasks/runs/cancel" | "tasks/runs/complete" | "tasks/runs/enqueue" | "tasks/runs/fail" | "tasks/runs/get" | "tasks/runs/result" | "tasks/runs/start" | "tasks/timeline" | "tasks/tree" | "tasks/update" | "view/patch";
3
3
  export interface AcceptedCapabilities {
4
4
  provides: string[];
5
5
  permissions: HostAPIMethod[];
@@ -7,16 +7,18 @@ export interface AcceptedCapabilities {
7
7
  export interface AgentCrashedPatch {
8
8
  labels?: Record<string, string>;
9
9
  }
10
- export type HookEvent = "session.pre_create" | "session.post_create" | "session.pre_resume" | "session.post_resume" | "session.pre_stop" | "session.post_stop" | "session.message_persisted" | "sandbox.prepare" | "sandbox.ready" | "sandbox.sync.before" | "sandbox.sync.after" | "sandbox.stop" | "input.pre_submit" | "prompt.post_assemble" | "event.pre_record" | "event.post_record" | "automation.job.pre_fire" | "automation.job.post_fire" | "automation.trigger.pre_fire" | "automation.trigger.post_fire" | "automation.run.completed" | "automation.run.failed" | "agent.pre_start" | "agent.spawned" | "agent.crashed" | "agent.stopped" | "agent.soul.snapshot.resolved" | "agent.soul.mutation.after" | "agent.heartbeat.policy.resolved" | "agent.heartbeat.wake.before" | "agent.heartbeat.wake.after" | "session.health.update.after" | "turn.start" | "turn.end" | "message.start" | "message.delta" | "message.end" | "tool.pre_call" | "tool.post_call" | "tool.post_error" | "permission.request" | "permission.resolved" | "permission.denied" | "context.pre_compact" | "context.post_compact" | "coordinator.pre_spawn" | "coordinator.spawned" | "coordinator.decision" | "coordinator.stopped" | "coordinator.failed" | "task.blocked" | "task.unblocked" | "task.needs_attention" | "task.recovered" | "task.status_changed" | "task.run.enqueued" | "task.run.pre_claim" | "task.run.post_claim" | "task.run.lease_extended" | "task.run.lease_expired" | "task.run.lease_recovered" | "task.run.released" | "task.run.completed" | "task.run.failed" | "loop.started" | "loop.generation.pre" | "loop.generation.post" | "loop.gate.pre" | "loop.gate.post" | "loop.node.terminal" | "loop.terminal" | "spawn.pre_create" | "spawn.created" | "spawn.parent_stopped" | "spawn.ttl_expired" | "spawn.reaped" | "network.thread.opened" | "network.direct_room.opened" | "network.message.persisted" | "network.work.opened" | "network.work.transitioned" | "network.work.closed" | "network.peer.joined" | "network.peer.left" | "network.participation.pre_resolve" | "network.participation.resolved" | "window_manager.layout.applied" | "window_manager.desktop.created" | "window_manager.desktop.deleted" | "window_manager.window.moved" | "window_manager.window.opened" | "window_manager.window.closed" | "window_manager.stack.grouped" | "window_manager.stack.ungrouped" | "window_manager.stack.activated";
10
+ export type HookEvent = "subagent.settled" | "session.pre_create" | "session.post_create" | "session.pre_resume" | "session.post_resume" | "session.pre_stop" | "session.post_stop" | "session.message_persisted" | "session.runtime_recovery.started" | "session.runtime_recovery.succeeded" | "session.runtime_recovery.exhausted" | "input.pre_submit" | "prompt.post_assemble" | "event.pre_record" | "event.post_record" | "automation.job.pre_fire" | "automation.job.post_fire" | "automation.trigger.pre_fire" | "automation.trigger.post_fire" | "automation.run.completed" | "automation.run.failed" | "agent.pre_start" | "agent.spawned" | "agent.crashed" | "agent.stopped" | "agent.soul.snapshot.resolved" | "agent.soul.mutation.after" | "agent.heartbeat.policy.resolved" | "agent.heartbeat.wake.before" | "agent.heartbeat.wake.after" | "session.health.update.after" | "turn.start" | "turn.end" | "message.start" | "message.delta" | "message.end" | "tool.pre_call" | "tool.post_call" | "tool.post_error" | "permission.request" | "permission.resolved" | "permission.denied" | "context.pre_compact" | "context.post_compact" | "coordinator.pre_spawn" | "coordinator.spawned" | "coordinator.decision" | "coordinator.stopped" | "coordinator.failed" | "task.blocked" | "task.unblocked" | "task.needs_attention" | "task.recovered" | "task.status_changed" | "task.run.enqueued" | "task.run.pre_claim" | "task.run.post_claim" | "task.run.lease_extended" | "task.run.lease_expired" | "task.run.lease_recovered" | "task.run.released" | "task.run.completed" | "task.run.failed" | "loop.started" | "loop.generation.pre" | "loop.generation.post" | "loop.gate.pre" | "loop.gate.post" | "loop.node.terminal" | "loop.terminal" | "spawn.pre_create" | "spawn.created" | "spawn.parent_stopped" | "spawn.ttl_expired" | "spawn.reaped" | "session.attention.changed" | "window_manager.layout.applied" | "window_manager.desktop.created" | "window_manager.desktop.deleted" | "window_manager.window.moved" | "window_manager.window.opened" | "window_manager.window.closed" | "window_manager.stack.grouped" | "window_manager.stack.ungrouped" | "window_manager.stack.activated" | "worktree.pre_create" | "worktree.pre_remove" | "worktree.created" | "worktree.adopted" | "worktree.removed" | "terminal.opened" | "terminal.closed" | "terminal.command_started" | "terminal.command_finished" | "terminal.input_requested" | "terminal.input_provided" | "terminal.recording_started" | "terminal.recording_stopped" | "terminal.subscriber_evicted" | "terminal.limit_rejected";
11
11
  export interface AgentCrashedPayload {
12
12
  event: HookEvent;
13
13
  timestamp: ISODateTime;
14
+ profile_id?: string;
14
15
  session_id?: string;
15
16
  session_name?: string;
16
17
  session_type?: string;
17
18
  agent_name?: string;
18
19
  workspace_id?: string;
19
20
  workspace?: string;
21
+ worktree_id?: string;
20
22
  acp_session_id?: string;
21
23
  state?: string;
22
24
  soul_snapshot_id?: string;
@@ -91,12 +93,14 @@ export interface AgentHeartbeatValidateParams {
91
93
  export interface AgentHeartbeatWakeAfterPayload {
92
94
  event: HookEvent;
93
95
  timestamp: ISODateTime;
96
+ profile_id?: string;
94
97
  session_id?: string;
95
98
  session_name?: string;
96
99
  session_type?: string;
97
100
  agent_name?: string;
98
101
  workspace_id?: string;
99
102
  workspace?: string;
103
+ worktree_id?: string;
100
104
  acp_session_id?: string;
101
105
  state?: string;
102
106
  soul_snapshot_id?: string;
@@ -115,12 +119,14 @@ export interface AgentHeartbeatWakeAfterPayload {
115
119
  export interface AgentHeartbeatWakeBeforePayload {
116
120
  event: HookEvent;
117
121
  timestamp: ISODateTime;
122
+ profile_id?: string;
118
123
  session_id?: string;
119
124
  session_name?: string;
120
125
  session_type?: string;
121
126
  agent_name?: string;
122
127
  workspace_id?: string;
123
128
  workspace?: string;
129
+ worktree_id?: string;
124
130
  acp_session_id?: string;
125
131
  state?: string;
126
132
  soul_snapshot_id?: string;
@@ -148,12 +154,14 @@ export interface AgentLifecyclePatch {
148
154
  export interface AgentLifecyclePayload {
149
155
  event: HookEvent;
150
156
  timestamp: ISODateTime;
157
+ profile_id?: string;
151
158
  session_id?: string;
152
159
  session_name?: string;
153
160
  session_type?: string;
154
161
  agent_name?: string;
155
162
  workspace_id?: string;
156
163
  workspace?: string;
164
+ worktree_id?: string;
157
165
  acp_session_id?: string;
158
166
  state?: string;
159
167
  soul_snapshot_id?: string;
@@ -171,12 +179,14 @@ export interface AgentLifecyclePayload {
171
179
  export interface AgentPreStartPayload {
172
180
  event: HookEvent;
173
181
  timestamp: ISODateTime;
182
+ profile_id?: string;
174
183
  session_id?: string;
175
184
  session_name?: string;
176
185
  session_type?: string;
177
186
  agent_name?: string;
178
187
  workspace_id?: string;
179
188
  workspace?: string;
189
+ worktree_id?: string;
180
190
  acp_session_id?: string;
181
191
  state?: string;
182
192
  soul_snapshot_id?: string;
@@ -278,7 +288,6 @@ export interface AgentSoulFrontmatterPayload {
278
288
  principles?: string[];
279
289
  constraints?: string[];
280
290
  collaboration?: string[];
281
- memory_policy?: string[];
282
291
  tags?: string[];
283
292
  }
284
293
  export interface AuthoredContextLimitsPayload {
@@ -391,12 +400,14 @@ export interface AgentSpawnedPatch {
391
400
  export interface AgentSpawnedPayload {
392
401
  event: HookEvent;
393
402
  timestamp: ISODateTime;
403
+ profile_id?: string;
394
404
  session_id?: string;
395
405
  session_name?: string;
396
406
  session_type?: string;
397
407
  agent_name?: string;
398
408
  workspace_id?: string;
399
409
  workspace?: string;
410
+ worktree_id?: string;
400
411
  acp_session_id?: string;
401
412
  state?: string;
402
413
  soul_snapshot_id?: string;
@@ -424,12 +435,14 @@ export interface AgentStoppedPatch {
424
435
  export interface AgentStoppedPayload {
425
436
  event: HookEvent;
426
437
  timestamp: ISODateTime;
438
+ profile_id?: string;
427
439
  session_id?: string;
428
440
  session_name?: string;
429
441
  session_type?: string;
430
442
  agent_name?: string;
431
443
  workspace_id?: string;
432
444
  workspace?: string;
445
+ worktree_id?: string;
433
446
  acp_session_id?: string;
434
447
  state?: string;
435
448
  soul_snapshot_id?: string;
@@ -493,39 +506,16 @@ export interface Ownership {
493
506
  kind: OwnerKind;
494
507
  ref: string;
495
508
  }
496
- export type NetworkParticipationRequest = {
497
- mode?: "local";
498
- channel_strategy?: never;
499
- channel_id?: never;
500
- bounds?: never;
501
- } | {
502
- mode: "live";
503
- channel_strategy: "named";
504
- channel_id: string;
505
- bounds?: NetworkParticipationBoundsRequest;
506
- } | {
507
- mode: "live";
508
- channel_strategy: "run";
509
- channel_id?: never;
510
- bounds?: NetworkParticipationBoundsRequest;
511
- } | {
512
- mode: "live";
513
- channel_strategy: "loop_run";
514
- channel_id?: never;
515
- bounds?: NetworkParticipationBoundsRequest;
516
- };
517
509
  export interface JobTaskConfig {
518
510
  title?: string;
519
511
  description?: string;
520
512
  owner?: Ownership;
521
- network_participation?: NetworkParticipationRequest;
522
513
  }
523
514
  export interface LoopTarget {
524
515
  workspace_id: string;
525
516
  loop_name: string;
526
517
  inputs?: Record<string, JSONValue>;
527
518
  input_mapping?: Record<string, string>;
528
- network_participation?: NetworkParticipationRequest;
529
519
  }
530
520
  export type RetryStrategy = string;
531
521
  export interface RetryConfig {
@@ -552,6 +542,7 @@ export interface AutomationJobCreateParams {
552
542
  fire_limit?: FireLimitConfig;
553
543
  }
554
544
  export interface AutomationJobPostFirePayload {
545
+ profile_id?: string;
555
546
  job_id: string;
556
547
  job_name?: string;
557
548
  agent_name?: string;
@@ -566,6 +557,7 @@ export interface AutomationSchedulePayload {
566
557
  time?: string;
567
558
  }
568
559
  export interface AutomationJobPreFirePayload {
560
+ profile_id?: string;
569
561
  job_id: string;
570
562
  job_name?: string;
571
563
  agent_name?: string;
@@ -606,7 +598,9 @@ export interface AutomationJobsParams {
606
598
  }
607
599
  export type JobSource = string;
608
600
  export interface Job {
601
+ grant_ceiling: string;
609
602
  id: string;
603
+ profile_id: string;
610
604
  scope: Scope;
611
605
  name: string;
612
606
  target_kind: TargetKind;
@@ -635,6 +629,7 @@ export interface AutomationJobsResult {
635
629
  }
636
630
  export type AutomationObservationPatch = Record<string, never>;
637
631
  export interface AutomationRunCompletedPayload {
632
+ profile_id?: string;
638
633
  run_id: string;
639
634
  job_id?: string;
640
635
  trigger_id?: string;
@@ -645,6 +640,7 @@ export interface AutomationRunCompletedPayload {
645
640
  duration_ms?: number;
646
641
  }
647
642
  export interface AutomationRunFailedPayload {
643
+ profile_id?: string;
648
644
  run_id: string;
649
645
  job_id?: string;
650
646
  trigger_id?: string;
@@ -688,6 +684,7 @@ export interface AutomationTriggerFireParams {
688
684
  payload?: Record<string, JSONValue>;
689
685
  }
690
686
  export interface AutomationTriggerPostFirePayload {
687
+ profile_id?: string;
691
688
  trigger_id: string;
692
689
  trigger_name?: string;
693
690
  event?: string;
@@ -697,6 +694,7 @@ export interface AutomationTriggerPostFirePayload {
697
694
  session_id?: string;
698
695
  }
699
696
  export interface AutomationTriggerPreFirePayload {
697
+ profile_id?: string;
700
698
  trigger_id: string;
701
699
  trigger_name?: string;
702
700
  event?: string;
@@ -746,8 +744,20 @@ export interface GatewayIngressPayload {
746
744
  confirmed_at?: ISODateTime;
747
745
  enable_path?: string;
748
746
  }
747
+ export type SchedulerSkipReason = string;
748
+ export interface AutomationLastRunPayload {
749
+ id: string;
750
+ status: RunStatus;
751
+ started_at?: ISODateTime;
752
+ ended_at?: ISODateTime;
753
+ skip_reason?: SchedulerSkipReason;
754
+ }
749
755
  export interface Trigger {
750
756
  id: string;
757
+ profile_id: string;
758
+ profile_name: string;
759
+ profile_color?: string;
760
+ profile_icon?: string;
751
761
  scope: Scope;
752
762
  name: string;
753
763
  target_kind: TargetKind;
@@ -768,6 +778,7 @@ export interface Trigger {
768
778
  ingress?: GatewayIngressPayload;
769
779
  created_at: ISODateTime;
770
780
  updated_at: ISODateTime;
781
+ last_run?: AutomationLastRunPayload;
771
782
  }
772
783
  export interface AutomationTriggersResult {
773
784
  triggers: Trigger[];
@@ -780,7 +791,6 @@ export interface AutonomyMatcher {
780
791
  loop_name?: string;
781
792
  node_id?: string;
782
793
  workflow_id?: string;
783
- participation_channel?: string;
784
794
  coordinator_session_id?: string;
785
795
  parent_session_id?: string;
786
796
  root_session_id?: string;
@@ -791,97 +801,6 @@ export interface AutonomyMatcher {
791
801
  export interface AutonomyObservationPatch {
792
802
  labels?: Record<string, string>;
793
803
  }
794
- export type BridgeCheckStatus = "pass" | "warn" | "fail" | "skipped";
795
- export interface BridgeCheckRecord {
796
- check: string;
797
- status: BridgeCheckStatus;
798
- remediation: string;
799
- }
800
- export interface BridgeCheckRequest {
801
- bridge_instance_id: string;
802
- }
803
- export interface BridgeCheckResponse {
804
- checks: BridgeCheckRecord[];
805
- }
806
- export type BridgeScope = string;
807
- export type BridgeInstanceSource = string;
808
- export type BridgeStatus = string;
809
- export type BridgeDMPolicy = string;
810
- export interface RoutingPolicy {
811
- include_peer: boolean;
812
- include_thread: boolean;
813
- include_group: boolean;
814
- }
815
- export type BridgeDegradationReason = string;
816
- export interface BridgeDegradation {
817
- reason: BridgeDegradationReason;
818
- message?: string;
819
- }
820
- export interface BridgeInstance {
821
- id: string;
822
- scope: BridgeScope;
823
- workspace_id?: string;
824
- platform: string;
825
- extension_name: string;
826
- display_name: string;
827
- source?: BridgeInstanceSource;
828
- enabled: boolean;
829
- status: BridgeStatus;
830
- dm_policy?: BridgeDMPolicy;
831
- routing_policy: RoutingPolicy;
832
- provider_config?: JSONValue;
833
- delivery_defaults?: JSONValue;
834
- notification_suppress: boolean;
835
- degradation?: BridgeDegradation;
836
- created_at: ISODateTime;
837
- updated_at: ISODateTime;
838
- }
839
- export interface BridgeInstanceTargetParams {
840
- bridge_instance_id: string;
841
- }
842
- export type BridgeRuntimePurpose = "service" | "control";
843
- export type BridgeTargetType = string;
844
- export interface BridgeTargetSnapshot {
845
- canonical_route: string;
846
- display_name: string;
847
- target_type: BridgeTargetType;
848
- qualifier?: string;
849
- capabilities?: string[];
850
- last_seen_at?: ISODateTime;
851
- }
852
- export interface BridgeTargetSnapshotRequest {
853
- bridge_instance_id: string;
854
- }
855
- export interface BridgeTargetSnapshotResponse {
856
- targets: BridgeTargetSnapshot[];
857
- }
858
- export interface BridgeWebhookRegistrationRequest {
859
- bridge_instance_id: string;
860
- public_url?: string;
861
- }
862
- export interface BridgeWebhookRegistrationResponse {
863
- status: BridgeCheckStatus;
864
- remediation: string;
865
- }
866
- export interface BridgesInstancesReportStateParams {
867
- bridge_instance_id: string;
868
- status: BridgeStatus;
869
- degradation?: BridgeDegradation;
870
- clear_degradation?: boolean;
871
- }
872
- export interface RoutingKey {
873
- scope: BridgeScope;
874
- workspace_id?: string;
875
- bridge_instance_id: string;
876
- peer_id?: string;
877
- thread_id?: string;
878
- group_id?: string;
879
- }
880
- export interface BridgesMessagesIngestResult {
881
- session_id: string;
882
- route_created: boolean;
883
- routing_key: RoutingKey;
884
- }
885
804
  export interface ClarifyAnswer {
886
805
  choice?: number;
887
806
  text: string;
@@ -892,6 +811,59 @@ export interface ClarifyAskParams {
892
811
  question: string;
893
812
  choices?: string[];
894
813
  }
814
+ export interface CmdPaletteArgument {
815
+ name: string;
816
+ type: string;
817
+ placeholder?: string;
818
+ required?: boolean;
819
+ options?: string[];
820
+ }
821
+ export interface CmdPaletteAction {
822
+ kind: string;
823
+ tool?: string;
824
+ view?: string;
825
+ app?: string;
826
+ url?: string;
827
+ args?: Record<string, JSONValue>;
828
+ }
829
+ export interface CmdPaletteConfirmation {
830
+ title: string;
831
+ body?: string;
832
+ confirm: string;
833
+ }
834
+ export interface CmdPaletteExecutionPolicy {
835
+ single_flight?: boolean;
836
+ retry_safe?: boolean;
837
+ }
838
+ export interface CmdPaletteCommand {
839
+ id: string;
840
+ title: string;
841
+ section?: string;
842
+ icon: string;
843
+ profile?: string;
844
+ keywords?: string[];
845
+ arguments?: CmdPaletteArgument[];
846
+ action: CmdPaletteAction;
847
+ destructive?: boolean;
848
+ confirmation?: CmdPaletteConfirmation;
849
+ default_shortcut?: string;
850
+ execution?: CmdPaletteExecutionPolicy;
851
+ }
852
+ export interface CmdPaletteViewSource {
853
+ tool: string;
854
+ }
855
+ export interface CmdPaletteView {
856
+ id: string;
857
+ title: string;
858
+ kind: string;
859
+ profile?: string;
860
+ source?: CmdPaletteViewSource;
861
+ program?: boolean;
862
+ }
863
+ export interface CmdPaletteConfig {
864
+ commands?: CmdPaletteCommand[];
865
+ views?: CmdPaletteView[];
866
+ }
895
867
  export type CommandFlagType = "string" | "boolean" | "integer" | "number";
896
868
  export interface CommandFlag {
897
869
  name: string;
@@ -906,14 +878,14 @@ export interface CommandFlag {
906
878
  maximum?: number;
907
879
  }
908
880
  export interface CompactionMatcher {
909
- compaction_reason?: string;
910
- compaction_strategy?: string;
881
+ compaction_trigger?: string;
911
882
  }
912
883
  export interface ConnectivityAdvertisedEndpoint {
913
884
  url: string;
914
885
  scheme: string;
915
886
  scheme_policy?: string;
916
887
  stability: string;
888
+ verification_address?: string;
917
889
  }
918
890
  export interface ConnectivityEstablishRequest {
919
891
  tier: string;
@@ -946,15 +918,20 @@ export interface ContextBlock {
946
918
  text?: string;
947
919
  metadata?: Record<string, string>;
948
920
  }
949
- export interface ContextCompactPayload {
921
+ export interface ContextCompactionPatch {
922
+ labels?: Record<string, string>;
923
+ }
924
+ export interface ContextCompactionPayload {
950
925
  event: HookEvent;
951
926
  timestamp: ISODateTime;
927
+ profile_id?: string;
952
928
  session_id?: string;
953
929
  session_name?: string;
954
930
  session_type?: string;
955
931
  agent_name?: string;
956
932
  workspace_id?: string;
957
933
  workspace?: string;
934
+ worktree_id?: string;
958
935
  acp_session_id?: string;
959
936
  state?: string;
960
937
  soul_snapshot_id?: string;
@@ -962,34 +939,26 @@ export interface ContextCompactPayload {
962
939
  created_at: ISODateTime;
963
940
  updated_at: ISODateTime;
964
941
  turn_id?: string;
965
- reason?: string;
966
- strategy?: string;
942
+ compaction_id: string;
943
+ trigger: string;
944
+ status?: string;
967
945
  summary?: string;
968
- context_blocks?: ContextBlock[];
969
- }
970
- export interface ContextCompactionPatch {
971
- deny?: boolean;
972
- deny_reason?: string;
973
- reason?: string;
974
- strategy?: string;
975
- context_blocks?: ContextBlock[];
946
+ error?: string;
976
947
  }
977
948
  export interface ContextPostCompactPatch {
978
- deny?: boolean;
979
- deny_reason?: string;
980
- reason?: string;
981
- strategy?: string;
982
- context_blocks?: ContextBlock[];
949
+ labels?: Record<string, string>;
983
950
  }
984
951
  export interface ContextPostCompactPayload {
985
952
  event: HookEvent;
986
953
  timestamp: ISODateTime;
954
+ profile_id?: string;
987
955
  session_id?: string;
988
956
  session_name?: string;
989
957
  session_type?: string;
990
958
  agent_name?: string;
991
959
  workspace_id?: string;
992
960
  workspace?: string;
961
+ worktree_id?: string;
993
962
  acp_session_id?: string;
994
963
  state?: string;
995
964
  soul_snapshot_id?: string;
@@ -997,27 +966,26 @@ export interface ContextPostCompactPayload {
997
966
  created_at: ISODateTime;
998
967
  updated_at: ISODateTime;
999
968
  turn_id?: string;
1000
- reason?: string;
1001
- strategy?: string;
969
+ compaction_id: string;
970
+ trigger: string;
971
+ status?: string;
1002
972
  summary?: string;
1003
- context_blocks?: ContextBlock[];
973
+ error?: string;
1004
974
  }
1005
975
  export interface ContextPreCompactPatch {
1006
- deny?: boolean;
1007
- deny_reason?: string;
1008
- reason?: string;
1009
- strategy?: string;
1010
- context_blocks?: ContextBlock[];
976
+ labels?: Record<string, string>;
1011
977
  }
1012
978
  export interface ContextPreCompactPayload {
1013
979
  event: HookEvent;
1014
980
  timestamp: ISODateTime;
981
+ profile_id?: string;
1015
982
  session_id?: string;
1016
983
  session_name?: string;
1017
984
  session_type?: string;
1018
985
  agent_name?: string;
1019
986
  workspace_id?: string;
1020
987
  workspace?: string;
988
+ worktree_id?: string;
1021
989
  acp_session_id?: string;
1022
990
  state?: string;
1023
991
  soul_snapshot_id?: string;
@@ -1025,34 +993,18 @@ export interface ContextPreCompactPayload {
1025
993
  created_at: ISODateTime;
1026
994
  updated_at: ISODateTime;
1027
995
  turn_id?: string;
1028
- reason?: string;
1029
- strategy?: string;
996
+ compaction_id: string;
997
+ trigger: string;
998
+ status?: string;
1030
999
  summary?: string;
1031
- context_blocks?: ContextBlock[];
1000
+ error?: string;
1032
1001
  }
1033
- export type ControlMethod = "bridges/check" | "bridges/webhook/register";
1034
1002
  export interface ControlPatch {
1035
1003
  deny?: boolean;
1036
1004
  deny_reason?: string;
1037
1005
  }
1038
- export type NetworkParticipationSpec = {
1039
- version: "network-participation/v1";
1040
- mode: "local";
1041
- workspace_id?: never;
1042
- channel_strategy?: never;
1043
- channel_id?: never;
1044
- source: NetworkParticipationSource;
1045
- bounds?: never;
1046
- } | {
1047
- version: "network-participation/v1";
1048
- mode: "live";
1049
- workspace_id: string;
1050
- channel_strategy: "named" | "run" | "loop_run";
1051
- channel_id: string;
1052
- source: NetworkParticipationSource;
1053
- bounds: NetworkParticipationBounds;
1054
- };
1055
1006
  export interface CoordinatorContext {
1007
+ profile_id?: string;
1056
1008
  workspace_id?: string;
1057
1009
  workspace?: string;
1058
1010
  agent_name?: string;
@@ -1060,13 +1012,13 @@ export interface CoordinatorContext {
1060
1012
  task_id?: string;
1061
1013
  run_id?: string;
1062
1014
  workflow_id?: string;
1063
- resolved_network_participation?: NetworkParticipationSpec;
1064
1015
  provider?: string;
1065
1016
  model?: string;
1066
1017
  }
1067
1018
  export interface CoordinatorDecisionPayload {
1068
1019
  event: HookEvent;
1069
1020
  timestamp: ISODateTime;
1021
+ profile_id?: string;
1070
1022
  workspace_id?: string;
1071
1023
  workspace?: string;
1072
1024
  agent_name?: string;
@@ -1074,7 +1026,6 @@ export interface CoordinatorDecisionPayload {
1074
1026
  task_id?: string;
1075
1027
  run_id?: string;
1076
1028
  workflow_id?: string;
1077
- resolved_network_participation?: NetworkParticipationSpec;
1078
1029
  provider?: string;
1079
1030
  model?: string;
1080
1031
  decision_kind?: string;
@@ -1085,6 +1036,7 @@ export interface CoordinatorDecisionPayload {
1085
1036
  export interface CoordinatorFailedPayload {
1086
1037
  event: HookEvent;
1087
1038
  timestamp: ISODateTime;
1039
+ profile_id?: string;
1088
1040
  workspace_id?: string;
1089
1041
  workspace?: string;
1090
1042
  agent_name?: string;
@@ -1092,7 +1044,6 @@ export interface CoordinatorFailedPayload {
1092
1044
  task_id?: string;
1093
1045
  run_id?: string;
1094
1046
  workflow_id?: string;
1095
- resolved_network_participation?: NetworkParticipationSpec;
1096
1047
  provider?: string;
1097
1048
  model?: string;
1098
1049
  decision_kind?: string;
@@ -1103,6 +1054,7 @@ export interface CoordinatorFailedPayload {
1103
1054
  export interface CoordinatorLifecyclePayload {
1104
1055
  event: HookEvent;
1105
1056
  timestamp: ISODateTime;
1057
+ profile_id?: string;
1106
1058
  workspace_id?: string;
1107
1059
  workspace?: string;
1108
1060
  agent_name?: string;
@@ -1110,7 +1062,6 @@ export interface CoordinatorLifecyclePayload {
1110
1062
  task_id?: string;
1111
1063
  run_id?: string;
1112
1064
  workflow_id?: string;
1113
- resolved_network_participation?: NetworkParticipationSpec;
1114
1065
  provider?: string;
1115
1066
  model?: string;
1116
1067
  decision_kind?: string;
@@ -1124,6 +1075,7 @@ export interface CoordinatorObservationPatch {
1124
1075
  export interface CoordinatorPreSpawnPayload {
1125
1076
  event: HookEvent;
1126
1077
  timestamp: ISODateTime;
1078
+ profile_id?: string;
1127
1079
  workspace_id?: string;
1128
1080
  workspace?: string;
1129
1081
  agent_name?: string;
@@ -1131,7 +1083,6 @@ export interface CoordinatorPreSpawnPayload {
1131
1083
  task_id?: string;
1132
1084
  run_id?: string;
1133
1085
  workflow_id?: string;
1134
- resolved_network_participation?: NetworkParticipationSpec;
1135
1086
  provider?: string;
1136
1087
  model?: string;
1137
1088
  reason?: string;
@@ -1148,6 +1099,7 @@ export interface CoordinatorSpawnPatch {
1148
1099
  export interface CoordinatorSpawnedPayload {
1149
1100
  event: HookEvent;
1150
1101
  timestamp: ISODateTime;
1102
+ profile_id?: string;
1151
1103
  workspace_id?: string;
1152
1104
  workspace?: string;
1153
1105
  agent_name?: string;
@@ -1155,7 +1107,6 @@ export interface CoordinatorSpawnedPayload {
1155
1107
  task_id?: string;
1156
1108
  run_id?: string;
1157
1109
  workflow_id?: string;
1158
- resolved_network_participation?: NetworkParticipationSpec;
1159
1110
  provider?: string;
1160
1111
  model?: string;
1161
1112
  decision_kind?: string;
@@ -1166,6 +1117,7 @@ export interface CoordinatorSpawnedPayload {
1166
1117
  export interface CoordinatorStoppedPayload {
1167
1118
  event: HookEvent;
1168
1119
  timestamp: ISODateTime;
1120
+ profile_id?: string;
1169
1121
  workspace_id?: string;
1170
1122
  workspace?: string;
1171
1123
  agent_name?: string;
@@ -1173,7 +1125,6 @@ export interface CoordinatorStoppedPayload {
1173
1125
  task_id?: string;
1174
1126
  run_id?: string;
1175
1127
  workflow_id?: string;
1176
- resolved_network_participation?: NetworkParticipationSpec;
1177
1128
  provider?: string;
1178
1129
  model?: string;
1179
1130
  decision_kind?: string;
@@ -1181,102 +1132,36 @@ export interface CoordinatorStoppedPayload {
1181
1132
  stop_reason?: string;
1182
1133
  error?: string;
1183
1134
  }
1184
- export type DeliveryAckOutcome = "success" | "committed_result_unavailable";
1185
- export interface DeliveryErrorDetail {
1186
- message: string;
1187
- }
1188
- export interface DeliveryAck {
1189
- delivery_id: string;
1190
- seq: number;
1191
- remote_message_id?: string;
1192
- replace_remote_message_id?: string;
1193
- outcome?: DeliveryAckOutcome;
1194
- error?: DeliveryErrorDetail;
1195
- }
1196
- export type DeliveryMode = string;
1197
- export interface DeliveryTarget {
1198
- bridge_instance_id: string;
1199
- peer_id?: string;
1200
- thread_id?: string;
1201
- group_id?: string;
1202
- mode?: DeliveryMode;
1203
- }
1204
- export type DeliveryEventType = "start" | "delta" | "final" | "error" | "resume" | "delete" | "progress";
1205
- export interface MessageContent {
1206
- text?: string;
1135
+ export interface DescribeGatewayRequirement {
1136
+ permissions: string[];
1207
1137
  }
1208
- export type DeliveryOperation = string;
1209
- export interface DeliveryMessageReference {
1210
- delivery_id?: string;
1211
- remote_message_id?: string;
1138
+ export interface DescribeProfileDefaults {
1139
+ agent?: string;
1140
+ provider?: string;
1212
1141
  }
1213
- export interface DeliveryResumeState {
1214
- latest_event_type: DeliveryEventType;
1142
+ export interface DescribeProfileCredential {
1143
+ provider: string;
1144
+ slot: string;
1215
1145
  }
1216
- export type ToolProgressPhase = "started" | "completed" | "failed";
1217
- export interface ToolProgress {
1218
- tool_call_id: string;
1219
- tool_id: string;
1220
- phase: ToolProgressPhase;
1221
- label: string;
1222
- preview?: string;
1146
+ export interface DescribeProfile {
1147
+ name: string;
1148
+ color?: string;
1149
+ icon?: string;
1223
1150
  emoji?: string;
1224
- duration_ms?: number;
1225
- error?: string;
1226
- index: number;
1151
+ defaults?: DescribeProfileDefaults;
1152
+ credentials?: DescribeProfileCredential[];
1227
1153
  }
1228
- export interface DeliveryEvent {
1229
- delivery_id: string;
1230
- bridge_instance_id: string;
1231
- routing_key: RoutingKey;
1232
- delivery_target: DeliveryTarget;
1233
- seq: number;
1234
- event_type: DeliveryEventType;
1235
- content: MessageContent;
1236
- final: boolean;
1237
- operation?: DeliveryOperation;
1238
- reference?: DeliveryMessageReference;
1239
- error?: DeliveryErrorDetail;
1240
- resume?: DeliveryResumeState;
1241
- progress?: ToolProgress;
1242
- provider_metadata?: JSONValue;
1243
- }
1244
- export interface DeliverySnapshot {
1245
- delivery_id: string;
1246
- session_id: string;
1247
- turn_id: string;
1248
- bridge_instance_id: string;
1249
- routing_key: RoutingKey;
1250
- delivery_target: DeliveryTarget;
1251
- latest_seq: number;
1252
- latest_event_type: DeliveryEventType;
1253
- current_content: MessageContent;
1254
- operation?: DeliveryOperation;
1255
- reference?: DeliveryMessageReference;
1256
- provider_metadata?: JSONValue;
1257
- last_sent_seq?: number;
1258
- last_acked_seq?: number;
1259
- remote_message_id?: string;
1260
- replace_remote_message_id?: string;
1261
- final: boolean;
1262
- error?: string;
1263
- updated_at: ISODateTime;
1264
- }
1265
- export interface DeliveryRequest {
1266
- event: DeliveryEvent;
1267
- snapshot?: DeliverySnapshot;
1268
- }
1269
- export interface DescribeNetworkParticipation {
1270
- required: boolean;
1271
- mode: string;
1272
- channel_scopes?: string[];
1154
+ export interface DescribeResourcePath {
1155
+ path: string;
1156
+ profile?: string;
1273
1157
  }
1274
1158
  export interface DescribeResources {
1275
- skills?: string[];
1276
- loops?: string[];
1277
- agents?: string[];
1278
- automation?: string[];
1279
- layouts?: string[];
1159
+ skills?: DescribeResourcePath[];
1160
+ loops?: DescribeResourcePath[];
1161
+ agents?: DescribeResourcePath[];
1162
+ automation?: DescribeResourcePath[];
1163
+ layouts?: DescribeResourcePath[];
1164
+ cmd_palette?: CmdPaletteConfig;
1280
1165
  }
1281
1166
  export interface DescribeSubprocess {
1282
1167
  command: string;
@@ -1292,6 +1177,7 @@ export interface ExtensionCommandSpec {
1292
1177
  flags?: Record<string, string>;
1293
1178
  }
1294
1179
  export interface ExtensionToolRuntimeDescriptor {
1180
+ profile?: string;
1295
1181
  id: ToolID;
1296
1182
  handler: string;
1297
1183
  description?: string;
@@ -1307,9 +1193,14 @@ export interface ExtensionToolRuntimeDescriptor {
1307
1193
  capabilities?: string[];
1308
1194
  command?: ExtensionCommandSpec;
1309
1195
  }
1196
+ export interface DescribeHookEvent {
1197
+ event: HookEvent;
1198
+ profile?: string;
1199
+ }
1310
1200
  export interface ExtensionCommandGroupSpec {
1311
1201
  path: string;
1312
1202
  summary: string;
1203
+ profile?: string;
1313
1204
  }
1314
1205
  export interface DescribeSDKInfo {
1315
1206
  name: string;
@@ -1324,15 +1215,21 @@ export interface DescribePayload {
1324
1215
  provides: string[];
1325
1216
  permissions: string[];
1326
1217
  requires_env?: string[];
1218
+ profiles?: DescribeProfile[];
1327
1219
  resources: DescribeResources;
1328
1220
  subprocess: DescribeSubprocess;
1329
- network_participation?: DescribeNetworkParticipation;
1221
+ gateway?: DescribeGatewayRequirement;
1330
1222
  tools?: ExtensionToolRuntimeDescriptor[];
1331
- hook_events?: string[];
1223
+ hook_events?: DescribeHookEvent[];
1332
1224
  watch_source_kinds?: string[];
1225
+ cmd_palette_views?: string[];
1333
1226
  command_groups?: ExtensionCommandGroupSpec[];
1334
1227
  sdk: DescribeSDKInfo;
1335
1228
  }
1229
+ export interface EffectResult {
1230
+ effect_id: string;
1231
+ payload?: JSONValue;
1232
+ }
1336
1233
  export type EmptyResult = Record<string, never>;
1337
1234
  export interface EventPostRecordPatch {
1338
1235
  labels?: Record<string, string>;
@@ -1340,12 +1237,14 @@ export interface EventPostRecordPatch {
1340
1237
  export interface EventPostRecordPayload {
1341
1238
  event: HookEvent;
1342
1239
  timestamp: ISODateTime;
1240
+ profile_id?: string;
1343
1241
  session_id?: string;
1344
1242
  session_name?: string;
1345
1243
  session_type?: string;
1346
1244
  agent_name?: string;
1347
1245
  workspace_id?: string;
1348
1246
  workspace?: string;
1247
+ worktree_id?: string;
1349
1248
  acp_session_id?: string;
1350
1249
  state?: string;
1351
1250
  soul_snapshot_id?: string;
@@ -1363,12 +1262,14 @@ export interface EventPreRecordPatch {
1363
1262
  export interface EventPreRecordPayload {
1364
1263
  event: HookEvent;
1365
1264
  timestamp: ISODateTime;
1265
+ profile_id?: string;
1366
1266
  session_id?: string;
1367
1267
  session_name?: string;
1368
1268
  session_type?: string;
1369
1269
  agent_name?: string;
1370
1270
  workspace_id?: string;
1371
1271
  workspace?: string;
1272
+ worktree_id?: string;
1372
1273
  acp_session_id?: string;
1373
1274
  state?: string;
1374
1275
  soul_snapshot_id?: string;
@@ -1386,12 +1287,14 @@ export interface EventRecordPatch {
1386
1287
  export interface EventRecordPayload {
1387
1288
  event: HookEvent;
1388
1289
  timestamp: ISODateTime;
1290
+ profile_id?: string;
1389
1291
  session_id?: string;
1390
1292
  session_name?: string;
1391
1293
  session_type?: string;
1392
1294
  agent_name?: string;
1393
1295
  workspace_id?: string;
1394
1296
  workspace?: string;
1297
+ worktree_id?: string;
1395
1298
  acp_session_id?: string;
1396
1299
  state?: string;
1397
1300
  soul_snapshot_id?: string;
@@ -1439,6 +1342,7 @@ export interface Redaction {
1439
1342
  reason: ReasonCode;
1440
1343
  bytes?: number;
1441
1344
  }
1345
+ export type ResultTrust = string;
1442
1346
  export interface ToolResult {
1443
1347
  content?: ToolContent[];
1444
1348
  structured?: JSONValue;
@@ -1449,13 +1353,20 @@ export interface ToolResult {
1449
1353
  truncated: boolean;
1450
1354
  bytes: number;
1451
1355
  duration_ms: number;
1356
+ trust?: ResultTrust;
1452
1357
  }
1453
1358
  export interface ExtensionToolCallResponse {
1454
1359
  result: ToolResult;
1455
1360
  }
1456
- export type IssueSeverity = "error" | "warning";
1361
+ export interface ExtensionValidationComponent {
1362
+ kind: string;
1363
+ name: string;
1364
+ transport?: string;
1365
+ }
1366
+ export type IssueSeverity = "error" | "warning" | "warn";
1457
1367
  export interface ValidationIssue {
1458
1368
  path: string;
1369
+ scope?: string;
1459
1370
  line?: number;
1460
1371
  column?: number;
1461
1372
  field?: string;
@@ -1463,9 +1374,80 @@ export interface ValidationIssue {
1463
1374
  severity: IssueSeverity;
1464
1375
  }
1465
1376
  export interface ExtensionValidatePayload {
1377
+ status: string;
1378
+ format: string;
1379
+ name?: string;
1380
+ version?: string;
1381
+ would_ingest?: ExtensionValidationComponent[];
1466
1382
  manifest?: ExtensionManifestSummary;
1467
1383
  issues: ValidationIssue[];
1468
- consent_areas: ConsentArea[];
1384
+ consent_areas?: ConsentArea[];
1385
+ }
1386
+ export interface ForgeCapabilitiesRequest {
1387
+ remote_urls: string[];
1388
+ }
1389
+ export interface ForgeCapabilitiesResponse {
1390
+ served: boolean;
1391
+ available: boolean;
1392
+ winner?: string;
1393
+ provider?: string;
1394
+ served_remote?: string;
1395
+ request_noun?: string;
1396
+ open_action_label?: string;
1397
+ view_action_label?: string;
1398
+ supports_draft?: boolean;
1399
+ compare_url_template?: string;
1400
+ template_paths?: string[];
1401
+ credential_source?: string;
1402
+ default_branch?: string;
1403
+ cause?: string;
1404
+ }
1405
+ export interface ForgePRCreateRequest {
1406
+ remote_urls: string[];
1407
+ head: string;
1408
+ head_sha?: string;
1409
+ base: string;
1410
+ title: string;
1411
+ body?: string;
1412
+ draft?: boolean;
1413
+ }
1414
+ export interface ForgePRCreateResponse {
1415
+ status: string;
1416
+ number?: number;
1417
+ url?: string;
1418
+ cause?: string;
1419
+ }
1420
+ export interface ForgeStatusRequest {
1421
+ remote_urls: string[];
1422
+ branch: string;
1423
+ base?: string;
1424
+ head_sha?: string;
1425
+ }
1426
+ export interface ForgeChecks {
1427
+ state: string;
1428
+ passed: number;
1429
+ failed: number;
1430
+ pending: number;
1431
+ failed_names: string[];
1432
+ }
1433
+ export interface ForgeStatusResponse {
1434
+ checks?: ForgeChecks;
1435
+ review_decision?: string;
1436
+ mergeable?: string;
1437
+ updated_at?: ISODateTime;
1438
+ selection?: string;
1439
+ retry_after?: ISODateTime;
1440
+ provider: string;
1441
+ pr_number?: number;
1442
+ pr_state?: string;
1443
+ pr_url?: string;
1444
+ head?: string;
1445
+ base?: string;
1446
+ head_sha?: string;
1447
+ draft?: boolean;
1448
+ merged?: boolean;
1449
+ fetched_at: ISODateTime;
1450
+ cause?: string;
1469
1451
  }
1470
1452
  export interface HeartbeatDeleteRequest {
1471
1453
  workspace_id?: string;
@@ -1632,10 +1614,15 @@ export interface HeartbeatWakeEventPayload {
1632
1614
  created_at: ISODateTime;
1633
1615
  expires_at: ISODateTime;
1634
1616
  }
1617
+ export type State = "starting" | "active" | "stopping" | "stopped";
1635
1618
  export type SessionHealthState = "idle" | "prompting" | "stopped" | "detached";
1636
1619
  export type SessionHealthStatus = "healthy" | "degraded" | "stale" | "dead" | "unknown";
1637
1620
  export type SessionHealthIneligibilityReason = "session_prompt_active" | "session_not_attachable" | "session_unhealthy" | "session_health_stale" | "session_health_hung" | "session_health_dead" | "session_health_unknown";
1638
1621
  export interface SessionHealthPayload {
1622
+ lifecycle_state?: State;
1623
+ verified?: boolean;
1624
+ escalated?: boolean;
1625
+ attention?: string;
1639
1626
  session_id: string;
1640
1627
  workspace_id: string;
1641
1628
  agent_name: string;
@@ -1700,12 +1687,9 @@ export interface HookMatcher {
1700
1687
  agent_name?: string;
1701
1688
  agent_type?: string;
1702
1689
  workspace_id?: string;
1690
+ worktree_id?: string;
1703
1691
  workspace_root?: string;
1704
1692
  session_type?: string;
1705
- sandbox_id?: string;
1706
- sandbox_backend?: string;
1707
- sandbox_profile?: string;
1708
- sync_direction?: string;
1709
1693
  input_class?: string;
1710
1694
  acp_event_type?: string;
1711
1695
  turn_id?: string;
@@ -1715,21 +1699,14 @@ export interface HookMatcher {
1715
1699
  decision_class?: string;
1716
1700
  message_role?: string;
1717
1701
  message_delta_type?: string;
1718
- channel?: string;
1719
- surface?: string;
1720
- kind?: string;
1721
- direction?: string;
1722
- work_state?: string;
1723
- participation_mode?: string;
1724
- participation_source?: string;
1725
- compaction_reason?: string;
1726
- compaction_strategy?: string;
1702
+ compaction_trigger?: string;
1727
1703
  autonomy?: AutonomyMatcher;
1728
1704
  }
1729
1705
  export type HookExecutorKind = "native" | "subprocess" | "wasm";
1730
1706
  export type HookSource = "native" | "config" | "extension" | "agent_definition" | "skill";
1731
1707
  export interface HookDecl {
1732
1708
  name: string;
1709
+ profile_id?: string;
1733
1710
  event: HookEvent;
1734
1711
  mode?: HookMode;
1735
1712
  matcher: HookMatcher;
@@ -1745,97 +1722,9 @@ export interface HookDecl {
1745
1722
  source: HookSource;
1746
1723
  required?: boolean;
1747
1724
  }
1748
- export type HookEventFamily = "session" | "sandbox" | "input" | "prompt" | "event" | "automation" | "agent" | "turn" | "message" | "tool" | "permission" | "context" | "coordinator" | "task" | "task.run" | "loop" | "spawn" | "network" | "window_manager";
1725
+ export type HookEventFamily = "subagent" | "session" | "input" | "prompt" | "event" | "automation" | "agent" | "turn" | "message" | "tool" | "permission" | "context" | "coordinator" | "task" | "task.run" | "loop" | "spawn" | "window_manager" | "worktree" | "terminal";
1749
1726
  export type HookRunOutcome = "applied" | "denied" | "failed" | "skipped" | "dropped" | "rejected";
1750
- export type HookSkillSource = "bundled" | "marketplace" | "user" | "additional" | "workspace";
1751
- export interface InboundAction {
1752
- action_id: string;
1753
- message_id?: string;
1754
- value?: string;
1755
- trigger_id?: string;
1756
- }
1757
- export interface InboundCommand {
1758
- command: string;
1759
- text?: string;
1760
- trigger_id?: string;
1761
- }
1762
- export type InboundEditOperation = "updated" | "deleted";
1763
- export interface InboundEdit {
1764
- message_id: string;
1765
- new_text: string;
1766
- original_timestamp: ISODateTime;
1767
- operation: InboundEditOperation;
1768
- }
1769
- export type InboundEventFamily = "message" | "command" | "action" | "reaction" | "edit";
1770
- export interface MessageSender {
1771
- id?: string;
1772
- username?: string;
1773
- display_name?: string;
1774
- }
1775
- export interface MessageAttachment {
1776
- id?: string;
1777
- name?: string;
1778
- mime_type?: string;
1779
- url?: string;
1780
- }
1781
- export interface InboundReaction {
1782
- message_id: string;
1783
- emoji: string;
1784
- raw_emoji?: string;
1785
- added: boolean;
1786
- }
1787
- export type NetworkConversationSurface = string;
1788
- export interface NetworkConversationRef {
1789
- channel: string;
1790
- surface: NetworkConversationSurface;
1791
- thread_id?: string;
1792
- direct_id?: string;
1793
- work_id?: string;
1794
- reply_to?: string;
1795
- trace_id?: string;
1796
- causation_id?: string;
1797
- }
1798
- export interface InboundMessageEnvelope {
1799
- bridge_instance_id: string;
1800
- scope: BridgeScope;
1801
- workspace_id?: string;
1802
- peer_id?: string;
1803
- thread_id?: string;
1804
- group_id?: string;
1805
- platform_message_id?: string;
1806
- received_at: ISODateTime;
1807
- sender: MessageSender;
1808
- content?: MessageContent;
1809
- attachments?: MessageAttachment[];
1810
- event_family: InboundEventFamily;
1811
- command?: InboundCommand;
1812
- action?: InboundAction;
1813
- reaction?: InboundReaction;
1814
- edit?: InboundEdit;
1815
- reply_to_text?: string;
1816
- reply_to_author_id?: string;
1817
- reply_to_author_name?: string;
1818
- conversation?: NetworkConversationRef;
1819
- provider_metadata?: JSONValue;
1820
- idempotency_key: string;
1821
- }
1822
- export interface InitializeBridgeBoundSecret {
1823
- binding_name: string;
1824
- kind: string;
1825
- value: string;
1826
- }
1827
- export interface InitializeBridgeManagedInstance {
1828
- instance: BridgeInstance;
1829
- bound_secrets?: InitializeBridgeBoundSecret[];
1830
- }
1831
- export interface InitializeBridgeRuntime {
1832
- runtime_version: string;
1833
- purpose: BridgeRuntimePurpose;
1834
- provider: string;
1835
- platform: string;
1836
- allowed_methods?: string[];
1837
- managed_instances?: InitializeBridgeManagedInstance[];
1838
- }
1727
+ export type HookSkillSource = "bundled" | "marketplace" | "user" | "profile" | "additional" | "workspace" | "workspace_profile";
1839
1728
  export interface InitializeCapabilities {
1840
1729
  provides: string[];
1841
1730
  granted_permissions: HostAPIMethod[];
@@ -1862,7 +1751,7 @@ export interface InitializeRuntime {
1862
1751
  health_check_timeout_ms: number;
1863
1752
  shutdown_timeout_ms: number;
1864
1753
  default_hook_timeout_ms: number;
1865
- bridge?: InitializeBridgeRuntime;
1754
+ default_view_timeout_ms?: number;
1866
1755
  }
1867
1756
  export interface InitializeRequest {
1868
1757
  protocol_version: string;
@@ -1884,6 +1773,7 @@ export interface InitializeResponse {
1884
1773
  implemented_methods: string[];
1885
1774
  supported_hook_events: string[];
1886
1775
  watch_source_kinds?: string[];
1776
+ cmd_palette_views?: string[];
1887
1777
  supports: InitializeSupports;
1888
1778
  }
1889
1779
  export interface InputPreSubmitPatch {
@@ -1892,15 +1782,33 @@ export interface InputPreSubmitPatch {
1892
1782
  message?: string;
1893
1783
  context_blocks?: ContextBlock[];
1894
1784
  }
1785
+ export interface InputAttachmentMetadata {
1786
+ id: string;
1787
+ name: string;
1788
+ mime: string;
1789
+ bytes: number;
1790
+ kind: string;
1791
+ }
1792
+ export type InputMentionKind = "file" | "folder" | "session";
1793
+ export interface InputMentionMetadata {
1794
+ kind: InputMentionKind;
1795
+ token: string;
1796
+ target: string;
1797
+ label: string;
1798
+ start: number;
1799
+ end: number;
1800
+ }
1895
1801
  export interface InputPreSubmitPayload {
1896
1802
  event: HookEvent;
1897
1803
  timestamp: ISODateTime;
1804
+ profile_id?: string;
1898
1805
  session_id?: string;
1899
1806
  session_name?: string;
1900
1807
  session_type?: string;
1901
1808
  agent_name?: string;
1902
1809
  workspace_id?: string;
1903
1810
  workspace?: string;
1811
+ worktree_id?: string;
1904
1812
  acp_session_id?: string;
1905
1813
  state?: string;
1906
1814
  soul_snapshot_id?: string;
@@ -1911,6 +1819,8 @@ export interface InputPreSubmitPayload {
1911
1819
  input_class?: string;
1912
1820
  message?: string;
1913
1821
  context_blocks?: ContextBlock[];
1822
+ attachments?: InputAttachmentMetadata[];
1823
+ mentions?: InputMentionMetadata[];
1914
1824
  }
1915
1825
  export interface ListLogsParams {
1916
1826
  workspace_id: string;
@@ -1929,6 +1839,7 @@ export interface ListLogsParams {
1929
1839
  limit?: number;
1930
1840
  }
1931
1841
  export interface LoopContext {
1842
+ profile_id?: string;
1932
1843
  loop_run_id?: string;
1933
1844
  parent_loop_run_id?: string;
1934
1845
  workspace_id?: string;
@@ -1939,7 +1850,6 @@ export interface LoopContext {
1939
1850
  run_kind?: string;
1940
1851
  node_id?: string;
1941
1852
  workflow_id?: string;
1942
- resolved_network_participation?: NetworkParticipationSpec;
1943
1853
  agent_name?: string;
1944
1854
  session_id?: string;
1945
1855
  actor_kind?: string;
@@ -1954,6 +1864,7 @@ export interface LoopControlPatch {
1954
1864
  export interface LoopGatePostPayload {
1955
1865
  event: HookEvent;
1956
1866
  timestamp: ISODateTime;
1867
+ profile_id?: string;
1957
1868
  loop_run_id?: string;
1958
1869
  parent_loop_run_id?: string;
1959
1870
  workspace_id?: string;
@@ -1964,7 +1875,6 @@ export interface LoopGatePostPayload {
1964
1875
  run_kind?: string;
1965
1876
  node_id?: string;
1966
1877
  workflow_id?: string;
1967
- resolved_network_participation?: NetworkParticipationSpec;
1968
1878
  agent_name?: string;
1969
1879
  session_id?: string;
1970
1880
  actor_kind?: string;
@@ -1988,6 +1898,7 @@ export interface LoopGatePrePatch {
1988
1898
  export interface LoopGatePrePayload {
1989
1899
  event: HookEvent;
1990
1900
  timestamp: ISODateTime;
1901
+ profile_id?: string;
1991
1902
  loop_run_id?: string;
1992
1903
  parent_loop_run_id?: string;
1993
1904
  workspace_id?: string;
@@ -1998,7 +1909,6 @@ export interface LoopGatePrePayload {
1998
1909
  run_kind?: string;
1999
1910
  node_id?: string;
2000
1911
  workflow_id?: string;
2001
- resolved_network_participation?: NetworkParticipationSpec;
2002
1912
  agent_name?: string;
2003
1913
  session_id?: string;
2004
1914
  actor_kind?: string;
@@ -2019,6 +1929,7 @@ export type LoopGenerationOrigin = "initial" | "stop_when" | "reattempt" | "gate
2019
1929
  export interface LoopGenerationPostPayload {
2020
1930
  event: HookEvent;
2021
1931
  timestamp: ISODateTime;
1932
+ profile_id?: string;
2022
1933
  loop_run_id?: string;
2023
1934
  parent_loop_run_id?: string;
2024
1935
  workspace_id?: string;
@@ -2029,7 +1940,6 @@ export interface LoopGenerationPostPayload {
2029
1940
  run_kind?: string;
2030
1941
  node_id?: string;
2031
1942
  workflow_id?: string;
2032
- resolved_network_participation?: NetworkParticipationSpec;
2033
1943
  agent_name?: string;
2034
1944
  session_id?: string;
2035
1945
  actor_kind?: string;
@@ -2051,6 +1961,7 @@ export interface LoopGenerationPrePatch {
2051
1961
  export interface LoopGenerationPrePayload {
2052
1962
  event: HookEvent;
2053
1963
  timestamp: ISODateTime;
1964
+ profile_id?: string;
2054
1965
  loop_run_id?: string;
2055
1966
  parent_loop_run_id?: string;
2056
1967
  workspace_id?: string;
@@ -2061,7 +1972,6 @@ export interface LoopGenerationPrePayload {
2061
1972
  run_kind?: string;
2062
1973
  node_id?: string;
2063
1974
  workflow_id?: string;
2064
- resolved_network_participation?: NetworkParticipationSpec;
2065
1975
  agent_name?: string;
2066
1976
  session_id?: string;
2067
1977
  actor_kind?: string;
@@ -2079,6 +1989,7 @@ export interface LoopGenerationPrePayload {
2079
1989
  export interface LoopLifecyclePayload {
2080
1990
  event: HookEvent;
2081
1991
  timestamp: ISODateTime;
1992
+ profile_id?: string;
2082
1993
  loop_run_id?: string;
2083
1994
  parent_loop_run_id?: string;
2084
1995
  workspace_id?: string;
@@ -2089,7 +2000,6 @@ export interface LoopLifecyclePayload {
2089
2000
  run_kind?: string;
2090
2001
  node_id?: string;
2091
2002
  workflow_id?: string;
2092
- resolved_network_participation?: NetworkParticipationSpec;
2093
2003
  agent_name?: string;
2094
2004
  session_id?: string;
2095
2005
  actor_kind?: string;
@@ -2104,6 +2014,7 @@ export interface LoopLifecyclePayload {
2104
2014
  export interface LoopNodeTerminalPayload {
2105
2015
  event: HookEvent;
2106
2016
  timestamp: ISODateTime;
2017
+ profile_id?: string;
2107
2018
  loop_run_id?: string;
2108
2019
  parent_loop_run_id?: string;
2109
2020
  workspace_id?: string;
@@ -2114,7 +2025,6 @@ export interface LoopNodeTerminalPayload {
2114
2025
  run_kind?: string;
2115
2026
  node_id?: string;
2116
2027
  workflow_id?: string;
2117
- resolved_network_participation?: NetworkParticipationSpec;
2118
2028
  agent_name?: string;
2119
2029
  session_id?: string;
2120
2030
  actor_kind?: string;
@@ -2136,6 +2046,7 @@ export interface LoopObservationPatch {
2136
2046
  export interface LoopStartedPayload {
2137
2047
  event: HookEvent;
2138
2048
  timestamp: ISODateTime;
2049
+ profile_id?: string;
2139
2050
  loop_run_id?: string;
2140
2051
  parent_loop_run_id?: string;
2141
2052
  workspace_id?: string;
@@ -2146,7 +2057,6 @@ export interface LoopStartedPayload {
2146
2057
  run_kind?: string;
2147
2058
  node_id?: string;
2148
2059
  workflow_id?: string;
2149
- resolved_network_participation?: NetworkParticipationSpec;
2150
2060
  agent_name?: string;
2151
2061
  session_id?: string;
2152
2062
  actor_kind?: string;
@@ -2161,6 +2071,7 @@ export interface LoopStartedPayload {
2161
2071
  export interface LoopTerminalPayload {
2162
2072
  event: HookEvent;
2163
2073
  timestamp: ISODateTime;
2074
+ profile_id?: string;
2164
2075
  loop_run_id?: string;
2165
2076
  parent_loop_run_id?: string;
2166
2077
  workspace_id?: string;
@@ -2171,7 +2082,6 @@ export interface LoopTerminalPayload {
2171
2082
  run_kind?: string;
2172
2083
  node_id?: string;
2173
2084
  workflow_id?: string;
2174
- resolved_network_participation?: NetworkParticipationSpec;
2175
2085
  agent_name?: string;
2176
2086
  session_id?: string;
2177
2087
  actor_kind?: string;
@@ -2183,30 +2093,6 @@ export interface LoopTerminalPayload {
2183
2093
  reason_code?: string;
2184
2094
  details?: JSONValue;
2185
2095
  }
2186
- export type MemoryScope = "global" | "workspace" | "agent";
2187
- export interface MemoryForgetParams {
2188
- key: string;
2189
- scope?: MemoryScope;
2190
- workspace?: string;
2191
- }
2192
- export interface MemoryRecallEntry {
2193
- key: string;
2194
- content: string;
2195
- score: number;
2196
- }
2197
- export interface MemoryRecallParams {
2198
- query: string;
2199
- limit?: number;
2200
- scope?: MemoryScope;
2201
- workspace?: string;
2202
- }
2203
- export interface MemoryStoreParams {
2204
- key: string;
2205
- content: string;
2206
- scope?: MemoryScope;
2207
- workspace?: string;
2208
- tags?: string[];
2209
- }
2210
2096
  export interface MessageDeltaPatch {
2211
2097
  deny?: boolean;
2212
2098
  deny_reason?: string;
@@ -2217,12 +2103,14 @@ export interface MessageDeltaPatch {
2217
2103
  export interface MessageDeltaPayload {
2218
2104
  event: HookEvent;
2219
2105
  timestamp: ISODateTime;
2106
+ profile_id?: string;
2220
2107
  session_id?: string;
2221
2108
  session_name?: string;
2222
2109
  session_type?: string;
2223
2110
  agent_name?: string;
2224
2111
  workspace_id?: string;
2225
2112
  workspace?: string;
2113
+ worktree_id?: string;
2226
2114
  acp_session_id?: string;
2227
2115
  state?: string;
2228
2116
  soul_snapshot_id?: string;
@@ -2246,12 +2134,14 @@ export interface MessageEndPatch {
2246
2134
  export interface MessageEndPayload {
2247
2135
  event: HookEvent;
2248
2136
  timestamp: ISODateTime;
2137
+ profile_id?: string;
2249
2138
  session_id?: string;
2250
2139
  session_name?: string;
2251
2140
  session_type?: string;
2252
2141
  agent_name?: string;
2253
2142
  workspace_id?: string;
2254
2143
  workspace?: string;
2144
+ worktree_id?: string;
2255
2145
  acp_session_id?: string;
2256
2146
  state?: string;
2257
2147
  soul_snapshot_id?: string;
@@ -2275,12 +2165,14 @@ export interface MessagePatch {
2275
2165
  export interface MessagePayload {
2276
2166
  event: HookEvent;
2277
2167
  timestamp: ISODateTime;
2168
+ profile_id?: string;
2278
2169
  session_id?: string;
2279
2170
  session_name?: string;
2280
2171
  session_type?: string;
2281
2172
  agent_name?: string;
2282
2173
  workspace_id?: string;
2283
2174
  workspace?: string;
2175
+ worktree_id?: string;
2284
2176
  acp_session_id?: string;
2285
2177
  state?: string;
2286
2178
  soul_snapshot_id?: string;
@@ -2304,12 +2196,14 @@ export interface MessageStartPatch {
2304
2196
  export interface MessageStartPayload {
2305
2197
  event: HookEvent;
2306
2198
  timestamp: ISODateTime;
2199
+ profile_id?: string;
2307
2200
  session_id?: string;
2308
2201
  session_name?: string;
2309
2202
  session_type?: string;
2310
2203
  agent_name?: string;
2311
2204
  workspace_id?: string;
2312
2205
  workspace?: string;
2206
+ worktree_id?: string;
2313
2207
  acp_session_id?: string;
2314
2208
  state?: string;
2315
2209
  soul_snapshot_id?: string;
@@ -2328,7 +2222,39 @@ export interface ModelSourceListParams {
2328
2222
  refresh?: boolean;
2329
2223
  include_stale?: boolean;
2330
2224
  }
2331
- export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
2225
+ export type ReasoningEffort = string;
2226
+ export type ModelSourceOptionKind = string;
2227
+ export interface ModelSourceOptionValue {
2228
+ value_id: string;
2229
+ label?: string;
2230
+ description?: string;
2231
+ group_id?: string;
2232
+ group_label?: string;
2233
+ order?: number;
2234
+ }
2235
+ export interface ModelSourceOptionDescriptor {
2236
+ id: string;
2237
+ label?: string;
2238
+ description?: string;
2239
+ category?: string;
2240
+ kind: ModelSourceOptionKind;
2241
+ current_value_id?: string;
2242
+ current_bool?: boolean;
2243
+ values?: ModelSourceOptionValue[];
2244
+ }
2245
+ export interface ModelSourceOptionSelection {
2246
+ id: string;
2247
+ value_id?: string;
2248
+ bool_value?: boolean;
2249
+ }
2250
+ export interface ModelSourceTransportBinding {
2251
+ transport_model_id: string;
2252
+ label?: string;
2253
+ reasoning_effort?: ReasoningEffort;
2254
+ fast?: boolean;
2255
+ thinking?: boolean;
2256
+ option_selections?: ModelSourceOptionSelection[];
2257
+ }
2332
2258
  export interface ModelCatalogCostPayload {
2333
2259
  input_per_million?: number;
2334
2260
  output_per_million?: number;
@@ -2353,6 +2279,8 @@ export interface ModelSourceRow {
2353
2279
  supports_reasoning?: boolean;
2354
2280
  reasoning_efforts?: ReasoningEffort[];
2355
2281
  default_reasoning_effort?: ReasoningEffort;
2282
+ config_options?: ModelSourceOptionDescriptor[];
2283
+ transport_bindings?: ModelSourceTransportBinding[];
2356
2284
  cost?: ModelCatalogCostPayload;
2357
2285
  deprecated?: boolean;
2358
2286
  hidden?: boolean;
@@ -2378,606 +2306,41 @@ export interface ModelsRefreshParams {
2378
2306
  export interface ModelsStatusParams {
2379
2307
  provider_id?: string;
2380
2308
  }
2381
- export interface NetworkChannelPayload {
2382
- channel: string;
2383
- workspace_id?: string;
2384
- purpose?: string;
2385
- fanout_policy?: string;
2386
- coordinator_peer_id?: string;
2387
- created_by?: string;
2388
- created_at?: ISODateTime;
2389
- peer_count: number;
2390
- local_peer_count?: number;
2391
- session_count?: number;
2392
- message_count?: number;
2393
- presence_count?: number;
2394
- historical_participant_count?: number;
2395
- last_activity_at?: ISODateTime;
2396
- last_presence_at?: ISODateTime;
2397
- last_message_preview?: string;
2398
- }
2399
- export interface NetworkChannelsParams {
2400
- workspace_id: string;
2309
+ export interface PersistenceHealth {
2310
+ status: string;
2311
+ global_db_size_bytes: number;
2312
+ session_db_size_bytes: number;
2401
2313
  }
2402
- export interface NetworkDirectMessagesParams {
2403
- workspace_id: string;
2404
- channel: string;
2405
- direct_id: string;
2406
- before?: string;
2407
- after?: string;
2408
- kind?: string;
2409
- work_id?: string;
2410
- limit?: number;
2314
+ export interface RetentionHealth {
2315
+ enabled: boolean;
2316
+ retention_days: number;
2317
+ sweep_interval_seconds: number;
2318
+ last_sweep_status: string;
2319
+ last_sweep_at?: ISODateTime;
2320
+ last_cutoff_at?: ISODateTime;
2321
+ last_sweep_error?: string;
2322
+ deleted_event_summaries: number;
2323
+ deleted_token_stats: number;
2324
+ deleted_token_usage_daily: number;
2325
+ deleted_permission_log_rows: number;
2411
2326
  }
2412
- export interface NetworkDirectResolveParams {
2413
- workspace_id: string;
2414
- channel: string;
2327
+ export type FailureKind = string;
2328
+ export interface SessionFailureHealth {
2415
2329
  session_id: string;
2416
- peer_id: string;
2417
- }
2418
- export interface NetworkConversationMessagePayload {
2419
- message_id: string;
2330
+ agent_name?: string;
2331
+ provider?: string;
2420
2332
  workspace_id?: string;
2421
- channel: string;
2422
- surface?: string;
2423
- thread_id?: string;
2424
- direct_id?: string;
2425
- kind: string;
2426
- direction: string;
2427
- peer_from: string;
2428
- peer_to?: string;
2429
- mentions?: string[];
2430
- display_name?: string;
2431
- session_id?: string;
2432
- local?: boolean;
2433
- work_id?: string;
2434
- reply_to?: string;
2435
- trace_id?: string;
2436
- causation_id?: string;
2437
- intent?: string;
2438
- text?: string;
2439
- preview_text?: string;
2440
- size_bytes?: number;
2441
- body: JSONValue;
2442
- timestamp: ISODateTime;
2443
- }
2444
- export interface CursorPagePayload {
2445
- next_cursor?: string;
2446
- has_more: boolean;
2447
- limit: number;
2333
+ state?: string;
2334
+ failure_kind: FailureKind;
2335
+ summary?: string;
2336
+ crash_bundle_path?: string;
2337
+ updated_at: ISODateTime;
2448
2338
  }
2449
- export interface NetworkDirectRoomMessagesResponse {
2450
- messages: NetworkConversationMessagePayload[];
2451
- page: CursorPagePayload;
2452
- }
2453
- export interface NetworkDirectRoomOpenedPayload {
2454
- event: HookEvent;
2455
- timestamp: ISODateTime;
2456
- workspace_id?: string;
2457
- session_id?: string;
2458
- channel?: string;
2459
- surface?: string;
2460
- thread_id?: string;
2461
- direct_id?: string;
2462
- message_id?: string;
2463
- kind?: string;
2464
- direction?: string;
2465
- work_id?: string;
2466
- work_state?: string;
2467
- peer_id?: string;
2468
- peer_from?: string;
2469
- peer_to?: string;
2470
- last_seen_at?: ISODateTime;
2471
- trace_id?: string;
2472
- causation_id?: string;
2473
- }
2474
- export interface NetworkDirectRoomPayload {
2475
- workspace_id?: string;
2476
- channel: string;
2477
- direct_id: string;
2478
- session_a: string;
2479
- session_b: string;
2480
- opened_at?: ISODateTime;
2481
- last_activity_at?: ISODateTime;
2482
- message_count: number;
2483
- open_work_count: number;
2484
- last_message_preview?: string;
2485
- }
2486
- export interface NetworkDirectRoomsResponse {
2487
- directs: NetworkDirectRoomPayload[];
2488
- page: CountedCursorPagePayload;
2489
- }
2490
- export interface NetworkDirectsParams {
2491
- workspace_id: string;
2492
- channel: string;
2493
- query?: string;
2494
- peer_id?: string;
2495
- sort?: string;
2496
- has_work?: boolean;
2497
- limit?: number;
2498
- after?: string;
2499
- }
2500
- export interface NetworkMatcher {
2501
- channel?: string;
2502
- surface?: string;
2503
- kind?: string;
2504
- direction?: string;
2505
- work_state?: string;
2506
- participation_mode?: string;
2507
- participation_source?: string;
2508
- }
2509
- export interface NetworkMessagePersistedPayload {
2510
- event: HookEvent;
2511
- timestamp: ISODateTime;
2512
- workspace_id?: string;
2513
- session_id?: string;
2514
- channel?: string;
2515
- surface?: string;
2516
- thread_id?: string;
2517
- direct_id?: string;
2518
- message_id?: string;
2519
- kind?: string;
2520
- direction?: string;
2521
- work_id?: string;
2522
- work_state?: string;
2523
- peer_id?: string;
2524
- peer_from?: string;
2525
- peer_to?: string;
2526
- last_seen_at?: ISODateTime;
2527
- trace_id?: string;
2528
- causation_id?: string;
2529
- }
2530
- export interface NetworkObservationPatch {
2531
- labels?: Record<string, string>;
2532
- }
2533
- export interface NetworkParticipationBounds {
2534
- max_wakes: number;
2535
- max_wake_wall_time: string;
2536
- max_total_wall_time: string;
2537
- max_input_tokens: number;
2538
- max_output_tokens: number;
2539
- max_wake_depth: number;
2540
- coalesce_window: string;
2541
- }
2542
- export interface NetworkParticipationBoundsRequest {
2543
- max_wakes?: number;
2544
- max_wake_wall_time?: string;
2545
- max_total_wall_time?: string;
2546
- max_input_tokens?: number;
2547
- max_output_tokens?: number;
2548
- max_wake_depth?: number;
2549
- coalesce_window?: string;
2550
- }
2551
- export type NetworkParticipationChannelStrategy = "named" | "run" | "loop_run";
2552
- export type NetworkParticipationMode = "local" | "live";
2553
- export type NetworkParticipationOwnerKind = "session" | "task_run" | "loop_run" | "automation_run";
2554
- export interface NetworkParticipationPreResolvePatch {
2555
- deny?: boolean;
2556
- deny_reason?: string;
2557
- request?: NetworkParticipationRequest;
2558
- }
2559
- export interface NetworkParticipationOwnerRef {
2560
- workspace_id: string;
2561
- kind: NetworkParticipationOwnerKind;
2562
- id: string;
2563
- }
2564
- export type NetworkParticipationSource = "explicit_request" | "task_profile" | "workspace_coordination" | "loop_definition" | "automation_job" | "built_in_local";
2565
- export interface NetworkParticipationPreResolvePayload {
2566
- workspace_id: string;
2567
- owner: NetworkParticipationOwnerRef;
2568
- request?: NetworkParticipationRequest;
2569
- source?: NetworkParticipationSource;
2570
- owner_key?: string;
2571
- }
2572
- export type NetworkParticipationResolvedPatch = Record<string, never>;
2573
- export interface NetworkParticipationResolvedPayload {
2574
- workspace_id: string;
2575
- owner: NetworkParticipationOwnerRef;
2576
- owner_key?: string;
2577
- resolved_network_participation: NetworkParticipationSpec;
2578
- }
2579
- export interface NetworkPayload {
2580
- event: HookEvent;
2581
- timestamp: ISODateTime;
2582
- workspace_id?: string;
2583
- session_id?: string;
2584
- channel?: string;
2585
- surface?: string;
2586
- thread_id?: string;
2587
- direct_id?: string;
2588
- message_id?: string;
2589
- kind?: string;
2590
- direction?: string;
2591
- work_id?: string;
2592
- work_state?: string;
2593
- peer_id?: string;
2594
- peer_from?: string;
2595
- peer_to?: string;
2596
- last_seen_at?: ISODateTime;
2597
- trace_id?: string;
2598
- causation_id?: string;
2599
- }
2600
- export interface NetworkPeerJoinedPayload {
2601
- event: HookEvent;
2602
- timestamp: ISODateTime;
2603
- workspace_id?: string;
2604
- session_id?: string;
2605
- channel?: string;
2606
- surface?: string;
2607
- thread_id?: string;
2608
- direct_id?: string;
2609
- message_id?: string;
2610
- kind?: string;
2611
- direction?: string;
2612
- work_id?: string;
2613
- work_state?: string;
2614
- peer_id?: string;
2615
- peer_from?: string;
2616
- peer_to?: string;
2617
- last_seen_at?: ISODateTime;
2618
- trace_id?: string;
2619
- causation_id?: string;
2620
- }
2621
- export interface NetworkPeerLeftPayload {
2622
- event: HookEvent;
2623
- timestamp: ISODateTime;
2624
- workspace_id?: string;
2625
- session_id?: string;
2626
- channel?: string;
2627
- surface?: string;
2628
- thread_id?: string;
2629
- direct_id?: string;
2630
- message_id?: string;
2631
- kind?: string;
2632
- direction?: string;
2633
- work_id?: string;
2634
- work_state?: string;
2635
- peer_id?: string;
2636
- peer_from?: string;
2637
- peer_to?: string;
2638
- last_seen_at?: ISODateTime;
2639
- trace_id?: string;
2640
- causation_id?: string;
2641
- }
2642
- export interface NetworkCapabilityBriefPayload {
2643
- id: string;
2644
- summary: string;
2645
- }
2646
- export interface NetworkPeerCardPayload {
2647
- peer_id: string;
2648
- display_name?: string;
2649
- profiles_supported: string[];
2650
- capabilities: NetworkCapabilityBriefPayload[];
2651
- artifacts_supported: string[];
2652
- trust_modes_supported: string[];
2653
- ext?: Record<string, JSONValue>;
2654
- }
2655
- export interface NetworkPeerPayload {
2656
- workspace_id?: string;
2657
- session_id?: string;
2658
- peer_id: string;
2659
- display_name?: string;
2660
- channel: string;
2661
- local: boolean;
2662
- peer_card: NetworkPeerCardPayload;
2663
- joined_at?: ISODateTime;
2664
- presence_state: string;
2665
- }
2666
- export interface NetworkPeersParams {
2667
- workspace_id: string;
2668
- channel?: string;
2669
- }
2670
- export interface NetworkSendParams {
2671
- workspace_id?: string;
2672
- session_id: string;
2673
- channel: string;
2674
- surface?: string;
2675
- thread_id?: string;
2676
- direct_id?: string;
2677
- kind: string;
2678
- to?: string;
2679
- mentions?: string[];
2680
- body: JSONValue;
2681
- work_id?: string;
2682
- reply_to?: string;
2683
- trace_id?: string;
2684
- causation_id?: string;
2685
- expires_at?: number;
2686
- id?: string;
2687
- ext?: Record<string, JSONValue>;
2688
- }
2689
- export interface NetworkSendPayload {
2690
- id: string;
2691
- workspace_id?: string;
2692
- session_id: string;
2693
- channel: string;
2694
- surface?: string;
2695
- thread_id?: string;
2696
- direct_id?: string;
2697
- kind: string;
2698
- to?: string;
2699
- mentions?: string[];
2700
- work_id?: string;
2701
- reply_to?: string;
2702
- trace_id?: string;
2703
- causation_id?: string;
2704
- expires_at?: number;
2705
- ext?: Record<string, JSONValue>;
2706
- }
2707
- export interface NetworkKindMetricPayload {
2708
- kind: string;
2709
- sent: number;
2710
- received: number;
2711
- rejected: number;
2712
- delivered: number;
2713
- }
2714
- export interface NetworkStatusPayload {
2715
- enabled: boolean;
2716
- status: string;
2717
- local_peers: number;
2718
- channels: number;
2719
- messages_sent: number;
2720
- messages_received: number;
2721
- messages_rejected: number;
2722
- messages_delivered: number;
2723
- workflow_tagged_events: number;
2724
- handoff_tagged_events: number;
2725
- open_threads: number;
2726
- open_direct_rooms: number;
2727
- open_work_items: number;
2728
- conversation_messages: number;
2729
- work_transitions: number;
2730
- direct_resolves: number;
2731
- kind_metrics: NetworkKindMetricPayload[];
2732
- }
2733
- export interface NetworkThreadMessagesParams {
2734
- workspace_id: string;
2735
- channel: string;
2736
- thread_id: string;
2737
- before?: string;
2738
- after?: string;
2739
- kind?: string;
2740
- work_id?: string;
2741
- limit?: number;
2742
- }
2743
- export interface NetworkThreadMessagesResponse {
2744
- messages: NetworkConversationMessagePayload[];
2745
- page: CursorPagePayload;
2746
- }
2747
- export interface NetworkThreadOpenedPayload {
2748
- event: HookEvent;
2749
- timestamp: ISODateTime;
2750
- workspace_id?: string;
2751
- session_id?: string;
2752
- channel?: string;
2753
- surface?: string;
2754
- thread_id?: string;
2755
- direct_id?: string;
2756
- message_id?: string;
2757
- kind?: string;
2758
- direction?: string;
2759
- work_id?: string;
2760
- work_state?: string;
2761
- peer_id?: string;
2762
- peer_from?: string;
2763
- peer_to?: string;
2764
- last_seen_at?: ISODateTime;
2765
- trace_id?: string;
2766
- causation_id?: string;
2767
- }
2768
- export interface NetworkCoordinationCostPayload {
2769
- delivered_count?: number;
2770
- prompt_size_bytes?: number;
2771
- estimated_prompt_tokens?: number;
2772
- }
2773
- export interface NetworkThreadSummaryPayload {
2774
- workspace_id?: string;
2775
- channel: string;
2776
- thread_id: string;
2777
- root_message_id: string;
2778
- title?: string;
2779
- opened_by_peer_id?: string;
2780
- opened_session_id?: string;
2781
- opened_at?: ISODateTime;
2782
- last_activity_at?: ISODateTime;
2783
- message_count: number;
2784
- participant_count: number;
2785
- open_work_count: number;
2786
- coordination_cost?: NetworkCoordinationCostPayload;
2787
- last_message_preview?: string;
2788
- }
2789
- export interface NetworkThreadTargetParams {
2790
- workspace_id: string;
2791
- channel: string;
2792
- thread_id: string;
2793
- }
2794
- export interface NetworkThreadsParams {
2795
- workspace_id: string;
2796
- channel: string;
2797
- query?: string;
2798
- peer_id?: string;
2799
- sort?: string;
2800
- has_work?: boolean;
2801
- limit?: number;
2802
- after?: string;
2803
- }
2804
- export interface NetworkThreadsResponse {
2805
- threads: NetworkThreadSummaryPayload[];
2806
- page: CountedCursorPagePayload;
2807
- }
2808
- export interface NetworkUsageParams {
2809
- workspace_id: string;
2810
- owner_kind?: string;
2811
- owner_id?: string;
2812
- run_id?: string;
2813
- channel?: string;
2814
- cursor?: string;
2815
- limit?: number;
2816
- }
2817
- export interface NetworkParticipationStatus {
2818
- owner: NetworkParticipationOwnerRef;
2819
- available: boolean;
2820
- participating: boolean;
2821
- reason?: string;
2822
- }
2823
- export interface NetworkUsageDetailPayload {
2824
- wake_id: string;
2825
- task_run_id: string;
2826
- participation_status: NetworkParticipationStatus;
2827
- workspace_id: string;
2828
- channel: string;
2829
- root_id: string;
2830
- depth: number;
2831
- state: string;
2832
- usage_state: string;
2833
- charged_wall_time: string;
2834
- input_tokens: number;
2835
- output_tokens: number;
2836
- reserved_at: ISODateTime;
2837
- settled_at?: ISODateTime;
2838
- reason?: string;
2839
- }
2840
- export interface NetworkUsageSummaryPayload {
2841
- wake_count: number;
2842
- reserved_wake_count: number;
2843
- actual_wake_count: number;
2844
- unavailable_wake_count: number;
2845
- charged_wall_time: string;
2846
- input_tokens: number;
2847
- output_tokens: number;
2848
- }
2849
- export interface NetworkBudgetUsagePayload {
2850
- participation_status: NetworkParticipationStatus;
2851
- wakes_used: number;
2852
- wall_time_used: string;
2853
- input_tokens_used: number;
2854
- output_tokens_used: number;
2855
- exhausted_reason?: string;
2856
- updated_at: ISODateTime;
2857
- }
2858
- export interface NetworkUsageResponse {
2859
- workspace_id: string;
2860
- details: NetworkUsageDetailPayload[];
2861
- total: NetworkUsageSummaryPayload;
2862
- budget?: NetworkBudgetUsagePayload;
2863
- next_cursor?: string;
2864
- }
2865
- export interface NetworkWorkClosedPayload {
2866
- event: HookEvent;
2867
- timestamp: ISODateTime;
2868
- workspace_id?: string;
2869
- session_id?: string;
2870
- channel?: string;
2871
- surface?: string;
2872
- thread_id?: string;
2873
- direct_id?: string;
2874
- message_id?: string;
2875
- kind?: string;
2876
- direction?: string;
2877
- work_id?: string;
2878
- work_state?: string;
2879
- peer_id?: string;
2880
- peer_from?: string;
2881
- peer_to?: string;
2882
- last_seen_at?: ISODateTime;
2883
- trace_id?: string;
2884
- causation_id?: string;
2885
- }
2886
- export interface NetworkWorkGetParams {
2887
- workspace_id: string;
2888
- work_id: string;
2889
- }
2890
- export interface NetworkWorkOpenedPayload {
2891
- event: HookEvent;
2892
- timestamp: ISODateTime;
2893
- workspace_id?: string;
2894
- session_id?: string;
2895
- channel?: string;
2896
- surface?: string;
2897
- thread_id?: string;
2898
- direct_id?: string;
2899
- message_id?: string;
2900
- kind?: string;
2901
- direction?: string;
2902
- work_id?: string;
2903
- work_state?: string;
2904
- peer_id?: string;
2905
- peer_from?: string;
2906
- peer_to?: string;
2907
- last_seen_at?: ISODateTime;
2908
- trace_id?: string;
2909
- causation_id?: string;
2910
- }
2911
- export interface NetworkWorkPayload {
2912
- work_id: string;
2913
- workspace_id?: string;
2914
- channel: string;
2915
- surface: string;
2916
- thread_id?: string;
2917
- direct_id?: string;
2918
- opened_session_id?: string;
2919
- target_session_id?: string;
2920
- state: string;
2921
- opened_at?: ISODateTime;
2922
- last_activity_at?: ISODateTime;
2923
- terminal_at?: ISODateTime;
2924
- }
2925
- export interface NetworkWorkTransitionedPayload {
2926
- event: HookEvent;
2927
- timestamp: ISODateTime;
2928
- workspace_id?: string;
2929
- session_id?: string;
2930
- channel?: string;
2931
- surface?: string;
2932
- thread_id?: string;
2933
- direct_id?: string;
2934
- message_id?: string;
2935
- kind?: string;
2936
- direction?: string;
2937
- work_id?: string;
2938
- work_state?: string;
2939
- peer_id?: string;
2940
- peer_from?: string;
2941
- peer_to?: string;
2942
- last_seen_at?: ISODateTime;
2943
- trace_id?: string;
2944
- causation_id?: string;
2945
- }
2946
- export interface PersistenceHealth {
2947
- status: string;
2948
- global_db_size_bytes: number;
2949
- session_db_size_bytes: number;
2950
- }
2951
- export interface RetentionHealth {
2952
- enabled: boolean;
2953
- retention_days: number;
2954
- sweep_interval_seconds: number;
2955
- last_sweep_status: string;
2956
- last_sweep_at?: ISODateTime;
2957
- last_cutoff_at?: ISODateTime;
2958
- last_sweep_error?: string;
2959
- deleted_event_summaries: number;
2960
- deleted_token_stats: number;
2961
- deleted_token_usage_daily: number;
2962
- deleted_permission_log_rows: number;
2963
- }
2964
- export type FailureKind = string;
2965
- export interface SessionFailureHealth {
2966
- session_id: string;
2967
- agent_name?: string;
2968
- provider?: string;
2969
- workspace_id?: string;
2970
- state?: string;
2971
- failure_kind: FailureKind;
2972
- summary?: string;
2973
- crash_bundle_path?: string;
2974
- updated_at: ISODateTime;
2975
- }
2976
- export interface FailureHealth {
2977
- status: string;
2978
- total: number;
2979
- by_kind?: Record<string, number>;
2980
- recent?: SessionFailureHealth[];
2339
+ export interface FailureHealth {
2340
+ status: string;
2341
+ total: number;
2342
+ by_kind?: Record<string, number>;
2343
+ recent?: SessionFailureHealth[];
2981
2344
  }
2982
2345
  export interface ProbeResult {
2983
2346
  agent_name?: string;
@@ -2989,25 +2352,7 @@ export interface ProbeResult {
2989
2352
  checked_at: ISODateTime;
2990
2353
  duration_ms: number;
2991
2354
  }
2992
- export interface BridgeStatusCounts {
2993
- disabled: number;
2994
- starting: number;
2995
- ready: number;
2996
- degraded: number;
2997
- auth_required: number;
2998
- error: number;
2999
- }
3000
- export interface BridgeAggregateHealth {
3001
- total_instances: number;
3002
- route_count: number;
3003
- delivery_backlog: number;
3004
- delivery_dropped_total: number;
3005
- delivery_failures_total: number;
3006
- auth_failures_total: number;
3007
- status_counts: BridgeStatusCounts;
3008
- }
3009
2355
  export interface TaskQueueDepth {
3010
- channel_id?: string;
3011
2356
  count: number;
3012
2357
  oldest_queued_at: ISODateTime;
3013
2358
  oldest_queue_age_ms: number;
@@ -3018,7 +2363,6 @@ export interface StuckTaskRun {
3018
2363
  run_id: string;
3019
2364
  status: RunStatus;
3020
2365
  origin_kind: OriginKind;
3021
- channel_id?: string;
3022
2366
  session_id?: string;
3023
2367
  age_ms: number;
3024
2368
  }
@@ -3026,13 +2370,11 @@ export type Status = string;
3026
2370
  export interface TaskStatusTotal {
3027
2371
  scope: Scope;
3028
2372
  status: Status;
3029
- channel_id?: string;
3030
2373
  count: number;
3031
2374
  }
3032
2375
  export interface TaskRunTotal {
3033
2376
  status: RunStatus;
3034
2377
  origin_kind: OriginKind;
3035
- channel_id?: string;
3036
2378
  count: number;
3037
2379
  }
3038
2380
  export interface TaskOwnerTotal {
@@ -3057,8 +2399,6 @@ export interface TaskHealth {
3057
2399
  run_totals?: TaskRunTotal[];
3058
2400
  owner_totals?: TaskOwnerTotal[];
3059
2401
  forced_stops_since_start: number;
3060
- duplicate_ingress_since_start: number;
3061
- channel_mismatch_since_start: number;
3062
2402
  recovery_since_start: TaskRecoveryTotals;
3063
2403
  }
3064
2404
  export interface SessionActivityHealth {
@@ -3091,7 +2431,6 @@ export interface ObserveHealth {
3091
2431
  retention: RetentionHealth;
3092
2432
  failures: FailureHealth;
3093
2433
  agent_probes?: ProbeResult[];
3094
- bridges: BridgeAggregateHealth;
3095
2434
  tasks: TaskHealth;
3096
2435
  activities?: SessionActivityHealth[];
3097
2436
  version: string;
@@ -3116,12 +2455,14 @@ export interface PermissionToolCall {
3116
2455
  export interface PermissionDeniedPayload {
3117
2456
  event: HookEvent;
3118
2457
  timestamp: ISODateTime;
2458
+ profile_id?: string;
3119
2459
  session_id?: string;
3120
2460
  session_name?: string;
3121
2461
  session_type?: string;
3122
2462
  agent_name?: string;
3123
2463
  workspace_id?: string;
3124
2464
  workspace?: string;
2465
+ worktree_id?: string;
3125
2466
  acp_session_id?: string;
3126
2467
  state?: string;
3127
2468
  soul_snapshot_id?: string;
@@ -3134,7 +2475,6 @@ export interface PermissionDeniedPayload {
3134
2475
  resource?: string;
3135
2476
  decision?: string;
3136
2477
  decision_class?: string;
3137
- tool_input?: JSONValue;
3138
2478
  tool_call: PermissionToolCall;
3139
2479
  }
3140
2480
  export interface PermissionOption {
@@ -3153,12 +2493,14 @@ export interface PermissionRequestPatch {
3153
2493
  export interface PermissionRequestPayload {
3154
2494
  event: HookEvent;
3155
2495
  timestamp: ISODateTime;
2496
+ profile_id?: string;
3156
2497
  session_id?: string;
3157
2498
  session_name?: string;
3158
2499
  session_type?: string;
3159
2500
  agent_name?: string;
3160
2501
  workspace_id?: string;
3161
2502
  workspace?: string;
2503
+ worktree_id?: string;
3162
2504
  acp_session_id?: string;
3163
2505
  state?: string;
3164
2506
  soul_snapshot_id?: string;
@@ -3178,12 +2520,14 @@ export interface PermissionRequestPayload {
3178
2520
  export interface PermissionResolutionPayload {
3179
2521
  event: HookEvent;
3180
2522
  timestamp: ISODateTime;
2523
+ profile_id?: string;
3181
2524
  session_id?: string;
3182
2525
  session_name?: string;
3183
2526
  session_type?: string;
3184
2527
  agent_name?: string;
3185
2528
  workspace_id?: string;
3186
2529
  workspace?: string;
2530
+ worktree_id?: string;
3187
2531
  acp_session_id?: string;
3188
2532
  state?: string;
3189
2533
  soul_snapshot_id?: string;
@@ -3203,12 +2547,14 @@ export type PermissionResolvedPatch = Record<string, never>;
3203
2547
  export interface PermissionResolvedPayload {
3204
2548
  event: HookEvent;
3205
2549
  timestamp: ISODateTime;
2550
+ profile_id?: string;
3206
2551
  session_id?: string;
3207
2552
  session_name?: string;
3208
2553
  session_type?: string;
3209
2554
  agent_name?: string;
3210
2555
  workspace_id?: string;
3211
2556
  workspace?: string;
2557
+ worktree_id?: string;
3212
2558
  acp_session_id?: string;
3213
2559
  state?: string;
3214
2560
  soul_snapshot_id?: string;
@@ -3229,8 +2575,6 @@ export interface PermissionSet {
3229
2575
  skills?: string[];
3230
2576
  mcp_servers?: string[];
3231
2577
  workspace_paths?: string[];
3232
- network_channels?: string[];
3233
- sandbox_profiles?: string[];
3234
2578
  }
3235
2579
  export interface PromptPatch {
3236
2580
  deny?: boolean;
@@ -3241,12 +2585,14 @@ export interface PromptPatch {
3241
2585
  export interface PromptPayload {
3242
2586
  event: HookEvent;
3243
2587
  timestamp: ISODateTime;
2588
+ profile_id?: string;
3244
2589
  session_id?: string;
3245
2590
  session_name?: string;
3246
2591
  session_type?: string;
3247
2592
  agent_name?: string;
3248
2593
  workspace_id?: string;
3249
2594
  workspace?: string;
2595
+ worktree_id?: string;
3250
2596
  acp_session_id?: string;
3251
2597
  state?: string;
3252
2598
  soul_snapshot_id?: string;
@@ -3266,6 +2612,28 @@ export interface ModelCatalogSourceRefPayload {
3266
2612
  stale: boolean;
3267
2613
  last_error?: string;
3268
2614
  }
2615
+ export interface SessionConfigOptionValuePayload {
2616
+ value: string;
2617
+ label?: string;
2618
+ description?: string;
2619
+ group_id?: string;
2620
+ group_label?: string;
2621
+ }
2622
+ export interface SessionConfigOptionPayload {
2623
+ id: string;
2624
+ label?: string;
2625
+ description?: string;
2626
+ category?: string;
2627
+ kind: string;
2628
+ current_value_id?: string;
2629
+ current_bool?: boolean;
2630
+ values?: SessionConfigOptionValuePayload[];
2631
+ }
2632
+ export interface ProviderModelConfigurationPayload {
2633
+ reasoning_effort?: ReasoningEffort;
2634
+ fast?: boolean;
2635
+ thinking?: boolean;
2636
+ }
3269
2637
  export type ReasoningSource = "acp" | "catalog";
3270
2638
  export interface ProviderModelPayload {
3271
2639
  provider_id: string;
@@ -3283,12 +2651,16 @@ export interface ProviderModelPayload {
3283
2651
  supports_reasoning?: boolean;
3284
2652
  reasoning_efforts?: ReasoningEffort[];
3285
2653
  default_reasoning_effort?: ReasoningEffort;
2654
+ config_options?: SessionConfigOptionPayload[];
2655
+ configurations?: ProviderModelConfigurationPayload[];
3286
2656
  cost?: ModelCatalogCostPayload;
3287
2657
  curated: boolean;
3288
2658
  deprecated: boolean;
3289
2659
  hidden: boolean;
3290
2660
  featured: boolean;
3291
2661
  release_date?: string;
2662
+ reasoning_known?: boolean;
2663
+ reasoning_apply?: string;
3292
2664
  reasoning_source?: ReasoningSource;
3293
2665
  last_error?: string;
3294
2666
  }
@@ -3296,6 +2668,7 @@ export interface ProviderModelListResponse {
3296
2668
  models: ProviderModelPayload[];
3297
2669
  }
3298
2670
  export interface ModelCatalogSourceStatusPayload {
2671
+ failure_reason?: string;
3299
2672
  source_id: string;
3300
2673
  source_kind: string;
3301
2674
  provider_id: string;
@@ -3362,7 +2735,10 @@ export interface ResourcesSnapshotParams {
3362
2735
  records: ResourceSnapshotRecord[];
3363
2736
  }
3364
2737
  export interface Run {
2738
+ workspace_id?: string;
2739
+ attribution: string;
3365
2740
  id: string;
2741
+ profile_id?: string;
3366
2742
  job_id?: string;
3367
2743
  trigger_id?: string;
3368
2744
  session_id?: string;
@@ -3378,211 +2754,40 @@ export interface Run {
3378
2754
  error?: string;
3379
2755
  delivery_error?: string;
3380
2756
  delivery_error_at?: ISODateTime;
3381
- network_participation?: NetworkParticipationRequest;
3382
2757
  metadata?: Record<string, JSONValue>;
3383
2758
  }
3384
- export interface SandboxExecParams {
3385
- workspace_id: string;
3386
- session_id: string;
3387
- command: string;
3388
- timeout?: number;
3389
- }
3390
- export interface SandboxExecResult {
3391
- exit_code: number;
3392
- stdout?: string;
3393
- stderr?: string;
3394
- }
3395
- export interface SandboxInfoParams {
3396
- workspace_id: string;
3397
- session_id: string;
3398
- }
3399
- export interface SandboxInfoResult {
3400
- sandbox_id: string;
3401
- backend: string;
3402
- profile: string;
3403
- instance_id: string;
3404
- runtime_root: string;
3405
- sync_state: string;
3406
- created_at: ISODateTime;
3407
- last_sync_error: string;
3408
- }
3409
- export interface SandboxListParams {
3410
- workspace?: string;
3411
- }
3412
- export interface SandboxSummary {
3413
- session_id: string;
3414
- sandbox_id: string;
3415
- backend: string;
3416
- profile?: string;
3417
- instance_id?: string;
3418
- state: string;
3419
- sync_state?: string;
3420
- }
3421
- export interface SandboxListResult {
3422
- sandboxes: SandboxSummary[];
3423
- }
3424
- export type SandboxObservationPatch = Record<string, never>;
3425
- export interface SandboxPreparePatch {
3426
- deny?: boolean;
3427
- deny_reason?: string;
3428
- env_overrides?: Record<string, string>;
3429
- }
3430
- export interface SandboxProfilePayload {
3431
- profile?: string;
3432
- backend?: string;
3433
- sync_mode?: string;
3434
- persistence?: string;
3435
- runtime_root?: string;
3436
- destroy_on_stop?: boolean;
3437
- env?: Record<string, string>;
3438
- secret_env?: Record<string, string>;
3439
- }
3440
- export interface SandboxPreparePayload {
2759
+ export interface SessionAttentionChangedPayload {
3441
2760
  event: HookEvent;
3442
2761
  timestamp: ISODateTime;
2762
+ profile_id?: string;
3443
2763
  session_id?: string;
3444
2764
  session_name?: string;
3445
2765
  session_type?: string;
3446
2766
  agent_name?: string;
3447
2767
  workspace_id?: string;
3448
2768
  workspace?: string;
2769
+ worktree_id?: string;
3449
2770
  acp_session_id?: string;
3450
2771
  state?: string;
3451
2772
  soul_snapshot_id?: string;
3452
2773
  soul_digest?: string;
3453
2774
  created_at: ISODateTime;
3454
2775
  updated_at: ISODateTime;
3455
- sandbox_id?: string;
3456
- backend?: string;
3457
- profile: SandboxProfilePayload;
3458
- local_root?: string;
3459
- local_additional_dirs?: string[];
3460
- agent_command?: string;
3461
- agent_env?: string[];
3462
- permissions?: string;
3463
- resume_acp_state?: string;
3464
- env_overrides?: Record<string, string>;
3465
- denied?: boolean;
3466
- deny_reason?: string;
3467
- }
3468
- export type SandboxReadyPatch = Record<string, never>;
3469
- export interface SandboxReadyPayload {
3470
- event: HookEvent;
3471
- timestamp: ISODateTime;
3472
- session_id?: string;
3473
- session_name?: string;
3474
- session_type?: string;
3475
- agent_name?: string;
3476
- workspace_id?: string;
3477
- workspace?: string;
3478
- acp_session_id?: string;
3479
- state?: string;
3480
- soul_snapshot_id?: string;
3481
- soul_digest?: string;
3482
- created_at: ISODateTime;
3483
- updated_at: ISODateTime;
3484
- sandbox_id?: string;
3485
- backend?: string;
3486
- profile?: string;
3487
- instance_id?: string;
3488
- runtime_root?: string;
3489
- runtime_additional_dirs?: string[];
3490
- }
3491
- export interface SandboxStopPatch {
3492
- deny?: boolean;
3493
- deny_reason?: string;
3494
- }
3495
- export interface SandboxStopPayload {
3496
- event: HookEvent;
3497
- timestamp: ISODateTime;
3498
- session_id?: string;
3499
- session_name?: string;
3500
- session_type?: string;
3501
- agent_name?: string;
3502
- workspace_id?: string;
3503
- workspace?: string;
3504
- acp_session_id?: string;
3505
- state?: string;
3506
- soul_snapshot_id?: string;
3507
- soul_digest?: string;
3508
- created_at: ISODateTime;
3509
- updated_at: ISODateTime;
3510
- sandbox_id?: string;
3511
- backend?: string;
3512
- profile?: string;
3513
- instance_id?: string;
3514
- runtime_root?: string;
3515
- stop_reason?: string;
3516
- will_destroy?: boolean;
3517
- denied?: boolean;
3518
- deny_reason?: string;
3519
- }
3520
- export type SandboxSyncAfterPatch = Record<string, never>;
3521
- export interface SandboxSyncAfterPayload {
3522
- event: HookEvent;
3523
- timestamp: ISODateTime;
3524
- session_id?: string;
3525
- session_name?: string;
3526
- session_type?: string;
3527
- agent_name?: string;
3528
- workspace_id?: string;
3529
- workspace?: string;
3530
- acp_session_id?: string;
3531
- state?: string;
3532
- soul_snapshot_id?: string;
3533
- soul_digest?: string;
3534
- created_at: ISODateTime;
3535
- updated_at: ISODateTime;
3536
- sandbox_id?: string;
3537
- backend?: string;
3538
- profile?: string;
3539
- instance_id?: string;
3540
- runtime_root?: string;
3541
- direction?: string;
3542
- reason?: string;
3543
- files_synced?: number;
3544
- bytes_transferred?: number;
3545
- duration_ms?: number;
3546
- errors?: string[];
3547
- }
3548
- export interface SandboxSyncBeforePatch {
3549
- deny?: boolean;
3550
- deny_reason?: string;
3551
- exclude_patterns?: string[];
3552
- }
3553
- export interface SandboxSyncBeforePayload {
3554
- event: HookEvent;
3555
- timestamp: ISODateTime;
3556
- session_id?: string;
3557
- session_name?: string;
3558
- session_type?: string;
3559
- agent_name?: string;
3560
- workspace_id?: string;
3561
- workspace?: string;
3562
- acp_session_id?: string;
3563
- state?: string;
3564
- soul_snapshot_id?: string;
3565
- soul_digest?: string;
3566
- created_at: ISODateTime;
3567
- updated_at: ISODateTime;
3568
- sandbox_id?: string;
3569
- backend?: string;
3570
- profile?: string;
3571
- instance_id?: string;
3572
- runtime_root?: string;
3573
- direction?: string;
3574
- reason?: string;
3575
- exclude_patterns?: string[];
3576
- denied?: boolean;
3577
- deny_reason?: string;
2776
+ from: string;
2777
+ to: string;
2778
+ class: string;
2779
+ at: ISODateTime;
3578
2780
  }
2781
+ export type SessionAttentionObservationPatch = Record<string, never>;
3579
2782
  export interface SessionContext {
2783
+ profile_id?: string;
3580
2784
  session_id?: string;
3581
2785
  session_name?: string;
3582
2786
  session_type?: string;
3583
2787
  agent_name?: string;
3584
2788
  workspace_id?: string;
3585
2789
  workspace?: string;
2790
+ worktree_id?: string;
3586
2791
  acp_session_id?: string;
3587
2792
  state?: string;
3588
2793
  soul_snapshot_id?: string;
@@ -3627,12 +2832,14 @@ export interface SessionHealthResponse {
3627
2832
  export interface SessionHealthUpdateAfterPayload {
3628
2833
  event: HookEvent;
3629
2834
  timestamp: ISODateTime;
2835
+ profile_id?: string;
3630
2836
  session_id?: string;
3631
2837
  session_name?: string;
3632
2838
  session_type?: string;
3633
2839
  agent_name?: string;
3634
2840
  workspace_id?: string;
3635
2841
  workspace?: string;
2842
+ worktree_id?: string;
3636
2843
  acp_session_id?: string;
3637
2844
  state?: string;
3638
2845
  soul_snapshot_id?: string;
@@ -3648,16 +2855,24 @@ export interface SessionHealthUpdateAfterPayload {
3648
2855
  last_presence_at: ISODateTime;
3649
2856
  last_error?: string;
3650
2857
  }
2858
+ export type SteerDeliveryMode = "injected" | "pending_injection" | "interrupt_fallback";
3651
2859
  export type PromptMode = string;
3652
2860
  export type PromptDelivery = string;
3653
2861
  export type Speed = string;
2862
+ export interface AgentACPOptionSelection {
2863
+ id: string;
2864
+ value_id?: string;
2865
+ bool_value?: boolean;
2866
+ }
3654
2867
  export interface PromptRuntimeSelectionPayload {
3655
2868
  provider: string;
3656
2869
  model?: string;
3657
2870
  reasoning_effort?: ReasoningEffort;
3658
2871
  speed?: Speed;
2872
+ acp_options?: AgentACPOptionSelection[];
3659
2873
  }
3660
2874
  export interface SessionInput {
2875
+ steer_delivery?: SteerDeliveryMode;
3661
2876
  id: string;
3662
2877
  session_id: string;
3663
2878
  message_id?: string;
@@ -3715,12 +2930,14 @@ export interface SessionInspectResponse {
3715
2930
  export interface SessionLifecyclePayload {
3716
2931
  event: HookEvent;
3717
2932
  timestamp: ISODateTime;
2933
+ profile_id?: string;
3718
2934
  session_id?: string;
3719
2935
  session_name?: string;
3720
2936
  session_type?: string;
3721
2937
  agent_name?: string;
3722
2938
  workspace_id?: string;
3723
2939
  workspace?: string;
2940
+ worktree_id?: string;
3724
2941
  acp_session_id?: string;
3725
2942
  state?: string;
3726
2943
  soul_snapshot_id?: string;
@@ -3731,12 +2948,14 @@ export interface SessionLifecyclePayload {
3731
2948
  export interface SessionMessagePersistedPayload {
3732
2949
  event: HookEvent;
3733
2950
  timestamp: ISODateTime;
2951
+ profile_id?: string;
3734
2952
  session_id?: string;
3735
2953
  session_name?: string;
3736
2954
  session_type?: string;
3737
2955
  agent_name?: string;
3738
2956
  workspace_id?: string;
3739
2957
  workspace?: string;
2958
+ worktree_id?: string;
3740
2959
  acp_session_id?: string;
3741
2960
  state?: string;
3742
2961
  soul_snapshot_id?: string;
@@ -3767,12 +2986,14 @@ export interface SessionPostCreatePatch {
3767
2986
  export interface SessionPostCreatePayload {
3768
2987
  event: HookEvent;
3769
2988
  timestamp: ISODateTime;
2989
+ profile_id?: string;
3770
2990
  session_id?: string;
3771
2991
  session_name?: string;
3772
2992
  session_type?: string;
3773
2993
  agent_name?: string;
3774
2994
  workspace_id?: string;
3775
2995
  workspace?: string;
2996
+ worktree_id?: string;
3776
2997
  acp_session_id?: string;
3777
2998
  state?: string;
3778
2999
  soul_snapshot_id?: string;
@@ -3792,12 +3013,14 @@ export interface SessionPostResumePatch {
3792
3013
  export interface SessionPostResumePayload {
3793
3014
  event: HookEvent;
3794
3015
  timestamp: ISODateTime;
3016
+ profile_id?: string;
3795
3017
  session_id?: string;
3796
3018
  session_name?: string;
3797
3019
  session_type?: string;
3798
3020
  agent_name?: string;
3799
3021
  workspace_id?: string;
3800
3022
  workspace?: string;
3023
+ worktree_id?: string;
3801
3024
  acp_session_id?: string;
3802
3025
  state?: string;
3803
3026
  soul_snapshot_id?: string;
@@ -3817,12 +3040,14 @@ export interface SessionPostStopPatch {
3817
3040
  export interface SessionPostStopPayload {
3818
3041
  event: HookEvent;
3819
3042
  timestamp: ISODateTime;
3043
+ profile_id?: string;
3820
3044
  session_id?: string;
3821
3045
  session_name?: string;
3822
3046
  session_type?: string;
3823
3047
  agent_name?: string;
3824
3048
  workspace_id?: string;
3825
3049
  workspace?: string;
3050
+ worktree_id?: string;
3826
3051
  acp_session_id?: string;
3827
3052
  state?: string;
3828
3053
  soul_snapshot_id?: string;
@@ -3833,12 +3058,14 @@ export interface SessionPostStopPayload {
3833
3058
  export interface SessionPreCreatePayload {
3834
3059
  event: HookEvent;
3835
3060
  timestamp: ISODateTime;
3061
+ profile_id?: string;
3836
3062
  session_id?: string;
3837
3063
  session_name?: string;
3838
3064
  session_type?: string;
3839
3065
  agent_name?: string;
3840
3066
  workspace_id?: string;
3841
3067
  workspace?: string;
3068
+ worktree_id?: string;
3842
3069
  acp_session_id?: string;
3843
3070
  state?: string;
3844
3071
  soul_snapshot_id?: string;
@@ -3858,12 +3085,14 @@ export interface SessionPreResumePatch {
3858
3085
  export interface SessionPreResumePayload {
3859
3086
  event: HookEvent;
3860
3087
  timestamp: ISODateTime;
3088
+ profile_id?: string;
3861
3089
  session_id?: string;
3862
3090
  session_name?: string;
3863
3091
  session_type?: string;
3864
3092
  agent_name?: string;
3865
3093
  workspace_id?: string;
3866
3094
  workspace?: string;
3095
+ worktree_id?: string;
3867
3096
  acp_session_id?: string;
3868
3097
  state?: string;
3869
3098
  soul_snapshot_id?: string;
@@ -3883,12 +3112,14 @@ export interface SessionPreStopPatch {
3883
3112
  export interface SessionPreStopPayload {
3884
3113
  event: HookEvent;
3885
3114
  timestamp: ISODateTime;
3115
+ profile_id?: string;
3886
3116
  session_id?: string;
3887
3117
  session_name?: string;
3888
3118
  session_type?: string;
3889
3119
  agent_name?: string;
3890
3120
  workspace_id?: string;
3891
3121
  workspace?: string;
3122
+ worktree_id?: string;
3892
3123
  acp_session_id?: string;
3893
3124
  state?: string;
3894
3125
  soul_snapshot_id?: string;
@@ -3896,7 +3127,11 @@ export interface SessionPreStopPayload {
3896
3127
  created_at: ISODateTime;
3897
3128
  updated_at: ISODateTime;
3898
3129
  }
3130
+ export type Disposition = "direct" | "steering" | "queued" | "interrupting";
3899
3131
  export interface SessionPromptResult {
3132
+ disposition?: Disposition;
3133
+ steer_delivery?: SteerDeliveryMode;
3134
+ entry_id?: string;
3900
3135
  status: string;
3901
3136
  mode?: PromptMode;
3902
3137
  delivery: PromptDelivery;
@@ -3916,11 +3151,87 @@ export interface SessionRuntimeClearParams {
3916
3151
  session_id: string;
3917
3152
  expected_revision?: number;
3918
3153
  }
3154
+ export interface SessionRuntimeRecoveryExhaustedPayload {
3155
+ event: HookEvent;
3156
+ timestamp: ISODateTime;
3157
+ profile_id?: string;
3158
+ session_id?: string;
3159
+ session_name?: string;
3160
+ session_type?: string;
3161
+ agent_name?: string;
3162
+ workspace_id?: string;
3163
+ workspace?: string;
3164
+ worktree_id?: string;
3165
+ acp_session_id?: string;
3166
+ state?: string;
3167
+ soul_snapshot_id?: string;
3168
+ soul_digest?: string;
3169
+ created_at: ISODateTime;
3170
+ updated_at: ISODateTime;
3171
+ turn_id?: string;
3172
+ run_id: string;
3173
+ attempt: number;
3174
+ max_attempts: number;
3175
+ generation: number;
3176
+ failure_kind?: string;
3177
+ failure_detail?: string;
3178
+ }
3179
+ export interface SessionRuntimeRecoveryStartedPayload {
3180
+ event: HookEvent;
3181
+ timestamp: ISODateTime;
3182
+ profile_id?: string;
3183
+ session_id?: string;
3184
+ session_name?: string;
3185
+ session_type?: string;
3186
+ agent_name?: string;
3187
+ workspace_id?: string;
3188
+ workspace?: string;
3189
+ worktree_id?: string;
3190
+ acp_session_id?: string;
3191
+ state?: string;
3192
+ soul_snapshot_id?: string;
3193
+ soul_digest?: string;
3194
+ created_at: ISODateTime;
3195
+ updated_at: ISODateTime;
3196
+ turn_id?: string;
3197
+ run_id: string;
3198
+ attempt: number;
3199
+ max_attempts: number;
3200
+ generation: number;
3201
+ failure_kind?: string;
3202
+ failure_detail?: string;
3203
+ }
3204
+ export interface SessionRuntimeRecoverySucceededPayload {
3205
+ event: HookEvent;
3206
+ timestamp: ISODateTime;
3207
+ profile_id?: string;
3208
+ session_id?: string;
3209
+ session_name?: string;
3210
+ session_type?: string;
3211
+ agent_name?: string;
3212
+ workspace_id?: string;
3213
+ workspace?: string;
3214
+ worktree_id?: string;
3215
+ acp_session_id?: string;
3216
+ state?: string;
3217
+ soul_snapshot_id?: string;
3218
+ soul_digest?: string;
3219
+ created_at: ISODateTime;
3220
+ updated_at: ISODateTime;
3221
+ turn_id?: string;
3222
+ run_id: string;
3223
+ attempt: number;
3224
+ max_attempts: number;
3225
+ generation: number;
3226
+ failure_kind?: string;
3227
+ failure_detail?: string;
3228
+ }
3919
3229
  export interface SessionRuntimeSelectionPayload {
3920
3230
  provider: string;
3921
3231
  model?: string;
3922
3232
  reasoning_effort?: ReasoningEffort;
3923
3233
  speed?: Speed;
3234
+ acp_options?: AgentACPOptionSelection[];
3924
3235
  }
3925
3236
  export interface SessionRuntimeSetParams {
3926
3237
  workspace_id: string;
@@ -3940,6 +3251,15 @@ export interface SessionSoulRefreshRequest {
3940
3251
  }
3941
3252
  export type SessionRuntimeStatus = string;
3942
3253
  export type SessionRuntimeTransition = string;
3254
+ export interface SessionRuntimeRecoveryPayload {
3255
+ attempt: number;
3256
+ max_attempts: number;
3257
+ generation: number;
3258
+ started_at: ISODateTime;
3259
+ last_attempt_at: ISODateTime;
3260
+ next_attempt_at?: ISODateTime;
3261
+ last_error?: string;
3262
+ }
3943
3263
  export type ResolutionStatus = string;
3944
3264
  export type ResolutionReason = string;
3945
3265
  export interface Resolution {
@@ -3952,23 +3272,16 @@ export interface RuntimeSelectionPayload {
3952
3272
  model?: string;
3953
3273
  reasoning_effort?: ReasoningEffort;
3954
3274
  speed?: Speed;
3275
+ acp_options?: AgentACPOptionSelection[];
3955
3276
  speed_resolution?: Resolution;
3956
3277
  }
3957
- export interface SessionConfigOptionValuePayload {
3958
- value: string;
3959
- label?: string;
3960
- description?: string;
3961
- }
3962
- export interface SessionConfigOptionPayload {
3963
- id: string;
3964
- label?: string;
3965
- description?: string;
3966
- kind: string;
3967
- current?: string;
3968
- values?: SessionConfigOptionValuePayload[];
3969
- }
3970
3278
  export interface ACPCapsPayload {
3971
3279
  supports_load_session: boolean;
3280
+ supports_fork_session: boolean;
3281
+ supports_resume_session: boolean;
3282
+ prompt_image: boolean;
3283
+ prompt_audio: boolean;
3284
+ prompt_embedded_context: boolean;
3972
3285
  supported_modes?: string[];
3973
3286
  config_options?: SessionConfigOptionPayload[];
3974
3287
  }
@@ -3976,13 +3289,16 @@ export interface SessionRuntimePayload {
3976
3289
  status: SessionRuntimeStatus;
3977
3290
  transition?: SessionRuntimeTransition;
3978
3291
  failure?: string;
3292
+ generation?: number;
3293
+ recovery?: SessionRuntimeRecoveryPayload;
3979
3294
  selected?: PromptRuntimeSelectionPayload;
3980
3295
  selection_revision: number;
3981
3296
  effective?: RuntimeSelectionPayload;
3297
+ requested?: PromptRuntimeSelectionPayload;
3298
+ last_known?: RuntimeSelectionPayload;
3982
3299
  acp_session_id?: string;
3983
3300
  acp_caps?: ACPCapsPayload;
3984
3301
  }
3985
- export type State = "starting" | "active" | "stopping" | "stopped";
3986
3302
  export type StopReason = "completed" | "user_canceled" | "max_iterations" | "loop_detected" | "timeout" | "budget_exceeded" | "error" | "agent_crashed" | "hook_stopped" | "shutdown";
3987
3303
  export interface SessionStatus {
3988
3304
  session_id: string;
@@ -3996,23 +3312,95 @@ export interface SessionStatus {
3996
3312
  stop_reason?: StopReason;
3997
3313
  stop_detail?: string;
3998
3314
  created_at: ISODateTime;
3999
- updated_at: ISODateTime;
4000
- }
4001
- export interface SessionStatusGetParams {
4002
- workspace_id: string;
4003
- session_id: string;
3315
+ updated_at: ISODateTime;
3316
+ }
3317
+ export interface SessionStatusGetParams {
3318
+ workspace_id: string;
3319
+ session_id: string;
3320
+ }
3321
+ export interface ReplyWatchPayload {
3322
+ id: string;
3323
+ target_session_id: string;
3324
+ message_id: string;
3325
+ state: string;
3326
+ created_at: ISODateTime;
3327
+ }
3328
+ export interface SessionQueueSummaryPayload {
3329
+ entries: number;
3330
+ cap: number;
3331
+ }
3332
+ export type Badge = "running" | "idle" | "unhealthy" | "hung" | "waiting-for-auth" | "waiting-for-input" | "done" | "stopped" | "failed" | "unknown" | "needs-attention" | "waiting";
3333
+ export interface PendingInteractionPayload {
3334
+ interaction_id: string;
3335
+ kind: string;
3336
+ provider_request_id: string;
3337
+ turn_id?: string;
3338
+ title?: string;
3339
+ choices?: string[];
3340
+ decisions?: string[];
3341
+ tool_id?: string;
3342
+ status: string;
3343
+ created_at: ISODateTime;
3344
+ resolved_at?: ISODateTime;
3345
+ resolution?: string;
3346
+ resolved_by?: string;
3347
+ }
3348
+ export type LineageKind = string;
3349
+ export interface SpawnBudgetPayload {
3350
+ max_children: number;
3351
+ max_depth: number;
3352
+ ttl_seconds: number;
3353
+ max_active_per_workspace?: number;
3354
+ }
3355
+ export interface SpawnPermissionPolicyPayload {
3356
+ tools: string[];
3357
+ skills: string[];
3358
+ mcp_servers: string[];
3359
+ workspace_paths: string[];
3360
+ }
3361
+ export interface SessionLineagePayload {
3362
+ parent_session_id?: string;
3363
+ root_session_id?: string;
3364
+ spawn_depth: number;
3365
+ spawn_role?: string;
3366
+ kind?: LineageKind;
3367
+ origin_message_id?: string;
3368
+ origin_agent_name?: string;
3369
+ ttl_expires_at?: ISODateTime;
3370
+ auto_stop_on_parent: boolean;
3371
+ notify_creator: boolean;
3372
+ spawn_budget: SpawnBudgetPayload;
3373
+ permission_policy: SpawnPermissionPolicyPayload;
3374
+ }
3375
+ export interface SessionDerivationPayload {
3376
+ kind: LineageKind;
3377
+ source_session_id: string;
3378
+ seed: string;
3379
+ native_state?: string;
3380
+ native_fork_error?: string;
3381
+ first_prompt: string;
4004
3382
  }
4005
3383
  export interface SessionStatusResponse {
3384
+ reply_watches?: ReplyWatchPayload[];
3385
+ queue?: SessionQueueSummaryPayload;
3386
+ lifecycle_state?: State;
3387
+ verified?: boolean;
3388
+ escalated?: boolean;
3389
+ attention?: string;
4006
3390
  session_id: string;
4007
3391
  workspace_id: string;
4008
3392
  agent_name: string;
4009
3393
  state: SessionHealthState;
3394
+ badge: Badge;
4010
3395
  health: SessionHealthStatus;
4011
3396
  active_prompt: boolean;
4012
3397
  attachable: boolean;
4013
3398
  eligible_for_wake: boolean;
4014
3399
  ineligibility_reason?: SessionHealthIneligibilityReason;
4015
3400
  wake_state?: HeartbeatWakeStatePayload;
3401
+ pending_interactions: PendingInteractionPayload[];
3402
+ lineage?: SessionLineagePayload;
3403
+ derivation?: SessionDerivationPayload;
4016
3404
  updated_at: ISODateTime;
4017
3405
  }
4018
3406
  export interface SessionSummary {
@@ -4032,7 +3420,6 @@ export interface SessionTargetParams {
4032
3420
  export interface SessionsCreateParams {
4033
3421
  agent: string;
4034
3422
  workspace?: string;
4035
- network_participation?: NetworkParticipationRequest;
4036
3423
  }
4037
3424
  export interface SessionsListParams {
4038
3425
  workspace?: string;
@@ -4070,6 +3457,7 @@ export interface SkillSummary {
4070
3457
  name: string;
4071
3458
  description?: string;
4072
3459
  source: string;
3460
+ origin: string;
4073
3461
  enabled: boolean;
4074
3462
  activation: SkillActivationPayload;
4075
3463
  }
@@ -4078,6 +3466,7 @@ export interface SkillsListParams {
4078
3466
  for_agent?: string;
4079
3467
  }
4080
3468
  export interface SpawnContext {
3469
+ profile_id?: string;
4081
3470
  parent_session_id?: string;
4082
3471
  root_session_id?: string;
4083
3472
  child_session_id?: string;
@@ -4091,7 +3480,6 @@ export interface SpawnContext {
4091
3480
  task_id?: string;
4092
3481
  run_id?: string;
4093
3482
  workflow_id?: string;
4094
- resolved_network_participation?: NetworkParticipationSpec;
4095
3483
  soul_snapshot_id?: string;
4096
3484
  soul_digest?: string;
4097
3485
  parent_soul_digest?: string;
@@ -4107,6 +3495,7 @@ export interface SpawnCreatePatch {
4107
3495
  export interface SpawnCreatedPayload {
4108
3496
  event: HookEvent;
4109
3497
  timestamp: ISODateTime;
3498
+ profile_id?: string;
4110
3499
  parent_session_id?: string;
4111
3500
  root_session_id?: string;
4112
3501
  child_session_id?: string;
@@ -4120,7 +3509,6 @@ export interface SpawnCreatedPayload {
4120
3509
  task_id?: string;
4121
3510
  run_id?: string;
4122
3511
  workflow_id?: string;
4123
- resolved_network_participation?: NetworkParticipationSpec;
4124
3512
  soul_snapshot_id?: string;
4125
3513
  soul_digest?: string;
4126
3514
  parent_soul_digest?: string;
@@ -4133,6 +3521,7 @@ export interface SpawnCreatedPayload {
4133
3521
  export interface SpawnLifecyclePayload {
4134
3522
  event: HookEvent;
4135
3523
  timestamp: ISODateTime;
3524
+ profile_id?: string;
4136
3525
  parent_session_id?: string;
4137
3526
  root_session_id?: string;
4138
3527
  child_session_id?: string;
@@ -4146,7 +3535,6 @@ export interface SpawnLifecyclePayload {
4146
3535
  task_id?: string;
4147
3536
  run_id?: string;
4148
3537
  workflow_id?: string;
4149
- resolved_network_participation?: NetworkParticipationSpec;
4150
3538
  soul_snapshot_id?: string;
4151
3539
  soul_digest?: string;
4152
3540
  parent_soul_digest?: string;
@@ -4162,6 +3550,7 @@ export interface SpawnObservationPatch {
4162
3550
  export interface SpawnParentStoppedPayload {
4163
3551
  event: HookEvent;
4164
3552
  timestamp: ISODateTime;
3553
+ profile_id?: string;
4165
3554
  parent_session_id?: string;
4166
3555
  root_session_id?: string;
4167
3556
  child_session_id?: string;
@@ -4175,7 +3564,6 @@ export interface SpawnParentStoppedPayload {
4175
3564
  task_id?: string;
4176
3565
  run_id?: string;
4177
3566
  workflow_id?: string;
4178
- resolved_network_participation?: NetworkParticipationSpec;
4179
3567
  soul_snapshot_id?: string;
4180
3568
  soul_digest?: string;
4181
3569
  parent_soul_digest?: string;
@@ -4185,9 +3573,18 @@ export interface SpawnParentStoppedPayload {
4185
3573
  reap_reason?: string;
4186
3574
  error?: string;
4187
3575
  }
3576
+ export interface SubagentSpawnPayload {
3577
+ isolation: string;
3578
+ worktree_id?: string;
3579
+ title: string;
3580
+ role: string;
3581
+ task_chars: number;
3582
+ }
4188
3583
  export interface SpawnPreCreatePayload {
3584
+ subagent?: SubagentSpawnPayload;
4189
3585
  event: HookEvent;
4190
3586
  timestamp: ISODateTime;
3587
+ profile_id?: string;
4191
3588
  parent_session_id?: string;
4192
3589
  root_session_id?: string;
4193
3590
  child_session_id?: string;
@@ -4201,7 +3598,6 @@ export interface SpawnPreCreatePayload {
4201
3598
  task_id?: string;
4202
3599
  run_id?: string;
4203
3600
  workflow_id?: string;
4204
- resolved_network_participation?: NetworkParticipationSpec;
4205
3601
  soul_snapshot_id?: string;
4206
3602
  soul_digest?: string;
4207
3603
  parent_soul_digest?: string;
@@ -4213,6 +3609,7 @@ export interface SpawnPreCreatePayload {
4213
3609
  export interface SpawnReapedPayload {
4214
3610
  event: HookEvent;
4215
3611
  timestamp: ISODateTime;
3612
+ profile_id?: string;
4216
3613
  parent_session_id?: string;
4217
3614
  root_session_id?: string;
4218
3615
  child_session_id?: string;
@@ -4226,7 +3623,6 @@ export interface SpawnReapedPayload {
4226
3623
  task_id?: string;
4227
3624
  run_id?: string;
4228
3625
  workflow_id?: string;
4229
- resolved_network_participation?: NetworkParticipationSpec;
4230
3626
  soul_snapshot_id?: string;
4231
3627
  soul_digest?: string;
4232
3628
  parent_soul_digest?: string;
@@ -4239,6 +3635,7 @@ export interface SpawnReapedPayload {
4239
3635
  export interface SpawnTTLExpiredPayload {
4240
3636
  event: HookEvent;
4241
3637
  timestamp: ISODateTime;
3638
+ profile_id?: string;
4242
3639
  parent_session_id?: string;
4243
3640
  root_session_id?: string;
4244
3641
  child_session_id?: string;
@@ -4252,7 +3649,6 @@ export interface SpawnTTLExpiredPayload {
4252
3649
  task_id?: string;
4253
3650
  run_id?: string;
4254
3651
  workflow_id?: string;
4255
- resolved_network_participation?: NetworkParticipationSpec;
4256
3652
  soul_snapshot_id?: string;
4257
3653
  soul_digest?: string;
4258
3654
  parent_soul_digest?: string;
@@ -4262,6 +3658,47 @@ export interface SpawnTTLExpiredPayload {
4262
3658
  reap_reason?: string;
4263
3659
  error?: string;
4264
3660
  }
3661
+ export interface SubagentObservationPatch {
3662
+ labels?: Record<string, string>;
3663
+ }
3664
+ export interface SubagentPullRequestPayload {
3665
+ url: string;
3666
+ number: number;
3667
+ state: string;
3668
+ }
3669
+ export interface SubagentWorktreePayload {
3670
+ id: string;
3671
+ name: string;
3672
+ branch: string;
3673
+ base_ref: string;
3674
+ base_sha?: string;
3675
+ path: string;
3676
+ head_sha?: string;
3677
+ commits_ahead?: number;
3678
+ dirty_files?: number;
3679
+ observed_at?: ISODateTime;
3680
+ pull_request_status?: string;
3681
+ pull_request?: SubagentPullRequestPayload;
3682
+ }
3683
+ export interface SubagentRuntimePayload {
3684
+ provider: string;
3685
+ model: string;
3686
+ }
3687
+ export interface SubagentSettledPayload {
3688
+ event: HookEvent;
3689
+ timestamp: ISODateTime;
3690
+ isolation: string;
3691
+ worktree?: SubagentWorktreePayload;
3692
+ profile_id?: string;
3693
+ workspace_id: string;
3694
+ subagent_id: string;
3695
+ parent_session_id: string;
3696
+ child_session_id?: string;
3697
+ origin: string;
3698
+ status: string;
3699
+ runtime: SubagentRuntimePayload;
3700
+ duration_ms: number;
3701
+ }
4265
3702
  export type Priority = string;
4266
3703
  export type ApprovalPolicy = string;
4267
3704
  export type ApprovalState = string;
@@ -4283,13 +3720,25 @@ export interface Origin {
4283
3720
  kind: OriginKind;
4284
3721
  ref: string;
4285
3722
  }
3723
+ export type LoopProvenanceRole = "coordinator" | "cell";
3724
+ export interface LoopProvenance {
3725
+ run_id: string;
3726
+ loop_name?: string;
3727
+ role: LoopProvenanceRole;
3728
+ generation?: number;
3729
+ node_id?: string;
3730
+ item_index?: number;
3731
+ }
4286
3732
  export interface Task {
4287
3733
  id: string;
3734
+ profile_id: string;
3735
+ profile_name: string;
3736
+ profile_color?: string;
3737
+ profile_icon?: string;
4288
3738
  identifier?: string;
4289
3739
  scope: Scope;
4290
3740
  workspace_id?: string;
4291
3741
  parent_task_id?: string;
4292
- resolved_network_participation?: NetworkParticipationSpec;
4293
3742
  title: string;
4294
3743
  description?: string;
4295
3744
  priority?: Priority;
@@ -4320,15 +3769,16 @@ export interface Task {
4320
3769
  updated_at: ISODateTime;
4321
3770
  closed_at?: ISODateTime;
4322
3771
  metadata?: JSONValue;
3772
+ loop?: LoopProvenance;
4323
3773
  }
4324
3774
  export interface TaskBlockedPayload {
4325
3775
  event: HookEvent;
4326
3776
  timestamp: ISODateTime;
3777
+ profile_id?: string;
4327
3778
  task_id?: string;
4328
3779
  parent_task_id?: string;
4329
3780
  workspace_id?: string;
4330
3781
  workflow_id?: string;
4331
- resolved_network_participation?: NetworkParticipationSpec;
4332
3782
  agent_name?: string;
4333
3783
  actor_kind?: string;
4334
3784
  actor_id?: string;
@@ -4351,11 +3801,11 @@ export interface TaskCancelParams {
4351
3801
  metadata?: JSONValue;
4352
3802
  }
4353
3803
  export interface TaskContext {
3804
+ profile_id?: string;
4354
3805
  task_id?: string;
4355
3806
  parent_task_id?: string;
4356
3807
  workspace_id?: string;
4357
3808
  workflow_id?: string;
4358
- resolved_network_participation?: NetworkParticipationSpec;
4359
3809
  agent_name?: string;
4360
3810
  actor_kind?: string;
4361
3811
  actor_id?: string;
@@ -4371,7 +3821,6 @@ export interface TaskCreateParams {
4371
3821
  identifier?: string;
4372
3822
  scope: Scope;
4373
3823
  workspace?: string;
4374
- network_participation?: NetworkParticipationRequest;
4375
3824
  title: string;
4376
3825
  description?: string;
4377
3826
  priority?: Priority;
@@ -4447,7 +3896,6 @@ export interface TaskDashboardStatusBreakdownPayload {
4447
3896
  share_percent: number;
4448
3897
  }
4449
3898
  export interface TaskDashboardQueueDepthPayload {
4450
- channel_id?: string;
4451
3899
  count: number;
4452
3900
  oldest_queued_at: ISODateTime;
4453
3901
  oldest_queue_age_ms: number;
@@ -4482,7 +3930,6 @@ export interface TaskDashboardActiveRunPayload {
4482
3930
  attempt: number;
4483
3931
  max_attempts: number;
4484
3932
  session_id?: string;
4485
- resolved_network_participation?: NetworkParticipationSpec;
4486
3933
  last_activity_at: ISODateTime;
4487
3934
  age_ms: number;
4488
3935
  health_status: string;
@@ -4516,11 +3963,13 @@ export interface TaskDashboard {
4516
3963
  freshness: TaskDashboardFreshnessPayload;
4517
3964
  }
4518
3965
  export interface TaskDashboardParams {
3966
+ all_workspaces?: boolean;
3967
+ workspace_ids?: string[];
4519
3968
  scope?: Scope;
4520
3969
  workspace?: string;
3970
+ worktree?: string;
4521
3971
  owner_kind?: OwnerKind;
4522
3972
  owner_ref?: string;
4523
- participation_channel?: string;
4524
3973
  origin_kind?: OriginKind;
4525
3974
  }
4526
3975
  export type DependencyKind = string;
@@ -4545,18 +3994,7 @@ export interface TaskDependencyReferencePayload {
4545
3994
  created_at: ISODateTime;
4546
3995
  depends_on: TaskReferencePayload;
4547
3996
  }
4548
- export type CoordinationMessageKind = string;
4549
- export interface CoordinationChannelPayload {
4550
- id: string;
4551
- display_name: string;
4552
- purpose?: string;
4553
- workspace_id?: string;
4554
- task_id?: string;
4555
- run_id?: string;
4556
- workflow_id?: string;
4557
- allowed_message_kinds: CoordinationMessageKind[];
4558
- last_activity_at?: ISODateTime;
4559
- }
3997
+ export type ResolvedWorktreeMode = string;
4560
3998
  export interface RunDesignationSummary {
4561
3999
  index: number;
4562
4000
  brief?: string;
@@ -4571,12 +4009,13 @@ export interface TaskRunSummaryPayload {
4571
4009
  failure_kind?: string;
4572
4010
  max_attempts: number;
4573
4011
  session_id?: string;
4012
+ worktree_id?: string;
4013
+ resolved_worktree_mode: ResolvedWorktreeMode;
4014
+ resolved_worktree_ref?: string;
4574
4015
  claimed_by?: ActorIdentity;
4575
4016
  claim_token_hash?: string;
4576
4017
  lease_until?: ISODateTime;
4577
4018
  heartbeat_at?: ISODateTime;
4578
- resolved_network_participation?: NetworkParticipationSpec;
4579
- coordination_channel?: CoordinationChannelPayload;
4580
4019
  designation_group_id?: string;
4581
4020
  designation?: RunDesignationSummary;
4582
4021
  queued_at: ISODateTime;
@@ -4587,11 +4026,14 @@ export interface TaskRunSummaryPayload {
4587
4026
  }
4588
4027
  export interface TaskSummaryPayload {
4589
4028
  id: string;
4029
+ profile_id: string;
4030
+ profile_name: string;
4031
+ profile_color?: string;
4032
+ profile_icon?: string;
4590
4033
  identifier?: string;
4591
4034
  scope: Scope;
4592
4035
  workspace_id?: string;
4593
4036
  parent_task_id?: string;
4594
- resolved_network_participation?: NetworkParticipationSpec;
4595
4037
  title: string;
4596
4038
  priority?: Priority;
4597
4039
  max_attempts?: number;
@@ -4634,6 +4076,10 @@ export interface TaskDependencyPayload {
4634
4076
  }
4635
4077
  export interface TaskRun {
4636
4078
  id: string;
4079
+ profile_id?: string;
4080
+ profile_name?: string;
4081
+ profile_color?: string;
4082
+ profile_icon?: string;
4637
4083
  task_id: string;
4638
4084
  status: RunStatus;
4639
4085
  attempt: number;
@@ -4642,14 +4088,15 @@ export interface TaskRun {
4642
4088
  failure_kind?: string;
4643
4089
  claimed_by?: ActorIdentity;
4644
4090
  session_id?: string;
4091
+ worktree_id?: string;
4092
+ resolved_worktree_mode: ResolvedWorktreeMode;
4093
+ resolved_worktree_ref?: string;
4645
4094
  origin: Origin;
4646
4095
  idempotency_key?: string;
4647
- resolved_network_participation?: NetworkParticipationSpec;
4648
4096
  designation_group_id?: string;
4649
4097
  claim_token_hash?: string;
4650
4098
  lease_until?: ISODateTime;
4651
4099
  heartbeat_at?: ISODateTime;
4652
- coordination_channel?: CoordinationChannelPayload;
4653
4100
  designation?: RunDesignationSummary;
4654
4101
  queued_at: ISODateTime;
4655
4102
  claimed_at?: ISODateTime;
@@ -4658,6 +4105,8 @@ export interface TaskRun {
4658
4105
  error?: string;
4659
4106
  metadata?: JSONValue;
4660
4107
  result?: JSONValue;
4108
+ result_ref?: string;
4109
+ result_bytes?: number;
4661
4110
  }
4662
4111
  export interface TaskDesignationRollupPayload {
4663
4112
  designation_group_id: string;
@@ -4707,10 +4156,12 @@ export interface TaskCatalogRunPayload {
4707
4156
  failure_kind?: string;
4708
4157
  max_attempts: number;
4709
4158
  session_id?: string;
4159
+ worktree_id?: string;
4160
+ resolved_worktree_mode: ResolvedWorktreeMode;
4161
+ resolved_worktree_ref?: string;
4710
4162
  claimed_by?: ActorIdentity;
4711
4163
  lease_until?: ISODateTime;
4712
4164
  heartbeat_at?: ISODateTime;
4713
- resolved_network_participation?: NetworkParticipationSpec;
4714
4165
  queued_at: ISODateTime;
4715
4166
  claimed_at?: ISODateTime;
4716
4167
  started_at?: ISODateTime;
@@ -4765,6 +4216,8 @@ export type CatalogScope = string;
4765
4216
  export interface TaskInboxParams {
4766
4217
  scope?: CatalogScope;
4767
4218
  workspace?: string;
4219
+ workspace_ids?: string[];
4220
+ worktree?: string;
4768
4221
  owner_kind?: OwnerKind;
4769
4222
  owner_ref?: string;
4770
4223
  lane?: TaskInboxLane;
@@ -4778,11 +4231,11 @@ export interface TaskInboxParams {
4778
4231
  export interface TaskNeedsAttentionPayload {
4779
4232
  event: HookEvent;
4780
4233
  timestamp: ISODateTime;
4234
+ profile_id?: string;
4781
4235
  task_id?: string;
4782
4236
  parent_task_id?: string;
4783
4237
  workspace_id?: string;
4784
4238
  workflow_id?: string;
4785
- resolved_network_participation?: NetworkParticipationSpec;
4786
4239
  agent_name?: string;
4787
4240
  actor_kind?: string;
4788
4241
  actor_id?: string;
@@ -4802,11 +4255,11 @@ export interface TaskObservationPatch {
4802
4255
  export interface TaskRecoveredPayload {
4803
4256
  event: HookEvent;
4804
4257
  timestamp: ISODateTime;
4258
+ profile_id?: string;
4805
4259
  task_id?: string;
4806
4260
  parent_task_id?: string;
4807
4261
  workspace_id?: string;
4808
4262
  workflow_id?: string;
4809
- resolved_network_participation?: NetworkParticipationSpec;
4810
4263
  agent_name?: string;
4811
4264
  actor_kind?: string;
4812
4265
  actor_id?: string;
@@ -4847,6 +4300,7 @@ export interface TaskRunCompleteParams {
4847
4300
  export interface TaskRunCompletedPayload {
4848
4301
  event: HookEvent;
4849
4302
  timestamp: ISODateTime;
4303
+ profile_id?: string;
4850
4304
  task_id?: string;
4851
4305
  run_id?: string;
4852
4306
  run_kind?: string;
@@ -4856,7 +4310,6 @@ export interface TaskRunCompletedPayload {
4856
4310
  loop_run_id?: string;
4857
4311
  workspace_id?: string;
4858
4312
  workflow_id?: string;
4859
- resolved_network_participation?: NetworkParticipationSpec;
4860
4313
  agent_name?: string;
4861
4314
  session_id?: string;
4862
4315
  actor_kind?: string;
@@ -4877,6 +4330,7 @@ export interface TaskRunCompletedPayload {
4877
4330
  recovery_reason?: string;
4878
4331
  }
4879
4332
  export interface TaskRunContext {
4333
+ profile_id?: string;
4880
4334
  task_id?: string;
4881
4335
  run_id?: string;
4882
4336
  run_kind?: string;
@@ -4886,7 +4340,6 @@ export interface TaskRunContext {
4886
4340
  loop_run_id?: string;
4887
4341
  workspace_id?: string;
4888
4342
  workflow_id?: string;
4889
- resolved_network_participation?: NetworkParticipationSpec;
4890
4343
  agent_name?: string;
4891
4344
  session_id?: string;
4892
4345
  actor_kind?: string;
@@ -4926,33 +4379,21 @@ export interface TaskRunOperationalSummaryPayload {
4926
4379
  cost_status?: CostStatus;
4927
4380
  cost_source?: CostSource;
4928
4381
  }
4929
- export interface TaskRunConversationRefPayload {
4930
- workspace_id: string;
4931
- channel: string;
4932
- surface: string;
4933
- thread_id: string;
4934
- stream_url: string;
4935
- }
4936
- export interface TaskRunNetworkPayload {
4937
- conversation: TaskRunConversationRefPayload;
4938
- usage: NetworkUsageResponse;
4939
- }
4940
4382
  export interface TaskRunDetail {
4941
4383
  run: TaskRun;
4942
4384
  task?: TaskReferencePayload;
4943
4385
  session?: TaskRunSessionPayload;
4944
4386
  summary: TaskRunOperationalSummaryPayload;
4945
- network?: TaskRunNetworkPayload;
4946
4387
  }
4947
4388
  export interface TaskRunEnqueueParams {
4948
4389
  task_id: string;
4949
4390
  idempotency_key?: string;
4950
- network_participation?: NetworkParticipationRequest;
4951
4391
  metadata?: JSONValue;
4952
4392
  }
4953
4393
  export interface TaskRunEnqueuedPayload {
4954
4394
  event: HookEvent;
4955
4395
  timestamp: ISODateTime;
4396
+ profile_id?: string;
4956
4397
  task_id?: string;
4957
4398
  run_id?: string;
4958
4399
  run_kind?: string;
@@ -4962,7 +4403,6 @@ export interface TaskRunEnqueuedPayload {
4962
4403
  loop_run_id?: string;
4963
4404
  workspace_id?: string;
4964
4405
  workflow_id?: string;
4965
- resolved_network_participation?: NetworkParticipationSpec;
4966
4406
  agent_name?: string;
4967
4407
  session_id?: string;
4968
4408
  actor_kind?: string;
@@ -4987,6 +4427,7 @@ export interface TaskRunFailParams {
4987
4427
  export interface TaskRunFailedPayload {
4988
4428
  event: HookEvent;
4989
4429
  timestamp: ISODateTime;
4430
+ profile_id?: string;
4990
4431
  task_id?: string;
4991
4432
  run_id?: string;
4992
4433
  run_kind?: string;
@@ -4996,7 +4437,6 @@ export interface TaskRunFailedPayload {
4996
4437
  loop_run_id?: string;
4997
4438
  workspace_id?: string;
4998
4439
  workflow_id?: string;
4999
- resolved_network_participation?: NetworkParticipationSpec;
5000
4440
  agent_name?: string;
5001
4441
  session_id?: string;
5002
4442
  actor_kind?: string;
@@ -5022,6 +4462,7 @@ export interface TaskRunGetParams {
5022
4462
  export interface TaskRunLeaseExpiredPayload {
5023
4463
  event: HookEvent;
5024
4464
  timestamp: ISODateTime;
4465
+ profile_id?: string;
5025
4466
  task_id?: string;
5026
4467
  run_id?: string;
5027
4468
  run_kind?: string;
@@ -5031,7 +4472,6 @@ export interface TaskRunLeaseExpiredPayload {
5031
4472
  loop_run_id?: string;
5032
4473
  workspace_id?: string;
5033
4474
  workflow_id?: string;
5034
- resolved_network_participation?: NetworkParticipationSpec;
5035
4475
  agent_name?: string;
5036
4476
  session_id?: string;
5037
4477
  actor_kind?: string;
@@ -5054,6 +4494,7 @@ export interface TaskRunLeaseExpiredPayload {
5054
4494
  export interface TaskRunLeaseExtendedPayload {
5055
4495
  event: HookEvent;
5056
4496
  timestamp: ISODateTime;
4497
+ profile_id?: string;
5057
4498
  task_id?: string;
5058
4499
  run_id?: string;
5059
4500
  run_kind?: string;
@@ -5063,7 +4504,6 @@ export interface TaskRunLeaseExtendedPayload {
5063
4504
  loop_run_id?: string;
5064
4505
  workspace_id?: string;
5065
4506
  workflow_id?: string;
5066
- resolved_network_participation?: NetworkParticipationSpec;
5067
4507
  agent_name?: string;
5068
4508
  session_id?: string;
5069
4509
  actor_kind?: string;
@@ -5086,6 +4526,7 @@ export interface TaskRunLeaseExtendedPayload {
5086
4526
  export interface TaskRunLeasePayload {
5087
4527
  event: HookEvent;
5088
4528
  timestamp: ISODateTime;
4529
+ profile_id?: string;
5089
4530
  task_id?: string;
5090
4531
  run_id?: string;
5091
4532
  run_kind?: string;
@@ -5095,7 +4536,6 @@ export interface TaskRunLeasePayload {
5095
4536
  loop_run_id?: string;
5096
4537
  workspace_id?: string;
5097
4538
  workflow_id?: string;
5098
- resolved_network_participation?: NetworkParticipationSpec;
5099
4539
  agent_name?: string;
5100
4540
  session_id?: string;
5101
4541
  actor_kind?: string;
@@ -5118,6 +4558,7 @@ export interface TaskRunLeasePayload {
5118
4558
  export interface TaskRunLeaseRecoveredPayload {
5119
4559
  event: HookEvent;
5120
4560
  timestamp: ISODateTime;
4561
+ profile_id?: string;
5121
4562
  task_id?: string;
5122
4563
  run_id?: string;
5123
4564
  run_kind?: string;
@@ -5127,7 +4568,6 @@ export interface TaskRunLeaseRecoveredPayload {
5127
4568
  loop_run_id?: string;
5128
4569
  workspace_id?: string;
5129
4570
  workflow_id?: string;
5130
- resolved_network_participation?: NetworkParticipationSpec;
5131
4571
  agent_name?: string;
5132
4572
  session_id?: string;
5133
4573
  actor_kind?: string;
@@ -5153,6 +4593,7 @@ export interface TaskRunObservationPatch {
5153
4593
  export interface TaskRunPostClaimPayload {
5154
4594
  event: HookEvent;
5155
4595
  timestamp: ISODateTime;
4596
+ profile_id?: string;
5156
4597
  task_id?: string;
5157
4598
  run_id?: string;
5158
4599
  run_kind?: string;
@@ -5162,7 +4603,6 @@ export interface TaskRunPostClaimPayload {
5162
4603
  loop_run_id?: string;
5163
4604
  workspace_id?: string;
5164
4605
  workflow_id?: string;
5165
- resolved_network_participation?: NetworkParticipationSpec;
5166
4606
  agent_name?: string;
5167
4607
  session_id?: string;
5168
4608
  actor_kind?: string;
@@ -5188,6 +4628,7 @@ export interface TaskRunPreClaimPatch {
5188
4628
  export interface TaskRunPreClaimPayload {
5189
4629
  event: HookEvent;
5190
4630
  timestamp: ISODateTime;
4631
+ profile_id?: string;
5191
4632
  task_id?: string;
5192
4633
  run_id?: string;
5193
4634
  run_kind?: string;
@@ -5197,7 +4638,6 @@ export interface TaskRunPreClaimPayload {
5197
4638
  loop_run_id?: string;
5198
4639
  workspace_id?: string;
5199
4640
  workflow_id?: string;
5200
- resolved_network_participation?: NetworkParticipationSpec;
5201
4641
  agent_name?: string;
5202
4642
  session_id?: string;
5203
4643
  actor_kind?: string;
@@ -5219,6 +4659,7 @@ export interface TaskRunPreClaimPayload {
5219
4659
  export interface TaskRunReleasedPayload {
5220
4660
  event: HookEvent;
5221
4661
  timestamp: ISODateTime;
4662
+ profile_id?: string;
5222
4663
  task_id?: string;
5223
4664
  run_id?: string;
5224
4665
  run_kind?: string;
@@ -5228,7 +4669,6 @@ export interface TaskRunReleasedPayload {
5228
4669
  loop_run_id?: string;
5229
4670
  workspace_id?: string;
5230
4671
  workflow_id?: string;
5231
- resolved_network_participation?: NetworkParticipationSpec;
5232
4672
  agent_name?: string;
5233
4673
  session_id?: string;
5234
4674
  actor_kind?: string;
@@ -5248,6 +4688,21 @@ export interface TaskRunReleasedPayload {
5248
4688
  recovery_action?: string;
5249
4689
  recovery_reason?: string;
5250
4690
  }
4691
+ export interface TaskRunResultPage {
4692
+ run_id: string;
4693
+ result_ref?: string;
4694
+ offset: number;
4695
+ bytes: number;
4696
+ total_bytes: number;
4697
+ data_base64: string;
4698
+ next_offset?: number;
4699
+ eof: boolean;
4700
+ }
4701
+ export interface TaskRunResultParams {
4702
+ id: string;
4703
+ offset?: number;
4704
+ limit?: number;
4705
+ }
5251
4706
  export interface TaskRunStartParams {
5252
4707
  id: string;
5253
4708
  idempotency_key?: string;
@@ -5256,17 +4711,16 @@ export interface TaskRunsParams {
5256
4711
  id: string;
5257
4712
  status?: RunStatus;
5258
4713
  session_id?: string;
5259
- participation_channel?: string;
5260
4714
  limit?: number;
5261
4715
  }
5262
4716
  export interface TaskStatusChangedPayload {
5263
4717
  event: HookEvent;
5264
4718
  timestamp: ISODateTime;
4719
+ profile_id?: string;
5265
4720
  task_id?: string;
5266
4721
  parent_task_id?: string;
5267
4722
  workspace_id?: string;
5268
4723
  workflow_id?: string;
5269
- resolved_network_participation?: NetworkParticipationSpec;
5270
4724
  agent_name?: string;
5271
4725
  actor_kind?: string;
5272
4726
  actor_id?: string;
@@ -5288,6 +4742,7 @@ export interface TaskTimelineItem {
5288
4742
  task: TaskReferencePayload;
5289
4743
  run?: TaskRunSummaryPayload;
5290
4744
  event_type: string;
4745
+ reason?: string;
5291
4746
  actor: ActorIdentity;
5292
4747
  origin: Origin;
5293
4748
  payload?: JSONValue;
@@ -5316,11 +4771,11 @@ export interface TaskTreeParams {
5316
4771
  export interface TaskUnblockedPayload {
5317
4772
  event: HookEvent;
5318
4773
  timestamp: ISODateTime;
4774
+ profile_id?: string;
5319
4775
  task_id?: string;
5320
4776
  parent_task_id?: string;
5321
4777
  workspace_id?: string;
5322
4778
  workflow_id?: string;
5323
- resolved_network_participation?: NetworkParticipationSpec;
5324
4779
  agent_name?: string;
5325
4780
  actor_kind?: string;
5326
4781
  actor_id?: string;
@@ -5346,22 +4801,25 @@ export interface TaskUpdateParams {
5346
4801
  auto_enqueue_on_ready?: boolean;
5347
4802
  approval_policy?: ApprovalPolicy;
5348
4803
  metadata?: JSONValue;
5349
- network_participation?: NetworkParticipationRequest;
5350
4804
  owner?: Ownership;
5351
4805
  clear_owner?: boolean;
5352
4806
  }
5353
4807
  export type CatalogSort = string;
5354
4808
  export interface TasksParams {
4809
+ all_workspaces?: boolean;
4810
+ workspace_ids?: string[];
5355
4811
  scope?: CatalogScope;
5356
4812
  workspace?: string;
5357
4813
  status?: Status;
5358
4814
  priority?: Priority;
5359
4815
  include_drafts?: boolean;
4816
+ include_loop?: boolean;
4817
+ loop_run_id?: string;
5360
4818
  approval_state?: ApprovalState;
5361
4819
  owner_kind?: OwnerKind;
5362
4820
  owner_ref?: string;
5363
4821
  parent_task_id?: string;
5364
- participation_channel?: string;
4822
+ worktree?: string;
5365
4823
  query?: string;
5366
4824
  sort?: CatalogSort;
5367
4825
  cursor?: string;
@@ -5369,11 +4827,14 @@ export interface TasksParams {
5369
4827
  }
5370
4828
  export interface TaskCatalogItemPayload {
5371
4829
  id: string;
4830
+ profile_id: string;
4831
+ profile_name: string;
4832
+ profile_color?: string;
4833
+ profile_icon?: string;
5372
4834
  identifier?: string;
5373
4835
  scope: Scope;
5374
4836
  workspace_id?: string;
5375
4837
  parent_task_id?: string;
5376
- resolved_network_participation?: NetworkParticipationSpec;
5377
4838
  title: string;
5378
4839
  priority?: Priority;
5379
4840
  max_attempts?: number;
@@ -5399,6 +4860,7 @@ export interface TaskCatalogItemPayload {
5399
4860
  dependency_count?: number;
5400
4861
  active_run?: TaskCatalogRunPayload;
5401
4862
  last_activity_at?: ISODateTime;
4863
+ loop?: LoopProvenance;
5402
4864
  }
5403
4865
  export interface TaskCatalogStatusFacetPayload {
5404
4866
  status: Status;
@@ -5417,6 +4879,176 @@ export interface TasksResponse {
5417
4879
  page: CountedCursorPagePayload;
5418
4880
  facets: TaskCatalogFacetsPayload;
5419
4881
  }
4882
+ export interface TerminalExit {
4883
+ cause: string;
4884
+ code?: number;
4885
+ signal?: string;
4886
+ }
4887
+ export interface TerminalClosedPayload {
4888
+ event: HookEvent;
4889
+ timestamp: ISODateTime;
4890
+ workspace_id: string;
4891
+ profile_id: string;
4892
+ terminal_id?: string;
4893
+ actor_kind: string;
4894
+ actor_id: string;
4895
+ session_id?: string;
4896
+ run_id?: string;
4897
+ generation?: number;
4898
+ at: ISODateTime;
4899
+ exit: TerminalExit;
4900
+ reason: string;
4901
+ }
4902
+ export interface TerminalCommandFinishedPayload {
4903
+ event: HookEvent;
4904
+ timestamp: ISODateTime;
4905
+ workspace_id: string;
4906
+ profile_id: string;
4907
+ terminal_id?: string;
4908
+ actor_kind: string;
4909
+ actor_id: string;
4910
+ session_id?: string;
4911
+ run_id?: string;
4912
+ generation?: number;
4913
+ at: ISODateTime;
4914
+ command_id: string;
4915
+ exit_code?: number;
4916
+ signal?: string;
4917
+ exit_cause: string;
4918
+ duration_ms: number;
4919
+ detected_by: string;
4920
+ approval: string;
4921
+ }
4922
+ export interface TerminalCommandStartedPayload {
4923
+ event: HookEvent;
4924
+ timestamp: ISODateTime;
4925
+ workspace_id: string;
4926
+ profile_id: string;
4927
+ terminal_id?: string;
4928
+ actor_kind: string;
4929
+ actor_id: string;
4930
+ session_id?: string;
4931
+ run_id?: string;
4932
+ generation?: number;
4933
+ at: ISODateTime;
4934
+ command_id: string;
4935
+ command: string;
4936
+ cwd: string;
4937
+ detected_by: string;
4938
+ }
4939
+ export interface TerminalInputProvidedPayload {
4940
+ event: HookEvent;
4941
+ timestamp: ISODateTime;
4942
+ workspace_id: string;
4943
+ profile_id: string;
4944
+ terminal_id?: string;
4945
+ actor_kind: string;
4946
+ actor_id: string;
4947
+ session_id?: string;
4948
+ run_id?: string;
4949
+ generation?: number;
4950
+ at: ISODateTime;
4951
+ request_id: string;
4952
+ redacted: boolean;
4953
+ length: number;
4954
+ outcome: string;
4955
+ }
4956
+ export interface TerminalInputRequestedPayload {
4957
+ event: HookEvent;
4958
+ timestamp: ISODateTime;
4959
+ workspace_id: string;
4960
+ profile_id: string;
4961
+ terminal_id?: string;
4962
+ actor_kind: string;
4963
+ actor_id: string;
4964
+ session_id?: string;
4965
+ run_id?: string;
4966
+ generation?: number;
4967
+ at: ISODateTime;
4968
+ request_id: string;
4969
+ reason: string;
4970
+ redacted: boolean;
4971
+ }
4972
+ export interface TerminalLimitRejectedPayload {
4973
+ event: HookEvent;
4974
+ timestamp: ISODateTime;
4975
+ workspace_id: string;
4976
+ profile_id: string;
4977
+ terminal_id?: string;
4978
+ actor_kind: string;
4979
+ actor_id: string;
4980
+ session_id?: string;
4981
+ run_id?: string;
4982
+ generation?: number;
4983
+ at: ISODateTime;
4984
+ limit: string;
4985
+ current: number;
4986
+ max: number;
4987
+ }
4988
+ export type TerminalObservationPatch = Record<string, never>;
4989
+ export interface TerminalOpenedPayload {
4990
+ event: HookEvent;
4991
+ timestamp: ISODateTime;
4992
+ workspace_id: string;
4993
+ profile_id: string;
4994
+ terminal_id?: string;
4995
+ actor_kind: string;
4996
+ actor_id: string;
4997
+ session_id?: string;
4998
+ run_id?: string;
4999
+ generation?: number;
5000
+ at: ISODateTime;
5001
+ mode: string;
5002
+ cwd: string;
5003
+ title?: string;
5004
+ }
5005
+ export interface TerminalRecordingStartedPayload {
5006
+ event: HookEvent;
5007
+ timestamp: ISODateTime;
5008
+ workspace_id: string;
5009
+ profile_id: string;
5010
+ terminal_id?: string;
5011
+ actor_kind: string;
5012
+ actor_id: string;
5013
+ session_id?: string;
5014
+ run_id?: string;
5015
+ generation?: number;
5016
+ at: ISODateTime;
5017
+ recording_id: string;
5018
+ }
5019
+ export interface TerminalRecordingStoppedPayload {
5020
+ event: HookEvent;
5021
+ timestamp: ISODateTime;
5022
+ workspace_id: string;
5023
+ profile_id: string;
5024
+ terminal_id?: string;
5025
+ actor_kind: string;
5026
+ actor_id: string;
5027
+ session_id?: string;
5028
+ run_id?: string;
5029
+ generation?: number;
5030
+ at: ISODateTime;
5031
+ recording_id: string;
5032
+ digest: string;
5033
+ bytes: number;
5034
+ reason: string;
5035
+ truncated: boolean;
5036
+ }
5037
+ export interface TerminalSubscriberEvictedPayload {
5038
+ event: HookEvent;
5039
+ timestamp: ISODateTime;
5040
+ workspace_id: string;
5041
+ profile_id: string;
5042
+ terminal_id?: string;
5043
+ actor_kind: string;
5044
+ actor_id: string;
5045
+ session_id?: string;
5046
+ run_id?: string;
5047
+ generation?: number;
5048
+ at: ISODateTime;
5049
+ flow: string;
5050
+ reason: string;
5051
+ }
5420
5052
  export type BackendKind = string;
5421
5053
  export interface BackendRef {
5422
5054
  kind: BackendKind;
@@ -5427,6 +5059,7 @@ export interface BackendRef {
5427
5059
  native_name?: string;
5428
5060
  requires_capabilities?: string[];
5429
5061
  }
5062
+ export type ErrorCode = string;
5430
5063
  export type SourceKind = "builtin" | "mcp" | "extension" | "dynamic";
5431
5064
  export interface SourceRef {
5432
5065
  kind: SourceKind;
@@ -5435,6 +5068,7 @@ export interface SourceRef {
5435
5068
  raw_tool_name?: string;
5436
5069
  resource_id?: string;
5437
5070
  resource_version?: string;
5071
+ profile_id?: string;
5438
5072
  workspace_id?: string;
5439
5073
  scope?: string;
5440
5074
  }
@@ -5446,6 +5080,10 @@ export interface Tool {
5446
5080
  display_title?: string;
5447
5081
  friendly_verb?: string;
5448
5082
  preview?: string;
5083
+ reserved_workspace_partition?: boolean;
5084
+ max_result_bytes?: number;
5085
+ idempotent?: boolean;
5086
+ input_error_code?: ErrorCode;
5449
5087
  description: string;
5450
5088
  input_schema: JSONValue;
5451
5089
  output_schema?: JSONValue;
@@ -5459,7 +5097,6 @@ export interface Tool {
5459
5097
  open_world: boolean;
5460
5098
  requires_interaction: boolean;
5461
5099
  concurrency_safe: boolean;
5462
- max_result_bytes?: number;
5463
5100
  toolsets?: ToolsetID[];
5464
5101
  tags?: string[];
5465
5102
  search_hints?: string[];
@@ -5479,12 +5116,14 @@ export interface ToolCallRef {
5479
5116
  export interface ToolPostCallPayload {
5480
5117
  event: HookEvent;
5481
5118
  timestamp: ISODateTime;
5119
+ profile_id?: string;
5482
5120
  session_id?: string;
5483
5121
  session_name?: string;
5484
5122
  session_type?: string;
5485
5123
  agent_name?: string;
5486
5124
  workspace_id?: string;
5487
5125
  workspace?: string;
5126
+ worktree_id?: string;
5488
5127
  acp_session_id?: string;
5489
5128
  state?: string;
5490
5129
  soul_snapshot_id?: string;
@@ -5509,12 +5148,14 @@ export interface ToolPostErrorPatch {
5509
5148
  export interface ToolPostErrorPayload {
5510
5149
  event: HookEvent;
5511
5150
  timestamp: ISODateTime;
5151
+ profile_id?: string;
5512
5152
  session_id?: string;
5513
5153
  session_name?: string;
5514
5154
  session_type?: string;
5515
5155
  agent_name?: string;
5516
5156
  workspace_id?: string;
5517
5157
  workspace?: string;
5158
+ worktree_id?: string;
5518
5159
  acp_session_id?: string;
5519
5160
  state?: string;
5520
5161
  soul_snapshot_id?: string;
@@ -5532,12 +5173,14 @@ export interface ToolPostErrorPayload {
5532
5173
  export interface ToolPreCallPayload {
5533
5174
  event: HookEvent;
5534
5175
  timestamp: ISODateTime;
5176
+ profile_id?: string;
5535
5177
  session_id?: string;
5536
5178
  session_name?: string;
5537
5179
  session_type?: string;
5538
5180
  agent_name?: string;
5539
5181
  workspace_id?: string;
5540
5182
  workspace?: string;
5183
+ worktree_id?: string;
5541
5184
  acp_session_id?: string;
5542
5185
  state?: string;
5543
5186
  soul_snapshot_id?: string;
@@ -5572,12 +5215,14 @@ export interface TurnEndPatch {
5572
5215
  export interface TurnEndPayload {
5573
5216
  event: HookEvent;
5574
5217
  timestamp: ISODateTime;
5218
+ profile_id?: string;
5575
5219
  session_id?: string;
5576
5220
  session_name?: string;
5577
5221
  session_type?: string;
5578
5222
  agent_name?: string;
5579
5223
  workspace_id?: string;
5580
5224
  workspace?: string;
5225
+ worktree_id?: string;
5581
5226
  acp_session_id?: string;
5582
5227
  state?: string;
5583
5228
  soul_snapshot_id?: string;
@@ -5596,12 +5241,14 @@ export interface TurnPatch {
5596
5241
  export interface TurnPayload {
5597
5242
  event: HookEvent;
5598
5243
  timestamp: ISODateTime;
5244
+ profile_id?: string;
5599
5245
  session_id?: string;
5600
5246
  session_name?: string;
5601
5247
  session_type?: string;
5602
5248
  agent_name?: string;
5603
5249
  workspace_id?: string;
5604
5250
  workspace?: string;
5251
+ worktree_id?: string;
5605
5252
  acp_session_id?: string;
5606
5253
  state?: string;
5607
5254
  soul_snapshot_id?: string;
@@ -5620,12 +5267,14 @@ export interface TurnStartPatch {
5620
5267
  export interface TurnStartPayload {
5621
5268
  event: HookEvent;
5622
5269
  timestamp: ISODateTime;
5270
+ profile_id?: string;
5623
5271
  session_id?: string;
5624
5272
  session_name?: string;
5625
5273
  session_type?: string;
5626
5274
  agent_name?: string;
5627
5275
  workspace_id?: string;
5628
5276
  workspace?: string;
5277
+ worktree_id?: string;
5629
5278
  acp_session_id?: string;
5630
5279
  state?: string;
5631
5280
  soul_snapshot_id?: string;
@@ -5636,6 +5285,228 @@ export interface TurnStartPayload {
5636
5285
  input_class?: string;
5637
5286
  user_message?: string;
5638
5287
  }
5288
+ export type ProfileLensID = string;
5289
+ export interface ProfileLens {
5290
+ profile_lens_id: ProfileLensID;
5291
+ profile_name: string;
5292
+ }
5293
+ export interface ViewCloseRequest {
5294
+ view_session: string;
5295
+ profile_lens: ProfileLens;
5296
+ reason?: string;
5297
+ }
5298
+ export interface ViewEvent {
5299
+ view_session: string;
5300
+ handler: string;
5301
+ args?: JSONValue[];
5302
+ revision: string;
5303
+ seq: number;
5304
+ generation: number;
5305
+ ack_effects?: string[];
5306
+ effect_result?: EffectResult;
5307
+ }
5308
+ export interface Pagination {
5309
+ has_more: boolean;
5310
+ page_size?: number;
5311
+ }
5312
+ export interface ViewChrome {
5313
+ is_loading?: boolean;
5314
+ search_text?: string;
5315
+ event_count?: number;
5316
+ search_placeholder?: string;
5317
+ throttle_ms?: number;
5318
+ filtering?: boolean;
5319
+ complete?: boolean;
5320
+ active_chip?: string;
5321
+ columns?: number;
5322
+ pagination?: Pagination;
5323
+ on_search?: string;
5324
+ on_chip?: string;
5325
+ on_selection?: string;
5326
+ on_load_more?: string;
5327
+ }
5328
+ export interface ViewBadge {
5329
+ label: string;
5330
+ tone: string;
5331
+ }
5332
+ export interface MetaField {
5333
+ label: string;
5334
+ value: string;
5335
+ requires?: Record<string, string>;
5336
+ fallback?: string;
5337
+ }
5338
+ export interface Confirmation {
5339
+ title: string;
5340
+ body?: string;
5341
+ confirm: string;
5342
+ }
5343
+ export type ActionKind = string;
5344
+ export interface Action {
5345
+ kind: ActionKind;
5346
+ op?: string;
5347
+ tool?: string;
5348
+ view?: string;
5349
+ app?: string;
5350
+ url?: string;
5351
+ args?: Record<string, JSONValue>;
5352
+ }
5353
+ export interface RowAction {
5354
+ title: string;
5355
+ icon?: string;
5356
+ section?: string;
5357
+ primary?: boolean;
5358
+ destructive?: boolean;
5359
+ confirmation?: Confirmation;
5360
+ shortcut?: string;
5361
+ action?: Action;
5362
+ handler?: string;
5363
+ submit_form?: boolean;
5364
+ requires?: Record<string, string>;
5365
+ fallback?: string;
5366
+ }
5367
+ export interface DetailBody {
5368
+ is_loading?: boolean;
5369
+ markdown?: string;
5370
+ metadata?: MetaField[];
5371
+ actions?: RowAction[];
5372
+ }
5373
+ export interface Row {
5374
+ id: string;
5375
+ title: string;
5376
+ subtitle?: string;
5377
+ icon?: string;
5378
+ badge?: ViewBadge;
5379
+ keywords?: string[];
5380
+ accessories?: string[];
5381
+ detail?: DetailBody;
5382
+ actions?: RowAction[];
5383
+ requires?: Record<string, string>;
5384
+ fallback?: string;
5385
+ }
5386
+ export interface Section {
5387
+ title?: string;
5388
+ rows: Row[];
5389
+ }
5390
+ export interface Chip {
5391
+ id: string;
5392
+ label: string;
5393
+ count?: number;
5394
+ requires?: Record<string, string>;
5395
+ fallback?: string;
5396
+ }
5397
+ export interface EmptyState {
5398
+ title: string;
5399
+ hint?: string;
5400
+ icon?: string;
5401
+ }
5402
+ export interface FormField {
5403
+ id: string;
5404
+ type: string;
5405
+ label: string;
5406
+ placeholder?: string;
5407
+ required?: boolean;
5408
+ options?: string[];
5409
+ directories?: boolean;
5410
+ default?: JSONValue;
5411
+ error?: string;
5412
+ empty_hint?: string;
5413
+ on_change?: string;
5414
+ on_blur?: string;
5415
+ event_count?: number;
5416
+ requires?: Record<string, string>;
5417
+ fallback?: string;
5418
+ }
5419
+ export interface FormBody {
5420
+ fields: FormField[];
5421
+ submit?: RowAction;
5422
+ on_submit?: string;
5423
+ }
5424
+ export interface Image {
5425
+ url?: string;
5426
+ token?: string;
5427
+ emoji?: string;
5428
+ }
5429
+ export interface GridTile {
5430
+ id: string;
5431
+ title: string;
5432
+ image: Image;
5433
+ badge?: ViewBadge;
5434
+ actions?: RowAction[];
5435
+ requires?: Record<string, string>;
5436
+ fallback?: string;
5437
+ }
5438
+ export interface GridSection {
5439
+ title?: string;
5440
+ tiles: GridTile[];
5441
+ }
5442
+ export interface GridBody {
5443
+ sections: GridSection[];
5444
+ }
5445
+ export interface ViewPayload {
5446
+ view: string;
5447
+ chrome?: ViewChrome;
5448
+ sections?: Section[];
5449
+ chips?: Chip[];
5450
+ empty?: EmptyState;
5451
+ detail?: DetailBody;
5452
+ form?: FormBody;
5453
+ grid?: GridBody;
5454
+ }
5455
+ export interface PatchOp {
5456
+ op: string;
5457
+ path: string;
5458
+ value?: JSONValue;
5459
+ }
5460
+ export interface ViewPatch {
5461
+ view_id: string;
5462
+ from: string;
5463
+ to: string;
5464
+ ops: PatchOp[];
5465
+ }
5466
+ export interface ToastEffect {
5467
+ tone: string;
5468
+ message: string;
5469
+ }
5470
+ export interface CopyEffect {
5471
+ content: string;
5472
+ }
5473
+ export interface OpenURLEffect {
5474
+ url: string;
5475
+ }
5476
+ export interface OpenAppEffect {
5477
+ app: string;
5478
+ }
5479
+ export interface PickFilesEffect {
5480
+ directories?: boolean;
5481
+ }
5482
+ export interface Effect {
5483
+ id: string;
5484
+ toast?: ToastEffect;
5485
+ copy?: CopyEffect;
5486
+ open_url?: OpenURLEffect;
5487
+ open_app?: OpenAppEffect;
5488
+ pick_files?: PickFilesEffect;
5489
+ }
5490
+ export interface ViewFrame {
5491
+ view_session: string;
5492
+ revision: string;
5493
+ in_reply_to?: number;
5494
+ generation: number;
5495
+ payload?: ViewPayload;
5496
+ patch?: ViewPatch;
5497
+ effects?: Effect[];
5498
+ handlers: string[];
5499
+ }
5500
+ export type WorkspaceID = string;
5501
+ export type ClientID = string;
5502
+ export interface ViewOpenRequest {
5503
+ view_session: string;
5504
+ view: string;
5505
+ profile_lens: ProfileLens;
5506
+ workspace: WorkspaceID;
5507
+ client: ClientID;
5508
+ args?: Record<string, JSONValue>;
5509
+ }
5639
5510
  export interface WindowManagerChanges {
5640
5511
  desktop_ids?: string[];
5641
5512
  window_ids?: string[];
@@ -5740,7 +5611,68 @@ export interface WindowManagerWindowOpenedPayload {
5740
5611
  actor: WindowManagerActor;
5741
5612
  origin?: string;
5742
5613
  }
5614
+ export interface WorktreeControlPatch {
5615
+ deny?: boolean;
5616
+ deny_reason?: string;
5617
+ }
5618
+ export type WorktreeObservationPatch = Record<string, never>;
5619
+ export interface WorktreeObservationPayload {
5620
+ event: HookEvent;
5621
+ timestamp: ISODateTime;
5622
+ profile_id?: string;
5623
+ worktree_id: string;
5624
+ workspace_id: string;
5625
+ workspace_root?: string;
5626
+ name: string;
5627
+ branch: string;
5628
+ path: string;
5629
+ origin: string;
5630
+ run_id?: string;
5631
+ }
5632
+ export interface WorktreePreCreatePayload {
5633
+ event: HookEvent;
5634
+ timestamp: ISODateTime;
5635
+ profile_id?: string;
5636
+ worktree_id: string;
5637
+ workspace_id: string;
5638
+ workspace_root?: string;
5639
+ name: string;
5640
+ branch: string;
5641
+ path: string;
5642
+ origin: string;
5643
+ run_id?: string;
5644
+ denied?: boolean;
5645
+ deny_reason?: string;
5646
+ }
5647
+ export interface WorktreeContext {
5648
+ profile_id?: string;
5649
+ worktree_id: string;
5650
+ workspace_id: string;
5651
+ workspace_root?: string;
5652
+ name: string;
5653
+ branch: string;
5654
+ path: string;
5655
+ origin: string;
5656
+ run_id?: string;
5657
+ }
5658
+ export interface WorktreeRisk {
5659
+ changed_files: number;
5660
+ insertions: number;
5661
+ deletions: number;
5662
+ unpushed_commits: number;
5663
+ exists_on_remote: boolean;
5664
+ }
5665
+ export interface WorktreePreRemovePayload {
5666
+ event: HookEvent;
5667
+ timestamp: ISODateTime;
5668
+ worktree: WorktreeContext;
5669
+ force: boolean;
5670
+ risk: WorktreeRisk;
5671
+ denied?: boolean;
5672
+ deny_reason?: string;
5673
+ }
5743
5674
  export interface HookPayloadByEvent {
5675
+ "subagent.settled": SubagentSettledPayload;
5744
5676
  "session.pre_create": SessionPreCreatePayload;
5745
5677
  "session.post_create": SessionPostCreatePayload;
5746
5678
  "session.pre_resume": SessionPreResumePayload;
@@ -5748,11 +5680,9 @@ export interface HookPayloadByEvent {
5748
5680
  "session.pre_stop": SessionPreStopPayload;
5749
5681
  "session.post_stop": SessionPostStopPayload;
5750
5682
  "session.message_persisted": SessionMessagePersistedPayload;
5751
- "sandbox.prepare": SandboxPreparePayload;
5752
- "sandbox.ready": SandboxReadyPayload;
5753
- "sandbox.sync.before": SandboxSyncBeforePayload;
5754
- "sandbox.sync.after": SandboxSyncAfterPayload;
5755
- "sandbox.stop": SandboxStopPayload;
5683
+ "session.runtime_recovery.started": SessionRuntimeRecoveryStartedPayload;
5684
+ "session.runtime_recovery.succeeded": SessionRuntimeRecoverySucceededPayload;
5685
+ "session.runtime_recovery.exhausted": SessionRuntimeRecoveryExhaustedPayload;
5756
5686
  "input.pre_submit": InputPreSubmitPayload;
5757
5687
  "prompt.post_assemble": PromptPayload;
5758
5688
  "event.pre_record": EventPreRecordPayload;
@@ -5817,16 +5747,7 @@ export interface HookPayloadByEvent {
5817
5747
  "spawn.parent_stopped": SpawnParentStoppedPayload;
5818
5748
  "spawn.ttl_expired": SpawnTTLExpiredPayload;
5819
5749
  "spawn.reaped": SpawnReapedPayload;
5820
- "network.thread.opened": NetworkThreadOpenedPayload;
5821
- "network.direct_room.opened": NetworkDirectRoomOpenedPayload;
5822
- "network.message.persisted": NetworkMessagePersistedPayload;
5823
- "network.work.opened": NetworkWorkOpenedPayload;
5824
- "network.work.transitioned": NetworkWorkTransitionedPayload;
5825
- "network.work.closed": NetworkWorkClosedPayload;
5826
- "network.peer.joined": NetworkPeerJoinedPayload;
5827
- "network.peer.left": NetworkPeerLeftPayload;
5828
- "network.participation.pre_resolve": NetworkParticipationPreResolvePayload;
5829
- "network.participation.resolved": NetworkParticipationResolvedPayload;
5750
+ "session.attention.changed": SessionAttentionChangedPayload;
5830
5751
  "window_manager.layout.applied": WindowManagerLayoutAppliedPayload;
5831
5752
  "window_manager.desktop.created": WindowManagerDesktopCreatedPayload;
5832
5753
  "window_manager.desktop.deleted": WindowManagerDesktopDeletedPayload;
@@ -5836,8 +5757,24 @@ export interface HookPayloadByEvent {
5836
5757
  "window_manager.stack.grouped": WindowManagerStackGroupedPayload;
5837
5758
  "window_manager.stack.ungrouped": WindowManagerStackUngroupedPayload;
5838
5759
  "window_manager.stack.activated": WindowManagerStackActivatedPayload;
5760
+ "worktree.pre_create": WorktreePreCreatePayload;
5761
+ "worktree.pre_remove": WorktreePreRemovePayload;
5762
+ "worktree.created": WorktreeObservationPayload;
5763
+ "worktree.adopted": WorktreeObservationPayload;
5764
+ "worktree.removed": WorktreeObservationPayload;
5765
+ "terminal.opened": TerminalOpenedPayload;
5766
+ "terminal.closed": TerminalClosedPayload;
5767
+ "terminal.command_started": TerminalCommandStartedPayload;
5768
+ "terminal.command_finished": TerminalCommandFinishedPayload;
5769
+ "terminal.input_requested": TerminalInputRequestedPayload;
5770
+ "terminal.input_provided": TerminalInputProvidedPayload;
5771
+ "terminal.recording_started": TerminalRecordingStartedPayload;
5772
+ "terminal.recording_stopped": TerminalRecordingStoppedPayload;
5773
+ "terminal.subscriber_evicted": TerminalSubscriberEvictedPayload;
5774
+ "terminal.limit_rejected": TerminalLimitRejectedPayload;
5839
5775
  }
5840
5776
  export interface HookPatchByEvent {
5777
+ "subagent.settled": SubagentObservationPatch;
5841
5778
  "session.pre_create": SessionCreatePatch;
5842
5779
  "session.post_create": SessionPostCreatePatch;
5843
5780
  "session.pre_resume": SessionPreResumePatch;
@@ -5845,11 +5782,9 @@ export interface HookPatchByEvent {
5845
5782
  "session.pre_stop": SessionPreStopPatch;
5846
5783
  "session.post_stop": SessionPostStopPatch;
5847
5784
  "session.message_persisted": AuthoredContextObservationPatch;
5848
- "sandbox.prepare": SandboxPreparePatch;
5849
- "sandbox.ready": SandboxReadyPatch;
5850
- "sandbox.sync.before": SandboxSyncBeforePatch;
5851
- "sandbox.sync.after": SandboxSyncAfterPatch;
5852
- "sandbox.stop": SandboxStopPatch;
5785
+ "session.runtime_recovery.started": AuthoredContextObservationPatch;
5786
+ "session.runtime_recovery.succeeded": AuthoredContextObservationPatch;
5787
+ "session.runtime_recovery.exhausted": AuthoredContextObservationPatch;
5853
5788
  "input.pre_submit": InputPreSubmitPatch;
5854
5789
  "prompt.post_assemble": PromptPatch;
5855
5790
  "event.pre_record": EventPreRecordPatch;
@@ -5914,16 +5849,7 @@ export interface HookPatchByEvent {
5914
5849
  "spawn.parent_stopped": SpawnObservationPatch;
5915
5850
  "spawn.ttl_expired": SpawnObservationPatch;
5916
5851
  "spawn.reaped": SpawnObservationPatch;
5917
- "network.thread.opened": NetworkObservationPatch;
5918
- "network.direct_room.opened": NetworkObservationPatch;
5919
- "network.message.persisted": NetworkObservationPatch;
5920
- "network.work.opened": NetworkObservationPatch;
5921
- "network.work.transitioned": NetworkObservationPatch;
5922
- "network.work.closed": NetworkObservationPatch;
5923
- "network.peer.joined": NetworkObservationPatch;
5924
- "network.peer.left": NetworkObservationPatch;
5925
- "network.participation.pre_resolve": NetworkParticipationPreResolvePatch;
5926
- "network.participation.resolved": NetworkParticipationResolvedPatch;
5852
+ "session.attention.changed": SessionAttentionObservationPatch;
5927
5853
  "window_manager.layout.applied": WindowManagerObservationPatch;
5928
5854
  "window_manager.desktop.created": WindowManagerObservationPatch;
5929
5855
  "window_manager.desktop.deleted": WindowManagerObservationPatch;
@@ -5933,6 +5859,21 @@ export interface HookPatchByEvent {
5933
5859
  "window_manager.stack.grouped": WindowManagerObservationPatch;
5934
5860
  "window_manager.stack.ungrouped": WindowManagerObservationPatch;
5935
5861
  "window_manager.stack.activated": WindowManagerObservationPatch;
5862
+ "worktree.pre_create": WorktreeControlPatch;
5863
+ "worktree.pre_remove": WorktreeControlPatch;
5864
+ "worktree.created": WorktreeObservationPatch;
5865
+ "worktree.adopted": WorktreeObservationPatch;
5866
+ "worktree.removed": WorktreeObservationPatch;
5867
+ "terminal.opened": TerminalObservationPatch;
5868
+ "terminal.closed": TerminalObservationPatch;
5869
+ "terminal.command_started": TerminalObservationPatch;
5870
+ "terminal.command_finished": TerminalObservationPatch;
5871
+ "terminal.input_requested": TerminalObservationPatch;
5872
+ "terminal.input_provided": TerminalObservationPatch;
5873
+ "terminal.recording_started": TerminalObservationPatch;
5874
+ "terminal.recording_stopped": TerminalObservationPatch;
5875
+ "terminal.subscriber_evicted": TerminalObservationPatch;
5876
+ "terminal.limit_rejected": TerminalObservationPatch;
5936
5877
  }
5937
5878
  export interface HostAPIMethodMap {
5938
5879
  "sessions/list": {
@@ -6003,30 +5944,6 @@ export interface HostAPIMethodMap {
6003
5944
  params: SessionStatusGetParams;
6004
5945
  result: SessionStatusResponse;
6005
5946
  };
6006
- "sandbox/list": {
6007
- params: SandboxListParams | undefined;
6008
- result: SandboxListResult;
6009
- };
6010
- "sandbox/info": {
6011
- params: SandboxInfoParams;
6012
- result: SandboxInfoResult;
6013
- };
6014
- "sandbox/exec": {
6015
- params: SandboxExecParams;
6016
- result: SandboxExecResult;
6017
- };
6018
- "memory/recall": {
6019
- params: MemoryRecallParams;
6020
- result: MemoryRecallEntry[];
6021
- };
6022
- "memory/store": {
6023
- params: MemoryStoreParams;
6024
- result: EmptyResult;
6025
- };
6026
- "memory/forget": {
6027
- params: MemoryForgetParams;
6028
- result: EmptyResult;
6029
- };
6030
5947
  "observe/health": {
6031
5948
  params: undefined;
6032
5949
  result: ObserveHealth;
@@ -6107,6 +6024,10 @@ export interface HostAPIMethodMap {
6107
6024
  params: AgentHeartbeatWakeParams;
6108
6025
  result: HeartbeatWakeResponse;
6109
6026
  };
6027
+ "view/patch": {
6028
+ params: ViewFrame;
6029
+ result: EmptyResult;
6030
+ };
6110
6031
  "automation/jobs": {
6111
6032
  params: AutomationJobsParams | undefined;
6112
6033
  result: AutomationJobsResult;
@@ -6211,6 +6132,10 @@ export interface HostAPIMethodMap {
6211
6132
  params: TaskRunGetParams;
6212
6133
  result: TaskRunDetail;
6213
6134
  };
6135
+ "tasks/runs/result": {
6136
+ params: TaskRunResultParams;
6137
+ result: TaskRunResultPage;
6138
+ };
6214
6139
  "tasks/runs/enqueue": {
6215
6140
  params: TaskRunEnqueueParams;
6216
6141
  result: TaskRun;
@@ -6235,54 +6160,6 @@ export interface HostAPIMethodMap {
6235
6160
  params: TaskRunCancelParams;
6236
6161
  result: TaskRun;
6237
6162
  };
6238
- "network/status": {
6239
- params: undefined;
6240
- result: NetworkStatusPayload;
6241
- };
6242
- "network/usage": {
6243
- params: NetworkUsageParams;
6244
- result: NetworkUsageResponse;
6245
- };
6246
- "network/channels": {
6247
- params: NetworkChannelsParams;
6248
- result: NetworkChannelPayload[];
6249
- };
6250
- "network/peers": {
6251
- params: NetworkPeersParams;
6252
- result: NetworkPeerPayload[];
6253
- };
6254
- "network/threads": {
6255
- params: NetworkThreadsParams;
6256
- result: NetworkThreadsResponse;
6257
- };
6258
- "network/thread/get": {
6259
- params: NetworkThreadTargetParams;
6260
- result: NetworkThreadSummaryPayload;
6261
- };
6262
- "network/thread/messages": {
6263
- params: NetworkThreadMessagesParams;
6264
- result: NetworkThreadMessagesResponse;
6265
- };
6266
- "network/directs": {
6267
- params: NetworkDirectsParams;
6268
- result: NetworkDirectRoomsResponse;
6269
- };
6270
- "network/direct/resolve": {
6271
- params: NetworkDirectResolveParams;
6272
- result: NetworkDirectRoomPayload;
6273
- };
6274
- "network/direct/messages": {
6275
- params: NetworkDirectMessagesParams;
6276
- result: NetworkDirectRoomMessagesResponse;
6277
- };
6278
- "network/work/get": {
6279
- params: NetworkWorkGetParams;
6280
- result: NetworkWorkPayload;
6281
- };
6282
- "network/send": {
6283
- params: NetworkSendParams;
6284
- result: NetworkSendPayload;
6285
- };
6286
6163
  "resources/list": {
6287
6164
  params: ResourcesListParams | undefined;
6288
6165
  result: ResourceRecord[];
@@ -6295,34 +6172,18 @@ export interface HostAPIMethodMap {
6295
6172
  params: ResourcesSnapshotParams;
6296
6173
  result: EmptyResult;
6297
6174
  };
6298
- "bridges/instances/list": {
6299
- params: undefined;
6300
- result: BridgeInstance[];
6301
- };
6302
- "bridges/messages/ingest": {
6303
- params: InboundMessageEnvelope;
6304
- result: BridgesMessagesIngestResult;
6305
- };
6306
- "bridges/instances/get": {
6307
- params: BridgeInstanceTargetParams;
6308
- result: BridgeInstance;
6309
- };
6310
- "bridges/instances/report_state": {
6311
- params: BridgesInstancesReportStateParams;
6312
- result: BridgeInstance;
6313
- };
6314
6175
  "clarify/ask": {
6315
6176
  params: ClarifyAskParams;
6316
6177
  result: ClarifyAnswer;
6317
6178
  };
6318
6179
  }
6319
6180
  export declare const REQUIRED_METHODS_BY_PROVIDE: {
6320
- readonly "bridge.adapter": readonly ["bridges/deliver", "bridges/targets/snapshot"];
6321
6181
  readonly "connectivity.provider": readonly ["connectivity/establish", "connectivity/status", "connectivity/teardown"];
6182
+ readonly "forge.provider": readonly ["forge/capabilities", "forge/pr_create", "forge/status"];
6322
6183
  readonly "loop.watch_source": readonly ["watch/poll"];
6323
- readonly "memory.backend": readonly ["memory/forget", "memory/recall", "memory/store"];
6324
6184
  readonly "model.source": readonly ["models/list"];
6325
6185
  readonly "tool.provider": readonly ["provide_tools", "tools/call"];
6186
+ readonly "view.provider": readonly ["view/close", "view/event", "view/open"];
6326
6187
  };
6327
6188
  export interface ProvideConformanceFixture {
6328
6189
  provide: string;