@ethisyscore/extension-runtime 1.115.0 → 1.116.0

package/dist/plugin/index.d.cts

@@ -1,12 +1,12 @@
-import { M as McpTransport } from '../bridge-envelopes-DA6vxbyb.cjs';
-export { U as UploadDocumentMeta, f as UploadDocumentResult } from '../bridge-envelopes-DA6vxbyb.cjs';
+import { M as McpTransport } from '../bridge-envelopes-DAuew-fU.cjs';
+export { U as UploadDocumentMeta, f as UploadDocumentResult } from '../bridge-envelopes-DAuew-fU.cjs';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { SduiNode, RenderMode } from '@ethisyscore/protocol';
 export { PagedResponse, PaginatedEnvelope } from '@ethisyscore/protocol';
 import { RemoteConnection } from '@remote-dom/core';
-import { P as PortBridgeClient, T as ThemePayload, L as LocalePayload } from '../bridge-client-DzRcKIJT.cjs';
-export { A as A11yPayload, B as BridgePortShim, D as DensityPayload, N as NavPayload, S as SessionTokenPayload, c as createPortBridgeClient } from '../bridge-client-DzRcKIJT.cjs';
+import { P as PortBridgeClient, T as ThemePayload, L as LocalePayload } from '../bridge-client-D0fogVGd.cjs';
+export { A as A11yPayload, B as BridgePortShim, D as DensityPayload, N as NavPayload, S as SessionTokenPayload, c as createPortBridgeClient } from '../bridge-client-D0fogVGd.cjs';
 export { M as MCP_ERROR_CODES, a as McpErrorCode, b as McpToolError, c as classifyHostError, d as classifyHostResponse, i as isMcpErrorCode, e as isMcpToolError, f as isRetryableMcpErrorCode, m as mcpErrorCodeFromHttpStatus } from '../mcp-error-CCZQd8Xl.cjs';
 
 /**
@@ -218,6 +218,78 @@ declare function useExtensionRuntimeTransport(override?: McpTransport): McpTrans
  */
 declare function useOptionalExtensionRuntimeTransport(override?: McpTransport): McpTransport | null;
 
