@agents-at-scale/ark 0.1.35 → 0.1.36

package/dist/commands/routes/index.js

@@ -0,0 +1,93 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { execa } from 'execa';
+import output from '../../lib/output.js';
+async function listRoutes() {
+    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,281 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { StatusChecker } from '../../components/statusChecker.js';
+import { StatusFormatter, } from '../../ui/statusFormatter.js';
+import { fetchVersionInfo } from '../../lib/versions.js';
+/**
+ * Enrich service with formatted details including version/revision
+ */
+function enrichServiceDetails(service) {
+    const statusMap = {
+        healthy: { icon: '✓', text: 'healthy', color: 'green' },
+        unhealthy: { icon: '✗', text: 'unhealthy', color: 'red' },
+        warning: { icon: '⚠', text: 'warning', color: 'yellow' },
+        'not ready': { icon: '○', text: 'not ready', color: 'yellow' },
+        'not installed': { icon: '?', text: 'not installed', color: 'yellow' },
+    };
+    const statusInfo = statusMap[service.status] || {
+        icon: '?',
+        text: service.status,
+        color: 'yellow',
+    };
+    // Build details array
+    const details = [];
+    if (service.status === 'healthy') {
+        if (service.version)
+            details.push(service.version);
+        if (service.revision)
+            details.push(`revision ${service.revision}`);
+    }
+    if (service.details)
+        details.push(service.details);
+    // Build display name with formatting
+    let displayName = chalk.bold(service.name);
+    if (service.namespace) {
+        displayName += ` ${chalk.blue(service.namespace)}`;
+    }
+    if (service.isDev) {
+        displayName += ' (dev)';
+    }
+    return {
+        statusInfo,
+        displayName,
+        details: details.join(', '),
+    };
+}
+function buildStatusSections(data, versionInfo) {
+    const sections = [];
+    // Dependencies section
+    sections.push({
+        title: 'system dependencies:',
+        lines: data.dependencies.map((dep) => ({
+            icon: dep.installed ? '✓' : '✗',
+            iconColor: (dep.installed ? 'green' : 'red'),
+            status: dep.installed ? 'installed' : 'missing',
+            statusColor: (dep.installed ? 'green' : 'red'),
+            name: chalk.bold(dep.name),
+            details: dep.version || '',
+            subtext: dep.installed ? undefined : dep.details,
+        })),
+    });
+    // Cluster access section
+    const clusterLines = [];
+    if (data.clusterAccess) {
+        const contextName = data.clusterInfo?.context || 'kubernetes cluster';
+        const namespace = data.clusterInfo?.namespace || 'default';
+        // Add bold context name with blue namespace
+        const name = `${chalk.bold(contextName)} ${chalk.blue(namespace)}`;
+        const details = [];
+        if (data.clusterInfo?.type && data.clusterInfo.type !== 'unknown') {
+            details.push(data.clusterInfo.type);
+        }
+        if (data.clusterInfo?.ip) {
+            details.push(data.clusterInfo.ip);
+        }
+        clusterLines.push({
+            icon: '✓',
+            iconColor: 'green',
+            status: 'accessible',
+            statusColor: 'green',
+            name,
+            details: details.join(', '),
+        });
+    }
+    else {
+        clusterLines.push({
+            icon: '✗',
+            iconColor: 'red',
+            status: 'unreachable',
+            statusColor: 'red',
+            name: 'kubernetes cluster',
+            subtext: 'Install minikube: https://minikube.sigs.k8s.io/docs/start',
+        });
+    }
+    sections.push({ title: 'cluster access:', lines: clusterLines });
+    // Ark services section
+    if (data.clusterAccess) {
+        const serviceLines = data.services
+            .filter((s) => s.name !== 'ark-controller')
+            .map((service) => {
+            const { statusInfo, displayName, details } = enrichServiceDetails(service);
+            return {
+                icon: statusInfo.icon,
+                iconColor: statusInfo.color,
+                status: statusInfo.text,
+                statusColor: statusInfo.color,
+                name: displayName,
+                details: details,
+            };
+        });
+        sections.push({ title: 'ark services:', lines: serviceLines });
+    }
+    else {
+        sections.push({
+            title: 'ark services:',
+            lines: [
+                {
+                    icon: '',
+                    status: '',
+                    name: 'Cannot check ARK services - cluster not accessible',
+                },
+            ],
+        });
+    }
+    // Ark status section
+    const arkStatusLines = [];
+    if (!data.clusterAccess) {
+        arkStatusLines.push({
+            icon: '✗',
+            iconColor: 'red',
+            status: 'no cluster access',
+            statusColor: 'red',
+            name: '',
+        });
+    }
+    else {
+        const controller = data.services?.find((s) => s.name === 'ark-controller');
+        if (!controller) {
+            arkStatusLines.push({
+                icon: '○',
+                iconColor: 'yellow',
+                status: 'not ready',
+                statusColor: 'yellow',
+                name: 'ark-controller',
+            });
+        }
+        else {
+            const { statusInfo, displayName, details } = enrichServiceDetails(controller);
+            // Map service status to ark status display
+            const statusText = controller.status === 'healthy'
+                ? 'ready'
+                : controller.status === 'not installed'
+                    ? 'not ready'
+                    : controller.status;
+            arkStatusLines.push({
+                icon: statusInfo.icon,
+                iconColor: statusInfo.color,
+                status: statusText,
+                statusColor: statusInfo.color,
+                name: displayName,
+                details: details,
+            });
+            // Add version update status as separate line
+            if (controller.status === 'healthy' && versionInfo) {
+                const currentVersion = versionInfo.current || controller.version;
+                if (!currentVersion) {
+                    // Version is unknown
+                    arkStatusLines.push({
+                        icon: '?',
+                        iconColor: 'yellow',
+                        status: 'version unknown',
+                        statusColor: 'yellow',
+                        name: '',
+                        details: versionInfo.latest
+                            ? `latest: ${versionInfo.latest}`
+                            : 'unable to determine version',
+                    });
+                }
+                else if (versionInfo.latest === undefined) {
+                    // Have current version but couldn't check for updates
+                    arkStatusLines.push({
+                        icon: '?',
+                        iconColor: 'yellow',
+                        status: `version ${currentVersion}`,
+                        statusColor: 'yellow',
+                        name: '',
+                        details: 'unable to check for updates',
+                    });
+                }
+                else {
+                    // Have both current and latest versions
+                    if (currentVersion === versionInfo.latest) {
+                        arkStatusLines.push({
+                            icon: '✓',
+                            iconColor: 'green',
+                            status: 'up to date',
+                            statusColor: 'green',
+                            name: '',
+                            details: versionInfo.latest,
+                        });
+                    }
+                    else {
+                        arkStatusLines.push({
+                            icon: '↑',
+                            iconColor: 'yellow',
+                            status: 'update available',
+                            statusColor: 'yellow',
+                            name: '',
+                            details: `${currentVersion} → ${versionInfo.latest}`,
+                        });
+                    }
+                }
+            }
+            // Add default model status
+            if (data.defaultModel) {
+                if (!data.defaultModel.exists) {
+                    arkStatusLines.push({
+                        icon: '○',
+                        iconColor: 'yellow',
+                        status: 'default model',
+                        statusColor: 'yellow',
+                        name: '',
+                        details: 'not configured',
+                    });
+                }
+                else if (data.defaultModel.available) {
+                    arkStatusLines.push({
+                        icon: '●',
+                        iconColor: 'green',
+                        status: 'default model',
+                        statusColor: 'green',
+                        name: '',
+                        details: data.defaultModel.provider || 'configured',
+                    });
+                }
+                else {
+                    arkStatusLines.push({
+                        icon: '●',
+                        iconColor: 'yellow',
+                        status: 'default model',
+                        statusColor: 'yellow',
+                        name: '',
+                        details: 'not available',
+                    });
+                }
+            }
+        }
+    }
+    sections.push({ title: 'ark status:', lines: arkStatusLines });
+    return sections;
+}
+export async function checkStatus() {
+    const spinner = ora('Checking system status').start();
+    try {
+        spinner.text = 'Checking system dependencies';
+        const statusChecker = new StatusChecker();
+        spinner.text = 'Testing cluster access';
+        spinner.text = 'Checking ARK services';
+        // Run status check and version fetch in parallel
+        const [statusData, versionInfo] = await Promise.all([
+            statusChecker.checkAll(),
+            fetchVersionInfo(),
+        ]);
+        spinner.stop();
+        const sections = buildStatusSections(statusData, versionInfo);
+        StatusFormatter.printSections(sections);
+        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,3 @@
+import { Command } from 'commander';
+import type { ArkConfig } from '../../lib/config.js';
+export declare function createTargetsCommand(_: ArkConfig): Command;

package/dist/commands/targets/index.js

@@ -0,0 +1,72 @@
+import { Command } from 'commander';
+import { execa } from 'execa';
+import output from '../../lib/output.js';
+async function fetchResourceTargets(resourceType) {
+    const result = await execa('kubectl', ['get', `${resourceType}s`, '-o', 'json'], {
+        stdio: 'pipe',
+    });
+    const data = JSON.parse(result.stdout);
+    const items = data.items || [];
+    return items.map((item) => ({
+        type: resourceType,
+        name: item.metadata.name,
+        id: `${resourceType}/${item.metadata.name}`,
+        available: item.status?.available || item.status?.phase === 'ready' || true,
+    }));
+}
+async function listTargets(options) {
+    try {
+        // Fetch all resource types in parallel
+        const resourceTypes = options.type
+            ? [options.type]
+            : ['model', 'agent', 'team', 'tool'];
+        const targetPromises = resourceTypes.map((type) => fetchResourceTargets(type));
+        const targetArrays = await Promise.all(targetPromises);
+        // Flatten all targets into single array
+        const allTargets = targetArrays.flat();
+        // Sort targets by type and name
+        allTargets.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(allTargets, null, 2));
+        }
+        else {
+            if (allTargets.length === 0) {
+                output.warning('no targets available');
+                return;
+            }
+            // Simple list output with type/name format
+            for (const target of allTargets) {
+                console.log(target.id);
+            }
+        }
+    }
+    catch (error) {
+        output.error('fetching targets:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+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/index.spec.d.ts

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

package/dist/commands/targets/index.spec.js

@@ -0,0 +1,154 @@
+import { jest } from '@jest/globals';
+import { Command } from 'commander';
+// Mock execa to avoid real kubectl calls
+jest.unstable_mockModule('execa', () => ({
+    execa: jest.fn(),
+}));
+const mockOutput = {
+    warning: jest.fn(),
+    error: jest.fn(),
+};
+jest.unstable_mockModule('../../lib/output.js', () => ({
+    default: mockOutput,
+}));
+const mockExit = jest.spyOn(process, 'exit').mockImplementation((() => {
+    throw new Error('process.exit called');
+}));
+const mockConsoleLog = jest.spyOn(console, 'log').mockImplementation(() => { });
+const { execa } = await import('execa');
+const mockExeca = execa;
+const { createTargetsCommand } = await import('./index.js');
+describe('targets command', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    it('creates command with correct structure', () => {
+        const command = createTargetsCommand({});
+        expect(command).toBeInstanceOf(Command);
+        expect(command.name()).toBe('targets');
+    });
+    it('lists targets in text format', async () => {
+        // Mock kubectl responses for each resource type (order: model, agent, team, tool)
+        mockExeca
+            .mockResolvedValueOnce({
+            stdout: JSON.stringify({
+                items: [{ metadata: { name: 'gpt-4' }, status: { available: true } }],
+            }),
+        })
+            .mockResolvedValueOnce({
+            stdout: JSON.stringify({
+                items: [
+                    { metadata: { name: 'gpt-assistant' }, status: { phase: 'ready' } },
+                ],
+            }),
+        })
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) })
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) });
+        const command = createTargetsCommand({});
+        await command.parseAsync(['node', 'test']);
+        expect(mockExeca).toHaveBeenCalledWith('kubectl', ['get', 'models', '-o', 'json'], {
+            stdio: 'pipe',
+        });
+        expect(mockExeca).toHaveBeenCalledWith('kubectl', ['get', 'agents', '-o', 'json'], {
+            stdio: 'pipe',
+        });
+        expect(mockConsoleLog).toHaveBeenCalledWith('agent/gpt-assistant');
+        expect(mockConsoleLog).toHaveBeenCalledWith('model/gpt-4');
+    });
+    it('lists targets in json format', async () => {
+        // Order: model, agent, team, tool
+        mockExeca
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) })
+            .mockResolvedValueOnce({
+            stdout: JSON.stringify({
+                items: [{ metadata: { name: 'gpt' }, status: { phase: 'ready' } }],
+            }),
+        })
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) })
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) });
+        const command = createTargetsCommand({});
+        await command.parseAsync(['node', 'test', '-o', 'json']);
+        const expectedTargets = [
+            { type: 'agent', name: 'gpt', id: 'agent/gpt', available: true },
+        ];
+        expect(mockConsoleLog).toHaveBeenCalledWith(JSON.stringify(expectedTargets, null, 2));
+    });
+    it('filters targets by type', async () => {
+        mockExeca.mockResolvedValueOnce({
+            stdout: JSON.stringify({
+                items: [
+                    { metadata: { name: 'gpt' }, status: { phase: 'ready' } },
+                    { metadata: { name: 'helper' }, status: { phase: 'ready' } },
+                ],
+            }),
+        });
+        const command = createTargetsCommand({});
+        await command.parseAsync(['node', 'test', '-t', 'agent']);
+        expect(mockExeca).toHaveBeenCalledWith('kubectl', ['get', 'agents', '-o', 'json'], {
+            stdio: 'pipe',
+        });
+        expect(mockExeca).toHaveBeenCalledTimes(1); // Only agents, not other types
+        expect(mockConsoleLog).toHaveBeenCalledWith('agent/gpt');
+        expect(mockConsoleLog).toHaveBeenCalledWith('agent/helper');
+    });
+    it('sorts targets by type then name', async () => {
+        // Order: model, agent, team, tool
+        mockExeca
+            .mockResolvedValueOnce({
+            stdout: JSON.stringify({
+                items: [
+                    { metadata: { name: 'b' }, status: { available: true } },
+                    { metadata: { name: 'a' }, status: { available: true } },
+                ],
+            }),
+        })
+            .mockResolvedValueOnce({
+            stdout: JSON.stringify({
+                items: [
+                    { metadata: { name: 'z' }, status: { phase: 'ready' } },
+                    { metadata: { name: 'a' }, status: { phase: 'ready' } },
+                ],
+            }),
+        })
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) })
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) });
+        const command = createTargetsCommand({});
+        await command.parseAsync(['node', 'test']);
+        // Check order of calls - sorted by type then name
+        const calls = mockConsoleLog.mock.calls
+            .filter((call) => call[0] && call[0].includes('/'))
+            .map((call) => call[0]);
+        expect(calls).toEqual(['agent/a', 'agent/z', 'model/a', 'model/b']);
+    });
+    it('shows warning when no targets', async () => {
+        // All resource types return empty (order: model, agent, team, tool)
+        mockExeca
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) })
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) })
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) })
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) });
+        const command = createTargetsCommand({});
+        await command.parseAsync(['node', 'test']);
+        expect(mockOutput.warning).toHaveBeenCalledWith('no targets available');
+    });
+    it('handles errors', async () => {
+        mockExeca.mockRejectedValue(new Error('kubectl not found'));
+        const command = createTargetsCommand({});
+        await expect(command.parseAsync(['node', 'test'])).rejects.toThrow('process.exit called');
+        expect(mockOutput.error).toHaveBeenCalledWith('fetching targets:', 'kubectl not found');
+        expect(mockExit).toHaveBeenCalledWith(1);
+    });
+    it('list subcommand works', async () => {
+        // Order: model, agent, team, tool
+        mockExeca
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) })
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) })
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) })
+            .mockResolvedValueOnce({ stdout: JSON.stringify({ items: [] }) });
+        const command = createTargetsCommand({});
+        await command.parseAsync(['node', 'test', 'list']);
+        expect(mockExeca).toHaveBeenCalledWith('kubectl', ['get', 'models', '-o', 'json'], {
+            stdio: 'pipe',
+        });
+    });
+});

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

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

package/dist/commands/teams/index.js

@@ -0,0 +1,64 @@
+import { Command } from 'commander';
+import { execa } from 'execa';
+import output from '../../lib/output.js';
+import { executeQuery } from '../../lib/executeQuery.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) {
+        output.error('fetching teams:', error instanceof Error ? error.message : 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);
+    // Add query command
+    const queryCommand = new Command('query');
+    queryCommand
+        .description('Query a team')
+        .argument('<name>', 'Team name')
+        .argument('<message>', 'Message to send')
+        .action(async (name, message) => {
+        await executeQuery({
+            targetType: 'team',
+            targetName: name,
+            message,
+        });
+    });
+    teamsCommand.addCommand(queryCommand);
+    return teamsCommand;
+}