@autobe/agent 0.19.1 → 0.21.0

package/src/orchestrate/realize/histories/transformRealizeAuthorization.ts

@@ -1,7 +1,8 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBeAnalyzeRole } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
 import { ILlmSchema } from "@samchon/openapi";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 import { AutoBeContext } from "../../../context/AutoBeContext";
@@ -16,33 +17,35 @@ export const transformRealizeAuthorizationHistories = <
 > => {
   return [
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.REALIZE_AUTHORIZATION,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
-      text: [
-        "## Role",
-        "```json",
-        JSON.stringify(role),
-        "```",
-        "",
-        "## Prisma Schema",
-        "",
-        JSON.stringify(ctx.state().prisma?.schemas),
-        "",
-        "## Component Naming Convention",
-        "",
-        "Please follow this naming convention for the authorization components:",
-        "",
-        `- Provider Name: ${role.name}Authorize (e.g. ${role.name}Authorize)`,
-        `- Decorator Name: ${role.name.charAt(0).toUpperCase() + role.name.slice(1)}Auth (e.g. ${role.name.charAt(0).toUpperCase() + role.name.slice(1)}Auth)`,
-        `- Payload Name: ${role.name.charAt(0).toUpperCase() + role.name.slice(1)}Payload (e.g. ${role.name.charAt(0).toUpperCase() + role.name.slice(1)}Payload)`,
-      ].join("\n"),
+      text: StringUtil.trim`
+        ## Role
+        \`\`\`json
+        ${JSON.stringify(role)}
+        \`\`\`
+
+        ## Prisma Schema
+
+        \`\`\`json
+        ${JSON.stringify(ctx.state().prisma?.schemas)}
+        \`\`\`
+
+        ## Component Naming Convention
+
+        Please follow this naming convention for the authorization components:
+
+        - Provider Name: ${role.name}Authorize (e.g. ${role.name}Authorize)
+        - Decorator Name: ${role.name.charAt(0).toUpperCase() + role.name.slice(1)}Auth (e.g. ${role.name.charAt(0).toUpperCase() + role.name.slice(1)}Auth)
+        - Payload Name: ${role.name.charAt(0).toUpperCase() + role.name.slice(1)}Payload (e.g. ${role.name.charAt(0).toUpperCase() + role.name.slice(1)}Payload)
+      `,
     },
   ];
 };

package/src/orchestrate/realize/histories/transformRealizeAuthorizationCorrectHistories.ts

@@ -3,8 +3,9 @@ import {
   AutoBeRealizeAuthorization,
   IAutoBeTypeScriptCompileResult,
 } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
 import { ILlmSchema } from "@samchon/openapi";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 import { AutoBeContext } from "../../../context/AutoBeContext";
