@falai/agent 1.2.8 → 2.0.0

package/dist/cjs/index.js

@@ -2,20 +2,25 @@
 /**
  * @falai/agent - Standalone AI Agent framework
  *
- * A strongly-typed, modular agent framework with route DSL and AI provider strategy
+ * A strongly-typed, modular agent framework with flow DSL and AI provider strategy
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MessageRole = exports.EventKind = exports.CompositionMode = exports.systemMessage = exports.toolMessage = exports.assistantMessage = exports.userMessage = exports.eventsToHistory = exports.eventToHistoryItem = exports.historyToEvents = exports.historyItemToEvent = exports.normalizeHistory = exports.hasProgrammaticConditions = exports.extractAIContextStrings = exports.createConditionEvaluator = exports.ConditionEvaluator = exports.formatKnowledgeBase = exports.generateToolId = exports.generateStepId = exports.generateRouteId = exports.END_ROUTE_ID = exports.END_ROUTE = exports.OpenSearchAdapter = exports.MemoryAdapter = exports.SQLiteAdapter = exports.PostgreSQLAdapter = exports.MongoAdapter = exports.RedisAdapter = exports.PrismaAdapter = exports.AnthropicProvider = exports.OpenRouterProvider = exports.OpenAIProvider = exports.GeminiProvider = exports.PromptSectionCache = exports.StreamingToolExecutor = exports.CompactionEngine = exports.BatchPromptBuilder = exports.needsInput = exports.BatchExecutor = exports.ToolExecutionError = exports.ToolCreationError = exports.ToolManager = exports.SessionManager = exports.PersistenceManager = exports.convertHistoryToEvents = exports.adaptEvent = exports.ResponseModal = exports.Step = exports.Route = exports.Agent = void 0;
-exports.mergeCollected = exports.enterStep = exports.enterRoute = exports.createSessionId = exports.createSession = void 0;
+exports.enterFlow = exports.createSessionId = exports.createSession = exports.MessageRole = exports.EventKind = exports.CompositionMode = exports.systemMessage = exports.toolMessage = exports.assistantMessage = exports.userMessage = exports.eventsToHistory = exports.eventToHistoryItem = exports.historyToEvents = exports.historyItemToEvent = exports.normalizeHistory = 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.AnthropicProvider = exports.OpenRouterProvider = exports.OpenAIProvider = exports.GeminiProvider = exports.StreamingToolExecutor = exports.NotImplementedError = exports.ToolExecutionError = exports.ToolCreationError = exports.ToolManager = exports.SessionManager = exports.PersistenceManager = exports.convertHistoryToEvents = exports.adaptEvent = exports.DirectiveChainTracker = exports.flow = exports.FlowConfigurationError = exports.Step = exports.Flow = exports.createAgent = exports.Agent = void 0;
+exports.mergeCollected = exports.isFlowCompletedThisSession = exports.completeCurrentFlow = exports.enterStep = void 0;
 // Core
 var Agent_1 = require("./core/Agent");
 Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return Agent_1.Agent; } });
-var Route_1 = require("./core/Route");
-Object.defineProperty(exports, "Route", { enumerable: true, get: function () { return Route_1.Route; } });
+var createAgent_1 = require("./core/createAgent");
+Object.defineProperty(exports, "createAgent", { enumerable: true, get: function () { return createAgent_1.createAgent; } });
+var Flow_1 = require("./core/Flow");
+Object.defineProperty(exports, "Flow", { enumerable: true, get: function () { return Flow_1.Flow; } });
 var Step_1 = require("./core/Step");
 Object.defineProperty(exports, "Step", { enumerable: true, get: function () { return Step_1.Step; } });
-var ResponseModal_1 = require("./core/ResponseModal");
-Object.defineProperty(exports, "ResponseModal", { enumerable: true, get: function () { return ResponseModal_1.ResponseModal; } });
+Object.defineProperty(exports, "FlowConfigurationError", { enumerable: true, get: function () { return Step_1.FlowConfigurationError; } });
+var flow_namespace_1 = require("./core/flow-namespace");
+Object.defineProperty(exports, "flow", { enumerable: true, get: function () { return flow_namespace_1.flow; } });
+var DirectiveChainTracker_1 = require("./core/DirectiveChainTracker");
+Object.defineProperty(exports, "DirectiveChainTracker", { enumerable: true, get: function () { return DirectiveChainTracker_1.DirectiveChainTracker; } });
 var Events_1 = require("./core/Events");
 Object.defineProperty(exports, "adaptEvent", { enumerable: true, get: function () { return Events_1.adaptEvent; } });
 Object.defineProperty(exports, "convertHistoryToEvents", { enumerable: true, get: function () { return Events_1.convertHistoryToEvents; } });
@@ -27,17 +32,10 @@ var ToolManager_1 = require("./core/ToolManager");
 Object.defineProperty(exports, "ToolManager", { enumerable: true, get: function () { return ToolManager_1.ToolManager; } });
 Object.defineProperty(exports, "ToolCreationError", { enumerable: true, get: function () { return ToolManager_1.ToolCreationError; } });
 Object.defineProperty(exports, "ToolExecutionError", { enumerable: true, get: function () { return ToolManager_1.ToolExecutionError; } });
-var BatchExecutor_1 = require("./core/BatchExecutor");
-Object.defineProperty(exports, "BatchExecutor", { enumerable: true, get: function () { return BatchExecutor_1.BatchExecutor; } });
-Object.defineProperty(exports, "needsInput", { enumerable: true, get: function () { return BatchExecutor_1.needsInput; } });
-var BatchPromptBuilder_1 = require("./core/BatchPromptBuilder");
-Object.defineProperty(exports, "BatchPromptBuilder", { enumerable: true, get: function () { return BatchPromptBuilder_1.BatchPromptBuilder; } });
-var CompactionEngine_1 = require("./core/CompactionEngine");
-Object.defineProperty(exports, "CompactionEngine", { enumerable: true, get: function () { return CompactionEngine_1.CompactionEngine; } });
+var errors_1 = require("./types/errors");
+Object.defineProperty(exports, "NotImplementedError", { enumerable: true, get: function () { return errors_1.NotImplementedError; } });
 var StreamingToolExecutor_1 = require("./core/StreamingToolExecutor");
 Object.defineProperty(exports, "StreamingToolExecutor", { enumerable: true, get: function () { return StreamingToolExecutor_1.StreamingToolExecutor; } });
-var PromptSectionCache_1 = require("./core/PromptSectionCache");
-Object.defineProperty(exports, "PromptSectionCache", { enumerable: true, get: function () { return PromptSectionCache_1.PromptSectionCache; } });
 // Providers
 var GeminiProvider_1 = require("./providers/GeminiProvider");
 Object.defineProperty(exports, "GeminiProvider", { enumerable: true, get: function () { return GeminiProvider_1.GeminiProvider; } });
@@ -62,13 +60,9 @@ var MemoryAdapter_1 = require("./adapters/MemoryAdapter");
 Object.defineProperty(exports, "MemoryAdapter", { enumerable: true, get: function () { return MemoryAdapter_1.MemoryAdapter; } });
 var OpenSearchAdapter_1 = require("./adapters/OpenSearchAdapter");
 Object.defineProperty(exports, "OpenSearchAdapter", { enumerable: true, get: function () { return OpenSearchAdapter_1.OpenSearchAdapter; } });
-// Constants
-var constants_1 = require("./constants");
-Object.defineProperty(exports, "END_ROUTE", { enumerable: true, get: function () { return constants_1.END_ROUTE; } });
-Object.defineProperty(exports, "END_ROUTE_ID", { enumerable: true, get: function () { return constants_1.END_ROUTE_ID; } });
 // Utils
 var id_1 = require("./utils/id");
-Object.defineProperty(exports, "generateRouteId", { enumerable: true, get: function () { return id_1.generateRouteId; } });
+Object.defineProperty(exports, "generateFlowId", { enumerable: true, get: function () { return id_1.generateFlowId; } });
 Object.defineProperty(exports, "generateStepId", { enumerable: true, get: function () { return id_1.generateStepId; } });
 Object.defineProperty(exports, "generateToolId", { enumerable: true, get: function () { return id_1.generateToolId; } });
 var template_1 = require("./utils/template");
@@ -95,7 +89,9 @@ Object.defineProperty(exports, "MessageRole", { enumerable: true, get: function
 var utils_1 = require("./utils");
 Object.defineProperty(exports, "createSession", { enumerable: true, get: function () { return utils_1.createSession; } });
 Object.defineProperty(exports, "createSessionId", { enumerable: true, get: function () { return utils_1.createSessionId; } });
-Object.defineProperty(exports, "enterRoute", { enumerable: true, get: function () { return utils_1.enterRoute; } });
+Object.defineProperty(exports, "enterFlow", { enumerable: true, get: function () { return utils_1.enterFlow; } });
 Object.defineProperty(exports, "enterStep", { enumerable: true, get: function () { return utils_1.enterStep; } });
+Object.defineProperty(exports, "completeCurrentFlow", { enumerable: true, get: function () { return utils_1.completeCurrentFlow; } });
+Object.defineProperty(exports, "isFlowCompletedThisSession", { enumerable: true, get: function () { return utils_1.isFlowCompletedThisSession; } });
 Object.defineProperty(exports, "mergeCollected", { enumerable: true, get: function () { return utils_1.mergeCollected; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;AAEH,OAAO;AACP,sCAAqC;AAA5B,8FAAA,KAAK,OAAA;AACd,sCAAqC;AAA5B,8FAAA,KAAK,OAAA;AACd,oCAAmC;AAA1B,4FAAA,IAAI,OAAA;AACb,sDAAqD;AAA5C,8GAAA,aAAa,OAAA;AAOtB,wCAAmE;AAA1D,oGAAA,UAAU,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AAC3C,gEAA+D;AAAtD,wHAAA,kBAAkB,OAAA;AAC3B,wDAAuD;AAA9C,gHAAA,cAAc,OAAA;AACvB,kDAAwF;AAA/E,0GAAA,WAAW,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAAE,iHAAA,kBAAkB,OAAA;AAC3D,sDAAiH;AAAxG,8GAAA,aAAa,OAAA;AAAE,2GAAA,UAAU,OAAA;AAClC,gEAAoH;AAA3G,wHAAA,kBAAkB,OAAA;AAC3B,4DAA2D;AAAlD,oHAAA,gBAAgB,OAAA;AACzB,sEAAqE;AAA5D,8HAAA,qBAAqB,OAAA;AAC9B,gEAA+D;AAAtD,wHAAA,kBAAkB,OAAA;AAG3B,YAAY;AACZ,6DAA4D;AAAnD,gHAAA,cAAc,OAAA;AAEvB,6DAA4D;AAAnD,gHAAA,cAAc,OAAA;AAEvB,qEAAoE;AAA3D,wHAAA,kBAAkB,OAAA;AAE3B,mEAAkE;AAAzD,sHAAA,iBAAiB,OAAA;AAG1B,WAAW;AACX,0DAAyD;AAAhD,8GAAA,aAAa,OAAA;AAMtB,wDAAuD;AAA9C,4GAAA,YAAY,OAAA;AAErB,wDAAuD;AAA9C,4GAAA,YAAY,OAAA;AAOrB,kEAAiE;AAAxD,sHAAA,iBAAiB,OAAA;AAM1B,0DAAyD;AAAhD,8GAAA,aAAa,OAAA;AAMtB,0DAAyD;AAAhD,8GAAA,aAAa,OAAA;AACtB,kEAAiE;AAAxD,sHAAA,iBAAiB,OAAA;AAM1B,YAAY;AACZ,yCAAsD;AAA7C,sGAAA,SAAS,OAAA;AAAE,yGAAA,YAAY,OAAA;AAEhC,QAAQ;AACR,iCAA6E;AAApE,qGAAA,eAAe,OAAA;AAAE,oGAAA,cAAc,OAAA;AAAE,oGAAA,cAAc,OAAA;AACxD,6CAAuD;AAA9C,+GAAA,mBAAmB,OAAA;AAC5B,+CAK2B;AAJzB,+GAAA,kBAAkB,OAAA;AAClB,qHAAA,wBAAwB,OAAA;AACxB,oHAAA,uBAAuB,OAAA;AACvB,sHAAA,yBAAyB,OAAA;AAE3B,2CAUyB;AATvB,2GAAA,gBAAgB,OAAA;AAChB,6GAAA,kBAAkB,OAAA;AAClB,0GAAA,eAAe,OAAA;AACf,6GAAA,kBAAkB,OAAA;AAClB,0GAAA,eAAe,OAAA;AACf,sGAAA,WAAW,OAAA;AACX,2GAAA,gBAAgB,OAAA;AAChB,sGAAA,WAAW,OAAA;AACX,wGAAA,aAAa,OAAA;AAoFf,iCAAkE;AAAzD,wGAAA,eAAe,OAAA;AAAE,kGAAA,SAAS,OAAA;AAAE,oGAAA,WAAW,OAAA;AAChD,iCAAgG;AAAvF,sGAAA,aAAa,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,kGAAA,SAAS,OAAA;AAAE,uGAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;AAEH,OAAO;AACP,sCAAqC;AAA5B,8FAAA,KAAK,OAAA;AACd,kDAAiD;AAAxC,0GAAA,WAAW,OAAA;AACpB,oCAAmC;AAA1B,4FAAA,IAAI,OAAA;AACb,oCAA2D;AAAlD,4FAAA,IAAI,OAAA;AAAE,8GAAA,sBAAsB,OAAA;AACrC,wDAA6C;AAApC,sGAAA,IAAI,OAAA;AACb,sEAAqE;AAA5D,8HAAA,qBAAqB,OAAA;AAG9B,wCAAmE;AAA1D,oGAAA,UAAU,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AAC3C,gEAA+D;AAAtD,wHAAA,kBAAkB,OAAA;AAC3B,wDAAuD;AAA9C,gHAAA,cAAc,OAAA;AACvB,kDAAwF;AAA/E,0GAAA,WAAW,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAAE,iHAAA,kBAAkB,OAAA;AAC3D,yCAAqD;AAA5C,6GAAA,mBAAmB,OAAA;AAE5B,sEAAqE;AAA5D,8HAAA,qBAAqB,OAAA;AAG9B,YAAY;AACZ,6DAA4D;AAAnD,gHAAA,cAAc,OAAA;AAEvB,6DAA4D;AAAnD,gHAAA,cAAc,OAAA;AAEvB,qEAAoE;AAA3D,wHAAA,kBAAkB,OAAA;AAE3B,mEAAkE;AAAzD,sHAAA,iBAAiB,OAAA;AAG1B,WAAW;AACX,0DAAyD;AAAhD,8GAAA,aAAa,OAAA;AAMtB,wDAAuD;AAA9C,4GAAA,YAAY,OAAA;AAErB,wDAAuD;AAA9C,4GAAA,YAAY,OAAA;AAOrB,kEAAiE;AAAxD,sHAAA,iBAAiB,OAAA;AAM1B,0DAAyD;AAAhD,8GAAA,aAAa,OAAA;AAMtB,0DAAyD;AAAhD,8GAAA,aAAa,OAAA;AACtB,kEAAiE;AAAxD,sHAAA,iBAAiB,OAAA;AAM1B,QAAQ;AACR,iCAA4E;AAAnE,oGAAA,cAAc,OAAA;AAAE,oGAAA,cAAc,OAAA;AAAE,oGAAA,cAAc,OAAA;AACvD,6CAAuD;AAA9C,+GAAA,mBAAmB,OAAA;AAC5B,+CAK2B;AAJzB,+GAAA,kBAAkB,OAAA;AAClB,qHAAA,wBAAwB,OAAA;AACxB,oHAAA,uBAAuB,OAAA;AACvB,sHAAA,yBAAyB,OAAA;AAE3B,2CAUyB;AATvB,2GAAA,gBAAgB,OAAA;AAChB,6GAAA,kBAAkB,OAAA;AAClB,0GAAA,eAAe,OAAA;AACf,6GAAA,kBAAkB,OAAA;AAClB,0GAAA,eAAe,OAAA;AACf,sGAAA,WAAW,OAAA;AACX,2GAAA,gBAAgB,OAAA;AAChB,sGAAA,WAAW,OAAA;AACX,wGAAA,aAAa,OAAA;AAiGf,iCAAkE;AAAzD,wGAAA,eAAe,OAAA;AAAE,kGAAA,SAAS,OAAA;AAAE,oGAAA,WAAW,OAAA;AAChD,iCAAgJ;AAAvI,sGAAA,aAAa,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,kGAAA,SAAS,OAAA;AAAE,kGAAA,SAAS,OAAA;AAAE,4GAAA,mBAAmB,OAAA;AAAE,mHAAA,0BAA0B,OAAA;AAAE,uGAAA,cAAc,OAAA"}

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

@@ -3,12 +3,40 @@
  */
 import type { AgentStructuredResponse, AiProvider } from "./ai";
 import type { Tool } from "./tool";
