@autobe/agent 0.28.1 → 0.29.1

package/src/orchestrate/interface/orchestrateInterfaceOperationsReview.ts

@@ -1,157 +0,0 @@
-import { IAgenticaController } from "@agentica/core";
-import {
-  AutoBeInterfaceOperationReviewEvent,
-  AutoBeOpenApi,
-  AutoBePrisma,
-  AutoBeProgressEventBase,
-} from "@autobe/interface";
-import { ILlmApplication, ILlmSchema, IValidation } from "@samchon/openapi";
-import { IPointer } from "tstl";
-import typia from "typia";
-import { v7 } from "uuid";
-
-import { AutoBeContext } from "../../context/AutoBeContext";
-import { transformInterfaceOperationsReviewHistories } from "./histories/transformInterfaceOperationsReviewHistories";
-import { IAutoBeInterfaceOperationsReviewApplication } from "./structures/IAutoBeInterfaceOperationsReviewApplication";
-import { OperationValidator } from "./utils/OperationValidator";
-
-export async function orchestrateInterfaceOperationsReview<
-  Model extends ILlmSchema.Model,
->(
-  ctx: AutoBeContext<Model>,
-  operations: AutoBeOpenApi.IOperation[],
-  progress: AutoBeProgressEventBase,
-): Promise<AutoBeOpenApi.IOperation[]> {
-  try {
-    const files: AutoBePrisma.IFile[] = ctx.state().prisma?.result.data.files!;
-    const pointer: IPointer<IAutoBeInterfaceOperationsReviewApplication.IProps | null> =
-      {
-        value: null,
-      };
-    const { metric, tokenUsage } = await ctx.conversate({
-      source: "interfaceOperationReview",
-      histories: transformInterfaceOperationsReviewHistories(ctx, operations),
-      controller: createReviewController({
-        model: ctx.model,
-        prismaSchemas: files,
-        build: (next: IAutoBeInterfaceOperationsReviewApplication.IProps) => {
-          pointer.value = next;
-        },
-      }),
-      enforceFunctionCall: false,
-      message: "Review the operations",
-    });
-    if (pointer.value === null) {
-      ++progress.completed;
-      return [];
-    }
-
-    const content: AutoBeOpenApi.IOperation[] = pointer.value.content.map(
-      (op) => ({
-        ...op,
-        authorizationType: null,
-      }),
-    );
-
-    ctx.dispatch({
-      type: "interfaceOperationReview",
-      id: v7(),
-      operations: content,
-      review: pointer.value.think.review,
-      plan: pointer.value.think.plan,
-      content,
-      metric,
-      tokenUsage,
-      created_at: new Date().toISOString(),
-      step: ctx.state().analyze?.step ?? 0,
-      total: progress.total,
-      completed: ++progress.completed,
-    } satisfies AutoBeInterfaceOperationReviewEvent);
-    return content;
-  } catch {
-    ++progress.completed;
-    return [];
-  }
-}
-
-function createReviewController<Model extends ILlmSchema.Model>(props: {
-  model: Model;
-  prismaSchemas: AutoBePrisma.IFile[];
-  build: (reviews: IAutoBeInterfaceOperationsReviewApplication.IProps) => void;
-}): IAgenticaController.IClass<Model> {
-  const validate = (
-    next: unknown,
-  ): IValidation<IAutoBeInterfaceOperationsReviewApplication.IProps> => {
-    const result: IValidation<IAutoBeInterfaceOperationsReviewApplication.IProps> =
-      typia.validate<IAutoBeInterfaceOperationsReviewApplication.IProps>(next);
-    if (result.success === false) return result;
-
-    const errors: IValidation.IError[] = [];
-    OperationValidator.validate({
-      path: "$input.content",
-      operations: result.data.content,
-      errors,
-    });
-    if (errors.length !== 0)
-      return {
-        success: false,
-        errors,
-        data: next,
-      };
-    return result;
-  };
-  const application: ILlmApplication<Model> = collection[
-    props.model === "chatgpt"
-      ? "chatgpt"
-      : props.model === "gemini"
-        ? "gemini"
-        : "claude"
-  ](
-    validate,
-  ) satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
-
-  return {
-    protocol: "class",
-    name: "review",
-    application,
-    execute: {
-      reviewOperations: (next) => {
-        props.build(next);
-      },
-    } satisfies IAutoBeInterfaceOperationsReviewApplication,
-  };
-}
-
-const collection = {
-  chatgpt: (validate: Validator) =>
-    typia.llm.application<
-      IAutoBeInterfaceOperationsReviewApplication,
-      "chatgpt"
-    >({
-      validate: {
-        reviewOperations: validate,
-      },
-    }),
-  claude: (validate: Validator) =>
-    typia.llm.application<
-      IAutoBeInterfaceOperationsReviewApplication,
-      "claude"
-    >({
-      validate: {
-        reviewOperations: validate,
-      },
-    }),
-  gemini: (validate: Validator) =>
-    typia.llm.application<
-      IAutoBeInterfaceOperationsReviewApplication,
-      "gemini"
-    >({
-      validate: {
-        reviewOperations: validate,
-      },
-    }),
-};
-
-type Validator = (
-  input: unknown,
-) => IValidation<IAutoBeInterfaceOperationsReviewApplication.IProps>;

