@kenkaiiii/ggcoder 5.24.0 → 5.26.0

package/dist/core/local-endpoint-store.js

@@ -0,0 +1,201 @@
+/**
+ * Persistence for user-added local model endpoints.
+ *
+ * The four well-known servers (Ollama, LM Studio, llama.cpp, vLLM) are probed
+ * without configuration; this store holds only the extra endpoints a user typed
+ * in — a moved port, a remote self-hosted box, an OpenAI-compatible gateway.
+ *
+ * Endpoints live in `~/.gg/gg-app.json` under `localEndpoints`; each one's key
+ * (and, for keyed servers, its token) lives in `~/.gg/auth.json` as a
+ * `local:<id>` credential, which is also what carries the baseUrl into the
+ * stream call. The two are kept in sync here so the UI never has to.
+ */
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { AuthStorage, DEFAULT_LOCAL_ENDPOINTS, clearLocalDiscoveryCache, } from "@kenkaiiii/gg-core";
+export class LocalEndpointError extends Error {
+}
+const RESERVED_IDS = new Set(DEFAULT_LOCAL_ENDPOINTS.map((e) => e.id));
+const MAX_CUSTOM_ENDPOINTS = 20;
+function appSettingsFile(override) {
+    return override ?? path.join(os.homedir(), ".gg", "gg-app.json");
+}
+/**
+ * Normalize a user-typed URL into the OpenAI-compatible base we call.
+ * Accepts `host:port`, a bare root, or a full `/v1` URL, and tolerates a pasted
+ * `/v1/chat/completions` or `/v1/models` (people copy from docs).
+ */
+export function normalizeLocalBaseUrl(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        throw new LocalEndpointError("Endpoint URL is required.");
+    const scheme = /^([a-z][a-z0-9+.-]*):\/\//i.exec(trimmed)?.[1]?.toLowerCase();
+    if (scheme && scheme !== "http" && scheme !== "https") {
+        throw new LocalEndpointError("Endpoint URL must use http or https.");
+    }
+    // Bare `host:port` is the common case — assume plain http, like the servers do.
+    const withScheme = scheme ? trimmed : `http://${trimmed}`;
+    let url;
+    try {
+        url = new URL(withScheme);
+    }
+    catch {
+        throw new LocalEndpointError(`"${input}" is not a valid URL.`);
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new LocalEndpointError("Endpoint URL must use http or https.");
+    }
+    if (!url.hostname)
+        throw new LocalEndpointError("Endpoint URL is missing a host.");
+    let pathname = url.pathname.replace(/\/+$/, "");
+    pathname = pathname.replace(/\/(?:chat\/completions|completions|models)$/, "");
+    if (!/\/v\d+$/.test(pathname))
+        pathname = `${pathname}/v1`;
+    return `${url.protocol}//${url.host}${pathname}`;
+}
+/** Slug derived from the URL, e.g. `custom-192-168-1-4-8000`. Stable per host:port. */
+function endpointIdFor(baseUrl) {
+    const { host } = new URL(baseUrl);
+    const slug = host
+        .replace(/[^a-z0-9]+/gi, "-")
+        .replace(/^-|-$/g, "")
+        .toLowerCase();
+    return `custom-${slug || "endpoint"}`;
+}
+function labelFor(baseUrl, label) {
+    const trimmed = label?.trim();
+    if (trimmed)
+        return trimmed;
+    return new URL(baseUrl).host;
+}
+// ── settings file I/O ──────────────────────────────────────
+/**
+ * Read/modify/write the whole settings object rather than a typed subset, so a
+ * key written by another part of the app (or a newer version) survives.
+ */
+async function readSettings(file) {
+    try {
+        const raw = JSON.parse(await fs.readFile(appSettingsFile(file), "utf-8"));
+        return raw && typeof raw === "object" ? raw : {};
+    }
+    catch {
+        return {};
+    }
+}
+async function writeSettings(settings, file) {
+    const target = appSettingsFile(file);
+    await fs.mkdir(path.dirname(target), { recursive: true });
+    await fs.writeFile(target, JSON.stringify(settings, null, 2), "utf-8");
+}
+function parseStored(value) {
+    if (!Array.isArray(value))
+        return [];
+    const endpoints = [];
+    for (const entry of value) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const { id, label, baseUrl, apiKey } = entry;
+        if (typeof id !== "string" || typeof baseUrl !== "string")
+            continue;
+        endpoints.push({
+            id,
+            label: typeof label === "string" && label ? label : baseUrl,
+            baseUrl,
+            kind: "custom",
+            custom: true,
+            ...(typeof apiKey === "string" && apiKey ? { apiKey } : {}),
+        });
+    }
+    return endpoints;
+}
+/** User-added endpoints, in insertion order. Never throws on a corrupt file. */
+export async function listCustomEndpoints(options = {}) {
+    return parseStored((await readSettings(options.settingsFile))["localEndpoints"]);
+}
+/** Well-known endpoints first, then the user's own — the probe/scan order. */
+export async function listAllEndpoints(options = {}) {
+    return [...DEFAULT_LOCAL_ENDPOINTS, ...(await listCustomEndpoints(options))];
+}
+/**
+ * Add a custom endpoint and write its `local:<id>` credential. Re-adding the
+ * same host updates it (that's how a user fixes a mistyped key) instead of
+ * creating a second row for the same server.
+ */
+export async function addCustomEndpoint(input, options = {}) {
+    const auth = options.auth ?? new AuthStorage();
+    const baseUrl = normalizeLocalBaseUrl(input.baseUrl);
+    const id = endpointIdFor(baseUrl);
+    if (RESERVED_IDS.has(id)) {
+        throw new LocalEndpointError(`"${id}" is a built-in endpoint id.`);
+    }
+    const existing = await listCustomEndpoints(options);
+    const builtIn = DEFAULT_LOCAL_ENDPOINTS.find((e) => e.baseUrl === baseUrl);
+    if (builtIn) {
+        throw new LocalEndpointError(`${baseUrl} is already probed automatically as ${builtIn.label}.`);
+    }
+    if (!existing.some((e) => e.id === id) && existing.length >= MAX_CUSTOM_ENDPOINTS) {
+        throw new LocalEndpointError(`At most ${MAX_CUSTOM_ENDPOINTS} custom endpoints.`);
+    }
+    const endpoint = {
+        id,
+        label: labelFor(baseUrl, input.label),
+        baseUrl,
+        kind: "custom",
+        custom: true,
+        ...(input.apiKey?.trim() ? { apiKey: input.apiKey.trim() } : {}),
+    };
+    const next = existing.some((e) => e.id === id)
+        ? existing.map((e) => (e.id === id ? endpoint : e))
+        : [...existing, endpoint];
+    const settings = await readSettings(options.settingsFile);
+    settings["localEndpoints"] = next.map(({ id: eid, label, baseUrl: url, apiKey }) => ({
+        id: eid,
+        label,
+        baseUrl: url,
+        ...(apiKey ? { apiKey } : {}),
+    }));
+    await writeSettings(settings, options.settingsFile);
+    await auth.setLocalEndpoint(id, baseUrl, endpoint.apiKey);
+    clearLocalDiscoveryCache();
+    return endpoint;
+}
+/**
+ * Remove a custom endpoint and its credential. Built-in endpoints can't be
+ * removed (they're discovered, not configured) — that's an error, not a no-op,
+ * so a UI bug doesn't silently do nothing.
+ */
+export async function removeCustomEndpoint(id, options = {}) {
+    const auth = options.auth ?? new AuthStorage();
+    if (RESERVED_IDS.has(id)) {
+        throw new LocalEndpointError(`${id} is a built-in endpoint and can't be removed.`);
+    }
+    const existing = await listCustomEndpoints(options);
+    if (!existing.some((e) => e.id === id)) {
+        throw new LocalEndpointError(`Unknown local endpoint "${id}".`);
+    }
+    const settings = await readSettings(options.settingsFile);
+    settings["localEndpoints"] = existing
+        .filter((e) => e.id !== id)
+        .map(({ id: eid, label, baseUrl, apiKey }) => ({
+        id: eid,
+        label,
+        baseUrl,
+        ...(apiKey ? { apiKey } : {}),
+    }));
+    await writeSettings(settings, options.settingsFile);
+    await auth.removeLocalEndpoint(id);
+    clearLocalDiscoveryCache();
+}
+/**
+ * Make sure every endpoint we're about to serve models from has a credential
+ * carrying its baseUrl — otherwise `stream()` has no endpoint to talk to.
+ * Called after each scan, so a fresh install works with zero setup.
+ */
+export async function syncEndpointCredentials(endpoints, options = {}) {
+    const auth = options.auth ?? new AuthStorage();
+    for (const endpoint of endpoints) {
+        await auth.setLocalEndpoint(endpoint.id, endpoint.baseUrl, endpoint.apiKey);
+    }
+}
+//# sourceMappingURL=local-endpoint-store.js.map

