@autobe/agent 0.20.0 → 0.22.0

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

@@ -1,10 +1,34 @@
 export interface IAutoBeRealizeWriteApplication {
+    /**
+     * Generates provider function implementation through multi-phase development.
+     *
+     * This method implements a systematic approach to generate NestJS provider
+     * functions that handle business logic for API operations. It follows a
+     * schema-first approach with multiple refinement phases to ensure type-safe,
+     * error-free code generation.
+     *
+     * The generation process includes:
+     * 1. Strategic planning based on Prisma schema analysis
+     * 2. Initial draft without Date type usage
+     * 3. Review and refinement for completeness
+     * 4. Compiler feedback integration if errors detected
+     * 5. Final implementation with all validations and type safety
+     *
+     * @param next Properties containing the multi-phase implementation plan and code
+     */
     coding: (next: IAutoBeRealizeWriteApplication.IProps) => void;
 }
 export declare namespace IAutoBeRealizeWriteApplication {
+    /**
+     * Properties for the Realize Write Application following Chain of Thinking (CoT).
+     *
+     * Each field represents a distinct phase in the reasoning and implementation process,
+     * building upon the previous step to create a complete, error-free implementation.
+     * This structured approach ensures clarity, debuggability, and systematic thinking.
+     */
     interface IProps {
         /**
-         * Step 1.
+         * Step 1 - Planning Phase (CoT: Initial Reasoning)
          *
          * 🧠 Provider Function Implementation Plan
          *
@@ -17,13 +41,18 @@ export declare namespace IAutoBeRealizeWriteApplication {
          * 📋 STEP 1 - PRISMA SCHEMA VERIFICATION:
          *
          * 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
+         * - Verify database compatibility (PostgreSQL AND SQLite)
          *
          * DO NOT:
+         *
          * - Assume common fields exist without verification
-         * - Use fields like deleted_at, created_by, updated_by, is_deleted, is_active without checking
+         * - Use fields like deleted_at, created_by, updated_by, is_deleted, is_active
+         *   without checking
+         * - Use PostgreSQL-specific features like mode: "insensitive"
          *
          * 📋 STEP 2 - FIELD INVENTORY:
          *
@@ -131,7 +160,7 @@ export declare namespace IAutoBeRealizeWriteApplication {
          */
         plan: string;
         /**
-         * Step 2.
+         * Step 2 - Schema Definition (CoT: Context Establishment)
          *
          * The Prisma schema string that will be used to validate the implementation
          * logic in this file.
@@ -152,7 +181,7 @@ export declare namespace IAutoBeRealizeWriteApplication {
          */
         prisma_schemas: string;
         /**
-         * Step 3.
+         * Step 3 - Initial Draft (CoT: First Implementation Attempt)
          *
          * Draft WITHOUT using native Date type.
          *
@@ -171,10 +200,12 @@ export declare namespace IAutoBeRealizeWriteApplication {
          * Import rules:
          *
          * DO NOT:
+         *
          * - Add any new import statements manually
          * - Write import statements directly (this causes compile errors)
          *
-         * Note: All necessary imports are provided globally or by the system automatically.
+         * Note: All necessary imports are provided globally or by the system
+         * automatically.
          *
          * ✅ Requirements:
          *
@@ -186,7 +217,7 @@ export declare namespace IAutoBeRealizeWriteApplication {
          */
         draft_without_date_type: string;
         /**
-         * Step 4.
+         * Step 4 - Review and Refinement (CoT: Self-Reflection)
          *
          * A refined version of the draft with improved completeness.
          *
@@ -200,27 +231,11 @@ export declare namespace IAutoBeRealizeWriteApplication {
          * - Avoid unsafe `as` casts unless only for branding or literal narrowing.
          * - Use `toISOStringSafe()` for all date conversions (NOT `.toISOString()`).
          * - Ensure all object keys strictly conform to the expected type definitions.
+         * - NEVER use `mode: "insensitive"` in string operations (breaks SQLite).
          */
         review: string;
         /**
-         * 🛠 Phase 4-2: With compiler feedback (optional)
-         *
-         * A correction pass that applies fixes for compile-time errors that arose
-         * during the review stage (if any).
-         *
-         * ✅ Must:
-         *
-         * - Only include this field if TypeScript errors are detected in the Review
-         *   phase.
-         * - Resolve all TypeScript errors without using `as any`.
-         * - Provide safe brand casting only if required (e.g., `as string &
-         *   tags.Format<'uuid'>`).
-         * - If no TypeScript errors exist, this field MUST contain the text: "No
-         *   TypeScript errors detected - skipping this phase"
-         */
-        withCompilerFeedback: string;
-        /**
-         * Step 5.
+         * Step 5 - Complete Implementation (CoT: Final Synthesis)
          *
          * The complete and fully correct TypeScript function implementation.
          *
@@ -232,6 +247,7 @@ export declare namespace IAutoBeRealizeWriteApplication {
          * - Uses only allowed imports (e.g., from `../api/structures` and
          *   `MyGlobal.prisma`).
          * - NEVER creates intermediate variables for Prisma operations.
+         * - NEVER uses `mode: "insensitive"` (PostgreSQL-only, breaks SQLite).
          *
          * ⚠️ Fallback Behavior:
          *

package/lib/agent/src/orchestrate/realize/utils/getRealizeWriteCodeTemplate.d.ts

@@ -0,0 +1,31 @@
+import { AutoBeOpenApi, AutoBeRealizeAuthorization } from "@autobe/interface";
+import { IAutoBeRealizeScenarioResult } from "../structures/IAutoBeRealizeScenarioResult";
+/**
+ * Generate a TypeScript function template for the Realize Agent to complete
+ *
+ * This utility creates a function skeleton with proper imports, parameters, and
+ * return type that the AI needs to implement. The template includes:
+ *
+ * - Import statements for required dependencies
+ * - Function signature with all parameters
+ * - Return type specification
+ *
+ * @example
+ *   // Returns a template like:
+ *   ```typescript
+ *   import { MyGlobal } from "../MyGlobal";
+ *   // ... other imports
+ *
+ *   async function post__users_create(
+ *     body: IUserCreateRequest
+ *   ): Promise<IUserResponse> {
+ *     ...
+ *   }
+ *   ```;
+ *
+ * @param scenario - The realize scenario containing function metadata
+ * @param operation - OpenAPI operation definition
+ * @param authorization - Authorization context if endpoint is authenticated
+ * @returns Complete TypeScript code template as a formatted string
+ */
+export declare function getRealizeWriteCodeTemplate(scenario: IAutoBeRealizeScenarioResult, operation: AutoBeOpenApi.IOperation, authorization: AutoBeRealizeAuthorization | null): string;

package/lib/agent/src/orchestrate/realize/utils/getRealizeWriteCodeTemplate.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRealizeWriteCodeTemplate = getRealizeWriteCodeTemplate;
+const utils_1 = require("@autobe/utils");
+const getRealizeWriteImportStatements_1 = require("./getRealizeWriteImportStatements");
+/**
+ * Generate a TypeScript function template for the Realize Agent to complete
+ *
+ * This utility creates a function skeleton with proper imports, parameters, and
+ * return type that the AI needs to implement. The template includes:
+ *
+ * - Import statements for required dependencies
+ * - Function signature with all parameters
+ * - Return type specification
+ *
+ * @example
+ *   // Returns a template like:
+ *   ```typescript
+ *   import { MyGlobal } from "../MyGlobal";
+ *   // ... other imports
+ *
+ *   async function post__users_create(
+ *     body: IUserCreateRequest
+ *   ): Promise<IUserResponse> {
+ *     ...
+ *   }
+ *   ```;
+ *
+ * @param scenario - The realize scenario containing function metadata
+ * @param operation - OpenAPI operation definition
+ * @param authorization - Authorization context if endpoint is authenticated
+ * @returns Complete TypeScript code template as a formatted string
+ */
+function getRealizeWriteCodeTemplate(scenario, operation, authorization) {
+    var _a, _b, _c;
+    // Collect all function parameters in order
+    const functionParameters = [];
+    // Add authentication parameter if needed (e.g., user: IUser, admin: IAdmin)
+    if (authorization && authorization.role.name) {
+        // Debug: Log the values to check what's being used
+        const authParameter = `${authorization.role.name}: ${authorization.payload.name}`;
+        functionParameters.push(authParameter);
+    }
+    // Add path parameters (e.g., id, postId, etc.)
+    const pathParameters = operation.parameters.map((param) => {
+        const paramType = param.schema.type;
+        const paramFormat = "format" in param.schema
+            ? ` & tags.Format<'${param.schema.format}'>`
+            : "";
+        return `${param.name}: ${paramType}${paramFormat}`;
+    });
+    functionParameters.push(...pathParameters);
+    // Add request body parameter if present
+    if ((_a = operation.requestBody) === null || _a === void 0 ? void 0 : _a.typeName) {
+        const bodyParameter = `body: ${operation.requestBody.typeName}`;
+        functionParameters.push(bodyParameter);
+    }
+    // Format parameters for props object
+    const hasParameters = functionParameters.length > 0;
+    let formattedSignature;
+    if (hasParameters) {
+        const propsFields = functionParameters
+            .map((param) => `  ${param}`)
+            .join(";\n");
+        formattedSignature = `props: {\n${propsFields};\n}`;
+    }
+    else {
+        formattedSignature = "";
+    }
+    // Determine return type
+    const returnType = (_c = (_b = operation.responseBody) === null || _b === void 0 ? void 0 : _b.typeName) !== null && _c !== void 0 ? _c : "void";
+    // Generate the complete template
+    return utils_1.StringUtil.trim `
+    Complete the code below, disregard the import part and return only the function part.
+
+    \`\`\`typescript
+    ${(0, getRealizeWriteImportStatements_1.getRealizeWriteImportStatements)(operation).join("\n")} 
+
+    // ONLY YOU HAVE TO WRITE THIS, AND USE IMPORTED.
+    export async function ${scenario.functionName}(${formattedSignature}): Promise<${returnType}> {
+      ...
+    }
+    \`\`\`
+  `;
+}
+//# sourceMappingURL=getRealizeWriteCodeTemplate.js.map

package/lib/agent/src/orchestrate/realize/utils/getRealizeWriteCodeTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRealizeWriteCodeTemplate.js","sourceRoot":"","sources":["../../../../../../src/orchestrate/realize/utils/getRealizeWriteCodeTemplate.ts"],"names":[],"mappings":";;AAkCA,kEA8DC;AA/FD,yCAA2C;AAG3C,uFAAoF;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,2BAA2B,CACzC,QAAsC,EACtC,SAAmC,EACnC,aAAgD;;IAEhD,2CAA2C;IAC3C,MAAM,kBAAkB,GAAa,EAAE,CAAC;IAExC,4EAA4E;IAC5E,IAAI,aAAa,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7C,mDAAmD;QACnD,MAAM,aAAa,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClF,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACzC,CAAC;IAED,+CAA+C;IAC/C,MAAM,cAAc,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;QACpC,MAAM,WAAW,GACf,QAAQ,IAAI,KAAK,CAAC,MAAM;YACtB,CAAC,CAAC,mBAAmB,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI;YAC5C,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,GAAG,WAAW,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;IACH,kBAAkB,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;IAE3C,wCAAwC;IACxC,IAAI,MAAA,SAAS,CAAC,WAAW,0CAAE,QAAQ,EAAE,CAAC;QACpC,MAAM,aAAa,GAAG,SAAS,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QAChE,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACzC,CAAC;IAED,qCAAqC;IACrC,MAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;IAEpD,IAAI,kBAA0B,CAAC;IAC/B,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,WAAW,GAAG,kBAAkB;aACnC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC;aAC5B,IAAI,CAAC,KAAK,CAAC,CAAC;QAEf,kBAAkB,GAAG,aAAa,WAAW,MAAM,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,kBAAkB,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED,wBAAwB;IACxB,MAAM,UAAU,GAAG,MAAA,MAAA,SAAS,CAAC,YAAY,0CAAE,QAAQ,mCAAI,MAAM,CAAC;IAE9D,iCAAiC;IACjC,OAAO,kBAAU,CAAC,IAAI,CAAA;;;;MAIlB,IAAA,iEAA+B,EAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;4BAG/B,QAAQ,CAAC,YAAY,IAAI,kBAAkB,cAAc,UAAU;;;;GAI5F,CAAC;AACJ,CAAC"}

package/lib/agent/src/orchestrate/realize/utils/getRealizeWriteDto.d.ts

@@ -0,0 +1,4 @@
+import { AutoBeOpenApi } from "@autobe/interface";
+import { ILlmSchema } from "@samchon/openapi";
+import { AutoBeContext } from "../../../context/AutoBeContext";
+export declare function getRealizeWriteDto<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, operation: AutoBeOpenApi.IOperation): Promise<Record<string, string>>;

package/lib/agent/src/orchestrate/realize/utils/getRealizeWriteDto.js

@@ -0,0 +1,55 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRealizeWriteDto = getRealizeWriteDto;
+const openapi_1 = require("@samchon/openapi");
+function getRealizeWriteDto(ctx, operation) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const document = filterDocument(operation, ctx.state().interface.document);
+        const compiler = yield ctx.compiler();
+        const entries = Object.entries(yield compiler.interface.write(document));
+        const filter = (prefix, exclude) => {
+            const result = entries.filter(([key]) => key.startsWith(prefix) === true);
+            return Object.fromEntries(exclude
+                ? result.filter(([key]) => key.startsWith(exclude) === false)
+                : result);
+        };
+        const dto = filter("src/api/structures");
+        return dto;
+    });
+}
+function filterDocument(operation, document) {
+    const components = {
+        authorization: document.components.authorization,
+        schemas: {},
+    };
+    const visit = (typeName) => {
+        openapi_1.OpenApiTypeChecker.visit({
+            components: document.components,
+            schema: { $ref: `#/components/schemas/${typeName}` },
+            closure: (s) => {
+                if (openapi_1.OpenApiTypeChecker.isReference(s)) {
+                    const key = s.$ref.split("/").pop();
+                    components.schemas[key] = document.components.schemas[key];
+                }
+            },
+        });
+    };
+    if (operation.requestBody)
+        visit(operation.requestBody.typeName);
+    if (operation.responseBody)
+        visit(operation.responseBody.typeName);
+    return {
+        operations: [operation],
+        components,
+    };
+}
+//# sourceMappingURL=getRealizeWriteDto.js.map

