@prestyj/cli 4.10.3 → 4.12.0

package/dist/core/resolve-start.d.ts

@@ -0,0 +1,29 @@
+import type { Provider } from "@prestyj/ai";
+/** A resolved startup provider + model for an AgentSession. */
+export interface ResolvedStart {
+    provider: Provider;
+    model: string;
+}
+/** The boot-time provider resolution, plus whether the user is logged in. */
+export interface ResolvedStartResult extends ResolvedStart {
+    /** False when no provider has usable credentials — the sidecar boots anyway
+     *  (logged-out, login endpoints reachable) instead of crashing. */
+    loggedIn: boolean;
+}
+/** Minimal auth surface needed to decide the startup provider (testable). */
+export interface ProviderAuthLookup {
+    hasProviderAuth(provider: string): Promise<boolean>;
+}
+/**
+ * Pick a provider/model the user is logged into, preferring the saved defaults.
+ * Mirrors the CLI's resolveActiveProvider, but NEVER throws when logged out:
+ * instead it falls back to `preferred` + its default model and reports
+ * `loggedIn: false`. This is what lets the ezcoder-app sidecar boot (and serve the
+ * login endpoints) for a fresh user with no credentials — throwing here used to
+ * kill the sidecar before it listened, making login impossible.
+ *
+ * Credentials resolve lazily at prompt time, so a logged-out boot is safe: a
+ * prompt sent before login fails cleanly through the run's error handling.
+ */
+export declare function resolveStartOrFallback(auth: ProviderAuthLookup, allProviders: readonly Provider[], preferred: Provider, savedModel: string | undefined): Promise<ResolvedStartResult>;
+//# sourceMappingURL=resolve-start.d.ts.map

package/dist/core/resolve-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-start.d.ts","sourceRoot":"","sources":["../../src/core/resolve-start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD;uEACmE;IACnE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,kBAAkB,EACxB,YAAY,EAAE,SAAS,QAAQ,EAAE,EACjC,SAAS,EAAE,QAAQ,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAuB9B"}

package/dist/core/resolve-start.js

@@ -0,0 +1,35 @@
+import { getDefaultModel, getModel } from "./model-registry.js";
+/**
+ * Pick a provider/model the user is logged into, preferring the saved defaults.
+ * Mirrors the CLI's resolveActiveProvider, but NEVER throws when logged out:
+ * instead it falls back to `preferred` + its default model and reports
+ * `loggedIn: false`. This is what lets the ezcoder-app sidecar boot (and serve the
+ * login endpoints) for a fresh user with no credentials — throwing here used to
+ * kill the sidecar before it listened, making login impossible.
+ *
+ * Credentials resolve lazily at prompt time, so a logged-out boot is safe: a
+ * prompt sent before login fails cleanly through the run's error handling.
+ */
+export async function resolveStartOrFallback(auth, allProviders, preferred, savedModel) {
+    const loggedIn = [];
+    for (const p of allProviders) {
+        if (await auth.hasProviderAuth(p))
+            loggedIn.push(p);
+    }
+    if (loggedIn.length === 0) {
+        // Logged-out fallback: boot with the preferred provider's default model so
+        // the sidecar still starts and the login flow is reachable.
+        return { provider: preferred, model: getDefaultModel(preferred).id, loggedIn: false };
+    }
+    if (loggedIn.includes(preferred)) {
+        const saved = savedModel ? getModel(savedModel) : undefined;
+        return {
+            provider: preferred,
+            model: saved?.provider === preferred ? saved.id : getDefaultModel(preferred).id,
+            loggedIn: true,
+        };
+    }
+    const provider = loggedIn[0];
+    return { provider, model: getDefaultModel(provider).id, loggedIn: true };
+}
+//# sourceMappingURL=resolve-start.js.map

package/dist/core/resolve-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-start.js","sourceRoot":"","sources":["../../src/core/resolve-start.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAoBhE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAwB,EACxB,YAAiC,EACjC,SAAmB,EACnB,UAA8B;IAE9B,MAAM,QAAQ,GAAe,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC7B,IAAI,MAAM,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,2EAA2E;QAC3E,4DAA4D;QAC5D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACxF,CAAC;IAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,KAAK,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE;YAC/E,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;IAC9B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC3E,CAAC"}

