@compozy/extension-sdk 0.3.0-beta.3 → 0.3.0-beta.31

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 (131) hide show
  1. package/dist/cjs/connectivity-provider.js +57 -0
  2. package/dist/cjs/connectivity-provider.js.map +1 -0
  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 +65 -1
  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-provide-surface.js +81 -0
  12. package/dist/cjs/extension-provide-surface.js.map +1 -0
  13. package/dist/cjs/extension-session.js +50 -0
  14. package/dist/cjs/extension-session.js.map +1 -0
  15. package/dist/cjs/extension-tool-dispatch.js +35 -0
  16. package/dist/cjs/extension-tool-dispatch.js.map +1 -0
  17. package/dist/cjs/extension-tool-registration.js +1 -0
  18. package/dist/cjs/extension-tool-registration.js.map +1 -1
  19. package/dist/cjs/extension.js +89 -92
  20. package/dist/cjs/extension.js.map +1 -1
  21. package/dist/cjs/forge-provider.js +90 -0
  22. package/dist/cjs/forge-provider.js.map +1 -0
  23. package/dist/cjs/generated/contracts.js +13 -1
  24. package/dist/cjs/generated/contracts.js.map +1 -1
  25. package/dist/cjs/host-api.js +2 -27
  26. package/dist/cjs/host-api.js.map +1 -1
  27. package/dist/cjs/index.js +22 -1
  28. package/dist/cjs/index.js.map +1 -1
  29. package/dist/cjs/protocol-params.js +23 -0
  30. package/dist/cjs/protocol-params.js.map +1 -0
  31. package/dist/cjs/testing/harness.js +4 -3
  32. package/dist/cjs/testing/harness.js.map +1 -1
  33. package/dist/cjs/testing/mock-transport.js +45 -2
  34. package/dist/cjs/testing/mock-transport.js.map +1 -1
  35. package/dist/cjs/transport.js +85 -8
  36. package/dist/cjs/transport.js.map +1 -1
  37. package/dist/cjs/types.js.map +1 -1
  38. package/dist/cjs/view-provider.js +148 -0
  39. package/dist/cjs/view-provider.js.map +1 -0
  40. package/dist/cjs/view-session-registry.js +41 -0
  41. package/dist/cjs/view-session-registry.js.map +1 -0
  42. package/dist/cjs/watch-source.js +11 -0
  43. package/dist/cjs/watch-source.js.map +1 -1
  44. package/dist/esm/connectivity-provider.js +53 -0
  45. package/dist/esm/connectivity-provider.js.map +1 -0
  46. package/dist/esm/errors.js +6 -1
  47. package/dist/esm/errors.js.map +1 -1
  48. package/dist/esm/extension-context.js +2 -1
  49. package/dist/esm/extension-context.js.map +1 -1
  50. package/dist/esm/extension-describe.js +64 -1
  51. package/dist/esm/extension-describe.js.map +1 -1
  52. package/dist/esm/extension-initialize.js +5 -0
  53. package/dist/esm/extension-initialize.js.map +1 -1
  54. package/dist/esm/extension-provide-surface.js +77 -0
  55. package/dist/esm/extension-provide-surface.js.map +1 -0
  56. package/dist/esm/extension-session.js +47 -0
  57. package/dist/esm/extension-session.js.map +1 -0
  58. package/dist/esm/extension-tool-dispatch.js +31 -0
  59. package/dist/esm/extension-tool-dispatch.js.map +1 -0
  60. package/dist/esm/extension-tool-registration.js +1 -0
  61. package/dist/esm/extension-tool-registration.js.map +1 -1
  62. package/dist/esm/extension.js +93 -96
  63. package/dist/esm/extension.js.map +1 -1
  64. package/dist/esm/forge-provider.js +86 -0
  65. package/dist/esm/forge-provider.js.map +1 -0
  66. package/dist/esm/generated/contracts.js +13 -1
  67. package/dist/esm/generated/contracts.js.map +1 -1
  68. package/dist/esm/host-api.js +2 -27
  69. package/dist/esm/host-api.js.map +1 -1
  70. package/dist/esm/index.js +5 -1
  71. package/dist/esm/index.js.map +1 -1
  72. package/dist/esm/protocol-params.js +18 -0
  73. package/dist/esm/protocol-params.js.map +1 -0
  74. package/dist/esm/testing/harness.js +4 -3
  75. package/dist/esm/testing/harness.js.map +1 -1
  76. package/dist/esm/testing/mock-transport.js +45 -2
  77. package/dist/esm/testing/mock-transport.js.map +1 -1
  78. package/dist/esm/transport.js +84 -7
  79. package/dist/esm/transport.js.map +1 -1
  80. package/dist/esm/types.js.map +1 -1
  81. package/dist/esm/view-provider.js +144 -0
  82. package/dist/esm/view-provider.js.map +1 -0
  83. package/dist/esm/view-session-registry.js +37 -0
  84. package/dist/esm/view-session-registry.js.map +1 -0
  85. package/dist/esm/watch-source.js +11 -0
  86. package/dist/esm/watch-source.js.map +1 -1
  87. package/dist/types/connectivity-provider.d.ts +14 -0
  88. package/dist/types/connectivity-provider.d.ts.map +1 -0
  89. package/dist/types/errors.d.ts +1 -0
  90. package/dist/types/errors.d.ts.map +1 -1
  91. package/dist/types/extension-context.d.ts +1 -1
  92. package/dist/types/extension-context.d.ts.map +1 -1
  93. package/dist/types/extension-contract.d.ts +2 -0
  94. package/dist/types/extension-contract.d.ts.map +1 -1
  95. package/dist/types/extension-describe.d.ts +2 -1
  96. package/dist/types/extension-describe.d.ts.map +1 -1
  97. package/dist/types/extension-initialize.d.ts.map +1 -1
  98. package/dist/types/extension-provide-surface.d.ts +23 -0
  99. package/dist/types/extension-provide-surface.d.ts.map +1 -0
  100. package/dist/types/extension-session.d.ts +16 -0
  101. package/dist/types/extension-session.d.ts.map +1 -0
  102. package/dist/types/extension-tool-dispatch.d.ts +5 -0
  103. package/dist/types/extension-tool-dispatch.d.ts.map +1 -0
  104. package/dist/types/extension-tool-registration.d.ts.map +1 -1
  105. package/dist/types/extension.d.ts +6 -1
  106. package/dist/types/extension.d.ts.map +1 -1
  107. package/dist/types/forge-provider.d.ts +14 -0
  108. package/dist/types/forge-provider.d.ts.map +1 -0
  109. package/dist/types/generated/contracts.d.ts +1347 -1384
  110. package/dist/types/generated/contracts.d.ts.map +1 -1
  111. package/dist/types/host-api.d.ts +3 -26
  112. package/dist/types/host-api.d.ts.map +1 -1
  113. package/dist/types/index.d.ts +9 -2
  114. package/dist/types/index.d.ts.map +1 -1
  115. package/dist/types/protocol-params.d.ts +4 -0
  116. package/dist/types/protocol-params.d.ts.map +1 -0
  117. package/dist/types/testing/harness.d.ts +1 -1
  118. package/dist/types/testing/harness.d.ts.map +1 -1
  119. package/dist/types/testing/mock-transport.d.ts +2 -1
  120. package/dist/types/testing/mock-transport.d.ts.map +1 -1
  121. package/dist/types/transport.d.ts +11 -4
  122. package/dist/types/transport.d.ts.map +1 -1
  123. package/dist/types/types.d.ts +7 -20
  124. package/dist/types/types.d.ts.map +1 -1
  125. package/dist/types/view-provider.d.ts +18 -0
  126. package/dist/types/view-provider.d.ts.map +1 -0
  127. package/dist/types/view-session-registry.d.ts +12 -0
  128. package/dist/types/view-session-registry.d.ts.map +1 -0
  129. package/dist/types/watch-source.d.ts +2 -0
  130. package/dist/types/watch-source.d.ts.map +1 -1
  131. package/package.json +2 -2
