@chatbotkit/cli 1.26.3 → 1.27.0

package/dist/cjs/color.cjs

@@ -1,9 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatBlue = exports.RESET = exports.BLUE = void 0;
+exports.formatYellow = exports.formatRed = exports.formatBlue = exports.RESET = exports.YELLOW = exports.RED = exports.BLUE = void 0;
 exports.BLUE = '\u001b[34m';
+exports.RED = '\u001b[31m';
+exports.YELLOW = '\u001b[33m';
 exports.RESET = '\u001b[0m';
 const formatBlue = (text) => {
     return `${exports.BLUE}${text}${exports.RESET}`;
 };
 exports.formatBlue = formatBlue;
+const formatRed = (text) => {
+    return `${exports.RED}${text}${exports.RESET}`;
+};
+exports.formatRed = formatRed;
+const formatYellow = (text) => {
+    return `${exports.YELLOW}${text}${exports.RESET}`;
+};
+exports.formatYellow = formatYellow;

package/dist/cjs/color.d.ts

@@ -1,3 +1,7 @@
 export const BLUE: "\u001B[34m";
+export const RED: "\u001B[31m";
+export const YELLOW: "\u001B[33m";
 export const RESET: "\u001B[0m";
 export function formatBlue(text: string): string;
+export function formatRed(text: string): string;
+export function formatYellow(text: string): string;

package/dist/cjs/command/run/index.cjs

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const output_js_1 = require("../../output.cjs");
+const child_process_1 = require("child_process");
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const url_1 = require("url");
+const __dirname = (0, path_1.dirname)((0, url_1.fileURLToPath)(import.meta.url));
+const loaderPath = (0, path_1.join)(__dirname, '..', '..', 'loader', 'index.js');
+function resolveScriptPath(scriptPath) {
+    if ((0, path_1.isAbsolute)(scriptPath)) {
+        return scriptPath;
+    }
+    return (0, path_1.resolve)(process.cwd(), scriptPath);
+}
+async function runScript(scriptPath, scriptArgs) {
+    const absolutePath = resolveScriptPath(scriptPath);
+    if (!(0, fs_1.existsSync)(absolutePath)) {
+        (0, output_js_1.printError)(new output_js_1.CommandError(`Script not found: ${scriptPath}`));
+    }
+    return new Promise((resolve) => {
+        const child = (0, child_process_1.spawn)(process.execPath, [
+            '--import',
+            loaderPath,
+            absolutePath,
+            ...scriptArgs,
+        ], {
+            stdio: 'inherit',
+            env: {
+                ...process.env,
+                CBK_API_KEY: process.env.CBK_API_KEY || process.env.CHATBOTKIT_API_KEY,
+            },
+            cwd: process.cwd(),
+        });
+        child.on('close', (code) => {
+            resolve(code ?? 0);
+        });
+        child.on('error', (err) => {
+            (0, output_js_1.printError)(new output_js_1.CommandError(`Failed to run script: ${err.message}`));
+        });
+    });
+}
+exports.command = new commander_1.Command()
+    .name('run')
+    .description('Run a JavaScript file with @chatbotkit/* packages available')
+    .argument('<script>', 'Path to the JavaScript file to run')
+    .argument('[args...]', 'Arguments to pass to the script')
+    .allowUnknownOption(true)
+    .allowExcessArguments(true)
+    .helpOption('-h, --help', 'Display help for the run command')
+    .addHelpText('after', `
+Examples:
+  $ cbk run script.js
+  $ cbk run ./scripts/deploy.js --env production
+  $ cbk run analyze.js data.json
+
+Available packages (no installation required):
+  @chatbotkit/sdk     - Main SDK for ChatBotKit API
+  @chatbotkit/agent   - Agent utilities for building AI agents
+  @chatbotkit/fetch   - Fetch utilities
+  @chatbotkit/cli     - CLI utilities (Command, Option, Argument)
+
+Example script:
+  import { ChatBotKit } from '@chatbotkit/sdk'
+  import { Command } from '@chatbotkit/cli'
+
+  const program = new Command()
+    .option('-e, --env <env>', 'Environment', 'production')
+    .parse()
+
+  const client = new ChatBotKit({
+    secret: process.env.CBK_API_KEY
+  })
+
+  console.log('Running in', program.opts().env)
+`)
+    .action(async (script, args) => {
+    const exitCode = await runScript(script, args);
+    process.exit(exitCode);
+});
+exports.default = exports.command;

