@kodaris/krubble-app-components 1.0.61 → 1.0.63

package/dist/chatbot.d.ts

@@ -0,0 +1,158 @@
+import { LitElement } from 'lit';
+/**
+ * Chat message interface
+ */
+export interface KRChatbotMessage {
+    role: 'user' | 'assistant';
+    content: string;
+    reasoning?: string;
+}
+/**
+ * Frontend action dispatched by the AI via the SSE stream.
+ * The backend passes through tool calls from the AI model as ACTION events.
+ *
+ * Each action type has a specific `data` shape:
+ * - `RELOAD` — no data needed
+ * - `NAVIGATE` — `{ url: string }`
+ * - `UPDATE_HTML` — `{ selector: string, html: string }`
+ * - `OPEN_TAB` — `{ url: string }`
+ * - `SCROLL_TO` — `{ selector: string }`
+ */
+export interface KRChatbotAction {
+    action: 'RELOAD' | 'NAVIGATE' | 'UPDATE_HTML' | 'OPEN_TAB' | 'SCROLL_TO';
+    data?: Record<string, string>;
+}
+/**
+ * Callback function type for sending messages.
+ * Receives the user's message text and the current conversation history.
+ * Must return a Response with a streaming body (SSE format).
+ */
+export type KRChatbotSend = (params: {
+    message: string;
+    messages: KRChatbotMessage[];
+}) => Promise<Response>;
+/**
+ * AI chatbot component with SSE streaming and native browser action execution.
+ *
+ * Accepts a `send` callback that returns a streaming Response (SSE format).
+ * Parses the stream for text tokens, status updates, errors, and frontend actions.
+ * When an ACTION event arrives, dispatches a cancelable `action` custom event.
+ * If not prevented, executes the native browser action (reload, navigate, etc.).
+ *
+ * ## SSE Stream Format
+ * The component expects `data:` lines with JSON payloads containing a `type` field:
+ * - `STATUS` — `{ type: "STATUS", message: "Thinking..." }`
+ * - `RESPONSE_PART` — `{ type: "RESPONSE_PART", message: "token text" }`
+ * - `ACTION` — `{ type: "ACTION", action: "RELOAD" }` (see KRChatbotAction)
+ * - `ERROR` — `{ type: "ERROR", message: "Something went wrong" }`
+ * - `HEARTBEAT` — `{ type: "HEARTBEAT" }` (ignored)
+ *
+ * The final event should include `finished: true` to signal stream completion.
+ *
+ * ## Usage
+ * ```html
+ * <kr-chatbot
+ *   title="AI Assistant"
+ *   .send=${(params) => {
+ *     return fetch('/api/ai/chat/stream', {
+ *       method: 'POST',
+ *       headers: { 'Content-Type': 'application/json', 'Accept': 'text/event-stream' },
+ *       credentials: 'include',
+ *       body: JSON.stringify({ userText: params.message })
+ *     });
+ *   }}
+ * ></kr-chatbot>
+ * ```
+ *
+ * @slot - Optional slot content displayed above the messages area
+ *
+ * @fires message-submit - When the user sends a message. Cancelable. Detail: `{ message: string }`
+ * @fires action - When the AI requests a frontend action. Cancelable. Detail: `{ action: KRChatbotAction }`
+ */
+export declare class KRChatbot extends LitElement {
+    static styles: import("lit").CSSResult;
+    private _reader;
+    private _decoder;
+    private _buffer;
+    private _userHasScrolledUp;
+    private _isDragging;
+    private _isResizing;
+    private _resizeDir;
+    private _dragStartX;
+    private _dragStartY;
+    private _dragStartLeft;
+    private _dragStartTop;
+    private _resizeStartW;
+    private _resizeStartH;
+    /**
+     * Callback function for sending messages. Receives the user's message and
+     * current conversation history. Must return a Response with a streaming SSE body.
+     */
+    send: KRChatbotSend | null;
+    /**
+     * Callback function called when the user clears the conversation.
+     * Must return a Promise — messages are only cleared if it resolves.
+     */
+    clear: (() => Promise<unknown>) | null;
+    /**
+     * Conversation messages. Can be set externally for initial messages.
+     * Updated internally as the conversation progresses.
+     */
+    messages: KRChatbotMessage[];
+    /**
+     * Header title text.
+     */
+    title: string;
+    /**
+     * Header subtitle text (shown below title with a green status dot).
+     */
+    subtitle: string;
+    /**
+     * Input placeholder text.
+     */
+    placeholder: string;
+    /**
+     * Whether the chat panel is open. Only relevant in floating mode.
+     */
+    opened: boolean;
+    private _inputValue;
+    private _isStreaming;
+    private _statusText;
+    private _error;
+    private _panelEl;
+    private _messagesEl;
+    private _inputEl;
+    disconnectedCallback(): void;
+    updated(changed: Map<string, unknown>): void;
+    /**
+     * Stops the current stream without clearing the conversation.
+     */
+    stop(): void;
+    private _handleHeaderMouseDown;
+    private _handleResizeMouseDown;
+    private _handleMouseMove;
+    private _handleMouseUp;
+    private _handleToggle;
+    private _handleInputChange;
+    private _handleKeyDown;
+    private _handleSubmit;
+    private _handleStop;
+    private _handleClear;
+    private _handleMessagesScroll;
+    private _handleErrorDismiss;
+    private _readStreamChunk;
+    private _handleStreamError;
+    /**
+     * Lightweight text formatting for assistant messages.
+     * Handles code blocks, inline code, bold, and line breaks.
+     * Escapes HTML entities first to prevent XSS.
+     */
+    private _formatAssistantContent;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'kr-chatbot': KRChatbot;
+    }
+}
+//# sourceMappingURL=chatbot.d.ts.map

