@tooluminati/router 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jitterbox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,218 @@
+"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);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  WebMcpReactRouterScope: () => WebMcpReactRouterScope,
+  createCurrentRouteTool: () => createCurrentRouteTool,
+  createNavigationStateTool: () => createNavigationStateTool,
+  createNextClientRouterDiagnosticsProvider: () => createNextClientRouterDiagnosticsProvider,
+  createReactRouterDiagnosticsProvider: () => createReactRouterDiagnosticsProvider,
+  createRouteContextTool: () => createRouteContextTool,
+  createTanStackRouterDiagnosticsProvider: () => createTanStackRouterDiagnosticsProvider
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/next-client.tsx
+function createNextClientRouterDiagnosticsProvider(input, options = {}) {
+  return {
+    loaderAllowlist: options.loaderAllowlist,
+    getCurrentRoute() {
+      const value = input();
+      return {
+        pathname: value.pathname,
+        search: value.search,
+        hash: value.hash,
+        params: value.params
+      };
+    },
+    getNavigationState() {
+      return { state: "idle" };
+    }
+  };
+}
+
+// src/react-router.tsx
+var import_react = require("react");
+var import_react2 = require("@tooluminati/react");
+
+// src/tools.ts
+function createCurrentRouteTool(provider, name = "get_current_route") {
+  return {
+    name,
+    description: "Returns the current router-derived route, params, search, hash, and safe match summary.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: () => provider.getCurrentRoute()
+  };
+}
+function createNavigationStateTool(provider, name = "get_navigation_state") {
+  return {
+    name,
+    description: "Returns router navigation state, pending path, blockers, and safe blocker reasons.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: () => provider.getNavigationState?.() ?? {
+      state: "idle"
+    }
+  };
+}
+function pickAllowlistedLoaderData(data, allowlist) {
+  if (!data || typeof data !== "object" || !allowlist?.length) {
+    return void 0;
+  }
+  const record = data;
+  return Object.fromEntries(
+    allowlist.filter((key) => key in record).map((key) => [key, record[key]])
+  );
+}
+function createRouteContextTool(provider, name = "get_route_context") {
+  return {
+    name,
+    description: "Returns a redacted summary of current route loader/context state before any raw data.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: () => {
+      const context = provider.getRouteContext?.() ?? {};
+      const loaderData = pickAllowlistedLoaderData(
+        context.loaderData,
+        provider.loaderAllowlist
+      );
+      return {
+        routeId: context.routeId,
+        loaderStatus: context.loaderStatus,
+        dataShape: context.dataShape,
+        safeLabels: context.safeLabels,
+        ...loaderData !== void 0 ? { loaderData } : {}
+      };
+    }
+  };
+}
+
+// src/react-router.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function createReactRouterDiagnosticsProvider(input, options = {}) {
+  return {
+    loaderAllowlist: options.loaderAllowlist,
+    getCurrentRoute() {
+      const value = input();
+      return {
+        pathname: value.location.pathname,
+        search: value.location.search,
+        hash: value.location.hash,
+        params: value.params,
+        matches: value.matches?.map((match) => ({
+          id: match.id,
+          path: match.pathname
+        }))
+      };
+    },
+    getNavigationState() {
+      const navigation = input().navigation;
+      return {
+        state: navigation?.state ?? "idle",
+        pendingPathname: navigation?.location?.pathname
+      };
+    },
+    getRouteContext() {
+      const value = input();
+      return {
+        loaderData: value.loaderData
+      };
+    }
+  };
+}
+function WebMcpReactRouterScope({
+  children,
+  useRouterState,
+  loaderAllowlist,
+  namespaceSegment
+}) {
+  const provider = (0, import_react.useMemo)(
+    () => createReactRouterDiagnosticsProvider(useRouterState, {
+      loaderAllowlist
+    }),
+    [useRouterState, loaderAllowlist]
+  );
+  const tools = (0, import_react.useMemo)(
+    () => [
+      createCurrentRouteTool(provider),
+      createNavigationStateTool(provider),
+      createRouteContextTool(provider)
+    ],
+    [provider]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react2.WebMcpScope, { tools, source: "route", namespaceSegment, children });
+}
+
+// src/tanstack-router.tsx
+function createTanStackRouterDiagnosticsProvider(input, options = {}) {
+  return {
+    loaderAllowlist: options.loaderAllowlist,
+    getCurrentRoute() {
+      const value = input();
+      return {
+        pathname: value.location.pathname,
+        search: value.location.search,
+        hash: value.location.hash,
+        params: value.params,
+        matches: value.matches?.map((match) => ({
+          id: match.id,
+          path: match.pathname,
+          status: match.status
+        }))
+      };
+    },
+    getNavigationState() {
+      const navigation = input().navigation;
+      return {
+        state: navigation?.state ?? "idle",
+        pendingPathname: navigation?.location?.pathname
+      };
+    },
+    getRouteContext() {
+      return {
+        loaderData: input().loaderData
+      };
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WebMcpReactRouterScope,
+  createCurrentRouteTool,
+  createNavigationStateTool,
+  createNextClientRouterDiagnosticsProvider,
+  createReactRouterDiagnosticsProvider,
+  createRouteContextTool,
+  createTanStackRouterDiagnosticsProvider
+});

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './next-client';
+export * from './react-router';
+export * from './tanstack-router';
+export * from './tools';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,185 @@
+// src/next-client.tsx
+function createNextClientRouterDiagnosticsProvider(input, options = {}) {
+  return {
+    loaderAllowlist: options.loaderAllowlist,
+    getCurrentRoute() {
+      const value = input();
+      return {
+        pathname: value.pathname,
+        search: value.search,
+        hash: value.hash,
+        params: value.params
+      };
+    },
+    getNavigationState() {
+      return { state: "idle" };
+    }
+  };
+}
+
+// src/react-router.tsx
+import { useMemo } from "react";
+import { WebMcpScope } from "@tooluminati/react";
+
+// src/tools.ts
+function createCurrentRouteTool(provider, name = "get_current_route") {
+  return {
+    name,
+    description: "Returns the current router-derived route, params, search, hash, and safe match summary.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: () => provider.getCurrentRoute()
+  };
+}
+function createNavigationStateTool(provider, name = "get_navigation_state") {
+  return {
+    name,
+    description: "Returns router navigation state, pending path, blockers, and safe blocker reasons.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: () => provider.getNavigationState?.() ?? {
+      state: "idle"
+    }
+  };
+}
+function pickAllowlistedLoaderData(data, allowlist) {
+  if (!data || typeof data !== "object" || !allowlist?.length) {
+    return void 0;
+  }
+  const record = data;
+  return Object.fromEntries(
+    allowlist.filter((key) => key in record).map((key) => [key, record[key]])
+  );
+}
+function createRouteContextTool(provider, name = "get_route_context") {
+  return {
+    name,
+    description: "Returns a redacted summary of current route loader/context state before any raw data.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: () => {
+      const context = provider.getRouteContext?.() ?? {};
+      const loaderData = pickAllowlistedLoaderData(
+        context.loaderData,
+        provider.loaderAllowlist
+      );
+      return {
+        routeId: context.routeId,
+        loaderStatus: context.loaderStatus,
+        dataShape: context.dataShape,
+        safeLabels: context.safeLabels,
+        ...loaderData !== void 0 ? { loaderData } : {}
+      };
+    }
+  };
+}
+
+// src/react-router.tsx
+import { jsx } from "react/jsx-runtime";
+function createReactRouterDiagnosticsProvider(input, options = {}) {
+  return {
+    loaderAllowlist: options.loaderAllowlist,
+    getCurrentRoute() {
+      const value = input();
+      return {
+        pathname: value.location.pathname,
+        search: value.location.search,
+        hash: value.location.hash,
+        params: value.params,
+        matches: value.matches?.map((match) => ({
+          id: match.id,
+          path: match.pathname
+        }))
+      };
+    },
+    getNavigationState() {
+      const navigation = input().navigation;
+      return {
+        state: navigation?.state ?? "idle",
+        pendingPathname: navigation?.location?.pathname
+      };
+    },
+    getRouteContext() {
+      const value = input();
+      return {
+        loaderData: value.loaderData
+      };
+    }
+  };
+}
+function WebMcpReactRouterScope({
+  children,
+  useRouterState,
+  loaderAllowlist,
+  namespaceSegment
+}) {
+  const provider = useMemo(
+    () => createReactRouterDiagnosticsProvider(useRouterState, {
+      loaderAllowlist
+    }),
+    [useRouterState, loaderAllowlist]
+  );
+  const tools = useMemo(
+    () => [
+      createCurrentRouteTool(provider),
+      createNavigationStateTool(provider),
+      createRouteContextTool(provider)
+    ],
+    [provider]
+  );
+  return /* @__PURE__ */ jsx(WebMcpScope, { tools, source: "route", namespaceSegment, children });
+}
+
+// src/tanstack-router.tsx
+function createTanStackRouterDiagnosticsProvider(input, options = {}) {
+  return {
+    loaderAllowlist: options.loaderAllowlist,
+    getCurrentRoute() {
+      const value = input();
+      return {
+        pathname: value.location.pathname,
+        search: value.location.search,
+        hash: value.location.hash,
+        params: value.params,
+        matches: value.matches?.map((match) => ({
+          id: match.id,
+          path: match.pathname,
+          status: match.status
+        }))
+      };
+    },
+    getNavigationState() {
+      const navigation = input().navigation;
+      return {
+        state: navigation?.state ?? "idle",
+        pendingPathname: navigation?.location?.pathname
+      };
+    },
+    getRouteContext() {
+      return {
+        loaderData: input().loaderData
+      };
+    }
+  };
+}
+export {
+  WebMcpReactRouterScope,
+  createCurrentRouteTool,
+  createNavigationStateTool,
+  createNextClientRouterDiagnosticsProvider,
+  createReactRouterDiagnosticsProvider,
+  createRouteContextTool,
+  createTanStackRouterDiagnosticsProvider
+};

