@opengeni/react 3.5.1-canary.0 → 3.7.0-canary.1

package/dist/interaction.js

@@ -7,7 +7,7 @@ import {
   useBrowserSession,
   useBrowserSessions,
   useSiteAuthConnections
-} from "./chunk-W2RGYBCV.js";
+} from "./chunk-24M4YBCL.js";
 import {
   ComputerViewer,
   useComputerFrameStream,
@@ -21,6 +21,7 @@ import {
 import "./chunk-4MDLEHXL.js";
 import "./chunk-5YK2ZDIG.js";
 import "./chunk-JVYQRRC4.js";
+import "./chunk-PLYRL5ER.js";
 import "./chunk-KZ73RL76.js";
 import {
   useEmbeddedBrowserInteraction,
@@ -28,7 +29,6 @@ import {
   useEmbeddedInteraction,
   useEmbeddedInterventions
 } from "./chunk-NEXLLTP4.js";
-import "./chunk-VTOREEXF.js";
 import "./chunk-22KP6LR5.js";
 
 // src/hooks/use-network-routes.ts

package/dist/lib/format.d.ts

@@ -48,3 +48,8 @@ export declare function isCreditExhaustion(input: {
  * debug surfaces.
  */
 export declare function humanizeFailureReason(reason: string | null): string | null;
+/** Project failure diagnostics without changing the stored event, including legacy retry wrappers. */
+export declare function presentFailure(payload: Record<string, unknown>): {
+    reason: string | null;
+    safetyRefusal: boolean;
+};

package/dist/machines.js

@@ -28,10 +28,11 @@ import {
   healthPulses,
   pointsFor,
   useMachines
-} from "./chunk-YVCHAQZY.js";
+} from "./chunk-ZFOFY5ST.js";
+import "./chunk-PAJU5KKL.js";
+import "./chunk-PLYRL5ER.js";
 import "./chunk-KZ73RL76.js";
 import "./chunk-NEXLLTP4.js";
-import "./chunk-VTOREEXF.js";
 import "./chunk-22KP6LR5.js";
 export {
   CONNECTION_STATUS_META,

package/dist/session-ui.d.ts

@@ -11,6 +11,9 @@ export type { UserMessageBodyProps } from "./components/user-message-body.js";
 export { BUILT_IN_TURN_SUMMARY_FACET_IDS } from "./timeline/turn-summary.js";
 export type { BuiltInTurnSummaryFacetId, TurnSummaryContext, TurnSummaryFacet, TurnSummaryFacetConfiguration, TurnSummaryFacetResult, TurnSummaryOptions, } from "./timeline/turn-summary.js";
 export { QueueSurface } from "./components/queue-surface.js";
+export { SessionConversation } from "./components/session-conversation.js";
+export type { SessionConversationProps } from "./components/session-conversation.js";
 export type { QueueSurfaceProps } from "./components/queue-surface.js";
 export { SessionChrome, sessionChromeGoalPillExplanation, sessionChromeGoalPillLabel, sessionChromeGoalPillState, } from "./components/session-chrome.js";
 export type { SessionChromeAgentsSignal, SessionChromeProps, SessionChromeSignalId, SessionChromeSignalTone, } from "./components/session-chrome.js";
+export { SessionCommandsPanel } from "./components/session-commands-panel.js";

package/dist/session-ui.js

@@ -5,21 +5,29 @@ import {
   MessageTimeline,
   QueueSurface,
   SessionChrome,
+  SessionCommandsPanel,
+  SessionConversation,
   TimelineRow,
   UserMessageBody,
   sessionChromeGoalPillExplanation,
   sessionChromeGoalPillLabel,
   sessionChromeGoalPillState,
   userMessageLikelyNeedsDisclosure
-} from "./chunk-WY3MELVJ.js";
+} from "./chunk-5IXTJTK3.js";
 import "./chunk-W3OUAH6M.js";
+import "./chunk-PAJU5KKL.js";
 import "./chunk-JVYQRRC4.js";
-import "./chunk-7EAFGICR.js";
+import "./chunk-INGB2N5R.js";
+import "./chunk-4JFUT22W.js";
 import "./chunk-VZTQ73XT.js";
 import {
   createOlderHistoryLoadReceipt
-} from "./chunk-TJFMMDQU.js";
-import "./chunk-VTOREEXF.js";
+} from "./chunk-MOWYEBCQ.js";
+import "./chunk-IOLVN74D.js";
+import "./chunk-PLYRL5ER.js";
+import "./chunk-KZ73RL76.js";
+import "./chunk-NEXLLTP4.js";
+import "./chunk-WMGF4Z7X.js";
 import "./chunk-22KP6LR5.js";
 export {
   BUILT_IN_TURN_SUMMARY_FACET_IDS,
@@ -28,6 +36,8 @@ export {
   MessageTimeline,
   QueueSurface,
   SessionChrome,
+  SessionCommandsPanel,
+  SessionConversation,
   TimelineRow,
   UserMessageBody,
   createOlderHistoryLoadReceipt,

package/dist/session.js

@@ -2,22 +2,33 @@ import {
   approvalsFromRequiresAction,
   createEmbeddedSessionClient,
   isGoalEvent,
-  isHumanInputEvent,
   isLineageRefreshEvent,
   isSessionMcpApprovalPolicyEvent,
-  isTitleEvent,
-  isTurnQueueEvent,
   projectPendingApprovals,
   useFileAttachments,
   useGoal,
+  useSessionControl,
+  useSessionLineage,
+  useSessionMcpApprovalPolicy
+} from "./chunk-5PQJOCX5.js";
+import {
+  buildTimeline,
+  createOlderHistoryLoadReceipt,
+  creditExhaustedFromEvents,
+  extractSessionRef,
+  groupTimeline,
+  humanInputRequestFromEvent,
+  isHumanInputEvent,
+  isTitleEvent,
+  isTurnQueueEvent,
+  projectPendingHumanInputRequests,
+  sessionStatusFromEvents,
+  toolDisplayName,
   useHumanInputRequests,
   useSession,
-  useSessionControl,
   useSessionEvents,
-  useSessionLineage,
-  useSessionMcpApprovalPolicy,
   useTurnQueue
-} from "./chunk-IB27C53Y.js";
+} from "./chunk-MOWYEBCQ.js";
 import {
   FILE_ONLY_MESSAGE_TEXT,
   composeSendInput,
@@ -25,20 +36,9 @@ import {
   shouldSubmitOnKey,
   useComposer
 } from "./chunk-IOLVN74D.js";
+import "./chunk-PLYRL5ER.js";
 import "./chunk-KZ73RL76.js";
 import "./chunk-NEXLLTP4.js";
-import {
-  buildTimeline,
-  createOlderHistoryLoadReceipt,
-  creditExhaustedFromEvents,
-  extractSessionRef,
-  groupTimeline,
-  humanInputRequestFromEvent,
-  projectPendingHumanInputRequests,
-  sessionStatusFromEvents,
-  toolDisplayName
-} from "./chunk-TJFMMDQU.js";
-import "./chunk-VTOREEXF.js";
 export {
   FILE_ONLY_MESSAGE_TEXT,
   approvalsFromRequiresAction,

package/dist/timeline/registry.d.ts

@@ -22,6 +22,8 @@ export type ToolRegistryEntry = {
     match: "name";
     name: string;
     render: ToolRenderer;
+    /** Disable untrusted `<server>__${name}` leaf matching for identity-sensitive renderers. */
+    matchPrefixedLeaf?: boolean | undefined;
 };
 export type ToolRegistry = {
     /** Resolve the renderer for a call (never null — falls back to generic). */

package/dist/timeline/types.d.ts

@@ -228,7 +228,7 @@ export type FleetDecisionItem = {
     policyVersion: "adaptive-shadow-v1";
     actualOutcome: "selected" | "waiting" | "none";
     actualCandidateKey: string | null;
-    actualReason: "lease_reused" | "pin" | "rotation" | "active" | "all_capped" | "none";
+    actualReason: "lease_reused" | "pin" | "rotation" | "active" | "all_capped" | "allocator_disabled" | "none";
     shadowOutcome: "selected" | "paced" | "none";
     shadowCandidateKey: string | null;
     shadowReason: "fenced_in_flight" | "fenced_candidate_missing" | "admission_paced" | "no_eligible_candidate" | "overlay_isolated_empty" | "best_score" | "affinity_best" | "hysteresis_hold";
@@ -263,6 +263,8 @@ export type NoticeItem = {
     id: string;
     tone: "waiting" | "cancelled" | "failed" | "input";
     text: string;
+    /** A preserved turn-end outcome, not a claim about current session state. */
+    recordedOutcome?: true;
     /** Optional evidence kept inspectable without overwhelming the main rail. */
     details?: {
         label: string;
@@ -293,7 +295,7 @@ export type ContextCompactionItem = {
 };
 export type MachineInputMember = {
     id: string;
-    kind: "scheduled_occurrence" | "goal_continuation" | "agent_message" | "agent_steer_instruction" | "child_terminal_result" | "media_generation_result" | "child_requires_action" | "child_requires_action_resolved" | "child_paused" | "child_waiting_capacity" | "child_progress";
+    kind: "scheduled_occurrence" | "goal_continuation" | "background_command_result" | "session_wait_timeout" | "agent_message" | "agent_steer_instruction" | "child_terminal_result" | "media_generation_result" | "child_requires_action" | "child_requires_action_resolved" | "child_paused" | "child_waiting_capacity" | "child_progress";
     classification: "success" | "failure" | "action_required" | "info";
     sourceId: string;
     summary: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/react",
-  "version": "3.5.1-canary.0",
+  "version": "3.7.0-canary.1",
   "description": "React hooks and styled components for OpenGeni: live session streaming, chat composer, message timeline, session status, and fleet views — token-themed (CSS variables), dark-first, built on Tailwind v4 + Radix + Motion.",
   "license": "Apache-2.0",
   "repository": {
@@ -120,7 +120,7 @@
     "@dnd-kit/utilities": "3.2.2",
     "@fontsource-variable/noto-sans-arabic": "5.2.10",
     "@fontsource-variable/noto-sans-jp": "5.2.10",
-    "@opengeni/sdk": "^3.5.1-canary.0",
+    "@opengeni/sdk": "^3.7.0-canary.1",
     "clsx": "^2.1.1",
     "dequal": "2.0.3",
     "lucide-react": "^1.8.0",

package/src/artifacts.ts

@@ -18,6 +18,8 @@ export {
   PresentationProjectionEditor,
   PublishedHtmlArtifactFrame,
   PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX,
+  openGeniSiteBridgePortFromBootstrap,
+  publishedHtmlArtifactDocument,
   SpreadsheetArtifactSurface,
   SpreadsheetGrid,
   SpreadsheetProjectionGrid,
@@ -62,6 +64,7 @@ export {
   type PresentationProjectionConnector,
   type PresentationProjectionEditorProps,
   type PublishedHtmlArtifactFrameProps,
+  type PublishedHtmlArtifactToolBridge,
   type PresentationProjectionElementMetadata,
   type PresentationProjectionElement,
   type PresentationProjectionFill,

package/src/client.ts

@@ -246,7 +246,8 @@ export type EmbeddedSessionLineageClientLike = EmbeddedSessionEventClientLike &
   Pick<OpenGeniClient, "getSessionLineage">;
 
 /** Exact client surface required by {@link useFileAttachments}. */
-export type EmbeddedFileAttachmentClientLike = Pick<OpenGeniClient, "uploadFile">;
+export type EmbeddedFileAttachmentClientLike = Pick<OpenGeniClient, "uploadFile"> &
+  Partial<Pick<OpenGeniClient, "createFileDownloadUrl">>;
 
 /** Exact client surface required by structured human-input hooks. */
 export type EmbeddedHumanInputSessionClientLike = EmbeddedSessionEventClientLike &

package/src/components/artifacts/index.ts

@@ -6,7 +6,10 @@ export {
 export {
   PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX,
   PublishedHtmlArtifactFrame,
+  openGeniSiteBridgePortFromBootstrap,
+  publishedHtmlArtifactDocument,
   type PublishedHtmlArtifactFrameProps,
+  type PublishedHtmlArtifactToolBridge,
 } from "./published-html-artifact-frame";
 export {
   SpreadsheetArtifactSurface,

package/src/components/artifacts/published-html-artifact-frame.tsx

@@ -1,4 +1,24 @@
-import type { CSSProperties } from "react";
+import {
+  OPENGENI_SITE_BRIDGE_BOOTSTRAP_GLOBAL,
+  OPENGENI_SITE_BRIDGE_READY,
+  OPENGENI_SITE_BRIDGE_RESPONSE,
+  OPENGENI_SITE_BRIDGE_VERSION,
+  isOpenGeniSiteBridgeCancelMessage,
+  isOpenGeniSiteBridgeConnectMessage,
+  isOpenGeniSiteBridgeRequestMessage,
+  sanitizeOpenGeniSiteToolCallRequest,
+  isSiteHttpRequest,
+  serveSiteHttp,
+  type SiteHttpRequest,
+  type OpenGeniSiteBridgeResponseMessage,
+  type OpenGeniSiteToolCatalog,
+} from "@opengeni/sdk/site";
+import type {
+  ToolGatewayCallRequest,
+  ToolGatewayCallResponse,
+  ToolGatewayDeclarationsResponse,
+} from "@opengeni/sdk";
+import { useEffect, useRef, type CSSProperties } from "react";
 
 export const PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX = [
   "allow-downloads",
@@ -17,22 +37,305 @@ export type PublishedHtmlArtifactFrameProps = {
   title: string;
   className?: string;
   style?: CSSProperties;
+  toolBridge?: PublishedHtmlArtifactToolBridge;
 };
 
+export type PublishedHtmlArtifactToolBridge = {
+  fetch?: (request: SiteHttpRequest, signal: AbortSignal) => Promise<Response>;
+  catalog: (options: { signal: AbortSignal }) => Promise<OpenGeniSiteToolCatalog>;
+  call: (
+    request: ToolGatewayCallRequest,
+    options: { signal: AbortSignal },
+  ) => Promise<ToolGatewayCallResponse>;
+  declarations?: (options: { signal: AbortSignal }) => Promise<ToolGatewayDeclarationsResponse>;
+};
+
+const SITE_BRIDGE_BOOTSTRAP_SCRIPT = `<script>(()=>{const key=${JSON.stringify(
+  OPENGENI_SITE_BRIDGE_BOOTSTRAP_GLOBAL,
+)};const parentWindow=window.parent;if(parentWindow===window)return;window.addEventListener("message",event=>{const data=event.data;if(event.source!==parentWindow||!data||data.type!==${JSON.stringify(
+  OPENGENI_SITE_BRIDGE_READY,
+)}||data.version!==${OPENGENI_SITE_BRIDGE_VERSION}||event.ports.length!==1)return;const port=event.ports[0];const previous=window[key]?.port;if(previous&&previous!==port)previous.close();Object.defineProperty(window,key,{configurable:true,value:{port}});port.start();});})();</script>`;
+
+export function publishedHtmlArtifactDocument(html: string, toolBridgeEnabled: boolean): string {
+  if (!toolBridgeEnabled) return html;
+  const doctypeEnd = leadingDoctypeEnd(html);
+  if (doctypeEnd >= 0) {
+    return `${html.slice(0, doctypeEnd + 1)}${SITE_BRIDGE_BOOTSTRAP_SCRIPT}${html.slice(doctypeEnd + 1)}`;
+  }
+  return `${SITE_BRIDGE_BOOTSTRAP_SCRIPT}${html}`;
+}
+
+function leadingDoctypeEnd(html: string): number {
+  const lower = html.toLowerCase();
+  let cursor = html.charCodeAt(0) === 0xfeff ? 1 : 0;
+  while (cursor < html.length) {
+    while (/\s/.test(html[cursor] ?? "")) cursor += 1;
+    if (!html.startsWith("<!--", cursor)) break;
+    const commentEnd = html.indexOf("-->", cursor + 4);
+    if (commentEnd < 0) return -1;
+    cursor = commentEnd + 3;
+  }
+  if (!lower.startsWith("<!doctype", cursor)) return -1;
+  return html.indexOf(">", cursor + 9);
+}
+
 /**
  * Render exact published HTML in an opaque-origin iframe. Artifact scripts,
- * external resources, forms, popups, and downloads work without granting
- * parent-origin authority, shared cookies/storage, or top-level navigation.
+ * external resources, forms, popups, downloads, and the host-filtered tool
+ * bridge work without granting parent-origin authority, shared cookies/storage,
+ * or top-level navigation.
  */
 export function PublishedHtmlArtifactFrame(props: PublishedHtmlArtifactFrameProps) {
+  const frameRef = useRef<HTMLIFrameElement | null>(null);
+  const bridgeRef = useRef(props.toolBridge);
+  const onFrameLoadRef = useRef<() => void>(() => undefined);
+  const frameLoadPendingRef = useRef(false);
+  const toolBridgeEnabled = props.toolBridge !== undefined;
+  useEffect(() => {
+    bridgeRef.current = props.toolBridge;
+  }, [props.toolBridge]);
+  useEffect(() => {
+    if (!toolBridgeEnabled || typeof window === "undefined") return;
+    const requests = new SiteBridgeRequestRegistry();
+    const attachToolPort = (data: unknown, ports: readonly MessagePort[]) => {
+      const port = openGeniSiteBridgePortFromBootstrap(data, ports);
+      if (!port) return;
+      requests.addPort(port);
+      port.addEventListener("message", (portEvent: MessageEvent<unknown>) => {
+        const message = portEvent.data;
+        if (isOpenGeniSiteBridgeCancelMessage(message)) {
+          requests.cancel(port, message.requestId);
+          return;
+        }
+        if (isSiteHttpRequest(message) && portEvent.ports.length === 1) {
+          const controller = requests.start(port, message.requestId);
+          if (!controller) {
+            portEvent.ports[0]!.close();
+            return;
+          }
+          void serveSiteHttp(
+            message,
+            portEvent.ports[0]!,
+            async (request, signal) => {
+              const fetch = bridgeRef.current?.fetch;
+              if (!fetch) throw new Error("This Site host does not support the session SDK");
+              return fetch(request, signal);
+            },
+            controller.signal,
+          ).finally(() => requests.complete(port, message.requestId, controller));
+          return;
+        }
+        if (!isOpenGeniSiteBridgeRequestMessage(message)) return;
+        const controller = requests.start(port, message.requestId);
+        if (!controller) {
+          port.postMessage({
+            type: OPENGENI_SITE_BRIDGE_RESPONSE,
+            version: OPENGENI_SITE_BRIDGE_VERSION,
+            requestId: message.requestId,
+            ok: false,
+            error: {
+              code: "duplicate_request_id",
+              message: "A Site tool request with this id is already running",
+              retryable: false,
+            },
+          } satisfies OpenGeniSiteBridgeResponseMessage);
+          return;
+        }
+        void handleSiteBridgeRequest(bridgeRef.current, message, controller.signal)
+          .then((value) => {
+            if (!controller.signal.aborted) {
+              port.postMessage({
+                type: OPENGENI_SITE_BRIDGE_RESPONSE,
+                version: OPENGENI_SITE_BRIDGE_VERSION,
+                requestId: message.requestId,
+                ok: true,
+                value,
+              } satisfies OpenGeniSiteBridgeResponseMessage);
+            }
+          })
+          .catch((error) => {
+            if (!controller.signal.aborted) {
+              port.postMessage({
+                type: OPENGENI_SITE_BRIDGE_RESPONSE,
+                version: OPENGENI_SITE_BRIDGE_VERSION,
+                requestId: message.requestId,
+                ok: false,
+                error: siteBridgeError(error),
+              } satisfies OpenGeniSiteBridgeResponseMessage);
+            }
+          })
+          .finally(() => requests.complete(port, message.requestId, controller));
+      });
+      port.addEventListener("messageerror", () => requests.closePort(port));
+      port.start();
+      port.postMessage({
+        type: OPENGENI_SITE_BRIDGE_READY,
+        version: OPENGENI_SITE_BRIDGE_VERSION,
+      });
+    };
+    const documentLease = new SiteBridgeDocumentLease(attachToolPort, () => requests.closeAll());
+    const onFrameLoad = () => {
+      frameLoadPendingRef.current = false;
+      const frameWindow = frameRef.current?.contentWindow ?? null;
+      if (!frameWindow) return;
+      documentLease.load(frameWindow);
+    };
+    onFrameLoadRef.current = onFrameLoad;
+    if (frameLoadPendingRef.current) {
+      frameLoadPendingRef.current = false;
+      onFrameLoad();
+    }
+    return () => {
+      onFrameLoadRef.current = () => undefined;
+      documentLease.close();
+    };
+  }, [props.html, toolBridgeEnabled]);
   return (
     <iframe
+      ref={frameRef}
       title={props.title}
       sandbox={PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX}
       referrerPolicy="no-referrer"
-      srcDoc={props.html}
+      srcDoc={publishedHtmlArtifactDocument(props.html, toolBridgeEnabled)}
+      onLoad={() => {
+        frameLoadPendingRef.current = true;
+        onFrameLoadRef.current();
+      }}
       className={props.className}
       style={props.style}
     />
   );
 }
+
+export class SiteBridgeRequestRegistry {
+  private readonly controllersByPort = new Map<MessagePort, Map<string, AbortController>>();
+
+  addPort(port: MessagePort): void {
+    // Several SDK clients may share one document bootstrap. Document teardown,
+    // not another client connecting, revokes all of that document's ports.
+    if (!this.controllersByPort.has(port)) this.controllersByPort.set(port, new Map());
+  }
+
+  start(port: MessagePort, requestId: string): AbortController | null {
+    const controllers = this.controllersByPort.get(port);
+    if (!controllers || controllers.has(requestId)) return null;
+    const controller = new AbortController();
+    controllers.set(requestId, controller);
+    return controller;
+  }
+
+  cancel(port: MessagePort, requestId: string): void {
+    const controllers = this.controllersByPort.get(port);
+    const controller = controllers?.get(requestId);
+    if (!controller) return;
+    controller.abort(new Error("Site tool request cancelled"));
+    controllers!.delete(requestId);
+  }
+
+  complete(port: MessagePort, requestId: string, controller: AbortController): void {
+    const controllers = this.controllersByPort.get(port);
+    if (controllers?.get(requestId) === controller) controllers.delete(requestId);
+  }
+
+  closePort(port: MessagePort): void {
+    const controllers = this.controllersByPort.get(port);
+    if (!controllers) return;
+    for (const controller of controllers.values()) {
+      controller.abort(new Error("Site tool bridge port closed"));
+    }
+    controllers.clear();
+    this.controllersByPort.delete(port);
+    port.close();
+  }
+
+  closeAll(): void {
+    for (const port of [...this.controllersByPort.keys()]) this.closePort(port);
+  }
+}
+
+export class SiteBridgeDocumentLease {
+  private loaded = false;
+  private bootstrapPort: MessagePort | null = null;
+
+  constructor(
+    private readonly attachToolPort: (data: unknown, ports: readonly MessagePort[]) => void,
+    private readonly closeActivePorts: () => void,
+    private readonly createMessageChannel: () => MessageChannel = () => new MessageChannel(),
+  ) {}
+
+  load(frameWindow: Pick<Window, "postMessage">): boolean {
+    if (this.loaded) {
+      this.close();
+      return false;
+    }
+    this.loaded = true;
+    const channel = this.createMessageChannel();
+    this.bootstrapPort = channel.port1;
+    channel.port1.addEventListener("message", (event: MessageEvent<unknown>) => {
+      this.attachToolPort(event.data, event.ports);
+    });
+    channel.port1.start();
+    frameWindow.postMessage(
+      {
+        type: OPENGENI_SITE_BRIDGE_READY,
+        version: OPENGENI_SITE_BRIDGE_VERSION,
+      },
+      "*",
+      [channel.port2],
+    );
+    return true;
+  }
+
+  close(): void {
+    this.bootstrapPort?.close();
+    this.bootstrapPort = null;
+    this.closeActivePorts();
+  }
+}
+
+export function openGeniSiteBridgePortFromBootstrap(
+  data: unknown,
+  ports: readonly MessagePort[],
+): MessagePort | null {
+  if (!isOpenGeniSiteBridgeConnectMessage(data)) return null;
+  return ports.length === 1 ? ports[0]! : null;
+}
+
+async function handleSiteBridgeRequest(
+  bridge: PublishedHtmlArtifactToolBridge | undefined,
+  message: Parameters<typeof isOpenGeniSiteBridgeRequestMessage>[0] & {
+    method: "catalog" | "call" | "declarations";
+    requestId: string;
+    payload?: ToolGatewayCallRequest;
+  },
+  signal: AbortSignal,
+): Promise<OpenGeniSiteToolCatalog | ToolGatewayCallResponse | ToolGatewayDeclarationsResponse> {
+  if (!bridge) throw new Error("Site tool bridge is unavailable");
+  if (message.method === "catalog") return await bridge.catalog({ signal });
+  if (message.method === "declarations") {
+    if (!bridge.declarations) throw new Error("Site tool declarations are unavailable");
+    return await bridge.declarations({ signal });
+  }
+  return await bridge.call(sanitizeOpenGeniSiteToolCallRequest(message.payload!), { signal });
+}
+
+export function siteBridgeError(error: unknown): {
+  code: string;
+  message: string;
+  retryable: boolean;
+  outcomeUnknown: boolean;
+} {
+  const candidate = error as {
+    code?: unknown;
+    message?: unknown;
+    retryable?: unknown;
+    outcomeUnknown?: unknown;
+  };
+  return {
+    code: typeof candidate?.code === "string" ? candidate.code : "site_tool_call_failed",
+    message:
+      typeof candidate?.message === "string" ? candidate.message : "Site tool request failed",
+    retryable: candidate?.retryable === true,
+    outcomeUnknown: candidate?.outcomeUnknown === true,
+  };
+}