@juspay/neurolink 9.5.3 → 9.6.0

package/dist/utils/modelChoices.d.ts

@@ -6,11 +6,11 @@ import { AIProviderName } from "../constants/enums.js";
 /**
  * Model choice for CLI prompts (inquirer format)
  */
-export interface ModelChoice {
+export type ModelChoice = {
     name: string;
     value: string;
     description?: string;
-}
+};
 /**
  * Default models per provider (first choice/recommended)
  */

package/dist/utils/multimodalOptionsBuilder.d.ts

@@ -46,7 +46,7 @@ export declare function buildMultimodalOptions(options: StreamOptions, providerN
         text: string;
         images: (string | Buffer<ArrayBufferLike> | import("../index.js").ImageWithAltText)[] | undefined;
         content: import("../index.js").Content[] | undefined;
-        files: (string | Buffer<ArrayBufferLike>)[] | undefined;
+        files: (string | Buffer<ArrayBufferLike> | import("../index.js").FileWithMetadata)[] | undefined;
         csvFiles: (string | Buffer<ArrayBufferLike>)[] | undefined;
         pdfFiles: (string | Buffer<ArrayBufferLike>)[] | undefined;
     };
@@ -64,4 +64,5 @@ export declare function buildMultimodalOptions(options: StreamOptions, providerN
     enableAnalytics: boolean | undefined;
     enableEvaluation: boolean | undefined;
     context: import("../index.js").UnknownRecord | undefined;
+    fileRegistry: unknown;
 };

package/dist/utils/multimodalOptionsBuilder.js

@@ -60,5 +60,6 @@ export function buildMultimodalOptions(options, providerName, modelName) {
         enableAnalytics: options.enableAnalytics,
         enableEvaluation: options.enableEvaluation,
         context: options.context,
+        fileRegistry: options.fileRegistry,
     };
 }

package/dist/utils/rateLimiter.d.ts

@@ -9,7 +9,7 @@
 /**
  * Configuration options for the rate limiter
  */
