@guuey/agent-client 0.2.3 → 0.3.1

package/dist/ggui-render.js

@@ -1,85 +0,0 @@
-import { asGguiRenderBootstrap, gguiShellHtml, MCP_APP_AI_GGUI_RENDER_META_KEY, } from "@ggui-ai/protocol/integrations/mcp-apps";
-import { isJsonObject } from "./block-ui";
-export { asGguiRenderBootstrap, gguiShellHtml, } from "@ggui-ai/protocol/integrations/mcp-apps";
-/**
- * The `_meta` key the ggui render bootstrap rides on. Alias of the
- * protocol package's own constant — one spelling, owned upstream.
- */
-export const GGUI_RENDER_META_KEY = MCP_APP_AI_GGUI_RENDER_META_KEY;
-/** The `ui://` scheme prefix every ggui render resource uri carries. */
-const UI_SCHEME = "ui://";
-/**
- * A tool result's `uiData` (+ its `_meta`, when carried) → a ggui render
- * descriptor, or `undefined` for anything that is not one.
- *
- * The `ui://` scheme gate is deliberate: `uiData` is a general-purpose channel
- * (every `structuredContent` of a `_meta.ui`-stamped tool lands there), so a
- * bare `resourceUri` string is not on its own a claim of generative UI.
- */
-export function asGguiRender(uiData, meta) {
-    if (!isJsonObject(uiData))
-        return undefined;
-    const resourceUri = uiData.resourceUri;
-    if (typeof resourceUri !== "string" || !resourceUri.startsWith(UI_SCHEME))
-        return undefined;
-    const bootstrap = asGguiRenderBootstrap(meta);
-    return {
-        resourceUri,
-        ...(typeof uiData.sessionId === "string" ? { sessionId: uiData.sessionId } : {}),
-        ...(bootstrap ? { bootstrap } : {}),
-    };
-}
-/**
- * A live `tool-result` AgBlock → its ggui render descriptor, if it is one.
- *
- * NOTE: `@ggui-ai/protocol/integrations/mcp-apps` exports a helper of the
- * same name that narrows a spec-canonical MCP `CallToolResult` instead. This
- * one is the silverprotocol-side twin — the input is the FOLDED block, whose
- * `uiData`/`_meta` carriage is `@silverprotocol/core`'s contract, not ggui's.
- */
-export function toolResultGguiRender(block) {
-    return asGguiRender(block.uiData, block._meta);
-}
-/** An untyped (persisted-snapshot) block → its ggui render descriptor, if it is one. */
-export function blockGguiRender(block) {
-    if (!isJsonObject(block))
-        return undefined;
-    if (block.type !== "tool-result")
-        return undefined;
-    return asGguiRender(block.uiData, block._meta);
-}
-/**
- * A ggui render descriptor → the mountable resource the host's existing
- * mcp-ui path already knows how to mount, or `undefined` when the descriptor
- * carries no bootstrap (history cards, and any fold that dropped `_meta`).
- *
- * The `uri` is the render's REAL `resourceUri` — the shell is the payload, not
- * a renaming of the resource.
- *
- * The shell is built `background: 'transparent'`: every guuey host that
- * mounts through this adapter (widget, portal web, Studio) draws its own
- * card chrome around the iframe, so the host page composits behind the card.
- * The upstream default (`'surface'`) is for standalone served documents —
- * see `GguiShellHtmlOptions` in `@ggui-ai/protocol/integrations/mcp-apps`.
- *
- * **On `_meta` being required to MOUNT (but never to RECOGNISE).** Recognition
- * — "this tool result is a ggui card" — is keyed on `uiData.resourceUri` alone
- * and never waits for anything (see {@link asGguiRender}); nothing in this
- * package is blocked on an upstream change. Mounting is different, and the
- * requirement is ggui's, not ours: its runtime rejects a slice without
- * `runtimeUrl` AND without at least one mode discriminator (`wsUrl`+`wsToken`,
- * `codeUrl`, or `kind`) as `MALFORMED_BOOTSTRAP` and renders nothing. `uiData`
- * carries none of those fields, so a bootstrap-less descriptor could only ever
- * produce a blank frame; returning `undefined` and letting the host show its
- * own placeholder is the honest answer, not a deferral. `@silverprotocol/core`'s
- * `Reducer` is what puts `_meta` on the block for a live turn, in-repo, today.
- */
-export function gguiRenderResource(render) {
-    if (!render.bootstrap)
-        return undefined;
-    return {
-        uri: render.resourceUri,
-        mimeType: "text/html",
-        text: gguiShellHtml(render.bootstrap, { background: "transparent" }),
-    };
-}

