@guuey/chat 0.12.2 → 0.14.0

package/dist/index.d.ts

@@ -11,11 +11,11 @@
  * rendering, tests, and RN bundlers consume the view-model directly.
  */
 export { newestViewKey, planTranscript, } from "./plan.js";
-export { calmPolicy, debugPolicy, type TranscriptPolicy, } from "./policy.js";
+export { calmPolicy, type TranscriptPolicyOverrides, 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 { OAUTH_LINK_PARAMS, OAUTH_RETURN_PARAMS, OAUTH_SCHEME, oauthAuthorizeAsk, oauthAuthorizeHref, parseOAuthReturn, stripOAuthReturn, type OAuthAuthorizeAsk, type OAuthReturn, } from "./oauth.js";
-export { DEFAULT_CHAT_THEME, GUUEY_CHAT_THEME, GuueyChatPalette, GuueyChatTheme, resolveTheme, } from "./theme.js";
+export { DEFAULT_CHAT_THEME, GUUEY_CHAT_THEME, GuueyChatAccentRamp, GuueyChatErrorRamp, GuueyChatPalette, GuueyChatRamps, GuueyChatRampSet, GuueyChatTheme, GuueyChatToneRamp, resolveTheme, } from "./theme.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, PlanViewSummary, 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,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,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,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,eAAe,EACf,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,GACZ,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,KAAK,yBAAyB,EAC9B,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,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,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,eAAe,EACf,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -16,4 +16,4 @@ export { defaultChatStrings, humanizeToolName, } from "./strings.js";
 export { transcriptInputsFromHistory } from "./history-inputs.js";
 export { buildHitlAnswer, grantModeDisplay, hitlPromptsFromFold, } from "./hitl.js";
 export { OAUTH_LINK_PARAMS, OAUTH_RETURN_PARAMS, OAUTH_SCHEME, oauthAuthorizeAsk, oauthAuthorizeHref, parseOAuthReturn, stripOAuthReturn, } from "./oauth.js";
-export { DEFAULT_CHAT_THEME, GUUEY_CHAT_THEME, GuueyChatPalette, GuueyChatTheme, resolveTheme, } from "./theme.js";
+export { DEFAULT_CHAT_THEME, GUUEY_CHAT_THEME, GuueyChatAccentRamp, GuueyChatErrorRamp, GuueyChatPalette, GuueyChatRamps, GuueyChatRampSet, GuueyChatTheme, GuueyChatToneRamp, resolveTheme, } from "./theme.js";

package/dist/policy.d.ts

@@ -115,8 +115,18 @@ export interface TranscriptPolicy {
         raw: boolean;
     };
 }
+/** Deep-ish merge for the one level of nesting policies actually have. */
+/**
+ * Per-section partial overrides — the shape `withOverrides` actually
+ * merges (each section spreads over its base), so the type tells the
+ * truth: `{ view: { presentation: 'chips' } }` is valid without
+ * restating the section's other fields (guuey#321 surfaced the lie).
+ */
+export type TranscriptPolicyOverrides = {
+    [K in keyof TranscriptPolicy]?: Partial<TranscriptPolicy[K]>;
+};
 /** The `calm` preset — the end-user default (spec §5). */
-export declare function calmPolicy(overrides?: Partial<TranscriptPolicy>): TranscriptPolicy;
+export declare function calmPolicy(overrides?: TranscriptPolicyOverrides): TranscriptPolicy;
 /** The `debug` preset — the builder surface (Studio's test chat, spec §5). */
-export declare function debugPolicy(overrides?: Partial<TranscriptPolicy>): TranscriptPolicy;
+export declare function debugPolicy(overrides?: TranscriptPolicyOverrides): TranscriptPolicy;
 //# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEtF,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,OAAO,EAAE,WAAW,CAAC;IACrB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU;IACV,WAAW,EAAE;QAAE,eAAe,EAAE,OAAO,CAAA;KAAE,CAAC;IAC1C,+EAA+E;IAC/E,IAAI,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5B,UAAU;IACV,SAAS,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,iBAAiB,EAAE,OAAO,CAAA;KAAE,CAAC;IACzD,UAAU;IACV,IAAI,EAAE;QACJ,eAAe,EAAE,OAAO,CAAC;QACzB,WAAW,EAAE,OAAO,CAAC;QACrB,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;KAC7C,CAAC;IACF,iEAAiE;IACjE,SAAS,EAAE;QAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAA;KAAE,CAAC;IACzC,UAAU;IACV,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,OAAO,CAAC;QACrB,eAAe,EAAE,OAAO,CAAC;QACzB,+EAA+E;QAC/E,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF;;;;;;;OAOG;IACH,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAA;KAAE,CAAC;IAC9D,UAAU;IACV,KAAK,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IACxD,UAAU;IACV,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IACxC,UAAU;IACV,SAAS,EAAE;QAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;KAAE,CAAC;IACvC,WAAW;IACX,MAAM,EAAE;QAAE,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/D;;;;;;;;;;;OAWG;IACH,KAAK,EAAE;QACL,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7C,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,CAAC;KAC1C,CAAC;IACF,oFAAoF;IACpF,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,4EAA4E;IAC5E,MAAM,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAC1B,WAAW;IACX,UAAU,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9B,WAAW;IACX,OAAO,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1C;AAoDD,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAElF;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAcnF"}
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"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"}

package/dist/policy.js

@@ -6,7 +6,6 @@
  * rest of the preset.
  */
 import { defaultChatStrings, humanizeToolName } from "./strings.js";
