@memberjunction/cli 2.77.0 → 2.78.0

package/README.md

@@ -52,6 +52,15 @@ interface MJConfig {
   coreSchema?: string;         // Core schema name (default: '__mj')
   cleanDisabled?: boolean;     // Disable database cleaning (default: true)
   mjRepoUrl?: string;          // MemberJunction repository URL
+  
+  // AI-specific settings (optional)
+  aiSettings?: {
+    defaultTimeout?: number;    // Default timeout for AI operations (default: 300000ms)
+    outputFormat?: 'compact' | 'json' | 'table'; // Default output format
+    logLevel?: 'info' | 'debug' | 'verbose';     // Logging detail level
+    enableChat?: boolean;       // Enable chat features (default: true)
+    chatHistoryLimit?: number;  // Chat history size limit
+  };
 }
 ```
 
@@ -106,6 +115,129 @@ mj sync push
 mj sync watch
 ```
 
+### `mj ai`
+
+Execute AI agents and actions using MemberJunction's AI framework. This command provides access to 20+ AI agents and 30+ actions for various tasks.
+
+```bash
+mj ai [COMMAND] [OPTIONS]
+```
+
+Available AI commands:
+- `agents list` - List available AI agents
+- `agents run` - Execute an AI agent with a prompt or start interactive chat
+- `actions list` - List available AI actions
+- `actions run` - Execute an AI action with parameters
+- `prompts list` - List available AI models for direct prompt execution
+- `prompts run` - Execute a direct prompt with an AI model
+
+#### Quick Examples:
+
+```bash
+# List all available agents
+mj ai agents list
+
+# Execute an agent with a prompt
+mj ai agents run -a "Skip: Requirements Expert" -p "Create a dashboard for sales metrics"
+
+# Start interactive chat with an agent
+mj ai agents run -a "Child Component Generator Sub-agent" --chat
+
+# List all available actions
+mj ai actions list --output=table
+
+# Execute an action with parameters
+mj ai actions run -n "Get Weather" --param "Location=Boston"
+
+# Execute action with multiple parameters
+mj ai actions run -n "Send Single Message" \
+  --param "To=user@example.com" \
+  --param "Subject=Test Message" \
+  --param "Body=Hello from MJ CLI"
+
+# Validate action without executing
+mj ai actions run -n "Calculate Expression" --param "Expression=2+2*3" --dry-run
+
+# List available AI models
+mj ai prompts list
+
+# Execute a direct prompt
+mj ai prompts run -p "Explain quantum computing in simple terms"
+
+# Use a specific model
+mj ai prompts run -p "Write a Python function to sort a list" --model "gpt-4"
+
+# Use system prompt and temperature
+mj ai prompts run -p "Generate a haiku" --system "You are a poet" --temperature 0.3
+```
+
+#### AI Command Options:
+
+**Agent Commands:**
+- `-a, --agent <name>`: Agent name (required)
+- `-p, --prompt <text>`: Prompt to execute
+- `-c, --chat`: Start interactive chat mode
+- `-o, --output <format>`: Output format (compact, json, table)
+- `-v, --verbose`: Show detailed execution information
+- `--timeout <ms>`: Execution timeout in milliseconds (default: 300000)
+
+**Action Commands:**
+- `-n, --name <name>`: Action name (required)
+- `-p, --param <key=value>`: Action parameters (can be specified multiple times)
+- `--dry-run`: Validate without executing
+- `-o, --output <format>`: Output format (compact, json, table)
+- `-v, --verbose`: Show detailed execution information
+- `--timeout <ms>`: Execution timeout in milliseconds (default: 300000)
+
+**Prompt Commands:**
+- `-p, --prompt <text>`: The prompt to execute (required)
+- `-m, --model <name>`: AI model to use (e.g., gpt-4, claude-3-opus)
+- `-s, --system <text>`: System prompt to set context
+- `-t, --temperature <0.0-2.0>`: Temperature for response creativity
+- `--max-tokens <number>`: Maximum tokens for the response
+- `-c, --configuration <id>`: AI Configuration ID to use
+- `-o, --output <format>`: Output format (compact, json, table)
+- `-v, --verbose`: Show detailed execution information
+- `--timeout <ms>`: Execution timeout in milliseconds (default: 300000)
+
+#### AI Features:
+
+**Progress Tracking**: Real-time visual progress indicators during agent execution
+- Compact single-line progress in normal mode
+- Detailed progress with metadata in verbose mode
+- Visual icons for each execution phase (🚀 initialization, ✓ validation, 💭 execution, etc.)
+
+**Text Formatting**: Automatic formatting of long AI responses for better readability
+- Word wrapping at console width
+- Paragraph and list preservation
+- Code block highlighting
+- JSON syntax coloring
+
+**Interactive Chat**: Full conversation context maintained across messages
+- Agent remembers previous exchanges
+- Natural back-and-forth dialogue
+- Exit with "exit", "quit", or Ctrl+C
+
+#### AI Configuration:
+
+Add AI-specific settings to your `mj.config.cjs`:
+
+```javascript
+module.exports = {
+  // Existing database settings...
+  
+  aiSettings: {
+    defaultTimeout: 300000,
+    outputFormat: 'compact',
+    logLevel: 'info',
+    enableChat: true,
+    chatHistoryLimit: 10
+  }
+};
+```
+
+Execution logs are stored in `.mj-ai/logs/` for debugging and audit purposes.
+
 ### `mj install`
 
 Performs a complete installation of MemberJunction, including:
