@agents-at-scale/ark 0.1.36-rc1 → 0.1.37

package/dist/commands/completion.js

@@ -1,265 +0,0 @@
-import chalk from 'chalk';
-import { Command } from 'commander';
-export function createCompletionCommand() {
-    const completion = new Command('completion');
-    completion.description('Generate shell completion scripts').action(() => {
-        console.log(chalk.cyan('Shell completion for ARK CLI'));
-        console.log('');
-        console.log('Usage:');
-        console.log('  ark completion bash   Generate bash completion script');
-        console.log('  ark completion zsh    Generate zsh completion script');
-        console.log('');
-        console.log('To enable completion, add this to your shell profile:');
-        console.log(chalk.grey('  # For bash:'));
-        console.log(chalk.grey('  eval "$(ark completion bash)"'));
-        console.log(chalk.grey('  # For zsh:'));
-        console.log(chalk.grey('  eval "$(ark completion zsh)"'));
-    });
-    completion
-        .command('bash')
-        .description('Generate bash completion script')
-        .action(() => {
-        console.log(`
-_ark_completion() {
-  local cur prev opts
-  COMPREPLY=()
-  cur="\${COMP_WORDS[COMP_CWORD]}"
-  prev="\${COMP_WORDS[COMP_CWORD-1]}"
-  
-  case \${COMP_CWORD} in
-    1)
-      opts="agents chat cluster completion config dashboard dev generate install models routes status targets teams tools uninstall help"
-      COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
-      return 0
-      ;;
-    2)
-      case \${prev} in
-        cluster)
-          opts="get-ip get-type"
-          COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
-          return 0
-          ;;
-        completion)
-          opts="bash zsh"
-          COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
-          return 0
-          ;;
-        check)
-          opts="status"
-          COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
-          return 0
-          ;;
-        targets)
-          opts="list ls"
-          COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
-          return 0
-          ;;
-        agents)
-          opts="list ls"
-          COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
-          return 0
-          ;;
-        models)
-          opts="list ls create"
-          COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
-          return 0
-          ;;
-        teams)
-          opts="list ls"
-          COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
-          return 0
-          ;;
-        tools)
-          opts="list ls"
-          COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
-          return 0
-          ;;
-        dev)
-          opts="tool"
-          COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
-          return 0
-          ;;
-        generate)
-          opts="agent marketplace mcp-server project query team"
-          COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
-          return 0
-          ;;
-        chat)
-          # Dynamically fetch available targets using ark targets list
-          local targets
-          targets=$(ark targets list 2>/dev/null)
-          if [ -z "$targets" ]; then
-            # Fallback to common targets if API is not available
-            targets="agent/sample-agent agent/math agent/weather model/default"
-          fi
-          COMPREPLY=( $(compgen -W "\${targets}" -- \${cur}) )
-          return 0
-          ;;
-      esac
-      ;;
-    3)
-      case \${COMP_WORDS[1]} in
-        dev)
-          case \${prev} in
-            tool)
-              opts="check init generate"
-              COMPREPLY=( $(compgen -W "\${opts}" -- \${cur}) )
-              return 0
-              ;;
-          esac
-          ;;
-      esac
-      ;;
-    4)
-      # Handle path completion for dev tool commands
-      case \${COMP_WORDS[1]} in
-        dev)
-          if [[ \${COMP_WORDS[2]} == "tool" ]]; then
-            case \${COMP_WORDS[3]} in
-              check|init|generate)
-                # Complete with directories
-                COMPREPLY=( $(compgen -d -- \${cur}) )
-                return 0
-                ;;
-            esac
-          fi
-          ;;
-      esac
-      ;;
-  esac
-}
-
-complete -F _ark_completion ark
-      `.trim());
-    });
-    completion
-        .command('zsh')
-        .description('Generate zsh completion script')
-        .action(() => {
-        console.log(`
-#compdef ark
-
-_ark() {
-  local context state line
-  
-  _arguments -C \\
-    '1:command:->command' \\
-    '2:subcommand:->subcommand' \\
-    '*::arg:->args'
-    
-  case $state in
-    command)
-      _values 'ark commands' \\
-        'agents[List available agents]' \\
-        'chat[Interactive chat with agents and models]' \\
-        'cluster[Cluster management commands]' \\
-        'completion[Generate shell completion scripts]' \\
-        'config[Configuration management]' \\
-        'dashboard[Open ARK dashboard]' \\
-        'dev[Development tools for ARK]' \\
-        'generate[Generate ARK resources]' \\
-        'install[Install ARK services]' \\
-        'models[List available models]' \\
-        'routes[List available routes]' \\
-        'status[Check system status]' \\
-        'targets[List available query targets]' \\
-        'teams[List available teams]' \\
-        'tools[List available tools]' \\
-        'uninstall[Uninstall ARK services]' \\
-        'help[Show help information]'
-      ;;
-    subcommand)
-      case $words[2] in
-        cluster)
-          _values 'cluster commands' \\
-            'get-ip[Get cluster IP address]' \\
-            'get-type[Get cluster type]'
-          ;;
-        completion)
-          _values 'completion shells' \\
-            'bash[Generate bash completion]' \\
-            'zsh[Generate zsh completion]'
-          ;;
-        check)
-          _values 'check commands' \\
-            'status[Check system status]'
-          ;;
-        targets)
-          _values 'targets commands' \\
-            'list[List all available targets]' \\
-            'ls[List all available targets]'
-          ;;
-        agents)
-          _values 'agents commands' \\
-            'list[List all available agents]' \\
-            'ls[List all available agents]'
-          ;;
-        models)
-          _values 'models commands' \\
-            'list[List all available models]' \\
-            'ls[List all available models]' \\
-            'create[Create a new model]'
-          ;;
-        teams)
-          _values 'teams commands' \\
-            'list[List all available teams]' \\
-            'ls[List all available teams]'
-          ;;
-        tools)
-          _values 'tools commands' \\
-            'list[List all available tools]' \\
-            'ls[List all available tools]'
-          ;;
-        dev)
-          _values 'dev commands' \\
-            'tool[MCP tool development utilities]'
-          ;;
-        generate)
-          _values 'generate types' \\
-            'agent[Generate a new agent]' \\
-            'marketplace[Generate marketplace content]' \\
-            'mcp-server[Generate MCP server]' \\
-            'project[Generate a new project]' \\
-            'query[Generate a query]' \\
-            'team[Generate a team]'
-          ;;
-        chat)
-          # Get available targets dynamically
-          local -a targets
-          targets=($(ark targets list 2>/dev/null))
-          if [ \${#targets[@]} -eq 0 ]; then
-            targets=('agent/sample-agent' 'agent/math' 'agent/weather' 'model/default')
-          fi
-          _values 'available targets' \${targets[@]}
-          ;;
-      esac
-      ;;
-    args)
-      case \$words[2] in
-        dev)
-          if [[ \$words[3] == "tool" ]]; then
-            case \$words[4] in
-              check|init|generate)
-                # Complete with directories
-                _files -/
-                ;;
-              *)
-                _values 'tool commands' \\
-                  'check[Check the status of an MCP tool project]' \\
-                  'init[Initialize an MCP tool project]' \\
-                  'generate[Generate project files from templates]' \\
-                  'clean[Remove template-generated files]'
-                ;;
-            esac
-          fi
-          ;;
-      esac
-      ;;
-  esac
-}
-
-_ark
-      `.trim());
-    });
-    return completion;
-}

