@botonic/nx-plugin 2.25.0 → 2.27.0

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+## 2.27.0 (2026-04-29)
+
+### 🚀 Features
+
+- **webchat-react:** add design system gateway for @lilara/ui-web-react (BLT-2334) ([#859](https://github.com/metis-ai/hubtype-product/pull/859))
+- Hero Header transitions ([#860](https://github.com/metis-ai/hubtype-product/pull/860))
+- **botonic:** session and Hubtype API adaptations (non-webviews) ([#810](https://github.com/metis-ai/hubtype-product/pull/810))
+
+### 🩹 Fixes
+
+- **nx-plugin:** stabilize vitest execution ([#798](https://github.com/metis-ai/hubtype-product/pull/798))
+- **nx-plugin:** inject lilara version into bot-app generator ([#795](https://github.com/metis-ai/hubtype-product/pull/795))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+- Marc Rabat @vanbasten17
+
+## 2.26.0 (2026-03-31)
+
+### 🚀 Features
+
+- **webchat-react:** chat input action bar and contextual send/mic #BLT-2290 ([#788](https://github.com/metis-ai/hubtype-product/pull/788))
+- **botonic:** allow Cloudflare tunnel hostnames in Vite webchat ([#780](https://github.com/metis-ai/hubtype-product/pull/780))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
 ## 2.25.0 (2026-03-27)
 
 This was a version bump only for @botonic/nx-plugin to align it with other projects, there were no code changes.

package/README.md

@@ -37,7 +37,7 @@ nx g @botonic/nx-plugin:bot-app my-bot
 
 #### What it creates:
 
-- **Modern Actions**: Async functions using `BotContext` instead of React class components
+- **Modern Actions**: Async functions using `BotonicContext` instead of React class components
 - **React 18 Webchat**: Uses `@botonic/webchat` with `createRoot` and `StrictMode`
 - **Current Dependencies**: Uses modern Botonic packages and avoids legacy packages
 - **Custom Messages Structure**: Empty structure ready for your custom components
@@ -173,11 +173,11 @@ export class Welcome extends React.Component {
 **After (modern async function):**
 
 ```typescript
-import { BotContext } from '@botonic/core'
+import { BotonicContext } from '@botonic/core'
 import { MessageAction } from '@botonic/shared'
 
-export async function Welcome({ sendMessage }: BotContext) {
-  await sendMessage([
+export async function Welcome({ sendMessages }: BotonicContext) {
+  await sendMessages([
     {
       type: 'text',
       data: { text: "Hello! I'm your bot 🤖\nWelcome to Botonic!" },

package/generators.json

@@ -30,32 +30,6 @@
       "factory": "./src/generators/webview/generator",
       "schema": "./src/generators/webview/schema.json",
       "description": "Create a webview component for Botonic"
-    },
-    "migrate-webchat-trigger": {
-      "factory": "./src/generators/bot-app-migrations/migrate-webchat-trigger/generator",
-      "schema": "./src/generators/bot-app-migrations/migrate-webchat-trigger/schema.json",
-      "description": "Migrate a bot app to use @botonic/webchat-react/trigger lazy-loading entry point",
-      "hidden": true,
-      "x-bot-app-migration": true,
-      "x-introduced-in": "2.18.0",
-      "x-migration-guide": "src/generators/bot-app-migrations/migrate-webchat-trigger/migrate-webchat-trigger.md"
-    },
-    "migrate-fix-css-code-split": {
-      "factory": "./src/generators/bot-app-migrations/migrate-fix-css-code-split/generator",
-      "schema": "./src/generators/bot-app-migrations/migrate-fix-css-code-split/schema.json",
-      "description": "Add cssCodeSplit: false to vite webchat and webviews configs",
-      "hidden": true,
-      "x-bot-app-migration": true,
-      "x-introduced-in": "2.18.0"
-    },
-    "migrate-pnpm-compat": {
-      "factory": "./src/generators/bot-app-migrations/migrate-pnpm-compat/generator",
-      "schema": "./src/generators/bot-app-migrations/migrate-pnpm-compat/schema.json",
-      "description": "Add **/node_modules/** to eslint ignorePatterns and update README npm refs to pnpm",
-      "hidden": true,
-      "x-bot-app-migration": true,
-      "x-introduced-in": "2.18.0",
-      "x-migration-guide": "src/generators/bot-app-migrations/migrate-pnpm-compat/migrate-pnpm-compat.md"
     }
   }
 }

package/migrations.json

@@ -1,40 +1,3 @@
 {
-  "generators": {
-    "add-botonic-update-bots-skill": {
-      "version": "2.17.0",
-      "description": "Add /update-botonic and /update-bot Cursor commands for workspace and per-bot version migrations",
-      "cli": "nx",
-      "implementation": "./src/migrations/add-botonic-update-bots-skill/add-botonic-update-bots-skill.migration"
-    },
-    "sync-pending-bot-migrations": {
-      "version": "2.17.0",
-      "description": "Write .botonic/pending-bot-migrations.json with bot-app generators pending for each bot",
-      "cli": "nx",
-      "implementation": "./src/migrations/sync-pending-bot-migrations/sync-pending-bot-migrations.migration"
-    },
-    "update-pnpm-workspace-scripts": {
-      "version": "2.18.0",
-      "description": "Update find-migration-guides.sh to reference pnpm instead of npm",
-      "cli": "nx",
-      "implementation": "./src/migrations/update-pnpm-workspace-scripts/update-pnpm-workspace-scripts.migration"
-    },
-    "update-cursor-commands-to-stubs": {
-      "version": "2.18.0",
-      "description": "Replace full-content .cursor/commands/*.md with stable stubs that reference the canonical source in node_modules",
-      "cli": "nx",
-      "implementation": "./src/migrations/update-cursor-commands-to-stubs/update-cursor-commands-to-stubs.migration"
-    },
-    "add-lilara-registry": {
-      "version": "2.19.0",
-      "description": "(Legacy) Add @hubtype-lilara:registry for CodeArtifact; run remove-codeartifact-registry (2.23+) for public npm",
-      "cli": "nx",
-      "implementation": "./src/migrations/add-lilara-registry/add-lilara-registry.migration"
-    },
-    "remove-codeartifact-registry": {
-      "version": "2.23.0",
-      "description": "Remove CodeArtifact @botonic / @hubtype-lilara registry and auth lines from .npmrc (switch to public npm)",
-      "cli": "nx",
-      "implementation": "./src/migrations/remove-codeartifact-registry/remove-codeartifact-registry.migration"
-    }
-  }
+  "generators": {}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botonic/nx-plugin",
-  "version": "2.25.0",
+  "version": "2.27.0",
   "description": "Nx plugin for creating Botonic bot applications",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",

package/src/executors/e2e-webchat/botonic-package-publish.spec.ts

@@ -70,12 +70,12 @@ test.describe('Botonic Publish E2E', () => {
     await ensureWebchatOpen(page)
 
     const input = page.locator('textarea').first()
-    const sendButton = page.locator('button[class*="send-button"]').first()
-
     await expect(input).toBeVisible({ timeout: 5000 })
-    await expect(sendButton).toBeVisible()
 
     await input.fill('test message')
+
+    const sendButton = page.getByRole('button', { name: 'Send message' })
+    await expect(sendButton).toBeVisible()
     await sendButton.click()
 
     const messages = page.locator('[class*="message-module"]')

package/src/executors/serve-bot/executor.js

@@ -51,6 +51,77 @@ const colors = {
   dim: "\x1B[2m",
   bold: "\x1B[1m"
 };
+let logFilePath = null;
+function initLogFile(projectRoot) {
+  const logsDir = (0, import_path.join)(projectRoot, ".botonic", "logs");
+  (0, import_fs.mkdirSync)(logsDir, { recursive: true });
+  const logPath = (0, import_path.join)(logsDir, "serve-bot.log");
+  (0, import_fs.writeFileSync)(logPath, "");
+  return logPath;
+}
+function writeToLogFile(line) {
+  if (logFilePath) {
+    try {
+      (0, import_fs.appendFileSync)(logFilePath, `${line}
+`);
+    } catch {
+    }
+  }
+}
+function checkFrontailInstalled(cwd) {
+  try {
+    (0, import_child_process.execSync)("npx --no frontail --help", { stdio: "pipe", cwd });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function startFrontail(logPath, port, cwd) {
+  if (!checkFrontailInstalled(cwd)) {
+    console.warn(`${colors.bold}\u26A0\uFE0F  frontail is not installed.${colors.reset}`);
+    console.warn(
+      `   Run: ${colors.dim}pnpm install${colors.reset} to install dependencies
+`
+    );
+    return null;
+  }
+  const frontailProcess = (0, import_child_process.spawn)(
+    "npx",
+    [
+      "--no",
+      "frontail",
+      "--port",
+      port.toString(),
+      "--theme",
+      "dark",
+      "--lines",
+      "500",
+      "--ui-hide-topbar",
+      logPath
+    ],
+    {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"],
+      detached: false
+    }
+  );
+  frontailProcess.on("error", (error) => {
+    console.error(
+      `${colors.dim}[log-viewer]${colors.reset} Error: ${error.message}`
+    );
+  });
+  return frontailProcess;
+}
+function tryReadWebchatDevPort(projectRoot) {
+  try {
+    const configPath = (0, import_path.join)(projectRoot, "vite", "build.config.ts");
+    const content = (0, import_fs.readFileSync)(configPath, "utf8");
+    const match = content.match(/webchat:\s*\{\s*port:\s*(\d+)/);
+    if (match) return parseInt(match[1], 10);
+  } catch {
+  }
+  return 4201;
+}
 function getAppIdFromEnvFile(projectRoot) {
   const envFilePath = (0, import_path.join)(projectRoot, ".env.local");
   if (!(0, import_fs.existsSync)(envFilePath)) {
@@ -77,9 +148,9 @@ function prefixOutput(stream, prefix, color) {
   const rl = readline.createInterface({ input: stream });
   rl.on("line", (line) => {
     const timestamp = (/* @__PURE__ */ new Date()).toLocaleTimeString("en-US", { hour12: false });
-    console.log(
-      `${colors.dim}${timestamp}${colors.reset} ${color}[${prefix}]${colors.reset} ${line}`
-    );
+    const formattedLine = `${colors.dim}${timestamp}${colors.reset} ${color}[${prefix}]${colors.reset} ${line}`;
+    console.log(formattedLine);
+    writeToLogFile(`${timestamp} [${prefix}] ${line}`);
   });
 }
 function spawnProcess(command, name, color, cwd) {
@@ -134,11 +205,21 @@ async function serveBotExecutor(options, context) {
       `${colors.dim}[lambda] No previous Lambda container to clean up.${colors.reset}`
     );
   }
+  const logViewerEnabled = options.logViewer === true;
+  logFilePath = null;
+  const logViewerPort = options.logViewerPort ?? 9001;
+  const webchatDevPort = tryReadWebchatDevPort(fullProjectRoot);
+  let frontailProcess = null;
+  if (logViewerEnabled) {
+    logFilePath = initLogFile(fullProjectRoot);
+    frontailProcess = startFrontail(logFilePath, logViewerPort, context.root);
+  }
+  const logViewerInfo = logViewerEnabled ? `${colors.dim}Webchat:${colors.reset}       ${colors.bold}http://localhost:${webchatDevPort}/?logs=${logViewerPort}${colors.reset} (with logs panel)
+${colors.dim}Log viewer:${colors.reset}    http://localhost:${logViewerPort}` : "";
   const useTunnel = true;
   const tunnelPort = options.tunnelPort ?? 3001;
   let effectiveLambdaEndpoint = options.lambdaEndpoint;
   let startLambda = !options.skipLambda && !effectiveLambdaEndpoint;
-  let tunnelBotId;
   let tunnelDeployResult;
   if (useTunnel) {
     await (0, import_executor_helpers.ensureHubtypeLoginBeforeTunnel)(context, fullProjectRoot, {
@@ -183,7 +264,6 @@ async function serveBotExecutor(options, context) {
         tunnelUrl,
         { env: options.env, configuration }
       );
-      tunnelBotId = deployResult.botId;
       tunnelDeployResult = {
         targetEnvironment: deployResult.targetEnvironment,
         environmentVariables: deployResult.environmentVariables
@@ -194,6 +274,9 @@ async function serveBotExecutor(options, context) {
   } catch (tunnelError) {
     const msg = tunnelError instanceof Error ? tunnelError.message : String(tunnelError);
     console.error(`\u274C Tunnel flow failed: ${msg}`);
+    if (frontailProcess) {
+      frontailProcess.kill("SIGTERM");
+    }
     return { success: false };
   }
   let effectiveAppId = appId;
@@ -206,14 +289,6 @@ async function serveBotExecutor(options, context) {
   }
   if (configuration !== "local" && effectiveAppId) {
     await (0, import_executor_helpers.writeAppIdToEnvFile)(fullProjectRoot, effectiveAppId, configuration);
-    if (tunnelBotId) {
-      (0, import_executor_helpers.writeEnvVarToEnvFile)(
-        fullProjectRoot,
-        "VITE_HUBTYPE_BOT_ID",
-        tunnelBotId,
-        configuration
-      );
-    }
   }
   const useExternalLambda = Boolean(effectiveLambdaEndpoint);
   if (!useTunnel) {
@@ -227,6 +302,7 @@ ${colors.bold}\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
 ${colors.dim}Project:${colors.reset}       ${context.projectName}
 ${colors.dim}Configuration:${colors.reset} ${configuration}
 ${colors.dim}App ID:${colors.reset}        ${effectiveAppId}
+${logViewerInfo}
 ${useExternalLambda ? `${colors.dim}Lambda (external):${colors.reset} ${effectiveLambdaEndpoint}
 ` : ""}
 ${colors.bot}[bot]${colors.reset}      - Node/Lambda build watcher
@@ -264,13 +340,13 @@ ${colors.webviews}[webviews]${colors.reset} - Webviews Vite dev server
     }
     const noOpenEnv = options.open === false ? "VITE_SERVE_OPEN=false " : "";
     const viteEnvAppId = `VITE_HUBTYPE_APP_ID=${effectiveAppId}`;
-    const viteEnvBotId = tunnelBotId != null ? ` VITE_HUBTYPE_BOT_ID=${tunnelBotId}` : "";
-    const webchatCommand = `${noOpenEnv}${viteEnvAppId}${viteEnvBotId} TARGET_APP=webchat MODE=${configuration} vite --config ${configPath}`;
+    const logViewerEnv = logViewerEnabled ? `LOG_VIEWER_PORT=${logViewerPort} ` : "";
+    const webchatCommand = `${noOpenEnv}${logViewerEnv}${viteEnvAppId} TARGET_APP=webchat MODE=${configuration} vite --config ${configPath}`;
     processes.push(
       spawnProcess(webchatCommand, "webchat", colors.webchat, fullProjectRoot)
     );
     if (!options.skipWebviews) {
-      const webviewsCommand = `${noOpenEnv}${viteEnvAppId}${viteEnvBotId} TARGET_APP=webviews MODE=${configuration} vite --config ${configPath}`;
+      const webviewsCommand = `${noOpenEnv}${viteEnvAppId} TARGET_APP=webviews MODE=${configuration} vite --config ${configPath}`;
       processes.push(
         spawnProcess(
           webviewsCommand,
@@ -292,6 +368,12 @@ ${colors.bold}\u{1F6D1} Shutting down all processes...${colors.reset}`
         console.log(`${color}[${name}]${colors.reset} Stopping...`);
         proc.kill("SIGTERM");
       });
+      if (frontailProcess) {
+        console.log(
+          `${colors.dim}[log-viewer]${colors.reset} Stopping log viewer...`
+        );
+        frontailProcess.kill("SIGTERM");
+      }
     };
     process.on("SIGINT", cleanup);
     process.on("SIGTERM", cleanup);

package/src/executors/serve-bot/schema.json

@@ -34,6 +34,16 @@
       "type": "number",
       "description": "Local port the Lambda listens on (used for cloudflared --url). Default 3001.",
       "default": 3001
+    },
+    "logViewer": {
+      "type": "boolean",
+      "description": "When true, start a web-based log viewer (frontail) and open webchat with an embedded logs panel.",
+      "default": false
+    },
+    "logViewerPort": {
+      "type": "number",
+      "description": "Port for the log viewer web interface",
+      "default": 9001
     }
   },
   "required": []

package/src/generators/action/files/__name__.spec.ts.template

@@ -3,13 +3,13 @@ import { describe, expect, it, vi } from 'vitest'
 import { <%= className %> } from './<%= fileName %>'
 
 describe('<%= className %>', () => {
-  it('should call sendMessage and return OK', async () => {
-    const sendMessage = vi.fn().mockResolvedValue(undefined)
-    const mockContext = { sendMessage } as any
+  it('should call sendMessages and return OK', async () => {
+    const sendMessages = vi.fn().mockResolvedValue(undefined)
+    const mockContext = { sendMessages } as any
 
     const result = await <%= className %>(mockContext)
 
-    expect(sendMessage).toHaveBeenCalledOnce()
+    expect(sendMessages).toHaveBeenCalledOnce()
     expect(result).toEqual({ status: 200, response: 'OK' })
   })
 })

package/src/generators/action/files/__name__.ts.template

@@ -1,12 +1,12 @@
-import { BotContext, BotServerMessageFactory } from '@botonic/shared'
+import { BotonicContext, BotServerMessageFactory } from '@botonic/shared'
 
-export async function <%= className %>({ sendMessage }: BotContext) {
+export async function <%= className %>({ sendMessages }: BotonicContext) {
   // TODO: Implement your action logic here
-  await sendMessage(
+  await sendMessages([
     BotServerMessageFactory.createText({
       text: 'Hello from <%= className %>!',
-    })
-  )
+    }),
+  ])
 
   return {
     status: 200,

package/src/generators/action/generator.js

@@ -80,7 +80,7 @@ function updateRoutes(tree, options) {
   (0, import_bot_app_utils.insertRouteBeforeFlowBuilder)(tree, options.routesPath, [
     `    {`,
     `      text: '${options.resolvedRouteMatcher}',`,
-    `      action: async () => await ${options.className}(botContext),`,
+    `      action: async () => await ${options.className}(botonicContext),`,
     `    },`
   ]);
 }

package/src/generators/bot-app/files/.eslintrc.json.template

@@ -4,7 +4,36 @@
   "overrides": [
     {
       "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
-      "rules": {}
+      "rules": {
+        "no-restricted-imports": [
+          "warn",
+          {
+            "paths": [
+              {
+                "name": "@lilara/ui-web-react",
+                "message": "Import UI components from '@botonic/webchat-react' instead of '@lilara/ui-web-react'."
+              },
+              {
+                "name": "@lilara/ui-web",
+                "message": "Import UI components from '@botonic/webchat-react' instead of '@lilara/ui-web'."
+              }
+            ],
+            "patterns": [
+              {
+                "group": [
+                  "@lilara/ui-web-react/*",
+                  "!@lilara/ui-web-react/styles.css"
+                ],
+                "message": "Import UI components from '@botonic/webchat-react' instead of '@lilara/ui-web-react'."
+              },
+              {
+                "group": ["@lilara/ui-web/*"],
+                "message": "Import UI components from '@botonic/webchat-react' instead of '@lilara/ui-web'."
+              }
+            ]
+          }
+        ]
+      }
     },
     {
       "files": ["*.ts", "*.tsx"],

package/src/generators/bot-app/files/src/client/webchat/index.tsx.template

@@ -41,12 +41,7 @@ function App({
   options: WebchatOptions
 }) {
   // Default avatar SVG
-  const defaultAvatarSvg = `<svg xmlns="http://www.w3.org/2000/svg" width="17" height="18" viewBox="0 0 17 18" fill="none">
-    <circle cx="8.5" cy="9" r="8.5" fill="#24252C"/>
-    <path d="M5.9647 5.03898C5.9647 4.61514 5.80479 4.45386 5.36004 4.45386C4.90405 4.45386 4.74414 4.61639 4.74414 5.03898C4.74414 5.46281 4.90405 5.6241 5.36004 5.6241C5.80479 5.6241 5.9647 5.46281 5.9647 5.03898Z" fill="white"/>
-    <path d="M11.1872 4.45386C10.7312 4.45386 10.5713 4.61639 10.5713 5.03898C10.5713 5.46281 10.7312 5.6241 11.1872 5.6241C11.6307 5.6241 11.7919 5.46156 11.7919 5.03898C11.7906 4.61514 11.6307 4.45386 11.1872 4.45386Z" fill="white"/>
-    <path d="M10.99 6.47729H10.7063C10.4352 6.47729 10.3365 6.60233 10.2503 6.99995L9.32574 10.8498C9.15332 11.4975 8.95591 11.6726 8.40117 11.6726H8.13005C7.5878 11.6726 7.3779 11.4988 7.20548 10.8498L6.28092 6.99995C6.19471 6.60108 6.1085 6.47729 5.83737 6.47729H5.55376C5.30762 6.47729 5.19643 6.6636 5.29513 7.04996L6.37962 11.2112C6.56453 11.9339 6.93436 12.2953 7.56406 12.4315C7.72399 12.4691 7.8102 12.5566 7.8102 12.7304V14.5884C7.8102 14.7997 7.94638 14.9373 8.15504 14.9373H8.38993C8.58733 14.9373 8.73476 14.7997 8.73476 14.5884V12.7316C8.73476 12.5566 8.82097 12.4703 8.9809 12.4328C9.59686 12.2953 9.96793 11.9339 10.1641 11.2124L11.2486 7.05121C11.3473 6.66485 11.2361 6.47729 10.99 6.47729Z" fill="white"/>
-  </svg>`
+  const defaultAvatarSvg = `<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg"><rect width="16" height="16" rx="6" fill="#24252C"/><rect x="0.2" y="0.2" width="15.6" height="15.6" rx="5.8" stroke="white" stroke-opacity="0.2" stroke-width="0.4"/><path d="M7.94153 11.5381C8.09581 11.5381 8.20905 11.5664 8.28235 11.6396C8.35546 11.7129 8.38095 11.8235 8.38098 11.9688C8.38098 12.1147 8.35354 12.2258 8.27942 12.2988C8.20522 12.3717 8.09189 12.3994 7.94153 12.3994C7.78327 12.3994 7.66826 12.3719 7.59387 12.2988C7.51926 12.2255 7.49329 12.1143 7.49329 11.9688C7.49332 11.8227 7.52127 11.7117 7.5968 11.6387C7.67209 11.5659 7.78719 11.5381 7.94153 11.5381Z" fill="white" stroke="white" stroke-width="0.0694444"/><path d="M5.7464 3.29785C5.90068 3.29785 6.01392 3.32621 6.08722 3.39941C6.16033 3.47263 6.18582 3.58322 6.18585 3.72852C6.18585 3.87448 6.15839 3.98553 6.08429 4.05859C6.01009 4.13148 5.89676 4.15918 5.7464 4.15918C5.58813 4.15917 5.47313 4.13167 5.39874 4.05859C5.32414 3.98529 5.29816 3.87409 5.29816 3.72852C5.29819 3.58251 5.32614 3.47149 5.40167 3.39844C5.47696 3.32567 5.59206 3.29786 5.7464 3.29785Z" fill="white" stroke="white" stroke-width="0.0694444"/><path d="M10.0797 3.29785C10.234 3.29785 10.3472 3.32621 10.4205 3.39941C10.4936 3.47263 10.5191 3.58322 10.5192 3.72852C10.5192 3.87449 10.4917 3.98554 10.4176 4.05859C10.3434 4.13148 10.2301 4.15918 10.0797 4.15918C9.92145 4.15917 9.80644 4.13166 9.73206 4.05859C9.65744 3.9853 9.63147 3.87409 9.63147 3.72852C9.6315 3.5825 9.65945 3.47149 9.73499 3.39844C9.81027 3.32568 9.92538 3.29786 10.0797 3.29785Z" fill="white" stroke="white" stroke-width="0.0694444"/><path d="M6.29785 4.92285C6.39622 4.92286 6.46906 4.94612 6.52344 5.01172C6.57475 5.07369 6.60632 5.17037 6.63574 5.30469H6.63477L7.25879 7.89648L7.30371 8.04395C7.35035 8.17596 7.40297 8.26354 7.46875 8.32129C7.55517 8.39706 7.67153 8.42676 7.84961 8.42676H8.03418C8.21668 8.42676 8.33272 8.39686 8.41797 8.32129C8.50461 8.24437 8.56623 8.11445 8.625 7.89648L9.24805 5.30469L9.29785 5.12988C9.31646 5.08141 9.33846 5.04164 9.36523 5.01074C9.42164 4.94591 9.49655 4.92285 9.59473 4.92285H9.78809C9.88168 4.92285 9.95707 4.9593 9.99609 5.03809C10.0332 5.11348 10.0335 5.22116 9.99902 5.35449L9.26562 8.1582V8.15918C9.19723 8.40664 9.09972 8.59529 8.96387 8.73438C8.86165 8.83893 8.73882 8.91483 8.59277 8.96582L8.43848 9.00879C8.38813 9.02043 8.35392 9.03858 8.33203 9.06348C8.31053 9.08814 8.29688 9.12375 8.29688 9.17676V10.4229C8.29688 10.5029 8.2682 10.571 8.21875 10.6191C8.16946 10.6671 8.1018 10.6933 8.02637 10.6934H7.86621C7.78698 10.6934 7.71857 10.6677 7.66992 10.6191C7.62126 10.5705 7.5957 10.5021 7.5957 10.4229V9.17676C7.5957 9.12375 7.58205 9.08814 7.56055 9.06348C7.53862 9.03845 7.50373 9.02045 7.45312 9.00879V9.00781C7.23793 8.9604 7.06298 8.87439 6.92578 8.73535C6.82281 8.63087 6.74253 8.49757 6.68164 8.33301L6.62695 8.1582L5.89355 5.35449C5.8591 5.22116 5.85838 5.11348 5.89551 5.03809C5.93444 4.95924 6.01001 4.92295 6.10352 4.92285H6.29785Z" fill="white" stroke="white" stroke-width="0.0694444"/></svg>`
 
   const avatarConfig = {
     bot: {

package/src/generators/bot-app/files/src/server/bot/actions/not-found.ts.template

@@ -1,10 +1,11 @@
-import { BotContext, BotServerMessageFactory } from '@botonic/shared'
+import { BotonicContext, BotServerMessageFactory } from '@botonic/shared'
 
-export async function NotFound({ sendMessage }: BotContext) {
-  const message = BotServerMessageFactory.createText({
-    text: 'Sorry, I didn\'t understand that.\n\nTry saying "hello" to get started!',
-  })
-  await sendMessage(message)
+export async function NotFound({ sendMessages }: BotonicContext) {
+  await sendMessages([
+    BotServerMessageFactory.createText({
+      text: 'Sorry, I didn\'t understand that.\n\nTry saying "hello" to get started!',
+    }),
+  ])
 
   return {
     status: 200,

package/src/generators/bot-app/files/src/server/bot/actions/welcome.ts.template

@@ -1,10 +1,11 @@
-import { BotContext, BotServerMessageFactory } from '@botonic/shared'
+import { BotonicContext, BotServerMessageFactory } from '@botonic/shared'
 
-export async function Welcome({ sendMessage }: BotContext) {
-  const message = BotServerMessageFactory.createText({
-    text: `Hello! I'm <%= className %> 🤖\n\nWelcome to your new Botonic bot! You can start building your conversation flow by editing the routes and actions.`,
-  })
-  await sendMessage(message)
+export async function Welcome({ sendMessages }: BotonicContext) {
+  await sendMessages([
+    BotServerMessageFactory.createText({
+      text: `Hello! I'm <%= className %> 🤖\n\nWelcome to your new Botonic bot! You can start building your conversation flow by editing the routes and actions.`,
+    }),
+  ])
 
   return {
     status: 200,

package/src/generators/bot-app/files/src/server/bot/index.ts.template

@@ -1,15 +1,16 @@
 // eslint-disable-next-line @nx/enforce-module-boundaries
 import { CoreBot } from '@botonic/core'
-import { BotContext, BotServerMessageFactory } from '@botonic/shared'
+import { BotonicContext, BotServerMessageFactory } from '@botonic/shared'
 
 import { plugins } from './plugins'
 import { routes } from './routes'
 
-const DefaultFallbackAction = async ({ sendMessage }: BotContext) => {
-  const message = BotServerMessageFactory.createText({
-    text: "I don't understand you",
-  })
-  await sendMessage(message)
+const DefaultFallbackAction = async ({ sendMessages }: BotonicContext) => {
+  await sendMessages([
+    BotServerMessageFactory.createText({
+      text: "I don't understand you",
+    }),
+  ])
 
   return {
     status: 200,
@@ -17,10 +18,10 @@ const DefaultFallbackAction = async ({ sendMessage }: BotContext) => {
   }
 }
 
-const defaultRoutes = (botContext: BotContext) => [
+const defaultRoutes = (botonicContext: BotonicContext) => [
   {
     path: '404',
-    action: async () => await DefaultFallbackAction(botContext),
+    action: async () => await DefaultFallbackAction(botonicContext),
   },
 ]
 
@@ -35,9 +36,6 @@ export class NodeApp {
     this.bot = new CoreBot(config)
   }
 
-  input(args: any) {
-    return this.bot.input(args)
-  }
 }
 
 export const app = new NodeApp({ routes, plugins })

package/src/generators/bot-app/files/src/server/bot/plugins/ai-agents/index.ts.template

@@ -1,5 +1,5 @@
 import { AiAgentArgs, BotonicPluginAiAgents } from '@botonic/plugin-ai-agents'
-import { BotContext } from '@botonic/shared'
+import { BotonicContext } from '@botonic/shared'
 
 import { customTools } from '../../tools'
 import { BotPlugins } from '../../types'
@@ -16,15 +16,15 @@ export const aiAgentsPlugin = hasAiAgentsConfig
   : null
 
 export async function getAiAgentResponse(
-  botContext: BotContext<BotPlugins>,
+  botonicContext: BotonicContext<BotPlugins>,
   aiAgentArgs: AiAgentArgs
 ) {
-  const aiAgentPlugin = botContext.plugins.aiAgents
+  const aiAgentPlugin = botonicContext.plugins.aiAgents
   if (!aiAgentPlugin) {
     throw new Error(
       'AI Agents plugin is not configured. Please set AZURE_OPENAI_API_KEY or OPENAI_API_KEY environment variable.'
     )
   }
-  const response = await aiAgentPlugin.getInference(botContext, aiAgentArgs)
+  const response = await aiAgentPlugin.getInference(botonicContext, aiAgentArgs)
   return response
 }

package/src/generators/bot-app/files/src/server/bot/plugins/flow-builder/index.ts.template

@@ -4,7 +4,7 @@ import {
   BotonicPluginFlowBuilderOptions,
   FlowBuilderJSONVersion,
 } from '@botonic/plugin-flow-builder'
-import { BotContext } from '@botonic/shared'
+import { BotonicContext } from '@botonic/shared'
 
 import { trackEventToHubtypeAnalytics } from '../../tracking'
 import { isLambdaLocal } from '../../utils'
@@ -14,14 +14,14 @@ export const flowBuilderConfig: BotonicPluginFlowBuilderOptions = {
   flowVersion: isLambdaLocal()
     ? FlowBuilderJSONVersion.DRAFT
     : FlowBuilderJSONVersion.LATEST,
-  trackEvent: async (botContext: BotContext, eventAction, args) => {
-    await trackEventToHubtypeAnalytics(botContext, eventAction, args)
+  trackEvent: async (botonicContext: BotonicContext, eventAction, args) => {
+    await trackEventToHubtypeAnalytics(botonicContext, eventAction, args)
   },
   getAiAgentResponse: async (
-    botContext: BotContext,
+    botonicContext: BotonicContext,
     aiAgentArgs: AiAgentArgs
   ) => {
-    return getAiAgentResponse(botContext, aiAgentArgs)
+    return getAiAgentResponse(botonicContext, aiAgentArgs)
   },
 }
 

package/src/generators/bot-app/files/src/server/bot/routes.ts.template

@@ -1,23 +1,23 @@
 import { FlowBuilderAction } from '@botonic/plugin-flow-builder'
-import { BotContext } from '@botonic/shared'
+import { BotonicContext } from '@botonic/shared'
 
 import { Welcome, NotFound } from './actions'
 
-export const routes = (botContext: BotContext) => {
+export const routes = (botonicContext: BotonicContext) => {
   return [
     {
       text: /^(hi|hello|start|hola)$/i,
-      action: async () => await Welcome(botContext),
+      action: async () => await Welcome(botonicContext),
     },
     {
       path: 'flow-builder',
       text: /.*/,
       payload: /.*/,
-      action: async () => await FlowBuilderAction.botonicInit(botContext),
+      action: async () => await FlowBuilderAction.botonicInit(botonicContext),
     },
     {
       path: 'not-found',
-      action: async () => await NotFound(botContext),
+      action: async () => await NotFound(botonicContext),
     },
   ]
 }