@autobe/agent 0.30.0-dev.20260315 → 0.30.1

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

@@ -1,78 +1,78 @@
-import { AutoBeInterfaceGroup, AutoBeOpenApi } from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-import { v7 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
-import { AutoBeState } from "../../../context/AutoBeState";
-import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
-import { AutoBePreliminaryController } from "../../common/AutoBePreliminaryController";
-import { transformInterfaceEndpointAuthorizationSection } from "./transformInterfaceEndpointAuthorizationSection";
-
-export const transformInterfaceActionEndpointWriteHistory = (props: {
-  state: AutoBeState;
-  group: AutoBeInterfaceGroup;
-  baseEndpoints: AutoBeOpenApi.IEndpoint[];
-  preliminary: AutoBePreliminaryController<
-    | "analysisSections"
-    | "databaseSchemas"
-    | "previousAnalysisSections"
-    | "previousDatabaseSchemas"
-    | "previousInterfaceOperations"
-  >;
-  authorizeOperations: AutoBeOpenApi.IOperation[];
-  instruction: string;
-}): IAutoBeOrchestrateHistory => ({
-  histories: [
-    {
-      type: "systemMessage",
-      id: v7(),
-      created_at: new Date().toISOString(),
-      text: AutoBeSystemPromptConstant.INTERFACE_ACTION_ENDPOINT_WRITE,
-    },
-    ...props.preliminary.getHistories(),
-    {
-      type: "assistantMessage",
-      id: v7(),
-      created_at: new Date().toISOString(),
-      text: StringUtil.trim`
-        ## API Design Instructions (Reference)
-
-        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.
-
-        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}
-
-        ## Base CRUD Endpoints (Reference - Already Exist)
-
-        These base CRUD endpoints already exist. Do NOT create similar endpoints.
-        Action endpoints should complement these, not duplicate them:
-
-        \`\`\`json
-        ${JSON.stringify(props.baseEndpoints)}
-        \`\`\`
-
-        ${transformInterfaceEndpointAuthorizationSection(props.authorizeOperations)}
-        
-        ## Target Group for Design (YOUR TASK)
-
-        You are designing action endpoints for the **${props.group.name}** group.
-
-        \`\`\`json
-        ${JSON.stringify(props.group)}
-        \`\`\`
-
-        Design action endpoints that fulfill the requirements for this group.
-        `,
-    },
-  ],
-  userMessage: `Design action endpoints for the ${props.group.name} group please`,
-});
+import { AutoBeInterfaceGroup, AutoBeOpenApi } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+import { v7 } from "uuid";
+
+import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
+import { AutoBeState } from "../../../context/AutoBeState";
+import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
+import { AutoBePreliminaryController } from "../../common/AutoBePreliminaryController";
+import { transformInterfaceEndpointAuthorizationSection } from "./transformInterfaceEndpointAuthorizationSection";
+
+export const transformInterfaceActionEndpointWriteHistory = (props: {
+  state: AutoBeState;
+  group: AutoBeInterfaceGroup;
+  baseEndpoints: AutoBeOpenApi.IEndpoint[];
+  preliminary: AutoBePreliminaryController<
+    | "analysisSections"
+    | "databaseSchemas"
+    | "previousAnalysisSections"
+    | "previousDatabaseSchemas"
+    | "previousInterfaceOperations"
+  >;
+  authorizeOperations: AutoBeOpenApi.IOperation[];
+  instruction: string;
+}): IAutoBeOrchestrateHistory => ({
+  histories: [
+    {
+      type: "systemMessage",
+      id: v7(),
+      created_at: new Date().toISOString(),
+      text: AutoBeSystemPromptConstant.INTERFACE_ACTION_ENDPOINT_WRITE,
+    },
+    ...props.preliminary.getHistories(),
+    {
+      type: "assistantMessage",
+      id: v7(),
+      created_at: new Date().toISOString(),
+      text: StringUtil.trim`
+        ## API Design Instructions (Reference)
+
+        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.
+
+        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}
+
+        ## Base CRUD Endpoints (Reference - Already Exist)
+
+        These base CRUD endpoints already exist. Do NOT create similar endpoints.
+        Action endpoints should complement these, not duplicate them:
+
+        \`\`\`json
+        ${JSON.stringify(props.baseEndpoints)}
+        \`\`\`
+
+        ${transformInterfaceEndpointAuthorizationSection(props.authorizeOperations)}
+        
+        ## Target Group for Design (YOUR TASK)
+
+        You are designing action endpoints for the **${props.group.name}** group.
+
+        \`\`\`json
+        ${JSON.stringify(props.group)}
+        \`\`\`
+
+        Design action endpoints that fulfill the requirements for this group.
+        `,
+    },
+  ],
+  userMessage: `Design action endpoints for the ${props.group.name} group please`,
+});

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

@@ -1,129 +1,129 @@
-import { AutoBeAnalyze, AutoBeAnalyzeHistory } from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-import { NamingConvention } from "@typia/utils";
-import { v7 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
-import { AutoBeState } from "../../../context/AutoBeState";
-import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
-import { AutoBePreliminaryController } from "../../common/AutoBePreliminaryController";
-import { AutoBeInterfaceAuthorizationProgrammer } from "../programmers/AutoBeInterfaceAuthorizationProgrammer";
-
-export const transformInterfaceAuthorizationHistory = (props: {
-  state: AutoBeState;
-  prefix: string;
-  actor: AutoBeAnalyze.IActor;
-  preliminary: AutoBePreliminaryController<
-    | "analysisSections"
-    | "databaseSchemas"
-    | "previousAnalysisSections"
-    | "previousDatabaseSchemas"
-  >;
-  instruction: string;
-}): IAutoBeOrchestrateHistory => {
-  const analyze: AutoBeAnalyzeHistory = props.state.analyze!;
-  const typeName: string = AutoBeInterfaceAuthorizationProgrammer.getTypeName({
-    prefix: props.prefix,
-    actor: props.actor.name,
-  });
-  const table: string = StringUtil.trim`
-    Authorization Type | Request Body Type | Response Body Type
-    -------------------|-------------------|--------------------
-    ${["join", ...(props.actor.kind !== "guest" ? ["login"] : []), "refresh"]
-      .map((type) =>
-        [
-          type,
-          `${typeName}.I${NamingConvention.pascal(type)}`,
-          `${typeName}.IAuthorized`,
-        ].join(" | "),
-      )
-      .join("\n    ")}
-  `;
-
-  return {
-    histories: [
-      {
-        type: "systemMessage",
-        id: v7(),
-        created_at: new Date().toISOString(),
-        text: AutoBeSystemPromptConstant.INTERFACE_AUTHORIZATION,
-      },
-      ...props.preliminary.getHistories(),
-      {
-        type: "systemMessage",
-        id: v7(),
-        created_at: new Date().toISOString(),
-        text: StringUtil.trim`
-          ## Service Prefix
-          - Original: ${analyze.prefix}
-          - PascalCase for DTOs: ${analyze.prefix
-            .split(/[-_]/)
-            .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
-            .join("")}
-          - Expected DTO pattern: I${analyze.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 authorization operations for ${props.actor.name}.
-          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}
-
-          ## Actor
-
-          You have to make API operations for the given actor:
-
-          \`\`\`json
-          ${JSON.stringify(props.actor)}
-          \`\`\`
-
-          ## Authorization Operations Table
-
-          The table below specifies the required authorization operations and their **exact type names**.
-          These type names are pre-determined based on the service prefix and actor name - do NOT deviate from them.
-
-          Each column means:
-          - **Authorization Type**: The value for \`AutoBeOpenApi.IOperation.authorizationType\` (one of \`"join"\`, \`"login"\`, or \`"refresh"\`)
-          - **Request Body Type Name**: The exact DTO type name for \`requestBody.typeName\`
-          - **Response Body Type Name**: The exact DTO type name for \`responseBody.typeName\` (always \`IAuthorized\` containing tokens)
-
-          ${table}
-
-          ${
-            props.actor.kind === "guest"
-              ? "> This actor is `guest` kind, so `login` operation is excluded. Guests authenticate via join/refresh only."
-              : ""
-          }
-
-          **⚠️ MANDATORY REQUIREMENT**: You MUST generate ALL operations listed in the table above.
-          Every single row represents a required operation - do NOT skip or omit any of them.
-          The validator will reject your output if any operation is missing.
-
-          When you create each operation's request/response body schemas,
-          you MUST use these exact type names. The validator will reject any
-          operation that does not match these specifications exactly.
-        `,
-      },
-    ],
-    userMessage: `Make authorization operations for ${props.actor.name} actor please`,
-  };
-};
+import { AutoBeAnalyze, AutoBeAnalyzeHistory } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+import { NamingConvention } from "@typia/utils";
+import { v7 } from "uuid";
+
+import { AutoBeSystemPromptConstant } from "../../../constants/AutoBeSystemPromptConstant";
+import { AutoBeState } from "../../../context/AutoBeState";
+import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
+import { AutoBePreliminaryController } from "../../common/AutoBePreliminaryController";
+import { AutoBeInterfaceAuthorizationProgrammer } from "../programmers/AutoBeInterfaceAuthorizationProgrammer";
+
+export const transformInterfaceAuthorizationHistory = (props: {
+  state: AutoBeState;
+  prefix: string;
+  actor: AutoBeAnalyze.IActor;
+  preliminary: AutoBePreliminaryController<
+    | "analysisSections"
+    | "databaseSchemas"
+    | "previousAnalysisSections"
+    | "previousDatabaseSchemas"
+  >;
+  instruction: string;
+}): IAutoBeOrchestrateHistory => {
+  const analyze: AutoBeAnalyzeHistory = props.state.analyze!;
+  const typeName: string = AutoBeInterfaceAuthorizationProgrammer.getTypeName({
+    prefix: props.prefix,
+    actor: props.actor.name,
+  });
+  const table: string = StringUtil.trim`
+    Authorization Type | Request Body Type | Response Body Type
+    -------------------|-------------------|--------------------
+    ${["join", ...(props.actor.kind !== "guest" ? ["login"] : []), "refresh"]
+      .map((type) =>
+        [
+          type,
+          `${typeName}.I${NamingConvention.pascal(type)}`,
+          `${typeName}.IAuthorized`,
+        ].join(" | "),
+      )
+      .join("\n    ")}
+  `;
+
+  return {
+    histories: [
+      {
+        type: "systemMessage",
+        id: v7(),
+        created_at: new Date().toISOString(),
+        text: AutoBeSystemPromptConstant.INTERFACE_AUTHORIZATION,
+      },
+      ...props.preliminary.getHistories(),
+      {
+        type: "systemMessage",
+        id: v7(),
+        created_at: new Date().toISOString(),
+        text: StringUtil.trim`
+          ## Service Prefix
+          - Original: ${analyze.prefix}
+          - PascalCase for DTOs: ${analyze.prefix
+            .split(/[-_]/)
+            .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+            .join("")}
+          - Expected DTO pattern: I${analyze.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 authorization operations for ${props.actor.name}.
+          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}
+
+          ## Actor
+
+          You have to make API operations for the given actor:
+
+          \`\`\`json
+          ${JSON.stringify(props.actor)}
+          \`\`\`
+
+          ## Authorization Operations Table
+
+          The table below specifies the required authorization operations and their **exact type names**.
+          These type names are pre-determined based on the service prefix and actor name - do NOT deviate from them.
+
+          Each column means:
+          - **Authorization Type**: The value for \`AutoBeOpenApi.IOperation.authorizationType\` (one of \`"join"\`, \`"login"\`, or \`"refresh"\`)
+          - **Request Body Type Name**: The exact DTO type name for \`requestBody.typeName\`
+          - **Response Body Type Name**: The exact DTO type name for \`responseBody.typeName\` (always \`IAuthorized\` containing tokens)
+
+          ${table}
+
+          ${
+            props.actor.kind === "guest"
+              ? "> This actor is `guest` kind, so `login` operation is excluded. Guests authenticate via join/refresh only."
+              : ""
+          }
+
+          **⚠️ MANDATORY REQUIREMENT**: You MUST generate ALL operations listed in the table above.
+          Every single row represents a required operation - do NOT skip or omit any of them.
+          The validator will reject your output if any operation is missing.
+
+          When you create each operation's request/response body schemas,
+          you MUST use these exact type names. The validator will reject any
+          operation that does not match these specifications exactly.
+        `,
+      },
+    ],
+    userMessage: `Make authorization operations for ${props.actor.name} actor please`,
+  };
+};

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

@@ -1,74 +1,74 @@
-import {
-  AutoBeInterfaceEndpointDesign,
-  AutoBeInterfaceGroup,
-  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";
-import { transformInterfaceEndpointAuthorizationSection } from "./transformInterfaceEndpointAuthorizationSection";
-
-export const transformInterfaceBaseEndpointReviewHistory = (props: {
-  preliminary: AutoBePreliminaryController<
-    | "analysisSections"
-    | "databaseSchemas"
-    | "previousAnalysisSections"
-    | "previousDatabaseSchemas"
-    | "previousInterfaceOperations"
-  >;
-  designs: AutoBeInterfaceEndpointDesign[];
-  group: AutoBeInterfaceGroup;
-  authorizeOperations: AutoBeOpenApi.IOperation[];
-}): IAutoBeOrchestrateHistory => ({
-  histories: [
-    {
-      type: "systemMessage",
-      id: v7(),
-      created_at: new Date().toISOString(),
-      text: AutoBeSystemPromptConstant.INTERFACE_BASE_ENDPOINT_WRITE,
-    },
-    {
-      type: "systemMessage",
-      id: v7(),
-      created_at: new Date().toISOString(),
-      text: AutoBeSystemPromptConstant.INTERFACE_BASE_ENDPOINT_REVIEW,
-    },
-    ...props.preliminary.getHistories(),
-    {
-      id: v7(),
-      type: "assistantMessage",
-      text: StringUtil.trim`
-        ## Target Group
-
-        You are reviewing endpoints for the **${props.group.name}** group.
-
-        - **Description**: ${props.group.description}
-        - **Related Database Schemas**: ${props.group.databaseSchemas.join(", ")}
-
-        ${transformInterfaceEndpointAuthorizationSection(props.authorizeOperations)}
-        
-        ## Base CRUD Endpoint Designs for Review (YOUR TASK)
-
-        ⚠️ CRITICAL: You MUST provide a revision for EVERY endpoint listed below.
-
-        - Use **keep** to approve endpoints that are correct
-        - Use **update** to fix endpoints with issues
-        - Use **erase** to remove invalid endpoints
-        - Use **create** to add missing endpoints
-
-        DO NOT omit any endpoint. DO NOT reference endpoints not listed here.
-
-        \`\`\`json
-        ${JSON.stringify(props.designs)}
-        \`\`\`
-
-        Review according to the criteria in the system prompt. Call \`process()\` with \`type: "complete"\` containing all \`revises\`.
-      `,
-      created_at: new Date().toISOString(),
-    },
-  ],
-  userMessage: `Review the base CRUD endpoints for the ${props.group.name} group and fix any issues found.`,
-});
+import {
+  AutoBeInterfaceEndpointDesign,
+  AutoBeInterfaceGroup,
+  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";
+import { transformInterfaceEndpointAuthorizationSection } from "./transformInterfaceEndpointAuthorizationSection";
+
+export const transformInterfaceBaseEndpointReviewHistory = (props: {
+  preliminary: AutoBePreliminaryController<
+    | "analysisSections"
+    | "databaseSchemas"
+    | "previousAnalysisSections"
+    | "previousDatabaseSchemas"
+    | "previousInterfaceOperations"
+  >;
+  designs: AutoBeInterfaceEndpointDesign[];
+  group: AutoBeInterfaceGroup;
+  authorizeOperations: AutoBeOpenApi.IOperation[];
+}): IAutoBeOrchestrateHistory => ({
+  histories: [
+    {
+      type: "systemMessage",
+      id: v7(),
+      created_at: new Date().toISOString(),
+      text: AutoBeSystemPromptConstant.INTERFACE_BASE_ENDPOINT_WRITE,
+    },
+    {
+      type: "systemMessage",
+      id: v7(),
+      created_at: new Date().toISOString(),
+      text: AutoBeSystemPromptConstant.INTERFACE_BASE_ENDPOINT_REVIEW,
+    },
+    ...props.preliminary.getHistories(),
+    {
+      id: v7(),
+      type: "assistantMessage",
+      text: StringUtil.trim`
+        ## Target Group
+
+        You are reviewing endpoints for the **${props.group.name}** group.
+
+        - **Description**: ${props.group.description}
+        - **Related Database Schemas**: ${props.group.databaseSchemas.join(", ")}
+
+        ${transformInterfaceEndpointAuthorizationSection(props.authorizeOperations)}
+        
+        ## Base CRUD Endpoint Designs for Review (YOUR TASK)
+
+        ⚠️ CRITICAL: You MUST provide a revision for EVERY endpoint listed below.
+
+        - Use **keep** to approve endpoints that are correct
+        - Use **update** to fix endpoints with issues
+        - Use **erase** to remove invalid endpoints
+        - Use **create** to add missing endpoints
+
+        DO NOT omit any endpoint. DO NOT reference endpoints not listed here.
+
+        \`\`\`json
+        ${JSON.stringify(props.designs)}
+        \`\`\`
+
+        Review according to the criteria in the system prompt. Call \`process()\` with \`type: "complete"\` containing all \`revises\`.
+      `,
+      created_at: new Date().toISOString(),
+    },
+  ],
+  userMessage: `Review the base CRUD endpoints for the ${props.group.name} group and fix any issues found.`,
+});