@falai/agent 3.4.3 → 3.4.5

package/dist/cjs/core/createAgent.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Level-1 factory for constructing an Agent from a single options object.
+ *
+ * `createAgent` is syntactic sugar over `new Agent(options)` and is the
+ * recommended entry point in docs and examples. Generic inference flows
+ * from `schema` through `flows[].steps[].collect` identically to `new Agent`.
+ *
+ * @example
+ * ```typescript
+ * const agent = createAgent({
+ *   name: 'BookingBot',
+ *   provider: new GeminiProvider({ apiKey }),
+ *   schema: { type: 'object', properties: { name: { type: 'string' }, email: { type: 'string' } } },
+ *   flows: [{ title: 'Onboarding', steps: [{ collect: ['name', 'email'] }] }],
+ * });
+ * ```
+ *
+ * **Validates: Requirements 14.1–14.7**
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgent = createAgent;
+const Agent_js_1 = require("./Agent.js");
+/**
+ * Create an Agent from a single options object.
+ *
+ * This is the recommended entry point for constructing agents in v2.
+ * Accepts the same options as `new Agent(options)` — `schema`, `provider`,
+ * `instructions`, `flows`, and everything else `AgentOptions` carries.
+ *
+ * Generic inference flows from `schema` through `flows[].steps[].collect`.
+ * Invalid `collect` references throw `FlowConfigurationError` at construction time.
+ *
+ * Post-construction flow registration is still available via `agent.createFlow(...)`.
+ */
+function createAgent(options) {
+    return new Agent_js_1.Agent(options);
+}
+//# sourceMappingURL=createAgent.js.map