-import type { RouteOptions, StepRef, StoppedReason } from "./route";
+import type { Directive, FlowOptions, StepRef, StoppedReason } from "./flow";
 import type { PersistenceConfig } from "./persistence";
 import type { SessionState } from "./session";
+import type { Signal, SignalFiring } from "./signals";
 import type { StructuredSchema } from "./schema";
-import { Template, ConditionTemplate } from "./template";
+import type { Event } from "./history";
+import type { Template } from "./template";
+import type { ConditionWhen, ConditionIf } from "./flow";
 import type { PromptCacheConfig } from "../core/PromptSectionCache";
+/**
+ * Context passed to every lifecycle hook (flow and step).
+ * Carries the current state and a `dispatch` method for emitting directives
+ * onto the per-turn directive bus.
+ */
+export interface HookContext<TContext = unknown, TData = unknown> {
+    /** Agent-level context. */
+    context: TContext;
+    /** Collected data (partial — fields may be undefined). */
+    data: Partial<TData>;
+    /** Full session state. */
+    session: SessionState<TData>;
+    /** Conversation history as events. */
+    history: Event[];
+    /**
+     * Emit a directive onto the per-turn directive bus.
+     * Multiple `dispatch()` calls are allowed; they merge via Algorithm 4
+     * along with any directive returned from the hook itself.
+     */
+    dispatch(directive: Directive<TContext, TData>): void;
+}
+/**
+ * Reason why a flow was exited, passed to `hooks.onExit`.
+ */
+export type ExitReason = 'completed' | 'goto_flow' | 'goto_step' | 'aborted';
 /**
  * Agent-level compaction configuration.
  * Unlike CompactionOptions, this does not require a `provider` since the agent already has one.
@@ -45,13 +73,7 @@ export interface AgentCompactionConfig {
  */
 export declare enum CompositionMode {
     /** Fluid, natural conversation without strict structure */
-    FLUID = "fluid",
-    /** Canned responses with fluid fallback */
-    CANNED_FLUID = "canned_fluid",
-    /** Composited canned responses */
-    CANNED_COMPOSITED = "composited_canned",
-    /** Strict canned responses only */
-    CANNED_STRICT = "strict_canned"
+    FLUID = "fluid"
 }
 /**
  * Context lifecycle hooks for managing step persistence
@@ -87,14 +109,13 @@ export type ContextProvider<TContext = unknown> = () => Promise<TContext> | TCon
 export interface AgentOptions<TContext = unknown, TData = unknown> {
     /** Display name of the agent */
     name: string;
