@frontmcp/react 0.0.1

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "@frontmcp/react",
+  "version": "0.0.1",
+  "description": "React hooks, components, and AI SDK integration for FrontMCP",
+  "author": "AgentFront <info@agentfront.dev>",
+  "homepage": "https://docs.agentfront.dev",
+  "license": "Apache-2.0",
+  "keywords": [
+    "mcp",
+    "react",
+    "hooks",
+    "ai",
+    "tools",
+    "openai",
+    "claude",
+    "vercel-ai",
+    "agentfront",
+    "frontmcp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentfront/frontmcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/agentfront/frontmcp/issues"
+  },
+  "type": "commonjs",
+  "main": "./index.js",
+  "module": "./esm/index.mjs",
+  "types": "./index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "require": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      },
+      "import": {
+        "types": "./index.d.ts",
+        "default": "./esm/index.mjs"
+      }
+    },
+    "./ai": {
+      "require": {
+        "types": "./ai/index.d.ts",
+        "default": "./ai/index.js"
+      },
+      "import": {
+        "types": "./ai/index.d.ts",
+        "default": "./esm/ai/index.mjs"
+      }
+    },
+    "./router": {
+      "require": {
+        "types": "./router/index.d.ts",
+        "default": "./router/index.js"
+      },
+      "import": {
+        "types": "./router/index.d.ts",
+        "default": "./esm/router/index.mjs"
+      }
+    },
+    "./state": {
+      "require": {
+        "types": "./state/index.d.ts",
+        "default": "./state/index.js"
+      },
+      "import": {
+        "types": "./state/index.d.ts",
+        "default": "./esm/state/index.mjs"
+      }
+    },
+    "./api": {
+      "require": {
+        "types": "./api/index.d.ts",
+        "default": "./api/index.js"
+      },
+      "import": {
+        "types": "./api/index.d.ts",
+        "default": "./esm/api/index.mjs"
+      }
+    }
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "@frontmcp/sdk": "1.0.0",
+    "@frontmcp/utils": "1.0.0",
+    "react-router-dom": "^7.0.0",
+    "zod": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react-router-dom": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@frontmcp/sdk": "1.0.0",
+    "@frontmcp/utils": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}

package/provider/FrontMcpContext.d.ts

@@ -0,0 +1,6 @@
+/**
+ * React context for FrontMCP.
+ */
+import type { FrontMcpContextValue } from '../types';
+export declare const FrontMcpContext: import("react").Context<FrontMcpContextValue>;
+//# sourceMappingURL=FrontMcpContext.d.ts.map

package/provider/FrontMcpContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrontMcpContext.d.ts","sourceRoot":"","sources":["../../src/provider/FrontMcpContext.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAMrD,eAAO,MAAM,eAAe,+CAM1B,CAAC"}

package/provider/FrontMcpProvider.d.ts

@@ -0,0 +1,34 @@
+/**
+ * FrontMcpProvider — manages MCP client lifecycle for a pre-created server.
+ *
+ * 1. Receives an already-created `DirectMcpServer` via the `server` prop
+ * 2. Optionally receives additional named servers via `servers` prop
+ * 3. Merges developer-registered components into the ComponentRegistry
+ * 4. Optionally auto-connects a client on mount (default: true)
+ * 5. Registers all servers into the shared ServerRegistry singleton
+ * 6. Creates a DynamicRegistry for dynamic tool/resource registration
+ * 7. Wraps the server to overlay dynamic entries on list/call operations
+ * 8. All state (status, tools, etc.) lives in the ServerRegistry — context
+ *    carries only `name`, `registry`, `dynamicRegistry`, and `connect`.
+ */
+import React from 'react';
+import type { ComponentType } from 'react';
+import type { DirectMcpServer, DirectClient } from '@frontmcp/sdk';
+import type { StoreAdapter } from '../types';
+export interface FrontMcpProviderProps {
+    /** Logical name for the primary server (defaults to 'default') */
+    name?: string;
+    /** Primary MCP server — registered under `name` in ServerRegistry */
+    server: DirectMcpServer;
+    /** Additional named servers — each registered by key in ServerRegistry */
+    servers?: Record<string, DirectMcpServer>;
+    components?: Record<string, ComponentType<Record<string, unknown>>>;
+    /** Store adapters to register at the provider level (reduxStore, valtioStore, createStore). */
+    stores?: StoreAdapter[];
+    autoConnect?: boolean;
+    children: React.ReactNode;
+    onConnected?: (client: DirectClient) => void;
+    onError?: (error: Error) => void;
+}
+export declare function FrontMcpProvider({ name: nameProp, server, servers, components, stores, autoConnect, children, onConnected, onError, }: FrontMcpProviderProps): React.ReactElement;
+//# sourceMappingURL=FrontMcpProvider.d.ts.map

