@juspay/neurolink 9.14.0 → 9.16.0

package/dist/lib/providers/anthropic.d.ts

@@ -1,15 +1,129 @@
 import { type LanguageModelV1 } from "ai";
 import { type AIProviderName } from "../constants/enums.js";
 import { BaseProvider } from "../core/baseProvider.js";
+import type { TextGenerationOptions, EnhancedGenerateResult } from "../types/generateTypes.js";
 import type { StreamOptions, StreamResult } from "../types/streamTypes.js";
 import type { ValidationSchema } from "../types/typeAliases.js";
+import type { ClaudeSubscriptionTier, AnthropicAuthMethod, AnthropicResponseMetadata, ClaudeUsageInfo } from "../types/subscriptionTypes.js";
+import type { AnthropicProviderConfig } from "../types/providers.js";
+/**
+ * Beta headers for Claude Code integration.
+ * These enable experimental features:
+ * - claude-code-20250219: Claude Code specific features
+ * - interleaved-thinking-2025-05-14: Interleaved thinking mode
+ * - fine-grained-tool-streaming-2025-05-14: Fine-grained tool streaming
+ */
+declare const ANTHROPIC_BETA_HEADERS: {
+    "anthropic-beta": string;
+};
+export type { AnthropicProviderConfig } from "../types/providers.js";
 /**
  * Anthropic Provider v2 - BaseProvider Implementation
- * Fixed syntax and enhanced with proper error handling
+ * Enhanced with OAuth support, subscription tiers, and beta headers for Claude Code integration.
  */
 export declare class AnthropicProvider extends BaseProvider {
     private model;
-    constructor(modelName?: string, sdk?: unknown);
+    private readonly authMethod;
+    private readonly subscriptionTier;
+    private readonly enableBetaFeatures;
+    private oauthToken;
+    private lastResponseMetadata;
+    private usageInfo;
+    private refreshPromise?;
+    /**
+     * Create a new Anthropic provider instance.
+     *
+     * @param modelName - Optional model name to use (defaults to CLAUDE_3_5_SONNET)
+     * @param sdk - Optional NeuroLink SDK instance
+     * @param config - Optional configuration options for auth, subscription tier, and beta features
+     */
+    constructor(modelName?: string, sdk?: unknown, config?: AnthropicProviderConfig);
+    /**
+     * Get authentication headers based on current auth method and configuration.
+     *
+     * @returns Headers object containing auth and beta feature headers
+     */
+    getAuthHeaders(): Record<string, string>;
+    /**
+     * Validate if a model is accessible with the current subscription tier.
+     *
+     * @param model - The model ID to validate
+     * @returns true if the model is accessible, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const provider = new AnthropicProvider();
+     * if (provider.validateModelAccess("claude-opus-4-5-20251101")) {
+     *   // Use the model
+     * } else {
+     *   // Fall back to a different model or show upgrade prompt
+     * }
+     * ```
+     */
+    validateModelAccess(model: string): boolean;
+    /**
+     * Get current usage information.
+     *
+     * Returns usage tracking data including messages sent, tokens consumed,
+     * and remaining quotas. This information is updated after each API request.
+     *
+     * @returns Current usage info or null if no requests have been made
+     *
+     * @example
+     * ```typescript
+     * const usage = provider.getUsageInfo();
+     * if (usage && usage.tokenQuotaPercent > 80) {
+     *   console.warn("Approaching token quota limit");
+     * }
+     * ```
+     */
+    getUsageInfo(): ClaudeUsageInfo | null;
+    /**
+     * Check if beta features are enabled for this provider instance.
+     *
+     * @returns true if beta features are enabled
+     */
+    areBetaFeaturesEnabled(): boolean;
+    /**
+     * Get model capabilities for the current model.
+     *
+     * @returns The model capabilities or undefined if not found
+     */
+    getModelCapabilities(): import("../types/subscriptionTypes.js").AnthropicModelMetadata | undefined;
+    /**
+     * Get the current subscription tier.
+     * @returns The detected or configured subscription tier
+     */
+    getSubscriptionTier(): ClaudeSubscriptionTier;
+    /**
+     * Get the authentication method being used.
+     * @returns The current authentication method
+     */
+    getAuthMethod(): AnthropicAuthMethod;
+    /**
+     * Refresh OAuth token if needed and possible.
+     * This method checks if the token is expired or about to expire,
+     * and attempts to refresh it using the refresh token if available.
+     *
+     * @returns Promise that resolves when refresh is complete (or not needed)
+     * @throws Error if refresh is needed but fails
+     */
+    refreshAuthIfNeeded(): Promise<void>;
+    /**
+     * Get the last response metadata including rate limit information.
+     * @returns The last response metadata or null if no request has been made
+     */
+    getLastResponseMetadata(): AnthropicResponseMetadata | null;
+    /**
+     * Update response metadata from API response headers.
+     * This should be called after each API request to track rate limits.
+     * @param headers - Response headers from the API
+     * @param requestId - Optional request ID
+     */
+    protected updateResponseMetadata(headers: Headers | Record<string, string>, requestId?: string, usageUpdate?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    }): void;
     getProviderName(): AIProviderName;
     getDefaultModel(): string;
     /**
@@ -17,8 +131,15 @@ export declare class AnthropicProvider extends BaseProvider {
      */
     getAISDKModel(): LanguageModelV1;
     protected formatProviderError(error: unknown): Error;
+    /**
+     * Override generate to refresh the OAuth token before delegating to
+     * BaseProvider so that expired tokens are renewed automatically.
+     */
+    generate(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: ValidationSchema): Promise<EnhancedGenerateResult | null>;
     protected executeStream(options: StreamOptions, _analysisSchema?: ValidationSchema): Promise<StreamResult>;
     isAvailable(): Promise<boolean>;
     getModel(): LanguageModelV1;
 }
+export { ModelAccessError, isModelAvailableForTier, getRecommendedModelForTier, getModelCapabilities, } from "../models/anthropicModels.js";
+export { ANTHROPIC_BETA_HEADERS };
 export default AnthropicProvider;