@juspay/neurolink 10.6.1 → 10.6.3

package/dist/lib/core/baseProvider.js

@@ -27,6 +27,18 @@ import { TelemetryHandler } from "./modules/TelemetryHandler.js";
 import { ToolsManager } from "./modules/ToolsManager.js";
 import { Utilities } from "./modules/Utilities.js";
 import { generateText } from "../utils/generation.js";
+/**
+ * Read the consumer-facing lifecycle callbacks buried inside a request's
+ * middleware blob. The parameter is `unknown` on purpose: request options
+ * arrive as several structurally-unrelated shapes (StreamOptions,
+ * TextGenerationOptions), and the lifecycle branch is an optional add-on
+ * none of them declare — a single structural view keeps the read cast-free
+ * at every call site.
+ */
+function getLifecycleMiddlewareConfig(options) {
+    return options?.middleware
+        ?.middlewareConfig?.lifecycle?.config;
+}
 /**
  * Abstract base class for all AI providers
  * Tools are integrated as first-class citizens - always available by default
@@ -39,7 +51,7 @@ export class BaseProvider {
     modelName;
     providerName;
     defaultTimeout = 30000; // 30 seconds
-    middlewareOptions; // TODO: Implement global level middlewares that can be used
+    middlewareOptions; // TODO(#1179): Implement global level middlewares that can be used
     // Tools are conditionally included based on centralized configuration
     directTools = shouldDisableBuiltinTools()
         ? {}
@@ -279,8 +291,7 @@ export class BaseProvider {
      * underlying transport.
      */
     wrapStreamWithLifecycleCallbacks(result, options) {
-        const lifecycle = options
-            ?.middleware?.middlewareConfig?.lifecycle?.config;
+        const lifecycle = getLifecycleMiddlewareConfig(options);
         if (!lifecycle?.onChunk && !lifecycle?.onFinish && !lifecycle?.onError) {
             return result;
         }
@@ -376,8 +387,7 @@ export class BaseProvider {
         if (hasLifecycleErrorFired(err)) {
             return;
         }
-        const lifecycle = options
-            ?.middleware?.middlewareConfig?.lifecycle?.config;
+        const lifecycle = getLifecycleMiddlewareConfig(options);
         const onError = lifecycle?.onError;
         if (!onError) {
             return;
@@ -1295,7 +1305,7 @@ export class BaseProvider {
     /**
      * Get AI SDK model with middleware applied
      * This method wraps the base model with any configured middleware
-     * TODO: Implement global level middlewares that can be used
+     * TODO(#1179): Implement global level middlewares that can be used
      */
     async getAISDKModelWithMiddleware(options = {}) {
         // Get the base model

package/dist/lib/core/factory.d.ts

@@ -1,4 +1,5 @@
-import type { AIProvider, SupportedModelName, NeurolinkCredentials, UnknownRecord, ProviderPairResult } from "../types/index.js";
+import type { NeuroLink } from "../neurolink.js";
+import type { AIProvider, SupportedModelName, NeurolinkCredentials, ProviderPairResult } from "../types/index.js";
 import { AIProviderName } from "../constants/enums.js";
 /**
  * Factory for creating AI provider instances with centralized configuration
@@ -25,7 +26,7 @@ export declare class AIProviderFactory {
      * @param region - Optional region override for cloud providers
      * @returns AIProvider instance
      */
-    static createProvider(providerName: string, modelName?: string | null, enableMCP?: boolean, sdk?: UnknownRecord, region?: string, credentials?: NeurolinkCredentials): Promise<AIProvider>;
+    static createProvider(providerName: string, modelName?: string | null, enableMCP?: boolean, sdk?: NeuroLink, region?: string, credentials?: NeurolinkCredentials): Promise<AIProvider>;
     /**
      * Create a provider instance with specific provider enum and model
      * @param provider - Provider enum value
@@ -40,7 +41,7 @@ export declare class AIProviderFactory {
      * @param enableMCP - Optional flag to enable MCP integration (default: true)
      * @returns AIProvider instance
      */
-    static createBestProvider(requestedProvider?: string, modelName?: string | null, enableMCP?: boolean, sdk?: UnknownRecord): Promise<AIProvider>;
+    static createBestProvider(requestedProvider?: string, modelName?: string | null, enableMCP?: boolean, sdk?: NeuroLink): Promise<AIProvider>;
     /**
      * Create primary and fallback provider instances
      * @param primaryProvider - Primary provider name

package/dist/lib/core/modules/GenerationHandler.d.ts

@@ -91,5 +91,5 @@ export declare class GenerationHandler {
     /**
      * Analyze AI response structure and log detailed debugging information
      */
-    analyzeAIResponse(result: Record<string, unknown>): void;
+    analyzeAIResponse(rawResult: unknown): void;
 }

package/dist/lib/core/modules/GenerationHandler.js

@@ -693,11 +693,9 @@ export class GenerationHandler {
             }));
         }
         // Extract from steps
-        if (generateResult.steps &&
-            Array.isArray(generateResult.steps)) {
+        if (generateResult.steps && Array.isArray(generateResult.steps)) {
             const toolCallArgsMap = new Map();
-            for (const step of generateResult
-                .steps || []) {
+            for (const step of generateResult.steps || []) {
                 // Collect tool calls and their arguments
                 if (step?.toolCalls && Array.isArray(step.toolCalls)) {
                     for (const toolCall of step.toolCalls) {
@@ -947,7 +945,11 @@ export class GenerationHandler {
     /**
      * Analyze AI response structure and log detailed debugging information
      */
-    analyzeAIResponse(result) {
+    analyzeAIResponse(rawResult) {
+        if (rawResult === null || typeof rawResult !== "object") {
+            return;
+        }
+        const result = rawResult;
         logger.debug("NeuroLink Raw AI Response Analysis", {
             provider: this.providerName,
             model: this.modelName,

package/dist/lib/core/modules/TelemetryHandler.js

@@ -189,10 +189,10 @@ export class TelemetryHandler {
             return;
         }
         const sessionId = options.context?.sessionId ||
-            options.sessionId ||
+            ("sessionId" in options ? options.sessionId : undefined) ||
             `session-${nanoid()}`;
         const userId = options.context?.userId ||
-            options.userId;
+            ("userId" in options ? options.userId : undefined);
         try {
             await this.neurolink.storeToolExecutions(sessionId, userId, toolCalls, toolResults, currentTime);
         }

package/dist/lib/core/toolExecutionRecorder.d.ts

@@ -56,7 +56,7 @@ export declare class ToolExecutionRecorder {
      * enumerable on purpose: downstream stages spread options (`{...options}`)
      * and the recorder must survive into the provider loops.
      */
-    attachTo(options: Record<string, unknown>): void;
+    attachTo(options: object): void;
     /** Retrieve the recorder a request is carrying, if any. */
     static from(options: unknown): ToolExecutionRecorder | undefined;
 }

package/dist/lib/core/toolExecutionRecorder.js

@@ -147,8 +147,7 @@ export class ToolExecutionRecorder {
         const wrapped = Object.create(null);
         for (const [name, tool] of Object.entries(tools)) {
             const execute = tool.execute;
-            if (typeof execute !== "function" ||
-                execute[RECORDER_WRAPPED]) {
+            if (typeof execute !== "function" || execute[RECORDER_WRAPPED]) {
                 wrapped[name] = tool;
                 continue;
             }

package/dist/lib/evaluation/scorers/rule/contentSimilarityScorer.js

@@ -270,6 +270,8 @@ export class ContentSimilarityScorer extends BaseScorer {
         const metrics = this._similarityConfig.metrics ?? [
             this._similarityConfig.metric ?? "jaccard",
         ];
+        // Intersected with JsonObject so the rows are JSON-typed at the source
+        // and flow into result metadata without a cast.
         const details = [];
         for (const metric of metrics) {
             const score = this._calculateSimilarity(input.response, reference, metric);

package/dist/lib/evaluation/scorers/rule/formatScorer.js

@@ -396,7 +396,7 @@ export class FormatScorer extends BaseRuleScorer {
         // First check if it's valid JSON
         try {
             JSON.parse(text);
-            // TODO: Implement full JSON Schema validation
+            // TODO(#1179): Implement full JSON Schema validation
             // For now, just check it's valid JSON
             return { passed: true, score: 1.0 };
         }

package/dist/lib/factories/providerFactory.d.ts

@@ -1,5 +1,6 @@
+import type { NeuroLink } from "../neurolink.js";
 import type { AIProviderName } from "../constants/enums.js";
-import type { AIProvider, NeurolinkCredentials, ProviderConstructor, ProviderRegistration, UnknownRecord } from "../types/index.js";
+import type { AIProvider, NeurolinkCredentials, ProviderConstructor, ProviderRegistration } from "../types/index.js";
 /**
  * True Factory Pattern implementation for AI Providers
  * Uses registration-based approach to eliminate switch statements
@@ -18,7 +19,7 @@ export declare class ProviderFactory {
      * @param providerName - Provider name (optional, uses NEUROLINK_PROVIDER env var or 'vertex' as default)
      * @param modelName - Model name (optional, uses provider-specific env var or registry default)
      */
-    static createProvider(providerName?: AIProviderName | string, modelName?: string, sdk?: UnknownRecord, region?: string, credentials?: NeurolinkCredentials): Promise<AIProvider>;
+    static createProvider(providerName?: AIProviderName | string, modelName?: string, sdk?: NeuroLink, region?: string, credentials?: NeurolinkCredentials): Promise<AIProvider>;
     /**
      * Check if a provider is registered
      */
@@ -52,7 +53,7 @@ export declare class ProviderFactory {
      * Create the best available provider for the given name
      * Used by NeuroLink SDK for streaming and generation
      */
-    static createBestProvider(providerName: AIProviderName | string, modelName?: string, enableMCP?: boolean, sdk?: UnknownRecord, credentials?: NeurolinkCredentials): Promise<AIProvider>;
+    static createBestProvider(providerName: AIProviderName | string, modelName?: string, enableMCP?: boolean, sdk?: NeuroLink, credentials?: NeurolinkCredentials): Promise<AIProvider>;
 }
 /**
  * Helper function to create providers with backward compatibility

package/dist/lib/factories/providerRegistry.d.ts

@@ -28,10 +28,15 @@ export declare class ProviderRegistry {
     /**
      * Internal registration implementation
      *
-     * This method is a flat list of 13 provider registrations. Each registration
-     * is self-contained and extracting helpers would add indirection without
-     * reducing complexity — the function is long because there are many providers,
-     * not because any single registration is complex.
+     * Flat list of ProviderFactory.registerProvider() calls. Providers load via
+     * dynamic import() of ../providers/<module>.js only - never static imports
+     * (avoids circular dependencies; see CLAUDE.md).
+     *
+     * Not registered (by design): index.ts, providerTypeUtils.ts,
+     * anthropicBaseProvider.ts (legacy; anthropic.ts is live),
+     * googleNativeGemini3.ts (shared helpers). Filename != provider ID
+     * (e.g. amazonBedrock -> "bedrock"); static scanners that miss dynamic
+     * imports may false-positive (Pattern Analysis #1178).
      */
     private static _doRegister;
     /**

package/dist/lib/factories/providerRegistry.js

@@ -47,10 +47,15 @@ export class ProviderRegistry {
     /**
      * Internal registration implementation
      *
-     * This method is a flat list of 13 provider registrations. Each registration
-     * is self-contained and extracting helpers would add indirection without
-     * reducing complexity — the function is long because there are many providers,
-     * not because any single registration is complex.
+     * Flat list of ProviderFactory.registerProvider() calls. Providers load via
+     * dynamic import() of ../providers/<module>.js only - never static imports
+     * (avoids circular dependencies; see CLAUDE.md).
+     *
+     * Not registered (by design): index.ts, providerTypeUtils.ts,
+     * anthropicBaseProvider.ts (legacy; anthropic.ts is live),
+     * googleNativeGemini3.ts (shared helpers). Filename != provider ID
+     * (e.g. amazonBedrock -> "bedrock"); static scanners that miss dynamic
+     * imports may false-positive (Pattern Analysis #1178).
      */
     // eslint-disable-next-line max-lines-per-function
     static async _doRegister() {

package/dist/lib/features/ppt/slideGenerator.js

@@ -23,11 +23,12 @@ export async function loadPptxGenJS() {
     }
     try {
         const mod = await import(/* @vite-ignore */ "pptxgenjs");
-        // ESM/CJS interop: pptxgenjs v4 may double-wrap the default export
-        const Ctor = typeof mod.default === "function"
-            ? mod.default
-            : mod.default
-                .default;
+        // ESM/CJS interop: pptxgenjs v4 may double-wrap the default export.
+        // The runtime shape is genuinely dynamic, so probe it as `unknown`.
+        const rawDefault = mod.default;
+        const Ctor = typeof rawDefault === "function"
+            ? rawDefault
+            : rawDefault.default;
         _pptxGenJS = Ctor;
         return _pptxGenJS;
     }

package/dist/lib/features/ppt/utils.d.ts

@@ -5,6 +5,7 @@
  *
  * @module ppt/utils
  */
+import type { NeuroLink } from "../../neurolink.js";
 import type { PPTGenerationContext, AspectRatioOption, EffectivePPTProviderResult, ImageValidationResult, TextSegment, LogoConfig, GenerateOptions } from "../../types/index.js";
 /**
  * Extract PPT generation context from GenerateOptions
@@ -18,7 +19,7 @@ export declare const PPT_VALID_PROVIDERS: readonly string[];
 /**
  * Get an effective PPT provider - handles all orchestration logic
  */
-export declare function getEffectivePPTProvider(currentProvider: unknown, currentProviderName: string, currentModelName: string, neurolink?: unknown): Promise<EffectivePPTProviderResult>;
+export declare function getEffectivePPTProvider(currentProvider: unknown, currentProviderName: string, currentModelName: string, neurolink?: NeuroLink): Promise<EffectivePPTProviderResult>;
 /**
  * Generate output file path for PPT
  */

package/dist/lib/features/ppt/utils.js

@@ -100,6 +100,7 @@ export async function getEffectivePPTProvider(currentProvider, currentProviderNa
     const { ErrorFactory } = await import("../../utils/errorHandling.js");
     const normalizedProvider = currentProviderName.toLowerCase();
     if (PPT_VALID_PROVIDERS.includes(normalizedProvider)) {
+        // Single assertion from `unknown` — the shape is probed defensively below.
         const providerInstance = currentProvider;
         const actualModelName = currentModelName ||
             providerInstance?.modelName ||

package/dist/lib/mcp/elicitationProtocol.js

@@ -355,7 +355,7 @@ export function createSelectRequest(message, selectOptions, options) {
  */
 export function createFormRequest(message, fields, options) {
     const requestOptions = {
-        fields: fields,
+        fields,
     };
     if (options.submitLabel !== undefined) {
         requestOptions.submitLabel = options.submitLabel;

package/dist/lib/mcp/mcpRegistryClient.js

@@ -272,7 +272,7 @@ export class MCPRegistryClient extends EventEmitter {
         if (wellKnown) {
             return wellKnown;
         }
-        // TODO: Fetch from remote registry
+        // TODO(#1179): Fetch from remote registry
         return undefined;
     }
     /**

package/dist/lib/middleware/utils/guardrailsUtils.js

@@ -318,7 +318,7 @@ export function applyContentFiltering(text, badWordsConfig, context = "unknown")
             logger.debug(`[ContentFiltering:${context}] Applying regex pattern filtering with ${badWordsConfig.regexPatterns.length} patterns using replacement: "${replacementText}".`);
             for (const pattern of badWordsConfig.regexPatterns) {
                 try {
-                    // TODO: Add blocking for overly complex or long patterns
+                    // TODO(#1179): Add blocking for overly complex or long patterns
                     if (pattern.length > 1000) {
                         logger.warn(`[ContentFiltering:${context}] Regex pattern exceeds max length (1000 chars): "${pattern.substring(0, 50)}..."`);
                     }

package/dist/lib/neurolink.js

@@ -327,13 +327,23 @@ export function isNeuroLink(value) {
         value !== null &&
         value[NEUROLINK_BRAND] === true);
 }
+/**
+ * Create a Node {@link EventEmitter} exposed through the typed-emitter
+ * surface. The runtime object is a plain EventEmitter — the typed view only
+ * narrows the event-name/payload relationship for callers, so the widening
+ * hop through `unknown` is contained here once.
+ */
+function createTypedEmitter() {
+    const emitter = new EventEmitter();
+    return emitter;
+}
 export class NeuroLink {
     /** @internal Brand for cross-module identification — see {@link isNeuroLink}. */
     [NEUROLINK_BRAND] = true;
     mcpInitialized = false;
     mcpSkipped = false;
     mcpInitPromise = null;
-    emitter = new EventEmitter();
+    emitter = createTypedEmitter();
     // TaskManager — lazy-initialized on first access via `this.tasks`
     _taskManager;
     _taskManagerConfig;
@@ -1306,8 +1316,7 @@ export class NeuroLink {
             description: retrieveContextDef.description ?? "Retrieve context or artifacts",
             // Pass the Zod schema so ToolsManager gives the LLM full parameter types.
             // registerTool() detects isZodSchema on inputSchema and preserves it.
-            inputSchema: retrieveContextDef
-                .inputSchema,
+            inputSchema: retrieveContextDef.inputSchema,
             execute: async (params) => {
                 // Lazy: conversationMemory is initialized on the first generate() call.
                 // When only an artifact store is present (no Redis), memoryManager is
@@ -1362,8 +1371,7 @@ export class NeuroLink {
                 description: toolDef.description ?? toolName,
                 // Zod schema — registerTool() detects isZodSchema and preserves it
                 // so ToolsManager gives the LLM full parameter types.
-                inputSchema: toolDef
-                    .inputSchema,
+                inputSchema: toolDef.inputSchema,
                 execute: async (params) => withTimeout(toolDef.execute(params, { toolCallId: "skill-tool", messages: [] }), TOOL_TIMEOUTS.EXECUTION_DEFAULT_MS, ErrorFactory.toolTimeout(toolName, TOOL_TIMEOUTS.EXECUTION_DEFAULT_MS)),
             });
         }
@@ -8915,7 +8923,7 @@ Current user's request: ${currentInput}`;
     // ========================================
     // ENHANCED: Tool Event Emission API
     // ========================================
-    // TODO: Add ToolExecutionEvent utility methods in future version
+    // TODO(#1179): Add ToolExecutionEvent utility methods in future version
     // Will provide structured event format for consistent tool event processing
     /**
      * Emit tool start event with execution tracking
@@ -9038,7 +9046,7 @@ Current user's request: ${currentInput}`;
     clearCurrentStreamExecutions() {
         this.currentStreamToolExecutions = [];
     }
-    // TODO: Add getToolExecutionEvents() method in future version
+    // TODO(#1179): Add getToolExecutionEvents() method in future version
     // Will return properly formatted ToolExecutionEvent objects for structured event processing
     // ========================================
     // Tool Registration API

package/dist/lib/processors/document/ExcelProcessor.js

@@ -271,7 +271,11 @@ export class ExcelProcessor extends BaseFileProcessor {
      */
     async parseWorkbook(buffer) {
         const ExcelJS = await loadExcelJS();
-        const workbook = new ExcelJS.Workbook();
+        // The exceljs constructor comes from a normalised CJS/ESM interop
+        // namespace (see loadExcelJS); probe the instance as `unknown` and
+        // narrow to the structural subset this processor uses.
+        const workbookInstance = new ExcelJS.Workbook();
+        const workbook = workbookInstance;
         // ExcelJS load() types expect Buffer but Node 22+ Buffer<ArrayBufferLike>
         // is not directly assignable. Extract a clean ArrayBuffer for the exact
         // byte range via slice, then cast for type compatibility.

package/dist/lib/providers/amazonBedrock.js

@@ -155,7 +155,8 @@ export class AmazonBedrockProvider extends BaseProvider {
         // Clear conversation history for new generation
         this.conversationHistory = [];
         // Check for multimodal input (images, PDFs, CSVs, files)
-        // Cast to any to access multimodal properties (runtime check is safe)
+        // Narrow to the StreamOptions input shape to access multimodal
+        // properties (runtime check is safe)
         const input = options.input;
         const hasMultimodalInput = !!(input?.images?.length ||
             input?.content?.length ||
@@ -917,10 +918,8 @@ export class AmazonBedrockProvider extends BaseProvider {
                 logger.debug("[TRACE] executeStream CATCH - error caught from streamingConversationLoop");
                 const errorObj = error;
                 // Check if error is related to streaming permissions
-                const isPermissionError = errorObj?.name ===
-                    "AccessDeniedException" ||
-                    errorObj?.name ===
-                        "UnauthorizedOperation" ||
+                const isPermissionError = errorObj?.name === "AccessDeniedException" ||
+                    errorObj?.name === "UnauthorizedOperation" ||
                     errorObj?.message?.includes("bedrock:InvokeModelWithResponseStream") ||
                     errorObj?.message?.includes("streaming") ||
                     errorObj?.message?.includes("ConverseStream");

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

@@ -54,6 +54,24 @@ export declare class AmazonSageMakerProvider extends BaseProvider {
      * Get model capabilities and information
      */
     getModelCapabilities(): {
+        capabilities: {
+            streaming: boolean;
+            toolCalling: boolean;
+            structuredOutput: boolean;
+            batchInference: boolean;
+            supportedResponseFormats: string[];
+            supportedToolTypes: string[];
+            maxBatchSize: number;
+            adaptiveConcurrency: boolean;
+            errorRecovery: boolean;
+        };
+        modelId: string;
+        provider: string;
+        specificationVersion: "v2";
+        endpointName: string;
+        modelType: "huggingface" | "mistral" | "custom" | "claude" | "llama" | "jumpstart" | undefined;
+        region: string;
+    } | {
         capabilities: {
             streaming: boolean;
             toolCalling: boolean;

package/dist/lib/providers/amazonSagemaker.js

@@ -10,6 +10,9 @@ import { SageMakerLanguageModel } from "./sagemaker/language-model.js";
  * Amazon SageMaker Provider extending BaseProvider
  */
 export class AmazonSageMakerProvider extends BaseProvider {
+    // Kept as the concrete class so SageMaker-specific members
+    // (testConnectivity, getModelCapabilities) stay typed; getAISDKModel()
+    // narrows to the AI SDK handle shape at its boundary.
     sagemakerModel;
     sagemakerConfig;
     modelConfig;
@@ -41,8 +44,7 @@ export class AmazonSageMakerProvider extends BaseProvider {
             // SageMakerLanguageModel implements SageMakerAsLanguageModel which is
             // structurally compatible with LanguageModelV2 (specificationVersion "v2",
             // modelId, provider, supportedUrls, doGenerate, doStream).
-            const smModel = new SageMakerLanguageModel(this.modelName, this.sagemakerConfig, this.modelConfig);
-            this.sagemakerModel = smModel;
+            this.sagemakerModel = new SageMakerLanguageModel(this.modelName, this.sagemakerConfig, this.modelConfig);
             logger.debug("Amazon SageMaker Provider initialized", {
                 modelName: this.modelName,
                 endpointName: this.modelConfig.endpointName,
@@ -66,7 +68,11 @@ export class AmazonSageMakerProvider extends BaseProvider {
         return getSageMakerModel();
     }
     getAISDKModel() {
-        return this.sagemakerModel;
+        // Same sanctioned two-step as construction previously used: the class
+        // satisfies the structural SageMakerAsLanguageModel shape, which is
+        // single-assertable to the AI SDK LanguageModel handle.
+        const smModel = this.sagemakerModel;
+        return smModel;
     }
     async executeStream(_options, _analysisSchema) {
         return withSpan({

package/dist/lib/providers/anthropic.js

@@ -1072,7 +1072,11 @@ export class AnthropicProvider extends BaseProvider {
         const modelId = this.modelName || getDefaultAnthropicModel();
         const getTimeoutForOptions = (opts) => this.getTimeout((opts ?? {}));
         const refreshAuth = () => this.refreshAuthIfNeeded();
-        return {
+        // Structural AI-SDK model shape (`SageMakerAsLanguageModel`, the
+        // sanctioned intermediate from src/lib/types/providers.ts): assigning the
+        // literal to it keeps the compiler's member checks, and the intermediate
+        // is single-assertable to the ai-package `LanguageModel` handle.
+        const delegatingModel = {
             specificationVersion: "v3",
             provider: providerName,
             modelId,
@@ -1259,6 +1263,7 @@ export class AnthropicProvider extends BaseProvider {
                 throw new Error(`${providerName}: doStream is not implemented on the delegating model — the streaming path uses executeStream directly.`);
             },
         };
+        return delegatingModel;
     }
     formatProviderError(error) {
         if (error instanceof TimeoutError) {

package/dist/lib/providers/googleAiStudio.js

@@ -1282,10 +1282,9 @@ export class GoogleAIStudioProvider extends BaseProvider {
                         if (queue.length > 0) {
                             const item = queue.shift();
                             if (!item) {
-                                return {
-                                    value: undefined,
-                                    done: true,
-                                };
+                                // `done: true` selects the IteratorReturnResult arm, whose
+                                // value type accepts undefined.
+                                return { value: undefined, done: true };
                             }
                             if (item.type === "audio") {
                                 return {
@@ -1295,10 +1294,7 @@ export class GoogleAIStudioProvider extends BaseProvider {
                             }
                             if (item.type === "end") {
                                 done = true;
-                                return {
-                                    value: undefined,
-                                    done: true,
-                                };
+                                return { value: undefined, done: true };
                             }
                             if (item.type === "error") {
                                 done = true;
@@ -1308,10 +1304,7 @@ export class GoogleAIStudioProvider extends BaseProvider {
                             }
                         }
                         if (done) {
-                            return {
-                                value: undefined,
-                                done: true,
-                            };
+                            return { value: undefined, done: true };
                         }
                         return await new Promise((resolve) => {
                             resolveNext = resolve;

package/dist/lib/providers/googleVertex.js

@@ -1443,6 +1443,9 @@ export class GoogleVertexProvider extends BaseProvider {
         const maxSteps = Number.isFinite(rawMaxSteps) && rawMaxSteps > 0
             ? Math.min(Math.floor(rawMaxSteps), 100) // Cap at 100 for safety
             : Math.min(DEFAULT_MAX_STEPS, 100);
+        // Widened per-turn copy: the agentic loop appends functionCall /
+        // functionResponse parts on top of the plain text/inlineData parts the
+        // initial contents carry.
         const currentContents = [...contents];
         let finalText = "";
         // Last SDK finish reason seen across steps (Bug 2: previously never read,
@@ -1671,7 +1674,8 @@ export class GoogleVertexProvider extends BaseProvider {
                                 functionCall: fc,
                             })),
                     });
-                    // Execute each function and collect responses
+                    // Execute each function and collect responses (plus an optional
+                    // trailing wrap-up nudge text part).
                     const functionResponses = [];
                     // Per-step bookkeeping for conversation-memory storage.
                     const stepStorageCalls = [];
@@ -2080,6 +2084,10 @@ export class GoogleVertexProvider extends BaseProvider {
             // (assistant text empty but tools ran) and downstream consumers see
             // the same shape AI-SDK-driven providers expose.
             toolsUsed: externalToolCalls.map((tc) => tc.toolName),
+            // transformToolExecutions' record shape (name/input/output/duration) is
+            // what downstream consumers read at runtime; it shares no required
+            // members with the declared ToolExecutionSummary element type, so the
+            // assertion carries both shapes instead of erasing the real one.
             toolExecutions: transformToolExecutions(externalToolExecutions),
             metadata: {
                 streamId: `native-vertex-${Date.now()}`,
@@ -2378,6 +2386,9 @@ export class GoogleVertexProvider extends BaseProvider {
         const maxSteps = Number.isFinite(rawMaxSteps) && rawMaxSteps > 0
             ? Math.min(Math.floor(rawMaxSteps), 100) // Cap at 100 for safety
             : Math.min(DEFAULT_MAX_STEPS, 100);
+        // Widened per-turn copy: the agentic loop appends functionCall /
+        // functionResponse parts on top of the plain text/inlineData parts the
+        // initial contents carry.
         const currentContents = [...contents];
         let finalText = "";
         // Cross-step text accumulation + last SDK finish reason, so the
@@ -2595,7 +2606,8 @@ export class GoogleVertexProvider extends BaseProvider {
                                 functionCall: fc,
                             })),
                     });
-                    // Execute each function and collect responses
+                    // Execute each function and collect responses (plus an optional
+                    // trailing wrap-up nudge text part).
                     const functionResponses = [];
                     const toolCallsBefore = allToolCalls.length;
                     const toolExecsBefore = toolExecutions.length;
@@ -3094,9 +3106,18 @@ export class GoogleVertexProvider extends BaseProvider {
         // `prepareOptions()` is a separate continuation and still surfaces auth
         // errors to callers. `void` flags the returned promise as deliberately
         // ignored (codebase convention for fire-and-forget).
-        void client._authClientPromise?.catch(() => {
-            // Intentionally ignored — see above.
-        });
+        //
+        // `_authClientPromise` is a private SDK internal, so it is reached via
+        // runtime narrowing (`in` + `instanceof`) rather than a type assertion.
+        const clientInternals = client;
+        if ("_authClientPromise" in clientInternals) {
+            const authClientPromise = clientInternals._authClientPromise;
+            if (authClientPromise instanceof Promise) {
+                void authClientPromise.catch(() => {
+                    // Intentionally ignored — see above.
+                });
+            }
+        }
         return client;
     }
     /**

package/dist/lib/providers/openaiChatCompletionsBase.js

@@ -291,6 +291,8 @@ export class OpenAIChatCompletionsProvider extends BaseProvider {
      */
     async getAISDKModel() {
         const modelId = await this.resolveModelName();
+        // buildDelegatingModel returns `unknown`, so this is a single
+        // unknown-to-target assertion.
         return this.buildDelegatingModel(modelId);
     }
     async resolveModelName() {

package/dist/lib/providers/sagemaker/errors.js

@@ -192,7 +192,8 @@ export function handleSageMakerError(error, endpoint) {
 /**
  * Extract request ID from AWS SDK error for debugging
  *
- * @param error - Error object that might contain request ID
+ * @param error - Error object that might contain request ID (AWS SDK errors
+ *   carry it as an untyped extra field, so the value is treated as opaque)
  * @returns Request ID if found, undefined otherwise
  */
 function extractRequestId(error) {