@sorbetai/acp 0.1.0-alpha.0 → 0.1.0-alpha.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (94) hide show
  1. package/COMPATIBILITY.md +149 -137
  2. package/MCP_HOST.md +2 -1
  3. package/README.md +121 -42
  4. package/agent.json +2 -2
  5. package/dist/W3CTraceContextPropagator-BqnCtQOQ.js +1843 -0
  6. package/dist/W3CTraceContextPropagator-BqnCtQOQ.js.map +1 -0
  7. package/dist/{agent-DY9tWj9z.js → agent-D4Pckpd-.js} +511 -187
  8. package/dist/agent-D4Pckpd-.js.map +1 -0
  9. package/dist/{agent-B7tO52_4.d.ts → agent-Dx9JAMk-.d.ts} +5 -3
  10. package/dist/{authentication-pNA443FX.js → authentication-vf6z-Lz1.js} +41 -20
  11. package/dist/authentication-vf6z-Lz1.js.map +1 -0
  12. package/dist/{compatibility-BD_TbVPM.d.ts → compatibility-BEe-9K6g.d.ts} +66 -18
  13. package/dist/{compatibility-1QpPxK_p.js → compatibility-DHKXJ5QO.js} +70 -16
  14. package/dist/compatibility-DHKXJ5QO.js.map +1 -0
  15. package/dist/compatibility.d.ts +1 -1
  16. package/dist/compatibility.js +1 -1
  17. package/dist/credentials-ZHLMBZpx.d.ts +19916 -0
  18. package/dist/dist-BL6z1iLg.js +1978 -0
  19. package/dist/dist-BL6z1iLg.js.map +1 -0
  20. package/dist/{environment-D9j7BLR7.js → environment-Ubf48xyf.js} +270 -123
  21. package/dist/environment-Ubf48xyf.js.map +1 -0
  22. package/dist/{experimental-v2-BCAb8mKD.js → experimental-v2-B27Nqm6V.js} +260 -59
  23. package/dist/experimental-v2-B27Nqm6V.js.map +1 -0
  24. package/dist/{experimental-v2-BkVh4DI5.d.ts → experimental-v2-BgqmHMwu.d.ts} +7 -5
  25. package/dist/experimental-v2.d.ts +4 -3
  26. package/dist/experimental-v2.js +7 -6
  27. package/dist/extensions-CiM2_sm_.js +22 -0
  28. package/dist/extensions-CiM2_sm_.js.map +1 -0
  29. package/dist/extensions-vrYnDHFr.d.ts +90 -0
  30. package/dist/extensions.d.ts +2 -33
  31. package/dist/extensions.js +2 -2
  32. package/dist/filesystem-worker.js +3850 -4309
  33. package/dist/filesystem-worker.js.map +1 -1
  34. package/dist/{index-fSbkxdkc.d.ts → index-BjYqLLBr.d.ts} +11 -8
  35. package/dist/index.d.ts +6 -5
  36. package/dist/index.js +9 -8
  37. package/dist/isolate-worker.mjs +7959 -12956
  38. package/dist/koffi-_vJIIc1O.js +294 -0
  39. package/dist/koffi-_vJIIc1O.js.map +1 -0
  40. package/dist/managed-worker.js +5 -4
  41. package/dist/managed-worker.js.map +1 -1
  42. package/dist/{mcp-host-profile-DHnfdZNU.js → mcp-host-profile-Cm3exPND.js} +99 -43
  43. package/dist/mcp-host-profile-Cm3exPND.js.map +1 -0
  44. package/dist/mcp-host.d.ts +1 -1
  45. package/dist/mcp-host.js +3 -3
  46. package/dist/mcp-host.js.map +1 -1
  47. package/dist/otlp-314qO8IE.js +4290 -0
  48. package/dist/otlp-314qO8IE.js.map +1 -0
  49. package/dist/process-worker.js +3 -4
  50. package/dist/process-worker.js.map +1 -1
  51. package/dist/{prompt-work-CiuX5Z_7.js → prompt-work-DZ3ncoOg.js} +33334 -23654
  52. package/dist/prompt-work-DZ3ncoOg.js.map +1 -0
  53. package/dist/{stdio-SpFgt4YA.js → stdio-Dd0sWlCk.js} +3 -3
  54. package/dist/{stdio-SpFgt4YA.js.map → stdio-Dd0sWlCk.js.map} +1 -1
  55. package/dist/{stdio-cli-main-DBUMMwJi.js → stdio-cli-main-SqQNz1wK.js} +2645 -2785
  56. package/dist/stdio-cli-main-SqQNz1wK.js.map +1 -0
  57. package/dist/stdio-cli.js +1 -1
  58. package/dist/stdio.d.ts +5 -4
  59. package/dist/stdio.js +9 -8
  60. package/dist/supervised-command-DNcHAKrD-oT0IP9MS.js +1019 -0
  61. package/dist/supervised-command-DNcHAKrD-oT0IP9MS.js.map +1 -0
  62. package/package.json +40 -45
  63. package/dist/agent-DY9tWj9z.js.map +0 -1
  64. package/dist/authentication-pNA443FX.js.map +0 -1
  65. package/dist/compatibility-1QpPxK_p.js.map +0 -1
  66. package/dist/environment-D9j7BLR7.js.map +0 -1
  67. package/dist/esm-BtdR1t_L.js +0 -1762
  68. package/dist/esm-BtdR1t_L.js.map +0 -1
  69. package/dist/execAsync-B4-X9Hoy.js +0 -14
  70. package/dist/execAsync-B4-X9Hoy.js.map +0 -1
  71. package/dist/experimental-v2-BCAb8mKD.js.map +0 -1
  72. package/dist/extensions-Da4-kIik.js +0 -14
  73. package/dist/extensions-Da4-kIik.js.map +0 -1
  74. package/dist/getMachineId-bsd-IHzOcFWI.js +0 -30
  75. package/dist/getMachineId-bsd-IHzOcFWI.js.map +0 -1
  76. package/dist/getMachineId-darwin-BecBWon1.js +0 -27
  77. package/dist/getMachineId-darwin-BecBWon1.js.map +0 -1
  78. package/dist/getMachineId-linux-Ce7oJ7Ie.js +0 -23
  79. package/dist/getMachineId-linux-Ce7oJ7Ie.js.map +0 -1
  80. package/dist/getMachineId-unsupported-BkvLks-h.js +0 -18
  81. package/dist/getMachineId-unsupported-BkvLks-h.js.map +0 -1
  82. package/dist/getMachineId-win-DjQUtLb-.js +0 -29
  83. package/dist/getMachineId-win-DjQUtLb-.js.map +0 -1
  84. package/dist/index-zP3wkYvN.d.ts +0 -9329
  85. package/dist/mcp-host-profile-DHnfdZNU.js.map +0 -1
  86. package/dist/metrics-BUyfNRF_-BmvM6Q32.js +0 -694
  87. package/dist/metrics-BUyfNRF_-BmvM6Q32.js.map +0 -1
  88. package/dist/otlp-BHSWLZNu.js +0 -16144
  89. package/dist/otlp-BHSWLZNu.js.map +0 -1
  90. package/dist/prompt-work-CiuX5Z_7.js.map +0 -1
  91. package/dist/stdio-cli-main-DBUMMwJi.js.map +0 -1
  92. package/dist/supervised-command-bugWwh_y-CN8RpnOM.js +0 -123
  93. package/dist/supervised-command-bugWwh_y-CN8RpnOM.js.map +0 -1
  94. /package/dist/{LICENSE.worker.typebox → LICENSE.pi-schema.typebox} +0 -0