@@ -208,6 +340,8 @@ The CLI respects the following environment variables:
 The CLI integrates seamlessly with other MemberJunction packages:
 
 - **@memberjunction/codegen-lib**: Powers the code generation functionality
+- **@memberjunction/metadata-sync**: Provides metadata synchronization capabilities
+- **@memberjunction/ai-cli**: Enables AI agent and action execution
 - **Generated Entities**: Automatically linked during installation
 - **MJAPI**: Configured and linked during installation
 - **MJExplorer**: UI configuration handled during installation

package/dist/commands/ai/actions/list.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@oclif/core';
+export default class ActionsList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/ai/actions/list.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const ai_cli_1 = require("@memberjunction/ai-cli");
+const ora_classic_1 = __importDefault(require("ora-classic"));
+class ActionsList extends core_1.Command {
+    static description = 'List available AI actions';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --output=table',
+        '<%= config.bin %> <%= command.id %> --output=json',
+    ];
+    static flags = {
+        output: core_1.Flags.string({
+            char: 'o',
+            description: 'Output format',
+            options: ['compact', 'json', 'table'],
+            default: 'compact',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ActionsList);
+        const spinner = (0, ora_classic_1.default)();
+        try {
+            spinner.start('Loading available actions...');
+            const service = new ai_cli_1.ActionService();
+            const actions = await service.listActions();
+            spinner.stop();
+            const formatter = new ai_cli_1.OutputFormatter(flags.output);
+            this.log(formatter.formatActionList(actions));
+            // Force exit after completion
+            process.exit(0);
+        }
+        catch (error) {
+            spinner.fail('Failed to load actions');
+            this.error(error);
+        }
+    }
+}
+exports.default = ActionsList;

package/dist/commands/ai/actions/run.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class ActionsRun extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        param: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/ai/actions/run.js

@@ -0,0 +1,94 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const ai_cli_1 = require("@memberjunction/ai-cli");
+const ora_classic_1 = __importDefault(require("ora-classic"));
+const chalk_1 = __importDefault(require("chalk"));
+class ActionsRun extends core_1.Command {
+    static description = 'Execute an AI action with parameters';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> -n "Get Weather" --param "Location=Boston"',
+        '<%= config.bin %> <%= command.id %> -n "Get Stock Price" --param "Ticker=AAPL"',
+        '<%= config.bin %> <%= command.id %> -n "Send Single Message" --param "To=user@example.com" --param "Subject=Test" --param "Body=Hello" --param "MessageType=Email" --param "Provider=SendGrid"',
+        '<%= config.bin %> <%= command.id %> -n "Calculate Expression" --param "Expression=2+2*3" --dry-run',
+    ];
+    static flags = {
+        name: core_1.Flags.string({
+            char: 'n',
+            description: 'Action name',
+            required: true,
+        }),
+        param: core_1.Flags.string({
+            char: 'p',
+            description: 'Action parameters in key=value format',
+            multiple: true,
+        }),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Validate without executing',
+        }),
+        output: core_1.Flags.string({
+            char: 'o',
+            description: 'Output format',
+            options: ['compact', 'json', 'table'],
+            default: 'compact',
+        }),
+        verbose: core_1.Flags.boolean({
+            char: 'v',
+            description: 'Show detailed execution information',
+        }),
+        timeout: core_1.Flags.integer({
+            description: 'Execution timeout in milliseconds',
+            default: 300000, // 5 minutes
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ActionsRun);
+        const service = new ai_cli_1.ActionService();
+        const formatter = new ai_cli_1.OutputFormatter(flags.output);
+        // Parse parameters
+        const params = {};
+        if (flags.param) {
+            for (const param of flags.param) {
+                const [key, ...valueParts] = param.split('=');
+                if (!key || valueParts.length === 0) {
+                    this.error(`Invalid parameter format: "${param}". Use key=value format.`);
+                }
+                params[key] = valueParts.join('='); // Handle values with = in them
+            }
+        }
+        try {
+            if (flags['dry-run']) {
+                // For dry-run, just show what would be executed
+                this.log(chalk_1.default.yellow('Dry-run mode: Action would be executed with these parameters:'));
+                this.log(chalk_1.default.cyan(`Action: ${flags.name}`));
+                if (Object.keys(params).length > 0) {
+                    this.log(chalk_1.default.cyan('Parameters:'));
+                    for (const [key, value] of Object.entries(params)) {
+                        this.log(`  ${key}: ${value}`);
+                    }
+                }
+                else {
+                    this.log(chalk_1.default.gray('No parameters provided'));
+                }
+            }
+            else {
+                // Execute action
+                const spinner = (0, ora_classic_1.default)();
+                spinner.start(`Executing action: ${flags.name}`);
+                const result = await service.executeAction(flags.name, params);
+                spinner.stop();
+                this.log(formatter.formatActionResult(result));
+                if (!result.success) {
+                    this.exit(1);
+                }
+            }
+        }
+        catch (error) {
+            this.error(error);
+        }
+    }
+}
+exports.default = ActionsRun;

