@lovable.dev/mcp-js 2.1.0-rc.0 → 2.2.0-rc.0

package/README.md

@@ -216,21 +216,29 @@ The SDK only uses discovery + JWKS. It never calls the authorization or token en
 
 Tool handlers receive their input args plus a `ToolContext` as the second
 argument. The SDK constructs one per request from the verified token and passes
-it to the handler; helpers that need the auth take a `ToolContext` parameter, so
-the dependency is explicit in their signatures.
+it to the handler. `ToolContext` extends `AuthContext`, which is also what
+`createAppContext` receives as `auth`; helpers that need the auth should take an
+`AuthContext` parameter so both call sites can share them.
 
 ```ts
-import type { ToolContext } from "@lovable.dev/mcp-js";
+import type { AuthContext } from "@lovable.dev/mcp-js";
+
+// Usable from tool handlers (`ctx`) and from `createAppContext` (`auth`).
+function requireUserId(auth: AuthContext): string {
+  const userId = auth.getUserId(); // token `sub`, or undefined when unauthenticated
+  if (!userId) throw new Error("Authenticated caller required");
+  return userId;
+}
 
 handler: async ({ title }, ctx) => {
-  const userId = ctx.getUserId();  // token `sub`, or undefined when unauthenticated
+  const userId = requireUserId(ctx);
   // Apply app/business permissions here using ctx.getClaims() / ctx.getClientId().
   // For Supabase RLS, pass ctx.getToken() through to Supabase.
   return { content: [{ type: "text", text: `user=${userId}` }] };
 };
 ```
 
-| `ToolContext` method | Returns |
+| `AuthContext` method (inherited by `ToolContext`) | Returns |
 | --- | --- |
 | `isAuthenticated()` | `true` when the call carries a verified auth context. |
 | `getUserId()` | The token `sub` (subject) — the user id. |
@@ -338,11 +346,11 @@ setLogLevel("debug"); // "silent" | "error" | "warn" | "info" | "debug"
 LOVABLE_MCP_LOG_LEVEL=debug
 ```
 
-A `500` on an OAuth-protected route is always one of two causes, logged at `error`: an `OAuthConfigurationError` from issuer-metadata discovery or a JWKS *fetch* failure (`oauth.discovery.config_error` / `oauth.jwks.fetch_failed` → `auth.config_error`), or a transport-level fault in the MCP handler (`mcp.transport_error`). Auth outcomes are logged at `info`: a granted request as `oauth.verify.ok`, a request with no parseable bearer as `auth.no_bearer_token`, and a rejected token as `auth.token_rejected` (a `jose` rejection such as an expired token carries the `jose` error name and code; the full reason appears at `debug` as `oauth.verify.rejected`) — so a request rejected for insufficient scope shows both `oauth.verify.ok` and the `auth.token_rejected` that follows it. A sustained flood of `auth.token_rejected` whose `code` is `ERR_JOSE_NOT_SUPPORTED` or `ERR_JOSE_ALG_NOT_ALLOWED` (rather than `ERR_JWT_EXPIRED`) points at server-side key or algorithm configuration, not client error.
+A `500` on an OAuth-protected route is always one of three causes, logged at `error`: an `OAuthConfigurationError` from issuer-metadata discovery or a JWKS *fetch* failure (`oauth.discovery.config_error` / `oauth.jwks.fetch_failed` → `auth.config_error`), a throw from the app's own `createAppContext` or an `enabled` predicate (`mcp.app_context_error`, carrying that error's name and message), or a transport-level fault in the MCP handler (`mcp.transport_error`). Auth outcomes are logged at `info`: a granted request as `oauth.verify.ok`, a request with no parseable bearer as `auth.no_bearer_token`, and a rejected token as `auth.token_rejected` (a `jose` rejection such as an expired token carries the `jose` error name and code; the full reason appears at `debug` as `oauth.verify.rejected`) — so a request rejected for insufficient scope shows both `oauth.verify.ok` and the `auth.token_rejected` that follows it. A sustained flood of `auth.token_rejected` whose `code` is `ERR_JOSE_NOT_SUPPORTED` or `ERR_JOSE_ALG_NOT_ALLOWED` (rather than `ERR_JWT_EXPIRED`) points at server-side key or algorithm configuration, not client error.
 
 ## Usage metrics
 
-Each MCP server records per-invocation telemetry — tool name, JSON-RPC method, outcome, latency, request and response sizes when available, and the verified token `sub` for authenticated calls — as **OTLP/HTTP JSON logs**, one awaited POST per record, bounded by a 3-second timeout; a failed or slow POST is logged (`metrics.failed`) and swallowed, never failing the request. Outcomes cover tool results (`ok`, `tool_error`, `handler_error`, `transport_error`), the authorization gate — `auth_challenge` for an unauthenticated request answered with the `401` challenge (so probe traffic produces records), and the `auth_*` discovery/JWKS failure outcomes — and `origin_rejected` for a request refused `403` by the origin policy. Tool-call records also carry the protocol era (`mcp.protocol`: `2026-07-28` or `legacy`); records emitted before protocol classification (auth challenges, transport errors, origin rejections) have no protocol attribute. The bearer token, full claims, tool arguments, and response payloads are never captured. Emission is **on by default** and self-disables at runtime when `LOVABLE_API_KEY` is absent: records are dropped and one `metrics.disabled_no_api_key` warning is logged per process, so a local `vite dev` stays quiet. With `metrics: false` the recorder never runs — on Deno and Cloudflare Workers that also means `LOVABLE_MCP_LOG_LEVEL` is never applied (use `setLogLevel()` instead).
+Each MCP server records per-invocation telemetry — tool name, JSON-RPC method, outcome, latency, request and response sizes when available, and the verified token `sub` for authenticated calls — as **OTLP/HTTP JSON logs**, one awaited POST per record, bounded by a 3-second timeout; a failed or slow POST is logged (`metrics.failed`) and swallowed, never failing the request. Outcomes cover tool results (`ok`, `tool_error`, `handler_error`, `transport_error`), `app_context_error` for a request failed by a throwing `createAppContext` or `enabled`, the authorization gate — `auth_challenge` for an unauthenticated request answered with the `401` challenge (so probe traffic produces records), and the `auth_*` discovery/JWKS failure outcomes — and `origin_rejected` for a request refused `403` by the origin policy. Tool-call records also carry the protocol era (`mcp.protocol`: `2026-07-28` or `legacy`); records emitted before protocol classification (auth challenges, transport errors, origin rejections) have no protocol attribute. The bearer token, full claims, tool arguments, and response payloads are never captured. Emission is **on by default** and self-disables at runtime when `LOVABLE_API_KEY` is absent: records are dropped and one `metrics.disabled_no_api_key` warning is logged per process, so a local `vite dev` stays quiet. With `metrics: false` the recorder never runs — on Deno and Cloudflare Workers that also means `LOVABLE_MCP_LOG_LEVEL` is never applied (use `setLogLevel()` instead).
 
 Configure it on the MCP definition:
 

package/dist/{authorize-BC4TM__8.d.cts → authorize-BmYO5_-I.d.cts}

@@ -1,4 +1,4 @@
-import "./types-S6J_QTXw.cjs";
+import "./types-BCKyT2wb.cjs";
 //#region src/metrics/recorder.d.ts
 type ScheduleBackground = (task: Promise<unknown>) => void;
 //#endregion

package/dist/{authorize-DEsM-zTN.d.ts → authorize-d9-8n9u3.d.ts}

@@ -1,4 +1,4 @@
-import "./types-S6J_QTXw.js";
+import "./types-BCKyT2wb.js";
 //#region src/metrics/recorder.d.ts
 type ScheduleBackground = (task: Promise<unknown>) => void;
 //#endregion

package/dist/{base-BnlJz6TE.d.ts → base-BAxrhVjq.d.ts}

@@ -1,4 +1,4 @@
-import { A as McpProtocolEra } from "./types-S6J_QTXw.js";
+import { j as McpProtocolEra } from "./types-BCKyT2wb.js";
 //#region src/metrics/impl/base.d.ts
 type InvocationOutcome = "ok" | "tool_error" | "handler_error" | "transport_error" | "app_context_error" | "auth_challenge" | "origin_rejected" | "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

package/dist/{base-4G2k3bMl.d.cts → base-Bmw6Wrb-.d.cts}

@@ -1,4 +1,4 @@
-import { A as McpProtocolEra } from "./types-S6J_QTXw.cjs";
+import { j as McpProtocolEra } from "./types-BCKyT2wb.cjs";
 //#region src/metrics/impl/base.d.ts
 type InvocationOutcome = "ok" | "tool_error" | "handler_error" | "transport_error" | "app_context_error" | "auth_challenge" | "origin_rejected" | "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

package/dist/cli/extract-manifest.cjs

@@ -4,7 +4,7 @@ const projectRoot = process.argv[2] ?? process.cwd();
 import("zod/v3").catch((err) => {
 	const message = err instanceof Error ? err.message : String(err);
 	throw new Error(`@lovable.dev/mcp-js requires zod ^3.25 or ^4.0 to extract MCP schemas. Verify the project's zod dependency and package resolution, then try again. Underlying error: ${message}`);