package/dist/core/local-endpoint-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-endpoint-store.js","sourceRoot":"","sources":["../../src/core/local-endpoint-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,uBAAuB,EACvB,wBAAwB,GAEzB,MAAM,oBAAoB,CAAC;AAS5B,MAAM,OAAO,kBAAmB,SAAQ,KAAK;CAAG;AAehD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvE,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,SAAS,eAAe,CAAC,QAAiB;IACxC,OAAO,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,kBAAkB,CAAC,2BAA2B,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9E,IAAI,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACtD,MAAM,IAAI,kBAAkB,CAAC,sCAAsC,CAAC,CAAC;IACvE,CAAC;IACD,gFAAgF;IAChF,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,OAAO,EAAE,CAAC;IAC1D,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,kBAAkB,CAAC,IAAI,KAAK,uBAAuB,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,kBAAkB,CAAC,sCAAsC,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,QAAQ;QAAE,MAAM,IAAI,kBAAkB,CAAC,iCAAiC,CAAC,CAAC;IACnF,IAAI,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChD,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,6CAA6C,EAAE,EAAE,CAAC,CAAC;IAC/E,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,QAAQ,GAAG,GAAG,QAAQ,KAAK,CAAC;IAC3D,OAAO,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;AACnD,CAAC;AAED,uFAAuF;AACvF,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI;SACd,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,WAAW,EAAE,CAAC;IACjB,OAAO,UAAU,IAAI,IAAI,UAAU,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe,EAAE,KAAc;IAC/C,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;AAC/B,CAAC;AAED,8DAA8D;AAE9D;;;GAGG;AACH,KAAK,UAAU,YAAY,CAAC,IAAa;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAY,CAAC;QACrF,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,GAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,QAAiC,EAAE,IAAa;IAC3E,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,SAAS,GAAoB,EAAE,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClD,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAgC,CAAC;QACxE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,SAAS;QACpE,SAAS,CAAC,IAAI,CAAC;YACb,EAAE;YACF,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;YAC3D,OAAO;YACP,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,IAAI;YACZ,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAqC,EAAE;IAEvC,OAAO,WAAW,CAAC,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAqC,EAAE;IAEvC,OAAO,CAAC,GAAG,uBAAuB,EAAE,GAAG,CAAC,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAyB,EACzB,UAAqC,EAAE;IAEvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,WAAW,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,kBAAkB,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAC3E,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,kBAAkB,CAAC,GAAG,OAAO,uCAAuC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,QAAQ,CAAC,MAAM,IAAI,oBAAoB,EAAE,CAAC;QAClF,MAAM,IAAI,kBAAkB,CAAC,WAAW,oBAAoB,oBAAoB,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,QAAQ,GAAkB;QAC9B,EAAE;QACF,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;QACrC,OAAO;QACP,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,IAAI;QACZ,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QAC5C,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE5B,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACnF,EAAE,EAAE,GAAG;QACP,KAAK;QACL,OAAO,EAAE,GAAG;QACZ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9B,CAAC,CAAC,CAAC;IACJ,MAAM,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1D,wBAAwB,EAAE,CAAC;IAC3B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,EAAU,EACV,UAAqC,EAAE;IAEvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,WAAW,EAAE,CAAC;IAC/C,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,kBAAkB,CAAC,GAAG,EAAE,+CAA+C,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,kBAAkB,CAAC,2BAA2B,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,GAAG,QAAQ;SAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;SAC1B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7C,EAAE,EAAE,GAAG;QACP,KAAK;QACL,OAAO;QACP,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9B,CAAC,CAAC,CAAC;IACN,MAAM,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACnC,wBAAwB,EAAE,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,SAAmC,EACnC,UAAqC,EAAE;IAEvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,WAAW,EAAE,CAAC;IAC/C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC"}

