@absolutejs/mcp 0.21.0 → 0.23.0
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/CHANGELOG.md +12 -0
- package/README.md +24 -0
- package/changelog.json +275 -248
- package/dist/apps.js +19 -5
- package/dist/index.js +49 -5
- package/dist/src/actionWorkflow.d.ts +5 -0
- package/dist/src/creditWorkResult.d.ts +13 -0
- package/dist/src/index.d.ts +2 -1
- package/docs/mcp-apps.md +13 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,18 @@ This file is generated by `absolute-changelog` from the entries in
|
|
|
6
6
|
`changelog/`. Edit an entry, not this file — and add new ones under
|
|
7
7
|
`changelog/unreleased/`.
|
|
8
8
|
|
|
9
|
+
## 0.23.0 — 2026-09-13
|
|
10
|
+
|
|
11
|
+
### Added
|
|
12
|
+
|
|
13
|
+
- **Preserve saved credit work results in identical text and structured host responses** (`createCreditWorkResult`)
|
|
14
|
+
|
|
15
|
+
## 0.22.0 — 2026-09-13
|
|
16
|
+
|
|
17
|
+
### Added
|
|
18
|
+
|
|
19
|
+
- **Display complete action-specific review terms and respect per-action approval availability** (`ActionReview`, `createActionWorkflowTools`)
|
|
20
|
+
|
|
9
21
|
## 0.21.0 — 2026-09-13
|
|
10
22
|
|
|
11
23
|
### Added
|
package/README.md
CHANGED
|
@@ -437,3 +437,27 @@ on the Change Date.
|
|
|
437
437
|
## Interactive MCP Apps
|
|
438
438
|
|
|
439
439
|
`createBillingApps()` adds reusable read-only credit, usage and receipt views with the official browser SDK. Apps capability negotiation, guarded resources and text fallbacks live in the package. See [MCP Apps](docs/mcp-apps.md) for integration, session migration, CSP restrictions and host validation boundaries.
|
|
440
|
+
|
|
441
|
+
### Saved credit-work results
|
|
442
|
+
|
|
443
|
+
Use `createCreditWorkResult(requestId, work)` for initial completion, duplicate
|
|
444
|
+
requests and read-only recovery. Pass the account-bound saved `budget`, `charged`,
|
|
445
|
+
`status` and `result`; extra database fields are not projected. Both MCP `content`
|
|
446
|
+
and `structuredContent` carry the same JSON envelope:
|
|
447
|
+
|
|
448
|
+
```json
|
|
449
|
+
{
|
|
450
|
+
"requestId": "proposal-1",
|
|
451
|
+
"status": "completed",
|
|
452
|
+
"maxCredits": 1,
|
|
453
|
+
"creditsCharged": 0,
|
|
454
|
+
"result": { "actionId": "action-1", "status": "proposed" }
|
|
455
|
+
}
|
|
456
|
+
```
|
|
457
|
+
|
|
458
|
+
Read the tool outcome under `result`; the outer `status` describes credit work,
|
|
459
|
+
not action approval or delivery. Saved JSON is decoded once; plain text remains
|
|
460
|
+
a string, and serialized MCP results remain nested without discarding content.
|
|
461
|
+
The formatter never retries work. A missing saved result carries a same-ID polling
|
|
462
|
+
instruction. Bind account identity and authorization before retrieving the saved
|
|
463
|
+
work; this helper does not authorize access or filter the tool's saved payload.
|
package/changelog.json
CHANGED
|
@@ -1,250 +1,277 @@
|
|
|
1
1
|
{
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
2
|
+
"contract": 1,
|
|
3
|
+
"name": "@absolutejs/mcp",
|
|
4
|
+
"releases": [
|
|
5
|
+
{
|
|
6
|
+
"changes": [
|
|
7
|
+
{
|
|
8
|
+
"kind": "added",
|
|
9
|
+
"summary": "Preserve saved credit work results in identical text and structured host responses",
|
|
10
|
+
"symbols": [
|
|
11
|
+
"createCreditWorkResult"
|
|
12
|
+
]
|
|
13
|
+
}
|
|
14
|
+
],
|
|
15
|
+
"date": "2026-09-13",
|
|
16
|
+
"version": "0.23.0"
|
|
17
|
+
},
|
|
18
|
+
{
|
|
19
|
+
"changes": [
|
|
20
|
+
{
|
|
21
|
+
"kind": "added",
|
|
22
|
+
"summary": "Display complete action-specific review terms and respect per-action approval availability",
|
|
23
|
+
"symbols": [
|
|
24
|
+
"ActionReview",
|
|
25
|
+
"createActionWorkflowTools"
|
|
26
|
+
]
|
|
27
|
+
}
|
|
28
|
+
],
|
|
29
|
+
"date": "2026-09-13",
|
|
30
|
+
"version": "0.22.0"
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
"changes": [
|
|
34
|
+
{
|
|
35
|
+
"kind": "added",
|
|
36
|
+
"summary": "Bind explicit prepaid budgets to action review and confirmation and display durable credit usage",
|
|
37
|
+
"symbols": [
|
|
38
|
+
"ActionReview",
|
|
39
|
+
"ActionConfirmation",
|
|
40
|
+
"ActionJob",
|
|
41
|
+
"createActionWorkflowTools"
|
|
42
|
+
]
|
|
43
|
+
}
|
|
44
|
+
],
|
|
45
|
+
"date": "2026-09-13",
|
|
46
|
+
"version": "0.21.0"
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
"changes": [
|
|
50
|
+
{
|
|
51
|
+
"kind": "fixed",
|
|
52
|
+
"summary": "Hide approval controls when an action review has no confirmation capability.",
|
|
53
|
+
"symbols": [
|
|
54
|
+
"ActionReview"
|
|
55
|
+
]
|
|
56
|
+
}
|
|
57
|
+
],
|
|
58
|
+
"date": "2026-09-13",
|
|
59
|
+
"version": "0.20.1"
|
|
60
|
+
},
|
|
61
|
+
{
|
|
62
|
+
"changes": [
|
|
63
|
+
{
|
|
64
|
+
"kind": "added",
|
|
65
|
+
"summary": "Add exact-version outbound review tools and rich durable job status with read-only recovery."
|
|
66
|
+
}
|
|
67
|
+
],
|
|
68
|
+
"date": "2026-09-13",
|
|
69
|
+
"version": "0.20.0"
|
|
70
|
+
},
|
|
71
|
+
{
|
|
72
|
+
"changes": [
|
|
73
|
+
{
|
|
74
|
+
"kind": "added",
|
|
75
|
+
"summary": "Add shared reviewed business selection tools and an MCP App with explicit revision-bound confirmation."
|
|
76
|
+
}
|
|
77
|
+
],
|
|
78
|
+
"date": "2026-09-13",
|
|
79
|
+
"version": "0.19.0"
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
"changes": [
|
|
83
|
+
{
|
|
84
|
+
"kind": "added",
|
|
85
|
+
"summary": "Add read-only setup and budget-preview tools with shared Apps and text fallbacks"
|
|
86
|
+
}
|
|
87
|
+
],
|
|
88
|
+
"date": "2026-09-13",
|
|
89
|
+
"version": "0.18.0"
|
|
90
|
+
},
|
|
91
|
+
{
|
|
92
|
+
"changes": [
|
|
93
|
+
{
|
|
94
|
+
"kind": "added",
|
|
95
|
+
"summary": "Document scoped individual Copilot paid-work eligibility and deployment budget requirements"
|
|
96
|
+
}
|
|
97
|
+
],
|
|
98
|
+
"date": "2026-09-12",
|
|
99
|
+
"version": "0.17.9"
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
"changes": [
|
|
103
|
+
{
|
|
104
|
+
"kind": "fixed",
|
|
105
|
+
"summary": "Correct the VS Code checkout canary after verifying native Windows link consent and document the individual Copilot channel review"
|
|
106
|
+
}
|
|
107
|
+
],
|
|
108
|
+
"date": "2026-09-12",
|
|
109
|
+
"version": "0.17.8"
|
|
110
|
+
},
|
|
111
|
+
{
|
|
112
|
+
"changes": [
|
|
113
|
+
{
|
|
114
|
+
"kind": "added",
|
|
115
|
+
"summary": "Ship a synthetic external-checkout host canary with expiring links, explicit approval and purchase-status checks"
|
|
116
|
+
}
|
|
117
|
+
],
|
|
118
|
+
"date": "2026-09-12",
|
|
119
|
+
"version": "0.17.7"
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
"changes": [
|
|
123
|
+
{
|
|
124
|
+
"kind": "fixed",
|
|
125
|
+
"summary": "Use text and structured report results on affected VS Code builds while their upstream webview startup race remains unresolved"
|
|
126
|
+
},
|
|
127
|
+
{
|
|
128
|
+
"kind": "added",
|
|
129
|
+
"summary": "Allow verified patched hosts through the version fallback with optional Apps configuration",
|
|
130
|
+
"symbols": [
|
|
131
|
+
"clientSupportsMcpApps",
|
|
132
|
+
"McpAppsConfig"
|
|
133
|
+
]
|
|
134
|
+
}
|
|
135
|
+
],
|
|
136
|
+
"date": "2026-09-11",
|
|
137
|
+
"version": "0.17.6"
|
|
138
|
+
},
|
|
139
|
+
{
|
|
140
|
+
"changes": [
|
|
141
|
+
{
|
|
142
|
+
"kind": "added",
|
|
143
|
+
"summary": "Distribute a verified VS Code webview startup-race source patch and actual-method regression checker, with explicit upstream delivery requirements"
|
|
144
|
+
}
|
|
145
|
+
],
|
|
146
|
+
"date": "2026-09-11",
|
|
147
|
+
"version": "0.17.5"
|
|
148
|
+
},
|
|
149
|
+
{
|
|
150
|
+
"changes": [
|
|
151
|
+
{
|
|
152
|
+
"kind": "added",
|
|
153
|
+
"summary": "Ship an authenticated two-account staging canary for read isolation, credential rejection and session reconnect with private credentials and aggregate-only results"
|
|
154
|
+
}
|
|
155
|
+
],
|
|
156
|
+
"date": "2026-09-11",
|
|
157
|
+
"version": "0.17.4"
|
|
158
|
+
},
|
|
159
|
+
{
|
|
160
|
+
"changes": [
|
|
161
|
+
{
|
|
162
|
+
"kind": "fixed",
|
|
163
|
+
"summary": "Authorize session deletion, recover explicit client initialization after expiry, and preserve typed HTTP failures without replaying tools"
|
|
164
|
+
},
|
|
165
|
+
{
|
|
166
|
+
"kind": "fixed",
|
|
167
|
+
"summary": "Accept the standard protocol-header compatibility fallback used by VS Code Copilot and record native report rendering evidence"
|
|
168
|
+
}
|
|
169
|
+
],
|
|
170
|
+
"date": "2026-09-11",
|
|
171
|
+
"version": "0.17.3"
|
|
172
|
+
},
|
|
173
|
+
{
|
|
174
|
+
"changes": [
|
|
175
|
+
{
|
|
176
|
+
"kind": "added",
|
|
177
|
+
"summary": "Record verified Claude web rendering, refresh, pagination and narrow-viewport host canary evidence"
|
|
178
|
+
}
|
|
179
|
+
],
|
|
180
|
+
"date": "2026-09-11",
|
|
181
|
+
"version": "0.17.2"
|
|
182
|
+
},
|
|
183
|
+
{
|
|
184
|
+
"changes": [
|
|
185
|
+
{
|
|
186
|
+
"kind": "added",
|
|
187
|
+
"summary": "Ship a preflight-validated synthetic host canary and record Claude Code and Codex terminal interoperability evidence"
|
|
188
|
+
}
|
|
189
|
+
],
|
|
190
|
+
"date": "2026-09-11",
|
|
191
|
+
"version": "0.17.1"
|
|
192
|
+
},
|
|
193
|
+
{
|
|
194
|
+
"changes": [
|
|
195
|
+
{
|
|
196
|
+
"kind": "added",
|
|
197
|
+
"summary": "Negotiate MCP Apps with persisted capabilities, guarded offline UI resources and reusable SDK-backed billing views"
|
|
198
|
+
},
|
|
199
|
+
{
|
|
200
|
+
"kind": "added",
|
|
201
|
+
"summary": "Preserve remote UI metadata in the client and expose immutable PostgreSQL migration entries"
|
|
202
|
+
},
|
|
203
|
+
{
|
|
204
|
+
"kind": "changed",
|
|
205
|
+
"summary": "Extend McpClientOptions, McpRemoteTool, createSessionRegistry, McpSessionStore, McpServerConfig, McpTool and McpToolResult with optional Apps capability and metadata fields; existing text-only callers remain supported",
|
|
206
|
+
"symbols": [
|
|
207
|
+
"McpClientOptions",
|
|
208
|
+
"McpRemoteTool",
|
|
209
|
+
"createSessionRegistry",
|
|
210
|
+
"McpSessionStore",
|
|
211
|
+
"McpServerConfig",
|
|
212
|
+
"McpTool",
|
|
213
|
+
"McpToolResult"
|
|
214
|
+
]
|
|
215
|
+
}
|
|
216
|
+
],
|
|
217
|
+
"date": "2026-09-11",
|
|
218
|
+
"version": "0.17.0"
|
|
219
|
+
},
|
|
220
|
+
{
|
|
221
|
+
"changes": [
|
|
222
|
+
{
|
|
223
|
+
"kind": "added",
|
|
224
|
+
"summary": "Add account-bound billing status, paginated receipts, bounded usage and reviewed billing-management links"
|
|
225
|
+
}
|
|
226
|
+
],
|
|
227
|
+
"date": "2026-09-11",
|
|
228
|
+
"version": "0.16.0"
|
|
229
|
+
},
|
|
230
|
+
{
|
|
231
|
+
"changes": [
|
|
232
|
+
{
|
|
233
|
+
"kind": "fixed",
|
|
234
|
+
"summary": "Build and test before publishing so checkout exports are present in the distributed artifact"
|
|
235
|
+
}
|
|
236
|
+
],
|
|
237
|
+
"date": "2026-09-11",
|
|
238
|
+
"version": "0.15.1"
|
|
239
|
+
},
|
|
240
|
+
{
|
|
241
|
+
"changes": [
|
|
242
|
+
{
|
|
243
|
+
"kind": "added",
|
|
244
|
+
"summary": "Add commerce-classified account-bound checkout handoff and purchase status tools"
|
|
245
|
+
}
|
|
246
|
+
],
|
|
247
|
+
"date": "2026-09-11",
|
|
248
|
+
"version": "0.15.0"
|
|
249
|
+
},
|
|
250
|
+
{
|
|
251
|
+
"changes": [
|
|
252
|
+
{
|
|
253
|
+
"kind": "added",
|
|
254
|
+
"summary": "Add explicit credit-budget envelopes for durable prepaid MCP work"
|
|
255
|
+
}
|
|
256
|
+
],
|
|
257
|
+
"date": "2026-09-11",
|
|
258
|
+
"version": "0.14.0"
|
|
259
|
+
},
|
|
260
|
+
{
|
|
261
|
+
"changes": [
|
|
262
|
+
{
|
|
263
|
+
"kind": "added",
|
|
264
|
+
"summary": "Add reviewed host commerce eligibility, execution guards, and reusable credit status tools",
|
|
265
|
+
"symbols": [
|
|
266
|
+
"McpServerConfig",
|
|
267
|
+
"McpTool",
|
|
268
|
+
"evaluateCommerce",
|
|
269
|
+
"createCreditBalanceTool"
|
|
270
|
+
]
|
|
271
|
+
}
|
|
272
|
+
],
|
|
273
|
+
"date": "2026-09-11",
|
|
274
|
+
"version": "0.13.0"
|
|
275
|
+
}
|
|
276
|
+
]
|
|
250
277
|
}
|