-}).then(() => Promise.resolve().then(() => require("../io-Cz81GsrM.cjs"))).then(({ runExtract }) => runExtract(projectRoot)).catch((err) => {
+}).then(() => Promise.resolve().then(() => require("../io-DaqblVaG.cjs"))).then(({ runExtract }) => runExtract(projectRoot)).catch((err) => {
 	console.error(err instanceof Error ? err.message : String(err));
 	process.exit(1);
 });

package/dist/cli/extract-manifest.js

@@ -4,7 +4,7 @@ const projectRoot = process.argv[2] ?? process.cwd();
 import("zod/v3").catch((err) => {
 	const message = err instanceof Error ? err.message : String(err);
 	throw new Error(`@lovable.dev/mcp-js requires zod ^3.25 or ^4.0 to extract MCP schemas. Verify the project's zod dependency and package resolution, then try again. Underlying error: ${message}`);
-}).then(() => import("../io-BEoJ_gb5.js")).then(({ runExtract }) => runExtract(projectRoot)).catch((err) => {
+}).then(() => import("../io-DD8wjGjd.js")).then(({ runExtract }) => runExtract(projectRoot)).catch((err) => {
 	console.error(err instanceof Error ? err.message : String(err));
 	process.exit(1);
 });

package/dist/{cors-D4BjUpgU.js → cors-BfacizN-.js}

@@ -1,5 +1,5 @@
-import { i as log, n as applyLogLevelFromEnv, o as parseSafeUrl, r as describeError, s as trimTrailingSlash, t as LOG_LEVEL_ENV_VAR, u as resolveMetricsConfig } from "./logger-Ctv5xUSD.js";
-import { t as version } from "./package-BAYb-3dX.js";
+import { i as log, n as applyLogLevelFromEnv, o as parseSafeUrl, r as describeError, s as trimTrailingSlash, t as LOG_LEVEL_ENV_VAR, u as resolveMetricsConfig } from "./logger-CpLgYbCG.js";
+import { t as version } from "./package-cPx-zYIb.js";
 import "./metadata-path-CAkNcfyY.js";
 import { createLocalJWKSet, decodeProtectedHeader, errors, jwtVerify } from "jose";
 //#region src/core/http.ts

package/dist/{cors-0ZCwmwyK.cjs → cors-Dm9Yn8E5.cjs}

@@ -1,5 +1,5 @@
-const require_logger = require("./logger-CN1q-KNn.cjs");
-const require_package = require("./package-DlouusYQ.cjs");
+const require_logger = require("./logger-C-Hdu57K.cjs");
+const require_package = require("./package-hWM0Ru0w.cjs");
 require("./metadata-path-zd7NSNoa.cjs");
 let jose = require("jose");
 //#region src/core/http.ts

package/dist/{errors-CdrGi5aP.cjs → errors-CpTdzogX.cjs}

@@ -1,4 +1,4 @@
-const require_logger = require("./logger-CN1q-KNn.cjs");
+const require_logger = require("./logger-C-Hdu57K.cjs");
 const require_schema = require("./schema-D3vClxb7.cjs");
 //#region src/core/define.ts
 function toolRequiresAppContext(tool) {
@@ -118,7 +118,6 @@ function assertToolSchemas(mcp) {
 		}
 	}
 }
