@autobe/agent 0.18.0 → 0.19.1

package/lib/orchestrate/realize/histories/transformRealizeWriteHistories.d.ts

@@ -3,9 +3,12 @@ import { AutoBeRealizeAuthorization } from "@autobe/interface";
 import { AutoBeState } from "../../../context/AutoBeState";
 import { IAutoBeTestScenarioArtifacts } from "../../test/structures/IAutoBeTestScenarioArtifacts";
 import { IAutoBeRealizeScenarioApplication } from "../structures/IAutoBeRealizeScenarioApplication";
-export declare const transformRealizeWriteHistories: (props: {
+export declare const transformRealizeWriteHistories: (props: IProps) => Array<IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage>;
+interface IProps {
     state: AutoBeState;
     scenario: IAutoBeRealizeScenarioApplication.IProps;
     artifacts: IAutoBeTestScenarioArtifacts;
     authorization: AutoBeRealizeAuthorization | null;
-}) => Array<IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage>;
+    totalAuthorizations: AutoBeRealizeAuthorization[];
+}
+export {};

package/lib/orchestrate/realize/internal/compile.d.ts

@@ -1,7 +1,7 @@
-import { AutoBeRealizeAuthorization, AutoBeRealizeValidateEvent, IAutoBeTypeScriptCompileResult } from "@autobe/interface";
+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: {
     authorizations: AutoBeRealizeAuthorization[];
-    providers: Record<string, string>;
-}): Promise<IAutoBeTypeScriptCompileResult.ISuccess | AutoBeRealizeValidateEvent>;
+    functions: AutoBeRealizeFunction[];
+}): Promise<IAutoBeTypeScriptCompileResult>;

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