package/dist/next-client.d.ts

@@ -0,0 +1,18 @@
+import type { RouteDiagnosticsProvider } from './types';
+export interface NextClientRouterLikeInput {
+    pathname: string;
+    search?: string;
+    hash?: string;
+    params?: Record<string, string | undefined>;
+}
+export interface NextClientRouterDiagnosticsOptions {
+    loaderAllowlist?: string[] | undefined;
+}
+/**
+ * Client-only pathname/search adapter for Next.js App Router pages.
+ * Server Components are not observable from the browser runtime.
+ *
+ * @experimental
+ */
+export declare function createNextClientRouterDiagnosticsProvider(input: () => NextClientRouterLikeInput, options?: NextClientRouterDiagnosticsOptions): RouteDiagnosticsProvider;
+//# sourceMappingURL=next-client.d.ts.map

package/dist/next-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-client.d.ts","sourceRoot":"","sources":["../src/next-client.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,kCAAkC;IACjD,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,MAAM,yBAAyB,EACtC,OAAO,GAAE,kCAAuC,GAC/C,wBAAwB,CAgB1B"}

package/dist/next-client.js

@@ -0,0 +1,23 @@
+/**
+ * Client-only pathname/search adapter for Next.js App Router pages.
+ * Server Components are not observable from the browser runtime.
+ *
+ * @experimental
+ */
+export function createNextClientRouterDiagnosticsProvider(input, options = {}) {
+    return {
+        loaderAllowlist: options.loaderAllowlist,
+        getCurrentRoute() {
+            const value = input();
+            return {
+                pathname: value.pathname,
+                search: value.search,
+                hash: value.hash,
+                params: value.params,
+            };
+        },
+        getNavigationState() {
+            return { state: 'idle' };
+        },
+    };
+}