package/src/orchestrate/interface/structures/IAutoBeInterfaceEndpointsReviewApplication.ts

@@ -1,65 +0,0 @@
-import { AutoBeOpenApi } from "@autobe/interface";
-
-/**
- * Interface for reviewing and refining API endpoints through holistic analysis.
- * 
- * This application performs comprehensive review of all endpoints generated
- * through divide-and-conquer strategy, ensuring consistency, eliminating
- * redundancy, and preventing over-engineering across the entire API surface.
- */
-export interface IAutoBeInterfaceEndpointsReviewApplication {
-  /**
-   * Reviews and refines the complete collection of API endpoints.
-   * 
-   * This method consolidates all endpoints generated independently by different
-   * groups and performs holistic review to:
-   * - Ensure naming consistency across all endpoints
-   * - Remove duplicate or overlapping endpoints
-   * - Eliminate over-engineered solutions
-   * - Standardize path structures and HTTP methods
-   * - Verify REST API design principles
-   * 
-   * The review process examines the entire API as a cohesive system rather
-   * than individual endpoints, ensuring the final API is intuitive, maintainable,
-   * and follows best practices.
-   * 
-   * @param next - The review results and refined endpoint collection
-   */
-  reviewEndpoints(
-    next: IAutoBeInterfaceEndpointsReviewApplication.IProps,
-  ): void;
-}
-
-export namespace IAutoBeInterfaceEndpointsReviewApplication {
-  export interface IProps {
-    /**
-     * Comprehensive review analysis of all collected endpoints.
-     * 
-     * Contains detailed findings from the holistic review including:
-     * - Identified inconsistencies in naming conventions
-     * - Duplicate endpoints that serve the same purpose
-     * - Over-engineered solutions that add unnecessary complexity
-     * - Violations of REST API design principles
-     * - Recommendations for improvement and standardization
-     * 
-     * The review provides actionable feedback for creating a clean,
-     * consistent, and maintainable API structure.
-     */
-    review: string;
-
-    /**
-     * Refined collection of API endpoints after review and cleanup.
-     * 
-     * The final optimized set of endpoints after:
-     * - Removing duplicates and redundant endpoints
-     * - Standardizing naming conventions across all paths
-     * - Simplifying over-engineered solutions
-     * - Ensuring consistent REST patterns
-     * - Aligning HTTP methods with their semantic meanings
-     * 
-     * This collection represents the production-ready API structure
-     * that balances functionality with simplicity and maintainability.
-     */
-    endpoints: AutoBeOpenApi.IEndpoint[];
-  }
-}

