@extrachill/chat 0.3.1 → 0.5.1

package/dist/hooks/useChat.d.ts

@@ -1,4 +1,4 @@
-import type { ChatMessage } from '../types/message.ts';
+import type { ChatMessage, ToolCall } from '../types/message.ts';
 import type { ChatSession } from '../types/session.ts';
 import type { ChatAvailability } from '../types/session.ts';
 import type { FetchFn } from '../api.ts';
@@ -41,6 +41,23 @@ export interface UseChatOptions {
      * Called when an error occurs.
      */
     onError?: (error: Error) => void;
+    /**
+     * Called after each turn when tool calls are present in the response.
+     * Use this to react to tool executions (e.g. invalidate caches,
+     * apply diffs to the editor, update external state).
+     */
+    onToolCalls?: (toolCalls: ToolCall[]) => void;
+    /**
+     * Arbitrary metadata forwarded to the backend with each message.
+     * Use for context scoping (e.g. `{ selected_pipeline_id: 42 }`,
+     * `{ post_id: 100, context: 'editor' }`).
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Optional context filter for session listing.
+     * Only sessions created in the matching context are shown.
+     */
+    sessionContext?: string;
 }
 /**
  * Return value of the useChat hook.
@@ -56,12 +73,19 @@ export interface UseChatReturn {
     availability: ChatAvailability;
     /** Active session ID. */
     sessionId: string | null;
+    /**
+     * The session ID that initiated the current request.
+     * Use to avoid stale loading indicators when the user switches
+     * sessions while a request is in flight.
+     * Null when idle.
+     */
+    processingSessionId: string | null;
     /** List of sessions. */
     sessions: ChatSession[];
     /** Whether sessions are loading. */
     sessionsLoading: boolean;
-    /** Send a user message. */
-    sendMessage: (content: string) => void;
+    /** Send a user message (with optional file attachments). */
+    sendMessage: (content: string, files?: File[]) => void;
     /** Switch to a different session. */
     switchSession: (sessionId: string) => void;
     /** Create a new session. */
@@ -98,5 +122,5 @@ export interface UseChatReturn {
  * );
  * ```
  */
-export declare function useChat({ basePath, fetchFn, agentId, initialMessages, initialSessionId, maxContinueTurns, onMessage, onError, }: UseChatOptions): UseChatReturn;
+export declare function useChat({ basePath, fetchFn, agentId, initialMessages, initialSessionId, maxContinueTurns, onMessage, onError, onToolCalls, metadata, sessionContext, }: UseChatOptions): UseChatReturn;
 //# sourceMappingURL=useChat.d.ts.map

package/dist/hooks/useChat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../../src/hooks/useChat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,WAAW,CAAC;AASxD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC3C;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,gDAAgD;IAChD,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,yBAAyB;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,wBAAwB;IACxB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,oCAAoC;IACpC,eAAe,EAAE,OAAO,CAAC;IACzB,2BAA2B;IAC3B,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,qCAAqC;IACrC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,4BAA4B;IAC5B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,wBAAwB;IACxB,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,oDAAoD;IACpD,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,gCAAgC;IAChC,eAAe,EAAE,MAAM,IAAI,CAAC;CAC5B;AAyBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CAAC,EACvB,QAAQ,EACR,OAAO,EACP,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,gBAAqB,EACrB,SAAS,EACT,OAAO,GACP,EAAE,cAAc,GAAG,aAAa,CAwLhC"}
+{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../../src/hooks/useChat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,WAAW,CAAC;AASxE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC3C;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,gDAAgD;IAChD,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,yBAAyB;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;OAKG;IACH,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,wBAAwB;IACxB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,oCAAoC;IACpC,eAAe,EAAE,OAAO,CAAC;IACzB,4DAA4D;IAC5D,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACvD,qCAAqC;IACrC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,4BAA4B;IAC5B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,wBAAwB;IACxB,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,oDAAoD;IACpD,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,gCAAgC;IAChC,eAAe,EAAE,MAAM,IAAI,CAAC;CAC5B;AAyBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CAAC,EACvB,QAAQ,EACR,OAAO,EACP,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,gBAAqB,EACrB,SAAS,EACT,OAAO,EACP,WAAW,EACX,QAAQ,EACR,cAAc,GACd,EAAE,cAAc,GAAG,aAAa,CA0QhC"}

package/dist/hooks/useChat.js

@@ -53,12 +53,13 @@ function toError(err) {
  * );
  * ```
  */