-    /** Detailed description of the agent's purpose and personality */
-    description?: string;
     /** The agent's primary goal or objective */
     goal?: string;
-    /** Optional personality/tone prompt used in prompts */
-    personality?: Template<TContext>;
-    /** Optional identity prompt defining the agent's self-concept and role */
-    identity?: Template<TContext>;
+    /**
+     * Agent persona — covers role, tone, self-concept, and communication style.
+     * Rendered into the system prompt as "who you are and how you communicate."
+     */
+    persona?: Template<TContext>;
     /** Enable debug logging */
     debug?: boolean;
     /** Default context data available to the agent */
@@ -109,46 +130,53 @@ export interface AgentOptions<TContext = unknown, TData = unknown> {
     hooks?: ContextLifecycleHooks<TContext, TData>;
     /** AI provider strategy for generating responses */
     provider: AiProvider;
-    /** Composition mode for response generation */
-    compositionMode?: CompositionMode;
     /** Initial terms for domain glossary */
     terms?: Term<TContext, TData>[];
-    /** Initial guidelines for agent behavior */
-    guidelines?: Guideline<TContext, TData>[];
-    /** Global tools available to all routes */
+    /**
+     * Instructions for agent behavior — unified primitive.
+     * Each instruction has a `kind`: `'must'` (rule), `'never'` (prohibition), or `'should'` (default, nudge).
+     */
+    instructions?: Instruction<TContext, TData>[];
+    /** Global tools available to all flows */
     tools?: Tool<TContext, TData, unknown>[];
-    /** Initial routes (will be instantiated as Route objects) */
-    routes?: RouteOptions<TContext, TData>[];
+    /** Initial flows (will be instantiated as Flow objects) */
+    flows?: FlowOptions<TContext, TData>[];
     /** Optional persistence configuration for auto-saving sessions and messages */
     persistence?: PersistenceConfig<TData>;
     /** Knowledge base containing any JSON structure the AI should know */
     knowledgeBase?: Record<string, unknown>;
-    /** Absolute rules the agent must follow across all routes */
-    rules?: Template<TContext, TData>[];
-    /** Absolute prohibitions the agent must never do across all routes */
-    prohibitions?: Template<TContext, TData>[];
     /** Agent-level data schema defining the complete data structure for collection */
     schema?: StructuredSchema;
     /** Initial data to pre-populate when creating the agent */
     initialData?: Partial<TData>;
     /**
-     * Margin (0-100) the best alternative route must exceed the current route's score
+     * Margin (0-100) the best alternative flow must exceed the current flow's score
      * by before the agent switches. Higher values make the agent "stickier" to the
-     * current route. Set to 0 to switch whenever any route scores higher.
+     * current flow. Set to 0 to switch whenever any flow scores higher.
      * @default 15
      */
-    routeSwitchMargin?: number;
+    flowSwitchMargin?: number;
+    /**
+    /**
+     * Maximum number of consecutive auto-steps (`auto: true`) that may execute
+     * within a single turn before the pipeline throws `FlowConfigurationError`.
+     * Guards against infinite loops in auto-step chains.
+     *
+     * The default (10) is applied at Agent construction time, not on this type.
+     *
+     * @default 10
+     */
+    maxAutoStepsPerTurn?: number;
     /**
-     * Maximum number of steps to execute in a single batch.
-     * Controls how many consecutive steps can run together in one LLM call.
+     * Maximum number of chained directives allowed within a single turn before
+     * the pipeline throws `FlowConfigurationError`. Guards against infinite
+     * redirection loops (e.g., goTo → onEnter emits goTo → onComplete emits goTo → …).
      *
-     * - `1` (default): Steps execute one at a time (classic behavior)
-     * - `Infinity`: No limit — all eligible steps batch together
-     * - Any positive integer: Cap the batch to that many steps
+     * Chain breakers (`abort` mid-chain) stop counting and apply immediately.
      *
-     * @default 1
+     * @default 10
      */
-    maxStepsPerBatch?: number;
+    maxDirectiveChain?: number;
     /**
      * Optional compaction configuration for managing conversation history size.
      * When provided, the agent will validate the options and make them available
@@ -161,6 +189,29 @@ export interface AgentOptions<TContext = unknown, TData = unknown> {
      * @default { enabled: true }
      */
     promptCache?: PromptCacheConfig;
+    /**
+     * Reserved for future router strategies. v2.0: only `'ai'` is implemented.
+     * Future v2.x widens to `'embedding' | 'rules'` etc.
+     *
+     * Setting any non-`'ai'` value in v2.0 throws `NotImplementedError` at
+     * `Agent` construction time. This is intentional — it surfaces forward-compat
+     * misconfiguration loudly. Future v2.x widens the accepted union without
+     * breaking the throw site (the new value just stops throwing).
+     *
+     * @default 'ai'
+     */
+    routerMode?: 'ai';
+    /**
+     * Signals: typed event detectors that run around the LLM turn.
+     * Empty array or undefined → signal phases are no-ops, zero cost.
+     */
+    signals?: Signal<TContext, TData, any>[];
+    /**
+     * Maximum signals per batched classifier call. Default 10.
+     * If more signals are eligible after gating, they are split into
+     * parallel batches of this size.
+     */
+    signalBatchSize?: number;
 }
 /**
  * A term in the domain glossary
@@ -174,30 +225,87 @@ export interface Term<TContext = unknown, TData = unknown> {
     synonyms?: Template<TContext, TData>[];
 }
 /**
- * A behavioral guideline for the agent
+ * Instruction — unified behavioral primitive.
+ * Collapses v1's `Guideline` (scoped nudge), `Rule` (absolute must-do),
+ * and `Prohibition` (absolute must-not) into a single type with a `kind` discriminator.
+ *
+ * @example
+ * // A "should" (default) — same as a v1 Guideline
+ * { prompt: "Prefer short answers", when: "User asks a simple question" }
+ *
+ * // A "must" — same as a v1 Rule
+ * { kind: 'must', prompt: "Always validate email format before proceeding" }
+ *
+ * // A "never" — same as a v1 Prohibition
+ * { kind: 'never', prompt: "Promise delivery dates you cannot guarantee" }
  */