-export interface RateLimiterConfig {
+export type RateLimiterConfig = {
     /** Maximum tokens (downloads) allowed per interval */
     maxTokens: number;
     /** Refill interval in milliseconds */
@@ -20,7 +20,7 @@ export interface RateLimiterConfig {
     maxQueueSize: number;
     /** Timeout for queued requests in milliseconds */
     queueTimeoutMs: number;
-}
+};
 /**
  * Token Bucket Rate Limiter
  *

package/dist/utils/sanitizers/filename.d.ts

@@ -12,7 +12,7 @@
 /**
  * Options for filename sanitization.
  */
-export interface SanitizeFileNameOptions {
+export type SanitizeFileNameOptions = {
     /** Maximum length for the filename (default: 255) */
     maxLength?: number;
     /** Replacement character for invalid chars (default: '_') */
@@ -21,16 +21,16 @@ export interface SanitizeFileNameOptions {
     blockDangerousExtensions?: boolean;
     /** Whether to allow hidden files starting with dot (default: false) */
     allowHiddenFiles?: boolean;
-}
+};
 /**
  * Options for display name sanitization.
  */
-export interface SanitizeDisplayNameOptions {
+export type SanitizeDisplayNameOptions = {
     /** Maximum length for the name (default: 100) */
     maxLength?: number;
     /** Whether to allow unicode characters (default: true) */
     allowUnicode?: boolean;
-}
+};
 /**
  * Sanitize a filename for safe filesystem storage.
  * Removes characters that are invalid on various operating systems.

package/dist/utils/sanitizers/svg.d.ts

@@ -19,14 +19,14 @@
 /**
  * Result of SVG sanitization including metadata about removed content
  */
-export interface SvgSanitizationResult {
+export type SvgSanitizationResult = {
     /** Sanitized SVG content */
     content: string;
     /** Items that were removed during sanitization */
     removedItems: string[];
     /** Whether any content was modified */
     wasModified: boolean;
-}
+};
 /**
  * Sanitize SVG content by removing dangerous elements and attributes.
  * Uses OWASP-compliant allowlist approach with regex-based parsing.

package/dist/utils/thinkingConfig.d.ts

@@ -11,32 +11,32 @@ export type ThinkingLevel = "minimal" | "low" | "medium" | "high";
 /**
  * ThinkingConfig interface matching the SDK's expected structure
  */
-export interface ThinkingConfig {
+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 interface CreateThinkingConfigOptions {
+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 interface NativeThinkingConfig {
+export type NativeThinkingConfig = {
     includeThoughts: boolean;
     thinkingLevel: ThinkingLevel;
-}
+};
 /**
  * Default token budget for thinking operations
  */

package/dist/utils/tokenEstimation.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Token Estimation Utilities
+ *
+ * Provides character-based token estimation with per-provider adjustment
+ * multipliers. Uses the same approach as Continue (gpt-tokenizer baseline
+ * + provider multipliers) but without requiring a tokenizer dependency.
+ *
+ * Multiplier sources: Continue project's getAdjustedTokenCount.ts
+ * - Anthropic: 1.23x (Anthropic tokenizer produces ~23% more tokens)
+ * - Google (AI Studio / Vertex): 1.18x
+ * - Mistral/Codestral: 1.26x
+ * - OpenAI/GPT: 1.0x (baseline)
+ */
+import type { ChatMessage } from "../types/conversation.js";
+/** Characters per token for English text */
+export declare const CHARS_PER_TOKEN = 4;
+/** Characters per token for code */
+export declare const CODE_CHARS_PER_TOKEN = 3;
+/** Safety margin to avoid underestimation */
+export declare const TOKEN_SAFETY_MARGIN = 1.15;
+/** Message framing overhead in tokens (role + delimiters) */
+export declare const TOKENS_PER_MESSAGE = 4;
+/** Conversation-level overhead in tokens */
+export declare const TOKENS_PER_CONVERSATION = 24;
+/** Image token estimate (flat) */
+export declare const IMAGE_TOKEN_ESTIMATE = 1024;
+/**
+ * Get the token multiplier for a given provider.
+ */
+export declare function getProviderMultiplier(provider?: string): number;
+/**
+ * Estimate token count for a string.
+ *
+ * @param text - Input text
+ * @param provider - Optional provider for multiplier adjustment
+ * @param isCode - Whether the text is code (uses CODE_CHARS_PER_TOKEN)
+ * @returns Estimated token count
+ */
+export declare function estimateTokens(text: string, provider?: string, isCode?: boolean): number;
+/**
+ * Estimate token count for a single ChatMessage.
+ * Includes message framing overhead.
+ */
+export declare function estimateMessageTokens(message: ChatMessage | {
+    role: string;
+    content: string;
+}, provider?: string): number;
+/**
+ * Estimate total token count for an array of messages.
+ * Includes conversation-level overhead.
+ */
+export declare function estimateMessagesTokens(messages: Array<ChatMessage | {
+    role: string;
+    content: string;
+}>, provider?: string): number;
+/**
+ * Truncate text to fit within a token budget.
+ * Tries to cut at sentence or word boundaries.
+ *
+ * @param text - Input text
+ * @param maxTokens - Maximum tokens allowed
+ * @param provider - Optional provider for multiplier
+ * @returns Truncated text with "..." suffix if truncated
+ */
+export declare function truncateToTokenBudget(text: string, maxTokens: number, provider?: string): {
+    text: string;
+    truncated: boolean;
+};

package/dist/utils/tokenEstimation.js

@@ -0,0 +1,112 @@
+/**
+ * Token Estimation Utilities
+ *
+ * Provides character-based token estimation with per-provider adjustment
+ * multipliers. Uses the same approach as Continue (gpt-tokenizer baseline
+ * + provider multipliers) but without requiring a tokenizer dependency.
+ *
+ * Multiplier sources: Continue project's getAdjustedTokenCount.ts
+ * - Anthropic: 1.23x (Anthropic tokenizer produces ~23% more tokens)
+ * - Google (AI Studio / Vertex): 1.18x
+ * - Mistral/Codestral: 1.26x
+ * - OpenAI/GPT: 1.0x (baseline)
+ */
+/** Characters per token for English text */
+export const CHARS_PER_TOKEN = 4;
+/** Characters per token for code */
+export const CODE_CHARS_PER_TOKEN = 3;
+/** Safety margin to avoid underestimation */
+export const TOKEN_SAFETY_MARGIN = 1.15;
+/** Message framing overhead in tokens (role + delimiters) */
+export const TOKENS_PER_MESSAGE = 4;
+/** Conversation-level overhead in tokens */
+export const TOKENS_PER_CONVERSATION = 24;
+/** Image token estimate (flat) */
+export const IMAGE_TOKEN_ESTIMATE = 1_024;
+/**
+ * Per-provider token multipliers.
+ * Applied on top of the base GPT-style character estimate.
+ */
+const PROVIDER_MULTIPLIERS = {
+    anthropic: 1.23,
+    "google-ai": 1.18,
+    vertex: 1.18,
+    mistral: 1.26,
+    openai: 1.0,
+    azure: 1.0,
+    bedrock: 1.23, // Bedrock is mostly Anthropic models
+    ollama: 1.0,
+    litellm: 1.0,
+    huggingface: 1.0,
+    sagemaker: 1.0,
+};
+/**
+ * Get the token multiplier for a given provider.
+ */
+export function getProviderMultiplier(provider) {
+    if (!provider) {
+        return 1.0;
+    }
+    return PROVIDER_MULTIPLIERS[provider] ?? 1.0;
+}
+/**
+ * Estimate token count for a string.
+ *
+ * @param text - Input text
+ * @param provider - Optional provider for multiplier adjustment
+ * @param isCode - Whether the text is code (uses CODE_CHARS_PER_TOKEN)
+ * @returns Estimated token count
+ */
+export function estimateTokens(text, provider, isCode) {
+    if (!text || text.length === 0) {
+        return 0;
+    }
+    const charsPerToken = isCode ? CODE_CHARS_PER_TOKEN : CHARS_PER_TOKEN;
+    const baseTokens = Math.ceil(text.length / charsPerToken);
+    const multiplier = getProviderMultiplier(provider);
+    return Math.ceil(baseTokens * multiplier * TOKEN_SAFETY_MARGIN);
+}
+/**
+ * Estimate token count for a single ChatMessage.
+ * Includes message framing overhead.
+ */
+export function estimateMessageTokens(message, provider) {
+    const contentTokens = estimateTokens(message.content || "", provider);
+    return contentTokens + TOKENS_PER_MESSAGE;
+}
+/**
+ * Estimate total token count for an array of messages.
+ * Includes conversation-level overhead.
+ */
+export function estimateMessagesTokens(messages, provider) {
+    if (!messages || messages.length === 0) {
+        return 0;
+    }
+    const messageTokens = messages.reduce((sum, msg) => sum + estimateMessageTokens(msg, provider), 0);
+    return messageTokens + TOKENS_PER_CONVERSATION;
+}
+/**
+ * Truncate text to fit within a token budget.
+ * Tries to cut at sentence or word boundaries.
+ *
+ * @param text - Input text
+ * @param maxTokens - Maximum tokens allowed
+ * @param provider - Optional provider for multiplier
+ * @returns Truncated text with "..." suffix if truncated
+ */
+export function truncateToTokenBudget(text, maxTokens, provider) {
+    if (estimateTokens(text, provider) <= maxTokens) {
+        return { text, truncated: false };
+    }
+    const multiplier = getProviderMultiplier(provider);
+    const safetyFactor = multiplier * TOKEN_SAFETY_MARGIN;
+    const maxChars = Math.floor((maxTokens / safetyFactor) * CHARS_PER_TOKEN);
+    if (maxChars <= 0) {
+        return { text: "", truncated: true };
+    }
+    // Try to cut at sentence boundary
+    const candidate = text.slice(0, maxChars);
+    const lastSentence = Math.max(candidate.lastIndexOf(". "), candidate.lastIndexOf("! "), candidate.lastIndexOf("? "), candidate.lastIndexOf("\n"));
+    const cutPoint = lastSentence > maxChars * 0.5 ? lastSentence + 1 : maxChars;
+    return { text: text.slice(0, cutPoint) + "...", truncated: true };
+}

package/dist/utils/tokenUtils.d.ts

@@ -12,7 +12,7 @@ import type { TokenUsage } from "../types/analytics.js";
  * Raw usage object that may come from various AI providers
  * Supports multiple naming conventions and nested structures
  */
-export interface RawUsageObject {
+export type RawUsageObject = {
     input?: number;
     output?: number;
     total?: number;
@@ -30,11 +30,11 @@ export interface RawUsageObject {
     reasoning_tokens?: number;
     thinkingTokens?: number;
     usage?: RawUsageObject;
-}
+};
 /**
  * Options for token extraction behavior
  */
-export interface TokenExtractionOptions {
+export type TokenExtractionOptions = {
     /**
      * Whether to calculate cache savings percentage
      * @default true
@@ -46,7 +46,7 @@ export interface TokenExtractionOptions {
      * - "undefined": Return undefined for missing optional fields (default)
      */
     missingOptionalBehavior?: "zero" | "undefined";
-}
+};
 /**
  * Extract input token count from various provider formats
  * Priority: input > inputTokens > promptTokens

package/dist/utils/ttsProcessor.d.ts

@@ -67,7 +67,7 @@ export declare class TTSError extends NeuroLinkError {
  * }
  * ```
  */
-export interface TTSHandler {
+export type TTSHandler = {
     /**
      * Generate audio from text using provider-specific TTS API
      *
@@ -101,7 +101,7 @@ export interface TTSHandler {
      * @default 3000 if not specified
      */
     maxTextLength?: number;
-}
+};
 /**
  * TTS processor class for orchestrating text-to-speech operations
  *