@autobe/agent 0.30.0-dev.20260315 → 0.30.1

package/src/orchestrate/realize/utils/AutoBeRealizeAuthorizationReplaceImport.ts

@@ -1,62 +1,62 @@
-export namespace AutoBeRealizeAuthorizationReplaceImport {
-  export function replaceProviderImport(
-    actor: string,
-    content: string,
-  ): string {
-    let updatedContent = content;
-
-    const actorCapitalized =
-      actor.charAt(0).toUpperCase() + actor.slice(1).toLowerCase();
-
-    const nestjsCommonPattern =
-      /import\s+{\s*[^}]*\s*}\s+from\s+"@nestjs\/common";/g;
-    const nestjsCommonReplacement =
-      'import { ForbiddenException, UnauthorizedException } from "@nestjs/common";';
-
-    const myGlobalPattern = /import\s+{\s*MyGlobal\s*}\s+from\s+[^;]+;/g;
-    const myGlobalReplacement = 'import { MyGlobal } from "../../MyGlobal";';
-
-    const jwtAuthorizePattern =
-      /import\s+{\s*jwtAuthorize\s*}\s+from\s+[^;]+;/g;
-    const jwtAuthorizeReplacement =
-      'import { jwtAuthorize } from "./jwtAuthorize";';
-
-    const payloadPattern = /import\s+{\s*\w*Payload\s*}\s+from\s+[^;]+;/g;
-    const payloadReplacement = `import { ${actorCapitalized}Payload } from "../../decorators/payload/${actorCapitalized}Payload";`;
-
-    updatedContent = updatedContent.replace(
-      nestjsCommonPattern,
-      nestjsCommonReplacement,
-    );
-    updatedContent = updatedContent.replace(
-      myGlobalPattern,
-      myGlobalReplacement,
-    );
-    updatedContent = updatedContent.replace(
-      jwtAuthorizePattern,
-      jwtAuthorizeReplacement,
-    );
-    updatedContent = updatedContent.replace(payloadPattern, payloadReplacement);
-
-    return updatedContent;
-  }
-
-  export function replaceDecoratorImport(
-    actor: string,
-    content: string,
-  ): string {
-    let updatedContent = content;
-
-    const actorLowercase = actor.toLowerCase();
-
-    const authorizePattern = /import\s+{\s*\w*Authorize\s*}\s+from\s+[^;]+;/g;
-    const authorizeReplacement = `import { ${actorLowercase}Authorize } from "../providers/authorize/${actorLowercase}Authorize";`;
-
-    updatedContent = updatedContent.replace(
-      authorizePattern,
-      authorizeReplacement,
-    );
-
-    return updatedContent;
-  }
-}
+export namespace AutoBeRealizeAuthorizationReplaceImport {
+  export function replaceProviderImport(
+    actor: string,
+    content: string,
+  ): string {
+    let updatedContent = content;
+
+    const actorCapitalized =
+      actor.charAt(0).toUpperCase() + actor.slice(1).toLowerCase();
+
+    const nestjsCommonPattern =
+      /import\s+{\s*[^}]*\s*}\s+from\s+"@nestjs\/common";/g;
+    const nestjsCommonReplacement =
+      'import { ForbiddenException, UnauthorizedException } from "@nestjs/common";';
+
+    const myGlobalPattern = /import\s+{\s*MyGlobal\s*}\s+from\s+[^;]+;/g;
+    const myGlobalReplacement = 'import { MyGlobal } from "../../MyGlobal";';
+
+    const jwtAuthorizePattern =
+      /import\s+{\s*jwtAuthorize\s*}\s+from\s+[^;]+;/g;
+    const jwtAuthorizeReplacement =
+      'import { jwtAuthorize } from "./jwtAuthorize";';
+
+    const payloadPattern = /import\s+{\s*\w*Payload\s*}\s+from\s+[^;]+;/g;
+    const payloadReplacement = `import { ${actorCapitalized}Payload } from "../../decorators/payload/${actorCapitalized}Payload";`;
+
+    updatedContent = updatedContent.replace(
+      nestjsCommonPattern,
+      nestjsCommonReplacement,
+    );
+    updatedContent = updatedContent.replace(
+      myGlobalPattern,
+      myGlobalReplacement,
+    );
+    updatedContent = updatedContent.replace(
+      jwtAuthorizePattern,
+      jwtAuthorizeReplacement,
+    );
+    updatedContent = updatedContent.replace(payloadPattern, payloadReplacement);
+
+    return updatedContent;
+  }
+
+  export function replaceDecoratorImport(
+    actor: string,
+    content: string,
+  ): string {
+    let updatedContent = content;
+
+    const actorLowercase = actor.toLowerCase();
+
+    const authorizePattern = /import\s+{\s*\w*Authorize\s*}\s+from\s+[^;]+;/g;
+    const authorizeReplacement = `import { ${actorLowercase}Authorize } from "../providers/authorize/${actorLowercase}Authorize";`;
+
+    updatedContent = updatedContent.replace(
+      authorizePattern,
+      authorizeReplacement,
+    );
+
+    return updatedContent;
+  }
+}

