@ethisyscore/plugin-ui 1.34.0 → 1.37.0

package/dist/platform-react/index.d.cts

@@ -4,6 +4,7 @@ import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, UseQueryResult, UseQueryOptions, QueryKey } from '@tanstack/react-query';
 import { PlatformReactPageProps } from '@ethisyscore/components-react';
 import * as _tanstack_query_core from '@tanstack/query-core';
+import { McpTransport, UploadDocumentResult } from '@ethisyscore/extension-runtime/plugin';
 
 /** A view component resolved from the template manifest. Props are open. */
 type ViewComponent = ComponentType<Record<string, unknown>>;
@@ -800,6 +801,57 @@ declare function createReactRouterShim(options?: ReactRouterShimOptions): {
  */
 declare function usePluginRealtime(typeCode: string, handler: (payload: unknown) => void): void;
 
+/**
+ * Advisory client-side upload ceiling (UX only). The kernel's streaming route
+ * applies the authoritative size cap mid-stream; this default lets the hook
+ * fail fast with a friendly message before reading a large file into memory.
+ * Roughly matches the host's default request-body ceiling.
+ */
+declare const DEFAULT_MAX_UPLOAD_BYTES: number;
+/** Where the uploaded document belongs. `moduleKey` is validated against the caller's kernel allowlist. */
+interface UseMcpUploadTarget {
+    /** Storage module key (e.g. "hr"). Server rejects a key outside the plugin's allowlist. */
+    moduleKey: string;
+    /** Owning entity name (e.g. "Candidates", "CompanyDocuments"). */
+    entityName: string;
+    /** Optional owning entity id. */
+    entityId?: string;
+    /** Logical sub-folder / category (e.g. "cvs"). */
+    category: string;
+}
+interface UseMcpUploadOptions {
+    /** Override the transport resolved from the runtime provider (tests / advanced hosts). */
+    transport?: McpTransport;
+    /** Advisory client-side max byte size. Defaults to {@link DEFAULT_MAX_UPLOAD_BYTES}. */
+    maxSizeBytes?: number;
+}
+interface UseMcpUploadResult {
+    /**
+     * Read `file` into an ArrayBuffer and upload it to core storage via the host,
+     * resolving the resulting `StoredDocumentId` + server-validated metadata. The
+     * plugin then records the id with its own JSON command.
+     */
+    upload: (file: File | Blob, target: UseMcpUploadTarget) => Promise<UploadDocumentResult>;
+    /**
+     * Coarse progress in [0, 1]. NOTE: the FE→host leg is not streaming (the file
+     * is transferred whole), so this is phase-based, not byte-accurate: 0 idle,
+     * ~0.1 once the bytes are read + handed to the host, 1 on completion.
+     */
+    progress: number;
+    loading: boolean;
+    error: Error | undefined;
+}
+/**
+ * Upload a binary file from a platform-react plugin surface to CORE storage.
+ *
+ * The bytes never touch the plugin backend and the plugin never sees the
+ * capability token or kernel URL: the host shell mints the token and streams
+ * the octet-stream to the kernel document-upload route, returning only the
+ * `StoredDocumentId`. Filename/content-type are advisory — the kernel
+ * sanitises them and binds the effective module key + organisation itself.
+ */
+declare function useMcpUpload(opts?: UseMcpUploadOptions): UseMcpUploadResult;
+
 declare const OVERLAY_HOST_CONTRACT_VERSION = "1.0.0";
 /** Canonical inset-lease identity — the SAME shape the web host layout store uses (Codex R2 M1:
  *  one lease shape across SDK/web/store, no adapter). The store's handle extends this with `source`. */
@@ -969,4 +1021,42 @@ interface ManagedLifecycle {
  */
 declare function useManagedLifecycle(): ManagedLifecycle;
 
-export { type AuthenticatedQueryResult, BaseMcpService, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, type InsetLease, type ManagedLifecycle, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, TemplateContext, type TemplateManifest, type ToolInvoker, type ViewComponent, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, notViaMcp, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useOverlayHost, usePluginRealtime, useToolInvoker, useToolInvokerMap, useView };
+/** The surface's mount context, provided by definePlatformReactPluginPage. */
+interface SurfaceBaseValue {
+    /** Host-provided mount path `/extensions/<slug>/<pageId>` (authoritative). */
+    basePath?: string;
+    /** The page id (from PlatformReactPageProps), used for the derived fallback. */
+    pageId?: string;
+}
+declare const SurfaceBaseContext: react.Context<SurfaceBaseValue | undefined>;
+/** Match the host's slug normalisation (useExtensionSurfaceShellPage `normaliseSlug`). */
+declare function normaliseSlug(value: string): string;
+/**
+ * Resolve the surface base. Precedence: host-provided basePath → derived from
+ * normaliseSlug(extensionGroupCode) + pageId → null (caller decides how to fail).
+ * Pure — callers read context + identity and pass the pieces in.
+ */
+declare function resolveSurfaceBase(input: {
+    basePath?: string;
+    pageId?: string;
+    extensionGroupCode?: string | null;
+}): {
+    base: string;
+    groupRoot: string;
+} | null;
+/** Join base + sub (leading slash stripped) + optional ?query/#hash suffix. */
+declare function buildSurfaceUrl(base: string, sub?: string, suffix?: string): string;
+/**
+ * Hook: build a URL relative to the CURRENT surface. Precedence per
+ * resolveSurfaceBase; throws in dev when unresolved (never returns app-root).
+ */
+declare function useSurfaceUrl(): (sub?: string, suffix?: string) => string;
+/** Pure: build a URL for ANOTHER surface (cross-surface, e.g. an overlay opening a page). */
+declare function surfacePathFor(opts: {
+    slug: string;
+    pageId: string;
+    sub?: string;
+    suffix?: string;
+}): string;
+
+export { type AuthenticatedQueryResult, BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, type InsetLease, type ManagedLifecycle, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, SurfaceBaseContext, type SurfaceBaseValue, TemplateContext, type TemplateManifest, type ToolInvoker, type UseMcpUploadOptions, type UseMcpUploadResult, type UseMcpUploadTarget, type ViewComponent, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };

package/dist/platform-react/index.d.ts

@@ -4,6 +4,7 @@ import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, UseQueryResult, UseQueryOptions, QueryKey } from '@tanstack/react-query';
 import { PlatformReactPageProps } from '@ethisyscore/components-react';
 import * as _tanstack_query_core from '@tanstack/query-core';
+import { McpTransport, UploadDocumentResult } from '@ethisyscore/extension-runtime/plugin';
 
 /** A view component resolved from the template manifest. Props are open. */
 type ViewComponent = ComponentType<Record<string, unknown>>;
@@ -800,6 +801,57 @@ declare function createReactRouterShim(options?: ReactRouterShimOptions): {
  */
 declare function usePluginRealtime(typeCode: string, handler: (payload: unknown) => void): void;
 
+/**
+ * Advisory client-side upload ceiling (UX only). The kernel's streaming route
+ * applies the authoritative size cap mid-stream; this default lets the hook
+ * fail fast with a friendly message before reading a large file into memory.
+ * Roughly matches the host's default request-body ceiling.
+ */
+declare const DEFAULT_MAX_UPLOAD_BYTES: number;
+/** Where the uploaded document belongs. `moduleKey` is validated against the caller's kernel allowlist. */
+interface UseMcpUploadTarget {
+    /** Storage module key (e.g. "hr"). Server rejects a key outside the plugin's allowlist. */
+    moduleKey: string;
+    /** Owning entity name (e.g. "Candidates", "CompanyDocuments"). */
+    entityName: string;
+    /** Optional owning entity id. */
+    entityId?: string;
+    /** Logical sub-folder / category (e.g. "cvs"). */
+    category: string;
+}
+interface UseMcpUploadOptions {
+    /** Override the transport resolved from the runtime provider (tests / advanced hosts). */
+    transport?: McpTransport;
+    /** Advisory client-side max byte size. Defaults to {@link DEFAULT_MAX_UPLOAD_BYTES}. */
+    maxSizeBytes?: number;
+}
+interface UseMcpUploadResult {
+    /**
+     * Read `file` into an ArrayBuffer and upload it to core storage via the host,
+     * resolving the resulting `StoredDocumentId` + server-validated metadata. The
+     * plugin then records the id with its own JSON command.
+     */
+    upload: (file: File | Blob, target: UseMcpUploadTarget) => Promise<UploadDocumentResult>;
+    /**
+     * Coarse progress in [0, 1]. NOTE: the FE→host leg is not streaming (the file
+     * is transferred whole), so this is phase-based, not byte-accurate: 0 idle,
+     * ~0.1 once the bytes are read + handed to the host, 1 on completion.
+     */
+    progress: number;
+    loading: boolean;
+    error: Error | undefined;
+}
+/**
+ * Upload a binary file from a platform-react plugin surface to CORE storage.
+ *
+ * The bytes never touch the plugin backend and the plugin never sees the
+ * capability token or kernel URL: the host shell mints the token and streams
+ * the octet-stream to the kernel document-upload route, returning only the
+ * `StoredDocumentId`. Filename/content-type are advisory — the kernel
+ * sanitises them and binds the effective module key + organisation itself.
+ */
+declare function useMcpUpload(opts?: UseMcpUploadOptions): UseMcpUploadResult;
+
 declare const OVERLAY_HOST_CONTRACT_VERSION = "1.0.0";
 /** Canonical inset-lease identity — the SAME shape the web host layout store uses (Codex R2 M1:
  *  one lease shape across SDK/web/store, no adapter). The store's handle extends this with `source`. */
@@ -969,4 +1021,42 @@ interface ManagedLifecycle {
  */
 declare function useManagedLifecycle(): ManagedLifecycle;
 
-export { type AuthenticatedQueryResult, BaseMcpService, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, type InsetLease, type ManagedLifecycle, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, TemplateContext, type TemplateManifest, type ToolInvoker, type ViewComponent, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, notViaMcp, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useOverlayHost, usePluginRealtime, useToolInvoker, useToolInvokerMap, useView };
+/** The surface's mount context, provided by definePlatformReactPluginPage. */
+interface SurfaceBaseValue {
+    /** Host-provided mount path `/extensions/<slug>/<pageId>` (authoritative). */
+    basePath?: string;
+    /** The page id (from PlatformReactPageProps), used for the derived fallback. */
+    pageId?: string;
+}
+declare const SurfaceBaseContext: react.Context<SurfaceBaseValue | undefined>;
+/** Match the host's slug normalisation (useExtensionSurfaceShellPage `normaliseSlug`). */
+declare function normaliseSlug(value: string): string;
+/**
+ * Resolve the surface base. Precedence: host-provided basePath → derived from
+ * normaliseSlug(extensionGroupCode) + pageId → null (caller decides how to fail).
+ * Pure — callers read context + identity and pass the pieces in.
+ */
+declare function resolveSurfaceBase(input: {
+    basePath?: string;
+    pageId?: string;
+    extensionGroupCode?: string | null;
+}): {
+    base: string;
+    groupRoot: string;
+} | null;
+/** Join base + sub (leading slash stripped) + optional ?query/#hash suffix. */
+declare function buildSurfaceUrl(base: string, sub?: string, suffix?: string): string;
+/**
+ * Hook: build a URL relative to the CURRENT surface. Precedence per
+ * resolveSurfaceBase; throws in dev when unresolved (never returns app-root).
+ */
+declare function useSurfaceUrl(): (sub?: string, suffix?: string) => string;
+/** Pure: build a URL for ANOTHER surface (cross-surface, e.g. an overlay opening a page). */
+declare function surfacePathFor(opts: {
+    slug: string;
+    pageId: string;
+    sub?: string;
+    suffix?: string;
+}): string;
+
+export { type AuthenticatedQueryResult, BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, type InsetLease, type ManagedLifecycle, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, SurfaceBaseContext, type SurfaceBaseValue, TemplateContext, type TemplateManifest, type ToolInvoker, type UseMcpUploadOptions, type UseMcpUploadResult, type UseMcpUploadTarget, type ViewComponent, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };

package/dist/platform-react/index.js

@@ -1,7 +1,7 @@
-import { createContext, useEffect, createElement, useContext, useMemo, useRef } from 'react';
+import { createContext, useEffect, useContext, createElement, useMemo, useRef, useState, useCallback } from 'react';
 import { QueryClient, useQuery, useQueries, QueryClientProvider } from '@tanstack/react-query';
 import { definePlatformReactPage, emitNavigation } from '@ethisyscore/components-react';
-import { useMcpTool, usePluginRealtimeSource } from '@ethisyscore/extension-runtime/plugin';
+import { useHostIdentity, useMcpTool, usePluginRealtimeSource, useExtensionRuntimeTransport } from '@ethisyscore/extension-runtime/plugin';
 
 // src/platform-react/definePlatformReactPluginPage.tsx
 var TemplateContext = createContext(null);
@@ -19,6 +19,57 @@ function PluginStyleScope({ id, css }) {
   }, [id, css]);
   return null;
 }
+var SurfaceBaseContext = createContext(void 0);
+function normaliseSlug(value) {
+  return value.trim().toLowerCase();
+}
+function stripTrailingSlash(p) {
+  return p.length > 1 && p.endsWith("/") ? p.slice(0, -1) : p;
+}
+function resolveSurfaceBase(input) {
+  if (input.basePath) {
+    const base = stripTrailingSlash(input.basePath);
+    const cut = base.lastIndexOf("/");
+    const groupRoot = cut > 0 ? base.slice(0, cut) : base;
+    return { base, groupRoot };
+  }
+  const slug = input.extensionGroupCode ? normaliseSlug(input.extensionGroupCode) : "";
+  const pageId = input.pageId ?? "";
+  if (slug && pageId) {
+    const groupRoot = `/extensions/${slug}`;
+    return { base: `${groupRoot}/${pageId}`, groupRoot };
+  }
+  return null;
+}
+function buildSurfaceUrl(base, sub = "", suffix = "") {
+  const b = stripTrailingSlash(base);
+  const s = sub.replace(/^\/+/, "");
+  const path = s ? `${b}/${s}` : b;
+  return suffix ? `${path}${suffix}` : path;
+}
+function useSurfaceUrl() {
+  const ctx = useContext(SurfaceBaseContext);
+  const identity = useHostIdentity();
+  return (sub = "", suffix = "") => {
+    const resolved = resolveSurfaceBase({
+      basePath: ctx?.basePath,
+      pageId: ctx?.pageId,
+      extensionGroupCode: identity?.extensionGroupCode ?? null
+    });
+    if (!resolved) {
+      const msg = "useSurfaceUrl: no surface base \u2014 SurfaceBaseContext (basePath/pageId) and extensionGroupCode are both unavailable. Ensure the page is wrapped by definePlatformReactPluginPage inside the host runtime.";
+      const isDevEnv = typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
+      if (isDevEnv) throw new Error(msg);
+      if (typeof console !== "undefined") console.error(msg);
+      return typeof window !== "undefined" ? window.location.pathname + window.location.search + window.location.hash : "";
+    }
+    return buildSurfaceUrl(resolved.base, sub, suffix);
+  };
+}
+function surfacePathFor(opts) {
+  const base = `/extensions/${normaliseSlug(opts.slug)}/${opts.pageId}`;
+  return buildSurfaceUrl(base, opts.sub ?? "", opts.suffix ?? "");
+}
 
 // src/platform-react/definePlatformReactPluginPage.tsx
 function makeDefaultQueryClient() {
@@ -47,16 +98,20 @@ function definePlatformReactPluginPage(Page, options) {
     const page = createElement(Page, props);
     const body = wrapPage ? wrapPage(page) : page;
     return createElement(
-      QueryClientProvider,
-      { client: queryClient },
+      SurfaceBaseContext.Provider,
+      { value: { basePath: props.basePath, pageId: props.pageId } },
       createElement(
-        TemplateContext.Provider,
-        { value: manifest },
-        createElement(PluginStyleScope, { id: styleId, css }),
+        QueryClientProvider,
+        { client: queryClient },
         createElement(
-          "div",
-          { className: `${EHX_PLUGIN_ROOT_CLASS} ${rootClassName}` },
-          body
+          TemplateContext.Provider,
+          { value: manifest },
+          createElement(PluginStyleScope, { id: styleId, css }),
+          createElement(
+            "div",
+            { className: `${EHX_PLUGIN_ROOT_CLASS} ${rootClassName}` },
+            body
+          )
         )
       )
     );
@@ -219,20 +274,33 @@ function createReactRouterShim(options = {}) {
     };
   }
   function useParams() {
+    const ctx = useContext(SurfaceBaseContext);
+    const identity = useHostIdentity();
+    const resolved = resolveSurfaceBase({
+      basePath: ctx?.basePath,
+      pageId: ctx?.pageId,
+      extensionGroupCode: identity?.extensionGroupCode ?? null
+    });
     const path = typeof window !== "undefined" ? window.location.pathname : "";
     if (routes != null && routes.length > 0) {
       const matched = matchRouteParams(path, routes, basePath);
-      if (matched != null) {
-        return matched;
+      if (matched != null) return matched;
+    }
+    const pathNoQuery = path.split(/[?#]/)[0];
+    let remainder = pathNoQuery;
+    if (resolved) {
+      for (const prefix of [resolved.base, resolved.groupRoot].sort((a, b) => b.length - a.length)) {
+        if (pathNoQuery === prefix || pathNoQuery.startsWith(prefix + "/")) {
+          remainder = pathNoQuery.slice(prefix.length);
+          break;
+        }
       }
     }
-    const segments = path.split("/").filter(Boolean);
+    const segments = remainder.split("/").filter(Boolean);
     const last = segments[segments.length - 1];
     const params = {};
     if (last) {
-      for (const key of paramKeys) {
-        params[key] = last;
-      }
+      for (const key of paramKeys) params[key] = last;
     }
     return params;
   }
@@ -285,6 +353,84 @@ function usePluginRealtime(typeCode, handler) {
     return source.subscribe(typeCode, (payload) => ref.current(payload));
   }, [source, typeCode]);
 }
+var DEFAULT_MAX_UPLOAD_BYTES = 30 * 1024 * 1024;
+function useMcpUpload(opts) {
+  const transport = useExtensionRuntimeTransport(opts?.transport);
+  const maxSizeBytes = opts?.maxSizeBytes ?? DEFAULT_MAX_UPLOAD_BYTES;
+  const [progress, setProgress] = useState(0);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(void 0);
+  const controllerRef = useRef(null);
+  const mountedRef = useRef(true);
+  useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+      controllerRef.current?.abort();
+    };
+  }, []);
+  const upload = useCallback(
+    async (file, target) => {
+      const controller = new AbortController();
+      controllerRef.current?.abort();
+      controllerRef.current = controller;
+      const applyState = (fn) => {
+        if (mountedRef.current && !controller.signal.aborted) {
+          fn();
+        }
+      };
+      applyState(() => {
+        setLoading(true);
+        setError(void 0);
+        setProgress(0);
+      });
+      try {
+        if (typeof transport.uploadDocument !== "function") {
+          throw new Error(
+            "The active McpTransport does not support binary uploads (no `uploadDocument`). The host runtime / transport must implement the upload capability for useMcpUpload to work."
+          );
+        }
+        const uploadDocument = transport.uploadDocument.bind(transport);
+        const size = file.size;
+        if (size > maxSizeBytes) {
+          throw new Error(
+            `File is ${size} bytes, which exceeds the ${maxSizeBytes}-byte upload limit.`
+          );
+        }
+        const buffer = await file.arrayBuffer();
+        applyState(() => setProgress(0.1));
+        const maybeName = file.name;
+        const fileName = typeof maybeName === "string" && maybeName.length > 0 ? maybeName : "upload.bin";
+        const contentType = file.type && file.type.length > 0 ? file.type : "application/octet-stream";
+        const meta = {
+          moduleKey: target.moduleKey,
+          entityName: target.entityName,
+          entityId: target.entityId,
+          category: target.category,
+          fileName,
+          contentType,
+          sizeBytes: buffer.byteLength
+        };
+        const result = await uploadDocument(meta, buffer, controller.signal);
+        applyState(() => {
+          setProgress(1);
+          setLoading(false);
+        });
+        return result;
+      } catch (err) {
+        const wrapped = err instanceof Error ? err : new Error(String(err));
+        applyState(() => {
+          setError(wrapped);
+          setLoading(false);
+          setProgress(0);
+        });
+        throw wrapped;
+      }
+    },
+    [transport, maxSizeBytes]
+  );
+  return { upload, progress, loading, error };
+}
 var OVERLAY_HOST_CONTRACT_VERSION = "1.0.0";
 var OverlayHostContext = createContext(null);
 function useOverlayHost() {
@@ -367,6 +513,6 @@ function useManagedLifecycle() {
   return lifecycle;
 }
 
-export { BaseMcpService, EHX_PLUGIN_ROOT_CLASS, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, OverlayHostContext, PluginStyleScope, TemplateContext, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, notViaMcp, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useOverlayHost, usePluginRealtime, useToolInvoker, useToolInvokerMap, useView };
+export { BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, EHX_PLUGIN_ROOT_CLASS, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, OverlayHostContext, PluginStyleScope, SurfaceBaseContext, TemplateContext, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map