@womp/mcp-ui 0.1.15 → 0.1.16

package/src/shared/bridge.ts

@@ -232,3 +232,44 @@ export function toggleFullscreen(app: App) {
     if (res?.mode) document.documentElement.dataset.displayMode = res.mode;
   });
 }
+
+/** What ChatGPT's own `window.openai` adds for things MCP Apps has no message for. */
+interface OpenAiBridge {
+  openExternal?: (args: { href: string; redirectUrl?: false }) => unknown;
+  sendFollowUpMessage?: (args: { prompt: string }) => unknown;
+}
+const openAiBridge = () => (window as Window & { openai?: OpenAiBridge }).openai;
+
+/**
+ * Open a page outside the chat, such as a checkout. ChatGPT opens a URL on one
+ * of the card's declared redirect domains (`openai/widgetCSP.redirect_domains`)
+ * without making the user confirm the link, but only through its own
+ * `openExternal`; every other host gets the standard `ui/open-link`.
+ * `redirectUrl: false` stops ChatGPT adding a query parameter of its own.
+ */
+export async function openExternal(app: App, url: string) {
+  const bridge = openAiBridge();
+  if (bridge?.openExternal) {
+    await bridge.openExternal({ href: url, redirectUrl: false });
+    return;
+  }
+  await app.openLink({ url });
+}
+
+/**
+ * Post a message in the chat as the user, for a button that stands for
+ * something they would otherwise type ("Order it"): the model answers it like
+ * any other turn. False when the host takes no messages from a card.
+ */
+export async function sendChatMessage(app: App, text: string): Promise<boolean> {
+  if ((app.getHostCapabilities() as { message?: unknown } | undefined)?.message) {
+    const res = await app.sendMessage({ role: "user", content: [{ type: "text", text }] });
+    return !res.isError;
+  }
+  const bridge = openAiBridge();
+  if (bridge?.sendFollowUpMessage) {
+    await bridge.sendFollowUpMessage({ prompt: text });
+    return true;
+  }
+  return false;
+}