@autobe/agent 0.17.1 → 0.19.1

package/lib/utils/enforceToolCall.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.enforceToolCall = enforceToolCall;
-function enforceToolCall(agent) {
-    agent.on("request", (event) => {
-        if (event.body.tools)
-            event.body.tool_choice = "required";
-        if (event.body.parallel_tool_calls !== undefined)
-            delete event.body.parallel_tool_calls;
-    });
-    return agent;
-}
-//# sourceMappingURL=enforceToolCall.js.map

package/lib/utils/enforceToolCall.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"enforceToolCall.js","sourceRoot":"","sources":["../../src/utils/enforceToolCall.ts"],"names":[],"mappings":";;AAGA,0CASC;AATD,SAAgB,eAAe,CAC7B,KAA2B;IAE3B,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;QAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC1D,IAAI,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,SAAS;YAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC;IAC1C,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/utils/forceRetry.d.ts

@@ -1 +0,0 @@
-export declare function forceRetry<T>(task: () => Promise<T>, count?: number): Promise<T>;

package/lib/utils/forceRetry.js

@@ -1,26 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.forceRetry = forceRetry;
-function forceRetry(task_1) {
-    return __awaiter(this, arguments, void 0, function* (task, count = 2) {
-        let error = undefined;
-        for (let i = 0; i <= count; ++i)
-            try {
-                return yield task();
-            }
-            catch (e) {
-                error = e;
-            }
-        throw error;
-    });
-}
-//# sourceMappingURL=forceRetry.js.map

package/lib/utils/forceRetry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"forceRetry.js","sourceRoot":"","sources":["../../src/utils/forceRetry.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,gCAYC;AAZD,SAAsB,UAAU;yDAC9B,IAAsB,EACtB,QAAgB,CAAC;QAEjB,IAAI,KAAK,GAAY,SAAS,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,EAAE,CAAC;YACtB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,KAAK,GAAG,CAAC,CAAC;YACZ,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;CAAA"}

package/lib/utils/pipe.d.ts

@@ -1,5 +0,0 @@
-import { FAILED } from "../orchestrate/realize/structures/IAutoBeRealizeFailedSymbol";
-export declare function pipe<A, B>(a: A, ab: (a: A) => Promise<B | FAILED>): Promise<B | FAILED>;
-export declare function pipe<A, B, C>(a: A, ab: (a: A) => Promise<B | FAILED>, bc: (b: B) => Promise<C | FAILED>): Promise<C | FAILED>;
-export declare function pipe<A, B, C, D>(a: A, ab: (a: A) => Promise<B | FAILED>, bc: (b: B) => Promise<C | FAILED>, cd: (c: C) => Promise<D | FAILED>): Promise<D | FAILED>;
-export declare function pipe<A, B, C, D, E>(a: A, ab: (a: A) => Promise<B | FAILED>, bc: (b: B) => Promise<C | FAILED>, cd: (c: C) => Promise<D | FAILED>, de: (d: D) => Promise<E | FAILED>): Promise<E | FAILED>;

package/lib/utils/pipe.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.pipe = pipe;
-const IAutoBeRealizeFailedSymbol_1 = require("../orchestrate/realize/structures/IAutoBeRealizeFailedSymbol");
-function pipe(a, ...fns) {
-    return fns.reduce((prev, fn) => {
-        return prev.then((result) => {
-            if (result === IAutoBeRealizeFailedSymbol_1.FAILED)
-                return IAutoBeRealizeFailedSymbol_1.FAILED;
-            return fn(result);
-        });
-    }, Promise.resolve(a));
-}
-//# sourceMappingURL=pipe.js.map

package/lib/utils/pipe.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../../src/utils/pipe.ts"],"names":[],"mappings":";;AA4BA,oBAUC;AAtCD,6GAAsF;AA4BtF,SAAgB,IAAI,CAClB,CAAM,EACN,GAAG,GAAsC;IAEzC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YAC1B,IAAI,MAAM,KAAK,mCAAM;gBAAE,OAAO,mCAAM,CAAC;YACrC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC"}

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"),
-    },
-  ];
-};