@latimer-woods-tech/llm 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+## [Unreleased]
+
+## [0.2.0] - 2026-04-29
+
+### Added
+- Multi-provider LLM completion chain with Anthropic primary, Grok fallback, and Groq tertiary fallback.
+- Streaming support through the Anthropic-compatible provider path.
+- `withSystem()` helper for consistently applying system prompts at call sites.
+- Quality-gated package build with lint, typecheck, coverage, and ESM output.
+
+### Fixed
+- Restored `@latimer-woods-tech/errors` and `@latimer-woods-tech/logger` as runtime dependencies so published consumers resolve package imports correctly.
+
+### Verification
+- `npm install` regenerated the package lock and ran the package prepublish gate on Apr 29, 2026.
+- `npm run lint`, `npm run typecheck`, `npm test -- --coverage`, and `npm run build` passed during the prepublish gate.

package/README.md

@@ -0,0 +1,3 @@
+# @factory/llm
+
+LLM failover orchestration across Factory AI providers.

package/dist/index.d.mts

@@ -0,0 +1,87 @@
+import { FactoryResponse } from '@latimer-woods-tech/errors';
+import { Logger } from '@latimer-woods-tech/logger';
+
+/**
+ * Single chat message exchanged with an LLM provider.
+ */
+interface LLMMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+/**
+ * Options that influence LLM completion behaviour.
+ */
+interface LLMOptions {
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    system?: string;
+}
+/**
+ * Provider that produced an LLM response.
+ */
+type LLMProvider = 'anthropic' | 'grok' | 'groq';
+/**
+ * Result returned by a successful completion.
+ */
+interface LLMResult {
+    content: string;
+    provider: LLMProvider;
+    tokens: {
+        input: number;
+        output: number;
+    };
+    latency: number;
+}
+/**
+ * Environment bindings required by {@link complete}.
+ */
+interface LLMEnv {
+    ANTHROPIC_API_KEY: string;
+    GROK_API_KEY: string;
+    GROQ_API_KEY: string;
+}
+/**
+ * Optional dependencies for {@link complete}.
+ */
+interface LLMDeps {
+    fetch?: typeof fetch;
+    logger?: Logger;
+    now?: () => number;
+}
+/**
+ * Runs a completion through the Anthropic → Grok → Groq failover chain.
+ *
+ * @param messages - Ordered chat history.
+ * @param env - API key bindings.
+ * @param opts - Optional model/parameters override.
+ * @param deps - Optional fetch/logger/clock injection (for testing).
+ * @returns A {@link FactoryResponse} carrying either an {@link LLMResult} or
+ *   an `LLM_ALL_PROVIDERS_FAILED` error.
+ */
+declare function complete(messages: LLMMessage[], env: LLMEnv, opts?: LLMOptions, deps?: LLMDeps): Promise<FactoryResponse<LLMResult>>;
+/**
+ * Streams a completion from Anthropic. No failover is performed for streaming
+ * responses; callers should fall back to {@link complete} on failure.
+ *
+ * @param messages - Ordered chat history.
+ * @param env - Anthropic API key binding.
+ * @param opts - Optional model/parameters override.
+ * @param deps - Optional fetch override (for testing).
+ * @returns The raw Anthropic streaming response body.
+ */
+declare function stream(messages: LLMMessage[], env: {
+    ANTHROPIC_API_KEY: string;
+}, opts?: LLMOptions, deps?: {
+    fetch?: typeof fetch;
+}): Promise<ReadableStream<Uint8Array>>;
+/**
+ * Returns a {@link complete}-compatible function with a system prompt
+ * pre-bound, so callers can hand around a domain-specific shortcut.
+ *
+ * @param system - System prompt to prepend to every call.
+ * @returns A function that invokes {@link complete} with `system` injected.
+ */
+declare function withSystem(system: string): (messages: LLMMessage[], env: LLMEnv, opts?: LLMOptions, deps?: LLMDeps) => Promise<FactoryResponse<LLMResult>>;
+
+export { type LLMDeps, type LLMEnv, type LLMMessage, type LLMOptions, type LLMProvider, type LLMResult, complete, stream, withSystem };

package/dist/index.mjs

