@chatbotkit/cli 1.28.0 → 1.29.0

package/README.md

@@ -9,6 +9,20 @@
 
 A powerful command-line interface for ChatBotKit that provides both API management commands and an autonomous AI agent mode for interactive development tasks.
 
+## Why ChatBotKit?
+
+**Build lighter, future-proof AI agents.** When you build with ChatBotKit, the heavy lifting happens on our servers—not in your application. This architectural advantage delivers:
+
+- 🪶 **Lightweight Agents**: Your agents stay lean because complex AI processing, model orchestration, and tool execution happen server-side. Less code in your app means faster load times and simpler maintenance.
+
+- 🛡️ **Robust & Streamlined**: Server-side processing provides a more reliable experience with built-in error handling, automatic retries, and consistent behavior across all platforms.
+
+- 🔄 **Backward & Forward Compatible**: As AI technology evolves—new models, new capabilities, new paradigms—your agents automatically benefit. No code changes required on your end.
+
+- 🔮 **Future-Proof**: Agents you build today will remain capable tomorrow. When we add support for new AI models or capabilities, your existing agents gain those powers without any updates to your codebase.
+
+This means you can focus on building great user experiences while ChatBotKit handles the complexity of the ever-changing AI landscape.
+
 ## Installation
 
 Install globally via npm:

package/dist/cjs/command/agent/index.cjs

@@ -109,8 +109,7 @@ exports.command = new commander_1.Command()
     let hasOutput = false;
     for await (const { type, data } of (0, agent_1.execute)({
         client,
-        botId: options.bot,
-        model: options.model,
+        ...(options.bot ? { botId: options.bot } : { model: options.model }),
         messages: [{ type: 'user', text: prompt }],
         tools,
         maxIterations: options.maxIterations,

package/dist/cjs/command/chat/index.cjs

@@ -45,8 +45,7 @@ exports.command = new commander_1.Command()
         let firstToken = true;
         for await (const { type, data } of (0, agent_1.complete)({
             client,
-            botId: options.bot,
-            model: options.model,
+            ...(options.bot ? { botId: options.bot } : { model: options.model }),
             messages,
             tools,
         })) {

package/dist/cjs/solution/index.cjs

@@ -215,6 +215,7 @@ exports.SlackIntegrationResourceConfigSchema = exports.BasicResourceConfigSchema
         ratings: zod_1.z.boolean().optional(),
         visibleMessages: zod_1.z.number().optional(),
         autoRespond: zod_1.z.string().optional(),
+        allowFrom: zod_1.z.string().optional(),
     }),
 });
 exports.DiscordIntegrationResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
@@ -234,6 +235,7 @@ exports.DiscordIntegrationResourceConfigSchema = exports.BasicResourceConfigSche
         sessionDuration: zod_1.z.number().optional(),
         attachments: zod_1.z.boolean().optional(),
         stream: zod_1.z.boolean().optional(),
+        allowFrom: zod_1.z.string().optional(),
     }),
 });
 exports.TelegramIntegrationResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
@@ -248,6 +250,7 @@ exports.TelegramIntegrationResourceConfigSchema = exports.BasicResourceConfigSch
         contactCollection: zod_1.z.boolean().optional(),
         sessionDuration: zod_1.z.number().optional(),
         attachments: zod_1.z.boolean().optional(),
+        allowFrom: zod_1.z.string().optional(),
     }),
 });
 exports.WhatsAppIntegrationResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
@@ -263,6 +266,7 @@ exports.WhatsAppIntegrationResourceConfigSchema = exports.BasicResourceConfigSch
         contactCollection: zod_1.z.boolean().optional(),
         sessionDuration: zod_1.z.number().optional(),
         attachments: zod_1.z.boolean().optional(),
+        allowFrom: zod_1.z.string().optional(),
     }),
 });
 exports.MessengerIntegrationResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
@@ -303,6 +307,7 @@ exports.EmailIntegrationResourceConfigSchema = exports.BasicResourceConfigSchema
         contactCollection: zod_1.z.boolean().optional(),
         sessionDuration: zod_1.z.number().optional(),
         attachments: zod_1.z.boolean().optional(),
