@autobe/agent 0.3.13 → 0.3.17

package/lib/index.mjs

@@ -5109,6 +5109,43 @@ function processCompilerResult(result) {
     return result;
 }
 
+var StringUtil;
+
+(function(StringUtil) {
+    function trim(strings, ...values) {
+        let result = strings[0];
+        for (let i = 0; i < values.length; i++) {
+            result += String(values[i]) + strings[i + 1];
+        }
+        const lines = result.split("\n");
+        while (lines.length > 0 && lines[0].trim() === "") {
+            lines.shift();
+        }
+        while (lines.length > 0 && lines[lines.length - 1].trim() === "") {
+            lines.pop();
+        }
+        if (lines.length === 0) return "";
+        const firstNonEmptyLine = lines.find((line => line.trim() !== ""));
+        if (!firstNonEmptyLine) return "";
+        const leadingWhitespace = firstNonEmptyLine.match(/^[ \t]*/)?.[0] || "";
+        const indentLength = leadingWhitespace.length;
+        const trimmedLines = lines.map((line => {
+            if (line.trim() === "") return "";
+            return line.slice(indentLength);
+        }));
+        return trimmedLines.join("\n");
+    }
+    StringUtil.trim = trim;
+    function singleLine(strings, ...values) {
+        let result = strings[0];
+        for (let i = 0; i < values.length; i++) {
+            result += String(values[i]) + strings[i + 1];
+        }
+        return result.replace(/\n/g, " ").replace(/\s+/g, " ").trim();
+    }
+    StringUtil.singleLine = singleLine;
+})(StringUtil || (StringUtil = {}));
+
 const createAutoBeController = props => {
     assertSchemaModel(props.model);
     const application = collection[props.model];
@@ -5117,11 +5154,59 @@ const createAutoBeController = props => {
         name: "autobe",
         application,
         execute: {
-            analyze: orchestrateAnalyze(props.context),
-            prisma: orchestratePrisma(props.context),
-            interface: orchestrateInterface(props.context),
-            test: orchestrateTest(),
-            realize: orchestrateRealize()
+            analyze: async next => {
+                const r = await orchestrateAnalyze(props.context)(next);
+                if (r.type === "analyze") return {
+                    type: "success",
+                    description: "Analysis completed successfully, and report has been published."
+                }; else return {
+                    type: "in-progress",
+                    description: StringUtil.trim`
+              Requirements are not yet fully elicited, 
+              therefore additional questions will be made to the user.
+            `
+                };
+            },
+            prisma: async next => {
+                const r = await orchestratePrisma(props.context)(next);
+                if (r.type === "prisma") return {
+                    type: r.result.type,
+                    description: r.result.type === "success" ? "Prisma schemas have been generated successfully." : r.result.type === "failure" ? "Prisma schemas are generated, but compilation failed." : "Unexpected error occurred while generating Prisma schemas."
+                }; else return {
+                    type: "prerequisites-not-satisfied",
+                    description: "Requirement analysis is not yet completed."
+                };
+            },
+            interface: async next => {
+                const r = await orchestrateInterface(props.context)(next);
+                if (r.type === "interface") return {
+                    type: "success",
+                    description: "API interfaces have been designed successfully."
+                }; else return {
+                    type: "prerequisites-not-satisfied",
+                    description: "Prisma schemas are not yet completed."
+                };
+            },
+            test: async next => {
+                const r = await orchestrateTest()(next);
+                if (r.type === "test") return {
+                    type: r.result.type,
+                    description: r.result.type === "success" ? "Test functions have been generated successfully." : r.result.type === "failure" ? "Test functions are written, but compilation failed." : "Unexpected error occurred while writing test functions."
+                }; else return {
+                    type: "prerequisites-not-satisfied",
+                    description: "API interfaces are not yet completed."
+                };
+            },
+            realize: async next => {
+                const r = await orchestrateRealize()(next);
+                if (r.type === "realize") return {
+                    type: r.result.type,
+                    description: r.result.type === "success" ? "API implementation codes have been generated successfully." : r.result.type === "failure" ? "Implementation codes are composed, but compilation failed." : "Unexpected error occurred while writing implementation codes."
+                }; else return {
+                    type: "prerequisites-not-satisfied",
+                    description: "API interfaces are not yet completed."
+                };
+            }
         }
     };
 };