package/lib/agent/src/orchestrate/realize/utils/getRealizeWriteDto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRealizeWriteDto.js","sourceRoot":"","sources":["../../../../../../src/orchestrate/realize/utils/getRealizeWriteDto.ts"],"names":[],"mappings":";;;;;;;;;;;AAKA,gDA2BC;AA/BD,8CAAkE;AAIlE,SAAsB,kBAAkB,CACtC,GAAyB,EACzB,SAAmC;;QAEnC,MAAM,QAAQ,GAA4B,cAAc,CACtD,SAAS,EACT,GAAG,CAAC,KAAK,EAAE,CAAC,SAAU,CAAC,QAAQ,CAChC,CAAC;QAEF,MAAM,QAAQ,GAAoB,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC;QACvD,MAAM,OAAO,GAAuB,MAAM,CAAC,OAAO,CAChD,MAAM,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CACzC,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,OAAgB,EAAE,EAAE;YAClD,MAAM,MAAM,GAAuB,OAAO,CAAC,MAAM,CAC/C,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI,CAC3C,CAAC;YACF,OAAO,MAAM,CAAC,WAAW,CACvB,OAAO;gBACL,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC;gBAC7D,CAAC,CAAC,MAAM,CACX,CAAC;QACJ,CAAC,CAAC;QAEF,MAAM,GAAG,GAA2B,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACjE,OAAO,GAAG,CAAC;IACb,CAAC;CAAA;AAED,SAAS,cAAc,CACrB,SAAmC,EACnC,QAAiC;IAEjC,MAAM,UAAU,GAA8B;QAC5C,aAAa,EAAE,QAAQ,CAAC,UAAU,CAAC,aAAa;QAChD,OAAO,EAAE,EAAE;KACZ,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,QAAgB,EAAE,EAAE;QACjC,4BAAkB,CAAC,KAAK,CAAC;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,MAAM,EAAE,EAAE,IAAI,EAAE,wBAAwB,QAAQ,EAAE,EAAE;YACpD,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gBACb,IAAI,4BAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtC,MAAM,GAAG,GAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC;oBAC7C,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,SAAS,CAAC,WAAW;QAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACjE,IAAI,SAAS,CAAC,YAAY;QAAE,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEnE,OAAO;QACL,UAAU,EAAE,CAAC,SAAS,CAAC;QACvB,UAAU;KACX,CAAC;AACJ,CAAC"}

