@falai/agent 2.6.1 → 3.0.0

package/src/core/flow-namespace.ts

@@ -5,8 +5,9 @@
  * Directives are plain object literals; this namespace provides runtime utilities only.
  */
 
-import type { Directive } from "../types/flow";
-import { FlowConfigurationError } from "./Step";
+import type { Directive } from "../types/flow.js";
+import type { SessionState } from "../types/session.js";
+import { FlowConfigurationError } from "./Step.js";
 
 // ─── Position field metadata ─────────────────────────────────────────────────
 
@@ -181,6 +182,32 @@ function validate<TContext, TData>(d: Directive<TContext, TData>): void {
     }
 }
 
+/**
+ * Reduce an array of directives into one via the canonical Algorithm 4 merge
+ * (position precedence, reply last-wins, state shallow-merge, halt OR).
+ * Empty arrays yield undefined.
+ */
+function mergeAll<TContext, TData>(
+    directives: Directive<TContext, TData>[]
+): Directive<TContext, TData> | undefined {
+    if (directives.length === 0) return undefined;
+    return directives.reduce((a, b) => merge(a, b));
+}
+
+/**
+ * Queue a control directive on the session for the pendingDirective applier at
+ * the START of the next turn, merging with anything already queued via the
+ * canonical Algorithm 4 merge.
+ */
+function queuePending<TData>(
+    session: SessionState<TData>,
+    directive: Directive<unknown, TData>
+): void {
+    session.pendingDirective = session.pendingDirective
+        ? merge(session.pendingDirective, directive)
+        : directive;
+}
+
 /**
  * The `flow` namespace object. Exported as a single const for ergonomic usage:
  *
@@ -194,5 +221,7 @@ function validate<TContext, TData>(d: Directive<TContext, TData>): void {
 export const flow = {
     isDirective,
     merge,
+    mergeAll,
+    queuePending,
     validate,
 } as const;

package/src/core/toolGates.ts

@@ -9,8 +9,8 @@
  * ("when denied, handler is NOT invoked") was silently a no-op on one
  * transport. Centralizing the logic here keeps both executors in lockstep.
  */
-import type { Tool, ToolContext, ToolExecutionResult } from "../types/tool";
-import { logger } from "../utils";
+import type { Tool, ToolContext, ToolExecutionResult } from "../types/tool.js";
+import { logger } from "../utils/index.js";
 
 /**
  * Run a tool's pre-execution gates in order: `validateInput`, then

package/src/index.ts

@@ -5,81 +5,95 @@
  */
 
 // Core
-export { Agent } from "./core/Agent";
-export { createAgent } from "./core/createAgent";
-export { Flow } from "./core/Flow";
-export { Step, FlowConfigurationError } from "./core/Step";
-export { flow } from "./core/flow-namespace";
+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";
-export { PersistenceManager } from "./core/PersistenceManager";
-export { SessionManager } from "./core/SessionManager";
-export { ToolManager, ToolCreationError, ToolExecutionError } from "./core/ToolManager";
-export { NotImplementedError, SessionConflictError, ProviderError } from "./types/errors";
-export type { ProviderErrorCode } from "./types/errors";
+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";
 
 
 // Providers
