@xpert-ai/chatkit-types 0.5.10 → 0.6.0

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';
 
 /**
@@ -641,9 +647,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 +1965,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 +2130,7 @@ export declare type TChatRequestHuman = {
     references?: ChatKitReference[];
     referenceComposition?: ChatKitReferenceCompositionMode;
     planMode?: boolean;
+    runtimeResources?: RuntimeResourcesSelection;
     runtimeCapabilities?: RuntimeCapabilitiesSelection;
     commandSource?: ChatKitCommandSource;
     [key: string]: unknown;
@@ -2706,6 +2756,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.0",
   "description": "Type definitions for the ChatKit.",
   "sideEffects": false,
   "type": "module",