@kodaris/krubble-app-components 1.0.70 → 1.0.71

package/dist/chatbot.js

@@ -11,6 +11,7 @@ import { unsafeHTML } from 'lit/directives/unsafe-html.js';
 import { repeat } from 'lit/directives/repeat.js';
 import { marked } from 'marked';
 import { KRFilePreview } from '@kodaris/krubble-components';
+import { KRHttp } from '@kodaris/krubble-http';
 /** Image MIME types the chatbot accepts (matches what Bedrock can ingest). */
 const ACCEPTED_IMAGE_TYPES = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
 /**
@@ -33,7 +34,7 @@ const ACCEPTED_IMAGE_TYPES = ['image/jpeg', 'image/png', 'image/gif', 'image/web
  * ## Usage
  * ```html
  * <kr-chatbot
- *   title="AI Assistant"
+ *   label="AI Assistant"
  *   .send=${(params) => {
  *     return fetch('/api/ai/chat/stream', {
  *       method: 'POST',
@@ -76,16 +77,25 @@ let KRChatbot = class KRChatbot extends LitElement {
         /**
          * Callback function for sending messages. Receives the user's message and
          * current conversation history. Must return a Response with a streaming SSE body.
+         *
+         * Optional — when not set, the chatbot uses its built-in default that streams
+         * from the Kodaris Bedrock conversation endpoints. Set this to override.
          */
         this.send = null;
         /**
          * Callback function called when the user clears the conversation.
          * Must return a Promise — messages are only cleared if it resolves.
+         *
+         * Optional — when not set, the chatbot uses its built-in default that clears
+         * the Kodaris Bedrock conversation state. Set this to override.
          */
         this.clear = null;
         /**
          * Callback function called on init to load existing conversation messages.
          * Must return a Promise that resolves with an array of KRChatbotMessage.
+         *
+         * Optional — when not set, the chatbot uses its built-in default that loads
+         * existing messages from the Kodaris Bedrock conversation. Set this to override.
          */
         this.load = null;
         /**
@@ -94,13 +104,9 @@ let KRChatbot = class KRChatbot extends LitElement {
          */
         this.messages = [];
         /**
-         * Header title text.
+         * Header label text.
          */
-        this.title = 'Kat';
-        /**
-         * Header subtitle text (shown below title with a green status dot).
-         */
-        this.subtitle = '';
+        this.label = 'Kat';
         /**
          * Input placeholder text.
          */