package/dist/commands/config.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function createConfigCommand(): Command;

package/dist/commands/config.js

@@ -1,44 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { loadConfig, getConfigPaths, formatConfig } from '../lib/config.js';
-import fs from 'fs';
-export function createConfigCommand() {
-    const configCommand = new Command('config');
-    configCommand
-        .description('Show current configuration')
-        .action(() => {
-        const config = loadConfig();
-        const paths = getConfigPaths();
-        console.log();
-        // User config
-        if (fs.existsSync(paths.user)) {
-            console.log(chalk.green('✓'), chalk.white(paths.user));
-        }
-        else {
-            console.log(chalk.red('✗'), chalk.white(paths.user), chalk.gray(`doesn't exist`));
-        }
-        // Project config
-        if (fs.existsSync(paths.project)) {
-            console.log(chalk.green('✓'), chalk.white(paths.project));
-        }
-        else {
-            console.log(chalk.red('✗'), chalk.white(paths.project), chalk.gray(`doesn't exist`));
-        }
-        // Environment variables
-        if (process.env.ARK_CHAT_STREAMING !== undefined) {
-            console.log(chalk.green('✓'), chalk.white('ARK_CHAT_STREAMING'), chalk.gray(process.env.ARK_CHAT_STREAMING));
-        }
-        else {
-            console.log(chalk.red('✗'), chalk.white('ARK_CHAT_STREAMING'), chalk.gray('not set'));
-        }
-        if (process.env.ARK_CHAT_OUTPUT_FORMAT !== undefined) {
-            console.log(chalk.green('✓'), chalk.white('ARK_CHAT_OUTPUT_FORMAT'), chalk.gray(process.env.ARK_CHAT_OUTPUT_FORMAT));
-        }
-        else {
-            console.log(chalk.red('✗'), chalk.white('ARK_CHAT_OUTPUT_FORMAT'), chalk.gray('not set'));
-        }
-        console.log();
-        console.log(formatConfig(config));
-    });
-    return configCommand;
-}

