@compozy/extension-sdk 0.3.0-beta.27 → 0.3.0-beta.29

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.
@@ -1,5 +1,5 @@
1
1
  import type { ISODateTime, JSONValue } from "../base-types.js";
2
- export type HostAPIMethod = "agents/heartbeat/delete" | "agents/heartbeat/get" | "agents/heartbeat/history" | "agents/heartbeat/put" | "agents/heartbeat/rollback" | "agents/heartbeat/status" | "agents/heartbeat/validate" | "agents/heartbeat/wake" | "agents/soul/delete" | "agents/soul/get" | "agents/soul/history" | "agents/soul/put" | "agents/soul/rollback" | "agents/soul/validate" | "automation/jobs" | "automation/jobs/create" | "automation/jobs/delete" | "automation/jobs/get" | "automation/jobs/runs" | "automation/jobs/trigger" | "automation/jobs/update" | "automation/runs" | "automation/triggers" | "automation/triggers/create" | "automation/triggers/delete" | "automation/triggers/fire" | "automation/triggers/get" | "automation/triggers/runs" | "automation/triggers/update" | "bridges/instances/get" | "bridges/instances/list" | "bridges/instances/report_state" | "bridges/messages/ingest" | "clarify/ask" | "logs/list" | "memory/forget" | "memory/recall" | "memory/store" | "models/list" | "models/refresh" | "models/status" | "network/channels" | "network/direct/messages" | "network/direct/resolve" | "network/directs" | "network/peers" | "network/send" | "network/status" | "network/thread/get" | "network/thread/messages" | "network/threads" | "network/usage" | "network/work/get" | "observe/health" | "resources/get" | "resources/list" | "resources/snapshot" | "sandbox/exec" | "sandbox/info" | "sandbox/list" | "sessions/archive" | "sessions/create" | "sessions/events" | "sessions/health/get" | "sessions/inputs/cancel" | "sessions/inputs/list" | "sessions/inputs/promote" | "sessions/inputs/replace" | "sessions/list" | "sessions/prompt" | "sessions/runtime/clear" | "sessions/runtime/set" | "sessions/soul/refresh" | "sessions/status" | "sessions/status/get" | "sessions/stop" | "sessions/unarchive" | "skills/list" | "tasks" | "tasks/cancel" | "tasks/create" | "tasks/dashboard" | "tasks/get" | "tasks/inbox" | "tasks/runs" | "tasks/runs/attach_session" | "tasks/runs/cancel" | "tasks/runs/complete" | "tasks/runs/enqueue" | "tasks/runs/fail" | "tasks/runs/get" | "tasks/runs/result" | "tasks/runs/start" | "tasks/timeline" | "tasks/tree" | "tasks/update" | "view/patch";
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,7 +7,7 @@ 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" | "session.runtime_recovery.started" | "session.runtime_recovery.succeeded" | "session.runtime_recovery.exhausted" | "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" | "session.attention.changed" | "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" | "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";
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;
@@ -507,39 +507,16 @@ export interface Ownership {
507
507
  kind: OwnerKind;
508
508
  ref: string;
509
509
  }
510
- export type NetworkParticipationRequest = {
511
- mode?: "local";
512
- channel_strategy?: never;
513
- channel_id?: never;
514
- bounds?: never;
515
- } | {
516
- mode: "live";
517
- channel_strategy: "named";
518
- channel_id: string;
519
- bounds?: NetworkParticipationBoundsRequest;
520
- } | {
521
- mode: "live";
522
- channel_strategy: "run";
523
- channel_id?: never;
524
- bounds?: NetworkParticipationBoundsRequest;
525
- } | {
526
- mode: "live";
527
- channel_strategy: "loop_run";
528
- channel_id?: never;
529
- bounds?: NetworkParticipationBoundsRequest;
530
- };
531
510
  export interface JobTaskConfig {
532
511
  title?: string;
533
512
  description?: string;
534
513
  owner?: Ownership;
535
- network_participation?: NetworkParticipationRequest;
536
514
  }
537
515
  export interface LoopTarget {
538
516
  workspace_id: string;
539
517
  loop_name: string;
540
518
  inputs?: Record<string, JSONValue>;
541
519
  input_mapping?: Record<string, string>;
542
- network_participation?: NetworkParticipationRequest;
543
520
  }
544
521
  export type RetryStrategy = string;
