@botonic/react 0.48.0 → 0.49.0-alpha.0

package/lib/cjs/debug-system-messages.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Dev-only mock payloads for every SystemDebugTrace event type.
+ *
+ * Usage from dev-entry.ts:
+ *   import { DEBUG_SYSTEM_MESSAGES } from '@botonic/react/src/debug-system-messages'
+ *   app.addDebugSystemMessage(DEBUG_SYSTEM_MESSAGES.keyword)
+ *
+ * Usage from the browser console (window.Botonic is the DevApp instance):
+ *   Botonic.addDebugSystemMessage({ action: 'nlu_keyword', nlu_keyword_name: 'hello', ... })
+ *   // or use the pre-built fixtures exposed on the DevApp:
+ *   Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.aiAgent)
+ */
+import { EventAction } from '@botonic/core';
+import type { ChunkIdsGroupedBySourceData } from './components/system-debug-trace/events/knowledge-bases-types';
+export declare const DEBUG_SYSTEM_MESSAGES: {
+    keyword: {
+        action: EventAction.Keyword;
+        flow_id: string;
+        flow_node_id: string;
+        nlu_keyword_is_regex: false;
+        nlu_keyword_name: string;
+    };
+    smartIntent: {
+        action: EventAction.IntentSmart;
+        nlu_intent_smart_title: string;
+    };
+    fallback: {
+        action: EventAction.Fallback;
+        user_input: string;
+        fallback_out: number;
+        fallback_message_id: string;
+    };
+    handoffSuccess: {
+        action: EventAction.HandoffSuccess;
+        handoff_queue_name: string;
+        handoff_is_queue_open: true;
+        handoff_has_auto_assign: true;
+        handoff_note_id: string;
+    };
+    botAction: {
+        action: EventAction.BotAction;
+        payload: string;
+    };
+    knowledgeBase: {
+        action: EventAction.Knowledgebase;
+        flow_id: string;
+        flow_node_id: string;
+        knowledgebase_inference_id: string;
+        knowledgebase_fail_reason: string;
+        knowledgebase_sources_ids: string[];
+        knowledgebase_chunks_ids: string[];
+        user_input: string;
+        knowledge_base_chunks_with_sources: ChunkIdsGroupedBySourceData[];
+    };
+    knowledgeBaseFailed: {
+        action: EventAction.Knowledgebase;
+        flow_id: string;
+        flow_node_id: string;
+        knowledgebase_inference_id: string;
+        knowledgebase_fail_reason: string;
+        knowledgebase_sources_ids: never[];
+        knowledgebase_chunks_ids: never[];
+        user_input: string;
+        knowledge_base_chunks_with_sources: never[];
+    };
+    conditionalChannel: {
+        action: EventAction.ConditionalChannel;
+        channel: string;
+    };
+    conditionalCountry: {
+        action: EventAction.ConditionalCountry;
+        country: string;
+    };
+    conditionalCustom: {
+        action: EventAction.ConditionalCustom;
+        conditional_variable: string;
+        variable_format: string;
+    };
+    conditionalQueueStatus: {
+        action: EventAction.ConditionalQueueStatus;
+        queue_id: string;
+        queue_name: string;
+        is_queue_open: true;
+        is_available_agent: true;
+    };
+    redirectFlow: {
+        action: EventAction.RedirectFlow;
+        flow_id: string;
+        flow_name: string;
+        flow_target_id: string;
+        flow_target_name: string;
+    };
+    webviewActionTriggered: {
+        action: EventAction.WebviewActionTriggered;
+        webview_target_id: string;
+        webview_name: string;
+    };
+    aiAgent: {
+        action: EventAction.AiAgent;
+        flow_node_content_id: string;
+        user_input: string;
+        tools_executed: ({
+            tool_name: string;
+            tool_arguments: {
+                query: string;
+                user_id?: undefined;
+            };
+            tool_results: string;
+            knowledgebase_sources_ids: string[];
+            knowledgebase_chunks_ids: string[];
+        } | {
+            tool_name: string;
+            tool_arguments: {
+                user_id: string;
+                query?: undefined;
+            };
+            tool_results: string;
+            knowledgebase_sources_ids?: undefined;
+            knowledgebase_chunks_ids?: undefined;
+        })[];
+        input_guardrails_triggered: never[];
+        output_guardrails_triggered: never[];
+        exit: false;
+        error: false;
+        knowledge_base_chunks_with_sources: ChunkIdsGroupedBySourceData[];
+    };
+    aiAgentWithGuardrails: {
+        action: EventAction.AiAgent;
+        flow_node_content_id: string;
+        user_input: string;
+        tools_executed: never[];
+        input_guardrails_triggered: string[];
+        output_guardrails_triggered: never[];
+        exit: false;
+        error: false;
+    };
+    aiAgentError: {
+        action: EventAction.AiAgent;
+        flow_node_content_id: string;
+        user_input: string;
+        tools_executed: never[];
+        input_guardrails_triggered: never[];
+        output_guardrails_triggered: never[];
+        exit: false;
+        error: true;
+    };
+    aiAgentRouter: {
+        noTransfer: {
+            action: EventAction.AiAgentRouter;
+            flow_node_content_id: string;
+            tools_executed: never[];
+            memory_length: number;
+            input_guardrails_triggered: never[];
+            output_guardrails_triggered: never[];
+            exit: false;
+            starting_agent_name: string;
+            last_agent_name: string;
+            available_specialists: {
+                name: string;
+                description: string;
+            }[];
+            is_transferred_to_specialist: false;
+        };
+        inputGuardrail: {
+            action: EventAction.AiAgentRouter;
+            flow_node_content_id: string;
+            tools_executed: never[];
+            memory_length: number;
+            input_guardrails_triggered: string[];
+            output_guardrails_triggered: never[];
+            exit: false;
+            starting_agent_name: string;
+            last_agent_name: string;
+            available_specialists: {
+                name: string;
+                description: string;
+            }[];
+            is_transferred_to_specialist: false;
+        };
+        transfer: {
+            action: EventAction.AiAgentRouter;
+            flow_node_content_id: string;
+            tools_executed: never[];
+            memory_length: number;
+            input_guardrails_triggered: never[];
+            output_guardrails_triggered: never[];
+            exit: true;
+            starting_agent_name: string;
+            last_agent_name: string;
+            available_specialists: {
+                name: string;
+                description: string;
+            }[];
+            is_transferred_to_specialist: true;
+            knowledge_base_chunks_with_sources: never[];
+        };
+    };
+};