package/dist/commands/dashboard.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function openDashboard(): Promise<void>;
-export declare function createDashboardCommand(): Command;

package/dist/commands/dashboard.js

@@ -1,39 +0,0 @@
-import chalk from 'chalk';
-import { Command } from 'commander';
-import open from 'open';
-import ora from 'ora';
-import { ArkServiceProxy } from '../lib/arkServiceProxy.js';
-import { arkServices } from '../arkServices.js';
-export async function openDashboard() {
-    const spinner = ora('Connecting to dashboard').start();
-    try {
-        const dashboardService = arkServices['ark-dashboard'];
-        const proxy = new ArkServiceProxy(dashboardService, 3274); // DASH on phone keypad
-        const url = await proxy.start();
-        spinner.succeed('Dashboard connected');
-        console.log(`ARK dashboard running on: ${chalk.green(url)}`);
-        console.log(chalk.gray('Press Ctrl+C to stop'));
-        // Brief pause before opening browser
-        await new Promise((resolve) => setTimeout(resolve, 1000));
-        // Open browser
-        await open(url);
-        // Handle Ctrl+C gracefully
-        process.on('SIGINT', () => {
-            proxy.stop();
-            process.exit(0);
-        });
-        // Keep process alive
-        process.stdin.resume();
-    }
-    catch (error) {
-        spinner.fail(error instanceof Error ? error.message : 'Failed to start dashboard');
-        process.exit(1);
-    }
-}
-export function createDashboardCommand() {
-    const dashboardCommand = new Command('dashboard');
-    dashboardCommand
-        .description('Open the ARK dashboard in your browser')
-        .action(openDashboard);
-    return dashboardCommand;
-}

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

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-import type { ArkConfig } from '../../lib/config.js';
-export declare function createDevCommand(_: ArkConfig): Command;

package/dist/commands/dev/index.js

@@ -1,9 +0,0 @@
-import { Command } from 'commander';
-import { createToolCommand } from './tool/index.js';
-export function createDevCommand(_) {
-    const devCommand = new Command('dev');
-    devCommand.description('Development tools for ARK');
-    // Add subcommands
-    devCommand.addCommand(createToolCommand());
-    return devCommand;
-}

package/dist/commands/dev/tool/check.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function createCheckCommand(): Command;

package/dist/commands/dev/tool/check.js