-/** Deep-ish merge for the one level of nesting policies actually have. */
 function withOverrides(base, overrides) {
     if (!overrides)
         return base;

package/dist/react/guuey-chat.d.ts

@@ -48,7 +48,7 @@ import { type CSSProperties } from "react";
 import { type AgentInvokeAdapters } from "@guuey/agent-client";
 import type { AgHitlAnswer, AgPausedAsk } from "@silverprotocol/core";
 import type { UiResourceReader } from "@guuey/mcp-apps-host";
-import { type TranscriptPolicy } from "../policy.js";
+import { type TranscriptPolicyOverrides } from "../policy.js";
 import { type ChatStrings } from "../strings.js";
 import { type GuueyChatTheme } from "../theme.js";
 import type { ChatDebugEvent, ErrorItem, PlanViewSummary, PromptItem, ViewRefItem } from "../types.js";
@@ -146,8 +146,12 @@ export interface GuueyChatProps {
     adapters?: AgentInvokeAdapters;
     /** Policy preset (spec §5). Default `"calm"`. */
     preset?: "calm" | "debug";
-    /** Knob overrides applied on top of the preset (spec §3's columns). */
-    policy?: Partial<TranscriptPolicy>;
+    /**
+     * Knob overrides applied on top of the preset (spec §3's columns) —
+     * per-SECTION partials (`{ view: { presentation: "chips" } }` needs no
+     * other view fields; guuey#321 made the type tell the merge's truth).
+     */
+    policy?: TranscriptPolicyOverrides;
     /** Per-slot component overrides (spec §3's override column). */
     components?: Partial<TranscriptComponents>;
     /** String overrides — merged over the preset's `ChatStrings` (§4.2). */

package/dist/react/guuey-chat.d.ts.map

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

package/dist/react/guuey-chat.js

@@ -48,7 +48,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { forwardRef, useCallback, useEffect, useId, useImperativeHandle, useMemo, useRef, useState, } from "react";
 import { createUiActionRelay, createUiResourceReader, createWebAdapters, } from "@guuey/agent-client";
 import { useAgentInvoke } from "@guuey/agent-client/react";
-import { unavailableToolCallResult } from "@guuey/mcp-apps-host";
+import { unavailableToolCallResult, withActionStaging } from "@guuey/mcp-apps-host";
 import { calmPolicy, debugPolicy } from "../policy.js";
 import { useStructuralIdentity } from "./structural-identity.js";
 import { defaultChatStrings } from "../strings.js";
@@ -205,6 +205,24 @@ export const GuueyChat = forwardRef(function GuueyChat(props, ref) {
     // `viewProps.hostContext` keys win; `theme` is only defaulted. Hosts
     // mounting views DIRECTLY (a canvas over the roster) announce on their
     // own <GuueyView hostContext> — this covers the kit's own mounts.
+    // ── Composer ─────────────────────────────────────────────────────────
+    const [input, setInput] = useState("");
+    const inputRef = useRef(null);
+    // Browser form-field heuristics (a11y/autofill lints) flag a field with
+    // neither id nor name on every embedding site. useId keeps the id unique
+    // when several chats mount on one page — a static id would collide.
+    const composerId = useId();
+    const busy = invoke.status !== "ready";
+    const available = endpointUrl !== null;
+    const canSend = available && !busy && input.trim() !== "";
+    // ── The imperative seam (guuey#210) ──────────────────────────────────
+    // ONE stable handle for the component's whole life (hosts capture it in
+    // `onReady` and keep it), reading live truth through a ref so a call
+    // always sees the CURRENT gate — never a stale closure's.
+    const liveRef = useRef({ available, busy, invoke, onReady });
+    useEffect(() => {
+        liveRef.current = { available, busy, invoke, onReady };
+    });
     // The DEFAULT ACTION RELAY (guuey#335 — the founder-hit Confirm bug):
     // pod-then-persisted, built over the SAME identity as the reader, thread
     // read through the ref at CALL time. Without it, a kit-mounted render's
@@ -242,10 +260,27 @@ export const GuueyChat = forwardRef(function GuueyChat(props, ref) {
             byteSize: JSON.stringify(params)?.length ?? 0,
         });
     }, []);
+    // Post-turn action STAGING (guuey#356 — the widget's ratified #198/#215/
+    // #218 policy, ONE copy in the kit): with no live turn, an allowlisted
+    // semantic card action stages its human-readable projection into the
+    // composer (append, never clobber — the staged-composer semantic) and the
+    // view hears the queued acceptance; everything else rides the relay path
+    // untouched. Rides viewSlotProps too, so canvas hosts get it for free.
+    const stagedDefaultOnCallTool = useMemo(() => {
+        if (defaultOnCallTool === undefined)
+            return undefined;
+        return withActionStaging(defaultOnCallTool, {
+            isTurnLive: () => liveRef.current.busy,
+            stage: (text) => {
+                setInput((prev) => (prev.trim() === "" ? text : `${prev.trimEnd()} ${text}`));
+                inputRef.current?.focus();
+            },
+        });
+    }, [defaultOnCallTool]);
     const effectiveViewProps = useMemo(() => viewPropsWithThemeAnnounce(viewProps, mode, {
-        ...(defaultOnCallTool !== undefined ? { onCallTool: defaultOnCallTool } : {}),
+        ...(stagedDefaultOnCallTool !== undefined ? { onCallTool: stagedDefaultOnCallTool } : {}),
         onUpdateModelContext: defaultOnUpdateModelContext,
-    }), [viewProps, mode, defaultOnCallTool, defaultOnUpdateModelContext]);
+    }), [viewProps, mode, stagedDefaultOnCallTool, defaultOnUpdateModelContext]);
     // The canvas-host door (guuey#335): a host mounting views DIRECTLY from
     // the roster (the chat-rail shell) needs the SAME slot wiring the kit's
     // inline mounts get — theme announce, action relay, context sink. Read
