@oxecli/oxe 1.0.0

package/dist/config.js

@@ -0,0 +1,280 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/** Package root (parent of dist/). Holds .env, skills/. */
+export const PROJECT_DIR = path.resolve(__dirname, "..");
+/** Where user data lives. Defaults to ~/.oxe so it survives reinstalls. */
+export const DATA_DIR = path.resolve(process.env.OXE_DATA_DIR || path.join(os.homedir(), ".oxe"));
+export const SESSION_DIR = path.join(DATA_DIR, "sessions");
+export const SKILLS_DIR = path.join(PROJECT_DIR, "skills");
+// ---------------------------------------------------------------------------
+// Tunables
+// ---------------------------------------------------------------------------
+export const max_output_chars = 8000;
+export const max_read_lines = 1500;
+export const max_read_line_chars = 500;
+export const max_read_file_bytes = 50 * 1024 * 1024;
+export const max_diff_lines = 16;
+export const max_diff_context_lines = 6;
+export const max_diff_line_chars = 400;
+export const max_agent_steps = 50;
+export const max_context_tokens = 256_000;
+export const context_overhead_margin = 32_000;
+export const compact_keep_recent_turns = 4;
+export const max_summary_source_chars = 200_000;
+export const max_output_tokens = 16384;
+export const max_empty_retries = 2;
+export const max_diff_source_chars = 1_000_000;
+export const max_grep_file_bytes = 20 * 1024 * 1024;
+export const max_read_file_stored_chars = 40_000;
+export const max_command_chars = 400;
+export const max_action_chars = 500;
+export const max_resume_history_items = 24;
+export const max_bash_timeout_seconds = 300;
+export const strict_max_properties = 2;
+export const ai_style = "grey62";
+// ---------------------------------------------------------------------------
+// .env loading
+// ---------------------------------------------------------------------------
+function loadEnvFile() {
+    const envPath = path.join(PROJECT_DIR, ".env");
+    if (!fs.existsSync(envPath))
+        return;
+    try {
+        const text = fs.readFileSync(envPath, "utf-8");
+        for (const rawLine of text.split("\n")) {
+            const line = rawLine.trim();
+            if (!line || line.startsWith("#") || !line.includes("="))
+                continue;
+            const idx = line.indexOf("=");
+            const key = line.slice(0, idx).trim();
+            let value = line.slice(idx + 1).trim();
+            if (value.length >= 2 &&
+                value[0] === value[value.length - 1] &&
+                (value[0] === '"' || value[0] === "'")) {
+                value = value.slice(1, -1);
+            }
+            if (process.env[key] === undefined)
+                process.env[key] = value;
+        }
+    }
+    catch {
+        /* ignore */
+    }
+}
+loadEnvFile();
+const OXE_SUPABASE_URL = process.env.OXE_SUPABASE_URL;
+const OXE_SUPABASE_ANON_KEY = process.env.OXE_SUPABASE_ANON_KEY;
+if (!OXE_SUPABASE_URL || !OXE_SUPABASE_ANON_KEY) {
+    console.error("Error: missing required environment variable OXE_SUPABASE_URL/OXE_SUPABASE_ANON_KEY.\n" +
+        "Set it in your shell environment, or add it to a .env file next to this package.\n");
+    process.exit(1);
+}
+export const OXE_SUPABASE_URL_EXPORT = OXE_SUPABASE_URL;
+export const OXE_SUPABASE_ANON_KEY_EXPORT = OXE_SUPABASE_ANON_KEY;
+export const OXE_KEY_PREFIX = "oxe_live_";
+export const default_base_url = process.env.OXE_BASE_URL || `${OXE_SUPABASE_URL}/functions/v1/chat-proxy`;
+export const default_model = process.env.OXE_MODEL_NAME || "deepseek-v4-flash";
+export const default_reasoning_effort = "low";
+// ---------------------------------------------------------------------------
+// OS / system context
+// ---------------------------------------------------------------------------
+export function runtimeOsSummary() {
+    return `${os.platform()} ${os.release()} (${os.arch()}, Node ${process.version})`;
+}
+export function osPrefix() {
+    const isWin = process.platform === "win32";
+    const shell = isWin ? "cmd.exe" : "POSIX sh";
+    return (`Running environment: ${runtimeOsSummary()}. ` +
+        `Shell commands run via ${shell} ` +
+        "with `shell=True`; use commands, quoting, and path separators " +
+        "appropriate to this OS.\n\n");
+}
+export const IGNORED_DIRS_BY_CATEGORY = [
+    ["Version control", [".git", ".svn"]],
+    ["Dependencies & environments", ["node_modules", "__pycache__", ".venv", "venv"]],
+    ["Build output", ["dist", "build", "target", ".tox"]],
+    ["Tool caches & IDE files", [".mypy_cache", ".pytest_cache", ".next", ".idea"]],
+];
+export const ignoredDirs = new Set(IGNORED_DIRS_BY_CATEGORY.flatMap(([, dirs]) => dirs));
+export const IGNORED_DIRS_SYSTEM_TEXT = IGNORED_DIRS_BY_CATEGORY.map(([cat, dirs]) => `- ${dirs.map((d) => `\`${d}\``).join(", ")} — ${cat}`).join("\n");
+export const SYSTEM_PROMPT_BODY = "You are a terminal-based coding agent named Oxe. You help with software engineering " +
+    "tasks by reading and editing files, running commands, and searching code, directly on the " +
+    "user's machine. You are a concise agent.\n\n" +
+    "CRITICAL: APPLY CHANGES, DON'T JUST DESCRIBE THEM:\n" +
+    "When the user asks you to make, fix, add, or refactor something, you MUST call write_file or " +
+    "edit_file to actually apply that change to the files on disk. Never respond with a plan, a " +
+    "code snippet, or instructions telling the user what to change instead of changing it yourself. " +
+    "Only describe a change in prose without applying it if you genuinely cannot proceed (e.g. the " +
+    "request is ambiguous and you need one clarifying answer first) — and say so explicitly rather " +
+    "than silently defaulting to a description.\n\n" +
+    "CRITICAL HISTORY TRACKING RULE:\n" +
+    "You must strictly keep track of your previous tool outputs during this conversation loop. If a " +
+    "tool call returns an empty string, error, or doesn't yield what you expected, DO NOT execute " +
+    "the exact same tool call with the exact same arguments again. Analyze why it failed, explicitly " +
+    "acknowledge the strategy change in your text response block, and try a completely different approach " +
+    "(e.g., changing search terms, looking at alternative files, or utilizing `bash`).\n\n" +
+    "You have these tools:\n" +
+    "- read_file: inspect a file's contents before changing it.\n" +
+    "- write_file: create a file, or replace one entirely.\n" +
+    "- edit_file: make a small, precise change by replacing one unique snippet of text.\n" +
+    "- bash: run shell commands (tests, git, package managers, build tools, etc).\n" +
+    "- glob: find files by name pattern.\n" +
+    "- grep: find text/regex matches across files.\n\n" +
+    "Search scope:\n" +
+    "- `glob` and `grep` automatically skip the following directories, so their\n" +
+    "  contents never appear in results and are never searched:\n" +
+    IGNORED_DIRS_SYSTEM_TEXT +
+    "\n\n" +
+    "Guidelines:\n" +
+    "1. Always read a file with read_file before editing it with edit_file, so your old_string " +
+    "matches exactly.\n" +
+    "2. Prefer edit_file for targeted changes and write_file only for new files or full rewrites.\n" +
+    "3. Use glob/grep to explore an unfamiliar codebase before making changes, instead of guessing " +
+    "at file locations.\n" +
+    "4. Verify your work when possible (e.g. run the relevant tests or linter with bash) before " +
+    "declaring a task done.\n" +
+    "5. Keep responses concise. Explain what you did and why, not step-by-step narration of tool calls.\n" +
+    "6. Never run destructive commands (e.g. rm -rf, force pushes) without first explaining the " +
+    "consequence in your response.\n";
+export const API_KEY_MAX = 64;
+import { validateOxeApiKey } from "./api.js";
+import { renderPanel, markupToAnsi } from "./ui.js";
+export async function loadOrPrompt() {
+    let api_key = "";
+    let key_data = {};
+    for (;;) {
+        if (!api_key) {
+            renderPanel("[bold white]Oxe Desktop Authentication[/bold white]\n\n" +
+                `[dim]Only valid Oxe API keys (starting with [bold]${OXE_KEY_PREFIX}[/bold]) generated on your\n` +
+                "Oxe web dashboard are authorized to run this agent.\n\n" +
+                "Get your key at: [bold underline]http://localhost:5173/dashboard/api-keys[/bold underline][/dim]", "Oxe Cloud Access");
+            process.stdout.write("\n");
+            api_key = await promptApiKey("Enter Oxe API Key: ");
+            if (!api_key) {
+                process.stdout.write("\n" + markupToAnsi("[red]Error: Key cannot be blank. Exiting application.[/red]") + "\n");
+                process.exit(1);
+            }
+        }
+        process.stdout.write("\n");
+        process.stdout.write(markupToAnsi("[dim]Authenticating key with Oxe Cloud…[/dim]") + "\n");
+        const validation = await validateOxeApiKey(api_key);
+        if (validation.valid) {
+            key_data = validation.key_data || {};
+            process.stdout.write(markupToAnsi(`[green]✓ Oxe API Key verified[/green] [dim](${String(key_data["name"] ?? "Desktop")})[/dim]`) + "\n");
+            process.env.OXE_API_KEY = api_key;
+            break;
+        }
+        else {
+            process.stdout.write(`\x1b[31mAuthentication Error:\x1b[0m ${validation.error}\n`);
+            process.stdout.write("\n");
+            api_key = "";
+        }
+    }
+    let timeout = 120.0;
+    try {
+        timeout = parseFloat((process.env.OXE_TIMEOUT || "120").trim() || "120");
+    }
+    catch {
+        timeout = 120.0;
+    }
+    let max_retries = 2;
+    try {
+        max_retries = parseInt((process.env.OXE_MAX_RETRIES || "2").trim() || "2", 10);
+    }
+    catch {
+        max_retries = 2;
+    }
+    let temperature = null;
+    const temp = (process.env.OXE_TEMPERATURE || "").trim();
+    if (temp) {
+        const t = parseFloat(temp);
+        if (!Number.isNaN(t))
+            temperature = t;
+    }
+    return {
+        api_key,
+        base_url: (process.env.OXE_BASE_URL || default_base_url).trim(),
+        model_name: (process.env.OXE_MODEL_NAME || default_model).trim(),
+        reasoning_effort: (process.env.OXE_REASONING_EFFORT || default_reasoning_effort).trim(),
+        timeout,
+        max_retries,
+        temperature,
+        key_data,
+    };
+}
+/**
+ * Prompt for a secret (API key) without echoing it to the terminal.
+ * Falls back to a plain readline read when stdin isn't a TTY (e.g. piped input).
+ */
+export async function promptApiKey(prompt) {
+    // Non-interactive (piped) input: just read a line, no masking possible.
+    if (!process.stdin.isTTY) {
+        const { default: readline } = await import("node:readline/promises");
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            const answer = await rl.question(prompt);
+            return answer.replace(/\r?\n$/, "").trim();
+        }
+        finally {
+            rl.close();
+        }
+    }
+    return new Promise((resolve, reject) => {
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdout.write(prompt);
+        let input = "";
+        const onData = (buf) => {
+            for (const b of buf) {
+                if (b === 3) {
+                    // Ctrl+C
+                    cleanup();
+                    process.stdout.write("\n");
+                    reject(new Error("interrupt"));
+                    return;
+                }
+                if (b === 4 || b === 26) {
+                    // Ctrl+D / Ctrl+Z
+                    cleanup();
+                    resolve(input);
+                    return;
+                }
+                if (b === 13 || b === 10) {
+                    // Enter
+                    cleanup();
+                    resolve(input);
+                    return;
+                }
+                if (b === 8 || b === 127) {
+                    // Backspace
+                    if (input.length) {
+                        input = input.slice(0, -1);
+                        process.stdout.write("\b \b");
+                    }
+                    continue;
+                }
+                if (b < 32)
+                    continue;
+                input += String.fromCharCode(b);
+                process.stdout.write("*");
+            }
+        };
+        const cleanup = () => {
+            process.stdin.removeListener("data", onData);
+            try {
+                process.stdin.setRawMode(false);
+            }
+            catch {
+                /* ignore */
+            }
+            process.stdout.write("\n");
+        };
+        process.stdin.on("data", onData);
+    });
+}