@extrachill/chat 0.2.0

package/dist/normalizer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Normalize raw backend messages into the ChatMessage format
+ * used by the UI components.
+ *
+ * The backend stores tool calls and results as regular messages
+ * with metadata.type = 'tool_call' | 'tool_result'. This normalizer
+ * maps them into the package's role-based message model.
+ */
+import type { ChatMessage } from './types/message.ts';
+import type { ChatSession } from './types/session.ts';
+import type { RawMessage, RawSession } from './types/api.ts';
+/**
+ * Normalize a raw backend message into a ChatMessage.
+ */
+export declare function normalizeMessage(raw: RawMessage, index: number): ChatMessage;
+/**
+ * Normalize a full conversation array.
+ */
+export declare function normalizeConversation(raw: RawMessage[]): ChatMessage[];
+/**
+ * Normalize a raw session into a ChatSession.
+ */
+export declare function normalizeSession(raw: RawSession): ChatSession;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/normalizer.d.ts.map

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

package/dist/normalizer.js

@@ -0,0 +1,96 @@
+/**
+ * Normalize raw backend messages into the ChatMessage format
+ * used by the UI components.
+ *
+ * The backend stores tool calls and results as regular messages
+ * with metadata.type = 'tool_call' | 'tool_result'. This normalizer
+ * maps them into the package's role-based message model.
+ */
+let idCounter = 0;
+function generateId() {
+    return `msg_${Date.now()}_${++idCounter}`;
+}
+/**
+ * Normalize a raw backend message into a ChatMessage.
+ */
+export function normalizeMessage(raw, index) {
+    const type = raw.metadata?.type ?? 'text';
+    const timestamp = raw.metadata?.timestamp ?? new Date().toISOString();
+    if (type === 'tool_call') {
+        const toolCalls = [];
+        // Extract from metadata (single tool call)
+        if (raw.metadata?.tool_name) {
+            toolCalls.push({
+                id: `tc_${index}_${raw.metadata.tool_name}`,
+                name: raw.metadata.tool_name,
+                parameters: raw.metadata.parameters ?? {},
+            });
+        }
+        // Also check top-level tool_calls array
+        if (raw.tool_calls?.length) {
+            for (const tc of raw.tool_calls) {
+                // Avoid duplicates
+                if (!toolCalls.some((t) => t.name === tc.tool_name)) {
+                    toolCalls.push({
+                        id: `tc_${index}_${tc.tool_name}`,
+                        name: tc.tool_name,
+                        parameters: tc.parameters ?? {},
+                    });
+                }
+            }
+        }
+        return {
+            id: generateId(),
+            role: 'tool_call',
+            content: raw.content,
+            timestamp,
+            toolCalls,
+        };
+    }
+    if (type === 'tool_result') {
+        return {
+            id: generateId(),
+            role: 'tool_result',
+            content: raw.content,
+            timestamp,
+            toolResult: {
+                toolName: raw.metadata?.tool_name ?? 'unknown',
+                success: raw.metadata?.success ?? false,
+            },
+        };
+    }
+    // Regular text message (user or assistant)
+    const message = {
+        id: generateId(),
+        role: raw.role === 'user' ? 'user' : 'assistant',
+        content: raw.content,
+        timestamp,
+    };
+    // 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) => ({
+            id: `tc_${index}_${i}_${tc.tool_name}`,
+            name: tc.tool_name,
+            parameters: tc.parameters ?? {},
+        }));
+    }
+    return message;
+}
+/**
+ * Normalize a full conversation array.
+ */
+export function normalizeConversation(raw) {
+    return raw.map(normalizeMessage);
+}
+/**
+ * Normalize a raw session into a ChatSession.
+ */
+export function normalizeSession(raw) {
+    return {
+        id: raw.session_id,
+        title: raw.title ?? raw.first_message ?? undefined,
+        createdAt: raw.created_at,
+        updatedAt: raw.updated_at,
+        messageCount: raw.message_count,
+    };
+}

package/dist/types/adapter.d.ts

