@autobe/agent 0.30.0-dev.20260315 → 0.30.0

package/src/orchestrate/interface/histories/transformInterfaceOperationHistory.ts

@@ -1,81 +1,81 @@
-import { AutoBeOpenApi } from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-import { v7 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
-import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
-import { AutoBePreliminaryController } from "../../common/AutoBePreliminaryController";
-
-export const transformInterfaceOperationHistory = (props: {
-  prefix: string;
-  endpoint: AutoBeOpenApi.IEndpoint;
-  preliminary: AutoBePreliminaryController<
-    | "analysisSections"
-    | "databaseSchemas"
-    | "previousAnalysisSections"
-    | "previousDatabaseSchemas"
-    | "previousInterfaceOperations"
-  >;
-  instruction: string;
-}): IAutoBeOrchestrateHistory => {
-  return {
-    histories: [
-      {
-        type: "systemMessage",
-        id: v7(),
-        created_at: new Date().toISOString(),
-        text: AutoBeSystemPromptConstant.INTERFACE_OPERATION,
-      },
-      ...props.preliminary.getHistories(),
-      {
-        type: "systemMessage",
-        id: v7(),
-        created_at: new Date().toISOString(),
-        text: StringUtil.trim`
-          ## Service Prefix
-          - Original: ${props.prefix}
-          - PascalCase for DTOs: ${props.prefix
-            .split(/[-_]/)
-            .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
-            .join("")}
-          - Expected DTO pattern: I${props.prefix
-            .split(/[-_]/)
-            .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
-            .join("")}{EntityName}
-        `,
-      },
-      {
-        type: "assistantMessage",
-        id: v7(),
-        created_at: new Date().toISOString(),
-        text: StringUtil.trim`
-          ## API Design Instructions
-
-          The following API-specific instructions were extracted from
-          the user's requirements. These focus on API interface design aspects
-          such as endpoint patterns, request/response formats, DTO schemas,
-          and operation specifications.
-
-          Follow these instructions when designing operation specifications.
-          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}
-
-          ## Operation
-
-          You have to make an API operation for the given endpoint:
-
-          - path: ${props.endpoint.path}
-          - method: ${props.endpoint.method}
-        `,
-      },
-    ],
-    userMessage:
-      "Create an API operation specification for the given endpoint please",
-  };
-};
+import { AutoBeOpenApi } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
+
+import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
+import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
+import { AutoBePreliminaryController } from "../../common/AutoBePreliminaryController";
+
+export const transformInterfaceOperationHistory = (props: {
+  prefix: string;
+  endpoint: AutoBeOpenApi.IEndpoint;
+  preliminary: AutoBePreliminaryController<
+    | "analysisSections"
+    | "databaseSchemas"
+    | "previousAnalysisSections"
+    | "previousDatabaseSchemas"
+    | "previousInterfaceOperations"
+  >;
+  instruction: string;
+}): IAutoBeOrchestrateHistory => {
+  return {
+    histories: [
+      {
+        type: "systemMessage",
+        id: v7(),
+        created_at: new Date().toISOString(),
+        text: AutoBeSystemPromptConstant.INTERFACE_OPERATION,
+      },
+      ...props.preliminary.getHistories(),
+      {
+        type: "systemMessage",
+        id: v7(),
+        created_at: new Date().toISOString(),
+        text: StringUtil.trim`
+          ## Service Prefix
+          - Original: ${props.prefix}
+          - PascalCase for DTOs: ${props.prefix
+            .split(/[-_]/)
+            .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+            .join("")}
+          - Expected DTO pattern: I${props.prefix
+            .split(/[-_]/)
+            .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+            .join("")}{EntityName}
+        `,
+      },
+      {
+        type: "assistantMessage",
+        id: v7(),
+        created_at: new Date().toISOString(),
+        text: StringUtil.trim`
+          ## API Design Instructions
+
+          The following API-specific instructions were extracted from
+          the user's requirements. These focus on API interface design aspects
+          such as endpoint patterns, request/response formats, DTO schemas,
+          and operation specifications.
+
+          Follow these instructions when designing operation specifications.
+          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}
+
+          ## Operation
+
+          You have to make an API operation for the given endpoint:
+
+          - path: ${props.endpoint.path}
+          - method: ${props.endpoint.method}
+        `,
+      },
+    ],
+    userMessage:
+      "Create an API operation specification for the given endpoint please",
+  };
+};

package/src/orchestrate/interface/histories/transformInterfaceOperationParameterHistory.ts

@@ -1,53 +1,53 @@
-import { AutoBeOpenApi } from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-
-export const transformInterfaceOperationParameterHistory = (props: {
-  typeName: string;
-  operations: AutoBeOpenApi.IOperation[];
-}): string => {
-  const operations: AutoBeOpenApi.IOperation[] = props.operations.filter(
-    (op) => op.requestBody?.typeName === props.typeName,
-  );
-  if (operations.length === 0) return "";
-
-  const actors: Set<string> = new Set(
-    operations.map((op) => op.authorizationActor).filter((s) => s !== null),
-  );
-  return [writeActor(Array.from(actors)), writeOperations(operations)]
-    .filter((s) => s !== null)
-    .join("\n\n");
-};
-
-function writeActor(actors: string[]): string | null {
-  if (actors.length === 0) return null;
-  return StringUtil.trim`
-    ### Authorization Actors
-
-    These following actors and their sessions are coming from 
-    the JWT authorization token, so you don't need to define them 
-    in the request body schema.
-
-    ${actors.map((a) => `- ${a}`).join("\n")}
-  `;
-}
-
-function writeOperations(
-  operations: AutoBeOpenApi.IOperation[],
-): string | null {
-  operations = operations.filter((op) => op.parameters.length !== 0);
-  if (operations.length === 0) return null;
-  return StringUtil.trim`
-    ### Path Parameters
-
-    These following path parameters are defined for the operations,
-    so you don't need to define them in the request body schema.
-
-    ${operations
-      .map((op) => [
-        `- ${op.method.toUpperCase()} ${op.path}`,
-        ...op.parameters.map((p) => `  - \`${p.name}\``),
-      ])
-      .flat()
-      .join("\n")}
-  `;
-}
+import { AutoBeOpenApi } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+
+export const transformInterfaceOperationParameterHistory = (props: {
+  typeName: string;
+  operations: AutoBeOpenApi.IOperation[];
+}): string => {
+  const operations: AutoBeOpenApi.IOperation[] = props.operations.filter(
+    (op) => op.requestBody?.typeName === props.typeName,
+  );
+  if (operations.length === 0) return "";
+
+  const actors: Set<string> = new Set(
+    operations.map((op) => op.authorizationActor).filter((s) => s !== null),
+  );
+  return [writeActor(Array.from(actors)), writeOperations(operations)]
+    .filter((s) => s !== null)
+    .join("\n\n");
+};
+
+function writeActor(actors: string[]): string | null {
+  if (actors.length === 0) return null;
+  return StringUtil.trim`
+    ### Authorization Actors
+
+    These following actors and their sessions are coming from 
+    the JWT authorization token, so you don't need to define them 
+    in the request body schema.
+
+    ${actors.map((a) => `- ${a}`).join("\n")}
+  `;
+}
+
+function writeOperations(
+  operations: AutoBeOpenApi.IOperation[],
+): string | null {
+  operations = operations.filter((op) => op.parameters.length !== 0);
+  if (operations.length === 0) return null;
+  return StringUtil.trim`
+    ### Path Parameters
+
+    These following path parameters are defined for the operations,
+    so you don't need to define them in the request body schema.
+
+    ${operations
+      .map((op) => [
+        `- ${op.method.toUpperCase()} ${op.path}`,
+        ...op.parameters.map((p) => `  - \`${p.name}\``),
+      ])
+      .flat()
+      .join("\n")}
+  `;
+}

package/src/orchestrate/interface/histories/transformInterfaceOperationReviewHistory.ts

@@ -1,49 +1,49 @@
-import { AutoBeOpenApi } from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-import { v7 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
-import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
-import { AutoBePreliminaryController } from "../../common/AutoBePreliminaryController";
-
-export function transformInterfaceOperationReviewHistory(props: {
-  preliminary: AutoBePreliminaryController<
-    | "analysisSections"
-    | "databaseSchemas"
-    | "previousAnalysisSections"
-    | "previousDatabaseSchemas"
-    | "previousInterfaceOperations"
-  >;
-  operation: AutoBeOpenApi.IOperation;
-}): IAutoBeOrchestrateHistory {
-  return {
-    histories: [
-      {
-        type: "systemMessage",
-        id: v7(),
-        created_at: new Date().toISOString(),
-        text: AutoBeSystemPromptConstant.INTERFACE_OPERATION,
-      },
-      {
-        type: "systemMessage",
-        id: v7(),
-        created_at: new Date().toISOString(),
-        text: AutoBeSystemPromptConstant.INTERFACE_OPERATION_REVIEW,
-      },
-      ...props.preliminary.getHistories(),
-      {
-        type: "assistantMessage",
-        id: v7(),
-        created_at: new Date().toISOString(),
-        text: StringUtil.trim`
-          Review the following API operation:
-
-          \`\`\`json
-          ${JSON.stringify(props.operation)}
-          \`\`\`
-        `,
-      },
-    ],
-    userMessage: "Review the following API operation please",
-  };
-}
+import { AutoBeOpenApi } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
+
+import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
+import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
+import { AutoBePreliminaryController } from "../../common/AutoBePreliminaryController";
+
+export function transformInterfaceOperationReviewHistory(props: {
+  preliminary: AutoBePreliminaryController<
+    | "analysisSections"
+    | "databaseSchemas"
+    | "previousAnalysisSections"
+    | "previousDatabaseSchemas"
+    | "previousInterfaceOperations"
+  >;
+  operation: AutoBeOpenApi.IOperation;
+}): IAutoBeOrchestrateHistory {
+  return {
+    histories: [
+      {
+        type: "systemMessage",
+        id: v7(),
+        created_at: new Date().toISOString(),
+        text: AutoBeSystemPromptConstant.INTERFACE_OPERATION,
+      },
+      {
+        type: "systemMessage",
+        id: v7(),
+        created_at: new Date().toISOString(),
+        text: AutoBeSystemPromptConstant.INTERFACE_OPERATION_REVIEW,
+      },
+      ...props.preliminary.getHistories(),
+      {
+        type: "assistantMessage",
+        id: v7(),
+        created_at: new Date().toISOString(),
+        text: StringUtil.trim`
+          Review the following API operation:
+
+          \`\`\`json
+          ${JSON.stringify(props.operation)}
+          \`\`\`
+        `,
+      },
+    ],
+    userMessage: "Review the following API operation please",
+  };
+}

