@siteverb/react 0.1.0-rc.0

package/README.md

@@ -0,0 +1,43 @@
+# @siteverb/react
+
+React and Next.js lifecycle bindings for `@siteverb/webmcp`.
+
+```tsx
+'use client';
+
+import { SiteverbProvider, useSiteverbTool } from '@siteverb/react';
+
+function SearchTool() {
+  const registration = useSiteverbTool({
+    id: 'catalog.search-products',
+    name: 'search_products',
+    description: 'Search products.',
+    annotations: { readOnlyHint: true },
+    execute: ({ query }: { query: string }) => searchProducts(query),
+  });
+  return null;
+}
+
+export function AgentSurface() {
+  return (
+    <SiteverbProvider>
+      <SearchTool />
+    </SiteverbProvider>
+  );
+}
+```
+
+The provider creates one Siteverb client or accepts an existing client. Hooks register after commit,
+unregister on cleanup, tolerate React Strict Mode, and route execution to the latest committed
+callback without metadata re-registration on every render.
+
+An owned provider renders its children during SSR and the first client paint through an inert,
+unsupported registration surface, then rebinds hooks to the committed browser client after mount.
+It never delays the wrapped application UI to initialize WebMCP.
+
+Provider `options` initialize one owned client after mount and are intentionally not reactive. Pass
+an explicitly managed `client` when configuration must change during the application lifecycle.
+
+In Next.js App Router, place the provider/registrar in a `'use client'` module and mount it from the
+layout or route that owns the tools. Registration remains discoverability; called server routes must
+enforce authorization independently.

package/dist/context.d.ts