package/lib/cjs/debug-system-messages.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * Dev-only mock payloads for every SystemDebugTrace event type.
+ *
+ * Usage from dev-entry.ts:
+ *   import { DEBUG_SYSTEM_MESSAGES } from '@botonic/react/src/debug-system-messages'
+ *   app.addDebugSystemMessage(DEBUG_SYSTEM_MESSAGES.keyword)
+ *
+ * Usage from the browser console (window.Botonic is the DevApp instance):
+ *   Botonic.addDebugSystemMessage({ action: 'nlu_keyword', nlu_keyword_name: 'hello', ... })
+ *   // or use the pre-built fixtures exposed on the DevApp:
+ *   Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.aiAgent)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEBUG_SYSTEM_MESSAGES = void 0;
+const core_1 = require("@botonic/core");
+const mockChunksWithSources = [
+    {
+        source: {
+            id: 'src-mock-001',
+            name: 'Help Center',
+            type: 'url',
+            scrapingCountryCode: null,
+            createdAt: '2026-01-01T00:00:00Z',
+            createdBy: 'mock',
+            lastUpdatedAt: '2026-01-01T00:00:00Z',
+            lastUpdatedBy: 'mock',
+            activeExtractionJob: null,
+            lastExtractionJob: null,
+        },
+        chunks: [
+            {
+                id: 'chunk-mock-001',
+                text: 'To reset your password, go to Settings > Security > Reset Password.',
+            },
+        ],
+    },
+];
+exports.DEBUG_SYSTEM_MESSAGES = {
+    keyword: {
+        action: core_1.EventAction.Keyword,
+        flow_id: 'flow-mock-001',
+        flow_node_id: 'node-mock-001',
+        nlu_keyword_is_regex: false,
+        nlu_keyword_name: 'hello',
+    },
+    smartIntent: {
+        action: core_1.EventAction.IntentSmart,
+        nlu_intent_smart_title: 'Greeting smart intent',
+    },
+    fallback: {
+        action: core_1.EventAction.Fallback,
+        user_input: "I don't understand this bot",
+        fallback_out: 1,
+        fallback_message_id: 'msg-mock-002',
+    },
+    handoffSuccess: {
+        action: core_1.EventAction.HandoffSuccess,
+        handoff_queue_name: 'Support Team',
+        handoff_is_queue_open: true,
+        handoff_has_auto_assign: true,
+        handoff_note_id: '',
+    },
+    botAction: {
+        action: core_1.EventAction.BotAction,
+        payload: 'custom-action-result',
+    },
+    knowledgeBase: {
+        action: core_1.EventAction.Knowledgebase,
+        flow_id: 'flow-mock-001',
+        flow_node_id: 'node-mock-004',
+        knowledgebase_inference_id: 'inf-mock-001',
+        knowledgebase_fail_reason: '',
+        knowledgebase_sources_ids: ['src-mock-001'],
+        knowledgebase_chunks_ids: ['chunk-mock-001'],
+        user_input: 'How do I reset my password?',
+        knowledge_base_chunks_with_sources: mockChunksWithSources,
+    },
+    knowledgeBaseFailed: {
+        action: core_1.EventAction.Knowledgebase,
+        flow_id: 'flow-mock-001',
+        flow_node_id: 'node-mock-004',
+        knowledgebase_inference_id: 'inf-mock-002',
+        knowledgebase_fail_reason: 'no_relevant_content',
+        knowledgebase_sources_ids: [],
+        knowledgebase_chunks_ids: [],
+        user_input: 'What is the meaning of life?',
+        knowledge_base_chunks_with_sources: [],
+    },
+    conditionalChannel: {
+        action: core_1.EventAction.ConditionalChannel,
+        channel: 'whatsapp',
+    },
+    conditionalCountry: {
+        action: core_1.EventAction.ConditionalCountry,
+        country: 'ES',
+    },
+    conditionalCustom: {
+        action: core_1.EventAction.ConditionalCustom,
+        conditional_variable: 'user_plan',
+        variable_format: 'string',
+    },
+    conditionalQueueStatus: {
+        action: core_1.EventAction.ConditionalQueueStatus,
+        queue_id: 'queue-mock-001',
+        queue_name: 'Support Team',
+        is_queue_open: true,
+        is_available_agent: true,
+    },
+    redirectFlow: {
+        action: core_1.EventAction.RedirectFlow,
+        flow_id: 'flow-mock-001',
+        flow_name: 'Main Flow',
+        flow_target_id: 'flow-mock-002',
+        flow_target_name: 'Billing Flow',
+    },
+    webviewActionTriggered: {
+        action: core_1.EventAction.WebviewActionTriggered,
+        webview_target_id: 'webview-mock-001',
+        webview_name: 'Payment Form',
+    },
+    aiAgent: {
+        action: core_1.EventAction.AiAgent,
+        flow_node_content_id: 'content-mock-001',
+        user_input: 'Can you help me with my subscription?',
+        tools_executed: [
+            {
+                tool_name: 'retrieve_knowledge',
+                tool_arguments: { query: 'subscription management' },
+                tool_results: 'Found 3 relevant articles about subscription management.',
+                knowledgebase_sources_ids: ['src-mock-001'],
+                knowledgebase_chunks_ids: ['chunk-mock-001'],
+            },
+            {
+                tool_name: 'get_user_subscription',
+                tool_arguments: { user_id: 'user-mock-001' },
+                tool_results: '{"plan": "pro", "renewal_date": "2026-06-01"}',
+            },
+        ],
+        input_guardrails_triggered: [],
+        output_guardrails_triggered: [],
+        exit: false,
+        error: false,
+        knowledge_base_chunks_with_sources: mockChunksWithSources,
+    },
+    aiAgentWithGuardrails: {
+        action: core_1.EventAction.AiAgent,
+        flow_node_content_id: 'content-mock-002',
+        user_input: 'Tell me something inappropriate',
+        tools_executed: [],
+        input_guardrails_triggered: ['content_safety', 'topic_restriction'],
+        output_guardrails_triggered: [],
+        exit: false,
+        error: false,
+    },
+    aiAgentError: {
+        action: core_1.EventAction.AiAgent,
+        flow_node_content_id: 'content-mock-003',
+        user_input: 'Hello',
+        tools_executed: [],
+        input_guardrails_triggered: [],
+        output_guardrails_triggered: [],
+        exit: false,
+        error: true,
+    },
+    aiAgentRouter: {
+        noTransfer: {
+            action: core_1.EventAction.AiAgentRouter,
+            flow_node_content_id: 'customer_support_router',
+            tools_executed: [],
+            memory_length: 2,
+            input_guardrails_triggered: [],
+            output_guardrails_triggered: [],
+            exit: false,
+            starting_agent_name: 'customer_support_router',
+            last_agent_name: 'customer_support_router',
+            available_specialists: [
+                {
+                    name: 'billing_specialist',
+                    description: 'Handles billing and invoice queries',
+                },
+                {
+                    name: 'technical_support_specialist',
+                    description: 'Handles technical issues',
+                },
+            ],
+            is_transferred_to_specialist: false,
+        },
+        inputGuardrail: {
+            action: core_1.EventAction.AiAgentRouter,
+            flow_node_content_id: 'customer_support_router',
+            tools_executed: [],
+            memory_length: 0,
+            input_guardrails_triggered: ['is_competence'],
+            output_guardrails_triggered: [],
+            exit: false,
+            starting_agent_name: 'customer_support_router',
+            last_agent_name: 'customer_support_router',
+            available_specialists: [
+                {
+                    name: 'billing_specialist',
+                    description: 'Handles billing and invoice queries',
+                },
+                {
+                    name: 'technical_support_specialist',
+                    description: 'Handles technical issues',
+                },
+            ],
+            is_transferred_to_specialist: false,
+        },
+        transfer: {
+            action: core_1.EventAction.AiAgentRouter,
+            flow_node_content_id: 'customer_support_router',
+            tools_executed: [],
+            memory_length: 3,
+            input_guardrails_triggered: [],
+            output_guardrails_triggered: [],
+            exit: true,
+            starting_agent_name: 'customer_support_router',
+            last_agent_name: 'billing_specialist',
+            available_specialists: [
+                {
+                    name: 'billing_specialist',
+                    description: 'Handles billing and invoice queries',
+                },
+                {
+                    name: 'technical_support_specialist',
+                    description: 'Handles technical issues',
+                },
+                {
+                    name: 'sales_specialist',
+                    description: 'Handles sales and pricing queries',
+                },
+            ],
+            is_transferred_to_specialist: true,
+            knowledge_base_chunks_with_sources: [],
+        },
+    },
+};
+//# sourceMappingURL=debug-system-messages.js.map