@@ -256,29 +291,11 @@ export const GuueyChat = forwardRef(function GuueyChat(props, ref) {
     staticSlotPropsRef.current =
         typeof effectiveViewProps === "function"
             ? {
-                ...(defaultOnCallTool !== undefined ? { onCallTool: defaultOnCallTool } : {}),
+                ...(stagedDefaultOnCallTool !== undefined ? { onCallTool: stagedDefaultOnCallTool } : {}),
                 onUpdateModelContext: defaultOnUpdateModelContext,
                 hostContext: { theme: mode },
             }
             : (effectiveViewProps ?? {});
-    // ── Composer ─────────────────────────────────────────────────────────
-    const [input, setInput] = useState("");
-    const inputRef = useRef(null);
-    // Browser form-field heuristics (a11y/autofill lints) flag a field with
-    // neither id nor name on every embedding site. useId keeps the id unique
-    // when several chats mount on one page — a static id would collide.
-    const composerId = useId();
-    const busy = invoke.status !== "ready";
-    const available = endpointUrl !== null;
-    const canSend = available && !busy && input.trim() !== "";
-    // ── The imperative seam (guuey#210) ──────────────────────────────────
-    // ONE stable handle for the component's whole life (hosts capture it in
-    // `onReady` and keep it), reading live truth through a ref so a call
-    // always sees the CURRENT gate — never a stale closure's.
-    const liveRef = useRef({ available, busy, invoke, onReady });
-    useEffect(() => {
-        liveRef.current = { available, busy, invoke, onReady };
-    });
     const handle = useMemo(() => ({
         send: (text) => {
             const live = liveRef.current;

package/dist/strings.d.ts

@@ -106,7 +106,6 @@ export interface ChatStrings {
     send: string;
     stop: string;
 }
-/** Humanize a wire tool name: `render_weather-card` → `render weather card`. */
 export declare function humanizeToolName(wireName: string): string;
 export declare const defaultChatStrings: ChatStrings;
 //# sourceMappingURL=strings.d.ts.map

package/dist/strings.d.ts.map

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

package/dist/strings.js

@@ -1,5 +1,28 @@
 /** Humanize a wire tool name: `render_weather-card` → `render weather card`. */
+/**
+ * The ggui generative-UI rail's tool vocabulary, in end-user words
+ * (guuey#307): raw wire names ("mcp ggui ggui handshake") read as
+ * internals on every card-bearing conversation — and the rail is the
+ * platform default (mcp.ggui.ai), so the kit owns its voice the same
+ * way it owns the card machinery.
+ */
+const GGUI_RAIL_TITLES = {
+    ggui_handshake: "Preparing interactive card",
+    ggui_render: "Rendering card",
+    ggui_consume: "Updating interactive card",
+    ggui_update: "Updating card",
+};
 export function humanizeToolName(wireName) {
+    // MCP wire shape: `mcp__<server>__<tool>` (double-underscore separators).
+    const mcp = /^mcp__([^_].*?)__(.+)$/.exec(wireName);
+    if (mcp) {
+        const [, server, tool] = mcp;
+        if (server === "ggui" && GGUI_RAIL_TITLES[tool])
+            return GGUI_RAIL_TITLES[tool];
+        const prettyServer = server.charAt(0).toUpperCase() + server.slice(1).replace(/[_-]+/g, " ");
+        const prettyTool = tool.replace(/[_-]+/g, " ").trim();
+        return `${prettyServer} · ${prettyTool}`;
+    }
     return wireName.replace(/[_-]+/g, " ").trim();
 }
 export const defaultChatStrings = {

package/dist/theme.d.ts

@@ -34,8 +34,122 @@ export declare const GuueyChatPalette: z.ZodObject<{
     error: z.ZodString;
 }, z.core.$loose>;
 export type GuueyChatPalette = z.infer<typeof GuueyChatPalette>;
+/**
+ * STATED ramp slots (theme-as-code, guuey#341 spec §3 — never derived).
+ * Closed per-family sets: `accent` carries the full ladder (the
+ * 500/600/700 floor is a WRITE/COMPILE rule, not a schema rule — the
+ * schema admits any stated subset so a stale stored document still parses);
+ * the status families carry their tone-500 slot. Ramps live BESIDE the
+ * palettes (`theme.ramps.{light,dark}`), never inside them — the flat
+ * palette record is a load-bearing invariant (token lists are DERIVED from
+ * its shape by every platform gate).
+ */
+export declare const GuueyChatAccentRamp: z.ZodObject<{
+    "100": z.ZodOptional<z.ZodString>;
+    "300": z.ZodOptional<z.ZodString>;
+    "500": z.ZodOptional<z.ZodString>;
+    "600": z.ZodOptional<z.ZodString>;
+    "700": z.ZodOptional<z.ZodString>;
+    "800": z.ZodOptional<z.ZodString>;
+    "900": z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type GuueyChatAccentRamp = z.infer<typeof GuueyChatAccentRamp>;
+export declare const GuueyChatErrorRamp: z.ZodObject<{
+    "500": z.ZodOptional<z.ZodString>;
+    "600": z.ZodOptional<z.ZodString>;
+    "700": z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type GuueyChatErrorRamp = z.infer<typeof GuueyChatErrorRamp>;
+export declare const GuueyChatToneRamp: z.ZodObject<{
+    "500": z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type GuueyChatToneRamp = z.infer<typeof GuueyChatToneRamp>;
+/** One mode's stated ramp families — every family optional. */
+export declare const GuueyChatRampSet: z.ZodObject<{
+    accent: z.ZodOptional<z.ZodObject<{
+        "100": z.ZodOptional<z.ZodString>;
+        "300": z.ZodOptional<z.ZodString>;
+        "500": z.ZodOptional<z.ZodString>;
+        "600": z.ZodOptional<z.ZodString>;
+        "700": z.ZodOptional<z.ZodString>;
+        "800": z.ZodOptional<z.ZodString>;
+        "900": z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    error: z.ZodOptional<z.ZodObject<{
+        "500": z.ZodOptional<z.ZodString>;
+        "600": z.ZodOptional<z.ZodString>;
+        "700": z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    success: z.ZodOptional<z.ZodObject<{
+        "500": z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    warning: z.ZodOptional<z.ZodObject<{
+        "500": z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    info: z.ZodOptional<z.ZodObject<{
+        "500": z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type GuueyChatRampSet = z.infer<typeof GuueyChatRampSet>;
+export declare const GuueyChatRamps: z.ZodObject<{
+    light: z.ZodOptional<z.ZodObject<{
+        accent: z.ZodOptional<z.ZodObject<{
+            "100": z.ZodOptional<z.ZodString>;
+            "300": z.ZodOptional<z.ZodString>;
+            "500": z.ZodOptional<z.ZodString>;
+            "600": z.ZodOptional<z.ZodString>;
+            "700": z.ZodOptional<z.ZodString>;
+            "800": z.ZodOptional<z.ZodString>;
+            "900": z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        error: z.ZodOptional<z.ZodObject<{
+            "500": z.ZodOptional<z.ZodString>;
+            "600": z.ZodOptional<z.ZodString>;
+            "700": z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        success: z.ZodOptional<z.ZodObject<{
+            "500": z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        warning: z.ZodOptional<z.ZodObject<{
+            "500": z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        info: z.ZodOptional<z.ZodObject<{
+            "500": z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+    dark: z.ZodOptional<z.ZodObject<{
+        accent: z.ZodOptional<z.ZodObject<{
+            "100": z.ZodOptional<z.ZodString>;
+            "300": z.ZodOptional<z.ZodString>;
+            "500": z.ZodOptional<z.ZodString>;
+            "600": z.ZodOptional<z.ZodString>;
+            "700": z.ZodOptional<z.ZodString>;
+            "800": z.ZodOptional<z.ZodString>;
+            "900": z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        error: z.ZodOptional<z.ZodObject<{
+            "500": z.ZodOptional<z.ZodString>;
+            "600": z.ZodOptional<z.ZodString>;
+            "700": z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        success: z.ZodOptional<z.ZodObject<{
+            "500": z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        warning: z.ZodOptional<z.ZodObject<{
+            "500": z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        info: z.ZodOptional<z.ZodObject<{
+            "500": z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type GuueyChatRamps = z.infer<typeof GuueyChatRamps>;
 export declare const GuueyChatTheme: z.ZodObject<{
     name: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>>;
     colors: z.ZodObject<{
         light: z.ZodObject<{
             accent: z.ZodString;
@@ -58,6 +172,58 @@ export declare const GuueyChatTheme: z.ZodObject<{
             error: z.ZodString;
         }, z.core.$loose>;
     }, z.core.$loose>;
+    ramps: z.ZodOptional<z.ZodObject<{
+        light: z.ZodOptional<z.ZodObject<{
+            accent: z.ZodOptional<z.ZodObject<{
+                "100": z.ZodOptional<z.ZodString>;
+                "300": z.ZodOptional<z.ZodString>;
+                "500": z.ZodOptional<z.ZodString>;
+                "600": z.ZodOptional<z.ZodString>;
+                "700": z.ZodOptional<z.ZodString>;
+                "800": z.ZodOptional<z.ZodString>;
+                "900": z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            error: z.ZodOptional<z.ZodObject<{
+                "500": z.ZodOptional<z.ZodString>;
+                "600": z.ZodOptional<z.ZodString>;
+                "700": z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            success: z.ZodOptional<z.ZodObject<{
+                "500": z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            warning: z.ZodOptional<z.ZodObject<{
+                "500": z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            info: z.ZodOptional<z.ZodObject<{
+                "500": z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
+        dark: z.ZodOptional<z.ZodObject<{
+            accent: z.ZodOptional<z.ZodObject<{
+                "100": z.ZodOptional<z.ZodString>;
+                "300": z.ZodOptional<z.ZodString>;
+                "500": z.ZodOptional<z.ZodString>;
+                "600": z.ZodOptional<z.ZodString>;
+                "700": z.ZodOptional<z.ZodString>;
+                "800": z.ZodOptional<z.ZodString>;
+                "900": z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            error: z.ZodOptional<z.ZodObject<{
+                "500": z.ZodOptional<z.ZodString>;
+                "600": z.ZodOptional<z.ZodString>;
+                "700": z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            success: z.ZodOptional<z.ZodObject<{
+                "500": z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            warning: z.ZodOptional<z.ZodObject<{
+                "500": z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            info: z.ZodOptional<z.ZodObject<{
+                "500": z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
     typography: z.ZodObject<{
         fontFamily: z.ZodOptional<z.ZodString>;
         monoFontFamily: z.ZodOptional<z.ZodString>;

package/dist/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;iBAWnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBjB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,cA0BhC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,cA0B9B,CAAC;AA0CF;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,OAAO,EAClB,IAAI,GAAE,cAAmC,GACxC,cAAc,CAgBhB"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;iBAWnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;iBAUtB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,kBAAkB;;;;iBAMrB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,iBAAiB;;iBAAqD,CAAC;AACpF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;iBAQnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKjB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BjB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,cA0BhC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,cA0B9B,CAAC;AA4CF;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,OAAO,EAClB,IAAI,GAAE,cAAmC,GACxC,cAAc,CAuBhB"}

package/dist/theme.js

@@ -35,11 +35,67 @@ export const GuueyChatPalette = z
     error: z.string(),
 })
     .loose();
+/**
+ * STATED ramp slots (theme-as-code, guuey#341 spec §3 — never derived).
+ * Closed per-family sets: `accent` carries the full ladder (the
+ * 500/600/700 floor is a WRITE/COMPILE rule, not a schema rule — the
+ * schema admits any stated subset so a stale stored document still parses);
+ * the status families carry their tone-500 slot. Ramps live BESIDE the
+ * palettes (`theme.ramps.{light,dark}`), never inside them — the flat
+ * palette record is a load-bearing invariant (token lists are DERIVED from
+ * its shape by every platform gate).
+ */
+export const GuueyChatAccentRamp = z
+    .object({
+    "100": z.string().optional(),
+    "300": z.string().optional(),
+    "500": z.string().optional(),
+    "600": z.string().optional(),
+    "700": z.string().optional(),
+    "800": z.string().optional(),
+    "900": z.string().optional(),
+})
+    .loose();
+export const GuueyChatErrorRamp = z
+    .object({
+    "500": z.string().optional(),
+    "600": z.string().optional(),
+    "700": z.string().optional(),
+})
+    .loose();
+export const GuueyChatToneRamp = z.object({ "500": z.string().optional() }).loose();
+/** One mode's stated ramp families — every family optional. */
+export const GuueyChatRampSet = z
+    .object({
+    accent: GuueyChatAccentRamp.optional(),
+    error: GuueyChatErrorRamp.optional(),
+    success: GuueyChatToneRamp.optional(),
+    warning: GuueyChatToneRamp.optional(),
+    info: GuueyChatToneRamp.optional(),
+})
+    .loose();
+export const GuueyChatRamps = z
+    .object({
+    light: GuueyChatRampSet.optional(),
+    dark: GuueyChatRampSet.optional(),
+})
+    .loose();
 export const GuueyChatTheme = z
     .object({
     name: z.string(),
+    /**
+     * The app's CANONICAL presentation mode (theme-as-code §3) — what the
+     * ggui stamp pins its render slice to. OPTIONAL and default-less on
+     * purpose: absent = "not stated", and the platform's legacy polarity
+     * derivation stands. Distinct from the VIEWER's runtime light/dark
+     * choice, which stays a component prop — chat components never read
+     * this field.
+     */
+    mode: z.enum(["light", "dark"]).optional(),
     /** BOTH palettes always present — mode is the consumer's runtime choice. */
     colors: z.object({ light: GuueyChatPalette, dark: GuueyChatPalette }).loose(),
+    /** Stated ramp slots per mode — see {@link GuueyChatRamps}. */
+    ramps: GuueyChatRamps.optional(),
     typography: z
         .object({
         fontFamily: z.string().optional(),
@@ -126,10 +182,12 @@ const PartialPalette = GuueyChatPalette.partial();
 const PartialTheme = z
     .object({
     name: z.string().optional(),
+    mode: GuueyChatTheme.shape.mode.optional(),
     colors: z
         .object({ light: PartialPalette.optional(), dark: PartialPalette.optional() })
         .loose()
         .optional(),
+    ramps: GuueyChatRamps.optional(),
     typography: GuueyChatTheme.shape.typography.optional(),
     shape: GuueyChatTheme.shape.shape.partial().loose().optional(),
 })
@@ -167,12 +225,19 @@ export function resolveTheme(candidate, base = DEFAULT_CHAT_THEME) {
     if (!parsed.success)
         return { ...base, colors: { light: { ...base.colors.light }, dark: { ...base.colors.dark } } };
     const p = parsed.data;
+    const mode = p.mode ?? base.mode;
+    const ramps = mergeRamps(base.ramps, p.ramps);
     return {
         name: p.name ?? base.name,
+        // `mode`/`ramps` are default-less (the package themes state neither):
+        // they appear on the resolved theme only when SOME layer stated them —
+        // an absent statement must stay visibly absent, not become a default.
+        ...(mode !== undefined ? { mode } : {}),
         colors: {
             light: mergePalette(base.colors.light, p.colors?.light),
             dark: mergePalette(base.colors.dark, p.colors?.dark),
         },
+        ...(ramps !== undefined ? { ramps } : {}),
         typography: { ...base.typography, ...(p.typography ?? {}) },
         shape: {
             radius: p.shape?.radius ?? base.shape.radius,
@@ -180,3 +245,31 @@ export function resolveTheme(candidate, base = DEFAULT_CHAT_THEME) {
         },
     };
 }
+/** Slot-level merge of two ramp statements (candidate slots win per slot). */
+function mergeRampSet(base, over) {
+    if (base === undefined)
+        return over;
+    if (over === undefined)
+        return base;
+    const merged = { ...base };
+    for (const family of ["accent", "error", "success", "warning", "info"]) {
+        const b = base[family];
+        const o = over[family];
+        if (o === undefined)
+            continue;
+        merged[family] = b === undefined ? o : { ...b, ...o };
+    }
+    return merged;
+}
+function mergeRamps(base, over) {
+    if (base === undefined)
+        return over;
+    if (over === undefined)
+        return base;
+    const light = mergeRampSet(base.light, over.light);
+    const dark = mergeRampSet(base.dark, over.dark);
+    return {
+        ...(light !== undefined ? { light } : {}),
+        ...(dark !== undefined ? { dark } : {}),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guuey/chat",
-  "version": "0.12.2",
+  "version": "0.14.0",
   "description": "The default end-user transcript UI for guuey agents — the headless view-model (planTranscript), calm/debug presets, the GuueyChatTheme token schema, the ChatStrings i18n seam, and (at ./react) the component kit that renders it: per-category components, <Transcript>, the live + history input assemblers, and stick-to-bottom/windowed/accessible transcript behavior; at ./native, the React Native renderer over the same view-model.",
   "license": "MIT",
   "type": "module",
@@ -39,8 +39,8 @@
     "@silverprotocol/core": "0.5.1",
     "@silverprotocol/richtext": "0.5.1",
     "zod": "^4.3.6",
-    "@guuey/agent-client": "0.12.2",
-    "@guuey/mcp-apps-host": "0.12.2"
+    "@guuey/agent-client": "0.14.0",
+    "@guuey/mcp-apps-host": "0.14.0"
   },
   "peerDependencies": {
     "react": ">=18",
@@ -65,7 +65,7 @@
     "react-dom": "^19.0.0",
     "react-native": "0.81.5",
     "typescript": "^5.0.0",
-    "vitest": "^3.0.0"
+    "vitest": "^3.2.7"
   },
   "publishConfig": {
     "access": "public"

package/src/index.ts

@@ -16,6 +16,7 @@ export {
 } from "./plan.js";
 export {
   calmPolicy,
+  type TranscriptPolicyOverrides,
   debugPolicy,
   type TranscriptPolicy,
 } from "./policy.js";
@@ -46,8 +47,13 @@ export {
 export {
   DEFAULT_CHAT_THEME,
   GUUEY_CHAT_THEME,
+  GuueyChatAccentRamp,
+  GuueyChatErrorRamp,
   GuueyChatPalette,
+  GuueyChatRamps,
+  GuueyChatRampSet,
   GuueyChatTheme,
+  GuueyChatToneRamp,
   resolveTheme,
 } from "./theme.js";
 export type {

package/src/policy.ts

@@ -85,7 +85,17 @@ export interface TranscriptPolicy {
 }
 
 /** Deep-ish merge for the one level of nesting policies actually have. */
-function withOverrides(base: TranscriptPolicy, overrides?: Partial<TranscriptPolicy>): TranscriptPolicy {
+/**
+ * Per-section partial overrides — the shape `withOverrides` actually
+ * merges (each section spreads over its base), so the type tells the
+ * truth: `{ view: { presentation: 'chips' } }` is valid without
+ * restating the section's other fields (guuey#321 surfaced the lie).
+ */
+export type TranscriptPolicyOverrides = {
+  [K in keyof TranscriptPolicy]?: Partial<TranscriptPolicy[K]>;
+};
+
+function withOverrides(base: TranscriptPolicy, overrides?: TranscriptPolicyOverrides): TranscriptPolicy {
   if (!overrides) return base;
   return {
     ...base,
@@ -135,12 +145,12 @@ function calmBase(): TranscriptPolicy {
 }
 
 /** The `calm` preset — the end-user default (spec §5). */
-export function calmPolicy(overrides?: Partial<TranscriptPolicy>): TranscriptPolicy {
+export function calmPolicy(overrides?: TranscriptPolicyOverrides): TranscriptPolicy {
   return withOverrides(calmBase(), overrides);
 }
 
 /** The `debug` preset — the builder surface (Studio's test chat, spec §5). */
-export function debugPolicy(overrides?: Partial<TranscriptPolicy>): TranscriptPolicy {
+export function debugPolicy(overrides?: TranscriptPolicyOverrides): TranscriptPolicy {
   const base = calmBase();
   const debug: TranscriptPolicy = {
     ...base,

package/src/react/guuey-chat.tsx

@@ -64,9 +64,9 @@ import {
 } from "@guuey/agent-client";
 import type { AgHitlAnswer, AgPausedAsk } from "@silverprotocol/core";
 import { useAgentInvoke } from "@guuey/agent-client/react";
-import { unavailableToolCallResult } from "@guuey/mcp-apps-host";
+import { unavailableToolCallResult, withActionStaging } from "@guuey/mcp-apps-host";
 import type { McpToolCallResult, UiActionRequest, UiResourceReader } from "@guuey/mcp-apps-host";
-import { calmPolicy, debugPolicy, type TranscriptPolicy } from "../policy.js";
+import { calmPolicy, debugPolicy, type TranscriptPolicyOverrides } from "../policy.js";
 import { useStructuralIdentity } from "./structural-identity.js";
 import { defaultChatStrings, type ChatStrings } from "../strings.js";
 import { DEFAULT_CHAT_THEME, type GuueyChatTheme } from "../theme.js";
@@ -192,8 +192,12 @@ export interface GuueyChatProps {
   adapters?: AgentInvokeAdapters;
   /** Policy preset (spec §5). Default `"calm"`. */
   preset?: "calm" | "debug";
-  /** Knob overrides applied on top of the preset (spec §3's columns). */
-  policy?: Partial<TranscriptPolicy>;
+  /**
+   * Knob overrides applied on top of the preset (spec §3's columns) —
+   * per-SECTION partials (`{ view: { presentation: "chips" } }` needs no
+   * other view fields; guuey#321 made the type tell the merge's truth).
+   */
+  policy?: TranscriptPolicyOverrides;
   /** Per-slot component overrides (spec §3's override column). */
   components?: Partial<TranscriptComponents>;
   /** String overrides — merged over the preset's `ChatStrings` (§4.2). */
@@ -443,6 +447,26 @@ export const GuueyChat = forwardRef<GuueyChatHandle, GuueyChatProps>(function Gu
   // `viewProps.hostContext` keys win; `theme` is only defaulted. Hosts
   // mounting views DIRECTLY (a canvas over the roster) announce on their
   // own <GuueyView hostContext> — this covers the kit's own mounts.
+  // ── Composer ─────────────────────────────────────────────────────────
+  const [input, setInput] = useState("");
+  const inputRef = useRef<HTMLTextAreaElement | null>(null);
+  // Browser form-field heuristics (a11y/autofill lints) flag a field with
+  // neither id nor name on every embedding site. useId keeps the id unique
+  // when several chats mount on one page — a static id would collide.
+  const composerId = useId();
+  const busy = invoke.status !== "ready";
+  const available = endpointUrl !== null;
+  const canSend = available && !busy && input.trim() !== "";
+
+  // ── The imperative seam (guuey#210) ──────────────────────────────────
+  // ONE stable handle for the component's whole life (hosts capture it in
+  // `onReady` and keep it), reading live truth through a ref so a call
+  // always sees the CURRENT gate — never a stale closure's.
+  const liveRef = useRef({ available, busy, invoke, onReady });
+  useEffect(() => {
+    liveRef.current = { available, busy, invoke, onReady };
+  });
+
   // The DEFAULT ACTION RELAY (guuey#335 — the founder-hit Confirm bug):
   // pod-then-persisted, built over the SAME identity as the reader, thread
   // read through the ref at CALL time. Without it, a kit-mounted render's
@@ -480,13 +504,32 @@ export const GuueyChat = forwardRef<GuueyChatHandle, GuueyChatProps>(function Gu
     });
   }, []);
 
+  // Post-turn action STAGING (guuey#356 — the widget's ratified #198/#215/
+  // #218 policy, ONE copy in the kit): with no live turn, an allowlisted
+  // semantic card action stages its human-readable projection into the
+  // composer (append, never clobber — the staged-composer semantic) and the
+  // view hears the queued acceptance; everything else rides the relay path
+  // untouched. Rides viewSlotProps too, so canvas hosts get it for free.
+  const stagedDefaultOnCallTool = useMemo<
+    ((request: UiActionRequest) => Promise<McpToolCallResult>) | undefined
+  >(() => {
+    if (defaultOnCallTool === undefined) return undefined;
+    return withActionStaging(defaultOnCallTool, {
+      isTurnLive: () => liveRef.current.busy,
+      stage: (text) => {
+        setInput((prev) => (prev.trim() === "" ? text : `${prev.trimEnd()} ${text}`));
+        inputRef.current?.focus();
+      },
+    });
+  }, [defaultOnCallTool]);
+
   const effectiveViewProps = useMemo<TranscriptItemContext["viewProps"]>(
     () =>
       viewPropsWithThemeAnnounce(viewProps, mode, {
-        ...(defaultOnCallTool !== undefined ? { onCallTool: defaultOnCallTool } : {}),
+        ...(stagedDefaultOnCallTool !== undefined ? { onCallTool: stagedDefaultOnCallTool } : {}),
         onUpdateModelContext: defaultOnUpdateModelContext,
       }),
-    [viewProps, mode, defaultOnCallTool, defaultOnUpdateModelContext],
+    [viewProps, mode, stagedDefaultOnCallTool, defaultOnUpdateModelContext],
   );
 
   // The canvas-host door (guuey#335): a host mounting views DIRECTLY from
@@ -499,32 +542,12 @@ export const GuueyChat = forwardRef<GuueyChatHandle, GuueyChatProps>(function Gu
   staticSlotPropsRef.current =
     typeof effectiveViewProps === "function"
       ? {
-          ...(defaultOnCallTool !== undefined ? { onCallTool: defaultOnCallTool } : {}),
+          ...(stagedDefaultOnCallTool !== undefined ? { onCallTool: stagedDefaultOnCallTool } : {}),
           onUpdateModelContext: defaultOnUpdateModelContext,
           hostContext: { theme: mode },
         }
       : (effectiveViewProps ?? {});
 
-  // ── Composer ─────────────────────────────────────────────────────────
-  const [input, setInput] = useState("");
-  const inputRef = useRef<HTMLTextAreaElement | null>(null);
-  // Browser form-field heuristics (a11y/autofill lints) flag a field with
-  // neither id nor name on every embedding site. useId keeps the id unique
-  // when several chats mount on one page — a static id would collide.
-  const composerId = useId();
-  const busy = invoke.status !== "ready";
-  const available = endpointUrl !== null;
-  const canSend = available && !busy && input.trim() !== "";
-
-  // ── The imperative seam (guuey#210) ──────────────────────────────────
-  // ONE stable handle for the component's whole life (hosts capture it in
-  // `onReady` and keep it), reading live truth through a ref so a call
-  // always sees the CURRENT gate — never a stale closure's.
-  const liveRef = useRef({ available, busy, invoke, onReady });
-  useEffect(() => {
-    liveRef.current = { available, busy, invoke, onReady };
-  });
-
   const handle = useMemo<GuueyChatHandle>(
     () => ({
       send: (text: string): boolean => {

package/src/strings.ts

@@ -123,7 +123,30 @@ export interface ChatStrings {
 }
 
 /** Humanize a wire tool name: `render_weather-card` → `render weather card`. */
+/**
+ * The ggui generative-UI rail's tool vocabulary, in end-user words
+ * (guuey#307): raw wire names ("mcp ggui ggui handshake") read as
+ * internals on every card-bearing conversation — and the rail is the
+ * platform default (mcp.ggui.ai), so the kit owns its voice the same
+ * way it owns the card machinery.
+ */
+const GGUI_RAIL_TITLES: Record<string, string> = {
+  ggui_handshake: "Preparing interactive card",
+  ggui_render: "Rendering card",
+  ggui_consume: "Updating interactive card",
+  ggui_update: "Updating card",
+};
+
 export function humanizeToolName(wireName: string): string {
+  // MCP wire shape: `mcp__<server>__<tool>` (double-underscore separators).
+  const mcp = /^mcp__([^_].*?)__(.+)$/.exec(wireName);
+  if (mcp) {
+    const [, server, tool] = mcp;
+    if (server === "ggui" && GGUI_RAIL_TITLES[tool]) return GGUI_RAIL_TITLES[tool];
+    const prettyServer = server.charAt(0).toUpperCase() + server.slice(1).replace(/[_-]+/g, " ");
+    const prettyTool = tool.replace(/[_-]+/g, " ").trim();
+    return `${prettyServer} · ${prettyTool}`;
+  }
   return wireName.replace(/[_-]+/g, " ").trim();
 }
 

package/src/theme.ts

@@ -38,11 +38,77 @@ export const GuueyChatPalette = z
   .loose();
 export type GuueyChatPalette = z.infer<typeof GuueyChatPalette>;
 
+/**
+ * STATED ramp slots (theme-as-code, guuey#341 spec §3 — never derived).
+ * Closed per-family sets: `accent` carries the full ladder (the
+ * 500/600/700 floor is a WRITE/COMPILE rule, not a schema rule — the
+ * schema admits any stated subset so a stale stored document still parses);
+ * the status families carry their tone-500 slot. Ramps live BESIDE the
+ * palettes (`theme.ramps.{light,dark}`), never inside them — the flat
+ * palette record is a load-bearing invariant (token lists are DERIVED from
+ * its shape by every platform gate).
+ */
+export const GuueyChatAccentRamp = z
+  .object({
+    "100": z.string().optional(),
+    "300": z.string().optional(),
+    "500": z.string().optional(),
+    "600": z.string().optional(),
+    "700": z.string().optional(),
+    "800": z.string().optional(),
+    "900": z.string().optional(),
+  })
+  .loose();
+export type GuueyChatAccentRamp = z.infer<typeof GuueyChatAccentRamp>;
+
+export const GuueyChatErrorRamp = z
+  .object({
+    "500": z.string().optional(),
+    "600": z.string().optional(),
+    "700": z.string().optional(),
+  })
+  .loose();
+export type GuueyChatErrorRamp = z.infer<typeof GuueyChatErrorRamp>;
+
+export const GuueyChatToneRamp = z.object({ "500": z.string().optional() }).loose();
+export type GuueyChatToneRamp = z.infer<typeof GuueyChatToneRamp>;
+
+/** One mode's stated ramp families — every family optional. */
+export const GuueyChatRampSet = z
+  .object({
+    accent: GuueyChatAccentRamp.optional(),
+    error: GuueyChatErrorRamp.optional(),
+    success: GuueyChatToneRamp.optional(),
+    warning: GuueyChatToneRamp.optional(),
+    info: GuueyChatToneRamp.optional(),
+  })
+  .loose();
+export type GuueyChatRampSet = z.infer<typeof GuueyChatRampSet>;
+
+export const GuueyChatRamps = z
+  .object({
+    light: GuueyChatRampSet.optional(),
+    dark: GuueyChatRampSet.optional(),
+  })
+  .loose();
+export type GuueyChatRamps = z.infer<typeof GuueyChatRamps>;
+
 export const GuueyChatTheme = z
   .object({
     name: z.string(),
+    /**
+     * The app's CANONICAL presentation mode (theme-as-code §3) — what the
+     * ggui stamp pins its render slice to. OPTIONAL and default-less on
+     * purpose: absent = "not stated", and the platform's legacy polarity
+     * derivation stands. Distinct from the VIEWER's runtime light/dark
+     * choice, which stays a component prop — chat components never read
+     * this field.
+     */
+    mode: z.enum(["light", "dark"]).optional(),
     /** BOTH palettes always present — mode is the consumer's runtime choice. */
     colors: z.object({ light: GuueyChatPalette, dark: GuueyChatPalette }).loose(),
+    /** Stated ramp slots per mode — see {@link GuueyChatRamps}. */
+    ramps: GuueyChatRamps.optional(),
     typography: z
       .object({
         fontFamily: z.string().optional(),
@@ -133,10 +199,12 @@ const PartialPalette = GuueyChatPalette.partial();
 const PartialTheme = z
   .object({
     name: z.string().optional(),
+    mode: GuueyChatTheme.shape.mode.optional(),
     colors: z
       .object({ light: PartialPalette.optional(), dark: PartialPalette.optional() })
       .loose()
       .optional(),
+    ramps: GuueyChatRamps.optional(),
     typography: GuueyChatTheme.shape.typography.optional(),
     shape: GuueyChatTheme.shape.shape.partial().loose().optional(),
   })
@@ -180,12 +248,19 @@ export function resolveTheme(
   const parsed = PartialTheme.safeParse(candidate);
   if (!parsed.success) return { ...base, colors: { light: { ...base.colors.light }, dark: { ...base.colors.dark } } };
   const p = parsed.data;
+  const mode = p.mode ?? base.mode;
+  const ramps = mergeRamps(base.ramps, p.ramps);
   return {
     name: p.name ?? base.name,
+    // `mode`/`ramps` are default-less (the package themes state neither):
+    // they appear on the resolved theme only when SOME layer stated them —
+    // an absent statement must stay visibly absent, not become a default.
+    ...(mode !== undefined ? { mode } : {}),
     colors: {
       light: mergePalette(base.colors.light, p.colors?.light),
       dark: mergePalette(base.colors.dark, p.colors?.dark),
     },
+    ...(ramps !== undefined ? { ramps } : {}),
     typography: { ...base.typography, ...(p.typography ?? {}) },
     shape: {
       radius: p.shape?.radius ?? base.shape.radius,
@@ -193,3 +268,34 @@ export function resolveTheme(
     },
   };
 }
+
+/** Slot-level merge of two ramp statements (candidate slots win per slot). */
+function mergeRampSet(
+  base: GuueyChatRampSet | undefined,
+  over: GuueyChatRampSet | undefined,
+): GuueyChatRampSet | undefined {
+  if (base === undefined) return over;
+  if (over === undefined) return base;
+  const merged: GuueyChatRampSet = { ...base };
+  for (const family of ["accent", "error", "success", "warning", "info"] as const) {
+    const b = base[family];
+    const o = over[family];
+    if (o === undefined) continue;
+    merged[family] = b === undefined ? o : { ...b, ...o };
+  }
+  return merged;
+}
+
+function mergeRamps(
+  base: GuueyChatRamps | undefined,
+  over: GuueyChatRamps | undefined,
+): GuueyChatRamps | undefined {
+  if (base === undefined) return over;
+  if (over === undefined) return base;
+  const light = mergeRampSet(base.light, over.light);
+  const dark = mergeRampSet(base.dark, over.dark);
+  return {
+    ...(light !== undefined ? { light } : {}),
+    ...(dark !== undefined ? { dark } : {}),
+  };
+}