@mcp-b/webmcp-types 2.3.0 → 2.3.1-beta.20260528050333
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/README.md +10 -7
- package/dist/index.d.ts +20 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/model-context.d.ts +28 -32
- package/dist/model-context.d.ts.map +1 -1
- package/dist/tool.d.ts +4 -0
- package/dist/tool.d.ts.map +1 -1
- package/package.json +6 -5
- package/src/index.ts +21 -5
- package/src/model-context.ts +35 -42
- package/src/tool.ts +5 -0
- package/dist/standard-schema.d.ts +0 -32
- package/dist/standard-schema.d.ts.map +0 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @mcp-b/webmcp-types
|
|
2
2
|
|
|
3
|
-
Strict TypeScript type definitions for the WebMCP core API (`
|
|
3
|
+
Strict TypeScript type definitions for the WebMCP core API (`document.modelContext`).
|
|
4
4
|
|
|
5
5
|
Zero runtime. Zero side effects. Just `.d.ts` types.
|
|
6
6
|
|
|
@@ -15,7 +15,8 @@ This package is the type-safety source of truth for WebMCP.
|
|
|
15
15
|
|
|
16
16
|
## Why This Package
|
|
17
17
|
|
|
18
|
-
- Global `
|
|
18
|
+
- Global `Document` augmentation for `document.modelContext`
|
|
19
|
+
- Deprecated global `Navigator` augmentation for backward-compatible `navigator.modelContext`
|
|
19
20
|
- Strongly typed tool descriptors and tool responses
|
|
20
21
|
- Literal JSON Schema inference for tool args and `structuredContent`
|
|
21
22
|
- Name-aware helper types for typed tool registries
|
|
@@ -90,7 +91,7 @@ const outputSchema = {
|
|
|
90
91
|
additionalProperties: false,
|
|
91
92
|
} as const satisfies JsonSchemaForInference;
|
|
92
93
|
|
|
93
|
-
|
|
94
|
+
document.modelContext.registerTool({
|
|
94
95
|
name: 'search',
|
|
95
96
|
description: 'Search indexed docs',
|
|
96
97
|
inputSchema,
|
|
@@ -188,14 +189,15 @@ await modelContext.callTool({ name: 'ping' });
|
|
|
188
189
|
|
|
189
190
|
## Core and Extension Surfaces
|
|
190
191
|
|
|
191
|
-
`
|
|
192
|
+
`Document['modelContext']` is typed as strict core WebMCP methods only.
|
|
193
|
+
`Navigator['modelContext']` remains typed as a deprecated backward-compatible alias.
|
|
192
194
|
|
|
193
195
|
Extension methods are available via `ModelContextExtensions` and `ModelContextWithExtensions`:
|
|
194
196
|
|
|
195
197
|
```ts
|
|
196
198
|
import type { ModelContextExtensions } from '@mcp-b/webmcp-types';
|
|
197
199
|
|
|
198
|
-
const modelContext =
|
|
200
|
+
const modelContext = document.modelContext as Document['modelContext'] & ModelContextExtensions;
|
|
199
201
|
const tools = modelContext.listTools();
|
|
200
202
|
const result = await modelContext.callTool({
|
|
201
203
|
name: 'search',
|
|
@@ -210,7 +212,7 @@ void result;
|
|
|
210
212
|
|
|
211
213
|
| Export | Purpose |
|
|
212
214
|
| ------------------------------------ | ------------------------------------------------------------ |
|
|
213
|
-
| `ModelContext` | Strict core `
|
|
215
|
+
| `ModelContext` | Strict core `document.modelContext` type |
|
|
214
216
|
| `ToolDescriptor` | Explicitly typed tool descriptor |
|
|
215
217
|
| `ToolDescriptorFromSchema` | Schema-driven descriptor with inferred args/result |
|
|
216
218
|
| `JsonSchemaForInference` | Supported JSON Schema subset for inference |
|
|
@@ -225,7 +227,8 @@ void result;
|
|
|
225
227
|
|
|
226
228
|
- This package does not install any runtime behavior.
|
|
227
229
|
- Runtime validation/execution behavior depends on your WebMCP runtime package.
|
|
228
|
-
- `
|
|
230
|
+
- Prefer `document.modelContext` for new code. `navigator.modelContext` is retained as a deprecated backward-compatible alias during the WebMCP migration.
|
|
231
|
+
- `provideContext()` and `clearContext()` were removed from the upstream WebMCP spec on March 5, 2026 and are intentionally not typed.
|
|
229
232
|
- `unregisterTool(name)` is `@deprecated`. The April 23, 2026 WebMCP draft removed it from the spec in favor of an `AbortSignal` passed via `registerTool(tool, { signal })`. The type is retained for compatibility with older native previews and existing MCP-B wrappers; it will be removed in the next major version.
|
|
230
233
|
- `registerTool(tool, options?)` accepts a `ModelContextRegisterToolOptions` dictionary with an optional `signal: AbortSignal`. Aborting the signal unregisters the tool.
|
|
231
234
|
- `ToolAnnotations.untrustedContentHint` was added to the spec on April 23, 2026 to flag tools whose output may include externally-sourced content.
|
package/dist/index.d.ts
CHANGED
|
@@ -1,18 +1,34 @@
|
|
|
1
1
|
import type { ModelContext, ModelContextTesting } from './model-context.js';
|
|
2
2
|
export type { AudioContent, BlobResourceContents, CallToolResult, ContentBlock, ElicitationFormParams, ElicitationParams, ElicitationResult, ElicitationUrlParams, EmbeddedResource, ImageContent, InputSchema, InputSchemaProperty, JsonObject, JsonPrimitive, JsonValue, LooseContentBlock, RegistrationHandle, ResourceContents, ResourceLink, TextContent, TextResourceContents, ToolResponse, } from './common.js';
|
|
3
3
|
export type { InferArgsFromInputSchema, InferJsonSchema, JsonSchemaArray, JsonSchemaBoolean, JsonSchemaEnumValue, JsonSchemaForInference, JsonSchemaMultiType, JsonSchemaNull, JsonSchemaNumber, JsonSchemaObject, JsonSchemaPrimitiveType, JsonSchemaString, JsonSchemaType, JsonSchemaTypeArray, } from './json-schema.js';
|
|
4
|
-
export type { AnyToolDescriptor, InferToolArgs, InferToolResult, ModelContext, ModelContextCore, ModelContextExtensions,
|
|
4
|
+
export type { AnyToolDescriptor, InferToolArgs, InferToolResult, ModelContext, ModelContextCore, ModelContextExtensions, ModelContextRegisterToolOptions, ModelContextTesting, ModelContextTestingExecuteToolOptions, ModelContextTestingPolyfillExtensions, ModelContextTestingToolInfo, ModelContextToolInfo, ModelContextToolReference, ModelContextToolRegistrationHandle, ModelContextWithExtensions, ToolArgsByName, ToolByName, ToolCallEvent, ToolCallParams, ToolName, ToolResultByName, TypedModelContext, } from './model-context.js';
|
|
5
5
|
export type { MaybePromise, ModelContextClient, ToolAnnotations, ToolDescriptor, ToolDescriptorFromSchema, ToolExecuteResult, ToolExecutionContext, ToolListItem, ToolRawResult, ToolResultFromOutputSchema, } from './tool.js';
|
|
6
6
|
declare global {
|
|
7
|
+
interface Document {
|
|
8
|
+
/**
|
|
9
|
+
* Web Model Context API strict core surface.
|
|
10
|
+
*
|
|
11
|
+
* Per WebMCP spec PR webmachinelearning/webmcp#184, each Document owns its
|
|
12
|
+
* associated ModelContext. This is the canonical install location as of
|
|
13
|
+
* Chrome 150. Prefer `document.modelContext` for new code.
|
|
14
|
+
*/
|
|
15
|
+
readonly modelContext: ModelContext;
|
|
16
|
+
}
|
|
7
17
|
interface Navigator {
|
|
8
18
|
/**
|
|
9
19
|
* Web Model Context API strict core surface.
|
|
20
|
+
*
|
|
21
|
+
* @deprecated The modelContext getter moved from Navigator to Document in
|
|
22
|
+
* Chrome 150 (see webmachinelearning/webmcp#173 / PR #184). Use
|
|
23
|
+
* `document.modelContext` instead. `navigator.modelContext` is kept as a
|
|
24
|
+
* backward-compatible alias and will be removed in a future Chrome release.
|
|
10
25
|
*/
|
|
11
|
-
modelContext: ModelContext;
|
|
26
|
+
readonly modelContext: ModelContext;
|
|
12
27
|
/**
|
|
13
28
|
* Web Model Context testing API surface (Chromium early preview).
|
|
14
|
-
* @deprecated
|
|
15
|
-
*
|
|
29
|
+
* @deprecated Chromium still exposes this API for testing flows. Producer
|
|
30
|
+
* discovery/execution should prefer document.modelContext.getTools() and
|
|
31
|
+
* document.modelContext.executeTool(...).
|
|
16
32
|
*/
|
|
17
33
|
modelContextTesting?: ModelContextTesting;
|
|
18
34
|
}
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG5E,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG5E,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,+BAA+B,EAC/B,mBAAmB,EACnB,qCAAqC,EACrC,qCAAqC,EACrC,2BAA2B,EAC3B,oBAAoB,EACpB,yBAAyB,EACzB,kCAAkC,EAClC,0BAA0B,EAC1B,cAAc,EACd,UAAU,EACV,aAAa,EACb,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,0BAA0B,GAC3B,MAAM,WAAW,CAAC;AAMnB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,QAAQ;QAChB;;;;;;WAMG;QACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;KACrC;IAED,UAAU,SAAS;QACjB;;;;;;;WAOG;QACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;QAEpC;;;;;WAKG;QACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;KAC3C;CACF"}
|
package/dist/model-context.d.ts
CHANGED
|
@@ -1,19 +1,6 @@
|
|
|
1
1
|
import type { InputSchema, ToolResponse } from './common.js';
|
|
2
2
|
import type { JsonSchemaForInference } from './json-schema.js';
|
|
3
3
|
import type { ToolDescriptor, ToolDescriptorFromSchema, ToolListItem, ToolRawResult } from './tool.js';
|
|
4
|
-
/**
|
|
5
|
-
* Context provided to models via provideContext().
|
|
6
|
-
*/
|
|
7
|
-
export interface ModelContextInput<TTools extends readonly ToolDescriptor[] = ToolDescriptor[]> {
|
|
8
|
-
/**
|
|
9
|
-
* Base tool descriptors to expose.
|
|
10
|
-
*/
|
|
11
|
-
tools?: TTools;
|
|
12
|
-
}
|
|
13
|
-
/**
|
|
14
|
-
* Public options accepted by provideContext().
|
|
15
|
-
*/
|
|
16
|
-
export type ModelContextOptions = ModelContextInput;
|
|
17
4
|
/**
|
|
18
5
|
* Tool info returned by ModelContextTesting.listTools().
|
|
19
6
|
*/
|
|
@@ -22,6 +9,14 @@ export interface ModelContextTestingToolInfo {
|
|
|
22
9
|
description: string;
|
|
23
10
|
inputSchema?: string;
|
|
24
11
|
}
|
|
12
|
+
/**
|
|
13
|
+
* Tool info returned by Chromium's producer-facing ModelContext.getTools().
|
|
14
|
+
*/
|
|
15
|
+
export interface ModelContextToolInfo extends ModelContextTestingToolInfo {
|
|
16
|
+
title: string;
|
|
17
|
+
origin: string;
|
|
18
|
+
window: Window;
|
|
19
|
+
}
|
|
25
20
|
/**
|
|
26
21
|
* Options supported by ModelContextTesting.executeTool().
|
|
27
22
|
*/
|
|
@@ -159,16 +154,15 @@ export interface ModelContextRegisterToolOptions {
|
|
|
159
154
|
* An `AbortSignal` whose abortion unregisters the tool. A pre-aborted signal short-circuits registration.
|
|
160
155
|
*/
|
|
161
156
|
signal?: AbortSignal;
|
|
157
|
+
/**
|
|
158
|
+
* Origins that can observe this tool from other documents in the same tree.
|
|
159
|
+
*/
|
|
160
|
+
exposedTo?: string[];
|
|
162
161
|
}
|
|
163
162
|
/**
|
|
164
|
-
* Strict WebMCP core interface on
|
|
163
|
+
* Strict WebMCP core interface on document.modelContext.
|
|
165
164
|
*/
|
|
166
165
|
export interface ModelContextCore {
|
|
167
|
-
/**
|
|
168
|
-
* Replaces base context with provided tools.
|
|
169
|
-
* @deprecated Removed from the upstream WebMCP spec on March 5, 2026. Kept only as a temporary compatibility API.
|
|
170
|
-
*/
|
|
171
|
-
provideContext(options?: ModelContextOptions): void;
|
|
172
166
|
/**
|
|
173
167
|
* Registers a dynamic tool with JSON Schema-driven inference.
|
|
174
168
|
*
|
|
@@ -194,7 +188,14 @@ export interface ModelContextCore {
|
|
|
194
188
|
* shape. Current Chromium returns JSON-stringified schemas here, matching
|
|
195
189
|
* ModelContextTesting.listTools().
|
|
196
190
|
*/
|
|
197
|
-
getTools():
|
|
191
|
+
getTools(): Promise<ModelContextToolInfo[]>;
|
|
192
|
+
/**
|
|
193
|
+
* Executes a registered tool object returned from getTools().
|
|
194
|
+
*
|
|
195
|
+
* This mirrors Chromium's current producer-facing preview API. The testing API
|
|
196
|
+
* still executes by `(toolName, inputArgsJson)`.
|
|
197
|
+
*/
|
|
198
|
+
executeTool(tool: ModelContextToolInfo, inputArgsJson: string, options?: ModelContextTestingExecuteToolOptions): Promise<string | null>;
|
|
198
199
|
/**
|
|
199
200
|
* Handler invoked when the producer tool list changes.
|
|
200
201
|
*/
|
|
@@ -202,23 +203,18 @@ export interface ModelContextCore {
|
|
|
202
203
|
addEventListener(type: 'toolchange', listener: () => void, options?: boolean | AddEventListenerOptions): void;
|
|
203
204
|
removeEventListener(type: 'toolchange', listener: () => void, options?: boolean | EventListenerOptions): void;
|
|
204
205
|
dispatchEvent(event: Event): boolean;
|
|
205
|
-
/**
|
|
206
|
-
* Unregisters a dynamic tool by name or tool reference.
|
|
207
|
-
*
|
|
208
|
-
* @deprecated Removed from the WebMCP spec on April 23, 2026. Use `registerTool(tool, { signal })`. Will be removed in the next major.
|
|
209
|
-
*/
|
|
210
|
-
unregisterTool(nameOrTool: string | ModelContextToolReference): void;
|
|
211
|
-
/**
|
|
212
|
-
* Clears all context (base + dynamic registrations).
|
|
213
|
-
* @deprecated Removed from the upstream WebMCP spec on March 5, 2026. Kept only as a temporary compatibility API.
|
|
214
|
-
*/
|
|
215
|
-
clearContext(): void;
|
|
216
206
|
}
|
|
217
207
|
/**
|
|
218
208
|
* MCPB extension surface layered on top of strict WebMCP core.
|
|
219
209
|
* These members are intentionally non-standard.
|
|
220
210
|
*/
|
|
221
211
|
export interface ModelContextExtensions {
|
|
212
|
+
/**
|
|
213
|
+
* Unregisters a dynamic tool by name or tool reference.
|
|
214
|
+
*
|
|
215
|
+
* @deprecated Removed from the WebMCP spec on April 23, 2026. Use `registerTool(tool, { signal })`. Will be removed in the next major.
|
|
216
|
+
*/
|
|
217
|
+
unregisterTool(nameOrTool: string | ModelContextToolReference): void;
|
|
222
218
|
/**
|
|
223
219
|
* Lists currently registered tools.
|
|
224
220
|
*/
|
|
@@ -260,7 +256,7 @@ export interface ModelContextExtensions {
|
|
|
260
256
|
dispatchEvent(event: Event): boolean;
|
|
261
257
|
}
|
|
262
258
|
/**
|
|
263
|
-
* Public
|
|
259
|
+
* Public document.modelContext type (strict core only).
|
|
264
260
|
*/
|
|
265
261
|
export type ModelContext = ModelContextCore;
|
|
266
262
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"model-context.d.ts","sourceRoot":"","sources":["../src/model-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,YAAY,EACZ,aAAa,EACd,MAAM,WAAW,CAAC;AAMnB;;GAEG;AACH,MAAM,WAAW,
|
|
1
|
+
{"version":3,"file":"model-context.d.ts","sourceRoot":"","sources":["../src/model-context.ts"],"names":[],"mappings":"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"}
|
package/dist/tool.d.ts
CHANGED
|
@@ -82,6 +82,10 @@ export interface ToolDescriptor<TArgs extends Record<string, unknown> = Record<s
|
|
|
82
82
|
* Unique tool identifier.
|
|
83
83
|
*/
|
|
84
84
|
name: TName;
|
|
85
|
+
/**
|
|
86
|
+
* Optional user-facing label.
|
|
87
|
+
*/
|
|
88
|
+
title?: string;
|
|
85
89
|
/**
|
|
86
90
|
* Human-readable summary of what the tool does.
|
|
87
91
|
*/
|
package/dist/tool.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mcp-b/webmcp-types",
|
|
3
|
-
"version": "2.3.
|
|
4
|
-
"description": "Strict TypeScript type definitions for the WebMCP core API (
|
|
3
|
+
"version": "2.3.1-beta.20260528050333",
|
|
4
|
+
"description": "Strict TypeScript type definitions for the WebMCP core API (document.modelContext)",
|
|
5
5
|
"keywords": [
|
|
6
|
+
"document-modelcontext",
|
|
6
7
|
"model-context",
|
|
7
8
|
"navigator-modelcontext",
|
|
8
9
|
"types",
|
|
@@ -43,10 +44,10 @@
|
|
|
43
44
|
"registry": "https://registry.npmjs.org/"
|
|
44
45
|
},
|
|
45
46
|
"devDependencies": {
|
|
46
|
-
"@vitest/coverage-v8": "^4.1.
|
|
47
|
-
"playwright": "^1.
|
|
47
|
+
"@vitest/coverage-v8": "^4.1.7",
|
|
48
|
+
"playwright": "^1.60.0",
|
|
48
49
|
"typescript": "^5.8.3",
|
|
49
|
-
"vite-plus": "
|
|
50
|
+
"vite-plus": "^0.1.22",
|
|
50
51
|
"vitest": "npm:@voidzero-dev/vite-plus-test@latest"
|
|
51
52
|
},
|
|
52
53
|
"scripts": {
|
package/src/index.ts
CHANGED
|
@@ -48,13 +48,12 @@ export type {
|
|
|
48
48
|
ModelContext,
|
|
49
49
|
ModelContextCore,
|
|
50
50
|
ModelContextExtensions,
|
|
51
|
-
ModelContextInput,
|
|
52
|
-
ModelContextOptions,
|
|
53
51
|
ModelContextRegisterToolOptions,
|
|
54
52
|
ModelContextTesting,
|
|
55
53
|
ModelContextTestingExecuteToolOptions,
|
|
56
54
|
ModelContextTestingPolyfillExtensions,
|
|
57
55
|
ModelContextTestingToolInfo,
|
|
56
|
+
ModelContextToolInfo,
|
|
58
57
|
ModelContextToolReference,
|
|
59
58
|
ModelContextToolRegistrationHandle,
|
|
60
59
|
ModelContextWithExtensions,
|
|
@@ -84,16 +83,33 @@ export type {
|
|
|
84
83
|
// ============================================================================
|
|
85
84
|
|
|
86
85
|
declare global {
|
|
86
|
+
interface Document {
|
|
87
|
+
/**
|
|
88
|
+
* Web Model Context API strict core surface.
|
|
89
|
+
*
|
|
90
|
+
* Per WebMCP spec PR webmachinelearning/webmcp#184, each Document owns its
|
|
91
|
+
* associated ModelContext. This is the canonical install location as of
|
|
92
|
+
* Chrome 150. Prefer `document.modelContext` for new code.
|
|
93
|
+
*/
|
|
94
|
+
readonly modelContext: ModelContext;
|
|
95
|
+
}
|
|
96
|
+
|
|
87
97
|
interface Navigator {
|
|
88
98
|
/**
|
|
89
99
|
* Web Model Context API strict core surface.
|
|
100
|
+
*
|
|
101
|
+
* @deprecated The modelContext getter moved from Navigator to Document in
|
|
102
|
+
* Chrome 150 (see webmachinelearning/webmcp#173 / PR #184). Use
|
|
103
|
+
* `document.modelContext` instead. `navigator.modelContext` is kept as a
|
|
104
|
+
* backward-compatible alias and will be removed in a future Chrome release.
|
|
90
105
|
*/
|
|
91
|
-
modelContext: ModelContext;
|
|
106
|
+
readonly modelContext: ModelContext;
|
|
92
107
|
|
|
93
108
|
/**
|
|
94
109
|
* Web Model Context testing API surface (Chromium early preview).
|
|
95
|
-
* @deprecated
|
|
96
|
-
*
|
|
110
|
+
* @deprecated Chromium still exposes this API for testing flows. Producer
|
|
111
|
+
* discovery/execution should prefer document.modelContext.getTools() and
|
|
112
|
+
* document.modelContext.executeTool(...).
|
|
97
113
|
*/
|
|
98
114
|
modelContextTesting?: ModelContextTesting;
|
|
99
115
|
}
|
package/src/model-context.ts
CHANGED
|
@@ -7,25 +7,6 @@ import type {
|
|
|
7
7
|
ToolRawResult,
|
|
8
8
|
} from './tool.js';
|
|
9
9
|
|
|
10
|
-
// ============================================================================
|
|
11
|
-
// Model Context Input
|
|
12
|
-
// ============================================================================
|
|
13
|
-
|
|
14
|
-
/**
|
|
15
|
-
* Context provided to models via provideContext().
|
|
16
|
-
*/
|
|
17
|
-
export interface ModelContextInput<TTools extends readonly ToolDescriptor[] = ToolDescriptor[]> {
|
|
18
|
-
/**
|
|
19
|
-
* Base tool descriptors to expose.
|
|
20
|
-
*/
|
|
21
|
-
tools?: TTools;
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
/**
|
|
25
|
-
* Public options accepted by provideContext().
|
|
26
|
-
*/
|
|
27
|
-
export type ModelContextOptions = ModelContextInput;
|
|
28
|
-
|
|
29
10
|
// ============================================================================
|
|
30
11
|
// Model Context Testing
|
|
31
12
|
// ============================================================================
|
|
@@ -39,6 +20,15 @@ export interface ModelContextTestingToolInfo {
|
|
|
39
20
|
inputSchema?: string;
|
|
40
21
|
}
|
|
41
22
|
|
|
23
|
+
/**
|
|
24
|
+
* Tool info returned by Chromium's producer-facing ModelContext.getTools().
|
|
25
|
+
*/
|
|
26
|
+
export interface ModelContextToolInfo extends ModelContextTestingToolInfo {
|
|
27
|
+
title: string;
|
|
28
|
+
origin: string;
|
|
29
|
+
window: Window;
|
|
30
|
+
}
|
|
31
|
+
|
|
42
32
|
/**
|
|
43
33
|
* Options supported by ModelContextTesting.executeTool().
|
|
44
34
|
*/
|
|
@@ -204,6 +194,11 @@ export interface ModelContextRegisterToolOptions {
|
|
|
204
194
|
* An `AbortSignal` whose abortion unregisters the tool. A pre-aborted signal short-circuits registration.
|
|
205
195
|
*/
|
|
206
196
|
signal?: AbortSignal;
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* Origins that can observe this tool from other documents in the same tree.
|
|
200
|
+
*/
|
|
201
|
+
exposedTo?: string[];
|
|
207
202
|
}
|
|
208
203
|
|
|
209
204
|
// ============================================================================
|
|
@@ -211,17 +206,9 @@ export interface ModelContextRegisterToolOptions {
|
|
|
211
206
|
// ============================================================================
|
|
212
207
|
|
|
213
208
|
/**
|
|
214
|
-
* Strict WebMCP core interface on
|
|
209
|
+
* Strict WebMCP core interface on document.modelContext.
|
|
215
210
|
*/
|
|
216
211
|
export interface ModelContextCore {
|
|
217
|
-
// ==================== CONTEXT ====================
|
|
218
|
-
|
|
219
|
-
/**
|
|
220
|
-
* Replaces base context with provided tools.
|
|
221
|
-
* @deprecated Removed from the upstream WebMCP spec on March 5, 2026. Kept only as a temporary compatibility API.
|
|
222
|
-
*/
|
|
223
|
-
provideContext(options?: ModelContextOptions): void;
|
|
224
|
-
|
|
225
212
|
// ==================== TOOLS ====================
|
|
226
213
|
|
|
227
214
|
/**
|
|
@@ -276,7 +263,19 @@ export interface ModelContextCore {
|
|
|
276
263
|
* shape. Current Chromium returns JSON-stringified schemas here, matching
|
|
277
264
|
* ModelContextTesting.listTools().
|
|
278
265
|
*/
|
|
279
|
-
getTools():
|
|
266
|
+
getTools(): Promise<ModelContextToolInfo[]>;
|
|
267
|
+
|
|
268
|
+
/**
|
|
269
|
+
* Executes a registered tool object returned from getTools().
|
|
270
|
+
*
|
|
271
|
+
* This mirrors Chromium's current producer-facing preview API. The testing API
|
|
272
|
+
* still executes by `(toolName, inputArgsJson)`.
|
|
273
|
+
*/
|
|
274
|
+
executeTool(
|
|
275
|
+
tool: ModelContextToolInfo,
|
|
276
|
+
inputArgsJson: string,
|
|
277
|
+
options?: ModelContextTestingExecuteToolOptions
|
|
278
|
+
): Promise<string | null>;
|
|
280
279
|
|
|
281
280
|
/**
|
|
282
281
|
* Handler invoked when the producer tool list changes.
|
|
@@ -296,7 +295,13 @@ export interface ModelContextCore {
|
|
|
296
295
|
): void;
|
|
297
296
|
|
|
298
297
|
dispatchEvent(event: Event): boolean;
|
|
298
|
+
}
|
|
299
299
|
|
|
300
|
+
/**
|
|
301
|
+
* MCPB extension surface layered on top of strict WebMCP core.
|
|
302
|
+
* These members are intentionally non-standard.
|
|
303
|
+
*/
|
|
304
|
+
export interface ModelContextExtensions {
|
|
300
305
|
/**
|
|
301
306
|
* Unregisters a dynamic tool by name or tool reference.
|
|
302
307
|
*
|
|
@@ -304,18 +309,6 @@ export interface ModelContextCore {
|
|
|
304
309
|
*/
|
|
305
310
|
unregisterTool(nameOrTool: string | ModelContextToolReference): void;
|
|
306
311
|
|
|
307
|
-
/**
|
|
308
|
-
* Clears all context (base + dynamic registrations).
|
|
309
|
-
* @deprecated Removed from the upstream WebMCP spec on March 5, 2026. Kept only as a temporary compatibility API.
|
|
310
|
-
*/
|
|
311
|
-
clearContext(): void;
|
|
312
|
-
}
|
|
313
|
-
|
|
314
|
-
/**
|
|
315
|
-
* MCPB extension surface layered on top of strict WebMCP core.
|
|
316
|
-
* These members are intentionally non-standard.
|
|
317
|
-
*/
|
|
318
|
-
export interface ModelContextExtensions {
|
|
319
312
|
/**
|
|
320
313
|
* Lists currently registered tools.
|
|
321
314
|
*/
|
|
@@ -395,7 +388,7 @@ export interface ModelContextExtensions {
|
|
|
395
388
|
}
|
|
396
389
|
|
|
397
390
|
/**
|
|
398
|
-
* Public
|
|
391
|
+
* Public document.modelContext type (strict core only).
|
|
399
392
|
*/
|
|
400
393
|
export type ModelContext = ModelContextCore;
|
|
401
394
|
|
package/src/tool.ts
CHANGED
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
import type { StandardJSONSchemaV1 as BaseStandardJSONSchemaV1, StandardSchemaV1 as BaseStandardSchemaV1, StandardTypedV1 } from '@standard-schema/spec';
|
|
2
|
-
import type { InputSchema } from './common.js';
|
|
3
|
-
/**
|
|
4
|
-
* Re-export of the official Standard Schema spec types.
|
|
5
|
-
*/
|
|
6
|
-
export type { BaseStandardJSONSchemaV1 as StandardJSONSchemaV1, BaseStandardSchemaV1 as StandardSchemaV1, StandardTypedV1, };
|
|
7
|
-
/**
|
|
8
|
-
* Standard Schema validator constrained to object-like tool args.
|
|
9
|
-
*/
|
|
10
|
-
export type StandardInputValidatorSchema = BaseStandardSchemaV1<Record<string, unknown>, Record<string, unknown>>;
|
|
11
|
-
/**
|
|
12
|
-
* Standard JSON Schema converter constrained to object-like tool args.
|
|
13
|
-
*/
|
|
14
|
-
export type StandardInputJsonSchema = BaseStandardJSONSchemaV1<Record<string, unknown>, Record<string, unknown>>;
|
|
15
|
-
/**
|
|
16
|
-
* Schema that supports both Standard Schema validation and JSON Schema conversion.
|
|
17
|
-
*/
|
|
18
|
-
export type StandardInputSchemaWithJson = StandardInputValidatorSchema & StandardInputJsonSchema;
|
|
19
|
-
/**
|
|
20
|
-
* Any input schema accepted by tool descriptors.
|
|
21
|
-
*
|
|
22
|
-
* Runtime adapters may normalize all inputs to a Standard Schema validator.
|
|
23
|
-
* When a schema implements both Standard Schema validation and Standard JSON
|
|
24
|
-
* Schema conversion, adapters may prefer JSON conversion to keep validation
|
|
25
|
-
* errors consistent across plain JSON Schema and Standard-compatible inputs.
|
|
26
|
-
*/
|
|
27
|
-
export type ToolInputSchema = InputSchema | StandardInputValidatorSchema | StandardInputJsonSchema;
|
|
28
|
-
/**
|
|
29
|
-
* Any output schema accepted by tool descriptors.
|
|
30
|
-
*/
|
|
31
|
-
export type ToolOutputSchema = InputSchema | StandardInputJsonSchema;
|
|
32
|
-
//# sourceMappingURL=standard-schema.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../src/standard-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,IAAI,wBAAwB,EAChD,gBAAgB,IAAI,oBAAoB,EACxC,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,YAAY,EACV,wBAAwB,IAAI,oBAAoB,EAChD,oBAAoB,IAAI,gBAAgB,EACxC,eAAe,GAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAC7D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,wBAAwB,CAC5D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,4BAA4B,GAAG,uBAAuB,CAAC;AAEjG;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,4BAA4B,GAAG,uBAAuB,CAAC;AAEnG;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,uBAAuB,CAAC"}
|