@guuey/chat 0.5.0 → 0.6.0

package/dist/hitl.d.ts

@@ -0,0 +1,58 @@
+/**
+ * R10's AgJSON HITL half (spec draft.2, silverprotocol/typescript-sdk#16):
+ * lifting persisted asks out of the fold, and constructing validated
+ * answers.
+ *
+ * Two contract points are load-bearing here:
+ *
+ *  - **Asks render from the PERSISTED declaration** — `AgPausedAsk` in
+ *    `turn.done.outcome:"paused".asks[]`. The live `hitl.ask` event is
+ *    live-only by spec (§1.3); a client that joins a thread late renders
+ *    the paused record, so this module reads ONLY that record and both
+ *    paths converge.
+ *  - **Every answer is validated BEFORE dispatch** — `validateHitlAnswer`
+ *    from core enforces required-iff-declared, echo-must-be-declared, and
+ *    the `requestState` byte-echo MUST. `buildHitlAnswer` constructs
+ *    answers that pass by construction and THROWS if they don't: a failed
+ *    validation here is a kit bug, never a user-visible state.
+ *
+ * Answer states encode guuey's ratified dismissal ruling (#16): dismissal
+ * maps to `cancelled` (still-pending, re-askable — the card stays
+ * answerable), `declined` is the durable explicit deny.
+ */
+import { type AgGrantMode, type AgHitlAnswer, type AgPausedAsk, type AgReduceResult } from "@silverprotocol/core";
+import type { HitlPromptInput } from "./types.js";
+/** A host-side record of how an ask was answered (the assembler's ledger value). */
+export interface HitlAnswerRecord {
+    status: "resolved" | "declined" | "cancelled";
+    /** Present iff `status === "resolved"` and the ask declared modes. */
+    grantModeId?: string;
+}
+/** A user action on a HITL card: pick a declared mode, decline, or dismiss. */
+export type HitlPromptAction = {
+    grantModeId: string;
+} | "accept" | "decline" | "dismiss";
+/**
+ * Display text for a grant mode: the asker's `label`, else the id as
+ * LITERAL text. Mode semantics are asker-scoped (normative, spec §7):
+ * falling back to the id displays identity, never interpreted meaning —
+ * a renderer must not special-case id strings.
+ */
+export declare function grantModeDisplay(mode: AgGrantMode): string;
+/**
+ * Lift every persisted ask in the fold into an R10 prompt input, merged
+ * with the host's answer ledger (keyed by askId). Pure; input order is the
+ * fold's turn order.
+ */
+export declare function hitlPromptsFromFold(result: AgReduceResult | null, answers?: Readonly<Record<string, HitlAnswerRecord>>): HitlPromptInput[];
+/**
+ * Construct the wire answer for a card action and validate it against the
+ * ask's own persisted record before anything dispatches it.
+ *
+ * `"accept"` is the plain-ask affirmative (valid only when the ask
+ * declared no modes — with a declaration, accepting IS picking a mode).
+ * A validation failure throws: the inputs came from the declaration
+ * itself, so a mismatch is a construction bug, not a user error.
+ */
+export declare function buildHitlAnswer(ask: AgPausedAsk, action: HitlPromptAction): AgHitlAnswer;
+//# sourceMappingURL=hitl.d.ts.map

package/dist/hitl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitl.d.ts","sourceRoot":"","sources":["../src/hitl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAC9C,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+EAA+E;AAC/E,MAAM,MAAM,gBAAgB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1F;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,GAAG,IAAI,EAC7B,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAM,GACvD,eAAe,EAAE,CAiBnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,GAAG,YAAY,CAexF"}

package/dist/hitl.js

