@ethisyscore/extension-runtime 1.115.0 → 1.116.0

package/dist/{bridge-client-DzRcKIJT.d.cts → bridge-client-D0fogVGd.d.cts}

@@ -1,4 +1,4 @@
-import { d as BridgePushThemeEnvelope, c as BridgePushLocaleEnvelope, b as BridgePushDensityEnvelope, a as BridgePushA11yEnvelope, B as BridgeNavPushEnvelope, e as BridgeSessionTokenPushEnvelope } from './bridge-envelopes-DA6vxbyb.cjs';
+import { d as BridgePushThemeEnvelope, c as BridgePushLocaleEnvelope, b as BridgePushDensityEnvelope, a as BridgePushA11yEnvelope, B as BridgeNavPushEnvelope, e as BridgeSessionTokenPushEnvelope } from './bridge-envelopes-DAuew-fU.cjs';
 
 /**
  * Plugin-side bridge client for the host ↔ plugin platform contract

package/dist/{bridge-client-DD99netz.d.ts → bridge-client-tIK_iYT9.d.ts}

@@ -1,4 +1,4 @@
-import { d as BridgePushThemeEnvelope, c as BridgePushLocaleEnvelope, b as BridgePushDensityEnvelope, a as BridgePushA11yEnvelope, B as BridgeNavPushEnvelope, e as BridgeSessionTokenPushEnvelope } from './bridge-envelopes-DA6vxbyb.js';
+import { d as BridgePushThemeEnvelope, c as BridgePushLocaleEnvelope, b as BridgePushDensityEnvelope, a as BridgePushA11yEnvelope, B as BridgeNavPushEnvelope, e as BridgeSessionTokenPushEnvelope } from './bridge-envelopes-DAuew-fU.js';
 
 /**
  * Plugin-side bridge client for the host ↔ plugin platform contract

package/dist/{bridge-envelopes-DA6vxbyb.d.cts → bridge-envelopes-DAuew-fU.d.cts}

@@ -27,6 +27,40 @@ interface McpTransport {
      * Implementations should observe `signal` to abort in-flight work.
      */
     invokeTool<TReq, TRes>(name: string, args: TReq, signal?: AbortSignal): Promise<TRes>;
+    /**
+     * Invoke a canonical OPERATION on a catalogue module, letting the host resolve
+     * which application answers it from the operator's provider selection, and
+     * falling back to `fallbackToolName` when no provider has been chosen.
+     *
+     * **Why this exists alongside {@link invokeTool}.** A plugin surface cannot
+     * reach another extension's tool: the router refuses a surface capability
+     * token for cross-extension tools (EXT_MCP_008), so naming `hr:list-employees`
+     * here does not reach HR — it is refused, and the screen quietly does nothing.
+     * Until this seam existed the only remedy was a hand-written proxy tool per
+     * call site, owned by the calling plugin and forwarding server-side. That
+     * works and does not scale: six artefacts per call, in the plugin's own
+     * repository, multiplied across every plugin that reads another's data.
+     *
+     * Naming the operation instead makes the operator's selection the thing that
+     * decides, exactly as `IPluginModuleOperations.InvokeOrFallbackAsync` does for
+     * a plugin's backend, and keeps the consumer ignorant of which application
+     * answered.
+     *
+     * **Optional capability.** A transport that does not support it simply omits
+     * this member, and {@link "../../plugin-ui" useModuleTool} throws a clear
+     * runtime error when invoked against such a transport. Keeping it optional
+     * makes adding the seam a non-breaking, additive change for existing custom
+     * transports, exactly as `uploadDocument` was.
+     *
+     * @param moduleKey The catalogue module the operation belongs to.
+     * @param operationKey The canonical operation, e.g. `person-directory`.
+     * @param fallbackToolName The tool this call site invoked before it was
+     *   converted, used verbatim while the module is unconfigured. It is the
+     *   DEFAULT provider rather than dead metadata, which is what makes every
+     *   conversion a no-op until an operator chooses something.
+     * @param args Canonical field values, keyed by canonical name.
+     */
+    invokeOperation?<TReq, TRes>(moduleKey: string, operationKey: string, fallbackToolName: string, args: TReq, signal?: AbortSignal): Promise<TRes>;
     /**
      * Upload a binary document to CORE storage via the host shell and resolve
      * the resulting {@link UploadDocumentResult} (a `StoredDocumentId` plus the

package/dist/{bridge-envelopes-DA6vxbyb.d.ts → bridge-envelopes-DAuew-fU.d.ts}

@@ -27,6 +27,40 @@ interface McpTransport {
      * Implementations should observe `signal` to abort in-flight work.
      */
     invokeTool<TReq, TRes>(name: string, args: TReq, signal?: AbortSignal): Promise<TRes>;