@@ -0,0 +1,235 @@
+// src/index.ts
+import {
+  ErrorCodes,
+  InternalError,
+  RateLimitError,
+  ValidationError
+} from "@latimer-woods-tech/errors";
+var DEFAULT_MAX_TOKENS = 1024;
+var DEFAULT_TEMPERATURE = 0.7;
+var DEFAULT_ANTHROPIC_MODEL = "claude-sonnet-4-20250514";
+var DEFAULT_GROK_MODEL = "grok-3-fast";
+var DEFAULT_GROQ_MODEL = "llama-3.3-70b-versatile";
+function isFailover(status) {
+  return status === 429 || status >= 500;
+}
+function buildAnthropicBody(messages, opts, system) {
+  const filtered = messages.filter((m) => m.role !== "system");
+  const sys = system ?? messages.find((m) => m.role === "system")?.content;
+  const body = {
+    model: opts.model ?? DEFAULT_ANTHROPIC_MODEL,
+    max_tokens: opts.maxTokens ?? DEFAULT_MAX_TOKENS,
+    temperature: opts.temperature ?? DEFAULT_TEMPERATURE,
+    messages: filtered.map((m) => ({ role: m.role, content: m.content }))
+  };
+  if (sys) {
+    body.system = sys;
+  }
+  return JSON.stringify(body);
+}
+function buildOpenAIBody(model, messages, opts, system) {
+  const sys = system ?? messages.find((m) => m.role === "system")?.content;
+  const merged = [];
+  if (sys) {
+    merged.push({ role: "system", content: sys });
+  }
+  for (const m of messages) {
+    if (m.role !== "system") {
+      merged.push(m);
+    }
+  }
+  return JSON.stringify({
+    model,
+    max_tokens: opts.maxTokens ?? DEFAULT_MAX_TOKENS,
+    temperature: opts.temperature ?? DEFAULT_TEMPERATURE,
+    messages: merged
+  });
+}
+function parseAnthropic(json) {
+  const r = json;
+  const text = r.content?.find((c) => c.type === "text")?.text ?? "";
+  return {
+    content: text,
+    input: r.usage?.input_tokens ?? 0,
+    output: r.usage?.output_tokens ?? 0
+  };
+}
+function parseOpenAI(json) {
+  const r = json;
+  const text = r.choices?.[0]?.message?.content ?? "";
+  return {
+    content: text,
+    input: r.usage?.prompt_tokens ?? 0,
+    output: r.usage?.completion_tokens ?? 0
+  };
+}
+async function callProvider(provider, request, fetchImpl) {
+  const response = await fetchImpl(request.url, {
+    method: "POST",
+    headers: request.headers,
+    body: request.body
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    const err = {
+      status: response.status,
+      message: `${provider} request failed (${String(response.status)}): ${text.slice(0, 200)}`
+    };
+    throw err;
+  }
+  return await response.json();
+}
+function isProviderError(err) {
+  return typeof err === "object" && err !== null && typeof err.status === "number" && typeof err.message === "string";
+}
+async function complete(messages, env, opts = {}, deps = {}) {
+  if (messages.length === 0) {
+    throw new ValidationError("messages must not be empty");
+  }
+  const fetchImpl = deps.fetch ?? fetch;
+  const now = deps.now ?? (() => Date.now());
+  const logger = deps.logger;
+  const startedAt = now();
+  const attempts = [];
+  try {
+    const json = await callProvider(
+      "anthropic",
+      {
+        url: "https://api.anthropic.com/v1/messages",
+        headers: {
+          "content-type": "application/json",
+          "x-api-key": env.ANTHROPIC_API_KEY,
+          "anthropic-version": "2023-06-01"
+        },
+        body: buildAnthropicBody(messages, opts, opts.system)
+      },
+      fetchImpl
+    );
+    const parsed = parseAnthropic(json);
+    return {
+      data: {
+        content: parsed.content,
+        provider: "anthropic",
+        tokens: { input: parsed.input, output: parsed.output },
+        latency: now() - startedAt
+      },
+      error: null
+    };
+  } catch (err) {
+    const status = isProviderError(err) ? err.status : 0;
+    const message = isProviderError(err) ? err.message : err.message;
+    attempts.push({ provider: "anthropic", status, message });
+    if (status !== 0 && !isFailover(status)) {
+      return providerErrorResponse(attempts, status === 429);
+    }
+    logger?.warn("llm.failover", { from: "anthropic", to: "grok", status, message });
+  }
+  try {
+    const json = await callProvider(
+      "grok",
+      {
+        url: "https://api.x.ai/v1/chat/completions",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${env.GROK_API_KEY}`
+        },
+        body: buildOpenAIBody(opts.model ?? DEFAULT_GROK_MODEL, messages, opts, opts.system)
+      },
+      fetchImpl
+    );
+    const parsed = parseOpenAI(json);
+    return {
+      data: {
+        content: parsed.content,
+        provider: "grok",
+        tokens: { input: parsed.input, output: parsed.output },
+        latency: now() - startedAt
+      },
+      error: null
+    };
+  } catch (err) {
+    const status = isProviderError(err) ? err.status : 0;
+    const message = isProviderError(err) ? err.message : err.message;
+    attempts.push({ provider: "grok", status, message });
+    logger?.warn("llm.failover", { from: "grok", to: "groq", status, message });
+  }
+  try {
+    const json = await callProvider(
+      "groq",
+      {
+        url: "https://api.groq.com/openai/v1/chat/completions",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${env.GROQ_API_KEY}`
+        },
+        body: buildOpenAIBody(opts.model ?? DEFAULT_GROQ_MODEL, messages, opts, opts.system)
+      },
+      fetchImpl
+    );
+    const parsed = parseOpenAI(json);
+    return {
+      data: {
+        content: parsed.content,
+        provider: "groq",
+        tokens: { input: parsed.input, output: parsed.output },
+        latency: now() - startedAt
+      },
+      error: null
+    };
+  } catch (err) {
+    const status = isProviderError(err) ? err.status : 0;
+    const message = isProviderError(err) ? err.message : err.message;
+    attempts.push({ provider: "groq", status, message });
+    logger?.error("llm.all_providers_failed", void 0, { attempts });
+  }
+  return providerErrorResponse(attempts, false);
+}
+function providerErrorResponse(attempts, rateLimited) {
+  const base = rateLimited ? new RateLimitError("LLM provider rate limited", { code: ErrorCodes.LLM_RATE_LIMITED, attempts }) : new InternalError("All LLM providers failed", {
+    code: ErrorCodes.LLM_ALL_PROVIDERS_FAILED,
+    attempts
+  });
+  return {
+    data: null,
+    error: {
+      code: rateLimited ? ErrorCodes.LLM_RATE_LIMITED : ErrorCodes.LLM_ALL_PROVIDERS_FAILED,
+      message: base.message,
+      status: base.status,
+      retryable: base.retryable,
+      context: base.context
+    }
+  };
+}
+async function stream(messages, env, opts = {}, deps = {}) {
+  if (messages.length === 0) {
+    throw new ValidationError("messages must not be empty");
+  }
+  const fetchImpl = deps.fetch ?? fetch;
+  const body = JSON.parse(buildAnthropicBody(messages, opts, opts.system));
+  body.stream = true;
+  const response = await fetchImpl("https://api.anthropic.com/v1/messages", {
+    method: "POST",
+    headers: {
+      "content-type": "application/json",
+      "x-api-key": env.ANTHROPIC_API_KEY,
+      "anthropic-version": "2023-06-01"
+    },
+    body: JSON.stringify(body)
+  });
+  if (!response.ok || !response.body) {
+    throw new InternalError("Anthropic stream failed", {
+      code: ErrorCodes.LLM_ALL_PROVIDERS_FAILED,
+      status: response.status
+    });
+  }
+  return response.body;
+}
+function withSystem(system) {
+  return (messages, env, opts = {}, deps = {}) => complete(messages, env, { ...opts, system }, deps);
+}
+export {
+  complete,
+  stream,
+  withSystem
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  ErrorCodes,\n  FactoryBaseError,\n  InternalError,\n  RateLimitError,\n  ValidationError,\n  type FactoryResponse,\n} from '@latimer-woods-tech/errors';\nimport type { Logger } from '@latimer-woods-tech/logger';\n\n/**\n * Single chat message exchanged with an LLM provider.\n */\nexport interface LLMMessage {\n  role: 'user' | 'assistant' | 'system';\n  content: string;\n}\n\n/**\n * Options that influence LLM completion behaviour.\n */\nexport interface LLMOptions {\n  model?: string;\n  maxTokens?: number;\n  temperature?: number;\n  system?: string;\n}\n\n/**\n * Provider that produced an LLM response.\n */\nexport type LLMProvider = 'anthropic' | 'grok' | 'groq';\n\n/**\n * Result returned by a successful completion.\n */\nexport interface LLMResult {\n  content: string;\n  provider: LLMProvider;\n  tokens: { input: number; output: number };\n  latency: number;\n}\n\n/**\n * Environment bindings required by {@link complete}.\n */\nexport interface LLMEnv {\n  ANTHROPIC_API_KEY: string;\n  GROK_API_KEY: string;\n  GROQ_API_KEY: string;\n}\n\n/**\n * Optional dependencies for {@link complete}.\n */\nexport interface LLMDeps {\n  fetch?: typeof fetch;\n  logger?: Logger;\n  now?: () => number;\n}\n\nconst DEFAULT_MAX_TOKENS = 1024;\nconst DEFAULT_TEMPERATURE = 0.7;\nconst DEFAULT_ANTHROPIC_MODEL = 'claude-sonnet-4-20250514';\nconst DEFAULT_GROK_MODEL = 'grok-3-fast';\nconst DEFAULT_GROQ_MODEL = 'llama-3.3-70b-versatile';\n\ninterface ProviderError {\n  status: number;\n  message: string;\n}\n\nfunction isFailover(status: number): boolean {\n  return status === 429 || status >= 500;\n}\n\nfunction buildAnthropicBody(messages: LLMMessage[], opts: LLMOptions, system?: string): string {\n  const filtered = messages.filter((m) => m.role !== 'system');\n  const sys = system ?? messages.find((m) => m.role === 'system')?.content;\n  const body: Record<string, unknown> = {\n    model: opts.model ?? DEFAULT_ANTHROPIC_MODEL,\n    max_tokens: opts.maxTokens ?? DEFAULT_MAX_TOKENS,\n    temperature: opts.temperature ?? DEFAULT_TEMPERATURE,\n    messages: filtered.map((m) => ({ role: m.role, content: m.content })),\n  };\n  if (sys) {\n    body.system = sys;\n  }\n  return JSON.stringify(body);\n}\n\nfunction buildOpenAIBody(\n  model: string,\n  messages: LLMMessage[],\n  opts: LLMOptions,\n  system?: string,\n): string {\n  const sys = system ?? messages.find((m) => m.role === 'system')?.content;\n  const merged: LLMMessage[] = [];\n  if (sys) {\n    merged.push({ role: 'system', content: sys });\n  }\n  for (const m of messages) {\n    if (m.role !== 'system') {\n      merged.push(m);\n    }\n  }\n  return JSON.stringify({\n    model,\n    max_tokens: opts.maxTokens ?? DEFAULT_MAX_TOKENS,\n    temperature: opts.temperature ?? DEFAULT_TEMPERATURE,\n    messages: merged,\n  });\n}\n\ninterface AnthropicResponse {\n  content?: Array<{ type: string; text?: string }>;\n  usage?: { input_tokens?: number; output_tokens?: number };\n}\n\ninterface OpenAIResponse {\n  choices?: Array<{ message?: { content?: string } }>;\n  usage?: { prompt_tokens?: number; completion_tokens?: number };\n}\n\nfunction parseAnthropic(json: unknown): { content: string; input: number; output: number } {\n  const r = json as AnthropicResponse;\n  const text = r.content?.find((c) => c.type === 'text')?.text ?? '';\n  return {\n    content: text,\n    input: r.usage?.input_tokens ?? 0,\n    output: r.usage?.output_tokens ?? 0,\n  };\n}\n\nfunction parseOpenAI(json: unknown): { content: string; input: number; output: number } {\n  const r = json as OpenAIResponse;\n  const text = r.choices?.[0]?.message?.content ?? '';\n  return {\n    content: text,\n    input: r.usage?.prompt_tokens ?? 0,\n    output: r.usage?.completion_tokens ?? 0,\n  };\n}\n\nasync function callProvider(\n  provider: LLMProvider,\n  request: { url: string; headers: Record<string, string>; body: string },\n  fetchImpl: typeof fetch,\n): Promise<unknown> {\n  const response = await fetchImpl(request.url, {\n    method: 'POST',\n    headers: request.headers,\n    body: request.body,\n  });\n  if (!response.ok) {\n    const text = await response.text().catch(() => '');\n    const err: ProviderError = {\n      status: response.status,\n      message: `${provider} request failed (${String(response.status)}): ${text.slice(0, 200)}`,\n    };\n    throw err;\n  }\n  return (await response.json()) as unknown;\n}\n\nfunction isProviderError(err: unknown): err is ProviderError {\n  return (\n    typeof err === 'object' &&\n    err !== null &&\n    typeof (err as { status?: unknown }).status === 'number' &&\n    typeof (err as { message?: unknown }).message === 'string'\n  );\n}\n\n/**\n * Runs a completion through the Anthropic → Grok → Groq failover chain.\n *\n * @param messages - Ordered chat history.\n * @param env - API key bindings.\n * @param opts - Optional model/parameters override.\n * @param deps - Optional fetch/logger/clock injection (for testing).\n * @returns A {@link FactoryResponse} carrying either an {@link LLMResult} or\n *   an `LLM_ALL_PROVIDERS_FAILED` error.\n */\nexport async function complete(\n  messages: LLMMessage[],\n  env: LLMEnv,\n  opts: LLMOptions = {},\n  deps: LLMDeps = {},\n): Promise<FactoryResponse<LLMResult>> {\n  if (messages.length === 0) {\n    throw new ValidationError('messages must not be empty');\n  }\n  const fetchImpl = deps.fetch ?? fetch;\n  const now = deps.now ?? (() => Date.now());\n  const logger = deps.logger;\n  const startedAt = now();\n\n  const attempts: Array<{ provider: LLMProvider; status?: number; message: string }> = [];\n\n  // Anthropic\n  try {\n    const json = await callProvider(\n      'anthropic',\n      {\n        url: 'https://api.anthropic.com/v1/messages',\n        headers: {\n          'content-type': 'application/json',\n          'x-api-key': env.ANTHROPIC_API_KEY,\n          'anthropic-version': '2023-06-01',\n        },\n        body: buildAnthropicBody(messages, opts, opts.system),\n      },\n      fetchImpl,\n    );\n    const parsed = parseAnthropic(json);\n    return {\n      data: {\n        content: parsed.content,\n        provider: 'anthropic',\n        tokens: { input: parsed.input, output: parsed.output },\n        latency: now() - startedAt,\n      },\n      error: null,\n    };\n  } catch (err) {\n    const status = isProviderError(err) ? err.status : 0;\n    const message = isProviderError(err) ? err.message : (err as Error).message;\n    attempts.push({ provider: 'anthropic', status, message });\n    if (status !== 0 && !isFailover(status)) {\n      return providerErrorResponse(attempts, status === 429);\n    }\n    logger?.warn('llm.failover', { from: 'anthropic', to: 'grok', status, message });\n  }\n\n  // Grok\n  try {\n    const json = await callProvider(\n      'grok',\n      {\n        url: 'https://api.x.ai/v1/chat/completions',\n        headers: {\n          'content-type': 'application/json',\n          authorization: `Bearer ${env.GROK_API_KEY}`,\n        },\n        body: buildOpenAIBody(opts.model ?? DEFAULT_GROK_MODEL, messages, opts, opts.system),\n      },\n      fetchImpl,\n    );\n    const parsed = parseOpenAI(json);\n    return {\n      data: {\n        content: parsed.content,\n        provider: 'grok',\n        tokens: { input: parsed.input, output: parsed.output },\n        latency: now() - startedAt,\n      },\n      error: null,\n    };\n  } catch (err) {\n    const status = isProviderError(err) ? err.status : 0;\n    const message = isProviderError(err) ? err.message : (err as Error).message;\n    attempts.push({ provider: 'grok', status, message });\n    logger?.warn('llm.failover', { from: 'grok', to: 'groq', status, message });\n  }\n\n  // Groq\n  try {\n    const json = await callProvider(\n      'groq',\n      {\n        url: 'https://api.groq.com/openai/v1/chat/completions',\n        headers: {\n          'content-type': 'application/json',\n          authorization: `Bearer ${env.GROQ_API_KEY}`,\n        },\n        body: buildOpenAIBody(opts.model ?? DEFAULT_GROQ_MODEL, messages, opts, opts.system),\n      },\n      fetchImpl,\n    );\n    const parsed = parseOpenAI(json);\n    return {\n      data: {\n        content: parsed.content,\n        provider: 'groq',\n        tokens: { input: parsed.input, output: parsed.output },\n        latency: now() - startedAt,\n      },\n      error: null,\n    };\n  } catch (err) {\n    const status = isProviderError(err) ? err.status : 0;\n    const message = isProviderError(err) ? err.message : (err as Error).message;\n    attempts.push({ provider: 'groq', status, message });\n    logger?.error('llm.all_providers_failed', undefined, { attempts });\n  }\n\n  return providerErrorResponse(attempts, false);\n}\n\nfunction providerErrorResponse(\n  attempts: Array<{ provider: LLMProvider; status?: number; message: string }>,\n  rateLimited: boolean,\n): FactoryResponse<LLMResult> {\n  const base: FactoryBaseError = rateLimited\n    ? new RateLimitError('LLM provider rate limited', { code: ErrorCodes.LLM_RATE_LIMITED, attempts })\n    : new InternalError('All LLM providers failed', {\n        code: ErrorCodes.LLM_ALL_PROVIDERS_FAILED,\n        attempts,\n      });\n  return {\n    data: null,\n    error: {\n      code: rateLimited ? ErrorCodes.LLM_RATE_LIMITED : ErrorCodes.LLM_ALL_PROVIDERS_FAILED,\n      message: base.message,\n      status: base.status,\n      retryable: base.retryable,\n      context: base.context,\n    },\n  };\n}\n\n/**\n * Streams a completion from Anthropic. No failover is performed for streaming\n * responses; callers should fall back to {@link complete} on failure.\n *\n * @param messages - Ordered chat history.\n * @param env - Anthropic API key binding.\n * @param opts - Optional model/parameters override.\n * @param deps - Optional fetch override (for testing).\n * @returns The raw Anthropic streaming response body.\n */\nexport async function stream(\n  messages: LLMMessage[],\n  env: { ANTHROPIC_API_KEY: string },\n  opts: LLMOptions = {},\n  deps: { fetch?: typeof fetch } = {},\n): Promise<ReadableStream<Uint8Array>> {\n  if (messages.length === 0) {\n    throw new ValidationError('messages must not be empty');\n  }\n  const fetchImpl = deps.fetch ?? fetch;\n  const body = JSON.parse(buildAnthropicBody(messages, opts, opts.system)) as Record<string, unknown>;\n  body.stream = true;\n  const response = await fetchImpl('https://api.anthropic.com/v1/messages', {\n    method: 'POST',\n    headers: {\n      'content-type': 'application/json',\n      'x-api-key': env.ANTHROPIC_API_KEY,\n      'anthropic-version': '2023-06-01',\n    },\n    body: JSON.stringify(body),\n  });\n  if (!response.ok || !response.body) {\n    throw new InternalError('Anthropic stream failed', {\n      code: ErrorCodes.LLM_ALL_PROVIDERS_FAILED,\n      status: response.status,\n    });\n  }\n  return response.body;\n}\n\n/**\n * Returns a {@link complete}-compatible function with a system prompt\n * pre-bound, so callers can hand around a domain-specific shortcut.\n *\n * @param system - System prompt to prepend to every call.\n * @returns A function that invokes {@link complete} with `system` injected.\n */\nexport function withSystem(\n  system: string,\n): (\n  messages: LLMMessage[],\n  env: LLMEnv,\n  opts?: LLMOptions,\n  deps?: LLMDeps,\n) => Promise<FactoryResponse<LLMResult>> {\n  return (messages, env, opts = {}, deps = {}) =>\n    complete(messages, env, { ...opts, system }, deps);\n}"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@latimer-woods-tech/llm",
+  "version": "0.2.0",
+  "private": false,
+  "publishConfig": {},
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "test": "vitest run --coverage",
+    "lint": "eslint src --max-warnings 0",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@latimer-woods-tech/errors": "^0.2.0",
+    "@latimer-woods-tech/logger": "^0.2.0"
+  },
+  "devDependencies": {
+    "@latimer-woods-tech/monitoring": "^0.2.0",
+    "@types/node": "^25.6.0",
+    "typescript": "^5.4.0",
+    "tsup": "^8.1.0",
+    "vitest": "^1.6.0",
+    "@vitest/coverage-v8": "^1.6.0",
+    "eslint": "^8.57.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0"
+  }
+}