@@ -5157,11 +5242,24 @@ const claude = {
             description: "Current Type: {@link IAutoBeApplicationResult}",
             type: "object",
             properties: {
-                success: {
-                    type: "boolean"
+                type: {
+                    oneOf: [ {
+                        const: "success"
+                    }, {
+                        const: "failure"
+                    }, {
+                        const: "exception"
+                    }, {
+                        const: "in-progress"
+                    }, {
+                        const: "prerequisites-not-satisfied"
+                    } ]
+                },
+                description: {
+                    type: "string"
                 }
             },
-            required: [ "success" ]
+            required: [ "type", "description" ]
         },
         description: "Run Analyze Agent.\n\nExecutes the Analyze agent to process user requirements and generate a\nstructured specification document. This agent analyzes all conversation\nhistory between users and AI, separates business logic from technical\nrequirements, and establishes development priorities and scope.\n\n**IMPORTANT**: Only call this function when sufficient requirements have\nbeen discussed to generate a comprehensive specification. The context must\ncontain enough detail about the system's purpose, core features, data\nmodels, and business rules. If requirements are unclear or incomplete,\ncontinue gathering information through conversation instead.\n\nThe agent will automatically generate follow-up questions for any ambiguous\nrequirements and continuously refine its understanding through iterative\nconversation. When executed after other agents have generated code, it can\nalso interpret change requests in the context of existing implementations.",
         validate: (() => {
@@ -5232,11 +5330,24 @@ const claude = {
             description: "Current Type: {@link IAutoBeApplicationResult}",
             type: "object",
             properties: {
-                success: {
-                    type: "boolean"
+                type: {
+                    oneOf: [ {
+                        const: "success"
+                    }, {
+                        const: "failure"
+                    }, {
+                        const: "exception"
+                    }, {
+                        const: "in-progress"
+                    }, {
+                        const: "prerequisites-not-satisfied"
+                    } ]
+                },
+                description: {
+                    type: "string"
                 }
             },
-            required: [ "success" ]
+            required: [ "type", "description" ]
         },
         description: "Run prisma agent.\n\nExecutes the Prisma agent to generate database schema files and ERD\ndocumentation. This agent reads the requirements specification created by\nthe {@link analyze Analyze agent} and produces a complete Prisma schema with\ncomprehensive documentation for each entity and attribute.\n\n**PREREQUISITE**: Only call this function after the {@link analyze} function\nhas been successfully executed and a requirements specification document\nhas been generated. The Prisma agent depends on the structured requirements\nanalysis to design the database schema properly. Without a completed\nrequirements specification, this function should NOT be called.\n\nThe agent will automatically validate the generated schema using the Prisma\ncompiler, self-correct any compilation errors through feedback loops, and\ngenerate ERD documentation using prisma-markdown. An internal review\nprocess ensures schema quality and optimization.",
         validate: (() => {
@@ -5307,11 +5418,24 @@ const claude = {
             description: "Current Type: {@link IAutoBeApplicationResult}",
             type: "object",
             properties: {
-                success: {
-                    type: "boolean"
+                type: {
+                    oneOf: [ {
+                        const: "success"
+                    }, {
+                        const: "failure"
+                    }, {
+                        const: "exception"
+                    }, {
+                        const: "in-progress"
+                    }, {
+                        const: "prerequisites-not-satisfied"
+                    } ]
+                },
+                description: {
+                    type: "string"
                 }
             },
-            required: [ "success" ]
+            required: [ "type", "description" ]
         },
         description: "Run interface agent.\n\nExecutes the Interface agent to design and generate API interfaces. This\nagent creates OpenAPI schemas and TypeScript/NestJS code based on the\nrequirements specification and ERD documentation from previous agents.\n\nThe agent follows a sophisticated pipeline: first constructing formal\nOpenAPI Operation Schemas and JSON Schemas, then validating these schemas,\nand finally transforming them into NestJS controllers and DTOs. Each\ngenerated interface includes comprehensive JSDoc comments and undergoes\ninternal review for consistency.",
         validate: (() => {
@@ -5382,11 +5506,24 @@ const claude = {
             description: "Current Type: {@link IAutoBeApplicationResult}",
             type: "object",
             properties: {
-                success: {
-                    type: "boolean"
+                type: {
+                    oneOf: [ {
+                        const: "success"
+                    }, {
+                        const: "failure"
+                    }, {
+                        const: "exception"
+                    }, {
+                        const: "in-progress"
+                    }, {
+                        const: "prerequisites-not-satisfied"
+                    } ]
+                },
+                description: {
+                    type: "string"
                 }
             },
-            required: [ "success" ]
+            required: [ "type", "description" ]
         },
         description: "Run test program agent.\n\nExecutes the Test agent to generate comprehensive E2E test suites for all\n{@link interface API interfaces}. This agent synthesizes outputs from\nprevious agents to create tests that validate both individual endpoints and\ntheir interactions.\n\n**PREREQUISITE**: Only call this function after the {@link interface}\nfunction has been successfully executed and API interfaces have been\ngenerated. The Test agent requires the completed API interface definitions,\nOpenAPI schemas, and TypeScript code to generate appropriate test\nscenarios. Without completed interface design, this function should NOT be\ncalled.\n\nThe agent will analyze dependency relationships between API functions,\nstructure integrated test scenarios with correct execution sequences, and\nenhance pre-generated test scaffolds with business logic validation.\nTypeScript compiler validation and internal review ensure test quality and\noptimal coverage.",
         validate: (() => {
@@ -5457,11 +5594,24 @@ const claude = {
             description: "Current Type: {@link IAutoBeApplicationResult}",
             type: "object",
             properties: {
-                success: {
-                    type: "boolean"
+                type: {
+                    oneOf: [ {
+                        const: "success"
+                    }, {
+                        const: "failure"
+                    }, {
+                        const: "exception"
+                    }, {
+                        const: "in-progress"
+                    }, {
+                        const: "prerequisites-not-satisfied"
+                    } ]
+                },
+                description: {
+                    type: "string"
                 }
             },
-            required: [ "success" ]
+            required: [ "type", "description" ]
         },
         description: "Run realize agent.\n\nExecutes the Realize agent to implement the actual business logic for each\nAPI endpoint. This agent synthesizes all outputs from previous agents to\ngenerate fully functional service provider code.\n\n**PREREQUISITE**: Only call this function after the {@link interface}\nfunction has been successfully executed and API interfaces have been\ngenerated. The Realize agent requires the completed API interface\ndefinitions to implement the corresponding service logic. It also benefits\nfrom having test code available for validation. Without completed interface\ndesign, this function should NOT be called.\n\nThe agent will create service implementations with multiple validation\nlayers: TypeScript compiler feedback, runtime validation through test\nexecution, and quality optimization through internal review. The generated\ncode handles database interactions through Prisma, implements security and\nvalidation checks, and processes business rules according to\nspecifications.",
         validate: (() => {
@@ -5543,11 +5693,15 @@ const collection = {
                 description: "Current Type: {@link IAutoBeApplicationResult}",
                 type: "object",
                 properties: {
-                    success: {
-                        type: "boolean"
+                    type: {
+                        type: "string",
+                        enum: [ "success", "failure", "exception", "in-progress", "prerequisites-not-satisfied" ]
+                    },
+                    description: {
+                        type: "string"
                     }
                 },
-                required: [ "success" ]
+                required: [ "type", "description" ]
             },
             description: "Run Analyze Agent.\n\nExecutes the Analyze agent to process user requirements and generate a\nstructured specification document. This agent analyzes all conversation\nhistory between users and AI, separates business logic from technical\nrequirements, and establishes development priorities and scope.\n\n**IMPORTANT**: Only call this function when sufficient requirements have\nbeen discussed to generate a comprehensive specification. The context must\ncontain enough detail about the system's purpose, core features, data\nmodels, and business rules. If requirements are unclear or incomplete,\ncontinue gathering information through conversation instead.\n\nThe agent will automatically generate follow-up questions for any ambiguous\nrequirements and continuously refine its understanding through iterative\nconversation. When executed after other agents have generated code, it can\nalso interpret change requests in the context of existing implementations.",
             validate: (() => {
@@ -5618,11 +5772,15 @@ const collection = {
                 description: "Current Type: {@link IAutoBeApplicationResult}",
                 type: "object",
                 properties: {
-                    success: {
-                        type: "boolean"
+                    type: {
+                        type: "string",
+                        enum: [ "success", "failure", "exception", "in-progress", "prerequisites-not-satisfied" ]
+                    },
+                    description: {
+                        type: "string"
                     }
                 },
-                required: [ "success" ]
+                required: [ "type", "description" ]
             },
             description: "Run prisma agent.\n\nExecutes the Prisma agent to generate database schema files and ERD\ndocumentation. This agent reads the requirements specification created by\nthe {@link analyze Analyze agent} and produces a complete Prisma schema with\ncomprehensive documentation for each entity and attribute.\n\n**PREREQUISITE**: Only call this function after the {@link analyze} function\nhas been successfully executed and a requirements specification document\nhas been generated. The Prisma agent depends on the structured requirements\nanalysis to design the database schema properly. Without a completed\nrequirements specification, this function should NOT be called.\n\nThe agent will automatically validate the generated schema using the Prisma\ncompiler, self-correct any compilation errors through feedback loops, and\ngenerate ERD documentation using prisma-markdown. An internal review\nprocess ensures schema quality and optimization.",
             validate: (() => {
@@ -5693,11 +5851,15 @@ const collection = {
                 description: "Current Type: {@link IAutoBeApplicationResult}",
                 type: "object",
                 properties: {
-                    success: {
-                        type: "boolean"
+                    type: {
+                        type: "string",
+                        enum: [ "success", "failure", "exception", "in-progress", "prerequisites-not-satisfied" ]
+                    },
+                    description: {
+                        type: "string"
                     }
                 },
-                required: [ "success" ]
+                required: [ "type", "description" ]
             },
             description: "Run interface agent.\n\nExecutes the Interface agent to design and generate API interfaces. This\nagent creates OpenAPI schemas and TypeScript/NestJS code based on the\nrequirements specification and ERD documentation from previous agents.\n\nThe agent follows a sophisticated pipeline: first constructing formal\nOpenAPI Operation Schemas and JSON Schemas, then validating these schemas,\nand finally transforming them into NestJS controllers and DTOs. Each\ngenerated interface includes comprehensive JSDoc comments and undergoes\ninternal review for consistency.",
             validate: (() => {
@@ -5768,11 +5930,15 @@ const collection = {
                 description: "Current Type: {@link IAutoBeApplicationResult}",
                 type: "object",
                 properties: {
-                    success: {
-                        type: "boolean"
+                    type: {
+                        type: "string",
+                        enum: [ "success", "failure", "exception", "in-progress", "prerequisites-not-satisfied" ]
+                    },
+                    description: {
+                        type: "string"
                     }
                 },
-                required: [ "success" ]
+                required: [ "type", "description" ]
             },
             description: "Run test program agent.\n\nExecutes the Test agent to generate comprehensive E2E test suites for all\n{@link interface API interfaces}. This agent synthesizes outputs from\nprevious agents to create tests that validate both individual endpoints and\ntheir interactions.\n\n**PREREQUISITE**: Only call this function after the {@link interface}\nfunction has been successfully executed and API interfaces have been\ngenerated. The Test agent requires the completed API interface definitions,\nOpenAPI schemas, and TypeScript code to generate appropriate test\nscenarios. Without completed interface design, this function should NOT be\ncalled.\n\nThe agent will analyze dependency relationships between API functions,\nstructure integrated test scenarios with correct execution sequences, and\nenhance pre-generated test scaffolds with business logic validation.\nTypeScript compiler validation and internal review ensure test quality and\noptimal coverage.",
             validate: (() => {
@@ -5843,11 +6009,15 @@ const collection = {
                 description: "Current Type: {@link IAutoBeApplicationResult}",
                 type: "object",
                 properties: {
-                    success: {
-                        type: "boolean"
+                    type: {
+                        type: "string",
+                        enum: [ "success", "failure", "exception", "in-progress", "prerequisites-not-satisfied" ]
+                    },
+                    description: {
+                        type: "string"
                     }
                 },
-                required: [ "success" ]
+                required: [ "type", "description" ]
             },
             description: "Run realize agent.\n\nExecutes the Realize agent to implement the actual business logic for each\nAPI endpoint. This agent synthesizes all outputs from previous agents to\ngenerate fully functional service provider code.\n\n**PREREQUISITE**: Only call this function after the {@link interface}\nfunction has been successfully executed and API interfaces have been\ngenerated. The Realize agent requires the completed API interface\ndefinitions to implement the corresponding service logic. It also benefits\nfrom having test code available for validation. Without completed interface\ndesign, this function should NOT be called.\n\nThe agent will create service implementations with multiple validation\nlayers: TypeScript compiler feedback, runtime validation through test\nexecution, and quality optimization through internal review. The generated\ncode handles database interactions through Prisma, implements security and\nvalidation checks, and processes business rules according to\nspecifications.",
             validate: (() => {
@@ -5929,11 +6099,15 @@ const collection = {
             output: {
                 type: "object",
                 properties: {
-                    success: {
-                        type: "boolean"
+                    type: {
+                        type: "string",
+                        enum: [ "success", "failure", "exception", "in-progress", "prerequisites-not-satisfied" ]
+                    },
+                    description: {
+                        type: "string"
                     }
                 },
-                required: [ "success" ],
+                required: [ "type", "description" ],
                 description: "Current Type: {@link IAutoBeApplicationResult}",
                 additionalProperties: false
             },
@@ -6004,11 +6178,15 @@ const collection = {
             output: {
                 type: "object",
                 properties: {
-                    success: {
-                        type: "boolean"
+                    type: {
+                        type: "string",
+                        enum: [ "success", "failure", "exception", "in-progress", "prerequisites-not-satisfied" ]
+                    },
+                    description: {
+                        type: "string"
                     }
                 },
-                required: [ "success" ],
+                required: [ "type", "description" ],
                 description: "Current Type: {@link IAutoBeApplicationResult}",
                 additionalProperties: false
             },
@@ -6079,11 +6257,15 @@ const collection = {
             output: {
                 type: "object",
                 properties: {
-                    success: {
-                        type: "boolean"
+                    type: {
+                        type: "string",
+                        enum: [ "success", "failure", "exception", "in-progress", "prerequisites-not-satisfied" ]
+                    },
+                    description: {
+                        type: "string"
                     }
                 },
-                required: [ "success" ],
+                required: [ "type", "description" ],
                 description: "Current Type: {@link IAutoBeApplicationResult}",
                 additionalProperties: false
             },
@@ -6154,11 +6336,15 @@ const collection = {
             output: {
                 type: "object",
                 properties: {
-                    success: {
-                        type: "boolean"
+                    type: {
+                        type: "string",
+                        enum: [ "success", "failure", "exception", "in-progress", "prerequisites-not-satisfied" ]
+                    },
+                    description: {
+                        type: "string"
                     }
                 },
-                required: [ "success" ],
+                required: [ "type", "description" ],
                 description: "Current Type: {@link IAutoBeApplicationResult}",
                 additionalProperties: false
             },
@@ -6229,11 +6415,15 @@ const collection = {
             output: {
                 type: "object",
                 properties: {
-                    success: {
-                        type: "boolean"
+                    type: {
+                        type: "string",
+                        enum: [ "success", "failure", "exception", "in-progress", "prerequisites-not-satisfied" ]
+                    },
+                    description: {
+                        type: "string"
                     }
                 },
-                required: [ "success" ],
+                required: [ "type", "description" ],
                 description: "Current Type: {@link IAutoBeApplicationResult}",
                 additionalProperties: false
             },
@@ -6296,43 +6486,6 @@ const createAutoBeState = histories => {
     };
 };
 
-var StringUtil;
-
-(function(StringUtil) {
-    function trim(strings, ...values) {
-        let result = strings[0];
-        for (let i = 0; i < values.length; i++) {
-            result += String(values[i]) + strings[i + 1];
-        }
-        const lines = result.split("\n");
-        while (lines.length > 0 && lines[0].trim() === "") {
-            lines.shift();
-        }
-        while (lines.length > 0 && lines[lines.length - 1].trim() === "") {
-            lines.pop();
-        }
-        if (lines.length === 0) return "";
-        const firstNonEmptyLine = lines.find((line => line.trim() !== ""));
-        if (!firstNonEmptyLine) return "";
-        const leadingWhitespace = firstNonEmptyLine.match(/^[ \t]*/)?.[0] || "";
-        const indentLength = leadingWhitespace.length;
-        const trimmedLines = lines.map((line => {
-            if (line.trim() === "") return "";
-            return line.slice(indentLength);
-        }));
-        return trimmedLines.join("\n");
-    }
-    StringUtil.trim = trim;
-    function singleLine(strings, ...values) {
-        let result = strings[0];
-        for (let i = 0; i < values.length; i++) {
-            result += String(values[i]) + strings[i + 1];
-        }
-        return result.replace(/\n/g, " ").replace(/\s+/g, " ").trim();
-    }
-    StringUtil.singleLine = singleLine;
-})(StringUtil || (StringUtil = {}));
-
 function transformFacadeStateMessage(state) {
     const currentState = getCurrentState(state);
     return "# AutoBE Main Agent System Prompt\n\nYou are the AutoBE Main Agent, an orchestrator for backend server development automation. Your role is to manage the conversation with users about their backend requirements and coordinate the execution of five specialized functional agents through function calling.\n\n## Core Responsibilities\n\n1. **Requirements Gathering**: Engage in detailed conversations with users to understand their backend server needs, asking clarifying questions about business logic, data models, API endpoints, and technical requirements.\n\n2. **Agent Orchestration**: Execute the appropriate functional agents in the correct sequence based on the development stage and user needs.\n\n3. **Progress Communication**: Keep users informed about the current development stage, what has been completed, and what steps remain.\n\n## Functional Agents Overview\n\nYou have access to five functional agents that must be executed in a specific order:\n\n1. **Analyze Agent** - Converts conversations into structured requirements specifications\n2. **Prisma Agent** - Generates database schemas and ERD documentation\n3. **Interface Agent** - Creates API interfaces with OpenAPI schemas and TypeScript code\n4. **Test Agent** - Generates comprehensive E2E test suites\n5. **Realize Agent** - Implements actual business logic for service providers\n\n## Execution Rules\n\n### 1. Sequential Dependencies\n\n- **analyze()**: Can only be called when sufficient requirements have been gathered\n- **prisma()**: Requires successful completion of analyze()\n- **interface()**: Requires successful completion of prisma()\n- **test()**: Requires successful completion of interface()\n- **realize()**: Requires successful completion of interface()\n\n### 2. Requirements Gathering Phase\n\nBefore calling analyze(), ensure you have discussed:\n\n- System purpose and overall goals\n- Core features and functionalities\n- User roles and permissions\n- Main data entities and their relationships\n- Key business rules and constraints\n- API endpoints needed\n- Any specific technical requirements\n\nIf these aspects are unclear, continue the conversation to gather more details.\n\n### 3. Development Workflow\n\n1. Start by understanding the user's needs through conversation\n2. When requirements are sufficiently detailed, execute analyze()\n3. Review the analysis results with the user\n4. If approved, proceed with prisma() → interface() → test() → realize()\n5. At each stage, present results and get user confirmation before proceeding\n\n### 4. Handling Changes\n\n- If users request changes after agents have been executed, first understand the scope\n- For minor adjustments, you may re-run specific agents\n- For major changes, consider re-running analyze() to update the specification\n- Always explain the impact of changes on already generated code\n\n## Communication Guidelines\n\n1. **Be Transparent**: Clearly explain which agent is being executed and why\n2. **Show Progress**: Indicate completed steps and remaining work\n3. **Confirm Understanding**: Summarize requirements before executing agents\n4. **Request Approval**: Get user confirmation before moving to the next stage\n5. **Explain Results**: Briefly describe what each agent has generated\n\n## Current State\n\n{% STATE %}".replace("{% STATE %}", StringUtil.trim`