@@ -0,0 +1,151 @@
+/**
+ * The adapter contract.
+ *
+ * This is the main abstraction boundary. The shared chat UI calls
+ * adapter methods — it never knows about REST endpoints, auth tokens,
+ * WebSocket connections, or billing logic.
+ *
+ * Adapters declare their capabilities so the UI can conditionally
+ * render features like session switching or tool display.
+ */
+import type { ChatMessage } from './message.ts';
+import type { ChatSession, ChatInitialState } from './session.ts';
+/**
+ * Capability flags. The UI uses these to conditionally render features.
+ */
+export interface ChatCapabilities {
+    /** Adapter supports multiple named sessions. */
+    sessions: boolean;
+    /** Adapter can load historical messages for a session. */
+    history: boolean;
+    /** Adapter supports real-time streaming of responses. */
+    streaming: boolean;
+    /** Adapter exposes tool call/result messages. */
+    tools: boolean;
+    /** Adapter surfaces availability states (login, provisioning, etc.). */
+    availabilityStates: boolean;
+}
+/**
+ * Input to the sendMessage method.
+ */
+export interface SendMessageInput {
+    /** The user's message text. */
+    content: string;
+    /** Session to send to (undefined = create new or use default). */
+    sessionId?: string;
+}
+/**
+ * Result from a sendMessage call.
+ *
+ * The response can include multiple messages (e.g. tool calls + final answer).
+ * If `completed` is false, the UI should call `continueResponse` to get more.
+ */
+export interface SendMessageResult {
+    /** The session this message belongs to (may be newly created). */
+    sessionId: string;
+    /** New messages to append to the conversation. */
+    messages: ChatMessage[];
+    /** Whether the response is fully complete. */
+    completed: boolean;
+}
+/**
+ * Result from a continueResponse call.
+ */
+export interface ContinueResult {
+    /** New messages from this turn. */
+    messages: ChatMessage[];
+    /** Whether the response is now fully complete. */
+    completed: boolean;
+}
+/**
+ * Callback for streaming chunks.
+ */
+export interface StreamChunk {
+    /** Partial content delta. */
+    content: string;
+    /** Whether this is the final chunk. */
+    done: boolean;
+}
+/**
+ * The adapter contract.
+ *
+ * Only `sendMessage` and `capabilities` are required. Everything else
+ * is optional — the UI degrades gracefully based on capabilities.
+ *
+ * @example
+ * ```ts
+ * const adapter: ChatAdapter = {
+ *   capabilities: {
+ *     sessions: false,
+ *     history: false,
+ *     streaming: false,
+ *     tools: false,
+ *     availabilityStates: false,
+ *   },
+ *   async sendMessage(input) {
+ *     const res = await fetch('/api/chat', {
+ *       method: 'POST',
+ *       body: JSON.stringify({ message: input.content }),
+ *     });
+ *     const data = await res.json();
+ *     return {
+ *       sessionId: 'default',
+ *       messages: [{ id: data.id, role: 'assistant', content: data.reply, timestamp: new Date().toISOString() }],
+ *       completed: true,
+ *     };
+ *   },
+ * };
+ * ```
+ */
+export interface ChatAdapter {
+    /** Declare what this adapter supports. */
+    capabilities: ChatCapabilities;
+    /**
+     * Load initial state on mount.
+     * Returns availability, optional active session, and messages.
+     * If not provided, the UI assumes `{ availability: { status: 'ready' } }`.
+     */
+    loadInitialState?(): Promise<ChatInitialState>;
+    /**
+     * Send a user message and get the response.
+     * This is the only required async method.
+     */
+    sendMessage(input: SendMessageInput): Promise<SendMessageResult>;
+    /**
+     * Continue a multi-turn response (tool calling, etc.).
+     * Called when `sendMessage` returns `completed: false`.
+     * If not provided, multi-turn is not supported.
+     */
+    continueResponse?(sessionId: string): Promise<ContinueResult>;
+    /**
+     * Subscribe to streaming response chunks.
+     * Called instead of polling when `capabilities.streaming` is true.
+     * Returns an unsubscribe function.
+     */
+    onStream?(sessionId: string, callback: (chunk: StreamChunk) => void): () => void;
+    /**
+     * List available sessions.
+     * Only called when `capabilities.sessions` is true.
+     */
+    listSessions?(limit?: number): Promise<ChatSession[]>;
+    /**
+     * Load messages for a specific session.
+     * Only called when `capabilities.history` is true.
+     */
+    loadMessages?(sessionId: string): Promise<ChatMessage[]>;
+    /**
+     * Create a new empty session.
+     * Only called when `capabilities.sessions` is true.
+     */
+    createSession?(): Promise<ChatSession>;
+    /**
+     * Delete a session.
+     * Only called when `capabilities.sessions` is true.
+     */
+    deleteSession?(sessionId: string): Promise<void>;
+    /**
+     * Clear all messages in a session (without deleting it).
+     */
+    clearSession?(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/types/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,kBAAkB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,mCAAmC;IACnC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,WAAW;IAC3B,0CAA0C;IAC1C,YAAY,EAAE,gBAAgB,CAAC;IAE/B;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE/C;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEjE;;;;OAIG;IACH,gBAAgB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE9D;;;;OAIG;IACH,QAAQ,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAEjF;;;OAGG;IACH,YAAY,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAEtD;;;OAGG;IACH,YAAY,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAEzD;;;OAGG;IACH,aAAa,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAEvC;;;OAGG;IACH,aAAa,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;OAEG;IACH,YAAY,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD"}

package/dist/types/adapter.js

@@ -0,0 +1,11 @@
+/**
+ * The adapter contract.
+ *
+ * This is the main abstraction boundary. The shared chat UI calls
+ * adapter methods — it never knows about REST endpoints, auth tokens,
+ * WebSocket connections, or billing logic.
+ *
+ * Adapters declare their capabilities so the UI can conditionally
+ * render features like session switching or tool display.
+ */
+export {};

package/dist/types/api.d.ts

@@ -0,0 +1,137 @@
+/**
+ * REST API contract types.
+ *
+ * These describe the expected shape of the chat REST endpoints.
+ * Any backend that wants to work with this package implements
+ * these same endpoints and response shapes.
+ */
+/**
+ * A raw message as stored/returned by the backend.
+ * The package normalizes these into ChatMessage before rendering.
+ */
+export interface RawMessage {
+    role: 'user' | 'assistant';
+    content: string;
+    metadata?: {
+        timestamp?: string;
+        type?: 'text' | 'tool_call' | 'tool_result';
+        tool_name?: string;
+        parameters?: Record<string, unknown>;
+        success?: boolean;
+        error?: string;
+        turn?: number;
+        tool_data?: Record<string, unknown>;
+    };
+    tool_calls?: Array<{
+        tool_name: string;
+        parameters: Record<string, unknown>;
+    }>;
+}
+/**
+ * POST /chat — Send a message.
+ */
+export interface SendRequest {
+    message: string;
+    session_id?: string;
+    agent_id?: number;
+}
+export interface SendResponse {
+    success: boolean;
+    data: {
+        session_id: string;
+        response: string;
+        tool_calls: Array<{
+            tool_name: string;
+            parameters: Record<string, unknown>;
+        }>;
+        conversation: RawMessage[];
+        metadata: SessionMetadata;
+        completed: boolean;
+        max_turns: number;
+        turn_number: number;
+        max_turns_reached: boolean;
+        warning?: string;
+    };
+}
+/**
+ * POST /chat/continue — Continue a multi-turn response.
+ */
+export interface ContinueRequest {
+    session_id: string;
+}
+export interface ContinueResponse {
+    success: boolean;
+    data: {
+        session_id: string;
+        new_messages: RawMessage[];
+        final_content: string;
+        tool_calls: Array<{
+            tool_name: string;
+            parameters: Record<string, unknown>;
+        }>;
+        completed: boolean;
+        turn_number: number;
+        max_turns: number;
+        max_turns_reached: boolean;
+    };
+}
+/**
+ * GET /chat/sessions — List sessions.
+ */
+export interface ListSessionsResponse {
+    success: boolean;
+    data: {
+        sessions: RawSession[];
+        total: number;
+        limit: number;
+        offset: number;
+    };
+}
+export interface RawSession {
+    session_id: string;
+    title: string | null;
+    context: string;
+    first_message: string | null;
+    message_count: number;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * GET /chat/{session_id} — Get a single session.
+ */
+export interface GetSessionResponse {
+    success: boolean;
+    data: {
+        session_id: string;
+        conversation: RawMessage[];
+        metadata: SessionMetadata;
+    };
+}
+/**
+ * DELETE /chat/{session_id} — Delete a session.
+ */
+export interface DeleteSessionResponse {
+    success: boolean;
+    data: {
+        session_id: string;
+        deleted: boolean;
+    };
+}
+/**
+ * Session metadata shape from the backend.
+ */
+export interface SessionMetadata {
+    status?: 'pending' | 'processing' | 'completed' | 'error';
+    started_at?: string;
+    last_activity?: string;
+    message_count?: number;
+    current_turn?: number;
+    has_pending_tools?: boolean;
+    token_usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+    error_message?: string;
+}
+//# sourceMappingURL=api.d.ts.map

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

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

package/dist/types/api.js

@@ -0,0 +1,8 @@
+/**
+ * REST API contract types.
+ *
+ * These describe the expected shape of the chat REST endpoints.
+ * Any backend that wants to work with this package implements
+ * these same endpoints and response shapes.
+ */
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export type { MessageRole, ToolCall, ToolResultMeta, 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';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/types/message.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Normalized message model for the chat package.
+ *
+ * This model is backend-agnostic. Adapters map their native message
+ * format into these types before the UI sees them.
+ */
+/**
+ * The role that produced a message.
+ *
+ * - `user` — sent by the human
+ * - `assistant` — sent by the AI / bot
+ * - `system` — system-level context (usually hidden from UI)
+ * - `tool_call` — the assistant requesting a tool execution
+ * - `tool_result` — the result of a tool execution
+ */
+export type MessageRole = 'user' | 'assistant' | 'system' | 'tool_call' | 'tool_result';
+/**
+ * A single tool call requested by the assistant.
+ */
+export interface ToolCall {
+    /** Unique ID for this tool call (used to pair with result). */
+    id: string;
+    /** Tool function name. */
+    name: string;
+    /** Arguments passed to the tool. */
+    parameters: Record<string, unknown>;
+}
+/**
+ * Metadata for a tool result message.
+ */
+export interface ToolResultMeta {
+    /** The tool that produced this result. */
+    toolName: string;
+    /** Whether the tool call succeeded. */
+    success: boolean;
+}
+/**
+ * A single message in a chat conversation.
+ */
+export interface ChatMessage {
+    /** Unique message ID. */
+    id: string;
+    /** Who produced this message. */
+    role: MessageRole;
+    /** Text content (may be markdown, HTML, or plain text depending on adapter). */
+    content: string;
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+    /** Tool calls requested by the assistant (only on assistant messages). */
+    toolCalls?: ToolCall[];
+    /** Tool result metadata (only on tool_result messages). */
+    toolResult?: ToolResultMeta;
+}
+/**
+ * Content format hint for how message content should be rendered.
+ *
+ * - `markdown` — render with a markdown renderer (default)
+ * - `html` — render as raw HTML (dangerouslySetInnerHTML)
+ * - `text` — render as plain text
+ */
+export type ContentFormat = 'markdown' | 'html' | 'text';
+//# sourceMappingURL=message.d.ts.map

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

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

package/dist/types/message.js

@@ -0,0 +1,7 @@
+/**
+ * Normalized message model for the chat package.
+ *
+ * This model is backend-agnostic. Adapters map their native message
+ * format into these types before the UI sees them.
+ */
+export {};

package/dist/types/session.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Chat session types.
+ *
+ * Sessions are optional — adapters that don't support sessions
+ * operate in single-conversation mode.
+ */
+import type { ChatMessage } from './message.ts';
+/**
+ * A chat session — a distinct conversation thread.
+ */
+export interface ChatSession {
+    /** Unique session identifier. */
+    id: string;
+    /** Human-readable title (may be auto-generated from first message). */
+    title?: string;
+    /** ISO 8601 timestamp of session creation. */
+    createdAt: string;
+    /** ISO 8601 timestamp of last activity. */
+    updatedAt: string;
+    /** Number of messages in the session (optional, for display). */
+    messageCount?: number;
+}
+/**
+ * Availability state of the chat service.
+ *
+ * Adapters surface this so the UI can render appropriate states
+ * without knowing the business logic behind them.
+ */
+export type ChatAvailability = {
+    status: 'ready';
+} | {
+    status: 'login-required';
+    loginUrl?: string;
+} | {
+    status: 'unavailable';
+    reason?: string;
+} | {
+    status: 'provisioning';
+    message?: string;
+} | {
+    status: 'upgrade-required';
+    upgradeUrl?: string;
+    message?: string;
+} | {
+    status: 'error';
+    message: string;
+};
+/**
+ * The initial state returned by an adapter on mount.
+ */
+export interface ChatInitialState {
+    /** Current availability of the chat service. */
+    availability: ChatAvailability;
+    /** Active session (if resuming). */
+    session?: ChatSession;
+    /** Messages for the active session (if resuming). */
+    messages?: ChatMessage[];
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACzB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,gDAAgD;IAChD,YAAY,EAAE,gBAAgB,CAAC;IAC/B,oCAAoC;IACpC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CACzB"}

package/dist/types/session.js

@@ -0,0 +1,7 @@
+/**
+ * Chat session types.
+ *
+ * Sessions are optional — adapters that don't support sessions
+ * operate in single-conversation mode.
+ */
+export {};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@extrachill/chat",
+  "version": "0.2.0",
+  "description": "Chat UI components with built-in REST API client. Speaks the standard chat message format natively.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./css": "./css/chat.css",
+    "./src": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./src/*": {
+      "types": "./src/*.tsx",
+      "default": "./src/*.tsx"
+    }
+  },
+  "files": [
+    "src",
+    "dist",
+    "css",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "chat",
+    "react",
+    "wordpress",
+    "gutenberg",
+    "ai",
+    "components"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Extra-Chill/chat.git"
+  },
+  "homepage": "https://github.com/Extra-Chill/chat",
+  "bugs": "https://github.com/Extra-Chill/chat/issues",
+  "license": "GPL-2.0-or-later",
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  }
+}