@tooluminati/state 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/apollo.d.ts

@@ -0,0 +1,14 @@
+import type { WebMcpToolDescriptor } from '@tooluminati/core';
+export interface ApolloQuerySummary {
+    name?: string;
+    networkStatus?: string | number;
+    loading?: boolean;
+    error?: string;
+}
+export declare function createApolloSummaryTool(options: {
+    getQueries: () => ApolloQuerySummary[];
+    name?: string;
+}): WebMcpToolDescriptor<Record<string, never>, {
+    queries: ApolloQuerySummary[];
+}>;
+//# sourceMappingURL=apollo.d.ts.map

package/dist/apollo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apollo.d.ts","sourceRoot":"","sources":["../src/apollo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,UAAU,EAAE,MAAM,kBAAkB,EAAE,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;IAAE,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC,CAajF"}

package/dist/apollo.js

@@ -0,0 +1,13 @@
+export function createApolloSummaryTool(options) {
+    return {
+        name: options.name ?? 'get_apollo_query_summary',
+        description: 'Returns allowlisted Apollo query loading, network, and error summaries.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: true },
+        execute: () => ({ queries: options.getQueries() }),
+    };
+}

package/dist/index.cjs

@@ -0,0 +1,195 @@
+"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, {
+  createApolloSummaryTool: () => createApolloSummaryTool,
+  createJotaiStateSummaryTool: () => createJotaiStateSummaryTool,
+  createQueryCacheSummaryTool: () => createQueryCacheSummaryTool,
+  createReduxStateSummaryTool: () => createReduxStateSummaryTool,
+  createStateSummaryTool: () => createStateSummaryTool,
+  createZustandStateSummaryTool: () => createZustandStateSummaryTool
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/apollo.ts
+function createApolloSummaryTool(options) {
+  return {
+    name: options.name ?? "get_apollo_query_summary",
+    description: "Returns allowlisted Apollo query loading, network, and error summaries.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: () => ({ queries: options.getQueries() })
+  };
+}
+
+// src/selector-tool.ts
+function createStateSummaryTool({
+  name,
+  description,
+  getState,
+  selector,
+  redact
+}) {
+  return {
+    name,
+    description,
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: () => {
+      const summary = selector(getState());
+      return redact ? redact(summary) : summary;
+    }
+  };
+}
+
+// src/jotai.ts
+function createJotaiStateSummaryTool(options) {
+  return createStateSummaryTool({
+    name: options.name ?? "get_jotai_state_summary",
+    description: options.description ?? "Returns an explicit summary from allowlisted Jotai atoms.",
+    getState: options.getSummary,
+    selector: (summary) => summary,
+    redact: options.redact
+  });
+}
+
+// src/redux-toolkit.ts
+var import_core = require("@tooluminati/core");
+function getPathValue(state, path) {
+  return path.split(".").reduce((current, segment) => {
+    if (current && typeof current === "object") {
+      return current[segment];
+    }
+    return void 0;
+  }, state);
+}
+function pickAllowlistedPaths(state, paths) {
+  return Object.fromEntries(
+    paths.map((path) => [path, getPathValue(state, path)])
+  );
+}
+function createReduxStateSummaryTool(options) {
+  const selector = options.pathAllowlist?.length ? (state) => pickAllowlistedPaths(state, options.pathAllowlist) : options.selector;
+  return createStateSummaryTool({
+    name: options.name ?? "get_redux_state_summary",
+    description: options.description ?? "Returns an explicit, redacted summary of allowlisted Redux state.",
+    getState: () => options.store.getState(),
+    selector,
+    redact: options.redact ?? ((summary) => (0, import_core.redactObject)(summary))
+  });
+}
+
+// src/tanstack-query.ts
+function summarizeShape(value) {
+  if (Array.isArray(value)) {
+    return { type: "array", length: value.length };
+  }
+  if (value && typeof value === "object") {
+    return {
+      type: "object",
+      keys: Object.keys(value).slice(0, 20)
+    };
+  }
+  return { type: typeof value };
+}
+function getRetryCount(query) {
+  const state = query.state;
+  return state.fetchFailureCount ?? state.failureCount;
+}
+function createQueryCacheSummaryTool({
+  queryClient,
+  allowKeys,
+  includeDataShape = true,
+  includeData = false,
+  redact,
+  name = "get_query_cache_summary"
+}) {
+  return {
+    name,
+    description: "Returns allowlisted query status, fetch state, stale state, errors, and data shape summaries.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: () => {
+      if (!allowKeys?.length) {
+        throw new Error(
+          "allowKeys is required for query cache summary tool. Provide an explicit allowlist of query keys."
+        );
+      }
+      if (includeData && !redact) {
+        throw new Error(
+          "redact is required when includeData is true for query cache summary tool."
+        );
+      }
+      const allowed = new Set(allowKeys.map((key) => JSON.stringify(key)));
+      const queries = queryClient.getQueryCache().findAll().filter((query) => allowed.has(JSON.stringify(query.queryKey))).map((query) => {
+        const summary = {
+          key: query.queryKey,
+          status: query.state.status,
+          fetchStatus: query.state.fetchStatus,
+          stale: query.isStale?.(),
+          updatedAt: query.state.dataUpdatedAt,
+          error: query.state.error ? query.state.error instanceof Error ? query.state.error.message : String(query.state.error) : void 0,
+          retryCount: getRetryCount(query)
+        };
+        if (includeDataShape) {
+          summary.dataShape = summarizeShape(query.state.data);
+        }
+        if (includeData && redact) {
+          summary.data = redact(query.state.data);
+        }
+        return summary;
+      });
+      return { queries };
+    }
+  };
+}
+
+// src/zustand.ts
+function createZustandStateSummaryTool(options) {
+  return createStateSummaryTool({
+    name: options.name ?? "get_zustand_state_summary",
+    description: options.description ?? "Returns an explicit summary from an allowlisted Zustand selector.",
+    getState: () => options.store.getState(),
+    selector: options.selector,
+    redact: options.redact
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createApolloSummaryTool,
+  createJotaiStateSummaryTool,
+  createQueryCacheSummaryTool,
+  createReduxStateSummaryTool,
+  createStateSummaryTool,
+  createZustandStateSummaryTool
+});

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @experimental Tooluminati state adapters — public APIs may change.
+ */
+export * from './apollo';
+export * from './jotai';
+export * from './redux-toolkit';
+export * from './selector-tool';
+export * from './tanstack-query';
+export * from './types';
+export * from './zustand';
+//# 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;;GAEG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,163 @@
+// src/apollo.ts
+function createApolloSummaryTool(options) {
+  return {
+    name: options.name ?? "get_apollo_query_summary",
+    description: "Returns allowlisted Apollo query loading, network, and error summaries.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: () => ({ queries: options.getQueries() })
+  };
+}
+
+// src/selector-tool.ts
+function createStateSummaryTool({
+  name,
+  description,
+  getState,
+  selector,
+  redact
+}) {
+  return {
+    name,
+    description,
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: () => {
+      const summary = selector(getState());
+      return redact ? redact(summary) : summary;
+    }
+  };
+}
+
+// src/jotai.ts
+function createJotaiStateSummaryTool(options) {
+  return createStateSummaryTool({
+    name: options.name ?? "get_jotai_state_summary",
+    description: options.description ?? "Returns an explicit summary from allowlisted Jotai atoms.",
+    getState: options.getSummary,
+    selector: (summary) => summary,
+    redact: options.redact
+  });
+}
+
+// src/redux-toolkit.ts
+import { redactObject } from "@tooluminati/core";
+function getPathValue(state, path) {
+  return path.split(".").reduce((current, segment) => {
+    if (current && typeof current === "object") {
+      return current[segment];
+    }
+    return void 0;
+  }, state);
+}
+function pickAllowlistedPaths(state, paths) {
+  return Object.fromEntries(
+    paths.map((path) => [path, getPathValue(state, path)])
+  );
+}
+function createReduxStateSummaryTool(options) {
+  const selector = options.pathAllowlist?.length ? (state) => pickAllowlistedPaths(state, options.pathAllowlist) : options.selector;
+  return createStateSummaryTool({
+    name: options.name ?? "get_redux_state_summary",
+    description: options.description ?? "Returns an explicit, redacted summary of allowlisted Redux state.",
+    getState: () => options.store.getState(),
+    selector,
+    redact: options.redact ?? ((summary) => redactObject(summary))
+  });
+}
+
+// src/tanstack-query.ts
+function summarizeShape(value) {
+  if (Array.isArray(value)) {
+    return { type: "array", length: value.length };
+  }
+  if (value && typeof value === "object") {
+    return {
+      type: "object",
+      keys: Object.keys(value).slice(0, 20)
+    };
+  }
+  return { type: typeof value };
+}
+function getRetryCount(query) {
+  const state = query.state;
+  return state.fetchFailureCount ?? state.failureCount;
+}
+function createQueryCacheSummaryTool({
+  queryClient,
+  allowKeys,
+  includeDataShape = true,
+  includeData = false,
+  redact,
+  name = "get_query_cache_summary"
+}) {
+  return {
+    name,
+    description: "Returns allowlisted query status, fetch state, stale state, errors, and data shape summaries.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: true },
+    execute: () => {
+      if (!allowKeys?.length) {
+        throw new Error(
+          "allowKeys is required for query cache summary tool. Provide an explicit allowlist of query keys."
+        );
+      }
+      if (includeData && !redact) {
+        throw new Error(
+          "redact is required when includeData is true for query cache summary tool."
+        );
+      }
+      const allowed = new Set(allowKeys.map((key) => JSON.stringify(key)));
+      const queries = queryClient.getQueryCache().findAll().filter((query) => allowed.has(JSON.stringify(query.queryKey))).map((query) => {
+        const summary = {
+          key: query.queryKey,
+          status: query.state.status,
+          fetchStatus: query.state.fetchStatus,
+          stale: query.isStale?.(),
+          updatedAt: query.state.dataUpdatedAt,
+          error: query.state.error ? query.state.error instanceof Error ? query.state.error.message : String(query.state.error) : void 0,
+          retryCount: getRetryCount(query)
+        };
+        if (includeDataShape) {
+          summary.dataShape = summarizeShape(query.state.data);
+        }
+        if (includeData && redact) {
+          summary.data = redact(query.state.data);
+        }
+        return summary;
+      });
+      return { queries };
+    }
+  };
+}
+
+// src/zustand.ts
+function createZustandStateSummaryTool(options) {
+  return createStateSummaryTool({
+    name: options.name ?? "get_zustand_state_summary",
+    description: options.description ?? "Returns an explicit summary from an allowlisted Zustand selector.",
+    getState: () => options.store.getState(),
+    selector: options.selector,
+    redact: options.redact
+  });
+}
+export {
+  createApolloSummaryTool,
+  createJotaiStateSummaryTool,
+  createQueryCacheSummaryTool,
+  createReduxStateSummaryTool,
+  createStateSummaryTool,
+  createZustandStateSummaryTool
+};

package/dist/jotai.d.ts

@@ -0,0 +1,7 @@
+export declare function createJotaiStateSummaryTool<TSummary>(options: {
+    getSummary: () => TSummary;
+    name?: string;
+    description?: string;
+    redact?: (summary: TSummary) => unknown;
+}): import("@tooluminati/core").WebMcpToolDescriptor<Record<string, never>, unknown>;
+//# sourceMappingURL=jotai.d.ts.map

package/dist/jotai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jotai.d.ts","sourceRoot":"","sources":["../src/jotai.ts"],"names":[],"mappings":"AAEA,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,OAAO,EAAE;IAC7D,UAAU,EAAE,MAAM,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC;CACzC,oFAUA"}

package/dist/jotai.js

@@ -0,0 +1,11 @@
+import { createStateSummaryTool } from './selector-tool';
+export function createJotaiStateSummaryTool(options) {
+    return createStateSummaryTool({
+        name: options.name ?? 'get_jotai_state_summary',
+        description: options.description ??
+            'Returns an explicit summary from allowlisted Jotai atoms.',
+        getState: options.getSummary,
+        selector: (summary) => summary,
+        redact: options.redact,
+    });
+}

package/dist/redux-toolkit.d.ts

@@ -0,0 +1,13 @@
+export interface ReduxStoreLike<TState> {
+    getState(): TState;
+}
+/** @experimental */
+export declare function createReduxStateSummaryTool<TState, TSummary>(options: {
+    store: ReduxStoreLike<TState>;
+    selector: (state: TState) => TSummary;
+    name?: string;
+    description?: string;
+    redact?: (summary: TSummary) => unknown;
+    pathAllowlist?: string[];
+}): import("@tooluminati/core").WebMcpToolDescriptor<Record<string, never>, unknown>;
+//# sourceMappingURL=redux-toolkit.d.ts.map

package/dist/redux-toolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redux-toolkit.d.ts","sourceRoot":"","sources":["../src/redux-toolkit.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc,CAAC,MAAM;IACpC,QAAQ,IAAI,MAAM,CAAC;CACpB;AAqBD,oBAAoB;AACpB,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE;IACrE,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,oFAeA"}

package/dist/redux-toolkit.js

@@ -0,0 +1,27 @@
+import { redactObject } from '@tooluminati/core';
+import { createStateSummaryTool } from './selector-tool';
+function getPathValue(state, path) {
+    return path.split('.').reduce((current, segment) => {
+        if (current && typeof current === 'object') {
+            return current[segment];
+        }
+        return undefined;
+    }, state);
+}
+function pickAllowlistedPaths(state, paths) {
+    return Object.fromEntries(paths.map((path) => [path, getPathValue(state, path)]));
+}
+/** @experimental */
+export function createReduxStateSummaryTool(options) {
+    const selector = options.pathAllowlist?.length
+        ? (state) => pickAllowlistedPaths(state, options.pathAllowlist)
+        : options.selector;
+    return createStateSummaryTool({
+        name: options.name ?? 'get_redux_state_summary',
+        description: options.description ??
+            'Returns an explicit, redacted summary of allowlisted Redux state.',
+        getState: () => options.store.getState(),
+        selector,
+        redact: options.redact ?? ((summary) => redactObject(summary)),
+    });
+}

package/dist/selector-tool.d.ts

@@ -0,0 +1,4 @@
+import type { WebMcpToolDescriptor } from '@tooluminati/core';
+import type { StateSummaryToolOptions } from './types';
+export declare function createStateSummaryTool<TState, TSummary>({ name, description, getState, selector, redact, }: StateSummaryToolOptions<TState, TSummary>): WebMcpToolDescriptor<Record<string, never>, unknown>;
+//# sourceMappingURL=selector-tool.d.ts.map

package/dist/selector-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-tool.d.ts","sourceRoot":"","sources":["../src/selector-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,EACvD,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,MAAM,GACP,EAAE,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,oBAAoB,CACjE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACrB,OAAO,CACR,CAeA"}

package/dist/selector-tool.js

@@ -0,0 +1,16 @@
+export function createStateSummaryTool({ name, description, getState, selector, redact, }) {
+    return {
+        name,
+        description,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: true },
+        execute: () => {
+            const summary = selector(getState());
+            return redact ? redact(summary) : summary;
+        },
+    };
+}

