@younndai/lyt-llm 0.9.0

package/dist/adapters/index.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Adapter barrel — re-export every concrete adapter + its config + the
+// per-adapter error types. Callers (and the brief's gold-standard smoke test
+// from block-B Commit 7) reach the adapters through the package root index
+// for a single import statement.
+export { createAiRelayAdapter, } from "./ai-relay.js";
+export { createOllamaAdapter, OllamaUnreachableError, OllamaHttpError, } from "./ollama.js";
+export { createHarnessAdapter, } from "./harness.js";
+export { createByokAdapter } from "./byok.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,uEAAuE;AACvE,6EAA6E;AAC7E,2EAA2E;AAC3E,iCAAiC;AAEjC,OAAO,EACL,oBAAoB,GAIrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,GAGhB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,GAKrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,iBAAiB,EAA2C,MAAM,WAAW,CAAC"}

package/dist/adapters/ollama.d.ts

@@ -0,0 +1,28 @@
+import type { LlmAdapter } from "../types.js";
+export type FetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+}>;
+export interface OllamaAdapterConfig {
+    fetchImpl: FetchLike;
+    endpoint?: string;
+    defaultModel?: string;
+    embedModel?: string;
+    liveSmoke?: boolean;
+}
+export declare class OllamaUnreachableError extends Error {
+    readonly name = "OllamaUnreachableError";
+    constructor(endpoint: string, cause: unknown);
+}
+export declare class OllamaHttpError extends Error {
+    readonly status: number;
+    readonly name = "OllamaHttpError";
+    constructor(status: number, body: unknown);
+}
+export declare function createOllamaAdapter(config: OllamaAdapterConfig): LlmAdapter;
+//# sourceMappingURL=ollama.d.ts.map

package/dist/adapters/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../src/adapters/ollama.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAKV,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KACxE,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAElC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IAIpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAkB,IAAI,4BAA4B;gBACtC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAG7C;AAED,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,MAAM,EAAE,MAAM;IAFhC,SAAkB,IAAI,qBAAqB;gBAEzB,MAAM,EAAE,MAAM,EAC9B,IAAI,EAAE,OAAO;CAIhB;AAaD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,UAAU,CA8E3E"}

package/dist/adapters/ollama.js

