@xpert-ai/chatkit-types 0.20.2 → 0.21.0

package/dist/index.d.ts

@@ -1854,6 +1854,16 @@ export declare type GrayscaleOptions = {
     shade?: -4 | -3 | -2 | -1 | 0 | 1 | 2 | 3 | 4;
 };
 
+/** HTTP 400 contract shared with Xpert's ChatGroupProjectRequiredError. No message was accepted. */
+export declare type GroupProjectRequiredError = {
+    statusCode: 400;
+    error: 'Bad Request';
+    code: 'GROUP_PROJECT_REQUIRED';
+    message: string;
+    groupId: string;
+    participantIds: string[];
+};
+
 export declare type HeaderIcon = 'sidebar-left' | 'sidebar-right' | 'sidebar-open-left' | 'sidebar-open-right' | 'sidebar-open-left-alt' | 'sidebar-open-right-alt' | 'sidebar-floating-left' | 'sidebar-floating-right' | 'sidebar-floating-open-left' | 'sidebar-floating-open-right' | 'sidebar-collapse-left' | 'sidebar-collapse-right' | 'collapse-left' | 'collapse-right' | 'open-left' | 'open-right' | 'double-chevron-left' | 'double-chevron-right' | 'home' | 'home-alt' | 'back-small' | 'back-large' | 'expand-large' | 'collapse-large' | 'expand-small' | 'collapse-small' | 'star' | 'star-filled' | 'chat-temporary' | 'settings-cog' | 'grid' | 'dots-horizontal' | 'dots-vertical' | 'dots-horizontal-circle' | 'dots-vertical-circle' | 'menu' | 'menu-inverted' | 'hamburger' | 'compose' | 'light-mode' | 'dark-mode' | 'close';
 
 export declare const HITL_DECISION_TYPES: readonly ["approve", "edit", "reject", "respond"];
@@ -3118,6 +3128,8 @@ export declare type TMessageComponentWidgetData = {
 
 export declare type TMessageComponentWidgetItem = {
     name: string;
+    /** Optional display-only provenance. Older clients may omit this footer. */
+    presentation?: TWidgetPresentation;
     /**
      * Standard A2UI server-to-client messages. New widget messages should use
      * this flat protocol shape so the UI can build and isolate surfaces at render time.
@@ -3386,6 +3398,26 @@ export declare type TThreadGoalUpdatedEvent = {
     updatedAt: string;
 };
 
+/**
+ * Passive provenance shown beside a Widget. Producers supply public, localized
+ * copy only; never include credentials, query bindings or private execution IDs.
+ * Renderers may collapse details and format the timestamp in the viewer's locale.
+ * These fields neither grant access nor request an action or a fresh query.
+ */
+export declare type TWidgetPresentation = {
+    /** Short result qualification, for example completeness or freshness. */
+    summary?: string;
+    /** ISO 8601 instant with timezone; retained unchanged, displayed in local time. */
+    timestamp?: string;
+    /** Producer-localized label explaining what the timestamp represents. */
+    timestampLabel?: string;
+    /** Public supplementary facts rendered as plain text in an optional disclosure. */
+    details?: Array<{
+        label: string;
+        value: string;
+    }>;
+};
+
 export declare type TXpertChatInterruptPatch = Pick<TInterruptCommand, 'agentKey' | 'toolCalls' | 'update'>;
 
 export declare type TXpertChatResumeDecision = {

package/package.json

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