package/provider/FrontMcpProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrontMcpProvider.d.ts","sourceRoot":"","sources":["../../src/provider/FrontMcpProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAkD,MAAM,OAAO,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAK7C,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,MAAM,EAAE,eAAe,CAAC;IACxB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,+FAA+F;IAC/F,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EAAE,QAAQ,EACd,MAAM,EACN,OAAO,EACP,UAAU,EACV,MAAM,EACN,WAAkB,EAClB,QAAQ,EACR,WAAW,EACX,OAAO,GACR,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CAsN5C"}

package/provider/index.d.ts

@@ -0,0 +1,4 @@
+export { FrontMcpContext } from './FrontMcpContext';
+export { FrontMcpProvider } from './FrontMcpProvider';
+export type { FrontMcpProviderProps } from './FrontMcpProvider';
+//# sourceMappingURL=index.d.ts.map

package/provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/registry/DynamicRegistry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * DynamicRegistry — React-side registry for tools and resources that
+ * components register on mount and unregister on unmount.
+ *
+ * Operates as an overlay on the base DirectMcpServer: dynamic entries
+ * are merged into listTools/listResources and checked first on
+ * callTool/readResource.
+ *
+ * Uses the same listener/version pattern as ServerRegistry for
+ * useSyncExternalStore compatibility.
+ */
+import type { DynamicToolDef, DynamicResourceDef } from '../types';
+type Listener = () => void;
+export declare class DynamicRegistry {
+    private tools;
+    private resources;
+    private toolRefCounts;
+    private resourceRefCounts;
+    private listeners;
+    private version;
+    /**
+     * Register a dynamic tool. Returns an unregister function
+     * suitable for useEffect cleanup.
+     *
+     * Multiple registrations of the same name are ref-counted:
+     * subsequent registrations update the definition but the tool
+     * is only removed when every registrant has unregistered.
+     */
+    registerTool(def: DynamicToolDef): () => void;
+    unregisterTool(name: string): void;
+    /**
+     * Register a dynamic resource. Returns an unregister function
+     * suitable for useEffect cleanup.
+     *
+     * Multiple registrations of the same URI are ref-counted.
+     */
+    registerResource(def: DynamicResourceDef): () => void;
+    unregisterResource(uri: string): void;
+    /** Update the execute function for an existing tool (for stale closure prevention). */
+    updateToolExecute(name: string, execute: DynamicToolDef['execute']): void;
+    /** Update the read function for an existing resource and notify subscribers. */
+    updateResourceRead(uri: string, read: DynamicResourceDef['read']): void;
+    getTools(): DynamicToolDef[];
+    getResources(): DynamicResourceDef[];
+    findTool(name: string): DynamicToolDef | undefined;
+    findResource(uri: string): DynamicResourceDef | undefined;
+    hasTool(name: string): boolean;
+    hasResource(uri: string): boolean;
+    subscribe(listener: Listener): () => void;
+    getVersion(): number;
+    clear(): void;
+    private notify;
+}
+export {};
+//# sourceMappingURL=DynamicRegistry.d.ts.map

package/registry/DynamicRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamicRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/DynamicRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnE,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAAK;IAEpB;;;;;;;OAOG;IACH,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,IAAI;IAe7C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAYlC;;;;;OAKG;IACH,gBAAgB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAerD,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAYrC,uFAAuF;IACvF,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,GAAG,IAAI;IAOzE,gFAAgF;IAChF,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,IAAI;IAQvE,QAAQ,IAAI,cAAc,EAAE;IAI5B,YAAY,IAAI,kBAAkB,EAAE;IAIpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIlD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIzD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIjC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAOzC,UAAU,IAAI,MAAM;IAIpB,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,MAAM;CAMf"}

