@falai/agent 0.6.8 → 0.7.0

package/src/core/State.ts

@@ -1,212 +0,0 @@
-/**
- * State in the route DSL
- */
-
-import type {
-  StateRef,
-  TransitionSpec,
-  TransitionResult,
-} from "../types/route";
-import type { Guideline } from "../types/agent";
-
-import { END_STATE } from "../constants";
-import { Transition } from "./Transition";
-import { generateStateId } from "../utils/id";
-
-/**
- * Represents a state within a route
- */
-export class State<TContext = unknown, TExtracted = unknown> {
-  public readonly id: string;
-  private transitions: Transition<TContext, TExtracted>[] = [];
-  private guidelines: Guideline[] = [];
-  public gatherFields?: string[];
-  public skipIf?: (extracted: Partial<TExtracted>) => boolean;
-  public requiredData?: string[];
-  public chatState?: string;
-
-  constructor(
-    public readonly routeId: string,
-    public description?: string,
-    customId?: string,
-    gatherFields?: string[],
-    skipIf?: (extracted: Partial<TExtracted>) => boolean,
-    requiredData?: string[],
-    chatState?: string
-  ) {
-    // Use provided ID or generate a deterministic one
-    this.id = customId || generateStateId(routeId, description);
-    this.gatherFields = gatherFields;
-    this.skipIf = skipIf;
-    this.requiredData = requiredData;
-    this.chatState = chatState;
-  }
-
-  /**
-   * Configure the state properties after creation
-   * Useful for overriding initial state configuration
-   */
-  configure(config: {
-    description?: string;
-    gatherFields?: string[];
-    skipIf?: (extracted: Partial<TExtracted>) => boolean;
-    requiredData?: string[];
-    chatState?: string;
-  }): this {
-    if (config.description !== undefined) {
-      this.description = config.description;
-    }
-    if (config.gatherFields !== undefined) {
-      this.gatherFields = config.gatherFields;
-    }
-    if (config.skipIf !== undefined) {
-      this.skipIf = config.skipIf;
-    }
-    if (config.requiredData !== undefined) {
-      this.requiredData = config.requiredData;
-    }
-    if (config.chatState !== undefined) {
-      this.chatState = config.chatState;
-    }
-    return this;
-  }
-
-  /**
-   * Create a transition from this state to another
-   *
-   * @param spec - Transition specification (chatState, toolState, or direct state)
-   * @returns TransitionResult that supports chaining
-   */
-  transitionTo(
-    spec: TransitionSpec<TContext, TExtracted>
-  ): TransitionResult<TContext, TExtracted> {
-    // Handle END_STATE
-    if (
-      spec.state &&
-      typeof spec.state === "symbol" &&
-      spec.state === END_STATE
-    ) {
-      const endTransition = new Transition<TContext, TExtracted>(
-        this.getRef(),
-        { state: END_STATE, condition: spec.condition, chatState: spec.chatState }
-      );
-      this.transitions.push(endTransition);
-
-      // Return a terminal state reference
-      return this.createTerminalRef();
-    }
-
-    // Handle direct state reference
-    if (spec.state && typeof spec.state !== "symbol") {
-      const transition = new Transition<TContext, TExtracted>(
-        this.getRef(),
-        spec
-      );
-      this.transitions.push(transition);
-
-      return this.createStateRefWithTransition(spec.state);
-    }
-
-    // Create new target state for chatState or toolState
-    const targetState = new State<TContext, TExtracted>(
-      this.routeId,
-      spec.chatState,
-      spec.id, // Use custom ID if provided
-      spec.gather,
-      spec.skipIf,
-      spec.requiredData,
-      spec.chatState
-    );
-    const transition = new Transition<TContext, TExtracted>(
-      this.getRef(),
-      spec
-    );
-    transition.setTarget(targetState);
-
-    this.transitions.push(transition);
-
-    return this.createStateRefWithTransition(targetState.getRef(), targetState);
-  }
-
-  /**
-   * Add a guideline specific to this state
-   */
-  addGuideline(guideline: Guideline): void {
-    this.guidelines.push(guideline);
-  }
-
-  /**
-   * Get guidelines for this state
-   */
-  getGuidelines(): Guideline[] {
-    return [...this.guidelines];
-  }
-
-  /**
-   * Get all transitions from this state
-   */
-  getTransitions(): Transition<TContext, TExtracted>[] {
-    return [...this.transitions];
-  }
-
-  /**
-   * Check if this state should be skipped based on extracted data
-   */
-  shouldSkip(extracted: Partial<TExtracted>): boolean {
-    if (!this.skipIf) return false;
-    return this.skipIf(extracted);
-  }
-
-  /**
-   * Check if this state has all required data to proceed
-   */
-  hasRequiredData(extracted: Partial<TExtracted>): boolean {
-    if (!this.requiredData || this.requiredData.length === 0) return true;
-    return this.requiredData.every(
-      (key) => extracted[key as keyof TExtracted] !== undefined
-    );
-  }
-
-  /**
-   * Get state reference
-   */
-  getRef(): StateRef {
-    return {
-      id: this.id,
-      routeId: this.routeId,
-    };
-  }
-
-  /**
-   * Create a state reference with transitionTo capability for chaining
-   */
-  private createStateRefWithTransition(
-    ref: StateRef,
-    state?: State<TContext, TExtracted>
-  ): TransitionResult<TContext, TExtracted> {
-    const stateInstance = state || this;
-
-    return {
-      ...ref,
-      transitionTo: (spec: TransitionSpec<TContext, TExtracted>) =>
-        stateInstance.transitionTo(spec),
-    };
-  }
-
-  /**
-   * Create a terminal state reference (for END_STATE)
-   */
-  private createTerminalRef(): TransitionResult<TContext, TExtracted> {
-    const terminalRef: StateRef = {
-      id: "END",
-      routeId: this.routeId,
-    };
-
-    return {
-      ...terminalRef,
-      transitionTo: () => {
-        throw new Error("Cannot transition from END_STATE state");
-      },
-    };
-  }
-}