+        allowFrom: zod_1.z.string().optional(),
     }),
 });
 exports.TriggerIntegrationResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
@@ -326,6 +331,8 @@ exports.TriggerIntegrationResourceConfigSchema = exports.BasicResourceConfigSche
         ])
             .optional(),
         sessionDuration: zod_1.z.number().optional(),
+        maxIterations: zod_1.z.number().optional(),
+        maxTime: zod_1.z.number().optional(),
     }),
 });
 exports.SupportIntegrationResourceConfigSchema = exports.BasicResourceConfigSchema.extend({

package/dist/esm/command/agent/index.js

@@ -106,8 +106,7 @@ export const command = new Command()
     let hasOutput = false;
     for await (const { type, data } of execute({
         client,
-        botId: options.bot,
-        model: options.model,
+        ...(options.bot ? { botId: options.bot } : { model: options.model }),
         messages: [{ type: 'user', text: prompt }],
         tools,
         maxIterations: options.maxIterations,

package/dist/esm/command/chat/index.js

@@ -41,8 +41,7 @@ export const command = new Command()
         let firstToken = true;
         for await (const { type, data } of complete({
             client,
-            botId: options.bot,
-            model: options.model,
+            ...(options.bot ? { botId: options.bot } : { model: options.model }),
             messages,
             tools,
         })) {

package/dist/esm/solution/index.d.ts

@@ -165,6 +165,7 @@ export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprin
     ratings?: boolean;
     visibleMessages?: number;
     autoRespond?: string;
+    allowFrom?: string;
 }>, ResourceConfigSchemaFor<"discordIntegration", {
     name?: string;
     description?: string;
@@ -179,6 +180,7 @@ export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprin
     handle?: string;
     contactCollection?: boolean;
     sessionDuration?: number;
+    allowFrom?: string;
 }>, ResourceConfigSchemaFor<"telegramIntegration", {
     name?: string;
     description?: string;
@@ -191,6 +193,7 @@ export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprin
     contactCollection?: boolean;
     sessionDuration?: number;
     attachments?: boolean;
+    allowFrom?: string;
 }>, ResourceConfigSchemaFor<"whatsappIntegration", {
     name?: string;
     description?: string;
@@ -204,6 +207,7 @@ export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprin
     contactCollection?: boolean;
     sessionDuration?: number;
     attachments?: boolean;
+    allowFrom?: string;
 }>, ResourceConfigSchemaFor<"messengerIntegration", {
     name?: string;
     description?: string;
@@ -213,6 +217,7 @@ export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprin
     blueprintId?: string;
     botId?: string;
     accessToken?: string;
+    contactCollection?: boolean;
     sessionDuration?: number;
     attachments?: boolean;
 }>, ResourceConfigSchemaFor<"notionIntegration", {
@@ -237,6 +242,7 @@ export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprin
     contactCollection?: boolean;
     sessionDuration?: number;
     attachments?: boolean;
+    allowFrom?: string;
 }>, ResourceConfigSchemaFor<"triggerIntegration", {
     name?: string;
     description?: string;
@@ -248,6 +254,8 @@ export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprin
     authenticate?: boolean;
     triggerSchedule?: "never" | "quarterhourly" | "halfhourly" | "hourly" | "daily" | "weekly" | "monthly";
     sessionDuration?: number;
+    maxIterations?: number;
+    maxTime?: number;
 }>, ResourceConfigSchemaFor<"supportIntegration", {
     name?: string;
     description?: string;
@@ -417,6 +425,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         ratings?: boolean;
         visibleMessages?: number;
         autoRespond?: string;
+        allowFrom?: string;
     }>, ResourceConfigSchemaFor<"discordIntegration", {
         name?: string;
         description?: string;
@@ -431,6 +440,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         handle?: string;
         contactCollection?: boolean;
         sessionDuration?: number;
+        allowFrom?: string;
     }>, ResourceConfigSchemaFor<"telegramIntegration", {
         name?: string;
         description?: string;
@@ -443,6 +453,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         contactCollection?: boolean;
         sessionDuration?: number;
         attachments?: boolean;
+        allowFrom?: string;
     }>, ResourceConfigSchemaFor<"whatsappIntegration", {
         name?: string;
         description?: string;
@@ -456,6 +467,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         contactCollection?: boolean;
         sessionDuration?: number;
         attachments?: boolean;
+        allowFrom?: string;
     }>, ResourceConfigSchemaFor<"messengerIntegration", {
         name?: string;
         description?: string;
@@ -465,6 +477,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         blueprintId?: string;
         botId?: string;
         accessToken?: string;
+        contactCollection?: boolean;
         sessionDuration?: number;
         attachments?: boolean;
     }>, ResourceConfigSchemaFor<"notionIntegration", {
@@ -489,6 +502,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         contactCollection?: boolean;
         sessionDuration?: number;
         attachments?: boolean;
+        allowFrom?: string;
     }>, ResourceConfigSchemaFor<"triggerIntegration", {
         name?: string;
         description?: string;
@@ -500,6 +514,8 @@ export const SolutionConfigSchema: z.ZodObject<{
         authenticate?: boolean;
         triggerSchedule?: "never" | "quarterhourly" | "halfhourly" | "hourly" | "daily" | "weekly" | "monthly";
         sessionDuration?: number;
+        maxIterations?: number;
+        maxTime?: number;
     }>, ResourceConfigSchemaFor<"supportIntegration", {
         name?: string;
         description?: string;
@@ -726,6 +742,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             ratings?: boolean | undefined;
             visibleMessages?: number | undefined;
             autoRespond?: string | undefined;
+            allowFrom?: string | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -742,6 +759,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             sessionDuration?: number | undefined;
             contactCollection?: boolean | undefined;
             botToken?: string | undefined;
+            allowFrom?: string | undefined;
             appId?: string | undefined;
             publicKey?: string | undefined;
             handle?: string | undefined;
@@ -762,6 +780,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             sessionDuration?: number | undefined;
             contactCollection?: boolean | undefined;
             botToken?: string | undefined;
+            allowFrom?: string | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -778,6 +797,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             blueprintId?: string | undefined;
             sessionDuration?: number | undefined;
             contactCollection?: boolean | undefined;
+            allowFrom?: string | undefined;
             phoneNumberId?: string | undefined;
             accessToken?: string | undefined;
         };
@@ -795,6 +815,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             } | undefined;
             blueprintId?: string | undefined;
             sessionDuration?: number | undefined;
+            contactCollection?: boolean | undefined;
             accessToken?: string | undefined;
         };
         slug?: string | undefined;
@@ -828,6 +849,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             blueprintId?: string | undefined;
             sessionDuration?: number | undefined;
             contactCollection?: boolean | undefined;
+            allowFrom?: string | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -836,6 +858,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         properties: {
             name?: string | undefined;
             botId?: string | undefined;
+            maxIterations?: number | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -844,6 +867,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             sessionDuration?: number | undefined;
             authenticate?: boolean | undefined;
             triggerSchedule?: "never" | "quarterhourly" | "halfhourly" | "hourly" | "daily" | "weekly" | "monthly" | undefined;
+            maxTime?: number | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -1093,6 +1117,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             ratings?: boolean | undefined;
             visibleMessages?: number | undefined;
             autoRespond?: string | undefined;
+            allowFrom?: string | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -1109,6 +1134,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             sessionDuration?: number | undefined;
             contactCollection?: boolean | undefined;
             botToken?: string | undefined;
+            allowFrom?: string | undefined;
             appId?: string | undefined;
             publicKey?: string | undefined;
             handle?: string | undefined;
@@ -1129,6 +1155,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             sessionDuration?: number | undefined;
             contactCollection?: boolean | undefined;
             botToken?: string | undefined;
+            allowFrom?: string | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -1145,6 +1172,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             blueprintId?: string | undefined;
             sessionDuration?: number | undefined;
             contactCollection?: boolean | undefined;
+            allowFrom?: string | undefined;
             phoneNumberId?: string | undefined;
             accessToken?: string | undefined;
         };
@@ -1162,6 +1190,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             } | undefined;
             blueprintId?: string | undefined;
             sessionDuration?: number | undefined;
+            contactCollection?: boolean | undefined;
             accessToken?: string | undefined;
         };
         slug?: string | undefined;
@@ -1195,6 +1224,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             blueprintId?: string | undefined;
             sessionDuration?: number | undefined;
             contactCollection?: boolean | undefined;
+            allowFrom?: string | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -1203,6 +1233,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         properties: {
             name?: string | undefined;
             botId?: string | undefined;
+            maxIterations?: number | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -1211,6 +1242,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             sessionDuration?: number | undefined;
             authenticate?: boolean | undefined;
             triggerSchedule?: "never" | "quarterhourly" | "halfhourly" | "hourly" | "daily" | "weekly" | "monthly" | undefined;
+            maxTime?: number | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -1461,6 +1493,7 @@ export class Resource {
             ratings?: boolean | undefined;
             visibleMessages?: number | undefined;
             autoRespond?: string | undefined;
+            allowFrom?: string | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -1477,6 +1510,7 @@ export class Resource {
             sessionDuration?: number | undefined;
             contactCollection?: boolean | undefined;
             botToken?: string | undefined;
+            allowFrom?: string | undefined;
             appId?: string | undefined;
             publicKey?: string | undefined;
             handle?: string | undefined;
@@ -1497,6 +1531,7 @@ export class Resource {
             sessionDuration?: number | undefined;
             contactCollection?: boolean | undefined;
             botToken?: string | undefined;
+            allowFrom?: string | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -1513,6 +1548,7 @@ export class Resource {
             blueprintId?: string | undefined;
             sessionDuration?: number | undefined;
             contactCollection?: boolean | undefined;
+            allowFrom?: string | undefined;
             phoneNumberId?: string | undefined;
             accessToken?: string | undefined;
         };
@@ -1530,6 +1566,7 @@ export class Resource {
             } | undefined;
             blueprintId?: string | undefined;
             sessionDuration?: number | undefined;
+            contactCollection?: boolean | undefined;
             accessToken?: string | undefined;
         };
         slug?: string | undefined;
@@ -1563,6 +1600,7 @@ export class Resource {
             blueprintId?: string | undefined;
             sessionDuration?: number | undefined;
             contactCollection?: boolean | undefined;
+            allowFrom?: string | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -1571,6 +1609,7 @@ export class Resource {
         properties: {
             name?: string | undefined;
             botId?: string | undefined;
+            maxIterations?: number | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -1579,6 +1618,7 @@ export class Resource {
             sessionDuration?: number | undefined;
             authenticate?: boolean | undefined;
             triggerSchedule?: "never" | "quarterhourly" | "halfhourly" | "hourly" | "daily" | "weekly" | "monthly" | undefined;
+            maxTime?: number | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -1909,6 +1949,7 @@ export class Solution {
                 ratings?: boolean | undefined;
                 visibleMessages?: number | undefined;
                 autoRespond?: string | undefined;
+                allowFrom?: string | undefined;
             };
             slug?: string | undefined;
             id?: string | undefined;
@@ -1925,6 +1966,7 @@ export class Solution {
                 sessionDuration?: number | undefined;
                 contactCollection?: boolean | undefined;
                 botToken?: string | undefined;
+                allowFrom?: string | undefined;
                 appId?: string | undefined;
                 publicKey?: string | undefined;
                 handle?: string | undefined;
@@ -1945,6 +1987,7 @@ export class Solution {
                 sessionDuration?: number | undefined;
                 contactCollection?: boolean | undefined;
                 botToken?: string | undefined;
+                allowFrom?: string | undefined;
             };
             slug?: string | undefined;
             id?: string | undefined;
@@ -1961,6 +2004,7 @@ export class Solution {
                 blueprintId?: string | undefined;
                 sessionDuration?: number | undefined;
                 contactCollection?: boolean | undefined;
+                allowFrom?: string | undefined;
                 phoneNumberId?: string | undefined;
                 accessToken?: string | undefined;
             };
@@ -1978,6 +2022,7 @@ export class Solution {
                 } | undefined;
                 blueprintId?: string | undefined;
                 sessionDuration?: number | undefined;
+                contactCollection?: boolean | undefined;
                 accessToken?: string | undefined;
             };
             slug?: string | undefined;
@@ -2011,6 +2056,7 @@ export class Solution {
                 blueprintId?: string | undefined;
                 sessionDuration?: number | undefined;
                 contactCollection?: boolean | undefined;
+                allowFrom?: string | undefined;
             };
             slug?: string | undefined;
             id?: string | undefined;
@@ -2019,6 +2065,7 @@ export class Solution {
             properties: {
                 name?: string | undefined;
                 botId?: string | undefined;
+                maxIterations?: number | undefined;
                 description?: string | undefined;
                 meta?: {
                     [key: string]: unknown;
@@ -2027,6 +2074,7 @@ export class Solution {
                 sessionDuration?: number | undefined;
                 authenticate?: boolean | undefined;
                 triggerSchedule?: "never" | "quarterhourly" | "halfhourly" | "hourly" | "daily" | "weekly" | "monthly" | undefined;
+                maxTime?: number | undefined;
             };
             slug?: string | undefined;
             id?: string | undefined;

package/dist/esm/solution/index.js

@@ -205,6 +205,7 @@ export const SlackIntegrationResourceConfigSchema = BasicResourceConfigSchema.ex
         ratings: z.boolean().optional(),
         visibleMessages: z.number().optional(),
         autoRespond: z.string().optional(),
+        allowFrom: z.string().optional(),
     }),
 });
 export const DiscordIntegrationResourceConfigSchema = BasicResourceConfigSchema.extend({
@@ -224,6 +225,7 @@ export const DiscordIntegrationResourceConfigSchema = BasicResourceConfigSchema.
         sessionDuration: z.number().optional(),
         attachments: z.boolean().optional(),
         stream: z.boolean().optional(),
+        allowFrom: z.string().optional(),
     }),
 });
 export const TelegramIntegrationResourceConfigSchema = BasicResourceConfigSchema.extend({
@@ -238,6 +240,7 @@ export const TelegramIntegrationResourceConfigSchema = BasicResourceConfigSchema
         contactCollection: z.boolean().optional(),
         sessionDuration: z.number().optional(),
         attachments: z.boolean().optional(),
+        allowFrom: z.string().optional(),
     }),
 });
 export const WhatsAppIntegrationResourceConfigSchema = BasicResourceConfigSchema.extend({
@@ -253,6 +256,7 @@ export const WhatsAppIntegrationResourceConfigSchema = BasicResourceConfigSchema
         contactCollection: z.boolean().optional(),
         sessionDuration: z.number().optional(),
         attachments: z.boolean().optional(),
+        allowFrom: z.string().optional(),
     }),
 });
 export const MessengerIntegrationResourceConfigSchema = BasicResourceConfigSchema.extend({
@@ -293,6 +297,7 @@ export const EmailIntegrationResourceConfigSchema = BasicResourceConfigSchema.ex
         contactCollection: z.boolean().optional(),
         sessionDuration: z.number().optional(),
         attachments: z.boolean().optional(),
+        allowFrom: z.string().optional(),
     }),
 });
 export const TriggerIntegrationResourceConfigSchema = BasicResourceConfigSchema.extend({
@@ -316,6 +321,8 @@ export const TriggerIntegrationResourceConfigSchema = BasicResourceConfigSchema.
         ])
             .optional(),
         sessionDuration: z.number().optional(),
+        maxIterations: z.number().optional(),
+        maxTime: z.number().optional(),
     }),
 });
 export const SupportIntegrationResourceConfigSchema = BasicResourceConfigSchema.extend({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatbotkit/cli",
-  "version": "1.28.0",
+  "version": "1.29.0",
   "description": "ChatBotKit command line tools",
   "license": "ISC",
   "engines": {
@@ -1404,8 +1404,8 @@
     "js-yaml": "^4.1.0",
     "tslib": "^2.6.2",
     "zod": "^3.25.76",
-    "@chatbotkit/agent": "1.28.0",
-    "@chatbotkit/sdk": "1.28.0"
+    "@chatbotkit/agent": "1.29.0",
+    "@chatbotkit/sdk": "1.29.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",