@autobe/agent 0.0.0 → 0.3.9

package/src/orchestrate/prisma/orchestratePrismaCompiler.ts

@@ -0,0 +1,194 @@
+import { IAgenticaController, MicroAgentica } from "@agentica/core";
+import { IAutoBePrismaCompilerResult } from "@autobe/interface";
+import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
+import { IPointer } from "tstl";
+import typia from "typia";
+
+import { AutoBeContext } from "../../context/AutoBeContext";
+import { assertSchemaModel } from "../../context/assertSchemaModel";
+import { transformPrismaCompilerHistories } from "./transformPrismaCompilerHistories";
+
+export async function orchestratePrismaCompiler<Model extends ILlmSchema.Model>(
+  ctx: AutoBeContext<Model>,
+  files: Record<string, string>,
+  retry: number = 10,
+): Promise<IAutoBePrismaCompilerResult & { description: string }> {
+  const pointer: IPointer<IModifyPrismaSchemaFilesProps> = {
+    value: { files, description: "" },
+  };
+  const agentica: MicroAgentica<Model> = new MicroAgentica({
+    model: ctx.model,
+    vendor: ctx.vendor,
+    config: {
+      ...(ctx.config ?? {}),
+    },
+    histories: transformPrismaCompilerHistories(ctx.state(), files),
+    tokenUsage: ctx.usage(),
+    controllers: [
+      createApplication({
+        model: ctx.model,
+        build: (next) => {
+          pointer.value = next;
+        },
+      }),
+    ],
+  });
+
+  agentica.on("request", (event) => {
+    if (event.body.tools) {
+      event.body.tool_choice = "required";
+    }
+  });
+
+  let result: IAutoBePrismaCompilerResult;
+
+  for (let i: number = 0; i < retry; ++i) {
+    result = await ctx.compiler.prisma({
+      files: pointer.value?.files ?? files,
+    });
+
+    if (result.type !== "failure") break;
+    ctx.dispatch({
+      type: "prismaValidate",
+      schemas: files,
+      result,
+      step: ctx.state().analyze?.step ?? 0,
+      created_at: new Date().toISOString(),
+    });
+
+    await agentica.conversate(
+      [
+        "The Prisma schema files have compilation errors that must be fixed. You MUST provide complete, corrected files.",
+        "",
+        "============================================== CURRENT FILES ==============================================",
+        "",
+        ...Object.entries(pointer.value?.files ?? files).flatMap(
+          ([filename, content]) => [`### ${filename} ###`, content, ""],
+        ),
+        "",
+        "============================================== COMPILATION ERRORS ==============================================",
+        "",
+        result.reason,
+        "",
+        "============================================== REQUIREMENTS ==============================================",
+        "",
+        "CRITICAL: You must call the modifyPrismaSchemaFiles function with:",
+        "",
+        "1. **COMPLETE file contents** - Do NOT truncate or abbreviate any content",
+        "2. **ALL files** - Every file from the input must be included in the output",
+        "3. **Fixed errors** - Resolve all compilation errors shown above",
+        "4. **Preserved structure** - Keep all models, fields, relationships, and comments",
+        "5. **Proper syntax** - Ensure valid Prisma schema syntax",
+        "",
+        "IMPORTANT NOTES:",
+        "- Include the ENTIRE content of each file, not summaries or truncated versions",
+        "- Maintain all existing relationships between models",
+        "- Keep all field definitions, attributes, and indexes",
+        "- Preserve all comments and documentation",
+        "- Fix ONLY the compilation errors, don't make unnecessary changes",
+        "",
+        "Example of what NOT to do:",
+        "```",
+        "// ... (truncated for brevity)",
+        "// ... other fields and relationships",
+        "// ... unchanged ...",
+        "```",
+        "",
+        "You must provide the COMPLETE file content for each file.",
+      ].join("\n"),
+    );
+
+    if (i === retry - 1) {
+      throw new Error("Prisma schema compiler failed");
+    }
+  }
+
+  return { ...result!, description: pointer.value.description };
+}
+
+function createApplication<Model extends ILlmSchema.Model>(props: {
+  model: Model;
+  build: (next: IModifyPrismaSchemaFilesProps) => void;
+}): IAgenticaController.IClass<Model> {
+  assertSchemaModel(props.model);
+  const application: ILlmApplication<Model> = collection[
+    props.model
+  ] as unknown as ILlmApplication<Model>;
+  return {
+    protocol: "class",
+    name: "Prisma Compiler",
+    application,
+    execute: {
+      modifyPrismaSchemaFiles: (next) => {
+        props.build(next);
+      },
+    } satisfies IApplication,
+  };
+}
+
+const claude = typia.llm.application<
+  IApplication,
+  "claude",
+  { reference: true }
+>();
+const collection = {
+  chatgpt: typia.llm.application<
+    IApplication,
+    "chatgpt",
+    { reference: true }
+  >(),
+  claude,
+  llama: claude,
+  deepseek: claude,
+  "3.1": claude,
+  "3.0": typia.llm.application<IApplication, "3.0">(),
+};
+
+interface IApplication {
+  /**
+   * Fixes compilation errors in Prisma schema files.
+   *
+   * CRITICAL: This function must return COMPLETE file contents, not truncated
+   * versions.
+   *
+   * Responsibilities:
+   *
+   * 1. Analyze compilation errors in the provided schema files
+   * 2. Fix all syntax and structural issues
+   * 3. Return COMPLETE corrected files (no truncation or abbreviation)
+   * 4. Preserve all existing models, relationships, and business logic
+   * 5. Maintain proper cross-file references and dependencies
+   *
+   * @param props Contains files to fix and requires complete file contents in
+   *   response
+   */
+  modifyPrismaSchemaFiles(props: IModifyPrismaSchemaFilesProps): void;
+}
+
+interface IModifyPrismaSchemaFilesProps {
+  /**
+   * COMPLETE Prisma schema files with ALL content included.
+   *
+   * CRITICAL REQUIREMENTS:
+   *
+   * - Each file must contain the ENTIRE schema content
+   * - Do NOT truncate, abbreviate, or use placeholders like "... unchanged ..."
+   * - Include ALL models, fields, relationships, indexes, and comments
+   * - Maintain exact same file organization and naming
+   *
+   * File organization patterns:
+   *
+   * - Main.prisma: Configuration, datasource, generators
+   * - Schema-XX-domain.prisma: Complete domain-specific models with ALL fields
+   *
+   * Key = filename (e.g., "main.prisma", "schema-01-core.prisma") Value =
+   * COMPLETE file content (no truncation allowed)
+   */
+  files: Record<string, string>;
+
+  /**
+   * Brief description of what was fixed or modified in the schema files. Should
+   * summarize the changes made to resolve compilation errors.
+   */
+  description: string;
+}

