@agents-at-scale/ark 0.1.34 → 0.1.35-rc.1

package/dist/commands/routes/index.js

@@ -0,0 +1,101 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { execa } from 'execa';
+import output from '../../lib/output.js';
+import { isCommandAvailable } from '../../lib/commandUtils.js';
+async function listRoutes() {
+    // Check if kubectl is installed
+    const kubectlInstalled = await isCommandAvailable('kubectl');
+    if (!kubectlInstalled) {
+        output.error('kubectl is not installed. please install kubectl first:');
+        output.info('https://kubernetes.io/docs/tasks/tools/');
+        process.exit(1);
+    }
+    const namespace = 'ark-system';
+    const port = 8080;
+    const portSuffix = `:${port}`;
+    try {
+        // Check if localhost-gateway is installed
+        const { stdout: gatewayCheck } = await execa('kubectl', ['get', 'gateway', 'localhost-gateway', '-n', namespace], { reject: false });
+        if (!gatewayCheck) {
+            output.error("localhost-gateway not installed in namespace 'ark-system'");
+            output.info("run 'ark install' first");
+            process.exit(1);
+        }
+        // Get HTTPRoutes
+        const { stdout: routeOutput } = await execa('kubectl', [
+            'get',
+            'httproutes',
+            '-A',
+            '-o',
+            'custom-columns=NAMESPACE:.metadata.namespace,NAME:.metadata.name,HOSTNAMES:.spec.hostnames',
+            '--no-headers',
+        ], { reject: false });
+        if (!routeOutput || routeOutput.trim() === '') {
+            console.log(chalk.white('available localhost gateway routes: 0'));
+            output.info('no httproutes found. install services to see routes here.');
+            return;
+        }
+        // Parse routes
+        const lines = routeOutput.trim().split('\n');
+        const routes = [];
+        lines.forEach((line) => {
+            const parts = line.split(/\s+/);
+            if (parts.length >= 3) {
+                const name = parts[1];
+                // Remove brackets and split hostnames
+                const hostnamesStr = parts.slice(2).join(' ').replace(/\[|\]/g, '');
+                const hostnames = hostnamesStr
+                    .split(',')
+                    .map((h) => h.trim())
+                    .filter((h) => h && h !== '<none>');
+                if (hostnames.length > 0) {
+                    routes.push({ name, hostnames });
+                }
+            }
+        });
+        // Count total routes (each hostname counts as a route)
+        const routeCount = routes.reduce((count, r) => count + r.hostnames.length, 0);
+        console.log(chalk.white(`available localhost gateway routes: ${routeCount}`));
+        // Check port-forward status
+        const { stdout: psOutput } = await execa('pgrep', ['-f', `kubectl.*port-forward.*${port}:80`], { reject: false });
+        const portForwardActive = !!psOutput;
+        if (portForwardActive) {
+            output.info(`port-forward active on localhost${portSuffix}`);
+        }
+        else {
+            output.error(`port-forward not running on localhost${portSuffix} - routes are not exposed`);
+            console.log(chalk.blue('run:'), `kubectl port-forward -n ${namespace} service/localhost-gateway-nginx ${port}:80 > /dev/null 2>&1 &`);
+        }
+        console.log();
+        // Display routes
+        if (routes.length > 0) {
+            const maxLength = Math.max(...routes.map((r) => r.name.length));
+            routes.forEach((route) => {
+                route.hostnames.forEach((hostname) => {
+                    const url = `http://${hostname}${portSuffix}/`;
+                    const padding = ' '.repeat(maxLength - route.name.length);
+                    if (portForwardActive) {
+                        console.log(`  ${route.name}${padding}: ${chalk.blue(url)}`);
+                    }
+                    else {
+                        console.log(`  ${route.name}${padding}: ${chalk.blue(url)} ${chalk.red('(unavailable)')}`);
+                    }
+                });
+            });
+        }
+    }
+    catch (error) {
+        output.error('failed to fetch routes:', error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+    }
+}
+export function createRoutesCommand() {
+    const command = new Command('routes');
+    command
+        .description('show available gateway routes and their urls')
+        .action(async () => {
+        await listRoutes();
+    });
+    return command;
+}

package/dist/commands/routes.d.ts

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

package/dist/commands/routes.js

@@ -0,0 +1,101 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { execa } from 'execa';
+import output from '../lib/output.js';
+import { isCommandAvailable } from '../lib/commandUtils.js';
+async function listRoutes() {
+    // Check if kubectl is installed
+    const kubectlInstalled = await isCommandAvailable('kubectl');
+    if (!kubectlInstalled) {
+        output.error('kubectl is not installed. please install kubectl first:');
+        output.info('https://kubernetes.io/docs/tasks/tools/');
+        process.exit(1);
+    }
+    const namespace = 'ark-system';
+    const port = 8080;
+    const portSuffix = `:${port}`;
+    try {
+        // Check if localhost-gateway is installed
+        const { stdout: gatewayCheck } = await execa('kubectl', ['get', 'gateway', 'localhost-gateway', '-n', namespace], { reject: false });
+        if (!gatewayCheck) {
+            output.error("localhost-gateway not installed in namespace 'ark-system'");
+            output.info("run 'ark install' first");
+            process.exit(1);
+        }
+        // Get HTTPRoutes
+        const { stdout: routeOutput } = await execa('kubectl', [
+            'get',
+            'httproutes',
+            '-A',
+            '-o',
+            'custom-columns=NAMESPACE:.metadata.namespace,NAME:.metadata.name,HOSTNAMES:.spec.hostnames',
+            '--no-headers',
+        ], { reject: false });
+        if (!routeOutput || routeOutput.trim() === '') {
+            console.log(chalk.white('available localhost gateway routes: 0'));
+            output.info('no httproutes found. install services to see routes here.');
+            return;
+        }
+        // Parse routes
+        const lines = routeOutput.trim().split('\n');
+        const routes = [];
+        lines.forEach((line) => {
+            const parts = line.split(/\s+/);
+            if (parts.length >= 3) {
+                const name = parts[1];
+                // Remove brackets and split hostnames
+                const hostnamesStr = parts.slice(2).join(' ').replace(/\[|\]/g, '');
+                const hostnames = hostnamesStr
+                    .split(',')
+                    .map((h) => h.trim())
+                    .filter((h) => h && h !== '<none>');
+                if (hostnames.length > 0) {
+                    routes.push({ name, hostnames });
+                }
+            }
+        });
+        // Count total routes (each hostname counts as a route)
+        const routeCount = routes.reduce((count, r) => count + r.hostnames.length, 0);
+        console.log(chalk.white(`available localhost gateway routes: ${routeCount}`));
+        // Check port-forward status
+        const { stdout: psOutput } = await execa('pgrep', ['-f', `kubectl.*port-forward.*${port}:80`], { reject: false });
+        const portForwardActive = !!psOutput;
+        if (portForwardActive) {
+            output.info(`port-forward active on localhost${portSuffix}`);
+        }
+        else {
+            output.error(`port-forward not running on localhost${portSuffix} - routes are not exposed`);
+            console.log(chalk.blue('run:'), `kubectl port-forward -n ${namespace} service/localhost-gateway-nginx ${port}:80 > /dev/null 2>&1 &`);
+        }
+        console.log();
+        // Display routes
+        if (routes.length > 0) {
+            const maxLength = Math.max(...routes.map((r) => r.name.length));
+            routes.forEach((route) => {
+                route.hostnames.forEach((hostname) => {
+                    const url = `http://${hostname}${portSuffix}/`;
+                    const padding = ' '.repeat(maxLength - route.name.length);
+                    if (portForwardActive) {
+                        console.log(`  ${route.name}${padding}: ${chalk.blue(url)}`);
+                    }
+                    else {
+                        console.log(`  ${route.name}${padding}: ${chalk.blue(url)} ${chalk.red('(unavailable)')}`);
+                    }
+                });
+            });
+        }
+    }
+    catch (error) {
+        output.error('failed to fetch routes:', error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+    }
+}
+export function createRoutesCommand() {
+    const command = new Command('routes');
+    command
+        .description('show available gateway routes and their urls')
+        .action(async () => {
+        await listRoutes();
+    });
+    return command;
+}

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

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

package/dist/commands/status/index.js

@@ -0,0 +1,33 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { StatusChecker } from '../../components/statusChecker.js';
+import { ConfigManager } from '../../config.js';
+import { ArkClient } from '../../lib/arkClient.js';
+import { StatusFormatter } from '../../ui/statusFormatter.js';
+export async function checkStatus() {
+    const spinner = ora('Checking system status').start();
+    try {
+        const configManager = new ConfigManager();
+        spinner.text = 'Checking system dependencies';
+        const apiBaseUrl = await configManager.getApiBaseUrl();
+        const arkClient = new ArkClient(apiBaseUrl);
+        const statusChecker = new StatusChecker(arkClient);
+        spinner.text = 'Testing cluster access';
+        spinner.text = 'Checking ARK services';
+        const statusData = await statusChecker.checkAll();
+        spinner.stop();
+        StatusFormatter.printStatus(statusData);
+        process.exit(0);
+    }
+    catch (error) {
+        spinner.fail('Failed to check status');
+        console.error(chalk.red('Error:'), error);
+        process.exit(1);
+    }
+}
+export function createStatusCommand() {
+    const statusCommand = new Command('status');
+    statusCommand.description('Check ARK system status').action(checkStatus);
+    return statusCommand;
+}

package/dist/commands/status.d.ts

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

package/dist/commands/status.js

@@ -0,0 +1,33 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { StatusChecker } from '../components/statusChecker.js';
+import { ConfigManager } from '../config.js';
+import { ArkClient } from '../lib/arkClient.js';
+import { StatusFormatter } from '../ui/statusFormatter.js';
+export async function checkStatus() {
+    const spinner = ora('Checking system status').start();
+    try {
+        const configManager = new ConfigManager();
+        spinner.text = 'Checking system dependencies';
+        const apiBaseUrl = await configManager.getApiBaseUrl();
+        const arkClient = new ArkClient(apiBaseUrl);
+        const statusChecker = new StatusChecker(arkClient);
+        spinner.text = 'Testing cluster access';
+        spinner.text = 'Checking ARK services';
+        const statusData = await statusChecker.checkAll();
+        spinner.stop();
+        StatusFormatter.printStatus(statusData);
+        process.exit(0);
+    }
+    catch (error) {
+        spinner.fail('Failed to check status');
+        console.error(chalk.red('Error:'), error);
+        process.exit(1);
+    }
+}
+export function createStatusCommand() {
+    const statusCommand = new Command('status');
+    statusCommand.description('Check ARK system status').action(checkStatus);
+    return statusCommand;
+}

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

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

package/dist/commands/targets/index.js

@@ -0,0 +1,65 @@
+import { Command } from 'commander';
+import output from '../../lib/output.js';
+import { ArkApiProxy } from '../../lib/arkApiProxy.js';
+async function listTargets(options) {
+    let proxy;
+    try {
+        proxy = new ArkApiProxy();
+        const arkApiClient = await proxy.start();
+        const allTargets = await arkApiClient.getQueryTargets();
+        // Filter by type if specified
+        let filteredTargets = allTargets;
+        if (options.type) {
+            filteredTargets = allTargets.filter((t) => t.type === options.type);
+        }
+        // Sort targets by type and name
+        filteredTargets.sort((a, b) => {
+            if (a.type !== b.type) {
+                return a.type.localeCompare(b.type);
+            }
+            return a.name.localeCompare(b.name);
+        });
+        if (options.output === 'json') {
+            console.log(JSON.stringify(filteredTargets, null, 2));
+        }
+        else {
+            if (filteredTargets.length === 0) {
+                output.warning('no targets available');
+                return;
+            }
+            // Simple list output with type/name format
+            for (const target of filteredTargets) {
+                console.log(target.id);
+            }
+        }
+    }
+    catch (error) {
+        output.error('fetching targets:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+    finally {
+        if (proxy) {
+            proxy.stop();
+        }
+    }
+}
+export function createTargetsCommand() {
+    const targets = new Command('targets');
+    targets
+        .description('list available query targets (agents, teams, models, tools)')
+        .option('-o, --output <format>', 'output format (json or text)', 'text')
+        .option('-t, --type <type>', 'filter by type (agent, team, model, tool)')
+        .action(async (options) => {
+        await listTargets(options);
+    });
+    targets
+        .command('list')
+        .alias('ls')
+        .description('list all available query targets')
+        .option('-o, --output <format>', 'output format (json or text)', 'text')
+        .option('-t, --type <type>', 'filter by type (agent, team, model, tool)')
+        .action(async (options) => {
+        await listTargets(options);
+    });
+    return targets;
+}

package/dist/commands/targets.d.ts

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

package/dist/commands/targets.js

@@ -0,0 +1,65 @@
+import { Command } from 'commander';
+import output from '../lib/output.js';
+import { ArkApiProxy } from '../lib/arkApiProxy.js';
+async function listTargets(options) {
+    let proxy;
+    try {
+        proxy = new ArkApiProxy();
+        const arkApiClient = await proxy.start();
+        const allTargets = await arkApiClient.getQueryTargets();
+        // Filter by type if specified
+        let filteredTargets = allTargets;
+        if (options.type) {
+            filteredTargets = allTargets.filter((t) => t.type === options.type);
+        }
+        // Sort targets by type and name
+        filteredTargets.sort((a, b) => {
+            if (a.type !== b.type) {
+                return a.type.localeCompare(b.type);
+            }
+            return a.name.localeCompare(b.name);
+        });
+        if (options.output === 'json') {
+            console.log(JSON.stringify(filteredTargets, null, 2));
+        }
+        else {
+            if (filteredTargets.length === 0) {
+                output.warning('no targets available');
+                return;
+            }
+            // Simple list output with type/name format
+            for (const target of filteredTargets) {
+                console.log(target.id);
+            }
+        }
+    }
+    catch (error) {
+        output.error('fetching targets:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+    finally {
+        if (proxy) {
+            proxy.stop();
+        }
+    }
+}
+export function createTargetsCommand() {
+    const targets = new Command('targets');
+    targets
+        .description('list available query targets (agents, teams, models, tools)')
+        .option('-o, --output <format>', 'output format (json or text)', 'text')
+        .option('-t, --type <type>', 'filter by type (agent, team, model, tool)')
+        .action(async (options) => {
+        await listTargets(options);
+    });
+    targets
+        .command('list')
+        .alias('ls')
+        .description('list all available query targets')
+        .option('-o, --output <format>', 'output format (json or text)', 'text')
+        .option('-t, --type <type>', 'filter by type (agent, team, model, tool)')
+        .action(async (options) => {
+        await listTargets(options);
+    });
+    return targets;
+}

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

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

package/dist/commands/teams/index.js

@@ -0,0 +1,54 @@
+import { Command } from 'commander';
+import { execa } from 'execa';
+import output from '../../lib/output.js';
+async function listTeams(options) {
+    try {
+        // Use kubectl to get teams
+        const result = await execa('kubectl', ['get', 'teams', '-o', 'json'], {
+            stdio: 'pipe',
+        });
+        const data = JSON.parse(result.stdout);
+        const teams = data.items || [];
+        if (options.output === 'json') {
+            // Output the raw items for JSON format
+            console.log(JSON.stringify(teams, null, 2));
+        }
+        else {
+            if (teams.length === 0) {
+                output.info('No teams found');
+                return;
+            }
+            teams.forEach((team) => {
+                console.log(team.metadata.name);
+            });
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('the server doesn\'t have a resource type')) {
+            output.error('Team CRDs not installed. Is the ARK controller running?');
+        }
+        else {
+            output.error(`Failed to list teams: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+        process.exit(1);
+    }
+}
+export function createTeamsCommand() {
+    const teamsCommand = new Command('teams');
+    teamsCommand
+        .description('List available teams')
+        .option('-o, --output <format>', 'Output format (json)', 'text')
+        .action(async (options) => {
+        await listTeams(options);
+    });
+    const listCommand = new Command('list');
+    listCommand
+        .alias('ls')
+        .description('List available teams')
+        .option('-o, --output <format>', 'Output format (json)', 'text')
+        .action(async (options) => {
+        await listTeams(options);
+    });
+    teamsCommand.addCommand(listCommand);
+    return teamsCommand;
+}

package/dist/commands/teams/selector.d.ts

@@ -0,0 +1,8 @@
+import { Team, ArkApiClient } from '../../lib/arkApiClient.js';
+interface TeamSelectorProps {
+    arkApiClient: ArkApiClient;
+    onSelect: (team: Team) => void;
+    onExit: () => void;
+}
+export declare function TeamSelector({ arkApiClient, onSelect, onExit, }: TeamSelectorProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/commands/teams/selector.js

@@ -0,0 +1,55 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from 'react';
+import { Box, Text, useInput } from 'ink';
+export function TeamSelector({ arkApiClient, onSelect, onExit, }) {
+    const [selectedIndex, setSelectedIndex] = useState(0);
+    const [teams, setTeams] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        arkApiClient
+            .getTeams()
+            .then((fetchedTeams) => {
+            setTeams(fetchedTeams);
+            setLoading(false);
+        })
+            .catch((err) => {
+            setError(err.message || 'Failed to fetch teams');
+            setLoading(false);
+        });
+    }, [arkApiClient]);
+    useInput((input, key) => {
+        if (key.escape) {
+            onExit();
+        }
+        else if (key.upArrow || input === 'k') {
+            setSelectedIndex((prev) => (prev === 0 ? teams.length - 1 : prev - 1));
+        }
+        else if (key.downArrow || input === 'j') {
+            setSelectedIndex((prev) => (prev === teams.length - 1 ? 0 : prev + 1));
+        }
+        else if (key.return) {
+            onSelect(teams[selectedIndex]);
+        }
+        else {
+            // Handle number keys for quick selection
+            const num = parseInt(input, 10);
+            if (!isNaN(num) && num >= 1 && num <= teams.length) {
+                onSelect(teams[num - 1]);
+            }
+        }
+    });
+    if (loading) {
+        return (_jsx(Box, { children: _jsx(Text, { children: "Loading teams..." }) }));
+    }
+    if (error) {
+        return (_jsx(Box, { children: _jsxs(Text, { color: "red", children: ["Error: ", error] }) }));
+    }
+    if (teams.length === 0) {
+        return (_jsx(Box, { children: _jsx(Text, { children: "No teams available" }) }));
+    }
+    const selectedTeam = teams[selectedIndex];
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 2, paddingY: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, children: "Select Team" }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { dimColor: true, children: "Choose a team to start a conversation with" }) }), _jsx(Box, { flexDirection: "column", children: teams.map((team, index) => (_jsx(Box, { marginBottom: 0, children: _jsxs(Text, { color: index === selectedIndex ? 'green' : undefined, children: [index === selectedIndex ? '❯ ' : '  ', index + 1, ". ", team.name, team.strategy ? ` (${team.strategy})` : ''] }) }, team.name))) }), selectedTeam &&
+                (selectedTeam.description || selectedTeam.members_count) && (_jsx(Box, { marginTop: 1, paddingLeft: 2, children: _jsx(Text, { dimColor: true, wrap: "wrap", children: selectedTeam.description ||
+                        `Members: ${selectedTeam.members_count}` }) })), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Enter to confirm \u00B7 Number to select \u00B7 Esc to exit" }) })] }));
+}

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

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

package/dist/commands/tools/index.js

@@ -0,0 +1,54 @@
+import { Command } from 'commander';
+import { execa } from 'execa';
+import output from '../../lib/output.js';
+async function listTools(options) {
+    try {
+        // Use kubectl to get tools (MCPServers)
+        const result = await execa('kubectl', ['get', 'mcpservers', '-o', 'json'], {
+            stdio: 'pipe',
+        });
+        const data = JSON.parse(result.stdout);
+        const tools = data.items || [];
+        if (options.output === 'json') {
+            // Output the raw items for JSON format
+            console.log(JSON.stringify(tools, null, 2));
+        }
+        else {
+            if (tools.length === 0) {
+                output.info('No tools found');
+                return;
+            }
+            tools.forEach((tool) => {
+                console.log(tool.metadata.name);
+            });
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('the server doesn\'t have a resource type')) {
+            output.error('MCPServer CRDs not installed. Is the ARK controller running?');
+        }
+        else {
+            output.error(`Failed to list tools: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+        process.exit(1);
+    }
+}
+export function createToolsCommand() {
+    const toolsCommand = new Command('tools');
+    toolsCommand
+        .description('List available tools')
+        .option('-o, --output <format>', 'Output format (json)', 'text')
+        .action(async (options) => {
+        await listTools(options);
+    });
+    const listCommand = new Command('list');
+    listCommand
+        .alias('ls')
+        .description('List available tools')
+        .option('-o, --output <format>', 'Output format (json)', 'text')
+        .action(async (options) => {
+        await listTools(options);
+    });
+    toolsCommand.addCommand(listCommand);
+    return toolsCommand;
+}

package/dist/commands/tools/selector.d.ts

@@ -0,0 +1,8 @@
+import { Tool, ArkApiClient } from '../../lib/arkApiClient.js';
+interface ToolSelectorProps {
+    arkApiClient: ArkApiClient;
+    onSelect: (tool: Tool) => void;
+    onExit: () => void;
+}
+export declare function ToolSelector({ arkApiClient, onSelect, onExit, }: ToolSelectorProps): import("react/jsx-runtime").JSX.Element;
+export {};