@@ -115,13 +121,23 @@ let KRChatbot = class KRChatbot extends LitElement {
          * then driven via the `open()` / `close()` / `toggle()` methods.
          */
         this.hideToggle = false;
+        /**
+         * Layout mode.
+         * - `'floating'` (default): the chatbot is a fixed bottom-right widget with a
+         *   toggle button, and the panel can be dragged and resized. This is the
+         *   traditional chat-widget appearance.
+         * - `'inline'`: the chatbot drops its fixed positioning and fills its parent
+         *   container (100% width/height, no border radius/shadow, no toggle, no
+         *   drag/resize). The panel is always open. Use this to embed the chat as a
+         *   full page or panel region.
+         */
+        this.variant = 'floating';
         // --- @state (internal) ---
         this._inputValue = '';
         this._isStreaming = false;
-        this._statusText = '';
         this._error = '';
         /** Images staged in the composer, before the message is sent. */
-        this._pendingAttachments = [];
+        this._pendingInternalFiles = [];
         /** True while a file is being dragged over the panel (shows the drop overlay). */
         this._isDraggingFile = false;
         this._handleMouseMove = (e) => {
@@ -185,12 +201,27 @@ let KRChatbot = class KRChatbot extends LitElement {
     // --- Lifecycle ---
     connectedCallback() {
         super.connectedCallback();
-        if (this.load) {
-            this.load().then((messages) => {
-                if (messages && messages.length) {
-                    this.messages = messages;
-                }
-            }).catch(() => { });
+        // Default to loading existing messages from the Kodaris Bedrock conversation
+        // when the consumer hasn't provided their own `load`. The endpoint returns
+        // messages already in KRChatbotMessage shape ({ type, content, images }), so
+        // they pass straight through.
+        if (!this.load) {
+            this.load = () => KRHttp.fetch({
+                url: '/api/system/integration/aws/bedrock/getConversationMessages',
+            })
+                .then((r) => r.json())
+                .then((res) => res.data || []);
+        }
+        this.load().then((messages) => {
+            if (messages && messages.length) {
+                this.messages = messages;
+            }
+        }).catch(() => { });
+        // Inline mode fills its container and is always open — the floating widget's
+        // toggle/drag/resize state (including any persisted layout) doesn't apply.
+        if (this.variant === 'inline') {
+            this.opened = true;
+            return;
         }
         this._restoreState();
     }
@@ -203,10 +234,10 @@ let KRChatbot = class KRChatbot extends LitElement {
         document.removeEventListener('mousemove', this._handleMouseMove);
         document.removeEventListener('mouseup', this._handleMouseUp);
         // Release any object URLs still held by staged attachments.
-        this._pendingAttachments.forEach((p) => URL.revokeObjectURL(p.previewUrl));
+        this._pendingInternalFiles.forEach((p) => URL.revokeObjectURL(p.previewUrl));
     }
     updated(changed) {
-        if (changed.has('messages') || changed.has('_statusText')) {
+        if (changed.has('messages')) {
             if (!this._userHasScrolledUp && !this._isStreaming && this._messagesEl) {
                 requestAnimationFrame(() => {
                     if (this._messagesEl) {
@@ -280,6 +311,10 @@ let KRChatbot = class KRChatbot extends LitElement {
         }
     }
     _handleHeaderMouseDown(e) {
+        // Inline mode fills its parent — dragging the panel doesn't apply.
+        if (this.variant === 'inline') {
+            return;
+        }
         // Ignore clicks on buttons inside the header
         if (e.target.closest('button')) {
             return;
@@ -305,6 +340,10 @@ let KRChatbot = class KRChatbot extends LitElement {
         document.addEventListener('mouseup', this._handleMouseUp);
     }
     _handleResizeMouseDown(e) {
+        // Inline mode fills its parent — resizing the panel doesn't apply.
+        if (this.variant === 'inline') {
+            return;
+        }
         if (!this._panelEl) {
             return;
         }
@@ -497,54 +536,49 @@ let KRChatbot = class KRChatbot extends LitElement {
                 name: file.name,
                 previewUrl: URL.createObjectURL(file),
             };
-            this._pendingAttachments = [...this._pendingAttachments, pending];
+            this._pendingInternalFiles = [...this._pendingInternalFiles, pending];
         });
     }
     _removePending(localId) {
-        const target = this._pendingAttachments.find((p) => p.localId === localId);
+        const target = this._pendingInternalFiles.find((p) => p.localId === localId);
         if (target) {
             URL.revokeObjectURL(target.previewUrl);
         }
-        this._pendingAttachments = this._pendingAttachments.filter((p) => p.localId !== localId);
+        this._pendingInternalFiles = this._pendingInternalFiles.filter((p) => p.localId !== localId);
     }
     _clearPending() {
-        this._pendingAttachments.forEach((p) => URL.revokeObjectURL(p.previewUrl));
-        this._pendingAttachments = [];
+        this._pendingInternalFiles.forEach((p) => URL.revokeObjectURL(p.previewUrl));
+        this._pendingInternalFiles = [];
     }
-    /** Open the shared full-screen previewer for an attachment. */
-    _openAttachment(att) {
+    /** Open the shared full-screen previewer for a message image. */
+    _openImage(img) {
         KRFilePreview.open({
-            src: att.url,
-            name: att.name || 'image',
+            src: `/api/system/integration/aws/bedrock/conversationImage/${img.internalFileID}/view`,
+            name: img.niceName || 'image',
         });
     }
     /** Whether the send button is active: needs text or at least one image. */
     _canSend() {
-        return Boolean(this._inputValue.trim()) || this._pendingAttachments.length > 0;
+        return Boolean(this._inputValue.trim()) || this._pendingInternalFiles.length > 0;
     }
     _handleSubmit() {
-        if (!this.send || this._isStreaming) {
+        if (this._isStreaming) {
             return;
         }
         const messageText = this._inputValue.trim();
-        const pending = this._pendingAttachments;
+        const pending = this._pendingInternalFiles;
         // Allow sending an image with no text, but require at least one of them.
         if (!messageText && !pending.length) {
             return;
         }
-        // The raw files sent to the backend, and the display attachments for the
-        // sent message. The message reuses each preview object URL, so ownership of
-        // those URLs transfers to the message (we don't revoke them here).
-        const files = pending.map((p) => p.file);
-        const attachments = pending.map((p) => ({
-            url: p.previewUrl,
-            name: p.name,
-            mimeType: p.file.type,
-        }));
+        // The raw files sent to the backend. Sent images are shown once the
+        // conversation reloads and they come back as stored internal files; the
+        // just-sent message itself carries text only.
+        const internalFiles = pending.map((p) => p.file);
         const submitEvent = new CustomEvent('message-submit', {
             detail: {
                 message: messageText,
-                files,
+                internalFiles,
             },
             bubbles: true,
             composed: true,
@@ -555,30 +589,26 @@ let KRChatbot = class KRChatbot extends LitElement {
             return;
         }
         const userMessage = {
-            role: 'user',
+            type: 'user',
             content: messageText,
         };
-        if (attachments.length) {
-            userMessage.attachments = attachments;
-        }
         this.messages = [...this.messages, userMessage];
         this._inputValue = '';
         this._error = '';
         this._userHasScrolledUp = false;
-        // Clear the composer without revoking the object URLs — the sent message now
-        // owns them for display.
-        this._pendingAttachments = [];
+        // Clear the composer and release its preview object URLs.
+        this._pendingInternalFiles.forEach((p) => URL.revokeObjectURL(p.previewUrl));
+        this._pendingInternalFiles = [];
         // Reset textarea height
         if (this._inputEl) {
             this._inputEl.style.height = 'auto';
         }
         // Add empty assistant message to stream into
         this.messages = [...this.messages, {
-                role: 'assistant',
+                type: 'assistant',
                 content: '',
             }];
         this._isStreaming = true;
-        this._statusText = '';
         // Scroll user's message to the top (Gemini-style).
         // Set min-height on the assistant message = container height so there's enough
         // scroll room below the user message to push it to the top.
@@ -600,10 +630,34 @@ let KRChatbot = class KRChatbot extends LitElement {
                 this._messagesEl.scrollTop = userMsgEl.offsetTop - this._messagesEl.offsetTop - 24;
             }
         });
+        // Default to streaming from the Kodaris Bedrock conversation endpoints when
+        // the consumer hasn't provided their own `send`.
+        if (!this.send) {
+            this.send = (params) => {
+                // With images, post text + files as multipart; without, post plain JSON.
+                if (params.internalFiles.length) {
+                    const form = new FormData();
+                    form.append('userText', params.message);
+                    params.internalFiles.forEach((file) => form.append('images', file));
+                    return KRHttp.fetch({
+                        url: '/api/system/integration/aws/bedrock/stream/invokeModelForConversationWithImages',
+                        method: 'POST',
+                        headers: { Accept: 'text/event-stream' },
+                        body: form,
+                    });
+                }
+                return KRHttp.fetch({
+                    url: '/api/system/integration/aws/bedrock/stream/invokeModelForConversationWithState',
+                    method: 'POST',
+                    headers: { Accept: 'text/event-stream' },
+                    body: { userText: params.message },
+                });
+            };
+        }
         this.send({
             message: messageText,
             messages: this.messages.slice(0, -1),
-            files,
+            internalFiles,
         }).then((response) => {
             if (!response.ok) {
                 this._handleStreamError('Request failed: ' + response.status);
@@ -629,11 +683,15 @@ let KRChatbot = class KRChatbot extends LitElement {
             this._reader = null;
         }
         this._isStreaming = false;
-        this._statusText = '';
     }
     _handleClear() {
+        // Default to clearing the Kodaris Bedrock conversation state when the consumer
+        // hasn't provided their own `clear`.
         if (!this.clear) {
-            return;
+            this.clear = () => KRHttp.fetch({
+                url: '/api/system/integration/aws/bedrock/clearConversationWithState',
+                method: 'POST',
+            });
         }
         this.clear().then(() => {
             if (this._reader) {
@@ -642,7 +700,6 @@ let KRChatbot = class KRChatbot extends LitElement {
             }
             this.messages = [];
             this._isStreaming = false;
-            this._statusText = '';
             this._error = '';
             this._inputValue = '';
             this._userHasScrolledUp = false;
@@ -668,7 +725,6 @@ let KRChatbot = class KRChatbot extends LitElement {
         this._reader.read().then((result) => {
             if (result.done) {
                 this._isStreaming = false;
-                this._statusText = '';
                 this._reader = null;
                 return;
             }
@@ -701,15 +757,10 @@ let KRChatbot = class KRChatbot extends LitElement {
                         bubbles: true,
                         composed: true,
                     }));
-                    if (data.type === 'STATUS') {
-                        if (data.message) {
-                            this._statusText = String(data.message);
-                        }
-                    }
-                    else if (data.type === 'REASONING_PART') {
+                    if (data.type === 'REASONING_PART') {
                         if (data.message) {
                             const lastIndex = this.messages.length - 1;
-                            if (lastIndex >= 0 && this.messages[lastIndex].role === 'assistant') {
+                            if (lastIndex >= 0 && this.messages[lastIndex].type === 'assistant') {
                                 if (!this.messages[lastIndex].reasoning) {
                                     this.messages[lastIndex].reasoning = '';
                                 }
@@ -720,9 +771,8 @@ let KRChatbot = class KRChatbot extends LitElement {
                     }
                     else if (data.type === 'RESPONSE_PART') {
                         if (data.message) {
-                            this._statusText = '';
                             const lastIndex = this.messages.length - 1;
-                            if (lastIndex >= 0 && this.messages[lastIndex].role === 'assistant') {
+                            if (lastIndex >= 0 && this.messages[lastIndex].type === 'assistant') {
                                 this.messages[lastIndex].content += String(data.message);
                                 this.requestUpdate();
                             }
@@ -733,7 +783,6 @@ let KRChatbot = class KRChatbot extends LitElement {
                     }
                     if (data.finished) {
                         this._isStreaming = false;
-                        this._statusText = '';
                         this._reader = null;
                     }
                 }
@@ -747,7 +796,6 @@ let KRChatbot = class KRChatbot extends LitElement {
     }
     _handleStreamError(message) {
         this._isStreaming = false;
-        this._statusText = '';
         this._error = message;
         if (this._reader) {
             this._reader.cancel();
@@ -756,7 +804,7 @@ let KRChatbot = class KRChatbot extends LitElement {
         // Remove the empty assistant message if it has no content
         if (this.messages.length > 0) {
             const lastMessage = this.messages[this.messages.length - 1];
-            if (lastMessage.role === 'assistant' && !lastMessage.content) {
+            if (lastMessage.type === 'assistant' && !lastMessage.content) {
                 this.messages = this.messages.slice(0, -1);
             }
         }
@@ -764,7 +812,7 @@ let KRChatbot = class KRChatbot extends LitElement {
     // --- Render ---
     render() {
         return html `
-      ${this.hideToggle ? nothing : html `
+      ${(this.hideToggle || this.variant === 'inline') ? nothing : html `
         <button
           class=${classMap({
             'toggle': true,
@@ -815,53 +863,52 @@ let KRChatbot = class KRChatbot extends LitElement {
             <span>Drop images to attach</span>
           </div>
         ` : nothing}
-        <div
-          class="resize resize--n"
-          data-dir="n"
-          @mousedown=${this._handleResizeMouseDown}
-        ></div>
-        <div
-          class="resize resize--s"
-          data-dir="s"
-          @mousedown=${this._handleResizeMouseDown}
-        ></div>
-        <div
-          class="resize resize--w"
-          data-dir="w"
-          @mousedown=${this._handleResizeMouseDown}
-        ></div>
-        <div
-          class="resize resize--e"
-          data-dir="e"
-          @mousedown=${this._handleResizeMouseDown}
-        ></div>
-        <div
-          class="resize resize--nw"
-          data-dir="nw"
-          @mousedown=${this._handleResizeMouseDown}
-        ></div>
-        <div
-          class="resize resize--ne"
-          data-dir="ne"
-          @mousedown=${this._handleResizeMouseDown}
-        ></div>
-        <div
-          class="resize resize--sw"
-          data-dir="sw"
-          @mousedown=${this._handleResizeMouseDown}
-        ></div>
-        <div
-          class="resize resize--se"
-          data-dir="se"
-          @mousedown=${this._handleResizeMouseDown}
-        ></div>
+        ${this.variant === 'inline' ? nothing : html `
+          <div
+            class="resize resize--n"
+            data-dir="n"
+            @mousedown=${this._handleResizeMouseDown}
+          ></div>
+          <div
+            class="resize resize--s"
+            data-dir="s"
+            @mousedown=${this._handleResizeMouseDown}
+          ></div>
+          <div
+            class="resize resize--w"
+            data-dir="w"
+            @mousedown=${this._handleResizeMouseDown}
+          ></div>
+          <div
+            class="resize resize--e"
+            data-dir="e"
+            @mousedown=${this._handleResizeMouseDown}
+          ></div>
+          <div
+            class="resize resize--nw"
+            data-dir="nw"
+            @mousedown=${this._handleResizeMouseDown}
+          ></div>
+          <div
+            class="resize resize--ne"
+            data-dir="ne"
+            @mousedown=${this._handleResizeMouseDown}
+          ></div>
+          <div
+            class="resize resize--sw"
+            data-dir="sw"
+            @mousedown=${this._handleResizeMouseDown}
+          ></div>
+          <div
+            class="resize resize--se"
+            data-dir="se"
+            @mousedown=${this._handleResizeMouseDown}
+          ></div>
+        `}
         <div class="header" @mousedown=${this._handleHeaderMouseDown}>
           <div class="header-left">
             <div class="header-info">
-              <span class="header-title">${this.title}</span>
-              ${this.subtitle ? html `
-                <span class="header-subtitle">${this.subtitle}</span>
-              ` : nothing}
+              <span class="header-title">${this.label}</span>
             </div>
           </div>
           <div class="header-actions">
@@ -887,77 +934,84 @@ let KRChatbot = class KRChatbot extends LitElement {
                 </svg>
               </button>
             ` : nothing}
-            <button
-              class="header-action"
-              @click=${this._handleToggle}
-              title="Close"
-            >
-              <svg
-                xmlns="http://www.w3.org/2000/svg"
-                fill="none"
-                viewBox="0 0 24 24"
-                stroke-width="2"
-                stroke="currentColor"
-                class="header-action-icon"
+            ${this.variant === 'inline' ? nothing : html `
+              <button
+                class="header-action"
+                @click=${this._handleToggle}
+                title="Close"
               >
-                <path
-                  stroke-linecap="round"
-                  stroke-linejoin="round"
-                  d="M6 18 18 6M6 6l12 12"
-                />
-              </svg>
-            </button>
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  fill="none"
+                  viewBox="0 0 24 24"
+                  stroke-width="2"
+                  stroke="currentColor"
+                  class="header-action-icon"
+                >
+                  <path
+                    stroke-linecap="round"
+                    stroke-linejoin="round"
+                    d="M6 18 18 6M6 6l12 12"
+                  />
+                </svg>
+              </button>
+            `}
           </div>
         </div>
 
         <div class="messages" @scroll=${this._handleMessagesScroll}>
-          ${this.messages.length === 0 ? html `
-            <div class="empty">
-              <span class="empty-text">What can I help you with?</span>
-            </div>
-          ` : nothing}
-          ${this.messages.map((msg) => html `
-            <div class=${classMap({
+          <div class="messages-inner">
+            ${this.messages.length === 0 ? html `
+              <div class="empty">
+                <span class="empty-text">What can I help you with?</span>
+              </div>
+            ` : nothing}
+            ${this.messages.map((msg) => html `
+              <div class=${classMap({
             'message': true,
-            'message--user': msg.role === 'user',
-            'message--assistant': msg.role === 'assistant',
+            'message--user': msg.type === 'user',
+            'message--assistant': msg.type === 'assistant',
         })}>
-              ${msg.reasoning ? html `
-                <details class="reasoning">
-                  <summary>Thinking</summary>
-                  <div class="reasoning-content">${msg.reasoning}</div>
-                </details>
-              ` : nothing}
-              ${msg.attachments && msg.attachments.length ? html `
-                <div class="attachments">
-                  ${msg.attachments.map((att) => html `
-                    <button
-                      class="attachment"
-                      type="button"
-                      title=${att.name || 'View image'}
-                      @click=${() => this._openAttachment(att)}
-                    >
-                      <img src=${att.url} alt=${att.name || ''} />
-                    </button>
-                  `)}
-                </div>
-              ` : nothing}
-              ${msg.content ? html `
-                <div class="message-content">
-                  ${msg.role === 'user'
+                ${msg.reasoning ? html `
+                  <details class="reasoning">
+                    <summary>Thinking</summary>
+                    <div class="reasoning-content">${msg.reasoning}</div>
+                  </details>
+                ` : nothing}
+                ${msg.internalFiles && msg.internalFiles.length ? html `
+                  <div class="attachments">
+                    ${msg.internalFiles.map((img) => html `
+                      <button
+                        class="attachment"
+                        type="button"
+                        title=${img.niceName || 'View image'}
+                        @click=${() => this._openImage(img)}
+                      >
+                        <img
+                          src="/api/system/integration/aws/bedrock/conversationImage/${img.internalFileID}/view"
+                          alt=${img.niceName || ''}
+                        />
+                      </button>
+                    `)}
+                  </div>
+                ` : nothing}
+                ${msg.content ? html `
+                  <div class="message-content">
+                    ${msg.type === 'user'
             ? msg.content
             : unsafeHTML(marked.parse(msg.content, { breaks: true }))}
-                </div>
-              ` : nothing}
-              ${msg.role === 'assistant' && this._isStreaming && msg === this.messages[this.messages.length - 1] ? html `
-                <div class="typing">
-                  <span></span>
-                  <span></span>
-                  <span></span>
-                </div>
-              ` : nothing}
-            </div>
-          `)}
+                  </div>
+                ` : nothing}
+                ${msg.type === 'assistant' && this._isStreaming && msg === this.messages[this.messages.length - 1] ? html `
+                  <div class="typing">
+                    <span></span>
+                    <span></span>
+                    <span></span>
+                  </div>
+                ` : nothing}
+              </div>
+            `)}
+          </div>
         </div>
 
         ${this._error ? html `
@@ -983,9 +1037,9 @@ let KRChatbot = class KRChatbot extends LitElement {
         ` : nothing}
 
         <div class="footer">
-          ${this._pendingAttachments.length ? html `
+          ${this._pendingInternalFiles.length ? html `
             <div class="composer-attachments">
-              ${repeat(this._pendingAttachments, (p) => p.localId, (p) => html `
+              ${repeat(this._pendingInternalFiles, (p) => p.localId, (p) => html `
                 <div class="chip">
                   <img src=${p.previewUrl} alt=${p.name} />
                   <button
@@ -1174,6 +1228,28 @@ KRChatbot.styles = css `
       display: flex;
     }
 
+    /* Inline mode: fill the parent container instead of floating bottom-right. */
+    :host([variant='inline']) {
+      position: static;
+      bottom: auto;
+      right: auto;
+      z-index: auto;
+      height: 100%;
+    }
+
+    :host([variant='inline']) .panel {
+      position: relative;
+      bottom: auto;
+      right: auto;
+      width: 100%;
+      height: 100%;
+      max-height: none;
+      border-radius: 0;
+      box-shadow: none;
+      border: none;
+      animation: none;
+    }
+
     @keyframes chatbot-panel-in {
       from {
         opacity: 0;
@@ -1204,7 +1280,7 @@ KRChatbot.styles = css `
       gap: 10px;
     }
 
-.header-info {
+    .header-info {
       display: flex;
       flex-direction: column;
     }
@@ -1214,22 +1290,6 @@ KRChatbot.styles = css `
       font-weight: 600;
     }
 
-    .header-subtitle {
-      color: rgba(255, 255, 255, 0.5);
-      font-size: 11px;
-      display: flex;
-      align-items: center;
-      gap: 4px;
-    }
-
-    .header-subtitle::before {
-      content: '';
-      width: 5px;
-      height: 5px;
-      background: var(--kr-chatbot-success);
-      border-radius: 50%;
-    }
-
     .header-actions {
       display: flex;
       align-items: center;
@@ -1261,17 +1321,29 @@ KRChatbot.styles = css `
     }
 
     /* Messages */
+    /* Full-width scroll container — keeps the scrollbar at the panel edge. */
     .messages {
       flex: 1;
       overflow-y: auto;
-      padding: 32px;
       display: flex;
       flex-direction: column;
-      gap: 24px;
       scroll-behavior: smooth;
       background: white;
     }
 
+    /* Centered, width-capped column that actually holds the messages. */
+    .messages-inner {
+      flex: 1;
+      display: flex;
+      flex-direction: column;
+      gap: 24px;
+      padding: 32px;
+      width: 100%;
+      max-width: 768px;
+      margin-left: auto;
+      margin-right: auto;
+    }
+
     .messages::-webkit-scrollbar {
       width: 4px;
     }
@@ -1295,7 +1367,7 @@ KRChatbot.styles = css `
       gap: 8px;
     }
 
-.empty-text {
+    .empty-text {
       font-size: 14px;
       color: rgb(0 0 0 / 80%);
     }
@@ -1407,7 +1479,7 @@ KRChatbot.styles = css `
       word-wrap: break-word;
     }
 
-.typing {
+    .typing {
       display: flex;
       gap: 4px;
       padding: 4px 0;
@@ -1475,6 +1547,15 @@ KRChatbot.styles = css `
       padding: 16px 16px 16px;
       flex-shrink: 0;
       background: white;
+      width: 100%;
+      max-width: 768px;
+      margin-left: auto;
+      margin-right: auto;
+    }
+
+    /* Inline mode: keep the composer clear of the bottom edge. */
+    :host([variant='inline']) .footer {
+      padding-bottom: 40px;
     }
 
     .input-wrapper {
@@ -1493,6 +1574,15 @@ KRChatbot.styles = css `
       box-shadow: 0 0 0 1px rgba(0, 0, 0, 0.04);
     }
 
+    /* Inline mode: keep the border and add a soft floating shadow (ChatGPT/Gemini style). */
+    :host([variant='inline']) .input-wrapper {
+      box-shadow: 0 2px 6px rgba(0, 0, 0, 0.06), 0 8px 24px rgba(0, 0, 0, 0.1);
+    }
+
+    :host([variant='inline']) .input-wrapper:focus-within {
+      box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08), 0 12px 32px rgba(0, 0, 0, 0.14);
+    }
+
     .input-plus {
       width: 34px;
       height: 34px;
@@ -1600,6 +1690,12 @@ KRChatbot.styles = css `
       cursor: grabbing;
     }
 
+    /* Inline mode isn't draggable — don't show the grab/hand cursor. */
+    :host([variant='inline']) .header,
+    :host([variant='inline']) .header:active {
+      cursor: default;
+    }
+
     /* Drag / Resize states */
     .panel--dragging,
     .panel--resizing {
@@ -1751,10 +1847,7 @@ __decorate([
 ], KRChatbot.prototype, "messages", void 0);
 __decorate([
     property({ type: String })
-], KRChatbot.prototype, "title", void 0);
-__decorate([
-    property({ type: String })
-], KRChatbot.prototype, "subtitle", void 0);
+], KRChatbot.prototype, "label", void 0);
 __decorate([
     property({ type: String })
 ], KRChatbot.prototype, "placeholder", void 0);
@@ -1771,21 +1864,24 @@ __decorate([
         reflect: true
     })
 ], KRChatbot.prototype, "hideToggle", void 0);
+__decorate([
+    property({
+        type: String,
+        reflect: true
+    })
+], KRChatbot.prototype, "variant", void 0);
 __decorate([
     state()
 ], KRChatbot.prototype, "_inputValue", void 0);
 __decorate([
     state()
 ], KRChatbot.prototype, "_isStreaming", void 0);
-__decorate([
-    state()
-], KRChatbot.prototype, "_statusText", void 0);
 __decorate([
     state()
 ], KRChatbot.prototype, "_error", void 0);
 __decorate([
     state()
-], KRChatbot.prototype, "_pendingAttachments", void 0);
+], KRChatbot.prototype, "_pendingInternalFiles", void 0);
 __decorate([
     state()
 ], KRChatbot.prototype, "_isDraggingFile", void 0);