@mcp-b/webmcp-types 0.0.0-beta-20260216200013

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 mcp-b contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,307 @@
+# @mcp-b/webmcp-types
+
+Strict TypeScript type definitions for the WebMCP core API (`navigator.modelContext`).
+
+Zero dependencies. Zero runtime. Just `.d.ts` declarations.
+
+## What's included
+
+- Global `Navigator` augmentation (`navigator.modelContext`)
+- Core descriptors: tools
+- Content and result payload types (`ContentBlock`, `CallToolResult`, `ResourceContents`)
+- MCPB extension API types (`ModelContextExtensions`, including `callTool`)
+- Tool execution client types (`ModelContextClient`, `ToolExecutionContext`)
+- Typed event surface (`ToolCallEvent`)
+- Pure JSON Schema inference helpers (`JsonSchemaForInference`, `InferArgsFromInputSchema`, `ToolDescriptorFromSchema`, `ToolResultFromOutputSchema`)
+
+## Install
+
+```bash
+npm install --save-dev @mcp-b/webmcp-types
+# or
+pnpm add -D @mcp-b/webmcp-types
+```
+
+If your published library exposes `@mcp-b/webmcp-types` in its own `.d.ts` surface, install it as a production dependency instead of a dev dependency.
+
+## Usage
+
+### Enable global types
+
+TypeScript does not always include global declarations from regular npm packages automatically.
+Use one of the following activation methods:
+
+1. Add to `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "types": ["@mcp-b/webmcp-types"]
+  }
+}
+```
+
+2. Add a triple-slash reference in a global `.d.ts` file:
+
+```typescript
+/// <reference types="@mcp-b/webmcp-types" />
+```
+
+3. Add a type-only import in your app/library entry:
+
+```typescript
+import type {} from '@mcp-b/webmcp-types';
+```
+
+### Global API example
+
+After activating the types, `navigator.modelContext` is available on `Navigator`:
+
+```typescript
+// No import needed - types are globally augmented
+navigator.modelContext.registerTool({
+  name: 'search',
+  description: 'Search the web',
+  inputSchema: {
+    type: 'object',
+    properties: { query: { type: 'string' } },
+    required: ['query'],
+  },
+  execute: async ({ query }) => ({
+    content: [{ type: 'text', text: `Results for: ${query}` }],
+  }),
+});
+```
+
+### Individual imports
+
+```typescript
+import type {
+  ElicitationParams,
+  ElicitationResult,
+  InferArgsFromInputSchema,
+  JsonSchemaForInference,
+  LooseContentBlock,
+  MaybePromise,
+  ModelContext,
+  ModelContextClient,
+  ModelContextExtensions,
+  ToolExecutionContext,
+  ToolDescriptor,
+  ToolDescriptorFromSchema,
+  ToolResultFromOutputSchema,
+  TypedModelContext,
+  CallToolResult,
+} from '@mcp-b/webmcp-types';
+```
+
+### Sync or async execute handlers
+
+`execute` can return a plain result or a `Promise`.
+
+```typescript
+import type { CallToolResult, ToolDescriptor } from '@mcp-b/webmcp-types';
+
+const syncTool: ToolDescriptor<{ message: string }, CallToolResult, 'sync_echo'> = {
+  name: 'sync_echo',
+  description: 'Synchronous echo',
+  inputSchema: {
+    type: 'object',
+    properties: { message: { type: 'string' } },
+    required: ['message'],
+  },
+  execute(args) {
+    return {
+      content: [{ type: 'text', text: args.message }],
+    };
+  },
+};
+```
+
+### Strict and loose content blocks
+
+`CallToolResult.content` accepts strict MCP content blocks and pragmatic loose objects.
+
+```typescript
+import type { CallToolResult } from '@mcp-b/webmcp-types';
+
+const result: CallToolResult = {
+  content: [
+    { type: 'text', text: 'strict block' },
+    { text: 'loose block', data: 'opaque payload' },
+  ],
+};
+```
+
+### Typed tool descriptors
+
+```typescript
+import type { ToolDescriptor } from '@mcp-b/webmcp-types';
+
+type SearchArgs = {
+  query: string;
+  limit?: number;
+};
+
+const searchTool: ToolDescriptor<SearchArgs> = {
+  name: 'search',
+  description: 'Search indexed docs',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      query: { type: 'string' },
+      limit: { type: 'number' },
+    },
+    required: ['query'],
+  },
+  execute: async ({ query, limit }, context) => {
+    const approval = await context.requestUserInteraction(async () => ({
+      confirmed: true,
+    }));
+
+    if (
+      typeof approval !== 'object' ||
+      !approval ||
+      !('confirmed' in approval) ||
+      !approval.confirmed
+    ) {
+      return {
+        content: [{ type: 'text', text: 'Search cancelled by user.' }],
+      };
+    }
+
+    return {
+      content: [{ type: 'text', text: `Searching for "${query}" (limit: ${limit ?? 10})` }],
+    };
+  },
+};
+```
+
+### Pure JSON Schema inference (input + output)
+
+Inference focuses on core keywords (`type`, `properties`, `required`, `items`, `enum`, `const`) and tolerates additional schema metadata.
+
+```typescript
+import type { JsonSchemaForInference } from '@mcp-b/webmcp-types';
+
+const inputSchema = {
+  type: 'object',
+  properties: {
+    query: { type: 'string' },
+    limit: { type: 'integer', minimum: 1, maximum: 50 },
+  },
+  required: ['query'],
+  additionalProperties: false,
+} as const satisfies JsonSchemaForInference;
+
+const outputSchema = {
+  type: 'object',
+  properties: {
+    total: { type: 'integer' },
+    items: {
+      type: 'array',
+      items: { type: 'string' },
+    },
+  },
+  required: ['total'],
+  additionalProperties: false,
+} as const satisfies JsonSchemaForInference;
+
+navigator.modelContext.registerTool({
+  name: 'search',
+  description: 'Search indexed docs',
+  inputSchema,
+  outputSchema,
+  async execute(args) {
+    // args is inferred as:
+    // { query: string; limit?: number }
+    return {
+      content: [{ type: 'text', text: `Searching for ${args.query}` }],
+      // structuredContent is inferred from outputSchema as:
+      // { total: number; items?: string[] }
+      structuredContent: {
+        total: 1,
+        items: [args.query],
+      },
+    };
+  },
+});
+```
+
+If your schema is not a literal (for example loaded from runtime config), inference safely falls back to `Record<string, unknown>`.
+
+### Tool-scoped elicitation
+
+```typescript
+import type { ModelContextExtensions } from '@mcp-b/webmcp-types';
+
+const modelContext = navigator.modelContext as Navigator['modelContext'] & ModelContextExtensions;
+
+modelContext.registerTool({
+  name: 'deploy',
+  description: 'Deploy current build',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      environment: { type: 'string' },
+    },
+    required: ['environment'],
+  },
+  async execute({ environment }, context) {
+    const confirmation = await context.requestUserInteraction(async () => ({
+      action: 'accept',
+      content: { confirm: true },
+    }));
+
+    if (confirmation.action !== 'accept' || !confirmation.content?.confirm) {
+      return {
+        content: [{ type: 'text', text: 'Deployment cancelled.' }],
+      };
+    }
+
+    return {
+      content: [{ type: 'text', text: `Deployment started for ${environment}.` }],
+    };
+  },
+};
+```
+
+### Name-aware typed context (advanced)
+
+```typescript
+import type { CallToolResult, ToolDescriptor, TypedModelContext } from '@mcp-b/webmcp-types';
+
+type SearchTool = ToolDescriptor<
+  { query: string },
+  CallToolResult & { structuredContent: { total: number } },
+  'search'
+>;
+
+type PingTool = ToolDescriptor<Record<string, never>, CallToolResult, 'ping'>;
+
+type AppModelContext = TypedModelContext<readonly [SearchTool, PingTool]>;
+declare const modelContext: AppModelContext;
+
+const searchResult = await modelContext.callTool({
+  name: 'search',
+  arguments: { query: 'webmcp' },
+});
+// searchResult is inferred from the 'search' tool result type.
+
+await modelContext.callTool({ name: 'ping' });
+// 'ping' arguments are optional because the args type is Record<string, never>.
+```
+
+## Relationship to Runtime Packages
+
+| Package | Purpose |
+|---------|---------|
+| `@mcp-b/webmcp-types` | Type definitions only - for libraries that need to type-check against the API |
+| `@mcp-b/webmcp-polyfill` | Strict core runtime polyfill for `navigator.modelContext` |
+| `@mcp-b/global` | Full MCPB runtime (core + bridge extensions like `callTool`, prompts, resources) |
+
+Use `@mcp-b/webmcp-types` when you only need types (e.g., building a library that accepts `ToolDescriptor`). Use `@mcp-b/webmcp-polyfill` for strict core runtime behavior, or `@mcp-b/global` for extension-heavy bridge workflows.
+
+## License
+
+MIT