+interface UseModuleToolOptions {
+    /**
+     * Override the transport resolved from {@link ExtensionRuntimeProvider}.
+     * Primarily intended for tests and advanced multi-host scenarios.
+     */
+    transport?: McpTransport;
+}
+interface UseModuleToolResult<TReq, TRes> {
+    /**
+     * Invoke the operation. Each call gets a fresh {@link AbortController} that is
+     * aborted on unmount so unresolved promises cannot keep state alive after the
+     * component is gone.
+     */
+    invoke: (req: TReq) => Promise<TRes>;
+    loading: boolean;
+    error: Error | undefined;
+}
+/**
+ * The cross-application counterpart to {@link useMcpTool}: names a MODULE and an
+ * OPERATION rather than a tool, so the operator's provider selection decides which
+ * application answers.
+ *
+ * **Use this, not {@link useMcpTool}, for another application's data.** A surface
+ * capability token is refused for cross-extension tools (EXT_MCP_008), so naming
+ * `projects:create-client` from a plugin surface does not reach Projects at all;
+ * it is refused and the screen silently does nothing. Naming the operation reaches
+ * whichever application the operator chose, and falls back to `fallbackToolName`
+ * while they have chosen none, which is the state every organisation starts in.
+ *
+ * Keep using {@link useMcpTool} for the plugin's OWN tools. There is no provider to
+ * choose between when the answer can only come from one place, and routing such a
+ * call through a per-organisation lookup is the failure that emptied the onboarding
+ * admin picker for every SDK-hosted plugin.
+ *
+ * `invoke` is a stable reference across renders for the same module, operation,
+ * fallback and transport, making it safe to use inside `useEffect` deps.
+ */
+declare function useModuleTool<TReq, TRes>(moduleKey: string, operationKey: string, fallbackToolName: string, opts?: UseModuleToolOptions): UseModuleToolResult<TReq, TRes>;
+
+interface UseModuleQueryOptions {
+    /**
+     * Gate the fetch on a guard. When false the hook returns idle state and never
+     * invokes, which is how a read that depends on a selection is expressed without
+     * violating the rules of hooks. Defaults to `true`.
+     */
+    enabled?: boolean;
+}
+interface UseModuleQueryResult<TRes> {
+    data: TRes | undefined;
+    loading: boolean;
+    error: Error | undefined;
+    /** Re-run the fetch against the current args. */
+    refetch: () => void;
+}
+/**
+ * The cross-application counterpart to {@link useMcpQuery}: an auto-fetching read that
+ * names a MODULE and an OPERATION, so the operator's provider selection decides which
+ * application answers.
+ *
+ * Use this, not {@link useMcpQuery}, for another application's data. A surface
+ * capability token is refused for cross-extension tools (EXT_MCP_008), so naming
+ * `hr:list-employees` from a plugin surface reaches nothing and the picker renders
+ * empty. Naming the operation reaches the chosen provider, and falls back to
+ * `fallbackToolName` while none is chosen, which is where every organisation starts.
+ *
+ * Keep {@link useMcpQuery} for the plugin's own tools and for platform intrinsics such
+ * as `users:*`: where only one source can answer there is no choice to model, and
+ * routing such a read through a per-organisation lookup is the failure that emptied
+ * the onboarding admin picker for every SDK-hosted plugin.
+ */
+declare function useModuleQuery<TArgs, TRes>(moduleKey: string, operationKey: string, fallbackToolName: string, args: TArgs, options?: UseModuleQueryOptions): UseModuleQueryResult<TRes>;
+
 interface UseMcpResourceOptions {
     /**
      * Override the transport resolved from {@link ExtensionRuntimeProvider}.
@@ -685,4 +757,4 @@ interface UseAuthResult {
  */
 declare function useAuth(transport: McpTransport): UseAuthResult;
 
-export { BridgeClientContext, type ClientPushChannel, ClientPushContext, type ClientPushEvent, type ClientPushSubscribeOptions, type CreatePortMcpTransportOptions, type CreateRemoteRootOptions, type DeclarativePluginConfig, type EthisysPluginConfig, ExtensionRuntimeProvider, type ExtensionRuntimeProviderProps, type HostIdentity, HostIdentityContext, type HostIdentityUser, type HostPermission, type ItemsResponse, LocalePayload, McpTransport, PluginRealtimeContext, type PluginRealtimeSource, PortBridgeClient, type PortShim, type RemoteRoot, ThemePayload, type UseAuthResult, type UseClientPushSubscriptionOptions, type UseFrontendSessionTokenResult, type UseMcpQueryOptions, type UseMcpQueryResult, type UseMcpResourceOptions, type UseMcpResourceResult, type UseMcpToolOptions, type UseMcpToolResult, createPortMcpTransport, createRemoteRoot, decodeJwtPayload, defineDeclarativePlugin, defineEthisysPlugin, unwrapItems, useAuth, useBridgeClient, useBridgeLocale, useBridgeTheme, useClientPushSubscription, useExtensionRuntimeTransport, useFrontendSessionToken, useHostIdentity, useMcpQuery, useMcpResource, useMcpTool, useOptionalExtensionRuntimeTransport, usePluginRealtimeSource };
+export { BridgeClientContext, type ClientPushChannel, ClientPushContext, type ClientPushEvent, type ClientPushSubscribeOptions, type CreatePortMcpTransportOptions, type CreateRemoteRootOptions, type DeclarativePluginConfig, type EthisysPluginConfig, ExtensionRuntimeProvider, type ExtensionRuntimeProviderProps, type HostIdentity, HostIdentityContext, type HostIdentityUser, type HostPermission, type ItemsResponse, LocalePayload, McpTransport, PluginRealtimeContext, type PluginRealtimeSource, PortBridgeClient, type PortShim, type RemoteRoot, ThemePayload, type UseAuthResult, type UseClientPushSubscriptionOptions, type UseFrontendSessionTokenResult, type UseMcpQueryOptions, type UseMcpQueryResult, type UseMcpResourceOptions, type UseMcpResourceResult, type UseMcpToolOptions, type UseMcpToolResult, type UseModuleQueryOptions, type UseModuleQueryResult, type UseModuleToolOptions, type UseModuleToolResult, createPortMcpTransport, createRemoteRoot, decodeJwtPayload, defineDeclarativePlugin, defineEthisysPlugin, unwrapItems, useAuth, useBridgeClient, useBridgeLocale, useBridgeTheme, useClientPushSubscription, useExtensionRuntimeTransport, useFrontendSessionToken, useHostIdentity, useMcpQuery, useMcpResource, useMcpTool, useModuleQuery, useModuleTool, useOptionalExtensionRuntimeTransport, usePluginRealtimeSource };

package/dist/plugin/index.d.ts

@@ -1,12 +1,12 @@
-import { M as McpTransport } from '../bridge-envelopes-DA6vxbyb.js';
-export { U as UploadDocumentMeta, f as UploadDocumentResult } from '../bridge-envelopes-DA6vxbyb.js';
+import { M as McpTransport } from '../bridge-envelopes-DAuew-fU.js';
+export { U as UploadDocumentMeta, f as UploadDocumentResult } from '../bridge-envelopes-DAuew-fU.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { SduiNode, RenderMode } from '@ethisyscore/protocol';
 export { PagedResponse, PaginatedEnvelope } from '@ethisyscore/protocol';
 import { RemoteConnection } from '@remote-dom/core';
-import { P as PortBridgeClient, T as ThemePayload, L as LocalePayload } from '../bridge-client-DD99netz.js';
-export { A as A11yPayload, B as BridgePortShim, D as DensityPayload, N as NavPayload, S as SessionTokenPayload, c as createPortBridgeClient } from '../bridge-client-DD99netz.js';
+import { P as PortBridgeClient, T as ThemePayload, L as LocalePayload } from '../bridge-client-tIK_iYT9.js';
+export { A as A11yPayload, B as BridgePortShim, D as DensityPayload, N as NavPayload, S as SessionTokenPayload, c as createPortBridgeClient } from '../bridge-client-tIK_iYT9.js';
 export { M as MCP_ERROR_CODES, a as McpErrorCode, b as McpToolError, c as classifyHostError, d as classifyHostResponse, i as isMcpErrorCode, e as isMcpToolError, f as isRetryableMcpErrorCode, m as mcpErrorCodeFromHttpStatus } from '../mcp-error-CCZQd8Xl.js';
 
 /**
@@ -218,6 +218,78 @@ declare function useExtensionRuntimeTransport(override?: McpTransport): McpTrans
  */
 declare function useOptionalExtensionRuntimeTransport(override?: McpTransport): McpTransport | null;
 
+interface UseModuleToolOptions {
+    /**
+     * Override the transport resolved from {@link ExtensionRuntimeProvider}.
+     * Primarily intended for tests and advanced multi-host scenarios.
+     */
+    transport?: McpTransport;
+}
+interface UseModuleToolResult<TReq, TRes> {
+    /**
+     * Invoke the operation. Each call gets a fresh {@link AbortController} that is
+     * aborted on unmount so unresolved promises cannot keep state alive after the
+     * component is gone.
+     */
+    invoke: (req: TReq) => Promise<TRes>;
+    loading: boolean;
+    error: Error | undefined;
+}
+/**
+ * The cross-application counterpart to {@link useMcpTool}: names a MODULE and an
+ * OPERATION rather than a tool, so the operator's provider selection decides which
+ * application answers.
+ *
+ * **Use this, not {@link useMcpTool}, for another application's data.** A surface
+ * capability token is refused for cross-extension tools (EXT_MCP_008), so naming
+ * `projects:create-client` from a plugin surface does not reach Projects at all;
+ * it is refused and the screen silently does nothing. Naming the operation reaches
+ * whichever application the operator chose, and falls back to `fallbackToolName`
+ * while they have chosen none, which is the state every organisation starts in.
+ *
+ * Keep using {@link useMcpTool} for the plugin's OWN tools. There is no provider to
+ * choose between when the answer can only come from one place, and routing such a
+ * call through a per-organisation lookup is the failure that emptied the onboarding
+ * admin picker for every SDK-hosted plugin.
+ *
+ * `invoke` is a stable reference across renders for the same module, operation,
+ * fallback and transport, making it safe to use inside `useEffect` deps.
+ */
+declare function useModuleTool<TReq, TRes>(moduleKey: string, operationKey: string, fallbackToolName: string, opts?: UseModuleToolOptions): UseModuleToolResult<TReq, TRes>;
+
+interface UseModuleQueryOptions {
+    /**
+     * Gate the fetch on a guard. When false the hook returns idle state and never
+     * invokes, which is how a read that depends on a selection is expressed without
+     * violating the rules of hooks. Defaults to `true`.
+     */
+    enabled?: boolean;
+}
+interface UseModuleQueryResult<TRes> {
+    data: TRes | undefined;
+    loading: boolean;
+    error: Error | undefined;
+    /** Re-run the fetch against the current args. */
+    refetch: () => void;
+}
+/**
+ * The cross-application counterpart to {@link useMcpQuery}: an auto-fetching read that
+ * names a MODULE and an OPERATION, so the operator's provider selection decides which
+ * application answers.
+ *
+ * Use this, not {@link useMcpQuery}, for another application's data. A surface
+ * capability token is refused for cross-extension tools (EXT_MCP_008), so naming
+ * `hr:list-employees` from a plugin surface reaches nothing and the picker renders
+ * empty. Naming the operation reaches the chosen provider, and falls back to
+ * `fallbackToolName` while none is chosen, which is where every organisation starts.
+ *
+ * Keep {@link useMcpQuery} for the plugin's own tools and for platform intrinsics such
+ * as `users:*`: where only one source can answer there is no choice to model, and
+ * routing such a read through a per-organisation lookup is the failure that emptied
+ * the onboarding admin picker for every SDK-hosted plugin.
+ */
+declare function useModuleQuery<TArgs, TRes>(moduleKey: string, operationKey: string, fallbackToolName: string, args: TArgs, options?: UseModuleQueryOptions): UseModuleQueryResult<TRes>;
+
 interface UseMcpResourceOptions {
     /**
      * Override the transport resolved from {@link ExtensionRuntimeProvider}.
@@ -685,4 +757,4 @@ interface UseAuthResult {
  */
 declare function useAuth(transport: McpTransport): UseAuthResult;
 
-export { BridgeClientContext, type ClientPushChannel, ClientPushContext, type ClientPushEvent, type ClientPushSubscribeOptions, type CreatePortMcpTransportOptions, type CreateRemoteRootOptions, type DeclarativePluginConfig, type EthisysPluginConfig, ExtensionRuntimeProvider, type ExtensionRuntimeProviderProps, type HostIdentity, HostIdentityContext, type HostIdentityUser, type HostPermission, type ItemsResponse, LocalePayload, McpTransport, PluginRealtimeContext, type PluginRealtimeSource, PortBridgeClient, type PortShim, type RemoteRoot, ThemePayload, type UseAuthResult, type UseClientPushSubscriptionOptions, type UseFrontendSessionTokenResult, type UseMcpQueryOptions, type UseMcpQueryResult, type UseMcpResourceOptions, type UseMcpResourceResult, type UseMcpToolOptions, type UseMcpToolResult, createPortMcpTransport, createRemoteRoot, decodeJwtPayload, defineDeclarativePlugin, defineEthisysPlugin, unwrapItems, useAuth, useBridgeClient, useBridgeLocale, useBridgeTheme, useClientPushSubscription, useExtensionRuntimeTransport, useFrontendSessionToken, useHostIdentity, useMcpQuery, useMcpResource, useMcpTool, useOptionalExtensionRuntimeTransport, usePluginRealtimeSource };
+export { BridgeClientContext, type ClientPushChannel, ClientPushContext, type ClientPushEvent, type ClientPushSubscribeOptions, type CreatePortMcpTransportOptions, type CreateRemoteRootOptions, type DeclarativePluginConfig, type EthisysPluginConfig, ExtensionRuntimeProvider, type ExtensionRuntimeProviderProps, type HostIdentity, HostIdentityContext, type HostIdentityUser, type HostPermission, type ItemsResponse, LocalePayload, McpTransport, PluginRealtimeContext, type PluginRealtimeSource, PortBridgeClient, type PortShim, type RemoteRoot, ThemePayload, type UseAuthResult, type UseClientPushSubscriptionOptions, type UseFrontendSessionTokenResult, type UseMcpQueryOptions, type UseMcpQueryResult, type UseMcpResourceOptions, type UseMcpResourceResult, type UseMcpToolOptions, type UseMcpToolResult, type UseModuleQueryOptions, type UseModuleQueryResult, type UseModuleToolOptions, type UseModuleToolResult, createPortMcpTransport, createRemoteRoot, decodeJwtPayload, defineDeclarativePlugin, defineEthisysPlugin, unwrapItems, useAuth, useBridgeClient, useBridgeLocale, useBridgeTheme, useClientPushSubscription, useExtensionRuntimeTransport, useFrontendSessionToken, useHostIdentity, useMcpQuery, useMcpResource, useMcpTool, useModuleQuery, useModuleTool, useOptionalExtensionRuntimeTransport, usePluginRealtimeSource };

package/dist/plugin/index.js

@@ -58,6 +58,98 @@ function useOptionalExtensionRuntimeTransport(override) {
   const fromContext = useContext(ExtensionRuntimeContext);
   return override ?? fromContext ?? null;
 }
+function useModuleTool(moduleKey, operationKey, fallbackToolName, opts) {
+  const transport = useExtensionRuntimeTransport(opts?.transport);
+  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 invoke = useCallback(
+    async (req) => {
+      const controller = new AbortController();
+      controllerRef.current?.abort();
+      controllerRef.current = controller;
+      setLoading(true);
+      setError(void 0);
+      try {
+        const invokeOperation = transport.invokeOperation;
+        if (typeof invokeOperation !== "function") {
+          throw new Error(
+            `This host's MCP transport does not support module operations, so ${moduleKey}/${operationKey} cannot be resolved to a provider. Upgrade the host, or call the plugin's own proxy tool with useMcpTool instead.`
+          );
+        }
+        const result = await invokeOperation.call(
+          transport,
+          moduleKey,
+          operationKey,
+          fallbackToolName,
+          req,
+          controller.signal
+        );
+        if (mountedRef.current && !controller.signal.aborted) {
+          setLoading(false);
+        }
+        return result;
+      } catch (err) {
+        const wrapped = err instanceof Error ? err : new Error(String(err));
+        if (mountedRef.current && !controller.signal.aborted) {
+          setError(wrapped);
+          setLoading(false);
+        }
+        throw wrapped;
+      }
+    },
+    [transport, moduleKey, operationKey, fallbackToolName]
+  );
+  return { invoke, loading, error };
+}
+function useModuleQuery(moduleKey, operationKey, fallbackToolName, args, options) {
+  const enabled = options?.enabled ?? true;
+  const { invoke } = useModuleTool(moduleKey, operationKey, fallbackToolName);
+  const [data, setData] = useState(void 0);
+  const [loading, setLoading] = useState(enabled);
+  const [error, setError] = useState(void 0);
+  const [tick, setTick] = useState(0);
+  const argsKey = JSON.stringify(args);
+  useEffect(() => {
+    if (!enabled) {
+      setLoading(false);
+      return;
+    }
+    let cancelled = false;
+    setLoading(true);
+    invoke(args).then((result) => {
+      if (cancelled) {
+        return;
+      }
+      setData(result);
+      setError(void 0);
+      setLoading(false);
+    }).catch((err) => {
+      if (cancelled) {
+        return;
+      }
+      setError(err instanceof Error ? err : new Error(String(err)));
+      setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [argsKey, tick, invoke, enabled]);
+  return {
+    data,
+    loading,
+    error,
+    refetch: () => setTick((t) => t + 1)
+  };
+}
 function useMcpResource(uri, opts) {
   const transport = useExtensionRuntimeTransport(opts?.transport);
   const [data, setData] = useState(void 0);
@@ -899,6 +991,6 @@ function useAuth(transport) {
   };
 }
 
-export { BridgeClientContext, ClientPushContext, ExtensionRuntimeProvider, HostIdentityContext, MCP_ERROR_CODES, McpToolError, PluginRealtimeContext, classifyHostError, classifyHostResponse, createPortBridgeClient, createPortMcpTransport, createRemoteRoot, decodeJwtPayload, defineDeclarativePlugin, defineEthisysPlugin, isMcpErrorCode, isMcpToolError, isRetryableMcpErrorCode, mcpErrorCodeFromHttpStatus, unwrapItems, useAuth, useBridgeClient, useBridgeLocale, useBridgeTheme, useClientPushSubscription, useExtensionRuntimeTransport, useFrontendSessionToken, useHostIdentity, useMcpQuery, useMcpResource, useMcpTool, useOptionalExtensionRuntimeTransport, usePluginRealtimeSource };
+export { BridgeClientContext, ClientPushContext, ExtensionRuntimeProvider, HostIdentityContext, MCP_ERROR_CODES, McpToolError, PluginRealtimeContext, classifyHostError, classifyHostResponse, createPortBridgeClient, createPortMcpTransport, createRemoteRoot, decodeJwtPayload, defineDeclarativePlugin, defineEthisysPlugin, isMcpErrorCode, isMcpToolError, isRetryableMcpErrorCode, mcpErrorCodeFromHttpStatus, unwrapItems, useAuth, useBridgeClient, useBridgeLocale, useBridgeTheme, useClientPushSubscription, useExtensionRuntimeTransport, useFrontendSessionToken, useHostIdentity, useMcpQuery, useMcpResource, useMcpTool, useModuleQuery, useModuleTool, useOptionalExtensionRuntimeTransport, usePluginRealtimeSource };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map