@lyse-labs/lyse 0.1.0-alpha.2 → 0.2.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (140) hide show
  1. package/LICENSE +0 -5
  2. package/dist/cli.js +67 -11
  3. package/dist/cli.js.map +1 -1
  4. package/dist/commands/__tests__/add-ci-gate.test.d.ts +1 -0
  5. package/dist/commands/__tests__/add-ci-gate.test.js +149 -0
  6. package/dist/commands/__tests__/add-ci-gate.test.js.map +1 -0
  7. package/dist/commands/add-ci-gate.d.ts +26 -0
  8. package/dist/commands/add-ci-gate.js +429 -0
  9. package/dist/commands/add-ci-gate.js.map +1 -0
  10. package/dist/commands/audit-pipeline.js +1 -1
  11. package/dist/commands/audit-pipeline.js.map +1 -1
  12. package/dist/commands/fix.d.ts +8 -8
  13. package/dist/commands/init.d.ts +3 -3
  14. package/dist/commands/init.js +1 -1
  15. package/dist/commands/init.js.map +1 -1
  16. package/dist/commands/mcp-setup.js +1 -1
  17. package/dist/commands/mcp-setup.js.map +1 -1
  18. package/dist/config/schema.d.ts +14 -14
  19. package/dist/llm/__tests__/layer4-stage.test.d.ts +1 -0
  20. package/dist/llm/__tests__/layer4-stage.test.js +157 -0
  21. package/dist/llm/__tests__/layer4-stage.test.js.map +1 -0
  22. package/dist/llm/__tests__/validator.test.d.ts +1 -0
  23. package/dist/llm/__tests__/validator.test.js +156 -0
  24. package/dist/llm/__tests__/validator.test.js.map +1 -0
  25. package/dist/llm/connectors/__tests__/anthropic-adapter.test.d.ts +1 -0
  26. package/dist/llm/connectors/__tests__/anthropic-adapter.test.js +99 -0
  27. package/dist/llm/connectors/__tests__/anthropic-adapter.test.js.map +1 -0
  28. package/dist/llm/connectors/__tests__/cache.test.d.ts +1 -0
  29. package/dist/llm/connectors/__tests__/cache.test.js +50 -0
  30. package/dist/llm/connectors/__tests__/cache.test.js.map +1 -0
  31. package/dist/llm/connectors/__tests__/noop-adapter.test.d.ts +1 -0
  32. package/dist/llm/connectors/__tests__/noop-adapter.test.js +21 -0
  33. package/dist/llm/connectors/__tests__/noop-adapter.test.js.map +1 -0
  34. package/dist/llm/connectors/__tests__/openai-compatible-adapter.test.d.ts +1 -0
  35. package/dist/llm/connectors/__tests__/openai-compatible-adapter.test.js +82 -0
  36. package/dist/llm/connectors/__tests__/openai-compatible-adapter.test.js.map +1 -0
  37. package/dist/llm/connectors/__tests__/resolver.test.d.ts +1 -0
  38. package/dist/llm/connectors/__tests__/resolver.test.js +140 -0
  39. package/dist/llm/connectors/__tests__/resolver.test.js.map +1 -0
  40. package/dist/llm/connectors/anthropic-adapter.d.ts +12 -0
  41. package/dist/llm/connectors/anthropic-adapter.js +57 -0
  42. package/dist/llm/connectors/anthropic-adapter.js.map +1 -0
  43. package/dist/llm/connectors/cache.d.ts +15 -0
  44. package/dist/llm/connectors/cache.js +57 -0
  45. package/dist/llm/connectors/cache.js.map +1 -0
  46. package/dist/llm/connectors/noop-adapter.d.ts +4 -0
  47. package/dist/llm/connectors/noop-adapter.js +12 -0
  48. package/dist/llm/connectors/noop-adapter.js.map +1 -0
  49. package/dist/llm/connectors/openai-compatible-adapter.d.ts +13 -0
  50. package/dist/llm/connectors/openai-compatible-adapter.js +47 -0
  51. package/dist/llm/connectors/openai-compatible-adapter.js.map +1 -0
  52. package/dist/llm/connectors/resolver.d.ts +9 -0
  53. package/dist/llm/connectors/resolver.js +162 -0
  54. package/dist/llm/connectors/resolver.js.map +1 -0
  55. package/dist/llm/connectors/types.d.ts +25 -0
  56. package/dist/llm/connectors/types.js +13 -0
  57. package/dist/llm/connectors/types.js.map +1 -0
  58. package/dist/llm/layer4-stage.d.ts +8 -6
  59. package/dist/llm/layer4-stage.js +145 -9
  60. package/dist/llm/layer4-stage.js.map +1 -1
  61. package/dist/llm/rubric-stub.d.ts +8 -0
  62. package/dist/llm/rubric-stub.js +4 -0
  63. package/dist/llm/rubric-stub.js.map +1 -0
  64. package/dist/llm/validator.d.ts +18 -0
  65. package/dist/llm/validator.js +81 -0
  66. package/dist/llm/validator.js.map +1 -0
  67. package/dist/parsers/ai-tokens.d.ts +10 -0
  68. package/dist/parsers/ai-tokens.js +156 -0
  69. package/dist/parsers/ai-tokens.js.map +1 -0
  70. package/dist/reliability/catalogue/__tests__/sub-axes.test.js +13 -3
  71. package/dist/reliability/catalogue/__tests__/sub-axes.test.js.map +1 -1
  72. package/dist/reliability/catalogue/sub-axes.js +16 -0
  73. package/dist/reliability/catalogue/sub-axes.js.map +1 -1
  74. package/dist/reliability/types.d.ts +1 -1
  75. package/dist/rule-runner.js +1 -1
  76. package/dist/rule-runner.js.map +1 -1
  77. package/dist/rules/ai-governance-ai-content-live-region.d.ts +11 -0
  78. package/dist/rules/ai-governance-ai-content-live-region.js +304 -0
  79. package/dist/rules/ai-governance-ai-content-live-region.js.map +1 -0
  80. package/dist/rules/ai-governance-ai-loading-error-states.d.ts +9 -0
  81. package/dist/rules/ai-governance-ai-loading-error-states.js +214 -0
  82. package/dist/rules/ai-governance-ai-loading-error-states.js.map +1 -0
  83. package/dist/rules/ai-governance-ai-marker-anti-patterns.d.ts +15 -0
  84. package/dist/rules/ai-governance-ai-marker-anti-patterns.js +178 -0
  85. package/dist/rules/ai-governance-ai-marker-anti-patterns.js.map +1 -0
  86. package/dist/rules/ai-governance-ai-marker-component-present.d.ts +28 -0
  87. package/dist/rules/ai-governance-ai-marker-component-present.js +320 -0
  88. package/dist/rules/ai-governance-ai-marker-component-present.js.map +1 -0
  89. package/dist/rules/ai-governance-ai-token-requires-marker.d.ts +17 -0
  90. package/dist/rules/ai-governance-ai-token-requires-marker.js +206 -0
  91. package/dist/rules/ai-governance-ai-token-requires-marker.js.map +1 -0
  92. package/dist/rules/ai-governance-ai-tokens-reserved.d.ts +8 -0
  93. package/dist/rules/ai-governance-ai-tokens-reserved.js +85 -0
  94. package/dist/rules/ai-governance-ai-tokens-reserved.js.map +1 -0
  95. package/dist/rules/ai-governance-disclaimer-present.d.ts +18 -0
  96. package/dist/rules/ai-governance-disclaimer-present.js +210 -0
  97. package/dist/rules/ai-governance-disclaimer-present.js.map +1 -0
  98. package/dist/rules/ai-governance-explainability-affordance.d.ts +14 -0
  99. package/dist/rules/ai-governance-explainability-affordance.js +196 -0
  100. package/dist/rules/ai-governance-explainability-affordance.js.map +1 -0
  101. package/dist/rules/ai-governance-feedback-control-present.d.ts +19 -0
  102. package/dist/rules/ai-governance-feedback-control-present.js +223 -0
  103. package/dist/rules/ai-governance-feedback-control-present.js.map +1 -0
  104. package/dist/rules/ai-governance-human-control-affordances.d.ts +16 -0
  105. package/dist/rules/ai-governance-human-control-affordances.js +228 -0
  106. package/dist/rules/ai-governance-human-control-affordances.js.map +1 -0
  107. package/dist/rules/ai-governance-value-gate-doc-present.d.ts +18 -0
  108. package/dist/rules/ai-governance-value-gate-doc-present.js +206 -0
  109. package/dist/rules/ai-governance-value-gate-doc-present.js.map +1 -0
  110. package/dist/rules/ai-surface-agent-instruction-files.d.ts +33 -0
  111. package/dist/rules/ai-surface-agent-instruction-files.js +310 -0
  112. package/dist/rules/ai-surface-agent-instruction-files.js.map +1 -0
  113. package/dist/rules/ai-surface-llms-txt-structure.d.ts +18 -0
  114. package/dist/rules/ai-surface-llms-txt-structure.js +200 -0
  115. package/dist/rules/ai-surface-llms-txt-structure.js.map +1 -0
  116. package/dist/rules/ai-surface-mcp-config-present.d.ts +23 -0
  117. package/dist/rules/ai-surface-mcp-config-present.js +193 -0
  118. package/dist/rules/ai-surface-mcp-config-present.js.map +1 -0
  119. package/dist/rules/ai-surface-shadcn-registry-valid.d.ts +22 -0
  120. package/dist/rules/ai-surface-shadcn-registry-valid.js +247 -0
  121. package/dist/rules/ai-surface-shadcn-registry-valid.js.map +1 -0
  122. package/dist/rules/components-contracts-strictness.d.ts +48 -0
  123. package/dist/rules/components-contracts-strictness.js +372 -0
  124. package/dist/rules/components-contracts-strictness.js.map +1 -0
  125. package/dist/rules/registry.js +32 -0
  126. package/dist/rules/registry.js.map +1 -1
  127. package/dist/rules/tokens-dtcg-conformance.d.ts +55 -19
  128. package/dist/rules/tokens-dtcg-conformance.js +320 -82
  129. package/dist/rules/tokens-dtcg-conformance.js.map +1 -1
  130. package/dist/scorer.js +4 -3
  131. package/dist/scorer.js.map +1 -1
  132. package/dist/types.d.ts +2 -2
  133. package/dist/types.js.map +1 -1
  134. package/package.json +41 -16
  135. package/rules-manifest.json +431 -6
  136. package/schemas/v1/lyse-rules.json +1 -1
  137. package/dist/commands/ci-setup.d.ts +0 -9
  138. package/dist/commands/ci-setup.js +0 -42
  139. package/dist/commands/ci-setup.js.map +0 -1
  140. package/dist/commands/templates/lyse-workflow.yml.template +0 -30