package/dist/cjs/core/createAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAgent.js","sourceRoot":"","sources":["../../../src/core/createAgent.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;AAiBH,kCAIC;AAnBD,yCAAmC;AAGnC;;;;;;;;;;;GAWG;AACH,SAAgB,WAAW,CACvB,OAAsC;IAEtC,OAAO,IAAI,gBAAK,CAAkB,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @falai/agent — Conversational state engine for TypeScript
+ *
+ * The AI understands. The code is in control.
+ */
+export { Agent } from "./core/Agent.js";
+export type { RespondParams, StreamOptions, GenerateOptions } from "./core/ResponseModal.js";
+export { ResponseGenerationError } from "./core/ResponseGenerationError.js";
+export type { EndedFlow } from "./types/agent.js";
+export { createAgent } from "./core/createAgent.js";
+export { Flow } from "./core/Flow.js";
+export { Step, FlowConfigurationError } from "./core/Step.js";
+export { flow } from "./core/flow-namespace.js";
+export { adaptEvent, convertHistoryToEvents } from "./core/Events.js";
+export { PersistenceManager } from "./core/PersistenceManager.js";
+export { SessionManager } from "./core/SessionManager.js";
+export { ToolManager, ToolCreationError, ToolExecutionError } from "./core/ToolManager.js";
+export { NotImplementedError, SessionConflictError, ProviderError } from "./types/errors.js";
+export type { ErrorKind } from "./types/errors.js";
+export { GeminiProvider } from "./providers/GeminiProvider.js";
+export type { GeminiProviderOptions } from "./providers/GeminiProvider.js";
+export { OpenAIProvider } from "./providers/OpenAIProvider.js";
+export type { OpenAIProviderOptions } from "./providers/OpenAIProvider.js";
+export { OpenRouterProvider } from "./providers/OpenRouterProvider.js";
+export type { OpenRouterProviderOptions } from "./providers/OpenRouterProvider.js";
+export { ZaiProvider } from "./providers/ZaiProvider.js";
+export type { ZaiProviderOptions } from "./providers/ZaiProvider.js";
+export { AnthropicProvider } from "./providers/AnthropicProvider.js";
+export type { AnthropicProviderOptions } from "./providers/AnthropicProvider.js";
+export { DeepSeekProvider } from "./providers/DeepSeekProvider.js";
+export type { DeepSeekProviderOptions } from "./providers/DeepSeekProvider.js";
+export { FallbackAiProvider } from "./providers/FallbackAiProvider.js";
+export type { FallbackAiProviderOptions } from "./providers/FallbackAiProvider.js";
+export { OpenAICompatibleProvider } from "./providers/OpenAICompatibleProvider.js";
+export type { JsonWithTools, OpenAICompatibleProviderInit, StructuredOutputMode, } from "./providers/OpenAICompatibleProvider.js";
+export { createOpenAICompatibleProvider } from "./providers/GenericOpenAICompatibleProvider.js";
+export type { OpenAICompatibleOptions } from "./providers/GenericOpenAICompatibleProvider.js";
+export { ProviderAdapter, resolveRetryConfig } from "./providers/ProviderAdapter.js";
+export type { JsonWithToolsProbe, ProbeOptions } from "@providerkit/core";
+export type { ProviderAdapterInit, RequestConfig, RetryConfig, } from "./providers/ProviderAdapter.js";
+export { PrismaAdapter } from "./adapters/PrismaAdapter.js";
+export type { PrismaClient, FieldMappings, PrismaAdapterOptions, } from "./adapters/PrismaAdapter.js";
+export { RedisAdapter } from "./adapters/RedisAdapter.js";
+export type { RedisClient, RedisAdapterOptions } from "./adapters/RedisAdapter.js";
+export { MongoAdapter } from "./adapters/MongoAdapter.js";
+export type { MongoClient, MongoDatabase, MongoCollection, MongoAdapterOptions, } from "./adapters/MongoAdapter.js";
+export { PostgreSQLAdapter } from "./adapters/PostgreSQLAdapter.js";
+export type { PgClient, PgQueryResult, PostgreSQLAdapterOptions, } from "./adapters/PostgreSQLAdapter.js";
+export { SQLiteAdapter } from "./adapters/SQLiteAdapter.js";
+export type { SqliteDatabase, SqliteStatement, SQLiteAdapterOptions, } from "./adapters/SQLiteAdapter.js";
+export { MemoryAdapter } from "./adapters/MemoryAdapter.js";
+export { OpenSearchAdapter } from "./adapters/OpenSearchAdapter.js";
+export type { OpenSearchClient, OpenSearchAdapterOptions, } from "./adapters/OpenSearchAdapter.js";
+export { generateFlowId, generateStepId, generateToolId } from "./utils/id.js";
+export { formatKnowledgeBase } from "./utils/template.js";
+export { ConditionEvaluator, createConditionEvaluator, extractAIContextStrings, hasProgrammaticConditions } from "./utils/condition.js";
+export { historyItemToEvent, historyToEvents, eventToHistoryItem, eventsToHistory, userMessage, assistantMessage, toolMessage, systemMessage, } from "./utils/history.js";
+export type { AgentOptions, AgentCompactionConfig, AgentResponse, Term, Instruction, ScopedInstructions, AppliedInstruction, ContextLifecycleHooks, ContextProvider, HookContext, ExitReason, Event, EmittedEvent, MessageEventData, ToolEventData, StatusEventData, Participant, FlowRef, StepRef, FlowOptions, StepOptions, FlowLifecycleHooks, StepLifecycleHooks, SessionState, SignalsState, SignalTriggerState, Signal, SignalContext, SignalDirective, ResolvedSignalDirective, SignalPredicate, SignalPredicateContext, SignalFiring, SignalSchema, ToolContext, ToolResult, ToolHandler, Tool, ToolValidationResult, ToolPermissionResult, ToolCallRequest, ToolExecutionUpdate, CompactionOptions, CompactionResult, DataEnrichmentConfig, ValidationConfig, ValidationError, ApiCallConfig, ComputationConfig, ToolScope, AiProvider, ProviderCapabilities, GenerateMessageInput, GenerateMessageOutput, AgentStructuredResponse, ReasoningConfig, StructuredSchema, SessionData, MessageData, CollectedStateData, SessionStatus, SessionRepository, SessionUpdateOptions, MessageRepository, PersistenceConfig, CreateSessionOptions, SaveMessageOptions, AgentResponseStreamChunk, Role, HistoryItem, History, PersistenceAdapter, Template, TemplateContext, ConditionEvaluationResult, UserHistoryItem, AssistantHistoryItem, ToolHistoryItem, SystemHistoryItem, StoppedReason, PrepareResult, Directive, BranchEntry, BranchMap, BranchPredicate, BranchPredicateContext, ConditionPredicate, ConditionIf, ConditionWhen, } from "./types/index.js";
+export { EventKind, MessageRole } from "./types/index.js";
+export { restoreSession, createSession, createSessionId, createPersistedState, enterFlow, enterStep, completeCurrentFlow, isFlowCompletedThisSession, mergeCollected } from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * @falai/agent — Conversational state engine for TypeScript
+ *
+ * The AI understands. The code is in control.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolMessage = exports.assistantMessage = exports.userMessage = exports.eventsToHistory = exports.eventToHistoryItem = exports.historyToEvents = exports.historyItemToEvent = exports.hasProgrammaticConditions = exports.extractAIContextStrings = exports.createConditionEvaluator = exports.ConditionEvaluator = exports.formatKnowledgeBase = exports.generateToolId = exports.generateStepId = exports.generateFlowId = exports.OpenSearchAdapter = exports.MemoryAdapter = exports.SQLiteAdapter = exports.PostgreSQLAdapter = exports.MongoAdapter = exports.RedisAdapter = exports.PrismaAdapter = exports.resolveRetryConfig = exports.ProviderAdapter = exports.createOpenAICompatibleProvider = exports.OpenAICompatibleProvider = exports.FallbackAiProvider = exports.DeepSeekProvider = exports.AnthropicProvider = exports.ZaiProvider = exports.OpenRouterProvider = exports.OpenAIProvider = exports.GeminiProvider = exports.ProviderError = exports.SessionConflictError = exports.NotImplementedError = exports.ToolExecutionError = exports.ToolCreationError = exports.ToolManager = exports.SessionManager = exports.PersistenceManager = exports.convertHistoryToEvents = exports.adaptEvent = exports.flow = exports.FlowConfigurationError = exports.Step = exports.Flow = exports.createAgent = exports.ResponseGenerationError = exports.Agent = void 0;
+exports.mergeCollected = exports.isFlowCompletedThisSession = exports.completeCurrentFlow = exports.enterStep = exports.enterFlow = exports.createPersistedState = exports.createSessionId = exports.createSession = exports.restoreSession = exports.MessageRole = exports.EventKind = exports.systemMessage = void 0;
+// Core
+var Agent_js_1 = require("./core/Agent.js");
+Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return Agent_js_1.Agent; } });
+var ResponseGenerationError_js_1 = require("./core/ResponseGenerationError.js");
+Object.defineProperty(exports, "ResponseGenerationError", { enumerable: true, get: function () { return ResponseGenerationError_js_1.ResponseGenerationError; } });
+var createAgent_js_1 = require("./core/createAgent.js");
+Object.defineProperty(exports, "createAgent", { enumerable: true, get: function () { return createAgent_js_1.createAgent; } });
+var Flow_js_1 = require("./core/Flow.js");
+Object.defineProperty(exports, "Flow", { enumerable: true, get: function () { return Flow_js_1.Flow; } });
+var Step_js_1 = require("./core/Step.js");
+Object.defineProperty(exports, "Step", { enumerable: true, get: function () { return Step_js_1.Step; } });
+Object.defineProperty(exports, "FlowConfigurationError", { enumerable: true, get: function () { return Step_js_1.FlowConfigurationError; } });
+var flow_namespace_js_1 = require("./core/flow-namespace.js");
+Object.defineProperty(exports, "flow", { enumerable: true, get: function () { return flow_namespace_js_1.flow; } });
+var Events_js_1 = require("./core/Events.js");
+Object.defineProperty(exports, "adaptEvent", { enumerable: true, get: function () { return Events_js_1.adaptEvent; } });
+Object.defineProperty(exports, "convertHistoryToEvents", { enumerable: true, get: function () { return Events_js_1.convertHistoryToEvents; } });
+var PersistenceManager_js_1 = require("./core/PersistenceManager.js");
+Object.defineProperty(exports, "PersistenceManager", { enumerable: true, get: function () { return PersistenceManager_js_1.PersistenceManager; } });
+var SessionManager_js_1 = require("./core/SessionManager.js");
+Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return SessionManager_js_1.SessionManager; } });
+var ToolManager_js_1 = require("./core/ToolManager.js");
+Object.defineProperty(exports, "ToolManager", { enumerable: true, get: function () { return ToolManager_js_1.ToolManager; } });
+Object.defineProperty(exports, "ToolCreationError", { enumerable: true, get: function () { return ToolManager_js_1.ToolCreationError; } });
+Object.defineProperty(exports, "ToolExecutionError", { enumerable: true, get: function () { return ToolManager_js_1.ToolExecutionError; } });
+var errors_js_1 = require("./types/errors.js");
+Object.defineProperty(exports, "NotImplementedError", { enumerable: true, get: function () { return errors_js_1.NotImplementedError; } });
+Object.defineProperty(exports, "SessionConflictError", { enumerable: true, get: function () { return errors_js_1.SessionConflictError; } });
+Object.defineProperty(exports, "ProviderError", { enumerable: true, get: function () { return errors_js_1.ProviderError; } });
+// Providers
+var GeminiProvider_js_1 = require("./providers/GeminiProvider.js");
+Object.defineProperty(exports, "GeminiProvider", { enumerable: true, get: function () { return GeminiProvider_js_1.GeminiProvider; } });
+var OpenAIProvider_js_1 = require("./providers/OpenAIProvider.js");
+Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return OpenAIProvider_js_1.OpenAIProvider; } });
+var OpenRouterProvider_js_1 = require("./providers/OpenRouterProvider.js");
+Object.defineProperty(exports, "OpenRouterProvider", { enumerable: true, get: function () { return OpenRouterProvider_js_1.OpenRouterProvider; } });
+var ZaiProvider_js_1 = require("./providers/ZaiProvider.js");
+Object.defineProperty(exports, "ZaiProvider", { enumerable: true, get: function () { return ZaiProvider_js_1.ZaiProvider; } });
+var AnthropicProvider_js_1 = require("./providers/AnthropicProvider.js");
+Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return AnthropicProvider_js_1.AnthropicProvider; } });
+var DeepSeekProvider_js_1 = require("./providers/DeepSeekProvider.js");
+Object.defineProperty(exports, "DeepSeekProvider", { enumerable: true, get: function () { return DeepSeekProvider_js_1.DeepSeekProvider; } });
+var FallbackAiProvider_js_1 = require("./providers/FallbackAiProvider.js");
+Object.defineProperty(exports, "FallbackAiProvider", { enumerable: true, get: function () { return FallbackAiProvider_js_1.FallbackAiProvider; } });
+// Base class for building OpenAI-compatible providers (Groq, Together, etc.)
+var OpenAICompatibleProvider_js_1 = require("./providers/OpenAICompatibleProvider.js");
+Object.defineProperty(exports, "OpenAICompatibleProvider", { enumerable: true, get: function () { return OpenAICompatibleProvider_js_1.OpenAICompatibleProvider; } });
+var GenericOpenAICompatibleProvider_js_1 = require("./providers/GenericOpenAICompatibleProvider.js");
+Object.defineProperty(exports, "createOpenAICompatibleProvider", { enumerable: true, get: function () { return GenericOpenAICompatibleProvider_js_1.createOpenAICompatibleProvider; } });
+// The bridge every provider above is built on — subclass it to bind any
+// `@providerkit/core` provider to this framework's seam.
+var ProviderAdapter_js_1 = require("./providers/ProviderAdapter.js");
+Object.defineProperty(exports, "ProviderAdapter", { enumerable: true, get: function () { return ProviderAdapter_js_1.ProviderAdapter; } });
+Object.defineProperty(exports, "resolveRetryConfig", { enumerable: true, get: function () { return ProviderAdapter_js_1.resolveRetryConfig; } });
+// Adapters
+var PrismaAdapter_js_1 = require("./adapters/PrismaAdapter.js");
+Object.defineProperty(exports, "PrismaAdapter", { enumerable: true, get: function () { return PrismaAdapter_js_1.PrismaAdapter; } });
+var RedisAdapter_js_1 = require("./adapters/RedisAdapter.js");
+Object.defineProperty(exports, "RedisAdapter", { enumerable: true, get: function () { return RedisAdapter_js_1.RedisAdapter; } });
+var MongoAdapter_js_1 = require("./adapters/MongoAdapter.js");
+Object.defineProperty(exports, "MongoAdapter", { enumerable: true, get: function () { return MongoAdapter_js_1.MongoAdapter; } });
+var PostgreSQLAdapter_js_1 = require("./adapters/PostgreSQLAdapter.js");
+Object.defineProperty(exports, "PostgreSQLAdapter", { enumerable: true, get: function () { return PostgreSQLAdapter_js_1.PostgreSQLAdapter; } });
+var SQLiteAdapter_js_1 = require("./adapters/SQLiteAdapter.js");
+Object.defineProperty(exports, "SQLiteAdapter", { enumerable: true, get: function () { return SQLiteAdapter_js_1.SQLiteAdapter; } });
+var MemoryAdapter_js_1 = require("./adapters/MemoryAdapter.js");
+Object.defineProperty(exports, "MemoryAdapter", { enumerable: true, get: function () { return MemoryAdapter_js_1.MemoryAdapter; } });
+var OpenSearchAdapter_js_1 = require("./adapters/OpenSearchAdapter.js");
+Object.defineProperty(exports, "OpenSearchAdapter", { enumerable: true, get: function () { return OpenSearchAdapter_js_1.OpenSearchAdapter; } });
+// Utils
+var id_js_1 = require("./utils/id.js");
+Object.defineProperty(exports, "generateFlowId", { enumerable: true, get: function () { return id_js_1.generateFlowId; } });
+Object.defineProperty(exports, "generateStepId", { enumerable: true, get: function () { return id_js_1.generateStepId; } });
+Object.defineProperty(exports, "generateToolId", { enumerable: true, get: function () { return id_js_1.generateToolId; } });
+var template_js_1 = require("./utils/template.js");
+Object.defineProperty(exports, "formatKnowledgeBase", { enumerable: true, get: function () { return template_js_1.formatKnowledgeBase; } });
+var condition_js_1 = require("./utils/condition.js");
+Object.defineProperty(exports, "ConditionEvaluator", { enumerable: true, get: function () { return condition_js_1.ConditionEvaluator; } });
+Object.defineProperty(exports, "createConditionEvaluator", { enumerable: true, get: function () { return condition_js_1.createConditionEvaluator; } });
+Object.defineProperty(exports, "extractAIContextStrings", { enumerable: true, get: function () { return condition_js_1.extractAIContextStrings; } });
+Object.defineProperty(exports, "hasProgrammaticConditions", { enumerable: true, get: function () { return condition_js_1.hasProgrammaticConditions; } });
+var history_js_1 = require("./utils/history.js");
+Object.defineProperty(exports, "historyItemToEvent", { enumerable: true, get: function () { return history_js_1.historyItemToEvent; } });
+Object.defineProperty(exports, "historyToEvents", { enumerable: true, get: function () { return history_js_1.historyToEvents; } });
+Object.defineProperty(exports, "eventToHistoryItem", { enumerable: true, get: function () { return history_js_1.eventToHistoryItem; } });
+Object.defineProperty(exports, "eventsToHistory", { enumerable: true, get: function () { return history_js_1.eventsToHistory; } });
+Object.defineProperty(exports, "userMessage", { enumerable: true, get: function () { return history_js_1.userMessage; } });
+Object.defineProperty(exports, "assistantMessage", { enumerable: true, get: function () { return history_js_1.assistantMessage; } });
+Object.defineProperty(exports, "toolMessage", { enumerable: true, get: function () { return history_js_1.toolMessage; } });
+Object.defineProperty(exports, "systemMessage", { enumerable: true, get: function () { return history_js_1.systemMessage; } });
+var index_js_1 = require("./types/index.js");
+Object.defineProperty(exports, "EventKind", { enumerable: true, get: function () { return index_js_1.EventKind; } });
+Object.defineProperty(exports, "MessageRole", { enumerable: true, get: function () { return index_js_1.MessageRole; } });
+var index_js_2 = require("./utils/index.js");
+Object.defineProperty(exports, "restoreSession", { enumerable: true, get: function () { return index_js_2.restoreSession; } });
+Object.defineProperty(exports, "createSession", { enumerable: true, get: function () { return index_js_2.createSession; } });
+Object.defineProperty(exports, "createSessionId", { enumerable: true, get: function () { return index_js_2.createSessionId; } });
+Object.defineProperty(exports, "createPersistedState", { enumerable: true, get: function () { return index_js_2.createPersistedState; } });
+Object.defineProperty(exports, "enterFlow", { enumerable: true, get: function () { return index_js_2.enterFlow; } });
+Object.defineProperty(exports, "enterStep", { enumerable: true, get: function () { return index_js_2.enterStep; } });
+Object.defineProperty(exports, "completeCurrentFlow", { enumerable: true, get: function () { return index_js_2.completeCurrentFlow; } });
+Object.defineProperty(exports, "isFlowCompletedThisSession", { enumerable: true, get: function () { return index_js_2.isFlowCompletedThisSession; } });
+Object.defineProperty(exports, "mergeCollected", { enumerable: true, get: function () { return index_js_2.mergeCollected; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;AAEH,OAAO;AACP,4CAAwC;AAA/B,iGAAA,KAAK,OAAA;AAEd,gFAA4E;AAAnE,qIAAA,uBAAuB,OAAA;AAEhC,wDAAoD;AAA3C,6GAAA,WAAW,OAAA;AACpB,0CAAsC;AAA7B,+FAAA,IAAI,OAAA;AACb,0CAA8D;AAArD,+FAAA,IAAI,OAAA;AAAE,iHAAA,sBAAsB,OAAA;AACrC,8DAAgD;AAAvC,yGAAA,IAAI,OAAA;AAEb,8CAAsE;AAA7D,uGAAA,UAAU,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAC3C,sEAAkE;AAAzD,2HAAA,kBAAkB,OAAA;AAC3B,8DAA0D;AAAjD,mHAAA,cAAc,OAAA;AACvB,wDAA2F;AAAlF,6GAAA,WAAW,OAAA;AAAE,mHAAA,iBAAiB,OAAA;AAAE,oHAAA,kBAAkB,OAAA;AAC3D,+CAA6F;AAApF,gHAAA,mBAAmB,OAAA;AAAE,iHAAA,oBAAoB,OAAA;AAAE,0GAAA,aAAa,OAAA;AAIjE,YAAY;AACZ,mEAA+D;AAAtD,mHAAA,cAAc,OAAA;AAEvB,mEAA+D;AAAtD,mHAAA,cAAc,OAAA;AAEvB,2EAAuE;AAA9D,2HAAA,kBAAkB,OAAA;AAE3B,6DAAyD;AAAhD,6GAAA,WAAW,OAAA;AAEpB,yEAAqE;AAA5D,yHAAA,iBAAiB,OAAA;AAE1B,uEAAmE;AAA1D,uHAAA,gBAAgB,OAAA;AAEzB,2EAAuE;AAA9D,2HAAA,kBAAkB,OAAA;AAE3B,6EAA6E;AAC7E,uFAAmF;AAA1E,uIAAA,wBAAwB,OAAA;AAMjC,qGAAgG;AAAvF,oJAAA,8BAA8B,OAAA;AAEvC,wEAAwE;AACxE,yDAAyD;AACzD,qEAAqF;AAA5E,qHAAA,eAAe,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAU5C,WAAW;AACX,gEAA4D;AAAnD,iHAAA,aAAa,OAAA;AAMtB,8DAA0D;AAAjD,+GAAA,YAAY,OAAA;AAErB,8DAA0D;AAAjD,+GAAA,YAAY,OAAA;AAOrB,wEAAoE;AAA3D,yHAAA,iBAAiB,OAAA;AAM1B,gEAA4D;AAAnD,iHAAA,aAAa,OAAA;AAMtB,gEAA4D;AAAnD,iHAAA,aAAa,OAAA;AACtB,wEAAoE;AAA3D,yHAAA,iBAAiB,OAAA;AAM1B,QAAQ;AACR,uCAA+E;AAAtE,uGAAA,cAAc,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,uGAAA,cAAc,OAAA;AACvD,mDAA0D;AAAjD,kHAAA,mBAAmB,OAAA;AAC5B,qDAK8B;AAJ5B,kHAAA,kBAAkB,OAAA;AAClB,wHAAA,wBAAwB,OAAA;AACxB,uHAAA,uBAAuB,OAAA;AACvB,yHAAA,yBAAyB,OAAA;AAE3B,iDAS4B;AAR1B,gHAAA,kBAAkB,OAAA;AAClB,6GAAA,eAAe,OAAA;AACf,gHAAA,kBAAkB,OAAA;AAClB,6GAAA,eAAe,OAAA;AACf,yGAAA,WAAW,OAAA;AACX,8GAAA,gBAAgB,OAAA;AAChB,yGAAA,WAAW,OAAA;AACX,2GAAA,aAAa,OAAA;AAmGf,6CAA0D;AAAjD,qGAAA,SAAS,OAAA;AAAE,uGAAA,WAAW,OAAA;AAC/B,6CAA+L;AAAtL,0GAAA,cAAc,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,gHAAA,oBAAoB,OAAA;AAAE,qGAAA,SAAS,OAAA;AAAE,qGAAA,SAAS,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAAE,sHAAA,0BAA0B,OAAA;AAAE,0GAAA,cAAc,OAAA"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

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

@@ -0,0 +1,46 @@
+/**
+ * Anthropic (Claude).
+ *
+ * Anthropic has no native schema mode, so a structured request carries the
+ * schema as an extra system block — placed after the cached one, where a
+ * per-call schema cannot invalidate the system prompt's cache. That, the
+ * thinking budget, its 529, and its cache-token accounting all live in
+ * `@providerkit/core`; this file is the constructor.
+ */
+import { type FallbackOptions, type Provider } from "@providerkit/core";
+import type { AiProvider, ProviderCapabilities } from "../types/ai.js";
+import { ProviderAdapter, type RequestConfig } from "./ProviderAdapter.js";
+export interface AnthropicProviderOptions {
+    /** Anthropic API key */
+    apiKey: string;
+    /** Model to use (required) — e.g. "claude-sonnet-5" or "claude-opus-5" */
+    model: string;
+    /** Backup models to try if the primary fails (default: []) */
+    backupModels?: string[];
+    /** Fallback providers to try if this provider fails/exhausts */
+    fallbacks?: Array<AiProvider | Provider>;
+    fallbackOptions?: FallbackOptions<Provider>;
+    /** Any endpoint speaking the Anthropic Messages 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.
+     *
+     * v3 note: this replaces the injected SDK client. There is no SDK now, so a
+     * test drives the same bytes the provider really receives rather than an
+     * SDK's idea of them.
+     */
+    fetchImpl?: typeof fetch;
+}
+export declare class AnthropicProvider extends ProviderAdapter {
+    readonly name = "anthropic";
+    readonly capabilities: ProviderCapabilities;
+    constructor(options: AnthropicProviderOptions);
+}
+//# sourceMappingURL=AnthropicProvider.d.ts.map

package/dist/cjs/providers/AnthropicProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/AnthropicProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA2B,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEjG,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE3E,MAAM,WAAW,wBAAwB;IACvC,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gEAAgE;IAChE,SAAS,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC,CAAC;IACzC,eAAe,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC5C,4DAA4D;IAC5D,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;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,SAAgB,IAAI,eAAe;IACnC,SAAgB,YAAY,EAAE,oBAAoB,CAMhD;gBAEU,OAAO,EAAE,wBAAwB;CAwB9C"}

package/dist/cjs/providers/AnthropicProvider.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Anthropic (Claude).
+ *
+ * Anthropic has no native schema mode, so a structured request carries the
+ * schema as an extra system block — placed after the cached one, where a
+ * per-call schema cannot invalidate the system prompt's cache. That, the
+ * thinking budget, its 529, and its cache-token accounting all live in
+ * `@providerkit/core`; this file is the constructor.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicProvider = void 0;
+const core_1 = require("@providerkit/core");
+const ProviderAdapter_js_1 = require("./ProviderAdapter.js");
+class AnthropicProvider extends ProviderAdapter_js_1.ProviderAdapter {
+    constructor(options) {
+        if (!options.apiKey)
+            throw new Error("Anthropic API key is required");
+        if (!options.model) {
+            throw new Error("Model is required. Example: 'claude-sonnet-5' or 'claude-opus-5'");
+        }
+        super({
+            provider: (0, core_1.createAnthropicProvider)({
+                apiKey: options.apiKey,
+                model: options.model,
+                id: "anthropic",
+                ...(options.baseUrl ? { baseUrl: options.baseUrl } : {}),
+                ...(options.config?.maxTokens ? { maxTokens: options.config.maxTokens } : {}),
+                ...(options.config?.effort ? { effort: options.config.effort } : {}),
+                ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
+            }),
+            model: options.model,
+            ...(options.config ? { defaults: options.config } : {}),
+            ...(options.backupModels ? { backupModels: options.backupModels } : {}),
+            ...(options.fallbacks ? { fallbacks: options.fallbacks } : {}),
+            ...(options.fallbackOptions ? { fallbackOptions: options.fallbackOptions } : {}),
+            ...(options.retryConfig ? { retryConfig: options.retryConfig } : {}),
+        });
+        this.name = "anthropic";
+        this.capabilities = {
+            supportsTools: true,
+            supportsNativeJsonSchema: false,
+            supportsStreaming: true,
+            supportsStreamingToolCalls: true,
+            supportsPromptCaching: true,
+        };
+    }
+}
+exports.AnthropicProvider = AnthropicProvider;
+//# sourceMappingURL=AnthropicProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicProvider.js","sourceRoot":"","sources":["../../../src/providers/AnthropicProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,4CAAiG;AAGjG,6DAA2E;AA4B3E,MAAa,iBAAkB,SAAQ,oCAAe;IAUpD,YAAY,OAAiC;QAC3C,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QAED,KAAK,CAAC;YACJ,QAAQ,EAAE,IAAA,8BAAuB,EAAC;gBAChC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,EAAE,EAAE,WAAW;gBACf,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxD,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7E,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,CAAC;YACF,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,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,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE,CAAC,CAAC;QA/BW,SAAI,GAAG,WAAW,CAAC;QACnB,iBAAY,GAAyB;YACnD,aAAa,EAAE,IAAI;YACnB,wBAAwB,EAAE,KAAK;YAC/B,iBAAiB,EAAE,IAAI;YACvB,0BAA0B,EAAE,IAAI;YAChC,qBAAqB,EAAE,IAAI;SAC5B,CAAC;IAyBF,CAAC;CACF;AAlCD,8CAkCC"}

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

@@ -0,0 +1,47 @@
+/**
+ * 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.
+ */
+import type { AiProvider, ProviderCapabilities } from "../types/ai.js";
+import { OpenAICompatibleProvider, type JsonWithTools } from "./OpenAICompatibleProvider.js";
+import type { Provider } from "@providerkit/core";
+import type { RequestConfig } from "./ProviderAdapter.js";
+export interface DeepSeekProviderOptions {
+    /** DeepSeek API key */
+    apiKey: string;
+    /** Model to use (required) — e.g. "deepseek-chat", "deepseek-reasoner" */
+    model: string;
+    /** Backup models to try if the primary fails (default: []) */
+    backupModels?: string[];
+    /**
+     * Fallback providers, tried in order after this one fails or exhausts.
+     * Accepts both @falai/agent AiProviders (like ZaiProvider) and
+     * @providerkit/core Providers — the seam that makes a coding-plan primary
+     * degrade to anything else rather than fail the turn.
+     */
+    fallbacks?: Array<AiProvider | Provider>;
+    /** Custom base URL (default: "https://api.deepseek.com") */
+    baseURL?: string;
+    /** Request defaults sent with every call */
+    config?: RequestConfig;
+    /**
+     * See {@link JsonWithTools} — and reach for it here first. The measured
+     * DeepSeek flash models called a tool 0/5 with the schema on the response
+     * format, and narrated it instead.
+     */
+    jsonWithTools?: JsonWithTools;
+    /** Idle-stream deadline and retry budget */
+    retryConfig?: {
+        timeout?: number;
+        retries?: number;
+    };
+    /** Replacement `fetch`, for tests that script the wire. */
+    fetchImpl?: typeof fetch;
+}
+export declare class DeepSeekProvider extends OpenAICompatibleProvider {
+    readonly name = "deepseek";
+    readonly capabilities: ProviderCapabilities;
+    constructor(options: DeepSeekProviderOptions);
+}
+//# sourceMappingURL=DeepSeekProvider.d.ts.map

package/dist/cjs/providers/DeepSeekProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepSeekProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/DeepSeekProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,uBAAuB;IACtC,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC,CAAC;IACzC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,4CAA4C;IAC5C,WAAW,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,qBAAa,gBAAiB,SAAQ,wBAAwB;IAC5D,SAAgB,IAAI,cAAc;IAClC,SAAgB,YAAY,EAAE,oBAAoB,CAMhD;gBAEU,OAAO,EAAE,uBAAuB;CAqB7C"}

package/dist/cjs/providers/DeepSeekProvider.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeepSeekProvider = void 0;
+const OpenAICompatibleProvider_js_1 = require("./OpenAICompatibleProvider.js");
+class DeepSeekProvider extends OpenAICompatibleProvider_js_1.OpenAICompatibleProvider {
+    constructor(options) {
+        if (!options.apiKey)
+            throw new Error("DeepSeek API key is required");
+        if (!options.model) {
+            throw new Error("Model is required. Example: 'deepseek-chat' or 'deepseek-reasoner'");
+        }
+        super({
+            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.jsonWithTools ? { jsonWithTools: options.jsonWithTools } : {}),
+            ...(options.backupModels ? { backupModels: options.backupModels } : {}),
+            ...(options.fallbacks ? { fallbacks: options.fallbacks } : {}),
+            ...(options.config ? { config: options.config } : {}),
+            ...(options.retryConfig ? { retryConfig: options.retryConfig } : {}),
+            ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
+        });
+        this.name = "deepseek";
+        this.capabilities = {
+            supportsTools: true,
+            supportsNativeJsonSchema: true,
+            supportsStreaming: true,
+            supportsStreamingToolCalls: true,
+            supportsPromptCaching: true,
+        };
+    }
+}
+exports.DeepSeekProvider = DeepSeekProvider;
+//# sourceMappingURL=DeepSeekProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DeepSeekProvider.js","sourceRoot":"","sources":["../../../src/providers/DeepSeekProvider.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,+EAA6F;AAkC7F,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,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,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,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,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;QA5BW,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;IAsBF,CAAC;CACF;AA/BD,4CA+BC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Fallback AI Provider: runs an ordered list of AiProviders.
+ *
+ * Each child AiProvider is tried in turn using `@providerkit/core`'s FallbackPool,
+ * preserving per-provider cooldowns (e.g. 5h or weekly rate limit / quota resets)
+ * across calls.
+ */
+import { FallbackPool, type FallbackOptions, type ErrorKind } from "@providerkit/core";
+import type { AgentStructuredResponse, AiProvider, GenerateMessageInput, GenerateMessageOutput, GenerateMessageStreamChunk, ProviderCapabilities } from "../types/ai.js";
+export interface FallbackAiProviderOptions {
+    /** The ordered list of providers to try. The first is primary. */
+    providers: AiProvider[];
+    /** Optional cooldown configuration overrides. */
+    cooldownMs?: Partial<Record<ErrorKind, number | null>>;
+    /** Optional callback when a provider enters cooldown. */
+    onCooldown?: FallbackOptions<AiProvider>["onCooldown"];
+}
+export declare class FallbackAiProvider implements AiProvider {
+    readonly name: string;
+    readonly capabilities: ProviderCapabilities;
+    readonly pool: FallbackPool<AiProvider>;
+    constructor(options: FallbackAiProviderOptions);
+    generateMessage<TContext = unknown, TStructured = AgentStructuredResponse>(input: GenerateMessageInput<TContext>): Promise<GenerateMessageOutput<TStructured>>;
+    generateMessageStream<TContext = unknown, TStructured = AgentStructuredResponse>(input: GenerateMessageInput<TContext>): AsyncGenerator<GenerateMessageStreamChunk<TStructured>>;
+}
+//# sourceMappingURL=FallbackAiProvider.d.ts.map

package/dist/cjs/providers/FallbackAiProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FallbackAiProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/FallbackAiProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EACV,uBAAuB,EACvB,UAAU,EACV,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,yBAAyB;IACxC,kEAAkE;IAClE,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IACvD,yDAAyD;IACzD,UAAU,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC;CACxD;AAED,qBAAa,kBAAmB,YAAW,UAAU;IACnD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,YAAY,EAAE,oBAAoB,CAAC;IACnD,SAAgB,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;gBAEnC,OAAO,EAAE,yBAAyB;IAkCxC,eAAe,CAAC,QAAQ,GAAG,OAAO,EAAE,WAAW,GAAG,uBAAuB,EAC7E,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACpC,OAAO,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;IASvC,qBAAqB,CAAC,QAAQ,GAAG,OAAO,EAAE,WAAW,GAAG,uBAAuB,EACpF,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACpC,cAAc,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC;CAQ3D"}

package/dist/cjs/providers/FallbackAiProvider.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Fallback AI Provider: runs an ordered list of AiProviders.
+ *
+ * Each child AiProvider is tried in turn using `@providerkit/core`'s FallbackPool,
+ * preserving per-provider cooldowns (e.g. 5h or weekly rate limit / quota resets)
+ * across calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FallbackAiProvider = void 0;
+const core_1 = require("@providerkit/core");
+const logger_js_1 = require("../utils/logger.js");
+class FallbackAiProvider {
+    constructor(options) {
+        if (!options.providers || options.providers.length === 0) {
+            throw new Error("FallbackAiProvider requires at least one provider");
+        }
+        this.name = `fallback(${options.providers.map((p) => p.name).join("->")})`;
+        // Capabilities represent the intersection of supported critical features
+        // while inheriting primary's defaults.
+        this.capabilities = {
+            supportsTools: options.providers.every((p) => p.capabilities.supportsTools),
+            supportsNativeJsonSchema: options.providers.every((p) => p.capabilities.supportsNativeJsonSchema),
+            supportsStreaming: options.providers.every((p) => p.capabilities.supportsStreaming),
+            supportsStreamingToolCalls: options.providers.every((p) => p.capabilities.supportsStreamingToolCalls),
+            supportsPromptCaching: options.providers.every((p) => p.capabilities.supportsPromptCaching),
+        };
+        this.pool = new core_1.FallbackPool(options.providers, {
+            ...(options.cooldownMs ? { cooldownMs: options.cooldownMs } : {}),
+            onCooldown: (info) => {
+                logger_js_1.logger.warn(`[${this.name}] Provider "${info.candidate.name}" cooled down until ${new Date(info.retryAtMs).toISOString()} (${info.kind}${info.window ? ` / ${info.window}` : ""})`);
+                options.onCooldown?.(info);
+            },
+        });
+    }
+    async generateMessage(input) {
+        return this.pool.with(async (provider, signal) => {
+            return provider.generateMessage({
+                ...input,
+                signal,
+            });
+        }, input.signal);
+    }
+    async *generateMessageStream(input) {
+        yield* this.pool.stream(async function* (provider, signal) {
+            yield* provider.generateMessageStream({
+                ...input,
+                signal,
+            });
+        }, input.signal);
+    }
+}
+exports.FallbackAiProvider = FallbackAiProvider;
+//# sourceMappingURL=FallbackAiProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FallbackAiProvider.js","sourceRoot":"","sources":["../../../src/providers/FallbackAiProvider.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,4CAI2B;AAU3B,kDAA4C;AAW5C,MAAa,kBAAkB;IAK7B,YAAY,OAAkC;QAC5C,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,YAAY,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAE3E,yEAAyE;QACzE,uCAAuC;QACvC,IAAI,CAAC,YAAY,GAAG;YAClB,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC;YAC3E,wBAAwB,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,CAC/C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,wBAAwB,CAC/C;YACD,iBAAiB,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,iBAAiB,CAAC;YACnF,0BAA0B,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,0BAA0B,CACjD;YACD,qBAAqB,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,qBAAqB,CAAC;SAC5F,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,IAAI,mBAAY,CAAa,OAAO,CAAC,SAAS,EAAE;YAC1D,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;gBACnB,kBAAM,CAAC,IAAI,CACT,IAAI,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,uBAAuB,IAAI,IAAI,CAC5E,IAAI,CAAC,SAAS,CACf,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAC1E,CAAC;gBACF,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,KAAqC;QAErC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YAC/C,OAAO,QAAQ,CAAC,eAAe,CAAwB;gBACrD,GAAG,KAAK;gBACR,MAAM;aACP,CAAC,CAAC;QACL,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,CAAC,qBAAqB,CAC1B,KAAqC;QAErC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM;YACvD,KAAK,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAwB;gBAC3D,GAAG,KAAK;gBACR,MAAM;aACP,CAAC,CAAC;QACL,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC;CACF;AA5DD,gDA4DC"}

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

@@ -0,0 +1,51 @@
+/**
+ * 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 FallbackOptions, type Provider } from "@providerkit/core";
+import type { AiProvider, ProviderCapabilities } from "../types/ai.js";
+import type { JsonWithTools } from "./OpenAICompatibleProvider.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: string;
+    /** Backup models to try if the primary fails (default: []) */
+    backupModels?: string[];
+    /** Fallback providers to try if this provider fails/exhausts */
+    fallbacks?: Array<AiProvider | Provider>;
+    fallbackOptions?: FallbackOptions<Provider>;
+    /** Any endpoint speaking the Gemini generateContent dialect. */
+    baseUrl?: string;
+    /**
+     * See {@link JsonWithTools}. The answer is the MODEL's, not the endpoint's:
+     * `gemini-3.5-flash` and `-flash-lite` called their tool under
+     * `responseJsonSchema` every time, while `gemini-3.8-flash` managed 3/10
+     * (2026-09-07). `probeJsonWithTools()` asks the one you serve.
+     */
+    jsonWithTools?: JsonWithTools;
+    /** 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;
+}
+export declare class GeminiProvider extends ProviderAdapter {
+    readonly name = "gemini";
+    readonly capabilities: ProviderCapabilities;
+    constructor(options: GeminiProviderOptions);
+}
+//# sourceMappingURL=GeminiProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GeminiProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/GeminiProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAwB,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE9F,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,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,SAAS,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC,CAAC;IACzC,eAAe,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC5C,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,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;CAyB3C"}