package/COMPATIBILITY.md CHANGED
@@ -20,7 +20,7 @@ supported behavior is connected and operational.
20
20
 
21
21
  | Extension package | Version |
22
22
  | -------------------- | ------- |
23
- | `acp-extension-core` | `0.1.7` |
23
+ | `acp-extension-core` | `0.3.0` |
24
24
 
25
25
  ## Summary
26
26
 
@@ -28,14 +28,14 @@ supported behavior is connected and operational.
28
28
  | ------------------------------- | --------: | ------: | ----------: | ----: |
29
29
  | Stable v1 Agent methods | 17 | 0 | 11 | 28 |
30
30
  | Stable v1 Client methods | 11 | 0 | 3 | 14 |
31
- | Stable v1 Session updates | 12 | 0 | 3 | 15 |
31
+ | Stable v1 Session updates | 13 | 0 | 2 | 15 |
32
32
  | Experimental v2 Agent methods | 15 | 1 | 10 | 26 |
33
33
  | Experimental v2 Client methods | 7 | 0 | 0 | 7 |
34
- | Experimental v2 Session updates | 14 | 0 | 5 | 19 |
34
+ | Experimental v2 Session updates | 15 | 0 | 4 | 19 |
35
35
  | Shared protocol methods | 1 | 0 | 0 | 1 |
36
- | Lody extension capabilities | 8 | 0 | 3 | 11 |
37
- | Lody custom methods | 8 | 0 | 2 | 10 |
38
- | Sorbet extensions | 7 | 0 | 1 | 8 |
36
+ | Lody extension capabilities | 8 | 0 | 6 | 14 |
37
+ | Lody custom methods | 8 | 0 | 5 | 13 |
38
+ | Sorbet extensions | 13 | 0 | 1 | 14 |
39
39
 
40
40
  ## Status definitions
41
41
 
@@ -47,36 +47,36 @@ supported behavior is connected and operational.
47
47
 
48
48
  ## Stable v1 Agent methods
49
49
 
