@mcp-fe/react-tools 0.1.8 → 0.1.9

package/README.md

@@ -4,6 +4,8 @@
 
 Simplify dynamic MCP tool integration in React applications with automatic lifecycle management, reference counting, and full access to React features.
 
+> 🔗 **Requires**: [@mcp-fe/mcp-worker](https://www.npmjs.com/package/@mcp-fe/mcp-worker) - The browser-based MCP server that powers these React hooks.
+
 ## ✨ Key Features
 
 - 🔄 **Automatic Lifecycle** - Register on mount, unregister on unmount
@@ -13,22 +15,49 @@ Simplify dynamic MCP tool integration in React applications with automatic lifec
 - 🔌 **Optional Context** - Works standalone or with Provider
 - 📘 **TypeScript First** - Complete type safety out of the box
 
-## 📦 Installation
+## ⚠️ Prerequisites
+
+This library requires **[@mcp-fe/mcp-worker](https://www.npmjs.com/package/@mcp-fe/mcp-worker)** to function. The worker library runs an MCP server in your browser that enables AI agents to interact with your application.
+
+**You must install and initialize the worker library first:**
 
 ```bash
-npm install @mcp-fe/react-tools
+npm install @mcp-fe/mcp-worker @mcp-fe/react-tools
 ```
 
 ```bash
-pnpm add @mcp-fe/react-tools
+pnpm add @mcp-fe/mcp-worker @mcp-fe/react-tools
 ```
 
 ```bash
-yarn add @mcp-fe/react-tools
+yarn add @mcp-fe/mcp-worker @mcp-fe/react-tools
 ```
 
+> 💡 **New to MCP Worker?** Check out the [@mcp-fe/mcp-worker documentation](https://www.npmjs.com/package/@mcp-fe/mcp-worker) to set up the browser-based MCP server first.
+
+
 ## 🚀 Quick Example
 
+**Step 1:** Wrap your app with `MCPToolsProvider`:
+
+```tsx
+import { MCPToolsProvider } from '@mcp-fe/react-tools';
+
+function App() {
+  return (
+    <MCPToolsProvider 
+      backendWsUrl="ws://localhost:3001"
+      authToken="your-auth-token" 
+      onInitialized={() => console.log('MCP ready!')}
+    >
+      <MyApp />
+    </MCPToolsProvider>
+  );
+}
+```
+
+**Step 2:** Register tools with React hooks in your components:
+
 ```tsx
 import { useMCPTool } from '@mcp-fe/react-tools';
 
@@ -58,6 +87,10 @@ function MyComponent() {
 }
 ```
 
+> 💡 **Alternative:** You can also initialize the worker client manually outside React. See the [Getting Started Guide](./docs/getting-started.md) for details.
+
+> 📖 **Need more details?** See the [Complete Setup Guide](./docs/getting-started.md) for step-by-step instructions.
+
 ## 📚 Documentation
 
 **[📖 View Complete Documentation →](./docs/index.md)**

package/context/MCPToolsContext.d.ts

@@ -32,6 +32,10 @@ export interface MCPToolsProviderProps {
      * Backend WebSocket URL
      */
     backendWsUrl?: string;
+    /**
+     * Authentication token for MCP server
+     */
+    authToken?: string | null;
     /**
      * Other worker client init options
      */
@@ -59,14 +63,15 @@ export interface MCPToolsProviderProps {
  * }
  * ```
  *
- * @example With callbacks:
+ * @example With authentication token:
  * ```tsx
  * function App() {
+ *   const token = getAuthToken(); // get token from your auth provider
+ *
  *   return (
  *     <MCPToolsProvider
  *       backendWsUrl="ws://localhost:3001"
- *       onInitialized={() => console.log('MCP Tools ready!')}
- *       onInitError={(err) => console.error('MCP init failed:', err)}
+ *       authToken={token}
  *     >
  *       <YourApp />
  *     </MCPToolsProvider>
@@ -74,6 +79,7 @@ export interface MCPToolsProviderProps {
  * }
  * ```
  *
+ *
  * @example Manual initialization:
  * ```tsx
  * function App() {
@@ -95,7 +101,7 @@ export interface MCPToolsProviderProps {
  * }
  * ```
  */
-export declare function MCPToolsProvider({ children, autoInit, backendWsUrl, initOptions, onInitialized, onInitError, }: MCPToolsProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function MCPToolsProvider({ children, autoInit, backendWsUrl, authToken, initOptions, onInitialized, onInitError, }: MCPToolsProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Hook to access MCP Tools context
  *

package/context/MCPToolsContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MCPToolsContext.d.ts","sourceRoot":"","sources":["../../../../libs/react-tools/src/context/MCPToolsContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAMN,MAAM,OAAO,CAAC;AACf,OAAO,EAAgB,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,UAAU,oBAAoB;IAC5B;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;OAEG;IACH,mBAAmB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7C;AAID,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,uBAAuB,CAAC;IAEtC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,QAAe,EACf,YAAoC,EACpC,WAAW,EACX,aAAa,EACb,WAAW,GACZ,EAAE,qBAAqB,2CAkFvB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,UAAQ,GAAG,oBAAoB,CAsBvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAG3C"}
+{"version":3,"file":"MCPToolsContext.d.ts","sourceRoot":"","sources":["../../../../libs/react-tools/src/context/MCPToolsContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAMN,MAAM,OAAO,CAAC;AACf,OAAO,EAAgB,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,UAAU,oBAAoB;IAC5B;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;OAEG;IACH,mBAAmB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7C;AAID,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,WAAW,CAAC,EAAE,uBAAuB,CAAC;IAEtC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,QAAe,EACf,YAAoC,EACpC,SAAS,EACT,WAAW,EACX,aAAa,EACb,WAAW,GACZ,EAAE,qBAAqB,2CAsGvB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,UAAQ,GAAG,oBAAoB,CAsBvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAG3C"}

package/hooks/useMCPTool.d.ts

@@ -135,19 +135,4 @@ export interface UseMCPToolResult {
  * ```
  */
 export declare function useMCPTool(options: UseMCPToolOptions): UseMCPToolResult;
-/**
- * Utility function to check if a tool is registered
- */
-export declare function isToolRegistered(name: string): boolean;
-/**
- * Utility function to get all registered tools
- */
-export declare function getRegisteredTools(): string[];
-/**
- * Utility function to get tool info
- */
-export declare function getToolInfo(name: string): {
-    refCount: number;
-    isRegistered: boolean;
-} | null;
 //# sourceMappingURL=useMCPTool.d.ts.map

package/hooks/useMCPTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMCPTool.d.ts","sourceRoot":"","sources":["../../../../libs/react-tools/src/hooks/useMCPTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,IAAI,EACT,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAE1B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;OAEG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAuKvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,GACX;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAEpD"}
+{"version":3,"file":"useMCPTool.d.ts","sourceRoot":"","sources":["../../../../libs/react-tools/src/hooks/useMCPTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,IAAI,EACT,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAE1B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;OAEG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAuKvE"}

package/index.d.ts

@@ -13,8 +13,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export { useMCPTool, isToolRegistered, getRegisteredTools, getToolInfo, } from './hooks/useMCPTool';
+export { useMCPTool } from './hooks/useMCPTool';
 export type { UseMCPToolOptions, UseMCPToolResult } from './hooks/useMCPTool';
+export { isToolRegistered, getRegisteredTools, getToolInfo, getToolDetails, } from './utils';
 export { useMCPGetter, useMCPAction } from './hooks/useMCPToolHelpers';
 export { MCPToolsProvider, useMCPToolsContext, useHasMCPProvider, } from './context/MCPToolsContext';
 export type { MCPToolsProviderProps } from './context/MCPToolsContext';

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../libs/react-tools/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../libs/react-tools/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}

package/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),f=require("@mcp-fe/mcp-worker"),D=require("react/jsx-runtime");function m(r){const{name:t,description:s,inputSchema:c,outputSchema:n,handler:l,annotations:u,execution:C,_meta:g,icons:d,title:P,autoRegister:T=!0,autoUnregister:S=!0}=r,[h,a]=e.useState(null),i=e.useRef(l),R=e.useRef(t),w=e.useRef(s),k=e.useRef(c),p=e.useRef(n),v=e.useRef(u),b=e.useRef(C),I=e.useRef(g),E=e.useRef(d),z=e.useRef(P),N=e.useRef(!0),y=e.useRef(!1);e.useEffect(()=>{i.current=l,R.current=t,w.current=s,k.current=c,p.current=n,v.current=u,b.current=C,I.current=g,E.current=d,z.current=P},[l,t,s,c,n,u,C,g,d,P]);const A=e.useCallback(async o=>i.current(o),[]),q=e.useCallback(async()=>{const o=R.current,M=w.current,H=k.current,O=p.current,U=v.current,F=b.current,G=I.current,J=E.current,_=z.current;try{await f.workerClient.registerTool(o,M,H,A,{outputSchema:O,annotations:U,execution:F,_meta:G,icons:J,title:_}),y.current=!0,console.log(`[useMCPTool] Registered tool '${o}'`)}catch(j){throw console.error(`[useMCPTool] Failed to register tool '${o}':`,j),j}},[A]),$=e.useCallback(async()=>{const o=R.current;try{await f.workerClient.unregisterTool(o),y.current=!1,console.log(`[useMCPTool] Unregistered tool '${o}'`)}catch(M){console.error(`[useMCPTool] Failed to unregister tool '${o}':`,M)}},[]);return e.useEffect(()=>f.workerClient.onToolChange(t,M=>{a(M)}),[t]),e.useEffect(()=>(T&&q().catch(o=>{console.error(`[useMCPTool] Auto-register failed for '${t}':`,o)}),()=>{N.current=!1,S&&y.current&&$().catch(o=>{console.error(`[useMCPTool] Auto-unregister failed for '${t}':`,o)})}),[t]),{isRegistered:h?.isRegistered??!1,refCount:h?.refCount??0,register:q,unregister:$}}function W(r){return f.workerClient.isToolRegistered(r)}function B(){return f.workerClient.getRegisteredTools()}function K(r){return f.workerClient.getToolInfo(r)}function L(r,t,s,c){const n=e.useCallback(async()=>{const l=await s();return{content:[{type:"text",text:JSON.stringify(l,null,2)}]}},[s]);return m({name:r,description:t,inputSchema:{type:"object",properties:{}},handler:n,...c})}function Q(r,t,s,c,n){const l=e.useCallback(async u=>{const C=await c(u);return{content:[{type:"text",text:JSON.stringify(C,null,2)}]}},[c]);return m({name:r,description:t,inputSchema:{type:"object",properties:s,...n?.required&&{required:n.required}},handler:l,autoRegister:n?.autoRegister,autoUnregister:n?.autoUnregister})}const x=e.createContext(null);function V({children:r,autoInit:t=!0,backendWsUrl:s="ws://localhost:3001",initOptions:c,onInitialized:n,onInitError:l}){const[u,C]=e.useState(!1),[g,d]=e.useState(!1),[P]=e.useState([]),T=e.useCallback(async a=>{if(u){console.log("[MCPToolsProvider] Already initialized");return}try{const i=a||c||{backendWsUrl:s};console.log("[MCPToolsProvider] Initializing worker client...",i),await f.workerClient.init(i),C(!0);const R=await f.workerClient.getConnectionStatus();d(R),f.workerClient.onConnectionStatus(w=>{d(w)}),console.log("[MCPToolsProvider] Worker client initialized"),n?.()}catch(i){throw console.error("[MCPToolsProvider] Initialization failed:",i),l?.(i instanceof Error?i:new Error(String(i))),i}},[u,c,s,n,l]),S=e.useCallback(async()=>{const a=await f.workerClient.getConnectionStatus();return d(a),a},[]);e.useEffect(()=>{t&&T().catch(a=>{console.error("[MCPToolsProvider] Auto-init failed:",a)})},[t,T]),e.useEffect(()=>{if(!u)return;const a=setInterval(()=>{},5e3);return()=>clearInterval(a)},[u]);const h={isInitialized:u,isConnected:g,registeredTools:P,initialize:T,getConnectionStatus:S};return D.jsx(x.Provider,{value:h,children:r})}function X(r=!1){const t=e.useContext(x);if(!t&&r)throw new Error("useMCPToolsContext must be used within MCPToolsProvider. Either wrap your component tree with <MCPToolsProvider> or set strict=false.");return t||{isInitialized:!1,isConnected:!1,registeredTools:[],initialize:async()=>{throw new Error("MCPToolsProvider not found")},getConnectionStatus:async()=>!1}}function Y(){return e.useContext(x)!==null}exports.MCPToolsProvider=V;exports.getRegisteredTools=B;exports.getToolInfo=K;exports.isToolRegistered=W;exports.useHasMCPProvider=Y;exports.useMCPAction=Q;exports.useMCPGetter=L;exports.useMCPTool=m;exports.useMCPToolsContext=X;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),i=require("@mcp-fe/mcp-worker"),_=require("react/jsx-runtime");function m(o){const{name:t,description:l,inputSchema:r,outputSchema:s,handler:f,annotations:C,execution:c,_meta:g,icons:P,title:d,autoRegister:S=!0,autoUnregister:T=!0}=o,[M,y]=e.useState(null),a=e.useRef(f),u=e.useRef(t),w=e.useRef(l),h=e.useRef(r),v=e.useRef(s),x=e.useRef(C),b=e.useRef(c),I=e.useRef(g),E=e.useRef(P),A=e.useRef(d),D=e.useRef(!0),k=e.useRef(!1);e.useEffect(()=>{a.current=f,u.current=t,w.current=l,h.current=r,v.current=s,x.current=C,b.current=c,I.current=g,E.current=P,A.current=d},[f,t,l,r,s,C,c,g,P,d]);const z=e.useCallback(async n=>a.current(n),[]),q=e.useCallback(async()=>{const n=u.current,R=w.current,N=h.current,H=v.current,O=x.current,U=b.current,F=I.current,G=E.current,J=A.current;try{await i.workerClient.registerTool(n,R,N,z,{outputSchema:H,annotations:O,execution:U,_meta:F,icons:G,title:J}),k.current=!0,console.log(`[useMCPTool] Registered tool '${n}'`)}catch(j){throw console.error(`[useMCPTool] Failed to register tool '${n}':`,j),j}},[z]),$=e.useCallback(async()=>{const n=u.current;try{await i.workerClient.unregisterTool(n),k.current=!1,console.log(`[useMCPTool] Unregistered tool '${n}'`)}catch(R){console.error(`[useMCPTool] Failed to unregister tool '${n}':`,R)}},[]);return e.useEffect(()=>i.workerClient.onToolChange(t,R=>{y(R)}),[t]),e.useEffect(()=>(S&&q().catch(n=>{console.error(`[useMCPTool] Auto-register failed for '${t}':`,n)}),()=>{D.current=!1,T&&k.current&&$().catch(n=>{console.error(`[useMCPTool] Auto-unregister failed for '${t}':`,n)})}),[t]),{isRegistered:M?.isRegistered??!1,refCount:M?.refCount??0,register:q,unregister:$}}function W(o){return i.workerClient.isToolRegistered(o)}function B(){return i.workerClient.getRegisteredTools()}function K(o){return i.workerClient.getToolInfo(o)}function L(o){return i.workerClient.getToolDetails(o)}function Q(o,t,l,r){const s=e.useCallback(async()=>{const f=await l();return{content:[{type:"text",text:JSON.stringify(f,null,2)}]}},[l]);return m({name:o,description:t,inputSchema:{type:"object",properties:{}},handler:s,...r})}function V(o,t,l,r,s){const f=e.useCallback(async C=>{const c=await r(C);return{content:[{type:"text",text:JSON.stringify(c,null,2)}]}},[r]);return m({name:o,description:t,inputSchema:{type:"object",properties:l,...s?.required&&{required:s.required}},handler:f,autoRegister:s?.autoRegister,autoUnregister:s?.autoUnregister})}const p=e.createContext(null);function X({children:o,autoInit:t=!0,backendWsUrl:l="ws://localhost:3001",authToken:r,initOptions:s,onInitialized:f,onInitError:C}){const[c,g]=e.useState(!1),[P,d]=e.useState(!1),[S]=e.useState([]),T=e.useCallback(async a=>{if(c){console.log("[MCPToolsProvider] Already initialized");return}try{const u=a||s||{backendWsUrl:l};console.log("[MCPToolsProvider] Initializing worker client...",u),await i.workerClient.init(u),r&&(console.log("[MCPToolsProvider] Setting auth token..."),i.workerClient.setAuthToken(r)),g(!0);const w=await i.workerClient.getConnectionStatus();d(w),i.workerClient.onConnectionStatus(h=>{d(h)}),console.log("[MCPToolsProvider] Worker client initialized"),f?.()}catch(u){throw console.error("[MCPToolsProvider] Initialization failed:",u),C?.(u instanceof Error?u:new Error(String(u))),u}},[c,s,l,r,f,C]),M=e.useCallback(async()=>{const a=await i.workerClient.getConnectionStatus();return d(a),a},[]);e.useEffect(()=>{t&&T().catch(a=>{console.error("[MCPToolsProvider] Auto-init failed:",a)})},[t,T]),e.useEffect(()=>{c&&r&&(console.log("[MCPToolsProvider] Auth token changed, updating..."),i.workerClient.setAuthToken(r))},[r,c]),e.useEffect(()=>{if(!c)return;const a=setInterval(()=>{},5e3);return()=>clearInterval(a)},[c]);const y={isInitialized:c,isConnected:P,registeredTools:S,initialize:T,getConnectionStatus:M};return _.jsx(p.Provider,{value:y,children:o})}function Y(o=!1){const t=e.useContext(p);if(!t&&o)throw new Error("useMCPToolsContext must be used within MCPToolsProvider. Either wrap your component tree with <MCPToolsProvider> or set strict=false.");return t||{isInitialized:!1,isConnected:!1,registeredTools:[],initialize:async()=>{throw new Error("MCPToolsProvider not found")},getConnectionStatus:async()=>!1}}function Z(){return e.useContext(p)!==null}exports.MCPToolsProvider=X;exports.getRegisteredTools=B;exports.getToolDetails=L;exports.getToolInfo=K;exports.isToolRegistered=W;exports.useHasMCPProvider=Z;exports.useMCPAction=V;exports.useMCPGetter=Q;exports.useMCPTool=m;exports.useMCPToolsContext=Y;

package/index.mjs

@@ -1,204 +1,217 @@
-import { useState as y, useRef as n, useEffect as R, useCallback as C, createContext as Q, useContext as F } from "react";
-import { workerClient as f } from "@mcp-fe/mcp-worker";
+import { useState as y, useRef as u, useEffect as P, useCallback as C, createContext as Q, useContext as k } from "react";
+import { workerClient as c } from "@mcp-fe/mcp-worker";
 import { jsx as V } from "react/jsx-runtime";
-function H(t) {
+function F(t) {
   const {
     name: e,
-    description: s,
-    inputSchema: c,
-    outputSchema: o,
-    handler: a,
-    annotations: i,
-    execution: d,
-    _meta: P,
-    icons: g,
-    title: T,
-    autoRegister: h = !0,
-    autoUnregister: x = !0
-  } = t, [p, l] = y(null), u = n(a), m = n(e), w = n(s), I = n(c), b = n(o), z = n(i), A = n(d), E = n(P), $ = n(g), N = n(T), J = n(!0), S = n(!1);
-  R(() => {
-    u.current = a, m.current = e, w.current = s, I.current = c, b.current = o, z.current = i, A.current = d, E.current = P, $.current = g, N.current = T;
+    description: l,
+    inputSchema: o,
+    outputSchema: n,
+    handler: f,
+    annotations: d,
+    execution: s,
+    _meta: T,
+    icons: h,
+    title: g,
+    autoRegister: S = !0,
+    autoUnregister: M = !0
+  } = t, [R, x] = y(null), a = u(f), i = u(e), p = u(l), w = u(o), A = u(n), b = u(d), z = u(s), E = u(T), $ = u(h), N = u(g), H = u(!0), v = u(!1);
+  P(() => {
+    a.current = f, i.current = e, p.current = l, w.current = o, A.current = n, b.current = d, z.current = s, E.current = T, $.current = h, N.current = g;
   }, [
-    a,
+    f,
     e,
-    s,
-    c,
+    l,
     o,
-    i,
+    n,
     d,
-    P,
-    g,
-    T
+    s,
+    T,
+    h,
+    g
   ]);
-  const j = C(async (r) => u.current(r), []), k = C(async () => {
-    const r = m.current, M = w.current, O = I.current, _ = b.current, D = z.current, G = A.current, B = E.current, K = $.current, L = N.current;
+  const j = C(async (r) => a.current(r), []), q = C(async () => {
+    const r = i.current, m = p.current, J = w.current, O = A.current, _ = b.current, G = z.current, B = E.current, K = $.current, L = N.current;
     try {
-      await f.registerTool(
+      await c.registerTool(
         r,
-        M,
-        O,
+        m,
+        J,
         j,
         {
-          outputSchema: _,
-          annotations: D,
+          outputSchema: O,
+          annotations: _,
           execution: G,
           _meta: B,
           icons: K,
           title: L
         }
-      ), S.current = !0, console.log(`[useMCPTool] Registered tool '${r}'`);
+      ), v.current = !0, console.log(`[useMCPTool] Registered tool '${r}'`);
     } catch (U) {
       throw console.error(
         `[useMCPTool] Failed to register tool '${r}':`,
         U
       ), U;
     }
-  }, [j]), q = C(async () => {
-    const r = m.current;
+  }, [j]), D = C(async () => {
+    const r = i.current;
     try {
-      await f.unregisterTool(r), S.current = !1, console.log(`[useMCPTool] Unregistered tool '${r}'`);
-    } catch (M) {
+      await c.unregisterTool(r), v.current = !1, console.log(`[useMCPTool] Unregistered tool '${r}'`);
+    } catch (m) {
       console.error(
         `[useMCPTool] Failed to unregister tool '${r}':`,
-        M
+        m
       );
     }
   }, []);
-  return R(() => f.onToolChange(e, (M) => {
-    l(M);
-  }), [e]), R(() => (h && k().catch((r) => {
+  return P(() => c.onToolChange(e, (m) => {
+    x(m);
+  }), [e]), P(() => (S && q().catch((r) => {
     console.error(
       `[useMCPTool] Auto-register failed for '${e}':`,
       r
     );
   }), () => {
-    J.current = !1, x && S.current && q().catch((r) => {
+    H.current = !1, M && v.current && D().catch((r) => {
       console.error(
         `[useMCPTool] Auto-unregister failed for '${e}':`,
         r
       );
     });
   }), [e]), {
-    isRegistered: p?.isRegistered ?? !1,
-    refCount: p?.refCount ?? 0,
-    register: k,
-    unregister: q
+    isRegistered: R?.isRegistered ?? !1,
+    refCount: R?.refCount ?? 0,
+    register: q,
+    unregister: D
   };
 }
 function Z(t) {
-  return f.isToolRegistered(t);
+  return c.isToolRegistered(t);
 }
 function ee() {
-  return f.getRegisteredTools();
+  return c.getRegisteredTools();
 }
 function te(t) {
-  return f.getToolInfo(t);
+  return c.getToolInfo(t);
+}
+function oe(t) {
+  return c.getToolDetails(t);
 }
-function re(t, e, s, c) {
-  const o = C(async () => {
-    const a = await s();
+function re(t, e, l, o) {
+  const n = C(async () => {
+    const f = await l();
     return {
       content: [
         {
           type: "text",
-          text: JSON.stringify(a, null, 2)
+          text: JSON.stringify(f, null, 2)
         }
       ]
     };
-  }, [s]);
-  return H({
+  }, [l]);
+  return F({
     name: t,
     description: e,
     inputSchema: {
       type: "object",
       properties: {}
     },
-    handler: o,
-    ...c
+    handler: n,
+    ...o
   });
 }
-function oe(t, e, s, c, o) {
-  const a = C(
-    async (i) => {
-      const d = await c(i);
+function ne(t, e, l, o, n) {
+  const f = C(
+    async (d) => {
+      const s = await o(d);
       return {
         content: [
           {
             type: "text",
-            text: JSON.stringify(d, null, 2)
+            text: JSON.stringify(s, null, 2)
           }
         ]
       };
     },
-    [c]
+    [o]
   );
-  return H({
+  return F({
     name: t,
     description: e,
     inputSchema: {
       type: "object",
-      properties: s,
-      ...o?.required && { required: o.required }
+      properties: l,
+      ...n?.required && { required: n.required }
     },
-    handler: a,
-    autoRegister: o?.autoRegister,
-    autoUnregister: o?.autoUnregister
+    handler: f,
+    autoRegister: n?.autoRegister,
+    autoUnregister: n?.autoUnregister
   });
 }
-const v = Q(null);
-function ne({
+const I = Q(null);
+function se({
   children: t,
   autoInit: e = !0,
-  backendWsUrl: s = "ws://localhost:3001",
-  initOptions: c,
-  onInitialized: o,
-  onInitError: a
+  backendWsUrl: l = "ws://localhost:3001",
+  authToken: o,
+  initOptions: n,
+  onInitialized: f,
+  onInitError: d
 }) {
-  const [i, d] = y(!1), [P, g] = y(!1), [T] = y([]), h = C(
-    async (l) => {
-      if (i) {
+  const [s, T] = y(!1), [h, g] = y(!1), [S] = y([]), M = C(
+    async (a) => {
+      if (s) {
         console.log("[MCPToolsProvider] Already initialized");
         return;
       }
       try {
-        const u = l || c || { backendWsUrl: s };
-        console.log("[MCPToolsProvider] Initializing worker client...", u), await f.init(u), d(!0);
-        const m = await f.getConnectionStatus();
-        g(m), f.onConnectionStatus((w) => {
+        const i = a || n || { backendWsUrl: l };
+        console.log("[MCPToolsProvider] Initializing worker client...", i), await c.init(i), o && (console.log("[MCPToolsProvider] Setting auth token..."), c.setAuthToken(o)), T(!0);
+        const p = await c.getConnectionStatus();
+        g(p), c.onConnectionStatus((w) => {
           g(w);
-        }), console.log("[MCPToolsProvider] Worker client initialized"), o?.();
-      } catch (u) {
-        throw console.error("[MCPToolsProvider] Initialization failed:", u), a?.(
-          u instanceof Error ? u : new Error(String(u))
-        ), u;
+        }), console.log("[MCPToolsProvider] Worker client initialized"), f?.();
+      } catch (i) {
+        throw console.error("[MCPToolsProvider] Initialization failed:", i), d?.(
+          i instanceof Error ? i : new Error(String(i))
+        ), i;
       }
     },
-    [i, c, s, o, a]
-  ), x = C(async () => {
-    const l = await f.getConnectionStatus();
-    return g(l), l;
+    [
+      s,
+      n,
+      l,
+      o,
+      f,
+      d
+    ]
+  ), R = C(async () => {
+    const a = await c.getConnectionStatus();
+    return g(a), a;
   }, []);
-  R(() => {
-    e && h().catch((l) => {
-      console.error("[MCPToolsProvider] Auto-init failed:", l);
+  P(() => {
+    e && M().catch((a) => {
+      console.error("[MCPToolsProvider] Auto-init failed:", a);
     });
-  }, [e, h]), R(() => {
-    if (!i) return;
-    const l = setInterval(() => {
+  }, [e, M]), P(() => {
+    s && o && (console.log("[MCPToolsProvider] Auth token changed, updating..."), c.setAuthToken(o));
+  }, [o, s]), P(() => {
+    if (!s) return;
+    const a = setInterval(() => {
     }, 5e3);
-    return () => clearInterval(l);
-  }, [i]);
-  const p = {
-    isInitialized: i,
-    isConnected: P,
-    registeredTools: T,
-    initialize: h,
-    getConnectionStatus: x
+    return () => clearInterval(a);
+  }, [s]);
+  const x = {
+    isInitialized: s,
+    isConnected: h,
+    registeredTools: S,
+    initialize: M,
+    getConnectionStatus: R
   };
-  return /* @__PURE__ */ V(v.Provider, { value: p, children: t });
+  return /* @__PURE__ */ V(I.Provider, { value: x, children: t });
 }
-function se(t = !1) {
-  const e = F(v);
+function ce(t = !1) {
+  const e = k(I);
   if (!e && t)
     throw new Error(
       "useMCPToolsContext must be used within MCPToolsProvider. Either wrap your component tree with <MCPToolsProvider> or set strict=false."
@@ -213,17 +226,18 @@ function se(t = !1) {
     getConnectionStatus: async () => !1
   };
 }
-function ce() {
-  return F(v) !== null;
+function ie() {
+  return k(I) !== null;
 }
 export {
-  ne as MCPToolsProvider,
+  se as MCPToolsProvider,
   ee as getRegisteredTools,
+  oe as getToolDetails,
   te as getToolInfo,
   Z as isToolRegistered,
-  ce as useHasMCPProvider,
-  oe as useMCPAction,
+  ie as useHasMCPProvider,
+  ne as useMCPAction,
   re as useMCPGetter,
-  H as useMCPTool,
-  se as useMCPToolsContext
+  F as useMCPTool,
+  ce as useMCPToolsContext
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-fe/react-tools",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "license": "Apache-2.0",
   "homepage": "https://mcp-fe.ai",
   "repository": {
@@ -19,7 +19,7 @@
     }
   },
   "peerDependencies": {
-    "@mcp-fe/mcp-worker": "^0.1.8",
+    "@mcp-fe/mcp-worker": "^0.1.9",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },

package/utils.d.ts

@@ -0,0 +1,35 @@
+import { ToolDefinition } from '@mcp-fe/mcp-worker';
+/**
+ * Check if a tool is currently registered
+ *
+ * @param name - Tool name to check
+ * @returns true if tool is registered, false otherwise
+ */
+export declare function isToolRegistered(name: string): boolean;
+/**
+ * Get list of all currently registered tool names
+ *
+ * @returns Array of registered tool names
+ */
+export declare function getRegisteredTools(): string[];
+/**
+ * Get basic registration information for a specific tool
+ *
+ * @param name - Tool name to query
+ * @returns Object with refCount and isRegistered, or null if tool not found
+ */
+export declare function getToolInfo(name: string): {
+    refCount: number;
+    isRegistered: boolean;
+} | null;
+/**
+ * Get complete tool definition including description, schema, annotations, and metadata
+ *
+ * @param name - Tool name to query
+ * @returns Full ToolDefinition with refCount and isRegistered, or null if tool not found
+ */
+export declare function getToolDetails(name: string): (ToolDefinition & {
+    refCount: number;
+    isRegistered: boolean;
+}) | null;
+//# sourceMappingURL=utils.d.ts.map

package/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../libs/react-tools/src/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,GACX;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GACvC,CAAC,cAAc,GAAG;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC,GACF,IAAI,CAEP"}