@syntrologie/adapt-chatbot 2.15.0 → 2.25.0

package/dist/tools/bridge.d.ts

@@ -1,26 +0,0 @@
-/**
- * Tool Bridge — Dispatch
- *
- * executeTool: translates an AI tool call to an ActionStep and fires applyBatch().
- * getContext: reads session state from the runtime (no page effect).
- */
-import type { ChatbotWidgetRuntime } from '../types';
-export interface ToolCall {
-    name: string;
-    args: Record<string, unknown>;
-}
-export interface ContextResult {
-    page: string;
-    signals: ReturnType<ChatbotWidgetRuntime['getActiveSignals']>;
-    config: ReturnType<ChatbotWidgetRuntime['getContextConfig']>;
-}
-/**
- * Execute a tool call. For action tools (show_overlay, scroll_to):
- * expands args to ActionStep and calls applyBatch(). Throws for unknown tools.
- */
-export declare function executeTool(call: ToolCall, runtime: ChatbotWidgetRuntime): Promise<void>;
-/**
- * Read current session context. Never calls applyBatch.
- */
-export declare function getContext(runtime: ChatbotWidgetRuntime): ContextResult;
-//# sourceMappingURL=bridge.d.ts.map

package/dist/tools/bridge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/tools/bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAGrD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC9D,MAAM,EAAE,UAAU,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC,CAAC;CAC9D;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9F;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAMvE"}

package/dist/tools/bridge.js

@@ -1,25 +0,0 @@
-/**
- * Tool Bridge — Dispatch
- *
- * executeTool: translates an AI tool call to an ActionStep and fires applyBatch().
- * getContext: reads session state from the runtime (no page effect).
- */
-import { expand } from './expanders';
-/**
- * Execute a tool call. For action tools (show_overlay, scroll_to):
- * expands args to ActionStep and calls applyBatch(). Throws for unknown tools.
- */
-export async function executeTool(call, runtime) {
-    const step = expand(call.name, call.args);
-    await runtime.actions.applyBatch([step]);
-}
-/**
- * Read current session context. Never calls applyBatch.
- */
-export function getContext(runtime) {
-    return {
-        page: window.location.pathname,
-        signals: runtime.getActiveSignals(),
-        config: runtime.getContextConfig(),
-    };
-}

package/dist/tools/expanders.d.ts

@@ -1,17 +0,0 @@
-/**
- * Tool Bridge — Expanders
- *
- * Translates simplified AI tool arguments into full ActionStep objects.
- * The AI sees small, constrained arg schemas. Expanders fill in all
- * schema defaults the AI doesn't need to reason about.
- */
-export interface ActionStep {
-    kind: string;
-    config: Record<string, unknown>;
-}
-/**
- * Expand a tool call into a full ActionStep.
- * Throws for unknown tool names — do not silently ignore.
- */
-export declare function expand(toolName: string, args: Record<string, unknown>): ActionStep;
-//# sourceMappingURL=expanders.d.ts.map

package/dist/tools/expanders.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"expanders.d.ts","sourceRoot":"","sources":["../../src/tools/expanders.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AA6BD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAMlF"}

package/dist/tools/expanders.js

@@ -1,41 +0,0 @@
-/**
- * Tool Bridge — Expanders
- *
- * Translates simplified AI tool arguments into full ActionStep objects.
- * The AI sees small, constrained arg schemas. Expanders fill in all
- * schema defaults the AI doesn't need to reason about.
- */
-const expanders = {
-    show_overlay: (args) => ({
-        kind: 'show_overlay',
-        config: {
-            headline: args['headline'],
-            body: args['body'],
-            cta_label: args['cta'] ?? null,
-            // Schema defaults — AI does not control these
-            position: 'center',
-            dismissible: true,
-        },
-    }),
-    scroll_to: (args) => ({
-        kind: 'scroll_to',
-        config: {
-            // Passed through as-is. The runtime SDK's scroll_to executor resolves
-            // the target string: first as a CSS selector / anchor ID, then by
-            // case-insensitive heading text match. The expander does no DOM lookup.
-            target: args['section'],
-            behavior: 'smooth',
-        },
-    }),
-};
-/**
- * Expand a tool call into a full ActionStep.
- * Throws for unknown tool names — do not silently ignore.
- */
-export function expand(toolName, args) {
-    const expander = expanders[toolName];
-    if (!expander) {
-        throw new Error(`Unknown tool: ${toolName}`);
-    }
-    return expander(args);
-}