-export function useChat({ basePath, fetchFn, agentId, initialMessages, initialSessionId, maxContinueTurns = 20, onMessage, onError, }) {
+export function useChat({ basePath, fetchFn, agentId, initialMessages, initialSessionId, maxContinueTurns = 20, onMessage, onError, onToolCalls, metadata, sessionContext, }) {
     const [messages, setMessages] = useState(initialMessages ?? []);
     const [isLoading, setIsLoading] = useState(false);
     const [turnCount, setTurnCount] = useState(0);
     const [availability, setAvailability] = useState({ status: 'ready' });
     const [sessionId, setSessionId] = useState(initialSessionId ?? null);
+    const [processingSessionId, setProcessingSessionId] = useState(null);
     const [sessions, setSessions] = useState([]);
     const [sessionsLoading, setSessionsLoading] = useState(false);
     // Build API config from props
@@ -66,12 +67,21 @@ export function useChat({ basePath, fetchFn, agentId, initialMessages, initialSe
     configRef.current = { basePath, fetchFn, agentId };
     const sessionIdRef = useRef(sessionId);
     sessionIdRef.current = sessionId;
+    // Refs for latest callback/metadata values (avoid stale closures).
+    const onToolCallsRef = useRef(onToolCalls);
+    onToolCallsRef.current = onToolCalls;
+    const metadataRef = useRef(metadata);
+    metadataRef.current = metadata;
+    const sessionContextRef = useRef(sessionContext);
+    sessionContextRef.current = sessionContext;
+    // Guard against concurrent session creation.
+    const isCreatingRef = useRef(false);
     // Load sessions on mount
     useEffect(() => {
         const loadSessions = async () => {
             setSessionsLoading(true);
             try {
-                const list = await apiListSessions(configRef.current);
+                const list = await apiListSessions(configRef.current, 20, sessionContextRef.current);
                 setSessions(list);
             }
             catch (err) {
@@ -85,27 +95,74 @@ export function useChat({ basePath, fetchFn, agentId, initialMessages, initialSe
         loadSessions();
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, []);
-    const sendMessage = useCallback(async (content) => {
-        if (isLoading)
+    /**
+     * Collect tool calls from a list of messages and fire the onToolCalls callback.
+     */
+    const fireToolCalls = useCallback((msgs) => {
+        const cb = onToolCallsRef.current;
+        if (!cb)
             return;
+        const allToolCalls = [];
+        for (const msg of msgs) {
+            if (msg.toolCalls?.length) {
+                allToolCalls.push(...msg.toolCalls);
+            }
+        }
+        if (allToolCalls.length > 0) {
+            cb(allToolCalls);
+        }
+    }, []);
+    const sendMessage = useCallback(async (content, files) => {
+        if (isLoading || isCreatingRef.current)
+            return;
+        // Build optimistic attachment previews from local files.
+        let optimisticAttachments;
+        let sendAttachments;
+        if (files?.length) {
+            optimisticAttachments = files.map((file) => ({
+                type: file.type.startsWith('image/') ? 'image'
+                    : file.type.startsWith('video/') ? 'video'
+                        : 'file',
+                url: URL.createObjectURL(file),
+                filename: file.name,
+                mimeType: file.type,
+                size: file.size,
+            }));
+            sendAttachments = files.map((file) => ({
+                filename: file.name,
+                mime_type: file.type,
+            }));
+        }
         // Optimistically add user message
         const userMessage = {
             id: generateMessageId(),
             role: 'user',
             content,
             timestamp: new Date().toISOString(),
+            attachments: optimisticAttachments,
         };
+        // Guard against concurrent session creation.
+        if (!sessionIdRef.current) {
+            isCreatingRef.current = true;
+        }
         setMessages((prev) => [...prev, userMessage]);
         onMessage?.(userMessage);
         setIsLoading(true);
         setTurnCount(0);
+        // Track which session initiated the request.
+        const initiatingSessionId = sessionIdRef.current;
+        setProcessingSessionId(initiatingSessionId);
         try {
-            const result = await apiSendMessage(configRef.current, content, sessionIdRef.current ?? undefined);
+            const result = await apiSendMessage(configRef.current, content, sessionIdRef.current ?? undefined, sendAttachments, metadataRef.current);
+            isCreatingRef.current = false;
             // Update session ID (may be newly created)
             setSessionId(result.sessionId);
             sessionIdRef.current = result.sessionId;
+            setProcessingSessionId(result.sessionId);
             // Replace all messages with the full normalized conversation
             setMessages(result.messages);
+            // Fire tool call callback for the initial response.
+            fireToolCalls(result.messages);
             // Handle multi-turn continuation
             if (!result.completed && !result.maxTurnsReached) {
                 let completed = false;
@@ -118,15 +175,18 @@ export function useChat({ basePath, fetchFn, agentId, initialMessages, initialSe
                     for (const msg of continuation.messages) {
                         onMessage?.(msg);
                     }
+                    // Fire tool call callback for each continuation turn.
+                    fireToolCalls(continuation.messages);
                     completed = continuation.completed || continuation.maxTurnsReached;
                 }
             }
             // Refresh sessions list after a message
-            apiListSessions(configRef.current)
+            apiListSessions(configRef.current, 20, sessionContextRef.current)
                 .then(setSessions)
                 .catch(() => { });
         }
         catch (err) {
+            isCreatingRef.current = false;
             const error = toError(err);
             onError?.(error);
             // Check if it's an auth error
@@ -145,8 +205,9 @@ export function useChat({ basePath, fetchFn, agentId, initialMessages, initialSe
         finally {
             setIsLoading(false);
             setTurnCount(0);
+            setProcessingSessionId(null);
         }
-    }, [isLoading, maxContinueTurns, onMessage, onError]);
+    }, [isLoading, maxContinueTurns, onMessage, onError, fireToolCalls]);
     const switchSession = useCallback(async (newSessionId) => {
         setSessionId(newSessionId);
         sessionIdRef.current = newSessionId;
@@ -188,7 +249,7 @@ export function useChat({ basePath, fetchFn, agentId, initialMessages, initialSe
     const refreshSessions = useCallback(async () => {
         setSessionsLoading(true);
         try {
-            const list = await apiListSessions(configRef.current);
+            const list = await apiListSessions(configRef.current, 20, sessionContextRef.current);
             setSessions(list);
         }
         catch (err) {
@@ -204,6 +265,7 @@ export function useChat({ basePath, fetchFn, agentId, initialMessages, initialSe
         turnCount,
         availability,
         sessionId,
+        processingSessionId,
         sessions,
         sessionsLoading,
         sendMessage,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export type { MessageRole, ToolCall, ToolResultMeta, ChatMessage, ContentFormat, ChatSession, ChatAvailability, ChatInitialState, RawMessage, RawSession, SessionMetadata, } from './types/index.ts';
-export type { FetchFn, FetchOptions, ChatApiConfig, SendResult, ContinueResult } from './api.ts';
+export type { MessageRole, ToolCall, ToolResultMeta, MediaAttachment, ChatMessage, ContentFormat, ChatSession, ChatAvailability, ChatInitialState, RawAttachment, RawMessage, RawSession, SessionMetadata, } from './types/index.ts';
+export type { FetchFn, FetchOptions, ChatApiConfig, SendResult, ContinueResult, SendAttachment } from './api.ts';
 export { sendMessage, continueResponse, listSessions, loadSession, deleteSession, } from './api.ts';
 export { normalizeMessage, normalizeConversation, normalizeSession } from './normalizer.ts';
 export { markdownToHtml } from './markdown.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACX,WAAW,EACX,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,eAAe,GACf,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACjG,OAAO,EACN,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,GACb,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAG5F,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EACN,WAAW,IAAI,oBAAoB,EACnC,KAAK,gBAAgB,GACrB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACN,YAAY,EACZ,KAAK,iBAAiB,GACtB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACN,SAAS,EACT,KAAK,cAAc,GACnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACN,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,SAAS,GACd,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACN,eAAe,EACf,KAAK,oBAAoB,GACzB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACN,eAAe,EACf,KAAK,oBAAoB,GACzB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACN,aAAa,EACb,KAAK,kBAAkB,GACvB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACN,gBAAgB,EAChB,KAAK,qBAAqB,GAC1B,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EACN,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,aAAa,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACX,WAAW,EACX,QAAQ,EACR,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,UAAU,EACV,eAAe,GACf,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACjH,OAAO,EACN,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,GACb,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAG5F,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EACN,WAAW,IAAI,oBAAoB,EACnC,KAAK,gBAAgB,GACrB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACN,YAAY,EACZ,KAAK,iBAAiB,GACtB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACN,SAAS,EACT,KAAK,cAAc,GACnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACN,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,SAAS,GACd,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACN,eAAe,EACf,KAAK,oBAAoB,GACzB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACN,eAAe,EACf,KAAK,oBAAoB,GACzB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACN,aAAa,EACb,KAAK,kBAAkB,GACvB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACN,gBAAgB,EAChB,KAAK,qBAAqB,GAC1B,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EACN,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,aAAa,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/normalizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAO7D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAsE5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,CAEtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,CAQ7D"}
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAiB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAO5E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CA4E5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,CAEtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,CAQ7D"}

package/dist/normalizer.js

@@ -63,9 +63,14 @@ export function normalizeMessage(raw, index) {
     const message = {
         id: generateId(),
         role: raw.role === 'user' ? 'user' : 'assistant',
-        content: raw.content,
+        content: extractTextContent(raw.content),
         timestamp,
     };
+    // Extract attachments from metadata (user uploads and tool-produced media).
+    const attachments = normalizeAttachments(raw);
+    if (attachments.length > 0) {
+        message.attachments = attachments;
+    }
     // Assistant messages may carry tool_calls at the top level
     if (raw.role === 'assistant' && raw.tool_calls?.length) {
         message.toolCalls = raw.tool_calls.map((tc, i) => ({
@@ -94,3 +99,81 @@ export function normalizeSession(raw) {
         messageCount: raw.message_count,
     };
 }
+/**
+ * Extract text content from a message that may be multi-modal.
+ *
+ * When the backend sends multi-modal content, `content` is an array of
+ * content blocks. We extract the text portion for display.
+ */
+function extractTextContent(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        const textParts = content
+            .filter((block) => block.type === 'text' && typeof block.text === 'string')
+            .map((block) => block.text);
+        return textParts.join('\n');
+    }
+    return '';
+}
+/**
+ * Normalize a single raw attachment into a MediaAttachment.
+ */
+function normalizeRawAttachment(raw) {
+    if (!raw.url)
+        return null;
+    const mimeType = raw.mime_type ?? '';
+    let type = 'file';
+    if (raw.type === 'image' || raw.type === 'video' || raw.type === 'file') {
+        type = raw.type;
+    }
+    else if (mimeType.startsWith('image/')) {
+        type = 'image';
+    }
+    else if (mimeType.startsWith('video/')) {
+        type = 'video';
+    }
+    const attachment = {
+        type,
+        url: raw.url,
+    };
+    if (raw.alt)
+        attachment.alt = raw.alt;
+    if (raw.filename)
+        attachment.filename = raw.filename;
+    if (mimeType)
+        attachment.mimeType = mimeType;
+    if (raw.size)
+        attachment.size = raw.size;
+    if (raw.media_id)
+        attachment.mediaId = raw.media_id;
+    if (raw.thumbnail_url)
+        attachment.thumbnailUrl = raw.thumbnail_url;
+    return attachment;
+}
+/**
+ * Extract all attachments from a raw message.
+ *
+ * Checks metadata.attachments (user uploads) and metadata.media
+ * (tool-produced media) for renderable media.
+ */
+function normalizeAttachments(raw) {
+    const attachments = [];
+    // User-uploaded attachments.
+    if (raw.metadata?.attachments) {
+        for (const rawAtt of raw.metadata.attachments) {
+            const att = normalizeRawAttachment(rawAtt);
+            if (att)
+                attachments.push(att);
+        }
+    }
+    // Tool-produced media.
+    if (raw.metadata?.media) {
+        for (const rawMedia of raw.metadata.media) {
+            const att = normalizeRawAttachment(rawMedia);
+            if (att)
+                attachments.push(att);
+        }
+    }
+    return attachments;
+}

package/dist/types/api.d.ts

@@ -9,18 +9,35 @@
  * A raw message as stored/returned by the backend.
  * The package normalizes these into ChatMessage before rendering.
  */
+/**
+ * A raw media attachment as returned by the backend.
+ */
+export interface RawAttachment {
+    type?: string;
+    url?: string;
+    alt?: string;
+    filename?: string;
+    mime_type?: string;
+    size?: number;
+    media_id?: number;
+    thumbnail_url?: string;
+}
 export interface RawMessage {
     role: 'user' | 'assistant';
     content: string;
     metadata?: {
         timestamp?: string;
-        type?: 'text' | 'tool_call' | 'tool_result';
+        type?: 'text' | 'multimodal' | 'tool_call' | 'tool_result';
         tool_name?: string;
         parameters?: Record<string, unknown>;
         success?: boolean;
         error?: string;
         turn?: number;
         tool_data?: Record<string, unknown>;
+        /** Attachments sent with the message. */
+        attachments?: RawAttachment[];
+        /** Media produced by tool results. */
+        media?: RawAttachment[];
     };
     tool_calls?: Array<{
         tool_name: string;
@@ -34,6 +51,13 @@ export interface SendRequest {
     message: string;
     session_id?: string;
     agent_id?: number;
+    /** Media attachments to send with the message. */
+    attachments?: Array<{
+        url?: string;
+        media_id?: number;
+        mime_type?: string;
+        filename?: string;
+    }>;
 }
 export interface SendResponse {
     success: boolean;

package/dist/types/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export type { MessageRole, ToolCall, ToolResultMeta, ChatMessage, ContentFormat, } from './message.ts';
+export type { MessageRole, ToolCall, ToolResultMeta, MediaAttachment, ChatMessage, ContentFormat, } from './message.ts';
 export type { ChatSession, ChatAvailability, ChatInitialState, } from './session.ts';
-export type { RawMessage, RawSession, SendRequest, SendResponse, ContinueRequest, ContinueResponse, ListSessionsResponse, GetSessionResponse, DeleteSessionResponse, SessionMetadata, } from './api.ts';
+export type { RawAttachment, RawMessage, RawSession, SendRequest, SendResponse, ContinueRequest, ContinueResponse, ListSessionsResponse, GetSessionResponse, DeleteSessionResponse, SessionMetadata, } from './api.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,WAAW,EACX,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,GACb,MAAM,cAAc,CAAC;AAEtB,YAAY,EACX,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,GACf,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,WAAW,EACX,QAAQ,EACR,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,GACb,MAAM,cAAc,CAAC;AAEtB,YAAY,EACX,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACX,aAAa,EACb,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,GACf,MAAM,UAAU,CAAC"}

package/dist/types/message.d.ts

@@ -34,6 +34,27 @@ export interface ToolResultMeta {
     /** Whether the tool call succeeded. */
     success: boolean;
 }
+/**
+ * A media attachment on a chat message (image, video, or file).
+ */
+export interface MediaAttachment {
+    /** Media type. */
+    type: 'image' | 'video' | 'file';
+    /** Public URL of the media. */
+    url: string;
+    /** Alt text or description. */
+    alt?: string;
+    /** Original filename. */
+    filename?: string;
+    /** MIME type (e.g. 'image/jpeg'). */
+    mimeType?: string;
+    /** File size in bytes. */
+    size?: number;
+    /** WordPress media library attachment ID. */
+    mediaId?: number;
+    /** Thumbnail URL for previews. */
+    thumbnailUrl?: string;
+}
 /**
  * A single message in a chat conversation.
  */
@@ -50,6 +71,8 @@ export interface ChatMessage {
     toolCalls?: ToolCall[];
     /** Tool result metadata (only on tool_result messages). */
     toolResult?: ToolResultMeta;
+    /** Media attachments (images, videos, files) on this message. */
+    attachments?: MediaAttachment[];
 }
 /**
  * Content format hint for how message content should be rendered.

package/dist/types/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,kBAAkB;IAClB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,iEAAiE;IACjE,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@extrachill/chat",
-  "version": "0.3.1",
+  "version": "0.5.1",
   "description": "Chat UI components with built-in REST API client. Speaks the standard chat message format natively.",
   "type": "module",
   "main": "./dist/index.js",

package/src/Chat.tsx

@@ -52,6 +52,15 @@ export interface ChatProps {
 	showSessions?: boolean;
 	/** Label shown during multi-turn processing. */
 	processingLabel?: (turnCount: number) => string;
+	/** Whether to show the attachment button in the input. Defaults to true. */
+	allowAttachments?: boolean;
+	/** Accepted file types for attachments. Defaults to 'image/*,video/*'. */
+	acceptFileTypes?: string;
+	/**
+	 * Arbitrary metadata forwarded to the backend with each message.
+	 * Use for client-side context injection (e.g. `{ client_context: { tab: 'compose', postId: 123 } }`).
+	 */
+	metadata?: Record<string, unknown>;
 }
 
 /**
@@ -95,6 +104,9 @@ export function Chat({
 	className,
 	showSessions = true,
 	processingLabel,
+	allowAttachments = true,
+	acceptFileTypes,
+	metadata,
 }: ChatProps) {
 	const chat = useChat({
 		basePath,
@@ -105,6 +117,7 @@ export function Chat({
 		maxContinueTurns,
 		onError,
 		onMessage,
+		metadata,
 	});
 
 	const baseClass = 'ec-chat';
@@ -149,6 +162,8 @@ export function Chat({
 						onSend={chat.sendMessage}
 						disabled={chat.isLoading}
 						placeholder={placeholder}
+						allowAttachments={allowAttachments}
+						accept={acceptFileTypes}
 					/>
 				</AvailabilityGate>
 			</div>

package/src/api.ts

@@ -31,7 +31,12 @@ import { normalizeConversation, normalizeMessage, normalizeSession } from './nor
 export interface FetchOptions {
 	path: string;
 	method?: string;
+	/** JSON body (mutually exclusive with formData). */
 	data?: Record<string, unknown>;
+	/** FormData body for file uploads (mutually exclusive with data). */
+	formData?: FormData;
+	/** Additional HTTP headers. */
+	headers?: Record<string, string>;
 }
 
 export type FetchFn = (options: FetchOptions) => Promise<unknown>;
@@ -60,22 +65,51 @@ export interface ContinueResult {
 	maxTurnsReached: boolean;
 }
 
+/**
+ * Attachment metadata to send with a message.
+ */
+export interface SendAttachment {
+	url?: string;
+	media_id?: number;
+	mime_type?: string;
+	filename?: string;
+}
+
 /**
  * Send a user message (create or continue a session).
+ *
+ * When attachments are provided, they are included in the JSON body
+ * as structured metadata (not as file uploads — files should already
+ * be in the WordPress media library or accessible by URL).
+ *
+ * @param metadata - Arbitrary key-value pairs forwarded to the backend
+ *   alongside the message (e.g. `{ selected_pipeline_id: 42 }` or
+ *   `{ post_id: 100, context: 'editor' }`). The backend can use these
+ *   to scope the AI's behavior. Not persisted as message content.
  */
 export async function sendMessage(
 	config: ChatApiConfig,
 	content: string,
 	sessionId?: string,
+	attachments?: SendAttachment[],
+	metadata?: Record<string, unknown>,
 ): Promise<SendResult> {
 	const body: Record<string, unknown> = { message: content };
 	if (sessionId) body.session_id = sessionId;
 	if (config.agentId) body.agent_id = config.agentId;
+	if (attachments?.length) body.attachments = attachments;
+	if (metadata) Object.assign(body, metadata);
+
+	// Generate a unique request ID for idempotent request handling.
+	const requestId = typeof crypto !== 'undefined' && crypto.randomUUID
+		? crypto.randomUUID()
+		: `req_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
 
 	const raw = await config.fetchFn({
 		path: config.basePath,
 		method: 'POST',
 		data: body,
+		headers: { 'X-Request-ID': requestId },
 	}) as SendResponse;
 
 	if (!raw.success) {
@@ -118,13 +152,18 @@ export async function continueResponse(
 
 /**
  * List sessions for the current user.
+ *
+ * @param context - Optional context filter (e.g. 'chat', 'editor', 'pipeline').
+ *   Only sessions created in the matching context are returned.
  */
 export async function listSessions(
 	config: ChatApiConfig,
 	limit = 20,
+	context?: string,
 ): Promise<ChatSession[]> {
 	const params = new URLSearchParams({ limit: String(limit) });
 	if (config.agentId) params.set('agent_id', String(config.agentId));
+	if (context) params.set('context', context);
 
 	const raw = await config.fetchFn({
 		path: `${config.basePath}/sessions?${params.toString()}`,