@xpert-ai/chatkit-types 0.5.10 → 0.6.1

package/dist/index.d.ts

@@ -11,6 +11,12 @@ declare type ActionConfig = {
     payload?: Record<string, unknown>;
 };
 
+export declare interface AgentPluginDiagnostic {
+    component: string;
+    code: string;
+    message: string;
+}
+
 declare type Alignment = 'start' | 'center' | 'end' | 'baseline' | 'stretch';
 
 /**
@@ -382,6 +388,13 @@ export declare type ChatKitMcpAppsOptions = {
 };
 
 export declare interface ChatkitMessage {
+    createdAt?: string | Date | null;
+    updatedAt?: string | Date | null;
+    historical?: boolean;
+    branching?: {
+        available: boolean;
+        reason?: 'message_not_complete' | 'checkpoint_unavailable' | 'graph_changed' | 'state_not_supported';
+    };
     status?: string;
     content: TMessageItems | string;
     reasoning?: TMessageContentReasoning[];
@@ -454,6 +467,11 @@ export declare type ChatKitOptions = {
      * Message list quick navigation controls.
      */
     messageNavigation?: ChatKitMessageNavigationOptions;
+    /** Message presentation only; never changes stored messages or model context. */
+    messagePresentation?: {
+        /** Collapse the process preceding each final assistant answer. Default: false. */
+        collapseProcess?: boolean;
+    };
     /**
      * Optional Xpert Remote Views workbench.
      *
@@ -562,6 +580,8 @@ export declare type ChatKitOptions = {
         promptsLayout?: 'cards' | 'list';
     };
     threadItemActions?: {
+        /** Show Branch in new chat when the server advertises a saved assistant boundary. Defaults to true. */
+        branch?: boolean;
         /**
          * Whether or not to show the response feedback buttons (thumbs up / thumbs
          * down) in the response view. When the user clicks on one of the buttons, the
@@ -641,9 +661,19 @@ export declare type ChatKitOptions = {
             /** Human-readable label for a locked Project scope. */
             label?: string;
         };
+        /** Unified conversation resource selector for plugins, middleware and experts. */
+        resources?: {
+            enabled?: boolean;
+            /** Opens the host's workspace Connector flow. Never returns credentials to ChatKit. */
+            onConnect?: WorkspaceConnectorConnectHandler;
+        };
         /**
          * Conversation-level Connector bindings for the current Xpert or Project.
          * Disabled by default and ignored by custom APIs.
+         *
+         * @deprecated Prefer `composer.resources` for unified resource selection.
+         * Retained for compatibility; this option still controls native Connector
+         * capabilities until their migration to `composer.resources` is complete.
          */
         connectors?: {
             enabled?: boolean;
@@ -1949,6 +1979,39 @@ export declare type RuntimeCapabilitiesSelectionSet = {
     };
 };
 
+export declare interface RuntimeResourceCatalog {
+    items: RuntimeResourceCatalogItem[];
+    total: number;
+}
+
+export declare interface RuntimeResourceCatalogItem extends RuntimeResourceReference {
+    kind: RuntimeResourceKind;
+    title: string;
+    description?: LocalizedText;
+    icon?: string;
+    status: RuntimeResourceStatus;
+    diagnostics: AgentPluginDiagnostic[];
+    components: Array<{
+        key: string;
+        kind: 'skill' | 'mcp' | 'middleware' | 'external_xpert';
+        status: RuntimeResourceStatus;
+    }>;
+}
+
+export declare type RuntimeResourceKind = 'agent_plugin' | 'middleware' | 'external_xpert';
+
+export declare interface RuntimeResourceReference {
+    bindingId: string;
+    version: string;
+}
+
+export declare interface RuntimeResourcesSelection {
+    revision: number;
+    resources: RuntimeResourceReference[];
+}
+
+export declare type RuntimeResourceStatus = 'ready' | 'requires_auth' | 'configuration_required' | 'partial' | 'unavailable';
+
 export declare type Select = {
     type: 'Select';
     key?: string;
@@ -2081,6 +2144,7 @@ export declare type TChatRequestHuman = {
     references?: ChatKitReference[];
     referenceComposition?: ChatKitReferenceCompositionMode;
     planMode?: boolean;
+    runtimeResources?: RuntimeResourcesSelection;
     runtimeCapabilities?: RuntimeCapabilitiesSelection;
     commandSource?: ChatKitCommandSource;
     [key: string]: unknown;
@@ -2706,6 +2770,18 @@ export declare type WorkflowTriggerParams = {
     params?: Record<string, any>;
 } | Record<string, any>;
 
+export declare type WorkspaceConnectorConnectHandler = (request: WorkspaceConnectorConnectRequest) => Promise<WorkspaceConnectorConnectResult>;
+
+/** The host resolves the workspace and verifies configuration permission again. */
+export declare type WorkspaceConnectorConnectRequest = {
+    assistantId: string;
+    bindingId: string;
+};
+
+export declare type WorkspaceConnectorConnectResult = {
+    status: 'connected' | 'cancelled';
+};
+
 /**
  * A Web Component that serves as the entry point for a ChatKit integration.
  * * @noInheritDoc

package/package.json

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