@hypercli.com/sdk 2026.3.13-1

package/dist/jobs.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Jobs API - GPU job management
+ */
+import type { HTTPClient } from './http.js';
+import WebSocket from 'ws';
+export interface Job {
+    jobId: string;
+    jobKey: string;
+    state: string;
+    gpuType: string;
+    gpuCount: number;
+    region: string;
+    interruptible: boolean;
+    pricePerHour: number;
+    pricePerSecond: number;
+    dockerImage: string;
+    runtime: number;
+    hostname: string | null;
+    coldBoot: boolean;
+    createdAt: number | null;
+    startedAt: number | null;
+    completedAt: number | null;
+}
+export interface ExecResult {
+    jobId: string;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface GPUMetrics {
+    index: number;
+    name: string;
+    utilization: number;
+    memoryUsed: number;
+    memoryTotal: number;
+    temperature: number;
+    powerDraw: number;
+}
+export interface SystemMetrics {
+    cpuPercent: number;
+    cpuCores: number;
+    cpuUnixPercent: number;
+    memoryUsed: number;
+    memoryLimit: number;
+}
+export interface JobMetrics {
+    gpus: GPUMetrics[];
+    system: SystemMetrics | null;
+}
+export interface CreateJobOptions {
+    image: string;
+    command?: string;
+    gpuType?: string;
+    gpuCount?: number;
+    region?: string;
+    runtime?: number;
+    interruptible?: boolean;
+    env?: Record<string, string>;
+    ports?: Record<string, number>;
+    auth?: boolean;
+    registryAuth?: {
+        username: string;
+        password: string;
+    };
+    dockerfile?: string;
+    dryRun?: boolean;
+}
+export declare class Jobs {
+    private http;
+    constructor(http: HTTPClient);
+    /**
+     * List all jobs
+     */
+    list(state?: string): Promise<Job[]>;
+    /**
+     * Get job details
+     */
+    get(jobId: string): Promise<Job>;
+    /**
+     * Create a new job
+     */
+    create(options: CreateJobOptions): Promise<Job>;
+    /**
+     * Cancel a job
+     */
+    cancel(jobId: string): Promise<any>;
+    /**
+     * Extend job runtime
+     */
+    extend(jobId: string, runtime: number): Promise<Job>;
+    /**
+     * Get job logs
+     */
+    logs(jobId: string): Promise<string>;
+    /**
+     * Get job GPU metrics
+     */
+    metrics(jobId: string): Promise<JobMetrics>;
+    /**
+     * Get job auth token
+     */
+    token(jobId: string): Promise<string>;
+    /**
+     * Execute a command non-interactively on a running job container.
+     */
+    exec(jobId: string, command: string, timeout?: number): Promise<ExecResult>;
+    /**
+     * Connect to a job shell via director WebSocket proxy.
+     */
+    shellConnect(jobId: string, shell?: string): Promise<WebSocket>;
+}
+/**
+ * Check if string looks like a UUID (job ID)
+ */
+export declare function isUuid(s: string): boolean;
+/**
+ * Find job by UUID via direct API call
+ */
+export declare function findById(jobs: Jobs, jobId: string): Promise<Job | null>;
+/**
+ * Find job by hostname (exact or prefix match)
+ */
+export declare function findByHostname(jobList: Job[], hostname: string): Job | null;
+/**
+ * Find job by IP address (extracted from hostname)
+ */
+export declare function findByIp(jobList: Job[], ip: string): Promise<Job | null>;
+/**
+ * Find a job by UUID, hostname, or IP address
+ */
+export declare function findJob(jobs: Jobs, identifier: string, state?: string): Promise<Job | null>;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"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"}

package/dist/jobs.js

