@frontmcp/react 0.0.1

package/hooks/index.d.ts

@@ -0,0 +1,21 @@
+export { useFrontMcp } from './useFrontMcp';
+export { useServer } from './useServer';
+export { useResolvedServer } from './useResolvedServer';
+export type { ResolvedServerEntry } from './useResolvedServer';
+export { useCallTool } from './useCallTool';
+export { useReadResource } from './useReadResource';
+export { useGetPrompt } from './useGetPrompt';
+export type { UseGetPromptReturn } from './useGetPrompt';
+export { useListTools } from './useListTools';
+export { useListResources } from './useListResources';
+export type { UseListResourcesResult } from './useListResources';
+export { useListPrompts } from './useListPrompts';
+export { useStoreResource } from './useStoreResource';
+export type { UseStoreResourceReturn } from './useStoreResource';
+export { useDynamicTool } from './useDynamicTool';
+export type { UseDynamicToolOptions, UseDynamicToolSchemaOptions, UseDynamicToolJsonSchemaOptions, } from './useDynamicTool';
+export { useDynamicResource } from './useDynamicResource';
+export type { UseDynamicResourceOptions } from './useDynamicResource';
+export { useComponentTree } from './useComponentTree';
+export type { UseComponentTreeOptions } from './useComponentTree';
+//# sourceMappingURL=index.d.ts.map

package/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,qBAAqB,EACrB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/hooks/useCallTool.d.ts

@@ -0,0 +1,9 @@
+/**
+ * useCallTool — [callFn, state, reset] tuple for tool invocation.
+ *
+ * Supports multi-server via `options.server` — targets a named server
+ * from the ServerRegistry instead of the provider context.
+ */
+import type { UseCallToolOptions, UseCallToolReturn } from '../types';
+export declare function useCallTool<TInput extends object = Record<string, unknown>, TOutput = unknown>(toolName: string, options?: UseCallToolOptions): UseCallToolReturn<TInput, TOutput>;
+//# sourceMappingURL=useCallTool.d.ts.map

package/hooks/useCallTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCallTool.d.ts","sourceRoot":"","sources":["../../src/hooks/useCallTool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAa,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGjF,wBAAgB,WAAW,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,EAC5F,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAoDpC"}

package/hooks/useComponentTree.d.ts

@@ -0,0 +1,21 @@
+/**
+ * useComponentTree — exposes the DOM subtree under a ref as an MCP resource.
+ *
+ * Uses `data-component` attributes for component names (opt-in).
+ * Falls back to tag names for unattributed elements.
+ * Returns a JSON tree structure representing the component hierarchy.
+ */
+import type { RefObject } from 'react';
+export interface UseComponentTreeOptions {
+    rootRef: RefObject<HTMLElement | null>;
+    /** Resource URI (defaults to 'react://component-tree'). */
+    uri?: string;
+    /** Maximum traversal depth (default: 10). */
+    maxDepth?: number;
+    /** Include data-* attributes as props (default: false). */
+    includeProps?: boolean;
+    /** Target a specific named server. */
+    server?: string;
+}
+export declare function useComponentTree(options: UseComponentTreeOptions): void;
+//# sourceMappingURL=useComponentTree.d.ts.map

package/hooks/useComponentTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComponentTree.d.ts","sourceRoot":"","sources":["../../src/hooks/useComponentTree.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACvC,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA2CD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CA6BvE"}

package/hooks/useDynamicResource.d.ts

@@ -0,0 +1,20 @@
+/**
+ * useDynamicResource — registers an MCP resource on mount, unregisters on unmount.
+ *
+ * Uses useRef for the read function to avoid stale closures.
+ * The resource appears in useListResources and can be read by agents.
+ */
+import type { ReadResourceResult } from '@frontmcp/sdk';
+export interface UseDynamicResourceOptions {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+    read: () => Promise<ReadResourceResult>;
+    /** Set to false to conditionally disable the resource (default: true). */
+    enabled?: boolean;
+    /** Target a specific named server from the ServerRegistry. */
+    server?: string;
+}
+export declare function useDynamicResource(options: UseDynamicResourceOptions): void;
+//# sourceMappingURL=useDynamicResource.d.ts.map

package/hooks/useDynamicResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDynamicResource.d.ts","sourceRoot":"","sources":["../../src/hooks/useDynamicResource.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAwB3E"}

package/hooks/useDynamicTool.d.ts