package/dist/commands/ai/agents/list.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@oclif/core';
+export default class AgentsList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/ai/agents/list.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const ai_cli_1 = require("@memberjunction/ai-cli");
+const ora_classic_1 = __importDefault(require("ora-classic"));
+class AgentsList extends core_1.Command {
+    static description = 'List available AI agents';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --output=table',
+        '<%= config.bin %> <%= command.id %> --output=json',
+    ];
+    static flags = {
+        output: core_1.Flags.string({
+            char: 'o',
+            description: 'Output format',
+            options: ['compact', 'json', 'table'],
+            default: 'compact',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AgentsList);
+        const spinner = (0, ora_classic_1.default)();
+        try {
+            spinner.start('Loading available agents...');
+            const service = new ai_cli_1.AgentService();
+            const agents = await service.listAgents();
+            spinner.stop();
+            const formatter = new ai_cli_1.OutputFormatter(flags.output);
+            this.log(formatter.formatAgentList(agents));
+            // Force exit after completion
+            process.exit(0);
+        }
+        catch (error) {
+            spinner.fail('Failed to load agents');
+            this.error(error);
+        }
+    }
+}
+exports.default = AgentsList;

package/dist/commands/ai/agents/run.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class AgentsRun extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        prompt: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        chat: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/ai/agents/run.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const ai_cli_1 = require("@memberjunction/ai-cli");
+const ora_classic_1 = __importDefault(require("ora-classic"));
+class AgentsRun extends core_1.Command {
+    static description = 'Execute an AI agent with a prompt or start interactive chat';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> -a "Skip: Requirements Expert" -p "Create a dashboard for sales metrics"',
+        '<%= config.bin %> <%= command.id %> -a "Child Component Generator Sub-agent" --chat',
+        '<%= config.bin %> <%= command.id %> -a "Skip: Technical Design Expert" -p "Build a React component" --verbose --timeout=600000',
+    ];
+    static flags = {
+        agent: core_1.Flags.string({
+            char: 'a',
+            description: 'Agent name',
+            required: true,
+        }),
+        prompt: core_1.Flags.string({
+            char: 'p',
+            description: 'Prompt to execute',
+            exclusive: ['chat'],
+        }),
+        chat: core_1.Flags.boolean({
+            char: 'c',
+            description: 'Start interactive chat mode',
+            exclusive: ['prompt'],
+        }),
+        output: core_1.Flags.string({
+            char: 'o',
+            description: 'Output format',
+            options: ['compact', 'json', 'table'],
+            default: 'compact',
+        }),
+        verbose: core_1.Flags.boolean({
+            char: 'v',
+            description: 'Show detailed execution information',
+        }),
+        timeout: core_1.Flags.integer({
+            description: 'Execution timeout in milliseconds',
+            default: 300000, // 5 minutes
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AgentsRun);
+        if (!flags.prompt && !flags.chat) {
+            this.error('Either --prompt or --chat flag is required');
+        }
+        const service = new ai_cli_1.AgentService();
+        const formatter = new ai_cli_1.OutputFormatter(flags.output);
+        try {
+            if (flags.chat) {
+                // Interactive chat mode
+                const conversationService = new ai_cli_1.ConversationService();
+                await conversationService.startChat(flags.agent, undefined, {
+                    verbose: flags.verbose,
+                    timeout: flags.timeout,
+                });
+            }
+            else {
+                // Single prompt execution
+                const spinner = (0, ora_classic_1.default)();
+                spinner.start(`Executing agent: ${flags.agent}`);
+                const result = await service.executeAgent(flags.agent, flags.prompt, {
+                    verbose: flags.verbose,
+                    timeout: flags.timeout,
+                });
+                spinner.stop();
+                this.log(formatter.formatAgentResult(result));
+                if (!result.success) {
+                    this.exit(1);
+                }
+            }
+        }
+        catch (error) {
+            this.error(error);
+        }
+    }
+}
+exports.default = AgentsRun;

