lmgrep 0.1.18 → 0.2.1

package/dist/infrastructure/ai/LocalRuntimeDetector.js

@@ -0,0 +1,63 @@
+import { DockerModelRunnerProbe } from "./DockerModelRunnerProbe.js";
+import { LmStudioProbe } from "./LmStudioProbe.js";
+import { OllamaProbe } from "./OllamaProbe.js";
+/**
+ * Finds whichever local inference server is running.
+ *
+ * Probes run concurrently and the first *useful* result wins — a server with
+ * models beats one that is merely listening, so a running-but-empty Ollama
+ * does not shadow a fully set up LM Studio.
+ */
+export class LocalRuntimeDetector {
+    probes;
+    constructor(probes = [
+        new DockerModelRunnerProbe(),
+        new LmStudioProbe(),
+        new OllamaProbe(),
+    ]) {
+        this.probes = probes;
+    }
+    async detectAll() {
+        const results = await Promise.all(this.probes.map((p) => p.detect().catch(() => undefined)));
+        return results.filter((r) => r !== undefined);
+    }
+    /** The best runtime to configure against, if any is usable. */
+    async detectBest() {
+        const found = await this.detectAll();
+        return (found.find((r) => LocalRuntimeDetector.embeddingModels(r).length > 0) ??
+            found[0]);
+    }
+    /**
+     * Models the runtime says are embedders, best candidate first.
+     *
+     * A loaded model sorts ahead of the rest. Runtimes list models in an order
+     * of their own — LM Studio appears to use recency — and picking by position
+     * means the choice silently changes depending on what was used last.
+     * Load state is an explicit signal instead of an incidental one.
+     */
+    static embeddingModels(runtime) {
+        return LocalRuntimeDetector.loadedFirst(runtime.models.filter((m) => m.kind === "embedding"));
+    }
+    /** Stable sort putting loaded models first, order otherwise preserved. */
+    static loadedFirst(models) {
+        return [
+            ...models.filter((m) => m.loaded),
+            ...models.filter((m) => !m.loaded),
+        ];
+    }
+    /**
+     * Models usable for `ask`. Only taken when the runtime typed them: guessing
+     * an embedder is a chat model produces a confusing failure at answer time.
+     */
+    static chatModels(runtime) {
+        return LocalRuntimeDetector.loadedFirst(runtime.models.filter((m) => m.kind === "chat"));
+    }
+    /**
+     * Fallback for runtimes that do not type their models: anything not
+     * recognizable as an embedder.
+     */
+    static untypedModels(runtime) {
+        return LocalRuntimeDetector.loadedFirst(runtime.models.filter((m) => m.kind === "unknown"));
+    }
+}
+//# sourceMappingURL=LocalRuntimeDetector.js.map

package/dist/infrastructure/ai/LocalRuntimeDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalRuntimeDetector.js","sourceRoot":"","sources":["../../../src/infrastructure/ai/LocalRuntimeDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMnD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAEd;IADlB,YACkB,SAAkC;QAClD,IAAI,sBAAsB,EAAE;QAC5B,IAAI,aAAa,EAAE;QACnB,IAAI,WAAW,EAAE;KACjB;QAJgB,WAAM,GAAN,MAAM,CAItB;IACC,CAAC;IAEJ,KAAK,CAAC,SAAS;QACd,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CACzD,CAAC;QACF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IACrE,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,UAAU;QACf,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACrC,OAAO,CACN,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YACrE,KAAK,CAAC,CAAC,CAAC,CACR,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,OAAwB;QAC9C,OAAO,oBAAoB,CAAC,WAAW,CACtC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CACpD,CAAC;IACH,CAAC;IAED,0EAA0E;IAClE,MAAM,CAAC,WAAW,CAAC,MAAwB;QAClD,OAAO;YACN,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;YACjC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;SAClC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,OAAwB;QACzC,OAAO,oBAAoB,CAAC,WAAW,CACtC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAC/C,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,OAAwB;QAC5C,OAAO,oBAAoB,CAAC,WAAW,CACtC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAClD,CAAC;IACH,CAAC;CACD"}