@@ -21,26 +22,26 @@ export const transformRealizeAuthorizationCorrectHistories = <
 > => {
   return [
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.REALIZE_AUTHORIZATION,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.REALIZE_AUTHORIZATION_CORRECT,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "assistantMessage",
-      text: [
-        "## Generated TypeScript Code",
-        "",
-        "```json",
-        `${JSON.stringify({
+      text: StringUtil.trim`
+        ## Generated TypeScript Code
+
+        \`\`\`json
+        ${JSON.stringify({
           provider: {
             location: auth.provider.location,
             name: auth.provider.name,
@@ -56,38 +57,39 @@ export const transformRealizeAuthorizationCorrectHistories = <
             name: auth.payload.name,
             content: auth.payload.content,
           },
-        } satisfies Omit<AutoBeRealizeAuthorization, "role">)}`,
-        "```",
-        "",
-        "## Prisma Schema",
-        "",
-        "```json",
-        `${JSON.stringify(ctx.state().prisma?.schemas)}`,
-        "```",
-        "",
-        "## File Paths",
-        "",
-        Object.keys(templateFiles)
+        } satisfies Omit<AutoBeRealizeAuthorization, "role">)}
+        \`\`\`
+
+        ## Prisma Schema
+
+        \`\`\`json
+        ${JSON.stringify(ctx.state().prisma?.schemas)}
+        \`\`\`
+
+        ## File Paths
+
+        ${Object.keys(templateFiles)
           .map((path) => `- ${path}`)
-          .join("\n"),
-        "",
-        "## Compile Errors",
-        "",
-        "Fix the compilation error in the provided code.",
-        "",
-        "```json",
-        JSON.stringify(diagnostics),
-        "```",
-        "## Component Naming Convention",
-        "",
-        "If the name of the component is not correct, please correct it.",
-        "",
-        "Please follow this naming convention for the authorization components:",
-        "",
-        `- Provider Name: ${auth.role.name.toLowerCase()}Authorize (e.g. ${auth.role.name.toLowerCase()}Authorize)`,
-        `- Decorator Name: ${auth.role.name.charAt(0).toUpperCase() + auth.role.name.slice(1).toLowerCase()}Auth (e.g. ${auth.role.name.charAt(0).toUpperCase() + auth.role.name.slice(1).toLowerCase()}Auth)`,
-        `- Payload Name: ${auth.role.name.charAt(0).toUpperCase() + auth.role.name.slice(1).toLowerCase()}Payload (e.g. ${auth.role.name.charAt(0).toUpperCase() + auth.role.name.slice(1).toLowerCase()}Payload)`,
-      ].join("\n"),
+          .join("\n")}
+
+        ## Compile Errors
+
+        Fix the compilation error in the provided code.
+
+        \`\`\`json
+        ${JSON.stringify(diagnostics)}
+        \`\`\`
+        
+        ## Component Naming Convention
+
+        If the name of the component is not correct, please correct it.
+
+        Please follow this naming convention for the authorization components:
+
+        - Provider Name: ${auth.role.name.toLowerCase()}Authorize (e.g. ${auth.role.name.toLowerCase()}Authorize)
+        - Decorator Name: ${auth.role.name.charAt(0).toUpperCase() + auth.role.name.slice(1).toLowerCase()}Auth (e.g. ${auth.role.name.charAt(0).toUpperCase() + auth.role.name.slice(1).toLowerCase()}Auth)
+        - Payload Name: ${auth.role.name.charAt(0).toUpperCase() + auth.role.name.slice(1).toLowerCase()}Payload (e.g. ${auth.role.name.charAt(0).toUpperCase() + auth.role.name.slice(1).toLowerCase()}Payload)
+      `,
     },
   ];
 };

package/src/orchestrate/realize/histories/transformRealizeCorrectHistories.ts

@@ -3,7 +3,8 @@ import {
   AutoBeRealizeAuthorization,
   IAutoBeTypeScriptCompileResult,
 } from "@autobe/interface";
