@juspay/neurolink 9.30.0 → 9.31.1

package/dist/types/clientTypes.js

@@ -0,0 +1,10 @@
+/**
+ * Client SDK Type Definitions
+ *
+ * Comprehensive type definitions for the NeuroLink client SDK system.
+ * These types enable type-safe API access from JavaScript/TypeScript applications
+ * and React applications with hooks for agents, workflows, and real-time streaming.
+ *
+ * @module @neurolink/client/types
+ */
+export {};

package/dist/types/common.d.ts

@@ -174,3 +174,126 @@ export type TestResult = {
     /** Optional execution duration in milliseconds */
     duration?: number;
 };
+/**
+ * Result type for safe JSON parsing operations
+ */
+export type SafeParseResult<T> = {
+    success: boolean;
+    data: T | null;
+    error: Error | null;
+};
+/**
+ * Configuration options for retry operations with exponential backoff.
+ * Named AsyncRetryOptions to avoid collision with utilities.ts RetryOptions.
+ */
+export type AsyncRetryOptions = {
+    /**
+     * Maximum number of retry attempts (not including the initial attempt).
+     * @default 3
+     */
+    maxRetries: number;
+    /**
+     * Initial delay between retries in milliseconds.
+     * @default 1000
+     */
+    baseDelayMs: number;
+    /**
+     * Maximum delay cap in milliseconds.
+     * @default 30000
+     */
+    maxDelayMs: number;
+    /**
+     * Multiplier for exponential backoff.
+     * @default 2
+     */
+    backoffMultiplier?: number;
+    /**
+     * Function to determine if a retry should be attempted.
+     * Return false to stop retrying immediately.
+     */
+    shouldRetry?: (error: Error, attempt: number) => boolean;
+    /**
+     * Whether to add random jitter to backoff delays to prevent thundering herd.
+     * @default true
+     */
+    addJitter?: boolean;
+    /**
+     * Callback invoked before each retry attempt.
+     * Useful for logging or metrics.
+     */
+    onRetry?: (error: Error, attempt: number, delayMs: number) => void;
+};
+/**
+ * Raw usage object that may come from various AI providers.
+ * Supports multiple naming conventions and nested structures.
+ */
+export type RawUsageObject = {
+    input?: number;
+    output?: number;
+    total?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    promptTokens?: number;
+    completionTokens?: number;
+    cacheCreationInputTokens?: number;
+    cacheReadInputTokens?: number;
+    cacheCreationTokens?: number;
+    cacheReadTokens?: number;
+    reasoningTokens?: number;
+    reasoning?: number;
+    reasoning_tokens?: number;
+    thinkingTokens?: number;
+    usage?: RawUsageObject;
+};
+/**
+ * Options for token extraction from raw usage objects.
+ */
+export type TokenExtractionOptions = {
+    /**
+     * Whether to calculate cache savings percentage
+     * @default true
+     */
+    calculateCacheSavings?: boolean;
+    /**
+     * How to handle missing optional fields
+     * - "zero": Return 0 for missing optional fields
+     * - "undefined": Return undefined for missing optional fields (default)
+     */
+    missingOptionalBehavior?: "zero" | "undefined";
+};
+/**
+ * Model choice for CLI prompts (inquirer format)
+ */
+export type ModelChoice = {
+    name: string;
+    value: string;
+    description?: string;
+};
+/** Factory function type for creating instances. */
+export type FactoryFunction<TInstance, TConfig> = (config?: TConfig) => Promise<TInstance>;
+/** Factory registration entry. */
+export type FactoryRegistration<TInstance, TConfig> = {
+    factory: FactoryFunction<TInstance, TConfig>;
+    aliases: string[];
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Registry entry for lazy-loaded items in BaseRegistry.
+ * Named InfraRegistryEntry to avoid collision with workflowTypes.ts RegistryEntry.
+ */
+export type InfraRegistryEntry<TItem, TMetadata = unknown> = {
+    factory: () => Promise<TItem>;
+    metadata: TMetadata;
+    instance?: TItem;
+};
+/** Error code type (string-based). */
+export type ErrorCode = string;
+import type { z } from "zod";
+/** Utility functions for tool management. */
+export type ToolUtilities = {
+    isZodSchema?: (schema: unknown) => boolean;
+    convertToolResult?: (result: unknown) => Promise<unknown>;
+    createPermissiveZodSchema?: () => z.ZodSchema;
+    fixSchemaForOpenAIStrictMode?: (schema: Record<string, unknown>) => Record<string, unknown>;
+};

package/dist/types/configTypes.d.ts

@@ -221,3 +221,52 @@ export type ConfigUpdateOptions = {
  * Default configuration values
  */
 export declare const DEFAULT_CONFIG: NeuroLinkConfig;
+import { TOOL_TIMEOUTS, BACKOFF_CONFIG, PERFORMANCE_PROFILES, PROVIDER_OPERATION_CONFIGS, MCP_OPERATION_CONFIGS } from "../constants/index.js";
+/** Timeout category keys from TOOL_TIMEOUTS. */
+export type TimeoutCategory = keyof typeof TOOL_TIMEOUTS;
+/** Retry strategy keys from BACKOFF_CONFIG. */
+export type RetryStrategy = keyof typeof BACKOFF_CONFIG;
+/** Performance profile keys from PERFORMANCE_PROFILES. */
+export type PerformanceProfile = keyof typeof PERFORMANCE_PROFILES;
+/** Provider-specific operation config. */
+export type ProviderOperationConfig = (typeof PROVIDER_OPERATION_CONFIGS)[keyof typeof PROVIDER_OPERATION_CONFIGS];
+/** MCP-specific operation config. */
+export type McpOperationConfig = (typeof MCP_OPERATION_CONFIGS)[keyof typeof MCP_OPERATION_CONFIGS];
+/** Configuration options for the token bucket rate limiter. */
+export type RateLimiterConfig = {
+    /** Maximum tokens (downloads) allowed per interval */
+    maxTokens: number;
+    /** Refill interval in milliseconds */
+    refillIntervalMs: number;
+    /** Number of tokens to add per refill interval */
+    tokensPerRefill: number;
+    /** Maximum queue size for pending requests */
+    maxQueueSize: number;
+    /** Timeout for queued requests in milliseconds */
+    queueTimeoutMs: number;
+};
+/** ThinkingLevel type for Gemini 3 models. */
+export type ThinkingLevel = "minimal" | "low" | "medium" | "high";
+/** ThinkingConfig matching the SDK's expected structure. */
+export type ThinkingConfig = {
+    enabled?: boolean;
+    type?: "enabled" | "disabled";
+    /** Token budget for thinking (Anthropic models: 5000-100000) */
+    budgetTokens?: number;
+    /** Thinking level for Gemini 3 models */
+    thinkingLevel?: ThinkingLevel;
+};
+/** Options for creating a thinkingConfig from CLI-style options. */
+export type CreateThinkingConfigOptions = {
+    /** Enable thinking mode */
+    thinking?: boolean;
+    /** Token budget for thinking (defaults to 10000) */
+    thinkingBudget?: number;
+    /** Thinking level for Gemini 3 models */
+    thinkingLevel?: ThinkingLevel;
+};
+/** Native SDK thinkingConfig structure for Gemini native SDK. */
+export type NativeThinkingConfig = {
+    includeThoughts: boolean;
+    thinkingLevel: ThinkingLevel;
+};

package/dist/types/configTypes.js

@@ -48,3 +48,7 @@ export const DEFAULT_CONFIG = {
     },
     configVersion: "3.0.1",
 };
+// =============================================================================
+// CONSTANTS-DERIVED TYPES (moved from constants/index.ts)
+// =============================================================================
+import { TOOL_TIMEOUTS, BACKOFF_CONFIG, PERFORMANCE_PROFILES, PROVIDER_OPERATION_CONFIGS, MCP_OPERATION_CONFIGS, } from "../constants/index.js";

package/dist/types/conversation.d.ts

@@ -32,7 +32,6 @@
  * - Current time (Unix ms): `Date.now()`
  * - Current time (ISO): `new Date().toISOString()`
  */
-import type { Mem0Config } from "../memory/mem0Initializer.js";
 import type { Memory, StorageConfig } from "../memory/hippocampusInitializer.js";
 export type { Memory, StorageConfig };
 /**
@@ -51,10 +50,6 @@ export type ConversationMemoryConfig = {
     summarizationProvider?: string;
     /** Model to use for summarization */
     summarizationModel?: string;
-    /** Enable mem0 integration for conversation memory */
-    mem0Enabled?: boolean;
-    /** Configuration for mem0 cloud API integration */
-    mem0Config?: Mem0Config;
     /** Memory SDK config (condensed key-value memory per user). Set enabled: true to activate. */
     memory?: Memory;
     /** Redis configuration (optional) - overrides environment variables */

package/dist/types/evaluationTypes.d.ts

@@ -1,4 +1,4 @@
-import type { LanguageModelV1CallOptions } from "ai";
+import type { LanguageModelV3CallOptions } from "@ai-sdk/provider";
 import type { TokenUsage } from "./analytics.js";
 import type { GenerateResult } from "./generateTypes.js";
 import type { ToolExecution } from "./tools.js";
@@ -119,7 +119,7 @@ export type EvaluationConfig = {
     /** The provider to use for the evaluation model. */
     provider?: string;
     /** A custom evaluator function to override the default behavior. */
-    customEvaluator?: (options: LanguageModelV1CallOptions, result: GenerateResult) => Promise<{
+    customEvaluator?: (options: LanguageModelV3CallOptions, result: GenerateResult) => Promise<{
         evaluationResult: EvaluationResult;
         evalContext: EnhancedEvaluationContext;
     }>;

package/dist/types/fileTypes.d.ts

@@ -324,3 +324,50 @@ export type GoogleFilesAPIUploadResult = {
         uri: string;
     };
 };
+/** Options for converting PDF pages to images. */
+export type PDFImageConversionOptions = {
+    /** Scale factor for image quality (1-4, default: 2) */
+    scale?: number;
+    /** Maximum number of pages to convert (default: 20 from PDF_LIMITS.DEFAULT_MAX_PAGES) */
+    maxPages?: number;
+    /** Output format (default: png). Only PNG is currently implemented by PDFProcessor. */
+    format?: "png";
+};
+/** Result of PDF to image conversion. */
+export type PDFImageConversionResult = {
+    /** Array of base64-encoded PNG images (one per page) */
+    images: string[];
+    /** Number of pages converted */
+    pageCount: number;
+    /** Total conversion time in milliseconds */
+    conversionTimeMs: number;
+    /** Any warnings during conversion */
+    warnings?: string[];
+};
+/** Options for filename sanitization. */
+export type SanitizeFileNameOptions = {
+    /** Maximum length for the filename (default: 255) */
+    maxLength?: number;
+    /** Replacement character for invalid chars (default: '_') */
+    replacement?: string;
+    /** Whether to block dangerous extensions (default: true) */
+    blockDangerousExtensions?: boolean;
+    /** Whether to allow hidden files starting with dot (default: false) */
+    allowHiddenFiles?: boolean;
+};
+/** Options for display name sanitization. */
+export type SanitizeDisplayNameOptions = {
+    /** Maximum length for the name (default: 100) */
+    maxLength?: number;
+    /** Whether to allow unicode characters (default: true) */
+    allowUnicode?: boolean;
+};
+/** Result of SVG sanitization. */
+export type SvgSanitizationResult = {
+    /** Sanitized SVG content */
+    content: string;
+    /** Items that were removed during sanitization */
+    removedItems: string[];
+    /** Whether any content was modified */
+    wasModified: boolean;
+};

package/dist/types/generateTypes.d.ts

@@ -144,7 +144,7 @@ export type GenerateOptions = {
      *
      * Enables extended thinking capabilities for supported models.
      *
-     * **Gemini 3 Models** (gemini-3-pro-preview, gemini-3-flash-preview):
+     * **Gemini 3 Models** (gemini-3.1-pro-preview, gemini-3-flash-preview):
      * Use `thinkingLevel` to control reasoning depth:
      * - `minimal` - Near-zero thinking (Flash only)
      * - `low` - Fast reasoning for simple tasks
@@ -159,7 +159,7 @@ export type GenerateOptions = {
      * const result = await neurolink.generate({
      *   input: { text: "Solve this complex problem..." },
      *   provider: "google-ai",
-     *   model: "gemini-3-pro-preview",
+     *   model: "gemini-3.1-pro-preview",
      *   thinkingConfig: {
      *     thinkingLevel: "high"
      *   }
@@ -556,6 +556,10 @@ export type GenerateResult = {
         workflowId: string;
         workflowName: string;
     };
+    /** Thinking/reasoning text from provider (Anthropic thinking blocks, Gemini thought parts) */
+    reasoning?: string;
+    /** Token count for reasoning content */
+    reasoningTokens?: number;
     retries?: {
         count: number;
         errors: Array<{
@@ -808,7 +812,7 @@ export type TextGenerationOptions = {
      * - Range: 5000-100000 tokens
      * - `thinkingLevel` is ignored for Anthropic
      *
-     * **Google Gemini 3 (gemini-3-pro-preview, gemini-3-flash-preview):**
+     * **Google Gemini 3 (gemini-3.1-pro-preview, gemini-3-flash-preview):**
      * - Use `thinkingConfig.thinkingLevel` or `thinkingLevel`
      * - Levels: minimal, low, medium, high
      * - `budgetTokens` is ignored for Gemini (uses level-based allocation)

package/dist/types/guardrails.d.ts

@@ -1,4 +1,4 @@
-import type { LanguageModelV1 } from "ai";
+import type { LanguageModel } from "ai";
 /**
  * Result from precall evaluation of user input
  */
@@ -82,7 +82,7 @@ export type BadWordsConfig = {
 };
 export type ModelFilterConfig = {
     enabled?: boolean;
-    filterModel?: LanguageModelV1;
+    filterModel?: LanguageModel;
 };
 /**
  * Configuration for the Guardrails middleware

package/dist/types/index.d.ts

@@ -11,7 +11,7 @@ export type { ModelCapability, ModelFilter, ModelPricing, ModelResolutionContext
 export * from "./providers.js";
 export * from "./taskClassificationTypes.js";
 export * from "./tools.js";
-export type { OptionalStandardRecord, OptionalValidationSchema, StandardRecord, ValidationSchema, ZodUnknownSchema, } from "./typeAliases.js";
+export type { OptionalStandardRecord, OptionalValidationSchema, StandardRecord, ValidationSchema, ZodToJsonSchemaInput, ZodUnknownSchema, } from "./typeAliases.js";
 export type { BatchProcessingSummary, ExcelWorksheet, FailedFileInfo, FileInfo, FileProcessingError, FileProcessingResult as ProcessorFileResult, FileProcessorConfig, FileWarning, JsonTypeGuard, OperationResult, ProcessedConfig, ProcessedExcel, ProcessedFileBase, ProcessedFileInfo, ProcessedHtml, ProcessedJson, ProcessedMarkdown, ProcessedOpenDocument, ProcessedRtf, ProcessedSourceCode, ProcessedSvg, ProcessedText, ProcessedWord, ProcessedYaml, ProcessOptions, ProcessorInfo, ProcessorMatch, ProcessorPriorityKey, ProcessorPriorityValue, RegistryOptions, RegistryProcessResult, RetryConfig as ProcessorRetryConfig, SkippedFileInfo, UnsupportedFileError, } from "../processors/base/types.js";
 export { PROCESSOR_PRIORITIES } from "../processors/base/types.js";
 export type { ActionAWSConfig, ActionCommentResult, ActionEvaluation, ActionExecutionResult, ActionGoogleCloudConfig, ActionInputs, ActionInputValidation, ActionMultimodalInputs, ActionOutput, ActionProviderKeys, ActionThinkingConfig, ActionTokenUsage, CliAnalytics, CliEvaluation, CliResponse, CliTokenUsage, ProviderKeyMapping, } from "./actionTypes.js";
@@ -40,3 +40,6 @@ export * from "./ragTypes.js";
 export * from "./conversationMemoryInterface.js";
 export type { StorageConfig } from "./conversation.js";
 export * from "./subscriptionTypes.js";
+export type { ClientConfig, RequestOptions as ClientRequestOptions, RetryConfig as ClientRetryConfig, ApiResponse as ClientApiResponse, ApiError as ClientApiError, ProviderStatus as ClientProviderStatus, StreamEventType as ClientStreamEventType, StreamEvent as ClientStreamEvent, StreamCallbacks as ClientStreamCallbacks, StreamResult as ClientStreamResult, GenerateRequestOptions as ClientGenerateRequestOptions, GenerateResponse as ClientGenerateResponse, StreamRequestOptions as ClientStreamRequestOptions, AgentExecuteOptions as ClientAgentExecuteOptions, AgentExecuteResult as ClientAgentExecuteResult, AgentInfo as ClientAgentInfo, WorkflowExecuteOptions as ClientWorkflowExecuteOptions, WorkflowExecuteResult as ClientWorkflowExecuteResult, WorkflowInfo as ClientWorkflowInfo, ToolInfo as ClientToolInfo, Middleware as ClientMiddleware, MiddlewareRequest as ClientMiddlewareRequest, MiddlewareResponse as ClientMiddlewareResponse, MiddlewareContext as ClientMiddlewareContext, ChatMessage as ClientChatMessage, UseChatOptions, UseChatReturn, UseAgentOptions, UseAgentReturn, UseWorkflowOptions, UseWorkflowReturn, UseVoiceOptions, UseVoiceReturn, UseStreamOptions, UseStreamReturn, UseToolsOptions, UseToolsReturn, LanguageModel as ClientLanguageModel, LanguageModelCallOptions as ClientLanguageModelCallOptions, LanguageModelResponse as ClientLanguageModelResponse, LanguageModelStreamResponse as ClientLanguageModelStreamResponse, NeuroLinkProviderOptions, ModelOptions as ClientModelOptions, WebSocketOptions as ClientWebSocketOptions, WebSocketState as ClientWebSocketState, WebSocketMessageHandler as ClientWebSocketMessageHandler, WSClientState, WSClientConfig, WSClientMessage, WSClientEventHandlers, SpeechRecognitionResult as ClientSpeechRecognitionResult, SpeechSynthesisOptions as ClientSpeechSynthesisOptions, AuthConfig as ClientAuthConfig, OAuth2Config as ClientOAuth2Config, TokenRefreshResult as ClientTokenRefreshResult, } from "./clientTypes.js";
+export type { TokenRefresher } from "./subscriptionTypes.js";
+export * from "./proxyTypes.js";

package/dist/types/index.js

@@ -49,4 +49,9 @@ export * from "./ragTypes.js";
 // Conversation memory manager type
 export * from "./conversationMemoryInterface.js";
 // Subscription types (Claude subscription tiers, authentication, usage tracking)
+// NOTE: subscriptionTypes.ts re-exports auth types from ./authTypes.ts for
+// backward compatibility. Import StoredOAuthTokens, TokenRefresher, etc.
+// from authTypes.ts for new code.
 export * from "./subscriptionTypes.js";
+// Proxy types (Claude API format, cloaking, routing, config, stats, server adapters)
+export * from "./proxyTypes.js";

package/dist/types/middlewareTypes.d.ts

@@ -1,4 +1,4 @@
-import type { LanguageModelV1Middleware } from "ai";
+import type { LanguageModelMiddleware } from "ai";
 import type { JsonValue } from "../types/common.js";
 import type { EvaluationData } from "./evaluation.js";
 import type { GetPromptFunction } from "./evaluationTypes.js";
@@ -24,7 +24,7 @@ export type NeuroLinkMiddlewareMetadata = {
  * NeuroLink middleware with metadata
  * Combines standard AI SDK middleware with NeuroLink-specific metadata
  */
-export type NeuroLinkMiddleware = LanguageModelV1Middleware & {
+export type NeuroLinkMiddleware = LanguageModelMiddleware & {
     /** Middleware metadata */
     readonly metadata: NeuroLinkMiddlewareMetadata;
 };
@@ -192,7 +192,7 @@ export type MiddlewareRegistryEntry = {
 /**
  * Middleware factory function type
  */
-export type MiddlewareFactory = (config: Record<string, unknown>) => LanguageModelV1Middleware;
+export type MiddlewareFactory = (config: Record<string, unknown>) => LanguageModelMiddleware;
 /**
  * Middleware validation result
  */

package/dist/types/modelTypes.d.ts

@@ -73,43 +73,15 @@ export type ProviderConfiguration = {
 export declare const ModelConfigSchema: z.ZodObject<{
     id: z.ZodString;
     displayName: z.ZodString;
-    capabilities: z.ZodArray<z.ZodString, "many">;
+    capabilities: z.ZodArray<z.ZodString>;
     deprecated: z.ZodBoolean;
     pricing: z.ZodObject<{
         input: z.ZodNumber;
         output: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        input: number;
-        output: number;
-    }, {
-        input: number;
-        output: number;
-    }>;
+    }, z.core.$strip>;
     contextWindow: z.ZodNumber;
     releaseDate: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    displayName: string;
-    capabilities: string[];
-    deprecated: boolean;
-    pricing: {
-        input: number;
-        output: number;
-    };
-    contextWindow: number;
-    releaseDate: string;
-}, {
-    id: string;
-    displayName: string;
-    capabilities: string[];
-    deprecated: boolean;
-    pricing: {
-        input: number;
-        output: number;
-    };
-    contextWindow: number;
-    releaseDate: string;
-}>;
+}, z.core.$strip>;
 /**
  * Zod schema for model registry validation
  */
@@ -119,80 +91,18 @@ export declare const ModelRegistrySchema: z.ZodObject<{
     models: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         displayName: z.ZodString;
-        capabilities: z.ZodArray<z.ZodString, "many">;
+        capabilities: z.ZodArray<z.ZodString>;
         deprecated: z.ZodBoolean;
         pricing: z.ZodObject<{
             input: z.ZodNumber;
             output: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            input: number;
-            output: number;
-        }, {
-            input: number;
-            output: number;
-        }>;
+        }, z.core.$strip>;
         contextWindow: z.ZodNumber;
         releaseDate: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        displayName: string;
-        capabilities: string[];
-        deprecated: boolean;
-        pricing: {
-            input: number;
-            output: number;
-        };
-        contextWindow: number;
-        releaseDate: string;
-    }, {
-        id: string;
-        displayName: string;
-        capabilities: string[];
-        deprecated: boolean;
-        pricing: {
-            input: number;
-            output: number;
-        };
-        contextWindow: number;
-        releaseDate: string;
-    }>>>;
+    }, z.core.$strip>>>;
     aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     defaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    version: string;
-    lastUpdated: string;
-    models: Record<string, Record<string, {
-        id: string;
-        displayName: string;
-        capabilities: string[];
-        deprecated: boolean;
-        pricing: {
-            input: number;
-            output: number;
-        };
-        contextWindow: number;
-        releaseDate: string;
-    }>>;
-    aliases?: Record<string, string> | undefined;
-    defaults?: Record<string, string> | undefined;
-}, {
-    version: string;
-    lastUpdated: string;
-    models: Record<string, Record<string, {
-        id: string;
-        displayName: string;
-        capabilities: string[];
-        deprecated: boolean;
-        pricing: {
-            input: number;
-            output: number;
-        };
-        contextWindow: number;
-        releaseDate: string;
-    }>>;
-    aliases?: Record<string, string> | undefined;
-    defaults?: Record<string, string> | undefined;
-}>;
+}, z.core.$strip>;
 /**
  * Dynamic model configuration type
  */

package/dist/types/modelTypes.js

@@ -25,7 +25,7 @@ export const ModelConfigSchema = z.object({
 export const ModelRegistrySchema = z.object({
     version: z.string(),
     lastUpdated: z.string(),
-    models: z.record(z.record(ModelConfigSchema)),
-    aliases: z.record(z.string()).optional(),
-    defaults: z.record(z.string()).optional(),
+    models: z.record(z.string(), z.record(z.string(), ModelConfigSchema)),
+    aliases: z.record(z.string(), z.string()).optional(),
+    defaults: z.record(z.string(), z.string()).optional(),
 });

package/dist/types/observability.d.ts

@@ -170,3 +170,40 @@ export type ObservabilityConfig = {
     /** OpenTelemetry configuration */
     openTelemetry?: OpenTelemetryConfig;
 };
+/**
+ * Retry policy type for observability exporters.
+ */
+export type RetryPolicy = {
+    /** Policy name for identification */
+    readonly name: string;
+    /** Decide whether to retry */
+    shouldRetry(context: import("../observability/retryPolicy.js").RetryContext): import("../observability/retryPolicy.js").RetryDecision;
+    /** Maximum attempts allowed */
+    readonly maxAttempts: number;
+    /** Maximum total time allowed for retries */
+    readonly maxTotalTimeMs: number;
+};
+/**
+ * Sampler type for controlling which spans are exported.
+ */
+export type Sampler = {
+    /** Sampler name for identification */
+    readonly name: string;
+    /** Determine if a span should be sampled */
+    shouldSample(span: import("../observability/types/spanTypes.js").SpanData): boolean;
+    /** Get sampling decision description */
+    getDescription(): string;
+};
+/**
+ * Span processor type for composable span processing pipelines.
+ */
+export type SpanProcessor = {
+    /** Processor name for identification */
+    readonly name: string;
+    /** Process a span before export, returns null to drop the span */
+    process(span: import("../observability/types/spanTypes.js").SpanData): import("../observability/types/spanTypes.js").SpanData | null;
+    /** Optional async processing (for external lookups, etc.) */
+    processAsync?(span: import("../observability/types/spanTypes.js").SpanData): Promise<import("../observability/types/spanTypes.js").SpanData | null>;
+    /** Shutdown the processor (cleanup resources) */
+    shutdown?(): Promise<void>;
+};