@@ -0,0 +1,81 @@
+/**
+ * R10's AgJSON HITL half (spec draft.2, silverprotocol/typescript-sdk#16):
+ * lifting persisted asks out of the fold, and constructing validated
+ * answers.
+ *
+ * Two contract points are load-bearing here:
+ *
+ *  - **Asks render from the PERSISTED declaration** — `AgPausedAsk` in
+ *    `turn.done.outcome:"paused".asks[]`. The live `hitl.ask` event is
+ *    live-only by spec (§1.3); a client that joins a thread late renders
+ *    the paused record, so this module reads ONLY that record and both
+ *    paths converge.
+ *  - **Every answer is validated BEFORE dispatch** — `validateHitlAnswer`
+ *    from core enforces required-iff-declared, echo-must-be-declared, and
+ *    the `requestState` byte-echo MUST. `buildHitlAnswer` constructs
+ *    answers that pass by construction and THROWS if they don't: a failed
+ *    validation here is a kit bug, never a user-visible state.
+ *
+ * Answer states encode guuey's ratified dismissal ruling (#16): dismissal
+ * maps to `cancelled` (still-pending, re-askable — the card stays
+ * answerable), `declined` is the durable explicit deny.
+ */
+import { validateHitlAnswer, } from "@silverprotocol/core";
+/**
+ * Display text for a grant mode: the asker's `label`, else the id as
+ * LITERAL text. Mode semantics are asker-scoped (normative, spec §7):
+ * falling back to the id displays identity, never interpreted meaning —
+ * a renderer must not special-case id strings.
+ */
+export function grantModeDisplay(mode) {
+    return mode.label ?? mode.id;
+}
+/**
+ * Lift every persisted ask in the fold into an R10 prompt input, merged
+ * with the host's answer ledger (keyed by askId). Pure; input order is the
+ * fold's turn order.
+ */
+export function hitlPromptsFromFold(result, answers = {}) {
+    if (result === null)
+        return [];
+    const prompts = [];
+    for (const turn of result.turns) {
+        if (turn.outcome?.type !== "paused")
+            continue;
+        for (const ask of turn.outcome.asks) {
+            const answer = answers[ask.askId];
+            prompts.push({
+                id: ask.askId,
+                kind: "hitl",
+                ask,
+                state: answer?.status ?? "pending",
+                ...(answer?.grantModeId !== undefined ? { grantModeId: answer.grantModeId } : {}),
+            });
+        }
+    }
+    return prompts;
+}
+/**
+ * Construct the wire answer for a card action and validate it against the
+ * ask's own persisted record before anything dispatches it.
+ *
+ * `"accept"` is the plain-ask affirmative (valid only when the ask
+ * declared no modes — with a declaration, accepting IS picking a mode).
+ * A validation failure throws: the inputs came from the declaration
+ * itself, so a mismatch is a construction bug, not a user error.
+ */
+export function buildHitlAnswer(ask, action) {
+    const answer = {
+        askId: ask.askId,
+        status: action === "decline" ? "declined" : action === "dismiss" ? "cancelled" : "resolved",
+        ...(typeof action === "object" ? { grantModeId: action.grantModeId } : {}),
+        // The pre-existing byte-echo MUST (spec §7): the answer carries the
+        // ask's requestState verbatim when one exists.
+        ...(ask.requestState !== undefined ? { requestState: ask.requestState } : {}),
+    };
+    const verdict = validateHitlAnswer(ask, answer);
+    if (!verdict.ok) {
+        throw new Error(`buildHitlAnswer constructed an invalid answer (${verdict.code}): ${verdict.message}`);
+    }
+    return answer;
+}

package/dist/index.d.ts

@@ -10,10 +10,11 @@
  * this root subpath stays React-free forever — server-side transcript
  * rendering, tests, and RN bundlers consume the view-model directly.
  */
-export { planTranscript, } from "./plan.js";
+export { newestViewKey, planTranscript, } from "./plan.js";
 export { calmPolicy, debugPolicy, type TranscriptPolicy, } from "./policy.js";
 export { defaultChatStrings, humanizeToolName, type ChatStrings, } from "./strings.js";
 export { transcriptInputsFromHistory } from "./history-inputs.js";
+export { buildHitlAnswer, grantModeDisplay, hitlPromptsFromFold, type HitlAnswerRecord, type HitlPromptAction, } from "./hitl.js";
 export { DEFAULT_CHAT_THEME, GUUEY_CHAT_THEME, GuueyChatPalette, GuueyChatTheme, resolveTheme, } from "./theme.js";
