@snoglobe/helios 0.1.0 → 0.2.0

package/dist/cli/doctor.js

@@ -0,0 +1,368 @@
+/**
+ * `helios doctor` — diagnose the full Helios setup.
+ *
+ * Checks auth, machines, storage, project config, and dependencies,
+ * printing a clear report with pass/fail/warn indicators.
+ */
+import { Effect } from "effect";
+import { Command } from "@effect/cli";
+import { exec as cpExec } from "node:child_process";
+import { existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { formatBytes, formatError } from "../ui/format.js";
+// ── Formatting helpers ──────────────────────────────────
+const PASS = "\x1b[32m\u2713\x1b[0m";
+const FAIL = "\x1b[31m\u2717\x1b[0m";
+const WARN = "\x1b[33m\u26A0\x1b[0m";
+const DIM = "\x1b[2m";
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+function heading(label) {
+    console.log(`\n  ${BOLD}${label}${RESET}`);
+}
+function pass(msg) {
+    console.log(`    ${PASS} ${msg}`);
+}
+function fail(msg) {
+    console.log(`    ${FAIL} ${msg}`);
+}
+function warn(msg) {
+    console.log(`    ${WARN} ${msg}`);
+}
+function detail(msg) {
+    console.log(`      ${DIM}${msg}${RESET}`);
+}
+/** Run a shell command and return stdout/stderr/exitCode. Never throws. */
+function sh(command, timeoutMs = 10_000) {
+    return new Promise((resolve) => {
+        cpExec(command, { timeout: timeoutMs, shell: "/bin/bash" }, (err, stdout, stderr) => {
+            let exitCode = 0;
+            if (err) {
+                exitCode = typeof err.code === "number" ? err.code : 1;
+            }
+            resolve({ stdout: stdout ?? "", stderr: stderr ?? "", exitCode });
+        });
+    });
+}
+// ── Section: Auth ───────────────────────────────────────
+async function checkAuth() {
+    heading("Auth");
+    try {
+        const { AuthManager } = await import("../providers/auth/auth-manager.js");
+        const authManager = new AuthManager();
+        // Claude
+        try {
+            const claudeAuth = authManager.isAuthenticated("claude");
+            if (claudeAuth) {
+                const creds = authManager.tokenStore.get("claude");
+                const method = creds?.method === "oauth" ? "OAuth" : "API key";
+                pass(`Claude: authenticated (${method})`);
+            }
+            else {
+                fail("Claude: not authenticated");
+            }
+        }
+        catch (e) {
+            fail(`Claude: error checking auth (${formatError(e)})`);
+        }
+        // OpenAI
+        try {
+            const openaiAuth = authManager.isAuthenticated("openai");
+            if (openaiAuth) {
+                const creds = authManager.tokenStore.get("openai");
+                const method = creds?.method === "oauth" ? "OAuth" : "API key";
+                const expired = authManager.tokenStore.isExpired("openai");
+                if (expired) {
+                    warn(`OpenAI: authenticated (${method}, token expired — will attempt refresh)`);
+                }
+                else {
+                    pass(`OpenAI: authenticated (${method})`);
+                }
+            }
+            else {
+                fail("OpenAI: not authenticated");
+            }
+        }
+        catch (e) {
+            fail(`OpenAI: error checking auth (${formatError(e)})`);
+        }
+    }
+    catch (e) {
+        fail(`Could not load auth system (${formatError(e)})`);
+    }
+}
+// ── Section: Machines ───────────────────────────────────
+async function checkMachines() {
+    heading("Machines");
+    try {
+        const { ConnectionPool } = await import("../remote/connection-pool.js");
+        const { loadMachines } = await import("../remote/config.js");
+        const pool = new ConnectionPool();
+        const machines = loadMachines();
+        // Add configured machines
+        for (const machine of machines) {
+            pool.addMachine(machine);
+        }
+        // Always check local first
+        const ids = ["local", ...machines.map((m) => m.id)];
+        for (const id of ids) {
+            if (id === "local") {
+                // Local is always connected
+                pass("local: connected");
+                await checkMachineDetails(pool, id);
+            }
+            else {
+                // Try to connect to remote machines
+                try {
+                    await pool.connect(id);
+                    const status = pool.getStatus(id);
+                    if (status.connected) {
+                        pass(`${id}: connected`);
+                        await checkMachineDetails(pool, id);
+                    }
+                    else {
+                        fail(`${id}: not connected${status.error ? ` (${status.error})` : ""}`);
+                    }
+                }
+                catch (e) {
+                    fail(`${id}: connection failed (${formatError(e)})`);
+                }
+            }
+        }
+        // Cleanup remote connections
+        pool.disconnectAll();
+    }
+    catch (e) {
+        fail(`Could not load machine config (${formatError(e)})`);
+    }
+}
+async function checkMachineDetails(pool, id) {
+    // Detect if the machine is macOS
+    const isMac = id === "local"
+        ? process.platform === "darwin"
+        : await pool.exec(id, "uname -s 2>/dev/null").then((r) => r.exitCode === 0 && r.stdout.trim().toLowerCase() === "darwin", () => false);
+    // Run GPU, Python, CUDA checks in parallel
+    const gpuCmd = isMac
+        ? "system_profiler SPDisplaysDataType 2>/dev/null"
+        : "nvidia-smi --query-gpu=name,memory.total,utilization.gpu,temperature.gpu --format=csv,noheader,nounits 2>/dev/null";
+    const [gpuResult, pyResult, cudaResult] = await Promise.all([
+        pool.exec(id, gpuCmd).catch(() => null),
+        pool.exec(id, "python3 --version 2>/dev/null || python --version 2>/dev/null").catch(() => null),
+        isMac ? null : pool.exec(id, "nvcc --version 2>/dev/null | grep -i release").catch(() => null),
+    ]);
+    // GPU info
+    let gpuFound = false;
+    if (gpuResult && gpuResult.exitCode === 0 && gpuResult.stdout.trim()) {
+        if (isMac) {
+            gpuFound = parseMacGpu(gpuResult.stdout);
+        }
+        else {
+            gpuFound = parseNvidiaGpu(gpuResult.stdout);
+        }
+    }
+    if (!gpuFound) {
+        detail("GPU: none detected");
+    }
+    // Python version
+    if (pyResult && pyResult.exitCode === 0 && pyResult.stdout.trim()) {
+        const ver = pyResult.stdout.trim().replace(/^Python\s+/i, "");
+        detail(`Python: ${ver}`);
+    }
+    else {
+        detail("Python: not found");
+    }
+    // CUDA version (only relevant for NVIDIA machines)
+    if (cudaResult && cudaResult.exitCode === 0 && cudaResult.stdout.trim()) {
+        const match = cudaResult.stdout.match(/release\s+([\d.]+)/i);
+        if (match) {
+            detail(`CUDA: ${match[1]}`);
+        }
+    }
+}
+/** Parse nvidia-smi CSV output and print GPU details. Returns true if any GPUs found. */
+function parseNvidiaGpu(stdout) {
+    let found = false;
+    for (const line of stdout.trim().split("\n")) {
+        const parts = line.split(",").map((s) => s.trim());
+        if (parts.length >= 4) {
+            const [name, memMb, utilPct, tempC] = parts;
+            const memGb = (parseInt(memMb, 10) / 1024).toFixed(0);
+            detail(`GPU: ${name} (${memGb}GB), util ${utilPct}%, temp ${tempC}\u00B0C`);
+            found = true;
+        }
+        else if (parts.length >= 2) {
+            const [name, memMb] = parts;
+            const memGb = (parseInt(memMb, 10) / 1024).toFixed(0);
+            detail(`GPU: ${name} (${memGb}GB)`);
+            found = true;
+        }
+    }
+    return found;
+}
+/** Parse macOS system_profiler SPDisplaysDataType output. Returns true if any GPUs found. */
+function parseMacGpu(stdout) {
+    let found = false;
+    const blocks = stdout.split(/(?=Chipset Model:)/);
+    for (const block of blocks) {
+        const nameMatch = block.match(/Chipset Model:\s*(.+)/);
+        if (!nameMatch)
+            continue;
+        const name = nameMatch[1].trim();
+        const parts = [name];
+        // VRAM (discrete GPUs, Intel Macs with AMD)
+        const vramMatch = block.match(/VRAM.*?:\s*(\d+)\s*(MB|GB)/i);
+        if (vramMatch) {
+            const vram = vramMatch[2].toUpperCase() === "GB"
+                ? `${vramMatch[1]}GB`
+                : `${(parseInt(vramMatch[1], 10) / 1024).toFixed(0)}GB`;
+            parts.push(vram);
+        }
+        // Metal support
+        const metalMatch = block.match(/Metal.*?:\s*(.+)/i);
+        if (metalMatch) {
+            parts.push(`Metal: ${metalMatch[1].trim()}`);
+        }
+        detail(`GPU: ${parts.join(", ")}`);
+        found = true;
+    }
+    return found;
+}
+// ── Section: Storage ────────────────────────────────────
+async function checkStorage() {
+    heading("Storage");
+    try {
+        const { HELIOS_DIR } = await import("../paths.js");
+        const dbPath = join(HELIOS_DIR, "helios.db");
+        // Database check
+        if (existsSync(dbPath)) {
+            try {
+                const stats = statSync(dbPath);
+                const sizeStr = formatBytes(stats.size);
+                // Count sessions with a lightweight query
+                let sessionCount = null;
+                try {
+                    const { getDb } = await import("../store/database.js");
+                    const db = getDb();
+                    const agentId = process.env.AGENTHUB_AGENT ?? "";
+                    const row = db.prepare("SELECT COUNT(*) AS cnt FROM sessions WHERE agent_id = ?").get(agentId);
+                    sessionCount = row?.cnt ?? null;
+                }
+                catch {
+                    // Database may be locked or corrupted
+                }
+                const sessionInfo = sessionCount !== null ? `, ${sessionCount} session${sessionCount !== 1 ? "s" : ""}` : "";
+                pass(`Database: ${dbPath} (${sizeStr}${sessionInfo})`);
+            }
+            catch (e) {
+                warn(`Database: exists at ${dbPath} but could not stat (${formatError(e)})`);
+            }
+        }
+        else {
+            warn(`Database: not found at ${dbPath} (will be created on first run)`);
+        }
+        // Disk space
+        try {
+            const dfResult = await sh(`df -h "${HELIOS_DIR}" 2>/dev/null | tail -1`);
+            if (dfResult.exitCode === 0 && dfResult.stdout.trim()) {
+                const parts = dfResult.stdout.trim().split(/\s+/);
+                if (parts.length >= 5) {
+                    const size = parts[1];
+                    const used = parts[2];
+                    const avail = parts[3];
+                    const pct = parts[4];
+                    pass(`Disk: ${used} used / ${size} total (${pct}), ${avail} available`);
+                }
+                else {
+                    warn("Disk: could not parse df output");
+                }
+            }
+            else {
+                warn("Disk: could not check disk space");
+            }
+        }
+        catch {
+            warn("Disk: could not check disk space");
+        }
+    }
+    catch (e) {
+        fail(`Could not load paths (${formatError(e)})`);
+    }
+}
+// ── Section: Project ────────────────────────────────────
+async function checkProject() {
+    heading("Project");
+    try {
+        const { findProjectConfigPath, findProjectConfig } = await import("../config/project.js");
+        const configPath = findProjectConfigPath();
+        if (configPath) {
+            const config = findProjectConfig();
+            if (config) {
+                pass(`helios.json found at ${configPath}`);
+                const parts = [];
+                if (config.provider)
+                    parts.push(`Provider: ${config.provider}`);
+                if (config.model)
+                    parts.push(`Model: ${config.model}`);
+                if (config.metricNames?.length)
+                    parts.push(`Metrics: ${config.metricNames.join(", ")}`);
+                if (config.defaultMachine)
+                    parts.push(`Machine: ${config.defaultMachine}`);
+                if (parts.length > 0) {
+                    detail(parts.join(", "));
+                }
+                if (config.instructions) {
+                    detail(`Custom instructions: ${config.instructions.length} chars`);
+                }
+                if (config.notifications) {
+                    detail(`Notifications: ${config.notifications.channels.length} channel(s) configured`);
+                }
+            }
+            else {
+                warn(`helios.json found at ${configPath} but could not parse`);
+            }
+        }
+        else {
+            fail("helios.json not found (searched up from cwd)");
+        }
+    }
+    catch (e) {
+        fail(`Error checking project config (${formatError(e)})`);
+    }
+}
+// ── Section: Dependencies ───────────────────────────────
+async function checkDependencies() {
+    heading("Dependencies");
+    const deps = ["ssh", "rsync", "git"];
+    // Check all dependencies in parallel
+    const results = await Promise.all(deps.map(async (dep) => {
+        try {
+            const result = await sh(`which ${dep} 2>/dev/null`);
+            return { dep, found: result.exitCode === 0 && !!result.stdout.trim() };
+        }
+        catch {
+            return { dep, found: false, error: true };
+        }
+    }));
+    for (const { dep, found, error } of results) {
+        if (error) {
+            fail(`${dep}: could not check`);
+        }
+        else if (found) {
+            pass(`${dep}: available`);
+        }
+        else {
+            fail(`${dep}: not found`);
+        }
+    }
+}
+// ── Command ─────────────────────────────────────────────
+export const doctor = Command.make("doctor", {}, () => Effect.promise(async () => {
+    console.log("\nhelios doctor\n");
+    await checkAuth();
+    await checkMachines();
+    await checkStorage();
+    await checkProject();
+    await checkDependencies();
+    console.log(""); // trailing newline
+}));
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/env.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Set environment variables from CLI options BEFORE any module imports
+ * that read env vars at load time (paths.ts, hub/config.ts, etc.).
+ */
+import { Option } from "effect";
+export interface EnvOptions {
+    home: Option.Option<string>;
+    hubUrl: Option.Option<string>;
+    hubKey: Option.Option<string>;
+    agent: Option.Option<string>;
+}
+export declare function applyEnv(opts: EnvOptions): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/cli/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/cli/env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAK/C"}

package/dist/cli/env.js

@@ -0,0 +1,16 @@
+/**
+ * Set environment variables from CLI options BEFORE any module imports
+ * that read env vars at load time (paths.ts, hub/config.ts, etc.).
+ */
+import { Option } from "effect";
+export function applyEnv(opts) {
+    if (Option.isSome(opts.home))
+        process.env.HELIOS_HOME = opts.home.value;
+    if (Option.isSome(opts.hubUrl))
+        process.env.AGENTHUB_URL = opts.hubUrl.value;
+    if (Option.isSome(opts.hubKey))
+        process.env.AGENTHUB_KEY = opts.hubKey.value;
+    if (Option.isSome(opts.agent))
+        process.env.AGENTHUB_AGENT = opts.agent.value;
+}
+//# sourceMappingURL=env.js.map

package/dist/cli/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/cli/env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAShC,MAAM,UAAU,QAAQ,CAAC,IAAgB;IACvC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IACxE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC7E,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC7E,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;AAC/E,CAAC"}

package/dist/cli/export.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `helios export` — export metrics and session data to CSV or JSON.
+ */
+import { Option } from "effect";
+import { Command } from "@effect/cli";
+export declare const exportCmd: Command.Command<"export", never, never, {
+    readonly sessionId: Option.Option<string>;
+    readonly format: "json" | "csv";
+    readonly what: "messages" | "metrics" | "sessions";
+}>;
+//# sourceMappingURL=export.d.ts.map

package/dist/cli/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/cli/export.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AA6BrD,eAAO,MAAM,SAAS;;;;EAsBrB,CAAC"}

package/dist/cli/export.js

@@ -0,0 +1,103 @@
+/**
+ * `helios export` — export metrics and session data to CSV or JSON.
+ */
+import { Effect, Option } from "effect";
+import { Command, Args, Options } from "@effect/cli";
+const sessionId = Args.text({ name: "session-id" }).pipe(Args.withDescription("Session to export (default: all)"), Args.optional);
+const format = Options.choice("format", ["csv", "json"]).pipe(Options.withAlias("f"), Options.withDescription("Output format"), Options.withDefault("csv"));
+const what = Options.choice("what", ["metrics", "messages", "sessions"]).pipe(Options.withAlias("w"), Options.withDescription("What to export"), Options.withDefault("metrics"));
+/** Escape a value for safe CSV output. */
+function csvField(v) {
+    if (v == null)
+        return "";
+    const s = String(v);
+    if (s.includes(",") || s.includes('"') || s.includes("\n")) {
+        return `"${s.replace(/"/g, '""')}"`;
+    }
+    return s;
+}
+export const exportCmd = Command.make("export", { sessionId, format, what }, ({ sessionId: sessionIdOpt, format, what }) => Effect.promise(async () => {
+    const { getDb } = await import("../store/database.js");
+    const db = getDb();
+    const agentId = process.env.AGENTHUB_AGENT ?? "";
+    const targetSession = Option.getOrUndefined(sessionIdOpt);
+    switch (what) {
+        case "metrics":
+            exportMetrics(db, agentId, targetSession, format);
+            break;
+        case "messages":
+            exportMessages(db, agentId, targetSession, format);
+            break;
+        case "sessions":
+            exportSessions(db, agentId, format);
+            break;
+    }
+}));
+function exportMetrics(db, agentId, sessionId, format) {
+    const query = `SELECT task_id, metric_name, value, step, timestamp FROM metrics WHERE agent_id = ? ORDER BY timestamp ASC`;
+    const params = [agentId];
+    if (sessionId) {
+        process.stderr.write("Note: session filter is not supported for metrics export (metrics are keyed by task, not session). Exporting all metrics.\n");
+    }
+    const rows = db.prepare(query).all(...params);
+    if (rows.length === 0) {
+        process.stderr.write("No metrics found.\n");
+        return;
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(rows, null, 2));
+    }
+    else {
+        console.log("task_id,metric_name,value,step,timestamp");
+        for (const r of rows) {
+            console.log(`${csvField(r.task_id)},${csvField(r.metric_name)},${r.value},${csvField(r.step)},${r.timestamp}`);
+        }
+    }
+}
+function exportMessages(db, agentId, sessionId, format) {
+    let query;
+    let params;
+    if (sessionId) {
+        query = `SELECT session_id, role, content, timestamp FROM messages WHERE session_id = ? ORDER BY timestamp ASC`;
+        params = [sessionId];
+    }
+    else {
+        query = `SELECT m.session_id, m.role, m.content, m.timestamp
+             FROM messages m JOIN sessions s ON s.id = m.session_id
+             WHERE s.agent_id = ? ORDER BY m.timestamp ASC`;
+        params = [agentId];
+    }
+    const rows = db.prepare(query).all(...params);
+    if (rows.length === 0) {
+        process.stderr.write("No messages found.\n");
+        return;
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(rows, null, 2));
+    }
+    else {
+        console.log("session_id,role,timestamp,content");
+        for (const r of rows) {
+            // Escape CSV: wrap in quotes, double internal quotes
+            console.log(`${csvField(r.session_id)},${csvField(r.role)},${r.timestamp},${csvField(r.content)}`);
+        }
+    }
+}
+function exportSessions(db, agentId, format) {
+    const rows = db.prepare(`SELECT id, provider, model, status, created_at, last_active_at, cost_usd, input_tokens, output_tokens
+     FROM sessions WHERE agent_id = ? ORDER BY last_active_at DESC`).all(agentId);
+    if (rows.length === 0) {
+        process.stderr.write("No sessions found.\n");
+        return;
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(rows, null, 2));
+    }
+    else {
+        console.log("id,provider,model,status,created_at,last_active_at,cost_usd,input_tokens,output_tokens");
+        for (const r of rows) {
+            console.log(`${csvField(r.id)},${csvField(r.provider)},${csvField(r.model)},${csvField(r.status)},${r.created_at},${r.last_active_at},${r.cost_usd},${r.input_tokens},${r.output_tokens}`);
+        }
+    }
+}
+//# sourceMappingURL=export.js.map