@@ -0,0 +1,39 @@
+/**
+ * useDynamicTool — registers an MCP tool on mount, unregisters on unmount.
+ *
+ * Uses useRef for the execute function to avoid stale closures.
+ * The tool appears in useListTools and can be called by agents.
+ *
+ * Supports both JSON Schema and zod-based schemas. When a zod schema
+ * is provided, input is validated before reaching the execute callback.
+ */
+import type { CallToolResult } from '@frontmcp/sdk';
+import type { z } from 'zod';
+export interface UseDynamicToolSchemaOptions<S extends z.ZodObject<z.ZodRawShape>> {
+    name: string;
+    description: string;
+    /** Zod schema for type-safe input validation. */
+    schema: S;
+    inputSchema?: never;
+    /** Type-safe execute callback — args are validated against `schema`. */
+    execute: (args: z.infer<S>) => Promise<CallToolResult>;
+    /** Set to false to conditionally disable the tool (default: true). */
+    enabled?: boolean;
+    /** Target a specific named server from the ServerRegistry. */
+    server?: string;
+}
+export interface UseDynamicToolJsonSchemaOptions {
+    name: string;
+    description: string;
+    schema?: never;
+    /** Raw JSON Schema for the tool's input. */
+    inputSchema: Record<string, unknown>;
+    execute: (args: Record<string, unknown>) => Promise<CallToolResult>;
+    /** Set to false to conditionally disable the tool (default: true). */
+    enabled?: boolean;
+    /** Target a specific named server from the ServerRegistry. */
+    server?: string;
+}
+export type UseDynamicToolOptions<S extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>> = UseDynamicToolSchemaOptions<S> | UseDynamicToolJsonSchemaOptions;
+export declare function useDynamicTool<S extends z.ZodObject<z.ZodRawShape>>(options: UseDynamicToolOptions<S>): void;
+//# sourceMappingURL=useDynamicTool.d.ts.map

package/hooks/useDynamicTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDynamicTool.d.ts","sourceRoot":"","sources":["../../src/hooks/useDynamicTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,wEAAwE;IACxE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACvD,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACpE,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAC/F,2BAA2B,CAAC,CAAC,CAAC,GAC9B,+BAA+B,CAAC;AAEpC,wBAAgB,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,CA2D5G"}

package/hooks/useFrontMcp.d.ts

@@ -0,0 +1,8 @@
+/**
+ * useFrontMcp — access a resolved server by name, or the default provider server.
+ *
+ * @param name - optional server name; defaults to the provider's `name`.
+ */
+import type { ResolvedServer } from '../types';
+export declare function useFrontMcp(name?: string): ResolvedServer;
+//# sourceMappingURL=useFrontMcp.d.ts.map

package/hooks/useFrontMcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFrontMcp.d.ts","sourceRoot":"","sources":["../../src/hooks/useFrontMcp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAezD"}

package/hooks/useGetPrompt.d.ts

@@ -0,0 +1,13 @@
+/**
+ * useGetPrompt — [fn, state] tuple for prompt fetching.
+ *
+ * Supports multi-server via `options.server`.
+ */
+import type { PromptState } from '../types';
+interface GetPromptOptions {
+    server?: string;
+}
+export type UseGetPromptReturn = [(args?: Record<string, string>) => Promise<unknown>, PromptState];
+export declare function useGetPrompt(promptName: string, options?: GetPromptOptions): UseGetPromptReturn;
+export {};
+//# sourceMappingURL=useGetPrompt.d.ts.map

package/hooks/useGetPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetPrompt.d.ts","sourceRoot":"","sources":["../../src/hooks/useGetPrompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;AAEpG,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAmC/F"}

package/hooks/useListPrompts.d.ts

@@ -0,0 +1,10 @@
+/**
+ * useListPrompts — reactive prompt list from the ServerRegistry.
+ */
+import type { PromptInfo } from '../types';
+interface ListPromptsOptions {
+    server?: string;
+}
+export declare function useListPrompts(options?: ListPromptsOptions): PromptInfo[];
+export {};
+//# sourceMappingURL=useListPrompts.d.ts.map

package/hooks/useListPrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListPrompts.d.ts","sourceRoot":"","sources":["../../src/hooks/useListPrompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAK3C,UAAU,kBAAkB;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,UAAU,EAAE,CAGzE"}

package/hooks/useListResources.d.ts

