@mochabug/adapt-sdk 0.4.0 → 0.4.1

package/dist/esm/openai.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/signals/index.ts", "../../src/openai/index.ts"],
-  "sourcesContent": ["import type {\n  JTDSchemaJson,\n  SignalDescriptorJson,\n  SignalFormatJson\n} from '../api';\nimport { isSchema, isValidSchema, validate as jtdValidate } from 'jtd';\nimport type { Schema, ValidationError } from 'jtd';\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// JTD FUZZER (generate sample values from JTD schemas)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/** Maximum recursion depth for fuzzJTD to prevent infinite loops on self-referencing schemas. */\nconst FUZZ_MAX_DEPTH = 10;\n\n/** Generate a fuzzed (sample) value from a JTD schema. */\nexport function fuzzJTD(\n  schema: JTDSchemaJson,\n  definitions?: Record<string, JTDSchemaJson>,\n  _depth: number = 0\n): unknown {\n  if (_depth > FUZZ_MAX_DEPTH) return null;\n\n  if (schema.ref) {\n    const def = definitions?.[schema.ref];\n    if (def) return fuzzJTD(def, definitions, _depth + 1);\n    return null;\n  }\n\n  if (schema.type) {\n    switch (schema.type) {\n      case 'string':\n        return 'Lorem ipsum';\n      case 'timestamp':\n        return '2024-01-15T10:30:00Z';\n      case 'float32':\n      case 'float64':\n        return 42.5;\n      case 'int8':\n      case 'uint8':\n      case 'int16':\n      case 'uint16':\n      case 'int32':\n      case 'uint32':\n        return BigInt(42);\n      case 'boolean':\n        return true;\n      default:\n        return null;\n    }\n  }\n\n  if (schema.enum) {\n    return schema.enum[0] ?? null;\n  }\n\n  if (schema.elements) {\n    return [\n      fuzzJTD(schema.elements, definitions, _depth + 1),\n      fuzzJTD(schema.elements, definitions, _depth + 1)\n    ];\n  }\n\n  if (schema.values) {\n    return { key1: fuzzJTD(schema.values, definitions, _depth + 1) };\n  }\n\n  if (schema.properties || schema.optionalProperties) {\n    const obj: Record<string, unknown> = {};\n    if (schema.properties) {\n      for (const [k, v] of Object.entries(schema.properties)) {\n        obj[k] = fuzzJTD(v, definitions, _depth + 1);\n      }\n    }\n    if (schema.optionalProperties) {\n      for (const [k, v] of Object.entries(schema.optionalProperties)) {\n        obj[k] = fuzzJTD(v, definitions, _depth + 1);\n      }\n    }\n    return obj;\n  }\n\n  if (schema.discriminator && schema.mapping) {\n    const firstKey = Object.keys(schema.mapping)[0];\n    if (firstKey) {\n      const variant = schema.mapping[firstKey]!;\n      const obj = fuzzJTD(variant, definitions, _depth + 1) as Record<\n        string,\n        unknown\n      >;\n      obj[schema.discriminator] = firstKey;\n      return obj;\n    }\n    return null;\n  }\n\n  // Empty schema\n  return null;\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// JTD VALUE VALIDATION (delegates to the `jtd` npm package)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nconst INTEGER_TYPES = new Set([\n  'int8',\n  'uint8',\n  'int16',\n  'uint16',\n  'int32',\n  'uint32'\n]);\n\nfunction formatInstancePath(instancePath: string[]): string {\n  if (instancePath.length === 0) return '/';\n  return instancePath\n    .map((p) => (/^\\d+$/.test(p) ? `[${p}]` : `.${p}`))\n    .join('');\n}\n\nfunction resolveSchemaParent(\n  schema: Record<string, unknown>,\n  schemaPath: string[]\n): Record<string, unknown> {\n  let current: any = schema;\n  for (let i = 0; i < schemaPath.length - 1; i++) {\n    if (current && typeof current === 'object' && schemaPath[i]! in current) {\n      current = current[schemaPath[i]!];\n    } else {\n      break;\n    }\n  }\n  return current as Record<string, unknown>;\n}\n\nfunction resolveInstanceValue(value: unknown, instancePath: string[]): unknown {\n  let current = value;\n  for (const key of instancePath) {\n    if (current && typeof current === 'object') {\n      current = (current as Record<string, unknown>)[key];\n    } else {\n      return undefined;\n    }\n  }\n  return current;\n}\n\nfunction formatValidationError(\n  error: ValidationError,\n  schema: Record<string, unknown>,\n  value: unknown\n): string {\n  const { instancePath, schemaPath } = error;\n  const path = formatInstancePath(instancePath);\n  const lastKey = schemaPath[schemaPath.length - 1];\n\n  if (lastKey === 'type') {\n    const parent = resolveSchemaParent(schema, schemaPath);\n    const jtdType = parent?.type as string;\n    if (jtdType === 'boolean') return `${path}: expected boolean`;\n    if (jtdType === 'string') return `${path}: expected string`;\n    if (jtdType === 'timestamp') return `${path}: expected timestamp string`;\n    if (INTEGER_TYPES.has(jtdType)) return `${path}: expected integer`;\n    return `${path}: expected number`;\n  }\n\n  if (lastKey === 'enum') {\n    const parent = resolveSchemaParent(schema, schemaPath);\n    const enumValues = parent?.enum as string[];\n    return `${path}: expected one of [${enumValues.join(', ')}]`;\n  }\n\n  if (\n    schemaPath.length >= 2 &&\n    schemaPath[schemaPath.length - 2] === 'properties' &&\n    lastKey\n  ) {\n    const prefix = path === '/' ? '' : path;\n    return `${prefix}.${lastKey}: missing required property`;\n  }\n\n  if (lastKey === 'elements') return `${path}: expected array`;\n\n  if (\n    lastKey === 'properties' ||\n    lastKey === 'optionalProperties' ||\n    lastKey === 'values'\n  ) {\n    return `${path}: expected object`;\n  }\n\n  if (lastKey === 'discriminator')\n    return `${path}: expected string discriminator`;\n\n  if (lastKey === 'mapping') {\n    const discValue = resolveInstanceValue(value, instancePath);\n    return `${path}: unknown variant \"${discValue}\"`;\n  }\n\n  if (schemaPath.length === 0) return `${path}: unexpected property`;\n\n  return `${path}: validation error at /${schemaPath.join('/')}`;\n}\n\n/**\n * Validate a value against a JTD schema, returning an array of error messages.\n * Delegates to the `jtd` npm package for spec-compliant validation.\n */\nexport function validateJsonAgainstJTD(\n  schema: JTDSchemaJson,\n  value: unknown,\n  definitions?: Record<string, JTDSchemaJson>\n): string[] {\n  const defs =\n    definitions ??\n    (schema.definitions as Record<string, JTDSchemaJson> | undefined);\n\n  const schemaForValidation = defs\n    ? ({ ...schema, definitions: defs } as Schema)\n    : (schema as Schema);\n\n  // The jtd lib throws on invalid schemas (e.g., unresolved refs).\n  if (!isValidSchema(schemaForValidation)) {\n    if (schema.ref) {\n      return [`/: unknown ref \"${schema.ref}\"`];\n    }\n    return [`/: invalid schema`];\n  }\n\n  const errors = jtdValidate(schemaForValidation, value, {\n    maxDepth: MAX_VALIDATION_DEPTH,\n    maxErrors: MAX_VALIDATION_ERRORS\n  });\n\n  return errors.map((err) =>\n    formatValidationError(\n      err,\n      schemaForValidation as Record<string, unknown>,\n      value\n    )\n  );\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// SIGNAL-LEVEL VALIDATION (JSON values against JTD formats)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/** Validate a JSON value against a single SignalFormatJson. */\nexport function validateJsonAgainstSignal(\n  format: SignalFormatJson,\n  jsonValue: unknown\n): string[];\n/** Validate a JSON value against a SignalDescriptorJson (valid if value matches ANY JTD format). */\nexport function validateJsonAgainstSignal(\n  descriptor: SignalDescriptorJson,\n  jsonValue: unknown\n): string[];\nexport function validateJsonAgainstSignal(\n  formatOrDescriptor: SignalFormatJson | SignalDescriptorJson,\n  jsonValue: unknown\n): string[] {\n  // Descriptor path \u2014 has `formats` array\n  if (\n    'formats' in formatOrDescriptor &&\n    Array.isArray(formatOrDescriptor.formats)\n  ) {\n    const jtdFormats = (\n      formatOrDescriptor.formats as SignalFormatJson[]\n    ).filter((f) => f.jtdSchema);\n    if (jtdFormats.length === 0) {\n      return ['/: no JTD formats in signal descriptor'];\n    }\n    // Valid if value matches ANY JTD format\n    for (const format of jtdFormats) {\n      const errors = validateJsonAgainstJTD(format.jtdSchema!, jsonValue);\n      if (errors.length === 0) return [];\n    }\n    // None matched \u2014 return errors from last format attempt\n    return validateJsonAgainstJTD(\n      jtdFormats[jtdFormats.length - 1]!.jtdSchema!,\n      jsonValue\n    );\n  }\n\n  // Single format path\n  const format = formatOrDescriptor as SignalFormatJson;\n  if (!format.jtdSchema) {\n    return ['/: signal format has no jtdSchema'];\n  }\n  return validateJsonAgainstJTD(format.jtdSchema, jsonValue);\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// JTD \u2192 JSON SCHEMA CONVERTER\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/**\n * Convert JTD (JSON Type Definition) schema to JSON Schema for validation.\n *\n * Supports all 8 JTD schema forms per RFC 8927:\n * - Empty form: {}\n * - Ref form: { ref: \"...\" }\n * - Type form: { type: \"...\" }\n * - Enum form: { enum: [...] }\n * - Elements form: { elements: {...} }\n * - Properties form: { properties: {...}, optionalProperties: {...} }\n * - Values form: { values: {...} }\n * - Discriminator form: { discriminator: \"...\", mapping: {...} }\n */\nexport function jtdToJsonSchema(\n  jtdSchema: JTDSchemaJson,\n  definitions?: Record<string, JTDSchemaJson>,\n  isRoot = true\n): any {\n  if (!jtdSchema || typeof jtdSchema !== 'object') {\n    return {};\n  }\n\n  const isNullable = jtdSchema['nullable'];\n  const defs =\n    definitions ||\n    (jtdSchema['definitions'] as Record<string, JTDSchemaJson> | undefined);\n\n  const result: any = {};\n\n  if (isRoot) {\n    result.$schema = 'http://json-schema.org/draft-07/schema#';\n  }\n\n  // Ref form\n  if (jtdSchema['ref']) {\n    const refName = jtdSchema['ref'] as string;\n    if (defs && defs[refName]) {\n      const resolvedSchema = jtdToJsonSchema(\n        defs[refName] as JTDSchemaJson,\n        defs,\n        false\n      );\n\n      if (isNullable) {\n        if (resolvedSchema.type) {\n          resolvedSchema.type = Array.isArray(resolvedSchema.type)\n            ? [...resolvedSchema.type, 'null']\n            : [resolvedSchema.type, 'null'];\n        } else {\n          return {\n            ...resolvedSchema,\n            anyOf: [resolvedSchema, { type: 'null' }],\n            ...(isRoot\n              ? { $schema: 'http://json-schema.org/draft-07/schema#' }\n              : {})\n          };\n        }\n      }\n\n      return isRoot\n        ? {\n            ...resolvedSchema,\n            $schema: 'http://json-schema.org/draft-07/schema#'\n          }\n        : resolvedSchema;\n    }\n    return isRoot ? result : {};\n  }\n\n  // Type form\n  if (jtdSchema['type']) {\n    const typeMap: Record<string, string> = {\n      boolean: 'boolean',\n      string: 'string',\n      timestamp: 'string',\n      float32: 'number',\n      float64: 'number',\n      int8: 'integer',\n      uint8: 'integer',\n      int16: 'integer',\n      uint16: 'integer',\n      int32: 'integer',\n      uint32: 'integer'\n    };\n    const jtdType = jtdSchema['type'] as string;\n    const baseType = typeMap[jtdType] || 'string';\n\n    result.type = isNullable ? [baseType, 'null'] : baseType;\n\n    if (baseType === 'string' && jtdType === 'timestamp') {\n      result.format = 'date-time';\n    }\n    return result;\n  }\n\n  // Enum form\n  if (jtdSchema['enum']) {\n    result.type = isNullable ? ['string', 'null'] : 'string';\n    result.enum = isNullable\n      ? [...(jtdSchema['enum'] as string[]), null]\n      : jtdSchema['enum'];\n    return result;\n  }\n\n  // Elements form\n  if (jtdSchema['elements']) {\n    result.type = isNullable ? ['array', 'null'] : 'array';\n    result.items = jtdToJsonSchema(\n      jtdSchema['elements'] as JTDSchemaJson,\n      defs,\n      false\n    );\n    return result;\n  }\n\n  // Properties form\n  if (jtdSchema['properties'] || jtdSchema['optionalProperties']) {\n    result.type = isNullable ? ['object', 'null'] : 'object';\n    result.properties = {};\n    result.required = [];\n\n    if (jtdSchema['properties']) {\n      for (const [key, value] of Object.entries(jtdSchema['properties'])) {\n        result.properties[key] = jtdToJsonSchema(\n          value as JTDSchemaJson,\n          defs,\n          false\n        );\n        result.required.push(key);\n      }\n    }\n\n    if (jtdSchema['optionalProperties']) {\n      for (const [key, value] of Object.entries(\n        jtdSchema['optionalProperties']\n      )) {\n        result.properties[key] = jtdToJsonSchema(\n          value as JTDSchemaJson,\n          defs,\n          false\n        );\n      }\n    }\n\n    // JTD is strict by default\n    if (jtdSchema['additionalProperties'] !== true) {\n      result.additionalProperties = false;\n    }\n\n    return result;\n  }\n\n  // Values form\n  if (jtdSchema['values']) {\n    result.type = isNullable ? ['object', 'null'] : 'object';\n    result.additionalProperties = jtdToJsonSchema(\n      jtdSchema['values'] as JTDSchemaJson,\n      defs,\n      false\n    );\n    return result;\n  }\n\n  // Discriminator form\n  if (jtdSchema['discriminator'] && jtdSchema['mapping']) {\n    const variants = [];\n    const discriminatorKey = jtdSchema['discriminator'] as string;\n\n    for (const [tag, schema] of Object.entries(jtdSchema['mapping'])) {\n      const variantSchema = jtdToJsonSchema(\n        schema as JTDSchemaJson,\n        defs,\n        false\n      );\n\n      if (!variantSchema.type) {\n        variantSchema.type = 'object';\n      } else if (\n        variantSchema.type !== 'object' &&\n        !Array.isArray(variantSchema.type)\n      ) {\n        variantSchema.type = 'object';\n      }\n\n      variantSchema.properties = variantSchema.properties || {};\n      variantSchema.properties[discriminatorKey] = { const: tag };\n\n      variantSchema.required = variantSchema.required || [];\n      if (!variantSchema.required.includes(discriminatorKey)) {\n        variantSchema.required.unshift(discriminatorKey);\n      }\n\n      // JTD discriminator variants are strict by default\n      if (variantSchema.additionalProperties === undefined) {\n        variantSchema.additionalProperties = false;\n      }\n\n      variants.push(variantSchema);\n    }\n\n    if (isNullable) {\n      variants.push({ type: 'null' });\n    }\n\n    result.oneOf = variants;\n    return result;\n  }\n\n  // Empty form\n  return result;\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// JTD SCHEMA VALIDATION (using the `jtd` npm package)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nexport const MAX_VALIDATION_DEPTH = 32;\nexport const MAX_VALIDATION_ERRORS = 100;\n\n/** Validate that the input is a valid JTD schema. */\nexport function validateJTDSchema(\n  schema: unknown\n): { valid: true; schema: JTDSchemaJson } | { valid: false; error: string } {\n  if (!isSchema(schema)) {\n    return {\n      valid: false,\n      error: 'Invalid JTD schema: Schema does not match JTD structure'\n    };\n  }\n\n  if (!isValidSchema(schema)) {\n    return {\n      valid: false,\n      error:\n        'Invalid JTD schema: Schema has semantic errors (e.g., circular references, conflicting forms)'\n    };\n  }\n\n  return { valid: true, schema: schema as unknown as JTDSchemaJson };\n}\n\n/** Parse and validate a JSON string. */\nexport function validateJSON(jsonString: string): {\n  valid: boolean;\n  data?: unknown;\n  error?: string;\n} {\n  try {\n    const data = JSON.parse(jsonString);\n    return { valid: true, data };\n  } catch (error) {\n    return {\n      valid: false,\n      error: `Invalid JSON: ${error instanceof Error ? error.message : 'Parse error'}`\n    };\n  }\n}\n\n/** Parse a JSON string and validate it as a JTD schema. */\nexport function validateJTDSchemaString(\n  schemaString: string\n): { valid: true; schema: JTDSchemaJson } | { valid: false; error: string } {\n  const jsonResult = validateJSON(schemaString);\n  if (!jsonResult.valid) return { valid: false, error: jsonResult.error! };\n\n  return validateJTDSchema(jsonResult.data);\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// MONACO EDITOR CONFIG FOR JTD SCHEMA EDITING\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/** Monaco editor JSON schema configuration for JTD schema IntelliSense and validation. */\nexport const JTD_SCHEMA_CONFIG = {\n  uri: 'https://jsontypedef.com/schemas/jtd-schema.json',\n  fileMatch: ['inmemory://jtd-schema/*.json'],\n  schema: {\n    $schema: 'http://json-schema.org/draft-07/schema#',\n    type: 'object',\n    properties: {\n      type: {\n        description: 'Type form - defines a primitive type',\n        enum: [\n          'boolean',\n          'string',\n          'timestamp',\n          'float32',\n          'float64',\n          'int8',\n          'uint8',\n          'int16',\n          'uint16',\n          'int32',\n          'uint32'\n        ]\n      },\n      enum: {\n        description: 'Enum form - defines a set of string values',\n        type: 'array',\n        items: { type: 'string' }\n      },\n      elements: {\n        description: 'Elements form - defines an array with typed elements',\n        $ref: '#'\n      },\n      properties: {\n        description:\n          'Properties form - defines an object with required properties',\n        type: 'object',\n        additionalProperties: { $ref: '#' }\n      },\n      optionalProperties: {\n        description: 'Optional properties - defines optional object properties',\n        type: 'object',\n        additionalProperties: { $ref: '#' }\n      },\n      values: {\n        description: 'Values form - defines a map/dictionary with typed values',\n        $ref: '#'\n      },\n      discriminator: {\n        description: 'Discriminator form - defines a tagged union',\n        type: 'string'\n      },\n      mapping: {\n        description: 'Mapping for discriminator form',\n        type: 'object',\n        additionalProperties: { $ref: '#' }\n      },\n      ref: {\n        description: 'Ref form - references a definition',\n        type: 'string'\n      },\n      definitions: {\n        description: 'Top-level definitions for reusable schemas',\n        type: 'object',\n        additionalProperties: { $ref: '#' }\n      },\n      nullable: {\n        description: 'Allow null values',\n        type: 'boolean'\n      },\n      metadata: {\n        description: 'Custom metadata for documentation',\n        type: 'object'\n      },\n      additionalProperties: {\n        description: 'Allow additional properties (properties form only)',\n        type: 'boolean'\n      }\n    }\n  }\n};\n", "// Copyright 2024-2025 Mochabug, LLC. All rights reserved.\n// Licensed under the Apache License, Version 2.0.\n\nimport type {\n  JTDSchemaJson,\n  SignalDescriptorJson,\n  SignalFormatJson\n} from '../api';\nimport { validateJsonAgainstJTD } from '../signals';\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Types\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/** JSON Schema subset supported by OpenAI structured output (strict mode). */\nexport interface OpenAISchema {\n  type?: string | string[];\n  description?: string;\n  properties?: Record<string, OpenAISchema>;\n  required?: string[];\n  additionalProperties?: false;\n  enum?: (string | number | null)[];\n  format?: string;\n  items?: OpenAISchema;\n  minimum?: number;\n  maximum?: number;\n  anyOf?: OpenAISchema[];\n  $defs?: Record<string, OpenAISchema>;\n  $ref?: string;\n}\n\nexport interface ConvertSuccess {\n  success: true;\n  data: unknown;\n}\n\nexport interface ConvertFailure {\n  success: false;\n  errors: string[];\n}\n\nexport type ConvertResult = ConvertSuccess | ConvertFailure;\n\nexport interface OpenAIConversionResult {\n  /** OpenAI strict mode compatible JSON Schema. */\n  schema: OpenAISchema;\n  /** Whether the schema supports strict mode. False for unstructured (empty) schemas. */\n  strict: boolean;\n  /** Convert OpenAI JSON output back to JTD-conforming JSON. */\n  convert: (openaiJson: unknown) => ConvertResult;\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Constants\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nconst MAX_REF_DEPTH = 32;\n\nconst INTEGER_BOUNDS: Record<string, { minimum: number; maximum: number }> = {\n  int8: { minimum: -128, maximum: 127 },\n  uint8: { minimum: 0, maximum: 255 },\n  int16: { minimum: -32768, maximum: 32767 },\n  uint16: { minimum: 0, maximum: 65535 },\n  int32: { minimum: -2147483648, maximum: 2147483647 },\n  uint32: { minimum: 0, maximum: 4294967295 }\n};\n\nconst FLOAT32_BOUNDS = {\n  minimum: -3.4028235e38,\n  maximum: 3.4028235e38\n};\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Helpers\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/** Check if a JTD schema is unstructured (empty form or equivalent). */\nfunction isUnstructuredSchema(schema: JTDSchemaJson): boolean {\n  if (!schema || typeof schema !== 'object') return true;\n\n  if (\n    schema.type ||\n    schema.enum ||\n    schema.elements ||\n    schema.values ||\n    schema.discriminator ||\n    schema.ref\n  ) {\n    return false;\n  }\n\n  const hasRealProps =\n    (schema.properties && Object.keys(schema.properties).length > 0) ||\n    (schema.optionalProperties &&\n      Object.keys(schema.optionalProperties).length > 0);\n\n  if (hasRealProps) return false;\n\n  // Properties form with empty props + additionalProperties: true \u2192 unstructured\n  if (\n    (schema.properties !== undefined ||\n      schema.optionalProperties !== undefined) &&\n    schema.additionalProperties === true\n  ) {\n    return true;\n  }\n\n  // Properties form with empty props, no AP:true \u2192 structured empty object\n  if (\n    schema.properties !== undefined ||\n    schema.optionalProperties !== undefined\n  ) {\n    return false;\n  }\n\n  // Truly empty schema\n  return true;\n}\n\n/** Resolve refs at root to determine if the root target is unstructured. */\nfunction isRootUnstructured(\n  schema: JTDSchemaJson,\n  defs: Record<string, JTDSchemaJson> | undefined\n): boolean {\n  let resolved = schema;\n  let depth = 0;\n  while (resolved.ref && depth < MAX_REF_DEPTH) {\n    const target = defs?.[resolved.ref as string];\n    if (!target) return false;\n    resolved = target;\n    depth++;\n  }\n  if (depth >= MAX_REF_DEPTH) return false;\n  return isUnstructuredSchema(resolved);\n}\n\n/** Make a schema nullable by adding \"null\" to the type. */\nfunction makeNullable(schema: OpenAISchema): OpenAISchema {\n  if (Array.isArray(schema.type) && schema.type.includes('null')) return schema;\n  if (schema.type === 'null') return schema;\n\n  // $ref \u2192 wrap in anyOf with null\n  if (schema.$ref) {\n    return { anyOf: [schema, { type: 'null' }] };\n  }\n\n  // anyOf \u2192 add null variant\n  if (schema.anyOf) {\n    if (schema.anyOf.some((s) => s.type === 'null')) return schema;\n    return { ...schema, anyOf: [...schema.anyOf, { type: 'null' }] };\n  }\n\n  // Standard: add null to type and enum\n  const result = { ...schema };\n  if (result.type) {\n    result.type = Array.isArray(result.type)\n      ? [...result.type, 'null']\n      : [result.type, 'null'];\n  }\n  if (result.enum && !result.enum.includes(null)) {\n    result.enum = [...result.enum, null];\n  }\n  return result;\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Metadata helper\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nconst METADATA_KNOWN_KEYS = new Set(['title', 'label', 'name', 'description']);\n\nfunction applyMetadata(result: OpenAISchema, schema: JTDSchemaJson): void {\n  const meta = schema.metadata as Record<string, unknown> | undefined;\n  if (!meta) return;\n\n  const descParts: string[] = [];\n\n  // OAI doesn't support title \u2014 fold title/label/name into description\n  const titleCandidate =\n    (typeof meta['title'] === 'string' && meta['title'].trim()) ||\n    (typeof meta['label'] === 'string' && meta['label'].trim()) ||\n    (typeof meta['name'] === 'string' && meta['name'].trim());\n\n  const descText =\n    typeof meta['description'] === 'string' ? meta['description'].trim() : '';\n\n  if (titleCandidate && descText) {\n    descParts.push(`${titleCandidate}. ${descText}`);\n  } else if (titleCandidate) {\n    descParts.push(titleCandidate);\n  } else if (descText) {\n    descParts.push(descText);\n  }\n\n  // Extra metadata keys as description hints\n  const extras: string[] = [];\n  for (const [key, value] of Object.entries(meta)) {\n    if (METADATA_KNOWN_KEYS.has(key)) continue;\n    if (typeof value === 'string' && value.trim()) {\n      extras.push(`[${key}: ${value.trim()}]`);\n    } else if (typeof value === 'number' || typeof value === 'boolean') {\n      extras.push(`[${key}: ${value}]`);\n    }\n  }\n  if (extras.length > 0) {\n    descParts.push(extras.join(' '));\n  }\n\n  if (descParts.length > 0) {\n    const newDesc = descParts.join(' ');\n    result.description = result.description\n      ? `${result.description} ${newDesc}`\n      : newDesc;\n  }\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Schema conversion (JTD \u2192 OpenAI JSON Schema)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nfunction convertNode(\n  schema: JTDSchemaJson,\n  defs: Record<string, JTDSchemaJson> | undefined,\n  depth: number\n): OpenAISchema {\n  if (depth > MAX_REF_DEPTH) {\n    throw new Error(`Schema nesting exceeded ${MAX_REF_DEPTH} levels`);\n  }\n\n  if (!schema || typeof schema !== 'object') {\n    return { type: 'string', description: 'Must be a valid JSON value.' };\n  }\n\n  // Unstructured (empty form or AP:true with no real props) \u2192 string\n  if (isUnstructuredSchema(schema)) {\n    const isNullable = schema.nullable === true;\n    const result: OpenAISchema = {\n      type: isNullable ? ['string', 'null'] : 'string',\n      description: 'Must be a valid JSON value.'\n    };\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  const isNullable = schema.nullable === true;\n\n  // Ref form \u2192 $ref\n  if (schema.ref) {\n    const refName = schema.ref as string;\n    if (!defs?.[refName]) {\n      throw new Error(`Unresolved ref \"${refName}\"`);\n    }\n    if (isNullable) {\n      const result: OpenAISchema = {\n        anyOf: [{ $ref: `#/$defs/${refName}` }, { type: 'null' }]\n      };\n      applyMetadata(result, schema);\n      return result;\n    }\n    // Bare $ref \u2014 skip metadata (JSON Schema $ref may ignore sibling keywords)\n    return { $ref: `#/$defs/${refName}` };\n  }\n\n  // Type form\n  if (schema.type) {\n    const jtdType = schema.type as string;\n    const result: OpenAISchema = {};\n\n    const intBounds = INTEGER_BOUNDS[jtdType];\n    if (intBounds) {\n      result.type = isNullable ? ['integer', 'null'] : 'integer';\n      result.minimum = intBounds.minimum;\n      result.maximum = intBounds.maximum;\n      applyMetadata(result, schema);\n      return result;\n    }\n\n    switch (jtdType) {\n      case 'boolean':\n        result.type = isNullable ? ['boolean', 'null'] : 'boolean';\n        break;\n      case 'string':\n        result.type = isNullable ? ['string', 'null'] : 'string';\n        break;\n      case 'timestamp':\n        result.type = isNullable ? ['string', 'null'] : 'string';\n        result.format = 'date-time';\n        break;\n      case 'float32':\n        result.type = isNullable ? ['number', 'null'] : 'number';\n        result.minimum = FLOAT32_BOUNDS.minimum;\n        result.maximum = FLOAT32_BOUNDS.maximum;\n        break;\n      case 'float64':\n        result.type = isNullable ? ['number', 'null'] : 'number';\n        break;\n      default:\n        throw new Error(`Unknown JTD type \"${jtdType}\"`);\n    }\n\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  // Enum form\n  if (schema.enum) {\n    const result: OpenAISchema = {\n      type: isNullable ? ['string', 'null'] : 'string',\n      enum: isNullable\n        ? [...(schema.enum as string[]), null]\n        : [...(schema.enum as string[])]\n    };\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  // Elements form\n  if (schema.elements) {\n    const result: OpenAISchema = {\n      type: isNullable ? ['array', 'null'] : 'array',\n      items: convertNode(schema.elements as JTDSchemaJson, defs, depth + 1)\n    };\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  // Properties form (has real props \u2014 unstructured was caught above)\n  if (schema.properties || schema.optionalProperties) {\n    const result: OpenAISchema = {\n      type: isNullable ? ['object', 'null'] : 'object',\n      properties: {},\n      additionalProperties: false\n    };\n    const required: string[] = [];\n\n    if (schema.properties) {\n      for (const [key, propSchema] of Object.entries(schema.properties)) {\n        result.properties![key] = convertNode(\n          propSchema as JTDSchemaJson,\n          defs,\n          depth + 1\n        );\n        required.push(key);\n      }\n    }\n\n    // Optional properties \u2192 required + nullable\n    if (schema.optionalProperties) {\n      for (const [key, propSchema] of Object.entries(\n        schema.optionalProperties\n      )) {\n        const converted = convertNode(\n          propSchema as JTDSchemaJson,\n          defs,\n          depth + 1\n        );\n        result.properties![key] = makeNullable(converted);\n        required.push(key);\n      }\n    }\n\n    result.required = required;\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  // Values form \u2192 array of {key, value} objects\n  if (schema.values) {\n    const valueSchema = convertNode(\n      schema.values as JTDSchemaJson,\n      defs,\n      depth + 1\n    );\n    const result: OpenAISchema = {\n      type: isNullable ? ['array', 'null'] : 'array',\n      items: {\n        type: 'object',\n        properties: {\n          key: { type: 'string' },\n          value: valueSchema\n        },\n        required: ['key', 'value'],\n        additionalProperties: false\n      }\n    };\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  // Discriminator form \u2192 anyOf with flat variants\n  if (schema.discriminator && schema.mapping) {\n    const discKey = schema.discriminator as string;\n    const mapping = schema.mapping as Record<string, JTDSchemaJson>;\n    const variants: OpenAISchema[] = [];\n\n    for (const [tag, variantSchema] of Object.entries(mapping)) {\n      let variantOAI: OpenAISchema;\n\n      if (isUnstructuredSchema(variantSchema)) {\n        // Unstructured variant: disc + _data string\n        variantOAI = {\n          type: 'object',\n          properties: {\n            [discKey]: { type: 'string', enum: [tag] },\n            _data: {\n              type: 'string',\n              description:\n                'Must be a valid JSON value representing the variant data.'\n            }\n          },\n          required: [discKey, '_data'],\n          additionalProperties: false\n        };\n      } else {\n        // Per RFC 8927, mapping values are always properties form,\n        // and the discriminator tag never appears in variant properties.\n        variantOAI = convertNode(variantSchema, defs, depth + 1);\n        variantOAI.properties![discKey] = { type: 'string', enum: [tag] };\n        (variantOAI.required ??= []).unshift(discKey);\n        variantOAI.additionalProperties = false;\n      }\n\n      applyMetadata(variantOAI, variantSchema);\n      variants.push(variantOAI);\n    }\n\n    const result: OpenAISchema = { anyOf: variants };\n    if (isNullable) {\n      result.anyOf!.push({ type: 'null' });\n    }\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  // Fallback\n  return { type: 'string', description: 'Must be a valid JSON value.' };\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Coercion (OpenAI output \u2192 JTD-conforming JSON)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nconst INTEGER_TYPE_SET = new Set(Object.keys(INTEGER_BOUNDS));\n\nfunction coerceToJTD(\n  value: unknown,\n  schema: JTDSchemaJson,\n  defs: Record<string, JTDSchemaJson> | undefined,\n  depth: number\n): unknown {\n  if (depth > MAX_REF_DEPTH) return value;\n  if (value === null || value === undefined) return value;\n\n  // Ref form \u2014 resolve in original JTD definitions and recurse\n  if (schema.ref) {\n    const resolved = defs?.[schema.ref as string];\n    if (resolved) {\n      return coerceToJTD(value, resolved, defs, depth + 1);\n    }\n    return value;\n  }\n\n  // Unstructured schema \u2014 parse JSON string back to value\n  if (isUnstructuredSchema(schema)) {\n    if (typeof value === 'string') {\n      try {\n        return JSON.parse(value);\n      } catch {\n        return value;\n      }\n    }\n    return value;\n  }\n\n  // Type form \u2014 integer coercion\n  if (schema.type && INTEGER_TYPE_SET.has(schema.type as string)) {\n    if (typeof value === 'number' && !Number.isInteger(value)) {\n      return Math.round(value);\n    }\n    return value;\n  }\n\n  // Elements form\n  if (schema.elements && Array.isArray(value)) {\n    return value.map((item) =>\n      coerceToJTD(item, schema.elements as JTDSchemaJson, defs, depth + 1)\n    );\n  }\n\n  // Properties form \u2014 strip null optionals\n  if (\n    (schema.properties || schema.optionalProperties) &&\n    typeof value === 'object' &&\n    value !== null\n  ) {\n    const obj = { ...(value as Record<string, unknown>) };\n\n    if (schema.properties) {\n      for (const [k, propSchema] of Object.entries(schema.properties)) {\n        if (k in obj) {\n          obj[k] = coerceToJTD(\n            obj[k],\n            propSchema as JTDSchemaJson,\n            defs,\n            depth + 1\n          );\n        }\n      }\n    }\n\n    // Optional properties: null \u2192 omit\n    if (schema.optionalProperties) {\n      for (const [k, propSchema] of Object.entries(\n        schema.optionalProperties\n      )) {\n        if (k in obj) {\n          if (obj[k] === null) {\n            delete obj[k];\n          } else {\n            obj[k] = coerceToJTD(\n              obj[k],\n              propSchema as JTDSchemaJson,\n              defs,\n              depth + 1\n            );\n          }\n        }\n      }\n    }\n\n    return obj;\n  }\n\n  // Values form \u2014 convert array of {key, value} to Record\n  if (schema.values && Array.isArray(value)) {\n    const result: Record<string, unknown> = {};\n    for (const entry of value) {\n      if (typeof entry === 'object' && entry !== null) {\n        const rec = entry as Record<string, unknown>;\n        const key = rec.key as string;\n        result[key] = coerceToJTD(\n          rec.value,\n          schema.values as JTDSchemaJson,\n          defs,\n          depth + 1\n        );\n      }\n    }\n    return result;\n  }\n\n  // Discriminator form \u2014 flat object, coerce variant + strip null optionals\n  if (\n    schema.discriminator &&\n    schema.mapping &&\n    typeof value === 'object' &&\n    value !== null\n  ) {\n    const rec = value as Record<string, unknown>;\n    const discKey = schema.discriminator as string;\n    const tag = rec[discKey] as string;\n    const variantSchema = (schema.mapping as Record<string, JTDSchemaJson>)[\n      tag\n    ];\n\n    if (!variantSchema) return value;\n\n    // Unstructured variant: parse _data\n    if (isUnstructuredSchema(variantSchema)) {\n      const dataStr = rec._data;\n      if (typeof dataStr === 'string') {\n        try {\n          const parsed = JSON.parse(dataStr);\n          if (typeof parsed === 'object' && parsed !== null) {\n            return { [discKey]: tag, ...parsed };\n          }\n        } catch {\n          /* validation catches */\n        }\n      }\n      return { [discKey]: tag };\n    }\n\n    // Build flat result: discriminator + variant properties\n    const result: Record<string, unknown> = { [discKey]: tag };\n\n    if (variantSchema.properties) {\n      for (const [k, propSchema] of Object.entries(variantSchema.properties)) {\n        if (k in rec) {\n          result[k] = coerceToJTD(\n            rec[k],\n            propSchema as JTDSchemaJson,\n            defs,\n            depth + 1\n          );\n        }\n      }\n    }\n\n    if (variantSchema.optionalProperties) {\n      for (const [k, propSchema] of Object.entries(\n        variantSchema.optionalProperties\n      )) {\n        if (k in rec && rec[k] !== null) {\n          result[k] = coerceToJTD(\n            rec[k],\n            propSchema as JTDSchemaJson,\n            defs,\n            depth + 1\n          );\n        }\n      }\n    }\n\n    return result;\n  }\n\n  return value;\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Public API\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/**\n * Convert a JTD schema to an OpenAI strict mode compatible JSON Schema, with a\n * converter function that transforms and validates OpenAI output against\n * the original JTD schema.\n *\n * @throws {Error} if the JTD schema contains forms that cannot be represented.\n */\nexport function convertToOpenAISchema(\n  jtdSchema: JTDSchemaJson\n): OpenAIConversionResult {\n  const defs = jtdSchema.definitions as\n    | Record<string, JTDSchemaJson>\n    | undefined;\n\n  const strict = !isRootUnstructured(jtdSchema, defs);\n\n  let schema: OpenAISchema;\n  if (strict) {\n    schema = convertNode(jtdSchema, defs, 0);\n\n    // Attach $defs at root\n    if (defs && Object.keys(defs).length > 0) {\n      const oaiDefs: Record<string, OpenAISchema> = {};\n      for (const [name, defSchema] of Object.entries(defs)) {\n        oaiDefs[name] = convertNode(defSchema as JTDSchemaJson, defs, 0);\n      }\n      schema.$defs = oaiDefs;\n    }\n  } else {\n    schema = {};\n    applyMetadata(schema, jtdSchema);\n  }\n\n  const convert = (openaiJson: unknown): ConvertResult => {\n    const coerced = coerceToJTD(openaiJson, jtdSchema, defs, 0);\n    const errors = validateJsonAgainstJTD(jtdSchema, coerced, defs);\n    if (errors.length > 0) {\n      return { success: false, errors };\n    }\n    return { success: true, data: coerced };\n  };\n\n  return { schema, strict, convert };\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Signal-level conversion (SignalDescriptorJson \u2192 OpenAI schema)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nfunction convertMimeFormat(mimeType: string): OpenAISchema {\n  return {\n    type: 'string',\n    description: `Base64-encoded binary content (MIME type: ${mimeType}).`\n  };\n}\n\nfunction convertSingleFormat(\n  format: SignalFormatJson\n): OpenAIConversionResult {\n  if (format.jtdSchema) {\n    return convertToOpenAISchema(format.jtdSchema);\n  }\n  if (format.mimeType) {\n    const schema = convertMimeFormat(format.mimeType);\n    const convert = (openaiJson: unknown): ConvertResult => {\n      if (typeof openaiJson !== 'string') {\n        return {\n          success: false,\n          errors: [\n            `/: expected base64 string for MIME type ${format.mimeType}, got ${typeof openaiJson}`\n          ]\n        };\n      }\n      return { success: true, data: openaiJson };\n    };\n    return { schema, strict: true, convert };\n  }\n  throw new Error('Signal format has neither jtdSchema nor mimeType');\n}\n\n/**\n * Convert a SignalDescriptorJson to an OpenAI strict mode compatible JSON Schema.\n *\n * Handles single and multi-format signals:\n * - Single format: schema is the converted format directly.\n * - Multiple formats: wrapper object with `format_0`, `format_1`, etc.\n *   All format properties are required and nullable (OAI strict mode).\n *   The model sets exactly one to a value and the rest to null.\n *\n * @throws {Error} if the descriptor has no formats.\n */\nexport function convertSignalToOpenAISchema(\n  descriptor: SignalDescriptorJson\n): OpenAIConversionResult {\n  const formats = descriptor.formats as SignalFormatJson[] | undefined;\n  if (!formats || formats.length === 0) {\n    throw new Error('Signal descriptor has no formats');\n  }\n\n  const signalName = descriptor.name ?? 'unnamed';\n  const isOptional = descriptor.optional === true;\n\n  // Single format \u2014 no wrapper\n  if (formats.length === 1) {\n    const result = convertSingleFormat(formats[0]!);\n    if (descriptor.label || descriptor.description) {\n      const parts: string[] = [];\n      if (descriptor.label) parts.push(descriptor.label);\n      if (descriptor.description) parts.push(descriptor.description);\n      const newDesc = parts.join('. ');\n      result.schema.description = result.schema.description\n        ? `${newDesc} ${result.schema.description}`\n        : newDesc;\n    }\n    return result;\n  }\n\n  // Multiple formats \u2014 wrapper object, all format props required + nullable\n  const formatConverters: Array<{\n    key: string;\n    converter: OpenAIConversionResult;\n  }> = [];\n\n  const wrapperProps: Record<string, OpenAISchema> = {};\n  const required: string[] = [];\n\n  for (let i = 0; i < formats.length; i++) {\n    const fmt = formats[i]!;\n    const key = `format_${i}`;\n    const conv = convertSingleFormat(fmt);\n\n    if (fmt.jtdSchema) {\n      const existing = conv.schema.description;\n      conv.schema.description = existing\n        ? `Structured JSON data. ${existing}`\n        : 'Structured JSON data.';\n    }\n\n    wrapperProps[key] = makeNullable(conv.schema);\n    required.push(key);\n    formatConverters.push({ key, converter: conv });\n  }\n\n  const keys = formatConverters.map((f) => f.key);\n  const baseDesc = descriptor.description ?? '';\n  const guidance = isOptional\n    ? 'Provide at most ONE of the following format properties, set all others to null.'\n    : `You MUST provide exactly ONE of the following format properties: ${keys.join(', ')}. Set all others to null.`;\n\n  const schema: OpenAISchema = {\n    type: 'object',\n    description: baseDesc ? `${baseDesc} ${guidance}` : guidance,\n    properties: wrapperProps,\n    required,\n    additionalProperties: false\n  };\n\n  const convert = (openaiJson: unknown): ConvertResult => {\n    if (typeof openaiJson !== 'object' || openaiJson === null) {\n      return {\n        success: false,\n        errors: [\n          `/: expected object with format properties, got ${typeof openaiJson}`\n        ]\n      };\n    }\n\n    const rec = openaiJson as Record<string, unknown>;\n\n    // Find which format is set (non-null)\n    const selected = formatConverters.find(\n      ({ key }) => rec[key] !== undefined && rec[key] !== null\n    );\n\n    if (!selected) {\n      if (isOptional) {\n        return { success: true, data: null };\n      }\n      return {\n        success: false,\n        errors: [\n          `Signal '${signalName}' is required but no format was provided. Set exactly one of: ${keys.join(', ')}.`\n        ]\n      };\n    }\n\n    return selected.converter.convert(rec[selected.key]);\n  };\n\n  return { schema, strict: true, convert };\n}\n"],
-  "mappings": "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",
-  "names": ["isSchema", "isValidSchema", "jtdValidate", "INTEGER_TYPES", "formatInstancePath", "instancePath", "p", "resolveSchemaParent", "schema", "schemaPath", "current", "resolveInstanceValue", "value", "key", "formatValidationError", "error", "path", "lastKey", "jtdType", "enumValues", "discValue", "validateJsonAgainstJTD", "definitions", "defs", "schemaForValidation", "isValidSchema", "jtdValidate", "MAX_VALIDATION_DEPTH", "MAX_VALIDATION_ERRORS", "err", "MAX_VALIDATION_DEPTH", "MAX_VALIDATION_ERRORS", "MAX_REF_DEPTH", "INTEGER_BOUNDS", "FLOAT32_BOUNDS", "isUnstructuredSchema", "schema", "isRootUnstructured", "defs", "resolved", "depth", "target", "makeNullable", "s", "result", "METADATA_KNOWN_KEYS", "applyMetadata", "meta", "descParts", "titleCandidate", "descText", "extras", "key", "value", "newDesc", "convertNode", "isNullable", "refName", "jtdType", "intBounds", "required", "propSchema", "converted", "valueSchema", "discKey", "mapping", "variants", "tag", "variantSchema", "variantOAI", "INTEGER_TYPE_SET", "coerceToJTD", "item", "obj", "k", "entry", "rec", "dataStr", "parsed", "convertToOpenAISchema", "jtdSchema", "strict", "oaiDefs", "name", "defSchema", "openaiJson", "coerced", "errors", "validateJsonAgainstJTD", "convertMimeFormat", "mimeType", "convertSingleFormat", "format", "convertSignalToOpenAISchema", "descriptor", "formats", "signalName", "isOptional", "parts", "formatConverters", "wrapperProps", "i", "fmt", "conv", "existing", "keys", "f", "baseDesc", "guidance", "selected"]
+  "sourcesContent": ["import type {\n  JTDSchemaJson,\n  SignalDescriptorJson,\n  SignalFormatJson\n} from '../api';\nimport { isSchema, isValidSchema, validate as jtdValidate } from 'jtd';\nimport type { Schema, ValidationError } from 'jtd';\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// JTD FUZZER (generate sample values from JTD schemas)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/** Maximum recursion depth for fuzzJTD to prevent infinite loops on self-referencing schemas. */\nconst FUZZ_MAX_DEPTH = 10;\n\n/** Generate a fuzzed (sample) value from a JTD schema. */\nexport function fuzzJTD(\n  schema: JTDSchemaJson,\n  definitions?: Record<string, JTDSchemaJson>,\n  _depth: number = 0\n): unknown {\n  if (_depth > FUZZ_MAX_DEPTH) return null;\n\n  if (schema.ref) {\n    const def = definitions?.[schema.ref];\n    if (def) return fuzzJTD(def, definitions, _depth + 1);\n    return null;\n  }\n\n  if (schema.type) {\n    switch (schema.type) {\n      case 'string':\n        return 'Lorem ipsum';\n      case 'timestamp':\n        return '2024-01-15T10:30:00Z';\n      case 'float32':\n      case 'float64':\n        return 42.5;\n      case 'int8':\n      case 'uint8':\n      case 'int16':\n      case 'uint16':\n      case 'int32':\n      case 'uint32':\n        return BigInt(42);\n      case 'boolean':\n        return true;\n      default:\n        return null;\n    }\n  }\n\n  if (schema.enum) {\n    return schema.enum[0] ?? null;\n  }\n\n  if (schema.elements) {\n    return [\n      fuzzJTD(schema.elements, definitions, _depth + 1),\n      fuzzJTD(schema.elements, definitions, _depth + 1)\n    ];\n  }\n\n  if (schema.values) {\n    return { key1: fuzzJTD(schema.values, definitions, _depth + 1) };\n  }\n\n  if (schema.properties || schema.optionalProperties) {\n    const obj: Record<string, unknown> = {};\n    if (schema.properties) {\n      for (const [k, v] of Object.entries(schema.properties)) {\n        obj[k] = fuzzJTD(v, definitions, _depth + 1);\n      }\n    }\n    if (schema.optionalProperties) {\n      for (const [k, v] of Object.entries(schema.optionalProperties)) {\n        obj[k] = fuzzJTD(v, definitions, _depth + 1);\n      }\n    }\n    return obj;\n  }\n\n  if (schema.discriminator && schema.mapping) {\n    const firstKey = Object.keys(schema.mapping)[0];\n    if (firstKey) {\n      const variant = schema.mapping[firstKey]!;\n      const obj = fuzzJTD(variant, definitions, _depth + 1) as Record<\n        string,\n        unknown\n      >;\n      obj[schema.discriminator] = firstKey;\n      return obj;\n    }\n    return null;\n  }\n\n  // Empty schema\n  return null;\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// JTD VALUE VALIDATION (delegates to the `jtd` npm package)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nconst INTEGER_TYPES = new Set([\n  'int8',\n  'uint8',\n  'int16',\n  'uint16',\n  'int32',\n  'uint32'\n]);\n\nfunction formatInstancePath(instancePath: string[]): string {\n  if (instancePath.length === 0) return '/';\n  return instancePath\n    .map((p) => (/^\\d+$/.test(p) ? `[${p}]` : `.${p}`))\n    .join('');\n}\n\nfunction resolveSchemaParent(\n  schema: Record<string, unknown>,\n  schemaPath: string[]\n): Record<string, unknown> {\n  let current: any = schema;\n  for (let i = 0; i < schemaPath.length - 1; i++) {\n    if (current && typeof current === 'object' && schemaPath[i]! in current) {\n      current = current[schemaPath[i]!];\n    } else {\n      break;\n    }\n  }\n  return current as Record<string, unknown>;\n}\n\nfunction resolveInstanceValue(value: unknown, instancePath: string[]): unknown {\n  let current = value;\n  for (const key of instancePath) {\n    if (current && typeof current === 'object') {\n      current = (current as Record<string, unknown>)[key];\n    } else {\n      return undefined;\n    }\n  }\n  return current;\n}\n\nfunction formatValidationError(\n  error: ValidationError,\n  schema: Record<string, unknown>,\n  value: unknown\n): string {\n  const { instancePath, schemaPath } = error;\n  const path = formatInstancePath(instancePath);\n  const lastKey = schemaPath[schemaPath.length - 1];\n\n  if (lastKey === 'type') {\n    const parent = resolveSchemaParent(schema, schemaPath);\n    const jtdType = parent?.type as string;\n    if (jtdType === 'boolean') return `${path}: expected boolean`;\n    if (jtdType === 'string') return `${path}: expected string`;\n    if (jtdType === 'timestamp') return `${path}: expected timestamp string`;\n    if (INTEGER_TYPES.has(jtdType)) return `${path}: expected integer`;\n    return `${path}: expected number`;\n  }\n\n  if (lastKey === 'enum') {\n    const parent = resolveSchemaParent(schema, schemaPath);\n    const enumValues = parent?.enum as string[];\n    return `${path}: expected one of [${enumValues.join(', ')}]`;\n  }\n\n  if (\n    schemaPath.length >= 2 &&\n    schemaPath[schemaPath.length - 2] === 'properties' &&\n    lastKey\n  ) {\n    const prefix = path === '/' ? '' : path;\n    return `${prefix}.${lastKey}: missing required property`;\n  }\n\n  if (lastKey === 'elements') return `${path}: expected array`;\n\n  if (\n    lastKey === 'properties' ||\n    lastKey === 'optionalProperties' ||\n    lastKey === 'values'\n  ) {\n    return `${path}: expected object`;\n  }\n\n  if (lastKey === 'discriminator')\n    return `${path}: expected string discriminator`;\n\n  if (lastKey === 'mapping') {\n    const discValue = resolveInstanceValue(value, instancePath);\n    return `${path}: unknown variant \"${discValue}\"`;\n  }\n\n  if (schemaPath.length === 0) return `${path}: unexpected property`;\n\n  return `${path}: validation error at /${schemaPath.join('/')}`;\n}\n\n/**\n * Validate a value against a JTD schema, returning an array of error messages.\n * Delegates to the `jtd` npm package for spec-compliant validation.\n */\nexport function validateJsonAgainstJTD(\n  schema: JTDSchemaJson,\n  value: unknown,\n  definitions?: Record<string, JTDSchemaJson>\n): string[] {\n  const defs =\n    definitions ??\n    (schema.definitions as Record<string, JTDSchemaJson> | undefined);\n\n  const schemaForValidation = defs\n    ? ({ ...schema, definitions: defs } as Schema)\n    : (schema as Schema);\n\n  // The jtd lib throws on invalid schemas (e.g., unresolved refs).\n  if (!isValidSchema(schemaForValidation)) {\n    if (schema.ref) {\n      return [`/: unknown ref \"${schema.ref}\"`];\n    }\n    return [`/: invalid schema`];\n  }\n\n  const errors = jtdValidate(schemaForValidation, value, {\n    maxDepth: MAX_VALIDATION_DEPTH,\n    maxErrors: MAX_VALIDATION_ERRORS\n  });\n\n  return errors.map((err) =>\n    formatValidationError(\n      err,\n      schemaForValidation as Record<string, unknown>,\n      value\n    )\n  );\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// SIGNAL-LEVEL VALIDATION (JSON values against JTD formats)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/** Validate a JSON value against a single SignalFormatJson. */\nexport function validateJsonAgainstSignal(\n  format: SignalFormatJson,\n  jsonValue: unknown\n): string[];\n/** Validate a JSON value against a SignalDescriptorJson (valid if value matches ANY JTD format). */\nexport function validateJsonAgainstSignal(\n  descriptor: SignalDescriptorJson,\n  jsonValue: unknown\n): string[];\nexport function validateJsonAgainstSignal(\n  formatOrDescriptor: SignalFormatJson | SignalDescriptorJson,\n  jsonValue: unknown\n): string[] {\n  // Descriptor path \u2014 has `formats` array\n  if (\n    'formats' in formatOrDescriptor &&\n    Array.isArray(formatOrDescriptor.formats)\n  ) {\n    const jtdFormats = (\n      formatOrDescriptor.formats as SignalFormatJson[]\n    ).filter((f) => f.jtdSchema);\n    if (jtdFormats.length === 0) {\n      return ['/: no JTD formats in signal descriptor'];\n    }\n    // Valid if value matches ANY JTD format\n    for (const format of jtdFormats) {\n      const errors = validateJsonAgainstJTD(format.jtdSchema!, jsonValue);\n      if (errors.length === 0) return [];\n    }\n    // None matched \u2014 return errors from last format attempt\n    return validateJsonAgainstJTD(\n      jtdFormats[jtdFormats.length - 1]!.jtdSchema!,\n      jsonValue\n    );\n  }\n\n  // Single format path\n  const format = formatOrDescriptor as SignalFormatJson;\n  if (!format.jtdSchema) {\n    return ['/: signal format has no jtdSchema'];\n  }\n  return validateJsonAgainstJTD(format.jtdSchema, jsonValue);\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// JTD \u2192 JSON SCHEMA CONVERTER\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/**\n * Convert JTD (JSON Type Definition) schema to JSON Schema for validation.\n *\n * Supports all 8 JTD schema forms per RFC 8927:\n * - Empty form: {}\n * - Ref form: { ref: \"...\" }\n * - Type form: { type: \"...\" }\n * - Enum form: { enum: [...] }\n * - Elements form: { elements: {...} }\n * - Properties form: { properties: {...}, optionalProperties: {...} }\n * - Values form: { values: {...} }\n * - Discriminator form: { discriminator: \"...\", mapping: {...} }\n */\nexport function jtdToJsonSchema(\n  jtdSchema: JTDSchemaJson,\n  definitions?: Record<string, JTDSchemaJson>,\n  isRoot = true\n): any {\n  if (!jtdSchema || typeof jtdSchema !== 'object') {\n    return {};\n  }\n\n  const isNullable = jtdSchema['nullable'];\n  const defs =\n    definitions ||\n    (jtdSchema['definitions'] as Record<string, JTDSchemaJson> | undefined);\n\n  const result: any = {};\n\n  if (isRoot) {\n    result.$schema = 'http://json-schema.org/draft-07/schema#';\n  }\n\n  // Ref form\n  if (jtdSchema['ref']) {\n    const refName = jtdSchema['ref'] as string;\n    if (defs && defs[refName]) {\n      const resolvedSchema = jtdToJsonSchema(\n        defs[refName] as JTDSchemaJson,\n        defs,\n        false\n      );\n\n      if (isNullable) {\n        if (resolvedSchema.type) {\n          resolvedSchema.type = Array.isArray(resolvedSchema.type)\n            ? [...resolvedSchema.type, 'null']\n            : [resolvedSchema.type, 'null'];\n        } else {\n          return {\n            ...resolvedSchema,\n            anyOf: [resolvedSchema, { type: 'null' }],\n            ...(isRoot\n              ? { $schema: 'http://json-schema.org/draft-07/schema#' }\n              : {})\n          };\n        }\n      }\n\n      return isRoot\n        ? {\n            ...resolvedSchema,\n            $schema: 'http://json-schema.org/draft-07/schema#'\n          }\n        : resolvedSchema;\n    }\n    return isRoot ? result : {};\n  }\n\n  // Type form\n  if (jtdSchema['type']) {\n    const typeMap: Record<string, string> = {\n      boolean: 'boolean',\n      string: 'string',\n      timestamp: 'string',\n      float32: 'number',\n      float64: 'number',\n      int8: 'integer',\n      uint8: 'integer',\n      int16: 'integer',\n      uint16: 'integer',\n      int32: 'integer',\n      uint32: 'integer'\n    };\n    const jtdType = jtdSchema['type'] as string;\n    const baseType = typeMap[jtdType] || 'string';\n\n    result.type = isNullable ? [baseType, 'null'] : baseType;\n\n    if (baseType === 'string' && jtdType === 'timestamp') {\n      result.format = 'date-time';\n    }\n    return result;\n  }\n\n  // Enum form\n  if (jtdSchema['enum']) {\n    result.type = isNullable ? ['string', 'null'] : 'string';\n    result.enum = isNullable\n      ? [...(jtdSchema['enum'] as string[]), null]\n      : jtdSchema['enum'];\n    return result;\n  }\n\n  // Elements form\n  if (jtdSchema['elements']) {\n    result.type = isNullable ? ['array', 'null'] : 'array';\n    result.items = jtdToJsonSchema(\n      jtdSchema['elements'] as JTDSchemaJson,\n      defs,\n      false\n    );\n    return result;\n  }\n\n  // Properties form\n  if (jtdSchema['properties'] || jtdSchema['optionalProperties']) {\n    result.type = isNullable ? ['object', 'null'] : 'object';\n    result.properties = {};\n    result.required = [];\n\n    if (jtdSchema['properties']) {\n      for (const [key, value] of Object.entries(jtdSchema['properties'])) {\n        result.properties[key] = jtdToJsonSchema(\n          value as JTDSchemaJson,\n          defs,\n          false\n        );\n        result.required.push(key);\n      }\n    }\n\n    if (jtdSchema['optionalProperties']) {\n      for (const [key, value] of Object.entries(\n        jtdSchema['optionalProperties']\n      )) {\n        result.properties[key] = jtdToJsonSchema(\n          value as JTDSchemaJson,\n          defs,\n          false\n        );\n      }\n    }\n\n    // JTD is strict by default\n    if (jtdSchema['additionalProperties'] !== true) {\n      result.additionalProperties = false;\n    }\n\n    return result;\n  }\n\n  // Values form\n  if (jtdSchema['values']) {\n    result.type = isNullable ? ['object', 'null'] : 'object';\n    result.additionalProperties = jtdToJsonSchema(\n      jtdSchema['values'] as JTDSchemaJson,\n      defs,\n      false\n    );\n    return result;\n  }\n\n  // Discriminator form\n  if (jtdSchema['discriminator'] && jtdSchema['mapping']) {\n    const variants = [];\n    const discriminatorKey = jtdSchema['discriminator'] as string;\n\n    for (const [tag, schema] of Object.entries(jtdSchema['mapping'])) {\n      const variantSchema = jtdToJsonSchema(\n        schema as JTDSchemaJson,\n        defs,\n        false\n      );\n\n      if (!variantSchema.type) {\n        variantSchema.type = 'object';\n      } else if (\n        variantSchema.type !== 'object' &&\n        !Array.isArray(variantSchema.type)\n      ) {\n        variantSchema.type = 'object';\n      }\n\n      variantSchema.properties = variantSchema.properties || {};\n      variantSchema.properties[discriminatorKey] = { const: tag };\n\n      variantSchema.required = variantSchema.required || [];\n      if (!variantSchema.required.includes(discriminatorKey)) {\n        variantSchema.required.unshift(discriminatorKey);\n      }\n\n      // JTD discriminator variants are strict by default\n      if (variantSchema.additionalProperties === undefined) {\n        variantSchema.additionalProperties = false;\n      }\n\n      variants.push(variantSchema);\n    }\n\n    if (isNullable) {\n      variants.push({ type: 'null' });\n    }\n\n    result.oneOf = variants;\n    return result;\n  }\n\n  // Empty form\n  return result;\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// JTD SCHEMA VALIDATION (using the `jtd` npm package)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nexport const MAX_VALIDATION_DEPTH = 32;\nexport const MAX_VALIDATION_ERRORS = 100;\n\n/** Validate that the input is a valid JTD schema. */\nexport function validateJTDSchema(\n  schema: unknown\n): { valid: true; schema: JTDSchemaJson } | { valid: false; error: string } {\n  if (!isSchema(schema)) {\n    return {\n      valid: false,\n      error: 'Invalid JTD schema: Schema does not match JTD structure'\n    };\n  }\n\n  if (!isValidSchema(schema)) {\n    return {\n      valid: false,\n      error:\n        'Invalid JTD schema: Schema has semantic errors (e.g., circular references, conflicting forms)'\n    };\n  }\n\n  return { valid: true, schema: schema as unknown as JTDSchemaJson };\n}\n\n/** Parse and validate a JSON string. */\nexport function validateJSON(jsonString: string): {\n  valid: boolean;\n  data?: unknown;\n  error?: string;\n} {\n  try {\n    const data = JSON.parse(jsonString);\n    return { valid: true, data };\n  } catch (error) {\n    return {\n      valid: false,\n      error: `Invalid JSON: ${error instanceof Error ? error.message : 'Parse error'}`\n    };\n  }\n}\n\n/** Parse a JSON string and validate it as a JTD schema. */\nexport function validateJTDSchemaString(\n  schemaString: string\n): { valid: true; schema: JTDSchemaJson } | { valid: false; error: string } {\n  const jsonResult = validateJSON(schemaString);\n  if (!jsonResult.valid) return { valid: false, error: jsonResult.error! };\n\n  return validateJTDSchema(jsonResult.data);\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// MONACO EDITOR CONFIG FOR JTD SCHEMA EDITING\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/** Monaco editor JSON schema configuration for JTD schema IntelliSense and validation. */\nexport const JTD_SCHEMA_CONFIG = {\n  uri: 'https://jsontypedef.com/schemas/jtd-schema.json',\n  fileMatch: ['inmemory://jtd-schema/*.json'],\n  schema: {\n    $schema: 'http://json-schema.org/draft-07/schema#',\n    type: 'object',\n    properties: {\n      type: {\n        description: 'Type form - defines a primitive type',\n        enum: [\n          'boolean',\n          'string',\n          'timestamp',\n          'float32',\n          'float64',\n          'int8',\n          'uint8',\n          'int16',\n          'uint16',\n          'int32',\n          'uint32'\n        ]\n      },\n      enum: {\n        description: 'Enum form - defines a set of string values',\n        type: 'array',\n        items: { type: 'string' }\n      },\n      elements: {\n        description: 'Elements form - defines an array with typed elements',\n        $ref: '#'\n      },\n      properties: {\n        description:\n          'Properties form - defines an object with required properties',\n        type: 'object',\n        additionalProperties: { $ref: '#' }\n      },\n      optionalProperties: {\n        description: 'Optional properties - defines optional object properties',\n        type: 'object',\n        additionalProperties: { $ref: '#' }\n      },\n      values: {\n        description: 'Values form - defines a map/dictionary with typed values',\n        $ref: '#'\n      },\n      discriminator: {\n        description: 'Discriminator form - defines a tagged union',\n        type: 'string'\n      },\n      mapping: {\n        description: 'Mapping for discriminator form',\n        type: 'object',\n        additionalProperties: { $ref: '#' }\n      },\n      ref: {\n        description: 'Ref form - references a definition',\n        type: 'string'\n      },\n      definitions: {\n        description: 'Top-level definitions for reusable schemas',\n        type: 'object',\n        additionalProperties: { $ref: '#' }\n      },\n      nullable: {\n        description: 'Allow null values',\n        type: 'boolean'\n      },\n      metadata: {\n        description: 'Custom metadata for documentation',\n        type: 'object'\n      },\n      additionalProperties: {\n        description: 'Allow additional properties (properties form only)',\n        type: 'boolean'\n      }\n    }\n  }\n};\n", "// Copyright 2024-2025 Mochabug, LLC. All rights reserved.\n// Licensed under the Apache License, Version 2.0.\n\nimport type {\n  JTDSchemaJson,\n  SignalDescriptorJson,\n  SignalFormatJson\n} from '../api';\nimport { validateJsonAgainstJTD } from '../signals';\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Types\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/**\n * JSON Schema subset accepted by the OpenAI structured-output API (strict mode).\n *\n * This is the provider-specific representation produced by {@link OpenAIConversion}.\n * It covers the keywords that OpenAI inspects when constraining model output in\n * strict mode: `type`, `properties`, `required`, `additionalProperties`, `enum`,\n * `format`, `items`, `minimum`/`maximum`, `anyOf`, `$defs`, `$ref`, and\n * `description`.\n */\nexport interface OpenAISchema {\n  type?: string | string[];\n  description?: string;\n  properties?: Record<string, OpenAISchema>;\n  required?: string[];\n  additionalProperties?: false;\n  enum?: (string | number | null)[];\n  format?: string;\n  items?: OpenAISchema;\n  minimum?: number;\n  maximum?: number;\n  anyOf?: OpenAISchema[];\n  $defs?: Record<string, OpenAISchema>;\n  $ref?: string;\n}\n\n/**\n * Successful conversion result for a JTD format.\n *\n * Returned when the raw LLM output has been coerced to match the JTD schema\n * and passes JTD validation. `data` contains the deserialized, coerced, and\n * JTD-validated JSON value.\n */\nexport interface ConvertSuccessJson {\n  success: true;\n  kind: 'json';\n  /** The deserialized, coerced, and JTD-validated JSON value. */\n  data: unknown;\n}\n\n/**\n * Successful conversion result for a MIME (binary) format.\n *\n * Returned when the raw LLM output matches a MIME format. The base64 string\n * produced by the model is decoded into raw binary bytes.\n */\nexport interface ConvertSuccessBinary {\n  success: true;\n  kind: 'binary';\n  /** The concrete MIME type of the binary content (e.g. `\"image/png\"`). */\n  mimeType: string;\n  /** The raw binary data decoded from the base64 string returned by the LLM. */\n  data: Uint8Array;\n  /** Optional filename, provided by the caller if available. */\n  filename?: string;\n}\n\n/**\n * Failed conversion result.\n *\n * `errors` contains one or more human-readable strings describing validation\n * or coercion failures. Each entry uses a JSON Pointer path prefix\n * (e.g. `\"/foo/bar: ...\"`) to locate the problem within the data.\n */\nexport interface ConvertFailure {\n  success: false;\n  /** Array of human-readable error messages with JSON Pointer path prefixes. */\n  errors: string[];\n}\n\n/**\n * Discriminated union of conversion outcomes.\n *\n * Check `success` first, then narrow on `kind` (`'json'` or `'binary'`)\n * for successful results.\n */\nexport type ConvertResult =\n  | ConvertSuccessJson\n  | ConvertSuccessBinary\n  | ConvertFailure;\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Constants\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nconst MAX_REF_DEPTH = 32;\n\nconst UNSTRUCTURED_DESC =\n  'Must be a valid JSON value encoded as a string. ' +\n  \"For objects: '{\\\"key\\\": \\\"value\\\"}', for arrays: '[1, 2]', for primitives: '\\\"hello\\\"' or '42' or 'true' or 'null'.\";\n\nconst UNSTRUCTURED_VARIANT_DESC =\n  'The variant data encoded as a valid JSON string ' +\n  '(e.g. \\'{\"key\": \"value\"}\\').';\n\nconst VALUES_ARRAY_DESC =\n  'Array of key-value entries representing a map/dictionary. ' +\n  \"Each entry has a string 'key' (the property name) and a 'value' (the property value).\";\n\nconst INTEGER_BOUNDS = {\n  int8: { minimum: -128, maximum: 127 },\n  uint8: { minimum: 0, maximum: 255 },\n  int16: { minimum: -32768, maximum: 32767 },\n  uint16: { minimum: 0, maximum: 65535 },\n  int32: { minimum: -2147483648, maximum: 2147483647 },\n  uint32: { minimum: 0, maximum: 4294967295 }\n} satisfies Record<string, { minimum: number; maximum: number }>;\n\nconst FLOAT32_BOUNDS = {\n  minimum: -3.4028235e38,\n  maximum: 3.4028235e38\n} satisfies { minimum: number; maximum: number };\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Helpers\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/** Check if a JTD schema is unstructured (empty form or equivalent). */\nfunction isUnstructuredSchema(schema: JTDSchemaJson): boolean {\n  if (!schema || typeof schema !== 'object') return true;\n\n  if (\n    schema.type ||\n    schema.enum ||\n    schema.elements ||\n    schema.values ||\n    schema.discriminator ||\n    schema.ref\n  ) {\n    return false;\n  }\n\n  const hasRealProps =\n    (schema.properties && Object.keys(schema.properties).length > 0) ||\n    (schema.optionalProperties &&\n      Object.keys(schema.optionalProperties).length > 0);\n\n  if (hasRealProps) return false;\n\n  // Properties form with empty props + additionalProperties: true \u2192 unstructured\n  if (\n    (schema.properties !== undefined ||\n      schema.optionalProperties !== undefined) &&\n    schema.additionalProperties === true\n  ) {\n    return true;\n  }\n\n  // Properties form with empty props, no AP:true \u2192 structured empty object\n  if (\n    schema.properties !== undefined ||\n    schema.optionalProperties !== undefined\n  ) {\n    return false;\n  }\n\n  // Truly empty schema\n  return true;\n}\n\n/** Resolve refs at root to determine if the root target is unstructured. */\nfunction isRootUnstructured(\n  schema: JTDSchemaJson,\n  defs: Record<string, JTDSchemaJson> | undefined\n): boolean {\n  let resolved = schema;\n  let depth = 0;\n  while (resolved.ref && depth < MAX_REF_DEPTH) {\n    const target = defs?.[resolved.ref];\n    if (!target) return false;\n    resolved = target;\n    depth++;\n  }\n  if (depth >= MAX_REF_DEPTH) return false;\n  return isUnstructuredSchema(resolved);\n}\n\n/** Make a schema nullable by adding \"null\" to the type. */\nfunction makeNullable(schema: OpenAISchema): OpenAISchema {\n  if (Array.isArray(schema.type) && schema.type.includes('null')) return schema;\n  if (schema.type === 'null') return schema;\n\n  // $ref \u2192 wrap in anyOf with null\n  if (schema.$ref) {\n    return { anyOf: [schema, { type: 'null' }] };\n  }\n\n  // anyOf \u2192 add null variant\n  if (schema.anyOf) {\n    if (schema.anyOf.some((s) => s.type === 'null')) return schema;\n    return { ...schema, anyOf: [...schema.anyOf, { type: 'null' }] };\n  }\n\n  // Standard: add null to type and enum\n  const result = { ...schema };\n  if (result.type) {\n    result.type = Array.isArray(result.type)\n      ? [...result.type, 'null']\n      : [result.type, 'null'];\n  }\n  if (result.enum && !result.enum.includes(null)) {\n    result.enum = [...result.enum, null];\n  }\n  return result;\n}\n\nfunction nullableType(baseType: string, nullable: boolean): string | string[] {\n  return nullable ? [baseType, 'null'] : baseType;\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Metadata helper\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nconst METADATA_KNOWN_KEYS = new Set(['title', 'label', 'name', 'description']);\n\nfunction applyMetadata(result: OpenAISchema, schema: JTDSchemaJson): void {\n  const meta = schema.metadata as Record<string, unknown> | undefined;\n  if (!meta) return;\n\n  const descParts: string[] = [];\n\n  // OAI doesn't support title \u2014 fold title/label/name into description\n  const titleCandidate =\n    (typeof meta['title'] === 'string' && meta['title'].trim()) ||\n    (typeof meta['label'] === 'string' && meta['label'].trim()) ||\n    (typeof meta['name'] === 'string' && meta['name'].trim());\n\n  const descText =\n    typeof meta['description'] === 'string' ? meta['description'].trim() : '';\n\n  if (titleCandidate && descText) {\n    descParts.push(`${titleCandidate}. ${descText}`);\n  } else if (titleCandidate) {\n    descParts.push(titleCandidate);\n  } else if (descText) {\n    descParts.push(descText);\n  }\n\n  // Extra metadata keys as description hints\n  const extras: string[] = [];\n  for (const [key, value] of Object.entries(meta)) {\n    if (METADATA_KNOWN_KEYS.has(key)) continue;\n    if (typeof value === 'string' && value.trim()) {\n      extras.push(`[${key}: ${value.trim()}]`);\n    } else if (typeof value === 'number' || typeof value === 'boolean') {\n      extras.push(`[${key}: ${value}]`);\n    }\n  }\n  if (extras.length > 0) {\n    descParts.push(extras.join(' '));\n  }\n\n  if (descParts.length > 0) {\n    const newDesc = descParts.join(' ');\n    result.description = result.description\n      ? `${result.description} ${newDesc}`\n      : newDesc;\n  }\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Schema conversion (JTD \u2192 OpenAI JSON Schema)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nfunction convertNode(\n  schema: JTDSchemaJson,\n  defs: Record<string, JTDSchemaJson> | undefined,\n  depth: number\n): OpenAISchema {\n  if (depth > MAX_REF_DEPTH) {\n    throw new Error(`Schema nesting exceeded ${MAX_REF_DEPTH} levels`);\n  }\n\n  if (!schema || typeof schema !== 'object') {\n    return { type: 'string', description: UNSTRUCTURED_DESC };\n  }\n\n  // Unstructured (empty form or AP:true with no real props) \u2192 string\n  if (isUnstructuredSchema(schema)) {\n    const result: OpenAISchema = {\n      type: nullableType('string', schema.nullable === true),\n      description: UNSTRUCTURED_DESC\n    };\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  const isNullable = schema.nullable === true;\n\n  // Ref form \u2192 $ref\n  if (schema.ref) {\n    const refName = schema.ref;\n    if (!defs?.[refName]) {\n      throw new Error(`Unresolved ref \"${refName}\"`);\n    }\n    if (isNullable) {\n      const result: OpenAISchema = {\n        anyOf: [{ $ref: `#/$defs/${refName}` }, { type: 'null' }]\n      };\n      applyMetadata(result, schema);\n      return result;\n    }\n    // Bare $ref \u2014 skip metadata (JSON Schema $ref may ignore sibling keywords)\n    return { $ref: `#/$defs/${refName}` };\n  }\n\n  // Type form\n  if (schema.type) {\n    const result: OpenAISchema = {};\n\n    const intBounds =\n      INTEGER_BOUNDS[schema.type as keyof typeof INTEGER_BOUNDS];\n    if (intBounds) {\n      result.type = nullableType('integer', isNullable);\n      result.minimum = intBounds.minimum;\n      result.maximum = intBounds.maximum;\n    } else\n      switch (schema.type) {\n        case 'boolean':\n          result.type = nullableType('boolean', isNullable);\n          break;\n        case 'string':\n          result.type = nullableType('string', isNullable);\n          break;\n        case 'timestamp':\n          result.type = nullableType('string', isNullable);\n          result.format = 'date-time';\n          break;\n        case 'float32':\n          result.type = nullableType('number', isNullable);\n          result.minimum = FLOAT32_BOUNDS.minimum;\n          result.maximum = FLOAT32_BOUNDS.maximum;\n          break;\n        case 'float64':\n          result.type = nullableType('number', isNullable);\n          break;\n        default:\n          throw new Error(`Unknown JTD type \"${schema.type}\"`);\n      }\n\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  // Enum form\n  if (schema.enum) {\n    const result: OpenAISchema = {\n      type: nullableType('string', isNullable),\n      enum: isNullable ? [...schema.enum, null] : schema.enum\n    };\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  // Elements form\n  if (schema.elements) {\n    const result: OpenAISchema = {\n      type: nullableType('array', isNullable),\n      items: convertNode(schema.elements, defs, depth + 1)\n    };\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  // Properties form (has real props \u2014 unstructured was caught above)\n  if (schema.properties || schema.optionalProperties) {\n    const props: Record<string, OpenAISchema> = {};\n    const required: string[] = [];\n\n    if (schema.properties) {\n      for (const [key, propSchema] of Object.entries(schema.properties)) {\n        props[key] = convertNode(propSchema, defs, depth + 1);\n        required.push(key);\n      }\n    }\n\n    // Optional properties \u2192 required + nullable (null means \"not provided\")\n    if (schema.optionalProperties) {\n      for (const [key, propSchema] of Object.entries(\n        schema.optionalProperties\n      )) {\n        const converted = convertNode(propSchema, defs, depth + 1);\n        const nullable = makeNullable(converted);\n        nullable.description = nullable.description\n          ? `(Optional, null if not provided) ${nullable.description}`\n          : 'Optional. Set to null if not provided.';\n        props[key] = nullable;\n        required.push(key);\n      }\n    }\n\n    const result: OpenAISchema = {\n      type: nullableType('object', isNullable),\n      properties: props,\n      additionalProperties: false,\n      required: required\n    };\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  // Values form \u2192 array of {key, value} objects\n  if (schema.values) {\n    const valueSchema = convertNode(schema.values, defs, depth + 1);\n    const result: OpenAISchema = {\n      type: nullableType('array', isNullable),\n      description: VALUES_ARRAY_DESC,\n      items: {\n        type: 'object',\n        properties: {\n          key: { type: 'string', description: 'The property name.' },\n          value: valueSchema\n        },\n        required: ['key', 'value'],\n        additionalProperties: false\n      }\n    };\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  // Discriminator form \u2192 anyOf with flat variants\n  if (schema.discriminator && schema.mapping) {\n    const discKey = schema.discriminator;\n    const mapping = schema.mapping;\n    const variants: OpenAISchema[] = [];\n\n    for (const [tag, variantSchema] of Object.entries(mapping)) {\n      let variantOAI: OpenAISchema;\n\n      if (isUnstructuredSchema(variantSchema)) {\n        // Unstructured variant: disc + _data string\n        variantOAI = {\n          type: 'object',\n          properties: {\n            [discKey]: { type: 'string', enum: [tag] },\n            _data: {\n              type: 'string',\n              description: UNSTRUCTURED_VARIANT_DESC\n            }\n          },\n          required: [discKey, '_data'],\n          additionalProperties: false\n        };\n      } else {\n        // Per RFC 8927, mapping values are always properties form,\n        // and the discriminator tag never appears in variant properties.\n        variantOAI = convertNode(variantSchema, defs, depth + 1);\n        variantOAI.properties![discKey] = { type: 'string', enum: [tag] };\n        (variantOAI.required ??= []).unshift(discKey);\n        variantOAI.additionalProperties = false;\n      }\n\n      applyMetadata(variantOAI, variantSchema);\n      variants.push(variantOAI);\n    }\n\n    if (isNullable) variants.push({ type: 'null' });\n    const result: OpenAISchema = { anyOf: variants };\n    applyMetadata(result, schema);\n    return result;\n  }\n\n  // Fallback\n  return { type: 'string', description: UNSTRUCTURED_DESC };\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Coercion (OpenAI output \u2192 JTD-conforming JSON)\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nconst INTEGER_TYPE_SET = new Set(Object.keys(INTEGER_BOUNDS));\n\nfunction coerceToJTD(\n  value: unknown,\n  schema: JTDSchemaJson,\n  defs: Record<string, JTDSchemaJson> | undefined,\n  depth: number\n): unknown {\n  if (depth > MAX_REF_DEPTH) return value;\n  if (value === null || value === undefined) return value;\n\n  // Ref form \u2014 resolve in original JTD definitions and recurse\n  if (schema.ref) {\n    const resolved = defs?.[schema.ref];\n    if (resolved) {\n      return coerceToJTD(value, resolved, defs, depth + 1);\n    }\n    return value;\n  }\n\n  // Unstructured schema \u2014 parse JSON string back to value\n  if (isUnstructuredSchema(schema)) {\n    if (typeof value === 'string') {\n      try {\n        return JSON.parse(value);\n      } catch {\n        return value;\n      }\n    }\n    return value;\n  }\n\n  // Type form \u2014 integer coercion\n  if (schema.type && INTEGER_TYPE_SET.has(schema.type)) {\n    if (typeof value === 'number' && !Number.isInteger(value)) {\n      return Math.round(value);\n    }\n    return value;\n  }\n\n  // Elements form\n  if (schema.elements && Array.isArray(value)) {\n    const elemSchema = schema.elements;\n    return value.map((item) => coerceToJTD(item, elemSchema, defs, depth + 1));\n  }\n\n  // Properties form \u2014 strip null optionals\n  if (\n    (schema.properties || schema.optionalProperties) &&\n    typeof value === 'object' &&\n    value !== null\n  ) {\n    const obj = { ...(value as Record<string, unknown>) };\n\n    if (schema.properties) {\n      for (const [k, propSchema] of Object.entries(schema.properties)) {\n        if (k in obj) {\n          obj[k] = coerceToJTD(obj[k], propSchema, defs, depth + 1);\n        }\n      }\n    }\n\n    // Optional properties: null \u2192 omit\n    if (schema.optionalProperties) {\n      for (const [k, propSchema] of Object.entries(schema.optionalProperties)) {\n        if (k in obj) {\n          if (obj[k] === null) {\n            delete obj[k];\n          } else {\n            obj[k] = coerceToJTD(obj[k], propSchema, defs, depth + 1);\n          }\n        }\n      }\n    }\n\n    return obj;\n  }\n\n  // Values form \u2014 convert array of {key, value} to Record\n  if (schema.values && Array.isArray(value)) {\n    const result: Record<string, unknown> = {};\n    for (const entry of value) {\n      if (typeof entry === 'object' && entry !== null) {\n        const rec = entry as Record<string, unknown>;\n        const key = rec.key as string;\n        result[key] = coerceToJTD(rec.value, schema.values, defs, depth + 1);\n      }\n    }\n    return result;\n  }\n\n  // Discriminator form \u2014 flat object, coerce variant + strip null optionals\n  if (\n    schema.discriminator &&\n    schema.mapping &&\n    typeof value === 'object' &&\n    value !== null\n  ) {\n    const rec = value as Record<string, unknown>;\n    const discKey = schema.discriminator;\n    const tag = rec[discKey];\n    if (typeof tag !== 'string') return value;\n    const variantSchema = schema.mapping[tag];\n\n    if (!variantSchema) return value;\n\n    // Unstructured variant: parse _data\n    if (isUnstructuredSchema(variantSchema)) {\n      const dataStr = rec._data;\n      if (typeof dataStr === 'string') {\n        try {\n          const parsed = JSON.parse(dataStr);\n          if (typeof parsed === 'object' && parsed !== null) {\n            return { [discKey]: tag, ...parsed };\n          }\n        } catch {\n          /* validation catches */\n        }\n      }\n      return { [discKey]: tag };\n    }\n\n    // Build flat result: discriminator + variant properties\n    const result: Record<string, unknown> = { [discKey]: tag };\n\n    if (variantSchema.properties) {\n      for (const [k, propSchema] of Object.entries(variantSchema.properties)) {\n        if (k in rec) {\n          result[k] = coerceToJTD(rec[k], propSchema, defs, depth + 1);\n        }\n      }\n    }\n\n    if (variantSchema.optionalProperties) {\n      for (const [k, propSchema] of Object.entries(\n        variantSchema.optionalProperties\n      )) {\n        if (k in rec && rec[k] !== null) {\n          result[k] = coerceToJTD(rec[k], propSchema, defs, depth + 1);\n        }\n      }\n    }\n\n    return result;\n  }\n\n  return value;\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// MIME format helpers\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nfunction convertMimeFormat(mimeType: string): OpenAISchema {\n  return {\n    type: 'string',\n    description: `Base64-encoded binary content (MIME type: ${mimeType}).`\n  };\n}\n\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n// Public API\n// \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n/**\n * Converts JTD schemas or Adapt signal descriptors into OpenAI-compatible\n * JSON Schema (strict mode), and converts raw LLM output back into\n * validated data.\n *\n * ### JTD form mapping\n * - **type** -- mapped to the corresponding JSON Schema `type` (`string`,\n *   `number`, `integer`, `boolean`). Integer sub-types (int8 .. uint32) add\n *   `minimum`/`maximum` bounds. `timestamp` becomes `string` with\n *   `format: \"date-time\"`.\n * - **enum** -- mapped to `type: \"string\"` with an `enum` array.\n * - **elements** -- mapped to `type: \"array\"` with `items`.\n * - **properties / optionalProperties** -- mapped to `type: \"object\"` with\n *   `properties`, `required`, and `additionalProperties: false`. OpenAI\n *   strict mode requires all properties to be present, so **optional\n *   properties are made required and nullable** (their schemas are wrapped\n *   with a `\"null\"` type variant). During {@link convert}, null values for\n *   optional properties are stripped back out.\n * - **values** -- mapped to an array of `{key, value}` objects because\n *   OpenAI strict mode does not support `additionalProperties`. During\n *   {@link convert}, the array is coerced back into a plain `Record`.\n * - **discriminator** -- mapped to `anyOf` with one variant per mapping\n *   entry. Each variant is a flat object containing the discriminator key\n *   (with a single-value `enum`) plus the variant's own properties.\n *\n * ### Unstructured schemas\n * Empty JTD schemas or schemas with only `additionalProperties: true` are\n * considered unstructured. They produce an empty `{}` JSON Schema with\n * `strict: false`, and during {@link convert} the raw string output is\n * parsed via `JSON.parse` back into an arbitrary value.\n *\n * ### MIME formats\n * MIME signal formats become `type: \"string\"` with a description requesting\n * base64-encoded content. On {@link convert}, the base64 string is decoded\n * into a {@link ConvertSuccessBinary} result.\n *\n * ### Serialization\n * `JSON.stringify(conv)` produces a JSON-safe object via {@link toJSON}.\n * Use {@link fromJSON} to restore a fully functional instance from the\n * serialized form (string or parsed object).\n *\n * ```ts\n * const conv = OpenAIConversion.fromJTD(jtdSchema);\n * conv.schema;           // OpenAI JSON Schema to pass to the LLM\n * conv.strict;           // whether strict mode applies\n * conv.convert(output);  // coerce + validate -> ConvertResult\n *\n * // Serialize & restore\n * const cached = JSON.stringify(conv);\n * const restored = OpenAIConversion.fromJSON(cached);\n * ```\n */\nexport class OpenAIConversion {\n  /** The OpenAI-specific JSON Schema to pass to the OpenAI API as the response format. */\n  readonly schema: OpenAISchema;\n  /**\n   * Whether the schema qualifies for OpenAI strict structured-output mode.\n   *\n   * This is `false` when the root JTD schema is empty or unstructured (e.g.\n   * the empty schema `{}` or a properties form with no real properties and\n   * `additionalProperties: true`). In that case `schema` is `{}` and the\n   * model output is unconstrained.\n   */\n  readonly strict: boolean;\n  /**\n   * The original JTD schema used to build this conversion.\n   * Set when created via {@link fromJTD}; `undefined` when created via {@link fromSignal}.\n   */\n  readonly jtdSchema?: JTDSchemaJson;\n  /**\n   * The original signal descriptor used to build this conversion.\n   * Set when created via {@link fromSignal}; `undefined` when created via {@link fromJTD}.\n   */\n  readonly descriptor?: SignalDescriptorJson;\n\n  // \u2500\u2500 Factories \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Build a conversion from a JTD schema.\n   *\n   * Recursively converts every JTD form into the equivalent OpenAI JSON Schema\n   * node. Definitions (`jtdSchema.definitions`) are emitted as `$defs` at the\n   * root level, and references become `$ref` pointers.\n   *\n   * If the root schema is unstructured, the result has an empty `schema` and\n   * `strict: false`.\n   *\n   * @param jtdSchema - A valid JTD schema (RFC 8927).\n   * @returns A new {@link OpenAIConversion} with `jtdSchema` set.\n   * @throws If the schema contains an unknown JTD type, an unresolved `ref`,\n   *         or nesting exceeding 32 levels.\n   */\n  static fromJTD(jtdSchema: JTDSchemaJson): OpenAIConversion {\n    const defs = jtdSchema.definitions;\n    const strict = !isRootUnstructured(jtdSchema, defs);\n\n    let schema: OpenAISchema;\n    if (strict) {\n      schema = convertNode(jtdSchema, defs, 0);\n\n      // Attach $defs at root\n      if (defs && Object.keys(defs).length > 0) {\n        schema.$defs = Object.fromEntries(\n          Object.entries(defs).map(([name, defSchema]) => [\n            name,\n            convertNode(defSchema, defs, 0)\n          ])\n        );\n      }\n    } else {\n      schema = {};\n      applyMetadata(schema, jtdSchema);\n    }\n\n    return new OpenAIConversion(schema, strict, jtdSchema, undefined);\n  }\n\n  /**\n   * Build a conversion from an Adapt signal descriptor.\n   *\n   * If the descriptor has a single format, its schema is used directly\n   * (unwrapped). If it has multiple formats, a wrapper object schema is\n   * produced with `format_0`, `format_1`, ... properties -- each made\n   * required and nullable so the LLM populates exactly one and sets the\n   * rest to `null`.\n   *\n   * @param descriptor - An Adapt signal descriptor with one or more formats.\n   * @returns A new {@link OpenAIConversion} with `descriptor` set.\n   * @throws If the descriptor has no formats, or a format has neither\n   *         `jtdSchema` nor `mimeType`.\n   */\n  static fromSignal(descriptor: SignalDescriptorJson): OpenAIConversion {\n    const { schema, strict } = buildSignalSchema(descriptor);\n    return new OpenAIConversion(schema, strict, undefined, descriptor);\n  }\n\n  /**\n   * Restore an {@link OpenAIConversion} from its serialized form.\n   *\n   * Accepts either the JSON string produced by `JSON.stringify(conv)` or the\n   * already-parsed plain object. The original `jtdSchema` or `descriptor` is\n   * re-processed through the corresponding factory, so the restored instance\n   * is fully functional.\n   *\n   * @param data - A JSON string or parsed object previously produced by {@link toJSON}.\n   * @returns A fully reconstructed {@link OpenAIConversion}.\n   * @throws If the serialized data contains neither `jtdSchema` nor `descriptor`.\n   */\n  static fromJSON(data: string | Record<string, unknown>): OpenAIConversion {\n    const parsed = typeof data === 'string' ? JSON.parse(data) : data;\n    if (parsed.descriptor) {\n      return OpenAIConversion.fromSignal(\n        parsed.descriptor as SignalDescriptorJson\n      );\n    }\n    if (parsed.jtdSchema) {\n      return OpenAIConversion.fromJTD(parsed.jtdSchema as JTDSchemaJson);\n    }\n    throw new Error('Cannot deserialize: missing jtdSchema or descriptor');\n  }\n\n  // \u2500\u2500 Constructor (private) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private constructor(\n    schema: OpenAISchema,\n    strict: boolean,\n    jtdSchema: JTDSchemaJson | undefined,\n    descriptor: SignalDescriptorJson | undefined\n  ) {\n    this.schema = schema;\n    this.strict = strict;\n    this.jtdSchema = jtdSchema;\n    this.descriptor = descriptor;\n  }\n\n  // \u2500\u2500 Convert \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Convert raw LLM output into a validated result.\n   *\n   * For JTD-based conversions, the value is coerced to conform to the original\n   * JTD schema:\n   * - Non-integer numbers are rounded for integer types.\n   * - Null values on optional properties are stripped (OpenAI required+nullable\n   *   encoding is reversed).\n   * - `{key, value}` arrays from the values form are reassembled into Records.\n   * - Unstructured/empty schemas parse the raw JSON string via `JSON.parse`.\n   *\n   * The coerced value is then validated against the JTD schema. Returns\n   * {@link ConvertSuccessJson} on success.\n   *\n   * For MIME-based conversions, the value is expected to be a base64 string\n   * which is decoded into raw bytes. Returns {@link ConvertSuccessBinary}.\n   *\n   * For multi-format signals, the first non-null `format_N` property is\n   * selected and converted individually.\n   *\n   * @param json - The raw value returned by the OpenAI API (typically parsed JSON).\n   * @returns A {@link ConvertResult} indicating success or failure with errors.\n   */\n  convert = (json: unknown): ConvertResult => {\n    if (this.jtdSchema) {\n      return convertJTDOutput(this.jtdSchema, json);\n    }\n    if (this.descriptor) {\n      return convertSignalOutput(this.descriptor, json);\n    }\n    return { success: false, errors: ['No source schema available'] };\n  };\n\n  // \u2500\u2500 Serialization \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Produce a JSON-serializable representation of this conversion.\n   *\n   * The output includes the OpenAI `schema`, `strict` flag, and either the\n   * original `jtdSchema` or `descriptor` (whichever was used to create this\n   * instance), which is sufficient to fully restore the conversion via\n   * {@link fromJSON}.\n   *\n   * Called automatically by `JSON.stringify(conv)`.\n   */\n  toJSON() {\n    if (this.descriptor) {\n      return {\n        schema: this.schema,\n        strict: this.strict,\n        descriptor: this.descriptor\n      };\n    }\n    return {\n      schema: this.schema,\n      strict: this.strict,\n      jtdSchema: this.jtdSchema\n    };\n  }\n}\n\n// \u2500\u2500 Convert helpers (stateless, used by the class) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction convertJTDOutput(\n  jtdSchema: JTDSchemaJson,\n  json: unknown\n): ConvertResult {\n  const defs = jtdSchema.definitions;\n  const coerced = coerceToJTD(json, jtdSchema, defs, 0);\n  const errors = validateJsonAgainstJTD(jtdSchema, coerced, defs);\n  if (errors.length > 0) return { success: false, errors };\n  return { success: true, kind: 'json', data: coerced };\n}\n\nfunction convertMimeOutput(mimeType: string, json: unknown): ConvertResult {\n  if (typeof json !== 'string') {\n    return {\n      success: false,\n      errors: [\n        `/: expected base64 string for MIME type ${mimeType}, got ${typeof json}`\n      ]\n    };\n  }\n  return {\n    success: true,\n    kind: 'binary',\n    mimeType,\n    data: new Uint8Array(Buffer.from(json, 'base64'))\n  };\n}\n\nfunction convertSingleFormatOutput(\n  fmt: SignalFormatJson,\n  json: unknown\n): ConvertResult {\n  if (fmt.mimeType) return convertMimeOutput(fmt.mimeType, json);\n  if (fmt.jtdSchema) return convertJTDOutput(fmt.jtdSchema, json);\n  return {\n    success: false,\n    errors: ['Signal format has neither jtdSchema nor mimeType']\n  };\n}\n\nfunction convertSignalOutput(\n  descriptor: SignalDescriptorJson,\n  json: unknown\n): ConvertResult {\n  const formats = descriptor.formats as SignalFormatJson[] | undefined;\n  if (!formats || formats.length === 0) {\n    return { success: false, errors: ['Signal descriptor has no formats'] };\n  }\n\n  // Single format\n  if (formats.length === 1) {\n    return convertSingleFormatOutput(formats[0], json);\n  }\n\n  // Multi-format\n  if (typeof json !== 'object' || json === null) {\n    return {\n      success: false,\n      errors: [`/: expected object with format properties, got ${typeof json}`]\n    };\n  }\n\n  const rec = json as Record<string, unknown>;\n  for (let i = 0; i < formats.length; i++) {\n    const key = `format_${i}`;\n    if (rec[key] !== undefined && rec[key] !== null) {\n      return convertSingleFormatOutput(formats[i], rec[key]);\n    }\n  }\n\n  if (descriptor.optional) {\n    return { success: true, kind: 'json', data: null };\n  }\n\n  const keys = formats.map((_, i) => `format_${i}`);\n  return {\n    success: false,\n    errors: [\n      `Signal '${descriptor.name ?? 'unnamed'}' is required but no format was provided. Set exactly one of: ${keys.join(', ')}.`\n    ]\n  };\n}\n\n// \u2500\u2500 Signal schema builder \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction buildSignalSchema(descriptor: SignalDescriptorJson): {\n  schema: OpenAISchema;\n  strict: boolean;\n} {\n  const formats = descriptor.formats as SignalFormatJson[] | undefined;\n  if (!formats || formats.length === 0) {\n    throw new Error('Signal descriptor has no formats');\n  }\n\n  if (formats.length === 1) {\n    const [fmt] = formats;\n    const { schema, strict } = buildFormatSchema(fmt);\n    if (descriptor.label || descriptor.description) {\n      const parts: string[] = [];\n      if (descriptor.label) parts.push(descriptor.label);\n      if (descriptor.description) parts.push(descriptor.description);\n      const newDesc = parts.join('. ');\n      schema.description = schema.description\n        ? `${newDesc} ${schema.description}`\n        : newDesc;\n    }\n    return { schema, strict };\n  }\n\n  // Multi-format wrapper \u2014 all format props are required + nullable\n  const wrapperProps: Record<string, OpenAISchema> = {};\n  const required: string[] = [];\n\n  for (const [i, fmt] of formats.entries()) {\n    const { schema: fmtSchema } = buildFormatSchema(fmt);\n    const key = `format_${i}`;\n\n    if (fmt.jtdSchema) {\n      fmtSchema.description = fmtSchema.description\n        ? `Structured JSON data. ${fmtSchema.description}`\n        : 'Structured JSON data.';\n    }\n\n    wrapperProps[key] = makeNullable(fmtSchema);\n    required.push(key);\n  }\n\n  const keys = Object.keys(wrapperProps);\n  const baseDesc = descriptor.description ?? '';\n  const isOptional = descriptor.optional === true;\n  const guidance = isOptional\n    ? 'Provide at most ONE of the following format properties, set all others to null.'\n    : `You MUST provide exactly ONE of the following format properties: ${keys.join(', ')}. Set all others to null.`;\n\n  const schema: OpenAISchema = {\n    type: 'object',\n    description: baseDesc ? `${baseDesc} ${guidance}` : guidance,\n    properties: wrapperProps,\n    required,\n    additionalProperties: false\n  };\n\n  return { schema, strict: true };\n}\n\nfunction buildFormatSchema(fmt: SignalFormatJson): {\n  schema: OpenAISchema;\n  strict: boolean;\n} {\n  if (fmt.jtdSchema) {\n    const defs = fmt.jtdSchema.definitions;\n    const strict = !isRootUnstructured(fmt.jtdSchema, defs);\n\n    let schema: OpenAISchema;\n    if (strict) {\n      schema = convertNode(fmt.jtdSchema, defs, 0);\n\n      if (defs && Object.keys(defs).length > 0) {\n        schema.$defs = Object.fromEntries(\n          Object.entries(defs).map(([name, defSchema]) => [\n            name,\n            convertNode(defSchema, defs, 0)\n          ])\n        );\n      }\n    } else {\n      schema = {};\n      applyMetadata(schema, fmt.jtdSchema);\n    }\n\n    return { schema, strict };\n  }\n  if (fmt.mimeType) {\n    return { schema: convertMimeFormat(fmt.mimeType), strict: true };\n  }\n  throw new Error('Signal format has neither jtdSchema nor mimeType');\n}\n\n// \u2500\u2500 Convenience aliases \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Convenience alias for {@link OpenAIConversion.fromJTD}.\n *\n * @param jtdSchema - A valid JTD schema (RFC 8927).\n * @returns A new {@link OpenAIConversion}.\n */\nexport function convertToOpenAISchema(\n  jtdSchema: JTDSchemaJson\n): OpenAIConversion {\n  return OpenAIConversion.fromJTD(jtdSchema);\n}\n\n/**\n * Convenience alias for {@link OpenAIConversion.fromSignal}.\n *\n * @param descriptor - An Adapt signal descriptor.\n * @returns A new {@link OpenAIConversion}.\n */\nexport function convertSignalToOpenAISchema(\n  descriptor: SignalDescriptorJson\n): OpenAIConversion {\n  return OpenAIConversion.fromSignal(descriptor);\n}\n"],
+  "mappings": "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",
+  "names": ["isSchema", "isValidSchema", "jtdValidate", "INTEGER_TYPES", "formatInstancePath", "instancePath", "p", "resolveSchemaParent", "schema", "schemaPath", "current", "i", "resolveInstanceValue", "value", "key", "formatValidationError", "error", "path", "lastKey", "jtdType", "enumValues", "discValue", "validateJsonAgainstJTD", "definitions", "defs", "schemaForValidation", "isValidSchema", "jtdValidate", "MAX_VALIDATION_DEPTH", "MAX_VALIDATION_ERRORS", "err", "MAX_VALIDATION_DEPTH", "MAX_VALIDATION_ERRORS", "MAX_REF_DEPTH", "UNSTRUCTURED_DESC", "UNSTRUCTURED_VARIANT_DESC", "VALUES_ARRAY_DESC", "INTEGER_BOUNDS", "FLOAT32_BOUNDS", "isUnstructuredSchema", "schema", "isRootUnstructured", "defs", "resolved", "depth", "target", "makeNullable", "s", "result", "nullableType", "baseType", "nullable", "METADATA_KNOWN_KEYS", "applyMetadata", "meta", "descParts", "titleCandidate", "descText", "extras", "key", "value", "newDesc", "convertNode", "isNullable", "refName", "intBounds", "props", "required", "propSchema", "converted", "valueSchema", "discKey", "mapping", "variants", "tag", "variantSchema", "variantOAI", "INTEGER_TYPE_SET", "coerceToJTD", "elemSchema", "item", "obj", "k", "entry", "rec", "dataStr", "parsed", "convertMimeFormat", "mimeType", "OpenAIConversion", "_OpenAIConversion", "jtdSchema", "strict", "name", "defSchema", "descriptor", "buildSignalSchema", "data", "json", "convertJTDOutput", "convertSignalOutput", "coerced", "errors", "validateJsonAgainstJTD", "convertMimeOutput", "convertSingleFormatOutput", "fmt", "formats", "keys", "_", "i", "buildFormatSchema", "parts", "wrapperProps", "fmtSchema", "baseDesc", "guidance", "convertToOpenAISchema", "convertSignalToOpenAISchema"]
 }

