@waniwani/sdk 0.21.5 → 0.22.0-beta.1

package/dist/chat/index.d.ts

@@ -590,6 +590,11 @@ interface ChatBaseProps {
     apiKey?: string;
     /** Chat API endpoint URL. Defaults to Waniwani hosted endpoint */
     api?: string;
+    /**
+     * Builds the transport turns are sent through. Defaults to the chat's own
+     * HTTP transport to `api`, which it also hands the factory as `fallback`.
+     */
+    transport?: ChatTransportFactory;
     /** Pre-loaded messages to display when the chat mounts. */
     initialMessages?: ai.UIMessage[];
     /** Initial greeting shown before user types */
@@ -869,6 +874,28 @@ interface ChatHandle {
         eventId: string;
     }>;
 }
+/** What the chat hands a transport factory. */
+interface ChatTransportContext {
+    /** The chat's HTTP transport to `api`. */
+    fallback: ai.ChatTransport<ai.UIMessage>;
+    headers: () => Record<string, string> | undefined;
+    /** The channel and visitor a turn is attributed to. */
+    body: () => Record<string, unknown>;
+    /** True while the thread needs what only `fallback` carries: attachments, model context, saved history. */
+    needsFallback: () => boolean;
+    onSession: (sessionId: string) => void;
+}
+/** Optional hooks the chat calls on a transport. */
+interface ChatTransportLifecycle {
+    /** The visitor started typing their first message. */
+    prepare?(): void;
+    /** On mount: the conversation this browser already holds, as messages to show. */
+    restore?(): Promise<ai.UIMessage[]>;
+    /** The visitor started a new conversation. */
+    reset?(): void;
+    dispose?(): void;
+}
+type ChatTransportFactory = (context: ChatTransportContext) => ai.ChatTransport<ai.UIMessage> & ChatTransportLifecycle;
 
 type ModelContextContentBlock = ContentBlock;
 type ModelContextUpdate = {
@@ -1153,6 +1180,12 @@ interface WaniwaniChatOverrides {
     api?: string;
     /** Override the MCP server URL (rarely needed). */
     mcpServerUrl?: string;
+    /**
+     * The app's agent-runtime session route (`/api/mcp/agent/session`). Set,
+     * turns go straight to the agent runtime for a chat the route admits, and
+     * through `api` for one it does not.
+     */
+    sessionApi?: string;
     /**
      * AI transparency notice rendered under the input (EU AI Act compliance).
      * String overrides the default wording; `false` hides it.