package/dist/tools/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * Tool Bridge — public API
- *
- * Integration mode (client owns the chat shell):
- *   import { SyntroTools } from '@syntrologie/adapt-chatbot/tools'
- *   // Render <SyntroTools runtime={syntroRuntime} /> inside AssistantRuntimeProvider
- *
- * Supply mode: use <SyntroChatbot /> from '@syntrologie/adapt-chatbot' instead.
- */
-export type { ContextResult, ToolCall } from './bridge';
-export { executeTool, getContext } from './bridge';
-export type { ActionStep } from './expanders';
-export { SyntroTools } from './registrations';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tools/index.js

@@ -1,11 +0,0 @@
-/**
- * Tool Bridge — public API
- *
- * Integration mode (client owns the chat shell):
- *   import { SyntroTools } from '@syntrologie/adapt-chatbot/tools'
- *   // Render <SyntroTools runtime={syntroRuntime} /> inside AssistantRuntimeProvider
- *
- * Supply mode: use <SyntroChatbot /> from '@syntrologie/adapt-chatbot' instead.
- */
-export { executeTool, getContext } from './bridge';
-export { SyntroTools } from './registrations';

package/dist/tools/registrations/GetContextTool.d.ts

@@ -1,7 +0,0 @@
-import type { ChatbotWidgetRuntime } from '../../types';
-interface Props {
-    runtime: ChatbotWidgetRuntime;
-}
-export declare function GetContextTool({ runtime }: Props): null;
-export {};
-//# sourceMappingURL=GetContextTool.d.ts.map

package/dist/tools/registrations/GetContextTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"GetContextTool.d.ts","sourceRoot":"","sources":["../../../src/tools/registrations/GetContextTool.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxD,UAAU,KAAK;IACb,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,QAUhD"}

package/dist/tools/registrations/GetContextTool.js

@@ -1,18 +0,0 @@
-/**
- * GetContextTool — registers the get_context tool with assistant-ui.
- *
- * This is a silent tool: it has no render output. When the AI calls it,
- * execute() reads session state and returns the context. No applyBatch call.
- */
-import { useAssistantTool } from '@assistant-ui/react';
-import { getContext } from '../bridge';
-export function GetContextTool({ runtime }) {
-    useAssistantTool({
-        toolName: 'get_context',
-        type: 'frontend',
-        description: "Get current context about the user: what page they're on and what behavioral signals have fired in this session.",
-        parameters: { type: 'object', properties: {}, required: [] },
-        execute: async () => getContext(runtime),
-    });
-    return null;
-}

package/dist/tools/registrations/ScrollToTool.d.ts

@@ -1,7 +0,0 @@
-import type { ChatbotWidgetRuntime } from '../../types';
-interface Props {
-    runtime: ChatbotWidgetRuntime;
-}
-export declare function ScrollToTool({ runtime }: Props): null;
-export {};
-//# sourceMappingURL=ScrollToTool.d.ts.map

package/dist/tools/registrations/ScrollToTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ScrollToTool.d.ts","sourceRoot":"","sources":["../../../src/tools/registrations/ScrollToTool.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAOxD,UAAU,KAAK;IACb,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,QAuC9C"}

package/dist/tools/registrations/ScrollToTool.js

@@ -1,38 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * ScrollToTool — registers the scroll_to tool with assistant-ui.
- */
-import { useAssistantTool } from '@assistant-ui/react';
-import { executeTool } from '../bridge';
-export function ScrollToTool({ runtime }) {
-    useAssistantTool({
-        toolName: 'scroll_to',
-        type: 'frontend',
-        description: "Scroll the page to a named section. Use the section's visible heading text or a known anchor ID.",
-        parameters: {
-            type: 'object',
-            properties: {
-                section: {
-                    type: 'string',
-                    description: "The section to scroll to. Use the section's visible heading text or a known anchor ID.",
-                },
-            },
-            required: ['section'],
-        },
-        execute: async (args) => {
-            await executeTool({ name: 'scroll_to', args }, runtime);
-        },
-        render: ({ args, status }) => {
-            if (status.type !== 'complete')
-                return null;
-            return (_jsxs("div", { style: {
-                    padding: '8px 12px',
-                    borderRadius: '6px',
-                    background: 'rgba(99, 179, 237, 0.08)',
-                    border: '1px solid rgba(99, 179, 237, 0.2)',
-                    fontSize: '12px',
-                }, children: [_jsx("span", { style: { color: '#63b3ed', fontWeight: 600 }, children: "Scrolled to \u2014 " }), _jsx("span", { style: { color: '#90cdf4' }, children: args.section })] }));
-        },
-    });
-    return null;
-}

package/dist/tools/registrations/ShowOverlayTool.d.ts