package/src/orchestrate/realize/utils/InternalFileSystem.ts

@@ -1,12 +1,12 @@
-export namespace InternalFileSystem {
-  /**
-   * Get template files for all of realize agents
-   *
-   * @returns Template file paths
-   */
-  export const DEFAULT = [
-    "src/providers/authorize/jwtAuthorize.ts",
-    "src/MyGlobal.ts",
-    "src/utils/toISOStringSafe.ts",
-  ];
-}
+export namespace InternalFileSystem {
+  /**
+   * Get template files for all of realize agents
+   *
+   * @returns Template file paths
+   */
+  export const DEFAULT = [
+    "src/providers/authorize/jwtAuthorize.ts",
+    "src/MyGlobal.ts",
+    "src/utils/toISOStringSafe.ts",
+  ];
+}

package/src/orchestrate/realize/utils/ProviderFileSystem.ts

@@ -1,4 +1,4 @@
-export namespace RealizeFileSystem {
-  export const providerPath = (filename: string): string =>
-    `src/providers/${filename}.ts`;
-}
+export namespace RealizeFileSystem {
+  export const providerPath = (filename: string): string =>
+    `src/providers/${filename}.ts`;
+}

package/src/orchestrate/realize/utils/filterDiagnostics.ts

@@ -1,25 +1,25 @@
-import { AutoBeRealizeFunction } from "@autobe/interface";
-
-import { IAutoBeRealizeFunctionFailure } from "../structures/IAutoBeRealizeFunctionFailure";
-
-/**
- * Filter diagnostic failures to only include those matching the given
- * locations.
- *
- * @param failures - Array of function failures with diagnostic information
- * @param locations - Array of file locations to filter by
- * @returns Filtered array of failures matching the specified locations
- * @warning This function assumes f.function and f.function.location are always defined.
- *          If f.function is undefined, this will throw a runtime error.
- *          Consider using optional chaining: f.function?.location
- */
-export function filterDiagnostics<
-  RealizeFunction extends AutoBeRealizeFunction,
->(
-  failures: IAutoBeRealizeFunctionFailure<RealizeFunction>[],
-  locations: string[],
-): IAutoBeRealizeFunctionFailure<RealizeFunction>[] {
-  return failures
-    .filter((f) => f.function.location.startsWith("src/providers"))
-    .filter((f) => locations.includes(f.function.location));
-}
+import { AutoBeRealizeFunction } from "@autobe/interface";
+
+import { IAutoBeRealizeFunctionFailure } from "../structures/IAutoBeRealizeFunctionFailure";
+
+/**
+ * Filter diagnostic failures to only include those matching the given
+ * locations.
+ *
+ * @param failures - Array of function failures with diagnostic information
+ * @param locations - Array of file locations to filter by
+ * @returns Filtered array of failures matching the specified locations
+ * @warning This function assumes f.function and f.function.location are always defined.
+ *          If f.function is undefined, this will throw a runtime error.
+ *          Consider using optional chaining: f.function?.location
+ */
+export function filterDiagnostics<
+  RealizeFunction extends AutoBeRealizeFunction,
+>(
+  failures: IAutoBeRealizeFunctionFailure<RealizeFunction>[],
+  locations: string[],
+): IAutoBeRealizeFunctionFailure<RealizeFunction>[] {
+  return failures
+    .filter((f) => f.function.location.startsWith("src/providers"))
+    .filter((f) => locations.includes(f.function.location));
+}