package/dist/react-router.d.ts

@@ -0,0 +1,36 @@
+import { type ReactNode } from 'react';
+import type { RouteDiagnosticsProvider } from './types';
+export interface ReactRouterLikeInput {
+    location: {
+        pathname: string;
+        search?: string;
+        hash?: string;
+    };
+    params?: Record<string, string | undefined>;
+    matches?: Array<{
+        id?: string;
+        pathname?: string;
+        handle?: unknown;
+    }>;
+    navigation?: {
+        state: string;
+        location?: {
+            pathname?: string;
+        };
+    };
+    loaderData?: unknown;
+}
+export interface ReactRouterDiagnosticsOptions {
+    loaderAllowlist?: string[] | undefined;
+}
+/** @experimental */
+export declare function createReactRouterDiagnosticsProvider(input: () => ReactRouterLikeInput, options?: ReactRouterDiagnosticsOptions): RouteDiagnosticsProvider;
+export interface WebMcpReactRouterScopeProps {
+    children: ReactNode;
+    useRouterState: () => ReactRouterLikeInput;
+    loaderAllowlist?: string[] | undefined;
+    namespaceSegment?: string | undefined;
+}
+/** @experimental */
+export declare function WebMcpReactRouterScope({ children, useRouterState, loaderAllowlist, namespaceSegment, }: WebMcpReactRouterScopeProps): import("react").JSX.Element;
+//# sourceMappingURL=react-router.d.ts.map