package/dist/core/local-endpoint-store.test.d.ts

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

package/dist/core/local-endpoint-store.test.d.ts.map

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

package/dist/core/local-endpoint-store.test.js

@@ -0,0 +1,131 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { AuthStorage } from "@kenkaiiii/gg-core";
+import { LocalEndpointError, addCustomEndpoint, listAllEndpoints, listCustomEndpoints, normalizeLocalBaseUrl, removeCustomEndpoint, syncEndpointCredentials, } from "./local-endpoint-store.js";
+let dir;
+let opts;
+let auth;
+// Both file paths are injected rather than redirected via $HOME: os.homedir()
+// reads USERPROFILE on Windows, so a HOME override silently writes to the real
+// ~/.gg there — which leaks state between tests and pollutes the user's files.
+beforeEach(async () => {
+    dir = await fs.mkdtemp(path.join(os.tmpdir(), "gg-local-endpoints-"));
+    auth = new AuthStorage(path.join(dir, "auth.json"));
+    opts = { settingsFile: path.join(dir, "gg-app.json"), auth };
+});
+afterEach(async () => {
+    await fs.rm(dir, { recursive: true, force: true });
+});
+async function settings() {
+    return JSON.parse(await fs.readFile(opts.settingsFile, "utf-8"));
+}
+describe("normalizeLocalBaseUrl", () => {
+    it("accepts the shapes users actually paste", () => {
+        expect(normalizeLocalBaseUrl("127.0.0.1:1234")).toBe("http://127.0.0.1:1234/v1");
+        expect(normalizeLocalBaseUrl("http://localhost:8000")).toBe("http://localhost:8000/v1");
+        expect(normalizeLocalBaseUrl("http://localhost:8000/v1")).toBe("http://localhost:8000/v1");
+        expect(normalizeLocalBaseUrl("  http://localhost:8000/v1/  ")).toBe("http://localhost:8000/v1");
+        expect(normalizeLocalBaseUrl("http://box.lan:8080/v1/chat/completions")).toBe("http://box.lan:8080/v1");
+        expect(normalizeLocalBaseUrl("http://box.lan:8080/v1/models")).toBe("http://box.lan:8080/v1");
+        // A gateway on a sub-path keeps the path.
+        expect(normalizeLocalBaseUrl("https://gw.example.com/openai")).toBe("https://gw.example.com/openai/v1");
+    });
+    it("rejects empty, malformed, and non-http URLs", () => {
+        expect(() => normalizeLocalBaseUrl("   ")).toThrow(LocalEndpointError);
+        expect(() => normalizeLocalBaseUrl("http://")).toThrow(LocalEndpointError);
+        expect(() => normalizeLocalBaseUrl("ftp://host/v1")).toThrow(LocalEndpointError);
+    });
+});
+describe("custom endpoints", () => {
+    it("adds an endpoint, persists it, and writes its auth credential", async () => {
+        const endpoint = await addCustomEndpoint({ label: "Workstation", baseUrl: "192.168.1.4:8000", apiKey: "secret" }, opts);
+        expect(endpoint).toMatchObject({
+            id: "custom-192-168-1-4-8000",
+            label: "Workstation",
+            baseUrl: "http://192.168.1.4:8000/v1",
+            kind: "custom",
+            custom: true,
+            apiKey: "secret",
+        });
+        expect(await listCustomEndpoints(opts)).toEqual([endpoint]);
+        const creds = await auth.getCredentials("local:custom-192-168-1-4-8000");
+        expect(creds).toMatchObject({ accessToken: "secret", baseUrl: "http://192.168.1.4:8000/v1" });
+        expect(creds.expiresAt).toBeGreaterThan(Date.now());
+        expect(await auth.hasProviderAuth("local")).toBe(true);
+    });
+    it("defaults the label to the host and the key to a placeholder", async () => {
+        await addCustomEndpoint({ baseUrl: "http://localhost:9999" }, opts);
+        const stored = (await listCustomEndpoints(opts))[0];
+        expect(stored.label).toBe("localhost:9999");
+        expect(stored.apiKey).toBeUndefined();
+        expect(await auth.getCredentials("local:custom-localhost-9999")).toMatchObject({
+            accessToken: "local",
+        });
+    });
+    it("updates in place when the same host is re-added", async () => {
+        await addCustomEndpoint({ baseUrl: "http://localhost:9999", apiKey: "wrong" }, opts);
+        await addCustomEndpoint({ label: "Fixed", baseUrl: "http://localhost:9999/v1", apiKey: "right" }, opts);
+        const stored = await listCustomEndpoints(opts);
+        expect(stored).toHaveLength(1);
+        expect(stored[0]).toMatchObject({ label: "Fixed", apiKey: "right" });
+        expect(await auth.getCredentials("local:custom-localhost-9999")).toMatchObject({
+            accessToken: "right",
+        });
+    });
+    it("refuses a URL already covered by a built-in endpoint", async () => {
+        await expect(addCustomEndpoint({ baseUrl: "http://127.0.0.1:11434/v1" }, opts)).rejects.toThrow(/already probed automatically as Ollama/);
+    });
+    it("removes an endpoint and its credential", async () => {
+        await addCustomEndpoint({ baseUrl: "http://localhost:9999" }, opts);
+        await removeCustomEndpoint("custom-localhost-9999", opts);
+        expect(await listCustomEndpoints(opts)).toEqual([]);
+        expect(await auth.getCredentials("local:custom-localhost-9999")).toBeUndefined();
+        expect(await auth.hasProviderAuth("local")).toBe(false);
+    });
+    it("refuses to remove a built-in or unknown endpoint", async () => {
+        await expect(removeCustomEndpoint("ollama", opts)).rejects.toThrow(/built-in/);
+        await expect(removeCustomEndpoint("custom-nope", opts)).rejects.toThrow(/Unknown local/);
+    });
+    it("preserves unrelated gg-app.json keys", async () => {
+        await fs.writeFile(opts.settingsFile, JSON.stringify({ projectsRoot: "/tmp/projects", autopilot: { "/a": true } }), "utf-8");
+        await addCustomEndpoint({ baseUrl: "http://localhost:9999" }, opts);
+        expect(await settings()).toMatchObject({
+            projectsRoot: "/tmp/projects",
+            autopilot: { "/a": true },
+        });
+        await removeCustomEndpoint("custom-localhost-9999", opts);
+        expect(await settings()).toMatchObject({ projectsRoot: "/tmp/projects" });
+    });
+    it("ignores a corrupt settings file instead of throwing", async () => {
+        await fs.writeFile(opts.settingsFile, "{not json", "utf-8");
+        expect(await listCustomEndpoints(opts)).toEqual([]);
+    });
+    it("lists built-in endpoints before custom ones", async () => {
+        await addCustomEndpoint({ baseUrl: "http://localhost:9999" }, opts);
+        expect((await listAllEndpoints(opts)).map((e) => e.id)).toEqual([
+            "ollama",
+            "lmstudio",
+            "llamacpp",
+            "vllm",
+            "custom-localhost-9999",
+        ]);
+    });
+});
+describe("syncEndpointCredentials", () => {
+    it("writes a baseUrl-carrying credential for every endpoint", async () => {
+        await syncEndpointCredentials(await listAllEndpoints(opts), opts);
+        expect((await auth.listLocalEndpointIds()).sort()).toEqual([
+            "llamacpp",
+            "lmstudio",
+            "ollama",
+            "vllm",
+        ]);
+        expect(await auth.getCredentials("local:ollama")).toMatchObject({
+            baseUrl: "http://127.0.0.1:11434/v1",
+            accessToken: "local",
+        });
+    });
+});
+//# sourceMappingURL=local-endpoint-store.test.js.map

