@datename/fastcode-termux 0.0.0-stage → 0.1.6-beta

package/src/lib/net.ts

@@ -0,0 +1,204 @@
+import { randomUUID } from "node:crypto";
+import type { ChatChunk } from "../types.js";
+
+export class QuotaError extends Error {
+    readonly code = "QUOTA";
+    constructor(message: string) {
+        super(message);
+        this.name = "QuotaError";
+    }
+}
+
+export class IncompleteStreamError extends Error {
+    readonly partialText: string;
+    constructor(message: string, partialText: string) {
+        super(message);
+        this.name = "IncompleteStreamError";
+        this.partialText = partialText;
+    }
+}
+
+export interface RetryRequestOptions {
+    retries?: number;
+    backoffMs?: number[];
+    retryOn?: (error: Error) => boolean;
+    signal?: AbortSignal;
+}
+
+export interface RetryStreamOptions {
+    clientRequestId?: string;
+    lastAcc?: string;
+    retries?: number;
+    backoffMs?: number[];
+    retryOn?: (error: Error) => boolean;
+    signal?: AbortSignal;
+    onRetry?: (error: Error, attempt: number) => void;
+    onReset?: () => void;
+}
+
+export interface StreamChunk extends ChatChunk {
+    reset?: boolean;
+}
+
+const DEFAULT_BACKOFF = [1000, 2000, 4000];
+const STREAM_BACKOFF = [400, 800, 1600];
+
+export function isRetryableError(error: Error): boolean {
+    const message = String(error?.message ?? error);
+    if (/\b(401|402|403|404)\b/.test(message))
+        return false;
+    if (/timeout|timed? ?out|ECONNRESET|ECONNREFUSED|ENOTFOUND|ETIMEDOUT|EPIPE|fetch failed|network|socket hang up|terminated|other side closed|stream ended before done/i.test(message))
+        return true;
+    return /\b(429|5\d\d)\b/.test(message);
+}
+
+function isQuotaError(error: Error): boolean {
+    return /\b429\b|quota|insufficient|rate limit|billing|balance/i.test(String(error?.message ?? error));
+}
+
+export async function retryRequest<T>(fn: (attempt: number) => Promise<T>, options: RetryRequestOptions = {}): Promise<T> {
+    const attempts = Math.max(1, Math.floor(options.retries ?? 3));
+    const backoff = options.backoffMs ?? DEFAULT_BACKOFF;
+    const retryOn = options.retryOn ?? isRetryableError;
+    let lastError: Error | undefined;
+    for (let attempt = 0; attempt < attempts; attempt += 1) {
+        if (options.signal?.aborted)
+            throw abortError();
+        try {
+            return await fn(attempt);
+        }
+        catch (err) {
+            lastError = toError(err);
+            if (attempt >= attempts - 1 || !retryOn(lastError))
+                break;
+            await delay(backoff[Math.min(attempt, backoff.length - 1)], options.signal);
+        }
+    }
+    if (lastError && isQuotaError(lastError))
+        throw new QuotaError(lastError.message);
+    throw lastError ?? new Error("retryRequest failed");
+}
+
+export async function* retryStream(
+    send: (options: { clientRequestId: string }) => AsyncGenerator<ChatChunk>,
+    options: RetryStreamOptions = {},
+): AsyncGenerator<StreamChunk> {
+    const clientRequestId = options.clientRequestId ?? randomUUID();
+    const attempts = Math.max(1, Math.floor(options.retries ?? 1) + 1);
+    const backoff = options.backoffMs ?? STREAM_BACKOFF;
+    const retryOn = options.retryOn ?? isRetryableError;
+    let delivered = options.lastAcc ?? "";
+    let lastError: Error | undefined;
+    for (let attempt = 0; attempt < attempts; attempt += 1) {
+        if (options.signal?.aborted)
+            throw abortError();
+        let buffering = delivered.length > 0;
+        let pending = "";
+        let doneSeen = false;
+        let usage: ChatChunk["usage"];
+        let toolCalls: ChatChunk["toolCalls"];
+        try {
+            for await (const chunk of send({ clientRequestId })) {
+                if (options.signal?.aborted)
+                    throw abortError();
+                if (chunk.usage)
+                    usage = chunk.usage;
+                if (chunk.toolCalls)
+                    toolCalls = chunk.toolCalls;
+                const delta = chunk.delta ?? "";
+                if (!delta) {
+                    if (!buffering && !chunk.done)
+                        yield chunk;
+                    if (chunk.done)
+                        doneSeen = true;
+                    continue;
+                }
+                if (buffering) {
+                    pending += delta;
+                    const matchedPrefix = delivered.startsWith(pending) || pending.startsWith(delivered);
+                    if (delivered.startsWith(pending)) {
+                        if (pending.length === delivered.length) {
+                            buffering = false;
+                            pending = "";
+                        }
+                        if (chunk.done)
+                            doneSeen = true;
+                        continue;
+                    }
+                    if (matchedPrefix) {
+                        const extra = pending.slice(delivered.length);
+                        buffering = false;
+                        pending = "";
+                        if (extra) {
+                            delivered += extra;
+                            yield { ...chunk, delta: extra, done: false };
+                        }
+                    }
+                    else {
+                        buffering = false;
+                        delivered = pending;
+                        pending = "";
+                        options.onReset?.();
+                        yield { ...chunk, delta: delivered, reset: true, done: false };
+                    }
+                    if (chunk.done)
+                        doneSeen = true;
+                    continue;
+                }
+                delivered += delta;
+                yield { ...chunk, done: false };
+                if (chunk.done)
+                    doneSeen = true;
+            }
+            if (!doneSeen)
+                throw new IncompleteStreamError("stream ended before done", delivered);
+            yield {
+                delta: "",
+                done: true,
+                ...(usage ? { usage } : {}),
+                ...(toolCalls ? { toolCalls } : {}),
+            };
+            return;
+        }
+        catch (err) {
+            lastError = toError(err);
+            if (options.signal?.aborted)
+                throw abortError();
+            if (attempt >= attempts - 1 || !retryOn(lastError)) {
+                (lastError as Error & { partialText?: string }).partialText = delivered;
+                throw lastError;
+            }
+            options.onRetry?.(lastError, attempt + 1);
+            await delay(backoff[Math.min(attempt, backoff.length - 1)], options.signal);
+        }
+    }
+    throw lastError ?? new Error("retryStream failed");
+}
+
+function delay(ms: number, signal?: AbortSignal): Promise<void> {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(abortError());
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(abortError());
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+
+function abortError(): Error {
+    const error = new Error("Aborted");
+    error.name = "AbortError";
+    return error;
+}
+
+function toError(value: unknown): Error {
+    return value instanceof Error ? value : new Error(String(value));
+}

package/src/lib/pkg.ts

@@ -0,0 +1,35 @@
+/**
+ * Read this package's package.json (name + version) from any layout.
+ *
+ * The same source runs three ways, so `import.meta.url` points at different
+ * depths; try every plausible relative path and fall back gracefully.
+ *
+ *   - tsx / dev:    src/lib/pkg.ts        -> ../../package.json
+ *   - tsc output:   dist/lib/pkg.js       -> ../../package.json
+ *   - esbuild bundle: dist/cli.js         -> ../package.json
+ */
+import { readFileSync } from "node:fs";
+
+export interface PackageMeta {
+    name: string;
+    version: string;
+}
+
+    const FALLBACK: PackageMeta = { name: "@datename/fastcode-termux", version: "0.0.0" };
+
+const CANDIDATES = ["../package.json", "../../package.json", "../../../package.json"];
+
+export function readPackageMeta(): PackageMeta {
+    for (const rel of CANDIDATES) {
+        try {
+            const meta = JSON.parse(readFileSync(new URL(rel, import.meta.url), "utf8"));
+            if (meta && typeof meta.version === "string") {
+                return { name: meta.name ?? FALLBACK.name, version: meta.version };
+            }
+        }
+        catch {
+            /* try the next candidate */
+        }
+    }
+    return FALLBACK;
+}

package/src/lib/platform.ts

@@ -0,0 +1,57 @@
+/**
+ * Cross-platform detection and small helpers.
+ *
+ * FastCode targets Termux, Linux, macOS, and Windows. Most of our
+ * environment-aware behavior keys off these flags rather than scattering
+ * `process.platform === "..."` checks across the codebase.
+ */
+import { platform, homedir } from "node:os";
+export function detectPlatform() {
+    // Termux exposes PREFIX=/data/data/com.termux/files/usr. The extra check
+    // makes us robust to users who manually export PREFIX for other reasons.
+    const prefix = process.env["PREFIX"];
+    // Termux exports TERMUX_VERSION; PREFIX=/data/data/com.termux/files/usr is a
+    // strong secondary signal. Neither requires the directory to exist yet.
+    if (process.platform === "android" ||
+        Boolean(process.env["TERMUX_VERSION"]) ||
+        (prefix && prefix.includes("com.termux"))) {
+        return "termux";
+    }
+    switch (process.platform) {
+        case "linux":
+        case "darwin":
+        case "win32":
+            return process.platform;
+        default:
+            return "other";
+    }
+}
+export const isTermux = () => detectPlatform() === "termux";
+export const isWindows = () => process.platform === "win32";
+export const isMac = () => process.platform === "darwin";
+/** Human-readable label for the status bar. */
+export function platformLabel() {
+    const p = detectPlatform();
+    switch (p) {
+        case "termux":
+            return "Termux";
+        case "linux":
+            return "Linux";
+        case "darwin":
+            return "macOS";
+        case "win32":
+            return "Windows";
+        default:
+            return platform();
+    }
+}
+export function safeHome() {
+    // os.homedir() can return undefined on weird CI containers; fall back
+    // to $HOME / %USERPROFILE% / cwd in that order.
+    const fromOs = homedir();
+    if (fromOs)
+        return fromOs;
+    return (process.env["HOME"] ??
+        process.env["USERPROFILE"] ??
+        process.cwd());
+}

package/src/lib/startup.ts

@@ -0,0 +1,25 @@
+import { resolveApiKey } from "../config/store.js";
+import { getProviderOrThrow } from "../providers/index.js";
+export function createStartupTranscript(config) {
+    const messages = [
+        `Welcome to FastCode. Provider: **${config.providerId}** · model: **${config.model}**.\n\nType **/help** to list slash commands, or just start chatting.`,
+    ];
+    const provider = getProviderOrThrow(config.providerId);
+    if (provider.authEnv.length > 0) {
+        const lookup = resolveApiKey(provider.id, config.model, provider.authEnv);
+        if (lookup.status === "unbound") {
+            messages.push(`Stored ${provider.label} key isn't bound to a model, so it won't be used. ` +
+                `Re-bind it with \`/login ${provider.id} ${config.model} <key>\` (or \`/logout ${provider.id}\` to discard it).`);
+        }
+        else if (lookup.status === "missing") {
+            messages.push(`No API key for ${provider.label} · ${config.model}. ` +
+                `Run \`/login ${provider.id} ${config.model} <key>\`, or set ${provider.authEnv[0]} (provider-wide, any model).`);
+        }
+    }
+    return messages.map((content, index) => ({
+        id: index + 1,
+        role: "system",
+        content,
+        markdown: true,
+    }));
+}

package/src/lib/uiMode.ts

@@ -0,0 +1,7 @@
+import { detectPlatform } from "./platform.js";
+export function shouldUseStableTerminalUi(platform = detectPlatform(), env = process.env) {
+    return platform === "termux" || env.FASTCODE_STABLE_UI === "1";
+}
+export function shouldUseLiveStreamingUi(platform = detectPlatform(), env = process.env) {
+    return !shouldUseStableTerminalUi(platform, env);
+}

package/src/patch/apply.ts

@@ -0,0 +1,194 @@
+import { closeSync, constants as fsConstants, fchmodSync, lstatSync, mkdirSync, openSync, renameSync, rmSync, unlinkSync, writeSync } from "node:fs";
+import { dirname } from "node:path";
+import type { PatchPlan, PlannedFile } from "./plan.js";
+
+export interface AppliedFile {
+    path: string;
+    kind: PlannedFile["kind"];
+    diff: string;
+}
+
+export interface ApplyResult {
+    ok: boolean;
+    output: string;
+    files: AppliedFile[];
+    touched: string[];
+    removed: string[];
+    warnings: string[];
+}
+
+export function applyPatchPlan(plan: PatchPlan): ApplyResult {
+    const warnings = [...plan.warnings];
+    const applied: PlannedFile[] = [];
+    const touched: string[] = [];
+    const removed: string[] = [];
+    const temps: string[] = [];
+    try {
+        for (const file of plan.files) {
+            commit(file, warnings, temps);
+            applied.push(file);
+            if (file.kind === "delete") {
+                removed.push(file.path);
+            }
+            else if (file.kind === "add") {
+                touched.push(file.path);
+            }
+            else if (file.moveTo) {
+                removed.push(file.path);
+                touched.push(file.moveTo);
+            }
+            else {
+                touched.push(file.path);
+            }
+        }
+    }
+    catch (err: any) {
+        for (const tmp of temps) {
+            try {
+                rmSync(tmp, { force: true });
+            }
+            catch {
+                // best effort
+            }
+        }
+        rollback(applied, warnings);
+        return {
+            ok: false,
+            output: `patch failed: ${err?.message ?? String(err)}; rolled back ${applied.length} file(s)`,
+            files: [],
+            touched: [],
+            removed: [],
+            warnings,
+        };
+    }
+    const files = plan.files.map((file) => ({
+        path: file.moveTo ?? file.path,
+        kind: file.kind,
+        diff: file.diff,
+    }));
+    return {
+        ok: true,
+        output: [`applied ${plan.files.length} file(s)`, ...files.map((file) => file.diff)].join("\n\n"),
+        files,
+        touched,
+        removed,
+        warnings,
+    };
+}
+
+function commit(file: PlannedFile, warnings: string[], temps: string[]): void {
+    if (file.kind === "delete") {
+        rejectSymlink(file.path);
+        unlinkSync(file.path);
+        return;
+    }
+    const target = file.moveTo ?? file.path;
+    if (file.kind === "add" || file.moveTo) {
+        if (lexists(target))
+            throw new Error(`target already exists: ${target}`);
+    }
+    rejectSymlink(target, true);
+    mkdirSync(dirname(target), { recursive: true });
+    const tmp = `${target}.fastcode-patch-${process.pid}-${Math.random().toString(36).slice(2, 8)}.tmp`;
+    temps.push(tmp);
+    const flags = fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL | (fsConstants.O_NOFOLLOW ?? 0);
+    const fd = openSync(tmp, flags, 0o600);
+    try {
+        writeSync(fd, file.newContent ?? "");
+        try {
+            fchmodSync(fd, file.origMode & 0o777);
+        }
+        catch {
+            warnings.push(`could not restore mode ${(file.origMode & 0o777).toString(8)} on ${target}; check permissions`);
+        }
+    }
+    finally {
+        closeSync(fd);
+    }
+    rejectSymlink(target, true);
+    renameSync(tmp, target);
+    const index = temps.indexOf(tmp);
+    if (index >= 0)
+        temps.splice(index, 1);
+    if (file.moveTo) {
+        try {
+            unlinkSync(file.path);
+        }
+        catch (err) {
+            try {
+                rmSync(target, { force: true });
+            }
+            catch {
+                // best effort
+            }
+            throw err;
+        }
+    }
+}
+
+function rejectSymlink(path: string, allowMissing = false): void {
+    try {
+        if (lstatSync(path).isSymbolicLink())
+            throw new Error(`refusing to write through a symbolic link: ${path}`);
+    }
+    catch (err: any) {
+        if (err?.code === "ENOENT" && allowMissing)
+            return;
+        throw err;
+    }
+}
+
+function lexists(path: string): boolean {
+    try {
+        lstatSync(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
+function rollback(applied: PlannedFile[], warnings: string[]): void {
+    for (let i = applied.length - 1; i >= 0; i -= 1) {
+        const file = applied[i];
+        try {
+            if (file.kind === "add") {
+                rmSync(file.path, { force: true });
+                continue;
+            }
+            if (file.kind === "delete") {
+                restore(file.path, file.oldContent ?? "", file.origMode);
+                continue;
+            }
+            if (file.moveTo) {
+                rmSync(file.moveTo, { force: true });
+                restore(file.path, file.oldContent ?? "", file.origMode);
+                continue;
+            }
+            restore(file.path, file.oldContent ?? "", file.origMode);
+        }
+        catch (err: any) {
+            warnings.push(`rollback failed for ${file.path}: ${err?.message ?? String(err)}`);
+        }
+    }
+}
+
+function restore(path: string, content: string, mode: number): void {
+    mkdirSync(dirname(path), { recursive: true });
+    const tmp = `${path}.fastcode-restore-${process.pid}-${Math.random().toString(36).slice(2, 8)}.tmp`;
+    const flags = fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL | (fsConstants.O_NOFOLLOW ?? 0);
+    const fd = openSync(tmp, flags, 0o600);
+    try {
+        writeSync(fd, content);
+        try {
+            fchmodSync(fd, mode & 0o777);
+        }
+        catch {
+            // best effort during rollback
+        }
+    }
+    finally {
+        closeSync(fd);
+    }
+    renameSync(tmp, path);
+}

package/src/patch/parse.ts

@@ -0,0 +1,131 @@
+export type PatchLineType = " " | "-" | "+";
+
+export interface PatchLine {
+    type: PatchLineType;
+    text: string;
+}
+
+export interface PatchHunk {
+    lines: PatchLine[];
+}
+
+export type PatchOp =
+    | { kind: "add"; path: string; lines: string[] }
+    | { kind: "delete"; path: string }
+    | { kind: "update"; path: string; hunks: PatchHunk[]; moveTo?: string };
+
+export type ParseResult = { ok: true; ops: PatchOp[] } | { ok: false; output: string };
+
+export function parsePatch(patch: string): ParseResult {
+    const lines = String(patch ?? "").split(/\r?\n/);
+    if (lines[0] !== "*** Begin Patch")
+        return fail("patch must start with *** Begin Patch");
+    const ops: PatchOp[] = [];
+    const seen = new Set<string>();
+    const claim = (path: string): string | undefined => {
+        if (!path)
+            return "empty file path in patch";
+        if (seen.has(path))
+            return `duplicate file in patch: ${path}`;
+        seen.add(path);
+        return undefined;
+    };
+    let i = 1;
+    let foundEnd = false;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (line === "*** End Patch") {
+            foundEnd = true;
+            i += 1;
+            break;
+        }
+        if (line === "" || line === undefined) {
+            i += 1;
+            continue;
+        }
+        if (line.startsWith("*** Add File: ")) {
+            const path = line.slice("*** Add File: ".length).trim();
+            const duplicate = claim(path);
+            if (duplicate)
+                return fail(duplicate);
+            i += 1;
+            const content: string[] = [];
+            while (i < lines.length && !lines[i].startsWith("*** ")) {
+                const row = lines[i];
+                if (row === "") {
+                    content.push("");
+                    i += 1;
+                    continue;
+                }
+                if (!row.startsWith("+"))
+                    return fail(`Add File body must start with '+': ${row}`);
+                content.push(row.slice(1));
+                i += 1;
+            }
+            ops.push({ kind: "add", path, lines: content });
+            continue;
+        }
+        if (line.startsWith("*** Delete File: ")) {
+            const path = line.slice("*** Delete File: ".length).trim();
+            const duplicate = claim(path);
+            if (duplicate)
+                return fail(duplicate);
+            ops.push({ kind: "delete", path });
+            i += 1;
+            continue;
+        }
+        if (line.startsWith("*** Update File: ")) {
+            const path = line.slice("*** Update File: ".length).trim();
+            const duplicate = claim(path);
+            if (duplicate)
+                return fail(duplicate);
+            i += 1;
+            let moveTo: string | undefined;
+            if (i < lines.length && lines[i].startsWith("*** Move to: ")) {
+                moveTo = lines[i].slice("*** Move to: ".length).trim();
+                const movedDuplicate = claim(moveTo);
+                if (movedDuplicate)
+                    return fail(movedDuplicate);
+                i += 1;
+            }
+            const hunks: PatchHunk[] = [];
+            let current: PatchHunk | undefined;
+            while (i < lines.length && !lines[i].startsWith("*** ")) {
+                const row = lines[i];
+                if (row === "") {
+                    i += 1;
+                    continue;
+                }
+                if (row.startsWith("@@")) {
+                    current = { lines: [] };
+                    hunks.push(current);
+                    i += 1;
+                    continue;
+                }
+                const type = row[0];
+                if (type !== " " && type !== "-" && type !== "+")
+                    return fail(`invalid hunk line (must start with ' ', '-', or '+'): ${row}`);
+                if (!current) {
+                    current = { lines: [] };
+                    hunks.push(current);
+                }
+                current.lines.push({ type: type as PatchLineType, text: row.slice(1) });
+                i += 1;
+            }
+            if (hunks.length === 0 && !moveTo)
+                return fail(`Update File has no hunks: ${path}`);
+            ops.push({ kind: "update", path, hunks, moveTo });
+            continue;
+        }
+        return fail(`unsupported patch directive: ${line}`);
+    }
+    if (!foundEnd)
+        return fail("patch must end with *** End Patch");
+    if (ops.length === 0)
+        return fail("patch contains no file operations");
+    return { ok: true, ops };
+}
+
+function fail(output: string): ParseResult {
+    return { ok: false, output };
+}