package/lib/agent/src/orchestrate/realize/utils/getRealizeWriteImportStatements.d.ts

@@ -0,0 +1,2 @@
+import { AutoBeOpenApi } from "@autobe/interface";
+export declare function getRealizeWriteImportStatements(operation: AutoBeOpenApi.IOperation): string[];

package/lib/agent/src/orchestrate/realize/utils/getRealizeWriteImportStatements.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRealizeWriteImportStatements = getRealizeWriteImportStatements;
+function getRealizeWriteImportStatements(operation) {
+    const typeReferences = Array.from(new Set([operation.requestBody, operation.responseBody]
+        .filter((el) => el !== null)
+        .map((el) => el.typeName.split(".")[0])));
+    // Build the standard imports
+    const imports = [
+        'import jwt from "jsonwebtoken";',
+        'import { MyGlobal } from "../MyGlobal";',
+        'import typia, { tags } from "typia";',
+        'import { Prisma } from "@prisma/client";',
+        'import { v4 } from "uuid";',
+        'import { toISOStringSafe } from "../util/toISOStringSafe"',
+        ...typeReferences.map((ref) => `import { ${ref} } from "@ORGANIZATION/PROJECT-api/lib/structures/${ref}";`),
+    ];
+    return imports;
+}
+//# sourceMappingURL=getRealizeWriteImportStatements.js.map

