@djangocfg/widget-assistant 0.3.12 → 0.3.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/widget-assistant",
-  "version": "0.3.12",
+  "version": "0.3.13",
   "description": "A site assistant on top of @djangocfg/widget-chat: the SSE wire and session layer, a persistent host, docked column, floating button and sheet, dictation, Help and 17 built-in locales",
   "keywords": [
     "chat",
@@ -44,19 +44,19 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@djangocfg/widget-chat": "^0.1.28",
+    "@djangocfg/widget-chat": "^0.1.29",
     "zustand": "^5.0.16"
   },
   "peerDependencies": {
-    "@djangocfg/i18n": "^2.1.627",
-    "@djangocfg/ui-core": "^2.1.627",
+    "@djangocfg/i18n": "^2.1.628",
+    "@djangocfg/ui-core": "^2.1.628",
     "lucide-react": "^1.68.0",
     "react": "^19.0.0"
   },
   "devDependencies": {
-    "@djangocfg/i18n": "^2.1.627",
-    "@djangocfg/typescript-config": "^2.1.627",
-    "@djangocfg/ui-core": "^2.1.627",
+    "@djangocfg/i18n": "^2.1.628",
+    "@djangocfg/typescript-config": "^2.1.628",
+    "@djangocfg/ui-core": "^2.1.628",
     "@storybook/react-vite": "^10.6.5",
     "@types/node": "^25.9.5",
     "@types/react": "19.3.0",

package/src/sessions/kit.ts

@@ -41,7 +41,7 @@ export interface ChatCallResult<T> {
 /** The three plain calls of the kit's thread routes, as the host maps them from its generated client (`Chat.chatThreadsList`, ...). The stream is not among them: no schema describes it. */
 export interface ChatThreadCalls {
   list: (options: { signal?: AbortSignal }) => Promise<ChatCallResult<readonly ChatThreadListItemShape[]>>;
-  create: (options: { body?: { kind?: string } }) => Promise<ChatCallResult<ChatThreadShape>>;
+  create: (options: { body?: { kind?: string; context?: Record<string, unknown> } }) => Promise<ChatCallResult<ChatThreadShape>>;
   retrieve: (options: { path: { thread_id: string }; signal?: AbortSignal }) => Promise<ChatCallResult<ChatThreadDetailShape>>;
 }
 
@@ -67,7 +67,7 @@ export function storedThreadOf(row: ChatThreadShape & Partial<Pick<ChatThreadLis
 }
 
 export interface ChatTransportConfig
-  extends Pick<TransportConfig, 'getToken' | 'headers' | 'idleMs' | 'streamFetch'> {
+  extends Pick<TransportConfig, 'getToken' | 'headers' | 'idleMs' | 'streamFetch' | 'buildBody'> {
   /** The thread calls of the generated client. */
   client: ChatThreadCalls;
   /** API origin, no trailing slash (the stream is called directly, never through a rewrite). */
@@ -78,6 +78,13 @@ export interface ChatTransportConfig
   trailingSlash?: boolean;
   /** The chat kind "New chat" asks for; omit where the server named a default kind. */
   kind?: string;
+  /**
+   * Context sent on "New chat" as the create body's `context` (a document id, the page locale), read per call. Return `undefined` for none.
+   * Without it a host wraps `client.create` to add it.
+   */
+  getCreateContext?: () => Record<string, unknown> | undefined;
+  /** List only threads that hold at least one message (`message_count > 0`), so an empty "New chat" never fills the menu. Default `false`. */
+  hideEmpty?: boolean;
 }
 
 export interface ChatConnection {
@@ -93,18 +100,21 @@ export interface ChatConnection {
  * The host adds renderers, words, auth (`getToken` / `streamFetch`) and the mount point; nothing else.
  */
 export function createChatTransport(config: ChatTransportConfig): ChatConnection {
-  const { client, baseUrl, mount, kind, trailingSlash = true } = config;
+  const { client, baseUrl, mount, kind, trailingSlash = true, getCreateContext, hideEmpty = false } = config;
   const tail = trailingSlash ? '/' : '';
   const streamUrl = ({ threadId }: SendInput) => `${mount}/threads/${encodeURIComponent(threadId ?? '')}/messages${tail}`;
-  const transport = createTransport({ baseUrl, streamUrl, getToken: config.getToken, headers: config.headers, idleMs: config.idleMs, streamFetch: config.streamFetch });
+  const transport = createTransport({ baseUrl, streamUrl, getToken: config.getToken, buildBody: config.buildBody, headers: config.headers, idleMs: config.idleMs, streamFetch: config.streamFetch });
   const api: ThreadApi = {
     async list(signal) {
       const res = await client.list({ signal });
       if (res.error || !res.data) throw new Error('chat threads');
-      return res.data.map(storedThreadOf);
+      const rows = hideEmpty ? res.data.filter((row) => row.message_count > 0) : res.data;
+      return rows.map(storedThreadOf);
     },
     async create() {
-      const res = await client.create(kind ? { body: { kind } } : {});
+      const context = getCreateContext?.();
+      const body = { ...(kind ? { kind } : {}), ...(context ? { context } : {}) };
+      const res = await client.create(Object.keys(body).length ? { body } : {});
       if (res.error || !res.data) throw new Error('chat create');
       return storedThreadOf(res.data);
     },