@juspay/neurolink 11.12.0 → 11.13.1

package/dist/lib/types/subscription.d.ts

@@ -1,1064 +0,0 @@
-/**
- * Claude Subscription Types for NeuroLink
- *
- * Type definitions for Claude subscription tiers, authentication methods,
- * and usage tracking for Anthropic API access.
- */
-import type { StoredOAuthTokens } from "./auth.js";
-export type { StoredOAuthTokens, TokenRefresher, TokenStorageData, StoredProviderTokens, } from "./auth.js";
-/**
- * Claude subscription tier levels
- *
- * @description Represents the different subscription tiers available for Claude:
- * - "free": Free tier with basic access and limited usage
- * - "pro": Professional tier with higher limits and priority access
- * - "max": Maximum tier with highest limits and advanced features (alias for max_5)
- * - "max_5": Max 5x usage tier
- * - "max_20": Max 20x usage tier
- * - "api": Direct API access tier for developers and enterprises
- */
-export type ClaudeSubscriptionTier = "free" | "pro" | "max" | "max_5" | "max_20" | "api";
-/**
- * Authentication methods supported for Anthropic API access
- *
- * @description Defines the available authentication methods:
- * - "api_key": Traditional API key authentication for direct API access
- * - "oauth": OAuth 2.0 authentication for subscription-based access
- */
-export type AnthropicAuthMethod = "api_key" | "oauth";
-/**
- * OAuth token structure for Claude subscriptions
- *
- * @description Contains the OAuth token information for authenticated sessions
- */
-export type OAuthToken = {
-    /**
-     * The access token for API requests
-     */
-    accessToken: string;
-    /**
-     * The refresh token for obtaining new access tokens
-     */
-    refreshToken?: string;
-    /**
-     * Token expiration timestamp (Unix milliseconds, i.e. Date.now() scale)
-     */
-    expiresAt?: number;
-    /**
-     * Token type (typically "Bearer")
-     */
-    tokenType?: string;
-    /**
-     * Scopes granted to this token
-     */
-    scopes?: string[];
-};
-/**
- * Rate limit information parsed from Anthropic API response headers
- *
- * @see https://docs.anthropic.com/en/api/rate-limits
- */
-export type AnthropicRateLimitInfo = {
-    /**
-     * Maximum number of requests allowed in the current window
-     */
-    requestsLimit?: number;
-    /**
-     * Number of requests remaining in the current window
-     */
-    requestsRemaining?: number;
-    /**
-     * Time when the request limit resets (ISO 8601 timestamp)
-     */
-    requestsReset?: string;
-    /**
-     * Maximum number of tokens allowed in the current window
-     */
-    tokensLimit?: number;
-    /**
-     * Number of tokens remaining in the current window
-     */
-    tokensRemaining?: number;
-    /**
-     * Time when the token limit resets (ISO 8601 timestamp)
-     */
-    tokensReset?: string;
-    /**
-     * Retry-After header value in seconds (present on 429 responses)
-     */
-    retryAfter?: number;
-    /**
-     * Subscription (OAuth) window utilization, 0.0-1.0 of capacity USED, from
-     * `anthropic-ratelimit-unified-5h-utilization`.
-     *
-     * Anthropic publishes utilization for subscription windows, never an
-     * absolute remaining count — there is no message or token figure to report.
-     * `sessionLeftPct` below is the derived "how much is left".
-     */
-    sessionUtilization?: number;
-    /** "allowed" | "throttled" | "rejected" for the 5h window. */
-    sessionStatus?: string;
-    /** Unix epoch seconds at which the 5h window resets. */
-    sessionResetAt?: number;
-    /** Whole-percent capacity remaining in the 5h window (100 - utilization). */
-    sessionLeftPct?: number;
-    /** 7d window utilization, 0.0-1.0 of capacity USED. */
-    weeklyUtilization?: number;
-    weeklyStatus?: string;
-    weeklyResetAt?: number;
-    weeklyLeftPct?: number;
-    /** Authoritative top-level unified status; can be "rejected" even while both
-     *  sub-windows still report "allowed". */
-    unifiedStatus?: string;
-    /** Whether overage is permitted once a window is exhausted. */
-    overageStatus?: string;
-};
-/**
- * Per-request limit snapshot as observed by the Anthropic provider.
- *
- * Assembled from response headers on every request — whether the provider is
- * talking directly to Anthropic (both auth methods) or through the NeuroLink
- * Claude proxy. The `account`/`pool`/`servedBy` fields are populated only by
- * the proxy, which is the only party that knows them.
- */
-export type ClaudeLimitSnapshot = {
-    /** Rate-limit figures parsed from `anthropic-ratelimit-*` headers. */
-    rateLimit: AnthropicRateLimitInfo;
-    /**
-     * Provenance of the quota numbers. "snapshot" means the proxy reported a
-     * previously captured reading rather than one from this response; "none"
-     * means no Anthropic account served the request (e.g. a fallback provider).
-     * Absent when talking directly to Anthropic, where any figures are live.
-     */
-    quotaSource?: "live" | "snapshot" | "none";
-    /** Proxy account label that served the request. */
-    account?: string;
-    /** "oauth" | "api_key" | "passthrough". */
-    accountType?: string;
-    /** Upstream that produced the response — "anthropic" or a fallback provider. */
-    servedBy?: string;
-    /** Epoch ms until which the serving account is cooling. */
-    accountCoolingUntil?: number;
-    accountCoolingReason?: string;
-    /** Proxy account-pool headroom at response time. */
-    pool?: {
-        available?: number;
-        cooling?: number;
-        bestSessionLeftPct?: number;
-    };
-    /** Anthropic request id, for correlating with provider-side logs. */
-    requestId?: string;
-    /** HTTP status of the response the snapshot came from. */
-    status?: number;
-    /** Epoch ms when this snapshot was captured. */
-    capturedAt: number;
-};
-/**
- * Per-request capture slot the Anthropic fetch wrapper writes into.
- *
- * Held in AsyncLocalStorage for the duration of a generate/stream call, so
- * concurrent calls on one provider instance cannot see each other's limits.
- * `headers` keeps the raw response header bag so the AI-SDK model adapter can
- * report real response headers.
- */
-export type ClaudeLimitCaptureSlot = {
-    snapshot?: ClaudeLimitSnapshot;
-    headers?: Record<string, string>;
-};
-/**
- * Response metadata including rate limit information
- *
- * @description Contains metadata from Anthropic API responses
- */
-export type AnthropicResponseMetadata = {
-    /**
-     * Rate limit information from response headers
-     */
-    rateLimit?: AnthropicRateLimitInfo;
-    /**
-     * Request ID for debugging
-     */
-    requestId?: string;
-    /**
-     * Server timing information
-     */
-    serverTiming?: string;
-};
-/**
- * Anthropic authentication configuration
- *
- * @description Configuration interface for authenticating with Anthropic services.
- * Supports both API key and OAuth authentication methods.
- */
-export type AnthropicAuthConfig = {
-    /**
-     * Authentication method to use
-     * @see AnthropicAuthMethod
-     */
-    method: AnthropicAuthMethod;
-    /**
-     * API key for API key authentication method
-     * @description Required when method is "api_key"
-     */
-    apiKey?: string;
-    /**
-     * OAuth token object for OAuth authentication method
-     * @description Full OAuth token with access, refresh, and expiry information
-     */
-    oauthToken?: OAuthToken;
-    /**
-     * OAuth access token for OAuth authentication method
-     * @description Required when method is "oauth", obtained through OAuth flow
-     * @deprecated Use oauthToken.accessToken instead
-     */
-    accessToken?: string;
-    /**
-     * OAuth refresh token for obtaining new access tokens
-     * @description Optional for OAuth method, enables automatic token refresh
-     * @deprecated Use oauthToken.refreshToken instead
-     */
-    refreshToken?: string;
-    /**
-     * Token expiry timestamp in milliseconds (Unix epoch)
-     * @description Used to determine when access token needs to be refreshed
-     * @deprecated Use oauthToken.expiresAt instead
-     */
-    tokenExpiry?: number;
-    /**
-     * User's subscription tier
-     * @description Determines rate limits, features, and capabilities available
-     */
-    subscriptionTier?: ClaudeSubscriptionTier;
-    /**
-     * Whether to automatically refresh OAuth tokens
-     * @description When true, tokens will be refreshed before expiry
-     */
-    autoRefresh?: boolean;
-};
-/**
- * Subscription information for Claude API access
- *
- * @description Contains subscription tier and related metadata
- * for providers that support subscription-based access
- */
-export type SubscriptionInfo = {
-    /**
-     * The subscription tier
-     */
-    tier: ClaudeSubscriptionTier;
-    /**
-     * Whether the subscription is active
-     */
-    isActive: boolean;
-    /**
-     * Subscription start date (ISO 8601 timestamp)
-     */
-    startDate?: string;
-    /**
-     * Subscription renewal date (ISO 8601 timestamp)
-     */
-    renewalDate?: string;
-    /**
-     * Current rate limit information
-     */
-    rateLimit?: AnthropicRateLimitInfo;
-    /**
-     * Features available with this subscription
-     */
-    features?: SubscriptionFeatures;
-};
-/**
- * Claude quota information for tracking usage limits
- *
- * @description Represents the quota limits for a Claude subscription,
- * including message limits, token limits, and model access restrictions.
- */
-export type ClaudeQuotaInfo = {
-    /**
-     * Maximum messages allowed per time period
-     * @description Number of messages the user can send within the reset period
-     */
-    maxMessagesPerPeriod: number;
-    /**
-     * Maximum tokens allowed per time period
-     * @description Total tokens (input + output) allowed within the reset period
-     */
-    maxTokensPerPeriod: number;
-    /**
-     * Maximum tokens per individual request
-     * @description Limit on tokens for a single API request
-     */
-    maxTokensPerRequest: number;
-    /**
-     * Time period for quota reset in milliseconds
-     * @description Duration after which quota counters reset (e.g., 3600000 for 1 hour)
-     */
-    resetPeriodMs: number;
-    /**
-     * Timestamp when quota will reset (Unix epoch in milliseconds)
-     * @description Next quota reset time
-     */
-    nextResetTimestamp: number;
-    /**
-     * List of models accessible with current subscription
-     * @description Model identifiers the user has access to based on tier
-     */
-    availableModels: string[];
-    /**
-     * Whether priority queue access is enabled
-     * @description Priority access reduces wait times during high traffic
-     */
-    hasPriorityAccess: boolean;
-    /**
-     * Maximum concurrent requests allowed
-     * @description Number of simultaneous API requests permitted
-     */
-    maxConcurrentRequests: number;
-    /**
-     * Whether extended thinking is available
-     * @description Access to extended thinking/reasoning capabilities
-     */
-    hasExtendedThinking: boolean;
-    /**
-     * Maximum context window size in tokens
-     * @description Maximum context length supported for the subscription tier
-     */
-    maxContextWindow: number;
-};
-/**
- * Claude usage information for tracking current consumption
- *
- * @description Represents the current usage state within a billing period,
- * tracking messages sent, tokens consumed, and remaining quotas.
- */
-export type ClaudeUsageInfo = {
-    /**
-     * Messages sent in current period
-     * @description Count of messages sent since last quota reset
-     */
-    messagesUsed: number;
-    /**
-     * Messages remaining in current period
-     * @description Calculated as maxMessagesPerPeriod - messagesUsed
-     */
-    messagesRemaining: number;
-    /**
-     * Tokens consumed in current period
-     * @description Total tokens (input + output) used since last reset
-     */
-    tokensUsed: number;
-    /**
-     * Tokens remaining in current period
-     * @description Calculated as maxTokensPerPeriod - tokensUsed
-     */
-    tokensRemaining: number;
-    /**
-     * Input tokens consumed in current period
-     * @description Prompt/input tokens used since last reset
-     */
-    inputTokensUsed: number;
-    /**
-     * Output tokens consumed in current period
-     * @description Response/output tokens used since last reset
-     */
-    outputTokensUsed: number;
-    /**
-     * Timestamp of last API request (Unix epoch in milliseconds)
-     * @description When the last successful request was made
-     */
-    lastRequestTimestamp: number;
-    /**
-     * Current rate limit status
-     * @description Whether the user is currently rate limited
-     */
-    isRateLimited: boolean;
-    /**
-     * Timestamp when rate limit expires (Unix epoch in milliseconds)
-     * @description When rate limiting will be lifted, if applicable
-     */
-    rateLimitExpiresAt?: number;
-    /**
-     * Total requests made in current period
-     * @description Count of all API requests since last reset
-     */
-    requestCount: number;
-    /**
-     * Usage percentage of message quota
-     * @description Percentage of message quota consumed (0-100)
-     */
-    messageQuotaPercent: number;
-    /**
-     * Usage percentage of token quota
-     * @description Percentage of token quota consumed (0-100)
-     */
-    tokenQuotaPercent: number;
-};
-/**
- * Subscription features defining capabilities per tier
- *
- * @description Defines what features and capabilities are available
- * for each subscription tier. Used to determine access to specific
- * functionality and feature gating.
- */
-export type SubscriptionFeatures = {
-    /**
-     * Subscription tier this feature set belongs to
-     */
-    tier: ClaudeSubscriptionTier;
-    /**
-     * Whether chat/conversation access is enabled
-     * @description Basic chat functionality with Claude
-     */
-    hasChat: boolean;
-    /**
-     * Whether API access is enabled
-     * @description Programmatic access to Claude via API
-     */
-    hasApiAccess: boolean;
-    /**
-     * Whether extended thinking/reasoning is enabled
-     * @description Access to extended thinking capabilities for complex reasoning
-     */
-    hasExtendedThinking: boolean;
-    /**
-     * Whether priority queue access is enabled
-     * @description Faster response times during high traffic periods
-     */
-    hasPriorityAccess: boolean;
-    /**
-     * Whether vision/image analysis is enabled
-     * @description Ability to analyze images and visual content
-     */
-    hasVision: boolean;
-    /**
-     * Whether file/document analysis is enabled
-     * @description Ability to process PDFs, documents, and other files
-     */
-    hasFileAnalysis: boolean;
-    /**
-     * Whether code execution is enabled
-     * @description Access to code execution/analysis features
-     */
-    hasCodeExecution: boolean;
-    /**
-     * Whether MCP (Model Context Protocol) tools are enabled
-     * @description Access to external tool integrations via MCP
-     */
-    hasMcpTools: boolean;
-    /**
-     * Whether computer use capability is enabled
-     * @description Access to computer use/automation features
-     */
-    hasComputerUse: boolean;
-    /**
-     * Whether web search is enabled
-     * @description Access to web search capabilities
-     */
-    hasWebSearch: boolean;
-    /**
-     * Maximum context window size in tokens
-     * @description Limit on context/conversation length
-     */
-    maxContextWindow: number;
-    /**
-     * Maximum output tokens per request
-     * @description Limit on response length per request
-     */
-    maxOutputTokens: number;
-    /**
-     * List of accessible model identifiers
-     * @description Which Claude models are available for this tier
-     */
-    availableModels: string[];
-    /**
-     * Daily message limit
-     * @description Maximum messages per day, -1 for unlimited
-     */
-    dailyMessageLimit: number;
-    /**
-     * Monthly token limit
-     * @description Maximum tokens per month, -1 for unlimited
-     */
-    monthlyTokenLimit: number;
-    /**
-     * Whether usage analytics are available
-     * @description Access to detailed usage statistics and analytics
-     */
-    hasUsageAnalytics: boolean;
-    /**
-     * Whether team/organization features are enabled
-     * @description Access to team management and collaboration features
-     */
-    hasTeamFeatures: boolean;
-    /**
-     * Custom feature flags for extensibility
-     * @description Additional feature flags for future capabilities
-     */
-    customFeatures?: Record<string, boolean>;
-};
-/**
- * Subscription tier comparison result
- *
- * @description Result of comparing two subscription tiers
- */
-export type TierComparisonResult = {
-    /** Whether the first tier is higher than the second */
-    isHigher: boolean;
-    /** Whether the first tier is lower than the second */
-    isLower: boolean;
-    /** Whether the tiers are equal */
-    isEqual: boolean;
-    /** Numeric difference between tier levels (positive = first is higher) */
-    levelDifference: number;
-};
-/**
- * Authentication state for tracking auth status
- *
- * @description Represents the current authentication state
- */
-export type AuthenticationState = {
-    /** Whether the user is authenticated */
-    isAuthenticated: boolean;
-    /** Current authentication method in use */
-    method?: AnthropicAuthMethod;
-    /** Current subscription tier */
-    tier?: ClaudeSubscriptionTier;
-    /** Whether tokens need to be refreshed */
-    needsRefresh: boolean;
-    /** Error message if authentication failed */
-    error?: string;
-    /** Timestamp of last successful authentication */
-    lastAuthenticatedAt?: number;
-};
-/**
- * Quota check result for determining if an operation can proceed
- *
- * @description Result of checking whether quota allows an operation
- */
-export type QuotaCheckResult = {
-    /** Whether the operation is allowed within quota */
-    allowed: boolean;
-    /** Reason if operation is not allowed */
-    reason?: string;
-    /** Estimated tokens required for the operation */
-    estimatedTokens?: number;
-    /** Tokens remaining after operation (if allowed) */
-    tokensRemainingAfter?: number;
-    /** Suggested wait time in ms if rate limited */
-    suggestedWaitMs?: number;
-};
-/**
- * OAuth tokens structure for Claude subscription authentication
- *
- * @description Contains OAuth token information for authenticated sessions.
- * This is the preferred type for OAuth token storage.
- */
-/**
- * OAuth configuration for Claude subscription authentication
- *
- * @description Configuration for OAuth 2.0 authentication flow with Claude/Anthropic.
- * Used to configure the OAuth client for subscription-based access.
- */
-export type OAuthConfig = {
-    /**
-     * OAuth client ID for the application
-     * @description Obtained from Anthropic developer console
-     */
-    clientId: string;
-    /**
-     * OAuth redirect URI for the callback
-     * @description Must match the registered redirect URI in Anthropic console
-     */
-    redirectUri: string;
-    /**
-     * OAuth scopes to request
-     * @description Array of scope strings defining requested permissions
-     */
-    scopes: string[];
-    /**
-     * OAuth client secret (optional, for confidential clients)
-     * @description Only used for server-side OAuth flows
-     */
-    clientSecret?: string;
-    /**
-     * OAuth authorization endpoint URL
-     * @description Anthropic's OAuth authorization URL
-     */
-    authorizationEndpoint?: string;
-    /**
-     * OAuth token endpoint URL
-     * @description Anthropic's OAuth token exchange URL
-     */
-    tokenEndpoint?: string;
-    /**
-     * PKCE code verifier (for public clients)
-     * @description Used with PKCE flow for enhanced security
-     */
-    codeVerifier?: string;
-    /**
-     * State parameter for CSRF protection
-     * @description Random string to prevent CSRF attacks
-     */
-    state?: string;
-};
-/**
- * Usage quota for tracking Claude subscription usage
- *
- * @description Simplified quota tracking structure for monitoring
- * subscription usage against limits. Used for real-time quota monitoring.
- */
-export type UsageQuota = {
-    /**
-     * Current subscription tier
-     */
-    tier: ClaudeSubscriptionTier;
-    /**
-     * Daily tokens used in current period
-     */
-    dailyTokensUsed: number;
-    /**
-     * Daily token limit for current tier
-     */
-    dailyTokensLimit: number;
-    /**
-     * Messages used in current period
-     */
-    messagesUsed: number;
-    /**
-     * Message limit for current tier
-     */
-    messagesLimit: number;
-    /**
-     * Time when usage counters will reset
-     */
-    resetTime: Date;
-    /**
-     * Current requests used in rate limit window
-     */
-    requestsUsed?: number;
-    /**
-     * Request limit for rate limit window
-     */
-    requestsLimit?: number;
-    /**
-     * Whether quota is currently exceeded
-     */
-    isExceeded?: boolean;
-    /**
-     * Percentage of quota used (0-100)
-     */
-    usagePercent?: number;
-};
-/**
- * Anthropic beta feature flags for beta header configuration
- *
- * @description Defines available beta features that can be enabled via
- * the anthropic-beta header. Each feature enables specific beta functionality.
- *
- * @see https://docs.anthropic.com/en/api/versioning#beta-headers
- */
-export type AnthropicBetaFeatures = {
-    /**
-     * Enable computer use capability
-     * @description Allows Claude to interact with computer interfaces
-     * Header value: "computer-use-2024-10-22"
-     */
-    computerUse?: boolean;
-    /**
-     * Enable extended thinking/reasoning
-     * @description Allows extended thinking for complex reasoning tasks
-     * Header value: "extended-thinking-2025-01-24"
-     */
-    extendedThinking?: boolean;
-    /**
-     * Enable prompt caching
-     * @description Allows caching of prompts for reduced latency
-     * Header value: "prompt-caching-2024-07-31"
-     */
-    promptCaching?: boolean;
-    /**
-     * Enable token counting
-     * @description Allows pre-counting tokens before generation
-     * Header value: "token-counting-2024-11-01"
-     */
-    tokenCounting?: boolean;
-    /**
-     * Enable message batches
-     * @description Allows batch processing of multiple messages
-     * Header value: "message-batches-2024-09-24"
-     */
-    messageBatches?: boolean;
-    /**
-     * Enable PDF support
-     * @description Allows processing PDF documents
-     * Header value: "pdfs-2024-09-25"
-     */
-    pdfs?: boolean;
-    /**
-     * Enable max tokens override (for higher output limits)
-     * @description Allows requesting more output tokens than default
-     * Header value: "max-tokens-3-5-sonnet-2024-07-15"
-     */
-    maxTokensOverride?: boolean;
-    /**
-     * Enable interleaved thinking (for multi-turn reasoning)
-     * @description Allows interleaved thinking in conversations
-     * Header value: "interleaved-thinking-2025-01-24"
-     */
-    interleavedThinking?: boolean;
-    /**
-     * Enable files API
-     * @description Allows using the Files API for document processing
-     * Header value: "files-api-2025-01-15"
-     */
-    filesApi?: boolean;
-    /**
-     * Enable MCP connectors
-     * @description Allows using MCP connectors for tool integrations
-     * Header value: "mcp-connectors-2025-01-01"
-     */
-    mcpConnectors?: boolean;
-    /**
-     * Enable code execution
-     * @description Allows Claude to execute code
-     * Header value: "code-execution-2025-01-24"
-     */
-    codeExecution?: boolean;
-    /**
-     * Custom beta features as raw strings
-     * @description For beta features not yet added to this type
-     */
-    custom?: string[];
-};
-/**
- * Anthropic beta header string values
- *
- * @description The actual string values used in the anthropic-beta header.
- * Use AnthropicBetaFeatures for configuration, this is for internal use.
- */
-export type AnthropicBetaHeader = "computer-use-2024-10-22" | "extended-thinking-2025-01-24" | "prompt-caching-2024-07-31" | "token-counting-2024-11-01" | "message-batches-2024-09-24" | "pdfs-2024-09-25" | "max-tokens-3-5-sonnet-2024-07-15" | "interleaved-thinking-2025-01-24" | "files-api-2025-01-15" | "mcp-connectors-2025-01-01" | "code-execution-2025-01-24" | string;
-/**
- * Subscription information summary for display purposes
- *
- * @description Extended subscription information including human-readable
- * tier descriptions and usage data. Use for UI display and status reporting.
- * For basic subscription state, see SubscriptionInfo.
- */
-export type SubscriptionInfoSummary = {
-    /** Current subscription tier */
-    tier: ClaudeSubscriptionTier;
-    /** Human-readable tier name */
-    tierName: string;
-    /** Human-readable tier description */
-    description: string;
-    /** Messages allowed per day (-1 for unlimited) */
-    messagesPerDay: number | "unlimited";
-    /** Maximum context window size in tokens */
-    contextWindow: number;
-    /** Whether the user has priority access */
-    priorityAccess: boolean;
-    /** Whether the subscription is active */
-    isActive: boolean;
-    /** Subscription expiration date (if applicable) */
-    expiresAt?: number;
-    /** Current usage information */
-    usage?: ClaudeUsageInfo;
-    /** Available features for this tier */
-    features?: SubscriptionFeatures;
-};
-/**
- * OAuth 2.0 token response from Anthropic (raw API response shape)
- */
-export type OAuthTokenResponse = {
-    /** The access token for API authentication */
-    access_token: string;
-    /** Token type (typically "Bearer") */
-    token_type: string;
-    /** Token expiration time in seconds */
-    expires_in: number;
-    /** Refresh token for obtaining new access tokens */
-    refresh_token?: string;
-    /** Granted scopes (space-separated) */
-    scope?: string;
-};
-/**
- * Parsed OAuth tokens from a fresh OAuth flow.
- * Uses Date for expiresAt (vs number in OAuthTokens for storage).
- */
-export type OAuthFlowTokens = {
-    /** The access token for API authentication */
-    accessToken: string;
-    /** Token type (typically "Bearer") */
-    tokenType: string;
-    /** Expiration timestamp (Date object) */
-    expiresAt: Date;
-    /** Refresh token for obtaining new access tokens */
-    refreshToken?: string;
-    /** Granted scopes as an array */
-    scopes: string[];
-};
-/**
- * Token validation result
- */
-export type ClaudeTokenValidationResult = {
-    /** Whether the token is valid */
-    isValid: boolean;
-    /** Remaining time in seconds until expiration */
-    expiresIn?: number;
-    /** Scopes associated with the token */
-    scopes?: string[];
-    /** User information if available */
-    user?: {
-        id: string;
-        email?: string;
-        subscription?: string;
-    };
-    /** Error message if validation failed */
-    error?: string;
-};
-/**
- * OAuth configuration options for AnthropicOAuth class
- */
-export type AnthropicOAuthConfig = {
-    /** OAuth client ID (optional, uses env var if not provided) */
-    clientId?: string;
-    /** OAuth client secret (optional, for confidential clients) */
-    clientSecret?: string;
-    /** Redirect URI for OAuth callback */
-    redirectUri?: string;
-    /** OAuth scopes to request */
-    scopes?: string[];
-    /** Custom authorization endpoint URL */
-    authorizationUrl?: string;
-    /** Custom token endpoint URL */
-    tokenUrl?: string;
-    /** Custom token validation endpoint URL */
-    validationUrl?: string;
-    /** Custom token revocation endpoint URL */
-    revocationUrl?: string;
-};
-/**
- * PKCE (Proof Key for Code Exchange) parameters
- */
-export type PKCEParams = {
-    /** Code verifier - random string used to generate challenge */
-    codeVerifier: string;
-    /** Code challenge - SHA-256 hash of verifier, base64url encoded */
-    codeChallenge: string;
-    /** Code challenge method - always "S256" */
-    codeChallengeMethod: "S256";
-};
-/**
- * Callback server result containing the authorization code
- */
-export type CallbackResult = {
-    /** Authorization code from OAuth callback */
-    code: string;
-    /** State parameter for CSRF verification */
-    state?: string;
-};
-/**
- * Anthropic authentication configuration result for providerConfig
- * Extended version with OAuth token details for configuration detection
- */
-export type AnthropicAuthConfigResult = {
-    method: AnthropicAuthMethod;
-    tier: ClaudeSubscriptionTier;
-    apiKey?: string;
-    accessToken?: string;
-    refreshToken?: string;
-    isConfigured: boolean;
-    error?: string;
-};
-/**
- * Unified authentication options for NeuroLink
- *
- * Supports both direct API key authentication and OAuth-based authentication
- * for Claude Pro/Max subscriptions.
- */
-export type NeuroLinkAuthOptions = {
-    /**
-     * Authentication method to use
-     * - "api-key": Use ANTHROPIC_API_KEY environment variable
-     * - "oauth": Use OAuth 2.0 flow for Claude Pro/Max subscriptions
-     */
-    method: "api-key" | "oauth";
-    /**
-     * OAuth configuration (required when method is "oauth")
-     */
-    oauth?: {
-        /** OAuth client ID */
-        clientId?: string;
-        /** OAuth redirect URI */
-        redirectUri?: string;
-        /** Custom scopes to request */
-        scopes?: string[];
-    };
-    /**
-     * Token storage configuration (optional, defaults to file-based storage)
-     */
-    tokenStorage?: {
-        /** Enable encryption for stored tokens */
-        encryptionEnabled?: boolean;
-        /** Custom storage path */
-        customStoragePath?: string;
-    };
-};
-/**
- * Authentication status result
- */
-export type AuthStatus = {
-    /** Whether the user is authenticated */
-    isAuthenticated: boolean;
-    /** Authentication method in use */
-    method: "api-key" | "oauth" | "none";
-    /** Token expiration time (for OAuth) */
-    expiresAt?: Date;
-    /** Whether token refresh is needed (for OAuth) */
-    needsRefresh?: boolean;
-    /** User information (for OAuth) */
-    user?: {
-        id?: string;
-        email?: string;
-        subscription?: string;
-    };
-};
-/**
- * Model metadata definition for Anthropic models
- */
-export type AnthropicModelMetadata = {
-    /** Human-readable display name */
-    displayName: string;
-    /** Maximum context window size in tokens */
-    contextWindow: number;
-    /** Maximum output tokens */
-    maxOutputTokens: number;
-    /** Whether the model supports vision/image input */
-    supportsVision: boolean;
-    /** Whether the model supports extended thinking mode */
-    supportsExtendedThinking: boolean;
-    /** Whether the model supports tool/function calling */
-    supportsToolUse: boolean;
-    /** Whether the model supports streaming */
-    supportsStreaming: boolean;
-    /** Whether the model is deprecated */
-    deprecated: boolean;
-    /** Model family (haiku, sonnet, opus) */
-    family: "haiku" | "sonnet" | "opus";
-    /** Short description of the model */
-    description: string;
-};
-/** A single Claude account in the pool */
-export type ProxyAccount = {
-    id: string;
-    label?: string;
-    type: "oauth" | "api_key";
-    tokens?: StoredOAuthTokens;
-    apiKey?: string;
-    status: "healthy" | "cooling" | "disabled";
-    cooldownUntil?: number;
-    consecutiveFailures: number;
-    requestCount: number;
-    lastUsed: number;
-    subscriptionTier?: ClaudeSubscriptionTier;
-};
-/** Configuration for AccountPool */
-export type AccountPoolConfig = {
-    strategy: "round-robin" | "fill-first";
-    defaultCooldownMs?: number;
-    maxCooldownMs?: number;
-    maxRetryAccounts?: number;
-};
-/** A single model mapping entry */
-export type ModelMapping = {
-    from: string;
-    to: string;
-    provider: string;
-};
-/** A fallback chain entry */
-export type FallbackEntry = {
-    provider: string;
-    model: string;
-};
-/** Full proxy routing config */
-export type ProxyRoutingConfig = {
-    strategy: "round-robin" | "fill-first";
-    modelMappings: ModelMapping[];
-    fallbackChain: FallbackEntry[];
-    /** Permit a last-resort provider chosen by the translation layer. Disabled by default. */
-    autoFallback?: boolean;
-    /**
-     * Optional in-flight upstream request cap per OAuth account.
-     *
-     * Unlimited admission is the result of omitting it AND of any value outside
-     * the accepted range — a non-integer, or anything below 1 or above 20 — since
-     * `normalizeMaxInflightPerAccount()` discards those rather than clamping.
-     */
-    maxInflightPerAccount?: number;
-    passthroughModels?: string[];
-    /** Enable quota-aware fill-first account ordering. Defaults to true. */
-    quotaRouting?: boolean;
-    /**
-     * Whether an account may keep serving on paid extra usage once its
-     * subscription window is spent.
-     *
-     * - `auto` (default): follow whatever Anthropic reports for the account.
-     * - `never`: park the account at the subscription limit even when extra usage
-     *   is enabled, so the pool can never spend credits.
-     * - `always`: keep serving whenever the provider permits extra usage.
-     *
-     * Only `never` can override the provider — nothing here can enable extra usage
-     * that Anthropic has disabled (e.g. `org_level_disabled`).
-     */
-    useOverage?: "auto" | "always" | "never";
-    /** Session utilization threshold used to proactively demote an account. */
-    sessionSoftLimit?: number;
-    /** Reset-time bucket width used when ordering quota windows. */
-    sessionResetToleranceMs?: number;
-    /** Email/label of the Anthropic account that should be tried first
-     *  ("home"). When absent, falls back to insertion-order index 0.
-     *  Resolved per-request to a stable key (anthropic:<email>); does not
-     *  encode an index. */
-    primaryAccount?: string;
-    /** Anthropic account emails/labels that may be loaded by the proxy. When
-     *  present, every token-store, legacy, and environment credential outside
-     *  this set is excluded before refresh or routing. An empty list denies all
-     *  stored credentials. */
-    accountAllowlist?: string[];
-};
-/** Cloaking plugin config */
-export type CloakingConfig = {
-    mode: "auto" | "always" | "never";
-    plugins: {
-        headerScrubber?: boolean;
-        sessionIdentity?: boolean;
-        systemPromptInjector?: boolean;
-        wordObfuscator?: {
-            enabled: boolean;
-            words: string[];
-        };
-        tlsFingerprint?: {
-            enabled: boolean;
-        };
-    };
-};
-/** Full proxy config (loaded from YAML) */
-export type ProxyConfig = {
-    host?: string;
-    port?: number;
-    auth?: "none" | "api-key";
-    proxyApiKey?: string;
-    /** Provider-keyed account map matching the YAML structure (e.g. accounts.anthropic[0]) */
-    accounts?: Record<string, Array<{
-        name: string;
-        apiKey?: string;
-        weight?: number;
-        rateLimit?: number;
-        enabled?: boolean;
-        baseUrl?: string;
-        orgId?: string;
-        metadata?: Record<string, unknown>;
-    }>>;
-    routing?: Partial<ProxyRoutingConfig>;
-    cloaking?: CloakingConfig;
-};