package/lib/agent/src/orchestrate/realize/utils/getRealizeWriteImportStatements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRealizeWriteImportStatements.js","sourceRoot":"","sources":["../../../../../../src/orchestrate/realize/utils/getRealizeWriteImportStatements.ts"],"names":[],"mappings":";;AAEA,0EA0BC;AA1BD,SAAgB,+BAA+B,CAC7C,SAAmC;IAEnC,MAAM,cAAc,GAAa,KAAK,CAAC,IAAI,CACzC,IAAI,GAAG,CACL,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,YAAY,CAAC;SAC5C,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;SAC3B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,CAC3C,CACF,CAAC;IAEF,6BAA6B;IAC7B,MAAM,OAAO,GAAG;QACd,iCAAiC;QACjC,yCAAyC;QACzC,sCAAsC;QACtC,0CAA0C;QAC1C,4BAA4B;QAC5B,2DAA2D;QAC3D,GAAG,cAAc,CAAC,GAAG,CACnB,CAAC,GAAG,EAAE,EAAE,CACN,YAAY,GAAG,qDAAqD,GAAG,IAAI,CAC9E;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/lib/agent/src/orchestrate/realize/utils/getRealizeWriteInputType.d.ts

@@ -0,0 +1,30 @@
+import { AutoBeOpenApi, AutoBeRealizeAuthorization } from "@autobe/interface";
+/**
+ * Generate TypeScript type definition string for provider function props
+ *
+ * This utility creates the exact props interface that the Realize Agent's
+ * generated provider functions must accept. It combines:
+ *
+ * - Authentication context (user/admin/member from authorization)
+ * - URL path parameters (e.g., id, boardId, postId)
+ * - Request body type (if applicable)
+ *
+ * The output is injected into REALIZE_WRITE_ARTIFACT.md template to tell the AI
+ * exactly what parameter type the function should accept.
+ *
+ * @example
+ *   // For DELETE /posts/:id (authenticated)
+ *   // Returns: "props: { user: IUser; id: string & tags.Format<'uuid'>; }"
+ *
+ * @example
+ *   // For GET /public/info (no auth, no params)
+ *   // Returns: "// No props parameter needed - function should have no parameters"
+ *
+ * @param operation - OpenAPI operation definition containing parameters and
+ *   auth requirements
+ * @param authorization - Authorization context with user/role information (if
+ *   authenticated endpoint)
+ * @returns TypeScript interface string like "props: { user: IUser; id: string;
+ *   body: IRequest; }"
+ */
+export declare function getRealizeWriteInputType(operation: AutoBeOpenApi.IOperation, authorization: AutoBeRealizeAuthorization | null): string;