50
- | Protocol item | Status | Notes |
51
- | --------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
52
- | `initialize` | ✅ Supported | Negotiates ACP v1, Client capabilities, Sorbet extensions, and advertised features. |
53
- | `authenticate` | ✅ Supported | Dispatches only authentication methods supplied by the injected authentication port. |
54
- | `logout` | ✅ Supported | Uses the injected authentication port or logs out NodeAgent provider credentials. |
55
- | `providers/list` | ✅ Supported | Lists stable Pi Provider slots with non-secret process-local endpoint state. |
56
- | `providers/set` | ✅ Supported | Fully replaces a known Provider endpoint without persisting headers or routing state. |
57
- | `providers/disable` | ✅ Supported | Disables a Provider endpoint while preserving its stable discoverable definition. |
58
- | `session/new` | ✅ Supported | Creates a durable Sorbet Session with workspace, MCP, and model bindings. |
59
- | `session/load` | ✅ Supported | Reopens an unattached Session, abandons interrupted execution without retrying effects, pauses its Goal, and replays durable conversation and Plan projections. |
60
- | `session/list` | ✅ Supported | Provides cwd filtering and opaque cursor pagination. |
61
- | `session/delete` | ✅ Supported | Closes connection state and idempotently deletes the Session catalog entry. |
62
- | `session/fork` | ✅ Supported | Creates an independent durable Session from a committed conversation boundary. |
63
- | `session/resume` | ✅ Supported | Reopens an unattached durable Session with new connection-scoped bindings. |
64
- | `session/close` | ✅ Supported | Aborts active work and releases Session, MCP, and connection resources. |
65
- | `session/set_mode` | ✅ Supported | Keeps ACP v1 Session mode at its sole advertised default; permissions use permission_mode. |
66
- | `session/set_config_option` | ✅ Supported | Applies advertised model, thinking-level, and permission selectors and publishes updated option state. |
67
- | `session/prompt` | ✅ Supported | Runs prompts and, in Plan permission mode, reviews the proposal before an idempotent implementation Run. |
68
- | `session/cancel` | ✅ Supported | Pauses the active Goal and cancels and drains current work, including automatic Runs without an ACP prompt owner. |
69
- | `mcp/message` | ❌ Unsupported | Stable v1 supports stdio, HTTP, and SSE MCP, but not MCP-over-ACP. |
70
- | `nes/start` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
71
- | `nes/suggest` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
72
- | `nes/accept` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
73
- | `nes/reject` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
74
- | `nes/close` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
75
- | `document/didOpen` | ❌ Unsupported | No editor document-state port is connected or advertised. |
76
- | `document/didChange` | ❌ Unsupported | No editor document-state port is connected or advertised. |
77
- | `document/didClose` | ❌ Unsupported | No editor document-state port is connected or advertised. |
78
- | `document/didSave` | ❌ Unsupported | No editor document-state port is connected or advertised. |
79
- | `document/didFocus` | ❌ Unsupported | No editor document-state port is connected or advertised. |
50
+ | Protocol item | Status | Notes |
51
+ | --------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
52
+ | `initialize` | ✅ Supported | Negotiates ACP v1, Client capabilities, Sorbet extensions, and advertised features. |
53
+ | `authenticate` | ✅ Supported | Dispatches only authentication methods supplied by the injected authentication port. |
54
+ | `logout` | ✅ Supported | Uses the injected authentication port or logs out NodeAgent provider credentials. |
55
+ | `providers/list` | ✅ Supported | Lists stable Pi Provider slots with non-secret endpoint state that survives a restart. |
56
+ | `providers/set` | ✅ Supported | Fully replaces a known Provider endpoint; the protocol and base URL persist while request headers stay in the process. |
57
+ | `providers/disable` | ✅ Supported | Disables a Provider endpoint while preserving its stable discoverable definition, and forgets the stored endpoint. |
58
+ | `session/new` | ✅ Supported | Creates a durable Sorbet Session with workspace, MCP, and model bindings. |
59
+ | `session/load` | ✅ Supported | Reopens an unattached Session, resumes unparked interrupted Runs through NodeAgent, and replays durable conversation and Plan projections. Recovery never re-executes an Effect attempt. |
60
+ | `session/list` | ✅ Supported | Provides cwd filtering and opaque cursor pagination. |
61
+ | `session/delete` | ✅ Supported | Closes connection state and idempotently deletes the Session catalog entry. |
62
+ | `session/fork` | ✅ Supported | Creates an independent durable Session from a committed conversation boundary. |
63
+ | `session/resume` | ✅ Supported | Reopens an unattached durable Session with new connection-scoped bindings. |
64
+ | `session/close` | ✅ Supported | Aborts active work and releases Session, MCP, and connection resources. |
65
+ | `session/set_mode` | ✅ Supported | Keeps ACP v1 Session mode at its sole advertised default; permissions use permission_mode. |
66
+ | `session/set_config_option` | ✅ Supported | Applies advertised model, thinking-level, and permission selectors and publishes updated option state. |
67
+ | `session/prompt` | ✅ Supported | Runs prompts and, in Plan permission mode, reviews the proposal before an idempotent implementation Run. |
68
+ | `session/cancel` | ✅ Supported | Pauses the active Goal and cancels and drains current work, including automatic Runs without an ACP prompt owner. |
69
+ | `mcp/message` | ❌ Unsupported | Stable v1 supports stdio, HTTP, and SSE MCP, but not MCP-over-ACP. |
70
+ | `nes/start` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
71
+ | `nes/suggest` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
72
+ | `nes/accept` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
73
+ | `nes/reject` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
74
+ | `nes/close` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
75
+ | `document/didOpen` | ❌ Unsupported | No editor document-state port is connected or advertised. |
76
+ | `document/didChange` | ❌ Unsupported | No editor document-state port is connected or advertised. |
77
+ | `document/didClose` | ❌ Unsupported | No editor document-state port is connected or advertised. |
78
+ | `document/didSave` | ❌ Unsupported | No editor document-state port is connected or advertised. |
79
+ | `document/didFocus` | ❌ Unsupported | No editor document-state port is connected or advertised. |
80
80
 
