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

package/dist/lib/timeout.js

@@ -0,0 +1,20 @@
+export function parseTimeoutToSeconds(value) {
+    const match = value.match(/^(\d+)([smh])?$/);
+    if (!match) {
+        throw new Error('Invalid timeout format. Use format like 30s, 2m, or 1h');
+    }
+    const num = parseInt(match[1], 10);
+    const unit = match[2];
+    if (!unit)
+        return num;
+    switch (unit) {
+        case 's':
+            return num;
+        case 'm':
+            return num * 60;
+        case 'h':
+            return num * 3600;
+        default:
+            return num;
+    }
+}

package/dist/lib/timeout.spec.js

@@ -0,0 +1,14 @@
+import { describe, it, expect } from '@jest/globals';
+import { parseTimeoutToSeconds } from './timeout.js';
+describe('parseTimeoutToSeconds', () => {
+    it('should parse time units correctly', () => {
+        expect(parseTimeoutToSeconds('30s')).toBe(30);
+        expect(parseTimeoutToSeconds('2m')).toBe(120);
+        expect(parseTimeoutToSeconds('1h')).toBe(3600);
+        expect(parseTimeoutToSeconds('60')).toBe(60);
+    });
+    it('should throw error for invalid formats', () => {
+        expect(() => parseTimeoutToSeconds('abc')).toThrow('Invalid timeout format');
+        expect(() => parseTimeoutToSeconds('-5s')).toThrow('Invalid timeout format');
+    });
+});

package/dist/lib/waitForReady.d.ts

@@ -0,0 +1,8 @@
+import type { ArkService } from '../types/arkService.js';
+export interface WaitProgress {
+    serviceName: string;
+    ready: boolean;
+    error?: string;
+}
+export declare function waitForDeploymentReady(deploymentName: string, namespace: string, timeoutSeconds: number): Promise<boolean>;
+export declare function waitForServicesReady(services: ArkService[], timeoutSeconds: number, onProgress?: (progress: WaitProgress) => void): Promise<boolean>;

package/dist/lib/waitForReady.js

