@autobe/agent 0.19.1 → 0.20.0

package/lib/orchestrate/analyze/histories/transformAnalyzeReviewHistories.d.ts

@@ -0,0 +1,6 @@
+import { IAgenticaHistoryJson } from "@agentica/core";
+import { AutoBeAnalyzeScenarioEvent } from "@autobe/interface";
+import { AutoBeAnalyzeFile } from "@autobe/interface/src/histories/contents/AutoBeAnalyzeFile";
+import { ILlmSchema } from "@samchon/openapi";
+import { AutoBeContext } from "../../../context/AutoBeContext";
+export declare const transformAnalyzeReviewHistories: <Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, scenario: AutoBeAnalyzeScenarioEvent, allFiles: AutoBeAnalyzeFile[], myFile: AutoBeAnalyzeFile) => Array<IAgenticaHistoryJson.IUserMessage | IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage>;

package/lib/orchestrate/analyze/orchestrateAnalyzeReview.d.ts

@@ -2,4 +2,10 @@ import { AutoBeAnalyzeReviewEvent, AutoBeAnalyzeScenarioEvent, AutoBeProgressEve
 import { AutoBeAnalyzeFile } from "@autobe/interface/src/histories/contents/AutoBeAnalyzeFile";
 import { ILlmSchema } from "@samchon/openapi";
 import { AutoBeContext } from "../../context/AutoBeContext";
-export declare const orchestrateAnalyzeReview: <Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, scenario: AutoBeAnalyzeScenarioEvent, otherFiles: AutoBeAnalyzeFile[], myFile: AutoBeAnalyzeFile, progress: AutoBeProgressEventBase) => Promise<AutoBeAnalyzeReviewEvent>;
+export declare const orchestrateAnalyzeReview: <Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, props: {
+    scenario: AutoBeAnalyzeScenarioEvent;
+    allFiles: AutoBeAnalyzeFile[];
+    myFile: AutoBeAnalyzeFile;
+    progress: AutoBeProgressEventBase;
+    promptCacheKey: string;
+}) => Promise<AutoBeAnalyzeReviewEvent>;

package/lib/orchestrate/analyze/orchestrateAnalyzeWrite.d.ts

@@ -1,8 +1,10 @@
-import { AutoBeAnalyzeScenarioEvent, AutoBeAnalyzeWriteEvent } from "@autobe/interface";
+import { AutoBeAnalyzeScenarioEvent, AutoBeAnalyzeWriteEvent, AutoBeProgressEventBase } from "@autobe/interface";
 import { AutoBeAnalyzeFile } from "@autobe/interface/src/histories/contents/AutoBeAnalyzeFile";
 import { ILlmSchema } from "@samchon/openapi";
 import { AutoBeContext } from "../../context/AutoBeContext";
-export declare const orchestrateAnalyzeWrite: <Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, scenario: AutoBeAnalyzeScenarioEvent, file: AutoBeAnalyzeFile.Scenario, progress: {
-    total: number;
-    completed: number;
+export declare const orchestrateAnalyzeWrite: <Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, props: {
+    scenario: AutoBeAnalyzeScenarioEvent;
+    file: AutoBeAnalyzeFile.Scenario;
+    progress: AutoBeProgressEventBase;
+    promptCacheKey: string;
 }) => Promise<AutoBeAnalyzeWriteEvent>;

package/lib/orchestrate/interface/orchestrateInterfaceSchemasReview.d.ts

@@ -1,7 +1,4 @@
-import { AutoBeOpenApi } from "@autobe/interface";
+import { AutoBeOpenApi, AutoBeProgressEventBase } from "@autobe/interface";
 import { ILlmSchema } from "@samchon/openapi";
 import { AutoBeContext } from "../../context/AutoBeContext";
-export declare function orchestrateInterfaceSchemasReview<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, operations: AutoBeOpenApi.IOperation[], schemas: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive<AutoBeOpenApi.IJsonSchema>>, progress: {
-    total: number;
-    completed: number;
-}): Promise<Record<string, AutoBeOpenApi.IJsonSchemaDescriptive>>;
+export declare function orchestrateInterfaceSchemasReview<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, operations: AutoBeOpenApi.IOperation[], schemas: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive<AutoBeOpenApi.IJsonSchema>>, progress: AutoBeProgressEventBase): Promise<Record<string, AutoBeOpenApi.IJsonSchemaDescriptive>>;