package/lib/cjs/debug-system-messages.js.map

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

package/lib/cjs/dev-app.d.ts

@@ -24,6 +24,205 @@ export class DevApp extends WebchatApp {
     bot: ReactBot;
     getComponent(host: any, optionsAtRuntime?: {}): import("react/jsx-runtime").JSX.Element;
     render(dest: any, optionsAtRuntime?: {}): void;
+    /** Pre-built mock payloads for every debug event type. Handy from the console:
+     *  Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.aiAgent) */
+    get debugSystemMessages(): {
+        keyword: {
+            action: import("@botonic/core").EventAction.Keyword;
+            flow_id: string;
+            flow_node_id: string;
+            nlu_keyword_is_regex: false;
+            nlu_keyword_name: string;
+        };
+        smartIntent: {
+            action: import("@botonic/core").EventAction.IntentSmart;
+            nlu_intent_smart_title: string;
+        };
+        fallback: {
+            action: import("@botonic/core").EventAction.Fallback;
+            user_input: string;
+            fallback_out: number;
+            fallback_message_id: string;
+        };
+        handoffSuccess: {
+            action: import("@botonic/core").EventAction.HandoffSuccess;
+            handoff_queue_name: string;
+            handoff_is_queue_open: true;
+            handoff_has_auto_assign: true;
+            handoff_note_id: string;
+        };
+        botAction: {
+            action: import("@botonic/core").EventAction.BotAction;
+            payload: string;
+        };
+        knowledgeBase: {
+            action: import("@botonic/core").EventAction.Knowledgebase;
+            flow_id: string;
+            flow_node_id: string;
+            knowledgebase_inference_id: string;
+            knowledgebase_fail_reason: string;
+            knowledgebase_sources_ids: string[];
+            knowledgebase_chunks_ids: string[];
+            user_input: string;
+            knowledge_base_chunks_with_sources: import("./index-types").ChunkIdsGroupedBySourceData[];
+        };
+        knowledgeBaseFailed: {
+            action: import("@botonic/core").EventAction.Knowledgebase;
+            flow_id: string;
+            flow_node_id: string;
+            knowledgebase_inference_id: string;
+            knowledgebase_fail_reason: string;
+            knowledgebase_sources_ids: never[];
+            knowledgebase_chunks_ids: never[];
+            user_input: string;
+            knowledge_base_chunks_with_sources: never[];
+        };
+        conditionalChannel: {
+            action: import("@botonic/core").EventAction.ConditionalChannel;
+            channel: string;
+        };
+        conditionalCountry: {
+            action: import("@botonic/core").EventAction.ConditionalCountry;
+            country: string;
+        };
+        conditionalCustom: {
+            action: import("@botonic/core").EventAction.ConditionalCustom;
+            conditional_variable: string;
+            variable_format: string;
+        };
+        conditionalQueueStatus: {
+            action: import("@botonic/core").EventAction.ConditionalQueueStatus;
+            queue_id: string;
+            queue_name: string;
+            is_queue_open: true;
+            is_available_agent: true;
+        };
+        redirectFlow: {
+            action: import("@botonic/core").EventAction.RedirectFlow;
+            flow_id: string;
+            flow_name: string;
+            flow_target_id: string;
+            flow_target_name: string;
+        };
+        webviewActionTriggered: {
+            action: import("@botonic/core").EventAction.WebviewActionTriggered;
+            webview_target_id: string;
+            webview_name: string;
+        };
+        aiAgent: {
+            action: import("@botonic/core").EventAction.AiAgent;
+            flow_node_content_id: string;
+            user_input: string;
+            tools_executed: ({
+                tool_name: string;
+                tool_arguments: {
+                    query: string;
+                    user_id?: undefined;
+                };
+                tool_results: string;
+                knowledgebase_sources_ids: string[];
+                knowledgebase_chunks_ids: string[];
+            } | {
+                tool_name: string;
+                tool_arguments: {
+                    user_id: string;
+                    query?: undefined;
+                };
+                tool_results: string;
+                knowledgebase_sources_ids?: undefined;
+                knowledgebase_chunks_ids?: undefined;
+            })[];
+            input_guardrails_triggered: never[];
+            output_guardrails_triggered: never[];
+            exit: false;
+            error: false;
+            knowledge_base_chunks_with_sources: import("./index-types").ChunkIdsGroupedBySourceData[];
+        };
+        aiAgentWithGuardrails: {
+            action: import("@botonic/core").EventAction.AiAgent;
+            flow_node_content_id: string;
+            user_input: string;
+            tools_executed: never[];
+            input_guardrails_triggered: string[];
+            output_guardrails_triggered: never[];
+            exit: false;
+            error: false;
+        };
+        aiAgentError: {
+            action: import("@botonic/core").EventAction.AiAgent;
+            flow_node_content_id: string;
+            user_input: string;
+            tools_executed: never[];
+            input_guardrails_triggered: never[];
+            output_guardrails_triggered: never[];
+            exit: false;
+            error: true;
+        };
+        aiAgentRouter: {
+            noTransfer: {
+                action: import("@botonic/core").EventAction.AiAgentRouter;
+                flow_node_content_id: string;
+                tools_executed: never[];
+                memory_length: number;
+                input_guardrails_triggered: never[];
+                output_guardrails_triggered: never[];
+                exit: false;
+                starting_agent_name: string;
+                last_agent_name: string;
+                available_specialists: {
+                    name: string;
+                    description: string;
+                }[];
+                is_transferred_to_specialist: false;
+            };
+            inputGuardrail: {
+                action: import("@botonic/core").EventAction.AiAgentRouter;
+                flow_node_content_id: string;
+                tools_executed: never[];
+                memory_length: number;
+                input_guardrails_triggered: string[];
+                output_guardrails_triggered: never[];
+                exit: false;
+                starting_agent_name: string;
+                last_agent_name: string;
+                available_specialists: {
+                    name: string;
+                    description: string;
+                }[];
+                is_transferred_to_specialist: false;
+            };
+            transfer: {
+                action: import("@botonic/core").EventAction.AiAgentRouter;
+                flow_node_content_id: string;
+                tools_executed: never[];
+                memory_length: number;
+                input_guardrails_triggered: never[];
+                output_guardrails_triggered: never[];
+                exit: true;
+                starting_agent_name: string;
+                last_agent_name: string;
+                available_specialists: {
+                    name: string;
+                    description: string;
+                }[];
+                is_transferred_to_specialist: true;
+                knowledge_base_chunks_with_sources: never[];
+            };
+        };
+    };
+    /**
+     * Inject a mock SystemDebugTrace event into the preview webchat.
+     * Accepts any DebugEvent payload (plain object with an `action` field).
+     *
+     * From code:
+     *   import { DEBUG_SYSTEM_MESSAGES } from '@botonic/react/src/debug-system-messages'
+     *   app.addDebugSystemMessage(DEBUG_SYSTEM_MESSAGES.aiAgent)
+     *
+     * From the browser console:
+     *   Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.conditionalQueueStatus)
+     *   Botonic.addDebugSystemMessage({ action: 'nlu_keyword', nlu_keyword_name: 'hi', nlu_keyword_is_regex: false, flow_id: 'f1', flow_node_id: 'n1' })
+     */
+    addDebugSystemMessage(eventData: any): void;
     onUserInput({ input, session, lastRoutePath }: {
         input: any;
         session: any;

package/lib/cjs/dev-app.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DevApp = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
+const core_1 = require("@botonic/core");
 const client_1 = require("react-dom/client");
+const debug_system_messages_1 = require("./debug-system-messages");
 const index_types_1 = require("./index-types");
 const react_bot_1 = require("./react-bot");
 const dom_1 = require("./util/dom");
@@ -56,6 +58,26 @@ class DevApp extends webchat_app_1.WebchatApp {
             reactRoot.render(devAppComponent);
         });
     }
+    /** Pre-built mock payloads for every debug event type. Handy from the console:
+     *  Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.aiAgent) */
+    get debugSystemMessages() {
+        return debug_system_messages_1.DEBUG_SYSTEM_MESSAGES;
+    }
+    /**
+     * Inject a mock SystemDebugTrace event into the preview webchat.
+     * Accepts any DebugEvent payload (plain object with an `action` field).
+     *
+     * From code:
+     *   import { DEBUG_SYSTEM_MESSAGES } from '@botonic/react/src/debug-system-messages'
+     *   app.addDebugSystemMessage(DEBUG_SYSTEM_MESSAGES.aiAgent)
+     *
+     * From the browser console:
+     *   Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.conditionalQueueStatus)
+     *   Botonic.addDebugSystemMessage({ action: 'nlu_keyword', nlu_keyword_name: 'hi', nlu_keyword_is_regex: false, flow_id: 'f1', flow_node_id: 'n1' })
+     */
+    addDebugSystemMessage(eventData) {
+        this.addSystemMessage({ type: core_1.INPUT.SYSTEM_DEBUG_TRACE, data: eventData });
+    }
     async onUserInput({ input, session, lastRoutePath }) {
         this.onMessage?.(this, {
             sentBy: index_types_1.SENDERS.user,