@@ -0,0 +1,148 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export class OllamaUnreachableError extends Error {
+    name = "OllamaUnreachableError";
+    constructor(endpoint, cause) {
+        super(`Ollama endpoint unreachable at ${endpoint}: ${stringifyCause(cause)}`);
+    }
+}
+export class OllamaHttpError extends Error {
+    status;
+    name = "OllamaHttpError";
+    constructor(status, body) {
+        super(`Ollama HTTP ${status}: ${stringifyCause(body)}`);
+        this.status = status;
+    }
+}
+function stringifyCause(cause) {
+    if (cause instanceof Error)
+        return cause.message;
+    try {
+        return JSON.stringify(cause);
+    }
+    catch {
+        return String(cause);
+    }
+}
+const DEFAULT_ENDPOINT = "http://localhost:11434";
+export function createOllamaAdapter(config) {
+    const endpoint = (config.endpoint ?? DEFAULT_ENDPOINT).replace(/\/$/, "");
+    async function post(path, body) {
+        let res;
+        try {
+            res = await config.fetchImpl(`${endpoint}${path}`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+            });
+        }
+        catch (err) {
+            throw new OllamaUnreachableError(endpoint, err);
+        }
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({ error: "<unparseable>" }));
+            throw new OllamaHttpError(res.status, body);
+        }
+        return await res.json();
+    }
+    return {
+        source: "ollama",
+        supports(mode) {
+            if (mode === "embed")
+                return Boolean(config.embedModel);
+            return true;
+        },
+        async generate(req) {
+            const model = req.model ?? config.defaultModel;
+            if (!model) {
+                throw new Error("ollama adapter requires either GenerateRequest.model or OllamaAdapterConfig.defaultModel");
+            }
+            const messages = [];
+            if (req.system)
+                messages.push({ role: "system", content: req.system });
+            messages.push({ role: "user", content: req.prompt });
+            const payload = await post("/v1/chat/completions", {
+                model,
+                messages,
+                ...(req.maxTokens !== undefined ? { max_tokens: req.maxTokens } : {}),
+                ...(req.temperature !== undefined ? { temperature: req.temperature } : {}),
+            });
+            const parsed = parseChatCompletion(payload);
+            return {
+                text: parsed.text,
+                sourceUsed: "ollama",
+                modelUsed: parsed.model ?? model,
+                tokensIn: parsed.tokensIn,
+                tokensOut: parsed.tokensOut,
+                // Local compute — zero marginal $ cost per arc §6.7 cost-shape table.
+                // Hardware cost is the user's responsibility and not surfaced here.
+                costUsd: 0,
+            };
+        },
+        async embed(req) {
+            const model = req.model ?? config.embedModel;
+            if (!model) {
+                throw new Error("ollama adapter requires either EmbedRequest.model or OllamaAdapterConfig.embedModel for embeddings");
+            }
+            const payload = await post("/v1/embeddings", {
+                model,
+                input: req.texts,
+            });
+            const parsed = parseEmbeddings(payload);
+            return {
+                vectors: parsed.vectors,
+                sourceUsed: "ollama",
+                modelUsed: parsed.model ?? model,
+                tokensIn: parsed.tokensIn,
+                costUsd: 0,
+            };
+        },
+    };
+}
+function parseChatCompletion(payload) {
+    if (!payload || typeof payload !== "object") {
+        throw new Error(`ollama: unparseable chat-completion response: ${JSON.stringify(payload)}`);
+    }
+    const p = payload;
+    const text = p.choices?.[0]?.message?.content;
+    if (typeof text !== "string") {
+        throw new Error(`ollama: chat-completion missing choices[0].message.content: ${JSON.stringify(payload)}`);
+    }
+    return {
+        text,
+        ...(p.model ? { model: p.model } : {}),
+        tokensIn: p.usage?.prompt_tokens ?? 0,
+        tokensOut: p.usage?.completion_tokens ?? 0,
+    };
+}
+function parseEmbeddings(payload) {
+    if (!payload || typeof payload !== "object") {
+        throw new Error(`ollama: unparseable embeddings response: ${JSON.stringify(payload)}`);
+    }
+    const p = payload;
+    const vectors = (p.data ?? []).map((d, idx) => {
+        if (!Array.isArray(d.embedding)) {
+            throw new Error(`ollama: data[${idx}].embedding is not a vector`);
+        }
+        return d.embedding;
+    });
+    return {
+        vectors,
+        ...(p.model ? { model: p.model } : {}),
+        tokensIn: p.usage?.prompt_tokens ?? 0,
+    };
+}
+//# sourceMappingURL=ollama.js.map

package/dist/adapters/ollama.js.map

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

package/dist/cost-budget.d.ts

@@ -0,0 +1,11 @@
+import { type CostBudget } from "./types.js";
+export interface CostTracker {
+    record(usd: number): void;
+    assertWithin(estimatedUsd: number): void;
+    totalUsd(): number;
+    callCount(): number;
+    reset(): void;
+    budget(): CostBudget | null;
+}
+export declare function createCostTracker(budget?: CostBudget): CostTracker;
+//# sourceMappingURL=cost-budget.d.ts.map

package/dist/cost-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-budget.d.ts","sourceRoot":"","sources":["../src/cost-budget.ts"],"names":[],"mappings":"AA4BA,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtE,MAAM,WAAW,WAAW;IAE1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAI1B,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,IAAI,MAAM,CAAC;IACnB,SAAS,IAAI,MAAM,CAAC;IACpB,KAAK,IAAI,IAAI,CAAC;IAGd,MAAM,IAAI,UAAU,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,CA8ClE"}

package/dist/cost-budget.js