package/dist/infrastructure/ai/ModelRuntime.d.ts

@@ -0,0 +1,32 @@
+/** What a discovered model is good for. */
+export type ModelKind = "embedding" | "chat" | "unknown";
+export interface CatalogedModel {
+    id: string;
+    kind: ModelKind;
+    /**
+     * Currently loaded in the runtime.
+     *
+     * The strongest statement of intent available without asking: a model the
+     * user has deliberately loaded is the one they mean. Undefined when the
+     * runtime does not report load state.
+     */
+    loaded?: boolean;
+}
+/** A local inference server that was found listening. */
+export interface DetectedRuntime {
+    /** Human name, for what `init` prints. */
+    label: string;
+    /** Provider segment of the `provider:model` string. */
+    providerId: string;
+    baseURL: string;
+    /**
+     * AI SDK package to load. Undefined means the default
+     * `@ai-sdk/<providerId>` is correct.
+     */
+    providerPackage?: string;
+    models: CatalogedModel[];
+}
+/** Detects one kind of local inference server. */
+export interface RuntimeProbe {
+    detect(): Promise<DetectedRuntime | undefined>;
+}

package/dist/infrastructure/ai/ModelRuntime.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ModelRuntime.js.map

package/dist/infrastructure/ai/ModelRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRuntime.js","sourceRoot":"","sources":["../../../src/infrastructure/ai/ModelRuntime.ts"],"names":[],"mappings":""}

package/dist/infrastructure/ai/OllamaProbe.d.ts

@@ -0,0 +1,22 @@
+import type { DetectedRuntime, RuntimeProbe } from "./ModelRuntime.js";
+/**
+ * Detects a local Ollama server.
+ *
+ * Ollama's tag listing does not say what a model is for, so kind is inferred
+ * from the name. That is a guess, and marked as one — `unknown` models are
+ * offered only when nothing better is found.
+ */
+export declare class OllamaProbe implements RuntimeProbe {
+    private static readonly TAGS_URL;
+    /** Models currently resident in memory. */
+    private static readonly RUNNING_URL;
+    static readonly BASE_URL = "http://localhost:11434/v1";
+    static readonly PROVIDER_PACKAGE = "@ai-sdk/openai-compatible";
+    private static readonly TIMEOUT_MS;
+    /** Name fragments that reliably indicate an embedding model. */
+    private static readonly EMBEDDING_HINTS;
+    detect(): Promise<DetectedRuntime | undefined>;
+    /** Best-effort; an older Ollama without this endpoint just reports none. */
+    private loadedModelNames;
+    private static looksLikeEmbedding;
+}

package/dist/infrastructure/ai/OllamaProbe.js

