@frontmcp/react 0.0.1

package/state/adapters/createStore.d.ts

@@ -0,0 +1,15 @@
+/**
+ * createStore — generic pass-through adapter factory for any custom store.
+ *
+ * Accepts a StoreAdapter-compatible object directly.
+ */
+import type { StoreAdapter } from '../../types';
+export interface CreateStoreOptions {
+    name: string;
+    getState: () => unknown;
+    subscribe: (cb: () => void) => () => void;
+    selectors?: Record<string, (state: unknown) => unknown>;
+    actions?: Record<string, (...args: unknown[]) => unknown>;
+}
+export declare function createStore(options: CreateStoreOptions): StoreAdapter;
+//# sourceMappingURL=createStore.d.ts.map

package/state/adapters/createStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStore.d.ts","sourceRoot":"","sources":["../../../src/state/adapters/createStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;CAC3D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY,CAQrE"}

package/state/adapters/index.d.ts

@@ -0,0 +1,7 @@
+export { reduxStore } from './reduxAdapter';
+export type { ReduxStoreOptions } from './reduxAdapter';
+export { valtioStore } from './valtioAdapter';
+export type { ValtioStoreOptions } from './valtioAdapter';
+export { createStore } from './createStore';
+export type { CreateStoreOptions } from './createStore';
+//# sourceMappingURL=index.d.ts.map

package/state/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/state/adapters/reduxAdapter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * reduxStore — adapter factory that normalizes a Redux store to the
+ * common StoreAdapter interface for provider-level registration.
+ */
+import type { StoreAdapter } from '../../types';
+export interface ReduxStoreOptions {
+    /** Redux store instance. */
+    store: {
+        getState(): unknown;
+        dispatch(action: unknown): unknown;
+        subscribe(fn: () => void): () => void;
+    };
+    /** Logical name (defaults to 'redux'). */
+    name?: string;
+    /** Named selectors — each becomes a sub-resource. */
+    selectors?: Record<string, (state: unknown) => unknown>;
+    /** Named action creators — each becomes a dynamic tool that auto-dispatches. */
+    actions?: Record<string, (...args: unknown[]) => unknown>;
+}
+export declare function reduxStore(options: ReduxStoreOptions): StoreAdapter;
+//# sourceMappingURL=reduxAdapter.d.ts.map

package/state/adapters/reduxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reduxAdapter.d.ts","sourceRoot":"","sources":["../../../src/state/adapters/reduxAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,KAAK,EAAE;QACL,QAAQ,IAAI,OAAO,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;QACnC,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;KACvC,CAAC;IACF,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;IACxD,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;CAC3D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY,CAsBnE"}

package/state/adapters/valtioAdapter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * valtioStore — adapter factory that normalizes a Valtio proxy to the
+ * common StoreAdapter interface for provider-level registration.
+ */
+import type { StoreAdapter } from '../../types';
+export interface ValtioStoreOptions {
+    /** Valtio proxy object. */
+    proxy: Record<string, unknown>;
+    /** User-provided subscribe function from valtio/utils. */
+    subscribe: (proxy: Record<string, unknown>, cb: () => void) => () => void;
+    /** Logical name (defaults to 'valtio'). */
+    name?: string;
+    /** Named deep path selectors (dot notation, e.g., 'user.name'). */
+    paths?: Record<string, string>;
+    /** Named mutations — each becomes a dynamic tool. */
+    mutations?: Record<string, (...args: unknown[]) => void>;
+}
+export declare function valtioStore(options: ValtioStoreOptions): StoreAdapter;
+//# sourceMappingURL=valtioAdapter.d.ts.map

package/state/adapters/valtioAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valtioAdapter.d.ts","sourceRoot":"","sources":["../../../src/state/adapters/valtioAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,0DAA0D;IAC1D,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAC1E,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;CAC1D;AAYD,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY,CA4BrE"}

