@llmnative/react 1.15.5 → 1.17.0

package/dist/types/src/Config.d.ts

@@ -43,6 +43,14 @@ export type AIConfig = {
     anthropicApiKey?: string;
     mistralApiKey?: string;
     glmApiKey?: string;
+    /** Cloudflare Workers AI — both apiToken and accountId are required (the account id is part of every URL). */
+    cloudflare?: {
+        apiToken?: string;
+        accountId?: string;
+        defaultModel?: string;
+        /** Keep models that require the Workers Paid plan in model discovery. Default: false. */
+        includePaidModels?: boolean;
+    };
     openAICompatible?: {
         apiKey?: string;
         baseUrl?: string;

package/dist/types/src/I18n.d.ts

@@ -145,6 +145,8 @@ export interface I18nDict {
         editSettings: string;
         attachFiles: string;
         dropFilesHere: string;
+        modelPricing: string;
+        modelPriceNotFound: string;
         attachmentsNotSupported: string;
         run: string;
         runFailed: string;

package/dist/types/src/components/widgets/Chatbot.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import type { AIModelPricing } from '../../providers/ai/AIProvider';
 import { type EditorCommand } from '../ui/fields/ContextMenu';
 /**
  * Chatbot — l'input/composer AI condiviso, estratto da `Prompt` (CR-071): textarea,
@@ -32,7 +33,12 @@ export interface ChatbotSubmitPayload {
 export interface ChatbotModelOption {
     label: string;
     value: string;
+    /** Input/output price per 1M tokens, shown next to the label; a free model (both 0) gets
+     * a highlighted row. `null` = price looked up but not found (flagged in the row);
+     * omitted = the consumer has no pricing at all, nothing is shown. */
+    pricing?: AIModelPricing | null;
 }
+export declare const isFreeModelOption: (option: ChatbotModelOption) => boolean;
 export interface ChatbotProps {
     /** Attributo `name` nativo sulla textarea sottostante — puro attributo DOM, MAI un
      * binding a Form (Chatbot non lo legge/scrive): serve solo a chi ha bisogno di un

package/dist/types/src/index.d.ts

@@ -78,8 +78,8 @@ export { loadGoogleMaps } from './providers/googleMaps/loadGoogleMaps';
 export type { GoogleMapsConfig } from './providers/googleMaps/loadGoogleMaps';
 export { useEmailProvider, EmailProvider } from './providers/email/EmailProviderContext';
 export { GmailEmailProvider } from './providers/email/google/GmailEmailProvider';
-export type { AIRequestOptions, AIAttachment, AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIProviderCapabilities, AIModelCatalog, AIProviderDefinition, AICompleteRequest, AICompleteResult, AIConversationTurn, AIToolDefinition, AIToolCall, AIToolResult, } from './providers/ai';
-export { createAIProviderRegistry, getAIModelCatalog, formatAIModelRef, parseAIModelRef, AI_PROVIDER_DEFINITIONS, AI_PROVIDER_DESCRIPTORS, OPENAI_COMPATIBLE_PROVIDER_DESCRIPTOR, toProviderDescriptor } from './providers/ai';
+export type { AIRequestOptions, AIAttachment, AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIModelPricing, DiscoveredAIModel, AIProviderCapabilities, AIModelCatalog, AIProviderDefinition, AICompleteRequest, AICompleteResult, AIConversationTurn, AIToolDefinition, AIToolCall, AIToolResult, CloudflareProviderOptions, } from './providers/ai';
+export { createAIProviderRegistry, getAIModelCatalog, formatAIModelRef, parseAIModelRef, isFreeAIModel, AI_PROVIDER_DEFINITIONS, AI_PROVIDER_DESCRIPTORS, OPENAI_COMPATIBLE_PROVIDER_DESCRIPTOR, CLOUDFLARE_PROVIDER_DESCRIPTOR, createCloudflareProviderDefinition, toProviderDescriptor } from './providers/ai';
 export type { ProviderDescriptor, ProviderCredentialField } from './providers/ProviderDescriptor';
 export { useAIProvider, useAIProviderRegistry, AIProvider } from './providers/ai/AIProviderContext';
 export { proxyFetch, useProxy, configureProxy, isProxyEnabled } from './providers/proxy';

package/dist/types/src/providers/ai/AIProvider.d.ts

@@ -1,12 +1,24 @@
 import type { PromptVariables } from '../../conf/Prompt';
 import type { ProviderConfigurable } from '../ProviderConfiguration';
+/** Token prices of a model, in `currency` per 1M tokens. `input === 0 && output === 0` means
+ * the model is free. */
+export interface AIModelPricing {
+    input: number;
+    output: number;
+    currency: 'USD';
+    /** Where the price comes from: the provider's own model listing, or the models.dev catalog. */
+    source: 'provider' | 'models.dev';
+}
 export interface AIModelDescriptor {
     id: string;
     provider: string;
     model: string;
     label: string;
     deprecated?: boolean;
+    /** Absent = price not found (neither in the provider listing nor on models.dev). */
+    pricing?: AIModelPricing;
 }
+export declare const isFreeAIModel: (model: Pick<AIModelDescriptor, "pricing">) => boolean;
 export interface AIProviderCapabilities {
     models: AIModelDescriptor[];
     supportsTemperature?: boolean;

package/dist/types/src/providers/ai/cloudflare.d.ts

@@ -0,0 +1,27 @@
+import type { ProviderDescriptor } from '../ProviderDescriptor';
+import type { AIModelPricing } from './AIProvider';
+import { type AIProviderDefinition } from './shared';
+type CloudflareModelProperty = {
+    property_id?: string;
+    value?: unknown;
+};
+type CloudflareModel = {
+    name?: string;
+    properties?: CloudflareModelProperty[];
+};
+export type CloudflareProviderOptions = {
+    accountId: string;
+    defaultModel?: string;
+    /** Keep models flagged `require_workers_paid` in discovery (they fail with 403 on the Free plan). */
+    includePaidModels?: boolean;
+};
+/** The catalog's `price` property: `[{ unit: 'per M input tokens', price, currency }, { unit:
+ * 'per M output tokens', … }]`. Anything else resolves to undefined and models.dev fills in. */
+export declare const parseCloudflarePricing: (model: CloudflareModel) => AIModelPricing | undefined;
+/** Built per account: the account id is part of every Workers AI URL, while
+ * AIProviderDefinition.complete()/discoverModels() only ever receive the API token. */
+export declare const createCloudflareProviderDefinition: ({ accountId, defaultModel, includePaidModels, }: CloudflareProviderOptions) => AIProviderDefinition;
+/** "Connect this provider" metadata — the working definition needs an account id, so (like
+ * openai-compatible) it is built only once one is configured; see createAIProviderRegistry. */
+export declare const CLOUDFLARE_PROVIDER_DESCRIPTOR: ProviderDescriptor;
+export {};

package/dist/types/src/providers/ai/index.d.ts

@@ -2,15 +2,21 @@ import type { AIConfig } from '../../Config';
 import type { ProviderDescriptor } from '../ProviderDescriptor';
 import type { AIProviderAdapter } from './AIProvider';
 import { type AIProviderDefinition } from './shared';
-export type { AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIProviderCapabilities, AIRequestOptions, AIAttachment, AICompleteRequest, AICompleteResult, AIConversationTurn, AIToolDefinition, AIToolCall, AIToolResult, } from './AIProvider';
-export { formatAIModelRef, parseAIModelRef } from './AIProvider';
+export type { AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIModelPricing, AIProviderCapabilities, AIRequestOptions, AIAttachment, AICompleteRequest, AICompleteResult, AIConversationTurn, AIToolDefinition, AIToolCall, AIToolResult, } from './AIProvider';
+export { formatAIModelRef, parseAIModelRef, isFreeAIModel } from './AIProvider';
+export type { DiscoveredAIModel } from './shared';
 export type { AIModelCatalog, AIProviderDefinition } from './shared';
 export { getAIModelCatalog } from './shared';
+export { CLOUDFLARE_PROVIDER_DESCRIPTOR, createCloudflareProviderDefinition } from './cloudflare';
+export type { CloudflareProviderOptions } from './cloudflare';
 export declare const AI_PROVIDER_DEFINITIONS: AIProviderDefinition[];
 /** Generic "connect this provider" view of an AIProviderDefinition — the shape a CMS/admin
  * UI needs (label, description, credential fields, where to find them), independent of the
  * runtime completion contract (discoverModels/complete) it also carries. */
 export declare const toProviderDescriptor: (definition: AIProviderDefinition) => ProviderDescriptor;
+/** Includes Cloudflare: like openai-compatible its working definition needs a second credential
+ * (the account id) before it can be built, but unlike openai-compatible it is a fixed, named
+ * vendor — a "connect" UI should list it alongside the others. */
 export declare const AI_PROVIDER_DESCRIPTORS: ProviderDescriptor[];
 /** The user-configurable "bring your own endpoint" slot — metadata-only counterpart of the
  * dynamic definition getDynamicAIProviderDefinitions() builds once a baseUrl is actually

package/dist/types/src/providers/ai/modelsDevPricing.d.ts

@@ -0,0 +1,23 @@
+import type { AIModelDescriptor, AIModelPricing } from './AIProvider';
+/** Public, CORS-open catalog (`access-control-allow-origin: *`) of models with their token
+ * prices, in USD per 1M tokens — the same unit AIModelPricing uses. */
+export declare const MODELS_DEV_URL = "https://models.dev/api.json";
+/** Compact cache shape: providerKey → modelId → [input, output]. The raw catalog is ~5 MB,
+ * this keeps only the providers above (~700 entries). */
+type PricingIndex = Record<string, Record<string, [number, number]>>;
+type ModelsDevCatalog = Record<string, {
+    models?: Record<string, {
+        cost?: {
+            input?: unknown;
+            output?: unknown;
+        };
+    }>;
+}>;
+export declare const buildPricingIndex: (catalog: ModelsDevCatalog) => PricingIndex;
+export declare const lookupModelsDevPricing: (index: PricingIndex, providerId: string, model: string) => AIModelPricing | undefined;
+/** Fills `pricing` from models.dev on the models the provider listing left without one.
+ * Models are never dropped: a model with no match simply keeps `pricing` undefined. */
+export declare const withModelsDevPricing: (providerId: string, models: AIModelDescriptor[]) => Promise<AIModelDescriptor[]>;
+/** Test-only: drops the in-flight promise between cases. */
+export declare const resetModelsDevPricingForTests: () => void;
+export {};

package/dist/types/src/providers/ai/openaiCompatible.d.ts

@@ -1,4 +1,4 @@
-import type { AIProviderDefinition, BuiltInAIProviderId } from './shared';
+import type { AIProviderDefinition, BuiltInAIProviderId, DiscoveredAIModel } from './shared';
 import type { AIConversationTurn, AICompleteResult, AIToolDefinition } from './AIProvider';
 type OpenAICompatibleDefinitionOptions = {
     id: BuiltInAIProviderId;
@@ -15,6 +15,8 @@ type OpenAICompatibleDefinitionOptions = {
     credentialsHint?: string;
     /** Override the default validateApiKey when the models endpoint is public or uses a non-standard error format. */
     validateApiKey?: AIProviderDefinition['validateApiKey'];
+    /** Maps one `/models` entry — for providers whose listing also reports prices (OpenRouter). */
+    mapModelEntry?: (entry: Record<string, unknown>) => string | DiscoveredAIModel | undefined;
 };
 /** Esportate per riuso da provider "chat completions"-simili ma non costruiti tramite
  * createOpenAICompatibleProviderDefinition (vedi opencode.ts) — stesso wire format OpenAI,
@@ -37,5 +39,5 @@ export declare function parseOpenAIResponse(response: {
         message?: Record<string, unknown>;
     }>;
 } | null): AICompleteResult | null;
-export declare const createOpenAICompatibleProviderDefinition: ({ id, label, description, configKey, requiredConfigKeys, defaultModel, fallbackModels, baseUrl, modelsUrl, chatCompletionsUrl, dashboardUrl, credentialsHint, validateApiKey: validateApiKeyOverride, }: OpenAICompatibleDefinitionOptions) => AIProviderDefinition;
+export declare const createOpenAICompatibleProviderDefinition: ({ id, label, description, configKey, requiredConfigKeys, defaultModel, fallbackModels, baseUrl, modelsUrl, chatCompletionsUrl, dashboardUrl, credentialsHint, validateApiKey: validateApiKeyOverride, mapModelEntry, }: OpenAICompatibleDefinitionOptions) => AIProviderDefinition;
 export {};

package/dist/types/src/providers/ai/openrouter.d.ts

@@ -1 +1,5 @@
+import type { AIModelPricing } from './AIProvider';
+/** `/models` prices are USD per token as decimal strings; `-1` marks routers with a variable
+ * price (openrouter/auto…), which count as "price not found". */
+export declare const parseOpenRouterPricing: (pricing: unknown) => AIModelPricing | undefined;
 export declare const OPENROUTER_PROVIDER_DEFINITION: import("./shared").AIProviderDefinition;

package/dist/types/src/providers/ai/shared.d.ts

@@ -1,7 +1,13 @@
 import { type ProviderConfigurationState } from '../ProviderConfiguration';
 import type { ProviderCredentialField } from '../ProviderDescriptor';
-import type { AICompleteRequest, AICompleteResult, AIKeyValidationResult, AIModelDescriptor, AIProviderAdapter, AIProviderCapabilities, AIRequestOptions } from './AIProvider';
-export type BuiltInAIProviderId = 'openai' | 'openrouter' | 'opencode' | 'openai-compatible' | 'deepseek' | 'gemini' | 'anthropic' | 'mistral' | 'glm';
+import type { AICompleteRequest, AICompleteResult, AIKeyValidationResult, AIModelDescriptor, AIModelPricing, AIProviderAdapter, AIProviderCapabilities, AIRequestOptions } from './AIProvider';
+export type BuiltInAIProviderId = 'openai' | 'openrouter' | 'opencode' | 'openai-compatible' | 'deepseek' | 'gemini' | 'anthropic' | 'mistral' | 'glm' | 'cloudflare';
+/** A discovered model carrying the price its provider listing already reports (OpenRouter,
+ * Cloudflare). Models discovered as a bare id get their price from models.dev instead. */
+export type DiscoveredAIModel = {
+    model: string;
+    pricing?: AIModelPricing;
+};
 export type AIProviderDefinition = {
     id: BuiltInAIProviderId;
     label: string;
@@ -20,7 +26,7 @@ export type AIProviderDefinition = {
     /** Short guidance on where in the dashboard to find the credential. */
     credentialsHint?: string;
     capabilities?: Omit<AIProviderCapabilities, 'models'>;
-    discoverModels: (apiKey: string) => Promise<string[]>;
+    discoverModels: (apiKey: string) => Promise<Array<string | DiscoveredAIModel>>;
     complete: (apiKey: string, request: Required<Pick<AICompleteRequest, 'prompt' | 'model'>> & AIRequestOptions & Pick<AICompleteRequest, 'history' | 'tools' | 'signal' | 'logId'>) => Promise<AICompleteResult | null>;
     /**
      * Per-provider auth check. When omitted, the default implementation in

package/dist/types/src/providers/manifest.d.ts

@@ -35,7 +35,7 @@ export type DataDriverName = 'dbRealtime' | 'firestoreDb' | 'supabaseDb' | 'mock
 export type StorageDriverName = 'firestorage' | 'supabaseStorage';
 export type AuthDriverName = 'googleAuth' | 'firebaseAuth' | 'dropboxAuth' | 'supabaseAuth';
 export type EmailDriverName = 'gmail';
-export type AIDriverName = 'openai' | 'openrouter' | 'opencode' | 'openai-compatible' | 'deepseek' | 'gemini' | 'anthropic' | 'mistral';
+export type AIDriverName = 'openai' | 'openrouter' | 'opencode' | 'openai-compatible' | 'deepseek' | 'gemini' | 'anthropic' | 'mistral' | 'cloudflare';
 export type CredentialsDriverName = 'googleServiceAccount';
 export type ServicesConfig = {
     data?: DataDriverName | string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnative/react",
-  "version": "1.15.5",
+  "version": "1.17.0",
   "description": "LLM-native React framework for deterministic UI generation. Data-driven by default, schema-driven optional. Ultra-low token consumption — built for AI agents, not just humans.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",