package/dist/tanstack-query.d.ts

@@ -0,0 +1,33 @@
+import type { WebMcpToolDescriptor } from '@tooluminati/core';
+import type { QuerySummary } from './types';
+export interface QueryLike {
+    queryKey: unknown;
+    state: {
+        status?: string;
+        fetchStatus?: string;
+        dataUpdatedAt?: number;
+        error?: unknown;
+        data?: unknown;
+        fetchFailureCount?: number;
+        failureCount?: number;
+    };
+    isStale?: () => boolean;
+}
+export interface QueryClientLike {
+    getQueryCache(): {
+        findAll(): QueryLike[];
+    };
+}
+export interface QueryCacheSummaryOptions {
+    queryClient: QueryClientLike;
+    allowKeys: unknown[];
+    includeDataShape?: boolean;
+    includeData?: boolean;
+    redact?: (data: unknown) => unknown;
+    name?: string;
+}
+/** @experimental */
+export declare function createQueryCacheSummaryTool({ queryClient, allowKeys, includeDataShape, includeData, redact, name, }: QueryCacheSummaryOptions): WebMcpToolDescriptor<Record<string, never>, {
+    queries: QuerySummary[];
+}>;
+//# sourceMappingURL=tanstack-query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-query.d.ts","sourceRoot":"","sources":["../src/tanstack-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,IAAI;QACf,OAAO,IAAI,SAAS,EAAE,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,eAAe,CAAC;IAC7B,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAsBD,oBAAoB;AACpB,wBAAgB,2BAA2B,CAAC,EAC1C,WAAW,EACX,SAAS,EACT,gBAAuB,EACvB,WAAmB,EACnB,MAAM,EACN,IAAgC,GACjC,EAAE,wBAAwB,GAAG,oBAAoB,CAChD,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACrB;IAAE,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,CAC5B,CA2DA"}

