@autobe/agent 0.25.0 → 0.25.2

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

@@ -65,8 +65,8 @@ export namespace IAutoBeTestWriteApplication {
      *
      * Contains the iterative improvement workflow that transforms the initial
      * draft into production-ready test code. The review phase identifies issues
-     * to fix or code to delete, followed by the final phase that produces
-     * the polished, production-ready test implementation.
+     * to fix or code to delete, followed by the final phase that produces the
+     * polished, production-ready test implementation.
      *
      * Workflow: Draft → Review analysis → Final implementation
      */
@@ -74,52 +74,6 @@ export namespace IAutoBeTestWriteApplication {
   }
 
   export interface IReviseProps {
-    // /**
-    //  * Test implementation rules compliance validation.
-    //  *
-    //  * This property tracks whether each section of the TEST_WRITE.md guidelines
-    //  * has been properly followed. Each array element represents a section from
-    //  * the documentation with its title and compliance status.
-    //  *
-    //  * Note: The specific section titles may evolve as documentation updates, so
-    //  * implementations should be flexible in handling different titles.
-    //  *
-    //  * Example:
-    //  *
-    //  * ```typescript
-    //  * rules: [
-    //  *   { title: "1. Role and Responsibility", state: true },
-    //  *   { title: "2. Input Materials Provided", state: true },
-    //  *   { title: "3. Code Generation Requirements", state: false },
-    //  *   // ... other sections
-    //  * ];
-    //  * ```
-    //  */
-    // rules: ICheck[] & tags.MinItems<1>;
-
-    // /**
-    //  * Final quality checklist validation results.
-    //  *
-    //  * This property captures the compliance status for each item in the Final
-    //  * Checklist (Section 5) from TEST_WRITE.md. Each array element represents a
-    //  * checklist item with its description and validation result.
-    //  *
-    //  * Note: Checklist items may be updated over time, so implementations should
-    //  * adapt to documentation changes while maintaining the validation purpose.
-    //  *
-    //  * Example:
-    //  *
-    //  * ```typescript
-    //  * checkList: [
-    //  *   { title: "NO additional import statements", state: true },
-    //  *   { title: "NO wrong type data in requests", state: true },
-    //  *   { title: "EVERY api.functional.* call has await", state: false },
-    //  *   // ... other checklist items
-    //  * ];
-    //  * ```
-    //  */
-    // checkList: ICheck[] & tags.MinItems<1>;
-
     /**
      * Step 4: Code review and quality assessment.
      *
@@ -180,7 +134,9 @@ export namespace IAutoBeTestWriteApplication {
      *
      * AI produces the final, polished version of the test code incorporating
      * all review feedback. This code represents the completed test
-     * implementation, ready for production deployment.
+     * implementation, ready for production deployment. When the draft code is
+     * already perfect with no issues found during review, this value can be
+     * null, indicating no revisions were necessary.
      *
      * **🚨 CRITICAL: APPLY ALL FIXES AND DELETIONS FROM REVIEW 🚨**
      *
@@ -188,41 +144,18 @@ export namespace IAutoBeTestWriteApplication {
      * - DELETE all prohibited code identified in review
      * - If review found type error tests, they MUST be deleted in final
      * - If review found code to DELETE, final MUST be different from draft
+     * - If review finds NO issues requiring changes, set to null
      *
      * All identified issues must be resolved, and the code must meet the
-     * highest quality standards.
+     * highest quality standards. A null value indicates the draft code already
+     * meets all requirements without modification.
      *
      * Workflow: Review feedback → Apply FIXES → Apply DELETIONS →
-     * Production-ready implementation
+     * Production-ready implementation (or null if no changes needed)
      *
      * This is the ultimate deliverable that will be used in the actual test
-     * suite.
+     * suite when provided, otherwise the draft is used as-is.
      */
-    final: string;
+    final: string | null;
   }
-
-  // /**
-  //  * Check validation item structure.
-  //  *
-  //  * Represents a validation check with its title and compliance state. Used for
-  //  * both rules validation and final checklist validation.
-  //  */
-  // export interface ICheck {
-  //   /**
-  //    * The title or description of the check.
-  //    *
-  //    * For rules: Section identifiers from TEST_WRITE.md (e.g., "1. Role and
-  //    * Responsibility") For checklist: Checklist item descriptions (e.g., "No
-  //    * compilation errors")
-  //    */
-  //   title: string;
-
-  //   /**
-  //    * The validation state of this check.
-  //    *
-  //    * - True: The requirement has been satisfied
-  //    * - False: The requirement has been violated or not met
-  //    */
-  //   state: boolean;
-  // }
 }

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

@@ -0,0 +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();
+};

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