@@ -1,7 +0,0 @@
-import type { ChatbotWidgetRuntime } from '../../types';
-interface Props {
-    runtime: ChatbotWidgetRuntime;
-}
-export declare function ShowOverlayTool({ runtime }: Props): null;
-export {};
-//# sourceMappingURL=ShowOverlayTool.d.ts.map

package/dist/tools/registrations/ShowOverlayTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShowOverlayTool.d.ts","sourceRoot":"","sources":["../../../src/tools/registrations/ShowOverlayTool.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AASxD,UAAU,KAAK;IACb,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,QAwCjD"}

package/dist/tools/registrations/ShowOverlayTool.js

@@ -1,47 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * ShowOverlayTool — registers the show_overlay tool with assistant-ui.
- *
- * execute() fires immediately (type: 'frontend'), dispatching the overlay
- * action via applyBatch(). The render prop shows a compact confirmation card
- * inline in the chat thread after the tool completes.
- *
- * React 18+ strict mode double-fires useEffect in dev. applyBatch is
- * idempotent for the same action within a session, so this is benign.
- */
-import { useAssistantTool } from '@assistant-ui/react';
-import { executeTool } from '../bridge';
-export function ShowOverlayTool({ runtime }) {
-    useAssistantTool({
-        toolName: 'show_overlay',
-        type: 'frontend',
-        description: 'Show a modal overlay on the page with a headline, body message, and optional call-to-action button.',
-        parameters: {
-            type: 'object',
-            properties: {
-                headline: { type: 'string', description: 'Short headline for the overlay.' },
-                body: { type: 'string', description: 'Main message body.' },
-                cta: {
-                    type: 'string',
-                    description: 'Button label. Omit if no action needed.',
-                },
-            },
-            required: ['headline', 'body'],
-        },
-        execute: async (args) => {
-            await executeTool({ name: 'show_overlay', args }, runtime);
-        },
-        render: ({ args, status }) => {
-            if (status.type !== 'complete')
-                return null;
-            return (_jsxs("div", { style: {
-                    padding: '8px 12px',
-                    borderRadius: '6px',
-                    background: 'rgba(104, 211, 145, 0.08)',
-                    border: '1px solid rgba(104, 211, 145, 0.2)',
-                    fontSize: '12px',
-                }, children: [_jsx("span", { style: { color: '#68d391', fontWeight: 600 }, children: "Overlay shown \u2014 " }), _jsx("span", { style: { color: '#9ae6b4' }, children: args.headline })] }));
-        },
-    });
-    return null;
-}

package/dist/tools/registrations/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * SyntroTools — renders all tool registration components.
- *
- * Render this inside an AssistantRuntimeProvider. Each child registers
- * one tool with assistant-ui via useAssistantTool.
- *
- * Integration mode:
- *   <AssistantRuntimeProvider runtime={myRuntime}>
- *     <SyntroTools runtime={syntroRuntime} />
- *     <Thread />
- *   </AssistantRuntimeProvider>
- */
-import type { ChatbotWidgetRuntime } from '../../types';
-interface Props {
-    runtime: ChatbotWidgetRuntime;
-}
-export declare function SyntroTools({ runtime }: Props): import("react/jsx-runtime").JSX.Element;
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/tools/registrations/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/registrations/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAKxD,UAAU,KAAK;IACb,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,2CAQ7C"}

package/dist/tools/registrations/index.js

@@ -1,7 +0,0 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { GetContextTool } from './GetContextTool';
-import { ScrollToTool } from './ScrollToTool';
-import { ShowOverlayTool } from './ShowOverlayTool';
-export function SyntroTools({ runtime }) {
-    return (_jsxs(_Fragment, { children: [_jsx(GetContextTool, { runtime: runtime }), _jsx(ShowOverlayTool, { runtime: runtime }), _jsx(ScrollToTool, { runtime: runtime })] }));
-}

package/dist/types.js

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

package/dist/useChat.d.ts

@@ -1,25 +0,0 @@
-/**
- * Adaptive Chatbot - useChat Hook
- *
- * React hook managing chat message state, API communication,
- * history management, and action execution via the runtime ActionEngine.
- */
-import type { ChatbotWidgetRuntime, ChatMessage } 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

@@ -1 +0,0 @@
-{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../src/useChat.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAqB,oBAAoB,EAAE,WAAW,EAAE,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

@@ -1,106 +0,0 @@
-/**
- * Adaptive Chatbot - useChat Hook
- *
- * React hook managing chat message state, API communication,
- * history management, and action execution via the runtime ActionEngine.
- */
-import { useCallback, useRef, useState } 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,
-    };
-}