@icanbwell/baileyai-chat-ui 1.0.0 → 1.0.2

package/dist/index.d.ts

@@ -496,8 +496,38 @@ export declare interface UseBaileyChatResult {
     /** Dismisses the current error without resending — distinct from retryLast, which resends. */
     clearError: () => void;
     /** Aborts any in-flight turn and resets the conversation to empty, so a host can offer a
-     *  "start over" control without remounting the component. */
+     *  "start over" control without remounting the component.
+     *
+     *  `BaileyChatPanel`'s own "New chat" button calls whatever `newChat` sits on the `chat`
+     *  object it was given (read off `props.chat`, not this hook directly) — so a host that
+     *  needs to react to a reset (e.g. to also clear its own persisted conversation identity)
+     *  wraps this function before handing `chat` to the panel:
+     *
+     *  ```ts
+     *  const chat = useBaileyChat({ transport, model, instructions });
+     *  const chatForPanel = useMemo(
+     *      () => ({ ...chat, newChat: () => { chat.newChat(); onHostReset(); } }),
+     *      [chat]
+     *  );
+     *  ```
+     *
+     *  `newChat()` is fully synchronous, so the wrapper returning is the only "did it finish"
+     *  signal a host needs — no callback or promise required. */
     newChat: () => void;
+    /** Replaces the current transcript with a caller-supplied one, for resuming a previously
+     *  started conversation or switching to a different one a host's user selected from a
+     *  history list. Call once per conversation load (e.g. from an effect keyed on the loaded
+     *  data), not on every render — repeated calls silently re-apply the same reset each time,
+     *  the same class of bug as a wrong `useEffect` dependency.
+     *
+     *  Aborts any in-flight turn first (switching conversations is decisive, unlike
+     *  `sendHidden`/`retryLast`, which no-op instead). Every provided message is normalized to
+     *  `streaming: false` — a restored message can never legitimately be mid-stream. `hidden`
+     *  messages are excluded from the visible transcript but retained in the model-context
+     *  history sent on the next turn, mirroring `sendHidden`'s live behaviour exactly. Any entry
+     *  whose `role` isn't `'user'` or `'assistant'` is dropped rather than trusted, since a
+     *  restored transcript crosses a service boundary this hook doesn't control. */
+    loadMessages: (messages: BaileyMessage[]) => void;
 }
 
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icanbwell/baileyai-chat-ui",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Shared React chat UI and streaming logic for Bailey, the icanbwell AI assistant",
   "license": "Apache-2.0",
   "repository": {