@steerable/agent-ui 0.6.51 → 0.6.53

package/dist/hooks/useChatStream.d.ts

@@ -94,8 +94,10 @@ export interface UseChatStreamReturn {
     /**
      * Steer the running turn with an extra user message. No-op resolving
      * `false` when not streaming or the transport has no `steer`. On success
-     * the message is appended to the visible transcript immediately (the loop
-     * consumes it at the next round boundary).
+     * the message is inserted immediately before the in-flight assistant
+     * message, matching the persisted order (hosts store the steer at
+     * acceptance, the reply at turn end), so the streaming assistant stays the
+     * list tail. The loop consumes it at the next round boundary.
      */
     steerUserMessage: (content: string) => Promise<boolean>;
     /**

package/dist/hooks/useChatStream.js

@@ -15,6 +15,14 @@ function reducer(state, action) {
             return { messages: action.messages };
         case 'append':
             return { messages: [...state.messages, action.message] };
+        case 'insert-before-last-assistant': {
+            const idx = findLastAssistantIndex(state.messages);
+            if (idx === -1)
+                return { messages: [...state.messages, action.message] };
+            const next = state.messages.slice();
+            next.splice(idx, 0, action.message);
+            return { messages: next };
+        }
         case 'patch-last-assistant': {
             const idx = findLastAssistantIndex(state.messages);
             if (idx === -1)
@@ -286,7 +294,7 @@ export function useChatStream(options) {
         }
         const ok = await steer(content);
         if (ok) {
-            dispatch({ type: 'append', message: newUserMessage(content) });
+            dispatch({ type: 'insert-before-last-assistant', message: newUserMessage(content) });
         }
         return ok;
     }, [options.transport]);
@@ -303,7 +311,7 @@ export function useChatStream(options) {
         if (steer) {
             const ok = await steer(content);
             if (ok) {
-                dispatch({ type: 'append', message: newUserMessage(content) });
+                dispatch({ type: 'insert-before-last-assistant', message: newUserMessage(content) });
                 return 'steered';
             }
             // The turn may have ended while the steer was in flight; its

package/dist/hooks/useToolCallStatus.d.ts

@@ -19,10 +19,9 @@ export interface UseToolCallStatusOptions {
     call: ToolCall;
     result?: ToolResult;
     /**
-     * Optional override; when omitted the hook infers the mode from the tool
-     * name pattern (`get_*` / `list_*` → read, `delete_*` / `archive_*` →
-     * destructive, `local_*` → local, etc.). Mirrors the framework's harness
-     * `decide_tool_mode`.
+     * Mode declared for this tool. First-party tools set this from registration.
+     * When omitted, the hook falls back to a name-prefix table. That fallback
+     * is only for undeclared third-party names.
      */
     mode?: ToolCallMode;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-ui",
-  "version": "0.6.51",
+  "version": "0.6.53",
   "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.6.51"
+    "@steerable/agent-protocol": "0.6.53"
   },
   "peerDependencies": {
     "react": ">=18.0.0",

package/src/hooks/useChatStream.test.ts

@@ -384,9 +384,13 @@ describe('steerOrFollowUpUserMessage', () => {
       outcome = await result.current.steerOrFollowUpUserMessage('补充一句');
     });
     expect(outcome).toBe('steered');
-    expect(
-      result.current.messages.some((m) => m.role === 'user' && m.content === '补充一句'),
-    ).toBe(true);
+    // Inserted before the in-flight assistant (matches the persisted order),
+    // so the streaming assistant stays the list tail.
+    expect(result.current.messages.map((m) => [m.role, m.content])).toEqual([
+      ['user', 'start'],
+      ['user', '补充一句'],
+      ['assistant', ''],
+    ]);
     expect(result.current.pendingFollowUps).toEqual([]);
     expect(streams).toHaveLength(1);
 

package/src/hooks/useChatStream.ts

@@ -107,8 +107,10 @@ export interface UseChatStreamReturn {
   /**
    * Steer the running turn with an extra user message. No-op resolving
    * `false` when not streaming or the transport has no `steer`. On success
-   * the message is appended to the visible transcript immediately (the loop
-   * consumes it at the next round boundary).
+   * the message is inserted immediately before the in-flight assistant
+   * message, matching the persisted order (hosts store the steer at
+   * acceptance, the reply at turn end), so the streaming assistant stays the
+   * list tail. The loop consumes it at the next round boundary.
    */
   steerUserMessage: (content: string) => Promise<boolean>;
   /**
@@ -142,6 +144,7 @@ export interface UseChatStreamReturn {
 type Action =
   | { type: 'reset'; messages: ChatMessage[] }
   | { type: 'append'; message: ChatMessage }
+  | { type: 'insert-before-last-assistant'; message: ChatMessage }
   | { type: 'patch-last-assistant'; patch: Partial<ChatMessage> }
   | { type: 'append-content'; delta: string }
   | { type: 'append-tool-call'; call: ToolCall }
@@ -158,6 +161,13 @@ function reducer(state: State, action: Action): State {
       return { messages: action.messages };
     case 'append':
       return { messages: [...state.messages, action.message] };
+    case 'insert-before-last-assistant': {
+      const idx = findLastAssistantIndex(state.messages);
+      if (idx === -1) return { messages: [...state.messages, action.message] };
+      const next = state.messages.slice();
+      next.splice(idx, 0, action.message);
+      return { messages: next };
+    }
     case 'patch-last-assistant': {
       const idx = findLastAssistantIndex(state.messages);
       if (idx === -1) return state;
@@ -453,7 +463,7 @@ export function useChatStream(
       }
       const ok = await steer(content);
       if (ok) {
-        dispatch({ type: 'append', message: newUserMessage(content) });
+        dispatch({ type: 'insert-before-last-assistant', message: newUserMessage(content) });
       }
       return ok;
     },
@@ -474,7 +484,7 @@ export function useChatStream(
       if (steer) {
         const ok = await steer(content);
         if (ok) {
-          dispatch({ type: 'append', message: newUserMessage(content) });
+          dispatch({ type: 'insert-before-last-assistant', message: newUserMessage(content) });
           return 'steered';
         }
         // The turn may have ended while the steer was in flight; its

package/src/hooks/useToolCallStatus.ts

@@ -32,10 +32,9 @@ export interface UseToolCallStatusOptions {
   call: ToolCall;
   result?: ToolResult;
   /**
-   * Optional override; when omitted the hook infers the mode from the tool
-   * name pattern (`get_*` / `list_*` → read, `delete_*` / `archive_*` →
-   * destructive, `local_*` → local, etc.). Mirrors the framework's harness
-   * `decide_tool_mode`.
+   * Mode declared for this tool. First-party tools set this from registration.
+   * When omitted, the hook falls back to a name-prefix table. That fallback
+   * is only for undeclared third-party names.
    */
   mode?: ToolCallMode;
   /**