81
81
  ## Stable v1 Client methods
82
82
 
@@ -99,54 +99,54 @@ supported behavior is connected and operational.
99
99
 
100
100
  ## Stable v1 Session updates
101
101
 
102
- | Protocol item | Status | Notes |
103
- | --------------------------- | -------------- | --------------------------------------------------------------------------------------------------------- |
104
- | `user_message_chunk` | ✅ Supported | Emitted while replaying durable user conversation entries. |
105
- | `agent_message_chunk` | ✅ Supported | Streams Pi assistant text and replays durable assistant messages. |
106
- | `agent_thought_chunk` | ✅ Supported | Streams Pi thinking deltas when the model produces them. |
107
- | `tool_call` | ✅ Supported | Publishes complete Pi Tool calls after argument streaming finishes. |
108
- | `tool_call_update` | ✅ Supported | Publishes Tool execution status, partial results, and terminal outcomes. |
109
- | `plan` | ✅ Supported | Projects durable checklist entries for Clients using the stable legacy Plan update. |
110
- | `plan_update` | ✅ Supported | Projects durable item and Markdown Plans when the Client advertises Plan capability. |
111
- | `plan_removed` | ✅ Supported | Removes a projected Plan when the Client advertises Plan capability. |
112
- | `available_commands_update` | ❌ Unsupported | Sorbet has no ACP command catalog projection. |
113
- | `compaction_summary_chunk` | ❌ Unsupported | Sorbet does not yet stream standard ACP compaction summary chunks. |
114
- | `compaction_update` | ❌ Unsupported | Sorbet compaction is currently projected through the Lody extension only. |
115
- | `current_mode_update` | ✅ Supported | Emitted when the Client selects the sole advertised default mode. |
116
- | `config_option_update` | ✅ Supported | Emitted after an advertised Session config option changes. |
117
- | `session_info_update` | ✅ Supported | Publishes durable titles with Lody titleSource provenance, activity timestamps, and MCP startup warnings. |
118
- | `usage_update` | ✅ Supported | Publishes current context occupancy, model context size, and cumulative Session cost. |
102
+ | Protocol item | Status | Notes |
103
+ | --------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
104
+ | `user_message_chunk` | ✅ Supported | Emitted while replaying durable user conversation entries. |
105
+ | `agent_message_chunk` | ✅ Supported | Streams Pi assistant text and replays durable assistant messages. |
106
+ | `agent_thought_chunk` | ✅ Supported | Streams Pi thinking deltas when the model produces them. |
107
+ | `tool_call` | ✅ Supported | Publishes complete Pi Tool calls after argument streaming finishes. |
108
+ | `tool_call_update` | ✅ Supported | Publishes Tool execution status, partial results, and terminal outcomes. |
109
+ | `plan` | ✅ Supported | Projects durable checklist entries for Clients using the stable legacy Plan update. |
110
+ | `plan_update` | ✅ Supported | Projects durable item and Markdown Plans when the Client advertises Plan capability. |
111
+ | `plan_removed` | ✅ Supported | Removes a projected Plan when the Client advertises Plan capability. |
112
+ | `available_commands_update` | ✅ Supported | Publishes Session slash command snapshots and routes client prompt invocations through the Session command owner. |
113
+ | `compaction_summary_chunk` | ❌ Unsupported | Sorbet does not yet stream standard ACP compaction summary chunks. |
114
+ | `compaction_update` | ❌ Unsupported | Sorbet compaction is currently projected through the Lody extension only. |
115
+ | `current_mode_update` | ✅ Supported | Emitted when the Client selects the sole advertised default mode. |
116
+ | `config_option_update` | ✅ Supported | Emitted after an advertised Session config option changes. |
117
+ | `session_info_update` | ✅ Supported | Publishes durable titles with Lody titleSource provenance, activity timestamps, and MCP startup warnings. |
118
+ | `usage_update` | ✅ Supported | Publishes Session cost and context occupancy; the newest Run subtotal, unsettled request counters, and occupancy provenance travel under _meta.sorbet. |
119
119
 
120
120
  ## Experimental v2 Agent methods
121
121
 
