@botonic/core 0.37.0 → 0.38.0-alpha.0

package/lib/cjs/models/ai-agents.d.ts

@@ -0,0 +1,45 @@
+export interface BaseMessage {
+    type: 'text' | 'textWithButtons' | 'carousel' | 'exit';
+}
+export interface TextMessage extends BaseMessage {
+    type: 'text';
+    content: {
+        text: string;
+    };
+}
+export interface TextWithButtonsMessage extends BaseMessage {
+    type: 'textWithButtons';
+    content: {
+        text: string;
+        buttons: string[];
+    };
+}
+interface CarouselElement {
+    title: string;
+    subtitle: string;
+    image: string;
+    button: {
+        text: string;
+        url: string;
+    };
+}
+export interface CarouselMessage extends BaseMessage {
+    type: 'carousel';
+    content: {
+        elements: CarouselElement[];
+    };
+}
+export interface ExitMessage extends BaseMessage {
+    type: 'exit';
+}
+export type OutputMessage = TextMessage | TextWithButtonsMessage | CarouselMessage | ExitMessage;
+export type AgenticOutputMessage = Exclude<OutputMessage, ExitMessage>;
+export interface RunResult {
+    messages: AgenticOutputMessage[];
+    toolsExecuted: string[];
+    exit: boolean;
+    inputGuardrailTriggered: string[];
+    outputGuardrailTriggered: string[];
+}
+export type InferenceResponse = RunResult | undefined;
+export {};