@@ -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/create" | "sessions/events" | "sessions/health/get" | "sessions/list" | "sessions/prompt" | "sessions/soul/refresh" | "sessions/status" | "sessions/status/get" | "sessions/stop" | "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" | "memory/forget" | "memory/recall" | "memory/store" | "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 = "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;
@@ -391,12 +401,14 @@ export interface AgentSpawnedPatch {
391
401
  export interface AgentSpawnedPayload {
392
402
  event: HookEvent;
393
403
  timestamp: ISODateTime;
404
+ profile_id?: string;
394
405
  session_id?: string;
395
406
  session_name?: string;
396
407
  session_type?: string;
397
408
  agent_name?: string;
398
409
  workspace_id?: string;
399
410
  workspace?: string;
411
+ worktree_id?: string;
400
412
  acp_session_id?: string;
401
413
  state?: string;
402
414
  soul_snapshot_id?: string;
@@ -424,12 +436,14 @@ export interface AgentStoppedPatch {
424
436
  export interface AgentStoppedPayload {
425
437
  event: HookEvent;
426
438
  timestamp: ISODateTime;
439
+ profile_id?: string;
427
440
  session_id?: string;
428
441
  session_name?: string;
429
442
  session_type?: string;
430
443
  agent_name?: string;
431
444
  workspace_id?: string;
432
445
  workspace?: string;
446
+ worktree_id?: string;
433
447
  acp_session_id?: string;
434
448
  state?: string;
435
449
  soul_snapshot_id?: string;
@@ -493,39 +507,16 @@ export interface Ownership {
493
507
  kind: OwnerKind;
494
508
  ref: string;
495
509
  }
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
510
  export interface JobTaskConfig {
518
511
  title?: string;
519
512
  description?: string;
520
513
  owner?: Ownership;
521
- network_participation?: NetworkParticipationRequest;
522
514
  }
523
515
  export interface LoopTarget {
524
516
  workspace_id: string;
525
517
  loop_name: string;
526
518
  inputs?: Record<string, JSONValue>;
527
519
  input_mapping?: Record<string, string>;
528
- network_participation?: NetworkParticipationRequest;
529
520
  }
530
521
  export type RetryStrategy = string;
531
522
  export interface RetryConfig {
@@ -552,6 +543,7 @@ export interface AutomationJobCreateParams {
552
543
  fire_limit?: FireLimitConfig;
553
544
  }
554
545
  export interface AutomationJobPostFirePayload {
546
+ profile_id?: string;
555
547
  job_id: string;
556
548
  job_name?: string;
557
549
  agent_name?: string;
@@ -566,6 +558,7 @@ export interface AutomationSchedulePayload {
566
558
  time?: string;
567
559
  }
568
560
  export interface AutomationJobPreFirePayload {
561
+ profile_id?: string;
569
562
  job_id: string;
570
563
  job_name?: string;
571
564
  agent_name?: string;
@@ -607,6 +600,7 @@ export interface AutomationJobsParams {
607
600
  export type JobSource = string;
608
601
  export interface Job {
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;
@@ -734,8 +732,24 @@ export interface AutomationTriggersParams {
734
732
  cursor?: string;
735
733
  limit?: number;
736
734
  }
735
+ export interface GatewayIngressPayload {
736
+ subject_kind: string;
737
+ subject_id: string;
738
+ scope_kind: string;
739
+ workspace_id?: string;
740
+ url?: string;
741
+ reachability: string;
742
+ endpoint_generation: number;
743
+ confirmed_endpoint_generation?: number;
744
+ confirmed_at?: ISODateTime;
745
+ enable_path?: string;
746
+ }
737
747
  export interface Trigger {
738
748
  id: string;
749
+ profile_id: string;
750
+ profile_name: string;
751
+ profile_color?: string;
752
+ profile_icon?: string;
739
753
  scope: Scope;
740
754
  name: string;
741
755
  target_kind: TargetKind;
@@ -753,6 +767,7 @@ export interface Trigger {
753
767
  endpoint_slug?: string;
754
768
  webhook_secret_present: boolean;
755
769
  webhook_secret_hash?: string;
770
+ ingress?: GatewayIngressPayload;
756
771
  created_at: ISODateTime;
757
772
  updated_at: ISODateTime;
758
773
  }
@@ -767,7 +782,6 @@ export interface AutonomyMatcher {
767
782
  loop_name?: string;
768
783
  node_id?: string;
769
784
  workflow_id?: string;
770
- participation_channel?: string;
771
785
  coordinator_session_id?: string;
772
786
  parent_session_id?: string;
773
787
  root_session_id?: string;
@@ -778,96 +792,6 @@ export interface AutonomyMatcher {
778
792
  export interface AutonomyObservationPatch {
779
793
  labels?: Record<string, string>;
780
794
  }
781
- export type BridgeCheckStatus = "pass" | "warn" | "fail" | "skipped";
782
- export interface BridgeCheckRecord {
783
- check: string;
784
- status: BridgeCheckStatus;
785
- remediation: string;
786
- }
787
- export interface BridgeCheckRequest {
788
- bridge_instance_id: string;
789
- }
790
- export interface BridgeCheckResponse {
791
- checks: BridgeCheckRecord[];
792
- }
793
- export type BridgeScope = string;
794
- export type BridgeInstanceSource = string;
795
- export type BridgeStatus = string;
796
- export type BridgeDMPolicy = string;
797
- export interface RoutingPolicy {
798
- include_peer: boolean;
799
- include_thread: boolean;
800
- include_group: boolean;
801
- }
802
- export type BridgeDegradationReason = string;
803
- export interface BridgeDegradation {
804
- reason: BridgeDegradationReason;
805
- message?: string;
806
- }
807
- export interface BridgeInstance {
808
- id: string;
809
- scope: BridgeScope;
810
- workspace_id?: string;
811
- platform: string;
812
- extension_name: string;
813
- display_name: string;
814
- source?: BridgeInstanceSource;
815
- enabled: boolean;
816
- status: BridgeStatus;
817
- dm_policy?: BridgeDMPolicy;
818
- routing_policy: RoutingPolicy;
819
- provider_config?: JSONValue;
820
- delivery_defaults?: JSONValue;
821
- notification_suppress: boolean;
822
- degradation?: BridgeDegradation;
823
- created_at: ISODateTime;
824
- updated_at: ISODateTime;
825
- }
826
- export interface BridgeInstanceTargetParams {
827
- bridge_instance_id: string;
828
- }
829
- export type BridgeRuntimePurpose = "service" | "control";
830
- export type BridgeTargetType = string;
831
- export interface BridgeTargetSnapshot {
832
- canonical_route: string;
833
- display_name: string;
834
- target_type: BridgeTargetType;
835
- qualifier?: string;
836
- capabilities?: string[];
837
- last_seen_at?: ISODateTime;
838
- }
839
- export interface BridgeTargetSnapshotRequest {
840
- bridge_instance_id: string;
841
- }
842
- export interface BridgeTargetSnapshotResponse {
843
- targets: BridgeTargetSnapshot[];
844
- }
845
- export interface BridgeWebhookRegistrationRequest {
846
- bridge_instance_id: string;
847
- }
848
- export interface BridgeWebhookRegistrationResponse {
849
- status: BridgeCheckStatus;
850
- remediation: string;
851
- }
852
- export interface BridgesInstancesReportStateParams {
853
- bridge_instance_id: string;
854
- status: BridgeStatus;
855
- degradation?: BridgeDegradation;
856
- clear_degradation?: boolean;
857
- }
858
- export interface RoutingKey {
859
- scope: BridgeScope;
860
- workspace_id?: string;
861
- bridge_instance_id: string;
862
- peer_id?: string;
863
- thread_id?: string;
864
- group_id?: string;
865
- }
866
- export interface BridgesMessagesIngestResult {
867
- session_id: string;
868
- route_created: boolean;
869
- routing_key: RoutingKey;
870
- }
871
795
  export interface ClarifyAnswer {
872
796
  choice?: number;
873
797
  text: string;
@@ -878,6 +802,59 @@ export interface ClarifyAskParams {
878
802
  question: string;
879
803
  choices?: string[];
880
804
  }
805
+ export interface CmdPaletteArgument {
806
+ name: string;
807
+ type: string;
808
+ placeholder?: string;
809
+ required?: boolean;
810
+ options?: string[];
811
+ }
812
+ export interface CmdPaletteAction {
813
+ kind: string;
814
+ tool?: string;
815
+ view?: string;
816
+ app?: string;
817
+ url?: string;
818
+ args?: Record<string, JSONValue>;
819
+ }
820
+ export interface CmdPaletteConfirmation {
821
+ title: string;
822
+ body?: string;
823
+ confirm: string;
824
+ }
825
+ export interface CmdPaletteExecutionPolicy {
826
+ single_flight?: boolean;
827
+ retry_safe?: boolean;
828
+ }
829
+ export interface CmdPaletteCommand {
830
+ id: string;
831
+ title: string;
832
+ section?: string;
833
+ icon: string;
834
+ profile?: string;
835
+ keywords?: string[];
836
+ arguments?: CmdPaletteArgument[];
837
+ action: CmdPaletteAction;
838
+ destructive?: boolean;
839
+ confirmation?: CmdPaletteConfirmation;
840
+ default_shortcut?: string;
841
+ execution?: CmdPaletteExecutionPolicy;
842
+ }
843
+ export interface CmdPaletteViewSource {
844
+ tool: string;
845
+ }
846
+ export interface CmdPaletteView {
847
+ id: string;
848
+ title: string;
849
+ kind: string;
850
+ profile?: string;
851
+ source?: CmdPaletteViewSource;
852
+ program?: boolean;
853
+ }
854
+ export interface CmdPaletteConfig {
855
+ commands?: CmdPaletteCommand[];
856
+ views?: CmdPaletteView[];
857
+ }
881
858
  export type CommandFlagType = "string" | "boolean" | "integer" | "number";
882
859
  export interface CommandFlag {
883
860
  name: string;
@@ -895,6 +872,35 @@ export interface CompactionMatcher {
895
872
  compaction_reason?: string;
896
873
  compaction_strategy?: string;
897
874
  }
875
+ export interface ConnectivityAdvertisedEndpoint {
876
+ url: string;
877
+ scheme: string;
878
+ scheme_policy?: string;
879
+ stability: string;
880
+ verification_address?: string;
881
+ }
882
+ export interface ConnectivityEstablishRequest {
883
+ tier: string;
884
+ forward_target: string;
885
+ challenge_path: string;
886
+ deadline: ISODateTime;
887
+ }
888
+ export interface ConnectivityReachability {
889
+ tier: string;
890
+ endpoints: ConnectivityAdvertisedEndpoint[];
891
+ health: string;
892
+ reason?: string;
893
+ }
894
+ export interface ConnectivityStatusRequest {
895
+ tier: string;
896
+ }
897
+ export interface ConnectivityTeardownRequest {
898
+ tier: string;
899
+ deadline: ISODateTime;
900
+ }
901
+ export interface ConnectivityTeardownResponse {
902
+ stopped: boolean;
903
+ }
898
904
  export interface ConsentArea {
899
905
  area: string;
900
906
  access: string;
@@ -907,12 +913,14 @@ export interface ContextBlock {
907
913
  export interface ContextCompactPayload {
908
914
  event: HookEvent;
909
915
  timestamp: ISODateTime;
916
+ profile_id?: string;
910
917
  session_id?: string;
911
918
  session_name?: string;
912
919
  session_type?: string;
913
920
  agent_name?: string;
914
921
  workspace_id?: string;
915
922
  workspace?: string;
923
+ worktree_id?: string;
916
924
  acp_session_id?: string;
917
925
  state?: string;
918
926
  soul_snapshot_id?: string;
@@ -942,12 +950,14 @@ export interface ContextPostCompactPatch {
942
950
  export interface ContextPostCompactPayload {
943
951
  event: HookEvent;
944
952
  timestamp: ISODateTime;
953
+ profile_id?: string;
945
954
  session_id?: string;
946
955
  session_name?: string;
947
956
  session_type?: string;
948
957
  agent_name?: string;
949
958
  workspace_id?: string;
950
959
  workspace?: string;
960
+ worktree_id?: string;
951
961
  acp_session_id?: string;
952
962
  state?: string;
953
963
  soul_snapshot_id?: string;
@@ -970,12 +980,14 @@ export interface ContextPreCompactPatch {
970
980
  export interface ContextPreCompactPayload {
971
981
  event: HookEvent;
972
982
  timestamp: ISODateTime;
983
+ profile_id?: string;
973
984
  session_id?: string;
974
985
  session_name?: string;
975
986
  session_type?: string;
976
987
  agent_name?: string;
977
988
  workspace_id?: string;
978
989
  workspace?: string;
990
+ worktree_id?: string;
979
991
  acp_session_id?: string;
980
992
  state?: string;
981
993
  soul_snapshot_id?: string;
@@ -988,29 +1000,12 @@ export interface ContextPreCompactPayload {
988
1000
  summary?: string;
989
1001
  context_blocks?: ContextBlock[];
990
1002
  }
991
- export type ControlMethod = "bridges/check" | "bridges/webhook/register";
992
1003
  export interface ControlPatch {
993
1004
  deny?: boolean;
994
1005
  deny_reason?: string;
995
1006
  }
996
- export type NetworkParticipationSpec = {
997
- version: "network-participation/v1";
998
- mode: "local";
999
- workspace_id?: never;
1000
- channel_strategy?: never;
1001
- channel_id?: never;
1002
- source: NetworkParticipationSource;
1003
- bounds?: never;
1004
- } | {
1005
- version: "network-participation/v1";
1006
- mode: "live";
1007
- workspace_id: string;
1008
- channel_strategy: "named" | "run" | "loop_run";
1009
- channel_id: string;
1010
- source: NetworkParticipationSource;
1011
- bounds: NetworkParticipationBounds;
1012
- };
1013
1007
  export interface CoordinatorContext {
1008
+ profile_id?: string;
1014
1009
  workspace_id?: string;
1015
1010
  workspace?: string;
1016
1011
  agent_name?: string;
@@ -1018,13 +1013,13 @@ export interface CoordinatorContext {
1018
1013
  task_id?: string;
1019
1014
  run_id?: string;
1020
1015
  workflow_id?: string;
1021
- resolved_network_participation?: NetworkParticipationSpec;
1022
1016
  provider?: string;
1023
1017
  model?: string;
1024
1018
  }
1025
1019
  export interface CoordinatorDecisionPayload {
1026
1020
  event: HookEvent;
1027
1021
  timestamp: ISODateTime;
1022
+ profile_id?: string;
1028
1023
  workspace_id?: string;
1029
1024
  workspace?: string;
1030
1025
  agent_name?: string;
@@ -1032,7 +1027,6 @@ export interface CoordinatorDecisionPayload {
1032
1027
  task_id?: string;
1033
1028
  run_id?: string;
1034
1029
  workflow_id?: string;
1035
- resolved_network_participation?: NetworkParticipationSpec;
1036
1030
  provider?: string;
1037
1031
  model?: string;
1038
1032
  decision_kind?: string;
@@ -1043,6 +1037,7 @@ export interface CoordinatorDecisionPayload {
1043
1037
  export interface CoordinatorFailedPayload {
1044
1038
  event: HookEvent;
1045
1039
  timestamp: ISODateTime;
1040
+ profile_id?: string;
1046
1041
  workspace_id?: string;
1047
1042
  workspace?: string;
1048
1043
  agent_name?: string;
@@ -1050,7 +1045,6 @@ export interface CoordinatorFailedPayload {
1050
1045
  task_id?: string;
1051
1046
  run_id?: string;
1052
1047
  workflow_id?: string;
1053
- resolved_network_participation?: NetworkParticipationSpec;
1054
1048
  provider?: string;
1055
1049
  model?: string;
1056
1050
  decision_kind?: string;
@@ -1061,6 +1055,7 @@ export interface CoordinatorFailedPayload {
1061
1055
  export interface CoordinatorLifecyclePayload {
1062
1056
  event: HookEvent;
1063
1057
  timestamp: ISODateTime;
1058
+ profile_id?: string;
1064
1059
  workspace_id?: string;
1065
1060
  workspace?: string;
1066
1061
  agent_name?: string;
@@ -1068,7 +1063,6 @@ export interface CoordinatorLifecyclePayload {
1068
1063
  task_id?: string;
1069
1064
  run_id?: string;
1070
1065
  workflow_id?: string;
1071
- resolved_network_participation?: NetworkParticipationSpec;
1072
1066
  provider?: string;
1073
1067
  model?: string;
1074
1068
  decision_kind?: string;
@@ -1082,6 +1076,7 @@ export interface CoordinatorObservationPatch {
1082
1076
  export interface CoordinatorPreSpawnPayload {
1083
1077
  event: HookEvent;
1084
1078
  timestamp: ISODateTime;
1079
+ profile_id?: string;
1085
1080
  workspace_id?: string;
1086
1081
  workspace?: string;
1087
1082
  agent_name?: string;
@@ -1089,7 +1084,6 @@ export interface CoordinatorPreSpawnPayload {
1089
1084
  task_id?: string;
1090
1085
  run_id?: string;
1091
1086
  workflow_id?: string;
1092
- resolved_network_participation?: NetworkParticipationSpec;
1093
1087
  provider?: string;
1094
1088
  model?: string;
1095
1089
  reason?: string;
@@ -1106,6 +1100,7 @@ export interface CoordinatorSpawnPatch {
1106
1100
  export interface CoordinatorSpawnedPayload {
1107
1101
  event: HookEvent;
1108
1102
  timestamp: ISODateTime;
1103
+ profile_id?: string;
1109
1104
  workspace_id?: string;
1110
1105
  workspace?: string;
1111
1106
  agent_name?: string;
@@ -1113,7 +1108,6 @@ export interface CoordinatorSpawnedPayload {
1113
1108
  task_id?: string;
1114
1109
  run_id?: string;
1115
1110
  workflow_id?: string;
1116
- resolved_network_participation?: NetworkParticipationSpec;
1117
1111
  provider?: string;
1118
1112
  model?: string;
1119
1113
  decision_kind?: string;
@@ -1124,6 +1118,7 @@ export interface CoordinatorSpawnedPayload {
1124
1118
  export interface CoordinatorStoppedPayload {
1125
1119
  event: HookEvent;
1126
1120
  timestamp: ISODateTime;
1121
+ profile_id?: string;
1127
1122
  workspace_id?: string;
1128
1123
  workspace?: string;
1129
1124
  agent_name?: string;
@@ -1131,7 +1126,6 @@ export interface CoordinatorStoppedPayload {
1131
1126
  task_id?: string;
1132
1127
  run_id?: string;
1133
1128
  workflow_id?: string;
1134
- resolved_network_participation?: NetworkParticipationSpec;
1135
1129
  provider?: string;
1136
1130
  model?: string;
1137
1131
  decision_kind?: string;
@@ -1139,90 +1133,36 @@ export interface CoordinatorStoppedPayload {
1139
1133
  stop_reason?: string;
1140
1134
  error?: string;
1141
1135
  }
1142
- export type DeliveryAckOutcome = "success" | "committed_result_unavailable";
1143
- export interface DeliveryErrorDetail {
1144
- message: string;
1145
- }
1146
- export interface DeliveryAck {
1147
- delivery_id: string;
1148
- seq: number;
1149
- remote_message_id?: string;
1150
- replace_remote_message_id?: string;
1151
- outcome?: DeliveryAckOutcome;
1152
- error?: DeliveryErrorDetail;
1153
- }
1154
- export type DeliveryMode = string;
1155
- export interface DeliveryTarget {
1156
- bridge_instance_id: string;
1157
- peer_id?: string;
1158
- thread_id?: string;
1159
- group_id?: string;
1160
- mode?: DeliveryMode;
1161
- }
1162
- export type DeliveryEventType = "start" | "delta" | "final" | "error" | "resume" | "delete" | "progress";
1163
- export interface MessageContent {
1164
- text?: string;
1136
+ export interface DescribeGatewayRequirement {
1137
+ permissions: string[];
1165
1138
  }
1166
- export type DeliveryOperation = string;
1167
- export interface DeliveryMessageReference {
1168
- delivery_id?: string;
1169
- remote_message_id?: string;
1139
+ export interface DescribeProfileDefaults {
1140
+ agent?: string;
1141
+ provider?: string;
1170
1142
  }
1171
- export interface DeliveryResumeState {
1172
- latest_event_type: DeliveryEventType;
1143
+ export interface DescribeProfileCredential {
1144
+ provider: string;
1145
+ slot: string;
1173
1146
  }
1174
- export type ToolProgressPhase = "started" | "completed" | "failed";
1175
- export interface ToolProgress {
1176
- tool_call_id: string;
1177
- tool_id: string;
1178
- phase: ToolProgressPhase;
1179
- label: string;
1180
- preview?: string;
1147
+ export interface DescribeProfile {
1148
+ name: string;
1149
+ color?: string;
1150
+ icon?: string;
1181
1151
  emoji?: string;
1182
- duration_ms?: number;
1183
- error?: string;
1184
- index: number;
1152
+ defaults?: DescribeProfileDefaults;
1153
+ credentials?: DescribeProfileCredential[];
1185
1154
  }
1186
- export interface DeliveryEvent {
1187
- delivery_id: string;
1188
- bridge_instance_id: string;
1189
- routing_key: RoutingKey;
1190
- delivery_target: DeliveryTarget;
1191
- seq: number;
1192
- event_type: DeliveryEventType;
1193
- content: MessageContent;
1194
- final: boolean;
1195
- operation?: DeliveryOperation;
1196
- reference?: DeliveryMessageReference;
1197
- error?: DeliveryErrorDetail;
1198
- resume?: DeliveryResumeState;
1199
- progress?: ToolProgress;
1200
- provider_metadata?: JSONValue;
1201
- }
1202
- export interface DeliverySnapshot {
1203
- delivery_id: string;
1204
- session_id: string;
1205
- turn_id: string;
1206
- bridge_instance_id: string;
1207
- routing_key: RoutingKey;
1208
- delivery_target: DeliveryTarget;
1209
- latest_seq: number;
1210
- latest_event_type: DeliveryEventType;
1211
- current_content: MessageContent;
1212
- operation?: DeliveryOperation;
1213
- reference?: DeliveryMessageReference;
1214
- provider_metadata?: JSONValue;
1215
- last_sent_seq?: number;
1216
- last_acked_seq?: number;
1217
- remote_message_id?: string;
1218
- replace_remote_message_id?: string;
1219
- final: boolean;
1220
- error?: string;
1221
- updated_at: ISODateTime;
1155
+ export interface DescribeResourcePath {
1156
+ path: string;
1157
+ profile?: string;
1222
1158
  }
1223
- export interface DeliveryRequest {
1224
- event: DeliveryEvent;
1225
- snapshot?: DeliverySnapshot;
1159
+ export interface DescribeResources {
1160
+ skills?: DescribeResourcePath[];
1161
+ loops?: DescribeResourcePath[];
1162
+ agents?: DescribeResourcePath[];
1163
+ automation?: DescribeResourcePath[];
1164
+ layouts?: DescribeResourcePath[];
1165
+ cmd_palette?: CmdPaletteConfig;
1226
1166
  }
1227
1167
  export interface DescribeSubprocess {
1228
1168
  command: string;
@@ -1238,6 +1178,7 @@ export interface ExtensionCommandSpec {
1238
1178
  flags?: Record<string, string>;
1239
1179
  }
1240
1180
  export interface ExtensionToolRuntimeDescriptor {
1181
+ profile?: string;
1241
1182
  id: ToolID;
1242
1183
  handler: string;
1243
1184
  description?: string;
@@ -1253,9 +1194,14 @@ export interface ExtensionToolRuntimeDescriptor {
1253
1194
  capabilities?: string[];
1254
1195
  command?: ExtensionCommandSpec;
1255
1196
  }
1197
+ export interface DescribeHookEvent {
1198
+ event: HookEvent;
1199
+ profile?: string;
1200
+ }
1256
1201
  export interface ExtensionCommandGroupSpec {
1257
1202
  path: string;
1258
1203
  summary: string;
1204
+ profile?: string;
1259
1205
  }
1260
1206
  export interface DescribeSDKInfo {
1261
1207
  name: string;
@@ -1270,13 +1216,21 @@ export interface DescribePayload {
1270
1216
  provides: string[];
1271
1217
  permissions: string[];
1272
1218
  requires_env?: string[];
1219
+ profiles?: DescribeProfile[];
1220
+ resources: DescribeResources;
1273
1221
  subprocess: DescribeSubprocess;
1222
+ gateway?: DescribeGatewayRequirement;
1274
1223
  tools?: ExtensionToolRuntimeDescriptor[];
1275
- hook_events?: string[];
1224
+ hook_events?: DescribeHookEvent[];
1276
1225
  watch_source_kinds?: string[];
1226
+ cmd_palette_views?: string[];
1277
1227
  command_groups?: ExtensionCommandGroupSpec[];
1278
1228
  sdk: DescribeSDKInfo;
1279
1229
  }
1230
+ export interface EffectResult {
1231
+ effect_id: string;
1232
+ payload?: JSONValue;
1233
+ }
1280
1234
  export type EmptyResult = Record<string, never>;
1281
1235
  export interface EventPostRecordPatch {
1282
1236
  labels?: Record<string, string>;
@@ -1284,12 +1238,14 @@ export interface EventPostRecordPatch {
1284
1238
  export interface EventPostRecordPayload {
1285
1239
  event: HookEvent;
1286
1240
  timestamp: ISODateTime;
1241
+ profile_id?: string;
1287
1242
  session_id?: string;
1288
1243
  session_name?: string;
1289
1244
  session_type?: string;
1290
1245
  agent_name?: string;
1291
1246
  workspace_id?: string;
1292
1247
  workspace?: string;
1248
+ worktree_id?: string;
1293
1249
  acp_session_id?: string;
1294
1250
  state?: string;
1295
1251
  soul_snapshot_id?: string;
@@ -1307,12 +1263,14 @@ export interface EventPreRecordPatch {
1307
1263
  export interface EventPreRecordPayload {
1308
1264
  event: HookEvent;
1309
1265
  timestamp: ISODateTime;
1266
+ profile_id?: string;
1310
1267
  session_id?: string;
1311
1268
  session_name?: string;
1312
1269
  session_type?: string;
1313
1270
  agent_name?: string;
1314
1271
  workspace_id?: string;
1315
1272
  workspace?: string;
1273
+ worktree_id?: string;
1316
1274
  acp_session_id?: string;
1317
1275
  state?: string;
1318
1276
  soul_snapshot_id?: string;
@@ -1330,12 +1288,14 @@ export interface EventRecordPatch {
1330
1288
  export interface EventRecordPayload {
1331
1289
  event: HookEvent;
1332
1290
  timestamp: ISODateTime;
1291
+ profile_id?: string;
1333
1292
  session_id?: string;
1334
1293
  session_name?: string;
1335
1294
  session_type?: string;
1336
1295
  agent_name?: string;
1337
1296
  workspace_id?: string;
1338
1297
  workspace?: string;
1298
+ worktree_id?: string;
1339
1299
  acp_session_id?: string;
1340
1300
  state?: string;
1341
1301
  soul_snapshot_id?: string;
@@ -1383,6 +1343,7 @@ export interface Redaction {
1383
1343
  reason: ReasonCode;
1384
1344
  bytes?: number;
1385
1345
  }
1346
+ export type ResultTrust = string;
1386
1347
  export interface ToolResult {
1387
1348
  content?: ToolContent[];
1388
1349
  structured?: JSONValue;
@@ -1393,13 +1354,20 @@ export interface ToolResult {
1393
1354
  truncated: boolean;
1394
1355
  bytes: number;
1395
1356
  duration_ms: number;
1357
+ trust?: ResultTrust;
1396
1358
  }
1397
1359
  export interface ExtensionToolCallResponse {
1398
1360
  result: ToolResult;
1399
1361
  }
1400
- export type IssueSeverity = "error" | "warning";
1362
+ export interface ExtensionValidationComponent {
1363
+ kind: string;
1364
+ name: string;
1365
+ transport?: string;
1366
+ }
1367
+ export type IssueSeverity = "error" | "warning" | "warn";
1401
1368
  export interface ValidationIssue {
1402
1369
  path: string;
1370
+ scope?: string;
1403
1371
  line?: number;
1404
1372
  column?: number;
1405
1373
  field?: string;
@@ -1407,9 +1375,67 @@ export interface ValidationIssue {
1407
1375
  severity: IssueSeverity;
1408
1376
  }
1409
1377
  export interface ExtensionValidatePayload {
1378
+ status: string;
1379
+ format: string;
1380
+ name?: string;
1381
+ version?: string;
1382
+ would_ingest?: ExtensionValidationComponent[];
1410
1383
  manifest?: ExtensionManifestSummary;
1411
1384
  issues: ValidationIssue[];
1412
- consent_areas: ConsentArea[];
1385
+ consent_areas?: ConsentArea[];
1386
+ }
1387
+ export interface ForgeCapabilitiesRequest {
1388
+ remote_urls: string[];
1389
+ }
1390
+ export interface ForgeCapabilitiesResponse {
1391
+ served: boolean;
1392
+ available: boolean;
1393
+ winner?: string;
1394
+ provider?: string;
1395
+ served_remote?: string;
1396
+ request_noun?: string;
1397
+ open_action_label?: string;
1398
+ view_action_label?: string;
1399
+ supports_draft?: boolean;
1400
+ compare_url_template?: string;
1401
+ template_paths?: string[];
1402
+ credential_source?: string;
1403
+ default_branch?: string;
1404
+ cause?: string;
1405
+ }
1406
+ export interface ForgePRCreateRequest {
1407
+ remote_urls: string[];
1408
+ head: string;
1409
+ head_sha?: string;
1410
+ base: string;
1411
+ title: string;
1412
+ body?: string;
1413
+ draft?: boolean;
1414
+ }
1415
+ export interface ForgePRCreateResponse {
1416
+ status: string;
1417
+ number?: number;
1418
+ url?: string;
1419
+ cause?: string;
1420
+ }
1421
+ export interface ForgeStatusRequest {
1422
+ remote_urls: string[];
1423
+ branch: string;
1424
+ base?: string;
1425
+ head_sha?: string;
1426
+ }
1427
+ export interface ForgeStatusResponse {
1428
+ provider: string;
1429
+ pr_number?: number;
1430
+ pr_state?: string;
1431
+ pr_url?: string;
1432
+ head?: string;
1433
+ base?: string;
1434
+ head_sha?: string;
1435
+ draft?: boolean;
1436
+ merged?: boolean;
1437
+ fetched_at: ISODateTime;
1438
+ cause?: string;
1413
1439
  }
1414
1440
  export interface HeartbeatDeleteRequest {
1415
1441
  workspace_id?: string;
@@ -1576,10 +1602,15 @@ export interface HeartbeatWakeEventPayload {
1576
1602
  created_at: ISODateTime;
1577
1603
  expires_at: ISODateTime;
1578
1604
  }
1605
+ export type State = "starting" | "active" | "stopping" | "stopped";
1579
1606
  export type SessionHealthState = "idle" | "prompting" | "stopped" | "detached";
1580
1607
  export type SessionHealthStatus = "healthy" | "degraded" | "stale" | "dead" | "unknown";
1581
1608
  export type SessionHealthIneligibilityReason = "session_prompt_active" | "session_not_attachable" | "session_unhealthy" | "session_health_stale" | "session_health_hung" | "session_health_dead" | "session_health_unknown";
1582
1609
  export interface SessionHealthPayload {
1610
+ lifecycle_state?: State;
1611
+ verified?: boolean;
1612
+ escalated?: boolean;
1613
+ attention?: string;
1583
1614
  session_id: string;
1584
1615
  workspace_id: string;
1585
1616
  agent_name: string;
@@ -1644,12 +1675,9 @@ export interface HookMatcher {
1644
1675
  agent_name?: string;
1645
1676
  agent_type?: string;
1646
1677
  workspace_id?: string;
1678
+ worktree_id?: string;
1647
1679
  workspace_root?: string;
1648
1680
  session_type?: string;
1649
- sandbox_id?: string;
1650
- sandbox_backend?: string;
1651
- sandbox_profile?: string;
1652
- sync_direction?: string;
1653
1681
  input_class?: string;
1654
1682
  acp_event_type?: string;
1655
1683
  turn_id?: string;
@@ -1659,13 +1687,6 @@ export interface HookMatcher {
1659
1687
  decision_class?: string;
1660
1688
  message_role?: string;
1661
1689
  message_delta_type?: string;
1662
- channel?: string;
1663
- surface?: string;
1664
- kind?: string;
1665
- direction?: string;
1666
- work_state?: string;
1667
- participation_mode?: string;
1668
- participation_source?: string;
1669
1690
  compaction_reason?: string;
1670
1691
  compaction_strategy?: string;
1671
1692
  autonomy?: AutonomyMatcher;
@@ -1674,6 +1695,7 @@ export type HookExecutorKind = "native" | "subprocess" | "wasm";
1674
1695
  export type HookSource = "native" | "config" | "extension" | "agent_definition" | "skill";
1675
1696
  export interface HookDecl {
1676
1697
  name: string;
1698
+ profile_id?: string;
1677
1699
  event: HookEvent;
1678
1700
  mode?: HookMode;
1679
1701
  matcher: HookMatcher;
@@ -1689,97 +1711,9 @@ export interface HookDecl {
1689
1711
  source: HookSource;
1690
1712
  required?: boolean;
1691
1713
  }
1692
- export type HookEventFamily = "session" | "sandbox" | "input" | "prompt" | "event" | "automation" | "agent" | "turn" | "message" | "tool" | "permission" | "context" | "coordinator" | "task" | "task.run" | "loop" | "spawn" | "network" | "window_manager";
1714
+ export type HookEventFamily = "session" | "input" | "prompt" | "event" | "automation" | "agent" | "turn" | "message" | "tool" | "permission" | "context" | "coordinator" | "task" | "task.run" | "loop" | "spawn" | "window_manager" | "worktree" | "terminal";
1693
1715
  export type HookRunOutcome = "applied" | "denied" | "failed" | "skipped" | "dropped" | "rejected";
1694
- export type HookSkillSource = "bundled" | "marketplace" | "user" | "additional" | "workspace";
1695
- export interface InboundAction {
1696
- action_id: string;
1697
- message_id?: string;
1698
- value?: string;
1699
- trigger_id?: string;
1700
- }
1701
- export interface InboundCommand {
1702
- command: string;
1703
- text?: string;
1704
- trigger_id?: string;
1705
- }
1706
- export type InboundEditOperation = "updated" | "deleted";
1707
- export interface InboundEdit {
1708
- message_id: string;
1709
- new_text: string;
1710
- original_timestamp: ISODateTime;
1711
- operation: InboundEditOperation;
1712
- }
1713
- export type InboundEventFamily = "message" | "command" | "action" | "reaction" | "edit";
1714
- export interface MessageSender {
1715
- id?: string;
1716
- username?: string;
1717
- display_name?: string;
1718
- }
1719
- export interface MessageAttachment {
1720
- id?: string;
1721
- name?: string;
1722
- mime_type?: string;
1723
- url?: string;
1724
- }
1725
- export interface InboundReaction {
1726
- message_id: string;
1727
- emoji: string;
1728
- raw_emoji?: string;
1729
- added: boolean;
1730
- }
1731
- export type NetworkConversationSurface = string;
1732
- export interface NetworkConversationRef {
1733
- channel: string;
1734
- surface: NetworkConversationSurface;
1735
- thread_id?: string;
1736
- direct_id?: string;
1737
- work_id?: string;
1738
- reply_to?: string;
1739
- trace_id?: string;
1740
- causation_id?: string;
1741
- }
1742
- export interface InboundMessageEnvelope {
1743
- bridge_instance_id: string;
1744
- scope: BridgeScope;
1745
- workspace_id?: string;
1746
- peer_id?: string;
1747
- thread_id?: string;
1748
- group_id?: string;
1749
- platform_message_id?: string;
1750
- received_at: ISODateTime;
1751
- sender: MessageSender;
1752
- content?: MessageContent;
1753
- attachments?: MessageAttachment[];
1754
- event_family: InboundEventFamily;
1755
- command?: InboundCommand;
1756
- action?: InboundAction;
1757
- reaction?: InboundReaction;
1758
- edit?: InboundEdit;
1759
- reply_to_text?: string;
1760
- reply_to_author_id?: string;
1761
- reply_to_author_name?: string;
1762
- conversation?: NetworkConversationRef;
1763
- provider_metadata?: JSONValue;
1764
- idempotency_key: string;
1765
- }
1766
- export interface InitializeBridgeBoundSecret {
1767
- binding_name: string;
1768
- kind: string;
1769
- value: string;
1770
- }
1771
- export interface InitializeBridgeManagedInstance {
1772
- instance: BridgeInstance;
1773
- bound_secrets?: InitializeBridgeBoundSecret[];
1774
- }
1775
- export interface InitializeBridgeRuntime {
1776
- runtime_version: string;
1777
- purpose: BridgeRuntimePurpose;
1778
- provider: string;
1779
- platform: string;
1780
- allowed_methods?: string[];
1781
- managed_instances?: InitializeBridgeManagedInstance[];
1782
- }
1716
+ export type HookSkillSource = "bundled" | "marketplace" | "user" | "profile" | "additional" | "workspace" | "workspace_profile";
1783
1717
  export interface InitializeCapabilities {
1784
1718
  provides: string[];
1785
1719
  granted_permissions: HostAPIMethod[];
@@ -1806,7 +1740,7 @@ export interface InitializeRuntime {
1806
1740
  health_check_timeout_ms: number;
1807
1741
  shutdown_timeout_ms: number;
1808
1742
  default_hook_timeout_ms: number;
1809
- bridge?: InitializeBridgeRuntime;
1743
+ default_view_timeout_ms?: number;
1810
1744
  }
1811
1745
  export interface InitializeRequest {
1812
1746
  protocol_version: string;
@@ -1828,6 +1762,7 @@ export interface InitializeResponse {
1828
1762
  implemented_methods: string[];
1829
1763
  supported_hook_events: string[];
1830
1764
  watch_source_kinds?: string[];
1765
+ cmd_palette_views?: string[];
1831
1766
  supports: InitializeSupports;
1832
1767
  }
1833
1768
  export interface InputPreSubmitPatch {
@@ -1836,15 +1771,24 @@ export interface InputPreSubmitPatch {
1836
1771
  message?: string;
1837
1772
  context_blocks?: ContextBlock[];
1838
1773
  }
1774
+ export interface InputAttachmentMetadata {
1775
+ id: string;
1776
+ name: string;
1777
+ mime: string;
1778
+ bytes: number;
1779
+ kind: string;
1780
+ }
1839
1781
  export interface InputPreSubmitPayload {
1840
1782
  event: HookEvent;
1841
1783
  timestamp: ISODateTime;
1784
+ profile_id?: string;
1842
1785
  session_id?: string;
1843
1786
  session_name?: string;
1844
1787
  session_type?: string;
1845
1788
  agent_name?: string;
1846
1789
  workspace_id?: string;
1847
1790
  workspace?: string;
1791
+ worktree_id?: string;
1848
1792
  acp_session_id?: string;
1849
1793
  state?: string;
1850
1794
  soul_snapshot_id?: string;
@@ -1855,6 +1799,7 @@ export interface InputPreSubmitPayload {
1855
1799
  input_class?: string;
1856
1800
  message?: string;
1857
1801
  context_blocks?: ContextBlock[];
1802
+ attachments?: InputAttachmentMetadata[];
1858
1803
  }
1859
1804
  export interface ListLogsParams {
1860
1805
  workspace_id: string;
@@ -1873,6 +1818,7 @@ export interface ListLogsParams {
1873
1818
  limit?: number;
1874
1819
  }
1875
1820
  export interface LoopContext {
1821
+ profile_id?: string;
1876
1822
  loop_run_id?: string;
1877
1823
  parent_loop_run_id?: string;
1878
1824
  workspace_id?: string;
@@ -1883,7 +1829,6 @@ export interface LoopContext {
1883
1829
  run_kind?: string;
1884
1830
  node_id?: string;
1885
1831
  workflow_id?: string;
1886
- resolved_network_participation?: NetworkParticipationSpec;
1887
1832
  agent_name?: string;
1888
1833
  session_id?: string;
1889
1834
  actor_kind?: string;
@@ -1898,6 +1843,7 @@ export interface LoopControlPatch {
1898
1843
  export interface LoopGatePostPayload {
1899
1844
  event: HookEvent;
1900
1845
  timestamp: ISODateTime;
1846
+ profile_id?: string;
1901
1847
  loop_run_id?: string;
1902
1848
  parent_loop_run_id?: string;
1903
1849
  workspace_id?: string;
@@ -1908,7 +1854,6 @@ export interface LoopGatePostPayload {
1908
1854
  run_kind?: string;
1909
1855
  node_id?: string;
1910
1856
  workflow_id?: string;
1911
- resolved_network_participation?: NetworkParticipationSpec;
1912
1857
  agent_name?: string;
1913
1858
  session_id?: string;
1914
1859
  actor_kind?: string;
@@ -1916,7 +1861,9 @@ export interface LoopGatePostPayload {
1916
1861
  origin_kind?: string;
1917
1862
  origin_ref?: string;
1918
1863
  gate_id?: string;
1919
- decision?: string;
1864
+ outcome?: string;
1865
+ score?: number;
1866
+ best_generation?: number;
1920
1867
  status?: string;
1921
1868
  reason_code?: string;
1922
1869
  details?: JSONValue;
@@ -1930,6 +1877,7 @@ export interface LoopGatePrePatch {
1930
1877
  export interface LoopGatePrePayload {
1931
1878
  event: HookEvent;
1932
1879
  timestamp: ISODateTime;
1880
+ profile_id?: string;
1933
1881
  loop_run_id?: string;
1934
1882
  parent_loop_run_id?: string;
1935
1883
  workspace_id?: string;
@@ -1940,7 +1888,6 @@ export interface LoopGatePrePayload {
1940
1888
  run_kind?: string;
1941
1889
  node_id?: string;
1942
1890
  workflow_id?: string;
1943
- resolved_network_participation?: NetworkParticipationSpec;
1944
1891
  agent_name?: string;
1945
1892
  session_id?: string;
1946
1893
  actor_kind?: string;
@@ -1948,16 +1895,20 @@ export interface LoopGatePrePayload {
1948
1895
  origin_kind?: string;
1949
1896
  origin_ref?: string;
1950
1897
  gate_id?: string;
1951
- decision?: string;
1898
+ outcome?: string;
1899
+ score?: number;
1900
+ best_generation?: number;
1952
1901
  status?: string;
1953
1902
  reason_code?: string;
1954
1903
  details?: JSONValue;
1955
1904
  denied?: boolean;
1956
1905
  deny_reason?: string;
1957
1906
  }
1907
+ export type LoopGenerationOrigin = "initial" | "stop_when" | "reattempt" | "gate_revise" | "gate_next_generation" | "dod_retry" | "ratchet_restore";
1958
1908
  export interface LoopGenerationPostPayload {
1959
1909
  event: HookEvent;
1960
1910
  timestamp: ISODateTime;
1911
+ profile_id?: string;
1961
1912
  loop_run_id?: string;
1962
1913
  parent_loop_run_id?: string;
1963
1914
  workspace_id?: string;
@@ -1968,13 +1919,14 @@ export interface LoopGenerationPostPayload {
1968
1919
  run_kind?: string;
1969
1920
  node_id?: string;
1970
1921
  workflow_id?: string;
1971
- resolved_network_participation?: NetworkParticipationSpec;
1972
1922
  agent_name?: string;
1973
1923
  session_id?: string;
1974
1924
  actor_kind?: string;
1975
1925
  actor_id?: string;
1976
1926
  origin_kind?: string;
1977
1927
  origin_ref?: string;
1928
+ origin: LoopGenerationOrigin;
1929
+ parent_generation: number;
1978
1930
  status?: string;
1979
1931
  reason_code?: string;
1980
1932
  details?: JSONValue;
@@ -1988,6 +1940,7 @@ export interface LoopGenerationPrePatch {
1988
1940
  export interface LoopGenerationPrePayload {
1989
1941
  event: HookEvent;
1990
1942
  timestamp: ISODateTime;
1943
+ profile_id?: string;
1991
1944
  loop_run_id?: string;
1992
1945
  parent_loop_run_id?: string;
1993
1946
  workspace_id?: string;
@@ -1998,13 +1951,14 @@ export interface LoopGenerationPrePayload {
1998
1951
  run_kind?: string;
1999
1952
  node_id?: string;
2000
1953
  workflow_id?: string;
2001
- resolved_network_participation?: NetworkParticipationSpec;
2002
1954
  agent_name?: string;
2003
1955
  session_id?: string;
2004
1956
  actor_kind?: string;
2005
1957
  actor_id?: string;
2006
1958
  origin_kind?: string;
2007
1959
  origin_ref?: string;
1960
+ origin: LoopGenerationOrigin;
1961
+ parent_generation: number;
2008
1962
  status?: string;
2009
1963
  reason_code?: string;
2010
1964
  details?: JSONValue;
@@ -2014,6 +1968,7 @@ export interface LoopGenerationPrePayload {
2014
1968
  export interface LoopLifecyclePayload {
2015
1969
  event: HookEvent;
2016
1970
  timestamp: ISODateTime;
1971
+ profile_id?: string;
2017
1972
  loop_run_id?: string;
2018
1973
  parent_loop_run_id?: string;
2019
1974
  workspace_id?: string;
@@ -2024,7 +1979,6 @@ export interface LoopLifecyclePayload {
2024
1979
  run_kind?: string;
2025
1980
  node_id?: string;
2026
1981
  workflow_id?: string;
2027
- resolved_network_participation?: NetworkParticipationSpec;
2028
1982
  agent_name?: string;
2029
1983
  session_id?: string;
2030
1984
  actor_kind?: string;
@@ -2039,6 +1993,7 @@ export interface LoopLifecyclePayload {
2039
1993
  export interface LoopNodeTerminalPayload {
2040
1994
  event: HookEvent;
2041
1995
  timestamp: ISODateTime;
1996
+ profile_id?: string;
2042
1997
  loop_run_id?: string;
2043
1998
  parent_loop_run_id?: string;
2044
1999
  workspace_id?: string;
@@ -2049,7 +2004,6 @@ export interface LoopNodeTerminalPayload {
2049
2004
  run_kind?: string;
2050
2005
  node_id?: string;
2051
2006
  workflow_id?: string;
2052
- resolved_network_participation?: NetworkParticipationSpec;
2053
2007
  agent_name?: string;
2054
2008
  session_id?: string;
2055
2009
  actor_kind?: string;
@@ -2058,6 +2012,10 @@ export interface LoopNodeTerminalPayload {
2058
2012
  origin_ref?: string;
2059
2013
  task_status?: string;
2060
2014
  run_status?: string;
2015
+ failure_class?: string;
2016
+ disposition?: string;
2017
+ attempt?: number;
2018
+ target?: string;
2061
2019
  error?: string;
2062
2020
  details?: JSONValue;
2063
2021
  }
@@ -2067,6 +2025,7 @@ export interface LoopObservationPatch {
2067
2025
  export interface LoopStartedPayload {
2068
2026
  event: HookEvent;
2069
2027
  timestamp: ISODateTime;
2028
+ profile_id?: string;
2070
2029
  loop_run_id?: string;
2071
2030
  parent_loop_run_id?: string;
2072
2031
  workspace_id?: string;
@@ -2077,7 +2036,6 @@ export interface LoopStartedPayload {
2077
2036
  run_kind?: string;
2078
2037
  node_id?: string;
2079
2038
  workflow_id?: string;
2080
- resolved_network_participation?: NetworkParticipationSpec;
2081
2039
  agent_name?: string;
2082
2040
  session_id?: string;
2083
2041
  actor_kind?: string;
@@ -2092,6 +2050,7 @@ export interface LoopStartedPayload {
2092
2050
  export interface LoopTerminalPayload {
2093
2051
  event: HookEvent;
2094
2052
  timestamp: ISODateTime;
2053
+ profile_id?: string;
2095
2054
  loop_run_id?: string;
2096
2055
  parent_loop_run_id?: string;
2097
2056
  workspace_id?: string;
@@ -2102,7 +2061,6 @@ export interface LoopTerminalPayload {
2102
2061
  run_kind?: string;
2103
2062
  node_id?: string;
2104
2063
  workflow_id?: string;
2105
- resolved_network_participation?: NetworkParticipationSpec;
2106
2064
  agent_name?: string;
2107
2065
  session_id?: string;
2108
2066
  actor_kind?: string;
@@ -2114,7 +2072,7 @@ export interface LoopTerminalPayload {
2114
2072
  reason_code?: string;
2115
2073
  details?: JSONValue;
2116
2074
  }
2117
- export type MemoryScope = "global" | "workspace" | "agent";
2075
+ export type MemoryScope = "profile" | "workspace" | "agent";
2118
2076
  export interface MemoryForgetParams {
2119
2077
  key: string;
2120
2078
  scope?: MemoryScope;
@@ -2148,12 +2106,14 @@ export interface MessageDeltaPatch {
2148
2106
  export interface MessageDeltaPayload {
2149
2107
  event: HookEvent;
2150
2108
  timestamp: ISODateTime;
2109
+ profile_id?: string;
2151
2110
  session_id?: string;
2152
2111
  session_name?: string;
2153
2112
  session_type?: string;
2154
2113
  agent_name?: string;
2155
2114
  workspace_id?: string;
2156
2115
  workspace?: string;
2116
+ worktree_id?: string;
2157
2117
  acp_session_id?: string;
2158
2118
  state?: string;
2159
2119
  soul_snapshot_id?: string;
@@ -2177,12 +2137,14 @@ export interface MessageEndPatch {
2177
2137
  export interface MessageEndPayload {
2178
2138
  event: HookEvent;
2179
2139
  timestamp: ISODateTime;
2140
+ profile_id?: string;
2180
2141
  session_id?: string;
2181
2142
  session_name?: string;
2182
2143
  session_type?: string;
2183
2144
  agent_name?: string;
2184
2145
  workspace_id?: string;
2185
2146
  workspace?: string;
2147
+ worktree_id?: string;
2186
2148
  acp_session_id?: string;
2187
2149
  state?: string;
2188
2150
  soul_snapshot_id?: string;
@@ -2206,12 +2168,14 @@ export interface MessagePatch {
2206
2168
  export interface MessagePayload {
2207
2169
  event: HookEvent;
2208
2170
  timestamp: ISODateTime;
2171
+ profile_id?: string;
2209
2172
  session_id?: string;
2210
2173
  session_name?: string;
2211
2174
  session_type?: string;
2212
2175
  agent_name?: string;
2213
2176
  workspace_id?: string;
2214
2177
  workspace?: string;
2178
+ worktree_id?: string;
2215
2179
  acp_session_id?: string;
2216
2180
  state?: string;
2217
2181
  soul_snapshot_id?: string;
@@ -2235,12 +2199,14 @@ export interface MessageStartPatch {
2235
2199
  export interface MessageStartPayload {
2236
2200
  event: HookEvent;
2237
2201
  timestamp: ISODateTime;
2202
+ profile_id?: string;
2238
2203
  session_id?: string;
2239
2204
  session_name?: string;
2240
2205
  session_type?: string;
2241
2206
  agent_name?: string;
2242
2207
  workspace_id?: string;
2243
2208
  workspace?: string;
2209
+ worktree_id?: string;
2244
2210
  acp_session_id?: string;
2245
2211
  state?: string;
2246
2212
  soul_snapshot_id?: string;
@@ -2259,7 +2225,39 @@ export interface ModelSourceListParams {
2259
2225
  refresh?: boolean;
2260
2226
  include_stale?: boolean;
2261
2227
  }
2262
- export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
2228
+ export type ReasoningEffort = string;
2229
+ export type ModelSourceOptionKind = string;
2230
+ export interface ModelSourceOptionValue {
2231
+ value_id: string;
2232
+ label?: string;
2233
+ description?: string;
2234
+ group_id?: string;
2235
+ group_label?: string;
2236
+ order?: number;
2237
+ }
2238
+ export interface ModelSourceOptionDescriptor {
2239
+ id: string;
2240
+ label?: string;
2241
+ description?: string;
2242
+ category?: string;
2243
+ kind: ModelSourceOptionKind;
2244
+ current_value_id?: string;
2245
+ current_bool?: boolean;
2246
+ values?: ModelSourceOptionValue[];
2247
+ }
2248
+ export interface ModelSourceOptionSelection {
2249
+ id: string;
2250
+ value_id?: string;
2251
+ bool_value?: boolean;
2252
+ }
2253
+ export interface ModelSourceTransportBinding {
2254
+ transport_model_id: string;
2255
+ label?: string;
2256
+ reasoning_effort?: ReasoningEffort;
2257
+ fast?: boolean;
2258
+ thinking?: boolean;
2259
+ option_selections?: ModelSourceOptionSelection[];
2260
+ }
2263
2261
  export interface ModelCatalogCostPayload {
2264
2262
  input_per_million?: number;
2265
2263
  output_per_million?: number;
@@ -2284,6 +2282,8 @@ export interface ModelSourceRow {
2284
2282
  supports_reasoning?: boolean;
2285
2283
  reasoning_efforts?: ReasoningEffort[];
2286
2284
  default_reasoning_effort?: ReasoningEffort;
2285
+ config_options?: ModelSourceOptionDescriptor[];
2286
+ transport_bindings?: ModelSourceTransportBinding[];
2287
2287
  cost?: ModelCatalogCostPayload;
2288
2288
  deprecated?: boolean;
2289
2289
  hidden?: boolean;
@@ -2309,678 +2309,81 @@ export interface ModelsRefreshParams {
2309
2309
  export interface ModelsStatusParams {
2310
2310
  provider_id?: string;
2311
2311
  }
2312
- export interface NetworkChannelPayload {
2313
- channel: string;
2314
- workspace_id?: string;
2315
- purpose?: string;
2316
- fanout_policy?: string;
2317
- coordinator_peer_id?: string;
2318
- created_by?: string;
2319
- created_at?: ISODateTime;
2320
- peer_count: number;
2321
- local_peer_count?: number;
2322
- session_count?: number;
2323
- message_count?: number;
2324
- presence_count?: number;
2325
- historical_participant_count?: number;
2326
- last_activity_at?: ISODateTime;
2327
- last_presence_at?: ISODateTime;
2328
- last_message_preview?: string;
2329
- }
2330
- export interface NetworkChannelsParams {
2331
- workspace_id: string;
2312
+ export interface PersistenceHealth {
2313
+ status: string;
2314
+ global_db_size_bytes: number;
2315
+ session_db_size_bytes: number;
2332
2316
  }
2333
- export interface NetworkDirectMessagesParams {
2334
- workspace_id: string;
2335
- channel: string;
2336
- direct_id: string;
2337
- before?: string;
2338
- after?: string;
2339
- kind?: string;
2340
- work_id?: string;
2341
- limit?: number;
2317
+ export interface RetentionHealth {
2318
+ enabled: boolean;
2319
+ retention_days: number;
2320
+ sweep_interval_seconds: number;
2321
+ last_sweep_status: string;
2322
+ last_sweep_at?: ISODateTime;
2323
+ last_cutoff_at?: ISODateTime;
2324
+ last_sweep_error?: string;
2325
+ deleted_event_summaries: number;
2326
+ deleted_token_stats: number;
2327
+ deleted_token_usage_daily: number;
2328
+ deleted_permission_log_rows: number;
2342
2329
  }
2343
- export interface NetworkDirectResolveParams {
2344
- workspace_id: string;
2345
- channel: string;
2330
+ export type FailureKind = string;
2331
+ export interface SessionFailureHealth {
2346
2332
  session_id: string;
2347
- peer_id: string;
2348
- }
2349
- export interface NetworkConversationMessagePayload {
2350
- message_id: string;
2333
+ agent_name?: string;
2334
+ provider?: string;
2351
2335
  workspace_id?: string;
2352
- channel: string;
2353
- surface?: string;
2354
- thread_id?: string;
2355
- direct_id?: string;
2356
- kind: string;
2357
- direction: string;
2358
- peer_from: string;
2359
- peer_to?: string;
2360
- mentions?: string[];
2361
- display_name?: string;
2362
- session_id?: string;
2363
- local?: boolean;
2364
- work_id?: string;
2365
- reply_to?: string;
2366
- trace_id?: string;
2367
- causation_id?: string;
2368
- intent?: string;
2369
- text?: string;
2370
- preview_text?: string;
2371
- size_bytes?: number;
2372
- body: JSONValue;
2373
- timestamp: ISODateTime;
2336
+ state?: string;
2337
+ failure_kind: FailureKind;
2338
+ summary?: string;
2339
+ crash_bundle_path?: string;
2340
+ updated_at: ISODateTime;
2374
2341
  }
2375
- export interface CursorPagePayload {
2376
- next_cursor?: string;
2377
- has_more: boolean;
2378
- limit: number;
2342
+ export interface FailureHealth {
2343
+ status: string;
2344
+ total: number;
2345
+ by_kind?: Record<string, number>;
2346
+ recent?: SessionFailureHealth[];
2379
2347
  }
2380
- export interface NetworkDirectRoomMessagesResponse {
2381
- messages: NetworkConversationMessagePayload[];
2382
- page: CursorPagePayload;
2348
+ export interface ProbeResult {
2349
+ agent_name?: string;
2350
+ provider?: string;
2351
+ command?: string;
2352
+ executable?: string;
2353
+ status: string;
2354
+ error?: string;
2355
+ checked_at: ISODateTime;
2356
+ duration_ms: number;
2383
2357
  }
2384
- export interface NetworkDirectRoomOpenedPayload {
2385
- event: HookEvent;
2386
- timestamp: ISODateTime;
2387
- workspace_id?: string;
2358
+ export interface TaskQueueDepth {
2359
+ count: number;
2360
+ oldest_queued_at: ISODateTime;
2361
+ oldest_queue_age_ms: number;
2362
+ }
2363
+ export type OriginKind = string;
2364
+ export interface StuckTaskRun {
2365
+ task_id: string;
2366
+ run_id: string;
2367
+ status: RunStatus;
2368
+ origin_kind: OriginKind;
2388
2369
  session_id?: string;
2389
- channel?: string;
2390
- surface?: string;
2391
- thread_id?: string;
2392
- direct_id?: string;
2393
- message_id?: string;
2394
- kind?: string;
2395
- direction?: string;
2396
- work_id?: string;
2397
- work_state?: string;
2398
- peer_id?: string;
2399
- peer_from?: string;
2400
- peer_to?: string;
2401
- last_seen_at?: ISODateTime;
2402
- trace_id?: string;
2403
- causation_id?: string;
2404
- }
2405
- export interface NetworkDirectRoomPayload {
2406
- workspace_id?: string;
2407
- channel: string;
2408
- direct_id: string;
2409
- session_a: string;
2410
- session_b: string;
2411
- opened_at?: ISODateTime;
2412
- last_activity_at?: ISODateTime;
2413
- message_count: number;
2414
- open_work_count: number;
2415
- last_message_preview?: string;
2370
+ age_ms: number;
2416
2371
  }
2417
- export interface NetworkDirectRoomsResponse {
2418
- directs: NetworkDirectRoomPayload[];
2419
- page: CountedCursorPagePayload;
2372
+ export type Status = string;
2373
+ export interface TaskStatusTotal {
2374
+ scope: Scope;
2375
+ status: Status;
2376
+ count: number;
2420
2377
  }
2421
- export interface NetworkDirectsParams {
2422
- workspace_id: string;
2423
- channel: string;
2424
- query?: string;
2425
- peer_id?: string;
2426
- sort?: string;
2427
- has_work?: boolean;
2428
- limit?: number;
2429
- after?: string;
2378
+ export interface TaskRunTotal {
2379
+ status: RunStatus;
2380
+ origin_kind: OriginKind;
2381
+ count: number;
2430
2382
  }
2431
- export interface NetworkMatcher {
2432
- channel?: string;
2433
- surface?: string;
2434
- kind?: string;
2435
- direction?: string;
2436
- work_state?: string;
2437
- participation_mode?: string;
2438
- participation_source?: string;
2439
- }
2440
- export interface NetworkMessagePersistedPayload {
2441
- event: HookEvent;
2442
- timestamp: ISODateTime;
2443
- workspace_id?: string;
2444
- session_id?: string;
2445
- channel?: string;
2446
- surface?: string;
2447
- thread_id?: string;
2448
- direct_id?: string;
2449
- message_id?: string;
2450
- kind?: string;
2451
- direction?: string;
2452
- work_id?: string;
2453
- work_state?: string;
2454
- peer_id?: string;
2455
- peer_from?: string;
2456
- peer_to?: string;
2457
- last_seen_at?: ISODateTime;
2458
- trace_id?: string;
2459
- causation_id?: string;
2460
- }
2461
- export interface NetworkObservationPatch {
2462
- labels?: Record<string, string>;
2463
- }
2464
- export interface NetworkParticipationBounds {
2465
- max_wakes: number;
2466
- max_wake_wall_time: string;
2467
- max_total_wall_time: string;
2468
- max_input_tokens: number;
2469
- max_output_tokens: number;
2470
- max_wake_depth: number;
2471
- coalesce_window: string;
2472
- }
2473
- export interface NetworkParticipationBoundsRequest {
2474
- max_wakes?: number;
2475
- max_wake_wall_time?: string;
2476
- max_total_wall_time?: string;
2477
- max_input_tokens?: number;
2478
- max_output_tokens?: number;
2479
- max_wake_depth?: number;
2480
- coalesce_window?: string;
2481
- }
2482
- export type NetworkParticipationChannelStrategy = "named" | "run" | "loop_run";
2483
- export type NetworkParticipationMode = "local" | "live";
2484
- export type NetworkParticipationOwnerKind = "session" | "task_run" | "loop_run" | "automation_run";
2485
- export interface NetworkParticipationPreResolvePatch {
2486
- deny?: boolean;
2487
- deny_reason?: string;
2488
- request?: NetworkParticipationRequest;
2489
- }
2490
- export interface NetworkParticipationOwnerRef {
2491
- workspace_id: string;
2492
- kind: NetworkParticipationOwnerKind;
2493
- id: string;
2494
- }
2495
- export type NetworkParticipationSource = "explicit_request" | "task_profile" | "workspace_coordination" | "loop_definition" | "automation_job" | "built_in_local";
2496
- export interface NetworkParticipationPreResolvePayload {
2497
- workspace_id: string;
2498
- owner: NetworkParticipationOwnerRef;
2499
- request?: NetworkParticipationRequest;
2500
- source?: NetworkParticipationSource;
2501
- owner_key?: string;
2502
- }
2503
- export type NetworkParticipationResolvedPatch = Record<string, never>;
2504
- export interface NetworkParticipationResolvedPayload {
2505
- workspace_id: string;
2506
- owner: NetworkParticipationOwnerRef;
2507
- owner_key?: string;
2508
- resolved_network_participation: NetworkParticipationSpec;
2509
- }
2510
- export interface NetworkPayload {
2511
- event: HookEvent;
2512
- timestamp: ISODateTime;
2513
- workspace_id?: string;
2514
- session_id?: string;
2515
- channel?: string;
2516
- surface?: string;
2517
- thread_id?: string;
2518
- direct_id?: string;
2519
- message_id?: string;
2520
- kind?: string;
2521
- direction?: string;
2522
- work_id?: string;
2523
- work_state?: string;
2524
- peer_id?: string;
2525
- peer_from?: string;
2526
- peer_to?: string;
2527
- last_seen_at?: ISODateTime;
2528
- trace_id?: string;
2529
- causation_id?: string;
2530
- }
2531
- export interface NetworkPeerJoinedPayload {
2532
- event: HookEvent;
2533
- timestamp: ISODateTime;
2534
- workspace_id?: string;
2535
- session_id?: string;
2536
- channel?: string;
2537
- surface?: string;
2538
- thread_id?: string;
2539
- direct_id?: string;
2540
- message_id?: string;
2541
- kind?: string;
2542
- direction?: string;
2543
- work_id?: string;
2544
- work_state?: string;
2545
- peer_id?: string;
2546
- peer_from?: string;
2547
- peer_to?: string;
2548
- last_seen_at?: ISODateTime;
2549
- trace_id?: string;
2550
- causation_id?: string;
2551
- }
2552
- export interface NetworkPeerLeftPayload {
2553
- event: HookEvent;
2554
- timestamp: ISODateTime;
2555
- workspace_id?: string;
2556
- session_id?: string;
2557
- channel?: string;
2558
- surface?: string;
2559
- thread_id?: string;
2560
- direct_id?: string;
2561
- message_id?: string;
2562
- kind?: string;
2563
- direction?: string;
2564
- work_id?: string;
2565
- work_state?: string;
2566
- peer_id?: string;
2567
- peer_from?: string;
2568
- peer_to?: string;
2569
- last_seen_at?: ISODateTime;
2570
- trace_id?: string;
2571
- causation_id?: string;
2572
- }
2573
- export interface NetworkCapabilityBriefPayload {
2574
- id: string;
2575
- summary: string;
2576
- }
2577
- export interface NetworkPeerCardPayload {
2578
- peer_id: string;
2579
- display_name?: string;
2580
- profiles_supported: string[];
2581
- capabilities: NetworkCapabilityBriefPayload[];
2582
- artifacts_supported: string[];
2583
- trust_modes_supported: string[];
2584
- ext?: Record<string, JSONValue>;
2585
- }
2586
- export interface NetworkPeerPayload {
2587
- workspace_id?: string;
2588
- session_id?: string;
2589
- peer_id: string;
2590
- display_name?: string;
2591
- channel: string;
2592
- local: boolean;
2593
- peer_card: NetworkPeerCardPayload;
2594
- joined_at?: ISODateTime;
2595
- presence_state: string;
2596
- }
2597
- export interface NetworkPeersParams {
2598
- workspace_id: string;
2599
- channel?: string;
2600
- }
2601
- export interface NetworkSendParams {
2602
- workspace_id?: string;
2603
- session_id: string;
2604
- channel: string;
2605
- surface?: string;
2606
- thread_id?: string;
2607
- direct_id?: string;
2608
- kind: string;
2609
- to?: string;
2610
- mentions?: string[];
2611
- body: JSONValue;
2612
- work_id?: string;
2613
- reply_to?: string;
2614
- trace_id?: string;
2615
- causation_id?: string;
2616
- expires_at?: number;
2617
- id?: string;
2618
- ext?: Record<string, JSONValue>;
2619
- }
2620
- export interface NetworkSendPayload {
2621
- id: string;
2622
- workspace_id?: string;
2623
- session_id: string;
2624
- channel: string;
2625
- surface?: string;
2626
- thread_id?: string;
2627
- direct_id?: string;
2628
- kind: string;
2629
- to?: string;
2630
- mentions?: string[];
2631
- work_id?: string;
2632
- reply_to?: string;
2633
- trace_id?: string;
2634
- causation_id?: string;
2635
- expires_at?: number;
2636
- ext?: Record<string, JSONValue>;
2637
- }
2638
- export interface DeclaredNetworkChannelPayload {
2639
- activation_id?: string;
2640
- extension_name?: string;
2641
- bundle_name?: string;
2642
- profile_name?: string;
2643
- workspace_id?: string;
2644
- name: string;
2645
- description?: string;
2646
- primary?: boolean;
2647
- }
2648
- export interface NetworkKindMetricPayload {
2649
- kind: string;
2650
- sent: number;
2651
- received: number;
2652
- rejected: number;
2653
- delivered: number;
2654
- }
2655
- export interface NetworkStatusPayload {
2656
- enabled: boolean;
2657
- status: string;
2658
- local_peers: number;
2659
- channels: number;
2660
- messages_sent: number;
2661
- messages_received: number;
2662
- messages_rejected: number;
2663
- messages_delivered: number;
2664
- workflow_tagged_events: number;
2665
- handoff_tagged_events: number;
2666
- open_threads: number;
2667
- open_direct_rooms: number;
2668
- open_work_items: number;
2669
- conversation_messages: number;
2670
- work_transitions: number;
2671
- direct_resolves: number;
2672
- declared_channels: DeclaredNetworkChannelPayload[];
2673
- kind_metrics: NetworkKindMetricPayload[];
2674
- }
2675
- export interface NetworkThreadMessagesParams {
2676
- workspace_id: string;
2677
- channel: string;
2678
- thread_id: string;
2679
- before?: string;
2680
- after?: string;
2681
- kind?: string;
2682
- work_id?: string;
2683
- limit?: number;
2684
- }
2685
- export interface NetworkThreadMessagesResponse {
2686
- messages: NetworkConversationMessagePayload[];
2687
- page: CursorPagePayload;
2688
- }
2689
- export interface NetworkThreadOpenedPayload {
2690
- event: HookEvent;
2691
- timestamp: ISODateTime;
2692
- workspace_id?: string;
2693
- session_id?: string;
2694
- channel?: string;
2695
- surface?: string;
2696
- thread_id?: string;
2697
- direct_id?: string;
2698
- message_id?: string;
2699
- kind?: string;
2700
- direction?: string;
2701
- work_id?: string;
2702
- work_state?: string;
2703
- peer_id?: string;
2704
- peer_from?: string;
2705
- peer_to?: string;
2706
- last_seen_at?: ISODateTime;
2707
- trace_id?: string;
2708
- causation_id?: string;
2709
- }
2710
- export interface NetworkCoordinationCostPayload {
2711
- delivered_count?: number;
2712
- prompt_size_bytes?: number;
2713
- estimated_prompt_tokens?: number;
2714
- }
2715
- export interface NetworkThreadSummaryPayload {
2716
- workspace_id?: string;
2717
- channel: string;
2718
- thread_id: string;
2719
- root_message_id: string;
2720
- title?: string;
2721
- opened_by_peer_id?: string;
2722
- opened_session_id?: string;
2723
- opened_at?: ISODateTime;
2724
- last_activity_at?: ISODateTime;
2725
- message_count: number;
2726
- participant_count: number;
2727
- open_work_count: number;
2728
- coordination_cost?: NetworkCoordinationCostPayload;
2729
- last_message_preview?: string;
2730
- }
2731
- export interface NetworkThreadTargetParams {
2732
- workspace_id: string;
2733
- channel: string;
2734
- thread_id: string;
2735
- }
2736
- export interface NetworkThreadsParams {
2737
- workspace_id: string;
2738
- channel: string;
2739
- query?: string;
2740
- peer_id?: string;
2741
- sort?: string;
2742
- has_work?: boolean;
2743
- limit?: number;
2744
- after?: string;
2745
- }
2746
- export interface NetworkThreadsResponse {
2747
- threads: NetworkThreadSummaryPayload[];
2748
- page: CountedCursorPagePayload;
2749
- }
2750
- export interface NetworkUsageParams {
2751
- workspace_id: string;
2752
- owner_kind?: string;
2753
- owner_id?: string;
2754
- run_id?: string;
2755
- channel?: string;
2756
- cursor?: string;
2757
- limit?: number;
2758
- }
2759
- export interface NetworkParticipationStatus {
2760
- owner: NetworkParticipationOwnerRef;
2761
- available: boolean;
2762
- participating: boolean;
2763
- reason?: string;
2764
- }
2765
- export interface NetworkUsageDetailPayload {
2766
- wake_id: string;
2767
- task_run_id: string;
2768
- participation_status: NetworkParticipationStatus;
2769
- workspace_id: string;
2770
- channel: string;
2771
- root_id: string;
2772
- depth: number;
2773
- state: string;
2774
- usage_state: string;
2775
- charged_wall_time: string;
2776
- input_tokens: number;
2777
- output_tokens: number;
2778
- reserved_at: ISODateTime;
2779
- settled_at?: ISODateTime;
2780
- reason?: string;
2781
- }
2782
- export interface NetworkUsageSummaryPayload {
2783
- wake_count: number;
2784
- reserved_wake_count: number;
2785
- actual_wake_count: number;
2786
- unavailable_wake_count: number;
2787
- charged_wall_time: string;
2788
- input_tokens: number;
2789
- output_tokens: number;
2790
- }
2791
- export interface NetworkBudgetUsagePayload {
2792
- participation_status: NetworkParticipationStatus;
2793
- wakes_used: number;
2794
- wall_time_used: string;
2795
- input_tokens_used: number;
2796
- output_tokens_used: number;
2797
- exhausted_reason?: string;
2798
- updated_at: ISODateTime;
2799
- }
2800
- export interface NetworkUsageResponse {
2801
- workspace_id: string;
2802
- details: NetworkUsageDetailPayload[];
2803
- total: NetworkUsageSummaryPayload;
2804
- budget?: NetworkBudgetUsagePayload;
2805
- next_cursor?: string;
2806
- }
2807
- export interface NetworkWorkClosedPayload {
2808
- event: HookEvent;
2809
- timestamp: ISODateTime;
2810
- workspace_id?: string;
2811
- session_id?: string;
2812
- channel?: string;
2813
- surface?: string;
2814
- thread_id?: string;
2815
- direct_id?: string;
2816
- message_id?: string;
2817
- kind?: string;
2818
- direction?: string;
2819
- work_id?: string;
2820
- work_state?: string;
2821
- peer_id?: string;
2822
- peer_from?: string;
2823
- peer_to?: string;
2824
- last_seen_at?: ISODateTime;
2825
- trace_id?: string;
2826
- causation_id?: string;
2827
- }
2828
- export interface NetworkWorkGetParams {
2829
- workspace_id: string;
2830
- work_id: string;
2831
- }
2832
- export interface NetworkWorkOpenedPayload {
2833
- event: HookEvent;
2834
- timestamp: ISODateTime;
2835
- workspace_id?: string;
2836
- session_id?: string;
2837
- channel?: string;
2838
- surface?: string;
2839
- thread_id?: string;
2840
- direct_id?: string;
2841
- message_id?: string;
2842
- kind?: string;
2843
- direction?: string;
2844
- work_id?: string;
2845
- work_state?: string;
2846
- peer_id?: string;
2847
- peer_from?: string;
2848
- peer_to?: string;
2849
- last_seen_at?: ISODateTime;
2850
- trace_id?: string;
2851
- causation_id?: string;
2852
- }
2853
- export interface NetworkWorkPayload {
2854
- work_id: string;
2855
- workspace_id?: string;
2856
- channel: string;
2857
- surface: string;
2858
- thread_id?: string;
2859
- direct_id?: string;
2860
- opened_session_id?: string;
2861
- target_session_id?: string;
2862
- state: string;
2863
- opened_at?: ISODateTime;
2864
- last_activity_at?: ISODateTime;
2865
- terminal_at?: ISODateTime;
2866
- }
2867
- export interface NetworkWorkTransitionedPayload {
2868
- event: HookEvent;
2869
- timestamp: ISODateTime;
2870
- workspace_id?: string;
2871
- session_id?: string;
2872
- channel?: string;
2873
- surface?: string;
2874
- thread_id?: string;
2875
- direct_id?: string;
2876
- message_id?: string;
2877
- kind?: string;
2878
- direction?: string;
2879
- work_id?: string;
2880
- work_state?: string;
2881
- peer_id?: string;
2882
- peer_from?: string;
2883
- peer_to?: string;
2884
- last_seen_at?: ISODateTime;
2885
- trace_id?: string;
2886
- causation_id?: string;
2887
- }
2888
- export interface PersistenceHealth {
2889
- status: string;
2890
- global_db_size_bytes: number;
2891
- session_db_size_bytes: number;
2892
- }
2893
- export interface RetentionHealth {
2894
- enabled: boolean;
2895
- retention_days: number;
2896
- sweep_interval_seconds: number;
2897
- last_sweep_status: string;
2898
- last_sweep_at?: ISODateTime;
2899
- last_cutoff_at?: ISODateTime;
2900
- last_sweep_error?: string;
2901
- deleted_event_summaries: number;
2902
- deleted_token_stats: number;
2903
- deleted_token_usage_daily: number;
2904
- deleted_permission_log_rows: number;
2905
- }
2906
- export type FailureKind = string;
2907
- export interface SessionFailureHealth {
2908
- session_id: string;
2909
- agent_name?: string;
2910
- provider?: string;
2911
- workspace_id?: string;
2912
- state?: string;
2913
- failure_kind: FailureKind;
2914
- summary?: string;
2915
- crash_bundle_path?: string;
2916
- updated_at: ISODateTime;
2917
- }
2918
- export interface FailureHealth {
2919
- status: string;
2920
- total: number;
2921
- by_kind?: Record<string, number>;
2922
- recent?: SessionFailureHealth[];
2923
- }
2924
- export interface ProbeResult {
2925
- agent_name?: string;
2926
- provider?: string;
2927
- command?: string;
2928
- executable?: string;
2929
- status: string;
2930
- error?: string;
2931
- checked_at: ISODateTime;
2932
- duration_ms: number;
2933
- }
2934
- export interface BridgeStatusCounts {
2935
- disabled: number;
2936
- starting: number;
2937
- ready: number;
2938
- degraded: number;
2939
- auth_required: number;
2940
- error: number;
2941
- }
2942
- export interface BridgeAggregateHealth {
2943
- total_instances: number;
2944
- route_count: number;
2945
- delivery_backlog: number;
2946
- delivery_dropped_total: number;
2947
- delivery_failures_total: number;
2948
- auth_failures_total: number;
2949
- status_counts: BridgeStatusCounts;
2950
- }
2951
- export interface TaskQueueDepth {
2952
- channel_id?: string;
2953
- count: number;
2954
- oldest_queued_at: ISODateTime;
2955
- oldest_queue_age_ms: number;
2956
- }
2957
- export type OriginKind = string;
2958
- export interface StuckTaskRun {
2959
- task_id: string;
2960
- run_id: string;
2961
- status: RunStatus;
2962
- origin_kind: OriginKind;
2963
- channel_id?: string;
2964
- session_id?: string;
2965
- age_ms: number;
2966
- }
2967
- export type Status = string;
2968
- export interface TaskStatusTotal {
2969
- scope: Scope;
2970
- status: Status;
2971
- channel_id?: string;
2972
- count: number;
2973
- }
2974
- export interface TaskRunTotal {
2975
- status: RunStatus;
2976
- origin_kind: OriginKind;
2977
- channel_id?: string;
2978
- count: number;
2979
- }
2980
- export interface TaskOwnerTotal {
2981
- owner_kind: OwnerKind;
2982
- owner_ref: string;
2983
- count: number;
2383
+ export interface TaskOwnerTotal {
2384
+ owner_kind: OwnerKind;
2385
+ owner_ref: string;
2386
+ count: number;
2984
2387
  }
2985
2388
  export interface TaskRecoveryTotals {
2986
2389
  requeued: number;
@@ -2999,8 +2402,6 @@ export interface TaskHealth {
2999
2402
  run_totals?: TaskRunTotal[];
3000
2403
  owner_totals?: TaskOwnerTotal[];
3001
2404
  forced_stops_since_start: number;
3002
- duplicate_ingress_since_start: number;
3003
- channel_mismatch_since_start: number;
3004
2405
  recovery_since_start: TaskRecoveryTotals;
3005
2406
  }
3006
2407
  export interface SessionActivityHealth {
@@ -3033,7 +2434,6 @@ export interface ObserveHealth {
3033
2434
  retention: RetentionHealth;
3034
2435
  failures: FailureHealth;
3035
2436
  agent_probes?: ProbeResult[];
3036
- bridges: BridgeAggregateHealth;
3037
2437
  tasks: TaskHealth;
3038
2438
  activities?: SessionActivityHealth[];
3039
2439
  version: string;
@@ -3058,12 +2458,14 @@ export interface PermissionToolCall {
3058
2458
  export interface PermissionDeniedPayload {
3059
2459
  event: HookEvent;
3060
2460
  timestamp: ISODateTime;
2461
+ profile_id?: string;
3061
2462
  session_id?: string;
3062
2463
  session_name?: string;
3063
2464
  session_type?: string;
3064
2465
  agent_name?: string;
3065
2466
  workspace_id?: string;
3066
2467
  workspace?: string;
2468
+ worktree_id?: string;
3067
2469
  acp_session_id?: string;
3068
2470
  state?: string;
3069
2471
  soul_snapshot_id?: string;
@@ -3076,7 +2478,6 @@ export interface PermissionDeniedPayload {
3076
2478
  resource?: string;
3077
2479
  decision?: string;
3078
2480
  decision_class?: string;
3079
- tool_input?: JSONValue;
3080
2481
  tool_call: PermissionToolCall;
3081
2482
  }
3082
2483
  export interface PermissionOption {
@@ -3095,12 +2496,14 @@ export interface PermissionRequestPatch {
3095
2496
  export interface PermissionRequestPayload {
3096
2497
  event: HookEvent;
3097
2498
  timestamp: ISODateTime;
2499
+ profile_id?: string;
3098
2500
  session_id?: string;
3099
2501
  session_name?: string;
3100
2502
  session_type?: string;
3101
2503
  agent_name?: string;
3102
2504
  workspace_id?: string;
3103
2505
  workspace?: string;
2506
+ worktree_id?: string;
3104
2507
  acp_session_id?: string;
3105
2508
  state?: string;
3106
2509
  soul_snapshot_id?: string;
@@ -3120,12 +2523,14 @@ export interface PermissionRequestPayload {
3120
2523
  export interface PermissionResolutionPayload {
3121
2524
  event: HookEvent;
3122
2525
  timestamp: ISODateTime;
2526
+ profile_id?: string;
3123
2527
  session_id?: string;
3124
2528
  session_name?: string;
3125
2529
  session_type?: string;
3126
2530
  agent_name?: string;
3127
2531
  workspace_id?: string;
3128
2532
  workspace?: string;
2533
+ worktree_id?: string;
3129
2534
  acp_session_id?: string;
3130
2535
  state?: string;
3131
2536
  soul_snapshot_id?: string;
@@ -3145,12 +2550,14 @@ export type PermissionResolvedPatch = Record<string, never>;
3145
2550
  export interface PermissionResolvedPayload {
3146
2551
  event: HookEvent;
3147
2552
  timestamp: ISODateTime;
2553
+ profile_id?: string;
3148
2554
  session_id?: string;
3149
2555
  session_name?: string;
3150
2556
  session_type?: string;
3151
2557
  agent_name?: string;
3152
2558
  workspace_id?: string;
3153
2559
  workspace?: string;
2560
+ worktree_id?: string;
3154
2561
  acp_session_id?: string;
3155
2562
  state?: string;
3156
2563
  soul_snapshot_id?: string;
@@ -3171,8 +2578,6 @@ export interface PermissionSet {
3171
2578
  skills?: string[];
3172
2579
  mcp_servers?: string[];
3173
2580
  workspace_paths?: string[];
3174
- network_channels?: string[];
3175
- sandbox_profiles?: string[];
3176
2581
  }
3177
2582
  export interface PromptPatch {
3178
2583
  deny?: boolean;
@@ -3183,12 +2588,14 @@ export interface PromptPatch {
3183
2588
  export interface PromptPayload {
3184
2589
  event: HookEvent;
3185
2590
  timestamp: ISODateTime;
2591
+ profile_id?: string;
3186
2592
  session_id?: string;
3187
2593
  session_name?: string;
3188
2594
  session_type?: string;
3189
2595
  agent_name?: string;
3190
2596
  workspace_id?: string;
3191
2597
  workspace?: string;
2598
+ worktree_id?: string;
3192
2599
  acp_session_id?: string;
3193
2600
  state?: string;
3194
2601
  soul_snapshot_id?: string;
@@ -3208,6 +2615,28 @@ export interface ModelCatalogSourceRefPayload {
3208
2615
  stale: boolean;
3209
2616
  last_error?: string;
3210
2617
  }
2618
+ export interface SessionConfigOptionValuePayload {
2619
+ value: string;
2620
+ label?: string;
2621
+ description?: string;
2622
+ group_id?: string;
2623
+ group_label?: string;
2624
+ }
2625
+ export interface SessionConfigOptionPayload {
2626
+ id: string;
2627
+ label?: string;
2628
+ description?: string;
2629
+ category?: string;
2630
+ kind: string;
2631
+ current_value_id?: string;
2632
+ current_bool?: boolean;
2633
+ values?: SessionConfigOptionValuePayload[];
2634
+ }
2635
+ export interface ProviderModelConfigurationPayload {
2636
+ reasoning_effort?: ReasoningEffort;
2637
+ fast?: boolean;
2638
+ thinking?: boolean;
2639
+ }
3211
2640
  export type ReasoningSource = "acp" | "catalog";
3212
2641
  export interface ProviderModelPayload {
3213
2642
  provider_id: string;
@@ -3225,12 +2654,16 @@ export interface ProviderModelPayload {
3225
2654
  supports_reasoning?: boolean;
3226
2655
  reasoning_efforts?: ReasoningEffort[];
3227
2656
  default_reasoning_effort?: ReasoningEffort;
2657
+ config_options?: SessionConfigOptionPayload[];
2658
+ configurations?: ProviderModelConfigurationPayload[];
3228
2659
  cost?: ModelCatalogCostPayload;
3229
2660
  curated: boolean;
3230
2661
  deprecated: boolean;
3231
2662
  hidden: boolean;
3232
2663
  featured: boolean;
3233
2664
  release_date?: string;
2665
+ reasoning_known?: boolean;
2666
+ reasoning_apply?: string;
3234
2667
  reasoning_source?: ReasoningSource;
3235
2668
  last_error?: string;
3236
2669
  }
@@ -3305,6 +2738,7 @@ export interface ResourcesSnapshotParams {
3305
2738
  }
3306
2739
  export interface Run {
3307
2740
  id: string;
2741
+ profile_id?: string;
3308
2742
  job_id?: string;
3309
2743
  trigger_id?: string;
3310
2744
  session_id?: string;
@@ -3320,211 +2754,40 @@ export interface Run {
3320
2754
  error?: string;
3321
2755
  delivery_error?: string;
3322
2756
  delivery_error_at?: ISODateTime;
3323
- network_participation?: NetworkParticipationRequest;
3324
2757
  metadata?: Record<string, JSONValue>;
3325
2758
  }
3326
- export interface SandboxExecParams {
3327
- workspace_id: string;
3328
- session_id: string;
3329
- command: string;
3330
- timeout?: number;
3331
- }
3332
- export interface SandboxExecResult {
3333
- exit_code: number;
3334
- stdout?: string;
3335
- stderr?: string;
3336
- }
3337
- export interface SandboxInfoParams {
3338
- workspace_id: string;
3339
- session_id: string;
3340
- }
3341
- export interface SandboxInfoResult {
3342
- sandbox_id: string;
3343
- backend: string;
3344
- profile: string;
3345
- instance_id: string;
3346
- runtime_root: string;
3347
- sync_state: string;
3348
- created_at: ISODateTime;
3349
- last_sync_error: string;
3350
- }
3351
- export interface SandboxListParams {
3352
- workspace?: string;
3353
- }
3354
- export interface SandboxSummary {
3355
- session_id: string;
3356
- sandbox_id: string;
3357
- backend: string;
3358
- profile?: string;
3359
- instance_id?: string;
3360
- state: string;
3361
- sync_state?: string;
3362
- }
3363
- export interface SandboxListResult {
3364
- sandboxes: SandboxSummary[];
3365
- }
3366
- export type SandboxObservationPatch = Record<string, never>;
3367
- export interface SandboxPreparePatch {
3368
- deny?: boolean;
3369
- deny_reason?: string;
3370
- env_overrides?: Record<string, string>;
3371
- }
3372
- export interface SandboxProfilePayload {
3373
- profile?: string;
3374
- backend?: string;
3375
- sync_mode?: string;
3376
- persistence?: string;
3377
- runtime_root?: string;
3378
- destroy_on_stop?: boolean;
3379
- env?: Record<string, string>;
3380
- secret_env?: Record<string, string>;
3381
- }
3382
- export interface SandboxPreparePayload {
3383
- event: HookEvent;
3384
- timestamp: ISODateTime;
3385
- session_id?: string;
3386
- session_name?: string;
3387
- session_type?: string;
3388
- agent_name?: string;
3389
- workspace_id?: string;
3390
- workspace?: string;
3391
- acp_session_id?: string;
3392
- state?: string;
3393
- soul_snapshot_id?: string;
3394
- soul_digest?: string;
3395
- created_at: ISODateTime;
3396
- updated_at: ISODateTime;
3397
- sandbox_id?: string;
3398
- backend?: string;
3399
- profile: SandboxProfilePayload;
3400
- local_root?: string;
3401
- local_additional_dirs?: string[];
3402
- agent_command?: string;
3403
- agent_env?: string[];
3404
- permissions?: string;
3405
- resume_acp_state?: string;
3406
- env_overrides?: Record<string, string>;
3407
- denied?: boolean;
3408
- deny_reason?: string;
3409
- }
3410
- export type SandboxReadyPatch = Record<string, never>;
3411
- export interface SandboxReadyPayload {
3412
- event: HookEvent;
3413
- timestamp: ISODateTime;
3414
- session_id?: string;
3415
- session_name?: string;
3416
- session_type?: string;
3417
- agent_name?: string;
3418
- workspace_id?: string;
3419
- workspace?: string;
3420
- acp_session_id?: string;
3421
- state?: string;
3422
- soul_snapshot_id?: string;
3423
- soul_digest?: string;
3424
- created_at: ISODateTime;
3425
- updated_at: ISODateTime;
3426
- sandbox_id?: string;
3427
- backend?: string;
3428
- profile?: string;
3429
- instance_id?: string;
3430
- runtime_root?: string;
3431
- runtime_additional_dirs?: string[];
3432
- }
3433
- export interface SandboxStopPatch {
3434
- deny?: boolean;
3435
- deny_reason?: string;
3436
- }
3437
- export interface SandboxStopPayload {
2759
+ export interface SessionAttentionChangedPayload {
3438
2760
  event: HookEvent;
3439
2761
  timestamp: ISODateTime;
2762
+ profile_id?: string;
3440
2763
  session_id?: string;
3441
2764
  session_name?: string;
3442
2765
  session_type?: string;
3443
2766
  agent_name?: string;
3444
2767
  workspace_id?: string;
3445
2768
  workspace?: string;
2769
+ worktree_id?: string;
3446
2770
  acp_session_id?: string;
3447
2771
  state?: string;
3448
2772
  soul_snapshot_id?: string;
3449
2773
  soul_digest?: string;
3450
2774
  created_at: ISODateTime;
3451
2775
  updated_at: ISODateTime;
3452
- sandbox_id?: string;
3453
- backend?: string;
3454
- profile?: string;
3455
- instance_id?: string;
3456
- runtime_root?: string;
3457
- stop_reason?: string;
3458
- will_destroy?: boolean;
3459
- denied?: boolean;
3460
- deny_reason?: string;
3461
- }
3462
- export type SandboxSyncAfterPatch = Record<string, never>;
3463
- export interface SandboxSyncAfterPayload {
3464
- event: HookEvent;
3465
- timestamp: ISODateTime;
3466
- session_id?: string;
3467
- session_name?: string;
3468
- session_type?: string;
3469
- agent_name?: string;
3470
- workspace_id?: string;
3471
- workspace?: string;
3472
- acp_session_id?: string;
3473
- state?: string;
3474
- soul_snapshot_id?: string;
3475
- soul_digest?: string;
3476
- created_at: ISODateTime;
3477
- updated_at: ISODateTime;
3478
- sandbox_id?: string;
3479
- backend?: string;
3480
- profile?: string;
3481
- instance_id?: string;
3482
- runtime_root?: string;
3483
- direction?: string;
3484
- reason?: string;
3485
- files_synced?: number;
3486
- bytes_transferred?: number;
3487
- duration_ms?: number;
3488
- errors?: string[];
3489
- }
3490
- export interface SandboxSyncBeforePatch {
3491
- deny?: boolean;
3492
- deny_reason?: string;
3493
- exclude_patterns?: string[];
3494
- }
3495
- export interface SandboxSyncBeforePayload {
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
- direction?: string;
3516
- reason?: string;
3517
- exclude_patterns?: string[];
3518
- denied?: boolean;
3519
- deny_reason?: string;
2776
+ from: string;
2777
+ to: string;
2778
+ class: string;
2779
+ at: ISODateTime;
3520
2780
  }
2781
+ export type SessionAttentionObservationPatch = Record<string, never>;
3521
2782
  export interface SessionContext {
2783
+ profile_id?: string;
3522
2784
  session_id?: string;
3523
2785
  session_name?: string;
3524
2786
  session_type?: string;
3525
2787
  agent_name?: string;
3526
2788
  workspace_id?: string;
3527
2789
  workspace?: string;
2790
+ worktree_id?: string;
3528
2791
  acp_session_id?: string;
3529
2792
  state?: string;
3530
2793
  soul_snapshot_id?: string;
@@ -3569,12 +2832,14 @@ export interface SessionHealthResponse {
3569
2832
  export interface SessionHealthUpdateAfterPayload {
3570
2833
  event: HookEvent;
3571
2834
  timestamp: ISODateTime;
2835
+ profile_id?: string;
3572
2836
  session_id?: string;
3573
2837
  session_name?: string;
3574
2838
  session_type?: string;
3575
2839
  agent_name?: string;
3576
2840
  workspace_id?: string;
3577
2841
  workspace?: string;
2842
+ worktree_id?: string;
3578
2843
  acp_session_id?: string;
3579
2844
  state?: string;
3580
2845
  soul_snapshot_id?: string;
@@ -3590,6 +2855,69 @@ export interface SessionHealthUpdateAfterPayload {
3590
2855
  last_presence_at: ISODateTime;
3591
2856
  last_error?: string;
3592
2857
  }
2858
+ export type SteerDeliveryMode = "injected" | "pending_injection" | "interrupt_fallback";
2859
+ export type PromptMode = string;
2860
+ export type PromptDelivery = string;
2861
+ export type Speed = string;
2862
+ export interface AgentACPOptionSelection {
2863
+ id: string;
2864
+ value_id?: string;
2865
+ bool_value?: boolean;
2866
+ }
2867
+ export interface PromptRuntimeSelectionPayload {
2868
+ provider: string;
2869
+ model?: string;
2870
+ reasoning_effort?: ReasoningEffort;
2871
+ speed?: Speed;
2872
+ acp_options?: AgentACPOptionSelection[];
2873
+ }
2874
+ export interface SessionInput {
2875
+ steer_delivery?: SteerDeliveryMode;
2876
+ id: string;
2877
+ session_id: string;
2878
+ message_id?: string;
2879
+ idempotency_key?: string;
2880
+ target_turn_id?: string;
2881
+ status: string;
2882
+ mode: PromptMode;
2883
+ delivery: PromptDelivery;
2884
+ text: string;
2885
+ queue_generation: number;
2886
+ enqueued_at: ISODateTime;
2887
+ runtime?: PromptRuntimeSelectionPayload;
2888
+ }
2889
+ export interface SessionInputListResult {
2890
+ inputs: SessionInput[];
2891
+ }
2892
+ export interface SessionInputPromoteParams {
2893
+ workspace_id: string;
2894
+ session_id: string;
2895
+ queue_entry_id: string;
2896
+ text: string;
2897
+ message_id: string;
2898
+ idempotency_key: string;
2899
+ expected_turn_id: string;
2900
+ }
2901
+ export interface SessionInputReplaceParams {
2902
+ workspace_id: string;
2903
+ session_id: string;
2904
+ queue_entry_id: string;
2905
+ text: string;
2906
+ message_id: string;
2907
+ idempotency_key: string;
2908
+ }
2909
+ export interface SessionInputResult {
2910
+ input: SessionInput;
2911
+ }
2912
+ export interface SessionInputTargetParams {
2913
+ workspace_id: string;
2914
+ session_id: string;
2915
+ queue_entry_id: string;
2916
+ }
2917
+ export interface SessionInputsListParams {
2918
+ workspace_id: string;
2919
+ session_id: string;
2920
+ }
3593
2921
  export interface SessionInspectResponse {
3594
2922
  session_id: string;
3595
2923
  health: SessionHealthPayload;
@@ -3602,12 +2930,14 @@ export interface SessionInspectResponse {
3602
2930
  export interface SessionLifecyclePayload {
3603
2931
  event: HookEvent;
3604
2932
  timestamp: ISODateTime;
2933
+ profile_id?: string;
3605
2934
  session_id?: string;
3606
2935
  session_name?: string;
3607
2936
  session_type?: string;
3608
2937
  agent_name?: string;
3609
2938
  workspace_id?: string;
3610
2939
  workspace?: string;
2940
+ worktree_id?: string;
3611
2941
  acp_session_id?: string;
3612
2942
  state?: string;
3613
2943
  soul_snapshot_id?: string;
@@ -3618,12 +2948,14 @@ export interface SessionLifecyclePayload {
3618
2948
  export interface SessionMessagePersistedPayload {
3619
2949
  event: HookEvent;
3620
2950
  timestamp: ISODateTime;
2951
+ profile_id?: string;
3621
2952
  session_id?: string;
3622
2953
  session_name?: string;
3623
2954
  session_type?: string;
3624
2955
  agent_name?: string;
3625
2956
  workspace_id?: string;
3626
2957
  workspace?: string;
2958
+ worktree_id?: string;
3627
2959
  acp_session_id?: string;
3628
2960
  state?: string;
3629
2961
  soul_snapshot_id?: string;
@@ -3654,12 +2986,14 @@ export interface SessionPostCreatePatch {
3654
2986
  export interface SessionPostCreatePayload {
3655
2987
  event: HookEvent;
3656
2988
  timestamp: ISODateTime;
2989
+ profile_id?: string;
3657
2990
  session_id?: string;
3658
2991
  session_name?: string;
3659
2992
  session_type?: string;
3660
2993
  agent_name?: string;
3661
2994
  workspace_id?: string;
3662
2995
  workspace?: string;
2996
+ worktree_id?: string;
3663
2997
  acp_session_id?: string;
3664
2998
  state?: string;
3665
2999
  soul_snapshot_id?: string;
@@ -3679,12 +3013,14 @@ export interface SessionPostResumePatch {
3679
3013
  export interface SessionPostResumePayload {
3680
3014
  event: HookEvent;
3681
3015
  timestamp: ISODateTime;
3016
+ profile_id?: string;
3682
3017
  session_id?: string;
3683
3018
  session_name?: string;
3684
3019
  session_type?: string;
3685
3020
  agent_name?: string;
3686
3021
  workspace_id?: string;
3687
3022
  workspace?: string;
3023
+ worktree_id?: string;
3688
3024
  acp_session_id?: string;
3689
3025
  state?: string;
3690
3026
  soul_snapshot_id?: string;
@@ -3704,12 +3040,14 @@ export interface SessionPostStopPatch {
3704
3040
  export interface SessionPostStopPayload {
3705
3041
  event: HookEvent;
3706
3042
  timestamp: ISODateTime;
3043
+ profile_id?: string;
3707
3044
  session_id?: string;
3708
3045
  session_name?: string;
3709
3046
  session_type?: string;
3710
3047
  agent_name?: string;
3711
3048
  workspace_id?: string;
3712
3049
  workspace?: string;
3050
+ worktree_id?: string;
3713
3051
  acp_session_id?: string;
3714
3052
  state?: string;
3715
3053
  soul_snapshot_id?: string;
@@ -3720,12 +3058,14 @@ export interface SessionPostStopPayload {
3720
3058
  export interface SessionPreCreatePayload {
3721
3059
  event: HookEvent;
3722
3060
  timestamp: ISODateTime;
3061
+ profile_id?: string;
3723
3062
  session_id?: string;
3724
3063
  session_name?: string;
3725
3064
  session_type?: string;
3726
3065
  agent_name?: string;
3727
3066
  workspace_id?: string;
3728
3067
  workspace?: string;
3068
+ worktree_id?: string;
3729
3069
  acp_session_id?: string;
3730
3070
  state?: string;
3731
3071
  soul_snapshot_id?: string;
@@ -3745,12 +3085,14 @@ export interface SessionPreResumePatch {
3745
3085
  export interface SessionPreResumePayload {
3746
3086
  event: HookEvent;
3747
3087
  timestamp: ISODateTime;
3088
+ profile_id?: string;
3748
3089
  session_id?: string;
3749
3090
  session_name?: string;
3750
3091
  session_type?: string;
3751
3092
  agent_name?: string;
3752
3093
  workspace_id?: string;
3753
3094
  workspace?: string;
3095
+ worktree_id?: string;
3754
3096
  acp_session_id?: string;
3755
3097
  state?: string;
3756
3098
  soul_snapshot_id?: string;
@@ -3770,12 +3112,14 @@ export interface SessionPreStopPatch {
3770
3112
  export interface SessionPreStopPayload {
3771
3113
  event: HookEvent;
3772
3114
  timestamp: ISODateTime;
3115
+ profile_id?: string;
3773
3116
  session_id?: string;
3774
3117
  session_name?: string;
3775
3118
  session_type?: string;
3776
3119
  agent_name?: string;
3777
3120
  workspace_id?: string;
3778
3121
  workspace?: string;
3122
+ worktree_id?: string;
3779
3123
  acp_session_id?: string;
3780
3124
  state?: string;
3781
3125
  soul_snapshot_id?: string;
@@ -3783,10 +3127,14 @@ export interface SessionPreStopPayload {
3783
3127
  created_at: ISODateTime;
3784
3128
  updated_at: ISODateTime;
3785
3129
  }
3786
- export type BusyInputMode = string;
3130
+ export type Disposition = "direct" | "steering" | "queued" | "interrupting";
3787
3131
  export interface SessionPromptResult {
3132
+ disposition?: Disposition;
3133
+ steer_delivery?: SteerDeliveryMode;
3134
+ entry_id?: string;
3788
3135
  status: string;
3789
- mode?: BusyInputMode;
3136
+ mode?: PromptMode;
3137
+ delivery: PromptDelivery;
3790
3138
  message_id: string;
3791
3139
  idempotency_key: string;
3792
3140
  replayed: boolean;
@@ -3796,11 +3144,100 @@ export interface SessionPromptResult {
3796
3144
  queue_generation?: number;
3797
3145
  estimated_send_at?: ISODateTime;
3798
3146
  previous_turn_id?: string;
3799
- interrupted?: boolean;
3800
- staged?: boolean;
3801
- queued?: boolean;
3802
3147
  canceled_queued_entries?: number;
3803
- fallback_mode_if_no_tool_result?: string;
3148
+ }
3149
+ export interface SessionRuntimeClearParams {
3150
+ workspace_id: string;
3151
+ session_id: string;
3152
+ expected_revision?: number;
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
+ }
3229
+ export interface SessionRuntimeSelectionPayload {
3230
+ provider: string;
3231
+ model?: string;
3232
+ reasoning_effort?: ReasoningEffort;
3233
+ speed?: Speed;
3234
+ acp_options?: AgentACPOptionSelection[];
3235
+ }
3236
+ export interface SessionRuntimeSetParams {
3237
+ workspace_id: string;
3238
+ session_id: string;
3239
+ runtime: SessionRuntimeSelectionPayload;
3240
+ expected_revision?: number;
3804
3241
  }
3805
3242
  export interface SessionSoulRefreshParams {
3806
3243
  workspace_id: string;
@@ -3814,7 +3251,15 @@ export interface SessionSoulRefreshRequest {
3814
3251
  }
3815
3252
  export type SessionRuntimeStatus = string;
3816
3253
  export type SessionRuntimeTransition = string;
3817
- export type Speed = 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
+ }
3818
3263
  export type ResolutionStatus = string;
3819
3264
  export type ResolutionReason = string;
3820
3265
  export interface Resolution {
@@ -3827,23 +3272,16 @@ export interface RuntimeSelectionPayload {
3827
3272
  model?: string;
3828
3273
  reasoning_effort?: ReasoningEffort;
3829
3274
  speed?: Speed;
3275
+ acp_options?: AgentACPOptionSelection[];
3830
3276
  speed_resolution?: Resolution;
3831
3277
  }
3832
- export interface SessionConfigOptionValuePayload {
3833
- value: string;
3834
- label?: string;
3835
- description?: string;
3836
- }
3837
- export interface SessionConfigOptionPayload {
3838
- id: string;
3839
- label?: string;
3840
- description?: string;
3841
- kind: string;
3842
- current?: string;
3843
- values?: SessionConfigOptionValuePayload[];
3844
- }
3845
3278
  export interface ACPCapsPayload {
3846
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;
3847
3285
  supported_modes?: string[];
3848
3286
  config_options?: SessionConfigOptionPayload[];
3849
3287
  }
@@ -3851,11 +3289,14 @@ export interface SessionRuntimePayload {
3851
3289
  status: SessionRuntimeStatus;
3852
3290
  transition?: SessionRuntimeTransition;
3853
3291
  failure?: string;
3292
+ generation?: number;
3293
+ recovery?: SessionRuntimeRecoveryPayload;
3294
+ selected?: PromptRuntimeSelectionPayload;
3295
+ selection_revision: number;
3854
3296
  effective?: RuntimeSelectionPayload;
3855
3297
  acp_session_id?: string;
3856
3298
  acp_caps?: ACPCapsPayload;
3857
3299
  }
3858
- export type State = "starting" | "active" | "stopping" | "stopped";
3859
3300
  export type StopReason = "completed" | "user_canceled" | "max_iterations" | "loop_detected" | "timeout" | "budget_exceeded" | "error" | "agent_crashed" | "hook_stopped" | "shutdown";
3860
3301
  export interface SessionStatus {
3861
3302
  session_id: string;
@@ -3865,6 +3306,7 @@ export interface SessionStatus {
3865
3306
  workspace_id?: string;
3866
3307
  workspace?: string;
3867
3308
  state: State;
3309
+ archived_at?: ISODateTime;
3868
3310
  stop_reason?: StopReason;
3869
3311
  stop_detail?: string;
3870
3312
  created_at: ISODateTime;
@@ -3874,17 +3316,81 @@ export interface SessionStatusGetParams {
3874
3316
  workspace_id: string;
3875
3317
  session_id: string;
3876
3318
  }
3319
+ export interface SessionQueueSummaryPayload {
3320
+ entries: number;
3321
+ cap: number;
3322
+ }
3323
+ export type Badge = string;
3324
+ export interface PendingInteractionPayload {
3325
+ interaction_id: string;
3326
+ kind: string;
3327
+ provider_request_id: string;
3328
+ turn_id?: string;
3329
+ title?: string;
3330
+ choices?: string[];
3331
+ decisions?: string[];
3332
+ tool_id?: string;
3333
+ status: string;
3334
+ created_at: ISODateTime;
3335
+ resolved_at?: ISODateTime;
3336
+ resolution?: string;
3337
+ resolved_by?: string;
3338
+ }
3339
+ export type LineageKind = string;
3340
+ export interface SpawnBudgetPayload {
3341
+ max_children: number;
3342
+ max_depth: number;
3343
+ ttl_seconds: number;
3344
+ max_active_per_workspace?: number;
3345
+ }
3346
+ export interface SpawnPermissionPolicyPayload {
3347
+ tools: string[];
3348
+ skills: string[];
3349
+ mcp_servers: string[];
3350
+ workspace_paths: string[];
3351
+ }
3352
+ export interface SessionLineagePayload {
3353
+ parent_session_id?: string;
3354
+ root_session_id?: string;
3355
+ spawn_depth: number;
3356
+ spawn_role?: string;
3357
+ kind?: LineageKind;
3358
+ origin_message_id?: string;
3359
+ origin_agent_name?: string;
3360
+ ttl_expires_at?: ISODateTime;
3361
+ auto_stop_on_parent: boolean;
3362
+ notify_creator: boolean;
3363
+ spawn_budget: SpawnBudgetPayload;
3364
+ permission_policy: SpawnPermissionPolicyPayload;
3365
+ }
3366
+ export interface SessionDerivationPayload {
3367
+ kind: LineageKind;
3368
+ source_session_id: string;
3369
+ seed: string;
3370
+ native_state?: string;
3371
+ native_fork_error?: string;
3372
+ first_prompt: string;
3373
+ }
3877
3374
  export interface SessionStatusResponse {
3375
+ queue?: SessionQueueSummaryPayload;
3376
+ lifecycle_state?: State;
3377
+ verified?: boolean;
3378
+ escalated?: boolean;
3379
+ attention?: string;
3878
3380
  session_id: string;
3879
3381
  workspace_id: string;
3880
3382
  agent_name: string;
3881
3383
  state: SessionHealthState;
3384
+ badge: Badge;
3882
3385
  health: SessionHealthStatus;
3883
3386
  active_prompt: boolean;
3884
3387
  attachable: boolean;
3885
3388
  eligible_for_wake: boolean;
3886
3389
  ineligibility_reason?: SessionHealthIneligibilityReason;
3887
3390
  wake_state?: HeartbeatWakeStatePayload;
3391
+ pending_interactions: PendingInteractionPayload[];
3392
+ lineage?: SessionLineagePayload;
3393
+ derivation?: SessionDerivationPayload;
3888
3394
  updated_at: ISODateTime;
3889
3395
  }
3890
3396
  export interface SessionSummary {
@@ -3894,6 +3400,7 @@ export interface SessionSummary {
3894
3400
  runtime: SessionRuntimePayload;
3895
3401
  workspace?: string;
3896
3402
  state: State;
3403
+ archived_at?: ISODateTime;
3897
3404
  created_at: ISODateTime;
3898
3405
  }
3899
3406
  export interface SessionTargetParams {
@@ -3903,16 +3410,10 @@ export interface SessionTargetParams {
3903
3410
  export interface SessionsCreateParams {
3904
3411
  agent: string;
3905
3412
  workspace?: string;
3906
- network_participation?: NetworkParticipationRequest;
3907
3413
  }
3908
3414
  export interface SessionsListParams {
3909
3415
  workspace?: string;
3910
- }
3911
- export interface PromptRuntimeSelectionPayload {
3912
- provider: string;
3913
- model?: string;
3914
- reasoning_effort?: ReasoningEffort;
3915
- speed?: Speed;
3416
+ archive?: string;
3916
3417
  }
3917
3418
  export interface SessionsPromptParams {
3918
3419
  workspace_id: string;
@@ -3920,6 +3421,8 @@ export interface SessionsPromptParams {
3920
3421
  message: string;
3921
3422
  message_id: string;
3922
3423
  idempotency_key: string;
3424
+ mode?: PromptMode;
3425
+ expected_turn_id?: string;
3923
3426
  runtime?: PromptRuntimeSelectionPayload;
3924
3427
  }
3925
3428
  export interface ShutdownRequest {
@@ -3944,6 +3447,7 @@ export interface SkillSummary {
3944
3447
  name: string;
3945
3448
  description?: string;
3946
3449
  source: string;
3450
+ origin: string;
3947
3451
  enabled: boolean;
3948
3452
  activation: SkillActivationPayload;
3949
3453
  }
@@ -3952,6 +3456,7 @@ export interface SkillsListParams {
3952
3456
  for_agent?: string;
3953
3457
  }
3954
3458
  export interface SpawnContext {
3459
+ profile_id?: string;
3955
3460
  parent_session_id?: string;
3956
3461
  root_session_id?: string;
3957
3462
  child_session_id?: string;
@@ -3965,7 +3470,6 @@ export interface SpawnContext {
3965
3470
  task_id?: string;
3966
3471
  run_id?: string;
3967
3472
  workflow_id?: string;
3968
- resolved_network_participation?: NetworkParticipationSpec;
3969
3473
  soul_snapshot_id?: string;
3970
3474
  soul_digest?: string;
3971
3475
  parent_soul_digest?: string;
@@ -3981,6 +3485,7 @@ export interface SpawnCreatePatch {
3981
3485
  export interface SpawnCreatedPayload {
3982
3486
  event: HookEvent;
3983
3487
  timestamp: ISODateTime;
3488
+ profile_id?: string;
3984
3489
  parent_session_id?: string;
3985
3490
  root_session_id?: string;
3986
3491
  child_session_id?: string;
@@ -3994,7 +3499,6 @@ export interface SpawnCreatedPayload {
3994
3499
  task_id?: string;
3995
3500
  run_id?: string;
3996
3501
  workflow_id?: string;
3997
- resolved_network_participation?: NetworkParticipationSpec;
3998
3502
  soul_snapshot_id?: string;
3999
3503
  soul_digest?: string;
4000
3504
  parent_soul_digest?: string;
@@ -4007,6 +3511,7 @@ export interface SpawnCreatedPayload {
4007
3511
  export interface SpawnLifecyclePayload {
4008
3512
  event: HookEvent;
4009
3513
  timestamp: ISODateTime;
3514
+ profile_id?: string;
4010
3515
  parent_session_id?: string;
4011
3516
  root_session_id?: string;
4012
3517
  child_session_id?: string;
@@ -4020,7 +3525,6 @@ export interface SpawnLifecyclePayload {
4020
3525
  task_id?: string;
4021
3526
  run_id?: string;
4022
3527
  workflow_id?: string;
4023
- resolved_network_participation?: NetworkParticipationSpec;
4024
3528
  soul_snapshot_id?: string;
4025
3529
  soul_digest?: string;
4026
3530
  parent_soul_digest?: string;
@@ -4036,6 +3540,7 @@ export interface SpawnObservationPatch {
4036
3540
  export interface SpawnParentStoppedPayload {
4037
3541
  event: HookEvent;
4038
3542
  timestamp: ISODateTime;
3543
+ profile_id?: string;
4039
3544
  parent_session_id?: string;
4040
3545
  root_session_id?: string;
4041
3546
  child_session_id?: string;
@@ -4049,7 +3554,6 @@ export interface SpawnParentStoppedPayload {
4049
3554
  task_id?: string;
4050
3555
  run_id?: string;
4051
3556
  workflow_id?: string;
4052
- resolved_network_participation?: NetworkParticipationSpec;
4053
3557
  soul_snapshot_id?: string;
4054
3558
  soul_digest?: string;
4055
3559
  parent_soul_digest?: string;
@@ -4062,6 +3566,7 @@ export interface SpawnParentStoppedPayload {
4062
3566
  export interface SpawnPreCreatePayload {
4063
3567
  event: HookEvent;
4064
3568
  timestamp: ISODateTime;
3569
+ profile_id?: string;
4065
3570
  parent_session_id?: string;
4066
3571
  root_session_id?: string;
4067
3572
  child_session_id?: string;
@@ -4075,7 +3580,6 @@ export interface SpawnPreCreatePayload {
4075
3580
  task_id?: string;
4076
3581
  run_id?: string;
4077
3582
  workflow_id?: string;
4078
- resolved_network_participation?: NetworkParticipationSpec;
4079
3583
  soul_snapshot_id?: string;
4080
3584
  soul_digest?: string;
4081
3585
  parent_soul_digest?: string;
@@ -4087,6 +3591,7 @@ export interface SpawnPreCreatePayload {
4087
3591
  export interface SpawnReapedPayload {
4088
3592
  event: HookEvent;
4089
3593
  timestamp: ISODateTime;
3594
+ profile_id?: string;
4090
3595
  parent_session_id?: string;
4091
3596
  root_session_id?: string;
4092
3597
  child_session_id?: string;
@@ -4100,7 +3605,6 @@ export interface SpawnReapedPayload {
4100
3605
  task_id?: string;
4101
3606
  run_id?: string;
4102
3607
  workflow_id?: string;
4103
- resolved_network_participation?: NetworkParticipationSpec;
4104
3608
  soul_snapshot_id?: string;
4105
3609
  soul_digest?: string;
4106
3610
  parent_soul_digest?: string;
@@ -4113,6 +3617,7 @@ export interface SpawnReapedPayload {
4113
3617
  export interface SpawnTTLExpiredPayload {
4114
3618
  event: HookEvent;
4115
3619
  timestamp: ISODateTime;
3620
+ profile_id?: string;
4116
3621
  parent_session_id?: string;
4117
3622
  root_session_id?: string;
4118
3623
  child_session_id?: string;
@@ -4126,7 +3631,6 @@ export interface SpawnTTLExpiredPayload {
4126
3631
  task_id?: string;
4127
3632
  run_id?: string;
4128
3633
  workflow_id?: string;
4129
- resolved_network_participation?: NetworkParticipationSpec;
4130
3634
  soul_snapshot_id?: string;
4131
3635
  soul_digest?: string;
4132
3636
  parent_soul_digest?: string;
@@ -4157,13 +3661,25 @@ export interface Origin {
4157
3661
  kind: OriginKind;
4158
3662
  ref: string;
4159
3663
  }
3664
+ export type LoopProvenanceRole = "coordinator" | "cell";
3665
+ export interface LoopProvenance {
3666
+ run_id: string;
3667
+ loop_name?: string;
3668
+ role: LoopProvenanceRole;
3669
+ generation?: number;
3670
+ node_id?: string;
3671
+ item_index?: number;
3672
+ }
4160
3673
  export interface Task {
4161
3674
  id: string;
3675
+ profile_id: string;
3676
+ profile_name: string;
3677
+ profile_color?: string;
3678
+ profile_icon?: string;
4162
3679
  identifier?: string;
4163
3680
  scope: Scope;
4164
3681
  workspace_id?: string;
4165
3682
  parent_task_id?: string;
4166
- resolved_network_participation?: NetworkParticipationSpec;
4167
3683
  title: string;
4168
3684
  description?: string;
4169
3685
  priority?: Priority;
@@ -4194,15 +3710,16 @@ export interface Task {
4194
3710
  updated_at: ISODateTime;
4195
3711
  closed_at?: ISODateTime;
4196
3712
  metadata?: JSONValue;
3713
+ loop?: LoopProvenance;
4197
3714
  }
4198
3715
  export interface TaskBlockedPayload {
4199
3716
  event: HookEvent;
4200
3717
  timestamp: ISODateTime;
3718
+ profile_id?: string;
4201
3719
  task_id?: string;
4202
3720
  parent_task_id?: string;
4203
3721
  workspace_id?: string;
4204
3722
  workflow_id?: string;
4205
- resolved_network_participation?: NetworkParticipationSpec;
4206
3723
  agent_name?: string;
4207
3724
  actor_kind?: string;
4208
3725
  actor_id?: string;
@@ -4225,11 +3742,11 @@ export interface TaskCancelParams {
4225
3742
  metadata?: JSONValue;
4226
3743
  }
4227
3744
  export interface TaskContext {
3745
+ profile_id?: string;
4228
3746
  task_id?: string;
4229
3747
  parent_task_id?: string;
4230
3748
  workspace_id?: string;
4231
3749
  workflow_id?: string;
4232
- resolved_network_participation?: NetworkParticipationSpec;
4233
3750
  agent_name?: string;
4234
3751
  actor_kind?: string;
4235
3752
  actor_id?: string;
@@ -4245,7 +3762,6 @@ export interface TaskCreateParams {
4245
3762
  identifier?: string;
4246
3763
  scope: Scope;
4247
3764
  workspace?: string;
4248
- network_participation?: NetworkParticipationRequest;
4249
3765
  title: string;
4250
3766
  description?: string;
4251
3767
  priority?: Priority;
@@ -4321,7 +3837,6 @@ export interface TaskDashboardStatusBreakdownPayload {
4321
3837
  share_percent: number;
4322
3838
  }
4323
3839
  export interface TaskDashboardQueueDepthPayload {
4324
- channel_id?: string;
4325
3840
  count: number;
4326
3841
  oldest_queued_at: ISODateTime;
4327
3842
  oldest_queue_age_ms: number;
@@ -4356,7 +3871,6 @@ export interface TaskDashboardActiveRunPayload {
4356
3871
  attempt: number;
4357
3872
  max_attempts: number;
4358
3873
  session_id?: string;
4359
- resolved_network_participation?: NetworkParticipationSpec;
4360
3874
  last_activity_at: ISODateTime;
4361
3875
  age_ms: number;
4362
3876
  health_status: string;
@@ -4392,9 +3906,9 @@ export interface TaskDashboard {
4392
3906
  export interface TaskDashboardParams {
4393
3907
  scope?: Scope;
4394
3908
  workspace?: string;
3909
+ worktree?: string;
4395
3910
  owner_kind?: OwnerKind;
4396
3911
  owner_ref?: string;
4397
- participation_channel?: string;
4398
3912
  origin_kind?: OriginKind;
4399
3913
  }
4400
3914
  export type DependencyKind = string;
@@ -4419,18 +3933,7 @@ export interface TaskDependencyReferencePayload {
4419
3933
  created_at: ISODateTime;
4420
3934
  depends_on: TaskReferencePayload;
4421
3935
  }
4422
- export type CoordinationMessageKind = string;
4423
- export interface CoordinationChannelPayload {
4424
- id: string;
4425
- display_name: string;
4426
- purpose?: string;
4427
- workspace_id?: string;
4428
- task_id?: string;
4429
- run_id?: string;
4430
- workflow_id?: string;
4431
- allowed_message_kinds: CoordinationMessageKind[];
4432
- last_activity_at?: ISODateTime;
4433
- }
3936
+ export type ResolvedWorktreeMode = string;
4434
3937
  export interface RunDesignationSummary {
4435
3938
  index: number;
4436
3939
  brief?: string;
@@ -4445,12 +3948,13 @@ export interface TaskRunSummaryPayload {
4445
3948
  failure_kind?: string;
4446
3949
  max_attempts: number;
4447
3950
  session_id?: string;
3951
+ worktree_id?: string;
3952
+ resolved_worktree_mode: ResolvedWorktreeMode;
3953
+ resolved_worktree_ref?: string;
4448
3954
  claimed_by?: ActorIdentity;
4449
3955
  claim_token_hash?: string;
4450
3956
  lease_until?: ISODateTime;
4451
3957
  heartbeat_at?: ISODateTime;
4452
- resolved_network_participation?: NetworkParticipationSpec;
4453
- coordination_channel?: CoordinationChannelPayload;
4454
3958
  designation_group_id?: string;
4455
3959
  designation?: RunDesignationSummary;
4456
3960
  queued_at: ISODateTime;
@@ -4461,11 +3965,14 @@ export interface TaskRunSummaryPayload {
4461
3965
  }
4462
3966
  export interface TaskSummaryPayload {
4463
3967
  id: string;
3968
+ profile_id: string;
3969
+ profile_name: string;
3970
+ profile_color?: string;
3971
+ profile_icon?: string;
4464
3972
  identifier?: string;
4465
3973
  scope: Scope;
4466
3974
  workspace_id?: string;
4467
3975
  parent_task_id?: string;
4468
- resolved_network_participation?: NetworkParticipationSpec;
4469
3976
  title: string;
4470
3977
  priority?: Priority;
4471
3978
  max_attempts?: number;
@@ -4508,6 +4015,10 @@ export interface TaskDependencyPayload {
4508
4015
  }
4509
4016
  export interface TaskRun {
4510
4017
  id: string;
4018
+ profile_id?: string;
4019
+ profile_name?: string;
4020
+ profile_color?: string;
4021
+ profile_icon?: string;
4511
4022
  task_id: string;
4512
4023
  status: RunStatus;
4513
4024
  attempt: number;
@@ -4516,14 +4027,15 @@ export interface TaskRun {
4516
4027
  failure_kind?: string;
4517
4028
  claimed_by?: ActorIdentity;
4518
4029
  session_id?: string;
4030
+ worktree_id?: string;
4031
+ resolved_worktree_mode: ResolvedWorktreeMode;
4032
+ resolved_worktree_ref?: string;
4519
4033
  origin: Origin;
4520
4034
  idempotency_key?: string;
4521
- resolved_network_participation?: NetworkParticipationSpec;
4522
4035
  designation_group_id?: string;
4523
4036
  claim_token_hash?: string;
4524
4037
  lease_until?: ISODateTime;
4525
4038
  heartbeat_at?: ISODateTime;
4526
- coordination_channel?: CoordinationChannelPayload;
4527
4039
  designation?: RunDesignationSummary;
4528
4040
  queued_at: ISODateTime;
4529
4041
  claimed_at?: ISODateTime;
@@ -4532,6 +4044,8 @@ export interface TaskRun {
4532
4044
  error?: string;
4533
4045
  metadata?: JSONValue;
4534
4046
  result?: JSONValue;
4047
+ result_ref?: string;
4048
+ result_bytes?: number;
4535
4049
  }
4536
4050
  export interface TaskDesignationRollupPayload {
4537
4051
  designation_group_id: string;
@@ -4581,10 +4095,12 @@ export interface TaskCatalogRunPayload {
4581
4095
  failure_kind?: string;
4582
4096
  max_attempts: number;
4583
4097
  session_id?: string;
4098
+ worktree_id?: string;
4099
+ resolved_worktree_mode: ResolvedWorktreeMode;
4100
+ resolved_worktree_ref?: string;
4584
4101
  claimed_by?: ActorIdentity;
4585
4102
  lease_until?: ISODateTime;
4586
4103
  heartbeat_at?: ISODateTime;
4587
- resolved_network_participation?: NetworkParticipationSpec;
4588
4104
  queued_at: ISODateTime;
4589
4105
  claimed_at?: ISODateTime;
4590
4106
  started_at?: ISODateTime;
@@ -4639,6 +4155,7 @@ export type CatalogScope = string;
4639
4155
  export interface TaskInboxParams {
4640
4156
  scope?: CatalogScope;
4641
4157
  workspace?: string;
4158
+ worktree?: string;
4642
4159
  owner_kind?: OwnerKind;
4643
4160
  owner_ref?: string;
4644
4161
  lane?: TaskInboxLane;
@@ -4652,11 +4169,11 @@ export interface TaskInboxParams {
4652
4169
  export interface TaskNeedsAttentionPayload {
4653
4170
  event: HookEvent;
4654
4171
  timestamp: ISODateTime;
4172
+ profile_id?: string;
4655
4173
  task_id?: string;
4656
4174
  parent_task_id?: string;
4657
4175
  workspace_id?: string;
4658
4176
  workflow_id?: string;
4659
- resolved_network_participation?: NetworkParticipationSpec;
4660
4177
  agent_name?: string;
4661
4178
  actor_kind?: string;
4662
4179
  actor_id?: string;
@@ -4676,11 +4193,11 @@ export interface TaskObservationPatch {
4676
4193
  export interface TaskRecoveredPayload {
4677
4194
  event: HookEvent;
4678
4195
  timestamp: ISODateTime;
4196
+ profile_id?: string;
4679
4197
  task_id?: string;
4680
4198
  parent_task_id?: string;
4681
4199
  workspace_id?: string;
4682
4200
  workflow_id?: string;
4683
- resolved_network_participation?: NetworkParticipationSpec;
4684
4201
  agent_name?: string;
4685
4202
  actor_kind?: string;
4686
4203
  actor_id?: string;
@@ -4721,6 +4238,7 @@ export interface TaskRunCompleteParams {
4721
4238
  export interface TaskRunCompletedPayload {
4722
4239
  event: HookEvent;
4723
4240
  timestamp: ISODateTime;
4241
+ profile_id?: string;
4724
4242
  task_id?: string;
4725
4243
  run_id?: string;
4726
4244
  run_kind?: string;
@@ -4730,7 +4248,6 @@ export interface TaskRunCompletedPayload {
4730
4248
  loop_run_id?: string;
4731
4249
  workspace_id?: string;
4732
4250
  workflow_id?: string;
4733
- resolved_network_participation?: NetworkParticipationSpec;
4734
4251
  agent_name?: string;
4735
4252
  session_id?: string;
4736
4253
  actor_kind?: string;
@@ -4751,6 +4268,7 @@ export interface TaskRunCompletedPayload {
4751
4268
  recovery_reason?: string;
4752
4269
  }
4753
4270
  export interface TaskRunContext {
4271
+ profile_id?: string;
4754
4272
  task_id?: string;
4755
4273
  run_id?: string;
4756
4274
  run_kind?: string;
@@ -4760,7 +4278,6 @@ export interface TaskRunContext {
4760
4278
  loop_run_id?: string;
4761
4279
  workspace_id?: string;
4762
4280
  workflow_id?: string;
4763
- resolved_network_participation?: NetworkParticipationSpec;
4764
4281
  agent_name?: string;
4765
4282
  session_id?: string;
4766
4283
  actor_kind?: string;
@@ -4800,33 +4317,21 @@ export interface TaskRunOperationalSummaryPayload {
4800
4317
  cost_status?: CostStatus;
4801
4318
  cost_source?: CostSource;
4802
4319
  }
4803
- export interface TaskRunConversationRefPayload {
4804
- workspace_id: string;
4805
- channel: string;
4806
- surface: string;
4807
- thread_id: string;
4808
- stream_url: string;
4809
- }
4810
- export interface TaskRunNetworkPayload {
4811
- conversation: TaskRunConversationRefPayload;
4812
- usage: NetworkUsageResponse;
4813
- }
4814
4320
  export interface TaskRunDetail {
4815
4321
  run: TaskRun;
4816
4322
  task?: TaskReferencePayload;
4817
4323
  session?: TaskRunSessionPayload;
4818
4324
  summary: TaskRunOperationalSummaryPayload;
4819
- network?: TaskRunNetworkPayload;
4820
4325
  }
4821
4326
  export interface TaskRunEnqueueParams {
4822
4327
  task_id: string;
4823
4328
  idempotency_key?: string;
4824
- network_participation?: NetworkParticipationRequest;
4825
4329
  metadata?: JSONValue;
4826
4330
  }
4827
4331
  export interface TaskRunEnqueuedPayload {
4828
4332
  event: HookEvent;
4829
4333
  timestamp: ISODateTime;
4334
+ profile_id?: string;
4830
4335
  task_id?: string;
4831
4336
  run_id?: string;
4832
4337
  run_kind?: string;
@@ -4836,7 +4341,6 @@ export interface TaskRunEnqueuedPayload {
4836
4341
  loop_run_id?: string;
4837
4342
  workspace_id?: string;
4838
4343
  workflow_id?: string;
4839
- resolved_network_participation?: NetworkParticipationSpec;
4840
4344
  agent_name?: string;
4841
4345
  session_id?: string;
4842
4346
  actor_kind?: string;
@@ -4861,6 +4365,7 @@ export interface TaskRunFailParams {
4861
4365
  export interface TaskRunFailedPayload {
4862
4366
  event: HookEvent;
4863
4367
  timestamp: ISODateTime;
4368
+ profile_id?: string;
4864
4369
  task_id?: string;
4865
4370
  run_id?: string;
4866
4371
  run_kind?: string;
@@ -4870,7 +4375,6 @@ export interface TaskRunFailedPayload {
4870
4375
  loop_run_id?: string;
4871
4376
  workspace_id?: string;
4872
4377
  workflow_id?: string;
4873
- resolved_network_participation?: NetworkParticipationSpec;
4874
4378
  agent_name?: string;
4875
4379
  session_id?: string;
4876
4380
  actor_kind?: string;
@@ -4896,6 +4400,7 @@ export interface TaskRunGetParams {
4896
4400
  export interface TaskRunLeaseExpiredPayload {
4897
4401
  event: HookEvent;
4898
4402
  timestamp: ISODateTime;
4403
+ profile_id?: string;
4899
4404
  task_id?: string;
4900
4405
  run_id?: string;
4901
4406
  run_kind?: string;
@@ -4905,7 +4410,6 @@ export interface TaskRunLeaseExpiredPayload {
4905
4410
  loop_run_id?: string;
4906
4411
  workspace_id?: string;
4907
4412
  workflow_id?: string;
4908
- resolved_network_participation?: NetworkParticipationSpec;
4909
4413
  agent_name?: string;
4910
4414
  session_id?: string;
4911
4415
  actor_kind?: string;
@@ -4928,6 +4432,7 @@ export interface TaskRunLeaseExpiredPayload {
4928
4432
  export interface TaskRunLeaseExtendedPayload {
4929
4433
  event: HookEvent;
4930
4434
  timestamp: ISODateTime;
4435
+ profile_id?: string;
4931
4436
  task_id?: string;
4932
4437
  run_id?: string;
4933
4438
  run_kind?: string;
@@ -4937,7 +4442,6 @@ export interface TaskRunLeaseExtendedPayload {
4937
4442
  loop_run_id?: string;
4938
4443
  workspace_id?: string;
4939
4444
  workflow_id?: string;
4940
- resolved_network_participation?: NetworkParticipationSpec;
4941
4445
  agent_name?: string;
4942
4446
  session_id?: string;
4943
4447
  actor_kind?: string;
@@ -4960,6 +4464,7 @@ export interface TaskRunLeaseExtendedPayload {
4960
4464
  export interface TaskRunLeasePayload {
4961
4465
  event: HookEvent;
4962
4466
  timestamp: ISODateTime;
4467
+ profile_id?: string;
4963
4468
  task_id?: string;
4964
4469
  run_id?: string;
4965
4470
  run_kind?: string;
@@ -4969,7 +4474,6 @@ export interface TaskRunLeasePayload {
4969
4474
  loop_run_id?: string;
4970
4475
  workspace_id?: string;
4971
4476
  workflow_id?: string;
4972
- resolved_network_participation?: NetworkParticipationSpec;
4973
4477
  agent_name?: string;
4974
4478
  session_id?: string;
4975
4479
  actor_kind?: string;
@@ -4992,6 +4496,7 @@ export interface TaskRunLeasePayload {
4992
4496
  export interface TaskRunLeaseRecoveredPayload {
4993
4497
  event: HookEvent;
4994
4498
  timestamp: ISODateTime;
4499
+ profile_id?: string;
4995
4500
  task_id?: string;
4996
4501
  run_id?: string;
4997
4502
  run_kind?: string;
@@ -5001,7 +4506,6 @@ export interface TaskRunLeaseRecoveredPayload {
5001
4506
  loop_run_id?: string;
5002
4507
  workspace_id?: string;
5003
4508
  workflow_id?: string;
5004
- resolved_network_participation?: NetworkParticipationSpec;
5005
4509
  agent_name?: string;
5006
4510
  session_id?: string;
5007
4511
  actor_kind?: string;
@@ -5027,6 +4531,7 @@ export interface TaskRunObservationPatch {
5027
4531
  export interface TaskRunPostClaimPayload {
5028
4532
  event: HookEvent;
5029
4533
  timestamp: ISODateTime;
4534
+ profile_id?: string;
5030
4535
  task_id?: string;
5031
4536
  run_id?: string;
5032
4537
  run_kind?: string;
@@ -5036,7 +4541,6 @@ export interface TaskRunPostClaimPayload {
5036
4541
  loop_run_id?: string;
5037
4542
  workspace_id?: string;
5038
4543
  workflow_id?: string;
5039
- resolved_network_participation?: NetworkParticipationSpec;
5040
4544
  agent_name?: string;
5041
4545
  session_id?: string;
5042
4546
  actor_kind?: string;
@@ -5062,6 +4566,7 @@ export interface TaskRunPreClaimPatch {
5062
4566
  export interface TaskRunPreClaimPayload {
5063
4567
  event: HookEvent;
5064
4568
  timestamp: ISODateTime;
4569
+ profile_id?: string;
5065
4570
  task_id?: string;
5066
4571
  run_id?: string;
5067
4572
  run_kind?: string;
@@ -5071,7 +4576,6 @@ export interface TaskRunPreClaimPayload {
5071
4576
  loop_run_id?: string;
5072
4577
  workspace_id?: string;
5073
4578
  workflow_id?: string;
5074
- resolved_network_participation?: NetworkParticipationSpec;
5075
4579
  agent_name?: string;
5076
4580
  session_id?: string;
5077
4581
  actor_kind?: string;
@@ -5093,6 +4597,7 @@ export interface TaskRunPreClaimPayload {
5093
4597
  export interface TaskRunReleasedPayload {
5094
4598
  event: HookEvent;
5095
4599
  timestamp: ISODateTime;
4600
+ profile_id?: string;
5096
4601
  task_id?: string;
5097
4602
  run_id?: string;
5098
4603
  run_kind?: string;
@@ -5102,7 +4607,6 @@ export interface TaskRunReleasedPayload {
5102
4607
  loop_run_id?: string;
5103
4608
  workspace_id?: string;
5104
4609
  workflow_id?: string;
5105
- resolved_network_participation?: NetworkParticipationSpec;
5106
4610
  agent_name?: string;
5107
4611
  session_id?: string;
5108
4612
  actor_kind?: string;
@@ -5122,6 +4626,21 @@ export interface TaskRunReleasedPayload {
5122
4626
  recovery_action?: string;
5123
4627
  recovery_reason?: string;
5124
4628
  }
4629
+ export interface TaskRunResultPage {
4630
+ run_id: string;
4631
+ result_ref?: string;
4632
+ offset: number;
4633
+ bytes: number;
4634
+ total_bytes: number;
4635
+ data_base64: string;
4636
+ next_offset?: number;
4637
+ eof: boolean;
4638
+ }
4639
+ export interface TaskRunResultParams {
4640
+ id: string;
4641
+ offset?: number;
4642
+ limit?: number;
4643
+ }
5125
4644
  export interface TaskRunStartParams {
5126
4645
  id: string;
5127
4646
  idempotency_key?: string;
@@ -5130,17 +4649,16 @@ export interface TaskRunsParams {
5130
4649
  id: string;
5131
4650
  status?: RunStatus;
5132
4651
  session_id?: string;
5133
- participation_channel?: string;
5134
4652
  limit?: number;
5135
4653
  }
5136
4654
  export interface TaskStatusChangedPayload {
5137
4655
  event: HookEvent;
5138
4656
  timestamp: ISODateTime;
4657
+ profile_id?: string;
5139
4658
  task_id?: string;
5140
4659
  parent_task_id?: string;
5141
4660
  workspace_id?: string;
5142
4661
  workflow_id?: string;
5143
- resolved_network_participation?: NetworkParticipationSpec;
5144
4662
  agent_name?: string;
5145
4663
  actor_kind?: string;
5146
4664
  actor_id?: string;
@@ -5162,6 +4680,7 @@ export interface TaskTimelineItem {
5162
4680
  task: TaskReferencePayload;
5163
4681
  run?: TaskRunSummaryPayload;
5164
4682
  event_type: string;
4683
+ reason?: string;
5165
4684
  actor: ActorIdentity;
5166
4685
  origin: Origin;
5167
4686
  payload?: JSONValue;
@@ -5190,11 +4709,11 @@ export interface TaskTreeParams {
5190
4709
  export interface TaskUnblockedPayload {
5191
4710
  event: HookEvent;
5192
4711
  timestamp: ISODateTime;
4712
+ profile_id?: string;
5193
4713
  task_id?: string;
5194
4714
  parent_task_id?: string;
5195
4715
  workspace_id?: string;
5196
4716
  workflow_id?: string;
5197
- resolved_network_participation?: NetworkParticipationSpec;
5198
4717
  agent_name?: string;
5199
4718
  actor_kind?: string;
5200
4719
  actor_id?: string;
@@ -5220,7 +4739,6 @@ export interface TaskUpdateParams {
5220
4739
  auto_enqueue_on_ready?: boolean;
5221
4740
  approval_policy?: ApprovalPolicy;
5222
4741
  metadata?: JSONValue;
5223
- network_participation?: NetworkParticipationRequest;
5224
4742
  owner?: Ownership;
5225
4743
  clear_owner?: boolean;
5226
4744
  }
@@ -5231,11 +4749,13 @@ export interface TasksParams {
5231
4749
  status?: Status;
5232
4750
  priority?: Priority;
5233
4751
  include_drafts?: boolean;
4752
+ include_loop?: boolean;
4753
+ loop_run_id?: string;
5234
4754
  approval_state?: ApprovalState;
5235
4755
  owner_kind?: OwnerKind;
5236
4756
  owner_ref?: string;
5237
4757
  parent_task_id?: string;
5238
- participation_channel?: string;
4758
+ worktree?: string;
5239
4759
  query?: string;
5240
4760
  sort?: CatalogSort;
5241
4761
  cursor?: string;
@@ -5243,11 +4763,14 @@ export interface TasksParams {
5243
4763
  }
5244
4764
  export interface TaskCatalogItemPayload {
5245
4765
  id: string;
4766
+ profile_id: string;
4767
+ profile_name: string;
4768
+ profile_color?: string;
4769
+ profile_icon?: string;
5246
4770
  identifier?: string;
5247
4771
  scope: Scope;
5248
4772
  workspace_id?: string;
5249
4773
  parent_task_id?: string;
5250
- resolved_network_participation?: NetworkParticipationSpec;
5251
4774
  title: string;
5252
4775
  priority?: Priority;
5253
4776
  max_attempts?: number;
@@ -5273,6 +4796,7 @@ export interface TaskCatalogItemPayload {
5273
4796
  dependency_count?: number;
5274
4797
  active_run?: TaskCatalogRunPayload;
5275
4798
  last_activity_at?: ISODateTime;
4799
+ loop?: LoopProvenance;
5276
4800
  }
5277
4801
  export interface TaskCatalogStatusFacetPayload {
5278
4802
  status: Status;
@@ -5291,6 +4815,176 @@ export interface TasksResponse {
5291
4815
  page: CountedCursorPagePayload;
5292
4816
  facets: TaskCatalogFacetsPayload;
5293
4817
  }
4818
+ export interface TerminalExit {
4819
+ cause: string;
4820
+ code?: number;
4821
+ signal?: string;
4822
+ }
4823
+ export interface TerminalClosedPayload {
4824
+ event: HookEvent;
4825
+ timestamp: ISODateTime;
4826
+ workspace_id: string;
4827
+ profile_id: string;
4828
+ terminal_id?: string;
4829
+ actor_kind: string;
4830
+ actor_id: string;
4831
+ session_id?: string;
4832
+ run_id?: string;
4833
+ generation?: number;
4834
+ at: ISODateTime;
4835
+ exit: TerminalExit;
4836
+ reason: string;
4837
+ }
4838
+ export interface TerminalCommandFinishedPayload {
4839
+ event: HookEvent;
4840
+ timestamp: ISODateTime;
4841
+ workspace_id: string;
4842
+ profile_id: string;
4843
+ terminal_id?: string;
4844
+ actor_kind: string;
4845
+ actor_id: string;
4846
+ session_id?: string;
4847
+ run_id?: string;
4848
+ generation?: number;
4849
+ at: ISODateTime;
4850
+ command_id: string;
4851
+ exit_code?: number;
4852
+ signal?: string;
4853
+ exit_cause: string;
4854
+ duration_ms: number;
4855
+ detected_by: string;
4856
+ approval: string;
4857
+ }
4858
+ export interface TerminalCommandStartedPayload {
4859
+ event: HookEvent;
4860
+ timestamp: ISODateTime;
4861
+ workspace_id: string;
4862
+ profile_id: string;
4863
+ terminal_id?: string;
4864
+ actor_kind: string;
4865
+ actor_id: string;
4866
+ session_id?: string;
4867
+ run_id?: string;
4868
+ generation?: number;
4869
+ at: ISODateTime;
4870
+ command_id: string;
4871
+ command: string;
4872
+ cwd: string;
4873
+ detected_by: string;
4874
+ }
4875
+ export interface TerminalInputProvidedPayload {
4876
+ event: HookEvent;
4877
+ timestamp: ISODateTime;
4878
+ workspace_id: string;
4879
+ profile_id: string;
4880
+ terminal_id?: string;
4881
+ actor_kind: string;
4882
+ actor_id: string;
4883
+ session_id?: string;
4884
+ run_id?: string;
4885
+ generation?: number;
4886
+ at: ISODateTime;
4887
+ request_id: string;
4888
+ redacted: boolean;
4889
+ length: number;
4890
+ outcome: string;
4891
+ }
4892
+ export interface TerminalInputRequestedPayload {
4893
+ event: HookEvent;
4894
+ timestamp: ISODateTime;
4895
+ workspace_id: string;
4896
+ profile_id: string;
4897
+ terminal_id?: string;
4898
+ actor_kind: string;
4899
+ actor_id: string;
4900
+ session_id?: string;
4901
+ run_id?: string;
4902
+ generation?: number;
4903
+ at: ISODateTime;
4904
+ request_id: string;
4905
+ reason: string;
4906
+ redacted: boolean;
4907
+ }
4908
+ export interface TerminalLimitRejectedPayload {
4909
+ event: HookEvent;
4910
+ timestamp: ISODateTime;
4911
+ workspace_id: string;
4912
+ profile_id: string;
4913
+ terminal_id?: string;
4914
+ actor_kind: string;
4915
+ actor_id: string;
4916
+ session_id?: string;
4917
+ run_id?: string;
4918
+ generation?: number;
4919
+ at: ISODateTime;
4920
+ limit: string;
4921
+ current: number;
4922
+ max: number;
4923
+ }
4924
+ export type TerminalObservationPatch = Record<string, never>;
4925
+ export interface TerminalOpenedPayload {
4926
+ event: HookEvent;
4927
+ timestamp: ISODateTime;
4928
+ workspace_id: string;
4929
+ profile_id: string;
4930
+ terminal_id?: string;
4931
+ actor_kind: string;
4932
+ actor_id: string;
4933
+ session_id?: string;
4934
+ run_id?: string;
4935
+ generation?: number;
4936
+ at: ISODateTime;
4937
+ mode: string;
4938
+ cwd: string;
4939
+ title?: string;
4940
+ }
4941
+ export interface TerminalRecordingStartedPayload {
4942
+ event: HookEvent;
4943
+ timestamp: ISODateTime;
4944
+ workspace_id: string;
4945
+ profile_id: string;
4946
+ terminal_id?: string;
4947
+ actor_kind: string;
4948
+ actor_id: string;
4949
+ session_id?: string;
4950
+ run_id?: string;
4951
+ generation?: number;
4952
+ at: ISODateTime;
4953
+ recording_id: string;
4954
+ }
4955
+ export interface TerminalRecordingStoppedPayload {
4956
+ event: HookEvent;
4957
+ timestamp: ISODateTime;
4958
+ workspace_id: string;
4959
+ profile_id: string;
4960
+ terminal_id?: string;
4961
+ actor_kind: string;
4962
+ actor_id: string;
4963
+ session_id?: string;
4964
+ run_id?: string;
4965
+ generation?: number;
4966
+ at: ISODateTime;
4967
+ recording_id: string;
4968
+ digest: string;
4969
+ bytes: number;
4970
+ reason: string;
4971
+ truncated: boolean;
4972
+ }
4973
+ export interface TerminalSubscriberEvictedPayload {
4974
+ event: HookEvent;
4975
+ timestamp: ISODateTime;
4976
+ workspace_id: string;
4977
+ profile_id: string;
4978
+ terminal_id?: string;
4979
+ actor_kind: string;
4980
+ actor_id: string;
4981
+ session_id?: string;
4982
+ run_id?: string;
4983
+ generation?: number;
4984
+ at: ISODateTime;
4985
+ flow: string;
4986
+ reason: string;
4987
+ }
5294
4988
  export type BackendKind = string;
5295
4989
  export interface BackendRef {
5296
4990
  kind: BackendKind;
@@ -5309,6 +5003,7 @@ export interface SourceRef {
5309
5003
  raw_tool_name?: string;
5310
5004
  resource_id?: string;
5311
5005
  resource_version?: string;
5006
+ profile_id?: string;
5312
5007
  workspace_id?: string;
5313
5008
  scope?: string;
5314
5009
  }
@@ -5353,12 +5048,14 @@ export interface ToolCallRef {
5353
5048
  export interface ToolPostCallPayload {
5354
5049
  event: HookEvent;
5355
5050
  timestamp: ISODateTime;
5051
+ profile_id?: string;
5356
5052
  session_id?: string;
5357
5053
  session_name?: string;
5358
5054
  session_type?: string;
5359
5055
  agent_name?: string;
5360
5056
  workspace_id?: string;
5361
5057
  workspace?: string;
5058
+ worktree_id?: string;
5362
5059
  acp_session_id?: string;
5363
5060
  state?: string;
5364
5061
  soul_snapshot_id?: string;
@@ -5383,12 +5080,14 @@ export interface ToolPostErrorPatch {
5383
5080
  export interface ToolPostErrorPayload {
5384
5081
  event: HookEvent;
5385
5082
  timestamp: ISODateTime;
5083
+ profile_id?: string;
5386
5084
  session_id?: string;
5387
5085
  session_name?: string;
5388
5086
  session_type?: string;
5389
5087
  agent_name?: string;
5390
5088
  workspace_id?: string;
5391
5089
  workspace?: string;
5090
+ worktree_id?: string;
5392
5091
  acp_session_id?: string;
5393
5092
  state?: string;
5394
5093
  soul_snapshot_id?: string;
@@ -5406,12 +5105,14 @@ export interface ToolPostErrorPayload {
5406
5105
  export interface ToolPreCallPayload {
5407
5106
  event: HookEvent;
5408
5107
  timestamp: ISODateTime;
5108
+ profile_id?: string;
5409
5109
  session_id?: string;
5410
5110
  session_name?: string;
5411
5111
  session_type?: string;
5412
5112
  agent_name?: string;
5413
5113
  workspace_id?: string;
5414
5114
  workspace?: string;
5115
+ worktree_id?: string;
5415
5116
  acp_session_id?: string;
5416
5117
  state?: string;
5417
5118
  soul_snapshot_id?: string;
@@ -5446,12 +5147,14 @@ export interface TurnEndPatch {
5446
5147
  export interface TurnEndPayload {
5447
5148
  event: HookEvent;
5448
5149
  timestamp: ISODateTime;
5150
+ profile_id?: string;
5449
5151
  session_id?: string;
5450
5152
  session_name?: string;
5451
5153
  session_type?: string;
5452
5154
  agent_name?: string;
5453
5155
  workspace_id?: string;
5454
5156
  workspace?: string;
5157
+ worktree_id?: string;
5455
5158
  acp_session_id?: string;
5456
5159
  state?: string;
5457
5160
  soul_snapshot_id?: string;
@@ -5470,12 +5173,14 @@ export interface TurnPatch {
5470
5173
  export interface TurnPayload {
5471
5174
  event: HookEvent;
5472
5175
  timestamp: ISODateTime;
5176
+ profile_id?: string;
5473
5177
  session_id?: string;
5474
5178
  session_name?: string;
5475
5179
  session_type?: string;
5476
5180
  agent_name?: string;
5477
5181
  workspace_id?: string;
5478
5182
  workspace?: string;
5183
+ worktree_id?: string;
5479
5184
  acp_session_id?: string;
5480
5185
  state?: string;
5481
5186
  soul_snapshot_id?: string;
@@ -5494,12 +5199,14 @@ export interface TurnStartPatch {
5494
5199
  export interface TurnStartPayload {
5495
5200
  event: HookEvent;
5496
5201
  timestamp: ISODateTime;
5202
+ profile_id?: string;
5497
5203
  session_id?: string;
5498
5204
  session_name?: string;
5499
5205
  session_type?: string;
5500
5206
  agent_name?: string;
5501
5207
  workspace_id?: string;
5502
5208
  workspace?: string;
5209
+ worktree_id?: string;
5503
5210
  acp_session_id?: string;
5504
5211
  state?: string;
5505
5212
  soul_snapshot_id?: string;
@@ -5510,6 +5217,228 @@ export interface TurnStartPayload {
5510
5217
  input_class?: string;
5511
5218
  user_message?: string;
5512
5219
  }
5220
+ export type ProfileLensID = string;
5221
+ export interface ProfileLens {
5222
+ profile_lens_id: ProfileLensID;
5223
+ profile_name: string;
5224
+ }
5225
+ export interface ViewCloseRequest {
5226
+ view_session: string;
5227
+ profile_lens: ProfileLens;
5228
+ reason?: string;
5229
+ }
5230
+ export interface ViewEvent {
5231
+ view_session: string;
5232
+ handler: string;
5233
+ args?: JSONValue[];
5234
+ revision: string;
5235
+ seq: number;
5236
+ generation: number;
5237
+ ack_effects?: string[];
5238
+ effect_result?: EffectResult;
5239
+ }
5240
+ export interface Pagination {
5241
+ has_more: boolean;
5242
+ page_size?: number;
5243
+ }
5244
+ export interface ViewChrome {
5245
+ is_loading?: boolean;
5246
+ search_text?: string;
5247
+ event_count?: number;
5248
+ search_placeholder?: string;
5249
+ throttle_ms?: number;
5250
+ filtering?: boolean;
5251
+ complete?: boolean;
5252
+ active_chip?: string;
5253
+ columns?: number;
5254
+ pagination?: Pagination;
5255
+ on_search?: string;
5256
+ on_chip?: string;
5257
+ on_selection?: string;
5258
+ on_load_more?: string;
5259
+ }
5260
+ export interface ViewBadge {
5261
+ label: string;
5262
+ tone: string;
5263
+ }
5264
+ export interface MetaField {
5265
+ label: string;
5266
+ value: string;
5267
+ requires?: Record<string, string>;
5268
+ fallback?: string;
5269
+ }
5270
+ export interface Confirmation {
5271
+ title: string;
5272
+ body?: string;
5273
+ confirm: string;
5274
+ }
5275
+ export type ActionKind = string;
5276
+ export interface Action {
5277
+ kind: ActionKind;
5278
+ op?: string;
5279
+ tool?: string;
5280
+ view?: string;
5281
+ app?: string;
5282
+ url?: string;
5283
+ args?: Record<string, JSONValue>;
5284
+ }
5285
+ export interface RowAction {
5286
+ title: string;
5287
+ icon?: string;
5288
+ section?: string;
5289
+ primary?: boolean;
5290
+ destructive?: boolean;
5291
+ confirmation?: Confirmation;
5292
+ shortcut?: string;
5293
+ action?: Action;
5294
+ handler?: string;
5295
+ submit_form?: boolean;
5296
+ requires?: Record<string, string>;
5297
+ fallback?: string;
5298
+ }
5299
+ export interface DetailBody {
5300
+ is_loading?: boolean;
5301
+ markdown?: string;
5302
+ metadata?: MetaField[];
5303
+ actions?: RowAction[];
5304
+ }
5305
+ export interface Row {
5306
+ id: string;
5307
+ title: string;
5308
+ subtitle?: string;
5309
+ icon?: string;
5310
+ badge?: ViewBadge;
5311
+ keywords?: string[];
5312
+ accessories?: string[];
5313
+ detail?: DetailBody;
5314
+ actions?: RowAction[];
5315
+ requires?: Record<string, string>;
5316
+ fallback?: string;
5317
+ }
5318
+ export interface Section {
5319
+ title?: string;
5320
+ rows: Row[];
5321
+ }
5322
+ export interface Chip {
5323
+ id: string;
5324
+ label: string;
5325
+ count?: number;
5326
+ requires?: Record<string, string>;
5327
+ fallback?: string;
5328
+ }
5329
+ export interface EmptyState {
5330
+ title: string;
5331
+ hint?: string;
5332
+ icon?: string;
5333
+ }
5334
+ export interface FormField {
5335
+ id: string;
5336
+ type: string;
5337
+ label: string;
5338
+ placeholder?: string;
5339
+ required?: boolean;
5340
+ options?: string[];
5341
+ directories?: boolean;
5342
+ default?: JSONValue;
5343
+ error?: string;
5344
+ empty_hint?: string;
5345
+ on_change?: string;
5346
+ on_blur?: string;
5347
+ event_count?: number;
5348
+ requires?: Record<string, string>;
5349
+ fallback?: string;
5350
+ }
5351
+ export interface FormBody {
5352
+ fields: FormField[];
5353
+ submit?: RowAction;
5354
+ on_submit?: string;
5355
+ }
5356
+ export interface Image {
5357
+ url?: string;
5358
+ token?: string;
5359
+ emoji?: string;
5360
+ }
5361
+ export interface GridTile {
5362
+ id: string;
5363
+ title: string;
5364
+ image: Image;
5365
+ badge?: ViewBadge;
5366
+ actions?: RowAction[];
5367
+ requires?: Record<string, string>;
5368
+ fallback?: string;
5369
+ }
5370
+ export interface GridSection {
5371
+ title?: string;
5372
+ tiles: GridTile[];
5373
+ }
5374
+ export interface GridBody {
5375
+ sections: GridSection[];
5376
+ }
5377
+ export interface ViewPayload {
5378
+ view: string;
5379
+ chrome?: ViewChrome;
5380
+ sections?: Section[];
5381
+ chips?: Chip[];
5382
+ empty?: EmptyState;
5383
+ detail?: DetailBody;
5384
+ form?: FormBody;
5385
+ grid?: GridBody;
5386
+ }
5387
+ export interface PatchOp {
5388
+ op: string;
5389
+ path: string;
5390
+ value?: JSONValue;
5391
+ }
5392
+ export interface ViewPatch {
5393
+ view_id: string;
5394
+ from: string;
5395
+ to: string;
5396
+ ops: PatchOp[];
5397
+ }
5398
+ export interface ToastEffect {
5399
+ tone: string;
5400
+ message: string;
5401
+ }
5402
+ export interface CopyEffect {
5403
+ content: string;
5404
+ }
5405
+ export interface OpenURLEffect {
5406
+ url: string;
5407
+ }
5408
+ export interface OpenAppEffect {
5409
+ app: string;
5410
+ }
5411
+ export interface PickFilesEffect {
5412
+ directories?: boolean;
5413
+ }
5414
+ export interface Effect {
5415
+ id: string;
5416
+ toast?: ToastEffect;
5417
+ copy?: CopyEffect;
5418
+ open_url?: OpenURLEffect;
5419
+ open_app?: OpenAppEffect;
5420
+ pick_files?: PickFilesEffect;
5421
+ }
5422
+ export interface ViewFrame {
5423
+ view_session: string;
5424
+ revision: string;
5425
+ in_reply_to?: number;
5426
+ generation: number;
5427
+ payload?: ViewPayload;
5428
+ patch?: ViewPatch;
5429
+ effects?: Effect[];
5430
+ handlers: string[];
5431
+ }
5432
+ export type WorkspaceID = string;
5433
+ export type ClientID = string;
5434
+ export interface ViewOpenRequest {
5435
+ view_session: string;
5436
+ view: string;
5437
+ profile_lens: ProfileLens;
5438
+ workspace: WorkspaceID;
5439
+ client: ClientID;
5440
+ args?: Record<string, JSONValue>;
5441
+ }
5513
5442
  export interface WindowManagerChanges {
5514
5443
  desktop_ids?: string[];
5515
5444
  window_ids?: string[];
@@ -5614,6 +5543,66 @@ export interface WindowManagerWindowOpenedPayload {
5614
5543
  actor: WindowManagerActor;
5615
5544
  origin?: string;
5616
5545
  }
5546
+ export interface WorktreeControlPatch {
5547
+ deny?: boolean;
5548
+ deny_reason?: string;
5549
+ }
5550
+ export type WorktreeObservationPatch = Record<string, never>;
5551
+ export interface WorktreeObservationPayload {
5552
+ event: HookEvent;
5553
+ timestamp: ISODateTime;
5554
+ profile_id?: string;
5555
+ worktree_id: string;
5556
+ workspace_id: string;
5557
+ workspace_root?: string;
5558
+ name: string;
5559
+ branch: string;
5560
+ path: string;
5561
+ origin: string;
5562
+ run_id?: string;
5563
+ }
5564
+ export interface WorktreePreCreatePayload {
5565
+ event: HookEvent;
5566
+ timestamp: ISODateTime;
5567
+ profile_id?: string;
5568
+ worktree_id: string;
5569
+ workspace_id: string;
5570
+ workspace_root?: string;
5571
+ name: string;
5572
+ branch: string;
5573
+ path: string;
5574
+ origin: string;
5575
+ run_id?: string;
5576
+ denied?: boolean;
5577
+ deny_reason?: string;
5578
+ }
5579
+ export interface WorktreeContext {
5580
+ profile_id?: string;
5581
+ worktree_id: string;
5582
+ workspace_id: string;
5583
+ workspace_root?: string;
5584
+ name: string;
5585
+ branch: string;
5586
+ path: string;
5587
+ origin: string;
5588
+ run_id?: string;
5589
+ }
5590
+ export interface WorktreeRisk {
5591
+ changed_files: number;
5592
+ insertions: number;
5593
+ deletions: number;
5594
+ unpushed_commits: number;
5595
+ exists_on_remote: boolean;
5596
+ }
5597
+ export interface WorktreePreRemovePayload {
5598
+ event: HookEvent;
5599
+ timestamp: ISODateTime;
5600
+ worktree: WorktreeContext;
5601
+ force: boolean;
5602
+ risk: WorktreeRisk;
5603
+ denied?: boolean;
5604
+ deny_reason?: string;
5605
+ }
5617
5606
  export interface HookPayloadByEvent {
5618
5607
  "session.pre_create": SessionPreCreatePayload;
5619
5608
  "session.post_create": SessionPostCreatePayload;
@@ -5622,11 +5611,9 @@ export interface HookPayloadByEvent {
5622
5611
  "session.pre_stop": SessionPreStopPayload;
5623
5612
  "session.post_stop": SessionPostStopPayload;
5624
5613
  "session.message_persisted": SessionMessagePersistedPayload;
5625
- "sandbox.prepare": SandboxPreparePayload;
5626
- "sandbox.ready": SandboxReadyPayload;
5627
- "sandbox.sync.before": SandboxSyncBeforePayload;
5628
- "sandbox.sync.after": SandboxSyncAfterPayload;
5629
- "sandbox.stop": SandboxStopPayload;
5614
+ "session.runtime_recovery.started": SessionRuntimeRecoveryStartedPayload;
5615
+ "session.runtime_recovery.succeeded": SessionRuntimeRecoverySucceededPayload;
5616
+ "session.runtime_recovery.exhausted": SessionRuntimeRecoveryExhaustedPayload;
5630
5617
  "input.pre_submit": InputPreSubmitPayload;
5631
5618
  "prompt.post_assemble": PromptPayload;
5632
5619
  "event.pre_record": EventPreRecordPayload;
@@ -5691,16 +5678,7 @@ export interface HookPayloadByEvent {
5691
5678
  "spawn.parent_stopped": SpawnParentStoppedPayload;
5692
5679
  "spawn.ttl_expired": SpawnTTLExpiredPayload;
5693
5680
  "spawn.reaped": SpawnReapedPayload;
5694
- "network.thread.opened": NetworkThreadOpenedPayload;
5695
- "network.direct_room.opened": NetworkDirectRoomOpenedPayload;
5696
- "network.message.persisted": NetworkMessagePersistedPayload;
5697
- "network.work.opened": NetworkWorkOpenedPayload;
5698
- "network.work.transitioned": NetworkWorkTransitionedPayload;
5699
- "network.work.closed": NetworkWorkClosedPayload;
5700
- "network.peer.joined": NetworkPeerJoinedPayload;
5701
- "network.peer.left": NetworkPeerLeftPayload;
5702
- "network.participation.pre_resolve": NetworkParticipationPreResolvePayload;
5703
- "network.participation.resolved": NetworkParticipationResolvedPayload;
5681
+ "session.attention.changed": SessionAttentionChangedPayload;
5704
5682
  "window_manager.layout.applied": WindowManagerLayoutAppliedPayload;
5705
5683
  "window_manager.desktop.created": WindowManagerDesktopCreatedPayload;
5706
5684
  "window_manager.desktop.deleted": WindowManagerDesktopDeletedPayload;
@@ -5710,6 +5688,21 @@ export interface HookPayloadByEvent {
5710
5688
  "window_manager.stack.grouped": WindowManagerStackGroupedPayload;
5711
5689
  "window_manager.stack.ungrouped": WindowManagerStackUngroupedPayload;
5712
5690
  "window_manager.stack.activated": WindowManagerStackActivatedPayload;
5691
+ "worktree.pre_create": WorktreePreCreatePayload;
5692
+ "worktree.pre_remove": WorktreePreRemovePayload;
5693
+ "worktree.created": WorktreeObservationPayload;
5694
+ "worktree.adopted": WorktreeObservationPayload;
5695
+ "worktree.removed": WorktreeObservationPayload;
5696
+ "terminal.opened": TerminalOpenedPayload;
5697
+ "terminal.closed": TerminalClosedPayload;
5698
+ "terminal.command_started": TerminalCommandStartedPayload;
5699
+ "terminal.command_finished": TerminalCommandFinishedPayload;
5700
+ "terminal.input_requested": TerminalInputRequestedPayload;
5701
+ "terminal.input_provided": TerminalInputProvidedPayload;
5702
+ "terminal.recording_started": TerminalRecordingStartedPayload;
5703
+ "terminal.recording_stopped": TerminalRecordingStoppedPayload;
5704
+ "terminal.subscriber_evicted": TerminalSubscriberEvictedPayload;
5705
+ "terminal.limit_rejected": TerminalLimitRejectedPayload;
5713
5706
  }
5714
5707
  export interface HookPatchByEvent {
5715
5708
  "session.pre_create": SessionCreatePatch;
@@ -5719,11 +5712,9 @@ export interface HookPatchByEvent {
5719
5712
  "session.pre_stop": SessionPreStopPatch;
5720
5713
  "session.post_stop": SessionPostStopPatch;
5721
5714
  "session.message_persisted": AuthoredContextObservationPatch;
5722
- "sandbox.prepare": SandboxPreparePatch;
5723
- "sandbox.ready": SandboxReadyPatch;
5724
- "sandbox.sync.before": SandboxSyncBeforePatch;
5725
- "sandbox.sync.after": SandboxSyncAfterPatch;
5726
- "sandbox.stop": SandboxStopPatch;
5715
+ "session.runtime_recovery.started": AuthoredContextObservationPatch;
5716
+ "session.runtime_recovery.succeeded": AuthoredContextObservationPatch;
5717
+ "session.runtime_recovery.exhausted": AuthoredContextObservationPatch;
5727
5718
  "input.pre_submit": InputPreSubmitPatch;
5728
5719
  "prompt.post_assemble": PromptPatch;
5729
5720
  "event.pre_record": EventPreRecordPatch;
@@ -5788,16 +5779,7 @@ export interface HookPatchByEvent {
5788
5779
  "spawn.parent_stopped": SpawnObservationPatch;
5789
5780
  "spawn.ttl_expired": SpawnObservationPatch;
5790
5781
  "spawn.reaped": SpawnObservationPatch;
5791
- "network.thread.opened": NetworkObservationPatch;
5792
- "network.direct_room.opened": NetworkObservationPatch;
5793
- "network.message.persisted": NetworkObservationPatch;
5794
- "network.work.opened": NetworkObservationPatch;
5795
- "network.work.transitioned": NetworkObservationPatch;
5796
- "network.work.closed": NetworkObservationPatch;
5797
- "network.peer.joined": NetworkObservationPatch;
5798
- "network.peer.left": NetworkObservationPatch;
5799
- "network.participation.pre_resolve": NetworkParticipationPreResolvePatch;
5800
- "network.participation.resolved": NetworkParticipationResolvedPatch;
5782
+ "session.attention.changed": SessionAttentionObservationPatch;
5801
5783
  "window_manager.layout.applied": WindowManagerObservationPatch;
5802
5784
  "window_manager.desktop.created": WindowManagerObservationPatch;
5803
5785
  "window_manager.desktop.deleted": WindowManagerObservationPatch;
@@ -5807,6 +5789,21 @@ export interface HookPatchByEvent {
5807
5789
  "window_manager.stack.grouped": WindowManagerObservationPatch;
5808
5790
  "window_manager.stack.ungrouped": WindowManagerObservationPatch;
5809
5791
  "window_manager.stack.activated": WindowManagerObservationPatch;
5792
+ "worktree.pre_create": WorktreeControlPatch;
5793
+ "worktree.pre_remove": WorktreeControlPatch;
5794
+ "worktree.created": WorktreeObservationPatch;
5795
+ "worktree.adopted": WorktreeObservationPatch;
5796
+ "worktree.removed": WorktreeObservationPatch;
5797
+ "terminal.opened": TerminalObservationPatch;
5798
+ "terminal.closed": TerminalObservationPatch;
5799
+ "terminal.command_started": TerminalObservationPatch;
5800
+ "terminal.command_finished": TerminalObservationPatch;
5801
+ "terminal.input_requested": TerminalObservationPatch;
5802
+ "terminal.input_provided": TerminalObservationPatch;
5803
+ "terminal.recording_started": TerminalObservationPatch;
5804
+ "terminal.recording_stopped": TerminalObservationPatch;
5805
+ "terminal.subscriber_evicted": TerminalObservationPatch;
5806
+ "terminal.limit_rejected": TerminalObservationPatch;
5810
5807
  }
5811
5808
  export interface HostAPIMethodMap {
5812
5809
  "sessions/list": {
@@ -5821,10 +5818,42 @@ export interface HostAPIMethodMap {
5821
5818
  params: SessionsPromptParams;
5822
5819
  result: SessionPromptResult;
5823
5820
  };
5821
+ "sessions/runtime/set": {
5822
+ params: SessionRuntimeSetParams;
5823
+ result: SessionStatus;
5824
+ };
5825
+ "sessions/runtime/clear": {
5826
+ params: SessionRuntimeClearParams;
5827
+ result: SessionStatus;
5828
+ };
5829
+ "sessions/inputs/list": {
5830
+ params: SessionInputsListParams;
5831
+ result: SessionInputListResult;
5832
+ };
5833
+ "sessions/inputs/replace": {
5834
+ params: SessionInputReplaceParams;
5835
+ result: SessionInputResult;
5836
+ };
5837
+ "sessions/inputs/cancel": {
5838
+ params: SessionInputTargetParams;
5839
+ result: SessionPromptResult;
5840
+ };
5841
+ "sessions/inputs/promote": {
5842
+ params: SessionInputPromoteParams;
5843
+ result: SessionPromptResult;
5844
+ };
5824
5845
  "sessions/stop": {
5825
5846
  params: SessionTargetParams;
5826
5847
  result: EmptyResult;
5827
5848
  };
5849
+ "sessions/archive": {
5850
+ params: SessionTargetParams;
5851
+ result: SessionStatus;
5852
+ };
5853
+ "sessions/unarchive": {
5854
+ params: SessionTargetParams;
5855
+ result: SessionStatus;
5856
+ };
5828
5857
  "sessions/status": {
5829
5858
  params: SessionTargetParams;
5830
5859
  result: SessionStatus;
@@ -5845,18 +5874,6 @@ export interface HostAPIMethodMap {
5845
5874
  params: SessionStatusGetParams;
5846
5875
  result: SessionStatusResponse;
5847
5876
  };
5848
- "sandbox/list": {
5849
- params: SandboxListParams | undefined;
5850
- result: SandboxListResult;
5851
- };
5852
- "sandbox/info": {
5853
- params: SandboxInfoParams;
5854
- result: SandboxInfoResult;
5855
- };
5856
- "sandbox/exec": {
5857
- params: SandboxExecParams;
5858
- result: SandboxExecResult;
5859
- };
5860
5877
  "memory/recall": {
5861
5878
  params: MemoryRecallParams;
5862
5879
  result: MemoryRecallEntry[];
@@ -5949,6 +5966,10 @@ export interface HostAPIMethodMap {
5949
5966
  params: AgentHeartbeatWakeParams;
5950
5967
  result: HeartbeatWakeResponse;
5951
5968
  };
5969
+ "view/patch": {
5970
+ params: ViewFrame;
5971
+ result: EmptyResult;
5972
+ };
5952
5973
  "automation/jobs": {
5953
5974
  params: AutomationJobsParams | undefined;
5954
5975
  result: AutomationJobsResult;
@@ -6053,6 +6074,10 @@ export interface HostAPIMethodMap {
6053
6074
  params: TaskRunGetParams;
6054
6075
  result: TaskRunDetail;
6055
6076
  };
6077
+ "tasks/runs/result": {
6078
+ params: TaskRunResultParams;
6079
+ result: TaskRunResultPage;
6080
+ };
6056
6081
  "tasks/runs/enqueue": {
6057
6082
  params: TaskRunEnqueueParams;
6058
6083
  result: TaskRun;
@@ -6077,54 +6102,6 @@ export interface HostAPIMethodMap {
6077
6102
  params: TaskRunCancelParams;
6078
6103
  result: TaskRun;
6079
6104
  };
6080
- "network/status": {
6081
- params: undefined;
6082
- result: NetworkStatusPayload;
6083
- };
6084
- "network/usage": {
6085
- params: NetworkUsageParams;
6086
- result: NetworkUsageResponse;
6087
- };
6088
- "network/channels": {
6089
- params: NetworkChannelsParams;
6090
- result: NetworkChannelPayload[];
6091
- };
6092
- "network/peers": {
6093
- params: NetworkPeersParams;
6094
- result: NetworkPeerPayload[];
6095
- };
6096
- "network/threads": {
6097
- params: NetworkThreadsParams;
6098
- result: NetworkThreadsResponse;
6099
- };
6100
- "network/thread/get": {
6101
- params: NetworkThreadTargetParams;
6102
- result: NetworkThreadSummaryPayload;
6103
- };
6104
- "network/thread/messages": {
6105
- params: NetworkThreadMessagesParams;
6106
- result: NetworkThreadMessagesResponse;
6107
- };
6108
- "network/directs": {
6109
- params: NetworkDirectsParams;
6110
- result: NetworkDirectRoomsResponse;
6111
- };
6112
- "network/direct/resolve": {
6113
- params: NetworkDirectResolveParams;
6114
- result: NetworkDirectRoomPayload;
6115
- };
6116
- "network/direct/messages": {
6117
- params: NetworkDirectMessagesParams;
6118
- result: NetworkDirectRoomMessagesResponse;
6119
- };
6120
- "network/work/get": {
6121
- params: NetworkWorkGetParams;
6122
- result: NetworkWorkPayload;
6123
- };
6124
- "network/send": {
6125
- params: NetworkSendParams;
6126
- result: NetworkSendPayload;
6127
- };
6128
6105
  "resources/list": {
6129
6106
  params: ResourcesListParams | undefined;
6130
6107
  result: ResourceRecord[];
@@ -6137,33 +6114,19 @@ export interface HostAPIMethodMap {
6137
6114
  params: ResourcesSnapshotParams;
6138
6115
  result: EmptyResult;
6139
6116
  };
6140
- "bridges/instances/list": {
6141
- params: undefined;
6142
- result: BridgeInstance[];
6143
- };
6144
- "bridges/messages/ingest": {
6145
- params: InboundMessageEnvelope;
6146
- result: BridgesMessagesIngestResult;
6147
- };
6148
- "bridges/instances/get": {
6149
- params: BridgeInstanceTargetParams;
6150
- result: BridgeInstance;
6151
- };
6152
- "bridges/instances/report_state": {
6153
- params: BridgesInstancesReportStateParams;
6154
- result: BridgeInstance;
6155
- };
6156
6117
  "clarify/ask": {
6157
6118
  params: ClarifyAskParams;
6158
6119
  result: ClarifyAnswer;
6159
6120
  };
6160
6121
  }
6161
6122
  export declare const REQUIRED_METHODS_BY_PROVIDE: {
6162
- readonly "bridge.adapter": readonly ["bridges/deliver", "bridges/targets/snapshot"];
6123
+ readonly "connectivity.provider": readonly ["connectivity/establish", "connectivity/status", "connectivity/teardown"];
6124
+ readonly "forge.provider": readonly ["forge/capabilities", "forge/pr_create", "forge/status"];
6163
6125
  readonly "loop.watch_source": readonly ["watch/poll"];
6164
6126
  readonly "memory.backend": readonly ["memory/forget", "memory/recall", "memory/store"];
6165
6127
  readonly "model.source": readonly ["models/list"];
6166
6128
  readonly "tool.provider": readonly ["provide_tools", "tools/call"];
6129
+ readonly "view.provider": readonly ["view/close", "view/event", "view/open"];
6167
6130
  };
6168
6131
  export interface ProvideConformanceFixture {
6169
6132
  provide: string;