package/registry/ServerRegistry.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ServerRegistry — shared singleton that maps server names to DirectMcpServer instances.
+ *
+ * Enables multiple MCP servers to coexist in a single React app without
+ * requiring multiple providers or React Router trees. Hooks can target
+ * a specific server by name via `{ server: 'name' }` option.
+ *
+ * Integrates with React via useSyncExternalStore for tear-free reads.
+ */
+import type { DirectMcpServer, DirectClient } from '@frontmcp/sdk';
+import type { FrontMcpStatus, ToolInfo, ResourceInfo, ResourceTemplateInfo, PromptInfo } from '../types';
+type Listener = () => void;
+export interface ServerEntry {
+    server: DirectMcpServer;
+    client: DirectClient | null;
+    status: FrontMcpStatus;
+    error: Error | null;
+    tools: ToolInfo[];
+    resources: ResourceInfo[];
+    resourceTemplates: ResourceTemplateInfo[];
+    prompts: PromptInfo[];
+}
+export declare class ServerRegistry {
+    private entries;
+    private listeners;
+    private version;
+    register(name: string, server: DirectMcpServer): void;
+    unregister(name: string): void;
+    get(name: string): ServerEntry | undefined;
+    has(name: string): boolean;
+    list(): string[];
+    connect(name: string): Promise<DirectClient>;
+    connectAll(): Promise<void>;
+    update(name: string, partial: Partial<ServerEntry>): void;
+    clear(): void;
+    subscribe(listener: Listener): () => void;
+    getVersion(): number;
+    private notify;
+}
+/** Module-scoped singleton — shared across all components. */
+export declare const serverRegistry: ServerRegistry;
+export {};
+//# sourceMappingURL=ServerRegistry.d.ts.map

package/registry/ServerRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/ServerRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEzG,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;IAC1C,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAAK;IAEpB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAcrD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,MAAM,EAAE;IAIV,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAuC5C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAQzD,KAAK,IAAI,IAAI;IAKb,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAOzC,UAAU,IAAI,MAAM;IAIpB,OAAO,CAAC,MAAM;CAIf;AAED,8DAA8D;AAC9D,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/registry/createWrappedServer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * createWrappedServer — wraps a DirectMcpServer with a DynamicRegistry overlay.
+ *
+ * Intercepts listTools/callTool/listResources/readResource to merge
+ * dynamically registered entries. All other methods delegate directly.
+ */
+import type { DirectMcpServer } from '@frontmcp/sdk';
+import type { DynamicRegistry } from './DynamicRegistry';
+/**
+ * Create a wrapped DirectMcpServer that overlays dynamic tools and resources.
+ * Dynamic entries take precedence over base server entries with the same name/uri.
+ */
+export declare function createWrappedServer(base: DirectMcpServer, dynamicRegistry: DynamicRegistry): DirectMcpServer;
+//# sourceMappingURL=createWrappedServer.d.ts.map

package/registry/createWrappedServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWrappedServer.d.ts","sourceRoot":"","sources":["../../src/registry/createWrappedServer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EAKhB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAiCzD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,GAAG,eAAe,CA4H5G"}

package/registry/index.d.ts

@@ -0,0 +1,5 @@
+export { ServerRegistry, serverRegistry } from './ServerRegistry';
+export type { ServerEntry } from './ServerRegistry';
+export { DynamicRegistry } from './DynamicRegistry';
+export { createWrappedServer } from './createWrappedServer';
+//# sourceMappingURL=index.d.ts.map

package/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/router/current-route.resource.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CurrentRouteResource — MCP resource that reads the current URL/path/params.
+ */
+import type { ReadResourceResult } from '@frontmcp/sdk';
+export declare class CurrentRouteResource {
+    static readonly uri = "route://current";
+    static readonly resourceName = "Current Route";
+    static readonly description = "Read the current URL path, search params, and hash";
+    static read(): ReadResourceResult;
+}
+//# sourceMappingURL=current-route.resource.d.ts.map

package/router/current-route.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-route.resource.d.ts","sourceRoot":"","sources":["../../src/router/current-route.resource.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,QAAQ,CAAC,GAAG,qBAAqB;IACxC,MAAM,CAAC,QAAQ,CAAC,YAAY,mBAAmB;IAC/C,MAAM,CAAC,QAAQ,CAAC,WAAW,wDAAwD;IAEnF,MAAM,CAAC,IAAI,IAAI,kBAAkB;CA+BlC"}

package/router/go-back.tool.d.ts

