@prestyj/cli 4.10.3 → 4.11.4

package/dist/app-sidecar.js

@@ -0,0 +1,1407 @@
+/**
+ * ezcoder-app sidecar — bridges the full ezcoder AgentSession to the Tauri webview
+ * over plain HTTP + Server-Sent Events (zero browser-side dependencies).
+ *
+ * Transport:
+ *   GET  /state    → { provider, model, cwd, ready }
+ *   GET  /events   → text/event-stream of forwarded agent + session events
+ *   POST /prompt   → { text } ; runs AgentSession.prompt(text)
+ *   POST /cancel   → aborts the in-flight run
+ *
+ * The agent spine (gg-ai → gg-agent → gg-core) and every tool are reused
+ * unchanged via AgentSession — this file is only a network seam.
+ */
+import http from "node:http";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { parseArgs } from "node:util";
+import { runJsonMode } from "./modes/json-mode.js";
+import { AgentSession } from "./core/agent-session.js";
+import { AuthStorage } from "./core/auth-storage.js";
+import { MOONSHOT_OAUTH_KEY } from "@prestyj/core";
+import { loginAnthropic } from "./core/oauth/anthropic.js";
+import { loginOpenAI } from "./core/oauth/openai.js";
+import { loginGemini } from "./core/oauth/gemini.js";
+import { loginKimi } from "./core/oauth/kimi.js";
+import { AUTH_PROVIDERS } from "./core/auth-providers.js";
+import { ensureAppDirs, loadSavedSettings } from "./config.js";
+import { SettingsManager } from "./core/settings-manager.js";
+import { getModel, getMaxThinkingLevel, getContextWindow, MODELS } from "./core/model-registry.js";
+import { resolveStartOrFallback } from "./core/resolve-start.js";
+import { getGitBranch, isGitRepo } from "./utils/git.js";
+import { getNextThinkingLevel, getSupportedThinkingLevels, isThinkingLevelSupported, } from "./core/thinking-level.js";
+import { PROMPT_COMMANDS } from "./core/prompt-commands.js";
+import { loadCustomCommands } from "./core/custom-commands.js";
+import { discoverProjects, listRecentSessions } from "./core/project-discovery.js";
+import { loadTasksSync, saveTasksSync, getNextPendingTask, markTaskInProgress, } from "./core/tasks-store.js";
+import { initLogger, log } from "./core/logger.js";
+import { RADIO_STATIONS, getCurrentStation, playRadio, stopRadio } from "./core/radio.js";
+import { enrichProcessPath } from "./core/shell-path.js";
+import { startServeMode } from "./modes/serve-mode.js";
+import { loadTelegramConfig, saveTelegramConfig, verifyBotToken } from "./core/telegram-config.js";
+const ALL_PROVIDERS = [
+    "anthropic",
+    "xiaomi",
+    "openai",
+    "gemini",
+    "glm",
+    "moonshot",
+    "minimax",
+    "deepseek",
+    "openrouter",
+];
+function appSettingsFile() {
+    return path.join(os.homedir(), ".ezcoder", "ezcoder-app.json");
+}
+function defaultProjectsRoot() {
+    return path.join(os.homedir(), "ez-projects");
+}
+/** Normalize a project cwd to a stable settings key so trailing slashes /
+ *  relative segments collapse — the same project always maps to one entry. */
+function projectModelKey(cwd) {
+    return path.resolve(cwd);
+}
+async function loadAppSettings() {
+    try {
+        const raw = JSON.parse(await fs.readFile(appSettingsFile(), "utf-8"));
+        return {
+            projectsRoot: typeof raw.projectsRoot === "string" && raw.projectsRoot.trim()
+                ? raw.projectsRoot
+                : defaultProjectsRoot(),
+            // Preserve the per-project map verbatim (validated + written by the
+            // model/thinking handlers below).
+            projectModels: raw.projectModels && typeof raw.projectModels === "object" ? raw.projectModels : undefined,
+        };
+    }
+    catch {
+        return { projectsRoot: defaultProjectsRoot() };
+    }
+}
+async function saveAppSettings(settings) {
+    await fs.mkdir(path.dirname(appSettingsFile()), { recursive: true });
+    await fs.writeFile(appSettingsFile(), JSON.stringify(settings, null, 2), "utf-8");
+}
+/** Read this project's persisted model/thinking prefs, if any. */
+async function loadProjectModelPrefs(cwd) {
+    const s = await loadAppSettings();
+    return s.projectModels?.[projectModelKey(cwd)];
+}
+/** Persist this project's model/thinking prefs via read-modify-write so the rest
+ *  of the settings file (projectsRoot, other projects' entries) is preserved. */
+async function saveProjectModelPrefs(cwd, prefs) {
+    const s = await loadAppSettings();
+    const key = projectModelKey(cwd);
+    s.projectModels = { ...(s.projectModels ?? {}), [key]: prefs };
+    await saveAppSettings(s);
+}
+/**
+ * Persist the active model selection to ~/.ezcoder/settings.json so it survives app
+ * restarts. Mirrors the CLI's handleModelSelect persistence (App.tsx).
+ */
+async function persistModelSelection(settingsFile, provider, model) {
+    try {
+        const sm = new SettingsManager(settingsFile);
+        await sm.load();
+        await sm.set("defaultProvider", provider);
+        await sm.set("defaultModel", model);
+    }
+    catch (err) {
+        log("WARN", "app-sidecar", "failed to persist model selection", { err: String(err) });
+    }
+}
+/**
+ * Persist the thinking level to ~/.ezcoder/settings.json so it survives app restarts.
+ * Mirrors the CLI's handleToggleThinking persistence (App.tsx).
+ */
+async function persistThinkingLevel(settingsFile, level) {
+    try {
+        const sm = new SettingsManager(settingsFile);
+        await sm.load();
+        await sm.set("thinkingEnabled", !!level);
+        if (level)
+            await sm.set("thinkingLevel", level);
+    }
+    catch (err) {
+        log("WARN", "app-sidecar", "failed to persist thinking level", { err: String(err) });
+    }
+}
+/** Validate a project folder name: lowercase letters, digits, dashes only. */
+function isValidProjectName(name) {
+    return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name);
+}
+async function prepareAttachments(cwd, attachments) {
+    const dir = path.join(cwd, ".ezcoder", "uploads");
+    await fs.mkdir(dir, { recursive: true }).catch(() => { });
+    const out = [];
+    for (const a of attachments) {
+        // Sanitize the filename and prefix with a short timestamp to avoid clobber.
+        const safe = a.name.replace(/[^\w.-]+/g, "_").slice(-80) || "file";
+        const fileName = `${Date.now().toString(36)}-${safe}`;
+        const filePath = path.join(dir, fileName);
+        try {
+            await fs.writeFile(filePath, Buffer.from(a.data, "base64"));
+            out.push({ ...a, path: filePath });
+        }
+        catch {
+            out.push({ ...a });
+        }
+    }
+    return out;
+}
+const FILE_SEARCH_LIMIT = 20;
+/** Score a candidate path against a lowercased query. Higher is better; a
+ *  negative score means "no match". Basename hits beat path hits; prefix beats
+ *  substring; shorter paths break ties. */
+function scoreFile(relPath, name, query) {
+    const lcPath = relPath.toLowerCase();
+    const lcName = name.toLowerCase();
+    let score = -1;
+    if (lcName === query)
+        score = 1000;
+    else if (lcName.startsWith(query))
+        score = 800;
+    else if (lcName.includes(query))
+        score = 600;
+    else if (lcPath.startsWith(query))
+        score = 400;
+    else if (lcPath.includes(query))
+        score = 200;
+    else if (subsequenceMatch(lcPath, query))
+        score = 100;
+    if (score < 0)
+        return -1;
+    // Prefer shorter paths (closer to root, less nesting) on equal match class.
+    return score - relPath.length * 0.1;
+}
+/** True when every char of `needle` appears in `haystack` in order (fuzzy). */
+function subsequenceMatch(haystack, needle) {
+    let i = 0;
+    for (const ch of haystack) {
+        if (ch === needle[i])
+            i++;
+        if (i === needle.length)
+            return true;
+    }
+    return needle.length === 0;
+}
+async function searchProjectFiles(cwd, rawQuery) {
+    const fg = await import("fast-glob");
+    const ignore = await import("ignore");
+    const query = rawQuery.trim().toLowerCase();
+    let gitignore = [];
+    try {
+        const content = await fs.readFile(path.join(cwd, ".gitignore"), "utf-8");
+        gitignore = content
+            .split("\n")
+            .map((l) => l.trim())
+            .filter((l) => l && !l.startsWith("#"));
+    }
+    catch {
+        // No .gitignore — nothing extra to ignore.
+    }
+    const ig = ignore.default().add(gitignore);
+    // `stats: true` gives mtime without a second stat pass, so the empty-query
+    // "recent files" path is a single walk.
+    const entries = await fg.default("**/*", {
+        cwd,
+        dot: false,
+        onlyFiles: true,
+        ignore: ["**/node_modules/**", "**/.git/**", "**/.ezcoder/**"],
+        suppressErrors: true,
+        followSymbolicLinks: false,
+        stats: true,
+    });
+    const files = entries.filter((e) => !ig.ignores(e.path));
+    if (!query) {
+        return files
+            .sort((a, b) => (b.stats?.mtimeMs ?? 0) - (a.stats?.mtimeMs ?? 0))
+            .slice(0, FILE_SEARCH_LIMIT)
+            .map((e) => ({ path: e.path, name: path.posix.basename(e.path) }));
+    }
+    const scored = [];
+    for (const e of files) {
+        const name = path.posix.basename(e.path);
+        const score = scoreFile(e.path, name, query);
+        if (score >= 0)
+            scored.push({ hit: { path: e.path, name }, score });
+    }
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, FILE_SEARCH_LIMIT).map((s) => s.hit);
+}
+/**
+ * Detect whether a restored user message is actually an injected self-correction
+ * hook prompt, by its distinctive opening phrase. Returns the hook kind so the
+ * webview can render the short notice line instead of the full prompt body.
+ */
+function detectHookKind(text) {
+    const t = text.trimStart();
+    if (t.startsWith("Ideal? Review the actual work"))
+        return "ideal";
+    if (t.startsWith("Stuck? You've repeated essentially"))
+        return "loop_break";
+    if (t.startsWith("Re-ground. The conversation was just compacted"))
+        return "regrounding";
+    return null;
+}
+// Separator AgentSession.prompt() inserts between a command's prompt body and
+// the user's trailing args. Must stay in sync with the expansion there.
+const COMMAND_ARGS_SEP = "\n\n## User Instructions\n\n";
+/**
+ * Reverse a prompt-template command's expansion. When a `/name` command runs,
+ * the agent persists the FULL expanded prompt body as the user message — so on
+ * resume the raw body would render instead of the short `/name` chip the user
+ * saw live. Given the candidate commands (built-in + custom) and a restored
+ * message body, recover the original `/name [args]` invocation. Returns null
+ * when the text isn't a known command body (an ordinary user message).
+ */
+function detectPromptCommand(text, candidates) {
+    for (const c of candidates) {
+        if (!c.prompt)
+            continue;
+        if (text === c.prompt)
+            return `/${c.name}`;
+        if (text.startsWith(c.prompt + COMMAND_ARGS_SEP)) {
+            const args = text.slice(c.prompt.length + COMMAND_ARGS_SEP.length).trim();
+            return args ? `/${c.name} ${args}` : `/${c.name}`;
+        }
+    }
+    return null;
+}
+/**
+ * Sub-agents spawn the ezcoder CLI in JSON mode to run a delegated task. In the
+ * packaged desktop app the only runnable entry is THIS bundle (there's no
+ * sibling `cli.js`), so the subagent tool ends up spawning the sidecar itself.
+ * Without this guard that would boot a second HTTP server, emit no NDJSON, and
+ * hang until the 10-minute hard timeout. So when invoked with `--json`, behave
+ * exactly like `ezcoder --json …`: stream the sub-agent run as NDJSON and exit,
+ * never starting the HTTP/SSE server. Mirrors the `values.json` branch in cli.ts.
+ */
+async function runJsonModeIfRequested() {
+    if (!process.argv.includes("--json"))
+        return false;
+    const { values, positionals } = parseArgs({
+        args: process.argv.slice(2),
+        options: {
+            json: { type: "boolean" },
+            provider: { type: "string" },
+            model: { type: "string" },
+            "max-turns": { type: "string" },
+            "system-prompt": { type: "string" },
+            "prompt-cache-key": { type: "string" },
+        },
+        allowPositionals: true,
+        strict: true,
+    });
+    const maxTurnsRaw = values["max-turns"];
+    await runJsonMode({
+        message: positionals[0] ?? "",
+        provider: (values.provider ?? "anthropic"),
+        model: values.model ?? "claude-opus-4-8",
+        cwd: process.cwd(),
+        systemPrompt: values["system-prompt"],
+        maxTurns: maxTurnsRaw ? parseInt(maxTurnsRaw, 10) : undefined,
+        promptCacheKey: values["prompt-cache-key"],
+    }).catch((err) => {
+        process.stderr.write((err instanceof Error ? err.message : String(err)) + "\n");
+        process.exit(1);
+    });
+    return true;
+}
+async function main() {
+    // Sub-agent JSON-mode dispatch must win before any sidecar/server setup.
+    if (await runJsonModeIfRequested())
+        return;
+    const cwd = process.env.GG_APP_CWD ?? process.cwd();
+    // Default to an ephemeral port (0) so concurrent/orphaned instances never
+    // collide on a fixed port. The actual port is reported via the
+    // GG_APP_LISTENING handshake and consumed by the shell.
+    const port = Number(process.env.GG_APP_PORT ?? 0);
+    const host = "127.0.0.1";
+    const paths = await ensureAppDirs();
+    // Own log file so the app sidecar never clobbers the interactive CLI's
+    // ~/.ezcoder/debug.log (initLogger truncates on each start).
+    const sidecarLog = path.join(paths.agentDir, "ezcoder-app-sidecar.log");
+    initLogger(sidecarLog);
+    // The packaged desktop app launches from Finder/Dock with a minimal PATH that
+    // omits Homebrew/Cargo/version-manager dirs, so the agent can't find node,
+    // git, python, rg, etc. Enrich process.env.PATH from the login shell once,
+    // before anything spawns (bash tool, background tasks, LSP, git helpers all
+    // inherit it). Best-effort — never blocks startup beyond its internal cap.
+    await enrichProcessPath();
+    const auth = new AuthStorage(paths.authFile);
+    await auth.load();
+    const saved = loadSavedSettings(paths.settingsFile);
+    // Per-project model/thinking prefs win over the shared global settings.json:
+    // each window (one project cwd) restores its own selection instead of every
+    // window reading the same single global slot that the last writer clobbered
+    // (the old bug — switching models in one window reset every other window).
+    const projectPrefs = await loadProjectModelPrefs(cwd);
+    const preferred = projectPrefs?.provider ?? saved.provider ?? "anthropic";
+    const savedModel = projectPrefs?.model ?? saved.model;
+    // Boot-tolerant: when no provider is configured this returns a logged-out
+    // fallback instead of throwing, so the sidecar still listens and the login
+    // endpoints are reachable for a fresh user (throwing here used to kill the
+    // sidecar before server.listen, making first-time login impossible).
+    const { provider, model, loggedIn } = await resolveStartOrFallback(auth, ALL_PROVIDERS, preferred, savedModel);
+    if (!loggedIn) {
+        log("WARN", "app-sidecar", "no provider configured — booting logged-out for login", {
+            fallbackProvider: provider,
+        });
+    }
+    // Per-project thinking prefs win over the global settings.json fallback.
+    const thinkEnabled = projectPrefs?.thinkingEnabled ?? saved.thinkingEnabled;
+    const thinkingLevel = thinkEnabled
+        ? (projectPrefs?.thinkingLevel ?? saved.thinkingLevel ?? getMaxThinkingLevel(model))
+        : undefined;
+    // ── SSE fan-out (declared before the session so plan callbacks can use it) ─
+    const clients = new Set();
+    let clientSeq = 0;
+    function broadcast(type, data) {
+        const frame = `data: ${JSON.stringify({ type, data })}\n\n`;
+        for (const c of clients)
+            c.res.write(frame);
+    }
+    // When the shell respawns this sidecar for a chosen project, it passes the
+    // session file path to resume; empty/unset starts a fresh session.
+    const resumeSessionPath = process.env.GG_APP_SESSION_ID || undefined;
+    let abort = new AbortController();
+    const session = new AgentSession({
+        provider,
+        model,
+        cwd,
+        thinkingLevel,
+        sessionId: resumeSessionPath,
+        signal: abort.signal,
+        // Plan mode: the agent's enter_plan/exit_plan tools drive these. We flip
+        // session plan state (rebuilds the system prompt + enforces read-only
+        // tools) and surface the transition to the webview.
+        onEnterPlan: async (reason) => {
+            await session.setPlanMode(true);
+            broadcast("plan_enter", { reason: reason ?? "" });
+        },
+        onExitPlan: async (planPath) => {
+            await session.setPlanMode(false);
+            // Surface the plan's path + markdown so the webview can show the review
+            // modal (Accept / Feedback / Reject). Best-effort content read.
+            let content;
+            try {
+                content = await fs.readFile(planPath, "utf-8");
+            }
+            catch {
+                content = "";
+            }
+            broadcast("plan_exit", { planPath, content });
+            return "Plan submitted for user review. Wait for the user to approve, reject, or dismiss it before implementing.";
+        },
+    });
+    await session.initialize();
+    log("INFO", "app-sidecar", "session ready", { provider, model, cwd });
+    // Footer extras (context window, git branch, background tasks). The git
+    // branch is resolved once at startup and refreshed lazily; the context
+    // window follows the active model.
+    let gitBranch = await getGitBranch(cwd).catch(() => null);
+    let gitIsRepo = await isGitRepo(cwd).catch(() => false);
+    function currentContextWindow() {
+        const st = session.getState();
+        return getContextWindow(st.model, { provider: st.provider });
+    }
+    // Shared shape merged into /state + the SSE `ready` frame so the footer can
+    // render context %, branch, and tasks immediately on connect.
+    function footerExtras() {
+        return {
+            contextWindow: currentContextWindow(),
+            gitBranch,
+            isGitRepo: gitIsRepo,
+            tasks: session.listBackgroundProcesses(),
+        };
+    }
+    // Forward every relevant bus event to the webview.
+    session.eventBus.on("text_delta", (d) => broadcast("text_delta", d));
+    session.eventBus.on("thinking_delta", (d) => broadcast("thinking_delta", d));
+    session.eventBus.on("tool_call_start", (d) => broadcast("tool_call_start", d));
+    session.eventBus.on("tool_call_update", (d) => broadcast("tool_call_update", d));
+    session.eventBus.on("tool_call_end", (d) => broadcast("tool_call_end", d));
+    session.eventBus.on("turn_end", (d) => broadcast("turn_end", d));
+    session.eventBus.on("agent_done", (d) => broadcast("agent_done", d));
+    session.eventBus.on("error", (d) => broadcast("error", { message: d.error instanceof Error ? d.error.message : String(d.error) }));
+    session.eventBus.on("model_change", (d) => broadcast("model_change", d));
+    session.eventBus.on("hook", (d) => broadcast("hook", d));
+    session.eventBus.on("compaction_start", (d) => broadcast("compaction_start", d));
+    session.eventBus.on("compaction_end", (d) => broadcast("compaction_end", d));
+    let running = false;
+    let titleGenerated = false;
+    // ── Telegram serve (remote control via Telegram) ───────────
+    // A single embedded serve session lives in this sidecar process. Only the main
+    // window's home screen exposes the controls, so there's one bot per app.
+    let serveController = null;
+    // Resumed session: if it already has a conversation, generate its title now so
+    // the title bar shows it immediately on load (not just after the next prompt).
+    {
+        const hasHistory = session
+            .getMessages()
+            .some((m) => m.role === "user" || m.role === "assistant");
+        if (hasHistory) {
+            titleGenerated = true;
+            void session.generateTitle().then((title) => {
+                if (title)
+                    broadcast("session_title", { title });
+            });
+        }
+    }
+    // Core run lifecycle shared by /prompt and the task runner: flips `running`,
+    // brackets the run with run_start/run_end, refreshes the footer extras, and
+    // generates the session title once. `label` is the text shown live with the
+    // run_start frame.
+    async function runAgent(label, run) {
+        running = true;
+        broadcast("run_start", { text: label });
+        try {
+            await run();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            broadcast("error", { message });
+            log("ERROR", "app-sidecar", "run failed", { message });
+        }
+        finally {
+            running = false;
+            // A run may have switched branches (git checkout) or spawned/finished
+            // background tasks — refresh the footer extras once it settles.
+            gitBranch = await getGitBranch(cwd).catch(() => gitBranch);
+            gitIsRepo = await isGitRepo(cwd).catch(() => gitIsRepo);
+            broadcast("run_end", {});
+            // Queue drains into the run as steering, so it's empty by run_end —
+            // sync the webview indicator.
+            broadcast("queued", { count: session.getQueuedCount() });
+            broadcast("extras", footerExtras());
+            // Generate a session title once, after the first run, for the title bar
+            // (best-effort, async — don't block the response).
+            if (!titleGenerated) {
+                titleGenerated = true;
+                void session.generateTitle().then((title) => {
+                    if (title)
+                        broadcast("session_title", { title });
+                });
+            }
+        }
+    }
+    // ── Task runner (project task list → sessions) ──────────────
+    // Mirrors the CLI's task flow: each task runs in its OWN fresh session, with a
+    // completion hint instructing the agent to mark the task done via the tasks
+    // tool. Run-all advances to the next pending task after each run finishes.
+    let taskRunAll = false;
+    async function runTaskById(taskId) {
+        const task = loadTasksSync(cwd).find((t) => t.id === taskId || t.id.startsWith(taskId));
+        if (!task)
+            return false;
+        // Fresh session per task so one task's context never bleeds into the next.
+        await session.newSession();
+        titleGenerated = false;
+        broadcast("session_reset", {});
+        markTaskInProgress(cwd, task.id);
+        broadcast("tasks_list", { tasks: loadTasksSync(cwd) });
+        broadcast("task_start", { id: task.id, title: task.title });
+        const shortId = task.id.slice(0, 8);
+        const completionHint = `\n\n---\nWhen you have fully completed this task, call the tasks tool to mark it done:\n` +
+            `tasks({ action: "done", id: "${shortId}" })`;
+        await runAgent(task.title, () => session.prompt(task.prompt + completionHint));
+        // The agent typically marks the task done via the tasks tool during the run;
+        // push the refreshed list so the webview's task modal reflects it.
+        broadcast("tasks_list", { tasks: loadTasksSync(cwd) });
+        return true;
+    }
+    async function runTasks(startId, all) {
+        taskRunAll = all;
+        let currentId = startId ?? getNextPendingTask(cwd)?.id ?? null;
+        while (currentId) {
+            const ran = await runTaskById(currentId);
+            if (!ran || !taskRunAll)
+                break;
+            const next = getNextPendingTask(cwd);
+            currentId = next ? next.id : null;
+            // Brief pause between tasks (mirrors the CLI cadence).
+            if (currentId)
+                await new Promise((resolve) => setTimeout(resolve, 500));
+        }
+        taskRunAll = false;
+        broadcast("tasks_run_done", {});
+    }
+    // ── Provider auth (login) bridge ───────────────────────────
+    // OAuth login functions are interactive (open a URL, sometimes prompt for a
+    // pasted code). We run one at a time and surface every step over SSE so the
+    // webview can open the URL and collect a code via a modal. `pendingCode`
+    // resolves when the webview POSTs /auth/oauth/code.
+    let oauthInFlight = false;
+    let pendingCode = null;
+    function authCallbacks() {
+        return {
+            onOpenUrl: (url) => broadcast("auth_url", { url }),
+            onStatus: (message) => broadcast("auth_status", { message }),
+            onPromptCode: (message) => new Promise((resolve) => {
+                pendingCode = resolve;
+                broadcast("auth_need_code", { message });
+            }),
+        };
+    }
+    async function authStatusPayload() {
+        const providers = await Promise.all(AUTH_PROVIDERS.map(async (p) => ({
+            ...p,
+            connected: await auth.hasProviderAuth(p.value),
+        })));
+        return { providers };
+    }
+    // Background tasks have no event source (the bash tool just spawns them), so
+    // poll the process manager and broadcast only when the snapshot changes. This
+    // keeps the webview footer live without a busy render loop. Adaptive cadence:
+    // tasks can only change while a run is active (the bash tool spawns them), so
+    // poll fast (1500ms) while running or while tasks exist, and back off to
+    // 5000ms when fully idle — fewer wakeups per idle window.
+    let lastTasksJson = "[]";
+    let tasksPoll;
+    let tasksPollStopped = false;
+    const scheduleTasksPoll = (delay) => {
+        if (tasksPollStopped)
+            return;
+        tasksPoll = setTimeout(() => {
+            const tasks = session.listBackgroundProcesses();
+            const next = JSON.stringify(tasks);
+            if (next !== lastTasksJson) {
+                lastTasksJson = next;
+                broadcast("tasks", { tasks });
+            }
+            const active = running || tasks.length > 0;
+            scheduleTasksPoll(active ? 1500 : 5000);
+        }, delay);
+        tasksPoll.unref?.();
+    };
+    scheduleTasksPoll(1500);
+    function readBody(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            req.on("data", (c) => chunks.push(c));
+            req.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+            req.on("error", reject);
+        });
+    }
+    function json(res, status, body) {
+        const payload = JSON.stringify(body);
+        res.writeHead(status, {
+            "content-type": "application/json",
+            "access-control-allow-origin": "*",
+        });
+        res.end(payload);
+    }
+    const server = http.createServer((req, res) => {
+        const url = req.url ?? "/";
+        const method = req.method ?? "GET";
+        // CORS preflight — the webview origin differs from 127.0.0.1.
+        if (method === "OPTIONS") {
+            res.writeHead(204, {
+                "access-control-allow-origin": "*",
+                "access-control-allow-methods": "GET, POST, OPTIONS",
+                "access-control-allow-headers": "content-type",
+            });
+            res.end();
+            return;
+        }
+        if (method === "GET" && url === "/state") {
+            const st = session.getState();
+            json(res, 200, {
+                ...st,
+                running,
+                ready: true,
+                thinkingLevel: session.getThinkingLevel() ?? null,
+                supportedThinkingLevels: getSupportedThinkingLevels(st.provider, st.model),
+                supportsVideo: getModel(st.model)?.supportsVideo ?? false,
+                ...footerExtras(),
+            });
+            return;
+        }
+        if (method === "GET" && url === "/events") {
+            res.writeHead(200, {
+                "content-type": "text/event-stream",
+                "cache-control": "no-cache",
+                connection: "keep-alive",
+                "access-control-allow-origin": "*",
+            });
+            res.write(`retry: 1000\n\n`);
+            const client = { id: ++clientSeq, res };
+            clients.add(client);
+            const st = session.getState();
+            res.write(`data: ${JSON.stringify({
+                type: "ready",
+                data: {
+                    ...st,
+                    running,
+                    thinkingLevel: session.getThinkingLevel() ?? null,
+                    supportedThinkingLevels: getSupportedThinkingLevels(st.provider, st.model),
+                    supportsVideo: getModel(st.model)?.supportsVideo ?? false,
+                    ...footerExtras(),
+                },
+            })}\n\n`);
+            const keepAlive = setInterval(() => res.write(`: ping\n\n`), 15000);
+            req.on("close", () => {
+                clearInterval(keepAlive);
+                clients.delete(client);
+            });
+            return;
+        }
+        if (method === "GET" && url === "/settings") {
+            // `configured` is true only when the user explicitly saved a projects root
+            // (the ezcoder-app.json file exists with a value) — not when we fall back to the
+            // default. The home screen gates "Your Projects" on this.
+            void (async () => {
+                const s = await loadAppSettings();
+                let configured;
+                try {
+                    const raw = JSON.parse(await fs.readFile(appSettingsFile(), "utf-8"));
+                    configured = typeof raw.projectsRoot === "string" && raw.projectsRoot.trim().length > 0;
+                }
+                catch {
+                    configured = false;
+                }
+                // Only projectsRoot + configured flag are webview-facing; the
+                // per-project model map is internal persistence, never shipped out.
+                json(res, 200, { projectsRoot: s.projectsRoot, configured });
+            })();
+            return;
+        }
+        if (method === "POST" && url === "/settings") {
+            void readBody(req).then(async (raw) => {
+                let projectsRoot;
+                try {
+                    projectsRoot = JSON.parse(raw).projectsRoot ?? "";
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                if (!projectsRoot.trim()) {
+                    json(res, 400, { error: "projectsRoot is required" });
+                    return;
+                }
+                // Read-modify-write so the per-project model map survives a projectsRoot
+                // change (a naive overwrite would drop every window's saved model).
+                const s = await loadAppSettings();
+                s.projectsRoot = projectsRoot;
+                await saveAppSettings(s);
+                json(res, 200, { projectsRoot });
+            });
+            return;
+        }
+        if (method === "POST" && url === "/create-project") {
+            void readBody(req).then(async (raw) => {
+                let name;
+                try {
+                    name = JSON.parse(raw).name ?? "";
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                name = name.trim();
+                if (!isValidProjectName(name)) {
+                    json(res, 400, {
+                        error: "Project name must be lowercase letters, digits, and dashes (e.g. my-project).",
+                    });
+                    return;
+                }
+                const { projectsRoot } = await loadAppSettings();
+                const dir = path.join(projectsRoot, name);
+                try {
+                    // Refuse to clobber an existing directory.
+                    const exists = await fs
+                        .stat(dir)
+                        .then(() => true)
+                        .catch(() => false);
+                    if (exists) {
+                        json(res, 409, { error: `A folder named "${name}" already exists.` });
+                        return;
+                    }
+                    await fs.mkdir(dir, { recursive: true });
+                    json(res, 200, { path: dir });
+                }
+                catch (err) {
+                    json(res, 500, { error: err instanceof Error ? err.message : String(err) });
+                }
+            });
+            return;
+        }
+        if (method === "GET" && url === "/projects") {
+            // Scan ezcoder + Claude Code + Codex session stores for known projects.
+            void discoverProjects()
+                .then((projects) => json(res, 200, { projects }))
+                .catch((err) => {
+                log("ERROR", "app-sidecar", "discoverProjects failed", {
+                    message: err instanceof Error ? err.message : String(err),
+                });
+                json(res, 200, { projects: [] });
+            });
+            return;
+        }
+        if (method === "GET" && url.startsWith("/sessions")) {
+            const target = new URL(url, `http://${host}`).searchParams.get("cwd");
+            if (!target) {
+                json(res, 400, { error: "missing cwd query param" });
+                return;
+            }
+            void listRecentSessions(target, 5)
+                .then((sessions) => json(res, 200, { sessions }))
+                .catch(() => json(res, 200, { sessions: [] }));
+            return;
+        }
+        if (method === "GET" && url.startsWith("/files")) {
+            const q = new URL(url, `http://${host}`).searchParams.get("q") ?? "";
+            void searchProjectFiles(cwd, q)
+                .then((files) => json(res, 200, { files }))
+                .catch((err) => {
+                log("ERROR", "app-sidecar", "searchProjectFiles failed", {
+                    message: err instanceof Error ? err.message : String(err),
+                });
+                json(res, 200, { files: [] });
+            });
+            return;
+        }
+        if (method === "GET" && url === "/history") {
+            // Flatten the resumed conversation into the webview's transcript shape:
+            // user + assistant TEXT only (tools live in the live panel, never the
+            // transcript; system + tool-result messages are omitted). Self-correction
+            // hook prompts (injected as user messages) are tagged with their `hook`
+            // kind so the webview renders the short "Hook engaged" line, not the raw
+            // prompt body — matching how they appear live.
+            //
+            // Prompt-template commands persist their FULL expanded body as the user
+            // message, so on resume we reverse the expansion (built-in + custom
+            // candidates) back to the short `/name [args]` chip the user saw live.
+            void (async () => {
+                const commandCandidates = [...PROMPT_COMMANDS, ...(await loadCustomCommands(cwd))];
+                const history = session
+                    .getMessages()
+                    .filter((m) => m.role === "user" || m.role === "assistant")
+                    .map((m) => {
+                    // `m.content` is a union of differently-typed arrays (user vs
+                    // assistant parts), so a type-predicate filter won't narrow cleanly.
+                    // A structural `"text" in c` check extracts text from any text-bearing
+                    // part regardless of the surrounding union.
+                    const text = typeof m.content === "string"
+                        ? m.content
+                        : m.content
+                            .map((c) => c.type === "text" && "text" in c && typeof c.text === "string" ? c.text : "")
+                            .join("");
+                    // Reconstruct image attachments as data URLs so they re-render on
+                    // resume — the webview only ever saw the live SSE stream, and the
+                    // persisted message holds the base64 bytes. Without this, attached
+                    // images vanish when returning to a session.
+                    const images = typeof m.content === "string"
+                        ? []
+                        : m.content.flatMap((c) => c.type === "image" ? [`data:${c.mediaType};base64,${c.data}`] : []);
+                    const hook = m.role === "user" ? detectHookKind(text) : null;
+                    // A compacted session persists its summary as a user message prefixed
+                    // with this marker. Tag it so the webview renders the quiet "Compacted
+                    // context" notice instead of dumping the full summary body.
+                    const compacted = m.role === "user" && !hook && text.startsWith("[Previous conversation summary]");
+                    // Recover a `/name [args]` command invocation from its expanded body
+                    // (skip messages already claimed as hooks or compaction summaries).
+                    const command = m.role === "user" && !hook && !compacted
+                        ? detectPromptCommand(text, commandCandidates)
+                        : null;
+                    return {
+                        role: m.role,
+                        text: command ?? text,
+                        images,
+                        hook,
+                        command: command !== null,
+                        compacted,
+                    };
+                })
+                    // Keep messages with text OR images — an image-only user turn has empty
+                    // text but must still appear.
+                    .filter((m) => m.text.trim().length > 0 || m.images.length > 0);
+                json(res, 200, { history });
+            })();
+            return;
+        }
+        if (method === "GET" && url === "/commands") {
+            // Workflow commands with agent functionality: built-in prompt templates +
+            // the user's own `.ezcoder/commands/*.md`. UI commands (model/quit/etc.) are
+            // handled webview-side and intentionally excluded.
+            void (async () => {
+                const builtins = PROMPT_COMMANDS.map((c) => ({
+                    name: c.name,
+                    aliases: c.aliases,
+                    description: c.description,
+                    source: "built-in",
+                }));
+                const custom = (await loadCustomCommands(cwd))
+                    // A custom command can't shadow a built-in name.
+                    .filter((c) => !PROMPT_COMMANDS.some((b) => b.name === c.name))
+                    .map((c) => ({
+                    name: c.name,
+                    aliases: [],
+                    description: c.description,
+                    source: "custom",
+                }));
+                json(res, 200, { commands: [...builtins, ...custom] });
+            })();
+            return;
+        }
+        if (method === "POST" && url === "/prompt") {
+            void readBody(req).then(async (raw) => {
+                let text;
+                let attachments;
+                try {
+                    const body = JSON.parse(raw);
+                    text = body.text ?? "";
+                    attachments = Array.isArray(body.attachments) ? body.attachments : [];
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                if (!text.trim() && attachments.length === 0) {
+                    json(res, 400, { error: "empty prompt" });
+                    return;
+                }
+                if (running) {
+                    // Queue text prompts as mid-run steering (mirrors the CLI). Attachments
+                    // aren't supported mid-run — reject those so the user resends after.
+                    if (attachments.length > 0) {
+                        json(res, 409, { error: "cannot attach files while the agent is running" });
+                        return;
+                    }
+                    const count = session.queueMessage(text);
+                    broadcast("queued", { count });
+                    json(res, 202, { queued: true, count });
+                    return;
+                }
+                json(res, 202, { accepted: true });
+                await runAgent(text, async () => {
+                    if (attachments.length > 0) {
+                        // Persist each attachment under .ezcoder/uploads so files are inspectable
+                        // by the agent's tools, then prompt with the media as native blocks.
+                        const prepared = await prepareAttachments(cwd, attachments);
+                        await session.promptWithAttachments(text, prepared);
+                    }
+                    else {
+                        // Pass the raw text straight through. AgentSession.prompt() is the
+                        // single source of truth for slash-command expansion (built-in +
+                        // `.ezcoder/commands/*.md` custom), so the agent gets the right body
+                        // while the webview keeps showing the short `/name`.
+                        await session.prompt(text);
+                    }
+                });
+            });
+            return;
+        }
+        if (method === "GET" && url === "/tasks") {
+            json(res, 200, { tasks: loadTasksSync(cwd) });
+            return;
+        }
+        // ── Radio ─────────────────────────────────────────────────
+        // Playback runs in THIS sidecar process, which is unique per window, so a
+        // station only plays in the window that started it.
+        if (method === "GET" && url === "/radio") {
+            json(res, 200, { stations: RADIO_STATIONS, current: getCurrentStation() });
+            return;
+        }
+        if (method === "POST" && url === "/radio") {
+            void readBody(req).then((raw) => {
+                let station;
+                try {
+                    station = JSON.parse(raw).station ?? "";
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                if (!station || station === "off") {
+                    stopRadio();
+                    json(res, 200, { current: null });
+                    return;
+                }
+                const result = playRadio(station);
+                if (!result.ok) {
+                    json(res, 400, { error: result.error ?? "Radio failed to start." });
+                    return;
+                }
+                json(res, 200, { current: getCurrentStation() });
+            });
+            return;
+        }
+        if (method === "POST" && url === "/tasks/run") {
+            void readBody(req).then((raw) => {
+                let id;
+                let all;
+                try {
+                    const body = JSON.parse(raw);
+                    id = body.id ?? null;
+                    all = Boolean(body.all);
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                if (running) {
+                    json(res, 409, { error: "cannot run a task while the agent is running" });
+                    return;
+                }
+                json(res, 202, { accepted: true });
+                void runTasks(id, all);
+            });
+            return;
+        }
+        if (method === "POST" && url === "/tasks/delete") {
+            void readBody(req).then((raw) => {
+                let id;
+                try {
+                    id = JSON.parse(raw).id ?? "";
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                if (!id.trim()) {
+                    json(res, 400, { error: "missing task id" });
+                    return;
+                }
+                const remaining = loadTasksSync(cwd).filter((t) => t.id !== id && !t.id.startsWith(id));
+                saveTasksSync(cwd, remaining);
+                json(res, 200, { tasks: remaining });
+            });
+            return;
+        }
+        if (method === "GET" && url === "/models") {
+            void (async () => {
+                const loggedIn = [];
+                for (const p of ALL_PROVIDERS) {
+                    if (await auth.hasProviderAuth(p))
+                        loggedIn.push(p);
+                }
+                // Just the names, grouped by provider in registry order — the UI shows
+                // a clean multi-column list of model ids.
+                const models = MODELS.filter((m) => loggedIn.includes(m.provider)).map((m) => ({
+                    id: m.id,
+                    name: m.name,
+                    provider: m.provider,
+                }));
+                json(res, 200, { models });
+            })();
+            return;
+        }
+        if (method === "POST" && url === "/model") {
+            void readBody(req).then(async (raw) => {
+                let modelId;
+                try {
+                    modelId = JSON.parse(raw).model ?? "";
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                const target = getModel(modelId);
+                if (!target) {
+                    json(res, 404, { error: `unknown model: ${modelId}` });
+                    return;
+                }
+                if (running) {
+                    json(res, 409, { error: "cannot switch model while running" });
+                    return;
+                }
+                await session.switchModel(target.provider, target.id);
+                // Clamp the reasoning level to what the new model supports (mirrors the
+                // CLI): keep thinking on at the first supported tier if it was on but
+                // the prior level is unsupported here; leave it off if it was off.
+                const prevLevel = session.getThinkingLevel();
+                if (prevLevel && !isThinkingLevelSupported(target.provider, target.id, prevLevel)) {
+                    session.setThinkingLevel(getNextThinkingLevel(target.provider, target.id, undefined));
+                }
+                // Persist per-project so THIS window/project restores its own model on
+                // restart (not the single global slot every window shares). Keep the
+                // global write too as a "last used" fallback for never-opened projects
+                // and so the CLI stays in sync.
+                await saveProjectModelPrefs(cwd, {
+                    provider: target.provider,
+                    model: target.id,
+                    thinkingEnabled: !!session.getThinkingLevel(),
+                    thinkingLevel: session.getThinkingLevel() ?? undefined,
+                });
+                await persistModelSelection(paths.settingsFile, target.provider, target.id);
+                await persistThinkingLevel(paths.settingsFile, session.getThinkingLevel());
+                const payload = {
+                    thinkingLevel: session.getThinkingLevel() ?? null,
+                    supportedThinkingLevels: getSupportedThinkingLevels(target.provider, target.id),
+                };
+                // model_change is emitted by switchModel; follow with thinking_change so
+                // the footer toggle reflects the new model's supported levels.
+                broadcast("thinking_change", payload);
+                // The new model usually has a different context window — push extras so
+                // the footer's context meter rescales immediately.
+                broadcast("extras", footerExtras());
+                json(res, 200, { provider: target.provider, model: target.id, ...payload });
+            });
+            return;
+        }
+        if (method === "POST" && url === "/kill") {
+            void readBody(req).then(async (raw) => {
+                let id;
+                try {
+                    id = JSON.parse(raw).id ?? "";
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                if (!id.trim()) {
+                    json(res, 400, { error: "missing task id" });
+                    return;
+                }
+                const message = await session.killBackgroundProcess(id);
+                // Push the updated task list right away rather than waiting for the poll.
+                broadcast("tasks", { tasks: session.listBackgroundProcesses() });
+                json(res, 200, { message });
+            });
+            return;
+        }
+        if (method === "POST" && url === "/thinking") {
+            const st = session.getState();
+            const next = getNextThinkingLevel(st.provider, st.model, session.getThinkingLevel());
+            session.setThinkingLevel(next);
+            // Persist per-project so THIS window restores its thinking state on
+            // restart; keep the global write as a fallback (mirrors the CLI).
+            void saveProjectModelPrefs(cwd, {
+                provider: st.provider,
+                model: st.model,
+                thinkingEnabled: !!next,
+                thinkingLevel: next ?? undefined,
+            }).then(() => persistThinkingLevel(paths.settingsFile, next));
+            const payload = {
+                thinkingLevel: next ?? null,
+                supportedThinkingLevels: getSupportedThinkingLevels(st.provider, st.model),
+            };
+            broadcast("thinking_change", payload);
+            json(res, 200, payload);
+            return;
+        }
+        if (method === "POST" && url === "/cancel") {
+            abort.abort();
+            abort = new AbortController();
+            session.setSignal(abort.signal);
+            running = false;
+            // Stop a run-all sweep so the next pending task isn't auto-started.
+            taskRunAll = false;
+            // Drop any queued steering and return it so the webview can restore it to
+            // the composer.
+            const drained = session.drainQueue();
+            broadcast("run_end", { cancelled: true });
+            broadcast("queued", { count: 0 });
+            json(res, 200, { cancelled: true, drained });
+            return;
+        }
+        if (method === "POST" && url === "/new-session") {
+            if (running) {
+                json(res, 409, { error: "cannot start a new session while running" });
+                return;
+            }
+            void session
+                .newSession()
+                .then(() => {
+                broadcast("session_reset", {});
+                json(res, 200, { ok: true });
+            })
+                .catch((err) => {
+                json(res, 500, { error: err instanceof Error ? err.message : String(err) });
+            });
+            return;
+        }
+        // Bake an approved plan into the system prompt before the implementation
+        // prompt runs, so the model is told to emit `[DONE:n]` markers and the
+        // webview's plan-progress widget advances (mirrors the CLI accept flow).
+        if (method === "POST" && url === "/plan/accept") {
+            void readBody(req).then(async (raw) => {
+                let planPath;
+                try {
+                    planPath = JSON.parse(raw).planPath || undefined;
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                try {
+                    await session.setApprovedPlan(planPath);
+                    json(res, 200, { ok: true });
+                }
+                catch (err) {
+                    json(res, 500, { error: err instanceof Error ? err.message : String(err) });
+                }
+            });
+            return;
+        }
+        // ── Provider auth (login) ───────────────────────────────
+        if (method === "GET" && url === "/auth/status") {
+            void authStatusPayload().then((payload) => json(res, 200, payload));
+            return;
+        }
+        if (method === "POST" && url === "/auth/apikey") {
+            void readBody(req).then(async (raw) => {
+                let provider = "";
+                let key;
+                try {
+                    const body = JSON.parse(raw);
+                    provider = body.provider ?? "";
+                    key = (body.key ?? "").trim();
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                const meta = AUTH_PROVIDERS.find((p) => p.value === provider);
+                if (!meta || !meta.methods.includes("apikey")) {
+                    json(res, 400, { error: "provider does not support API key auth" });
+                    return;
+                }
+                if (!key) {
+                    json(res, 400, { error: "API key is required" });
+                    return;
+                }
+                const creds = {
+                    accessToken: key,
+                    refreshToken: "",
+                    expiresAt: Date.now() + 365 * 24 * 60 * 60 * 1000 * 100, // ~100y
+                    ...(meta.apiKeyBaseUrl ? { baseUrl: meta.apiKeyBaseUrl } : {}),
+                };
+                await auth.setCredentials(provider, creds);
+                broadcast("auth_done", { provider });
+                json(res, 200, { ok: true });
+            });
+            return;
+        }
+        if (method === "POST" && url === "/auth/oauth/start") {
+            void readBody(req).then((raw) => {
+                let provider = "";
+                try {
+                    provider = JSON.parse(raw).provider ?? "";
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                const meta = AUTH_PROVIDERS.find((p) => p.value === provider);
+                if (!meta || !meta.methods.includes("oauth")) {
+                    json(res, 400, { error: "provider does not support OAuth" });
+                    return;
+                }
+                if (oauthInFlight) {
+                    json(res, 409, { error: "a login is already in progress" });
+                    return;
+                }
+                oauthInFlight = true;
+                json(res, 202, { accepted: true });
+                void (async () => {
+                    const cb = authCallbacks();
+                    try {
+                        let creds;
+                        let storageKey = provider;
+                        if (provider === "anthropic")
+                            creds = await loginAnthropic(cb);
+                        else if (provider === "openai")
+                            creds = await loginOpenAI(cb);
+                        else if (provider === "gemini")
+                            creds = await loginGemini(cb);
+                        else if (provider === "moonshot") {
+                            creds = await loginKimi(cb);
+                            storageKey = MOONSHOT_OAUTH_KEY;
+                        }
+                        else {
+                            throw new Error(`OAuth not implemented for ${provider}`);
+                        }
+                        await auth.setCredentials(storageKey, creds);
+                        broadcast("auth_done", { provider });
+                    }
+                    catch (err) {
+                        broadcast("auth_error", {
+                            provider,
+                            message: err instanceof Error ? err.message : String(err),
+                        });
+                    }
+                    finally {
+                        oauthInFlight = false;
+                        pendingCode = null;
+                    }
+                })();
+            });
+            return;
+        }
+        if (method === "POST" && url === "/auth/oauth/code") {
+            void readBody(req).then((raw) => {
+                let code;
+                try {
+                    code = JSON.parse(raw).code ?? "";
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                if (!pendingCode) {
+                    json(res, 409, { error: "no login is awaiting a code" });
+                    return;
+                }
+                pendingCode(code.trim());
+                pendingCode = null;
+                json(res, 200, { ok: true });
+            });
+            return;
+        }
+        if (method === "POST" && url === "/auth/logout") {
+            void readBody(req).then(async (raw) => {
+                let provider;
+                try {
+                    provider = JSON.parse(raw).provider ?? "";
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                await auth.clearCredentials(provider);
+                // Moonshot's OAuth credential lives under a distinct key — clear both so
+                // "disconnect" fully removes Kimi OAuth and the API key.
+                if (provider === "moonshot")
+                    await auth.clearCredentials(MOONSHOT_OAUTH_KEY);
+                broadcast("auth_done", { provider });
+                json(res, 200, { ok: true });
+            });
+            return;
+        }
+        // ── Telegram config (mirrors `ezcoder telegram`) ─────────
+        if (method === "GET" && url === "/telegram") {
+            void loadTelegramConfig().then((cfg) => {
+                if (!cfg) {
+                    json(res, 200, { configured: false });
+                    return;
+                }
+                // Never return the raw token to the webview — a short masked preview is
+                // enough to show "already set".
+                const t = cfg.botToken;
+                const tokenPreview = t.length > 14 ? `${t.slice(0, 10)}\u2026${t.slice(-4)}` : "set";
+                json(res, 200, { configured: true, userId: cfg.userId, tokenPreview });
+            });
+            return;
+        }
+        if (method === "POST" && url === "/telegram") {
+            void readBody(req).then(async (raw) => {
+                let botTokenInput;
+                let userIdInput;
+                try {
+                    const body = JSON.parse(raw);
+                    botTokenInput = (body.botToken ?? "").trim();
+                    userIdInput = String(body.userId ?? "").trim();
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                // Keep the existing token when the field is left blank (the webview shows
+                // a masked preview, not the real token).
+                const existing = await loadTelegramConfig();
+                const botToken = botTokenInput || existing?.botToken || "";
+                if (!botToken) {
+                    json(res, 400, { error: "Bot token is required." });
+                    return;
+                }
+                const userId = userIdInput ? parseInt(userIdInput, 10) : existing?.userId;
+                if (!userId || Number.isNaN(userId)) {
+                    json(res, 400, { error: "A numeric Telegram user ID is required." });
+                    return;
+                }
+                const verified = await verifyBotToken(botToken);
+                if (!verified.ok) {
+                    json(res, 400, { error: "Invalid bot token — Telegram rejected it." });
+                    return;
+                }
+                await saveTelegramConfig({ botToken, userId });
+                json(res, 200, { ok: true, userId, username: verified.username ?? null });
+            });
+            return;
+        }
+        // ── Serve lifecycle (mirrors `ezcoder serve`) ───────────
+        if (method === "GET" && url === "/serve") {
+            void loadTelegramConfig().then((cfg) => json(res, 200, { running: serveController !== null, configured: cfg !== null }));
+            return;
+        }
+        if (method === "POST" && url === "/serve/start") {
+            void (async () => {
+                if (serveController) {
+                    json(res, 200, { running: true });
+                    return;
+                }
+                const cfg = await loadTelegramConfig();
+                if (!cfg) {
+                    json(res, 400, { error: "Telegram isn't set up yet. Open Serve settings first." });
+                    return;
+                }
+                const st = session.getState();
+                try {
+                    serveController = await startServeMode({
+                        provider: st.provider,
+                        model: st.model,
+                        cwd,
+                        version: "app",
+                        thinkingLevel: session.getThinkingLevel() ?? undefined,
+                        telegram: { botToken: cfg.botToken, userId: cfg.userId },
+                        embedded: true,
+                    });
+                    broadcast("serve_change", { running: true });
+                    log("INFO", "app-sidecar", "serve started", { userId: cfg.userId });
+                    json(res, 200, { running: true });
+                }
+                catch (err) {
+                    serveController = null;
+                    json(res, 400, { error: err instanceof Error ? err.message : String(err) });
+                }
+            })();
+            return;
+        }
+        if (method === "POST" && url === "/serve/stop") {
+            void (async () => {
+                if (serveController) {
+                    await serveController.stop().catch(() => { });
+                    serveController = null;
+                    broadcast("serve_change", { running: false });
+                    log("INFO", "app-sidecar", "serve stopped");
+                }
+                json(res, 200, { running: false });
+            })();
+            return;
+        }
+        json(res, 404, { error: "not found" });
+    });
+    server.listen(port, host, () => {
+        const addr = server.address();
+        // The Rust shell reads this line to learn the port.
+        process.stdout.write(`GG_APP_LISTENING ${addr.port}\n`);
+        log("INFO", "app-sidecar", "listening", { port: String(addr.port), host });
+    });
+    const shutdown = async () => {
+        tasksPollStopped = true;
+        if (tasksPoll)
+            clearTimeout(tasksPoll);
+        // Kill any playing radio so the stream dies with its window.
+        stopRadio();
+        // Stop the Telegram serve loop + dispose its per-chat sessions.
+        if (serveController)
+            await serveController.stop().catch(() => { });
+        for (const c of clients)
+            c.res.end();
+        server.close();
+        await session.dispose().catch(() => { });
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown());
+    process.on("SIGTERM", () => void shutdown());
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`GG_APP_FATAL ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=app-sidecar.js.map