@syntrologie/adapt-chatbot 0.0.0-semantically-released → 2.0.1

package/dist/ChatAssistant.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Adaptive Chatbot - ChatAssistant Component
+ *
+ * Main React component for the AI chat assistant widget.
+ * Renders a message list with auto-scroll, loading indicator, and input form.
+ */
+import type { ChatbotWidgetRuntime, ChatbotConfig } from './types';
+export interface ChatAssistantProps {
+    config: ChatbotConfig;
+    runtime: ChatbotWidgetRuntime;
+    tileId: string;
+}
+export declare function ChatAssistant({ config, runtime, tileId }: ChatAssistantProps): import("react/jsx-runtime").JSX.Element;
+export declare const ChatAssistantMountableWidget: {
+    mount(container: HTMLElement, mountConfig?: Record<string, unknown>): () => void;
+};
+export default ChatAssistant;
+//# sourceMappingURL=ChatAssistant.d.ts.map

package/dist/ChatAssistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatAssistant.d.ts","sourceRoot":"","sources":["../src/ChatAssistant.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAe,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA8GhF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,kBAAkB,2CAwE5E;AAMD,eAAO,MAAM,4BAA4B;qBACtB,WAAW,gBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CA4CpE,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/ChatAssistant.js

@@ -0,0 +1,175 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Adaptive Chatbot - ChatAssistant Component
+ *
+ * Main React component for the AI chat assistant widget.
+ * Renders a message list with auto-scroll, loading indicator, and input form.
+ */
+import React, { useRef, useEffect } from 'react';
+import { createRoot } from 'react-dom/client';
+import { useChat } from './useChat';
+// ============================================================================
+// Styles
+// ============================================================================
+const styles = {
+    container: {
+        display: 'flex',
+        flexDirection: 'column',
+        height: '100%',
+        fontFamily: 'system-ui, -apple-system, sans-serif',
+        fontSize: '14px',
+    },
+    messageList: {
+        flex: 1,
+        overflowY: 'auto',
+        padding: '12px',
+        display: 'flex',
+        flexDirection: 'column',
+        gap: '8px',
+    },
+    messageBubble: {
+        maxWidth: '85%',
+        padding: '8px 12px',
+        borderRadius: '12px',
+        lineHeight: 1.5,
+        wordBreak: 'break-word',
+    },
+    userMessage: {
+        alignSelf: 'flex-end',
+        backgroundColor: '#6366f1',
+        color: '#ffffff',
+        borderBottomRightRadius: '4px',
+    },
+    assistantMessage: {
+        alignSelf: 'flex-start',
+        backgroundColor: 'rgba(255, 255, 255, 0.08)',
+        color: '#e2e8f0',
+        borderBottomLeftRadius: '4px',
+    },
+    loadingDots: {
+        alignSelf: 'flex-start',
+        padding: '8px 16px',
+        backgroundColor: 'rgba(255, 255, 255, 0.05)',
+        borderRadius: '12px',
+        color: '#94a3b8',
+        fontSize: '13px',
+    },
+    errorBanner: {
+        padding: '8px 12px',
+        backgroundColor: 'rgba(239, 68, 68, 0.1)',
+        color: '#ef4444',
+        fontSize: '13px',
+        borderRadius: '8px',
+        margin: '0 12px',
+    },
+    inputForm: {
+        display: 'flex',
+        gap: '8px',
+        padding: '12px',
+        borderTop: '1px solid rgba(255, 255, 255, 0.06)',
+    },
+    input: {
+        flex: 1,
+        padding: '8px 12px',
+        borderRadius: '8px',
+        border: '1px solid rgba(255, 255, 255, 0.1)',
+        backgroundColor: 'rgba(0, 0, 0, 0.2)',
+        color: '#f1f5f9',
+        fontSize: '14px',
+        outline: 'none',
+        fontFamily: 'inherit',
+    },
+    sendButton: {
+        padding: '8px 16px',
+        borderRadius: '8px',
+        border: 'none',
+        backgroundColor: '#6366f1',
+        color: '#ffffff',
+        fontWeight: 600,
+        fontSize: '13px',
+        cursor: 'pointer',
+        whiteSpace: 'nowrap',
+    },
+    sendButtonDisabled: {
+        opacity: 0.5,
+        cursor: 'not-allowed',
+    },
+};
+// ============================================================================
+// MessageBubble Component
+// ============================================================================
+function MessageBubble({ message }) {
+    const isUser = message.role === 'user';
+    const bubbleStyle = {
+        ...styles.messageBubble,
+        ...(isUser ? styles.userMessage : styles.assistantMessage),
+    };
+    return _jsx("div", { style: bubbleStyle, children: message.text });
+}
+export function ChatAssistant({ config, runtime, tileId }) {
+    const { messages, isLoading, error, sendMessage, clearMessages: _clearMessages, } = useChat({
+        backendUrl: config.backendUrl,
+        tileId,
+        runtime,
+        greeting: config.greeting,
+        maxHistory: config.maxHistory,
+        mlflowRunId: config.mlflowRunId,
+    });
+    const messageListRef = useRef(null);
+    const inputRef = useRef(null);
+    // Auto-scroll to bottom on new messages
+    useEffect(() => {
+        if (messageListRef.current) {
+            messageListRef.current.scrollTop = messageListRef.current.scrollHeight;
+        }
+    }, [messages, isLoading]);
+    const handleSubmit = (e) => {
+        e.preventDefault();
+        const input = inputRef.current;
+        if (!input || !input.value.trim() || isLoading)
+            return;
+        const text = input.value;
+        input.value = '';
+        sendMessage(text);
+    };
+    return (_jsxs("div", { style: styles.container, "data-testid": "chat-assistant", children: [_jsxs("div", { ref: messageListRef, style: styles.messageList, children: [messages.map((msg) => (_jsx(MessageBubble, { message: msg }, msg.id))), isLoading && _jsx("div", { style: styles.loadingDots, children: "Thinking..." })] }), error && _jsx("div", { style: styles.errorBanner, children: error }), _jsxs("form", { onSubmit: handleSubmit, style: styles.inputForm, children: [_jsx("input", { ref: inputRef, style: styles.input, placeholder: "Ask anything...", disabled: isLoading, "data-testid": "chat-input" }), _jsx("button", { type: "submit", disabled: isLoading, style: {
+                            ...styles.sendButton,
+                            ...(isLoading ? styles.sendButtonDisabled : {}),
+                        }, "data-testid": "chat-send", children: "Send" })] })] }));
+}
+// ============================================================================
+// Mountable Widget Interface
+// ============================================================================
+export const ChatAssistantMountableWidget = {
+    mount(container, mountConfig) {
+        const { config, runtime, tileId = 'chatbot-widget', } = (mountConfig || {});
+        // React rendering when config + runtime + ReactDOM are available
+        if (config && runtime && typeof createRoot === 'function') {
+            const root = createRoot(container);
+            root.render(React.createElement(ChatAssistant, {
+                config,
+                runtime,
+                tileId,
+            }));
+            return () => { root.unmount(); };
+        }
+        if (!config || !runtime) {
+            container.innerHTML =
+                '<div style="padding: 16px; color: #94a3b8;">Chat widget requires config and runtime.</div>';
+            return () => {
+                container.innerHTML = '';
+            };
+        }
+        // HTML fallback
+        container.innerHTML = `
+      <div style="padding: 16px; font-family: system-ui; color: #e2e8f0;">
+        <p style="margin: 0 0 8px; color: #94a3b8;">${config.greeting || 'Hi! How can I help?'}</p>
+        <p style="margin: 0; font-size: 12px; color: #64748b;">Chat widget mounted. Awaiting React renderer.</p>
+      </div>
+    `;
+        return () => {
+            container.innerHTML = '';
+        };
+    },
+};
+export default ChatAssistant;

