@juspay/neurolink 9.63.1 → 9.65.0

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

@@ -9,7 +9,20 @@
  * providers so they can share a single implementation.
  */
 import { type Tool } from "ai";
-import type { ThinkingConfig, CollectedChunkResult, NativeFunctionCall, NativeFunctionResponse, NativeToolDeclarationsResult, NativeToolsConfig, TextChannel } from "../types/index.js";
+import type { ThinkingConfig, CollectedChunkResult, NativeFunctionCall, NativeFunctionResponse, NativeToolDeclarationsResult, NativeToolsConfig, TextChannel, VertexNativePart, GeminiMultimodalInput } from "../types/index.js";
+export declare function sanitizeForGoogleFunctionName(name: string): string;
+/**
+ * Resolve a sanitized Gemini tool name to one that is both unique within
+ * the current request and at most 128 characters. When the candidate
+ * collides with an already-used name we append `_2`, `_3`, … — but
+ * reserve room for the suffix by truncating the base first so the
+ * resolved name never exceeds Google's `function_declarations[].name`
+ * limit.
+ *
+ * @param base       The already-sanitized candidate name.
+ * @param isTaken    Predicate that returns true if `name` is already used.
+ */
+export declare function resolveUniqueGoogleFunctionName(base: string, isTaken: (name: string) => boolean): string;
 /**
  * Sanitize a JSON Schema for Gemini's proto-based API.
  *
@@ -35,6 +48,12 @@ export declare function sanitizeSchemaForGemini(schema: Record<string, unknown>)
 export declare function sanitizeToolsForGemini(tools: Record<string, Tool>): {
     tools: Record<string, Tool>;
     dropped: string[];
+    /**
+     * Reverse map: Google-safe sanitized name → original consumer-supplied
+     * name. Lets the calling layer translate tool-call results back so the
+     * sanitization stays transport-only (see CodeRabbit thread, PR #1006).
+     */
+    originalNameMap: Map<string, string>;
 };
 export declare function normalizeToolsForJsonSchemaProvider(tools: Record<string, Tool>): {
     tools: Record<string, Tool>;
@@ -48,12 +67,30 @@ export declare function normalizeToolsForJsonSchemaProvider(tools: Record<string
 export declare function buildNativeToolDeclarations(tools: Record<string, Tool>): NativeToolDeclarationsResult;
 /**
  * Build the native @google/genai config object shared by stream and generate.
+ *
+ * Caller is responsible for the tools-vs-JSON conflict resolution: Gemini's
+ * function calling cannot be combined with `responseMimeType:
+ * "application/json"`, and `responseSchema` requires that mime type. So
+ * when tools are active, callers must NOT pass `wantsJsonOutput`/
+ * `responseSchema` here; when JSON/schema output is requested, callers
+ * must omit `toolsConfig`. The AI Studio path enforces this by forcing
+ * `disableTools: true` whenever JSON/schema output is requested.
  */
 export declare function buildNativeConfig(options: {
     temperature?: number;
     maxTokens?: number;
     systemPrompt?: string;
     thinkingConfig?: ThinkingConfig;
+    /**
+     * When true (and `toolsConfig` is undefined), set
+     * `responseMimeType: "application/json"` to enforce native JSON output.
+     */
+    wantsJsonOutput?: boolean;
+    /**
+     * Pre-converted JSON Schema for native `responseSchema`. Implies
+     * `wantsJsonOutput`. Ignored if `toolsConfig` is present.
+     */
+    responseSchema?: Record<string, unknown>;
 }, toolsConfig?: NativeToolsConfig): Record<string, unknown>;
 /**
  * Compute a safe, clamped maxSteps value.
@@ -110,7 +147,10 @@ export declare function extractTextFromParts(rawResponseParts: unknown[]): strin
  * @param executeMap - Map of tool name to execute function
  * @param failedTools - Mutable map tracking per-tool failure counts
  * @param allToolCalls - Mutable array accumulating all tool call records
- * @param options - Optional settings for execution tracking and cancellation
+ * @param options - Optional settings for execution tracking and cancellation,
+ *                  plus an `originalNameMap` (Google-safe → consumer-supplied
+ *                  identifier) so the sanitization stays transport-only and
+ *                  consumers see the names they registered.
  * @returns Array of function responses for conversation history
  */
 export declare function executeNativeToolCalls(logLabel: string, stepFunctionCalls: NativeFunctionCall[], executeMap: Map<string, Tool["execute"]>, failedTools: Map<string, {
@@ -126,6 +166,7 @@ export declare function executeNativeToolCalls(logLabel: string, stepFunctionCal
         output: unknown;
     }>;
     abortSignal?: AbortSignal;
+    originalNameMap?: Map<string, string>;
 }): Promise<NativeFunctionResponse[]>;
 /**
  * Handle maxSteps termination by producing a final text when the model
@@ -142,3 +183,67 @@ export declare function pushModelResponseToHistory(currentContents: Array<{
     role: string;
     parts: unknown[];
 }>, rawResponseParts: unknown[], stepFunctionCalls: NativeFunctionCall[]): void;
+/**
+ * Convert a Zod schema (or AI SDK `jsonSchema()` wrapper) into the shape
+ * `@google/genai` accepts as `responseSchema`. Mirrors the inline pipeline
+ * the Vertex Gemini paths already use:
+ *
+ *   convertZodToJsonSchema → inlineJsonSchema → strip `$schema` → ensure
+ *   every nested schema has a `type` (Vertex/Gemini reject schemas missing
+ *   that field, even on nested objects).
+ *
+ * Lives here so the AI Studio and Vertex paths can share the same
+ * sanitization without duplicating the schema-conversion churn.
+ */
+export declare function buildGeminiResponseSchema(schema: unknown): Record<string, unknown>;
+/**
+ * Map NeuroLink ChatMessage[] history into the @google/genai content format
+ * and push the entries onto a contents array.
+ *
+ * Used by the native Vertex Gemini and Google AI Studio paths to honor
+ * `options.conversationMessages` so multi-turn conversations (memory, loop
+ * REPL, agent flows) actually carry prior turns into the request.
+ *
+ * Behavior notes:
+ *  - Only `user` and `assistant` roles are forwarded; system messages are
+ *    expected to be wired via `systemInstruction`, and tool-call /
+ *    tool-result roles only appear inside intra-call tool loops which build
+ *    their own model/function entries.
+ *  - String content is wrapped as a single `{ text }` part. Empty strings
+ *    are skipped to avoid sending empty parts that some Gemini regions
+ *    reject.
+ *  - The current user input should be appended AFTER calling this helper
+ *    so the prior turns appear first in chronological order.
+ */
+export declare function prependConversationMessages(contents: Array<{
+    role: string;
+    parts: unknown[];
+}>, conversationMessages?: Array<{
+    role: string;
+    content: string;
+}>): void;
+/**
+ * Build the `parts` array for the current user turn of a Gemini native
+ * `generateContent` request, including inline image + PDF blobs.
+ *
+ * Both providers that hit the native `@google/genai` SDK — `GoogleVertex`
+ * and `GoogleAIStudio` — need this. The previous AI Studio code only
+ * pushed a single `{ text }` part, which silently dropped `input.images`
+ * and `input.pdfFiles` on the floor: the model received text only and
+ * legitimately reported "no image attached". Extracting this from the
+ * Vertex copy keeps both providers on one definition.
+ *
+ * Accepted shapes per element (mirroring the runtime behaviour the Vertex
+ * code already supported):
+ *   - `Buffer` → used as-is
+ *   - local file path → read via `readFileSync`, MIME guessed from extension
+ *   - `data:<mime>;base64,...` URL → mime parsed, data base64-decoded
+ *   - `http(s)://...` URL → fetched, mime from `content-type`
+ *   - any other string → assumed to be a base64-encoded payload
+ *
+ * Image MIME guessing is conservative — only known extensions override the
+ * default `image/jpeg`. Fetch failures are logged and the offending entry
+ * is skipped rather than aborting the entire request, matching prior
+ * Vertex behaviour.
+ */
+export declare function buildUserPartsWithMultimodal(input: GeminiMultimodalInput | undefined, textOverride?: string, logPrefix?: string): Promise<VertexNativePart[]>;