+    /**
+     * Invoke a canonical OPERATION on a catalogue module, letting the host resolve
+     * which application answers it from the operator's provider selection, and
+     * falling back to `fallbackToolName` when no provider has been chosen.
+     *
+     * **Why this exists alongside {@link invokeTool}.** A plugin surface cannot
+     * reach another extension's tool: the router refuses a surface capability
+     * token for cross-extension tools (EXT_MCP_008), so naming `hr:list-employees`
+     * here does not reach HR — it is refused, and the screen quietly does nothing.
+     * Until this seam existed the only remedy was a hand-written proxy tool per
+     * call site, owned by the calling plugin and forwarding server-side. That
+     * works and does not scale: six artefacts per call, in the plugin's own
+     * repository, multiplied across every plugin that reads another's data.
+     *
+     * Naming the operation instead makes the operator's selection the thing that
+     * decides, exactly as `IPluginModuleOperations.InvokeOrFallbackAsync` does for
+     * a plugin's backend, and keeps the consumer ignorant of which application
+     * answered.
+     *
+     * **Optional capability.** A transport that does not support it simply omits
+     * this member, and {@link "../../plugin-ui" useModuleTool} throws a clear
+     * runtime error when invoked against such a transport. Keeping it optional
+     * makes adding the seam a non-breaking, additive change for existing custom
+     * transports, exactly as `uploadDocument` was.
+     *
+     * @param moduleKey The catalogue module the operation belongs to.
+     * @param operationKey The canonical operation, e.g. `person-directory`.
+     * @param fallbackToolName The tool this call site invoked before it was
+     *   converted, used verbatim while the module is unconfigured. It is the
+     *   DEFAULT provider rather than dead metadata, which is what makes every
+     *   conversion a no-op until an operator chooses something.
+     * @param args Canonical field values, keyed by canonical name.
+     */
+    invokeOperation?<TReq, TRes>(moduleKey: string, operationKey: string, fallbackToolName: string, args: TReq, signal?: AbortSignal): Promise<TRes>;
     /**
      * Upload a binary document to CORE storage via the host shell and resolve
      * the resulting {@link UploadDocumentResult} (a `StoredDocumentId` plus the

package/dist/host/index.d.cts

@@ -3,12 +3,12 @@ import { C as ComponentRegistry } from '../registry-DpCx_LxF.cjs';
 export { P as PrimitiveProps } from '../registry-DpCx_LxF.cjs';
 import { SduiNode } from '@ethisyscore/protocol';
 export { PrimitiveName, SduiNode } from '@ethisyscore/protocol';
-import { M as McpHttpClient, f as VersionSkew } from '../transport-C4xoMWBE.cjs';
-export { C as CAPABILITY_REJECTION_REASON_HEADER, D as DEFAULT_MAX_CONCURRENT_MCP_REQUESTS, E as EXTENSION_ACTIVE_VERSION_HEADER, a as EXTENSION_VERSION_HEADER, I as InputEventPayload, b as McpHttpRequest, c as McpHttpResponse, d as McpResponseMetadata, e as McpUploadRequest, V as VERSION_MISMATCH_REASON, g as VersionSkewSource, W as WORKER_TRANSPORT_PROTOCOL, h as WorkerCtor, i as WorkerHandshakePayload, j as WorkerLike, k as WorkerRemoteDomTransport, l as WorkerRemoteDomTransportOptions, m as detectVersionSkew } from '../transport-C4xoMWBE.cjs';
+import { M as McpHttpClient, f as VersionSkew } from '../transport-Cjpb_qPo.cjs';
+export { C as CAPABILITY_REJECTION_REASON_HEADER, D as DEFAULT_MAX_CONCURRENT_MCP_REQUESTS, E as EXTENSION_ACTIVE_VERSION_HEADER, a as EXTENSION_VERSION_HEADER, I as InputEventPayload, b as McpHttpRequest, c as McpHttpResponse, d as McpResponseMetadata, e as McpUploadRequest, V as VERSION_MISMATCH_REASON, g as VersionSkewSource, W as WORKER_TRANSPORT_PROTOCOL, h as WorkerCtor, i as WorkerHandshakePayload, j as WorkerLike, k as WorkerRemoteDomTransport, l as WorkerRemoteDomTransportOptions, m as detectVersionSkew } from '../transport-Cjpb_qPo.cjs';
 export { RemoteReceiver, RemoteReceiverComment, RemoteReceiverElement, RemoteReceiverNode, RemoteReceiverParent, RemoteReceiverRoot, RemoteReceiverText } from '@remote-dom/core/receivers';
 export { RemoteComponentRendererMap, RemoteComponentRendererProps, RemoteRootRenderer, RemoteRootRendererProps, createRemoteComponentRenderer } from '@remote-dom/react/host';
 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';
-import '../bridge-envelopes-DA6vxbyb.cjs';
+import '../bridge-envelopes-DAuew-fU.cjs';
 
 /**
  * Resolution context for `var` references. Keys are looked up via dot-path

package/dist/host/index.d.ts

@@ -3,12 +3,12 @@ import { C as ComponentRegistry } from '../registry-DpCx_LxF.js';
 export { P as PrimitiveProps } from '../registry-DpCx_LxF.js';
 import { SduiNode } from '@ethisyscore/protocol';
 export { PrimitiveName, SduiNode } from '@ethisyscore/protocol';
-import { M as McpHttpClient, f as VersionSkew } from '../transport-BuX8gzq1.js';
-export { C as CAPABILITY_REJECTION_REASON_HEADER, D as DEFAULT_MAX_CONCURRENT_MCP_REQUESTS, E as EXTENSION_ACTIVE_VERSION_HEADER, a as EXTENSION_VERSION_HEADER, I as InputEventPayload, b as McpHttpRequest, c as McpHttpResponse, d as McpResponseMetadata, e as McpUploadRequest, V as VERSION_MISMATCH_REASON, g as VersionSkewSource, W as WORKER_TRANSPORT_PROTOCOL, h as WorkerCtor, i as WorkerHandshakePayload, j as WorkerLike, k as WorkerRemoteDomTransport, l as WorkerRemoteDomTransportOptions, m as detectVersionSkew } from '../transport-BuX8gzq1.js';
+import { M as McpHttpClient, f as VersionSkew } from '../transport-B9mwIXYs.js';
+export { C as CAPABILITY_REJECTION_REASON_HEADER, D as DEFAULT_MAX_CONCURRENT_MCP_REQUESTS, E as EXTENSION_ACTIVE_VERSION_HEADER, a as EXTENSION_VERSION_HEADER, I as InputEventPayload, b as McpHttpRequest, c as McpHttpResponse, d as McpResponseMetadata, e as McpUploadRequest, V as VERSION_MISMATCH_REASON, g as VersionSkewSource, W as WORKER_TRANSPORT_PROTOCOL, h as WorkerCtor, i as WorkerHandshakePayload, j as WorkerLike, k as WorkerRemoteDomTransport, l as WorkerRemoteDomTransportOptions, m as detectVersionSkew } from '../transport-B9mwIXYs.js';
 export { RemoteReceiver, RemoteReceiverComment, RemoteReceiverElement, RemoteReceiverNode, RemoteReceiverParent, RemoteReceiverRoot, RemoteReceiverText } from '@remote-dom/core/receivers';
 export { RemoteComponentRendererMap, RemoteComponentRendererProps, RemoteRootRenderer, RemoteRootRendererProps, createRemoteComponentRenderer } from '@remote-dom/react/host';
 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';
-import '../bridge-envelopes-DA6vxbyb.js';
+import '../bridge-envelopes-DAuew-fU.js';
 
 /**
  * Resolution context for `var` references. Keys are looked up via dot-path

package/dist/mock-host/cli.d.cts

@@ -1,6 +1,6 @@
 import { SduiNode } from '@ethisyscore/protocol';
-import { h as WorkerCtor, M as McpHttpClient, k as WorkerRemoteDomTransport } from '../transport-C4xoMWBE.cjs';
-import '../bridge-envelopes-DA6vxbyb.cjs';
+import { h as WorkerCtor, M as McpHttpClient, k as WorkerRemoteDomTransport } from '../transport-Cjpb_qPo.cjs';
+import '../bridge-envelopes-DAuew-fU.cjs';
 
 /**
  * `npx mock-host <dir>` — standalone declarative-mock-host dev server.

package/dist/mock-host/cli.d.ts

@@ -1,6 +1,6 @@
 import { SduiNode } from '@ethisyscore/protocol';
-import { h as WorkerCtor, M as McpHttpClient, k as WorkerRemoteDomTransport } from '../transport-BuX8gzq1.js';
-import '../bridge-envelopes-DA6vxbyb.js';
+import { h as WorkerCtor, M as McpHttpClient, k as WorkerRemoteDomTransport } from '../transport-B9mwIXYs.js';
+import '../bridge-envelopes-DAuew-fU.js';
 
 /**
  * `npx mock-host <dir>` — standalone declarative-mock-host dev server.

package/dist/mock-host/index.d.cts

@@ -1,8 +1,8 @@
 import { ReactNode, ReactElement } from 'react';
 import { C as ComponentRegistry } from '../registry-DpCx_LxF.cjs';
 import { SduiNode } from '@ethisyscore/protocol';
-import { M as McpTransport, U as UploadDocumentMeta, f as UploadDocumentResult } from '../bridge-envelopes-DA6vxbyb.cjs';
-import { P as PortBridgeClient, T as ThemePayload, L as LocalePayload, D as DensityPayload, A as A11yPayload, N as NavPayload, S as SessionTokenPayload } from '../bridge-client-DzRcKIJT.cjs';
+import { M as McpTransport, U as UploadDocumentMeta, f as UploadDocumentResult } from '../bridge-envelopes-DAuew-fU.cjs';
+import { P as PortBridgeClient, T as ThemePayload, L as LocalePayload, D as DensityPayload, A as A11yPayload, N as NavPayload, S as SessionTokenPayload } from '../bridge-client-D0fogVGd.cjs';
 
 /**
  * Handler for a mocked tool invocation. The handler receives the request

package/dist/mock-host/index.d.ts

@@ -1,8 +1,8 @@
 import { ReactNode, ReactElement } from 'react';
 import { C as ComponentRegistry } from '../registry-DpCx_LxF.js';
 import { SduiNode } from '@ethisyscore/protocol';
-import { M as McpTransport, U as UploadDocumentMeta, f as UploadDocumentResult } from '../bridge-envelopes-DA6vxbyb.js';
-import { P as PortBridgeClient, T as ThemePayload, L as LocalePayload, D as DensityPayload, A as A11yPayload, N as NavPayload, S as SessionTokenPayload } from '../bridge-client-DD99netz.js';
+import { M as McpTransport, U as UploadDocumentMeta, f as UploadDocumentResult } from '../bridge-envelopes-DAuew-fU.js';
+import { P as PortBridgeClient, T as ThemePayload, L as LocalePayload, D as DensityPayload, A as A11yPayload, N as NavPayload, S as SessionTokenPayload } from '../bridge-client-tIK_iYT9.js';
 
 /**
  * Handler for a mocked tool invocation. The handler receives the request

package/dist/plugin/index.cjs

@@ -64,6 +64,98 @@ function useOptionalExtensionRuntimeTransport(override) {
   const fromContext = react.useContext(ExtensionRuntimeContext);
   return override ?? fromContext ?? null;
 }
+function useModuleTool(moduleKey, operationKey, fallbackToolName, opts) {
+  const transport = useExtensionRuntimeTransport(opts?.transport);
+  const [loading, setLoading] = react.useState(false);
+  const [error, setError] = react.useState(void 0);
+  const controllerRef = react.useRef(null);
+  const mountedRef = react.useRef(true);
+  react.useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+      controllerRef.current?.abort();
+    };
+  }, []);
+  const invoke = react.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] = react.useState(void 0);
+  const [loading, setLoading] = react.useState(enabled);
+  const [error, setError] = react.useState(void 0);
+  const [tick, setTick] = react.useState(0);
+  const argsKey = JSON.stringify(args);
+  react.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] = react.useState(void 0);
@@ -936,6 +1028,8 @@ exports.useHostIdentity = useHostIdentity;
 exports.useMcpQuery = useMcpQuery;
 exports.useMcpResource = useMcpResource;
 exports.useMcpTool = useMcpTool;
+exports.useModuleQuery = useModuleQuery;
+exports.useModuleTool = useModuleTool;
 exports.useOptionalExtensionRuntimeTransport = useOptionalExtensionRuntimeTransport;
 exports.usePluginRealtimeSource = usePluginRealtimeSource;
 //# sourceMappingURL=index.cjs.map