package/src/orchestrate/realize/utils/generateTS2339Hints.ts

@@ -1,54 +1,54 @@
-import { IAutoBeTypeScriptCompileResult } from "@autobe/interface";
-
-/**
- * Generates concise TS2339-specific hints for Prisma relation field access
- * errors.
- *
- * Parses TS2339 "Property 'X' does not exist on type 'Y'" diagnostics,
- * deduplicates by (property, type) pair, and returns a short explanation when Y
- * appears to be a Prisma model type (snake_case naming).
- *
- * Returns empty string if no TS2339 diagnostics on Prisma-like types are found.
- */
-export function generateTS2339Hints(
-  diagnostics: IAutoBeTypeScriptCompileResult.IDiagnostic[],
-): string {
-  const TS2339_PATTERN = /^Property '(\w+)' does not exist on type '(\w+)'\.?$/;
-  const PRISMA_MODEL_PATTERN = /^[a-z][a-z0-9]*(_[a-z][a-z0-9]*)+$/;
-
-  const seen = new Set<string>();
-  const hints: Array<{ property: string; modelType: string }> = [];
-
-  for (const diag of diagnostics) {
-    if (Number(diag.code) !== 2339) continue;
-
-    const match = diag.messageText.match(TS2339_PATTERN);
-    if (match === null) continue;
-
-    const [, property, typeName] = match;
-    if (!PRISMA_MODEL_PATTERN.test(typeName)) continue;
-
-    const key = `${property}::${typeName}`;
-    if (seen.has(key)) continue;
-    seen.add(key);
-
-    hints.push({ property, modelType: typeName });
-  }
-
-  if (hints.length === 0) return "";
-
-  const lines = hints
-    .map((h) => `- \`${h.property}\` on \`${h.modelType}\``)
-    .join("\n");
-
-  return [
-    "## TS2339 Relation Field Hints",
-    "",
-    "These TS2339 errors are caused by accessing **Prisma relation fields** not available on the base model type.",
-    "- For transformers: add the missing relation to `select()` using `NeighborTransformer.select()`",
-    "- For collectors: use the **relation property name** (left side of schema definition) with `{ connect }` syntax",
-    "",
-    "Affected:",
-    lines,
-  ].join("\n");
-}
+import { IAutoBeTypeScriptCompileResult } from "@autobe/interface";
+
+/**
+ * Generates concise TS2339-specific hints for Prisma relation field access
+ * errors.
+ *
+ * Parses TS2339 "Property 'X' does not exist on type 'Y'" diagnostics,
+ * deduplicates by (property, type) pair, and returns a short explanation when Y
+ * appears to be a Prisma model type (snake_case naming).
+ *
+ * Returns empty string if no TS2339 diagnostics on Prisma-like types are found.
+ */
+export function generateTS2339Hints(
+  diagnostics: IAutoBeTypeScriptCompileResult.IDiagnostic[],
+): string {
+  const TS2339_PATTERN = /^Property '(\w+)' does not exist on type '(\w+)'\.?$/;
+  const PRISMA_MODEL_PATTERN = /^[a-z][a-z0-9]*(_[a-z][a-z0-9]*)+$/;
+
+  const seen = new Set<string>();
+  const hints: Array<{ property: string; modelType: string }> = [];
+
+  for (const diag of diagnostics) {
+    if (Number(diag.code) !== 2339) continue;
+
+    const match = diag.messageText.match(TS2339_PATTERN);
+    if (match === null) continue;
+
+    const [, property, typeName] = match;
+    if (!PRISMA_MODEL_PATTERN.test(typeName)) continue;
+
+    const key = `${property}::${typeName}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+
+    hints.push({ property, modelType: typeName });
+  }
+
+  if (hints.length === 0) return "";
+
+  const lines = hints
+    .map((h) => `- \`${h.property}\` on \`${h.modelType}\``)
+    .join("\n");
+
+  return [
+    "## TS2339 Relation Field Hints",
+    "",
+    "These TS2339 errors are caused by accessing **Prisma relation fields** not available on the base model type.",
+    "- For transformers: add the missing relation to `select()` using `NeighborTransformer.select()`",
+    "- For collectors: use the **relation property name** (left side of schema definition) with `{ connect }` syntax",
+    "",
+    "Affected:",
+    lines,
+  ].join("\n");
+}