@@ -0,0 +1,32 @@
+import { execa } from 'execa';
+export async function waitForDeploymentReady(deploymentName, namespace, timeoutSeconds) {
+    try {
+        await execa('kubectl', [
+            'wait',
+            '--for=condition=available',
+            `deployment/${deploymentName}`,
+            '-n',
+            namespace,
+            `--timeout=${timeoutSeconds}s`,
+        ], { timeout: timeoutSeconds * 1000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function waitForServicesReady(services, timeoutSeconds, onProgress) {
+    const validServices = services.filter((s) => s.k8sDeploymentName && s.namespace);
+    const checkPromises = validServices.map(async (service) => {
+        const isReady = await waitForDeploymentReady(service.k8sDeploymentName, service.namespace, timeoutSeconds);
+        if (onProgress) {
+            onProgress({
+                serviceName: service.name,
+                ready: isReady,
+            });
+        }
+        return isReady;
+    });
+    const results = await Promise.all(checkPromises);
+    return results.every((ready) => ready);
+}

package/dist/lib/waitForReady.spec.js

@@ -0,0 +1,104 @@
+import { describe, it, expect, jest, beforeEach } from '@jest/globals';
+jest.unstable_mockModule('execa', () => ({
+    execa: jest.fn(),
+}));
+const { execa } = await import('execa');
+const { waitForDeploymentReady, waitForServicesReady } = await import('./waitForReady.js');
+const mockedExeca = execa;
+describe('waitForDeploymentReady', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    it('returns true when deployment is ready', async () => {
+        mockedExeca.mockResolvedValueOnce({
+            stdout: 'deployment.apps/ark-controller condition met',
+            stderr: '',
+            exitCode: 0,
+        });
+        const result = await waitForDeploymentReady('ark-controller', 'ark-system', 30);
+        expect(result).toBe(true);
+        expect(mockedExeca).toHaveBeenCalledWith('kubectl', [
+            'wait',
+            '--for=condition=available',
+            'deployment/ark-controller',
+            '-n',
+            'ark-system',
+            '--timeout=30s',
+        ], { timeout: 30000 });
+    });
+    it('returns false on error', async () => {
+        mockedExeca.mockRejectedValueOnce(new Error('kubectl error'));
+        const result = await waitForDeploymentReady('ark-api', 'default', 10);
+        expect(result).toBe(false);
+    });
+});
+describe('waitForServicesReady', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    const service1 = {
+        name: 'ark-controller',
+        helmReleaseName: 'ark-controller',
+        description: 'Core controller',
+        enabled: true,
+        category: 'core',
+        namespace: 'ark-system',
+        k8sDeploymentName: 'ark-controller',
+    };
+    const service2 = {
+        name: 'ark-api',
+        helmReleaseName: 'ark-api',
+        description: 'API service',
+        enabled: true,
+        category: 'service',
+        namespace: 'default',
+        k8sDeploymentName: 'ark-api',
+    };
+    it('returns true when all services are ready', async () => {
+        mockedExeca.mockResolvedValue({
+            stdout: 'condition met',
+            stderr: '',
+            exitCode: 0,
+        });
+        const result = await waitForServicesReady([service1, service2], 30);
+        expect(result).toBe(true);
+        expect(mockedExeca).toHaveBeenCalledTimes(2);
+    });
+    it('returns false when any service fails', async () => {
+        mockedExeca
+            .mockResolvedValueOnce({ stdout: 'ok', stderr: '', exitCode: 0 })
+            .mockRejectedValueOnce(new Error('timeout'));
+        const result = await waitForServicesReady([service1, service2], 30);
+        expect(result).toBe(false);
+    });
+    it('calls progress callback', async () => {
+        mockedExeca.mockResolvedValue({
+            stdout: 'ok',
+            stderr: '',
+            exitCode: 0,
+        });
+        const onProgress = jest.fn();
+        await waitForServicesReady([service1], 30, onProgress);
+        expect(onProgress).toHaveBeenCalledWith({
+            serviceName: 'ark-controller',
+            ready: true,
+        });
+    });
+    it('skips services without deployment info', async () => {
+        const incompleteService = {
+            name: 'incomplete',
+            helmReleaseName: 'incomplete',
+            description: 'No deployment info',
+            enabled: true,
+            category: 'service',
+        };
+        mockedExeca.mockResolvedValue({
+            stdout: 'ok',
+            stderr: '',
+            exitCode: 0,
+        });
+        const result = await waitForServicesReady([service1, incompleteService], 30);
+        expect(result).toBe(true);
+        expect(mockedExeca).toHaveBeenCalledTimes(1);
+    });
+});

package/dist/types/arkService.d.ts

@@ -0,0 +1,27 @@
+export interface ArkService {
+    name: string;
+    helmReleaseName: string;
+    description: string;
+    enabled: boolean;
+    category: string;
+    namespace?: string;
+    chartPath?: string;
+    installArgs?: string[];
+    k8sServiceName?: string;
+    k8sServicePort?: number;
+    k8sPortForwardLocalPort?: number;
+    k8sDeploymentName?: string;
+    k8sDevDeploymentName?: string;
+}
+export interface ServiceCollection {
+    [key: string]: ArkService;
+}
+export interface ArkDependency {
+    name: string;
+    command: string;
+    args: string[];
+    description: string;
+}
+export interface DependencyCollection {
+    [key: string]: ArkDependency;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agents-at-scale/ark",
-  "version": "0.1.36-rc1",
-  "description": "ARK CLI - Interactive terminal interface for ARK agents",
+  "version": "0.1.37",
+  "description": "Ark CLI - Interactive terminal interface for ARK agents",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
@@ -18,7 +18,7 @@
     "lint": "eslint src/ --fix && prettier --write src/",
     "lint:check": "eslint src/ && prettier --check src/",
     "test": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --coverage --coverageDirectory=./artifacts/coverage --coverageReporters=text --coverageReporters=lcov --coverageReporters=text-summary",
-    "postinstall": "echo \"ARK CLI installed! Run 'ark' to try it out.\""
+    "postinstall": "echo \"Ark CLI installed. Run 'ark' to try it out.\""
   },
   "keywords": [
     "ark",

package/dist/charts/charts.d.ts

@@ -1,5 +0,0 @@
-/**
- * @deprecated Use arkServices.ts instead. This file is kept for backward compatibility.
- * Charts are now defined in arkServices.ts with comprehensive service definitions.
- */
-export declare const charts: import("../arkServices.js").ServiceCollection;

package/dist/charts/charts.js

@@ -1,6 +0,0 @@
-import { getInstallableServices } from '../arkServices.js';
-/**
- * @deprecated Use arkServices.ts instead. This file is kept for backward compatibility.
- * Charts are now defined in arkServices.ts with comprehensive service definitions.
- */
-export const charts = getInstallableServices();

package/dist/charts/dependencies.d.ts

@@ -1,6 +0,0 @@
-import { DependencyCollection } from './types.js';
-/**
- * Dependencies that should be installed before ARK charts
- * Note: Dependencies will be installed in the order they are defined here
- */
-export declare const dependencies: DependencyCollection;

package/dist/charts/dependencies.js

@@ -1,50 +0,0 @@
-/**
- * Dependencies that should be installed before ARK charts
- * Note: Dependencies will be installed in the order they are defined here
- */
-export const dependencies = {
-    'cert-manager-repo': {
-        name: 'cert-manager-repo',
-        command: 'helm',
-        args: [
-            'repo',
-            'add',
-            'jetstack',
-            'https://charts.jetstack.io',
-            '--force-update',
-        ],
-        description: 'Add Jetstack Helm repository',
-    },
-    'helm-repo-update': {
-        name: 'helm-repo-update',
-        command: 'helm',
-        args: ['repo', 'update'],
-        description: 'Update Helm repositories',
-    },
-    'cert-manager': {
-        name: 'cert-manager',
-        command: 'helm',
-        args: [
-            'upgrade',
-            '--install',
-            'cert-manager',
-            'jetstack/cert-manager',
-            '--namespace',
-            'cert-manager',
-            '--create-namespace',
-            '--set',
-            'crds.enabled=true',
-        ],
-        description: 'Certificate management for Kubernetes',
-    },
-    'gateway-api-crds': {
-        name: 'gateway-api-crds',
-        command: 'kubectl',
-        args: [
-            'apply',
-            '-f',
-            'https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.3.0/standard-install.yaml',
-        ],
-        description: 'Gateway API CRDs',
-    },
-};

package/dist/charts/types.d.ts

@@ -1,40 +0,0 @@
-/**
- * Represents a Helm chart configuration for ARK components
- */
-export interface ArkChart {
-    /** Name of the chart (used as release name) */
-    name: string;
-    /** Full chart path (OCI registry or local path) */
-    chartPath: string;
-    /** Kubernetes namespace to install into */
-    namespace: string;
-    /** Additional arguments to pass to helm (e.g., --create-namespace, --wait, --timeout 300s, --set key=value) */
-    args?: string[];
-    /** Description of what this chart provides */
-    description?: string;
-}
-/**
- * Collection of ARK charts
- */
-export interface ChartCollection {
-    [key: string]: ArkChart;
-}
-/**
- * Represents a dependency that needs to be installed
- */
-export interface Dependency {
-    /** Name of the dependency */
-    name: string;
-    /** Command to execute (helm, kubectl, etc.) */
-    command: string;
-    /** Arguments to pass to the command */
-    args: string[];
-    /** Description of what this dependency provides */
-    description?: string;
-}
-/**
- * Collection of dependencies
- */
-export interface DependencyCollection {
-    [key: string]: Dependency;
-}

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

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

package/dist/commands/agents/selector.js

@@ -1,53 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState, useEffect } from 'react';
-import { Box, Text, useInput } from 'ink';
-export function AgentSelector({ arkApiClient, onSelect, onExit, }) {
-    const [selectedIndex, setSelectedIndex] = useState(0);
-    const [agents, setAgents] = useState([]);
-    const [loading, setLoading] = useState(true);
-    const [error, setError] = useState(null);
-    useEffect(() => {
-        arkApiClient
-            .getAgents()
-            .then((fetchedAgents) => {
-            setAgents(fetchedAgents);
-            setLoading(false);
-        })
-            .catch((err) => {
-            setError(err.message || 'Failed to fetch agents');
-            setLoading(false);
-        });
-    }, [arkApiClient]);
-    useInput((input, key) => {
-        if (key.escape) {
-            onExit();
-        }
-        else if (key.upArrow || input === 'k') {
-            setSelectedIndex((prev) => (prev === 0 ? agents.length - 1 : prev - 1));
-        }
-        else if (key.downArrow || input === 'j') {
-            setSelectedIndex((prev) => (prev === agents.length - 1 ? 0 : prev + 1));
-        }
-        else if (key.return) {
-            onSelect(agents[selectedIndex]);
-        }
-        else {
-            // Handle number keys for quick selection
-            const num = parseInt(input, 10);
-            if (!isNaN(num) && num >= 1 && num <= agents.length) {
-                onSelect(agents[num - 1]);
-            }
-        }
-    });
-    if (loading) {
-        return (_jsx(Box, { children: _jsx(Text, { children: "Loading agents..." }) }));
-    }
-    if (error) {
-        return (_jsx(Box, { children: _jsxs(Text, { color: "red", children: ["Error: ", error] }) }));
-    }
-    if (agents.length === 0) {
-        return (_jsx(Box, { children: _jsx(Text, { children: "No agents available" }) }));
-    }
-    const selectedAgent = agents[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 Agent" }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { dimColor: true, children: "Choose an agent to start a conversation with" }) }), _jsx(Box, { flexDirection: "column", children: agents.map((agent, index) => (_jsx(Box, { marginBottom: 0, children: _jsxs(Text, { color: index === selectedIndex ? 'green' : undefined, children: [index === selectedIndex ? '❯ ' : '  ', index + 1, ". ", agent.name] }) }, agent.name))) }), selectedAgent.description && (_jsx(Box, { marginTop: 1, paddingLeft: 2, children: _jsx(Text, { dimColor: true, wrap: "wrap", children: selectedAgent.description }) })), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Enter to confirm \u00B7 Number to select \u00B7 Esc to exit" }) })] }));
-}