package/lib/orchestrate/interface/structures/IAutoBeInterfaceOperationApplication.d.ts

@@ -85,6 +85,44 @@ export declare namespace IAutoBeInterfaceOperationApplication {
      * ```
      */
     interface IOperation extends Omit<AutoBeOpenApi.IOperation, "authorizationRole" | "authorizationType"> {
+        /**
+         * Prisma schema models relevant to this operation.
+         *
+         * Contains the complete Prisma schema definitions for all entities involved
+         * in this operation, including their fields, relations, and database
+         * constraints. This enables comprehensive validation and schema-aware
+         * operation design.
+         *
+         * The schema information serves multiple critical purposes:
+         *
+         * - **Field Verification**: Ensures all referenced fields actually exist in
+         *   the database schema and have the correct types
+         * - **Relationship Validation**: Confirms that entity relationships are
+         *   properly defined and can support the operation's data access patterns
+         * - **Soft-Delete Detection**: For DELETE operations, identifies whether
+         *   entities have soft-delete fields (deleted_at, is_deleted, etc.) to
+         *   determine if the operation should perform logical deletion instead of
+         *   physical removal
+         * - **Constraint Awareness**: Understands unique constraints, required
+         *   fields, and default values to generate accurate request/response
+         *   schemas
+         *
+         * Example content might include:
+         *
+         * ```prisma
+         * model User {
+         *   id         String    @id @default(uuid())
+         *   email      String    @unique
+         *   name       String
+         *   deleted_at DateTime? // Indicates soft-delete capability
+         *   posts      Post[]
+         * }
+         * ```
+         *
+         * This schema context ensures operations are fully aligned with the actual
+         * database structure and business logic requirements.
+         */
+        prisma_schemas: string;
         /**
          * Authorization roles required to access this API operation.
          *

package/lib/orchestrate/interface/structures/IAutoBeInterfaceOperationsReviewApplication.d.ts

@@ -128,5 +128,43 @@ export declare namespace IAutoBeInterfaceOperationsReviewApplication {
      * ```
      */
     interface IOperation extends Omit<AutoBeOpenApi.IOperation, "authorizationType"> {
+        /**
+         * Prisma schema models relevant to this operation.
+         *
+         * Contains the complete Prisma schema definitions for all entities involved
+         * in this operation, including their fields, relations, and database
+         * constraints. This enables comprehensive validation and schema-aware
+         * operation design.
+         *
+         * The schema information serves multiple critical purposes:
+         *
+         * - **Field Verification**: Ensures all referenced fields actually exist in
+         *   the database schema and have the correct types
+         * - **Relationship Validation**: Confirms that entity relationships are
+         *   properly defined and can support the operation's data access patterns
+         * - **Soft-Delete Detection**: For DELETE operations, identifies whether
+         *   entities have soft-delete fields (deleted_at, is_deleted, etc.) to
+         *   determine if the operation should perform logical deletion instead of
+         *   physical removal
+         * - **Constraint Awareness**: Understands unique constraints, required
+         *   fields, and default values to generate accurate request/response
+         *   schemas
+         *
+         * Example content might include:
+         *
+         * ```prisma
+         * model User {
+         *   id         String    @id @default(uuid())
+         *   email      String    @unique
+         *   name       String
+         *   deleted_at DateTime? // Indicates soft-delete capability
+         *   posts      Post[]
+         * }
+         * ```
+         *
+         * This schema context ensures operations are fully aligned with the actual
+         * database structure and business logic requirements.
+         */
+        prisma_schemas: string;
     }
 }

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

@@ -1,7 +1,7 @@
 import { AutoBeRealizeAuthorization, AutoBeRealizeFunction, IAutoBeTypeScriptCompileResult } from "@autobe/interface";
 import { ILlmSchema } from "@samchon/openapi";
 import { AutoBeContext } from "../../../context/AutoBeContext";
