@mochabug/adapt-sdk 0.4.1 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (16) hide show
  1. package/dist/anthropic/index.d.ts.map +1 -1
  2. package/dist/cjs/anthropic.cjs +1 -1
  3. package/dist/cjs/anthropic.cjs.map +2 -2
  4. package/dist/cjs/gemini.cjs +1 -1
  5. package/dist/cjs/gemini.cjs.map +2 -2
  6. package/dist/cjs/openai.cjs +1 -1
  7. package/dist/cjs/openai.cjs.map +2 -2
  8. package/dist/esm/anthropic.mjs +1 -1
  9. package/dist/esm/anthropic.mjs.map +2 -2
  10. package/dist/esm/gemini.mjs +1 -1
  11. package/dist/esm/gemini.mjs.map +2 -2
  12. package/dist/esm/openai.mjs +1 -1
  13. package/dist/esm/openai.mjs.map +3 -3
  14. package/dist/gemini/index.d.ts.map +1 -1
  15. package/dist/openai/index.d.ts.map +1 -1
  16. package/package.json +1 -1
package/dist/esm/gemini.mjs.map CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/signals/index.ts", "../../src/gemini/index.ts"],
4
- "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 Gemini structured-output API.\n *\n * This is the provider-specific representation produced by {@link GeminiConversion}.\n * It covers the keywords that Gemini 3+ actually inspects when constraining\n * model output: `type`, `properties`, `required`, `enum`, `items`,\n * `additionalProperties`, `format`, `minimum`/`maximum`, `title`, and\n * `description`.\n */\nexport interface GeminiSchema {\n type?: string | string[];\n title?: string;\n description?: string;\n properties?: Record<string, GeminiSchema>;\n required?: string[];\n additionalProperties?: boolean | GeminiSchema;\n enum?: (string | number | null)[];\n format?: string;\n items?: GeminiSchema;\n minimum?: number;\n maximum?: number;\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 & 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\nconst MAX_REF_DEPTH = 32;\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\nfunction nullableType(base: string, nullable: boolean): string | string[] {\n return nullable ? [base, 'null'] : base;\n}\n\nconst METADATA_KNOWN_KEYS = new Set(['title', 'label', 'name', 'description']);\n\nfunction applyMetadata(result: GeminiSchema, schema: JTDSchemaJson): void {\n const meta = schema.metadata as Record<string, unknown> | undefined;\n if (!meta) return;\n\n if (typeof meta['description'] === 'string' && meta['description'].trim()) {\n result.description = meta['description'].trim();\n }\n\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 if (titleCandidate) result.title = titleCandidate;\n\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 const suffix = extras.join(' ');\n result.description = result.description\n ? `${result.description} ${suffix}`\n : suffix;\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 Gemini 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 resolveRef(\n schema: JTDSchemaJson,\n defs: Record<string, JTDSchemaJson> | undefined,\n depth: number\n): JTDSchemaJson {\n if (depth > MAX_REF_DEPTH) {\n throw new Error(\n `Circular or excessively deep ref chain (exceeded ${MAX_REF_DEPTH} levels)`\n );\n }\n if (!schema.ref) return schema;\n const resolved = defs?.[schema.ref];\n if (!resolved) throw new Error(`Unresolved ref \"${schema.ref}\"`);\n return resolveRef(resolved, defs, depth + 1);\n}\n\nfunction convertNode(\n schema: JTDSchemaJson,\n defs: Record<string, JTDSchemaJson> | undefined,\n depth: number\n): GeminiSchema {\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 { description: 'Any JSON value' };\n }\n\n if (schema.ref) {\n const resolved = resolveRef(schema, defs, depth);\n const result = convertNode(resolved, defs, depth + 1);\n applyMetadata(result, schema);\n if (schema.nullable) {\n const existing = result.type;\n result.type = Array.isArray(existing)\n ? [...existing, 'null']\n : existing\n ? [existing, 'null']\n : ['null'];\n }\n return result;\n }\n\n const isNullable = schema.nullable === true;\n const result: GeminiSchema = {};\n\n if (schema.type) {\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 applyMetadata(result, schema);\n return result;\n }\n\n if (schema.enum) {\n result.type = nullableType('string', isNullable);\n result.enum = isNullable ? [...schema.enum, null] : schema.enum;\n applyMetadata(result, schema);\n return result;\n }\n\n if (schema.elements) {\n result.type = nullableType('array', isNullable);\n result.items = convertNode(schema.elements, defs, depth + 1);\n applyMetadata(result, schema);\n return result;\n }\n\n if (schema.properties || schema.optionalProperties) {\n result.type = nullableType('object', isNullable);\n result.properties = {};\n const required: string[] = [];\n\n if (schema.properties) {\n for (const [key, propSchema] of Object.entries(schema.properties)) {\n result.properties[key] = convertNode(propSchema, defs, depth + 1);\n required.push(key);\n }\n }\n if (schema.optionalProperties) {\n for (const [key, propSchema] of Object.entries(\n schema.optionalProperties\n )) {\n result.properties[key] = convertNode(propSchema, defs, depth + 1);\n }\n }\n if (required.length > 0) result.required = required;\n if (schema.additionalProperties !== true)\n result.additionalProperties = false;\n\n applyMetadata(result, schema);\n return result;\n }\n\n if (schema.values) {\n result.type = nullableType('object', isNullable);\n result.additionalProperties = convertNode(schema.values, defs, depth + 1);\n applyMetadata(result, schema);\n return result;\n }\n\n if (schema.discriminator && schema.mapping) {\n const tags = Object.keys(schema.mapping);\n result.type = nullableType('object', isNullable);\n result.description =\n `Tagged union: set '${schema.discriminator}' to one of [${tags.join(', ')}], ` +\n `then populate ONLY the property whose name matches the chosen '${schema.discriminator}' value. ` +\n `Leave all other variant properties empty.`;\n result.properties = {\n [schema.discriminator]: {\n type: 'string',\n enum: [...tags],\n description: `Selects which variant to use. MUST match exactly one of: ${tags.join(', ')}.`\n }\n };\n result.required = [schema.discriminator];\n result.additionalProperties = false;\n\n for (const [tag, variantSchema] of Object.entries(schema.mapping)) {\n const v = convertNode(variantSchema, defs, depth + 1);\n const guidance = `Populate ONLY when ${schema.discriminator}='${tag}'.`;\n v.description = v.description\n ? `${v.description} \u2014 ${guidance}`\n : guidance;\n result.properties[tag] = v;\n }\n applyMetadata(result, schema);\n return result;\n }\n\n result.description = 'Any JSON value';\n applyMetadata(result, schema);\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// Coercion (Gemini 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 if (schema.ref) {\n const resolved = defs?.[schema.ref];\n if (resolved) return coerceToJTD(value, resolved, defs, depth + 1);\n return value;\n }\n\n if (schema.type && INTEGER_TYPE_SET.has(schema.type)) {\n if (typeof value === 'number' && !Number.isInteger(value))\n return Math.round(value);\n return value;\n }\n\n if (schema.elements && Array.isArray(value)) {\n const el = schema.elements;\n return value.map((item) => coerceToJTD(item, el, defs, depth + 1));\n }\n\n if (\n (schema.properties || schema.optionalProperties) &&\n typeof value === 'object' &&\n value !== null\n ) {\n const obj = { ...(value as Record<string, unknown>) };\n if (schema.properties) {\n for (const [k, s] of Object.entries(schema.properties)) {\n if (k in obj) obj[k] = coerceToJTD(obj[k], s, defs, depth + 1);\n }\n }\n if (schema.optionalProperties) {\n for (const [k, s] of Object.entries(schema.optionalProperties)) {\n if (k in obj) obj[k] = coerceToJTD(obj[k], s, defs, depth + 1);\n }\n }\n return obj;\n }\n\n if (schema.values && typeof value === 'object' && value !== null) {\n const obj: Record<string, unknown> = {};\n for (const [k, v] of Object.entries(value as Record<string, unknown>)) {\n obj[k] = coerceToJTD(v, schema.values, defs, depth + 1);\n }\n return obj;\n }\n\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 tag = rec[schema.discriminator];\n if (typeof tag !== 'string') return value;\n const vs = schema.mapping[tag];\n if (!vs || typeof rec[tag] !== 'object' || rec[tag] === null) return value;\n const coerced = coerceToJTD(\n rec[tag] as Record<string, unknown>,\n vs,\n defs,\n depth + 1\n );\n return {\n [schema.discriminator]: tag,\n ...(coerced as Record<string, unknown>)\n };\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 * Converts JTD schemas or Adapt signal descriptors into Gemini-compatible\n * JSON Schema, and converts raw LLM output back into 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`. Optional\n * properties are included but not listed in `required`.\n * - **values** -- mapped to `type: \"object\"` with `additionalProperties` set\n * to the value schema (Gemini supports free-form object keys natively).\n * - **discriminator** -- mapped to a wrapper object: a `type: \"string\"` enum\n * property for the discriminator tag, plus one property per variant. The\n * LLM is instructed via `description` to populate only the property\n * matching the chosen tag. (Gemini does not support `anyOf`.)\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 = GeminiConversion.fromJTD(jtdSchema);\n * conv.schema; // Gemini JSON Schema to pass to the LLM\n * conv.convert(output); // coerce + validate -> ConvertResult\n *\n * // Serialize & restore\n * const cached = JSON.stringify(conv);\n * const restored = GeminiConversion.fromJSON(cached);\n * ```\n */\nexport class GeminiConversion {\n /** The Gemini-specific JSON Schema to pass to the Gemini API as the response schema. */\n readonly schema: GeminiSchema;\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 Gemini JSON Schema\n * node. Definitions (`jtdSchema.definitions`) are resolved inline because\n * Gemini does not support `$ref`.\n *\n * @param jtdSchema - A valid JTD schema (RFC 8927).\n * @returns A new {@link GeminiConversion} with `jtdSchema` set.\n * @throws If the schema contains an unknown JTD type, an unresolved `ref`,\n * or circular / excessively deep refs (exceeding 32 levels).\n */\n static fromJTD(jtdSchema: JTDSchemaJson): GeminiConversion {\n const schema = convertNode(jtdSchema, jtdSchema.definitions, 0);\n return new GeminiConversion(schema, 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 -- the LLM must\n * populate exactly one. MIME formats become base64 string schemas.\n *\n * @param descriptor - An Adapt signal descriptor with one or more formats.\n * @returns A new {@link GeminiConversion} 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): GeminiConversion {\n const schema = buildSignalSchema(descriptor);\n return new GeminiConversion(schema, undefined, descriptor);\n }\n\n /**\n * Restore a {@link GeminiConversion} 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 GeminiConversion}.\n * @throws If the serialized data contains neither `jtdSchema` nor `descriptor`.\n */\n static fromJSON(data: string | Record<string, unknown>): GeminiConversion {\n const parsed = typeof data === 'string' ? JSON.parse(data) : data;\n if (parsed.descriptor) {\n return GeminiConversion.fromSignal(\n parsed.descriptor as SignalDescriptorJson\n );\n }\n if (parsed.jtdSchema) {\n return GeminiConversion.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: GeminiSchema,\n jtdSchema: JTDSchemaJson | undefined,\n descriptor: SignalDescriptorJson | undefined\n ) {\n this.schema = schema;\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 (e.g. non-integer numbers\n * are rounded for integer types, discriminator wrapper objects are unwrapped\n * into flat tagged unions), then validated against the original JTD schema.\n * Returns {@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} on\n * success.\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 Gemini 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 Gemini `schema` and either the original\n * `jtdSchema` or `descriptor` (whichever was used to create this instance),\n * which is sufficient to fully restore the conversion via {@link fromJSON}.\n *\n * Called automatically by `JSON.stringify(conv)`.\n */\n toJSON() {\n if (this.descriptor) {\n return { schema: this.schema, descriptor: this.descriptor };\n }\n return { schema: this.schema, jtdSchema: this.jtdSchema };\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): GeminiSchema {\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 = buildFormatSchema(fmt);\n if (descriptor.label) schema.title = descriptor.label;\n if (descriptor.description) schema.description = descriptor.description;\n return schema;\n }\n\n const wrapperProps: Record<string, GeminiSchema> = {};\n for (const [i, fmt] of formats.entries()) {\n const fmtSchema = buildFormatSchema(fmt);\n if (fmt.jtdSchema) {\n fmtSchema.description = fmtSchema.description\n ? `Structured JSON data. ${fmtSchema.description}`\n : 'Structured JSON data.';\n }\n wrapperProps[`format_${i}`] = fmtSchema;\n }\n\n const keys = Object.keys(wrapperProps);\n const baseDesc = descriptor.description ?? '';\n const guidance = descriptor.optional\n ? 'Provide at most ONE of the following format properties. All are optional.'\n : `You MUST provide exactly ONE of the following format properties: ${keys.join(', ')}.`;\n\n const schema: GeminiSchema = {\n type: 'object',\n description: baseDesc ? `${baseDesc} ${guidance}` : guidance,\n properties: wrapperProps,\n additionalProperties: false\n };\n if (descriptor.label) schema.title = descriptor.label;\n return schema;\n}\n\nfunction buildFormatSchema(fmt: SignalFormatJson): GeminiSchema {\n if (fmt.jtdSchema)\n return convertNode(fmt.jtdSchema, fmt.jtdSchema.definitions, 0);\n if (fmt.mimeType) return convertMimeFormat(fmt.mimeType);\n throw new Error('Signal format has neither jtdSchema nor mimeType');\n}\n\nfunction convertMimeFormat(mimeType: string): GeminiSchema {\n return {\n type: 'string',\n description: `Base64-encoded binary content (MIME type: ${mimeType}).`\n };\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 GeminiConversion.fromJTD}.\n *\n * @param jtdSchema - A valid JTD schema (RFC 8927).\n * @returns A new {@link GeminiConversion}.\n */\nexport function convertToGeminiSchema(\n jtdSchema: JTDSchemaJson\n): GeminiConversion {\n return GeminiConversion.fromJTD(jtdSchema);\n}\n\n/**\n * Convenience alias for {@link GeminiConversion.fromSignal}.\n *\n * @param descriptor - An Adapt signal descriptor.\n * @returns A new {@link GeminiConversion}.\n */\nexport function convertSignalToGeminiSchema(\n descriptor: SignalDescriptorJson\n): GeminiConversion {\n return GeminiConversion.fromSignal(descriptor);\n}\n"],
5
- "mappings": "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",
4
+ "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 Gemini structured-output API.\n *\n * This is the provider-specific representation produced by {@link GeminiConversion}.\n * It covers the keywords that Gemini 3+ actually inspects when constraining\n * model output: `type`, `properties`, `required`, `enum`, `items`,\n * `additionalProperties`, `format`, `minimum`/`maximum`, `title`, and\n * `description`.\n */\nexport interface GeminiSchema {\n type?: string | string[];\n title?: string;\n description?: string;\n properties?: Record<string, GeminiSchema>;\n required?: string[];\n additionalProperties?: boolean | GeminiSchema;\n enum?: (string | number | null)[];\n format?: string;\n items?: GeminiSchema;\n minimum?: number;\n maximum?: number;\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 & 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\nconst MAX_REF_DEPTH = 32;\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\nfunction nullableType(base: string, nullable: boolean): string | string[] {\n return nullable ? [base, 'null'] : base;\n}\n\nconst METADATA_KNOWN_KEYS = new Set(['title', 'label', 'name', 'description']);\n\nfunction applyMetadata(result: GeminiSchema, schema: JTDSchemaJson): void {\n const meta = schema.metadata as Record<string, unknown> | undefined;\n if (!meta) return;\n\n if (typeof meta['description'] === 'string' && meta['description'].trim()) {\n result.description = meta['description'].trim();\n }\n\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 if (titleCandidate) result.title = titleCandidate;\n\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 const suffix = extras.join(' ');\n result.description = result.description\n ? `${result.description} ${suffix}`\n : suffix;\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 Gemini 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 resolveRef(\n schema: JTDSchemaJson,\n defs: Record<string, JTDSchemaJson> | undefined,\n depth: number\n): JTDSchemaJson {\n if (depth > MAX_REF_DEPTH) {\n throw new Error(\n `Circular or excessively deep ref chain (exceeded ${MAX_REF_DEPTH} levels)`\n );\n }\n if (!schema.ref) return schema;\n const resolved = defs?.[schema.ref];\n if (!resolved) throw new Error(`Unresolved ref \"${schema.ref}\"`);\n return resolveRef(resolved, defs, depth + 1);\n}\n\nfunction convertNode(\n schema: JTDSchemaJson,\n defs: Record<string, JTDSchemaJson> | undefined,\n depth: number\n): GeminiSchema {\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 { description: 'Any JSON value' };\n }\n\n if (schema.ref) {\n const resolved = resolveRef(schema, defs, depth);\n const result = convertNode(resolved, defs, depth + 1);\n applyMetadata(result, schema);\n if (schema.nullable) {\n const existing = result.type;\n result.type = Array.isArray(existing)\n ? [...existing, 'null']\n : existing\n ? [existing, 'null']\n : ['null'];\n }\n return result;\n }\n\n const isNullable = schema.nullable === true;\n const result: GeminiSchema = {};\n\n if (schema.type) {\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 applyMetadata(result, schema);\n return result;\n }\n\n if (schema.enum) {\n result.type = nullableType('string', isNullable);\n result.enum = isNullable ? [...schema.enum, null] : schema.enum;\n applyMetadata(result, schema);\n return result;\n }\n\n if (schema.elements) {\n result.type = nullableType('array', isNullable);\n result.items = convertNode(schema.elements, defs, depth + 1);\n applyMetadata(result, schema);\n return result;\n }\n\n if (schema.properties || schema.optionalProperties) {\n result.type = nullableType('object', isNullable);\n result.properties = {};\n const required: string[] = [];\n\n if (schema.properties) {\n for (const [key, propSchema] of Object.entries(schema.properties)) {\n result.properties[key] = convertNode(propSchema, defs, depth + 1);\n required.push(key);\n }\n }\n if (schema.optionalProperties) {\n for (const [key, propSchema] of Object.entries(\n schema.optionalProperties\n )) {\n result.properties[key] = convertNode(propSchema, defs, depth + 1);\n }\n }\n if (required.length > 0) result.required = required;\n if (schema.additionalProperties !== true)\n result.additionalProperties = false;\n\n applyMetadata(result, schema);\n return result;\n }\n\n if (schema.values) {\n result.type = nullableType('object', isNullable);\n result.additionalProperties = convertNode(schema.values, defs, depth + 1);\n applyMetadata(result, schema);\n return result;\n }\n\n if (schema.discriminator && schema.mapping) {\n const tags = Object.keys(schema.mapping);\n result.type = nullableType('object', isNullable);\n result.description =\n `Tagged union: set '${schema.discriminator}' to one of [${tags.join(', ')}], ` +\n `then populate ONLY the property whose name matches the chosen '${schema.discriminator}' value. ` +\n `Leave all other variant properties empty.`;\n result.properties = {\n [schema.discriminator]: {\n type: 'string',\n enum: [...tags],\n description: `Selects which variant to use. MUST match exactly one of: ${tags.join(', ')}.`\n }\n };\n result.required = [schema.discriminator];\n result.additionalProperties = false;\n\n for (const [tag, variantSchema] of Object.entries(schema.mapping)) {\n const v = convertNode(variantSchema, defs, depth + 1);\n const guidance = `Populate ONLY when ${schema.discriminator}='${tag}'.`;\n v.description = v.description\n ? `${v.description} \u2014 ${guidance}`\n : guidance;\n result.properties[tag] = v;\n }\n applyMetadata(result, schema);\n return result;\n }\n\n result.description = 'Any JSON value';\n applyMetadata(result, schema);\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// Coercion (Gemini 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 if (schema.ref) {\n const resolved = defs?.[schema.ref];\n if (resolved) return coerceToJTD(value, resolved, defs, depth + 1);\n return value;\n }\n\n if (schema.type && INTEGER_TYPE_SET.has(schema.type)) {\n if (typeof value === 'number' && !Number.isInteger(value))\n return Math.round(value);\n return value;\n }\n\n if (schema.elements && Array.isArray(value)) {\n const el = schema.elements;\n return value.map((item) => coerceToJTD(item, el, defs, depth + 1));\n }\n\n if (\n (schema.properties || schema.optionalProperties) &&\n typeof value === 'object' &&\n value !== null\n ) {\n const obj = { ...(value as Record<string, unknown>) };\n if (schema.properties) {\n for (const [k, s] of Object.entries(schema.properties)) {\n if (k in obj) obj[k] = coerceToJTD(obj[k], s, defs, depth + 1);\n }\n }\n if (schema.optionalProperties) {\n for (const [k, s] of Object.entries(schema.optionalProperties)) {\n if (k in obj) obj[k] = coerceToJTD(obj[k], s, defs, depth + 1);\n }\n }\n return obj;\n }\n\n if (schema.values && typeof value === 'object' && value !== null) {\n const obj: Record<string, unknown> = {};\n for (const [k, v] of Object.entries(value as Record<string, unknown>)) {\n obj[k] = coerceToJTD(v, schema.values, defs, depth + 1);\n }\n return obj;\n }\n\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 tag = rec[schema.discriminator];\n if (typeof tag !== 'string') return value;\n const vs = schema.mapping[tag];\n if (!vs || typeof rec[tag] !== 'object' || rec[tag] === null) return value;\n const coerced = coerceToJTD(\n rec[tag] as Record<string, unknown>,\n vs,\n defs,\n depth + 1\n );\n return {\n [schema.discriminator]: tag,\n ...(coerced as Record<string, unknown>)\n };\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 * Converts JTD schemas or Adapt signal descriptors into Gemini-compatible\n * JSON Schema, and converts raw LLM output back into 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`. Optional\n * properties are included but not listed in `required`.\n * - **values** -- mapped to `type: \"object\"` with `additionalProperties` set\n * to the value schema (Gemini supports free-form object keys natively).\n * - **discriminator** -- mapped to a wrapper object: a `type: \"string\"` enum\n * property for the discriminator tag, plus one property per variant. The\n * LLM is instructed via `description` to populate only the property\n * matching the chosen tag. (Gemini does not support `anyOf`.)\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 = GeminiConversion.fromJTD(jtdSchema);\n * conv.schema; // Gemini JSON Schema to pass to the LLM\n * conv.convert(output); // coerce + validate -> ConvertResult\n *\n * // Serialize & restore\n * const cached = JSON.stringify(conv);\n * const restored = GeminiConversion.fromJSON(cached);\n * ```\n */\nexport class GeminiConversion {\n /** The Gemini-specific JSON Schema to pass to the Gemini API as the response schema. */\n readonly schema: GeminiSchema;\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 Gemini JSON Schema\n * node. Definitions (`jtdSchema.definitions`) are resolved inline because\n * Gemini does not support `$ref`.\n *\n * @param jtdSchema - A valid JTD schema (RFC 8927).\n * @returns A new {@link GeminiConversion} with `jtdSchema` set.\n * @throws If the schema contains an unknown JTD type, an unresolved `ref`,\n * or circular / excessively deep refs (exceeding 32 levels).\n */\n static fromJTD(jtdSchema: JTDSchemaJson): GeminiConversion {\n const schema = convertNode(jtdSchema, jtdSchema.definitions, 0);\n return new GeminiConversion(schema, 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 -- the LLM must\n * populate exactly one. MIME formats become base64 string schemas.\n *\n * @param descriptor - An Adapt signal descriptor with one or more formats.\n * @returns A new {@link GeminiConversion} 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): GeminiConversion {\n const schema = buildSignalSchema(descriptor);\n return new GeminiConversion(schema, undefined, descriptor);\n }\n\n /**\n * Restore a {@link GeminiConversion} 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 GeminiConversion}.\n * @throws If the serialized data contains neither `jtdSchema` nor `descriptor`.\n */\n static fromJSON(data: string | Record<string, unknown>): GeminiConversion {\n const parsed = typeof data === 'string' ? JSON.parse(data) : data;\n if (parsed.descriptor) {\n return GeminiConversion.fromSignal(\n parsed.descriptor as SignalDescriptorJson\n );\n }\n if (parsed.jtdSchema) {\n return GeminiConversion.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: GeminiSchema,\n jtdSchema: JTDSchemaJson | undefined,\n descriptor: SignalDescriptorJson | undefined\n ) {\n this.schema = schema;\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 (e.g. non-integer numbers\n * are rounded for integer types, discriminator wrapper objects are unwrapped\n * into flat tagged unions), then validated against the original JTD schema.\n * Returns {@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} on\n * success.\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 Gemini 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 Gemini `schema` and either the original\n * `jtdSchema` or `descriptor` (whichever was used to create this instance),\n * which is sufficient to fully restore the conversion via {@link fromJSON}.\n *\n * Called automatically by `JSON.stringify(conv)`.\n */\n toJSON() {\n if (this.descriptor) {\n return { schema: this.schema, descriptor: this.descriptor };\n }\n return { schema: this.schema, jtdSchema: this.jtdSchema };\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 !== 'object' || json === null) {\n return {\n success: false,\n errors: [\n `/: expected object with 'data' field for MIME type ${mimeType}, got ${typeof json}`\n ]\n };\n }\n const rec = json as Record<string, unknown>;\n if (typeof rec.data !== 'string') {\n return {\n success: false,\n errors: [\n `/data: expected base64 string for MIME type ${mimeType}, got ${typeof rec.data}`\n ]\n };\n }\n const result: ConvertSuccessBinary = {\n success: true,\n kind: 'binary',\n mimeType,\n data: new Uint8Array(Buffer.from(rec.data, 'base64'))\n };\n if (typeof rec.filename === 'string' && rec.filename) {\n result.filename = rec.filename;\n }\n return result;\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): GeminiSchema {\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 = buildFormatSchema(fmt);\n if (descriptor.label) schema.title = descriptor.label;\n if (descriptor.description) schema.description = descriptor.description;\n return schema;\n }\n\n const wrapperProps: Record<string, GeminiSchema> = {};\n for (const [i, fmt] of formats.entries()) {\n const fmtSchema = buildFormatSchema(fmt);\n if (fmt.jtdSchema) {\n fmtSchema.description = fmtSchema.description\n ? `Structured JSON data. ${fmtSchema.description}`\n : 'Structured JSON data.';\n }\n wrapperProps[`format_${i}`] = fmtSchema;\n }\n\n const keys = Object.keys(wrapperProps);\n const baseDesc = descriptor.description ?? '';\n const guidance = descriptor.optional\n ? 'Provide at most ONE of the following format properties. All are optional.'\n : `You MUST provide exactly ONE of the following format properties: ${keys.join(', ')}.`;\n\n const schema: GeminiSchema = {\n type: 'object',\n description: baseDesc ? `${baseDesc} ${guidance}` : guidance,\n properties: wrapperProps,\n additionalProperties: false\n };\n if (descriptor.label) schema.title = descriptor.label;\n return schema;\n}\n\nfunction buildFormatSchema(fmt: SignalFormatJson): GeminiSchema {\n if (fmt.jtdSchema)\n return convertNode(fmt.jtdSchema, fmt.jtdSchema.definitions, 0);\n if (fmt.mimeType) return convertMimeFormat(fmt.mimeType);\n throw new Error('Signal format has neither jtdSchema nor mimeType');\n}\n\nfunction convertMimeFormat(mimeType: string): GeminiSchema {\n return {\n type: 'object',\n description: `Binary content (MIME type: ${mimeType}).`,\n properties: {\n data: {\n type: 'string',\n description: `The base64-encoded binary content (MIME type: ${mimeType}).`\n },\n filename: {\n type: 'string',\n description:\n 'Optional filename for the binary content (e.g. \"report.pdf\", \"image.png\").'\n }\n },\n required: ['data'],\n additionalProperties: false\n };\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 GeminiConversion.fromJTD}.\n *\n * @param jtdSchema - A valid JTD schema (RFC 8927).\n * @returns A new {@link GeminiConversion}.\n */\nexport function convertToGeminiSchema(\n jtdSchema: JTDSchemaJson\n): GeminiConversion {\n return GeminiConversion.fromJTD(jtdSchema);\n}\n\n/**\n * Convenience alias for {@link GeminiConversion.fromSignal}.\n *\n * @param descriptor - An Adapt signal descriptor.\n * @returns A new {@link GeminiConversion}.\n */\nexport function convertSignalToGeminiSchema(\n descriptor: SignalDescriptorJson\n): GeminiConversion {\n return GeminiConversion.fromSignal(descriptor);\n}\n"],
5
+ "mappings": "AAKA,OAAS,YAAAA,EAAU,iBAAAC,EAAe,YAAYC,MAAmB,MAmGjE,IAAMC,EAAgB,IAAI,IAAI,CAC5B,OACA,QACA,QACA,SACA,QACA,QACF,CAAC,EAED,SAASC,EAAmBC,EAAgC,CAC1D,OAAIA,EAAa,SAAW,EAAU,IAC/BA,EACJ,IAAKC,GAAO,QAAQ,KAAKA,CAAC,EAAI,IAAIA,CAAC,IAAM,IAAIA,CAAC,EAAG,EACjD,KAAK,EAAE,CACZ,CAEA,SAASC,EACPC,EACAC,EACyB,CACzB,IAAIC,EAAeF,EACnB,QAASG,EAAI,EAAGA,EAAIF,EAAW,OAAS,IAClCC,GAAW,OAAOA,GAAY,UAAYD,EAAWE,CAAC,IAAMD,GADvBC,IAEvCD,EAAUA,EAAQD,EAAWE,CAAC,CAAE,EAKpC,OAAOD,CACT,CAEA,SAASE,EAAqBC,EAAgBR,EAAiC,CAC7E,IAAIK,EAAUG,EACd,QAAWC,KAAOT,EAChB,GAAIK,GAAW,OAAOA,GAAY,SAChCA,EAAWA,EAAoCI,CAAG,MAElD,QAGJ,OAAOJ,CACT,CAEA,SAASK,EACPC,EACAR,EACAK,EACQ,CACR,GAAM,CAAE,aAAAR,EAAc,WAAAI,CAAW,EAAIO,EAC/BC,EAAOb,EAAmBC,CAAY,EACtCa,EAAUT,EAAWA,EAAW,OAAS,CAAC,EAEhD,GAAIS,IAAY,OAAQ,CAEtB,IAAMC,EADSZ,EAAoBC,EAAQC,CAAU,GAC7B,KACxB,OAAIU,IAAY,UAAkB,GAAGF,CAAI,qBACrCE,IAAY,SAAiB,GAAGF,CAAI,oBACpCE,IAAY,YAAoB,GAAGF,CAAI,8BACvCd,EAAc,IAAIgB,CAAO,EAAU,GAAGF,CAAI,qBACvC,GAAGA,CAAI,mBAChB,CAEA,GAAIC,IAAY,OAAQ,CAEtB,IAAME,EADSb,EAAoBC,EAAQC,CAAU,GAC1B,KAC3B,MAAO,GAAGQ,CAAI,sBAAsBG,EAAW,KAAK,IAAI,CAAC,GAC3D,CAEA,GACEX,EAAW,QAAU,GACrBA,EAAWA,EAAW,OAAS,CAAC,IAAM,cACtCS,EAGA,MAAO,GADQD,IAAS,IAAM,GAAKA,CACnB,IAAIC,CAAO,8BAG7B,GAAIA,IAAY,WAAY,MAAO,GAAGD,CAAI,mBAE1C,GACEC,IAAY,cACZA,IAAY,sBACZA,IAAY,SAEZ,MAAO,GAAGD,CAAI,oBAGhB,GAAIC,IAAY,gBACd,MAAO,GAAGD,CAAI,kCAEhB,GAAIC,IAAY,UAAW,CACzB,IAAMG,EAAYT,EAAqBC,EAAOR,CAAY,EAC1D,MAAO,GAAGY,CAAI,sBAAsBI,CAAS,GAC/C,CAEA,OAAIZ,EAAW,SAAW,EAAU,GAAGQ,CAAI,wBAEpC,GAAGA,CAAI,0BAA0BR,EAAW,KAAK,GAAG,CAAC,EAC9D,CAMO,SAASa,EACdd,EACAK,EACAU,EACU,CACV,IAAMC,EACJD,GACCf,EAAO,YAEJiB,EAAsBD,EACvB,CAAE,GAAGhB,EAAQ,YAAagB,CAAK,EAC/BhB,EAGL,OAAKkB,EAAcD,CAAmB,EAOvBE,EAAYF,EAAqBZ,EAAO,CACrD,SAAUe,EACV,UAAWC,CACb,CAAC,EAEa,IAAKC,GACjBf,EACEe,EACAL,EACAZ,CACF,CACF,EAjBML,EAAO,IACF,CAAC,mBAAmBA,EAAO,GAAG,GAAG,EAEnC,CAAC,mBAAmB,CAe/B,CA+QO,IAAMuB,EAAuB,GACvBC,EAAwB,ICjarC,IAAMC,EAAgB,GAEhBC,EAAiB,CACrB,KAAM,CAAE,QAAS,KAAM,QAAS,GAAI,EACpC,MAAO,CAAE,QAAS,EAAG,QAAS,GAAI,EAClC,MAAO,CAAE,QAAS,OAAQ,QAAS,KAAM,EACzC,OAAQ,CAAE,QAAS,EAAG,QAAS,KAAM,EACrC,MAAO,CAAE,QAAS,YAAa,QAAS,UAAW,EACnD,OAAQ,CAAE,QAAS,EAAG,QAAS,UAAW,CAC5C,EAEMC,EAAiB,CACrB,QAAS,aACT,QAAS,WACX,EAEA,SAASC,EAAaC,EAAcC,EAAsC,CACxE,OAAOA,EAAW,CAACD,EAAM,MAAM,EAAIA,CACrC,CAEA,IAAME,EAAsB,IAAI,IAAI,CAAC,QAAS,QAAS,OAAQ,aAAa,CAAC,EAE7E,SAASC,EAAcC,EAAsBC,EAA6B,CACxE,IAAMC,EAAOD,EAAO,SACpB,GAAI,CAACC,EAAM,OAEP,OAAOA,EAAK,aAAmB,UAAYA,EAAK,YAAe,KAAK,IACtEF,EAAO,YAAcE,EAAK,YAAe,KAAK,GAGhD,IAAMC,EACH,OAAOD,EAAK,OAAa,UAAYA,EAAK,MAAS,KAAK,GACxD,OAAOA,EAAK,OAAa,UAAYA,EAAK,MAAS,KAAK,GACxD,OAAOA,EAAK,MAAY,UAAYA,EAAK,KAAQ,KAAK,EACrDC,IAAgBH,EAAO,MAAQG,GAEnC,IAAMC,EAAmB,CAAC,EAC1B,OAAW,CAACC,EAAKC,CAAK,IAAK,OAAO,QAAQJ,CAAI,EACxCJ,EAAoB,IAAIO,CAAG,IAC3B,OAAOC,GAAU,UAAYA,EAAM,KAAK,EAC1CF,EAAO,KAAK,IAAIC,CAAG,KAAKC,EAAM,KAAK,CAAC,GAAG,GAC9B,OAAOA,GAAU,UAAY,OAAOA,GAAU,YACvDF,EAAO,KAAK,IAAIC,CAAG,KAAKC,CAAK,GAAG,GAGpC,GAAIF,EAAO,OAAS,EAAG,CACrB,IAAMG,EAASH,EAAO,KAAK,GAAG,EAC9BJ,EAAO,YAAcA,EAAO,YACxB,GAAGA,EAAO,WAAW,IAAIO,CAAM,GAC/BA,CACN,CACF,CAMA,SAASC,EACPP,EACAQ,EACAC,EACe,CACf,GAAIA,EAAQlB,EACV,MAAM,IAAI,MACR,oDAAoDA,CAAa,UACnE,EAEF,GAAI,CAACS,EAAO,IAAK,OAAOA,EACxB,IAAMU,EAAWF,IAAOR,EAAO,GAAG,EAClC,GAAI,CAACU,EAAU,MAAM,IAAI,MAAM,mBAAmBV,EAAO,GAAG,GAAG,EAC/D,OAAOO,EAAWG,EAAUF,EAAMC,EAAQ,CAAC,CAC7C,CAEA,SAASE,EACPX,EACAQ,EACAC,EACc,CACd,GAAIA,EAAQlB,EACV,MAAM,IAAI,MAAM,2BAA2BA,CAAa,SAAS,EAGnE,GAAI,CAACS,GAAU,OAAOA,GAAW,SAC/B,MAAO,CAAE,YAAa,gBAAiB,EAGzC,GAAIA,EAAO,IAAK,CACd,IAAMU,EAAWH,EAAWP,EAAQQ,EAAMC,CAAK,EACzCV,EAASY,EAAYD,EAAUF,EAAMC,EAAQ,CAAC,EAEpD,GADAX,EAAcC,EAAQC,CAAM,EACxBA,EAAO,SAAU,CACnB,IAAMY,EAAWb,EAAO,KACxBA,EAAO,KAAO,MAAM,QAAQa,CAAQ,EAChC,CAAC,GAAGA,EAAU,MAAM,EACpBA,EACE,CAACA,EAAU,MAAM,EACjB,CAAC,MAAM,CACf,CACA,OAAOb,CACT,CAEA,IAAMc,EAAab,EAAO,WAAa,GACjCD,EAAuB,CAAC,EAE9B,GAAIC,EAAO,KAAM,CACf,IAAMc,EACJtB,EAAeQ,EAAO,IAAmC,EAC3D,GAAIc,EACFf,EAAO,KAAOL,EAAa,UAAWmB,CAAU,EAChDd,EAAO,QAAUe,EAAU,QAC3Bf,EAAO,QAAUe,EAAU,YAE3B,QAAQd,EAAO,KAAM,CACnB,IAAK,UACHD,EAAO,KAAOL,EAAa,UAAWmB,CAAU,EAChD,MACF,IAAK,SACHd,EAAO,KAAOL,EAAa,SAAUmB,CAAU,EAC/C,MACF,IAAK,YACHd,EAAO,KAAOL,EAAa,SAAUmB,CAAU,EAC/Cd,EAAO,OAAS,YAChB,MACF,IAAK,UACHA,EAAO,KAAOL,EAAa,SAAUmB,CAAU,EAC/Cd,EAAO,QAAUN,EAAe,QAChCM,EAAO,QAAUN,EAAe,QAChC,MACF,IAAK,UACHM,EAAO,KAAOL,EAAa,SAAUmB,CAAU,EAC/C,MACF,QACE,MAAM,IAAI,MAAM,qBAAqBb,EAAO,IAAI,GAAG,CACvD,CACF,OAAAF,EAAcC,EAAQC,CAAM,EACrBD,CACT,CAEA,GAAIC,EAAO,KACT,OAAAD,EAAO,KAAOL,EAAa,SAAUmB,CAAU,EAC/Cd,EAAO,KAAOc,EAAa,CAAC,GAAGb,EAAO,KAAM,IAAI,EAAIA,EAAO,KAC3DF,EAAcC,EAAQC,CAAM,EACrBD,EAGT,GAAIC,EAAO,SACT,OAAAD,EAAO,KAAOL,EAAa,QAASmB,CAAU,EAC9Cd,EAAO,MAAQY,EAAYX,EAAO,SAAUQ,EAAMC,EAAQ,CAAC,EAC3DX,EAAcC,EAAQC,CAAM,EACrBD,EAGT,GAAIC,EAAO,YAAcA,EAAO,mBAAoB,CAClDD,EAAO,KAAOL,EAAa,SAAUmB,CAAU,EAC/Cd,EAAO,WAAa,CAAC,EACrB,IAAMgB,EAAqB,CAAC,EAE5B,GAAIf,EAAO,WACT,OAAW,CAACI,EAAKY,CAAU,IAAK,OAAO,QAAQhB,EAAO,UAAU,EAC9DD,EAAO,WAAWK,CAAG,EAAIO,EAAYK,EAAYR,EAAMC,EAAQ,CAAC,EAChEM,EAAS,KAAKX,CAAG,EAGrB,GAAIJ,EAAO,mBACT,OAAW,CAACI,EAAKY,CAAU,IAAK,OAAO,QACrChB,EAAO,kBACT,EACED,EAAO,WAAWK,CAAG,EAAIO,EAAYK,EAAYR,EAAMC,EAAQ,CAAC,EAGpE,OAAIM,EAAS,OAAS,IAAGhB,EAAO,SAAWgB,GACvCf,EAAO,uBAAyB,KAClCD,EAAO,qBAAuB,IAEhCD,EAAcC,EAAQC,CAAM,EACrBD,CACT,CAEA,GAAIC,EAAO,OACT,OAAAD,EAAO,KAAOL,EAAa,SAAUmB,CAAU,EAC/Cd,EAAO,qBAAuBY,EAAYX,EAAO,OAAQQ,EAAMC,EAAQ,CAAC,EACxEX,EAAcC,EAAQC,CAAM,EACrBD,EAGT,GAAIC,EAAO,eAAiBA,EAAO,QAAS,CAC1C,IAAMiB,EAAO,OAAO,KAAKjB,EAAO,OAAO,EACvCD,EAAO,KAAOL,EAAa,SAAUmB,CAAU,EAC/Cd,EAAO,YACL,sBAAsBC,EAAO,aAAa,gBAAgBiB,EAAK,KAAK,IAAI,CAAC,qEACPjB,EAAO,aAAa,qDAExFD,EAAO,WAAa,CAClB,CAACC,EAAO,aAAa,EAAG,CACtB,KAAM,SACN,KAAM,CAAC,GAAGiB,CAAI,EACd,YAAa,4DAA4DA,EAAK,KAAK,IAAI,CAAC,GAC1F,CACF,EACAlB,EAAO,SAAW,CAACC,EAAO,aAAa,EACvCD,EAAO,qBAAuB,GAE9B,OAAW,CAACmB,EAAKC,CAAa,IAAK,OAAO,QAAQnB,EAAO,OAAO,EAAG,CACjE,IAAMoB,EAAIT,EAAYQ,EAAeX,EAAMC,EAAQ,CAAC,EAC9CY,EAAW,sBAAsBrB,EAAO,aAAa,KAAKkB,CAAG,KACnEE,EAAE,YAAcA,EAAE,YACd,GAAGA,EAAE,WAAW,WAAMC,CAAQ,GAC9BA,EACJtB,EAAO,WAAWmB,CAAG,EAAIE,CAC3B,CACA,OAAAtB,EAAcC,EAAQC,CAAM,EACrBD,CACT,CAEA,OAAAA,EAAO,YAAc,iBACrBD,EAAcC,EAAQC,CAAM,EACrBD,CACT,CAMA,IAAMuB,EAAmB,IAAI,IAAI,OAAO,KAAK9B,CAAc,CAAC,EAE5D,SAAS+B,EACPlB,EACAL,EACAQ,EACAC,EACS,CAET,GADIA,EAAQlB,GACRc,GAAU,KAA6B,OAAOA,EAElD,GAAIL,EAAO,IAAK,CACd,IAAMU,EAAWF,IAAOR,EAAO,GAAG,EAClC,OAAIU,EAAiBa,EAAYlB,EAAOK,EAAUF,EAAMC,EAAQ,CAAC,EAC1DJ,CACT,CAEA,GAAIL,EAAO,MAAQsB,EAAiB,IAAItB,EAAO,IAAI,EACjD,OAAI,OAAOK,GAAU,UAAY,CAAC,OAAO,UAAUA,CAAK,EAC/C,KAAK,MAAMA,CAAK,EAClBA,EAGT,GAAIL,EAAO,UAAY,MAAM,QAAQK,CAAK,EAAG,CAC3C,IAAMmB,EAAKxB,EAAO,SAClB,OAAOK,EAAM,IAAKoB,GAASF,EAAYE,EAAMD,EAAIhB,EAAMC,EAAQ,CAAC,CAAC,CACnE,CAEA,IACGT,EAAO,YAAcA,EAAO,qBAC7B,OAAOK,GAAU,UACjBA,IAAU,KACV,CACA,IAAMqB,EAAM,CAAE,GAAIrB,CAAkC,EACpD,GAAIL,EAAO,WACT,OAAW,CAAC2B,EAAG,CAAC,IAAK,OAAO,QAAQ3B,EAAO,UAAU,EAC/C2B,KAAKD,IAAKA,EAAIC,CAAC,EAAIJ,EAAYG,EAAIC,CAAC,EAAG,EAAGnB,EAAMC,EAAQ,CAAC,GAGjE,GAAIT,EAAO,mBACT,OAAW,CAAC2B,EAAG,CAAC,IAAK,OAAO,QAAQ3B,EAAO,kBAAkB,EACvD2B,KAAKD,IAAKA,EAAIC,CAAC,EAAIJ,EAAYG,EAAIC,CAAC,EAAG,EAAGnB,EAAMC,EAAQ,CAAC,GAGjE,OAAOiB,CACT,CAEA,GAAI1B,EAAO,QAAU,OAAOK,GAAU,UAAYA,IAAU,KAAM,CAChE,IAAMqB,EAA+B,CAAC,EACtC,OAAW,CAACC,EAAGP,CAAC,IAAK,OAAO,QAAQf,CAAgC,EAClEqB,EAAIC,CAAC,EAAIJ,EAAYH,EAAGpB,EAAO,OAAQQ,EAAMC,EAAQ,CAAC,EAExD,OAAOiB,CACT,CAEA,GACE1B,EAAO,eACPA,EAAO,SACP,OAAOK,GAAU,UACjBA,IAAU,KACV,CACA,IAAMuB,EAAMvB,EACNa,EAAMU,EAAI5B,EAAO,aAAa,EACpC,GAAI,OAAOkB,GAAQ,SAAU,OAAOb,EACpC,IAAMwB,EAAK7B,EAAO,QAAQkB,CAAG,EAC7B,GAAI,CAACW,GAAM,OAAOD,EAAIV,CAAG,GAAM,UAAYU,EAAIV,CAAG,IAAM,KAAM,OAAOb,EACrE,IAAMyB,EAAUP,EACdK,EAAIV,CAAG,EACPW,EACArB,EACAC,EAAQ,CACV,EACA,MAAO,CACL,CAACT,EAAO,aAAa,EAAGkB,EACxB,GAAIY,CACN,CACF,CAEA,OAAOzB,CACT,CA+CO,IAAM0B,EAAN,MAAMC,CAAiB,CAEnB,OAKA,UAKA,WAgBT,OAAO,QAAQC,EAA4C,CACzD,IAAMjC,EAASW,EAAYsB,EAAWA,EAAU,YAAa,CAAC,EAC9D,OAAO,IAAID,EAAiBhC,EAAQiC,EAAW,MAAS,CAC1D,CAeA,OAAO,WAAWC,EAAoD,CACpE,IAAMlC,EAASmC,EAAkBD,CAAU,EAC3C,OAAO,IAAIF,EAAiBhC,EAAQ,OAAWkC,CAAU,CAC3D,CAcA,OAAO,SAASE,EAA0D,CACxE,IAAMC,EAAS,OAAOD,GAAS,SAAW,KAAK,MAAMA,CAAI,EAAIA,EAC7D,GAAIC,EAAO,WACT,OAAOL,EAAiB,WACtBK,EAAO,UACT,EAEF,GAAIA,EAAO,UACT,OAAOL,EAAiB,QAAQK,EAAO,SAA0B,EAEnE,MAAM,IAAI,MAAM,qDAAqD,CACvE,CAIQ,YACNrC,EACAiC,EACAC,EACA,CACA,KAAK,OAASlC,EACd,KAAK,UAAYiC,EACjB,KAAK,WAAaC,CACpB,CAsBA,QAAWI,GACL,KAAK,UACAC,EAAiB,KAAK,UAAWD,CAAI,EAE1C,KAAK,WACAE,EAAoB,KAAK,WAAYF,CAAI,EAE3C,CAAE,QAAS,GAAO,OAAQ,CAAC,4BAA4B,CAAE,EAclE,QAAS,CACP,OAAI,KAAK,WACA,CAAE,OAAQ,KAAK,OAAQ,WAAY,KAAK,UAAW,EAErD,CAAE,OAAQ,KAAK,OAAQ,UAAW,KAAK,SAAU,CAC1D,CACF,EAIA,SAASC,EACPN,EACAK,EACe,CACf,IAAM9B,EAAOyB,EAAU,YACjBH,EAAUP,EAAYe,EAAML,EAAWzB,EAAM,CAAC,EAC9CiC,EAASC,EAAuBT,EAAWH,EAAStB,CAAI,EAC9D,OAAIiC,EAAO,OAAS,EAAU,CAAE,QAAS,GAAO,OAAAA,CAAO,EAChD,CAAE,QAAS,GAAM,KAAM,OAAQ,KAAMX,CAAQ,CACtD,CAEA,SAASa,EAAkBC,EAAkBN,EAA8B,CACzE,GAAI,OAAOA,GAAS,UAAYA,IAAS,KACvC,MAAO,CACL,QAAS,GACT,OAAQ,CACN,sDAAsDM,CAAQ,SAAS,OAAON,CAAI,EACpF,CACF,EAEF,IAAMV,EAAMU,EACZ,GAAI,OAAOV,EAAI,MAAS,SACtB,MAAO,CACL,QAAS,GACT,OAAQ,CACN,+CAA+CgB,CAAQ,SAAS,OAAOhB,EAAI,IAAI,EACjF,CACF,EAEF,IAAM7B,EAA+B,CACnC,QAAS,GACT,KAAM,SACN,SAAA6C,EACA,KAAM,IAAI,WAAW,OAAO,KAAKhB,EAAI,KAAM,QAAQ,CAAC,CACtD,EACA,OAAI,OAAOA,EAAI,UAAa,UAAYA,EAAI,WAC1C7B,EAAO,SAAW6B,EAAI,UAEjB7B,CACT,CAEA,SAAS8C,EACPC,EACAR,EACe,CACf,OAAIQ,EAAI,SAAiBH,EAAkBG,EAAI,SAAUR,CAAI,EACzDQ,EAAI,UAAkBP,EAAiBO,EAAI,UAAWR,CAAI,EACvD,CACL,QAAS,GACT,OAAQ,CAAC,kDAAkD,CAC7D,CACF,CAEA,SAASE,EACPN,EACAI,EACe,CACf,IAAMS,EAAUb,EAAW,QAC3B,GAAI,CAACa,GAAWA,EAAQ,SAAW,EACjC,MAAO,CAAE,QAAS,GAAO,OAAQ,CAAC,kCAAkC,CAAE,EAIxE,GAAIA,EAAQ,SAAW,EACrB,OAAOF,EAA0BE,EAAQ,CAAC,EAAGT,CAAI,EAInD,GAAI,OAAOA,GAAS,UAAYA,IAAS,KACvC,MAAO,CACL,QAAS,GACT,OAAQ,CAAC,kDAAkD,OAAOA,CAAI,EAAE,CAC1E,EAGF,IAAMV,EAAMU,EACZ,QAAS,EAAI,EAAG,EAAIS,EAAQ,OAAQ,IAAK,CACvC,IAAM3C,EAAM,UAAU,CAAC,GACvB,GAAIwB,EAAIxB,CAAG,IAAM,QAAawB,EAAIxB,CAAG,IAAM,KACzC,OAAOyC,EAA0BE,EAAQ,CAAC,EAAGnB,EAAIxB,CAAG,CAAC,CAEzD,CAEA,GAAI8B,EAAW,SACb,MAAO,CAAE,QAAS,GAAM,KAAM,OAAQ,KAAM,IAAK,EAGnD,IAAMc,EAAOD,EAAQ,IAAI,CAACE,EAAGC,IAAM,UAAUA,CAAC,EAAE,EAChD,MAAO,CACL,QAAS,GACT,OAAQ,CACN,WAAWhB,EAAW,MAAQ,SAAS,iEAAiEc,EAAK,KAAK,IAAI,CAAC,GACzH,CACF,CACF,CAIA,SAASb,EAAkBD,EAAgD,CACzE,IAAMa,EAAUb,EAAW,QAC3B,GAAI,CAACa,GAAWA,EAAQ,SAAW,EACjC,MAAM,IAAI,MAAM,kCAAkC,EAGpD,GAAIA,EAAQ,SAAW,EAAG,CACxB,GAAM,CAACD,CAAG,EAAIC,EACR/C,EAASmD,EAAkBL,CAAG,EACpC,OAAIZ,EAAW,QAAOlC,EAAO,MAAQkC,EAAW,OAC5CA,EAAW,cAAalC,EAAO,YAAckC,EAAW,aACrDlC,CACT,CAEA,IAAMoD,EAA6C,CAAC,EACpD,OAAW,CAACF,EAAGJ,CAAG,IAAKC,EAAQ,QAAQ,EAAG,CACxC,IAAMM,EAAYF,EAAkBL,CAAG,EACnCA,EAAI,YACNO,EAAU,YAAcA,EAAU,YAC9B,yBAAyBA,EAAU,WAAW,GAC9C,yBAEND,EAAa,UAAUF,CAAC,EAAE,EAAIG,CAChC,CAEA,IAAML,EAAO,OAAO,KAAKI,CAAY,EAC/BE,EAAWpB,EAAW,aAAe,GACrCb,EAAWa,EAAW,SACxB,4EACA,oEAAoEc,EAAK,KAAK,IAAI,CAAC,IAEjFhD,EAAuB,CAC3B,KAAM,SACN,YAAasD,EAAW,GAAGA,CAAQ,IAAIjC,CAAQ,GAAKA,EACpD,WAAY+B,EACZ,qBAAsB,EACxB,EACA,OAAIlB,EAAW,QAAOlC,EAAO,MAAQkC,EAAW,OACzClC,CACT,CAEA,SAASmD,EAAkBL,EAAqC,CAC9D,GAAIA,EAAI,UACN,OAAOnC,EAAYmC,EAAI,UAAWA,EAAI,UAAU,YAAa,CAAC,EAChE,GAAIA,EAAI,SAAU,OAAOS,EAAkBT,EAAI,QAAQ,EACvD,MAAM,IAAI,MAAM,kDAAkD,CACpE,CAEA,SAASS,EAAkBX,EAAgC,CACzD,MAAO,CACL,KAAM,SACN,YAAa,8BAA8BA,CAAQ,KACnD,WAAY,CACV,KAAM,CACJ,KAAM,SACN,YAAa,iDAAiDA,CAAQ,IACxE,EACA,SAAU,CACR,KAAM,SACN,YACE,4EACJ,CACF,EACA,SAAU,CAAC,MAAM,EACjB,qBAAsB,EACxB,CACF,CAUO,SAASY,EACdvB,EACkB,CAClB,OAAOF,EAAiB,QAAQE,CAAS,CAC3C,CAQO,SAASwB,EACdvB,EACkB,CAClB,OAAOH,EAAiB,WAAWG,CAAU,CAC/C",
6
6
  "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", "INTEGER_BOUNDS", "FLOAT32_BOUNDS", "nullableType", "base", "nullable", "METADATA_KNOWN_KEYS", "applyMetadata", "result", "schema", "meta", "titleCandidate", "extras", "key", "value", "suffix", "resolveRef", "defs", "depth", "resolved", "convertNode", "existing", "isNullable", "intBounds", "required", "propSchema", "tags", "tag", "variantSchema", "v", "guidance", "INTEGER_TYPE_SET", "coerceToJTD", "el", "item", "obj", "k", "rec", "vs", "coerced", "GeminiConversion", "_GeminiConversion", "jtdSchema", "descriptor", "buildSignalSchema", "data", "parsed", "json", "convertJTDOutput", "convertSignalOutput", "errors", "validateJsonAgainstJTD", "convertMimeOutput", "mimeType", "convertSingleFormatOutput", "fmt", "formats", "keys", "_", "i", "buildFormatSchema", "wrapperProps", "fmtSchema", "baseDesc", "convertMimeFormat", "convertToGeminiSchema", "convertSignalToGeminiSchema"]
