@botpress/adk 1.7.11 → 1.7.12

package/dist/index.js

@@ -15,6 +15,7 @@ var __toESM = (mod, isNodeMode, target) => {
       });
   return to;
 };
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -36,7 +37,6 @@ var init_types = __esm(() => {
       version: z.string(),
       enabled: z.boolean(),
       configurationType: z.string().optional(),
-      connection: z.string().optional(),
       config: z.record(z.any()).optional()
     })).optional()
   });
@@ -654,7 +654,7 @@ var PRETTIER_CONFIG, formatCode = async (code, filepath) => {
 `));
     return code;
   }
-}, ADK_VERSION = "1.7.11", relative2 = (from, to) => {
+}, ADK_VERSION = "1.7.12", relative2 = (from, to) => {
   const fromDir = path10.dirname(from);
   const relative3 = path10.relative(fromDir, to);
   return relative3.startsWith(".") ? relative3 : `./${relative3}`;
@@ -793,6 +793,86 @@ var init_integration_action_types = __esm(() => {
   init_fs();
 });
 
+// package.json
+var require_package = __commonJS((exports, module) => {
+  module.exports = {
+    name: "@botpress/adk",
+    version: "1.7.12",
+    description: "Core ADK library for building AI agents on Botpress",
+    type: "module",
+    main: "dist/index.js",
+    types: "dist/index.d.ts",
+    files: [
+      "dist/**/*",
+      "package.json",
+      "README.md"
+    ],
+    exports: {
+      ".": {
+        types: "./dist/index.d.ts",
+        import: "./dist/index.js"
+      },
+      "./schemas/*": "./schemas/*"
+    },
+    scripts: {
+      build: "bun run build:types && bun run build.ts",
+      "build:types": "tsc --emitDeclarationOnly",
+      watch: "bun run build:types && bun build ./src/index.ts --outdir ./dist --target node --format esm --sourcemap --watch",
+      clean: "rm -rf dist",
+      prepublishOnly: "bun run clean && bun run build",
+      test: "vitest run",
+      "test:watch": "vitest",
+      "test:ui": "vitest --ui",
+      "test:coverage": "vitest run --coverage"
+    },
+    keywords: [
+      "botpress",
+      "adk",
+      "agent",
+      "ai",
+      "chatbot",
+      "conversational-ai",
+      "development-kit"
+    ],
+    author: "Botpress",
+    license: "MIT",
+    repository: {
+      type: "git",
+      url: "https://github.com/botpress/adk"
+    },
+    dependencies: {
+      "@botpress/cli": "^4.23",
+      "@botpress/client": "^1.27.0",
+      "@botpress/cognitive": "^0.2.0",
+      "@botpress/runtime": "^1.7.12",
+      "@botpress/sdk": "^4.18.1",
+      "@bpinternal/yargs-extra": "^0.0.21",
+      "@parcel/watcher": "^2.5.1",
+      "@types/glob": "^9.0.0",
+      "@types/luxon": "^3.7.1",
+      "@types/semver": "^7.7.1",
+      dedent: "^1.7.0",
+      execa: "9.6.0",
+      glob: "^11.0.3",
+      luxon: "^3.7.2",
+      prettier: "^3.6.2",
+      semver: "^7.7.2",
+      "ts-morph": "^27.0.2"
+    },
+    devDependencies: {
+      dotenv: "^17.2.3"
+    },
+    peerDependencies: {
+      typescript: ">=4.5.0"
+    },
+    engines: {
+      node: ">=22.0.0",
+      bun: ">=1.3.0"
+    },
+    packageManager: "bun@1.3.0"
+  };
+});
+
 // src/auth/index.ts
 init_credentials();
 
@@ -1837,7 +1917,7 @@ function getRelativeTime(date) {
 // src/utils/json-ordering.ts
 var agentInfoKeyOrder = ["botId", "workspaceId", "apiUrl", "devId"];
 var dependenciesKeyOrder = ["integrations"];
-var integrationKeyOrder = ["version", "enabled", "configurationType", "connection", "config"];
+var integrationKeyOrder = ["version", "enabled", "configurationType", "config"];
 function orderKeys(obj, keyOrder) {
   const objKeys = Object.keys(obj);
   const orderedKeys = [];
@@ -2690,7 +2770,7 @@ class IntegrationManager {
       return { valid: false, errors, warnings };
     }
     const hasChannels = integration.definition.channels && Object.keys(integration.definition.channels).length > 0;
-    if (!integration.connection) {
+    if (!integration.config) {
       let requiresConfig = false;
       if (integration.definition.configurations) {
         requiresConfig = Object.values(integration.definition.configurations).some((config) => config.identifier?.required === true);
@@ -2701,7 +2781,7 @@ class IntegrationManager {
         requiresConfig = schema?.required && schema.required.length > 0;
       }
       if (requiresConfig) {
-        warnings.push(`Integration '${integration.alias}' requires configuration. Add a connection in agent.config.ts dependencies`);
+        warnings.push(`Integration '${integration.alias}' requires configuration. Add a config object in agent.config.ts dependencies`);
       }
     }
     return {
@@ -3443,8 +3523,8 @@ class IntegrationChecker {
       }
     }
     if (!installedIntegration) {
-      result.needsInstall = true;
-      if (config) {
+      result.needsInstall = enabled !== false;
+      if (result.needsInstall && config) {
         result.needsConfiguration = true;
       }
     } else {
@@ -3458,24 +3538,23 @@ class IntegrationChecker {
         const configType = configurationType ?? installedIntegration.configurationType ?? "default";
         const schema = configType === "default" ? definition.configuration?.schema : definition.configurations?.[configType]?.schema;
         const schemaProperties = schema?.properties || {};
-        const propertyKeys = Object.keys(schemaProperties);
-        const filterConfig = (cfg) => {
-          const filtered = {};
-          for (const key of propertyKeys) {
-            if (key in cfg) {
-              filtered[key] = cfg[key];
-            }
-          }
-          return filtered;
-        };
-        const currentConfig = filterConfig(installedIntegration.configuration || {});
-        const desiredConfig = filterConfig(config || {});
-        if (JSON.stringify(currentConfig) !== JSON.stringify(desiredConfig)) {
+        const allKeys = new Set([
+          ...Object.keys(installedIntegration.configuration || {}),
+          ...Object.keys(config || {})
+        ]);
+        const configsMatch = Array.from(allKeys).every((key) => {
+          const currentValue = installedIntegration.configuration?.[key] ?? schemaProperties[key]?.default;
+          const desiredValue = config?.[key] ?? schemaProperties[key]?.default;
+          return JSON.stringify(currentValue) === JSON.stringify(desiredValue);
+        });
+        if (!configsMatch) {
           result.needsConfiguration = true;
         }
       }
-      if (enabled !== undefined) {
-        if (enabled === false && installedIntegration.enabled || enabled === true && !installedIntegration.enabled) {
+      if (enabled !== undefined && enabled !== installedIntegration.enabled) {
+        if (enabled === false) {
+          result.needsRemoval = true;
+        } else if (enabled === true && result.installStatus === "disabled") {
           result.needsConfiguration = true;
         }
       }
@@ -3483,8 +3562,101 @@ class IntegrationChecker {
     return result;
   }
 }
-// src/interfaces/manager.ts
+// src/integrations/sync-manager.ts
 import { Client as Client8 } from "@botpress/client";
+class IntegrationSyncManager {
+  projectPath;
+  client;
+  constructor(projectPath) {
+    this.projectPath = projectPath;
+  }
+  async getClient() {
+    if (!this.client) {
+      const credentials = await auth.getActiveCredentials();
+      const project = await AgentProject.load(this.projectPath);
+      const workspaceId = project.agentInfo?.workspaceId || credentials.workspaceId;
+      if (!workspaceId) {
+        throw new Error('No workspace ID found. Please login with "adk login"');
+      }
+      this.client = new Client8({
+        token: credentials.token,
+        apiUrl: credentials.apiUrl,
+        workspaceId,
+        headers: {
+          "x-multiple-integrations": "true"
+        }
+      });
+    }
+    return this.client;
+  }
+  async applySyncPlan(checkResults, botId) {
+    const summary = {
+      installed: 0,
+      updated: 0,
+      removed: 0,
+      failed: 0,
+      errors: []
+    };
+    const client = await this.getClient();
+    for (const result of checkResults) {
+      if (result.needsRemoval && result.installStatus !== "not_installed") {
+        try {
+          await client.updateBot({
+            id: botId,
+            integrations: {
+              [result.alias]: null
+            }
+          });
+          summary.removed++;
+        } catch (error) {
+          const errorMsg = error instanceof Error ? error.message : String(error);
+          summary.failed++;
+          summary.errors.push({ alias: result.alias, error: errorMsg });
+        }
+      } else if (result.needsInstall) {
+        try {
+          await client.updateBot({
+            id: botId,
+            integrations: {
+              [result.alias]: {
+                integrationId: result.desiredIntegrationId || result.definition.id,
+                enabled: result.desiredInstallStatus === "enabled",
+                configuration: result.desiredConfiguration || {}
+              }
+            }
+          });
+          summary.installed++;
+        } catch (error) {
+          const errorMsg = error instanceof Error ? error.message : String(error);
+          summary.failed++;
+          summary.errors.push({ alias: result.alias, error: errorMsg });
+        }
+      } else if ((result.needsUpdate || result.needsConfiguration) && result.installStatus !== "not_installed") {
+        try {
+          await client.updateBot({
+            id: botId,
+            integrations: {
+              [result.alias]: {
+                integrationId: result.desiredIntegrationId || result.definition.id,
+                enabled: result.desiredInstallStatus === "enabled",
+                configuration: result.desiredConfiguration || {},
+                configurationType: result.desiredConfigurationType
+              }
+            }
+          });
+          summary.updated++;
+        } catch (error) {
+          const errorMsg = error instanceof Error ? error.message : String(error);
+          summary.failed++;
+          summary.errors.push({ alias: result.alias, error: errorMsg });
+        }
+      }
+    }
+    return summary;
+  }
+}
+// src/interfaces/manager.ts
+import { Client as Client9 } from "@botpress/client";
 
 // src/interfaces/enhanced-cache.ts
 import fs9 from "fs/promises";
@@ -3655,7 +3827,7 @@ class InterfaceManager {
       if (!this.options.workspaceId && !credentials.workspaceId) {
         throw new Error('No workspace ID found in current profile. Please login again with "adk login"');
       }
-      this.client = new Client8({
+      this.client = new Client9({
         token: credentials.token,
         apiUrl: credentials.apiUrl,
         workspaceId: this.options.workspaceId || credentials.workspaceId,
@@ -4139,7 +4311,6 @@ class AgentProject {
       name: parsed.alias,
       version: parsed.ref.version,
       workspace: parsed.ref.workspace,
-      connection: parsed.connection,
       config: parsed.config,
       installed: false,
       installedVersion: undefined,
@@ -4658,7 +4829,7 @@ class AgentProjectGenerator {
         deploy: "adk deploy"
       },
       dependencies: {
-        "@botpress/runtime": `^${"1.7.11"}`
+        "@botpress/runtime": `^${"1.7.12"}`
       },
       devDependencies: {
         typescript: "^5.9.3"
@@ -5736,7 +5907,7 @@ init_fs();
 import path25 from "path";
 import fs12 from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
-import { Client as Client9 } from "@botpress/client";
+import { Client as Client10 } from "@botpress/client";
 class DevIdManager {
   projectPath;
   botProjectPath;
@@ -5755,7 +5926,7 @@ class DevIdManager {
       if (!workspaceId) {
         throw new Error('No workspace ID found in agent.json or current profile. Please login again with "adk login"');
       }
-      this.client = new Client9({
+      this.client = new Client10({
         token: credentials.token,
         apiUrl: credentials.apiUrl,
         workspaceId,
@@ -6403,9 +6574,13 @@ declare module "@botpress/runtime/_types/state" {
     const integrations = project.dependencies?.integrations || {};
     const imports = [];
     const integrationDefs = [];
-    for (const alias of Object.keys(integrations).map(getIntegrationAlias)) {
-      imports.push(`import integration_${alias} from "../bp_modules/integration_${alias}";`);
-      integrationDefs.push(`${alias}: integration_${alias}`);
+    for (const [alias, config] of Object.entries(integrations)) {
+      if (config.enabled === false) {
+        continue;
+      }
+      const normalizedAlias = getIntegrationAlias(alias);
+      imports.push(`import integration_${normalizedAlias} from "../bp_modules/integration_${normalizedAlias}";`);
+      integrationDefs.push(`${normalizedAlias}: integration_${normalizedAlias}`);
     }
     const content = dedent`
       import { IntegrationPackage } from "@botpress/sdk";
@@ -6449,10 +6624,13 @@ declare module "@botpress/runtime/_types/state" {
     const integrations = project.integrations;
     const imports = [];
     const addIntegrations = [];
-    for (const { alias } of integrations.filter((i) => i.enabled)) {
+    for (const integration of integrations.filter((i) => i.enabled)) {
+      const { alias, configurationType, config } = integration;
       const importName = `integration_${getIntegrationAlias(alias)}`;
       imports.push(`import ${importName} from "./bp_modules/${importName}";`);
-      addIntegrations.push(`bot.addIntegration(${importName}, { alias: "${alias}" });`);
+      const configType = configurationType ? `, configurationType: "${configurationType}"` : "";
+      const configData = config && Object.keys(config).length > 0 ? `, configuration: ${JSON.stringify(config)}` : "";
+      addIntegrations.push(`bot.addIntegration(${importName}, { alias: "${alias}", enabled: true${configType}${configData} });`);
     }
     const conversationTags = {};
     const workflowTags = {};
@@ -7160,7 +7338,7 @@ async function generateBotProject(options) {
   }
 }
 // src/tables/manager.ts
-import { Client as Client10 } from "@botpress/client";
+import { Client as Client11 } from "@botpress/client";
 import { transforms as transforms4 } from "@botpress/sdk";
 class TableManager {
   client;
@@ -7174,7 +7352,7 @@ class TableManager {
     if (!this.client) {
       const credentials = await auth.getActiveCredentials();
       this.assertBotId("initialize client");
-      this.client = new Client10({
+      this.client = new Client11({
         token: credentials.token,
         apiUrl: credentials.apiUrl,
         botId: this.botId,
@@ -7498,6 +7676,867 @@ class FileWatcher2 extends EventEmitter3 {
     return super.emit(event, data);
   }
 }
+// src/preflight/checker.ts
+import { Client as Client12 } from "@botpress/client";
+import path31 from "path";
+
+// src/preflight/types.ts
+function hasIntegrationChanges(integrations) {
+  return integrations.toInstall.length > 0 || integrations.toRemove.length > 0 || integrations.toUpdate.length > 0;
+}
+function pluralize(count, word) {
+  return `${count} ${word}${count > 1 ? "s" : ""}`;
+}
+
+// src/preflight/agent-config-sync.ts
+class AgentConfigSyncManager {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async performSync(botId, updates, options) {
+    if (Object.keys(updates).length === 0) {
+      return false;
+    }
+    try {
+      options?.onProgress?.("Updating bot configuration...");
+      await this.client.updateBot({ id: botId, ...updates });
+      options?.onSuccess?.("Bot configuration updated");
+      return true;
+    } catch (error) {
+      const errorMsg = error instanceof Error ? error.message : String(error);
+      options?.onError?.(`Failed to sync agent config: ${errorMsg}`);
+      throw error;
+    }
+  }
+  async syncFromConfig(botId, config, options) {
+    const updates = {};
+    if (config.name !== undefined) {
+      updates.name = config.name;
+    }
+    return this.performSync(botId, updates, options);
+  }
+  async syncFromChanges(botId, configChanges, options) {
+    if (!configChanges || configChanges.length === 0) {
+      return false;
+    }
+    const updates = {};
+    for (const change of configChanges) {
+      switch (change.field) {
+        case "name":
+          updates.name = change.newValue;
+          break;
+        default:
+          options?.onProgress?.(`Warning: Unknown config field '${change.field}' - skipping sync`);
+      }
+    }
+    return this.performSync(botId, updates, options);
+  }
+}
+
+// ../../node_modules/chalk/source/vendor/ansi-styles/index.js
+var ANSI_BACKGROUND_OFFSET = 10;
+var wrapAnsi16 = (offset = 0) => (code) => `\x1B[${code + offset}m`;
+var wrapAnsi256 = (offset = 0) => (code) => `\x1B[${38 + offset};5;${code}m`;
+var wrapAnsi16m = (offset = 0) => (red, green, blue) => `\x1B[${38 + offset};2;${red};${green};${blue}m`;
+var styles = {
+  modifier: {
+    reset: [0, 0],
+    bold: [1, 22],
+    dim: [2, 22],
+    italic: [3, 23],
+    underline: [4, 24],
+    overline: [53, 55],
+    inverse: [7, 27],
+    hidden: [8, 28],
+    strikethrough: [9, 29]
+  },
+  color: {
+    black: [30, 39],
+    red: [31, 39],
+    green: [32, 39],
+    yellow: [33, 39],
+    blue: [34, 39],
+    magenta: [35, 39],
+    cyan: [36, 39],
+    white: [37, 39],
+    blackBright: [90, 39],
+    gray: [90, 39],
+    grey: [90, 39],
+    redBright: [91, 39],
+    greenBright: [92, 39],
+    yellowBright: [93, 39],
+    blueBright: [94, 39],
+    magentaBright: [95, 39],
+    cyanBright: [96, 39],
+    whiteBright: [97, 39]
+  },
+  bgColor: {
+    bgBlack: [40, 49],
+    bgRed: [41, 49],
+    bgGreen: [42, 49],
+    bgYellow: [43, 49],
+    bgBlue: [44, 49],
+    bgMagenta: [45, 49],
+    bgCyan: [46, 49],
+    bgWhite: [47, 49],
+    bgBlackBright: [100, 49],
+    bgGray: [100, 49],
+    bgGrey: [100, 49],
+    bgRedBright: [101, 49],
+    bgGreenBright: [102, 49],
+    bgYellowBright: [103, 49],
+    bgBlueBright: [104, 49],
+    bgMagentaBright: [105, 49],
+    bgCyanBright: [106, 49],
+    bgWhiteBright: [107, 49]
+  }
+};
+var modifierNames = Object.keys(styles.modifier);
+var foregroundColorNames = Object.keys(styles.color);
+var backgroundColorNames = Object.keys(styles.bgColor);
+var colorNames = [...foregroundColorNames, ...backgroundColorNames];
+function assembleStyles() {
+  const codes = new Map;
+  for (const [groupName, group] of Object.entries(styles)) {
+    for (const [styleName, style] of Object.entries(group)) {
+      styles[styleName] = {
+        open: `\x1B[${style[0]}m`,
+        close: `\x1B[${style[1]}m`
+      };
+      group[styleName] = styles[styleName];
+      codes.set(style[0], style[1]);
+    }
+    Object.defineProperty(styles, groupName, {
+      value: group,
+      enumerable: false
+    });
+  }
+  Object.defineProperty(styles, "codes", {
+    value: codes,
+    enumerable: false
+  });
+  styles.color.close = "\x1B[39m";
+  styles.bgColor.close = "\x1B[49m";
+  styles.color.ansi = wrapAnsi16();
+  styles.color.ansi256 = wrapAnsi256();
+  styles.color.ansi16m = wrapAnsi16m();
+  styles.bgColor.ansi = wrapAnsi16(ANSI_BACKGROUND_OFFSET);
+  styles.bgColor.ansi256 = wrapAnsi256(ANSI_BACKGROUND_OFFSET);
+  styles.bgColor.ansi16m = wrapAnsi16m(ANSI_BACKGROUND_OFFSET);
+  Object.defineProperties(styles, {
+    rgbToAnsi256: {
+      value(red, green, blue) {
+        if (red === green && green === blue) {
+          if (red < 8) {
+            return 16;
+          }
+          if (red > 248) {
+            return 231;
+          }
+          return Math.round((red - 8) / 247 * 24) + 232;
+        }
+        return 16 + 36 * Math.round(red / 255 * 5) + 6 * Math.round(green / 255 * 5) + Math.round(blue / 255 * 5);
+      },
+      enumerable: false
+    },
+    hexToRgb: {
+      value(hex) {
+        const matches = /[a-f\d]{6}|[a-f\d]{3}/i.exec(hex.toString(16));
+        if (!matches) {
+          return [0, 0, 0];
+        }
+        let [colorString] = matches;
+        if (colorString.length === 3) {
+          colorString = [...colorString].map((character) => character + character).join("");
+        }
+        const integer = Number.parseInt(colorString, 16);
+        return [
+          integer >> 16 & 255,
+          integer >> 8 & 255,
+          integer & 255
+        ];
+      },
+      enumerable: false
+    },
+    hexToAnsi256: {
+      value: (hex) => styles.rgbToAnsi256(...styles.hexToRgb(hex)),
+      enumerable: false
+    },
+    ansi256ToAnsi: {
+      value(code) {
+        if (code < 8) {
+          return 30 + code;
+        }
+        if (code < 16) {
+          return 90 + (code - 8);
+        }
+        let red;
+        let green;
+        let blue;
+        if (code >= 232) {
+          red = ((code - 232) * 10 + 8) / 255;
+          green = red;
+          blue = red;
+        } else {
+          code -= 16;
+          const remainder = code % 36;
+          red = Math.floor(code / 36) / 5;
+          green = Math.floor(remainder / 6) / 5;
+          blue = remainder % 6 / 5;
+        }
+        const value = Math.max(red, green, blue) * 2;
+        if (value === 0) {
+          return 30;
+        }
+        let result = 30 + (Math.round(blue) << 2 | Math.round(green) << 1 | Math.round(red));
+        if (value === 2) {
+          result += 60;
+        }
+        return result;
+      },
+      enumerable: false
+    },
+    rgbToAnsi: {
+      value: (red, green, blue) => styles.ansi256ToAnsi(styles.rgbToAnsi256(red, green, blue)),
+      enumerable: false
+    },
+    hexToAnsi: {
+      value: (hex) => styles.ansi256ToAnsi(styles.hexToAnsi256(hex)),
+      enumerable: false
+    }
+  });
+  return styles;
+}
+var ansiStyles = assembleStyles();
+var ansi_styles_default = ansiStyles;
+
+// ../../node_modules/chalk/source/vendor/supports-color/index.js
+import process3 from "node:process";
+import os7 from "node:os";
+import tty from "node:tty";
+function hasFlag(flag, argv = globalThis.Deno ? globalThis.Deno.args : process3.argv) {
+  const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
+  const position = argv.indexOf(prefix + flag);
+  const terminatorPosition = argv.indexOf("--");
+  return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
+}
+var { env } = process3;
+var flagForceColor;
+if (hasFlag("no-color") || hasFlag("no-colors") || hasFlag("color=false") || hasFlag("color=never")) {
+  flagForceColor = 0;
+} else if (hasFlag("color") || hasFlag("colors") || hasFlag("color=true") || hasFlag("color=always")) {
+  flagForceColor = 1;
+}
+function envForceColor() {
+  if ("FORCE_COLOR" in env) {
+    if (env.FORCE_COLOR === "true") {
+      return 1;
+    }
+    if (env.FORCE_COLOR === "false") {
+      return 0;
+    }
+    return env.FORCE_COLOR.length === 0 ? 1 : Math.min(Number.parseInt(env.FORCE_COLOR, 10), 3);
+  }
+}
+function translateLevel(level) {
+  if (level === 0) {
+    return false;
+  }
+  return {
+    level,
+    hasBasic: true,
+    has256: level >= 2,
+    has16m: level >= 3
+  };
+}
+function _supportsColor(haveStream, { streamIsTTY, sniffFlags = true } = {}) {
+  const noFlagForceColor = envForceColor();
+  if (noFlagForceColor !== undefined) {
+    flagForceColor = noFlagForceColor;
+  }
+  const forceColor = sniffFlags ? flagForceColor : noFlagForceColor;
+  if (forceColor === 0) {
+    return 0;
+  }
+  if (sniffFlags) {
+    if (hasFlag("color=16m") || hasFlag("color=full") || hasFlag("color=truecolor")) {
+      return 3;
+    }
+    if (hasFlag("color=256")) {
+      return 2;
+    }
+  }
+  if ("TF_BUILD" in env && "AGENT_NAME" in env) {
+    return 1;
+  }
+  if (haveStream && !streamIsTTY && forceColor === undefined) {
+    return 0;
+  }
+  const min = forceColor || 0;
+  if (env.TERM === "dumb") {
+    return min;
+  }
+  if (process3.platform === "win32") {
+    const osRelease = os7.release().split(".");
+    if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
+      return Number(osRelease[2]) >= 14931 ? 3 : 2;
+    }
+    return 1;
+  }
+  if ("CI" in env) {
+    if (["GITHUB_ACTIONS", "GITEA_ACTIONS", "CIRCLECI"].some((key) => (key in env))) {
+      return 3;
+    }
+    if (["TRAVIS", "APPVEYOR", "GITLAB_CI", "BUILDKITE", "DRONE"].some((sign) => (sign in env)) || env.CI_NAME === "codeship") {
+      return 1;
+    }
+    return min;
+  }
+  if ("TEAMCITY_VERSION" in env) {
+    return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(env.TEAMCITY_VERSION) ? 1 : 0;
+  }
+  if (env.COLORTERM === "truecolor") {
+    return 3;
+  }
+  if (env.TERM === "xterm-kitty") {
+    return 3;
+  }
+  if (env.TERM === "xterm-ghostty") {
+    return 3;
+  }
+  if (env.TERM === "wezterm") {
+    return 3;
+  }
+  if ("TERM_PROGRAM" in env) {
+    const version = Number.parseInt((env.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
+    switch (env.TERM_PROGRAM) {
+      case "iTerm.app": {
+        return version >= 3 ? 3 : 2;
+      }
+      case "Apple_Terminal": {
+        return 2;
+      }
+    }
+  }
+  if (/-256(color)?$/i.test(env.TERM)) {
+    return 2;
+  }
+  if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(env.TERM)) {
+    return 1;
+  }
+  if ("COLORTERM" in env) {
+    return 1;
+  }
+  return min;
+}
+function createSupportsColor(stream, options = {}) {
+  const level = _supportsColor(stream, {
+    streamIsTTY: stream && stream.isTTY,
+    ...options
+  });
+  return translateLevel(level);
+}
+var supportsColor = {
+  stdout: createSupportsColor({ isTTY: tty.isatty(1) }),
+  stderr: createSupportsColor({ isTTY: tty.isatty(2) })
+};
+var supports_color_default = supportsColor;
+
+// ../../node_modules/chalk/source/utilities.js
+function stringReplaceAll(string, substring, replacer) {
+  let index = string.indexOf(substring);
+  if (index === -1) {
+    return string;
+  }
+  const substringLength = substring.length;
+  let endIndex = 0;
+  let returnValue = "";
+  do {
+    returnValue += string.slice(endIndex, index) + substring + replacer;
+    endIndex = index + substringLength;
+    index = string.indexOf(substring, endIndex);
+  } while (index !== -1);
+  returnValue += string.slice(endIndex);
+  return returnValue;
+}
+function stringEncaseCRLFWithFirstIndex(string, prefix, postfix, index) {
+  let endIndex = 0;
+  let returnValue = "";
+  do {
+    const gotCR = string[index - 1] === "\r";
+    returnValue += string.slice(endIndex, gotCR ? index - 1 : index) + prefix + (gotCR ? `\r
+` : `
+`) + postfix;
+    endIndex = index + 1;
+    index = string.indexOf(`
+`, endIndex);
+  } while (index !== -1);
+  returnValue += string.slice(endIndex);
+  return returnValue;
+}
+
+// ../../node_modules/chalk/source/index.js
+var { stdout: stdoutColor, stderr: stderrColor } = supports_color_default;
+var GENERATOR = Symbol("GENERATOR");
+var STYLER = Symbol("STYLER");
+var IS_EMPTY = Symbol("IS_EMPTY");
+var levelMapping = [
+  "ansi",
+  "ansi",
+  "ansi256",
+  "ansi16m"
+];
+var styles2 = Object.create(null);
+var applyOptions = (object, options = {}) => {
+  if (options.level && !(Number.isInteger(options.level) && options.level >= 0 && options.level <= 3)) {
+    throw new Error("The `level` option should be an integer from 0 to 3");
+  }
+  const colorLevel = stdoutColor ? stdoutColor.level : 0;
+  object.level = options.level === undefined ? colorLevel : options.level;
+};
+var chalkFactory = (options) => {
+  const chalk = (...strings) => strings.join(" ");
+  applyOptions(chalk, options);
+  Object.setPrototypeOf(chalk, createChalk.prototype);
+  return chalk;
+};
+function createChalk(options) {
+  return chalkFactory(options);
+}
+Object.setPrototypeOf(createChalk.prototype, Function.prototype);
+for (const [styleName, style] of Object.entries(ansi_styles_default)) {
+  styles2[styleName] = {
+    get() {
+      const builder = createBuilder(this, createStyler(style.open, style.close, this[STYLER]), this[IS_EMPTY]);
+      Object.defineProperty(this, styleName, { value: builder });
+      return builder;
+    }
+  };
+}
+styles2.visible = {
+  get() {
+    const builder = createBuilder(this, this[STYLER], true);
+    Object.defineProperty(this, "visible", { value: builder });
+    return builder;
+  }
+};
+var getModelAnsi = (model, level, type, ...arguments_) => {
+  if (model === "rgb") {
+    if (level === "ansi16m") {
+      return ansi_styles_default[type].ansi16m(...arguments_);
+    }
+    if (level === "ansi256") {
+      return ansi_styles_default[type].ansi256(ansi_styles_default.rgbToAnsi256(...arguments_));
+    }
+    return ansi_styles_default[type].ansi(ansi_styles_default.rgbToAnsi(...arguments_));
+  }
+  if (model === "hex") {
+    return getModelAnsi("rgb", level, type, ...ansi_styles_default.hexToRgb(...arguments_));
+  }
+  return ansi_styles_default[type][model](...arguments_);
+};
+var usedModels = ["rgb", "hex", "ansi256"];
+for (const model of usedModels) {
+  styles2[model] = {
+    get() {
+      const { level } = this;
+      return function(...arguments_) {
+        const styler = createStyler(getModelAnsi(model, levelMapping[level], "color", ...arguments_), ansi_styles_default.color.close, this[STYLER]);
+        return createBuilder(this, styler, this[IS_EMPTY]);
+      };
+    }
+  };
+  const bgModel = "bg" + model[0].toUpperCase() + model.slice(1);
+  styles2[bgModel] = {
+    get() {
+      const { level } = this;
+      return function(...arguments_) {
+        const styler = createStyler(getModelAnsi(model, levelMapping[level], "bgColor", ...arguments_), ansi_styles_default.bgColor.close, this[STYLER]);
+        return createBuilder(this, styler, this[IS_EMPTY]);
+      };
+    }
+  };
+}
+var proto = Object.defineProperties(() => {}, {
+  ...styles2,
+  level: {
+    enumerable: true,
+    get() {
+      return this[GENERATOR].level;
+    },
+    set(level) {
+      this[GENERATOR].level = level;
+    }
+  }
+});
+var createStyler = (open, close, parent) => {
+  let openAll;
+  let closeAll;
+  if (parent === undefined) {
+    openAll = open;
+    closeAll = close;
+  } else {
+    openAll = parent.openAll + open;
+    closeAll = close + parent.closeAll;
+  }
+  return {
+    open,
+    close,
+    openAll,
+    closeAll,
+    parent
+  };
+};
+var createBuilder = (self, _styler, _isEmpty) => {
+  const builder = (...arguments_) => applyStyle(builder, arguments_.length === 1 ? "" + arguments_[0] : arguments_.join(" "));
+  Object.setPrototypeOf(builder, proto);
+  builder[GENERATOR] = self;
+  builder[STYLER] = _styler;
+  builder[IS_EMPTY] = _isEmpty;
+  return builder;
+};
+var applyStyle = (self, string) => {
+  if (self.level <= 0 || !string) {
+    return self[IS_EMPTY] ? "" : string;
+  }
+  let styler = self[STYLER];
+  if (styler === undefined) {
+    return string;
+  }
+  const { openAll, closeAll } = styler;
+  if (string.includes("\x1B")) {
+    while (styler !== undefined) {
+      string = stringReplaceAll(string, styler.close, styler.open);
+      styler = styler.parent;
+    }
+  }
+  const lfIndex = string.indexOf(`
+`);
+  if (lfIndex !== -1) {
+    string = stringEncaseCRLFWithFirstIndex(string, closeAll, openAll, lfIndex);
+  }
+  return openAll + string + closeAll;
+};
+Object.defineProperties(createChalk.prototype, styles2);
+var chalk = createChalk();
+var chalkStderr = createChalk({ level: stderrColor ? stderrColor.level : 0 });
+var source_default = chalk;
+
+// src/preflight/formatter.ts
+import { readFileSync } from "fs";
+import { join as join8 } from "path";
+var getAdkVersion = () => {
+  try {
+    const packageJson = require_package();
+    return packageJson.version;
+  } catch {
+    try {
+      const adkPackagePath = join8(process.cwd(), "node_modules/@botpress/adk/package.json");
+      const pkg = JSON.parse(readFileSync(adkPackagePath, "utf-8"));
+      return pkg.version;
+    } catch {
+      return "unknown";
+    }
+  }
+};
+
+class PreflightFormatter {
+  static format(result) {
+    const sections = [];
+    const purple = "#D2A6FF";
+    const logoLine1 = source_default.hex(purple)(" ▄▀█ █▀▄ █▄▀") + "  Botpress ADK";
+    const logoLine2 = source_default.hex(purple)(" █▀█ █▄▀ █░█") + `  v${getAdkVersion()}`;
+    sections.push("");
+    sections.push(logoLine1);
+    sections.push(logoLine2);
+    sections.push("");
+    sections.push(source_default.hex(purple)("Running") + " preflight checks...");
+    sections.push("");
+    const allIntegrations = [
+      ...result.integrations.toRemove,
+      ...result.integrations.toInstall,
+      ...result.integrations.toUpdate
+    ];
+    const maxWidth = Math.max(...allIntegrations.map((i) => `${i.alias} (v${i.version})`.length), 30);
+    if (hasIntegrationChanges(result.integrations)) {
+      sections.push(source_default.bold(`Integrations:
+`));
+      if (result.integrations.toRemove.length > 0) {
+        sections.push(source_default.bold("Installed Remotely but NOT in agent.config.ts"));
+        sections.push(source_default.gray(`(these will be DISABLED or REMOVED)
+`));
+        for (const integration of result.integrations.toRemove) {
+          const name = `${integration.alias} (v${integration.version})`;
+          const padding = " ".repeat(maxWidth - name.length + 4);
+          sections.push(`  ${source_default.red("—")} ${name}${padding}${source_default.red("✗")} Not present locally`);
+          sections.push(`    Action: ${source_default.red("Remove")}
+`);
+        }
+      }
+      if (result.integrations.toInstall.length > 0) {
+        sections.push(source_default.bold("Present Locally but NOT Installed Remotely"));
+        sections.push(source_default.gray(`(these will be INSTALLED)
+`));
+        for (const integration of result.integrations.toInstall) {
+          const name = `${integration.alias} (v${integration.version})`;
+          const padding = " ".repeat(maxWidth - name.length + 4);
+          sections.push(`  ${source_default.green("—")} ${name}${padding}${source_default.green("+")} Missing remotely`);
+          sections.push(`    Action: ${source_default.green("Install")}
+`);
+        }
+      }
+      if (result.integrations.toUpdate.length > 0) {
+        sections.push(source_default.bold("Present on both, but config DIFFERS"));
+        sections.push(source_default.gray(`(these will be UPDATED)
+`));
+        for (const integration of result.integrations.toUpdate) {
+          sections.push(`  ${source_default.yellow("—")} ${integration.alias} (v${integration.version})`);
+          if (integration.configChanges && integration.configChanges.length > 0) {
+            sections.push(source_default.yellow(`    Configuration differences:
+`));
+            for (const change of integration.configChanges) {
+              sections.push(`      ${change.field}:`);
+              sections.push(`        ${source_default.red("-")} Remote:  ${this.formatValue(change.oldValue)}`);
+              sections.push(`        ${source_default.green("+")} Local:   ${this.formatValue(change.newValue)}
+`);
+            }
+          }
+        }
+      }
+    }
+    if (result.agentConfig.length > 0) {
+      sections.push(source_default.bold("Agent Configuration Differences"));
+      sections.push(source_default.gray(`(These are top-level agent settings, not integration settings)
+`));
+      for (const diff of result.agentConfig) {
+        sections.push(`  agent.${diff.field}:`);
+        sections.push(`    ${source_default.red("-")} Remote:  ${this.formatValue(diff.oldValue)}`);
+        sections.push(`    ${source_default.green("+")} Local:   ${this.formatValue(diff.newValue)}
+`);
+      }
+    }
+    sections.push(source_default.bold(`Summary of Actions
+`));
+    const install = result.integrations.toInstall.length;
+    const remove = result.integrations.toRemove.length;
+    const update = result.integrations.toUpdate.length;
+    const agentConfig = result.agentConfig.length;
+    if (install > 0) {
+      sections.push(`  • ${source_default.green("Install:")} ${pluralize(install, "integration")}`);
+    }
+    if (remove > 0) {
+      sections.push(`  • ${source_default.red("Remove:")}  ${pluralize(remove, "integration")}`);
+    }
+    if (update > 0) {
+      sections.push(`  • ${source_default.yellow("Update:")}  ${pluralize(update, "integration")}`);
+    }
+    if (agentConfig > 0) {
+      sections.push(`  • ${source_default.cyan("Agent config:")} ${pluralize(agentConfig, "change")}`);
+    }
+    sections.push("");
+    return sections.join(`
+`);
+  }
+  static formatPrompt() {
+    return source_default.bold.red(`❓ Apply these changes before continuing?
+`) + source_default.gray("Proceed? [y/N] ");
+  }
+  static formatValue(value) {
+    if (value === undefined || value === null) {
+      return source_default.gray("(not set)");
+    }
+    if (typeof value === "string") {
+      return `"${value}"`;
+    }
+    if (typeof value === "boolean") {
+      return value ? source_default.green("true") : source_default.red("false");
+    }
+    if (Array.isArray(value)) {
+      return `[${value.map((v) => this.formatValue(v)).join(", ")}]`;
+    }
+    if (typeof value === "object") {
+      return JSON.stringify(value);
+    }
+    return String(value);
+  }
+}
+
+// src/preflight/checker.ts
+class PreflightChecker {
+  projectPath;
+  client;
+  project;
+  constructor(projectPath) {
+    this.projectPath = projectPath;
+  }
+  async getProject() {
+    if (!this.project) {
+      this.project = await AgentProject.load(this.projectPath);
+    }
+    return this.project;
+  }
+  async getClient() {
+    if (!this.client) {
+      const credentials = await auth.getActiveCredentials();
+      const project = await this.getProject();
+      const workspaceId = project.agentInfo?.workspaceId || credentials.workspaceId;
+      if (!workspaceId) {
+        throw new Error('No workspace ID found. Please login with "adk login"');
+      }
+      this.client = new Client12({
+        token: credentials.token,
+        apiUrl: credentials.apiUrl,
+        workspaceId,
+        headers: {
+          "x-multiple-integrations": "true"
+        }
+      });
+    }
+    return this.client;
+  }
+  async performCheck(botId) {
+    const client = await this.getClient();
+    const project = await this.getProject();
+    const { bot } = await client.getBot({ id: botId });
+    const integrationChecker = new IntegrationChecker(this.projectPath);
+    const integrationResults = await integrationChecker.checkIntegrations(botId);
+    const integrationDiffs = this.buildIntegrationDiffs(integrationResults);
+    const agentConfigDiffs = this.buildAgentConfigDiffs(project, bot);
+    const hasChanges = hasIntegrationChanges(integrationDiffs) || agentConfigDiffs.length > 0;
+    return {
+      result: {
+        integrations: integrationDiffs,
+        agentConfig: agentConfigDiffs,
+        hasChanges
+      },
+      integrationResults
+    };
+  }
+  buildIntegrationDiffs(results) {
+    const toInstall = [];
+    const toRemove = [];
+    const toUpdate = [];
+    for (const result of results) {
+      if (result.desiredInstallStatus === "disabled" && !result.needsRemoval && !result.needsConfiguration) {
+        continue;
+      }
+      if (result.needsInstall) {
+        toInstall.push({
+          alias: result.alias,
+          name: result.name,
+          version: result.desiredVersion,
+          action: "install"
+        });
+      } else if (result.needsRemoval) {
+        toRemove.push({
+          alias: result.alias,
+          name: result.name,
+          version: result.installedVersion || result.desiredVersion,
+          action: "remove"
+        });
+      } else if (result.needsUpdate || result.needsConfiguration) {
+        const configChanges = this.buildConfigDiff(result.currentConfiguration || {}, result.desiredConfiguration || {}, result.definition.configuration?.schema?.properties || {});
+        toUpdate.push({
+          alias: result.alias,
+          name: result.name,
+          version: result.desiredVersion,
+          action: "update",
+          configChanges: configChanges.length > 0 ? configChanges : undefined
+        });
+      }
+    }
+    return { toInstall, toRemove, toUpdate };
+  }
+  buildConfigDiff(current, desired, schema) {
+    const diffs = [];
+    const currentObj = current ?? {};
+    const desiredObj = desired ?? {};
+    const allKeys = new Set([...Object.keys(currentObj), ...Object.keys(desiredObj)]);
+    for (const key of allKeys) {
+      const schemaDefault = schema.properties?.[key]?.default;
+      const currentValue = currentObj[key] ?? schemaDefault;
+      const desiredValue = desiredObj[key] ?? schemaDefault;
+      if (JSON.stringify(currentValue) !== JSON.stringify(desiredValue)) {
+        const type = currentValue === undefined ? "added" : desiredValue === undefined ? "removed" : "changed";
+        diffs.push({
+          field: key,
+          oldValue: currentValue,
+          newValue: desiredValue,
+          type
+        });
+      }
+    }
+    return diffs;
+  }
+  buildAgentConfigDiffs(project, bot) {
+    if (project.config?.name !== undefined && project.config.name !== bot.name) {
+      return [
+        {
+          field: "name",
+          oldValue: bot.name,
+          newValue: project.config.name
+        }
+      ];
+    }
+    return [];
+  }
+  async checkWithPendingApply(botId) {
+    const { result, integrationResults } = await this.performCheck(botId);
+    return {
+      result,
+      apply: (callbacks) => this.apply(botId, result, integrationResults, callbacks)
+    };
+  }
+  async checkAndApply(botId, options = {}) {
+    const { result, integrationResults } = await this.performCheck(botId);
+    if (!result.hasChanges) {
+      return { result, applied: false };
+    }
+    if (options.shouldApply) {
+      const formatted = PreflightFormatter.format(result);
+      const approved = await options.shouldApply(result, formatted);
+      if (!approved) {
+        return { result, applied: false };
+      }
+    }
+    await this.apply(botId, result, integrationResults, options.callbacks);
+    return { result, applied: true };
+  }
+  async apply(botId, result, integrationResults, options) {
+    const client = await this.getClient();
+    if (hasIntegrationChanges(result.integrations)) {
+      options?.onProgress?.("Syncing integrations to bot...");
+      const integrationSyncer = new IntegrationSyncManager(this.projectPath);
+      const syncResult = await integrationSyncer.applySyncPlan(integrationResults, botId);
+      if (syncResult.installed > 0) {
+        options?.onSuccess?.(`Installed ${pluralize(syncResult.installed, "integration")}`);
+      }
+      if (syncResult.updated > 0) {
+        options?.onSuccess?.(`Updated ${pluralize(syncResult.updated, "integration")}`);
+      }
+      if (syncResult.removed > 0) {
+        options?.onSuccess?.(`Removed ${pluralize(syncResult.removed, "integration")}`);
+      }
+      if (syncResult.failed > 0) {
+        options?.onError?.(`Failed to sync ${pluralize(syncResult.failed, "integration")}`);
+        for (const { alias, error } of syncResult.errors) {
+          options?.onError?.(`  ${alias}: ${error}`);
+        }
+      }
+    }
+    if (result.agentConfig.length > 0) {
+      const configSyncer = new AgentConfigSyncManager(client);
+      await configSyncer.syncFromChanges(botId, result.agentConfig, options);
+    }
+    options?.onProgress?.("Regenerating bot project...");
+    await generateBotProject({
+      projectPath: this.projectPath,
+      outputPath: path31.join(this.projectPath, ".adk", "bot")
+    });
+    options?.onSuccess?.("Bot project regenerated");
+  }
+}
 export {
   workspaceCache,
   stringifyWithOrder,
@@ -7518,9 +8557,12 @@ export {
   ValidationErrorCode,
   TableManager,
   ProjectState,
+  PreflightFormatter,
+  PreflightChecker,
   InterfaceParser,
   InterfaceOperations,
   InterfaceManager,
+  IntegrationSyncManager,
   IntegrationSync,
   IntegrationParser,
   IntegrationOperations,
@@ -7543,5 +8585,5 @@ export {
   AgentProject
 };
 
-//# debugId=5A49E76D7DEDD7B864756E2164756E21
+//# debugId=2099CC0161971ADE64756E2164756E21
 //# sourceMappingURL=index.js.map