visual-ai-assertions 0.13.0 → 0.13.1

package/dist/index.d.cts

@@ -420,8 +420,12 @@ declare const AskResultSchema: z.ZodObject<{
     /**
      * For video inputs, the indices of frames the model relied on to answer.
      * Indices are 0-based and refer to entries in `frames.timestampsSeconds`.
+     *
+     * Nullable because providers with strict structured-output schemas (e.g. OpenAI)
+     * must mark every field required and represent "no value" as `null` rather than
+     * omitting the key, even for image inputs that were never asked to populate it.
      */
-    frameReferences: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    frameReferences: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber, "many">>>;
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
@@ -457,7 +461,7 @@ declare const AskResultSchema: z.ZodObject<{
         estimatedCost?: number | undefined;
         durationSeconds?: number | undefined;
     } | undefined;
-    frameReferences?: number[] | undefined;
+    frameReferences?: number[] | null | undefined;
 }, {
     issues: {
         priority: "critical" | "major" | "minor";
@@ -473,11 +477,12 @@ declare const AskResultSchema: z.ZodObject<{
         estimatedCost?: number | undefined;
         durationSeconds?: number | undefined;
     } | undefined;
-    frameReferences?: number[] | undefined;
+    frameReferences?: number[] | null | undefined;
 }>;
 /** Result returned by `ask()`. */
-type AskResult = z.infer<typeof AskResultSchema> & {
+type AskResult = Omit<z.infer<typeof AskResultSchema>, "frameReferences"> & {
     /** Present only when the input was a video. Describes which frames the model saw. */
+    frameReferences?: number[];
     frames?: VideoFramesMetadata;
 };
 /** Supported input shapes for image arguments accepted by the client. */

package/dist/index.d.ts

@@ -420,8 +420,12 @@ declare const AskResultSchema: z.ZodObject<{
     /**
      * For video inputs, the indices of frames the model relied on to answer.
      * Indices are 0-based and refer to entries in `frames.timestampsSeconds`.
+     *
+     * Nullable because providers with strict structured-output schemas (e.g. OpenAI)
+     * must mark every field required and represent "no value" as `null` rather than
+     * omitting the key, even for image inputs that were never asked to populate it.
      */
-    frameReferences: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    frameReferences: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber, "many">>>;
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
@@ -457,7 +461,7 @@ declare const AskResultSchema: z.ZodObject<{
         estimatedCost?: number | undefined;
         durationSeconds?: number | undefined;
     } | undefined;
-    frameReferences?: number[] | undefined;
+    frameReferences?: number[] | null | undefined;
 }, {
     issues: {
         priority: "critical" | "major" | "minor";
@@ -473,11 +477,12 @@ declare const AskResultSchema: z.ZodObject<{
         estimatedCost?: number | undefined;
         durationSeconds?: number | undefined;
     } | undefined;
-    frameReferences?: number[] | undefined;
+    frameReferences?: number[] | null | undefined;
 }>;
 /** Result returned by `ask()`. */
-type AskResult = z.infer<typeof AskResultSchema> & {
+type AskResult = Omit<z.infer<typeof AskResultSchema>, "frameReferences"> & {
     /** Present only when the input was a video. Describes which frames the model saw. */
+    frameReferences?: number[];
     frames?: VideoFramesMetadata;
 };
 /** Supported input shapes for image arguments accepted by the client. */

package/dist/index.js

@@ -1785,8 +1785,12 @@ var AskResultSchema = z.object({
   /**
    * For video inputs, the indices of frames the model relied on to answer.
    * Indices are 0-based and refer to entries in `frames.timestampsSeconds`.
+   *
+   * Nullable because providers with strict structured-output schemas (e.g. OpenAI)
+   * must mark every field required and represent "no value" as `null` rather than
+   * omitting the key, even for image inputs that were never asked to populate it.
    */
-  frameReferences: z.array(z.number().int().nonnegative()).optional(),
+  frameReferences: z.array(z.number().int().nonnegative()).nullable().optional(),
   usage: UsageInfoSchema.optional()
 });
 
@@ -1838,7 +1842,11 @@ function parseCheckResponse(raw) {
   return reconcileCheckResult(result);
 }
 function parseAskResponse(raw) {
-  return parseResponse(raw, AskResponseSchema);
+  const result = parseResponse(raw, AskResponseSchema);
+  return {
+    ...result,
+    frameReferences: result.frameReferences ?? void 0
+  };
 }
 function parseCompareResponse(raw) {
   return parseResponse(raw, CompareResponseSchema);