package/dist/actionParser.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Adaptive Chatbot - Action Parser
+ *
+ * Extracts JSON action blocks from LLM markdown responses.
+ * Actions are identified by having a `kind` field in a ```json code fence.
+ */
+import type { ParsedResponse } from './types';
+/**
+ * Parse an LLM response, extracting action blocks from JSON code fences.
+ *
+ * - Blocks with a `kind` field are treated as actions and removed from display text.
+ * - Blocks without `kind` or with invalid JSON are left in the display text.
+ */
+export declare function parseActions(input: string): ParsedResponse;
+//# sourceMappingURL=actionParser.d.ts.map

package/dist/actionParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionParser.d.ts","sourceRoot":"","sources":["../src/actionParser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,SAAS,CAAC;AAI3D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CA8C1D"}

package/dist/actionParser.js

@@ -0,0 +1,52 @@
+/**
+ * Adaptive Chatbot - Action Parser
+ *
+ * Extracts JSON action blocks from LLM markdown responses.
+ * Actions are identified by having a `kind` field in a ```json code fence.
+ */
+const JSON_FENCE_RE = /```json\s*\n([\s\S]*?)```/g;
+/**
+ * Parse an LLM response, extracting action blocks from JSON code fences.
+ *
+ * - Blocks with a `kind` field are treated as actions and removed from display text.
+ * - Blocks without `kind` or with invalid JSON are left in the display text.
+ */
+export function parseActions(input) {
+    const actions = [];
+    let displayText = input;
+    // Collect matches in reverse order so we can splice display text without index shifting
+    const matches = [];
+    let match;
+    // Reset regex state
+    JSON_FENCE_RE.lastIndex = 0;
+    while ((match = JSON_FENCE_RE.exec(input)) !== null) {
+        matches.push({
+            fullMatch: match[0],
+            json: match[1],
+            index: match.index,
+        });
+    }
+    // Process in reverse to preserve indices when removing from displayText
+    for (let i = matches.length - 1; i >= 0; i--) {
+        const { fullMatch, json } = matches[i];
+        let parsed;
+        try {
+            parsed = JSON.parse(json);
+        }
+        catch {
+            // Malformed JSON — leave in display text
+            continue;
+        }
+        if (typeof parsed === 'object' &&
+            parsed !== null &&
+            'kind' in parsed &&
+            typeof parsed.kind === 'string') {
+            actions.unshift(parsed);
+            // Remove the action block from display text
+            displayText = displayText.replace(fullMatch, '');
+        }
+    }
+    // Clean up extra blank lines left from removed blocks
+    displayText = displayText.replace(/\n{3,}/g, '\n\n').trim();
+    return { displayText, actions };
+}

