@kenkaiiii/ggcoder 4.10.1 → 4.11.0

package/dist/core/radio.js

@@ -0,0 +1,250 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { log } from "./logger.js";
+export const RADIO_STATIONS = [
+    {
+        id: "somafm-groove-salad",
+        name: "SomaFM · Groove Salad",
+        description: "Chilled downtempo, ambient grooves",
+        url: "http://ice1.somafm.com/groovesalad-128-mp3",
+    },
+    {
+        id: "somafm-drone-zone",
+        name: "SomaFM · Drone Zone",
+        description: "Atmospheric textures with minimal beats",
+        url: "http://ice1.somafm.com/dronezone-128-mp3",
+    },
+    {
+        id: "radio-paradise",
+        name: "Radio Paradise",
+        description: "Eclectic mix — rock, electronica, jazz",
+        url: "http://stream.radioparadise.com/mp3-128",
+    },
+    {
+        id: "george-fm",
+        name: "George FM",
+        description: "NZ dance + electronic",
+        url: "https://mediaworks.streamguys1.com/george_net_icy",
+    },
+];
+/**
+ * Well-known directories where streaming players get installed but which a
+ * GUI app's minimal PATH usually omits. macOS apps launched from Finder/Dock
+ * inherit only `/usr/bin:/bin:/usr/sbin:/sbin` — not Homebrew (`/opt/homebrew/bin`
+ * on Apple Silicon, `/usr/local/bin` on Intel) or MacPorts (`/opt/local/bin`),
+ * so `spawn("mpv")` ENOENTs even when mpv is installed. We search these in
+ * addition to PATH. Linux dirs cover the common package-manager prefixes.
+ */
+function extraPlayerDirs() {
+    switch (process.platform) {
+        case "darwin":
+            return ["/opt/homebrew/bin", "/usr/local/bin", "/opt/local/bin"];
+        case "linux":
+            return ["/usr/bin", "/usr/local/bin", "/bin", "/snap/bin"];
+        default:
+            return [];
+    }
+}
+/**
+ * Resolve a player command to a runnable path. Probes PATH plus the well-known
+ * install dirs and returns the first absolute hit, so GUI apps find players in
+ * Homebrew/MacPorts dirs their minimal PATH omits. Returns null when the binary
+ * isn't found anywhere we look.
+ *
+ * Windows is left to the OS: executables carry extensions (.exe/.cmd) resolved
+ * via PATHEXT, and GUI apps there inherit a usable PATH — so we return `cmd`
+ * unchanged and let spawn do its normal lookup (probing bare names here would
+ * miss `mpv.exe` and regress Windows).
+ */
+function resolvePlayerPath(cmd) {
+    // An explicit path is used as-is.
+    if (cmd.includes(path.sep))
+        return existsSync(cmd) ? cmd : null;
+    // Defer to the OS on Windows (PATHEXT handles the extension).
+    if (process.platform === "win32")
+        return cmd;
+    // 1) PATH (covers terminal launches + any inherited shell environment).
+    const pathDirs = (process.env.PATH ?? "").split(path.delimiter).filter(Boolean);
+    // 2) Well-known dirs a GUI PATH typically omits.
+    for (const dir of [...pathDirs, ...extraPlayerDirs()]) {
+        const candidate = path.join(dir, cmd);
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+/**
+ * Streaming-capable players in priority order. Each gets its quietest flag
+ * combination — radio runs in the background, we don't want stdout/stderr
+ * spam. Stdio is also redirected to "ignore" at spawn time.
+ */
+const PLAYERS = [
+    { cmd: "mpv", args: (u) => ["--really-quiet", "--no-video", "--no-terminal", u] },
+    { cmd: "ffplay", args: (u) => ["-nodisp", "-autoexit", "-loglevel", "quiet", u] },
+    { cmd: "mpg123", args: (u) => ["-q", u] },
+    { cmd: "cvlc", args: (u) => ["--play-and-exit", "--quiet", u] },
+];
+let currentChild = null;
+let currentStationId = null;
+export function getCurrentStation() {
+    return currentStationId;
+}
+/**
+ * Stop whatever's currently playing. Idempotent — safe to call when nothing
+ * is playing. Sends SIGTERM (graceful), child cleans up the audio device.
+ */
+export function stopRadio() {
+    if (!currentChild)
+        return;
+    try {
+        // Detached children sit in their own process group on POSIX; kill the
+        // whole group so any helper threads/forks die too. On Windows there's no
+        // process group concept — kill() targets the child only.
+        if (process.platform !== "win32" && currentChild.pid) {
+            try {
+                process.kill(-currentChild.pid, "SIGTERM");
+            }
+            catch {
+                currentChild.kill("SIGTERM");
+            }
+        }
+        else {
+            currentChild.kill("SIGTERM");
+        }
+    }
+    catch {
+        // Already exited — nothing to do.
+    }
+    currentChild = null;
+    currentStationId = null;
+    log("INFO", "radio", "stopped");
+}
+/**
+ * On WSL2, native Linux audio binaries can't reach the Windows audio device
+ * through WSLg's bridge in any useful way for streaming — detect WSL and route
+ * through the Windows host instead.
+ */
+function isWsl() {
+    if (process.platform !== "linux")
+        return false;
+    return !!process.env.WSL_DISTRO_NAME || existsSync("/proc/sys/fs/binfmt_misc/WSLInterop");
+}
+/**
+ * Stream a station through powershell.exe + WPF MediaPlayer on the Windows host
+ * instead of a Linux binary. Returns the ChildProcess or null on spawn failure.
+ * The URL is allowlist-checked, scheme-enforced, and passed via env (never
+ * interpolated into the -Command string).
+ */
+function tryPlayOnWindowsHost(station) {
+    const allowedUrls = new Set(RADIO_STATIONS.map((s) => s.url));
+    if (!allowedUrls.has(station.url))
+        return null;
+    if (!/^https?:\/\//i.test(station.url))
+        return null;
+    const psScript = [
+        "Add-Type -AssemblyName presentationCore;",
+        "Add-Type -AssemblyName WindowsBase;",
+        "$p = New-Object System.Windows.Media.MediaPlayer;",
+        "$p.Open([uri]$env:GG_RADIO_URL);",
+        "$p.Play();",
+        "[System.Windows.Threading.Dispatcher]::Run();",
+    ].join(" ");
+    try {
+        return spawn("powershell.exe", ["-NoProfile", "-WindowStyle", "Hidden", "-Command", psScript], {
+            detached: true,
+            stdio: "ignore",
+            env: {
+                ...process.env,
+                GG_RADIO_URL: station.url,
+                WSLENV: (process.env.WSLENV ? process.env.WSLENV + ":" : "") + "GG_RADIO_URL",
+            },
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Spawn a streaming player for the given station. If one is already playing,
+ * it's killed first. Returns ok=false with a hint if no compatible player is
+ * installed — caller should surface the error to the user.
+ */
+export function playRadio(stationId) {
+    const station = RADIO_STATIONS.find((s) => s.id === stationId);
+    if (!station)
+        return { ok: false, error: `Unknown station: ${stationId}` };
+    // Always stop the previous stream before starting a new one.
+    stopRadio();
+    if (isWsl()) {
+        const child = tryPlayOnWindowsHost(station);
+        if (child) {
+            let errored = false;
+            child.once("error", () => {
+                errored = true;
+            });
+            if (child.pid && !errored) {
+                currentChild = child;
+                currentStationId = stationId;
+                log("INFO", "radio", "playing", {
+                    station: station.id,
+                    player: "powershell.exe (wsl→host)",
+                    url: station.url,
+                });
+                child.unref();
+                return { ok: true };
+            }
+        }
+    }
+    for (const player of PLAYERS) {
+        // Resolve to an absolute path first so we find players in Homebrew/MacPorts
+        // dirs that a GUI app's minimal PATH omits. Skip when not installed.
+        const bin = resolvePlayerPath(player.cmd);
+        if (!bin)
+            continue;
+        try {
+            const child = spawn(bin, player.args(station.url), {
+                detached: process.platform !== "win32",
+                stdio: "ignore",
+            });
+            let errored = false;
+            child.once("error", () => {
+                errored = true;
+            });
+            if (child.pid && !errored) {
+                currentChild = child;
+                currentStationId = stationId;
+                log("INFO", "radio", "playing", {
+                    station: station.id,
+                    player: player.cmd,
+                    url: station.url,
+                });
+                child.unref();
+                return { ok: true };
+            }
+        }
+        catch {
+            // ENOENT or permission — try the next player.
+        }
+    }
+    log("WARN", "radio", "no compatible player found", { platform: process.platform });
+    return { ok: false, error: buildInstallHint() };
+}
+/**
+ * Platform-specific one-line install hint so the user can copy-paste rather
+ * than reading generic suggestions.
+ */
+function buildInstallHint() {
+    const base = "Radio needs a streaming player. Install one of: mpv (recommended), ffplay, mpg123, or vlc.";
+    switch (process.platform) {
+        case "darwin":
+            return `${base} On macOS: \`brew install mpv\` (or \`brew install ffmpeg\` for ffplay).`;
+        case "linux":
+            return `${base} On Linux (Debian/Ubuntu): \`sudo apt install mpv\`. Fedora: \`sudo dnf install mpv\`. Arch: \`sudo pacman -S mpv\`.`;
+        case "win32":
+            return `${base} On Windows: \`winget install mpv.mpv\` (or download from https://mpv.io).`;
+        default:
+            return `${base} See https://mpv.io for platform installation instructions.`;
+    }
+}
+//# sourceMappingURL=radio.js.map

package/dist/core/radio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio.js","sourceRoot":"","sources":["../../src/core/radio.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";

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,CAAC,WAAW,GAAE,MAA+B,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBvG;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/telegram-config.d.ts

@@ -0,0 +1,21 @@
+export interface TelegramConfig {
+    botToken: string;
+    userId: number;
+}
+/** Read the saved Telegram config, or null when unset/incomplete. */
+export declare function loadTelegramConfig(): Promise<TelegramConfig | null>;
+/** Persist the Telegram config with owner-only permissions (0600). */
+export declare function saveTelegramConfig(config: TelegramConfig): Promise<void>;
+/** Rough bot-token shape check (`123456789:ABCdef...`). */
+export declare function isValidBotTokenFormat(token: string): boolean;
+export interface BotVerification {
+    ok: boolean;
+    username?: string;
+    firstName?: string;
+}
+/**
+ * Verify a bot token against Telegram's getMe. Returns `{ ok: false }` when the
+ * token is malformed or Telegram rejects it (never throws on a bad token).
+ */
+export declare function verifyBotToken(botToken: string): Promise<BotVerification>;
+//# sourceMappingURL=telegram-config.d.ts.map

package/dist/core/telegram-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-config.d.ts","sourceRoot":"","sources":["../../src/core/telegram-config.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CASzE;AAED,sEAAsE;AACtE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9E;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAa/E"}

package/dist/core/telegram-config.js

@@ -0,0 +1,52 @@
+/**
+ * Shared Telegram bot configuration: the `~/.gg/telegram.json` store (bot token
+ * + authorized user id) plus bot-token verification. Used by the CLI
+ * (`ggcoder telegram` / `ggcoder serve`) and the desktop app sidecar so both
+ * read/write the same file with the same validation.
+ */
+import fs from "node:fs/promises";
+import { ensureAppDirs, getAppPaths } from "../config.js";
+/** Read the saved Telegram config, or null when unset/incomplete. */
+export async function loadTelegramConfig() {
+    try {
+        const raw = await fs.readFile(getAppPaths().telegramFile, "utf-8");
+        const data = JSON.parse(raw);
+        if (data.botToken && data.userId)
+            return data;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Persist the Telegram config with owner-only permissions (0600). */
+export async function saveTelegramConfig(config) {
+    const paths = await ensureAppDirs();
+    await fs.writeFile(paths.telegramFile, JSON.stringify(config, null, 2), {
+        encoding: "utf-8",
+        mode: 0o600,
+    });
+}
+/** Rough bot-token shape check (`123456789:ABCdef...`). */
+export function isValidBotTokenFormat(token) {
+    return /^\d+:[A-Za-z0-9_-]+$/.test(token);
+}
+/**
+ * Verify a bot token against Telegram's getMe. Returns `{ ok: false }` when the
+ * token is malformed or Telegram rejects it (never throws on a bad token).
+ */
+export async function verifyBotToken(botToken) {
+    if (!isValidBotTokenFormat(botToken))
+        return { ok: false };
+    try {
+        const res = await fetch(`https://api.telegram.org/bot${botToken}/getMe`, { method: "POST" });
+        const data = (await res.json());
+        if (!data.ok || !data.result)
+            return { ok: false };
+        return { ok: true, username: data.result.username, firstName: data.result.first_name };
+    }
+    catch {
+        return { ok: false };
+    }
+}
+//# sourceMappingURL=telegram-config.js.map

package/dist/core/telegram-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-config.js","sourceRoot":"","sources":["../../src/core/telegram-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO1D,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;QAC/C,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAsB;IAC7D,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;IACpC,MAAM,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QACtE,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAQD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,+BAA+B,QAAQ,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7F,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACnD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export { EventBus, AgentSession, SessionManager, SettingsManager, AuthStorage, S
 export { runPrintMode } from "./modes/index.js";
 export { renderApp } from "./ui/render.js";
 export { APP_NAME, VERSION, getAppPaths, ensureAppDirs } from "./config.js";
+export { discoverProjects, listRecentSessions, type DiscoveredProject, type ProjectSource, type RecentSession, } from "./core/project-discovery.js";
 export type { CliConfig, SessionHeader as LegacySessionHeader, SessionMessageEntry, SessionEntry as LegacySessionEntry, SessionInfo as LegacySessionInfo, } from "./types.js";
 export type { AgentSessionOptions, AgentSessionState, BusEventMap, ContextWindowOptions, ModelInfo, Settings, SlashCommand, SlashCommandContext, Skill, Extension, ExtensionContext, CompactionResult, SessionEntry, SessionInfo, SessionHeader, } from "./core/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACZ,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,cAAc,GACf,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,MAAM,EACN,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,aAAa,EACb,OAAO,EACP,cAAc,EACd,cAAc,EACd,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5E,YAAY,EACV,SAAS,EACT,aAAa,IAAI,mBAAmB,EACpC,mBAAmB,EACnB,YAAY,IAAI,kBAAkB,EAClC,WAAW,IAAI,iBAAiB,GACjC,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,mBAAmB,EACnB,KAAK,EACL,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,GACd,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACZ,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,cAAc,GACf,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,MAAM,EACN,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,aAAa,EACb,OAAO,EACP,cAAc,EACd,cAAc,EACd,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,6BAA6B,CAAC;AAGrC,YAAY,EACV,SAAS,EACT,aAAa,IAAI,mBAAmB,EACpC,mBAAmB,EACnB,YAAY,IAAI,kBAAkB,EAClC,WAAW,IAAI,iBAAiB,GACjC,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,mBAAmB,EACnB,KAAK,EACL,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -12,4 +12,6 @@ export { runPrintMode } from "./modes/index.js";
 export { renderApp } from "./ui/render.js";
 // Config
 export { APP_NAME, VERSION, getAppPaths, ensureAppDirs } from "./config.js";
+// Project discovery (shared with gg-boss + gg-app sidecar)
+export { discoverProjects, listRecentSessions, } from "./core/project-discovery.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACZ,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,kCAAkC;AAClC,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO;AACP,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,MAAM,EACN,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,aAAa,EACb,OAAO,EACP,cAAc,EACd,cAAc,EACd,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,WAAW;AACX,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,SAAS;AACT,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACZ,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,kCAAkC;AAClC,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO;AACP,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,MAAM,EACN,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,aAAa,EACb,OAAO,EACP,cAAc,EACd,cAAc,EACd,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,WAAW;AACX,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,SAAS;AACT,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5E,2DAA2D;AAC3D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GAInB,MAAM,6BAA6B,CAAC"}

package/dist/modes/serve-mode.d.ts

@@ -9,6 +9,17 @@ export interface ServeModeOptions {
         botToken: string;
         userId: number;
     };
+    /**
+     * Embedded mode (desktop app): skip the terminal banner/console output and
+     * don't register process signal handlers — the host process owns those. The
+     * bot polls in the background and the caller stops it via the returned
+     * controller. Defaults to false (the CLI's blocking, banner-printing flow).
+     */
+    embedded?: boolean;
+}
+/** Handle for an embedded serve session: stop polling + dispose all sessions. */
+export interface ServeController {
+    stop: () => Promise<void>;
 }
 /**
  * Serve mode: run ggcoder controlled via Telegram.
@@ -17,5 +28,18 @@ export interface ServeModeOptions {
  * - Groups → linked projects via /link <path>
  * - Each chat gets its own AgentSession, tools, context
  */
+/**
+ * Build a serve session: wire the Telegram bot to per-chat AgentSessions and
+ * start long-polling in the background. Returns a controller to stop it.
+ *
+ * Shared by the CLI (`ggcoder serve`, via {@link runServeMode}) and the desktop
+ * app sidecar. In `embedded` mode it stays silent and leaves process-signal
+ * handling to the host.
+ */
+export declare function startServeMode(options: ServeModeOptions): Promise<ServeController>;
+/**
+ * CLI serve flow (`ggcoder serve`): prints the banner, starts the bot, wires
+ * SIGINT/SIGTERM to a graceful shutdown, then blocks until the process exits.
+ */
 export declare function runServeMode(options: ServeModeOptions): Promise<void>;
 //# sourceMappingURL=serve-mode.d.ts.map

package/dist/modes/serve-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve-mode.d.ts","sourceRoot":"","sources":["../../src/modes/serve-mode.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAehE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AA2ED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAurB3E"}
+{"version":3,"file":"serve-mode.d.ts","sourceRoot":"","sources":["../../src/modes/serve-mode.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAgBhE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AA2ED;;;;;;GAMG;AACH;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA+rBxF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3E"}