@@ -0,0 +1,71 @@
+/**
+ * Detects a local Ollama server.
+ *
+ * Ollama's tag listing does not say what a model is for, so kind is inferred
+ * from the name. That is a guess, and marked as one — `unknown` models are
+ * offered only when nothing better is found.
+ */
+export class OllamaProbe {
+    static TAGS_URL = "http://localhost:11434/api/tags";
+    /** Models currently resident in memory. */
+    static RUNNING_URL = "http://localhost:11434/api/ps";
+    static BASE_URL = "http://localhost:11434/v1";
+    static PROVIDER_PACKAGE = "@ai-sdk/openai-compatible";
+    static TIMEOUT_MS = 3000;
+    /** Name fragments that reliably indicate an embedding model. */
+    static EMBEDDING_HINTS = [
+        "embed",
+        "nomic",
+        "bge",
+        "minilm",
+        "gte-",
+        "e5-",
+    ];
+    async detect() {
+        let payload;
+        try {
+            const res = await fetch(OllamaProbe.TAGS_URL, {
+                signal: AbortSignal.timeout(OllamaProbe.TIMEOUT_MS),
+            });
+            if (!res.ok)
+                return undefined;
+            payload = (await res.json());
+        }
+        catch {
+            return undefined;
+        }
+        const loaded = await this.loadedModelNames();
+        const models = (payload.models ?? []).map((m) => ({
+            id: m.name,
+            kind: OllamaProbe.looksLikeEmbedding(m.name) ? "embedding" : "unknown",
+            loaded: loaded.has(m.name),
+        }));
+        return {
+            label: "Ollama",
+            providerId: "ollama",
+            baseURL: OllamaProbe.BASE_URL,
+            providerPackage: OllamaProbe.PROVIDER_PACKAGE,
+            models,
+        };
+    }
+    /** Best-effort; an older Ollama without this endpoint just reports none. */
+    async loadedModelNames() {
+        try {
+            const res = await fetch(OllamaProbe.RUNNING_URL, {
+                signal: AbortSignal.timeout(OllamaProbe.TIMEOUT_MS),
+            });
+            if (!res.ok)
+                return new Set();
+            const payload = (await res.json());
+            return new Set((payload.models ?? []).map((m) => m.name));
+        }
+        catch {
+            return new Set();
+        }
+    }
+    static looksLikeEmbedding(name) {
+        const lower = name.toLowerCase();
+        return OllamaProbe.EMBEDDING_HINTS.some((hint) => lower.includes(hint));
+    }
+}
+//# sourceMappingURL=OllamaProbe.js.map

package/dist/infrastructure/ai/OllamaProbe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OllamaProbe.js","sourceRoot":"","sources":["../../../src/infrastructure/ai/OllamaProbe.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IACf,MAAM,CAAU,QAAQ,GAAG,iCAAiC,CAAC;IACrE,2CAA2C;IACnC,MAAM,CAAU,WAAW,GAAG,+BAA+B,CAAC;IACtE,MAAM,CAAU,QAAQ,GAAG,2BAA2B,CAAC;IACvD,MAAM,CAAU,gBAAgB,GAAG,2BAA2B,CAAC;IACvD,MAAM,CAAU,UAAU,GAAG,IAAI,CAAC;IAE1C,gEAAgE;IACxD,MAAM,CAAU,eAAe,GAAG;QACzC,OAAO;QACP,OAAO;QACP,KAAK;QACL,QAAQ;QACR,MAAM;QACN,KAAK;KACL,CAAC;IAEF,KAAK,CAAC,MAAM;QACX,IAAI,OAA6C,CAAC;QAClD,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE;gBAC7C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC;aACnD,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,SAAS,CAAC;YAC9B,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAyC,CAAC;QACtE,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAqB,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnE,EAAE,EAAE,CAAC,CAAC,IAAI;YACV,IAAI,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;YACtE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;SAC1B,CAAC,CAAC,CAAC;QAEJ,OAAO;YACN,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE,QAAQ;YACpB,OAAO,EAAE,WAAW,CAAC,QAAQ;YAC7B,eAAe,EAAE,WAAW,CAAC,gBAAgB;YAC7C,MAAM;SACN,CAAC;IACH,CAAC;IAED,4EAA4E;IACpE,KAAK,CAAC,gBAAgB;QAC7B,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE;gBAChD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC;aACnD,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,IAAI,GAAG,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAEhC,CAAC;YACF,OAAO,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,GAAG,EAAE,CAAC;QAClB,CAAC;IACF,CAAC;IAEO,MAAM,CAAC,kBAAkB,CAAC,IAAY;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,CAAC"}

package/dist/infrastructure/ai/ProviderFailure.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Classifies provider errors that the research loop must handle differently
+ * from a genuine failure.
+ *
+ * A timeout and a context overflow both mean "the loop cannot continue, but
+ * what it gathered is still good" — they fall through to synthesis rather than
+ * degrading the whole run.
+ */
+export declare class ProviderFailure {
+    private static readonly OVERFLOW_PATTERN;
+    static isAbort(error: unknown): boolean;
+    /** A provider 400 whose body mentions the context window being exceeded. */
+    static isContextOverflow(error: unknown): boolean;
+    /** Opt-in diagnostics; provider errors carry detail worth seeing. */
+    static debug(where: string, error: unknown): void;
+}

