@autobe/agent 0.30.0-dev.20260315 → 0.30.1

package/src/orchestrate/test/structures/IAutoBeTestScenarioReviewApplication.ts

@@ -1,133 +1,133 @@
-import { AutoBeTestScenario } from "@autobe/interface";
-
-import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
-import { IAutoBePreliminaryGetInterfaceOperations } from "../../common/structures/IAutoBePreliminaryGetInterfaceOperations";
-import { IAutoBePreliminaryGetInterfaceSchemas } from "../../common/structures/IAutoBePreliminaryGetInterfaceSchemas";
-
-export interface IAutoBeTestScenarioReviewApplication {
-  /**
-   * Process test scenario review task or preliminary data requests.
-   *
-   * Reviews generated test scenarios to validate implementability, dependency
-   * correctness, and business logic coverage, producing necessary improvements
-   * via RAG-based context retrieval.
-   *
-   * @param props Request containing either preliminary data request or complete
-   *   task
-   */
-  process(props: IAutoBeTestScenarioReviewApplication.IProps): void;
-}
-
-export namespace IAutoBeTestScenarioReviewApplication {
-  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, getInterfaceOperations, getInterfaceSchemas) or
-     * final test scenario review (complete). When preliminary returns empty
-     * array, that type is removed from the union, physically preventing
-     * repeated calls.
-     */
-    request:
-      | IComplete
-      | IAutoBePreliminaryGetAnalysisSections
-      | IAutoBePreliminaryGetInterfaceOperations
-      | IAutoBePreliminaryGetInterfaceSchemas;
-  }
-
-  /**
-   * Request to review and refine a single test scenario.
-   *
-   * Executes comprehensive scenario review to validate implementability,
-   * dependency correctness, authentication flows, and business logic coverage,
-   * producing refined scenario ready for test implementation.
-   */
-  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";
-
-    /**
-     * Comprehensive review analysis of the test scenario.
-     *
-     * Analyzes the scenario for implementability, dependency correctness,
-     * authentication flows, execution order, and business logic coverage.
-     * Documents identified issues and applied corrections.
-     *
-     * Should include:
-     *
-     * - Authentication validation (correct authorizationActor alignment)
-     * - Dependency completeness (all prerequisites present)
-     * - Execution order verification (proper sequencing)
-     * - Business logic coverage assessment
-     * - Specific issues found and corrections applied
-     */
-    review: string;
-
-    /**
-     * The review result: improved scenario, deletion flag, or null.
-     *
-     * Decision logic (THREE possible outcomes):
-     *
-     * - If scenario VIOLATES ABSOLUTE PROHIBITIONS (tests HTTP 400 validation
-     *   errors, invalid types, missing fields, etc.) → Return "erase" to delete
-     *   the entire scenario
-     * - If scenario needs improvements (auth fixes, dependency corrections,
-     *   reordering) → Return the complete improved AutoBeTestScenario
-     * - If scenario is already perfect with no issues → Return null
-     *
-     * When returning "erase":
-     *
-     * - Scenario tests framework-level validations (forbidden per Section 2.1 of
-     *   TEST_SCENARIO.md)
-     * - Scenario tests type mismatches, missing fields, invalid formats, or any
-     *   HTTP 400 validation errors
-     * - These scenarios are fundamentally wrong and must be completely removed
-     * - Document in review field WHY the scenario was erased
-     *
-     * When returning improved scenario:
-     *
-     * - Endpoint MUST match the original (same method and path)
-     * - FunctionName MUST match the original (same name)
-     * - Draft can be improved if needed
-     * - Dependencies should be corrected and properly ordered
-     *
-     * When returning null:
-     *
-     * - Scenario is correct and implementable as-is
-     * - No authentication issues, dependency problems, or ordering errors
-     * - Tests business logic, not framework validations
-     */
-    content: AutoBeTestScenario | "erase" | null;
-  }
-}
+import { AutoBeTestScenario } from "@autobe/interface";
+
+import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
+import { IAutoBePreliminaryGetInterfaceOperations } from "../../common/structures/IAutoBePreliminaryGetInterfaceOperations";
+import { IAutoBePreliminaryGetInterfaceSchemas } from "../../common/structures/IAutoBePreliminaryGetInterfaceSchemas";
+
+export interface IAutoBeTestScenarioReviewApplication {
+  /**
+   * Process test scenario review task or preliminary data requests.
+   *
+   * Reviews generated test scenarios to validate implementability, dependency
+   * correctness, and business logic coverage, producing necessary improvements
+   * via RAG-based context retrieval.
+   *
+   * @param props Request containing either preliminary data request or complete
+   *   task
+   */
+  process(props: IAutoBeTestScenarioReviewApplication.IProps): void;
+}
+
+export namespace IAutoBeTestScenarioReviewApplication {
+  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, getInterfaceOperations, getInterfaceSchemas) or
+     * final test scenario review (complete). When preliminary returns empty
+     * array, that type is removed from the union, physically preventing
+     * repeated calls.
+     */
+    request:
+      | IComplete
+      | IAutoBePreliminaryGetAnalysisSections
+      | IAutoBePreliminaryGetInterfaceOperations
+      | IAutoBePreliminaryGetInterfaceSchemas;
+  }
+
+  /**
+   * Request to review and refine a single test scenario.
+   *
+   * Executes comprehensive scenario review to validate implementability,
+   * dependency correctness, authentication flows, and business logic coverage,
+   * producing refined scenario ready for test implementation.
+   */
+  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";
+
+    /**
+     * Comprehensive review analysis of the test scenario.
+     *
+     * Analyzes the scenario for implementability, dependency correctness,
+     * authentication flows, execution order, and business logic coverage.
+     * Documents identified issues and applied corrections.
+     *
+     * Should include:
+     *
+     * - Authentication validation (correct authorizationActor alignment)
+     * - Dependency completeness (all prerequisites present)
+     * - Execution order verification (proper sequencing)
+     * - Business logic coverage assessment
+     * - Specific issues found and corrections applied
+     */
+    review: string;
+
+    /**
+     * The review result: improved scenario, deletion flag, or null.
+     *
+     * Decision logic (THREE possible outcomes):
+     *
+     * - If scenario VIOLATES ABSOLUTE PROHIBITIONS (tests HTTP 400 validation
+     *   errors, invalid types, missing fields, etc.) → Return "erase" to delete
+     *   the entire scenario
+     * - If scenario needs improvements (auth fixes, dependency corrections,
+     *   reordering) → Return the complete improved AutoBeTestScenario
+     * - If scenario is already perfect with no issues → Return null
+     *
+     * When returning "erase":
+     *
+     * - Scenario tests framework-level validations (forbidden per Section 2.1 of
+     *   TEST_SCENARIO.md)
+     * - Scenario tests type mismatches, missing fields, invalid formats, or any
+     *   HTTP 400 validation errors
+     * - These scenarios are fundamentally wrong and must be completely removed
+     * - Document in review field WHY the scenario was erased
+     *
+     * When returning improved scenario:
+     *
+     * - Endpoint MUST match the original (same method and path)
+     * - FunctionName MUST match the original (same name)
+     * - Draft can be improved if needed
+     * - Dependencies should be corrected and properly ordered
+     *
+     * When returning null:
+     *
+     * - Scenario is correct and implementable as-is
+     * - No authentication issues, dependency problems, or ordering errors
+     * - Tests business logic, not framework validations
+     */
+    content: AutoBeTestScenario | "erase" | null;
+  }
+}

