@autobe/agent 0.19.1 → 0.20.0

package/src/orchestrate/interface/orchestrateInterface.ts

@@ -9,7 +9,7 @@ import {
 import { AutoBeEndpointComparator } from "@autobe/utils";
 import { ILlmSchema } from "@samchon/openapi";
 import { HashMap, Pair } from "tstl";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { IAutoBeApplicationProps } from "../../context/IAutoBeApplicationProps";
@@ -35,13 +35,14 @@ export const orchestrateInterface =
     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: "interfaceStart",
+      id: v7(),
       created_at: start.toISOString(),
       reason: props.reason,
       step: ctx.state().analyze?.step ?? 0,
@@ -101,6 +102,7 @@ export const orchestrateInterface =
     // DO COMPILE
     return ctx.dispatch({
       type: "interfaceComplete",
+      id: v7(),
       document,
       authorizations,
       created_at: new Date().toISOString(),

package/src/orchestrate/interface/orchestrateInterfaceAuthorizations.ts

@@ -10,9 +10,11 @@ import { StringUtil } from "@autobe/utils";
 import { ILlmApplication, ILlmSchema, IValidation } 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 { transformInterfaceAuthorizationsHistories } from "./histories/transformInterfaceAuthorizationsHistories";
 import { IAutoBeInterfaceAuthorizationsApplication } from "./structures/IAutoBeInterfaceAuthorizationsApplication";
 
@@ -24,20 +26,22 @@ export async function orchestrateInterfaceAuthorizations<
     total: roles.length,
     completed: 0,
   };
-  const authorizations: AutoBeInterfaceAuthorization[] = await Promise.all(
-    roles.map(async (role) => {
-      const event: AutoBeInterfaceAuthorizationEvent = await process(
-        ctx,
-        role,
-        progress,
-      );
-      ctx.dispatch(event);
-      return {
-        role: role.name,
-        operations: event.operations,
-      };
-    }),
-  );
+  const authorizations: AutoBeInterfaceAuthorization[] =
+    await executeCachedBatch(
+      roles.map((role) => async (promptCacheKey) => {
+        const event: AutoBeInterfaceAuthorizationEvent = await process(
+          ctx,
+          role,
+          progress,
+          promptCacheKey,
+        );
+        ctx.dispatch(event);
+        return {
+          role: role.name,
+          operations: event.operations,
+        };
+      }),
+    );
 
   return authorizations;
 }
@@ -46,6 +50,7 @@ async function process<Model extends ILlmSchema.Model>(
   ctx: AutoBeContext<Model>,
   role: AutoBeAnalyzeRole,
   progress: AutoBeProgressEventBase,
+  promptCacheKey: string,
 ): Promise<AutoBeInterfaceAuthorizationEvent> {
   const pointer: IPointer<IAutoBeInterfaceAuthorizationsApplication.IProps | null> =
     {
@@ -62,6 +67,7 @@ async function process<Model extends ILlmSchema.Model>(
       },
     }),
     enforceFunctionCall: true,
+    promptCacheKey,
     message: "Create Authorization Operation for the given roles",
   });
   if (pointer.value === null)
@@ -69,6 +75,7 @@ async function process<Model extends ILlmSchema.Model>(
 
   return {
     type: "interfaceAuthorization",
+    id: v7(),
     operations: pointer.value.operations,
     completed: ++progress.completed,
     tokenUsage,
@@ -107,27 +114,27 @@ function createController<Model extends ILlmSchema.Model>(props: {
           expected:
             "Response body with I{RoleName(PascalCase)}.IAuthorized type is required",
           value: op.responseBody,
-          description: [
-            "Response body is required for authentication operations.",
-            "",
-            "The responseBody must contain description and typeName fields.",
-            "typeName must be I{Prefix(PascalCase)}{RoleName(PascalCase)}.IAuthorized",
-            "description must be a detailed description of the response body.",
-          ].join("\n"),
+          description: StringUtil.trim`
+            Response body is required for authentication operations.
+
+            The responseBody must contain description and typeName fields.
+            typeName must be I{Prefix(PascalCase)}{RoleName(PascalCase)}.IAuthorized
+            description must be a detailed description of the response body.
+          `,
         });
       else if (!op.responseBody.typeName.endsWith(".IAuthorized"))
         errors.push({
           path: `$input.operations.${i}.responseBody.typeName`,
           expected: `Type name must be I{RoleName(PascalCase)}.IAuthorized`,
           value: op.responseBody?.typeName,
-          description: [
-            `Wrong response body type name: ${op.responseBody?.typeName}`,
-            "",
-            `For authentication operations (login, join, refresh), the response body type name must follow the convention "I{RoleName}.IAuthorized".`,
-            ``,
-            `This standardized naming convention ensures consistency across all authentication endpoints and clearly identifies authorization response types.`,
-            `The Role name should be in PascalCase format (e.g., IUser.IAuthorized, IAdmin.IAuthorized, ISeller.IAuthorized).`,
-          ].join("\n"),
+          description: StringUtil.trim`
+            Wrong response body type name: ${op.responseBody?.typeName}
+
+            For authentication operations (login, join, refresh), the response body type name must follow the convention "I{RoleName}.IAuthorized".
+
+            This standardized naming convention ensures consistency across all authentication endpoints and clearly identifies authorization response types.
+            The Role name should be in PascalCase format (e.g., IUser.IAuthorized, IAdmin.IAuthorized, ISeller.IAuthorized).
+          `,
         });
     });
 