package/dist/chatbot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.d.ts","sourceRoot":"","sources":["../src/chatbot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,KAAK,CAAC;AAKrD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,CAAC;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBACa,SAAU,SAAQ,UAAU;IACvC,OAAgB,MAAM,0BAskBpB;IAIF,OAAO,CAAC,OAAO,CAAwD;IAEvE,OAAO,CAAC,QAAQ,CAAqB;IAErC,OAAO,CAAC,OAAO,CAAM;IAErB,OAAO,CAAC,kBAAkB,CAAS;IAEnC,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,UAAU,CAAM;IAExB,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,cAAc,CAAK;IAE3B,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,aAAa,CAAK;IAK1B;;;OAGG;IAEH,IAAI,EAAE,aAAa,GAAG,IAAI,CAAQ;IAElC;;;OAGG;IAEH,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAQ;IAE9C;;;OAGG;IAEH,QAAQ,EAAE,gBAAgB,EAAE,CAAM;IAElC;;OAEG;IAEH,KAAK,SAAkB;IAEvB;;OAEG;IAEH,QAAQ,SAAM;IAEd;;OAEG;IAEH,WAAW,SAAuB;IAElC;;OAEG;IAEH,MAAM,UAAS;IAKf,OAAO,CAAC,WAAW,CAAM;IAGzB,OAAO,CAAC,YAAY,CAAS;IAG7B,OAAO,CAAC,WAAW,CAAM;IAGzB,OAAO,CAAC,MAAM,CAAM;IAKpB,OAAO,CAAC,QAAQ,CAAe;IAG/B,OAAO,CAAC,WAAW,CAAe;IAGlC,OAAO,CAAC,QAAQ,CAAuB;IAI9B,oBAAoB;IAUpB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAsB9C;;OAEG;IACH,IAAI;IAMJ,OAAO,CAAC,sBAAsB;IA8B9B,OAAO,CAAC,sBAAsB;IA8B9B,OAAO,CAAC,gBAAgB,CAsDvB;IAED,OAAO,CAAC,cAAc,CAWrB;IAED,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAkErB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,gBAAgB;IA2HxB,OAAO,CAAC,kBAAkB;IAoB1B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAyCtB,MAAM;CAgJhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,SAAS,CAAC;KACzB;CACF"}