package/src/block-ui.ts

@@ -1,212 +0,0 @@
-/**
- * Pure block-walk / resource-narrowing helpers for a block-preserving agent
- * transcript — no React, no DOM, so the narrowing logic stays unit-testable in
- * isolation (this package's vitest runs a `node` environment) and can be shared
- * by every host renderer (Studio's `AgentBlocks`, Portal-web's agent chat).
- *
- * The pod's AgJSON wire carries generative-UI payloads on `tool.done` events,
- * which the reducer folds onto `tool-result` blocks. Two channels reach us:
- *
- *  1. **`uiData`** — the MCP-Apps *surface* channel. The pod's Claude facet
- *     routes a tool result's `structuredContent` here when the server stamped
- *     `_meta.ui`. Any resource here is intended as UI.
- *  2. **`provider-raw` content blocks** — an MCP embedded `resource` content
- *     part does NOT survive as a first-class `resource` AgBlock in the Claude
- *     facet; it degrades to `{ type:'provider-raw', vendor, raw:<part> }`. So a
- *     `ui://` resource can be hiding inside `provider-raw.raw` and must be
- *     scanned for defensively.
- *
- * The resource-narrowing (opaque `JsonValue` → typed payload) mirrors the
- * proven `create-agentic-app` web template — structural validation, never a cast.
- */
-import type { AgBlock, AgMessage, JsonValue } from "@silverprotocol/core";
-import type { HistoryCard } from "./types";
-
-/** A narrowed MCP embedded UI resource (the `_meta.ui.resource` shape). */
-export interface McpUiResourcePayload {
-  uri: string;
-  mimeType?: string;
-  text?: string;
-  blob?: string;
-}
-
-/** Narrow an opaque `JsonValue` to a plain (non-array) JSON object. */
-export function isJsonObject(v: JsonValue | undefined): v is { [key: string]: JsonValue } {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
-}
-
-/**
- * A JSON object → an MCP UI resource, if it has a `uri` plus renderable
- * payload (`text` or base64 `blob`). Returns `undefined` for anything else.
- */
-export function asResourcePayload(v: JsonValue | undefined): McpUiResourcePayload | undefined {
-  if (!isJsonObject(v)) return undefined;
-  if (typeof v.uri !== "string") return undefined;
-  if (typeof v.text !== "string" && typeof v.blob !== "string") return undefined;
-  return {
-    uri: v.uri,
-    ...(typeof v.mimeType === "string" ? { mimeType: v.mimeType } : {}),
-    ...(typeof v.text === "string" ? { text: v.text } : {}),
-    ...(typeof v.blob === "string" ? { blob: v.blob } : {}),
-  };
-}
-
-/**
- * Does a `tool-result` block's `uiData` carry an MCP embedded UI resource?
- * Accepts the resource inlined directly, or wrapped as `{ resource: {...} }`
- * (the shape an MCP `resource` content part carries). No `ui://` scheme gate
- * here on purpose: `uiData` is the explicit *surface* channel (the server
- * stamped `_meta.ui`), so any resource on it is meant to render.
- */
-export function asUiResource(uiData: JsonValue | undefined): McpUiResourcePayload | undefined {
-  if (!isJsonObject(uiData)) return undefined;
-  const direct = asResourcePayload(uiData);
-  if (direct) return direct;
-  return asResourcePayload(uiData.resource);
-}
-
-/**
- * Scan a `provider-raw` block's `raw` (the vendor tool_result content part)
- * for a *generative-UI* resource. Unlike {@link asUiResource}, this path IS
- * gated on the `ui://` scheme: `provider-raw` degradation is a lossy catch-all,
- * so a plain file/text resource riding it is NOT a UI to mount — only the
- * mcp-ui `ui://` convention is.
- */
-export function scanProviderRawForUiResource(
-  raw: JsonValue | undefined,
-): McpUiResourcePayload | undefined {
-  if (!isJsonObject(raw)) return undefined;
-  const candidate =
-    raw.resource !== undefined ? asResourcePayload(raw.resource) : asResourcePayload(raw);
-  if (!candidate) return undefined;
-  return candidate.uri.startsWith("ui://") ? candidate : undefined;
-}
-
-/**
- * Extract a mountable UI resource from an opaque AgBlock-shaped `JsonValue`
- * (used for persisted card snapshot parts, which arrive untyped). Dispatches
- * by `block.type`:
- *   - `tool-result` → its `uiData` surface channel, then a `ui://` resource
- *     degraded into a `provider-raw` content part — the SAME two channels
- *     the live path ({@link toolResultUiResource}) mounts. The write side
- *     (`nocode-runtime`'s `uiCardArtifactsFromMessages`, guuey#86) persists
- *     card rows for both, so the snapshot arm must mount both or
- *     provider-raw-only cards rehydrate as placeholders.
- *   - `provider-raw` → a `ui://` resource hiding in `raw`
- *   - `resource`     → a first-class embedded resource (gated on `ui://`)
- * Everything else → `undefined`.
- */
-export function blockUiResource(block: JsonValue): McpUiResourcePayload | undefined {
-  if (!isJsonObject(block)) return undefined;
-  switch (block.type) {
-    case "tool-result": {
-      const fromUiData = asUiResource(block.uiData);
-      if (fromUiData) return fromUiData;
-      if (Array.isArray(block.content)) {
-        for (const part of block.content) {
-          if (isJsonObject(part) && part.type === "provider-raw") {
-            const found = scanProviderRawForUiResource(part.raw);
-            if (found) return found;
-          }
-        }
-      }
-      return undefined;
-    }
-    case "provider-raw":
-      return scanProviderRawForUiResource(block.raw);
-    case "resource": {
-      const r = asResourcePayload(block.resource);
-      return r && r.uri.startsWith("ui://") ? r : undefined;
-    }
-    default:
-      return undefined;
-  }
-}
-
-/**
- * A live `tool-result` AgBlock → its mountable UI resource, checking BOTH
- * channels the Claude facet uses:
- *   1. the `uiData` surface channel (server stamped `_meta.ui`), and
- *   2. an embedded `ui://` resource that degraded into a `provider-raw`
- *      content part inside the tool result (MCP `resource` parts do NOT survive
- *      as first-class `resource` AgBlocks here).
- * First-class `resource` content parts are intentionally not scanned in this
- * typed live path (the Claude facet never emits them); the untyped card path
- * ({@link blockUiResource}) covers them for other facets' persisted snapshots.
- */
-export function toolResultUiResource(
-  block: Extract<AgBlock, { type: "tool-result" }>,
-): McpUiResourcePayload | undefined {
-  const fromUiData = asUiResource(block.uiData);
-  if (fromUiData) return fromUiData;
-  for (const part of block.content) {
-    if (part.type === "provider-raw") {
-      const found = scanProviderRawForUiResource(part.raw);
-      if (found) return found;
-    }
-  }
-  return undefined;
-}
-
-/**
- * A persisted `HistoryCard`'s `cardSnapshot` → a mountable UI resource. The
- * snapshot is the verbatim `AgArtifact` the pod stored (`{ parts: AgBlock[] }`),
- * so walk its `parts` for the first block that yields a resource; fall back to
- * treating the snapshot root itself as a block.
- *
- * NOTE (`no-ggui-tools`): a ggui-rendered card carries NO inline HTML resource —
- * its UI rides `_meta.ggui.bootstrap` and mounts via `@ggui-ai/react`'s
- * `McpAppIframe`. That branch is OUT OF SCOPE for v1 (deferred-pending-capture).
- * So a real ggui card resolves to `undefined` here and renders as the host's
- * coherent placeholder, not a broken mount.
- */
-export function cardUiResource(cardSnapshot: JsonValue): McpUiResourcePayload | undefined {
-  if (!isJsonObject(cardSnapshot)) return undefined;
-  const parts = cardSnapshot.parts;
-  if (Array.isArray(parts)) {
-    for (const part of parts) {
-      const found = blockUiResource(part);
-      if (found) return found;
-    }
-  }
-  return blockUiResource(cardSnapshot);
-}
-
-/**
- * The resource's HTML: inline `text` wins; else base64-decode `blob`. `atob`
- * alone yields a Latin-1 string (mojibake on multibyte UTF-8), so decode via
- * bytes + `TextDecoder`. Invalid base64 → `undefined` (no renderable payload).
- */
-export function resourceHtml(resource: McpUiResourcePayload): string | undefined {
-  if (resource.text !== undefined) return resource.text;
-  if (resource.blob !== undefined) {
-    try {
-      return new TextDecoder().decode(Uint8Array.from(atob(resource.blob), (c) => c.charCodeAt(0)));
-    } catch {
-      return undefined;
-    }
-  }
-  return undefined;
-}
-
-/**
- * The tool name for a `tool-result` block, read off its paired `tool-call`
- * block in the same message (the reducer keeps both in one message's content).
- * Falls back to `"tool"` when the pair is missing.
- */
-export function toolNameFor(message: AgMessage, toolCallId: string): string {
-  for (const b of message.content) {
-    if (b.type === "tool-call" && b.toolCallId === toolCallId) return b.name;
-  }
-  return "tool";
-}
-
-/**
- * Persisted cards, ascending by transcript `seq` (stable; input untouched).
- * These are PRIOR-turn cards — they always precede the live fold, so a
- * block-preserving renderer surfaces them first (e.g. under an "Earlier in
- * this conversation" divider).
- */
-export function sortHistoryCards(cards: readonly HistoryCard[]): HistoryCard[] {
-  return [...cards].sort((a, b) => a.seq - b.seq);
-}

