@autobe/agent 0.30.0-dev.20260315 → 0.30.0

package/src/orchestrate/interface/programmers/AutoBeInterfaceEndpointProgrammer.ts

@@ -1,155 +1,155 @@
-import {
-  AutoBeAnalyze,
-  AutoBeInterfaceEndpointDesign,
-} from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-import { LlmTypeChecker, NamingConvention } from "@typia/utils";
-import { singular } from "pluralize";
-import typia, { ILlmApplication, ILlmSchema, IValidation } from "typia";
-
-export namespace AutoBeInterfaceEndpointProgrammer {
-  /**
-   * Filter endpoint designs:
-   *
-   * - For base: Remove guest actors and login/join/refresh/session
-   *   authorizationType
-   * - For action: Remove all non-null authorizationType (action endpoints must be
-   *   null only)
-   */
-  export const filter = (props: {
-    kind: "base" | "action";
-    design: AutoBeInterfaceEndpointDesign;
-    actors: AutoBeAnalyze.IActor[];
-  }): boolean => {
-    // Action endpoints: only allow authorizationType: null
-    if (props.kind === "action") return props.design.authorizationType === null;
-    else if (
-      props.design.endpoint.path === "/auth" ||
-      props.design.endpoint.path.startsWith("/auth/")
-    )
-      return false;
-
-    // remove specific auth types
-    if (
-      props.design.authorizationType === "login" ||
-      props.design.authorizationType === "join" ||
-      props.design.authorizationType === "refresh" ||
-      props.design.authorizationType === "withdraw"
-    )
-      return false;
-    else if (props.design.authorizationType === "session") {
-      props.design.authorizationActors =
-        props.design.authorizationActors.filter((name) => {
-          const actor: AutoBeAnalyze.IActor | undefined = props.actors.find(
-            (a) => a.name === name,
-          );
-          if (actor === undefined) return false;
-          return actor.kind !== "guest";
-        });
-      if (props.design.authorizationActors.length === 0) return false;
-      else if (
-        props.design.endpoint.method !== "get" &&
-        props.design.endpoint.method !== "patch"
-      )
-        return false;
-      return true;
-    }
-    return true;
-  };
-
-  export const fixDesign = (props: {
-    actors: AutoBeAnalyze.IActor[];
-    design: AutoBeInterfaceEndpointDesign;
-  }): AutoBeInterfaceEndpointDesign => {
-    props.design.endpoint.path = fixPath(props.design.endpoint.path);
-    if (props.design.authorizationActors.length === 1) {
-      const actor: AutoBeAnalyze.IActor | undefined = props.actors.find(
-        (a) => a.name === props.design.authorizationActors[0],
-      );
-      if (actor !== undefined && actor.kind !== "admin") {
-        const param: string =
-          NamingConvention.camel(singular(actor.name)) + "Id";
-        const bracket: string = `{${param}}`;
-        if (props.design.endpoint.path.includes(bracket) === true)
-          props.design.endpoint.path = props.design.endpoint.path.replace(
-            bracket,
-            "",
-          );
-      }
-    } else if (
-      props.design.authorizationActors.length > 1 &&
-      props.design.endpoint.path.includes("{actorId}")
-    ) {
-      props.design.endpoint.path = props.design.endpoint.path.replace(
-        "{actorId}",
-        "",
-      );
-    }
-    return props.design;
-  };
-
-  export const fixPath = (path: string): string => {
-    return path
-      .split("/")
-      .map((s) =>
-        s.startsWith("{") && s.endsWith("}")
-          ? `{${NamingConvention.camel(s.slice(1, -1).replace(/-/g, "_"))}}`
-          : s,
-      )
-      .join("/");
-  };
-
-  export const fixApplication = (props: {
-    application: ILlmApplication;
-    actors: AutoBeAnalyze.IActor[];
-  }): void => {
-    const $defs: Record<string, ILlmSchema> =
-      props.application.functions[0].parameters.$defs;
-    const design: ILlmSchema | undefined =
-      $defs[typia.reflect.name<AutoBeInterfaceEndpointDesign>()];
-    if (design === undefined)
-      throw new Error("AutoBeInterfaceEndpointDesign is undefined");
-    else if (LlmTypeChecker.isObject(design) === false)
-      throw new Error("AutoBeInterfaceEndpointDesign is not object type");
-
-    const property: ILlmSchema | undefined =
-      design.properties["authorizationActors"];
-    if (property === undefined)
-      throw new Error(
-        "AutoBeInterfaceEndpointDesign.authorizationActors is undefined",
-      );
-    else if (LlmTypeChecker.isArray(property) === false)
-      throw new Error(
-        "AutoBeInterfaceEndpointDesign.authorizationActors is not array type",
-      );
-    property.items = {
-      type: "string",
-      enum: props.actors.map((actor) => actor.name),
-    };
-  };
-
-  export const validateDesign = (props: {
-    design: AutoBeInterfaceEndpointDesign;
-    actors: AutoBeAnalyze.IActor[];
-    path: string;
-    errors: IValidation.IError[];
-  }): void => {
-    // if (props.actors.length === 0) props.design.authorizationActors = [];
-
-    props.design.authorizationActors.forEach((actorName, i) => {
-      if (props.actors.find((actor) => actor.name === actorName) === undefined)
-        props.errors.push({
-          path: `${props.path}.authorizationActors[${i}]`,
-          expected: props.actors.map((a) => JSON.stringify(a.name)).join(" | "),
-          value: actorName,
-          description: StringUtil.trim`
-            Actor "${actorName}" is not defined in the roles list.
-
-            Please select one of them below, or do not define (\`null\`):
-
-            ${props.actors.map((actor) => `- ${actor.name}`).join("\n")}
-          `,
-        });
-    });
-  };
-}
+import {
+  AutoBeAnalyze,
+  AutoBeInterfaceEndpointDesign,
+} from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+import { LlmTypeChecker, NamingConvention } from "@typia/utils";
+import { singular } from "pluralize";
+import typia, { ILlmApplication, ILlmSchema, IValidation } from "typia";
+
+export namespace AutoBeInterfaceEndpointProgrammer {
+  /**
+   * Filter endpoint designs:
+   *
+   * - For base: Remove guest actors and login/join/refresh/session
+   *   authorizationType
+   * - For action: Remove all non-null authorizationType (action endpoints must be
+   *   null only)
+   */
+  export const filter = (props: {
+    kind: "base" | "action";
+    design: AutoBeInterfaceEndpointDesign;
+    actors: AutoBeAnalyze.IActor[];
+  }): boolean => {
+    // Action endpoints: only allow authorizationType: null
+    if (props.kind === "action") return props.design.authorizationType === null;
+    else if (
+      props.design.endpoint.path === "/auth" ||
+      props.design.endpoint.path.startsWith("/auth/")
+    )
+      return false;
+
+    // remove specific auth types
+    if (
+      props.design.authorizationType === "login" ||
+      props.design.authorizationType === "join" ||
+      props.design.authorizationType === "refresh" ||
+      props.design.authorizationType === "withdraw"
+    )
+      return false;
+    else if (props.design.authorizationType === "session") {
+      props.design.authorizationActors =
+        props.design.authorizationActors.filter((name) => {
+          const actor: AutoBeAnalyze.IActor | undefined = props.actors.find(
+            (a) => a.name === name,
+          );
+          if (actor === undefined) return false;
+          return actor.kind !== "guest";
+        });
+      if (props.design.authorizationActors.length === 0) return false;
+      else if (
+        props.design.endpoint.method !== "get" &&
+        props.design.endpoint.method !== "patch"
+      )
+        return false;
+      return true;
+    }
+    return true;
+  };
+
+  export const fixDesign = (props: {
+    actors: AutoBeAnalyze.IActor[];
+    design: AutoBeInterfaceEndpointDesign;
+  }): AutoBeInterfaceEndpointDesign => {
+    props.design.endpoint.path = fixPath(props.design.endpoint.path);
+    if (props.design.authorizationActors.length === 1) {
+      const actor: AutoBeAnalyze.IActor | undefined = props.actors.find(
+        (a) => a.name === props.design.authorizationActors[0],
+      );
+      if (actor !== undefined && actor.kind !== "admin") {
+        const param: string =
+          NamingConvention.camel(singular(actor.name)) + "Id";
+        const bracket: string = `{${param}}`;
+        if (props.design.endpoint.path.includes(bracket) === true)
+          props.design.endpoint.path = props.design.endpoint.path.replace(
+            bracket,
+            "",
+          );
+      }
+    } else if (
+      props.design.authorizationActors.length > 1 &&
+      props.design.endpoint.path.includes("{actorId}")
+    ) {
+      props.design.endpoint.path = props.design.endpoint.path.replace(
+        "{actorId}",
+        "",
+      );
+    }
+    return props.design;
+  };
+
+  export const fixPath = (path: string): string => {
+    return path
+      .split("/")
+      .map((s) =>
+        s.startsWith("{") && s.endsWith("}")
+          ? `{${NamingConvention.camel(s.slice(1, -1).replace(/-/g, "_"))}}`
+          : s,
+      )
+      .join("/");
+  };
+
+  export const fixApplication = (props: {
+    application: ILlmApplication;
+    actors: AutoBeAnalyze.IActor[];
+  }): void => {
+    const $defs: Record<string, ILlmSchema> =
+      props.application.functions[0].parameters.$defs;
+    const design: ILlmSchema | undefined =
+      $defs[typia.reflect.name<AutoBeInterfaceEndpointDesign>()];
+    if (design === undefined)
+      throw new Error("AutoBeInterfaceEndpointDesign is undefined");
+    else if (LlmTypeChecker.isObject(design) === false)
+      throw new Error("AutoBeInterfaceEndpointDesign is not object type");
+
+    const property: ILlmSchema | undefined =
+      design.properties["authorizationActors"];
+    if (property === undefined)
+      throw new Error(
+        "AutoBeInterfaceEndpointDesign.authorizationActors is undefined",
+      );
+    else if (LlmTypeChecker.isArray(property) === false)
+      throw new Error(
+        "AutoBeInterfaceEndpointDesign.authorizationActors is not array type",
+      );
+    property.items = {
+      type: "string",
+      enum: props.actors.map((actor) => actor.name),
+    };
+  };
+
+  export const validateDesign = (props: {
+    design: AutoBeInterfaceEndpointDesign;
+    actors: AutoBeAnalyze.IActor[];
+    path: string;
+    errors: IValidation.IError[];
+  }): void => {
+    // if (props.actors.length === 0) props.design.authorizationActors = [];
+
+    props.design.authorizationActors.forEach((actorName, i) => {
+      if (props.actors.find((actor) => actor.name === actorName) === undefined)
+        props.errors.push({
+          path: `${props.path}.authorizationActors[${i}]`,
+          expected: props.actors.map((a) => JSON.stringify(a.name)).join(" | "),
+          value: actorName,
+          description: StringUtil.trim`
+            Actor "${actorName}" is not defined in the roles list.
+
+            Please select one of them below, or do not define (\`null\`):
+
+            ${props.actors.map((actor) => `- ${actor.name}`).join("\n")}
+          `,
+        });
+    });
+  };
+}