package/lib/agent/src/orchestrate/realize/utils/getRealizeWriteInputType.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRealizeWriteInputType = getRealizeWriteInputType;
+const utils_1 = require("@autobe/utils");
+/**
+ * Generate TypeScript type definition string for provider function props
+ *
+ * This utility creates the exact props interface that the Realize Agent's
+ * generated provider functions must accept. It combines:
+ *
+ * - Authentication context (user/admin/member from authorization)
+ * - URL path parameters (e.g., id, boardId, postId)
+ * - Request body type (if applicable)
+ *
+ * The output is injected into REALIZE_WRITE_ARTIFACT.md template to tell the AI
+ * exactly what parameter type the function should accept.
+ *
+ * @example
+ *   // For DELETE /posts/:id (authenticated)
+ *   // Returns: "props: { user: IUser; id: string & tags.Format<'uuid'>; }"
+ *
+ * @example
+ *   // For GET /public/info (no auth, no params)
+ *   // Returns: "// No props parameter needed - function should have no parameters"
+ *
+ * @param operation - OpenAPI operation definition containing parameters and
+ *   auth requirements
+ * @param authorization - Authorization context with user/role information (if
+ *   authenticated endpoint)
+ * @returns TypeScript interface string like "props: { user: IUser; id: string;
+ *   body: IRequest; }"
+ */
+function getRealizeWriteInputType(operation, authorization) {
+    var _a, _b;
+    const functionParameterFields = [];
+    // Add authentication field (user/admin/member) if endpoint requires auth
+    const hasAuthentication = authorization && operation.authorizationRole;
+    if (hasAuthentication) {
+        const authFieldName = operation.authorizationRole;
+        const authFieldType = authorization.payload.name;
+        functionParameterFields.push(`${authFieldName}: ${authFieldType};`);
+    }
+    // Add URL path parameters (e.g., /posts/:id → id parameter)
+    const pathParameters = operation.parameters;
+    pathParameters.forEach((pathParam) => {
+        const paramName = pathParam.name;
+        const paramType = pathParam.schema.type;
+        const paramFormat = "format" in pathParam.schema
+            ? ` & tags.Format<'${pathParam.schema.format}'>`
+            : "";
+        const parameterField = `${paramName}: ${paramType}${paramFormat};`;
+        functionParameterFields.push(parameterField);
+    });
+    // Add request body if present (POST/PUT/PATCH operations)
+    const hasRequestBody = (_a = operation.requestBody) === null || _a === void 0 ? void 0 : _a.typeName;
+    if (hasRequestBody) {
+        const bodyTypeName = (_b = operation.requestBody) === null || _b === void 0 ? void 0 : _b.typeName;
+        functionParameterFields.push(`body: ${bodyTypeName};`);
+    }
+    // Format as TypeScript props interface or indicate no parameters needed
+    const hasParameters = functionParameterFields.length > 0;
+    if (!hasParameters) {
+        return `// No props parameter needed - function should have no parameters`;
+    }
+    const formattedFields = functionParameterFields
+        .map((field) => `  ${field}`)
+        .join("\n");
+    return utils_1.StringUtil.trim `
+    props: {
+    ${formattedFields}
+    }`;
+}
+//# sourceMappingURL=getRealizeWriteInputType.js.map