package/state/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @frontmcp/react/state — State management integration for FrontMCP.
+ *
+ * Exposes Redux, Valtio, or any store as MCP resources (with deep selectors)
+ * and actions as MCP tools that agents can invoke.
+ *
+ * @packageDocumentation
+ */
+export { useStoreResource } from './useStoreResource';
+export { useReduxResource } from './useReduxResource';
+export { useValtioResource } from './useValtioResource';
+export type { StoreResourceOptions, ReduxResourceOptions, ValtioResourceOptions } from './state.types';
+export { reduxStore, valtioStore, createStore } from './adapters';
+export type { ReduxStoreOptions, ValtioStoreOptions, CreateStoreOptions } from './adapters';
+//# sourceMappingURL=index.d.ts.map

package/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACvG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/state/index.js

@@ -0,0 +1,473 @@
+"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/state/index.ts
+var state_exports = {};
+__export(state_exports, {
+  createStore: () => createStore,
+  reduxStore: () => reduxStore,
+  useReduxResource: () => useReduxResource,
+  useStoreResource: () => useStoreResource,
+  useValtioResource: () => useValtioResource,
+  valtioStore: () => valtioStore
+});
+module.exports = __toCommonJS(state_exports);
+
+// libs/react/src/state/useStoreResource.ts
+var import_react2 = require("react");
+
+// libs/react/src/provider/FrontMcpContext.ts
+var import_react = require("react");
+
+// libs/react/src/components/ComponentRegistry.ts
+var ComponentRegistry = class {
+  entries = /* @__PURE__ */ new Map();
+  register(uri, component, meta) {
+    const name = extractName(uri);
+    this.entries.set(uri, { uri, name, component, description: meta?.description });
+  }
+  registerAll(map) {
+    for (const [uri, component] of Object.entries(map)) {
+      this.register(uri, component);
+    }
+  }
+  get(uri) {
+    return this.entries.get(uri)?.component;
+  }
+  /**
+   * Resolve a shorthand name like `'UserCard'` by trying
+   * `component://UserCard`, `element://UserCard`, `page://UserCard`.
+   */
+  resolve(type) {
+    const exact = this.entries.get(type);
+    if (exact) return exact.component;
+    for (const protocol of ["component://", "element://", "page://"]) {
+      const entry = this.entries.get(`${protocol}${type}`);
+      if (entry) return entry.component;
+    }
+    return void 0;
+  }
+  has(uri) {
+    return this.entries.has(uri);
+  }
+  list() {
+    return Array.from(this.entries.values()).map(({ uri, name, description }) => ({
+      uri,
+      name,
+      description
+    }));
+  }
+  clear() {
+    this.entries.clear();
+  }
+};
+function extractName(uri) {
+  const idx = uri.indexOf("://");
+  return idx >= 0 ? uri.slice(idx + 3) : uri;
+}
+
+// libs/react/src/registry/DynamicRegistry.ts
+var DynamicRegistry = class {
+  tools = /* @__PURE__ */ new Map();
+  resources = /* @__PURE__ */ new Map();
+  toolRefCounts = /* @__PURE__ */ new Map();
+  resourceRefCounts = /* @__PURE__ */ new Map();
+  listeners = /* @__PURE__ */ new Set();
+  version = 0;
+  /**
+   * 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) {
+    const existing = this.toolRefCounts.get(def.name) ?? 0;
+    this.toolRefCounts.set(def.name, existing + 1);
+    this.tools.set(def.name, def);
+    if (existing === 0) {
+      this.notify();
+    }
+    let called = false;
+    return () => {
+      if (called) return;
+      called = true;
+      this.unregisterTool(def.name);
+    };
+  }
+  unregisterTool(name) {
+    const count = this.toolRefCounts.get(name);
+    if (count == null) return;
+    if (count <= 1) {
+      this.toolRefCounts.delete(name);
+      this.tools.delete(name);
+      this.notify();
+    } else {
+      this.toolRefCounts.set(name, count - 1);
+    }
+  }
+  /**
+   * Register a dynamic resource. Returns an unregister function
+   * suitable for useEffect cleanup.
+   *
+   * Multiple registrations of the same URI are ref-counted.
+   */
+  registerResource(def) {
+    const existing = this.resourceRefCounts.get(def.uri) ?? 0;
+    this.resourceRefCounts.set(def.uri, existing + 1);
+    this.resources.set(def.uri, def);
+    if (existing === 0) {
+      this.notify();
+    }
+    let called = false;
+    return () => {
+      if (called) return;
+      called = true;
+      this.unregisterResource(def.uri);
+    };
+  }
+  unregisterResource(uri) {
+    const count = this.resourceRefCounts.get(uri);
+    if (count == null) return;
+    if (count <= 1) {
+      this.resourceRefCounts.delete(uri);
+      this.resources.delete(uri);
+      this.notify();
+    } else {
+      this.resourceRefCounts.set(uri, count - 1);
+    }
+  }
+  /** Update the execute function for an existing tool (for stale closure prevention). */
+  updateToolExecute(name, execute) {
+    const existing = this.tools.get(name);
+    if (existing) {
+      existing.execute = execute;
+    }
+  }
+  /** Update the read function for an existing resource and notify subscribers. */
+  updateResourceRead(uri, read) {
+    const existing = this.resources.get(uri);
+    if (existing) {
+      existing.read = read;
+      this.notify();
+    }
+  }
+  getTools() {
+    return [...this.tools.values()];
+  }
+  getResources() {
+    return [...this.resources.values()];
+  }
+  findTool(name) {
+    return this.tools.get(name);
+  }
+  findResource(uri) {
+    return this.resources.get(uri);
+  }
+  hasTool(name) {
+    return this.tools.has(name);
+  }
+  hasResource(uri) {
+    return this.resources.has(uri);
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  getVersion() {
+    return this.version;
+  }
+  clear() {
+    if (this.tools.size === 0 && this.resources.size === 0) return;
+    this.tools.clear();
+    this.resources.clear();
+    this.toolRefCounts.clear();
+    this.resourceRefCounts.clear();
+    this.notify();
+  }
+  notify() {
+    this.version++;
+    this.listeners.forEach((l) => {
+      l();
+    });
+  }
+};
+
+// libs/react/src/provider/FrontMcpContext.ts
+var defaultDynamicRegistry = new DynamicRegistry();
+var FrontMcpContext = (0, import_react.createContext)({
+  name: "default",
+  registry: new ComponentRegistry(),
+  dynamicRegistry: defaultDynamicRegistry,
+  getDynamicRegistry: () => defaultDynamicRegistry,
+  connect: async () => {
+  }
+});
+
+// libs/react/src/state/useStoreResource.ts
+var VALID_NAME_RE = /^[a-zA-Z0-9_-]+$/;
+function useStoreResource(options) {
+  const { name, getState, subscribe, selectors, actions } = options;
+  const { getDynamicRegistry } = (0, import_react2.useContext)(FrontMcpContext);
+  const dynamicRegistry = getDynamicRegistry(options.server);
+  if (!name || !VALID_NAME_RE.test(name)) {
+    throw new Error(`useStoreResource: invalid store name "${name}". Names must match ${VALID_NAME_RE}.`);
+  }
+  const getStateRef = (0, import_react2.useRef)(getState);
+  getStateRef.current = getState;
+  const readState = (0, import_react2.useCallback)(
+    async () => ({
+      contents: [
+        {
+          uri: `state://${name}`,
+          mimeType: "application/json",
+          text: JSON.stringify(getStateRef.current() ?? null)
+        }
+      ]
+    }),
+    [name]
+  );
+  (0, import_react2.useEffect)(() => {
+    const unregister = dynamicRegistry.registerResource({
+      uri: `state://${name}`,
+      name: `${name}-state`,
+      description: `Full state of ${name} store`,
+      mimeType: "application/json",
+      read: readState
+    });
+    const unsubscribe = subscribe(() => {
+      dynamicRegistry.updateResourceRead(`state://${name}`, readState);
+    });
+    return () => {
+      unregister();
+      unsubscribe();
+    };
+  }, [dynamicRegistry, name, subscribe, readState]);
+  (0, import_react2.useEffect)(() => {
+    if (!selectors) return;
+    const cleanups = [];
+    const selectorUris = [];
+    for (const [key, selector] of Object.entries(selectors)) {
+      if (!key || !VALID_NAME_RE.test(key)) {
+        throw new Error(`useStoreResource: invalid selector key "${key}". Keys must match ${VALID_NAME_RE}.`);
+      }
+      const uri = `state://${name}/${key}`;
+      const selectorRef = { current: selector };
+      const readSelector = async () => ({
+        contents: [
+          {
+            uri,
+            mimeType: "application/json",
+            text: JSON.stringify(selectorRef.current(getStateRef.current()) ?? null)
+          }
+        ]
+      });
+      selectorUris.push({ uri, readSelector });
+      cleanups.push(
+        dynamicRegistry.registerResource({
+          uri,
+          name: `${name}-${key}`,
+          description: `Selector "${key}" from ${name} store`,
+          mimeType: "application/json",
+          read: readSelector
+        })
+      );
+    }
+    const unsubscribe = subscribe(() => {
+      for (const { uri, readSelector } of selectorUris) {
+        dynamicRegistry.updateResourceRead(uri, readSelector);
+      }
+    });
+    cleanups.push(unsubscribe);
+    return () => {
+      cleanups.forEach((fn) => {
+        fn();
+      });
+    };
+  }, [dynamicRegistry, name, selectors, subscribe]);
+  (0, import_react2.useEffect)(() => {
+    if (!actions) return;
+    const cleanups = [];
+    for (const [key, action] of Object.entries(actions)) {
+      const toolName = `${name}_${key}`;
+      const execute = async (args) => {
+        const argsArray = args["args"];
+        const result = await (Array.isArray(argsArray) ? action(...argsArray) : action(args));
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true, result }) }]
+        };
+      };
+      cleanups.push(
+        dynamicRegistry.registerTool({
+          name: toolName,
+          description: `Action "${key}" on ${name} store`,
+          inputSchema: {
+            type: "object",
+            properties: {
+              args: { type: "array", description: "Arguments to pass to the action" }
+            }
+          },
+          execute
+        })
+      );
+    }
+    return () => {
+      cleanups.forEach((fn) => {
+        fn();
+      });
+    };
+  }, [dynamicRegistry, name, actions]);
+}
+
+// libs/react/src/state/useReduxResource.ts
+var import_react3 = require("react");
+function useReduxResource(options) {
+  const { store, name = "redux", selectors, actions, server } = options;
+  const wrappedActions = (0, import_react3.useMemo)(() => {
+    if (!actions) return void 0;
+    const wrapped = {};
+    for (const [key, actionCreator] of Object.entries(actions)) {
+      wrapped[key] = (...args) => {
+        const action = actionCreator(...args);
+        return store.dispatch(action);
+      };
+    }
+    return wrapped;
+  }, [actions, store]);
+  useStoreResource({
+    name,
+    getState: store.getState.bind(store),
+    subscribe: store.subscribe.bind(store),
+    selectors,
+    actions: wrappedActions,
+    server
+  });
+}
+
+// libs/react/src/state/useValtioResource.ts
+var import_react4 = require("react");
+function getByPath(obj, path) {
+  const parts = path.split(".");
+  let current = obj;
+  for (const part of parts) {
+    if (current == null || typeof current !== "object") return void 0;
+    current = current[part];
+  }
+  return current;
+}
+function useValtioResource(options) {
+  const { proxy, subscribe: valtioSubscribe, name = "valtio", paths, mutations, server } = options;
+  const selectors = (0, import_react4.useMemo)(() => {
+    if (!paths) return void 0;
+    const sels = {};
+    for (const [key, path] of Object.entries(paths)) {
+      sels[key] = (state) => getByPath(state, path);
+    }
+    return sels;
+  }, [paths]);
+  const subscribe = (0, import_react4.useMemo)(() => (cb) => valtioSubscribe(proxy, cb), [proxy, valtioSubscribe]);
+  const actions = (0, import_react4.useMemo)(() => {
+    if (!mutations) return void 0;
+    const wrapped = {};
+    for (const [key, mutation] of Object.entries(mutations)) {
+      wrapped[key] = (...args) => mutation(...args);
+    }
+    return wrapped;
+  }, [mutations]);
+  const getState = (0, import_react4.useMemo)(() => () => JSON.parse(JSON.stringify(proxy)), [proxy]);
+  useStoreResource({
+    name,
+    getState,
+    subscribe,
+    selectors,
+    actions,
+    server
+  });
+}
+
+// libs/react/src/state/adapters/reduxAdapter.ts
+function reduxStore(options) {
+  const { store, name = "redux", selectors, actions: rawActions } = options;
+  let actions;
+  if (rawActions) {
+    actions = {};
+    for (const [key, actionCreator] of Object.entries(rawActions)) {
+      actions[key] = (...args) => {
+        const action = actionCreator(...args);
+        return store.dispatch(action);
+      };
+    }
+  }
+  return {
+    name,
+    getState: store.getState.bind(store),
+    subscribe: store.subscribe.bind(store),
+    selectors,
+    actions
+  };
+}
+
+// libs/react/src/state/adapters/valtioAdapter.ts
+function getByPath2(obj, path) {
+  const parts = path.split(".");
+  let current = obj;
+  for (const part of parts) {
+    if (current == null || typeof current !== "object") return void 0;
+    current = current[part];
+  }
+  return current;
+}
+function valtioStore(options) {
+  const { proxy, subscribe: valtioSubscribe, name = "valtio", paths, mutations } = options;
+  let selectors;
+  if (paths) {
+    selectors = {};
+    for (const [key, path] of Object.entries(paths)) {
+      selectors[key] = (state) => getByPath2(state, path);
+    }
+  }
+  let actions;
+  if (mutations) {
+    actions = {};
+    for (const [key, mutation] of Object.entries(mutations)) {
+      actions[key] = (...args) => mutation(...args);
+    }
+  }
+  return {
+    name,
+    getState: () => JSON.parse(JSON.stringify(proxy)),
+    subscribe: (cb) => valtioSubscribe(proxy, cb),
+    selectors,
+    actions
+  };
+}
+
+// libs/react/src/state/adapters/createStore.ts
+function createStore(options) {
+  return {
+    name: options.name,
+    getState: options.getState,
+    subscribe: options.subscribe,
+    selectors: options.selectors,
+    actions: options.actions
+  };
+}