package/dist/tanstack-query.js

@@ -0,0 +1,66 @@
+function summarizeShape(value) {
+    if (Array.isArray(value)) {
+        return { type: 'array', length: value.length };
+    }
+    if (value && typeof value === 'object') {
+        return {
+            type: 'object',
+            keys: Object.keys(value).slice(0, 20),
+        };
+    }
+    return { type: typeof value };
+}
+function getRetryCount(query) {
+    const state = query.state;
+    return state.fetchFailureCount ?? state.failureCount;
+}
+/** @experimental */
+export function createQueryCacheSummaryTool({ queryClient, allowKeys, includeDataShape = true, includeData = false, redact, name = 'get_query_cache_summary', }) {
+    return {
+        name,
+        description: 'Returns allowlisted query status, fetch state, stale state, errors, and data shape summaries.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: true },
+        execute: () => {
+            if (!allowKeys?.length) {
+                throw new Error('allowKeys is required for query cache summary tool. ' +
+                    'Provide an explicit allowlist of query keys.');
+            }
+            if (includeData && !redact) {
+                throw new Error('redact is required when includeData is true for query cache summary tool.');
+            }
+            const allowed = new Set(allowKeys.map((key) => JSON.stringify(key)));
+            const queries = queryClient
+                .getQueryCache()
+                .findAll()
+                .filter((query) => allowed.has(JSON.stringify(query.queryKey)))
+                .map((query) => {
+                const summary = {
+                    key: query.queryKey,
+                    status: query.state.status,
+                    fetchStatus: query.state.fetchStatus,
+                    stale: query.isStale?.(),
+                    updatedAt: query.state.dataUpdatedAt,
+                    error: query.state.error
+                        ? query.state.error instanceof Error
+                            ? query.state.error.message
+                            : String(query.state.error)
+                        : undefined,
+                    retryCount: getRetryCount(query),
+                };
+                if (includeDataShape) {
+                    summary.dataShape = summarizeShape(query.state.data);
+                }
+                if (includeData && redact) {
+                    summary.data = redact(query.state.data);
+                }
+                return summary;
+            });
+            return { queries };
+        },
+    };
+}