-import { v4 } from "uuid";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 import { AutoBeState } from "../../../context/AutoBeState";
@@ -25,22 +26,25 @@ export function transformRealizeCorrectHistories(props: {
   return [
     ...transformRealizeWriteHistories(props),
     {
-      id: v4(),
+      id: v7(),
       type: "assistantMessage",
-      text: [
-        `Below is the code you made before. It's also something to review.`,
-        "```typescript",
-        props.code,
-        "```",
-        `The code has a compilation error:`,
-        "```json",
-        JSON.stringify(props.diagnostic),
-        "",
-      ].join("\n"),
+      text: StringUtil.trim`
+        Below is the code you made before. It's also something to review.
+
+        \`\`\`typescript
+        ${props.code}
+        \`\`\`
+
+        The code has a compilation error:
+        
+        \`\`\`json
+        ${JSON.stringify(props.diagnostic)}
+        \`\`\`
+      `,
       created_at: new Date().toISOString(),
     },
     {
-      id: v4(),
+      id: v7(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.REALIZE_CORRECT,
       created_at: new Date().toISOString(),

package/src/orchestrate/realize/histories/transformRealizeWriteAuthorizationsHistories.ts

@@ -1,7 +1,7 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBeOpenApi } from "@autobe/interface";
 import { StringUtil } from "@autobe/utils";
-import { v4 } from "uuid";
+import { v7 } from "uuid";
 
 export const transformRealizeWriteAuthorizationsHistories = (
   operation: AutoBeOpenApi.IOperation,
@@ -12,7 +12,7 @@ export const transformRealizeWriteAuthorizationsHistories = (
     operation.authorizationType === "login"
       ? [
           {
-            id: v4(),
+            id: v7(),
             created_at: new Date().toISOString(),
             type: "systemMessage" as const,
             text: StringUtil.trim`
@@ -50,7 +50,10 @@ export const transformRealizeWriteAuthorizationsHistories = (
               **NOTE**: The jsonwebtoken library is automatically imported as jwt. Use it to generate tokens with the EXACT payload structure:
 
               **CRITICAL**: Use the predefined payload structures for consistency:
+
+              \`\`\`json
               ${JSON.stringify(payloads)}
+              \`\`\`
 
               // JWT is already imported: import jwt from "jsonwebtoken";
               
@@ -105,7 +108,7 @@ export const transformRealizeWriteAuthorizationsHistories = (
     operation.authorizationType === "join"
       ? [
           {
-            id: v4(),
+            id: v7(),
             created_at: new Date().toISOString(),
             type: "systemMessage" as const,
             text: StringUtil.trim`
@@ -151,7 +154,10 @@ export const transformRealizeWriteAuthorizationsHistories = (
               **NOTE**: The jsonwebtoken library is automatically imported as jwt. After successful registration, generate tokens with the EXACT payload structure:
 
               **CRITICAL**: Use the predefined payload structures for consistency:
+
+              \`\`\`json
               ${JSON.stringify(payloads)}
+              \`\`\`
 
               // JWT is already imported: import jwt from "jsonwebtoken";
               
@@ -195,7 +201,7 @@ export const transformRealizeWriteAuthorizationsHistories = (
     operation.authorizationType === "refresh"
       ? [
           {
-            id: v4(),
+            id: v7(),
             created_at: new Date().toISOString(),
             type: "systemMessage" as const,
             text: StringUtil.trim`
@@ -223,7 +229,10 @@ export const transformRealizeWriteAuthorizationsHistories = (
               3. Generate a new access token with THE SAME payload structure as the original
 
               **CRITICAL**: Use the predefined payload structures for consistency:
+
+              \`\`\`json
               ${JSON.stringify(payloads)}
+              \`\`\`
 
               // JWT is already imported: import jwt from "jsonwebtoken";
               
@@ -282,4 +291,4 @@ export const transformRealizeWriteAuthorizationsHistories = (
       : [];
 
   return [...loginGuide, ...joinGuide, ...refreshGuide];
-};
+};

package/src/orchestrate/realize/histories/transformRealizeWriteHistories.ts

@@ -1,6 +1,7 @@
 import { IAgenticaHistoryJson } from "@agentica/core";
 import { AutoBeRealizeAuthorization } from "@autobe/interface";
-import { v4 } from "uuid";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
 
 import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
 import { AutoBeState } from "../../../context/AutoBeState";
@@ -47,13 +48,16 @@ export const transformRealizeWriteHistories = (
 
   const input =
     propsFields.length > 0
-      ? `props: {\n${propsFields.map((field) => `  ${field}`).join("\n")}\n}`
+      ? StringUtil.trim`
+        props: {
+        ${propsFields.map((field) => `  ${field},`).join("\n")}
+        }`
       : `// No props parameter needed - function should have no parameters`;
 
   if (props.state.analyze === null)
     return [
       {
-        id: v4(),
+        id: v7(),
         created_at: new Date().toISOString(),
         type: "systemMessage",
         text: [
@@ -66,7 +70,7 @@ export const transformRealizeWriteHistories = (
   else if (props.state.prisma === null)
     return [
       {
-        id: v4(),
+        id: v7(),
         created_at: new Date().toISOString(),
         type: "systemMessage",
         text: [
@@ -79,7 +83,7 @@ export const transformRealizeWriteHistories = (
   else if (props.state.analyze.step !== props.state.prisma.step)
     return [
       {
-        id: v4(),
+        id: v7(),
         created_at: new Date().toISOString(),
         type: "systemMessage",
         text: [
@@ -93,7 +97,7 @@ export const transformRealizeWriteHistories = (
   else if (props.state.prisma.compiled.type !== "success")
     return [
       {
-        id: v4(),
+        id: v7(),
         created_at: new Date().toISOString(),
         type: "systemMessage",
         text: [
@@ -107,7 +111,7 @@ export const transformRealizeWriteHistories = (
   else if (props.state.interface === null)
     return [
       {
-        id: v4(),
+        id: v7(),
         created_at: new Date().toISOString(),
         type: "systemMessage",
         text: [
@@ -125,14 +129,14 @@ export const transformRealizeWriteHistories = (
 
   return [
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.REALIZE_WRITE_TOTAL,
     },
     ...authorizationHistories,
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
       text: AutoBeSystemPromptConstant.REALIZE_WRITE_ARTIFACT.replaceAll(
@@ -144,33 +148,34 @@ export const transformRealizeWriteHistories = (
         .replaceAll(`{input}`, input),
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "systemMessage",
-      text: [
-        "Write new code based on the following operation.",
-        "```json",
-        JSON.stringify(props.scenario),
-        "```",
-      ].join("\n"),
+      text: StringUtil.trim`
+        Write new code based on the following operation.
+        
+        \`\`\`json
+        ${JSON.stringify(props.scenario)}
+        \`\`\`
+      `,
     },
     {
-      id: v4(),
+      id: v7(),
       created_at: new Date().toISOString(),
       type: "assistantMessage",
-      text: [
-        `I understand your request.`,
-        ``,
-        `To summarize:`,
-        `- I must **never use the native \`Date\` type** in any code or type definitions.`,
-        `- Instead, all date and datetime values must be handled as \`string & tags.Format<'date-time'>\`.`,
-        `- This rule is **strict** and applies everywhere, including domain types, API inputs/outputs, and Prisma models.`,
-        `- Even if a library or tool returns a \`Date\`, I must convert it to the correct string format before use.`,
-        ``,
-        `Especially regarding the \`Date\` type: I understand that using it can lead to type inconsistency and runtime issues, so I will completely avoid it in all circumstances.`,
-        ``,
-        `I'll make sure to follow all these rules strictly. Let’s proceed with this in mind.`,
-      ].join("\n"),
+      text: StringUtil.trim`
+        I understand your request.
+
+        To summarize:
+        - I must **never use the native \`Date\` type** in any code or type definitions.
+        - Instead, all date and datetime values must be handled as \`string & tags.Format<'date-time'>\`.
+        - This rule is **strict** and applies everywhere, including domain types, API inputs/outputs, and Prisma models.
+        - Even if a library or tool returns a \`Date\`, I must convert it to the correct string format before use.
+
+        Especially regarding the \`Date\` type: I understand that using it can lead to type inconsistency and runtime issues, so I will completely avoid it in all circumstances.
+
+        I'll make sure to follow all these rules strictly. Let's proceed with this in mind.
+      `,
     },
   ];
 };

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

@@ -2,13 +2,15 @@ import {
   AutoBeRealizeAuthorization,
   AutoBeRealizeFunction,
   AutoBeRealizeValidateEvent,
+  IAutoBeCompiler,
   IAutoBeTypeScriptCompileResult,
 } from "@autobe/interface";
 import { ILlmSchema } from "@samchon/openapi";
+import { v7 } from "uuid";
 
 import { AutoBeContext } from "../../../context/AutoBeContext";
 
-export async function compile<Model extends ILlmSchema.Model>(
+export async function compileRealizeFiles<Model extends ILlmSchema.Model>(
   ctx: AutoBeContext<Model>,
   props: {
     authorizations: AutoBeRealizeAuthorization[];
@@ -19,11 +21,14 @@ export async function compile<Model extends ILlmSchema.Model>(
   const payloads: Record<string, string> = Object.fromEntries(
     props.authorizations.map((el) => [el.payload.location, el.payload.content]),
   );
-  const compiler = await ctx.compiler();
-  const templateFiles = await compiler.realize.getTemplate();
-  const nodeModules = prisma?.type === "success" ? prisma.nodeModules : {};
+  const compiler: IAutoBeCompiler = await ctx.compiler();
+  const templateFiles: Record<string, string> =
+    await compiler.realize.getTemplate();
+  const nodeModules: Record<string, string> =
+    prisma?.type === "success" ? prisma.nodeModules : {};
 
-  const filterTsFiles = (location: string) => location.endsWith(".ts");
+  const filterTsFiles = (location: string) =>
+    location.startsWith("src/") && location.endsWith(".ts");
 
   const files: Record<string, string> = {
     ...nodeModules,
@@ -41,17 +46,17 @@ export async function compile<Model extends ILlmSchema.Model>(
     ),
   };
 
-  const compiled = await compiler.typescript.compile({
-    files: files,
-  });
-
+  const compiled: IAutoBeTypeScriptCompileResult =
+    await compiler.typescript.compile({
+      files: files,
+    });
   if (compiled.type === "success") {
     return compiled;
-  } else if (compiled.type === "failure") {
   }
 
   const event: AutoBeRealizeValidateEvent = {
     type: "realizeValidate",
+    id: v7(),
     result: compiled,
     files: Object.fromEntries(
       compiled.type === "failure"
@@ -62,6 +67,5 @@ export async function compile<Model extends ILlmSchema.Model>(
     created_at: new Date().toISOString(),
   };
   ctx.dispatch(event);
-
   return compiled;
 }