@autobe/agent 0.17.1 → 0.18.0

package/src/orchestrate/analyze/AutoBeAnalyzeFileSystem.ts

@@ -1,58 +0,0 @@
-import { tags } from "typia";
-
-export interface IFile {
-  /**
-   * Describe briefly why you made this document, and if you have any plans for
-   * the next one.
-   */
-  reason: string;
-
-  /** Filename to generate or overwrite. */
-  filename: `${string}.md`;
-
-  /**
-   * Markdown file content. Only write the content of the file. Do not include
-   * any questions. This should contain only the contents of the file. Do not
-   * write down any questions or appreciation. For example, remove a sentence
-   * such as "Is it okay if we proceed with the table of contents? Please let me
-   * know if there is anything to add or exclude from the table of contents!"
-   */
-  markdown: string;
-}
-
-export interface ICreateOrUpdateInput {
-  /**
-   * Fill in the elements of the array as many files as you want to create.
-   * Overwrite if you point to the name of the file that already exists.
-   *
-   * @title files to create or update
-   */
-  files: Array<IFile> & tags.MinItems<1>;
-}
-
-type Filename = string;
-type FileContent = string;
-
-export interface IAutoBeAnalyzeFileSystem {
-  /**
-   * Generate multiple markdown files. if there is already created files,
-   * overwrite it. Generate several markdown files at once. It is recommended
-   * that you create multiple files at a time.
-   */
-  createOrUpdateFiles(
-    input: ICreateOrUpdateInput,
-  ): Promise<Record<string, string>>;
-}
-
-export class AutoBeAnalyzeFileSystem implements IAutoBeAnalyzeFileSystem {
-  constructor(private readonly fileMap: Record<Filename, FileContent> = {}) {}
-  async createOrUpdateFiles(input: {
-    files: Array<IFile> & tags.MinItems<1>;
-  }): Promise<Record<string, string>> {
-    input.files.forEach((file) => {
-      this.fileMap[file.filename] = file.markdown;
-    });
-
-    return this.fileMap;
-  }
-}

package/src/orchestrate/analyze/AutoBeAnalyzePointer.ts

@@ -1,10 +0,0 @@
-import { IPointer } from "tstl";
-
-type Filename = string;
-type FileContent = string;
-
-export interface AutoBEAnalyzeFileMap extends Record<Filename, FileContent> {}
-
-export type AutoBeAnalyzePointer = IPointer<{
-  files: AutoBEAnalyzeFileMap;
-} | null>;

package/src/orchestrate/analyze/orchestrateAnalyzeComposer.ts