@@ -0,0 +1,18 @@
+/**
+ * GoBackTool — MCP tool that goes back to the previous page in history.
+ */
+export declare class GoBackTool {
+    static readonly toolName = "go_back";
+    static readonly description = "Go back to the previous page in browser history";
+    static readonly inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    static execute(): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=go-back.tool.d.ts.map

package/router/go-back.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-back.tool.d.ts","sourceRoot":"","sources":["../../src/router/go-back.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,qBAAa,UAAU;IACrB,MAAM,CAAC,QAAQ,CAAC,QAAQ,aAAa;IACrC,MAAM,CAAC,QAAQ,CAAC,WAAW,qDAAqD;IAChF,MAAM,CAAC,QAAQ,CAAC,WAAW;;;MAGzB;WAEW,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAkBpF"}

package/router/index.d.ts

@@ -0,0 +1,9 @@
+export { useRouterBridge } from './useRouterBridge';
+export { NavigateTool } from './navigate.tool';
+export { GoBackTool } from './go-back.tool';
+export { CurrentRouteResource } from './current-route.resource';
+export { createRouterEntries } from './router.entries';
+export type { RouterEntries } from './router.entries';
+export type { BridgeLocation, NavigateFn } from './router-bridge';
+export { setNavigate, setLocation, getNavigate, getLocation, clearBridge } from './router-bridge';
+//# sourceMappingURL=index.d.ts.map

package/router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/router/index.js

@@ -0,0 +1,180 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// libs/react/src/router/index.ts
+var router_exports = {};
+__export(router_exports, {
+  CurrentRouteResource: () => CurrentRouteResource,
+  GoBackTool: () => GoBackTool,
+  NavigateTool: () => NavigateTool,
+  clearBridge: () => clearBridge,
+  createRouterEntries: () => createRouterEntries,
+  getLocation: () => getLocation,
+  getNavigate: () => getNavigate,
+  setLocation: () => setLocation,
+  setNavigate: () => setNavigate,
+  useRouterBridge: () => useRouterBridge
+});
+module.exports = __toCommonJS(router_exports);
+
+// libs/react/src/router/useRouterBridge.ts
+var import_react = require("react");
+var import_react_router_dom = require("react-router-dom");
+
+// libs/react/src/router/router-bridge.ts
+var currentNavigate = null;
+var currentLocation = null;
+function setNavigate(fn) {
+  currentNavigate = fn;
+}
+function setLocation(loc) {
+  currentLocation = loc;
+}
+function getNavigate() {
+  return currentNavigate;
+}
+function getLocation() {
+  return currentLocation;
+}
+function clearBridge() {
+  currentNavigate = null;
+  currentLocation = null;
+}
+
+// libs/react/src/router/useRouterBridge.ts
+function useRouterBridge() {
+  const navigate = (0, import_react_router_dom.useNavigate)();
+  const location = (0, import_react_router_dom.useLocation)();
+  (0, import_react.useEffect)(() => {
+    setNavigate(navigate);
+    return () => {
+      clearBridge();
+    };
+  }, [navigate]);
+  (0, import_react.useEffect)(() => {
+    setLocation({
+      pathname: location.pathname,
+      search: location.search,
+      hash: location.hash
+    });
+  }, [location.pathname, location.search, location.hash]);
+}
+
+// libs/react/src/router/navigate.tool.ts
+var NavigateTool = class {
+  static toolName = "navigate";
+  static description = "Navigate to a URL path in the application";
+  static inputSchema = {
+    type: "object",
+    properties: {
+      path: { type: "string", description: "The URL path to navigate to" },
+      replace: { type: "boolean", description: "Replace current history entry instead of pushing" }
+    },
+    required: ["path"]
+  };
+  static async execute(args) {
+    const navigate = getNavigate();
+    if (!navigate) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: "Router bridge not connected. Ensure useRouterBridge() is called inside a React Router tree."
+          }
+        ]
+      };
+    }
+    navigate(args.path, { replace: args.replace });
+    return {
+      content: [{ type: "text", text: `Navigated to ${args.path}` }]
+    };
+  }
+};
+
+// libs/react/src/router/go-back.tool.ts
+var GoBackTool = class {
+  static toolName = "go_back";
+  static description = "Go back to the previous page in browser history";
+  static inputSchema = {
+    type: "object",
+    properties: {}
+  };
+  static async execute() {
+    const navigate = getNavigate();
+    if (!navigate) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: "Router bridge not connected. Ensure useRouterBridge() is called inside a React Router tree."
+          }
+        ]
+      };
+    }
+    navigate(-1);
+    return {
+      content: [{ type: "text", text: "Navigated back" }]
+    };
+  }
+};
+
+// libs/react/src/router/current-route.resource.ts
+var CurrentRouteResource = class _CurrentRouteResource {
+  static uri = "route://current";
+  static resourceName = "Current Route";
+  static description = "Read the current URL path, search params, and hash";
+  static read() {
+    const location = getLocation();
+    if (!location) {
+      return {
+        contents: [
+          {
+            uri: _CurrentRouteResource.uri,
+            mimeType: "application/json",
+            text: JSON.stringify({
+              error: "Router bridge not connected. Ensure useRouterBridge() is called inside a React Router tree."
+            })
+          }
+        ]
+      };
+    }
+    return {
+      contents: [
+        {
+          uri: _CurrentRouteResource.uri,
+          mimeType: "application/json",
+          text: JSON.stringify({
+            pathname: location.pathname,
+            search: location.search,
+            hash: location.hash,
+            href: `${location.pathname}${location.search}${location.hash}`
+          })
+        }
+      ]
+    };
+  }
+};
+
+// libs/react/src/router/router.entries.ts
+function createRouterEntries() {
+  return {
+    tools: [NavigateTool, GoBackTool],
+    resources: [CurrentRouteResource]
+  };
+}