package/dist/infrastructure/ai/ProviderFailure.js

@@ -0,0 +1,35 @@
+/**
+ * Classifies provider errors that the research loop must handle differently
+ * from a genuine failure.
+ *
+ * A timeout and a context overflow both mean "the loop cannot continue, but
+ * what it gathered is still good" — they fall through to synthesis rather than
+ * degrading the whole run.
+ */
+export class ProviderFailure {
+    static OVERFLOW_PATTERN = /context (size|length|window)|exceed|too (long|large)|max.*token/i;
+    static isAbort(error) {
+        return (error instanceof Error &&
+            (error.name === "AbortError" || error.name === "TimeoutError"));
+    }
+    /** A provider 400 whose body mentions the context window being exceeded. */
+    static isContextOverflow(error) {
+        const e = error;
+        if (e?.statusCode !== 400)
+            return false;
+        return ProviderFailure.OVERFLOW_PATTERN.test(`${e.responseBody ?? ""} ${e.message ?? ""}`);
+    }
+    /** Opt-in diagnostics; provider errors carry detail worth seeing. */
+    static debug(where, error) {
+        if (!process.env.LMGREP_DEBUG)
+            return;
+        const e = error;
+        console.error(`[lmgrep debug] ${where} error:`, {
+            name: e?.name,
+            message: e?.message,
+            statusCode: e?.statusCode,
+            responseBody: e?.responseBody,
+        });
+    }
+}
+//# sourceMappingURL=ProviderFailure.js.map

package/dist/infrastructure/ai/ProviderFailure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderFailure.js","sourceRoot":"","sources":["../../../src/infrastructure/ai/ProviderFailure.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IACnB,MAAM,CAAU,gBAAgB,GACvC,kEAAkE,CAAC;IAEpE,MAAM,CAAC,OAAO,CAAC,KAAc;QAC5B,OAAO,CACN,KAAK,YAAY,KAAK;YACtB,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,CAC9D,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,iBAAiB,CAAC,KAAc;QACtC,MAAM,CAAC,GAAG,KAIT,CAAC;QACF,IAAI,CAAC,EAAE,UAAU,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QACxC,OAAO,eAAe,CAAC,gBAAgB,CAAC,IAAI,CAC3C,GAAG,CAAC,CAAC,YAAY,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,CAC5C,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,MAAM,CAAC,KAAK,CAAC,KAAa,EAAE,KAAc;QACzC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY;YAAE,OAAO;QACtC,MAAM,CAAC,GAAG,KAAgC,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,kBAAkB,KAAK,SAAS,EAAE;YAC/C,IAAI,EAAE,CAAC,EAAE,IAAI;YACb,OAAO,EAAE,CAAC,EAAE,OAAO;YACnB,UAAU,EAAE,CAAC,EAAE,UAAU;YACzB,YAAY,EAAE,CAAC,EAAE,YAAY;SAC7B,CAAC,CAAC;IACJ,CAAC"}

package/dist/infrastructure/ai/ProviderModuleLoader.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Imports an AI SDK provider package.
+ *
+ * The OpenAI-compatible adapter is statically bundled so local runtimes work
+ * in the standalone executable. Other providers remain plugins: resolution
+ * reaches beyond this package's own `node_modules`, allowing a global install.
+ */
+export declare class ProviderModuleLoader {
+    private readonly cache;
+    private readonly bundled;
+    load(packageName: string): Promise<Record<string, unknown>>;
+    private resolve;
+    private globalModulePaths;
+}

package/dist/infrastructure/ai/ProviderModuleLoader.js