-export declare function compile<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, props: {
+export declare function compileRealizeFiles<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, props: {
     authorizations: AutoBeRealizeAuthorization[];
     functions: AutoBeRealizeFunction[];
 }): Promise<IAutoBeTypeScriptCompileResult>;

package/lib/orchestrate/realize/orchestrateRealizeCorrect.d.ts

@@ -1,4 +1,4 @@
-import { AutoBeRealizeAuthorization, AutoBeRealizeCorrectEvent, IAutoBeTypeScriptCompileResult } from "@autobe/interface";
+import { AutoBeProgressEventBase, AutoBeRealizeAuthorization, AutoBeRealizeCorrectEvent, IAutoBeTypeScriptCompileResult } from "@autobe/interface";
 import { ILlmSchema } from "@samchon/openapi";
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { IAutoBeRealizeScenarioApplication } from "./structures/IAutoBeRealizeScenarioApplication";
@@ -8,9 +8,5 @@ export declare function orchestrateRealizeCorrect<Model extends ILlmSchema.Model
     scenario: IAutoBeRealizeScenarioApplication.IProps;
     code: string;
     diagnostic: IAutoBeTypeScriptCompileResult.IDiagnostic;
-    progress: IProgress;
+    progress: AutoBeProgressEventBase;
 }): Promise<AutoBeRealizeCorrectEvent>;
-export interface IProgress {
-    total: number;
-    completed: number;
-}

package/lib/orchestrate/realize/orchestrateRealizeScenario.d.ts

@@ -2,72 +2,6 @@ import { AutoBeOpenApi, AutoBeRealizeAuthorization } from "@autobe/interface";
 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/lib/orchestrate/realize/orchestrateRealizeWrite.d.ts

@@ -1,4 +1,4 @@
-import { AutoBeRealizeAuthorization, AutoBeRealizeWriteEvent } from "@autobe/interface";
+import { AutoBeProgressEventBase, AutoBeRealizeAuthorization, AutoBeRealizeWriteEvent } from "@autobe/interface";
 import { ILlmSchema } from "@samchon/openapi";
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { IAutoBeRealizeScenarioApplication } from "./structures/IAutoBeRealizeScenarioApplication";
@@ -6,9 +6,6 @@ export declare function orchestrateRealizeWrite<Model extends ILlmSchema.Model>(
     totalAuthorizations: AutoBeRealizeAuthorization[];
     authorization: AutoBeRealizeAuthorization | null;
     scenario: IAutoBeRealizeScenarioApplication.IProps;
-    progress: IProgress;
+    progress: AutoBeProgressEventBase;
+    promptCacheKey: string;
 }): Promise<AutoBeRealizeWriteEvent>;
-export interface IProgress {
-    total: number;
-    completed: number;
-}

package/lib/orchestrate/test/structures/IAutoBeTestCorrectApplication.d.ts