-export type { CitationsItem, CodeItem, CompactionItem, DataResultItem, DisplayItem, ErrorItem, HistoryBoundaryItem, ItemKey, MediaItem, PromptItem, PromptItemInput, ReasoningItem, StatusLineItem, TextItem, ToolGroupItem, ToolItem, TranscriptInputs, TranscriptMessage, TranscriptOverrides, TranscriptPlan, UnknownItem, UserMessageItem, ViewMountItem, } from "./types.js";
+export type { ChatDebugEvent, CitationsItem, CodeItem, CompactionItem, DataResultItem, DisplayItem, ErrorItem, HistoryBoundaryItem, ItemKey, HitlPromptInput, HitlPromptItem, MediaItem, NoticeItem, ProfilePromptInput, ProfilePromptItem, PromptItem, PromptItemInput, ReasoningItem, StatusLineItem, TextItem, ToolGroupItem, ToolItem, TranscriptInputs, TranscriptMessage, TranscriptOverrides, TranscriptPlan, UnknownItem, UserMessageItem, ViewMountItem, ViewRefItem, } from "./types.js";
 //# 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;;;;;;;;;;;GAWG;AACH,OAAO,EACL,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,UAAU,EACV,WAAW,EACX,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,cAAc,EACd,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,OAAO,EACP,SAAS,EACT,UAAU,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,aAAa,EACb,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,UAAU,EACV,WAAW,EACX,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,aAAa,EACb,QAAQ,EACR,cAAc,EACd,cAAc,EACd,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,OAAO,EACP,eAAe,EACf,cAAc,EACd,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -10,8 +10,9 @@
  * this root subpath stays React-free forever — server-side transcript
  * rendering, tests, and RN bundlers consume the view-model directly.
  */
-export { planTranscript, } from "./plan.js";
+export { newestViewKey, planTranscript, } from "./plan.js";
 export { calmPolicy, debugPolicy, } from "./policy.js";
 export { defaultChatStrings, humanizeToolName, } from "./strings.js";
 export { transcriptInputsFromHistory } from "./history-inputs.js";
+export { buildHitlAnswer, grantModeDisplay, hitlPromptsFromFold, } from "./hitl.js";
 export { DEFAULT_CHAT_THEME, GUUEY_CHAT_THEME, GuueyChatPalette, GuueyChatTheme, resolveTheme, } from "./theme.js";

package/dist/native/components.d.ts

@@ -28,7 +28,7 @@
 import type { ComponentType, ReactNode } from "react";
 import type { ResolvedViewMount, ViewHostPhase } from "@guuey/mcp-apps-host";
 import type { ChatStrings } from "../strings.js";