package/dist/tanstack-query.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tanstack-query.test.d.ts.map

package/dist/tanstack-query.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-query.test.d.ts","sourceRoot":"","sources":["../src/tanstack-query.test.ts"],"names":[],"mappings":""}

package/dist/tanstack-query.test.js

@@ -0,0 +1,64 @@
+import { describe, expect, it } from 'vitest';
+import { redactObject } from '@tooluminati/core';
+import { createQueryCacheSummaryTool } from './tanstack-query';
+describe('createQueryCacheSummaryTool security', () => {
+    const queryClient = {
+        getQueryCache: () => ({
+            findAll: () => [
+                {
+                    queryKey: ['users'],
+                    state: {
+                        status: 'success',
+                        data: { token: 'secret', name: 'Ada' },
+                    },
+                },
+                {
+                    queryKey: ['posts'],
+                    state: {
+                        status: 'success',
+                        data: { title: 'Hello' },
+                    },
+                },
+            ],
+        }),
+    };
+    it('throws when allowKeys is omitted or empty', () => {
+        const tool = createQueryCacheSummaryTool({
+            queryClient,
+            allowKeys: [],
+        });
+        expect(() => tool.execute({}, {})).toThrow(/allowKeys is required/);
+    });
+    it('does not dump the full cache without explicit allowKeys', () => {
+        const tool = createQueryCacheSummaryTool({
+            queryClient,
+            allowKeys: [['users']],
+        });
+        const result = tool.execute({}, {});
+        expect(result.queries).toHaveLength(1);
+        expect(result.queries[0]?.key).toEqual(['users']);
+        expect(result.queries[0]?.data).toBeUndefined();
+    });
+    it('requires redact when includeData is true', () => {
+        const tool = createQueryCacheSummaryTool({
+            queryClient,
+            allowKeys: [['users']],
+            includeData: true,
+        });
+        expect(() => tool.execute({}, {})).toThrow(/redact is required/);
+    });
+    it('returns redacted data only for allowlisted keys', () => {
+        const tool = createQueryCacheSummaryTool({
+            queryClient,
+            allowKeys: [['users']],
+            includeData: true,
+            includeDataShape: false,
+            redact: (data) => redactObject(data),
+        });
+        const result = tool.execute({}, {});
+        expect(result.queries[0]?.data).toEqual({
+            token: '[REDACTED]',
+            name: 'Ada',
+        });
+    });
+});