-export { GeminiProvider } from "./providers/GeminiProvider";
-export type { GeminiProviderOptions } from "./providers/GeminiProvider";
-export { OpenAIProvider } from "./providers/OpenAIProvider";
-export type { OpenAIProviderOptions } from "./providers/OpenAIProvider";
-export { OpenRouterProvider } from "./providers/OpenRouterProvider";
-export type { OpenRouterProviderOptions } from "./providers/OpenRouterProvider";
-export { AnthropicProvider } from "./providers/AnthropicProvider";
-export type { AnthropicProviderOptions } from "./providers/AnthropicProvider";
-export { DeepSeekProvider } from "./providers/DeepSeekProvider";
-export type { DeepSeekProviderOptions } from "./providers/DeepSeekProvider";
+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 { 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";
 // Base class for building OpenAI-compatible providers (Groq, Together, etc.)
-export { OpenAICompatibleProvider } from "./providers/OpenAICompatibleProvider";
-export type { StructuredOutputMode } from "./providers/OpenAICompatibleProvider";
-export { createOpenAICompatibleProvider } from "./providers/GenericOpenAICompatibleProvider";
-export type { OpenAICompatibleOptions } from "./providers/GenericOpenAICompatibleProvider";
+export { OpenAICompatibleProvider } from "./providers/OpenAICompatibleProvider.js";
+export type {
+  OpenAICompatibleProviderInit,
+  StructuredOutputMode,
+} from "./providers/OpenAICompatibleProvider.js";
+export { createOpenAICompatibleProvider } from "./providers/GenericOpenAICompatibleProvider.js";
+export type { OpenAICompatibleOptions } from "./providers/GenericOpenAICompatibleProvider.js";
+// The bridge every provider above is built on — subclass it to bind any
+// `@providerkit/core` provider to this framework's seam.
+export { ProviderAdapter, resolveRetryConfig } from "./providers/ProviderAdapter.js";
+export type {
+  ProviderAdapterInit,
+  RequestConfig,
+  RetryConfig,
+} from "./providers/ProviderAdapter.js";
 
 // Adapters
-export { PrismaAdapter } from "./adapters/PrismaAdapter";
+export { PrismaAdapter } from "./adapters/PrismaAdapter.js";
 export type {
   PrismaClient,
   FieldMappings,
   PrismaAdapterOptions,
-} from "./adapters/PrismaAdapter";
-export { RedisAdapter } from "./adapters/RedisAdapter";
-export type { RedisClient, RedisAdapterOptions } from "./adapters/RedisAdapter";
-export { MongoAdapter } from "./adapters/MongoAdapter";
+} 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";
-export { PostgreSQLAdapter } from "./adapters/PostgreSQLAdapter";
+} from "./adapters/MongoAdapter.js";
+export { PostgreSQLAdapter } from "./adapters/PostgreSQLAdapter.js";
 export type {
   PgClient,
   PgQueryResult,
   PostgreSQLAdapterOptions,
-} from "./adapters/PostgreSQLAdapter";
-export { SQLiteAdapter } from "./adapters/SQLiteAdapter";
+} from "./adapters/PostgreSQLAdapter.js";
+export { SQLiteAdapter } from "./adapters/SQLiteAdapter.js";
 export type {
   SqliteDatabase,
   SqliteStatement,
   SQLiteAdapterOptions,
-} from "./adapters/SQLiteAdapter";
-export { MemoryAdapter } from "./adapters/MemoryAdapter";
-export { OpenSearchAdapter } from "./adapters/OpenSearchAdapter";
+} from "./adapters/SQLiteAdapter.js";
+export { MemoryAdapter } from "./adapters/MemoryAdapter.js";
+export { OpenSearchAdapter } from "./adapters/OpenSearchAdapter.js";
 export type {
   OpenSearchClient,
   OpenSearchAdapterOptions,
-} from "./adapters/OpenSearchAdapter";
+} from "./adapters/OpenSearchAdapter.js";
 
 // Utils
-export { generateFlowId, generateStepId, generateToolId } from "./utils/id";
-export { formatKnowledgeBase } from "./utils/template";
+export { generateFlowId, generateStepId, generateToolId } from "./utils/id.js";
+export { formatKnowledgeBase } from "./utils/template.js";
 export {
   ConditionEvaluator,
   createConditionEvaluator,
   extractAIContextStrings,
   hasProgrammaticConditions
-} from "./utils/condition";
+} from "./utils/condition.js";
 export {
   historyItemToEvent,
   historyToEvents,
@@ -89,7 +103,7 @@ export {
   assistantMessage,
   toolMessage,
   systemMessage,
-} from "./utils/history";
+} from "./utils/history.js";
 
 // Types
 export type {
@@ -186,6 +200,6 @@ export type {
   ConditionPredicate,
   ConditionIf,
   ConditionWhen,
-} from "./types";
-export { EventKind, MessageRole } from "./types";
-export { createSession, createSessionId, createPersistedState, enterFlow, enterStep, completeCurrentFlow, isFlowCompletedThisSession, mergeCollected } from "./utils";
+} 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";