package/dist/gemini/index.d.ts

@@ -1,5 +1,13 @@
 import type { JTDSchemaJson, SignalDescriptorJson } from '../api';
-/** JSON Schema subset supported by Gemini 3+ structured output. */
+/**
+ * JSON Schema subset accepted by the Gemini structured-output API.
+ *
+ * This is the provider-specific representation produced by {@link GeminiConversion}.
+ * It covers the keywords that Gemini 3+ actually inspects when constraining
+ * model output: `type`, `properties`, `required`, `enum`, `items`,
+ * `additionalProperties`, `format`, `minimum`/`maximum`, `title`, and
+ * `description`.
+ */
 export interface GeminiSchema {
     type?: string | string[];
     title?: string;
@@ -13,40 +21,199 @@ export interface GeminiSchema {
     minimum?: number;
     maximum?: number;
 }
-export interface ConvertSuccess {
+/**
+ * Successful conversion result for a JTD format.
+ *
+ * Returned when the raw LLM output has been coerced to match the JTD schema
+ * and passes JTD validation. `data` contains the deserialized, coerced, and
+ * JTD-validated JSON value.
+ */
+export interface ConvertSuccessJson {
     success: true;
+    kind: 'json';
+    /** The deserialized, coerced, and JTD-validated JSON value. */
     data: unknown;
 }
+/**
+ * Successful conversion result for a MIME (binary) format.
+ *
+ * Returned when the raw LLM output matches a MIME format. The base64 string
+ * produced by the model is decoded into raw binary bytes.
+ */
+export interface ConvertSuccessBinary {
+    success: true;
+    kind: 'binary';
+    /** The concrete MIME type of the binary content (e.g. `"image/png"`). */
+    mimeType: string;
+    /** The raw binary data decoded from the base64 string returned by the LLM. */
+    data: Uint8Array;
+    /** Optional filename, provided by the caller if available. */
+    filename?: string;
+}
+/**
+ * Failed conversion result.
+ *
+ * `errors` contains one or more human-readable strings describing validation
+ * or coercion failures. Each entry uses a JSON Pointer path prefix
+ * (e.g. `"/foo/bar: ..."`) to locate the problem within the data.
+ */
 export interface ConvertFailure {
     success: false;
+    /** Array of human-readable error messages with JSON Pointer path prefixes. */
     errors: string[];
 }
-export type ConvertResult = ConvertSuccess | ConvertFailure;
-export interface GeminiConversionResult {
-    /** Gemini 3+ compatible JSON Schema for structured output. */
-    schema: GeminiSchema;
-    /** Convert Gemini JSON output back to JTD-conforming JSON. */
-    convert: (geminiJson: unknown) => ConvertResult;
-}
 /**
- * Convert a JTD schema to a Gemini 3+ compatible JSON Schema, with a
- * converter function that transforms and validates Gemini output against
- * the original JTD schema.
+ * Discriminated union of conversion outcomes.
  *
- * @throws {Error} if the JTD schema contains forms that cannot be represented.
+ * Check `success` first, then narrow on `kind` (`'json'` or `'binary'`)
+ * for successful results.
  */
-export declare function convertToGeminiSchema(jtdSchema: JTDSchemaJson): GeminiConversionResult;
+export type ConvertResult = ConvertSuccessJson | ConvertSuccessBinary | ConvertFailure;
 /**
- * Convert a SignalDescriptorJson to a Gemini 3+ compatible JSON Schema.
+ * Converts JTD schemas or Adapt signal descriptors into Gemini-compatible
+ * JSON Schema, and converts raw LLM output back into validated data.
+ *
+ * ### JTD form mapping
+ * - **type** -- mapped to the corresponding JSON Schema `type` (`string`,
+ *   `number`, `integer`, `boolean`). Integer sub-types (int8 .. uint32) add
+ *   `minimum`/`maximum` bounds. `timestamp` becomes `string` with
+ *   `format: "date-time"`.
+ * - **enum** -- mapped to `type: "string"` with an `enum` array.
+ * - **elements** -- mapped to `type: "array"` with `items`.
+ * - **properties / optionalProperties** -- mapped to `type: "object"` with
+ *   `properties`, `required`, and `additionalProperties: false`. Optional
+ *   properties are included but not listed in `required`.
+ * - **values** -- mapped to `type: "object"` with `additionalProperties` set
+ *   to the value schema (Gemini supports free-form object keys natively).
+ * - **discriminator** -- mapped to a wrapper object: a `type: "string"` enum
+ *   property for the discriminator tag, plus one property per variant. The
+ *   LLM is instructed via `description` to populate only the property
+ *   matching the chosen tag. (Gemini does not support `anyOf`.)
+ *
+ * ### MIME formats
+ * MIME signal formats become `type: "string"` with a description requesting
+ * base64-encoded content. On {@link convert}, the base64 string is decoded
+ * into a {@link ConvertSuccessBinary} result.
+ *
+ * ### Serialization
+ * `JSON.stringify(conv)` produces a JSON-safe object via {@link toJSON}.
+ * Use {@link fromJSON} to restore a fully functional instance from the
+ * serialized form (string or parsed object).
  *
- * Handles single and multi-format signals:
- * - Single format: schema is the converted format directly.
- * - Multiple formats: schema is a wrapper object with `format_0`, `format_1`, etc.
- *   as optional properties. The convert function extracts the selected format.
+ * ```ts
+ * const conv = GeminiConversion.fromJTD(jtdSchema);
+ * conv.schema;           // Gemini JSON Schema to pass to the LLM
+ * conv.convert(output);  // coerce + validate -> ConvertResult
  *
- * MIME type formats are mapped to base64 strings.
+ * // Serialize & restore
+ * const cached = JSON.stringify(conv);
+ * const restored = GeminiConversion.fromJSON(cached);
+ * ```
+ */
+export declare class GeminiConversion {
+    /** The Gemini-specific JSON Schema to pass to the Gemini API as the response schema. */
+    readonly schema: GeminiSchema;
+    /**
+     * The original JTD schema used to build this conversion.
+     * Set when created via {@link fromJTD}; `undefined` when created via {@link fromSignal}.
+     */
+    readonly jtdSchema?: JTDSchemaJson;
+    /**
+     * The original signal descriptor used to build this conversion.
+     * Set when created via {@link fromSignal}; `undefined` when created via {@link fromJTD}.
+     */
+    readonly descriptor?: SignalDescriptorJson;
+    /**
+     * Build a conversion from a JTD schema.
+     *
+     * Recursively converts every JTD form into the equivalent Gemini JSON Schema
+     * node. Definitions (`jtdSchema.definitions`) are resolved inline because
+     * Gemini does not support `$ref`.
+     *
+     * @param jtdSchema - A valid JTD schema (RFC 8927).
+     * @returns A new {@link GeminiConversion} with `jtdSchema` set.
+     * @throws If the schema contains an unknown JTD type, an unresolved `ref`,
+     *         or circular / excessively deep refs (exceeding 32 levels).
+     */
+    static fromJTD(jtdSchema: JTDSchemaJson): GeminiConversion;
+    /**
+     * Build a conversion from an Adapt signal descriptor.
+     *
+     * If the descriptor has a single format, its schema is used directly
+     * (unwrapped). If it has multiple formats, a wrapper object schema is
+     * produced with `format_0`, `format_1`, ... properties -- the LLM must
+     * populate exactly one. MIME formats become base64 string schemas.
+     *
+     * @param descriptor - An Adapt signal descriptor with one or more formats.
+     * @returns A new {@link GeminiConversion} with `descriptor` set.
+     * @throws If the descriptor has no formats, or a format has neither
+     *         `jtdSchema` nor `mimeType`.
+     */
+    static fromSignal(descriptor: SignalDescriptorJson): GeminiConversion;
+    /**
+     * Restore a {@link GeminiConversion} from its serialized form.
+     *
+     * Accepts either the JSON string produced by `JSON.stringify(conv)` or the
+     * already-parsed plain object. The original `jtdSchema` or `descriptor` is
+     * re-processed through the corresponding factory, so the restored instance
+     * is fully functional.
+     *
+     * @param data - A JSON string or parsed object previously produced by {@link toJSON}.
+     * @returns A fully reconstructed {@link GeminiConversion}.
+     * @throws If the serialized data contains neither `jtdSchema` nor `descriptor`.
+     */
+    static fromJSON(data: string | Record<string, unknown>): GeminiConversion;
+    private constructor();
+    /**
+     * Convert raw LLM output into a validated result.
+     *
+     * For JTD-based conversions, the value is coerced (e.g. non-integer numbers
+     * are rounded for integer types, discriminator wrapper objects are unwrapped
+     * into flat tagged unions), then validated against the original JTD schema.
+     * Returns {@link ConvertSuccessJson} on success.
+     *
+     * For MIME-based conversions, the value is expected to be a base64 string
+     * which is decoded into raw bytes. Returns {@link ConvertSuccessBinary} on
+     * success.
+     *
+     * For multi-format signals, the first non-null `format_N` property is
+     * selected and converted individually.
+     *
+     * @param json - The raw value returned by the Gemini API (typically parsed JSON).
+     * @returns A {@link ConvertResult} indicating success or failure with errors.
+     */
+    convert: (json: unknown) => ConvertResult;
+    /**
+     * Produce a JSON-serializable representation of this conversion.
+     *
+     * The output includes the Gemini `schema` and either the original
+     * `jtdSchema` or `descriptor` (whichever was used to create this instance),
+     * which is sufficient to fully restore the conversion via {@link fromJSON}.
+     *
+     * Called automatically by `JSON.stringify(conv)`.
+     */
+    toJSON(): {
+        schema: GeminiSchema;
+        descriptor: SignalDescriptorJson;
+        jtdSchema?: undefined;
+    } | {
+        schema: GeminiSchema;
+        jtdSchema: JTDSchemaJson | undefined;
+        descriptor?: undefined;
+    };
+}
+/**
+ * Convenience alias for {@link GeminiConversion.fromJTD}.
+ *
+ * @param jtdSchema - A valid JTD schema (RFC 8927).
+ * @returns A new {@link GeminiConversion}.
+ */
+export declare function convertToGeminiSchema(jtdSchema: JTDSchemaJson): GeminiConversion;
+/**
+ * Convenience alias for {@link GeminiConversion.fromSignal}.
  *
- * @throws {Error} if the descriptor has no formats.
+ * @param descriptor - An Adapt signal descriptor.
+ * @returns A new {@link GeminiConversion}.
  */
-export declare function convertSignalToGeminiSchema(descriptor: SignalDescriptorJson): GeminiConversionResult;
+export declare function convertSignalToGeminiSchema(descriptor: SignalDescriptorJson): GeminiConversion;
 //# sourceMappingURL=index.d.ts.map