@falai/agent 3.4.4 → 4.0.0-alpha.1

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

@@ -1,415 +1,185 @@
 /**
- * Agent-related type definitions
+ * Agent options and the one entry point: `turn`.
  */
-import type { AgentStructuredResponse, AiProvider } from "./ai.js";
+import type { AiProvider, TokenUsage } from "./ai.js";
+import type { ActionMap, ConditionMap, EventMap, FieldDefs, Flow, Instruction, Template } from "./flow.js";
+import type { History } from "./history.js";
+import type { Run, Session, StepOutcome, StepOutcomeCode } from "./session.js";
 import type { Tool } from "./tool.js";
-import type { Directive, FlowOptions, StepRef, StoppedReason } from "./flow.js";
-import type { PersistenceConfig } from "./persistence.js";
-import type { SessionState } from "./session.js";
-import type { Signal, SignalFiring } from "./signals.js";
-import type { StructuredSchema } from "./schema.js";
-import type { Event } from "./history.js";
-import type { Template } from "./template.js";
-import type { ConditionWhen, ConditionIf } from "./flow.js";
-import type { PromptCacheConfig } from "./prompt-cache.js";
+/** Returns "now". Tests pass a fake clock. */
+export type Clock = () => Date;
+/** Moves a time forward to the next working moment. Snaps, never clamps. */
+export type BusinessHours<C = unknown> = (at: Date, ctx: {
+    context: C;
+}) => Date;
 /**
- * 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.
+ * The one speaker that is not a step: answers when no run holds the floor.
+ * `'silent'` mutes it.
  */
-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;
-}
+export type Idle<C = unknown, D = unknown> = {
+    prompt: Template;
+    tools?: string[];
+    instructions?: Instruction<C, D>[];
+} | "silent";
 /**
- * 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.
+ * Agent-level compaction configuration. `provider` comes from the agent.
  */
 export interface AgentCompactionConfig {
-    /** Maximum token budget for the conversation */
+    /** Maximum token budget for the conversation. */
     maxTokens: number;
-    /**
-     * Threshold ratio (0–1) at which to trigger compaction.
-     * Must be between 0.5 and 0.95.
-     * @default 0.8
-     */
+    /** Ratio (0.5–0.95) at which to compact. Default 0.8. */
     compactionThreshold?: number;
-    /**
-     * Number of recent messages to always preserve unchanged.
-     * Must be >= 2.
-     * @default 4
-     */
+    /** Recent messages always kept unchanged (>= 2). Default 4. */
     preserveRecentCount?: number;
-    /**
-     * Maximum characters per tool result before truncation.
-     * Must be > 0.
-     * @default 5000
-     */
+    /** Characters per tool result before truncation (> 0). Default 5000. */
     maxToolResultChars?: number;
-    /**
-     * Whether compaction is enabled.
-     * @default true when config is provided
-     */
+    /** Default true when the config is present. */
     enabled?: boolean;
 }
