import {
  AutoBeHistory,
  IAutoBeCompiler,
  IAutoBeCompilerListener,
  IAutoBeTokenUsageJson,
} from "@autobe/interface";

import { AutoBeTokenUsage } from "../context/AutoBeTokenUsage";
import { IAutoBeConfig } from "./IAutoBeConfig";
import { IAutoBeVendor } from "./IAutoBeVendor";

/**
 * Configuration properties for initializing an AutoBeAgent instance.
 *
 * This interface defines all the essential parameters required to create and
 * configure an AutoBeAgent for vibe coding operations. The properties establish
 * the AI model capabilities, vendor connectivity, compilation infrastructure,
 * behavioral context, and optional session continuity through conversation
 * histories.
 *
 * The configuration enables type-safe AI function calling through
 * model-specific schema generation, ensures compatibility with various AI
 * service providers, and provides the compilation tools necessary for the
 * sophisticated AST-based development pipeline that transforms conversations
 * into working software.
 *
 * @author Samchon
 */
export interface IAutoBeProps {
  /**
   * AI vendor configuration for service provider integration.
   *
   * Defines the complete AI service connection including the OpenAI SDK
   * instance, model identifier, request options, and concurrency controls. This
   * configuration enables the AutoBeAgent to connect with various AI providers
   * while maintaining consistent functionality across the entire automated
   * development workflow.
   *
   * The vendor settings determine the AI capabilities available for
   * requirements analysis, database design, API specification, testing, and
   * implementation phases of the vibe coding process.
   */
  vendor: IAutoBeVendor;

  /**
   * Compiler factory function for TypeScript, database schema, and OpenAPI
   * operations.
   *
   * Factory function that creates compiler instances required for the
   * sophisticated AST-based development pipeline. The compiler handles
   * validation, transformation, and code generation across all development
   * phases including database schema compilation, OpenAPI document validation,
   * and TypeScript code compilation.
   *
   * For high-performance scenarios with multiple concurrent users, the compiler
   * can be separated into dedicated worker processes to prevent blocking the
   * main agent during computationally intensive compilation operations.
   */
  compiler: (
    listener: IAutoBeCompilerListener,
  ) => IAutoBeCompiler | Promise<IAutoBeCompiler>;

  /**
   * Optional conversation and development histories for session continuation.
   *
   * Enables resuming previous vibe coding sessions by providing the
   * chronological record of past conversations, development activities, and
   * generated artifacts. When provided, the agent reconstructs its internal
   * state from these histories, allowing seamless continuation of development
   * work.
   *
   * This capability supports iterative development workflows where users can
   * return to modify, enhance, or extend previously generated applications
   * while maintaining full context of earlier decisions and implementations.
   */
  histories?: AutoBeHistory[] | undefined;

  /**
   * Optional behavioral configuration for localization and context.
   *
   * Customizes the agent's communication style, language preferences, and
   * geographical context to provide personalized vibe coding experiences.
   * Configuration includes locale settings for internationalized responses and
   * timezone information for temporal context awareness.
   *
   * These settings influence how the agent communicates with users, interprets
   * regional requirements (such as regulatory considerations), and handles
   * time-sensitive operations throughout the development process.
   */
  config?: IAutoBeConfig | undefined;

  /**
   * Token usage information.
   *
   * You can start token usage tracing by assigning this property.
   *
   * If you assign {@link IAutoBeTokenUsageJson} value, the token usage tracing
   * would be from the value. Otherwise you assign the {@link AutoBeTokenUsage}
   * typed instance, the tracing would be binded to the instance.
   */
  tokenUsage?: IAutoBeTokenUsageJson | AutoBeTokenUsage | undefined;
}