@builder.io/ai-utils 0.74.1 → 0.74.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.74.1",
+  "version": "0.74.2",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/codegen.d.ts

@@ -1317,7 +1317,16 @@ export type SubmitPRReviewToolInput = z.infer<typeof SubmitPRReviewToolInputSche
 export declare const AddCommentToolInputSchema: z.ZodObject<{
     type: z.ZodString;
     content: z.ZodString;
-    metadata: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        filePath: z.ZodOptional<z.ZodString>;
+        startLine: z.ZodOptional<z.ZodNumber>;
+        endLine: z.ZodOptional<z.ZodNumber>;
+        severity: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            low: "low";
+            medium: "medium";
+        }>>;
+    }, z.core.$loose>>;
 }, z.core.$strip>;
 export type AddCommentToolInput = Omit<z.infer<typeof AddCommentToolInputSchema>, "metadata"> & {
     metadata?: AddedCommentMetadata;
@@ -1669,7 +1678,16 @@ export declare const CodeGenToolMapSchema: z.ZodObject<{
     AddComment: z.ZodObject<{
         type: z.ZodString;
         content: z.ZodString;
-        metadata: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            filePath: z.ZodOptional<z.ZodString>;
+            startLine: z.ZodOptional<z.ZodNumber>;
+            endLine: z.ZodOptional<z.ZodNumber>;
+            severity: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                low: "low";
+                medium: "medium";
+            }>>;
+        }, z.core.$loose>>;
     }, z.core.$strip>;
     ProposeConfig: z.ZodObject<{
         config: z.ZodObject<{

package/src/codegen.js

@@ -1362,9 +1362,30 @@ export const AddCommentToolInputSchema = z
     }),
     // `looseObject` (not `z.record`) so the JSON schema emits
     // `additionalProperties` rather than `propertyNames`, which OpenAI's strict
-    // tool-schema mode rejects.
-    metadata: z.looseObject({}).optional().meta({
-        description: "Type-specific fields. For 'code-review': filePath (string), startLine (number), endLine (number, optional), severity ('high' | 'medium' | 'low'), and originalSnippet when available",
+    // tool-schema mode rejects. The location fields are declared explicitly
+    // (rather than left to an open object) because typed fields get filled far
+    // more consistently by the model. They are optional in the schema since
+    // `metadata` is shared across comment types; for 'code-review', filePath and
+    // startLine are enforced as required server-side (see AddComment tool).
+    metadata: z
+        .looseObject({
+        filePath: z.string().min(1).optional().meta({
+            description: "Project-relative file path the comment refers to. Required for 'code-review'.",
+        }),
+        startLine: z.number().int().positive().optional().meta({
+            description: "1-indexed start line the comment refers to. Required for 'code-review'. Use the [L:N] markers from the annotated diff.",
+        }),
+        endLine: z.number().int().positive().optional().meta({
+            description: "1-indexed end line; defaults to startLine when omitted.",
+        }),
+        severity: z
+            .enum(["high", "medium", "low"])
+            .optional()
+            .meta({ description: "Finding severity for 'code-review'." }),
+    })
+        .optional()
+        .meta({
+        description: "Type-specific fields. For 'code-review': filePath and startLine are required; endLine and severity are optional. originalSnippet is populated automatically.",
     }),
 })
     .meta({ title: "AddCommentToolInput" });