@extrachill/chat 0.2.0

package/dist/components/ErrorBoundary.d.ts

@@ -0,0 +1,27 @@
+import { Component, type ErrorInfo, type ReactNode } from 'react';
+export interface ErrorBoundaryProps {
+    /** Content to render when an error occurs. */
+    fallback?: ReactNode | ((error: Error, reset: () => void) => ReactNode);
+    /** Called when an error is caught. */
+    onError?: (error: Error, errorInfo: ErrorInfo) => void;
+    /** Children to render. */
+    children: ReactNode;
+}
+interface ErrorBoundaryState {
+    error: Error | null;
+}
+/**
+ * Error boundary for the chat UI.
+ *
+ * Catches React render errors and shows a fallback UI with retry.
+ * Resets automatically when children change via key prop.
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    reset: () => void;
+    render(): string | number | boolean | Iterable<ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}
+export {};
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/dist/components/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/components/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElE,MAAM,WAAW,kBAAkB;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC,CAAC;IACxE,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACvD,0BAA0B;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACpB;AAED,UAAU,kBAAkB;IAC3B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAC1E,KAAK,EAAE,kBAAkB,CAAmB;IAErD,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAIxD,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS;IAI7D,KAAK,aAEH;IAEO,MAAM;CA6Bf"}

package/dist/components/ErrorBoundary.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Component } from 'react';
+/**
+ * Error boundary for the chat UI.
+ *
+ * Catches React render errors and shows a fallback UI with retry.
+ * Resets automatically when children change via key prop.
+ */
+export class ErrorBoundary extends Component {
+    state = { error: null };
+    static getDerivedStateFromError(error) {
+        return { error };
+    }
+    componentDidCatch(error, errorInfo) {
+        this.props.onError?.(error, errorInfo);
+    }
+    reset = () => {
+        this.setState({ error: null });
+    };
+    render() {
+        const { error } = this.state;
+        const { fallback, children } = this.props;
+        if (error) {
+            if (typeof fallback === 'function') {
+                return fallback(error, this.reset);
+            }
+            if (fallback) {
+                return fallback;
+            }
+            return (_jsxs("div", { className: "ec-chat-error", children: [_jsx("p", { className: "ec-chat-error__message", children: "Something went wrong in the chat." }), _jsx("button", { className: "ec-chat-error__retry", onClick: this.reset, type: "button", children: "Try again" })] }));
+        }
+        return children;
+    }
+}

package/dist/components/SessionSwitcher.d.ts