package/src/orchestrate/interface/programmers/AutoBeInterfaceEndpointReviewProgrammer.ts

@@ -1,139 +1,139 @@
-import {
-  AutoBeAnalyze,
-  AutoBeInterfaceEndpointDesign,
-  AutoBeInterfaceEndpointRevise,
-} from "@autobe/interface";
-import { AutoBeOpenApiEndpointComparator, StringUtil } from "@autobe/utils";
-import { IValidation } from "typia";
-
-import { AutoBeInterfaceEndpointProgrammer } from "./AutoBeInterfaceEndpointProgrammer";
-
-export namespace AutoBeInterfaceEndpointReviewProgrammer {
-  export const validate = (props: {
-    path: string;
-    errors: IValidation.IError[];
-    actors: AutoBeAnalyze.IActor[];
-    designs: AutoBeInterfaceEndpointDesign[];
-    revises: AutoBeInterfaceEndpointRevise[];
-  }): void => {
-    props.revises.forEach((revise, i) => {
-      // check endpoint existence
-      if ("endpoint" in revise) {
-        const found: AutoBeInterfaceEndpointDesign | undefined =
-          props.designs.find((d) =>
-            AutoBeOpenApiEndpointComparator.equals(d.endpoint, revise.endpoint),
-          );
-        if (found === undefined)
-          props.errors.push({
-            path: `${props.path}[${i}].endpoint`,
-            expected: `An endpoint matching one of the provided designs (path + method)`,
-            value: revise.endpoint,
-            description: StringUtil.trim`
-              The endpoint referenced in this revision does not exist in the
-              provided designs list.
-
-              You can only use keep, update, or erase for endpoints that were
-              given to you for review. Check the path and method carefully -
-              they must match exactly.
-
-              If you want to add a new endpoint that doesn't exist yet, use the
-              "create" revision type instead.
-
-              Here are all valid endpoints you can reference:
-
-              | Method | Path |
-              |--------|------|
-              ${props.designs.map((d) => `| ${d.endpoint.method} | ${d.endpoint.path} |`).join("\n")}
-            `,
-          });
-      }
-
-      // individual cases
-      if (revise.type === "create")
-        AutoBeInterfaceEndpointProgrammer.validateDesign({
-          design: revise.design,
-          actors: props.actors,
-          errors: props.errors,
-          path: `${props.path}[${i}].design`,
-        });
-      else if (revise.type === "update")
-        AutoBeInterfaceEndpointProgrammer.validateDesign({
-          design: revise.newDesign,
-          actors: props.actors,
-          errors: props.errors,
-          path: `${props.path}[${i}].newDesign`,
-        });
-      else if (revise.type === "erase" || revise.type === "keep") {
-      } else revise satisfies never;
-    });
-
-    // check omissions
-    for (const design of props.designs) {
-      const found: AutoBeInterfaceEndpointRevise | undefined =
-        props.revises.find((revise) => {
-          if ("endpoint" in revise)
-            return AutoBeOpenApiEndpointComparator.equals(
-              design.endpoint,
-              revise.endpoint,
-            );
-          else return false;
-        });
-      if (found === undefined)
-        props.errors.push({
-          path: `${props.path}[]`,
-          value: undefined,
-          expected: `AutoBeInterfaceEndpointRevise (corresponding to the design with path: ${design.endpoint.path} and method: ${design.endpoint.method})`,
-          description: StringUtil.trim`
-            Every endpoint in the provided designs list MUST have a
-            corresponding revision.
-
-            You cannot omit any endpoint - if an endpoint is correct and needs
-            no changes, use the "keep" revision type to explicitly approve it.
-
-            This ensures complete review coverage with no accidentally skipped
-            endpoints.
-          `,
-        });
-    }
-  };
-
-  export const execute = (props: {
-    kind: "base" | "action";
-    actors: AutoBeAnalyze.IActor[];
-    designs: AutoBeInterfaceEndpointDesign[];
-    revises: AutoBeInterfaceEndpointRevise[];
-  }): AutoBeInterfaceEndpointDesign[] => {
-    const output: AutoBeInterfaceEndpointDesign[] = [];
-    for (const revise of props.revises) {
-      if (revise.type === "create")
-        output.push(
-          AutoBeInterfaceEndpointProgrammer.fixDesign({
-            actors: props.actors,
-            design: revise.design,
-          }),
-        );
-      else if (revise.type === "update")
-        output.push(
-          AutoBeInterfaceEndpointProgrammer.fixDesign({
-            actors: props.actors,
-            design: revise.newDesign,
-          }),
-        );
-      else if (revise.type === "keep") {
-        const found: AutoBeInterfaceEndpointDesign | undefined =
-          props.designs.find((d) =>
-            AutoBeOpenApiEndpointComparator.equals(d.endpoint, revise.endpoint),
-          );
-        if (found !== undefined) output.push(found);
-      } else if (revise.type === "erase") {
-      } else revise satisfies never;
-    }
-    return output.filter((design) =>
-      AutoBeInterfaceEndpointProgrammer.filter({
-        kind: props.kind,
-        actors: props.actors,
-        design,
-      }),
-    );
-  };
-}
+import {
+  AutoBeAnalyze,
+  AutoBeInterfaceEndpointDesign,
+  AutoBeInterfaceEndpointRevise,
+} from "@autobe/interface";
+import { AutoBeOpenApiEndpointComparator, StringUtil } from "@autobe/utils";
+import { IValidation } from "typia";
+
+import { AutoBeInterfaceEndpointProgrammer } from "./AutoBeInterfaceEndpointProgrammer";
+
+export namespace AutoBeInterfaceEndpointReviewProgrammer {
+  export const validate = (props: {
+    path: string;
+    errors: IValidation.IError[];
+    actors: AutoBeAnalyze.IActor[];
+    designs: AutoBeInterfaceEndpointDesign[];
+    revises: AutoBeInterfaceEndpointRevise[];
+  }): void => {
+    props.revises.forEach((revise, i) => {
+      // check endpoint existence
+      if ("endpoint" in revise) {
+        const found: AutoBeInterfaceEndpointDesign | undefined =
+          props.designs.find((d) =>
+            AutoBeOpenApiEndpointComparator.equals(d.endpoint, revise.endpoint),
+          );
+        if (found === undefined)
+          props.errors.push({
+            path: `${props.path}[${i}].endpoint`,
+            expected: `An endpoint matching one of the provided designs (path + method)`,
+            value: revise.endpoint,
+            description: StringUtil.trim`
+              The endpoint referenced in this revision does not exist in the
+              provided designs list.
+
+              You can only use keep, update, or erase for endpoints that were
+              given to you for review. Check the path and method carefully -
+              they must match exactly.
+
+              If you want to add a new endpoint that doesn't exist yet, use the
+              "create" revision type instead.
+
+              Here are all valid endpoints you can reference:
+
+              | Method | Path |
+              |--------|------|
+              ${props.designs.map((d) => `| ${d.endpoint.method} | ${d.endpoint.path} |`).join("\n")}
+            `,
+          });
+      }
+
+      // individual cases
+      if (revise.type === "create")
+        AutoBeInterfaceEndpointProgrammer.validateDesign({
+          design: revise.design,
+          actors: props.actors,
+          errors: props.errors,
+          path: `${props.path}[${i}].design`,
+        });
+      else if (revise.type === "update")
+        AutoBeInterfaceEndpointProgrammer.validateDesign({
+          design: revise.newDesign,
+          actors: props.actors,
+          errors: props.errors,
+          path: `${props.path}[${i}].newDesign`,
+        });
+      else if (revise.type === "erase" || revise.type === "keep") {
+      } else revise satisfies never;
+    });
+
+    // check omissions
+    for (const design of props.designs) {
+      const found: AutoBeInterfaceEndpointRevise | undefined =
+        props.revises.find((revise) => {
+          if ("endpoint" in revise)
+            return AutoBeOpenApiEndpointComparator.equals(
+              design.endpoint,
+              revise.endpoint,
+            );
+          else return false;
+        });
+      if (found === undefined)
+        props.errors.push({
+          path: `${props.path}[]`,
+          value: undefined,
+          expected: `AutoBeInterfaceEndpointRevise (corresponding to the design with path: ${design.endpoint.path} and method: ${design.endpoint.method})`,
+          description: StringUtil.trim`
+            Every endpoint in the provided designs list MUST have a
+            corresponding revision.
+
+            You cannot omit any endpoint - if an endpoint is correct and needs
+            no changes, use the "keep" revision type to explicitly approve it.
+
+            This ensures complete review coverage with no accidentally skipped
+            endpoints.
+          `,
+        });
+    }
+  };
+
+  export const execute = (props: {
+    kind: "base" | "action";
+    actors: AutoBeAnalyze.IActor[];
+    designs: AutoBeInterfaceEndpointDesign[];
+    revises: AutoBeInterfaceEndpointRevise[];
+  }): AutoBeInterfaceEndpointDesign[] => {
+    const output: AutoBeInterfaceEndpointDesign[] = [];
+    for (const revise of props.revises) {
+      if (revise.type === "create")
+        output.push(
+          AutoBeInterfaceEndpointProgrammer.fixDesign({
+            actors: props.actors,
+            design: revise.design,
+          }),
+        );
+      else if (revise.type === "update")
+        output.push(
+          AutoBeInterfaceEndpointProgrammer.fixDesign({
+            actors: props.actors,
+            design: revise.newDesign,
+          }),
+        );
+      else if (revise.type === "keep") {
+        const found: AutoBeInterfaceEndpointDesign | undefined =
+          props.designs.find((d) =>
+            AutoBeOpenApiEndpointComparator.equals(d.endpoint, revise.endpoint),
+          );
+        if (found !== undefined) output.push(found);
+      } else if (revise.type === "erase") {
+      } else revise satisfies never;
+    }
+    return output.filter((design) =>
+      AutoBeInterfaceEndpointProgrammer.filter({
+        kind: props.kind,
+        actors: props.actors,
+        design,
+      }),
+    );
+  };
+}