@xpert-ai/chatkit-types 0.17.0 → 0.18.0

package/dist/index.d.ts

@@ -1162,6 +1162,16 @@ export declare type ChatKitWorkbenchFileResource = {
     targetId?: string;
 };
 
+/** Public view state owned by a routed embedder. Never carries credentials. */
+export declare type ChatKitWorkbenchNavigation = {
+    projectId: string | null;
+    view: {
+        viewKey: string;
+        selectionId?: string;
+        parameters?: Record<string, string | number | boolean | null | (string | number | boolean | null)[]>;
+    } | null;
+};
+
 /** Authenticated host response consumed only by ChatKit, never forwarded to a plugin. */
 export declare type ChatKitWorkbenchNavigationSession = {
     assistantId: string;
@@ -1173,6 +1183,14 @@ export declare type ChatKitWorkbenchNavigationSession = {
 };
 
 export declare type ChatKitWorkbenchOptions = {
+    /**
+     * Restore host URL state after the matching runtime scope has been authorized.
+     * Omit to use ChatKit's own navigation history; view:null closes the routed View.
+     * The embedder must update its authorized API Project scope independently.
+     */
+    navigation?: ChatKitWorkbenchNavigation;
+    /** Persist successful view selections in the host URL. Replayed state does not emit this callback. */
+    onNavigationChange?: (navigation: ChatKitWorkbenchNavigation) => void | Promise<void>;
     /** Show external Assistant executions in a native workbench tab. Enabled by default. */
     externalAssistants?: {
         enabled?: boolean;

package/package.json

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