@falai/agent 2.1.1 → 2.2.1

package/src/types/flow.ts

@@ -25,7 +25,7 @@ export type ConditionIf<TContext = unknown, TData = unknown> =
   | ConditionPredicate<TContext, TData>[];
 
 /**
- * The `when` field shape: a single AI-evaluated string or array of strings (AND semantics).
+ * The `when` field shape: a single AI-evaluated string or array of strings (OR semantics).
  * Functions are NOT allowed on `when` — they belong on `if` only.
  */
 export type ConditionWhen = string | string[];
@@ -196,7 +196,7 @@ export type BranchPredicate<TContext = unknown, TData = unknown> = (
  */
 export interface BranchEntry<TContext = unknown, TData = unknown> {
   /**
-   * AI-evaluated condition. String or array of strings (AND semantics).
+   * AI-evaluated condition. String or array of strings (OR semantics).
    * Costs LLM tokens. Reuses the same machinery as `step.when`.
    * Only evaluated if `if` passes (or is absent) — code-first short-circuit.
    */
@@ -324,7 +324,7 @@ export interface FlowOptions<TContext = unknown, TData = unknown> {
   description?: string;
 
   /**
-   * AI-evaluated activation condition(s). String or array of strings (AND semantics).
+   * AI-evaluated activation condition(s). String or array of strings (OR semantics).
    * Costs LLM tokens. Functions are NOT allowed here — use `if` for code predicates.
    */
   when?: ConditionWhen;
@@ -498,7 +498,7 @@ export interface StepOptions<TContext = unknown, TData = unknown> {
    */
   requires?: (keyof TData)[];
   /**
-   * AI-evaluated activation condition(s). String or array of strings (AND semantics).
+   * AI-evaluated activation condition(s). String or array of strings (OR semantics).
    * Costs LLM tokens. Functions are NOT allowed here — use `if` for code predicates.
    */
   when?: ConditionWhen;

package/src/types/history.ts

@@ -16,8 +16,6 @@ export enum MessageRole {
   SYSTEM = "system",
 }
 
-export type MessageRoleType = MessageRole;
-
 import type { SessionState } from "./session";
 
 /**
@@ -32,8 +30,6 @@ export enum EventKind {
   STATUS = "status",
 }
 
-export type EventKindType = EventKind;
-
 /**
  * Participant in a conversation
  */

package/src/types/index.ts

@@ -19,7 +19,6 @@ export type {
   HookContext,
   ExitReason,
 } from "./agent";
-export { CompositionMode } from "./agent";
 
 // History types
 export type {
@@ -41,7 +40,6 @@ export type {
   ToolHistoryItem,
 } from "./history";
 export { EventKind, MessageRole } from "./history";
-export * from "./history";
 
 // Flow types
 export type {
@@ -105,12 +103,12 @@ export type {
   CompactionResult,
 } from "./compaction";
 
-// Prompt cache types (re-exported from core)
+// Prompt cache types
 export type {
   PromptSectionType,
   PromptCacheConfig,
   SectionCompute,
-} from "../core/PromptSectionCache";
+} from "./prompt-cache";
 
 // AI provider types
 export type {
@@ -125,10 +123,6 @@ export type {
 // Schema types
 export type { StructuredSchema } from "./schema";
 
-// Routing types
-export type { RoutingDecision } from "./routing";
-export * from "./routing";
-
 // Persistence types
 export type {
   SessionData,
@@ -143,7 +137,6 @@ export type {
   SaveMessageOptions,
   CollectedStateData,
 } from "./persistence";
-export * from "./persistence";
 
 // Template types
 export type {

package/src/types/prompt-cache.ts

@@ -0,0 +1,17 @@
+/**
+ * Prompt section cache configuration types.
+ */
+
+/** Section type: static sections are cached, dynamic sections recompute every turn */
+export type PromptSectionType = "static" | "dynamic";
+
+/** Configuration for prompt section caching behavior */
+export interface PromptCacheConfig {
+    /** Whether to enable section memoization (default: true) */
+    enabled?: boolean;
+    /** Keys of sections that should always recompute every turn, even if registered as static */
+    volatileKeys?: string[];
+}
+
+/** Compute function that produces a section's content */
+export type SectionCompute = () => string | null | Promise<string | null>;

package/src/types/schema.ts

@@ -13,11 +13,3 @@ export interface StructuredSchema {
   // Allow provider-specific passthroughs without breaking types
   [key: string]: unknown;
 }
-
-/**
- * A small helper describing a named schema (for providers that require a name)
- */
-export interface NamedSchema {
-  name?: string;
-  schema: StructuredSchema;
-}

package/src/types/tool.ts

@@ -159,8 +159,6 @@ export enum ToolScope {
 
 
 
-// --- EnhancedTool (deprecated internal alias — use Tool directly) ---
-
 /**
  * Result of input validation on a tool call
  */

package/src/utils/history.ts

@@ -258,13 +258,7 @@ export function eventsToHistory(events: Event[]): History {
   });
 }
 
-/**
- * Normalize a simplified history array to internal Event array
- * @deprecated Use historyToEvents instead
- */
-export function normalizeHistory(history: History): Event[] {
-  return historyToEvents(history);
-}
+
 
 /**
  * Helper function to create a user message

package/src/utils/index.ts

@@ -29,8 +29,6 @@ export {
 export {
   render,
   renderMany,
-  renderTemplate,
-  renderTemplateObject,
   formatKnowledgeBase,
   createTemplateContext,
 } from "./template";
@@ -43,7 +41,6 @@ export { getLastMessageFromHistory } from "./event";
 
 // History utilities
 export {
-  normalizeHistory,
   historyItemToEvent,
   historyToEvents,
   eventToHistoryItem,

package/src/utils/template.ts

@@ -59,7 +59,6 @@ export async function renderMany<TContext = unknown, TData = unknown>(
 }
 
 /**
- * @deprecated Use the asynchronous `render` function instead.
  * Renders template variables in a string using the provided context.
  * Supports {{variable}} and {{object.property}} syntax for property access.
  *
@@ -171,7 +170,6 @@ function valueToString(value: unknown): string {
 }
 
 /**
- * @deprecated This function does not support async template functions.
  * Renders template variables in an object recursively.
  * Handles nested objects and arrays.
  *

package/dist/cjs/types/routing.d.ts

@@ -1,12 +0,0 @@
-import type { StructuredSchema } from "./schema";
-export interface RoutingDecision {
-    context: string;
-    flows: Record<string, number>;
-    responseDirectives?: string[];
-    extractions?: unknown;
-    contextUpdate?: Record<string, unknown>;
-}
-export interface RoutingSchemaOptions {
-    extrasSchema?: StructuredSchema;
-}
-//# sourceMappingURL=routing.d.ts.map

package/dist/cjs/types/routing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../../src/types/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC"}

package/dist/cjs/types/routing.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=routing.js.map

package/dist/cjs/types/routing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"routing.js","sourceRoot":"","sources":["../../../src/types/routing.ts"],"names":[],"mappings":""}

package/dist/types/routing.d.ts

@@ -1,12 +0,0 @@
-import type { StructuredSchema } from "./schema";
-export interface RoutingDecision {
-    context: string;
-    flows: Record<string, number>;
-    responseDirectives?: string[];
-    extractions?: unknown;
-    contextUpdate?: Record<string, unknown>;
-}
-export interface RoutingSchemaOptions {
-    extrasSchema?: StructuredSchema;
-}
-//# sourceMappingURL=routing.d.ts.map

package/dist/types/routing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/types/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC"}

package/dist/types/routing.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=routing.js.map

package/dist/types/routing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"routing.js","sourceRoot":"","sources":["../../src/types/routing.ts"],"names":[],"mappings":""}

package/src/types/routing.ts

@@ -1,13 +0,0 @@
-import type { StructuredSchema } from "./schema";
-
-export interface RoutingDecision {
-  context: string;
-  flows: Record<string, number>;
-  responseDirectives?: string[];
-  extractions?: unknown;
-  contextUpdate?: Record<string, unknown>;
-}
-
-export interface RoutingSchemaOptions {
-  extrasSchema?: StructuredSchema;
-}