@autobe/agent 0.17.1 → 0.19.1

package/src/orchestrate/interface/orchestrateInterfaceAuthorizations.ts

@@ -0,0 +1,209 @@
+import { IAgenticaController } from "@agentica/core";
+import {
+  AutoBeAnalyzeRole,
+  AutoBeInterfaceAuthorization,
+  AutoBeOpenApi,
+  AutoBeProgressEventBase,
+} from "@autobe/interface";
+import { AutoBeInterfaceAuthorizationEvent } from "@autobe/interface/src/events/AutoBeInterfaceAuthorizationEvent";
+import { StringUtil } from "@autobe/utils";
+import { ILlmApplication, ILlmSchema, IValidation } from "@samchon/openapi";
+import { IPointer } from "tstl";
+import typia from "typia";
+
+import { AutoBeContext } from "../../context/AutoBeContext";
+import { assertSchemaModel } from "../../context/assertSchemaModel";
+import { transformInterfaceAuthorizationsHistories } from "./histories/transformInterfaceAuthorizationsHistories";
+import { IAutoBeInterfaceAuthorizationsApplication } from "./structures/IAutoBeInterfaceAuthorizationsApplication";
+
+export async function orchestrateInterfaceAuthorizations<
+  Model extends ILlmSchema.Model,
+>(ctx: AutoBeContext<Model>): Promise<AutoBeInterfaceAuthorization[]> {
+  const roles: AutoBeAnalyzeRole[] = ctx.state().analyze?.roles ?? [];
+  const progress: AutoBeProgressEventBase = {
+    total: roles.length,
+    completed: 0,
+  };
+  const authorizations: AutoBeInterfaceAuthorization[] = await Promise.all(
+    roles.map(async (role) => {
+      const event: AutoBeInterfaceAuthorizationEvent = await process(
+        ctx,
+        role,
+        progress,
+      );
+      ctx.dispatch(event);
+      return {
+        role: role.name,
+        operations: event.operations,
+      };
+    }),
+  );
+
+  return authorizations;
+}
+
+async function process<Model extends ILlmSchema.Model>(
+  ctx: AutoBeContext<Model>,
+  role: AutoBeAnalyzeRole,
+  progress: AutoBeProgressEventBase,
+): Promise<AutoBeInterfaceAuthorizationEvent> {
+  const pointer: IPointer<IAutoBeInterfaceAuthorizationsApplication.IProps | null> =
+    {
+      value: null,
+    };
+  const { tokenUsage } = await ctx.conversate({
+    source: "interfaceAuthorization",
+    histories: transformInterfaceAuthorizationsHistories(ctx.state(), role),
+    controller: createController({
+      model: ctx.model,
+      role: role.name,
+      build: (next) => {
+        pointer.value = next;
+      },
+    }),
+    enforceFunctionCall: true,
+    message: "Create Authorization Operation for the given roles",
+  });
+  if (pointer.value === null)
+    throw new Error("Failed to generate authorization operation.");
+
+  return {
+    type: "interfaceAuthorization",
+    operations: pointer.value.operations,
+    completed: ++progress.completed,
+    tokenUsage,
+    created_at: new Date().toISOString(),
+    step: ctx.state().analyze?.step ?? 0,
+    total: progress.total,
+  } satisfies AutoBeInterfaceAuthorizationEvent;
+}
+
+function createController<Model extends ILlmSchema.Model>(props: {
+  model: Model;
+  role: string;
+  build: (next: IAutoBeInterfaceAuthorizationsApplication.IProps) => void;
+}): IAgenticaController.IClass<Model> {
+  assertSchemaModel(props.model);
+
+  const validate = (
+    next: unknown,
+  ): IValidation<IAutoBeInterfaceAuthorizationsApplication.IProps> => {
+    const result: IValidation<IAutoBeInterfaceAuthorizationsApplication.IProps> =
+      typia.validate<IAutoBeInterfaceAuthorizationsApplication.IProps>(next);
+    if (result.success === false) return result;
+
+    const errors: IValidation.IError[] = [];
+    result.data.operations.forEach((op, i) => {
+      // validate authorizationRole
+      if (op.authorizationRole !== null) {
+        op.authorizationRole = props.role;
+      }
+
+      // validate responseBody.typeName -> must be ~.IAuthorized
+      if (op.authorizationType === null) return;
+      else if (op.responseBody === null)
+        errors.push({
+          path: `$input.operations.${i}.responseBody`,
+          expected:
+            "Response body with I{RoleName(PascalCase)}.IAuthorized type is required",
+          value: op.responseBody,
+          description: [
+            "Response body is required for authentication operations.",
+            "",
+            "The responseBody must contain description and typeName fields.",
+            "typeName must be I{Prefix(PascalCase)}{RoleName(PascalCase)}.IAuthorized",
+            "description must be a detailed description of the response body.",
+          ].join("\n"),
+        });
+      else if (!op.responseBody.typeName.endsWith(".IAuthorized"))
+        errors.push({
+          path: `$input.operations.${i}.responseBody.typeName`,
+          expected: `Type name must be I{RoleName(PascalCase)}.IAuthorized`,
+          value: op.responseBody?.typeName,
+          description: [
+            `Wrong response body type name: ${op.responseBody?.typeName}`,
+            "",
+            `For authentication operations (login, join, refresh), the response body type name must follow the convention "I{RoleName}.IAuthorized".`,
+            ``,
+            `This standardized naming convention ensures consistency across all authentication endpoints and clearly identifies authorization response types.`,
+            `The Role name should be in PascalCase format (e.g., IUser.IAuthorized, IAdmin.IAuthorized, ISeller.IAuthorized).`,
+          ].join("\n"),
+        });
+    });
+
+    // validate authorization types' existence
+    type AuthorizationType = NonNullable<
+      AutoBeOpenApi.IOperation["authorizationType"]
+    >;
+    const authorizationTypes: Set<AuthorizationType> = new Set(
+      result.data.operations
+        .map((o) => o.authorizationType)
+        .filter((v) => v !== null),
+    );
+    for (const type of typia.misc.literals<AuthorizationType>())
+      if (authorizationTypes.has(type) === false)
+        errors.push({
+          path: "$input.operations[].authorizationType",
+          expected: StringUtil.trim`{
+          ...(AutoBeOpenApi.IOperation data),
+          authorizationType: "${type}"
+        }`,
+          value: `No authorizationType "${type}" found in any operation`,
+          description: StringUtil.trim`
+          There must be an operation that has defined AutoBeOpenApi.IOperation.authorizationType := "${type}"
+          for the "${props.role}" role's authorization activity; "${type}".
+
+          However, none of the operations have the AutoBeOpenApi.IOperation.authorizationType := "${type}" 
+          value, so that the "${props.role}" cannot perform the authorization ${type} activity.
+
+          Please make that operation at the next function calling. You have to do it.
+        `,
+        });
+    if (errors.length !== 0) {
+      return {
+        success: false,
+        errors,
+        data: next,
+      };
+    }
+    return result;
+  };
+
+  const application: ILlmApplication<Model> = collection[
+    props.model === "chatgpt" ? "chatgpt" : "claude"
+  ](
+    validate,
+  ) satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
+
+  return {
+    protocol: "class",
+    name: "Create Authorization Interface",
+    application,
+    execute: {
+      makeOperations: (next) => {
+        props.build(next);
+      },
+    } satisfies IAutoBeInterfaceAuthorizationsApplication,
+  };
+}
+
+const collection = {
+  chatgpt: (validate: Validator) =>
+    typia.llm.application<IAutoBeInterfaceAuthorizationsApplication, "chatgpt">(
+      {
+        validate: {
+          makeOperations: validate,
+        },
+      },
+    ),
+  claude: (validate: Validator) =>
+    typia.llm.application<IAutoBeInterfaceAuthorizationsApplication, "claude">({
+      validate: {
+        makeOperations: validate,
+      },
+    }),
+};
+
+type Validator = (
+  input: unknown,
+) => IValidation<IAutoBeInterfaceAuthorizationsApplication.IProps>;

