@xpert-ai/chatkit-types 0.20.3 → 0.21.0

package/dist/index.d.ts

@@ -3128,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.
@@ -3396,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.3",
+  "version": "0.21.0",
   "description": "Type definitions for the ChatKit.",
   "sideEffects": false,
   "type": "module",