@@ -0,0 +1,71 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Per-run cost tracker.
+//
+// Per arc-thoughts §6.7 ("cost-shape lock") + brief Open Decision #3 default
+// (recommended: hard-stop on per-run, warn-on-monthly). The CostTracker
+// accumulates per-call cost across the current run; the gateway calls
+// `assertWithin()` BEFORE invoking the adapter so a known-over-budget call
+// never even reaches the network.
+//
+// Implementation is in-memory + per-gateway-instance; block-B Commit 4 hands
+// the gateway a fresh CostTracker at 5-step protocol step 3 start and reads
+// `totalCostUsd()` at step 4 commit to populate `automator_runs.llm_cost_usd`.
+import { CostBudgetExceededError } from "./types.js";
+export function createCostTracker(budget) {
+    let accumulated = 0;
+    let calls = 0;
+    const snapshot = budget
+        ? {
+            perRunUsd: budget.perRunUsd,
+            ...(budget.monthlyUsd !== undefined ? { monthlyUsd: budget.monthlyUsd } : {}),
+        }
+        : null;
+    return {
+        record(usd) {
+            if (!Number.isFinite(usd) || usd < 0) {
+                throw new RangeError(`CostTracker.record() requires a non-negative finite number; got ${usd}`);
+            }
+            accumulated += usd;
+            calls += 1;
+        },
+        assertWithin(estimatedUsd) {
+            if (!Number.isFinite(estimatedUsd) || estimatedUsd < 0) {
+                throw new RangeError(`CostTracker.assertWithin() requires a non-negative finite number; got ${estimatedUsd}`);
+            }
+            if (!snapshot)
+                return;
+            const projected = accumulated + estimatedUsd;
+            if (projected > snapshot.perRunUsd) {
+                throw new CostBudgetExceededError(snapshot.perRunUsd, accumulated, estimatedUsd);
+            }
+        },
+        totalUsd() {
+            return accumulated;
+        },
+        callCount() {
+            return calls;
+        },
+        reset() {
+            accumulated = 0;
+            calls = 0;
+        },
+        budget() {
+            return snapshot;
+        },
+    };
+}
+//# sourceMappingURL=cost-budget.js.map

