@lovable.dev/mcp-js 0.29.0-rc.0 → 0.29.0-rc.2

package/dist/{types-D1cgsnPu.d.cts → types-DnGEKnvI.d.cts}

@@ -85,16 +85,46 @@ interface McpAuthConfig {
 }
 //#endregion
 //#region src/auth/context.d.ts
-/**
- * The auth surface passed to every tool handler as its second argument. It wraps
- * the verified per-request auth context in a private field, so the context — and
- * the bearer token inside it — can't be read, enumerated, spread, or
- * `JSON.stringify`'d off the instance; the accessors below are the only way out.
- * `getToken()` is the single intentional escape hatch for the raw bearer.
- */
+/** What the client declared about itself on the in-flight request. Unverified
+ * client input — a hint, never an authorization signal (use the auth accessors). */
+interface McpClientInfo {
+  /** Protocol era of the in-flight request. */
+  protocol: "2026-07-28" | "legacy";
+  /** Client name/version from the request envelope (`2026-07-28` era only). */
+  info?: {
+    name: string;
+    version: string;
+    title?: string;
+  };
+  /** Client capabilities from the request envelope (`2026-07-28` era only). */
+  capabilities?: Record<string, unknown>;
+  /** Extension declarations (`capabilities.extensions`), keyed by extension id. */
+  extensions?: Record<string, Record<string, unknown>>;
+}
+/** A progress notification payload. `progress` should increase monotonically. */
+interface ProgressUpdate {
+  progress: number;
+  total?: number;
+  message?: string;
+}
+/** Per-request runtime surface threaded into `ToolContext` by the protocol layer. */
+interface ToolRequestContext {
+  signal?: AbortSignal;
+  client?: McpClientInfo;
+  sendProgress?: (update: ProgressUpdate) => Promise<void>;
+}
+/** The per-request context passed to every tool handler as its second argument. The
+ * auth context lives in a private field so the accessors are the only way out; `getToken()` is the sole bearer escape hatch. */
 declare class ToolContext {
   #private;
-  constructor(auth: McpAuthContext | undefined);
+  constructor(auth: McpAuthContext | undefined, request?: ToolRequestContext);
+  /** Aborts when the client cancels the request or disconnects. */
+  get signal(): AbortSignal;
+  /** What the client declared about itself on this request. Unverified input. */
+  get client(): McpClientInfo;
+  /** Send a progress notification for this call. A no-op when the client
+   * didn't request progress (no `progressToken` on the request). */
+  progress(update: ProgressUpdate): Promise<void>;
   /** Whether the in-flight tool call carries a verified auth context. */
   isAuthenticated(): boolean;
   /** The verified bearer token, or `undefined` when unauthenticated. Pass it to downstream APIs; never return or log it. */
@@ -278,10 +308,8 @@ interface ToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$
   readonly annotations?: ToolAnnotations;
   readonly handler: TInput extends ZodRawShape$1 ? (args: ShapeOutput<TInput>, ctx: ToolContext) => ToolHandlerResult | Promise<ToolHandlerResult> : (args: Record<string, never> | undefined, ctx: ToolContext) => ToolHandlerResult | Promise<ToolHandlerResult>;
 }