7
7
  }
package/dist/esm/openai.mjs CHANGED
@@ -1,2 +1,2 @@
1
- import{isSchema as H,isValidSchema as I,validate as R}from"jtd";var P=new Set(["int8","uint8","int16","uint16","int32","uint32"]);function E(e){return e.length===0?"/":e.map(t=>/^\d+$/.test(t)?`[${t}]`:`.${t}`).join("")}function T(e,t){let r=e;for(let o=0;o<t.length-1&&(r&&typeof r=="object"&&t[o]in r);o++)r=r[t[o]];return r}function N(e,t){let r=e;for(let o of t)if(r&&typeof r=="object")r=r[o];else return;return r}function C(e,t,r){let{instancePath:o,schemaPath:n}=e,i=E(o),s=n[n.length-1];if(s==="type"){let u=T(t,n)?.type;return u==="boolean"?`${i}: expected boolean`:u==="string"?`${i}: expected string`:u==="timestamp"?`${i}: expected timestamp string`:P.has(u)?`${i}: expected integer`:`${i}: expected number`}if(s==="enum"){let u=T(t,n)?.enum;return`${i}: expected one of [${u.join(", ")}]`}if(n.length>=2&&n[n.length-2]==="properties"&&s)return`${i==="/"?"":i}.${s}: missing required property`;if(s==="elements")return`${i}: expected array`;if(s==="properties"||s==="optionalProperties"||s==="values")return`${i}: expected object`;if(s==="discriminator")return`${i}: expected string discriminator`;if(s==="mapping"){let a=N(r,o);return`${i}: unknown variant "${a}"`}return n.length===0?`${i}: unexpected property`:`${i}: validation error at /${n.join("/")}`}function k(e,t,r){let o=r??e.definitions,n=o?{...e,definitions:o}:e;return I(n)?R(n,t,{maxDepth:F,maxErrors:M}).map(s=>C(s,n,t)):e.ref?[`/: unknown ref "${e.ref}"`]:["/: invalid schema"]}var F=32,M=100;var S=32,h=`Must be a valid JSON value encoded as a string. For objects: '{"key": "value"}', for arrays: '[1, 2]', for primitives: '"hello"' or '42' or 'true' or 'null'.`,_=`The variant data encoded as a valid JSON string (e.g. '{"key": "value"}').`,U="Array of key-value entries representing a map/dictionary. Each entry has a string 'key' (the property name) and a 'value' (the property value).",j={int8:{minimum:-128,maximum:127},uint8:{minimum:0,maximum:255},int16:{minimum:-32768,maximum:32767},uint16:{minimum:0,maximum:65535},int32:{minimum:-2147483648,maximum:2147483647},uint32:{minimum:0,maximum:4294967295}},v={minimum:-34028235e31,maximum:34028235e31};function b(e){return!e||typeof e!="object"?!0:e.type||e.enum||e.elements||e.values||e.discriminator||e.ref||e.properties&&Object.keys(e.properties).length>0||e.optionalProperties&&Object.keys(e.optionalProperties).length>0?!1:(e.properties!==void 0||e.optionalProperties!==void 0)&&e.additionalProperties===!0?!0:!(e.properties!==void 0||e.optionalProperties!==void 0)}function w(e,t){let r=e,o=0;for(;r.ref&&o<S;){let n=t?.[r.ref];if(!n)return!1;r=n,o++}return o>=S?!1:b(r)}function $(e){if(Array.isArray(e.type)&&e.type.includes("null")||e.type==="null")return e;if(e.$ref)return{anyOf:[e,{type:"null"}]};if(e.anyOf)return e.anyOf.some(r=>r.type==="null")?e:{...e,anyOf:[...e.anyOf,{type:"null"}]};let t={...e};return t.type&&(t.type=Array.isArray(t.type)?[...t.type,"null"]:[t.type,"null"]),t.enum&&!t.enum.includes(null)&&(t.enum=[...t.enum,null]),t}function l(e,t){return t?[e,"null"]:e}var q=new Set(["title","label","name","description"]);function f(e,t){let r=t.metadata;if(!r)return;let o=[],n=typeof r.title=="string"&&r.title.trim()||typeof r.label=="string"&&r.label.trim()||typeof r.name=="string"&&r.name.trim(),i=typeof r.description=="string"?r.description.trim():"";n&&i?o.push(`${n}. ${i}`):n?o.push(n):i&&o.push(i);let s=[];for(let[a,u]of Object.entries(r))q.has(a)||(typeof u=="string"&&u.trim()?s.push(`[${a}: ${u.trim()}]`):(typeof u=="number"||typeof u=="boolean")&&s.push(`[${a}: ${u}]`));if(s.length>0&&o.push(s.join(" ")),o.length>0){let a=o.join(" ");e.description=e.description?`${e.description} ${a}`:a}}function m(e,t,r){if(r>S)throw new Error(`Schema nesting exceeded ${S} levels`);if(!e||typeof e!="object")return{type:"string",description:h};if(b(e)){let n={type:l("string",e.nullable===!0),description:h};return f(n,e),n}let o=e.nullable===!0;if(e.ref){let n=e.ref;if(!t?.[n])throw new Error(`Unresolved ref "${n}"`);if(o){let i={anyOf:[{$ref:`#/$defs/${n}`},{type:"null"}]};return f(i,e),i}return{$ref:`#/$defs/${n}`}}if(e.type){let n={},i=j[e.type];if(i)n.type=l("integer",o),n.minimum=i.minimum,n.maximum=i.maximum;else switch(e.type){case"boolean":n.type=l("boolean",o);break;case"string":n.type=l("string",o);break;case"timestamp":n.type=l("string",o),n.format="date-time";break;case"float32":n.type=l("number",o),n.minimum=v.minimum,n.maximum=v.maximum;break;case"float64":n.type=l("number",o);break;default:throw new Error(`Unknown JTD type "${e.type}"`)}return f(n,e),n}if(e.enum){let n={type:l("string",o),enum:o?[...e.enum,null]:e.enum};return f(n,e),n}if(e.elements){let n={type:l("array",o),items:m(e.elements,t,r+1)};return f(n,e),n}if(e.properties||e.optionalProperties){let n={},i=[];if(e.properties)for(let[a,u]of Object.entries(e.properties))n[a]=m(u,t,r+1),i.push(a);if(e.optionalProperties)for(let[a,u]of Object.entries(e.optionalProperties)){let c=m(u,t,r+1),p=$(c);p.description=p.description?`(Optional, null if not provided) ${p.description}`:"Optional. Set to null if not provided.",n[a]=p,i.push(a)}let s={type:l("object",o),properties:n,additionalProperties:!1,required:i};return f(s,e),s}if(e.values){let n=m(e.values,t,r+1),i={type:l("array",o),description:U,items:{type:"object",properties:{key:{type:"string",description:"The property name."},value:n},required:["key","value"],additionalProperties:!1}};return f(i,e),i}if(e.discriminator&&e.mapping){let n=e.discriminator,i=e.mapping,s=[];for(let[u,c]of Object.entries(i)){let p;b(c)?p={type:"object",properties:{[n]:{type:"string",enum:[u]},_data:{type:"string",description:_}},required:[n,"_data"],additionalProperties:!1}:(p=m(c,t,r+1),p.properties[n]={type:"string",enum:[u]},(p.required??=[]).unshift(n),p.additionalProperties=!1),f(p,c),s.push(p)}o&&s.push({type:"null"});let a={anyOf:s};return f(a,e),a}return{type:"string",description:h}}var V=new Set(Object.keys(j));function d(e,t,r,o){if(o>S||e==null)return e;if(t.ref){let n=r?.[t.ref];return n?d(e,n,r,o+1):e}if(b(t)){if(typeof e=="string")try{return JSON.parse(e)}catch{return e}return e}if(t.type&&V.has(t.type))return typeof e=="number"&&!Number.isInteger(e)?Math.round(e):e;if(t.elements&&Array.isArray(e)){let n=t.elements;return e.map(i=>d(i,n,r,o+1))}if((t.properties||t.optionalProperties)&&typeof e=="object"&&e!==null){let n={...e};if(t.properties)for(let[i,s]of Object.entries(t.properties))i in n&&(n[i]=d(n[i],s,r,o+1));if(t.optionalProperties)for(let[i,s]of Object.entries(t.optionalProperties))i in n&&(n[i]===null?delete n[i]:n[i]=d(n[i],s,r,o+1));return n}if(t.values&&Array.isArray(e)){let n={};for(let i of e)if(typeof i=="object"&&i!==null){let s=i,a=s.key;n[a]=d(s.value,t.values,r,o+1)}return n}if(t.discriminator&&t.mapping&&typeof e=="object"&&e!==null){let n=e,i=t.discriminator,s=n[i];if(typeof s!="string")return e;let a=t.mapping[s];if(!a)return e;if(b(a)){let c=n._data;if(typeof c=="string")try{let p=JSON.parse(c);if(typeof p=="object"&&p!==null)return{[i]:s,...p}}catch{}return{[i]:s}}let u={[i]:s};if(a.properties)for(let[c,p]of Object.entries(a.properties))c in n&&(u[c]=d(n[c],p,r,o+1));if(a.optionalProperties)for(let[c,p]of Object.entries(a.optionalProperties))c in n&&n[c]!==null&&(u[c]=d(n[c],p,r,o+1));return u}return e}function B(e){return{type:"string",description:`Base64-encoded binary content (MIME type: ${e}).`}}var J=class e{schema;strict;jtdSchema;descriptor;static fromJTD(t){let r=t.definitions,o=!w(t,r),n;return o?(n=m(t,r,0),r&&Object.keys(r).length>0&&(n.$defs=Object.fromEntries(Object.entries(r).map(([i,s])=>[i,m(s,r,0)])))):(n={},f(n,t)),new e(n,o,t,void 0)}static fromSignal(t){let{schema:r,strict:o}=L(t);return new e(r,o,void 0,t)}static fromJSON(t){let r=typeof t=="string"?JSON.parse(t):t;if(r.descriptor)return e.fromSignal(r.descriptor);if(r.jtdSchema)return e.fromJTD(r.jtdSchema);throw new Error("Cannot deserialize: missing jtdSchema or descriptor")}constructor(t,r,o,n){this.schema=t,this.strict=r,this.jtdSchema=o,this.descriptor=n}convert=t=>this.jtdSchema?x(this.jtdSchema,t):this.descriptor?G(this.descriptor,t):{success:!1,errors:["No source schema available"]};toJSON(){return this.descriptor?{schema:this.schema,strict:this.strict,descriptor:this.descriptor}:{schema:this.schema,strict:this.strict,jtdSchema:this.jtdSchema}}};function x(e,t){let r=e.definitions,o=d(t,e,r,0),n=k(e,o,r);return n.length>0?{success:!1,errors:n}:{success:!0,kind:"json",data:o}}function K(e,t){return typeof t!="string"?{success:!1,errors:[`/: expected base64 string for MIME type ${e}, got ${typeof t}`]}:{success:!0,kind:"binary",mimeType:e,data:new Uint8Array(Buffer.from(t,"base64"))}}function A(e,t){return e.mimeType?K(e.mimeType,t):e.jtdSchema?x(e.jtdSchema,t):{success:!1,errors:["Signal format has neither jtdSchema nor mimeType"]}}function G(e,t){let r=e.formats;if(!r||r.length===0)return{success:!1,errors:["Signal descriptor has no formats"]};if(r.length===1)return A(r[0],t);if(typeof t!="object"||t===null)return{success:!1,errors:[`/: expected object with format properties, got ${typeof t}`]};let o=t;for(let i=0;i<r.length;i++){let s=`format_${i}`;if(o[s]!==void 0&&o[s]!==null)return A(r[i],o[s])}if(e.optional)return{success:!0,kind:"json",data:null};let n=r.map((i,s)=>`format_${s}`);return{success:!1,errors:[`Signal '${e.name??"unnamed"}' is required but no format was provided. Set exactly one of: ${n.join(", ")}.`]}}function L(e){let t=e.formats;if(!t||t.length===0)throw new Error("Signal descriptor has no formats");if(t.length===1){let[c]=t,{schema:p,strict:g}=D(c);if(e.label||e.description){let y=[];e.label&&y.push(e.label),e.description&&y.push(e.description);let O=y.join(". ");p.description=p.description?`${O} ${p.description}`:O}return{schema:p,strict:g}}let r={},o=[];for(let[c,p]of t.entries()){let{schema:g}=D(p),y=`format_${c}`;p.jtdSchema&&(g.description=g.description?`Structured JSON data. ${g.description}`:"Structured JSON data."),r[y]=$(g),o.push(y)}let n=Object.keys(r),i=e.description??"",a=e.optional===!0?"Provide at most ONE of the following format properties, set all others to null.":`You MUST provide exactly ONE of the following format properties: ${n.join(", ")}. Set all others to null.`;return{schema:{type:"object",description:i?`${i} ${a}`:a,properties:r,required:o,additionalProperties:!1},strict:!0}}function D(e){if(e.jtdSchema){let t=e.jtdSchema.definitions,r=!w(e.jtdSchema,t),o;return r?(o=m(e.jtdSchema,t,0),t&&Object.keys(t).length>0&&(o.$defs=Object.fromEntries(Object.entries(t).map(([n,i])=>[n,m(i,t,0)])))):(o={},f(o,e.jtdSchema)),{schema:o,strict:r}}if(e.mimeType)return{schema:B(e.mimeType),strict:!0};throw new Error("Signal format has neither jtdSchema nor mimeType")}function Z(e){return J.fromJTD(e)}function W(e){return J.fromSignal(e)}export{J as OpenAIConversion,W as convertSignalToOpenAISchema,Z as convertToOpenAISchema};
1
+ import{isSchema as H,isValidSchema as x,validate as R}from"jtd";var P=new Set(["int8","uint8","int16","uint16","int32","uint32"]);function E(e){return e.length===0?"/":e.map(t=>/^\d+$/.test(t)?`[${t}]`:`.${t}`).join("")}function T(e,t){let r=e;for(let i=0;i<t.length-1&&(r&&typeof r=="object"&&t[i]in r);i++)r=r[t[i]];return r}function N(e,t){let r=e;for(let i of t)if(r&&typeof r=="object")r=r[i];else return;return r}function C(e,t,r){let{instancePath:i,schemaPath:n}=e,o=E(i),s=n[n.length-1];if(s==="type"){let u=T(t,n)?.type;return u==="boolean"?`${o}: expected boolean`:u==="string"?`${o}: expected string`:u==="timestamp"?`${o}: expected timestamp string`:P.has(u)?`${o}: expected integer`:`${o}: expected number`}if(s==="enum"){let u=T(t,n)?.enum;return`${o}: expected one of [${u.join(", ")}]`}if(n.length>=2&&n[n.length-2]==="properties"&&s)return`${o==="/"?"":o}.${s}: missing required property`;if(s==="elements")return`${o}: expected array`;if(s==="properties"||s==="optionalProperties"||s==="values")return`${o}: expected object`;if(s==="discriminator")return`${o}: expected string discriminator`;if(s==="mapping"){let a=N(r,i);return`${o}: unknown variant "${a}"`}return n.length===0?`${o}: unexpected property`:`${o}: validation error at /${n.join("/")}`}function k(e,t,r){let i=r??e.definitions,n=i?{...e,definitions:i}:e;return x(n)?R(n,t,{maxDepth:M,maxErrors:F}).map(s=>C(s,n,t)):e.ref?[`/: unknown ref "${e.ref}"`]:["/: invalid schema"]}var M=32,F=100;var S=32,h=`Must be a valid JSON value encoded as a string. For objects: '{"key": "value"}', for arrays: '[1, 2]', for primitives: '"hello"' or '42' or 'true' or 'null'.`,_=`The variant data encoded as a valid JSON string (e.g. '{"key": "value"}').`,U="Array of key-value entries representing a map/dictionary. Each entry has a string 'key' (the property name) and a 'value' (the property value).",j={int8:{minimum:-128,maximum:127},uint8:{minimum:0,maximum:255},int16:{minimum:-32768,maximum:32767},uint16:{minimum:0,maximum:65535},int32:{minimum:-2147483648,maximum:2147483647},uint32:{minimum:0,maximum:4294967295}},v={minimum:-34028235e31,maximum:34028235e31};function b(e){return!e||typeof e!="object"?!0:e.type||e.enum||e.elements||e.values||e.discriminator||e.ref||e.properties&&Object.keys(e.properties).length>0||e.optionalProperties&&Object.keys(e.optionalProperties).length>0?!1:(e.properties!==void 0||e.optionalProperties!==void 0)&&e.additionalProperties===!0?!0:!(e.properties!==void 0||e.optionalProperties!==void 0)}function w(e,t){let r=e,i=0;for(;r.ref&&i<S;){let n=t?.[r.ref];if(!n)return!1;r=n,i++}return i>=S?!1:b(r)}function $(e){if(Array.isArray(e.type)&&e.type.includes("null")||e.type==="null")return e;if(e.$ref)return{anyOf:[e,{type:"null"}]};if(e.anyOf)return e.anyOf.some(r=>r.type==="null")?e:{...e,anyOf:[...e.anyOf,{type:"null"}]};let t={...e};return t.type&&(t.type=Array.isArray(t.type)?[...t.type,"null"]:[t.type,"null"]),t.enum&&!t.enum.includes(null)&&(t.enum=[...t.enum,null]),t}function l(e,t){return t?[e,"null"]:e}var q=new Set(["title","label","name","description"]);function f(e,t){let r=t.metadata;if(!r)return;let i=[],n=typeof r.title=="string"&&r.title.trim()||typeof r.label=="string"&&r.label.trim()||typeof r.name=="string"&&r.name.trim(),o=typeof r.description=="string"?r.description.trim():"";n&&o?i.push(`${n}. ${o}`):n?i.push(n):o&&i.push(o);let s=[];for(let[a,u]of Object.entries(r))q.has(a)||(typeof u=="string"&&u.trim()?s.push(`[${a}: ${u.trim()}]`):(typeof u=="number"||typeof u=="boolean")&&s.push(`[${a}: ${u}]`));if(s.length>0&&i.push(s.join(" ")),i.length>0){let a=i.join(" ");e.description=e.description?`${e.description} ${a}`:a}}function m(e,t,r){if(r>S)throw new Error(`Schema nesting exceeded ${S} levels`);if(!e||typeof e!="object")return{type:"string",description:h};if(b(e)){let n={type:l("string",e.nullable===!0),description:h};return f(n,e),n}let i=e.nullable===!0;if(e.ref){let n=e.ref;if(!t?.[n])throw new Error(`Unresolved ref "${n}"`);if(i){let o={anyOf:[{$ref:`#/$defs/${n}`},{type:"null"}]};return f(o,e),o}return{$ref:`#/$defs/${n}`}}if(e.type){let n={},o=j[e.type];if(o)n.type=l("integer",i),n.minimum=o.minimum,n.maximum=o.maximum;else switch(e.type){case"boolean":n.type=l("boolean",i);break;case"string":n.type=l("string",i);break;case"timestamp":n.type=l("string",i),n.format="date-time";break;case"float32":n.type=l("number",i),n.minimum=v.minimum,n.maximum=v.maximum;break;case"float64":n.type=l("number",i);break;default:throw new Error(`Unknown JTD type "${e.type}"`)}return f(n,e),n}if(e.enum){let n={type:l("string",i),enum:i?[...e.enum,null]:e.enum};return f(n,e),n}if(e.elements){let n={type:l("array",i),items:m(e.elements,t,r+1)};return f(n,e),n}if(e.properties||e.optionalProperties){let n={},o=[];if(e.properties)for(let[a,u]of Object.entries(e.properties))n[a]=m(u,t,r+1),o.push(a);if(e.optionalProperties)for(let[a,u]of Object.entries(e.optionalProperties)){let c=m(u,t,r+1),p=$(c);p.description=p.description?`(Optional, null if not provided) ${p.description}`:"Optional. Set to null if not provided.",n[a]=p,o.push(a)}let s={type:l("object",i),properties:n,additionalProperties:!1,required:o};return f(s,e),s}if(e.values){let n=m(e.values,t,r+1),o={type:l("array",i),description:U,items:{type:"object",properties:{key:{type:"string",description:"The property name."},value:n},required:["key","value"],additionalProperties:!1}};return f(o,e),o}if(e.discriminator&&e.mapping){let n=e.discriminator,o=e.mapping,s=[];for(let[u,c]of Object.entries(o)){let p;b(c)?p={type:"object",properties:{[n]:{type:"string",enum:[u]},_data:{type:"string",description:_}},required:[n,"_data"],additionalProperties:!1}:(p=m(c,t,r+1),p.properties[n]={type:"string",enum:[u]},(p.required??=[]).unshift(n),p.additionalProperties=!1),f(p,c),s.push(p)}i&&s.push({type:"null"});let a={anyOf:s};return f(a,e),a}return{type:"string",description:h}}var V=new Set(Object.keys(j));function d(e,t,r,i){if(i>S||e==null)return e;if(t.ref){let n=r?.[t.ref];return n?d(e,n,r,i+1):e}if(b(t)){if(typeof e=="string")try{return JSON.parse(e)}catch{return e}return e}if(t.type&&V.has(t.type))return typeof e=="number"&&!Number.isInteger(e)?Math.round(e):e;if(t.elements&&Array.isArray(e)){let n=t.elements;return e.map(o=>d(o,n,r,i+1))}if((t.properties||t.optionalProperties)&&typeof e=="object"&&e!==null){let n={...e};if(t.properties)for(let[o,s]of Object.entries(t.properties))o in n&&(n[o]=d(n[o],s,r,i+1));if(t.optionalProperties)for(let[o,s]of Object.entries(t.optionalProperties))o in n&&(n[o]===null?delete n[o]:n[o]=d(n[o],s,r,i+1));return n}if(t.values&&Array.isArray(e)){let n={};for(let o of e)if(typeof o=="object"&&o!==null){let s=o,a=s.key;n[a]=d(s.value,t.values,r,i+1)}return n}if(t.discriminator&&t.mapping&&typeof e=="object"&&e!==null){let n=e,o=t.discriminator,s=n[o];if(typeof s!="string")return e;let a=t.mapping[s];if(!a)return e;if(b(a)){let c=n._data;if(typeof c=="string")try{let p=JSON.parse(c);if(typeof p=="object"&&p!==null)return{[o]:s,...p}}catch{}return{[o]:s}}let u={[o]:s};if(a.properties)for(let[c,p]of Object.entries(a.properties))c in n&&(u[c]=d(n[c],p,r,i+1));if(a.optionalProperties)for(let[c,p]of Object.entries(a.optionalProperties))c in n&&n[c]!==null&&(u[c]=d(n[c],p,r,i+1));return u}return e}function B(e){return{type:"object",description:`Binary content (MIME type: ${e}).`,properties:{data:{type:"string",description:`The base64-encoded binary content (MIME type: ${e}).`},filename:{type:["string","null"],description:'Optional filename for the binary content (e.g. "report.pdf"). Set to null if not applicable.'}},required:["data","filename"],additionalProperties:!1}}var J=class e{schema;strict;jtdSchema;descriptor;static fromJTD(t){let r=t.definitions,i=!w(t,r),n;return i?(n=m(t,r,0),r&&Object.keys(r).length>0&&(n.$defs=Object.fromEntries(Object.entries(r).map(([o,s])=>[o,m(s,r,0)])))):(n={},f(n,t)),new e(n,i,t,void 0)}static fromSignal(t){let{schema:r,strict:i}=L(t);return new e(r,i,void 0,t)}static fromJSON(t){let r=typeof t=="string"?JSON.parse(t):t;if(r.descriptor)return e.fromSignal(r.descriptor);if(r.jtdSchema)return e.fromJTD(r.jtdSchema);throw new Error("Cannot deserialize: missing jtdSchema or descriptor")}constructor(t,r,i,n){this.schema=t,this.strict=r,this.jtdSchema=i,this.descriptor=n}convert=t=>this.jtdSchema?I(this.jtdSchema,t):this.descriptor?G(this.descriptor,t):{success:!1,errors:["No source schema available"]};toJSON(){return this.descriptor?{schema:this.schema,strict:this.strict,descriptor:this.descriptor}:{schema:this.schema,strict:this.strict,jtdSchema:this.jtdSchema}}};function I(e,t){let r=e.definitions,i=d(t,e,r,0),n=k(e,i,r);return n.length>0?{success:!1,errors:n}:{success:!0,kind:"json",data:i}}function K(e,t){if(typeof t!="object"||t===null)return{success:!1,errors:[`/: expected object with 'data' field for MIME type ${e}, got ${typeof t}`]};let r=t;if(typeof r.data!="string")return{success:!1,errors:[`/data: expected base64 string for MIME type ${e}, got ${typeof r.data}`]};let i={success:!0,kind:"binary",mimeType:e,data:new Uint8Array(Buffer.from(r.data,"base64"))};return typeof r.filename=="string"&&r.filename&&(i.filename=r.filename),i}function A(e,t){return e.mimeType?K(e.mimeType,t):e.jtdSchema?I(e.jtdSchema,t):{success:!1,errors:["Signal format has neither jtdSchema nor mimeType"]}}function G(e,t){let r=e.formats;if(!r||r.length===0)return{success:!1,errors:["Signal descriptor has no formats"]};if(r.length===1)return A(r[0],t);if(typeof t!="object"||t===null)return{success:!1,errors:[`/: expected object with format properties, got ${typeof t}`]};let i=t;for(let o=0;o<r.length;o++){let s=`format_${o}`;if(i[s]!==void 0&&i[s]!==null)return A(r[o],i[s])}if(e.optional)return{success:!0,kind:"json",data:null};let n=r.map((o,s)=>`format_${s}`);return{success:!1,errors:[`Signal '${e.name??"unnamed"}' is required but no format was provided. Set exactly one of: ${n.join(", ")}.`]}}function L(e){let t=e.formats;if(!t||t.length===0)throw new Error("Signal descriptor has no formats");if(t.length===1){let[c]=t,{schema:p,strict:g}=D(c);if(e.label||e.description){let y=[];e.label&&y.push(e.label),e.description&&y.push(e.description);let O=y.join(". ");p.description=p.description?`${O} ${p.description}`:O}return{schema:p,strict:g}}let r={},i=[];for(let[c,p]of t.entries()){let{schema:g}=D(p),y=`format_${c}`;p.jtdSchema&&(g.description=g.description?`Structured JSON data. ${g.description}`:"Structured JSON data."),r[y]=$(g),i.push(y)}let n=Object.keys(r),o=e.description??"",a=e.optional===!0?"Provide at most ONE of the following format properties, set all others to null.":`You MUST provide exactly ONE of the following format properties: ${n.join(", ")}. Set all others to null.`;return{schema:{type:"object",description:o?`${o} ${a}`:a,properties:r,required:i,additionalProperties:!1},strict:!0}}function D(e){if(e.jtdSchema){let t=e.jtdSchema.definitions,r=!w(e.jtdSchema,t),i;return r?(i=m(e.jtdSchema,t,0),t&&Object.keys(t).length>0&&(i.$defs=Object.fromEntries(Object.entries(t).map(([n,o])=>[n,m(o,t,0)])))):(i={},f(i,e.jtdSchema)),{schema:i,strict:r}}if(e.mimeType)return{schema:B(e.mimeType),strict:!0};throw new Error("Signal format has neither jtdSchema nor mimeType")}function Z(e){return J.fromJTD(e)}function W(e){return J.fromSignal(e)}export{J as OpenAIConversion,W as convertSignalToOpenAISchema,Z as convertToOpenAISchema};
2
2
  //# sourceMappingURL=openai.mjs.map