package/dist/commands/agents.d.ts

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

package/dist/commands/agents.js

@@ -1,53 +0,0 @@
-import { Command } from 'commander';
-import { ArkApiProxy } from '../lib/arkApiProxy.js';
-import output from '../lib/output.js';
-async function listAgents(options) {
-    let proxy;
-    try {
-        proxy = new ArkApiProxy();
-        const arkApiClient = await proxy.start();
-        const agents = await arkApiClient.getAgents();
-        if (options.output === 'json') {
-            console.log(JSON.stringify(agents, null, 2));
-        }
-        else {
-            if (agents.length === 0) {
-                output.warning('no agents available');
-                return;
-            }
-            // Simple list output - just agent names with namespace prefix
-            agents.forEach(agent => {
-                console.log(`agent/${agent.name}`);
-            });
-        }
-    }
-    catch (error) {
-        output.error('fetching agents:', error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-    finally {
-        if (proxy) {
-            proxy.stop();
-        }
-    }
-}
-export function createAgentsCommand() {
-    const agentsCommand = new Command('agents');
-    agentsCommand
-        .description('list available agents')
-        .alias('agent')
-        .option('-o, --output <format>', 'output format (json or text)', 'text')
-        .action(async (options) => {
-        await listAgents(options);
-    });
-    // Add list subcommand (same as default action)
-    agentsCommand
-        .command('list')
-        .alias('ls')
-        .description('list all available agents')
-        .option('-o, --output <format>', 'output format (json or text)', 'text')
-        .action(async (options) => {
-        await listAgents(options);
-    });
-    return agentsCommand;
-}

package/dist/commands/chat.d.ts

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

package/dist/commands/chat.js

@@ -1,45 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Command } from 'commander';
-import { render } from 'ink';
-import ChatUI from '../components/ChatUI.js';
-import { ArkApiProxy } from '../lib/arkApiProxy.js';
-import { loadConfig } from '../lib/config.js';
-import output from '../lib/output.js';
-export function createChatCommand() {
-    const chatCommand = new Command('chat');
-    chatCommand
-        .description('Start an interactive chat session with ARK agents or models')
-        .argument('[target]', 'Target to connect to (e.g., agent/sample-agent, model/default)')
-        .option('-a, --agent <name>', 'Connect directly to a specific agent')
-        .option('-m, --model <name>', 'Connect directly to a specific model')
-        .action(async (targetArg, options) => {
-        // Determine initial target from argument or options
-        let initialTargetId;
-        if (targetArg) {
-            // Direct target argument (e.g., "agent/sample-agent")
-            initialTargetId = targetArg;
-        }
-        else if (options.agent) {
-            // Agent option
-            initialTargetId = `agent/${options.agent}`;
-        }
-        else if (options.model) {
-            // Model option
-            initialTargetId = `model/${options.model}`;
-        }
-        // Load config
-        const config = loadConfig();
-        // Initialize proxy first - no spinner, just let ChatUI handle loading state
-        try {
-            const proxy = new ArkApiProxy();
-            const arkApiClient = await proxy.start();
-            // Pass the initialized client and config to ChatUI
-            render(_jsx(ChatUI, { initialTargetId: initialTargetId, arkApiClient: arkApiClient, arkApiProxy: proxy, config: config }));
-        }
-        catch (error) {
-            output.error(error instanceof Error ? error.message : 'ARK API connection failed');
-            process.exit(1);
-        }
-    });
-    return chatCommand;
-}

package/dist/commands/cluster/get-ip.d.ts

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

package/dist/commands/cluster/get-ip.js

@@ -1,32 +0,0 @@
-import chalk from 'chalk';
-import { Command } from 'commander';
-import { getClusterIp } from '../../lib/cluster.js';
-export function createGetIpCommand() {
-    const getIp = new Command('get-ip');
-    getIp
-        .description('Get the IP address of the current Kubernetes cluster')
-        .option('-c, --context <context>', 'Kubernetes context to use')
-        .action(async (options) => {
-        try {
-            const clusterInfo = await getClusterIp(options.context);
-            if (clusterInfo.error) {
-                console.error(chalk.red('Error getting cluster IP:'), clusterInfo.error);
-                process.exit(1);
-            }
-            if (!clusterInfo.ip) {
-                console.error(chalk.red('Could not determine cluster IP'));
-                process.exit(1);
-            }
-            console.log(clusterInfo.ip);
-            console.error(chalk.grey(`Cluster type: ${clusterInfo.type}`));
-            if (clusterInfo.context) {
-                console.error(chalk.grey(`Context: ${clusterInfo.context}`));
-            }
-        }
-        catch (error) {
-            console.error(chalk.red('Failed to get cluster IP:'), error.message);
-            process.exit(1);
-        }
-    });
-    return getIp;
-}

package/dist/commands/cluster/get-type.d.ts

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

package/dist/commands/cluster/get-type.js

@@ -1,26 +0,0 @@
-import chalk from 'chalk';
-import { Command } from 'commander';
-import { detectClusterType } from '../../lib/cluster.js';
-export function createGetTypeCommand() {
-    const getType = new Command('get-type');
-    getType
-        .description('Detect and display the current Kubernetes cluster type')
-        .action(async () => {
-        try {
-            const clusterInfo = await detectClusterType();
-            if (clusterInfo.error) {
-                console.error(chalk.red('Error detecting cluster type:'), clusterInfo.error);
-                process.exit(1);
-            }
-            console.log(clusterInfo.type);
-            if (clusterInfo.context) {
-                console.error(chalk.grey(`Context: ${clusterInfo.context}`));
-            }
-        }
-        catch (error) {
-            console.error(chalk.red('Failed to detect cluster type:'), error.message);
-            process.exit(1);
-        }
-    });
-    return getType;
-}

package/dist/commands/completion.d.ts

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