package/dist/react-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-router.d.ts","sourceRoot":"","sources":["../src/react-router.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAQhD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtE,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAClC,CAAC;IACF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,6BAA6B;IAC5C,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC;AAED,oBAAoB;AACpB,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,MAAM,oBAAoB,EACjC,OAAO,GAAE,6BAAkC,GAC1C,wBAAwB,CA8B1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,SAAS,CAAC;IACpB,cAAc,EAAE,MAAM,oBAAoB,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACvC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,oBAAoB;AACpB,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,EACR,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,EAAE,2BAA2B,+BAuB7B"}

package/dist/react-router.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { WebMcpScope } from '@tooluminati/react';
+import { createCurrentRouteTool, createNavigationStateTool, createRouteContextTool, } from './tools';
+/** @experimental */
+export function createReactRouterDiagnosticsProvider(input, options = {}) {
+    return {
+        loaderAllowlist: options.loaderAllowlist,
+        getCurrentRoute() {
+            const value = input();
+            return {
+                pathname: value.location.pathname,
+                search: value.location.search,
+                hash: value.location.hash,
+                params: value.params,
+                matches: value.matches?.map((match) => ({
+                    id: match.id,
+                    path: match.pathname,
+                })),
+            };
+        },
+        getNavigationState() {
+            const navigation = input().navigation;
+            return {
+                state: navigation?.state ?? 'idle',
+                pendingPathname: navigation?.location?.pathname,
+            };
+        },
+        getRouteContext() {
+            const value = input();
+            return {
+                loaderData: value.loaderData,
+            };
+        },
+    };
+}
+/** @experimental */
+export function WebMcpReactRouterScope({ children, useRouterState, loaderAllowlist, namespaceSegment, }) {
+    const provider = useMemo(() => createReactRouterDiagnosticsProvider(useRouterState, {
+        loaderAllowlist,
+    }), [useRouterState, loaderAllowlist]);
+    const tools = useMemo(() => [
+        createCurrentRouteTool(provider),
+        createNavigationStateTool(provider),
+        createRouteContextTool(provider),
+    ], [provider]);
+    return (_jsx(WebMcpScope, { tools: tools, source: "route", namespaceSegment: namespaceSegment, children: children }));
+}

package/dist/tanstack-router.d.ts

@@ -0,0 +1,27 @@
+import type { RouteDiagnosticsProvider } from './types';
+export interface TanStackRouterLikeInput {
+    location: {
+        pathname: string;
+        search?: string;
+        hash?: string;
+    };
+    params?: Record<string, string | undefined>;
+    matches?: Array<{
+        id?: string;
+        pathname?: string;
+        status?: string;
+    }>;
+    navigation?: {
+        state: string;
+        location?: {
+            pathname?: string;
+        };
+    };
+    loaderData?: unknown;
+}
+export interface TanStackRouterDiagnosticsOptions {
+    loaderAllowlist?: string[] | undefined;
+}
+/** @experimental */
+export declare function createTanStackRouterDiagnosticsProvider(input: () => TanStackRouterLikeInput, options?: TanStackRouterDiagnosticsOptions): RouteDiagnosticsProvider;
+//# sourceMappingURL=tanstack-router.d.ts.map

package/dist/tanstack-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-router.d.ts","sourceRoot":"","sources":["../src/tanstack-router.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAClC,CAAC;IACF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gCAAgC;IAC/C,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC;AAED,oBAAoB;AACpB,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,MAAM,uBAAuB,EACpC,OAAO,GAAE,gCAAqC,GAC7C,wBAAwB,CA8B1B"}

package/dist/tanstack-router.js

@@ -0,0 +1,32 @@
+/** @experimental */
+export function createTanStackRouterDiagnosticsProvider(input, options = {}) {
+    return {
+        loaderAllowlist: options.loaderAllowlist,
+        getCurrentRoute() {
+            const value = input();
+            return {
+                pathname: value.location.pathname,
+                search: value.location.search,
+                hash: value.location.hash,
+                params: value.params,
+                matches: value.matches?.map((match) => ({
+                    id: match.id,
+                    path: match.pathname,
+                    status: match.status,
+                })),
+            };
+        },
+        getNavigationState() {
+            const navigation = input().navigation;
+            return {
+                state: navigation?.state ?? 'idle',
+                pendingPathname: navigation?.location?.pathname,
+            };
+        },
+        getRouteContext() {
+            return {
+                loaderData: input().loaderData,
+            };
+        },
+    };
+}

package/dist/tools.d.ts