-import type { CitationsItem, CodeItem, CompactionItem, DataResultItem, DisplayItem, ErrorItem, HistoryBoundaryItem, ItemKey, MediaItem, PromptItem, ReasoningItem, StatusLineItem, ToolGroupItem, ToolItem, UnknownItem, UserMessageItem, TextItem, ViewMountItem } from "../types.js";
+import type { CitationsItem, CodeItem, CompactionItem, DataResultItem, DisplayItem, ErrorItem, HistoryBoundaryItem, ItemKey, MediaItem, NoticeItem, PromptItem, ReasoningItem, StatusLineItem, ToolGroupItem, ToolItem, UnknownItem, UserMessageItem, TextItem, ViewMountItem, ViewRefItem } from "../types.js";
 import type { NativeChatTokens } from "./theme-native.js";
 /** Everything a rendered native item may need beyond itself. */
 export interface NativeTranscriptItemContext {
@@ -40,13 +40,20 @@ export interface NativeTranscriptItemContext {
     /** R0 failed-send retry. */
     onRetry?: (item: UserMessageItem) => void;
     /** R10 prompt actions — the host owns what accept/decline DO. */
-    onPromptAction?: (item: PromptItem, action: "accept" | "decline" | "dismiss") => void;
+    onPromptAction?: (item: PromptItem, action: "accept" | "decline" | "dismiss" | {
+        grantModeId: string;
+    }) => void;
     /** R11 action slots (sign-in / retry affordances). */
     onErrorAction?: (item: ErrorItem) => void;
     /** R6: locator mounts resolved by `useTranscript` ("expired" = failed). */
     resolvedMounts: ReadonlyMap<ItemKey, ResolvedViewMount | "expired">;
     /** R6: live phase reports wired back into the next plan. */
     onViewPhase: (key: ItemKey, phase: ViewHostPhase) => void;
+    /**
+     * guuey#204: a promoted-view reference chip was activated — the host
+     * focuses/reveals its stage. Absent ⇒ the chip renders as a label.
+     */
+    onViewRef?: (item: ViewRefItem) => void;
 }
 interface ItemProps<T> {
     item: T;
@@ -59,10 +66,17 @@ export declare function NativeDataResult({ item, ctx }: ItemProps<DataResultItem
 export declare function NativeTool({ item, ctx }: ItemProps<ToolItem>): ReactNode;
 export declare function NativeToolGroup({ item, ctx }: ItemProps<ToolGroupItem>): ReactNode;
 export declare function NativeView({ item, ctx }: ItemProps<ViewMountItem>): ReactNode;
+/**
+ * guuey#204: the "promote and reference" chip — a Pressable when the host
+ * wires `onViewRef`, a plain labeled row otherwise. Never a second mount.
+ */
+export declare function NativeViewRef({ item, ctx }: ItemProps<ViewRefItem>): ReactNode;
 export declare function NativeMedia({ item, ctx }: ItemProps<MediaItem>): ReactNode;
 export declare function NativeCode({ item, ctx }: ItemProps<CodeItem>): ReactNode;
 export declare function NativeCitations({ item, ctx }: ItemProps<CitationsItem>): ReactNode;
 export declare function NativePrompt({ item, ctx }: ItemProps<PromptItem>): ReactNode;
+/** The notice row (spec draft.2) — labeled, non-conversational, never agent-voiced. */
+export declare function NativeNotice({ item, ctx }: ItemProps<NoticeItem>): ReactNode;
 export declare function NativeError({ item, ctx }: ItemProps<ErrorItem>): ReactNode;
 export declare function NativeHistoryBoundary({ item, ctx }: ItemProps<HistoryBoundaryItem>): ReactNode;
 export declare function NativeCompaction({ item, ctx }: ItemProps<CompactionItem>): ReactNode;
@@ -77,10 +91,12 @@ export interface NativeTranscriptComponents {
     toolGroup: ComponentType<ItemProps<ToolGroupItem>>;
     dataResult: ComponentType<ItemProps<DataResultItem>>;
     view: ComponentType<ItemProps<ViewMountItem>>;
+    viewRef: ComponentType<ItemProps<ViewRefItem>>;
     media: ComponentType<ItemProps<MediaItem>>;
     code: ComponentType<ItemProps<CodeItem>>;
     citations: ComponentType<ItemProps<CitationsItem>>;
     prompt: ComponentType<ItemProps<PromptItem>>;
+    notice: ComponentType<ItemProps<NoticeItem>>;
     error: ComponentType<ItemProps<ErrorItem>>;
     history: ComponentType<ItemProps<HistoryBoundaryItem>>;
     compaction: ComponentType<ItemProps<CompactionItem>>;

package/dist/native/components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/native/components.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/native/components.tsx"],"names":[],"mappings":"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"}

package/dist/native/components.js

@@ -113,6 +113,25 @@ export function NativeView({ item, ctx }) {
             gap: 4,
         }, children: [_jsx(MutedText, { ctx: ctx, children: label }), item.attribution !== null ? _jsx(MutedText, { ctx: ctx, children: item.attribution }) : null] }));
 }