@@ -2,7 +2,14 @@ import { AutoBeRealizeAuthorization, AutoBeRealizeCorrectEvent, IAutoBeTypeScrip
 import { ILlmSchema } from "@samchon/openapi";
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { IAutoBeRealizeScenarioApplication } from "./structures/IAutoBeRealizeScenarioApplication";
-export declare function orchestrateRealizeCorrect<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, authorization: AutoBeRealizeAuthorization | null, scenario: IAutoBeRealizeScenarioApplication.IProps, code: string, diagnostic: IAutoBeTypeScriptCompileResult.IDiagnostic, progress: IProgress): Promise<AutoBeRealizeCorrectEvent>;
+export declare function orchestrateRealizeCorrect<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, props: {
+    authorization: AutoBeRealizeAuthorization | null;
+    totalAuthorizations: AutoBeRealizeAuthorization[];
+    scenario: IAutoBeRealizeScenarioApplication.IProps;
+    code: string;
+    diagnostic: IAutoBeTypeScriptCompileResult.IDiagnostic;
+    progress: IProgress;
+}): Promise<AutoBeRealizeCorrectEvent>;
 export interface IProgress {
     total: number;
     completed: number;

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

@@ -2,7 +2,12 @@ import { AutoBeRealizeAuthorization, AutoBeRealizeWriteEvent } from "@autobe/int
 import { ILlmSchema } from "@samchon/openapi";
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { IAutoBeRealizeScenarioApplication } from "./structures/IAutoBeRealizeScenarioApplication";
-export declare function orchestrateRealizeWrite<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, authorization: AutoBeRealizeAuthorization | null, scenario: IAutoBeRealizeScenarioApplication.IProps, progress: IProgress): Promise<AutoBeRealizeWriteEvent>;
+export declare function orchestrateRealizeWrite<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, props: {
+    totalAuthorizations: AutoBeRealizeAuthorization[];
+    authorization: AutoBeRealizeAuthorization | null;
+    scenario: IAutoBeRealizeScenarioApplication.IProps;
+    progress: IProgress;
+}): Promise<AutoBeRealizeWriteEvent>;
 export interface IProgress {
     total: number;
     completed: number;

package/lib/orchestrate/realize/structures/IAutoBeRealizeAuthorizationApplication.d.ts

@@ -34,7 +34,7 @@ export declare namespace IAutoBeRealizeAuthorizationApplication {
          * called by the decorator to verify JWT tokens and return authenticated
          * user information for the specified role.
          *
-         * MUST use camelCase naming convention.
+         * DO: Use camelCase naming convention.
          */
         name: string & CamelPattern;
         /**
@@ -55,7 +55,7 @@ export declare namespace IAutoBeRealizeAuthorizationApplication {
          * authorize users for the specific role, injecting the authenticated user
          * payload as a method parameter.
          *
-         * MUST use PascalCase naming convention.
+         * DO: Use PascalCase naming convention.
          */
         name: string & PascalPattern;
         /**
@@ -75,7 +75,7 @@ export declare namespace IAutoBeRealizeAuthorizationApplication {
          * authenticated user data that will be injected into Controller methods
          * when using the decorator.
          *
-         * MUST use PascalCase naming convention.
+         * DO: Use PascalCase naming convention.
          */
         name: string & PascalPattern;
         /**

package/lib/orchestrate/realize/structures/IAutoBeRealizeWriteApplication.d.ts

@@ -12,16 +12,18 @@ export declare namespace IAutoBeRealizeWriteApplication {
          * function according to the Realize Coder Agent specification. Before
          * writing the actual code, think through the logic and structure.
          *
-         * The plan MUST follow MANDATORY SCHEMA-FIRST APPROACH:
+         * The plan follows a SCHEMA-FIRST APPROACH:
          *
-         * 📋 STEP 1 - PRISMA SCHEMA VERIFICATION (MOST CRITICAL):
+         * 📋 STEP 1 - PRISMA SCHEMA VERIFICATION:
          *
-         * - EXAMINE the actual Prisma schema model definition
-         * - LIST EVERY field that exists in the model with exact types
-         * - EXPLICITLY NOTE fields that DO NOT exist (e.g., "Note: deleted_at field
-         *   DOES NOT EXIST")
-         * - Common assumption errors to avoid: `deleted_at`, `created_by`,
-         *   `updated_by`, `is_deleted`, `is_active`
+         * DO:
+         * - Examine the actual Prisma schema model definition
+         * - List EVERY field that exists in the model with exact types
+         * - Explicitly note fields that DO NOT exist
+         *
+         * DO NOT:
+         * - Assume common fields exist without verification
+         * - Use fields like deleted_at, created_by, updated_by, is_deleted, is_active without checking
          *
          * 📋 STEP 2 - FIELD INVENTORY:
          *
@@ -155,8 +157,9 @@ export declare namespace IAutoBeRealizeWriteApplication {
          * Draft WITHOUT using native Date type.
          *
          * This is the initial drafting phase where you outline the basic skeleton
-         * of the function. CRITICAL: This draft must NEVER use the native Date
-         * type.
+         * of the function.
+         *
+         * DO NOT: Use the native Date type.
          *
          * - The function signature must correctly include `user`, `parameters`, and
          *   `body` arguments.
@@ -165,13 +168,13 @@ export declare namespace IAutoBeRealizeWriteApplication {
          * - Mark any incomplete or missing parts clearly with placeholders (e.g.,
          *   comments or temporary values).
          *
-         * ⚠️ Import rules:
+         * Import rules:
+         *
+         * DO NOT:
+         * - Add any new import statements manually
+         * - Write import statements directly (this causes compile errors)
          *
-         * - Do NOT add any new import statements manually.
-         * - All necessary imports are provided globally or by the system
-         *   automatically.
-         * - Writing import statements directly is prohibited and may cause compile
-         *   errors. If import errors occur, check your environment configuration.
+         * Note: All necessary imports are provided globally or by the system automatically.
          *
          * ✅ Requirements:
          *

package/lib/orchestrate/test/histories/transformTestScenarioHistories.d.ts

@@ -1,3 +1,4 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBeOpenApi } from "@autobe/interface";
-export declare const transformTestScenarioHistories: (entire: AutoBeOpenApi.IOperation[], include: AutoBeOpenApi.IOperation[], exclude: Pick<AutoBeOpenApi.IOperation, "method" | "path">[]) => Array<IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage>;
+import { AutoBeState } from "../../../context/AutoBeState";
+export declare const transformTestScenarioHistories: (state: AutoBeState, entire: AutoBeOpenApi.IOperation[], include: AutoBeOpenApi.IOperation[], exclude: Pick<AutoBeOpenApi.IOperation, "method" | "path">[]) => Array<IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage>;

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

@@ -30,7 +30,7 @@ export declare namespace IAutoBeTestCorrectApplication {
          * AI analyzes the original test scenario, business requirements, and
          * intended functionality without being influenced by compilation errors.
          * This clean analysis establishes a clear understanding of what the test
-         * should accomplish, the expected business workflow, and the correct API
+         * accomplishes, the expected business workflow, and the correct API
          * integration patterns.
          *
          * This step ensures that error correction doesn't lose sight of the
@@ -67,17 +67,18 @@ 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 must be compilation-error-free and follow all
+         * 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
          * intended test functionality. All type safety requirements and framework
-         * conventions must be followed in this corrected implementation.
+         * conventions are followed in this corrected implementation.
          *
          * Workflow: Error correction → TypeScript implementation → Functional
-         * preservation Critical: Must resolve all compilation errors while
-         * maintaining original test intent
+         * preservation
+         *
+         * DO: Resolve all compilation errors while maintaining original test intent
          */
         draft: string;
         /**

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

@@ -57,7 +57,7 @@ export declare namespace IAutoBeTestScenarioApplication {
          *
          * ## Naming Convention
          *
-         * MUST use snake_case naming convention.
+         * DO: Use snake_case naming convention.
          *
          * - Must start with `test_api_` prefix (mandatory requirement)
          * - ALWAYS start with business feature, NOT action verbs

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

@@ -0,0 +1,6 @@
+import { AutoBeOpenApi } from "@autobe/interface";
+export interface IAutoBeTestScenarioAuthorizationRole {
+    name: string;
+    join: AutoBeOpenApi.IOperation | null;
+    login: AutoBeOpenApi.IOperation | null;
+}

package/lib/utils/predicateStateMessage.d.ts

@@ -0,0 +1,4 @@
+import { AutoBeState } from "../context/AutoBeState";
+type StepName = "analyze" | "prisma" | "interface" | "test" | "realize";
+export declare const predicateStateMessage: (state: AutoBeState, future: StepName) => string | null;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobe/agent",
-  "version": "0.18.0",
+  "version": "0.19.1",
   "description": "AI backend server code generator",
   "main": "lib/index.js",
   "author": "Wrtn Technologies",
@@ -20,15 +20,15 @@
     "README.md"
   ],
   "dependencies": {
-    "@agentica/core": "^0.31.1",
+    "@agentica/core": "^0.32.1",
     "@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.18.0",
-    "@autobe/utils": "^0.18.0"
+    "@autobe/interface": "^0.19.1",
+    "@autobe/utils": "^0.19.1"
   },
   "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/compiler": "^0.18.0",
-    "@autobe/filesystem": "^0.18.0"
+    "@autobe/filesystem": "^0.19.1",
+    "@autobe/compiler": "^0.19.1"
   },
   "keywords": [
     "ai",

package/src/AutoBeAgent.ts

@@ -197,6 +197,8 @@ export class AutoBeAgent<Model extends ILlmSchema.Model>
       });
       previous = current;
     };
+
+    // SHIFT EVENTS
     this.agentica_.on("assistantMessage", async (message) => {
       const start = new Date();
       const history: AutoBeAssistantMessageHistory = {
@@ -220,6 +222,18 @@ export class AutoBeAgent<Model extends ILlmSchema.Model>
     this.agentica_.on("request", (e) => {
       if (e.body.parallel_tool_calls !== undefined)
         delete e.body.parallel_tool_calls;
+      void this.dispatch({
+        ...e,
+        type: "vendorRequest",
+        source: "facade",
+      }).catch(() => {});
+    });
+    this.agentica_.on("response", (e) => {
+      void this.dispatch({
+        ...e,
+        type: "vendorResponse",
+        source: "facade",
+      }).catch(() => {});
     });
   }
 

package/src/AutoBeMockAgent.ts

@@ -8,6 +8,7 @@ import {
   IAutoBeAgent,
   IAutoBeCompiler,
   IAutoBeCompilerListener,
+  IAutoBePlaygroundReplay,
 } from "@autobe/interface";
 import { Singleton, randint, sleep_for } from "tstl";
 import { v4 } from "uuid";
@@ -113,7 +114,7 @@ export class AutoBeMockAgent extends AutoBeAgentBase implements IAutoBeAgent {
       }
       this.histories_.push(userMessage);
       this.histories_.push(
-        this.props_.preset.histories.find((h) => h.type === type)!,
+        this.props_.replay.histories.find((h) => h.type === type)!,
       );
     };
     if (state.analyze === null) await take("analyze");
@@ -135,7 +136,7 @@ export class AutoBeMockAgent extends AutoBeAgentBase implements IAutoBeAgent {
   private getEventSnapshots(
     state: "analyze" | "prisma" | "interface" | "test" | "realize",
   ): AutoBeEventSnapshot[] | null {
-    return this.props_.preset[state] ?? null;
+    return this.props_.replay[state] ?? null;
   }
 }
 export namespace AutoBeMockAgent {
@@ -143,21 +144,18 @@ export namespace AutoBeMockAgent {
     compiler: (
       listener: IAutoBeCompilerListener,
     ) => IAutoBeCompiler | Promise<IAutoBeCompiler>;
-    preset: IPreset;
-  }
-  export interface IPreset {
-    histories: AutoBeHistory[];
-    analyze?: AutoBeEventSnapshot[] | null;
-    prisma?: AutoBeEventSnapshot[] | null;
-    interface?: AutoBeEventSnapshot[] | null;
-    test?: AutoBeEventSnapshot[] | null;
-    realize?: AutoBeEventSnapshot[] | null;
+    replay: IAutoBePlaygroundReplay;
   }
 }
 
 const sleepMap: Record<AutoBeEvent.Type, number> = {
   userMessage: 1_000,
   assistantMessage: 1_000,
+  vendorRequest: 0,
+  vendorResponse: 0,
+  jsonParseError: 0,
+  jsonValidateError: 0,
+  consentFunctionCall: 0,
   // ANALYZE
   analyzeStart: 1_000,
   analyzeScenario: 1_000,