package/dist/commands/ai/index.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class AI extends Command {
+    static description: string;
+    static hidden: boolean;
+    run(): Promise<void>;
+}

package/dist/commands/ai/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+class AI extends core_1.Command {
+    static description = 'Execute AI agents and actions';
+    static hidden = false;
+    async run() {
+        // This command just displays help for the ai topic
+        await this.config.runCommand('help', ['ai']);
+    }
+}
+exports.default = AI;

package/dist/commands/ai/prompts/list.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@oclif/core';
+export default class PromptsList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/ai/prompts/list.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const ai_cli_1 = require("@memberjunction/ai-cli");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_classic_1 = __importDefault(require("ora-classic"));
+class PromptsList extends core_1.Command {
+    static description = 'List available models for prompt execution';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+    ];
+    static flags = {
+        verbose: core_1.Flags.boolean({
+            char: 'v',
+            description: 'Show detailed model information',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(PromptsList);
+        const spinner = (0, ora_classic_1.default)();
+        try {
+            spinner.start('Loading available models...');
+            const service = new ai_cli_1.PromptService();
+            const models = await service.listAvailableModels();
+            spinner.stop();
+            this.log(chalk_1.default.bold(`\nAvailable AI Models (${models.length}):\n`));
+            for (const model of models) {
+                this.log(`${chalk_1.default.cyan(model.name)} ${chalk_1.default.gray(`(${model.vendor})`)}`);
+                if (flags.verbose && model.description) {
+                    this.log(`  ${chalk_1.default.dim(model.description)}`);
+                }
+            }
+            this.log(chalk_1.default.gray('\nUse any of these models with the --model flag when running prompts'));
+            // Force exit after completion
+            process.exit(0);
+        }
+        catch (error) {
+            spinner.fail('Failed to load models');
+            this.error(error);
+        }
+    }
+}
+exports.default = PromptsList;

package/dist/commands/ai/prompts/run.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@oclif/core';
+export default class PromptsRun extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        prompt: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        model: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        system: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        temperature: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'max-tokens': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        configuration: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/ai/prompts/run.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const ai_cli_1 = require("@memberjunction/ai-cli");
+const ora_classic_1 = __importDefault(require("ora-classic"));
+class PromptsRun extends core_1.Command {
+    static description = 'Execute a direct prompt with an AI model';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> -p "Explain quantum computing in simple terms"',
+        '<%= config.bin %> <%= command.id %> -p "Write a Python function to sort a list" --model "gpt-4"',
+        '<%= config.bin %> <%= command.id %> -p "Translate to French: Hello world" --temperature 0.3',
+        '<%= config.bin %> <%= command.id %> -p "Generate a haiku" --system "You are a poet" --max-tokens 100',
+    ];
+    static flags = {
+        prompt: core_1.Flags.string({
+            char: 'p',
+            description: 'The prompt to execute',
+            required: true,
+        }),
+        model: core_1.Flags.string({
+            char: 'm',
+            description: 'AI model to use (e.g., gpt-4, claude-3-opus)',
+        }),
+        system: core_1.Flags.string({
+            char: 's',
+            description: 'System prompt to set context',
+        }),
+        temperature: core_1.Flags.string({
+            char: 't',
+            description: 'Temperature for response creativity (0.0-2.0)',
+        }),
+        'max-tokens': core_1.Flags.integer({
+            description: 'Maximum tokens for the response',
+        }),
+        configuration: core_1.Flags.string({
+            char: 'c',
+            description: 'AI Configuration ID to use',
+        }),
+        output: core_1.Flags.string({
+            char: 'o',
+            description: 'Output format',
+            options: ['compact', 'json', 'table'],
+            default: 'compact',
+        }),
+        verbose: core_1.Flags.boolean({
+            char: 'v',
+            description: 'Show detailed execution information',
+        }),
+        timeout: core_1.Flags.integer({
+            description: 'Execution timeout in milliseconds',
+            default: 300000, // 5 minutes
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(PromptsRun);
+        const service = new ai_cli_1.PromptService();
+        const formatter = new ai_cli_1.OutputFormatter(flags.output);
+        try {
+            const spinner = (0, ora_classic_1.default)();
+            // Show what model will be used
+            if (flags.model) {
+                spinner.start(`Executing prompt with model: ${flags.model}`);
+            }
+            else {
+                spinner.start('Executing prompt with default model');
+            }
+            // Parse temperature if provided
+            let temperature;
+            if (flags.temperature) {
+                temperature = parseFloat(flags.temperature);
+                if (isNaN(temperature) || temperature < 0 || temperature > 2) {
+                    spinner.fail();
+                    this.error('Temperature must be a number between 0.0 and 2.0');
+                }
+            }
+            const result = await service.executePrompt(flags.prompt, {
+                verbose: flags.verbose,
+                timeout: flags.timeout,
+                model: flags.model,
+                temperature,
+                maxTokens: flags['max-tokens'],
+                systemPrompt: flags.system,
+                configurationId: flags.configuration,
+            });
+            spinner.stop();
+            this.log(formatter.formatPromptResult(result));
+            if (!result.success) {
+                this.exit(1);
+            }
+        }
+        catch (error) {
+            this.error(error);
+        }
+    }
+}
+exports.default = PromptsRun;

package/dist/hooks/init.d.ts

@@ -1,7 +1,7 @@
 import { Hook } from '@oclif/core';
 /**
  * Init hook runs once when the CLI starts up.
- * Currently unused but required by oclif configuration.
+ * Load environment variables from .env file.
  */
 declare const hook: Hook<'init'>;
 export default hook;

package/dist/hooks/init.js

@@ -1,10 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+const dotenv = __importStar(require("dotenv"));
+const path = __importStar(require("path"));
 /**
  * Init hook runs once when the CLI starts up.
- * Currently unused but required by oclif configuration.
+ * Load environment variables from .env file.
  */
 const hook = async function () {
-    // No initialization needed at this time
+    // Load environment variables from .env file in repo root
+    const envPath = path.resolve(process.cwd(), '.env');
+    dotenv.config({ path: envPath });
 };
 exports.default = hook;

package/oclif.manifest.json

@@ -1,5 +1,27 @@
 {
   "commands": {
+    "ai": {
+      "aliases": [],
+      "args": {},
+      "description": "Execute AI agents and actions",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "ai",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "index.js"
+      ]
+    },
     "bump": {
       "aliases": [],
       "args": {},
@@ -638,7 +660,398 @@
         "sync",
         "watch.js"
       ]
+    },
+    "ai:actions:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List available AI actions",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --output=table",
+        "<%= config.bin %> <%= command.id %> --output=json"
+      ],
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "Output format",
+          "name": "output",
+          "default": "compact",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "compact",
+            "json",
+            "table"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai:actions:list",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "actions",
+        "list.js"
+      ]
+    },
+    "ai:actions:run": {
+      "aliases": [],
+      "args": {},
+      "description": "Execute an AI action with parameters",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -n \"Get Weather\" --param \"Location=Boston\"",
+        "<%= config.bin %> <%= command.id %> -n \"Get Stock Price\" --param \"Ticker=AAPL\"",
+        "<%= config.bin %> <%= command.id %> -n \"Send Single Message\" --param \"To=user@example.com\" --param \"Subject=Test\" --param \"Body=Hello\" --param \"MessageType=Email\" --param \"Provider=SendGrid\"",
+        "<%= config.bin %> <%= command.id %> -n \"Calculate Expression\" --param \"Expression=2+2*3\" --dry-run"
+      ],
+      "flags": {
+        "name": {
+          "char": "n",
+          "description": "Action name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "param": {
+          "char": "p",
+          "description": "Action parameters in key=value format",
+          "name": "param",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Validate without executing",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "output": {
+          "char": "o",
+          "description": "Output format",
+          "name": "output",
+          "default": "compact",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "compact",
+            "json",
+            "table"
+          ],
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed execution information",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Execution timeout in milliseconds",
+          "name": "timeout",
+          "default": 300000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai:actions:run",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "actions",
+        "run.js"
+      ]
+    },
+    "ai:agents:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List available AI agents",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --output=table",
+        "<%= config.bin %> <%= command.id %> --output=json"
+      ],
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "Output format",
+          "name": "output",
+          "default": "compact",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "compact",
+            "json",
+            "table"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai:agents:list",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "agents",
+        "list.js"
+      ]
+    },
+    "ai:agents:run": {
+      "aliases": [],
+      "args": {},
+      "description": "Execute an AI agent with a prompt or start interactive chat",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -a \"Skip: Requirements Expert\" -p \"Create a dashboard for sales metrics\"",
+        "<%= config.bin %> <%= command.id %> -a \"Child Component Generator Sub-agent\" --chat",
+        "<%= config.bin %> <%= command.id %> -a \"Skip: Technical Design Expert\" -p \"Build a React component\" --verbose --timeout=600000"
+      ],
+      "flags": {
+        "agent": {
+          "char": "a",
+          "description": "Agent name",
+          "name": "agent",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "prompt": {
+          "char": "p",
+          "description": "Prompt to execute",
+          "exclusive": [
+            "chat"
+          ],
+          "name": "prompt",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "chat": {
+          "char": "c",
+          "description": "Start interactive chat mode",
+          "exclusive": [
+            "prompt"
+          ],
+          "name": "chat",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "output": {
+          "char": "o",
+          "description": "Output format",
+          "name": "output",
+          "default": "compact",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "compact",
+            "json",
+            "table"
+          ],
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed execution information",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Execution timeout in milliseconds",
+          "name": "timeout",
+          "default": 300000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai:agents:run",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "agents",
+        "run.js"
+      ]
+    },
+    "ai:prompts:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List available models for prompt execution",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed model information",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai:prompts:list",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "prompts",
+        "list.js"
+      ]
+    },
+    "ai:prompts:run": {
+      "aliases": [],
+      "args": {},
+      "description": "Execute a direct prompt with an AI model",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -p \"Explain quantum computing in simple terms\"",
+        "<%= config.bin %> <%= command.id %> -p \"Write a Python function to sort a list\" --model \"gpt-4\"",
+        "<%= config.bin %> <%= command.id %> -p \"Translate to French: Hello world\" --temperature 0.3",
+        "<%= config.bin %> <%= command.id %> -p \"Generate a haiku\" --system \"You are a poet\" --max-tokens 100"
+      ],
+      "flags": {
+        "prompt": {
+          "char": "p",
+          "description": "The prompt to execute",
+          "name": "prompt",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "model": {
+          "char": "m",
+          "description": "AI model to use (e.g., gpt-4, claude-3-opus)",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "system": {
+          "char": "s",
+          "description": "System prompt to set context",
+          "name": "system",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "temperature": {
+          "char": "t",
+          "description": "Temperature for response creativity (0.0-2.0)",
+          "name": "temperature",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "max-tokens": {
+          "description": "Maximum tokens for the response",
+          "name": "max-tokens",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "configuration": {
+          "char": "c",
+          "description": "AI Configuration ID to use",
+          "name": "configuration",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "Output format",
+          "name": "output",
+          "default": "compact",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "compact",
+            "json",
+            "table"
+          ],
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed execution information",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Execution timeout in milliseconds",
+          "name": "timeout",
+          "default": 300000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai:prompts:run",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "prompts",
+        "run.js"
+      ]
     }
   },
-  "version": "2.77.0"
+  "version": "2.78.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/cli",
-  "version": "2.77.0",
+  "version": "2.78.0",
   "description": "MemberJunction command line tools",
   "keywords": [
     "oclif"
@@ -51,9 +51,10 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^5.0.1",
-    "@memberjunction/codegen-lib": "2.77.0",
-    "@memberjunction/metadata-sync": "2.77.0",
-    "@memberjunction/sqlserver-dataprovider": "2.77.0",
+    "@memberjunction/ai-cli": "2.78.0",
+    "@memberjunction/codegen-lib": "2.78.0",
+    "@memberjunction/metadata-sync": "2.78.0",
+    "@memberjunction/sqlserver-dataprovider": "2.78.0",
     "@oclif/core": "^3",
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-version": "^2.0.17",