package/src/orchestrate/interface/histories/transformInterfacePrerequisiteHistory.ts

@@ -1,94 +1,94 @@
-import { AutoBeOpenApi } from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-import { OpenApiTypeChecker } from "@typia/utils";
-import { v7 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
-import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
-import { AutoBePreliminaryController } from "../../common/AutoBePreliminaryController";
-import { getReferenceIds } from "../../test/utils/getReferenceIds";
-
-// @todo -> RAG
-export const transformInterfacePrerequisiteHistory = (props: {
-  document: AutoBeOpenApi.IDocument;
-  operation: AutoBeOpenApi.IOperation;
-  preliminary: AutoBePreliminaryController<
-    | "analysisSections"
-    | "databaseSchemas"
-    | "interfaceOperations"
-    | "interfaceSchemas"
-    | "previousAnalysisSections"
-    | "previousDatabaseSchemas"
-    | "previousInterfaceOperations"
-    | "previousInterfaceSchemas"
-  >;
-}): IAutoBeOrchestrateHistory => {
-  const domainSchemas: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive> =
-    {};
-  const visit = (key: string) =>
-    OpenApiTypeChecker.visit({
-      schema: {
-        $ref: `#/components/schemas/${key}`,
-      },
-      components: props.document.components,
-      closure: (next) => {
-        if (OpenApiTypeChecker.isReference(next))
-          domainSchemas[next.$ref.split("/").pop()!] =
-            props.document.components.schemas[next.$ref.split("/").pop()!];
-      },
-    });
-  if (props.operation.requestBody) visit(props.operation.requestBody.typeName);
-  if (props.operation.responseBody)
-    visit(props.operation.responseBody.typeName);
-
-  return {
-    histories: [
-      {
-        type: "systemMessage",
-        id: v7(),
-        created_at: new Date().toISOString(),
-        text: AutoBeSystemPromptConstant.INTERFACE_PREREQUISITE,
-      },
-      ...props.preliminary.getHistories(),
-      {
-        type: "assistantMessage",
-        id: v7(),
-        created_at: new Date().toISOString(),
-        text: StringUtil.trim`
-          ## Target Operation
-
-          Single operation requiring prerequisite analysis.
-
-          Analyze if this operation needs any prerequisites from the available
-          operations above. Add prerequisites only when there are genuine
-          dependencies like resource existence checks or state validations.
-
-          \`\`\`json
-          ${JSON.stringify(props.operation)}
-          \`\`\`
-
-          Also, here is the list of reference IDs found in the target 
-          operation's path parameters.
-
-          ${
-            getReferenceIds({
-              document: props.document,
-              operation: props.operation,
-            })
-              .map((id) => `- ${id}`)
-              .join("\n") || "- None"
-          }
-
-          ### Domain Schemas
-
-          Schema definitions for the target operation.
-
-          \`\`\`json
-          ${JSON.stringify(domainSchemas)}
-          \`\`\`
-        `,
-      },
-    ],
-    userMessage: "Analyze and add operation prerequisites please",
-  };
-};
+import { AutoBeOpenApi } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+import { OpenApiTypeChecker } from "@typia/utils";
+import { v7 } from "uuid";
+
+import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
+import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
+import { AutoBePreliminaryController } from "../../common/AutoBePreliminaryController";
+import { getReferenceIds } from "../../test/utils/getReferenceIds";
+
+// @todo -> RAG
+export const transformInterfacePrerequisiteHistory = (props: {
+  document: AutoBeOpenApi.IDocument;
+  operation: AutoBeOpenApi.IOperation;
+  preliminary: AutoBePreliminaryController<
+    | "analysisSections"
+    | "databaseSchemas"
+    | "interfaceOperations"
+    | "interfaceSchemas"
+    | "previousAnalysisSections"
+    | "previousDatabaseSchemas"
+    | "previousInterfaceOperations"
+    | "previousInterfaceSchemas"
+  >;
+}): IAutoBeOrchestrateHistory => {
+  const domainSchemas: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive> =
+    {};
+  const visit = (key: string) =>
+    OpenApiTypeChecker.visit({
+      schema: {
+        $ref: `#/components/schemas/${key}`,
+      },
+      components: props.document.components,
+      closure: (next) => {
+        if (OpenApiTypeChecker.isReference(next))
+          domainSchemas[next.$ref.split("/").pop()!] =
+            props.document.components.schemas[next.$ref.split("/").pop()!];
+      },
+    });
+  if (props.operation.requestBody) visit(props.operation.requestBody.typeName);
+  if (props.operation.responseBody)
+    visit(props.operation.responseBody.typeName);
+
+  return {
+    histories: [
+      {
+        type: "systemMessage",
+        id: v7(),
+        created_at: new Date().toISOString(),
+        text: AutoBeSystemPromptConstant.INTERFACE_PREREQUISITE,
+      },
+      ...props.preliminary.getHistories(),
+      {
+        type: "assistantMessage",
+        id: v7(),
+        created_at: new Date().toISOString(),
+        text: StringUtil.trim`
+          ## Target Operation
+
+          Single operation requiring prerequisite analysis.
+
+          Analyze if this operation needs any prerequisites from the available
+          operations above. Add prerequisites only when there are genuine
+          dependencies like resource existence checks or state validations.
+
+          \`\`\`json
+          ${JSON.stringify(props.operation)}
+          \`\`\`
+
+          Also, here is the list of reference IDs found in the target 
+          operation's path parameters.
+
+          ${
+            getReferenceIds({
+              document: props.document,
+              operation: props.operation,
+            })
+              .map((id) => `- ${id}`)
+              .join("\n") || "- None"
+          }
+
+          ### Domain Schemas
+
+          Schema definitions for the target operation.
+
+          \`\`\`json
+          ${JSON.stringify(domainSchemas)}
+          \`\`\`
+        `,
+      },
+    ],
+    userMessage: "Analyze and add operation prerequisites please",
+  };
+};