@standardagents/novita 0.0.0-dev.fffff

package/README.md

@@ -0,0 +1,65 @@
+# @standardagents/novita
+
+Novita AI provider for Standard Agents.
+
+This package wraps Novita's OpenAI-compatible Chat Completions API behind the
+Standard Agents provider interface. It supports:
+
+- streaming and non-streaming text generation
+- local function tool calling on supported models
+- JSON and structured output modes
+- live model discovery from Novita's `/openai/v1/models` endpoint
+- usage normalization and live provider pricing from Novita's model catalog,
+  including cache-read token prices when Novita reports them
+
+## Install
+
+```bash
+npm install @standardagents/novita @standardagents/spec
+```
+
+## Usage
+
+```ts
+import { novita } from '@standardagents/novita';
+
+const provider = novita({
+  apiKey: process.env.NOVITA_API_KEY!,
+});
+
+const result = await provider.generate({
+  model: 'deepseek/deepseek-v3.2',
+  messages: [{ role: 'user', content: 'Give me three concise launch names.' }],
+});
+
+console.log(result.content);
+console.log(result.usage?.cost);
+```
+
+## Factory
+
+The package exports:
+
+- `novita(config)` - provider factory
+- `NovitaProvider` - provider class
+- `novitaProviderOptions` - Zod schema for provider-specific options
+
+## Model Discovery And Pricing
+
+Novita model metadata is read from `https://api.novita.ai/openai/v1/models`.
+The response includes model IDs, context size, and token prices. Novita reports
+prices as scaled integers, so this provider converts values like `14000` to
+`$1.40` per million tokens before exposing `inputPrice`, `outputPrice`,
+`cachedPrice`, and `usage.pricing`.
+
+When Novita includes `pricing.input_cache_read.price_per_m`, the provider maps
+that value to `cachedInputPerMillion` and uses it for cached prompt tokens.
+Cache write tokens remain part of uncached prompt input usage and are priced at
+the normal input rate.
+
+When response usage includes token counts, generated and streamed responses also
+attach `usage.cost`. If the live catalog cannot be reached, the provider falls
+back to a small static set of currently recommended Novita models.
+
+For custom or private Novita models, set explicit model pricing in AgentBuilder
+if the model does not appear in Novita's catalog.

package/dist/index.d.ts

@@ -0,0 +1,85 @@
+import { LLMProviderInterface, ProviderFactoryConfig, ModelCapabilities, ProviderModelInfo, ProviderRequest, ProviderResponse, ProviderStreamChunk, InspectedRequest, ProviderUsagePricing, ProviderUsage, ProviderFactoryWithOptions } from '@standardagents/spec';
+import { z } from 'zod';
+
+/**
+ * Novita provider options schema.
+ *
+ * Novita exposes an OpenAI-compatible Chat Completions API. These options cover
+ * documented Novita-specific and OpenAI-compatible parameters, while
+ * passthrough keeps the provider forward-compatible with new API fields.
+ */
+declare const novitaProviderOptions: z.ZodObject<{
+    n: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    frequency_penalty: z.ZodOptional<z.ZodNumber>;
+    presence_penalty: z.ZodOptional<z.ZodNumber>;
+    repetition_penalty: z.ZodOptional<z.ZodNumber>;
+    top_k: z.ZodOptional<z.ZodNumber>;
+    min_p: z.ZodOptional<z.ZodNumber>;
+    logit_bias: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    logprobs: z.ZodOptional<z.ZodBoolean>;
+    top_logprobs: z.ZodOptional<z.ZodNumber>;
+    separate_reasoning: z.ZodOptional<z.ZodBoolean>;
+    enable_thinking: z.ZodOptional<z.ZodBoolean>;
+    modalities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+type NovitaProviderOptions = z.infer<typeof novitaProviderOptions>;
+
+interface NovitaModelInfo {
+    id: string;
+    object?: string;
+    created?: number;
+    title?: string;
+    description?: string;
+    context_size?: number;
+    input_token_price_per_m?: number;
+    output_token_price_per_m?: number;
+    pricing?: {
+        prompt?: NovitaPriceInfo;
+        completion?: NovitaPriceInfo;
+        input_cache_read?: NovitaPriceInfo;
+    };
+}
+interface NovitaPriceInfo {
+    origin_price_per_m?: number;
+    price_per_m?: number;
+}
+declare function normalizeNovitaPricePerMillion(value: unknown): number | undefined;
+declare function novitaUsagePricingFromModel(model: NovitaModelInfo | undefined): ProviderUsagePricing | undefined;
+declare function calculateNovitaUsageCost(usage: ProviderUsage, pricing?: ProviderUsagePricing): number | undefined;
+declare class NovitaProvider implements LLMProviderInterface {
+    readonly name = "novita";
+    readonly specificationVersion: "1";
+    private config;
+    private static modelsCache;
+    private static modelsCacheTime;
+    private static readonly CACHE_TTL;
+    private static readonly USAGE_PRICING_FINISH_WAIT_MS;
+    constructor(config: ProviderFactoryConfig);
+    supportsModel(_modelId: string): boolean;
+    getIcon(modelId?: string): string;
+    private baseUrl;
+    private headers;
+    private fetchModelsWithCache;
+    private mapModelCapabilities;
+    getModelCapabilities(modelId: string): Promise<ModelCapabilities | null>;
+    private mapToProviderModelInfo;
+    getModels(filter?: string): Promise<ProviderModelInfo[]>;
+    private static settleUsagePricing;
+    private getUsagePricing;
+    generate(request: ProviderRequest): Promise<ProviderResponse>;
+    stream(request: ProviderRequest): Promise<AsyncIterable<ProviderStreamChunk>>;
+    private toHttpProviderErrorFromResponse;
+    private toProviderError;
+    private toHttpProviderError;
+    inspectRequest(request: ProviderRequest): Promise<InspectedRequest>;
+}
+
+/**
+ * Novita AI provider factory for Standard Agents.
+ *
+ * Uses Novita's OpenAI-compatible Chat Completions API and live model catalog.
+ */
+declare const novita: ProviderFactoryWithOptions<typeof novitaProviderOptions>;
+
+export { type NovitaModelInfo, NovitaProvider, type NovitaProviderOptions, calculateNovitaUsageCost, normalizeNovitaPricePerMillion, novita, novitaProviderOptions, novitaUsagePricingFromModel };