@truefoundry/ai-gateway-sdk 0.0.0-stage → 0.0.2

package/dist/globals.d.ts

@@ -0,0 +1,452 @@
+/**
+ * ================================
+ * Inherited upstream file
+ * But need few custom changes for TFY
+ * 1. Chaning name of providers
+ * 2. Add response format tool name
+ * 3. Add gateway cached credentials prefix
+ * 4. Add model unsupported params
+ * ================================
+ */
+import { Endpoint } from './providers/types.js';
+/**
+ * ================================
+ * NOTE: Keep this aligned with the tfy header prefix
+ * ================================
+ */
+export declare const POWERED_BY: string;
+export declare const API_TFY_AI = "api.tfy.ai";
+export declare const MAX_RETRY_LIMIT_MS: number;
+export declare const POSSIBLE_RETRY_STATUS_HEADERS: string[];
+export declare const POD_STARTUP_JITTER_MS = 15000;
+/**
+ * ================================
+ * NOTE: Add response format tool name for anthropic and gateway cached credentials prefix
+ * ================================
+ */
+export declare const RESPONSE_FORMAT_TOOL_NAME = "json_extractor";
+export declare const GATEWAY_V2_CACHE_PREFIX = "v2-cache.";
+export declare const GATEWAY_V2_COMMON_PREFIX = "v2-common.";
+export declare const GATEWAY_V2_ENFORCEMENT_PREFIX = "v2-enforcement.";
+export declare const GATEWAY_V2_ENFORCEMENT_LIMITS_PREFIX = "v2-enforcement-with-limits.";
+export declare const GATEWAY_V2_METRICS_LOADBALANCER_PREFIX = "v2-metrics-loadbalancer.";
+export declare const GATEWAY_V2_STATISTICS_PREFIX = "v2-statistics.";
+export declare const PROMPTS_CACHE_NATS_KEY_PREFIX = "prompts-cache.";
+export declare const GIT_SKILL_CONTENT_CACHE_NATS_KEY_PREFIX = "git-skill-content-cache.";
+export declare const GATEWAY_SECRET_CACHE_NATS_KEY_PREFIX = "gateway-secret-cache.";
+export declare const GATEWAY_APPROVAL_CACHE_NATS_KEY_PREFIX = "gateway-approval-cache.";
+export declare const V2_CACHE_ENTITIES: {
+    readonly PROVIDER_CREDENTIALS: "providerCredentials";
+    readonly PROMPTS_MANIFESTS: "promptsManifests";
+    readonly STICKY_FALLBACK: "sticky_fallback";
+};
+export declare const V2_ENFORCEMENT_ENTITIES: {
+    readonly BUDGET: "BUDGET";
+    readonly BUDGET_V2: "BUDGET_V2";
+    readonly RATELIMIT: "RATELIMIT";
+};
+export declare const V2_COMMON_ENTITIES: {
+    readonly MODEL_CONFIG: "model-config";
+    readonly PROVIDER_CONFIG: "provider-config";
+};
+export declare const V2_STATISTICS_ENTITIES: {
+    readonly RATE_LIMIT_BUCKET: "gateway-rate-limit-bucket";
+    readonly BUDGET_BUCKET: "gateway-budget-bucket";
+    readonly LOADBALANCE_BUCKET: "gateway-loadbalance-bucket";
+};
+export declare const HEADER_KEYS: Record<string, string>;
+export declare const RESPONSE_HEADER_KEYS: Record<string, string>;
+export declare const RETRY_STATUS_CODES: number[];
+export declare const MAX_RETRIES = 5;
+export declare const REQUEST_TIMEOUT_STATUS_CODE = 408;
+export declare const PRECONDITION_CHECK_FAILED_STATUS_CODE = 412;
+export declare const PROVIDER_MALFORMED_RESPONSE_STATUS_CODE = 500;
+/**
+ * ================================
+ * NOTE: Change name of vertex-ai to vertex, bedrock to aws-bedrock, google to gcp, azure-ai to azure-foundry, and add google-vertex
+ * ================================
+ */
+export declare const DATABRICKS: string;
+export declare const OPEN_AI: string;
+export declare const COHERE: string;
+export declare const AZURE_OPEN_AI: string;
+export declare const AZURE_AI_INFERENCE: string;
+export declare const MICROSOFT_FOUNDRY: string;
+export declare const ANTHROPIC: string;
+/** Provider names whose deployments are priced by foundation_model / deployment_type-derived region, Azure-style. */
+export declare const AZURE_OPENAI_COMPATIBLE_COST_PROVIDERS: ReadonlySet<string>;
+/** Prefix used by Anthropic to identify server-side tool call IDs (web search, code execution, etc.). */
+export declare const ANTHROPIC_SERVER_TOOL_CALL_ID_PREFIX = "srvtoolu_";
+export declare function isClaudeOpus45(model: string): boolean;
+/**
+ * Returns true when the model is a Claude model that should use adaptive thinking
+ * ({type: 'adaptive'}, no budget_tokens).
+ *
+ * Versions >= 4.6 use adaptive thinking. Older versions use {type: 'enabled', budget_tokens}.
+ * If the version can't be parsed, defaults to legacy (enabled) as a safe fallback.
+ *
+ * Handles Bedrock-style model IDs (e.g. "global.anthropic-claude-sonnet-4-20250514-v1-0")
+ * and Vertex AI model IDs (e.g. "anthropic/claude-opus-4@20250514").
+ */
+export declare function isClaudeAdaptiveThinkingModel(model: string): boolean;
+/**
+ * Returns true when the Bedrock model natively supports eager_input_streaming on tools.
+ *
+ * Older models (< 4.6, e.g. claude-opus-4-5) reject eager_input_streaming with
+ * "Extra inputs are not permitted". Newer models (>= 4.6) accept it directly.
+ */
+export declare function isBedrockEagerInputStreamingSupported(model: string): boolean;
+export declare const ANYSCALE: string;
+export declare const PALM: string;
+export declare const TOGETHER_AI: string;
+export declare const GOOGLE: string;
+export declare const GOOGLE_VERTEX_AI: string;
+export declare const HUGGING_FACE: string;
+export declare const GOOGLE_VERTEX: string;
+export declare const GOOGLE_GEMINI: string;
+export declare const PERPLEXITY_AI: string;
+export declare const REKA_AI: string;
+export declare const MISTRAL_AI: string;
+export declare const DEEPINFRA: string;
+export declare const NCOMPASS: string;
+export declare const STABILITY_AI: string;
+export declare const NOMIC: string;
+export declare const OLLAMA: string;
+export declare const AI21: string;
+export declare const BEDROCK: string;
+export declare const AWS_BEDROCK_MANTLE: string;
+export declare const AWS_CLAUDE_PLATFORM: string;
+/**
+ * AWS Partner Network (APN) user-agent tag for TrueFoundry. AWS reads this from
+ * the User-Agent header to attribute API usage to our APN partner code. It must
+ * be appended to every outbound AWS API request (Bedrock model invocations,
+ * Bedrock guardrails, Bedrock Mantle, Claude on AWS, SageMaker, STS, ...).
+ * Ref: https://docs.aws.amazon.com/PRM/latest/aws-prm-onboarding-guide/user-agent-samples.html
+ */
+export declare const AWS_APN_USER_AGENT: string;
+/**
+ * Appends {@link AWS_APN_USER_AGENT} to a headers object, preserving any existing
+ * User-Agent value. `user-agent` is an unsignable SigV4 header, so this is safe
+ * to call before signing without invalidating the signature. Idempotent and
+ * case-insensitive on the existing header key.
+ */
+export declare const appendApnUserAgent: (headers: Record<string, string>) => Record<string, string>;
+export declare const GROQ: string;
+export declare const SEGMIND: string;
+export declare const JINA: string;
+export declare const FIREWORKS_AI: string;
+export declare const WORKERS_AI: string;
+export declare const MOONSHOT: string;
+export declare const OPENROUTER: string;
+export declare const LINGYI: string;
+export declare const ZHIPU: string;
+export declare const NOVITA_AI: string;
+export declare const MONSTERAPI: string;
+export declare const DEEPSEEK: string;
+export declare const PREDIBASE: string;
+export declare const TRITON: string;
+export declare const VOYAGE: string;
+export declare const GITHUB: string;
+export declare const DEEPBRICKS: string;
+export declare const SILICONFLOW: string;
+export declare const CEREBRAS: string;
+export declare const WAFER: string;
+export declare const TYPESAFE: string;
+export declare const INFERENCENET: string;
+export declare const SAMBANOVA: string;
+export declare const LEMONFOX_AI: string;
+export declare const UPSTAGE: string;
+export declare const LAMBDA: string;
+export declare const DASHSCOPE: string;
+export declare const X_AI: string;
+export declare const BASETEN: string;
+export declare const TRUEFOUNDRY_MODELS: string;
+export declare const CORTEX: string;
+export declare const SAGEMAKER: string;
+export declare const NEBIUS: string;
+export declare const RECRAFTAI: string;
+export declare const MILVUS: string;
+export declare const REPLICATE: string;
+export declare const LEPTON: string;
+export declare const KLUSTER_AI: string;
+export declare const NSCALE: string;
+export declare const HYPERBOLIC: string;
+export declare const BYTEZ: string;
+export declare const FEATHERLESS_AI: string;
+export declare const KRUTRIM: string;
+export declare const QDRANT: string;
+export declare const THREE_ZERO_TWO_AI: string;
+export declare const CLOUDERA: string;
+export declare const CARTESIA: string;
+export declare const DEEPGRAM: string;
+/**
+ * ================================
+ * NOTE: Add self-hosted provider
+ * ================================
+ */
+export declare const SELF_HOSTED: string;
+/**
+ * ================================
+ * OpenAI-Compatible Provider Base URLs
+ * Base URLs for OpenAI-compatible providers
+ * ================================
+ */
+export declare const OPENAI_COMPATIBLE_BASE_URLS: Record<string, string>;
+/**
+ * ================================
+ * Provider Name to Constant Mapping
+ * Maps provider names from providerOptions to constants from globals.ts
+ * ================================
+ */
+export declare const PROVIDER_CONSTANTS: Record<string, string>;
+export declare const VALID_PROVIDERS: string[];
+/**
+ * ================================
+ * Query parameter constants
+ * ================================
+ */
+export declare const QUERY_PARAMS: {
+    readonly REFRESH: "refresh";
+    readonly INCLUDE_ALL_TOOLS: "includeAllTools";
+    readonly BYPASS_METADATA_OVERRIDES: "bypassMetadataOverrides";
+};
+export declare const CONTENT_TYPES: {
+    APPLICATION_JSON: string;
+    MULTIPART_FORM_DATA: string;
+    EVENT_STREAM: string;
+    AUDIO_MPEG: string;
+    APPLICATION_OCTET_STREAM: string;
+    BINARY_OCTET_STREAM: string;
+    GENERIC_AUDIO_PATTERN: string;
+    PLAIN_TEXT: string;
+    HTML: string;
+    GENERIC_IMAGE_PATTERN: string;
+};
+export declare const MULTIPART_FORM_DATA_ENDPOINTS: Endpoint[];
+export declare const fileExtensionMimeTypeMap: {
+    mp4: string;
+    jpeg: string;
+    jpg: string;
+    png: string;
+    bmp: string;
+    tiff: string;
+    webp: string;
+    gif: string;
+    pdf: string;
+    csv: string;
+    doc: string;
+    docx: string;
+    xls: string;
+    xlsx: string;
+    html: string;
+    md: string;
+    mp3: string;
+    wav: string;
+    txt: string;
+    mov: string;
+    mpeg: string;
+    mpg: string;
+    avi: string;
+    wmv: string;
+    mpegps: string;
+    flv: string;
+    webm: string;
+    mkv: string;
+    threegpp: string;
+};
+/**
+ * Reverse mapping from MIME type to file extension.
+ * Example: "text/plain" → "txt", "application/pdf" → "pdf"
+ *
+ * When multiple extensions map to the same MIME type (e.g. both `jpeg` and `jpg`
+ * → `image/jpeg`), the FIRST extension declared in `fileExtensionMimeTypeMap`
+ * wins. This guarantees the canonical IANA-style extension is returned, which
+ * is what downstream providers (e.g. AWS Bedrock Converse, which only accepts
+ * `[gif, jpeg, png, webp]` as image formats) expect.
+ */
+export declare const mimeTypeToExtensionMap: Record<string, string>;
+export declare const imagesMimeTypes: string[];
+export declare const documentMimeTypes: string[];
+export declare const videoMimeTypes: string[];
+export declare enum BatchEndpoints {
+    CHAT_COMPLETIONS = "/v1/chat/completions",
+    COMPLETIONS = "/v1/completions",
+    EMBEDDINGS = "/v1/embeddings"
+}
+/**
+ * ================================
+ * Context Keys
+ * ================================
+ */
+export declare const CONTEXT_KEYS: {
+    readonly TRANSFORMED_BODY: "transformedBody";
+    readonly SKIP_GUARDRAIL_AUTHORIZATION: "skipGuardrailAuthorization";
+    readonly SKIP_MODEL_AUTHORIZATION: "skipModelAuthorization";
+    readonly SKIP_METADATA_LOGGING: "skipMetadataLogging";
+    readonly SKIP_GLOBAL_STREAM_CONVERSION: "skipGlobalStreamConversion";
+    readonly MONOTONIC_MODEL_LATENCY_IN_MS: "monotonicModelLatencyInMs";
+    readonly IS_STREAMING_REQUEST: "isStreamingRequest";
+    readonly MONOTONIC_MODEL_REQUEST_START_TIME: "monotonicModelRequestStartTime";
+    readonly MONOTONIC_REQUEST_START_TIME: "monotonicRequestStartTime";
+    readonly MONOTONIC_REQUEST_FIRST_TOKEN_TIME: "monotonicRequestFirstTokenTime";
+    /** TTFT timeout: AbortController set by routing layer to abort provider fetch when budget expires */
+    readonly TTFT_ABORT_CONTROLLER: "ttftAbortController";
+    /** TTFT timeout: timeout in ms, set when TTFT is enabled so span can build message */
+    readonly TTFT_TIMEOUT_MS: "ttftTimeoutMs";
+    /** TTFT timeout: timer set when TTFT is enabled so span can build message */
+    readonly TTFT_TIMER: "ttftTimer";
+    readonly TRACING_RESPONSE_ERROR_MESSAGE: "tracingResponseErrorMessage";
+    readonly TRACING_RESPONSE_STATUS_CODE: "tracingResponseStatusCode";
+    readonly TRACING_STREAMING_MODEL_PROVIDER_TERMINATED: "tracingStreamingModelProviderTerminated";
+    readonly TRACING_PROVIDER_STREAM_STATUS_CODE: "tracingProviderStreamStatusCode";
+    readonly TRACING_MODEL_PROVIDER_STATUS_CODE: "tracingModelProviderStatusCode";
+    readonly TRACING_MODEL_SPAN_EVER_CREATED: "tracingModelSpanEverCreated";
+    readonly TRACING_PROVIDER_REQUEST_FORMAT: "tracingProviderRequestFormat";
+    readonly TRACING_ANTHROPIC_BETAS_SENT: "tracingAnthropicBetasSent";
+    readonly TRACING_ANTHROPIC_BETAS_REQUESTED: "tracingAnthropicBetasRequested";
+    readonly TRACING_ROOT_SPAN_MODEL: "tracingRootSpanModel";
+    readonly TRACING_MODEL_REQUEST_URL: "tracingModelRequestUrl";
+    readonly DATA_ROUTING_DESTINATION: "dataRoutingDestination";
+    readonly TRACING_PROVIDER_INPUT: "tracingProviderInput";
+    readonly GUARDRAILS_INPUT_EXECUTED: "guardrailsInputExecuted";
+    readonly GUARDRAILS_RESOLVED_MODEL: "guardrailsResolvedModel";
+    readonly RESOLVED_GUARDRAIL_CHECKS: "guardrailsConfigCache";
+    readonly RESOLVED_GUARDRAIL_CUSTOM_ERROR_MESSAGE_MAP: "resolvedGuardrailCustomErrorMessageMap";
+    readonly INPUT_GUARDRAIL_PROMISE: "inputGuardrailPromise";
+    readonly HOOK_SPAN_ID: "hookSpanId";
+    readonly TFY_PROVIDER_NAME: "tfyProviderName";
+    readonly AUTH_TYPE: "authType";
+    readonly IS_GEMINI_ROUTER: "isGeminiRouter";
+    readonly IS_VERTEX_AI_ROUTER: "isVertexAIRouter";
+    readonly IS_BEDROCK_ROUTER: "isBedrockRouter";
+    readonly NEED_ORIGINAL_BINARY_CHUNKS: "needOriginalBinaryChunks";
+    /** TTS router: /tts/{providerName}/* - provider name from path, model from body */
+    readonly IS_TTS_ROUTER: "isTtsRouter";
+    /** STT router: /stt/{providerName}/* - provider name from path, model from body (multipart/form-data) */
+    readonly IS_STT_ROUTER: "isSttRouter";
+    /** Video blind-proxy router: /videos-proxy/{providerName}/* - provider name from path, model from native URL/header */
+    readonly IS_VIDEO_PROXY_ROUTER: "isVideoProxyRouter";
+    /** Custom proxy router: /proxy-api/{providerAccountName}/{endpointName}/* - transparent HTTP proxy */
+    readonly IS_CUSTOM_PROXY_ROUTER: "isCustomProxyRouter";
+    readonly IS_CURSOR_REQUEST: "isCursorRequest";
+    /** Model id extracted from Gemini/Vertex proxy path (e.g. /v1beta/models/{model}:action) for auth and cost */
+    readonly TFY_PROXY_PATH_MODEL_ID: "tfyProxyPathModelId";
+    /** When proxying via tryTargetsRecursively, the actual endpoint fn (tts-proxy | stt-proxy | proxy) for cost model type mapping */
+    readonly PROXY_ENDPOINT_FN: "proxyEndpointFn";
+    /** Parsed request body for proxy cost attribution (e.g. Vertex TTS JSON before streaming audio response) */
+    readonly PROXY_COST_REQUEST_BODY: "proxyCostRequestBody";
+    /** Unicode code-point count billed for Cloud TTS (Vertex tts-proxy), excluding SSML mark tags */
+    readonly AUDIO_BILLED_CHARS: "audioBilledChars";
+    /** Billable audio seconds from Cloud STT response (Vertex stt-proxy), after parsing totalBilledTime / totalBilledDuration */
+    readonly AUDIO_BILLED_SECONDS: "audioBilledSeconds";
+    /** Billable video seconds (durationSeconds * sampleCount), set at submit time since Veo's cost is fully known from the request. */
+    readonly VIDEO_BILLED_SECONDS: "videoBilledSeconds";
+    /** Resolved video resolution (e.g. "720p", "1080p", "4k") used for resolution-tiered video pricing. */
+    readonly VIDEO_BILLED_RESOLUTION: "videoBilledResolution";
+    /** Whether the requested video includes audio; selects the audio-on vs audio-off rate tier. */
+    readonly VIDEO_BILLED_AUDIO: "videoBilledAudio";
+    readonly TFY_INTEGRATION_TO_GUARDRAIL_MANIFEST_MAP: "tfyIntegrationToGuardrailManifestMap";
+    readonly PROMPT_LOGGING_ENABLED: "promptLoggingEnabled";
+    readonly LOGGING_REDACTION_PATTERNS: "loggingRedactionPatterns";
+    readonly PROMPT_SUBSTITUTED: "promptSubstituted";
+    readonly CROWDSTRIKE_FPE_CONTEXT_MAP: "crowdstrikeAidrFpeContextMap";
+    readonly CUSTOM_STREAM_WRAPPER: "customStreamWrapper";
+    readonly NOMINATED_RATE_LIMIT_RULES: "nominatedRateLimitRules";
+    readonly APPLIED_RATE_LIMIT_RULE_IDS: "appliedRateLimitRuleIds";
+    readonly AGGREGATED_APPLIED_RATE_LIMIT_RULE_IDS: "aggregatedAppliedRateLimitRuleIds";
+    readonly NOMINATED_BUDGET_RULES: "nominatedBudgetRules";
+    readonly APPLIED_BUDGET_RULE_IDS: "appliedBudgetRuleIds";
+    readonly AGGREGATED_APPLIED_BUDGET_RULE_IDS: "aggregatedAppliedBudgetRuleIds";
+    readonly BUDGET_AUDIT_MODE: "budgetAuditMode";
+    readonly APPLIED_BUDGET_SOURCE: "appliedBudgetSource";
+    readonly NOMINATED_BUDGETS_V2: "nominatedBudgetsV2";
+    readonly PREMATCHED_VM_BUDGETS: "prematchedVmBudgets";
+    readonly PREMATCHED_VIRTUAL_MODEL_ID: "prematchedVirtualModelId";
+    readonly REQUESTED_MODEL: "requestedModel";
+    readonly MODEL_COST_IN_USD: "modelCostInUsd";
+    readonly CACHE_CONFIG: "cacheConfig";
+    readonly CACHE_EMBEDDINGS: "cacheEmbeddings";
+    readonly CACHE_STATUS: "cacheStatus";
+    readonly OVERRIDE_PROVIDER_BEARER_TOKEN: "overrideProviderBearerToken";
+    readonly IS_VIRTUAL_MODEL: "isVirtualModel";
+    readonly VIRTUAL_MODEL_RESOLVED_FROM_SLUG: "virtualModelResolvedFromSlug";
+    readonly RESPONSES_STATEFUL: "responsesStateful";
+    readonly RESPONSES_PINNED_TARGET: "responsesPinnedTarget";
+    readonly RESPONSES_SERVED_TARGET: "responsesServedTarget";
+    readonly RESPONSES_PROVIDER_RESPONSE_ID: "responsesProviderResponseId";
+    readonly RESOLVED_METADATA: "resolvedMetadata";
+    readonly TRUNCATED_METADATA: "truncatedMetadata";
+    readonly REQUEST_SIGNAL: "requestSignal";
+    readonly STREAMING_COMPLETED: "streamingCompleted";
+    /** Resolved ClientCancelBilling policy for this request (see utils/clientCancelPolicy). */
+    readonly CLIENT_CANCEL_BILLING_TYPE: "clientCancelBillingType";
+    /** Case B: detach the client but keep draining upstream so the provider's own usage block is captured. */
+    readonly COMPLETE_REQUEST_ON_CLIENT_CANCEL: "completeRequestOnClientCancel";
+    /** Case C: the pump will estimate tokens from the partial stream, so spans must stay open for it. */
+    readonly KEEP_SPANS_OPEN_ON_CLIENT_CANCEL: "keepSpansOpenOnClientCancel";
+    readonly PARSED_REQUEST_BODY: "parsedRequestBody";
+    readonly ADAPTER: "adapter";
+    readonly ADAPTER_ORIGINAL_ENDPOINT: "adapterOriginalEndpoint";
+    readonly ADAPTER_ORIGINAL_REQUEST: "adapterOriginalRequest";
+    /** IMAGE-modality billable tokens from image gen/edit responses (set before model span cost) */
+    readonly IMAGE_BILLED_INPUT_TOKENS: "imageBilledInputTokens";
+    readonly IMAGE_BILLED_OUTPUT_TOKENS: "imageBilledOutputTokens";
+    /** Set to true by the response loggers when token counts are produced via the estimation fallback (provider returned no usage). */
+    readonly TOKENS_ESTIMATED: "tokensEstimated";
+};
+/**
+ * ================================
+ * OpenAI model patterns for native response_format support
+ * ================================
+ */
+export declare const OPENAI_MODELS_WITHOUT_NATIVE_RESPONSE_FORMAT: readonly ["gpt-5-chat", "gpt-4o-2024-05-13"];
+export declare const OPENAI_MODELS_WITH_NATIVE_RESPONSE_FORMAT: readonly ["gpt-4o", "gpt-5", "gpt-4.1", "o3", "o4"];
+/**
+ * Returns true when the Claude model natively supports structured output via
+ * output_config.format (e.g. claude-sonnet-4-5, claude-opus-4-6); others fall
+ * back to tool conversion.
+ *
+ * Versions >= 4.5 support native structured output. If the version can't be
+ * parsed, defaults to false (tool conversion) as a safe fallback.
+ */
+export declare function isClaudeNativeStructuredOutputModel(model: string): boolean;
+/**
+ * ================================
+ * Model-specific parameter exclusions
+ * ================================
+ *
+ *
+ * Sampling params the GPT-5 family rejects. Sending any of them to a model that does not
+ * accept them is a 400 from OpenAI, so they are dropped rather than forwarded.
+ */
+export declare const GPT5_UNSUPPORTED_SAMPLING_PARAMS: string[];
+/**
+ * True for the original GPT-5 reasoning models — `gpt-5`, `gpt-5-mini`, `gpt-5-nano`,
+ * `gpt-5-pro`, `gpt-5-codex` and their dated snapshots — which reject the params above
+ * unconditionally. https://developers.openai.com/api/docs/guides/latest-model
+ *
+ * Scoped to that family on purpose. From gpt-5.1 onwards support depends on `reasoning_effort`,
+ * and per-model quirks (`-pro` cannot disable reasoning, some `-chat` aliases still reason)
+ * can't be read off the model name reliably — an earlier attempt to encode them here got two
+ * families wrong. So those are forwarded and the provider validates them, which fails loudly
+ * instead of silently discarding what the caller asked for. The durable fix is the model
+ * catalogue; see the TODO above.
+ *
+ * The `includes('gpt-5')` gate is deliberately loose: Azure deployment names are arbitrary and
+ * callers rely on a deployment named e.g. `prod-gpt-5-east` matching when no foundation model
+ * is set.
+ */
+export declare function isBaseGpt5ReasoningModel(model: string): boolean;
+/**
+ * Authentication types supported by the system
+ */
+export type AuthType = 'default' | 'gemini-api-key' | 'azure-api-key';
+/**
+ * ================================
+ * TLS Certificate Error Codes and Messages
+ * Reference: https://nodejs.org/api/tls.html
+ * These are official Node.js TLS error codes from OpenSSL
+ * Keys are the error codes, values are user-friendly error messages
+ * ================================
+ */
+export declare const TLS_ERROR_CONFIG: Record<string, string>;