@propio-ai/providers 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Isaac Heist
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# @propio-ai/providers
+
+Provider adapters for LLM APIs with a unified streaming chat interface. Supports Anthropic (Claude), AWS Bedrock, Ollama, OpenRouter, Google Gemini, xAI (Grok), and Cloudflare Workers AI.
+
+Extracted from [propio-agent](https://github.com/esack7/propio-agent), which uses it as its provider layer.
+
+## Install
+
+```bash
+npm install @propio-ai/providers
+```
+
+Requires Node.js >= 20. ESM only.
+
+## Usage
+
+```ts
+import { createProvider, type ChatStreamEvent } from "@propio-ai/providers";
+
+const provider = createProvider({
+  name: "claude",
+  type: "anthropic",
+  models: [
+    {
+      name: "Claude Sonnet",
+      key: "claude-sonnet-4-6",
+      contextWindowTokens: 200000,
+    },
+  ],
+  defaultModel: "claude-sonnet-4-6",
+  apiKey: process.env.ANTHROPIC_API_KEY,
+});
+
+for await (const event of provider.streamChat({
+  model: "claude-sonnet-4-6",
+  messages: [{ role: "user", content: "Hello!" }],
+})) {
+  if ("type" in event && event.type === "assistant_text") {
+    process.stdout.write(event.delta);
+  }
+}
+```
+
+## API
+
+### Factory
+
+- `createProvider(config, modelKey?, onDiagnosticEvent?, debugLoggingEnabled?, retryConfig?)` — instantiate an `LLMProvider` from a `ProviderConfig`
+- `extractModelFromConfig(config)` — read the default model key from a provider config
+
+### Provider contract
+
+`LLMProvider` exposes `name`, `getCapabilities()`, and `streamChat(request)`, which yields `ChatStreamEvent` values (`assistant_text`, `thinking_delta`, `tool_calls`, `status`, `reasoning_summary`, `terminal`).
+
+`ProviderCapabilities.supportsSyntheticToolCallHistory` is `false` for providers (currently Gemini) that reject caller-fabricated assistant tool-call history; callers should inline such content into a user message instead.
+
+### Configuration
+
+- `validateProvidersConfig(value)` — validate an arbitrary parsed value as a `ProvidersConfig`
+- `resolveProvider(config, name?)` / `resolveModelKey(provider, key?)`
+- `getDefaultProviderModelSelection(config)` / `updateDefaultProviderModelSelection(config, providerName, modelKey?)`
+- `loadProvidersConfig(filePath, options?)` / `loadProvidersConfigAsync(filePath, options?)` — load + validate from an explicit file path; `options.missingMessage` customizes the missing-file error
+- `writeProvidersConfig(filePath, config)` — atomic write
+- `updateDefaultProviderModelSelectionInFile(filePath, providerName, modelKey?)`
+
+### Errors
+
+`ProviderError` and subclasses `ProviderAuthenticationError`, `ProviderRateLimitError`, `ProviderCapacityError`, `ProviderModelNotFoundError`, `ProviderContextLengthError`.
+
+### Diagnostics
+
+Pass a `ProviderDiagnosticListener` to `createProvider` to receive `ProviderDiagnosticEvent`s (currently `provider_retry`, emitted when a request is retried).
+
+## Development
+
+```bash
+npm install
+npm test              # unit tests
+npm run test:integration  # live-API tests (needs provider credentials)
+npm run build
+```
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,91 @@
+/**
+ * A model entry containing both human-readable name and technical key.
+ * contextWindowTokens is required because providers do not maintain
+ * hardcoded per-model capability tables.
+ */
+export interface Model {
+    name: string;
+    key: string;
+    contextWindowTokens: number;
+}
+/**
+ * Base provider configuration with common fields
+ */
+export interface BaseProviderConfig {
+    name: string;
+    type: string;
+    models: Model[];
+    defaultModel: string;
+}
+/**
+ * Ollama provider configuration with flat structure
+ */
+export interface OllamaProviderConfig extends BaseProviderConfig {
+    type: "ollama";
+    host?: string;
+}
+/**
+ * Bedrock provider configuration with flat structure
+ */
+export interface BedrockProviderConfig extends BaseProviderConfig {
+    type: "bedrock";
+    region?: string;
+}
+/**
+ * OpenRouter provider configuration with flat structure
+ */
+export interface OpenRouterRoutingConfig {
+    allowFallbacks?: boolean;
+    order?: string[];
+    requireParameters?: boolean;
+}
+export interface OpenRouterProviderConfig extends BaseProviderConfig {
+    type: "openrouter";
+    apiKey?: string;
+    httpReferer?: string;
+    xTitle?: string;
+    provider?: OpenRouterRoutingConfig;
+    fallbackModels?: string[];
+    debugEchoUpstreamBody?: boolean;
+}
+/**
+ * xAI (Grok) provider configuration using the OpenAI-compatible API at api.x.ai
+ */
+export interface XaiProviderConfig extends BaseProviderConfig {
+    type: "xai";
+    apiKey?: string;
+}
+/**
+ * Cloudflare Workers AI provider configuration using the OpenAI-compatible API.
+ */
+export interface CloudflareProviderConfig extends BaseProviderConfig {
+    type: "cloudflare";
+    apiKey?: string;
+    accountId?: string;
+}
+/**
+ * Gemini provider configuration using Google's OpenAI-compatible API.
+ */
+export interface GeminiProviderConfig extends BaseProviderConfig {
+    type: "gemini";
+    apiKey?: string;
+}
+/**
+ * Anthropic (Claude API) provider configuration
+ */
+export interface AnthropicProviderConfig extends BaseProviderConfig {
+    type: "anthropic";
+    apiKey?: string;
+}
+/**
+ * Configuration for a single LLM provider (discriminated union)
+ */
+export type ProviderConfig = OllamaProviderConfig | BedrockProviderConfig | OpenRouterProviderConfig | GeminiProviderConfig | XaiProviderConfig | CloudflareProviderConfig | AnthropicProviderConfig;
+/**
+ * Multi-provider configuration
+ */
+export interface ProvidersConfig {
+    default: string;
+    providers: ProviderConfig[];
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAClE,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAClE,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IACjE,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,oBAAoB,GACpB,qBAAqB,GACrB,wBAAwB,GACxB,oBAAoB,GACpB,iBAAiB,GACjB,wBAAwB,GACxB,uBAAuB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B"}

package/dist/config.js

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

package/dist/config.js.map

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

package/dist/configFile.d.ts

@@ -0,0 +1,22 @@
+import { ProvidersConfig } from "./config.js";
+export interface LoadProvidersConfigOptions {
+    /**
+     * Message thrown when the config file does not exist. Defaults to a
+     * generic "Configuration file not found" message; consumers can inject
+     * application-specific guidance here.
+     */
+    readonly missingMessage?: string;
+}
+/**
+ * Load and validate a ProvidersConfig from a JSON file
+ *
+ * @param filePath - Path to the providers config JSON file
+ * @param options - Optional overrides such as the missing-file message
+ * @returns ProvidersConfig object with all validation completed
+ * @throws Error if file not found, invalid JSON, validation fails, or references are invalid
+ */
+export declare function loadProvidersConfig(filePath: string, options?: LoadProvidersConfigOptions): ProvidersConfig;
+export declare function loadProvidersConfigAsync(filePath: string, options?: LoadProvidersConfigOptions): Promise<ProvidersConfig>;
+export declare function writeProvidersConfig(filePath: string, config: ProvidersConfig): void;
+export declare function updateDefaultProviderModelSelectionInFile(filePath: string, providerName: string, modelKey?: string): ProvidersConfig;
+//# sourceMappingURL=configFile.d.ts.map

package/dist/configFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configFile.d.ts","sourceRoot":"","sources":["../src/configFile.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAM9C,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAWD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,0BAA0B,GACnC,eAAe,CAIjB;AAED,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,eAAe,CAAC,CAI1B;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,GACtB,IAAI,CAEN;AAED,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,eAAe,CASjB"}

package/dist/configFile.js

@@ -0,0 +1,33 @@
+import { readJsonFile, readJsonFileAsync, writeJsonFileAtomic, } from "./internal/jsonFile.js";
+import { validateProvidersConfig, updateDefaultProviderModelSelection, } from "./configValidation.js";
+function readOptions(filePath, options) {
+    return {
+        invalidJsonPrefix: "Invalid JSON in configuration file",
+        missingMessage: options?.missingMessage ?? `Configuration file not found: ${filePath}`,
+        readErrorPrefix: "Failed to read configuration file",
+    };
+}
+/**
+ * Load and validate a ProvidersConfig from a JSON file
+ *
+ * @param filePath - Path to the providers config JSON file
+ * @param options - Optional overrides such as the missing-file message
+ * @returns ProvidersConfig object with all validation completed
+ * @throws Error if file not found, invalid JSON, validation fails, or references are invalid
+ */
+export function loadProvidersConfig(filePath, options) {
+    return validateProvidersConfig(readJsonFile(filePath, readOptions(filePath, options)));
+}
+export async function loadProvidersConfigAsync(filePath, options) {
+    return validateProvidersConfig(await readJsonFileAsync(filePath, readOptions(filePath, options)));
+}
+export function writeProvidersConfig(filePath, config) {
+    writeJsonFileAtomic(filePath, "providers", config);
+}
+export function updateDefaultProviderModelSelectionInFile(filePath, providerName, modelKey) {
+    const config = loadProvidersConfig(filePath);
+    const updatedConfig = updateDefaultProviderModelSelection(config, providerName, modelKey);
+    writeProvidersConfig(filePath, updatedConfig);
+    return updatedConfig;
+}
+//# sourceMappingURL=configFile.js.map

package/dist/configFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configFile.js","sourceRoot":"","sources":["../src/configFile.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,uBAAuB,EACvB,mCAAmC,GACpC,MAAM,uBAAuB,CAAC;AAW/B,SAAS,WAAW,CAAC,QAAgB,EAAE,OAAoC;IACzE,OAAO;QACL,iBAAiB,EAAE,oCAAoC;QACvD,cAAc,EACZ,OAAO,EAAE,cAAc,IAAI,iCAAiC,QAAQ,EAAE;QACxE,eAAe,EAAE,mCAAmC;KACrD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,OAAoC;IAEpC,OAAO,uBAAuB,CAC5B,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,QAAgB,EAChB,OAAoC;IAEpC,OAAO,uBAAuB,CAC5B,MAAM,iBAAiB,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAClE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,MAAuB;IAEvB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,yCAAyC,CACvD,QAAgB,EAChB,YAAoB,EACpB,QAAiB;IAEjB,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,aAAa,GAAG,mCAAmC,CACvD,MAAM,EACN,YAAY,EACZ,QAAQ,CACT,CAAC;IACF,oBAAoB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC9C,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/configValidation.d.ts

@@ -0,0 +1,34 @@
+import { ProvidersConfig, ProviderConfig } from "./config.js";
+export interface ProviderModelSelection {
+    readonly providerName: string;
+    readonly modelKey: string;
+}
+/**
+ * Validate an arbitrary value as a ProvidersConfig
+ *
+ * @param config - The parsed configuration value to validate
+ * @returns ProvidersConfig object with all validation completed
+ * @throws Error if validation fails or references are invalid
+ */
+export declare function validateProvidersConfig(config: unknown): ProvidersConfig;
+/**
+ * Resolve a provider from ProvidersConfig by name
+ *
+ * @param config - The providers configuration
+ * @param providerName - Optional provider name. If not provided, uses config.default
+ * @returns The resolved ProviderConfig
+ * @throws Error if provider not found
+ */
+export declare function resolveProvider(config: ProvidersConfig, providerName?: string): ProviderConfig;
+/**
+ * Resolve a model key from a ProviderConfig
+ *
+ * @param provider - The provider configuration
+ * @param modelKey - Optional model key. If not provided, uses provider.defaultModel
+ * @returns The resolved model key
+ * @throws Error if model key not found
+ */
+export declare function resolveModelKey(provider: ProviderConfig, modelKey?: string): string;
+export declare function getDefaultProviderModelSelection(config: ProvidersConfig): ProviderModelSelection;
+export declare function updateDefaultProviderModelSelection(config: ProvidersConfig, providerName: string, modelKey?: string): ProvidersConfig;
+//# sourceMappingURL=configValidation.d.ts.map

package/dist/configValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configValidation.d.ts","sourceRoot":"","sources":["../src/configValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG9D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAkBD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,CAoCxE;AAwKD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,cAAc,CAYhB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAYR;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,eAAe,GACtB,sBAAsB,CAMxB;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,eAAe,EACvB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,eAAe,CAejB"}

package/dist/configValidation.js

@@ -0,0 +1,185 @@
+import { validateContextWindowTokens } from "./internal/capabilities.js";
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function isNonEmptyStringArray(value) {
+    return (Array.isArray(value) &&
+        value.length > 0 &&
+        value.every((item) => isNonEmptyString(item)));
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Validate an arbitrary value as a ProvidersConfig
+ *
+ * @param config - The parsed configuration value to validate
+ * @returns ProvidersConfig object with all validation completed
+ * @throws Error if validation fails or references are invalid
+ */
+export function validateProvidersConfig(config) {
+    if (!isPlainObject(config)) {
+        throw new Error("Configuration root must be a JSON object");
+    }
+    const candidate = config;
+    // Validate required fields exist
+    if (!candidate.providers) {
+        throw new Error('Configuration must include a "providers" array');
+    }
+    if (candidate.default === undefined) {
+        throw new Error('Configuration must include a "default" field specifying default provider');
+    }
+    // Validate that default references an existing provider
+    const defaultProviderExists = candidate.providers.some((p) => p.name === candidate.default);
+    if (!defaultProviderExists) {
+        const availableProviders = candidate.providers
+            .map((p) => p.name)
+            .join(", ");
+        throw new Error(`Default provider "${candidate.default}" not found in providers list. Available: ${availableProviders}`);
+    }
+    // Validate each provider
+    const seenNames = new Set();
+    for (const provider of candidate.providers) {
+        validateProviderConfig(provider, seenNames);
+    }
+    return candidate;
+}
+/**
+ * Validate a single provider configuration
+ */
+function validateProviderConfig(provider, seenNames) {
+    validateProviderRequiredFields(provider);
+    validateUniqueProviderName(provider.name, seenNames);
+    validateProviderModels(provider);
+    if (provider.type === "openrouter") {
+        validateOpenRouterProviderConfig(provider);
+    }
+    validateDefaultModel(provider);
+}
+function validateProviderRequiredFields(provider) {
+    const requiredFields = ["name", "type", "models", "defaultModel"];
+    const missingFields = requiredFields.filter((field) => !provider[field]);
+    if (missingFields.length > 0) {
+        throw new Error(`Provider is missing required fields: ${missingFields.join(", ")}`);
+    }
+}
+function validateUniqueProviderName(providerName, seenNames) {
+    if (seenNames.has(providerName)) {
+        throw new Error(`Duplicate provider name: "${providerName}". Provider names must be unique.`);
+    }
+    seenNames.add(providerName);
+}
+function validateProviderModels(provider) {
+    if (!Array.isArray(provider.models) || provider.models.length === 0) {
+        throw new Error(`Provider "${provider.name}" must have at least one model in the models array`);
+    }
+    const seenModelKeys = new Set();
+    for (const model of provider.models) {
+        validateProviderModel(provider.name, model, seenModelKeys);
+    }
+}
+function validateProviderModel(providerName, model, seenModelKeys) {
+    validateModelRequiredFields(providerName, model);
+    validateContextWindowTokens(model.contextWindowTokens, `Provider "${providerName}" model "${model.key}" contextWindowTokens`);
+    validateUniqueModelKey(providerName, model.key, seenModelKeys);
+}
+function validateModelRequiredFields(providerName, model) {
+    if (!model.name || !model.key) {
+        throw new Error(`Provider "${providerName}" has model missing required fields: each model must have "name", "key", and "contextWindowTokens"`);
+    }
+    if (model.contextWindowTokens === undefined) {
+        throw new Error(`Provider "${providerName}" model "${model.key}" is missing required field "contextWindowTokens"`);
+    }
+}
+function validateUniqueModelKey(providerName, modelKey, seenModelKeys) {
+    if (seenModelKeys.has(modelKey)) {
+        throw new Error(`Provider "${providerName}" has duplicate model key: "${modelKey}". Model keys must be unique within a provider.`);
+    }
+    seenModelKeys.add(modelKey);
+}
+function validateDefaultModel(provider) {
+    const defaultModelExists = provider.models.some((m) => m.key === provider.defaultModel);
+    if (!defaultModelExists) {
+        const availableModels = provider.models.map((m) => m.key).join(", ");
+        throw new Error(`Provider "${provider.name}" defaultModel "${provider.defaultModel}" not found in models list. Available: ${availableModels}`);
+    }
+}
+function validateOpenRouterProviderConfig(provider) {
+    if (provider.provider !== undefined) {
+        validateOpenRouterRoutingConfig(provider.name, provider.provider);
+    }
+    validateOptionalStringArray(provider.name, "fallbackModels", provider.fallbackModels);
+    validateOptionalBoolean(provider.name, "debugEchoUpstreamBody", provider.debugEchoUpstreamBody);
+}
+function validateOpenRouterRoutingConfig(providerName, routing) {
+    if (!isPlainObject(routing)) {
+        throw new Error(`Provider "${providerName}" OpenRouter "provider" field must be an object`);
+    }
+    validateOptionalBoolean(providerName, "provider.allowFallbacks", routing.allowFallbacks);
+    validateOptionalBoolean(providerName, "provider.requireParameters", routing.requireParameters);
+    validateOptionalStringArray(providerName, "provider.order", routing.order);
+}
+function validateOptionalBoolean(providerName, fieldName, value) {
+    if (value !== undefined && typeof value !== "boolean") {
+        throw new Error(`Provider "${providerName}" OpenRouter "${fieldName}" must be a boolean`);
+    }
+}
+function validateOptionalStringArray(providerName, fieldName, value) {
+    if (value !== undefined && !isNonEmptyStringArray(value)) {
+        throw new Error(`Provider "${providerName}" OpenRouter "${fieldName}" must be a non-empty array of non-empty strings`);
+    }
+}
+/**
+ * Resolve a provider from ProvidersConfig by name
+ *
+ * @param config - The providers configuration
+ * @param providerName - Optional provider name. If not provided, uses config.default
+ * @returns The resolved ProviderConfig
+ * @throws Error if provider not found
+ */
+export function resolveProvider(config, providerName) {
+    const name = providerName || config.default;
+    const provider = config.providers.find((p) => p.name === name);
+    if (!provider) {
+        const availableProviders = config.providers.map((p) => p.name).join(", ");
+        throw new Error(`Unknown provider: "${name}". Available providers: ${availableProviders}`);
+    }
+    return provider;
+}
+/**
+ * Resolve a model key from a ProviderConfig
+ *
+ * @param provider - The provider configuration
+ * @param modelKey - Optional model key. If not provided, uses provider.defaultModel
+ * @returns The resolved model key
+ * @throws Error if model key not found
+ */
+export function resolveModelKey(provider, modelKey) {
+    const key = modelKey || provider.defaultModel;
+    const model = provider.models.find((m) => m.key === key);
+    if (!model) {
+        const availableModels = provider.models.map((m) => m.key).join(", ");
+        throw new Error(`Invalid model key: "${key}" for provider "${provider.name}". Available models: ${availableModels}`);
+    }
+    return key;
+}
+export function getDefaultProviderModelSelection(config) {
+    const provider = resolveProvider(config);
+    return {
+        providerName: provider.name,
+        modelKey: provider.defaultModel,
+    };
+}
+export function updateDefaultProviderModelSelection(config, providerName, modelKey) {
+    const provider = resolveProvider(config, providerName);
+    const resolvedModelKey = resolveModelKey(provider, modelKey);
+    const updatedConfig = {
+        ...config,
+        default: provider.name,
+        providers: config.providers.map((entry) => entry.name === provider.name
+            ? { ...entry, defaultModel: resolvedModelKey }
+            : entry),
+    };
+    return validateProvidersConfig(updatedConfig);
+}
+//# sourceMappingURL=configValidation.js.map

package/dist/configValidation.js.map

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

package/dist/diagnostics.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Diagnostic events emitted by providers.
+ *
+ * Providers report operational events (currently only retries) through an
+ * optional listener callback. Consumers can forward these into their own
+ * diagnostics pipelines; the event shapes are stable, provider-owned types.
+ */
+/**
+ * Emitted when a provider retries a failed request.
+ */
+export interface ProviderRetryDiagnosticEvent {
+    type: "provider_retry";
+    provider: string;
+    model: string;
+    iteration: number;
+    reason: string;
+    attemptNumber: number;
+    delayMs: number;
+}
+export type ProviderDiagnosticEvent = ProviderRetryDiagnosticEvent;
+export type ProviderDiagnosticListener = (event: ProviderDiagnosticEvent) => void;
+/**
+ * Retry behavior configuration accepted by providers and the factory.
+ */
+export interface ProviderRetryConfig {
+    maxRetries: number;
+    consecutive529Limit: number;
+}
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,uBAAuB,GAAG,4BAA4B,CAAC;AAEnE,MAAM,MAAM,0BAA0B,GAAG,CACvC,KAAK,EAAE,uBAAuB,KAC3B,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;CAC7B"}

package/dist/diagnostics.js

@@ -0,0 +1,9 @@
+/**
+ * Diagnostic events emitted by providers.
+ *
+ * Providers report operational events (currently only retries) through an
+ * optional listener callback. Consumers can forward these into their own
+ * diagnostics pipelines; the event shapes are stable, provider-owned types.
+ */
+export {};
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/factory.d.ts

@@ -0,0 +1,56 @@
+import { LLMProvider } from "./interface.js";
+import { ProviderConfig } from "./config.js";
+import type { ProviderDiagnosticListener, ProviderRetryConfig } from "./diagnostics.js";
+/**
+ * Factory function to create LLM provider instances from configuration.
+ *
+ * This factory encapsulates provider instantiation logic, allowing new providers to be added
+ * without modifying the Agent class. The factory uses a switch statement on type field
+ * to determine which provider class to instantiate.
+ *
+ * @param config - Provider configuration containing type field and provider-specific settings
+ * @param modelKey - Optional model key override. If provided, uses this instead of config.defaultModel
+ * @returns An LLMProvider interface instance configured according to the provided config
+ * @throws Error if the provider type is unknown or unsupported
+ *
+ * @example
+ * // Create an Ollama provider
+ * const ollamaProvider = createProvider({
+ *   name: 'local-ollama',
+ *   type: 'ollama',
+ *   models: [{ name: 'Llama', key: 'llama3.2', contextWindowTokens: 8192 }],
+ *   defaultModel: 'llama3.2',
+ *   host: 'http://localhost:11434'
+ * });
+ *
+ * @example
+ * // Create a Bedrock provider with specific model
+ * const bedrockProvider = createProvider({
+ *   name: 'bedrock',
+ *   type: 'bedrock',
+ *   models: [{ name: 'Claude 3.5', key: 'anthropic.claude-3-5-sonnet-20241022-v2:0', contextWindowTokens: 200000 }],
+ *   defaultModel: 'anthropic.claude-3-5-sonnet-20241022-v2:0',
+ *   region: 'us-west-2'
+ * }, 'anthropic.claude-3-5-sonnet-20241022-v2:0');
+ */
+export declare function createProvider(config: ProviderConfig, modelKey?: string, onDiagnosticEvent?: ProviderDiagnosticListener, debugLoggingEnabled?: boolean, retryConfig?: ProviderRetryConfig): LLMProvider;
+/**
+ * Extract the default model name from a provider configuration.
+ *
+ * This utility function provides a centralized way to extract the default model name from any
+ * provider configuration type. All provider configs now have a top-level defaultModel field.
+ *
+ * @param config - The provider configuration object
+ * @returns The default model key string
+ *
+ * @example
+ * const model = extractModelFromConfig({
+ *   name: 'ollama',
+ *   type: 'ollama',
+ *   models: [{ name: 'Llama', key: 'llama3.2', contextWindowTokens: 8192 }],
+ *   defaultModel: 'llama3.2'
+ * });
+ * console.log(model); // 'llama3.2'
+ */
+export declare function extractModelFromConfig(config: ProviderConfig): string;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,cAAc,EASf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,0BAA0B,EAC1B,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAS1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,iBAAiB,CAAC,EAAE,0BAA0B,EAC9C,mBAAmB,UAAQ,EAC3B,WAAW,CAAC,EAAE,mBAAmB,GAChC,WAAW,CA0Gb;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAErE"}