@omnicross/core 0.1.1 → 0.1.3

package/dist/index.d.cts

@@ -3,35 +3,48 @@ export { SSEEvent, SSEFormat, SSEParserCallbacks, createSSEParser, streamSSEResp
 export { A as AnthropicTool, B as BuiltinToolExecutor, G as GeminiTools, M as McpToolProvider, O as OpenAITool, g as getBuiltinSearchTools } from './BuiltinToolExecutor-CS2WpXhM.cjs';
 import { LLMProvider } from '@omnicross/contracts/llm-config';
 export { C as CorePaths, a as CoreUsageEvent, b as CoreUsageTokenCounts, U as UsageEventSink } from './usage-event-sink-BX7FE1NL.cjs';
-export { L as Logger } from './ApiKeyPoolService-BmMkau07.cjs';
+export { L as Logger } from './logger-4GvQNzhE.cjs';
+export { PricingStore } from './ports/pricing-store.cjs';
 export { ProviderConfigSource } from './ports/provider-config-source.cjs';
+export { UsageEventStore } from './ports/usage-event-store.cjs';
 export { WebSearchBackend } from './ports/web-search-backend.cjs';
 export { AnthropicIngressHandler, AnthropicIngressHandlerFactory, AnthropicRouteHandlerParams, AnthropicSdkHints, ExtendedContextHint, IngressFormat, ProviderProxyDeps, ProxyAttribution, RetryCallback, RouteAuthMode, RouteContext, StreamEventCallback, SubscriptionDispatchProfile, SubscriptionRequestSummary, TargetProviderFormat, UsageRecorderImport, UsageRecorderImport as UsageSink } from './provider-proxy/types.cjs';
-export { EndpointRoutingConfig, OutboundApiDeps, OutboundApiKeyCreated, OutboundApiKeyInfo, OutboundApiServerConfig, OutboundApiServerStatus, OutboundKeyDb as OutboundCredentialStore, OutboundEndpoint, OutboundFormatUrls, OutboundKeyDb, OutboundKeyDbRow, RequestRole } from './outbound-api/types.cjs';
+export { A as AccountProbeConfig, C as ChatDispatchMode, a as ConcurrencyQueueConfig, E as ENDPOINT_MODEL_KINDS, b as EndpointRoutingConfig, F as FingerprintConfig, K as KeyCostLimits, c as KeyExpiryInput, d as KeyExpiryResult, e as KeySpend, f as KeySpendReader, g as KeySpendSeeder, h as KeySpendTracker, i as KindMappedEndpoint, M as MessagesModelKind, j as ModelKind, k as ModelPrefixTargets, l as OutboundApiDeps, m as OutboundApiKeyCreated, n as OutboundApiKeyInfo, o as OutboundApiServerConfig, p as OutboundApiServerStatus, O as OutboundCredentialStore, q as OutboundEndpoint, r as OutboundFormatUrls, s as OutboundKeyActivationMode, O as OutboundKeyDb, t as OutboundKeyDbRow, u as OutboundKeyPolicy, v as OutboundProxyConfig, Q as QuotaDecision, R as RequestRole, w as ResponsesModelKind, U as UserMessageQueueConfig, V as VoucherCreateInput, x as VoucherDb, y as checkKeyQuota, z as computeKeyExpiry, B as computeVoucherGrant, D as generateVoucherCode, G as hashVoucherCode, H as newVoucherId, I as startOfLocalDay, J as startOfLocalWeek, L as toVoucherInfo, N as voucherCodePrefix } from './types-aBFFXoBz.cjs';
+export { CostCalculation, PricingEngine, PricingEngineOptions } from './usage/pricing-engine.cjs';
+export { UsageRecordInput, UsageRecorder, UsageRecorderOptions } from './usage/usage-recorder.cjs';
 export { A as ApiFormat, C as CompletionOptions, a as CompletionResult, N as NATIVE_SEARCH_TOOL_NAMES, b as NativeSearchAugmentation, c as NativeSearchDetectionResult, d as NativeSearchProvider, e as NativeSearchUserConfig, S as StreamCallbacks } from './types-BScIHmPr.cjs';
-export { C as CompletionService, V as VisionFallbackProvider } from './CompletionService-DtOF_War.cjs';
+export { C as CompletionService, V as VisionFallbackProvider } from './CompletionService-D3a47vdU.cjs';
 export { SimpleChatGeminiMessage, SimpleChatGeminiPart, StreamEvent, StreamEventType, StreamSender, addOpenRouterProviderToRequest, attachStreamEventBuffer, convertMessageToAnthropic, convertMessageToGemini, convertMessageToOpenAI, emitStreamEvent, getOpenRouterProviderConfig, getProviderHeaders, registerStreamEventBuffer, releaseStreamEventBuffer } from './completion.cjs';
 export { buildAnthropicApiUrl, buildAzureOpenAIApiUrl, buildGeminiApiUrl, buildOpenAIApiUrl, buildOpenAIResponseApiUrl, buildProviderApiUrl, normalizeAzureEndpoint, resolveApiFormat, resolveProviderEndpoint } from './completion/url-builder.cjs';
 export { applyAugmentation, buildNativeSearchAugmentation, detectNativeSearch } from './completion/NativeSearchInjector.cjs';
 export { __resetProviderProxyForTests, extractRouteToken, getProviderProxy } from './provider-proxy.cjs';
-export { ApiServerSettingsStore, ApplyConfigInput, DEFAULT_OUTBOUND_PORT, OUTBOUND_API_SERVER_CONFIG_KEY, OutboundApiServer, OutboundRateLimiter, __resetOutboundApiServerForTests, createNamedKey, defaultServerConfig, detectRequestRole, endpointToIngressFormat, formatUrls, getOutboundApiServer, hashKey, loadServerConfig, mergeServerConfig, normalizeServerConfig, saveServerConfig, verifyPresentedKey } from './outbound-api.cjs';
+export { AUDIT_REDACTED, ApiServerSettingsStore, ApplyConfigInput, AuditCaptureContext, BillingCaptureContext, ConcurrencyQueueFullError, ConcurrencyWaitCancelledError, ConcurrencyWaitTimeoutError, DEFAULT_ACCOUNT_PROBE, DEFAULT_CONCURRENCY_QUEUE, DEFAULT_FINGERPRINT, DEFAULT_OUTBOUND_PORT, DEFAULT_USER_MESSAGE_QUEUE, EndpointModelConfigError, GateAcquireOptions, GateAcquisition, GateSlot, GateStatusEntry, KeyVerification, KeyedMutex, ModelPrefixKind, OUTBOUND_API_SERVER_CONFIG_KEY, OutboundApiConfigError, OutboundApiServer, OutboundConcurrencyGate, OutboundRateLimiter, SerialAcquireOptions, SerialQueueStatusEntry, SerialQueueTimeoutError, SerialSlot, UserMessageSerialQueue, VerifiedKey, __resetOutboundApiServerForTests, beginAuditCapture, beginBillingCapture, classifyModelPrefix, createNamedKey, defaultServerConfig, detectModelKind, detectRequestRole, endpointToIngressFormat, formatUrls, getOutboundApiServer, handleVoucherRedeem, hashKey, isConcurrencyRejection, isKindMappedEndpoint, isRedeemRequest, isSerialQueueTimeout, isUserMessageRequest, loadServerConfig, mergeServerConfig, modelKindsForEndpoint, normalizeAccountProbe, normalizeAudit, normalizeBilling, normalizeFingerprint, normalizePrefixTargets, normalizeProxyConfig, normalizeProxySegment, normalizeQueueSegments, normalizeServerConfig, normalizeVoucher, normalizeWebhookDestination, normalizeWebhookSegment, randomBase62, redactAuditText, resolvePrefixTarget, saveServerConfig, validateEndpointModelConfig, validateServerModelConfig, verifyKey, verifyPresentedKey } from './outbound-api.cjs';
 export { convertAnthropicRequestToOpenAI, convertAnthropicStreamToOpenAI, convertAnthropicToOpenAI, convertAnthropicToOpenAIWithThinking, convertOpenAIResponseToAnthropic, convertOpenAIStreamToAnthropic, convertOpenAIToAnthropic, convertOpenAIToAnthropicWithThinking, hasImageContent, hasThinkingEnabled } from './ApiConverter.cjs';
 export { ChainExecutionOptions, TransformerChainExecutor } from './transformer/TransformerChainExecutor.cjs';
 export { TransformerService } from './transformer/TransformerService.cjs';
 export { registerBuiltinTransformers } from './transformer/transformers.cjs';
 export { Annotation, ImageContent, MessageContent, ModelRoute, ModelTransformerConfig, ReasoningConfig, RequestConfig, RequestRouteInfo, ResolvedTransformerChain, StreamChunk, TextContent, ThinkLevel, ThinkingContent, ToolCall, ToolChoice, ToolParameterSchema, TransformRequestResult, Transformer, TransformerChainConfig, TransformerConfigEntry, TransformerConstructor, TransformerContext, TransformerLogger, TransformerOptions, TransformerReference, TransformerServiceConfig, UnifiedChatRequest, UnifiedChatResponse, UnifiedMessage, UnifiedTool, UrlCitation } from './transformer/types.cjs';
 export { D as DEFAULT_ROUTE_IDLE_MS, P as ProviderProxy, a as ProviderProxyRouteMap } from './ProviderProxy-CnMQYN59.cjs';
-export { S as SUBSCRIPTION_PROVIDER_IDS, e as endpointSupportsSubscription, i as isSubscriptionProviderId, r as resolveRoute } from './routeResolver-BrbK6ja9.cjs';
+export { S as SUBSCRIPTION_PROVIDER_IDS, e as endpointSupportsSubscription, i as isSubscriptionProviderId, p as parseModelRef, a as pickModelRefFromList, r as resolveRoute } from './routeResolver-CbG5uBgm.cjs';
 import '@omnicross/contracts/message-blocks';
 import '@omnicross/contracts/completion-types';
 import '@omnicross/contracts/mcp-types';
+import '@omnicross/contracts/pricing-types';
+import '@omnicross/contracts/usage-stats-types';
 import '@omnicross/contracts/websearch-types';
 import 'node:http';
 import '@omnicross/contracts/subscription-types';
 import '@omnicross/contracts/usage-types';
+import './completion/ApiKeyPoolService.cjs';
 import './pipeline/AuthSource.cjs';
 import './pipeline/SubscriptionAuthSource.cjs';
 import './pipeline/SubscriptionAuthStrategy.cjs';
+import '@omnicross/contracts/account-tokens-types';
+import '@omnicross/contracts/audit-types';
+import '@omnicross/contracts/billing-types';
+import '@omnicross/contracts/health-logging-types';
+import '@omnicross/contracts/voucher-types';
+import '@omnicross/contracts/webhook-types';
 import '@omnicross/contracts/endpoint-resolver';
 import './transformer/transformers/AnthropicTransformer.cjs';
 import './transformer/transformers/GeminiCodeAssistTransformer.cjs';
@@ -54,12 +67,36 @@ import './transformer/transformers/ReasoningTransformer.cjs';
  */
 declare function isOpenRouterProvider(provider: LLMProvider): boolean;
 /**
- * OpenRouter app attribution headers
- * See: https://openrouter.ai/docs/app-attribution
+ * OpenRouter "app attribution" identity — the `HTTP-Referer` (the app's URL,
+ * the primary attribution key) and `X-Title` (the app's display name) that
+ * OpenRouter uses to attribute usage to an app on its public daily/weekly/
+ * monthly rankings. See https://openrouter.ai/docs/app-attribution
  */
-declare const OPENROUTER_APP_HEADERS: {
-    'HTTP-Referer': string;
-    'X-Title': string;
-};
+interface OpenRouterAppIdentity {
+    /** `HTTP-Referer` header — the app's URL. */
+    referer: string;
+    /** `X-Title` header — the app's display name on OpenRouter rankings. */
+    title: string;
+}
+/**
+ * The live OpenRouter app-attribution header set — the SINGLE source of truth
+ * for every OpenRouter request the serving core makes. Both the LLM path
+ * (`header-builder` / `TransformerHandler`) and the media path
+ * (`completion/openrouter-headers.ts` → `buildOpenRouterHeaders`) read this
+ * object. `setOpenRouterAppIdentity` mutates it in place; consumers spread it
+ * at request time, so a boot-time host override is reflected everywhere without
+ * re-importing.
+ */
+declare const OPENROUTER_APP_HEADERS: Record<string, string>;
+/**
+ * Override the OpenRouter app-attribution identity. Call once at host boot,
+ * before any OpenRouter request. Blank/whitespace-only fields are ignored (the
+ * existing value is kept), so a partial override is safe.
+ */
+declare function setOpenRouterAppIdentity(identity: Partial<OpenRouterAppIdentity>): void;
+/**
+ * Read the current OpenRouter app-attribution identity.
+ */
+declare function getOpenRouterAppIdentity(): OpenRouterAppIdentity;
 
-export { OPENROUTER_APP_HEADERS, isOpenRouterProvider };
+export { OPENROUTER_APP_HEADERS, type OpenRouterAppIdentity, getOpenRouterAppIdentity, isOpenRouterProvider, setOpenRouterAppIdentity };

package/dist/index.d.ts

@@ -3,35 +3,48 @@ export { SSEEvent, SSEFormat, SSEParserCallbacks, createSSEParser, streamSSEResp
 export { A as AnthropicTool, B as BuiltinToolExecutor, G as GeminiTools, M as McpToolProvider, O as OpenAITool, g as getBuiltinSearchTools } from './BuiltinToolExecutor-BluWyeob.js';
 import { LLMProvider } from '@omnicross/contracts/llm-config';
 export { C as CorePaths, a as CoreUsageEvent, b as CoreUsageTokenCounts, U as UsageEventSink } from './usage-event-sink-BX7FE1NL.js';
-export { L as Logger } from './ApiKeyPoolService-BmMkau07.js';
+export { L as Logger } from './logger-4GvQNzhE.js';
+export { PricingStore } from './ports/pricing-store.js';
 export { ProviderConfigSource } from './ports/provider-config-source.js';
+export { UsageEventStore } from './ports/usage-event-store.js';
 export { WebSearchBackend } from './ports/web-search-backend.js';
 export { AnthropicIngressHandler, AnthropicIngressHandlerFactory, AnthropicRouteHandlerParams, AnthropicSdkHints, ExtendedContextHint, IngressFormat, ProviderProxyDeps, ProxyAttribution, RetryCallback, RouteAuthMode, RouteContext, StreamEventCallback, SubscriptionDispatchProfile, SubscriptionRequestSummary, TargetProviderFormat, UsageRecorderImport, UsageRecorderImport as UsageSink } from './provider-proxy/types.js';
-export { EndpointRoutingConfig, OutboundApiDeps, OutboundApiKeyCreated, OutboundApiKeyInfo, OutboundApiServerConfig, OutboundApiServerStatus, OutboundKeyDb as OutboundCredentialStore, OutboundEndpoint, OutboundFormatUrls, OutboundKeyDb, OutboundKeyDbRow, RequestRole } from './outbound-api/types.js';
+export { A as AccountProbeConfig, C as ChatDispatchMode, a as ConcurrencyQueueConfig, E as ENDPOINT_MODEL_KINDS, b as EndpointRoutingConfig, F as FingerprintConfig, K as KeyCostLimits, c as KeyExpiryInput, d as KeyExpiryResult, e as KeySpend, f as KeySpendReader, g as KeySpendSeeder, h as KeySpendTracker, i as KindMappedEndpoint, M as MessagesModelKind, j as ModelKind, k as ModelPrefixTargets, l as OutboundApiDeps, m as OutboundApiKeyCreated, n as OutboundApiKeyInfo, o as OutboundApiServerConfig, p as OutboundApiServerStatus, O as OutboundCredentialStore, q as OutboundEndpoint, r as OutboundFormatUrls, s as OutboundKeyActivationMode, O as OutboundKeyDb, t as OutboundKeyDbRow, u as OutboundKeyPolicy, v as OutboundProxyConfig, Q as QuotaDecision, R as RequestRole, w as ResponsesModelKind, U as UserMessageQueueConfig, V as VoucherCreateInput, x as VoucherDb, y as checkKeyQuota, z as computeKeyExpiry, B as computeVoucherGrant, D as generateVoucherCode, G as hashVoucherCode, H as newVoucherId, I as startOfLocalDay, J as startOfLocalWeek, L as toVoucherInfo, N as voucherCodePrefix } from './types-6OUY_xfA.js';
+export { CostCalculation, PricingEngine, PricingEngineOptions } from './usage/pricing-engine.js';
+export { UsageRecordInput, UsageRecorder, UsageRecorderOptions } from './usage/usage-recorder.js';
 export { A as ApiFormat, C as CompletionOptions, a as CompletionResult, N as NATIVE_SEARCH_TOOL_NAMES, b as NativeSearchAugmentation, c as NativeSearchDetectionResult, d as NativeSearchProvider, e as NativeSearchUserConfig, S as StreamCallbacks } from './types-BScIHmPr.js';
-export { C as CompletionService, V as VisionFallbackProvider } from './CompletionService-7fCmKAP3.js';
+export { C as CompletionService, V as VisionFallbackProvider } from './CompletionService-DdWaAxq0.js';
 export { SimpleChatGeminiMessage, SimpleChatGeminiPart, StreamEvent, StreamEventType, StreamSender, addOpenRouterProviderToRequest, attachStreamEventBuffer, convertMessageToAnthropic, convertMessageToGemini, convertMessageToOpenAI, emitStreamEvent, getOpenRouterProviderConfig, getProviderHeaders, registerStreamEventBuffer, releaseStreamEventBuffer } from './completion.js';
 export { buildAnthropicApiUrl, buildAzureOpenAIApiUrl, buildGeminiApiUrl, buildOpenAIApiUrl, buildOpenAIResponseApiUrl, buildProviderApiUrl, normalizeAzureEndpoint, resolveApiFormat, resolveProviderEndpoint } from './completion/url-builder.js';
 export { applyAugmentation, buildNativeSearchAugmentation, detectNativeSearch } from './completion/NativeSearchInjector.js';
 export { __resetProviderProxyForTests, extractRouteToken, getProviderProxy } from './provider-proxy.js';
-export { ApiServerSettingsStore, ApplyConfigInput, DEFAULT_OUTBOUND_PORT, OUTBOUND_API_SERVER_CONFIG_KEY, OutboundApiServer, OutboundRateLimiter, __resetOutboundApiServerForTests, createNamedKey, defaultServerConfig, detectRequestRole, endpointToIngressFormat, formatUrls, getOutboundApiServer, hashKey, loadServerConfig, mergeServerConfig, normalizeServerConfig, saveServerConfig, verifyPresentedKey } from './outbound-api.js';
+export { AUDIT_REDACTED, ApiServerSettingsStore, ApplyConfigInput, AuditCaptureContext, BillingCaptureContext, ConcurrencyQueueFullError, ConcurrencyWaitCancelledError, ConcurrencyWaitTimeoutError, DEFAULT_ACCOUNT_PROBE, DEFAULT_CONCURRENCY_QUEUE, DEFAULT_FINGERPRINT, DEFAULT_OUTBOUND_PORT, DEFAULT_USER_MESSAGE_QUEUE, EndpointModelConfigError, GateAcquireOptions, GateAcquisition, GateSlot, GateStatusEntry, KeyVerification, KeyedMutex, ModelPrefixKind, OUTBOUND_API_SERVER_CONFIG_KEY, OutboundApiConfigError, OutboundApiServer, OutboundConcurrencyGate, OutboundRateLimiter, SerialAcquireOptions, SerialQueueStatusEntry, SerialQueueTimeoutError, SerialSlot, UserMessageSerialQueue, VerifiedKey, __resetOutboundApiServerForTests, beginAuditCapture, beginBillingCapture, classifyModelPrefix, createNamedKey, defaultServerConfig, detectModelKind, detectRequestRole, endpointToIngressFormat, formatUrls, getOutboundApiServer, handleVoucherRedeem, hashKey, isConcurrencyRejection, isKindMappedEndpoint, isRedeemRequest, isSerialQueueTimeout, isUserMessageRequest, loadServerConfig, mergeServerConfig, modelKindsForEndpoint, normalizeAccountProbe, normalizeAudit, normalizeBilling, normalizeFingerprint, normalizePrefixTargets, normalizeProxyConfig, normalizeProxySegment, normalizeQueueSegments, normalizeServerConfig, normalizeVoucher, normalizeWebhookDestination, normalizeWebhookSegment, randomBase62, redactAuditText, resolvePrefixTarget, saveServerConfig, validateEndpointModelConfig, validateServerModelConfig, verifyKey, verifyPresentedKey } from './outbound-api.js';
 export { convertAnthropicRequestToOpenAI, convertAnthropicStreamToOpenAI, convertAnthropicToOpenAI, convertAnthropicToOpenAIWithThinking, convertOpenAIResponseToAnthropic, convertOpenAIStreamToAnthropic, convertOpenAIToAnthropic, convertOpenAIToAnthropicWithThinking, hasImageContent, hasThinkingEnabled } from './ApiConverter.js';
 export { ChainExecutionOptions, TransformerChainExecutor } from './transformer/TransformerChainExecutor.js';
 export { TransformerService } from './transformer/TransformerService.js';
 export { registerBuiltinTransformers } from './transformer/transformers.js';
 export { Annotation, ImageContent, MessageContent, ModelRoute, ModelTransformerConfig, ReasoningConfig, RequestConfig, RequestRouteInfo, ResolvedTransformerChain, StreamChunk, TextContent, ThinkLevel, ThinkingContent, ToolCall, ToolChoice, ToolParameterSchema, TransformRequestResult, Transformer, TransformerChainConfig, TransformerConfigEntry, TransformerConstructor, TransformerContext, TransformerLogger, TransformerOptions, TransformerReference, TransformerServiceConfig, UnifiedChatRequest, UnifiedChatResponse, UnifiedMessage, UnifiedTool, UrlCitation } from './transformer/types.js';
 export { D as DEFAULT_ROUTE_IDLE_MS, P as ProviderProxy, a as ProviderProxyRouteMap } from './ProviderProxy-C-xqrkKi.js';
-export { S as SUBSCRIPTION_PROVIDER_IDS, e as endpointSupportsSubscription, i as isSubscriptionProviderId, r as resolveRoute } from './routeResolver-HE-ZO0fO.js';
+export { S as SUBSCRIPTION_PROVIDER_IDS, e as endpointSupportsSubscription, i as isSubscriptionProviderId, p as parseModelRef, a as pickModelRefFromList, r as resolveRoute } from './routeResolver-B1NglTfe.js';
 import '@omnicross/contracts/message-blocks';
 import '@omnicross/contracts/completion-types';
 import '@omnicross/contracts/mcp-types';
+import '@omnicross/contracts/pricing-types';
+import '@omnicross/contracts/usage-stats-types';
 import '@omnicross/contracts/websearch-types';
 import 'node:http';
 import '@omnicross/contracts/subscription-types';
 import '@omnicross/contracts/usage-types';
+import './completion/ApiKeyPoolService.js';
 import './pipeline/AuthSource.js';
 import './pipeline/SubscriptionAuthSource.js';
 import './pipeline/SubscriptionAuthStrategy.js';
+import '@omnicross/contracts/account-tokens-types';
+import '@omnicross/contracts/audit-types';
+import '@omnicross/contracts/billing-types';
+import '@omnicross/contracts/health-logging-types';
+import '@omnicross/contracts/voucher-types';
+import '@omnicross/contracts/webhook-types';
 import '@omnicross/contracts/endpoint-resolver';
 import './transformer/transformers/AnthropicTransformer.js';
 import './transformer/transformers/GeminiCodeAssistTransformer.js';
@@ -54,12 +67,36 @@ import './transformer/transformers/ReasoningTransformer.js';
  */
 declare function isOpenRouterProvider(provider: LLMProvider): boolean;
 /**
- * OpenRouter app attribution headers
- * See: https://openrouter.ai/docs/app-attribution
+ * OpenRouter "app attribution" identity — the `HTTP-Referer` (the app's URL,
+ * the primary attribution key) and `X-Title` (the app's display name) that
+ * OpenRouter uses to attribute usage to an app on its public daily/weekly/
+ * monthly rankings. See https://openrouter.ai/docs/app-attribution
  */
-declare const OPENROUTER_APP_HEADERS: {
-    'HTTP-Referer': string;
-    'X-Title': string;
-};
+interface OpenRouterAppIdentity {
+    /** `HTTP-Referer` header — the app's URL. */
+    referer: string;
+    /** `X-Title` header — the app's display name on OpenRouter rankings. */
+    title: string;
+}
+/**
+ * The live OpenRouter app-attribution header set — the SINGLE source of truth
+ * for every OpenRouter request the serving core makes. Both the LLM path
+ * (`header-builder` / `TransformerHandler`) and the media path
+ * (`completion/openrouter-headers.ts` → `buildOpenRouterHeaders`) read this
+ * object. `setOpenRouterAppIdentity` mutates it in place; consumers spread it
+ * at request time, so a boot-time host override is reflected everywhere without
+ * re-importing.
+ */
+declare const OPENROUTER_APP_HEADERS: Record<string, string>;
+/**
+ * Override the OpenRouter app-attribution identity. Call once at host boot,
+ * before any OpenRouter request. Blank/whitespace-only fields are ignored (the
+ * existing value is kept), so a partial override is safe.
+ */
+declare function setOpenRouterAppIdentity(identity: Partial<OpenRouterAppIdentity>): void;
+/**
+ * Read the current OpenRouter app-attribution identity.
+ */
+declare function getOpenRouterAppIdentity(): OpenRouterAppIdentity;
 
-export { OPENROUTER_APP_HEADERS, isOpenRouterProvider };
+export { OPENROUTER_APP_HEADERS, type OpenRouterAppIdentity, getOpenRouterAppIdentity, isOpenRouterProvider, setOpenRouterAppIdentity };