@@ -1,142 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import path from 'path';
-import ora from 'ora';
-import output from '../../../lib/output.js';
-import { ArkDevToolAnalyzer } from '../../../lib/dev/tools/analyzer.js';
-import { toMCPTool } from '../../../lib/dev/tools/mcp-types.js';
-async function checkTool(toolPath, options) {
-    const absolutePath = path.resolve(toolPath);
-    const analyzer = new ArkDevToolAnalyzer();
-    const isJson = options.output === 'json';
-    // Build up result object as we go
-    const result = {
-        path: absolutePath,
-        projectRoot: null,
-        error: null,
-        platform: null,
-        projectType: null,
-        projectName: null,
-        projectVersion: null,
-        hasFastmcp: false,
-        fastmcpVersion: null,
-        tools: [],
-        toolDiscoveryError: null,
-    };
-    if (!isJson) {
-        console.log();
-    }
-    // Single spinner for all analysis (skip for JSON output)
-    const analyzeSpinner = isJson
-        ? null
-        : ora(`analyzing ${absolutePath}`).start();
-    // Small delay to let user see what's happening (skip for JSON)
-    if (!isJson) {
-        await new Promise((resolve) => setTimeout(resolve, 500));
-    }
-    // Collect all information
-    const project = await analyzer.discoverProject(absolutePath);
-    if (!project || !project.exists) {
-        result.error = 'path not found';
-        if (isJson) {
-            console.log(JSON.stringify(result, null, 2));
-        }
-        else {
-            analyzeSpinner.stop();
-            output.error(`path not found: ${absolutePath}`);
-        }
-        process.exit(1);
-    }
-    if (!project.is_directory) {
-        result.error = 'path is not a directory';
-        if (isJson) {
-            console.log(JSON.stringify(result, null, 2));
-        }
-        else {
-            analyzeSpinner.stop();
-            output.error(`path is not a directory: ${absolutePath}`);
-        }
-        process.exit(1);
-    }
-    if (!project.platform) {
-        result.error =
-            'platform unknown - no pyproject.toml or requirements.txt found';
-        if (isJson) {
-            console.log(JSON.stringify(result, null, 2));
-        }
-        else {
-            analyzeSpinner.stop();
-            output.error(`no pyproject.toml or requirements.txt found in: ${absolutePath}`);
-        }
-        process.exit(1);
-    }
-    // Update result with project info
-    result.platform = project.platform;
-    result.projectType = project.project_type;
-    result.projectName = project.project_name;
-    result.projectVersion = project.project_version;
-    result.hasFastmcp = project.has_fastmcp;
-    result.fastmcpVersion = project.fastmcp_version;
-    result.projectRoot = absolutePath; // Store the project root
-    // Discover tools recursively in the project
-    const rawTools = [];
-    try {
-        const projectTools = await analyzer.findProjectTools(absolutePath);
-        if (projectTools && projectTools.tools) {
-            rawTools.push(...projectTools.tools);
-        }
-    }
-    catch (error) {
-        result.toolDiscoveryError =
-            error instanceof Error ? error.message : 'Unknown error';
-    }
-    // Store tools in the appropriate format
-    result.tools = isJson ? rawTools.map(toMCPTool) : rawTools;
-    if (isJson) {
-        // Output raw JSON
-        console.log(JSON.stringify(result, null, 2));
-        return;
-    }
-    analyzeSpinner.succeed('analysis complete');
-    console.log();
-    // Display summary in cleaner format
-    output.section(path.basename(absolutePath));
-    // Platform
-    output.statusCheck('found', 'platform', result.platform);
-    // Project type with name and version in gray
-    let projectDetails = '';
-    if (result.projectName) {
-        projectDetails = result.projectName;
-        if (result.projectVersion) {
-            projectDetails += ` v${result.projectVersion}`;
-        }
-    }
-    output.statusCheck('found', 'project', result.projectType, projectDetails);
-    // Framework with version in gray
-    if (result.hasFastmcp) {
-        const fastmcpDetails = result.fastmcpVersion
-            ? `v${result.fastmcpVersion}`
-            : undefined;
-        output.statusCheck('found', 'framework', 'fastmcp', fastmcpDetails);
-    }
-    else {
-        output.statusCheck('missing', 'framework', 'fastmcp');
-    }
-    // Tools with details
-    output.statusCheck('found', 'tools', result.tools.length.toString());
-    if (result.tools.length > 0) {
-        for (const tool of result.tools) {
-            const description = tool.docstring ? tool.docstring.split('\n')[0] : '';
-            console.log(chalk.gray(`      - ${tool.name}: ${description}`));
-        }
-    }
-}
-export function createCheckCommand() {
-    const checkCommand = new Command('check');
-    checkCommand
-        .description('Check the status of an MCP tool project')
-        .argument('<path>', 'Path to the tool directory')
-        .option('-o, --output <format>', 'Output format (json)', 'text')
-        .action(checkTool);
-    return checkCommand;
-}

package/dist/commands/dev/tool/clean.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function createCleanCommand(): Command;

package/dist/commands/dev/tool/clean.js