@@ -1,112 +0,0 @@
-import { IAgenticaController, MicroAgentica } from "@agentica/core";
-import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
-import typia from "typia";
-import { v4 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../constants/AutoBeSystemPromptConstant";
-import { AutoBeContext } from "../../context/AutoBeContext";
-import { assertSchemaModel } from "../../context/assertSchemaModel";
-import { enforceToolCall } from "../../utils/enforceToolCall";
-import {
-  IAutoBeAnalyzeComposerApplication,
-  IComposeInput,
-} from "./structures/IAutoBeAnalyzeComposerApplication";
-
-export const orchestrateAnalyzeComposer = <Model extends ILlmSchema.Model>(
-  ctx: AutoBeContext<Model>,
-  setComposeInput: (value: IComposeInput) => void,
-) => {
-  const controller = createController<Model>({
-    model: ctx.model,
-    execute: new AutoBeAnalyzeComposerApplication(),
-    preExecute: setComposeInput,
-  });
-
-  const agent = new MicroAgentica({
-    model: ctx.model,
-    vendor: ctx.vendor,
-    controllers: [controller],
-    config: {
-      locale: ctx.config?.locale,
-      executor: {
-        describe: null,
-      },
-    },
-    histories: [
-      ...ctx
-        .histories()
-        .filter(
-          (h) => h.type === "userMessage" || h.type === "assistantMessage",
-        ),
-      {
-        id: v4(),
-        type: "systemMessage",
-        text: AutoBeSystemPromptConstant.ANALYZE_PLANNER,
-        created_at: new Date().toISOString(),
-      },
-    ],
-  });
-  enforceToolCall(agent);
-  return agent;
-};
-
-class AutoBeAnalyzeComposerApplication
-  implements IAutoBeAnalyzeComposerApplication
-{
-  /**
-   * Compose project structure with roles and files.
-   *
-   * Design a list of roles and initial documents that you need to create for
-   * that requirement. Roles define team member responsibilities, while files
-   * define the documentation structure. These are managed separately. If you
-   * determine from the conversation that the user's requirements have not been
-   * fully gathered, you must stop the analysis and continue collecting the
-   * remaining requirements. In this case, you do not need to generate any files
-   * or roles. Simply pass an empty array to `input.files` and `input.roles`.
-   *
-   * @param input Prefix, roles, and files
-   * @returns
-   */
-  compose(input: IComposeInput): IComposeInput {
-    return input;
-  }
-}
-
-function createController<Model extends ILlmSchema.Model>(props: {
-  model: Model;
-  execute: AutoBeAnalyzeComposerApplication;
-  preExecute: (input: IComposeInput) => void;
-}): IAgenticaController.IClass<Model> {
-  assertSchemaModel(props.model);
-  const application: ILlmApplication<Model> = collection[
-    props.model
-  ] as unknown as ILlmApplication<Model>;
-  return {
-    protocol: "class",
-    name: "Compose",
-    application,
-    execute: {
-      compose: (input) => {
-        props.preExecute(input);
-        return props.execute.compose(input);
-      },
-    } satisfies IAutoBeAnalyzeComposerApplication,
-  };
-}
-
-const claude = typia.llm.application<
-  AutoBeAnalyzeComposerApplication,
-  "claude",
-  { reference: true }
->();
-const collection = {
-  chatgpt: typia.llm.application<
-    AutoBeAnalyzeComposerApplication,
-    "chatgpt",
-    { reference: true }
-  >(),
-  claude,
-  llama: claude,
-  deepseek: claude,
-  "3.1": claude,
-};

package/src/orchestrate/analyze/orchestrateAnalyzeReviewer.ts

@@ -1,131 +0,0 @@
-import { IAgenticaController, MicroAgentica } from "@agentica/core";
-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 { enforceToolCall } from "../../utils/enforceToolCall";
-import { transformAnalyzeReviewerHistories } from "./transformAnalyzeReviewerHistories";
-
-export type IOrchestrateAnalyzeReviewerResult =
-  | {
-      type: "reject";
-      value: string;
-    }
-  | {
-      type: "accept";
-    };
-
-export const orchestrateAnalyzeReviewer = async <
-  Model extends ILlmSchema.Model,
->(
-  ctx: AutoBeContext<Model>,
-  input: {
-    /** Total file names */
-    files: Record<string, string>;
-  },
-): Promise<IOrchestrateAnalyzeReviewerResult> => {
-  const fnCalled: IPointer<IOrchestrateAnalyzeReviewerResult> = {
-    value: {
-      type: "reject",
-      value: "reviewer is not working because of unknown reason.",
-    },
-  };
-
-  const controller = createController({
-    model: ctx.model,
-    setResult: (result: IOrchestrateAnalyzeReviewerResult) => {
-      fnCalled.value = result;
-    },
-  });
-  const agent = new MicroAgentica({
-    model: ctx.model,
-    vendor: ctx.vendor,
-    controllers: [controller],
-    config: {
-      ...ctx.config,
-      executor: {
-        describe: null,
-      },
-    },
-    histories: [...transformAnalyzeReviewerHistories(input)],
-  });
-  enforceToolCall(agent);
-
-  const command = `proceed with the review of these files only.` as const;
-  await agent.conversate(command).finally(() => {
-    const tokenUsage = agent.getTokenUsage().aggregate;
-    ctx.usage().record(tokenUsage, ["analyze"]);
-  });
-
-  return fnCalled.value;
-};
-
-interface IAutoBeAnalyzerReviewerSystem {
-  /**
-   * If there is anything that needs to be modified, you can call it, This
-   * function is to reject the document for to try rewriting document with your
-   * advice or suggestion.
-   */
-  reject(input: {
-    /**
-     * The reason why you reject the document and the suggestion for the
-     * modification. You can write the reason in detail.
-     */
-    reason: string;
-  }): "OK" | Promise<"OK">;
-
-  /**
-   * If you decide that you no longer need any reviews, call accept. This is a
-   * function to end document creation and review, and to respond to users.
-   */
-  accept(): "OK" | Promise<"OK">;
-}
-
-function createController<Model extends ILlmSchema.Model>(props: {
-  model: Model;
-  setResult: (result: IOrchestrateAnalyzeReviewerResult) => void;
-}): IAgenticaController.IClass<Model> {
-  assertSchemaModel(props.model);
-  const application: ILlmApplication<Model> = collection[
-    props.model
-  ] as unknown as ILlmApplication<Model>;
-  return {
-    protocol: "class",
-    name: "Reviewer",
-    application,
-    execute: {
-      accept: async () => {
-        props.setResult({
-          type: "accept",
-        });
-        return "OK" as const;
-      },
-      reject: async (input) => {
-        props.setResult({
-          type: "reject",
-          value: input.reason,
-        });
-        return "OK" as const;
-      },
-    } satisfies IAutoBeAnalyzerReviewerSystem,
-  };
-}
-
-const claude = typia.llm.application<
-  IAutoBeAnalyzerReviewerSystem,
-  "claude",
-  { reference: true }
->();
-const collection = {
-  chatgpt: typia.llm.application<
-    IAutoBeAnalyzerReviewerSystem,
-    "chatgpt",
-    { reference: true }
-  >(),
-  claude,
-  llama: claude,
-  deepseek: claude,
-  "3.1": claude,
-};

package/src/orchestrate/analyze/structures/IAutoBeAnalyzeComposerApplication.ts

@@ -1,75 +0,0 @@
-import { AutoBeAnalyzeRole } from "@autobe/interface";
-
-import { IFile } from "../AutoBeAnalyzeFileSystem";
-
-export interface IComposeInput {
-  /** Reason for the analysis and composition of the project structure. */
-  reason: string;
-
-  /**
-   * Prefix for file names and all prisma schema files, table, interface, and
-   * variable names.
-   */
-  prefix: string;
-
-  /** Roles to be assigned for the project */
-  roles: AutoBeAnalyzeRole[];
-
-  /**
-   * If the user has requested a specific number of pages, enter that number.
-   * Otherwise, provide an appropriate number of documents needed to meet the
-   * user's requirements. This number must always match the length of the files
-   * property, must be greater than 1, and must include the table of contents.
-   * For example, if the user requests 3 pages, the total should be 4, including
-   * the table of contents.
-   */
-  page: number;
-
-  /**
-   * # Document files to be generated
-   *
-   * File name must be English and it must contain the numbering and prefix.
-   *
-   * These files represent business documentation that may include:
-   *
-   * - Business requirements and functional specifications
-   * - User journey mapping and use case scenarios
-   * - Business rules and workflow definitions
-   * - Service architecture and system design overview
-   * - Data flow and integration requirements
-   * - User roles and permission matrix
-   * - API endpoint specifications and contracts
-   * - Business logic and validation rules
-   *
-   * Generate files based on actual requirements gathered from conversation. Do
-   * not create unnecessary documentation - only generate what is needed to
-   * properly define the business requirements and system specifications.
-   *
-   * # Page Length Rules
-   *
-   * The number of documents must match the user's request, excluding the table
-   * of contents. For example, if the user requests 3 pages, a total of 4
-   * documents should be generated, including the table of contents. If the user
-   * does not specify a number, generate a sufficient number of documents to
-   * adequately support the service.
-   */
-  files: Array<Pick<IFile, "filename" | "reason">>;
-}
-
-export interface IAutoBeAnalyzeComposerApplication {
-  /**
-   * Compose project structure with roles and files.
-   *
-   * Design a list of roles and initial documents that you need to create for
-   * that requirement. Roles define team member responsibilities, while files
-   * define the documentation structure. These are managed separately. If you
-   * determine from the conversation that the user's requirements have not been
-   * fully gathered, you must stop the analysis and continue collecting the
-   * remaining requirements. In this case, you do not need to generate any files
-   * or roles. Simply pass an empty array to `input.files` and `input.roles`.
-   *
-   * @param input Prefix, roles, and files
-   * @returns
-   */
-  compose(input: IComposeInput): IComposeInput;
-}

package/src/orchestrate/analyze/transformAnalyzeReviewerHistories.ts

@@ -1,31 +0,0 @@
-import { IAgenticaHistoryJson } from "@agentica/core";
-import { v4 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../constants/AutoBeSystemPromptConstant";
-
-export const transformAnalyzeReviewerHistories = (input: {
-  /** Total file names */
-  files: Record<string, string>;
-}): Array<
-  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
-> => {
-  return [
-    {
-      id: v4(),
-      created_at: new Date().toISOString(),
-      type: "assistantMessage",
-      text: [
-        "Below are all of the files.",
-        "```json",
-        JSON.stringify(input.files),
-        "```",
-      ].join("\n"),
-    },
-    {
-      id: v4(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.ANALYZE_REVIEWER,
-    },
-  ];
-};

package/src/orchestrate/analyze/transformAnalyzeWriteHistories.ts

@@ -1,94 +0,0 @@
-import { IAgenticaHistoryJson } from "@agentica/core";
-import { AutoBeAnalyzeRole } from "@autobe/interface";
-import { ILlmSchema } from "@samchon/openapi";
-import { v4 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../constants/AutoBeSystemPromptConstant";
-import { AutoBeContext } from "../../context/AutoBeContext";
-import { IFile } from "./AutoBeAnalyzeFileSystem";
-
-export const transformAnalyzeWriteHistories = <Model extends ILlmSchema.Model>(
-  ctx: AutoBeContext<Model>,
-  input: {
-    /** Total file names */
-    totalFiles: Pick<IFile, "filename" | "reason">[];
-    targetFile: string;
-    roles: AutoBeAnalyzeRole[];
-    review: string | null;
-  },
-): Array<
-  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
-> => {
-  return [
-    ...(input.review !== null
-      ? ([
-          {
-            id: v4(),
-            created_at: new Date().toISOString(),
-            type: "assistantMessage",
-            text: [
-              input.totalFiles.find((el) => el.filename === input.targetFile),
-            ].join("\n"),
-          },
-          {
-            id: v4(),
-            created_at: new Date().toISOString(),
-            type: "assistantMessage",
-            text: [
-              `You previously wrote a piece of content.`,
-              `The following review has been received regarding your writing:`,
-              input.review,
-              `You must revise your content to reflect the feedback in this review.`,
-            ].join(),
-          },
-        ] as const)
-      : []),
-    {
-      id: v4(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.ANALYZE.replace(
-        "{% User Locale %}",
-        ctx.config?.locale ?? "en-US",
-      ),
-    },
-    {
-      id: v4(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: [
-        "# Guidelines",
-        "If the user specifies the exact number of pages, please follow it precisely.",
-        AutoBeSystemPromptConstant.ANALYZE_GUIDELINE,
-      ].join("\n"),
-    },
-    {
-      id: v4(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: [
-        `# Instruction`,
-        `The names of all the files are as follows: ${input.totalFiles
-          .map((f) => f.filename)
-          .join(",")}`,
-        "Assume that all files are in the same folder. Also, when pointing to the location of a file, go to the relative path.",
-        "",
-        `The following user roles have been defined for this system:`,
-        ...input.roles.map((role) => `- ${role.name}: ${role.description}`),
-        "These roles will be used for API authentication and should be considered when creating documentation.",
-        "",
-        `Document Length Specification:`,
-        `- You are responsible for writing ONLY ONE document: ${input.targetFile}`,
-        `- Each page should contain approximately 2,000 characters`,
-        `- DO NOT write content for other documents - focus only on ${input.targetFile}`,
-        "",
-        `Among the various documents, the part you decided to take care of is as follows.: ${input.targetFile}`,
-        `Only write this document named '${input.targetFile}'.`,
-        "Never write other documents.",
-        "",
-        "# Reason to write this document",
-        `- ${input.totalFiles.find((el) => el.filename === input.targetFile)?.reason}`,
-      ].join("\n"),
-    },
-  ];
-};

package/src/orchestrate/analyze/writeDocumentUntilReviewPassed.ts

@@ -1,96 +0,0 @@
-import { AutoBeAnalyzeRole } from "@autobe/interface";
-import { ILlmSchema } from "@samchon/openapi";
-
-import { AutoBeContext } from "../../context/AutoBeContext";
-import { IFile } from "./AutoBeAnalyzeFileSystem";
-import {
-  AutoBEAnalyzeFileMap,
-  AutoBeAnalyzePointer,
-} from "./AutoBeAnalyzePointer";
-import { orchestrateAnalyzeReviewer } from "./orchestrateAnalyzeReviewer";
-import { orchestrateAnalyzeWrite } from "./orchestrateAnalyzeWrite";
-
-export async function writeDocumentUntilReviewPassed<
-  Model extends ILlmSchema.Model,
->(
-  ctx: AutoBeContext<Model>,
-  props: {
-    totalFiles: Pick<IFile, "filename" | "reason">[];
-    filename: string;
-    roles: AutoBeAnalyzeRole[];
-    progress: { total: number; completed: number };
-    retry?: number;
-    prevReview?: string;
-  },
-): Promise<AutoBeAnalyzePointer> {
-  const retry = props.retry ?? 3;
-  const pointer: { value: { files: AutoBEAnalyzeFileMap } } = {
-    value: { files: {} },
-  };
-
-  /**
-   * `retry` means the number of times to retry the review. so if `retry` is -1,
-   * it means not execute this logic.
-   */
-  if (retry === -1) {
-    return pointer;
-  }
-
-  let isToolCalled = false;
-  const writer = orchestrateAnalyzeWrite(ctx, {
-    totalFiles: props.totalFiles,
-    roles: props.roles,
-    targetFile: props.filename,
-    review: props.prevReview ?? "",
-    setDocument: (v) => {
-      isToolCalled = true;
-      pointer.value = { files: { ...pointer.value?.files, ...v } };
-    },
-  });
-  await writer.conversate("Write Document.").finally(() => {
-    const tokenUsage = writer.getTokenUsage().aggregate;
-    ctx.usage().record(tokenUsage, ["analyze"]);
-  });
-
-  if (isToolCalled === false) {
-    throw new Error("Failed to write document by unknown reason.");
-  }
-
-  ctx.dispatch({
-    type: "analyzeWrite",
-    files: {
-      ...pointer.value?.files,
-    },
-    total: props.progress.total,
-    completed: ++props.progress.completed,
-    step: ctx.state().analyze?.step ?? 0,
-    created_at: new Date().toISOString(),
-  });
-
-  const reviewResult = await orchestrateAnalyzeReviewer(ctx, pointer.value);
-
-  if (reviewResult.type === "accept") {
-    return pointer;
-  }
-
-  ctx.dispatch({
-    type: "analyzeReview",
-    files: {
-      ...pointer.value.files,
-    },
-    review: reviewResult.value,
-    total: props.progress.total,
-    completed: props.progress.completed,
-    step: ctx.state().analyze?.step ?? 0,
-    created_at: new Date().toISOString(),
-  });
-
-  return await writeDocumentUntilReviewPassed(ctx, {
-    totalFiles: props.totalFiles,
-    filename: props.filename,
-    roles: props.roles,
-    progress: props.progress,
-    retry: retry - 1,
-    prevReview: reviewResult.value,
-  });
-}

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

@@ -1,59 +0,0 @@
-import { IAgenticaHistoryJson } from "@agentica/core";
-import { v4 } from "uuid";
-
-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 [
-      {
-        id: v4(),
-        created_at: new Date().toISOString(),
-        type: "systemMessage",
-        text: [
-          "Requirement analysis is not yet completed.",
-          "Don't call any tool function,",
-          "but say to process the requirement analysis.",
-        ].join(" "),
-      },
-    ];
-  return [
-    {
-      id: v4(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.PRISMA,
-    },
-    {
-      id: v4(),
-      created_at: new Date().toISOString(),
-      type: "assistantMessage",
-      text: AutoBeSystemPromptConstant.PRISMA_EXAMPLE,
-    },
-    {
-      id: v4(),
-      created_at: new Date().toISOString(),
-      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"),
-    },
-  ];
-};