package/src/orchestrate/prisma/orchestratePrismaComponent.ts

@@ -0,0 +1,176 @@
+import {
+  AgenticaAssistantMessageHistory,
+  IAgenticaController,
+  MicroAgentica,
+  MicroAgenticaHistory,
+} from "@agentica/core";
+import { AutoBeAssistantMessageHistory } from "@autobe/interface";
+import { AutoBePrismaComponentsEvent } from "@autobe/interface/src/events/AutoBePrismaComponentsEvent";
+import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
+import { IPointer } from "tstl";
+import typia from "typia";
+import { v4 } from "uuid";
+
+import { AutoBeContext } from "../../context/AutoBeContext";
+import { assertSchemaModel } from "../../context/assertSchemaModel";
+import { transformPrismaComponentsHistories } from "./transformPrismaComponentsHistories";
+
+export async function orchestratePrismaComponents<
+  Model extends ILlmSchema.Model,
+>(
+  ctx: AutoBeContext<Model>,
+  content: string = "Please extract files and tables from the given documents.",
+): Promise<AutoBeAssistantMessageHistory | AutoBePrismaComponentsEvent> {
+  const start: Date = new Date();
+  const pointer: IPointer<IExtractComponentsProps | null> = {
+    value: null,
+  };
+  const agentica: MicroAgentica<Model> = new MicroAgentica({
+    model: ctx.model,
+    vendor: ctx.vendor,
+    config: {
+      ...(ctx.config ?? {}),
+    },
+    histories: transformPrismaComponentsHistories(ctx.state()),
+    tokenUsage: ctx.usage(),
+    controllers: [
+      createApplication({
+        model: ctx.model,
+        build: (next) => {
+          pointer.value = next;
+        },
+      }),
+    ],
+  });
+
+  const histories: MicroAgenticaHistory<Model>[] =
+    await agentica.conversate(content);
+  if (histories.at(-1)?.type === "assistantMessage")
+    return {
+      ...(histories.at(-1)! as AgenticaAssistantMessageHistory),
+      created_at: start.toISOString(),
+      completed_at: new Date().toISOString(),
+      id: v4(),
+    } satisfies AutoBeAssistantMessageHistory;
+  else if (pointer.value === null) {
+    throw new Error("Failed to extract files and tables."); // unreachable
+  }
+  return {
+    type: "prismaComponents",
+    created_at: start.toISOString(),
+    components: pointer.value.components,
+    step: ctx.state().analyze?.step ?? 0,
+  };
+}
+
+function createApplication<Model extends ILlmSchema.Model>(props: {
+  model: Model;
+  build: (next: IExtractComponentsProps) => void;
+}): IAgenticaController.IClass<Model> {
+  assertSchemaModel(props.model);
+
+  const application: ILlmApplication<Model> = collection[
+    props.model
+  ] as unknown as ILlmApplication<Model>;
+  return {
+    protocol: "class",
+    name: "Prisma Extract Files and Tables",
+    application,
+    execute: {
+      extractComponents: (next) => {
+        props.build(next);
+      },
+    } satisfies IApplication,
+  };
+}
+
+const claude = typia.llm.application<
+  IApplication,
+  "claude",
+  { reference: true }
+>();
+const collection = {
+  chatgpt: typia.llm.application<
+    IApplication,
+    "chatgpt",
+    { reference: true }
+  >(),
+  claude,
+  llama: claude,
+  deepseek: claude,
+  "3.1": claude,
+  "3.0": typia.llm.application<IApplication, "3.0">(),
+};
+
+interface IApplication {
+  /**
+   * Extracts and organizes database schema files with their corresponding table
+   * definitions.
+   *
+   * Processes Prisma schema files and maps each file to its contained database
+   * tables, enabling structured organization of schemas across multiple files
+   * for large projects.
+   *
+   * @example
+   *   ```typescript
+   *   application.extractFilesAndTables({
+   *     components: [
+   *       {
+   *         filename: "schema-01-users.prisma",
+   *         tables: ["user", "user_profile"]
+   *       },
+   *       {
+   *         filename: "schema-02-articles.prisma",
+   *         tables: ["article", "attachment_file"]
+   *       }
+   *     ]
+   *   });
+   *   ```;
+   *
+   * @param props - Configuration object containing the file-to-table mapping
+   *   structure
+   */
+  extractComponents(props: IExtractComponentsProps): void;
+}
+
+interface IExtractComponentsProps {
+  /**
+   * Maps Prisma schema filenames to their contained database tables.
+   *
+   * **Structure:**
+   *
+   * - Key: Prisma schema filename with .prisma extension
+   * - Value: Array of table names defined in that file
+   *
+   * **Example:**
+   *
+   * ```typescript
+   * {
+   *   {
+   *     filename: "schema-01-users.prisma",
+   *     tables: ["user", "user_profile", "user_settings"]
+   *   },
+   *   {
+   *     filename: "schema-02-articles.prisma",
+   *     tables: ["article", "article_snapshot"]
+   *   },
+   *   {
+   *     filename: "schema-03-comments.prisma",
+   *     tables: ["comment", "comment_like"]
+   *   }
+   * }
+   * ```
+   *
+   * **Notes:**
+   *
+   * - Table names must match exact Prisma model names (case-sensitive)
+   * - Keep mapping synchronized with actual schema files
+   * - Use consistent naming convention for files
+   */
+  components: IComponent[];
+}
+
+interface IComponent {
+  filename: string;
+  tables: string[];
+}

