@instruments/materialgraph 0.29.0 → 0.31.0

package/schema-resource-types.d.ts

@@ -1,6 +1,6 @@
 import type { OpenEnum } from "./types.js";
-/** The nine governed static resources. */
-export type SchemaResource = "blocks" | "attributes" | "verticals" | "productTypes" | "units" | "valueDictionaries" | "sourceRequirements" | "productTypeTemplates" | "mappings";
+/** The governed static resources. */
+export type SchemaResource = "valueDictionaries";
 /**
  * Resource → the operation that serves it. Internal to the SDK (`index.ts`
  * re-exports this module's TYPES only), and it lives beside
@@ -8,15 +8,7 @@ export type SchemaResource = "blocks" | "attributes" | "verticals" | "productTyp
  * it must cover cannot drift apart.
  */
 export declare const SCHEMA_RESOURCE_OPERATION_IDS: {
-    readonly attributes: "list_schema_attributes";
-    readonly blocks: "list_schema_blocks";
-    readonly mappings: "list_schema_mappings";
-    readonly productTypeTemplates: "list_schema_product_type_templates";
-    readonly productTypes: "list_schema_product_types";
-    readonly sourceRequirements: "list_schema_source_requirements";
-    readonly units: "list_schema_units";
     readonly valueDictionaries: "list_schema_value_dictionaries";
-    readonly verticals: "list_schema_verticals";
 };
 export type SchemaResourceRequest = SchemaResource;
 export type SchemaLifecycle = {
@@ -37,81 +29,6 @@ export type SchemaExternalMapping = {
     notes?: string;
 };
 export type SchemaMatchStrength = OpenEnum<"exact" | "close" | "broad" | "narrow" | "related">;
-export type SchemaBlockItem = {
-    id: string;
-    semanticId: string;
-    lifecycle: SchemaLifecycle;
-    name: string;
-    description: string;
-    attributeIds: string[];
-};
-export type KnownSchemaQuantityKind = "length" | "area" | "volume" | "mass" | "time" | "temperature" | "currency" | "ratio" | "density" | "coverage" | "emissions" | "force" | "thermal_conductivity" | "power" | "voltage" | "current" | "frequency" | "luminous_flux" | "color_temperature" | "count" | "unitless";
-export type SchemaQuantityKind = OpenEnum<KnownSchemaQuantityKind>;
-export type SchemaAttributeItem = {
-    id: string;
-    semanticId: string;
-    lifecycle: SchemaLifecycle;
-    name: string;
-    description: string;
-    valueKind: OpenEnum<"string" | "text" | "integer" | "number" | "boolean" | "enum" | "object" | "reference">;
-    quantityKind: SchemaQuantityKind | null;
-    canonicalUnitId: string | null;
-    acceptedUnitIds: string[];
-    valueDictionaryId: string | null;
-    defaultSourceRequirementId: string | null;
-    externalMappings: SchemaExternalMapping[];
-    searchFacet: boolean;
-    comparable: boolean;
-    usedInBlocks: string[];
-    enumValues: string[] | null;
-};
-export type SchemaVerticalItem = {
-    id: string;
-    displayName: string;
-    description: string;
-};
-export type SchemaApplicability = OpenEnum<"required" | "recommended" | "optional" | "unusual">;
-export type SchemaProductTypeBlock = {
-    blockId: string;
-    applicability: SchemaApplicability;
-    requiredAttributes?: string[];
-    optionalAttributes?: string[];
-    sourceRequirementId?: string;
-    completenessWeight?: number;
-    notes?: string;
-    optional?: boolean;
-};
-export type SchemaProductTypeItem = {
-    id: string;
-    name: string;
-    description?: string;
-    /** Display names this type carried before a rename, kept so they still find it. */
-    formerNames?: string[];
-    verticalId: string;
-    parentProductTypeGroupId?: string;
-    blocks: SchemaProductTypeBlock[];
-    productTypeSpecificAttributes?: string[];
-    semanticId: string;
-    lifecycle: SchemaLifecycle;
-};
-export type SchemaUnitItem = {
-    id: string;
-    name: string;
-    symbol: string;
-    quantityKind: SchemaQuantityKind;
-    acceptedSourceUnits?: string[];
-    conversionToCanonical?: {
-        factor: number;
-        offset?: number;
-    };
-    notes?: string;
-    /** UN/CEFACT Rec 20 common code (schema.org `unitCode`); absent when Rec 20 has none. */
-    uncefactCode?: string;
-    /** QUDT unit IRI, where exactly one QUDT unit matches. */
-    qudtUnit?: string;
-    semanticId: string;
-    lifecycle: SchemaLifecycle;
-};
 export type SchemaValueDictionaryTerm = {
     id: string;
     label: string;
@@ -129,62 +46,8 @@ export type SchemaValueDictionaryItem = {
     semanticId: string;
     lifecycle: SchemaLifecycle;
 };
-export type KnownSchemaSourceType = "manufacturer_page" | "technical_data_sheet" | "safety_data_sheet" | "test_report" | "certificate" | "image" | "commerce_page" | "catalog_pdf" | "derived_analysis";
-export type SchemaSourceType = OpenEnum<KnownSchemaSourceType>;
-export type KnownSchemaSourceMethod = "manual_review" | "agent_extract" | "pdf_extract" | "image_analysis" | "html_scrape" | "structured_feed" | "calculation";
-export type SchemaSourceMethod = OpenEnum<KnownSchemaSourceMethod>;
-export type SchemaSourceRequirementItem = {
-    id: string;
-    name: string;
-    description: string;
-    allowedSourceTypes: SchemaSourceType[];
-    allowedMethods: SchemaSourceMethod[];
-    minConfidence: number;
-    reviewRequired: boolean;
-    freshnessDays?: number;
-    sourceBasis?: OpenEnum<"declared" | "derived">;
-    semanticId: string;
-    lifecycle: SchemaLifecycle;
-};
-export type SchemaProductTypeTemplateBlock = {
-    blockId: string;
-    applicability: SchemaApplicability;
-    requiredAttributes?: string[];
-    optionalAttributes?: string[];
-    sourceRequirementId?: string;
-    completenessWeight?: number;
-    notes?: string;
-};
-export type SchemaProductTypeTemplateItem = {
-    id: string;
-    name: string;
-    productTypeId: string;
-    blocks: SchemaProductTypeTemplateBlock[];
-    defaultSourceRequirementId?: string;
-    notes?: string;
-    semanticId: string;
-    lifecycle: SchemaLifecycle;
-};
-export type SchemaMappingItem = {
-    target: SchemaExternalMapping["target"];
-    subjectKind?: OpenEnum<"attribute" | "block" | "product_type" | "template" | "unit" | "value_dictionary" | "value_dictionary_term">;
-    subjectId?: string;
-    canonicalPath: string;
-    targetPath: string;
-    mappingType: SchemaExternalMapping["mappingType"];
-    matchStrength?: SchemaMatchStrength;
-    notes?: string;
-};
 export type SchemaResourceItemMap = {
-    blocks: SchemaBlockItem;
-    attributes: SchemaAttributeItem;
-    verticals: SchemaVerticalItem;
-    productTypes: SchemaProductTypeItem;
-    units: SchemaUnitItem;
     valueDictionaries: SchemaValueDictionaryItem;
-    sourceRequirements: SchemaSourceRequirementItem;
-    productTypeTemplates: SchemaProductTypeTemplateItem;
-    mappings: SchemaMappingItem;
 };
 export type SchemaResourceResponse<K extends SchemaResource = SchemaResource> = {
     kind: K;

package/schema-resource-types.js

@@ -5,13 +5,5 @@
  * it must cover cannot drift apart.
  */
 export const SCHEMA_RESOURCE_OPERATION_IDS = {
-    attributes: "list_schema_attributes",
-    blocks: "list_schema_blocks",
-    mappings: "list_schema_mappings",
-    productTypeTemplates: "list_schema_product_type_templates",
-    productTypes: "list_schema_product_types",
-    sourceRequirements: "list_schema_source_requirements",
-    units: "list_schema_units",
     valueDictionaries: "list_schema_value_dictionaries",
-    verticals: "list_schema_verticals",
 };

package/search-card-types.d.ts

@@ -16,7 +16,7 @@ import type { OpenEnum, SearchData, SearchResponse } from "./types.js";
  *
  * A PROJECTION, not a smaller answer: a field the card omits (palette, verdict,
  * signals, availability) is unread here, never known-absent. Re-read the same
- * `variantId` at `view: "full"` or via `material()` before claiming anything the
+ * `variantId` at `view: "full"` or via `getVariant()` before claiming anything the
  * card does not carry.
  */
 export type SearchCardItem = {

package/search-index-plan-types.d.ts

@@ -5,9 +5,10 @@
  * `@materialgraph/products/search-index/plan-schema`; `key-parity.test.ts`
  * holds the two to the same fields.
  */
+import type { ColourRegionRange } from "./colour-region-types.js";
 import type { CorpusScope } from "./corpus-scope-types.js";
 /** One attribute the plan wants: its terms, or any value when `presence`. */
-export type SearchIndexPlanWant = {
+type SearchIndexPlanWant = {
     attributeId: string;
     /** Share of the category's materials stating the attribute, 0 to 1. */
     fill: number;
@@ -20,7 +21,7 @@ export type SearchIndexPlanWant = {
     terms: string[];
 };
 /**
- * The query's plan: the category, makers, wanted and excluded attribute terms,
+ * The query's plan: the category, brands, wanted and excluded attribute terms,
  * the colour, the words left for text, and the caller's corpus scope.
  */
 export type SearchIndexPlan = {
@@ -40,6 +41,8 @@ export type SearchIndexPlan = {
         hex: string;
         oklab: [number, number, number];
         phrase: string;
+        /** The colour's region, when the plan holds one rather than a point. */
+        range?: ColourRegionRange;
     } | null;
     /** Present only when the caller sent a scope narrower than the whole graph. */
     corpusScope?: Exclude<CorpusScope, "all">;
@@ -68,3 +71,4 @@ export type SearchPlanReceipt = {
     source: "dictionary" | "jev";
     version: string;
 };
+export {};

package/search-request-types.d.ts

@@ -5,6 +5,7 @@
  * repo's source-size gate; every name here is re-exported from `types.ts`, so
  * no import path changes.
  */
+import type { ColourRegionRange } from "./colour-region-types.js";
 import type { CorpusScope } from "./corpus-scope-types.js";
 import type { Cursor, VariantId } from "./identifiers.js";
 import type { OpenEnum, SearchImageInput } from "./types.js";
@@ -93,16 +94,23 @@ export type SearchInput = {
      * existing Variant. The page is the colour's family, nearest first by OKLab
      * distance; it replaces any colour read from `text`. A Variant with no colour
      * on the index is a 400.
+     *
+     * `oklab` and `range` are additive: send them when you already resolved the
+     * exact OKLab point or the named colour's region (see `resolveColour()`), and
+     * the plan carries that colour without re-deriving it from `hex`. `hex` stays
+     * required.
      */
     colour?: {
         hex: string;
+        oklab?: [number, number, number];
+        range?: ColourRegionRange;
     } | {
         variantId: VariantId;
     };
     /**
-     * Makers the page must come from: canonical brand ids, exact slugs
+     * Brands the page must come from: canonical brand ids, exact slugs
      * ("sherwin-williams") or exact display names ("Sherwin-Williams"), up to
-     * 50. They replace the makers `text` was read as. An empty list is the
+     * 50. They replace the brands `text` was read as. An empty list is the
      * same request as omitting it — every brand. An unrecognised value is a
      * 400 naming it; a display name shared by more than one brand is a 400
      * naming the exact slugs to choose between; a brand MaterialGraph holds no

package/spec-types.d.ts

@@ -22,8 +22,8 @@
  *   object literal for anything else). Reach for it when the spec is the
  *   whole question and ranking would be noise.
  *
- * Discover the tokens before you spend them: `client.specificationFacets()` for
- * what is facetable at all, `client.attributeValues()` for one attribute's
+ * Discover the tokens before you spend them: `client.listVariantFacets()` for
+ * the live values of the attributes you name, `client.attributeValues()` for one attribute's
  * values, `client.listAttributes({ query })` to turn a phrase into a canonical
  * attribute id. A hand-guessed token returns an honest empty answer, which is
  * the hardest kind of bug to see.
@@ -57,8 +57,8 @@ export type CertificationProgrammeAttributeId = typeof CERTIFICATION_PROGRAMME_A
 /**
  * A term-equality spec criterion: the attribute must carry this canonical value,
  * e.g. `{ attributeId: "fire_classifications", term: "astm_e84_class_a" }`.
- * Discover valid `attributeId`/`term` pairs via `client.specificationFacets()`
- * and `client.attributeValues()`, or find an attribute from free text with
+ * Discover valid `attributeId`/`term` pairs via `client.listVariantFacets()`
+ * and `client.listEnumValues()`, or find an attribute from free text with
  * `client.listAttributes({ query })`.
  */
 export type SpecTermFilter = {

package/spec-types.js

@@ -22,8 +22,8 @@
  *   object literal for anything else). Reach for it when the spec is the
  *   whole question and ranking would be noise.
  *
- * Discover the tokens before you spend them: `client.specificationFacets()` for
- * what is facetable at all, `client.attributeValues()` for one attribute's
+ * Discover the tokens before you spend them: `client.listVariantFacets()` for
+ * the live values of the attributes you name, `client.attributeValues()` for one attribute's
  * values, `client.listAttributes({ query })` to turn a phrase into a canonical
  * attribute id. A hand-guessed token returns an honest empty answer, which is
  * the hardest kind of bug to see.

package/specifications.d.ts

@@ -1,12 +1,4 @@
-import type { CertificationProgrammeFilter, SpecExclusionFilter, SpecPresenceFilter, SpecTermFilter } from "./spec-types.js";
-/**
- * A hard criterion excluding one canonical value.
- *
- * By default retains only variants with a KNOWN value (unstated does not
- * pass). Pass `whenUnstated: "pass"` to admit unstated variants too — only a
- * variant that STATES the excluded term is dropped.
- */
-export declare const excludeSpec: (attributeId: string, excludesTerm: string, whenUnstated?: "drop" | "pass") => SpecExclusionFilter;
+import type { CertificationProgrammeFilter, SpecPresenceFilter, SpecTermFilter } from "./spec-types.js";
 /**
  * A term-equality criterion for `search({ filters })` — the attribute must
  * carry this canonical value.

package/specifications.js

@@ -15,18 +15,6 @@
  * object literal needs no encoder (MG-2222).
  */
 import { CERTIFICATION_PROGRAMME_ATTRIBUTE_ID } from "./spec-types.js";
-/**
- * A hard criterion excluding one canonical value.
- *
- * By default retains only variants with a KNOWN value (unstated does not
- * pass). Pass `whenUnstated: "pass"` to admit unstated variants too — only a
- * variant that STATES the excluded term is dropped.
- */
-export const excludeSpec = (attributeId, excludesTerm, whenUnstated) => ({
-    attributeId,
-    excludesTerm,
-    ...(whenUnstated === undefined ? {} : { whenUnstated }),
-});
 /**
  * A term-equality criterion for `search({ filters })` — the attribute must
  * carry this canonical value.

package/sse.d.ts

@@ -1,11 +1,11 @@
 /**
  * A minimal, dependency-free Server-Sent Events reader — the primitive behind
- * {@link MaterialGraphClient.streamRunEvents}. Hand-rolled (no `eventsource`,
+ * {@link WorkflowsClient.streamRunEvents}. Hand-rolled (no `eventsource`,
  * no `undici`) so the SDK stays zero-runtime-dep and works unchanged inside
  * Node route handlers, where `fetch` yields a byte `ReadableStream`.
  *
  * The parser follows the WHATWG event-stream tokenizer closely enough for the
- * `/api/v1/runs/{runId}/events` contract: `\n`, `\r\n`, and `\r` line endings,
+ * `/api/v1/workflows/{workflowId}/runs/{runId}/events` contract: `\n`, `\r\n`, and `\r` line endings,
  * multi-line `data:` accumulation, comment (`:`-prefixed) lines, and a single
  * optional leading space after the field colon. Frames split across network
  * chunks are held in an internal buffer until their terminating blank line.

package/sse.js

@@ -1,11 +1,11 @@
 /**
  * A minimal, dependency-free Server-Sent Events reader — the primitive behind
- * {@link MaterialGraphClient.streamRunEvents}. Hand-rolled (no `eventsource`,
+ * {@link WorkflowsClient.streamRunEvents}. Hand-rolled (no `eventsource`,
  * no `undici`) so the SDK stays zero-runtime-dep and works unchanged inside
  * Node route handlers, where `fetch` yields a byte `ReadableStream`.
  *
  * The parser follows the WHATWG event-stream tokenizer closely enough for the
- * `/api/v1/runs/{runId}/events` contract: `\n`, `\r\n`, and `\r` line endings,
+ * `/api/v1/workflows/{workflowId}/runs/{runId}/events` contract: `\n`, `\r\n`, and `\r` line endings,
  * multi-line `data:` accumulation, comment (`:`-prefixed) lines, and a single
  * optional leading space after the field colon. Frames split across network
  * chunks are held in an internal buffer until their terminating blank line.

package/types.d.ts

@@ -28,7 +28,7 @@ import type { ResponseAttribution } from "./attribution-types.js";
 import type { CorpusScope } from "./corpus-scope-types.js";
 import type { Cursor, ProductId, VariantId } from "./identifiers.js";
 import type { FilterOp } from "./list-variants-types.js";
-import type { MaterialDetail, MaterialTile } from "./material-types.js";
+import type { MaterialTile } from "./material-types.js";
 import type { SearchMode, SearchResponseExplainReceipts } from "./search-response-receipt-types.js";
 export type { SearchResponse } from "./search-response-types.js";
 export type * from "./search-response-receipt-types.js";
@@ -77,7 +77,7 @@ export type MaterialColour = {
 };
 /** Where the served image came from. */
 export type ImageSource = OpenEnum<"r2" | "origin">;
-export type { DimensionEntry, MaterialAvailability, MaterialDetail, MaterialFacet, MaterialSuccessor, MaterialTile, } from "./material-types.js";
+export type { MaterialAvailability, MaterialTile } from "./material-types.js";
 /**
  * Match only: the image-space cosine between the query image and this row's
  * image, in [0,1]. Null when it was not measured.
@@ -98,7 +98,7 @@ export type SearchResultItem = {
     resultId?: string;
     /** Accepted sampleability fact. Absent means unknown, never false. */
     sampleable?: boolean;
-    /** Opaque — round-trip verbatim into `material()`, `pairings()`, `similarTo`. */
+    /** Opaque — round-trip verbatim into `getVariant()`, `pairings()`, `similarTo`. */
     variantId: VariantId;
     brand: string;
     product: string;
@@ -485,17 +485,6 @@ export type PairingsResponse = {
     /** Opaque continuation bound to the seed, filters, corpus, and order. */
     nextCursor?: Cursor;
 };
-export type MaterialResponse = {
-    material: MaterialDetail;
-};
-export type SuggestColourResponse = {
-    suggestions: {
-        term: string;
-        hex: string;
-        libraryId?: string;
-        kind: string;
-    }[];
-};
 /**
  * How a {@link AttributeListItem} matched the query. Declared here rather than
  * imported: this package is published, so it may not reach across into
@@ -554,7 +543,6 @@ export type ListAttributesResult = {
 };
 export type * from "./catalog-discovery-types.js";
 export type * from "./resolve-colour-types.js";
-export type * from "./suggest-types.js";
 export type * from "./by-spec-types.js";
 export type WhoamiResponse = {
     principal: string;
@@ -578,6 +566,7 @@ export type SearchImageInput = {
 };
 export type { SearchGetParams, SearchIndexFilter, SearchInput, } from "./search-request-types.js";
 export type { SearchIndexPlan, SearchPlanReceipt, } from "./search-index-plan-types.js";
+export type { ColourRegionRange } from "./colour-region-types.js";
 /** Options for a pairings read. */
 export type PairingsOptions = {
     /** Comma-separated coarse category display names; filters both arms. */
@@ -608,28 +597,6 @@ export type ListAttributesOptions = {
     /** `pageInfo.endCursor` from the previous page, with the same query and scope. */
     cursor?: string;
 };
-export type * from "./demand-types.js";
-/** One quarter's tally. Sparse across a series — an absent quarter is not a zero. */
-export type DemandQuarter = {
-    quarter: string;
-    specCount: number;
-    projectCount: number;
-};
-/**
- * Which behavioural signal a demand read is scoped to — and therefore what a
- * number drawn from it may honestly be called.
- *
- *  - `sampled` — real ORDER co-occurrence. The default everywhere. Present as
- *    "specified together" / "specified on N projects".
- *  - `considered` — board / moodboard CURATION. Somebody assembled them; nobody
- *    is known to have bought them. Present as "considered alongside", never as
- *    a specification.
- *  - `specified` — the won tier. STATS ONLY: no co-specification edges are built
- *    at this grain, so asking for `specified` companions is a rejected request,
- *    not an empty result.
- */
-export type DemandSignal = OpenEnum<"sampled" | "considered" | "specified">;
-export type * from "./demand-batch-types.js";
 export type ExtractedPalette = {
     colors: {
         hex: string;
@@ -647,7 +614,6 @@ export type ExtractedPalette = {
 export type ExtractPaletteResponse = {
     palette: ExtractedPalette | null;
 };
-export type * from "./spec-facet-types.js";
 /** Body for `POST /api/v1/search/palettes/extract`. */
 export type ExtractPaletteInput = {
     /** The query image as a data URI or bare base64 string. */

package/validation.d.ts

@@ -15,37 +15,19 @@
  * this file knowing what a Match frame or a Run event is.
  */
 import type { MaterialGraphError } from "./errors.js";
-import type { JsonValue } from "./types.js";
 /**
  * Builds the one error a validation run raises. The calling module supplies it,
  * so the message names that payload and quotes its source.
  */
 export type ValidationFailure = (reason: string) => MaterialGraphError;
-export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
 /** A `z.object({…})`. */
 export declare const requireRecord: (value: unknown, what: string, fail: ValidationFailure) => Record<string, unknown>;
 /** A `z.string()`. */
 export declare const requireString: (value: unknown, what: string, fail: ValidationFailure) => string;
-/** A `z.string().min(1)`. */
-export declare const requireNonEmptyString: (value: unknown, what: string, fail: ValidationFailure) => string;
 /** A `z.string().optional()`: absent is fine, present-but-wrong is not. */
 export declare const requireOptionalString: (value: unknown, what: string, fail: ValidationFailure) => void;
 /** A `z.string().nullable()`. */
 export declare const requireNullableString: (value: unknown, what: string, fail: ValidationFailure) => string | null;
-/** A `z.string().min(1).nullable()`. */
-export declare const requireNullableNonEmptyString: (value: unknown, what: string, fail: ValidationFailure) => string | null;
-/**
- * A `z.string().trim().min(1).max(max)`.
- *
- * The `.trim()` is a TRANSFORM, so the schema's parsed output is the trimmed
- * string and its length bounds apply AFTER trimming. A mirror that checked the
- * raw length would disagree with the schema twice over: it would accept a
- * whitespace-only value the schema rejects, and reject a padded value the schema
- * accepts. Returns the trimmed string, which is what the schema returns.
- */
-export declare const requireTrimmedBoundedString: (value: unknown, what: string, max: number, fail: ValidationFailure) => string;
-/** A `z.string().trim().min(1).max(max).nullable()`. */
-export declare const requireNullableTrimmedBoundedString: (value: unknown, what: string, max: number, fail: ValidationFailure) => string | null;
 /** A `z.boolean()`. */
 export declare const requireBoolean: (value: unknown, what: string, fail: ValidationFailure) => boolean;
 /** A `z.boolean().optional()`. */
@@ -55,8 +37,6 @@ export declare const requireOptionalBoolean: (value: unknown, what: string, fail
  * out of JSON as `Infinity`, so finiteness is a reachable check.
  */
 export declare const requireNumber: (value: unknown, what: string, fail: ValidationFailure) => number;
-/** A `z.number().optional()`. */
-export declare const requireOptionalNumber: (value: unknown, what: string, fail: ValidationFailure) => void;
 /** A `z.number().nullable()`. */
 export declare const requireNullableNumber: (value: unknown, what: string, fail: ValidationFailure) => number | null;
 /**
@@ -64,29 +44,10 @@ export declare const requireNullableNumber: (value: unknown, what: string, fail:
  * comparisons, exactly as the bounded Zod schema rejects them.
  */
 export declare const requireBoundedNumber: (value: unknown, what: string, fail: ValidationFailure, min: number, max: number) => number;
-/** A `z.number().min(min).max(max).nullable()`. */
-export declare const requireNullableBoundedNumber: (value: unknown, what: string, fail: ValidationFailure, min: number, max: number) => number | null;
-/**
- * A bare `z.number().int()` — integer, finite, and within the SAFE range, with
- * NO lower bound.
- *
- * Measured against the pinned Zod (4.4.3), `.int()` is exactly
- * `Number.isSafeInteger`: it accepts `0`, `-1`, and `±MAX_SAFE_INTEGER`, and
- * rejects `1.5`, `±2**53`, `NaN`, and `±Infinity`.
- *
- * Two ways to get this wrong, both of which break parity in a different
- * direction. Adding a `min: 0` REJECTS a negative the schema accepts — a client
- * refusing a legitimate response. Using `Number.isInteger` ACCEPTS `2**53`,
- * which the schema rejects — so `requireIntegerAtLeast` is not this helper with
- * the bound dropped, and the safe-range test is why.
- */
-export declare const requireSafeInteger: (value: unknown, what: string, fail: ValidationFailure) => number;
 /** A `z.number().int().min(min)` — the integer constraint AND the lower bound. */
 export declare const requireIntegerAtLeast: (value: unknown, what: string, fail: ValidationFailure, min: number) => number;
 /** A `z.enum([…])` — CLOSED, exactly like the canonical member list. */
 export declare const requireEnum: (value: unknown, allowed: readonly string[], what: string, fail: ValidationFailure) => string;
-/** A `z.enum([…]).nullable()`. */
-export declare const requireNullableEnum: (value: unknown, allowed: readonly string[], what: string, fail: ValidationFailure) => string | null;
 /** A `z.array(…)`. */
 export declare const requireArray: (value: unknown, what: string, fail: ValidationFailure) => unknown[];
 /**
@@ -94,38 +55,3 @@ export declare const requireArray: (value: unknown, what: string, fail: Validati
  * `[]`; a present non-array is not.
  */
 export declare const requireDefaultedArray: (value: unknown, what: string, fail: ValidationFailure) => unknown[];
-/** A `z.array(z.string()).min(1)` — non-empty, and every element a string. */
-export declare const requireNonEmptyStringArray: (value: unknown, what: string, fail: ValidationFailure) => string[];
-/**
- * A `z.json()` — a JSON value, recursively: `string | number | boolean | null`,
- * an array of them, or an object of them, at ANY depth.
- *
- * WHY THIS EXISTS, given it can never fire over the wire. Every SDK response
- * has already been through `JSON.parse`, so a `Date`, `bigint`, `undefined`, or
- * function CANNOT be present by construction — this check is unreachable in
- * practice. It is here for PARITY: the canonical `sourceImageAnalysisResultSchema`
- * uses `z.json()` precisely because those four break differently on the way to
- * `jsonb` (a `bigint` throws in `JSON.stringify`, an `undefined` is silently
- * dropped, and a `Date` round-trips as an ISO *string* — a different type read
- * back than written). The mirror has to reject what the schema rejects or the
- * parity test is lying. Do not delete this as dead code.
- */
-export declare const requireJsonValue: (value: unknown, what: string, fail: ValidationFailure) => JsonValue;
-/**
- * A `z.record(z.string(), z.json())` — a PLAIN JSON object of JSON values.
- *
- * Deliberately NOT `requireRecord` + walk the entries. That combination has a
- * top-level hole: `Object.entries(new Date())` and `Object.entries(new Map())`
- * are both `[]`, so there is nothing to recurse over and the value is accepted
- * as `{}` — while `z.record(z.string(), z.json())` rejects both outright. A
- * "non-array object" guard would close those two and still miss a class instance
- * with real own properties, which canonical also rejects. Only a prototype test
- * matches, and {@link requireJsonValue} already applies it at every depth — so
- * this delegates there and then narrows to an object, rather than reimplementing
- * the test and acquiring the same hole one level up.
- *
- * `requireRecord` is left alone: its other callers mirror `z.object({…})`, which
- * genuinely does accept any record, and tightening a shared helper under them
- * would be a change none of them asked for.
- */
-export declare const requireJsonRecord: (value: unknown, what: string, fail: ValidationFailure) => Record<string, JsonValue>;