package/lib/cjs/models/{events/message/custom.js → ai-agents.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=custom.js.map
+//# sourceMappingURL=ai-agents.js.map

package/lib/cjs/models/ai-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-agents.js","sourceRoot":"","sources":["../../../src/models/ai-agents.ts"],"names":[],"mappings":""}

package/lib/cjs/models/hubtype-analytics.d.ts

@@ -0,0 +1,138 @@
+export declare enum EventAction {
+    FeedbackCase = "feedback_case",
+    FeedbackMessage = "feedback_message",
+    FeedbackConversation = "feedback_conversation",
+    FeedbackKnowledgebase = "feedback_knowledgebase",
+    FeedbackWebview = "feedback_webview",
+    FlowNode = "flow_node",
+    HandoffOption = "handoff_option",
+    HandoffSuccess = "handoff_success",
+    HandoffFail = "handoff_fail",
+    Keyword = "nlu_keyword",
+    IntentSmart = "nlu_intent_smart",
+    Knowledgebase = "knowledgebase",
+    Fallback = "fallback",
+    WebviewStep = "webview_step",
+    WebviewEnd = "webview_end",
+    Custom = "custom"
+}
+export interface HtBaseEventProps {
+    action: EventAction;
+}
+export interface EventFeedback extends HtBaseEventProps {
+    action: EventAction.FeedbackCase | EventAction.FeedbackConversation | EventAction.FeedbackMessage | EventAction.FeedbackWebview;
+    feedbackTargetId: string;
+    feedbackGroupId: string;
+    possibleOptions: string[];
+    possibleValues?: number[];
+    option: string;
+    value?: number;
+    comment?: string;
+}
+export interface EventFeedbackKnowledgebase extends HtBaseEventProps {
+    action: EventAction.FeedbackKnowledgebase;
+    knowledgebaseInferenceId: string;
+    feedbackBotInteractionId: string;
+    feedbackTargetId: string;
+    feedbackGroupId: string;
+    possibleOptions: string[];
+    possibleValues?: number[];
+    option: string;
+    value?: number;
+    comment?: string;
+}
+export interface EventFlow extends HtBaseEventProps {
+    action: EventAction.FlowNode;
+    flowThreadId: string;
+    flowId: string;
+    flowName: string;
+    flowNodeId: string;
+    flowNodeContentId: string;
+    flowNodeIsMeaningful?: boolean;
+}
+export interface EventHandoff extends HtBaseEventProps {
+    action: EventAction.HandoffSuccess | EventAction.HandoffFail;
+    flowThreadId?: string;
+    queueId: string;
+    queueName: string;
+    caseId?: string;
+    isQueueOpen?: boolean;
+    isAvailableAgent?: boolean;
+    isThresholdReached?: boolean;
+}
+export interface EventHandoffOption extends HtBaseEventProps {
+    action: EventAction.HandoffOption;
+    flowThreadId?: string;
+    queueId?: string;
+    queueName?: string;
+}
+export interface EventKeyword extends HtBaseEventProps {
+    action: EventAction.Keyword;
+    flowThreadId: string;
+    flowId: string;
+    flowNodeId: string;
+    nluKeywordName: string;
+    nluKeywordIsRegex?: boolean;
+    nluKeywordMessageId: string;
+    userInput: string;
+}
+export interface EventIntentSmart extends HtBaseEventProps {
+    action: EventAction.IntentSmart;
+    flowThreadId: string;
+    flowId: string;
+    flowNodeId: string;
+    nluIntentSmartTitle: string;
+    nluIntentSmartNumUsed: number;
+    nluIntentSmartMessageId: string;
+    userInput: string;
+}
+export interface EventKnowledgeBase extends HtBaseEventProps {
+    action: EventAction.Knowledgebase;
+    flowThreadId: string;
+    flowId: string;
+    flowNodeId: string;
+    knowledgebaseInferenceId: string;
+    knowledgebaseFailReason?: KnowledgebaseFailReason;
+    knowledgebaseSourcesIds: string[];
+    knowledgebaseChunksIds: string[];
+    knowledgebaseMessageId: string;
+    userInput: string;
+}
+export declare enum KnowledgebaseFailReason {
+    NoKnowledge = "no_knowledge",
+    Hallucination = "hallucination"
+}
+export interface EventFallback extends HtBaseEventProps {
+    action: EventAction.Fallback;
+    userInput: string;
+    fallbackOut: number;
+    fallbackMessageId: string;
+}
+export interface EventWebviewStep extends HtBaseEventProps {
+    action: EventAction.WebviewStep;
+    flowThreadId?: string;
+    webviewThreadId: string;
+    webviewName: string;
+    webviewStepName: string;
+    webviewStepNumber: number;
+}
+export interface EventWebviewEnd extends HtBaseEventProps {
+    action: EventAction.WebviewEnd;
+    flowThreadId?: string;
+    webviewThreadId: string;
+    webviewName: string;
+    webviewStepName?: string;
+    webviewStepNumber?: number;
+    webviewEndFailType?: WebviewEndFailType;
+    webviewEndFailMessage?: string;
+}
+export declare enum WebviewEndFailType {
+    CanceledByUser = "canceled_by_user",
+    ApiError = "api_error",
+    NeedsEscalation = "needs_escalation"
+}
+export interface EventCustom extends HtBaseEventProps {
+    action: EventAction.Custom;
+    customFields?: Record<string, any>;
+    customSensitiveFields?: Record<string, any>;
+}

package/lib/cjs/models/hubtype-analytics.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebviewEndFailType = exports.KnowledgebaseFailReason = exports.EventAction = void 0;
+var EventAction;
+(function (EventAction) {
+    EventAction["FeedbackCase"] = "feedback_case";
+    EventAction["FeedbackMessage"] = "feedback_message";
+    EventAction["FeedbackConversation"] = "feedback_conversation";
+    EventAction["FeedbackKnowledgebase"] = "feedback_knowledgebase";
+    EventAction["FeedbackWebview"] = "feedback_webview";
+    EventAction["FlowNode"] = "flow_node";
+    EventAction["HandoffOption"] = "handoff_option";
+    EventAction["HandoffSuccess"] = "handoff_success";
+    EventAction["HandoffFail"] = "handoff_fail";
+    EventAction["Keyword"] = "nlu_keyword";
+    EventAction["IntentSmart"] = "nlu_intent_smart";
+    EventAction["Knowledgebase"] = "knowledgebase";
+    EventAction["Fallback"] = "fallback";
+    EventAction["WebviewStep"] = "webview_step";
+    EventAction["WebviewEnd"] = "webview_end";
+    EventAction["Custom"] = "custom";
+})(EventAction = exports.EventAction || (exports.EventAction = {}));
+var KnowledgebaseFailReason;
+(function (KnowledgebaseFailReason) {
+    KnowledgebaseFailReason["NoKnowledge"] = "no_knowledge";
+    KnowledgebaseFailReason["Hallucination"] = "hallucination";
+})(KnowledgebaseFailReason = exports.KnowledgebaseFailReason || (exports.KnowledgebaseFailReason = {}));
+var WebviewEndFailType;
+(function (WebviewEndFailType) {
+    WebviewEndFailType["CanceledByUser"] = "canceled_by_user";
+    WebviewEndFailType["ApiError"] = "api_error";
+    WebviewEndFailType["NeedsEscalation"] = "needs_escalation";
+})(WebviewEndFailType = exports.WebviewEndFailType || (exports.WebviewEndFailType = {}));
+//# sourceMappingURL=hubtype-analytics.js.map

package/lib/cjs/models/hubtype-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hubtype-analytics.js","sourceRoot":"","sources":["../../../src/models/hubtype-analytics.ts"],"names":[],"mappings":";;;AAAA,IAAY,WAiBX;AAjBD,WAAY,WAAW;IACrB,6CAA8B,CAAA;IAC9B,mDAAoC,CAAA;IACpC,6DAA8C,CAAA;IAC9C,+DAAgD,CAAA;IAChD,mDAAoC,CAAA;IACpC,qCAAsB,CAAA;IACtB,+CAAgC,CAAA;IAChC,iDAAkC,CAAA;IAClC,2CAA4B,CAAA;IAC5B,sCAAuB,CAAA;IACvB,+CAAgC,CAAA;IAChC,8CAA+B,CAAA;IAC/B,oCAAqB,CAAA;IACrB,2CAA4B,CAAA;IAC5B,yCAA0B,CAAA;IAC1B,gCAAiB,CAAA;AACnB,CAAC,EAjBW,WAAW,GAAX,mBAAW,KAAX,mBAAW,QAiBtB;AAiGD,IAAY,uBAGX;AAHD,WAAY,uBAAuB;IACjC,uDAA4B,CAAA;IAC5B,0DAA+B,CAAA;AACjC,CAAC,EAHW,uBAAuB,GAAvB,+BAAuB,KAAvB,+BAAuB,QAGlC;AA6BD,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,yDAAmC,CAAA;IACnC,4CAAsB,CAAA;IACtB,0DAAoC,CAAA;AACtC,CAAC,EAJW,kBAAkB,GAAlB,0BAAkB,KAAlB,0BAAkB,QAI7B"}

package/lib/cjs/models/index.d.ts

@@ -1,3 +1,4 @@
-export * from './events';
+export * from './ai-agents';
+export * from './hubtype-analytics';
+export * from './knowledge-bases';
 export * from './legacy-types';
-export * from './user';

package/lib/cjs/models/index.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./events"), exports);
+tslib_1.__exportStar(require("./ai-agents"), exports);
+tslib_1.__exportStar(require("./hubtype-analytics"), exports);
+tslib_1.__exportStar(require("./knowledge-bases"), exports);
 tslib_1.__exportStar(require("./legacy-types"), exports);
-tslib_1.__exportStar(require("./user"), exports);
 //# sourceMappingURL=index.js.map

package/lib/cjs/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":";;;AAAA,mDAAwB;AACxB,yDAA8B;AAC9B,iDAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":";;;AAAA,sDAA2B;AAC3B,8DAAmC;AACnC,4DAAiC;AACjC,yDAA8B"}

package/lib/cjs/models/knowledge-bases.d.ts

@@ -0,0 +1,7 @@
+export interface KnowledgeBasesResponse {
+    inferenceId: string;
+    hasKnowledge: boolean;
+    isFaithful: boolean;
+    chunkIds: string[];
+    answer: string;
+}

package/lib/cjs/models/{events/botonic-event.js → knowledge-bases.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=botonic-event.js.map
+//# sourceMappingURL=knowledge-bases.js.map

package/lib/cjs/models/knowledge-bases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-bases.js","sourceRoot":"","sources":["../../../src/models/knowledge-bases.ts"],"names":[],"mappings":""}

package/lib/cjs/models/legacy-types.d.ts

@@ -150,6 +150,7 @@ export interface SessionUser<TExtraData = any> {
     name?: string;
     provider: ProviderType;
     extra_data?: TExtraData;
+    contact_info?: Record<string, string>;
     imp_id?: string;
     provider_id?: string;
     locale: string;

package/lib/cjs/models/legacy-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-types.js","sourceRoot":"","sources":["../../../src/models/legacy-types.ts"],"names":[],"mappings":";AAAA,wIAAwI;;;AAExI,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,yCAA0B,CAAA;IAC1B,6CAA8B,CAAA;IAC9B,mCAAoB,CAAA;IACpB,2CAA4B,CAAA;AAC9B,CAAC,EALW,WAAW,GAAX,mBAAW,KAAX,mBAAW,QAKtB;AAQD,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,mCAAgB,CAAA;IAChB,qCAAkB,CAAA;IAClB,mDAAgC,CAAA;IAChC,2CAAwB,CAAA;AAC1B,CAAC,EALW,eAAe,GAAf,uBAAe,KAAf,uBAAe,QAK1B;AAQD,IAAY,QAaX;AAbD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,uBAAW,CAAA;IACX,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;IACnB,mCAAuB,CAAA;IACvB,iCAAqB,CAAA;IACrB,6BAAiB,CAAA;IACjB,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;IACnB,+BAAmB,CAAA;IACnB,6BAAiB,CAAA;IACjB,iCAAqB,CAAA;AACvB,CAAC,EAbW,QAAQ,GAAR,gBAAQ,KAAR,gBAAQ,QAanB;AAeD,IAAY,KA2BX;AA3BD,WAAY,KAAK;IACf,sBAAa,CAAA;IACb,8BAAqB,CAAA;IACrB,wBAAe,CAAA;IACf,wBAAe,CAAA;IACf,wBAAe,CAAA;IACf,8BAAqB,CAAA;IACrB,8BAAqB,CAAA;IACrB,4BAAmB,CAAA;IACnB,yCAAgC,CAAA;IAChC,8BAAqB,CAAA;IACrB,0BAAiB,CAAA;IACjB,6CAAoC,CAAA;IACpC,+CAAsC,CAAA;IACtC,oBAAW,CAAA;IACX,iCAAwB,CAAA;IACxB,sDAA6C,CAAA;IAC7C,4DAAmD,CAAA;IACnD,8CAAqC,CAAA;IACrC,8CAAqC,CAAA;IACrC,wDAA+C,CAAA;IAC/C,gEAAuD,CAAA;IACvD,4DAAmD,CAAA;IACnD,0CAAiC,CAAA;IACjC,yEAAgE,CAAA;IAChE,2EAAkE,CAAA;IAClE,gEAAuD,CAAA;AACzD,CAAC,EA3BW,KAAK,GAAL,aAAK,KAAL,aAAK,QA2BhB;AA8CD,IAAY,OAGX;AAHD,WAAY,OAAO;IACjB,8BAAmB,CAAA;IACnB,uCAA4B,CAAA;AAC9B,CAAC,EAHW,OAAO,GAAP,eAAO,KAAP,eAAO,QAGlB;AAqCD,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,wCAA0B,CAAA;IAC1B,4CAA8B,CAAA;IAC9B,kCAAoB,CAAA;IACpB,0CAA4B,CAAA;AAC9B,CAAC,EALW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAKrB;AA8OD,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,6CAA4B,CAAA;IAC5B,2CAA0B,CAAA;IAC1B,2CAA0B,CAAA;IAC1B,6CAA4B,CAAA;AAC9B,CAAC,EALW,aAAa,GAAb,qBAAa,KAAb,qBAAa,QAKxB"}
+{"version":3,"file":"legacy-types.js","sourceRoot":"","sources":["../../../src/models/legacy-types.ts"],"names":[],"mappings":";AAAA,wIAAwI;;;AAExI,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,yCAA0B,CAAA;IAC1B,6CAA8B,CAAA;IAC9B,mCAAoB,CAAA;IACpB,2CAA4B,CAAA;AAC9B,CAAC,EALW,WAAW,GAAX,mBAAW,KAAX,mBAAW,QAKtB;AAQD,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,mCAAgB,CAAA;IAChB,qCAAkB,CAAA;IAClB,mDAAgC,CAAA;IAChC,2CAAwB,CAAA;AAC1B,CAAC,EALW,eAAe,GAAf,uBAAe,KAAf,uBAAe,QAK1B;AAQD,IAAY,QAaX;AAbD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,uBAAW,CAAA;IACX,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;IACnB,mCAAuB,CAAA;IACvB,iCAAqB,CAAA;IACrB,6BAAiB,CAAA;IACjB,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;IACnB,+BAAmB,CAAA;IACnB,6BAAiB,CAAA;IACjB,iCAAqB,CAAA;AACvB,CAAC,EAbW,QAAQ,GAAR,gBAAQ,KAAR,gBAAQ,QAanB;AAeD,IAAY,KA2BX;AA3BD,WAAY,KAAK;IACf,sBAAa,CAAA;IACb,8BAAqB,CAAA;IACrB,wBAAe,CAAA;IACf,wBAAe,CAAA;IACf,wBAAe,CAAA;IACf,8BAAqB,CAAA;IACrB,8BAAqB,CAAA;IACrB,4BAAmB,CAAA;IACnB,yCAAgC,CAAA;IAChC,8BAAqB,CAAA;IACrB,0BAAiB,CAAA;IACjB,6CAAoC,CAAA;IACpC,+CAAsC,CAAA;IACtC,oBAAW,CAAA;IACX,iCAAwB,CAAA;IACxB,sDAA6C,CAAA;IAC7C,4DAAmD,CAAA;IACnD,8CAAqC,CAAA;IACrC,8CAAqC,CAAA;IACrC,wDAA+C,CAAA;IAC/C,gEAAuD,CAAA;IACvD,4DAAmD,CAAA;IACnD,0CAAiC,CAAA;IACjC,yEAAgE,CAAA;IAChE,2EAAkE,CAAA;IAClE,gEAAuD,CAAA;AACzD,CAAC,EA3BW,KAAK,GAAL,aAAK,KAAL,aAAK,QA2BhB;AA8CD,IAAY,OAGX;AAHD,WAAY,OAAO;IACjB,8BAAmB,CAAA;IACnB,uCAA4B,CAAA;AAC9B,CAAC,EAHW,OAAO,GAAP,eAAO,KAAP,eAAO,QAGlB;AAqCD,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,wCAA0B,CAAA;IAC1B,4CAA8B,CAAA;IAC9B,kCAAoB,CAAA;IACpB,0CAA4B,CAAA;AAC9B,CAAC,EALW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAKrB;AA+OD,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,6CAA4B,CAAA;IAC5B,2CAA0B,CAAA;IAC1B,2CAA0B,CAAA;IAC1B,6CAA4B,CAAA;AAC9B,CAAC,EALW,aAAa,GAAb,qBAAa,KAAb,qBAAa,QAKxB"}

package/lib/esm/models/ai-agents.d.ts

@@ -0,0 +1,45 @@
+export interface BaseMessage {
+    type: 'text' | 'textWithButtons' | 'carousel' | 'exit';
+}
+export interface TextMessage extends BaseMessage {
+    type: 'text';
+    content: {
+        text: string;
+    };
+}
+export interface TextWithButtonsMessage extends BaseMessage {
+    type: 'textWithButtons';
+    content: {
+        text: string;
+        buttons: string[];
+    };
+}
+interface CarouselElement {
+    title: string;
+    subtitle: string;
+    image: string;
+    button: {
+        text: string;
+        url: string;
+    };
+}
+export interface CarouselMessage extends BaseMessage {
+    type: 'carousel';
+    content: {
+        elements: CarouselElement[];
+    };
+}
+export interface ExitMessage extends BaseMessage {
+    type: 'exit';
+}
+export type OutputMessage = TextMessage | TextWithButtonsMessage | CarouselMessage | ExitMessage;
+export type AgenticOutputMessage = Exclude<OutputMessage, ExitMessage>;
+export interface RunResult {
+    messages: AgenticOutputMessage[];
+    toolsExecuted: string[];
+    exit: boolean;
+    inputGuardrailTriggered: string[];
+    outputGuardrailTriggered: string[];
+}
+export type InferenceResponse = RunResult | undefined;
+export {};

package/lib/esm/models/ai-agents.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ai-agents.js.map

package/lib/esm/models/ai-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-agents.js","sourceRoot":"","sources":["../../../src/models/ai-agents.ts"],"names":[],"mappings":""}

package/lib/esm/models/hubtype-analytics.d.ts

@@ -0,0 +1,138 @@
+export declare enum EventAction {
+    FeedbackCase = "feedback_case",
+    FeedbackMessage = "feedback_message",
+    FeedbackConversation = "feedback_conversation",
+    FeedbackKnowledgebase = "feedback_knowledgebase",
+    FeedbackWebview = "feedback_webview",
+    FlowNode = "flow_node",
+    HandoffOption = "handoff_option",
+    HandoffSuccess = "handoff_success",
+    HandoffFail = "handoff_fail",
+    Keyword = "nlu_keyword",
+    IntentSmart = "nlu_intent_smart",
+    Knowledgebase = "knowledgebase",
+    Fallback = "fallback",
+    WebviewStep = "webview_step",
+    WebviewEnd = "webview_end",
+    Custom = "custom"
+}
+export interface HtBaseEventProps {
+    action: EventAction;
+}
+export interface EventFeedback extends HtBaseEventProps {
+    action: EventAction.FeedbackCase | EventAction.FeedbackConversation | EventAction.FeedbackMessage | EventAction.FeedbackWebview;
+    feedbackTargetId: string;
+    feedbackGroupId: string;
+    possibleOptions: string[];
+    possibleValues?: number[];
+    option: string;
+    value?: number;
+    comment?: string;
+}
+export interface EventFeedbackKnowledgebase extends HtBaseEventProps {
+    action: EventAction.FeedbackKnowledgebase;
+    knowledgebaseInferenceId: string;
+    feedbackBotInteractionId: string;
+    feedbackTargetId: string;
+    feedbackGroupId: string;
+    possibleOptions: string[];
+    possibleValues?: number[];
+    option: string;
+    value?: number;
+    comment?: string;
+}
+export interface EventFlow extends HtBaseEventProps {
+    action: EventAction.FlowNode;
+    flowThreadId: string;
+    flowId: string;
+    flowName: string;
+    flowNodeId: string;
+    flowNodeContentId: string;
+    flowNodeIsMeaningful?: boolean;
+}
+export interface EventHandoff extends HtBaseEventProps {
+    action: EventAction.HandoffSuccess | EventAction.HandoffFail;
+    flowThreadId?: string;
+    queueId: string;
+    queueName: string;
+    caseId?: string;
+    isQueueOpen?: boolean;
+    isAvailableAgent?: boolean;
+    isThresholdReached?: boolean;
+}
+export interface EventHandoffOption extends HtBaseEventProps {
+    action: EventAction.HandoffOption;
+    flowThreadId?: string;
+    queueId?: string;
+    queueName?: string;
+}
+export interface EventKeyword extends HtBaseEventProps {
+    action: EventAction.Keyword;
+    flowThreadId: string;
+    flowId: string;
+    flowNodeId: string;
+    nluKeywordName: string;
+    nluKeywordIsRegex?: boolean;
+    nluKeywordMessageId: string;
+    userInput: string;
+}
+export interface EventIntentSmart extends HtBaseEventProps {
+    action: EventAction.IntentSmart;
+    flowThreadId: string;
+    flowId: string;
+    flowNodeId: string;
+    nluIntentSmartTitle: string;
+    nluIntentSmartNumUsed: number;
+    nluIntentSmartMessageId: string;
+    userInput: string;
+}
+export interface EventKnowledgeBase extends HtBaseEventProps {
+    action: EventAction.Knowledgebase;
+    flowThreadId: string;
+    flowId: string;
+    flowNodeId: string;
+    knowledgebaseInferenceId: string;
+    knowledgebaseFailReason?: KnowledgebaseFailReason;
+    knowledgebaseSourcesIds: string[];
+    knowledgebaseChunksIds: string[];
+    knowledgebaseMessageId: string;
+    userInput: string;
+}
+export declare enum KnowledgebaseFailReason {
+    NoKnowledge = "no_knowledge",
+    Hallucination = "hallucination"
+}
+export interface EventFallback extends HtBaseEventProps {
+    action: EventAction.Fallback;
+    userInput: string;
+    fallbackOut: number;
+    fallbackMessageId: string;
+}
+export interface EventWebviewStep extends HtBaseEventProps {
+    action: EventAction.WebviewStep;
+    flowThreadId?: string;
+    webviewThreadId: string;
+    webviewName: string;
+    webviewStepName: string;
+    webviewStepNumber: number;
+}
+export interface EventWebviewEnd extends HtBaseEventProps {
+    action: EventAction.WebviewEnd;
+    flowThreadId?: string;
+    webviewThreadId: string;
+    webviewName: string;
+    webviewStepName?: string;
+    webviewStepNumber?: number;
+    webviewEndFailType?: WebviewEndFailType;
+    webviewEndFailMessage?: string;
+}
+export declare enum WebviewEndFailType {
+    CanceledByUser = "canceled_by_user",
+    ApiError = "api_error",
+    NeedsEscalation = "needs_escalation"
+}
+export interface EventCustom extends HtBaseEventProps {
+    action: EventAction.Custom;
+    customFields?: Record<string, any>;
+    customSensitiveFields?: Record<string, any>;
+}

package/lib/esm/models/hubtype-analytics.js

@@ -0,0 +1,31 @@
+export var EventAction;
+(function (EventAction) {
+    EventAction["FeedbackCase"] = "feedback_case";
+    EventAction["FeedbackMessage"] = "feedback_message";
+    EventAction["FeedbackConversation"] = "feedback_conversation";
+    EventAction["FeedbackKnowledgebase"] = "feedback_knowledgebase";
+    EventAction["FeedbackWebview"] = "feedback_webview";
+    EventAction["FlowNode"] = "flow_node";
+    EventAction["HandoffOption"] = "handoff_option";
+    EventAction["HandoffSuccess"] = "handoff_success";
+    EventAction["HandoffFail"] = "handoff_fail";
+    EventAction["Keyword"] = "nlu_keyword";
+    EventAction["IntentSmart"] = "nlu_intent_smart";
+    EventAction["Knowledgebase"] = "knowledgebase";
+    EventAction["Fallback"] = "fallback";
+    EventAction["WebviewStep"] = "webview_step";
+    EventAction["WebviewEnd"] = "webview_end";
+    EventAction["Custom"] = "custom";
+})(EventAction || (EventAction = {}));
+export var KnowledgebaseFailReason;
+(function (KnowledgebaseFailReason) {
+    KnowledgebaseFailReason["NoKnowledge"] = "no_knowledge";
+    KnowledgebaseFailReason["Hallucination"] = "hallucination";
+})(KnowledgebaseFailReason || (KnowledgebaseFailReason = {}));
+export var WebviewEndFailType;
+(function (WebviewEndFailType) {
+    WebviewEndFailType["CanceledByUser"] = "canceled_by_user";
+    WebviewEndFailType["ApiError"] = "api_error";
+    WebviewEndFailType["NeedsEscalation"] = "needs_escalation";
+})(WebviewEndFailType || (WebviewEndFailType = {}));
+//# sourceMappingURL=hubtype-analytics.js.map

package/lib/esm/models/hubtype-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hubtype-analytics.js","sourceRoot":"","sources":["../../../src/models/hubtype-analytics.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WAiBX;AAjBD,WAAY,WAAW;IACrB,6CAA8B,CAAA;IAC9B,mDAAoC,CAAA;IACpC,6DAA8C,CAAA;IAC9C,+DAAgD,CAAA;IAChD,mDAAoC,CAAA;IACpC,qCAAsB,CAAA;IACtB,+CAAgC,CAAA;IAChC,iDAAkC,CAAA;IAClC,2CAA4B,CAAA;IAC5B,sCAAuB,CAAA;IACvB,+CAAgC,CAAA;IAChC,8CAA+B,CAAA;IAC/B,oCAAqB,CAAA;IACrB,2CAA4B,CAAA;IAC5B,yCAA0B,CAAA;IAC1B,gCAAiB,CAAA;AACnB,CAAC,EAjBW,WAAW,KAAX,WAAW,QAiBtB;AAiGD,MAAM,CAAN,IAAY,uBAGX;AAHD,WAAY,uBAAuB;IACjC,uDAA4B,CAAA;IAC5B,0DAA+B,CAAA;AACjC,CAAC,EAHW,uBAAuB,KAAvB,uBAAuB,QAGlC;AA6BD,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,yDAAmC,CAAA;IACnC,4CAAsB,CAAA;IACtB,0DAAoC,CAAA;AACtC,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B"}

package/lib/esm/models/index.d.ts

@@ -1,3 +1,4 @@
-export * from './events';
+export * from './ai-agents';
+export * from './hubtype-analytics';
+export * from './knowledge-bases';
 export * from './legacy-types';
-export * from './user';

package/lib/esm/models/index.js

@@ -1,4 +1,5 @@
-export * from './events';
+export * from './ai-agents';
+export * from './hubtype-analytics';
+export * from './knowledge-bases';
 export * from './legacy-types';
-export * from './user';
 //# sourceMappingURL=index.js.map

package/lib/esm/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,QAAQ,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA"}

package/lib/esm/models/knowledge-bases.d.ts

@@ -0,0 +1,7 @@
+export interface KnowledgeBasesResponse {
+    inferenceId: string;
+    hasKnowledge: boolean;
+    isFaithful: boolean;
+    chunkIds: string[];
+    answer: string;
+}

package/lib/esm/models/knowledge-bases.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=knowledge-bases.js.map

package/lib/esm/models/knowledge-bases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-bases.js","sourceRoot":"","sources":["../../../src/models/knowledge-bases.ts"],"names":[],"mappings":""}

package/lib/esm/models/legacy-types.d.ts

@@ -150,6 +150,7 @@ export interface SessionUser<TExtraData = any> {
     name?: string;
     provider: ProviderType;
     extra_data?: TExtraData;
+    contact_info?: Record<string, string>;
     imp_id?: string;
     provider_id?: string;
     locale: string;

package/lib/esm/models/legacy-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-types.js","sourceRoot":"","sources":["../../../src/models/legacy-types.ts"],"names":[],"mappings":"AAAA,wIAAwI;AAExI,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,yCAA0B,CAAA;IAC1B,6CAA8B,CAAA;IAC9B,mCAAoB,CAAA;IACpB,2CAA4B,CAAA;AAC9B,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAQD,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,mCAAgB,CAAA;IAChB,qCAAkB,CAAA;IAClB,mDAAgC,CAAA;IAChC,2CAAwB,CAAA;AAC1B,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAQD,MAAM,CAAN,IAAY,QAaX;AAbD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,uBAAW,CAAA;IACX,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;IACnB,mCAAuB,CAAA;IACvB,iCAAqB,CAAA;IACrB,6BAAiB,CAAA;IACjB,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;IACnB,+BAAmB,CAAA;IACnB,6BAAiB,CAAA;IACjB,iCAAqB,CAAA;AACvB,CAAC,EAbW,QAAQ,KAAR,QAAQ,QAanB;AAeD,MAAM,CAAN,IAAY,KA2BX;AA3BD,WAAY,KAAK;IACf,sBAAa,CAAA;IACb,8BAAqB,CAAA;IACrB,wBAAe,CAAA;IACf,wBAAe,CAAA;IACf,wBAAe,CAAA;IACf,8BAAqB,CAAA;IACrB,8BAAqB,CAAA;IACrB,4BAAmB,CAAA;IACnB,yCAAgC,CAAA;IAChC,8BAAqB,CAAA;IACrB,0BAAiB,CAAA;IACjB,6CAAoC,CAAA;IACpC,+CAAsC,CAAA;IACtC,oBAAW,CAAA;IACX,iCAAwB,CAAA;IACxB,sDAA6C,CAAA;IAC7C,4DAAmD,CAAA;IACnD,8CAAqC,CAAA;IACrC,8CAAqC,CAAA;IACrC,wDAA+C,CAAA;IAC/C,gEAAuD,CAAA;IACvD,4DAAmD,CAAA;IACnD,0CAAiC,CAAA;IACjC,yEAAgE,CAAA;IAChE,2EAAkE,CAAA;IAClE,gEAAuD,CAAA;AACzD,CAAC,EA3BW,KAAK,KAAL,KAAK,QA2BhB;AA8CD,MAAM,CAAN,IAAY,OAGX;AAHD,WAAY,OAAO;IACjB,8BAAmB,CAAA;IACnB,uCAA4B,CAAA;AAC9B,CAAC,EAHW,OAAO,KAAP,OAAO,QAGlB;AAqCD,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,wCAA0B,CAAA;IAC1B,4CAA8B,CAAA;IAC9B,kCAAoB,CAAA;IACpB,0CAA4B,CAAA;AAC9B,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AA8OD,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,6CAA4B,CAAA;IAC5B,2CAA0B,CAAA;IAC1B,2CAA0B,CAAA;IAC1B,6CAA4B,CAAA;AAC9B,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB"}
+{"version":3,"file":"legacy-types.js","sourceRoot":"","sources":["../../../src/models/legacy-types.ts"],"names":[],"mappings":"AAAA,wIAAwI;AAExI,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,yCAA0B,CAAA;IAC1B,6CAA8B,CAAA;IAC9B,mCAAoB,CAAA;IACpB,2CAA4B,CAAA;AAC9B,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAQD,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,mCAAgB,CAAA;IAChB,qCAAkB,CAAA;IAClB,mDAAgC,CAAA;IAChC,2CAAwB,CAAA;AAC1B,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAQD,MAAM,CAAN,IAAY,QAaX;AAbD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,uBAAW,CAAA;IACX,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;IACnB,mCAAuB,CAAA;IACvB,iCAAqB,CAAA;IACrB,6BAAiB,CAAA;IACjB,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;IACnB,+BAAmB,CAAA;IACnB,6BAAiB,CAAA;IACjB,iCAAqB,CAAA;AACvB,CAAC,EAbW,QAAQ,KAAR,QAAQ,QAanB;AAeD,MAAM,CAAN,IAAY,KA2BX;AA3BD,WAAY,KAAK;IACf,sBAAa,CAAA;IACb,8BAAqB,CAAA;IACrB,wBAAe,CAAA;IACf,wBAAe,CAAA;IACf,wBAAe,CAAA;IACf,8BAAqB,CAAA;IACrB,8BAAqB,CAAA;IACrB,4BAAmB,CAAA;IACnB,yCAAgC,CAAA;IAChC,8BAAqB,CAAA;IACrB,0BAAiB,CAAA;IACjB,6CAAoC,CAAA;IACpC,+CAAsC,CAAA;IACtC,oBAAW,CAAA;IACX,iCAAwB,CAAA;IACxB,sDAA6C,CAAA;IAC7C,4DAAmD,CAAA;IACnD,8CAAqC,CAAA;IACrC,8CAAqC,CAAA;IACrC,wDAA+C,CAAA;IAC/C,gEAAuD,CAAA;IACvD,4DAAmD,CAAA;IACnD,0CAAiC,CAAA;IACjC,yEAAgE,CAAA;IAChE,2EAAkE,CAAA;IAClE,gEAAuD,CAAA;AACzD,CAAC,EA3BW,KAAK,KAAL,KAAK,QA2BhB;AA8CD,MAAM,CAAN,IAAY,OAGX;AAHD,WAAY,OAAO;IACjB,8BAAmB,CAAA;IACnB,uCAA4B,CAAA;AAC9B,CAAC,EAHW,OAAO,KAAP,OAAO,QAGlB;AAqCD,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,wCAA0B,CAAA;IAC1B,4CAA8B,CAAA;IAC9B,kCAAoB,CAAA;IACpB,0CAA4B,CAAA;AAC9B,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AA+OD,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,6CAA4B,CAAA;IAC5B,2CAA0B,CAAA;IAC1B,2CAA0B,CAAA;IAC1B,6CAA4B,CAAA;AAC9B,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botonic/core",
-  "version": "0.37.0",
+  "version": "0.38.0-alpha.0",
   "license": "MIT",
   "description": "Build Chatbots using React",
   "main": "./lib/cjs/index.js",

package/src/models/ai-agents.ts

@@ -0,0 +1,54 @@
+export interface BaseMessage {
+  type: 'text' | 'textWithButtons' | 'carousel' | 'exit'
+}
+
+export interface TextMessage extends BaseMessage {
+  type: 'text'
+  content: {
+    text: string
+  }
+}
+
+export interface TextWithButtonsMessage extends BaseMessage {
+  type: 'textWithButtons'
+  content: {
+    text: string
+    buttons: string[]
+  }
+}
+
+interface CarouselElement {
+  title: string
+  subtitle: string
+  image: string
+  button: { text: string; url: string }
+}
+
+export interface CarouselMessage extends BaseMessage {
+  type: 'carousel'
+  content: {
+    elements: CarouselElement[]
+  }
+}
+
+export interface ExitMessage extends BaseMessage {
+  type: 'exit'
+}
+
+export type OutputMessage =
+  | TextMessage
+  | TextWithButtonsMessage
+  | CarouselMessage
+  | ExitMessage
+
+export type AgenticOutputMessage = Exclude<OutputMessage, ExitMessage>
+
+export interface RunResult {
+  messages: AgenticOutputMessage[]
+  toolsExecuted: string[]
+  exit: boolean
+  inputGuardrailTriggered: string[]
+  outputGuardrailTriggered: string[]
+}
+
+export type InferenceResponse = RunResult | undefined