122
- | Protocol item | Status | Notes |
123
- | --------------------------- | -------------- | ------------------------------------------------------------------------------------------------------ |
124
- | `initialize` | ✅ Supported | Negotiates ACP v2 and advertises only operational draft capabilities. |
125
- | `auth/login` | ✅ Supported | Dispatches only methods supplied by the injected authentication port. |
126
- | `auth/logout` | ✅ Supported | Uses the injected authentication port or NodeAgent provider logout. |
127
- | `providers/list` | ✅ Supported | Lists stable Pi Provider slots with non-secret process-local endpoint state. |
128
- | `providers/set` | ✅ Supported | Fully replaces a known Provider endpoint without persisting headers or routing state. |
129
- | `providers/disable` | ✅ Supported | Disables a Provider endpoint while preserving its stable discoverable definition. |
130
- | `session/new` | ✅ Supported | Creates a durable Session with stdio, HTTP, or ACP-relayed MCP Tools. |
131
- | `session/list` | ✅ Supported | Provides cwd filtering and opaque cursor pagination. |
132
- | `session/delete` | ✅ Supported | Closes connection state and idempotently deletes the Session. |
133
- | `session/fork` | ✅ Supported | Creates an independent durable Session from a committed conversation boundary. |
134
- | `session/resume` | ⚠️ Partial | Unattached Session resume, replay-from-start, and MCP work; draft update-ID replay does not. |
135
- | `session/close` | ✅ Supported | Aborts active work and releases connection-scoped Session resources. |
136
- | `session/set_config_option` | ✅ Supported | Applies advertised model, thinking-level, and permission selectors and publishes updated option state. |
137
- | `session/prompt` | ✅ Supported | Acknowledges before execution, reviews Plan proposals, and completes through background state updates. |
138
- | `session/cancel` | ✅ Supported | Aborts the active Sorbet Run and propagates cancellation to Pi. |
139
- | `mcp/message` | ✅ Supported | Routes MCP server requests and notifications over active ACP relay connections. |
140
- | `nes/start` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
141
- | `nes/suggest` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
142
- | `nes/accept` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
143
- | `nes/reject` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
144
- | `nes/close` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
145
- | `document/didOpen` | ❌ Unsupported | No editor document-state port is connected or advertised. |
146
- | `document/didChange` | ❌ Unsupported | No editor document-state port is connected or advertised. |
147
- | `document/didClose` | ❌ Unsupported | No editor document-state port is connected or advertised. |
148
- | `document/didSave` | ❌ Unsupported | No editor document-state port is connected or advertised. |
149
- | `document/didFocus` | ❌ Unsupported | No editor document-state port is connected or advertised. |
122
+ | Protocol item | Status | Notes |
123
+ | --------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------- |
124
+ | `initialize` | ✅ Supported | Negotiates ACP v2 and advertises only operational draft capabilities. |
125
+ | `auth/login` | ✅ Supported | Dispatches only methods supplied by the injected authentication port. |
126
+ | `auth/logout` | ✅ Supported | Uses the injected authentication port or NodeAgent provider logout. |
127
+ | `providers/list` | ✅ Supported | Lists stable Pi Provider slots with non-secret endpoint state that survives a restart. |
128
+ | `providers/set` | ✅ Supported | Fully replaces a known Provider endpoint; the protocol and base URL persist while request headers stay in the process. |
129
+ | `providers/disable` | ✅ Supported | Disables a Provider endpoint while preserving its stable discoverable definition, and forgets the stored endpoint. |
130
+ | `session/new` | ✅ Supported | Creates a durable Session with stdio, HTTP, or ACP-relayed MCP Tools. |
131
+ | `session/list` | ✅ Supported | Provides cwd filtering and opaque cursor pagination. |
132
+ | `session/delete` | ✅ Supported | Closes connection state and idempotently deletes the Session. |
133
+ | `session/fork` | ✅ Supported | Creates an independent durable Session from a committed conversation boundary. |
134
+ | `session/resume` | ⚠️ Partial | Unattached Session resume, replay-from-start, and MCP work; draft update-ID replay does not. |
135
+ | `session/close` | ✅ Supported | Aborts active work and releases connection-scoped Session resources. |
136
+ | `session/set_config_option` | ✅ Supported | Applies advertised model, thinking-level, and permission selectors and publishes updated option state. |
137
+ | `session/prompt` | ✅ Supported | Acknowledges before execution, reviews Plan proposals, and completes through background state updates. |
138
+ | `session/cancel` | ✅ Supported | Aborts the active Sorbet Run and propagates cancellation to Pi. |
139
+ | `mcp/message` | ✅ Supported | Routes MCP server requests and notifications over active ACP relay connections. |
140
+ | `nes/start` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
141
+ | `nes/suggest` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
142
+ | `nes/accept` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
143
+ | `nes/reject` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
144
+ | `nes/close` | ❌ Unsupported | No Next Edit Suggestions engine is connected or advertised. |
145
+ | `document/didOpen` | ❌ Unsupported | No editor document-state port is connected or advertised. |
146
+ | `document/didChange` | ❌ Unsupported | No editor document-state port is connected or advertised. |
147
+ | `document/didClose` | ❌ Unsupported | No editor document-state port is connected or advertised. |
148
+ | `document/didSave` | ❌ Unsupported | No editor document-state port is connected or advertised. |
149
+ | `document/didFocus` | ❌ Unsupported | No editor document-state port is connected or advertised. |
150
150
 
151
151
  ## Experimental v2 Client methods
152
152
 
@@ -162,27 +162,27 @@ supported behavior is connected and operational.
162
162
 
163
163
  ## Experimental v2 Session updates
164
164
 