package/src/orchestrate/prisma/orchestratePrismaSchema.ts

@@ -0,0 +1,181 @@
+import { IAgenticaController, MicroAgentica } from "@agentica/core";
+import { AutoBePrismaSchemasEvent } from "@autobe/interface/src/events/AutoBePrismaSchemasEvent";
+import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
+import { IPointer } from "tstl";
+import typia from "typia";
+
+import { AutoBeContext } from "../../context/AutoBeContext";
+import { assertSchemaModel } from "../../context/assertSchemaModel";
+import { transformPrismaSchemaHistories } from "./transformPrismaSchemaHistories";
+
+export async function orchestratePrismaSchemas<Model extends ILlmSchema.Model>(
+  ctx: AutoBeContext<Model>,
+  components: { filename: string; tables: string[] }[],
+): Promise<AutoBePrismaSchemasEvent[]> {
+  const start: Date = new Date();
+  const entireTables: string[] = Array.from(
+    new Set(components.flatMap((c) => c.tables)),
+  );
+
+  const total: number = components.reduce((acc, c) => acc + c.tables.length, 0);
+  let i: number = 0;
+
+  return await Promise.all(
+    components.map(async (c) => {
+      const result: IMakePrismaSchemaFilesProps = await process(ctx, {
+        filename: c.filename,
+        tables: c.tables,
+        entireTables,
+      });
+      const event: AutoBePrismaSchemasEvent = {
+        type: "prismaSchemas",
+        created_at: start.toISOString(),
+        filename: c.filename,
+        content: result.content,
+        completed: (i += c.tables.length),
+        total,
+        step: ctx.state().analyze?.step ?? 0,
+      };
+      ctx.dispatch(event);
+      return event;
+    }),
+  );
+}
+
+async function process<Model extends ILlmSchema.Model>(
+  ctx: AutoBeContext<Model>,
+  component: { filename: string; tables: string[] } & {
+    entireTables: string[];
+  },
+): Promise<IMakePrismaSchemaFilesProps> {
+  const pointer: IPointer<IMakePrismaSchemaFilesProps | null> = {
+    value: null,
+  };
+  const agentica: MicroAgentica<Model> = new MicroAgentica({
+    model: ctx.model,
+    vendor: ctx.vendor,
+    config: {
+      ...(ctx.config ?? {}),
+    },
+    histories: transformPrismaSchemaHistories(ctx.state()),
+    tokenUsage: ctx.usage(),
+    controllers: [
+      createApplication({
+        model: ctx.model,
+        build: (next) => {
+          pointer.value = next;
+        },
+      }),
+    ],
+  });
+  agentica.on("request", async (event) => {
+    if (event.body.tools) {
+      event.body.tool_choice = "required";
+    }
+  });
+
+  await agentica.conversate(
+    [
+      "Please generate Prisma schema files based on the previous requirement analysis report.",
+      "",
+      "**Context:**",
+      `- Target filename: \`${component.filename}\``,
+      `- Tables to implement in this file: \`${component.tables.join("`, `")}\``,
+      `- All available tables in the system: \`${component.entireTables.join("`, `")}\``,
+      "",
+      "**Instructions:**",
+      "1. Create comprehensive Prisma schema content for the specified tables",
+      "2. Reference the previous requirement analysis to understand business logic and data structures",
+      "3. Establish appropriate relationships between tables using the entireTables list as reference",
+      "4. Include proper field types, constraints, indexes, and documentation",
+      "5. Follow enterprise-level schema design patterns and best practices",
+      "6. Ensure cross-table relationships are accurately modeled based on business requirements",
+      "",
+      "**Key Requirements:**",
+      "- Implement only the tables specified for this file",
+      "- Create foreign key relationships to tables from entireTables when business logic requires it",
+      "- Add comprehensive field documentation and model descriptions",
+      "- Include appropriate indexes for performance optimization",
+      "- Follow consistent naming conventions and data types",
+    ].join("\n"),
+  );
+
+  if (pointer.value === null)
+    throw new Error("Unreachable code: Prisma Schema not generated");
+
+  return pointer.value;
+}
+
+function createApplication<Model extends ILlmSchema.Model>(props: {
+  model: Model;
+  build: (next: IMakePrismaSchemaFilesProps) => void;
+}): IAgenticaController.IClass<Model> {
+  assertSchemaModel(props.model);
+  const application: ILlmApplication<Model> = collection[
+    props.model
+  ] as unknown as ILlmApplication<Model>;
+  return {
+    protocol: "class",
+    name: "Prisma Generator",
+    application,
+    execute: {
+      makePrismaSchemaFiles: (next) => {
+        props.build(next);
+      },
+    } satisfies IApplication,
+  };
+}
+
+const claude = typia.llm.application<
+  IApplication,
+  "claude",
+  { reference: true }
+>();
+const collection = {
+  chatgpt: typia.llm.application<
+    IApplication,
+    "chatgpt",
+    { reference: true }
+  >(),
+  claude,
+  llama: claude,
+  deepseek: claude,
+  "3.1": claude,
+  "3.0": typia.llm.application<IApplication, "3.0">(),
+};
+
+interface IApplication {
+  /**
+   * Generates comprehensive Prisma schema files based on detailed requirements
+   * analysis.
+   *
+   * Creates multiple organized schema files following enterprise patterns
+   * including proper domain separation, relationship modeling, snapshot
+   * patterns, inheritance, materialized views, and comprehensive documentation.
+   * The generated schemas implement best practices for scalability,
+   * maintainability, and data integrity.
+   *
+   * @param props Properties containing the complete set of Prisma schema files
+   */
+  makePrismaSchemaFiles(props: IMakePrismaSchemaFilesProps): void;
+}
+
+interface IMakePrismaSchemaFilesProps {
+  /**
+   * Complete Prisma schema content as a single concatenated string.
+   *
+   * Contains all schema files organized by domain/functionality with clear file
+   * separators. Each file section includes models, relationships, indexes, and
+   * comprehensive documentation following enterprise patterns.
+   *
+   * Content should be organized following enterprise patterns:
+   *
+   * - Main.prisma: Configuration, datasource, and generators
+   * - Schema-XX-domain.prisma: Domain-specific entity definitions
+   * - Proper cross-file relationships and dependencies
+   */
+  content: string;
+
+  /** Summary description of the application requirements and business context. */
+  description: string;
+}