@@ -0,0 +1,82 @@
1
+ import { describe, expect, it, vi } from "vitest";
2
+ import { OpenAICompatibleAdapter } from "../openai-compatible-adapter.js";
3
+ function mockFetch(responseText, model) {
4
+ return vi.fn().mockResolvedValue({
5
+ ok: true,
6
+ status: 200,
7
+ json: async () => ({
8
+ choices: [{ message: { content: responseText } }],
9
+ model,
10
+ usage: { prompt_tokens: 10, completion_tokens: 20, total_tokens: 30 },
11
+ }),
12
+ });
13
+ }
14
+ describe("OpenAICompatibleAdapter", () => {
15
+ it("returns text from a mock response", async () => {
16
+ const fetch = mockFetch("design system score: 82", "gpt-4o-mini");
17
+ const adapter = new OpenAICompatibleAdapter({
18
+ apiKey: "sk-test",
19
+ model: "gpt-4o-mini",
20
+ baseURL: "https://api.openai.com/v1",
21
+ fetchFn: fetch,
22
+ });
23
+ const result = await adapter.complete([{ role: "user", content: "audit" }]);
24
+ expect(result.text).toBe("design system score: 82");
25
+ expect(result.modelUsed).toBe("gpt-4o-mini");
26
+ expect(result.cacheHit).toBe(false);
27
+ expect(result.llmQuality).toBe("higher");
28
+ });
29
+ it("does NOT include the API key in the fetch call body", async () => {
30
+ const fetch = mockFetch("ok", "gpt-4o");
31
+ const adapter = new OpenAICompatibleAdapter({
32
+ apiKey: "sk-secret-key",
33
+ model: "gpt-4o",
34
+ baseURL: "https://api.openai.com/v1",
35
+ fetchFn: fetch,
36
+ });
37
+ await adapter.complete([{ role: "user", content: "x" }]);
38
+ const [_url, init] = fetch.mock.calls[0];
39
+ const bodyStr = typeof init.body === "string" ? init.body : "";
40
+ expect(bodyStr).not.toContain("sk-secret-key");
41
+ const headers = init.headers;
42
+ expect(headers["Authorization"]).toBe("Bearer sk-secret-key");
43
+ });
44
+ it("marks ollama (localhost) responses as llmQuality: lower", async () => {
45
+ const fetch = mockFetch("ok", "llama3.2");
46
+ const adapter = new OpenAICompatibleAdapter({
47
+ apiKey: "",
48
+ model: "llama3.2",
49
+ baseURL: "http://localhost:11434/v1",
50
+ fetchFn: fetch,
51
+ });
52
+ const result = await adapter.complete([{ role: "user", content: "x" }]);
53
+ expect(result.llmQuality).toBe("lower");
54
+ expect(result.usdSpent).toBe(0);
55
+ });
56
+ it("marks openrouter as llmQuality: higher", async () => {
57
+ const fetch = mockFetch("ok", "openai/gpt-4o");
58
+ const adapter = new OpenAICompatibleAdapter({
59
+ apiKey: "or-test",
60
+ model: "openai/gpt-4o",
61
+ baseURL: "https://openrouter.ai/api/v1",
62
+ fetchFn: fetch,
63
+ });
64
+ const result = await adapter.complete([{ role: "user", content: "x" }]);
65
+ expect(result.llmQuality).toBe("higher");
66
+ });
67
+ it("throws when the API returns a non-200 response", async () => {
68
+ const fetch = vi.fn().mockResolvedValue({
69
+ ok: false,
70
+ status: 401,
71
+ json: async () => ({ error: { message: "Invalid API key" } }),
72
+ });
73
+ const adapter = new OpenAICompatibleAdapter({
74
+ apiKey: "bad",
75
+ model: "gpt-4o",
76
+ baseURL: "https://api.openai.com/v1",
77
+ fetchFn: fetch,
78
+ });
79
+ await expect(adapter.complete([{ role: "user", content: "x" }])).rejects.toThrow("OpenAI-compatible API error 401");
80
+ });
81
+ });
82
+ //# sourceMappingURL=openai-compatible-adapter.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openai-compatible-adapter.test.js","sourceRoot":"","sources":["../../../../src/llm/connectors/__tests__/openai-compatible-adapter.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,140 @@
1
+ import { describe, expect, it, vi, beforeEach, afterEach } from "vitest";
2
+ import { mkdtempSync } from "node:fs";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import { resolveConnector } from "../resolver.js";
6
+ function mockFetch(text = "ok", model = "gpt-4o-mini") {
7
+ return vi.fn().mockResolvedValue({
8
+ ok: true,
9
+ status: 200,
10
+ json: async () => ({
11
+ choices: [{ message: { content: text } }],
12
+ model,
13
+ usage: { prompt_tokens: 5, completion_tokens: 5, total_tokens: 10 },
14
+ }),
15
+ });
16
+ }
17
+ function tmpBudgetPath() {
18
+ return join(mkdtempSync(join(tmpdir(), "lyse-resolver-")), "budget.json");
19
+ }
20
+ function tmpCacheDir() {
21
+ return mkdtempSync(join(tmpdir(), "lyse-cache-"));
22
+ }
23
+ describe("resolveConnector", () => {
24
+ beforeEach(() => {
25
+ vi.unstubAllEnvs();
26
+ });
27
+ afterEach(() => {
28
+ vi.unstubAllEnvs();
29
+ });
30
+ it("returns no-op when no llm config is set", async () => {
31
+ const config = {};
32
+ const client = resolveConnector(config, undefined, {
33
+ budgetStatePath: tmpBudgetPath(),
34
+ cacheDir: tmpCacheDir(),
35
+ });
36
+ const result = await client.complete([{ role: "user", content: "x" }]);
37
+ expect(result.text).toBe("");
38
+ expect(result.usdSpent).toBe(0);
39
+ expect(result.modelUsed).toBe("none");
40
+ });
41
+ it("returns no-op when staticOnly: true in flags", async () => {
42
+ const config = { llm: { provider: "openai", model: "gpt-4o" } };
43
+ const client = resolveConnector(config, { staticOnly: true }, {
44
+ budgetStatePath: tmpBudgetPath(),
45
+ cacheDir: tmpCacheDir(),
46
+ });
47
+ const result = await client.complete([{ role: "user", content: "x" }]);
48
+ expect(result.modelUsed).toBe("none");
49
+ });
50
+ it("returns no-op when config.llm.staticOnly is true", async () => {
51
+ const config = { llm: { staticOnly: true } };
52
+ const client = resolveConnector(config, undefined, {
53
+ budgetStatePath: tmpBudgetPath(),
54
+ cacheDir: tmpCacheDir(),
55
+ });
56
+ const result = await client.complete([{ role: "user", content: "x" }]);
57
+ expect(result.modelUsed).toBe("none");
58
+ });
59
+ it("refuses a call when the daily budget is exhausted", async () => {
60
+ vi.stubEnv("OPENAI_API_KEY", "sk-test");
61
+ const fetch = mockFetch();
62
+ const budgetPath = tmpBudgetPath();
63
+ const opts = {
64
+ budgetStatePath: budgetPath,
65
+ cacheDir: tmpCacheDir(),
66
+ fetchFn: fetch,
67
+ };
68
+ const config = { llm: { provider: "openai", model: "gpt-4o-mini", costCapUsd: 1.0 } };
69
+ const client1 = resolveConnector(config, undefined, opts);
70
+ const r1 = await client1.complete([{ role: "user", content: "x" }]);
71
+ expect(r1.text).toBe("ok");
72
+ const { LLMBudget } = await import("../../../reliability/llm-eval/budget.js");
73
+ const b = new LLMBudget({ dailyUsd: 1.0, statePath: budgetPath });
74
+ b.record(2.0);
75
+ const client2 = resolveConnector(config, undefined, opts);
76
+ const r2 = await client2.complete([{ role: "user", content: "y" }]);
77
+ expect(r2.modelUsed).toBe("none");
78
+ expect(r2.usdSpent).toBe(0);
79
+ });
80
+ it("returns a cache hit on second call with same messages", async () => {
81
+ vi.stubEnv("OPENAI_API_KEY", "sk-test");
82
+ const fetch = mockFetch("cached-text");
83
+ const cacheDir = tmpCacheDir();
84
+ const opts = {
85
+ budgetStatePath: tmpBudgetPath(),
86
+ cacheDir,
87
+ fetchFn: fetch,
88
+ };
89
+ const config = {
90
+ llm: { provider: "openai", model: "gpt-4o-mini", cacheMaxAgeDays: 7 },
91
+ };
92
+ const client = resolveConnector(config, undefined, opts);
93
+ const msgs = [{ role: "user", content: "hello" }];
94
+ const r1 = await client.complete(msgs);
95
+ expect(r1.cacheHit).toBe(false);
96
+ expect(r1.text).toBe("cached-text");
97
+ const r2 = await client.complete(msgs);
98
+ expect(r2.cacheHit).toBe(true);
99
+ expect(r2.usdSpent).toBe(0);
100
+ expect(r2.text).toBe("cached-text");
101
+ expect(fetch).toHaveBeenCalledTimes(1);
102
+ });
103
+ it("mcp-host connector throws ConnectorNotImplementedError", async () => {
104
+ const config = { llm: { provider: "openai", connector: "mcp-host" } };
105
+ const client = resolveConnector(config, undefined, {
106
+ budgetStatePath: tmpBudgetPath(),
107
+ cacheDir: tmpCacheDir(),
108
+ });
109
+ await expect(client.complete([{ role: "user", content: "x" }])).rejects.toThrow("mcp-host");
110
+ });
111
+ it("noCache: true — second identical call bypasses cache and calls transport again", async () => {
112
+ vi.stubEnv("OPENAI_API_KEY", "sk-test");
113
+ const fetch = mockFetch("fresh-text");
114
+ const opts = {
115
+ budgetStatePath: tmpBudgetPath(),
116
+ cacheDir: tmpCacheDir(),
117
+ fetchFn: fetch,
118
+ };
119
+ const config = {
120
+ llm: { provider: "openai", model: "gpt-4o-mini", cacheMaxAgeDays: 7 },
121
+ };
122
+ const msgs = [{ role: "user", content: "hello" }];
123
+ const client1 = resolveConnector(config, { noCache: true }, opts);
124
+ const r1 = await client1.complete(msgs);
125
+ expect(r1.cacheHit).toBe(false);
126
+ const client2 = resolveConnector(config, { noCache: true }, opts);
127
+ const r2 = await client2.complete(msgs);
128
+ expect(r2.cacheHit).toBe(false);
129
+ expect(fetch).toHaveBeenCalledTimes(2);
130
+ });
131
+ it("provider mcp throws ConnectorNotImplementedError", async () => {
132
+ const config = { llm: { provider: "mcp" } };
133
+ const client = resolveConnector(config, undefined, {
134
+ budgetStatePath: tmpBudgetPath(),
135
+ cacheDir: tmpCacheDir(),
136
+ });
137
+ await expect(client.complete([{ role: "user", content: "x" }])).rejects.toThrow("mcp");
138
+ });
139
+ });
140
+ //# sourceMappingURL=resolver.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolver.test.js","sourceRoot":"","sources":["../../../../src/llm/connectors/__tests__/resolver.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { ChatMessage, CompleteOptions, ConnectorClient, ConnectorResult } from "./types.js";
2
+ export interface AnthropicAdapterOptions {
3
+ apiKey: string;
4
+ model: string;
5
+ fetchFn?: typeof globalThis.fetch;
6
+ }
7
+ export declare class AnthropicAdapter implements ConnectorClient {
8
+ private readonly opts;
9
+ private readonly client;
10
+ constructor(opts: AnthropicAdapterOptions);
11
+ complete(messages: ChatMessage[], _opts?: CompleteOptions): Promise<ConnectorResult>;
12
+ }
@@ -0,0 +1,57 @@
1
+ import Anthropic from "@anthropic-ai/sdk";
2
+ // Heuristic upper-bound rates (USD per 1M tokens). These are conservative estimates;
3
+ // actual pricing may differ. Used only for budget tracking, not billing.
4
+ const MODEL_RATES = [
5
+ { pattern: /haiku/i, inputPer1M: 0.8, outputPer1M: 4 },
6
+ { pattern: /sonnet/i, inputPer1M: 3, outputPer1M: 15 },
7
+ { pattern: /opus/i, inputPer1M: 15, outputPer1M: 75 },
8
+ ];
9
+ // Conservative default for unknown models.
10
+ const DEFAULT_RATE = { inputPer1M: 15, outputPer1M: 75 };
11
+ function rateForModel(model) {
12
+ for (const entry of MODEL_RATES) {
13
+ if (entry.pattern.test(model))
14
+ return entry;
15
+ }
16
+ return DEFAULT_RATE;
17
+ }
18
+ function isTextBlock(b) {
19
+ return b.type === "text";
20
+ }
21
+ export class AnthropicAdapter {
22
+ opts;
23
+ client;
24
+ constructor(opts) {
25
+ this.opts = opts;
26
+ this.client = new Anthropic({
27
+ apiKey: opts.apiKey,
28
+ ...(opts.fetchFn !== undefined && { fetch: opts.fetchFn }),
29
+ });
30
+ }
31
+ async complete(messages, _opts) {
32
+ const systemMessages = messages.filter((m) => m.role === "system");
33
+ const conversationMessages = messages.filter((m) => m.role !== "system");
34
+ const systemText = systemMessages.map((m) => m.content).join("\n");
35
+ const response = await this.client.messages.create({
36
+ model: this.opts.model,
37
+ max_tokens: 4096,
38
+ ...(systemText.length > 0 && { system: systemText }),
39
+ messages: conversationMessages.map((m) => ({
40
+ role: m.role,
41
+ content: m.content,
42
+ })),
43
+ });
44
+ const text = response.content.filter(isTextBlock).map((b) => b.text).join("");
45
+ const rate = rateForModel(this.opts.model);
46
+ const usdSpent = response.usage.input_tokens * (rate.inputPer1M / 1_000_000) +
47
+ response.usage.output_tokens * (rate.outputPer1M / 1_000_000);
48
+ return {
49
+ text,
50
+ usdSpent,
51
+ modelUsed: this.opts.model,
52
+ llmQuality: "higher",
53
+ cacheHit: false,
54
+ };
55
+ }
56
+ }
57
+ //# sourceMappingURL=anthropic-adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"anthropic-adapter.js","sourceRoot":"","sources":["../../../src/llm/connectors/anthropic-adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import type { ChatMessage, ConnectorResult } from "./types.js";
2
+ export declare const DEFAULT_CACHE_DIR: string;
3
+ export declare class ResponseCache {
4
+ private readonly opts;
5
+ constructor(opts: {
6
+ cacheDir: string;
7
+ maxAgeDays: number;
8
+ });
9
+ private cacheKey;
10
+ private entryPath;
11
+ private isExpired;
12
+ get(model: string, messages: ChatMessage[]): Promise<ConnectorResult | null>;
13
+ set(model: string, messages: ChatMessage[], result: ConnectorResult): Promise<void>;
14
+ }
15
+ export declare function defaultResponseCache(maxAgeDays: number): ResponseCache;
@@ -0,0 +1,57 @@
1
+ import { createHash } from "node:crypto";
2
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
3
+ import { homedir } from "node:os";
4
+ import { join } from "node:path";
5
+ export const DEFAULT_CACHE_DIR = join(homedir(), ".cache", "lyse", "llm-responses");
6
+ export class ResponseCache {
7
+ opts;
8
+ constructor(opts) {
9
+ this.opts = opts;
10
+ }
11
+ cacheKey(model, messages) {
12
+ const payload = JSON.stringify({ model, messages });
13
+ return createHash("sha256").update(payload).digest("hex");
14
+ }
15
+ entryPath(key) {
16
+ return join(this.opts.cacheDir, `${key}.json`);
17
+ }
18
+ isExpired(timestamp) {
19
+ const ageMs = Date.now() - new Date(timestamp).getTime();
20
+ const ageDays = ageMs / (1000 * 60 * 60 * 24);
21
+ return ageDays >= this.opts.maxAgeDays;
22
+ }
23
+ async get(model, messages) {
24
+ const path = this.entryPath(this.cacheKey(model, messages));
25
+ if (!existsSync(path))
26
+ return null;
27
+ try {
28
+ const entry = JSON.parse(readFileSync(path, "utf8"));
29
+ if (this.isExpired(entry.timestamp))
30
+ return null;
31
+ return {
32
+ ...entry.result,
33
+ cacheHit: true,
34
+ usdSpent: 0,
35
+ };
36
+ }
37
+ catch {
38
+ return null;
39
+ }
40
+ }
41
+ async set(model, messages, result) {
42
+ mkdirSync(this.opts.cacheDir, { recursive: true });
43
+ const entry = {
44
+ timestamp: new Date().toISOString(),
45
+ result: {
46
+ text: result.text,
47
+ modelUsed: result.modelUsed,
48
+ llmQuality: result.llmQuality,
49
+ },
50
+ };
51
+ writeFileSync(this.entryPath(this.cacheKey(model, messages)), JSON.stringify(entry));
52
+ }
53
+ }
54
+ export function defaultResponseCache(maxAgeDays) {
55
+ return new ResponseCache({ cacheDir: DEFAULT_CACHE_DIR, maxAgeDays });
56
+ }
57
+ //# sourceMappingURL=cache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/llm/connectors/cache.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { ChatMessage, CompleteOptions, ConnectorClient, ConnectorResult } from "./types.js";
2
+ export declare class NoopAdapter implements ConnectorClient {
3
+ complete(_messages: ChatMessage[], _opts?: CompleteOptions): Promise<ConnectorResult>;
4
+ }
@@ -0,0 +1,12 @@
1
+ export class NoopAdapter {
2
+ async complete(_messages, _opts) {
3
+ return {
4
+ text: "",
5
+ usdSpent: 0,
6
+ modelUsed: "none",
7
+ llmQuality: "lower",
8
+ cacheHit: false,
9
+ };
10
+ }
11
+ }
12
+ //# sourceMappingURL=noop-adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"noop-adapter.js","sourceRoot":"","sources":["../../../src/llm/connectors/noop-adapter.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAW;IACtB,KAAK,CAAC,QAAQ,CAAC,SAAwB,EAAE,KAAuB;QAC9D,OAAO;YACL,IAAI,EAAE,EAAE;YACR,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,MAAM;YACjB,UAAU,EAAE,OAAO;YACnB,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,13 @@
1
+ import type { ChatMessage, CompleteOptions, ConnectorClient, ConnectorResult } from "./types.js";
2
+ export interface OpenAICompatibleAdapterOptions {
3
+ apiKey: string;
4
+ model: string;
5
+ baseURL: string;
6
+ fetchFn?: typeof globalThis.fetch;
7
+ }
8
+ export declare class OpenAICompatibleAdapter implements ConnectorClient {
9
+ private readonly opts;
10
+ private readonly fetchFn;
11
+ constructor(opts: OpenAICompatibleAdapterOptions);
12
+ complete(messages: ChatMessage[], _opts?: CompleteOptions): Promise<ConnectorResult>;
13
+ }
@@ -0,0 +1,47 @@
1
+ const LOCALHOST_RE = /^https?:\/\/localhost|^https?:\/\/127\./;
2
+ function isLocalEndpoint(baseURL) {
3
+ return LOCALHOST_RE.test(baseURL);
4
+ }
5
+ function estimateUsd(usage, baseURL) {
6
+ if (isLocalEndpoint(baseURL) || !usage)
7
+ return 0;
8
+ const total = usage.prompt_tokens + usage.completion_tokens;
9
+ return (total / 1_000_000) * 0.15;
10
+ }
11
+ export class OpenAICompatibleAdapter {
12
+ opts;
13
+ fetchFn;
14
+ constructor(opts) {
15
+ this.opts = opts;
16
+ this.fetchFn = opts.fetchFn ?? globalThis.fetch;
17
+ }
18
+ async complete(messages, _opts) {
19
+ const url = `${this.opts.baseURL.replace(/\/$/, "")}/chat/completions`;
20
+ const body = JSON.stringify({ model: this.opts.model, messages });
21
+ const headers = {
22
+ "Content-Type": "application/json",
23
+ };
24
+ if (this.opts.apiKey) {
25
+ headers["Authorization"] = `Bearer ${this.opts.apiKey}`;
26
+ }
27
+ const response = await this.fetchFn(url, {
28
+ method: "POST",
29
+ headers,
30
+ body,
31
+ });
32
+ if (!response.ok) {
33
+ throw new Error(`OpenAI-compatible API error ${response.status} from ${this.opts.baseURL}`);
34
+ }
35
+ const data = (await response.json());
36
+ const text = data.choices[0]?.message.content ?? "";
37
+ const local = isLocalEndpoint(this.opts.baseURL);
38
+ return {
39
+ text,
40
+ usdSpent: estimateUsd(data.usage, this.opts.baseURL),
41
+ modelUsed: this.opts.model,
42
+ llmQuality: local ? "lower" : "higher",
43
+ cacheHit: false,
44
+ };
45
+ }
46
+ }
47
+ //# sourceMappingURL=openai-compatible-adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openai-compatible-adapter.js","sourceRoot":"","sources":["../../../src/llm/connectors/openai-compatible-adapter.ts"],"names":[],"mappings":"AAqBA,MAAM,YAAY,GAAG,yCAAyC,CAAC;AAE/D,SAAS,eAAe,CAAC,OAAe;IACtC,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,WAAW,CAAC,KAA8B,EAAE,OAAe;IAClE,IAAI,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAC5D,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;AACpC,CAAC;AAED,MAAM,OAAO,uBAAuB;IAGL;IAFZ,OAAO,CAA0B;IAElD,YAA6B,IAAoC;QAApC,SAAI,GAAJ,IAAI,CAAgC;QAC/D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAuB,EAAE,KAAuB;QAC7D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAElE,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QACF,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACrB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1D,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YACvC,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,+BAA+B,QAAQ,CAAC,MAAM,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAC3E,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmB,CAAC;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEjD,OAAO;YACL,IAAI;YACJ,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACpD,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;YAC1B,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;YACtC,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,9 @@
1
+ import type { ConnectorClient } from "./types.js";
2
+ import type { LyseConfig } from "../../types.js";
3
+ import type { AuditFlags } from "../../commands/audit-flags.js";
4
+ export interface ResolveConnectorOptions {
5
+ budgetStatePath?: string;
6
+ cacheDir?: string;
7
+ fetchFn?: typeof globalThis.fetch;
8
+ }
9
+ export declare function resolveConnector(config: LyseConfig, flags: AuditFlags | undefined, opts?: ResolveConnectorOptions): ConnectorClient;