@xpert-ai/chatkit-types 0.20.0 → 0.20.2

package/dist/index.d.ts

@@ -363,6 +363,9 @@ export declare interface ChatKitElementEventMap {
     'chatkit.connectors.change': CustomEvent<{
         connectorBindingIds: string[];
     }>;
+    'chatkit.pet.launcher.visibility.change': CustomEvent<{
+        visible: boolean;
+    }>;
     'chatkit.log': CustomEvent<{
         name: string;
         data?: Record<string, unknown>;
@@ -413,13 +416,27 @@ export declare type ChatKitEvents = {
     'chatkit.connectors.change': CustomEvent<{
         connectorBindingIds: string[];
     }>;
+    /** Emitted when the user closes or reopens the pet launcher. */
+    'chatkit.pet.launcher.visibility.change': CustomEvent<{
+        visible: boolean;
+    }>;
     /** Emitted when ChatKit starts loading a thread (initial load or selected from history). */
     'chatkit.thread.load.start': CustomEvent<{
         threadId: string;
     }>;
     /** Emitted when ChatKit finished loading a thread. */
+    /** Metadata for the loaded branch; excludes messages, resources and execution internals. */
     'chatkit.thread.load.end': CustomEvent<{
         threadId: string;
+        conversation?: {
+            id: string;
+            threadId: string;
+            title?: string;
+            projectId?: string;
+            xpertId?: string;
+            from?: string;
+            status?: 'idle' | 'busy' | 'pausing' | 'paused' | 'interrupted' | 'error';
+        };
     }>;
     /** Diagnostic events that can be used for logging/analytics. */
     'chatkit.log': CustomEvent<{
@@ -645,7 +662,8 @@ export declare type ChatKitOptions = {
      * the host page viewport.
      * Passing `true` enables the default built-in pet.
      * Explicit `false` disables pets and local pet controls in chat mode,
-     * overriding saved user preferences. Pet display mode still requires a pet.
+     * overriding saved user preferences. In pet display mode, omitting pet shows
+     * the launcher by default and false collapses it to the Show pet button.
      *
      * @default false
      */
@@ -696,6 +714,11 @@ export declare type ChatKitOptions = {
      */
     header?: {
         enabled?: boolean;
+        /** Inline avatar, title, and status block. Hidden by default; separate from the centered character. */
+        identity?: {
+            /** Show the identity block when the centered character is not displayed. Defaults to false. */
+            enabled?: boolean;
+        };
         /** Center the published Assistant character in bubble mode. Defaults to true. */
         character?: {
             enabled?: boolean;
@@ -940,6 +963,10 @@ export declare type ChatKitPetOptions = {
      * enabled is false. Host offline assets separately from the UI npm package.
      */
     assetsBaseUrl?: string;
+    /** In pet display mode, false collapses the launcher to Show pet. Omit to
+     * start visible. Users can close and reopen the launcher. Hosts can persist
+     * those actions via `chatkit.pet.launcher.visibility.change`.
+     */
     enabled?: boolean;
     character?: ChatKitPetCharacter;
     position?: ChatKitPetPositionOptions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/chatkit-types",
-  "version": "0.20.0",
+  "version": "0.20.2",
   "description": "Type definitions for the ChatKit.",
   "sideEffects": false,
   "type": "module",