package/dist/apiClient.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Adaptive Chatbot - API Client
+ *
+ * Auth-aware fetch client that reads Stytch JWT from cookies
+ * and workspace ID from localStorage.
+ */
+import type { ChatApiRequest, ChatApiResponse } from './types';
+export declare class AuthError extends Error {
+    constructor(message: string);
+}
+/**
+ * Read auth credentials from browser cookie and localStorage.
+ * Throws AuthError if credentials are missing.
+ */
+export declare function getAuthHeaders(): {
+    Authorization: string;
+    'X-Workspace-Id': string;
+};
+/**
+ * Send a chat message to the backend.
+ */
+export declare function sendMessage(url: string, request: ChatApiRequest): Promise<ChatApiResponse>;
+//# sourceMappingURL=apiClient.d.ts.map

package/dist/apiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../src/apiClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/D,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAepF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAoBhG"}

package/dist/apiClient.js

@@ -0,0 +1,51 @@
+/**
+ * Adaptive Chatbot - API Client
+ *
+ * Auth-aware fetch client that reads Stytch JWT from cookies
+ * and workspace ID from localStorage.
+ */
+export class AuthError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AuthError';
+    }
+}
+/**
+ * Read auth credentials from browser cookie and localStorage.
+ * Throws AuthError if credentials are missing.
+ */
+export function getAuthHeaders() {
+    const cookieMatch = document.cookie.match(/stytch_session_jwt=([^;]*)/);
+    if (!cookieMatch || !cookieMatch[1]) {
+        throw new AuthError('No authentication token found');
+    }
+    const workspaceId = localStorage.getItem('syntrologie_workspace_id');
+    if (!workspaceId) {
+        throw new AuthError('No workspace ID found');
+    }
+    return {
+        Authorization: `Bearer ${cookieMatch[1]}`,
+        'X-Workspace-Id': workspaceId,
+    };
+}
+/**
+ * Send a chat message to the backend.
+ */
+export async function sendMessage(url, request) {
+    const authHeaders = getAuthHeaders();
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...authHeaders,
+        },
+        body: JSON.stringify(request),
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new AuthError('Session expired or unauthorized');
+        }
+        throw new Error(`Chat request failed: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+}

package/dist/cdn.d.ts

@@ -0,0 +1,44 @@
+/**
+ * CDN Entry Point for Adaptive Chatbot
+ *
+ * This module is bundled for CDN delivery and self-registers with the global
+ * SynOS app registry when loaded dynamically via the AppLoader.
+ */
+import ChatbotEditor from './editor';
+/**
+ * App manifest for registry registration.
+ * Follows the AppManifest interface expected by AppLoader/AppRegistry.
+ */
+export declare const manifest: {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    runtime: {
+        actions: never[];
+        widgets: {
+            id: string;
+            component: {
+                mount(container: HTMLElement, mountConfig?: Record<string, unknown>): () => void;
+            };
+            metadata: {
+                name: string;
+                description: string;
+                icon: string;
+            };
+        }[];
+    };
+    editor: {
+        component: typeof ChatbotEditor;
+        panel: {
+            title: string;
+            icon: string;
+            description: string;
+        };
+    };
+    metadata: {
+        isBuiltIn: boolean;
+    };
+};
+export default manifest;
+//# sourceMappingURL=cdn.d.ts.map

package/dist/cdn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn.d.ts","sourceRoot":"","sources":["../src/cdn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,aAA8B,MAAM,UAAU,CAAC;AAGtD;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAapB,CAAC;AAaF,eAAe,QAAQ,CAAC"}

package/dist/cdn.js

@@ -0,0 +1,37 @@
+/**
+ * CDN Entry Point for Adaptive Chatbot
+ *
+ * This module is bundled for CDN delivery and self-registers with the global
+ * SynOS app registry when loaded dynamically via the AppLoader.
+ */
+import ChatbotEditor, { editorPanel } from './editor';
+import { runtime } from './runtime';
+/**
+ * App manifest for registry registration.
+ * Follows the AppManifest interface expected by AppLoader/AppRegistry.
+ */
+export const manifest = {
+    id: 'adaptive-chatbot',
+    version: runtime.version,
+    name: runtime.name,
+    description: runtime.description,
+    runtime: {
+        actions: [],
+        widgets: runtime.widgets,
+    },
+    editor: { component: ChatbotEditor, panel: editorPanel },
+    metadata: {
+        isBuiltIn: false,
+    },
+};
+/**
+ * Self-register with global registry if available.
+ * This happens when loaded via script tag (UMD).
+ */
+if (typeof window !== 'undefined') {
+    const registry = window.SynOS?.appRegistry;
+    if (registry && typeof registry.register === 'function') {
+        registry.register(manifest);
+    }
+}
+export default manifest;

package/dist/editor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Adaptive Chatbot - Editor Component
+ *
+ * Visual editor panel for configuring chatbot tile props.
+ */
+import type { EditorPanelProps } from './types';
+export declare function ChatbotEditor({ config, onChange, editor }: EditorPanelProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Editor panel configuration for the app registry.
+ */
+export declare const editorPanel: {
+    title: string;
+    icon: string;
+    description: string;
+};
+export default ChatbotEditor;
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,SAAS,CAAC;AAwH/D,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,gBAAgB,2CAkG3E;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;CAIvB,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/editor.js

@@ -0,0 +1,147 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Adaptive Chatbot - Editor Component
+ *
+ * Visual editor panel for configuring chatbot tile props.
+ */
+import { useEffect, useRef } from 'react';
+// ============================================================================
+// Editor Styles
+// ============================================================================
+const styles = {
+    container: {
+        display: 'flex',
+        flexDirection: 'column',
+        height: '100%',
+        fontFamily: 'system-ui, -apple-system, sans-serif',
+    },
+    header: {
+        padding: '16px',
+        borderBottom: '1px solid #334155',
+        display: 'flex',
+        alignItems: 'center',
+        gap: '12px',
+    },
+    backButton: {
+        padding: '6px 12px',
+        borderRadius: '6px',
+        border: 'none',
+        backgroundColor: 'rgba(255,255,255,0.05)',
+        color: '#94a3b8',
+        fontSize: '13px',
+        cursor: 'pointer',
+    },
+    title: {
+        margin: 0,
+        fontSize: '15px',
+        fontWeight: 600,
+        color: '#f8fafc',
+    },
+    subtitle: {
+        margin: '2px 0 0 0',
+        fontSize: '11px',
+        color: '#64748b',
+    },
+    content: {
+        flex: 1,
+        overflow: 'auto',
+        padding: '16px',
+    },
+    section: {
+        marginBottom: '24px',
+    },
+    sectionTitle: {
+        fontSize: '12px',
+        fontWeight: 600,
+        color: '#94a3b8',
+        textTransform: 'uppercase',
+        letterSpacing: '0.05em',
+        marginBottom: '12px',
+    },
+    inputGroup: {
+        marginBottom: '12px',
+    },
+    inputLabel: {
+        display: 'block',
+        fontSize: '11px',
+        color: '#94a3b8',
+        marginBottom: '4px',
+    },
+    input: {
+        width: '100%',
+        padding: '10px 12px',
+        borderRadius: '6px',
+        border: '1px solid rgba(255,255,255,0.1)',
+        backgroundColor: 'rgba(255,255,255,0.05)',
+        color: '#f8fafc',
+        fontSize: '13px',
+    },
+    textarea: {
+        width: '100%',
+        padding: '10px 12px',
+        borderRadius: '6px',
+        border: '1px solid rgba(255,255,255,0.1)',
+        backgroundColor: 'rgba(255,255,255,0.05)',
+        color: '#f8fafc',
+        fontSize: '13px',
+        minHeight: '60px',
+        resize: 'vertical',
+        fontFamily: 'inherit',
+    },
+    footer: {
+        padding: '12px 16px',
+        borderTop: '1px solid #334155',
+        display: 'flex',
+        gap: '8px',
+    },
+    saveButton: {
+        flex: 1,
+        padding: '10px',
+        borderRadius: '8px',
+        border: 'none',
+        background: 'rgba(59, 130, 246, 0.15)',
+        color: '#3b82f6',
+        fontSize: '13px',
+        fontWeight: 600,
+        cursor: 'pointer',
+    },
+    publishButton: {
+        flex: 1,
+        padding: '10px',
+        borderRadius: '8px',
+        border: 'none',
+        background: '#22c55e',
+        color: 'white',
+        fontSize: '13px',
+        fontWeight: 600,
+        cursor: 'pointer',
+    },
+};
+// ============================================================================
+// ChatbotEditor Component
+// ============================================================================
+export function ChatbotEditor({ config, onChange, editor }) {
+    const typedConfig = config;
+    // Consume initial navigation payload on mount (chatbot is form-based, no sub-items)
+    const initialConsumed = useRef(false);
+    useEffect(() => {
+        if (!initialConsumed.current && (editor.initialEditKey != null || editor.initialCreate)) {
+            initialConsumed.current = true;
+            editor.clearInitialState?.();
+        }
+    }, [editor]);
+    const handleChange = (field, value) => {
+        onChange({ ...config, [field]: value });
+        editor.setDirty(true);
+    };
+    return (_jsxs("div", { style: styles.container, children: [_jsxs("div", { style: styles.header, children: [_jsx("button", { onClick: () => editor.navigateHome(), style: styles.backButton, children: "\u2190 Back" }), _jsxs("div", { children: [_jsx("h2", { style: styles.title, children: "Chat Assistant" }), _jsx("p", { style: styles.subtitle, children: "Configure AI chat assistant" })] })] }), _jsxs("div", { style: styles.content, children: [_jsxs("div", { style: styles.section, children: [_jsx("div", { style: styles.sectionTitle, children: "API Configuration" }), _jsxs("div", { style: styles.inputGroup, children: [_jsx("label", { style: styles.inputLabel, children: "Backend URL" }), _jsx("input", { type: "text", value: typedConfig.backendUrl || '', onChange: (e) => handleChange('backendUrl', e.target.value), style: styles.input, placeholder: "/api/chat/message" })] }), _jsxs("div", { style: styles.inputGroup, children: [_jsx("label", { style: styles.inputLabel, children: "MLflow Run ID (optional)" }), _jsx("input", { type: "text", value: typedConfig.mlflowRunId || '', onChange: (e) => handleChange('mlflowRunId', e.target.value), style: styles.input, placeholder: "e.g., abc123" })] })] }), _jsxs("div", { style: styles.section, children: [_jsx("div", { style: styles.sectionTitle, children: "Chat Settings" }), _jsxs("div", { style: styles.inputGroup, children: [_jsx("label", { style: styles.inputLabel, children: "Greeting Message" }), _jsx("textarea", { value: typedConfig.greeting || '', onChange: (e) => handleChange('greeting', e.target.value), style: styles.textarea, placeholder: "Hi! How can I help?" })] }), _jsxs("div", { style: styles.inputGroup, children: [_jsx("label", { style: styles.inputLabel, children: "Max History (messages sent to backend)" }), _jsx("input", { type: "number", value: typedConfig.maxHistory || 20, onChange: (e) => handleChange('maxHistory', parseInt(e.target.value, 10)), style: styles.input, min: 1, max: 100 })] })] })] }), _jsxs("div", { style: styles.footer, children: [_jsx("button", { onClick: () => editor.save(), style: styles.saveButton, children: "Save Draft" }), _jsx("button", { onClick: () => editor.publish(), style: styles.publishButton, children: "Publish" })] })] }));
+}
+/**
+ * Editor panel configuration for the app registry.
+ */
+export const editorPanel = {
+    title: 'Chat Assistant',
+    icon: '💬',
+    description: 'AI chat assistant with action execution',
+};
+export default ChatbotEditor;

package/dist/runtime.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Adaptive Chatbot - Runtime Module
+ *
+ * Runtime manifest for the AI chat assistant adaptive.
+ * This is a widget-based adaptive with no action executors.
+ */
+export declare const runtime: {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    /** No action executors — chatbot uses existing action kinds via applyBatch */
+    executors: never[];
+    /** Widget definitions for the runtime's WidgetRegistry */
+    widgets: {
+        id: string;
+        component: {
+            mount(container: HTMLElement, mountConfig?: Record<string, unknown>): () => void;
+        };
+        metadata: {
+            name: string;
+            description: string;
+            icon: string;
+        };
+    }[];
+};
+export default runtime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,eAAO,MAAM,OAAO;;;;;IAMlB,8EAA8E;;IAG9E,0DAA0D;;;;;;;;;;;;CAY3D,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,31 @@
+/**
+ * Adaptive Chatbot - Runtime Module
+ *
+ * Runtime manifest for the AI chat assistant adaptive.
+ * This is a widget-based adaptive with no action executors.
+ */
+import { ChatAssistantMountableWidget } from './ChatAssistant';
+// ============================================================================
+// App Runtime Manifest
+// ============================================================================
+export const runtime = {
+    id: 'adaptive-chatbot',
+    version: '1.0.0',
+    name: 'Chat Assistant',
+    description: 'AI chat assistant with action execution capabilities',
+    /** No action executors — chatbot uses existing action kinds via applyBatch */
+    executors: [],
+    /** Widget definitions for the runtime's WidgetRegistry */
+    widgets: [
+        {
+            id: 'adaptive-chatbot:assistant',
+            component: ChatAssistantMountableWidget,
+            metadata: {
+                name: 'Chat Assistant',
+                description: 'AI-powered chat assistant that can execute DOM actions',
+                icon: '💬',
+            },
+        },
+    ],
+};
+export default runtime;

package/dist/schema.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Adaptive Chatbot - Config Schema
+ *
+ * Zod schema for validating chatbot widget configuration.
+ */
+import { z } from 'zod';
+export declare const configSchema: z.ZodObject<{
+    /** Backend URL for the chat API endpoint */
+    backendUrl: z.ZodString;
+    /** MLflow run ID for experiment tracking */
+    mlflowRunId: z.ZodOptional<z.ZodString>;
+    /** Greeting message shown when the chat opens */
+    greeting: z.ZodDefault<z.ZodString>;
+    /** Maximum number of history messages sent to the backend */
+    maxHistory: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    backendUrl: string;
+    greeting: string;
+    maxHistory: number;
+    mlflowRunId?: string | undefined;
+}, {
+    backendUrl: string;
+    greeting?: string | undefined;
+    maxHistory?: number | undefined;
+    mlflowRunId?: string | undefined;
+}>;
+export type ChatbotConfigSchema = z.infer<typeof configSchema>;
+export declare function validateChatbotConfig(data: unknown): z.SafeParseReturnType<{
+    backendUrl: string;
+    greeting?: string | undefined;
+    maxHistory?: number | undefined;
+    mlflowRunId?: string | undefined;
+}, {
+    backendUrl: string;
+    greeting: string;
+    maxHistory: number;
+    mlflowRunId?: string | undefined;
+}>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY;IACvB,4CAA4C;;IAE5C,4CAA4C;;IAE5C,iDAAiD;;IAEjD,6DAA6D;;;;;;;;;;;;EAE7D,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE/D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;GAElD"}

package/dist/schema.js

@@ -0,0 +1,19 @@
+/**
+ * Adaptive Chatbot - Config Schema
+ *
+ * Zod schema for validating chatbot widget configuration.
+ */
+import { z } from 'zod';
+export const configSchema = z.object({
+    /** Backend URL for the chat API endpoint */
+    backendUrl: z.string().min(1, 'Backend URL is required'),
+    /** MLflow run ID for experiment tracking */
+    mlflowRunId: z.string().optional(),
+    /** Greeting message shown when the chat opens */
+    greeting: z.string().default('Hi! How can I help?'),
+    /** Maximum number of history messages sent to the backend */
+    maxHistory: z.number().int().min(1).max(100).default(20),
+});
+export function validateChatbotConfig(data) {
+    return configSchema.safeParse(data);
+}

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Adaptive Chatbot - Types
+ *
+ * Type definitions for the AI chat assistant adaptive.
+ */
+export type MessageRole = 'user' | 'assistant';
+export interface ChatMessage {
+    id: string;
+    role: MessageRole;
+    text: string;
+    timestamp: number;
+}
+export interface ChatApiRequest {
+    message: string;
+    history: Array<{
+        role: MessageRole;
+        content: string;
+    }>;
+    mlflow_run_id?: string;
+    current_config?: Record<string, unknown>;
+}
+export interface ChatApiResponse {
+    response: string;
+    success: boolean;
+}
+export interface ActionBlock {
+    kind: string;
+    [key: string]: unknown;
+}
+export interface ParsedResponse {
+    displayText: string;
+    actions: ActionBlock[];
+}
+export interface ChatbotConfig {
+    backendUrl: string;
+    mlflowRunId?: string;
+    greeting?: string;
+    maxHistory?: number;
+}
+export interface ActionHandle {
+    id: string;
+    revert: () => Promise<void>;
+    isApplied: () => boolean;
+}
+export interface BatchActionHandle {
+    id: string;
+    handles: ActionHandle[];
+    revertAll: () => Promise<void>;
+    isApplied: () => boolean;
+}
+export interface ActionEngine {
+    apply: (action: unknown) => Promise<ActionHandle>;
+    applyBatch: (actions: unknown[]) => Promise<BatchActionHandle>;
+}
+export interface ChatbotWidgetRuntime {
+    actions: ActionEngine;
+    events: {
+        publish: (name: string, props?: Record<string, unknown>) => void;
+    };
+}
+export interface EditorPanelProps {
+    config: Record<string, unknown>;
+    onChange: (config: Record<string, unknown>) => void;
+    editor: {
+        setDirty: (dirty: boolean) => void;
+        navigateHome: () => Promise<boolean>;
+        save: () => Promise<void>;
+        publish: (captureScreenshot?: boolean) => Promise<void>;
+        /** Flat action index to open in edit mode (from accordion navigation). */
+        initialEditKey?: string;
+        /** Open the editor in create mode. */
+        initialCreate?: boolean;
+        /** Clear the initial navigation state (call after consuming). */
+        clearInitialState?: () => void;
+    };
+    platformClient?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Adaptive Chatbot - Types
+ *
+ * Type definitions for the AI chat assistant adaptive.
+ */
+export {};

package/dist/useChat.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Adaptive Chatbot - useChat Hook
+ *
+ * React hook managing chat message state, API communication,
+ * history management, and action execution via the runtime ActionEngine.
+ */
+import type { ChatMessage, ChatbotWidgetRuntime } from './types';
+export interface UseChatOptions {
+    backendUrl: string;
+    tileId: string;
+    runtime: ChatbotWidgetRuntime;
+    greeting?: string;
+    maxHistory?: number;
+    mlflowRunId?: string;
+    config?: Record<string, unknown>;
+}
+export interface UseChatReturn {
+    messages: ChatMessage[];
+    isLoading: boolean;
+    error: string | null;
+    sendMessage: (text: string) => Promise<void>;
+    clearMessages: () => void;
+}
+export declare function useChat(options: UseChatOptions): UseChatReturn;
+//# sourceMappingURL=useChat.d.ts.map

package/dist/useChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../src/useChat.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAqB,MAAM,SAAS,CAAC;AAEpF,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAOD,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CA4G9D"}

package/dist/useChat.js

@@ -0,0 +1,106 @@
+/**
+ * Adaptive Chatbot - useChat Hook
+ *
+ * React hook managing chat message state, API communication,
+ * history management, and action execution via the runtime ActionEngine.
+ */
+import { useState, useCallback, useRef } from 'react';
+import { parseActions } from './actionParser';
+import { sendMessage } from './apiClient';
+let nextId = 0;
+function generateId() {
+    return `msg-${Date.now()}-${++nextId}`;
+}
+export function useChat(options) {
+    const { backendUrl, tileId, runtime, greeting, maxHistory = 20, mlflowRunId, config } = options;
+    const [messages, setMessages] = useState(() => {
+        if (greeting) {
+            return [
+                {
+                    id: generateId(),
+                    role: 'assistant',
+                    text: greeting,
+                    timestamp: Date.now(),
+                },
+            ];
+        }
+        return [];
+    });
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const batchHandleRef = useRef(null);
+    const send = useCallback(async (text) => {
+        const trimmed = text.trim();
+        if (!trimmed)
+            return;
+        setError(null);
+        const userMessage = {
+            id: generateId(),
+            role: 'user',
+            text: trimmed,
+            timestamp: Date.now(),
+        };
+        setMessages((prev) => [...prev, userMessage]);
+        setIsLoading(true);
+        try {
+            // Build history from current messages + new user message
+            const currentMessages = [...messages, userMessage];
+            const historySlice = currentMessages.slice(-maxHistory).map((m) => ({
+                role: m.role,
+                content: m.text,
+            }));
+            const response = await sendMessage(backendUrl, {
+                message: trimmed,
+                history: historySlice,
+                mlflow_run_id: mlflowRunId,
+                current_config: config,
+            });
+            // Parse actions from the LLM response
+            const { displayText, actions } = parseActions(response.response);
+            const assistantMessage = {
+                id: generateId(),
+                role: 'assistant',
+                text: displayText,
+                timestamp: Date.now(),
+            };
+            setMessages((prev) => [...prev, assistantMessage]);
+            // Execute actions if present
+            if (actions.length > 0) {
+                // Revert previous batch
+                if (batchHandleRef.current?.isApplied()) {
+                    await batchHandleRef.current.revertAll();
+                }
+                batchHandleRef.current = await runtime.actions.applyBatch(actions);
+                runtime.events.publish('chatbot.actions_applied', {
+                    count: actions.length,
+                    kinds: actions.map((a) => a.kind),
+                    tileId,
+                });
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'An unexpected error occurred';
+            setError(message);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [backendUrl, messages, maxHistory, mlflowRunId, config, runtime, tileId]);
+    const clearMessages = useCallback(() => {
+        setMessages([]);
+        setError(null);
+        // Revert any active actions
+        if (batchHandleRef.current?.isApplied()) {
+            batchHandleRef.current.revertAll();
+            batchHandleRef.current = null;
+        }
+        sessionStorage.removeItem(`syntro:chatbot:history:${tileId}`);
+    }, [tileId]);
+    return {
+        messages,
+        isLoading,
+        error,
+        sendMessage: send,
+        clearMessages,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syntrologie/adapt-chatbot",
-  "version": "0.0.0-semantically-released",
+  "version": "2.0.1",
   "description": "Adaptive Chatbot - AI chat assistant widget with action execution",
   "license": "Proprietary",
   "private": false,
@@ -45,13 +45,13 @@
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.2",
-    "@types/react": "^18.0.0",
+    "@types/react": "^19.1.0",
     "@types/react-dom": "^19.2.3",
-    "jsdom": "^25.0.0",
+    "jsdom": "^25.0.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
-    "typescript": "^5.0.0",
-    "vitest": "^2.0.0",
-    "zod": "^3.25.0"
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.9",
+    "zod": "^3.25.76"
   }
 }