@@ -0,0 +1,56 @@
+import { execSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import * as openAICompatible from "@ai-sdk/openai-compatible";
+/**
+ * Imports an AI SDK provider package.
+ *
+ * The OpenAI-compatible adapter is statically bundled so local runtimes work
+ * in the standalone executable. Other providers remain plugins: resolution
+ * reaches beyond this package's own `node_modules`, allowing a global install.
+ */
+export class ProviderModuleLoader {
+    cache = new Map();
+    bundled = new Map([
+        ["@ai-sdk/openai-compatible", openAICompatible],
+    ]);
+    async load(packageName) {
+        const bundled = this.bundled.get(packageName);
+        if (bundled)
+            return bundled;
+        const cached = this.cache.get(packageName);
+        if (cached)
+            return cached;
+        const loaded = await this.resolve(packageName);
+        this.cache.set(packageName, loaded);
+        return loaded;
+    }
+    async resolve(packageName) {
+        // Local resolution first — the common case.
+        try {
+            return await import(packageName);
+        }
+        catch { }
+        for (const globalPath of this.globalModulePaths()) {
+            try {
+                const req = createRequire(join(globalPath, ".placeholder"));
+                return await import(req.resolve(packageName));
+            }
+            catch { }
+        }
+        throw new Error(`Provider "${packageName}" is not installed. Run:\n\n  npm install -g ${packageName}\n`);
+    }
+    globalModulePaths() {
+        const paths = [];
+        for (const command of ["pnpm root -g", "npm root -g"]) {
+            try {
+                const out = execSync(command, { stdio: "pipe" }).toString().trim();
+                if (out)
+                    paths.push(out);
+            }
+            catch { }
+        }
+        return paths;
+    }
+}
+//# sourceMappingURL=ProviderModuleLoader.js.map

package/dist/infrastructure/ai/ProviderModuleLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderModuleLoader.js","sourceRoot":"","sources":["../../../src/infrastructure/ai/ProviderModuleLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,gBAAgB,MAAM,2BAA2B,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IACf,KAAK,GAAG,IAAI,GAAG,EAAmC,CAAC;IAEnD,OAAO,GAAG,IAAI,GAAG,CAAkC;QACnE,CAAC,2BAA2B,EAAE,gBAAgB,CAAC;KAC/C,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAE5B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC3C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,WAAmB;QACxC,4CAA4C;QAC5C,IAAI,CAAC;YACJ,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QAEV,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACnD,IAAI,CAAC;gBACJ,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;gBAC5D,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACX,CAAC;QAED,MAAM,IAAI,KAAK,CACd,aAAa,WAAW,gDAAgD,WAAW,IAAI,CACvF,CAAC;IACH,CAAC;IAEO,iBAAiB;QACxB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,OAAO,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC;gBACJ,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;gBACnE,IAAI,GAAG;oBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACX,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;CACD"}

package/dist/infrastructure/ai/ProviderRegistry.d.ts

@@ -0,0 +1,38 @@
+import { ProviderModuleLoader } from "./ProviderModuleLoader.js";
+/** A `provider:model` string split into its parts. */
+export declare class ModelReference {
+    readonly provider: string;
+    readonly model: string;
+    readonly full: string;
+    private constructor();
+    static parse(value: string, label: string): ModelReference;
+}
+export interface ProviderRequest {
+    reference: ModelReference;
+    /** Package to import; defaults to `@ai-sdk/<provider>`. */
+    packageName?: string;
+    baseURL?: string;
+    /**
+     * Whether a configured `baseURL` should force use of the `create*` factory
+     * even when the module exports a ready-made default instance.
+     *
+     * It matters because a bare default export (e.g. `openai`) ignores baseURL
+     * and would silently talk to the cloud. The chat path sets this; the
+     * embedding path historically does not, and the two are kept distinct here
+     * rather than quietly unified.
+     */
+    preferFactoryWhenBaseUrlSet: boolean;
+}
+/**
+ * Turns a `provider:model` string plus config into a live AI SDK provider.
+ *
+ * Both the embedding and chat paths need the same import-and-instantiate
+ * dance, so it lives here once; the one place they genuinely differ is
+ * expressed as {@link ProviderRequest.preferFactoryWhenBaseUrlSet}.
+ */
+export declare class ProviderRegistry {
+    private readonly loader;
+    private static readonly OPENAI_COMPATIBLE_PROVIDERS;
+    constructor(loader?: ProviderModuleLoader);
+    instantiate(request: ProviderRequest): Promise<unknown>;
+}

package/dist/infrastructure/ai/ProviderRegistry.js

@@ -0,0 +1,63 @@
+import { ProviderModuleLoader } from "./ProviderModuleLoader.js";
+/** A `provider:model` string split into its parts. */
+export class ModelReference {
+    provider;
+    model;
+    full;
+    constructor(provider, model, full) {
+        this.provider = provider;
+        this.model = model;
+        this.full = full;
+    }
+    static parse(value, label) {
+        const colon = value.indexOf(":");
+        if (colon === -1) {
+            throw new Error(`${label} must be in "provider:model" format. Got: "${value}"`);
+        }
+        return new ModelReference(value.slice(0, colon), value.slice(colon + 1), value);
+    }
+}
+/**
+ * Turns a `provider:model` string plus config into a live AI SDK provider.
+ *
+ * Both the embedding and chat paths need the same import-and-instantiate
+ * dance, so it lives here once; the one place they genuinely differ is
+ * expressed as {@link ProviderRequest.preferFactoryWhenBaseUrlSet}.
+ */
+export class ProviderRegistry {
+    loader;
+    static OPENAI_COMPATIBLE_PROVIDERS = new Set([
+        "docker",
+        "lmstudio",
+        "ollama",
+    ]);
+    constructor(loader = new ProviderModuleLoader()) {
+        this.loader = loader;
+    }
+    async instantiate(request) {
+        const providerName = request.reference.provider;
+        const packageName = request.packageName ??
+            (ProviderRegistry.OPENAI_COMPATIBLE_PROVIDERS.has(providerName)
+                ? "@ai-sdk/openai-compatible"
+                : `@ai-sdk/${providerName}`);
+        const module = await this.loader.load(packageName);
+        let instance = module[providerName];
+        const forceFactory = request.preferFactoryWhenBaseUrlSet && Boolean(request.baseURL);
+        if (!instance || forceFactory) {
+            const factoryKey = Object.keys(module).find((k) => k.startsWith("create"));
+            if (factoryKey) {
+                const factory = module[factoryKey];
+                instance = factory({
+                    name: providerName,
+                    ...(request.baseURL ? { baseURL: request.baseURL } : {}),
+                });
+            }
+        }
+        if (!instance) {
+            throw new Error(`Package "${packageName}" has no usable provider export. ` +
+                `Available: ${Object.keys(module).join(", ")}`);
+        }
+        return instance;
+    }
+}
+//# sourceMappingURL=ProviderRegistry.js.map

package/dist/infrastructure/ai/ProviderRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderRegistry.js","sourceRoot":"","sources":["../../../src/infrastructure/ai/ProviderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,sDAAsD;AACtD,MAAM,OAAO,cAAc;IAEhB;IACA;IACA;IAHV,YACU,QAAgB,EAChB,KAAa,EACb,IAAY;QAFZ,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAQ;QACb,SAAI,GAAJ,IAAI,CAAQ;IACnB,CAAC;IAEJ,MAAM,CAAC,KAAK,CAAC,KAAa,EAAE,KAAa;QACxC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACd,GAAG,KAAK,8CAA8C,KAAK,GAAG,CAC9D,CAAC;QACH,CAAC;QACD,OAAO,IAAI,cAAc,CACxB,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EACrB,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EACtB,KAAK,CACL,CAAC;IACH,CAAC;CACD;AAmBD;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAQV;IAPV,MAAM,CAAU,2BAA2B,GAAG,IAAI,GAAG,CAAC;QAC7D,QAAQ;QACR,UAAU;QACV,QAAQ;KACR,CAAC,CAAC;IAEH,YACkB,SAA+B,IAAI,oBAAoB,EAAE;QAAzD,WAAM,GAAN,MAAM,CAAmD;IACxE,CAAC;IAEJ,KAAK,CAAC,WAAW,CAAC,OAAwB;QACzC,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC;QAChD,MAAM,WAAW,GAChB,OAAO,CAAC,WAAW;YACnB,CAAC,gBAAgB,CAAC,2BAA2B,CAAC,GAAG,CAAC,YAAY,CAAC;gBAC9D,CAAC,CAAC,2BAA2B;gBAC7B,CAAC,CAAC,WAAW,YAAY,EAAE,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEnD,IAAI,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;QAEpC,MAAM,YAAY,GACjB,OAAO,CAAC,2BAA2B,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,CAAC,QAAQ,IAAI,YAAY,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACjD,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CACtB,CAAC;YACF,IAAI,UAAU,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAErB,CAAC;gBACb,QAAQ,GAAG,OAAO,CAAC;oBAClB,IAAI,EAAE,YAAY;oBAClB,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxD,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACd,YAAY,WAAW,mCAAmC;gBACzD,cAAc,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/C,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC"}

package/dist/infrastructure/fs/ConfigLoader.d.ts

@@ -0,0 +1,59 @@
+import type { ConfigSource } from "../../domain/config/ConfigSource.js";
+import type { LmgrepConfig } from "../../domain/config/LmgrepConfig.js";
+/**
+ * Loads configuration from two kinds of file, split by what the settings
+ * actually describe.
+ *
+ * **Machine settings** — which model to embed with, which to answer with,
+ * where those servers listen — describe *this computer's* inference setup.
+ * They live in one global file. They used to be settable per project too,
+ * which was the single most confusing thing about lmgrep: the model determines
+ * what a stored vector *means*, so a project file could silently point an
+ * index at incompatible embeddings, and `status` would report an effective
+ * model without saying which of three files produced it.
+ *
+ * **Project settings** — what to ignore, which extensions to index — describe
+ * *this repository*, are worth committing, and mean the same thing on every
+ * machine that checks it out.
+ *
+ * Machine keys found in a project file are reported and ignored rather than
+ * applied. Wanting a different model for one project is a real thing to want;
+ * it is now spelled as a different database (`--database`), because the model
+ * is a property of an index rather than of a directory.
+ */
+export declare class ConfigLoader {
+    /** Settings that describe this machine's inference setup. */
+    private static readonly MACHINE_SCHEMA;
+    /** Settings that describe a repository. */
+    private static readonly PROJECT_SCHEMA;
+    private static readonly FILE_NAME;
+    private static readonly PROJECT_FILE_NAMES;
+    private static readonly DEFAULTS;
+    /** Populated by {@link load}: what was read, and what was ignored. */
+    readonly sources: ConfigSource[];
+    readonly warnings: string[];
+    load(cwd: string): LmgrepConfig;
+    /**
+     * The XDG-compliant global config directory.
+     *   Linux:  $XDG_CONFIG_HOME/lmgrep  or  ~/.config/lmgrep
+     *   macOS:  ~/Library/Application Support/lmgrep
+     */
+    configDirectory(): string;
+    globalConfigPath(): string;
+    /** Path of the project file in `cwd`, whether or not it exists. */
+    projectConfigPath(cwd: string): string;
+    /**
+     * Parse a single machine config file, ignoring the layering.
+     *
+     * `init` rewrites one specific file, so it needs that file's own contents —
+     * merging layers here would copy one file's settings into another.
+     */
+    readFile(path: string): Partial<LmgrepConfig> | undefined;
+    private readMachineFile;
+    private readProjectFile;
+    private parseYaml;
+    private pick;
+    private static machineKeys;
+    private static projectKeys;
+    private validate;
+}