@astra-code/astra-ai 0.1.0

package/dist/lib/voice.js

@@ -0,0 +1,158 @@
+import { spawn, spawnSync } from "child_process";
+import { randomUUID } from "crypto";
+import { basename, join } from "path";
+import { tmpdir } from "os";
+import { readFile, rm } from "fs/promises";
+const VOICE_TEXT_LIMIT = 600;
+const DEFAULT_STT_MODEL = process.env.ASTRA_STT_MODEL?.trim() || "whisper-1";
+const DEFAULT_CHUNK_SECONDS = Number(process.env.ASTRA_STT_CHUNK_SECONDS ?? "2.5");
+const safeText = (text) => text.replace(/\s+/g, " ").trim().slice(0, VOICE_TEXT_LIMIT);
+const runShell = async (command) => new Promise((resolve, reject) => {
+    const child = spawn(command, { shell: true, stdio: "ignore" });
+    child.on("error", reject);
+    child.on("exit", (code) => {
+        if (code === 0) {
+            resolve();
+        }
+        else {
+            reject(new Error(`Command failed (${code}): ${command}`));
+        }
+    });
+});
+const captureAudioChunk = async (seconds) => {
+    const outPath = join(tmpdir(), `astra-stt-${randomUUID()}.wav`);
+    const custom = process.env.ASTRA_STT_CAPTURE_COMMAND?.trim();
+    let cmd = custom ?? "";
+    if (!cmd) {
+        if (process.platform === "darwin") {
+            cmd = `sox -q -d -r 16000 -c 1 -b 16 "${outPath}" trim 0 ${seconds}`;
+        }
+        else if (process.platform === "linux") {
+            cmd = `arecord -q -f S16_LE -r 16000 -c 1 -d ${Math.ceil(seconds)} "${outPath}"`;
+        }
+        else {
+            throw new Error("No default audio capture command for this platform. Set ASTRA_STT_CAPTURE_COMMAND.");
+        }
+    }
+    else {
+        cmd = cmd.replaceAll("{output}", outPath).replaceAll("{seconds}", String(seconds));
+    }
+    await runShell(cmd);
+    return outPath;
+};
+const transcribeAudioFile = async (filePath) => {
+    const apiKey = process.env.ASTRA_OPENAI_API_KEY?.trim() || process.env.OPENAI_API_KEY?.trim();
+    if (!apiKey) {
+        throw new Error("Missing OPENAI_API_KEY (or ASTRA_OPENAI_API_KEY) for Whisper STT.");
+    }
+    const bytes = await readFile(filePath);
+    const file = new File([bytes], basename(filePath), { type: "audio/wav" });
+    const form = new FormData();
+    form.append("file", file);
+    form.append("model", DEFAULT_STT_MODEL);
+    form.append("response_format", "json");
+    const response = await fetch("https://api.openai.com/v1/audio/transcriptions", {
+        method: "POST",
+        headers: { Authorization: `Bearer ${apiKey}` },
+        body: form
+    });
+    if (!response.ok) {
+        const detail = (await response.text()).slice(0, 400);
+        throw new Error(`Whisper STT failed ${response.status}: ${detail}`);
+    }
+    const data = (await response.json());
+    return String(data.text ?? "").trim();
+};
+/**
+ * Speak assistant text using either:
+ * - ASTRA_TTS_COMMAND (shell command, receives text as final arg), or
+ * - macOS `say` by default.
+ */
+export const speakText = (text) => {
+    const clean = safeText(text);
+    if (!clean) {
+        return;
+    }
+    const custom = process.env.ASTRA_TTS_COMMAND?.trim();
+    if (custom) {
+        spawn(custom, [clean], { shell: true, detached: true, stdio: "ignore" }).unref();
+        return;
+    }
+    if (process.platform === "darwin") {
+        spawn("say", [clean], { detached: true, stdio: "ignore" }).unref();
+    }
+};
+/**
+ * Run one-shot STT. Uses custom ASTRA_STT_COMMAND if provided;
+ * otherwise records a short chunk and transcribes via OpenAI Whisper.
+ */
+export const transcribeOnce = async () => {
+    const sttCommand = process.env.ASTRA_STT_COMMAND?.trim();
+    if (sttCommand) {
+        const result = spawnSync(sttCommand, { shell: true, encoding: "utf-8" });
+        if (result.error || result.status !== 0) {
+            return null;
+        }
+        const out = String(result.stdout ?? "").trim();
+        return out || null;
+    }
+    let audioPath = null;
+    try {
+        audioPath = await captureAudioChunk(DEFAULT_CHUNK_SECONDS);
+        const text = await transcribeAudioFile(audioPath);
+        return text || null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        if (audioPath) {
+            await rm(audioPath, { force: true });
+        }
+    }
+};
+export const startLiveTranscription = (handlers) => {
+    let running = true;
+    let stopping = false;
+    let transcript = "";
+    let finishedResolve = null;
+    const finished = new Promise((resolve) => {
+        finishedResolve = resolve;
+    });
+    const loop = async () => {
+        while (running) {
+            let audioPath = null;
+            try {
+                audioPath = await captureAudioChunk(DEFAULT_CHUNK_SECONDS);
+                const piece = await transcribeAudioFile(audioPath);
+                if (piece) {
+                    transcript = transcript ? `${transcript} ${piece}` : piece;
+                    handlers.onPartial(transcript);
+                }
+            }
+            catch (error) {
+                handlers.onError(error instanceof Error ? error : new Error(String(error)));
+            }
+            finally {
+                if (audioPath) {
+                    await rm(audioPath, { force: true });
+                }
+            }
+        }
+        handlers.onFinal(transcript.trim());
+        finishedResolve?.();
+    };
+    void loop();
+    return {
+        stop: async () => {
+            if (stopping) {
+                await finished;
+                return;
+            }
+            stopping = true;
+            running = false;
+            await finished;
+        }
+    };
+};
+//# sourceMappingURL=voice.js.map