@@ -0,0 +1,14 @@
+/**
+ * useListResources — reactive resource + template list from the ServerRegistry.
+ */
+import type { ResourceInfo, ResourceTemplateInfo } from '../types';
+interface ListResourcesOptions {
+    server?: string;
+}
+export interface UseListResourcesResult {
+    resources: ResourceInfo[];
+    resourceTemplates: ResourceTemplateInfo[];
+}
+export declare function useListResources(options?: ListResourcesOptions): UseListResourcesResult;
+export {};
+//# sourceMappingURL=useListResources.d.ts.map

package/hooks/useListResources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListResources.d.ts","sourceRoot":"","sources":["../../src/hooks/useListResources.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAMnE,UAAU,oBAAoB;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;CAC3C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,sBAAsB,CAMvF"}

package/hooks/useListTools.d.ts

@@ -0,0 +1,10 @@
+/**
+ * useListTools — reactive tool list from the ServerRegistry.
+ */
+import type { ToolInfo } from '../types';
+interface ListToolsOptions {
+    server?: string;
+}
+export declare function useListTools(options?: ListToolsOptions): ToolInfo[];
+export {};
+//# sourceMappingURL=useListTools.d.ts.map

package/hooks/useListTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListTools.d.ts","sourceRoot":"","sources":["../../src/hooks/useListTools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAKzC,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,QAAQ,EAAE,CAGnE"}

package/hooks/useReadResource.d.ts

@@ -0,0 +1,23 @@
+/**
+ * useReadResource — dual-mode resource reading.
+ *
+ * Lazy mode (no URI): `const [read, state] = useReadResource()`
+ * Auto-fetch mode:    `const state = useReadResource('app://info')`
+ *
+ * Supports multi-server via `options.server`.
+ */
+import type { ResourceState } from '../types';
+interface ReadResourceOptions {
+    server?: string;
+}
+type ReadFn = (uri: string) => Promise<unknown>;
+type LazyReturn = [ReadFn, ResourceState & {
+    refetch?: undefined;
+}];
+type AutoReturn = ResourceState & {
+    refetch: () => void;
+};
+export declare function useReadResource(options?: ReadResourceOptions): LazyReturn;
+export declare function useReadResource(uri: string, options?: ReadResourceOptions): AutoReturn;
+export {};
+//# sourceMappingURL=useReadResource.d.ts.map

package/hooks/useReadResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReadResource.d.ts","sourceRoot":"","sources":["../../src/hooks/useReadResource.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,UAAU,mBAAmB;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAChD,KAAK,UAAU,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG;IAAE,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AACpE,KAAK,UAAU,GAAG,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAE1D,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,UAAU,CAAC;AAC3E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,UAAU,CAAC"}

package/hooks/useResolvedServer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * useResolvedServer — internal shared hook that resolves a server entry.
+ *
+ * Without args: resolves the provider's server name from context.
+ * With a name: resolves the named server from the ServerRegistry.
+ */
+import type { ServerEntry } from '../registry/ServerRegistry';
+import type { ComponentRegistry } from '../components/ComponentRegistry';
+export interface ResolvedServerEntry {
+    entry: ServerEntry | undefined;
+    name: string;
+    registry: ComponentRegistry;
+    connect: () => Promise<void>;
+}
+export declare function useResolvedServer(serverName?: string): ResolvedServerEntry;
+//# sourceMappingURL=useResolvedServer.d.ts.map

package/hooks/useResolvedServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolvedServer.d.ts","sourceRoot":"","sources":["../../src/hooks/useResolvedServer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAK1E"}

package/hooks/useServer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * useServer — access a named server from the shared ServerRegistry singleton.
+ *
+ * Uses useSyncExternalStore for tear-free reads. When no name is given,
+ * returns the 'default' server entry (the one from FrontMcpProvider).
+ *
+ * @example
+ * ```tsx
+ * const entry = useServer('analytics');
+ * if (entry?.status === 'connected') {
+ *   // entry.client is available
+ * }
+ * ```
+ */
+import type { ServerEntry } from '../registry/ServerRegistry';
+export declare function useServer(name?: string): ServerEntry | undefined;
+//# sourceMappingURL=useServer.d.ts.map

package/hooks/useServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useServer.d.ts","sourceRoot":"","sources":["../../src/hooks/useServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAQhE"}

package/hooks/useStoreResource.d.ts

@@ -0,0 +1,22 @@
+/**
+ * useStoreResource — Subscribe to a `state://` URI via MCP resource subscriptions.
+ *
+ * When the server sends `notifications/resources/updated`, the hook re-fetches
+ * the resource automatically. This enables live reactive state binding.
+ *
+ * Supports multi-server via `options.server`.
+ */
+interface StoreResourceState {
+    data: unknown;
+    loading: boolean;
+    error: Error | null;
+}
+interface StoreResourceOptions {
+    server?: string;
+}
+export interface UseStoreResourceReturn extends StoreResourceState {
+    refetch: () => void;
+}
+export declare function useStoreResource(uri: string, options?: StoreResourceOptions): UseStoreResourceReturn;
+export {};
+//# sourceMappingURL=useStoreResource.d.ts.map