@@ -0,0 +1,244 @@
+import WebSocket from 'ws';
+function jobFromDict(data) {
+    return {
+        jobId: data.job_id || '',
+        jobKey: data.job_key || '',
+        state: data.state || '',
+        gpuType: data.gpu_type || '',
+        gpuCount: data.gpu_count || 1,
+        region: data.region || '',
+        interruptible: data.interruptible !== false,
+        pricePerHour: data.price_per_hour || 0,
+        pricePerSecond: data.price_per_second || 0,
+        dockerImage: data.docker_image || '',
+        runtime: data.runtime || 0,
+        hostname: data.hostname || null,
+        coldBoot: data.cold_boot ?? true,
+        createdAt: data.created_at || null,
+        startedAt: data.started_at || null,
+        completedAt: data.completed_at || null,
+    };
+}
+function execResultFromDict(data) {
+    return {
+        jobId: data.job_id || '',
+        stdout: data.stdout || '',
+        stderr: data.stderr || '',
+        exitCode: data.exit_code ?? -1,
+    };
+}
+function gpuMetricsFromDict(data) {
+    return {
+        index: data.index || 0,
+        name: data.name || '',
+        utilization: data.utilization_gpu_percent || 0,
+        memoryUsed: data.memory_used_mb || 0,
+        memoryTotal: data.memory_total_mb || 0,
+        temperature: data.temperature_c || 0,
+        powerDraw: data.power_draw_w || 0,
+    };
+}
+function systemMetricsFromDict(data) {
+    return {
+        cpuPercent: data.cpu_percent || 0,
+        cpuCores: data.cpu_cores || 1,
+        cpuUnixPercent: data.cpu_unix_percent || data.cpu_percent || 0,
+        memoryUsed: data.memory_used_mb || 0,
+        memoryLimit: data.memory_limit_mb || 0,
+    };
+}
+function jobMetricsFromDict(data) {
+    return {
+        gpus: (data.gpus || []).map(gpuMetricsFromDict),
+        system: data.system ? systemMetricsFromDict(data.system) : null,
+    };
+}
+export class Jobs {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List all jobs
+     */
+    async list(state) {
+        const params = {};
+        if (state) {
+            params.state = state;
+        }
+        const data = await this.http.get('/api/jobs', params);
+        // API returns {"jobs": [...], "total_count": ...}
+        const jobs = typeof data === 'object' && data.jobs ? data.jobs : data;
+        return (jobs || []).map(jobFromDict);
+    }
+    /**
+     * Get job details
+     */
+    async get(jobId) {
+        const data = await this.http.get(`/api/jobs/${jobId}`);
+        return jobFromDict(data);
+    }
+    /**
+     * Create a new job
+     */
+    async create(options) {
+        const { image, command, gpuType = 'l40s', gpuCount = 1, region, runtime, interruptible = true, env, ports, auth, registryAuth, dockerfile, dryRun = false, } = options;
+        const payload = {
+            docker_image: image,
+            gpu_type: gpuType,
+            gpu_count: gpuCount,
+            interruptible,
+            command: command ? Buffer.from(command).toString('base64') : '',
+        };
+        if (region)
+            payload.region = region;
+        if (runtime)
+            payload.runtime = runtime;
+        if (env)
+            payload.env_vars = env;
+        if (ports)
+            payload.ports = ports;
+        if (auth)
+            payload.auth = auth;
+        if (registryAuth)
+            payload.registry_auth = registryAuth;
+        if (dockerfile)
+            payload.dockerfile = dockerfile;
+        if (dryRun)
+            payload.dry_run = true;
+        const data = await this.http.post('/api/jobs', payload);
+        return jobFromDict(data);
+    }
+    /**
+     * Cancel a job
+     */
+    async cancel(jobId) {
+        return await this.http.delete(`/api/jobs/${jobId}`);
+    }
+    /**
+     * Extend job runtime
+     */
+    async extend(jobId, runtime) {
+        const data = await this.http.patch(`/api/jobs/${jobId}`, { runtime });
+        return jobFromDict(data);
+    }
+    /**
+     * Get job logs
+     */
+    async logs(jobId) {
+        const data = await this.http.get(`/api/jobs/${jobId}/logs`);
+        return data.logs || '';
+    }
+    /**
+     * Get job GPU metrics
+     */
+    async metrics(jobId) {
+        const data = await this.http.get(`/api/jobs/${jobId}/metrics`);
+        return jobMetricsFromDict(data);
+    }
+    /**
+     * Get job auth token
+     */
+    async token(jobId) {
+        const data = await this.http.get(`/api/jobs/${jobId}/token`);
+        return data.token || '';
+    }
+    /**
+     * Execute a command non-interactively on a running job container.
+     */
+    async exec(jobId, command, timeout = 30) {
+        const data = await this.http.post(`/api/jobs/${jobId}/exec`, {
+            command,
+            timeout,
+        });
+        return execResultFromDict(data);
+    }
+    /**
+     * Connect to a job shell via director WebSocket proxy.
+     */
+    async shellConnect(jobId, shell = '/bin/bash') {
+        const job = await this.get(jobId);
+        const wsBase = this.http.baseUrl
+            .replace('https://', 'wss://')
+            .replace('http://', 'ws://')
+            .replace(/\/api$/, '');
+        const url = `${wsBase}/orchestra/ws/shell/${jobId}?token=${encodeURIComponent(job.jobKey)}&shell=${encodeURIComponent(shell)}`;
+        return await new Promise((resolve, reject) => {
+            const ws = new WebSocket(url);
+            const onError = (err) => reject(err);
+            ws.once('error', onError);
+            ws.once('open', () => {
+                ws.off('error', onError);
+                resolve(ws);
+            });
+        });
+    }
+}
+// Utility functions for finding jobs
+/**
+ * Check if string looks like a UUID (job ID)
+ */
+export function isUuid(s) {
+    return s.includes('-') && s.length > 30;
+}
+/**
+ * Find job by UUID via direct API call
+ */
+export async function findById(jobs, jobId) {
+    try {
+        return await jobs.get(jobId);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find job by hostname (exact or prefix match)
+ */
+export function findByHostname(jobList, hostname) {
+    for (const job of jobList) {
+        if (job.hostname && (job.hostname === hostname || job.hostname.startsWith(hostname))) {
+            return job;
+        }
+    }
+    return null;
+}
+/**
+ * Find job by IP address (extracted from hostname)
+ */
+export async function findByIp(jobList, ip) {
+    const dns = await import('dns').then(m => m.promises);
+    for (const job of jobList) {
+        if (!job.hostname)
+            continue;
+        try {
+            const addresses = await dns.resolve4(job.hostname);
+            if (addresses.includes(ip)) {
+                return job;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+/**
+ * Find a job by UUID, hostname, or IP address
+ */
+export async function findJob(jobs, identifier, state) {
+    // Try UUID first (direct API call)
+    if (isUuid(identifier)) {
+        return await findById(jobs, identifier);
+    }
+    // Get job list for hostname/IP search
+    const jobList = await jobs.list(state);
+    // Try hostname match
+    const byHostname = findByHostname(jobList, identifier);
+    if (byHostname) {
+        return byHostname;
+    }
+    // Try IP match (slower, requires DNS lookup)
+    return await findByIp(jobList, identifier);
+}
+//# sourceMappingURL=jobs.js.map

package/dist/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"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"}

package/dist/keys.d.ts

@@ -0,0 +1,39 @@
+/**
+ * API Keys management
+ */
+import type { HTTPClient } from './http.js';
+export interface ApiKey {
+    keyId: string;
+    name: string;
+    apiKey: string | null;
+    apiKeyPreview: string | null;
+    last4: string | null;
+    isActive: boolean;
+    createdAt: string;
+    lastUsedAt: string | null;
+}
+export declare class KeysAPI {
+    private http;
+    constructor(http: HTTPClient);
+    /**
+     * Create a new API key
+     */
+    create(name?: string): Promise<ApiKey>;
+    /**
+     * List all API keys (masked)
+     */
+    list(): Promise<ApiKey[]>;
+    /**
+     * Get a specific API key (masked)
+     */
+    get(keyId: string): Promise<ApiKey>;
+    /**
+     * Deactivate an API key (irreversible)
+     */
+    disable(keyId: string): Promise<any>;
+    /**
+     * Rename an API key
+     */
+    rename(keyId: string, name: string): Promise<ApiKey>;
+}
+//# sourceMappingURL=keys.d.ts.map

package/dist/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAeD,qBAAa,OAAO;IACN,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;OAEG;IACG,MAAM,CAAC,IAAI,GAAE,MAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAKvD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK/B;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzC;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI1C;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAI3D"}

package/dist/keys.js

@@ -0,0 +1,53 @@
+function apiKeyFromDict(data) {
+    return {
+        keyId: data.key_id || '',
+        name: data.name || '',
+        apiKey: data.api_key || null,
+        apiKeyPreview: data.api_key_preview || null,
+        last4: data.last4 || null,
+        isActive: data.is_active !== false,
+        createdAt: data.created_at || '',
+        lastUsedAt: data.last_used_at || null,
+    };
+}
+export class KeysAPI {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Create a new API key
+     */
+    async create(name = 'default') {
+        const data = await this.http.post('/api/keys', { name });
+        return apiKeyFromDict(data);
+    }
+    /**
+     * List all API keys (masked)
+     */
+    async list() {
+        const data = await this.http.get('/api/keys');
+        return (data || []).map(apiKeyFromDict);
+    }
+    /**
+     * Get a specific API key (masked)
+     */
+    async get(keyId) {
+        const data = await this.http.get(`/api/keys/${keyId}`);
+        return apiKeyFromDict(data);
+    }
+    /**
+     * Deactivate an API key (irreversible)
+     */
+    async disable(keyId) {
+        return await this.http.delete(`/api/keys/${keyId}`);
+    }
+    /**
+     * Rename an API key
+     */
+    async rename(keyId, name) {
+        const data = await this.http.patch(`/api/keys/${keyId}`, { name });
+        return apiKeyFromDict(data);
+    }
+}
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAgBA,SAAS,cAAc,CAAC,IAAS;IAC/B,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACrB,MAAM,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC5B,aAAa,EAAE,IAAI,CAAC,eAAe,IAAI,IAAI;QAC3C,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,QAAQ,EAAE,IAAI,CAAC,SAAS,KAAK,KAAK;QAClC,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;QAChC,UAAU,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,OAAO;IACE;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAe,SAAS;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,KAAa;QACrB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC;QACvD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,KAAa;QACzB,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,IAAY;QACtC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/logs.d.ts

@@ -0,0 +1,54 @@
+import type { HyperCLI } from './client.js';
+/**
+ * Fetch logs via REST API (one-time call)
+ */
+export declare function fetchLogs(client: HyperCLI, jobId: string, tail?: number): Promise<string[]>;
+/**
+ * Async log streamer - WebSocket streaming with optional initial fetch
+ */
+export declare class LogStream {
+    private client;
+    private jobId;
+    private jobKey?;
+    private fetchInitial;
+    private maxInitialLines;
+    private maxBuffer;
+    private ws;
+    private buffer;
+    private initialFetched;
+    private connected;
+    private closed;
+    constructor(client: HyperCLI, jobId: string, jobKey?: string | undefined, fetchInitial?: boolean, maxInitialLines?: number, maxBuffer?: number);
+    get status(): 'disconnected' | 'connecting' | 'connected' | 'closed';
+    /**
+     * Connect to log stream. Returns initial logs if fetchInitial=true.
+     */
+    connect(): Promise<string[]>;
+    /**
+     * Close the WebSocket connection
+     */
+    close(): Promise<void>;
+    /**
+     * Get current buffer contents (bounded, oldest may be dropped)
+     */
+    getBuffer(): string[];
+    /**
+     * Clear the buffer
+     */
+    clearBuffer(): void;
+    /**
+     * Async iterate over NEW log lines from WebSocket
+     */
+    [Symbol.asyncIterator](): AsyncGenerator<string>;
+}
+/**
+ * Stream logs until job reaches a terminal state
+ */
+export declare function streamLogs(client: HyperCLI, jobId: string, onLine: (line: string) => void, options?: {
+    untilState?: Set<string>;
+    pollStateInterval?: number;
+    fetchInitial?: boolean;
+    fetchFinal?: boolean;
+    maxInitialLines?: number;
+}): Promise<void>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAO5C;;GAEG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB;AAED;;GAEG;AACH,qBAAa,SAAS;IAQlB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,SAAS;IAZnB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAS;gBAGb,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,YAAY,GAAE,OAAc,EAC5B,eAAe,GAAE,MAAkC,EACnD,SAAS,GAAE,MAA2B;IAGhD,IAAI,MAAM,IAAI,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAKnE;IAED;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAsDlC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC;CAqExD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC9B,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GACA,OAAO,CAAC,IAAI,CAAC,CAoEf"}