package/state/state.types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Shared types for state management integration.
+ */
+export interface StoreResourceOptions {
+    /** Name prefix for resources and tools (e.g., 'redux' → state://redux). */
+    name: string;
+    /** Returns the current state snapshot. */
+    getState: () => unknown;
+    /** Subscribes to state changes. Returns an unsubscribe function. */
+    subscribe: (cb: () => void) => () => void;
+    /** Named selectors — each becomes a sub-resource state://{name}/{key}. */
+    selectors?: Record<string, (state: unknown) => unknown>;
+    /** Named actions — each becomes a dynamic tool {name}_{key}. */
+    actions?: Record<string, (...args: unknown[]) => unknown>;
+    /** Target a specific named server. */
+    server?: string;
+}
+export interface ReduxResourceOptions {
+    /** Redux store with standard getState/dispatch/subscribe interface. */
+    store: {
+        getState(): unknown;
+        dispatch(action: unknown): unknown;
+        subscribe(fn: () => void): () => void;
+    };
+    /** Name prefix (defaults to 'redux'). */
+    name?: string;
+    /** Named selectors — each becomes a sub-resource. */
+    selectors?: Record<string, (state: unknown) => unknown>;
+    /** Named action creators — each becomes a dynamic tool that dispatches. */
+    actions?: Record<string, (...args: unknown[]) => unknown>;
+    /** Target a specific named server. */
+    server?: string;
+}
+export interface ValtioResourceOptions {
+    /** Valtio proxy object. */
+    proxy: Record<string, unknown>;
+    /** User-provided subscribe function from valtio/utils. */
+    subscribe: (proxy: Record<string, unknown>, cb: () => void) => () => void;
+    /** Name prefix (defaults to 'valtio'). */
+    name?: string;
+    /** Named deep path selectors (dot notation, e.g., 'user.name'). */
+    paths?: Record<string, string>;
+    /** Named mutations — each becomes a dynamic tool. */
+    mutations?: Record<string, (...args: unknown[]) => void>;
+    /** Target a specific named server. */
+    server?: string;
+}
+//# sourceMappingURL=state.types.d.ts.map

