@xpert-ai/chatkit-types 0.0.13 → 0.0.15

package/dist/index.d.ts

@@ -246,6 +246,11 @@ export declare type ChatKitOptions = {
      */
     frameUrl?: string;
     api: CustomApiConfig | HostedApiConfig;
+    /**
+     * Default request values that should be injected into every user message sent
+     * from this ChatKit instance.
+     */
+    request?: ChatKitRequestOptions;
     /**
      * Locale override for ChatKit UI. If not provided, the browser's locale
      * will be used. If the locale is not supported, will fall back to English.
@@ -426,6 +431,38 @@ export declare type ChatKitOptions = {
     };
 };
 
+export declare type ChatKitRequestContext = {
+    /**
+     * Request-scoped runtime env overrides.
+     * ChatKit forwards this field to LangGraph as `context.env`.
+     */
+    env?: Record<string, string>;
+    [key: string]: unknown;
+};
+
+export declare type ChatKitRequestOptions<TState = Record<string, any>, TContext extends ChatKitRequestContext = ChatKitRequestContext, TConfig extends Record<string, unknown> = Record<string, unknown>> = {
+    /**
+     * Custom graph state merged into every submitted message request.
+     * The active user input is always written into `state.human.input`.
+     */
+    state?: TState;
+    /**
+     * Additional stream context merged into every submitted message request.
+     *
+     * Request-scoped runtime env overrides should be placed in `context.env`.
+     * Extend `TContext` with any other request-scoped context fields you need.
+     */
+    context?: TContext;
+    /**
+     * Additional LangGraph run config merged into every submitted message request.
+     *
+     * This is forwarded to the hosted `runs.stream` request as `config`.
+     * Use this for LangGraph runtime controls such as tags or configurable values,
+     * not request-scoped env overrides.
+     */
+    config?: TConfig;
+};
+
 export declare type ChatKitTheme = {
     /**
      * The color scheme to use for the ChatKit UI.

package/package.json

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