545
522
  export interface RetryConfig {
@@ -805,7 +782,6 @@ export interface AutonomyMatcher {
805
782
  loop_name?: string;
806
783
  node_id?: string;
807
784
  workflow_id?: string;
808
- participation_channel?: string;
809
785
  coordinator_session_id?: string;
810
786
  parent_session_id?: string;
811
787
  root_session_id?: string;
@@ -816,103 +792,6 @@ export interface AutonomyMatcher {
816
792
  export interface AutonomyObservationPatch {
817
793
  labels?: Record<string, string>;
818
794
  }
819
- export type BridgeCheckStatus = "pass" | "warn" | "fail" | "skipped";
820
- export interface BridgeCheckRecord {
821
- check: string;
822
- status: BridgeCheckStatus;
823
- remediation: string;
824
- }
825
- export interface BridgeCheckRequest {
826
- bridge_instance_id: string;
827
- }
828
- export interface BridgeCheckResponse {
829
- checks: BridgeCheckRecord[];
830
- }
831
- export type BridgeScope = string;
832
- export type BridgeInstanceSource = string;
833
- export type BridgeStatus = string;
834
- export type BridgeDMPolicy = string;
835
- export interface RoutingPolicy {
836
- include_peer: boolean;
837
- include_thread: boolean;
838
- include_group: boolean;
839
- }
840
- export type BridgeDegradationReason = string;
841
- export interface BridgeDegradation {
842
- reason: BridgeDegradationReason;
843
- message?: string;
844
- }
845
- export interface BridgeInstance {
846
- id: string;
847
- profile_id: string;
848
- profile_name?: string;
849
- profile_color?: string;
850
- profile_icon?: string;
851
- profile_emoji?: string;
852
- profile_archived?: boolean;
853
- scope: BridgeScope;
854
- workspace_id?: string;
855
- platform: string;
856
- extension_name: string;
857
- display_name: string;
858
- source?: BridgeInstanceSource;
859
- enabled: boolean;
860
- status: BridgeStatus;
861
- dm_policy?: BridgeDMPolicy;
862
- routing_policy: RoutingPolicy;
863
- provider_config?: JSONValue;
864
- delivery_defaults?: JSONValue;
865
- notification_suppress: boolean;
866
- degradation?: BridgeDegradation;
867
- created_at: ISODateTime;
868
- updated_at: ISODateTime;
869
- }
870
- export interface BridgeInstanceTargetParams {
871
- bridge_instance_id: string;
872
- }
873
- export type BridgeRuntimePurpose = "service" | "control";
874
- export type BridgeTargetType = string;
875
- export interface BridgeTargetSnapshot {
876
- canonical_route: string;
877
- display_name: string;
878
- target_type: BridgeTargetType;
879
- qualifier?: string;
880
- capabilities?: string[];
881
- last_seen_at?: ISODateTime;
882
- }
883
- export interface BridgeTargetSnapshotRequest {
884
- bridge_instance_id: string;
885
- }
886
- export interface BridgeTargetSnapshotResponse {
887
- targets: BridgeTargetSnapshot[];
888
- }
889
- export interface BridgeWebhookRegistrationRequest {
890
- bridge_instance_id: string;
891
- public_url?: string;
892
- }
893
- export interface BridgeWebhookRegistrationResponse {
894
- status: BridgeCheckStatus;
895
- remediation: string;
896
- }
897
- export interface BridgesInstancesReportStateParams {
898
- bridge_instance_id: string;
899
- status: BridgeStatus;
900
- degradation?: BridgeDegradation;
901
- clear_degradation?: boolean;
902
- }
903
- export interface RoutingKey {
904
- scope: BridgeScope;
905
- workspace_id?: string;
906
- bridge_instance_id: string;
907
- peer_id?: string;
908
- thread_id?: string;
909
- group_id?: string;
910
- }
911
- export interface BridgesMessagesIngestResult {
912
- session_id: string;
913
- route_created: boolean;
914
- routing_key: RoutingKey;
915
- }
916
795
  export interface ClarifyAnswer {
917
796
  choice?: number;
918
797
  text: string;
@@ -1121,28 +1000,10 @@ export interface ContextPreCompactPayload {
1121
1000
  summary?: string;
1122
1001
  context_blocks?: ContextBlock[];
1123
1002
  }
1124
- export type ControlMethod = "bridges/check" | "bridges/webhook/register";
1125
1003
  export interface ControlPatch {
1126
1004
  deny?: boolean;
1127
1005
  deny_reason?: string;
1128
1006
  }
1129
- export type NetworkParticipationSpec = {
1130
- version: "network-participation/v1";
1131
- mode: "local";
1132
- workspace_id?: never;
1133
- channel_strategy?: never;
1134
- channel_id?: never;
1135
- source: NetworkParticipationSource;
1136
- bounds?: never;
1137
- } | {
1138
- version: "network-participation/v1";
1139
- mode: "live";
1140
- workspace_id: string;
1141
- channel_strategy: "named" | "run" | "loop_run";
1142
- channel_id: string;
1143
- source: NetworkParticipationSource;
1144
- bounds: NetworkParticipationBounds;
1145
- };
1146
1007
  export interface CoordinatorContext {
1147
1008
  profile_id?: string;
1148
1009
  workspace_id?: string;
@@ -1152,7 +1013,6 @@ export interface CoordinatorContext {
1152
1013
  task_id?: string;
1153
1014
  run_id?: string;
1154
1015
  workflow_id?: string;
1155
- resolved_network_participation?: NetworkParticipationSpec;
1156
1016
  provider?: string;
1157
1017
  model?: string;
1158
1018
  }
@@ -1167,7 +1027,6 @@ export interface CoordinatorDecisionPayload {
1167
1027
  task_id?: string;
1168
1028
  run_id?: string;
1169
1029
  workflow_id?: string;
1170
- resolved_network_participation?: NetworkParticipationSpec;
1171
1030
  provider?: string;
1172
1031
  model?: string;
1173
1032
  decision_kind?: string;
@@ -1186,7 +1045,6 @@ export interface CoordinatorFailedPayload {
1186
1045
  task_id?: string;
1187
1046
  run_id?: string;
1188
1047
  workflow_id?: string;
1189
- resolved_network_participation?: NetworkParticipationSpec;
1190
1048
  provider?: string;
1191
1049
  model?: string;
1192
1050
  decision_kind?: string;
@@ -1205,7 +1063,6 @@ export interface CoordinatorLifecyclePayload {
1205
1063
  task_id?: string;
1206
1064
  run_id?: string;
1207
1065
  workflow_id?: string;
1208
- resolved_network_participation?: NetworkParticipationSpec;
1209
1066
  provider?: string;
1210
1067
  model?: string;
1211
1068
  decision_kind?: string;
@@ -1227,7 +1084,6 @@ export interface CoordinatorPreSpawnPayload {
1227
1084
  task_id?: string;
1228
1085
  run_id?: string;
1229
1086
  workflow_id?: string;
1230
- resolved_network_participation?: NetworkParticipationSpec;
1231
1087
  provider?: string;
1232
1088
  model?: string;
1233
1089
  reason?: string;
@@ -1252,7 +1108,6 @@ export interface CoordinatorSpawnedPayload {
1252
1108
  task_id?: string;
1253
1109
  run_id?: string;
1254
1110
  workflow_id?: string;
1255
- resolved_network_participation?: NetworkParticipationSpec;
1256
1111
  provider?: string;
1257
1112
  model?: string;
1258
1113
  decision_kind?: string;
@@ -1271,7 +1126,6 @@ export interface CoordinatorStoppedPayload {
1271
1126
  task_id?: string;
1272
1127
  run_id?: string;
1273
1128
  workflow_id?: string;
1274
- resolved_network_participation?: NetworkParticipationSpec;
1275
1129
  provider?: string;
1276
1130
  model?: string;
1277
1131
  decision_kind?: string;
@@ -1279,100 +1133,12 @@ export interface CoordinatorStoppedPayload {
1279
1133
  stop_reason?: string;
1280
1134
  error?: string;
1281
1135
  }
1282
- export type DeliveryAckOutcome = "success" | "committed_result_unavailable";
1283
- export interface DeliveryErrorDetail {
1284
- message: string;
1285
- }
1286
- export interface DeliveryAck {
1287
- delivery_id: string;
1288
- seq: number;
1289
- remote_message_id?: string;
1290
- replace_remote_message_id?: string;
1291
- outcome?: DeliveryAckOutcome;
1292
- error?: DeliveryErrorDetail;
1293
- }
1294
- export type DeliveryMode = string;
1295
- export interface DeliveryTarget {
1296
- bridge_instance_id: string;
1297
- peer_id?: string;
1298
- thread_id?: string;
1299
- group_id?: string;
1300
- mode?: DeliveryMode;
1301
- }
1302
- export type DeliveryEventType = "start" | "delta" | "final" | "error" | "resume" | "delete" | "progress";
1303
- export interface MessageContent {
1304
- text?: string;
1305
- }
1306
- export type DeliveryOperation = string;
1307
- export interface DeliveryMessageReference {
1308
- delivery_id?: string;
1309
- remote_message_id?: string;
1310
- }
1311
- export interface DeliveryResumeState {
1312
- latest_event_type: DeliveryEventType;
1313
- }
1314
- export type ToolProgressPhase = "started" | "completed" | "failed";
1315
- export interface ToolProgress {
1316
- tool_call_id: string;
1317
- tool_id: string;
1318
- phase: ToolProgressPhase;
1319
- label: string;
1320
- preview?: string;
1321
- emoji?: string;
1322
- duration_ms?: number;
1323
- error?: string;
1324
- index: number;
1325
- }
1326
- export interface DeliveryEvent {
1327
- delivery_id: string;
1328
- bridge_instance_id: string;
1329
- routing_key: RoutingKey;
1330
- delivery_target: DeliveryTarget;
1331
- seq: number;
1332
- event_type: DeliveryEventType;
1333
- content: MessageContent;
1334
- final: boolean;
1335
- operation?: DeliveryOperation;
1336
- reference?: DeliveryMessageReference;
1337
- error?: DeliveryErrorDetail;
1338
- resume?: DeliveryResumeState;
1339
- progress?: ToolProgress;
1340
- provider_metadata?: JSONValue;
1341
- }
1342
- export interface DeliverySnapshot {
1343
- delivery_id: string;
1344
- session_id: string;
1345
- turn_id: string;
1346
- bridge_instance_id: string;
1347
- routing_key: RoutingKey;
1348
- delivery_target: DeliveryTarget;
1349
- latest_seq: number;
1350
- latest_event_type: DeliveryEventType;
1351
- current_content: MessageContent;
1352
- operation?: DeliveryOperation;
1353
- reference?: DeliveryMessageReference;
1354
- provider_metadata?: JSONValue;
1355
- last_sent_seq?: number;
1356
- last_acked_seq?: number;
1357
- remote_message_id?: string;
1358
- replace_remote_message_id?: string;
1359
- final: boolean;
1360
- error?: string;
1361
- updated_at: ISODateTime;
1362
- }
1363
- export interface DeliveryRequest {
1364
- event: DeliveryEvent;
1365
- snapshot?: DeliverySnapshot;
1366
- }
1367
- export interface DescribeNetworkParticipation {
1368
- required: boolean;
1369
- mode: string;
1370
- channel_scopes?: string[];
1136
+ export interface DescribeGatewayRequirement {
1137
+ permissions: string[];
1371
1138
  }
1372
1139
  export interface DescribeProfileDefaults {
1373
1140
  agent?: string;
1374
1141
  provider?: string;
1375
- sandbox?: string;
1376
1142
  }
1377
1143
  export interface DescribeProfileCredential {
1378
1144
  provider: string;
@@ -1453,7 +1219,7 @@ export interface DescribePayload {
1453
1219
  profiles?: DescribeProfile[];
1454
1220
  resources: DescribeResources;
1455
1221
  subprocess: DescribeSubprocess;
1456
- network_participation?: DescribeNetworkParticipation;
1222
+ gateway?: DescribeGatewayRequirement;
1457
1223
  tools?: ExtensionToolRuntimeDescriptor[];
1458
1224
  hook_events?: DescribeHookEvent[];
1459
1225
  watch_source_kinds?: string[];
@@ -1640,6 +1406,7 @@ export interface ForgeCapabilitiesResponse {
1640
1406
  export interface ForgePRCreateRequest {
1641
1407
  remote_urls: string[];
1642
1408
  head: string;
1409
+ head_sha?: string;
1643
1410
  base: string;
1644
1411
  title: string;
1645
1412
  body?: string;
@@ -1654,12 +1421,18 @@ export interface ForgePRCreateResponse {
1654
1421
  export interface ForgeStatusRequest {
1655
1422
  remote_urls: string[];
1656
1423
  branch: string;
1424
+ base?: string;
1425
+ head_sha?: string;
1657
1426
  }
1658
1427
  export interface ForgeStatusResponse {
1659
1428
  provider: string;
1660
1429
  pr_number?: number;
1661
1430
  pr_state?: string;
1662
1431
  pr_url?: string;
1432
+ head?: string;
1433
+ base?: string;
1434
+ head_sha?: string;
1435
+ draft?: boolean;
1663
1436
  merged?: boolean;
1664
1437
  fetched_at: ISODateTime;
1665
1438
  cause?: string;
@@ -1905,10 +1678,6 @@ export interface HookMatcher {
1905
1678
  worktree_id?: string;
1906
1679
  workspace_root?: string;
1907
1680
  session_type?: string;
1908
- sandbox_id?: string;
1909
- sandbox_backend?: string;
1910
- sandbox_profile?: string;
1911
- sync_direction?: string;
1912
1681
  input_class?: string;
1913
1682
  acp_event_type?: string;
1914
1683
  turn_id?: string;
@@ -1918,13 +1687,6 @@ export interface HookMatcher {
1918
1687
  decision_class?: string;
1919
1688
  message_role?: string;
1920
1689
  message_delta_type?: string;
1921
- channel?: string;
1922
- surface?: string;
1923
- kind?: string;
1924
- direction?: string;
1925
- work_state?: string;
1926
- participation_mode?: string;
1927
- participation_source?: string;
1928
1690
  compaction_reason?: string;
1929
1691
  compaction_strategy?: string;
1930
1692
  autonomy?: AutonomyMatcher;
@@ -1949,97 +1711,9 @@ export interface HookDecl {
1949
1711
  source: HookSource;
1950
1712
  required?: boolean;
1951
1713
  }
1952
- export type HookEventFamily = "session" | "sandbox" | "input" | "prompt" | "event" | "automation" | "agent" | "turn" | "message" | "tool" | "permission" | "context" | "coordinator" | "task" | "task.run" | "loop" | "spawn" | "network" | "window_manager" | "worktree" | "terminal";
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";
1953
1715
  export type HookRunOutcome = "applied" | "denied" | "failed" | "skipped" | "dropped" | "rejected";
1954
1716
  export type HookSkillSource = "bundled" | "marketplace" | "user" | "profile" | "additional" | "workspace" | "workspace_profile";
1955
- export interface InboundAction {
1956
- action_id: string;
1957
- message_id?: string;
1958
- value?: string;
1959
- trigger_id?: string;
1960
- }
1961
- export interface InboundCommand {
1962
- command: string;
1963
- text?: string;
1964
- trigger_id?: string;
1965
- }
1966
- export type InboundEditOperation = "updated" | "deleted";
1967
- export interface InboundEdit {
1968
- message_id: string;
1969
- new_text: string;
1970
- original_timestamp: ISODateTime;
1971
- operation: InboundEditOperation;
1972
- }
1973
- export type InboundEventFamily = "message" | "command" | "action" | "reaction" | "edit";
1974
- export interface MessageSender {
1975
- id?: string;
1976
- username?: string;
1977
- display_name?: string;
1978
- }
1979
- export interface MessageAttachment {
1980
- id?: string;
1981
- name?: string;
1982
- mime_type?: string;
1983
- url?: string;
1984
- }
1985
- export interface InboundReaction {
1986
- message_id: string;
1987
- emoji: string;
1988
- raw_emoji?: string;
1989
- added: boolean;
1990
- }
1991
- export type NetworkConversationSurface = string;
1992
- export interface NetworkConversationRef {
1993
- channel: string;
1994
- surface: NetworkConversationSurface;
1995
- thread_id?: string;
1996
- direct_id?: string;
1997
- work_id?: string;
1998
- reply_to?: string;
1999
- trace_id?: string;
2000
- causation_id?: string;
2001
- }
2002
- export interface InboundMessageEnvelope {
2003
- bridge_instance_id: string;
2004
- scope: BridgeScope;
2005
- workspace_id?: string;
2006
- peer_id?: string;
2007
- thread_id?: string;
2008
- group_id?: string;
2009
- platform_message_id?: string;
2010
- received_at: ISODateTime;
2011
- sender: MessageSender;
2012
- content?: MessageContent;
2013
- attachments?: MessageAttachment[];
2014
- event_family: InboundEventFamily;
2015
- command?: InboundCommand;
2016
- action?: InboundAction;
2017
- reaction?: InboundReaction;
2018
- edit?: InboundEdit;
2019
- reply_to_text?: string;
2020
- reply_to_author_id?: string;
2021
- reply_to_author_name?: string;
2022
- conversation?: NetworkConversationRef;
2023
- provider_metadata?: JSONValue;
2024
- idempotency_key: string;
2025
- }
2026
- export interface InitializeBridgeBoundSecret {
2027
- binding_name: string;
2028
- kind: string;
2029
- value: string;
2030
- }
2031
- export interface InitializeBridgeManagedInstance {
2032
- instance: BridgeInstance;
2033
- bound_secrets?: InitializeBridgeBoundSecret[];
2034
- }
2035
- export interface InitializeBridgeRuntime {
2036
- runtime_version: string;
2037
- purpose: BridgeRuntimePurpose;
2038
- provider: string;
2039
- platform: string;
2040
- allowed_methods?: string[];
2041
- managed_instances?: InitializeBridgeManagedInstance[];
2042
- }
2043
1717
  export interface InitializeCapabilities {
2044
1718
  provides: string[];
2045
1719
  granted_permissions: HostAPIMethod[];
@@ -2067,7 +1741,6 @@ export interface InitializeRuntime {
2067
1741
  shutdown_timeout_ms: number;
2068
1742
  default_hook_timeout_ms: number;
2069
1743
  default_view_timeout_ms?: number;
2070
- bridge?: InitializeBridgeRuntime;
2071
1744
  }
2072
1745
  export interface InitializeRequest {
2073
1746
  protocol_version: string;
@@ -2156,7 +1829,6 @@ export interface LoopContext {
2156
1829
  run_kind?: string;
2157
1830
  node_id?: string;
2158
1831
  workflow_id?: string;
2159
- resolved_network_participation?: NetworkParticipationSpec;
2160
1832
  agent_name?: string;
2161
1833
  session_id?: string;
2162
1834
  actor_kind?: string;
@@ -2182,7 +1854,6 @@ export interface LoopGatePostPayload {
2182
1854
  run_kind?: string;
2183
1855
  node_id?: string;
2184
1856
  workflow_id?: string;
2185
- resolved_network_participation?: NetworkParticipationSpec;
2186
1857
  agent_name?: string;
2187
1858
  session_id?: string;
2188
1859
  actor_kind?: string;
@@ -2217,7 +1888,6 @@ export interface LoopGatePrePayload {
2217
1888
  run_kind?: string;
2218
1889
  node_id?: string;
2219
1890
  workflow_id?: string;
2220
- resolved_network_participation?: NetworkParticipationSpec;
2221
1891
  agent_name?: string;
2222
1892
  session_id?: string;
2223
1893
  actor_kind?: string;
@@ -2249,7 +1919,6 @@ export interface LoopGenerationPostPayload {
2249
1919
  run_kind?: string;
2250
1920
  node_id?: string;
2251
1921
  workflow_id?: string;
2252
- resolved_network_participation?: NetworkParticipationSpec;
2253
1922
  agent_name?: string;
2254
1923
  session_id?: string;
2255
1924
  actor_kind?: string;
@@ -2282,7 +1951,6 @@ export interface LoopGenerationPrePayload {
2282
1951
  run_kind?: string;
2283
1952
  node_id?: string;
2284
1953
  workflow_id?: string;
2285
- resolved_network_participation?: NetworkParticipationSpec;
2286
1954
  agent_name?: string;
2287
1955
  session_id?: string;
2288
1956
  actor_kind?: string;
@@ -2311,7 +1979,6 @@ export interface LoopLifecyclePayload {
2311
1979
  run_kind?: string;
2312
1980
  node_id?: string;
2313
1981
  workflow_id?: string;
2314
- resolved_network_participation?: NetworkParticipationSpec;
2315
1982
  agent_name?: string;
2316
1983
  session_id?: string;
2317
1984
  actor_kind?: string;
@@ -2337,7 +2004,6 @@ export interface LoopNodeTerminalPayload {
2337
2004
  run_kind?: string;
2338
2005
  node_id?: string;
2339
2006
  workflow_id?: string;
2340
- resolved_network_participation?: NetworkParticipationSpec;
2341
2007
  agent_name?: string;
2342
2008
  session_id?: string;
2343
2009
  actor_kind?: string;
@@ -2370,7 +2036,6 @@ export interface LoopStartedPayload {
2370
2036
  run_kind?: string;
2371
2037
  node_id?: string;
2372
2038
  workflow_id?: string;
2373
- resolved_network_participation?: NetworkParticipationSpec;
2374
2039
  agent_name?: string;
2375
2040
  session_id?: string;
2376
2041
  actor_kind?: string;
@@ -2396,7 +2061,6 @@ export interface LoopTerminalPayload {
2396
2061
  run_kind?: string;
2397
2062
  node_id?: string;
2398
2063
  workflow_id?: string;
2399
- resolved_network_participation?: NetworkParticipationSpec;
2400
2064
  agent_name?: string;
2401
2065
  session_id?: string;
2402
2066
  actor_kind?: string;
@@ -2645,601 +2309,6 @@ export interface ModelsRefreshParams {
2645
2309
  export interface ModelsStatusParams {
2646
2310
  provider_id?: string;
2647
2311
  }
2648
- export interface NetworkChannelPayload {
2649
- profile_id: string;
2650
- profile_name: string;
2651
- profile_color?: string;
2652
- profile_icon?: string;
2653
- profile_emoji?: string;
2654
- profile_archived?: boolean;
2655
- channel: string;
2656
- workspace_id?: string;
2657
- purpose?: string;
2658
- fanout_policy?: string;
2659
- coordinator_peer_id?: string;
2660
- created_by?: string;
2661
- created_at?: ISODateTime;
2662
- peer_count: number;
2663
- local_peer_count?: number;
2664
- session_count?: number;
2665
- message_count?: number;
2666
- presence_count?: number;
2667
- historical_participant_count?: number;
2668
- last_activity_at?: ISODateTime;
2669
- last_presence_at?: ISODateTime;
2670
- last_message_preview?: string;
2671
- }
2672
- export interface NetworkChannelsParams {
2673
- workspace_id: string;
2674
- }
2675
- export interface NetworkDirectMessagesParams {
2676
- workspace_id: string;
2677
- channel: string;
2678
- direct_id: string;
2679
- before?: string;
2680
- after?: string;
2681
- kind?: string;
2682
- work_id?: string;
2683
- limit?: number;
2684
- }
2685
- export interface NetworkDirectResolveParams {
2686
- workspace_id: string;
2687
- channel: string;
2688
- session_id: string;
2689
- peer_id: string;
2690
- }
2691
- export interface NetworkConversationMessagePayload {
2692
- profile_id: string;
2693
- profile_name: string;
2694
- profile_color?: string;
2695
- profile_icon?: string;
2696
- profile_emoji?: string;
2697
- profile_archived?: boolean;
2698
- message_id: string;
2699
- workspace_id?: string;
2700
- channel: string;
2701
- surface?: string;
2702
- thread_id?: string;
2703
- direct_id?: string;
2704
- kind: string;
2705
- direction: string;
2706
- peer_from: string;
2707
- peer_to?: string;
2708
- mentions?: string[];
2709
- display_name?: string;
2710
- session_id?: string;
2711
- local?: boolean;
2712
- work_id?: string;
2713
- reply_to?: string;
2714
- trace_id?: string;
2715
- causation_id?: string;
2716
- intent?: string;
2717
- text?: string;
2718
- preview_text?: string;
2719
- size_bytes?: number;
2720
- body: JSONValue;
2721
- timestamp: ISODateTime;
2722
- }
2723
- export interface CursorPagePayload {
2724
- next_cursor?: string;
2725
- has_more: boolean;
2726
- limit: number;
2727
- }
2728
- export interface NetworkDirectRoomMessagesResponse {
2729
- messages: NetworkConversationMessagePayload[];
2730
- page: CursorPagePayload;
2731
- }
2732
- export interface NetworkDirectRoomOpenedPayload {
2733
- event: HookEvent;
2734
- timestamp: ISODateTime;
2735
- workspace_id?: string;
2736
- session_id?: string;
2737
- channel?: string;
2738
- surface?: string;
2739
- thread_id?: string;
2740
- direct_id?: string;
2741
- message_id?: string;
2742
- kind?: string;
2743
- direction?: string;
2744
- work_id?: string;
2745
- work_state?: string;
2746
- peer_id?: string;
2747
- peer_from?: string;
2748
- peer_to?: string;
2749
- last_seen_at?: ISODateTime;
2750
- trace_id?: string;
2751
- causation_id?: string;
2752
- }
2753
- export interface NetworkDirectRoomPayload {
2754
- profile_id: string;
2755
- profile_name: string;
2756
- profile_color?: string;
2757
- profile_icon?: string;
2758
- profile_emoji?: string;
2759
- profile_archived?: boolean;
2760
- workspace_id?: string;
2761
- channel: string;
2762
- direct_id: string;
2763
- session_a: string;
2764
- session_b: string;
2765
- opened_at?: ISODateTime;
2766
- last_activity_at?: ISODateTime;
2767
- message_count: number;
2768
- open_work_count: number;
2769
- last_message_preview?: string;
2770
- }
2771
- export interface NetworkDirectRoomsResponse {
2772
- directs: NetworkDirectRoomPayload[];
2773
- page: CountedCursorPagePayload;
2774
- }
2775
- export interface NetworkDirectsParams {
2776
- workspace_id: string;
2777
- channel: string;
2778
- query?: string;
2779
- peer_id?: string;
2780
- sort?: string;
2781
- has_work?: boolean;
2782
- limit?: number;
2783
- after?: string;
2784
- }
2785
- export interface NetworkMatcher {
2786
- channel?: string;
2787
- surface?: string;
2788
- kind?: string;
2789
- direction?: string;
2790
- work_state?: string;
2791
- participation_mode?: string;
2792
- participation_source?: string;
2793
- }
2794
- export interface NetworkMessagePersistedPayload {
2795
- event: HookEvent;
2796
- timestamp: ISODateTime;
2797
- workspace_id?: string;
2798
- session_id?: string;
2799
- channel?: string;
2800
- surface?: string;
2801
- thread_id?: string;
2802
- direct_id?: string;
2803
- message_id?: string;
2804
- kind?: string;
2805
- direction?: string;
2806
- work_id?: string;
2807
- work_state?: string;
2808
- peer_id?: string;
2809
- peer_from?: string;
2810
- peer_to?: string;
2811
- last_seen_at?: ISODateTime;
2812
- trace_id?: string;
2813
- causation_id?: string;
2814
- }
2815
- export interface NetworkObservationPatch {
2816
- labels?: Record<string, string>;
2817
- }
2818
- export interface NetworkParticipationBounds {
2819
- max_wakes: number;
2820
- max_wake_wall_time: string;
2821
- max_total_wall_time: string;
2822
- max_input_tokens: number;
2823
- max_output_tokens: number;
2824
- max_wake_depth: number;
2825
- coalesce_window: string;
2826
- }
2827
- export interface NetworkParticipationBoundsRequest {
2828
- max_wakes?: number;
2829
- max_wake_wall_time?: string;
2830
- max_total_wall_time?: string;
2831
- max_input_tokens?: number;
2832
- max_output_tokens?: number;
2833
- max_wake_depth?: number;
2834
- coalesce_window?: string;
2835
- }
2836
- export type NetworkParticipationChannelStrategy = "named" | "run" | "loop_run";
2837
- export type NetworkParticipationMode = "local" | "live";
2838
- export type NetworkParticipationOwnerKind = "session" | "task_run" | "loop_run" | "automation_run";
2839
- export interface NetworkParticipationPreResolvePatch {
2840
- deny?: boolean;
2841
- deny_reason?: string;
2842
- request?: NetworkParticipationRequest;
2843
- }
2844
- export interface NetworkParticipationOwnerRef {
2845
- workspace_id: string;
2846
- kind: NetworkParticipationOwnerKind;
2847
- id: string;
2848
- }
2849
- export type NetworkParticipationSource = "explicit_request" | "task_profile" | "workspace_coordination" | "loop_definition" | "automation_job" | "built_in_local";
2850
- export interface NetworkParticipationPreResolvePayload {
2851
- workspace_id: string;
2852
- owner: NetworkParticipationOwnerRef;
2853
- request?: NetworkParticipationRequest;
2854
- source?: NetworkParticipationSource;
2855
- owner_key?: string;
2856
- }
2857
- export type NetworkParticipationResolvedPatch = Record<string, never>;
2858
- export interface NetworkParticipationResolvedPayload {
2859
- workspace_id: string;
2860
- owner: NetworkParticipationOwnerRef;
2861
- owner_key?: string;
2862
- resolved_network_participation: NetworkParticipationSpec;
2863
- }
2864
- export interface NetworkPayload {
2865
- event: HookEvent;
2866
- timestamp: ISODateTime;
2867
- workspace_id?: string;
2868
- session_id?: string;
2869
- channel?: string;
2870
- surface?: string;
2871
- thread_id?: string;
2872
- direct_id?: string;
2873
- message_id?: string;
2874
- kind?: string;
2875
- direction?: string;
2876
- work_id?: string;
2877
- work_state?: string;
2878
- peer_id?: string;
2879
- peer_from?: string;
2880
- peer_to?: string;
2881
- last_seen_at?: ISODateTime;
2882
- trace_id?: string;
2883
- causation_id?: string;
2884
- }
2885
- export interface NetworkPeerJoinedPayload {
2886
- event: HookEvent;
2887
- timestamp: ISODateTime;
2888
- workspace_id?: string;
2889
- session_id?: string;
2890
- channel?: string;
2891
- surface?: string;
2892
- thread_id?: string;
2893
- direct_id?: string;
2894
- message_id?: string;
2895
- kind?: string;
2896
- direction?: string;
2897
- work_id?: string;
2898
- work_state?: string;
2899
- peer_id?: string;
2900
- peer_from?: string;
2901
- peer_to?: string;
2902
- last_seen_at?: ISODateTime;
2903
- trace_id?: string;
2904
- causation_id?: string;
2905
- }
2906
- export interface NetworkPeerLeftPayload {
2907
- event: HookEvent;
2908
- timestamp: ISODateTime;
2909
- workspace_id?: string;
2910
- session_id?: string;
2911
- channel?: string;
2912
- surface?: string;
2913
- thread_id?: string;
2914
- direct_id?: string;
2915
- message_id?: string;
2916
- kind?: string;
2917
- direction?: string;
2918
- work_id?: string;
2919
- work_state?: string;
2920
- peer_id?: string;
2921
- peer_from?: string;
2922
- peer_to?: string;
2923
- last_seen_at?: ISODateTime;
2924
- trace_id?: string;
2925
- causation_id?: string;
2926
- }
2927
- export interface NetworkCapabilityBriefPayload {
2928
- id: string;
2929
- summary: string;
2930
- }
2931
- export interface NetworkPeerCardPayload {
2932
- peer_id: string;
2933
- display_name?: string;
2934
- profiles_supported: string[];
2935
- capabilities: NetworkCapabilityBriefPayload[];
2936
- artifacts_supported: string[];
2937
- trust_modes_supported: string[];
2938
- ext?: Record<string, JSONValue>;
2939
- }
2940
- export interface NetworkPeerPayload {
2941
- workspace_id?: string;
2942
- session_id?: string;
2943
- peer_id: string;
2944
- display_name?: string;
2945
- channel: string;
2946
- local: boolean;
2947
- peer_card: NetworkPeerCardPayload;
2948
- joined_at?: ISODateTime;
2949
- presence_state: string;
2950
- }
2951
- export interface NetworkPeersParams {
2952
- workspace_id: string;
2953
- channel?: string;
2954
- }
2955
- export interface NetworkSendParams {
2956
- workspace_id?: string;
2957
- session_id: string;
2958
- channel: string;
2959
- surface?: string;
2960
- thread_id?: string;
2961
- direct_id?: string;
2962
- kind: string;
2963
- to?: string;
2964
- mentions?: string[];
2965
- body: JSONValue;
2966
- work_id?: string;
2967
- reply_to?: string;
2968
- trace_id?: string;
2969
- causation_id?: string;
2970
- expires_at?: number;
2971
- id?: string;
2972
- ext?: Record<string, JSONValue>;
2973
- }
2974
- export interface NetworkSendPayload {
2975
- id: string;
2976
- workspace_id?: string;
2977
- session_id: string;
2978
- channel: string;
2979
- surface?: string;
2980
- thread_id?: string;
2981
- direct_id?: string;
2982
- kind: string;
2983
- to?: string;
2984
- mentions?: string[];
2985
- work_id?: string;
2986
- reply_to?: string;
2987
- trace_id?: string;
2988
- causation_id?: string;
2989
- expires_at?: number;
2990
- ext?: Record<string, JSONValue>;
2991
- }
2992
- export interface NetworkKindMetricPayload {
2993
- kind: string;
2994
- sent: number;
2995
- received: number;
2996
- rejected: number;
2997
- delivered: number;
2998
- }
2999
- export interface NetworkStatusPayload {
3000
- enabled: boolean;
3001
- status: string;
3002
- local_peers: number;
3003
- channels: number;
3004
- messages_sent: number;
3005
- messages_received: number;
3006
- messages_rejected: number;
3007
- messages_delivered: number;
3008
- workflow_tagged_events: number;
3009
- handoff_tagged_events: number;
3010
- open_threads: number;
3011
- open_direct_rooms: number;
3012
- open_work_items: number;
3013
- conversation_messages: number;
3014
- work_transitions: number;
3015
- direct_resolves: number;
3016
- kind_metrics: NetworkKindMetricPayload[];
3017
- }
3018
- export interface NetworkThreadMessagesParams {
3019
- workspace_id: string;
3020
- channel: string;
3021
- thread_id: string;
3022
- before?: string;
3023
- after?: string;
3024
- kind?: string;
3025
- work_id?: string;
3026
- limit?: number;
3027
- }
3028
- export interface NetworkThreadMessagesResponse {
3029
- messages: NetworkConversationMessagePayload[];
3030
- page: CursorPagePayload;
3031
- }
3032
- export interface NetworkThreadOpenedPayload {
3033
- event: HookEvent;
3034
- timestamp: ISODateTime;
3035
- workspace_id?: string;
3036
- session_id?: string;
3037
- channel?: string;
3038
- surface?: string;
3039
- thread_id?: string;
3040
- direct_id?: string;
3041
- message_id?: string;
3042
- kind?: string;
3043
- direction?: string;
3044
- work_id?: string;
3045
- work_state?: string;
3046
- peer_id?: string;
3047
- peer_from?: string;
3048
- peer_to?: string;
3049
- last_seen_at?: ISODateTime;
3050
- trace_id?: string;
3051
- causation_id?: string;
3052
- }
3053
- export interface NetworkCoordinationCostPayload {
3054
- delivered_count?: number;
3055
- prompt_size_bytes?: number;
3056
- estimated_prompt_tokens?: number;
3057
- }
3058
- export interface NetworkThreadSummaryPayload {
3059
- profile_id: string;
3060
- profile_name: string;
3061
- profile_color?: string;
3062
- profile_icon?: string;
3063
- profile_emoji?: string;
3064
- profile_archived?: boolean;
3065
- workspace_id?: string;
3066
- channel: string;
3067
- thread_id: string;
3068
- root_message_id: string;
3069
- title?: string;
3070
- opened_by_peer_id?: string;
3071
- opened_session_id?: string;
3072
- opened_at?: ISODateTime;
3073
- last_activity_at?: ISODateTime;
3074
- message_count: number;
3075
- participant_count: number;
3076
- open_work_count: number;
3077
- coordination_cost?: NetworkCoordinationCostPayload;
3078
- last_message_preview?: string;
3079
- }
3080
- export interface NetworkThreadTargetParams {
3081
- workspace_id: string;
3082
- channel: string;
3083
- thread_id: string;
3084
- }
3085
- export interface NetworkThreadsParams {
3086
- workspace_id: string;
3087
- channel: string;
3088
- query?: string;
3089
- peer_id?: string;
3090
- sort?: string;
3091
- has_work?: boolean;
3092
- limit?: number;
3093
- after?: string;
3094
- }
3095
- export interface NetworkThreadsResponse {
3096
- threads: NetworkThreadSummaryPayload[];
3097
- page: CountedCursorPagePayload;
3098
- }
3099
- export interface NetworkUsageParams {
3100
- workspace_id: string;
3101
- owner_kind?: string;
3102
- owner_id?: string;
3103
- run_id?: string;
3104
- channel?: string;
3105
- cursor?: string;
3106
- limit?: number;
3107
- }
3108
- export interface NetworkParticipationStatus {
3109
- owner: NetworkParticipationOwnerRef;
3110
- available: boolean;
3111
- participating: boolean;
3112
- reason?: string;
3113
- }
3114
- export interface NetworkUsageDetailPayload {
3115
- wake_id: string;
3116
- task_run_id: string;
3117
- participation_status: NetworkParticipationStatus;
3118
- workspace_id: string;
3119
- channel: string;
3120
- root_id: string;
3121
- depth: number;
3122
- state: string;
3123
- usage_state: string;
3124
- charged_wall_time: string;
3125
- input_tokens: number;
3126
- output_tokens: number;
3127
- reserved_at: ISODateTime;
3128
- settled_at?: ISODateTime;
3129
- reason?: string;
3130
- }
3131
- export interface NetworkUsageSummaryPayload {
3132
- wake_count: number;
3133
- reserved_wake_count: number;
3134
- actual_wake_count: number;
3135
- unavailable_wake_count: number;
3136
- charged_wall_time: string;
3137
- input_tokens: number;
3138
- output_tokens: number;
3139
- }
3140
- export interface NetworkBudgetUsagePayload {
3141
- participation_status: NetworkParticipationStatus;
3142
- wakes_used: number;
3143
- wall_time_used: string;
3144
- input_tokens_used: number;
3145
- output_tokens_used: number;
3146
- exhausted_reason?: string;
3147
- updated_at: ISODateTime;
3148
- }
3149
- export interface NetworkUsageResponse {
3150
- workspace_id: string;
3151
- details: NetworkUsageDetailPayload[];
3152
- total: NetworkUsageSummaryPayload;
3153
- budget?: NetworkBudgetUsagePayload;
3154
- next_cursor?: string;
3155
- }
3156
- export interface NetworkWorkClosedPayload {
3157
- event: HookEvent;
3158
- timestamp: ISODateTime;
3159
- workspace_id?: string;
3160
- session_id?: string;
3161
- channel?: string;
3162
- surface?: string;
3163
- thread_id?: string;
3164
- direct_id?: string;
3165
- message_id?: string;
3166
- kind?: string;
3167
- direction?: string;
3168
- work_id?: string;
3169
- work_state?: string;
3170
- peer_id?: string;
3171
- peer_from?: string;
3172
- peer_to?: string;
3173
- last_seen_at?: ISODateTime;
3174
- trace_id?: string;
3175
- causation_id?: string;
3176
- }
3177
- export interface NetworkWorkGetParams {
3178
- workspace_id: string;
3179
- work_id: string;
3180
- }
3181
- export interface NetworkWorkOpenedPayload {
3182
- event: HookEvent;
3183
- timestamp: ISODateTime;
3184
- workspace_id?: string;
3185
- session_id?: string;
3186
- channel?: string;
3187
- surface?: string;
3188
- thread_id?: string;
3189
- direct_id?: string;
3190
- message_id?: string;
3191
- kind?: string;
3192
- direction?: string;
3193
- work_id?: string;
3194
- work_state?: string;
3195
- peer_id?: string;
3196
- peer_from?: string;
3197
- peer_to?: string;
3198
- last_seen_at?: ISODateTime;
3199
- trace_id?: string;
3200
- causation_id?: string;
3201
- }
3202
- export interface NetworkWorkPayload {
3203
- profile_id: string;
3204
- profile_name: string;
3205
- profile_color?: string;
3206
- profile_icon?: string;
3207
- profile_emoji?: string;
3208
- profile_archived?: boolean;
3209
- work_id: string;
3210
- workspace_id?: string;
3211
- channel: string;
3212
- surface: string;
3213
- thread_id?: string;
3214
- direct_id?: string;
3215
- opened_session_id?: string;
3216
- target_session_id?: string;
3217
- state: string;
3218
- opened_at?: ISODateTime;
3219
- last_activity_at?: ISODateTime;
3220
- terminal_at?: ISODateTime;
3221
- }
3222
- export interface NetworkWorkTransitionedPayload {
3223
- event: HookEvent;
3224
- timestamp: ISODateTime;
3225
- workspace_id?: string;
3226
- session_id?: string;
3227
- channel?: string;
3228
- surface?: string;
3229
- thread_id?: string;
3230
- direct_id?: string;
3231
- message_id?: string;
3232
- kind?: string;
3233
- direction?: string;
3234
- work_id?: string;
3235
- work_state?: string;
3236
- peer_id?: string;
3237
- peer_from?: string;
3238
- peer_to?: string;
3239
- last_seen_at?: ISODateTime;
3240
- trace_id?: string;
3241
- causation_id?: string;
3242
- }
3243
2312
  export interface PersistenceHealth {
3244
2313
  status: string;
3245
2314
  global_db_size_bytes: number;
@@ -3286,25 +2355,7 @@ export interface ProbeResult {
3286
2355
  checked_at: ISODateTime;
3287
2356
  duration_ms: number;
3288
2357
  }
3289
- export interface BridgeStatusCounts {
3290
- disabled: number;
3291
- starting: number;
3292
- ready: number;
3293
- degraded: number;
3294
- auth_required: number;
3295
- error: number;
3296
- }
3297
- export interface BridgeAggregateHealth {
3298
- total_instances: number;
3299
- route_count: number;
3300
- delivery_backlog: number;
3301
- delivery_dropped_total: number;
3302
- delivery_failures_total: number;
3303
- auth_failures_total: number;
3304
- status_counts: BridgeStatusCounts;
3305
- }
3306
2358
  export interface TaskQueueDepth {
3307
- channel_id?: string;
3308
2359
  count: number;
3309
2360
  oldest_queued_at: ISODateTime;
3310
2361
  oldest_queue_age_ms: number;
@@ -3315,7 +2366,6 @@ export interface StuckTaskRun {
3315
2366
  run_id: string;
3316
2367
  status: RunStatus;
3317
2368
  origin_kind: OriginKind;
3318
- channel_id?: string;
3319
2369
  session_id?: string;
3320
2370
  age_ms: number;
3321
2371
  }
@@ -3323,13 +2373,11 @@ export type Status = string;
3323
2373
  export interface TaskStatusTotal {
3324
2374
  scope: Scope;
3325
2375
  status: Status;
3326
- channel_id?: string;
3327
2376
  count: number;
3328
2377
  }
3329
2378
  export interface TaskRunTotal {
3330
2379
  status: RunStatus;
3331
2380
  origin_kind: OriginKind;
3332
- channel_id?: string;
3333
2381
  count: number;
3334
2382
  }
3335
2383
  export interface TaskOwnerTotal {
@@ -3354,8 +2402,6 @@ export interface TaskHealth {
3354
2402
  run_totals?: TaskRunTotal[];
3355
2403
  owner_totals?: TaskOwnerTotal[];
3356
2404
  forced_stops_since_start: number;
3357
- duplicate_ingress_since_start: number;
3358
- channel_mismatch_since_start: number;
3359
2405
  recovery_since_start: TaskRecoveryTotals;
3360
2406
  }
3361
2407
  export interface SessionActivityHealth {
@@ -3388,7 +2434,6 @@ export interface ObserveHealth {
3388
2434
  retention: RetentionHealth;
3389
2435
  failures: FailureHealth;
3390
2436
  agent_probes?: ProbeResult[];
3391
- bridges: BridgeAggregateHealth;
3392
2437
  tasks: TaskHealth;
3393
2438
  activities?: SessionActivityHealth[];
3394
2439
  version: string;
@@ -3533,8 +2578,6 @@ export interface PermissionSet {
3533
2578
  skills?: string[];
3534
2579
  mcp_servers?: string[];
3535
2580
  workspace_paths?: string[];
3536
- network_channels?: string[];
3537
- sandbox_profiles?: string[];
3538
2581
  }
3539
2582
  export interface PromptPatch {
3540
2583
  deny?: boolean;
@@ -3619,6 +2662,8 @@ export interface ProviderModelPayload {
3619
2662
  hidden: boolean;
3620
2663
  featured: boolean;
3621
2664
  release_date?: string;
2665
+ reasoning_known?: boolean;
2666
+ reasoning_apply?: string;
3622
2667
  reasoning_source?: ReasoningSource;
3623
2668
  last_error?: string;
3624
2669
  }
@@ -3709,214 +2754,8 @@ export interface Run {
3709
2754
  error?: string;
3710
2755
  delivery_error?: string;
3711
2756
  delivery_error_at?: ISODateTime;
3712
- network_participation?: NetworkParticipationRequest;
3713
2757
  metadata?: Record<string, JSONValue>;
3714
2758
  }
3715
- export interface SandboxExecParams {
3716
- workspace_id: string;
3717
- session_id: string;
3718
- command: string;
3719
- timeout?: number;
3720
- }
3721
- export interface SandboxExecResult {
3722
- exit_code: number;
3723
- stdout?: string;
3724
- stderr?: string;
3725
- }
3726
- export interface SandboxInfoParams {
3727
- workspace_id: string;
3728
- session_id: string;
3729
- }
3730
- export interface SandboxInfoResult {
3731
- sandbox_id: string;
3732
- backend: string;
3733
- profile: string;
3734
- instance_id: string;
3735
- runtime_root: string;
3736
- sync_state: string;
3737
- created_at: ISODateTime;
3738
- last_sync_error: string;
3739
- }
3740
- export interface SandboxListParams {
3741
- workspace?: string;
3742
- }
3743
- export interface SandboxSummary {
3744
- session_id: string;
3745
- sandbox_id: string;
3746
- backend: string;
3747
- profile?: string;
3748
- instance_id?: string;
3749
- state: string;
3750
- sync_state?: string;
3751
- }
3752
- export interface SandboxListResult {
3753
- sandboxes: SandboxSummary[];
3754
- }
3755
- export type SandboxObservationPatch = Record<string, never>;
3756
- export interface SandboxPreparePatch {
3757
- deny?: boolean;
3758
- deny_reason?: string;
3759
- env_overrides?: Record<string, string>;
3760
- }
3761
- export interface SandboxProfilePayload {
3762
- profile?: string;
3763
- backend?: string;
3764
- sync_mode?: string;
3765
- persistence?: string;
3766
- runtime_root?: string;
3767
- destroy_on_stop?: boolean;
3768
- env?: Record<string, string>;
3769
- secret_env?: Record<string, string>;
3770
- }
3771
- export interface SandboxPreparePayload {
3772
- event: HookEvent;
3773
- timestamp: ISODateTime;
3774
- profile_id?: string;
3775
- session_id?: string;
3776
- session_name?: string;
3777
- session_type?: string;
3778
- agent_name?: string;
3779
- workspace_id?: string;
3780
- workspace?: string;
3781
- worktree_id?: string;
3782
- acp_session_id?: string;
3783
- state?: string;
3784
- soul_snapshot_id?: string;
3785
- soul_digest?: string;
3786
- created_at: ISODateTime;
3787
- updated_at: ISODateTime;
3788
- sandbox_id?: string;
3789
- backend?: string;
3790
- profile: SandboxProfilePayload;
3791
- local_root?: string;
3792
- local_additional_dirs?: string[];
3793
- agent_command?: string;
3794
- agent_env?: string[];
3795
- permissions?: string;
3796
- resume_acp_state?: string;
3797
- env_overrides?: Record<string, string>;
3798
- denied?: boolean;
3799
- deny_reason?: string;
3800
- }
3801
- export type SandboxReadyPatch = Record<string, never>;
3802
- export interface SandboxReadyPayload {
3803
- event: HookEvent;
3804
- timestamp: ISODateTime;
3805
- profile_id?: string;
3806
- session_id?: string;
3807
- session_name?: string;
3808
- session_type?: string;
3809
- agent_name?: string;
3810
- workspace_id?: string;
3811
- workspace?: string;
3812
- worktree_id?: string;
3813
- acp_session_id?: string;
3814
- state?: string;
3815
- soul_snapshot_id?: string;
3816
- soul_digest?: string;
3817
- created_at: ISODateTime;
3818
- updated_at: ISODateTime;
3819
- sandbox_id?: string;
3820
- backend?: string;
3821
- profile?: string;
3822
- instance_id?: string;
3823
- runtime_root?: string;
3824
- runtime_additional_dirs?: string[];
3825
- }
3826
- export interface SandboxStopPatch {
3827
- deny?: boolean;
3828
- deny_reason?: string;
3829
- }
3830
- export interface SandboxStopPayload {
3831
- event: HookEvent;
3832
- timestamp: ISODateTime;
3833
- profile_id?: string;
3834
- session_id?: string;
3835
- session_name?: string;
3836
- session_type?: string;
3837
- agent_name?: string;
3838
- workspace_id?: string;
3839
- workspace?: string;
3840
- worktree_id?: string;
3841
- acp_session_id?: string;
3842
- state?: string;
3843
- soul_snapshot_id?: string;
3844
- soul_digest?: string;
3845
- created_at: ISODateTime;
3846
- updated_at: ISODateTime;
3847
- sandbox_id?: string;
3848
- backend?: string;
3849
- profile?: string;
3850
- instance_id?: string;
3851
- runtime_root?: string;
3852
- stop_reason?: string;
3853
- will_destroy?: boolean;
3854
- denied?: boolean;
3855
- deny_reason?: string;
3856
- }
3857
- export type SandboxSyncAfterPatch = Record<string, never>;
3858
- export interface SandboxSyncAfterPayload {
3859
- event: HookEvent;
3860
- timestamp: ISODateTime;
3861
- profile_id?: string;
3862
- session_id?: string;
3863
- session_name?: string;
3864
- session_type?: string;
3865
- agent_name?: string;
3866
- workspace_id?: string;
3867
- workspace?: string;
3868
- worktree_id?: string;
3869
- acp_session_id?: string;
3870
- state?: string;
3871
- soul_snapshot_id?: string;
3872
- soul_digest?: string;
3873
- created_at: ISODateTime;
3874
- updated_at: ISODateTime;
3875
- sandbox_id?: string;
3876
- backend?: string;
3877
- profile?: string;
3878
- instance_id?: string;
3879
- runtime_root?: string;
3880
- direction?: string;
3881
- reason?: string;
3882
- files_synced?: number;
3883
- bytes_transferred?: number;
3884
- duration_ms?: number;
3885
- errors?: string[];
3886
- }
3887
- export interface SandboxSyncBeforePatch {
3888
- deny?: boolean;
3889
- deny_reason?: string;
3890
- exclude_patterns?: string[];
3891
- }
3892
- export interface SandboxSyncBeforePayload {
3893
- event: HookEvent;
3894
- timestamp: ISODateTime;
3895
- profile_id?: string;
3896
- session_id?: string;
3897
- session_name?: string;
3898
- session_type?: string;
3899
- agent_name?: string;
3900
- workspace_id?: string;
3901
- workspace?: string;
3902
- worktree_id?: string;
3903
- acp_session_id?: string;
3904
- state?: string;
3905
- soul_snapshot_id?: string;
3906
- soul_digest?: string;
3907
- created_at: ISODateTime;
3908
- updated_at: ISODateTime;
3909
- sandbox_id?: string;
3910
- backend?: string;
3911
- profile?: string;
3912
- instance_id?: string;
3913
- runtime_root?: string;
3914
- direction?: string;
3915
- reason?: string;
3916
- exclude_patterns?: string[];
3917
- denied?: boolean;
3918
- deny_reason?: string;
3919
- }
3920
2759
  export interface SessionAttentionChangedPayload {
3921
2760
  event: HookEvent;
3922
2761
  timestamp: ISODateTime;
@@ -4438,6 +3277,8 @@ export interface RuntimeSelectionPayload {
4438
3277
  }
4439
3278
  export interface ACPCapsPayload {
4440
3279
  supports_load_session: boolean;
3280
+ supports_fork_session: boolean;
3281
+ supports_resume_session: boolean;
4441
3282
  prompt_image: boolean;
4442
3283
  prompt_audio: boolean;
4443
3284
  prompt_embedded_context: boolean;
@@ -4495,6 +3336,41 @@ export interface PendingInteractionPayload {
4495
3336
  resolution?: string;
4496
3337
  resolved_by?: string;
4497
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
+ }
4498
3374
  export interface SessionStatusResponse {
4499
3375
  queue?: SessionQueueSummaryPayload;
4500
3376
  lifecycle_state?: State;
@@ -4513,6 +3389,8 @@ export interface SessionStatusResponse {
4513
3389
  ineligibility_reason?: SessionHealthIneligibilityReason;
4514
3390
  wake_state?: HeartbeatWakeStatePayload;
4515
3391
  pending_interactions: PendingInteractionPayload[];
3392
+ lineage?: SessionLineagePayload;
3393
+ derivation?: SessionDerivationPayload;
4516
3394
  updated_at: ISODateTime;
4517
3395
  }
4518
3396
  export interface SessionSummary {
@@ -4532,7 +3410,6 @@ export interface SessionTargetParams {
4532
3410
  export interface SessionsCreateParams {
4533
3411
  agent: string;
4534
3412
  workspace?: string;
4535
- network_participation?: NetworkParticipationRequest;
4536
3413
  }
4537
3414
  export interface SessionsListParams {
4538
3415
  workspace?: string;
@@ -4593,7 +3470,6 @@ export interface SpawnContext {
4593
3470
  task_id?: string;
4594
3471
  run_id?: string;
4595
3472
  workflow_id?: string;
4596
- resolved_network_participation?: NetworkParticipationSpec;
4597
3473
  soul_snapshot_id?: string;
4598
3474
  soul_digest?: string;
4599
3475
  parent_soul_digest?: string;
@@ -4623,7 +3499,6 @@ export interface SpawnCreatedPayload {
4623
3499
  task_id?: string;
4624
3500
  run_id?: string;
4625
3501
  workflow_id?: string;
4626
- resolved_network_participation?: NetworkParticipationSpec;
4627
3502
  soul_snapshot_id?: string;
4628
3503
  soul_digest?: string;
4629
3504
  parent_soul_digest?: string;
@@ -4650,7 +3525,6 @@ export interface SpawnLifecyclePayload {
4650
3525
  task_id?: string;
4651
3526
  run_id?: string;
4652
3527
  workflow_id?: string;
4653
- resolved_network_participation?: NetworkParticipationSpec;
4654
3528
  soul_snapshot_id?: string;
4655
3529
  soul_digest?: string;
4656
3530
  parent_soul_digest?: string;
@@ -4680,7 +3554,6 @@ export interface SpawnParentStoppedPayload {
4680
3554
  task_id?: string;
4681
3555
  run_id?: string;
4682
3556
  workflow_id?: string;
4683
- resolved_network_participation?: NetworkParticipationSpec;
4684
3557
  soul_snapshot_id?: string;
4685
3558
  soul_digest?: string;
4686
3559
  parent_soul_digest?: string;
@@ -4707,7 +3580,6 @@ export interface SpawnPreCreatePayload {
4707
3580
  task_id?: string;
4708
3581
  run_id?: string;
4709
3582
  workflow_id?: string;
4710
- resolved_network_participation?: NetworkParticipationSpec;
4711
3583
  soul_snapshot_id?: string;
4712
3584
  soul_digest?: string;
4713
3585
  parent_soul_digest?: string;
@@ -4733,7 +3605,6 @@ export interface SpawnReapedPayload {
4733
3605
  task_id?: string;
4734
3606
  run_id?: string;
4735
3607
  workflow_id?: string;
4736
- resolved_network_participation?: NetworkParticipationSpec;
4737
3608
  soul_snapshot_id?: string;
4738
3609
  soul_digest?: string;
4739
3610
  parent_soul_digest?: string;
@@ -4760,7 +3631,6 @@ export interface SpawnTTLExpiredPayload {
4760
3631
  task_id?: string;
4761
3632
  run_id?: string;
4762
3633
  workflow_id?: string;
4763
- resolved_network_participation?: NetworkParticipationSpec;
4764
3634
  soul_snapshot_id?: string;
4765
3635
  soul_digest?: string;
4766
3636
  parent_soul_digest?: string;
@@ -4810,7 +3680,6 @@ export interface Task {
4810
3680
  scope: Scope;
4811
3681
  workspace_id?: string;
4812
3682
  parent_task_id?: string;
4813
- resolved_network_participation?: NetworkParticipationSpec;
4814
3683
  title: string;
4815
3684
  description?: string;
4816
3685
  priority?: Priority;
@@ -4851,7 +3720,6 @@ export interface TaskBlockedPayload {
4851
3720
  parent_task_id?: string;
4852
3721
  workspace_id?: string;
4853
3722
  workflow_id?: string;
4854
- resolved_network_participation?: NetworkParticipationSpec;
4855
3723
  agent_name?: string;
4856
3724
  actor_kind?: string;
4857
3725
  actor_id?: string;
@@ -4879,7 +3747,6 @@ export interface TaskContext {
4879
3747
  parent_task_id?: string;
4880
3748
  workspace_id?: string;
4881
3749
  workflow_id?: string;
4882
- resolved_network_participation?: NetworkParticipationSpec;
4883
3750
  agent_name?: string;
4884
3751
  actor_kind?: string;
4885
3752
  actor_id?: string;
@@ -4895,7 +3762,6 @@ export interface TaskCreateParams {
4895
3762
  identifier?: string;
4896
3763
  scope: Scope;
4897
3764
  workspace?: string;
4898
- network_participation?: NetworkParticipationRequest;
4899
3765
  title: string;
4900
3766
  description?: string;
4901
3767
  priority?: Priority;
@@ -4971,7 +3837,6 @@ export interface TaskDashboardStatusBreakdownPayload {
4971
3837
  share_percent: number;
4972
3838
  }
4973
3839
  export interface TaskDashboardQueueDepthPayload {
4974
- channel_id?: string;
4975
3840
  count: number;
4976
3841
  oldest_queued_at: ISODateTime;
4977
3842
  oldest_queue_age_ms: number;
@@ -5006,7 +3871,6 @@ export interface TaskDashboardActiveRunPayload {
5006
3871
  attempt: number;
5007
3872
  max_attempts: number;
5008
3873
  session_id?: string;
5009
- resolved_network_participation?: NetworkParticipationSpec;
5010
3874
  last_activity_at: ISODateTime;
5011
3875
  age_ms: number;
5012
3876
  health_status: string;
@@ -5045,7 +3909,6 @@ export interface TaskDashboardParams {
5045
3909
  worktree?: string;
5046
3910
  owner_kind?: OwnerKind;
5047
3911
  owner_ref?: string;
5048
- participation_channel?: string;
5049
3912
  origin_kind?: OriginKind;
5050
3913
  }
5051
3914
  export type DependencyKind = string;
@@ -5071,18 +3934,6 @@ export interface TaskDependencyReferencePayload {
5071
3934
  depends_on: TaskReferencePayload;
5072
3935
  }
5073
3936
  export type ResolvedWorktreeMode = string;
5074
- export type CoordinationMessageKind = string;
5075
- export interface CoordinationChannelPayload {
5076
- id: string;
5077
- display_name: string;
5078
- purpose?: string;
5079
- workspace_id?: string;
5080
- task_id?: string;
5081
- run_id?: string;
5082
- workflow_id?: string;
5083
- allowed_message_kinds: CoordinationMessageKind[];
5084
- last_activity_at?: ISODateTime;
5085
- }
5086
3937
  export interface RunDesignationSummary {
5087
3938
  index: number;
5088
3939
  brief?: string;
@@ -5104,8 +3955,6 @@ export interface TaskRunSummaryPayload {
5104
3955
  claim_token_hash?: string;
5105
3956
  lease_until?: ISODateTime;
5106
3957
  heartbeat_at?: ISODateTime;
5107
- resolved_network_participation?: NetworkParticipationSpec;
5108
- coordination_channel?: CoordinationChannelPayload;
5109
3958
  designation_group_id?: string;
5110
3959
  designation?: RunDesignationSummary;
5111
3960
  queued_at: ISODateTime;
@@ -5124,7 +3973,6 @@ export interface TaskSummaryPayload {
5124
3973
  scope: Scope;
5125
3974
  workspace_id?: string;
5126
3975
  parent_task_id?: string;
5127
- resolved_network_participation?: NetworkParticipationSpec;
5128
3976
  title: string;
5129
3977
  priority?: Priority;
5130
3978
  max_attempts?: number;
@@ -5184,12 +4032,10 @@ export interface TaskRun {
5184
4032
  resolved_worktree_ref?: string;
5185
4033
  origin: Origin;
5186
4034
  idempotency_key?: string;
5187
- resolved_network_participation?: NetworkParticipationSpec;
5188
4035
  designation_group_id?: string;
5189
4036
  claim_token_hash?: string;
5190
4037
  lease_until?: ISODateTime;
5191
4038
  heartbeat_at?: ISODateTime;
5192
- coordination_channel?: CoordinationChannelPayload;
5193
4039
  designation?: RunDesignationSummary;
5194
4040
  queued_at: ISODateTime;
5195
4041
  claimed_at?: ISODateTime;
@@ -5255,7 +4101,6 @@ export interface TaskCatalogRunPayload {
5255
4101
  claimed_by?: ActorIdentity;
5256
4102
  lease_until?: ISODateTime;
5257
4103
  heartbeat_at?: ISODateTime;
5258
- resolved_network_participation?: NetworkParticipationSpec;
5259
4104
  queued_at: ISODateTime;
5260
4105
  claimed_at?: ISODateTime;
5261
4106
  started_at?: ISODateTime;
@@ -5329,7 +4174,6 @@ export interface TaskNeedsAttentionPayload {
5329
4174
  parent_task_id?: string;
5330
4175
  workspace_id?: string;
5331
4176
  workflow_id?: string;
5332
- resolved_network_participation?: NetworkParticipationSpec;
5333
4177
  agent_name?: string;
5334
4178
  actor_kind?: string;
5335
4179
  actor_id?: string;
@@ -5354,7 +4198,6 @@ export interface TaskRecoveredPayload {
5354
4198
  parent_task_id?: string;
5355
4199
  workspace_id?: string;
5356
4200
  workflow_id?: string;
5357
- resolved_network_participation?: NetworkParticipationSpec;
5358
4201
  agent_name?: string;
5359
4202
  actor_kind?: string;
5360
4203
  actor_id?: string;
@@ -5405,7 +4248,6 @@ export interface TaskRunCompletedPayload {
5405
4248
  loop_run_id?: string;
5406
4249
  workspace_id?: string;
5407
4250
  workflow_id?: string;
5408
- resolved_network_participation?: NetworkParticipationSpec;
5409
4251
  agent_name?: string;
5410
4252
  session_id?: string;
5411
4253
  actor_kind?: string;
@@ -5436,7 +4278,6 @@ export interface TaskRunContext {
5436
4278
  loop_run_id?: string;
5437
4279
  workspace_id?: string;
5438
4280
  workflow_id?: string;
5439
- resolved_network_participation?: NetworkParticipationSpec;
5440
4281
  agent_name?: string;
5441
4282
  session_id?: string;
5442
4283
  actor_kind?: string;
@@ -5476,28 +4317,15 @@ export interface TaskRunOperationalSummaryPayload {
5476
4317
  cost_status?: CostStatus;
5477
4318
  cost_source?: CostSource;
5478
4319
  }
5479
- export interface TaskRunConversationRefPayload {
5480
- workspace_id: string;
5481
- channel: string;
5482
- surface: string;
5483
- thread_id: string;
5484
- stream_url: string;
5485
- }
5486
- export interface TaskRunNetworkPayload {
5487
- conversation: TaskRunConversationRefPayload;
5488
- usage: NetworkUsageResponse;
5489
- }
5490
4320
  export interface TaskRunDetail {
5491
4321
  run: TaskRun;
5492
4322
  task?: TaskReferencePayload;
5493
4323
  session?: TaskRunSessionPayload;
5494
4324
  summary: TaskRunOperationalSummaryPayload;
5495
- network?: TaskRunNetworkPayload;
5496
4325
  }
5497
4326
  export interface TaskRunEnqueueParams {
5498
4327
  task_id: string;
5499
4328
  idempotency_key?: string;
5500
- network_participation?: NetworkParticipationRequest;
5501
4329
  metadata?: JSONValue;
5502
4330
  }
5503
4331
  export interface TaskRunEnqueuedPayload {
@@ -5513,7 +4341,6 @@ export interface TaskRunEnqueuedPayload {
5513
4341
  loop_run_id?: string;
5514
4342
  workspace_id?: string;
5515
4343
  workflow_id?: string;
5516
- resolved_network_participation?: NetworkParticipationSpec;
5517
4344
  agent_name?: string;
5518
4345
  session_id?: string;
5519
4346
  actor_kind?: string;
@@ -5548,7 +4375,6 @@ export interface TaskRunFailedPayload {
5548
4375
  loop_run_id?: string;
5549
4376
  workspace_id?: string;
5550
4377
  workflow_id?: string;
5551
- resolved_network_participation?: NetworkParticipationSpec;
5552
4378
  agent_name?: string;
5553
4379
  session_id?: string;
5554
4380
  actor_kind?: string;
@@ -5584,7 +4410,6 @@ export interface TaskRunLeaseExpiredPayload {
5584
4410
  loop_run_id?: string;
5585
4411
  workspace_id?: string;
5586
4412
  workflow_id?: string;
5587
- resolved_network_participation?: NetworkParticipationSpec;
5588
4413
  agent_name?: string;
5589
4414
  session_id?: string;
5590
4415
  actor_kind?: string;
@@ -5617,7 +4442,6 @@ export interface TaskRunLeaseExtendedPayload {
5617
4442
  loop_run_id?: string;
5618
4443
  workspace_id?: string;
5619
4444
  workflow_id?: string;
5620
- resolved_network_participation?: NetworkParticipationSpec;
5621
4445
  agent_name?: string;
5622
4446
  session_id?: string;
5623
4447
  actor_kind?: string;
@@ -5650,7 +4474,6 @@ export interface TaskRunLeasePayload {
5650
4474
  loop_run_id?: string;
5651
4475
  workspace_id?: string;
5652
4476
  workflow_id?: string;
5653
- resolved_network_participation?: NetworkParticipationSpec;
5654
4477
  agent_name?: string;
5655
4478
  session_id?: string;
5656
4479
  actor_kind?: string;
@@ -5683,7 +4506,6 @@ export interface TaskRunLeaseRecoveredPayload {
5683
4506
  loop_run_id?: string;
5684
4507
  workspace_id?: string;
5685
4508
  workflow_id?: string;
5686
- resolved_network_participation?: NetworkParticipationSpec;
5687
4509
  agent_name?: string;
5688
4510
  session_id?: string;
5689
4511
  actor_kind?: string;
@@ -5719,7 +4541,6 @@ export interface TaskRunPostClaimPayload {
5719
4541
  loop_run_id?: string;
5720
4542
  workspace_id?: string;
5721
4543
  workflow_id?: string;
5722
- resolved_network_participation?: NetworkParticipationSpec;
5723
4544
  agent_name?: string;
5724
4545
  session_id?: string;
5725
4546
  actor_kind?: string;
@@ -5755,7 +4576,6 @@ export interface TaskRunPreClaimPayload {
5755
4576
  loop_run_id?: string;
5756
4577
  workspace_id?: string;
5757
4578
  workflow_id?: string;
5758
- resolved_network_participation?: NetworkParticipationSpec;
5759
4579
  agent_name?: string;
5760
4580
  session_id?: string;
5761
4581
  actor_kind?: string;
@@ -5787,7 +4607,6 @@ export interface TaskRunReleasedPayload {
5787
4607
  loop_run_id?: string;
5788
4608
  workspace_id?: string;
5789
4609
  workflow_id?: string;
5790
- resolved_network_participation?: NetworkParticipationSpec;
5791
4610
  agent_name?: string;
5792
4611
  session_id?: string;
5793
4612
  actor_kind?: string;
@@ -5830,7 +4649,6 @@ export interface TaskRunsParams {
5830
4649
  id: string;
5831
4650
  status?: RunStatus;
5832
4651
  session_id?: string;
5833
- participation_channel?: string;
5834
4652
  limit?: number;
5835
4653
  }
5836
4654
  export interface TaskStatusChangedPayload {
@@ -5841,7 +4659,6 @@ export interface TaskStatusChangedPayload {
5841
4659
  parent_task_id?: string;
5842
4660
  workspace_id?: string;
5843
4661
  workflow_id?: string;
5844
- resolved_network_participation?: NetworkParticipationSpec;
5845
4662
  agent_name?: string;
5846
4663
  actor_kind?: string;
5847
4664
  actor_id?: string;
@@ -5897,7 +4714,6 @@ export interface TaskUnblockedPayload {
5897
4714
  parent_task_id?: string;
5898
4715
  workspace_id?: string;
5899
4716
  workflow_id?: string;
5900
- resolved_network_participation?: NetworkParticipationSpec;
5901
4717
  agent_name?: string;
5902
4718
  actor_kind?: string;
5903
4719
  actor_id?: string;
@@ -5923,7 +4739,6 @@ export interface TaskUpdateParams {
5923
4739
  auto_enqueue_on_ready?: boolean;
5924
4740
  approval_policy?: ApprovalPolicy;
5925
4741
  metadata?: JSONValue;
5926
- network_participation?: NetworkParticipationRequest;
5927
4742
  owner?: Ownership;
5928
4743
  clear_owner?: boolean;
5929
4744
  }
@@ -5941,7 +4756,6 @@ export interface TasksParams {
5941
4756
  owner_ref?: string;
5942
4757
  parent_task_id?: string;
5943
4758
  worktree?: string;
5944
- participation_channel?: string;
5945
4759
  query?: string;
5946
4760
  sort?: CatalogSort;
5947
4761
  cursor?: string;
@@ -5957,7 +4771,6 @@ export interface TaskCatalogItemPayload {
5957
4771
  scope: Scope;
5958
4772
  workspace_id?: string;
5959
4773
  parent_task_id?: string;
5960
- resolved_network_participation?: NetworkParticipationSpec;
5961
4774
  title: string;
5962
4775
  priority?: Priority;
5963
4776
  max_attempts?: number;
@@ -6801,11 +5614,6 @@ export interface HookPayloadByEvent {
6801
5614
  "session.runtime_recovery.started": SessionRuntimeRecoveryStartedPayload;
6802
5615
  "session.runtime_recovery.succeeded": SessionRuntimeRecoverySucceededPayload;
6803
5616
  "session.runtime_recovery.exhausted": SessionRuntimeRecoveryExhaustedPayload;
6804
- "sandbox.prepare": SandboxPreparePayload;
6805
- "sandbox.ready": SandboxReadyPayload;
6806
- "sandbox.sync.before": SandboxSyncBeforePayload;
6807
- "sandbox.sync.after": SandboxSyncAfterPayload;
6808
- "sandbox.stop": SandboxStopPayload;
6809
5617
  "input.pre_submit": InputPreSubmitPayload;
6810
5618
  "prompt.post_assemble": PromptPayload;
6811
5619
  "event.pre_record": EventPreRecordPayload;
@@ -6871,16 +5679,6 @@ export interface HookPayloadByEvent {
6871
5679
  "spawn.ttl_expired": SpawnTTLExpiredPayload;
6872
5680
  "spawn.reaped": SpawnReapedPayload;
6873
5681
  "session.attention.changed": SessionAttentionChangedPayload;
6874
- "network.thread.opened": NetworkThreadOpenedPayload;
6875
- "network.direct_room.opened": NetworkDirectRoomOpenedPayload;
6876
- "network.message.persisted": NetworkMessagePersistedPayload;
6877
- "network.work.opened": NetworkWorkOpenedPayload;
6878
- "network.work.transitioned": NetworkWorkTransitionedPayload;
6879
- "network.work.closed": NetworkWorkClosedPayload;
6880
- "network.peer.joined": NetworkPeerJoinedPayload;
6881
- "network.peer.left": NetworkPeerLeftPayload;
6882
- "network.participation.pre_resolve": NetworkParticipationPreResolvePayload;
6883
- "network.participation.resolved": NetworkParticipationResolvedPayload;
6884
5682
  "window_manager.layout.applied": WindowManagerLayoutAppliedPayload;
6885
5683
  "window_manager.desktop.created": WindowManagerDesktopCreatedPayload;
6886
5684
  "window_manager.desktop.deleted": WindowManagerDesktopDeletedPayload;
@@ -6917,11 +5715,6 @@ export interface HookPatchByEvent {
6917
5715
  "session.runtime_recovery.started": AuthoredContextObservationPatch;
6918
5716
  "session.runtime_recovery.succeeded": AuthoredContextObservationPatch;
6919
5717
  "session.runtime_recovery.exhausted": AuthoredContextObservationPatch;
6920
- "sandbox.prepare": SandboxPreparePatch;
6921
- "sandbox.ready": SandboxReadyPatch;
6922
- "sandbox.sync.before": SandboxSyncBeforePatch;
6923
- "sandbox.sync.after": SandboxSyncAfterPatch;
6924
- "sandbox.stop": SandboxStopPatch;
6925
5718
  "input.pre_submit": InputPreSubmitPatch;
6926
5719
  "prompt.post_assemble": PromptPatch;
6927
5720
  "event.pre_record": EventPreRecordPatch;
@@ -6987,16 +5780,6 @@ export interface HookPatchByEvent {
6987
5780
  "spawn.ttl_expired": SpawnObservationPatch;
6988
5781
  "spawn.reaped": SpawnObservationPatch;
6989
5782
  "session.attention.changed": SessionAttentionObservationPatch;
6990
- "network.thread.opened": NetworkObservationPatch;
6991
- "network.direct_room.opened": NetworkObservationPatch;
6992
- "network.message.persisted": NetworkObservationPatch;
6993
- "network.work.opened": NetworkObservationPatch;
6994
- "network.work.transitioned": NetworkObservationPatch;
6995
- "network.work.closed": NetworkObservationPatch;
6996
- "network.peer.joined": NetworkObservationPatch;
6997
- "network.peer.left": NetworkObservationPatch;
6998
- "network.participation.pre_resolve": NetworkParticipationPreResolvePatch;
6999
- "network.participation.resolved": NetworkParticipationResolvedPatch;
7000
5783
  "window_manager.layout.applied": WindowManagerObservationPatch;
7001
5784
  "window_manager.desktop.created": WindowManagerObservationPatch;
7002
5785
  "window_manager.desktop.deleted": WindowManagerObservationPatch;
@@ -7091,18 +5874,6 @@ export interface HostAPIMethodMap {
7091
5874
  params: SessionStatusGetParams;
7092
5875
  result: SessionStatusResponse;
7093
5876
  };
7094
- "sandbox/list": {
7095
- params: SandboxListParams | undefined;
7096
- result: SandboxListResult;
7097
- };
7098
- "sandbox/info": {
7099
- params: SandboxInfoParams;
7100
- result: SandboxInfoResult;
7101
- };
7102
- "sandbox/exec": {
7103
- params: SandboxExecParams;
7104
- result: SandboxExecResult;
7105
- };
7106
5877
  "memory/recall": {
7107
5878
  params: MemoryRecallParams;
7108
5879
  result: MemoryRecallEntry[];
@@ -7331,54 +6102,6 @@ export interface HostAPIMethodMap {
7331
6102
  params: TaskRunCancelParams;
7332
6103
  result: TaskRun;
7333
6104
  };
7334
- "network/status": {
7335
- params: undefined;
7336
- result: NetworkStatusPayload;
7337
- };
7338
- "network/usage": {
7339
- params: NetworkUsageParams;
7340
- result: NetworkUsageResponse;
7341
- };
7342
- "network/channels": {
7343
- params: NetworkChannelsParams;
7344
- result: NetworkChannelPayload[];
7345
- };
7346
- "network/peers": {
7347
- params: NetworkPeersParams;
7348
- result: NetworkPeerPayload[];
7349
- };
7350
- "network/threads": {
7351
- params: NetworkThreadsParams;
7352
- result: NetworkThreadsResponse;
7353
- };
7354
- "network/thread/get": {
7355
- params: NetworkThreadTargetParams;
7356
- result: NetworkThreadSummaryPayload;
7357
- };
7358
- "network/thread/messages": {
7359
- params: NetworkThreadMessagesParams;
7360
- result: NetworkThreadMessagesResponse;
7361
- };
7362
- "network/directs": {
7363
- params: NetworkDirectsParams;
7364
- result: NetworkDirectRoomsResponse;
7365
- };
7366
- "network/direct/resolve": {
7367
- params: NetworkDirectResolveParams;
7368
- result: NetworkDirectRoomPayload;
7369
- };
7370
- "network/direct/messages": {
7371
- params: NetworkDirectMessagesParams;
7372
- result: NetworkDirectRoomMessagesResponse;
7373
- };
7374
- "network/work/get": {
7375
- params: NetworkWorkGetParams;
7376
- result: NetworkWorkPayload;
7377
- };
7378
- "network/send": {
7379
- params: NetworkSendParams;
7380
- result: NetworkSendPayload;
7381
- };
7382
6105
  "resources/list": {
7383
6106
  params: ResourcesListParams | undefined;
7384
6107
  result: ResourceRecord[];
@@ -7391,29 +6114,12 @@ export interface HostAPIMethodMap {
7391
6114
  params: ResourcesSnapshotParams;
7392
6115
  result: EmptyResult;
7393
6116
  };
7394
- "bridges/instances/list": {
7395
- params: undefined;
7396
- result: BridgeInstance[];
7397
- };
7398
- "bridges/messages/ingest": {
7399
- params: InboundMessageEnvelope;
7400
- result: BridgesMessagesIngestResult;
7401
- };
7402
- "bridges/instances/get": {
7403
- params: BridgeInstanceTargetParams;
7404
- result: BridgeInstance;
7405
- };
7406
- "bridges/instances/report_state": {
7407
- params: BridgesInstancesReportStateParams;
7408
- result: BridgeInstance;
7409
- };
7410
6117
  "clarify/ask": {
7411
6118
  params: ClarifyAskParams;
7412
6119
  result: ClarifyAnswer;
7413
6120
  };
7414
6121
  }
7415
6122
  export declare const REQUIRED_METHODS_BY_PROVIDE: {
7416
- readonly "bridge.adapter": readonly ["bridges/deliver", "bridges/targets/snapshot"];
7417
6123
  readonly "connectivity.provider": readonly ["connectivity/establish", "connectivity/status", "connectivity/teardown"];
7418
6124
  readonly "forge.provider": readonly ["forge/capabilities", "forge/pr_create", "forge/status"];
7419
6125
  readonly "loop.watch_source": readonly ["watch/poll"];