package/state/state.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.types.d.ts","sourceRoot":"","sources":["../../src/state/state.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,oEAAoE;IACpE,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAC1C,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;IACxD,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IAC1D,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,KAAK,EAAE;QACL,QAAQ,IAAI,OAAO,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;QACnC,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;KACvC,CAAC;IACF,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;IACxD,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IAC1D,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,0DAA0D;IAC1D,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAC1E,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;IACzD,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/state/useReduxResource.d.ts

@@ -0,0 +1,8 @@
+/**
+ * useReduxResource — thin wrapper around useStoreResource for Redux stores.
+ *
+ * Accepts a standard Redux store and dispatches action creators as MCP tools.
+ */
+import type { ReduxResourceOptions } from './state.types';
+export declare function useReduxResource(options: ReduxResourceOptions): void;
+//# sourceMappingURL=useReduxResource.d.ts.map

package/state/useReduxResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReduxResource.d.ts","sourceRoot":"","sources":["../../src/state/useReduxResource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAwBpE"}

package/state/useStoreRegistration.d.ts

@@ -0,0 +1,14 @@
+/**
+ * useStoreRegistration — internal hook that takes StoreAdapter[] and a
+ * DynamicRegistry, then registers all resources/tools.
+ *
+ * Reuses the same registration logic as useStoreResource:
+ * - For each adapter: register main resource state://{name}, selector
+ *   sub-resources, and action tools
+ * - Subscribe to store changes, call updateResourceRead on change
+ * - Cleanup on unmount
+ */
+import type { DynamicRegistry } from '../registry/DynamicRegistry';
+import type { StoreAdapter } from '../types';
+export declare function useStoreRegistration(stores: StoreAdapter[], dynamicRegistry: DynamicRegistry): void;
+//# sourceMappingURL=useStoreRegistration.d.ts.map

package/state/useStoreRegistration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoreRegistration.d.ts","sourceRoot":"","sources":["../../src/state/useStoreRegistration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAU7C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,eAAe,EAAE,eAAe,GAAG,IAAI,CAkHnG"}

package/state/useStoreResource.d.ts

@@ -0,0 +1,10 @@
+/**
+ * useStoreResource — generic hook that exposes any state store as MCP
+ * resources (with optional deep selectors) and actions as tools.
+ *
+ * This is the core hook; useReduxResource and useValtioResource are
+ * thin wrappers around it.
+ */
+import type { StoreResourceOptions } from './state.types';
+export declare function useStoreResource(options: StoreResourceOptions): void;
+//# sourceMappingURL=useStoreResource.d.ts.map

package/state/useStoreResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoreResource.d.ts","sourceRoot":"","sources":["../../src/state/useStoreResource.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAI1D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CA0IpE"}