package/src/orchestrate/test/utils/getPrerequisites.ts

@@ -1,51 +1,51 @@
-import { AutoBeOpenApi } from "@autobe/interface";
-import { AutoBeOpenApiEndpointComparator } from "@autobe/utils";
-import { HashMap } from "tstl";
-
-export const getPrerequisites = (props: {
-  document: AutoBeOpenApi.IDocument;
-  endpoint: AutoBeOpenApi.IEndpoint;
-}): AutoBeOpenApi.IPrerequisite[] => {
-  const visited: Set<string> = new Set<string>();
-  const result: HashMap<
-    AutoBeOpenApi.IEndpoint,
-    AutoBeOpenApi.IPrerequisite[]
-  > = new HashMap<AutoBeOpenApi.IEndpoint, AutoBeOpenApi.IPrerequisite[]>(
-    AutoBeOpenApiEndpointComparator.hashCode,
-    AutoBeOpenApiEndpointComparator.equals,
-  );
-
-  const traverse = (endpoint: AutoBeOpenApi.IEndpoint): void => {
-    const key = `${endpoint.method}:${endpoint.path}`;
-
-    // prevent circular structure: skip visited endpoint
-    if (visited.has(key)) return;
-    visited.add(key);
-
-    const operation: AutoBeOpenApi.IOperation | undefined =
-      props.document.operations.find(
-        (op) => op.method === endpoint.method && op.path === endpoint.path,
-      );
-
-    if (operation === undefined) return;
-
-    // add current operation's prerequisites
-    for (const prerequisite of operation.prerequisites) {
-      // check if already in result to avoid duplicates
-      const exists: boolean = result.has(prerequisite.endpoint);
-
-      if (!exists) {
-        result.set(prerequisite.endpoint, [prerequisite]);
-      }
-
-      // recursively traverse prerequisite's prerequisites
-      traverse(prerequisite.endpoint);
-    }
-  };
-
-  traverse(props.endpoint);
-  return result
-    .toJSON()
-    .map((it) => it.second)
-    .flat();
-};
+import { AutoBeOpenApi } from "@autobe/interface";
+import { AutoBeOpenApiEndpointComparator } from "@autobe/utils";
+import { HashMap } from "tstl";
+
+export const getPrerequisites = (props: {
+  document: AutoBeOpenApi.IDocument;
+  endpoint: AutoBeOpenApi.IEndpoint;
+}): AutoBeOpenApi.IPrerequisite[] => {
+  const visited: Set<string> = new Set<string>();
+  const result: HashMap<
+    AutoBeOpenApi.IEndpoint,
+    AutoBeOpenApi.IPrerequisite[]
+  > = new HashMap<AutoBeOpenApi.IEndpoint, AutoBeOpenApi.IPrerequisite[]>(
+    AutoBeOpenApiEndpointComparator.hashCode,
+    AutoBeOpenApiEndpointComparator.equals,
+  );
+
+  const traverse = (endpoint: AutoBeOpenApi.IEndpoint): void => {
+    const key = `${endpoint.method}:${endpoint.path}`;
+
+    // prevent circular structure: skip visited endpoint
+    if (visited.has(key)) return;
+    visited.add(key);
+
+    const operation: AutoBeOpenApi.IOperation | undefined =
+      props.document.operations.find(
+        (op) => op.method === endpoint.method && op.path === endpoint.path,
+      );
+
+    if (operation === undefined) return;
+
+    // add current operation's prerequisites
+    for (const prerequisite of operation.prerequisites) {
+      // check if already in result to avoid duplicates
+      const exists: boolean = result.has(prerequisite.endpoint);
+
+      if (!exists) {
+        result.set(prerequisite.endpoint, [prerequisite]);
+      }
+
+      // recursively traverse prerequisite's prerequisites
+      traverse(prerequisite.endpoint);
+    }
+  };
+
+  traverse(props.endpoint);
+  return result
+    .toJSON()
+    .map((it) => it.second)
+    .flat();
+};

