@livekit/agents 1.0.17 → 1.0.19

package/dist/llm/utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/llm/utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { VideoBufferType, VideoFrame } from '@livekit/rtc-node';\nimport type { JSONSchema7 } from 'json-schema';\nimport sharp from 'sharp';\nimport type { UnknownUserData } from '../voice/run_context.js';\nimport type { ChatContext } from './chat_context.js';\nimport {\n  type ChatItem,\n  FunctionCall,\n  FunctionCallOutput,\n  type ImageContent,\n} from './chat_context.js';\nimport type { ToolContext, ToolInputSchema, ToolOptions } from './tool_context.js';\nimport { isZodSchema, parseZodSchema, zodSchemaToJsonSchema } from './zod-utils.js';\n\nexport interface SerializedImage {\n  inferenceDetail: 'auto' | 'high' | 'low';\n  mimeType?: string;\n  base64Data?: string;\n  externalUrl?: string;\n}\n\nfunction getChannelsFromVideoBufferType(type: VideoBufferType): 3 | 4 {\n  switch (type) {\n    case VideoBufferType.RGBA:\n    case VideoBufferType.ABGR:\n    case VideoBufferType.ARGB:\n    case VideoBufferType.BGRA:\n      return 4;\n    case VideoBufferType.RGB24:\n      return 3;\n    default:\n      // YUV formats (I420, I420A, I422, I444, I010, NV12) need conversion\n      throw new Error(`Unsupported VideoBufferType: ${type}. Only RGB/RGBA formats are supported.`);\n  }\n}\n\nfunction ensureRGBCompatible(frame: VideoFrame): VideoFrame {\n  // If the frame is already in an RGB/RGBA-compatible format, return it directly\n  if (\n    frame.type === VideoBufferType.RGBA ||\n    frame.type === VideoBufferType.BGRA ||\n    frame.type === VideoBufferType.ARGB ||\n    frame.type === VideoBufferType.ABGR ||\n    frame.type === VideoBufferType.RGB24\n  ) {\n    return frame;\n  }\n\n  // Otherwise, attempt conversion for other formats (like YUV)\n  try {\n    return frame.convert(VideoBufferType.RGBA);\n  } catch (error) {\n    throw new Error(\n      `Failed to convert format ${frame.type} to RGB: ${error}. ` +\n        `Consider using RGB/RGBA formats or converting on the client side.`,\n    );\n  }\n}\n\nexport async function serializeImage(image: ImageContent): Promise<SerializedImage> {\n  if (typeof image.image === 'string') {\n    if (image.image.startsWith('data:')) {\n      const [header, base64Data] = image.image.split(',', 2) as [string, string];\n      const headerParts = header.split(';');\n      const mimeParts = headerParts[0]?.split(':');\n      const headerMime = mimeParts?.[1];\n\n      if (!headerMime) {\n        throw new Error('Invalid data URL format');\n      }\n\n      let mimeType: string;\n      if (image.mimeType && image.mimeType !== headerMime) {\n        console.warn(\n          `Provided mimeType '${image.mimeType}' does not match data URL mime type '${headerMime}'. Using provided mimeType.`,\n        );\n        mimeType = image.mimeType;\n      } else {\n        mimeType = headerMime;\n      }\n\n      const supportedTypes = new Set(['image/jpeg', 'image/png', 'image/webp', 'image/gif']);\n      if (!supportedTypes.has(mimeType)) {\n        throw new Error(`Unsupported mimeType ${mimeType}. Must be jpeg, png, webp, or gif`);\n      }\n\n      return {\n        base64Data,\n        mimeType: mimeType,\n        inferenceDetail: image.inferenceDetail,\n      };\n    }\n\n    // External URL\n    return {\n      mimeType: image.mimeType,\n      inferenceDetail: image.inferenceDetail,\n      externalUrl: image.image,\n    };\n  } else if (image.image instanceof VideoFrame) {\n    const frame = ensureRGBCompatible(image.image);\n    const channels = getChannelsFromVideoBufferType(frame.type);\n\n    // Sharp needs to know the format of raw pixel data\n    let encoded = sharp(frame.data, {\n      raw: {\n        width: frame.width,\n        height: frame.height,\n        channels,\n      },\n    });\n\n    if (image.inferenceWidth && image.inferenceHeight) {\n      encoded = encoded.resize(image.inferenceWidth, image.inferenceHeight);\n    }\n\n    const base64Data = await encoded\n      .png()\n      .toBuffer()\n      .then((buffer) => buffer.toString('base64'));\n\n    return {\n      base64Data,\n      mimeType: 'image/png',\n      inferenceDetail: image.inferenceDetail,\n    };\n  } else {\n    throw new Error('Unsupported image type');\n  }\n}\n\n/** Raw OpenAI-adherent function parameters. */\nexport type OpenAIFunctionParameters = {\n  type: 'object';\n  properties: { [id: string]: any }; // eslint-disable-line @typescript-eslint/no-explicit-any\n  required: string[];\n  additionalProperties?: boolean;\n};\n\n// TODO(brian): remove this helper once we have the real RunContext user data\nexport const createToolOptions = <UserData extends UnknownUserData>(\n  toolCallId: string,\n  userData: UserData = {} as UserData,\n): ToolOptions<UserData> => {\n  return { ctx: { userData }, toolCallId } as unknown as ToolOptions<UserData>;\n};\n\n/** @internal */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const oaiParams = (schema: any, isOpenai: boolean = true): OpenAIFunctionParameters => {\n  // Adapted from https://github.com/vercel/ai/blob/56eb0ee9/packages/provider-utils/src/zod-schema.ts\n  const jsonSchema = zodSchemaToJsonSchema(schema, isOpenai);\n  const { properties, required, additionalProperties } = jsonSchema as OpenAIFunctionParameters;\n\n  return {\n    type: 'object',\n    properties,\n    required,\n    additionalProperties,\n  };\n};\n\n/** @internal */\nexport const oaiBuildFunctionInfo = (\n  toolCtx: ToolContext,\n  toolCallId: string,\n  toolName: string,\n  rawArgs: string,\n): FunctionCall => {\n  const tool = toolCtx[toolName];\n  if (!tool) {\n    throw new Error(`AI tool ${toolName} not found`);\n  }\n\n  return FunctionCall.create({\n    callId: toolCallId,\n    name: toolName,\n    args: rawArgs,\n  });\n};\n\nexport async function executeToolCall(\n  toolCall: FunctionCall,\n  toolCtx: ToolContext,\n): Promise<FunctionCallOutput> {\n  const tool = toolCtx[toolCall.name]!;\n  let args: object | undefined;\n  let params: object | undefined;\n\n  // Ensure valid JSON\n  try {\n    args = JSON.parse(toolCall.args);\n  } catch (error) {\n    return FunctionCallOutput.create({\n      callId: toolCall.callId,\n      output: `Invalid JSON: ${error}`,\n      isError: true,\n    });\n  }\n\n  // Ensure valid arguments schema\n  try {\n    if (isZodSchema(tool.parameters)) {\n      const result = await parseZodSchema<object>(tool.parameters, args);\n      if (result.success) {\n        params = result.data;\n      } else {\n        return FunctionCallOutput.create({\n          callId: toolCall.callId,\n          output: `Arguments parsing failed: ${result.error}`,\n          isError: true,\n        });\n      }\n    } else {\n      params = args;\n    }\n  } catch (error) {\n    return FunctionCallOutput.create({\n      callId: toolCall.callId,\n      output: `Arguments parsing failed: ${error}`,\n      isError: true,\n    });\n  }\n\n  try {\n    const result = await tool.execute(params, createToolOptions(toolCall.callId));\n    return FunctionCallOutput.create({\n      callId: toolCall.callId,\n      output: JSON.stringify(result),\n      isError: false,\n    });\n  } catch (error) {\n    return FunctionCallOutput.create({\n      callId: toolCall.callId,\n      output: `Tool execution failed: ${error}`,\n      isError: true,\n    });\n  }\n}\n\n/**\n * Standard dynamic-programming LCS to get the common subsequence\n * of IDs (in order) that appear in both old_ids and new_ids.\n *\n * @param oldIds - The old list of IDs.\n * @param newIds - The new list of IDs.\n * @returns The longest common subsequence of the two lists of IDs.\n */\nfunction computeLCS(oldIds: string[], newIds: string[]): string[] {\n  const n = oldIds.length;\n  const m = newIds.length;\n  const dp: number[][] = Array(n + 1)\n    .fill(null)\n    .map(() => Array(m + 1).fill(0));\n\n  // Fill DP table\n  for (let i = 1; i <= n; i++) {\n    for (let j = 1; j <= m; j++) {\n      if (oldIds[i - 1] === newIds[j - 1]) {\n        dp[i]![j] = dp[i - 1]![j - 1]! + 1;\n      } else {\n        dp[i]![j] = Math.max(dp[i - 1]![j]!, dp[i]![j - 1]!);\n      }\n    }\n  }\n\n  // Backtrack to find the actual LCS sequence\n  const lcsIds: string[] = [];\n  let i = n;\n  let j = m;\n  while (i > 0 && j > 0) {\n    if (oldIds[i - 1] === newIds[j - 1]) {\n      lcsIds.push(oldIds[i - 1]!);\n      i--;\n      j--;\n    } else if (dp[i - 1]![j]! > dp[i]![j - 1]!) {\n      i--;\n    } else {\n      j--;\n    }\n  }\n\n  return lcsIds.reverse();\n}\n\ninterface DiffOps {\n  toRemove: string[];\n  toCreate: Array<[string | null, string]>; // (previous_item_id, id), if previous_item_id is null, add to the root\n}\n\n/**\n * Compute the minimal list of create/remove operations to transform oldCtx into newCtx.\n *\n * @param oldCtx - The old chat context.\n * @param newCtx - The new chat context.\n * @returns The minimal list of create/remove operations to transform oldCtx into newCtx.\n */\nexport function computeChatCtxDiff(oldCtx: ChatContext, newCtx: ChatContext): DiffOps {\n  const oldIds = oldCtx.items.map((item: ChatItem) => item.id);\n  const newIds = newCtx.items.map((item: ChatItem) => item.id);\n  const lcsIds = new Set(computeLCS(oldIds, newIds));\n\n  const toRemove = oldCtx.items.filter((msg) => !lcsIds.has(msg.id)).map((msg) => msg.id);\n  const toCreate: Array<[string | null, string]> = [];\n\n  let lastIdInSequence: string | null = null;\n  for (const newItem of newCtx.items) {\n    if (lcsIds.has(newItem.id)) {\n      lastIdInSequence = newItem.id;\n    } else {\n      const prevId = lastIdInSequence; // null if root\n      toCreate.push([prevId, newItem.id]);\n      lastIdInSequence = newItem.id;\n    }\n  }\n\n  return {\n    toRemove,\n    toCreate,\n  };\n}\n\nexport function toJsonSchema(schema: ToolInputSchema<any>, isOpenai: boolean = true): JSONSchema7 {\n  if (isZodSchema(schema)) {\n    return zodSchemaToJsonSchema(schema, isOpenai);\n  }\n  return schema as JSONSchema7;\n}\n"],"mappings":"AAGA,SAAS,iBAAiB,kBAAkB;AAE5C,OAAO,WAAW;AAGlB;AAAA,EAEE;AAAA,EACA;AAAA,OAEK;AAEP,SAAS,aAAa,gBAAgB,6BAA6B;AASnE,SAAS,+BAA+B,MAA8B;AACpE,UAAQ,MAAM;AAAA,IACZ,KAAK,gBAAgB;AAAA,IACrB,KAAK,gBAAgB;AAAA,IACrB,KAAK,gBAAgB;AAAA,IACrB,KAAK,gBAAgB;AACnB,aAAO;AAAA,IACT,KAAK,gBAAgB;AACnB,aAAO;AAAA,IACT;AAEE,YAAM,IAAI,MAAM,gCAAgC,IAAI,wCAAwC;AAAA,EAChG;AACF;AAEA,SAAS,oBAAoB,OAA+B;AAE1D,MACE,MAAM,SAAS,gBAAgB,QAC/B,MAAM,SAAS,gBAAgB,QAC/B,MAAM,SAAS,gBAAgB,QAC/B,MAAM,SAAS,gBAAgB,QAC/B,MAAM,SAAS,gBAAgB,OAC/B;AACA,WAAO;AAAA,EACT;AAGA,MAAI;AACF,WAAO,MAAM,QAAQ,gBAAgB,IAAI;AAAA,EAC3C,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR,4BAA4B,MAAM,IAAI,YAAY,KAAK;AAAA,IAEzD;AAAA,EACF;AACF;AAEA,eAAsB,eAAe,OAA+C;AA9DpF;AA+DE,MAAI,OAAO,MAAM,UAAU,UAAU;AACnC,QAAI,MAAM,MAAM,WAAW,OAAO,GAAG;AACnC,YAAM,CAAC,QAAQ,UAAU,IAAI,MAAM,MAAM,MAAM,KAAK,CAAC;AACrD,YAAM,cAAc,OAAO,MAAM,GAAG;AACpC,YAAM,aAAY,iBAAY,CAAC,MAAb,mBAAgB,MAAM;AACxC,YAAM,aAAa,uCAAY;AAE/B,UAAI,CAAC,YAAY;AACf,cAAM,IAAI,MAAM,yBAAyB;AAAA,MAC3C;AAEA,UAAI;AACJ,UAAI,MAAM,YAAY,MAAM,aAAa,YAAY;AACnD,gBAAQ;AAAA,UACN,sBAAsB,MAAM,QAAQ,wCAAwC,UAAU;AAAA,QACxF;AACA,mBAAW,MAAM;AAAA,MACnB,OAAO;AACL,mBAAW;AAAA,MACb;AAEA,YAAM,iBAAiB,oBAAI,IAAI,CAAC,cAAc,aAAa,cAAc,WAAW,CAAC;AACrF,UAAI,CAAC,eAAe,IAAI,QAAQ,GAAG;AACjC,cAAM,IAAI,MAAM,wBAAwB,QAAQ,mCAAmC;AAAA,MACrF;AAEA,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,iBAAiB,MAAM;AAAA,MACzB;AAAA,IACF;AAGA,WAAO;AAAA,MACL,UAAU,MAAM;AAAA,MAChB,iBAAiB,MAAM;AAAA,MACvB,aAAa,MAAM;AAAA,IACrB;AAAA,EACF,WAAW,MAAM,iBAAiB,YAAY;AAC5C,UAAM,QAAQ,oBAAoB,MAAM,KAAK;AAC7C,UAAM,WAAW,+BAA+B,MAAM,IAAI;AAG1D,QAAI,UAAU,MAAM,MAAM,MAAM;AAAA,MAC9B,KAAK;AAAA,QACH,OAAO,MAAM;AAAA,QACb,QAAQ,MAAM;AAAA,QACd;AAAA,MACF;AAAA,IACF,CAAC;AAED,QAAI,MAAM,kBAAkB,MAAM,iBAAiB;AACjD,gBAAU,QAAQ,OAAO,MAAM,gBAAgB,MAAM,eAAe;AAAA,IACtE;AAEA,UAAM,aAAa,MAAM,QACtB,IAAI,EACJ,SAAS,EACT,KAAK,CAAC,WAAW,OAAO,SAAS,QAAQ,CAAC;AAE7C,WAAO;AAAA,MACL;AAAA,MACA,UAAU;AAAA,MACV,iBAAiB,MAAM;AAAA,IACzB;AAAA,EACF,OAAO;AACL,UAAM,IAAI,MAAM,wBAAwB;AAAA,EAC1C;AACF;AAWO,MAAM,oBAAoB,CAC/B,YACA,WAAqB,CAAC,MACI;AAC1B,SAAO,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW;AACzC;AAIO,MAAM,YAAY,CAAC,QAAa,WAAoB,SAAmC;AAE5F,QAAM,aAAa,sBAAsB,QAAQ,QAAQ;AACzD,QAAM,EAAE,YAAY,UAAU,qBAAqB,IAAI;AAEvD,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAGO,MAAM,uBAAuB,CAClC,SACA,YACA,UACA,YACiB;AACjB,QAAM,OAAO,QAAQ,QAAQ;AAC7B,MAAI,CAAC,MAAM;AACT,UAAM,IAAI,MAAM,WAAW,QAAQ,YAAY;AAAA,EACjD;AAEA,SAAO,aAAa,OAAO;AAAA,IACzB,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,MAAM;AAAA,EACR,CAAC;AACH;AAEA,eAAsB,gBACpB,UACA,SAC6B;AAC7B,QAAM,OAAO,QAAQ,SAAS,IAAI;AAClC,MAAI;AACJ,MAAI;AAGJ,MAAI;AACF,WAAO,KAAK,MAAM,SAAS,IAAI;AAAA,EACjC,SAAS,OAAO;AACd,WAAO,mBAAmB,OAAO;AAAA,MAC/B,QAAQ,SAAS;AAAA,MACjB,QAAQ,iBAAiB,KAAK;AAAA,MAC9B,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAGA,MAAI;AACF,QAAI,YAAY,KAAK,UAAU,GAAG;AAChC,YAAM,SAAS,MAAM,eAAuB,KAAK,YAAY,IAAI;AACjE,UAAI,OAAO,SAAS;AAClB,iBAAS,OAAO;AAAA,MAClB,OAAO;AACL,eAAO,mBAAmB,OAAO;AAAA,UAC/B,QAAQ,SAAS;AAAA,UACjB,QAAQ,6BAA6B,OAAO,KAAK;AAAA,UACjD,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AAAA,IACF,OAAO;AACL,eAAS;AAAA,IACX;AAAA,EACF,SAAS,OAAO;AACd,WAAO,mBAAmB,OAAO;AAAA,MAC/B,QAAQ,SAAS;AAAA,MACjB,QAAQ,6BAA6B,KAAK;AAAA,MAC1C,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAEA,MAAI;AACF,UAAM,SAAS,MAAM,KAAK,QAAQ,QAAQ,kBAAkB,SAAS,MAAM,CAAC;AAC5E,WAAO,mBAAmB,OAAO;AAAA,MAC/B,QAAQ,SAAS;AAAA,MACjB,QAAQ,KAAK,UAAU,MAAM;AAAA,MAC7B,SAAS;AAAA,IACX,CAAC;AAAA,EACH,SAAS,OAAO;AACd,WAAO,mBAAmB,OAAO;AAAA,MAC/B,QAAQ,SAAS;AAAA,MACjB,QAAQ,0BAA0B,KAAK;AAAA,MACvC,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF;AAUA,SAAS,WAAW,QAAkB,QAA4B;AAChE,QAAM,IAAI,OAAO;AACjB,QAAM,IAAI,OAAO;AACjB,QAAM,KAAiB,MAAM,IAAI,CAAC,EAC/B,KAAK,IAAI,EACT,IAAI,MAAM,MAAM,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;AAGjC,WAASA,KAAI,GAAGA,MAAK,GAAGA,MAAK;AAC3B,aAASC,KAAI,GAAGA,MAAK,GAAGA,MAAK;AAC3B,UAAI,OAAOD,KAAI,CAAC,MAAM,OAAOC,KAAI,CAAC,GAAG;AACnC,WAAGD,EAAC,EAAGC,EAAC,IAAI,GAAGD,KAAI,CAAC,EAAGC,KAAI,CAAC,IAAK;AAAA,MACnC,OAAO;AACL,WAAGD,EAAC,EAAGC,EAAC,IAAI,KAAK,IAAI,GAAGD,KAAI,CAAC,EAAGC,EAAC,GAAI,GAAGD,EAAC,EAAGC,KAAI,CAAC,CAAE;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AAGA,QAAM,SAAmB,CAAC;AAC1B,MAAI,IAAI;AACR,MAAI,IAAI;AACR,SAAO,IAAI,KAAK,IAAI,GAAG;AACrB,QAAI,OAAO,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,GAAG;AACnC,aAAO,KAAK,OAAO,IAAI,CAAC,CAAE;AAC1B;AACA;AAAA,IACF,WAAW,GAAG,IAAI,CAAC,EAAG,CAAC,IAAK,GAAG,CAAC,EAAG,IAAI,CAAC,GAAI;AAC1C;AAAA,IACF,OAAO;AACL;AAAA,IACF;AAAA,EACF;AAEA,SAAO,OAAO,QAAQ;AACxB;AAcO,SAAS,mBAAmB,QAAqB,QAA8B;AACpF,QAAM,SAAS,OAAO,MAAM,IAAI,CAAC,SAAmB,KAAK,EAAE;AAC3D,QAAM,SAAS,OAAO,MAAM,IAAI,CAAC,SAAmB,KAAK,EAAE;AAC3D,QAAM,SAAS,IAAI,IAAI,WAAW,QAAQ,MAAM,CAAC;AAEjD,QAAM,WAAW,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;AACtF,QAAM,WAA2C,CAAC;AAElD,MAAI,mBAAkC;AACtC,aAAW,WAAW,OAAO,OAAO;AAClC,QAAI,OAAO,IAAI,QAAQ,EAAE,GAAG;AAC1B,yBAAmB,QAAQ;AAAA,IAC7B,OAAO;AACL,YAAM,SAAS;AACf,eAAS,KAAK,CAAC,QAAQ,QAAQ,EAAE,CAAC;AAClC,yBAAmB,QAAQ;AAAA,IAC7B;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,aAAa,QAA8B,WAAoB,MAAmB;AAChG,MAAI,YAAY,MAAM,GAAG;AACvB,WAAO,sBAAsB,QAAQ,QAAQ;AAAA,EAC/C;AACA,SAAO;AACT;","names":["i","j"]}
+{"version":3,"sources":["../../src/llm/utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { VideoBufferType, VideoFrame } from '@livekit/rtc-node';\nimport type { JSONSchema7 } from 'json-schema';\nimport sharp from 'sharp';\nimport type { UnknownUserData } from '../voice/run_context.js';\nimport type { ChatContext } from './chat_context.js';\nimport {\n  type ChatItem,\n  FunctionCall,\n  FunctionCallOutput,\n  type ImageContent,\n} from './chat_context.js';\nimport type { ToolContext, ToolInputSchema, ToolOptions } from './tool_context.js';\nimport { isZodSchema, parseZodSchema, zodSchemaToJsonSchema } from './zod-utils.js';\n\nexport interface SerializedImage {\n  inferenceDetail: 'auto' | 'high' | 'low';\n  mimeType?: string;\n  base64Data?: string;\n  externalUrl?: string;\n}\n\nfunction getChannelsFromVideoBufferType(type: VideoBufferType): 3 | 4 {\n  switch (type) {\n    case VideoBufferType.RGBA:\n    case VideoBufferType.ABGR:\n    case VideoBufferType.ARGB:\n    case VideoBufferType.BGRA:\n      return 4;\n    case VideoBufferType.RGB24:\n      return 3;\n    default:\n      // YUV formats (I420, I420A, I422, I444, I010, NV12) need conversion\n      throw new Error(`Unsupported VideoBufferType: ${type}. Only RGB/RGBA formats are supported.`);\n  }\n}\n\nfunction ensureRGBCompatible(frame: VideoFrame): VideoFrame {\n  // If the frame is already in an RGB/RGBA-compatible format, return it directly\n  if (\n    frame.type === VideoBufferType.RGBA ||\n    frame.type === VideoBufferType.BGRA ||\n    frame.type === VideoBufferType.ARGB ||\n    frame.type === VideoBufferType.ABGR ||\n    frame.type === VideoBufferType.RGB24\n  ) {\n    return frame;\n  }\n\n  // Otherwise, attempt conversion for other formats (like YUV)\n  try {\n    return frame.convert(VideoBufferType.RGBA);\n  } catch (error) {\n    throw new Error(\n      `Failed to convert format ${frame.type} to RGB: ${error}. ` +\n        `Consider using RGB/RGBA formats or converting on the client side.`,\n    );\n  }\n}\n\nexport async function serializeImage(image: ImageContent): Promise<SerializedImage> {\n  if (typeof image.image === 'string') {\n    if (image.image.startsWith('data:')) {\n      const [header, base64Data] = image.image.split(',', 2) as [string, string];\n      const headerParts = header.split(';');\n      const mimeParts = headerParts[0]?.split(':');\n      const headerMime = mimeParts?.[1];\n\n      if (!headerMime) {\n        throw new Error('Invalid data URL format');\n      }\n\n      let mimeType: string;\n      if (image.mimeType && image.mimeType !== headerMime) {\n        console.warn(\n          `Provided mimeType '${image.mimeType}' does not match data URL mime type '${headerMime}'. Using provided mimeType.`,\n        );\n        mimeType = image.mimeType;\n      } else {\n        mimeType = headerMime;\n      }\n\n      const supportedTypes = new Set(['image/jpeg', 'image/png', 'image/webp', 'image/gif']);\n      if (!supportedTypes.has(mimeType)) {\n        throw new Error(`Unsupported mimeType ${mimeType}. Must be jpeg, png, webp, or gif`);\n      }\n\n      return {\n        base64Data,\n        mimeType: mimeType,\n        inferenceDetail: image.inferenceDetail,\n      };\n    }\n\n    // External URL\n    return {\n      mimeType: image.mimeType,\n      inferenceDetail: image.inferenceDetail,\n      externalUrl: image.image,\n    };\n  } else if (image.image instanceof VideoFrame) {\n    const frame = ensureRGBCompatible(image.image);\n    const channels = getChannelsFromVideoBufferType(frame.type);\n\n    // Sharp needs to know the format of raw pixel data\n    let encoded = sharp(frame.data, {\n      raw: {\n        width: frame.width,\n        height: frame.height,\n        channels,\n      },\n    });\n\n    if (image.inferenceWidth && image.inferenceHeight) {\n      encoded = encoded.resize(image.inferenceWidth, image.inferenceHeight);\n    }\n\n    const base64Data = await encoded\n      .png()\n      .toBuffer()\n      .then((buffer) => buffer.toString('base64'));\n\n    return {\n      base64Data,\n      mimeType: 'image/png',\n      inferenceDetail: image.inferenceDetail,\n    };\n  } else {\n    throw new Error('Unsupported image type');\n  }\n}\n\n/** Raw OpenAI-adherent function parameters. */\nexport type OpenAIFunctionParameters = {\n  type: 'object';\n  properties: { [id: string]: any }; // eslint-disable-line @typescript-eslint/no-explicit-any\n  required: string[];\n  additionalProperties?: boolean;\n};\n\n// TODO(brian): remove this helper once we have the real RunContext user data\nexport const createToolOptions = <UserData extends UnknownUserData>(\n  toolCallId: string,\n  userData: UserData = {} as UserData,\n): ToolOptions<UserData> => {\n  return { ctx: { userData }, toolCallId } as unknown as ToolOptions<UserData>;\n};\n\n/** @internal */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const oaiParams = (schema: any, isOpenai: boolean = true): OpenAIFunctionParameters => {\n  // Adapted from https://github.com/vercel/ai/blob/56eb0ee9/packages/provider-utils/src/zod-schema.ts\n  const jsonSchema = zodSchemaToJsonSchema(schema, isOpenai);\n  const { properties, required, additionalProperties } = jsonSchema as OpenAIFunctionParameters;\n\n  return {\n    type: 'object',\n    properties,\n    required,\n    additionalProperties,\n  };\n};\n\n/** @internal */\nexport const oaiBuildFunctionInfo = (\n  toolCtx: ToolContext,\n  toolCallId: string,\n  toolName: string,\n  rawArgs: string,\n): FunctionCall => {\n  const tool = toolCtx[toolName];\n  if (!tool) {\n    throw new Error(`AI tool ${toolName} not found`);\n  }\n\n  return FunctionCall.create({\n    callId: toolCallId,\n    name: toolName,\n    args: rawArgs,\n  });\n};\n\nexport async function executeToolCall(\n  toolCall: FunctionCall,\n  toolCtx: ToolContext,\n): Promise<FunctionCallOutput> {\n  const tool = toolCtx[toolCall.name]!;\n  let args: object | undefined;\n  let params: object | undefined;\n\n  // Ensure valid JSON\n  try {\n    args = JSON.parse(toolCall.args);\n  } catch (error) {\n    return FunctionCallOutput.create({\n      callId: toolCall.callId,\n      output: `Invalid JSON: ${error}`,\n      isError: true,\n    });\n  }\n\n  // Ensure valid arguments schema\n  try {\n    if (isZodSchema(tool.parameters)) {\n      const result = await parseZodSchema<object>(tool.parameters, args);\n      if (result.success) {\n        params = result.data;\n      } else {\n        return FunctionCallOutput.create({\n          callId: toolCall.callId,\n          output: `Arguments parsing failed: ${result.error}`,\n          isError: true,\n        });\n      }\n    } else {\n      params = args;\n    }\n  } catch (error) {\n    return FunctionCallOutput.create({\n      callId: toolCall.callId,\n      output: `Arguments parsing failed: ${error}`,\n      isError: true,\n    });\n  }\n\n  try {\n    const result = await tool.execute(params, createToolOptions(toolCall.callId));\n    return FunctionCallOutput.create({\n      callId: toolCall.callId,\n      output: JSON.stringify(result),\n      isError: false,\n    });\n  } catch (error) {\n    return FunctionCallOutput.create({\n      callId: toolCall.callId,\n      output: `Tool execution failed: ${error}`,\n      isError: true,\n    });\n  }\n}\n\n/**\n * Standard dynamic-programming LCS to get the common subsequence\n * of IDs (in order) that appear in both old_ids and new_ids.\n *\n * @param oldIds - The old list of IDs.\n * @param newIds - The new list of IDs.\n * @returns The longest common subsequence of the two lists of IDs.\n */\nfunction computeLCS(oldIds: string[], newIds: string[]): string[] {\n  const n = oldIds.length;\n  const m = newIds.length;\n  const dp: number[][] = Array(n + 1)\n    .fill(null)\n    .map(() => Array(m + 1).fill(0));\n\n  // Fill DP table\n  for (let i = 1; i <= n; i++) {\n    for (let j = 1; j <= m; j++) {\n      if (oldIds[i - 1] === newIds[j - 1]) {\n        dp[i]![j] = dp[i - 1]![j - 1]! + 1;\n      } else {\n        dp[i]![j] = Math.max(dp[i - 1]![j]!, dp[i]![j - 1]!);\n      }\n    }\n  }\n\n  // Backtrack to find the actual LCS sequence\n  const lcsIds: string[] = [];\n  let i = n;\n  let j = m;\n  while (i > 0 && j > 0) {\n    if (oldIds[i - 1] === newIds[j - 1]) {\n      lcsIds.push(oldIds[i - 1]!);\n      i--;\n      j--;\n    } else if (dp[i - 1]![j]! > dp[i]![j - 1]!) {\n      i--;\n    } else {\n      j--;\n    }\n  }\n\n  return lcsIds.reverse();\n}\n\ninterface DiffOps {\n  toRemove: string[];\n  toCreate: Array<[string | null, string]>; // (previous_item_id, id), if previous_item_id is null, add to the root\n}\n\n/**\n * Compute the minimal list of create/remove operations to transform oldCtx into newCtx.\n *\n * @param oldCtx - The old chat context.\n * @param newCtx - The new chat context.\n * @returns The minimal list of create/remove operations to transform oldCtx into newCtx.\n */\nexport function computeChatCtxDiff(oldCtx: ChatContext, newCtx: ChatContext): DiffOps {\n  const oldIds = oldCtx.items.map((item: ChatItem) => item.id);\n  const newIds = newCtx.items.map((item: ChatItem) => item.id);\n  const lcsIds = new Set(computeLCS(oldIds, newIds));\n\n  const toRemove = oldCtx.items.filter((msg) => !lcsIds.has(msg.id)).map((msg) => msg.id);\n  const toCreate: Array<[string | null, string]> = [];\n\n  let lastIdInSequence: string | null = null;\n  for (const newItem of newCtx.items) {\n    if (lcsIds.has(newItem.id)) {\n      lastIdInSequence = newItem.id;\n    } else {\n      const prevId = lastIdInSequence; // null if root\n      toCreate.push([prevId, newItem.id]);\n      lastIdInSequence = newItem.id;\n    }\n  }\n\n  return {\n    toRemove,\n    toCreate,\n  };\n}\n\nexport function toJsonSchema(\n  schema: ToolInputSchema<any>,\n  isOpenai: boolean = true,\n  strict: boolean = false,\n): JSONSchema7 {\n  if (isZodSchema(schema)) {\n    return zodSchemaToJsonSchema(schema, isOpenai, strict);\n  }\n\n  return schema as JSONSchema7;\n}\n"],"mappings":"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","names":["i","j"]}

package/dist/llm/zod-utils.cjs

@@ -35,6 +35,7 @@ __export(zod_utils_exports, {
   zodSchemaToJsonSchema: () => zodSchemaToJsonSchema
 });
 module.exports = __toCommonJS(zod_utils_exports);
+var import_transform = require("openai/lib/transform");
 var import_zod_to_json_schema = require("zod-to-json-schema");
 var z4 = __toESM(require("zod/v4"), 1);
 function isZod4Schema(schema) {
@@ -63,21 +64,23 @@ function isZodObjectSchema(schema) {
   }
   return ((_d = schemaWithInternals._def) == null ? void 0 : _d.typeName) === "ZodObject";
 }
-function zodSchemaToJsonSchema(schema, isOpenai = true) {
+function zodSchemaToJsonSchema(schema, isOpenai = true, strict = false) {
+  let result;
   if (isZod4Schema(schema)) {
-    return z4.toJSONSchema(schema, {
+    result = z4.toJSONSchema(schema, {
       target: "draft-7",
       io: "output",
       reused: "inline"
       // Don't use references by default (to support openapi conversion for google)
     });
   } else {
-    return (0, import_zod_to_json_schema.zodToJsonSchema)(schema, {
+    result = (0, import_zod_to_json_schema.zodToJsonSchema)(schema, {
       target: isOpenai ? "openAi" : "jsonSchema7",
       $refStrategy: "none"
       // Don't use references by default (to support openapi conversion for google)
     });
   }
+  return strict ? (0, import_transform.toStrictJsonSchema)(result) : result;
 }
 async function parseZodSchema(schema, value) {
   if (isZod4Schema(schema)) {

package/dist/llm/zod-utils.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/llm/zod-utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { JSONSchema7 } from 'json-schema';\nimport { zodToJsonSchema as zodToJsonSchemaV3 } from 'zod-to-json-schema';\nimport type * as z3 from 'zod/v3';\nimport * as z4 from 'zod/v4';\n\n/**\n * Result type from Zod schema parsing.\n */\nexport type ZodParseResult<T = unknown> =\n  | { success: true; data: T }\n  | { success: false; error: unknown };\n\n/**\n * Type definition for Zod schemas that works with both v3 and v4.\n * Uses a union type of both Zod v3 and v4 schema types.\n *\n * Adapted from Vercel AI SDK's zodSchema function signature.\n * Source: https://github.com/vercel/ai/blob/main/packages/provider-utils/src/schema.ts#L278-L281\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type ZodSchema = z4.core.$ZodType<any, any> | z3.Schema<any, z3.ZodTypeDef, any>;\n\n/**\n * Detects if a schema is a Zod v4 schema.\n * Zod v4 schemas have a `_zod` property that v3 schemas don't have.\n *\n * @param schema - The schema to check\n * @returns True if the schema is a Zod v4 schema\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Required to match Zod v4's type signature\nexport function isZod4Schema(schema: ZodSchema): schema is z4.core.$ZodType<any, any> {\n  // https://zod.dev/library-authors?id=how-to-support-zod-3-and-zod-4-simultaneously\n  return '_zod' in schema;\n}\n\n/**\n * Checks if a value is a Zod schema (either v3 or v4).\n *\n * @param value - The value to check\n * @returns True if the value is a Zod schema\n */\nexport function isZodSchema(value: unknown): value is ZodSchema {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n\n  // Check for v4 schema (_zod property)\n  if ('_zod' in value) {\n    return true;\n  }\n\n  // Check for v3 schema (_def property with typeName)\n  if ('_def' in value && typeof value._def === 'object' && value._def !== null) {\n    const def = value._def as Record<string, unknown>;\n    if ('typeName' in def) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Checks if a Zod schema is an object schema.\n *\n * @param schema - The schema to check\n * @returns True if the schema is an object schema\n */\nexport function isZodObjectSchema(schema: ZodSchema): boolean {\n  // Need to access internal Zod properties to check schema type\n  const schemaWithInternals = schema as {\n    _def?: { type?: string; typeName?: string };\n    _zod?: { traits?: Set<string> };\n  };\n\n  // Check for v4 schema first\n  if (isZod4Schema(schema)) {\n    // v4 uses _def.type and _zod.traits\n    return (\n      schemaWithInternals._def?.type === 'object' ||\n      schemaWithInternals._zod?.traits?.has('ZodObject') ||\n      false\n    );\n  }\n\n  // v3 uses _def.typeName\n  return schemaWithInternals._def?.typeName === 'ZodObject';\n}\n\n/**\n * Converts a Zod schema to JSON Schema format.\n * Handles both Zod v3 and v4 schemas automatically.\n *\n * Adapted from Vercel AI SDK's zod3Schema and zod4Schema functions.\n * Source: https://github.com/vercel/ai/blob/main/packages/provider-utils/src/schema.ts#L237-L269\n *\n * @param schema - The Zod schema to convert\n * @param isOpenai - Whether to use OpenAI-specific formatting (default: true)\n * @returns A JSON Schema representation of the Zod schema\n */\nexport function zodSchemaToJsonSchema(schema: ZodSchema, isOpenai: boolean = true): JSONSchema7 {\n  if (isZod4Schema(schema)) {\n    // Zod v4 has native toJSONSchema support\n    // Configuration adapted from Vercel AI SDK to support OpenAPI conversion for Google\n    // Source: https://github.com/vercel/ai/blob/main/packages/provider-utils/src/schema.ts#L255-L258\n    return z4.toJSONSchema(schema, {\n      target: 'draft-7',\n      io: 'output',\n      reused: 'inline', // Don't use references by default (to support openapi conversion for google)\n    }) as JSONSchema7;\n  } else {\n    // Zod v3 requires the zod-to-json-schema library\n    // Configuration adapted from Vercel AI SDK\n    // $refStrategy: 'none' is equivalent to v4's reused: 'inline'\n    return zodToJsonSchemaV3(schema, {\n      target: isOpenai ? 'openAi' : 'jsonSchema7',\n      $refStrategy: 'none', // Don't use references by default (to support openapi conversion for google)\n    }) as JSONSchema7;\n  }\n}\n\n/**\n * Parses a value against a Zod schema.\n * Handles both Zod v3 and v4 parse APIs automatically.\n *\n * @param schema - The Zod schema to parse against\n * @param value - The value to parse\n * @returns A promise that resolves to the parse result\n */\nexport async function parseZodSchema<T = unknown>(\n  schema: ZodSchema,\n  value: unknown,\n): Promise<ZodParseResult<T>> {\n  if (isZod4Schema(schema)) {\n    const result = await z4.safeParseAsync(schema, value);\n    return result as ZodParseResult<T>;\n  } else {\n    const result = await schema.safeParseAsync(value);\n    return result as ZodParseResult<T>;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,gCAAqD;AAErD,SAAoB;AA2Bb,SAAS,aAAa,QAAyD;AAEpF,SAAO,UAAU;AACnB;AAQO,SAAS,YAAY,OAAoC;AAC9D,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO;AAAA,EACT;AAGA,MAAI,UAAU,OAAO;AACnB,WAAO;AAAA,EACT;AAGA,MAAI,UAAU,SAAS,OAAO,MAAM,SAAS,YAAY,MAAM,SAAS,MAAM;AAC5E,UAAM,MAAM,MAAM;AAClB,QAAI,cAAc,KAAK;AACrB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,kBAAkB,QAA4B;AAvE9D;AAyEE,QAAM,sBAAsB;AAM5B,MAAI,aAAa,MAAM,GAAG;AAExB,aACE,yBAAoB,SAApB,mBAA0B,UAAS,cACnC,+BAAoB,SAApB,mBAA0B,WAA1B,mBAAkC,IAAI,iBACtC;AAAA,EAEJ;AAGA,WAAO,yBAAoB,SAApB,mBAA0B,cAAa;AAChD;AAaO,SAAS,sBAAsB,QAAmB,WAAoB,MAAmB;AAC9F,MAAI,aAAa,MAAM,GAAG;AAIxB,WAAO,GAAG,aAAa,QAAQ;AAAA,MAC7B,QAAQ;AAAA,MACR,IAAI;AAAA,MACJ,QAAQ;AAAA;AAAA,IACV,CAAC;AAAA,EACH,OAAO;AAIL,eAAO,0BAAAA,iBAAkB,QAAQ;AAAA,MAC/B,QAAQ,WAAW,WAAW;AAAA,MAC9B,cAAc;AAAA;AAAA,IAChB,CAAC;AAAA,EACH;AACF;AAUA,eAAsB,eACpB,QACA,OAC4B;AAC5B,MAAI,aAAa,MAAM,GAAG;AACxB,UAAM,SAAS,MAAM,GAAG,eAAe,QAAQ,KAAK;AACpD,WAAO;AAAA,EACT,OAAO;AACL,UAAM,SAAS,MAAM,OAAO,eAAe,KAAK;AAChD,WAAO;AAAA,EACT;AACF;","names":["zodToJsonSchemaV3"]}
+{"version":3,"sources":["../../src/llm/zod-utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { JSONSchema7 } from 'json-schema';\nimport { toStrictJsonSchema } from 'openai/lib/transform';\nimport { zodToJsonSchema as zodToJsonSchemaV3 } from 'zod-to-json-schema';\nimport type * as z3 from 'zod/v3';\nimport * as z4 from 'zod/v4';\n\n/**\n * Result type from Zod schema parsing.\n */\nexport type ZodParseResult<T = unknown> =\n  | { success: true; data: T }\n  | { success: false; error: unknown };\n\n/**\n * Type definition for Zod schemas that works with both v3 and v4.\n * Uses a union type of both Zod v3 and v4 schema types.\n *\n * Adapted from Vercel AI SDK's zodSchema function signature.\n * Source: https://github.com/vercel/ai/blob/main/packages/provider-utils/src/schema.ts#L278-L281\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type ZodSchema = z4.core.$ZodType<any, any> | z3.Schema<any, z3.ZodTypeDef, any>;\n\n/**\n * Detects if a schema is a Zod v4 schema.\n * Zod v4 schemas have a `_zod` property that v3 schemas don't have.\n *\n * @param schema - The schema to check\n * @returns True if the schema is a Zod v4 schema\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Required to match Zod v4's type signature\nexport function isZod4Schema(schema: ZodSchema): schema is z4.core.$ZodType<any, any> {\n  // https://zod.dev/library-authors?id=how-to-support-zod-3-and-zod-4-simultaneously\n  return '_zod' in schema;\n}\n\n/**\n * Checks if a value is a Zod schema (either v3 or v4).\n *\n * @param value - The value to check\n * @returns True if the value is a Zod schema\n */\nexport function isZodSchema(value: unknown): value is ZodSchema {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n\n  // Check for v4 schema (_zod property)\n  if ('_zod' in value) {\n    return true;\n  }\n\n  // Check for v3 schema (_def property with typeName)\n  if ('_def' in value && typeof value._def === 'object' && value._def !== null) {\n    const def = value._def as Record<string, unknown>;\n    if ('typeName' in def) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Checks if a Zod schema is an object schema.\n *\n * @param schema - The schema to check\n * @returns True if the schema is an object schema\n */\nexport function isZodObjectSchema(schema: ZodSchema): boolean {\n  // Need to access internal Zod properties to check schema type\n  const schemaWithInternals = schema as {\n    _def?: { type?: string; typeName?: string };\n    _zod?: { traits?: Set<string> };\n  };\n\n  // Check for v4 schema first\n  if (isZod4Schema(schema)) {\n    // v4 uses _def.type and _zod.traits\n    return (\n      schemaWithInternals._def?.type === 'object' ||\n      schemaWithInternals._zod?.traits?.has('ZodObject') ||\n      false\n    );\n  }\n\n  // v3 uses _def.typeName\n  return schemaWithInternals._def?.typeName === 'ZodObject';\n}\n\n/**\n * Converts a Zod schema to JSON Schema format.\n * Handles both Zod v3 and v4 schemas automatically.\n *\n * Adapted from Vercel AI SDK's zod3Schema and zod4Schema functions.\n * Source: https://github.com/vercel/ai/blob/main/packages/provider-utils/src/schema.ts#L237-L269\n *\n * @param schema - The Zod schema to convert\n * @param isOpenai - Whether to use OpenAI-specific formatting (default: true)\n * @returns A JSON Schema representation of the Zod schema\n */\nexport function zodSchemaToJsonSchema(\n  schema: ZodSchema,\n  isOpenai: boolean = true,\n  strict: boolean = false,\n): JSONSchema7 {\n  let result: JSONSchema7;\n\n  if (isZod4Schema(schema)) {\n    // Zod v4 has native toJSONSchema support\n    // Configuration adapted from Vercel AI SDK to support OpenAPI conversion for Google\n    // Source: https://github.com/vercel/ai/blob/main/packages/provider-utils/src/schema.ts#L255-L258\n    result = z4.toJSONSchema(schema, {\n      target: 'draft-7',\n      io: 'output',\n      reused: 'inline', // Don't use references by default (to support openapi conversion for google)\n    }) as JSONSchema7;\n  } else {\n    // Zod v3 requires the zod-to-json-schema library\n    // Configuration adapted from Vercel AI SDK\n    // $refStrategy: 'none' is equivalent to v4's reused: 'inline'\n    result = zodToJsonSchemaV3(schema, {\n      target: isOpenai ? 'openAi' : 'jsonSchema7',\n      $refStrategy: 'none', // Don't use references by default (to support openapi conversion for google)\n    }) as JSONSchema7;\n  }\n\n  return strict ? (toStrictJsonSchema(result) as JSONSchema7) : result;\n}\n\n/**\n * Parses a value against a Zod schema.\n * Handles both Zod v3 and v4 parse APIs automatically.\n *\n * @param schema - The Zod schema to parse against\n * @param value - The value to parse\n * @returns A promise that resolves to the parse result\n */\nexport async function parseZodSchema<T = unknown>(\n  schema: ZodSchema,\n  value: unknown,\n): Promise<ZodParseResult<T>> {\n  if (isZod4Schema(schema)) {\n    const result = await z4.safeParseAsync(schema, value);\n    return result as ZodParseResult<T>;\n  } else {\n    const result = await schema.safeParseAsync(value);\n    return result as ZodParseResult<T>;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,uBAAmC;AACnC,gCAAqD;AAErD,SAAoB;AA2Bb,SAAS,aAAa,QAAyD;AAEpF,SAAO,UAAU;AACnB;AAQO,SAAS,YAAY,OAAoC;AAC9D,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO;AAAA,EACT;AAGA,MAAI,UAAU,OAAO;AACnB,WAAO;AAAA,EACT;AAGA,MAAI,UAAU,SAAS,OAAO,MAAM,SAAS,YAAY,MAAM,SAAS,MAAM;AAC5E,UAAM,MAAM,MAAM;AAClB,QAAI,cAAc,KAAK;AACrB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,kBAAkB,QAA4B;AAxE9D;AA0EE,QAAM,sBAAsB;AAM5B,MAAI,aAAa,MAAM,GAAG;AAExB,aACE,yBAAoB,SAApB,mBAA0B,UAAS,cACnC,+BAAoB,SAApB,mBAA0B,WAA1B,mBAAkC,IAAI,iBACtC;AAAA,EAEJ;AAGA,WAAO,yBAAoB,SAApB,mBAA0B,cAAa;AAChD;AAaO,SAAS,sBACd,QACA,WAAoB,MACpB,SAAkB,OACL;AACb,MAAI;AAEJ,MAAI,aAAa,MAAM,GAAG;AAIxB,aAAS,GAAG,aAAa,QAAQ;AAAA,MAC/B,QAAQ;AAAA,MACR,IAAI;AAAA,MACJ,QAAQ;AAAA;AAAA,IACV,CAAC;AAAA,EACH,OAAO;AAIL,iBAAS,0BAAAA,iBAAkB,QAAQ;AAAA,MACjC,QAAQ,WAAW,WAAW;AAAA,MAC9B,cAAc;AAAA;AAAA,IAChB,CAAC;AAAA,EACH;AAEA,SAAO,aAAU,qCAAmB,MAAM,IAAoB;AAChE;AAUA,eAAsB,eACpB,QACA,OAC4B;AAC5B,MAAI,aAAa,MAAM,GAAG;AACxB,UAAM,SAAS,MAAM,GAAG,eAAe,QAAQ,KAAK;AACpD,WAAO;AAAA,EACT,OAAO;AACL,UAAM,SAAS,MAAM,OAAO,eAAe,KAAK;AAChD,WAAO;AAAA,EACT;AACF;","names":["zodToJsonSchemaV3"]}

package/dist/llm/zod-utils.d.cts

@@ -52,7 +52,7 @@ export declare function isZodObjectSchema(schema: ZodSchema): boolean;
  * @param isOpenai - Whether to use OpenAI-specific formatting (default: true)
  * @returns A JSON Schema representation of the Zod schema
  */
-export declare function zodSchemaToJsonSchema(schema: ZodSchema, isOpenai?: boolean): JSONSchema7;
+export declare function zodSchemaToJsonSchema(schema: ZodSchema, isOpenai?: boolean, strict?: boolean): JSONSchema7;
 /**
  * Parses a value against a Zod schema.
  * Handles both Zod v3 and v4 parse APIs automatically.

package/dist/llm/zod-utils.d.ts

@@ -52,7 +52,7 @@ export declare function isZodObjectSchema(schema: ZodSchema): boolean;
  * @param isOpenai - Whether to use OpenAI-specific formatting (default: true)
  * @returns A JSON Schema representation of the Zod schema
  */
-export declare function zodSchemaToJsonSchema(schema: ZodSchema, isOpenai?: boolean): JSONSchema7;
+export declare function zodSchemaToJsonSchema(schema: ZodSchema, isOpenai?: boolean, strict?: boolean): JSONSchema7;
 /**
  * Parses a value against a Zod schema.
  * Handles both Zod v3 and v4 parse APIs automatically.

package/dist/llm/zod-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zod-utils.d.ts","sourceRoot":"","sources":["../../src/llm/zod-utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAClC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvC;;;;;;GAMG;AAEH,MAAM,MAAM,SAAS,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;AAExF;;;;;;GAMG;AAEH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAGpF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAmB9D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAmB5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAE,OAAc,GAAG,WAAW,CAmB9F;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAQ5B"}
+{"version":3,"file":"zod-utils.d.ts","sourceRoot":"","sources":["../../src/llm/zod-utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAClC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvC;;;;;;GAMG;AAEH,MAAM,MAAM,SAAS,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;AAExF;;;;;;GAMG;AAEH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAGpF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAmB9D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAmB5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,OAAc,EACxB,MAAM,GAAE,OAAe,GACtB,WAAW,CAuBb;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAQ5B"}

package/dist/llm/zod-utils.js

@@ -1,3 +1,4 @@
+import { toStrictJsonSchema } from "openai/lib/transform";
 import { zodToJsonSchema as zodToJsonSchemaV3 } from "zod-to-json-schema";
 import * as z4 from "zod/v4";
 function isZod4Schema(schema) {
@@ -26,21 +27,23 @@ function isZodObjectSchema(schema) {
   }
   return ((_d = schemaWithInternals._def) == null ? void 0 : _d.typeName) === "ZodObject";
 }
-function zodSchemaToJsonSchema(schema, isOpenai = true) {
+function zodSchemaToJsonSchema(schema, isOpenai = true, strict = false) {
+  let result;
   if (isZod4Schema(schema)) {
-    return z4.toJSONSchema(schema, {
+    result = z4.toJSONSchema(schema, {
       target: "draft-7",
       io: "output",
       reused: "inline"
       // Don't use references by default (to support openapi conversion for google)
     });
   } else {
-    return zodToJsonSchemaV3(schema, {
+    result = zodToJsonSchemaV3(schema, {
       target: isOpenai ? "openAi" : "jsonSchema7",
       $refStrategy: "none"
       // Don't use references by default (to support openapi conversion for google)
     });
   }
+  return strict ? toStrictJsonSchema(result) : result;
 }
 async function parseZodSchema(schema, value) {
   if (isZod4Schema(schema)) {

package/dist/llm/zod-utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/llm/zod-utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { JSONSchema7 } from 'json-schema';\nimport { zodToJsonSchema as zodToJsonSchemaV3 } from 'zod-to-json-schema';\nimport type * as z3 from 'zod/v3';\nimport * as z4 from 'zod/v4';\n\n/**\n * Result type from Zod schema parsing.\n */\nexport type ZodParseResult<T = unknown> =\n  | { success: true; data: T }\n  | { success: false; error: unknown };\n\n/**\n * Type definition for Zod schemas that works with both v3 and v4.\n * Uses a union type of both Zod v3 and v4 schema types.\n *\n * Adapted from Vercel AI SDK's zodSchema function signature.\n * Source: https://github.com/vercel/ai/blob/main/packages/provider-utils/src/schema.ts#L278-L281\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type ZodSchema = z4.core.$ZodType<any, any> | z3.Schema<any, z3.ZodTypeDef, any>;\n\n/**\n * Detects if a schema is a Zod v4 schema.\n * Zod v4 schemas have a `_zod` property that v3 schemas don't have.\n *\n * @param schema - The schema to check\n * @returns True if the schema is a Zod v4 schema\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Required to match Zod v4's type signature\nexport function isZod4Schema(schema: ZodSchema): schema is z4.core.$ZodType<any, any> {\n  // https://zod.dev/library-authors?id=how-to-support-zod-3-and-zod-4-simultaneously\n  return '_zod' in schema;\n}\n\n/**\n * Checks if a value is a Zod schema (either v3 or v4).\n *\n * @param value - The value to check\n * @returns True if the value is a Zod schema\n */\nexport function isZodSchema(value: unknown): value is ZodSchema {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n\n  // Check for v4 schema (_zod property)\n  if ('_zod' in value) {\n    return true;\n  }\n\n  // Check for v3 schema (_def property with typeName)\n  if ('_def' in value && typeof value._def === 'object' && value._def !== null) {\n    const def = value._def as Record<string, unknown>;\n    if ('typeName' in def) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Checks if a Zod schema is an object schema.\n *\n * @param schema - The schema to check\n * @returns True if the schema is an object schema\n */\nexport function isZodObjectSchema(schema: ZodSchema): boolean {\n  // Need to access internal Zod properties to check schema type\n  const schemaWithInternals = schema as {\n    _def?: { type?: string; typeName?: string };\n    _zod?: { traits?: Set<string> };\n  };\n\n  // Check for v4 schema first\n  if (isZod4Schema(schema)) {\n    // v4 uses _def.type and _zod.traits\n    return (\n      schemaWithInternals._def?.type === 'object' ||\n      schemaWithInternals._zod?.traits?.has('ZodObject') ||\n      false\n    );\n  }\n\n  // v3 uses _def.typeName\n  return schemaWithInternals._def?.typeName === 'ZodObject';\n}\n\n/**\n * Converts a Zod schema to JSON Schema format.\n * Handles both Zod v3 and v4 schemas automatically.\n *\n * Adapted from Vercel AI SDK's zod3Schema and zod4Schema functions.\n * Source: https://github.com/vercel/ai/blob/main/packages/provider-utils/src/schema.ts#L237-L269\n *\n * @param schema - The Zod schema to convert\n * @param isOpenai - Whether to use OpenAI-specific formatting (default: true)\n * @returns A JSON Schema representation of the Zod schema\n */\nexport function zodSchemaToJsonSchema(schema: ZodSchema, isOpenai: boolean = true): JSONSchema7 {\n  if (isZod4Schema(schema)) {\n    // Zod v4 has native toJSONSchema support\n    // Configuration adapted from Vercel AI SDK to support OpenAPI conversion for Google\n    // Source: https://github.com/vercel/ai/blob/main/packages/provider-utils/src/schema.ts#L255-L258\n    return z4.toJSONSchema(schema, {\n      target: 'draft-7',\n      io: 'output',\n      reused: 'inline', // Don't use references by default (to support openapi conversion for google)\n    }) as JSONSchema7;\n  } else {\n    // Zod v3 requires the zod-to-json-schema library\n    // Configuration adapted from Vercel AI SDK\n    // $refStrategy: 'none' is equivalent to v4's reused: 'inline'\n    return zodToJsonSchemaV3(schema, {\n      target: isOpenai ? 'openAi' : 'jsonSchema7',\n      $refStrategy: 'none', // Don't use references by default (to support openapi conversion for google)\n    }) as JSONSchema7;\n  }\n}\n\n/**\n * Parses a value against a Zod schema.\n * Handles both Zod v3 and v4 parse APIs automatically.\n *\n * @param schema - The Zod schema to parse against\n * @param value - The value to parse\n * @returns A promise that resolves to the parse result\n */\nexport async function parseZodSchema<T = unknown>(\n  schema: ZodSchema,\n  value: unknown,\n): Promise<ZodParseResult<T>> {\n  if (isZod4Schema(schema)) {\n    const result = await z4.safeParseAsync(schema, value);\n    return result as ZodParseResult<T>;\n  } else {\n    const result = await schema.safeParseAsync(value);\n    return result as ZodParseResult<T>;\n  }\n}\n"],"mappings":"AAIA,SAAS,mBAAmB,yBAAyB;AAErD,YAAY,QAAQ;AA2Bb,SAAS,aAAa,QAAyD;AAEpF,SAAO,UAAU;AACnB;AAQO,SAAS,YAAY,OAAoC;AAC9D,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO;AAAA,EACT;AAGA,MAAI,UAAU,OAAO;AACnB,WAAO;AAAA,EACT;AAGA,MAAI,UAAU,SAAS,OAAO,MAAM,SAAS,YAAY,MAAM,SAAS,MAAM;AAC5E,UAAM,MAAM,MAAM;AAClB,QAAI,cAAc,KAAK;AACrB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,kBAAkB,QAA4B;AAvE9D;AAyEE,QAAM,sBAAsB;AAM5B,MAAI,aAAa,MAAM,GAAG;AAExB,aACE,yBAAoB,SAApB,mBAA0B,UAAS,cACnC,+BAAoB,SAApB,mBAA0B,WAA1B,mBAAkC,IAAI,iBACtC;AAAA,EAEJ;AAGA,WAAO,yBAAoB,SAApB,mBAA0B,cAAa;AAChD;AAaO,SAAS,sBAAsB,QAAmB,WAAoB,MAAmB;AAC9F,MAAI,aAAa,MAAM,GAAG;AAIxB,WAAO,GAAG,aAAa,QAAQ;AAAA,MAC7B,QAAQ;AAAA,MACR,IAAI;AAAA,MACJ,QAAQ;AAAA;AAAA,IACV,CAAC;AAAA,EACH,OAAO;AAIL,WAAO,kBAAkB,QAAQ;AAAA,MAC/B,QAAQ,WAAW,WAAW;AAAA,MAC9B,cAAc;AAAA;AAAA,IAChB,CAAC;AAAA,EACH;AACF;AAUA,eAAsB,eACpB,QACA,OAC4B;AAC5B,MAAI,aAAa,MAAM,GAAG;AACxB,UAAM,SAAS,MAAM,GAAG,eAAe,QAAQ,KAAK;AACpD,WAAO;AAAA,EACT,OAAO;AACL,UAAM,SAAS,MAAM,OAAO,eAAe,KAAK;AAChD,WAAO;AAAA,EACT;AACF;","names":[]}
+{"version":3,"sources":["../../src/llm/zod-utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { JSONSchema7 } from 'json-schema';\nimport { toStrictJsonSchema } from 'openai/lib/transform';\nimport { zodToJsonSchema as zodToJsonSchemaV3 } from 'zod-to-json-schema';\nimport type * as z3 from 'zod/v3';\nimport * as z4 from 'zod/v4';\n\n/**\n * Result type from Zod schema parsing.\n */\nexport type ZodParseResult<T = unknown> =\n  | { success: true; data: T }\n  | { success: false; error: unknown };\n\n/**\n * Type definition for Zod schemas that works with both v3 and v4.\n * Uses a union type of both Zod v3 and v4 schema types.\n *\n * Adapted from Vercel AI SDK's zodSchema function signature.\n * Source: https://github.com/vercel/ai/blob/main/packages/provider-utils/src/schema.ts#L278-L281\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type ZodSchema = z4.core.$ZodType<any, any> | z3.Schema<any, z3.ZodTypeDef, any>;\n\n/**\n * Detects if a schema is a Zod v4 schema.\n * Zod v4 schemas have a `_zod` property that v3 schemas don't have.\n *\n * @param schema - The schema to check\n * @returns True if the schema is a Zod v4 schema\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Required to match Zod v4's type signature\nexport function isZod4Schema(schema: ZodSchema): schema is z4.core.$ZodType<any, any> {\n  // https://zod.dev/library-authors?id=how-to-support-zod-3-and-zod-4-simultaneously\n  return '_zod' in schema;\n}\n\n/**\n * Checks if a value is a Zod schema (either v3 or v4).\n *\n * @param value - The value to check\n * @returns True if the value is a Zod schema\n */\nexport function isZodSchema(value: unknown): value is ZodSchema {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n\n  // Check for v4 schema (_zod property)\n  if ('_zod' in value) {\n    return true;\n  }\n\n  // Check for v3 schema (_def property with typeName)\n  if ('_def' in value && typeof value._def === 'object' && value._def !== null) {\n    const def = value._def as Record<string, unknown>;\n    if ('typeName' in def) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Checks if a Zod schema is an object schema.\n *\n * @param schema - The schema to check\n * @returns True if the schema is an object schema\n */\nexport function isZodObjectSchema(schema: ZodSchema): boolean {\n  // Need to access internal Zod properties to check schema type\n  const schemaWithInternals = schema as {\n    _def?: { type?: string; typeName?: string };\n    _zod?: { traits?: Set<string> };\n  };\n\n  // Check for v4 schema first\n  if (isZod4Schema(schema)) {\n    // v4 uses _def.type and _zod.traits\n    return (\n      schemaWithInternals._def?.type === 'object' ||\n      schemaWithInternals._zod?.traits?.has('ZodObject') ||\n      false\n    );\n  }\n\n  // v3 uses _def.typeName\n  return schemaWithInternals._def?.typeName === 'ZodObject';\n}\n\n/**\n * Converts a Zod schema to JSON Schema format.\n * Handles both Zod v3 and v4 schemas automatically.\n *\n * Adapted from Vercel AI SDK's zod3Schema and zod4Schema functions.\n * Source: https://github.com/vercel/ai/blob/main/packages/provider-utils/src/schema.ts#L237-L269\n *\n * @param schema - The Zod schema to convert\n * @param isOpenai - Whether to use OpenAI-specific formatting (default: true)\n * @returns A JSON Schema representation of the Zod schema\n */\nexport function zodSchemaToJsonSchema(\n  schema: ZodSchema,\n  isOpenai: boolean = true,\n  strict: boolean = false,\n): JSONSchema7 {\n  let result: JSONSchema7;\n\n  if (isZod4Schema(schema)) {\n    // Zod v4 has native toJSONSchema support\n    // Configuration adapted from Vercel AI SDK to support OpenAPI conversion for Google\n    // Source: https://github.com/vercel/ai/blob/main/packages/provider-utils/src/schema.ts#L255-L258\n    result = z4.toJSONSchema(schema, {\n      target: 'draft-7',\n      io: 'output',\n      reused: 'inline', // Don't use references by default (to support openapi conversion for google)\n    }) as JSONSchema7;\n  } else {\n    // Zod v3 requires the zod-to-json-schema library\n    // Configuration adapted from Vercel AI SDK\n    // $refStrategy: 'none' is equivalent to v4's reused: 'inline'\n    result = zodToJsonSchemaV3(schema, {\n      target: isOpenai ? 'openAi' : 'jsonSchema7',\n      $refStrategy: 'none', // Don't use references by default (to support openapi conversion for google)\n    }) as JSONSchema7;\n  }\n\n  return strict ? (toStrictJsonSchema(result) as JSONSchema7) : result;\n}\n\n/**\n * Parses a value against a Zod schema.\n * Handles both Zod v3 and v4 parse APIs automatically.\n *\n * @param schema - The Zod schema to parse against\n * @param value - The value to parse\n * @returns A promise that resolves to the parse result\n */\nexport async function parseZodSchema<T = unknown>(\n  schema: ZodSchema,\n  value: unknown,\n): Promise<ZodParseResult<T>> {\n  if (isZod4Schema(schema)) {\n    const result = await z4.safeParseAsync(schema, value);\n    return result as ZodParseResult<T>;\n  } else {\n    const result = await schema.safeParseAsync(value);\n    return result as ZodParseResult<T>;\n  }\n}\n"],"mappings":"AAIA,SAAS,0BAA0B;AACnC,SAAS,mBAAmB,yBAAyB;AAErD,YAAY,QAAQ;AA2Bb,SAAS,aAAa,QAAyD;AAEpF,SAAO,UAAU;AACnB;AAQO,SAAS,YAAY,OAAoC;AAC9D,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO;AAAA,EACT;AAGA,MAAI,UAAU,OAAO;AACnB,WAAO;AAAA,EACT;AAGA,MAAI,UAAU,SAAS,OAAO,MAAM,SAAS,YAAY,MAAM,SAAS,MAAM;AAC5E,UAAM,MAAM,MAAM;AAClB,QAAI,cAAc,KAAK;AACrB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,kBAAkB,QAA4B;AAxE9D;AA0EE,QAAM,sBAAsB;AAM5B,MAAI,aAAa,MAAM,GAAG;AAExB,aACE,yBAAoB,SAApB,mBAA0B,UAAS,cACnC,+BAAoB,SAApB,mBAA0B,WAA1B,mBAAkC,IAAI,iBACtC;AAAA,EAEJ;AAGA,WAAO,yBAAoB,SAApB,mBAA0B,cAAa;AAChD;AAaO,SAAS,sBACd,QACA,WAAoB,MACpB,SAAkB,OACL;AACb,MAAI;AAEJ,MAAI,aAAa,MAAM,GAAG;AAIxB,aAAS,GAAG,aAAa,QAAQ;AAAA,MAC/B,QAAQ;AAAA,MACR,IAAI;AAAA,MACJ,QAAQ;AAAA;AAAA,IACV,CAAC;AAAA,EACH,OAAO;AAIL,aAAS,kBAAkB,QAAQ;AAAA,MACjC,QAAQ,WAAW,WAAW;AAAA,MAC9B,cAAc;AAAA;AAAA,IAChB,CAAC;AAAA,EACH;AAEA,SAAO,SAAU,mBAAmB,MAAM,IAAoB;AAChE;AAUA,eAAsB,eACpB,QACA,OAC4B;AAC5B,MAAI,aAAa,MAAM,GAAG;AACxB,UAAM,SAAS,MAAM,GAAG,eAAe,QAAQ,KAAK;AACpD,WAAO;AAAA,EACT,OAAO;AACL,UAAM,SAAS,MAAM,OAAO,eAAe,KAAK;AAChD,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/llm/zod-utils.test.cjs

@@ -222,6 +222,89 @@ var import_zod_utils = require("./zod-utils.cjs");
         (0, import_vitest.expect)(jsonSchema7).toHaveProperty("properties");
       });
     });
+    (0, import_vitest.describe)("strict parameter", () => {
+      (0, import_vitest.it)("should produce strict JSON schema with strict: true", () => {
+        const schema = z4.object({
+          name: z4.string(),
+          age: z4.number()
+        });
+        const strictSchema = (0, import_zod_utils.zodSchemaToJsonSchema)(schema, true, true);
+        (0, import_vitest.expect)(strictSchema).toMatchSnapshot();
+      });
+      (0, import_vitest.it)("should handle nullable fields in strict mode", () => {
+        const schema = z4.object({
+          required: z4.string(),
+          optional: z4.string().nullable()
+        });
+        const strictSchema = (0, import_zod_utils.zodSchemaToJsonSchema)(schema, true, true);
+        (0, import_vitest.expect)(strictSchema).toMatchSnapshot();
+      });
+      (0, import_vitest.it)("should handle default values in strict mode", () => {
+        const schema = z4.object({
+          name: z4.string(),
+          role: z4.string().default("user"),
+          active: z4.boolean().default(true)
+        });
+        const strictSchema = (0, import_zod_utils.zodSchemaToJsonSchema)(schema, true, true);
+        (0, import_vitest.expect)(strictSchema).toMatchSnapshot();
+      });
+      (0, import_vitest.it)("should handle nested objects in strict mode", () => {
+        const schema = z4.object({
+          user: z4.object({
+            name: z4.string(),
+            email: z4.string().nullable()
+          }),
+          metadata: z4.object({
+            created: z4.string()
+          })
+        });
+        const strictSchema = (0, import_zod_utils.zodSchemaToJsonSchema)(schema, true, true);
+        (0, import_vitest.expect)(strictSchema).toMatchSnapshot();
+      });
+      (0, import_vitest.it)("should handle arrays in strict mode", () => {
+        const schema = z4.object({
+          tags: z4.array(z4.string()),
+          numbers: z4.array(z4.number())
+        });
+        const strictSchema = (0, import_zod_utils.zodSchemaToJsonSchema)(schema, true, true);
+        (0, import_vitest.expect)(strictSchema).toMatchSnapshot();
+      });
+      (0, import_vitest.it)("should handle v3 schemas in strict mode", () => {
+        const schema = z3.object({
+          name: z3.string(),
+          age: z3.number().optional()
+        });
+        const strictSchema = (0, import_zod_utils.zodSchemaToJsonSchema)(schema, true, true);
+        (0, import_vitest.expect)(strictSchema).toMatchSnapshot();
+      });
+      (0, import_vitest.it)("should throw error when using .optional() without .nullable() in strict mode", () => {
+        const schema = z4.object({
+          required: z4.string(),
+          optional: z4.string().optional()
+        });
+        (0, import_vitest.expect)(() => (0, import_zod_utils.zodSchemaToJsonSchema)(schema, true, true)).toThrow(
+          /uses `.optional\(\)` without `.nullable\(\)` which is not supported by the API/
+        );
+      });
+      (0, import_vitest.it)("should throw error for nested .optional() fields in strict mode", () => {
+        const schema = z4.object({
+          user: z4.object({
+            name: z4.string(),
+            email: z4.string().optional()
+          })
+        });
+        (0, import_vitest.expect)(() => (0, import_zod_utils.zodSchemaToJsonSchema)(schema, true, true)).toThrow(
+          /uses `.optional\(\)` without `.nullable\(\)` which is not supported by the API/
+        );
+      });
+      (0, import_vitest.it)("should NOT throw error when using .optional() in non-strict mode", () => {
+        const schema = z4.object({
+          required: z4.string(),
+          optional: z4.string().optional()
+        });
+        (0, import_vitest.expect)(() => (0, import_zod_utils.zodSchemaToJsonSchema)(schema, true, false)).not.toThrow();
+      });
+    });
   });
   (0, import_vitest.describe)("parseZodSchema", () => {
     (0, import_vitest.describe)("Zod v4 schemas", () => {

package/dist/llm/zod-utils.test.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/llm/zod-utils.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { describe, expect, it } from 'vitest';\nimport { z } from 'zod';\nimport * as z3 from 'zod/v3';\nimport * as z4 from 'zod/v4';\nimport {\n  isZod4Schema,\n  isZodObjectSchema,\n  isZodSchema,\n  parseZodSchema,\n  zodSchemaToJsonSchema,\n} from './zod-utils.js';\n\ntype JSONSchemaProperties = Record<string, Record<string, unknown>>;\n\ndescribe('Zod Utils', () => {\n  describe('isZod4Schema', () => {\n    it('should detect Zod v4 schemas', () => {\n      const v4Schema = z4.string();\n      expect(isZod4Schema(v4Schema)).toBe(true);\n    });\n\n    it('should detect Zod v3 schemas', () => {\n      const v3Schema = z3.string();\n      expect(isZod4Schema(v3Schema)).toBe(false);\n    });\n\n    it('should handle default z import (follows installed version)', () => {\n      const schema = z.string();\n      expect(typeof isZod4Schema(schema)).toBe('boolean');\n    });\n  });\n\n  describe('isZodSchema', () => {\n    it('should detect Zod v4 schemas', () => {\n      const v4Schema = z4.object({ name: z4.string() });\n      expect(isZodSchema(v4Schema)).toBe(true);\n    });\n\n    it('should detect Zod v3 schemas', () => {\n      const v3Schema = z3.object({ name: z3.string() });\n      expect(isZodSchema(v3Schema)).toBe(true);\n    });\n\n    it('should return false for non-Zod values', () => {\n      expect(isZodSchema({})).toBe(false);\n      expect(isZodSchema(null)).toBe(false);\n      expect(isZodSchema(undefined)).toBe(false);\n      expect(isZodSchema('string')).toBe(false);\n      expect(isZodSchema(123)).toBe(false);\n      expect(isZodSchema({ _def: {} })).toBe(false); // missing typeName\n    });\n  });\n\n  describe('isZodObjectSchema', () => {\n    it('should detect Zod v4 object schemas', () => {\n      const objectSchema = z4.object({ name: z4.string() });\n      expect(isZodObjectSchema(objectSchema)).toBe(true);\n    });\n\n    it('should detect Zod v3 object schemas', () => {\n      const objectSchema = z3.object({ name: z3.string() });\n      expect(isZodObjectSchema(objectSchema)).toBe(true);\n    });\n\n    it('should return false for non-object Zod schemas', () => {\n      expect(isZodObjectSchema(z4.string())).toBe(false);\n      expect(isZodObjectSchema(z4.number())).toBe(false);\n      expect(isZodObjectSchema(z4.array(z4.string()))).toBe(false);\n      expect(isZodObjectSchema(z3.string())).toBe(false);\n      expect(isZodObjectSchema(z3.number())).toBe(false);\n    });\n  });\n\n  describe('zodSchemaToJsonSchema', () => {\n    describe('Zod v4 schemas', () => {\n      it('should convert basic v4 object schema to JSON Schema', () => {\n        const schema = z4.object({\n          name: z4.string(),\n          age: z4.number(),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it.skip('should handle v4 schemas with descriptions', () => {\n        // NOTE: This test is skipped because Zod 3.25.76's v4 alpha doesn't fully support\n        // descriptions in toJSONSchema yet. This will work in final Zod v4 release.\n        const schema = z4.object({\n          location: z4.string().describe('The location to search'),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v4 schemas with optional fields', () => {\n        const schema = z4.object({\n          required: z4.string(),\n          optional: z4.string().optional(),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v4 enum schemas', () => {\n        const schema = z4.object({\n          color: z4.enum(['red', 'blue', 'green']),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v4 array schemas', () => {\n        const schema = z4.object({\n          tags: z4.array(z4.string()),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v4 nested object schemas', () => {\n        const schema = z4.object({\n          user: z4.object({\n            name: z4.string(),\n            email: z4.string(),\n          }),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v4 schemas with multiple optional fields', () => {\n        const schema = z4.object({\n          id: z4.string(),\n          name: z4.string().optional(),\n          age: z4.number().optional(),\n          email: z4.string(),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v4 schemas with default values', () => {\n        const schema = z4.object({\n          name: z4.string(),\n          role: z4.string().default('user'),\n          active: z4.boolean().default(true),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n    });\n\n    describe('Zod v3 schemas', () => {\n      it('should convert basic v3 object schema to JSON Schema', () => {\n        const schema = z3.object({\n          name: z3.string(),\n          age: z3.number(),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 schemas with descriptions', () => {\n        const schema = z3.object({\n          location: z3.string().describe('The location to search'),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it.skip('should handle v3 schemas with optional fields', () => {\n        // NOTE: This test is skipped because in Zod 3.25.76, the v3 export's optional()\n        // handling in zod-to-json-schema has some quirks. The behavior is correct for\n        // the default z import which is what users will typically use.\n        const schema = z3.object({\n          required: z3.string(),\n          optional: z3.string().optional(),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 enum schemas', () => {\n        const schema = z3.object({\n          color: z3.enum(['red', 'blue', 'green']),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 array schemas', () => {\n        const schema = z3.object({\n          tags: z3.array(z3.string()),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 nested object schemas', () => {\n        const schema = z3.object({\n          user: z3.object({\n            name: z3.string(),\n            email: z3.string(),\n          }),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 schemas with multiple optional fields', () => {\n        const schema = z3.object({\n          id: z3.string(),\n          name: z3.string().optional(),\n          age: z3.number().optional(),\n          email: z3.string(),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 schemas with default values', () => {\n        const schema = z3.object({\n          name: z3.string(),\n          role: z3.string().default('user'),\n          active: z3.boolean().default(true),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n    });\n\n    describe('isOpenai parameter', () => {\n      it('should respect isOpenai parameter for v3 schemas', () => {\n        const schema = z3.object({ name: z3.string() });\n\n        const openaiSchema = zodSchemaToJsonSchema(schema, true);\n        const jsonSchema7 = zodSchemaToJsonSchema(schema, false);\n\n        // Both should work, just different internal handling\n        expect(openaiSchema).toHaveProperty('properties');\n        expect(jsonSchema7).toHaveProperty('properties');\n      });\n    });\n  });\n\n  describe('parseZodSchema', () => {\n    describe('Zod v4 schemas', () => {\n      it('should successfully parse valid v4 data', async () => {\n        const schema = z4.object({\n          name: z4.string(),\n          age: z4.number(),\n        });\n\n        const result = await parseZodSchema(schema, { name: 'John', age: 30 });\n\n        expect(result.success).toBe(true);\n        if (result.success) {\n          expect(result.data).toEqual({ name: 'John', age: 30 });\n        }\n      });\n\n      it('should fail to parse invalid v4 data', async () => {\n        const schema = z4.object({\n          name: z4.string(),\n          age: z4.number(),\n        });\n\n        const result = await parseZodSchema(schema, { name: 'John', age: 'invalid' });\n\n        expect(result.success).toBe(false);\n        if (!result.success) {\n          expect(result.error).toBeDefined();\n        }\n      });\n\n      it('should handle v4 optional fields', async () => {\n        const schema = z4.object({\n          name: z4.string(),\n          email: z4.string().optional(),\n        });\n\n        const result1 = await parseZodSchema(schema, { name: 'John' });\n        expect(result1.success).toBe(true);\n\n        const result2 = await parseZodSchema(schema, { name: 'John', email: 'john@example.com' });\n        expect(result2.success).toBe(true);\n      });\n\n      it('should handle v4 default values', async () => {\n        const schema = z4.object({\n          name: z4.string(),\n          role: z4.string().default('user'),\n        });\n\n        const result = await parseZodSchema(schema, { name: 'John' });\n\n        expect(result.success).toBe(true);\n        if (result.success) {\n          expect(result.data).toEqual({ name: 'John', role: 'user' });\n        }\n      });\n    });\n\n    describe('Zod v3 schemas', () => {\n      it('should successfully parse valid v3 data', async () => {\n        const schema = z3.object({\n          name: z3.string(),\n          age: z3.number(),\n        });\n\n        const result = await parseZodSchema(schema, { name: 'John', age: 30 });\n\n        expect(result.success).toBe(true);\n        if (result.success) {\n          expect(result.data).toEqual({ name: 'John', age: 30 });\n        }\n      });\n\n      it('should fail to parse invalid v3 data', async () => {\n        const schema = z3.object({\n          name: z3.string(),\n          age: z3.number(),\n        });\n\n        const result = await parseZodSchema(schema, { name: 'John', age: 'invalid' });\n\n        expect(result.success).toBe(false);\n        if (!result.success) {\n          expect(result.error).toBeDefined();\n        }\n      });\n\n      it('should handle v3 optional fields', async () => {\n        const schema = z3.object({\n          name: z3.string(),\n          email: z3.string().optional(),\n        });\n\n        const result1 = await parseZodSchema(schema, { name: 'John' });\n        expect(result1.success).toBe(true);\n\n        const result2 = await parseZodSchema(schema, { name: 'John', email: 'john@example.com' });\n        expect(result2.success).toBe(true);\n      });\n\n      it('should handle v3 default values', async () => {\n        const schema = z3.object({\n          name: z3.string(),\n          role: z3.string().default('user'),\n        });\n\n        const result = await parseZodSchema(schema, { name: 'John' });\n\n        expect(result.success).toBe(true);\n        if (result.success) {\n          expect(result.data).toEqual({ name: 'John', role: 'user' });\n        }\n      });\n    });\n  });\n\n  describe('Cross-version compatibility', () => {\n    it('should handle mixed v3 and v4 schemas in the same codebase', async () => {\n      const v3Schema = z3.object({ name: z3.string() });\n      const v4Schema = z4.object({ name: z4.string() });\n\n      const v3Result = await parseZodSchema(v3Schema, { name: 'John' });\n      const v4Result = await parseZodSchema(v4Schema, { name: 'Jane' });\n\n      expect(v3Result.success).toBe(true);\n      expect(v4Result.success).toBe(true);\n    });\n\n    it('should convert both v3 and v4 basic schemas to compatible JSON Schema', () => {\n      const v3Schema = z3.object({ count: z3.number() });\n      const v4Schema = z4.object({ count: z4.number() });\n\n      const v3Json = zodSchemaToJsonSchema(v3Schema);\n      const v4Json = zodSchemaToJsonSchema(v4Schema);\n\n      // Both should produce valid JSON Schema with same structure\n      expect(v3Json.type).toBe('object');\n      expect(v4Json.type).toBe('object');\n      expect((v3Json.properties as JSONSchemaProperties).count?.type).toBe('number');\n      expect((v4Json.properties as JSONSchemaProperties).count?.type).toBe('number');\n    });\n\n    it('should handle optional fields consistently across v3 and v4', () => {\n      const v3Schema = z3.object({\n        required: z3.string(),\n        optional: z3.string().optional(),\n      });\n      const v4Schema = z4.object({\n        required: z4.string(),\n        optional: z4.string().optional(),\n      });\n\n      const v3Json = zodSchemaToJsonSchema(v3Schema);\n      const v4Json = zodSchemaToJsonSchema(v4Schema);\n\n      // Both should mark 'required' as required\n      expect(v3Json.required).toContain('required');\n      expect(v4Json.required).toContain('required');\n\n      // v4 should NOT mark 'optional' as required\n      expect(v4Json.required).not.toContain('optional');\n\n      // NOTE: v3's optional handling in zod-to-json-schema (for the v3 export) has quirks\n      // in the alpha version 3.25.76. The default z import works correctly for users.\n    });\n\n    it('should handle complex schemas with nested objects and arrays consistently', () => {\n      const v3Schema = z3.object({\n        user: z3.object({\n          name: z3.string(),\n          email: z3.string().optional(),\n        }),\n        tags: z3.array(z3.string()),\n        status: z3.enum(['active', 'inactive']),\n      });\n\n      const v4Schema = z4.object({\n        user: z4.object({\n          name: z4.string(),\n          email: z4.string().optional(),\n        }),\n        tags: z4.array(z4.string()),\n        status: z4.enum(['active', 'inactive']),\n      });\n\n      const v3Json = zodSchemaToJsonSchema(v3Schema);\n      const v4Json = zodSchemaToJsonSchema(v4Schema);\n\n      // Check structure compatibility\n      expect(v3Json.type).toBe(v4Json.type);\n      expect(Object.keys(v3Json.properties || {})).toEqual(Object.keys(v4Json.properties || {}));\n\n      // Check nested object\n      const v3User = (v3Json.properties as JSONSchemaProperties).user;\n      const v4User = (v4Json.properties as JSONSchemaProperties).user;\n      expect(v3User?.type).toBe('object');\n      expect(v4User?.type).toBe('object');\n\n      // Check array\n      const v3Tags = (v3Json.properties as JSONSchemaProperties).tags;\n      const v4Tags = (v4Json.properties as JSONSchemaProperties).tags;\n      expect(v3Tags?.type).toBe('array');\n      expect(v4Tags?.type).toBe('array');\n\n      // Check enum\n      const v3Status = (v3Json.properties as JSONSchemaProperties).status;\n      const v4Status = (v4Json.properties as JSONSchemaProperties).status;\n      expect(v3Status?.enum).toEqual(['active', 'inactive']);\n      expect(v4Status?.enum).toEqual(['active', 'inactive']);\n    });\n  });\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/llm/zod-utils.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { describe, expect, it } from 'vitest';\nimport { z } from 'zod';\nimport * as z3 from 'zod/v3';\nimport * as z4 from 'zod/v4';\nimport {\n  isZod4Schema,\n  isZodObjectSchema,\n  isZodSchema,\n  parseZodSchema,\n  zodSchemaToJsonSchema,\n} from './zod-utils.js';\n\ntype JSONSchemaProperties = Record<string, Record<string, unknown>>;\n\ndescribe('Zod Utils', () => {\n  describe('isZod4Schema', () => {\n    it('should detect Zod v4 schemas', () => {\n      const v4Schema = z4.string();\n      expect(isZod4Schema(v4Schema)).toBe(true);\n    });\n\n    it('should detect Zod v3 schemas', () => {\n      const v3Schema = z3.string();\n      expect(isZod4Schema(v3Schema)).toBe(false);\n    });\n\n    it('should handle default z import (follows installed version)', () => {\n      const schema = z.string();\n      expect(typeof isZod4Schema(schema)).toBe('boolean');\n    });\n  });\n\n  describe('isZodSchema', () => {\n    it('should detect Zod v4 schemas', () => {\n      const v4Schema = z4.object({ name: z4.string() });\n      expect(isZodSchema(v4Schema)).toBe(true);\n    });\n\n    it('should detect Zod v3 schemas', () => {\n      const v3Schema = z3.object({ name: z3.string() });\n      expect(isZodSchema(v3Schema)).toBe(true);\n    });\n\n    it('should return false for non-Zod values', () => {\n      expect(isZodSchema({})).toBe(false);\n      expect(isZodSchema(null)).toBe(false);\n      expect(isZodSchema(undefined)).toBe(false);\n      expect(isZodSchema('string')).toBe(false);\n      expect(isZodSchema(123)).toBe(false);\n      expect(isZodSchema({ _def: {} })).toBe(false); // missing typeName\n    });\n  });\n\n  describe('isZodObjectSchema', () => {\n    it('should detect Zod v4 object schemas', () => {\n      const objectSchema = z4.object({ name: z4.string() });\n      expect(isZodObjectSchema(objectSchema)).toBe(true);\n    });\n\n    it('should detect Zod v3 object schemas', () => {\n      const objectSchema = z3.object({ name: z3.string() });\n      expect(isZodObjectSchema(objectSchema)).toBe(true);\n    });\n\n    it('should return false for non-object Zod schemas', () => {\n      expect(isZodObjectSchema(z4.string())).toBe(false);\n      expect(isZodObjectSchema(z4.number())).toBe(false);\n      expect(isZodObjectSchema(z4.array(z4.string()))).toBe(false);\n      expect(isZodObjectSchema(z3.string())).toBe(false);\n      expect(isZodObjectSchema(z3.number())).toBe(false);\n    });\n  });\n\n  describe('zodSchemaToJsonSchema', () => {\n    describe('Zod v4 schemas', () => {\n      it('should convert basic v4 object schema to JSON Schema', () => {\n        const schema = z4.object({\n          name: z4.string(),\n          age: z4.number(),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it.skip('should handle v4 schemas with descriptions', () => {\n        // NOTE: This test is skipped because Zod 3.25.76's v4 alpha doesn't fully support\n        // descriptions in toJSONSchema yet. This will work in final Zod v4 release.\n        const schema = z4.object({\n          location: z4.string().describe('The location to search'),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v4 schemas with optional fields', () => {\n        const schema = z4.object({\n          required: z4.string(),\n          optional: z4.string().optional(),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v4 enum schemas', () => {\n        const schema = z4.object({\n          color: z4.enum(['red', 'blue', 'green']),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v4 array schemas', () => {\n        const schema = z4.object({\n          tags: z4.array(z4.string()),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v4 nested object schemas', () => {\n        const schema = z4.object({\n          user: z4.object({\n            name: z4.string(),\n            email: z4.string(),\n          }),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v4 schemas with multiple optional fields', () => {\n        const schema = z4.object({\n          id: z4.string(),\n          name: z4.string().optional(),\n          age: z4.number().optional(),\n          email: z4.string(),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v4 schemas with default values', () => {\n        const schema = z4.object({\n          name: z4.string(),\n          role: z4.string().default('user'),\n          active: z4.boolean().default(true),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n    });\n\n    describe('Zod v3 schemas', () => {\n      it('should convert basic v3 object schema to JSON Schema', () => {\n        const schema = z3.object({\n          name: z3.string(),\n          age: z3.number(),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 schemas with descriptions', () => {\n        const schema = z3.object({\n          location: z3.string().describe('The location to search'),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it.skip('should handle v3 schemas with optional fields', () => {\n        // NOTE: This test is skipped because in Zod 3.25.76, the v3 export's optional()\n        // handling in zod-to-json-schema has some quirks. The behavior is correct for\n        // the default z import which is what users will typically use.\n        const schema = z3.object({\n          required: z3.string(),\n          optional: z3.string().optional(),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 enum schemas', () => {\n        const schema = z3.object({\n          color: z3.enum(['red', 'blue', 'green']),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 array schemas', () => {\n        const schema = z3.object({\n          tags: z3.array(z3.string()),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 nested object schemas', () => {\n        const schema = z3.object({\n          user: z3.object({\n            name: z3.string(),\n            email: z3.string(),\n          }),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 schemas with multiple optional fields', () => {\n        const schema = z3.object({\n          id: z3.string(),\n          name: z3.string().optional(),\n          age: z3.number().optional(),\n          email: z3.string(),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 schemas with default values', () => {\n        const schema = z3.object({\n          name: z3.string(),\n          role: z3.string().default('user'),\n          active: z3.boolean().default(true),\n        });\n\n        const jsonSchema = zodSchemaToJsonSchema(schema);\n        expect(jsonSchema).toMatchSnapshot();\n      });\n    });\n\n    describe('isOpenai parameter', () => {\n      it('should respect isOpenai parameter for v3 schemas', () => {\n        const schema = z3.object({ name: z3.string() });\n\n        const openaiSchema = zodSchemaToJsonSchema(schema, true);\n        const jsonSchema7 = zodSchemaToJsonSchema(schema, false);\n\n        // Both should work, just different internal handling\n        expect(openaiSchema).toHaveProperty('properties');\n        expect(jsonSchema7).toHaveProperty('properties');\n      });\n    });\n\n    describe('strict parameter', () => {\n      it('should produce strict JSON schema with strict: true', () => {\n        const schema = z4.object({\n          name: z4.string(),\n          age: z4.number(),\n        });\n\n        const strictSchema = zodSchemaToJsonSchema(schema, true, true);\n        expect(strictSchema).toMatchSnapshot();\n      });\n\n      it('should handle nullable fields in strict mode', () => {\n        const schema = z4.object({\n          required: z4.string(),\n          optional: z4.string().nullable(),\n        });\n\n        const strictSchema = zodSchemaToJsonSchema(schema, true, true);\n        expect(strictSchema).toMatchSnapshot();\n      });\n\n      it('should handle default values in strict mode', () => {\n        const schema = z4.object({\n          name: z4.string(),\n          role: z4.string().default('user'),\n          active: z4.boolean().default(true),\n        });\n\n        const strictSchema = zodSchemaToJsonSchema(schema, true, true);\n        expect(strictSchema).toMatchSnapshot();\n      });\n\n      it('should handle nested objects in strict mode', () => {\n        const schema = z4.object({\n          user: z4.object({\n            name: z4.string(),\n            email: z4.string().nullable(),\n          }),\n          metadata: z4.object({\n            created: z4.string(),\n          }),\n        });\n\n        const strictSchema = zodSchemaToJsonSchema(schema, true, true);\n        expect(strictSchema).toMatchSnapshot();\n      });\n\n      it('should handle arrays in strict mode', () => {\n        const schema = z4.object({\n          tags: z4.array(z4.string()),\n          numbers: z4.array(z4.number()),\n        });\n\n        const strictSchema = zodSchemaToJsonSchema(schema, true, true);\n        expect(strictSchema).toMatchSnapshot();\n      });\n\n      it('should handle v3 schemas in strict mode', () => {\n        const schema = z3.object({\n          name: z3.string(),\n          age: z3.number().optional(),\n        });\n\n        const strictSchema = zodSchemaToJsonSchema(schema, true, true);\n        expect(strictSchema).toMatchSnapshot();\n      });\n\n      it('should throw error when using .optional() without .nullable() in strict mode', () => {\n        const schema = z4.object({\n          required: z4.string(),\n          optional: z4.string().optional(),\n        });\n\n        expect(() => zodSchemaToJsonSchema(schema, true, true)).toThrow(\n          /uses `.optional\\(\\)` without `.nullable\\(\\)` which is not supported by the API/,\n        );\n      });\n\n      it('should throw error for nested .optional() fields in strict mode', () => {\n        const schema = z4.object({\n          user: z4.object({\n            name: z4.string(),\n            email: z4.string().optional(),\n          }),\n        });\n\n        expect(() => zodSchemaToJsonSchema(schema, true, true)).toThrow(\n          /uses `.optional\\(\\)` without `.nullable\\(\\)` which is not supported by the API/,\n        );\n      });\n\n      it('should NOT throw error when using .optional() in non-strict mode', () => {\n        const schema = z4.object({\n          required: z4.string(),\n          optional: z4.string().optional(),\n        });\n\n        expect(() => zodSchemaToJsonSchema(schema, true, false)).not.toThrow();\n      });\n    });\n  });\n\n  describe('parseZodSchema', () => {\n    describe('Zod v4 schemas', () => {\n      it('should successfully parse valid v4 data', async () => {\n        const schema = z4.object({\n          name: z4.string(),\n          age: z4.number(),\n        });\n\n        const result = await parseZodSchema(schema, { name: 'John', age: 30 });\n\n        expect(result.success).toBe(true);\n        if (result.success) {\n          expect(result.data).toEqual({ name: 'John', age: 30 });\n        }\n      });\n\n      it('should fail to parse invalid v4 data', async () => {\n        const schema = z4.object({\n          name: z4.string(),\n          age: z4.number(),\n        });\n\n        const result = await parseZodSchema(schema, { name: 'John', age: 'invalid' });\n\n        expect(result.success).toBe(false);\n        if (!result.success) {\n          expect(result.error).toBeDefined();\n        }\n      });\n\n      it('should handle v4 optional fields', async () => {\n        const schema = z4.object({\n          name: z4.string(),\n          email: z4.string().optional(),\n        });\n\n        const result1 = await parseZodSchema(schema, { name: 'John' });\n        expect(result1.success).toBe(true);\n\n        const result2 = await parseZodSchema(schema, { name: 'John', email: 'john@example.com' });\n        expect(result2.success).toBe(true);\n      });\n\n      it('should handle v4 default values', async () => {\n        const schema = z4.object({\n          name: z4.string(),\n          role: z4.string().default('user'),\n        });\n\n        const result = await parseZodSchema(schema, { name: 'John' });\n\n        expect(result.success).toBe(true);\n        if (result.success) {\n          expect(result.data).toEqual({ name: 'John', role: 'user' });\n        }\n      });\n    });\n\n    describe('Zod v3 schemas', () => {\n      it('should successfully parse valid v3 data', async () => {\n        const schema = z3.object({\n          name: z3.string(),\n          age: z3.number(),\n        });\n\n        const result = await parseZodSchema(schema, { name: 'John', age: 30 });\n\n        expect(result.success).toBe(true);\n        if (result.success) {\n          expect(result.data).toEqual({ name: 'John', age: 30 });\n        }\n      });\n\n      it('should fail to parse invalid v3 data', async () => {\n        const schema = z3.object({\n          name: z3.string(),\n          age: z3.number(),\n        });\n\n        const result = await parseZodSchema(schema, { name: 'John', age: 'invalid' });\n\n        expect(result.success).toBe(false);\n        if (!result.success) {\n          expect(result.error).toBeDefined();\n        }\n      });\n\n      it('should handle v3 optional fields', async () => {\n        const schema = z3.object({\n          name: z3.string(),\n          email: z3.string().optional(),\n        });\n\n        const result1 = await parseZodSchema(schema, { name: 'John' });\n        expect(result1.success).toBe(true);\n\n        const result2 = await parseZodSchema(schema, { name: 'John', email: 'john@example.com' });\n        expect(result2.success).toBe(true);\n      });\n\n      it('should handle v3 default values', async () => {\n        const schema = z3.object({\n          name: z3.string(),\n          role: z3.string().default('user'),\n        });\n\n        const result = await parseZodSchema(schema, { name: 'John' });\n\n        expect(result.success).toBe(true);\n        if (result.success) {\n          expect(result.data).toEqual({ name: 'John', role: 'user' });\n        }\n      });\n    });\n  });\n\n  describe('Cross-version compatibility', () => {\n    it('should handle mixed v3 and v4 schemas in the same codebase', async () => {\n      const v3Schema = z3.object({ name: z3.string() });\n      const v4Schema = z4.object({ name: z4.string() });\n\n      const v3Result = await parseZodSchema(v3Schema, { name: 'John' });\n      const v4Result = await parseZodSchema(v4Schema, { name: 'Jane' });\n\n      expect(v3Result.success).toBe(true);\n      expect(v4Result.success).toBe(true);\n    });\n\n    it('should convert both v3 and v4 basic schemas to compatible JSON Schema', () => {\n      const v3Schema = z3.object({ count: z3.number() });\n      const v4Schema = z4.object({ count: z4.number() });\n\n      const v3Json = zodSchemaToJsonSchema(v3Schema);\n      const v4Json = zodSchemaToJsonSchema(v4Schema);\n\n      // Both should produce valid JSON Schema with same structure\n      expect(v3Json.type).toBe('object');\n      expect(v4Json.type).toBe('object');\n      expect((v3Json.properties as JSONSchemaProperties).count?.type).toBe('number');\n      expect((v4Json.properties as JSONSchemaProperties).count?.type).toBe('number');\n    });\n\n    it('should handle optional fields consistently across v3 and v4', () => {\n      const v3Schema = z3.object({\n        required: z3.string(),\n        optional: z3.string().optional(),\n      });\n      const v4Schema = z4.object({\n        required: z4.string(),\n        optional: z4.string().optional(),\n      });\n\n      const v3Json = zodSchemaToJsonSchema(v3Schema);\n      const v4Json = zodSchemaToJsonSchema(v4Schema);\n\n      // Both should mark 'required' as required\n      expect(v3Json.required).toContain('required');\n      expect(v4Json.required).toContain('required');\n\n      // v4 should NOT mark 'optional' as required\n      expect(v4Json.required).not.toContain('optional');\n\n      // NOTE: v3's optional handling in zod-to-json-schema (for the v3 export) has quirks\n      // in the alpha version 3.25.76. The default z import works correctly for users.\n    });\n\n    it('should handle complex schemas with nested objects and arrays consistently', () => {\n      const v3Schema = z3.object({\n        user: z3.object({\n          name: z3.string(),\n          email: z3.string().optional(),\n        }),\n        tags: z3.array(z3.string()),\n        status: z3.enum(['active', 'inactive']),\n      });\n\n      const v4Schema = z4.object({\n        user: z4.object({\n          name: z4.string(),\n          email: z4.string().optional(),\n        }),\n        tags: z4.array(z4.string()),\n        status: z4.enum(['active', 'inactive']),\n      });\n\n      const v3Json = zodSchemaToJsonSchema(v3Schema);\n      const v4Json = zodSchemaToJsonSchema(v4Schema);\n\n      // Check structure compatibility\n      expect(v3Json.type).toBe(v4Json.type);\n      expect(Object.keys(v3Json.properties || {})).toEqual(Object.keys(v4Json.properties || {}));\n\n      // Check nested object\n      const v3User = (v3Json.properties as JSONSchemaProperties).user;\n      const v4User = (v4Json.properties as JSONSchemaProperties).user;\n      expect(v3User?.type).toBe('object');\n      expect(v4User?.type).toBe('object');\n\n      // Check array\n      const v3Tags = (v3Json.properties as JSONSchemaProperties).tags;\n      const v4Tags = (v4Json.properties as JSONSchemaProperties).tags;\n      expect(v3Tags?.type).toBe('array');\n      expect(v4Tags?.type).toBe('array');\n\n      // Check enum\n      const v3Status = (v3Json.properties as JSONSchemaProperties).status;\n      const v4Status = (v4Json.properties as JSONSchemaProperties).status;\n      expect(v3Status?.enum).toEqual(['active', 'inactive']);\n      expect(v4Status?.enum).toEqual(['active', 'inactive']);\n    });\n  });\n});\n"],"mappings":"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","names":[]}

package/dist/llm/zod-utils.test.js

@@ -205,6 +205,89 @@ describe("Zod Utils", () => {
         expect(jsonSchema7).toHaveProperty("properties");
       });
     });
+    describe("strict parameter", () => {
+      it("should produce strict JSON schema with strict: true", () => {
+        const schema = z4.object({
+          name: z4.string(),
+          age: z4.number()
+        });
+        const strictSchema = zodSchemaToJsonSchema(schema, true, true);
+        expect(strictSchema).toMatchSnapshot();
+      });
+      it("should handle nullable fields in strict mode", () => {
+        const schema = z4.object({
+          required: z4.string(),
+          optional: z4.string().nullable()
+        });
+        const strictSchema = zodSchemaToJsonSchema(schema, true, true);
+        expect(strictSchema).toMatchSnapshot();
+      });
+      it("should handle default values in strict mode", () => {
+        const schema = z4.object({
+          name: z4.string(),
+          role: z4.string().default("user"),
+          active: z4.boolean().default(true)
+        });
+        const strictSchema = zodSchemaToJsonSchema(schema, true, true);
+        expect(strictSchema).toMatchSnapshot();
+      });
+      it("should handle nested objects in strict mode", () => {
+        const schema = z4.object({
+          user: z4.object({
+            name: z4.string(),
+            email: z4.string().nullable()
+          }),
+          metadata: z4.object({
+            created: z4.string()
+          })
+        });
+        const strictSchema = zodSchemaToJsonSchema(schema, true, true);
+        expect(strictSchema).toMatchSnapshot();
+      });
+      it("should handle arrays in strict mode", () => {
+        const schema = z4.object({
+          tags: z4.array(z4.string()),
+          numbers: z4.array(z4.number())
+        });
+        const strictSchema = zodSchemaToJsonSchema(schema, true, true);
+        expect(strictSchema).toMatchSnapshot();
+      });
+      it("should handle v3 schemas in strict mode", () => {
+        const schema = z3.object({
+          name: z3.string(),
+          age: z3.number().optional()
+        });
+        const strictSchema = zodSchemaToJsonSchema(schema, true, true);
+        expect(strictSchema).toMatchSnapshot();
+      });
+      it("should throw error when using .optional() without .nullable() in strict mode", () => {
+        const schema = z4.object({
+          required: z4.string(),
+          optional: z4.string().optional()
+        });
+        expect(() => zodSchemaToJsonSchema(schema, true, true)).toThrow(
+          /uses `.optional\(\)` without `.nullable\(\)` which is not supported by the API/
+        );
+      });
+      it("should throw error for nested .optional() fields in strict mode", () => {
+        const schema = z4.object({
+          user: z4.object({
+            name: z4.string(),
+            email: z4.string().optional()
+          })
+        });
+        expect(() => zodSchemaToJsonSchema(schema, true, true)).toThrow(
+          /uses `.optional\(\)` without `.nullable\(\)` which is not supported by the API/
+        );
+      });
+      it("should NOT throw error when using .optional() in non-strict mode", () => {
+        const schema = z4.object({
+          required: z4.string(),
+          optional: z4.string().optional()
+        });
+        expect(() => zodSchemaToJsonSchema(schema, true, false)).not.toThrow();
+      });
+    });
   });
   describe("parseZodSchema", () => {
     describe("Zod v4 schemas", () => {