+/**
+ * guuey#204: the "promote and reference" chip — a Pressable when the host
+ * wires `onViewRef`, a plain labeled row otherwise. Never a second mount.
+ */
+export function NativeViewRef({ item, ctx }) {
+    const { tokens } = ctx;
+    const chipStyle = {
+        alignSelf: "flex-start",
+        backgroundColor: tokens.palette.surface,
+        borderRadius: 999,
+        paddingHorizontal: tokens.pad,
+        paddingVertical: 6,
+    };
+    if (ctx.onViewRef === undefined) {
+        return (_jsx(View, { accessibilityRole: "text", style: chipStyle, children: _jsx(MutedText, { ctx: ctx, children: item.label }) }));
+    }
+    const onViewRef = ctx.onViewRef;
+    return (_jsx(Pressable, { accessibilityRole: "button", accessibilityLabel: item.label, onPress: () => onViewRef(item), style: chipStyle, children: _jsx(MutedText, { ctx: ctx, children: item.label }) }));
+}
 // ─── R7 ────────────────────────────────────────────────────────────────────
 /** Inline images allow https URLs and image/* base64 data — nothing else. */
 function imageSrc(item) {
@@ -167,6 +186,20 @@ export function NativeCitations({ item, ctx }) {
 // ─── R10 ───────────────────────────────────────────────────────────────────
 export function NativePrompt({ item, ctx }) {
     const { tokens } = ctx;
+    if (item.promptKind === "hitl") {
+        const s = ctx.strings;
+        if (item.state === "resolved" || item.state === "declined") {
+            return (_jsx(MutedText, { ctx: ctx, children: item.state === "resolved"
+                    ? item.chosenModeLabel !== null
+                        ? s.promptAnsweredWith(item.chosenModeLabel)
+                        : s.promptAccept
+                    : s.promptDeclinedRecord }));
+        }
+        // `cancelled` = guuey's re-askable dismissal: a record row that reopens
+        // to the actions on toggle (silverprotocol#16 ruling).
+        const answerable = item.state === "pending" || (item.state === "cancelled" && item.expanded);
+        return (_jsxs(View, { accessibilityLiveRegion: "polite", accessible: true, style: { backgroundColor: tokens.palette.surface, borderRadius: tokens.radius, padding: tokens.pad, gap: 8 }, children: [item.state === "cancelled" && (_jsx(Pressable, { accessibilityRole: "button", accessibilityState: { expanded: item.expanded }, onPress: () => ctx.onToggle(item.key), children: _jsx(Text, { style: { color: tokens.palette.inkMuted, fontSize: tokens.fontSize }, children: s.promptDismissed }) })), answerable && (_jsxs(_Fragment, { children: [item.message !== null && (_jsx(Text, { style: { color: tokens.palette.ink, fontSize: tokens.fontSize, fontFamily: tokens.fontFamily }, children: item.message })), _jsxs(View, { style: { flexDirection: "row", flexWrap: "wrap", gap: 12 }, children: [item.grantModes.length === 0 ? (_jsx(Pressable, { accessibilityRole: "button", onPress: () => ctx.onPromptAction?.(item, "accept"), children: _jsx(Text, { style: { color: tokens.palette.accent, fontWeight: "700", fontSize: tokens.fontSize }, children: s.promptAccept }) })) : (item.grantModes.map((mode) => (_jsx(Pressable, { accessibilityRole: "button", accessibilityHint: mode.description, onPress: () => ctx.onPromptAction?.(item, { grantModeId: mode.id }), children: _jsx(Text, { style: { color: tokens.palette.accent, fontWeight: "700", fontSize: tokens.fontSize }, children: mode.label ?? mode.id }) }, mode.id)))), _jsx(Pressable, { accessibilityRole: "button", onPress: () => ctx.onPromptAction?.(item, "decline"), children: _jsx(Text, { style: { color: tokens.palette.inkMuted, fontSize: tokens.fontSize }, children: s.promptDecline }) })] })] }))] }));
+    }
     if (item.state !== "pending") {
         return (_jsxs(MutedText, { ctx: ctx, children: [item.promptKind, ": ", item.state] }));
     }
@@ -180,6 +213,12 @@ export function NativePrompt({ item, ctx }) {
                     ? `${item.appId} requests ${item.requested} access`
                     : `Link your account to ${item.appId}` }), _jsxs(View, { style: { flexDirection: "row", gap: 12 }, children: [_jsx(Pressable, { accessibilityRole: "button", onPress: () => ctx.onPromptAction?.(item, "accept"), children: _jsx(Text, { style: { color: tokens.palette.accent, fontWeight: "700", fontSize: tokens.fontSize }, children: "Allow" }) }), _jsx(Pressable, { accessibilityRole: "button", onPress: () => ctx.onPromptAction?.(item, "decline"), children: _jsx(Text, { style: { color: tokens.palette.inkMuted, fontSize: tokens.fontSize }, children: "Decline" }) })] })] }));
 }