@@ -67,8 +67,8 @@ export declare namespace IAutoBeTestCorrectApplication {
          * AI generates the first corrected version of the test code based on error
          * analysis and correction strategies. This draft addresses all identified
          * compilation errors while preserving the original business logic and test
-         * workflow. The code is compilation-error-free and follows all
-         * established conventions.
+         * workflow. The code is compilation-error-free and follows all established
+         * conventions.
          *
          * The implementation incorporates lessons learned from error analysis to
          * produce properly typed, syntactically correct code that maintains the

package/lib/orchestrate/test/structures/IAutoBeTestWriteApplication.d.ts

@@ -32,8 +32,8 @@ export declare namespace IAutoBeTestWriteApplication {
          *
          * AI determines the appropriate domain category based on the scenario
          * analysis. This classification drives file structure, test categorization,
-         * and logical grouping. The domain must be a single, lowercase word that
-         * represents the primary API resource.
+         * and logical grouping. The domain must be a single, lowercase word in
+         * snake_case format that represents the primary API resource.
          *
          * Workflow: Scenario analysis → Domain identification → Test organization
          * structure

package/lib/utils/executeCachedBatch.d.ts

@@ -0,0 +1 @@
+export declare const executeCachedBatch: <T>(tasks: Array<(user: string) => Promise<T>>, promptCacheKey?: string) => Promise<T[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobe/agent",
-  "version": "0.19.1",
+  "version": "0.20.0",
   "description": "AI backend server code generator",
   "main": "lib/index.js",
   "author": "Wrtn Technologies",
@@ -20,15 +20,15 @@
     "README.md"
   ],
   "dependencies": {
-    "@agentica/core": "^0.32.1",
+    "@agentica/core": "0.32.3-dev.3",
     "@prisma/internals": "^6.7.0",
     "@samchon/openapi": "^4.7.1",
     "openai": "^5.12.2",
     "tstl": "^3.0.0",
     "typia": "^9.7.1",
     "uuid": "^11.1.0",
-    "@autobe/interface": "^0.19.1",
-    "@autobe/utils": "^0.19.1"
+    "@autobe/interface": "^0.20.0",
+    "@autobe/utils": "^0.20.0"
   },
   "devDependencies": {
     "@rollup/plugin-json": "^6.1.0",
@@ -40,8 +40,8 @@
     "ts-node": "^10.9.2",
     "ts-patch": "^3.3.0",
     "typescript": "~5.9.2",
-    "@autobe/filesystem": "^0.19.1",
-    "@autobe/compiler": "^0.19.1"
+    "@autobe/compiler": "^0.20.0",
+    "@autobe/filesystem": "^0.20.0"
   },
   "keywords": [
     "ai",

package/src/AutoBeAgent.ts

@@ -13,7 +13,7 @@ import {
 } from "@autobe/interface";
 import { ILlmSchema } from "@samchon/openapi";
 import { Semaphore, Singleton } from "tstl";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeAgentBase } from "./AutoBeAgentBase";
 import { AutoBeContext } from "./context/AutoBeContext";
@@ -202,7 +202,7 @@ export class AutoBeAgent<Model extends ILlmSchema.Model>
     this.agentica_.on("assistantMessage", async (message) => {
       const start = new Date();
       const history: AutoBeAssistantMessageHistory = {
-        id: v4(),
+        id: v7(),
         type: "assistantMessage",
         text: await message.join(),
         created_at: start.toISOString(),
@@ -212,6 +212,7 @@ export class AutoBeAgent<Model extends ILlmSchema.Model>
       this.histories_.push(history);
       this.dispatch({
         type: "assistantMessage",
+        id: history.id,
         text: history.text,
         created_at: history.created_at,
       }).catch(() => {});
@@ -253,7 +254,7 @@ export class AutoBeAgent<Model extends ILlmSchema.Model>
   ): Promise<AutoBeHistory[]> {
     const index: number = this.histories_.length;
     const userMessageHistory: AutoBeUserMessageHistory = {
-      id: v4(),
+      id: v7(),
       type: "userMessage",
       contents:
         typeof content === "string"

package/src/AutoBeMockAgent.ts

@@ -11,7 +11,7 @@ import {
   IAutoBePlaygroundReplay,
 } from "@autobe/interface";
 import { Singleton, randint, sleep_for } from "tstl";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeAgentBase } from "./AutoBeAgentBase";
 import { AutoBeState } from "./context/AutoBeState";
@@ -50,7 +50,7 @@ export class AutoBeMockAgent extends AutoBeAgentBase implements IAutoBeAgent {
   ): Promise<AutoBeHistory[]> {
     // THE USER-MESSAGE
     const userMessage: AutoBeUserMessageHistory = {
-      id: v4(),
+      id: v7(),
       type: "userMessage",
       contents:
         typeof content === "string"
@@ -72,7 +72,7 @@ export class AutoBeMockAgent extends AutoBeAgentBase implements IAutoBeAgent {
     if (state.realize !== null) {
       await sleep_for(2_000);
       const assistantMessage: AutoBeAssistantMessageHistory = {
-        id: v4(),
+        id: v7(),
         type: "assistantMessage",
         text: [
           "AutoBE has successfully realized the application.",
@@ -94,7 +94,7 @@ export class AutoBeMockAgent extends AutoBeAgentBase implements IAutoBeAgent {
       if (snapshots === null) {
         this.histories_.push(userMessage);
         this.histories_.push({
-          id: v4(),
+          id: v7(),
           type: "assistantMessage",
           text: [
             "The histories are prepared until current state.",