package/src/card-mount.ts

@@ -1,101 +0,0 @@
-/**
- * The card-mount dispatcher: ONE narrowing that answers "what, if anything,
- * does this block mount?" across BOTH generative-UI channels a guuey pod
- * emits.
- *
- *   1. **inline mcp-ui resource** — `{uri, text|blob}` on `uiData`, or a
- *      `ui://` resource degraded into a `provider-raw` content part. Handled
- *      verbatim by `block-ui.ts`; this module does not touch that path, it
- *      only tries it FIRST.
- *   2. **ggui render** — `uiData.resourceUri` + the `_meta["ai.ggui/render"]`
- *      bootstrap, mounted through ggui's self-contained shell. See
- *      `ggui-render.ts`.
- *
- * Both channels land on the SAME `McpUiResourcePayload`, which is the whole
- * point: a host that already mounts inline resources through
- * `@mcp-ui/client`'s `AppRenderer` in a second-origin sandbox gains ggui cards
- * without a second mount mechanism, a second iframe contract, or a second
- * security posture to review.
- *
- * Precedence is inline-first and deliberate: an inline resource is the
- * server's explicit, self-sufficient HTML. A ggui render only ever wins when
- * there is no inline resource to prefer, so this dispatcher can never change
- * what an existing inline card renders.
- *
- * ## Why the CHANNEL is returned alongside the resource
- *
- * The payload alone cannot say where it came from — a ggui shell is a string
- * of HTML like any other. But a host has one decision that genuinely depends
- * on the origin of that HTML: WHICH sandbox host page to mount it in. A ggui
- * shell must load ggui's runtime bundle and open its WSS, so it needs a page
- * whose CSP names the ggui origins; an inline card is arbitrary tenant HTML
- * and must keep the self-only page it has always had. Handing back the channel
- * keeps that one narrowing in one place — the alternative was for every host
- * to re-run `toolResultGguiRender` beside this call and ask again.
- */
-import { cardUiResource, toolResultUiResource, type McpUiResourcePayload } from "./block-ui";
-import { blockGguiRender, gguiRenderResource, toolResultGguiRender } from "./ggui-render";
-import type { AgBlock, JsonValue } from "@silverprotocol/core";
-
-/** Which generative-UI channel produced a mount. See this module's header. */
-export type CardMountChannel = "inline" | "ggui";
-
-/** A mountable card: the resource to hand the host, and where it came from. */
-export interface CardMount {
-  /** The payload an mcp-ui host mounts, identical in shape for both channels. */
-  resource: McpUiResourcePayload;
-  /**
-   * `"inline"` — the server's own HTML, untrusted tenant content.
-   * `"ggui"` — a shell that boots the ggui runtime from a platform-pinned
-   * origin, and therefore needs a host page whose CSP allows that origin.
-   */
-  channel: CardMountChannel;
-}
-
-/**
- * A live `tool-result` block → the card to mount, across both channels.
- * `undefined` when the block carries no generative UI at all (or carries a
- * ggui render whose bootstrap did not reach us — see `ggui-render.ts`).
- */
-export function toolResultCardMount(
-  block: Extract<AgBlock, { type: "tool-result" }>,
-): CardMount | undefined {
-  const inline = toolResultUiResource(block);
-  if (inline) return { resource: inline, channel: "inline" };
-  const ggui = toolResultGguiRender(block);
-  const resource = ggui ? gguiRenderResource(ggui) : undefined;
-  return resource ? { resource, channel: "ggui" } : undefined;
-}
-
-/**
- * A persisted `HistoryCard`'s `cardSnapshot` → the card to mount, across both
- * channels.
- *
- * The ggui arm is reached only for a snapshot that stored the render's
- * `_meta`; a bootstrap old enough to have been persisted has an expired
- * `wsToken` anyway, so in practice a ggui history card resolves to `undefined`
- * and the host renders its placeholder — honest, and NOT a broken mount.
- */
-export function cardCardMount(cardSnapshot: JsonValue): CardMount | undefined {
-  const inline = cardUiResource(cardSnapshot);
-  if (inline) return { resource: inline, channel: "inline" };
-  for (const block of snapshotBlocks(cardSnapshot)) {
-    const ggui = blockGguiRender(block);
-    const resource = ggui ? gguiRenderResource(ggui) : undefined;
-    if (resource) return { resource, channel: "ggui" };
-  }
-  return undefined;
-}
-
-/**
- * The blocks to scan inside a card snapshot: the stored `AgArtifact`'s `parts`
- * when present, then the snapshot root itself — exactly `cardUiResource`'s own
- * walk order, so both channels see the same candidates in the same order.
- */
-function snapshotBlocks(cardSnapshot: JsonValue): JsonValue[] {
-  if (typeof cardSnapshot !== "object" || cardSnapshot === null || Array.isArray(cardSnapshot)) {
-    return [];
-  }
-  const parts = cardSnapshot.parts;
-  return Array.isArray(parts) ? [...parts, cardSnapshot] : [cardSnapshot];
-}