+// ─── R16 ──────────────────────────────────────────────────────────────────
+/** The notice row (spec draft.2) — labeled, non-conversational, never agent-voiced. */
+export function NativeNotice({ item, ctx }) {
+    const { tokens } = ctx;
+    return (_jsx(View, { accessible: true, accessibilityRole: "text", style: { paddingVertical: 4 }, children: _jsxs(Text, { style: { color: tokens.palette.inkMuted, fontSize: tokens.fontSize - 2 }, children: [ctx.strings.noticeLabel, item.sourceLabel !== null ? ` · ${item.sourceLabel}` : "", item.text !== "" ? ` — ${item.text}` : ""] }) }));
+}
 // ─── R11 ───────────────────────────────────────────────────────────────────
 export function NativeError({ item, ctx }) {
     const { tokens } = ctx;
@@ -215,10 +254,12 @@ export const nativeTranscriptComponents = {
     toolGroup: NativeToolGroup,
     dataResult: NativeDataResult,
     view: NativeView,
+    viewRef: NativeViewRef,
     media: NativeMedia,
     code: NativeCode,
     citations: NativeCitations,
     prompt: NativePrompt,
+    notice: NativeNotice,
     error: NativeError,
     history: NativeHistoryBoundary,
     compaction: NativeCompaction,
@@ -256,6 +297,10 @@ export function renderNativeItem(item, components, ctx) {
             const C = components.view;
             return _jsx(C, { item: item, ctx: ctx }, item.key);
         }
+        case "viewRef": {
+            const C = components.viewRef;
+            return _jsx(C, { item: item, ctx: ctx }, item.key);
+        }
         case "media": {
             const C = components.media;
             return _jsx(C, { item: item, ctx: ctx }, item.key);
@@ -272,6 +317,10 @@ export function renderNativeItem(item, components, ctx) {
             const C = components.prompt;
             return _jsx(C, { item: item, ctx: ctx }, item.key);
         }
+        case "notice": {
+            const C = components.notice;
+            return _jsx(C, { item: item, ctx: ctx }, item.key);
+        }
         case "error": {
             const C = components.error;
             return _jsx(C, { item: item, ctx: ctx }, item.key);

package/dist/native/transcript.d.ts

@@ -33,7 +33,7 @@ import { type NativeTranscriptComponents, type NativeTranscriptItemContext } fro
 import { type NativeThemeMode } from "./theme-native.js";
 /** The host-behavior pass-through — everything the kit deliberately does NOT own. */
 export type NativeTranscriptListProps = Pick<FlatListProps<DisplayItem>, "style" | "contentContainerStyle" | "keyboardDismissMode" | "keyboardShouldPersistTaps" | "automaticallyAdjustKeyboardInsets" | "onScroll" | "scrollEventThrottle" | "ListEmptyComponent" | "scrollIndicatorInsets">;
-export interface NativeTranscriptProps extends Pick<NativeTranscriptItemContext, "onToggle" | "onRetry" | "onPromptAction" | "onErrorAction" | "resolvedMounts" | "onViewPhase"> {
+export interface NativeTranscriptProps extends Pick<NativeTranscriptItemContext, "onToggle" | "onRetry" | "onPromptAction" | "onErrorAction" | "resolvedMounts" | "onViewPhase" | "onViewRef"> {
     plan: TranscriptPlan;
     /** Per-slot component overrides (spec §3's override column). */
     components?: Partial<NativeTranscriptComponents>;

package/dist/native/transcript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../src/native/transcript.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAqD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1F,OAAO,EAML,KAAK,aAAa,EAGnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EACjC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAK7E,qFAAqF;AACrF,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,aAAa,CAAC,WAAW,CAAC,EACxB,OAAO,GACP,uBAAuB,GACvB,qBAAqB,GACrB,2BAA2B,GAC3B,mCAAmC,GACnC,UAAU,GACV,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,CAC1B,CAAC;AAEF,MAAM,WAAW,qBACf,SAAQ,IAAI,CACV,2BAA2B,EAC3B,UAAU,GAAG,SAAS,GAAG,gBAAgB,GAAG,eAAe,GAAG,gBAAgB,GAAG,aAAa,CAC/F;IACD,IAAI,EAAE,cAAc,CAAC;IACrB,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACjD,gEAAgE;IAChE,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,yBAAyB,CAAC;CACvC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,CA0GxE"}
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../src/native/transcript.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAqD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1F,OAAO,EAML,KAAK,aAAa,EAGnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EACjC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAK7E,qFAAqF;AACrF,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,aAAa,CAAC,WAAW,CAAC,EACxB,OAAO,GACP,uBAAuB,GACvB,qBAAqB,GACrB,2BAA2B,GAC3B,mCAAmC,GACnC,UAAU,GACV,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,CAC1B,CAAC;AAEF,MAAM,WAAW,qBACf,SAAQ,IAAI,CACV,2BAA2B,EAC3B,UAAU,GAAG,SAAS,GAAG,gBAAgB,GAAG,eAAe,GAAG,gBAAgB,GAAG,aAAa,GAAG,WAAW,CAC7G;IACD,IAAI,EAAE,cAAc,CAAC;IACrB,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACjD,gEAAgE;IAChE,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,yBAAyB,CAAC;CACvC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,CA2GxE"}

package/dist/native/transcript.js

@@ -34,10 +34,10 @@ import { resolveNativeTheme } from "./theme-native.js";
 /** Offset (px) past which the reader counts as "up in history". */
 const JUMP_THRESHOLD_PX = 160;
 export function NativeTranscript(props) {
-    const { plan, components, strings = defaultChatStrings, theme = DEFAULT_CHAT_THEME, mode = "light", listProps, onToggle, onRetry, onPromptAction, onErrorAction, resolvedMounts, onViewPhase, } = props;
+    const { plan, components, strings = defaultChatStrings, theme = DEFAULT_CHAT_THEME, mode = "light", listProps, onToggle, onRetry, onPromptAction, onErrorAction, resolvedMounts, onViewPhase, onViewRef, } = props;
     const tokens = useMemo(() => resolveNativeTheme(theme, mode), [theme, mode]);
     const resolvedComponents = useMemo(() => ({ ...nativeTranscriptComponents, ...components }), [components]);
-    const ctx = useMemo(() => ({ strings, tokens, onToggle, onRetry, onPromptAction, onErrorAction, resolvedMounts, onViewPhase }), [strings, tokens, onToggle, onRetry, onPromptAction, onErrorAction, resolvedMounts, onViewPhase]);
+    const ctx = useMemo(() => ({ strings, tokens, onToggle, onRetry, onPromptAction, onErrorAction, resolvedMounts, onViewPhase, onViewRef }), [strings, tokens, onToggle, onRetry, onPromptAction, onErrorAction, resolvedMounts, onViewPhase, onViewRef]);
     // Inverted-list data: reversed plan, newest at index 0 (the visual
     // bottom / scroll origin). Keys are the plan's stable keys.
     const data = useMemo(() => [...plan.items].reverse(), [plan.items]);

package/dist/native.d.ts

@@ -19,7 +19,7 @@
  * importable everywhere; this arm loads only inside an RN runtime.
  */
 export { NativeTranscript, type NativeTranscriptProps, type NativeTranscriptListProps, } from "./native/transcript.js";
-export { nativeTranscriptComponents, renderNativeItem, NativeUserMessage, NativeText, NativeReasoning, NativeTool, NativeToolGroup, NativeDataResult, NativeView, NativeMedia, NativeCode, NativeCitations, NativePrompt, NativeError, NativeHistoryBoundary, NativeCompaction, NativeUnknown, NativeStatus, type NativeTranscriptComponents, type NativeTranscriptItemContext, } from "./native/components.js";
+export { nativeTranscriptComponents, renderNativeItem, NativeUserMessage, NativeText, NativeReasoning, NativeTool, NativeToolGroup, NativeDataResult, NativeView, NativeViewRef, NativeMedia, NativeCode, NativeCitations, NativePrompt, NativeError, NativeHistoryBoundary, NativeCompaction, NativeUnknown, NativeStatus, type NativeTranscriptComponents, type NativeTranscriptItemContext, } from "./native/components.js";
 export { NativeMarkdown } from "./native/markdown.js";
 export { resolveNativeTheme, type NativeChatTokens, type NativeThemeMode, } from "./native/theme-native.js";
 export { useTranscript, useTranscriptInputs, type UseTranscriptArgs, type UseTranscriptResult, type UseTranscriptInputsResult, } from "./react/use-transcript.js";

package/dist/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,GAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,GACjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,GAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,GACjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,2BAA2B,CAAC"}

package/dist/native.js

@@ -19,7 +19,7 @@
  * importable everywhere; this arm loads only inside an RN runtime.
  */
 export { NativeTranscript, } from "./native/transcript.js";
-export { nativeTranscriptComponents, renderNativeItem, NativeUserMessage, NativeText, NativeReasoning, NativeTool, NativeToolGroup, NativeDataResult, NativeView, NativeMedia, NativeCode, NativeCitations, NativePrompt, NativeError, NativeHistoryBoundary, NativeCompaction, NativeUnknown, NativeStatus, } from "./native/components.js";
+export { nativeTranscriptComponents, renderNativeItem, NativeUserMessage, NativeText, NativeReasoning, NativeTool, NativeToolGroup, NativeDataResult, NativeView, NativeViewRef, NativeMedia, NativeCode, NativeCitations, NativePrompt, NativeError, NativeHistoryBoundary, NativeCompaction, NativeUnknown, NativeStatus, } from "./native/components.js";
 export { NativeMarkdown } from "./native/markdown.js";
 export { resolveNativeTheme, } from "./native/theme-native.js";
 // The React-generic renderer-state owner + live assembler — shared with

package/dist/plan.d.ts

@@ -1,5 +1,20 @@
+import { type ViewMount } from "@guuey/mcp-apps-host";
 import type { TranscriptPolicy } from "./policy.js";
 import type { TranscriptInputs, TranscriptOverrides, TranscriptPlan } from "./types.js";
 /** The one pure function (spec §7). */
 export declare function planTranscript(inputs: TranscriptInputs, policy: TranscriptPolicy, overrides?: TranscriptOverrides): TranscriptPlan;
+/**
+ * The plan key of the NEWEST mountable view — what a "most recent card"
+ * stage (the widget's CanvasPane) will show, derived in the same family
+ * the plan's own emission uses: live fold mounts (transcript order, last
+ * wins) outrank history cards (ascending `seq`). `undefined` when nothing
+ * narrows to a mountable resource. Hosts pass the key back as
+ * `TranscriptInputs.promotedViewKey`; `channel` lets a host decline to
+ * promote a bare locator when no reader is wired (the stage would show
+ * nothing, and a chip must never point at an empty canvas).
+ */
+export declare function newestViewKey(inputs: Pick<TranscriptInputs, "result" | "historyCards">): {
+    key: string;
+    channel: ViewMount["channel"];
+} | undefined;
 //# sourceMappingURL=plan.d.ts.map

package/dist/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAQV,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EAGf,MAAM,YAAY,CAAC;AAoiBpB,uCAAuC;AACvC,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,EACxB,SAAS,GAAE,mBAAwB,GAClC,cAAc,CA4IhB"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAqD,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACzG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EASV,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EAIf,MAAM,YAAY,CAAC;AAslBpB,uCAAuC;AACvC,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,EACxB,SAAS,GAAE,mBAAwB,GAClC,cAAc,CA0QhB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,cAAc,CAAC,GACxD;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;CAAE,GAAG,SAAS,CAiB5D"}