package/dist/lib/voice.js.map

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

package/dist/lib/workspaceScanner.js

@@ -0,0 +1,158 @@
+/**
+ * Scans a local workspace directory to produce:
+ *   workspaceTree   — relative paths the backend uses for list_directory / search_files
+ *   workspaceFiles  — file contents the backend populates into VirtualFS
+ *                     so view_file / edit_file work without a local disk on the backend
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
+import { join, relative } from "path";
+const SKIP_DIRS = new Set([
+    "node_modules",
+    ".git",
+    ".svn",
+    ".hg",
+    "dist",
+    "build",
+    ".next",
+    ".nuxt",
+    "__pycache__",
+    ".cache",
+    "coverage",
+    ".nyc_output",
+    "vendor",
+    ".venv",
+    "venv",
+    "env",
+    ".tox",
+    "target",
+    ".gradle",
+    ".idea",
+    ".pytest_cache",
+    ".mypy_cache",
+    ".ruff_cache",
+]);
+const BINARY_EXTENSIONS = new Set([
+    ".png", ".jpg", ".jpeg", ".gif", ".webp", ".ico", ".bmp",
+    ".woff", ".woff2", ".ttf", ".eot", ".otf",
+    ".mp3", ".mp4", ".wav", ".webm", ".ogg", ".flac",
+    ".zip", ".tar", ".gz", ".br", ".zst", ".bz2", ".7z", ".rar",
+    ".pyc", ".pyo", ".class", ".o", ".so", ".dll", ".dylib",
+    ".exe", ".bin", ".pdf", ".sqlite", ".db",
+]);
+const EXT_TO_LANG = {
+    ".py": "python",
+    ".js": "javascript",
+    ".ts": "typescript",
+    ".tsx": "typescriptreact",
+    ".jsx": "javascriptreact",
+    ".json": "json",
+    ".md": "markdown",
+    ".css": "css",
+    ".scss": "scss",
+    ".less": "less",
+    ".html": "html",
+    ".xml": "xml",
+    ".rs": "rust",
+    ".go": "go",
+    ".java": "java",
+    ".c": "c",
+    ".cpp": "cpp",
+    ".h": "c",
+    ".rb": "ruby",
+    ".sh": "shellscript",
+    ".bash": "shellscript",
+    ".zsh": "shellscript",
+    ".yaml": "yaml",
+    ".yml": "yaml",
+    ".toml": "toml",
+    ".sql": "sql",
+    ".swift": "swift",
+    ".kt": "kotlin",
+    ".php": "php",
+    ".graphql": "graphql",
+    ".vue": "vue",
+    ".svelte": "svelte",
+    ".env": "plaintext",
+    ".txt": "plaintext",
+    ".csv": "plaintext",
+    ".lock": "plaintext",
+};
+const MAX_TREE_ENTRIES = 2000;
+const MAX_CONTENT_FILES = 200;
+const MAX_FILE_BYTES = 100 * 1024; // 100 KB per file
+const MAX_TOTAL_BYTES = 2 * 1024 * 1024; // 2 MB total content
+function detectLanguage(relPath) {
+    const m = relPath.toLowerCase().match(/\.[^./\\]+$/);
+    return m ? (EXT_TO_LANG[m[0]] ?? "plaintext") : "plaintext";
+}
+function isBinary(relPath) {
+    const m = relPath.toLowerCase().match(/\.[^./\\]+$/);
+    return m ? BINARY_EXTENSIONS.has(m[0]) : false;
+}
+/**
+ * Scan `rootDir` and return both the path tree and file contents.
+ *
+ * Called once per `streamChat` request so the backend VirtualFS is always
+ * populated with the current state of the local workspace.
+ */
+export function scanWorkspace(rootDir) {
+    if (!existsSync(rootDir)) {
+        return { workspaceTree: [], workspaceFiles: [] };
+    }
+    const workspaceTree = [];
+    const workspaceFiles = [];
+    let totalBytes = 0;
+    function walk(dir) {
+        if (workspaceTree.length >= MAX_TREE_ENTRIES)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir).sort();
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (workspaceTree.length >= MAX_TREE_ENTRIES)
+                break;
+            const fullPath = join(dir, entry);
+            const relPath = relative(rootDir, fullPath).replace(/\\/g, "/");
+            let st;
+            try {
+                st = statSync(fullPath);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                if (SKIP_DIRS.has(entry) || entry.startsWith("."))
+                    continue;
+                workspaceTree.push(relPath + "/");
+                walk(fullPath);
+            }
+            else if (st.isFile()) {
+                workspaceTree.push(relPath);
+                if (workspaceFiles.length < MAX_CONTENT_FILES &&
+                    totalBytes < MAX_TOTAL_BYTES &&
+                    !isBinary(relPath) &&
+                    st.size < MAX_FILE_BYTES) {
+                    try {
+                        const content = readFileSync(fullPath, "utf-8");
+                        workspaceFiles.push({
+                            path: relPath,
+                            content,
+                            language: detectLanguage(relPath),
+                        });
+                        totalBytes += st.size;
+                    }
+                    catch {
+                        // Unreadable file — include in tree but skip content.
+                    }
+                }
+            }
+        }
+    }
+    walk(rootDir);
+    return { workspaceTree, workspaceFiles };
+}
+//# sourceMappingURL=workspaceScanner.js.map

