@falai/agent 2.7.0 → 3.1.0

package/dist/providers/GeminiProvider.d.ts

@@ -1,98 +1,39 @@
 /**
- * Google Gemini AI provider implementation with retry and backup models
- */
-import type { GoogleGenAI as GoogleGenAIType, GenerateContentConfig } from "@google/genai";
-import type { AiProvider, GenerateMessageInput, GenerateMessageOutput, GenerateMessageStreamChunk, AgentStructuredResponse } from "../types";
-import type { ProviderCapabilities } from "../types/ai";
-/**
- * Configuration options for Gemini provider
- * Uses types from @google/genai package
+ * Google Gemini.
+ *
+ * Thought signatures, the `functionResponse`-by-name pairing, implicit cache
+ * hits and the thinking levels are all in `@providerkit/core`, written against
+ * the REST API rather than the SDK.
+ *
+ * v3 sends a response schema alongside tools when a caller asks for both. v2
+ * dropped the schema in that case, from a 2024-era constraint that no longer
+ * holds — a sibling codebase runs the combination in production today.
  */
+import type { ProviderCapabilities } from "../types/ai.js";
+import { ProviderAdapter, type RequestConfig } from "./ProviderAdapter.js";
 export interface GeminiProviderOptions {
-    /** Gemini API key. Optional when `client` is injected (tests). */
-    apiKey?: string;
-    /** Model to use (required) - e.g., "gemini-3.1-pro-preview" */
+    /** Gemini API key */
+    apiKey: string;
+    /** Model to use (required) — e.g. "gemini-3.1-pro-preview" */
     model: string;
-    /** Backup models to try if primary fails (default: []) */
+    /** Backup models to try if the primary fails (default: []) */
     backupModels?: string[];
-    /** Default generation config - uses GenerateContentConfig from @google/genai */
-    config?: Partial<GenerateContentConfig>;
-    /** Retry configuration */
+    /** Any endpoint speaking the Gemini generateContent dialect. */
+    baseUrl?: string;
+    /** Request defaults sent with every call */
+    config?: RequestConfig;
+    /** Idle-stream deadline and retry budget */
     retryConfig?: {
         timeout?: number;
         retries?: number;
     };
-    /**
-     * Pre-configured SDK client. Overrides the internally-constructed one.
-     * Intended for tests injecting scripted transports; production callers
-     * should pass `apiKey` instead.
-     */
-    client?: GoogleGenAIType;
+    /** Replacement `fetch`, for tests that script the wire. Replaces v2's
+     *  injected SDK client — see {@link AnthropicProviderOptions.fetchImpl}. */
+    fetchImpl?: typeof fetch;
 }
-/**
- * Gemini provider implementation with backup models and retry logic
- */
-export declare class GeminiProvider implements AiProvider {
+export declare class GeminiProvider extends ProviderAdapter {
     readonly name = "gemini";
     readonly capabilities: ProviderCapabilities;
-    private genAI;
-    private primaryModel;
-    private backupModels;
-    private config?;
-    private retryConfig;
     constructor(options: GeminiProviderOptions);
-    /**
-     * Build Gemini-formatted contents from HistoryItem[] array.
-     * Gemini uses "user"/"model" roles (not "assistant").
-     * System messages are extracted separately for systemInstruction.
-     * Tool results map to functionResponse parts, tool calls to functionCall parts.
-     */
-    private buildGeminiContents;
-    /**
-     * Convert tool parameter schemas (JSON Schema) to Gemini's Schema format.
-     * Gemini's FunctionDeclaration.parameters expects its own Schema type,
-     * not raw JSON Schema. This method handles the conversion, including
-     * edge cases like empty objects that Gemini rejects.
-     *
-     * @private
-     */
-    private convertToolParameters;
-    /**
-     * Safely extract text from a Gemini response or chunk.
-     * Bypasses the SDK's `.text` getter entirely to avoid warnings about
-     * non-text parts (e.g., "thoughtSignature") in the response.
-     * Manually concatenates only text parts from candidates.
-     *
-     * @private
-     */
-    private safeExtractText;
-    /**
-     * Build Gemini function declarations from framework tool definitions.
-     * Converts JSON Schema parameters to Gemini's Schema format.
-     *
-     * @private
-     */
-    private buildFunctionDeclarations;
-    /**
-     * Adapt common schema format to Gemini's specific requirements.
-     * Gemini has strict validation:
-     * - OBJECT types MUST have non-empty properties
-     * - Empty objects cause 400 Bad Request errors
-     * - Uses Gemini's Schema type with Type enums
-     *
-     * @private
-     */
-    private adaptSchemaForGemini;
-    /**
-     * Map common JSON Schema type strings to Gemini's Type enum
-     * @private
-     */
-    private mapToGeminiType;
-    generateMessage<TContext = unknown, TStructured = AgentStructuredResponse>(input: GenerateMessageInput<TContext>): Promise<GenerateMessageOutput<TStructured>>;
-    generateMessageStream<TContext = unknown, TStructured = AgentStructuredResponse>(input: GenerateMessageInput<TContext>): AsyncGenerator<GenerateMessageStreamChunk<TStructured>>;
-    private generateWithBackup;
-    private generateWithModel;
-    private generateStreamWithBackup;
-    private generateStreamWithModel;
 }
 //# sourceMappingURL=GeminiProvider.d.ts.map

package/dist/providers/GeminiProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeminiProvider.d.ts","sourceRoot":"","sources":["../../src/providers/GeminiProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,WAAW,IAAI,eAAe,EAC9B,qBAAqB,EAItB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EAExB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAcxD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gFAAgF;IAChF,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxC,0BAA0B;IAC1B,WAAW,CAAC,EAAE;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF;;;;OAIG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAkBD;;GAEG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,SAAgB,IAAI,YAAY;IAChC,SAAgB,YAAY,EAAE,oBAAoB,CAMhD;IACF,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAW;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAiC;IAChD,OAAO,CAAC,WAAW,CAAuC;gBAE9C,OAAO,EAAE,qBAAqB;IAkB1C;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAkD3B;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAoBvB;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAUjC;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAoE5B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAsBjB,eAAe,CACnB,QAAQ,GAAG,OAAO,EAClB,WAAW,GAAG,uBAAuB,EAErC,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACpC,OAAO,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAIvC,qBAAqB,CAC1B,QAAQ,GAAG,OAAO,EAClB,WAAW,GAAG,uBAAuB,EAErC,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACpC,cAAc,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC;YAI5C,kBAAkB;YAsBlB,iBAAiB;YAyJhB,wBAAwB;YAyBxB,uBAAuB;CAqJvC"}
+{"version":3,"file":"GeminiProvider.d.ts","sourceRoot":"","sources":["../../src/providers/GeminiProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,4CAA4C;IAC5C,WAAW,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD;gFAC4E;IAC5E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,qBAAa,cAAe,SAAQ,eAAe;IACjD,SAAgB,IAAI,YAAY;IAChC,SAAgB,YAAY,EAAE,oBAAoB,CAMhD;gBAEU,OAAO,EAAE,qBAAqB;CAsB3C"}