@sorbetai/acp 0.1.0-alpha.6 → 0.1.0-alpha.8

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 (82) hide show
  1. package/COMPATIBILITY.md +98 -94
  2. package/README.md +61 -15
  3. package/agent.json +1 -1
  4. package/dist/W3CTraceContextPropagator-CW8yXeW3.js +1843 -0
  5. package/dist/W3CTraceContextPropagator-CW8yXeW3.js.map +1 -0
  6. package/dist/{agent-S0BFq45U.d.ts → agent-D6YCR88q.d.ts} +3 -3
  7. package/dist/{agent-BovB-tw0.js → agent-DKPpR4vm.js} +241 -40
  8. package/dist/agent-DKPpR4vm.js.map +1 -0
  9. package/dist/{authentication-BIVmLfrb.js → authentication-fNnv3xa8.js} +12 -8
  10. package/dist/authentication-fNnv3xa8.js.map +1 -0
  11. package/dist/{compatibility-87fR9ZAa.d.ts → compatibility-BPwcjEUV.d.ts} +26 -10
  12. package/dist/{compatibility-DbQl9fV9.js → compatibility-BqOhyCUP.js} +26 -10
  13. package/dist/compatibility-BqOhyCUP.js.map +1 -0
  14. package/dist/compatibility.d.ts +1 -1
  15. package/dist/compatibility.js +1 -1
  16. package/dist/{credentials-CHHCSH_7.d.ts → credentials-D5piJd6F.d.ts} +690 -697
  17. package/dist/{environment-7S0-Wqln.js → environment-BePz_waz.js} +1 -1
  18. package/dist/{environment-7S0-Wqln.js.map → environment-BePz_waz.js.map} +1 -1
  19. package/dist/{experimental-v2-BoLcFf2t.d.ts → experimental-v2-6juQfXRs.d.ts} +3 -3
  20. package/dist/{experimental-v2-CY-_9I4S.js → experimental-v2-BJIQbdGm.js} +101 -21
  21. package/dist/experimental-v2-BJIQbdGm.js.map +1 -0
  22. package/dist/experimental-v2.d.ts +4 -4
  23. package/dist/experimental-v2.js +6 -6
  24. package/dist/extensions-91p5K6rB.js +22 -0
  25. package/dist/extensions-91p5K6rB.js.map +1 -0
  26. package/dist/extensions-br2BE0bG.d.ts +90 -0
  27. package/dist/extensions.d.ts +2 -2
  28. package/dist/extensions.js +2 -2
  29. package/dist/filesystem-worker.js +1474 -1530
  30. package/dist/filesystem-worker.js.map +1 -1
  31. package/dist/{index-B1Rr3ylL.d.ts → index-BOkVkd2m.d.ts} +7 -7
  32. package/dist/index.d.ts +5 -5
  33. package/dist/index.js +8 -8
  34. package/dist/isolate-worker.mjs +1824 -1862
  35. package/dist/managed-worker.js +2 -2
  36. package/dist/{mcp-host-profile-RdE3910q.js → mcp-host-profile-CIaaS8Hf.js} +24 -21
  37. package/dist/mcp-host-profile-CIaaS8Hf.js.map +1 -0
  38. package/dist/mcp-host.d.ts +1 -1
  39. package/dist/mcp-host.js +1 -1
  40. package/dist/otlp-A--tiAwj.js +4290 -0
  41. package/dist/otlp-A--tiAwj.js.map +1 -0
  42. package/dist/process-worker.js +1 -1
  43. package/dist/{prompt-work-GOaSft-m.js → prompt-work-BhO8aF3u.js} +2787 -1434
  44. package/dist/prompt-work-BhO8aF3u.js.map +1 -0
  45. package/dist/{stdio-CR8vZgia.js → stdio-BcrAEASy.js} +3 -3
  46. package/dist/{stdio-CR8vZgia.js.map → stdio-BcrAEASy.js.map} +1 -1
  47. package/dist/{stdio-cli-main-C2eTBZdr.js → stdio-cli-main-DoNdrtKX.js} +95 -171
  48. package/dist/stdio-cli-main-DoNdrtKX.js.map +1 -0
  49. package/dist/stdio-cli.js +1 -1
  50. package/dist/stdio.d.ts +5 -5
  51. package/dist/stdio.js +8 -8
  52. package/dist/{supervised-command-bugWwh_y-CN8RpnOM.js → supervised-command-bugWwh_y-CZrLe3ON.js} +1 -1
  53. package/dist/{supervised-command-bugWwh_y-CN8RpnOM.js.map → supervised-command-bugWwh_y-CZrLe3ON.js.map} +1 -1
  54. package/package.json +38 -37
  55. package/dist/agent-BovB-tw0.js.map +0 -1
  56. package/dist/authentication-BIVmLfrb.js.map +0 -1
  57. package/dist/compatibility-DbQl9fV9.js.map +0 -1
  58. package/dist/esm-ADdBCfsU.js +0 -1762
  59. package/dist/esm-ADdBCfsU.js.map +0 -1
  60. package/dist/execAsync-BvmYsUWQ.js +0 -14
  61. package/dist/execAsync-BvmYsUWQ.js.map +0 -1
  62. package/dist/experimental-v2-CY-_9I4S.js.map +0 -1
  63. package/dist/extensions-8WYNyhPy.d.ts +0 -47
  64. package/dist/extensions-Eaix9kSN.js +0 -17
  65. package/dist/extensions-Eaix9kSN.js.map +0 -1
  66. package/dist/getMachineId-bsd-DMi4LSrq.js +0 -30
  67. package/dist/getMachineId-bsd-DMi4LSrq.js.map +0 -1
  68. package/dist/getMachineId-darwin-D4kzFBWw.js +0 -27
  69. package/dist/getMachineId-darwin-D4kzFBWw.js.map +0 -1
  70. package/dist/getMachineId-linux-BaClIYJg.js +0 -23
  71. package/dist/getMachineId-linux-BaClIYJg.js.map +0 -1
  72. package/dist/getMachineId-unsupported-BTb7CCyX.js +0 -18
  73. package/dist/getMachineId-unsupported-BTb7CCyX.js.map +0 -1
  74. package/dist/getMachineId-win-S5PVECTO.js +0 -29
  75. package/dist/getMachineId-win-S5PVECTO.js.map +0 -1
  76. package/dist/mcp-host-profile-RdE3910q.js.map +0 -1
  77. package/dist/otlp-BUnHo5Yu.js +0 -12259
  78. package/dist/otlp-BUnHo5Yu.js.map +0 -1
  79. package/dist/prompt-work-GOaSft-m.js.map +0 -1
  80. package/dist/src-Bc3Cz0DW.js +0 -4753
  81. package/dist/src-Bc3Cz0DW.js.map +0 -1
  82. package/dist/stdio-cli-main-C2eTBZdr.js.map +0 -1
