@autobe/agent 0.30.0-dev.20260315 → 0.30.0

package/src/orchestrate/realize/structures/IAutoBeRealizeOperationCorrectApplication.ts

@@ -1,134 +1,134 @@
-import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
-import { IAutoBePreliminaryGetDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetDatabaseSchemas";
-import { IAutoBePreliminaryGetRealizeCollectors } from "../../common/structures/IAutoBePreliminaryGetRealizeCollectors";
-import { IAutoBePreliminaryGetRealizeTransformers } from "../../common/structures/IAutoBePreliminaryGetRealizeTransformers";
-
-export interface IAutoBeRealizeOperationCorrectApplication {
-  /**
-   * Process provider correction task or preliminary data requests.
-   *
-   * Systematically analyzes and corrects TypeScript compilation errors through
-   * three-phase workflow (think → draft → revise). Maintains business logic
-   * integrity while resolving all compilation issues.
-   *
-   * @param props Request containing either preliminary data request or complete
-   *   task
-   */
-  process(props: IAutoBeRealizeOperationCorrectApplication.IProps): void;
-}
-
-export namespace IAutoBeRealizeOperationCorrectApplication {
-  export interface IProps {
-    /**
-     * Think before you act.
-     *
-     * Before requesting preliminary data or completing your task, reflect on
-     * your current state and explain your reasoning:
-     *
-     * For preliminary requests (getAnalysisSections, getDatabaseSchemas, etc.):
-     *
-     * - What critical information is missing that you don't already have?
-     * - Why do you need it specifically right now?
-     * - Be brief - state the gap, don't list everything you have.
-     *
-     * For completion (complete):
-     *
-     * - What key assets did you acquire?
-     * - What did you accomplish?
-     * - Why is it sufficient to complete?
-     * - Summarize - don't enumerate every single item.
-     *
-     * This reflection helps you avoid duplicate requests and premature
-     * completion.
-     */
-    thinking: string;
-
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval
-     * (getDatabaseSchemas) or final error correction (complete). When
-     * preliminary returns empty array, that type is removed from the union,
-     * physically preventing repeated calls.
-     */
-    request:
-      | IComplete
-      | IAutoBePreliminaryGetAnalysisSections
-      | IAutoBePreliminaryGetDatabaseSchemas
-      | IAutoBePreliminaryGetRealizeCollectors
-      | IAutoBePreliminaryGetRealizeTransformers;
-  }
-
-  /**
-   * Request to correct provider implementation errors.
-   *
-   * Executes three-phase error correction to resolve TypeScript compilation
-   * issues in provider functions. Applies systematic fixes following think →
-   * draft → revise pattern to ensure error-free production code.
-   */
-  export interface IComplete {
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval or actual
-     * task execution. Value "complete" indicates this is the final task
-     * execution request.
-     */
-    type: "complete";
-
-    /**
-     * Initial error analysis and correction strategy.
-     *
-     * Analyzes TypeScript compilation errors to understand:
-     *
-     * - Error patterns and root causes
-     * - Required fixes and their impact
-     * - Whether quick fixes or deep refactoring is needed
-     * - Database schema and API contract constraints
-     */
-    think: string;
-
-    /**
-     * First correction attempt.
-     *
-     * Implements the initial fixes identified in the think phase. For simple
-     * errors (typos, missing imports), this may be the final solution. Complex
-     * errors may require further refinement.
-     */
-    draft: string;
-
-    /**
-     * Revision and finalization phase.
-     *
-     * Reviews the draft corrections and produces the final, error-free code
-     * that maintains all business requirements.
-     */
-    revise: IReviseProps;
-  }
-
-  export interface IReviseProps {
-    /**
-     * Correction review and validation.
-     *
-     * Analyzes the draft corrections to ensure:
-     *
-     * - All TypeScript errors are resolved
-     * - Business logic remains intact
-     * - AutoBE coding standards are maintained
-     * - No new errors are introduced
-     * - Performance and security are preserved
-     */
-    review: string;
-
-    /**
-     * Final error-free implementation.
-     *
-     * The complete, corrected code that passes all TypeScript compilation
-     * checks.
-     *
-     * Returns `null` if the draft corrections are sufficient and need no
-     * further changes.
-     */
-    final: string | null;
-  }
-}
+import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
+import { IAutoBePreliminaryGetDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetDatabaseSchemas";
+import { IAutoBePreliminaryGetRealizeCollectors } from "../../common/structures/IAutoBePreliminaryGetRealizeCollectors";
+import { IAutoBePreliminaryGetRealizeTransformers } from "../../common/structures/IAutoBePreliminaryGetRealizeTransformers";
+
+export interface IAutoBeRealizeOperationCorrectApplication {
+  /**
+   * Process provider correction task or preliminary data requests.
+   *
+   * Systematically analyzes and corrects TypeScript compilation errors through
+   * three-phase workflow (think → draft → revise). Maintains business logic
+   * integrity while resolving all compilation issues.
+   *
+   * @param props Request containing either preliminary data request or complete
+   *   task
+   */
+  process(props: IAutoBeRealizeOperationCorrectApplication.IProps): void;
+}
+
+export namespace IAutoBeRealizeOperationCorrectApplication {
+  export interface IProps {
+    /**
+     * Think before you act.
+     *
+     * Before requesting preliminary data or completing your task, reflect on
+     * your current state and explain your reasoning:
+     *
+     * For preliminary requests (getAnalysisSections, getDatabaseSchemas, etc.):
+     *
+     * - What critical information is missing that you don't already have?
+     * - Why do you need it specifically right now?
+     * - Be brief - state the gap, don't list everything you have.
+     *
+     * For completion (complete):
+     *
+     * - What key assets did you acquire?
+     * - What did you accomplish?
+     * - Why is it sufficient to complete?
+     * - Summarize - don't enumerate every single item.
+     *
+     * This reflection helps you avoid duplicate requests and premature
+     * completion.
+     */
+    thinking: string;
+
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval
+     * (getDatabaseSchemas) or final error correction (complete). When
+     * preliminary returns empty array, that type is removed from the union,
+     * physically preventing repeated calls.
+     */
+    request:
+      | IComplete
+      | IAutoBePreliminaryGetAnalysisSections
+      | IAutoBePreliminaryGetDatabaseSchemas
+      | IAutoBePreliminaryGetRealizeCollectors
+      | IAutoBePreliminaryGetRealizeTransformers;
+  }
+
+  /**
+   * Request to correct provider implementation errors.
+   *
+   * Executes three-phase error correction to resolve TypeScript compilation
+   * issues in provider functions. Applies systematic fixes following think →
+   * draft → revise pattern to ensure error-free production code.
+   */
+  export interface IComplete {
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval or actual
+     * task execution. Value "complete" indicates this is the final task
+     * execution request.
+     */
+    type: "complete";
+
+    /**
+     * Initial error analysis and correction strategy.
+     *
+     * Analyzes TypeScript compilation errors to understand:
+     *
+     * - Error patterns and root causes
+     * - Required fixes and their impact
+     * - Whether quick fixes or deep refactoring is needed
+     * - Database schema and API contract constraints
+     */
+    think: string;
+
+    /**
+     * First correction attempt.
+     *
+     * Implements the initial fixes identified in the think phase. For simple
+     * errors (typos, missing imports), this may be the final solution. Complex
+     * errors may require further refinement.
+     */
+    draft: string;
+
+    /**
+     * Revision and finalization phase.
+     *
+     * Reviews the draft corrections and produces the final, error-free code
+     * that maintains all business requirements.
+     */
+    revise: IReviseProps;
+  }
+
+  export interface IReviseProps {
+    /**
+     * Correction review and validation.
+     *
+     * Analyzes the draft corrections to ensure:
+     *
+     * - All TypeScript errors are resolved
+     * - Business logic remains intact
+     * - AutoBE coding standards are maintained
+     * - No new errors are introduced
+     * - Performance and security are preserved
+     */
+    review: string;
+
+    /**
+     * Final error-free implementation.
+     *
+     * The complete, corrected code that passes all TypeScript compilation
+     * checks.
+     *
+     * Returns `null` if the draft corrections are sufficient and need no
+     * further changes.
+     */
+    final: string | null;
+  }
+}

package/src/orchestrate/realize/structures/IAutoBeRealizeOperationWriteApplication.ts

@@ -1,138 +1,138 @@
-import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
-import { IAutoBePreliminaryGetDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetDatabaseSchemas";
-import { IAutoBePreliminaryGetRealizeCollectors } from "../../common/structures/IAutoBePreliminaryGetRealizeCollectors";
-import { IAutoBePreliminaryGetRealizeTransformers } from "../../common/structures/IAutoBePreliminaryGetRealizeTransformers";
-
-/**
- * Function calling interface for generating API operation implementation
- * functions.
- *
- * Guides the AI agent through creating provider functions that implement
- * complete business logic for specific API endpoints. Each operation function
- * handles the full request-response lifecycle including validation,
- * authorization, database operations, and response formatting.
- *
- * The generation follows a structured RAG workflow: preliminary context
- * gathering (database schemas) → implementation planning → code generation →
- * review and refinement.
- */
-export interface IAutoBeRealizeOperationWriteApplication {
-  /**
-   * Process operation function implementation task or preliminary data
-   * requests.
-   *
-   * Generates complete operation function implementation through three-phase
-   * workflow (plan → draft → revise). Ensures type safety, proper database
-   * query patterns, and API contract compliance.
-   *
-   * @param props Request containing either preliminary data request or complete
-   *   task
-   */
-  process(props: IAutoBeRealizeOperationWriteApplication.IProps): void;
-}
-
-export namespace IAutoBeRealizeOperationWriteApplication {
-  export interface IProps {
-    /**
-     * Think before you act.
-     *
-     * Before requesting preliminary data or completing your task, reflect on
-     * your current state and explain your reasoning:
-     *
-     * For preliminary requests (getAnalysisSections, getDatabaseSchemas, etc.):
-     *
-     * - What critical information is missing that you don't already have?
-     * - Why do you need it specifically right now?
-     * - Be brief - state the gap, don't list everything you have.
-     *
-     * For completion (complete):
-     *
-     * - What key assets did you acquire?
-     * - What did you accomplish?
-     * - Why is it sufficient to complete?
-     * - Summarize - don't enumerate every single item.
-     *
-     * This reflection helps you avoid duplicate requests and premature
-     * completion.
-     */
-    thinking: string;
-
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval
-     * (getDatabaseSchemas, getRealizeCollectors, getRealizeTransformers) or
-     * final implementation generation (complete). When preliminary returns
-     * empty array, that type is removed from the union, physically preventing
-     * repeated calls.
-     */
-    request:
-      | IComplete
-      | IAutoBePreliminaryGetDatabaseSchemas
-      | IAutoBePreliminaryGetAnalysisSections
-      | IAutoBePreliminaryGetRealizeCollectors
-      | IAutoBePreliminaryGetRealizeTransformers;
-  }
-
-  /**
-   * Request to generate operation function implementation.
-   *
-   * Executes three-phase generation to create complete operation
-   * implementation. Follows plan → draft → revise pattern to ensure type
-   * safety, proper database query patterns, and API contract compliance.
-   */
-  export interface IComplete {
-    /** Type discriminator for completion request. */
-    type: "complete";
-
-    /**
-     * Operation implementation plan and strategy.
-     *
-     * Analyzes the operation function requirements, identifies related database
-     * schemas, and outlines the implementation approach. Includes schema
-     * validation and API contract verification.
-     */
-    plan: string;
-
-    /**
-     * Initial implementation draft.
-     *
-     * The first complete implementation attempt based on the plan. May contain
-     * areas that need refinement in the review phase.
-     */
-    draft: string;
-
-    /**
-     * Revision and finalization phase.
-     *
-     * Reviews the draft implementation and produces the final code with all
-     * improvements and corrections applied.
-     */
-    revise: IReviseProps;
-  }
-
-  export interface IReviseProps {
-    /**
-     * Review and improvement suggestions.
-     *
-     * Identifies areas for improvement in the draft code, including:
-     *
-     * - Type safety enhancements
-     * - Database query optimizations
-     * - Null/undefined handling corrections
-     * - Authentication/authorization improvements
-     * - Error handling refinements
-     */
-    review: string;
-
-    /**
-     * Final operation function code.
-     *
-     * The complete, production-ready implementation with all review suggestions
-     * applied.
-     *
-     * Returns `null` if the draft is already perfect and needs no changes.
-     */
-    final: string | null;
-  }
-}
+import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
+import { IAutoBePreliminaryGetDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetDatabaseSchemas";
+import { IAutoBePreliminaryGetRealizeCollectors } from "../../common/structures/IAutoBePreliminaryGetRealizeCollectors";
+import { IAutoBePreliminaryGetRealizeTransformers } from "../../common/structures/IAutoBePreliminaryGetRealizeTransformers";
+
+/**
+ * Function calling interface for generating API operation implementation
+ * functions.
+ *
+ * Guides the AI agent through creating provider functions that implement
+ * complete business logic for specific API endpoints. Each operation function
+ * handles the full request-response lifecycle including validation,
+ * authorization, database operations, and response formatting.
+ *
+ * The generation follows a structured RAG workflow: preliminary context
+ * gathering (database schemas) → implementation planning → code generation →
+ * review and refinement.
+ */
+export interface IAutoBeRealizeOperationWriteApplication {
+  /**
+   * Process operation function implementation task or preliminary data
+   * requests.
+   *
+   * Generates complete operation function implementation through three-phase
+   * workflow (plan → draft → revise). Ensures type safety, proper database
+   * query patterns, and API contract compliance.
+   *
+   * @param props Request containing either preliminary data request or complete
+   *   task
+   */
+  process(props: IAutoBeRealizeOperationWriteApplication.IProps): void;
+}
+
+export namespace IAutoBeRealizeOperationWriteApplication {
+  export interface IProps {
+    /**
+     * Think before you act.
+     *
+     * Before requesting preliminary data or completing your task, reflect on
+     * your current state and explain your reasoning:
+     *
+     * For preliminary requests (getAnalysisSections, getDatabaseSchemas, etc.):
+     *
+     * - What critical information is missing that you don't already have?
+     * - Why do you need it specifically right now?
+     * - Be brief - state the gap, don't list everything you have.
+     *
+     * For completion (complete):
+     *
+     * - What key assets did you acquire?
+     * - What did you accomplish?
+     * - Why is it sufficient to complete?
+     * - Summarize - don't enumerate every single item.
+     *
+     * This reflection helps you avoid duplicate requests and premature
+     * completion.
+     */
+    thinking: string;
+
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval
+     * (getDatabaseSchemas, getRealizeCollectors, getRealizeTransformers) or
+     * final implementation generation (complete). When preliminary returns
+     * empty array, that type is removed from the union, physically preventing
+     * repeated calls.
+     */
+    request:
+      | IComplete
+      | IAutoBePreliminaryGetDatabaseSchemas
+      | IAutoBePreliminaryGetAnalysisSections
+      | IAutoBePreliminaryGetRealizeCollectors
+      | IAutoBePreliminaryGetRealizeTransformers;
+  }
+
+  /**
+   * Request to generate operation function implementation.
+   *
+   * Executes three-phase generation to create complete operation
+   * implementation. Follows plan → draft → revise pattern to ensure type
+   * safety, proper database query patterns, and API contract compliance.
+   */
+  export interface IComplete {
+    /** Type discriminator for completion request. */
+    type: "complete";
+
+    /**
+     * Operation implementation plan and strategy.
+     *
+     * Analyzes the operation function requirements, identifies related database
+     * schemas, and outlines the implementation approach. Includes schema
+     * validation and API contract verification.
+     */
+    plan: string;
+
+    /**
+     * Initial implementation draft.
+     *
+     * The first complete implementation attempt based on the plan. May contain
+     * areas that need refinement in the review phase.
+     */
+    draft: string;
+
+    /**
+     * Revision and finalization phase.
+     *
+     * Reviews the draft implementation and produces the final code with all
+     * improvements and corrections applied.
+     */
+    revise: IReviseProps;
+  }
+
+  export interface IReviseProps {
+    /**
+     * Review and improvement suggestions.
+     *
+     * Identifies areas for improvement in the draft code, including:
+     *
+     * - Type safety enhancements
+     * - Database query optimizations
+     * - Null/undefined handling corrections
+     * - Authentication/authorization improvements
+     * - Error handling refinements
+     */
+    review: string;
+
+    /**
+     * Final operation function code.
+     *
+     * The complete, production-ready implementation with all review suggestions
+     * applied.
+     *
+     * Returns `null` if the draft is already perfect and needs no changes.
+     */
+    final: string | null;
+  }
+}

package/src/orchestrate/realize/structures/IAutoBeRealizeScenarioResult.ts

@@ -1,32 +1,32 @@
-import { AutoBeOpenApi, AutoBeRealizeAuthorization } from "@autobe/interface";
-
-export interface IAutoBeRealizeScenarioResult {
-  /** The OpenAPI operation to be realized. */
-  operation: AutoBeOpenApi.IOperation;
-
-  /**
-   * The name of the function to be generated.
-   *
-   * Derived from the Swagger path and method. The function name must be written
-   * in snake_case. It serves as the entry point in both code generation and
-   * test code.
-   *
-   * Once the function is generated, the function name and file name will be the
-   * same. The generated file will be located at
-   * `src/providers/${function_name}.ts`.
-   */
-  functionName: string;
-
-  /** For example, `src/providers/${function_name}.ts`. */
-  location: string;
-
-  /**
-   * Optional decorator event for customizing code generation behavior.
-   *
-   * Provides additional metadata or instructions that can modify how the
-   * function implementation is generated. Can include custom annotations,
-   * middleware configurations, or special handling directives that affect the
-   * final code output.
-   */
-  decoratorEvent?: AutoBeRealizeAuthorization;
-}
+import { AutoBeOpenApi, AutoBeRealizeAuthorization } from "@autobe/interface";
+
+export interface IAutoBeRealizeScenarioResult {
+  /** The OpenAPI operation to be realized. */
+  operation: AutoBeOpenApi.IOperation;
+
+  /**
+   * The name of the function to be generated.
+   *
+   * Derived from the Swagger path and method. The function name must be written
+   * in snake_case. It serves as the entry point in both code generation and
+   * test code.
+   *
+   * Once the function is generated, the function name and file name will be the
+   * same. The generated file will be located at
+   * `src/providers/${function_name}.ts`.
+   */
+  functionName: string;
+
+  /** For example, `src/providers/${function_name}.ts`. */
+  location: string;
+
+  /**
+   * Optional decorator event for customizing code generation behavior.
+   *
+   * Provides additional metadata or instructions that can modify how the
+   * function implementation is generated. Can include custom annotations,
+   * middleware configurations, or special handling directives that affect the
+   * final code output.
+   */
+  decoratorEvent?: AutoBeRealizeAuthorization;
+}