@@ -0,0 +1,25 @@
+import type { ChatSession } from '../types/index.ts';
+export interface SessionSwitcherProps {
+    /** List of available sessions. */
+    sessions: ChatSession[];
+    /** Currently active session ID. */
+    activeSessionId?: string;
+    /** Called when a session is selected. */
+    onSelect: (sessionId: string) => void;
+    /** Called when the user wants to create a new session. */
+    onNew?: () => void;
+    /** Called when the user wants to delete a session. */
+    onDelete?: (sessionId: string) => void;
+    /** Whether sessions are currently loading. */
+    loading?: boolean;
+    /** Additional CSS class name. */
+    className?: string;
+}
+/**
+ * Session switcher dropdown.
+ *
+ * Renders a list of sessions with the active one highlighted.
+ * Only rendered when the adapter declares `capabilities.sessions = true`.
+ */
+export declare function SessionSwitcher({ sessions, activeSessionId, onSelect, onNew, onDelete, loading, className, }: SessionSwitcherProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SessionSwitcher.d.ts.map

package/dist/components/SessionSwitcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionSwitcher.d.ts","sourceRoot":"","sources":["../../src/components/SessionSwitcher.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACpC,kCAAkC;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC/B,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,OAAe,EACf,SAAS,GACT,EAAE,oBAAoB,2CAyEtB"}

package/dist/components/SessionSwitcher.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Session switcher dropdown.
+ *
+ * Renders a list of sessions with the active one highlighted.
+ * Only rendered when the adapter declares `capabilities.sessions = true`.
+ */
+export function SessionSwitcher({ sessions, activeSessionId, onSelect, onNew, onDelete, loading = false, className, }) {
+    const baseClass = 'ec-chat-sessions';
+    const classes = [baseClass, className].filter(Boolean).join(' ');
+    return (_jsxs("div", { className: classes, children: [_jsxs("div", { className: `${baseClass}__header`, children: [_jsx("span", { className: `${baseClass}__title`, children: "Conversations" }), onNew && (_jsx("button", { className: `${baseClass}__new`, onClick: onNew, "aria-label": "New conversation", type: "button", children: "+" }))] }), loading && (_jsx("div", { className: `${baseClass}__loading`, children: "Loading..." })), _jsx("ul", { className: `${baseClass}__list`, role: "listbox", "aria-label": "Chat sessions", children: sessions.map((session) => {
+                    const isActive = session.id === activeSessionId;
+                    const itemClass = [
+                        `${baseClass}__item`,
+                        isActive ? `${baseClass}__item--active` : '',
+                    ].filter(Boolean).join(' ');
+                    return (_jsxs("li", { className: itemClass, role: "option", "aria-selected": isActive, children: [_jsxs("button", { className: `${baseClass}__item-button`, onClick: () => onSelect(session.id), type: "button", children: [_jsx("span", { className: `${baseClass}__item-title`, children: session.title ?? `Session ${session.id.slice(0, 8)}` }), _jsx("time", { className: `${baseClass}__item-date`, dateTime: session.updatedAt, children: formatRelativeDate(session.updatedAt) })] }), onDelete && (_jsx("button", { className: `${baseClass}__item-delete`, onClick: (e) => {
+                                    e.stopPropagation();
+                                    onDelete(session.id);
+                                }, "aria-label": `Delete session ${session.title ?? session.id}`, type: "button", children: "\\u00D7" }))] }, session.id));
+                }) })] }));
+}
+function formatRelativeDate(iso) {
+    try {
+        const date = new Date(iso);
+        const now = new Date();
+        const diffMs = now.getTime() - date.getTime();
+        const diffMins = Math.floor(diffMs / 60_000);
+        if (diffMins < 1)
+            return 'just now';
+        if (diffMins < 60)
+            return `${diffMins}m ago`;
+        const diffHours = Math.floor(diffMins / 60);
+        if (diffHours < 24)
+            return `${diffHours}h ago`;
+        const diffDays = Math.floor(diffHours / 24);
+        if (diffDays < 7)
+            return `${diffDays}d ago`;
+        return date.toLocaleDateString();
+    }
+    catch {
+        return '';
+    }
+}

package/dist/components/ToolMessage.d.ts

@@ -0,0 +1,34 @@
+import type { ChatMessage } from '../types/index.ts';
+/**
+ * A paired tool call + result for display.
+ */
+export interface ToolGroup {
+    /** The message containing the tool call. */
+    callMessage: ChatMessage;
+    /** The result message (null if still pending). */
+    resultMessage: ChatMessage | null;
+    /** Tool function name. */
+    toolName: string;
+    /** Parameters passed to the tool. */
+    parameters: Record<string, unknown>;
+    /** Whether the tool succeeded (null if pending). */
+    success: boolean | null;
+}
+export interface ToolMessageProps {
+    /** The tool call/result group to display. */
+    group: ToolGroup;
+    /** Map of tool names to friendly display labels. */
+    toolNames?: Record<string, string>;
+    /** Whether the tool details are initially expanded. Defaults to false. */
+    defaultExpanded?: boolean;
+    /** Additional CSS class name. */
+    className?: string;
+}
+/**
+ * Renders a collapsible tool call/result pair.
+ *
+ * Shows a summary line with the tool name (or friendly label),
+ * success/error indicator, and expandable details section.
+ */
+export declare function ToolMessage({ group, toolNames, defaultExpanded, className, }: ToolMessageProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ToolMessage.d.ts.map

package/dist/components/ToolMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolMessage.d.ts","sourceRoot":"","sources":["../../src/components/ToolMessage.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,4CAA4C;IAC5C,WAAW,EAAE,WAAW,CAAC;IACzB,kDAAkD;IAClD,aAAa,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,oDAAoD;IACpD,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAChC,6CAA6C;IAC7C,KAAK,EAAE,SAAS,CAAC;IACjB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAC3B,KAAK,EACL,SAAS,EACT,eAAuB,EACvB,SAAS,GACT,EAAE,gBAAgB,2CAkDlB"}

package/dist/components/ToolMessage.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+/**
+ * Renders a collapsible tool call/result pair.
+ *
+ * Shows a summary line with the tool name (or friendly label),
+ * success/error indicator, and expandable details section.
+ */
+export function ToolMessage({ group, toolNames, defaultExpanded = false, className, }) {
+    const [expanded, setExpanded] = useState(defaultExpanded);
+    const displayName = toolNames?.[group.toolName] ?? formatToolName(group.toolName);
+    const baseClass = 'ec-chat-tool';
+    const statusClass = group.success === true
+        ? `${baseClass}--success`
+        : group.success === false
+            ? `${baseClass}--error`
+            : `${baseClass}--pending`;
+    const classes = [baseClass, statusClass, className].filter(Boolean).join(' ');
+    return (_jsxs("div", { className: classes, children: [_jsxs("button", { className: `${baseClass}__header`, onClick: () => setExpanded(!expanded), "aria-expanded": expanded, type: "button", children: [_jsx("span", { className: `${baseClass}__icon`, children: group.success === true ? '\u2713' : group.success === false ? '\u2717' : '\u2026' }), _jsx("span", { className: `${baseClass}__name`, children: displayName }), _jsx("span", { className: `${baseClass}__chevron`, children: expanded ? '\u25B2' : '\u25BC' })] }), expanded && (_jsxs("div", { className: `${baseClass}__details`, children: [Object.keys(group.parameters).length > 0 && (_jsxs("div", { className: `${baseClass}__section`, children: [_jsx("div", { className: `${baseClass}__section-label`, children: "Parameters" }), _jsx("pre", { className: `${baseClass}__json`, children: JSON.stringify(group.parameters, null, 2) })] })), group.resultMessage && (_jsxs("div", { className: `${baseClass}__section`, children: [_jsx("div", { className: `${baseClass}__section-label`, children: "Result" }), _jsx("pre", { className: `${baseClass}__json`, children: formatResult(group.resultMessage.content) })] }))] }))] }));
+}
+/**
+ * Convert snake_case tool name to a readable label.
+ */
+function formatToolName(name) {
+    return name
+        .replace(/_/g, ' ')
+        .replace(/\b\w/g, (c) => c.toUpperCase());
+}
+/**
+ * Try to pretty-print JSON content, fall back to raw string.
+ */
+function formatResult(content) {
+    try {
+        return JSON.stringify(JSON.parse(content), null, 2);
+    }
+    catch {
+        return content;
+    }
+}

package/dist/components/TypingIndicator.d.ts

@@ -0,0 +1,16 @@
+export interface TypingIndicatorProps {
+    /** Whether the indicator is visible. */
+    visible: boolean;
+    /** Optional label text. Defaults to none (dots only). */
+    label?: string;
+    /** Additional CSS class name. */
+    className?: string;
+}
+/**
+ * Animated typing indicator with three bouncing dots.
+ *
+ * Renders as an assistant-style message bubble.
+ * The animation is pure CSS — no JS timers.
+ */
+export declare function TypingIndicator({ visible, label, className, }: TypingIndicatorProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=TypingIndicator.d.ts.map

package/dist/components/TypingIndicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypingIndicator.d.ts","sourceRoot":"","sources":["../../src/components/TypingIndicator.tsx"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACpC,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC/B,OAAO,EACP,KAAK,EACL,SAAS,GACT,EAAE,oBAAoB,kDAgBtB"}

package/dist/components/TypingIndicator.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Animated typing indicator with three bouncing dots.
+ *
+ * Renders as an assistant-style message bubble.
+ * The animation is pure CSS — no JS timers.
+ */
+export function TypingIndicator({ visible, label, className, }) {
+    if (!visible)
+        return null;
+    const baseClass = 'ec-chat-typing';
+    const classes = [baseClass, className].filter(Boolean).join(' ');
+    return (_jsxs("div", { className: classes, role: "status", "aria-label": "Assistant is typing", children: [_jsxs("div", { className: `${baseClass}__dots`, children: [_jsx("span", { className: `${baseClass}__dot` }), _jsx("span", { className: `${baseClass}__dot` }), _jsx("span", { className: `${baseClass}__dot` })] }), label && _jsx("span", { className: `${baseClass}__label`, children: label })] }));
+}

package/dist/components/index.d.ts

@@ -0,0 +1,9 @@
+export { ChatMessage, type ChatMessageProps } from './ChatMessage.tsx';
+export { ChatMessages, type ChatMessagesProps } from './ChatMessages.tsx';
+export { ChatInput, type ChatInputProps } from './ChatInput.tsx';
+export { ToolMessage, type ToolMessageProps, type ToolGroup } from './ToolMessage.tsx';
+export { TypingIndicator, type TypingIndicatorProps } from './TypingIndicator.tsx';
+export { SessionSwitcher, type SessionSwitcherProps } from './SessionSwitcher.tsx';
+export { ErrorBoundary, type ErrorBoundaryProps } from './ErrorBoundary.tsx';
+export { AvailabilityGate, type AvailabilityGateProps } from './AvailabilityGate.tsx';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/components/index.js

@@ -0,0 +1,8 @@
+export { ChatMessage } from "./ChatMessage.js";
+export { ChatMessages } from "./ChatMessages.js";
+export { ChatInput } from "./ChatInput.js";
+export { ToolMessage } from "./ToolMessage.js";
+export { TypingIndicator } from "./TypingIndicator.js";
+export { SessionSwitcher } from "./SessionSwitcher.js";
+export { ErrorBoundary } from "./ErrorBoundary.js";
+export { AvailabilityGate } from "./AvailabilityGate.js";

package/dist/hooks/index.d.ts

@@ -0,0 +1,2 @@
+export { useChat, type UseChatOptions, type UseChatReturn } from './useChat.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1 @@
+export { useChat } from "./useChat.js";

package/dist/hooks/useChat.d.ts

@@ -0,0 +1,102 @@
+import type { ChatMessage } from '../types/message.ts';
+import type { ChatSession } from '../types/session.ts';
+import type { ChatAvailability } from '../types/session.ts';
+import type { FetchFn } from '../api.ts';
+/**
+ * Configuration for the useChat hook.
+ */
+export interface UseChatOptions {
+    /**
+     * Base path for the chat REST endpoints.
+     * e.g. '/datamachine/v1/chat'
+     */
+    basePath: string;
+    /**
+     * Fetch function for API calls. Must accept { path, method?, data? }
+     * and return parsed JSON. @wordpress/api-fetch works directly.
+     */
+    fetchFn: FetchFn;
+    /**
+     * Agent ID to scope the chat to.
+     */
+    agentId?: number;
+    /**
+     * Initial messages to hydrate state with (e.g. server-rendered).
+     */
+    initialMessages?: ChatMessage[];
+    /**
+     * Initial session ID (e.g. from server-rendered state).
+     */
+    initialSessionId?: string;
+    /**
+     * Maximum number of continuation turns before stopping.
+     * Defaults to 20.
+     */
+    maxContinueTurns?: number;
+    /**
+     * Called when a new message is added to the conversation.
+     */
+    onMessage?: (message: ChatMessage) => void;
+    /**
+     * Called when an error occurs.
+     */
+    onError?: (error: Error) => void;
+}
+/**
+ * Return value of the useChat hook.
+ */
+export interface UseChatReturn {
+    /** All messages in the current conversation. */
+    messages: ChatMessage[];
+    /** Whether a message is being sent/processed. */
+    isLoading: boolean;
+    /** Current continuation turn count (0 when not processing). */
+    turnCount: number;
+    /** Current availability state. */
+    availability: ChatAvailability;
+    /** Active session ID. */
+    sessionId: string | null;
+    /** List of sessions. */
+    sessions: ChatSession[];
+    /** Whether sessions are loading. */
+    sessionsLoading: boolean;
+    /** Send a user message. */
+    sendMessage: (content: string) => void;
+    /** Switch to a different session. */
+    switchSession: (sessionId: string) => void;
+    /** Create a new session. */
+    newSession: () => void;
+    /** Delete a session. */
+    deleteSession: (sessionId: string) => void;
+    /** Clear the current session's messages locally. */
+    clearSession: () => void;
+    /** Refresh the session list. */
+    refreshSessions: () => void;
+}
+/**
+ * Core state orchestrator for the chat UI.
+ *
+ * Manages messages, sessions, continuation loops, and availability
+ * by calling the standard chat REST endpoints directly.
+ *
+ * @example
+ * ```tsx
+ * import apiFetch from '@wordpress/api-fetch';
+ *
+ * const chat = useChat({
+ *   basePath: '/datamachine/v1/chat',
+ *   fetchFn: apiFetch,
+ *   agentId: 5,
+ * });
+ *
+ * return (
+ *   <>
+ *     <ChatMessages messages={chat.messages} />
+ *     <TypingIndicator visible={chat.isLoading} />
+ *     <ChatInput onSend={chat.sendMessage} disabled={chat.isLoading} />
+ *   </>
+ * );
+ * ```
+ */
+export declare function useChat({ basePath, fetchFn, agentId, initialMessages, initialSessionId, maxContinueTurns, onMessage, onError, }: UseChatOptions): UseChatReturn;
+//# sourceMappingURL=useChat.d.ts.map

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

@@ -0,0 +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;AAOD;;;;;;;;;;;;;;;;;;;;;;;;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"}

package/dist/hooks/useChat.js

@@ -0,0 +1,192 @@
+import { useState, useCallback, useRef, useEffect } from 'react';
+import { sendMessage as apiSendMessage, continueResponse as apiContinueResponse, listSessions as apiListSessions, loadSession as apiLoadSession, deleteSession as apiDeleteSession, } from "../api.js";
+let messageIdCounter = 0;
+function generateMessageId() {
+    return `msg_${Date.now()}_${++messageIdCounter}`;
+}
+/**
+ * Core state orchestrator for the chat UI.
+ *
+ * Manages messages, sessions, continuation loops, and availability
+ * by calling the standard chat REST endpoints directly.
+ *
+ * @example
+ * ```tsx
+ * import apiFetch from '@wordpress/api-fetch';
+ *
+ * const chat = useChat({
+ *   basePath: '/datamachine/v1/chat',
+ *   fetchFn: apiFetch,
+ *   agentId: 5,
+ * });
+ *
+ * return (
+ *   <>
+ *     <ChatMessages messages={chat.messages} />
+ *     <TypingIndicator visible={chat.isLoading} />
+ *     <ChatInput onSend={chat.sendMessage} disabled={chat.isLoading} />
+ *   </>
+ * );
+ * ```
+ */
+export function useChat({ basePath, fetchFn, agentId, initialMessages, initialSessionId, maxContinueTurns = 20, onMessage, onError, }) {
+    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 [sessions, setSessions] = useState([]);
+    const [sessionsLoading, setSessionsLoading] = useState(false);
+    // Build API config from props
+    const configRef = useRef({ basePath, fetchFn, agentId });
+    configRef.current = { basePath, fetchFn, agentId };
+    const sessionIdRef = useRef(sessionId);
+    sessionIdRef.current = sessionId;
+    // Load sessions on mount
+    useEffect(() => {
+        const loadSessions = async () => {
+            setSessionsLoading(true);
+            try {
+                const list = await apiListSessions(configRef.current);
+                setSessions(list);
+            }
+            catch (err) {
+                // Sessions not available — degrade gracefully
+                onError?.(err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                setSessionsLoading(false);
+            }
+        };
+        loadSessions();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    const sendMessage = useCallback(async (content) => {
+        if (isLoading)
+            return;
+        // Optimistically add user message
+        const userMessage = {
+            id: generateMessageId(),
+            role: 'user',
+            content,
+            timestamp: new Date().toISOString(),
+        };
+        setMessages((prev) => [...prev, userMessage]);
+        onMessage?.(userMessage);
+        setIsLoading(true);
+        setTurnCount(0);
+        try {
+            const result = await apiSendMessage(configRef.current, content, sessionIdRef.current ?? undefined);
+            // Update session ID (may be newly created)
+            setSessionId(result.sessionId);
+            sessionIdRef.current = result.sessionId;
+            // Replace all messages with the full normalized conversation
+            setMessages(result.messages);
+            // Handle multi-turn continuation
+            if (!result.completed && !result.maxTurnsReached) {
+                let completed = false;
+                let turns = 0;
+                while (!completed && turns < maxContinueTurns) {
+                    turns++;
+                    setTurnCount(turns);
+                    const continuation = await apiContinueResponse(configRef.current, result.sessionId);
+                    setMessages((prev) => [...prev, ...continuation.messages]);
+                    for (const msg of continuation.messages) {
+                        onMessage?.(msg);
+                    }
+                    completed = continuation.completed || continuation.maxTurnsReached;
+                }
+            }
+            // Refresh sessions list after a message
+            apiListSessions(configRef.current)
+                .then(setSessions)
+                .catch(() => { });
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            onError?.(error);
+            // Check if it's an auth error
+            if (error.message.includes('403') || error.message.includes('rest_forbidden')) {
+                setAvailability({ status: 'login-required' });
+            }
+            // Add error as assistant message so it's visible in the UI
+            const errorMessage = {
+                id: generateMessageId(),
+                role: 'assistant',
+                content: `Sorry, something went wrong: ${error.message}`,
+                timestamp: new Date().toISOString(),
+            };
+            setMessages((prev) => [...prev, errorMessage]);
+        }
+        finally {
+            setIsLoading(false);
+            setTurnCount(0);
+        }
+    }, [isLoading, maxContinueTurns, onMessage, onError]);
+    const switchSession = useCallback(async (newSessionId) => {
+        setSessionId(newSessionId);
+        sessionIdRef.current = newSessionId;
+        setIsLoading(true);
+        try {
+            const loaded = await apiLoadSession(configRef.current, newSessionId);
+            setMessages(loaded);
+        }
+        catch (err) {
+            onError?.(err instanceof Error ? err : new Error(String(err)));
+            setMessages([]);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [onError]);
+    const newSession = useCallback(() => {
+        setSessionId(null);
+        sessionIdRef.current = null;
+        setMessages([]);
+    }, []);
+    const deleteSessionHandler = useCallback(async (targetSessionId) => {
+        try {
+            await apiDeleteSession(configRef.current, targetSessionId);
+            setSessions((prev) => prev.filter((s) => s.id !== targetSessionId));
+            if (sessionIdRef.current === targetSessionId) {
+                setSessionId(null);
+                sessionIdRef.current = null;
+                setMessages([]);
+            }
+        }
+        catch (err) {
+            onError?.(err instanceof Error ? err : new Error(String(err)));
+        }
+    }, [onError]);
+    const clearSession = useCallback(() => {
+        setMessages([]);
+    }, []);
+    const refreshSessions = useCallback(async () => {
+        setSessionsLoading(true);
+        try {
+            const list = await apiListSessions(configRef.current);
+            setSessions(list);
+        }
+        catch (err) {
+            onError?.(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setSessionsLoading(false);
+        }
+    }, [onError]);
+    return {
+        messages,
+        isLoading,
+        turnCount,
+        availability,
+        sessionId,
+        sessions,
+        sessionsLoading,
+        sendMessage,
+        switchSession,
+        newSession,
+        deleteSession: deleteSessionHandler,
+        clearSession,
+        refreshSessions,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+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 { sendMessage, continueResponse, listSessions, loadSession, deleteSession, } from './api.ts';
+export { normalizeMessage, normalizeConversation, normalizeSession } from './normalizer.ts';
+export { ChatMessage as ChatMessageComponent, type ChatMessageProps, } from './components/ChatMessage.tsx';
+export { ChatMessages, type ChatMessagesProps, } from './components/ChatMessages.tsx';
+export { ChatInput, type ChatInputProps, } from './components/ChatInput.tsx';
+export { ToolMessage, type ToolMessageProps, type ToolGroup, } from './components/ToolMessage.tsx';
+export { TypingIndicator, type TypingIndicatorProps, } from './components/TypingIndicator.tsx';
+export { SessionSwitcher, type SessionSwitcherProps, } from './components/SessionSwitcher.tsx';
+export { ErrorBoundary, type ErrorBoundaryProps, } from './components/ErrorBoundary.tsx';
+export { AvailabilityGate, type AvailabilityGateProps, } from './components/AvailabilityGate.tsx';
+export { useChat, type UseChatOptions, type UseChatReturn, } from './hooks/useChat.ts';
+export { Chat, type ChatProps } from './Chat.tsx';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,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/index.js

@@ -0,0 +1,16 @@
+export { sendMessage, continueResponse, listSessions, loadSession, deleteSession, } from "./api.js";
+// Normalizer
+export { normalizeMessage, normalizeConversation, normalizeSession } from "./normalizer.js";
+// Components
+export { ChatMessage as ChatMessageComponent, } from "./components/ChatMessage.js";
+export { ChatMessages, } from "./components/ChatMessages.js";
+export { ChatInput, } from "./components/ChatInput.js";
+export { ToolMessage, } from "./components/ToolMessage.js";
+export { TypingIndicator, } from "./components/TypingIndicator.js";
+export { SessionSwitcher, } from "./components/SessionSwitcher.js";
+export { ErrorBoundary, } from "./components/ErrorBoundary.js";
+export { AvailabilityGate, } from "./components/AvailabilityGate.js";
+// Hook
+export { useChat, } from "./hooks/useChat.js";
+// Composed
+export { Chat } from "./Chat.js";