@falai/agent 2.6.1 → 3.0.0

package/dist/cjs/providers/DeepSeekProvider.js

@@ -1,47 +1,30 @@
 "use strict";
 /**
- * DeepSeek provider implementation (OpenAI-compatible API)
- * Supports deepseek-chat, deepseek-reasoner with optional thinking/reasoning mode.
- * DeepSeek streams reasoning content via `delta.reasoning_content` when thinking is enabled.
+ * DeepSeek (OpenAI-compatible). Its reasoning arrives on `reasoning_content`
+ * and its cache hits under `prompt_cache_hit_tokens`; both are read one layer
+ * down, where they are the dialect's business rather than this file's.
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeepSeekProvider = void 0;
-const openai_1 = __importDefault(require("openai"));
-const utils_1 = require("../utils");
-const OpenAICompatibleProvider_1 = require("./OpenAICompatibleProvider");
-/**
- * DeepSeek provider implementation using the OpenAI-compatible API.
- * Supports deepseek-chat and deepseek-reasoner with optional thinking mode.
- *
- * DeepSeek streams reasoning content via `delta.reasoning_content` when
- * thinking mode is enabled. Tool calls follow the standard OpenAI format.
- * Structured output uses chat completions with a json_schema response
- * format (DeepSeek does not expose the responses.parse API).
- */
-class DeepSeekProvider extends OpenAICompatibleProvider_1.OpenAICompatibleProvider {
+const OpenAICompatibleProvider_js_1 = require("./OpenAICompatibleProvider.js");
+class DeepSeekProvider extends OpenAICompatibleProvider_js_1.OpenAICompatibleProvider {
     constructor(options) {
-        const { apiKey, model, backupModels, baseURL = "https://api.deepseek.com", config, retryConfig, } = options;
-        if (!apiKey) {
+        if (!options.apiKey)
             throw new Error("DeepSeek API key is required");
-        }
-        if (!model) {
+        if (!options.model) {
             throw new Error("Model is required. Example: 'deepseek-chat' or 'deepseek-reasoner'");
         }
         super({
-            client: new openai_1.default({
-                apiKey,
-                baseURL,
-            }),
-            model,
-            backupModels,
-            config,
-            retryConfig,
-            // DeepSeek has no responses.parse API; structured output goes through
-            // chat completions with a native json_schema response_format.
+            id: "deepseek",
+            apiKey: options.apiKey,
+            baseUrl: options.baseURL ?? "https://api.deepseek.com",
+            model: options.model,
+            // No Responses API here; chat completions enforces the schema natively.
             structuredOutput: "json_schema",
+            ...(options.backupModels ? { backupModels: options.backupModels } : {}),
+            ...(options.config ? { config: options.config } : {}),
+            ...(options.retryConfig ? { retryConfig: options.retryConfig } : {}),
+            ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
         });
         this.name = "deepseek";
         this.capabilities = {
@@ -49,25 +32,8 @@ class DeepSeekProvider extends OpenAICompatibleProvider_1.OpenAICompatibleProvid
             supportsNativeJsonSchema: true,
             supportsStreaming: true,
             supportsStreamingToolCalls: true,
-            supportsPromptCaching: false,
+            supportsPromptCaching: true,
         };
-        this.logLabel = "DEEPSEEK";
-        this.displayName = "DeepSeek";
-    }
-    /**
-     * DeepSeek reports usage in streaming chunks when explicitly requested.
-     */
-    configureStreamParams(params) {
-        params.stream_options = { include_usage: true };
-    }
-    /**
-     * DeepSeek streams reasoning via `reasoning_content` on the delta.
-     */
-    onStreamDelta(delta) {
-        const reasoning = delta.reasoning_content ?? undefined;
-        if (reasoning) {
-            utils_1.logger.debug(`[${this.logLabel}] Reasoning: ${reasoning}`);
-        }
     }
 }
 exports.DeepSeekProvider = DeepSeekProvider;

package/dist/cjs/providers/DeepSeekProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"DeepSeekProvider.js","sourceRoot":"","sources":["../../../src/providers/DeepSeekProvider.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,oDAA4B;AAO5B,oCAAkC;AAClC,yEAGoC;AAwBpC;;;;;;;;GAQG;AACH,MAAa,gBAAiB,SAAQ,mDAAwB;IAa5D,YAAY,OAAgC;QAC1C,MAAM,EACJ,MAAM,EACN,KAAK,EACL,YAAY,EACZ,OAAO,GAAG,0BAA0B,EACpC,MAAM,EACN,WAAW,GACZ,GAAG,OAAO,CAAC;QAEZ,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;QACJ,CAAC;QAED,KAAK,CAAC;YACJ,MAAM,EAAE,IAAI,gBAAM,CAAC;gBACjB,MAAM;gBACN,OAAO;aACR,CAAC;YACF,KAAK;YACL,YAAY;YACZ,MAAM;YACN,WAAW;YACX,sEAAsE;YACtE,8DAA8D;YAC9D,gBAAgB,EAAE,aAAa;SAChC,CAAC,CAAC;QA5CW,SAAI,GAAG,UAAU,CAAC;QAClB,iBAAY,GAAyB;YACnD,aAAa,EAAE,IAAI;YACnB,wBAAwB,EAAE,IAAI;YAC9B,iBAAiB,EAAE,IAAI;YACvB,0BAA0B,EAAE,IAAI;YAChC,qBAAqB,EAAE,KAAK;SAC7B,CAAC;QAEiB,aAAQ,GAAG,UAAU,CAAC;QACtB,gBAAW,GAAG,UAAU,CAAC;IAmC5C,CAAC;IAED;;OAEG;IACgB,qBAAqB,CACtC,MAA2C;QAE3C,MAAM,CAAC,cAAc,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAClD,CAAC;IAED;;OAEG;IACgB,aAAa,CAC9B,KAAuC;QAEvC,MAAM,SAAS,GACX,KAAiC,CAAC,iBAEtB,IAAI,SAAS,CAAC;QAC9B,IAAI,SAAS,EAAE,CAAC;YACd,cAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,gBAAgB,SAAS,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;CACF;AAvED,4CAuEC"}
+{"version":3,"file":"DeepSeekProvider.js","sourceRoot":"","sources":["../../../src/providers/DeepSeekProvider.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,+EAAyE;AAoBzE,MAAa,gBAAiB,SAAQ,sDAAwB;IAU5D,YAAY,OAAgC;QAC1C,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACrE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACxF,CAAC;QAED,KAAK,CAAC;YACJ,EAAE,EAAE,UAAU;YACd,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,0BAA0B;YACtD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,wEAAwE;YACxE,gBAAgB,EAAE,aAAa;YAC/B,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/D,CAAC,CAAC;QA1BW,SAAI,GAAG,UAAU,CAAC;QAClB,iBAAY,GAAyB;YACnD,aAAa,EAAE,IAAI;YACnB,wBAAwB,EAAE,IAAI;YAC9B,iBAAiB,EAAE,IAAI;YACvB,0BAA0B,EAAE,IAAI;YAChC,qBAAqB,EAAE,IAAI;SAC5B,CAAC;IAoBF,CAAC;CACF;AA7BD,4CA6BC"}

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

@@ -1,92 +1,39 @@
 /**
- * Google Gemini AI provider implementation with retry and backup models
- */
-import type { 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 */
     apiKey: string;
-    /** Model to use (required) - e.g., "gemini-3.1-pro-preview" */
+    /** 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;
     };
+    /** 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/cjs/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,EAEV,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,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,+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;CACH;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;YA6DlB,iBAAiB;YAwJhB,wBAAwB;YAmExB,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;CAqB3C"}