package/COMPATIBILITY.md CHANGED
@@ -35,7 +35,7 @@ supported behavior is connected and operational.
35
35
  | Shared protocol methods | 1 | 0 | 0 | 1 |
36
36
  | Lody extension capabilities | 8 | 0 | 3 | 11 |
37
37
  | Lody custom methods | 8 | 0 | 2 | 10 |
38
- | Sorbet extensions | 9 | 0 | 1 | 10 |
38
+ | Sorbet extensions | 13 | 0 | 1 | 14 |
39
39
 
40
40
  ## Status definitions
41
41
 
@@ -52,9 +52,9 @@ supported behavior is connected and operational.
52
52
  | `initialize` | ✅ Supported | Negotiates ACP v1, Client capabilities, Sorbet extensions, and advertised features. |
53
53
  | `authenticate` | ✅ Supported | Dispatches only authentication methods supplied by the injected authentication port. |
54
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. |
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
58
  | `session/new` | ✅ Supported | Creates a durable Sorbet Session with workspace, MCP, and model bindings. |
59
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
60
  | `session/list` | ✅ Supported | Provides cwd filtering and opaque cursor pagination. |
@@ -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` | ✅ 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 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` | ✅ 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 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
 
@@ -208,30 +208,34 @@ supported behavior is connected and operational.
208
208
 
