@younndai/lyt-llm 0.9.0

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+export type LlmSource = "ai-relay" | "ollama" | "harness" | "byok";
+export type LlmCapability = "grunt" | "reasoning" | "embed" | "structured";
+export interface HardConstraint {
+    kind: string;
+    args?: Record<string, unknown>;
+}
+export interface CostBudget {
+    perRunUsd: number;
+    monthlyUsd?: number;
+}
+export interface MemscopeContext {
+    defaultView?: "private" | "group" | "public";
+    redactPiiV3?: boolean;
+}
+export interface GenerateRequest {
+    prompt: string;
+    system?: string;
+    capability?: LlmCapability;
+    sourcePreference?: LlmSource[];
+    hardConstraints?: HardConstraint[];
+    memscope?: MemscopeContext;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface GenerateResult {
+    text: string;
+    sourceUsed: LlmSource;
+    modelUsed: string;
+    tokensIn: number;
+    tokensOut: number;
+    costUsd: number;
+}
+export interface EmbedRequest {
+    texts: string[];
+    sourcePreference?: LlmSource[];
+    hardConstraints?: HardConstraint[];
+    memscope?: MemscopeContext;
+    model?: string;
+}
+export interface EmbedResult {
+    vectors: number[][];
+    sourceUsed: LlmSource;
+    modelUsed: string;
+    tokensIn: number;
+    costUsd: number;
+}
+export interface LlmAdapter {
+    readonly source: LlmSource;
+    supports(mode: "generate" | "embed"): boolean;
+    generate(req: GenerateRequest): Promise<GenerateResult>;
+    embed(req: EmbedRequest): Promise<EmbedResult>;
+}
+export interface LlmGatewayConfig {
+    preference?: LlmSource[];
+    costBudget?: CostBudget;
+    adapters?: Partial<Record<LlmSource, LlmAdapter>>;
+}
+export interface LlmGateway {
+    generate(req: GenerateRequest): Promise<GenerateResult>;
+    embed(req: EmbedRequest): Promise<EmbedResult>;
+    totalCostUsd(): number;
+    totalCalls(): number;
+    resetCostTracker(): void;
+    registeredSources(): LlmSource[];
+}
+export declare class NoEligibleAdapterError extends Error {
+    readonly mode: "generate" | "embed";
+    readonly preference: LlmSource[];
+    readonly reason: string;
+    readonly name = "NoEligibleAdapterError";
+    constructor(mode: "generate" | "embed", preference: LlmSource[], reason: string);
+}
+export declare class CostBudgetExceededError extends Error {
+    readonly budgetUsd: number;
+    readonly accumulatedUsd: number;
+    readonly attemptedUsd: number;
+    readonly name = "CostBudgetExceededError";
+    constructor(budgetUsd: number, accumulatedUsd: number, attemptedUsd: number);
+}
+export declare class HardConstraintViolationError extends Error {
+    readonly constraintKind: string;
+    readonly source: LlmSource;
+    readonly detail: string;
+    readonly name = "HardConstraintViolationError";
+    constructor(constraintKind: string, source: LlmSource, detail: string);
+}
+export declare class UnknownHardConstraintError extends Error {
+    readonly constraintKind: string;
+    readonly name = "UnknownHardConstraintError";
+    constructor(constraintKind: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,63 @@
+/*
+ * 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.
+ */
+// Errors surfaced at the gateway boundary. Each carries enough context for
+// the lyt-runner pre-write hook (block-B Commit 5) to write a structured
+// automator_run_events row.
+export class NoEligibleAdapterError extends Error {
+    mode;
+    preference;
+    reason;
+    name = "NoEligibleAdapterError";
+    constructor(mode, preference, reason) {
+        super(`No eligible LLM adapter for mode=${mode} after applying preference=[${preference.join(",")}]: ${reason}`);
+        this.mode = mode;
+        this.preference = preference;
+        this.reason = reason;
+    }
+}
+export class CostBudgetExceededError extends Error {
+    budgetUsd;
+    accumulatedUsd;
+    attemptedUsd;
+    name = "CostBudgetExceededError";
+    constructor(budgetUsd, accumulatedUsd, attemptedUsd) {
+        super(`Cost budget exceeded: budget=${budgetUsd.toFixed(4)}, accumulated=${accumulatedUsd.toFixed(4)}, this-call=${attemptedUsd.toFixed(4)}`);
+        this.budgetUsd = budgetUsd;
+        this.accumulatedUsd = accumulatedUsd;
+        this.attemptedUsd = attemptedUsd;
+    }
+}
+export class HardConstraintViolationError extends Error {
+    constraintKind;
+    source;
+    detail;
+    name = "HardConstraintViolationError";
+    constructor(constraintKind, source, detail) {
+        super(`Hard constraint '${constraintKind}' rejects source '${source}': ${detail}`);
+        this.constraintKind = constraintKind;
+        this.source = source;
+        this.detail = detail;
+    }
+}
+export class UnknownHardConstraintError extends Error {
+    constraintKind;
+    name = "UnknownHardConstraintError";
+    constructor(constraintKind) {
+        super(`Unknown hard constraint kind '${constraintKind}'. Known kinds: local_only, never_external_when_private_memscope, max_cost_per_run_usd, provider`);
+        this.constraintKind = constraintKind;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoJH,2EAA2E;AAC3E,yEAAyE;AACzE,4BAA4B;AAE5B,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAG7B;IACA;IACA;IAJA,IAAI,GAAG,wBAAwB,CAAC;IAClD,YACkB,IAA0B,EAC1B,UAAuB,EACvB,MAAc;QAE9B,KAAK,CACH,oCAAoC,IAAI,+BAA+B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,MAAM,EAAE,CAC1G,CAAC;QANc,SAAI,GAAJ,IAAI,CAAsB;QAC1B,eAAU,GAAV,UAAU,CAAa;QACvB,WAAM,GAAN,MAAM,CAAQ;IAKhC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAG9B;IACA;IACA;IAJA,IAAI,GAAG,yBAAyB,CAAC;IACnD,YACkB,SAAiB,EACjB,cAAsB,EACtB,YAAoB;QAEpC,KAAK,CACH,gCAAgC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CACvI,CAAC;QANc,cAAS,GAAT,SAAS,CAAQ;QACjB,mBAAc,GAAd,cAAc,CAAQ;QACtB,iBAAY,GAAZ,YAAY,CAAQ;IAKtC,CAAC;CACF;AAED,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAGnC;IACA;IACA;IAJA,IAAI,GAAG,8BAA8B,CAAC;IACxD,YACkB,cAAsB,EACtB,MAAiB,EACjB,MAAc;QAE9B,KAAK,CAAC,oBAAoB,cAAc,qBAAqB,MAAM,MAAM,MAAM,EAAE,CAAC,CAAC;QAJnE,mBAAc,GAAd,cAAc,CAAQ;QACtB,WAAM,GAAN,MAAM,CAAW;QACjB,WAAM,GAAN,MAAM,CAAQ;IAGhC,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAEvB;IADV,IAAI,GAAG,4BAA4B,CAAC;IACtD,YAA4B,cAAsB;QAChD,KAAK,CACH,iCAAiC,cAAc,kGAAkG,CAClJ,CAAC;QAHwB,mBAAc,GAAd,cAAc,CAAQ;IAIlD,CAAC;CACF"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@younndai/lyt-llm",
+  "version": "0.9.0",
+  "description": "Lyt LLM gateway — multi-source LLM routing for AI-assisted vault operations. Composes 4 adapters (ai-relay external / Ollama local / Claude Code-Codex harness / BYOK) behind a single createLlmGateway() surface, with per-automator source preferences, hard constraints, and a per-run cost-budget hard-stop. Registers std:llm.* ops with @younndai/lyt-runner.",
+  "homepage": "https://linkyourthink.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/younndai/lyt",
+    "directory": "packages/lyt-llm"
+  },
+  "author": {
+    "name": "MARLINK TRADING SRL (YounndAI)",
+    "url": "https://younndai.com"
+  },
+  "contributors": [
+    {
+      "name": "Alexandru Mareș",
+      "url": "https://allemaar.com"
+    }
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=20.9",
+    "npm": ">=10"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rimraf --glob dist .turbo *.tsbuildinfo",
+    "prepack": "npm run clean && npm run build",
+    "prepublishOnly": "node ../../scripts/check-no-vendored-deps.mjs --root ../.."
+  },
+  "dependencies": {
+    "@younndai/ai-relay": "^3.0.0"
+  },
+  "devDependencies": {
+    "@lyt/typescript-config": "*",
+    "@types/node": "^22.10.5",
+    "rimraf": "*",
+    "typescript": "*",
+    "vitest": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "lyt",
+    "llm",
+    "ai",
+    "ollama",
+    "byok",
+    "younndai"
+  ]
+}