package/dist/common.d.ts

@@ -0,0 +1,297 @@
+/**
+ * Primitive JSON value.
+ */
+export type JsonPrimitive = string | number | boolean | null;
+/**
+ * Object-shaped JSON value.
+ */
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+/**
+ * Any valid JSON value.
+ */
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+/**
+ * JSON Schema property definition.
+ *
+ * @see {@link https://json-schema.org/}
+ */
+export interface InputSchemaProperty {
+    /**
+     * JSON Schema type for this property.
+     */
+    type: string;
+    /**
+     * Human-readable description of the property.
+     */
+    description?: string;
+    /**
+     * Additional JSON Schema keywords.
+     */
+    [key: string]: unknown;
+}
+/**
+ * JSON Schema definition for tool input parameters.
+ *
+ * @see {@link https://json-schema.org/}
+ */
+export interface InputSchema {
+    /**
+     * JSON Schema type for the root value (usually `'object'` for tool args).
+     */
+    type: string;
+    /**
+     * Property definitions for object schemas.
+     */
+    properties?: Record<string, InputSchemaProperty>;
+    /**
+     * List of required property names.
+     */
+    required?: readonly string[];
+    /**
+     * Additional JSON Schema keywords.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Plain text content.
+ */
+export interface TextContent {
+    /**
+     * Discriminator for text content.
+     */
+    type: 'text';
+    /**
+     * UTF-8 text value.
+     */
+    text: string;
+}
+/**
+ * Base64-encoded image content.
+ */
+export interface ImageContent {
+    /**
+     * Discriminator for image content.
+     */
+    type: 'image';
+    /**
+     * Base64 payload.
+     */
+    data: string;
+    /**
+     * MIME type for the encoded image.
+     */
+    mimeType: string;
+}
+/**
+ * Base64-encoded audio content.
+ */
+export interface AudioContent {
+    /**
+     * Discriminator for audio content.
+     */
+    type: 'audio';
+    /**
+     * Base64 payload.
+     */
+    data: string;
+    /**
+     * MIME type for the encoded audio.
+     */
+    mimeType: string;
+}
+/**
+ * Text resource contents.
+ */
+export interface TextResourceContents {
+    /**
+     * Canonical resource URI.
+     */
+    uri: string;
+    /**
+     * Optional MIME type.
+     */
+    mimeType?: string;
+    /**
+     * UTF-8 resource payload.
+     */
+    text: string;
+}
+/**
+ * Binary resource contents encoded as base64.
+ */
+export interface BlobResourceContents {
+    /**
+     * Canonical resource URI.
+     */
+    uri: string;
+    /**
+     * Optional MIME type.
+     */
+    mimeType?: string;
+    /**
+     * Base64-encoded binary payload.
+     */
+    blob: string;
+}
+/**
+ * Resource contents returned by resource reads.
+ */
+export type ResourceContents = TextResourceContents | BlobResourceContents;
+/**
+ * Embedded resource content block.
+ */
+export interface EmbeddedResource {
+    /**
+     * Discriminator for embedded resources.
+     */
+    type: 'resource';
+    /**
+     * Inlined resource contents.
+     */
+    resource: ResourceContents;
+}
+/**
+ * Link to an externally retrievable resource.
+ */
+export interface ResourceLink {
+    /**
+     * Discriminator for resource links.
+     */
+    type: 'resource_link';
+    /**
+     * Resource URI.
+     */
+    uri: string;
+    /**
+     * Optional display name.
+     */
+    name?: string;
+    /**
+     * Optional human-readable description.
+     */
+    description?: string;
+    /**
+     * Optional MIME type hint.
+     */
+    mimeType?: string;
+}
+/**
+ * Any content block allowed in tool responses.
+ */
+export type ContentBlock = TextContent | ImageContent | AudioContent | ResourceLink | EmbeddedResource;
+/**
+ * Looser content block shape accepted by many MCP tool implementations.
+ *
+ * This keeps tool return typing practical while preserving strict content
+ * unions via {@link ContentBlock} for consumers that want discriminated checks.
+ */
+export type LooseContentBlock = Record<string, unknown> & {
+    type?: string;
+};
+/**
+ * The result returned from tool execution.
+ *
+ * @see {@link https://spec.modelcontextprotocol.io/specification/server/tools/}
+ */
+export interface CallToolResult {
+    /**
+     * Ordered content blocks to return to the model.
+     */
+    content: Array<ContentBlock | LooseContentBlock>;
+    /**
+     * Optional machine-readable payload.
+     */
+    structuredContent?: JsonObject;
+    /**
+     * Marks the result as an error response.
+     */
+    isError?: boolean;
+}
+/**
+ * Alias for {@link CallToolResult} for API consistency.
+ */
+export type ToolResponse = CallToolResult;
+/**
+ * Form-based elicitation request parameters.
+ */
+export interface ElicitationFormParams {
+    /**
+     * Elicitation mode. Omit or set to `'form'` for form input.
+     */
+    mode?: 'form';
+    /**
+     * User-facing message.
+     */
+    message: string;
+    /**
+     * Requested form schema.
+     */
+    requestedSchema: {
+        /**
+         * Root schema type.
+         */
+        type: 'object';
+        /**
+         * Field definitions.
+         */
+        properties: Record<string, InputSchema>;
+        /**
+         * Required field names.
+         */
+        required?: readonly string[];
+        /**
+         * Additional schema keywords.
+         */
+        [key: string]: unknown;
+    };
+}
+/**
+ * URL-based elicitation request parameters.
+ */
+export interface ElicitationUrlParams {
+    /**
+     * Elicitation mode.
+     */
+    mode: 'url';
+    /**
+     * User-facing message.
+     */
+    message: string;
+    /**
+     * Unique elicitation identifier.
+     */
+    elicitationId: string;
+    /**
+     * URL to open.
+     */
+    url: string;
+}
+/**
+ * Elicitation request parameters.
+ */
+export type ElicitationParams = ElicitationFormParams | ElicitationUrlParams;
+/**
+ * Result returned by an elicitation request.
+ */
+export interface ElicitationResult {
+    /**
+     * User decision.
+     */
+    action: 'accept' | 'decline' | 'cancel';
+    /**
+     * Submitted values when `action` is `'accept'`.
+     */
+    content?: Record<string, string | number | boolean | string[]>;
+}
+/**
+ * Registration handle returned by registration methods.
+ */
+export interface RegistrationHandle {
+    /**
+     * Unregisters the associated item.
+     */
+    unregister: () => void;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import type { ModelContext, ModelContextTesting } from './model-context.js';
+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';
+export type { InferArgsFromInputSchema, InferJsonSchema, JsonSchemaArray, JsonSchemaBoolean, JsonSchemaEnumValue, JsonSchemaForInference, JsonSchemaMultiType, JsonSchemaNull, JsonSchemaNumber, JsonSchemaObject, JsonSchemaPrimitiveType, JsonSchemaString, JsonSchemaType, JsonSchemaTypeArray, } from './json-schema.js';
+export type { AnyToolDescriptor, InferToolArgs, InferToolResult, ModelContext, ModelContextCore, ModelContextExtensions, ModelContextInput, ModelContextOptions, ModelContextTesting, ModelContextTestingExecuteToolOptions, ModelContextTestingPolyfillExtensions, ModelContextTestingToolInfo, ModelContextWithExtensions, ToolArgsByName, ToolByName, ToolCallEvent, ToolCallParams, ToolName, ToolResultByName, TypedModelContext, } from './model-context.js';
+export type { MaybePromise, ModelContextClient, ToolAnnotations, ToolDescriptor, ToolDescriptorFromSchema, ToolExecutionContext, ToolListItem, ToolResultFromOutputSchema, } from './tool.js';
+declare global {
+    interface Navigator {
+        /**
+         * Web Model Context API strict core surface.
+         */
+        modelContext: ModelContext;
+        /**
+         * Web Model Context testing API surface (Chromium early preview).
+         * @deprecated Prefer navigator.modelContext.callTool(...) and toolschanged events
+         * for in-page consumers. Chromium still exposes this API for testing flows.
+         */
+        modelContextTesting?: ModelContextTesting;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qCAAqC,EACrC,qCAAqC,EACrC,2BAA2B,EAC3B,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,oBAAoB,EACpB,YAAY,EACZ,0BAA0B,GAC3B,MAAM,WAAW,CAAC;AAMnB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,SAAS;QACjB;;WAEG;QACH,YAAY,EAAE,YAAY,CAAC;QAE3B;;;;WAIG;QACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;KAC3C;CACF"}