209
209
  ## Lody custom methods
210
210
 
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. |
211
+ | Protocol item | Status | Notes |
212
+ | ----------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
213
+ | `_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. |
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. |
223
223
 
224
224
  ## Sorbet extensions
225
225
 
226
- | Protocol item | Status | Notes |
227
- | --------------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
228
- | `_sorbet/auth/credentials/list` | ✅ Supported | Lists non-secret stored credential metadata when the authentication port provides credential management. |
229
- | `_sorbet/auth/credentials/logout` | ✅ Supported | Logs out one Provider through the authentication port credential management capability. |
230
- | `_session/steering` | ✅ Supported | Stable v1 injects steering into an active Run or starts a new turn. |
231
- | `_sorbet/session/run/get` | ✅ Supported | Stable v1 returns the durable Sorbet Run snapshot. |
232
- | `_sorbet/session/replay` | ✅ Supported | Stable v1 returns cursor-based Journal fact summaries. |
233
- | `_sorbet/plugins/query` | ✅ Supported | Negotiated v1/v2 transport reads the attached Session’s Host-bound, filtered composition facade. |
234
- | `_sorbet/plugins/apply` | ✅ Supported | Submits patches to the Host-bound facade; the transport cannot supply authorization. Desired concurrency and durable command identity apply. |
235
- | `_sorbet/plugins/watch` | ✅ Supported | Starts or stops one coalesced snapshot subscription per attached Session; cleanup follows the connection. |
236
- | `_sorbet/plugins/changed` | ✅ Supported | Publishes initial and changed composition snapshots, including Service-driven Mount changes without a Desired edit. |
237
- | `_sorbet/session/activity` | ❌ Unsupported | The name is reserved, but no activity notification is emitted yet. |
226
+ | Protocol item | Status | Notes |
227
+ | --------------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
228
+ | `_sorbet/auth/credentials/list` | ✅ Supported | Lists non-secret stored credential metadata when the authentication port provides credential management. |
229
+ | `_sorbet/auth/credentials/logout` | ✅ Supported | Logs out one Provider through the authentication port credential management capability. |
230
+ | `_sorbet/providers/custom/list` | ✅ Supported | Lists persisted custom Provider definitions without exposing credentials. |
231
+ | `_sorbet/providers/custom/create` | ✅ Supported | Creates a custom Provider endpoint; Sorbet assigns the ID and adds it to the live catalog. |
232
+ | `_sorbet/providers/custom/update` | ✅ Supported | Replaces one custom Provider definition in place, keeping its ID and stored credential. |
233
+ | `_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. |
234
+ | `_session/steering` | ✅ Supported | Stable v1 injects steering into an active Run or starts a new turn. |
235
+ | `_sorbet/session/run/get` | ✅ Supported | Stable v1 returns the durable Sorbet Run snapshot. |
236
+ | `_sorbet/session/replay` | ✅ Supported | Stable v1 returns cursor-based Journal fact summaries. |
237
+ | `_sorbet/plugins/query` | ✅ Supported | Negotiated v1/v2 transport reads the attached Session’s Host-bound, filtered composition facade. |
238
+ | `_sorbet/plugins/apply` | ✅ Supported | Submits patches to the Host-bound facade; the transport cannot supply authorization. Desired concurrency and durable command identity apply. |
239
+ | `_sorbet/plugins/watch` | ✅ Supported | Starts or stops one coalesced snapshot subscription per attached Session; cleanup follows the connection. |
240
+ | `_sorbet/plugins/changed` | ✅ Supported | Publishes initial and changed composition snapshots, including Service-driven Mount changes without a Desired edit. |
241
+ | `_sorbet/session/activity` | ❌ Unsupported | The name is reserved, but no activity notification is emitted yet. |
package/README.md CHANGED
@@ -251,7 +251,7 @@ Only the ACP tarball needs to be published. The stdio integration test extracts
251
251
  that tarball, supplies only its third-party runtime dependencies, and exercises