package/src/orchestrate/realize/utils/getRealizeWriteImportStatements.ts

@@ -1,42 +1,42 @@
-import { AutoBeOpenApi } from "@autobe/interface";
-import { OpenApiTypeChecker } from "@typia/utils";
-
-export function getRealizeWriteImportStatements(props: {
-  operation: AutoBeOpenApi.IOperation;
-  schemas: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive>;
-}): string[] {
-  const typeReferences: Set<string> = new Set();
-  const visit = (key: string) =>
-    OpenApiTypeChecker.visit({
-      schema: {
-        $ref: `#/components/schemas/${key}`,
-      },
-      components: { schemas: props.schemas },
-      closure: (next) => {
-        if (OpenApiTypeChecker.isReference(next))
-          typeReferences.add(next.$ref.split("/").pop()!.split(".")[0]!);
-      },
-    });
-  if (props.operation.requestBody) visit(props.operation.requestBody.typeName);
-  if (props.operation.responseBody)
-    visit(props.operation.responseBody.typeName);
-
-  // Build the standard imports
-  const imports: string[] = [
-    'import { HttpException } from "@nestjs/common";',
-    'import { Prisma } from "@prisma/sdk";',
-    'import jwt from "jsonwebtoken";',
-    'import typia, { tags } from "typia";',
-    'import { v4 } from "uuid";',
-
-    'import { MyGlobal } from "../MyGlobal";',
-    'import { PasswordUtil } from "../utils/PasswordUtil";',
-    'import { toISOStringSafe } from "../utils/toISOStringSafe"',
-    "",
-    ...Array.from(typeReferences).map(
-      (ref) =>
-        `import { ${ref} } from "@ORGANIZATION/PROJECT-api/lib/structures/${ref}";`,
-    ),
-  ];
-  return imports;
-}
+import { AutoBeOpenApi } from "@autobe/interface";
+import { OpenApiTypeChecker } from "@typia/utils";
+
+export function getRealizeWriteImportStatements(props: {
+  operation: AutoBeOpenApi.IOperation;
+  schemas: Record<string, AutoBeOpenApi.IJsonSchemaDescriptive>;
+}): string[] {
+  const typeReferences: Set<string> = new Set();
+  const visit = (key: string) =>
+    OpenApiTypeChecker.visit({
+      schema: {
+        $ref: `#/components/schemas/${key}`,
+      },
+      components: { schemas: props.schemas },
+      closure: (next) => {
+        if (OpenApiTypeChecker.isReference(next))
+          typeReferences.add(next.$ref.split("/").pop()!.split(".")[0]!);
+      },
+    });
+  if (props.operation.requestBody) visit(props.operation.requestBody.typeName);
+  if (props.operation.responseBody)
+    visit(props.operation.responseBody.typeName);
+
+  // Build the standard imports
+  const imports: string[] = [
+    'import { HttpException } from "@nestjs/common";',
+    'import { Prisma } from "@prisma/sdk";',
+    'import jwt from "jsonwebtoken";',
+    'import typia, { tags } from "typia";',
+    'import { v4 } from "uuid";',
+
+    'import { MyGlobal } from "../MyGlobal";',
+    'import { PasswordUtil } from "../utils/PasswordUtil";',
+    'import { toISOStringSafe } from "../utils/toISOStringSafe"',
+    "",
+    ...Array.from(typeReferences).map(
+      (ref) =>
+        `import { ${ref} } from "@ORGANIZATION/PROJECT-api/lib/structures/${ref}";`,
+    ),
+  ];
+  return imports;
+}