package/src/orchestrate/interface/orchestrateInterfaceComplement.ts

@@ -1,4 +1,4 @@
-import { IAgenticaController, MicroAgentica } from "@agentica/core";
+import { IAgenticaController } from "@agentica/core";
 import { AutoBeOpenApi } from "@autobe/interface";
 import {
   ILlmApplication,
@@ -11,8 +11,6 @@ import typia from "typia";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
-import { enforceToolCall } from "../../utils/enforceToolCall";
-import { forceRetry } from "../../utils/forceRetry";
 import { transformInterfaceComplementHistories } from "./histories/transformInterfaceComplementHistories";
 import { IAutoBeInterfaceComplementApplication } from "./structures/IAutoBeInterfaceComplementApplication";
 
@@ -21,7 +19,7 @@ export function orchestrateInterfaceComplement<Model extends ILlmSchema.Model>(
   document: AutoBeOpenApi.IDocument,
   life: number = 8,
 ): Promise<Record<string, AutoBeOpenApi.IJsonSchemaDescriptive>> {
-  return forceRetry(() => step(ctx, document, life));
+  return step(ctx, document, life);
 }
 
 async function step<Model extends ILlmSchema.Model>(
@@ -40,54 +38,41 @@ async function step<Model extends ILlmSchema.Model>(
   > | null> = {
     value: null,
   };
-  const agentica: MicroAgentica<Model> = new MicroAgentica({
-    model: ctx.model,
-    vendor: ctx.vendor,
-    config: {
-      ...(ctx.config ?? {}),
-      executor: {
-        describe: null,
-      },
-    },
+  const { tokenUsage } = await ctx.conversate({
+    source: "interfaceComplement",
     histories: transformInterfaceComplementHistories(
       ctx.state(),
       document,
       missed,
     ),
-    controllers: [
-      createApplication({
-        model: ctx.model,
-        build: (next) => {
-          pointer.value ??= {};
-          Object.assign(
-            pointer.value,
-            (OpenApiV3_1Emender.convertComponents({
-              schemas: next,
-            }).schemas ?? {}) as Record<
-              string,
-              AutoBeOpenApi.IJsonSchemaDescriptive
-            >,
-          );
-        },
-      }),
-    ],
-  });
-  enforceToolCall(agentica);
-
-  await agentica.conversate("Fill missing schema types please").finally(() => {
-    const tokenUsage = agentica.getTokenUsage().aggregate;
-    ctx.usage().record(tokenUsage, ["interface"]);
+    controller: createController({
+      model: ctx.model,
+      build: (next) => {
+        pointer.value ??= {};
+        Object.assign(
+          pointer.value,
+          (OpenApiV3_1Emender.convertComponents({
+            schemas: next,
+          }).schemas ?? {}) as Record<
+            string,
+            AutoBeOpenApi.IJsonSchemaDescriptive
+          >,
+        );
+      },
+    }),
+    enforceFunctionCall: true,
+    message: "Fill missing schema types please",
   });
-  if (pointer.value === null) {
+  if (pointer.value === null)
     // unreachable
     throw new Error(
       "Failed to fill missing schema types. No response from agentica.",
     );
-  }
   ctx.dispatch({
     type: "interfaceComplement",
     missed,
     schemas: pointer.value,
+    tokenUsage,
     step: ctx.state().analyze?.step ?? 0,
     created_at: new Date().toISOString(),
   });
@@ -130,7 +115,7 @@ const getMissed = (document: AutoBeOpenApi.IDocument): string[] => {
   return Array.from(missed);
 };
 
-function createApplication<Model extends ILlmSchema.Model>(props: {
+function createController<Model extends ILlmSchema.Model>(props: {
   model: Model;
   build: (
     schemas: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive>,
@@ -139,7 +124,7 @@ function createApplication<Model extends ILlmSchema.Model>(props: {
   assertSchemaModel(props.model);
   const application: ILlmApplication<Model> = collection[
     props.model
-  ] as unknown as ILlmApplication<Model>;
+  ] satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
   return {
     protocol: "class",
     name: "interface",
@@ -154,14 +139,12 @@ function createApplication<Model extends ILlmSchema.Model>(props: {
 
 const claude = typia.llm.application<
   IAutoBeInterfaceComplementApplication,
-  "claude",
-  { reference: true }
+  "claude"
 >();
 const collection = {
   chatgpt: typia.llm.application<
     IAutoBeInterfaceComplementApplication,
-    "chatgpt",
-    { reference: true }
+    "chatgpt"
   >(),
   claude,
   llama: claude,

package/src/orchestrate/interface/orchestrateInterfaceEndpoints.ts

@@ -1,4 +1,4 @@
-import { IAgenticaController, MicroAgentica } from "@agentica/core";
+import { IAgenticaController } from "@agentica/core";
 import {
   AutoBeInterfaceEndpointsEvent,
   AutoBeOpenApi,
@@ -10,7 +10,6 @@ import typia from "typia";
 
 import { AutoBeContext } from "../../context/AutoBeContext";
 import { assertSchemaModel } from "../../context/assertSchemaModel";
-import { enforceToolCall } from "../../utils/enforceToolCall";
 import { transformInterfaceEndpointHistories } from "./histories/transformInterfaceEndpointHistories";
 import { IAutoBeInterfaceEndpointApplication } from "./structures/IAutoBeInterfaceEndpointApplication";
 import { OpenApiEndpointComparator } from "./utils/OpenApiEndpointComparator";
@@ -20,6 +19,7 @@ export async function orchestrateInterfaceEndpoints<
 >(
   ctx: AutoBeContext<Model>,
   groups: AutoBeInterfaceGroup[],
+  authorizations: AutoBeOpenApi.IOperation[],
   content: string = `Make endpoints for the given assets`,
 ): Promise<AutoBeOpenApi.IEndpoint[]> {
   const progress: IProgress = {
@@ -27,7 +27,9 @@ export async function orchestrateInterfaceEndpoints<
     completed: 0,
   };
   const endpoints: AutoBeOpenApi.IEndpoint[] = (
-    await Promise.all(groups.map((g) => process(ctx, g, content, progress)))
+    await Promise.all(
+      groups.map((g) => process(ctx, g, content, progress, authorizations)),
+    )
   ).flat();
   return new HashSet(
     endpoints,
@@ -39,40 +41,33 @@ export async function orchestrateInterfaceEndpoints<
 async function process<Model extends ILlmSchema.Model>(
   ctx: AutoBeContext<Model>,
   group: AutoBeInterfaceGroup,
-  content: string,
+  message: string,
   progress: IProgress,
+  authorizations: AutoBeOpenApi.IOperation[],
 ): Promise<AutoBeOpenApi.IEndpoint[]> {
   const start: Date = new Date();
   const pointer: IPointer<AutoBeOpenApi.IEndpoint[] | null> = {
     value: null,
   };
-  const agentica: MicroAgentica<Model> = new MicroAgentica({
-    model: ctx.model,
-    vendor: ctx.vendor,
-    config: {
-      ...(ctx.config ?? {}),
-      executor: {
-        describe: null,
+  const { tokenUsage } = await ctx.conversate({
+    source: "interfaceEndpoints",
+    histories: transformInterfaceEndpointHistories(
+      ctx.state(),
+      group,
+      authorizations,
+    ),
+    controller: createController({
+      model: ctx.model,
+      build: (endpoints) => {
+        pointer.value ??= endpoints;
+        pointer.value.push(...endpoints);
       },
-    },
-    histories: transformInterfaceEndpointHistories(ctx.state(), group),
-    controllers: [
-      createApplication({
-        model: ctx.model,
-        build: (endpoints) => {
-          pointer.value ??= endpoints;
-          pointer.value.push(...endpoints);
-        },
-      }),
-    ],
-  });
-  enforceToolCall(agentica);
-
-  await agentica.conversate(content).finally(() => {
-    const tokenUsage = agentica.getTokenUsage().aggregate;
-    ctx.usage().record(tokenUsage, ["interface"]);
+    }),
+    enforceFunctionCall: true,
+    message,
   });
   if (pointer.value === null) throw new Error("Failed to generate endpoints."); // unreachable
+
   const event: AutoBeInterfaceEndpointsEvent = {
     type: "interfaceEndpoints",
     endpoints: new HashSet(
@@ -80,6 +75,7 @@ async function process<Model extends ILlmSchema.Model>(
       OpenApiEndpointComparator.hashCode,
       OpenApiEndpointComparator.equals,
     ).toJSON(),
+    tokenUsage,
     created_at: start.toISOString(),
     step: ctx.state().analyze?.step ?? 0,
     completed: ++progress.completed,
@@ -89,7 +85,7 @@ async function process<Model extends ILlmSchema.Model>(
   return pointer.value;
 }
 
-function createApplication<Model extends ILlmSchema.Model>(props: {
+function createController<Model extends ILlmSchema.Model>(props: {
   model: Model;
   build: (endpoints: AutoBeOpenApi.IEndpoint[]) => void;
 }): IAgenticaController.IClass<Model> {
@@ -97,7 +93,7 @@ function createApplication<Model extends ILlmSchema.Model>(props: {
 
   const application: ILlmApplication<Model> = collection[
     props.model
-  ] as unknown as ILlmApplication<Model>;
+  ] satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
   return {
     protocol: "class",
     name: "interface",
@@ -112,14 +108,12 @@ function createApplication<Model extends ILlmSchema.Model>(props: {
 
 const claude = typia.llm.application<
   IAutoBeInterfaceEndpointApplication,
-  "claude",
-  { reference: true }
+  "claude"
 >();
 const collection = {
   chatgpt: typia.llm.application<
     IAutoBeInterfaceEndpointApplication,
-    "chatgpt",
-    { reference: true }
+    "chatgpt"
   >(),
   claude,
   llama: claude,

package/src/orchestrate/interface/orchestrateInterfaceGroups.ts

@@ -1,16 +1,8 @@
-import {
-  IAgenticaController,
-  MicroAgentica,
-  MicroAgenticaHistory,
-} from "@agentica/core";
-import {
-  AutoBeAssistantMessageHistory,
-  AutoBeInterfaceGroupsEvent,
-} from "@autobe/interface";
+import { IAgenticaController } from "@agentica/core";
+import { AutoBeInterfaceGroupsEvent } from "@autobe/interface";
 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";
@@ -21,57 +13,35 @@ export async function orchestrateInterfaceGroups<
   Model extends ILlmSchema.Model,
 >(
   ctx: AutoBeContext<Model>,
-  content: string = "Design API operations for the given assets.",
-): Promise<AutoBeAssistantMessageHistory | AutoBeInterfaceGroupsEvent> {
+  message: string = "Design API operations for the given assets.",
+): Promise<AutoBeInterfaceGroupsEvent> {
   const start: Date = new Date();
   const pointer: IPointer<IAutoBeInterfaceGroupApplication.IProps | null> = {
     value: null,
   };
-  const agentica: MicroAgentica<Model> = new MicroAgentica({
-    model: ctx.model,
-    vendor: ctx.vendor,
-    config: {
-      ...(ctx.config ?? {}),
-      executor: {
-        describe: null,
-      },
-    },
+  const { tokenUsage } = await ctx.conversate({
+    source: "interfaceGroups",
     histories: transformInterfaceGroupHistories(ctx.state()),
-    controllers: [
-      createApplication({
-        model: ctx.model,
-        build: (next) => {
-          pointer.value = next;
-        },
-      }),
-    ],
+    controller: createController({
+      model: ctx.model,
+      build: (next) => {
+        pointer.value = next;
+      },
+    }),
+    enforceFunctionCall: true,
+    message,
   });
-
-  const histories: MicroAgenticaHistory<Model>[] = await agentica
-    .conversate(content)
-    .finally(() => {
-      const tokenUsage = agentica.getTokenUsage().aggregate;
-      ctx.usage().record(tokenUsage, ["interface"]);
-    });
-  const last: MicroAgenticaHistory<Model> = histories.at(-1)!;
-  if (last.type === "assistantMessage")
-    return {
-      ...last,
-      created_at: start.toISOString(),
-      completed_at: new Date().toISOString(),
-      id: v4(),
-    } satisfies AutoBeAssistantMessageHistory;
-  else if (pointer.value === null)
-    throw new Error("Failed to generate groups."); // unreachable
+  if (pointer.value === null) throw new Error("Failed to generate groups."); // unreachable
   return {
     type: "interfaceGroups",
     created_at: start.toISOString(),
     groups: pointer.value.groups,
+    tokenUsage,
     step: ctx.state().analyze?.step ?? 0,
   } satisfies AutoBeInterfaceGroupsEvent;
 }
 
-function createApplication<Model extends ILlmSchema.Model>(props: {
+function createController<Model extends ILlmSchema.Model>(props: {
   model: Model;
   build: (next: IAutoBeInterfaceGroupApplication.IProps) => void;
 }): IAgenticaController.IClass<Model> {
@@ -79,7 +49,7 @@ function createApplication<Model extends ILlmSchema.Model>(props: {
 
   const application: ILlmApplication<Model> = collection[
     props.model
-  ] as unknown as ILlmApplication<Model>;
+  ] satisfies ILlmApplication<any> as unknown as ILlmApplication<Model>;
   return {
     protocol: "class",
     name: "interface",