@guuey/chat 0.13.0 → 0.14.0

package/dist/index.d.ts

@@ -11,7 +11,7 @@
  * 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";

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,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"}
+{"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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guuey/chat",
-  "version": "0.13.0",
+  "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.13.0",
-    "@guuey/mcp-apps-host": "0.13.0"
+    "@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";

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 => {