252
252
  the packaged CLI, sandboxed filesystem worker, and command execution.
253
253
  Use pnpm for packing and publishing so catalog dependency versions are resolved.
254
- The package requires Node.js 22.19.0 or later.
254
+ The package requires Node.js 22.22.0 or later.
255
255
 
256
256
  ## Lody Setup
257
257
 
@@ -271,13 +271,19 @@ may instead launch `node packages/acp/dist/stdio-cli.js`; production configs
271
271
  should use the PATH-resolved executable so they do not depend on a checkout's
272
272
  absolute path.
273
273
 
274
- Stable v1 advertises Provider OAuth methods when the Client supports both form and URL
275
- elicitation. Generic ACP does not expose API-key login; a Provider that only supports an
276
- API key must be configured by the embedding Host outside ACP. Lody selects a method and
277
- relays request-scoped URL, device-code, text, or select elicitations; secret and manual-code
278
- forms additionally require Lody's credential-safe form capability. Sorbet persists the result
279
- in its credential store; credentials are never returned in ACP capability data or Lody
280
- workspace configuration.
274
+ Stable v1 advertises one `authenticate` method per Provider and per interactive mechanism:
275
+ `sorbet:<providerId>:oauth` for a Provider with an OAuth flow, and
276
+ `sorbet:<providerId>:api_key` for a Provider whose API key is entered interactively. Methods
277
+ appear only when the Client supports both form and URL elicitation; API-key methods
278
+ therefore additionally require Lody's credential-safe form capability, because the only
279
+ prompt they issue is a secret. A Provider that resolves its key from the environment without
280
+ an interactive login publishes no method and stays configured outside ACP. Sorbet stores one
281
+ credential per Provider, so authenticating a second mechanism replaces the first.
282
+
283
+ Lody selects a method and relays request-scoped URL, device-code, text, or select
284
+ elicitations; secret and manual-code forms carry `_meta.lody.elicitation.secret`.
285
+ Sorbet persists the result in its credential store; credentials are never returned in ACP
286
+ capability data or Lody workspace configuration.
281
287
 
282
288
  Session create, load, resume, and fork responses publish each advertised
283
289
  model's model-dependent ACP config options under
@@ -349,16 +355,26 @@ for measured costs and rejected simplifications.
349
355
  Both protocol versions publish `usage_update.used` as current context occupancy,
350
356
  including cached tokens, and `size` as the active Session model's context window.
351
357
  They never sum successive requests to calculate occupancy. `cost` is cumulative
352
- Session cost, including committed compaction responses and metered failed attempts.
353
- Usage is reconstructed from the Journal and refreshed after compaction, restore,
354
- and model changes. Before a Provider measurement is available, occupancy is an
358
+ Session cost, including committed compaction responses and metered failed attempts; it
359
+ is `null` when the Provider reported no price, because unknown cost must not read as
360
+ free. `_meta.sorbet` states what the numbers cannot: the occupancy measurement
361
+ (`measured` or `estimated`), the newest Run carrying the top-level `usage` scope, and
362
+ the open, unknown, and partial-usage request counters that make a cumulative total
363
+ provisional. Usage is reconstructed from the Journal and refreshed after compaction,
364
+ restore, and model changes. Before a Provider measurement is available, occupancy is an
355
365
  estimate of the reconstructed request; no context update is sent for an empty
356
366
  Session without request evidence. Estimates are not clamped to the window size.
357
367
 