package/src/orchestrate/prisma/transformPrismaCompilerHistories.ts

@@ -0,0 +1,49 @@
+import { IAgenticaHistoryJson } from "@agentica/core";
+
+import { AutoBeSystemPromptConstant } from "../../constants/AutoBeSystemPromptConstant";
+import { AutoBeState } from "../../context/AutoBeState";
+
+export const transformPrismaCompilerHistories = (
+  state: AutoBeState,
+  files: Record<string, string>,
+): Array<
+  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
+> => {
+  if (state.analyze === null)
+    return [
+      {
+        type: "systemMessage",
+        text: [
+          "Requirement analysis is not yet completed.",
+          "Don't call any tool function,",
+          "but say to process the requirement analysis.",
+        ].join(" "),
+      },
+    ];
+  return [
+    {
+      type: "systemMessage",
+      text: AutoBeSystemPromptConstant.PRISMA_COMPILER,
+    },
+    {
+      type: "assistantMessage",
+      text: [
+        "Below are the current schema files that failed compilation:",
+        "",
+        "============================================== CURRENT SCHEMA FILES ==============================================",
+        "",
+        Object.entries(files)
+          .map(([filename, content]) => {
+            return [
+              `// =============================================================================`,
+              `// FILE: ${filename}`,
+              `// =============================================================================`,
+              content,
+            ].join("\n");
+          })
+          .join("\n\n"),
+        "",
+      ].join("\n"),
+    },
+  ];
+};