165
- | Protocol item | Status | Notes |
166
- | --------------------------- | -------------- | --------------------------------------------------------------------------------------------------------- |
167
- | `user_message_chunk` | ✅ Supported | Emitted for accepted prompts and replay before the authoritative user_message upsert. |
168
- | `user_message` | ✅ Supported | Emitted for accepted prompts and durable conversation replay. |
169
- | `agent_message_chunk` | ✅ Supported | Streams Pi assistant text with stable message IDs. |
170
- | `agent_message` | ✅ Supported | Publishes authoritative final assistant message upserts. |
171
- | `agent_thought_chunk` | ✅ Supported | Streams Pi thinking deltas with stable thought message IDs. |
172
- | `agent_thought` | ✅ Supported | Publishes authoritative final Pi thinking content for live runs and replay. |
173
- | `state_update` | ✅ Supported | Publishes running and exactly one terminal idle transition per prompt. |
174
- | `tool_call_content_chunk` | ✅ Supported | Appends proven Tool content deltas and falls back to replacement updates on rewrites. |
175
- | `tool_call_update` | ✅ Supported | Publishes Tool input, execution status, progress, and terminal output. |
176
- | `terminal_update` | ❌ Unsupported | The v2 adapter has no terminal projection. |
177
- | `terminal_output_chunk` | ❌ Unsupported | The v2 adapter has no terminal projection. |
178
- | `plan_update` | ✅ Supported | Projects durable item and Markdown Plans for live work and replay. |
179
- | `plan_removed` | ✅ Supported | Removes the current durable Plan projection. |
180
- | `available_commands_update` | ❌ Unsupported | Sorbet has no ACP command catalog projection. |
181
- | `compaction_summary_chunk` | ❌ Unsupported | Sorbet does not yet stream standard ACP v2 compaction summary chunks. |
182
- | `compaction_update` | ❌ Unsupported | Sorbet has no standard ACP v2 compaction projection yet. |
183
- | `config_option_update` | ✅ Supported | Emitted after an advertised Session config option changes. |
184
- | `session_info_update` | ✅ Supported | Publishes durable titles with Lody titleSource provenance, activity timestamps, and MCP startup warnings. |
185
- | `usage_update` | ✅ Supported | Publishes current context occupancy, model context size, and cumulative Session cost. |
165
+ | Protocol item | Status | Notes |
166
+ | --------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
167
+ | `user_message_chunk` | ✅ Supported | Emitted for accepted prompts and replay before the authoritative user_message upsert. |
168
+ | `user_message` | ✅ Supported | Emitted for accepted prompts and durable conversation replay. |
169
+ | `agent_message_chunk` | ✅ Supported | Streams Pi assistant text with stable message IDs. |
170
+ | `agent_message` | ✅ Supported | Publishes authoritative final assistant message upserts. |
171
+ | `agent_thought_chunk` | ✅ Supported | Streams Pi thinking deltas with stable thought message IDs. |
172
+ | `agent_thought` | ✅ Supported | Publishes authoritative final Pi thinking content for live runs and replay. |
173
+ | `state_update` | ✅ Supported | Publishes running and exactly one terminal idle transition per prompt. |
174
+ | `tool_call_content_chunk` | ✅ Supported | Appends proven Tool content deltas and falls back to replacement updates on rewrites. |
175
+ | `tool_call_update` | ✅ Supported | Publishes Tool input, execution status, progress, and terminal output. |
176
+ | `terminal_update` | ❌ Unsupported | The v2 adapter has no terminal projection. |
177
+ | `terminal_output_chunk` | ❌ Unsupported | The v2 adapter has no terminal projection. |
178
+ | `plan_update` | ✅ Supported | Projects durable item and Markdown Plans for live work and replay. |
179
+ | `plan_removed` | ✅ Supported | Removes the current durable Plan projection. |
180
+ | `available_commands_update` | ✅ Supported | Publishes Session slash command snapshots and routes client prompt invocations through the Session command owner. |
181
+ | `compaction_summary_chunk` | ❌ Unsupported | Sorbet does not yet stream standard ACP v2 compaction summary chunks. |
182
+ | `compaction_update` | ❌ Unsupported | Sorbet has no standard ACP v2 compaction projection yet. |
183
+ | `config_option_update` | ✅ Supported | Emitted after an advertised Session config option changes. |
184
+ | `session_info_update` | ✅ Supported | Publishes durable titles with Lody titleSource provenance, activity timestamps, and MCP startup warnings. |
185
+ | `usage_update` | ✅ Supported | Publishes Session cost and context occupancy; the newest Run subtotal, unsettled request counters, and occupancy provenance travel under _meta.sorbet. |
186
186
 
187
187
  ## Shared protocol methods
188
188
 
@@ -192,44 +192,56 @@ supported behavior is connected and operational.
192
192
 
193
193
  ## Lody extension capabilities
194
194
 