package/dist/core/local-endpoint-store.test.js.map

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

package/dist/core/memory/compaction-notes.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Turn the detail compaction is about to throw away into durable journal
+ * entries.
+ *
+ * Compaction is one-way: the summary replaces the messages and the specifics
+ * are gone for good. That is the actual hole the journal exists to fill — an
+ * entry written here survives the summary, the session and the next restart.
+ *
+ * **Every entry must be a past-tense record of something that already
+ * happened.** Bench G showed that an injected note suppresses verification
+ * entirely (5/5 checks → 0/5), so an entry that can later become false will be
+ * asserted with full confidence and never re-checked. History cannot become
+ * false, which is what makes this writer safe while a free-form "save a fact"
+ * tool was not. Do not add a producer here that records current state.
+ *
+ * Deliberately conservative: at most a handful of bounded entries per
+ * compaction. A journal that floods itself is one nobody can afford to read.
+ */
+import type { Message } from "@kenkaiiii/gg-ai";
+/** Max notes written per compaction. A flooded log is an unreadable log. */
+export declare const MAX_NOTES_PER_COMPACTION = 3;
+export interface CompactionNote {
+    text: string;
+    tag: string;
+}
+/**
+ * Build the notes to persist for one compaction. `dropped` are the messages
+ * being replaced; `summary` is the text replacing them.
+ */
+export declare function buildCompactionNotes(dropped: readonly Message[], summary: string): CompactionNote[];
+//# sourceMappingURL=compaction-notes.d.ts.map

