@falai/agent 1.2.7 → 2.0.0

package/dist/types/persistence.d.ts

@@ -16,7 +16,7 @@ export interface SessionData<TData = Record<string, unknown>> {
     userId?: string;
     agentName?: string;
     status: SessionStatus;
-    currentRoute?: string;
+    currentFlow?: string;
     currentStep?: string;
     collectedData?: CollectedStateData<TData>;
     messageCount?: number;
@@ -37,11 +37,15 @@ export type CreateSessionData<TData = Record<string, unknown>> = Omit<SessionDat
  */
 export interface CollectedStateData<TData = Record<string, unknown>> {
     data: Partial<TData>;
-    routeHistory: SessionState<TData>["routeHistory"];
+    flowHistory: SessionState<TData>["flowHistory"];
     history?: SessionState<TData>["history"];
-    currentRouteTitle?: string;
+    currentFlowTitle?: string;
     currentStepDescription?: string;
     metadata: SessionState<TData>["metadata"];
+    /** Pending directive — included only when a directive is actually present. */
+    pendingDirective?: SessionState<TData>["pendingDirective"];
+    /** Reserved for v2.x Signals. Passed through bit-identical. */
+    signals?: SessionState<TData>["signals"];
 }
 /**
  * Base message data structure
@@ -52,7 +56,7 @@ export interface MessageData {
     userId?: string;
     role: MessageRole;
     content: string;
-    route?: string;
+    flow?: string;
     step?: string;
     toolCalls?: Array<{
         toolName: string;
@@ -95,9 +99,9 @@ export interface SessionRepository<TData = Record<string, unknown>> {
      */
     updateCollectedData(id: string, collectedData: CollectedStateData<TData>): Promise<SessionData<TData> | null>;
     /**
-     * Update current route and step
+     * Update current flow and step
      */
-    updateRouteStep(id: string, route?: string, step?: string): Promise<SessionData<TData> | null>;
+    updateFlowStep(id: string, flow?: string, step?: string): Promise<SessionData<TData> | null>;
     /**
      * Increment message count
      */
@@ -198,7 +202,7 @@ export interface SaveMessageOptions {
     userId?: string;
     role: MessageRole;
     content: string;
-    route?: string;
+    flow?: string;
     step?: string;
     toolCalls?: Array<{
         toolName: string;

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

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

package/dist/types/routing.d.ts

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

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

@@ -1 +1 @@
-{"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,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,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"}
+{"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/session.d.ts

@@ -2,54 +2,55 @@
  * Session step types for tracking conversation progress
  */
 import type { History } from "./history";
-/**
- * Pending route transition information
- */
-export interface PendingTransition {
-    /** Target route ID to transition to */
-    targetRouteId: string;
-    /** Optional AI-evaluated condition for the transition */
-    condition?: string;
-    /** Reason for the transition */
-    reason: "route_complete" | "manual";
-}
+import type { Directive } from "./flow";
+import type { SignalsState } from "./signals";
+export type { SignalsState, SignalTriggerState } from "./signals";
 /**
  * Session state tracks the current position in the conversation flow
- * and data collected at the agent level across all routes
+ * and data collected at the agent level across all flows
  */
 export interface SessionState<TData = unknown> {
     /** Unique session identifier (useful for persistence) */
     id: string;
-    /** Current route the conversation is in */
-    currentRoute?: {
+    /** Current flow the conversation is in */
+    currentFlow?: {
         id: string;
         title: string;
         enteredAt?: Date;
     };
-    /** Current step within the route */
+    /** Current step within the flow */
     currentStep?: {
         id: string;
         description?: string;
         enteredAt?: Date;
     };
     /**
-     * Agent-level data collected across all routes
+     * Agent-level data collected across all flows
      * This is the single source of truth for all collected data
-     * Routes can access and contribute to this shared data structure
+     * Flows can access and contribute to this shared data structure
      */
     data: Partial<TData>;
-    /** History of routes visited in this session */
-    routeHistory?: Array<{
-        routeId: string;
+    /** History of flows visited in this session */
+    flowHistory?: Array<{
+        flowId: string;
         enteredAt?: Date;
         exitedAt?: Date;
         completed: boolean;
     }>;
     /**
-     * Pending route transition after completion
-     * Set when a route completes with onComplete handler
+     * Pending directive to apply at the start of the next turn.
+     * Replaces the v1 `pendingTransition` field. When set, the turn pipeline
+     * applies this directive and skips `FlowRouter.decideFlowAndStep`.
+     *
+     * Cleared after application unless `complete.next` chains another directive.
+     */
+    pendingDirective?: Directive<unknown, TData>;
+    /**
+     * Reserved for v2.x Signals feature. v2.0 does not read or mutate this
+     * field at runtime — persistence adapters preserve it bit-identical through
+     * save → load roundtrips. See Decision D-Q6 in design.md.
      */
-    pendingTransition?: PendingTransition;
+    signals?: SignalsState;
     /**
      * Conversation history managed by the session
      * Contains the full conversation between user and assistant

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,MAAM,EAAE,gBAAgB,GAAG,QAAQ,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,OAAO;IAC3C,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IAEX,2CAA2C;IAC3C,YAAY,CAAC,EAAE;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,CAAC;IAEF,oCAAoC;IACpC,WAAW,CAAC,EAAE;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,CAAC;IAEF;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAErB,gDAAgD;IAChD,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,QAAQ,CAAC,EAAE,IAAI,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IAEH;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,uBAAuB;IACvB,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,aAAa,CAAC,EAAE,IAAI,CAAC;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,OAAO;IAC3C,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IAEX,0CAA0C;IAC1C,WAAW,CAAC,EAAE;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,CAAC;IAEF,mCAAmC;IACnC,WAAW,CAAC,EAAE;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,CAAC;IAEF;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAErB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,QAAQ,CAAC,EAAE,IAAI,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IAEH;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAE7C;;;;OAIG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,uBAAuB;IACvB,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,aAAa,CAAC,EAAE,IAAI,CAAC;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH"}

package/dist/types/signals.d.ts

@@ -0,0 +1,248 @@
+/**
+ * Signals types for v2.x.
+ *
+ * This is the canonical location for all signals-related types.
+ * `SignalsState` and `SignalTriggerState` originated in `session.ts` as v2.0
+ * forward-compat reservations and are re-exported from there for backward
+ * compatibility within the same major.
+ */
+import type { SessionState } from "./session";
+import type { PreDirective } from "./flow";
+import type { Event } from "./history";
+/**
+ * Per-signal trigger tracking state.
+ * Shape is locked to enable forward-compatible persistence in v2.0.
+ */
+export interface SignalTriggerState {
+    /** When this signal first fired. */
+    firstTriggeredAt: Date;
+    /** When this signal last fired. */
+    lastTriggeredAt: Date;
+    /** Total number of times this signal has fired. */
+    count: number;
+    /** Free-text reason from the last trigger (if the signal supplied one). */
+    lastReason?: string;
+    /** Which phase the signal last fired in. */
+    lastPhase?: 'pre' | 'post';
+}
+/**
+ * Aggregated signals state stored on the session.
+ * Shape is locked to enable forward-compatible persistence in v2.0.
+ */
+export interface SignalsState {
+    /** Per-signal trigger tracking; keyed by signal id. */
+    triggers: Record<string, SignalTriggerState>;
+}
+/**
+ * Schema for extraction signals. JSON Schema subset or Zod-compatible shape.
+ * The framework uses this to build the per-signal `extracted` field in the
+ * classifier response schema.
+ *
+ * When set on a signal, the signal operates in extraction mode: the classifier
+ * call includes this schema in the response format, and the handler receives
+ * `extracted: TExtract` when the signal matches.
+ *
+ * The type parameter `_T` is a phantom type that carries the extraction shape
+ * for downstream inference — the runtime value is always a JSON Schema object.
+ */
+export type SignalSchema<_T = unknown> = Record<string, unknown>;
+/**
+ * Context passed to signal `if` predicates.
+ * Symmetric with `BranchPredicateContext` used by branches.
+ */
+export interface SignalPredicateContext<TContext = unknown, TData = unknown> {
+    /** Collected data (partial — null-check fields not guaranteed). */
+    data: Partial<TData>;
+    /** Agent-level context. */
+    context: TContext;
+    /** Full session state. */
+    session: SessionState<TData>;
+    /** Conversation history as events. */
+    history: Event[];
+}
+/**
+ * Code-evaluated predicate for signal `if` conditions.
+ * Returns `true` to pass (signal proceeds to `when` evaluation or fires),
+ * `false` to skip (signal is not evaluated this turn).
+ *
+ * Predicates evaluate BEFORE `when` conditions — code-first short-circuit.
+ * If `if` returns false, `when` is NOT evaluated (token-saving).
+ *
+ * If a predicate throws, the signal is treated as non-match and other
+ * signals continue evaluation.
+ */
+export type SignalPredicate<TContext = unknown, TData = unknown> = (ctx: SignalPredicateContext<TContext, TData>) => boolean | Promise<boolean>;
+/**
+ * SignalDirective — what signal handlers return.
+ * Extends `PreDirective` (which extends `Directive`). Adds signal-specific
+ * fields: `stopOtherSignals` and `replyWith`.
+ *
+ * All position-control (`goTo`, `goToStep`, `complete`, `abort`, `reset`),
+ * state writes (`dataUpdate`, `contextUpdate`), prompt augmentation
+ * (`appendPrompt`, `injectTools`), `reply`, and `halt` are inherited unchanged.
+ *
+ * Post-phase drop rules: when returned in the post-phase, `appendPrompt`,
+ * `injectTools`, and `halt` are dropped with a debug warning — they have
+ * no meaning after the LLM call has already completed.
+ */
+export interface SignalDirective<TContext = unknown, TData = unknown> extends PreDirective<TContext, TData> {
+    /**
+     * Stop processing remaining signals for this phase after this handler.
+     * Does not affect the other phase.
+     */
+    stopOtherSignals?: boolean;
+    /**
+     * Verbatim reply with optional late-binding (function form).
+     * - String: same as `Directive.reply`.
+     * - Function: evaluated at emit time; result projects onto `Directive.reply`.
+     *
+     * The field is resolved and stripped before reaching the directive merge bus.
+     */
+    replyWith?: string | ((ctx: SignalContext<TContext, TData>) => string);
+}
+/**
+ * Context passed to signal handlers when a signal fires.
+ * Symmetric with `ToolContext` — provides session state and writer methods.
+ *
+ * The `updateContext` and `updateData` writers follow the same D-Q12 contract
+ * as `ToolContext` writers.
+ */
+export interface SignalContext<TContext = unknown, TData = unknown, TExtract = void> {
+    /** The signal definition that fired. */
+    signal: Signal<TContext, TData, TExtract>;
+    /** Phase in which this signal fired. */
+    phase: 'pre' | 'post';
+    /** Whether the signal matched (always `true` when handler runs). */
+    matched: true;
+    /** AI rationale when `when` matched, or `'code-only'` / `'unconditional'`. */
+    reason: string;
+    /**
+     * Extracted data when the signal has `extract` set. Typed via the
+     * TExtract generic. Undefined for detection-only signals.
+     */
+    extracted: TExtract extends void ? undefined : TExtract;
+    /** Session state. Use writers below for mutations. */
+    session: SessionState<TData>;
+    /** Agent-level context. */
+    context: TContext;
+    /** Collected data (partial). */
+    data: Partial<TData>;
+    /** Conversation history as events. */
+    history: Event[];
+    /** Last user message (convenience). */
+    lastUserMessage?: string;
+    /** Timestamp when the signal fired. */
+    triggeredAt: Date;
+    /** Update agent context (same signature as ToolContext.updateContext). */
+    updateContext: (updates: Partial<TContext>) => Promise<void>;
+    /** Update collected data (same signature as ToolContext.updateData). */
+    updateData: (updates: Partial<TData>) => Promise<void>;
+    /** Imperative directive emission onto the per-turn bus. */
+    dispatch(directive: SignalDirective<TContext, TData>): void;
+}
+/**
+ * A signal: a typed event detector (and optional data extractor) that runs
+ * around an LLM turn.
+ *
+ * Conditions use the v2 `when` / `if` split:
+ * - `when`: AI-evaluated string(s). Entries prefixed with `!` are exclusion
+ *   conditions rendered under "DO NOT TRIGGER WHEN" in the classifier prompt.
+ *   Non-prefixed entries render under "TRIGGER WHEN". Positive entries use AND
+ *   semantics (all must match). Negative entries use OR semantics (any match
+ *   inhibits firing).
+ * - `if`: Code-evaluated function(s). Free. AND semantics.
+ *
+ * When both `if` and `when` are set, `if` evaluates first. If `if` returns
+ * false, `when` is not evaluated (token-saving).
+ *
+ * Signals with neither `when` nor `if` are unconditional — they always fire
+ * (subject to behavior gating). If `extract` is set on an unconditional signal,
+ * the extraction runs every turn.
+ */
+export interface Signal<TContext = unknown, TData = unknown, TExtract = void> {
+    /** Unique identifier. Auto-generated if omitted (stable within session). */
+    id?: string;
+    /** Display title (shown in logs and traces). */
+    title?: string;
+    /** Free-text description of what this signal detects. */
+    description?: string;
+    /**
+     * AI-evaluated trigger condition(s). String or array of strings.
+     * - Non-prefixed entries: AND semantics. All must match to trigger.
+     * - `!`-prefixed entries: OR exclusion. Any match inhibits firing.
+     *
+     * At prompt-render time, the framework splits entries by prefix:
+     * - Non-`!` → rendered under "TRIGGER WHEN"
+     * - `!` → stripped of prefix, rendered under "DO NOT TRIGGER WHEN"
+     */
+    when?: string | string[];
+    /**
+     * Code predicate(s). Function or array of functions (AND).
+     * Free to evaluate; runs before `when`. If `if` returns false, the
+     * signal is skipped — `when` is not evaluated.
+     */
+    if?: SignalPredicate<TContext, TData> | SignalPredicate<TContext, TData>[];
+    /**
+     * Optional structured extraction schema. When set, the signal operates
+     * in extraction mode: the classifier call includes this schema in the
+     * response format, and the handler receives `extracted: TExtract` when
+     * the signal matches.
+     *
+     * Extraction signals participate in the same batched classifier call as
+     * detection signals. The merged response schema includes each signal's
+     * extraction fields alongside the standard `matched` / `reason`.
+     *
+     * When absent, the signal operates in detection mode (boolean match).
+     */
+    extract?: SignalSchema<TExtract>;
+    /**
+     * When this signal evaluates relative to the LLM call.
+     * - `'pre'`: before the LLM call (parallel with routing).
+     * - `'post'`: after the LLM call (sequential, after finalize).
+     * - `'both'`: evaluated in both phases.
+     */
+    phase: 'pre' | 'post' | 'both';
+    /**
+     * Handler invoked when the signal fires. Receives match info and
+     * extracted data (if applicable). Returns void or a SignalDirective.
+     */
+    handler: (ctx: SignalContext<TContext, TData, TExtract>) => void | SignalDirective<TContext, TData> | Promise<void | SignalDirective<TContext, TData>>;
+    /**
+     * Rate-limit / dedup behavior:
+     * - `'once'`: fire once per session.
+     * - `'always'`: fire every match (default).
+     * - `'cooldown'`: fire, then suppress for `cooldownMs`.
+     */
+    behavior?: 'once' | 'always' | 'cooldown';
+    /** Cooldown duration in ms. Required when `behavior === 'cooldown'`. */
+    cooldownMs?: number;
+    /** Whether this signal is currently enabled. @default true */
+    enabled?: boolean;
+    /**
+     * Higher priority signals fire first within a phase. Default 0.
+     * Tie: declaration order in `agent.signals`.
+     */
+    priority?: number;
+}
+/**
+ * Observability record for a signal that fired during a turn.
+ * Populated in fire order across both pre- and post-phases.
+ * Mirrors the observability framing of `executedSteps` and `appliedGuidelines`.
+ */
+export interface SignalFiring<TContext = unknown, TData = unknown> {
+    /** The signal's unique identifier. */
+    id: string;
+    /** Which phase the signal fired in. */
+    phase: 'pre' | 'post';
+    /** AI rationale when `when` matched, or 'code-only' / 'unconditional'. */
+    reason?: string;
+    /** Extracted data when the signal operates in extraction mode. */
+    extracted?: unknown;
+    /** The directive returned by the signal handler (if any). */
+    directive?: SignalDirective<TContext, TData>;
+    /** Error message if the handler threw. */
+    handlerError?: string;
+    /** Wall-clock duration of the handler invocation in milliseconds. */
+    durationMs?: number;
+}
+//# sourceMappingURL=signals.d.ts.map

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

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

package/dist/types/signals.js

@@ -0,0 +1,10 @@
+/**
+ * Signals types for v2.x.
+ *
+ * This is the canonical location for all signals-related types.
+ * `SignalsState` and `SignalTriggerState` originated in `session.ts` as v2.0
+ * forward-compat reservations and are re-exported from there for backward
+ * compatibility within the same major.
+ */
+export {};
+//# sourceMappingURL=signals.js.map

package/dist/types/signals.js.map

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

package/dist/types/template.d.ts

@@ -17,14 +17,14 @@ export interface TemplateContext<TContext = unknown, TData = unknown> {
      */
     history?: Event[];
     /**
-     * The data collected in the current route.
+     * The data collected in the current flow.
      * A convenience alias for `session.data`.
      */
     data: Partial<TData>;
     /**
      * Helper methods for working with history and context.
      */
-    helpers: {
+    helpers?: {
         /**
          * Get the last message from history, optionally filtered by role.
          * @param role - Optional role to filter by (user, assistant, etc.)
@@ -61,12 +61,6 @@ export interface TemplateContext<TContext = unknown, TData = unknown> {
  * that dynamically generates a string from context.
  */
 export type Template<TContext = unknown, TData = unknown> = string | ((params: TemplateContext<TContext, TData>) => string | Promise<string>);
-/**
- * Represents a condition that can be used for routing decisions.
- * Supports strings (AI context only), boolean functions (programmatic evaluation),
- * and arrays of either for complex condition logic.
- */
-export type ConditionTemplate<TContext = unknown, TData = unknown> = string | ((params: TemplateContext<TContext, TData>) => boolean | Promise<boolean>) | ConditionTemplate<TContext, TData>[];
 /**
  * Result of condition evaluation containing both programmatic results
  * and AI context strings.

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

@@ -1 +1 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/types/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAClE;;OAEG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE;QACP;;;;WAIG;QACH,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;QAEvD;;;WAGG;QACH,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAAC;QAEzC;;;WAGG;QACH,uBAAuB,IAAI,MAAM,GAAG,SAAS,CAAC;QAE9C;;;;WAIG;QACH,WAAW,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAAC;QAE1C;;;;;WAKG;QACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;KACpF,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,IACpD,MAAM,GACN,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,IAC7D,MAAM,GACN,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,GAC1E,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;AAEzC;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,0CAA0C;IAC1C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,2CAA2C;IAC3C,yBAAyB,EAAE,OAAO,CAAC;IACnC,oDAAoD;IACpD,iBAAiB,CAAC,EAAE;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;KACvC,EAAE,CAAC;CACL"}
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/types/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAClE;;OAEG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE;QACR;;;;WAIG;QACH,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;QAEvD;;;WAGG;QACH,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAAC;QAEzC;;;WAGG;QACH,uBAAuB,IAAI,MAAM,GAAG,SAAS,CAAC;QAE9C;;;;WAIG;QACH,WAAW,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAAC;QAE1C;;;;;WAKG;QACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;KACpF,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,IACpD,MAAM,GACN,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAI7E;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,0CAA0C;IAC1C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,2CAA2C;IAC3C,yBAAyB,EAAE,OAAO,CAAC;IACnC,oDAAoD;IACpD,iBAAiB,CAAC,EAAE;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;KACvC,EAAE,CAAC;CACL"}

package/dist/types/tool.d.ts

@@ -2,6 +2,7 @@
  * Tool system type definitions
  */
 import type { Event, StepRef, ValidationResult } from "./index";
+import type { Directive } from "./flow";
 /**
  * Context provided to tool handlers
  */
@@ -12,7 +13,7 @@ export interface ToolContext<TContext = any, TData = any> {
     data: Partial<TData>;
     /** Interaction history */
     history: Event[];
-    /** Current step reference (if in a route) */
+    /** Current step reference (if in a flow) */
     step?: StepRef;
     /** Additional metadata */
     metadata?: Record<string, unknown>;
@@ -26,6 +27,15 @@ export interface ToolContext<TContext = any, TData = any> {
     setField<K extends keyof TData>(key: K, value: TData[K]): Promise<void>;
     /** Check if a field exists in collected data */
     hasField<K extends keyof TData>(key: K): boolean;
+    /**
+     * Emit a directive into the per-turn bus. Identical effect to returning
+     * `{ directive }` from the tool handler, but usable mid-handler (e.g.,
+     * after an early-exit branch decides the rest of the turn is moot).
+     *
+     * Multiple `dispatch()` calls in one handler are allowed; they are merged
+     * by Algorithm 4 along with directives from other tools/hooks this turn.
+     */
+    dispatch(directive: Directive<TContext, TData>): void;
 }
 /**
  * Result returned by a tool
@@ -43,25 +53,43 @@ export interface ToolResult<TResultData = any, TContext = any, TData = any> {
     error?: string;
     /** Optional metadata about the execution */
     meta?: Record<string, unknown>;
+    /** Emit a directive declaratively (alternative to ctx.dispatch). */
+    directive?: Directive<TContext, TData>;
 }
 /**
  * Handler function for a tool
  */
 export type ToolHandler<TContext = any, TData = any, TResult = any> = (context: ToolContext<TContext, TData>, args?: Record<string, unknown>) => Promise<TResult | ToolResult<TResult, TContext, TData>> | TResult | ToolResult<TResult, TContext, TData>;
 /**
- * Tool definition - plain object interface
+ * Tool definition - single unified type (v2).
+ *
+ * In v1 there were two tool types: `Tool` (basic) and `EnhancedTool`
+ * (with metadata). v2 merges these into a single `Tool` type with all
+ * metadata fields optional. `EnhancedTool` is removed from the public surface.
  */
 export interface Tool<TContext = any, TData = any, TResult = any> {
     /** Tool identifier */
     id: string;
-    /** Tool display name (shown to AI models) */
-    name?: string;
     /** Tool handler function */
     handler: ToolHandler<TContext, TData, TResult>;
     /** Description of what the tool does (for AI discovery) */
     description?: string;
     /** Parameter schema or description */
     parameters?: unknown;
+    /** Whether this tool is safe to run concurrently with other concurrent-safe tools */
+    isConcurrencySafe?(input?: Record<string, unknown>): boolean;
+    /** Whether this tool only reads data without side effects */
+    isReadOnly?(input?: Record<string, unknown>): boolean;
+    /** Whether this tool performs destructive/irreversible operations */
+    isDestructive?(input?: Record<string, unknown>): boolean;
+    /** How the tool responds to abort signals: 'cancel' = immediate abort, 'block' = allow completion */
+    interruptBehavior?(): 'cancel' | 'block';
+    /** Maximum characters for the tool result before truncation */
+    maxResultSizeChars?: number;
+    /** Validate input before execution */
+    validateInput?(input: Record<string, unknown>, context: ToolContext<TContext, TData>): Promise<ToolValidationResult> | ToolValidationResult;
+    /** Check permissions before execution — when denied, handler is NOT invoked */
+    checkPermissions?(input: Record<string, unknown>, context: ToolContext<TContext, TData>): Promise<ToolPermissionResult> | ToolPermissionResult;
 }
 /**
  * Tool execution result
@@ -73,13 +101,15 @@ export interface ToolExecutionResult {
     contextUpdate?: Record<string, unknown>;
     dataUpdate?: Record<string, unknown>;
     metadata?: Record<string, unknown>;
+    /** Directives collected during tool execution (from ctx.dispatch and/or result.directive). */
+    directives?: Directive[];
 }
 /**
  * Tool scope enumeration
  */
 export declare enum ToolScope {
     AGENT = "agent",
-    ROUTE = "route",
+    FLOW = "flow",
     STEP = "step",
     REGISTERED = "registered",
     ALL = "all"
@@ -138,36 +168,13 @@ export type ToolStatus = 'queued' | 'executing' | 'completed' | 'yielded';
 export interface TrackedTool<TContext = unknown, TData = unknown> {
     id: string;
     toolCall: ToolCallRequest;
-    tool: EnhancedTool<TContext, TData>;
+    tool: Tool<TContext, TData>;
     status: ToolStatus;
     isConcurrencySafe: boolean;
     promise?: Promise<void>;
     results: ToolExecutionResult[];
     pendingProgress: string[];
 }
-/**
- * Extended tool interface with rich metadata for concurrency control,
- * permission gating, input validation, and result size management.
- *
- * All additional methods/properties are optional — plain `Tool` objects
- * remain fully compatible.
- */
-export interface EnhancedTool<TContext = any, TData = any, TResult = any> extends Tool<TContext, TData, TResult> {
-    /** Whether this tool is safe to run concurrently with other concurrent-safe tools */
-    isConcurrencySafe?(input?: Record<string, unknown>): boolean;
-    /** Whether this tool only reads data without side effects */
-    isReadOnly?(input?: Record<string, unknown>): boolean;
-    /** Whether this tool performs destructive/irreversible operations */
-    isDestructive?(input?: Record<string, unknown>): boolean;
-    /** How the tool responds to abort signals: 'cancel' = immediate abort, 'block' = allow completion */
-    interruptBehavior?(): 'cancel' | 'block';
-    /** Maximum characters for the tool result before truncation */
-    maxResultSizeChars?: number;
-    /** Validate input before execution */
-    validateInput?(input: Record<string, unknown>, context: ToolContext<TContext, TData>): Promise<ToolValidationResult> | ToolValidationResult;
-    /** Check permissions before execution */
-    checkPermissions?(input: Record<string, unknown>, context: ToolContext<TContext, TData>): Promise<ToolPermissionResult> | ToolPermissionResult;
-}
 /**
  * Configuration for data enrichment tools
  */