package/dist/types.d.ts

@@ -0,0 +1,19 @@
+export interface StateSummaryToolOptions<TState, TSummary> {
+    name: string;
+    description: string;
+    getState: () => TState;
+    selector: (state: TState) => TSummary;
+    redact?: ((summary: TSummary) => unknown) | undefined;
+}
+export interface QuerySummary {
+    key: unknown;
+    status?: string | undefined;
+    fetchStatus?: string | undefined;
+    stale?: boolean | undefined;
+    updatedAt?: number | undefined;
+    error?: string | undefined;
+    retryCount?: number | undefined;
+    dataShape?: unknown;
+    data?: unknown;
+}
+//# 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,uBAAuB,CAAC,MAAM,EAAE,QAAQ;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC;IACtC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;CACvD;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB"}

package/dist/types.js

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

package/dist/zustand.d.ts

@@ -0,0 +1,11 @@
+export interface ZustandStoreLike<TState> {
+    getState(): TState;
+}
+export declare function createZustandStateSummaryTool<TState, TSummary>(options: {
+    store: ZustandStoreLike<TState>;
+    selector: (state: TState) => TSummary;
+    name?: string;
+    description?: string;
+    redact?: (summary: TSummary) => unknown;
+}): import("@tooluminati/core").WebMcpToolDescriptor<Record<string, never>, unknown>;
+//# sourceMappingURL=zustand.d.ts.map