package/src/orchestrate/interface/structures/IAutoBeInterfacePrerequisitesApplication.ts

@@ -1,58 +0,0 @@
-import { AutoBeOpenApi } from "@autobe/interface";
-
-/**
- * Interface Prerequisite Agent application for analyzing and generating API
- * operation dependencies.
- *
- * Analyzes Target Operations to determine which Available API Operations must
- * be executed as prerequisites based on resource creation dependencies and
- * existence validations.
- */
-export interface IAutoBeInterfacePrerequisitesApplication {
-  /**
-   * Generate prerequisites for the provided operations.
-   *
-   * Analyzes each operation's dependencies and returns the complete list with
-   * their required prerequisite chains based on resource relationships.
-   */
-  makePrerequisite(
-    props: IAutoBeInterfacePrerequisitesApplication.IProps,
-  ): void;
-}
-
-export namespace IAutoBeInterfacePrerequisitesApplication {
-  export interface IProps {
-    /**
-     * Target operations requiring prerequisite analysis.
-     *
-     * Each operation will be analyzed for dependency requirements and returned
-     * with appropriate prerequisites from Available API Operations.
-     */
-    operations: IOperation[];
-  }
-
-  /**
-   * Operation with its analyzed prerequisite dependencies.
-   *
-   * Represents a single API operation and its complete prerequisite chain
-   * needed for successful execution.
-   */
-  export interface IOperation {
-    /**
-     * The API endpoint being analyzed.
-     *
-     * Identifies the specific operation (method + path) that needs
-     * prerequisites.
-     */
-    endpoint: AutoBeOpenApi.IEndpoint;
-
-    /**
-     * Required prerequisite operations.
-     *
-     * List of API operations that must be successfully executed before this
-     * operation can be performed. Based on resource creation dependencies and
-     * existence validations from the analysis.
-     */
-    prerequisites: AutoBeOpenApi.IPrerequisite[];
-  }
-}

package/src/orchestrate/prisma/histories/transformPrismaComponentsHistories.ts

@@ -1,104 +0,0 @@
-import { IAgenticaHistoryJson } from "@agentica/core";
-import { StringUtil } from "@autobe/utils";
-import { NamingConvention } from "typia/lib/utils/NamingConvention";
-import { v7 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
-import { AutoBeState } from "../../../context/AutoBeState";
-
-export const transformPrismaComponentsHistories = (
-  state: AutoBeState,
-  props: {
-    prefix: string | null;
-    instruction: string;
-  },
-): Array<
-  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
-> => {
-  if (state.analyze === null)
-    // unreachable
-    throw new Error("Analyze state is not set.");
-  if (props.prefix) props.prefix = NamingConvention.snake(props.prefix);
-  return [
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.PRISMA_COMPONENT,
-    },
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "assistantMessage",
-      text: StringUtil.trim`
-        ## Requirement Analysis Report
-
-        Here is the requirement analysis report.
-        
-        Call the provided tool function to generate Prisma DB schema
-        referencing below requirement analysis report.
-        
-        \`\`\`json
-        ${JSON.stringify(state.analyze.files)}
-        \`\`\`
-        
-        ## Prefix
-        
-        - Prefix provided by the user: ${props.prefix}
-        
-        The user wants all database schema (table) names to start with the prefix provided below.
-        
-        - DO: Use the provided prefix for all table names
-        - DO: Place special-purpose prefixes like \`mv\` (for materialized views) before the given prefix
-        - DO NOT: Apply prefix if it is \`null\`
-        
-        ## Prefix Example
-        
-        If the prefix is \`shopping\`, then table names are like:
-        
-        - \`shopping_sales\`
-        - \`shopping_sale_options\`
-        
-        In cases where a table is created for performance optimization purposes 
-        (e.g., materialized views), the \`mv_\` prefix must come first. For example:
-        
-        - \`mv_shopping_daily_stats\`
-        
-        ${
-          state.analyze.actors.length > 0
-            ? StringUtil.trim`
-                ## User Actor Handling
-
-                The Requirement Analysis Report contains the following user actors: ${state.analyze.actors.join(", ")}
-
-                **Do not normalize** user actors into a single table.
-                Instead, create separate tables for each distinct actor mentioned in the requirements.
-
-                Create separate tables for each actor:
-
-                ${state.analyze.actors
-                  .map((actor) => `- ${props.prefix}_${actor.name.toLowerCase()}`)
-                  .join("\n")}
-              `
-            : ""
-        }
-
-        ## Database Design Instructions
-
-        The following database-specific instructions were extracted from
-        the user's requirements. These focus on database schema design aspects
-        such as table structure, relationships, constraints, and indexing strategies.
-
-        Follow these instructions when designing namespace components and DB table names. 
-        Carefully distinguish between:
-        - Suggestions or recommendations (consider these as guidance)
-        - Direct specifications or explicit commands (these must be followed exactly)
-        
-        When instructions contain direct specifications or explicit design decisions, 
-        follow them precisely even if you believe you have better alternatives.
-
-        ${props.instruction}
-      `,
-    },
-  ];
-};