package/dist/cli/export.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Helios CLI — built with @effect/cli.
+ *
+ * Usage:
+ *   helios                          Interactive TUI
+ *   helios "prompt"                 TUI with initial prompt
+ *   helios -p "prompt"              Print response and exit
+ *   helios -c                       Continue most recent session
+ *   helios -r <session-id>          Resume specific session
+ *   helios auth login|logout|status Auth management
+ *   helios sessions                 List recent sessions
+ *   helios watch <machine:pid>      Stream task output + metrics
+ *   helios replay <session-id>      Replay a past session
+ *   helios report [session-id]      Generate experiment writeup
+ *   helios init                     Initialize project config
+ *   helios doctor                    Diagnose setup
+ *   helios search "query"            Search session histories
+ *   helios export [session-id]       Export data to CSV/JSON
+ *   helios kill <machine:pid>        Kill a running task
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/cli/index.js

@@ -0,0 +1,71 @@
+/**
+ * Helios CLI — built with @effect/cli.
+ *
+ * Usage:
+ *   helios                          Interactive TUI
+ *   helios "prompt"                 TUI with initial prompt
+ *   helios -p "prompt"              Print response and exit
+ *   helios -c                       Continue most recent session
+ *   helios -r <session-id>          Resume specific session
+ *   helios auth login|logout|status Auth management
+ *   helios sessions                 List recent sessions
+ *   helios watch <machine:pid>      Stream task output + metrics
+ *   helios replay <session-id>      Replay a past session
+ *   helios report [session-id]      Generate experiment writeup
+ *   helios init                     Initialize project config
+ *   helios doctor                    Diagnose setup
+ *   helios search "query"            Search session histories
+ *   helios export [session-id]       Export data to CSV/JSON
+ *   helios kill <machine:pid>        Kill a running task
+ */
+import { Command } from "@effect/cli";
+import { NodeContext, NodeRuntime } from "@effect/platform-node";
+import { Effect } from "effect";
+import { VERSION } from "../version.js";
+import { provider, claudeMode, model, continueSession, resumeSession, print, headless, home, hubUrl, hubKey, agent, files, prompt, } from "./options.js";
+import { applyEnv } from "./env.js";
+import { run } from "./run.js";
+import { auth } from "./auth.js";
+import { sessions } from "./sessions.js";
+import { watch } from "./watch.js";
+import { replay } from "./replay.js";
+import { report } from "./report.js";
+import { initCmd } from "./init-cmd.js";
+import { doctor } from "./doctor.js";
+import { search } from "./search.js";
+import { exportCmd } from "./export.js";
+import { kill } from "./kill.js";
+// ── Root command ─────────────────────────────────────────
+const helios = Command.make("helios", {
+    provider, claudeMode, model,
+    continueSession, resumeSession,
+    print, headless,
+    home, hubUrl, hubKey, agent,
+    files, prompt,
+}, (opts) => Effect.gen(function* () {
+    // Set env vars before any runtime imports
+    applyEnv({
+        home: opts.home,
+        hubUrl: opts.hubUrl,
+        hubKey: opts.hubKey,
+        agent: opts.agent,
+    });
+    yield* run({
+        provider: opts.provider,
+        claudeMode: opts.claudeMode,
+        model: opts.model,
+        continueSession: opts.continueSession,
+        resumeSession: opts.resumeSession,
+        print: opts.print,
+        headless: opts.headless,
+        files: opts.files,
+        prompt: opts.prompt,
+    });
+})).pipe(Command.withSubcommands([auth, sessions, watch, replay, report, initCmd, doctor, search, exportCmd, kill]));
+// ── Launch ───────────────────────────────────────────────
+const cli = Command.run(helios, {
+    name: "helios",
+    version: `v${VERSION}`,
+});
+cli(process.argv).pipe(Effect.provide(NodeContext.layer), NodeRuntime.runMain);
+//# sourceMappingURL=index.js.map