@autobe/agent 0.30.0-dev.20260315 → 0.30.0

package/src/orchestrate/interface/structures/IAutoBeInterfaceAuthorizationApplication.ts

@@ -1,135 +1,135 @@
-import { AutoBeOpenApi } from "@autobe/interface";
-import { tags } from "typia";
-
-import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
-import { IAutoBePreliminaryGetDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetDatabaseSchemas";
-import { IAutoBePreliminaryGetPreviousAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetPreviousAnalysisSections";
-import { IAutoBePreliminaryGetPreviousDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetPreviousDatabaseSchemas";
-
-export interface IAutoBeInterfaceAuthorizationApplication {
-  /**
-   * Process authorization operations generation task or preliminary data
-   * requests.
-   *
-   * Generates authorization operations for the given roles and ensures the
-   * interface reflects correct permissions and access levels.
-   *
-   * @param props Request containing either preliminary data request or complete
-   *   task
-   */
-  process(props: IAutoBeInterfaceAuthorizationApplication.IProps): void;
-}
-
-export namespace IAutoBeInterfaceAuthorizationApplication {
-  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
-     * (getAnalysisSections, getPreviousAnalysisSections, getDatabaseSchemas,
-     * getPreviousDatabaseSchemas) or final authorization operations generation
-     * (complete). When preliminary returns empty array, that type is removed
-     * from the union, physically preventing repeated calls.
-     */
-    request:
-      | IComplete
-      | IAutoBePreliminaryGetAnalysisSections
-      | IAutoBePreliminaryGetDatabaseSchemas
-      | IAutoBePreliminaryGetPreviousAnalysisSections
-      | IAutoBePreliminaryGetPreviousDatabaseSchemas;
-  }
-
-  /**
-   * Request to generate authorization operations.
-   *
-   * Executes authorization operations generation to define the authorization
-   * requirements for the given roles. Ensures operations reflect correct
-   * permissions and access levels for each role.
-   */
-  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";
-
-    /**
-     * Analysis of the actor's authentication requirements and schema context.
-     *
-     * Documents the agent's understanding of the actor type
-     * (guest/member/admin), what authentication fields exist in the database
-     * schema, what additional authentication features are supported by the
-     * schema, and what operations are appropriate for this actor kind.
-     */
-    analysis: string;
-
-    /**
-     * Rationale for the authorization operation design decisions.
-     *
-     * Explains why specific operations were included or excluded, how the actor
-     * kind influenced the essential operations selection (e.g., why guests
-     * don't have login), what schema fields enabled additional operations, and
-     * why certain authentication patterns were chosen.
-     */
-    rationale: string;
-
-    /**
-     * Array of API operations to generate authorization operation for.
-     *
-     * Each operation in this array must include:
-     *
-     * - Specification: Detailed API specification with clear purpose and
-     *   functionality
-     * - Path: Resource-centric URL path (e.g., "/resources/{resourceId}")
-     * - Method: HTTP method (get, post, put, delete, patch)
-     * - Description: Extremely detailed multi-paragraph description referencing
-     *   database schema comments
-     * - Summary: Concise one-sentence summary of the endpoint
-     * - Parameters: Array of all necessary parameters with descriptions and
-     *   schema definitions
-     * - RequestBody: For POST/PUT/PATCH methods, with typeName referencing
-     *   components.schemas
-     * - ResponseBody: With typeName referencing appropriate response type
-     *
-     * All operations must follow strict quality standards:
-     *
-     * 1. Detailed descriptions referencing database schema comments
-     * 2. Accurate parameter definitions matching path parameters
-     * 3. Appropriate request/response body type references
-     * 4. Consistent patterns for CRUD operations
-     *
-     * For list retrievals (typically PATCH), include pagination, search, and
-     * sorting. For detail retrieval (GET), return a single resource. For
-     * creation (POST), use .ICreate request body. For modification (PUT), use
-     * .IUpdate request body.
-     */
-    operations: AutoBeOpenApi.IOperation[] & tags.MinItems<1>;
-  }
-}
+import { AutoBeOpenApi } from "@autobe/interface";
+import { tags } from "typia";
+
+import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
+import { IAutoBePreliminaryGetDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetDatabaseSchemas";
+import { IAutoBePreliminaryGetPreviousAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetPreviousAnalysisSections";
+import { IAutoBePreliminaryGetPreviousDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetPreviousDatabaseSchemas";
+
+export interface IAutoBeInterfaceAuthorizationApplication {
+  /**
+   * Process authorization operations generation task or preliminary data
+   * requests.
+   *
+   * Generates authorization operations for the given roles and ensures the
+   * interface reflects correct permissions and access levels.
+   *
+   * @param props Request containing either preliminary data request or complete
+   *   task
+   */
+  process(props: IAutoBeInterfaceAuthorizationApplication.IProps): void;
+}
+
+export namespace IAutoBeInterfaceAuthorizationApplication {
+  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
+     * (getAnalysisSections, getPreviousAnalysisSections, getDatabaseSchemas,
+     * getPreviousDatabaseSchemas) or final authorization operations generation
+     * (complete). When preliminary returns empty array, that type is removed
+     * from the union, physically preventing repeated calls.
+     */
+    request:
+      | IComplete
+      | IAutoBePreliminaryGetAnalysisSections
+      | IAutoBePreliminaryGetDatabaseSchemas
+      | IAutoBePreliminaryGetPreviousAnalysisSections
+      | IAutoBePreliminaryGetPreviousDatabaseSchemas;
+  }
+
+  /**
+   * Request to generate authorization operations.
+   *
+   * Executes authorization operations generation to define the authorization
+   * requirements for the given roles. Ensures operations reflect correct
+   * permissions and access levels for each role.
+   */
+  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";
+
+    /**
+     * Analysis of the actor's authentication requirements and schema context.
+     *
+     * Documents the agent's understanding of the actor type
+     * (guest/member/admin), what authentication fields exist in the database
+     * schema, what additional authentication features are supported by the
+     * schema, and what operations are appropriate for this actor kind.
+     */
+    analysis: string;
+
+    /**
+     * Rationale for the authorization operation design decisions.
+     *
+     * Explains why specific operations were included or excluded, how the actor
+     * kind influenced the essential operations selection (e.g., why guests
+     * don't have login), what schema fields enabled additional operations, and
+     * why certain authentication patterns were chosen.
+     */
+    rationale: string;
+
+    /**
+     * Array of API operations to generate authorization operation for.
+     *
+     * Each operation in this array must include:
+     *
+     * - Specification: Detailed API specification with clear purpose and
+     *   functionality
+     * - Path: Resource-centric URL path (e.g., "/resources/{resourceId}")
+     * - Method: HTTP method (get, post, put, delete, patch)
+     * - Description: Extremely detailed multi-paragraph description referencing
+     *   database schema comments
+     * - Summary: Concise one-sentence summary of the endpoint
+     * - Parameters: Array of all necessary parameters with descriptions and
+     *   schema definitions
+     * - RequestBody: For POST/PUT/PATCH methods, with typeName referencing
+     *   components.schemas
+     * - ResponseBody: With typeName referencing appropriate response type
+     *
+     * All operations must follow strict quality standards:
+     *
+     * 1. Detailed descriptions referencing database schema comments
+     * 2. Accurate parameter definitions matching path parameters
+     * 3. Appropriate request/response body type references
+     * 4. Consistent patterns for CRUD operations
+     *
+     * For list retrievals (typically PATCH), include pagination, search, and
+     * sorting. For detail retrieval (GET), return a single resource. For
+     * creation (POST), use .ICreate request body. For modification (PUT), use
+     * .IUpdate request body.
+     */
+    operations: AutoBeOpenApi.IOperation[] & tags.MinItems<1>;
+  }
+}

package/src/orchestrate/interface/structures/IAutoBeInterfaceEndpointReviewApplication.ts

@@ -1,128 +1,128 @@
-import { AutoBeInterfaceEndpointRevise } from "@autobe/interface";
-
-import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
-import { IAutoBePreliminaryGetDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetDatabaseSchemas";
-import { IAutoBePreliminaryGetPreviousAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetPreviousAnalysisSections";
-import { IAutoBePreliminaryGetPreviousDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetPreviousDatabaseSchemas";
-import { IAutoBePreliminaryGetPreviousInterfaceOperations } from "../../common/structures/IAutoBePreliminaryGetPreviousInterfaceOperations";
-
-export interface IAutoBeInterfaceEndpointReviewApplication {
-  /**
-   * Process endpoint review task or preliminary data requests.
-   *
-   * Reviews and validates generated endpoints to ensure they meet quality
-   * standards. The review process examines endpoint design, identifies issues
-   * such as duplicates or inconsistencies, and applies corrections through
-   * revision operations (keep, create, update, or erase).
-   *
-   * **Critical**: Every endpoint in the provided list MUST receive a revision
-   * decision. No omissions are allowed - use "keep" to explicitly approve
-   * endpoints that need no changes.
-   *
-   * @param props Request containing either preliminary data request or endpoint
-   *   review completion
-   */
-  process(props: IAutoBeInterfaceEndpointReviewApplication.IProps): void;
-}
-
-export namespace IAutoBeInterfaceEndpointReviewApplication {
-  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
-     * (getAnalysisSections, getDatabaseSchemas, getPreviousAnalysisSections,
-     * getPreviousDatabaseSchemas, getPreviousInterfaceOperations) or completion
-     * of the review with all modifications (complete). When preliminary returns
-     * empty array, that type is removed from the union, physically preventing
-     * repeated calls.
-     */
-    request:
-      | IComplete
-      | IAutoBePreliminaryGetAnalysisSections
-      | IAutoBePreliminaryGetDatabaseSchemas
-      | IAutoBePreliminaryGetPreviousAnalysisSections
-      | IAutoBePreliminaryGetPreviousDatabaseSchemas
-      | IAutoBePreliminaryGetPreviousInterfaceOperations;
-  }
-
-  /**
-   * Request to complete the endpoint review process.
-   *
-   * Finalizes the review by submitting revision decisions for ALL endpoints.
-   * Every endpoint in the provided list must have exactly one revision:
-   *
-   * - **keep**: Approve endpoint as-is (explicitly confirm it's correct)
-   * - **create**: Add a new endpoint that was missing
-   * - **update**: Fix an incorrectly structured endpoint
-   * - **erase**: Remove an invalid or duplicate endpoint
-   *
-   * The revisions ensure the final API structure is consistent, free of
-   * duplicates, properly designed, and aligned with RESTful conventions.
-   */
-  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";
-
-    /**
-     * Summary of issues found and fixes applied during review.
-     *
-     * Document all issues discovered during endpoint validation:
-     *
-     * - What duplicates, inconsistencies, or design issues were found?
-     * - What endpoints needed to be added, modified, or removed?
-     * - What patterns or conventions were violated?
-     *
-     * State "No issues found." if all endpoints pass review.
-     */
-    review: string;
-
-    /**
-     * Revision decisions for ALL endpoints.
-     *
-     * You MUST provide exactly one revision for each endpoint in the provided
-     * list. No omissions allowed.
-     *
-     * - Use **keep** for endpoints that are correct (do NOT simply omit them)
-     * - Use **create** to add missing endpoints
-     * - Use **update** to fix incorrectly structured endpoints
-     * - Use **erase** to remove invalid or duplicate endpoints
-     *
-     * The endpoint field in keep, update, and erase must exactly match an
-     * endpoint from the provided list (path + method).
-     *
-     * @see AutoBeInterfaceEndpointRevise - Discriminated union of revision types
-     */
-    revises: AutoBeInterfaceEndpointRevise[];
-  }
-}
+import { AutoBeInterfaceEndpointRevise } from "@autobe/interface";
+
+import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
+import { IAutoBePreliminaryGetDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetDatabaseSchemas";
+import { IAutoBePreliminaryGetPreviousAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetPreviousAnalysisSections";
+import { IAutoBePreliminaryGetPreviousDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetPreviousDatabaseSchemas";
+import { IAutoBePreliminaryGetPreviousInterfaceOperations } from "../../common/structures/IAutoBePreliminaryGetPreviousInterfaceOperations";
+
+export interface IAutoBeInterfaceEndpointReviewApplication {
+  /**
+   * Process endpoint review task or preliminary data requests.
+   *
+   * Reviews and validates generated endpoints to ensure they meet quality
+   * standards. The review process examines endpoint design, identifies issues
+   * such as duplicates or inconsistencies, and applies corrections through
+   * revision operations (keep, create, update, or erase).
+   *
+   * **Critical**: Every endpoint in the provided list MUST receive a revision
+   * decision. No omissions are allowed - use "keep" to explicitly approve
+   * endpoints that need no changes.
+   *
+   * @param props Request containing either preliminary data request or endpoint
+   *   review completion
+   */
+  process(props: IAutoBeInterfaceEndpointReviewApplication.IProps): void;
+}
+
+export namespace IAutoBeInterfaceEndpointReviewApplication {
+  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
+     * (getAnalysisSections, getDatabaseSchemas, getPreviousAnalysisSections,
+     * getPreviousDatabaseSchemas, getPreviousInterfaceOperations) or completion
+     * of the review with all modifications (complete). When preliminary returns
+     * empty array, that type is removed from the union, physically preventing
+     * repeated calls.
+     */
+    request:
+      | IComplete
+      | IAutoBePreliminaryGetAnalysisSections
+      | IAutoBePreliminaryGetDatabaseSchemas
+      | IAutoBePreliminaryGetPreviousAnalysisSections
+      | IAutoBePreliminaryGetPreviousDatabaseSchemas
+      | IAutoBePreliminaryGetPreviousInterfaceOperations;
+  }
+
+  /**
+   * Request to complete the endpoint review process.
+   *
+   * Finalizes the review by submitting revision decisions for ALL endpoints.
+   * Every endpoint in the provided list must have exactly one revision:
+   *
+   * - **keep**: Approve endpoint as-is (explicitly confirm it's correct)
+   * - **create**: Add a new endpoint that was missing
+   * - **update**: Fix an incorrectly structured endpoint
+   * - **erase**: Remove an invalid or duplicate endpoint
+   *
+   * The revisions ensure the final API structure is consistent, free of
+   * duplicates, properly designed, and aligned with RESTful conventions.
+   */
+  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";
+
+    /**
+     * Summary of issues found and fixes applied during review.
+     *
+     * Document all issues discovered during endpoint validation:
+     *
+     * - What duplicates, inconsistencies, or design issues were found?
+     * - What endpoints needed to be added, modified, or removed?
+     * - What patterns or conventions were violated?
+     *
+     * State "No issues found." if all endpoints pass review.
+     */
+    review: string;
+
+    /**
+     * Revision decisions for ALL endpoints.
+     *
+     * You MUST provide exactly one revision for each endpoint in the provided
+     * list. No omissions allowed.
+     *
+     * - Use **keep** for endpoints that are correct (do NOT simply omit them)
+     * - Use **create** to add missing endpoints
+     * - Use **update** to fix incorrectly structured endpoints
+     * - Use **erase** to remove invalid or duplicate endpoints
+     *
+     * The endpoint field in keep, update, and erase must exactly match an
+     * endpoint from the provided list (path + method).
+     *
+     * @see AutoBeInterfaceEndpointRevise - Discriminated union of revision types
+     */
+    revises: AutoBeInterfaceEndpointRevise[];
+  }
+}