@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.
- package/COMPATIBILITY.md +98 -94
- package/README.md +61 -15
- package/agent.json +1 -1
- package/dist/W3CTraceContextPropagator-CW8yXeW3.js +1843 -0
- package/dist/W3CTraceContextPropagator-CW8yXeW3.js.map +1 -0
- package/dist/{agent-S0BFq45U.d.ts → agent-D6YCR88q.d.ts} +3 -3
- package/dist/{agent-BovB-tw0.js → agent-DKPpR4vm.js} +241 -40
- package/dist/agent-DKPpR4vm.js.map +1 -0
- package/dist/{authentication-BIVmLfrb.js → authentication-fNnv3xa8.js} +12 -8
- package/dist/authentication-fNnv3xa8.js.map +1 -0
- package/dist/{compatibility-87fR9ZAa.d.ts → compatibility-BPwcjEUV.d.ts} +26 -10
- package/dist/{compatibility-DbQl9fV9.js → compatibility-BqOhyCUP.js} +26 -10
- package/dist/compatibility-BqOhyCUP.js.map +1 -0
- package/dist/compatibility.d.ts +1 -1
- package/dist/compatibility.js +1 -1
- package/dist/{credentials-CHHCSH_7.d.ts → credentials-D5piJd6F.d.ts} +690 -697
- package/dist/{environment-7S0-Wqln.js → environment-BePz_waz.js} +1 -1
- package/dist/{environment-7S0-Wqln.js.map → environment-BePz_waz.js.map} +1 -1
- package/dist/{experimental-v2-BoLcFf2t.d.ts → experimental-v2-6juQfXRs.d.ts} +3 -3
- package/dist/{experimental-v2-CY-_9I4S.js → experimental-v2-BJIQbdGm.js} +101 -21
- package/dist/experimental-v2-BJIQbdGm.js.map +1 -0
- package/dist/experimental-v2.d.ts +4 -4
- package/dist/experimental-v2.js +6 -6
- package/dist/extensions-91p5K6rB.js +22 -0
- package/dist/extensions-91p5K6rB.js.map +1 -0
- package/dist/extensions-br2BE0bG.d.ts +90 -0
- package/dist/extensions.d.ts +2 -2
- package/dist/extensions.js +2 -2
- package/dist/filesystem-worker.js +1474 -1530
- package/dist/filesystem-worker.js.map +1 -1
- package/dist/{index-B1Rr3ylL.d.ts → index-BOkVkd2m.d.ts} +7 -7
- package/dist/index.d.ts +5 -5
- package/dist/index.js +8 -8
- package/dist/isolate-worker.mjs +1824 -1862
- package/dist/managed-worker.js +2 -2
- package/dist/{mcp-host-profile-RdE3910q.js → mcp-host-profile-CIaaS8Hf.js} +24 -21
- package/dist/mcp-host-profile-CIaaS8Hf.js.map +1 -0
- package/dist/mcp-host.d.ts +1 -1
- package/dist/mcp-host.js +1 -1
- package/dist/otlp-A--tiAwj.js +4290 -0
- package/dist/otlp-A--tiAwj.js.map +1 -0
- package/dist/process-worker.js +1 -1
- package/dist/{prompt-work-GOaSft-m.js → prompt-work-BhO8aF3u.js} +2787 -1434
- package/dist/prompt-work-BhO8aF3u.js.map +1 -0
- package/dist/{stdio-CR8vZgia.js → stdio-BcrAEASy.js} +3 -3
- package/dist/{stdio-CR8vZgia.js.map → stdio-BcrAEASy.js.map} +1 -1
- package/dist/{stdio-cli-main-C2eTBZdr.js → stdio-cli-main-DoNdrtKX.js} +95 -171
- package/dist/stdio-cli-main-DoNdrtKX.js.map +1 -0
- package/dist/stdio-cli.js +1 -1
- package/dist/stdio.d.ts +5 -5
- package/dist/stdio.js +8 -8
- package/dist/{supervised-command-bugWwh_y-CN8RpnOM.js → supervised-command-bugWwh_y-CZrLe3ON.js} +1 -1
- package/dist/{supervised-command-bugWwh_y-CN8RpnOM.js.map → supervised-command-bugWwh_y-CZrLe3ON.js.map} +1 -1
- package/package.json +38 -37
- package/dist/agent-BovB-tw0.js.map +0 -1
- package/dist/authentication-BIVmLfrb.js.map +0 -1
- package/dist/compatibility-DbQl9fV9.js.map +0 -1
- package/dist/esm-ADdBCfsU.js +0 -1762
- package/dist/esm-ADdBCfsU.js.map +0 -1
- package/dist/execAsync-BvmYsUWQ.js +0 -14
- package/dist/execAsync-BvmYsUWQ.js.map +0 -1
- package/dist/experimental-v2-CY-_9I4S.js.map +0 -1
- package/dist/extensions-8WYNyhPy.d.ts +0 -47
- package/dist/extensions-Eaix9kSN.js +0 -17
- package/dist/extensions-Eaix9kSN.js.map +0 -1
- package/dist/getMachineId-bsd-DMi4LSrq.js +0 -30
- package/dist/getMachineId-bsd-DMi4LSrq.js.map +0 -1
- package/dist/getMachineId-darwin-D4kzFBWw.js +0 -27
- package/dist/getMachineId-darwin-D4kzFBWw.js.map +0 -1
- package/dist/getMachineId-linux-BaClIYJg.js +0 -23
- package/dist/getMachineId-linux-BaClIYJg.js.map +0 -1
- package/dist/getMachineId-unsupported-BTb7CCyX.js +0 -18
- package/dist/getMachineId-unsupported-BTb7CCyX.js.map +0 -1
- package/dist/getMachineId-win-S5PVECTO.js +0 -29
- package/dist/getMachineId-win-S5PVECTO.js.map +0 -1
- package/dist/mcp-host-profile-RdE3910q.js.map +0 -1
- package/dist/otlp-BUnHo5Yu.js +0 -12259
- package/dist/otlp-BUnHo5Yu.js.map +0 -1
- package/dist/prompt-work-GOaSft-m.js.map +0 -1
- package/dist/src-Bc3Cz0DW.js +0 -4753
- package/dist/src-Bc3Cz0DW.js.map +0 -1
- 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 |
|
|
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
|
|
56
|
-
| `providers/set` | ✅ Supported | Fully replaces a known Provider endpoint
|
|
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
|
|
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
|
|
128
|
-
| `providers/set` | ✅ Supported | Fully replaces a known Provider endpoint
|
|
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
|
|
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
|
|
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
|
-
| `
|
|
231
|
-
| `_sorbet/
|
|
232
|
-
| `_sorbet/
|
|
233
|
-
| `_sorbet/
|
|
234
|
-
| `
|
|
235
|
-
| `_sorbet/
|
|
236
|
-
| `_sorbet/
|
|
237
|
-
| `_sorbet/
|
|
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.
|
|
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
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
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
|
-
|
|
354
|
-
|
|
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
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
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.
|
|
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",
|