@falai/agent 3.4.5 → 4.0.0-alpha.1

package/dist/core/Step.d.ts

@@ -1,184 +0,0 @@
-/**
- * Step in a conversational flow
- */
-import type { StepRef, StepOptions, BranchMap, Instruction, Tool, PrepareResult } from "../types/index.js";
-import type { StepResult, BranchSpec, BranchResult } from "../types/flow.js";
-import { ToolScope, Template, TemplateContext } from "../types/index.js";
-import type { ConditionWhen, ConditionIf } from "../types/flow.js";
-import { Agent } from './Agent.js';
-/**
- * Error thrown when a step's configuration violates auto-step constraints.
- */
-export declare class FlowConfigurationError extends Error {
-    constructor(message: string);
-}
-/**
- * Represents a step within a route
- */
-export declare class Step<TContext = unknown, TData = unknown> {
-    readonly id: string;
-    private nextSteps;
-    private _instructions;
-    readonly flowId: string;
-    collect?: (keyof TData)[];
-    description?: string;
-    when?: ConditionWhen;
-    if?: ConditionIf<TContext, TData>;
-    skip?: ConditionIf<TContext, TData>;
-    requires?: (keyof TData)[];
-    prompt?: Template<TContext, TData>;
-    reply?: Template<TContext, TData>;
-    prepare?: string | Tool<TContext, TData> | ((context: TContext, data?: Partial<TData>) => void | PrepareResult | Promise<void | PrepareResult>);
-    finalize?: string | Tool<TContext, TData> | ((context: TContext, data?: Partial<TData>) => void | PrepareResult | Promise<void | PrepareResult>);
-    tools?: (string | Tool<TContext, TData>)[];
-    private readonly _auto;
-    private readonly _branches?;
-    /** Whether this step runs without an LLM call (computational only). */
-    get auto(): boolean;
-    /** Explicit source-local fork entries, if declared. */
-    get branches(): BranchMap<TContext, TData> | undefined;
-    private parentAgent?;
-    constructor(routeId: string, options?: StepOptions<TContext, TData>, parentAgent?: Agent<TContext, TData>);
-    /**
-     * Configure the step properties after creation
-     * Useful for overriding initial step configuration
-     */
-    configure(config: {
-        description?: string;
-        collect?: (keyof TData)[];
-        skip?: ConditionIf<TContext, TData>;
-        requires?: (keyof TData)[];
-        prompt?: Template<TContext, TData>;
-        prepare?: string | Tool<TContext, TData> | ((context: TContext, data?: Partial<TData>) => void | Promise<void>);
-        finalize?: string | Tool<TContext, TData> | ((context: TContext, data?: Partial<TData>) => void | Promise<void>);
-        tools?: (string | Tool<TContext, TData>)[];
-    }): this;
-    /**
-     * Create a transition from this step to another
-     *
-     * @param spec - Transition specification (prompt, tool, or direct step)
-     * @returns StepResult that supports chaining
-     */
-    nextStep(spec: StepOptions<TContext, TData>): StepResult<TContext, TData>;
-    /**
-     * Create multiple branches from this step
-     *
-     * @param branches - Array of branch specifications
-     * @returns BranchResult mapping branch names to their step results
-     */
-    branch(branches: BranchSpec<TContext, TData>[]): BranchResult<TContext, TData>;
-    /**
-     * Add an instruction to this step.
-     */
-    addInstruction(instruction: Instruction<TContext, TData>): void;
-    /**
-     * Get instructions for this step
-     */
-    getInstructions(): Instruction<TContext, TData>[];
-    /**
-     * Add a tool to this step using the unified Tool interface
-     * Creates and adds the tool to step scope in one operation
-     */
-    addTool(tool: Tool<TContext, TData>): this;
-    /**
-     * Resolve tool references in the tools array
-     * Supports both string IDs (resolved from registry) and inline tool objects
-     */
-    resolveTools(): Tool<TContext, TData>[];
-    /**
-     * Get all tools available to this step (both inline and resolved from registry)
-     */
-    getAvailableTools(): (string | Tool<TContext, TData>)[];
-    /**
-     * Get all resolved tools available to this step using ToolManager
-     * This method provides the complete set of tools accessible from this step
-     */
-    getAllAvailableTools(): Tool<TContext, TData>[];
-    /**
-     * Find a specific tool by ID using ToolManager resolution
-     * This method respects the tool resolution hierarchy: step → route → agent → registry
-     */
-    findTool(toolId: string, scope?: ToolScope): Tool<TContext, TData> | undefined;
-    /**
-     * Get tools from a specific scope
-     */
-    getToolsFromScope(scope: ToolScope): Tool<TContext, TData>[];
-    /**
-     * Get only step-level tools (inline tools in this step)
-     */
-    getStepTools(): Tool<TContext, TData>[];
-    /**
-     * Get only registered tools accessible from this step
-     */
-    getRegisteredTools(): Tool<TContext, TData>[];
-    /**
-     * Validate that all tool references in this step can be resolved
-     * Returns validation result with details about missing tools
-     */
-    validateToolReferences(): {
-        valid: boolean;
-        missing: string[];
-        found: string[];
-        details: Array<{
-            id: string;
-            found: boolean;
-            scope?: string;
-        }>;
-    };
-    /**
-     * Get all transitions from this step
-     */
-    getTransitions(): Step<TContext, TData>[];
-    /**
-     * Evaluate when/if conditions using the v2 split logic.
-     * `if` (code predicate) evaluates first (free); `when` (AI) evaluates only when `if` passes.
-     * `if` predicates use AND semantics. Non-`!` `when` strings use OR semantics;
-     * `!` strings are exclusions where any match inhibits activation.
-     * When both fields are set, the passing `if` gate and AI match are combined with AND.
-     */
-    evaluateWhen(templateContext: TemplateContext<TContext, TData>): Promise<{
-        shouldActivate: boolean;
-        aiContextStrings: string[];
-        aiExclusionStrings: string[];
-        hasProgrammaticConditions: boolean;
-    }>;
-    /**
-     * Evaluate the skip condition (if-only shape — code predicates, OR semantics).
-     * Returns true if the step should be skipped.
-     */
-    evaluateSkip(templateContext: TemplateContext<TContext, TData>): Promise<{
-        shouldSkip: boolean;
-        aiContextStrings: string[];
-        hasProgrammaticConditions: boolean;
-    }>;
-    /**
-     * Check if this step has all required data to proceed
-     */
-    hasRequires(data: Partial<TData>): boolean;
-    /**
-     * Get step reference
-     */
-    getRef(): StepRef;
-    /**
-     * Create a step reference with nextStep capability for chaining
-     */
-    private createStepRefWithTransition;
-    /**
-     * Create a transition result for this step
-     */
-    asStepResult(): StepResult<TContext, TData>;
-    /**
-     * Export step configuration as StepOptions for copying/cloning
-     * @returns StepOptions that can be used to create a new step with identical configuration
-     */
-    toOptions(): StepOptions<TContext, TData>;
-    /**
-     * Validate the branches array at construction time.
-     * Checks:
-     * - Non-empty array
-     * - Unconditional entries (no `when` and no `if`) only legal as the last entry
-     * - Directive `then` values: at most one position field, no empty `goTo: {}`
-     */
-    private validateBranches;
-}
-//# sourceMappingURL=Step.d.ts.map

package/dist/core/Step.d.ts.map

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