package/dist/cjs/command/run/index.d.ts

@@ -0,0 +1,3 @@
+export const command: Command;
+export default command;
+import { Command } from 'commander';

package/dist/cjs/index.cjs

@@ -1,13 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.Argument = exports.Option = exports.Command = void 0;
 exports.default = cbk;
 const tslib_1 = require("tslib");
 const color_js_1 = require("./color.cjs");
 const index_js_1 = tslib_1.__importDefault(require("./command/agent/index.cjs"));
 const index_js_2 = tslib_1.__importDefault(require("./command/api/index.cjs"));
 const index_js_3 = tslib_1.__importDefault(require("./command/chat/index.cjs"));
-const index_js_4 = tslib_1.__importDefault(require("./command/solution/index.cjs"));
+const index_js_4 = tslib_1.__importDefault(require("./command/run/index.cjs"));
+const index_js_5 = tslib_1.__importDefault(require("./command/solution/index.cjs"));
 const commander_1 = require("commander");
+Object.defineProperty(exports, "Argument", { enumerable: true, get: function () { return commander_1.Argument; } });
+Object.defineProperty(exports, "Command", { enumerable: true, get: function () { return commander_1.Command; } });
+Object.defineProperty(exports, "Option", { enumerable: true, get: function () { return commander_1.Option; } });
 function printBanner() {
     console.log((0, color_js_1.formatBlue)(`
  .d8888b.  888888b.   888    d8P
@@ -32,5 +37,6 @@ async function cbk(argv = process.argv) {
     program.addCommand(index_js_1.default);
     program.addCommand(index_js_3.default);
     program.addCommand(index_js_4.default);
+    program.addCommand(index_js_5.default);
     program.parse(argv);
 }

package/dist/cjs/index.d.ts

@@ -1 +1,5 @@
 export default function cbk(argv?: string[]): Promise<void>;
+import { Command } from 'commander';
+import { Option } from 'commander';
+import { Argument } from 'commander';
+export { Command, Option, Argument };

package/dist/cjs/loader/hooks.cjs

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolve = resolve;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const url_1 = require("url");
+const __dirname = (0, path_1.dirname)((0, url_1.fileURLToPath)(import.meta.url));
+const cliRoot = (0, path_1.join)(__dirname, '..', '..');
+const cliNodeModules = (0, path_1.join)(cliRoot, 'node_modules');
+function resolvePackageExport(packagePath, subpath) {
+    const packageJsonPath = (0, path_1.join)(packagePath, 'package.json');
+    if (!(0, fs_1.existsSync)(packageJsonPath)) {
+        return null;
+    }
+    try {
+        const packageJson = JSON.parse((0, fs_1.readFileSync)(packageJsonPath, 'utf-8'));
+        const exportKey = subpath ? './' + subpath : '.';
+        if (packageJson.exports) {
+            const exportEntry = packageJson.exports[exportKey];
+            if (exportEntry) {
+                let importPath;
+                if (typeof exportEntry === 'string') {
+                    importPath = exportEntry;
+                }
+                else if (exportEntry.import) {
+                    importPath = exportEntry.import;
+                }
+                else if (exportEntry.default) {
+                    importPath = exportEntry.default;
+                }
+                if (importPath) {
+                    const resolved = (0, path_1.join)(packagePath, importPath);
+                    if ((0, fs_1.existsSync)(resolved)) {
+                        return resolved;
+                    }
+                }
+            }
+        }
+        if (!subpath && packageJson.main) {
+            const resolved = (0, path_1.join)(packagePath, packageJson.main);
+            if ((0, fs_1.existsSync)(resolved)) {
+                return resolved;
+            }
+        }
+        if (!subpath) {
+            const indexPath = (0, path_1.join)(packagePath, 'index.js');
+            if ((0, fs_1.existsSync)(indexPath)) {
+                return indexPath;
+            }
+        }
+    }
+    catch {
+    }
+    return null;
+}
+async function resolve(specifier, context, nextResolve) {
+    if (specifier.startsWith('@chatbotkit/')) {
+        const parts = specifier.split('/');
+        const packageName = parts[0] + '/' + parts[1];
+        const subpath = parts.slice(2).join('/');
+        if (packageName === '@chatbotkit/cli') {
+            const resolved = resolvePackageExport(cliRoot, subpath);
+            if (resolved) {
+                return {
+                    url: (0, url_1.pathToFileURL)(resolved).href,
+                    shortCircuit: true,
+                };
+            }
+        }
+        const packagePath = (0, path_1.join)(cliNodeModules, packageName);
+        if ((0, fs_1.existsSync)(packagePath)) {
+            const resolved = resolvePackageExport(packagePath, subpath);
+            if (resolved) {
+                return {
+                    url: (0, url_1.pathToFileURL)(resolved).href,
+                    shortCircuit: true,
+                };
+            }
+        }
+    }
+    return nextResolve(specifier, context);
+}

package/dist/cjs/loader/hooks.d.ts

@@ -0,0 +1,4 @@
+export function resolve(specifier: string, context: object, nextResolve: Function): Promise<{
+    url: string;
+    shortCircuit?: boolean;
+}>;

package/dist/cjs/loader/index.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_module_1 = require("node:module");
+const path_1 = require("path");
+const url_1 = require("url");
+const __dirname = (0, path_1.dirname)((0, url_1.fileURLToPath)(import.meta.url));
+const hooksPath = (0, path_1.join)(__dirname, 'hooks.js');
+(0, node_module_1.register)((0, url_1.pathToFileURL)(hooksPath).href, import.meta.url);

package/dist/cjs/loader/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/solution/index.cjs

@@ -60,6 +60,7 @@ exports.BasicResourceConfigSchema = zod_1.z.object({
 exports.BlueprintResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
     type: zod_1.z.literal('blueprint'),
     properties: zod_1.z.object({
+        alias: zod_1.z.string().optional(),
         name: zod_1.z.string().optional(),
         description: zod_1.z.string().optional(),
         meta: zod_1.z.record(zod_1.z.unknown()).optional(),
@@ -69,6 +70,7 @@ exports.BlueprintResourceConfigSchema = exports.BasicResourceConfigSchema.extend
 exports.BotResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
     type: zod_1.z.literal('bot'),
     properties: zod_1.z.object({
+        alias: zod_1.z.string().optional(),
         name: zod_1.z.string().optional(),
         description: zod_1.z.string().optional(),
         meta: zod_1.z.record(zod_1.z.unknown()).optional(),
@@ -85,6 +87,7 @@ exports.BotResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
 exports.DatasetResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
     type: zod_1.z.literal('dataset'),
     properties: zod_1.z.object({
+        alias: zod_1.z.string().optional(),
         name: zod_1.z.string().optional(),
         description: zod_1.z.string().optional(),
         meta: zod_1.z.record(zod_1.z.unknown()).optional(),
@@ -104,6 +107,7 @@ exports.DatasetResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
 exports.FileResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
     type: zod_1.z.literal('file'),
     properties: zod_1.z.object({
+        alias: zod_1.z.string().optional(),
         name: zod_1.z.string().optional(),
         description: zod_1.z.string().optional(),
         meta: zod_1.z.record(zod_1.z.unknown()).optional(),
@@ -114,6 +118,7 @@ exports.FileResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
 exports.SecretResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
     type: zod_1.z.literal('secret'),
     properties: zod_1.z.object({
+        alias: zod_1.z.string().optional(),
         name: zod_1.z.string().optional(),
         description: zod_1.z.string().optional(),
         meta: zod_1.z.record(zod_1.z.unknown()).optional(),
@@ -130,6 +135,7 @@ exports.SecretResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
 exports.SkillsetResourceConfigSchema = exports.BasicResourceConfigSchema.extend({
     type: zod_1.z.literal('skillset'),
     properties: zod_1.z.object({
+        alias: zod_1.z.string().optional(),
         name: zod_1.z.string().optional(),
         description: zod_1.z.string().optional(),
         meta: zod_1.z.record(zod_1.z.unknown()).optional(),

package/dist/esm/color.d.ts

@@ -1,3 +1,7 @@
 export const BLUE: "\u001B[34m";
+export const RED: "\u001B[31m";
+export const YELLOW: "\u001B[33m";
 export const RESET: "\u001B[0m";
 export function formatBlue(text: string): string;
+export function formatRed(text: string): string;
+export function formatYellow(text: string): string;

package/dist/esm/color.js

@@ -1,5 +1,13 @@
 export const BLUE = '\u001b[34m';
+export const RED = '\u001b[31m';
+export const YELLOW = '\u001b[33m';
 export const RESET = '\u001b[0m';
 export const formatBlue = (text) => {
     return `${BLUE}${text}${RESET}`;
 };
+export const formatRed = (text) => {
+    return `${RED}${text}${RESET}`;
+};
+export const formatYellow = (text) => {
+    return `${YELLOW}${text}${RESET}`;
+};

package/dist/esm/command/run/index.d.ts

@@ -0,0 +1,3 @@
+export const command: Command;
+export default command;
+import { Command } from 'commander';

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

@@ -0,0 +1,80 @@
+import { CommandError, printError } from '../../output.js';
+import { spawn } from 'child_process';
+import { Command } from 'commander';
+import { existsSync } from 'fs';
+import { dirname, isAbsolute, join, resolve } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const loaderPath = join(__dirname, '..', '..', 'loader', 'index.js');
+function resolveScriptPath(scriptPath) {
+    if (isAbsolute(scriptPath)) {
+        return scriptPath;
+    }
+    return resolve(process.cwd(), scriptPath);
+}
+async function runScript(scriptPath, scriptArgs) {
+    const absolutePath = resolveScriptPath(scriptPath);
+    if (!existsSync(absolutePath)) {
+        printError(new CommandError(`Script not found: ${scriptPath}`));
+    }
+    return new Promise((resolve) => {
+        const child = spawn(process.execPath, [
+            '--import',
+            loaderPath,
+            absolutePath,
+            ...scriptArgs,
+        ], {
+            stdio: 'inherit',
+            env: {
+                ...process.env,
+                CBK_API_KEY: process.env.CBK_API_KEY || process.env.CHATBOTKIT_API_KEY,
+            },
+            cwd: process.cwd(),
+        });
+        child.on('close', (code) => {
+            resolve(code ?? 0);
+        });
+        child.on('error', (err) => {
+            printError(new CommandError(`Failed to run script: ${err.message}`));
+        });
+    });
+}
+export const command = new Command()
+    .name('run')
+    .description('Run a JavaScript file with @chatbotkit/* packages available')
+    .argument('<script>', 'Path to the JavaScript file to run')
+    .argument('[args...]', 'Arguments to pass to the script')
+    .allowUnknownOption(true)
+    .allowExcessArguments(true)
+    .helpOption('-h, --help', 'Display help for the run command')
+    .addHelpText('after', `
+Examples:
+  $ cbk run script.js
+  $ cbk run ./scripts/deploy.js --env production
+  $ cbk run analyze.js data.json
+
+Available packages (no installation required):
+  @chatbotkit/sdk     - Main SDK for ChatBotKit API
+  @chatbotkit/agent   - Agent utilities for building AI agents
+  @chatbotkit/fetch   - Fetch utilities
+  @chatbotkit/cli     - CLI utilities (Command, Option, Argument)
+
+Example script:
+  import { ChatBotKit } from '@chatbotkit/sdk'
+  import { Command } from '@chatbotkit/cli'
+
+  const program = new Command()
+    .option('-e, --env <env>', 'Environment', 'production')
+    .parse()
+
+  const client = new ChatBotKit({
+    secret: process.env.CBK_API_KEY
+  })
+
+  console.log('Running in', program.opts().env)
+`)
+    .action(async (script, args) => {
+    const exitCode = await runScript(script, args);
+    process.exit(exitCode);
+});
+export default command;

package/dist/esm/index.d.ts

@@ -1 +1,5 @@
 export default function cbk(argv?: string[]): Promise<void>;
+import { Command } from 'commander';
+import { Option } from 'commander';
+import { Argument } from 'commander';
+export { Command, Option, Argument };

package/dist/esm/index.js

@@ -2,8 +2,10 @@ import { formatBlue } from './color.js';
 import agent from './command/agent/index.js';
 import command from './command/api/index.js';
 import chat from './command/chat/index.js';
+import run from './command/run/index.js';
 import solution from './command/solution/index.js';
-import { Command } from 'commander';
+import { Argument, Command, Option } from 'commander';
+export { Command, Option, Argument };
 function printBanner() {
     console.log(formatBlue(`
  .d8888b.  888888b.   888    d8P
@@ -27,6 +29,7 @@ export default async function cbk(argv = process.argv) {
     program.addCommand(command);
     program.addCommand(agent);
     program.addCommand(chat);
+    program.addCommand(run);
     program.addCommand(solution);
     program.parse(argv);
 }

package/dist/esm/loader/hooks.d.ts

@@ -0,0 +1,4 @@
+export function resolve(specifier: string, context: object, nextResolve: Function): Promise<{
+    url: string;
+    shortCircuit?: boolean;
+}>;

package/dist/esm/loader/hooks.js

@@ -0,0 +1,79 @@
+import { existsSync, readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath, pathToFileURL } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cliRoot = join(__dirname, '..', '..');
+const cliNodeModules = join(cliRoot, 'node_modules');
+function resolvePackageExport(packagePath, subpath) {
+    const packageJsonPath = join(packagePath, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        return null;
+    }
+    try {
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        const exportKey = subpath ? './' + subpath : '.';
+        if (packageJson.exports) {
+            const exportEntry = packageJson.exports[exportKey];
+            if (exportEntry) {
+                let importPath;
+                if (typeof exportEntry === 'string') {
+                    importPath = exportEntry;
+                }
+                else if (exportEntry.import) {
+                    importPath = exportEntry.import;
+                }
+                else if (exportEntry.default) {
+                    importPath = exportEntry.default;
+                }
+                if (importPath) {
+                    const resolved = join(packagePath, importPath);
+                    if (existsSync(resolved)) {
+                        return resolved;
+                    }
+                }
+            }
+        }
+        if (!subpath && packageJson.main) {
+            const resolved = join(packagePath, packageJson.main);
+            if (existsSync(resolved)) {
+                return resolved;
+            }
+        }
+        if (!subpath) {
+            const indexPath = join(packagePath, 'index.js');
+            if (existsSync(indexPath)) {
+                return indexPath;
+            }
+        }
+    }
+    catch {
+    }
+    return null;
+}
+export async function resolve(specifier, context, nextResolve) {
+    if (specifier.startsWith('@chatbotkit/')) {
+        const parts = specifier.split('/');
+        const packageName = parts[0] + '/' + parts[1];
+        const subpath = parts.slice(2).join('/');
+        if (packageName === '@chatbotkit/cli') {
+            const resolved = resolvePackageExport(cliRoot, subpath);
+            if (resolved) {
+                return {
+                    url: pathToFileURL(resolved).href,
+                    shortCircuit: true,
+                };
+            }
+        }
+        const packagePath = join(cliNodeModules, packageName);
+        if (existsSync(packagePath)) {
+            const resolved = resolvePackageExport(packagePath, subpath);
+            if (resolved) {
+                return {
+                    url: pathToFileURL(resolved).href,
+                    shortCircuit: true,
+                };
+            }
+        }
+    }
+    return nextResolve(specifier, context);
+}

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

@@ -0,0 +1 @@
+export {};

package/dist/esm/loader/index.js

@@ -0,0 +1,6 @@
+import { register } from 'node:module';
+import { dirname, join } from 'path';
+import { fileURLToPath, pathToFileURL } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const hooksPath = join(__dirname, 'hooks.js');
+register(pathToFileURL(hooksPath).href, import.meta.url);

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

@@ -40,6 +40,7 @@ export const ExtractIntegrationResourceConfigSchema: ResourceConfigSchemaFor<"ex
 export const McpServerIntegrationResourceConfigSchema: ResourceConfigSchemaFor<"mcpserverIntegration", import("@chatbotkit/sdk/integration/mcpserver/v1").McpServerIntegrationCreateRequest>;
 export const TwilioIntegrationResourceConfigSchema: ResourceConfigSchemaFor<"twilioIntegration", import("@chatbotkit/sdk/integration/twilio/v1").TwilioIntegrationCreateRequest>;
 export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprint", {
+    alias?: string;
     name?: string;
     description?: string;
     meta?: {
@@ -47,6 +48,7 @@ export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprin
     };
     visibility?: "private" | "protected" | "public";
 }>, ResourceConfigSchemaFor<"bot", import("@chatbotkit/sdk/bot/v1").BotCreateRequest>, ResourceConfigSchemaFor<"dataset", {
+    alias?: string;
     name?: string;
     description?: string;
     meta?: {
@@ -64,6 +66,7 @@ export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprin
     separators?: string;
     visibility?: "private" | "protected" | "public";
 }>, ResourceConfigSchemaFor<"file", {
+    alias?: string;
     name?: string;
     description?: string;
     meta?: {
@@ -72,6 +75,7 @@ export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprin
     blueprintId?: string;
     visibility?: "private" | "protected" | "public";
 }>, ResourceConfigSchemaFor<"secret", {
+    alias?: string;
     name?: string;
     description?: string;
     meta?: {
@@ -86,6 +90,7 @@ export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprin
     };
     visibility?: "private" | "protected" | "public";
 }>, ResourceConfigSchemaFor<"skillset", {
+    alias?: string;
     name?: string;
     description?: string;
     meta?: {
@@ -287,6 +292,7 @@ export const ResourceConfigSchema: z.ZodUnion<[ResourceConfigSchemaFor<"blueprin
 export const SolutionConfigSchema: z.ZodObject<{
     version: z.ZodLiteral<1>;
     resources: z.ZodArray<z.ZodUnion<[ResourceConfigSchemaFor<"blueprint", {
+        alias?: string;
         name?: string;
         description?: string;
         meta?: {
@@ -294,6 +300,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         };
         visibility?: "private" | "protected" | "public";
     }>, ResourceConfigSchemaFor<"bot", import("@chatbotkit/sdk/bot/v1").BotCreateRequest>, ResourceConfigSchemaFor<"dataset", {
+        alias?: string;
         name?: string;
         description?: string;
         meta?: {
@@ -311,6 +318,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         separators?: string;
         visibility?: "private" | "protected" | "public";
     }>, ResourceConfigSchemaFor<"file", {
+        alias?: string;
         name?: string;
         description?: string;
         meta?: {
@@ -319,6 +327,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         blueprintId?: string;
         visibility?: "private" | "protected" | "public";
     }>, ResourceConfigSchemaFor<"secret", {
+        alias?: string;
         name?: string;
         description?: string;
         meta?: {
@@ -333,6 +342,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         };
         visibility?: "private" | "protected" | "public";
     }>, ResourceConfigSchemaFor<"skillset", {
+        alias?: string;
         name?: string;
         description?: string;
         meta?: {
@@ -537,6 +547,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         type: "blueprint";
         properties: {
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -555,6 +566,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             skillsetId?: string | undefined;
             privacy?: boolean | undefined;
             moderation?: boolean | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -568,6 +580,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         type: "dataset";
         properties: {
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -590,6 +603,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         type: "file";
         properties: {
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -605,16 +619,17 @@ export const SolutionConfigSchema: z.ZodObject<{
             value?: string | undefined;
             type?: "plain" | "basic" | "bearer" | "oauth" | "template" | "reference" | undefined;
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
             } | undefined;
             visibility?: "private" | "protected" | "public" | undefined;
             blueprintId?: string | undefined;
-            kind?: "shared" | "personal" | undefined;
             config?: {
                 [key: string]: unknown;
             } | undefined;
+            kind?: "shared" | "personal" | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -622,6 +637,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         type: "skillset";
         properties: {
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -898,6 +914,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         type: "blueprint";
         properties: {
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -916,6 +933,7 @@ export const SolutionConfigSchema: z.ZodObject<{
             skillsetId?: string | undefined;
             privacy?: boolean | undefined;
             moderation?: boolean | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -929,6 +947,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         type: "dataset";
         properties: {
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -951,6 +970,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         type: "file";
         properties: {
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -966,16 +986,17 @@ export const SolutionConfigSchema: z.ZodObject<{
             value?: string | undefined;
             type?: "plain" | "basic" | "bearer" | "oauth" | "template" | "reference" | undefined;
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
             } | undefined;
             visibility?: "private" | "protected" | "public" | undefined;
             blueprintId?: string | undefined;
-            kind?: "shared" | "personal" | undefined;
             config?: {
                 [key: string]: unknown;
             } | undefined;
+            kind?: "shared" | "personal" | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -983,6 +1004,7 @@ export const SolutionConfigSchema: z.ZodObject<{
         type: "skillset";
         properties: {
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -1260,6 +1282,7 @@ export class Resource {
         type: "blueprint";
         properties: {
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -1278,6 +1301,7 @@ export class Resource {
             skillsetId?: string | undefined;
             privacy?: boolean | undefined;
             moderation?: boolean | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -1291,6 +1315,7 @@ export class Resource {
         type: "dataset";
         properties: {
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -1313,6 +1338,7 @@ export class Resource {
         type: "file";
         properties: {
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -1328,16 +1354,17 @@ export class Resource {
             value?: string | undefined;
             type?: "plain" | "basic" | "bearer" | "oauth" | "template" | "reference" | undefined;
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
             } | undefined;
             visibility?: "private" | "protected" | "public" | undefined;
             blueprintId?: string | undefined;
-            kind?: "shared" | "personal" | undefined;
             config?: {
                 [key: string]: unknown;
             } | undefined;
+            kind?: "shared" | "personal" | undefined;
         };
         slug?: string | undefined;
         id?: string | undefined;
@@ -1345,6 +1372,7 @@ export class Resource {
         type: "skillset";
         properties: {
             name?: string | undefined;
+            alias?: string | undefined;
             description?: string | undefined;
             meta?: {
                 [key: string]: unknown;
@@ -1702,6 +1730,7 @@ export class Solution {
             type: "blueprint";
             properties: {
                 name?: string | undefined;
+                alias?: string | undefined;
                 description?: string | undefined;
                 meta?: {
                     [key: string]: unknown;
@@ -1720,6 +1749,7 @@ export class Solution {
                 skillsetId?: string | undefined;
                 privacy?: boolean | undefined;
                 moderation?: boolean | undefined;
+                alias?: string | undefined;
                 description?: string | undefined;
                 meta?: {
                     [key: string]: unknown;
@@ -1733,6 +1763,7 @@ export class Solution {
             type: "dataset";
             properties: {
                 name?: string | undefined;
+                alias?: string | undefined;
                 description?: string | undefined;
                 meta?: {
                     [key: string]: unknown;
@@ -1755,6 +1786,7 @@ export class Solution {
             type: "file";
             properties: {
                 name?: string | undefined;
+                alias?: string | undefined;
                 description?: string | undefined;
                 meta?: {
                     [key: string]: unknown;
@@ -1770,16 +1802,17 @@ export class Solution {
                 value?: string | undefined;
                 type?: "plain" | "basic" | "bearer" | "oauth" | "template" | "reference" | undefined;
                 name?: string | undefined;
+                alias?: string | undefined;
                 description?: string | undefined;
                 meta?: {
                     [key: string]: unknown;
                 } | undefined;
                 visibility?: "private" | "protected" | "public" | undefined;
                 blueprintId?: string | undefined;
-                kind?: "shared" | "personal" | undefined;
                 config?: {
                     [key: string]: unknown;
                 } | undefined;
+                kind?: "shared" | "personal" | undefined;
             };
             slug?: string | undefined;
             id?: string | undefined;
@@ -1787,6 +1820,7 @@ export class Solution {
             type: "skillset";
             properties: {
                 name?: string | undefined;
+                alias?: string | undefined;
                 description?: string | undefined;
                 meta?: {
                     [key: string]: unknown;

package/dist/esm/solution/index.js

@@ -50,6 +50,7 @@ export const BasicResourceConfigSchema = z.object({
 export const BlueprintResourceConfigSchema = BasicResourceConfigSchema.extend({
     type: z.literal('blueprint'),
     properties: z.object({
+        alias: z.string().optional(),
         name: z.string().optional(),
         description: z.string().optional(),
         meta: z.record(z.unknown()).optional(),
@@ -59,6 +60,7 @@ export const BlueprintResourceConfigSchema = BasicResourceConfigSchema.extend({
 export const BotResourceConfigSchema = BasicResourceConfigSchema.extend({
     type: z.literal('bot'),
     properties: z.object({
+        alias: z.string().optional(),
         name: z.string().optional(),
         description: z.string().optional(),
         meta: z.record(z.unknown()).optional(),
@@ -75,6 +77,7 @@ export const BotResourceConfigSchema = BasicResourceConfigSchema.extend({
 export const DatasetResourceConfigSchema = BasicResourceConfigSchema.extend({
     type: z.literal('dataset'),
     properties: z.object({
+        alias: z.string().optional(),
         name: z.string().optional(),
         description: z.string().optional(),
         meta: z.record(z.unknown()).optional(),
@@ -94,6 +97,7 @@ export const DatasetResourceConfigSchema = BasicResourceConfigSchema.extend({
 export const FileResourceConfigSchema = BasicResourceConfigSchema.extend({
     type: z.literal('file'),
     properties: z.object({
+        alias: z.string().optional(),
         name: z.string().optional(),
         description: z.string().optional(),
         meta: z.record(z.unknown()).optional(),
@@ -104,6 +108,7 @@ export const FileResourceConfigSchema = BasicResourceConfigSchema.extend({
 export const SecretResourceConfigSchema = BasicResourceConfigSchema.extend({
     type: z.literal('secret'),
     properties: z.object({
+        alias: z.string().optional(),
         name: z.string().optional(),
         description: z.string().optional(),
         meta: z.record(z.unknown()).optional(),
@@ -120,6 +125,7 @@ export const SecretResourceConfigSchema = BasicResourceConfigSchema.extend({
 export const SkillsetResourceConfigSchema = BasicResourceConfigSchema.extend({
     type: z.literal('skillset'),
     properties: z.object({
+        alias: z.string().optional(),
         name: z.string().optional(),
         description: z.string().optional(),
         meta: z.record(z.unknown()).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatbotkit/cli",
-  "version": "1.26.3",
+  "version": "1.27.0",
   "description": "ChatBotKit command line tools",
   "license": "ISC",
   "engines": {
@@ -1095,6 +1095,36 @@
         "default": "./dist/cjs/command/chat/index.cjs"
       }
     },
+    "./command/run": {
+      "import": {
+        "types": "./dist/esm/command/run/index.d.ts",
+        "default": "./dist/esm/command/run/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/command/run/index.d.ts",
+        "default": "./dist/cjs/command/run/index.cjs"
+      }
+    },
+    "./command/run/index": {
+      "import": {
+        "types": "./dist/esm/command/run/index.d.ts",
+        "default": "./dist/esm/command/run/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/command/run/index.d.ts",
+        "default": "./dist/cjs/command/run/index.cjs"
+      }
+    },
+    "./command/run/index.js": {
+      "import": {
+        "types": "./dist/esm/command/run/index.d.ts",
+        "default": "./dist/esm/command/run/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/command/run/index.d.ts",
+        "default": "./dist/cjs/command/run/index.cjs"
+      }
+    },
     "./command/solution": {
       "import": {
         "types": "./dist/esm/command/solution/index.d.ts",
@@ -1225,6 +1255,56 @@
         "default": "./dist/cjs/input.cjs"
       }
     },
+    "./loader/hooks": {
+      "import": {
+        "types": "./dist/esm/loader/hooks.d.ts",
+        "default": "./dist/esm/loader/hooks.js"
+      },
+      "require": {
+        "types": "./dist/cjs/loader/hooks.d.ts",
+        "default": "./dist/cjs/loader/hooks.cjs"
+      }
+    },
+    "./loader/hooks.js": {
+      "import": {
+        "types": "./dist/esm/loader/hooks.d.ts",
+        "default": "./dist/esm/loader/hooks.js"
+      },
+      "require": {
+        "types": "./dist/cjs/loader/hooks.d.ts",
+        "default": "./dist/cjs/loader/hooks.cjs"
+      }
+    },
+    "./loader": {
+      "import": {
+        "types": "./dist/esm/loader/index.d.ts",
+        "default": "./dist/esm/loader/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/loader/index.d.ts",
+        "default": "./dist/cjs/loader/index.cjs"
+      }
+    },
+    "./loader/index": {
+      "import": {
+        "types": "./dist/esm/loader/index.d.ts",
+        "default": "./dist/esm/loader/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/loader/index.d.ts",
+        "default": "./dist/cjs/loader/index.cjs"
+      }
+    },
+    "./loader/index.js": {
+      "import": {
+        "types": "./dist/esm/loader/index.d.ts",
+        "default": "./dist/esm/loader/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/loader/index.d.ts",
+        "default": "./dist/cjs/loader/index.cjs"
+      }
+    },
     "./output": {
       "import": {
         "types": "./dist/esm/output.d.ts",
@@ -1324,8 +1404,8 @@
     "js-yaml": "^4.1.0",
     "tslib": "^2.6.2",
     "zod": "^3.25.76",
-    "@chatbotkit/agent": "1.26.3",
-    "@chatbotkit/sdk": "1.26.3"
+    "@chatbotkit/agent": "1.26.5",
+    "@chatbotkit/sdk": "1.26.5"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",