@botonic/plugin-flow-builder 0.40.0-alpha.3 → 0.41.0-alpha.0

package/lib/esm/types.d.ts

@@ -1,4 +1,4 @@
-import { BotContext, InferenceResponse, KnowledgeBasesResponse, PluginPreRequest, ResolvedPlugins } from '@botonic/core';
+import { AiAgentArgs, BotContext, GuardrailRule, InferenceResponse, KnowledgeBasesResponse, PluginPreRequest, ResolvedPlugins } from '@botonic/core';
 import { FlowContent } from './content-fields';
 import { HtFlowBuilderData, HtRatingButton } from './content-fields/hubtype-fields';
 export interface InShadowingConfig {
@@ -25,18 +25,6 @@ export interface BotonicPluginFlowBuilderOptions<TPlugins extends ResolvedPlugin
 export type TrackEventFunction<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = any> = (request: BotContext<TPlugins, TExtraData>, eventAction: string, args?: Record<string, any>) => Promise<void>;
 export type KnowledgeBaseFunction<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = any> = (request: BotContext<TPlugins, TExtraData>, sources: string[], instructions: string, messageId: string, memoryLength: number) => Promise<KnowledgeBasesResponse>;
 export type AiAgentFunction<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = any> = (request: BotContext<TPlugins, TExtraData>, aiAgentArgs: AiAgentArgs) => Promise<InferenceResponse>;
-export interface GuardrailRule {
-    name: string;
-    description: string;
-}
-export interface AiAgentArgs {
-    name: string;
-    instructions: string;
-    activeTools?: {
-        name: string;
-    }[];
-    inputGuardrailRules?: GuardrailRule[];
-}
 export type ContentFilter<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = any> = (request: BotContext<TPlugins, TExtraData>, content: FlowContent) => Promise<FlowContent> | FlowContent;
 export interface FlowBuilderApiOptions {
     url: string;
@@ -70,3 +58,4 @@ export interface RatingSubmittedInfo extends HtRatingButton {
     possibleOptions: string[];
     possibleValues: number[];
 }
+export { AiAgentArgs, GuardrailRule };

package/lib/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AA6FA,MAAM,CAAN,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC5B,+CAAyB,CAAA;IACzB,iDAA2B,CAAA;AAC7B,CAAC,EAHW,kBAAkB,KAAlB,kBAAkB,QAG7B;AAED,MAAM,CAAN,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,yCAAe,CAAA;IACf,2CAAiB,CAAA;AACnB,CAAC,EAHW,sBAAsB,KAAtB,sBAAsB,QAGjC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAoFA,MAAM,CAAN,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC5B,+CAAyB,CAAA;IACzB,iDAA2B,CAAA;AAC7B,CAAC,EAHW,kBAAkB,KAAlB,kBAAkB,QAG7B;AAED,MAAM,CAAN,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,yCAAe,CAAA;IACf,2CAAiB,CAAA;AACnB,CAAC,EAHW,sBAAsB,KAAtB,sBAAsB,QAGjC"}

package/lib/esm/user-input/keyword.js

@@ -1,7 +1,7 @@
 import { __awaiter, __rest } from "tslib";
 import { EventAction, NluType } from '@botonic/core';
 import { REG_EXP_PATTERN } from '../constants';
-import { trackEvent } from '../tracking';
+import { getCommonFlowContentEventArgsForContentId, trackEvent, } from '../tracking';
 export class KeywordMatcher {
     constructor({ cmsApi, locale, request }) {
         this.cmsApi = cmsApi;
@@ -63,11 +63,14 @@ export class KeywordMatcher {
     }
     trackKeywordEvent() {
         return __awaiter(this, void 0, void 0, function* () {
+            const { flowId, flowName, flowNodeId, flowNodeContentId } = getCommonFlowContentEventArgsForContentId(this.request, this.keywordNodeId);
             const event = {
                 action: EventAction.Keyword,
+                flowNodeId,
+                flowId,
+                flowName,
+                flowNodeContentId,
                 flowThreadId: this.request.session.flow_thread_id,
-                flowNodeId: this.keywordNodeId,
-                flowId: this.flowId,
                 nluKeywordName: this.matchedKeyword,
                 nluKeywordIsRegex: this.isRegExp,
                 nluKeywordMessageId: this.request.input.message_id,

package/lib/esm/user-input/keyword.js.map

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

package/lib/esm/user-input/smart-intent.js

@@ -2,7 +2,7 @@ import { __awaiter, __rest } from "tslib";
 import { EventAction, NluType } from '@botonic/core';
 import axios from 'axios';
 import { getFlowBuilderPlugin } from '../helpers';
-import { trackEvent } from '../tracking';
+import { getCommonFlowContentEventArgsForContentId, trackEvent, } from '../tracking';
 export class SmartIntentsApi {
     constructor(cmsApi, currentRequest, smartIntentsConfig, flowId) {
         this.cmsApi = cmsApi;
@@ -33,6 +33,7 @@ export class SmartIntentsApi {
                         matchedValue: smartIntentNode.content.title,
                         payload: targetPayload,
                     };
+                    const { flowId, flowName, flowNodeId, flowNodeContentId } = getCommonFlowContentEventArgsForContentId(this.currentRequest, smartIntentNode.id);
                     const event = {
                         action: EventAction.IntentSmart,
                         nluIntentSmartTitle: response.data.smart_intent_title,
@@ -40,8 +41,10 @@ export class SmartIntentsApi {
                         nluIntentSmartMessageId: this.currentRequest.input.message_id,
                         userInput: this.currentRequest.input.data,
                         flowThreadId: this.currentRequest.session.flow_thread_id,
-                        flowId: smartIntentNode.flow_id,
-                        flowNodeId: smartIntentNode.id,
+                        flowId,
+                        flowName,
+                        flowNodeContentId,
+                        flowNodeId,
                     };
                     const { action } = event, eventArgs = __rest(event, ["action"]);
                     yield trackEvent(this.currentRequest, action, eventArgs);

package/lib/esm/user-input/smart-intent.js.map

@@ -1 +1 @@
-{"version":3,"file":"smart-intent.js","sourceRoot":"","sources":["../../../src/user-input/smart-intent.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAoB,OAAO,EAAE,MAAM,eAAe,CAAA;AAEtE,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAexC,MAAM,OAAO,eAAe;IAC1B,YACS,MAAsB,EACtB,cAA6B,EAC7B,kBAA+C,EAC/C,MAAe;QAHf,WAAM,GAAN,MAAM,CAAgB;QACtB,mBAAc,GAAd,cAAc,CAAe;QAC7B,uBAAkB,GAAlB,kBAAkB,CAA6B;QAC/C,WAAM,GAAN,MAAM,CAAS;IACrB,CAAC;IAEE,cAAc;;YAClB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAA;YACrD,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAA;YAC1D,IAAI,CAAC,gBAAgB,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAA;YAE9C,MAAM,MAAM,GAAG;gBACb,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBAC1C,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI;gBACpC,wBAAwB,EAAE,IAAI,CAAC,kBAAkB,CAAC,oBAAoB;gBACtE,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE;aACpC,CAAA;YAED,IAAI;gBACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;gBAChD,MAAM,eAAe,GAAG,gBAAgB,CAAC,IAAI,CAC3C,eAAe,CAAC,EAAE,CAChB,eAAe,CAAC,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CACrE,CAAA;gBAED,IAAI,eAAe,EAAE;oBACnB,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAA;oBACpE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,aAAa,GAAG;wBACxC,IAAI,EAAE,OAAO,CAAC,WAAW;wBACzB,YAAY,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK;wBAC3C,OAAO,EAAE,aAAa;qBACvB,CAAA;oBAED,MAAM,KAAK,GAAqB;wBAC9B,MAAM,EAAE,WAAW,CAAC,WAAW;wBAC/B,mBAAmB,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB;wBACrD,qBAAqB,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM;wBAC9D,uBAAuB,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,UAAU;wBAC7D,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI;wBACzC,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,cAAwB;wBAClE,MAAM,EAAE,eAAe,CAAC,OAAO;wBAC/B,UAAU,EAAE,eAAe,CAAC,EAAE;qBAC/B,CAAA;oBACD,MAAM,EAAE,MAAM,KAAmB,KAAK,EAAnB,SAAS,UAAK,KAAK,EAAhC,UAAwB,CAAQ,CAAA;oBAEtC,MAAM,UAAU,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;oBAExD,OAAO,eAAe,CAAA;iBACvB;aACF;YAAC,OAAO,CAAC,EAAE;gBACV,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;aACjB;YACD,OAAO,SAAS,CAAA;QAClB,CAAC;KAAA;IAEO,gBAAgB;QACtB,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,mBAAmB;YAAE,OAAO,KAAK,CAAA;QACjE,OAAO,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAA;IAC1C,CAAC;IAEa,YAAY,CACxB,eAA4C;;YAE5C,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;YAC3E,MAAM,KAAK,GAAG,iBAAiB,CAAC,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;YAE3E,OAAO,MAAM,KAAK,CAAC;gBACjB,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,0CAA0C;gBAC7E,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,KAAK,EAAE;oBAChC,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,KAAK;aACf,CAAC,CAAA;QACJ,CAAC;KAAA;CACF"}
+{"version":3,"file":"smart-intent.js","sourceRoot":"","sources":["../../../src/user-input/smart-intent.ts"],"names":[],"mappings":"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"}

package/lib/esm/utils.js

@@ -18,7 +18,7 @@ export function resolveGetAccessToken(getAccessToken) {
     }
 }
 export function getValueFromKeyPath(request, keyPath) {
-    if (keyPath.startsWith('input') || keyPath.startsWith('session')) {
+    if (keyPath.startsWith('input.') || keyPath.startsWith('session.')) {
         return keyPath
             .split('.')
             .reduce((object, key) => resolveObjectKey(object, key), request);

package/lib/esm/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,eAAe,CAAA;AAGrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAqB,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAE/D,SAAS,yBAAyB,CAAC,OAAgB;IACjD,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;QAC1B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;KACpD;IACD,OAAO,OAAO,CAAC,aAAa,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,cAA4C;IAE5C,QAAQ,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE;QAC5B,KAAK,kBAAkB,CAAC,UAAU;YAChC,OAAO,yBAAyB,CAAA;QAClC,KAAK,kBAAkB,CAAC,WAAW;YACjC,OAAO,cAAc,CAAA;QACvB;YACE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;KAChE;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAsB,EACtB,OAAe;IAEf,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;QAChE,OAAO,OAAO;aACX,KAAK,CAAC,GAAG,CAAC;aACV,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAA;KACnE;IAED,OAAO,OAAO;SACX,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CACL,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9C,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAChC,CAAA;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAW,EAAE,GAAW;IAChD,IAAI,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;QACvC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;KACnB;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAA;AAC9D,CAAC;AAED,SAAS,YAAY,CACnB,OAAsB,EACtB,OAAgC;IAEhC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IACrD,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/D,OAAO,CAAC,SAAS,IAAI,CAAC,SAAS,IAAI,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;AAC5E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAsB;IACtD,OAAO,YAAY,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAsB;IAC1D,OAAO,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAsB;IAC5D,OAAO,YAAY,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAA;AACrD,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,eAAe,CAAA;AAGrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAqB,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAE/D,SAAS,yBAAyB,CAAC,OAAgB;IACjD,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;QAC1B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;KACpD;IACD,OAAO,OAAO,CAAC,aAAa,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,cAA4C;IAE5C,QAAQ,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE;QAC5B,KAAK,kBAAkB,CAAC,UAAU;YAChC,OAAO,yBAAyB,CAAA;QAClC,KAAK,kBAAkB,CAAC,WAAW;YACjC,OAAO,cAAc,CAAA;QACvB;YACE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;KAChE;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAsB,EACtB,OAAe;IAEf,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QAClE,OAAO,OAAO;aACX,KAAK,CAAC,GAAG,CAAC;aACV,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAA;KACnE;IAED,OAAO,OAAO;SACX,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CACL,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9C,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAChC,CAAA;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAW,EAAE,GAAW;IAChD,IAAI,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;QACvC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;KACnB;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAA;AAC9D,CAAC;AAED,SAAS,YAAY,CACnB,OAAsB,EACtB,OAAgC;IAEhC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IACrD,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/D,OAAO,CAAC,SAAS,IAAI,CAAC,SAAS,IAAI,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;AAC5E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAsB;IACtD,OAAO,YAAY,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAsB;IAC1D,OAAO,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAsB;IAC5D,OAAO,YAAY,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAA;AACrD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botonic/plugin-flow-builder",
-  "version": "0.40.0-alpha.3",
+  "version": "0.41.0-alpha.0",
   "main": "./lib/cjs/index.js",
   "module": "./lib/esm/index.js",
   "description": "Use Flow Builder to show your contents",
@@ -14,8 +14,8 @@
     "lint_core": "../../node_modules/.bin/eslint_d --cache --quiet 'src/**/*.ts*'"
   },
   "dependencies": {
-    "@botonic/react": "^0.40.0-alpha.0",
-    "axios": "^1.10.0",
+    "@botonic/react": "0.41.0-alpha.0",
+    "axios": "^1.12.2",
     "uuid": "^10.0.0"
   },
   "repository": {
@@ -32,7 +32,7 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=20.0.0",
+    "node": ">=22.19.0",
     "npm": ">=10.0.0"
   },
   "keywords": [

package/src/action/ai-agent.ts

@@ -49,6 +49,7 @@ export async function getContentsByAiAgent({
       instructions: aiAgentContent.instructions,
       activeTools: aiAgentContent.activeTools,
       inputGuardrailRules: activeInputGuardrailRules,
+      sourceIds: aiAgentContent.sources?.map(source => source.id),
     }
   )
 

package/src/action/fallback.ts

@@ -3,7 +3,10 @@ import { ActionRequest } from '@botonic/react'
 
 import { FlowBuilderApi } from '../api'
 import { FlowContent } from '../content-fields'
-import { trackEvent } from '../tracking'
+import {
+  getCommonFlowContentEventArgsForContentId,
+  trackEvent,
+} from '../tracking'
 import { FlowBuilderContext } from './index'
 
 export async function getContentsByFallback({
@@ -31,8 +34,15 @@ async function getFallbackNode(cmsApi: FlowBuilderApi, request: ActionRequest) {
   const fallbackNode = cmsApi.getFallbackNode(isFirstFallbackOption)
   request.session.user.extra_data.isFirstFallbackOption = !isFirstFallbackOption
 
+  const { flowId, flowName, flowNodeId, flowNodeContentId } =
+    getCommonFlowContentEventArgsForContentId(request, fallbackNode.id)
+
   const event: EventFallback = {
     action: EventAction.Fallback,
+    flowId,
+    flowName,
+    flowNodeId,
+    flowNodeContentId,
     userInput: request.input.data as string,
     fallbackOut: isFirstFallbackOption ? 1 : 2,
     fallbackMessageId: request.input.message_id,

package/src/action/index.tsx

@@ -9,7 +9,7 @@ import {
 import React from 'react'
 
 import { FlowBuilderApi } from '../api'
-import { DO_NOTHING_PAYLOAD } from '../constants'
+import { EMPTY_PAYLOAD } from '../constants'
 import { FlowContent, FlowHandoff } from '../content-fields'
 import { FlowBotAction } from '../content-fields/flow-bot-action'
 import { ContentFilterExecutor } from '../filters'
@@ -126,11 +126,7 @@ async function getContents(
     return []
   }
 
-  if (request.input.payload?.startsWith(DO_NOTHING_PAYLOAD)) {
-    request.input.payload = undefined
-  }
-
-  if (request.input.payload?.startsWith('AI_AGENT_PAYLOAD_')) {
+  if (request.input.payload?.startsWith(EMPTY_PAYLOAD)) {
     request.input.payload = undefined
   }
 

package/src/action/knowledge-bases.ts

@@ -12,9 +12,10 @@ import {
   FlowContent,
   FlowKnowledgeBase,
 } from '../content-fields'
-import { HtNodeWithContent } from '../content-fields/hubtype-fields/nodes'
-import { getFlowBuilderPlugin } from '../helpers'
-import { trackEvent } from '../tracking'
+import {
+  getCommonFlowContentEventArgsForContentId,
+  trackEvent,
+} from '../tracking'
 import { KnowledgeBaseFunction } from '../types'
 import { inputHasTextData, isKnowledgeBasesAllowed } from '../utils'
 import { FlowBuilderContext } from './index'
@@ -121,11 +122,6 @@ async function trackKnowledgeBase(
   request: BotContext,
   knowledgeBaseContent: FlowKnowledgeBase
 ) {
-  const flowBuilderPlugin = getFlowBuilderPlugin(request.plugins)
-  const flowId = flowBuilderPlugin.cmsApi.getNodeById<HtNodeWithContent>(
-    knowledgeBaseContent.id
-  ).flow_id
-
   const getKnowledgeFailReason = (): KnowledgebaseFailReason | undefined => {
     let knowledgebaseFailReason: KnowledgebaseFailReason | undefined
 
@@ -139,6 +135,9 @@ async function trackKnowledgeBase(
     return knowledgebaseFailReason
   }
 
+  const { flowId, flowName, flowNodeId, flowNodeContentId } =
+    getCommonFlowContentEventArgsForContentId(request, knowledgeBaseContent.id)
+
   const event: EventKnowledgeBase = {
     action: EventAction.Knowledgebase,
     knowledgebaseInferenceId: response.inferenceId,
@@ -150,8 +149,10 @@ async function trackKnowledgeBase(
     knowledgebaseMessageId: request.input.message_id,
     userInput: request.input.data as string,
     flowThreadId: request.session.flow_thread_id as string,
-    flowId: flowId,
-    flowNodeId: knowledgeBaseContent.id,
+    flowId,
+    flowName,
+    flowNodeId,
+    flowNodeContentId,
   }
 
   const { action, ...eventArgs } = event

package/src/constants.ts

@@ -2,7 +2,7 @@ export const FLOW_BUILDER_API_URL_PROD =
   process.env.HUBTYPE_API_URL || 'https://api.hubtype.com'
 export const SEPARATOR = '|'
 export const SOURCE_INFO_SEPARATOR = `${SEPARATOR}source_`
-export const DO_NOTHING_PAYLOAD = 'fb-do-nothing'
+export const EMPTY_PAYLOAD = 'fb-empty-payload'
 export const VARIABLE_PATTERN = /{([^}]+)}/g
 export const ACCESS_TOKEN_VARIABLE_KEY = '_access_token'
 export const REG_EXP_PATTERN = /^\/(.*)\/([gimyus]*)$/

package/src/content-fields/flow-ai-agent.tsx

@@ -1,6 +1,7 @@
 import { AgenticOutputMessage } from '@botonic/core'
 import { Button, Carousel, Text } from '@botonic/react'
 
+import { EMPTY_PAYLOAD, SOURCE_INFO_SEPARATOR } from '../constants'
 import { ContentFieldsBase } from './content-fields-base'
 import { FlowElement } from './flow-element'
 import { HtAiAgentNode, HtInputGuardrailRule } from './hubtype-fields/ai-agent'
@@ -11,6 +12,7 @@ export class FlowAiAgent extends ContentFieldsBase {
   public instructions: string = ''
   public activeTools?: { name: string }[]
   public inputGuardrailRules: HtInputGuardrailRule[]
+  public sources?: { id: string; name: string }[]
 
   public responses: AgenticOutputMessage[] = []
 
@@ -21,6 +23,7 @@ export class FlowAiAgent extends ContentFieldsBase {
     newAiAgent.activeTools = component.content.active_tools
     newAiAgent.inputGuardrailRules =
       component.content.input_guardrail_rules || []
+    newAiAgent.sources = component.content.sources
     return newAiAgent
   }
 
@@ -36,14 +39,16 @@ export class FlowAiAgent extends ContentFieldsBase {
             return (
               <Text key={id}>
                 {response.content.text}
-                {response.content.buttons.map((button, buttonIndex) => (
-                  <Button
-                    key={buttonIndex}
-                    payload={`AI_AGENT_PAYLOAD_${buttonIndex}`}
-                  >
-                    {button}
-                  </Button>
-                ))}
+                {response.content.buttons.map((button, buttonIndex) => {
+                  return (
+                    <Button
+                      key={buttonIndex}
+                      payload={`${EMPTY_PAYLOAD}${SOURCE_INFO_SEPARATOR}${buttonIndex}`}
+                    >
+                      {button.text}
+                    </Button>
+                  )
+                })}
               </Text>
             )
           }

package/src/content-fields/flow-element.tsx

@@ -1,5 +1,5 @@
+import { Button } from '@botonic/core'
 import { Element, Pic, Subtitle, Title } from '@botonic/react'
-import React from 'react'
 
 import { FlowBuilderApi } from '../api'
 import { ContentFieldsBase } from './content-fields-base'
@@ -36,7 +36,7 @@ export class FlowElement extends ContentFieldsBase {
       title: string
       subtitle: string
       image: string
-      button: { text: string; url: string }
+      button: Button
     }
   ) {
     const newElement = new FlowElement(id)

package/src/content-fields/flow-handoff.tsx

@@ -1,8 +1,8 @@
 import { HandOffBuilder, HelpdeskEvent, isDev, isWebchat } from '@botonic/core'
 import { ActionRequest, WebchatSettings } from '@botonic/react'
-import React from 'react'
 
 import { FlowBuilderApi } from '../api'
+import { getCommonFlowContentEventArgsForContentId } from '../tracking'
 import { ContentFieldsBase } from './content-fields-base'
 import { HtHandoffNode, HtQueueLocale } from './hubtype-fields'
 
@@ -56,13 +56,19 @@ export class FlowHandoff extends ContentFieldsBase {
 
     if (this.queue) {
       const language = request.getSystemLocale()
-      const country = request.getUserCountry()
 
       handOffBuilder.withQueue(this.queue.id)
+
+      const { flowId, flowName, flowNodeId, flowNodeContentId } =
+        getCommonFlowContentEventArgsForContentId(request, this.id)
+
       handOffBuilder.withBotEvent({
-        language,
-        country,
+        flowId,
+        flowName,
+        flowNodeId,
+        flowNodeContentId,
       })
+
       handOffBuilder.withExtraData({
         language,
       })

package/src/content-fields/flow-rating.tsx

@@ -72,6 +72,7 @@ export class FlowRating extends ContentFieldsBase {
 
       return (
         <CustomRatingMessage
+          alt={this.text}
           payloads={payloads}
           messageText={this.text}
           buttonText={this.sendButtonText}

package/src/content-fields/hubtype-fields/ai-agent.ts

@@ -14,5 +14,6 @@ export interface HtAiAgentNode extends HtBaseNode {
     instructions: string
     active_tools?: { name: string }[]
     input_guardrail_rules?: HtInputGuardrailRule[]
+    sources?: { id: string; name: string }[]
   }
 }

package/src/index.ts

@@ -1,6 +1,8 @@
 import {
+  INPUT,
   Plugin,
   PluginPreRequest,
+  PROVIDER,
   ResolvedPlugins,
   Session,
 } from '@botonic/core'
@@ -9,6 +11,7 @@ import { v7 as uuidv7 } from 'uuid'
 
 import { FlowBuilderApi } from './api'
 import {
+  EMPTY_PAYLOAD,
   FLOW_BUILDER_API_URL_PROD,
   SEPARATOR,
   SOURCE_INFO_SEPARATOR,
@@ -105,6 +108,9 @@ export default class BotonicPluginFlowBuilder implements Plugin {
   }
 
   async pre(request: PluginPreRequest): Promise<void> {
+    // When AI Agent is executed in Whatsapp, button payloads come as referral and must be converted to text being processed by the agent.
+    this.convertWhatsappAiAgentEmptyPayloads(request)
+
     this.currentRequest = request
     this.cmsApi = await FlowBuilderApi.create({
       flowUrl: this.resolveFlowUrl(request),
@@ -114,12 +120,8 @@ export default class BotonicPluginFlowBuilder implements Plugin {
       request: this.currentRequest,
     })
 
-    const checkAiAgentPayload =
-      request.input.payload?.startsWith('AI_AGENT_PAYLOAD_')
-
-    const checkPayload = !request.input.payload || checkAiAgentPayload
-
-    const checkUserTextInput = inputHasTextData(request.input) && checkPayload
+    const checkUserTextInput =
+      inputHasTextData(request.input) && !request.input.payload
 
     if (checkUserTextInput) {
       const resolvedLocale = this.cmsApi.getResolvedLocale()
@@ -135,6 +137,19 @@ export default class BotonicPluginFlowBuilder implements Plugin {
     this.updateRequestBeforeRoutes(request)
   }
 
+  private convertWhatsappAiAgentEmptyPayloads(request: PluginPreRequest): void {
+    if (request.session.user.provider === PROVIDER.WHATSAPP) {
+      const shouldUseReferral =
+        request.input.referral &&
+        request.input.payload?.startsWith(EMPTY_PAYLOAD)
+
+      if (shouldUseReferral) {
+        request.input.type = INPUT.TEXT
+        request.input.data = request.input.referral
+      }
+    }
+  }
+
   private updateRequestBeforeRoutes(request: PluginPreRequest): void {
     if (request.input.payload) {
       request.input.payload = this.removeSourceSuffix(request.input.payload)

package/src/tracking.ts

@@ -44,18 +44,52 @@ function getContentEventArgs(
   request: ActionRequest,
   nodeContent: HtNodeWithContent
 ): EventFlow {
-  const flowBuilderPlugin = getFlowBuilderPlugin(request.plugins)
-  const flowName = flowBuilderPlugin.getFlowName(nodeContent.flow_id)
+  const { flowId, flowName, flowNodeId, flowNodeContentId } =
+    getCommonFlowContentEventArgs(request, nodeContent)
+
   const flowThreadId = request.session.flow_thread_id ?? uuidv7()
   request.session.flow_thread_id = flowThreadId
 
   return {
     action: EventAction.FlowNode,
+    flowId,
+    flowName,
+    flowNodeId,
+    flowNodeContentId,
     flowThreadId,
+    flowNodeIsMeaningful: nodeContent.is_meaningful ?? false,
+  }
+}
+
+type CommonFlowContentEventArgs = {
+  flowId: string
+  flowName: string
+  flowNodeId: string
+  flowNodeContentId: string
+}
+
+function getCommonFlowContentEventArgs(
+  request: ActionRequest,
+  nodeContent: HtNodeWithContent
+): CommonFlowContentEventArgs {
+  const flowBuilderPlugin = getFlowBuilderPlugin(request.plugins)
+  const flowName = flowBuilderPlugin.getFlowName(nodeContent.flow_id)
+
+  return {
     flowId: nodeContent.flow_id,
-    flowName: flowName,
+    flowName,
     flowNodeId: nodeContent.id,
-    flowNodeContentId: nodeContent.code,
-    flowNodeIsMeaningful: nodeContent.is_meaningful ?? false,
+    flowNodeContentId: nodeContent.code ?? '',
   }
 }
+
+export function getCommonFlowContentEventArgsForContentId(
+  request: ActionRequest,
+  contentId: string
+): CommonFlowContentEventArgs {
+  const flowBuilderPlugin = getFlowBuilderPlugin(request.plugins)
+  const cmsApi = flowBuilderPlugin.cmsApi
+  const nodeContent = cmsApi.getNodeById<HtNodeWithContent>(contentId)
+
+  return getCommonFlowContentEventArgs(request, nodeContent)
+}

package/src/types.ts

@@ -1,5 +1,7 @@
 import {
+  AiAgentArgs,
   BotContext,
+  GuardrailRule,
   InferenceResponse,
   KnowledgeBasesResponse,
   PluginPreRequest,
@@ -64,17 +66,6 @@ export type AiAgentFunction<
   aiAgentArgs: AiAgentArgs
 ) => Promise<InferenceResponse>
 
-export interface GuardrailRule {
-  name: string
-  description: string
-}
-
-export interface AiAgentArgs {
-  name: string
-  instructions: string
-  activeTools?: { name: string }[]
-  inputGuardrailRules?: GuardrailRule[]
-}
 export type ContentFilter<
   TPlugins extends ResolvedPlugins = ResolvedPlugins,
   TExtraData = any,
@@ -120,3 +111,5 @@ export interface RatingSubmittedInfo extends HtRatingButton {
   possibleOptions: string[]
   possibleValues: number[]
 }
+
+export { AiAgentArgs, GuardrailRule }

package/src/user-input/keyword.ts

@@ -7,7 +7,10 @@ import {
   HtKeywordNode,
   HtNodeWithContent,
 } from '../content-fields/hubtype-fields'
-import { trackEvent } from '../tracking'
+import {
+  getCommonFlowContentEventArgsForContentId,
+  trackEvent,
+} from '../tracking'
 
 interface KeywordProps {
   cmsApi: FlowBuilderApi
@@ -101,11 +104,19 @@ export class KeywordMatcher {
   }
 
   private async trackKeywordEvent() {
+    const { flowId, flowName, flowNodeId, flowNodeContentId } =
+      getCommonFlowContentEventArgsForContentId(
+        this.request,
+        this.keywordNodeId as string
+      )
+
     const event: EventKeyword = {
       action: EventAction.Keyword,
+      flowNodeId,
+      flowId,
+      flowName,
+      flowNodeContentId,
       flowThreadId: this.request.session.flow_thread_id as string,
-      flowNodeId: this.keywordNodeId as string,
-      flowId: this.flowId as string,
       nluKeywordName: this.matchedKeyword as string,
       nluKeywordIsRegex: this.isRegExp,
       nluKeywordMessageId: this.request.input.message_id,

package/src/user-input/smart-intent.ts

@@ -5,7 +5,10 @@ import axios from 'axios'
 import { FlowBuilderApi } from '../api'
 import { HtSmartIntentNode } from '../content-fields/hubtype-fields/smart-intent'
 import { getFlowBuilderPlugin } from '../helpers'
-import { trackEvent } from '../tracking'
+import {
+  getCommonFlowContentEventArgsForContentId,
+  trackEvent,
+} from '../tracking'
 import { SmartIntentResponse } from '../types'
 
 export interface SmartIntentsInferenceParams {
@@ -55,6 +58,12 @@ export class SmartIntentsApi {
           payload: targetPayload,
         }
 
+        const { flowId, flowName, flowNodeId, flowNodeContentId } =
+          getCommonFlowContentEventArgsForContentId(
+            this.currentRequest,
+            smartIntentNode.id
+          )
+
         const event: EventIntentSmart = {
           action: EventAction.IntentSmart,
           nluIntentSmartTitle: response.data.smart_intent_title,
@@ -62,8 +71,10 @@ export class SmartIntentsApi {
           nluIntentSmartMessageId: this.currentRequest.input.message_id,
           userInput: this.currentRequest.input.data,
           flowThreadId: this.currentRequest.session.flow_thread_id as string,
-          flowId: smartIntentNode.flow_id,
-          flowNodeId: smartIntentNode.id,
+          flowId,
+          flowName,
+          flowNodeContentId,
+          flowNodeId,
         }
         const { action, ...eventArgs } = event
 

package/src/utils.ts

@@ -28,7 +28,7 @@ export function getValueFromKeyPath(
   request: ActionRequest,
   keyPath: string
 ): any {
-  if (keyPath.startsWith('input') || keyPath.startsWith('session')) {
+  if (keyPath.startsWith('input.') || keyPath.startsWith('session.')) {
     return keyPath
       .split('.')
       .reduce((object, key) => resolveObjectKey(object, key), request)