package/src/orchestrate/prisma/histories/transformPrismaReviewHistories.ts

@@ -1,69 +0,0 @@
-import { IAgenticaHistoryJson } from "@agentica/core";
-import { AutoBePrisma } from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-import { v7 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
-
-export const transformPrismaReviewHistories = (props: {
-  analysis: Record<string, string>;
-  application: AutoBePrisma.IApplication;
-  schemas: Record<string, string>;
-  component: AutoBePrisma.IComponent;
-}): Array<
-  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
-> => {
-  return [
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.PRISMA_SCHEMA,
-    },
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.PRISMA_REVIEW,
-    },
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "assistantMessage",
-      text: StringUtil.trim`
-        Here is the requirement analysis report given by the user:
-        
-        \`\`\`json
-        ${JSON.stringify(props.analysis)}
-        \`\`\`
-        
-        Reading the requirement analysis report, you AI made 
-        below AST definition for the database design:
-        
-        \`\`\`json
-        ${JSON.stringify(props.application)}
-        \`\`\`
-        
-        And here are the Prisma schema files generated (compiled) 
-        from the above AST:
-        
-        \`\`\`json
-        ${JSON.stringify(props.schemas)}
-        \`\`\`
-      `,
-    },
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "assistantMessage",
-      text: StringUtil.trim`
-        Now, please review the tables in the "${props.component.namespace}" namespace.
-        
-        Focus your review exclusively on these tables.
-        
-        **Tables in this namespace:**
-        ${props.component.tables.map((table) => `- ${table}`).join("\n")}
-      `,
-    },
-  ];
-};

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

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

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