package/lib/agent/src/orchestrate/realize/utils/getRealizeWriteInputType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRealizeWriteInputType.js","sourceRoot":"","sources":["../../../../../../src/orchestrate/realize/utils/getRealizeWriteInputType.ts"],"names":[],"mappings":";;AA+BA,4DAkDC;AAhFD,yCAA2C;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,wBAAwB,CACtC,SAAmC,EACnC,aAAgD;;IAEhD,MAAM,uBAAuB,GAAa,EAAE,CAAC;IAE7C,yEAAyE;IACzE,MAAM,iBAAiB,GAAG,aAAa,IAAI,SAAS,CAAC,iBAAiB,CAAC;IACvE,IAAI,iBAAiB,EAAE,CAAC;QACtB,MAAM,aAAa,GAAG,SAAS,CAAC,iBAAiB,CAAC;QAClD,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;QACjD,uBAAuB,CAAC,IAAI,CAAC,GAAG,aAAa,KAAK,aAAa,GAAG,CAAC,CAAC;IACtE,CAAC;IAED,4DAA4D;IAC5D,MAAM,cAAc,GAAG,SAAS,CAAC,UAAU,CAAC;IAC5C,cAAc,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QACnC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC;QACjC,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;QACxC,MAAM,WAAW,GACf,QAAQ,IAAI,SAAS,CAAC,MAAM;YAC1B,CAAC,CAAC,mBAAmB,SAAS,CAAC,MAAM,CAAC,MAAM,IAAI;YAChD,CAAC,CAAC,EAAE,CAAC;QAET,MAAM,cAAc,GAAG,GAAG,SAAS,KAAK,SAAS,GAAG,WAAW,GAAG,CAAC;QACnE,uBAAuB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,0DAA0D;IAC1D,MAAM,cAAc,GAAG,MAAA,SAAS,CAAC,WAAW,0CAAE,QAAQ,CAAC;IACvD,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,YAAY,GAAG,MAAA,SAAS,CAAC,WAAW,0CAAE,QAAQ,CAAC;QACrD,uBAAuB,CAAC,IAAI,CAAC,SAAS,YAAY,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,wEAAwE;IACxE,MAAM,aAAa,GAAG,uBAAuB,CAAC,MAAM,GAAG,CAAC,CAAC;IAEzD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,mEAAmE,CAAC;IAC7E,CAAC;IAED,MAAM,eAAe,GAAG,uBAAuB;SAC5C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC;SAC5B,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,kBAAU,CAAC,IAAI,CAAA;;MAElB,eAAe;MACf,CAAC;AACP,CAAC"}

package/lib/agent/src/orchestrate/realize/utils/replaceImportStatements.d.ts

@@ -1,4 +1,8 @@
+import { AutoBeOpenApi } from "@autobe/interface";
 import { ILlmSchema } from "@samchon/openapi";
 import { AutoBeContext } from "../../../context/AutoBeContext";
-import { IAutoBeTestScenarioArtifacts } from "../../test/structures/IAutoBeTestScenarioArtifacts";
-export declare function replaceImportStatements<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>): (artifacts: IAutoBeTestScenarioArtifacts, code: string, decoratorType?: string) => Promise<string>;
+export declare function replaceImportStatements<Model extends ILlmSchema.Model>(ctx: AutoBeContext<Model>, props: {
+    operation: AutoBeOpenApi.IOperation;
+    code: string;
+    decoratorType?: string;
+}): Promise<string>;

package/lib/agent/src/orchestrate/realize/utils/replaceImportStatements.js

