@autobe/agent 0.19.1 → 0.20.0

package/src/orchestrate/realize/internal/{compile.ts → compileRealizeFiles.ts}

@@ -2,13 +2,15 @@ import {
   AutoBeRealizeAuthorization,
   AutoBeRealizeFunction,
   AutoBeRealizeValidateEvent,
+  IAutoBeCompiler,
   IAutoBeTypeScriptCompileResult,
 } from "@autobe/interface";
 import { ILlmSchema } from "@samchon/openapi";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../../context/AutoBeContext";
 
-export async function compile<Model extends ILlmSchema.Model>(
+export async function compileRealizeFiles<Model extends ILlmSchema.Model>(
   ctx: AutoBeContext<Model>,
   props: {
     authorizations: AutoBeRealizeAuthorization[];
@@ -19,11 +21,14 @@ export async function compile<Model extends ILlmSchema.Model>(
   const payloads: Record<string, string> = Object.fromEntries(
     props.authorizations.map((el) => [el.payload.location, el.payload.content]),
   );
-  const compiler = await ctx.compiler();
-  const templateFiles = await compiler.realize.getTemplate();
-  const nodeModules = prisma?.type === "success" ? prisma.nodeModules : {};
+  const compiler: IAutoBeCompiler = await ctx.compiler();
+  const templateFiles: Record<string, string> =
+    await compiler.realize.getTemplate();
+  const nodeModules: Record<string, string> =
+    prisma?.type === "success" ? prisma.nodeModules : {};
 
-  const filterTsFiles = (location: string) => location.endsWith(".ts");
+  const filterTsFiles = (location: string) =>
+    location.startsWith("src/") && location.endsWith(".ts");
 
   const files: Record<string, string> = {
     ...nodeModules,
@@ -41,17 +46,17 @@ export async function compile<Model extends ILlmSchema.Model>(
     ),
   };
 
-  const compiled = await compiler.typescript.compile({
-    files: files,
-  });
-
+  const compiled: IAutoBeTypeScriptCompileResult =
+    await compiler.typescript.compile({
+      files: files,
+    });
   if (compiled.type === "success") {
     return compiled;
-  } else if (compiled.type === "failure") {
   }
 
   const event: AutoBeRealizeValidateEvent = {
     type: "realizeValidate",
+    id: v7(),
     result: compiled,
     files: Object.fromEntries(
       compiled.type === "failure"
@@ -62,6 +67,5 @@ export async function compile<Model extends ILlmSchema.Model>(
     created_at: new Date().toISOString(),
   };
   ctx.dispatch(event);
-
   return compiled;
 }

package/src/orchestrate/realize/orchestrateRealize.ts

@@ -1,6 +1,7 @@
 import {
   AutoBeAssistantMessageHistory,
   AutoBeOpenApi,
+  AutoBeProgressEventBase,
   AutoBeRealizeAuthorization,
   AutoBeRealizeFunction,
   AutoBeRealizeHistory,
@@ -9,12 +10,13 @@ import {
   IAutoBeTypeScriptCompileResult,
 } from "@autobe/interface";
 import { ILlmSchema } from "@samchon/openapi";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { IAutoBeApplicationProps } from "../../context/IAutoBeApplicationProps";
+import { executeCachedBatch } from "../../utils/executeCachedBatch";
 import { predicateStateMessage } from "../../utils/predicateStateMessage";
-import { compile } from "./internal/compile";
+import { compileRealizeFiles } from "./internal/compileRealizeFiles";
 import { orchestrateRealizeAuthorization } from "./orchestrateRealizeAuthorization";
 import { orchestrateRealizeCorrect } from "./orchestrateRealizeCorrect";
 import { orchestrateRealizeScenario } from "./orchestrateRealizeScenario";
@@ -40,13 +42,14 @@ export const orchestrateRealize =
     if (predicate !== null)
       return ctx.assistantMessage({
         type: "assistantMessage",
-        id: v4(),
+        id: v7(),
         created_at: start.toISOString(),
         text: predicate,
         completed_at: new Date().toISOString(),
       });
     ctx.dispatch({
       type: "realizeStart",
+      id: v7(),
       created_at: start.toISOString(),
       reason: props.reason,
       step: ctx.state().test?.step ?? 0,
@@ -66,14 +69,18 @@ export const orchestrateRealize =
         return orchestrateRealizeScenario(ctx, operation, authorization);
       });
 
-    const writeProgress = { total: scenarios.length, completed: 0 };
-    const writeEvents: AutoBeRealizeWriteEvent[] = await Promise.all(
-      scenarios.map(async (scenario) => {
-        const code = orchestrateRealizeWrite(ctx, {
+    const writeProgress: AutoBeProgressEventBase = {
+      total: scenarios.length,
+      completed: 0,
+    };
+    const writeEvents: AutoBeRealizeWriteEvent[] = await executeCachedBatch(
+      scenarios.map((scenario) => async (promptCacheKey) => {
+        const code = await orchestrateRealizeWrite(ctx, {
           totalAuthorizations: authorizations,
           authorization: scenario.decoratorEvent ?? null,
           scenario,
           progress: writeProgress,
+          promptCacheKey,
         });
         return code;
       }),
@@ -96,12 +103,16 @@ export const orchestrateRealize =
       };
     });
 
-    let compilation = await compile(ctx, { authorizations, functions });
+    let compilation = await compileRealizeFiles(ctx, {
+      authorizations,
+      functions,
+    });
 
     if (compilation.type !== "success") {
-      const MAX_CORRECTION_ATTEMPTS = 3 as const;
+      const MAX_CORRECTION_ATTEMPTS = 5 as const;
 
       const reviewProgress = {
+        id: v7(),
         total: writeEvents.length,
         completed: writeEvents.length,
       };
@@ -117,37 +128,45 @@ export const orchestrateRealize =
           reviewProgress.total += Object.keys(failedFiles).length;
           const failure: IAutoBeTypeScriptCompileResult.IFailure = compilation;
 
-          await Promise.all(
-            Object.entries(failedFiles).map(async ([location, content]) => {
-              const diagnostic:
-                | IAutoBeTypeScriptCompileResult.IDiagnostic
-                | undefined = failure.diagnostics.find(
-                (el) => el.file === location,
-              );
-
-              const scenario = scenarios.find((el) => el.location === location);
-              if (diagnostic && scenario) {
-                const correctEvent = await orchestrateRealizeCorrect(ctx, {
-                  totalAuthorizations: authorizations,
-                  authorization: scenario.decoratorEvent ?? null,
-                  scenario,
-                  code: content,
-                  diagnostic,
-                  progress: reviewProgress,
-                });
-
-                const corrected = functions.find(
-                  (el) => el.location === correctEvent.location,
-                );
-
-                if (corrected) {
-                  corrected.content = correctEvent.content;
-                }
-              }
-            }),
+          await executeCachedBatch(
+            Object.entries(failedFiles).map(
+              ([location, content]) =>
+                async () => {
+                  const diagnostic:
+                    | IAutoBeTypeScriptCompileResult.IDiagnostic
+                    | undefined = failure.diagnostics.find(
+                    (el) => el.file === location,
+                  );
+
+                  const scenario = scenarios.find(
+                    (el) => el.location === location,
+                  );
+                  if (diagnostic && scenario) {
+                    const correctEvent = await orchestrateRealizeCorrect(ctx, {
+                      totalAuthorizations: authorizations,
+                      authorization: scenario.decoratorEvent ?? null,
+                      scenario,
+                      code: content,
+                      diagnostic,
+                      progress: reviewProgress,
+                    });
+
+                    const corrected = functions.find(
+                      (el) => el.location === correctEvent.location,
+                    );
+
+                    if (corrected) {
+                      corrected.content = correctEvent.content;
+                    }
+                  }
+                },
+            ),
           );
 
-          compilation = await compile(ctx, { authorizations, functions });
+          compilation = await compileRealizeFiles(ctx, {
+            authorizations,
+            functions,
+          });
           if (compilation.type === "success") {
             break;
           }
@@ -162,14 +181,14 @@ export const orchestrateRealize =
         functions,
         authorizations,
       });
-
     return ctx.dispatch({
       type: "realizeComplete",
+      id: v7(),
       created_at: new Date().toISOString(),
       functions,
       authorizations,
       controllers,
-      compiled: await compile(ctx, { authorizations, functions }),
+      compiled: await compileRealizeFiles(ctx, { authorizations, functions }),
       step: ctx.state().analyze?.step ?? 0,
       elapsed: new Date().getTime() - start.getTime(),
     });

package/src/orchestrate/realize/orchestrateRealizeAuthorization.ts

@@ -9,9 +9,11 @@ import {
 import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
 import { IPointer } from "tstl";
 import typia from "typia";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
+import { executeCachedBatch } from "../../utils/executeCachedBatch";
 import { transformRealizeAuthorizationHistories } from "./histories/transformRealizeAuthorization";
 import { orchestrateRealizeAuthorizationCorrect } from "./orchestrateRealizeAuthorizationCorrect";
 import { IAutoBeRealizeAuthorizationApplication } from "./structures/IAutoBeRealizeAuthorizationApplication";
@@ -29,6 +31,7 @@ export async function orchestrateRealizeAuthorization<
 >(ctx: AutoBeContext<Model>): Promise<AutoBeRealizeAuthorization[]> {
   ctx.dispatch({
     type: "realizeAuthorizationStart",
+    id: v7(),
     step: ctx.state().test?.step ?? 0,
     created_at: new Date().toISOString(),
   });
@@ -39,20 +42,23 @@ export async function orchestrateRealizeAuthorization<
     completed: 0,
   };
   const templateFiles = await (await ctx.compiler()).realize.getTemplate();
-  const authorizations: AutoBeRealizeAuthorization[] = await Promise.all(
-    roles.map((role) =>
-      process(
-        ctx,
-        role,
-        InternalFileSystem.DEFAULT.map((el) => ({
-          [el]: templateFiles[el],
-        })).reduce((acc, cur) => Object.assign(acc, cur), {}),
-        progress,
-      ),
+  const authorizations: AutoBeRealizeAuthorization[] = await executeCachedBatch(
+    roles.map(
+      (role) => (promptCacheKey) =>
+        process(
+          ctx,
+          role,
+          InternalFileSystem.DEFAULT.map((el) => ({
+            [el]: templateFiles[el],
+          })).reduce((acc, cur) => Object.assign(acc, cur), {}),
+          progress,
+          promptCacheKey,
+        ),
     ),
   );
   ctx.dispatch({
     type: "realizeAuthorizationComplete",
+    id: v7(),
     created_at: new Date().toISOString(),
     step: ctx.state().test?.step ?? 0,
   });
@@ -64,6 +70,7 @@ async function process<Model extends ILlmSchema.Model>(
   role: AutoBeAnalyzeRole,
   templateFiles: Record<string, string>,
   progress: AutoBeProgressEventBase,
+  promptCacheKey: string,
 ): Promise<AutoBeRealizeAuthorization> {
   const pointer: IPointer<IAutoBeRealizeAuthorizationApplication.IProps | null> =
     {
@@ -79,6 +86,7 @@ async function process<Model extends ILlmSchema.Model>(
       },
     }),
     enforceFunctionCall: true,
+    promptCacheKey,
     message: "Create Authorization Provider and Decorator.",
   });
   if (pointer.value === null) throw new Error("Failed to create decorator.");
@@ -114,6 +122,7 @@ async function process<Model extends ILlmSchema.Model>(
 
   ctx.dispatch({
     type: "realizeAuthorizationWrite",
+    id: v7(),
     created_at: new Date().toISOString(),
     authorization: authorization,
     tokenUsage,

package/src/orchestrate/realize/orchestrateRealizeAuthorizationCorrect.ts

@@ -8,6 +8,7 @@ import {
 import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
 import { IPointer } from "tstl";
 import typia from "typia";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
@@ -58,6 +59,7 @@ export async function orchestrateRealizeAuthorizationCorrect<
 
   ctx.dispatch({
     type: "realizeAuthorizationValidate",
+    id: v7(),
     created_at: new Date().toISOString(),
     authorization: authorization,
     result: compiled,
@@ -120,6 +122,7 @@ export async function orchestrateRealizeAuthorizationCorrect<
   ctx.dispatch({
     ...pointer.value,
     type: "realizeAuthorizationCorrect",
+    id: v7(),
     created_at: new Date().toISOString(),
     authorization: result,
     result: compiled,

package/src/orchestrate/realize/orchestrateRealizeCorrect.ts

@@ -1,11 +1,14 @@
 import {
+  AutoBeProgressEventBase,
   AutoBeRealizeAuthorization,
   AutoBeRealizeCorrectEvent,
   IAutoBeTypeScriptCompileResult,
 } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
 import { ILlmApplication, ILlmController, ILlmSchema } from "@samchon/openapi";
 import { IPointer } from "tstl";
 import typia from "typia";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
@@ -24,7 +27,7 @@ export async function orchestrateRealizeCorrect<Model extends ILlmSchema.Model>(
     scenario: IAutoBeRealizeScenarioApplication.IProps;
     code: string;
     diagnostic: IAutoBeTypeScriptCompileResult.IDiagnostic;
-    progress: IProgress;
+    progress: AutoBeProgressEventBase;
   },
 ): Promise<AutoBeRealizeCorrectEvent> {
   const artifacts: IAutoBeTestScenarioArtifacts =
@@ -54,10 +57,11 @@ export async function orchestrateRealizeCorrect<Model extends ILlmSchema.Model>(
       totalAuthorizations: props.totalAuthorizations,
     }),
     enforceFunctionCall: true,
-    message: [
-      `Correct the TypeScript code implementation to strictly follow these rules:`,
-      `1. Ensure that the code is production-ready and follows best practices.`,
-    ].join("\n"),
+    message: StringUtil.trim`
+      Correct the TypeScript code implementation to strictly follow these rules:
+      
+      1. Ensure that the code is production-ready and follows best practices.
+    `,
   });
 
   if (pointer.value === null)
@@ -71,6 +75,7 @@ export async function orchestrateRealizeCorrect<Model extends ILlmSchema.Model>(
 
   const event: AutoBeRealizeCorrectEvent = {
     type: "realizeCorrect",
+    id: v7(),
     location: props.scenario.location,
     content: pointer.value.implementationCode,
     tokenUsage,
@@ -115,8 +120,3 @@ const collection = {
   deepseek: claude,
   "3.1": claude,
 };
-
-export interface IProgress {
-  total: number;
-  completed: number;
-}

package/src/orchestrate/realize/orchestrateRealizeScenario.ts

@@ -4,80 +4,6 @@ import { ILlmSchema } from "@samchon/openapi";
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { IAutoBeRealizeScenarioApplication } from "./structures/IAutoBeRealizeScenarioApplication";
 
-export interface IAutoBeRealizeScenario {
-  /**
-   * 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;
-
-  /**
-   * Definition of path and query parameters extracted from the OpenAPI spec.
-   *
-   * Includes input values passed via URL path or query string. Used for type
-   * definitions, validation, and function signature construction.
-   */
-  parameters: AutoBeOpenApi.IParameter[];
-
-  /**
-   * Schema definition for the request body input.
-   *
-   * Extracted from the requestBody section of Swagger. Represents the input
-   * data passed in the body (e.g., JSON). Used for generating function
-   * arguments or DTOs.
-   */
-  inputSchema: AutoBeOpenApi.IRequestBody | null;
-
-  /**
-   * Schema definition for the response body.
-   *
-   * Extracted from the responses section of Swagger. Used to define the return
-   * type and expected output in test code.
-   */
-  outputSchema: AutoBeOpenApi.IResponseBody | null;
-
-  /**
-   * Natural language description of the function’s purpose.
-   *
-   * Extracted from the summary or description field of Swagger. Used for code
-   * documentation, test scenario generation, and conveying function intent.
-   */
-  description: string;
-
-  /**
-   * HTTP method information.
-   *
-   * Extracted from the Swagger operation method. Used to define the request
-   * type during code and test generation.
-   */
-  method: "get" | "post" | "put" | "delete" | "patch";
-
-  /**
-   * List of scenario descriptions for test code generation.
-   *
-   * Each scenario describes the expected behavior of the function under certain
-   * conditions. Used as a basis for TDD-style automated test generation.
-   */
-  testScenarios: 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;
-}
-
 /**
  * Generates a planning result that defines what kind of function should be
  * created, based solely on the provided Swagger (OpenAPI) operation — without

package/src/orchestrate/realize/orchestrateRealizeWrite.ts

@@ -1,10 +1,13 @@
 import {
+  AutoBeProgressEventBase,
   AutoBeRealizeAuthorization,
   AutoBeRealizeWriteEvent,
 } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
 import { ILlmApplication, ILlmController, ILlmSchema } from "@samchon/openapi";
 import { IPointer } from "tstl";
 import typia from "typia";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
@@ -21,7 +24,8 @@ export async function orchestrateRealizeWrite<Model extends ILlmSchema.Model>(
     totalAuthorizations: AutoBeRealizeAuthorization[];
     authorization: AutoBeRealizeAuthorization | null;
     scenario: IAutoBeRealizeScenarioApplication.IProps;
-    progress: IProgress;
+    progress: AutoBeProgressEventBase;
+    promptCacheKey: string;
   },
 ): Promise<AutoBeRealizeWriteEvent> {
   const artifacts: IAutoBeTestScenarioArtifacts =
@@ -48,23 +52,24 @@ export async function orchestrateRealizeWrite<Model extends ILlmSchema.Model>(
       },
     }),
     enforceFunctionCall: true,
-    message: [
-      `Write complete, production-ready TypeScript code that strictly follows these rules:`,
-      "",
-      `DO NOT:`,
-      `- Use the native \`Date\` type anywhere`,
-      `- Use \`as\` for type assertions`,
-      ``,
-      `DO:`,
-      `- Write all date/datetime values as \`string & tags.Format<'date-time'>\``,
-      `- Generate UUIDs using \`v4()\` and type as \`string & tags.Format<'uuid'>\``,
-      `- Resolve types properly without assertions`,
-      `- Type all functions with clear parameter and return types`,
-      `6. Do not skip validations or default values where necessary.`,
-      `7. Follow functional, immutable, and consistent code structure.`,
-      "",
-      `Use \`@nestia/e2e\` test structure if relevant.`,
-    ].join("\n"),
+    promptCacheKey: props.promptCacheKey,
+    message: StringUtil.trim`
+      Write complete, production-ready TypeScript code that strictly follows these rules:
+
+      DO NOT:
+      - Use the native \`Date\` type anywhere
+      - Use \`as\` for type assertions
+
+      DO:
+      - Write all date/datetime values as \`string & tags.Format<'date-time'>\`
+      - Generate UUIDs using \`v4()\` and type as \`string & tags.Format<'uuid'>\`
+      - Resolve types properly without assertions
+      - Type all functions with clear parameter and return types
+      6. Do not skip validations or default values where necessary.
+      7. Follow functional, immutable, and consistent code structure.
+
+      Use \`@nestia/e2e\` test structure if relevant.
+    `,
   });
   if (pointer.value === null) throw new Error("Failed to write code.");
 
@@ -76,6 +81,7 @@ export async function orchestrateRealizeWrite<Model extends ILlmSchema.Model>(
 
   const event: AutoBeRealizeWriteEvent = {
     type: "realizeWrite",
+    id: v7(),
     location: props.scenario.location,
     content: pointer.value.implementationCode,
     tokenUsage,
@@ -121,8 +127,3 @@ const collection = {
   deepseek: claude,
   "3.1": claude,
 };
-
-export interface IProgress {
-  total: number;
-  completed: number;
-}

package/src/orchestrate/test/compile/completeTestCode.ts

@@ -1,3 +1,5 @@
+import { StringUtil } from "@autobe/utils";
+
 import { IAutoBeTestScenarioArtifacts } from "../structures/IAutoBeTestScenarioArtifacts";
 
 export function completeTestCode(
@@ -18,18 +20,20 @@ export function completeTestCode(
     'string & Format<"uuid">',
     'string & tags.Format<"uuid">',
   );
-  code = [
-    `import { ArrayUtil, RandomGenerator, TestValidator } from "@nestia/e2e";`,
-    `import { IConnection } from "@nestia/fetcher";`,
-    `import typia, { tags } from "typia";`,
-    "",
-    `import api from "@ORGANIZATION/PROJECT-api";`,
-    ...typeReferences.map(
-      (ref) =>
-        `import type { ${ref} } from "@ORGANIZATION/PROJECT-api/lib/structures/${ref}";`,
-    ),
-    "",
-    code,
-  ].join("\n");
+  code = StringUtil.trim`
+    import { ArrayUtil, RandomGenerator, TestValidator } from "@nestia/e2e";
+    import { IConnection } from "@nestia/fetcher";
+    import typia, { tags } from "typia";
+    
+    import api from "@ORGANIZATION/PROJECT-api";
+    ${typeReferences
+      .map(
+        (ref) =>
+          `import type { ${ref} } from "@ORGANIZATION/PROJECT-api/lib/structures/${ref}";`,
+      )
+      .join("\n")}
+    
+    ${code}
+  `;
   return code;
 }

package/src/orchestrate/test/experimental/transformTestCorrectHistories.ast

@@ -1,6 +1,6 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { IAutoBeTypeScriptCompileResult } from "@autobe/interface";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../constants/AutoBeSystemPromptConstant";
 import { IAutoBeTestWriteResult } from "./structures/IAutoBeTestWriteResult";
@@ -14,13 +14,13 @@ export const transformTestCorrectHistories = (
 > => {
   return [
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.TEST_WRITE,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "assistantMessage",
       text: [
@@ -43,7 +43,7 @@ export const transformTestCorrectHistories = (
       ].join("\n"),
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.TEST_CORRECT,