package/src/orchestrate/test/utils/getReferenceIds.ts

@@ -1,26 +1,26 @@
-import { AutoBeOpenApi } from "@autobe/interface";
-import { OpenApiTypeChecker } from "@typia/utils";
-
-export const getReferenceIds = (props: {
-  document: AutoBeOpenApi.IDocument;
-  operation: AutoBeOpenApi.IOperation;
-}): string[] => {
-  const result: Set<string> = new Set();
-  const emplace = (key: string) => {
-    if (key.endsWith("_id") || key.endsWith("Id") || key === "id")
-      result.add(key);
-  };
-
-  props.operation.parameters.forEach((p) => emplace(p.name));
-  if (props.operation.requestBody) {
-    OpenApiTypeChecker.visit({
-      components: props.document.components,
-      schema: { $ref: props.operation.requestBody.typeName },
-      closure: (schema) => {
-        if (OpenApiTypeChecker.isObject(schema) === false) return;
-        for (const key of Object.keys(schema.properties ?? {})) emplace(key);
-      },
-    });
-  }
-  return Array.from(result);
-};
+import { AutoBeOpenApi } from "@autobe/interface";
+import { OpenApiTypeChecker } from "@typia/utils";
+
+export const getReferenceIds = (props: {
+  document: AutoBeOpenApi.IDocument;
+  operation: AutoBeOpenApi.IOperation;
+}): string[] => {
+  const result: Set<string> = new Set();
+  const emplace = (key: string) => {
+    if (key.endsWith("_id") || key.endsWith("Id") || key === "id")
+      result.add(key);
+  };
+
+  props.operation.parameters.forEach((p) => emplace(p.name));
+  if (props.operation.requestBody) {
+    OpenApiTypeChecker.visit({
+      components: props.document.components,
+      schema: { $ref: props.operation.requestBody.typeName },
+      closure: (schema) => {
+        if (OpenApiTypeChecker.isObject(schema) === false) return;
+        for (const key of Object.keys(schema.properties ?? {})) emplace(key);
+      },
+    });
+  }
+  return Array.from(result);
+};

package/src/orchestrate/test/utils/insertScriptToTestResult.ts

@@ -1,14 +1,14 @@
-import { IAutoBeTestProcedure } from "../structures/IAutoBeTestProcedure";
-
-export const insertScriptToTestResult = <Item extends IAutoBeTestProcedure>(
-  item: Item,
-  script: string,
-): Item => {
-  return {
-    ...item,
-    function: {
-      ...item.function,
-      content: script,
-    },
-  };
-};
+import { IAutoBeTestProcedure } from "../structures/IAutoBeTestProcedure";
+
+export const insertScriptToTestResult = <Item extends IAutoBeTestProcedure>(
+  item: Item,
+  script: string,
+): Item => {
+  return {
+    ...item,
+    function: {
+      ...item.function,
+      content: script,
+    },
+  };
+};