package/router/navigate.tool.d.ts

@@ -0,0 +1,35 @@
+/**
+ * NavigateTool — MCP tool that navigates to a URL path in the application.
+ *
+ * This is a plain class (not using SDK decorators) to avoid requiring
+ * reflect-metadata in browser bundles. It exposes the same shape that
+ * `create()` accepts in its `tools` array.
+ */
+export declare class NavigateTool {
+    static readonly toolName = "navigate";
+    static readonly description = "Navigate to a URL path in the application";
+    static readonly inputSchema: {
+        type: "object";
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            replace: {
+                type: string;
+                description: string;
+            };
+        };
+        required: readonly ["path"];
+    };
+    static execute(args: {
+        path: string;
+        replace?: boolean;
+    }): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=navigate.tool.d.ts.map

package/router/navigate.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.tool.d.ts","sourceRoot":"","sources":["../../src/router/navigate.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,WAAW,+CAA+C;IAC1E,MAAM,CAAC,QAAQ,CAAC,WAAW;;;;;;;;;;;;;MAOzB;WAEW,OAAO,CAAC,IAAI,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAkBhE"}

package/router/router-bridge.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Router bridge — module-scoped singleton holding navigate/location.
+ *
+ * Single-threaded browser context means no async context needed.
+ * `useRouterBridge()` populates this on every render/route change.
+ */
+export interface BridgeLocation {
+    pathname: string;
+    search: string;
+    hash: string;
+}
+export type NavigateFn = (to: string | number, options?: {
+    replace?: boolean;
+}) => void;
+export declare function setNavigate(fn: NavigateFn): void;
+export declare function setLocation(loc: BridgeLocation): void;
+export declare function getNavigate(): NavigateFn | null;
+export declare function getLocation(): BridgeLocation | null;
+export declare function clearBridge(): void;
+//# sourceMappingURL=router-bridge.d.ts.map

package/router/router-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-bridge.d.ts","sourceRoot":"","sources":["../../src/router/router-bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,CAAC;AAKxF,wBAAgB,WAAW,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAEhD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAErD;AAED,wBAAgB,WAAW,IAAI,UAAU,GAAG,IAAI,CAE/C;AAED,wBAAgB,WAAW,IAAI,cAAc,GAAG,IAAI,CAEnD;AAED,wBAAgB,WAAW,IAAI,IAAI,CAGlC"}

package/router/router.entries.d.ts

@@ -0,0 +1,23 @@
+/**
+ * createRouterEntries — factory that returns tool/resource entries for easy
+ * spreading into `create()` config.
+ *
+ * @example
+ * ```ts
+ * const { tools, resources } = createRouterEntries();
+ * const server = await create({
+ *   info: { name: 'app', version: '1.0.0' },
+ *   tools: [...tools, ...myTools],
+ *   resources: [...resources, ...myResources],
+ * });
+ * ```
+ */
+import { NavigateTool } from './navigate.tool';
+import { GoBackTool } from './go-back.tool';
+import { CurrentRouteResource } from './current-route.resource';
+export interface RouterEntries {
+    tools: [typeof NavigateTool, typeof GoBackTool];
+    resources: [typeof CurrentRouteResource];
+}
+export declare function createRouterEntries(): RouterEntries;
+//# sourceMappingURL=router.entries.d.ts.map

package/router/router.entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.entries.d.ts","sourceRoot":"","sources":["../../src/router/router.entries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,CAAC,OAAO,YAAY,EAAE,OAAO,UAAU,CAAC,CAAC;IAChD,SAAS,EAAE,CAAC,OAAO,oBAAoB,CAAC,CAAC;CAC1C;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAKnD"}

package/router/useRouterBridge.d.ts

@@ -0,0 +1,7 @@
+/**
+ * useRouterBridge — wires React Router's navigate/location into the bridge singleton.
+ *
+ * Must be called inside a React Router tree (e.g., <BrowserRouter>).
+ */
+export declare function useRouterBridge(): void;
+//# sourceMappingURL=useRouterBridge.d.ts.map

package/router/useRouterBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRouterBridge.d.ts","sourceRoot":"","sources":["../../src/router/useRouterBridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,wBAAgB,eAAe,IAAI,IAAI,CAkBtC"}