package/dist/core/resolve-start.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolve-start.test.d.ts.map

package/dist/core/resolve-start.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-start.test.d.ts","sourceRoot":"","sources":["../../src/core/resolve-start.test.ts"],"names":[],"mappings":""}

package/dist/core/resolve-start.test.js

@@ -0,0 +1,66 @@
+import { describe, it, expect } from "vitest";
+import { getDefaultModel } from "./model-registry.js";
+import { resolveStartOrFallback } from "./resolve-start.js";
+const ALL = [
+    "anthropic",
+    "xiaomi",
+    "openai",
+    "gemini",
+    "glm",
+    "moonshot",
+    "minimax",
+    "deepseek",
+    "openrouter",
+];
+/** Fake auth lookup: only the providers in `set` are "logged in". */
+function auth(...connected) {
+    const set = new Set(connected);
+    return { hasProviderAuth: async (p) => set.has(p) };
+}
+describe("resolveStartOrFallback", () => {
+    it("falls back to preferred + default model when no provider is logged in", async () => {
+        const res = await resolveStartOrFallback(auth(), ALL, "anthropic", undefined);
+        expect(res.loggedIn).toBe(false);
+        expect(res.provider).toBe("anthropic");
+        expect(res.model).toBe(getDefaultModel("anthropic").id);
+    });
+    it("honors a non-anthropic preferred provider in the logged-out fallback", async () => {
+        const res = await resolveStartOrFallback(auth(), ALL, "openai", undefined);
+        expect(res.loggedIn).toBe(false);
+        expect(res.provider).toBe("openai");
+        expect(res.model).toBe(getDefaultModel("openai").id);
+    });
+    it("uses the preferred provider's default model when logged in with no saved model", async () => {
+        const res = await resolveStartOrFallback(auth("anthropic"), ALL, "anthropic", undefined);
+        expect(res.loggedIn).toBe(true);
+        expect(res.provider).toBe("anthropic");
+        expect(res.model).toBe(getDefaultModel("anthropic").id);
+    });
+    it("keeps a saved model that belongs to the preferred provider", async () => {
+        const saved = getDefaultModel("anthropic").id;
+        const res = await resolveStartOrFallback(auth("anthropic"), ALL, "anthropic", saved);
+        expect(res.loggedIn).toBe(true);
+        expect(res.provider).toBe("anthropic");
+        expect(res.model).toBe(saved);
+    });
+    it("ignores a saved model that belongs to a different provider", async () => {
+        // Saved model is an OpenAI model but preferred is anthropic → default anthropic.
+        const otherProviderModel = getDefaultModel("openai").id;
+        const res = await resolveStartOrFallback(auth("anthropic"), ALL, "anthropic", otherProviderModel);
+        expect(res.provider).toBe("anthropic");
+        expect(res.model).toBe(getDefaultModel("anthropic").id);
+    });
+    it("falls back to the first logged-in provider when preferred is not connected", async () => {
+        // Preferred anthropic is logged out; only openai is connected.
+        const res = await resolveStartOrFallback(auth("openai"), ALL, "anthropic", undefined);
+        expect(res.loggedIn).toBe(true);
+        expect(res.provider).toBe("openai");
+        expect(res.model).toBe(getDefaultModel("openai").id);
+    });
+    it("picks the first connected provider in registry order", async () => {
+        // Both gemini and glm connected; ALL lists gemini before glm.
+        const res = await resolveStartOrFallback(auth("glm", "gemini"), ALL, "anthropic", undefined);
+        expect(res.provider).toBe("gemini");
+    });
+});
+//# sourceMappingURL=resolve-start.test.js.map

package/dist/core/resolve-start.test.js.map

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

package/dist/core/settings-manager.d.ts