-/**
- * Context lifecycle hooks for managing step persistence
- */
-export interface ContextLifecycleHooks<TContext = unknown, TData = unknown> {
-    /**
-     * Called before respond() to get fresh context
-     * Useful for loading context from a database or cache
-     */
-    beforeRespond?: (currentContext: TContext) => Promise<TContext> | TContext;
-    /**
-     * Called after context is updated via updateContext() or tool execution
-     * Useful for persisting context to a database or cache
-     */
-    onContextUpdate?: (newContext: TContext, previousContext: TContext) => Promise<void> | void;
-    /**
-     * Called after collected data is updated (from AI response or tool execution)
-     * Useful for validation, enrichment, or persistence of collected data
-     * Return modified collected data or the same data to keep it unchanged
-     *
-     * Note: This hook now works with agent-level data collection (TData type)
-     */
-    onDataUpdate?: (data: Partial<TData>, previousCollected: Partial<TData>) => Partial<TData> | Promise<Partial<TData>>;
-}
-/**
- * Context provider function for always-fresh context
- * Alternative to static context, useful for loading from external sources
- */
-export type ContextProvider<TContext = unknown> = () => Promise<TContext> | TContext;
-/**
- * Options for creating an Agent
- */
-export interface AgentOptions<TContext = unknown, TData = unknown> {
-    /** Display name of the agent */
+export interface AgentOptions<C = unknown, D = unknown> {
     name: string;
-    /** The agent's primary goal or objective */
-    goal?: string;
-    /**
-     * 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>;
-    /**
-     * Hard bound on session.history length (default: 400). The oldest entries
-     * are trimmed — never splitting an assistant/tool pair — when the bound is
-     * exceeded and no compaction strategy shrank the history first. Set 0 to
-     * disable bounding entirely.
-     */
-    maxHistoryMessages?: number;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Default context data available to the agent */
-    context?: TContext;
-    /** Optional current session for convenience methods */
-    session?: SessionState;
-    /** Optional sessionId to load or create - managed by SessionManager */
-    sessionId?: string;
-    /** Context provider function for always-fresh context (alternative to static context) */
-    contextProvider?: ContextProvider<TContext>;
-    /** Lifecycle hooks for context management */
-    hooks?: ContextLifecycleHooks<TContext, TData>;
-    /** AI provider for generating responses */
+    /** What the agent is for. */
+    goal?: Template;
+    /** Who the agent is and how it talks. */
+    persona?: Template;
     provider: AiProvider;
-    /** Initial terms for domain glossary */
-    terms?: Term<TContext, TData>[];
-    /**
-     * 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 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 */
+    /** Every collectable field, authored once. */
+    fields: FieldDefs;
+    flows?: Flow<C, D>[];
+    /** Host actions `do` steps may name. */
+    actions?: ActionMap<C, D>;
+    /** Host events triggers and waits may name. */
+    events?: EventMap;
+    /** Host conditions JSON predicates may name. */
+    conditions?: ConditionMap<C, D>;
+    tools?: Tool<C, D>[];
+    instructions?: Instruction<C, D>[];
+    /** Any JSON the AI should know. */
     knowledgeBase?: Record<string, unknown>;
-    /** 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 flow must exceed the current flow's score
-     * by before the agent switches. Higher values make the agent "stickier" to the
-     * current flow. Set to 0 to switch whenever any flow scores higher.
-     * @default 15
-     */
-    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 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 → …).
-     *
-     * Chain breakers (`abort` mid-chain) stop counting and apply immediately.
-     *
-     * @default 10
-     */
-    maxDirectiveChain?: number;
-    /**
-     * Maximum number of tool loop iterations allowed within a single response
-     * generation before the pipeline stops executing further tool calls.
-     * Guards against runaway recursive tool calling. An explicit `0` is honored
-     * (no tool loops). Applies to both `respond()` and streaming paths.
-     *
-     * @default 5
-     */
+    idle?: Idle<C, D>;
+    clock?: Clock;
+    businessHours?: BusinessHours<C>;
+    /** Tool rounds per speak call. Default 5; 0 disables tools. */
     maxToolLoops?: number;
-    /**
-     * Optional compaction configuration for managing conversation history size.
-     * When provided, the agent will validate the options and make them available
-     * for use by the SessionManager/CompactionEngine.
-     */
+    /** Trim the history both calls see, once per turn, when it grows past `maxTokens`. */
     compaction?: AgentCompactionConfig;
-    /**
-     * Optional prompt cache configuration for controlling section memoization behavior.
-     * When provided, controls whether prompt sections are cached across turns.
-     * @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
- */
-export interface Term<TContext = unknown, TData = unknown> {
-    /** Name of the term */
-    name: Template<TContext, TData>;
-    /** Description/definition of the term */
-    description: Template<TContext, TData>;
-    /** Alternative names or synonyms */
-    synonyms?: Template<TContext, TData>[];
+    debug?: boolean;
 }
-/**
- * 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 Instruction<TContext = unknown, TData = unknown> {
-    /** Unique identifier (auto-generated if omitted). */
+/** The host's reason the assistant cannot speak. Zero calls unless `understand: true`. */
+export type Silenced = string | {
+    reason: string;
+    understand?: boolean;
+};
+type ContextField<C> = undefined extends C ? {
+    context?: C;
+} : {
+    context: C;
+};
+export type TurnBase<C = unknown, D = unknown> = ContextField<C> & {
+    sessionId: string;
+    /** Absent on a first turn. A wake never creates a session. */
+    session?: Session<D>;
+    /** Pass on every input kind, wakes included. */
+    history?: History;
+    silenced?: Silenced;
+    /** Host anchors this session belongs to, e.g. `{ lead: { key: 'lead:456', lastInboundAt } }`. */
+    anchors?: Record<string, {
+        key: string;
+        lastInboundAt?: string;
+    }>;
+    /** Claims held in the lead's other sessions: `dedupeKey → at`, and live `${flowId}:${anchor}` pairs. */
+    claims?: {
+        held: Record<string, string>;
+        active: string[];
+    };
+};
+export type TurnKind = 
+/** The lead wrote. Hosts pass the channel id and receipt time. */
+{
+    message: string;
     id?: string;
-    /**
-     * 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. Non-`!` strings are OR alternatives;
-     * `!` strings are OR exclusions where any match inhibits the instruction.
-     * 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 instructions. */
-    tags?: string[];
-    /** Additional metadata. */
-    metadata?: Record<string, unknown>;
+    at?: string;
 }
-/**
- * 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>[];
+/** A scheduled wake fired; the key came from `schedule[]`. */
+ | {
+    wake: string;
+}
+/** Something happened in the host. */
+ | {
+    event: string;
+    payload?: unknown;
+    key: string;
+    hop?: number;
+}
+/** Start a flow by hand. */
+ | {
+    start: {
+        flow: string;
+        input?: unknown;
+        key: string;
+        hop?: number;
     };
-    /**
-     * Step-level — rendered with caption `[Step: <stepId>]`.
-     * `stepId` is captured here for the same reason.
-     */
-    step?: {
-        stepId: string;
-        items: Instruction<TContext, TData>[];
+};
+export type TurnInput<C = unknown, D = unknown> = TurnBase<C, D> & TurnKind;
+export interface OutboundMessage {
+    text: string;
+    /** `'ai'` was phrased by the model; `'verbatim'` came from a `say` step. */
+    kind: "ai" | "verbatim";
+    media?: {
+        slug: string;
     };
+    /** Delay before sending, from a short `wait` that preceded it. */
+    afterMs: number;
+    /** `${runId}:${stepId}:${visit}`; the same on a replay. */
+    key: string;
+    runId?: string;
+    stepId?: string;
 }
-/**
- * Observability record for an instruction that was rendered into a turn's prompt.
- * Textual `when` conditions are included in the prompt for the AI to evaluate.
- * Deterministic — derived from rendering, not from LLM self-report.
- */
-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;
+/** A wake to enqueue with `jobId = key`; at fire time call `turn({ wake: key })`. */
+export interface ScheduleEntry {
+    key: string;
+    at: Date;
+    /** An earlier wake this one supersedes; removing it is best effort. */
+    replaces?: string;
 }
-/** A flow that left its active position during a turn. */
-export interface EndedFlow {
-    flowId: string;
-    title?: string;
-    reason: StoppedReason;
-}
-export interface AgentResponse<TData = Record<string, unknown>> {
-    message: string;
-    session?: SessionState<TData>;
-    toolCalls?: Array<{
-        toolName: string;
-        arguments: Record<string, unknown>;
+export type EndReason = "end" | "flow" | "reset" | "skipped" | "failed" | "replaced";
+export interface TurnResult<D = unknown> {
+    /** Version unchanged; the host bumps it on save. */
+    session: Session<D>;
+    /** False: save nothing, send nothing. */
+    changed: boolean;
+    messages: OutboundMessage[];
+    schedule: ScheduleEntry[];
+    outcomes: StepOutcome[];
+    started: Array<{
+        runId: string;
+        flowId: string;
+        anchor: string;
+        dedupeKey: string;
     }>;
-    isFlowComplete?: boolean;
-    /** Steps executed in this response (for multi-step execution) */
-    executedSteps?: StepRef[];
-    /** Why execution stopped (for multi-step execution) */
-    stoppedReason?: StoppedReason;
-    /**
-     * Instructions rendered into this turn's prompt after code-evaluated gates passed.
-     * Textual `when` conditions remain in the prompt for the AI to evaluate.
-     * 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>[];
-    /**
-     * Provider-reported usage for this turn's primary generation (routing and
-     * extraction sub-calls are not included).
-     */
-    metadata?: {
-        tokensUsed?: number;
-    };
-    /**
-     * Flows that LEFT their active position this turn — completions, redirects,
-     * resets. planTurn knows these internally; surfaced so consumers stop
-     * re-deriving them from executedSteps + session cursor inspection.
-     */
-    endedFlows?: EndedFlow[];
-}
-export interface AgentResponseStreamChunk<TData = Record<string, unknown>> {
-    delta: string;
-    accumulated: string;
-    done: boolean;
-    session?: SessionState<TData>;
-    toolCalls?: Array<{
-        toolName: string;
-        arguments: Record<string, unknown>;
+    ended: Array<Run & {
+        reason: EndReason;
     }>;
-    isFlowComplete?: boolean;
-    /** Steps executed in this response (for multi-step execution) */
-    executedSteps?: StepRef[];
-    /** Why execution stopped (for multi-step execution) */
-    stoppedReason?: StoppedReason;
-    metadata?: {
-        model?: string;
-        tokensUsed?: number;
-        finishReason?: string;
-        [key: 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[];
+    /** Triggers that matched but did not start a run, with the reason. */
+    skipped: Array<{
+        flowId: string;
+        anchor: string;
+        triggerKey: string;
+        code: StepOutcomeCode;
+        message: string;
+    }>;
+    llmCalls: number;
     /**
-     * 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.
+     * What those calls cost, added up. Absent when the turn spent none, or when
+     * the provider reported no counts.
      */
-    triggeredSignals?: SignalFiring<unknown, TData>[];
-}
-/**
- * Validation error for data validation
- */
-export interface ValidationError {
-    field: string;
-    value: unknown;
-    message: string;
-    schemaPath: string;
-}
-/**
- * Result of data validation
- */
-export interface ValidationResult {
-    valid: boolean;
-    errors: ValidationError[];
-    warnings: ValidationError[];
+    usage?: TokenUsage;
 }
+export type TurnStreamChunk<D = unknown> = {
+    delta: string;
+} | {
+    done: true;
+    result: TurnResult<D>;
+};
+export {};
 //# sourceMappingURL=agent.d.ts.map

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

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Agent-related type definitions
+ * Agent options and the one entry point: `turn`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=agent.js.map