@mcp-b/webmcp-types 5.1.0 → 6.0.0-beta.20261001010549

package/README.md

@@ -1,127 +1,49 @@
 # @mcp-b/webmcp-types
 
-TypeScript contracts for the current WebMCP API on `document.modelContext`. This package emits declarations only and has no runtime side effects.
+This package is a compatibility alias for the upstream
+[`webmcp-types`](https://github.com/webmachinelearning/webmcp-types) package.
+It forwards upstream type exports and browser declarations directly.
 
-The [WebMCP draft](https://webmachinelearning.github.io/webmcp/) is authoritative for the browser API. MCP-B extension types are kept separate from that standard surface.
+**This package will eventually be removed. Please use `webmcp-types` directly.**
+There is no removal date yet.
 
-## Install
+## Migrate to upstream
 
 ```bash
-pnpm add -D @mcp-b/webmcp-types
+pnpm remove @mcp-b/webmcp-types
+pnpm add -D webmcp-types@0.1.9
 ```
 
-Use a production dependency when your published declarations reference these types.
-
-## Activate the browser globals
-
-Choose one activation method:
-
-```json
-{
-  "compilerOptions": {
-    "types": ["@mcp-b/webmcp-types"]
-  }
-}
-```
+Change the import to the upstream package:
 
 ```ts
-/// <reference types="@mcp-b/webmcp-types" />
-```
+import type { WebMCP } from 'webmcp-types';
 
-```ts
-import type {} from '@mcp-b/webmcp-types';
+const context: WebMCP.ModelContext | undefined = document.modelContext;
 ```
 
-Activation adds the canonical `document.modelContext` type and the optional deprecated navigator compatibility surfaces.
-
-## Register a standard tool
+Also replace `@mcp-b/webmcp-types` with `webmcp-types` in TypeScript `types`
+configuration and triple-slash references, if used. Published libraries whose
+declarations reference these types should declare `webmcp-types` as a production
+dependency.
 
-```ts
-import type { JsonSchemaForInference } from '@mcp-b/webmcp-types';
-
-const inputSchema = {
-  type: 'object',
-  properties: {
-    query: { type: 'string' },
-    limit: { type: 'integer', minimum: 1 },
-  },
-  required: ['query'],
-  additionalProperties: false,
-} as const satisfies JsonSchemaForInference;
-
-const controller = new AbortController();
+## Compatibility
 
-await document.modelContext.registerTool(
-  {
-    name: 'search',
-    description: 'Search indexed docs',
-    inputSchema,
-    execute: ({ query, limit }) => ({ query, limit }),
-  },
-  { signal: controller.signal }
-);
+The alias exports the same `WebMCP` namespace as upstream. Existing consumers can
+use it while migrating:
 
-controller.abort();
+```ts
+import type { WebMCP } from '@mcp-b/webmcp-types';
 ```
 
-The callback input is `{ query: string; limit?: number }`. `registerTool()` returns `Promise<void>`; aborting the registration signal removes the tool.
-
-## Type surfaces
-
-| Type                         | Contract                                                         |
-| ---------------------------- | ---------------------------------------------------------------- |
-| `ModelContext`               | Current standard `document.modelContext` producer API            |
-| `ChromeModelContext`         | Standard API plus feature-detectable Chromium `executeTool()`    |
-| `ModelContextExtensions`     | MCP-B registration and `listTools()` extensions                  |
-| `ModelContextWithExtensions` | Standard event/discovery shape with MCP-B registration overloads |
-| `ModelContextTesting`        | Deprecated optional testing compatibility surface                |
-
-Both tool descriptor callbacks receive one input argument. MCP-B `ToolDescriptor` may also declare `outputSchema`.
-
-## Schema inference
-
-`JsonSchemaForInference` is the JSON Schema type owned by `@modelcontextprotocol/server`. The local inference helpers add no competing schema vocabulary.
-
-`InferJsonSchema<T>` supports:
-
-- `type`, including multi-type arrays such as `['string', 'null']`
-- `const` and `enum`
-- object `properties`, `required`, and `additionalProperties`
-- array `items`
-- boolean subschemas
-
-Typeless object keywords infer an object. Unsupported compositions such as `$ref` and `oneOf` remain `unknown`.
-
-`InferArgsFromInputSchema<T>` keeps object and array inputs. A widened or runtime-defined `InputSchema` safely falls back to `WebMcpToolInput`, which is `Record<string, unknown> | unknown[]`.
-
-MCP-B output inference uses `ToolResultFromOutputSchema<T>` or `ToolDescriptorFromSchema<TInput, TOutput>`. `outputSchema` is not part of the current standard `ModelContextTool` dictionary.
-
-## Main exports
-
-| Export                       | Purpose                                      |
-| ---------------------------- | -------------------------------------------- |
-| `ModelContextTool`           | Standard one-argument tool dictionary        |
-| `RegisteredTool`             | Metadata returned by `getTools()`            |
-| `ToolDescriptor`             | Explicit MCP-B input and result types        |
-| `ToolDescriptorFromSchema`   | MCP-B input and output schema inference      |
-| `ToolListItem`               | Metadata returned by `listTools()`           |
-| `InputSchema`                | Broad runtime JSON Schema boundary           |
-| `JsonSchemaForInference`     | Canonical upstream JSON Schema type          |
-| `InferJsonSchema`            | Infer a value from supported schema keywords |
-| `InferArgsFromInputSchema`   | Infer an object or array callback input      |
-| `ToolResultFromOutputSchema` | Infer MCP `structuredContent`                |
-| `CallToolResult`             | Canonical MCP tool result                    |
-| `RegistrationHandle`         | Handle returned by prompt/resource helpers   |
-
-## Compatibility
-
-- `navigator.modelContext` remains optional and deprecated.
-- `navigator.modelContextTesting` remains optional and deprecated.
-- `unregisterTool()`, `provideContext()`, and `clearContext()` are absent. Use an `AbortSignal` to own a tool registration.
-- Strict and `strictNullChecks: false` projects are covered by package type tests.
+The previous package's top-level type exports are not reproduced. Use upstream
+types such as `WebMCP.ModelContext` and `WebMCP.ModelContextTool`. MCP-B extension
+types, including `ToolDescriptor` and `ModelContextWithExtensions`, now live in
+[`@mcp-b/webmcp-ts-sdk`](../webmcp-ts-sdk/README.md).
 
-See the [package reference](https://docs.mcp-b.ai/packages/webmcp-types/reference) and [strict core versus MCP-B extensions](https://docs.mcp-b.ai/explanation/strict-core-vs-mcp-b-extensions).
+See the [upstream README](https://github.com/webmachinelearning/webmcp-types#readme)
+for the API and schema inference documentation.
 
 ## License
 
-MIT
+MIT.

package/index.d.ts

@@ -0,0 +1 @@
+export type * from 'webmcp-types';

package/package.json

@@ -1,17 +1,8 @@
 {
   "name": "@mcp-b/webmcp-types",
-  "version": "5.1.0",
-  "description": "Strict TypeScript type definitions for the WebMCP core API (document.modelContext)",
-  "keywords": [
-    "document-modelcontext",
-    "model-context",
-    "navigator-modelcontext",
-    "types",
-    "typescript",
-    "web-standard",
-    "webmcp"
-  ],
-  "homepage": "https://docs.mcp-b.ai/packages/webmcp-types/reference",
+  "version": "6.0.0-beta.20261001010549",
+  "description": "Compatibility alias for upstream webmcp-types; use webmcp-types directly",
+  "homepage": "https://github.com/webmachinelearning/webmcp-types",
   "bugs": {
     "url": "https://github.com/WebMCP-org/npm-packages/issues"
   },
@@ -23,19 +14,14 @@
     "directory": "packages/webmcp-types"
   },
   "files": [
-    "dist",
-    "src/common.ts",
-    "src/index.ts",
-    "src/json-schema.ts",
-    "src/model-context.ts",
-    "src/tool.ts"
+    "index.d.ts"
   ],
   "type": "module",
   "sideEffects": false,
-  "types": "./dist/index.d.ts",
+  "types": "./index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts"
+      "types": "./index.d.ts"
     }
   },
   "publishConfig": {
@@ -43,25 +29,6 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@modelcontextprotocol/server": "2.0.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.8.3",
-    "vite-plus": "0.1.24",
-    "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.24"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "build": "pnpm run clean && tsc -p tsconfig.build.json",
-    "check": "vp check --fix",
-    "clean": "rm -rf dist",
-    "format": "vp fmt --write",
-    "lint": "vp lint --fix",
-    "publish:dry": "pnpm publish --access public --dry-run",
-    "publish:npm": "pnpm publish --access public",
-    "test": "vp test run",
-    "typecheck": "tsc --noEmit && tsc -p tsconfig.strict-null-checks-false.json && vp test run --typecheck.only --silent"
+    "webmcp-types": "0.1.9"
   }
 }

package/dist/common.d.ts

@@ -1,15 +0,0 @@
-export type { CallToolResult, ContentBlock, JSONObject as JsonObject, JSONValue as JsonValue, TextContent, } from '@modelcontextprotocol/server';
-/** JSON Schema object accepted at the WebMCP boundary. */
-export interface InputSchema {
-    type?: unknown;
-    properties?: Readonly<Record<string, unknown>> | undefined;
-    required?: readonly string[] | undefined;
-    [keyword: string]: unknown;
-}
-/** Values accepted by WebMCP tool callbacks. */
-export type WebMcpToolInput = Record<string, unknown> | unknown[];
-/** Handle returned by MCP-B registration helpers. */
-export interface RegistrationHandle {
-    unregister(): void;
-}
-//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,YAAY,EACZ,UAAU,IAAI,UAAU,EACxB,SAAS,IAAI,SAAS,EACtB,WAAW,GACZ,MAAM,8BAA8B,CAAC;AAEtC,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACzC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,gDAAgD;AAChD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;AAElE,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,UAAU,IAAI,IAAI,CAAC;CACpB"}

package/dist/index.d.ts

@@ -1,52 +0,0 @@
-import type { ModelContext, ModelContextTesting } from './model-context.js';
-export type { CallToolResult, ContentBlock, InputSchema, JsonObject, JsonValue, RegistrationHandle, TextContent, WebMcpToolInput, } from './common.js';
-export type { InferArgsFromInputSchema, InferJsonSchema, JsonSchemaForInference, } from './json-schema.js';
-export type { ChromeModelContext, ChromeModelContextExecuteToolOptions, ChromeModelContextExtensions, ModelContext, ModelContextExtensions, ModelContextGetToolOptions, ModelContextRegisterToolOptions, ModelContextTesting, ModelContextTestingToolInfo, ModelContextWithExtensions, RegisteredTool, } from './model-context.js';
-export type { MaybePromise, ModelContextTool, ToolAnnotations, ToolDescriptor, ToolDescriptorFromSchema, ToolListItem, ToolResultFromOutputSchema, WebMcpToolAnnotations, } from './tool.js';
-declare global {
-    /**
-     * Web IDL interface object used for branding and `instanceof`.
-     *
-     * Absent unless the document's realm implements WebMCP, so guard with
-     * `typeof ModelContext !== 'undefined'` before referencing it. A bare
-     * reference to an undeclared global throws `ReferenceError`.
-     */
-    var ModelContext: (Function & {
-        readonly prototype: ModelContext;
-        [Symbol.hasInstance](value: unknown): value is ModelContext;
-    }) | undefined;
-    interface Document {
-        /**
-         * Canonical WebMCP API for this document.
-         *
-         * Optional because no browser ships WebMCP unflagged: Chromium exposes it
-         * only under `--enable-features=WebMCP`, and elsewhere the property is
-         * genuinely absent (`'modelContext' in document === false`). Feature-detect
-         * it, or install `@mcp-b/webmcp-polyfill`.
-         */
-        readonly modelContext?: ModelContext;
-    }
-    interface Navigator {
-        /** @deprecated Use `document.modelContext`. */
-        readonly modelContext?: ModelContext;
-        /** @deprecated Compatibility surface for older Chromium previews. */
-        modelContextTesting?: ModelContextTesting;
-    }
-    interface SubmitEvent {
-        /**
-         * True when a declarative WebMCP tool initiated this submission.
-         *
-         * Optional because declarative forms are explainer-only: this attribute is
-         * in neither the WebMCP specification nor WPT's `webmcp.idl`, and no
-         * browser implements it. `@mcp-b/webmcp-polyfill` installs it.
-         */
-        readonly agentInvoked?: boolean;
-        /**
-         * Associates an intercepted form submission result with the invoking agent.
-         *
-         * Optional for the same reason as {@link SubmitEvent.agentInvoked}.
-         */
-        respondWith?(agentResponse: Promise<unknown>): void;
-    }
-}
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,YAAY,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,wBAAwB,EACxB,eAAe,EACf,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,kBAAkB,EAClB,oCAAoC,EACpC,4BAA4B,EAC5B,YAAY,EACZ,sBAAsB,EACtB,0BAA0B,EAC1B,+BAA+B,EAC/B,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,YAAY,EACZ,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,OAAO,CAAC,MAAM,CAAC;IACb;;;;;;OAMG;IACH,IAAI,YAAY,EACZ,CAAC,QAAQ,GAAG;QACV,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;QACjC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC;KAC7D,CAAC,GACF,SAAS,CAAC;IAEd,UAAU,QAAQ;QAChB;;;;;;;WAOG;QACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;KACtC;IAED,UAAU,SAAS;QACjB,+CAA+C;QAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;QAErC,qEAAqE;QACrE,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;KAC3C;IAED,UAAU,WAAW;QACnB;;;;;;WAMG;QACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;QAEhC;;;;WAIG;QACH,WAAW,CAAC,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;KACrD;CACF"}

package/dist/json-schema.d.ts

@@ -1,52 +0,0 @@
-import type { InputSchema, WebMcpToolInput } from './common.js';
-import type { JsonSchemaType as McpJsonSchema } from '@modelcontextprotocol/server';
-/** JSON Schema Draft 2020-12 accepted by the inference helpers. */
-export type JsonSchemaForInference = McpJsonSchema;
-type JsonSchemaType = 'string' | 'number' | 'integer' | 'boolean' | 'null' | 'object' | 'array';
-type Simplify<T> = {
-    [K in keyof T]: T[K];
-} & {};
-type EmptyObject = Record<never, never>;
-type ConstValue<TSchema> = TSchema extends {
-    const: infer TValue;
-} ? TValue : never;
-type EnumValue<TSchema> = TSchema extends {
-    enum: readonly (infer TValue)[];
-} ? TValue : never;
-type Properties<TSchema> = TSchema extends {
-    properties: infer TProperties extends Readonly<Record<string, unknown>>;
-} ? TProperties : EmptyObject;
-type RequiredKeys<TSchema> = TSchema extends {
-    required: readonly (infer TKey extends string)[];
-} ? string extends TKey ? never : Extract<TKey, keyof Properties<TSchema>> : never;
-type AdditionalProperties<TSchema> = TSchema extends {
-    additionalProperties: false;
-} ? keyof Properties<TSchema> extends never ? Record<string, never> : EmptyObject : keyof Properties<TSchema> extends never ? TSchema extends {
-    additionalProperties: infer TAdditional extends object;
-} ? Record<string, InferJsonSchema<TAdditional>> : Record<string, unknown> : Record<string, unknown>;
-type InferObject<TSchema> = Simplify<{
-    -readonly [K in keyof Properties<TSchema> as K extends RequiredKeys<TSchema> ? K : never]-?: InferJsonSchema<Properties<TSchema>[K]>;
-} & {
-    -readonly [K in keyof Properties<TSchema> as K extends RequiredKeys<TSchema> ? never : K]?: InferJsonSchema<Properties<TSchema>[K]>;
-} & AdditionalProperties<TSchema>>;
-type TypeKeyword<TSchema> = TSchema extends {
-    type: infer TType;
-} ? TType : TSchema extends {
-    properties: unknown;
-} | {
-    required: unknown;
-} | {
-    additionalProperties: unknown;
-} ? 'object' : never;
-type TypeOptions<TSchema> = TypeKeyword<TSchema> extends readonly unknown[] ? Extract<TypeKeyword<TSchema>[number], JsonSchemaType> : Extract<TypeKeyword<TSchema>, JsonSchemaType>;
-type InferType<TSchema, TType extends JsonSchemaType> = TType extends 'object' ? InferObject<TSchema> : TType extends 'array' ? TSchema extends {
-    items: infer TItems;
-} ? InferJsonSchema<TItems>[] : unknown[] : TType extends 'string' ? string : TType extends 'number' | 'integer' ? number : TType extends 'boolean' ? boolean : TType extends 'null' ? null : unknown;
-/** Infers a TypeScript value from the supported JSON Schema keywords. */
-export type InferJsonSchema<TSchema> = TSchema extends false ? never : TSchema extends true ? unknown : [InputSchema] extends [TSchema] ? unknown : [ConstValue<TSchema>] extends [never] ? [EnumValue<TSchema>] extends [never] ? TypeOptions<TSchema> extends never ? unknown : InferType<TSchema, TypeOptions<TSchema>> : EnumValue<TSchema> : ConstValue<TSchema>;
-/** Infers the object or array passed to a WebMCP tool callback. */
-export type InferArgsFromInputSchema<TSchema> = [
-    Extract<Exclude<InferJsonSchema<TSchema>, null | undefined>, WebMcpToolInput>
-] extends [never] ? WebMcpToolInput : Extract<Exclude<InferJsonSchema<TSchema>, null | undefined>, WebMcpToolInput>;
-export {};
-//# sourceMappingURL=json-schema.d.ts.map

package/dist/json-schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../src/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAEpF,mEAAmE;AACnE,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAEnD,KAAK,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAChG,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AACjD,KAAK,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAExC,KAAK,UAAU,CAAC,OAAO,IAAI,OAAO,SAAS;IAAE,KAAK,EAAE,MAAM,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,KAAK,CAAC;AACpF,KAAK,SAAS,CAAC,OAAO,IAAI,OAAO,SAAS;IAAE,IAAI,EAAE,SAAS,CAAC,MAAM,MAAM,CAAC,EAAE,CAAA;CAAE,GAAG,MAAM,GAAG,KAAK,CAAC;AAC/F,KAAK,UAAU,CAAC,OAAO,IAAI,OAAO,SAAS;IACzC,UAAU,EAAE,MAAM,WAAW,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzE,GACG,WAAW,GACX,WAAW,CAAC;AAChB,KAAK,YAAY,CAAC,OAAO,IAAI,OAAO,SAAS;IAAE,QAAQ,EAAE,SAAS,CAAC,MAAM,IAAI,SAAS,MAAM,CAAC,EAAE,CAAA;CAAE,GAC7F,MAAM,SAAS,IAAI,GACjB,KAAK,GACL,OAAO,CAAC,IAAI,EAAE,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,GAC1C,KAAK,CAAC;AAEV,KAAK,oBAAoB,CAAC,OAAO,IAAI,OAAO,SAAS;IAAE,oBAAoB,EAAE,KAAK,CAAA;CAAE,GAChF,MAAM,UAAU,CAAC,OAAO,CAAC,SAAS,KAAK,GACrC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GACrB,WAAW,GACb,MAAM,UAAU,CAAC,OAAO,CAAC,SAAS,KAAK,GACrC,OAAO,SAAS;IAAE,oBAAoB,EAAE,MAAM,WAAW,SAAS,MAAM,CAAA;CAAE,GACxE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9B,KAAK,WAAW,CAAC,OAAO,IAAI,QAAQ,CAClC;IACE,CAAC,UAAU,CAAC,IAAI,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,YAAY,CAAC,OAAO,CAAC,GACxE,CAAC,GACD,KAAK,CAAC,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACtD,GAAG;IACF,CAAC,UAAU,CAAC,IAAI,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,YAAY,CAAC,OAAO,CAAC,GACxE,KAAK,GACL,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACjD,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAClC,CAAC;AAEF,KAAK,WAAW,CAAC,OAAO,IAAI,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,KAAK,CAAA;CAAE,GAC7D,KAAK,GACL,OAAO,SACD;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,GACvB;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,GACrB;IAAE,oBAAoB,EAAE,OAAO,CAAA;CAAE,GACrC,QAAQ,GACR,KAAK,CAAC;AACZ,KAAK,WAAW,CAAC,OAAO,IACtB,WAAW,CAAC,OAAO,CAAC,SAAS,SAAS,OAAO,EAAE,GAC3C,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,GACrD,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC;AAEpD,KAAK,SAAS,CAAC,OAAO,EAAE,KAAK,SAAS,cAAc,IAAI,KAAK,SAAS,QAAQ,GAC1E,WAAW,CAAC,OAAO,CAAC,GACpB,KAAK,SAAS,OAAO,GACnB,OAAO,SAAS;IAAE,KAAK,EAAE,MAAM,MAAM,CAAA;CAAE,GACrC,eAAe,CAAC,MAAM,CAAC,EAAE,GACzB,OAAO,EAAE,GACX,KAAK,SAAS,QAAQ,GACpB,MAAM,GACN,KAAK,SAAS,QAAQ,GAAG,SAAS,GAChC,MAAM,GACN,KAAK,SAAS,SAAS,GACrB,OAAO,GACP,KAAK,SAAS,MAAM,GAClB,IAAI,GACJ,OAAO,CAAC;AAEtB,yEAAyE;AACzE,MAAM,MAAM,eAAe,CAAC,OAAO,IAAI,OAAO,SAAS,KAAK,GACxD,KAAK,GACL,OAAO,SAAS,IAAI,GAClB,OAAO,GACP,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,GAC7B,OAAO,GACP,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACnC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAClC,WAAW,CAAC,OAAO,CAAC,SAAS,KAAK,GAChC,OAAO,GACP,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,GAC1C,SAAS,CAAC,OAAO,CAAC,GACpB,UAAU,CAAC,OAAO,CAAC,CAAC;AAE9B,mEAAmE;AACnE,MAAM,MAAM,wBAAwB,CAAC,OAAO,IAAI;IAC9C,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC,EAAE,eAAe,CAAC;CAC9E,SAAS,CAAC,KAAK,CAAC,GACb,eAAe,GACf,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC"}

package/dist/model-context.d.ts

@@ -1,91 +0,0 @@
-import type { InputSchema, WebMcpToolInput } from './common.js';
-import type { JsonSchemaForInference } from './json-schema.js';
-import type { ModelContextTool, ModelContextToolFromSchema, ToolDescriptor, ToolDescriptorFromSchema, ToolListItem, WebMcpToolAnnotations } from './tool.js';
-/** Options for tools exposed by descendant documents. */
-export interface ModelContextGetToolOptions {
-    fromOrigins?: string[];
-}
-/** Tool metadata returned by `document.modelContext.getTools()`. */
-export interface RegisteredTool {
-    name: string;
-    /**
-     * Present on every tool Chrome and `@mcp-b/webmcp-polyfill` return today --
-     * the spec defaults it to the empty string when a tool registers no title.
-     * Kept optional deliberately: webmcp#224 proposes dropping that default and
-     * omitting the member instead. Read it as `tool.title || tool.name`: today the
-     * spec default makes it an empty string, which `??` does not fall through.
-     */
-    title?: string;
-    description: string;
-    /**
-     * A JSON Schema object since webmcp#241, rolling out from Chrome 154.0.8013
-     * (cross-document tools first). Chrome 149-153 -- most of the Origin Trial
-     * population -- and 154's same-document tools still return the serialized
-     * JSON string the change replaced. Consumers that support both generations
-     * must branch on `typeof` and guard the parse of the string arm.
-     */
-    inputSchema?: InputSchema | string;
-    window: Window;
-    origin: string;
-    /**
-     * Absent when the tool registered no annotations -- both the spec and the
-     * polyfill omit the member rather than emitting an empty object. Each hint
-     * inside it is always populated, but the object itself is not guaranteed.
-     */
-    annotations?: WebMcpToolAnnotations;
-}
-export interface ChromeModelContextExecuteToolOptions {
-    signal?: AbortSignal;
-}
-/** Experimental Chromium methods; feature-detect them before use. */
-export interface ChromeModelContextExtensions {
-    executeTool?(tool: RegisteredTool, inputArguments: string, options?: ChromeModelContextExecuteToolOptions): Promise<string | null>;
-}
-/** @deprecated Metadata returned by `navigator.modelContextTesting`. */
-export interface ModelContextTestingToolInfo {
-    name: string;
-    description: string;
-    inputSchema?: string;
-}
-/** @deprecated Compatibility surface for Chromium's removed testing API. */
-export interface ModelContextTesting extends EventTarget {
-    listTools(): ModelContextTestingToolInfo[];
-    executeTool(toolName: string, inputArgsJson: string, options?: ChromeModelContextExecuteToolOptions): Promise<string | null>;
-    ontoolchange: ((this: ModelContextTesting, event: Event) => unknown) | null;
-}
-/** Options accepted by `ModelContext.registerTool()`. */
-export interface ModelContextRegisterToolOptions {
-    signal?: AbortSignal;
-    exposedTo?: string[];
-}
-type WidenedSchema<TSchema extends InputSchema> = string extends TSchema['type'] ? unknown : never;
-/**
- * Standard `document.modelContext` API.
- * @see https://webmachinelearning.github.io/webmcp/#modelcontext
- */
-export interface ModelContext extends EventTarget {
-    registerTool<const TInputSchema extends JsonSchemaForInference, TResult = unknown, TName extends string = string>(tool: ModelContextToolFromSchema<TInputSchema, TResult, TName>, options?: ModelContextRegisterToolOptions): Promise<void>;
-    registerTool<TInputSchema extends InputSchema, TArgs extends WebMcpToolInput = WebMcpToolInput, TResult = unknown, TName extends string = string>(tool: ModelContextTool<TArgs, TResult, TName> & {
-        inputSchema: TInputSchema;
-    } & WidenedSchema<TInputSchema>, options?: ModelContextRegisterToolOptions): Promise<void>;
-    registerTool<TArgs extends WebMcpToolInput = Record<string, unknown>, TResult = unknown, TName extends string = string>(tool: Omit<ModelContextTool<TArgs, TResult, TName>, 'inputSchema'> & {
-        inputSchema?: undefined;
-    }, options?: ModelContextRegisterToolOptions): Promise<void>;
-    getTools(options?: ModelContextGetToolOptions): Promise<RegisteredTool[]>;
-    ontoolchange: ((this: ModelContext, event: Event) => unknown) | null;
-}
-/** Non-standard methods exposed by MCP-B runtimes. */
-export interface ModelContextExtensions {
-    registerTool<const TInputSchema extends JsonSchemaForInference, const TOutputSchema extends JsonSchemaForInference | undefined = undefined, TName extends string = string>(tool: ToolDescriptorFromSchema<TInputSchema, TOutputSchema, TName>, options?: ModelContextRegisterToolOptions): Promise<void>;
-    registerTool<TInputSchema extends InputSchema, TArgs extends WebMcpToolInput = WebMcpToolInput, TName extends string = string>(tool: ToolDescriptor<TArgs, unknown, TName> & {
-        inputSchema: TInputSchema;
-    } & WidenedSchema<TInputSchema>, options?: ModelContextRegisterToolOptions): Promise<void>;
-    registerTool<TArgs extends WebMcpToolInput = Record<string, unknown>, TName extends string = string>(tool: Omit<ToolDescriptor<TArgs, unknown, TName>, 'inputSchema'> & {
-        inputSchema?: undefined;
-    }, options?: ModelContextRegisterToolOptions): Promise<void>;
-    listTools(): ToolListItem[];
-}
-export type ChromeModelContext = ModelContext & ChromeModelContextExtensions;
-export type ModelContextWithExtensions = Omit<ModelContext, 'registerTool'> & ModelContextExtensions;
-export {};
-//# sourceMappingURL=model-context.d.ts.map

package/dist/model-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"model-context.d.ts","sourceRoot":"","sources":["../src/model-context.ts"],"names":[],"mappings":"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"}

package/dist/tool.d.ts

@@ -1,56 +0,0 @@
-import type { CallToolResult, InputSchema, WebMcpToolInput } from './common.js';
-import type { InferArgsFromInputSchema, InferJsonSchema, JsonSchemaForInference } from './json-schema.js';
-import type { ToolAnnotations as McpToolAnnotations } from '@modelcontextprotocol/server';
-/**
- * Annotations in the WebMCP tool dictionary.
- * @see https://webmachinelearning.github.io/webmcp/#dictdef-toolannotations
- */
-export interface WebMcpToolAnnotations {
-    readOnlyHint?: boolean;
-    untrustedContentHint?: boolean;
-}
-/** MCP annotations plus WebMCP's untrusted-content hint. */
-export type ToolAnnotations = McpToolAnnotations & WebMcpToolAnnotations;
-export type MaybePromise<T> = T | Promise<T>;
-/**
- * Tool dictionary accepted by the standard browser API.
- * @see https://webmachinelearning.github.io/webmcp/#dictdef-modelcontexttool
- */
-export interface ModelContextTool<TArgs extends WebMcpToolInput = Record<string, unknown>, TResult = unknown, TName extends string = string> {
-    name: TName;
-    title?: string;
-    description: string;
-    inputSchema?: InputSchema | undefined;
-    annotations?: WebMcpToolAnnotations;
-    execute: (input: TArgs) => MaybePromise<TResult>;
-}
-/** Standard tool dictionary with input inferred from a JSON Schema literal. */
-export type ModelContextToolFromSchema<TInputSchema extends InputSchema, TResult = unknown, TName extends string = string> = Omit<ModelContextTool<InferArgsFromInputSchema<TInputSchema>, TResult, TName>, 'inputSchema'> & {
-    inputSchema: TInputSchema;
-};
-/** MCP-B tool dictionary with output metadata. */
-export type ToolDescriptor<TArgs extends WebMcpToolInput = Record<string, unknown>, TResult = unknown, TName extends string = string> = Omit<ModelContextTool<TArgs, TResult, TName>, 'annotations'> & {
-    outputSchema?: JsonSchemaForInference;
-    annotations?: ToolAnnotations;
-};
-/** MCP response with `structuredContent` inferred from an output schema. */
-export type ToolResultFromOutputSchema<TOutputSchema extends JsonSchemaForInference | undefined = undefined> = [TOutputSchema] extends [undefined] ? CallToolResult : TOutputSchema extends JsonSchemaForInference ? Omit<CallToolResult, 'structuredContent'> & {
-    structuredContent: InferJsonSchema<TOutputSchema>;
-} : never;
-type ExecuteResult<TOutputSchema extends JsonSchemaForInference | undefined> = [
-    TOutputSchema
-] extends [undefined] ? unknown : TOutputSchema extends JsonSchemaForInference ? InferJsonSchema<TOutputSchema> | ToolResultFromOutputSchema<TOutputSchema> : never;
-/** Tool dictionary with input and output inferred from JSON Schema literals. */
-export type ToolDescriptorFromSchema<TInputSchema extends InputSchema, TOutputSchema extends JsonSchemaForInference | undefined = undefined, TName extends string = string> = Omit<ToolDescriptor<InferArgsFromInputSchema<TInputSchema>, ExecuteResult<TOutputSchema>, TName>, 'inputSchema' | 'outputSchema'> & {
-    inputSchema: TInputSchema;
-} & ([TOutputSchema] extends [undefined] ? {
-    outputSchema?: undefined;
-} : {
-    outputSchema: TOutputSchema;
-});
-/** Tool metadata returned by the MCP-B `listTools()` extension. */
-export type ToolListItem<TName extends string = string> = Omit<ToolDescriptor<Record<string, unknown>, unknown, TName>, 'execute' | 'inputSchema'> & {
-    inputSchema: InputSchema;
-};
-export {};
-//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"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"}

package/src/common.ts

@@ -1,23 +0,0 @@
-export type {
-  CallToolResult,
-  ContentBlock,
-  JSONObject as JsonObject,
-  JSONValue as JsonValue,
-  TextContent,
-} from '@modelcontextprotocol/server';
-
-/** JSON Schema object accepted at the WebMCP boundary. */
-export interface InputSchema {
-  type?: unknown;
-  properties?: Readonly<Record<string, unknown>> | undefined;
-  required?: readonly string[] | undefined;
-  [keyword: string]: unknown;
-}
-
-/** Values accepted by WebMCP tool callbacks. */
-export type WebMcpToolInput = Record<string, unknown> | unknown[];
-
-/** Handle returned by MCP-B registration helpers. */
-export interface RegistrationHandle {
-  unregister(): void;
-}

package/src/index.ts

@@ -1,94 +0,0 @@
-import type { ModelContext, ModelContextTesting } from './model-context.js';
-
-export type {
-  CallToolResult,
-  ContentBlock,
-  InputSchema,
-  JsonObject,
-  JsonValue,
-  RegistrationHandle,
-  TextContent,
-  WebMcpToolInput,
-} from './common.js';
-export type {
-  InferArgsFromInputSchema,
-  InferJsonSchema,
-  JsonSchemaForInference,
-} from './json-schema.js';
-export type {
-  ChromeModelContext,
-  ChromeModelContextExecuteToolOptions,
-  ChromeModelContextExtensions,
-  ModelContext,
-  ModelContextExtensions,
-  ModelContextGetToolOptions,
-  ModelContextRegisterToolOptions,
-  ModelContextTesting,
-  ModelContextTestingToolInfo,
-  ModelContextWithExtensions,
-  RegisteredTool,
-} from './model-context.js';
-export type {
-  MaybePromise,
-  ModelContextTool,
-  ToolAnnotations,
-  ToolDescriptor,
-  ToolDescriptorFromSchema,
-  ToolListItem,
-  ToolResultFromOutputSchema,
-  WebMcpToolAnnotations,
-} from './tool.js';
-
-declare global {
-  /**
-   * Web IDL interface object used for branding and `instanceof`.
-   *
-   * Absent unless the document's realm implements WebMCP, so guard with
-   * `typeof ModelContext !== 'undefined'` before referencing it. A bare
-   * reference to an undeclared global throws `ReferenceError`.
-   */
-  var ModelContext:
-    | (Function & {
-        readonly prototype: ModelContext;
-        [Symbol.hasInstance](value: unknown): value is ModelContext;
-      })
-    | undefined;
-
-  interface Document {
-    /**
-     * Canonical WebMCP API for this document.
-     *
-     * Optional because no browser ships WebMCP unflagged: Chromium exposes it
-     * only under `--enable-features=WebMCP`, and elsewhere the property is
-     * genuinely absent (`'modelContext' in document === false`). Feature-detect
-     * it, or install `@mcp-b/webmcp-polyfill`.
-     */
-    readonly modelContext?: ModelContext;
-  }
-
-  interface Navigator {
-    /** @deprecated Use `document.modelContext`. */
-    readonly modelContext?: ModelContext;
-
-    /** @deprecated Compatibility surface for older Chromium previews. */
-    modelContextTesting?: ModelContextTesting;
-  }
-
-  interface SubmitEvent {
-    /**
-     * True when a declarative WebMCP tool initiated this submission.
-     *
-     * Optional because declarative forms are explainer-only: this attribute is
-     * in neither the WebMCP specification nor WPT's `webmcp.idl`, and no
-     * browser implements it. `@mcp-b/webmcp-polyfill` installs it.
-     */
-    readonly agentInvoked?: boolean;
-
-    /**
-     * Associates an intercepted form submission result with the invoking agent.
-     *
-     * Optional for the same reason as {@link SubmitEvent.agentInvoked}.
-     */
-    respondWith?(agentResponse: Promise<unknown>): void;
-  }
-}

package/src/json-schema.ts

@@ -1,95 +0,0 @@
-import type { InputSchema, WebMcpToolInput } from './common.js';
-import type { JsonSchemaType as McpJsonSchema } from '@modelcontextprotocol/server';
-
-/** JSON Schema Draft 2020-12 accepted by the inference helpers. */
-export type JsonSchemaForInference = McpJsonSchema;
-
-type JsonSchemaType = 'string' | 'number' | 'integer' | 'boolean' | 'null' | 'object' | 'array';
-type Simplify<T> = { [K in keyof T]: T[K] } & {};
-type EmptyObject = Record<never, never>;
-
-type ConstValue<TSchema> = TSchema extends { const: infer TValue } ? TValue : never;
-type EnumValue<TSchema> = TSchema extends { enum: readonly (infer TValue)[] } ? TValue : never;
-type Properties<TSchema> = TSchema extends {
-  properties: infer TProperties extends Readonly<Record<string, unknown>>;
-}
-  ? TProperties
-  : EmptyObject;
-type RequiredKeys<TSchema> = TSchema extends { required: readonly (infer TKey extends string)[] }
-  ? string extends TKey
-    ? never
-    : Extract<TKey, keyof Properties<TSchema>>
-  : never;
-
-type AdditionalProperties<TSchema> = TSchema extends { additionalProperties: false }
-  ? keyof Properties<TSchema> extends never
-    ? Record<string, never>
-    : EmptyObject
-  : keyof Properties<TSchema> extends never
-    ? TSchema extends { additionalProperties: infer TAdditional extends object }
-      ? Record<string, InferJsonSchema<TAdditional>>
-      : Record<string, unknown>
-    : Record<string, unknown>;
-
-type InferObject<TSchema> = Simplify<
-  {
-    -readonly [K in keyof Properties<TSchema> as K extends RequiredKeys<TSchema>
-      ? K
-      : never]-?: InferJsonSchema<Properties<TSchema>[K]>;
-  } & {
-    -readonly [K in keyof Properties<TSchema> as K extends RequiredKeys<TSchema>
-      ? never
-      : K]?: InferJsonSchema<Properties<TSchema>[K]>;
-  } & AdditionalProperties<TSchema>
->;
-
-type TypeKeyword<TSchema> = TSchema extends { type: infer TType }
-  ? TType
-  : TSchema extends
-        | { properties: unknown }
-        | { required: unknown }
-        | { additionalProperties: unknown }
-    ? 'object'
-    : never;
-type TypeOptions<TSchema> =
-  TypeKeyword<TSchema> extends readonly unknown[]
-    ? Extract<TypeKeyword<TSchema>[number], JsonSchemaType>
-    : Extract<TypeKeyword<TSchema>, JsonSchemaType>;
-
-type InferType<TSchema, TType extends JsonSchemaType> = TType extends 'object'
-  ? InferObject<TSchema>
-  : TType extends 'array'
-    ? TSchema extends { items: infer TItems }
-      ? InferJsonSchema<TItems>[]
-      : unknown[]
-    : TType extends 'string'
-      ? string
-      : TType extends 'number' | 'integer'
-        ? number
-        : TType extends 'boolean'
-          ? boolean
-          : TType extends 'null'
-            ? null
-            : unknown;
-
-/** Infers a TypeScript value from the supported JSON Schema keywords. */
-export type InferJsonSchema<TSchema> = TSchema extends false
-  ? never
-  : TSchema extends true
-    ? unknown
-    : [InputSchema] extends [TSchema]
-      ? unknown
-      : [ConstValue<TSchema>] extends [never]
-        ? [EnumValue<TSchema>] extends [never]
-          ? TypeOptions<TSchema> extends never
-            ? unknown
-            : InferType<TSchema, TypeOptions<TSchema>>
-          : EnumValue<TSchema>
-        : ConstValue<TSchema>;
-
-/** Infers the object or array passed to a WebMCP tool callback. */
-export type InferArgsFromInputSchema<TSchema> = [
-  Extract<Exclude<InferJsonSchema<TSchema>, null | undefined>, WebMcpToolInput>,
-] extends [never]
-  ? WebMcpToolInput
-  : Extract<Exclude<InferJsonSchema<TSchema>, null | undefined>, WebMcpToolInput>;

package/src/model-context.ts

@@ -1,164 +0,0 @@
-import type { InputSchema, WebMcpToolInput } from './common.js';
-import type { JsonSchemaForInference } from './json-schema.js';
-import type {
-  ModelContextTool,
-  ModelContextToolFromSchema,
-  ToolDescriptor,
-  ToolDescriptorFromSchema,
-  ToolListItem,
-  WebMcpToolAnnotations,
-} from './tool.js';
-
-/** Options for tools exposed by descendant documents. */
-export interface ModelContextGetToolOptions {
-  fromOrigins?: string[];
-}
-
-/** Tool metadata returned by `document.modelContext.getTools()`. */
-export interface RegisteredTool {
-  name: string;
-  /**
-   * Present on every tool Chrome and `@mcp-b/webmcp-polyfill` return today --
-   * the spec defaults it to the empty string when a tool registers no title.
-   * Kept optional deliberately: webmcp#224 proposes dropping that default and
-   * omitting the member instead. Read it as `tool.title || tool.name`: today the
-   * spec default makes it an empty string, which `??` does not fall through.
-   */
-  title?: string;
-  description: string;
-  /**
-   * A JSON Schema object since webmcp#241, rolling out from Chrome 154.0.8013
-   * (cross-document tools first). Chrome 149-153 -- most of the Origin Trial
-   * population -- and 154's same-document tools still return the serialized
-   * JSON string the change replaced. Consumers that support both generations
-   * must branch on `typeof` and guard the parse of the string arm.
-   */
-  inputSchema?: InputSchema | string;
-  window: Window;
-  origin: string;
-  /**
-   * Absent when the tool registered no annotations -- both the spec and the
-   * polyfill omit the member rather than emitting an empty object. Each hint
-   * inside it is always populated, but the object itself is not guaranteed.
-   */
-  annotations?: WebMcpToolAnnotations;
-}
-
-export interface ChromeModelContextExecuteToolOptions {
-  signal?: AbortSignal;
-}
-
-/** Experimental Chromium methods; feature-detect them before use. */
-export interface ChromeModelContextExtensions {
-  executeTool?(
-    tool: RegisteredTool,
-    inputArguments: string,
-    options?: ChromeModelContextExecuteToolOptions
-  ): Promise<string | null>;
-}
-
-/** @deprecated Metadata returned by `navigator.modelContextTesting`. */
-export interface ModelContextTestingToolInfo {
-  name: string;
-  description: string;
-  inputSchema?: string;
-}
-
-/** @deprecated Compatibility surface for Chromium's removed testing API. */
-export interface ModelContextTesting extends EventTarget {
-  listTools(): ModelContextTestingToolInfo[];
-  executeTool(
-    toolName: string,
-    inputArgsJson: string,
-    options?: ChromeModelContextExecuteToolOptions
-  ): Promise<string | null>;
-  ontoolchange: ((this: ModelContextTesting, event: Event) => unknown) | null;
-}
-
-/** Options accepted by `ModelContext.registerTool()`. */
-export interface ModelContextRegisterToolOptions {
-  signal?: AbortSignal;
-  exposedTo?: string[];
-}
-
-type WidenedSchema<TSchema extends InputSchema> = string extends TSchema['type'] ? unknown : never;
-
-/**
- * Standard `document.modelContext` API.
- * @see https://webmachinelearning.github.io/webmcp/#modelcontext
- */
-export interface ModelContext extends EventTarget {
-  registerTool<
-    const TInputSchema extends JsonSchemaForInference,
-    TResult = unknown,
-    TName extends string = string,
-  >(
-    tool: ModelContextToolFromSchema<TInputSchema, TResult, TName>,
-    options?: ModelContextRegisterToolOptions
-  ): Promise<void>;
-
-  registerTool<
-    TInputSchema extends InputSchema,
-    TArgs extends WebMcpToolInput = WebMcpToolInput,
-    TResult = unknown,
-    TName extends string = string,
-  >(
-    tool: ModelContextTool<TArgs, TResult, TName> & {
-      inputSchema: TInputSchema;
-    } & WidenedSchema<TInputSchema>,
-    options?: ModelContextRegisterToolOptions
-  ): Promise<void>;
-
-  registerTool<
-    TArgs extends WebMcpToolInput = Record<string, unknown>,
-    TResult = unknown,
-    TName extends string = string,
-  >(
-    tool: Omit<ModelContextTool<TArgs, TResult, TName>, 'inputSchema'> & {
-      inputSchema?: undefined;
-    },
-    options?: ModelContextRegisterToolOptions
-  ): Promise<void>;
-
-  getTools(options?: ModelContextGetToolOptions): Promise<RegisteredTool[]>;
-  ontoolchange: ((this: ModelContext, event: Event) => unknown) | null;
-}
-
-/** Non-standard methods exposed by MCP-B runtimes. */
-export interface ModelContextExtensions {
-  registerTool<
-    const TInputSchema extends JsonSchemaForInference,
-    const TOutputSchema extends JsonSchemaForInference | undefined = undefined,
-    TName extends string = string,
-  >(
-    tool: ToolDescriptorFromSchema<TInputSchema, TOutputSchema, TName>,
-    options?: ModelContextRegisterToolOptions
-  ): Promise<void>;
-
-  registerTool<
-    TInputSchema extends InputSchema,
-    TArgs extends WebMcpToolInput = WebMcpToolInput,
-    TName extends string = string,
-  >(
-    tool: ToolDescriptor<TArgs, unknown, TName> & {
-      inputSchema: TInputSchema;
-    } & WidenedSchema<TInputSchema>,
-    options?: ModelContextRegisterToolOptions
-  ): Promise<void>;
-
-  registerTool<
-    TArgs extends WebMcpToolInput = Record<string, unknown>,
-    TName extends string = string,
-  >(
-    tool: Omit<ToolDescriptor<TArgs, unknown, TName>, 'inputSchema'> & {
-      inputSchema?: undefined;
-    },
-    options?: ModelContextRegisterToolOptions
-  ): Promise<void>;
-
-  listTools(): ToolListItem[];
-}
-
-export type ChromeModelContext = ModelContext & ChromeModelContextExtensions;
-export type ModelContextWithExtensions = Omit<ModelContext, 'registerTool'> &
-  ModelContextExtensions;

package/src/tool.ts

@@ -1,101 +0,0 @@
-import type { CallToolResult, InputSchema, WebMcpToolInput } from './common.js';
-import type {
-  InferArgsFromInputSchema,
-  InferJsonSchema,
-  JsonSchemaForInference,
-} from './json-schema.js';
-import type { ToolAnnotations as McpToolAnnotations } from '@modelcontextprotocol/server';
-
-/**
- * Annotations in the WebMCP tool dictionary.
- * @see https://webmachinelearning.github.io/webmcp/#dictdef-toolannotations
- */
-export interface WebMcpToolAnnotations {
-  readOnlyHint?: boolean;
-  untrustedContentHint?: boolean;
-}
-
-/** MCP annotations plus WebMCP's untrusted-content hint. */
-export type ToolAnnotations = McpToolAnnotations & WebMcpToolAnnotations;
-
-export type MaybePromise<T> = T | Promise<T>;
-
-/**
- * Tool dictionary accepted by the standard browser API.
- * @see https://webmachinelearning.github.io/webmcp/#dictdef-modelcontexttool
- */
-export interface ModelContextTool<
-  TArgs extends WebMcpToolInput = Record<string, unknown>,
-  TResult = unknown,
-  TName extends string = string,
-> {
-  name: TName;
-  title?: string;
-  description: string;
-  inputSchema?: InputSchema | undefined;
-  annotations?: WebMcpToolAnnotations;
-  execute: (input: TArgs) => MaybePromise<TResult>;
-}
-
-/** Standard tool dictionary with input inferred from a JSON Schema literal. */
-export type ModelContextToolFromSchema<
-  TInputSchema extends InputSchema,
-  TResult = unknown,
-  TName extends string = string,
-> = Omit<
-  ModelContextTool<InferArgsFromInputSchema<TInputSchema>, TResult, TName>,
-  'inputSchema'
-> & {
-  inputSchema: TInputSchema;
-};
-
-/** MCP-B tool dictionary with output metadata. */
-export type ToolDescriptor<
-  TArgs extends WebMcpToolInput = Record<string, unknown>,
-  TResult = unknown,
-  TName extends string = string,
-> = Omit<ModelContextTool<TArgs, TResult, TName>, 'annotations'> & {
-  outputSchema?: JsonSchemaForInference;
-  annotations?: ToolAnnotations;
-};
-
-/** MCP response with `structuredContent` inferred from an output schema. */
-export type ToolResultFromOutputSchema<
-  TOutputSchema extends JsonSchemaForInference | undefined = undefined,
-> = [TOutputSchema] extends [undefined]
-  ? CallToolResult
-  : TOutputSchema extends JsonSchemaForInference
-    ? Omit<CallToolResult, 'structuredContent'> & {
-        structuredContent: InferJsonSchema<TOutputSchema>;
-      }
-    : never;
-
-type ExecuteResult<TOutputSchema extends JsonSchemaForInference | undefined> = [
-  TOutputSchema,
-] extends [undefined]
-  ? unknown
-  : TOutputSchema extends JsonSchemaForInference
-    ? InferJsonSchema<TOutputSchema> | ToolResultFromOutputSchema<TOutputSchema>
-    : never;
-
-/** Tool dictionary with input and output inferred from JSON Schema literals. */
-export type ToolDescriptorFromSchema<
-  TInputSchema extends InputSchema,
-  TOutputSchema extends JsonSchemaForInference | undefined = undefined,
-  TName extends string = string,
-> = Omit<
-  ToolDescriptor<InferArgsFromInputSchema<TInputSchema>, ExecuteResult<TOutputSchema>, TName>,
-  'inputSchema' | 'outputSchema'
-> & {
-  inputSchema: TInputSchema;
-} & ([TOutputSchema] extends [undefined]
-    ? { outputSchema?: undefined }
-    : { outputSchema: TOutputSchema });
-
-/** Tool metadata returned by the MCP-B `listTools()` extension. */
-export type ToolListItem<TName extends string = string> = Omit<
-  ToolDescriptor<Record<string, unknown>, unknown, TName>,
-  'execute' | 'inputSchema'
-> & {
-  inputSchema: InputSchema;
-};