@@ -24,8 +24,8 @@ declare const SettingsSchema: z.ZodObject<{
         max: "max";
     }>>;
     theme: z.ZodDefault<z.ZodEnum<{
-        light: "light";
         dark: "dark";
+        light: "light";
         "dark-ansi": "dark-ansi";
         "light-ansi": "light-ansi";
         "dark-daltonized": "dark-daltonized";
@@ -38,6 +38,10 @@ declare const SettingsSchema: z.ZodObject<{
     lspDiagnostics: z.ZodDefault<z.ZodBoolean>;
     enabledTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sessionRetentionDays: z.ZodDefault<z.ZodNumber>;
+    speedProfile: z.ZodDefault<z.ZodEnum<{
+        baseline: "baseline";
+        optimized: "optimized";
+    }>>;
 }, z.core.$strip>;
 export type Settings = z.infer<typeof SettingsSchema>;
 export declare const DEFAULT_SETTINGS: Settings;

package/dist/core/settings-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-manager.d.ts","sourceRoot":"","sources":["../../src/core/settings-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuClB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,gBAAgB,EAAE,QAY9B,CAAC;AAIF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,QAAQ,CAAC,EAAE,MAAM;IAIvB,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC;IAazB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAI5C,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9E,MAAM,IAAI,QAAQ;CAGnB"}
+{"version":3,"file":"settings-manager.d.ts","sourceRoot":"","sources":["../../src/core/settings-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2ClB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,gBAAgB,EAAE,QAa9B,CAAC;AAIF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,QAAQ,CAAC,EAAE,MAAM;IAIvB,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC;IAazB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAI5C,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9E,MAAM,IAAI,QAAQ;CAGnB"}

package/dist/core/settings-manager.js

@@ -41,6 +41,10 @@ const SettingsSchema = z.object({
     enabledTools: z.array(z.string()).optional(),
     /** Delete session transcripts older than this many days at startup. 0 disables pruning. */
     sessionRetentionDays: z.number().int().min(0).default(30),
+    /** Speed optimization profile.
+     *  - "baseline": 5-min cache TTL, no pre-warm
+     *  - "optimized": 1-h cache TTL, cache pre-warming on first prompt (default) */
+    speedProfile: z.enum(["baseline", "optimized"]).default("optimized"),
 });
 export const DEFAULT_SETTINGS = {
     autoCompact: true,
@@ -54,6 +58,7 @@ export const DEFAULT_SETTINGS = {
     autoApprovePlans: true,
     lspDiagnostics: true,
     sessionRetentionDays: 30,
+    speedProfile: "optimized",
 };
 // ── Settings Manager ───────────────────────────────────────
 export class SettingsManager {

package/dist/core/settings-manager.js.map

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

package/dist/core/shell-path.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Compute the enriched PATH (login shell ∪ current ∪ existing well-known dirs).
+ * Cached after first call. Order is preserved and duplicates removed.
+ */
+export declare function resolveEnrichedPath(currentPath?: string): Promise<string>;
+/**
+ * Enrich `process.env.PATH` in place so every later spawn/execFile (the bash
+ * tool, background tasks, LSP servers, git helpers) inherits a working PATH.
+ * Idempotent and safe to call once at startup. No-op on Windows.
+ */
+export declare function enrichProcessPath(): Promise<void>;
+//# sourceMappingURL=shell-path.d.ts.map

package/dist/core/shell-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-path.d.ts","sourceRoot":"","sources":["../../src/core/shell-path.ts"],"names":[],"mappings":"AA4HA;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,GAAE,MAA+B,GAC3C,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAUvD"}

package/dist/core/shell-path.js

@@ -0,0 +1,166 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { log } from "./logger.js";
+/**
+ * Resolve a usable PATH for shelling out to developer tools.
+ *
+ * GUI apps launched from Finder/Dock (the packaged desktop app) inherit a
+ * minimal PATH — on macOS just `/usr/bin:/bin:/usr/sbin:/sbin` — which omits
+ * Homebrew (`/opt/homebrew/bin`, `/usr/local/bin`), Cargo (`~/.cargo/bin`),
+ * version managers (nvm/asdf/pyenv), and most toolchains. A coding agent that
+ * can't find `node`, `npm`, `git`, `python3`, `rg`, `cargo`, … is useless, so
+ * we enrich the process PATH once at sidecar startup.
+ *
+ * Strategy (union, de-duped, order-preserving):
+ *   1. The user's real login-shell PATH (captures nvm/asdf/pyenv/custom dirs).
+ *   2. The current process PATH (whatever we were launched with).
+ *   3. Well-known install dirs that exist on disk (fallback when 1 fails).
+ *
+ * No-op on Windows, where GUI apps inherit a usable PATH and there's no
+ * equivalent login-shell concept.
+ */
+/** Well-known bin dirs a GUI PATH commonly omits, by platform. */
+function wellKnownBinDirs() {
+    const home = os.homedir();
+    if (process.platform === "darwin") {
+        return [
+            "/opt/homebrew/bin",
+            "/opt/homebrew/sbin",
+            "/usr/local/bin",
+            "/usr/local/sbin",
+            "/opt/local/bin", // MacPorts
+            "/opt/local/sbin",
+            path.join(home, ".local", "bin"),
+            path.join(home, ".cargo", "bin"),
+            path.join(home, "go", "bin"),
+            path.join(home, ".deno", "bin"),
+            path.join(home, ".bun", "bin"),
+        ];
+    }
+    if (process.platform === "linux") {
+        return [
+            "/usr/local/bin",
+            "/usr/local/sbin",
+            "/usr/bin",
+            "/bin",
+            "/usr/sbin",
+            "/sbin",
+            "/snap/bin",
+            path.join(home, ".local", "bin"),
+            path.join(home, ".cargo", "bin"),
+            path.join(home, "go", "bin"),
+            path.join(home, ".deno", "bin"),
+            path.join(home, ".bun", "bin"),
+        ];
+    }
+    return [];
+}
+const DELIMITER = "_GG_SHELL_ENV_DELIMITER_";
+/**
+ * Ask the user's login shell for its PATH. Best-effort: resolves to null on any
+ * error/timeout so the caller falls back to the well-known dirs. Mirrors the
+ * approach used by `shell-env`/`fix-path` (delimited echo, detached to dodge a
+ * zsh hang, oh-my-zsh auto-update disabled).
+ */
+function loginShellPath() {
+    if (process.platform === "win32")
+        return Promise.resolve(null);
+    const shell = process.env.SHELL || "/bin/zsh";
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(value);
+        };
+        try {
+            const child = spawn(shell, ["-ilc", `echo -n "${DELIMITER}"; printf "%s" "$PATH"; echo -n "${DELIMITER}"; exit`], {
+                // zsh can hang on stdin without detaching; matches shell-env's fix.
+                detached: true,
+                stdio: ["ignore", "pipe", "ignore"],
+                env: { ...process.env, DISABLE_AUTO_UPDATE: "true" },
+            });
+            let out = "";
+            child.stdout?.on("data", (d) => {
+                out += d.toString("utf-8");
+            });
+            child.once("error", () => finish(null));
+            child.once("close", () => {
+                const start = out.indexOf(DELIMITER);
+                const end = out.lastIndexOf(DELIMITER);
+                if (start === -1 || end === -1 || end <= start) {
+                    finish(null);
+                    return;
+                }
+                const value = out.slice(start + DELIMITER.length, end).trim();
+                finish(value || null);
+            });
+            // Hard cap: some shells (slow rc files) can stall; don't block startup.
+            const timer = setTimeout(() => {
+                try {
+                    if (child.pid)
+                        process.kill(-child.pid, "SIGKILL");
+                }
+                catch {
+                    child.kill("SIGKILL");
+                }
+                finish(null);
+            }, 5000);
+            timer.unref();
+        }
+        catch {
+            finish(null);
+        }
+    });
+}
+let cached;
+/**
+ * Compute the enriched PATH (login shell ∪ current ∪ existing well-known dirs).
+ * Cached after first call. Order is preserved and duplicates removed.
+ */
+export async function resolveEnrichedPath(currentPath = process.env.PATH ?? "") {
+    if (cached !== undefined)
+        return cached;
+    const parts = [];
+    const seen = new Set();
+    const add = (dir) => {
+        const d = dir.trim();
+        if (d && !seen.has(d)) {
+            seen.add(d);
+            parts.push(d);
+        }
+    };
+    const login = await loginShellPath();
+    if (login)
+        for (const d of login.split(path.delimiter))
+            add(d);
+    for (const d of currentPath.split(path.delimiter))
+        add(d);
+    // Only append fallback dirs that actually exist, so PATH stays clean.
+    for (const d of wellKnownBinDirs())
+        if (existsSync(d))
+            add(d);
+    cached = parts.join(path.delimiter);
+    return cached;
+}
+/**
+ * Enrich `process.env.PATH` in place so every later spawn/execFile (the bash
+ * tool, background tasks, LSP servers, git helpers) inherits a working PATH.
+ * Idempotent and safe to call once at startup. No-op on Windows.
+ */
+export async function enrichProcessPath() {
+    if (process.platform === "win32")
+        return;
+    const before = process.env.PATH ?? "";
+    const enriched = await resolveEnrichedPath(before);
+    if (enriched && enriched !== before) {
+        process.env.PATH = enriched;
+        log("INFO", "shell-path", "enriched PATH for tools", {
+            added: enriched.length - before.length,
+        });
+    }
+}
+//# sourceMappingURL=shell-path.js.map

package/dist/core/shell-path.js.map

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

package/dist/core/shell.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Cross-platform shell resolution for the bash tool + background process
+ * manager.
+ *
+ * The agent writes shell commands assuming POSIX `bash` semantics (`&&`, pipes,
+ * `ls`, `grep`, `$(...)`, single-quoting, …). On macOS/Linux that's just
+ * `bash`. On Windows there are three cases, and getting this wrong is the root
+ * of the "files not mounted / different environment" class of bugs:
+ *
+ *   1. Git Bash (Git for Windows) — a REAL POSIX bash that operates on the
+ *      native Windows filesystem. `D:\proj` is reachable as `/d/proj` AND the
+ *      spawned process honors the Windows `cwd`. This is what we want, so we
+ *      detect and prefer it.
+ *
+ *   2. WSL bash (`C:\Windows\System32\bash.exe`) — the Windows Subsystem for
+ *      Linux launcher. It runs commands inside a SEPARATE Linux distro whose
+ *      filesystem is not the project tree (`D:\proj` ≈ `/mnt/d/proj`, and a
+ *      raw `D:\proj` cwd lands you somewhere else entirely). Commands appear to
+ *      run "in a different project / sandbox". We deliberately SKIP it.
+ *
+ *   3. No bash at all — bare `spawn("bash", …)` fails with `spawn bash ENOENT`,
+ *      so every shell command the agent runs errors out. We fall back to
+ *      `cmd.exe` so commands can at least run (with different semantics, which
+ *      the agent is told about).
+ *
+ * The resolver is pure: filesystem + env + platform are injected so it can be
+ * unit-tested for every OS from any host.
+ */
+export interface ShellResolution {
+    /** Executable to spawn (never goes through a shell wrapper itself). */
+    file: string;
+    /** Args that run the given command string as one shell command. */
+    args: string[];
+    /** True when `file` is a cmd.exe fallback (non-POSIX semantics). */
+    isCmdFallback: boolean;
+}
+export interface ResolveShellOpts {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    /** Injected for testability; defaults to fs.existsSync. */
+    exists?: (p: string) => boolean;
+}
+/**
+ * Resolve the shell executable + args to run a single command string.
+ *
+ * `GG_BASH` env override always wins (point it at any POSIX bash, e.g. a custom
+ * Git Bash or msys2 install). Otherwise: non-Windows → `bash`; Windows → Git
+ * Bash if found, else `cmd.exe`.
+ */
+export declare function resolveShell(command: string, opts?: ResolveShellOpts): ShellResolution;
+//# sourceMappingURL=shell.d.ts.map

package/dist/core/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/core/shell.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,oEAAoE;IACpE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CACjC;AAmDD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,eAAe,CAwB1F"}

package/dist/core/shell.js

@@ -0,0 +1,82 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+/**
+ * Fixed Git-Bash install locations to probe on Windows, in priority order.
+ * These cover the official Git for Windows installer (system + per-user) plus
+ * the common 32-bit path. We NEVER include `System32\bash.exe` (WSL).
+ */
+function gitBashFixedCandidates(env) {
+    const programFiles = env.ProgramFiles ?? "C:\\Program Files";
+    const programFilesX86 = env["ProgramFiles(x86)"] ?? "C:\\Program Files (x86)";
+    const localAppData = env.LOCALAPPDATA;
+    const candidates = [
+        path.win32.join(programFiles, "Git", "bin", "bash.exe"),
+        path.win32.join(programFilesX86, "Git", "bin", "bash.exe"),
+    ];
+    if (localAppData) {
+        candidates.push(path.win32.join(localAppData, "Programs", "Git", "bin", "bash.exe"));
+    }
+    return candidates;
+}
+/**
+ * Derive Git Bash from `git.exe` on PATH: Git for Windows ships `git.exe` under
+ * `<root>\cmd` (and `<root>\bin`), with `bash.exe` at `<root>\bin\bash.exe`.
+ */
+function gitBashFromPath(env, exists) {
+    const rawPath = env.PATH ?? env.Path ?? "";
+    if (!rawPath)
+        return null;
+    // Windows PATH is always ';'-separated. (Don't use path.delimiter — it
+    // reflects the HOST OS, which breaks when this win32-only branch is exercised
+    // in cross-platform tests on a POSIX host.)
+    for (const dir of rawPath.split(";")) {
+        if (!dir)
+            continue;
+        const gitExe = path.win32.join(dir, "git.exe");
+        if (!exists(gitExe))
+            continue;
+        // <root>\cmd\git.exe or <root>\bin\git.exe → <root>\bin\bash.exe
+        const gitRoot = path.win32.dirname(path.win32.dirname(gitExe));
+        const bash = path.win32.join(gitRoot, "bin", "bash.exe");
+        if (exists(bash))
+            return bash;
+    }
+    return null;
+}
+/** Locate a usable Git Bash on Windows, or null if none is installed. */
+function findGitBash(env, exists) {
+    for (const candidate of gitBashFixedCandidates(env)) {
+        if (exists(candidate))
+            return candidate;
+    }
+    return gitBashFromPath(env, exists);
+}
+/**
+ * Resolve the shell executable + args to run a single command string.
+ *
+ * `GG_BASH` env override always wins (point it at any POSIX bash, e.g. a custom
+ * Git Bash or msys2 install). Otherwise: non-Windows → `bash`; Windows → Git
+ * Bash if found, else `cmd.exe`.
+ */
+export function resolveShell(command, opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    const env = opts.env ?? process.env;
+    const exists = opts.exists ?? existsSync;
+    // Explicit override (power users / tests): treat as a POSIX bash.
+    const override = env.GG_BASH?.trim();
+    if (override) {
+        return { file: override, args: ["-c", command], isCmdFallback: false };
+    }
+    if (platform !== "win32") {
+        return { file: "bash", args: ["-c", command], isCmdFallback: false };
+    }
+    const gitBash = findGitBash(env, exists);
+    if (gitBash) {
+        return { file: gitBash, args: ["-c", command], isCmdFallback: false };
+    }
+    // Last resort: cmd.exe. `/d` skips AutoRun, `/s` + `/c` runs the rest as a
+    // single command verbatim (correct quoting for an arbitrary command string).
+    const comspec = env.ComSpec ?? env.COMSPEC ?? "C:\\Windows\\System32\\cmd.exe";
+    return { file: comspec, args: ["/d", "/s", "/c", command], isCmdFallback: true };
+}
+//# sourceMappingURL=shell.js.map

package/dist/core/shell.js.map

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

package/dist/core/shell.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shell.test.d.ts.map

package/dist/core/shell.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.test.d.ts","sourceRoot":"","sources":["../../src/core/shell.test.ts"],"names":[],"mappings":""}