package/dist/cost-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-budget.js","sourceRoot":"","sources":["../src/cost-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,wBAAwB;AACxB,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,sEAAsE;AACtE,2EAA2E;AAC3E,kCAAkC;AAClC,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,+EAA+E;AAE/E,OAAO,EAAE,uBAAuB,EAAmB,MAAM,YAAY,CAAC;AAiBtE,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,QAAQ,GAAsB,MAAM;QACxC,CAAC,CAAC;YACE,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9E;QACH,CAAC,CAAC,IAAI,CAAC;IAET,OAAO;QACL,MAAM,CAAC,GAAW;YAChB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,UAAU,CAClB,mEAAmE,GAAG,EAAE,CACzE,CAAC;YACJ,CAAC;YACD,WAAW,IAAI,GAAG,CAAC;YACnB,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;QACD,YAAY,CAAC,YAAoB;YAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;gBACvD,MAAM,IAAI,UAAU,CAClB,yEAAyE,YAAY,EAAE,CACxF,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACtB,MAAM,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;YAC7C,IAAI,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACnC,MAAM,IAAI,uBAAuB,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;QACD,QAAQ;YACN,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,SAAS;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK;YACH,WAAW,GAAG,CAAC,CAAC;YAChB,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;QACD,MAAM;YACJ,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { LlmGateway, LlmGatewayConfig } from "./types.js";
+export declare function createLlmGateway(config?: LlmGatewayConfig): LlmGateway;
+export type { CostBudget, EmbedRequest, EmbedResult, GenerateRequest, GenerateResult, HardConstraint, LlmAdapter, LlmCapability, LlmGateway, LlmGatewayConfig, LlmSource, MemscopeContext, } from "./types.js";
+export { CostBudgetExceededError, HardConstraintViolationError, NoEligibleAdapterError, UnknownHardConstraintError, } from "./types.js";
+export { createCostTracker, type CostTracker } from "./cost-budget.js";
+export { DEFAULT_SOURCE_PREFERENCE, firstViolation, selectAdapter, type SelectAdapterArgs, } from "./routing.js";
+export { createAiRelayAdapter, createOllamaAdapter, createHarnessAdapter, createByokAdapter, OllamaUnreachableError, OllamaHttpError, type AiRelayAdapterConfig, type AiRelayGenerateFn, type AiRelayEmbedFn, type OllamaAdapterConfig, type FetchLike, type HarnessAdapterConfig, type HarnessInvokeArgs, type HarnessInvokeResult, type HarnessInvokeFn, type ByokAdapterConfig, type ByokClient, } from "./adapters/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAMV,UAAU,EACV,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,gBAAqB,GAAG,UAAU,CA0D1E;AAKD,YAAY,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,cAAc,EACd,cAAc,EACd,UAAU,EACV,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,aAAa,EACb,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,95 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// @younndai/lyt-llm — public entry point.
+//
+// Per arc-thoughts §6.12 (LOCKED 2026-05-27): a multi-source LLM gateway
+// composing four adapters (ai-relay external / Ollama local / Harness
+// CC-Codex / BYOK) behind a single createLlmGateway() surface.
+//
+// In Commit 2 the gateway ships standalone. The lyt-runner op composition
+// (`std:llm.generate@v1`, `std:llm.stream@v1`, `std:llm.generate_object@v1`,
+// `std:llm.embed@v1`) is deferred to block-B Commit 4 alongside the 5-step
+// protocol — Commit 4 imports `createLlmGateway` + `registerLlmOps(runner,
+// gateway)` (the latter shipped here in a future iteration) and wires them
+// into the lyt-runner factory's `createLytRunner(config)`.
+//
+// Reference: zen-runner/src/index.ts L200-300 is the canonical Pattern A
+// composition template; this gateway mirrors its factory + injected-deps
+// shape so lyt-runner can compose both with identical ergonomics.
+import { createCostTracker } from "./cost-budget.js";
+import { DEFAULT_SOURCE_PREFERENCE, selectAdapter } from "./routing.js";
+export function createLlmGateway(config = {}) {
+    const adapters = { ...(config.adapters ?? {}) };
+    const defaultPreference = config.preference ?? [...DEFAULT_SOURCE_PREFERENCE];
+    const tracker = createCostTracker(config.costBudget);
+    function preferenceFor(req) {
+        return req.sourcePreference && req.sourcePreference.length > 0
+            ? req.sourcePreference
+            : defaultPreference;
+    }
+    return {
+        async generate(req) {
+            const adapter = selectAdapter({
+                mode: "generate",
+                preference: preferenceFor(req),
+                adapters,
+                ...(req.hardConstraints !== undefined ? { hardConstraints: req.hardConstraints } : {}),
+                ...(req.memscope !== undefined ? { memscope: req.memscope } : {}),
+            });
+            // Pre-flight budget check. Per arc §6.7 cost-shape lock the per-run
+            // hard-stop fires BEFORE the call so we never burn cost on a request
+            // that's already over budget. The estimate is 0 here — we don't have
+            // a cheap pre-call cost estimate without tokenising the prompt
+            // (block-D will integrate @younndai/ai-relay's `estimateCost`); the
+            // assertWithin(0) call still throws if accumulated already exceeds
+            // the budget (edge case after a previous call put us over).
+            tracker.assertWithin(0);
+            const result = await adapter.generate(req);
+            tracker.record(result.costUsd);
+            return result;
+        },
+        async embed(req) {
+            const adapter = selectAdapter({
+                mode: "embed",
+                preference: preferenceFor(req),
+                adapters,
+                ...(req.hardConstraints !== undefined ? { hardConstraints: req.hardConstraints } : {}),
+                ...(req.memscope !== undefined ? { memscope: req.memscope } : {}),
+            });
+            tracker.assertWithin(0);
+            const result = await adapter.embed(req);
+            tracker.record(result.costUsd);
+            return result;
+        },
+        totalCostUsd() {
+            return tracker.totalUsd();
+        },
+        totalCalls() {
+            return tracker.callCount();
+        },
+        resetCostTracker() {
+            tracker.reset();
+        },
+        registeredSources() {
+            return Object.keys(adapters).filter((s) => adapters[s] !== undefined);
+        },
+    };
+}
+export { CostBudgetExceededError, HardConstraintViolationError, NoEligibleAdapterError, UnknownHardConstraintError, } from "./types.js";
+export { createCostTracker } from "./cost-budget.js";
+export { DEFAULT_SOURCE_PREFERENCE, firstViolation, selectAdapter, } from "./routing.js";
+export { createAiRelayAdapter, createOllamaAdapter, createHarnessAdapter, createByokAdapter, OllamaUnreachableError, OllamaHttpError, } from "./adapters/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/routing.d.ts

