@icanbwell/baileyai-chat-ui 1.0.17 → 1.0.19

package/dist/index.d.ts

@@ -246,6 +246,19 @@ export declare interface BaileyChatTransport {
          *  error state (the partial text stays visible) instead of treating it as a finished
          *  answer. A transport that never sets it behaves exactly as before. */
         interrupted?: boolean;
+        /** Optional. Why a request that never got a response failed. Set by `createBaileyClient`
+         *  together with `status: undefined` when `fetch` rejects or the host's `getHeaders`
+         *  throws (`'network'`); the type is a subset of `BaileyApiErrorKind`. `'timeout'` is reserved
+         *  for a transport that resolves instead of throwing on a timeout: `createBaileyClient`
+         *  still rethrows its idle-timeout `TimeoutError`. `errorMessage` stays a fixed string.
+         *  Hosts that ignore this field behave exactly as before. */
+        errorKind?: Extract<BaileyApiErrorKind, 'network' | 'timeout'>;
+        /** Optional. The error `fetch` threw, set only with `errorKind` when the failure came
+         *  from `fetch`; never set when `getHeaders` threw (it can carry auth detail) and never
+         *  a request or response body. Browsers do not distinguish CORS, DNS or offline: all
+         *  surface as a generic `TypeError`. Do not show `cause.message` to users without review,
+         *  and do not log the request URL (it can carry identifiers). */
+        errorCause?: unknown;
     }>;
 }
 
@@ -335,8 +348,16 @@ export declare type BaileyContentPart = {
 export declare interface BaileyContextLossInfo {
     /** The id the turn sent. */
     sentId: string;
-    /** The id the server reported instead; undefined when it reported none. */
+    /** The id the server reported instead; undefined when it reported none. For
+     *  `reason: 'history'` it is the id the server reported, normally equal to `sentId`. */
     reportedId?: string;
+    /** `'id'`: the server reported no id or a different one. `'history'`: the server reported the
+     *  same id but said it loaded no history (`conversation.history_status` of `'failed'` or
+     *  `'empty'`). Only newer backends send the status; older ones can only produce `'id'`. The
+     *  accompanying `history_loaded` count is not used by the library. Optional in the type so hosts that
+     *  construct this object keep compiling; the library always sets it on what it passes to
+     *  `onContextLoss`. */
+    reason?: 'id' | 'history';
 }
 
 export declare interface BaileyConversationList {
@@ -613,6 +634,14 @@ export declare interface BaileyServerMessage {
 
 export declare type BaileyStorageOperation = 'read' | 'write' | 'remove' | 'key';
 
+/** The `conversation` object on `response.created` / `response.completed`. Every member is optional
+ *  and `unknown`: older backends omit them and the library ignores values it does not recognise. */
+export declare interface BaileyStreamConversation {
+    id?: unknown;
+    history_status?: unknown;
+    history_loaded?: unknown;
+}
+
 export declare type BaileyStreamEvent = {
     type: 'response.output_text.delta';
     delta: string;
@@ -631,17 +660,13 @@ export declare type BaileyStreamEvent = {
 } | {
     type: 'response.created';
     response?: {
-        conversation?: {
-            id?: unknown;
-        } | null;
+        conversation?: BaileyStreamConversation | null;
     };
 } | {
     type: 'response.completed';
     message_id?: string;
     response?: {
-        conversation?: {
-            id?: unknown;
-        } | null;
+        conversation?: BaileyStreamConversation | null;
     };
 } | {
     type: 'error';
@@ -1054,9 +1079,11 @@ export declare interface UseBaileyChatConfig {
      *  provided but blank (operation `'key'`). Chat keeps working with the id in memory only and
      *  `persistence` becomes `'degraded'`. Receives the underlying error; nothing is logged. */
     onStorageError?: (error: unknown, operation: BaileyStorageOperation) => void;
-    /** Called when a turn that sent a held id came back with no id or a different one: the server
-     *  did not continue that conversation (persistence off, unknown or foreign id, or history that
-     *  could not be loaded). The held id and its stored value are dropped, so the next turn sends
+    /** Called when a turn that sent a held id came back with no id or a different one
+     *  (`reason: 'id'`), or with the same id but `conversation.history_status` of `'failed'` or
+     *  `'empty'` (`reason: 'history'`, newer backends only): the server did not continue that
+     *  conversation (persistence off, unknown or foreign id, or history that could not be loaded).
+     *  The held id and its stored value are dropped, so the next turn sends
      *  the full transcript. */
     onContextLoss?: (info: BaileyContextLossInfo) => void;
 }
@@ -1066,8 +1093,8 @@ export declare interface UseBaileyChatResult {
      *  storage call failed or `sub` was blank, so the id lives in memory only. Optional in the type
      *  so hosts that construct their own result objects still compile. */
     persistence?: 'ok' | 'degraded' | 'off';
-    /** True from a turn whose reported id was missing or different from the one sent (see
-     *  `onContextLoss`) until the next turn starts or the conversation is replaced. */
+    /** True from a turn whose reported id was missing or different from the one sent, or whose
+     *  history load failed or was empty (see `onContextLoss`) until the next turn starts or the conversation is replaced. */
     contextLost?: boolean;
     /** Read-only. The held conversation id (seeded, restored from `storage`, or reported by the
      *  transport via `onConversationId`); `undefined` until one exists and after `newChat()`.

package/package.json

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