package/hooks/useStoreResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoreResource.d.ts","sourceRoot":"","sources":["../../src/hooks/useStoreResource.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,UAAU,kBAAkB;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,UAAU,oBAAoB;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAcD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,sBAAsB,CA6DpG"}

package/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @frontmcp/react — React hooks, components, and utilities for FrontMCP.
+ *
+ * Entry points:
+ * - `@frontmcp/react`        — Provider + hooks + components + ServerRegistry + SDK re-exports
+ * - `@frontmcp/react/ai`     — AI SDK integration hooks (OpenAI, Vercel AI, Claude)
+ * - `@frontmcp/react/router` — React Router integration (optional)
+ * - `@frontmcp/react/state`  — State management integration (Redux, Valtio, generic)
+ * - `@frontmcp/react/api`    — API client integration (OpenAPI)
+ *
+ * @packageDocumentation
+ */
+export { create, clearCreateCache } from '@frontmcp/sdk';
+export { connect, connectOpenAI, connectClaude, connectLangChain, connectVercelAI } from '@frontmcp/sdk';
+export type { CreateConfig, DirectMcpServer, DirectClient, DirectCallOptions, DirectAuthContext } from '@frontmcp/sdk';
+export type { ConnectOptions, LLMPlatform } from '@frontmcp/sdk';
+export { Tool, FrontMcpTool, tool, frontMcpTool, Resource, FrontMcpResource, resource, frontMcpResource, ResourceTemplate, FrontMcpResourceTemplate, resourceTemplate, frontMcpResourceTemplate, Prompt, FrontMcpPrompt, prompt, frontMcpPrompt, App, FrontMcpApp, FrontMcp, Adapter, FrontMcpAdapter, Plugin, FrontMcpPlugin, } from '@frontmcp/sdk';
+export { ToolContext, ResourceContext, PromptContext, ExecutionContextBase } from '@frontmcp/sdk';
+export type { GetPromptResult, ReadResourceResult, CallToolResult, ListToolsResult, ListResourcesResult, ListResourceTemplatesResult, ListPromptsResult, TextContent, ImageContent, PromptMessage, } from '@frontmcp/sdk';
+export type { FrontMcpContextValue, ResolvedServer, FrontMcpStatus, ToolInfo, ResourceInfo, ResourceTemplateInfo, PromptInfo, ToolState, ResourceState, PromptState, UseCallToolOptions, UseCallToolReturn, ComponentNode, FieldRenderProps, DynamicToolDef, DynamicResourceDef, StoreAdapter, McpColumnDef, } from './types';
+export { ServerRegistry, serverRegistry } from './registry';
+export { DynamicRegistry } from './registry';
+export type { ServerEntry } from './registry';
+export { FrontMcpContext, FrontMcpProvider } from './provider';
+export type { FrontMcpProviderProps } from './provider';
+export { useFrontMcp, useServer, useResolvedServer, useCallTool, useReadResource, useGetPrompt, useListTools, useListResources, useListPrompts, useStoreResource, useDynamicTool, useDynamicResource, useComponentTree, } from './hooks';
+export type { ResolvedServerEntry, UseGetPromptReturn, UseListResourcesResult, UseStoreResourceReturn } from './hooks';
+export type { UseDynamicToolOptions, UseDynamicToolSchemaOptions, UseDynamicToolJsonSchemaOptions, UseDynamicResourceOptions, UseComponentTreeOptions, } from './hooks';
+export { ComponentRegistry, DynamicRenderer, readDomById, readDomBySelector, ToolForm, PromptForm, ResourceViewer, OutputDisplay, AgentContent, AgentSearch, mcpComponent, mcpLazy, } from './components';
+export type { ComponentRegistryEntry, DynamicRendererProps, DomResourceResult, ToolFormProps, PromptFormProps, ResourceViewerProps, ResourceContent, OutputDisplayProps, AgentContentProps, AgentSearchProps, SearchInputRenderProps, McpComponentOptions, McpComponentInstance, } from './components';
+export { reduxStore, valtioStore, createStore } from './state/adapters';
+export type { HttpClient, HttpRequestConfig, HttpResponse } from './api/api.types';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}