@@ -0,0 +1,12 @@
+import { HardConstraintViolationError, type LlmAdapter, type LlmSource, type HardConstraint, type MemscopeContext } from "./types.js";
+export declare const DEFAULT_SOURCE_PREFERENCE: readonly LlmSource[];
+export interface SelectAdapterArgs {
+    mode: "generate" | "embed";
+    preference: LlmSource[];
+    adapters: Partial<Record<LlmSource, LlmAdapter>>;
+    hardConstraints?: HardConstraint[];
+    memscope?: MemscopeContext;
+}
+export declare function selectAdapter(args: SelectAdapterArgs): LlmAdapter;
+export declare function firstViolation(source: LlmSource, constraints: HardConstraint[], memscope?: MemscopeContext): HardConstraintViolationError | null;
+//# sourceMappingURL=routing.d.ts.map

package/dist/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":"AAmCA,OAAO,EACL,4BAA4B,EAC5B,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EAGrB,MAAM,YAAY,CAAC;AAKpB,eAAO,MAAM,yBAAyB,EAAE,SAAS,SAAS,EAKxD,CAAC;AAYH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IACjD,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAkCjE;AAKD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,cAAc,EAAE,EAC7B,QAAQ,CAAC,EAAE,eAAe,GACzB,4BAA4B,GAAG,IAAI,CAQrC"}

package/dist/routing.js