@@ -1,153 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import fs from 'fs';
-import yaml from 'yaml';
-import inquirer from 'inquirer';
-import output from '../../../lib/output.js';
-async function cleanTool(toolPath, options = {}) {
-    const absolutePath = path.resolve(toolPath);
-    const arkConfigPath = path.join(absolutePath, '.ark.yaml');
-    // Check if .ark.yaml exists
-    if (!fs.existsSync(arkConfigPath)) {
-        output.error('.ark.yaml not found. Run "ark dev tool init" first.');
-        process.exit(1);
-    }
-    // Load .ark.yaml to validate it's parseable
-    yaml.parse(fs.readFileSync(arkConfigPath, 'utf-8'));
-    // Find template directory
-    const currentFile = fileURLToPath(import.meta.url);
-    const distDir = path.dirname(path.dirname(path.dirname(path.dirname(currentFile)))); // Goes to dist/
-    const arkCliDir = path.dirname(distDir); // Goes to ark-cli/
-    const templateDir = path.join(arkCliDir, 'templates', 'python-mcp-tool');
-    if (!fs.existsSync(templateDir)) {
-        output.error('Template directory not found');
-        process.exit(1);
-    }
-    // Collect all template-based files (not directories)
-    const allTemplateFiles = [];
-    const dirsToCheck = new Set();
-    collectTemplateFiles(templateDir, absolutePath, allTemplateFiles, dirsToCheck);
-    // Filter to only existing files
-    const filesToClean = allTemplateFiles.filter((file) => {
-        const fullPath = path.join(absolutePath, file);
-        return fs.existsSync(fullPath);
-    });
-    if (filesToClean.length === 0) {
-        console.log(chalk.green('No template-generated files found to clean.'));
-        return;
-    }
-    console.log(chalk.yellow(`Found ${filesToClean.length} template-generated file(s) to potentially remove:`));
-    // Display the list of files
-    filesToClean.forEach((file) => {
-        console.log(chalk.gray(`  - ${file}`));
-    });
-    console.log();
-    let removedCount = 0;
-    let skippedCount = 0;
-    // First, delete individual files
-    for (const file of filesToClean) {
-        const fullPath = path.join(absolutePath, file);
-        // Ask for confirmation unless --yes flag is set
-        let shouldDelete = options.yes;
-        if (!shouldDelete) {
-            const answer = await inquirer.prompt([
-                {
-                    type: 'confirm',
-                    name: 'delete',
-                    message: `Delete file ${chalk.cyan(file)}?`,
-                    default: false,
-                },
-            ]);
-            shouldDelete = answer.delete;
-        }
-        if (shouldDelete) {
-            try {
-                fs.unlinkSync(fullPath);
-                console.log(chalk.green(`  ✓ Removed ${file}`));
-                removedCount++;
-            }
-            catch (err) {
-                console.log(chalk.red(`  ✗ Failed to remove ${file}: ${err instanceof Error ? err.message : 'Unknown error'}`));
-            }
-        }
-        else {
-            console.log(chalk.gray(`  - Skipped ${file}`));
-            skippedCount++;
-        }
-    }
-    // Now check for empty directories and offer to delete them
-    const sortedDirs = Array.from(dirsToCheck).sort((a, b) => b.length - a.length); // Process deepest dirs first
-    for (const dir of sortedDirs) {
-        const fullPath = path.join(absolutePath, dir);
-        // Check if directory exists and is empty
-        if (fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory()) {
-            const contents = fs.readdirSync(fullPath);
-            if (contents.length === 0) {
-                // Directory is empty, ask to delete it
-                let shouldDelete = options.yes;
-                if (!shouldDelete) {
-                    const answer = await inquirer.prompt([
-                        {
-                            type: 'confirm',
-                            name: 'delete',
-                            message: `Delete empty directory ${chalk.cyan(dir)}?`,
-                            default: false,
-                        },
-                    ]);
-                    shouldDelete = answer.delete;
-                }
-                if (shouldDelete) {
-                    try {
-                        fs.rmdirSync(fullPath);
-                        console.log(chalk.green(`  ✓ Removed empty directory ${dir}`));
-                    }
-                    catch (err) {
-                        console.log(chalk.red(`  ✗ Failed to remove directory ${dir}: ${err instanceof Error ? err.message : 'Unknown error'}`));
-                    }
-                }
-                else {
-                    console.log(chalk.gray(`  - Kept empty directory ${dir}`));
-                }
-            }
-        }
-    }
-    console.log();
-    if (removedCount > 0) {
-        console.log(chalk.green(`✓ Removed ${removedCount} file(s)`));
-    }
-    if (skippedCount > 0) {
-        console.log(chalk.gray(`Skipped ${skippedCount} file(s)`));
-    }
-}
-function collectTemplateFiles(sourceDir, targetDir, files, dirsToCheck, relativePath = '') {
-    const entries = fs.readdirSync(sourceDir, { withFileTypes: true });
-    for (const entry of entries) {
-        if (entry.isDirectory()) {
-            // Track directory for later checking
-            const dirPath = path.join(relativePath, entry.name);
-            dirsToCheck.add(dirPath);
-            // Recursively collect from subdirectory
-            const subSourceDir = path.join(sourceDir, entry.name);
-            collectTemplateFiles(subSourceDir, targetDir, files, dirsToCheck, dirPath);
-        }
-        else {
-            // Check if it's a template file
-            const targetFileName = entry.name.startsWith('template.')
-                ? entry.name.replace('template.', '')
-                : entry.name;
-            const filePath = path.join(relativePath, targetFileName);
-            files.push(filePath);
-        }
-    }
-}
-export function createCleanCommand() {
-    const cleanCommand = new Command('clean');
-    cleanCommand
-        .description('Remove template-generated files from an MCP tool project')
-        .argument('<path>', 'Path to the tool directory')
-        .option('-y, --yes', 'Skip confirmation prompts and delete all files')
-        .action(cleanTool);
-    return cleanCommand;
-}

package/dist/commands/dev/tool/generate.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function createGenerateCommand(): Command;