-export interface Guideline<TContext = unknown, TData = unknown> {
-    /** Unique identifier */
+export interface Instruction<TContext = unknown, TData = unknown> {
+    /** Unique identifier (auto-generated if omitted). */
     id?: string;
-    /** Condition that triggers this guideline (optional for always-active guidelines) */
-    condition?: ConditionTemplate<TContext, TData>;
-    /** Action the agent should take when the condition is met */
-    action: Template<TContext, TData>;
-    /** Whether this guideline is currently enabled */
+    /**
+     * Instruction severity.
+     * - `'must'`  — absolute rule the agent must always follow.
+     * - `'never'` — absolute prohibition the agent must never do.
+     * - `'should'`— behavioral nudge, active when conditions match.
+     *
+     * @default 'should'
+     */
+    kind?: 'must' | 'never' | 'should';
+    /**
+     * AI-evaluated activation condition. String or array of strings (AND semantics).
+     * Undefined = always active. Functions are NOT allowed here — use `if`.
+     */
+    when?: ConditionWhen;
+    /**
+     * Code-evaluated activation condition. Function or array of functions (AND semantics).
+     * Free to evaluate. When both `when` and `if` are set, `if` runs first;
+     * `when` is only evaluated when `if` passes.
+     */
+    if?: ConditionIf<TContext, TData>;
+    /** Behavioral instruction text rendered into the prompt. */
+    prompt: Template<TContext, TData>;
+    /** Whether this instruction is currently enabled. @default true */
     enabled?: boolean;
-    /** Tags for organizing and filtering guidelines */
+    /** Tags for organizing and filtering instructions. */
     tags?: string[];
-    /** Additional metadata */
+    /** Additional metadata. */
     metadata?: Record<string, unknown>;
 }
 /**
- * Guideline match with rationale
+ * Carries the three scope buckets through the prompt pipeline so the composer
+ * can render scope captions correctly.
+ */
+export interface ScopedInstructions<TContext = unknown, TData = unknown> {
+    /** Agent-level — rendered with caption `[Always]`. */
+    global: Instruction<TContext, TData>[];
+    /**
+     * Flow-level — rendered with caption `[In: <FlowTitle>]`.
+     * `flowTitle` is captured here so the composer doesn't need a Flow reference.
+     */
+    flow?: {
+        flowTitle: string;
+        items: Instruction<TContext, TData>[];
+    };
+    /**
+     * Step-level — rendered with caption `[Step: <stepId>]`.
+     * `stepId` is captured here for the same reason.
+     */
+    step?: {
+        stepId: string;
+        items: Instruction<TContext, TData>[];
+    };
+}
+/**
+ * Observability record for an instruction that was active and rendered into a turn's prompt.
+ * Deterministic — derived from rendering, not from LLM self-report.
  */
-export interface GuidelineMatch<TContext = unknown, TData = unknown> {
-    /** The matched guideline */
-    guideline: Guideline<TContext, TData>;
-    /** Explanation of why this guideline was matched */
-    rationale?: string;
+export interface AppliedInstruction {
+    /** The instruction's id */
+    id: string;
+    /** Which scope the instruction originated from */
+    scope: 'global' | 'flow' | 'step';
+    /** FlowTitle for `scope === 'flow'`, stepId for `scope === 'step'`, undefined for `scope === 'global'`. */
+    scopeRef?: string;
 }
 export interface AgentResponse<TData = Record<string, unknown>> {
     message: string;
@@ -206,11 +314,21 @@ export interface AgentResponse<TData = Record<string, unknown>> {
         toolName: string;
         arguments: Record<string, unknown>;
     }>;
-    isRouteComplete?: boolean;
+    isFlowComplete?: boolean;
     /** Steps executed in this response (for multi-step execution) */
     executedSteps?: StepRef[];
     /** Why execution stopped (for multi-step execution) */
     stoppedReason?: StoppedReason;
+    /**
+     * Instructions whose conditions passed and were rendered into this turn's prompt.
+     * Deterministic — derived from rendering, not from LLM self-report.
+     */
+    appliedInstructions?: AppliedInstruction[];
+    /**
+     * Signals that fired during this turn (both pre- and post-phases), in fire order.
+     * Mirrors the observability framing of `executedSteps` and `appliedInstructions`.
+     */
+    triggeredSignals?: SignalFiring<unknown, TData>[];
 }
 export interface AgentResponseStreamChunk<TData = Record<string, unknown>> {
     delta: string;
@@ -221,7 +339,7 @@ export interface AgentResponseStreamChunk<TData = Record<string, unknown>> {
         toolName: string;
         arguments: Record<string, unknown>;
     }>;
-    isRouteComplete?: boolean;
+    isFlowComplete?: boolean;
     /** Steps executed in this response (for multi-step execution) */
     executedSteps?: StepRef[];
     /** Why execution stopped (for multi-step execution) */
@@ -234,6 +352,17 @@ export interface AgentResponseStreamChunk<TData = Record<string, unknown>> {
     };
     structured?: AgentStructuredResponse;
     error?: Error;
+    /**
+     * Instructions whose conditions passed and were rendered into this turn's prompt.
+     * Populated on the final (`done: true`) chunk only.
+     */
+    appliedInstructions?: AppliedInstruction[];
+    /**
+     * Signals that fired during this turn (both pre- and post-phases), in fire order.
+     * Mirrors the observability framing of `executedSteps` and `appliedInstructions`.
+     * Populated on the final (`done: true`) chunk only.
+     */
+    triggeredSignals?: SignalFiring<unknown, TData>[];
 }
 /**
  * Validation error for data validation

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

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

package/dist/cjs/types/agent.js

@@ -11,11 +11,5 @@ var CompositionMode;
 (function (CompositionMode) {
     /** Fluid, natural conversation without strict structure */
     CompositionMode["FLUID"] = "fluid";
-    /** Canned responses with fluid fallback */
-    CompositionMode["CANNED_FLUID"] = "canned_fluid";
-    /** Composited canned responses */
-    CompositionMode["CANNED_COMPOSITED"] = "composited_canned";
-    /** Strict canned responses only */
-    CompositionMode["CANNED_STRICT"] = "strict_canned";
 })(CompositionMode || (exports.CompositionMode = CompositionMode = {}));
 //# sourceMappingURL=agent.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/types/agent.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA2CH;;GAEG;AACH,IAAY,eASX;AATD,WAAY,eAAe;IACzB,2DAA2D;IAC3D,kCAAe,CAAA;IACf,2CAA2C;IAC3C,gDAA6B,CAAA;IAC7B,kCAAkC;IAClC,0DAAuC,CAAA;IACvC,mCAAmC;IACnC,kDAA+B,CAAA;AACjC,CAAC,EATW,eAAe,+BAAf,eAAe,QAS1B"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/types/agent.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAyEH;;GAEG;AACH,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,2DAA2D;IAC3D,kCAAe,CAAA;AACjB,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}

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