package/dist/lib/workspaceScanner.js.map

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

package/dist/types/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":""}

package/docs/python-to-ts-parity.md

@@ -0,0 +1,45 @@
+# Python to TypeScript parity checklist
+
+This checklist tracks migration parity from `../astra-code/astra_code/app.py` and `../astra-code/astra_code/tui.py`.
+
+## Core runtime parity
+
+- [x] Env config defaults: `ASTRA_BACKEND_URL`, `ASTRA_MODEL`, `ASTRA_CLIENT_ID`
+- [x] Session persistence in `~/.astra-code/session.json`
+- [x] Health check gate on startup (`/healthz`)
+- [x] Session validation via `/api/user/profile`
+- [x] Login/signup flow via `/api/auth/sign-in` and `/api/auth/sign-up`
+- [x] Session creation via `/api/sessions`
+- [x] Chat stream via `/api/agent/chat/stream` (`data:` SSE + `[DONE]`)
+
+## UI and event behavior parity
+
+- [x] Login screen with email/password
+- [x] Chat screen input + message stream
+- [x] Thinking indicator while stream active
+- [x] Slash commands: `/help`, `/new`, `/logout`, `/exit`
+- [x] `tool_start` rendering
+- [x] `tool_result` rendering
+- [x] `credits_update` rendering
+- [x] `credits_exhausted` rendering
+- [x] `error` rendering
+
+## Terminal bridge parity
+
+- [x] Handle `run_in_terminal` events
+- [x] Run local shell command in workspace context
+- [x] Post completion to `/api/agent/terminal-result`
+
+## Command mode parity
+
+- [x] `whoami`
+- [x] `sessions`
+- [x] `skills`
+- [x] `skills --suggest`
+- [x] `session-messages --session`
+- [x] `logout`
+
+## Known deltas (intentional for first cut)
+
+- Textual-specific layout/styling and widget system is replaced by Ink components.
+- Some Python-only utility commands (for workspace sandbox inspection) are not yet ported in this first TypeScript cut and can be added in follow-up milestones.

package/install.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+cd "$SCRIPT_DIR"
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Node.js is required (20+ recommended)." >&2
+  exit 1
+fi
+
+if ! command -v npm >/dev/null 2>&1; then
+  echo "npm is required." >&2
+  exit 1
+fi
+
+echo "Installing dependencies..."
+npm install
+
+echo "Building astra-code..."
+npm run build
+
+echo "Installing global astra-code bin..."
+npm install -g .
+
+if [[ ! -f "$SCRIPT_DIR/.env" && -f "$SCRIPT_DIR/.env.example" ]]; then
+  cp "$SCRIPT_DIR/.env.example" "$SCRIPT_DIR/.env"
+  echo "Created .env from .env.example"
+fi
+
+echo ""
+echo "Done. Run: astra-code"

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@astra-code/astra-ai",
+  "version": "0.1.0",
+  "description": "Astra Code terminal app built by Sean Donovan",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "astra": "dist/index.js",
+    "astra-code": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "tsx src/index.ts",
+    "dev": "tsx src/index.ts"
+  },
+  "keywords": [
+    "astra",
+    "terminal",
+    "ink",
+    "ai"
+  ],
+  "author": "Sean Donovan",
+  "license": "MIT",
+  "dependencies": {
+    "dotenv": "^17.3.1",
+    "ink": "^6.8.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "react": "^19.2.4"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@types/react": "^19.2.14",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}