@womp/mcp-ui 0.1.3 → 0.1.5

package/src/shared/bridge.ts

@@ -69,6 +69,13 @@ export interface CardHooks {
   onResult: (data: GenerationResult) => void;
   /** Called when a poll gives up. */
   onTimeout?: () => void;
+  /**
+   * Called with the tool call's ARGUMENTS when the host announces the input
+   * (before any result exists). This is how a configurator card starts on the
+   * settings the model was asked for — "print it in resin-clear at 15cm" seeds
+   * the controls before the first quote lands.
+   */
+  onInput?: (args: Record<string, unknown>) => void;
 }
 
 export interface Card {
@@ -148,7 +155,10 @@ export function createCard(name: string, hooks: CardHooks): Card {
   };
 
   // Before connect(), always.
-  app.ontoolinput = () => hooks.onResult({ status: "running" });
+  app.ontoolinput = (params) => {
+    hooks.onInput?.(((params as any)?.arguments as Record<string, unknown>) || {});
+    hooks.onResult({ status: "running" });
+  };
   app.ontoolresult = (params) => handle(params?.structuredContent as GenerationResult);
   app.onhostcontextchanged = (ctx) => {
     if (ctx?.theme) applyDocumentTheme(ctx.theme);
@@ -181,6 +191,17 @@ export function openLink(app: App, url: string) {
   return app.openLink({ url });
 }
 
+/**
+ * Call a server tool through the host. Only works for tools that declare
+ * `visibility: ["model", "app"]` — the host refuses everything else, which is
+ * the security boundary keeping credit-spending tools out of widget reach.
+ * Returns the raw result; callers check `isError` themselves because an error
+ * here is normal UI state (bad material, mesh gone), not an exception.
+ */
+export async function callTool(app: App, name: string, args: Record<string, unknown>) {
+  return app.request({ method: "tools/call", params: { name, arguments: args } }, CallToolResultSchema);
+}
+
 /** Toggle fullscreen, trusting the host's answer over our request. */
 export function toggleFullscreen(app: App) {
   const isFull = document.documentElement.dataset.displayMode === "fullscreen";