@rowan-agent/models 0.4.4

package/dist/index.d.cts

@@ -0,0 +1,109 @@
+import { M as Model, L as LlmTokenUsage, P as Provider, A as Api, a as ApiStreamFn, S as StreamFn, b as LlmRequest, c as LlmStreamOptions, d as LlmStreamEvent } from './index-ChnUfIk1.cjs';
+export { e as AgentContextMessage, f as AgentContextSkill, g as AgentEvent, h as AgentEventListener, i as AnthropicConfig, j as AssistantMessagePartial, B as BaseProviderConfig, C as ContentBlock, K as KnownApi, k as KnownProvider, l as LlmContentPart, m as LlmImageContent, n as LlmMessage, o as LlmModelRef, p as LlmModelUsage, q as LlmResponse, r as LlmStopReason, s as LlmTextContent, t as LlmThinkingContent, u as LlmToolCall, v as LlmToolChoice, w as LlmToolDefinition, x as LlmToolResultContent, y as LlmToolUseContent, z as ModelCost, O as OpenAICompletionsConfig, D as OpenAIResponsesConfig, E as Outcome, F as ProviderConfig, G as ProviderError, H as ProviderFetch, I as ProviderModelConfig, R as ResolveAnthropicConfigInput, J as ResolveOpenAICompletionsConfigInput, N as ResolveOpenAIResponsesConfigInput, T as TextBlock, Q as ThinkingBlock, U as ToolCall, V as ToolCallBlock, W as ToolResult, X as callOpenAICompletions, Y as createAnthropicStream, Z as createOpenAICompletionsStream, _ as createOpenAIResponsesStream, $ as resolveAnthropicConfig, a0 as resolveOpenAICompletionsConfig, a1 as resolveOpenAIResponsesConfig, a2 as streamAnthropic, a3 as streamOpenAICompletions, a4 as streamOpenAIResponses, a5 as textFromPartial, a6 as toolCallsFromPartial } from './index-ChnUfIk1.cjs';
+
+interface ServerSentEvent {
+    event: string | null;
+    data: string;
+}
+declare function iterateSseMessages(body: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<ServerSentEvent>;
+
+/**
+ * Register a model in the registry. Models are keyed by (provider, id).
+ */
+declare function registerModel(model: Model): void;
+/**
+ * Look up a model by provider and model id.
+ */
+declare function getModel(provider: string, modelId: string): Model | undefined;
+/**
+ * Look up a model by a combined "provider/model" string (e.g. "anthropic/claude-sonnet-4-20250514").
+ */
+declare function resolveModel(ref: string): Model | undefined;
+/**
+ * Get all registered provider names.
+ */
+declare function getProviders(): Provider[];
+/**
+ * Get all models for a given provider.
+ */
+declare function getModels(provider: string): Model[];
+/**
+ * Get all registered models across all providers.
+ */
+declare function getAllModels(): Model[];
+/**
+ * Clear all registered models. Useful for testing.
+ */
+declare function clearModels(): void;
+/**
+ * Unregister all models for a given provider. Returns the number of models removed.
+ */
+declare function unregisterProviderModels(provider: string): number;
+declare function calculateCost(model: Model, usage: LlmTokenUsage): {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    total: number;
+};
+
+/**
+ * Static model catalog.
+ * This file is manually maintained. Run `bun run generate-models` to auto-generate
+ * from an upstream source when available.
+ */
+
+declare const MODELS: Record<string, Record<string, Model>>;
+
+interface ApiProvider {
+    api: Api;
+    stream: ApiStreamFn;
+}
+/**
+ * Register a provider for a given API protocol.
+ * When a model with `api === provider.api` is used, this provider handles it.
+ */
+declare function registerApiProvider(provider: ApiProvider): void;
+/**
+ * Look up a registered API provider by protocol name.
+ */
+declare function getApiProvider(api: Api): ApiProvider | undefined;
+/**
+ * List all registered API protocol names.
+ */
+declare function listApiProviders(): Api[];
+/**
+ * Clear all registered API providers.
+ */
+declare function clearApiProviders(): void;
+/**
+ * Unregister an API provider by protocol name.
+ * Returns true if a provider was removed.
+ */
+declare function unregisterApiProvider(api: Api): boolean;
+/**
+ * Register all built-in API providers.
+ * Each provider resolves its config from the Model descriptor and environment.
+ */
+declare function registerBuiltInApiProviders(): void;
+/**
+ * Resolve the API provider for a model and stream the request.
+ * This is the main entry point for model-based dispatch.
+ */
+declare function stream(model: Model, request: LlmRequest, options: LlmStreamOptions): AsyncIterable<LlmStreamEvent>;
+/**
+ * Convenience: resolve model from a "provider/model" string or LlmModelRef,
+ * then stream.
+ */
+declare function streamByRef(ref: string | {
+    provider: string;
+    name: string;
+}, request: Omit<LlmRequest, "model">, options?: LlmStreamOptions): AsyncIterable<LlmStreamEvent>;
+type ProviderFactory = (model: {
+    provider: string;
+    name: string;
+}) => StreamFn;
+declare function registerProvider(name: string, factory: ProviderFactory): void;
+declare function createDispatchStream(): StreamFn;
+
+export { Api, type ApiProvider, ApiStreamFn, LlmRequest, LlmStreamEvent, LlmStreamOptions, LlmTokenUsage, MODELS, Model, Provider, type ProviderFactory, type ServerSentEvent, StreamFn, calculateCost, clearApiProviders, clearModels, createDispatchStream, getAllModels, getApiProvider, getModel, getModels, getProviders, iterateSseMessages, listApiProviders, registerApiProvider, registerBuiltInApiProviders, registerModel, registerProvider, resolveModel, stream, streamByRef, unregisterApiProvider, unregisterProviderModels };

package/dist/index.d.ts

@@ -0,0 +1,109 @@
+import { M as Model, L as LlmTokenUsage, P as Provider, A as Api, a as ApiStreamFn, S as StreamFn, b as LlmRequest, c as LlmStreamOptions, d as LlmStreamEvent } from './index-ChnUfIk1.js';
+export { e as AgentContextMessage, f as AgentContextSkill, g as AgentEvent, h as AgentEventListener, i as AnthropicConfig, j as AssistantMessagePartial, B as BaseProviderConfig, C as ContentBlock, K as KnownApi, k as KnownProvider, l as LlmContentPart, m as LlmImageContent, n as LlmMessage, o as LlmModelRef, p as LlmModelUsage, q as LlmResponse, r as LlmStopReason, s as LlmTextContent, t as LlmThinkingContent, u as LlmToolCall, v as LlmToolChoice, w as LlmToolDefinition, x as LlmToolResultContent, y as LlmToolUseContent, z as ModelCost, O as OpenAICompletionsConfig, D as OpenAIResponsesConfig, E as Outcome, F as ProviderConfig, G as ProviderError, H as ProviderFetch, I as ProviderModelConfig, R as ResolveAnthropicConfigInput, J as ResolveOpenAICompletionsConfigInput, N as ResolveOpenAIResponsesConfigInput, T as TextBlock, Q as ThinkingBlock, U as ToolCall, V as ToolCallBlock, W as ToolResult, X as callOpenAICompletions, Y as createAnthropicStream, Z as createOpenAICompletionsStream, _ as createOpenAIResponsesStream, $ as resolveAnthropicConfig, a0 as resolveOpenAICompletionsConfig, a1 as resolveOpenAIResponsesConfig, a2 as streamAnthropic, a3 as streamOpenAICompletions, a4 as streamOpenAIResponses, a5 as textFromPartial, a6 as toolCallsFromPartial } from './index-ChnUfIk1.js';
+
+interface ServerSentEvent {
+    event: string | null;
+    data: string;
+}
+declare function iterateSseMessages(body: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<ServerSentEvent>;
+
+/**
+ * Register a model in the registry. Models are keyed by (provider, id).
+ */
+declare function registerModel(model: Model): void;
+/**
+ * Look up a model by provider and model id.
+ */
+declare function getModel(provider: string, modelId: string): Model | undefined;
+/**
+ * Look up a model by a combined "provider/model" string (e.g. "anthropic/claude-sonnet-4-20250514").
+ */
+declare function resolveModel(ref: string): Model | undefined;
+/**
+ * Get all registered provider names.
+ */
+declare function getProviders(): Provider[];
+/**
+ * Get all models for a given provider.
+ */
+declare function getModels(provider: string): Model[];
+/**
+ * Get all registered models across all providers.
+ */
+declare function getAllModels(): Model[];
+/**
+ * Clear all registered models. Useful for testing.
+ */
+declare function clearModels(): void;
+/**
+ * Unregister all models for a given provider. Returns the number of models removed.
+ */
+declare function unregisterProviderModels(provider: string): number;
+declare function calculateCost(model: Model, usage: LlmTokenUsage): {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    total: number;
+};
+
+/**
+ * Static model catalog.
+ * This file is manually maintained. Run `bun run generate-models` to auto-generate
+ * from an upstream source when available.
+ */
+
+declare const MODELS: Record<string, Record<string, Model>>;
+
+interface ApiProvider {
+    api: Api;
+    stream: ApiStreamFn;
+}
+/**
+ * Register a provider for a given API protocol.
+ * When a model with `api === provider.api` is used, this provider handles it.
+ */
+declare function registerApiProvider(provider: ApiProvider): void;
+/**
+ * Look up a registered API provider by protocol name.
+ */
+declare function getApiProvider(api: Api): ApiProvider | undefined;
+/**
+ * List all registered API protocol names.
+ */
+declare function listApiProviders(): Api[];
+/**
+ * Clear all registered API providers.
+ */
+declare function clearApiProviders(): void;
+/**
+ * Unregister an API provider by protocol name.
+ * Returns true if a provider was removed.
+ */
+declare function unregisterApiProvider(api: Api): boolean;
+/**
+ * Register all built-in API providers.
+ * Each provider resolves its config from the Model descriptor and environment.
+ */
+declare function registerBuiltInApiProviders(): void;
+/**
+ * Resolve the API provider for a model and stream the request.
+ * This is the main entry point for model-based dispatch.
+ */
+declare function stream(model: Model, request: LlmRequest, options: LlmStreamOptions): AsyncIterable<LlmStreamEvent>;
+/**
+ * Convenience: resolve model from a "provider/model" string or LlmModelRef,
+ * then stream.
+ */
+declare function streamByRef(ref: string | {
+    provider: string;
+    name: string;
+}, request: Omit<LlmRequest, "model">, options?: LlmStreamOptions): AsyncIterable<LlmStreamEvent>;
+type ProviderFactory = (model: {
+    provider: string;
+    name: string;
+}) => StreamFn;
+declare function registerProvider(name: string, factory: ProviderFactory): void;
+declare function createDispatchStream(): StreamFn;
+
+export { Api, type ApiProvider, ApiStreamFn, LlmRequest, LlmStreamEvent, LlmStreamOptions, LlmTokenUsage, MODELS, Model, Provider, type ProviderFactory, type ServerSentEvent, StreamFn, calculateCost, clearApiProviders, clearModels, createDispatchStream, getAllModels, getApiProvider, getModel, getModels, getProviders, iterateSseMessages, listApiProviders, registerApiProvider, registerBuiltInApiProviders, registerModel, registerProvider, resolveModel, stream, streamByRef, unregisterApiProvider, unregisterProviderModels };

package/dist/index.js

@@ -0,0 +1,337 @@
+import {
+  ProviderError,
+  callOpenAICompletions,
+  createAnthropicStream,
+  createOpenAICompletionsStream,
+  createOpenAIResponsesStream,
+  iterateSseMessages,
+  resolveAnthropicConfig,
+  resolveOpenAICompletionsConfig,
+  resolveOpenAIResponsesConfig,
+  streamAnthropic,
+  streamOpenAICompletions,
+  streamOpenAIResponses
+} from "./chunk-J6S6ZJJA.js";
+
+// src/protocol.ts
+function textFromPartial(partial) {
+  return partial.contentBlocks.filter((b) => b.type === "text").map((b) => b.text).join("");
+}
+function toolCallsFromPartial(partial) {
+  return partial.contentBlocks.filter((b) => b.type === "tool_call");
+}
+
+// src/models.ts
+var modelRegistry = /* @__PURE__ */ new Map();
+function registerModel(model) {
+  let providerModels = modelRegistry.get(model.provider);
+  if (!providerModels) {
+    providerModels = /* @__PURE__ */ new Map();
+    modelRegistry.set(model.provider, providerModels);
+  }
+  providerModels.set(model.id, model);
+}
+function getModel(provider, modelId) {
+  return modelRegistry.get(provider)?.get(modelId);
+}
+function resolveModel(ref) {
+  const slashIndex = ref.indexOf("/");
+  if (slashIndex === -1) {
+    for (const models of modelRegistry.values()) {
+      const found = models.get(ref);
+      if (found) return found;
+    }
+    return void 0;
+  }
+  const provider = ref.slice(0, slashIndex);
+  const modelId = ref.slice(slashIndex + 1);
+  return getModel(provider, modelId);
+}
+function getProviders() {
+  return [...modelRegistry.keys()];
+}
+function getModels(provider) {
+  const models = modelRegistry.get(provider);
+  return models ? [...models.values()] : [];
+}
+function getAllModels() {
+  const result = [];
+  for (const models of modelRegistry.values()) {
+    result.push(...models.values());
+  }
+  return result;
+}
+function clearModels() {
+  modelRegistry.clear();
+}
+function unregisterProviderModels(provider) {
+  const models = modelRegistry.get(provider);
+  if (!models) return 0;
+  const count = models.size;
+  modelRegistry.delete(provider);
+  return count;
+}
+function calculateCost(model, usage) {
+  const input = (usage.inputTokens ?? 0) / 1e6 * model.cost.input;
+  const output = (usage.outputTokens ?? 0) / 1e6 * model.cost.output;
+  const cacheRead = (usage.cacheReadTokens ?? 0) / 1e6 * model.cost.cacheRead;
+  const cacheWrite = (usage.cacheWriteTokens ?? 0) / 1e6 * model.cost.cacheWrite;
+  return { input, output, cacheRead, cacheWrite, total: input + output + cacheRead + cacheWrite };
+}
+
+// src/models.generated.ts
+var MODELS = {
+  anthropic: {
+    "claude-sonnet-4-20250514": {
+      id: "claude-sonnet-4-20250514",
+      name: "Claude Sonnet 4",
+      api: "anthropic-messages",
+      provider: "anthropic",
+      baseUrl: "https://api.anthropic.com",
+      reasoning: true,
+      input: ["text", "image"],
+      cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
+      contextWindow: 2e5,
+      maxTokens: 16e3
+    },
+    "claude-opus-4-20250514": {
+      id: "claude-opus-4-20250514",
+      name: "Claude Opus 4",
+      api: "anthropic-messages",
+      provider: "anthropic",
+      baseUrl: "https://api.anthropic.com",
+      reasoning: true,
+      input: ["text", "image"],
+      cost: { input: 15, output: 75, cacheRead: 1.5, cacheWrite: 18.75 },
+      contextWindow: 2e5,
+      maxTokens: 32e3
+    },
+    "claude-haiku-4-20250514": {
+      id: "claude-haiku-4-20250514",
+      name: "Claude Haiku 4",
+      api: "anthropic-messages",
+      provider: "anthropic",
+      baseUrl: "https://api.anthropic.com",
+      reasoning: false,
+      input: ["text", "image"],
+      cost: { input: 0.8, output: 4, cacheRead: 0.08, cacheWrite: 1 },
+      contextWindow: 2e5,
+      maxTokens: 8192
+    }
+  },
+  openai: {
+    "gpt-4o": {
+      id: "gpt-4o",
+      name: "GPT-4o",
+      api: "openai-completions",
+      provider: "openai",
+      baseUrl: "https://api.openai.com/v1",
+      reasoning: false,
+      input: ["text", "image"],
+      cost: { input: 2.5, output: 10, cacheRead: 1.25, cacheWrite: 0 },
+      contextWindow: 128e3,
+      maxTokens: 16384
+    },
+    "gpt-4o-mini": {
+      id: "gpt-4o-mini",
+      name: "GPT-4o Mini",
+      api: "openai-completions",
+      provider: "openai",
+      baseUrl: "https://api.openai.com/v1",
+      reasoning: false,
+      input: ["text", "image"],
+      cost: { input: 0.15, output: 0.6, cacheRead: 0.075, cacheWrite: 0 },
+      contextWindow: 128e3,
+      maxTokens: 16384
+    },
+    "o3": {
+      id: "o3",
+      name: "o3",
+      api: "openai-responses",
+      provider: "openai",
+      baseUrl: "https://api.openai.com/v1",
+      reasoning: true,
+      input: ["text", "image"],
+      cost: { input: 2, output: 8, cacheRead: 0.5, cacheWrite: 0 },
+      contextWindow: 2e5,
+      maxTokens: 1e5
+    },
+    "o4-mini": {
+      id: "o4-mini",
+      name: "o4-mini",
+      api: "openai-responses",
+      provider: "openai",
+      baseUrl: "https://api.openai.com/v1",
+      reasoning: true,
+      input: ["text", "image"],
+      cost: { input: 1.1, output: 4.4, cacheRead: 0.275, cacheWrite: 0 },
+      contextWindow: 2e5,
+      maxTokens: 1e5
+    },
+    "gpt-4.1": {
+      id: "gpt-4.1",
+      name: "GPT-4.1",
+      api: "openai-completions",
+      provider: "openai",
+      baseUrl: "https://api.openai.com/v1",
+      reasoning: false,
+      input: ["text", "image"],
+      cost: { input: 2, output: 8, cacheRead: 0.5, cacheWrite: 0 },
+      contextWindow: 1047576,
+      maxTokens: 32768
+    },
+    "gpt-4.1-mini": {
+      id: "gpt-4.1-mini",
+      name: "GPT-4.1 Mini",
+      api: "openai-completions",
+      provider: "openai",
+      baseUrl: "https://api.openai.com/v1",
+      reasoning: false,
+      input: ["text", "image"],
+      cost: { input: 0.4, output: 1.6, cacheRead: 0.1, cacheWrite: 0 },
+      contextWindow: 1047576,
+      maxTokens: 32768
+    }
+  },
+  deepseek: {
+    "deepseek-chat": {
+      id: "deepseek-chat",
+      name: "DeepSeek V3",
+      api: "openai-completions",
+      provider: "deepseek",
+      baseUrl: "https://api.deepseek.com/v1",
+      reasoning: false,
+      input: ["text"],
+      cost: { input: 0.27, output: 1.1, cacheRead: 0.07, cacheWrite: 0 },
+      contextWindow: 64e3,
+      maxTokens: 8192
+    },
+    "deepseek-reasoner": {
+      id: "deepseek-reasoner",
+      name: "DeepSeek R1",
+      api: "openai-completions",
+      provider: "deepseek",
+      baseUrl: "https://api.deepseek.com/v1",
+      reasoning: true,
+      input: ["text"],
+      cost: { input: 0.55, output: 2.19, cacheRead: 0.14, cacheWrite: 0 },
+      contextWindow: 64e3,
+      maxTokens: 8192
+    }
+  },
+  openrouter: {
+    "anthropic/claude-sonnet-4": {
+      id: "anthropic/claude-sonnet-4",
+      name: "Claude Sonnet 4 (OpenRouter)",
+      api: "openai-completions",
+      provider: "openrouter",
+      baseUrl: "https://openrouter.ai/api/v1",
+      reasoning: true,
+      input: ["text", "image"],
+      cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 0 },
+      contextWindow: 2e5,
+      maxTokens: 16e3
+    }
+  }
+};
+
+// src/registry.ts
+var apiProviderRegistry = /* @__PURE__ */ new Map();
+function registerApiProvider(provider) {
+  apiProviderRegistry.set(provider.api, provider);
+}
+function getApiProvider(api) {
+  return apiProviderRegistry.get(api);
+}
+function listApiProviders() {
+  return [...apiProviderRegistry.keys()];
+}
+function clearApiProviders() {
+  apiProviderRegistry.clear();
+}
+function unregisterApiProvider(api) {
+  return apiProviderRegistry.delete(api);
+}
+function registerBuiltInApiProviders() {
+  registerApiProvider({ api: "openai-completions", stream: streamOpenAICompletions });
+  registerApiProvider({ api: "openai-responses", stream: streamOpenAIResponses });
+  registerApiProvider({ api: "anthropic-messages", stream: streamAnthropic });
+}
+function stream(model, request, options) {
+  const provider = apiProviderRegistry.get(model.api);
+  if (!provider) {
+    throw new Error(
+      `No API provider registered for api "${model.api}". Registered: ${[...apiProviderRegistry.keys()].join(", ") || "(none)"}. Call registerBuiltInApiProviders() or registerApiProvider() first.`
+    );
+  }
+  return provider.stream(model, request, options);
+}
+function streamByRef(ref, request, options = {}) {
+  const model = typeof ref === "string" ? resolveModel(ref) : getModel(ref.provider, ref.name);
+  if (!model) {
+    const key = typeof ref === "string" ? ref : `${ref.provider}/${ref.name}`;
+    throw new Error(`Model not found: "${key}". Register it with registerModel() first.`);
+  }
+  return stream(model, { ...request, model: { provider: model.provider, name: model.id } }, options);
+}
+var legacyProviders = /* @__PURE__ */ new Map();
+function registerProvider(name, factory) {
+  legacyProviders.set(name, factory);
+}
+function createDispatchStream() {
+  if (apiProviderRegistry.size === 0) {
+    registerBuiltInApiProviders();
+  }
+  return async function* dispatchStream(request, options) {
+    const model = getModel(request.model.provider, request.model.name) ?? resolveModel(request.model.name);
+    if (model) {
+      yield* stream(model, request, options);
+      return;
+    }
+    const factory = legacyProviders.get(request.model.provider);
+    if (factory) {
+      const streamFn = factory(request.model);
+      yield* streamFn(request, options);
+      return;
+    }
+    throw new Error(
+      `No provider for "${request.model.provider}/${request.model.name}". Register a model with registerModel() or a provider with registerProvider().`
+    );
+  };
+}
+export {
+  MODELS,
+  ProviderError,
+  calculateCost,
+  callOpenAICompletions,
+  clearApiProviders,
+  clearModels,
+  createAnthropicStream,
+  createDispatchStream,
+  createOpenAICompletionsStream,
+  createOpenAIResponsesStream,
+  getAllModels,
+  getApiProvider,
+  getModel,
+  getModels,
+  getProviders,
+  iterateSseMessages,
+  listApiProviders,
+  registerApiProvider,
+  registerBuiltInApiProviders,
+  registerModel,
+  registerProvider,
+  resolveAnthropicConfig,
+  resolveModel,
+  resolveOpenAICompletionsConfig,
+  resolveOpenAIResponsesConfig,
+  stream,
+  streamAnthropic,
+  streamByRef,
+  streamOpenAICompletions,
+  streamOpenAIResponses,
+  textFromPartial,
+  toolCallsFromPartial,
+  unregisterApiProvider,
+  unregisterProviderModels
+};