-/**
- * Type-erased element of `McpDefinition.tools`. Per-tool generic typing
- * happens at the `defineTool` call site; see README §6 for the rationale.
- */
+/** Type-erased element of `McpDefinition.tools`; per-tool generic typing
+ * happens at the `defineTool` call site. */
 interface AnyToolDefinition {
   readonly name: string;
   readonly title: string;
@@ -291,13 +319,8 @@ interface AnyToolDefinition {
   readonly annotations?: ToolAnnotations;
   readonly handler: (args: any, ctx: ToolContext) => ToolHandlerResult | Promise<ToolHandlerResult>;
 }
-/**
- * Fields a caller supplies when constructing an MCP definition. Pass this
- * shape to `defineMcp(...)` — its return type is the branded `McpDefinition`,
- * which is the type every internal factory (`createInvokeToolHandler`,
- * `createMcpProtocolHandler`, …) consumes. The brand forces consumers
- * through `defineMcp`'s `assertUniqueNames` + freeze.
- */
+/** Input shape for `defineMcp(...)`, whose branded `McpDefinition` return type is what
+ * `createMcpProtocolHandler` consumes — the brand forces validation + freeze. */
 interface McpDefinitionInput {
   readonly name: string;
   /** Human-readable display name shown to MCP clients. Required. */
@@ -326,4 +349,4 @@ type McpDefinition = McpDefinitionInput & {
   readonly [McpDefinitionBrand]: never;
 };
 //#endregion
-export { MetricsOptions as C, McpAuthConfig as E, MetricsConfig as S, JwtClaims as T, ToolDefinition as _, EmbeddedResource as a, ZodRawShape$1 as b, JsonValue as c, McpDefinitionInput as d, ResourceLink as f, ToolContent as g, ToolAnnotations as h, EmbeddedBlobResource as i, McpAllowedOrigins as l, TextContent as m, ContentAnnotations as n, EmbeddedTextResource as o, ResourceLinkIcon as p, ContentBlock as r, ImageContent as s, AudioContent as t, McpDefinition as u, ToolHandlerResult as v, ToolContext as w, ZodSchema as x, ZodOutputSchema as y };
+export { MetricsOptions as C, JwtClaims as D, ToolContext as E, McpAuthConfig as O, MetricsConfig as S, ProgressUpdate as T, ToolDefinition as _, EmbeddedResource as a, ZodRawShape$1 as b, JsonValue as c, McpDefinitionInput as d, ResourceLink as f, ToolContent as g, ToolAnnotations as h, EmbeddedBlobResource as i, McpAllowedOrigins as l, TextContent as m, ContentAnnotations as n, EmbeddedTextResource as o, ResourceLinkIcon as p, ContentBlock as r, ImageContent as s, AudioContent as t, McpDefinition as u, ToolHandlerResult as v, McpClientInfo as w, ZodSchema as x, ZodOutputSchema as y };

package/dist/{types-D1cgsnPu.d.ts → types-DnGEKnvI.d.ts}

@@ -85,16 +85,46 @@ interface McpAuthConfig {
 }
 //#endregion
 //#region src/auth/context.d.ts
-/**
- * The auth surface passed to every tool handler as its second argument. It wraps
- * the verified per-request auth context in a private field, so the context — and
- * the bearer token inside it — can't be read, enumerated, spread, or
- * `JSON.stringify`'d off the instance; the accessors below are the only way out.
- * `getToken()` is the single intentional escape hatch for the raw bearer.
- */
+/** What the client declared about itself on the in-flight request. Unverified
+ * client input — a hint, never an authorization signal (use the auth accessors). */
+interface McpClientInfo {
+  /** Protocol era of the in-flight request. */
+  protocol: "2026-07-28" | "legacy";
+  /** Client name/version from the request envelope (`2026-07-28` era only). */
+  info?: {
+    name: string;
+    version: string;
+    title?: string;
+  };
+  /** Client capabilities from the request envelope (`2026-07-28` era only). */
+  capabilities?: Record<string, unknown>;
+  /** Extension declarations (`capabilities.extensions`), keyed by extension id. */
+  extensions?: Record<string, Record<string, unknown>>;
+}
+/** A progress notification payload. `progress` should increase monotonically. */
+interface ProgressUpdate {
+  progress: number;
+  total?: number;
+  message?: string;
+}
+/** Per-request runtime surface threaded into `ToolContext` by the protocol layer. */
+interface ToolRequestContext {
+  signal?: AbortSignal;
+  client?: McpClientInfo;
+  sendProgress?: (update: ProgressUpdate) => Promise<void>;
+}
+/** The per-request context passed to every tool handler as its second argument. The
+ * auth context lives in a private field so the accessors are the only way out; `getToken()` is the sole bearer escape hatch. */
 declare class ToolContext {
   #private;
-  constructor(auth: McpAuthContext | undefined);
+  constructor(auth: McpAuthContext | undefined, request?: ToolRequestContext);
+  /** Aborts when the client cancels the request or disconnects. */
+  get signal(): AbortSignal;
+  /** What the client declared about itself on this request. Unverified input. */
+  get client(): McpClientInfo;
+  /** Send a progress notification for this call. A no-op when the client
+   * didn't request progress (no `progressToken` on the request). */
+  progress(update: ProgressUpdate): Promise<void>;
   /** Whether the in-flight tool call carries a verified auth context. */
   isAuthenticated(): boolean;
   /** The verified bearer token, or `undefined` when unauthenticated. Pass it to downstream APIs; never return or log it. */
@@ -278,10 +308,8 @@ interface ToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$
   readonly annotations?: ToolAnnotations;
   readonly handler: TInput extends ZodRawShape$1 ? (args: ShapeOutput<TInput>, ctx: ToolContext) => ToolHandlerResult | Promise<ToolHandlerResult> : (args: Record<string, never> | undefined, ctx: ToolContext) => ToolHandlerResult | Promise<ToolHandlerResult>;
 }
-/**
- * Type-erased element of `McpDefinition.tools`. Per-tool generic typing
- * happens at the `defineTool` call site; see README §6 for the rationale.
- */
+/** Type-erased element of `McpDefinition.tools`; per-tool generic typing
+ * happens at the `defineTool` call site. */
 interface AnyToolDefinition {
   readonly name: string;
   readonly title: string;
@@ -291,13 +319,8 @@ interface AnyToolDefinition {
   readonly annotations?: ToolAnnotations;
   readonly handler: (args: any, ctx: ToolContext) => ToolHandlerResult | Promise<ToolHandlerResult>;
 }
-/**
- * Fields a caller supplies when constructing an MCP definition. Pass this
- * shape to `defineMcp(...)` — its return type is the branded `McpDefinition`,
- * which is the type every internal factory (`createInvokeToolHandler`,
- * `createMcpProtocolHandler`, …) consumes. The brand forces consumers
- * through `defineMcp`'s `assertUniqueNames` + freeze.
- */
+/** Input shape for `defineMcp(...)`, whose branded `McpDefinition` return type is what
+ * `createMcpProtocolHandler` consumes — the brand forces validation + freeze. */
 interface McpDefinitionInput {
   readonly name: string;
   /** Human-readable display name shown to MCP clients. Required. */
@@ -326,4 +349,4 @@ type McpDefinition = McpDefinitionInput & {
   readonly [McpDefinitionBrand]: never;
 };
 //#endregion
-export { MetricsOptions as C, McpAuthConfig as E, MetricsConfig as S, JwtClaims as T, ToolDefinition as _, EmbeddedResource as a, ZodRawShape$1 as b, JsonValue as c, McpDefinitionInput as d, ResourceLink as f, ToolContent as g, ToolAnnotations as h, EmbeddedBlobResource as i, McpAllowedOrigins as l, TextContent as m, ContentAnnotations as n, EmbeddedTextResource as o, ResourceLinkIcon as p, ContentBlock as r, ImageContent as s, AudioContent as t, McpDefinition as u, ToolHandlerResult as v, ToolContext as w, ZodSchema as x, ZodOutputSchema as y };
+export { MetricsOptions as C, JwtClaims as D, ToolContext as E, McpAuthConfig as O, MetricsConfig as S, ProgressUpdate as T, ToolDefinition as _, EmbeddedResource as a, ZodRawShape$1 as b, JsonValue as c, McpDefinitionInput as d, ResourceLink as f, ToolContent as g, ToolAnnotations as h, EmbeddedBlobResource as i, McpAllowedOrigins as l, TextContent as m, ContentAnnotations as n, EmbeddedTextResource as o, ResourceLinkIcon as p, ContentBlock as r, ImageContent as s, AudioContent as t, McpDefinition as u, ToolHandlerResult as v, McpClientInfo as w, ZodSchema as x, ZodOutputSchema as y };

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "@lovable.dev/mcp-js",
-  "version": "0.29.0-rc.0",
+  "version": "0.29.0-rc.2",
+  "engines": {
+    "node": ">=20"
+  },
   "description": "Author MCP servers for Lovable apps. Declare tools with defineTool, register them in defineMcp, and a framework adapter (TanStack or Supabase Edge Functions) emits the route(s) at build time.",
   "type": "module",
   "repository": {
@@ -49,16 +52,6 @@
         "default": "./dist/protocols/oauth-metadata.cjs"
       }
     },
-    "./protocols/rest": {
-      "import": {
-        "types": "./dist/protocols/rest/index.d.ts",
-        "default": "./dist/protocols/rest/index.js"
-      },
-      "require": {
-        "types": "./dist/protocols/rest/index.d.cts",
-        "default": "./dist/protocols/rest/index.cjs"
-      }
-    },
     "./stacks/tanstack": {
       "import": {
         "types": "./dist/stacks/tanstack/index.d.ts",

package/dist/base-DSH8NnPj.d.cts

@@ -1,36 +0,0 @@
-//#region src/metrics/impl/base.d.ts
-type InvocationOutcome = "ok" | "tool_error" | "handler_error" | "transport_error" | "auth_challenge" | "auth_discovery_config_error" | "auth_discovery_unreachable" | "auth_jwks_config_error" | "auth_jwks_unreachable";
-/** One recorded MCP call. Carries no arguments or response payloads — only the
- *  tool name, the JSON-RPC method, the result class, timing, and byte sizes.
- *  `errorText` is the sole exception: it is logged locally for debugging and
- *  deliberately never included in the OTLP payload (see `emit` / `buildLogsPayload`). */
-interface InvocationRecord {
-  /** Tool name for `tools/call`; `null` for list/initialize, transport faults, and `authorize` records. */
-  tool: string | null;
-  /** JSON-RPC method, e.g. `tools/call`; `authorize` for records from the authorization gate. */
-  method: string;
-  outcome: InvocationOutcome;
-  durationMs: number;
-  reqBytes?: number;
-  resBytes?: number;
-  /** HTTP request method. Set on `auth_challenge` so probe traffic (GET vs
-   *  POST discovery) is distinguishable; absent on tool-call records. */
-  httpMethod?: string;
-  /** Wire surface that served the call: the modern stateless revision, the
-   *  initialization-era path, or the REST companion. Absent on records emitted
-   *  before protocol classification (auth gate, transport faults). */
-  protocol?: "2026-07-28" | "legacy" | "rest";
-  /** The app end-user that made the call (the access token `sub`), or
-   *  `undefined` when the request is unauthenticated. Not a Lovable identity. */
-  endUserId?: string;
-  /** Caller-visible `isError` text (`tool_error`) or a bounded internal-exception
-   *  summary (`handler_error`). Local log only — never sent to the collector. */
-  errorText?: string;
-}
-/** A per-request telemetry recorder. `emit` logs the invocation and sends it as a
- *  single OTLP POST, awaited so it lands before the request ends. */
-interface MetricsRecorder {
-  emit(ev: InvocationRecord): Promise<void>;
-}
-//#endregion
-export { MetricsRecorder as t };

package/dist/base-DSH8NnPj.d.ts

@@ -1,36 +0,0 @@
-//#region src/metrics/impl/base.d.ts
-type InvocationOutcome = "ok" | "tool_error" | "handler_error" | "transport_error" | "auth_challenge" | "auth_discovery_config_error" | "auth_discovery_unreachable" | "auth_jwks_config_error" | "auth_jwks_unreachable";
-/** One recorded MCP call. Carries no arguments or response payloads — only the
- *  tool name, the JSON-RPC method, the result class, timing, and byte sizes.
- *  `errorText` is the sole exception: it is logged locally for debugging and
- *  deliberately never included in the OTLP payload (see `emit` / `buildLogsPayload`). */
-interface InvocationRecord {
-  /** Tool name for `tools/call`; `null` for list/initialize, transport faults, and `authorize` records. */
-  tool: string | null;
-  /** JSON-RPC method, e.g. `tools/call`; `authorize` for records from the authorization gate. */
-  method: string;
-  outcome: InvocationOutcome;
-  durationMs: number;
-  reqBytes?: number;
-  resBytes?: number;
-  /** HTTP request method. Set on `auth_challenge` so probe traffic (GET vs
-   *  POST discovery) is distinguishable; absent on tool-call records. */
-  httpMethod?: string;
-  /** Wire surface that served the call: the modern stateless revision, the
-   *  initialization-era path, or the REST companion. Absent on records emitted
-   *  before protocol classification (auth gate, transport faults). */
-  protocol?: "2026-07-28" | "legacy" | "rest";
-  /** The app end-user that made the call (the access token `sub`), or
-   *  `undefined` when the request is unauthenticated. Not a Lovable identity. */
-  endUserId?: string;
-  /** Caller-visible `isError` text (`tool_error`) or a bounded internal-exception
-   *  summary (`handler_error`). Local log only — never sent to the collector. */
-  errorText?: string;
-}
-/** A per-request telemetry recorder. `emit` logs the invocation and sends it as a
- *  single OTLP POST, awaited so it lands before the request ends. */
-interface MetricsRecorder {
-  emit(ev: InvocationRecord): Promise<void>;
-}
-//#endregion
-export { MetricsRecorder as t };

package/dist/gate-n_HX6eQ5.cjs

@@ -1,26 +0,0 @@
-const require_cors = require("./cors-CmKzDN7k.cjs");
-//#region src/protocols/gate.ts
-function createGatedHandler(gate) {
-	const allow = [...gate.methods, "OPTIONS"].join(", ");
-	const respond = async (request, recorder, ...extra) => {
-		const authResult = await gate.authorizer.authorize(request, recorder);
-		if (!authResult.ok) return authResult.response;
-		if (!gate.methods.includes(request.method)) return gate.methodNotAllowed(allow);
-		return gate.handle(request, authResult, recorder, ...extra);
-	};
-	return async (request, recorder = require_cors.createNoopRecorder(), ...extra) => {
-		const cors = require_cors.evaluateCors(request, gate.allowedOrigins);
-		if (!cors.ok) return require_cors.finalizeWireResponse(request, cors.response);
-		if (request.method === "OPTIONS") return cors.preflight(allow);
-		const final = require_cors.finalizeWireResponse(request, cors.withHeaders(await respond(request, recorder, ...extra)));
-		if (!final.headers.has("Cache-Control")) final.headers.set("Cache-Control", "no-store");
-		return final;
-	};
-}
-//#endregion
-Object.defineProperty(exports, "createGatedHandler", {
-	enumerable: true,
-	get: function() {
-		return createGatedHandler;
-	}
-});

package/dist/gate-pGsVlY_4.js

@@ -1,21 +0,0 @@
-import { f as finalizeWireResponse, l as createNoopRecorder, t as evaluateCors } from "./cors-D4YbODs-.js";
-//#region src/protocols/gate.ts
-function createGatedHandler(gate) {
-	const allow = [...gate.methods, "OPTIONS"].join(", ");
-	const respond = async (request, recorder, ...extra) => {
-		const authResult = await gate.authorizer.authorize(request, recorder);
-		if (!authResult.ok) return authResult.response;
-		if (!gate.methods.includes(request.method)) return gate.methodNotAllowed(allow);
-		return gate.handle(request, authResult, recorder, ...extra);
-	};
-	return async (request, recorder = createNoopRecorder(), ...extra) => {
-		const cors = evaluateCors(request, gate.allowedOrigins);
-		if (!cors.ok) return finalizeWireResponse(request, cors.response);
-		if (request.method === "OPTIONS") return cors.preflight(allow);
-		const final = finalizeWireResponse(request, cors.withHeaders(await respond(request, recorder, ...extra)));
-		if (!final.headers.has("Cache-Control")) final.headers.set("Cache-Control", "no-store");
-		return final;
-	};
-}
-//#endregion
-export { createGatedHandler as t };

package/dist/list-tools-Dkyyje7j.cjs

@@ -1,48 +0,0 @@
-const require_schema = require("./schema-D3vClxb7.cjs");
-const require_cors = require("./cors-CmKzDN7k.cjs");
-const require_gate = require("./gate-n_HX6eQ5.cjs");
-//#region src/protocols/rest/list-tools.ts
-function schemaToJsonSchema(definition, pipeStrategy) {
-	if (!definition) return null;
-	return require_schema.jsonSchemaFromDefinition(definition, pipeStrategy);
-}
-function buildMcpListing(mcp) {
-	return {
-		server: {
-			name: mcp.name,
-			version: mcp.version,
-			title: mcp.title
-		},
-		tools: mcp.tools.map((tool) => ({
-			name: tool.name,
-			title: tool.title,
-			description: tool.description,
-			annotations: tool.annotations,
-			inputSchema: schemaToJsonSchema(tool.inputSchema, "input"),
-			outputSchema: schemaToJsonSchema(tool.outputSchema, "output")
-		}))
-	};
-}
-function createListToolsHandler(mcp, options = {}) {
-	require_cors.assertRestResourceBinding(mcp, options);
-	return require_gate.createGatedHandler({
-		authorizer: require_cors.createRequestAuthorizer(mcp, options),
-		allowedOrigins: mcp.allowedOrigins,
-		methods: ["GET", "HEAD"],
-		methodNotAllowed: require_cors.methodNotAllowed,
-		handle: async () => Response.json(buildMcpListing(mcp))
-	});
-}
-//#endregion
-Object.defineProperty(exports, "buildMcpListing", {
-	enumerable: true,
-	get: function() {
-		return buildMcpListing;
-	}
-});
-Object.defineProperty(exports, "createListToolsHandler", {
-	enumerable: true,
-	get: function() {
-		return createListToolsHandler;
-	}
-});

package/dist/list-tools-ePP9tXND.js

@@ -1,37 +0,0 @@
-import { t as jsonSchemaFromDefinition } from "./schema-CW1jKvio.js";
-import { n as assertRestResourceBinding, p as methodNotAllowed, r as createRequestAuthorizer } from "./cors-D4YbODs-.js";
-import { t as createGatedHandler } from "./gate-pGsVlY_4.js";
-//#region src/protocols/rest/list-tools.ts
-function schemaToJsonSchema(definition, pipeStrategy) {
-	if (!definition) return null;
-	return jsonSchemaFromDefinition(definition, pipeStrategy);
-}
-function buildMcpListing(mcp) {
-	return {
-		server: {
-			name: mcp.name,
-			version: mcp.version,
-			title: mcp.title
-		},
-		tools: mcp.tools.map((tool) => ({
-			name: tool.name,
-			title: tool.title,
-			description: tool.description,
-			annotations: tool.annotations,
-			inputSchema: schemaToJsonSchema(tool.inputSchema, "input"),
-			outputSchema: schemaToJsonSchema(tool.outputSchema, "output")
-		}))
-	};
-}
-function createListToolsHandler(mcp, options = {}) {
-	assertRestResourceBinding(mcp, options);
-	return createGatedHandler({
-		authorizer: createRequestAuthorizer(mcp, options),
-		allowedOrigins: mcp.allowedOrigins,
-		methods: ["GET", "HEAD"],
-		methodNotAllowed,
-		handle: async () => Response.json(buildMcpListing(mcp))
-	});
-}
-//#endregion
-export { createListToolsHandler as n, buildMcpListing as t };

package/dist/list-tools-qIvVJeWZ.d.ts

@@ -1,8 +0,0 @@
-import { u as McpDefinition } from "./types-D1cgsnPu.js";
-import { t as MetricsRecorder } from "./base-DSH8NnPj.js";
-import { t as McpRuntimeOptions } from "./authorize-BjNE3LPr.js";
-//#region src/protocols/rest/list-tools.d.ts
-type RestListToolsHandler = (request: Request, recorder?: MetricsRecorder) => Promise<Response>;
-declare function createListToolsHandler(mcp: McpDefinition, options?: McpRuntimeOptions): RestListToolsHandler;
-//#endregion
-export { createListToolsHandler as n, RestListToolsHandler as t };

package/dist/list-tools-zagoI477.d.cts

@@ -1,8 +0,0 @@
-import { u as McpDefinition } from "./types-D1cgsnPu.cjs";
-import { t as MetricsRecorder } from "./base-DSH8NnPj.cjs";
-import { t as McpRuntimeOptions } from "./authorize-BzZFS0zi.cjs";
-//#region src/protocols/rest/list-tools.d.ts
-type RestListToolsHandler = (request: Request, recorder?: MetricsRecorder) => Promise<Response>;
-declare function createListToolsHandler(mcp: McpDefinition, options?: McpRuntimeOptions): RestListToolsHandler;
-//#endregion
-export { createListToolsHandler as n, RestListToolsHandler as t };