@xpert-ai/chatkit-types 0.4.0 → 0.4.2

package/dist/index.d.ts

@@ -305,6 +305,19 @@ export declare type ChatKitImageReference = ChatKitReferenceBase & {
     height?: number;
 };
 
+export declare type ChatKitLayoutOptions = {
+    /**
+     * Maximum width of the internal chat column on wide screens. The ChatKit root
+     * still fills its host container; message content and composer remain centered
+     * within this width.
+     *
+     * Accepts any CSS max-width value, or a number interpreted by React as pixels.
+     *
+     * @example "960px"
+     */
+    maxWidth?: number | string;
+};
+
 export declare interface ChatkitMessage {
     status?: string;
     content: TMessageItems | string;
@@ -354,6 +367,10 @@ export declare type ChatKitOptions = {
      * * @default "light"
      */
     theme?: ColorScheme | ChatKitTheme;
+    /**
+     * Layout configuration for the ChatKit UI.
+     */
+    layout?: ChatKitLayoutOptions;
     /**
      * Optional animated pet companion rendered by the ChatKit web component over
      * the host page viewport.
@@ -1813,6 +1830,17 @@ export declare type TMcpAppPermissions = {
     clipboardWrite?: TMcpAppPermissionGrant;
 };
 
+export declare type TMcpAppToolResult = {
+    content: TMcpAppToolResultContentBlock[];
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+};
+
+export declare type TMcpAppToolResultContentBlock = Record<string, unknown> & {
+    type: string;
+};
+
 /**
  * Declares who may use an MCP tool. `model` exposes the tool to the LLM;
  * `app` allows the rendered MCP App iframe to call it through the host bridge.
@@ -1845,8 +1873,8 @@ export declare type TMessageComponentMcpApp = TMessageComponent<TMessageComponen
 
 /**
  * Safe metadata needed to render an MCP App message. Chat history stores this
- * descriptor only; the app HTML is fetched from the short-lived backend app
- * instance using `appInstanceId`.
+ * descriptor and the initial tool input/result only; the app HTML is fetched
+ * from the backend app instance using `appInstanceId`.
  */
 export declare type TMessageComponentMcpAppData = {
     /** Component discriminator used by ChatKit renderers. */
@@ -1883,6 +1911,15 @@ export declare type TMessageComponentMcpAppData = {
     prefersBorder?: boolean;
     /** Original tool input sent to the MCP App via `ui/notifications/tool-input`. */
     toolInput?: Record<string, unknown>;
+    /**
+     * Standardized initial CallToolResult used to replay MCP App history without
+     * re-running the originating tool. Raw app HTML is never persisted here.
+     */
+    toolResult?: TMcpAppToolResult;
+    /** Serialized byte size of the initial tool result when known. */
+    toolResultSize?: number;
+    /** True when the initial tool result was too large to inline in chat history. */
+    toolResultTruncated?: boolean;
     /** Visibility declared by the originating MCP tool. */
     visibility?: TMcpAppVisibility[];
     /** Current lifecycle status of the tool/app message. */

package/package.json

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