@@ -7,7 +7,8 @@ export const getReferenceIds = (props: {
 }): string[] => {
   const result: Set<string> = new Set();
   const emplace = (key: string) => {
-    if (key.endsWith("_id") || key.endsWith("Id")) result.add(key);
+    if (key.endsWith("_id") || key.endsWith("Id") || key === "id")
+      result.add(key);
   };
 
   props.operation.parameters.forEach((p) => emplace(p.name));

package/lib/orchestrate/interface/histories/transformInterfacePrerequisiteHistories.d.ts

@@ -1,3 +0,0 @@
-import { IAgenticaHistoryJson } from "@agentica/core";
-import { AutoBeState } from "../../../context/AutoBeState";
-export declare const transformInterfacePrerequisiteHistories: (state: AutoBeState) => Array<IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage> | null;

package/lib/orchestrate/interface/histories/transformInterfacePrerequisiteHistories.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transformInterfacePrerequisiteHistories.js","sourceRoot":"","sources":["../../../../src/orchestrate/interface/histories/transformInterfacePrerequisiteHistories.ts"],"names":[],"mappings":";;;AACA,+BAA0B;AAInB,MAAM,uCAAuC,GAAG,CACrD,KAAkB,EAGX,EAAE;IACT,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;QACxB,OAAO;YACL;gBACE,EAAE,EAAE,IAAA,SAAE,GAAE;gBACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE;oBACJ,4CAA4C;oBAC5C,mCAAmC;oBACnC,8CAA8C;iBAC/C,CAAC,IAAI,CAAC,GAAG,CAAC;aACZ;SACF,CAAC;SACC,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI;QAC5B,OAAO;YACL;gBACE,EAAE,EAAE,IAAA,SAAE,GAAE;gBACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE;oBACJ,mDAAmD;oBACnD,mCAAmC;oBACnC,qDAAqD;iBACtD,CAAC,IAAI,CAAC,GAAG,CAAC;aACZ;SACF,CAAC;SACC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,CAAC,IAAI;QAC/C,OAAO;YACL;gBACE,EAAE,EAAE,IAAA,SAAE,GAAE;gBACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE;oBACJ,kDAAkD;oBAClD,sCAAsC;oBACtC,mCAAmC;oBACnC,wDAAwD;iBACzD,CAAC,IAAI,CAAC,GAAG,CAAC;aACZ;SACF,CAAC;SACC,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS;QAC/C,OAAO;YACL;gBACE,EAAE,EAAE,IAAA,SAAE,GAAE;gBACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE;oBACJ,kDAAkD;oBAClD,sCAAsC;oBACtC,mCAAmC;oBACnC,wDAAwD;iBACzD,CAAC,IAAI,CAAC,GAAG,CAAC;aACZ;SACF,CAAC;IACJ,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AA5DW,QAAA,uCAAuC,2CA4DlD"}

package/lib/orchestrate/interface/utils/OpenApiEndpointComparator.d.ts

@@ -1,6 +0,0 @@
-import { AutoBeOpenApi } from "@autobe/interface";
-export declare namespace OpenApiEndpointComparator {
-    function hashCode(e: AutoBeOpenApi.IEndpoint): number;
-    function equals(x: AutoBeOpenApi.IEndpoint, y: AutoBeOpenApi.IEndpoint): boolean;
-    function compare(x: AutoBeOpenApi.IEndpoint, y: AutoBeOpenApi.IEndpoint): number;
-}

package/lib/orchestrate/interface/utils/OpenApiEndpointComparator.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenApiEndpointComparator = void 0;
-const tstl_1 = require("tstl");
-var OpenApiEndpointComparator;
-(function (OpenApiEndpointComparator) {
-    function hashCode(e) {
-        return (0, tstl_1.hash)(e.path, e.method);
-    }
-    OpenApiEndpointComparator.hashCode = hashCode;
-    function equals(x, y) {
-        return x.path === y.path && x.method === y.method;
-    }
-    OpenApiEndpointComparator.equals = equals;
-    function compare(x, y) {
-        if (x.path !== y.path)
-            return x.path.localeCompare(y.path);
-        return x.method.localeCompare(y.method);
-    }
-    OpenApiEndpointComparator.compare = compare;
-})(OpenApiEndpointComparator || (exports.OpenApiEndpointComparator = OpenApiEndpointComparator = {}));
-//# sourceMappingURL=OpenApiEndpointComparator.js.map

package/lib/orchestrate/interface/utils/OpenApiEndpointComparator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"OpenApiEndpointComparator.js","sourceRoot":"","sources":["../../../../src/orchestrate/interface/utils/OpenApiEndpointComparator.ts"],"names":[],"mappings":";;;AACA,+BAA4B;AAE5B,IAAiB,yBAAyB,CAmBzC;AAnBD,WAAiB,yBAAyB;IACxC,SAAgB,QAAQ,CAAC,CAA0B;QACjD,OAAO,IAAA,WAAI,EAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAFe,kCAAQ,WAEvB,CAAA;IAED,SAAgB,MAAM,CACpB,CAA0B,EAC1B,CAA0B;QAE1B,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC;IACpD,CAAC;IALe,gCAAM,SAKrB,CAAA;IAED,SAAgB,OAAO,CACrB,CAA0B,EAC1B,CAA0B;QAE1B,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3D,OAAO,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IANe,iCAAO,UAMtB,CAAA;AACH,CAAC,EAnBgB,yBAAyB,yCAAzB,yBAAyB,QAmBzC"}

package/src/orchestrate/interface/utils/OpenApiEndpointComparator.ts

@@ -1,23 +0,0 @@
-import { AutoBeOpenApi } from "@autobe/interface";
-import { hash } from "tstl";
-
-export namespace OpenApiEndpointComparator {
-  export function hashCode(e: AutoBeOpenApi.IEndpoint): number {
-    return hash(e.path, e.method);
-  }
-
-  export function equals(
-    x: AutoBeOpenApi.IEndpoint,
-    y: AutoBeOpenApi.IEndpoint,
-  ): boolean {
-    return x.path === y.path && x.method === y.method;
-  }
-
-  export function compare(
-    x: AutoBeOpenApi.IEndpoint,
-    y: AutoBeOpenApi.IEndpoint,
-  ): number {
-    if (x.path !== y.path) return x.path.localeCompare(y.path);
-    return x.method.localeCompare(y.method);
-  }
-}