@@ -10,74 +10,68 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.replaceImportStatements = replaceImportStatements;
-function replaceImportStatements(ctx) {
-    return function (artifacts, code, decoratorType) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const typeReferences = Array.from(new Set(Object.keys(artifacts.document.components.schemas).map((key) => key.split(".")[0])));
-            const compiler = yield ctx.compiler();
-            code = yield compiler.typescript.beautify(code);
-            // Remove existing import statements using flexible regex patterns
-            code = code
-                .replace(/import\s*{\s*MyGlobal\s*}\s*from\s*["']\.\.\/MyGlobal["']\s*;?\s*/gm, "")
-                .replace(/import\s+typia\s*,\s*{\s*tags\s*}\s*from\s*["']typia["']\s*;?\s*/gm, "")
-                .replace(/import\s*{\s*tags\s*}\s*from\s*["']typia["']\s*;?\s*/gm, "")
-                .replace(/import\s*{\s*tags\s*,\s*typia\s*}\s*from\s*["']typia["']\s*;?\s*/gm, "")
-                .replace(/import\s+typia\s*from\s*["']typia["']\s*;?\s*/gm, "")
-                .replace(/import\s*{\s*Prisma\s*}\s*from\s*["']@prisma\/client["']\s*;?\s*/gm, "")
-                .replace(/import\s*{\s*v4\s*}\s*from\s*["']uuid["']\s*;?\s*/gm, "")
-                .replace(/import\s*{\s*toISOStringSafe\s*}\s*from\s*["']\.\.\/util\/toISOStringSafe["']\s*;?\s*/gm, "")
-                // Remove JWT import if it exists (to prevent duplication)
-                .replace(/import\s+jwt\s+from\s*["']jsonwebtoken["']\s*;?\s*/gm, "")
-                .replace(/import\s*\*\s*as\s+jwt\s+from\s*["']jsonwebtoken["']\s*;?\s*/gm, "");
-            // Remove any existing API structure imports
-            // Pattern 1: ../api/structures path
-            code = code.replace(/import\s*(?:type\s*)?{\s*[^}]+\s*}\s*from\s*["']\.\.\/api\/structures\/[^"']+["']\s*;?\s*/gm, "");
-            // Pattern 2: @ORGANIZATION/PROJECT-api/lib/structures path
-            code = code.replace(/import\s*(?:type\s*)?{\s*[^}]+\s*}\s*from\s*["']@ORGANIZATION\/PROJECT-api\/lib\/structures\/[^"']+["']\s*;?\s*/gm, "");
-            // Remove specific type imports that match our typeReferences
-            for (const ref of typeReferences) {
-                // Remove any import of this specific type from any path
-                const typeImportRegex = new RegExp(`import\\s*(?:type\\s*)?{\\s*${ref}\\s*}\\s*from\\s*["'][^"']+["']\\s*;?\\s*`, "gm");
-                code = code.replace(typeImportRegex, "");
-            }
-            // Remove any existing decoratorType imports if LLM mistakenly added them
-            if (decoratorType) {
-                const decoratorTypeRegex = new RegExp(`import\\s*(?:type\\s*)?{\\s*${decoratorType}\\s*}\\s*from\\s*["']\\.\\.\/decorators\/payload\/${decoratorType}["']\\s*;?\\s*`, "gm");
-                code = code.replace(decoratorTypeRegex, "");
-            }
-            // Build the standard imports
-            const imports = [
-                'import jwt from "jsonwebtoken";',
-                'import { MyGlobal } from "../MyGlobal";',
-                'import typia, { tags } from "typia";',
-                'import { Prisma } from "@prisma/client";',
-                'import { v4 } from "uuid";',
-                'import { toISOStringSafe } from "../util/toISOStringSafe"',
-                ...typeReferences.map((ref) => `import { ${ref} } from "@ORGANIZATION/PROJECT-api/lib/structures/${ref}";`),
-            ];
-            // Only add decoratorType import if it exists
-            if (decoratorType) {
-                imports.push(`import { ${decoratorType} } from "../decorators/payload/${decoratorType}"`);
-            }
-            code = [...imports, "", code].join("\n");
-            // Clean up formatting issues
-            code =
-                code
-                    // Remove lines with only whitespace
-                    .replace(/^\s+$/gm, "")
-                    // Replace 3+ consecutive newlines with exactly 2 newlines
-                    .replace(/\n{3,}/g, "\n\n")
-                    // Ensure proper spacing after import section
-                    .replace(/(import.*?;)(\s*)(\n(?!import|\s*$))/g, "$1\n\n$3")
-                    // Trim and ensure single trailing newline
-                    .trim() + "\n";
-            // fix escaped codes
-            code = code.replace(/\\n/g, "\n").replace(/\\"/g, '"').replace(/\\'/g, "'");
-            // Apply final beautification
-            code = yield compiler.typescript.beautify(code);
-            code = code.replaceAll("typia.tags.assert", "typia.assert");
-            return code;
-        });
-    };
+const getRealizeWriteImportStatements_1 = require("./getRealizeWriteImportStatements");
+function replaceImportStatements(ctx, props) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let { operation, code, decoratorType } = props;
+        const typeReferences = Array.from(new Set([operation.requestBody, operation.responseBody]
+            .filter((el) => el !== null)
+            .map((el) => el.typeName.split(".")[0])));
+        const compiler = yield ctx.compiler();
+        code = yield compiler.typescript.beautify(code);
+        // Remove existing import statements using flexible regex patterns
+        code = code
+            .replace(/import\s*{\s*MyGlobal\s*}\s*from\s*["']\.\.\/MyGlobal["']\s*;?\s*/gm, "")
+            .replace(/import\s+typia\s*,\s*{\s*tags\s*}\s*from\s*["']typia["']\s*;?\s*/gm, "")
+            .replace(/import\s*{\s*tags\s*}\s*from\s*["']typia["']\s*;?\s*/gm, "")
+            .replace(/import\s*{\s*tags\s*,\s*typia\s*}\s*from\s*["']typia["']\s*;?\s*/gm, "")
+            .replace(/import\s+typia\s*from\s*["']typia["']\s*;?\s*/gm, "")
+            .replace(/import\s*{\s*Prisma\s*}\s*from\s*["']@prisma\/client["']\s*;?\s*/gm, "")
+            .replace(/import\s*{\s*v4\s*}\s*from\s*["']uuid["']\s*;?\s*/gm, "")
+            .replace(/import\s*{\s*toISOStringSafe\s*}\s*from\s*["']\.\.\/util\/toISOStringSafe["']\s*;?\s*/gm, "")
+            // Remove JWT import if it exists (to prevent duplication)
+            .replace(/import\s+jwt\s+from\s*["']jsonwebtoken["']\s*;?\s*/gm, "")
+            .replace(/import\s*\*\s*as\s+jwt\s+from\s*["']jsonwebtoken["']\s*;?\s*/gm, "");
+        // Remove any existing API structure imports
+        // Pattern 1: ../api/structures path
+        code = code.replace(/import\s*(?:type\s*)?{\s*[^}]+\s*}\s*from\s*["']\.\.\/api\/structures\/[^"']+["']\s*;?\s*/gm, "");
+        // Pattern 2: @ORGANIZATION/PROJECT-api/lib/structures path
+        code = code.replace(/import\s*(?:type\s*)?{\s*[^}]+\s*}\s*from\s*["']@ORGANIZATION\/PROJECT-api\/lib\/structures\/[^"']+["']\s*;?\s*/gm, "");
+        // Remove specific type imports that match our typeReferences
+        for (const ref of typeReferences) {
+            // Remove any import of this specific type from any path
+            const typeImportRegex = new RegExp(`import\\s*(?:type\\s*)?{\\s*${ref}\\s*}\\s*from\\s*["'][^"']+["']\\s*;?\\s*`, "gm");
+            code = code.replace(typeImportRegex, "");
+        }
+        // Remove any existing decoratorType imports if LLM mistakenly added them
+        if (decoratorType) {
+            const decoratorTypeRegex = new RegExp(`import\\s*(?:type\\s*)?{\\s*${decoratorType}\\s*}\\s*from\\s*["']\\.\\.\/decorators\/payload\/${decoratorType}["']\\s*;?\\s*`, "gm");
+            code = code.replace(decoratorTypeRegex, "");
+        }
+        // Build the standard imports
+        const imports = (0, getRealizeWriteImportStatements_1.getRealizeWriteImportStatements)(operation);
+        // Only add decoratorType import if it exists
+        if (decoratorType) {
+            imports.push(`import { ${decoratorType} } from "../decorators/payload/${decoratorType}"`);
+        }
+        code = [...imports, "", code].join("\n");
+        // Clean up formatting issues
+        code =
+            code
+                // Remove lines with only whitespace
+                .replace(/^\s+$/gm, "")
+                // Replace 3+ consecutive newlines with exactly 2 newlines
+                .replace(/\n{3,}/g, "\n\n")
+                // Ensure proper spacing after import section
+                .replace(/(import.*?;)(\s*)(\n(?!import|\s*$))/g, "$1\n\n$3")
+                // Trim and ensure single trailing newline
+                .trim() + "\n";
+        // fix escaped codes
+        code = code.replace(/\\n/g, "\n").replace(/\\"/g, '"').replace(/\\'/g, "'");
+        // Apply final beautification
+        code = yield compiler.typescript.beautify(code);
+        code = code.replaceAll("typia.tags.assert", "typia.assert");
+        return code;
+    });
 }
 //# sourceMappingURL=replaceImportStatements.js.map