@@ -0,0 +1,6 @@
+import type { WebMcpToolDescriptor } from '@tooluminati/core';
+import type { NavigationSummary, RouteContextSummary, RouteDiagnosticsProvider, RouteSummary } from './types';
+export declare function createCurrentRouteTool(provider: RouteDiagnosticsProvider, name?: string): WebMcpToolDescriptor<Record<string, never>, RouteSummary>;
+export declare function createNavigationStateTool(provider: RouteDiagnosticsProvider, name?: string): WebMcpToolDescriptor<Record<string, never>, NavigationSummary>;
+export declare function createRouteContextTool(provider: RouteDiagnosticsProvider, name?: string): WebMcpToolDescriptor<Record<string, never>, RouteContextSummary>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,wBAAwB,EAClC,IAAI,SAAsB,GACzB,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,CAAC,CAa3D;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,wBAAwB,EAClC,IAAI,SAAyB,GAC5B,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,CAAC,CAgBhE;AAkBD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,wBAAwB,EAClC,IAAI,SAAsB,GACzB,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,mBAAmB,CAAC,CA2BlE"}

package/dist/tools.js

@@ -0,0 +1,60 @@
+export function createCurrentRouteTool(provider, name = 'get_current_route') {
+    return {
+        name,
+        description: 'Returns the current router-derived route, params, search, hash, and safe match summary.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: true },
+        execute: () => provider.getCurrentRoute(),
+    };
+}
+export function createNavigationStateTool(provider, name = 'get_navigation_state') {
+    return {
+        name,
+        description: 'Returns router navigation state, pending path, blockers, and safe blocker reasons.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: true },
+        execute: () => provider.getNavigationState?.() ?? {
+            state: 'idle',
+        },
+    };
+}
+function pickAllowlistedLoaderData(data, allowlist) {
+    if (!data || typeof data !== 'object' || !allowlist?.length) {
+        return undefined;
+    }
+    const record = data;
+    return Object.fromEntries(allowlist
+        .filter((key) => key in record)
+        .map((key) => [key, record[key]]));
+}
+export function createRouteContextTool(provider, name = 'get_route_context') {
+    return {
+        name,
+        description: 'Returns a redacted summary of current route loader/context state before any raw data.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: true },
+        execute: () => {
+            const context = provider.getRouteContext?.() ?? {};
+            const loaderData = pickAllowlistedLoaderData(context.loaderData, provider.loaderAllowlist);
+            return {
+                routeId: context.routeId,
+                loaderStatus: context.loaderStatus,
+                dataShape: context.dataShape,
+                safeLabels: context.safeLabels,
+                ...(loaderData !== undefined ? { loaderData } : {}),
+            };
+        },
+    };
+}

package/dist/types.d.ts

@@ -0,0 +1,32 @@
+export interface RouteSummary {
+    pathname: string;
+    search?: string | undefined;
+    hash?: string | undefined;
+    params?: Record<string, string | undefined> | undefined;
+    matches?: Array<{
+        id?: string | undefined;
+        path?: string | undefined;
+        status?: string | undefined;
+        label?: string | undefined;
+    }> | undefined;
+}
+export interface NavigationSummary {
+    state: 'idle' | 'loading' | 'submitting' | string;
+    pendingPathname?: string | undefined;
+    blocked?: boolean | undefined;
+    blockerReasons?: string[] | undefined;
+}
+export interface RouteContextSummary {
+    routeId?: string | undefined;
+    loaderStatus?: string | undefined;
+    dataShape?: unknown;
+    safeLabels?: string[] | undefined;
+    loaderData?: unknown;
+}
+export interface RouteDiagnosticsProvider {
+    getCurrentRoute(): RouteSummary;
+    getNavigationState?: () => NavigationSummary;
+    getRouteContext?: () => RouteContextSummary;
+    loaderAllowlist?: string[] | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IACxD,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC5B,CAAC,GAAG,SAAS,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC;IAClD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,IAAI,YAAY,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,iBAAiB,CAAC;IAC7C,eAAe,CAAC,EAAE,MAAM,mBAAmB,CAAC;IAC5C,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@tooluminati/router",
+  "version": "0.1.0",
+  "description": "Route and navigation diagnostics for Tooluminati.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "@tooluminati/react": "0.1.0",
+    "@tooluminati/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jitterbox/Tooluminati.git",
+    "directory": "packages/router"
+  },
+  "bugs": {
+    "url": "https://github.com/jitterbox/Tooluminati/issues"
+  },
+  "homepage": "https://github.com/jitterbox/Tooluminati#readme",
+  "keywords": [
+    "tooluminati",
+    "webmcp",
+    "react",
+    "router",
+    "react-router"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs && tsc -p tsconfig.json --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit"
+  }
+}