@@ -0,0 +1,10 @@
+import { type ReactNode } from 'react';
+import { type SiteverbClient, type SiteverbOptions } from '@siteverb/webmcp';
+export interface SiteverbProviderProps {
+    readonly children?: ReactNode;
+    readonly client?: SiteverbClient;
+    readonly options?: SiteverbOptions;
+}
+export declare function SiteverbProvider({ children, client, options }: SiteverbProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<SiteverbClient | undefined>> | import("react").FunctionComponentElement<SiteverbProviderProps>;
+export declare function useSiteverbClient(): SiteverbClient;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAI7F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;CACpC;AA+BD,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,qBAAqB,yKAIpF;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAIlD"}

package/dist/context.js

@@ -0,0 +1,41 @@
+'use client';
+import { createContext, createElement, useContext, useEffect, useRef, useState, } from 'react';
+import { createSiteverb } from '@siteverb/webmcp';
+const SiteverbContext = createContext(undefined);
+function OwnedSiteverbProvider({ children, options }) {
+    const initialOptions = useRef(options);
+    const fallbackClient = useRef(undefined);
+    if (!fallbackClient.current) {
+        fallbackClient.current = createSiteverb({ modelContext: () => undefined });
+    }
+    const [ownedClient, setOwnedClient] = useState(undefined);
+    useEffect(() => {
+        let active = true;
+        let created;
+        queueMicrotask(() => {
+            if (!active)
+                return;
+            created = createSiteverb(initialOptions.current);
+            setOwnedClient(created);
+        });
+        return () => {
+            active = false;
+            created?.dispose();
+        };
+    }, []);
+    return createElement(SiteverbContext.Provider, { value: ownedClient ?? fallbackClient.current }, children);
+}
+export function SiteverbProvider({ children, client, options }) {
+    if (client && options)
+        throw new TypeError('Pass either client or options to SiteverbProvider.');
+    if (client)
+        return createElement(SiteverbContext.Provider, { value: client }, children);
+    return createElement(OwnedSiteverbProvider, options === undefined ? {} : { options }, children);
+}
+export function useSiteverbClient() {
+    const client = useContext(SiteverbContext);
+    if (!client)
+        throw new Error('useSiteverbClient must be used inside SiteverbProvider.');
+    return client;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EACL,aAAa,EACb,aAAa,EACb,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,GAET,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,cAAc,EAA6C,MAAM,kBAAkB,CAAC;AAE7F,MAAM,eAAe,GAAG,aAAa,CAA6B,SAAS,CAAC,CAAC;AAQ7E,SAAS,qBAAqB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAyB;IACzE,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,cAAc,GAAG,MAAM,CAA6B,SAAS,CAAC,CAAC;IACrE,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC5B,cAAc,CAAC,OAAO,GAAG,cAAc,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAA6B,SAAS,CAAC,CAAC;IAEtF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,OAAmC,CAAC;QACxC,cAAc,CAAC,GAAG,EAAE;YAClB,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,OAAO,GAAG,cAAc,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YACjD,cAAc,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,KAAK,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,aAAa,CAClB,eAAe,CAAC,QAAQ,EACxB,EAAE,KAAK,EAAE,WAAW,IAAI,cAAc,CAAC,OAAO,EAAE,EAChD,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAyB;IACnF,IAAI,MAAM,IAAI,OAAO;QAAE,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;IACjG,IAAI,MAAM;QAAE,OAAO,aAAa,CAAC,eAAe,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;IACxF,OAAO,aAAa,CAAC,qBAAqB,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IACxF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,16 @@
+import type { AnySiteverbTool, RegisterToolOptions, RegisterToolsOptions, RegistrationStatus, SiteverbToolDefinition } from '@siteverb/webmcp';
+export interface UseSiteverbRegistrationOptions extends RegisterToolOptions {
+    readonly enabled?: boolean;
+    readonly onError?: (error: unknown) => void;
+}
+export interface UseSiteverbBatchOptions extends RegisterToolsOptions {
+    readonly enabled?: boolean;
+    readonly onError?: (error: unknown) => void;
+}
+export interface SiteverbRegistrationState {
+    readonly error: unknown;
+    readonly status: RegistrationStatus;
+}
+export declare function useSiteverbTool<TInput extends object, TResult>(definition: SiteverbToolDefinition<TInput, TResult>, options?: UseSiteverbRegistrationOptions): SiteverbRegistrationState;
+export declare function useSiteverbTools(definitions: readonly AnySiteverbTool[], options?: UseSiteverbBatchOptions): SiteverbRegistrationState;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAK1B,MAAM,WAAW,8BAA+B,SAAQ,mBAAmB;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC;AAeD,wBAAgB,eAAe,CAAC,MAAM,SAAS,MAAM,EAAE,OAAO,EAC5D,UAAU,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,EACnD,OAAO,GAAE,8BAAmC,GAC3C,yBAAyB,CAuD3B;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,SAAS,eAAe,EAAE,EACvC,OAAO,GAAE,uBAA4B,GACpC,yBAAyB,CA8D3B"}

package/dist/hooks.js

@@ -0,0 +1,137 @@
+'use client';
+import { useEffect, useLayoutEffect, useRef, useState } from 'react';
+import { useSiteverbClient } from './context.js';
+const useCommittedLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;
+function metadataKey(tools) {
+    return JSON.stringify(tools.map(({ id, name, title, description, inputSchema, annotations }) => ({
+        id,
+        name,
+        title,
+        description,
+        inputSchema,
+        annotations,
+    })));
+}
+export function useSiteverbTool(definition, options = {}) {
+    const client = useSiteverbClient();
+    const definitionRef = useRef(definition);
+    const onErrorRef = useRef(options.onError);
+    const [state, setState] = useState({
+        error: undefined,
+        status: options.enabled === false ? 'unregistered' : 'pending',
+    });
+    const key = metadataKey([definition]);
+    const exposedToKey = JSON.stringify(options.exposedTo ?? []);
+    useCommittedLayoutEffect(() => {
+        definitionRef.current = definition;
+        onErrorRef.current = options.onError;
+    });
+    useEffect(() => {
+        if (options.enabled === false) {
+            setState({ error: undefined, status: 'unregistered' });
+            return;
+        }
+        let active = true;
+        setState({ error: undefined, status: 'pending' });
+        const wrappedDefinition = {
+            ...definition,
+            execute: (input, context) => definitionRef.current.execute(input, context),
+        };
+        const registration = client.registerTool(wrappedDefinition, {
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+            ...(options.exposedTo === undefined ? {} : { exposedTo: options.exposedTo }),
+        });
+        const onExternalAbort = () => {
+            if (active)
+                setState({ error: undefined, status: 'unregistered' });
+        };
+        options.signal?.addEventListener('abort', onExternalAbort, { once: true });
+        void registration.ready
+            .then((result) => {
+            if (active)
+                setState({ error: undefined, status: result.status });
+        })
+            .catch((error) => {
+            if (options.signal?.aborted) {
+                if (active)
+                    setState({ error: undefined, status: 'unregistered' });
+                return;
+            }
+            onErrorRef.current?.(error);
+            if (active)
+                setState({ error, status: 'failed' });
+        });
+        return () => {
+            active = false;
+            options.signal?.removeEventListener('abort', onExternalAbort);
+            registration.unregister();
+        };
+    }, [client, key, exposedToKey, options.enabled, options.signal]);
+    return state;
+}
+export function useSiteverbTools(definitions, options = {}) {
+    const client = useSiteverbClient();
+    const definitionsRef = useRef(definitions);
+    const onErrorRef = useRef(options.onError);
+    const [state, setState] = useState({
+        error: undefined,
+        status: options.enabled === false ? 'unregistered' : 'pending',
+    });
+    const key = metadataKey(definitions);
+    const exposedToKey = JSON.stringify(options.exposedTo ?? []);
+    useCommittedLayoutEffect(() => {
+        definitionsRef.current = definitions;
+        onErrorRef.current = options.onError;
+    });
+    useEffect(() => {
+        if (options.enabled === false) {
+            setState({ error: undefined, status: 'unregistered' });
+            return;
+        }
+        let active = true;
+        setState({ error: undefined, status: 'pending' });
+        const wrappers = definitions.map((definition) => ({
+            ...definition,
+            execute: (input, context) => {
+                const latest = definitionsRef.current.find((tool) => tool.id === definition.id);
+                if (!latest)
+                    throw new Error(`Siteverb tool "${definition.id}" is no longer available.`);
+                return latest.execute(input, context);
+            },
+        }));
+        const registration = client.registerTools(wrappers, {
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+            ...(options.exposedTo === undefined ? {} : { exposedTo: options.exposedTo }),
+            ...(options.atomic === undefined ? {} : { atomic: options.atomic }),
+        });
+        const onExternalAbort = () => {
+            if (active)
+                setState({ error: undefined, status: 'unregistered' });
+        };
+        options.signal?.addEventListener('abort', onExternalAbort, { once: true });
+        void registration.ready
+            .then((results) => {
+            if (!active)
+                return;
+            const unsupported = results.some((result) => result.status === 'unsupported');
+            setState({ error: undefined, status: unsupported ? 'unsupported' : 'registered' });
+        })
+            .catch((error) => {
+            if (options.signal?.aborted) {
+                if (active)
+                    setState({ error: undefined, status: 'unregistered' });
+                return;
+            }
+            onErrorRef.current?.(error);
+            if (active)
+                setState({ error, status: 'failed' });
+        });
+        return () => {
+            active = false;
+            options.signal?.removeEventListener('abort', onExternalAbort);
+            registration.unregister();
+        };
+    }, [client, key, exposedToKey, options.atomic, options.enabled, options.signal]);
+    return state;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { SiteverbProvider, useSiteverbClient } from './context.js';
+export { useSiteverbTool, useSiteverbTools } from './hooks.js';
+export type { SiteverbProviderProps } from './context.js';
+export type { SiteverbRegistrationState, UseSiteverbBatchOptions, UseSiteverbRegistrationOptions, } from './hooks.js';
+//# 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":"AAEA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/D,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EACV,yBAAyB,EACzB,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+'use client';
+export { SiteverbProvider, useSiteverbClient } from './context.js';
+export { useSiteverbTool, useSiteverbTools } from './hooks.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@siteverb/react",
+  "version": "0.1.0-rc.0",
+  "description": "React and Next.js lifecycle bindings for @siteverb/webmcp.",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "package:check": "publint && attw --pack . --profile esm-only",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "keywords": [
+    "webmcp",
+    "react",
+    "nextjs",
+    "browser-agents"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/siteverb/siteverb.git",
+    "directory": "packages/react"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@siteverb/webmcp": "^0.1.0-rc.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.3"
+  }
+}