-/** Bind app context once while retaining input/output inference for every tool. */
 const defineStaticTool = (def) => def;
 const defineTool = Object.assign(defineStaticTool, { withAppContext: () => (def) => {
 	return {

package/dist/{errors-DTvfh8lb.js → errors-DGcJ8jPK.js}

@@ -1,4 +1,4 @@
-import { o as parseSafeUrl, s as trimTrailingSlash, u as resolveMetricsConfig } from "./logger-Ctv5xUSD.js";
+import { o as parseSafeUrl, s as trimTrailingSlash, u as resolveMetricsConfig } from "./logger-CpLgYbCG.js";
 import { t as jsonSchemaFromDefinition } from "./schema-CW1jKvio.js";
 //#region src/core/define.ts
 function toolRequiresAppContext(tool) {
@@ -118,7 +118,6 @@ function assertToolSchemas(mcp) {
 		}
 	}
 }
-/** Bind app context once while retaining input/output inference for every tool. */
 const defineStaticTool = (def) => def;
 const defineTool = Object.assign(defineStaticTool, { withAppContext: () => (def) => {
 	return {

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_logger = require("./logger-CN1q-KNn.cjs");
-const require_errors = require("./errors-CdrGi5aP.cjs");
+const require_logger = require("./logger-C-Hdu57K.cjs");
+const require_errors = require("./errors-CpTdzogX.cjs");
 //#region src/auth/config.ts
 function frozenArray(value) {
 	return value === void 0 ? void 0 : Object.freeze([...value]);

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { A as McpProtocolEra, C as ZodOutputSchema, D as MetricsOptions, E as MetricsConfig, M as ToolContext, N as JwtClaims, O as AuthContext, P as McpAuthConfig, S as ToolVisibilityContext, T as ZodSchema, _ as TextContent, a as CreateAppContextInput, b as ToolDefinition, c as EmbeddedTextResource, d as JsonValueInput, f as McpAllowedOrigins, g as ResourceLinkIcon, h as ResourceLink, i as ContentBlock, j as ProgressUpdate, k as McpClientInfo, l as ImageContent, m as McpDefinitionInput, n as AudioContent, o as EmbeddedBlobResource, p as McpDefinition, r as ContentAnnotations, s as EmbeddedResource, t as AppContextToolDefinition, u as JsonValue, v as ToolAnnotations, w as ZodRawShape, x as ToolHandlerResult, y as ToolContent } from "./types-S6J_QTXw.cjs";
+import { A as McpClientInfo, C as ToolVisibilityContext, D as MetricsConfig, E as ZodSchema, F as McpAuthConfig, M as ProgressUpdate, N as ToolContext, O as MetricsOptions, P as JwtClaims, S as ToolHandlerResult, T as ZodRawShape, _ as ResourceLinkIcon, a as ContentBlock, b as ToolContent, c as EmbeddedResource, d as JsonValue, f as JsonValueInput, g as ResourceLink, h as McpDefinitionInput, i as ContentAnnotations, j as McpProtocolEra, k as AuthContext, l as EmbeddedTextResource, m as McpDefinition, n as AppContextToolDefinitionInput, o as CreateAppContextInput, p as McpAllowedOrigins, r as AudioContent, s as EmbeddedBlobResource, t as AppContextToolDefinition, u as ImageContent, v as TextContent, w as ZodOutputSchema, x as ToolDefinition, y as ToolAnnotations } from "./types-BCKyT2wb.cjs";
 //#region src/core/define.d.ts
 /**
  * Declare a single MCP tool. Import the result into your MCP definition's
@@ -9,12 +9,9 @@ import { A as McpProtocolEra, C as ZodOutputSchema, D as MetricsOptions, E as Me
  * and the raw shape is what the JSON-RPC `tools/list` payload exposes.
  */
 interface DefineTool {
-  <TInput extends ZodRawShape | undefined = undefined, TOutput extends ZodOutputSchema | undefined = undefined>(def: Omit<ToolDefinition<TInput, TOutput>, "enabled"> & {
-    readonly enabled?: never;
-  }): Omit<ToolDefinition<TInput, TOutput>, "enabled"> & {
-    readonly enabled?: never;
-  };
-  withAppContext<TAppContext>(): <TInput extends ZodRawShape | undefined = undefined, TOutput extends ZodOutputSchema | undefined = undefined>(def: ToolDefinition<TInput, TOutput, TAppContext>) => AppContextToolDefinition<TInput, TOutput, TAppContext>;
+  <TInput extends ZodRawShape | undefined = undefined, TOutput extends ZodOutputSchema | undefined = undefined>(def: ToolDefinition<TInput, TOutput>): ToolDefinition<TInput, TOutput>;
+  /** Bind app context once while retaining input/output inference for every tool. */
+  withAppContext<TAppContext>(): <TInput extends ZodRawShape | undefined = undefined, TOutput extends ZodOutputSchema | undefined = undefined>(def: AppContextToolDefinitionInput<TInput, TOutput, TAppContext>) => AppContextToolDefinition<TInput, TOutput, TAppContext>;
 }
 declare const defineTool: DefineTool;
 /**
@@ -79,4 +76,4 @@ type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
  */
 declare function setLogLevel(level: LogLevel): LogLevel;
 //#endregion
-export { type AppContextToolDefinition, type AudioContent, AuthContext, type ContentAnnotations, type ContentBlock, type CreateAppContextInput, type EmbeddedBlobResource, type EmbeddedResource, type EmbeddedTextResource, type ImageContent, type IssuerOAuthOptions, type JsonValue, type JsonValueInput, type JwtClaims, type LogLevel, type McpAllowedOrigins, type McpClientInfo, type McpDefinitionInput, type McpProtocolEra, type MetricsConfig, type MetricsOptions, type ProgressUpdate, type ResourceLink, type ResourceLinkIcon, type TextContent, type ToolAnnotations, type ToolContent, ToolContext, type ToolDefinition, ToolError, type ToolHandlerResult, type ToolVisibilityContext, type ZodOutputSchema, type ZodRawShape, type ZodSchema, auth, defineMcp, defineTool, setLogLevel };
+export { type AppContextToolDefinition, type AppContextToolDefinitionInput, type AudioContent, AuthContext, type ContentAnnotations, type ContentBlock, type CreateAppContextInput, type EmbeddedBlobResource, type EmbeddedResource, type EmbeddedTextResource, type ImageContent, type IssuerOAuthOptions, type JsonValue, type JsonValueInput, type JwtClaims, type LogLevel, type McpAllowedOrigins, type McpClientInfo, type McpDefinitionInput, type McpProtocolEra, type MetricsConfig, type MetricsOptions, type ProgressUpdate, type ResourceLink, type ResourceLinkIcon, type TextContent, type ToolAnnotations, type ToolContent, ToolContext, type ToolDefinition, ToolError, type ToolHandlerResult, type ToolVisibilityContext, type ZodOutputSchema, type ZodRawShape, type ZodSchema, auth, defineMcp, defineTool, setLogLevel };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { A as McpProtocolEra, C as ZodOutputSchema, D as MetricsOptions, E as MetricsConfig, M as ToolContext, N as JwtClaims, O as AuthContext, P as McpAuthConfig, S as ToolVisibilityContext, T as ZodSchema, _ as TextContent, a as CreateAppContextInput, b as ToolDefinition, c as EmbeddedTextResource, d as JsonValueInput, f as McpAllowedOrigins, g as ResourceLinkIcon, h as ResourceLink, i as ContentBlock, j as ProgressUpdate, k as McpClientInfo, l as ImageContent, m as McpDefinitionInput, n as AudioContent, o as EmbeddedBlobResource, p as McpDefinition, r as ContentAnnotations, s as EmbeddedResource, t as AppContextToolDefinition, u as JsonValue, v as ToolAnnotations, w as ZodRawShape, x as ToolHandlerResult, y as ToolContent } from "./types-S6J_QTXw.js";
+import { A as McpClientInfo, C as ToolVisibilityContext, D as MetricsConfig, E as ZodSchema, F as McpAuthConfig, M as ProgressUpdate, N as ToolContext, O as MetricsOptions, P as JwtClaims, S as ToolHandlerResult, T as ZodRawShape, _ as ResourceLinkIcon, a as ContentBlock, b as ToolContent, c as EmbeddedResource, d as JsonValue, f as JsonValueInput, g as ResourceLink, h as McpDefinitionInput, i as ContentAnnotations, j as McpProtocolEra, k as AuthContext, l as EmbeddedTextResource, m as McpDefinition, n as AppContextToolDefinitionInput, o as CreateAppContextInput, p as McpAllowedOrigins, r as AudioContent, s as EmbeddedBlobResource, t as AppContextToolDefinition, u as ImageContent, v as TextContent, w as ZodOutputSchema, x as ToolDefinition, y as ToolAnnotations } from "./types-BCKyT2wb.js";
 //#region src/core/define.d.ts
 /**
  * Declare a single MCP tool. Import the result into your MCP definition's
@@ -9,12 +9,9 @@ import { A as McpProtocolEra, C as ZodOutputSchema, D as MetricsOptions, E as Me
  * and the raw shape is what the JSON-RPC `tools/list` payload exposes.
  */
 interface DefineTool {
-  <TInput extends ZodRawShape | undefined = undefined, TOutput extends ZodOutputSchema | undefined = undefined>(def: Omit<ToolDefinition<TInput, TOutput>, "enabled"> & {
-    readonly enabled?: never;
-  }): Omit<ToolDefinition<TInput, TOutput>, "enabled"> & {
-    readonly enabled?: never;
-  };
-  withAppContext<TAppContext>(): <TInput extends ZodRawShape | undefined = undefined, TOutput extends ZodOutputSchema | undefined = undefined>(def: ToolDefinition<TInput, TOutput, TAppContext>) => AppContextToolDefinition<TInput, TOutput, TAppContext>;
+  <TInput extends ZodRawShape | undefined = undefined, TOutput extends ZodOutputSchema | undefined = undefined>(def: ToolDefinition<TInput, TOutput>): ToolDefinition<TInput, TOutput>;
+  /** Bind app context once while retaining input/output inference for every tool. */
+  withAppContext<TAppContext>(): <TInput extends ZodRawShape | undefined = undefined, TOutput extends ZodOutputSchema | undefined = undefined>(def: AppContextToolDefinitionInput<TInput, TOutput, TAppContext>) => AppContextToolDefinition<TInput, TOutput, TAppContext>;
 }
 declare const defineTool: DefineTool;
 /**
@@ -79,4 +76,4 @@ type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
  */
 declare function setLogLevel(level: LogLevel): LogLevel;
 //#endregion
-export { type AppContextToolDefinition, type AudioContent, AuthContext, type ContentAnnotations, type ContentBlock, type CreateAppContextInput, type EmbeddedBlobResource, type EmbeddedResource, type EmbeddedTextResource, type ImageContent, type IssuerOAuthOptions, type JsonValue, type JsonValueInput, type JwtClaims, type LogLevel, type McpAllowedOrigins, type McpClientInfo, type McpDefinitionInput, type McpProtocolEra, type MetricsConfig, type MetricsOptions, type ProgressUpdate, type ResourceLink, type ResourceLinkIcon, type TextContent, type ToolAnnotations, type ToolContent, ToolContext, type ToolDefinition, ToolError, type ToolHandlerResult, type ToolVisibilityContext, type ZodOutputSchema, type ZodRawShape, type ZodSchema, auth, defineMcp, defineTool, setLogLevel };
+export { type AppContextToolDefinition, type AppContextToolDefinitionInput, type AudioContent, AuthContext, type ContentAnnotations, type ContentBlock, type CreateAppContextInput, type EmbeddedBlobResource, type EmbeddedResource, type EmbeddedTextResource, type ImageContent, type IssuerOAuthOptions, type JsonValue, type JsonValueInput, type JwtClaims, type LogLevel, type McpAllowedOrigins, type McpClientInfo, type McpDefinitionInput, type McpProtocolEra, type MetricsConfig, type MetricsOptions, type ProgressUpdate, type ResourceLink, type ResourceLinkIcon, type TextContent, type ToolAnnotations, type ToolContent, ToolContext, type ToolDefinition, ToolError, type ToolHandlerResult, type ToolVisibilityContext, type ZodOutputSchema, type ZodRawShape, type ZodSchema, auth, defineMcp, defineTool, setLogLevel };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { a as setLogLevel } from "./logger-Ctv5xUSD.js";
-import { a as ToolContext, i as AuthContext, o as defineMcp, s as defineTool, t as ToolError } from "./errors-DTvfh8lb.js";
+import { a as setLogLevel } from "./logger-CpLgYbCG.js";
+import { a as ToolContext, i as AuthContext, o as defineMcp, s as defineTool, t as ToolError } from "./errors-DGcJ8jPK.js";
 //#region src/auth/config.ts
 function frozenArray(value) {
 	return value === void 0 ? void 0 : Object.freeze([...value]);

package/dist/{io-BLZ8jYW6.d.ts → io-7U860POB.d.ts}

@@ -1,4 +1,4 @@
-import "./types-S6J_QTXw.js";
+import "./types-BCKyT2wb.js";
 //#region src/manifest/io.d.ts
 /**
  * Shape every MCP Vite plugin exposes on its `api` so `runExtract` can read

package/dist/{io-9jGNgPfl.d.cts → io-CL1GeE3D.d.cts}

@@ -1,4 +1,4 @@
-import "./types-S6J_QTXw.cjs";
+import "./types-BCKyT2wb.cjs";
 //#region src/manifest/io.d.ts
 /**
  * Shape every MCP Vite plugin exposes on its `api` so `runExtract` can read

package/dist/{io-BEoJ_gb5.js → io-DD8wjGjd.js}

@@ -1,5 +1,5 @@
 import { t as jsonSchemaFromDefinition } from "./schema-CW1jKvio.js";
-import { t as version } from "./package-BAYb-3dX.js";
+import { t as version } from "./package-cPx-zYIb.js";
 import { t as isFileMissing } from "./fs-errors-PA2t1TIp.js";
 import { lstatSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";

package/dist/{io-Cz81GsrM.cjs → io-DaqblVaG.cjs}

@@ -1,5 +1,5 @@
 const require_schema = require("./schema-D3vClxb7.cjs");
-const require_package = require("./package-DlouusYQ.cjs");
+const require_package = require("./package-hWM0Ru0w.cjs");
 const require_fs_errors = require("./fs-errors-CWNzOV75.cjs");
 let node_fs = require("node:fs");
 let node_path = require("node:path");

package/dist/{logger-CN1q-KNn.cjs → logger-C-Hdu57K.cjs}

@@ -139,7 +139,11 @@ function describeError(err) {
 			...typeof code === "string" ? { code } : {}
 		};
 	}
-	return { value: String(err) };
+	try {
+		return { value: String(err) };
+	} catch {
+		return { value: "[unprintable object]" };
+	}
 }
 //#endregion
 Object.defineProperty(exports, "DEFAULT_METRICS_ENDPOINT", {

package/dist/{logger-Ctv5xUSD.js → logger-CpLgYbCG.js}

@@ -139,7 +139,11 @@ function describeError(err) {
 			...typeof code === "string" ? { code } : {}
 		};
 	}
-	return { value: String(err) };
+	try {
+		return { value: String(err) };
+	} catch {
+		return { value: "[unprintable object]" };
+	}
 }
 //#endregion
 export { setLogLevel as a, DEFAULT_METRICS_ENDPOINT as c, log as i, LEGACY_METRICS_ENDPOINT as l, applyLogLevelFromEnv as n, parseSafeUrl as o, describeError as r, trimTrailingSlash as s, LOG_LEVEL_ENV_VAR as t, resolveMetricsConfig as u };

package/dist/{mcp-Q_rjpR99.cjs → mcp-BGsPYWs1.cjs}

@@ -1,7 +1,7 @@
-const require_logger = require("./logger-CN1q-KNn.cjs");
+const require_logger = require("./logger-C-Hdu57K.cjs");
 const require_schema = require("./schema-D3vClxb7.cjs");
-const require_errors = require("./errors-CdrGi5aP.cjs");
-const require_cors = require("./cors-0ZCwmwyK.cjs");
+const require_errors = require("./errors-CpTdzogX.cjs");
+const require_cors = require("./cors-Dm9Yn8E5.cjs");
 let _modelcontextprotocol_sdk_server_zod_compat_js = require("@modelcontextprotocol/sdk/server/zod-compat.js");
 let _modelcontextprotocol_server = require("@modelcontextprotocol/server");
 //#region src/core/content.ts

package/dist/{mcp-CuHyVOZK.js → mcp-DdJJjYYZ.js}

@@ -1,7 +1,7 @@
-import { i as log, r as describeError } from "./logger-Ctv5xUSD.js";
+import { i as log, r as describeError } from "./logger-CpLgYbCG.js";
 import { n as schemaFromDefinition, t as jsonSchemaFromDefinition } from "./schema-CW1jKvio.js";
-import { a as ToolContext, c as toolRequiresAppContext, i as AuthContext, n as errorSummary, r as resolveToolErrorMessage } from "./errors-DTvfh8lb.js";
-import { d as nowMs, i as normalizeHttpMethod, l as emitBeforeResponse, n as createRequestAuthorizer, p as finalizeWireResponse, t as evaluateCors, u as createNoopRecorder } from "./cors-D4BjUpgU.js";
+import { a as ToolContext, c as toolRequiresAppContext, i as AuthContext, n as errorSummary, r as resolveToolErrorMessage } from "./errors-DGcJ8jPK.js";
+import { d as nowMs, i as normalizeHttpMethod, l as emitBeforeResponse, n as createRequestAuthorizer, p as finalizeWireResponse, t as evaluateCors, u as createNoopRecorder } from "./cors-BfacizN-.js";
 import { getParseErrorMessage, safeParseAsync } from "@modelcontextprotocol/sdk/server/zod-compat.js";
 import { CLIENT_CAPABILITIES_META_KEY, CLIENT_INFO_META_KEY, McpServer, createMcpHandler } from "@modelcontextprotocol/server";
 //#region src/core/content.ts

package/dist/{package-BAYb-3dX.js → package-cPx-zYIb.js}

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "2.1.0-rc.0";
+var version = "2.2.0-rc.0";
 //#endregion
 export { version as t };

package/dist/{package-DlouusYQ.cjs → package-hWM0Ru0w.cjs}

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "2.1.0-rc.0";
+var version = "2.2.0-rc.0";
 //#endregion
 Object.defineProperty(exports, "version", {
 	enumerable: true,

package/dist/protocols/mcp/index.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_mcp = require("../../mcp-Q_rjpR99.cjs");
+const require_mcp = require("../../mcp-BGsPYWs1.cjs");
 exports.createMcpProtocolHandler = require_mcp.createMcpProtocolHandler;

package/dist/protocols/mcp/index.d.cts

@@ -1,6 +1,6 @@
-import { p as McpDefinition } from "../../types-S6J_QTXw.cjs";
-import { t as MetricsRecorder } from "../../base-4G2k3bMl.cjs";
-import { n as ScheduleBackground, t as McpRuntimeOptions } from "../../authorize-BC4TM__8.cjs";
+import { m as McpDefinition } from "../../types-BCKyT2wb.cjs";
+import { t as MetricsRecorder } from "../../base-Bmw6Wrb-.cjs";
+import { n as ScheduleBackground, t as McpRuntimeOptions } from "../../authorize-BmYO5_-I.cjs";
 //#region src/protocols/mcp/protocol.d.ts
 type McpProtocolHandler = (request: Request, recorder?: MetricsRecorder, scheduleBackground?: ScheduleBackground) => Promise<Response>;
 /**

package/dist/protocols/mcp/index.d.ts

@@ -1,6 +1,6 @@
-import { p as McpDefinition } from "../../types-S6J_QTXw.js";
-import { t as MetricsRecorder } from "../../base-BnlJz6TE.js";
-import { n as ScheduleBackground, t as McpRuntimeOptions } from "../../authorize-DEsM-zTN.js";
+import { m as McpDefinition } from "../../types-BCKyT2wb.js";
+import { t as MetricsRecorder } from "../../base-BAxrhVjq.js";
+import { n as ScheduleBackground, t as McpRuntimeOptions } from "../../authorize-d9-8n9u3.js";
 //#region src/protocols/mcp/protocol.d.ts
 type McpProtocolHandler = (request: Request, recorder?: MetricsRecorder, scheduleBackground?: ScheduleBackground) => Promise<Response>;
 /**

package/dist/protocols/mcp/index.js

@@ -1,2 +1,2 @@
-import { t as createMcpProtocolHandler } from "../../mcp-CuHyVOZK.js";
+import { t as createMcpProtocolHandler } from "../../mcp-DdJJjYYZ.js";
 export { createMcpProtocolHandler };

package/dist/protocols/oauth-metadata.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_logger = require("../logger-CN1q-KNn.cjs");
-const require_cors = require("../cors-0ZCwmwyK.cjs");
+const require_logger = require("../logger-C-Hdu57K.cjs");
+const require_cors = require("../cors-Dm9Yn8E5.cjs");
 //#region src/protocols/oauth-metadata.ts
 function notFound() {
 	return new Response(JSON.stringify({ error: "not found" }), {

package/dist/protocols/oauth-metadata.d.cts

@@ -1,6 +1,6 @@
-import { p as McpDefinition } from "../types-S6J_QTXw.cjs";
-import { t as MetricsRecorder } from "../base-4G2k3bMl.cjs";
-import { n as ScheduleBackground, t as McpRuntimeOptions } from "../authorize-BC4TM__8.cjs";
+import { m as McpDefinition } from "../types-BCKyT2wb.cjs";
+import { t as MetricsRecorder } from "../base-Bmw6Wrb-.cjs";
+import { n as ScheduleBackground, t as McpRuntimeOptions } from "../authorize-BmYO5_-I.cjs";
 //#region src/protocols/oauth-metadata.d.ts
 type OAuthProtectedResourceMetadataHandler = (request: Request, recorder?: MetricsRecorder, scheduleBackground?: ScheduleBackground) => Promise<Response>;
 declare function createOAuthProtectedResourceMetadataHandler(mcp: McpDefinition, options?: McpRuntimeOptions): OAuthProtectedResourceMetadataHandler;

package/dist/protocols/oauth-metadata.d.ts

@@ -1,6 +1,6 @@
-import { p as McpDefinition } from "../types-S6J_QTXw.js";
-import { t as MetricsRecorder } from "../base-BnlJz6TE.js";
-import { n as ScheduleBackground, t as McpRuntimeOptions } from "../authorize-DEsM-zTN.js";
+import { m as McpDefinition } from "../types-BCKyT2wb.js";
+import { t as MetricsRecorder } from "../base-BAxrhVjq.js";
+import { n as ScheduleBackground, t as McpRuntimeOptions } from "../authorize-d9-8n9u3.js";
 //#region src/protocols/oauth-metadata.d.ts
 type OAuthProtectedResourceMetadataHandler = (request: Request, recorder?: MetricsRecorder, scheduleBackground?: ScheduleBackground) => Promise<Response>;
 declare function createOAuthProtectedResourceMetadataHandler(mcp: McpDefinition, options?: McpRuntimeOptions): OAuthProtectedResourceMetadataHandler;

package/dist/protocols/oauth-metadata.js

@@ -1,5 +1,5 @@
-import { i as log, r as describeError } from "../logger-Ctv5xUSD.js";
-import { a as oauthConfigurationErrorResponse, f as JSON_HEADERS, i as normalizeHttpMethod, l as emitBeforeResponse, m as methodNotAllowed, p as finalizeWireResponse, r as getOAuthRuntime, s as resolveProtectedResource, t as evaluateCors, u as createNoopRecorder } from "../cors-D4BjUpgU.js";
+import { i as log, r as describeError } from "../logger-CpLgYbCG.js";
+import { a as oauthConfigurationErrorResponse, f as JSON_HEADERS, i as normalizeHttpMethod, l as emitBeforeResponse, m as methodNotAllowed, p as finalizeWireResponse, r as getOAuthRuntime, s as resolveProtectedResource, t as evaluateCors, u as createNoopRecorder } from "../cors-BfacizN-.js";
 //#region src/protocols/oauth-metadata.ts
 function notFound() {
 	return new Response(JSON.stringify({ error: "not found" }), {

package/dist/stacks/supabase/index.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_logger = require("../../logger-CN1q-KNn.cjs");
-const require_cors = require("../../cors-0ZCwmwyK.cjs");
+const require_logger = require("../../logger-C-Hdu57K.cjs");
+const require_cors = require("../../cors-Dm9Yn8E5.cjs");
 const require_metadata_path = require("../../metadata-path-zd7NSNoa.cjs");
-const require_mcp = require("../../mcp-Q_rjpR99.cjs");
+const require_mcp = require("../../mcp-BGsPYWs1.cjs");
 const require_protocols_oauth_metadata = require("../../protocols/oauth-metadata.cjs");
 const require_forwarded = require("../../forwarded-B37IdmMX.cjs");
 const require_paths = require("../../paths-OP318a6c.cjs");

package/dist/stacks/supabase/index.d.cts

@@ -1,4 +1,4 @@
-import { p as McpDefinition } from "../../types-S6J_QTXw.cjs";
+import { m as McpDefinition } from "../../types-BCKyT2wb.cjs";
 //#region src/stacks/supabase/handler.d.ts
 type SupabaseHandler = (request: Request) => Promise<Response>;
 interface SupabaseHandlerOptions {

package/dist/stacks/supabase/index.d.ts

@@ -1,4 +1,4 @@
-import { p as McpDefinition } from "../../types-S6J_QTXw.js";
+import { m as McpDefinition } from "../../types-BCKyT2wb.js";
 //#region src/stacks/supabase/handler.d.ts
 type SupabaseHandler = (request: Request) => Promise<Response>;
 interface SupabaseHandlerOptions {

package/dist/stacks/supabase/index.js

@@ -1,7 +1,7 @@
-import { s as trimTrailingSlash } from "../../logger-Ctv5xUSD.js";
-import { c as createRecorderForRuntime, o as assertResourcePathShape } from "../../cors-D4BjUpgU.js";
+import { s as trimTrailingSlash } from "../../logger-CpLgYbCG.js";
+import { c as createRecorderForRuntime, o as assertResourcePathShape } from "../../cors-BfacizN-.js";
 import { t as OAUTH_PROTECTED_RESOURCE_METADATA_PATH } from "../../metadata-path-CAkNcfyY.js";
-import { t as createMcpProtocolHandler } from "../../mcp-CuHyVOZK.js";
+import { t as createMcpProtocolHandler } from "../../mcp-DdJJjYYZ.js";
 import { createOAuthProtectedResourceMetadataHandler } from "../../protocols/oauth-metadata.js";
 import { t as applyForwardedOrigin } from "../../forwarded-BBXvFeh6.js";
 import { n as assertFunctionName, t as FUNCTIONS_MOUNT_PREFIX } from "../../paths-IS65L6TA.js";

package/dist/stacks/supabase/vite.cjs

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_package = require("../../package-DlouusYQ.cjs");
+const require_package = require("../../package-hWM0Ru0w.cjs");
 const require_fs_errors = require("../../fs-errors-CWNzOV75.cjs");
 const require_supabase_config = require("../../supabase-config-Dz7dnUv0.cjs");
 const require_paths = require("../../paths-OP318a6c.cjs");

package/dist/stacks/supabase/vite.d.cts

@@ -1,4 +1,4 @@
-import { t as McpPluginApi } from "../../io-9jGNgPfl.cjs";
+import { t as McpPluginApi } from "../../io-CL1GeE3D.cjs";
 import { Plugin } from "vite";
 //#region src/stacks/supabase/vite.d.ts
 interface McpPluginOptions {

package/dist/stacks/supabase/vite.d.ts

@@ -1,4 +1,4 @@
-import { t as McpPluginApi } from "../../io-BLZ8jYW6.js";
+import { t as McpPluginApi } from "../../io-7U860POB.js";
 import { Plugin } from "vite";
 //#region src/stacks/supabase/vite.d.ts
 interface McpPluginOptions {

package/dist/stacks/supabase/vite.js

@@ -1,4 +1,4 @@
-import { t as version } from "../../package-BAYb-3dX.js";
+import { t as version } from "../../package-cPx-zYIb.js";
 import { t as isFileMissing } from "../../fs-errors-PA2t1TIp.js";
 import { t as readSupabaseProjectRef } from "../../supabase-config-CakTU8YF.js";
 import { n as assertFunctionName, t as FUNCTIONS_MOUNT_PREFIX } from "../../paths-IS65L6TA.js";

package/dist/stacks/tanstack/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_cors = require("../../cors-0ZCwmwyK.cjs");
-const require_mcp = require("../../mcp-Q_rjpR99.cjs");
+const require_cors = require("../../cors-Dm9Yn8E5.cjs");
+const require_mcp = require("../../mcp-BGsPYWs1.cjs");
 const require_protocols_oauth_metadata = require("../../protocols/oauth-metadata.cjs");
 const require_forwarded = require("../../forwarded-B37IdmMX.cjs");
 //#region src/stacks/tanstack/handlers.ts

package/dist/stacks/tanstack/index.d.cts

@@ -1,5 +1,5 @@
-import { p as McpDefinition } from "../../types-S6J_QTXw.cjs";
-import { n as ScheduleBackground, t as McpRuntimeOptions } from "../../authorize-BC4TM__8.cjs";
+import { m as McpDefinition } from "../../types-BCKyT2wb.cjs";
+import { n as ScheduleBackground, t as McpRuntimeOptions } from "../../authorize-BmYO5_-I.cjs";
 //#region src/stacks/tanstack/handlers.d.ts
 interface TanStackRequest extends Request {
   waitUntil?: ScheduleBackground;

package/dist/stacks/tanstack/index.d.ts

@@ -1,5 +1,5 @@
-import { p as McpDefinition } from "../../types-S6J_QTXw.js";
-import { n as ScheduleBackground, t as McpRuntimeOptions } from "../../authorize-DEsM-zTN.js";
+import { m as McpDefinition } from "../../types-BCKyT2wb.js";
+import { n as ScheduleBackground, t as McpRuntimeOptions } from "../../authorize-d9-8n9u3.js";
 //#region src/stacks/tanstack/handlers.d.ts
 interface TanStackRequest extends Request {
   waitUntil?: ScheduleBackground;

package/dist/stacks/tanstack/index.js

@@ -1,5 +1,5 @@
-import { c as createRecorderForRuntime } from "../../cors-D4BjUpgU.js";
-import { t as createMcpProtocolHandler } from "../../mcp-CuHyVOZK.js";
+import { c as createRecorderForRuntime } from "../../cors-BfacizN-.js";
+import { t as createMcpProtocolHandler } from "../../mcp-DdJJjYYZ.js";
 import { createOAuthProtectedResourceMetadataHandler } from "../../protocols/oauth-metadata.js";
 import { t as applyForwardedOrigin } from "../../forwarded-BBXvFeh6.js";
 //#region src/stacks/tanstack/handlers.ts

package/dist/stacks/tanstack/vite.d.cts

@@ -1,4 +1,4 @@
-import { t as McpPluginApi } from "../../io-9jGNgPfl.cjs";
+import { t as McpPluginApi } from "../../io-CL1GeE3D.cjs";
 import { Plugin } from "vite";
 //#region src/stacks/tanstack/vite.d.ts
 interface McpPluginOptions {

package/dist/stacks/tanstack/vite.d.ts

@@ -1,4 +1,4 @@
-import { t as McpPluginApi } from "../../io-BLZ8jYW6.js";
+import { t as McpPluginApi } from "../../io-7U860POB.js";
 import { Plugin } from "vite";
 //#region src/stacks/tanstack/vite.d.ts
 interface McpPluginOptions {

package/dist/{types-S6J_QTXw.d.ts → types-BCKyT2wb.d.cts}

@@ -303,6 +303,11 @@ interface ToolAnnotations {
   idempotentHint?: boolean;
   /** Tool interacts with external/unbounded systems (DB, network, third-party APIs). */
   openWorldHint?: boolean;
+  /**
+   * Asks the Lovable agent to keep up to 50 KB of this tool's result in context instead of the default 5 KB.
+   * Honored for the app's published MCP server; meant for results the agent must read whole.
+   */
+  largeOutputHint?: boolean;
 }
 interface ToolHandlerResult {
   content?: ToolContent;
@@ -318,7 +323,7 @@ interface CreateAppContextInput {
 interface ToolVisibilityContext<TAppContext> {
   readonly appContext: TAppContext;
 }
-interface ToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined, TAppContext = undefined> {
+interface ToolDefinitionBase<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined> {
   readonly name: string;
   /** Human-readable display name shown to the user in MCP clients. Required. */
   readonly title: string;
@@ -327,11 +332,19 @@ interface ToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$
   readonly inputSchema?: TInput;
   readonly outputSchema?: TOutput;
   readonly annotations?: ToolAnnotations;
+}
+type ToolHandler<TInput extends ZodRawShape$1 | undefined, TAppContext> = TInput extends ZodRawShape$1 ? (args: ShapeOutput<TInput>, ctx: ToolContext<TAppContext>) => ToolHandlerResult | Promise<ToolHandlerResult> : (args: Record<string, never> | undefined, ctx: ToolContext<TAppContext>) => ToolHandlerResult | Promise<ToolHandlerResult>;
+/** A tool that exists for every caller. Its handler receives the plain `ToolContext`. */
+interface ToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined> extends ToolDefinitionBase<TInput, TOutput> {
+  readonly handler: ToolHandler<TInput, undefined>;
+}
+/** Input to `defineTool.withAppContext<TAppContext>()`. */
+interface AppContextToolDefinitionInput<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined, TAppContext = unknown> extends ToolDefinitionBase<TInput, TOutput> {
   /** Synchronously decide whether this tool exists for the current caller. */
   readonly enabled?: (ctx: ToolVisibilityContext<TAppContext>) => boolean;
-  readonly handler: TInput extends ZodRawShape$1 ? (args: ShapeOutput<TInput>, ctx: ToolContext<TAppContext>) => ToolHandlerResult | Promise<ToolHandlerResult> : (args: Record<string, never> | undefined, ctx: ToolContext<TAppContext>) => ToolHandlerResult | Promise<ToolHandlerResult>;
+  readonly handler: ToolHandler<TInput, TAppContext>;
 }
-interface AppContextToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined, TAppContext = unknown> extends ToolDefinition<TInput, TOutput, TAppContext> {
+interface AppContextToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined, TAppContext = unknown> extends AppContextToolDefinitionInput<TInput, TOutput, TAppContext> {
   readonly requiresAppContext: true;
 }
 /** Type-erased element of `McpDefinition.tools`; per-tool generic typing
@@ -394,4 +407,4 @@ type McpDefinition<TAppContext = unknown> = Omit<McpDefinitionInput<TAppContext>
   readonly [McpDefinitionBrand]: never;
 };
 //#endregion
-export { McpProtocolEra as A, ZodOutputSchema as C, MetricsOptions as D, MetricsConfig as E, ToolContext as M, JwtClaims as N, AuthContext as O, McpAuthConfig as P, ToolVisibilityContext as S, ZodSchema as T, TextContent as _, CreateAppContextInput as a, ToolDefinition as b, EmbeddedTextResource as c, JsonValueInput as d, McpAllowedOrigins as f, ResourceLinkIcon as g, ResourceLink as h, ContentBlock as i, ProgressUpdate as j, McpClientInfo as k, ImageContent as l, McpDefinitionInput as m, AudioContent as n, EmbeddedBlobResource as o, McpDefinition as p, ContentAnnotations as r, EmbeddedResource as s, AppContextToolDefinition as t, JsonValue as u, ToolAnnotations as v, ZodRawShape$1 as w, ToolHandlerResult as x, ToolContent as y };
+export { McpClientInfo as A, ToolVisibilityContext as C, MetricsConfig as D, ZodSchema as E, McpAuthConfig as F, ProgressUpdate as M, ToolContext as N, MetricsOptions as O, JwtClaims as P, ToolHandlerResult as S, ZodRawShape$1 as T, ResourceLinkIcon as _, ContentBlock as a, ToolContent as b, EmbeddedResource as c, JsonValue as d, JsonValueInput as f, ResourceLink as g, McpDefinitionInput as h, ContentAnnotations as i, McpProtocolEra as j, AuthContext as k, EmbeddedTextResource as l, McpDefinition as m, AppContextToolDefinitionInput as n, CreateAppContextInput as o, McpAllowedOrigins as p, AudioContent as r, EmbeddedBlobResource as s, AppContextToolDefinition as t, ImageContent as u, TextContent as v, ZodOutputSchema as w, ToolDefinition as x, ToolAnnotations as y };

package/dist/{types-S6J_QTXw.d.cts → types-BCKyT2wb.d.ts}

@@ -303,6 +303,11 @@ interface ToolAnnotations {
   idempotentHint?: boolean;
   /** Tool interacts with external/unbounded systems (DB, network, third-party APIs). */
   openWorldHint?: boolean;
+  /**
+   * Asks the Lovable agent to keep up to 50 KB of this tool's result in context instead of the default 5 KB.
+   * Honored for the app's published MCP server; meant for results the agent must read whole.
+   */
+  largeOutputHint?: boolean;
 }
 interface ToolHandlerResult {
   content?: ToolContent;
@@ -318,7 +323,7 @@ interface CreateAppContextInput {
 interface ToolVisibilityContext<TAppContext> {
   readonly appContext: TAppContext;
 }
-interface ToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined, TAppContext = undefined> {
+interface ToolDefinitionBase<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined> {
   readonly name: string;
   /** Human-readable display name shown to the user in MCP clients. Required. */
   readonly title: string;
@@ -327,11 +332,19 @@ interface ToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$
   readonly inputSchema?: TInput;
   readonly outputSchema?: TOutput;
   readonly annotations?: ToolAnnotations;
+}
+type ToolHandler<TInput extends ZodRawShape$1 | undefined, TAppContext> = TInput extends ZodRawShape$1 ? (args: ShapeOutput<TInput>, ctx: ToolContext<TAppContext>) => ToolHandlerResult | Promise<ToolHandlerResult> : (args: Record<string, never> | undefined, ctx: ToolContext<TAppContext>) => ToolHandlerResult | Promise<ToolHandlerResult>;
+/** A tool that exists for every caller. Its handler receives the plain `ToolContext`. */
+interface ToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined> extends ToolDefinitionBase<TInput, TOutput> {
+  readonly handler: ToolHandler<TInput, undefined>;
+}
+/** Input to `defineTool.withAppContext<TAppContext>()`. */
+interface AppContextToolDefinitionInput<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined, TAppContext = unknown> extends ToolDefinitionBase<TInput, TOutput> {
   /** Synchronously decide whether this tool exists for the current caller. */
   readonly enabled?: (ctx: ToolVisibilityContext<TAppContext>) => boolean;
-  readonly handler: TInput extends ZodRawShape$1 ? (args: ShapeOutput<TInput>, ctx: ToolContext<TAppContext>) => ToolHandlerResult | Promise<ToolHandlerResult> : (args: Record<string, never> | undefined, ctx: ToolContext<TAppContext>) => ToolHandlerResult | Promise<ToolHandlerResult>;
+  readonly handler: ToolHandler<TInput, TAppContext>;
 }
-interface AppContextToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined, TAppContext = unknown> extends ToolDefinition<TInput, TOutput, TAppContext> {
+interface AppContextToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined, TAppContext = unknown> extends AppContextToolDefinitionInput<TInput, TOutput, TAppContext> {
   readonly requiresAppContext: true;
 }
 /** Type-erased element of `McpDefinition.tools`; per-tool generic typing
@@ -394,4 +407,4 @@ type McpDefinition<TAppContext = unknown> = Omit<McpDefinitionInput<TAppContext>
   readonly [McpDefinitionBrand]: never;
 };
 //#endregion
-export { McpProtocolEra as A, ZodOutputSchema as C, MetricsOptions as D, MetricsConfig as E, ToolContext as M, JwtClaims as N, AuthContext as O, McpAuthConfig as P, ToolVisibilityContext as S, ZodSchema as T, TextContent as _, CreateAppContextInput as a, ToolDefinition as b, EmbeddedTextResource as c, JsonValueInput as d, McpAllowedOrigins as f, ResourceLinkIcon as g, ResourceLink as h, ContentBlock as i, ProgressUpdate as j, McpClientInfo as k, ImageContent as l, McpDefinitionInput as m, AudioContent as n, EmbeddedBlobResource as o, McpDefinition as p, ContentAnnotations as r, EmbeddedResource as s, AppContextToolDefinition as t, JsonValue as u, ToolAnnotations as v, ZodRawShape$1 as w, ToolHandlerResult as x, ToolContent as y };
+export { McpClientInfo as A, ToolVisibilityContext as C, MetricsConfig as D, ZodSchema as E, McpAuthConfig as F, ProgressUpdate as M, ToolContext as N, MetricsOptions as O, JwtClaims as P, ToolHandlerResult as S, ZodRawShape$1 as T, ResourceLinkIcon as _, ContentBlock as a, ToolContent as b, EmbeddedResource as c, JsonValue as d, JsonValueInput as f, ResourceLink as g, McpDefinitionInput as h, ContentAnnotations as i, McpProtocolEra as j, AuthContext as k, EmbeddedTextResource as l, McpDefinition as m, AppContextToolDefinitionInput as n, CreateAppContextInput as o, McpAllowedOrigins as p, AudioContent as r, EmbeddedBlobResource as s, AppContextToolDefinition as t, ImageContent as u, TextContent as v, ZodOutputSchema as w, ToolDefinition as x, ToolAnnotations as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovable.dev/mcp-js",
-  "version": "2.1.0-rc.0",
+  "version": "2.2.0-rc.0",
   "engines": {
     "node": ">=20"
   },