@vextlabs/theron-cli 0.1.0

package/dist/api.js

@@ -0,0 +1,328 @@
+// API client — talks to /api/cli/chat (the new tool-loop-aware endpoint
+// we'll add to marketing/api/). Uses streaming JSON-NDJSON so we can
+// emit text deltas as they arrive AND surface tool_call frames cleanly.
+//
+// Wire format (one JSON object per line):
+//   { "type": "text_delta", "delta": "..." }
+//   { "type": "tool_call", "id": "tc_...", "name": "Read", "args": {...} }
+//   { "type": "turn_end", "stop_reason": "tool_use" | "end_turn" | "max_tokens" }
+//   { "type": "error", "message": "..." }
+//
+// We chose NDJSON over OpenAI's SSE delta shape because it's easier to
+// stream to a local CLI (no event:/data: parsing) and lets us send
+// typed tool_calls in a single coherent frame.
+/** POSTs /api/theron/plan. Returns null on any failure so the REPL
+ *  never blocks on the classifier — chat starts streaming regardless. */
+export async function fetchInteractionPlan(opts) {
+    const url = opts.apiUrl.replace(/\/$/, "") + "/api/theron/plan";
+    try {
+        const r = await fetch(url, {
+            method: "POST",
+            signal: opts.signal,
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({
+                prompt: opts.prompt,
+                history: opts.history,
+                surface: "cli",
+            }),
+        });
+        if (!r.ok)
+            return null;
+        const data = (await r.json());
+        if (!data || typeof data.intent !== "string")
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+// Failure-mode constants. Tuned for: fetch timeout > model thinking
+// time (so we don't kill long reasoning); retry budget > transient
+// 429s but not so aggressive we hammer rate limits.
+const FETCH_CONNECT_TIMEOUT_MS = 30_000; // connect / first byte
+const FETCH_TOTAL_TIMEOUT_MS = 300_000; // 5 min total stream
+const RETRY_STATUSES = new Set([408, 429, 500, 502, 503, 504]);
+const MAX_RETRIES = 3;
+/** Sleep ms with abort support. */
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted)
+            return reject(new Error("aborted"));
+        const t = setTimeout(resolve, ms);
+        signal?.addEventListener("abort", () => { clearTimeout(t); reject(new Error("aborted")); });
+    });
+}
+/** POSTs /api/cli/chat and parses NDJSON deltas. Returns when the
+ *  stream closes (normally on turn_end).
+ *
+ *  Hardened (2026-05-10):
+ *    - Retries automatically on 429 / 5xx with exponential backoff
+ *      (1s → 2s → 4s, max 3 retries). Surfaces "rate limited, retrying
+ *      in Ns…" via onError so the user sees what's happening.
+ *    - 30s connect timeout + 5min total stream timeout. After timeout
+ *      we surface a friendly error rather than hanging.
+ *    - Network errors (ECONNRESET, fetch failures) get a single
+ *      reconnect attempt before bailing.
+ *    - Ignored partial NDJSON frames at stream-end (some upstreams
+ *      flush a half-line on close; previously this logged a noisy
+ *      "skipped malformed NDJSON" warning every turn). */
+/** Thrown by getJson on a non-2xx response. Carries the HTTP status so
+ *  callers can branch (e.g. 401 -> prompt re-auth). */
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(status, message, body) {
+        super(message);
+        this.name = "ApiError";
+        this.status = status;
+        this.body = body;
+    }
+}
+/** Minimal GET helper for non-streaming JSON endpoints (version probe,
+ *  workspace list/get). Mirrors streamChat's apiUrl + Bearer convention. */
+export async function getJson(path, opts) {
+    const base = opts.apiUrl.replace(/\/$/, "");
+    const url = base + (path.startsWith("/") ? path : `/${path}`);
+    const headers = { accept: "application/json" };
+    if (opts.apiKey)
+        headers.authorization = `Bearer ${opts.apiKey}`;
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            const r = await fetch(url, { method: "GET", headers });
+            const ct = r.headers.get("content-type") || "";
+            const body = ct.includes("application/json")
+                ? await r.json().catch(() => null)
+                : await r.text().catch(() => null);
+            if (!r.ok) {
+                // Retry once on transient 5xx; 4xx is terminal.
+                if (r.status >= 500 && attempt === 0) {
+                    opts.onRetry?.(`server ${r.status}, retrying…`);
+                    continue;
+                }
+                const msg = body && typeof body === "object" && "error" in body && typeof body.error === "string"
+                    ? body.error
+                    : `HTTP ${r.status}`;
+                throw new ApiError(r.status, msg, body);
+            }
+            return body;
+        }
+        catch (err) {
+            if (err instanceof ApiError)
+                throw err;
+            if (attempt === 0) {
+                opts.onRetry?.(`network error, retrying…`);
+                continue;
+            }
+            throw err;
+        }
+    }
+    throw new ApiError(0, "request failed after retry");
+}
+export async function streamChat(req, h) {
+    const url = req.apiUrl.replace(/\/$/, "") + "/api/cli/chat";
+    let attempt = 0;
+    while (attempt <= MAX_RETRIES) {
+        attempt += 1;
+        // Per-attempt abort — chains through caller's signal + a connect
+        // timeout. Clears after first byte; total-stream timeout caps the
+        // whole thing.
+        const ctl = new AbortController();
+        const onCallerAbort = () => ctl.abort();
+        req.signal?.addEventListener("abort", onCallerAbort);
+        const connectTimer = setTimeout(() => ctl.abort(), FETCH_CONNECT_TIMEOUT_MS);
+        const totalTimer = setTimeout(() => ctl.abort(), FETCH_TOTAL_TIMEOUT_MS);
+        let r;
+        try {
+            r = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    ...(req.apiKey ? { authorization: `Bearer ${req.apiKey}` } : {}),
+                    accept: "application/x-ndjson",
+                },
+                body: JSON.stringify({
+                    messages: req.messages,
+                    tools: req.tools,
+                    surface: "cli",
+                    profile: req.profile,
+                }),
+                signal: ctl.signal,
+            });
+            clearTimeout(connectTimer);
+        }
+        catch (err) {
+            clearTimeout(connectTimer);
+            clearTimeout(totalTimer);
+            req.signal?.removeEventListener("abort", onCallerAbort);
+            const aborted = req.signal?.aborted ?? false;
+            if (aborted) {
+                h.onError("canceled");
+                return;
+            }
+            if (attempt <= MAX_RETRIES) {
+                const wait = 1000 * Math.pow(2, attempt - 1);
+                h.onError(`network error (${err instanceof Error ? err.message : String(err)}) — retrying in ${wait / 1000}s…`);
+                try {
+                    await sleep(wait, req.signal);
+                }
+                catch {
+                    return;
+                }
+                continue;
+            }
+            h.onError(`network error after ${MAX_RETRIES} retries: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+        if (!r.ok || !r.body) {
+            let detail = "";
+            try {
+                detail = (await r.text()).slice(0, 500);
+            }
+            catch { /* ignore */ }
+            clearTimeout(totalTimer);
+            req.signal?.removeEventListener("abort", onCallerAbort);
+            // Retry on transient statuses with exponential backoff.
+            if (RETRY_STATUSES.has(r.status) && attempt <= MAX_RETRIES) {
+                const wait = 1000 * Math.pow(2, attempt - 1);
+                const reason = r.status === 429 ? "rate limited" : `HTTP ${r.status}`;
+                h.onError(`${reason} — retrying in ${wait / 1000}s…`);
+                try {
+                    await sleep(wait, req.signal);
+                }
+                catch {
+                    return;
+                }
+                continue;
+            }
+            // Friendlier 401 / 403 messaging — auth issue, not infra.
+            if (r.status === 401 || r.status === 403) {
+                h.onError(`HTTP ${r.status}: not authorized. Run \`theron login\` or check your API key.`);
+            }
+            else {
+                h.onError(`HTTP ${r.status}: ${detail || "no response body"}`);
+            }
+            return;
+        }
+        // Stream consumed successfully — read NDJSON line-by-line.
+        const reader = r.body.getReader();
+        const decoder = new TextDecoder();
+        let buf = "";
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    // Surface any trailing JSON line (some servers don't flush
+                    // a final newline). Tolerate parse failure quietly here —
+                    // the previous noisy warning fired every turn on partial
+                    // chunks.
+                    const tail = buf.trim();
+                    if (tail) {
+                        try {
+                            const frame = JSON.parse(tail);
+                            dispatchFrame(frame, h);
+                        }
+                        catch { /* end-of-stream partial — ignore */ }
+                    }
+                    break;
+                }
+                buf += decoder.decode(value, { stream: true });
+                let idx;
+                while ((idx = buf.indexOf("\n")) >= 0) {
+                    const line = buf.slice(0, idx).trim();
+                    buf = buf.slice(idx + 1);
+                    if (!line)
+                        continue;
+                    try {
+                        dispatchFrame(JSON.parse(line), h);
+                    }
+                    catch {
+                        // Mid-stream malformed line — skip silently. Server can
+                        // hiccup; we'd rather lose one frame than spam stderr.
+                    }
+                }
+            }
+        }
+        catch (err) {
+            // Stream interrupted. Most common cause: timeout fired on a
+            // genuinely-long generation. Surface the cause + don't retry —
+            // the model already produced partial output, retrying would
+            // duplicate it.
+            const aborted = req.signal?.aborted ?? false;
+            if (aborted) {
+                h.onError("canceled");
+            }
+            else {
+                h.onError(`stream interrupted: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        finally {
+            clearTimeout(totalTimer);
+            req.signal?.removeEventListener("abort", onCallerAbort);
+        }
+        return;
+    }
+}
+/** Apply one parsed NDJSON frame to the handler set. */
+/** Normalize tool-call args. The current substrate (DeepSeek-V3.2 via
+ *  OpenRouter) intermittently emits arguments as a JSON *string* (single
+ *  or double-encoded) and leaks special tokens like
+ *  `<|tool_call_argument_begin|>` into the payload. Left unhandled, every
+ *  tool sees `undefined` for its required args and the agent loop stalls.
+ *  This coerces any shape into a plain object so Read/Glob/Grep/Edit work. */
+export function normalizeToolArgs(raw) {
+    if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+        return raw;
+    }
+    if (typeof raw === "string") {
+        // Strip model special tokens (<|...|>) and any `functions.Name:1` prefix.
+        let s = raw.replace(/<\|[^|]*\|>/g, "").replace(/^\s*functions\.[A-Za-z_]+:\d+\s*/g, "").trim();
+        // Unwrap up to two layers of JSON encoding.
+        for (let i = 0; i < 2; i++) {
+            try {
+                const parsed = JSON.parse(s);
+                if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+                    return parsed;
+                }
+                if (typeof parsed === "string") {
+                    s = parsed;
+                    continue;
+                }
+            }
+            catch {
+                break;
+            }
+        }
+        // Last resort: pull the first {...} block out of contaminated text.
+        const m = s.match(/\{[\s\S]*\}/);
+        if (m) {
+            try {
+                const obj = JSON.parse(m[0]);
+                if (obj && typeof obj === "object" && !Array.isArray(obj)) {
+                    return obj;
+                }
+            }
+            catch { /* give up */ }
+        }
+    }
+    return {};
+}
+/** Strip a leaked `functions.` prefix / `:N` suffix off a tool name. */
+function normalizeToolName(name) {
+    const s = typeof name === "string" ? name : "";
+    return s.replace(/<\|[^|]*\|>/g, "").replace(/^functions\./, "").replace(/:\d+$/, "").trim();
+}
+function dispatchFrame(frame, h) {
+    const f = frame;
+    if (f && typeof f === "object" && "type" in f) {
+        if (f.type === "text_delta")
+            h.onTextDelta(f.delta);
+        else if (f.type === "tool_call")
+            h.onToolCall({ id: f.id, name: normalizeToolName(f.name), args: normalizeToolArgs(f.args) });
+        else if (f.type === "turn_end")
+            h.onTurnEnd(f.stop_reason);
+        else if (f.type === "error")
+            h.onError(f.message);
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/auth.d.ts

@@ -0,0 +1,15 @@
+export interface Credentials {
+    api_key?: string;
+    /** Override the API base URL — defaults to https://theron.tryvext.com */
+    api_url?: string;
+    /** Last-known username for greeting. */
+    email?: string;
+}
+export declare function loadCredentials(): Promise<Credentials>;
+export declare function saveCredentials(creds: Credentials): Promise<void>;
+/** Path to the credentials file — exposed so other commands can clear
+ *  it consistently (REPL `/logout`, etc.) without rebuilding the path. */
+export declare function credentialsPath(): string;
+/** Interactive `theron login` flow. */
+export declare function loginCommand(): Promise<number>;
+export declare function logoutCommand(): Promise<number>;

package/dist/auth.js

@@ -0,0 +1,92 @@
+// Auth — stores the user's API key in ~/.theron/credentials so the
+// CLI doesn't need it on the command line every invocation.
+//
+// Resolution order (collapsed by loadCredentials, then --api-key beats
+// it inside index.ts):
+//   1. --api-key CLI flag     (handled by main, not here)
+//   2. THERON_API_KEY env var
+//   3. ~/.theron/credentials JSON
+// Run `theron login` to set option 3 interactively.
+//
+// Storage is a flat 0600 file with 0700 dir, which gates against
+// other-user reads on a multi-user box. macOS Keychain / Windows
+// Credential Manager / freedesktop Secret Service are on the roadmap;
+// see OPEN_QUESTIONS in the audit.
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import readline from "node:readline";
+const CRED_DIR = path.join(os.homedir(), ".theron");
+const CRED_FILE = path.join(CRED_DIR, "credentials");
+export async function loadCredentials() {
+    // Env wins over file.
+    const envKey = process.env.THERON_API_KEY;
+    const envUrl = process.env.THERON_API_URL;
+    let fileCreds = {};
+    try {
+        const raw = await fs.readFile(CRED_FILE, "utf-8");
+        fileCreds = JSON.parse(raw);
+    }
+    catch { /* file not present — that's fine */ }
+    return {
+        api_key: envKey ?? fileCreds.api_key,
+        api_url: envUrl ?? fileCreds.api_url ?? "https://theron.tryvext.com",
+        email: fileCreds.email,
+    };
+}
+export async function saveCredentials(creds) {
+    // 0700 dir + 0600 file: only the owner can read or write the key.
+    // chmod() runs after writeFile in case the file already existed
+    // with looser perms (writeFile honors `mode` only on create).
+    await fs.mkdir(CRED_DIR, { recursive: true, mode: 0o700 });
+    await fs.writeFile(CRED_FILE, JSON.stringify(creds, null, 2), { mode: 0o600 });
+    try {
+        await fs.chmod(CRED_FILE, 0o600);
+    }
+    catch { /* best effort */ }
+    try {
+        await fs.chmod(CRED_DIR, 0o700);
+    }
+    catch { /* best effort */ }
+}
+/** Path to the credentials file — exposed so other commands can clear
+ *  it consistently (REPL `/logout`, etc.) without rebuilding the path. */
+export function credentialsPath() {
+    return CRED_FILE;
+}
+/** Interactive `theron login` flow. */
+export async function loginCommand() {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
+    console.log("\nTheron — Vext Labs CLI login\n");
+    console.log("Get your API key at https://theron.tryvext.com/settings/api-keys\n");
+    const apiKey = (await ask("API key: ")).trim();
+    const apiUrl = (await ask("API URL [https://theron.tryvext.com]: ")).trim() || undefined;
+    const email = (await ask("Email (for greeting, optional): ")).trim() || undefined;
+    rl.close();
+    if (!apiKey) {
+        console.error("No API key entered. Aborting.");
+        return 1;
+    }
+    await saveCredentials({ api_key: apiKey, api_url: apiUrl, email });
+    console.log(`\nSaved to ${CRED_FILE} (mode 0600)`);
+    return 0;
+}
+export async function logoutCommand() {
+    try {
+        await fs.unlink(CRED_FILE);
+        console.log(`Removed ${CRED_FILE}`);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT") {
+            console.log("Not logged in.");
+        }
+        else {
+            console.error(`Failed to remove credentials: ${err instanceof Error ? err.message : String(err)}`);
+            return 1;
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/banner.d.ts

@@ -0,0 +1,29 @@
+/** Render the THERON banner as a string of ANSI-colored block letters. */
+export declare function bannerTheron(): string;
+/** Tiny rounded-box drawing — same shape as Claude Code's "Welcome to
+ *  Claude Code research preview!" pill. Single-line content, amber
+ *  border, leading * marker. */
+export declare function welcomePill(text: string): string;
+export interface IntroNote {
+    title: string;
+    body: string[];
+}
+export declare function renderNotes(notes: IntroNote[]): string;
+export declare function sampleSuggestion(): string;
+export interface StatusLine {
+    cwd: string;
+    apiUrl: string;
+    loggedIn: boolean;
+    yolo: boolean;
+    model?: string;
+    /** Active profile label (e.g. "Code", "Legal"). Surfaces what
+     *  domain mode the REPL is in so the user always sees the active
+     *  voice + verifier set. */
+    profileLabel?: string;
+}
+export declare function renderStatus(s: StatusLine): string;
+export declare const SLASH_COMMANDS: Array<{
+    trigger: string;
+    desc: string;
+}>;
+export declare function renderSlashHelp(): string;