@@ -1,95 +0,0 @@
-import { IAgenticaHistoryJson } from "@agentica/core";
-import {
-  AutoBeRealizeAuthorization,
-  IAutoBeTypeScriptCompileResult,
-} from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-import { ILlmSchema } from "@samchon/openapi";
-import { v7 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
-import { AutoBeContext } from "../../../context/AutoBeContext";
-
-export const transformRealizeAuthorizationCorrectHistories = <
-  Model extends ILlmSchema.Model,
->(
-  ctx: AutoBeContext<Model>,
-  auth: AutoBeRealizeAuthorization,
-  templateFiles: Record<string, string>,
-  diagnostics: IAutoBeTypeScriptCompileResult.IDiagnostic[],
-): Array<
-  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
-> => {
-  return [
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.REALIZE_AUTHORIZATION,
-    },
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.REALIZE_AUTHORIZATION_CORRECT,
-    },
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "assistantMessage",
-      text: StringUtil.trim`
-        ## Generated TypeScript Code
-
-        \`\`\`json
-        ${JSON.stringify({
-          provider: {
-            location: auth.provider.location,
-            name: auth.provider.name,
-            content: auth.provider.content,
-          },
-          decorator: {
-            location: auth.decorator.location,
-            name: auth.decorator.name,
-            content: auth.decorator.content,
-          },
-          payload: {
-            location: auth.payload.location,
-            name: auth.payload.name,
-            content: auth.payload.content,
-          },
-        } satisfies Omit<AutoBeRealizeAuthorization, "actor">)}
-        \`\`\`
-
-        ## 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.actor.name.toLowerCase()}Authorize (e.g. ${auth.actor.name.toLowerCase()}Authorize)
-        - Decorator Name: ${auth.actor.name.charAt(0).toUpperCase() + auth.actor.name.slice(1).toLowerCase()}Auth (e.g. ${auth.actor.name.charAt(0).toUpperCase() + auth.actor.name.slice(1).toLowerCase()}Auth)
-        - Payload Name: ${auth.actor.name.charAt(0).toUpperCase() + auth.actor.name.slice(1).toLowerCase()}Payload (e.g. ${auth.actor.name.charAt(0).toUpperCase() + auth.actor.name.slice(1).toLowerCase()}Payload)
-      `,
-    },
-  ];
-};

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

@@ -1,30 +0,0 @@
-import { IAgenticaHistoryJson } from "@agentica/core";
-import { v7 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
-import { transformPreviousAndLatestCorrectHistories } from "../../common/histories/transformPreviousAndLatestCorrectHistories";
-import { IAutoBeRealizeFunctionFailure } from "../structures/IAutoBeRealizeFunctionFailure";
-
-export const transformRealizeCorrectCastingHistories = (props: {
-  failures: IAutoBeRealizeFunctionFailure[];
-}): Array<
-  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
-> => {
-  const histories: Array<
-    IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
-  > = [
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.COMMON_CORRECT_CASTING,
-    },
-    ...transformPreviousAndLatestCorrectHistories(
-      props.failures.map((f) => ({
-        script: f.function.content,
-        diagnostics: f.diagnostics,
-      })),
-    ),
-  ];
-  return histories;
-};

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

@@ -1,46 +0,0 @@
-import { IAgenticaHistoryJson } from "@agentica/core";
-import { AutoBeRealizeAuthorization } from "@autobe/interface";
-import { v7 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
-import { AutoBeState } from "../../../context/AutoBeState";
-import { transformPreviousAndLatestCorrectHistories } from "../../common/histories/transformPreviousAndLatestCorrectHistories";
-import { IAutoBeRealizeFunctionFailure } from "../structures/IAutoBeRealizeFunctionFailure";
-import { IAutoBeRealizeScenarioResult } from "../structures/IAutoBeRealizeScenarioResult";
-import { transformRealizeWriteHistories } from "./transformRealizeWriteHistories";
-
-export function transformRealizeCorrectHistories(props: {
-  state: AutoBeState;
-  scenario: IAutoBeRealizeScenarioResult;
-  authorization: AutoBeRealizeAuthorization | null;
-  totalAuthorizations: AutoBeRealizeAuthorization[];
-  dto: Record<string, string>;
-  failures: IAutoBeRealizeFunctionFailure[];
-}): Array<
-  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
-> {
-  const histories: Array<
-    IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
-  > = [
-    ...transformRealizeWriteHistories(props),
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.COMMON_CORRECT_CASTING,
-    } as IAgenticaHistoryJson.ISystemMessage,
-    {
-      id: v7(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.REALIZE_CORRECT,
-      created_at: new Date().toISOString(),
-    } as IAgenticaHistoryJson.ISystemMessage,
-    ...transformPreviousAndLatestCorrectHistories(
-      props.failures.map((f) => ({
-        script: f.function.content,
-        diagnostics: f.diagnostics,
-      })),
-    ),
-  ];
-  return histories;
-}