@@ -0,0 +1,149 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Routing policy engine.
+//
+// Per arc-thoughts §6.7 + §6.12: each @AUTOMATOR declares a
+// `llm_source_preference` (ordered list) + `llm_hard_constraints` (gating
+// predicates). The gateway walks the preference order, filters by
+// hard-constraints + adapter availability + mode support, and picks the
+// first match. No fallback ranking — explicit preference order is the
+// contract.
+//
+// Default preference is `[harness, ai-relay, byok, ollama]` matching arc
+// §6.7 cost-shape table: harness is the "use the €20 you already pay"
+// adoption lever (zero marginal cost), ai-relay is the cheap-tier default
+// for grunt work, byok is power-user direct, ollama is the local fallback.
+//
+// Constraint evaluation is fail-loud: unknown constraint kinds throw
+// UnknownHardConstraintError rather than being silently ignored. Per arc
+// §6.7: "hard_constraint is a hard contract; soft preferences belong in
+// source_preference".
+import { HardConstraintViolationError, UnknownHardConstraintError, NoEligibleAdapterError, } from "./types.js";
+// Brief @TASK clause (4): "default `[cheap, harness, byok, local]` per arc §6.10".
+// Translated to source vocabulary: cheap → ai-relay; harness → harness;
+// byok → byok; local → ollama. Order preserved from arc §6.10 default.
+export const DEFAULT_SOURCE_PREFERENCE = Object.freeze([
+    "ai-relay",
+    "harness",
+    "byok",
+    "ollama",
+]);
+const KNOWN_CONSTRAINT_KINDS = new Set([
+    "local_only",
+    "never_external_when_private_memscope",
+    "max_cost_per_run_usd",
+    "provider",
+]);
+const EXTERNAL_SOURCES = new Set(["ai-relay", "byok"]);
+const LOCAL_SOURCES = new Set(["ollama", "harness"]);
+// Walk preference in order; return the first adapter that (a) is registered,
+// (b) supports the requested mode, and (c) passes every hard constraint.
+// Throws NoEligibleAdapterError if no candidate qualifies — the caller
+// surfaces this as a structured automator_run_events row.
+export function selectAdapter(args) {
+    const constraints = args.hardConstraints ?? [];
+    // Validate constraint kinds up-front so we fail-loud BEFORE iterating
+    // preference. Defensive — keeps the "unknown constraint" diagnostic clean.
+    for (const c of constraints) {
+        if (!KNOWN_CONSTRAINT_KINDS.has(c.kind)) {
+            throw new UnknownHardConstraintError(c.kind);
+        }
+    }
+    const reasons = [];
+    for (const source of args.preference) {
+        const adapter = args.adapters[source];
+        if (!adapter) {
+            reasons.push(`${source}: no adapter registered`);
+            continue;
+        }
+        if (!adapter.supports(args.mode)) {
+            reasons.push(`${source}: does not support mode=${args.mode}`);
+            continue;
+        }
+        const violation = firstViolation(source, constraints, args.memscope);
+        if (violation) {
+            reasons.push(`${source}: ${violation.constraintKind} (${violation.detail})`);
+            continue;
+        }
+        return adapter;
+    }
+    throw new NoEligibleAdapterError(args.mode, args.preference, reasons.length > 0 ? reasons.join("; ") : "preference list is empty");
+}
+// Public helper for adapter-shopping callers (e.g., the lyt-runner pre-write
+// hook from Commit 5 may pre-validate constraints before issuing the call).
+// Returns the first violation, or null if every constraint is satisfied.
+export function firstViolation(source, constraints, memscope) {
+    for (const c of constraints) {
+        const detail = evaluateOne(source, c, memscope);
+        if (detail !== null) {
+            return new HardConstraintViolationError(c.kind, source, detail);
+        }
+    }
+    return null;
+}
+// Per-constraint evaluator. Returns a non-null detail string when the
+// constraint REJECTS this source, or null when the constraint accepts it.
+//
+// New constraint kinds must (1) be added to KNOWN_CONSTRAINT_KINDS,
+// (2) get a branch here, and (3) be documented in
+// the LYT design doc `lyt-yai-domain.md` §`@AUTOMATOR`.
+function evaluateOne(source, c, memscope) {
+    switch (c.kind) {
+        case "local_only": {
+            if (!LOCAL_SOURCES.has(source)) {
+                return `source ${source} is external; only ${[...LOCAL_SOURCES].join(",")} allowed`;
+            }
+            return null;
+        }
+        case "never_external_when_private_memscope": {
+            if (memscope?.defaultView === "private" && EXTERNAL_SOURCES.has(source)) {
+                return `memscope default_view=private; source ${source} is external`;
+            }
+            return null;
+        }
+        case "max_cost_per_run_usd": {
+            // Adapter-mode constraint is advisory at routing time — actual
+            // enforcement happens in the cost-budget tracker at call time. We
+            // simply confirm the args shape is well-formed; if not, treat as
+            // rejection so the constraint can't be silently misconfigured.
+            const usd = c.args?.usd;
+            if (typeof usd !== "number" || !Number.isFinite(usd) || usd < 0) {
+                return `max_cost_per_run_usd requires args.usd:number>=0; got ${JSON.stringify(c.args)}`;
+            }
+            return null;
+        }
+        case "provider": {
+            // Pin to a specific provider name. Source-level scoping: ai-relay and
+            // byok are the provider-bearing surfaces; ollama and harness are
+            // implicitly local/integrated and don't honour provider pinning.
+            const requested = c.args?.name;
+            if (typeof requested !== "string" || requested.length === 0) {
+                return `provider requires args.name:string; got ${JSON.stringify(c.args)}`;
+            }
+            if (source === "ollama" || source === "harness") {
+                return `provider pinning ('${requested}') is incompatible with source '${source}'`;
+            }
+            return null;
+        }
+        default: {
+            // Unreachable — KNOWN_CONSTRAINT_KINDS is checked at the top of
+            // selectAdapter. Defensive against the gate being widened without
+            // a matching switch arm.
+            throw new UnknownHardConstraintError(c.kind);
+        }
+    }
+}
+//# sourceMappingURL=routing.js.map

package/dist/routing.js.map

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