package/src/ggui-render.ts

@@ -1,168 +0,0 @@
-/**
- * The **ggui render** channel: narrowing + self-contained shell construction
- * for a generative-UI card produced by the ggui MCP server (`ggui_render`).
- *
- * ## Where the pieces live (guuey#108 / ggui#427)
- *
- * The two halves of this channel have different owners, and the module is
- * split along that line:
- *
- *  - **ggui's wire contract** — what makes a `_meta` slice a mountable
- *    render bootstrap, and what the self-contained shell must contain — is
- *    OWNED by ggui and imported from
- *    `@ggui-ai/protocol/integrations/mcp-apps` ({@link asGguiRenderBootstrap},
- *    {@link gguiShellHtml}, the `ai.ggui/render` key). This package used to
- *    carry byte-compatible private copies (lifted upstream as ggui#427);
- *    re-exporting the originals means a shell-contract change lands here by
- *    bumping the pin, not by mirror-editing two repos.
- *  - **host/silverprotocol shapes** — the `uiData`-keyed RECOGNITION signal,
- *    the `AgBlock` tool-result narrowing, and the `McpUiResourcePayload`
- *    adapter onto the host's existing mcp-ui mount path — are guuey-side
- *    contracts and stay implemented here.
- *
- * ## Why recognition and mounting are separate
- *
- * A ggui render's `tool.done` carries two distinct signals:
- *
- *  1. **`uiData.resourceUri` is the RECOGNITION signal.** It is the only part
- *     of the render's identity that survives `@silverprotocol/core`'s fold
- *     (the reducer copies `uiData` — and, as of `@silverprotocol/core`
- *     0.4.1 (workspace#9), `_meta` — onto the `tool-result` block).
- *  2. **`_meta["ai.ggui/render"]` is the MOUNT MATERIAL.** Everything needed
- *     to boot the card — which runtime bundle to load, which live-channel to
- *     open, which props to seed — lives there and nowhere else.
- *
- * The shell {@link gguiShellHtml} builds is a string of HTML, so the ggui
- * card rides the host's EXISTING mcp-ui mount path unchanged: it narrows to
- * the same `McpUiResourcePayload` an inline resource does, so
- * `@mcp-ui/client`'s `AppRenderer` posts it as `srcdoc` into the
- * second-origin `mcp-app-sandbox.html` page — same double-iframe rule, same
- * sandbox origin, same opaque inner frame. No second mount mechanism.
- *
- * NOT in scope here: rehydrating a ggui card from persisted history. The
- * bootstrap's `wsToken` expires minutes after the render, so a stored
- * bootstrap is dead on arrival — a history card without a live bootstrap
- * correctly resolves to `undefined` and renders the host's placeholder
- * rather than a broken mount.
- */
-import type { AgBlock, JsonValue } from "@silverprotocol/core";
-import {
-  asGguiRenderBootstrap,
-  gguiShellHtml,
-  MCP_APP_AI_GGUI_RENDER_META_KEY,
-  type GguiRenderBootstrap,
-} from "@ggui-ai/protocol/integrations/mcp-apps";
-import { isJsonObject, type McpUiResourcePayload } from "./block-ui";
-
-export {
-  asGguiRenderBootstrap,
-  gguiShellHtml,
-} from "@ggui-ai/protocol/integrations/mcp-apps";
-export type {
-  GguiRenderBootstrap,
-  GguiShellHtmlOptions,
-} from "@ggui-ai/protocol/integrations/mcp-apps";
-
-/**
- * The `_meta` key the ggui render bootstrap rides on. Alias of the
- * protocol package's own constant — one spelling, owned upstream.
- */
-export const GGUI_RENDER_META_KEY = MCP_APP_AI_GGUI_RENDER_META_KEY;
-
-/** The `ui://` scheme prefix every ggui render resource uri carries. */
-const UI_SCHEME = "ui://";
-
-/** A ggui render recognised on a tool result: its resource uri + mount material. */
-export interface GguiRenderDescriptor {
-  /** `uiData.resourceUri` — `ui://ggui/render/<sessionId>/<contractHash>`. */
-  resourceUri: string;
-  /** `uiData.sessionId`, when present. */
-  sessionId?: string;
-  /**
-   * The `_meta["ai.ggui/render"]` slice, when it reached us. Absent for a
-   * persisted history card and for any consumer folding without `fold.ts`'s
-   * `_meta` carriage — such a descriptor is recognised but NOT mountable.
-   */
-  bootstrap?: GguiRenderBootstrap;
-}
-
-/**
- * A tool result's `uiData` (+ its `_meta`, when carried) → a ggui render
- * descriptor, or `undefined` for anything that is not one.
- *
- * The `ui://` scheme gate is deliberate: `uiData` is a general-purpose channel
- * (every `structuredContent` of a `_meta.ui`-stamped tool lands there), so a
- * bare `resourceUri` string is not on its own a claim of generative UI.
- */
-export function asGguiRender(
-  uiData: JsonValue | undefined,
-  meta: JsonValue | undefined,
-): GguiRenderDescriptor | undefined {
-  if (!isJsonObject(uiData)) return undefined;
-  const resourceUri = uiData.resourceUri;
-  if (typeof resourceUri !== "string" || !resourceUri.startsWith(UI_SCHEME)) return undefined;
-  const bootstrap = asGguiRenderBootstrap(meta);
-  return {
-    resourceUri,
-    ...(typeof uiData.sessionId === "string" ? { sessionId: uiData.sessionId } : {}),
-    ...(bootstrap ? { bootstrap } : {}),
-  };
-}
-
-/**
- * A live `tool-result` AgBlock → its ggui render descriptor, if it is one.
- *
- * NOTE: `@ggui-ai/protocol/integrations/mcp-apps` exports a helper of the
- * same name that narrows a spec-canonical MCP `CallToolResult` instead. This
- * one is the silverprotocol-side twin — the input is the FOLDED block, whose
- * `uiData`/`_meta` carriage is `@silverprotocol/core`'s contract, not ggui's.
- */
-export function toolResultGguiRender(
-  block: Extract<AgBlock, { type: "tool-result" }>,
-): GguiRenderDescriptor | undefined {
-  return asGguiRender(block.uiData, block._meta);
-}
-
-/** An untyped (persisted-snapshot) block → its ggui render descriptor, if it is one. */
-export function blockGguiRender(block: JsonValue): GguiRenderDescriptor | undefined {
-  if (!isJsonObject(block)) return undefined;
-  if (block.type !== "tool-result") return undefined;
-  return asGguiRender(block.uiData, block._meta);
-}
-
-/**
- * A ggui render descriptor → the mountable resource the host's existing
- * mcp-ui path already knows how to mount, or `undefined` when the descriptor
- * carries no bootstrap (history cards, and any fold that dropped `_meta`).
- *
- * The `uri` is the render's REAL `resourceUri` — the shell is the payload, not
- * a renaming of the resource.
- *
- * The shell is built `background: 'transparent'`: every guuey host that
- * mounts through this adapter (widget, portal web, Studio) draws its own
- * card chrome around the iframe, so the host page composits behind the card.
- * The upstream default (`'surface'`) is for standalone served documents —
- * see `GguiShellHtmlOptions` in `@ggui-ai/protocol/integrations/mcp-apps`.
- *
- * **On `_meta` being required to MOUNT (but never to RECOGNISE).** Recognition
- * — "this tool result is a ggui card" — is keyed on `uiData.resourceUri` alone
- * and never waits for anything (see {@link asGguiRender}); nothing in this
- * package is blocked on an upstream change. Mounting is different, and the
- * requirement is ggui's, not ours: its runtime rejects a slice without
- * `runtimeUrl` AND without at least one mode discriminator (`wsUrl`+`wsToken`,
- * `codeUrl`, or `kind`) as `MALFORMED_BOOTSTRAP` and renders nothing. `uiData`
- * carries none of those fields, so a bootstrap-less descriptor could only ever
- * produce a blank frame; returning `undefined` and letting the host show its
- * own placeholder is the honest answer, not a deferral. `@silverprotocol/core`'s
- * `Reducer` is what puts `_meta` on the block for a live turn, in-repo, today.
- */
-export function gguiRenderResource(
-  render: GguiRenderDescriptor,
-): McpUiResourcePayload | undefined {
-  if (!render.bootstrap) return undefined;
-  return {
-    uri: render.resourceUri,
-    mimeType: "text/html",
-    text: gguiShellHtml(render.bootstrap, { background: "transparent" }),
-  };
-}