package/src/orchestrate/prisma/transformPrismaComponentsHistories.ts

@@ -0,0 +1,46 @@
+import { IAgenticaHistoryJson } from "@agentica/core";
+
+import { AutoBeSystemPromptConstant } from "../../constants/AutoBeSystemPromptConstant";
+import { AutoBeState } from "../../context/AutoBeState";
+
+export const transformPrismaComponentsHistories = (
+  state: AutoBeState,
+): Array<
+  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
+> => {
+  if (state.analyze === null)
+    return [
+      {
+        type: "systemMessage",
+        text: [
+          "Requirement analysis is not yet completed.",
+          "Don't call any tool function,",
+          "but say to process the requirement analysis.",
+        ].join(" "),
+      },
+    ];
+  return [
+    {
+      type: "systemMessage",
+      text: AutoBeSystemPromptConstant.PRISMA_COMPONENT,
+    },
+    {
+      type: "assistantMessage",
+      text: [
+        "Here is the requirement analysis report.",
+        "",
+        "Call the provided tool function to generate Prisma DB schema",
+        "referencing below requirement analysis report.",
+        "",
+        "## User Request",
+        state.analyze.reason,
+        "",
+        `## Requirement Analysis Report`,
+        "",
+        "```json",
+        JSON.stringify(state.analyze.files),
+        "```",
+      ].join("\n"),
+    },
+  ];
+};

package/src/orchestrate/prisma/transformPrismaHistories.ts

@@ -0,0 +1,50 @@
+import { IAgenticaHistoryJson } from "@agentica/core";
+
+import { AutoBeSystemPromptConstant } from "../../constants/AutoBeSystemPromptConstant";
+import { AutoBeState } from "../../context/AutoBeState";
+
+export const transformPrismaHistories = (
+  state: AutoBeState,
+): Array<
+  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
+> => {
+  if (state.analyze === null)
+    return [
+      {
+        type: "systemMessage",
+        text: [
+          "Requirement analysis is not yet completed.",
+          "Don't call any tool function,",
+          "but say to process the requirement analysis.",
+        ].join(" "),
+      },
+    ];
+  return [
+    {
+      type: "systemMessage",
+      text: AutoBeSystemPromptConstant.PRISMA,
+    },
+    {
+      type: "assistantMessage",
+      text: AutoBeSystemPromptConstant.PRISMA_EXAMPLE,
+    },
+    {
+      type: "assistantMessage",
+      text: [
+        "Here is the requirement analysis report.",
+        "",
+        "Call the provided tool function to generate Prisma DB schema",
+        "referencing below requirement analysis report.",
+        "",
+        "## User Request",
+        state.analyze.reason,
+        "",
+        `## Requirement Analysis Report`,
+        "",
+        "```json",
+        JSON.stringify(state.analyze.files),
+        "```",
+      ].join("\n"),
+    },
+  ];
+};