@gajae-code/ai 0.1.1

package/src/utils/schema/fields.ts

@@ -0,0 +1,190 @@
+/**
+ * Field classification sets for JSON Schema sanitization across providers.
+ *
+ * Each set serves a different provider need. They overlap intentionally —
+ * co-locating them makes the overlap visible and maintainable.
+ *
+ * All keysets here are static and small (≤ ~40 entries) so they live as
+ * `Record<string, true>` literals — `k in REC` resolves through hidden
+ * class inline caches without the per-call hashtable cost of `Set.has`.
+ */
+
+/**
+ * Google Generative AI unsupported schema fields.
+ * Stripped during normalizeSchemaForGoogle / normalizeSchemaForCCA.
+ */
+export const UNSUPPORTED_SCHEMA_FIELDS: Record<string, true> = {
+	$schema: true,
+	$ref: true,
+	$defs: true,
+	$dynamicRef: true,
+	$dynamicAnchor: true,
+	examples: true,
+	prefixItems: true,
+	unevaluatedProperties: true,
+	unevaluatedItems: true,
+	patternProperties: true,
+	additionalProperties: true,
+	propertyNames: true,
+	minItems: true,
+	maxItems: true,
+	minLength: true,
+	maxLength: true,
+	minimum: true,
+	maximum: true,
+	exclusiveMinimum: true,
+	exclusiveMaximum: true,
+	pattern: true,
+	format: true,
+};
+
+/**
+ * Human-meaningful validation/decorative keywords that can be preserved in a
+ * sibling description when a provider-specific normalizer strips them from the
+ * wire schema.
+ */
+export const LIFTABLE_TO_DESCRIPTION_FIELDS: Record<string, true> = {
+	pattern: true,
+	format: true,
+	minLength: true,
+	maxLength: true,
+	minimum: true,
+	maximum: true,
+	exclusiveMinimum: true,
+	exclusiveMaximum: true,
+	multipleOf: true,
+	minItems: true,
+	maxItems: true,
+	uniqueItems: true,
+	minProperties: true,
+	maxProperties: true,
+	default: true,
+	examples: true,
+};
+
+/**
+ * Non-structural schema keys stripped during OpenAI strict mode sanitization.
+ * These are decorative/validation-only keywords that don't affect the structural
+ * shape OpenAI's strict mode enforces.
+ */
+export const NON_STRUCTURAL_SCHEMA_KEYS: Record<string, true> = {
+	format: true,
+	pattern: true,
+	minLength: true,
+	maxLength: true,
+	minimum: true,
+	maximum: true,
+	exclusiveMinimum: true,
+	exclusiveMaximum: true,
+	minItems: true,
+	maxItems: true,
+	uniqueItems: true,
+	multipleOf: true,
+	$schema: true,
+	examples: true,
+	default: true,
+	title: true,
+	$comment: true,
+	if: true,
+	// biome-ignore lint/suspicious/noThenProperty: JSON Schema keyword
+	then: true,
+	else: true,
+	not: true,
+	unevaluatedProperties: true,
+	unevaluatedItems: true,
+	patternProperties: true,
+	propertyNames: true,
+	contains: true,
+	minContains: true,
+	maxContains: true,
+	dependentRequired: true,
+	dependentSchemas: true,
+	contentEncoding: true,
+	contentMediaType: true,
+	contentSchema: true,
+	deprecated: true,
+	readOnly: true,
+	writeOnly: true,
+	minProperties: true,
+	maxProperties: true,
+	$dynamicRef: true,
+	$dynamicAnchor: true,
+};
+
+/**
+ * Cloud Code Assist type-specific allowed keys per JSON Schema type.
+ * Used when collapsing mixed-type combiner variants for CCA Anthropic model.
+ */
+export const CLOUD_CODE_ASSIST_TYPE_SPECIFIC_KEYS: Record<string, Record<string, true>> = {
+	array: {
+		items: true,
+		prefixItems: true,
+		contains: true,
+		minContains: true,
+		maxContains: true,
+		minItems: true,
+		maxItems: true,
+		uniqueItems: true,
+		unevaluatedItems: true,
+	},
+	object: {
+		properties: true,
+		required: true,
+		additionalProperties: true,
+		patternProperties: true,
+		propertyNames: true,
+		minProperties: true,
+		maxProperties: true,
+		dependentRequired: true,
+		dependentSchemas: true,
+		unevaluatedProperties: true,
+	},
+	string: {
+		minLength: true,
+		maxLength: true,
+		pattern: true,
+		format: true,
+		contentEncoding: true,
+		contentMediaType: true,
+	},
+	number: { minimum: true, maximum: true, exclusiveMinimum: true, exclusiveMaximum: true, multipleOf: true },
+	integer: { minimum: true, maximum: true, exclusiveMinimum: true, exclusiveMaximum: true, multipleOf: true },
+	boolean: {},
+	null: {},
+};
+
+/**
+ * Cloud Code Assist shared schema keys allowed on any type.
+ * Used alongside CLOUD_CODE_ASSIST_TYPE_SPECIFIC_KEYS for CCA combiner collapsing.
+ */
+export const CLOUD_CODE_ASSIST_SHARED_SCHEMA_KEYS: Record<string, true> = {
+	title: true,
+	description: true,
+	default: true,
+	examples: true,
+	deprecated: true,
+	readOnly: true,
+	writeOnly: true,
+	$comment: true,
+};
+
+/**
+ * Combinator keys used across schema sanitization modules.
+ * Defined once to avoid duplication in strict-mode.ts and normalize.ts.
+ */
+export const COMBINATOR_KEYS = ["anyOf", "allOf", "oneOf"] as const;
+
+/**
+ * Cloud Code Assist Anthropic model unsupported schema fields.
+ * Much smaller than UNSUPPORTED_SCHEMA_FIELDS (Google) because CCA supports
+ * validation keywords like additionalProperties, minLength, pattern, etc.
+ * Meta/reference keywords plus object-key validators that CCA cannot resolve are stripped.
+ */
+export const CCA_UNSUPPORTED_SCHEMA_FIELDS: Record<string, true> = {
+	$schema: true,
+	$ref: true,
+	$defs: true,
+	$dynamicRef: true,
+	$dynamicAnchor: true,
+	propertyNames: true,
+};

package/src/utils/schema/index.ts

@@ -0,0 +1,13 @@
+export * from "./adapt";
+export * from "./compatibility";
+export * from "./dereference";
+export * from "./draft";
+export * from "./equality";
+export * from "./fields";
+export * from "./json-schema-validator";
+export * from "./meta-validator";
+export * from "./normalize";
+export * from "./spill";
+export * from "./types";
+export * from "./wire";
+export * from "./zod-decontaminate";