package/src/orchestrate/interface/orchestrateInterfaceComplement.ts

@@ -8,6 +8,7 @@ import {
 import { OpenApiV3_1Emender } from "@samchon/openapi/lib/converters/OpenApiV3_1Emender";
 import { IPointer } from "tstl";
 import typia from "typia";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
@@ -70,6 +71,7 @@ async function step<Model extends ILlmSchema.Model>(
     );
   ctx.dispatch({
     type: "interfaceComplement",
+    id: v7(),
     missed,
     schemas: pointer.value,
     tokenUsage,

package/src/orchestrate/interface/orchestrateInterfaceEndpoints.ts

@@ -2,14 +2,17 @@ import { IAgenticaController } from "@agentica/core";
 import {
   AutoBeInterfaceEndpointsEvent,
   AutoBeOpenApi,
+  AutoBeProgressEventBase,
 } from "@autobe/interface";
 import { AutoBeInterfaceGroup } from "@autobe/interface/src/histories/contents/AutoBeInterfaceGroup";
 import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
 import { HashSet, 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 { transformInterfaceEndpointHistories } from "./histories/transformInterfaceEndpointHistories";
 import { IAutoBeInterfaceEndpointApplication } from "./structures/IAutoBeInterfaceEndpointApplication";
 import { OpenApiEndpointComparator } from "./utils/OpenApiEndpointComparator";
@@ -22,13 +25,16 @@ export async function orchestrateInterfaceEndpoints<
   authorizations: AutoBeOpenApi.IOperation[],
   content: string = `Make endpoints for the given assets`,
 ): Promise<AutoBeOpenApi.IEndpoint[]> {
-  const progress: IProgress = {
+  const progress: AutoBeProgressEventBase = {
     total: groups.length,
     completed: 0,
   };
   const endpoints: AutoBeOpenApi.IEndpoint[] = (
-    await Promise.all(
-      groups.map((g) => process(ctx, g, content, progress, authorizations)),
+    await executeCachedBatch(
+      groups.map(
+        (g) => (promptCacheKey) =>
+          process(ctx, g, content, progress, authorizations, promptCacheKey),
+      ),
     )
   ).flat();
   return new HashSet(
@@ -42,8 +48,9 @@ async function process<Model extends ILlmSchema.Model>(
   ctx: AutoBeContext<Model>,
   group: AutoBeInterfaceGroup,
   message: string,
-  progress: IProgress,
+  progress: AutoBeProgressEventBase,
   authorizations: AutoBeOpenApi.IOperation[],
+  promptCacheKey: string,
 ): Promise<AutoBeOpenApi.IEndpoint[]> {
   const start: Date = new Date();
   const pointer: IPointer<AutoBeOpenApi.IEndpoint[] | null> = {
@@ -64,12 +71,14 @@ async function process<Model extends ILlmSchema.Model>(
       },
     }),
     enforceFunctionCall: true,
+    promptCacheKey,
     message,
   });
   if (pointer.value === null) throw new Error("Failed to generate endpoints."); // unreachable
 
   const event: AutoBeInterfaceEndpointsEvent = {
     type: "interfaceEndpoints",
+    id: v7(),
     endpoints: new HashSet(
       pointer.value,
       OpenApiEndpointComparator.hashCode,
@@ -120,8 +129,3 @@ const collection = {
   deepseek: claude,
   "3.1": claude,
 };
-
-interface IProgress {
-  total: number;
-  completed: number;
-}

package/src/orchestrate/interface/orchestrateInterfaceGroups.ts

@@ -3,6 +3,7 @@ import { AutoBeInterfaceGroupsEvent } from "@autobe/interface";
 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";
@@ -34,6 +35,7 @@ export async function orchestrateInterfaceGroups<
   if (pointer.value === null) throw new Error("Failed to generate groups."); // unreachable
   return {
     type: "interfaceGroups",
+    id: v7(),
     created_at: start.toISOString(),
     groups: pointer.value.groups,
     tokenUsage,

package/src/orchestrate/interface/orchestrateInterfaceOperations.ts

@@ -2,6 +2,7 @@ import { IAgenticaController } from "@agentica/core";
 import {
   AutoBeInterfaceOperationsEvent,
   AutoBeOpenApi,
+  AutoBeProgressEventBase,
 } from "@autobe/interface";
 import { AutoBeEndpointComparator, StringUtil } from "@autobe/utils";
 import { ILlmApplication, ILlmSchema, IValidation } from "@samchon/openapi";
@@ -9,11 +10,13 @@ import { HashMap, HashSet, IPointer } from "tstl";
 import typia from "typia";
 import { Escaper } from "typia/lib/utils/Escaper";
 import { NamingConvention } from "typia/lib/utils/NamingConvention";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
 import { divideArray } from "../../utils/divideArray";
 import { emplaceMap } from "../../utils/emplaceMap";
+import { executeCachedBatch } from "../../utils/executeCachedBatch";
 import { transformInterfaceOperationHistories } from "./histories/transformInterfaceOperationHistories";
 import { orchestrateInterfaceOperationsReview } from "./orchestrateInterfaceOperationsReview";
 import { IAutoBeInterfaceOperationApplication } from "./structures/IAutoBeInterfaceOperationApplication";
@@ -30,23 +33,23 @@ export async function orchestrateInterfaceOperations<
     array: endpoints,
     capacity,
   });
-  const operationsProgress: IProgress = {
-    total: endpoints.length,
-    completed: 0,
-  };
-  const operationsReviewProgress: IProgress = {
-    total: matrix.length,
-    completed: 0,
-  };
+
   return (
-    await Promise.all(
-      matrix.map(async (it) => {
+    await executeCachedBatch(
+      matrix.map((it) => async (promptCacheKey) => {
         const row: AutoBeOpenApi.IOperation[] = await divideAndConquer(
           ctx,
           it,
           3,
-          operationsProgress,
-          operationsReviewProgress,
+          {
+            total: matrix.length,
+            completed: 0,
+          },
+          {
+            total: matrix.length,
+            completed: 0,
+          },
+          promptCacheKey,
         );
         return row;
       }),
@@ -58,8 +61,9 @@ async function divideAndConquer<Model extends ILlmSchema.Model>(
   ctx: AutoBeContext<Model>,
   endpoints: AutoBeOpenApi.IEndpoint[],
   retry: number,
-  operationsProgress: IProgress,
-  operationsReviewProgress: IProgress,
+  operationsProgress: AutoBeProgressEventBase,
+  operationsReviewProgress: AutoBeProgressEventBase,
+  promptCacheKey: string,
 ): Promise<AutoBeOpenApi.IOperation[]> {
   const remained: HashSet<AutoBeOpenApi.IEndpoint> = new HashSet(
     endpoints,
@@ -74,7 +78,7 @@ async function divideAndConquer<Model extends ILlmSchema.Model>(
   for (let i: number = 0; i < retry; ++i) {
     if (remained.empty() === true || unique.size() >= endpoints.length) break;
     const operations: AutoBeOpenApi.IOperation[] = remained.size()
-      ? await process(ctx, remained, operationsProgress)
+      ? await process(ctx, remained, operationsProgress, promptCacheKey)
       : [];
 
     for (const item of operations) {
@@ -95,7 +99,8 @@ async function divideAndConquer<Model extends ILlmSchema.Model>(
 async function process<Model extends ILlmSchema.Model>(
   ctx: AutoBeContext<Model>,
   endpoints: HashSet<AutoBeOpenApi.IEndpoint>,
-  progress: IProgress,
+  progress: AutoBeProgressEventBase,
+  promptCacheKey: string,
 ): Promise<AutoBeOpenApi.IOperation[]> {
   const prefix: string = NamingConvention.camel(ctx.state().analyze!.prefix);
   const pointer: IPointer<AutoBeOpenApi.IOperation[] | null> = {
@@ -151,12 +156,14 @@ async function process<Model extends ILlmSchema.Model>(
       },
     }),
     enforceFunctionCall: true,
+    promptCacheKey,
     message: "Make API operations",
   });
   if (pointer.value === null) throw new Error("Failed to create operations."); // never be happened
 
   ctx.dispatch({
     type: "interfaceOperations",
+    id: v7(),
     operations: pointer.value,
     tokenUsage,
     ...progress,
@@ -218,13 +225,13 @@ function createController<Model extends ILlmSchema.Model>(props: {
           errors.push({
             path: `$input.operations[${i}].authorizationRoles[${j}]`,
             expected: `null | ${props.roles.map((str) => JSON.stringify(str)).join(" | ")}`,
-            description: [
-              `Role "${role}" is not defined in the roles list.`,
-              "",
-              "Please select one of them below, or do not define (`null`):  ",
-              "",
-              ...props.roles.map((role) => `- ${role}`),
-            ].join("\n"),
+            description: StringUtil.trim`
+              Role "${role}" is not defined in the roles list.
+
+              Please select one of them below, or do not define (\`null\`):  
+
+              ${props.roles.map((role) => `- ${role}`).join("\n")}
+            `,
             value: role,
           });
         });
@@ -247,15 +254,16 @@ function createController<Model extends ILlmSchema.Model>(props: {
           path: `$input.operations[${i}].{"path"|"method"}`,
           expected: "Unique endpoint (path and method)",
           value: key,
-          description: [
-            `Duplicated endpoint detected (method: ${op.method}, path: ${op.path}).`,
-            "",
-            "The duplicated endpoints of others are located in below accessors.",
-            "Check them, and consider which operation endpoint would be proper to modify.",
-            ...indexes.map(
-              (idx) => `- $input.operations.[${idx}].{"path"|"method"}`,
-            ),
-          ].join("\n"),
+          description: StringUtil.trim`
+            Duplicated endpoint detected (method: ${op.method}, path: ${op.path}).
+
+            The duplicated endpoints of others are located in below accessors.
+            Check them, and consider which operation endpoint would be proper to modify.
+            
+            ${indexes
+              .map((idx) => `- $input.operations.[${idx}].{"path"|"method"}`)
+              .join("\n")}
+          `,
         });
         indexes.push(i);
       } else endpoints.emplace(key, [i]);
@@ -276,20 +284,20 @@ function createController<Model extends ILlmSchema.Model>(props: {
           path: `$input.operations[${i}].name`,
           expected: "Unique name in the same accessor scope.",
           value: op.name,
-          description: [
-            `Duplicated operation accessor detected (name: ${op.name}, accessor: ${key}).`,
-            "",
-            "The operation name must be unique within the parent accessor.",
-            "In other worlds, the operation accessor determined by the name",
-            "must be unique in the OpenAPI document.",
-            "",
-            "Here is the list of elements of duplicated operation names.",
-            "Check them, and consider which operation name would be proper to modify.",
-            "",
-            ...indexes
+          description: StringUtil.trim`
+            Duplicated operation accessor detected (name: ${op.name}, accessor: ${key}).
+
+            The operation name must be unique within the parent accessor.
+            In other worlds, the operation accessor determined by the name
+            must be unique in the OpenAPI document.
+
+            Here is the list of elements of duplicated operation names.
+            Check them, and consider which operation name would be proper to modify.
+
+            ${indexes
               .map((idx) => `- ${operations[idx].name} (accessor: ${key})`)
-              .join("\n"),
-          ].join("\n"),
+              .join("\n")}
+          `,
         });
       }
       indexes.push(i);
@@ -335,11 +343,6 @@ const collection = {
     }),
 };
 
-interface IProgress {
-  completed: number;
-  total: number;
-}
-
 type Validator = (
   input: unknown,
 ) => IValidation<IAutoBeInterfaceOperationApplication.IProps>;

package/src/orchestrate/interface/orchestrateInterfaceOperationsReview.ts

@@ -7,6 +7,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 { transformInterfaceOperationsReviewHistories } from "./histories/transformInterfaceOperationsReviewHistories";
@@ -51,6 +52,7 @@ export async function orchestrateInterfaceOperationsReview<
 
     ctx.dispatch({
       type: "interfaceOperationsReview",
+      id: v7(),
       operations: content,
       review: pointer.value.review,
       plan: pointer.value.plan,

package/src/orchestrate/interface/orchestrateInterfaceSchemas.ts

@@ -4,14 +4,17 @@ import {
   AutoBeOpenApi,
   AutoBeProgressEventBase,
 } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
 import { ILlmApplication, ILlmSchema, IValidation } from "@samchon/openapi";
 import { OpenApiV3_1Emender } from "@samchon/openapi/lib/converters/OpenApiV3_1Emender";
 import { IPointer } from "tstl";
 import typia, { tags } from "typia";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
 import { divideArray } from "../../utils/divideArray";
+import { executeCachedBatch } from "../../utils/executeCachedBatch";
 import { transformInterfaceSchemaHistories } from "./histories/transformInterfaceSchemaHistories";
 import { orchestrateInterfaceSchemasReview } from "./orchestrateInterfaceSchemasReview";
 import { IAutoBeInterfaceSchemaApplication } from "./structures/IAutoBeInterfaceSchemaApplication";
@@ -50,10 +53,17 @@ export async function orchestrateInterfaceSchemas<
           IAuthorizationToken: authTokenSchema,
         }
       : {};
-  for (const y of await Promise.all(
-    matrix.map(async (it) => {
+  for (const y of await executeCachedBatch(
+    matrix.map((it) => async (promptCacheKey) => {
       const row: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive> =
-        await divideAndConquer(ctx, operations, it, 3, progress);
+        await divideAndConquer(
+          ctx,
+          operations,
+          it,
+          3,
+          progress,
+          promptCacheKey,
+        );
       const newbie: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive> =
         await orchestrateInterfaceSchemasReview(
           ctx,
@@ -76,13 +86,21 @@ async function divideAndConquer<Model extends ILlmSchema.Model>(
   typeNames: string[],
   retry: number,
   progress: AutoBeProgressEventBase,
+  promptCacheKey: string,
 ): Promise<Record<string, AutoBeOpenApi.IJsonSchemaDescriptive>> {
   const remained: Set<string> = new Set(typeNames);
   const schemas: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive> = {};
   for (let i: number = 0; i < retry; ++i) {
     if (remained.size === 0) break;
     const newbie: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive> =
-      await process(ctx, operations, schemas, remained, progress);
+      await process(
+        ctx,
+        operations,
+        schemas,
+        remained,
+        progress,
+        promptCacheKey,
+      );
     for (const key of Object.keys(newbie)) {
       schemas[key] = newbie[key];
       remained.delete(key);
@@ -97,6 +115,7 @@ async function process<Model extends ILlmSchema.Model>(
   oldbie: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive>,
   remained: Set<string>,
   progress: AutoBeProgressEventBase,
+  promptCacheKey: string,
 ): Promise<Record<string, AutoBeOpenApi.IJsonSchemaDescriptive>> {
   const already: string[] = Object.keys(oldbie);
   const pointer: IPointer<Record<
@@ -117,25 +136,29 @@ async function process<Model extends ILlmSchema.Model>(
       pointer,
     }),
     enforceFunctionCall: true,
-    message: [
-      "Make type components please.",
-      "",
-      "Here is the list of request/response bodies' type names from",
-      "OpenAPI operations. Make type components of them. If more object",
-      "types are required during making the components, please make them",
-      "too.",
-      "",
-      ...Array.from(remained).map((k) => `- \`${k}\``),
-      ...(already.length !== 0
-        ? [
-            "",
-            "> By the way, here is the list of components schemas what you've",
-            "> already made. So, you don't need to make them again.",
-            ">",
-            ...already.map((k) => `> - \`${k}\``),
-          ]
-        : []),
-    ].join("\n"),
+    promptCacheKey,
+    message: StringUtil.trim`
+      Make type components please.
+
+      Here is the list of request/response bodies' type names from
+      OpenAPI operations. Make type components of them. If more object
+      types are required during making the components, please make them
+      too.
+
+      ${Array.from(remained)
+        .map((k) => `      - \`${k}\``)
+        .join("\n")}${
+        already.length !== 0
+          ? StringUtil.trim`
+
+            > By the way, here is the list of components schemas what you've
+            > already made. So, you don't need to make them again.
+            >
+            ${already.map((k) => `> - \`${k}\``).join("\n")}
+          `
+          : ""
+      }
+    `,
   });
   if (pointer.value === null) throw new Error("Failed to create components.");
 
@@ -147,6 +170,7 @@ async function process<Model extends ILlmSchema.Model>(
     ).schemas ?? {};
   ctx.dispatch({
     type: "interfaceSchemas",
+    id: v7(),
     schemas,
     tokenUsage,
     completed: (progress.completed += Object.keys(schemas).length),