package/dist/core/memory/compaction-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-notes.d.ts","sourceRoot":"","sources":["../../../src/core/memory/compaction-notes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,kBAAkB,CAAC;AAK7D,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAM1C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAoID;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,OAAO,EAAE,MAAM,GACd,cAAc,EAAE,CA0BlB"}

package/dist/core/memory/compaction-notes.js

@@ -0,0 +1,162 @@
+// Single source of truth for entry truncation — both writers must cut at the
+// same boundaries, or an entry's rendering would depend on which path made it.
+import { clampEntryText } from "./journal.js";
+/** Max notes written per compaction. A flooded log is an unreadable log. */
+export const MAX_NOTES_PER_COMPACTION = 3;
+/** Max file paths named in the files note. */
+const MAX_FILES_LISTED = 8;
+/** Max chars of the summary carried into a note. */
+const SUMMARY_NOTE_CHARS = 360;
+/**
+ * Sections of the compactor's summary worth keeping in a durable journal.
+ *
+ * The compactor emits seven labelled sections. Most must NOT be journalled:
+ *
+ * - `Primary Request and Intent` / `User Messages` — already captured verbatim,
+ *   and far more cheaply, by the `request` entry. Live measurement (bench H)
+ *   showed 64% of the request entry's words repeated inside the summary.
+ * - `Files Touched` — already captured exactly by the `files` entry.
+ * - `Current Work` / `Next Step` — in-flight state. True at the moment of
+ *   compaction, false minutes later, and bench G proved a stale entry is
+ *   asserted with full confidence and never re-checked. Journalling these
+ *   would reintroduce exactly the failure this design exists to avoid.
+ *
+ * That leaves the two sections that are pure, permanent history — what was
+ * actually done, and what went wrong and how it was fixed. Those are also the
+ * only parts a future session cannot cheaply re-derive by reading the code.
+ */
+const DURABLE_SUMMARY_SECTIONS = ["What Was Done", "Errors and Fixes"];
+const SECTION_HEADING = /^#{1,6}\s*(.+?)\s*$/;
+/** Split a compactor summary into `heading -> body` pairs. */
+function splitSections(summary) {
+    const sections = new Map();
+    let heading = null;
+    let body = [];
+    const flush = () => {
+        if (heading)
+            sections.set(heading.toLowerCase(), body.join(" ").trim());
+    };
+    for (const line of summary.split("\n")) {
+        const match = SECTION_HEADING.exec(line);
+        if (match && line.trimStart().startsWith("#")) {
+            flush();
+            heading = match[1];
+            body = [];
+            continue;
+        }
+        body.push(line);
+    }
+    flush();
+    return sections;
+}
+/** Strip markdown so an entry stays one clean, diffable line. */
+function toProse(text) {
+    return text
+        .replace(/<(read|modified)-files>[\s\S]*?<\/\1-files>/g, " ")
+        .replace(/^\s*[-*]\s+/gm, " ")
+        .replace(/^\s*\d+\.\s+/gm, " ")
+        .replace(/[`*_>#]/g, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/**
+ * The durable, non-duplicated part of a compaction summary. Falls back to the
+ * whole summary when the expected headings are absent (the compactor's
+ * extractive fallback path emits unstructured prose).
+ */
+function summaryToProse(summary) {
+    const stripped = summary.replace(/^\[Previous conversation summary\]/, "");
+    const sections = splitSections(stripped);
+    if (sections.size > 0) {
+        const kept = DURABLE_SUMMARY_SECTIONS.map((name) => sections.get(name.toLowerCase()))
+            .filter((body) => Boolean(body && body.trim()))
+            .map(toProse)
+            .filter(Boolean);
+        if (kept.length > 0)
+            return kept.join(" ");
+    }
+    return toProse(stripped);
+}
+const MUTATING_TOOLS = new Set(["write", "edit"]);
+/**
+ * Safety net for the structural de-duplication above: drop any entry whose text
+ * already appears verbatim inside another entry. Every journal entry is paid
+ * for on every subsequent turn, so a duplicate is not a cosmetic problem.
+ */
+function dropContainedNotes(notes) {
+    return notes.filter((note, index) => notes.every((other, otherIndex) => otherIndex === index ||
+        !other.text.includes(note.text) ||
+        // Identical texts: keep the first occurrence only.
+        (other.text === note.text && otherIndex > index)));
+}
+function textOf(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join(" ");
+}
+/** Files the discarded span actually changed, in first-touch order. */
+function changedFiles(dropped) {
+    const files = [];
+    for (const message of dropped) {
+        if (message.role !== "assistant" || !Array.isArray(message.content))
+            continue;
+        for (const part of message.content) {
+            if (part.type !== "tool_call" || !MUTATING_TOOLS.has(part.name))
+                continue;
+            const target = part.args?.file_path;
+            if (typeof target !== "string" || files.includes(target))
+                continue;
+            files.push(target);
+            if (files.length >= MAX_FILES_LISTED)
+                return files;
+        }
+    }
+    return files;
+}
+/** The first real user request in the discarded span, if there was one. */
+function firstUserRequest(dropped) {
+    for (const message of dropped) {
+        if (message.role !== "user")
+            continue;
+        const text = textOf(message.content).trim();
+        // Harness-injected framing (steering, loop-break, compaction summary) is
+        // not something worth remembering across sessions.
+        if (!text || text.startsWith("["))
+            continue;
+        return text;
+    }
+    return undefined;
+}
+/**
+ * Build the notes to persist for one compaction. `dropped` are the messages
+ * being replaced; `summary` is the text replacing them.
+ */
+export function buildCompactionNotes(dropped, summary) {
+    const notes = [];
+    // Past tense throughout: these describe a session that is already over.
+    const request = firstUserRequest(dropped);
+    if (request) {
+        notes.push({
+            tag: "request",
+            text: clampEntryText(`Was asked to: ${request}`, SUMMARY_NOTE_CHARS),
+        });
+    }
+    const files = changedFiles(dropped);
+    if (files.length > 0) {
+        notes.push({
+            tag: "files",
+            text: clampEntryText(`Edited: ${files.join(", ")}`, SUMMARY_NOTE_CHARS),
+        });
+    }
+    const summaryText = clampEntryText(summaryToProse(summary), SUMMARY_NOTE_CHARS);
+    if (summaryText) {
+        notes.push({ tag: "summary", text: summaryText });
+    }
+    return dropContainedNotes(notes).slice(0, MAX_NOTES_PER_COMPACTION);
+}
+//# sourceMappingURL=compaction-notes.js.map

package/dist/core/memory/compaction-notes.js.map

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

package/dist/core/memory/compaction-notes.test.d.ts

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

package/dist/core/memory/compaction-notes.test.d.ts.map

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