@mcp-b/react-webmcp 4.1.0-beta.20260702224704 → 5.0.1

package/dist/index.js

@@ -1,2 +1,2 @@
-"use client";import{isPlainObject as e,normalizeInputSchema as t,toJsonValue as n}from"@mcp-b/webmcp-polyfill/schema";import{createContext as r,useCallback as i,useContext as a,useEffect as o,useLayoutEffect as s,useMemo as c,useRef as l,useState as u}from"react";import{normalizeObjectSchema as d}from"@modelcontextprotocol/sdk/server/zod-compat.js";import{toJsonSchemaCompat as f}from"@modelcontextprotocol/sdk/server/zod-json-schema-compat.js";import{ResourceListChangedNotificationSchema as p,ToolListChangedNotificationSchema as m}from"@mcp-b/webmcp-ts-sdk";import{jsx as h}from"react/jsx-runtime";function g(){if(typeof window>`u`)return;let e=window.document.modelContext,t=window.navigator.modelContext;return e??t}function _(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function v(e){return _(e)&&(`_def`in e||`_zod`in e)}function y(e){return!_(e)||v(e)?!1:d(e)!==void 0}function b(e){let t=d(e)??(v(e)?e:void 0);if(!t)throw Error(`Expected a Zod schema or Zod schema object`);return f(t,{strictUnions:!0,pipeStrategy:`input`})}function x(e){return typeof e==`string`?e:JSON.stringify(e,null,2)}const S=new Map,C=[`array`,`boolean`,`integer`,`null`,`number`,`object`,`string`],w=[`$ref`,`allOf`,`anyOf`,`oneOf`,`not`];function T(e){return typeof e==`string`&&C.includes(e)}function E(e){throw Error(`Unsupported outputSchema: ${e}`)}function D(t,n=`$`){e(t)||E(`${n} must be a JSON Schema object`);for(let e of w)e in t&&E(`${n}.${e} is outside the inferable JSON Schema subset`);let r=typeof t.type==`string`?[t.type]:Array.isArray(t.type)?t.type:void 0;(!r?.length||!r.every(e=>T(e)))&&E(`${n} must declare an inferable JSON Schema type`);let i=t.required;if(i!==void 0&&(!Array.isArray(i)||i.some(e=>typeof e!=`string`))&&E(`${n}.required must be an array of strings`),r.includes(`array`)&&(e(t.items)||E(`${n}.items must be an inferable schema for array outputs`),D(t.items,`${n}.items`)),r.includes(`object`)){if(t.properties!==void 0&&!e(t.properties)&&E(`${n}.properties must be an object`),e(t.properties))for(let[e,r]of Object.entries(t.properties))D(r,`${n}.properties.${e}`);t.additionalProperties!==void 0&&typeof t.additionalProperties!=`boolean`&&D(t.additionalProperties,`${n}.additionalProperties`)}}const O=typeof window<`u`?s:o;function k(e,r){let{name:a,description:s,inputSchema:c,outputSchema:d,annotations:f,handler:p,formatOutput:m=x,onSuccess:h,onError:_}=e,[C,w]=u({isExecuting:!1,lastResult:null,error:null,executionCount:0}),T=l(p),E=l(h),k=l(_),A=l(m),j=l(!0);O(()=>{T.current=p,E.current=h,k.current=_,A.current=m},[p,h,_,m]),o(()=>(j.current=!0,()=>{j.current=!1}),[]);let M=i(async e=>{w(e=>({...e,isExecuting:!0,error:null}));try{let t=await T.current(e);return j.current&&w(e=>({isExecuting:!1,lastResult:t,error:null,executionCount:e.executionCount+1})),E.current&&E.current(t,e),t}catch(t){let n=t instanceof Error?t:Error(String(t));throw j.current&&w(e=>({...e,isExecuting:!1,error:n})),k.current&&k.current(n,e),n}},[]),N=l(M);o(()=>{N.current=M},[M]);let P=i(e=>N.current(e),[]),F=i(()=>{w({isExecuting:!1,lastResult:null,error:null,executionCount:0})},[]);return o(()=>{let e=g();if(!e){console.warn(`[ReactWebMCP:useWebMCP]`,`Tool "${a}" skipped: modelContext is not available`);return}let r=y(c)?b(c):t(c).inputSchema,i;if(d){let e=y(d)||v(d)?b(d):d;D(e),i=e}let o=async e=>{try{let t=await Reflect.apply(N.current,void 0,[e]),r={content:[{type:`text`,text:A.current(t)}]};if(i){let e=n(t);if(e===void 0)throw Error(`Tool "${a}" outputSchema requires the handler to return a JSON-serializable result`);r.structuredContent=e}return r}catch(e){return{content:[{type:`text`,text:`Error: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}},l=Symbol(a),u={name:a,description:s,inputSchema:r,...i&&{outputSchema:i},...f&&{annotations:f},execute:o},p=new AbortController,m=!1,h=!1;try{let t=e.registerTool(u,{signal:p.signal});Promise.resolve(t).then(()=>{!h&&!p.signal.aborted&&(m=!0,S.set(a,l))},e=>{p.signal.aborted||(p.abort(),console.warn(`[ReactWebMCP:useWebMCP] registerTool("${a}") rejected:`,e))})}catch(e){p.abort(),console.warn(`[ReactWebMCP:useWebMCP] registerTool("${a}") rejected:`,e);return}return()=>{if(h=!0,m&&S.get(a)===l){S.delete(a),p.abort();return}m||p.abort()}},[a,s,...r??[]]),{state:C,execute:P,reset:F}}function A(e,t,n){let r=l(n);return r.current=n,k({name:e,description:t,annotations:c(()=>({title:`Context: ${e}`,readOnlyHint:!0,idempotentHint:!0,destructiveHint:!1,openWorldHint:!1}),[e]),handler:async e=>r.current(),formatOutput:e=>typeof e==`string`?e:JSON.stringify(e,null,2)})}function j(e){let{name:n,description:r,argsSchema:i,get:a}=e,[s,c]=u(!1),d=l(a);return o(()=>{d.current=a},[a]),o(()=>{let e=g();if(!e){console.warn(`[ReactWebMCP] window.document.modelContext is not available. Prompt "${n}" will not be registered.`);return}let a=async e=>d.current(e),o=i?y(i)?b(i):t(i).inputSchema:void 0,s;try{s=e.registerPrompt({name:n,...r!==void 0&&{description:r},...o&&{argsSchema:o},get:a})}catch(e){throw c(!1),e}if(!s){console.warn(`[ReactWebMCP] Prompt "${n}" did not return a registration handle.`),c(!1);return}return c(!0),()=>{s.unregister(),c(!1)}},[n,r,i]),{isRegistered:s}}function M(e){let{uri:t,name:n,description:r,mimeType:i,read:a}=e,[s,c]=u(!1),d=l(a);return o(()=>{d.current=a},[a]),o(()=>{let e=g();if(!e){console.warn(`[ReactWebMCP] window.document.modelContext is not available. Resource "${t}" will not be registered.`);return}let a=async(e,t)=>d.current(e,t),o;try{o=e.registerResource({uri:t,name:n,...r!==void 0&&{description:r},...i!==void 0&&{mimeType:i},read:a})}catch(e){throw c(!1),e}if(!o){console.warn(`[ReactWebMCP] Resource "${t}" did not return a registration handle.`),c(!1);return}return c(!0),()=>{o.unregister(),c(!1)}},[t,n,r,i]),{isRegistered:s}}function N(e={}){let{onSuccess:t,onError:n}=e,[r,a]=u({isLoading:!1,result:null,error:null,requestCount:0}),o=i(()=>{a({isLoading:!1,result:null,error:null,requestCount:0})},[]);return{state:r,elicitInput:i(async e=>{let r=g();if(!r)throw Error(`document.modelContext is not available`);a(e=>({...e,isLoading:!0,error:null}));try{let n=await r.elicitInput(e);return a(e=>({isLoading:!1,result:n,error:null,requestCount:e.requestCount+1})),t?.(n),n}catch(e){let t=e instanceof Error?e:Error(String(e));throw a(e=>({...e,isLoading:!1,error:t})),n?.(t),t}},[t,n]),reset:o}}function P(e={}){let{onSuccess:t,onError:n}=e,[r,a]=u({isLoading:!1,result:null,error:null,requestCount:0}),o=i(()=>{a({isLoading:!1,result:null,error:null,requestCount:0})},[]);return{state:r,createMessage:i(async e=>{let r=g();if(!r)throw Error(`document.modelContext is not available`);a(e=>({...e,isLoading:!0,error:null}));try{let n=await r.createMessage(e);return a(e=>({isLoading:!1,result:n,error:null,requestCount:e.requestCount+1})),t?.(n),n}catch(e){let t=e instanceof Error?e:Error(String(e));throw a(e=>({...e,isLoading:!1,error:t})),n?.(t),t}},[t,n]),reset:o}}const F=r(null),I={};function L(e,t){let n=globalThis.console;if(!n)return;let r=n.debug??n.log;typeof r==`function`&&r.call(n,`[ReactWebMCP:McpClientProvider:ToolFlow]`,e,t)}function R(){if(typeof window>`u`)return!1;try{return window.localStorage.getItem(`WEBMCP_TRACE_TOOL_FLOW`)===`1`}catch{return!1}}function z({children:e,client:t,transport:n,opts:r}){let[a,s]=u([]),[c,d]=u([]),[f,g]=u(!1),[_,v]=u(null),[y,b]=u(!1),[x,S]=u(null),C=r??I,w=l(`disconnected`),T=l(0),E=i((e,t={})=>{let n=`[${++T.current}] ${e}`;R()&&L(n,t)},[]),D=i(async()=>{if(t){if(!t.getServerCapabilities()?.resources){s([]);return}try{s((await t.listResources()).resources)}catch(e){throw console.error(`[ReactWebMCP:McpClientProvider]`,`Error fetching resources:`,e),e}}},[t]),O=i(async()=>{if(!t)return;let e=t.getServerCapabilities();if(!e?.tools){E(`listTools:capability_missing`,{}),d([]);return}let n=Date.now();E(`listTools:start`,{hasToolsCapability:!!e.tools});try{let e=await t.listTools();d(e.tools),E(`listTools:success`,{durationMs:Date.now()-n,toolCount:e.tools.length})}catch(e){throw E(`listTools:error`,{durationMs:Date.now()-n,errorMessage:e instanceof Error?e.message:String(e)}),console.error(`[ReactWebMCP:McpClientProvider]`,`Error fetching tools:`,e),e}},[t,E]),k=i(async()=>{if(!t||!n)throw Error(`Client or transport not available`);if(w.current===`disconnected`){w.current=`connecting`,g(!0),v(null);try{await t.connect(n,C);let e=t.getServerCapabilities();b(!0),S(e||null),w.current=`connected`,E(`reconnect:connected`,{hasToolsListChanged:!!e?.tools?.listChanged}),await Promise.all([D(),O()])}catch(e){let t=e instanceof Error?e:Error(String(e));throw w.current=`disconnected`,v(t),t}finally{g(!1)}}},[t,n,C,D,O,E]);return o(()=>{if(!y||!t)return;let e=t.getServerCapabilities();return e?.resources?.listChanged&&t.setNotificationHandler(p,()=>{D().catch(e=>{console.error(`[ReactWebMCP:McpClientProvider]`,`Failed to refresh resources after list_changed:`,e)})}),e?.tools?.listChanged&&t.setNotificationHandler(m,()=>{E(`notification:tools/list_changed`,{}),O().catch(e=>{console.error(`[ReactWebMCP:McpClientProvider]`,`Failed to refresh tools after list_changed:`,e)})}),Promise.all([D(),O()]).catch(e=>{console.error(`[ReactWebMCP:McpClientProvider]`,`Failed to refresh tools/resources after handler registration:`,e)}),()=>{e?.resources?.listChanged&&t.removeNotificationHandler(`notifications/resources/list_changed`),e?.tools?.listChanged&&t.removeNotificationHandler(`notifications/tools/list_changed`)}},[t,y,D,O,E]),o(()=>(k().catch(e=>{console.error(`[ReactWebMCP:McpClientProvider]`,`Failed to connect MCP client:`,e)}),()=>{w.current=`disconnected`,b(!1)}),[t,n,k]),h(F.Provider,{value:{client:t,tools:c,resources:a,isConnected:y,isLoading:f,error:_,capabilities:x,reconnect:k},children:e})}function B(){let e=a(F);if(!e)throw Error(`useMcpClient must be used within an McpClientProvider`);return e}export{z as McpClientProvider,N as useElicitation,N as useElicitationHandler,B as useMcpClient,P as useSampling,P as useSamplingHandler,k as useWebMCP,A as useWebMCPContext,j as useWebMCPPrompt,M as useWebMCPResource};
+"use client";import{useWebMCP as e,useWebMCP as t}from"usewebmcp";import{createContext as n,useCallback as r,useContext as i,useEffect as a,useLayoutEffect as o,useMemo as s,useRef as c,useState as l}from"react";import{jsx as u}from"react/jsx-runtime";import{normalizeInputSchema as d}from"@mcp-b/webmcp-polyfill/schema";import{isBrowserMcpServer as f}from"@mcp-b/webmcp-ts-sdk";const p=typeof window>`u`?a:o;function m(e){let t=c(e);return p(()=>{t.current=e},[e]),t}const h=n(null);function g(e,t,n){let r=new AbortController;return e.listen(t,{signal:r.signal}).then(async e=>{if(r.signal.aborted){await e.close();return}await n()}).catch(e=>{r.signal.aborted||console.error(`[ReactWebMCP:McpClientProvider]`,`Failed to listen for list_changed notifications:`,e)}),()=>r.abort()}function _({children:e,client:t,transport:n,opts:i}){let[o,d]=l([]),[f,p]=l([]),[_,v]=l(null),[y,b]=l(`disconnected`),[x,S]=l(null),C=y===`initializing`||y===`connected`,w=y===`connecting`||y===`initializing`,T=c(`disconnected`),E=c(0),D=c(null),O=c(null),k=c(0),A=m(i),j=r(async e=>{let n=++k.current,r=t.getServerCapabilities();try{let[i,a]=await Promise.all([r?.resources?t.listResources(void 0,{cacheMode:`refresh`}):void 0,r?.tools?t.listTools(void 0,{cacheMode:`refresh`}):void 0]);if(e!==E.current||n!==k.current)return;d(i?.resources??[]),p(a?.tools??[]),v(null)}catch(t){let r=t instanceof Error?t:Error(String(t));if(e!==E.current||n!==k.current)return;throw v(r),r}},[t]),M=r(async e=>{if(T.current===`connected`&&e===void 0){let e=E.current;T.current=`initializing`,b(`initializing`);try{await j(e)}catch{}e===E.current&&(T.current=`connected`,b(`connected`));return}if(T.current!==`disconnected`)return;T.current=`connecting`,b(`connecting`),v(null);let r=E.current;try{if(await D.current,r!==E.current||(await t.connect(e??n,A.current),r!==E.current))return}catch(e){let t=e instanceof Error?e:Error(String(e));throw r===E.current&&(T.current=`disconnected`,b(`disconnected`),v(t)),t}S(t.getServerCapabilities()??null),T.current=`initializing`,b(`initializing`);try{await j(r)}catch{}r===E.current&&(T.current=`connected`,b(`connected`))},[t,n,j,A]);a(()=>{if(!C)return;let e=t.getServerCapabilities(),n=e?.resources?.listChanged===!0,r=e?.tools?.listChanged===!0,i=async()=>{try{await j(E.current)}catch(e){console.error(`[ReactWebMCP:McpClientProvider]`,`Failed to refresh tools/resources after list_changed:`,e)}};n&&t.setNotificationHandler(`notifications/resources/list_changed`,i),r&&t.setNotificationHandler(`notifications/tools/list_changed`,i);let a=n||r,o=t.getProtocolEra()===`modern`&&a?g(t,{...r&&{toolsListChanged:!0},...n&&{resourcesListChanged:!0}},i):void 0;return!o&&a&&i(),()=>{n&&t.removeNotificationHandler(`notifications/resources/list_changed`),r&&t.removeNotificationHandler(`notifications/tools/list_changed`),o?.()}},[t,C,j]),a(()=>{let e=!0,n=E.current,r=t.onclose,i=()=>{try{r?.()}finally{e&&O.current===null&&(E.current+=1,k.current+=1,T.current=`disconnected`,b(`disconnected`),S(null),d([]),p([]))}};return t.onclose=i,T.current=`disconnected`,b(`disconnected`),M().catch(e=>{n===E.current&&console.error(`[ReactWebMCP:McpClientProvider]`,`Failed to connect MCP client:`,e)}),()=>{e=!1,t.onclose===i&&(r?t.onclose=r:Reflect.deleteProperty(t,`onclose`)),E.current+=1,k.current+=1,T.current=`disconnected`;let n={};O.current=n,D.current=t.close().catch(e=>{console.error(`[ReactWebMCP:McpClientProvider]`,`Failed to close MCP client:`,e)}).finally(()=>{O.current===n&&(O.current=null)})}},[t,n,M]);let N=s(()=>({client:t,tools:f,resources:o,isConnected:C,isLoading:w,error:_,capabilities:x,reconnect:M}),[t,f,o,C,w,_,x,M]);return u(h.Provider,{value:N,children:e})}function v(){let e=i(h);if(!e)throw Error(`useMcpClient must be used within an McpClientProvider`);return e}function y(e,n,r){return t({name:e,description:n,annotations:{title:`Context: ${e}`,readOnlyHint:!0,idempotentHint:!0,destructiveHint:!1,openWorldHint:!1},execute:r})}function b(){if(typeof document>`u`||typeof navigator>`u`)return;let e=document.modelContext??navigator.modelContext;return e&&f(e)?e:void 0}function x(e){let[t,n]=l(!1);return a(()=>{let t=e();if(!t){n(!1);return}return n(!0),()=>{t.unregister()}},[e]),t}function S(e){let{name:t,description:n}=e,i=m(e);return{isRegistered:x(r(()=>{let e=b();if(!e){console.warn(`[ReactWebMCP] BrowserMcpServer is not available. Prompt "${t}" will not be registered.`);return}let{argsSchema:r}=i.current,a=r?d(r).inputSchema:void 0;return e.registerPrompt({name:t,...n!==void 0&&{description:n},...a&&{argsSchema:a},get:async e=>i.current.get(e)})},[t,n,i]))}}function C(e){let{uri:t,name:n,description:i,mimeType:a,read:o}=e,s=m(o);return{isRegistered:x(r(()=>{let e=b();if(!e){console.warn(`[ReactWebMCP] BrowserMcpServer is not available. Resource "${t}" will not be registered.`);return}return e.registerResource({uri:t,name:n,...i!==void 0&&{description:i},...a!==void 0&&{mimeType:a},read:(e,t)=>s.current(e,t)})},[t,n,i,a,s]))}}export{_ as McpClientProvider,v as useMcpClient,e as useWebMCP,y as useWebMCPContext,S as useWebMCPPrompt,C as useWebMCPResource};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/model-context.ts","../src/zod-utils.ts","../src/useWebMCP.ts","../src/useWebMCPContext.ts","../src/useWebMCPPrompt.ts","../src/useWebMCPResource.ts","../src/useElicitationHandler.ts","../src/useSamplingHandler.ts","../src/client/McpClientProvider.tsx"],"sourcesContent":["import type { ModelContext } from '@mcp-b/webmcp-types';\n\nexport type ModelContextSurface = ModelContext;\ntype ModelContextHost = { modelContext?: ModelContext };\n\nexport function getModelContext(): ModelContextSurface | undefined {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n\n  const documentContext = (window.document as Document & ModelContextHost).modelContext;\n  const navigatorContext = (window.navigator as Navigator & ModelContextHost).modelContext;\n  return documentContext ?? navigatorContext;\n}\n","import type { InputSchema } from '@mcp-b/webmcp-types';\nimport type { AnySchema, ZodRawShapeCompat } from '@modelcontextprotocol/sdk/server/zod-compat.js';\nimport { normalizeObjectSchema } from '@modelcontextprotocol/sdk/server/zod-compat.js';\nimport { toJsonSchemaCompat } from '@modelcontextprotocol/sdk/server/zod-json-schema-compat.js';\nimport type { z } from 'zod';\n\nexport type ZodSchemaObject = Record<string, z.ZodTypeAny>;\nexport type ZodSchema = ZodSchemaObject | z.ZodTypeAny;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nexport function isZodType(schema: unknown): schema is z.ZodTypeAny {\n  return isRecord(schema) && ('_def' in schema || '_zod' in schema);\n}\n\nexport function isZodSchema(schema: unknown): schema is ZodSchemaObject {\n  if (!isRecord(schema) || isZodType(schema)) {\n    return false;\n  }\n\n  return normalizeObjectSchema(schema as ZodRawShapeCompat) !== undefined;\n}\n\nexport function zodToJsonSchema(schema: ZodSchema): InputSchema {\n  const normalized = normalizeObjectSchema(schema as AnySchema | ZodRawShapeCompat);\n  const zodSchema = normalized ?? (isZodType(schema) ? (schema as AnySchema) : undefined);\n  if (!zodSchema) {\n    throw new Error('Expected a Zod schema or Zod schema object');\n  }\n\n  return toJsonSchemaCompat(zodSchema, {\n    strictUnions: true,\n    pipeStrategy: 'input',\n  }) as InputSchema;\n}\n","import type {\n  CallToolResult,\n  InputSchema,\n  JsonSchemaForInference,\n  ToolDescriptor,\n} from '@mcp-b/webmcp-types';\nimport { isPlainObject, normalizeInputSchema, toJsonValue } from '@mcp-b/webmcp-polyfill/schema';\nimport type { DependencyList } from 'react';\nimport { useCallback, useEffect, useLayoutEffect, useRef, useState } from 'react';\nimport type {\n  InferOutput,\n  InferToolInput,\n  ReactWebMCPInputSchema,\n  ReactWebMCPOutputSchema,\n  ToolExecutionState,\n  WebMCPConfig,\n  WebMCPReturn,\n} from './types.js';\nimport { getModelContext } from './model-context.js';\nimport { isZodSchema, isZodType, zodToJsonSchema } from './zod-utils.js';\n\n/**\n * Default output formatter that converts values to formatted JSON strings.\n *\n * String values are returned as-is; all other types are serialized to\n * indented JSON for readability.\n *\n * @internal\n */\nfunction defaultFormatOutput(output: unknown): string {\n  if (typeof output === 'string') {\n    return output;\n  }\n  return JSON.stringify(output, null, 2);\n}\n\nconst TOOL_OWNER_BY_NAME = new Map<string, symbol>();\nconst INFERABLE_JSON_SCHEMA_TYPES = [\n  'array',\n  'boolean',\n  'integer',\n  'null',\n  'number',\n  'object',\n  'string',\n] as const;\nconst UNSUPPORTED_OUTPUT_SCHEMA_KEYS = ['$ref', 'allOf', 'anyOf', 'oneOf', 'not'] as const;\n\nfunction isInferableJsonSchemaType(\n  value: unknown\n): value is (typeof INFERABLE_JSON_SCHEMA_TYPES)[number] {\n  return (\n    typeof value === 'string' &&\n    INFERABLE_JSON_SCHEMA_TYPES.includes(value as (typeof INFERABLE_JSON_SCHEMA_TYPES)[number])\n  );\n}\n\nfunction unsupportedOutputSchema(detail: string): never {\n  throw new Error(`Unsupported outputSchema: ${detail}`);\n}\n\nfunction assertInferableJsonSchema(\n  value: unknown,\n  path = '$'\n): asserts value is JsonSchemaForInference {\n  if (!isPlainObject(value)) {\n    unsupportedOutputSchema(`${path} must be a JSON Schema object`);\n  }\n\n  for (const key of UNSUPPORTED_OUTPUT_SCHEMA_KEYS) {\n    if (key in value) {\n      unsupportedOutputSchema(`${path}.${key} is outside the inferable JSON Schema subset`);\n    }\n  }\n\n  const schemaTypes =\n    typeof value.type === 'string'\n      ? [value.type]\n      : Array.isArray(value.type)\n        ? value.type\n        : undefined;\n  if (\n    !schemaTypes?.length ||\n    !schemaTypes.every((schemaType) => isInferableJsonSchemaType(schemaType))\n  ) {\n    unsupportedOutputSchema(`${path} must declare an inferable JSON Schema type`);\n  }\n\n  const requiredValue = value.required;\n  if (\n    requiredValue !== undefined &&\n    (!Array.isArray(requiredValue) || requiredValue.some((entry) => typeof entry !== 'string'))\n  ) {\n    unsupportedOutputSchema(`${path}.required must be an array of strings`);\n  }\n\n  if (schemaTypes.includes('array')) {\n    if (!isPlainObject(value.items)) {\n      unsupportedOutputSchema(`${path}.items must be an inferable schema for array outputs`);\n    }\n    assertInferableJsonSchema(value.items, `${path}.items`);\n  }\n\n  if (schemaTypes.includes('object')) {\n    if (value.properties !== undefined && !isPlainObject(value.properties)) {\n      unsupportedOutputSchema(`${path}.properties must be an object`);\n    }\n\n    if (isPlainObject(value.properties)) {\n      for (const [key, propertySchema] of Object.entries(value.properties)) {\n        assertInferableJsonSchema(propertySchema, `${path}.properties.${key}`);\n      }\n    }\n\n    if (\n      value.additionalProperties !== undefined &&\n      typeof value.additionalProperties !== 'boolean'\n    ) {\n      assertInferableJsonSchema(value.additionalProperties, `${path}.additionalProperties`);\n    }\n  }\n}\n\nconst useIsomorphicLayoutEffect = typeof window !== 'undefined' ? useLayoutEffect : useEffect;\n\n/**\n * React hook for registering and managing Model Context Protocol (MCP) tools.\n *\n * This hook handles the complete lifecycle of an MCP tool:\n * - Registers the tool with `window.document.modelContext`\n * - Manages execution state (loading, results, errors)\n * - Handles tool execution and lifecycle callbacks\n * - Automatically unregisters on component unmount\n * - Returns `structuredContent` when `outputSchema` is defined\n *\n * ## Output Schema (Recommended)\n *\n * Always define an `outputSchema` for your tools. This provides:\n * - **Type Safety**: Handler return type is inferred from the schema\n * - **MCP structuredContent**: AI models receive structured, typed data\n * - **Better AI Understanding**: Models can reason about your tool's output format\n *\n * ```tsx\n * useWebMCP({\n *   name: 'get_user',\n *   description: 'Get user by ID',\n *   inputSchema: {\n *     type: 'object',\n *     properties: { userId: { type: 'string' } },\n *     required: ['userId'],\n *   } as const,\n *   outputSchema: {\n *     type: 'object',\n *     properties: {\n *       id: { type: 'string' },\n *       name: { type: 'string' },\n *       email: { type: 'string' },\n *     },\n *   } as const,\n *   handler: async ({ userId }) => {\n *     const user = await fetchUser(userId);\n *     return { id: user.id, name: user.name, email: user.email };\n *   },\n * });\n * ```\n *\n * @template TInputSchema - JSON Schema defining input parameter types (use `as const` for inference)\n * @template TOutputSchema - JSON Schema defining output structure\n *\n * @param config - Configuration object for the tool\n * @param deps - Optional dependency array that triggers tool re-registration when values change.\n *\n * @returns Object containing execution state and control methods\n *\n * @public\n */\nexport function useWebMCP<\n  TInputSchema extends ReactWebMCPInputSchema = InputSchema,\n  TOutputSchema extends ReactWebMCPOutputSchema | undefined = undefined,\n>(\n  config: WebMCPConfig<TInputSchema, TOutputSchema>,\n  deps?: DependencyList\n): WebMCPReturn<TOutputSchema, TInputSchema> {\n  type TOutput = InferOutput<TOutputSchema>;\n  type TInput = InferToolInput<TInputSchema>;\n  const {\n    name,\n    description,\n    inputSchema,\n    outputSchema,\n    annotations,\n    handler,\n    formatOutput = defaultFormatOutput,\n    onSuccess,\n    onError,\n  } = config;\n\n  const [state, setState] = useState<ToolExecutionState<TOutput>>({\n    isExecuting: false,\n    lastResult: null,\n    error: null,\n    executionCount: 0,\n  });\n\n  const handlerRef = useRef(handler);\n  const onSuccessRef = useRef(onSuccess);\n  const onErrorRef = useRef(onError);\n  const formatOutputRef = useRef(formatOutput);\n  const isMountedRef = useRef(true);\n  // Keep the registered handler current without re-registering the tool.\n  useIsomorphicLayoutEffect(() => {\n    handlerRef.current = handler;\n    onSuccessRef.current = onSuccess;\n    onErrorRef.current = onError;\n    formatOutputRef.current = formatOutput;\n  }, [handler, onSuccess, onError, formatOutput]);\n\n  // Cleanup: mark component as unmounted\n  useEffect(() => {\n    isMountedRef.current = true;\n    return () => {\n      isMountedRef.current = false;\n    };\n  }, []);\n\n  /**\n   * Executes the tool handler with input validation and state management.\n   *\n   * @param input - The input parameters to validate and pass to the handler\n   * @returns Promise resolving to the handler's output\n   * @throws Error if validation fails or the handler throws\n   */\n  const execute = useCallback(async (input: TInput): Promise<TOutput> => {\n    setState((prev) => ({\n      ...prev,\n      isExecuting: true,\n      error: null,\n    }));\n\n    try {\n      const result = await handlerRef.current(input);\n\n      // Only update state if component is still mounted\n      if (isMountedRef.current) {\n        setState((prev) => ({\n          isExecuting: false,\n          lastResult: result,\n          error: null,\n          executionCount: prev.executionCount + 1,\n        }));\n      }\n\n      if (onSuccessRef.current) {\n        onSuccessRef.current(result, input);\n      }\n\n      return result;\n    } catch (error) {\n      const err = error instanceof Error ? error : new Error(String(error));\n\n      // Only update state if component is still mounted\n      if (isMountedRef.current) {\n        setState((prev) => ({\n          ...prev,\n          isExecuting: false,\n          error: err,\n        }));\n      }\n\n      if (onErrorRef.current) {\n        onErrorRef.current(err, input);\n      }\n\n      throw err;\n    }\n  }, []);\n  const executeRef = useRef(execute);\n\n  useEffect(() => {\n    executeRef.current = execute;\n  }, [execute]);\n\n  const stableExecute = useCallback(\n    (input: TInput): Promise<TOutput> => executeRef.current(input),\n    []\n  );\n\n  /**\n   * Resets the execution state to initial values.\n   */\n  const reset = useCallback(() => {\n    setState({\n      isExecuting: false,\n      lastResult: null,\n      error: null,\n      executionCount: 0,\n    });\n  }, []);\n\n  useEffect(() => {\n    const modelContext = getModelContext();\n    if (!modelContext) {\n      console.warn(\n        '[ReactWebMCP:useWebMCP]',\n        `Tool \"${name}\" skipped: modelContext is not available`\n      );\n      return;\n    }\n\n    const resolvedInputSchema = isZodSchema(inputSchema)\n      ? zodToJsonSchema(inputSchema)\n      : normalizeInputSchema(inputSchema).inputSchema;\n    let resolvedOutputSchema: JsonSchemaForInference | undefined;\n    if (outputSchema) {\n      const jsonSchema =\n        isZodSchema(outputSchema) || isZodType(outputSchema)\n          ? zodToJsonSchema(outputSchema)\n          : outputSchema;\n      assertInferableJsonSchema(jsonSchema);\n      resolvedOutputSchema = jsonSchema;\n    }\n    const mcpHandler = async (input: unknown): Promise<CallToolResult> => {\n      try {\n        const result = await Reflect.apply(executeRef.current, undefined, [input]);\n        const formattedOutput = formatOutputRef.current(result);\n\n        const response: CallToolResult = {\n          content: [\n            {\n              type: 'text',\n              text: formattedOutput,\n            },\n          ],\n        };\n\n        if (resolvedOutputSchema) {\n          const structuredContent = toJsonValue(result);\n          if (structuredContent === undefined) {\n            throw new Error(\n              `Tool \"${name}\" outputSchema requires the handler to return a JSON-serializable result`\n            );\n          }\n          response.structuredContent = structuredContent;\n        }\n\n        return response;\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error);\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Error: ${errorMessage}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    };\n\n    const ownerToken = Symbol(name);\n    const toolDescriptor: ToolDescriptor & { inputSchema: InputSchema } = {\n      name,\n      description,\n      inputSchema: resolvedInputSchema,\n      ...(resolvedOutputSchema && { outputSchema: resolvedOutputSchema }),\n      ...(annotations && { annotations }),\n      execute: mcpHandler,\n    };\n    const controller = new AbortController();\n    let registered = false;\n    let disposed = false;\n\n    try {\n      const registerResult = modelContext.registerTool(toolDescriptor, {\n        signal: controller.signal,\n      });\n\n      void Promise.resolve(registerResult).then(\n        () => {\n          if (!disposed && !controller.signal.aborted) {\n            registered = true;\n            TOOL_OWNER_BY_NAME.set(name, ownerToken);\n          }\n        },\n        (error: unknown) => {\n          if (!controller.signal.aborted) {\n            controller.abort();\n            console.warn(`[ReactWebMCP:useWebMCP] registerTool(\"${name}\") rejected:`, error);\n          }\n        }\n      );\n    } catch (error) {\n      controller.abort();\n      console.warn(`[ReactWebMCP:useWebMCP] registerTool(\"${name}\") rejected:`, error);\n      return;\n    }\n\n    return () => {\n      disposed = true;\n\n      if (registered && TOOL_OWNER_BY_NAME.get(name) === ownerToken) {\n        TOOL_OWNER_BY_NAME.delete(name);\n        controller.abort();\n        return;\n      }\n\n      if (!registered) {\n        controller.abort();\n      }\n    };\n    // Spread operator in dependencies intentionally allows consumers to trigger\n    // re-registration with custom reactive inputs.\n  }, [name, description, ...(deps ?? [])]);\n\n  return {\n    state,\n    execute: stableExecute,\n    reset,\n  };\n}\n","import { useMemo, useRef } from 'react';\nimport type { WebMCPReturn } from './types.js';\nimport { useWebMCP } from './useWebMCP.js';\n\n/**\n * Convenience hook for exposing read-only context data to AI assistants.\n *\n * This is a simplified wrapper around {@link useWebMCP} specifically designed for\n * context tools that expose data without performing actions. The hook automatically\n * configures appropriate annotations (read-only, idempotent) and handles value\n * serialization.\n *\n * Note: This hook does not use an output schema, so the result will not include\n * `structuredContent` in the MCP response. Use {@link useWebMCP} directly with\n * `outputSchema` if you need structured output for MCP compliance.\n *\n * @template T - The type of context data to expose\n *\n * @param name - Unique identifier for the context tool (e.g., 'context_current_post')\n * @param description - Human-readable description of the context for AI assistants\n * @param getValue - Function that returns the current context value\n * @returns Tool execution state and control methods\n *\n * @public\n *\n * @example\n * Expose current post context:\n * ```tsx\n * function PostDetailPage() {\n *   const { postId } = useParams();\n *   const { data: post } = useQuery(['post', postId], () => fetchPost(postId));\n *\n *   useWebMCPContext(\n *     'context_current_post',\n *     'Get the currently viewed post ID and metadata',\n *     () => ({\n *       postId,\n *       title: post?.title,\n *       author: post?.author,\n *       tags: post?.tags,\n *       createdAt: post?.createdAt,\n *     })\n *   );\n *\n *   return <PostContent post={post} />;\n * }\n * ```\n *\n * @example\n * Expose user session context:\n * ```tsx\n * function AppRoot() {\n *   const { user, isAuthenticated } = useAuth();\n *\n *   useWebMCPContext(\n *     'context_user_session',\n *     'Get the current user session information',\n *     () => ({\n *       isAuthenticated,\n *       userId: user?.id,\n *       email: user?.email,\n *       permissions: user?.permissions,\n *     })\n *   );\n *\n *   return <App />;\n * }\n * ```\n */\nexport function useWebMCPContext<T>(\n  name: string,\n  description: string,\n  getValue: () => T\n): WebMCPReturn {\n  const getValueRef = useRef(getValue);\n  getValueRef.current = getValue;\n  const annotations = useMemo(\n    () => ({\n      title: `Context: ${name}`,\n      readOnlyHint: true,\n      idempotentHint: true,\n      destructiveHint: false,\n      openWorldHint: false,\n    }),\n    [name]\n  );\n\n  // Use default generics (no input/output schema) since context tools\n  // don't define structured schemas. The handler returns T but it's\n  // treated as `unknown` in the return type since no outputSchema is defined.\n  return useWebMCP({\n    name,\n    description,\n    annotations,\n    // Cast to unknown since context tools return arbitrary types\n    // that don't need to conform to a specific schema\n    handler: async (_input: Record<string, unknown>) => {\n      return getValueRef.current() as Record<string, unknown>;\n    },\n    formatOutput: (output) => {\n      if (typeof output === 'string') {\n        return output as string;\n      }\n      return JSON.stringify(output, null, 2);\n    },\n  });\n}\n","import type { InputSchema } from '@mcp-b/webmcp-types';\nimport { normalizeInputSchema } from '@mcp-b/webmcp-polyfill/schema';\nimport { useEffect, useRef, useState } from 'react';\nimport type {\n  PromptMessage,\n  ReactWebMCPInputSchema,\n  WebMCPPromptConfig,\n  WebMCPPromptReturn,\n} from './types.js';\nimport { getModelContext, type ModelContextSurface } from './model-context.js';\nimport { isZodSchema, zodToJsonSchema } from './zod-utils.js';\n\ntype PromptModelContext = ModelContextSurface & {\n  registerPrompt: (descriptor: {\n    name: string;\n    description?: string;\n    argsSchema?: InputSchema;\n    get: (args: Record<string, unknown>) => Promise<{ messages: PromptMessage[] }>;\n  }) => { unregister: () => void } | undefined;\n};\n\n/**\n * React hook for registering Model Context Protocol (MCP) prompts.\n *\n * This hook handles the complete lifecycle of an MCP prompt:\n * - Registers the prompt with `window.document.modelContext`\n * - Converts Zod schemas to JSON Schema for argument validation\n * - Automatically unregisters on component unmount\n *\n * @template TArgsSchema - Zod schema object defining argument types\n *\n * @param config - Configuration object for the prompt\n * @returns Object indicating registration status\n *\n * @public\n *\n * @example\n * Simple prompt without arguments:\n * ```tsx\n * function HelpPrompt() {\n *   const { isRegistered } = useWebMCPPrompt({\n *     name: 'help',\n *     description: 'Get help with using the application',\n *     get: async () => ({\n *       messages: [{\n *         role: 'user',\n *         content: { type: 'text', text: 'How do I use this application?' }\n *       }]\n *     }),\n *   });\n *\n *   return <div>Help prompt {isRegistered ? 'ready' : 'loading'}</div>;\n * }\n * ```\n *\n * @example\n * Prompt with typed arguments:\n * ```tsx\n * function CodeReviewPrompt() {\n *   const { isRegistered } = useWebMCPPrompt({\n *     name: 'review_code',\n *     description: 'Review code for best practices',\n *     argsSchema: {\n *       type: 'object',\n *       properties: {\n *         code: { type: 'string', description: 'The code to review' },\n *         language: { type: 'string', description: 'Programming language' },\n *       },\n *       required: ['code'],\n *     } as const,\n *     get: async ({ code, language }) => ({\n *       messages: [{\n *         role: 'user',\n *         content: {\n *           type: 'text',\n *           text: `Please review this ${language ?? ''} code:\\n\\n${code}`\n *         }\n *       }]\n *     }),\n *   });\n *\n *   return <div>Code review prompt {isRegistered ? 'ready' : 'loading'}</div>;\n * }\n * ```\n */\nexport function useWebMCPPrompt<TArgsSchema extends ReactWebMCPInputSchema = InputSchema>(\n  config: WebMCPPromptConfig<TArgsSchema>\n): WebMCPPromptReturn {\n  const { name, description, argsSchema, get } = config;\n\n  const [isRegistered, setIsRegistered] = useState(false);\n\n  const getRef = useRef(get);\n\n  useEffect(() => {\n    getRef.current = get;\n  }, [get]);\n\n  useEffect(() => {\n    const modelContext = getModelContext() as PromptModelContext | undefined;\n    if (!modelContext) {\n      console.warn(\n        `[ReactWebMCP] window.document.modelContext is not available. Prompt \"${name}\" will not be registered.`\n      );\n      return;\n    }\n\n    const promptHandler = async (\n      args: Record<string, unknown>\n    ): Promise<{ messages: PromptMessage[] }> => {\n      return getRef.current(args as never);\n    };\n\n    const resolvedArgsSchema = argsSchema\n      ? isZodSchema(argsSchema)\n        ? zodToJsonSchema(argsSchema)\n        : normalizeInputSchema(argsSchema).inputSchema\n      : undefined;\n\n    let registration: { unregister: () => void } | undefined;\n    try {\n      registration = modelContext.registerPrompt({\n        name,\n        ...(description !== undefined && { description }),\n        ...(resolvedArgsSchema && { argsSchema: resolvedArgsSchema }),\n        get: promptHandler,\n      });\n    } catch (error) {\n      setIsRegistered(false);\n      throw error;\n    }\n\n    if (!registration) {\n      console.warn(`[ReactWebMCP] Prompt \"${name}\" did not return a registration handle.`);\n      setIsRegistered(false);\n      return;\n    }\n\n    setIsRegistered(true);\n\n    return () => {\n      registration.unregister();\n      setIsRegistered(false);\n    };\n  }, [name, description, argsSchema]);\n\n  return {\n    isRegistered,\n  };\n}\n","import { useEffect, useRef, useState } from 'react';\nimport { getModelContext, type ModelContextSurface } from './model-context.js';\nimport type { ResourceContents, WebMCPResourceConfig, WebMCPResourceReturn } from './types.js';\n\ntype ResourceModelContext = ModelContextSurface & {\n  registerResource: (descriptor: {\n    uri: string;\n    name: string;\n    description?: string;\n    mimeType?: string;\n    read: (uri: URL, params?: Record<string, string>) => Promise<{ contents: ResourceContents[] }>;\n  }) => { unregister: () => void } | undefined;\n};\n\n/**\n * React hook for registering Model Context Protocol (MCP) resources.\n *\n * This hook handles the complete lifecycle of an MCP resource:\n * - Registers the resource with `window.document.modelContext`\n * - Supports both static URIs and URI templates with parameters\n * - Automatically unregisters on component unmount\n *\n * @param config - Configuration object for the resource\n * @returns Object indicating registration status\n *\n * @public\n *\n * @example\n * Static resource:\n * ```tsx\n * function AppSettingsResource() {\n *   const { isRegistered } = useWebMCPResource({\n *     uri: 'config://app-settings',\n *     name: 'App Settings',\n *     description: 'Application configuration',\n *     mimeType: 'application/json',\n *     read: async (uri) => ({\n *       contents: [{\n *         uri: uri.href,\n *         text: JSON.stringify({ theme: 'dark', language: 'en' })\n *       }]\n *     }),\n *   });\n *\n *   return <div>Settings resource {isRegistered ? 'ready' : 'loading'}</div>;\n * }\n * ```\n *\n * @example\n * Dynamic resource with URI template:\n * ```tsx\n * function UserProfileResource() {\n *   const { isRegistered } = useWebMCPResource({\n *     uri: 'user://{userId}/profile',\n *     name: 'User Profile',\n *     description: 'User profile data by ID',\n *     mimeType: 'application/json',\n *     read: async (uri, params) => {\n *       const userId = params?.userId ?? '';\n *       const profile = await fetchUserProfile(userId);\n *       return {\n *         contents: [{\n *           uri: uri.href,\n *           text: JSON.stringify(profile)\n *         }]\n *       };\n *     },\n *   });\n *\n *   return <div>User profile resource {isRegistered ? 'ready' : 'loading'}</div>;\n * }\n * ```\n */\nexport function useWebMCPResource(config: WebMCPResourceConfig): WebMCPResourceReturn {\n  const { uri, name, description, mimeType, read } = config;\n\n  const [isRegistered, setIsRegistered] = useState(false);\n\n  const readRef = useRef(read);\n\n  useEffect(() => {\n    readRef.current = read;\n  }, [read]);\n\n  useEffect(() => {\n    const modelContext = getModelContext() as ResourceModelContext | undefined;\n    if (!modelContext) {\n      console.warn(\n        `[ReactWebMCP] window.document.modelContext is not available. Resource \"${uri}\" will not be registered.`\n      );\n      return;\n    }\n\n    const resourceHandler = async (\n      resolvedUri: URL,\n      params?: Record<string, string>\n    ): Promise<{ contents: ResourceContents[] }> => {\n      return readRef.current(resolvedUri, params);\n    };\n\n    let registration: { unregister: () => void } | undefined;\n    try {\n      registration = modelContext.registerResource({\n        uri,\n        name,\n        ...(description !== undefined && { description }),\n        ...(mimeType !== undefined && { mimeType }),\n        read: resourceHandler,\n      });\n    } catch (error) {\n      setIsRegistered(false);\n      throw error;\n    }\n\n    if (!registration) {\n      console.warn(`[ReactWebMCP] Resource \"${uri}\" did not return a registration handle.`);\n      setIsRegistered(false);\n      return;\n    }\n\n    setIsRegistered(true);\n\n    return () => {\n      registration.unregister();\n      setIsRegistered(false);\n    };\n  }, [uri, name, description, mimeType]);\n\n  return {\n    isRegistered,\n  };\n}\n","import type { ElicitationParams, ElicitationResult } from '@mcp-b/webmcp-types';\nimport { useCallback, useState } from 'react';\nimport { getModelContext, type ModelContextSurface } from './model-context.js';\n\ntype ElicitationModelContext = ModelContextSurface & {\n  elicitInput: (params: ElicitationParams) => Promise<ElicitationResult>;\n};\n\n/**\n * State for elicitation requests, tracking the current request and results.\n */\nexport interface ElicitationState {\n  /** Whether an elicitation request is currently in progress */\n  isLoading: boolean;\n  /** The last elicitation result received */\n  result: ElicitationResult | null;\n  /** Any error that occurred during the last request */\n  error: Error | null;\n  /** Total number of requests made */\n  requestCount: number;\n}\n\n/**\n * Configuration options for the useElicitation hook.\n */\nexport interface UseElicitationConfig {\n  /**\n   * Optional callback invoked when an elicitation request completes successfully.\n   */\n  onSuccess?: (result: ElicitationResult) => void;\n\n  /**\n   * Optional callback invoked when an elicitation request fails.\n   */\n  onError?: (error: Error) => void;\n}\n\n/**\n * Return value from the useElicitation hook.\n */\nexport interface UseElicitationReturn {\n  /** Current state of elicitation */\n  state: ElicitationState;\n  /** Function to request user input from the connected client */\n  elicitInput: (params: ElicitationParams) => Promise<ElicitationResult>;\n  /** Reset the state */\n  reset: () => void;\n}\n\n/**\n * React hook for requesting user input from the connected MCP client.\n *\n * Elicitation allows the server (webpage) to request user input from the\n * connected client. This is useful when the page needs additional information\n * from the user, such as API keys, configuration options, or confirmations.\n *\n * There are two modes:\n * 1. **Form mode**: For non-sensitive data collection using a schema-driven form.\n * 2. **URL mode**: For sensitive data collection via a web URL (API keys, OAuth, etc.).\n *\n * @param config - Optional configuration including callbacks\n * @returns Object containing state and the elicitInput function\n *\n * @example Form elicitation:\n * ```tsx\n * function ConfigForm() {\n *   const { state, elicitInput } = useElicitation({\n *     onSuccess: (result) => console.log('Got input:', result),\n *     onError: (error) => console.error('Elicitation failed:', error),\n *   });\n *\n *   const handleConfigure = async () => {\n *     const result = await elicitInput({\n *       message: 'Please provide your configuration',\n *       requestedSchema: {\n *         type: 'object',\n *         properties: {\n *           apiKey: { type: 'string', title: 'API Key', description: 'Your API key' },\n *           model: { type: 'string', enum: ['gpt-4', 'gpt-3.5'], title: 'Model' }\n *         },\n *         required: ['apiKey']\n *       }\n *     });\n *\n *     if (result.action === 'accept') {\n *       console.log('Config:', result.content);\n *     }\n *   };\n *\n *   return (\n *     <button onClick={handleConfigure} disabled={state.isLoading}>\n *       Configure\n *     </button>\n *   );\n * }\n * ```\n *\n * @example URL elicitation (for sensitive data):\n * ```tsx\n * const { elicitInput } = useElicitation();\n *\n * const handleOAuth = async () => {\n *   const result = await elicitInput({\n *     mode: 'url',\n *     message: 'Please authenticate with GitHub',\n *     elicitationId: 'github-oauth-123',\n *     url: 'https://github.com/login/oauth/authorize?client_id=...'\n *   });\n *\n *   if (result.action === 'accept') {\n *     console.log('OAuth completed');\n *   }\n * };\n * ```\n */\nexport function useElicitation(config: UseElicitationConfig = {}): UseElicitationReturn {\n  const { onSuccess, onError } = config;\n\n  const [state, setState] = useState<ElicitationState>({\n    isLoading: false,\n    result: null,\n    error: null,\n    requestCount: 0,\n  });\n\n  const reset = useCallback(() => {\n    setState({\n      isLoading: false,\n      result: null,\n      error: null,\n      requestCount: 0,\n    });\n  }, []);\n\n  const elicitInput = useCallback(\n    async (params: ElicitationParams): Promise<ElicitationResult> => {\n      const mc = getModelContext() as ElicitationModelContext | undefined;\n      if (!mc) {\n        throw new Error('document.modelContext is not available');\n      }\n\n      setState((prev) => ({\n        ...prev,\n        isLoading: true,\n        error: null,\n      }));\n\n      try {\n        const result: ElicitationResult = await mc.elicitInput(params);\n\n        setState((prev) => ({\n          isLoading: false,\n          result,\n          error: null,\n          requestCount: prev.requestCount + 1,\n        }));\n\n        onSuccess?.(result);\n        return result;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err));\n\n        setState((prev) => ({\n          ...prev,\n          isLoading: false,\n          error,\n        }));\n\n        onError?.(error);\n        throw error;\n      }\n    },\n    [onSuccess, onError]\n  );\n\n  return {\n    state,\n    elicitInput,\n    reset,\n  };\n}\n\n// Also export with the old name for backwards compatibility during migration\nexport { useElicitation as useElicitationHandler };\nexport type { ElicitationState as ElicitationHandlerState };\nexport type { UseElicitationConfig as UseElicitationHandlerConfig };\nexport type { UseElicitationReturn as UseElicitationHandlerReturn };\n","import type { SamplingRequestParams, SamplingResult } from '@mcp-b/webmcp-ts-sdk';\nimport { useCallback, useState } from 'react';\nimport { getModelContext, type ModelContextSurface } from './model-context.js';\n\ntype SamplingModelContext = ModelContextSurface & {\n  createMessage: (params: SamplingRequestParams) => Promise<SamplingResult>;\n};\n\n/**\n * State for sampling requests, tracking the current request and results.\n */\nexport interface SamplingState {\n  /** Whether a sampling request is currently in progress */\n  isLoading: boolean;\n  /** The last sampling result received */\n  result: SamplingResult | null;\n  /** Any error that occurred during the last request */\n  error: Error | null;\n  /** Total number of requests made */\n  requestCount: number;\n}\n\n/**\n * Configuration options for the useSampling hook.\n */\nexport interface UseSamplingConfig {\n  /**\n   * Optional callback invoked when a sampling request completes successfully.\n   */\n  onSuccess?: (result: SamplingResult) => void;\n\n  /**\n   * Optional callback invoked when a sampling request fails.\n   */\n  onError?: (error: Error) => void;\n}\n\n/**\n * Return value from the useSampling hook.\n */\nexport interface UseSamplingReturn {\n  /** Current state of sampling */\n  state: SamplingState;\n  /** Function to request LLM completion from the connected client */\n  createMessage: (params: SamplingRequestParams) => Promise<SamplingResult>;\n  /** Reset the state */\n  reset: () => void;\n}\n\n/**\n * React hook for requesting LLM completions from the connected MCP client.\n *\n * Sampling allows the server (webpage) to request LLM completions from the\n * connected client. This is useful when the page needs AI capabilities like\n * summarization, generation, or analysis.\n *\n * @param config - Optional configuration including callbacks\n * @returns Object containing state and the createMessage function\n *\n * @example Basic usage:\n * ```tsx\n * function AIAssistant() {\n *   const { state, createMessage } = useSampling({\n *     onSuccess: (result) => console.log('Got response:', result),\n *     onError: (error) => console.error('Sampling failed:', error),\n *   });\n *\n *   const handleAsk = async () => {\n *     const result = await createMessage({\n *       messages: [\n *         { role: 'user', content: { type: 'text', text: 'What is 2+2?' } }\n *       ],\n *       maxTokens: 100,\n *     });\n *     console.log(result.content);\n *   };\n *\n *   return (\n *     <div>\n *       <button onClick={handleAsk} disabled={state.isLoading}>\n *         Ask AI\n *       </button>\n *       {state.result && <p>{JSON.stringify(state.result.content)}</p>}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useSampling(config: UseSamplingConfig = {}): UseSamplingReturn {\n  const { onSuccess, onError } = config;\n\n  const [state, setState] = useState<SamplingState>({\n    isLoading: false,\n    result: null,\n    error: null,\n    requestCount: 0,\n  });\n\n  const reset = useCallback(() => {\n    setState({\n      isLoading: false,\n      result: null,\n      error: null,\n      requestCount: 0,\n    });\n  }, []);\n\n  const createMessage = useCallback(\n    async (params: SamplingRequestParams): Promise<SamplingResult> => {\n      const modelContext = getModelContext() as SamplingModelContext | undefined;\n      if (!modelContext) {\n        throw new Error('document.modelContext is not available');\n      }\n\n      setState((prev) => ({\n        ...prev,\n        isLoading: true,\n        error: null,\n      }));\n\n      try {\n        const result = await modelContext.createMessage(params);\n\n        setState((prev) => ({\n          isLoading: false,\n          result,\n          error: null,\n          requestCount: prev.requestCount + 1,\n        }));\n\n        onSuccess?.(result);\n        return result;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err));\n\n        setState((prev) => ({\n          ...prev,\n          isLoading: false,\n          error,\n        }));\n\n        onError?.(error);\n        throw error;\n      }\n    },\n    [onSuccess, onError]\n  );\n\n  return {\n    state,\n    createMessage,\n    reset,\n  };\n}\n\n// Also export with the old name for backwards compatibility during migration\nexport { useSampling as useSamplingHandler };\nexport type { SamplingState as SamplingHandlerState };\nexport type { UseSamplingConfig as UseSamplingHandlerConfig };\nexport type { UseSamplingReturn as UseSamplingHandlerReturn };\n","import {\n  type Client,\n  type Tool as McpTool,\n  type RequestOptions,\n  type Resource,\n  ResourceListChangedNotificationSchema,\n  type ServerCapabilities,\n  ToolListChangedNotificationSchema,\n  type Transport,\n} from '@mcp-b/webmcp-ts-sdk';\nimport {\n  createContext,\n  type ReactElement,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useRef,\n  useState,\n} from 'react';\n\n/**\n * Context value provided by McpClientProvider.\n *\n * @internal\n */\ninterface McpClientContextValue {\n  client: Client;\n  tools: McpTool[];\n  resources: Resource[];\n  isConnected: boolean;\n  isLoading: boolean;\n  error: Error | null;\n  capabilities: ServerCapabilities | null;\n  reconnect: () => Promise<void>;\n}\n\nconst McpClientContext = createContext<McpClientContextValue | null>(null);\nconst EMPTY_REQUEST_OPTS: RequestOptions = {};\nconst TOOL_FLOW_TRACE_KEY = 'WEBMCP_TRACE_TOOL_FLOW';\n\nfunction emitForcedToolFlowTrace(event: string, details: Record<string, unknown>): void {\n  const consoleRef = globalThis.console;\n  if (!consoleRef) {\n    return;\n  }\n\n  const method = consoleRef.debug ?? consoleRef.log;\n  if (typeof method !== 'function') {\n    return;\n  }\n\n  method.call(consoleRef, '[ReactWebMCP:McpClientProvider:ToolFlow]', event, details);\n}\n\nfunction isToolFlowTraceEnabled(): boolean {\n  if (typeof window === 'undefined') {\n    return false;\n  }\n\n  try {\n    return window.localStorage.getItem(TOOL_FLOW_TRACE_KEY) === '1';\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Props for the McpClientProvider component.\n *\n * @public\n */\nexport interface McpClientProviderProps {\n  /**\n   * React children to render within the provider.\n   */\n  children: ReactNode;\n\n  /**\n   * MCP Client instance to use for communication.\n   */\n  client: Client;\n\n  /**\n   * Transport instance for the client to connect through.\n   */\n  transport: Transport;\n\n  /**\n   * Optional request options for the connection.\n   */\n  opts?: RequestOptions;\n}\n\n/**\n * Provider component that manages an MCP client connection and exposes\n * tools, resources, and connection state to child components.\n *\n * This provider handles:\n * - Establishing and maintaining the MCP client connection\n * - Fetching available tools and resources from the server\n * - Listening for server notifications about tool/resource changes\n * - Managing connection state and errors\n * - Automatic cleanup on unmount\n *\n * @param props - Component props\n * @returns Provider component wrapping children\n *\n * @public\n *\n * @example\n * Connect to an MCP server via tab transport:\n * ```tsx\n * import { Client } from '@modelcontextprotocol/sdk/client/index.js';\n * import { TabClientTransport } from '@mcp-b/transports';\n * import { McpClientProvider } from '@mcp-b/react-webmcp';\n *\n * const client = new Client(\n *   { name: 'my-app', version: '1.0.0' },\n *   { capabilities: {} }\n * );\n *\n * const transport = new TabClientTransport('mcp', {\n *   clientInstanceId: 'my-app-instance',\n * });\n *\n * function App() {\n *   return (\n *     <McpClientProvider client={client} transport={transport}>\n *       <MyAppContent />\n *     </McpClientProvider>\n *   );\n * }\n * ```\n *\n * @example\n * Access tools from child components:\n * ```tsx\n * function MyAppContent() {\n *   const { tools, isConnected, isLoading } = useMcpClient();\n *\n *   if (isLoading) {\n *     return <div>Connecting to MCP server...</div>;\n *   }\n *\n *   if (!isConnected) {\n *     return <div>Failed to connect to MCP server</div>;\n *   }\n *\n *   return (\n *     <div>\n *       <h2>Available Tools:</h2>\n *       <ul>\n *         {tools.map(tool => (\n *           <li key={tool.name}>{tool.description}</li>\n *         ))}\n *       </ul>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function McpClientProvider({\n  children,\n  client,\n  transport,\n  opts,\n}: McpClientProviderProps): ReactElement {\n  const [resources, setResources] = useState<Resource[]>([]);\n  const [tools, setTools] = useState<McpTool[]>([]);\n  const [isLoading, setIsLoading] = useState<boolean>(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [isConnected, setIsConnected] = useState<boolean>(false);\n  const [capabilities, setCapabilities] = useState<ServerCapabilities | null>(null);\n  const requestOpts = opts ?? EMPTY_REQUEST_OPTS;\n\n  const connectionStateRef = useRef<'disconnected' | 'connecting' | 'connected'>('disconnected');\n  const toolFlowSequenceRef = useRef(0);\n  const logToolFlow = useCallback((event: string, details: Record<string, unknown> = {}) => {\n    const sequence = ++toolFlowSequenceRef.current;\n    const message = `[${sequence}] ${event}`;\n\n    if (isToolFlowTraceEnabled()) {\n      emitForcedToolFlowTrace(message, details);\n    }\n  }, []);\n\n  /**\n   * Fetches available resources from the MCP server.\n   * Only fetches if the server supports the resources capability.\n   */\n  const fetchResourcesInternal = useCallback(async () => {\n    if (!client) return;\n\n    const serverCapabilities = client.getServerCapabilities();\n    if (!serverCapabilities?.resources) {\n      setResources([]);\n      return;\n    }\n\n    try {\n      const response = await client.listResources();\n      setResources(response.resources);\n    } catch (e) {\n      console.error('[ReactWebMCP:McpClientProvider]', 'Error fetching resources:', e);\n      throw e;\n    }\n  }, [client]);\n\n  /**\n   * Fetches available tools from the MCP server.\n   * Only fetches if the server supports the tools capability.\n   */\n  const fetchToolsInternal = useCallback(async () => {\n    if (!client) return;\n\n    const serverCapabilities = client.getServerCapabilities();\n    if (!serverCapabilities?.tools) {\n      logToolFlow('listTools:capability_missing', {});\n      setTools([]);\n      return;\n    }\n\n    const startedAt = Date.now();\n    logToolFlow('listTools:start', {\n      hasToolsCapability: Boolean(serverCapabilities.tools),\n    });\n    try {\n      const response = await client.listTools();\n      setTools(response.tools);\n      logToolFlow('listTools:success', {\n        durationMs: Date.now() - startedAt,\n        toolCount: response.tools.length,\n      });\n    } catch (e) {\n      logToolFlow('listTools:error', {\n        durationMs: Date.now() - startedAt,\n        errorMessage: e instanceof Error ? e.message : String(e),\n      });\n      console.error('[ReactWebMCP:McpClientProvider]', 'Error fetching tools:', e);\n      throw e;\n    }\n  }, [client, logToolFlow]);\n\n  /**\n   * Establishes connection to the MCP server.\n   * Safe to call multiple times - will no-op if already connected or connecting.\n   */\n  const reconnect = useCallback(async () => {\n    if (!client || !transport) {\n      throw new Error('Client or transport not available');\n    }\n\n    if (connectionStateRef.current !== 'disconnected') {\n      return;\n    }\n\n    connectionStateRef.current = 'connecting';\n    setIsLoading(true);\n    setError(null);\n\n    try {\n      await client.connect(transport, requestOpts);\n      const caps = client.getServerCapabilities();\n      setIsConnected(true);\n      setCapabilities(caps || null);\n      connectionStateRef.current = 'connected';\n      logToolFlow('reconnect:connected', {\n        hasToolsListChanged: Boolean(caps?.tools?.listChanged),\n      });\n\n      await Promise.all([fetchResourcesInternal(), fetchToolsInternal()]);\n    } catch (e) {\n      const err = e instanceof Error ? e : new Error(String(e));\n      connectionStateRef.current = 'disconnected';\n      setError(err);\n      throw err;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [client, transport, requestOpts, fetchResourcesInternal, fetchToolsInternal, logToolFlow]);\n\n  useEffect(() => {\n    if (!isConnected || !client) {\n      return;\n    }\n\n    const serverCapabilities = client.getServerCapabilities();\n\n    const handleResourcesChanged = () => {\n      fetchResourcesInternal().catch((error) => {\n        console.error(\n          '[ReactWebMCP:McpClientProvider]',\n          'Failed to refresh resources after list_changed:',\n          error\n        );\n      });\n    };\n\n    const handleToolsChanged = () => {\n      logToolFlow('notification:tools/list_changed', {});\n      fetchToolsInternal().catch((error) => {\n        console.error(\n          '[ReactWebMCP:McpClientProvider]',\n          'Failed to refresh tools after list_changed:',\n          error\n        );\n      });\n    };\n\n    if (serverCapabilities?.resources?.listChanged) {\n      client.setNotificationHandler(ResourceListChangedNotificationSchema, handleResourcesChanged);\n    }\n\n    if (serverCapabilities?.tools?.listChanged) {\n      client.setNotificationHandler(ToolListChangedNotificationSchema, handleToolsChanged);\n    }\n\n    // Re-fetch after setting up handlers to catch any changes that occurred\n    // during the gap between initial fetch and handler setup\n    Promise.all([fetchResourcesInternal(), fetchToolsInternal()]).catch((error) => {\n      console.error(\n        '[ReactWebMCP:McpClientProvider]',\n        'Failed to refresh tools/resources after handler registration:',\n        error\n      );\n    });\n\n    return () => {\n      if (serverCapabilities?.resources?.listChanged) {\n        client.removeNotificationHandler('notifications/resources/list_changed');\n      }\n\n      if (serverCapabilities?.tools?.listChanged) {\n        client.removeNotificationHandler('notifications/tools/list_changed');\n      }\n    };\n  }, [client, isConnected, fetchResourcesInternal, fetchToolsInternal, logToolFlow]);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: intentional - reconnect when client/transport props change\n  useEffect(() => {\n    // Initial connection - reconnect() has its own guard to prevent concurrent connections\n    reconnect().catch((err) => {\n      console.error('[ReactWebMCP:McpClientProvider]', 'Failed to connect MCP client:', err);\n    });\n\n    // Cleanup: mark as disconnected so next mount will reconnect\n    return () => {\n      connectionStateRef.current = 'disconnected';\n      setIsConnected(false);\n    };\n  }, [client, transport, reconnect]);\n\n  return (\n    <McpClientContext.Provider\n      value={{\n        client,\n        tools,\n        resources,\n        isConnected,\n        isLoading,\n        error,\n        capabilities,\n        reconnect,\n      }}\n    >\n      {children}\n    </McpClientContext.Provider>\n  );\n}\n\n/**\n * Hook to access the MCP client context.\n * Must be used within an {@link McpClientProvider}.\n *\n * @returns The MCP client context including client instance, tools, resources, and connection state\n * @throws Error if used outside of McpClientProvider\n *\n * @public\n *\n * @example\n * ```tsx\n * function ToolsList() {\n *   const { tools, isConnected, error, reconnect } = useMcpClient();\n *\n *   if (error) {\n *     return (\n *       <div>\n *         Error: {error.message}\n *         <button onClick={reconnect}>Retry</button>\n *       </div>\n *     );\n *   }\n *\n *   if (!isConnected) {\n *     return <div>Not connected</div>;\n *   }\n *\n *   return (\n *     <ul>\n *       {tools.map(tool => (\n *         <li key={tool.name}>{tool.description}</li>\n *       ))}\n *     </ul>\n *   );\n * }\n * ```\n */\nexport function useMcpClient() {\n  const context = useContext(McpClientContext);\n  if (!context) {\n    throw new Error('useMcpClient must be used within an McpClientProvider');\n  }\n  return context;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["useWebMCP"],"sources":["../src/useCommittedRef.ts","../src/client/McpClientProvider.tsx","../src/useWebMCPContext.ts","../src/model-context.ts","../src/useMcpRegistration.ts","../src/useWebMCPPrompt.ts","../src/useWebMCPResource.ts"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef } from 'react';\n\nconst useIsomorphicLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;\n\nexport function useCommittedRef<T>(value: T) {\n  const ref = useRef(value);\n\n  // External MCP work may read values after commit but before passive effects. SSR cannot.\n  useIsomorphicLayoutEffect(() => {\n    ref.current = value;\n  }, [value]);\n\n  return ref;\n}\n","import {\n  type Client,\n  type ConnectOptions,\n  type Resource,\n  type ServerCapabilities,\n  type SubscriptionFilter,\n  type Tool as McpTool,\n  type Transport,\n} from '@modelcontextprotocol/client';\nimport {\n  createContext,\n  type ReactElement,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { useCommittedRef } from '../useCommittedRef.js';\n\n/**\n * Context value provided by McpClientProvider.\n *\n * @internal\n */\ninterface McpClientContextValue {\n  client: Client;\n  tools: McpTool[];\n  resources: Resource[];\n  isConnected: boolean;\n  isLoading: boolean;\n  error: Error | null;\n  capabilities: ServerCapabilities | null;\n  reconnect: (freshTransport?: Transport) => Promise<void>;\n}\n\ntype ConnectionState = 'disconnected' | 'connecting' | 'initializing' | 'connected';\n\nconst McpClientContext = createContext<McpClientContextValue | null>(null);\n\nfunction startListChangedSubscription(\n  client: Client,\n  filter: SubscriptionFilter,\n  refreshLists: () => Promise<void>\n): () => void {\n  const controller = new AbortController();\n\n  void client\n    .listen(filter, { signal: controller.signal })\n    .then(async (subscription) => {\n      if (controller.signal.aborted) {\n        await subscription.close();\n        return;\n      }\n\n      // Modern servers deliver list_changed only after listen is acknowledged.\n      await refreshLists();\n    })\n    .catch((error) => {\n      if (!controller.signal.aborted) {\n        console.error(\n          '[ReactWebMCP:McpClientProvider]',\n          'Failed to listen for list_changed notifications:',\n          error\n        );\n      }\n    });\n\n  return () => controller.abort();\n}\n\n/**\n * Props for the McpClientProvider component.\n *\n * @public\n */\nexport interface McpClientProviderProps {\n  /**\n   * React children to render within the provider.\n   */\n  children: ReactNode;\n\n  /**\n   * MCP Client instance to use for communication.\n   */\n  client: Client;\n\n  /**\n   * Transport instance for the client to connect through.\n   */\n  transport: Transport;\n\n  /**\n   * Optional connection options.\n   */\n  opts?: ConnectOptions;\n}\n\n/**\n * Provider component that manages an MCP client connection and exposes\n * tools, resources, and connection state to child components.\n *\n * This provider handles:\n * - Establishing and maintaining the MCP client connection\n * - Fetching available tools and resources from the server\n * - Listening for server notifications about tool/resource changes\n * - Managing connection state and errors\n * - Automatic cleanup on unmount\n *\n * @param props - Component props\n * @returns Provider component wrapping children\n *\n * @public\n *\n * @example\n * Connect to an MCP server via tab transport:\n * ```tsx\n * import { TabClientTransport } from '@mcp-b/transports';\n * import { McpClientProvider } from '@mcp-b/react-webmcp';\n * import { Client } from '@modelcontextprotocol/client';\n *\n * const client = new Client(\n *   { name: 'my-app', version: '1.0.0' },\n *   { versionNegotiation: { mode: 'auto' } }\n * );\n *\n * const transport = new TabClientTransport({\n *   channelId: 'mcp',\n *   targetOrigin: window.location.origin,\n * });\n *\n * function App() {\n *   return (\n *     <McpClientProvider client={client} transport={transport}>\n *       <MyAppContent />\n *     </McpClientProvider>\n *   );\n * }\n * ```\n *\n * @example\n * Access tools from child components:\n * ```tsx\n * function MyAppContent() {\n *   const { tools, isConnected, isLoading } = useMcpClient();\n *\n *   if (isLoading) {\n *     return <div>Connecting to MCP server...</div>;\n *   }\n *\n *   if (!isConnected) {\n *     return <div>Failed to connect to MCP server</div>;\n *   }\n *\n *   return (\n *     <div>\n *       <h2>Available Tools:</h2>\n *       <ul>\n *         {tools.map(tool => (\n *           <li key={tool.name}>{tool.description}</li>\n *         ))}\n *       </ul>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function McpClientProvider({\n  children,\n  client,\n  transport,\n  opts,\n}: McpClientProviderProps): ReactElement {\n  const [resources, setResources] = useState<Resource[]>([]);\n  const [tools, setTools] = useState<McpTool[]>([]);\n  const [error, setError] = useState<Error | null>(null);\n  const [connectionState, setConnectionState] = useState<ConnectionState>('disconnected');\n  const [capabilities, setCapabilities] = useState<ServerCapabilities | null>(null);\n  const isConnected = connectionState === 'initializing' || connectionState === 'connected';\n  const isLoading = connectionState === 'connecting' || connectionState === 'initializing';\n  const connectionStateRef = useRef<ConnectionState>('disconnected');\n  const connectionGenerationRef = useRef(0);\n  const closePromiseRef = useRef<Promise<void> | null>(null);\n  const providerCloseRef = useRef<object | null>(null);\n  const inventoryRequestRef = useRef(0);\n  const requestOptsRef = useCommittedRef(opts);\n\n  /**\n   * Refreshes every provider-owned inventory list and clears a prior inventory\n   * error only after the complete refresh succeeds.\n   */\n  const refreshInventory = useCallback(\n    async (connectionGeneration: number): Promise<void> => {\n      const inventoryRequest = ++inventoryRequestRef.current;\n      const serverCapabilities = client.getServerCapabilities();\n\n      try {\n        const [resourceResponse, toolResponse] = await Promise.all([\n          serverCapabilities?.resources\n            ? client.listResources(undefined, { cacheMode: 'refresh' })\n            : undefined,\n          serverCapabilities?.tools\n            ? client.listTools(undefined, { cacheMode: 'refresh' })\n            : undefined,\n        ]);\n\n        if (\n          connectionGeneration !== connectionGenerationRef.current ||\n          inventoryRequest !== inventoryRequestRef.current\n        ) {\n          return;\n        }\n\n        setResources(resourceResponse?.resources ?? []);\n        setTools(toolResponse?.tools ?? []);\n        setError(null);\n      } catch (cause) {\n        const error = cause instanceof Error ? cause : new Error(String(cause));\n        if (\n          connectionGeneration !== connectionGenerationRef.current ||\n          inventoryRequest !== inventoryRequestRef.current\n        ) {\n          return;\n        }\n        setError(error);\n        throw error;\n      }\n    },\n    [client]\n  );\n\n  /**\n   * Connects a disconnected client, or retries inventory discovery when the\n   * MCP handshake is already alive. Calls made while work is in progress no-op.\n   *\n   * Pass a fresh transport after a one-shot transport has closed.\n   */\n  const reconnect = useCallback(\n    async (freshTransport?: Transport): Promise<void> => {\n      if (connectionStateRef.current === 'connected' && freshTransport === undefined) {\n        const connectionGeneration = connectionGenerationRef.current;\n        connectionStateRef.current = 'initializing';\n        setConnectionState('initializing');\n\n        try {\n          await refreshInventory(connectionGeneration);\n        } catch {\n          // Inventory failure does not undo the completed MCP handshake.\n        }\n\n        if (connectionGeneration === connectionGenerationRef.current) {\n          connectionStateRef.current = 'connected';\n          setConnectionState('connected');\n        }\n        return;\n      }\n\n      if (connectionStateRef.current !== 'disconnected') {\n        return;\n      }\n\n      connectionStateRef.current = 'connecting';\n      setConnectionState('connecting');\n      setError(null);\n      const connectionGeneration = connectionGenerationRef.current;\n\n      try {\n        await closePromiseRef.current;\n        if (connectionGeneration !== connectionGenerationRef.current) {\n          return;\n        }\n        await client.connect(freshTransport ?? transport, requestOptsRef.current);\n        if (connectionGeneration !== connectionGenerationRef.current) {\n          return;\n        }\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        if (connectionGeneration === connectionGenerationRef.current) {\n          connectionStateRef.current = 'disconnected';\n          setConnectionState('disconnected');\n          setError(err);\n        }\n        throw err;\n      }\n\n      const caps = client.getServerCapabilities();\n      setCapabilities(caps ?? null);\n      connectionStateRef.current = 'initializing';\n      setConnectionState('initializing');\n\n      try {\n        await refreshInventory(connectionGeneration);\n      } catch {\n        // Inventory failure does not undo the completed MCP handshake.\n      }\n\n      if (connectionGeneration === connectionGenerationRef.current) {\n        connectionStateRef.current = 'connected';\n        setConnectionState('connected');\n      }\n    },\n    [client, transport, refreshInventory, requestOptsRef]\n  );\n\n  useEffect(() => {\n    if (!isConnected) {\n      return;\n    }\n\n    const serverCapabilities = client.getServerCapabilities();\n\n    const resourcesListChanged = serverCapabilities?.resources?.listChanged === true;\n    const toolsListChanged = serverCapabilities?.tools?.listChanged === true;\n    const refreshLists = async () => {\n      try {\n        await refreshInventory(connectionGenerationRef.current);\n      } catch (error) {\n        console.error(\n          '[ReactWebMCP:McpClientProvider]',\n          'Failed to refresh tools/resources after list_changed:',\n          error\n        );\n      }\n    };\n\n    if (resourcesListChanged) {\n      client.setNotificationHandler('notifications/resources/list_changed', refreshLists);\n    }\n\n    if (toolsListChanged) {\n      client.setNotificationHandler('notifications/tools/list_changed', refreshLists);\n    }\n\n    const hasListChanged = resourcesListChanged || toolsListChanged;\n    const stopListening =\n      client.getProtocolEra() === 'modern' && hasListChanged\n        ? startListChangedSubscription(\n            client,\n            {\n              ...(toolsListChanged && { toolsListChanged: true }),\n              ...(resourcesListChanged && { resourcesListChanged: true }),\n            },\n            refreshLists\n          )\n        : undefined;\n    if (!stopListening && hasListChanged) {\n      // Legacy servers deliver list_changed unsolicited once handlers are installed.\n      void refreshLists();\n    }\n\n    return () => {\n      if (resourcesListChanged) {\n        client.removeNotificationHandler('notifications/resources/list_changed');\n      }\n\n      if (toolsListChanged) {\n        client.removeNotificationHandler('notifications/tools/list_changed');\n      }\n\n      stopListening?.();\n    };\n  }, [client, isConnected, refreshInventory]);\n\n  useEffect(() => {\n    let active = true;\n    const connectionGeneration = connectionGenerationRef.current;\n    const previousOnclose = client.onclose;\n    const handleClientClose = () => {\n      try {\n        previousOnclose?.();\n      } finally {\n        if (active && providerCloseRef.current === null) {\n          connectionGenerationRef.current += 1;\n          inventoryRequestRef.current += 1;\n          connectionStateRef.current = 'disconnected';\n          setConnectionState('disconnected');\n          setCapabilities(null);\n          setResources([]);\n          setTools([]);\n        }\n      }\n    };\n    client.onclose = handleClientClose;\n    connectionStateRef.current = 'disconnected';\n    setConnectionState('disconnected');\n\n    // Initial connection - reconnect() has its own guard to prevent concurrent connections\n    reconnect().catch((err) => {\n      if (connectionGeneration === connectionGenerationRef.current) {\n        console.error('[ReactWebMCP:McpClientProvider]', 'Failed to connect MCP client:', err);\n      }\n    });\n\n    return () => {\n      active = false;\n      if (client.onclose === handleClientClose) {\n        if (previousOnclose) {\n          client.onclose = previousOnclose;\n        } else {\n          Reflect.deleteProperty(client, 'onclose');\n        }\n      }\n      connectionGenerationRef.current += 1;\n      inventoryRequestRef.current += 1;\n      connectionStateRef.current = 'disconnected';\n      const closeToken = {};\n      providerCloseRef.current = closeToken;\n      closePromiseRef.current = client\n        .close()\n        .catch((error: unknown) => {\n          console.error('[ReactWebMCP:McpClientProvider]', 'Failed to close MCP client:', error);\n        })\n        .finally(() => {\n          if (providerCloseRef.current === closeToken) {\n            providerCloseRef.current = null;\n          }\n        });\n    };\n  }, [client, transport, reconnect]);\n\n  const contextValue = useMemo(\n    () => ({\n      client,\n      tools,\n      resources,\n      isConnected,\n      isLoading,\n      error,\n      capabilities,\n      reconnect,\n    }),\n    [client, tools, resources, isConnected, isLoading, error, capabilities, reconnect]\n  );\n\n  return <McpClientContext.Provider value={contextValue}>{children}</McpClientContext.Provider>;\n}\n\n/**\n * Hook to access the MCP client context.\n * Must be used within an {@link McpClientProvider}.\n *\n * @returns The MCP client context including client instance, tools, resources, and connection state\n * @throws Error if used outside of McpClientProvider\n *\n * @public\n *\n * @example\n * ```tsx\n * function ToolsList() {\n *   const { tools, isConnected, error, reconnect } = useMcpClient();\n *\n *   if (error) {\n *     return (\n *       <div>\n *         Error: {error.message}\n *         <button onClick={() => void reconnect()}>Retry</button>\n *       </div>\n *     );\n *   }\n *\n *   if (!isConnected) {\n *     return <div>Not connected</div>;\n *   }\n *\n *   return (\n *     <ul>\n *       {tools.map(tool => (\n *         <li key={tool.name}>{tool.description}</li>\n *       ))}\n *     </ul>\n *   );\n * }\n * ```\n */\nexport function useMcpClient() {\n  const context = useContext(McpClientContext);\n  if (!context) {\n    throw new Error('useMcpClient must be used within an McpClientProvider');\n  }\n  return context;\n}\n","import { useWebMCP, type WebMCPReturn } from 'usewebmcp';\n\n/**\n * Convenience hook for exposing read-only context data to AI assistants.\n *\n * This is a simplified wrapper around {@link useWebMCP} specifically designed for\n * context tools that expose data without performing actions. The hook automatically\n * configures appropriate annotations (read-only, idempotent) and handles value\n * serialization.\n *\n * JSON-compatible values are normalized to text plus `structuredContent`.\n *\n * @template T - The type of context data to expose\n *\n * @param name - Unique identifier for the context tool (e.g., 'context_current_post')\n * @param description - Human-readable description of the context for AI assistants\n * @param getValue - Function that returns the current context value\n * @returns Tool execution state and control methods\n *\n * @public\n *\n * @example\n * Expose current post context:\n * ```tsx\n * function PostDetailPage() {\n *   const { postId } = useParams();\n *   const { data: post } = useQuery(['post', postId], () => fetchPost(postId));\n *\n *   useWebMCPContext(\n *     'context_current_post',\n *     'Get the currently viewed post ID and metadata',\n *     () => ({\n *       postId,\n *       title: post?.title,\n *       author: post?.author,\n *       tags: post?.tags,\n *       createdAt: post?.createdAt,\n *     })\n *   );\n *\n *   return <PostContent post={post} />;\n * }\n * ```\n *\n * @example\n * Expose user session context:\n * ```tsx\n * function AppRoot() {\n *   const { user, isAuthenticated } = useAuth();\n *\n *   useWebMCPContext(\n *     'context_user_session',\n *     'Get the current user session information',\n *     () => ({\n *       isAuthenticated,\n *       userId: user?.id,\n *       email: user?.email,\n *       permissions: user?.permissions,\n *     })\n *   );\n *\n *   return <App />;\n * }\n * ```\n */\nexport function useWebMCPContext<T>(\n  name: string,\n  description: string,\n  getValue: () => T\n): WebMCPReturn {\n  return useWebMCP({\n    name,\n    description,\n    annotations: {\n      title: `Context: ${name}`,\n      readOnlyHint: true,\n      idempotentHint: true,\n      destructiveHint: false,\n      openWorldHint: false,\n    },\n    execute: getValue,\n  });\n}\n","import { isBrowserMcpServer, type BrowserMcpServer } from '@mcp-b/webmcp-ts-sdk';\n\nexport function getBrowserMcpServer(): BrowserMcpServer | undefined {\n  if (typeof document === 'undefined' || typeof navigator === 'undefined') {\n    return undefined;\n  }\n\n  const modelContext = document.modelContext ?? navigator.modelContext;\n  return modelContext && isBrowserMcpServer(modelContext) ? modelContext : undefined;\n}\n","import type { RegistrationHandle } from '@mcp-b/webmcp-types';\nimport { useEffect, useState } from 'react';\n\nexport function useMcpRegistration(register: () => RegistrationHandle | undefined): boolean {\n  const [isRegistered, setIsRegistered] = useState(false);\n\n  useEffect(() => {\n    const registration = register();\n    if (!registration) {\n      setIsRegistered(false);\n      return;\n    }\n\n    setIsRegistered(true);\n    return () => {\n      registration.unregister();\n    };\n  }, [register]);\n\n  return isRegistered;\n}\n","import { normalizeInputSchema } from '@mcp-b/webmcp-polyfill/schema';\nimport { useCallback } from 'react';\nimport type { WebMCPPromptConfig, WebMCPPromptReturn } from './types.js';\nimport { getBrowserMcpServer } from './model-context.js';\nimport { useCommittedRef } from './useCommittedRef.js';\nimport { useMcpRegistration } from './useMcpRegistration.js';\n\n/**\n * React hook for registering Model Context Protocol (MCP) prompts.\n *\n * This hook handles the complete lifecycle of an MCP prompt:\n * - Registers the prompt with the installed MCP-B `BrowserMcpServer`\n * - Automatically unregisters on component unmount\n *\n * @param config - Configuration object for the prompt\n * @returns Object indicating registration status\n *\n * @public\n *\n * @example\n * Simple prompt without arguments:\n * ```tsx\n * function HelpPrompt() {\n *   const { isRegistered } = useWebMCPPrompt({\n *     name: 'help',\n *     description: 'Get help with using the application',\n *     get: async () => ({\n *       messages: [{\n *         role: 'user',\n *         content: { type: 'text', text: 'How do I use this application?' }\n *       }]\n *     }),\n *   });\n *\n *   return <div>Help prompt {isRegistered ? 'ready' : 'loading'}</div>;\n * }\n * ```\n *\n * @example\n * Prompt with typed arguments:\n * ```tsx\n * function CodeReviewPrompt() {\n *   const { isRegistered } = useWebMCPPrompt({\n *     name: 'review_code',\n *     description: 'Review code for best practices',\n *     argsSchema: {\n *       type: 'object',\n *       properties: {\n *         code: { type: 'string', description: 'The code to review' },\n *         language: { type: 'string', description: 'Programming language' },\n *       },\n *       required: ['code'],\n *     } as const,\n *     get: async ({ code, language }) => ({\n *       messages: [{\n *         role: 'user',\n *         content: {\n *           type: 'text',\n *           text: `Please review this ${language ?? ''} code:\\n\\n${code}`\n *         }\n *       }]\n *     }),\n *   });\n *\n *   return <div>Code review prompt {isRegistered ? 'ready' : 'loading'}</div>;\n * }\n * ```\n */\nexport function useWebMCPPrompt(config: WebMCPPromptConfig): WebMCPPromptReturn {\n  const { name, description } = config;\n\n  const configRef = useCommittedRef(config);\n\n  const register = useCallback(() => {\n    const modelContext = getBrowserMcpServer();\n    if (!modelContext) {\n      console.warn(\n        `[ReactWebMCP] BrowserMcpServer is not available. Prompt \"${name}\" will not be registered.`\n      );\n      return;\n    }\n\n    // ponytail: read at registration time so an inline `argsSchema` literal cannot re-register\n    // every render. Ceiling: a changed schema is picked up only when `name` or `description`\n    // changes; add a caller-supplied deps list, as `useWebMCP` has, if that is ever needed.\n    const { argsSchema } = configRef.current;\n    const resolvedArgsSchema = argsSchema\n      ? normalizeInputSchema(argsSchema).inputSchema\n      : undefined;\n\n    return modelContext.registerPrompt({\n      name,\n      ...(description !== undefined && { description }),\n      ...(resolvedArgsSchema && { argsSchema: resolvedArgsSchema }),\n      get: async (args) => configRef.current.get(args),\n    });\n  }, [name, description, configRef]);\n\n  return { isRegistered: useMcpRegistration(register) };\n}\n","import { useCallback } from 'react';\nimport { getBrowserMcpServer } from './model-context.js';\nimport type { WebMCPResourceConfig, WebMCPResourceReturn } from './types.js';\nimport { useCommittedRef } from './useCommittedRef.js';\nimport { useMcpRegistration } from './useMcpRegistration.js';\n\n/**\n * React hook for registering Model Context Protocol (MCP) resources.\n *\n * This hook handles the complete lifecycle of an MCP resource:\n * - Registers the resource with the installed MCP-B `BrowserMcpServer`\n * - Supports both static URIs and URI templates with parameters\n * - Automatically unregisters on component unmount\n *\n * @param config - Configuration object for the resource\n * @returns Object indicating registration status\n *\n * @public\n *\n * @example\n * Static resource:\n * ```tsx\n * function AppSettingsResource() {\n *   const { isRegistered } = useWebMCPResource({\n *     uri: 'config://app-settings',\n *     name: 'App Settings',\n *     description: 'Application configuration',\n *     mimeType: 'application/json',\n *     read: async (uri) => ({\n *       contents: [{\n *         uri: uri.href,\n *         text: JSON.stringify({ theme: 'dark', language: 'en' })\n *       }]\n *     }),\n *   });\n *\n *   return <div>Settings resource {isRegistered ? 'ready' : 'loading'}</div>;\n * }\n * ```\n *\n * @example\n * Dynamic resource with URI template:\n * ```tsx\n * function UserProfileResource() {\n *   const { isRegistered } = useWebMCPResource({\n *     uri: 'user://{userId}/profile',\n *     name: 'User Profile',\n *     description: 'User profile data by ID',\n *     mimeType: 'application/json',\n *     read: async (uri, params) => {\n *       const userId = typeof params?.userId === 'string' ? params.userId : '';\n *       const profile = await fetchUserProfile(userId);\n *       return {\n *         contents: [{\n *           uri: uri.href,\n *           text: JSON.stringify(profile)\n *         }]\n *       };\n *     },\n *   });\n *\n *   return <div>User profile resource {isRegistered ? 'ready' : 'loading'}</div>;\n * }\n * ```\n */\nexport function useWebMCPResource(config: WebMCPResourceConfig): WebMCPResourceReturn {\n  const { uri, name, description, mimeType, read } = config;\n\n  const readRef = useCommittedRef(read);\n\n  const register = useCallback(() => {\n    const modelContext = getBrowserMcpServer();\n    if (!modelContext) {\n      console.warn(\n        `[ReactWebMCP] BrowserMcpServer is not available. Resource \"${uri}\" will not be registered.`\n      );\n      return;\n    }\n\n    return modelContext.registerResource({\n      uri,\n      name,\n      ...(description !== undefined && { description }),\n      ...(mimeType !== undefined && { mimeType }),\n      read: (resolvedUri, params) => readRef.current(resolvedUri, params),\n    });\n  }, [uri, name, description, mimeType, readRef]);\n\n  return { isRegistered: useMcpRegistration(register) };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mcp-b/react-webmcp",
-  "version": "4.1.0-beta.20260702224704",
-  "description": "React hooks for Model Context Protocol (MCP) - expose React components as AI tools for Claude, ChatGPT, Cursor, and Copilot with Zod validation",
+  "version": "5.0.1",
+  "description": "React hooks for Model Context Protocol (MCP) - expose React components as AI tools for Claude, ChatGPT, Cursor, and Copilot",
   "keywords": [
     "ai",
     "ai-agents",
@@ -46,7 +46,9 @@
     "dist"
   ],
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -58,14 +60,14 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.29.0",
-    "@mcp-b/global": "4.1.0-beta.20260702224704",
-    "@mcp-b/transports": "4.1.0-beta.20260702224704",
-    "@mcp-b/webmcp-types": "4.1.0-beta.20260702224704",
-    "@mcp-b/webmcp-polyfill": "4.1.0-beta.20260702224704",
-    "@mcp-b/webmcp-ts-sdk": "4.1.0-beta.20260702224704"
+    "@modelcontextprotocol/client": "2.0.0",
+    "@mcp-b/webmcp-ts-sdk": "5.0.1",
+    "@mcp-b/webmcp-polyfill": "5.0.1",
+    "@mcp-b/webmcp-types": "5.0.1",
+    "usewebmcp": "5.0.1"
   },
   "devDependencies": {
+    "@modelcontextprotocol/server": "2.0.0",
     "@types/node": "22.17.2",
     "@types/react": "^19.2.9",
     "@vitest/coverage-v8": "^4.1.7",
@@ -75,16 +77,14 @@
     "typescript": "^5.8.3",
     "vite-plus": "^0.1.22",
     "vitest": "npm:@voidzero-dev/vite-plus-test@latest",
-    "vitest-browser-react": "^2.0.4"
+    "vitest-browser-react": "^2.0.4",
+    "@mcp-b/global": "5.0.1"
   },
   "peerDependencies": {
-    "react": "^17.0.0 || ^18.0.0 || ^19.0.0",
-    "zod": "^3.25 || ^4.0"
+    "react": "^18.0.0 || ^19.0.0"
   },
-  "peerDependenciesMeta": {
-    "zod": {
-      "optional": true
-    }
+  "engines": {
+    "node": ">=20"
   },
   "scripts": {
     "build": "vp pack",
@@ -97,9 +97,6 @@
     "publish:npm": "pnpm publish --access public",
     "test": "vp test run",
     "test:watch": "vp test",
-    "typecheck": "tsc --noEmit && tsc -p tsconfig.strict-null-checks-false.json --noEmit && vp test run --typecheck --silent",
-    "version:major": "pnpm version major --no-git-tag-version",
-    "version:minor": "pnpm version minor --no-git-tag-version",
-    "version:patch": "pnpm version patch --no-git-tag-version"
+    "typecheck": "tsc --noEmit && vp test run --typecheck --silent"
   }
 }

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/zod-utils.ts","../src/types.ts","../src/useWebMCP.ts","../src/useWebMCPContext.ts","../src/useWebMCPPrompt.ts","../src/useWebMCPResource.ts","../src/useElicitationHandler.ts","../src/useSamplingHandler.ts","../src/client/McpClientProvider.tsx"],"mappings":"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"}