@steerable/agent-ui 0.2.5 → 0.4.0

package/dist/hooks/index.d.ts

@@ -1,5 +1,5 @@
 export { useChatStream } from './useChatStream.js';
-export type { UseChatStreamOptions, UseChatStreamReturn, ChatStreamTransport, ChatStreamSendInput, } from './useChatStream.js';
+export type { UseChatStreamOptions, UseChatStreamReturn, ChatStreamTransport, ChatStreamSendInput, SteerOutcome, } from './useChatStream.js';
 export { useToolCallStatus } from './useToolCallStatus.js';
 export type { ToolCallStatus, UseToolCallStatusOptions, UseToolCallStatusReturn, } from './useToolCallStatus.js';
 export { useAgentSession } from './useAgentSession.js';

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,cAAc,EACd,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,cAAc,EACd,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/hooks/useChatStream.d.ts

@@ -35,6 +35,17 @@ export interface ChatStreamTransport {
      */
     steer?: (content: string) => Promise<boolean>;
 }
+/**
+ * Where `steerOrFollowUpUserMessage` actually delivered the message:
+ *   - `'steered'` — the running turn accepted the injection.
+ *   - `'queued'` — the turn is still running but not steerable; the message
+ *     sits in the W6-2 follow-up queue and auto-sends at turn end.
+ *   - `'sent'` — no turn was running by the time the steer attempt settled;
+ *     the message went out immediately as a normal new turn.
+ * The union lets callers render their own locale-specific notice per
+ * outcome; the hook itself carries no user-facing copy.
+ */
+export type SteerOutcome = 'steered' | 'queued' | 'sent';
 export interface UseChatStreamOptions {
     /** Required transport handle; see `ChatStreamTransport`. */
     transport: ChatStreamTransport;
@@ -56,7 +67,23 @@ export interface UseChatStreamOptions {
 export interface UseChatStreamReturn {
     messages: ChatMessage[];
     isStreaming: boolean;
+    /**
+     * Send a user message. Queue-safe (W6-2): if a turn is currently streaming
+     * the message is NOT dropped — it is appended to the follow-up queue and
+     * sent automatically as the next turn when the current one ends.
+     */
     sendUserMessage: (input: ChatStreamSendInput) => Promise<void>;
+    /**
+     * W7-1: resume the interrupted turn recorded on the backend. Streams an
+     * assistant turn WITHOUT appending a user message — the transport receives
+     * `{ content: '', metadata: { ...input?.metadata, resume: true } }` and the
+     * backend replays the durable record's projection as the loop seed, so the
+     * user never retypes the interrupted request. No-op while streaming (a
+     * resume is not queueable as a follow-up — it is not a user message).
+     */
+    resumeTurn: (input?: {
+        metadata?: Record<string, unknown>;
+    }) => Promise<void>;
     /**
      * Steer the running turn with an extra user message. No-op resolving
      * `false` when not streaming or the transport has no `steer`. On success
@@ -64,6 +91,27 @@ export interface UseChatStreamReturn {
      * consumes it at the next round boundary).
      */
     steerUserMessage: (content: string) => Promise<boolean>;
+    /**
+     * Steer with a never-drop fallback (W6-2): tries `steerUserMessage` first,
+     * then degrades based on live turn state — see `SteerOutcome` for the
+     * three outcomes. The turn-already-ended race is resolved by re-checking
+     * `isStreaming` after the steer attempt settles: a finished turn's
+     * `finally` has already drained the queue, so queueing there would strand
+     * the message until some future turn ends — it is sent directly instead.
+     * Prefer this over `steerUserMessage` for composer Enter handlers.
+     */
+    steerOrFollowUpUserMessage: (content: string) => Promise<SteerOutcome>;
+    /**
+     * Explicitly queue a message as a follow-up (W6-2): sent automatically as
+     * the next turn once the current turn finishes. When not streaming this is
+     * equivalent to `sendUserMessage`. Distinct from `steerUserMessage`, which
+     * redirects the *current* turn mid-flight.
+     */
+    followUpUserMessage: (input: ChatStreamSendInput) => void;
+    /** Follow-up messages queued while streaming, in order (not yet sent). */
+    pendingFollowUps: ChatStreamSendInput[];
+    /** Remove a queued follow-up by index (e.g. the user withdraws it). */
+    removeFollowUp: (index: number) => void;
     cancel: () => void;
     /** Replace the message buffer (e.g. when switching chat). */
     setMessages: (messages: ChatMessage[]) => void;

package/dist/hooks/useChatStream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useChatStream.d.ts","sourceRoot":"","sources":["../../src/hooks/useChatStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EAER,UAAU,EACX,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;OAQG;IACH,MAAM,EAAE,CACN,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,KAC/B,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAClC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,SAAS,EAAE,mBAAmB,CAAC;IAC/B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,WAAW,GAAG,IAAI,CAAC;IACjE;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D;;;;;OAKG;IACH,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6DAA6D;IAC7D,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAC/C,mEAAmE;IACnE,aAAa,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC/C;AAsID,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,CAsJrB"}
+{"version":3,"file":"useChatStream.d.ts","sourceRoot":"","sources":["../../src/hooks/useChatStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EAER,UAAU,EACX,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;OAQG;IACH,MAAM,EAAE,CACN,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,KAC/B,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAClC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/C;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,SAAS,EAAE,mBAAmB,CAAC;IAC/B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,WAAW,GAAG,IAAI,CAAC;IACjE;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D;;;;;;;OAOG;IACH,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E;;;;;OAKG;IACH,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD;;;;;;;;OAQG;IACH,0BAA0B,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACvE;;;;;OAKG;IACH,mBAAmB,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC1D,0EAA0E;IAC1E,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;IACxC,uEAAuE;IACvE,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6DAA6D;IAC7D,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAC/C,mEAAmE;IACnE,aAAa,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC/C;AAsID,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,CA+QrB"}

package/dist/hooks/useChatStream.js

@@ -133,6 +133,14 @@ export function useChatStream(options) {
     const isStreamingRef = useRef(false);
     const cancelRef = useRef(null);
     const [, forceRerender] = useReducer((x) => x + 1, 0);
+    // W6-2 follow-up queue: messages submitted while a turn is streaming. Kept
+    // in a ref (drained imperatively at turn end) with a version counter to
+    // re-render consumers that show the pending queue.
+    const followUpsRef = useRef([]);
+    const [followUpVersion, bumpFollowUpVersion] = useReducer((x) => x + 1, 0);
+    // Self-handle so a finishing turn can start the next queued turn without a
+    // circular useCallback dependency.
+    const sendRef = useRef();
     const setStreaming = useCallback((next) => {
         isStreamingRef.current = next;
         forceRerender();
@@ -193,11 +201,14 @@ export function useChatStream(options) {
                 options.onUnknownEvent?.(event);
         }
     }, [options]);
-    const sendUserMessage = useCallback(async (input) => {
-        if (isStreamingRef.current) {
-            return;
+    // Shared turn core: stream one assistant turn and drain the follow-up
+    // queue at the end. `echoUserMessage` is false only for W7-1 resume —
+    // the interrupted turn's user message is already in the transcript and
+    // the backend replays it from the durable record.
+    const startTurn = useCallback(async (input, opts) => {
+        if (opts.echoUserMessage) {
+            dispatch({ type: 'append', message: newUserMessage(input.content) });
         }
-        dispatch({ type: 'append', message: newUserMessage(input.content) });
         dispatch({ type: 'append', message: newAssistantPlaceholder() });
         setStreaming(true);
         try {
@@ -216,9 +227,51 @@ export function useChatStream(options) {
         finally {
             cancelRef.current = null;
             setStreaming(false);
+            // W6-2: drain the follow-up queue — send the next queued message as
+            // a fresh turn. isStreamingRef is already false here, so the nested
+            // call starts a new turn rather than re-queueing.
+            const next = followUpsRef.current.shift();
+            if (next !== undefined) {
+                bumpFollowUpVersion();
+                void sendRef.current?.(next);
+            }
         }
     }, [handleEvent, options.transport, setStreaming]);
+    const sendUserMessage = useCallback(async (input) => {
+        if (isStreamingRef.current) {
+            // W6-2: queue instead of dropping. The finishing turn's `finally`
+            // drains the queue and starts the next turn automatically.
+            followUpsRef.current = [...followUpsRef.current, input];
+            bumpFollowUpVersion();
+            return;
+        }
+        await startTurn(input, { echoUserMessage: true });
+    }, [startTurn]);
+    const resumeTurn = useCallback(async (input) => {
+        if (isStreamingRef.current)
+            return;
+        await startTurn({ content: '', metadata: { ...input?.metadata, resume: true } }, { echoUserMessage: false });
+    }, [startTurn]);
+    useEffect(() => {
+        sendRef.current = sendUserMessage;
+    }, [sendUserMessage]);
+    const followUpUserMessage = useCallback((input) => {
+        if (!isStreamingRef.current) {
+            void sendRef.current?.(input);
+            return;
+        }
+        followUpsRef.current = [...followUpsRef.current, input];
+        bumpFollowUpVersion();
+    }, []);
+    const removeFollowUp = useCallback((index) => {
+        followUpsRef.current = followUpsRef.current.filter((_, i) => i !== index);
+        bumpFollowUpVersion();
+    }, []);
     const cancel = useCallback(() => {
+        // Cancelling the current turn also drops queued follow-ups — an explicit
+        // stop means "don't keep going", so we don't auto-send what was queued.
+        followUpsRef.current = [];
+        bumpFollowUpVersion();
         if (cancelRef.current) {
             cancelRef.current();
             cancelRef.current = null;
@@ -236,6 +289,38 @@ export function useChatStream(options) {
         }
         return ok;
     }, [options.transport]);
+    const steerOrFollowUpUserMessage = useCallback(async (content) => {
+        const input = { content };
+        // No turn running: there is nothing to inject into and nothing whose
+        // `finally` would drain the queue — a normal send is the only route
+        // that delivers the message.
+        if (!isStreamingRef.current) {
+            void sendRef.current?.(input);
+            return 'sent';
+        }
+        const steer = options.transport.steer;
+        if (steer) {
+            const ok = await steer(content);
+            if (ok) {
+                dispatch({ type: 'append', message: newUserMessage(content) });
+                return 'steered';
+            }
+            // The turn may have ended while the steer was in flight; its
+            // `finally` already ran the queue drain, so a queued message would
+            // sit unsent until an unrelated future turn ends. Send it as a fresh
+            // turn instead. If a queued follow-up already started the next turn,
+            // isStreamingRef is true again and queueing below is correct.
+            if (!isStreamingRef.current) {
+                void sendRef.current?.(input);
+                return 'sent';
+            }
+        }
+        // Turn still running but not steerable (transport lacks `steer`, or
+        // the loop rejected the injection): W6-2 queue, drained at turn end.
+        followUpsRef.current = [...followUpsRef.current, input];
+        bumpFollowUpVersion();
+        return 'queued';
+    }, [options.transport]);
     const setMessages = useCallback((messages) => {
         dispatch({ type: 'reset', messages });
     }, []);
@@ -254,10 +339,30 @@ export function useChatStream(options) {
         messages: state.messages,
         isStreaming: isStreamingRef.current,
         sendUserMessage,
+        resumeTurn,
+        steerUserMessage,
+        steerOrFollowUpUserMessage,
+        followUpUserMessage,
+        // followUpVersion re-keys this memo so queue changes surface to the UI.
+        pendingFollowUps: followUpsRef.current,
+        removeFollowUp,
+        cancel,
+        setMessages,
+        appendMessage,
+    }), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+        state.messages,
+        sendUserMessage,
+        resumeTurn,
         steerUserMessage,
+        steerOrFollowUpUserMessage,
+        followUpUserMessage,
+        removeFollowUp,
         cancel,
         setMessages,
         appendMessage,
-    }), [state.messages, sendUserMessage, steerUserMessage, cancel, setMessages, appendMessage]);
+        followUpVersion,
+    ]);
 }
 //# sourceMappingURL=useChatStream.js.map

package/dist/hooks/useChatStream.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-ui",
-  "version": "0.2.5",
+  "version": "0.4.0",
   "description": "Steerable framework Tier 4 — headless React hooks (useAgentSession, useChatStream, useToolCallStatus) and Tailwind-themed components (ChatPanel, MessageList, OrchestrationPlanCard, ToolCallRenderer, SSEStreamView) for embedding Steerable agents in any React app.",
   "license": "Apache-2.0",
   "homepage": "https://steerableframework.com/storybook/",
@@ -57,7 +57,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@steerable/agent-protocol": "0.2.5"
+    "@steerable/agent-protocol": "0.4.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0",

package/src/hooks/index.ts

@@ -4,6 +4,7 @@ export type {
   UseChatStreamReturn,
   ChatStreamTransport,
   ChatStreamSendInput,
+  SteerOutcome,
 } from './useChatStream.js';
 
 export { useToolCallStatus } from './useToolCallStatus.js';

package/src/hooks/useChatStream.mdx

@@ -33,6 +33,12 @@ const {
   messages,            // ChatMessage[]
   isStreaming,         // boolean
   sendUserMessage,     // ({ content }) => Promise<void>
+  resumeTurn,          // ({ metadata? }?) => Promise<void> — W7-1 crash resume
+  steerUserMessage,    // (content) => Promise<boolean> — raw mid-turn steer
+  steerOrFollowUpUserMessage, // (content) => Promise<SteerOutcome> — steer with never-drop fallback
+  followUpUserMessage, // ({ content }) => void — queue for after the turn (W6-2)
+  pendingFollowUps,    // ChatStreamSendInput[] — queued, not yet sent
+  removeFollowUp,      // (index) => void — withdraw a queued message
   cancel,              // () => void
   setMessages,         // (messages) => void
   appendMessage,       // (message) => void
@@ -113,6 +119,19 @@ const { ... } = useChatStream({
 });
 ```
 
+## Steering and follow-ups (W6-2)
+
+While a turn is streaming there are three ways to submit more input, with different delivery guarantees:
+
+* `steerUserMessage(content)` — raw mid-turn steer. Resolves `true` when the running turn accepted the message (it is appended to the transcript at once); `false` when no steerable turn is active (no transport `steer`, or the turn already ended). On `false` nothing else happens — what to do with the draft is the caller's problem.
+* `followUpUserMessage(input)` — queue the message; it is sent automatically as the next turn when the current turn's `finally` drains the queue. `pendingFollowUps` exposes the queue (in order, not yet sent) and `removeFollowUp(index)` withdraws one. `sendUserMessage` while streaming degrades into this same queue rather than dropping.
+* `steerOrFollowUpUserMessage(content)` — the never-drop combinator, intended for composer Enter handlers. It tries the steer first and resolves a `SteerOutcome` telling the caller where the message landed:
+  * `'steered'` — injected into the running turn.
+  * `'queued'` — the turn is still running but not steerable; the message sits in the follow-up queue and auto-sends at turn end.
+  * `'sent'` — no turn was running by the time the steer attempt settled. This covers the race where the turn ends while `transport.steer` is in flight: that turn's `finally` already drained the queue, so queueing would strand the message until some unrelated future turn ends — it is sent immediately as a normal new turn instead.
+
+The hook exposes only the neutral outcome; rendering any notice ("queued instead of injected", "N queued will be discarded") is the caller's job, in the caller's locale.
+
 ## Cancellation
 
 `transport.stream` may return a `() => void` cancel handle. The hook stores it and calls it when:
@@ -122,8 +141,11 @@ const { ... } = useChatStream({
 
 If your transport can't cancel, return `void` — the hook will simply mark `isStreaming` as `false` when the promise settles.
 
+`cancel()` also drops every queued follow-up (W6-2): an explicit stop means "don't keep going", so queued messages are not auto-sent afterwards. If your UI shows `pendingFollowUps`, tell the user that stopping discards them before they confirm.
+
 ## Caveats
 
-* `sendUserMessage` is a no-op while `isStreaming` is true. Wire your composer's send button to `disabled={isStreaming}` to mirror this in the UI.
+* `sendUserMessage` while `isStreaming` is true does NOT drop the message — it appends to the W6-2 follow-up queue and auto-sends as the next turn. If you'd rather block input during streaming, wire your composer's send button to `disabled={isStreaming}`.
+* `resumeTurn` (W7-1) streams an assistant turn WITHOUT appending a user message — the transport receives `{ content: '', metadata: { resume: true } }` and the backend replays the durable record's projection as the loop seed. Use it for a "continue the interrupted turn" affordance after a crash/kill; it is a no-op while streaming and is never queued as a follow-up.
 * Tool results are attached to the **latest assistant message**. If you need per-call lookup, override `renderToolCall` on `ChatPanel` and pull the result from your own map.
 * Setting `toolResultToMessage` to a non-null returner switches to a "tool result lives in its own message" model — useful if you want to render tool results as standalone bubbles. Otherwise the result rides inline on the assistant turn.

package/src/hooks/useChatStream.test.ts

@@ -12,9 +12,47 @@ import { describe, expect, it, vi } from 'vitest';
 import type { SSEEvent } from '@steerable/agent-protocol';
 import {
   useChatStream,
+  type ChatStreamSendInput,
   type ChatStreamTransport,
+  type SteerOutcome,
 } from './useChatStream';
 
+/**
+ * A transport whose streams stay open until the test explicitly finishes them,
+ * so we can submit follow-ups mid-stream and watch the queue drain.
+ */
+function makeControllableTransport(steer?: ChatStreamTransport['steer']) {
+  const streams: Array<{
+    input: ChatStreamSendInput;
+    onEvent: (e: SSEEvent) => void;
+    finish: () => void;
+  }> = [];
+  const transport: ChatStreamTransport = {
+    stream: (input, onEvent) =>
+      new Promise<void>((resolve) => {
+        streams.push({
+          input,
+          onEvent,
+          finish: () => {
+            onEvent({ type: 'done' });
+            resolve();
+          },
+        });
+      }),
+    ...(steer ? { steer } : {}),
+  };
+  return { transport, streams };
+}
+
+/** Manually-resolved promise, for parking a steer attempt mid-flight. */
+function makeDeferred<T>() {
+  let resolve!: (value: T) => void;
+  const promise = new Promise<T>((r) => {
+    resolve = r;
+  });
+  return { promise, resolve };
+}
+
 function makeTransport(
   script: SSEEvent[][],
 ): { transport: ChatStreamTransport; cancel: ReturnType<typeof vi.fn> } {
@@ -309,3 +347,358 @@ describe('steerUserMessage', () => {
     });
   });
 });
+
+describe('steerOrFollowUpUserMessage', () => {
+  it("resolves 'steered' and appends the message when the turn accepts the injection", async () => {
+    const steer = vi.fn().mockResolvedValue(true);
+    const { transport, streams } = makeControllableTransport(steer);
+    const { result } = renderHook(() => useChatStream({ transport }));
+
+    act(() => {
+      void result.current.sendUserMessage({ content: 'start' });
+    });
+    await waitFor(() => expect(streams).toHaveLength(1));
+
+    let outcome: SteerOutcome | undefined;
+    await act(async () => {
+      outcome = await result.current.steerOrFollowUpUserMessage('补充一句');
+    });
+    expect(outcome).toBe('steered');
+    expect(
+      result.current.messages.some((m) => m.role === 'user' && m.content === '补充一句'),
+    ).toBe(true);
+    expect(result.current.pendingFollowUps).toEqual([]);
+    expect(streams).toHaveLength(1);
+
+    await act(async () => {
+      streams[0]!.finish();
+    });
+  });
+
+  it("resolves 'queued' when the transport has no steer, then drains at turn end", async () => {
+    const { transport, streams } = makeControllableTransport();
+    const { result } = renderHook(() => useChatStream({ transport }));
+
+    act(() => {
+      void result.current.sendUserMessage({ content: 'first' });
+    });
+    await waitFor(() => expect(streams).toHaveLength(1));
+
+    let outcome: SteerOutcome | undefined;
+    await act(async () => {
+      outcome = await result.current.steerOrFollowUpUserMessage('排队等下轮');
+    });
+    expect(outcome).toBe('queued');
+    expect(result.current.pendingFollowUps).toEqual([{ content: '排队等下轮' }]);
+
+    await act(async () => {
+      streams[0]!.finish();
+    });
+    await waitFor(() => expect(streams).toHaveLength(2));
+    expect(streams[1]!.input.content).toBe('排队等下轮');
+    await act(async () => {
+      streams[1]!.finish();
+    });
+  });
+
+  it("resolves 'queued' when the steer is rejected and the turn is still running", async () => {
+    const steer = vi.fn().mockResolvedValue(false);
+    const { transport, streams } = makeControllableTransport(steer);
+    const { result } = renderHook(() => useChatStream({ transport }));
+
+    act(() => {
+      void result.current.sendUserMessage({ content: 'first' });
+    });
+    await waitFor(() => expect(streams).toHaveLength(1));
+
+    let outcome: SteerOutcome | undefined;
+    await act(async () => {
+      outcome = await result.current.steerOrFollowUpUserMessage('拒收的转向');
+    });
+    expect(outcome).toBe('queued');
+    expect(steer).toHaveBeenCalledWith('拒收的转向');
+    expect(result.current.pendingFollowUps).toEqual([{ content: '拒收的转向' }]);
+
+    await act(async () => {
+      streams[0]!.finish();
+    });
+    await waitFor(() => expect(streams).toHaveLength(2));
+    expect(streams[1]!.input.content).toBe('拒收的转向');
+    await act(async () => {
+      streams[1]!.finish();
+    });
+  });
+
+  it("resolves 'sent' when the turn ended while the steer attempt was in flight", async () => {
+    const gate = makeDeferred<boolean>();
+    const steer = vi.fn(() => gate.promise);
+    const { transport, streams } = makeControllableTransport(steer);
+    const { result } = renderHook(() => useChatStream({ transport }));
+
+    act(() => {
+      void result.current.sendUserMessage({ content: 'first' });
+    });
+    await waitFor(() => expect(streams).toHaveLength(1));
+
+    let outcomePromise: Promise<SteerOutcome>;
+    await act(async () => {
+      outcomePromise = result.current.steerOrFollowUpUserMessage('来迟的补充');
+    });
+    expect(steer).toHaveBeenCalledWith('来迟的补充');
+
+    // The turn ends while the steer is still pending: its `finally` drains
+    // the (empty) queue and clears isStreaming before the steer settles.
+    await act(async () => {
+      streams[0]!.finish();
+    });
+    await waitFor(() => expect(result.current.isStreaming).toBe(false));
+
+    let outcome: SteerOutcome | undefined;
+    await act(async () => {
+      gate.resolve(false);
+      outcome = await outcomePromise;
+    });
+    // Queueing here would strand the message (the drain already ran), so it
+    // goes out immediately as a fresh turn instead.
+    expect(outcome).toBe('sent');
+    expect(result.current.pendingFollowUps).toEqual([]);
+    await waitFor(() => expect(streams).toHaveLength(2));
+    expect(streams[1]!.input.content).toBe('来迟的补充');
+    await act(async () => {
+      streams[1]!.finish();
+    });
+  });
+
+  it("resolves 'sent' without touching steer when no turn is streaming", async () => {
+    const steer = vi.fn().mockResolvedValue(true);
+    const { transport, streams } = makeControllableTransport(steer);
+    const { result } = renderHook(() => useChatStream({ transport }));
+
+    let outcome: SteerOutcome | undefined;
+    await act(async () => {
+      outcome = await result.current.steerOrFollowUpUserMessage('直接发出');
+    });
+    expect(outcome).toBe('sent');
+    expect(steer).not.toHaveBeenCalled();
+    expect(streams).toHaveLength(1);
+    expect(streams[0]!.input.content).toBe('直接发出');
+    expect(result.current.pendingFollowUps).toEqual([]);
+
+    await act(async () => {
+      streams[0]!.finish();
+    });
+  });
+});
+
+describe('follow-up queue (W6-2)', () => {
+  it('sendUserMessage while streaming queues instead of dropping, then auto-sends next turn', async () => {
+    const { transport, streams } = makeControllableTransport();
+    const { result } = renderHook(() => useChatStream({ transport }));
+
+    // Turn 1 starts and stays open.
+    act(() => {
+      void result.current.sendUserMessage({ content: 'first' });
+    });
+    await waitFor(() => expect(streams).toHaveLength(1));
+    expect(result.current.isStreaming).toBe(true);
+
+    // Submit a second message mid-stream — must be queued, not dropped.
+    await act(async () => {
+      await result.current.sendUserMessage({ content: 'second' });
+    });
+    expect(streams).toHaveLength(1); // no new turn yet
+    expect(result.current.pendingFollowUps).toEqual([{ content: 'second' }]);
+
+    // Finish turn 1 → the queued message auto-sends as turn 2.
+    await act(async () => {
+      streams[0]!.finish();
+    });
+    await waitFor(() => expect(streams).toHaveLength(2));
+    expect(streams[1]!.input.content).toBe('second');
+    expect(result.current.pendingFollowUps).toEqual([]);
+
+    await act(async () => {
+      streams[1]!.finish();
+    });
+    await waitFor(() => expect(result.current.isStreaming).toBe(false));
+    // Both user messages landed in the transcript.
+    const userTexts = result.current.messages
+      .filter((m) => m.role === 'user')
+      .map((m) => m.content);
+    expect(userTexts).toEqual(['first', 'second']);
+  });
+
+  it('followUpUserMessage queues while streaming and sends immediately when idle', async () => {
+    const { transport, streams } = makeControllableTransport();
+    const { result } = renderHook(() => useChatStream({ transport }));
+
+    // Idle: followUpUserMessage behaves like a normal send.
+    await act(async () => {
+      result.current.followUpUserMessage({ content: 'idle' });
+    });
+    await waitFor(() => expect(streams).toHaveLength(1));
+    expect(streams[0]!.input.content).toBe('idle');
+
+    // Streaming: queues.
+    await act(async () => {
+      result.current.followUpUserMessage({ content: 'queued' });
+    });
+    expect(streams).toHaveLength(1);
+    expect(result.current.pendingFollowUps).toEqual([{ content: 'queued' }]);
+
+    await act(async () => {
+      streams[0]!.finish();
+    });
+    await waitFor(() => expect(streams).toHaveLength(2));
+    expect(streams[1]!.input.content).toBe('queued');
+    await act(async () => {
+      streams[1]!.finish();
+    });
+  });
+
+  it('removeFollowUp withdraws a queued message before it sends', async () => {
+    const { transport, streams } = makeControllableTransport();
+    const { result } = renderHook(() => useChatStream({ transport }));
+
+    act(() => {
+      void result.current.sendUserMessage({ content: 'first' });
+    });
+    await waitFor(() => expect(streams).toHaveLength(1));
+
+    await act(async () => {
+      result.current.followUpUserMessage({ content: 'keep' });
+      result.current.followUpUserMessage({ content: 'drop' });
+    });
+    expect(result.current.pendingFollowUps.map((m) => m.content)).toEqual(['keep', 'drop']);
+
+    await act(async () => {
+      result.current.removeFollowUp(1); // remove 'drop'
+    });
+    expect(result.current.pendingFollowUps.map((m) => m.content)).toEqual(['keep']);
+
+    await act(async () => {
+      streams[0]!.finish();
+    });
+    await waitFor(() => expect(streams).toHaveLength(2));
+    expect(streams[1]!.input.content).toBe('keep');
+    await act(async () => {
+      streams[1]!.finish();
+    });
+    // 'drop' never sent.
+    expect(streams).toHaveLength(2);
+  });
+
+  it('cancel() clears the queue so nothing auto-sends afterwards', async () => {
+    const { transport, streams } = makeControllableTransport();
+    const { result } = renderHook(() => useChatStream({ transport }));
+
+    act(() => {
+      void result.current.sendUserMessage({ content: 'first' });
+    });
+    await waitFor(() => expect(streams).toHaveLength(1));
+
+    await act(async () => {
+      result.current.followUpUserMessage({ content: 'queued' });
+    });
+    expect(result.current.pendingFollowUps).toHaveLength(1);
+
+    await act(async () => {
+      result.current.cancel();
+    });
+    expect(result.current.pendingFollowUps).toEqual([]);
+
+    // Even if the stream later finishes, no follow-up turn starts.
+    await act(async () => {
+      streams[0]!.finish();
+    });
+    await waitFor(() => expect(result.current.isStreaming).toBe(false));
+    expect(streams).toHaveLength(1);
+  });
+});
+
+describe('resumeTurn (W7-1)', () => {
+  it('streams an assistant turn with resume:true and NO new user message', async () => {
+    const { transport, streams } = makeControllableTransport();
+    const { result } = renderHook(() =>
+      useChatStream({
+        transport,
+        initialMessages: [
+          {
+            id: 'u1',
+            role: 'user',
+            content: '被中断的请求',
+            createdAt: new Date().toISOString(),
+          },
+        ],
+      }),
+    );
+
+    act(() => {
+      void result.current.resumeTurn({ metadata: { mode: 'plan' } });
+    });
+    await waitFor(() => expect(streams).toHaveLength(1));
+    await act(async () => {
+      streams[0]!.finish();
+    });
+    await waitFor(() => expect(result.current.isStreaming).toBe(false));
+
+    // The wire input carries the resume marker and the caller's metadata,
+    // with empty content — the backend replays the record, so no user text
+    // is re-sent.
+    expect(streams).toHaveLength(1);
+    expect(streams[0]!.input).toEqual({
+      content: '',
+      metadata: { mode: 'plan', resume: true },
+    });
+    // The transcript gains ONLY the assistant placeholder — the interrupted
+    // turn's user message is already there (initialMessages), not duplicated.
+    expect(result.current.messages.map((m) => m.role)).toEqual([
+      'user',
+      'assistant',
+    ]);
+    expect(result.current.isStreaming).toBe(false);
+  });
+
+  it('is a no-op while streaming (a resume is not queueable)', async () => {
+    const { transport, streams } = makeControllableTransport();
+    const { result } = renderHook(() => useChatStream({ transport }));
+
+    act(() => {
+      void result.current.sendUserMessage({ content: 'first' });
+    });
+    await waitFor(() => expect(streams).toHaveLength(1));
+
+    await act(async () => {
+      await result.current.resumeTurn();
+    });
+    expect(streams).toHaveLength(1);
+    expect(result.current.pendingFollowUps).toEqual([]);
+
+    await act(async () => {
+      streams[0]!.finish();
+    });
+  });
+
+  it('drains the follow-up queue after the resumed turn ends', async () => {
+    const { transport, streams } = makeControllableTransport();
+    const { result } = renderHook(() => useChatStream({ transport }));
+
+    act(() => {
+      void result.current.resumeTurn();
+    });
+    await waitFor(() => expect(streams).toHaveLength(1));
+
+    await act(async () => {
+      result.current.followUpUserMessage({ content: 'next question' });
+    });
+
+    await act(async () => {
+      streams[0]!.finish();
+    });
+    await waitFor(() => expect(streams).toHaveLength(2));
+    expect(streams[1]!.input.content).toBe('next question');
+    await act(async () => {
+      streams[1]!.finish();
+    });
+  });
+});

package/src/hooks/useChatStream.ts

@@ -48,6 +48,18 @@ export interface ChatStreamTransport {
   steer?: (content: string) => Promise<boolean>;
 }
 
+/**
+ * Where `steerOrFollowUpUserMessage` actually delivered the message:
+ *   - `'steered'` — the running turn accepted the injection.
+ *   - `'queued'` — the turn is still running but not steerable; the message
+ *     sits in the W6-2 follow-up queue and auto-sends at turn end.
+ *   - `'sent'` — no turn was running by the time the steer attempt settled;
+ *     the message went out immediately as a normal new turn.
+ * The union lets callers render their own locale-specific notice per
+ * outcome; the hook itself carries no user-facing copy.
+ */
+export type SteerOutcome = 'steered' | 'queued' | 'sent';
+
 export interface UseChatStreamOptions {
   /** Required transport handle; see `ChatStreamTransport`. */
   transport: ChatStreamTransport;
@@ -70,7 +82,21 @@ export interface UseChatStreamOptions {
 export interface UseChatStreamReturn {
   messages: ChatMessage[];
   isStreaming: boolean;
+  /**
+   * Send a user message. Queue-safe (W6-2): if a turn is currently streaming
+   * the message is NOT dropped — it is appended to the follow-up queue and
+   * sent automatically as the next turn when the current one ends.
+   */
   sendUserMessage: (input: ChatStreamSendInput) => Promise<void>;
+  /**
+   * W7-1: resume the interrupted turn recorded on the backend. Streams an
+   * assistant turn WITHOUT appending a user message — the transport receives
+   * `{ content: '', metadata: { ...input?.metadata, resume: true } }` and the
+   * backend replays the durable record's projection as the loop seed, so the
+   * user never retypes the interrupted request. No-op while streaming (a
+   * resume is not queueable as a follow-up — it is not a user message).
+   */
+  resumeTurn: (input?: { metadata?: Record<string, unknown> }) => Promise<void>;
   /**
    * Steer the running turn with an extra user message. No-op resolving
    * `false` when not streaming or the transport has no `steer`. On success
@@ -78,6 +104,27 @@ export interface UseChatStreamReturn {
    * consumes it at the next round boundary).
    */
   steerUserMessage: (content: string) => Promise<boolean>;
+  /**
+   * Steer with a never-drop fallback (W6-2): tries `steerUserMessage` first,
+   * then degrades based on live turn state — see `SteerOutcome` for the
+   * three outcomes. The turn-already-ended race is resolved by re-checking
+   * `isStreaming` after the steer attempt settles: a finished turn's
+   * `finally` has already drained the queue, so queueing there would strand
+   * the message until some future turn ends — it is sent directly instead.
+   * Prefer this over `steerUserMessage` for composer Enter handlers.
+   */
+  steerOrFollowUpUserMessage: (content: string) => Promise<SteerOutcome>;
+  /**
+   * Explicitly queue a message as a follow-up (W6-2): sent automatically as
+   * the next turn once the current turn finishes. When not streaming this is
+   * equivalent to `sendUserMessage`. Distinct from `steerUserMessage`, which
+   * redirects the *current* turn mid-flight.
+   */
+  followUpUserMessage: (input: ChatStreamSendInput) => void;
+  /** Follow-up messages queued while streaming, in order (not yet sent). */
+  pendingFollowUps: ChatStreamSendInput[];
+  /** Remove a queued follow-up by index (e.g. the user withdraws it). */
+  removeFollowUp: (index: number) => void;
   cancel: () => void;
   /** Replace the message buffer (e.g. when switching chat). */
   setMessages: (messages: ChatMessage[]) => void;
@@ -226,6 +273,14 @@ export function useChatStream(
   const isStreamingRef = useRef(false);
   const cancelRef = useRef<(() => void) | null>(null);
   const [, forceRerender] = useReducer((x: number) => x + 1, 0);
+  // W6-2 follow-up queue: messages submitted while a turn is streaming. Kept
+  // in a ref (drained imperatively at turn end) with a version counter to
+  // re-render consumers that show the pending queue.
+  const followUpsRef = useRef<ChatStreamSendInput[]>([]);
+  const [followUpVersion, bumpFollowUpVersion] = useReducer((x: number) => x + 1, 0);
+  // Self-handle so a finishing turn can start the next queued turn without a
+  // circular useCallback dependency.
+  const sendRef = useRef<(input: ChatStreamSendInput) => Promise<void>>();
 
   const setStreaming = useCallback((next: boolean) => {
     isStreamingRef.current = next;
@@ -289,12 +344,15 @@ export function useChatStream(
     [options],
   );
 
-  const sendUserMessage = useCallback(
-    async (input: ChatStreamSendInput) => {
-      if (isStreamingRef.current) {
-        return;
+  // Shared turn core: stream one assistant turn and drain the follow-up
+  // queue at the end. `echoUserMessage` is false only for W7-1 resume —
+  // the interrupted turn's user message is already in the transcript and
+  // the backend replays it from the durable record.
+  const startTurn = useCallback(
+    async (input: ChatStreamSendInput, opts: { echoUserMessage: boolean }) => {
+      if (opts.echoUserMessage) {
+        dispatch({ type: 'append', message: newUserMessage(input.content) });
       }
-      dispatch({ type: 'append', message: newUserMessage(input.content) });
       dispatch({ type: 'append', message: newAssistantPlaceholder() });
       setStreaming(true);
       try {
@@ -312,12 +370,67 @@ export function useChatStream(
       } finally {
         cancelRef.current = null;
         setStreaming(false);
+        // W6-2: drain the follow-up queue — send the next queued message as
+        // a fresh turn. isStreamingRef is already false here, so the nested
+        // call starts a new turn rather than re-queueing.
+        const next = followUpsRef.current.shift();
+        if (next !== undefined) {
+          bumpFollowUpVersion();
+          void sendRef.current?.(next);
+        }
       }
     },
     [handleEvent, options.transport, setStreaming],
   );
 
+  const sendUserMessage = useCallback(
+    async (input: ChatStreamSendInput) => {
+      if (isStreamingRef.current) {
+        // W6-2: queue instead of dropping. The finishing turn's `finally`
+        // drains the queue and starts the next turn automatically.
+        followUpsRef.current = [...followUpsRef.current, input];
+        bumpFollowUpVersion();
+        return;
+      }
+      await startTurn(input, { echoUserMessage: true });
+    },
+    [startTurn],
+  );
+
+  const resumeTurn = useCallback(
+    async (input?: { metadata?: Record<string, unknown> }) => {
+      if (isStreamingRef.current) return;
+      await startTurn(
+        { content: '', metadata: { ...input?.metadata, resume: true } },
+        { echoUserMessage: false },
+      );
+    },
+    [startTurn],
+  );
+
+  useEffect(() => {
+    sendRef.current = sendUserMessage;
+  }, [sendUserMessage]);
+
+  const followUpUserMessage = useCallback((input: ChatStreamSendInput) => {
+    if (!isStreamingRef.current) {
+      void sendRef.current?.(input);
+      return;
+    }
+    followUpsRef.current = [...followUpsRef.current, input];
+    bumpFollowUpVersion();
+  }, []);
+
+  const removeFollowUp = useCallback((index: number) => {
+    followUpsRef.current = followUpsRef.current.filter((_, i) => i !== index);
+    bumpFollowUpVersion();
+  }, []);
+
   const cancel = useCallback(() => {
+    // Cancelling the current turn also drops queued follow-ups — an explicit
+    // stop means "don't keep going", so we don't auto-send what was queued.
+    followUpsRef.current = [];
+    bumpFollowUpVersion();
     if (cancelRef.current) {
       cancelRef.current();
       cancelRef.current = null;
@@ -340,6 +453,42 @@ export function useChatStream(
     [options.transport],
   );
 
+  const steerOrFollowUpUserMessage = useCallback(
+    async (content: string): Promise<SteerOutcome> => {
+      const input: ChatStreamSendInput = { content };
+      // No turn running: there is nothing to inject into and nothing whose
+      // `finally` would drain the queue — a normal send is the only route
+      // that delivers the message.
+      if (!isStreamingRef.current) {
+        void sendRef.current?.(input);
+        return 'sent';
+      }
+      const steer = options.transport.steer;
+      if (steer) {
+        const ok = await steer(content);
+        if (ok) {
+          dispatch({ type: 'append', message: newUserMessage(content) });
+          return 'steered';
+        }
+        // The turn may have ended while the steer was in flight; its
+        // `finally` already ran the queue drain, so a queued message would
+        // sit unsent until an unrelated future turn ends. Send it as a fresh
+        // turn instead. If a queued follow-up already started the next turn,
+        // isStreamingRef is true again and queueing below is correct.
+        if (!isStreamingRef.current) {
+          void sendRef.current?.(input);
+          return 'sent';
+        }
+      }
+      // Turn still running but not steerable (transport lacks `steer`, or
+      // the loop rejected the injection): W6-2 queue, drained at turn end.
+      followUpsRef.current = [...followUpsRef.current, input];
+      bumpFollowUpVersion();
+      return 'queued';
+    },
+    [options.transport],
+  );
+
   const setMessages = useCallback((messages: ChatMessage[]) => {
     dispatch({ type: 'reset', messages });
   }, []);
@@ -362,11 +511,30 @@ export function useChatStream(
       messages: state.messages,
       isStreaming: isStreamingRef.current,
       sendUserMessage,
+      resumeTurn,
       steerUserMessage,
+      steerOrFollowUpUserMessage,
+      followUpUserMessage,
+      // followUpVersion re-keys this memo so queue changes surface to the UI.
+      pendingFollowUps: followUpsRef.current,
+      removeFollowUp,
       cancel,
       setMessages,
       appendMessage,
     }),
-    [state.messages, sendUserMessage, steerUserMessage, cancel, setMessages, appendMessage],
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+      state.messages,
+      sendUserMessage,
+      resumeTurn,
+      steerUserMessage,
+      steerOrFollowUpUserMessage,
+      followUpUserMessage,
+      removeFollowUp,
+      cancel,
+      setMessages,
+      appendMessage,
+      followUpVersion,
+    ],
   );
 }