@compozy/extension-sdk 0.3.0-beta.28 → 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;
@@ -3711,214 +2754,8 @@ export interface Run {
3711
2754
  error?: string;
3712
2755
  delivery_error?: string;
3713
2756
  delivery_error_at?: ISODateTime;
3714
- network_participation?: NetworkParticipationRequest;
3715
2757
  metadata?: Record<string, JSONValue>;
3716
2758
  }
3717
- export interface SandboxExecParams {
3718
- workspace_id: string;
3719
- session_id: string;
3720
- command: string;
3721
- timeout?: number;
3722
- }
3723
- export interface SandboxExecResult {
3724
- exit_code: number;
3725
- stdout?: string;
3726
- stderr?: string;
3727
- }
3728
- export interface SandboxInfoParams {
3729
- workspace_id: string;
3730
- session_id: string;
3731
- }
3732
- export interface SandboxInfoResult {
3733
- sandbox_id: string;
3734
- backend: string;
3735
- profile: string;
3736
- instance_id: string;
3737
- runtime_root: string;
3738
- sync_state: string;
3739
- created_at: ISODateTime;
3740
- last_sync_error: string;
3741
- }
3742
- export interface SandboxListParams {
3743
- workspace?: string;
3744
- }
3745
- export interface SandboxSummary {
3746
- session_id: string;
3747
- sandbox_id: string;
3748
- backend: string;
3749
- profile?: string;
3750
- instance_id?: string;
3751
- state: string;
3752
- sync_state?: string;
3753
- }
3754
- export interface SandboxListResult {
3755
- sandboxes: SandboxSummary[];
3756
- }
3757
- export type SandboxObservationPatch = Record<string, never>;
3758
- export interface SandboxPreparePatch {
3759
- deny?: boolean;
3760
- deny_reason?: string;
3761
- env_overrides?: Record<string, string>;
3762
- }
3763
- export interface SandboxProfilePayload {
3764
- profile?: string;
3765
- backend?: string;
3766
- sync_mode?: string;
3767
- persistence?: string;
3768
- runtime_root?: string;
3769
- destroy_on_stop?: boolean;
3770
- env?: Record<string, string>;
3771
- secret_env?: Record<string, string>;
3772
- }
3773
- export interface SandboxPreparePayload {
3774
- event: HookEvent;
3775
- timestamp: ISODateTime;
3776
- profile_id?: string;
3777
- session_id?: string;
3778
- session_name?: string;
3779
- session_type?: string;
3780
- agent_name?: string;
3781
- workspace_id?: string;
3782
- workspace?: string;
3783
- worktree_id?: string;
3784
- acp_session_id?: string;
3785
- state?: string;
3786
- soul_snapshot_id?: string;
3787
- soul_digest?: string;
3788
- created_at: ISODateTime;
3789
- updated_at: ISODateTime;
3790
- sandbox_id?: string;
3791
- backend?: string;
3792
- profile: SandboxProfilePayload;
3793
- local_root?: string;
3794
- local_additional_dirs?: string[];
3795
- agent_command?: string;
3796
- agent_env?: string[];
3797
- permissions?: string;
3798
- resume_acp_state?: string;
3799
- env_overrides?: Record<string, string>;
3800
- denied?: boolean;
3801
- deny_reason?: string;
3802
- }
3803
- export type SandboxReadyPatch = Record<string, never>;
3804
- export interface SandboxReadyPayload {
3805
- event: HookEvent;
3806
- timestamp: ISODateTime;
3807
- profile_id?: string;
3808
- session_id?: string;
3809
- session_name?: string;
3810
- session_type?: string;
3811
- agent_name?: string;
3812
- workspace_id?: string;
3813
- workspace?: string;
3814
- worktree_id?: string;
3815
- acp_session_id?: string;
3816
- state?: string;
3817
- soul_snapshot_id?: string;
3818
- soul_digest?: string;
3819
- created_at: ISODateTime;
3820
- updated_at: ISODateTime;
3821
- sandbox_id?: string;
3822
- backend?: string;
3823
- profile?: string;
3824
- instance_id?: string;
3825
- runtime_root?: string;
3826
- runtime_additional_dirs?: string[];
3827
- }
3828
- export interface SandboxStopPatch {
3829
- deny?: boolean;
3830
- deny_reason?: string;
3831
- }
3832
- export interface SandboxStopPayload {
3833
- event: HookEvent;
3834
- timestamp: ISODateTime;
3835
- profile_id?: string;
3836
- session_id?: string;
3837
- session_name?: string;
3838
- session_type?: string;
3839
- agent_name?: string;
3840
- workspace_id?: string;
3841
- workspace?: string;
3842
- worktree_id?: string;
3843
- acp_session_id?: string;
3844
- state?: string;
3845
- soul_snapshot_id?: string;
3846
- soul_digest?: string;
3847
- created_at: ISODateTime;
3848
- updated_at: ISODateTime;
3849
- sandbox_id?: string;
3850
- backend?: string;
3851
- profile?: string;
3852
- instance_id?: string;
3853
- runtime_root?: string;
3854
- stop_reason?: string;
3855
- will_destroy?: boolean;
3856
- denied?: boolean;
3857
- deny_reason?: string;
3858
- }
3859
- export type SandboxSyncAfterPatch = Record<string, never>;
3860
- export interface SandboxSyncAfterPayload {
3861
- event: HookEvent;
3862
- timestamp: ISODateTime;
3863
- profile_id?: string;
3864
- session_id?: string;
3865
- session_name?: string;
3866
- session_type?: string;
3867
- agent_name?: string;
3868
- workspace_id?: string;
3869
- workspace?: string;
3870
- worktree_id?: string;
3871
- acp_session_id?: string;
3872
- state?: string;
3873
- soul_snapshot_id?: string;
3874
- soul_digest?: string;
3875
- created_at: ISODateTime;
3876
- updated_at: ISODateTime;
3877
- sandbox_id?: string;
3878
- backend?: string;
3879
- profile?: string;
3880
- instance_id?: string;
3881
- runtime_root?: string;
3882
- direction?: string;
3883
- reason?: string;
3884
- files_synced?: number;
3885
- bytes_transferred?: number;
3886
- duration_ms?: number;
3887
- errors?: string[];
3888
- }
3889
- export interface SandboxSyncBeforePatch {
3890
- deny?: boolean;
3891
- deny_reason?: string;
3892
- exclude_patterns?: string[];
3893
- }
3894
- export interface SandboxSyncBeforePayload {
3895
- event: HookEvent;
3896
- timestamp: ISODateTime;
3897
- profile_id?: string;
3898
- session_id?: string;
3899
- session_name?: string;
3900
- session_type?: string;
3901
- agent_name?: string;
3902
- workspace_id?: string;
3903
- workspace?: string;
3904
- worktree_id?: string;
3905
- acp_session_id?: string;
3906
- state?: string;
3907
- soul_snapshot_id?: string;
3908
- soul_digest?: string;
3909
- created_at: ISODateTime;
3910
- updated_at: ISODateTime;
3911
- sandbox_id?: string;
3912
- backend?: string;
3913
- profile?: string;
3914
- instance_id?: string;
3915
- runtime_root?: string;
3916
- direction?: string;
3917
- reason?: string;
3918
- exclude_patterns?: string[];
3919
- denied?: boolean;
3920
- deny_reason?: string;
3921
- }
3922
2759
  export interface SessionAttentionChangedPayload {
3923
2760
  event: HookEvent;
3924
2761
  timestamp: ISODateTime;
@@ -4440,6 +3277,8 @@ export interface RuntimeSelectionPayload {
4440
3277
  }
4441
3278
  export interface ACPCapsPayload {
4442
3279
  supports_load_session: boolean;
3280
+ supports_fork_session: boolean;
3281
+ supports_resume_session: boolean;
4443
3282
  prompt_image: boolean;
4444
3283
  prompt_audio: boolean;
4445
3284
  prompt_embedded_context: boolean;
@@ -4497,6 +3336,41 @@ export interface PendingInteractionPayload {
4497
3336
  resolution?: string;
4498
3337
  resolved_by?: string;
4499
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
+ }
4500
3374
  export interface SessionStatusResponse {
4501
3375
  queue?: SessionQueueSummaryPayload;
4502
3376
  lifecycle_state?: State;
@@ -4515,6 +3389,8 @@ export interface SessionStatusResponse {
4515
3389
  ineligibility_reason?: SessionHealthIneligibilityReason;
4516
3390
  wake_state?: HeartbeatWakeStatePayload;
4517
3391
  pending_interactions: PendingInteractionPayload[];
3392
+ lineage?: SessionLineagePayload;
3393
+ derivation?: SessionDerivationPayload;
4518
3394
  updated_at: ISODateTime;
4519
3395
  }
4520
3396
  export interface SessionSummary {
@@ -4534,7 +3410,6 @@ export interface SessionTargetParams {
4534
3410
  export interface SessionsCreateParams {
4535
3411
  agent: string;
4536
3412
  workspace?: string;
4537
- network_participation?: NetworkParticipationRequest;
4538
3413
  }
4539
3414
  export interface SessionsListParams {
4540
3415
  workspace?: string;
@@ -4595,7 +3470,6 @@ export interface SpawnContext {
4595
3470
  task_id?: string;
4596
3471
  run_id?: string;
4597
3472
  workflow_id?: string;
4598
- resolved_network_participation?: NetworkParticipationSpec;
4599
3473
  soul_snapshot_id?: string;
4600
3474
  soul_digest?: string;
4601
3475
  parent_soul_digest?: string;
@@ -4625,7 +3499,6 @@ export interface SpawnCreatedPayload {
4625
3499
  task_id?: string;
4626
3500
  run_id?: string;
4627
3501
  workflow_id?: string;
4628
- resolved_network_participation?: NetworkParticipationSpec;
4629
3502
  soul_snapshot_id?: string;
4630
3503
  soul_digest?: string;
4631
3504
  parent_soul_digest?: string;
@@ -4652,7 +3525,6 @@ export interface SpawnLifecyclePayload {
4652
3525
  task_id?: string;
4653
3526
  run_id?: string;
4654
3527
  workflow_id?: string;
4655
- resolved_network_participation?: NetworkParticipationSpec;
4656
3528
  soul_snapshot_id?: string;
4657
3529
  soul_digest?: string;
4658
3530
  parent_soul_digest?: string;
@@ -4682,7 +3554,6 @@ export interface SpawnParentStoppedPayload {
4682
3554
  task_id?: string;
4683
3555
  run_id?: string;
4684
3556
  workflow_id?: string;
4685
- resolved_network_participation?: NetworkParticipationSpec;
4686
3557
  soul_snapshot_id?: string;
4687
3558
  soul_digest?: string;
4688
3559
  parent_soul_digest?: string;
@@ -4709,7 +3580,6 @@ export interface SpawnPreCreatePayload {
4709
3580
  task_id?: string;
4710
3581
  run_id?: string;
4711
3582
  workflow_id?: string;
4712
- resolved_network_participation?: NetworkParticipationSpec;
4713
3583
  soul_snapshot_id?: string;
4714
3584
  soul_digest?: string;
4715
3585
  parent_soul_digest?: string;
@@ -4735,7 +3605,6 @@ export interface SpawnReapedPayload {
4735
3605
  task_id?: string;
4736
3606
  run_id?: string;
4737
3607
  workflow_id?: string;
4738
- resolved_network_participation?: NetworkParticipationSpec;
4739
3608
  soul_snapshot_id?: string;
4740
3609
  soul_digest?: string;
4741
3610
  parent_soul_digest?: string;
@@ -4762,7 +3631,6 @@ export interface SpawnTTLExpiredPayload {
4762
3631
  task_id?: string;
4763
3632
  run_id?: string;
4764
3633
  workflow_id?: string;
4765
- resolved_network_participation?: NetworkParticipationSpec;
4766
3634
  soul_snapshot_id?: string;
4767
3635
  soul_digest?: string;
4768
3636
  parent_soul_digest?: string;
@@ -4812,7 +3680,6 @@ export interface Task {
4812
3680
  scope: Scope;
4813
3681
  workspace_id?: string;
4814
3682
  parent_task_id?: string;
4815
- resolved_network_participation?: NetworkParticipationSpec;
4816
3683
  title: string;
4817
3684
  description?: string;
4818
3685
  priority?: Priority;
@@ -4853,7 +3720,6 @@ export interface TaskBlockedPayload {
4853
3720
  parent_task_id?: string;
4854
3721
  workspace_id?: string;
4855
3722
  workflow_id?: string;
4856
- resolved_network_participation?: NetworkParticipationSpec;
4857
3723
  agent_name?: string;
4858
3724
  actor_kind?: string;
4859
3725
  actor_id?: string;
@@ -4881,7 +3747,6 @@ export interface TaskContext {
4881
3747
  parent_task_id?: string;
4882
3748
  workspace_id?: string;
4883
3749
  workflow_id?: string;
4884
- resolved_network_participation?: NetworkParticipationSpec;
4885
3750
  agent_name?: string;
4886
3751
  actor_kind?: string;
4887
3752
  actor_id?: string;
@@ -4897,7 +3762,6 @@ export interface TaskCreateParams {
4897
3762
  identifier?: string;
4898
3763
  scope: Scope;
4899
3764
  workspace?: string;
4900
- network_participation?: NetworkParticipationRequest;
4901
3765
  title: string;
4902
3766
  description?: string;
4903
3767
  priority?: Priority;
@@ -4973,7 +3837,6 @@ export interface TaskDashboardStatusBreakdownPayload {
4973
3837
  share_percent: number;
4974
3838
  }
4975
3839
  export interface TaskDashboardQueueDepthPayload {
4976
- channel_id?: string;
4977
3840
  count: number;
4978
3841
  oldest_queued_at: ISODateTime;
4979
3842
  oldest_queue_age_ms: number;
@@ -5008,7 +3871,6 @@ export interface TaskDashboardActiveRunPayload {
5008
3871
  attempt: number;
5009
3872
  max_attempts: number;
5010
3873
  session_id?: string;
5011
- resolved_network_participation?: NetworkParticipationSpec;
5012
3874
  last_activity_at: ISODateTime;
5013
3875
  age_ms: number;
5014
3876
  health_status: string;
@@ -5047,7 +3909,6 @@ export interface TaskDashboardParams {
5047
3909
  worktree?: string;
5048
3910
  owner_kind?: OwnerKind;
5049
3911
  owner_ref?: string;
5050
- participation_channel?: string;
5051
3912
  origin_kind?: OriginKind;
5052
3913
  }
5053
3914
  export type DependencyKind = string;
@@ -5073,18 +3934,6 @@ export interface TaskDependencyReferencePayload {
5073
3934
  depends_on: TaskReferencePayload;
5074
3935
  }
5075
3936
  export type ResolvedWorktreeMode = string;
5076
- export type CoordinationMessageKind = string;
5077
- export interface CoordinationChannelPayload {
5078
- id: string;
5079
- display_name: string;
5080
- purpose?: string;
5081
- workspace_id?: string;
5082
- task_id?: string;
5083
- run_id?: string;
5084
- workflow_id?: string;
5085
- allowed_message_kinds: CoordinationMessageKind[];
5086
- last_activity_at?: ISODateTime;
5087
- }
5088
3937
  export interface RunDesignationSummary {
5089
3938
  index: number;
5090
3939
  brief?: string;
@@ -5106,8 +3955,6 @@ export interface TaskRunSummaryPayload {
5106
3955
  claim_token_hash?: string;
5107
3956
  lease_until?: ISODateTime;
5108
3957
  heartbeat_at?: ISODateTime;
5109
- resolved_network_participation?: NetworkParticipationSpec;
5110
- coordination_channel?: CoordinationChannelPayload;
5111
3958
  designation_group_id?: string;
5112
3959
  designation?: RunDesignationSummary;
5113
3960
  queued_at: ISODateTime;
@@ -5126,7 +3973,6 @@ export interface TaskSummaryPayload {
5126
3973
  scope: Scope;
5127
3974
  workspace_id?: string;
5128
3975
  parent_task_id?: string;
5129
- resolved_network_participation?: NetworkParticipationSpec;
5130
3976
  title: string;
5131
3977
  priority?: Priority;
5132
3978
  max_attempts?: number;
@@ -5186,12 +4032,10 @@ export interface TaskRun {
5186
4032
  resolved_worktree_ref?: string;
5187
4033
  origin: Origin;
5188
4034
  idempotency_key?: string;
5189
- resolved_network_participation?: NetworkParticipationSpec;
5190
4035
  designation_group_id?: string;
5191
4036
  claim_token_hash?: string;
5192
4037
  lease_until?: ISODateTime;
5193
4038
  heartbeat_at?: ISODateTime;
5194
- coordination_channel?: CoordinationChannelPayload;
5195
4039
  designation?: RunDesignationSummary;
5196
4040
  queued_at: ISODateTime;
5197
4041
  claimed_at?: ISODateTime;
@@ -5257,7 +4101,6 @@ export interface TaskCatalogRunPayload {
5257
4101
  claimed_by?: ActorIdentity;
5258
4102
  lease_until?: ISODateTime;
5259
4103
  heartbeat_at?: ISODateTime;
5260
- resolved_network_participation?: NetworkParticipationSpec;
5261
4104
  queued_at: ISODateTime;
5262
4105
  claimed_at?: ISODateTime;
5263
4106
  started_at?: ISODateTime;
@@ -5331,7 +4174,6 @@ export interface TaskNeedsAttentionPayload {
5331
4174
  parent_task_id?: string;
5332
4175
  workspace_id?: string;
5333
4176
  workflow_id?: string;
5334
- resolved_network_participation?: NetworkParticipationSpec;
5335
4177
  agent_name?: string;
5336
4178
  actor_kind?: string;
5337
4179
  actor_id?: string;
@@ -5356,7 +4198,6 @@ export interface TaskRecoveredPayload {
5356
4198
  parent_task_id?: string;
5357
4199
  workspace_id?: string;
5358
4200
  workflow_id?: string;
5359
- resolved_network_participation?: NetworkParticipationSpec;
5360
4201
  agent_name?: string;
5361
4202
  actor_kind?: string;
5362
4203
  actor_id?: string;
@@ -5407,7 +4248,6 @@ export interface TaskRunCompletedPayload {
5407
4248
  loop_run_id?: string;
5408
4249
  workspace_id?: string;
5409
4250
  workflow_id?: string;
5410
- resolved_network_participation?: NetworkParticipationSpec;
5411
4251
  agent_name?: string;
5412
4252
  session_id?: string;
5413
4253
  actor_kind?: string;
@@ -5438,7 +4278,6 @@ export interface TaskRunContext {
5438
4278
  loop_run_id?: string;
5439
4279
  workspace_id?: string;
5440
4280
  workflow_id?: string;
5441
- resolved_network_participation?: NetworkParticipationSpec;
5442
4281
  agent_name?: string;
5443
4282
  session_id?: string;
5444
4283
  actor_kind?: string;
@@ -5478,28 +4317,15 @@ export interface TaskRunOperationalSummaryPayload {
5478
4317
  cost_status?: CostStatus;
5479
4318
  cost_source?: CostSource;
5480
4319
  }
5481
- export interface TaskRunConversationRefPayload {
5482
- workspace_id: string;
5483
- channel: string;
5484
- surface: string;
5485
- thread_id: string;
5486
- stream_url: string;
5487
- }
5488
- export interface TaskRunNetworkPayload {
5489
- conversation: TaskRunConversationRefPayload;
5490
- usage: NetworkUsageResponse;
5491
- }
5492
4320
  export interface TaskRunDetail {
5493
4321
  run: TaskRun;
5494
4322
  task?: TaskReferencePayload;
5495
4323
  session?: TaskRunSessionPayload;
5496
4324
  summary: TaskRunOperationalSummaryPayload;
5497
- network?: TaskRunNetworkPayload;
5498
4325
  }
5499
4326
  export interface TaskRunEnqueueParams {
5500
4327
  task_id: string;
5501
4328
  idempotency_key?: string;
5502
- network_participation?: NetworkParticipationRequest;
5503
4329
  metadata?: JSONValue;
5504
4330
  }
5505
4331
  export interface TaskRunEnqueuedPayload {
@@ -5515,7 +4341,6 @@ export interface TaskRunEnqueuedPayload {
5515
4341
  loop_run_id?: string;
5516
4342
  workspace_id?: string;
5517
4343
  workflow_id?: string;
5518
- resolved_network_participation?: NetworkParticipationSpec;
5519
4344
  agent_name?: string;
5520
4345
  session_id?: string;
5521
4346
  actor_kind?: string;
@@ -5550,7 +4375,6 @@ export interface TaskRunFailedPayload {
5550
4375
  loop_run_id?: string;
5551
4376
  workspace_id?: string;
5552
4377
  workflow_id?: string;
5553
- resolved_network_participation?: NetworkParticipationSpec;
5554
4378
  agent_name?: string;
5555
4379
  session_id?: string;
5556
4380
  actor_kind?: string;
@@ -5586,7 +4410,6 @@ export interface TaskRunLeaseExpiredPayload {
5586
4410
  loop_run_id?: string;
5587
4411
  workspace_id?: string;
5588
4412
  workflow_id?: string;
5589
- resolved_network_participation?: NetworkParticipationSpec;
5590
4413
  agent_name?: string;
5591
4414
  session_id?: string;
5592
4415
  actor_kind?: string;
@@ -5619,7 +4442,6 @@ export interface TaskRunLeaseExtendedPayload {
5619
4442
  loop_run_id?: string;
5620
4443
  workspace_id?: string;
5621
4444
  workflow_id?: string;
5622
- resolved_network_participation?: NetworkParticipationSpec;
5623
4445
  agent_name?: string;
5624
4446
  session_id?: string;
5625
4447
  actor_kind?: string;
@@ -5652,7 +4474,6 @@ export interface TaskRunLeasePayload {
5652
4474
  loop_run_id?: string;
5653
4475
  workspace_id?: string;
5654
4476
  workflow_id?: string;
5655
- resolved_network_participation?: NetworkParticipationSpec;
5656
4477
  agent_name?: string;
5657
4478
  session_id?: string;
5658
4479
  actor_kind?: string;
@@ -5685,7 +4506,6 @@ export interface TaskRunLeaseRecoveredPayload {
5685
4506
  loop_run_id?: string;
5686
4507
  workspace_id?: string;
5687
4508
  workflow_id?: string;
5688
- resolved_network_participation?: NetworkParticipationSpec;
5689
4509
  agent_name?: string;
5690
4510
  session_id?: string;
5691
4511
  actor_kind?: string;
@@ -5721,7 +4541,6 @@ export interface TaskRunPostClaimPayload {
5721
4541
  loop_run_id?: string;
5722
4542
  workspace_id?: string;
5723
4543
  workflow_id?: string;
5724
- resolved_network_participation?: NetworkParticipationSpec;
5725
4544
  agent_name?: string;
5726
4545
  session_id?: string;
5727
4546
  actor_kind?: string;
@@ -5757,7 +4576,6 @@ export interface TaskRunPreClaimPayload {
5757
4576
  loop_run_id?: string;
5758
4577
  workspace_id?: string;
5759
4578
  workflow_id?: string;
5760
- resolved_network_participation?: NetworkParticipationSpec;
5761
4579
  agent_name?: string;
5762
4580
  session_id?: string;
5763
4581
  actor_kind?: string;
@@ -5789,7 +4607,6 @@ export interface TaskRunReleasedPayload {
5789
4607
  loop_run_id?: string;
5790
4608
  workspace_id?: string;
5791
4609
  workflow_id?: string;
5792
- resolved_network_participation?: NetworkParticipationSpec;
5793
4610
  agent_name?: string;
5794
4611
  session_id?: string;
5795
4612
  actor_kind?: string;
@@ -5832,7 +4649,6 @@ export interface TaskRunsParams {
5832
4649
  id: string;
5833
4650
  status?: RunStatus;
5834
4651
  session_id?: string;
5835
- participation_channel?: string;
5836
4652
  limit?: number;
5837
4653
  }
5838
4654
  export interface TaskStatusChangedPayload {
@@ -5843,7 +4659,6 @@ export interface TaskStatusChangedPayload {
5843
4659
  parent_task_id?: string;
5844
4660
  workspace_id?: string;
5845
4661
  workflow_id?: string;
5846
- resolved_network_participation?: NetworkParticipationSpec;
5847
4662
  agent_name?: string;
5848
4663
  actor_kind?: string;
5849
4664
  actor_id?: string;
@@ -5899,7 +4714,6 @@ export interface TaskUnblockedPayload {
5899
4714
  parent_task_id?: string;
5900
4715
  workspace_id?: string;
5901
4716
  workflow_id?: string;
5902
- resolved_network_participation?: NetworkParticipationSpec;
5903
4717
  agent_name?: string;
5904
4718
  actor_kind?: string;
5905
4719
  actor_id?: string;
@@ -5925,7 +4739,6 @@ export interface TaskUpdateParams {
5925
4739
  auto_enqueue_on_ready?: boolean;
5926
4740
  approval_policy?: ApprovalPolicy;
5927
4741
  metadata?: JSONValue;
5928
- network_participation?: NetworkParticipationRequest;
5929
4742
  owner?: Ownership;
5930
4743
  clear_owner?: boolean;
5931
4744
  }
@@ -5943,7 +4756,6 @@ export interface TasksParams {
5943
4756
  owner_ref?: string;
5944
4757
  parent_task_id?: string;
5945
4758
  worktree?: string;
5946
- participation_channel?: string;
5947
4759
  query?: string;
5948
4760
  sort?: CatalogSort;
5949
4761
  cursor?: string;
@@ -5959,7 +4771,6 @@ export interface TaskCatalogItemPayload {
5959
4771
  scope: Scope;
5960
4772
  workspace_id?: string;
5961
4773
  parent_task_id?: string;
5962
- resolved_network_participation?: NetworkParticipationSpec;
5963
4774
  title: string;
5964
4775
  priority?: Priority;
5965
4776
  max_attempts?: number;
@@ -6803,11 +5614,6 @@ export interface HookPayloadByEvent {
6803
5614
  "session.runtime_recovery.started": SessionRuntimeRecoveryStartedPayload;
6804
5615
  "session.runtime_recovery.succeeded": SessionRuntimeRecoverySucceededPayload;
6805
5616
  "session.runtime_recovery.exhausted": SessionRuntimeRecoveryExhaustedPayload;
6806
- "sandbox.prepare": SandboxPreparePayload;
6807
- "sandbox.ready": SandboxReadyPayload;
6808
- "sandbox.sync.before": SandboxSyncBeforePayload;
6809
- "sandbox.sync.after": SandboxSyncAfterPayload;
6810
- "sandbox.stop": SandboxStopPayload;
6811
5617
  "input.pre_submit": InputPreSubmitPayload;
6812
5618
  "prompt.post_assemble": PromptPayload;
6813
5619
  "event.pre_record": EventPreRecordPayload;
@@ -6873,16 +5679,6 @@ export interface HookPayloadByEvent {
6873
5679
  "spawn.ttl_expired": SpawnTTLExpiredPayload;
6874
5680
  "spawn.reaped": SpawnReapedPayload;
6875
5681
  "session.attention.changed": SessionAttentionChangedPayload;
6876
- "network.thread.opened": NetworkThreadOpenedPayload;
6877
- "network.direct_room.opened": NetworkDirectRoomOpenedPayload;
6878
- "network.message.persisted": NetworkMessagePersistedPayload;
6879
- "network.work.opened": NetworkWorkOpenedPayload;
6880
- "network.work.transitioned": NetworkWorkTransitionedPayload;
6881
- "network.work.closed": NetworkWorkClosedPayload;
6882
- "network.peer.joined": NetworkPeerJoinedPayload;
6883
- "network.peer.left": NetworkPeerLeftPayload;
6884
- "network.participation.pre_resolve": NetworkParticipationPreResolvePayload;
6885
- "network.participation.resolved": NetworkParticipationResolvedPayload;
6886
5682
  "window_manager.layout.applied": WindowManagerLayoutAppliedPayload;
6887
5683
  "window_manager.desktop.created": WindowManagerDesktopCreatedPayload;
6888
5684
  "window_manager.desktop.deleted": WindowManagerDesktopDeletedPayload;
@@ -6919,11 +5715,6 @@ export interface HookPatchByEvent {
6919
5715
  "session.runtime_recovery.started": AuthoredContextObservationPatch;
6920
5716
  "session.runtime_recovery.succeeded": AuthoredContextObservationPatch;
6921
5717
  "session.runtime_recovery.exhausted": AuthoredContextObservationPatch;
6922
- "sandbox.prepare": SandboxPreparePatch;
6923
- "sandbox.ready": SandboxReadyPatch;
6924
- "sandbox.sync.before": SandboxSyncBeforePatch;
6925
- "sandbox.sync.after": SandboxSyncAfterPatch;
6926
- "sandbox.stop": SandboxStopPatch;
6927
5718
  "input.pre_submit": InputPreSubmitPatch;
6928
5719
  "prompt.post_assemble": PromptPatch;
6929
5720
  "event.pre_record": EventPreRecordPatch;
@@ -6989,16 +5780,6 @@ export interface HookPatchByEvent {
6989
5780
  "spawn.ttl_expired": SpawnObservationPatch;
6990
5781
  "spawn.reaped": SpawnObservationPatch;
6991
5782
  "session.attention.changed": SessionAttentionObservationPatch;
6992
- "network.thread.opened": NetworkObservationPatch;
6993
- "network.direct_room.opened": NetworkObservationPatch;
6994
- "network.message.persisted": NetworkObservationPatch;
6995
- "network.work.opened": NetworkObservationPatch;
6996
- "network.work.transitioned": NetworkObservationPatch;
6997
- "network.work.closed": NetworkObservationPatch;
6998
- "network.peer.joined": NetworkObservationPatch;
6999
- "network.peer.left": NetworkObservationPatch;
7000
- "network.participation.pre_resolve": NetworkParticipationPreResolvePatch;
7001
- "network.participation.resolved": NetworkParticipationResolvedPatch;
7002
5783
  "window_manager.layout.applied": WindowManagerObservationPatch;
7003
5784
  "window_manager.desktop.created": WindowManagerObservationPatch;
7004
5785
  "window_manager.desktop.deleted": WindowManagerObservationPatch;
@@ -7093,18 +5874,6 @@ export interface HostAPIMethodMap {
7093
5874
  params: SessionStatusGetParams;
7094
5875
  result: SessionStatusResponse;
7095
5876
  };
7096
- "sandbox/list": {
7097
- params: SandboxListParams | undefined;
7098
- result: SandboxListResult;
7099
- };
7100
- "sandbox/info": {
7101
- params: SandboxInfoParams;
7102
- result: SandboxInfoResult;
7103
- };
7104
- "sandbox/exec": {
7105
- params: SandboxExecParams;
7106
- result: SandboxExecResult;
7107
- };
7108
5877
  "memory/recall": {
7109
5878
  params: MemoryRecallParams;
7110
5879
  result: MemoryRecallEntry[];
@@ -7333,54 +6102,6 @@ export interface HostAPIMethodMap {
7333
6102
  params: TaskRunCancelParams;
7334
6103
  result: TaskRun;
7335
6104
  };
7336
- "network/status": {
7337
- params: undefined;
7338
- result: NetworkStatusPayload;
7339
- };
7340
- "network/usage": {
7341
- params: NetworkUsageParams;
7342
- result: NetworkUsageResponse;
7343
- };
7344
- "network/channels": {
7345
- params: NetworkChannelsParams;
7346
- result: NetworkChannelPayload[];
7347
- };
7348
- "network/peers": {
7349
- params: NetworkPeersParams;
7350
- result: NetworkPeerPayload[];
7351
- };
7352
- "network/threads": {
7353
- params: NetworkThreadsParams;
7354
- result: NetworkThreadsResponse;
7355
- };
7356
- "network/thread/get": {
7357
- params: NetworkThreadTargetParams;
7358
- result: NetworkThreadSummaryPayload;
7359
- };
7360
- "network/thread/messages": {
7361
- params: NetworkThreadMessagesParams;
7362
- result: NetworkThreadMessagesResponse;
7363
- };
7364
- "network/directs": {
7365
- params: NetworkDirectsParams;
7366
- result: NetworkDirectRoomsResponse;
7367
- };
7368
- "network/direct/resolve": {
7369
- params: NetworkDirectResolveParams;
7370
- result: NetworkDirectRoomPayload;
7371
- };
7372
- "network/direct/messages": {
7373
- params: NetworkDirectMessagesParams;
7374
- result: NetworkDirectRoomMessagesResponse;
7375
- };
7376
- "network/work/get": {
7377
- params: NetworkWorkGetParams;
7378
- result: NetworkWorkPayload;
7379
- };
7380
- "network/send": {
7381
- params: NetworkSendParams;
7382
- result: NetworkSendPayload;
7383
- };
7384
6105
  "resources/list": {
7385
6106
  params: ResourcesListParams | undefined;
7386
6107
  result: ResourceRecord[];
@@ -7393,29 +6114,12 @@ export interface HostAPIMethodMap {
7393
6114
  params: ResourcesSnapshotParams;
7394
6115
  result: EmptyResult;
7395
6116
  };
7396
- "bridges/instances/list": {
7397
- params: undefined;
7398
- result: BridgeInstance[];
7399
- };
7400
- "bridges/messages/ingest": {
7401
- params: InboundMessageEnvelope;
7402
- result: BridgesMessagesIngestResult;
7403
- };
7404
- "bridges/instances/get": {
7405
- params: BridgeInstanceTargetParams;
7406
- result: BridgeInstance;
7407
- };
7408
- "bridges/instances/report_state": {
7409
- params: BridgesInstancesReportStateParams;
7410
- result: BridgeInstance;
7411
- };
7412
6117
  "clarify/ask": {
7413
6118
  params: ClarifyAskParams;
7414
6119
  result: ClarifyAnswer;
7415
6120
  };
7416
6121
  }
7417
6122
  export declare const REQUIRED_METHODS_BY_PROVIDE: {
7418
- readonly "bridge.adapter": readonly ["bridges/deliver", "bridges/targets/snapshot"];
7419
6123
  readonly "connectivity.provider": readonly ["connectivity/establish", "connectivity/status", "connectivity/teardown"];
7420
6124
  readonly "forge.provider": readonly ["forge/capabilities", "forge/pr_create", "forge/status"];
7421
6125
  readonly "loop.watch_source": readonly ["watch/poll"];