@juspay/neurolink 9.26.1 → 9.27.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [9.27.0](https://github.com/juspay/neurolink/compare/v9.26.2...v9.27.0) (2026-03-18)
+
+### Features
+
+- **(memory):** add CustomStorageConfig type to Hippocampus integration ([dfcea2b](https://github.com/juspay/neurolink/commit/dfcea2b04834a86812f13c5d85ad3d7b9ab530a7))
+
+## [9.26.2](https://github.com/juspay/neurolink/compare/v9.26.1...v9.26.2) (2026-03-18)
+
+### Bug Fixes
+
+- **(providers):** fix Gemini 3.1 native SDK tool calling, streaming, and multimodal on Vertex global endpoint ([b95089a](https://github.com/juspay/neurolink/commit/b95089a5bc900b38678b919a6ae2567c9500ca8b))
+
 ## [9.26.1](https://github.com/juspay/neurolink/compare/v9.26.0...v9.26.1) (2026-03-16)
 
 ### Bug Fixes

package/dist/adapters/providerImageAdapter.js

@@ -90,6 +90,9 @@ const VISION_CAPABILITIES = {
         "gpt-4-vision-preview",
     ],
     "google-ai": [
+        // Gemini 3.1 Series (Preview)
+        "gemini-3.1-pro-preview",
+        "gemini-3.1-flash-lite-preview",
         // Gemini 3 Series (Preview - November 2025)
         "gemini-3-pro-preview",
         "gemini-3-pro-preview-11-2025",
@@ -168,6 +171,9 @@ const VISION_CAPABILITIES = {
         "gpt-4",
     ],
     vertex: [
+        // Gemini 3.1 models on Vertex AI (Preview)
+        "gemini-3.1-pro-preview",
+        "gemini-3.1-flash-lite-preview",
         // Gemini 3.x models on Vertex AI (Preview)
         "gemini-3-pro-preview-11-2025",
         "gemini-3-pro-latest",

package/dist/constants/contextWindows.js

@@ -92,6 +92,7 @@ export const MODEL_CONTEXT_WINDOWS = {
         "gemini-3.1-pro-preview": 1_048_576,
         "gemini-3.1-flash": 1_048_576,
         "gemini-3.1-flash-lite": 1_048_576,
+        "gemini-3.1-flash-lite-preview": 1_048_576,
         "gemini-3-pro-preview": 1_048_576,
         "gemini-3-pro-image-preview": 65_536,
         "gemini-3-flash-preview": 1_048_576,
@@ -121,6 +122,7 @@ export const MODEL_CONTEXT_WINDOWS = {
         "gemini-3.1-pro-preview": 1_048_576,
         "gemini-3.1-flash": 1_048_576,
         "gemini-3.1-flash-lite": 1_048_576,
+        "gemini-3.1-flash-lite-preview": 1_048_576,
         "gemini-3-pro-preview": 1_048_576,
         "gemini-3-pro-latest": 1_048_576,
         "gemini-3-flash-preview": 1_048_576,

package/dist/constants/enums.d.ts

@@ -238,6 +238,7 @@ export declare enum VertexModels {
     GEMINI_3_1_PRO_PREVIEW = "gemini-3.1-pro-preview",
     GEMINI_3_1_FLASH = "gemini-3.1-flash",
     GEMINI_3_1_FLASH_LITE = "gemini-3.1-flash-lite",
+    GEMINI_3_1_FLASH_LITE_PREVIEW = "gemini-3.1-flash-lite-preview",
     GEMINI_3_PRO = "gemini-3-pro",
     GEMINI_3_PRO_PREVIEW_11_2025 = "gemini-3-pro-preview-11-2025",
     GEMINI_3_PRO_LATEST = "gemini-3-pro-latest",
@@ -265,6 +266,7 @@ export declare enum GoogleAIModels {
     GEMINI_3_1_PRO_PREVIEW = "gemini-3.1-pro-preview",
     GEMINI_3_1_FLASH = "gemini-3.1-flash",
     GEMINI_3_1_FLASH_LITE = "gemini-3.1-flash-lite",
+    GEMINI_3_1_FLASH_LITE_PREVIEW = "gemini-3.1-flash-lite-preview",
     GEMINI_3_PRO_PREVIEW = "gemini-3-pro-preview",
     GEMINI_3_PRO_IMAGE_PREVIEW = "gemini-3-pro-image-preview",
     GEMINI_3_FLASH = "gemini-3-flash",

package/dist/constants/enums.js

@@ -336,6 +336,7 @@ export var VertexModels;
     VertexModels["GEMINI_3_1_PRO_PREVIEW"] = "gemini-3.1-pro-preview";
     VertexModels["GEMINI_3_1_FLASH"] = "gemini-3.1-flash";
     VertexModels["GEMINI_3_1_FLASH_LITE"] = "gemini-3.1-flash-lite";
+    VertexModels["GEMINI_3_1_FLASH_LITE_PREVIEW"] = "gemini-3.1-flash-lite-preview";
     // Gemini 3 Series (Preview)
     VertexModels["GEMINI_3_PRO"] = "gemini-3-pro";
     VertexModels["GEMINI_3_PRO_PREVIEW_11_2025"] = "gemini-3-pro-preview-11-2025";
@@ -369,6 +370,7 @@ export var GoogleAIModels;
     GoogleAIModels["GEMINI_3_1_PRO_PREVIEW"] = "gemini-3.1-pro-preview";
     GoogleAIModels["GEMINI_3_1_FLASH"] = "gemini-3.1-flash";
     GoogleAIModels["GEMINI_3_1_FLASH_LITE"] = "gemini-3.1-flash-lite";
+    GoogleAIModels["GEMINI_3_1_FLASH_LITE_PREVIEW"] = "gemini-3.1-flash-lite-preview";
     // Gemini 3 Series (Preview)
     GoogleAIModels["GEMINI_3_PRO_PREVIEW"] = "gemini-3-pro-preview";
     GoogleAIModels["GEMINI_3_PRO_IMAGE_PREVIEW"] = "gemini-3-pro-image-preview";

package/dist/lib/adapters/providerImageAdapter.js

@@ -90,6 +90,9 @@ const VISION_CAPABILITIES = {
         "gpt-4-vision-preview",
     ],
     "google-ai": [
+        // Gemini 3.1 Series (Preview)
+        "gemini-3.1-pro-preview",
+        "gemini-3.1-flash-lite-preview",
         // Gemini 3 Series (Preview - November 2025)
         "gemini-3-pro-preview",
         "gemini-3-pro-preview-11-2025",
@@ -168,6 +171,9 @@ const VISION_CAPABILITIES = {
         "gpt-4",
     ],
     vertex: [
+        // Gemini 3.1 models on Vertex AI (Preview)
+        "gemini-3.1-pro-preview",
+        "gemini-3.1-flash-lite-preview",
         // Gemini 3.x models on Vertex AI (Preview)
         "gemini-3-pro-preview-11-2025",
         "gemini-3-pro-latest",

package/dist/lib/constants/contextWindows.js

@@ -92,6 +92,7 @@ export const MODEL_CONTEXT_WINDOWS = {
         "gemini-3.1-pro-preview": 1_048_576,
         "gemini-3.1-flash": 1_048_576,
         "gemini-3.1-flash-lite": 1_048_576,
+        "gemini-3.1-flash-lite-preview": 1_048_576,
         "gemini-3-pro-preview": 1_048_576,
         "gemini-3-pro-image-preview": 65_536,
         "gemini-3-flash-preview": 1_048_576,
@@ -121,6 +122,7 @@ export const MODEL_CONTEXT_WINDOWS = {
         "gemini-3.1-pro-preview": 1_048_576,
         "gemini-3.1-flash": 1_048_576,
         "gemini-3.1-flash-lite": 1_048_576,
+        "gemini-3.1-flash-lite-preview": 1_048_576,
         "gemini-3-pro-preview": 1_048_576,
         "gemini-3-pro-latest": 1_048_576,
         "gemini-3-flash-preview": 1_048_576,

package/dist/lib/constants/enums.d.ts

@@ -238,6 +238,7 @@ export declare enum VertexModels {
     GEMINI_3_1_PRO_PREVIEW = "gemini-3.1-pro-preview",
     GEMINI_3_1_FLASH = "gemini-3.1-flash",
     GEMINI_3_1_FLASH_LITE = "gemini-3.1-flash-lite",
+    GEMINI_3_1_FLASH_LITE_PREVIEW = "gemini-3.1-flash-lite-preview",
     GEMINI_3_PRO = "gemini-3-pro",
     GEMINI_3_PRO_PREVIEW_11_2025 = "gemini-3-pro-preview-11-2025",
     GEMINI_3_PRO_LATEST = "gemini-3-pro-latest",
@@ -265,6 +266,7 @@ export declare enum GoogleAIModels {
     GEMINI_3_1_PRO_PREVIEW = "gemini-3.1-pro-preview",
     GEMINI_3_1_FLASH = "gemini-3.1-flash",
     GEMINI_3_1_FLASH_LITE = "gemini-3.1-flash-lite",
+    GEMINI_3_1_FLASH_LITE_PREVIEW = "gemini-3.1-flash-lite-preview",
     GEMINI_3_PRO_PREVIEW = "gemini-3-pro-preview",
     GEMINI_3_PRO_IMAGE_PREVIEW = "gemini-3-pro-image-preview",
     GEMINI_3_FLASH = "gemini-3-flash",

package/dist/lib/constants/enums.js

@@ -336,6 +336,7 @@ export var VertexModels;
     VertexModels["GEMINI_3_1_PRO_PREVIEW"] = "gemini-3.1-pro-preview";
     VertexModels["GEMINI_3_1_FLASH"] = "gemini-3.1-flash";
     VertexModels["GEMINI_3_1_FLASH_LITE"] = "gemini-3.1-flash-lite";
+    VertexModels["GEMINI_3_1_FLASH_LITE_PREVIEW"] = "gemini-3.1-flash-lite-preview";
     // Gemini 3 Series (Preview)
     VertexModels["GEMINI_3_PRO"] = "gemini-3-pro";
     VertexModels["GEMINI_3_PRO_PREVIEW_11_2025"] = "gemini-3-pro-preview-11-2025";
@@ -369,6 +370,7 @@ export var GoogleAIModels;
     GoogleAIModels["GEMINI_3_1_PRO_PREVIEW"] = "gemini-3.1-pro-preview";
     GoogleAIModels["GEMINI_3_1_FLASH"] = "gemini-3.1-flash";
     GoogleAIModels["GEMINI_3_1_FLASH_LITE"] = "gemini-3.1-flash-lite";
+    GoogleAIModels["GEMINI_3_1_FLASH_LITE_PREVIEW"] = "gemini-3.1-flash-lite-preview";
     // Gemini 3 Series (Preview)
     GoogleAIModels["GEMINI_3_PRO_PREVIEW"] = "gemini-3-pro-preview";
     GoogleAIModels["GEMINI_3_PRO_IMAGE_PREVIEW"] = "gemini-3-pro-image-preview";

package/dist/lib/memory/hippocampusInitializer.d.ts

@@ -1,5 +1,5 @@
-import { Hippocampus, type HippocampusConfig } from "@juspay/hippocampus";
-export type { HippocampusConfig };
+import { Hippocampus, type HippocampusConfig, type CustomStorageConfig } from "@juspay/hippocampus";
+export type { HippocampusConfig, CustomStorageConfig };
 export type Memory = HippocampusConfig & {
     enabled?: boolean;
 };

package/dist/lib/memory/hippocampusInitializer.js

@@ -1,4 +1,4 @@
-import { Hippocampus } from "@juspay/hippocampus";
+import { Hippocampus, } from "@juspay/hippocampus";
 import { logger } from "../utils/logger.js";
 export function initializeHippocampus(config) {
     try {

package/dist/lib/providers/googleAiStudio.js

@@ -11,7 +11,7 @@ import { logger } from "../utils/logger.js";
 import { isGemini3Model } from "../utils/modelDetection.js";
 import { composeAbortSignals, createTimeoutController, TimeoutError, } from "../utils/timeout.js";
 import { estimateTokens } from "../utils/tokenEstimation.js";
-import { buildNativeConfig, buildNativeToolDeclarations, collectStreamChunks, computeMaxSteps, executeNativeToolCalls, extractTextFromParts, handleMaxStepsTermination, pushModelResponseToHistory, sanitizeToolsForGemini, } from "./googleNativeGemini3.js";
+import { buildNativeConfig, buildNativeToolDeclarations, collectStreamChunks, collectStreamChunksIncremental, computeMaxSteps, createTextChannel, executeNativeToolCalls, extractTextFromParts, handleMaxStepsTermination, pushModelResponseToHistory, sanitizeToolsForGemini, } from "./googleNativeGemini3.js";
 // Google AI Live API types now imported from ../types/providerSpecific.js
 // Import proper types for multimodal message handling
 // Create Google GenAI client
@@ -578,107 +578,151 @@ export class GoogleAIStudioProvider extends BaseProvider {
                 }
                 const config = buildNativeConfig(options, toolsConfig);
                 const maxSteps = computeMaxSteps(options.maxSteps);
-                let finalText = "";
-                let lastStepText = "";
-                let totalInputTokens = 0;
-                let totalOutputTokens = 0;
-                const allToolCalls = [];
-                let step = 0;
-                const failedTools = new Map();
                 // Compose abort signal from user signal + timeout
                 const composedSignal = composeAbortSignals(options.abortSignal, timeoutController?.controller.signal);
-                // Agentic loop for tool calling
-                while (step < maxSteps) {
-                    if (composedSignal?.aborted) {
-                        throw composedSignal.reason instanceof Error
-                            ? composedSignal.reason
-                            : new Error("Request aborted");
-                    }
-                    step++;
-                    logger.debug(`[GoogleAIStudio] Native SDK step ${step}/${maxSteps}`);
+                // Create a push-based text channel so the caller receives tokens as
+                // they arrive from the network rather than after full buffering.
+                const channel = createTextChannel();
+                // Shared mutable state updated by the background agentic loop.
+                const allToolCalls = [];
+                // analyticsResolvers lets the background loop settle the analytics
+                // promise once token counts are known (after the loop completes).
+                let analyticsResolve;
+                let analyticsReject;
+                const analyticsPromise = new Promise((res, rej) => {
+                    analyticsResolve = res;
+                    analyticsReject = rej;
+                });
+                // Shared metadata object mutated by the background loop so the
+                // returned object reflects the final values after stream completion.
+                const metadata = {
+                    streamId: `native-${Date.now()}`,
+                    startTime,
+                    responseTime: 0,
+                    totalToolExecutions: 0,
+                };
+                // Run the agentic loop in the background without awaiting it here,
+                // so we can return the StreamResult (with channel.iterable) immediately.
+                const loopPromise = (async () => {
+                    let lastStepText = "";
+                    let totalInputTokens = 0;
+                    let totalOutputTokens = 0;
+                    let step = 0;
+                    let completedWithFinalAnswer = false;
+                    const failedTools = new Map();
                     try {
-                        const stream = await client.models.generateContentStream({
-                            model: modelName,
-                            contents: currentContents,
-                            config,
-                            ...(composedSignal
-                                ? { httpOptions: { signal: composedSignal } }
-                                : {}),
-                        });
-                        const chunkResult = await collectStreamChunks(stream);
-                        totalInputTokens += chunkResult.inputTokens;
-                        totalOutputTokens += chunkResult.outputTokens;
-                        const stepText = extractTextFromParts(chunkResult.rawResponseParts);
-                        // If no function calls, we're done
-                        if (chunkResult.stepFunctionCalls.length === 0) {
-                            finalText = stepText;
-                            break;
+                        // Agentic loop for tool calling
+                        while (step < maxSteps) {
+                            if (composedSignal?.aborted) {
+                                throw composedSignal.reason instanceof Error
+                                    ? composedSignal.reason
+                                    : new Error("Request aborted");
+                            }
+                            step++;
+                            logger.debug(`[GoogleAIStudio] Native SDK step ${step}/${maxSteps}`);
+                            try {
+                                const rawStream = await client.models.generateContentStream({
+                                    model: modelName,
+                                    contents: currentContents,
+                                    config,
+                                    ...(composedSignal
+                                        ? { httpOptions: { signal: composedSignal } }
+                                        : {}),
+                                });
+                                // For every step, use incremental collection so text parts
+                                // are pushed to the channel as they arrive.  For intermediate
+                                // steps (those that produce function calls) we still need the
+                                // complete rawResponseParts for pushModelResponseToHistory,
+                                // which collectStreamChunksIncremental provides at stream end.
+                                const chunkResult = await collectStreamChunksIncremental(rawStream, channel);
+                                totalInputTokens += chunkResult.inputTokens;
+                                totalOutputTokens += chunkResult.outputTokens;
+                                const stepText = extractTextFromParts(chunkResult.rawResponseParts);
+                                // If no function calls, this was the final step — channel
+                                // already received all text parts incrementally.
+                                if (chunkResult.stepFunctionCalls.length === 0) {
+                                    completedWithFinalAnswer = true;
+                                    break;
+                                }
+                                lastStepText = stepText;
+                                // Record tool call events on the span
+                                for (const fc of chunkResult.stepFunctionCalls) {
+                                    span.addEvent("gen_ai.tool_call", {
+                                        "tool.name": fc.name,
+                                        "tool.step": step,
+                                    });
+                                }
+                                logger.debug(`[GoogleAIStudio] Executing ${chunkResult.stepFunctionCalls.length} function calls`);
+                                // Add model response with ALL parts (including thoughtSignature) to history
+                                pushModelResponseToHistory(currentContents, chunkResult.rawResponseParts, chunkResult.stepFunctionCalls);
+                                const functionResponses = await executeNativeToolCalls("[GoogleAIStudio]", chunkResult.stepFunctionCalls, executeMap, failedTools, allToolCalls, { abortSignal: composedSignal });
+                                // Add function responses to history — the @google/genai SDK
+                                // only accepts "user" and "model" as valid roles in contents.
+                                // Function/tool responses must use role: "user" (matching the
+                                // SDK's own automaticFunctionCalling implementation).
+                                currentContents.push({
+                                    role: "user",
+                                    parts: functionResponses,
+                                });
+                            }
+                            catch (error) {
+                                logger.error("[GoogleAIStudio] Native SDK error", error);
+                                throw this.handleProviderError(error);
+                            }
                         }
-                        lastStepText = stepText;
-                        // Record tool call events on the span
-                        for (const fc of chunkResult.stepFunctionCalls) {
-                            span.addEvent("gen_ai.tool_call", {
-                                "tool.name": fc.name,
-                                "tool.step": step,
-                            });
+                        // Handle max-steps termination: if the model was still calling
+                        // tools when we hit the limit, push a synthetic final message.
+                        const hitStepLimitWithoutFinalAnswer = step >= maxSteps && !completedWithFinalAnswer;
+                        if (hitStepLimitWithoutFinalAnswer) {
+                            const fallback = handleMaxStepsTermination("[GoogleAIStudio]", step, maxSteps, "", // finalText is empty — model didn't stop on its own
+                            lastStepText);
+                            if (fallback) {
+                                channel.push(fallback);
+                            }
                         }
-                        logger.debug(`[GoogleAIStudio] Executing ${chunkResult.stepFunctionCalls.length} function calls`);
-                        // Add model response with ALL parts (including thoughtSignature) to history
-                        pushModelResponseToHistory(currentContents, chunkResult.rawResponseParts, chunkResult.stepFunctionCalls);
-                        const functionResponses = await executeNativeToolCalls("[GoogleAIStudio]", chunkResult.stepFunctionCalls, executeMap, failedTools, allToolCalls, { abortSignal: composedSignal });
-                        // Add function responses to history — the @google/genai SDK
-                        // only accepts "user" and "model" as valid roles in contents.
-                        // Function/tool responses must use role: "user" (matching the
-                        // SDK's own automaticFunctionCalling implementation).
-                        currentContents.push({
-                            role: "user",
-                            parts: functionResponses,
+                        const responseTime = Date.now() - startTime;
+                        // Update shared metadata so the returned object reflects final values.
+                        metadata.responseTime = responseTime;
+                        metadata.totalToolExecutions = allToolCalls.length;
+                        // Set token usage and finish reason on the span
+                        span.setAttribute(ATTR.GEN_AI_INPUT_TOKENS, totalInputTokens);
+                        span.setAttribute(ATTR.GEN_AI_OUTPUT_TOKENS, totalOutputTokens);
+                        span.setAttribute(ATTR.GEN_AI_FINISH_REASON, hitStepLimitWithoutFinalAnswer ? "max_steps" : "stop");
+                        analyticsResolve({
+                            provider: this.providerName,
+                            model: modelName,
+                            tokenUsage: {
+                                input: totalInputTokens,
+                                output: totalOutputTokens,
+                                total: totalInputTokens + totalOutputTokens,
+                            },
+                            requestDuration: responseTime,
+                            timestamp: new Date().toISOString(),
                         });
+                        channel.close();
                     }
-                    catch (error) {
-                        logger.error("[GoogleAIStudio] Native SDK error", error);
-                        throw this.handleProviderError(error);
+                    catch (err) {
+                        channel.error(err);
+                        analyticsReject(err);
                     }
-                }
-                finalText = handleMaxStepsTermination("[GoogleAIStudio]", step, maxSteps, finalText, lastStepText);
-                const responseTime = Date.now() - startTime;
-                // Set token usage and finish reason on the span
-                span.setAttribute(ATTR.GEN_AI_INPUT_TOKENS, totalInputTokens);
-                span.setAttribute(ATTR.GEN_AI_OUTPUT_TOKENS, totalOutputTokens);
-                span.setAttribute(ATTR.GEN_AI_FINISH_REASON, step >= maxSteps ? "max_steps" : "stop");
-                // Create async iterable for streaming result
-                async function* createTextStream() {
-                    yield { content: finalText };
-                }
+                    finally {
+                        timeoutController?.cleanup();
+                    }
+                })();
+                // Suppress unhandled-rejection warnings on loopPromise — errors are
+                // forwarded to the channel and will surface when the caller iterates.
+                loopPromise.catch(() => undefined);
                 return {
-                    stream: createTextStream(),
+                    stream: channel.iterable,
                     provider: this.providerName,
                     model: modelName,
-                    toolCalls: allToolCalls.map((tc) => ({
-                        toolName: tc.toolName,
-                        args: tc.args,
-                    })),
-                    analytics: Promise.resolve({
-                        provider: this.providerName,
-                        model: modelName,
-                        tokenUsage: {
-                            input: totalInputTokens,
-                            output: totalOutputTokens,
-                            total: totalInputTokens + totalOutputTokens,
-                        },
-                        requestDuration: responseTime,
-                        timestamp: new Date().toISOString(),
-                    }),
-                    metadata: {
-                        streamId: `native-${Date.now()}`,
-                        startTime,
-                        responseTime,
-                        totalToolExecutions: allToolCalls.length,
-                    },
+                    toolCalls: allToolCalls,
+                    analytics: analyticsPromise,
+                    metadata,
                 };
             }
             finally {
-                timeoutController?.cleanup();
+                // Timeout controller cleanup is managed inside the background loop
             }
         });
     }
@@ -709,7 +753,9 @@ export class GoogleAIStudioProvider extends BaseProvider {
                     hasTools: !!options.tools && Object.keys(options.tools).length > 0,
                 });
                 // Build contents from input
-                const promptText = options.prompt || options.input?.text || "";
+                // Prefer input.text over prompt — processCSVFilesForNativeSDK enriches
+                // input.text with inlined CSV data, so using prompt first would discard it.
+                const promptText = options.input?.text || options.prompt || "";
                 const currentContents = [{ role: "user", parts: [{ text: promptText }] }];
                 // Convert tools (merge SDK tools with options.tools)
                 let toolsConfig;

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

@@ -98,6 +98,49 @@ export declare function collectStreamChunks(stream: AsyncIterable<{
     functionCalls?: NativeFunctionCall[];
     [key: string]: unknown;
 }>): Promise<CollectedChunkResult>;
+/**
+ * A push-based text channel that decouples producers (agentic loop) from
+ * consumers (the caller's async iterable).
+ *
+ * The producer calls `push(text)` for each chunk and `close()` / `error(err)`
+ * when done.  The consumer iterates the `iterable` async generator.
+ */
+export type TextChannel = {
+    /** Push a text chunk to the consumer. */
+    push(text: string): void;
+    /** Signal that no more chunks will arrive. */
+    close(): void;
+    /** Signal that the producer encountered a fatal error. */
+    error(err: unknown): void;
+    /** Async iterable consumed by the StreamResult. */
+    iterable: AsyncIterable<{
+        content: string;
+    }>;
+};
+/**
+ * Create a push-based text channel that bridges a background producer
+ * (the agentic tool-calling loop) with an async-iterable consumer.
+ *
+ * This enables truly incremental streaming: text parts are yielded to the
+ * caller as they arrive from the network, rather than being buffered until
+ * the model finishes generating.
+ */
+export declare function createTextChannel(): TextChannel;
+/**
+ * Iterate a single stream step incrementally, pushing text parts to `channel`
+ * as they arrive from the network while simultaneously accumulating the full
+ * `CollectedChunkResult` needed for history and token accounting.
+ *
+ * Used for all steps (both intermediate tool-calling steps and the final
+ * text-only step).  Text parts are pushed to the channel as they arrive,
+ * enabling truly incremental streaming.  The complete `rawResponseParts`
+ * (including thoughtSignature) are still returned at the end for use by
+ * `pushModelResponseToHistory`.
+ */
+export declare function collectStreamChunksIncremental(stream: AsyncIterable<{
+    functionCalls?: NativeFunctionCall[];
+    [key: string]: unknown;
+}>, channel: TextChannel): Promise<CollectedChunkResult>;
 /**
  * Extract text from raw response parts, filtering out non-text parts
  * (thoughtSignature, functionCall) to avoid SDK warnings.