hoomanjs 1.46.0 → 1.55.0

package/dist/core/utils/preview-server.js

@@ -0,0 +1,212 @@
+import { createServer, } from "node:http";
+import { watch, createReadStream as fsCreateReadStream, } from "node:fs";
+import { access, readFile } from "node:fs/promises";
+import { relative, resolve, sep } from "node:path";
+import { PassThrough } from "node:stream";
+import serveHandler from "serve-handler";
+import { isResolvedPathInsideDir } from "./normalize-user-path.js";
+const LIVE_RELOAD_PATH = "/__hooman_live_reload";
+const LIVE_RELOAD_SNIPPET = `
+<script data-hooman-live-reload>
+(function () {
+  try {
+    var es = new EventSource(${JSON.stringify(LIVE_RELOAD_PATH)});
+    es.onmessage = function () { location.reload(); };
+    es.onerror = function () { /* browser will retry */ };
+  } catch (e) {}
+})();
+</script>
+`;
+/** Live preview servers keyed by absolute serve root. */
+const serversByRoot = new Map();
+function injectLiveReload(html) {
+    if (html.includes("data-hooman-live-reload")) {
+        return html;
+    }
+    if (/<\/body>/i.test(html)) {
+        return html.replace(/<\/body>/i, `${LIVE_RELOAD_SNIPPET}</body>`);
+    }
+    return `${html}\n${LIVE_RELOAD_SNIPPET}`;
+}
+function broadcastReload(active) {
+    for (const res of active.clients) {
+        try {
+            res.write(`data: reload\n\n`);
+        }
+        catch {
+            active.clients.delete(res);
+        }
+    }
+}
+async function listen(server, port) {
+    return new Promise((resolveListen, reject) => {
+        server.once("error", reject);
+        server.listen(port, "127.0.0.1", () => {
+            server.off("error", reject);
+            const addr = server.address();
+            if (!addr || typeof addr === "string") {
+                reject(new Error("Preview server failed to bind a port."));
+                return;
+            }
+            resolveListen(addr.port);
+        });
+    });
+}
+function requestPathname(req) {
+    try {
+        return new URL(req.url ?? "/", "http://127.0.0.1").pathname;
+    }
+    catch {
+        return "/";
+    }
+}
+async function handleRequest(active, req, res) {
+    if (requestPathname(req) === LIVE_RELOAD_PATH) {
+        res.writeHead(200, {
+            "Content-Type": "text/event-stream; charset=utf-8",
+            "Cache-Control": "no-cache, no-transform",
+            Connection: "keep-alive",
+            "Access-Control-Allow-Origin": "*",
+        });
+        res.write("\n");
+        active.clients.add(res);
+        req.on("close", () => {
+            active.clients.delete(res);
+        });
+        return;
+    }
+    await serveHandler(req, res, {
+        public: active.rootDir,
+        cleanUrls: false,
+        directoryListing: false,
+        headers: [
+            {
+                source: "**",
+                headers: [{ key: "Cache-Control", value: "no-store" }],
+            },
+            {
+                // Injected HTML length differs from on-disk size — drop Content-Length.
+                source: "**/*.@(html|htm)",
+                headers: [
+                    {
+                        key: "Content-Length",
+                        value: null,
+                    },
+                ],
+            },
+        ],
+    }, {
+        createReadStream(filePath, options) {
+            const path = typeof filePath === "string"
+                ? filePath
+                : Buffer.isBuffer(filePath)
+                    ? filePath.toString("utf8")
+                    : filePath.toString();
+            if (/\.html?$/i.test(path)) {
+                const stream = new PassThrough();
+                void readFile(path, "utf8")
+                    .then((raw) => {
+                    stream.end(Buffer.from(injectLiveReload(raw), "utf8"));
+                })
+                    .catch((error) => {
+                    stream.destroy(error instanceof Error ? error : new Error(String(error)));
+                });
+                return stream;
+            }
+            return fsCreateReadStream(filePath, options);
+        },
+    });
+}
+/**
+ * Start a localhost static file server with SSE live-reload.
+ * Servers are keyed by absolute `rootDir`; calling again for the same root
+ * returns the existing server.
+ *
+ * @param rootDir Absolute directory to serve.
+ * @param port Bind port; `0` (default) picks an ephemeral free port.
+ */
+export async function createPreviewServer(rootDirRaw, port = 0) {
+    const rootDir = resolve(rootDirRaw);
+    await access(rootDir);
+    const existing = serversByRoot.get(rootDir);
+    if (existing) {
+        return existing;
+    }
+    const clients = new Set();
+    const server = createServer((req, res) => {
+        void handleRequest(active, req, res).catch(() => {
+            if (!res.headersSent) {
+                res.writeHead(500).end("Preview server error");
+            }
+            else {
+                res.end();
+            }
+        });
+    });
+    const boundPort = await listen(server, port);
+    const baseUrl = `http://127.0.0.1:${boundPort}`;
+    let debounce;
+    const watcher = watch(rootDir, { recursive: true }, () => {
+        if (debounce) {
+            clearTimeout(debounce);
+        }
+        debounce = setTimeout(() => broadcastReload(active), 80);
+    });
+    watcher.on("error", () => {
+        /* ignore watcher errors on some platforms */
+    });
+    const active = {
+        rootDir,
+        port: boundPort,
+        baseUrl,
+        server,
+        watcher,
+        clients,
+        urlFor(filePath) {
+            const resolved = resolve(filePath);
+            if (!isResolvedPathInsideDir(resolved, rootDir)) {
+                throw new Error(`Preview file must stay under the served root (${rootDir}).`);
+            }
+            const rel = relative(rootDir, resolved).split(sep).join("/");
+            return `${baseUrl}/${rel}`;
+        },
+        async close() {
+            if (debounce) {
+                clearTimeout(debounce);
+            }
+            for (const res of clients) {
+                try {
+                    res.end();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            clients.clear();
+            watcher.close();
+            await new Promise((resolveClose, reject) => {
+                server.close((err) => (err ? reject(err) : resolveClose()));
+            });
+            if (serversByRoot.get(rootDir) === active) {
+                serversByRoot.delete(rootDir);
+            }
+        },
+    };
+    serversByRoot.set(rootDir, active);
+    return active;
+}
+export function getPreviewServer(rootDirRaw) {
+    return serversByRoot.get(resolve(rootDirRaw));
+}
+export async function stopPreviewServer(rootDirRaw) {
+    const active = serversByRoot.get(resolve(rootDirRaw));
+    if (!active) {
+        return false;
+    }
+    await active.close();
+    return true;
+}
+export function listPreviewServerRoots() {
+    return [...serversByRoot.keys()];
+}
+//# sourceMappingURL=preview-server.js.map

package/dist/core/utils/preview-server.js.map

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

package/dist/core/utils/search-probe.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Lightweight credential probe for search providers (one-result test query).
+ * Kept free of the web_search tool / Strands SDK so the VS Code extension can
+ * import it without pulling those into the extension host bundle.
+ */
+export type SearchProbeProvider = "brave" | "duckduckgo" | "exa" | "firecrawl" | "litellm" | "serper" | "tavily";
+export type SearchProbeOptions = {
+    provider: SearchProbeProvider;
+    apiKey?: string;
+    baseURL?: string;
+    /** LiteLLM search tool id (e.g. `perplexity-search`). */
+    tool?: string;
+    signal?: AbortSignal;
+};
+/**
+ * Run a one-result test search to validate search provider credentials.
+ * DuckDuckGo has no API key and succeeds without a network call.
+ */
+export declare function probeSearchProvider(options: SearchProbeOptions): Promise<void>;

package/dist/core/utils/search-probe.js

@@ -0,0 +1,165 @@
+/**
+ * Lightweight credential probe for search providers (one-result test query).
+ * Kept free of the web_search tool / Strands SDK so the VS Code extension can
+ * import it without pulling those into the extension host bundle.
+ */
+const BRAVE_ENDPOINT = "https://api.search.brave.com/res/v1/web/search";
+const SERPER_ENDPOINT = "https://google.serper.dev/search";
+const TAVILY_ENDPOINT = "https://api.tavily.com/search";
+const EXA_ENDPOINT = "https://api.exa.ai/search";
+const FIRECRAWL_ENDPOINT = "https://api.firecrawl.dev/v2/search";
+const DEFAULT_TIMEOUT_MS = 20_000;
+const FIRECRAWL_TIMEOUT_MS = 60_000;
+const PROBE_QUERY = "hooman";
+/**
+ * Run a one-result test search to validate search provider credentials.
+ * DuckDuckGo has no API key and succeeds without a network call.
+ */
+export async function probeSearchProvider(options) {
+    if (options.provider === "duckduckgo") {
+        return;
+    }
+    const timeoutMs = options.provider === "firecrawl" || options.provider === "litellm"
+        ? FIRECRAWL_TIMEOUT_MS
+        : DEFAULT_TIMEOUT_MS;
+    const timeoutSignal = AbortSignal.timeout(timeoutMs);
+    const signal = options.signal
+        ? AbortSignal.any([timeoutSignal, options.signal])
+        : timeoutSignal;
+    switch (options.provider) {
+        case "brave":
+            await probeBrave(requireApiKey(options.apiKey), signal);
+            return;
+        case "exa":
+            await probeExa(requireApiKey(options.apiKey), signal);
+            return;
+        case "firecrawl":
+            await probeFirecrawl(requireApiKey(options.apiKey), signal);
+            return;
+        case "litellm":
+            await probeLiteLLM({
+                baseURL: requireValue(options.baseURL, "Base URL is required."),
+                apiKey: requireApiKey(options.apiKey),
+                tool: requireValue(options.tool, "Search tool is required."),
+            }, signal);
+            return;
+        case "serper":
+            await probeSerper(requireApiKey(options.apiKey), signal);
+            return;
+        case "tavily":
+            await probeTavily(requireApiKey(options.apiKey), signal);
+            return;
+        default: {
+            const _exhaustive = options.provider;
+            throw new Error(`Unsupported search provider: ${_exhaustive}`);
+        }
+    }
+}
+function requireApiKey(apiKey) {
+    return requireValue(apiKey, "API key is required.");
+}
+function requireValue(value, message) {
+    const trimmed = value?.trim();
+    if (!trimmed) {
+        throw new Error(message);
+    }
+    return trimmed;
+}
+async function readErrorBody(response) {
+    const body = await response.text().catch(() => "");
+    return body.slice(0, 200);
+}
+async function probeBrave(apiKey, signal) {
+    const url = new URL(BRAVE_ENDPOINT);
+    url.searchParams.set("q", PROBE_QUERY);
+    url.searchParams.set("count", "1");
+    const response = await fetch(url, {
+        method: "GET",
+        signal,
+        headers: {
+            accept: "application/json",
+            "x-subscription-token": apiKey,
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Brave search failed (${response.status}): ${await readErrorBody(response)}`);
+    }
+}
+async function probeSerper(apiKey, signal) {
+    const response = await fetch(SERPER_ENDPOINT, {
+        method: "POST",
+        signal,
+        headers: {
+            "Content-Type": "application/json",
+            "X-API-KEY": apiKey,
+        },
+        body: JSON.stringify({ q: PROBE_QUERY, num: 1 }),
+    });
+    if (!response.ok) {
+        throw new Error(`Serper search failed (${response.status}): ${await readErrorBody(response)}`);
+    }
+}
+async function probeTavily(apiKey, signal) {
+    const response = await fetch(TAVILY_ENDPOINT, {
+        method: "POST",
+        signal,
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            api_key: apiKey,
+            query: PROBE_QUERY,
+            max_results: 1,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`Tavily search failed (${response.status}): ${await readErrorBody(response)}`);
+    }
+}
+async function probeExa(apiKey, signal) {
+    const response = await fetch(EXA_ENDPOINT, {
+        method: "POST",
+        signal,
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": apiKey,
+        },
+        body: JSON.stringify({
+            query: PROBE_QUERY,
+            numResults: 1,
+            type: "auto",
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`Exa search failed (${response.status}): ${await readErrorBody(response)}`);
+    }
+}
+async function probeFirecrawl(apiKey, signal) {
+    const response = await fetch(FIRECRAWL_ENDPOINT, {
+        method: "POST",
+        signal,
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({ query: PROBE_QUERY, limit: 1 }),
+    });
+    if (!response.ok) {
+        throw new Error(`Firecrawl search failed (${response.status}): ${await readErrorBody(response)}`);
+    }
+}
+async function probeLiteLLM(options, signal) {
+    const base = options.baseURL.replace(/\/+$/, "");
+    const url = `${base}/v1/search/${encodeURIComponent(options.tool)}`;
+    const response = await fetch(url, {
+        method: "POST",
+        signal,
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${options.apiKey}`,
+        },
+        body: JSON.stringify({ query: PROBE_QUERY, max_results: 1 }),
+    });
+    if (!response.ok) {
+        throw new Error(`LiteLLM search failed (${response.status}): ${await readErrorBody(response)}`);
+    }
+}
+//# sourceMappingURL=search-probe.js.map

package/dist/core/utils/search-probe.js.map

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

package/dist/core/utils/url-safety.d.ts

@@ -0,0 +1,2 @@
+export declare function isHttpUrl(value: string): URL;
+export declare function assertRemoteUrl(url: URL): Promise<void>;

package/dist/core/utils/url-safety.js

@@ -0,0 +1,47 @@
+import dns from "node:dns/promises";
+import net from "node:net";
+export function isHttpUrl(value) {
+    const url = new URL(value);
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error("Only http:// and https:// URLs are supported.");
+    }
+    return url;
+}
+function isPrivateHostname(hostname) {
+    const normalized = hostname.toLowerCase();
+    return (normalized === "localhost" ||
+        normalized === "127.0.0.1" ||
+        normalized === "::1" ||
+        normalized.endsWith(".localhost"));
+}
+function isPrivateIp(address) {
+    const version = net.isIP(address);
+    if (version === 4) {
+        const parts = address.split(".").map((part) => Number(part));
+        const a = parts[0] ?? -1;
+        const b = parts[1] ?? -1;
+        return (a === 10 ||
+            a === 127 ||
+            (a === 172 && b >= 16 && b <= 31) ||
+            (a === 192 && b === 168) ||
+            (a === 169 && b === 254));
+    }
+    if (version === 6) {
+        const normalized = address.toLowerCase();
+        return (normalized === "::1" ||
+            normalized.startsWith("fc") ||
+            normalized.startsWith("fd") ||
+            normalized.startsWith("fe80:"));
+    }
+    return false;
+}
+export async function assertRemoteUrl(url) {
+    if (isPrivateHostname(url.hostname)) {
+        throw new Error("Fetching localhost or loopback URLs is not allowed.");
+    }
+    const resolved = await dns.lookup(url.hostname, { all: true });
+    if (resolved.some((entry) => isPrivateIp(entry.address))) {
+        throw new Error("Fetching private-network URLs is not allowed.");
+    }
+}
+//# sourceMappingURL=url-safety.js.map

package/dist/core/utils/url-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-safety.js","sourceRoot":"","sources":["../../../src/core/utils/url-safety.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,mBAAmB,CAAC;AACpC,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC1C,OAAO,CACL,UAAU,KAAK,WAAW;QAC1B,UAAU,KAAK,WAAW;QAC1B,UAAU,KAAK,KAAK;QACpB,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,CAClC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAEzB,OAAO,CACL,CAAC,KAAK,EAAE;YACR,CAAC,KAAK,GAAG;YACT,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YACjC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC;YACxB,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CACzB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACzC,OAAO,CACL,UAAU,KAAK,KAAK;YACpB,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;YAC3B,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;YAC3B,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAC/B,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAQ;IAC5C,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/core/utils/zstd.d.ts

@@ -0,0 +1,6 @@
+/**
+ * zstd compress wrapper for openfig message chunk 1.
+ * openfig-core only decompresses (fzstd); Figma requires zstd on write.
+ */
+/** Compress bytes with zstd level 3 (Figma-compatible). */
+export declare function zstdCompress(data: Uint8Array, level?: number): Promise<Uint8Array>;

package/dist/core/utils/zstd.js

@@ -0,0 +1,39 @@
+/**
+ * zstd compress wrapper for openfig message chunk 1.
+ * openfig-core only decompresses (fzstd); Figma requires zstd on write.
+ */
+let codecPromise;
+async function loadZstdCodec() {
+    if (!codecPromise) {
+        codecPromise = (async () => {
+            const mod = (await import("zstd-codec"));
+            const codec = mod.ZstdCodec ?? mod.default?.ZstdCodec;
+            if (!codec?.run) {
+                throw new Error("zstd-codec: ZstdCodec.run not found");
+            }
+            return codec;
+        })();
+    }
+    return codecPromise;
+}
+/** Compress bytes with zstd level 3 (Figma-compatible). */
+export async function zstdCompress(data, level = 3) {
+    const codec = await loadZstdCodec();
+    return new Promise((resolve, reject) => {
+        try {
+            codec.run((zstd) => {
+                try {
+                    const simple = new zstd.Simple();
+                    resolve(simple.compress(data, level));
+                }
+                catch (err) {
+                    reject(err);
+                }
+            });
+        }
+        catch (err) {
+            reject(err);
+        }
+    });
+}
+//# sourceMappingURL=zstd.js.map

package/dist/core/utils/zstd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zstd.js","sourceRoot":"","sources":["../../../src/core/utils/zstd.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,IAAI,YAA8C,CAAC;AAEnD,KAAK,UAAU,aAAa;IAC1B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,CAAC,KAAK,IAAI,EAAE;YACzB,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAGtC,CAAC;YACF,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC;YACtD,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,EAAE,CAAC;IACP,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAgB,EAChB,KAAK,GAAG,CAAC;IAET,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;IACpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACjB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;gBACxC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/exec/approvals.js

@@ -1,12 +1,12 @@
 import { createInterface } from "node:readline/promises";
 import { stdin, stdout } from "node:process";
 import { HoomanToolApprovalIntervention } from "../core/approvals/intervention.js";
-import { EXIT_PLAN_MODE_TOOL } from "../core/state/tool-approvals.js";
+import { SWITCH_MODE_TOOL } from "../core/state/tool-approvals.js";
 function canPromptForApproval() {
     return Boolean(stdin.isTTY && stdout.isTTY);
 }
 async function promptForApproval(toolName, description, inputPreview) {
-    const isPlanExit = toolName === EXIT_PLAN_MODE_TOOL;
+    const isSwitchMode = toolName === SWITCH_MODE_TOOL;
     const rl = createInterface({ input: stdin, output: stdout });
     try {
         stdout.write(`\nTool approval required\n`);
@@ -15,7 +15,7 @@ async function promptForApproval(toolName, description, inputPreview) {
             stdout.write(`Description: ${description}\n`);
         }
         stdout.write(`Input:\n${inputPreview}\n`);
-        stdout.write(isPlanExit
+        stdout.write(isSwitchMode
             ? `Options: [a]llow once, [r]eject\n`
             : `Options: [a]llow once, [r]eject, [A]lways allow\n`);
         while (true) {
@@ -26,10 +26,10 @@ async function promptForApproval(toolName, description, inputPreview) {
             if (answer === "r" || answer === "reject") {
                 return "reject";
             }
-            if (!isPlanExit && (answer === "A" || answer === "always")) {
+            if (!isSwitchMode && (answer === "A" || answer === "always")) {
                 return "always";
             }
-            stdout.write(isPlanExit ? "Enter a or r.\n" : "Enter a, r, or A.\n");
+            stdout.write(isSwitchMode ? "Enter a or r.\n" : "Enter a, r, or A.\n");
         }
     }
     finally {

package/dist/exec/approvals.js.map

@@ -1 +1 @@
-{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/exec/approvals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAEnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,SAAS,oBAAoB;IAC3B,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,QAAgB,EAChB,WAA+B,EAC/B,YAAoB;IAEpB,MAAM,UAAU,GAAG,QAAQ,KAAK,mBAAmB,CAAC;IACpD,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,SAAS,QAAQ,IAAI,CAAC,CAAC;QACpC,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,gBAAgB,WAAW,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,WAAW,YAAY,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CACV,UAAU;YACR,CAAC,CAAC,mCAAmC;YACrC,CAAC,CAAC,mDAAmD,CACxD,CAAC;QACF,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAChD,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;gBAC1D,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC1C,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAC3D,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,OAAO,IAAI,8BAA8B,CAAC;QACxC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACrB,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;gBAC5B,OAAO;oBACL,QAAQ,EAAE,QAAQ;oBAClB,MAAM,EAAE,SAAS,OAAO,CAAC,QAAQ,gEAAgE;iBAClG,CAAC;YACJ,CAAC;YACD,OAAO,iBAAiB,CACtB,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,YAAY,CACrB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/exec/approvals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,SAAS,oBAAoB;IAC3B,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,QAAgB,EAChB,WAA+B,EAC/B,YAAoB;IAEpB,MAAM,YAAY,GAAG,QAAQ,KAAK,gBAAgB,CAAC;IACnD,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,SAAS,QAAQ,IAAI,CAAC,CAAC;QACpC,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,gBAAgB,WAAW,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,WAAW,YAAY,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CACV,YAAY;YACV,CAAC,CAAC,mCAAmC;YACrC,CAAC,CAAC,mDAAmD,CACxD,CAAC;QACF,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAChD,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;gBAC1D,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC1C,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAC7D,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,OAAO,IAAI,8BAA8B,CAAC;QACxC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACrB,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;gBAC5B,OAAO;oBACL,QAAQ,EAAE,QAAQ;oBAClB,MAAM,EAAE,SAAS,OAAO,CAAC,QAAQ,gEAAgE;iBAClG,CAAC;YACJ,CAAC;YACD,OAAO,iBAAiB,CACtB,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,YAAY,CACrB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { createRuntimeConfig, createRuntimeMcpConfig, runtimeConfigOptions, runt
 export type { RuntimeConfigSources } from "./core/runtime-config.js";
 export { attachmentsPath, basePath, configJsonPath, instructionsMdPath, mcpJsonPath, mcpOauthJsonPath, localSkillsPath, memoryPath, offloadedContentPath, plansPath, sessionsPath, skillsPath, } from "./core/utils/paths.js";
 export { currentProjectRoot, projectId, projectPath, projectRegistryPath, projectsPath, } from "./core/utils/project-registry.js";
-export { openBrowser } from "./core/utils/browser.js";
+export { openExternalBrowser } from "./core/utils/browser.js";
 export { attachmentDiagnosticBlock, attachmentPathsToPromptBlocks, normalizeAttachmentPaths, readAttachmentAsBlocksOrBase64, } from "./core/utils/attachments.js";
 export type { AttachmentBinaryFallback, AttachmentMediaBlocks, AttachmentReadResult, } from "./core/utils/attachments.js";
 export { detectDocumentFormat, detectImageFormat, detectVideoFormat, } from "./core/utils/file-formats.js";
@@ -23,10 +23,10 @@ export type { BeginAuthorizationResult as McpBeginAuthorizationResult, McpOAuthC
 export { McpTransportSchema, SseSchema, StdioSchema, StreamableHttpSchema, } from "./core/mcp/types.js";
 export type { McpTransport, Sse, Stdio, StreamableHttp, } from "./core/mcp/types.js";
 export { PrefixedMcpTool } from "./core/mcp/prefixed-mcp-tool.js";
-export { createAskUserTools, createFetchTools, createFilesystemTools, createGrepTools, createShellTools, createSleepTools, createThinkingTools, createTimeTools, createTodoTools, createWebSearchTools, } from "./core/tools/index.js";
+export { createAskUserTools, createFetchTools, createFilesystemTools, createGrepTools, createSleepTools, createThinkingTools, createTimeTools, createTodoTools, createWebSearchTools, } from "./core/tools/index.js";
 export { UPDATE_TODOS_TOOL_NAME } from "./core/tools/todo.js";
 export { ASK_USER_TOOL_NAME, getAskUserBackend, setAskUserBackend, type AskUserBackend, type AskUserRequest, type AskUserResponse, } from "./core/tools/ask-user.js";
-export { getTerminalBackend, setTerminalBackend, type TerminalBackend, type TerminalRunRequest, type TerminalRunResult, } from "./core/tools/shell.js";
+export { clearShellJobManager, createShellTools, getShellJobManager, getTerminalBackend, peekShellJobManager, setTerminalBackend, ShellJobManager, SHELL_OUTPUT_TOOL_NAME, SHELL_STOP_TOOL_NAME, SHELL_TOOL_NAME, type ShellJobEvent, type ShellJobInfo, type ShellJobOutputSnapshot, type ShellJobStatus, type TerminalBackend, type TerminalOutputSnapshot, type TerminalRunRequest, type TerminalRunResult, type TerminalSpawnResult, } from "./core/shell/index.js";
 export { getTextFsBackend, setTextFsBackend, type TextFsBackend, type TextFsReadOptions, } from "./core/tools/filesystem.js";
 export { AGENT_SKILLS_STATE_KEY, Registry as SkillsRegistry, builtInSkillsPath, clearAgentSkillsPromptInjectionState, createAgentSkillsPlugin, createAgentSkillSources, createSkillsRegistry, } from "./core/skills/index.js";
 export type { SkillListEntry, SkillSearchResult, } from "./core/skills/registry.js";
@@ -36,6 +36,12 @@ export { modelProviders } from "./core/models/index.js";
 export type { ModelProvider } from "./core/models/index.js";
 export { createModelDownloadLogger, downloadRatio, formatBytes, formatBytesPerSecond, formatEtaSeconds, formatModelDownloadLine, renderDownloadBar, subscribeModelDownloadProgress, } from "./core/utils/download-progress.js";
 export type { ModelDownloadProgress, ModelDownloadProgressListener, } from "./core/utils/download-progress.js";
+export { DEFAULT_PREFETCH_MODEL_BY_PROVIDER, defaultPrefetchedModel, hasPrefetchCredentials, prefetchProviderModels, providerRequiresCredentials, resolvePrefetchModels, } from "./core/utils/models-prefetch.js";
+export type { PrefetchModelsOptions, PrefetchProviderId, PrefetchedModel, } from "./core/utils/models-prefetch.js";
+export { probeSearchProvider } from "./core/utils/search-probe.js";
+export type { SearchProbeOptions, SearchProbeProvider, } from "./core/utils/search-probe.js";
+export { completeOnboardingConfig, hasOnboardingConfig, validateOnboardingProvider, validateOnboardingSearch, } from "./core/utils/onboarding-config.js";
+export type { OnboardingInput, OnboardingProviderId, OnboardingProviderInput, OnboardingSearchProvider, } from "./core/utils/onboarding-config.js";
 export { subscribeModelRetryProgress } from "./core/agent/retry-progress.js";
 export type { ModelRetryProgress, ModelRetryProgressListener, } from "./core/agent/retry-progress.js";
 export { create as createAnthropicModelProvider, type AnthropicModelParams, } from "./core/models/anthropic.js";
@@ -56,7 +62,7 @@ export { FlatFileStorage } from "./core/sessions/flat-file-storage.js";
 export { LazySessionManager, type LazySessionManagerConfig, } from "./core/sessions/lazy-session-manager.js";
 export { TolerantFileStorage } from "./core/sessions/tolerant-file-storage.js";
 export { latestCliSession, listCliSessions, type CliSessionSummary, } from "./core/sessions/list-cli-sessions.js";
-export { SUBAGENT_TOOL_NAME_PREFIX, createSubagentTools, createSubagentRegistry, } from "./core/subagents/index.js";
+export { LAUNCH_SUBAGENT_TOOL_NAME, createSubagentTools, createSubagentRegistry, } from "./core/subagents/index.js";
 export type { SubagentKindConfig, SubagentKindDefinition, SubagentRegistry, } from "./core/subagents/index.js";
 export { INTERNAL_ALWAYS_ALLOWED as TOOL_APPROVAL_INTERNAL_ALWAYS_ALLOWED, isImplicitlyAllowed, isToolVisible, planModeWriteEditRejectionMessage, } from "./core/state/tool-approvals.js";
 export { Allowlist, getAllowlist, type AllowlistOptions, type AllowlistRule, } from "./core/approvals/allowlist.js";
@@ -67,7 +73,7 @@ export { createChannelPermissionAsk, readChannelOrigin, type ChannelOrigin as To
 export { ChatTurnSteeringController, ChatTurnSteeringIntervention, createChatTurnSteeringIntervention, type QueuedSteeringPrompt, } from "./core/agent/turn-steering.js";
 export { YOLO_STATE_KEY, isYoloEnabled, setYoloEnabled, } from "./core/state/yolo.js";
 export { MODE_STATE_KEY, getModeState, setSessionMode, type SessionMode, } from "./core/state/session-mode.js";
-export { DEFAULT_SESSION_MODE, MODE_DEFINITIONS, MODE_IDS, formatModeNames, getModeDefinition, getModeIds, getModeOptions, getModeTools, isKnownSessionMode, isModeDefinition, loadModeDefinitions, type KnownSessionMode, type ModeDefinition, } from "./core/modes/index.js";
+export { DEFAULT_SESSION_MODE, MODE_DEFINITIONS, MODE_IDS, formatModeNames, getModeDefinition, getModeIds, getModeOptions, getModeTools, isKnownSessionMode, isModeDefinition, isModeListedTool, loadModeDefinitions, type KnownSessionMode, type ModeDefinition, } from "./core/modes/index.js";
 export type { LoadedModeDefinition } from "./core/modes/registry.js";
 export { TODO_ITEMS_STATE_KEY, TODO_VISIBLE_STATE_KEY, TodoItemSchema, TodoStatusSchema, clearTodoState, getTodoViewState, setTodoState, summarizeTodos, } from "./core/state/todos.js";
 export type { TodoItem, TodoStatus, TodoViewState, } from "./core/state/todos.js";