358
- The v1 detailed Lody notification contains cumulative Session and per-model
359
- billing totals across Runs. A fork inherits context but starts its own billing
360
- history. Model window metadata comes from the runtime model configuration;
361
- custom endpoints with different limits must set `contextWindow` explicitly.
368
+ The v1 detailed Lody notification keeps the two scopes apart: `usage` is the newest
369
+ Run's subtotal, `modelUsage` is cumulative per-model billing across Runs keyed by model
370
+ id, and `delta` reports what the preceding notification newly accounted for. A
371
+ Provider that reports no price leaves `costUSD` absent instead of claiming zero. Child
372
+ Session spend is folded into the owning Session's cumulative rows and reported as
373
+ `_meta.sorbet.subagents`, because a child is not an ACP Session and has no other
374
+ accounting channel; a Client polling `_lody/subagents/list` also refreshes that fold.
375
+ A fork inherits context but starts its own billing history. Model window metadata comes
376
+ from the runtime model configuration; custom endpoints with different limits must set
377
+ `contextWindow` explicitly.
362
378
 
363
379
  ## Lody Extensions
364
380
 
@@ -469,6 +485,36 @@ supply `credentials` for the same authentication store to advertise the extensio
469
485
  methods return method-not-found. The ACP connection is trusted to manage these credentials;
470
486
  Hosts accepting untrusted Clients must enforce access at their transport boundary.
471
487
 
488
+ ## Custom Provider extension
489
+
490
+ ACP `providers/list|set|disable` select the endpoint of a Provider both sides already know.
491
+ A Provider whose identity, protocol, and model list come from the Client is a Sorbet
492
+ extension. ACP v1 and experimental v2 advertise `_meta["sorbet.dev"].customProviders:
493
+ { "version": 1 }`; Clients should check it before issuing these connection-level requests:
494
+
495
+ - `_sorbet/providers/custom/list` takes `{}` and returns `{ "providers": [...] }`.
496
+ - `_sorbet/providers/custom/create` takes `{ name, protocol, baseUrl, catalogRefs?, models }`
497
+ and returns `{ "provider": { "id": "..." } }`. Sorbet assigns the ID.
498
+ - `_sorbet/providers/custom/update` takes the same configuration plus `providerId` and
499
+ returns `{ "provider": ... }`. The ID and any stored credential stay.
500
+ - `_sorbet/providers/custom/delete` takes `{ "providerId": "..." }` and returns `{}`. It also
501
+ removes the stored credential and endpoint selection; a definition a Session or the
502
+ approval reviewer still references rejects the request.
503
+
504
+ `protocol` is `anthropic-messages`, `openai-responses`, or `openai-completions`. Each `models`
505
+ entry is `{ id, name?, reasoning?, thinkingLevelMap?, input?, contextWindow?, maxTokens? }`;
506
+ explicit fields take precedence over endpoint discovery and catalog metadata, and an omitted
507
+ field is inferred from that discovery. A rejected request — unknown Provider, conflicting
508
+ definition, Provider in use, or a configuration Sorbet cannot parse — is returned as an
509
+ invalid-params error instead of failing the Run.
510
+
511
+ Definitions are persisted in the Node Agent data directory, so a later process — including
512
+ one that never saw the request — offers the same Provider. `providers/set` persists the
513
+ protocol and base URL for the same reason; request headers carry credentials and are applied
514
+ in the current process only, so a Host that supplies headers must re-supply them after a
515
+ restart. Like the credential extension, this surface can point Sorbet at any endpoint, so a
516
+ Host exposing ACP to untrusted Clients must enforce access at its transport boundary.
517
+
472
518
  ## MCP Protocol Compatibility
473
519
 
474
520
  SDK embeddings and ACP Clients own MCP UI and credentials. Standard MCP form/URL
package/agent.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "id": "sorbet",
3
3
  "name": "Sorbet",
4
- "version": "0.1.0-alpha.6",
4
+ "version": "0.1.0-alpha.8",
5
5
  "description": "A durable Agent Harness with Pi-backed model access and ACP v1 plus experimental ACP v2 support.",
6
6
  "repository": "https://github.com/lodyspeak/sorbet",
7
7
  "license": "MIT",