package/dist/zustand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zustand.d.ts","sourceRoot":"","sources":["../src/zustand.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB,CAAC,MAAM;IACtC,QAAQ,IAAI,MAAM,CAAC;CACpB;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE;IACvE,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC;CACzC,oFAUA"}

package/dist/zustand.js

@@ -0,0 +1,11 @@
+import { createStateSummaryTool } from './selector-tool';
+export function createZustandStateSummaryTool(options) {
+    return createStateSummaryTool({
+        name: options.name ?? 'get_zustand_state_summary',
+        description: options.description ??
+            'Returns an explicit summary from an allowlisted Zustand selector.',
+        getState: () => options.store.getState(),
+        selector: options.selector,
+        redact: options.redact,
+    });
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@tooluminati/state",
+  "version": "0.1.0",
+  "description": "Safe state and data-cache summaries 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/core": "0.1.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jitterbox/Tooluminati.git",
+    "directory": "packages/state"
+  },
+  "bugs": {
+    "url": "https://github.com/jitterbox/Tooluminati/issues"
+  },
+  "homepage": "https://github.com/jitterbox/Tooluminati#readme",
+  "keywords": [
+    "tooluminati",
+    "webmcp",
+    "react",
+    "redux",
+    "tanstack-query"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs && tsc -p tsconfig.json --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit"
+  }
+}