package/src/orchestrate/realize/utils/getRealizeWriteInputType.ts

@@ -1,88 +1,88 @@
-import { AutoBeOpenApi, AutoBeRealizeAuthorization } from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-
-import { AutoBeRealizeOperationProgrammer } from "../programmers/AutoBeRealizeOperationProgrammer";
-
-/**
- * Generate TypeScript type definition string for provider function props
- *
- * This utility creates the exact props interface that the Realize Agent's
- * generated provider functions must accept. It combines:
- *
- * - Authentication context (user/admin/member from authorization)
- * - URL path parameters (e.g., id, boardId, postId)
- * - Request body type (if applicable)
- *
- * The output is injected into REALIZE_OPERATION_WRITE.md template to tell the
- * AI exactly what parameter type the function should accept.
- *
- * @example
- *   // For DELETE /posts/:id (authenticated)
- *   // Returns: "props: { user: IUser; id: string & tags.Format<'uuid'>; }"
- *
- * @example
- *   // For GET /public/info (no auth, no params)
- *   // Returns: "// No props parameter needed - function should have no parameters"
- *
- * @param operation - OpenAPI operation definition containing parameters and
- *   auth requirements
- * @param authorization - Authorization context with user/role information (if
- *   authenticated endpoint)
- * @returns TypeScript interface string like "props: { user: IUser; id: string;
- *   body: IRequest; }"
- */
-export function getRealizeWriteInputType(
-  operation: AutoBeOpenApi.IOperation,
-  authorization: AutoBeRealizeAuthorization | null,
-): string {
-  const functionParameterFields: string[] = [];
-
-  // Add authentication field (user/admin/member) if endpoint requires auth
-  // Skip for public auth operations (login, join, refresh) - they must be publicly accessible
-  const hasAuthentication =
-    authorization &&
-    operation.authorizationActor &&
-    !AutoBeRealizeOperationProgrammer.isPublicAuthOperation(operation);
-  if (hasAuthentication) {
-    const authFieldName = operation.authorizationActor;
-    const authFieldType = authorization.payload.name;
-    functionParameterFields.push(`${authFieldName}: ${authFieldType};`);
-  }
-
-  // Add URL path parameters (e.g., /posts/:id → id parameter)
-  const pathParameters = operation.parameters;
-  pathParameters.forEach((pathParam) => {
-    const paramName = pathParam.name;
-    const paramType = pathParam.schema.type;
-    const paramFormat =
-      "format" in pathParam.schema
-        ? ` & tags.Format<'${pathParam.schema.format}'>`
-        : "";
-
-    const parameterField = `${paramName}: ${paramType}${paramFormat};`;
-    functionParameterFields.push(parameterField);
-  });
-
-  // Add request body if present (POST/PUT/PATCH operations)
-  const hasRequestBody = operation.requestBody?.typeName;
-  if (hasRequestBody) {
-    const bodyTypeName = operation.requestBody?.typeName;
-    functionParameterFields.push(`body: ${bodyTypeName};`);
-  }
-
-  // Format as TypeScript props interface or indicate no parameters needed
-  const hasParameters = functionParameterFields.length > 0;
-
-  if (!hasParameters) {
-    return `// No props parameter needed - function should have no parameters`;
-  }
-
-  const formattedFields = functionParameterFields
-    .map((field) => `  ${field}`)
-    .join("\n");
-
-  return StringUtil.trim`
-    props: {
-    ${formattedFields}
-    }`;
-}
+import { AutoBeOpenApi, AutoBeRealizeAuthorization } from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+
+import { AutoBeRealizeOperationProgrammer } from "../programmers/AutoBeRealizeOperationProgrammer";
+
+/**
+ * Generate TypeScript type definition string for provider function props
+ *
+ * This utility creates the exact props interface that the Realize Agent's
+ * generated provider functions must accept. It combines:
+ *
+ * - Authentication context (user/admin/member from authorization)
+ * - URL path parameters (e.g., id, boardId, postId)
+ * - Request body type (if applicable)
+ *
+ * The output is injected into REALIZE_OPERATION_WRITE.md template to tell the
+ * AI exactly what parameter type the function should accept.
+ *
+ * @example
+ *   // For DELETE /posts/:id (authenticated)
+ *   // Returns: "props: { user: IUser; id: string & tags.Format<'uuid'>; }"
+ *
+ * @example
+ *   // For GET /public/info (no auth, no params)
+ *   // Returns: "// No props parameter needed - function should have no parameters"
+ *
+ * @param operation - OpenAPI operation definition containing parameters and
+ *   auth requirements
+ * @param authorization - Authorization context with user/role information (if
+ *   authenticated endpoint)
+ * @returns TypeScript interface string like "props: { user: IUser; id: string;
+ *   body: IRequest; }"
+ */
+export function getRealizeWriteInputType(
+  operation: AutoBeOpenApi.IOperation,
+  authorization: AutoBeRealizeAuthorization | null,
+): string {
+  const functionParameterFields: string[] = [];
+
+  // Add authentication field (user/admin/member) if endpoint requires auth
+  // Skip for public auth operations (login, join, refresh) - they must be publicly accessible
+  const hasAuthentication =
+    authorization &&
+    operation.authorizationActor &&
+    !AutoBeRealizeOperationProgrammer.isPublicAuthOperation(operation);
+  if (hasAuthentication) {
+    const authFieldName = operation.authorizationActor;
+    const authFieldType = authorization.payload.name;
+    functionParameterFields.push(`${authFieldName}: ${authFieldType};`);
+  }
+
+  // Add URL path parameters (e.g., /posts/:id → id parameter)
+  const pathParameters = operation.parameters;
+  pathParameters.forEach((pathParam) => {
+    const paramName = pathParam.name;
+    const paramType = pathParam.schema.type;
+    const paramFormat =
+      "format" in pathParam.schema
+        ? ` & tags.Format<'${pathParam.schema.format}'>`
+        : "";
+
+    const parameterField = `${paramName}: ${paramType}${paramFormat};`;
+    functionParameterFields.push(parameterField);
+  });
+
+  // Add request body if present (POST/PUT/PATCH operations)
+  const hasRequestBody = operation.requestBody?.typeName;
+  if (hasRequestBody) {
+    const bodyTypeName = operation.requestBody?.typeName;
+    functionParameterFields.push(`body: ${bodyTypeName};`);
+  }
+
+  // Format as TypeScript props interface or indicate no parameters needed
+  const hasParameters = functionParameterFields.length > 0;
+
+  if (!hasParameters) {
+    return `// No props parameter needed - function should have no parameters`;
+  }
+
+  const formattedFields = functionParameterFields
+    .map((field) => `  ${field}`)
+    .join("\n");
+
+  return StringUtil.trim`
+    props: {
+    ${formattedFields}
+    }`;
+}