@guuey/agent-client 0.2.2 → 0.3.0

package/dist/history.d.ts

@@ -10,7 +10,7 @@
  * `credentials: "include"`). Consumed by {@link createWebAdapters}; Portal
  * has its own copy today and can migrate onto this later.
  */
-import type { JsonValue } from "@silverprotocol/core";
+import type { AgMessage, JsonValue } from "@silverprotocol/core";
 import type { AgentMessage, HistoryCard, HistoryLoadResult } from "./types";
 /** One row of `GET /v1/threads/:id/messages`. */
 export interface ThreadHistoryRow {
@@ -71,4 +71,17 @@ export interface ThreadHistoryFetchOptions {
  * the chat empty.
  */
 export declare function fetchThreadHistory({ baseUrl, threadId, requestInit, includeCards, fetchImpl, }: ThreadHistoryFetchOptions): Promise<HistoryLoadResult>;
+/**
+ * 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 declare function toolNameFor(message: AgMessage, toolCallId: string): string;
+/**
+ * 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 declare function sortHistoryCards(cards: readonly HistoryCard[]): HistoryCard[];
 //# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5E,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CACjC;AAOD;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,SAA6B;CAIjD;AAeD,qEAAqE;AACrE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,YAAY,EAAE,CAOpF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE,CAOhF;AAED,MAAM,WAAW,yBAAyB;IACxC,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,OAAO,EACP,QAAQ,EACR,WAAW,EACX,YAAoB,EACpB,SAAiB,GAClB,EAAE,yBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuBxD"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5E,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CACjC;AAOD;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,SAA6B;CAIjD;AAeD,qEAAqE;AACrE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,YAAY,EAAE,CAOpF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE,CAOhF;AAED,MAAM,WAAW,yBAAyB;IACxC,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,OAAO,EACP,QAAQ,EACR,WAAW,EACX,YAAoB,EACpB,SAAiB,GAClB,EAAE,yBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuBxD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAE7E"}

package/dist/history.js

@@ -81,3 +81,24 @@ export async function fetchThreadHistory({ baseUrl, threadId, requestInit, inclu
         ...(includeCards ? { cards: threadHistoryRowsToCards(rows) } : {}),
     };
 }
+/**
+ * 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, toolCallId) {
+    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) {
+    return [...cards].sort((a, b) => a.seq - b.seq);
+}

package/dist/index.d.ts

@@ -1,11 +1,9 @@
 export { parseSseEvents, extractAssistantText, reduceAssistantText, stringField, parseConsentRequest, parseLinkRequest, type ParsedSseEvent, } from "./sse";
 export { dismissLinkPrompt } from "./link-prompt";
-export { createWebAdapters, localStorageThreadStore, webGenerateId, fetchStreamTransport, AgentResponseError, type CreateWebAdaptersOptions, } from "./web-adapters";
+export { createUiResourceReader, type CreateUiResourceReaderOptions, type ResolvedUiResourceMount, createWebAdapters, localStorageThreadStore, webGenerateId, fetchStreamTransport, AgentResponseError, type CreateWebAdaptersOptions, } from "./web-adapters";
 export { fetchThreadHistory, threadHistoryRowsToMessages, threadHistoryRowsToCards, HistoryUnauthorizedError, type ThreadHistoryRow, type ThreadHistoryFetchOptions, } from "./history";
 export { ingestMessageFrame } from "./blocks";
-export { asResourcePayload, asUiResource, blockUiResource, cardUiResource, isJsonObject, resourceHtml, scanProviderRawForUiResource, sortHistoryCards, toolNameFor, toolResultUiResource, type McpUiResourcePayload, } from "./block-ui";
-export { asGguiRender, asGguiRenderBootstrap, blockGguiRender, gguiRenderResource, gguiShellHtml, toolResultGguiRender, GGUI_RENDER_META_KEY, type GguiRenderBootstrap, type GguiRenderDescriptor, } from "./ggui-render";
-export { cardCardMount, toolResultCardMount, type CardMount, type CardMountChannel, } from "./card-mount";
+export { sortHistoryCards, toolNameFor } from "./history";
 export type { AgEvent, AgReduceResult, AgMessage, AgBlock } from "@silverprotocol/core";
 export type { AgentMessage, HistoryCard, ProfileConsentRequest, ProfileLinkRequest, ThreadIdStore, GenerateId, InvokeRequest, InvokeTransport, AgentInvokeAdapters, AgentInvokeHistoryAdapter, AgentInvokeStatus, HistoryLoadResult, UseAgentInvokeOptions, UseAgentInvokeReturn, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,cAAc,GACpB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,4BAA4B,EAC5B,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AAItB,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACxF,YAAY,EACV,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,cAAc,GACpB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAK9C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI1D,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACxF,YAAY,EACV,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,13 +1,10 @@
 export { parseSseEvents, extractAssistantText, reduceAssistantText, stringField, parseConsentRequest, parseLinkRequest, } from "./sse";
 export { dismissLinkPrompt } from "./link-prompt";
-export { createWebAdapters, localStorageThreadStore, webGenerateId, fetchStreamTransport, AgentResponseError, } from "./web-adapters";
+export { createUiResourceReader, createWebAdapters, localStorageThreadStore, webGenerateId, fetchStreamTransport, AgentResponseError, } from "./web-adapters";
 export { fetchThreadHistory, threadHistoryRowsToMessages, threadHistoryRowsToCards, HistoryUnauthorizedError, } from "./history";
 export { ingestMessageFrame } from "./blocks";
 // Pure block-walk / resource-narrowing helpers for a block-preserving renderer
 // (shared by Studio's `AgentBlocks` and Portal-web's agent chat). React-free.
-export { asResourcePayload, asUiResource, blockUiResource, cardUiResource, isJsonObject, resourceHtml, scanProviderRawForUiResource, sortHistoryCards, toolNameFor, toolResultUiResource, } from "./block-ui";
-// The ggui render channel (`uiData.resourceUri` + the `_meta["ai.ggui/render"]`
-// bootstrap) and the dispatcher that mounts EITHER channel through the same
-// second-origin sandbox path.
-export { asGguiRender, asGguiRenderBootstrap, blockGguiRender, gguiRenderResource, gguiShellHtml, toolResultGguiRender, GGUI_RENDER_META_KEY, } from "./ggui-render";
-export { cardCardMount, toolResultCardMount, } from "./card-mount";
+// Transcript labeling/ordering helpers (mount narrowing itself moved to
+// @guuey/mcp-apps-host — the SEP-1865 Host role package; import it directly).
+export { sortHistoryCards, toolNameFor } from "./history";

package/dist/sse.d.ts

@@ -22,6 +22,11 @@ export declare function parseSseEvents(buffer: string): {
  * messages APPEND (streaming). The success `result` message carries the SAME
  * final text, so it REPLACES rather than appends — otherwise the answer renders
  * twice. The result is also the fallback for result-only turns.
+ *
+ * Block boundaries become paragraph breaks: a silver `text.start` frame (and,
+ * on the bypass arm, each new `assistant` message) opens a new block, so the
+ * separator lands exactly there — never per `text.delta`, which must stay a
+ * raw append for streaming (#91).
  */
 export declare function reduceAssistantText(current: string, data: unknown): string;
 /**

package/dist/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqBzF;AAUD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAM1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAgC1D;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI1E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,GAAG,IAAI,CAO/E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAOzE"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqBzF;AAsBD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAU1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAmC1D;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI1E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,GAAG,IAAI,CAO/E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAOzE"}

package/dist/sse.js

@@ -34,23 +34,49 @@ export function parseSseEvents(buffer) {
     }
     return { events, rest };
 }
+function frameType(data) {
+    if (typeof data !== "object" || data === null)
+        return undefined;
+    return data.type;
+}
 function isResultMessage(data) {
-    return (typeof data === "object" &&
-        data !== null &&
-        data.type === "result");
+    return frameType(data) === "result";
+}
+/**
+ * Join point where a NEW text block begins: distinct blocks are distinct
+ * paragraphs on the flat text surface (guuey#98 — raw concatenation rendered
+ * "…instead.Here's your packing…"). Idempotent so an empty block between two
+ * boundaries never stacks separators.
+ */
+function withBlockBreak(current) {
+    if (!current || current.endsWith("\n\n"))
+        return current;
+    return current + "\n\n";
 }
 /**
  * Fold one `message` SSE payload into the running assistant text. `assistant`
  * messages APPEND (streaming). The success `result` message carries the SAME
  * final text, so it REPLACES rather than appends — otherwise the answer renders
  * twice. The result is also the fallback for result-only turns.
+ *
+ * Block boundaries become paragraph breaks: a silver `text.start` frame (and,
+ * on the bypass arm, each new `assistant` message) opens a new block, so the
+ * separator lands exactly there — never per `text.delta`, which must stay a
+ * raw append for streaming (#91).
  */
 export function reduceAssistantText(current, data) {
     if (isResultMessage(data)) {
         const result = extractAssistantText(data);
         return result || current;
     }
-    return current + extractAssistantText(data);
+    if (frameType(data) === "text.start")
+        return withBlockBreak(current);
+    const text = extractAssistantText(data);
+    if (!text)
+        return current;
+    if (frameType(data) === "assistant")
+        return withBlockBreak(current) + text;
+    return current + text;
 }
 /**
  * Best-effort assistant text from one `message` payload — BOTH protocols:
@@ -79,13 +105,16 @@ export function extractAssistantText(data) {
         if (typeof message === "object" && message !== null && "content" in message) {
             const content = message.content;
             if (Array.isArray(content)) {
+                // Distinct text blocks are distinct paragraphs (guuey#98) — same
+                // block-boundary contract as the silver arm's text.start handling.
                 return content
                     .filter((b) => typeof b === "object" &&
                     b !== null &&
                     b.type === "text" &&
                     typeof b.text === "string")
                     .map((b) => b.text)
-                    .join("");
+                    .filter((t) => t.length > 0)
+                    .join("\n\n");
             }
         }
         return "";

package/dist/web-adapters.d.ts

@@ -120,4 +120,52 @@ export interface CreateWebAdaptersOptions {
  * cookie-only, history-less bundle.
  */
 export declare function createWebAdapters(opts?: CreateWebAdaptersOptions): AgentInvokeAdapters;
+/** Options for {@link createUiResourceReader} — same credential surface as the history adapter. */
+export interface CreateUiResourceReaderOptions {
+    /** The guuey public API base (`…/v1`). */
+    apiBaseUrl: string;
+    /** The thread whose persisted locators this reader may resolve. */
+    threadId: string;
+    /** Signed-in bearer — wins over the guest secret (same rule as the transport). */
+    getAccessToken?: (opts?: {
+        forceRefresh?: boolean;
+    }) => Promise<string | null>;
+    /** Caller-owned anonymous guest secret (widget / guest chat). */
+    guestSecret?: string | null;
+    /** Injectable for tests. */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Build a `@guuey/mcp-apps-host` `UiResourceReader` over guuey's
+ * authenticated resources/read proxy (guuey#122 Gap 1:
+ * `GET /v1/threads/:threadId/ui-resource?uri=…`).
+ *
+ * The proxy owns EVERYTHING trust-shaped: caller identity (the same three
+ * families as the history read), thread ownership, the locator-to-thread
+ * scope guard, and the per-user federation mint. This reader only carries
+ * the surface's existing credential and maps EVERY non-OK — 401/403/404/502
+ * alike — to `undefined`: deny is byte-identical to a miss, and a miss
+ * renders the host's placeholder, never an error surface.
+ *
+ * Channel resolution is the phase-1 heuristic: a `ui://ggui/…` uri mounts in
+ * the ggui-CSP sandbox page (`channel: "ggui"`), anything else in the
+ * self-only page (`channel: "inline"`). Phase 2 (per-resource declared-CSP
+ * construction from the response `_meta.ui.csp`) retires the heuristic —
+ * conformance map, retirement step 3.
+ */
+/**
+ * The mount the reader resolves — structurally assignable to
+ * `@guuey/mcp-apps-host`'s `ViewMount` mountable arms (typed inline so this
+ * package carries no dependency on the host package; hosts that consume
+ * both see one structural type).
+ */
+export interface ResolvedUiResourceMount {
+    channel: "inline" | "ggui";
+    resource: {
+        uri: string;
+        mimeType?: string;
+        text: string;
+    };
+}
+export declare function createUiResourceReader(options: CreateUiResourceReaderOptions): (resourceUri: string) => Promise<ResolvedUiResourceMount | undefined>;
 //# sourceMappingURL=web-adapters.d.ts.map

package/dist/web-adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-adapters.d.ts","sourceRoot":"","sources":["../src/web-adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EAEb,aAAa,EACd,MAAM,SAAS,CAAC;AAGjB;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;gBAFtB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,YAAA;CAKzB;AAED,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,EAAE,aAiBrC,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAwCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAuB,oBAAoB,CACzC,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B,cAAc,CAAC,MAAM,CAAC,CA4CxB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,GAAE,wBAA6B,GAClC,mBAAmB,CAwErB"}
+{"version":3,"file":"web-adapters.d.ts","sourceRoot":"","sources":["../src/web-adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EAEb,aAAa,EACd,MAAM,SAAS,CAAC;AAGjB;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;gBAFtB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,YAAA;CAKzB;AAED,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,EAAE,aAiBrC,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAwCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAuB,oBAAoB,CACzC,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B,cAAc,CAAC,MAAM,CAAC,CA4CxB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,GAAE,wBAA6B,GAClC,mBAAmB,CAwErB;AAED,mGAAmG;AACnG,MAAM,WAAW,6BAA6B;IAC5C,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,cAAc,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/E,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAkDvE"}

package/dist/web-adapters.js

@@ -227,3 +227,60 @@ export function createWebAdapters(opts = {}) {
     }
     return adapters;
 }
+export function createUiResourceReader(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    return async (resourceUri) => {
+        const headers = {};
+        const token = options.getAccessToken ? await options.getAccessToken() : null;
+        const guest = sendableGuestSecret(options.guestSecret);
+        if (token) {
+            headers["authorization"] = `Bearer ${token}`;
+        }
+        else if (guest) {
+            headers[GUEST_HEADER] = guest;
+        }
+        const requestUrl = `${options.apiBaseUrl}/threads/${encodeURIComponent(options.threadId)}/ui-resource?uri=${encodeURIComponent(resourceUri)}`;
+        let res;
+        try {
+            res = await fetchImpl(requestUrl, { headers });
+        }
+        catch {
+            return undefined; // transport failure == miss == placeholder
+        }
+        // One forceRefresh retry on 401 with a bearer in play — the same
+        // expired-but-refreshable recovery the history adapter performs;
+        // without it a stale token degrades to a permanent placeholder.
+        if (res.status === 401 && options.getAccessToken) {
+            const fresh = await options.getAccessToken({ forceRefresh: true }).catch(() => null);
+            if (fresh) {
+                try {
+                    res = await fetchImpl(requestUrl, {
+                        headers: { ...headers, authorization: `Bearer ${fresh}` },
+                    });
+                }
+                catch {
+                    return undefined;
+                }
+            }
+        }
+        if (!res.ok)
+            return undefined;
+        let body;
+        try {
+            body = (await res.json());
+        }
+        catch {
+            return undefined;
+        }
+        if (typeof body.uri !== "string" || typeof body.text !== "string")
+            return undefined;
+        return {
+            channel: resourceUri.startsWith("ui://ggui/") ? "ggui" : "inline",
+            resource: {
+                uri: body.uri,
+                ...(typeof body.mimeType === "string" ? { mimeType: body.mimeType } : {}),
+                text: body.text,
+            },
+        };
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guuey/agent-client",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Client SDK for Guuey's agent runtime: the `useAgentInvoke` React hook + pure SSE helpers that speak the /agent/invoke streaming contract, plus the paginated thread-history read plane. Host adapters (storage / id / transport) are injected, so it runs on web (Next) and React Native alike.",
   "license": "MIT",
   "type": "module",

package/src/history.ts

@@ -10,7 +10,7 @@
  * `credentials: "include"`). Consumed by {@link createWebAdapters}; Portal
  * has its own copy today and can migrate onto this later.
  */
-import type { JsonValue } from "@silverprotocol/core";
+import type { AgMessage, JsonValue } from "@silverprotocol/core";
 import type { AgentMessage, HistoryCard, HistoryLoadResult } from "./types";
 
 /** One row of `GET /v1/threads/:id/messages`. */
@@ -141,3 +141,25 @@ export async function fetchThreadHistory({
     ...(includeCards ? { cards: threadHistoryRowsToCards(rows) } : {}),
   };
 }
+
+/**
+ * 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/index.ts

@@ -9,6 +9,9 @@ export {
 } from "./sse";
 export { dismissLinkPrompt } from "./link-prompt";
 export {
+  createUiResourceReader,
+  type CreateUiResourceReaderOptions,
+  type ResolvedUiResourceMount,
   createWebAdapters,
   localStorageThreadStore,
   webGenerateId,
@@ -27,39 +30,9 @@ export {
 export { ingestMessageFrame } from "./blocks";
 // Pure block-walk / resource-narrowing helpers for a block-preserving renderer
 // (shared by Studio's `AgentBlocks` and Portal-web's agent chat). React-free.
-export {
-  asResourcePayload,
-  asUiResource,
-  blockUiResource,
-  cardUiResource,
-  isJsonObject,
-  resourceHtml,
-  scanProviderRawForUiResource,
-  sortHistoryCards,
-  toolNameFor,
-  toolResultUiResource,
-  type McpUiResourcePayload,
-} from "./block-ui";
-// The ggui render channel (`uiData.resourceUri` + the `_meta["ai.ggui/render"]`
-// bootstrap) and the dispatcher that mounts EITHER channel through the same
-// second-origin sandbox path.
-export {
-  asGguiRender,
-  asGguiRenderBootstrap,
-  blockGguiRender,
-  gguiRenderResource,
-  gguiShellHtml,
-  toolResultGguiRender,
-  GGUI_RENDER_META_KEY,
-  type GguiRenderBootstrap,
-  type GguiRenderDescriptor,
-} from "./ggui-render";
-export {
-  cardCardMount,
-  toolResultCardMount,
-  type CardMount,
-  type CardMountChannel,
-} from "./card-mount";
+// Transcript labeling/ordering helpers (mount narrowing itself moved to
+// @guuey/mcp-apps-host — the SEP-1865 Host role package; import it directly).
+export { sortHistoryCards, toolNameFor } from "./history";
 // Re-export the AgJSON types the block-preserving transcript surfaces, so
 // consumers can name `reduceResult` / block types without a direct
 // `@silverprotocol/core` import.

package/src/sse.ts

@@ -39,12 +39,24 @@ export function parseSseEvents(buffer: string): { events: ParsedSseEvent[]; rest
   return { events, rest };
 }
 
+function frameType(data: unknown): unknown {
+  if (typeof data !== "object" || data === null) return undefined;
+  return (data as { type?: unknown }).type;
+}
+
 function isResultMessage(data: unknown): boolean {
-  return (
-    typeof data === "object" &&
-    data !== null &&
-    (data as { type?: unknown }).type === "result"
-  );
+  return frameType(data) === "result";
+}
+
+/**
+ * Join point where a NEW text block begins: distinct blocks are distinct
+ * paragraphs on the flat text surface (guuey#98 — raw concatenation rendered
+ * "…instead.Here's your packing…"). Idempotent so an empty block between two
+ * boundaries never stacks separators.
+ */
+function withBlockBreak(current: string): string {
+  if (!current || current.endsWith("\n\n")) return current;
+  return current + "\n\n";
 }
 
 /**
@@ -52,13 +64,22 @@ function isResultMessage(data: unknown): boolean {
  * messages APPEND (streaming). The success `result` message carries the SAME
  * final text, so it REPLACES rather than appends — otherwise the answer renders
  * twice. The result is also the fallback for result-only turns.
+ *
+ * Block boundaries become paragraph breaks: a silver `text.start` frame (and,
+ * on the bypass arm, each new `assistant` message) opens a new block, so the
+ * separator lands exactly there — never per `text.delta`, which must stay a
+ * raw append for streaming (#91).
  */
 export function reduceAssistantText(current: string, data: unknown): string {
   if (isResultMessage(data)) {
     const result = extractAssistantText(data);
     return result || current;
   }
-  return current + extractAssistantText(data);
+  if (frameType(data) === "text.start") return withBlockBreak(current);
+  const text = extractAssistantText(data);
+  if (!text) return current;
+  if (frameType(data) === "assistant") return withBlockBreak(current) + text;
+  return current + text;
 }
 
 /**
@@ -87,6 +108,8 @@ export function extractAssistantText(data: unknown): string {
     if (typeof message === "object" && message !== null && "content" in message) {
       const content = (message as { content?: unknown }).content;
       if (Array.isArray(content)) {
+        // Distinct text blocks are distinct paragraphs (guuey#98) — same
+        // block-boundary contract as the silver arm's text.start handling.
         return content
           .filter(
             (b): b is { type: "text"; text: string } =>
@@ -96,7 +119,8 @@ export function extractAssistantText(data: unknown): string {
               typeof (b as { text?: unknown }).text === "string",
           )
           .map((b) => b.text)
-          .join("");
+          .filter((t) => t.length > 0)
+          .join("\n\n");
       }
     }
     return "";

package/src/web-adapters.ts

@@ -317,3 +317,100 @@ export function createWebAdapters(
 
   return adapters;
 }
+
+/** Options for {@link createUiResourceReader} — same credential surface as the history adapter. */
+export interface CreateUiResourceReaderOptions {
+  /** The guuey public API base (`…/v1`). */
+  apiBaseUrl: string;
+  /** The thread whose persisted locators this reader may resolve. */
+  threadId: string;
+  /** Signed-in bearer — wins over the guest secret (same rule as the transport). */
+  getAccessToken?: (opts?: { forceRefresh?: boolean }) => Promise<string | null>;
+  /** Caller-owned anonymous guest secret (widget / guest chat). */
+  guestSecret?: string | null;
+  /** Injectable for tests. */
+  fetchImpl?: typeof fetch;
+}
+
+/**
+ * Build a `@guuey/mcp-apps-host` `UiResourceReader` over guuey's
+ * authenticated resources/read proxy (guuey#122 Gap 1:
+ * `GET /v1/threads/:threadId/ui-resource?uri=…`).
+ *
+ * The proxy owns EVERYTHING trust-shaped: caller identity (the same three
+ * families as the history read), thread ownership, the locator-to-thread
+ * scope guard, and the per-user federation mint. This reader only carries
+ * the surface's existing credential and maps EVERY non-OK — 401/403/404/502
+ * alike — to `undefined`: deny is byte-identical to a miss, and a miss
+ * renders the host's placeholder, never an error surface.
+ *
+ * Channel resolution is the phase-1 heuristic: a `ui://ggui/…` uri mounts in
+ * the ggui-CSP sandbox page (`channel: "ggui"`), anything else in the
+ * self-only page (`channel: "inline"`). Phase 2 (per-resource declared-CSP
+ * construction from the response `_meta.ui.csp`) retires the heuristic —
+ * conformance map, retirement step 3.
+ */
+/**
+ * The mount the reader resolves — structurally assignable to
+ * `@guuey/mcp-apps-host`'s `ViewMount` mountable arms (typed inline so this
+ * package carries no dependency on the host package; hosts that consume
+ * both see one structural type).
+ */
+export interface ResolvedUiResourceMount {
+  channel: "inline" | "ggui";
+  resource: { uri: string; mimeType?: string; text: string };
+}
+
+export function createUiResourceReader(
+  options: CreateUiResourceReaderOptions,
+): (resourceUri: string) => Promise<ResolvedUiResourceMount | undefined> {
+  const fetchImpl = options.fetchImpl ?? fetch;
+  return async (resourceUri) => {
+    const headers: Record<string, string> = {};
+    const token = options.getAccessToken ? await options.getAccessToken() : null;
+    const guest = sendableGuestSecret(options.guestSecret);
+    if (token) {
+      headers["authorization"] = `Bearer ${token}`;
+    } else if (guest) {
+      headers[GUEST_HEADER] = guest;
+    }
+    const requestUrl = `${options.apiBaseUrl}/threads/${encodeURIComponent(options.threadId)}/ui-resource?uri=${encodeURIComponent(resourceUri)}`;
+    let res: Response;
+    try {
+      res = await fetchImpl(requestUrl, { headers });
+    } catch {
+      return undefined; // transport failure == miss == placeholder
+    }
+    // One forceRefresh retry on 401 with a bearer in play — the same
+    // expired-but-refreshable recovery the history adapter performs;
+    // without it a stale token degrades to a permanent placeholder.
+    if (res.status === 401 && options.getAccessToken) {
+      const fresh = await options.getAccessToken({ forceRefresh: true }).catch(() => null);
+      if (fresh) {
+        try {
+          res = await fetchImpl(requestUrl, {
+            headers: { ...headers, authorization: `Bearer ${fresh}` },
+          });
+        } catch {
+          return undefined;
+        }
+      }
+    }
+    if (!res.ok) return undefined;
+    let body: { uri?: unknown; mimeType?: unknown; text?: unknown };
+    try {
+      body = (await res.json()) as typeof body;
+    } catch {
+      return undefined;
+    }
+    if (typeof body.uri !== "string" || typeof body.text !== "string") return undefined;
+    return {
+      channel: resourceUri.startsWith("ui://ggui/") ? "ggui" : "inline",
+      resource: {
+        uri: body.uri,
+        ...(typeof body.mimeType === "string" ? { mimeType: body.mimeType } : {}),
+        text: body.text,
+      },
+    };
+  };
+}