@@ -67,9 +67,9 @@ export interface GenerateMessageInput<TContext = unknown> {
 export interface AgentStructuredResponse extends Record<string, unknown> {
     /** The actual message to send to the user */
     message: string;
-    /** Route chosen by the agent (route title or null if no route) */
-    route?: string | null;
-    /** Current step within the route (step description or null) */
+    /** Flow chosen by the agent (flow title or null if no flow) */
+    flow?: string | null;
+    /** Current step within the flow (step description or null) */
     step?: string | null;
     /** Tool calls the agent wants to execute */
     toolCalls?: Array<{

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Typed error classes for @falai/agent.
+ */
+/**
+ * Typed error for not-yet-implemented surface. Subclass of Error (not of
+ * FlowConfigurationError) so handlers can distinguish "not yet built" from
+ * "misconfigured".
+ *
+ * Thrown when a reserved option is set to a value that the current version
+ * does not support (e.g. `routerMode: 'embedding'` in v2.0).
+ */
+export declare class NotImplementedError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI9B"}

package/dist/cjs/types/errors.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Typed error classes for @falai/agent.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotImplementedError = void 0;
+/**
+ * Typed error for not-yet-implemented surface. Subclass of Error (not of
+ * FlowConfigurationError) so handlers can distinguish "not yet built" from
+ * "misconfigured".
+ *
+ * Thrown when a reserved option is set to a value that the current version
+ * does not support (e.g. `routerMode: 'embedding'` in v2.0).
+ */
+class NotImplementedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NotImplementedError';
+    }
+}
+exports.NotImplementedError = NotImplementedError;
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;;;;;;GAOG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ;AALD,kDAKC"}