195
- | Protocol item | Status | Notes |
196
- | ----------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
197
- | `sessionTitle` | ✅ Supported | Advertised at version 1; generates and pushes tagged durable titles after each turn. |
198
- | `usage` | ✅ Supported | Advertised at version 1 with standard and detailed per-model usage updates. |
199
- | `rateLimits` | ❌ Unsupported | No rate-limit query or update source is connected or advertised. |
200
- | `forkAtTurn` | ✅ Supported | Publishes durable Run ids as turn boundaries and forks the selected Journal prefix. |
201
- | `steering` | ✅ Supported | Advertised at version 1 for request-based steering of the active upstream turn. |
202
- | `tasks` | ❌ Unsupported | No Lody background or scheduled task lifecycle is projected or advertised. |
203
- | `subagents` | ✅ Supported | Advertises lifecycle plus durable listing, cancellation, and output for Sorbet children. |
204
- | `goal` | ✅ Supported | Advertises pause/clear requests and active-owner resume; prompt metadata starts or owns Goal work when idle. Goal prompts stay open across automatic continuations. |
205
- | `compaction` | ✅ Supported | Projects durable compaction start and terminal facts through Lody activity metadata. |
206
- | `sessionHistory` | ✅ Supported | Advertised at version 1 and replays durable conversation and Plan projections. |
207
- | `worktreeProject` | ❌ Unsupported | No logical project identity is projected beyond the ACP working directory. |
195
+ | Protocol item | Status | Notes |
196
+ | ------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
197
+ | `sessionTitle` | ✅ Supported | Advertised at version 1; generates and pushes tagged durable titles after each turn. |
198
+ | `usage` | ✅ Supported | Advertised at version 1 with standard and detailed per-model usage updates. |
199
+ | `promptSuggestions` | ❌ Unsupported | Prompt suggestion notifications are not advertised or emitted. |
200
+ | `sessionActivity` | ❌ Unsupported | Session activity notifications are not advertised or emitted. |
201
+ | `subagentEvents` | ❌ Unsupported | Subagent event notifications are not advertised or emitted. |
202
+ | `rateLimits` | ❌ Unsupported | No rate-limit query or update source is connected or advertised. |
203
+ | `forkAtTurn` | ✅ Supported | Publishes durable Run ids as turn boundaries and forks the selected Journal prefix. |
204
+ | `steering` | ✅ Supported | Advertised at version 1 for request-based steering of the active upstream turn. |
205
+ | `tasks` | ❌ Unsupported | No Lody background or scheduled task lifecycle is projected or advertised. |
206
+ | `subagents` | ✅ Supported | Advertises lifecycle plus durable listing, cancellation, and output for Sorbet children. |
207
+ | `goal` | ✅ Supported | Advertises pause/clear requests and active-owner resume; prompt metadata starts or owns Goal work when idle. Goal prompts stay open across automatic continuations. |
208
+ | `compaction` | ✅ Supported | Projects durable compaction start and terminal facts through Lody activity metadata. |
209
+ | `sessionHistory` | ✅ Supported | Advertised at version 1 and replays durable conversation and Plan projections. |
210
+ | `worktreeProject` | ❌ Unsupported | No logical project identity is projected beyond the ACP working directory. |
208
211
 
209
212
  ## Lody custom methods
210
213
 
211
- | Protocol item | Status | Notes |
212
- | ----------------------------- | -------------- | --------------------------------------------------------------------------------- |
213
- | `_lody/session/usage_update` | ✅ Supported | Emits cumulative Session and per-model usage after each assistant message. |
214
- | `_lody/rate_limits/get` | ❌ Unsupported | No Provider rate-limit query source is connected. |
215
- | `_lody/rate_limits/update` | ❌ Unsupported | No Provider rate-limit update source is connected. |
216
- | `_lody/session/steer` | ✅ Supported | Injects content into the active Run and returns failed while the Session is idle. |
217
- | `_lody/session/steer_applied` | ✅ Supported | Acknowledges the exact steer identity after Runtime injection succeeds. |
218
- | `_lody/session/goal` | ✅ Supported | Controls the durable Goal through set, pause, resume, and clear actions. |
219
- | `_lody/session/history/read` | ✅ Supported | Replays durable user and assistant conversation through standard Session updates. |
220
- | `_lody/subagents/list` | ✅ Supported | Lists durable Sorbet child-agent snapshots owned by the attached parent Session. |
221
- | `_lody/subagents/cancel` | ✅ Supported | Cancels and closes the requested Sorbet child agent. |
222
- | `_lody/subagents/output` | ✅ Supported | Returns the durable completed child response with optional line tailing. |
214
+ | Protocol item | Status | Notes |
215
+ | --------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
216
+ | `_lody/session/activity_update` | ❌ Unsupported | Session activity notifications are not emitted. |
217
+ | `_lody/session/prompt_suggestion` | ❌ Unsupported | Prompt suggestion notifications are not emitted. |
218
+ | `_lody/subagents/event` | ❌ Unsupported | Subagent event notifications are not emitted. |
219
+ | `_lody/session/usage_update` | ✅ Supported | Emits the newest Run subtotal in `usage`, cumulative per-model totals keyed by model id, an optional per-step delta, and subagent spend folded into the owning Session after each assistant message. |
220
+ | `_lody/rate_limits/get` | ❌ Unsupported | No Provider rate-limit query source is connected. |
221
+ | `_lody/rate_limits/update` | ❌ Unsupported | No Provider rate-limit update source is connected. |
222
+ | `_lody/session/steer` | ✅ Supported | Injects content into the active Run and returns failed while the Session is idle. |
223
+ | `_lody/session/steer_applied` | ✅ Supported | Acknowledges the exact steer identity after Runtime injection succeeds. |
224
+ | `_lody/session/goal` | ✅ Supported | Controls the durable Goal through set, pause, resume, and clear actions. |
225
+ | `_lody/session/history/read` | ✅ Supported | Replays durable user and assistant conversation through standard Session updates. |
226
+ | `_lody/subagents/list` | ✅ Supported | Lists durable Sorbet child-agent snapshots owned by the attached parent Session. |
227
+ | `_lody/subagents/cancel` | ✅ Supported | Cancels and closes the requested Sorbet child agent. |
228
+ | `_lody/subagents/output` | ✅ Supported | Returns the durable completed child response with optional line tailing. |
223
229
 
224
230
  ## Sorbet extensions
225
231
 
226
- | Protocol item | Status | Notes |
227
- | -------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
228
- | `_session/steering` | ✅ Supported | Stable v1 injects steering into an active Run or starts a new turn. |
229
- | `_sorbet/session/run/get` | ✅ Supported | Stable v1 returns the durable Sorbet Run snapshot. |
230
- | `_sorbet/session/replay` | ✅ Supported | Stable v1 returns cursor-based Journal fact summaries. |
231
- | `_sorbet/plugins/query` | ✅ Supported | Negotiated v1/v2 transport reads the attached Session’s Host-bound, filtered composition facade. |
232
- | `_sorbet/plugins/apply` | ✅ Supported | Submits patches to the Host-bound facade; the transport cannot supply authorization. Desired concurrency and durable command identity apply. |
233
- | `_sorbet/plugins/watch` | ✅ Supported | Starts or stops one coalesced snapshot subscription per attached Session; cleanup follows the connection. |
234
- | `_sorbet/plugins/changed` | ✅ Supported | Publishes initial and changed composition snapshots, including Service-driven Mount changes without a Desired edit. |
235
- | `_sorbet/session/activity` | ❌ Unsupported | The name is reserved, but no activity notification is emitted yet. |
232
+ | Protocol item | Status | Notes |
233
+ | --------------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
234
+ | `_sorbet/auth/credentials/list` | ✅ Supported | Lists non-secret stored credential metadata when the authentication port provides credential management. |
235
+ | `_sorbet/auth/credentials/logout` | ✅ Supported | Logs out one Provider through the authentication port credential management capability. |
236
+ | `_sorbet/providers/custom/list` | ✅ Supported | Lists persisted custom Provider definitions without exposing credentials. |
237
+ | `_sorbet/providers/custom/create` | ✅ Supported | Creates a custom Provider endpoint; Sorbet assigns the ID and adds it to the live catalog. |
238
+ | `_sorbet/providers/custom/update` | ✅ Supported | Replaces one custom Provider definition in place, keeping its ID and stored credential. |
239
+ | `_sorbet/providers/custom/delete` | ✅ Supported | Removes a custom Provider with its stored credential and endpoint; a Session or the approval reviewer still referencing it rejects the request. |
240
+ | `_session/steering` | ✅ Supported | Stable v1 injects steering into an active Run or starts a new turn. |
241
+ | `_sorbet/session/run/get` | ✅ Supported | Stable v1 returns the durable Sorbet Run snapshot. |
242
+ | `_sorbet/session/replay` | ✅ Supported | Stable v1 returns cursor-based Journal fact summaries. |
243
+ | `_sorbet/plugins/query` | ✅ Supported | Negotiated v1/v2 transport reads the attached Session’s Host-bound, filtered composition facade. |
244
+ | `_sorbet/plugins/apply` | ✅ Supported | Submits patches to the Host-bound facade; the transport cannot supply authorization. Desired concurrency and durable command identity apply. |
245
+ | `_sorbet/plugins/watch` | ✅ Supported | Starts or stops one coalesced snapshot subscription per attached Session; cleanup follows the connection. |
246
+ | `_sorbet/plugins/changed` | ✅ Supported | Publishes initial and changed composition snapshots, including Service-driven Mount changes without a Desired edit. |
247
+ | `_sorbet/session/activity` | ❌ Unsupported | The name is reserved, but no activity notification is emitted yet. |
package/MCP_HOST.md CHANGED
@@ -69,7 +69,8 @@ v1 `clientCapabilities._meta` or v2 `capabilities._meta`. Verify the Agent's
69
69
  acknowledgment before using the helper. The acknowledgment includes `version: 1`,
70
70
  `read: true`, `call: true` and `control: 'installed-services'`. No acknowledgment
71
71
  means access is unavailable, even if the Client sends a custom method anyway.
72
- The stock CLI does not opt into remote Host control; an embedding must authorize it.
72
+ The stock CLI enables remote Host control; SDK embeddings must explicitly authorize it.
73
+ The Client must still negotiate the profile and install handlers for each offered service.
73
74
  Import `MCP_EVENTS_PROFILE` from `@sorbetai/mcp`; its pinned experimental version is
74
75
  independent of stable MCP support.
75
76