@instruments/materialgraph 1.3.0 → 2.0.0

package/client-response-schema.js

@@ -29,7 +29,6 @@ const openStrings = new Set([
     "ProductDocumentPage.documents.declarations.status",
     "ProductDocumentPage.documents.documentTypes",
     "ProductDocumentPage.documents.status",
-    "PublicRun.status",
     "ResolveColorResponse.match.libraryType",
     "ResolveColorResponse.match.variant.reason",
     "SchemaValueDictionariesResponse.items.lifecycle.status",

package/client.d.ts

@@ -4,6 +4,7 @@ import { CatalogClient } from "./catalog-client.js";
 import { CategoriesClient } from "./categories-client.js";
 import type { MaterialGraphClientOptions } from "./client-config.js";
 import { ColorsClient } from "./colors-client.js";
+import type { DiscoveryReference, DiscoveryTerms, InterpretDiscoveryTermsInput, ColorlessVariantsResult, VariantSibling } from "./discovery-context-types.js";
 import type { RateLimit } from "./errors.js";
 import type { FindSampledTogetherInput, FindSampledTogetherOutput } from "./find-sampled-together-types.js";
 import type { FindVariantsByColorInput, FindVariantsByColorOutput } from "./find-variants-by-color-types.js";
@@ -15,11 +16,10 @@ import type { ListSampledTogetherPairsInput, ListSampledTogetherPairsOutput } fr
 import type { ListVariantFacetsInput, ListVariantFacetsOutput } from "./list-variant-facets-types.js";
 import type { ListVariantsInput, ListVariantsOutput } from "./list-variants-types.js";
 import type { ListVariantAssetsOptions, MaterialDocumentPageOptions, VariantAssetPage } from "./material-asset-types.js";
-import type { SourceMaterialBatchReceipt, UploadSourceMaterialInput } from "./run-types.js";
 import type { SchemaResource, SchemaResourceResponse } from "./schema-resource-types.js";
 import type { SearchVariantsInput, SearchVariantsOutput } from "./search-variants-types.js";
+import type { SourceMaterialBatchReceipt, UploadSourceMaterialInput } from "./source-material-types.js";
 import type { ExtractPaletteInput, ExtractPaletteResponse, ListAttributesOptions, ListAttributesResult, PairingsOptions, PairingsResponse, ResolveColorOptions, ResolveColorResponse, WhoamiResponse } from "./types.js";
-import { WorkflowsClient } from "./workflows-client.js";
 export { DEFAULT_BASE_URL } from "./client-config.js";
 export type { MaterialGraphClientOptions } from "./client-config.js";
 /**
@@ -40,7 +40,6 @@ export type { MaterialGraphClientOptions } from "./client-config.js";
  * | "what does the brand say is AVAILABLE on this?" | {@link MaterialGraphClient.associatedFinishes}, {@link MaterialGraphClient.associatedProducts} |
  * | "what can I even ask for?" | {@link MaterialGraphClient.listVariantFacets}, `categories.list()` |
  * | "what is this word called here?" | {@link MaterialGraphClient.listAttributes} |
- * | "do the whole job for me, async" | `workflows.start()` + `mg:compose` |
  *
  * Three structural rules that fall out of that table:
  * - **Color is a separate lens.** {@link MaterialGraphClient.searchVariants}
@@ -88,16 +87,16 @@ export declare class MaterialGraphClient extends CatalogClient {
      * Value Source says which.
      */
     readonly colors: ColorsClient;
-    /**
-     * THE QUESTION: "do a whole job for me" — the ASYNC lens. `start()` begins a
-     * Run of one registered workflow, `run()` polls it, `streamRunEvents()` and
-     * `drainRunEvents()` follow it live. Everything else on this client answers
-     * in one round trip; a Run may suspend for human input and finish minutes
-     * later. Replaces the flat `createRun()` / `run()` family, with no shim.
-     */
-    readonly workflows: WorkflowsClient;
     constructor(options: MaterialGraphClientOptions);
     get lastRateLimit(): RateLimit | null;
+    /** Registry definitions and MG's catalog admission policy. */
+    discoveryReference(signal?: AbortSignal): Promise<DiscoveryReference>;
+    /** MG's exact category and generic color phrase readings. */
+    interpretDiscoveryTerms(input: InterpretDiscoveryTermsInput, signal?: AbortSignal): Promise<DiscoveryTerms>;
+    /** Colorless finishes among at most 250 supplied variants. */
+    colorlessVariants(variantIds: readonly string[], signal?: AbortSignal): Promise<ColorlessVariantsResult>;
+    /** The eligible colorways of this variant's product, in name/id order, capped at 300. */
+    variantSiblings(variantId: string, signal?: AbortSignal): Promise<VariantSibling[] | null>;
     /** Current catalog generation; authenticated, no SQL and no rate-limit charge. */
     getCatalogGeneration(signal?: AbortSignal): Promise<{
         generation: number;

package/client.js

@@ -10,9 +10,8 @@ import { HttpTransport } from "./http-transport.js";
 import { listVariantAssets as listVariantAssetsCall, materialBlocks as materialBlocksCall, materialDocuments as materialDocumentsCall, } from "./material-resources-client.js";
 // Aliased to `operation` — the local name every call site here already used.
 import { resolveOperation as operation } from "./operations.js";
-import { uploadSourceMaterial } from "./runs.js";
 import { SCHEMA_RESOURCE_OPERATION_IDS } from "./schema-resource-types.js";
-import { WorkflowsClient } from "./workflows-client.js";
+import { uploadSourceMaterial } from "./source-material.js";
 // Re-exported whole so `index.ts` and every existing importer keep their path.
 export { DEFAULT_BASE_URL } from "./client-config.js";
 /**
@@ -33,7 +32,6 @@ export { DEFAULT_BASE_URL } from "./client-config.js";
  * | "what does the brand say is AVAILABLE on this?" | {@link MaterialGraphClient.associatedFinishes}, {@link MaterialGraphClient.associatedProducts} |
  * | "what can I even ask for?" | {@link MaterialGraphClient.listVariantFacets}, `categories.list()` |
  * | "what is this word called here?" | {@link MaterialGraphClient.listAttributes} |
- * | "do the whole job for me, async" | `workflows.start()` + `mg:compose` |
  *
  * Three structural rules that fall out of that table:
  * - **Color is a separate lens.** {@link MaterialGraphClient.searchVariants}
@@ -80,14 +78,6 @@ export class MaterialGraphClient extends CatalogClient {
      * Value Source says which.
      */
     colors;
-    /**
-     * THE QUESTION: "do a whole job for me" — the ASYNC lens. `start()` begins a
-     * Run of one registered workflow, `run()` polls it, `streamRunEvents()` and
-     * `drainRunEvents()` follow it live. Everything else on this client answers
-     * in one round trip; a Run may suspend for human input and finish minutes
-     * later. Replaces the flat `createRun()` / `run()` family, with no shim.
-     */
-    workflows;
     #transport;
     constructor(options) {
         if (!options.apiKey) {
@@ -110,7 +100,6 @@ export class MaterialGraphClient extends CatalogClient {
         this.colors = new ColorsClient({
             get: async (operationId, query, signal) => await this.#get(operationId, query, signal),
         });
-        this.workflows = new WorkflowsClient({ transport });
     }
     get lastRateLimit() {
         return this.#transport.lastRateLimit;
@@ -129,6 +118,24 @@ export class MaterialGraphClient extends CatalogClient {
             signal,
         });
     }
+    /** Registry definitions and MG's catalog admission policy. */
+    async discoveryReference(signal) {
+        return await this.#get("get_discovery_reference", undefined, signal);
+    }
+    /** MG's exact category and generic color phrase readings. */
+    async interpretDiscoveryTerms(input, signal) {
+        return await this.#post("interpret_discovery_terms", input, signal);
+    }
+    /** Colorless finishes among at most 250 supplied variants. */
+    async colorlessVariants(variantIds, signal) {
+        return await this.#post("find_colorless_variants", { variantIds }, signal);
+    }
+    /** The eligible colorways of this variant's product, in name/id order, capped at 300. */
+    async variantSiblings(variantId, signal) {
+        return await this.#get("list_variant_siblings", undefined, signal, {
+            variantId,
+        });
+    }
     /** Current catalog generation; authenticated, no SQL and no rate-limit charge. */
     async getCatalogGeneration(signal) {
         return await this.#get("get_catalog_generation", undefined, signal);

package/discovery-context-types.d.ts

@@ -0,0 +1,45 @@
+import type { MaterialTile } from "./material-types.js";
+/** Static registry definitions and MG-owned discovery policy, without product counts. */
+export type DiscoveryReference = {
+    attributes: {
+        id: string;
+        name: string;
+        valueKind: string;
+        dictionaryId: string | null;
+        unit: string | null;
+        isArray: boolean;
+        filterable: boolean;
+    }[];
+    categories: {
+        id: string;
+        name: string;
+        path: string;
+        ancestorIds: string[];
+        inCatalog: boolean;
+    }[];
+    productTypes: {
+        id: string;
+        name: string;
+        description: string;
+    }[];
+    admittedBrandIds: string[];
+};
+export type InterpretDiscoveryTermsInput = {
+    text: string;
+    categoryIds: readonly string[];
+};
+export type DiscoveryTerms = {
+    categories: {
+        categoryIds: string[];
+        words: string[];
+    } | null;
+    colorWordHexes: string[];
+};
+export type ColorlessVariantsResult = {
+    variantIds: string[];
+};
+/** A sibling uses the same tile contract as the catalog's material cards. */
+export type VariantSibling = MaterialTile & {
+    distinction?: string;
+    distinguishedBy?: "size" | "code";
+};

package/discovery-context-types.js

@@ -0,0 +1 @@
+export {};

package/http-transport.d.ts

@@ -11,12 +11,6 @@ export type RequestOptions = {
     signal?: AbortSignal;
     pathParams?: Readonly<Record<string, string>>;
 };
-export type StreamRequestOptions = {
-    /** The streaming media type to negotiate (`text/event-stream`, `application/x-ndjson`). */
-    accept: string;
-    /** Names this stream in the "returned no body" diagnostic, e.g. `"run-event stream"`. */
-    subject: string;
-} & RequestOptions;
 /** A read, status-checked HTTP response with its parsed body. */
 export type SentResponse = {
     response: Response;
@@ -55,16 +49,6 @@ export declare class HttpTransport {
      * it consumes the whole body via `response.text()`.
      */
     send(input: SendInput): Promise<SentResponse>;
-    /**
-     * Open a streaming operation and hand back its UNREAD byte body — the one
-     * entry point for every long-lived read (SSE run events, NDJSON Match
-     * progress). Everything up to the first byte behaves exactly like
-     * {@link send}: same URL building, same bearer header, same rate-limit
-     * capture, same {@link MaterialGraphError} mapping for a transport failure or
-     * a non-2xx (whose short error body IS read, since it is not a stream).
-     * Framing and cancellation belong to the caller.
-     */
-    openStream(sdkOperation: SdkOperation, options: StreamRequestOptions): Promise<ReadableStream<Uint8Array>>;
     /** Execute a registered JSON operation and return its typed body. */
     requestJson<K extends JsonOperationId>(sdkOperation: SdkOperation<K>, options?: RequestOptions): Promise<OperationResponses[K]>;
 }

package/http-transport.js

@@ -148,79 +148,6 @@ export class HttpTransport {
         }
         return { parsed, response, text };
     }
-    /**
-     * Open a streaming operation and hand back its UNREAD byte body — the one
-     * entry point for every long-lived read (SSE run events, NDJSON Match
-     * progress). Everything up to the first byte behaves exactly like
-     * {@link send}: same URL building, same bearer header, same rate-limit
-     * capture, same {@link MaterialGraphError} mapping for a transport failure or
-     * a non-2xx (whose short error body IS read, since it is not a stream).
-     * Framing and cancellation belong to the caller.
-     */
-    async openStream(sdkOperation, options) {
-        const url = this.buildUrl(operationPath(sdkOperation, options.pathParams), options.query);
-        const requestUrl = new URL(url);
-        const metadata = {
-            method: sdkOperation.method,
-            origin: requestUrl.origin,
-            path: requestUrl.pathname,
-        };
-        const hasBody = options.body !== undefined;
-        let response;
-        try {
-            response = await this.fetch(url, {
-                body: hasBody ? JSON.stringify(options.body) : undefined,
-                headers: this.authHeaders({
-                    Accept: options.accept,
-                    ...(hasBody ? { "Content-Type": "application/json" } : {}),
-                }),
-                method: sdkOperation.method,
-                signal: options.signal,
-            });
-        }
-        catch (cause) {
-            throw MaterialGraphError.fromTransport({
-                ...metadata,
-                callerSignal: options.signal,
-                cause,
-            });
-        }
-        const rateLimit = parseRateLimit(response.headers);
-        this.#lastRateLimit = rateLimit;
-        if (!response.ok) {
-            let text = "";
-            try {
-                text = await response.text();
-            }
-            catch {
-                // The status IS the error; a body that will not read adds nothing and
-                // must not mask it. Report the failure with an empty detail instead.
-                text = "";
-            }
-            let parsed;
-            if (text.length > 0) {
-                try {
-                    parsed = JSON.parse(text);
-                }
-                catch {
-                    parsed = text;
-                }
-            }
-            throw MaterialGraphError.fromResponse({
-                ...metadata,
-                apiKey: this.apiKey,
-                body: parsed,
-                queryValues: [...requestUrl.searchParams.values()],
-                rateLimit,
-                responseText: text,
-                status: response.status,
-            });
-        }
-        if (response.body === null) {
-            throw MaterialGraphError.unexpected(`MaterialGraph ${options.subject} returned no body`);
-        }
-        return response.body;
-    }
     /** Execute a registered JSON operation and return its typed body. */
     async requestJson(sdkOperation, options = {}) {
         const url = this.buildUrl(operationPath(sdkOperation, options.pathParams), options.query);

package/identifiers.d.ts

@@ -5,7 +5,7 @@
  * MaterialGraph hands back two very different kinds of string, and the whole
  * class of caller bugs this file exists to prevent comes from confusing them:
  *
- * - **Opaque tokens** ({@link VariantId}, {@link ProductId}, {@link RunId},
+ * - **Opaque tokens** ({@link VariantId}, {@link ProductId},
  *   {@link BatchId}, {@link ProjectId}, {@link SchemeId}, {@link SlotId},
  *   {@link Cursor}). Round-trip them BYTE-FOR-BYTE. Never parse one, never
  *   construct one, never pattern-match one, never sort by one, and never read
@@ -42,11 +42,6 @@ export type VariantId = OpaqueId;
  * Opaque: preserve verbatim, never parse or construct one.
  */
 export type ProductId = OpaqueId;
-/**
- * A Run id from the hosted agentic surface. Opaque: preserve verbatim, never
- * parse or construct one.
- */
-export type RunId = OpaqueId;
 /**
  * A source-material batch id (`smb_…`). The prefix is a reading convenience,
  * not a contract — treat the whole string as opaque.

package/identifiers.js

@@ -5,7 +5,7 @@
  * MaterialGraph hands back two very different kinds of string, and the whole
  * class of caller bugs this file exists to prevent comes from confusing them:
  *
- * - **Opaque tokens** ({@link VariantId}, {@link ProductId}, {@link RunId},
+ * - **Opaque tokens** ({@link VariantId}, {@link ProductId},
  *   {@link BatchId}, {@link ProjectId}, {@link SchemeId}, {@link SlotId},
  *   {@link Cursor}). Round-trip them BYTE-FOR-BYTE. Never parse one, never
  *   construct one, never pattern-match one, never sort by one, and never read

package/index.d.ts

@@ -1,3 +1,4 @@
+export type { DiscoveryReference, DiscoveryTerms, InterpretDiscoveryTermsInput, ColorlessVariantsResult, VariantSibling, } from "./discovery-context-types.js";
 export { MaterialGraphClient, DEFAULT_BASE_URL } from "./client.js";
 export type { MaterialGraphClientOptions } from "./client.js";
 export type { FilterOp, FilterTermCondition, FilterNumericCondition, FilterPresenceCondition, FilterAnyFieldCondition, FilterCondition, FilterGroups, OptionalFilterGroups, OrderByEntry, ListVariantsInclude, ListVariantsCollapse, ColorRegion, ColorRangeCondition, ListVariantsInput, ListVariantsPreference, ListVariantsSpecifications, ListVariantsNotApplicable, SampleSubject, ListVariantsItem, ListVariantsOutput, VariantCard, } from "./list-variants-types.js";
@@ -13,9 +14,8 @@ export { FIND_VARIANTS_BY_VECTOR_MODES } from "./find-variants-by-vector-types.j
 export type { FindVariantsByVectorMode, FindVariantsByVectorQuery, FindVariantsByVectorInput, FindVariantsByVectorItem, FindVariantsByVectorReference, FindVariantsByVectorScan, FindVariantsByVectorTimings, FindVariantsByVectorOutput, } from "./find-variants-by-vector-types.js";
 export { MATERIALGRAPH_API_VERSION, SDK_OPERATIONS } from "./operations.js";
 export type { SdkOperation, SdkOperationId } from "./operations.js";
-export type { OpaqueId, VariantId, ProductId, RunId, BatchId, SourceFileId, ProjectId, SchemeId, SlotId, Cursor, } from "./identifiers.js";
-export { TERMINAL_RUN_EVENT_TYPES } from "./run-types.js";
-export type { FileInput, UploadSourceMaterialInput, SourceMaterialReceiptFile, SourceMaterialBatchReceipt, PublicRunStatus, PublicRunFailure, PublicRunArtifactRef, PublicRun, CreatePublicRunRequest, CreatePublicRunResponse, PublicRunResponse, RunEvent, StreamRunEventsOptions, DrainRunEventsOptions, } from "./run-types.js";
+export type { OpaqueId, VariantId, ProductId, BatchId, SourceFileId, ProjectId, SchemeId, SlotId, Cursor, } from "./identifiers.js";
+export type { FileInput, UploadSourceMaterialInput, SourceMaterialReceiptFile, SourceMaterialBatchReceipt, } from "./source-material-types.js";
 export { MATERIALGRAPH_PROBLEM_EXTENSIONS, MaterialGraphError, } from "./errors.js";
 export type { MaterialGraphErrorInit, MaterialGraphErrorKind, MaterialGraphRequestMetadata, ProblemDetail, RateLimit, SanitizedErrorValue, SanitizedIssue, SimpleErrorBody, } from "./errors.js";
 export type { OpenEnum, JsonValue, OklabTriple, MaterialColor, ImageSource, MaterialAvailability, MaterialTile, DemandMomentum, CompanionDemand, ProjectTypeShare, CospecPairing, ColorPairing, PairingOrderMode, PairingRanking, PairingOrdering, PairingItem, PairingsResponse, AttributeMatch, AttributeListItem, OutsideScopeAttribute, ListAttributesResult, WhoamiResponse, PairingsOptions, ListAttributesOptions, ExtractedPalette, ExtractPaletteResponse, ExtractPaletteInput, ResolveValueCandidate, ValueResolution, ResolveColorOptions, ResolveColorCatalogVariant, ResolveColorVariant, ResolveColorResponse, BySpecVerdictState, BySpecVerdictCell, BySpecVerdict, MaterialVerdict, BySpecUnresolvedCriterion, } from "./types.js";

package/index.js

@@ -1,7 +1,6 @@
 export { MaterialGraphClient, DEFAULT_BASE_URL } from "./client.js";
 export { FIND_VARIANTS_BY_VECTOR_MODES } from "./find-variants-by-vector-types.js";
 export { MATERIALGRAPH_API_VERSION, SDK_OPERATIONS } from "./operations.js";
-export { TERMINAL_RUN_EVENT_TYPES } from "./run-types.js";
 export { MATERIALGRAPH_PROBLEM_EXTENSIONS, MaterialGraphError, } from "./errors.js";
 export { CategoriesClient } from "./categories-client.js";
 export { ColorsClient } from "./colors-client.js";

package/operation-responses.d.ts

@@ -4,6 +4,7 @@ import type { ListBrandsPage } from "./brand-types.js";
 import type { CatalogDocumentList, CatalogPageListResult, CatalogProductReferenceReadResult, CatalogChannelCollectionsResponse, CatalogDocumentAccessResult, CatalogPageRepresentationReadResult, CatalogReferenceBatchResponse } from "./catalog-types.js";
 import type { CategoriesGetResult, CategoriesListResult } from "./category-types.js";
 import type { CategoryColorProfilesResponse } from "./color-profiles-types.js";
+import type { DiscoveryReference, DiscoveryTerms, ColorlessVariantsResult, VariantSibling } from "./discovery-context-types.js";
 import type { FindSampledTogetherOutput } from "./find-sampled-together-types.js";
 import type { FindVariantsByColorOutput } from "./find-variants-by-color-types.js";
 import type { FindVariantsByVectorOutput } from "./find-variants-by-vector-types.js";
@@ -16,19 +17,22 @@ import type { MaterialDocumentPage, VariantAssetPage } from "./material-asset-ty
 import type { MaterialBlockProjection } from "./material-block-types.js";
 import type { NearestPaintsOutput } from "./nearest-paints-types.js";
 import type { ResolveVariantOutput } from "./resolve-variant-types.js";
-import type { CreatePublicRunResponse, PublicRunResponse, SourceMaterialBatchReceipt } from "./run-types.js";
 import type { SamplizeCatalogPage } from "./samplize-catalog-types.js";
 import type { SchemaResourceResponse } from "./schema-resource-types.js";
 import type { SearchVariantsOutput } from "./search-variants-types.js";
+import type { SourceMaterialBatchReceipt } from "./source-material-types.js";
 import type { ExtractPaletteResponse, ListAttributesResult, PairingsResponse, ResolveColorResponse, WhoamiResponse } from "./types.js";
 export type OperationResponses = {
+    get_discovery_reference: DiscoveryReference;
+    interpret_discovery_terms: DiscoveryTerms;
+    find_colorless_variants: ColorlessVariantsResult;
+    list_variant_siblings: VariantSibling[] | null;
     find_nearest_paints: NearestPaintsOutput;
     get_catalog_generation: {
         generation: number;
     };
     catalog_list_attributes: ListAttributesResult;
     catalog_list_enum_values: ListEnumValuesResult;
-    create_public_run: CreatePublicRunResponse;
     extract_image_palette: ExtractPaletteResponse;
     find_sampled_together: FindSampledTogetherOutput;
     list_sampled_together_pairs: ListSampledTogetherPairsOutput;
@@ -41,7 +45,6 @@ export type OperationResponses = {
     get_category: CategoriesGetResult;
     get_category_color_profiles: CategoryColorProfilesResponse;
     get_material_pairings: PairingsResponse;
-    get_public_run: PublicRunResponse;
     get_variant: GetVariantOutput;
     list_associated_finishes: DeclaredAssociationsResponse;
     list_associated_products: DeclaredAssociationsResponse;

package/operations.generated.d.ts

@@ -1,5 +1,5 @@
 export declare const MATERIALGRAPH_API_VERSION = "0.8.0";
-declare const OPERATION_DEFINITIONS: readonly [readonly ["colors.nearestPaints", "GET", "/api/v1/colors/nearest-paints", "find_nearest_paints"], readonly ["getCatalogGeneration", "GET", "/api/v1/catalog/generation", "get_catalog_generation"], readonly ["catalogs", "GET", "/api/v1/catalogs", "list_catalog_documents"], readonly ["catalogPages", "GET", "/api/v1/catalogs/{catalogId}/pages", "list_catalog_pages"], readonly ["catalogPageRepresentation", "GET", "/api/v1/catalog-pages/{pageId}/representation", "get_catalog_page_representation"], readonly ["catalogReferences", "GET", "/api/v1/catalogs/{catalogId}/references", "list_catalog_product_references"], readonly ["samplizeCatalog", "GET", "/api/v1/catalogs/samplize/products", "samplize_catalog_products"], readonly ["catalogReferencesForVariants", "POST", "/api/v1/catalogs/references", "get_catalog_references_batch"], readonly ["catalogCollections", "GET", "/api/v1/catalogs/collections", "list_catalog_channel_collections"], readonly ["catalogDocumentAccess", "GET", "/api/v1/catalogs/documents/{documentId}", "get_catalog_document_access"], readonly ["materialBlocks", "GET", "/api/v1/materials/{variantId}/blocks", "list_material_blocks"], readonly ["listVariantAssets", "GET", "/api/v1/variants/{variantId}/assets", "list_variant_assets"], readonly ["materialDocuments", "GET", "/api/v1/materials/{variantId}/documents", "list_material_documents"], readonly ["schema", "GET", "/api/v1/schema/value-dictionaries", "list_schema_value_dictionaries"], readonly ["pairings", "GET", "/api/v1/materials/{variantId}/pairings", "get_material_pairings"], readonly ["associatedFinishes", "GET", "/api/v1/associated/finishes", "list_associated_finishes"], readonly ["associatedProducts", "GET", "/api/v1/associated/products", "list_associated_products"], readonly ["applicability", "GET", "/api/v1/applicability", "get_applicability"], readonly ["listVariants", "GET", "/api/v1/variants", "list_variants"], readonly ["listVariantFacets", "POST", "/api/v1/variants/facets", "list_variant_facets"], readonly ["searchVariants", "POST", "/api/v1/variants/search", "search_variants"], readonly ["findVariantsByColor", "GET", "/api/v1/variants/by-color", "find_variants_by_color"], readonly ["findVariantsByVector", "POST", "/api/v1/variants/by-vector", "find_variants_by_vector"], readonly ["findSampledTogether", "GET", "/api/v1/variants/sampled-together", "find_sampled_together"], readonly ["listSampledTogetherPairs", "GET", "/api/v1/variants/sampled-together/pairs", "list_sampled_together_pairs"], readonly ["resolveVariant", "POST", "/api/v1/variants/resolve", "resolve_variant"], readonly ["getVariant", "GET", "/api/v1/variants/{variantId}", "get_variant"], readonly ["resolveColor", "GET", "/api/v1/search/colors/resolve", "resolve_color_name"], readonly ["listAttributes", "GET", "/api/v1/catalog/attributes", "catalog_list_attributes"], readonly ["listEnumValues", "GET", "/api/v1/catalog/enum-values", "catalog_list_enum_values"], readonly ["categories.list", "GET", "/api/v1/categories", "list_categories"], readonly ["categories.get", "GET", "/api/v1/categories/{id}", "get_category"], readonly ["whoami", "GET", "/api/v1/whoami", "whoami"], readonly ["colors.profiles", "GET", "/api/v1/colors/profiles", "get_category_color_profiles"], readonly ["extractPalette", "POST", "/api/v1/search/palettes/extract", "extract_image_palette"], readonly ["brands", "GET", "/api/v1/brands", "list_brands"], readonly ["uploadSourceMaterial", "POST", "/api/v1/source-material", "upload_source_material"], readonly ["workflows.start", "POST", "/api/v1/workflows/{workflowId}/runs", "create_public_run"], readonly ["workflows.run", "GET", "/api/v1/workflows/{workflowId}/runs/{runId}", "get_public_run"], readonly ["workflows.streamRunEvents", "GET", "/api/v1/workflows/{workflowId}/runs/{runId}/events", "list_public_run_events"]];
+declare const OPERATION_DEFINITIONS: readonly [readonly ["discoveryReference", "GET", "/api/v1/catalog/discovery-reference", "get_discovery_reference"], readonly ["interpretDiscoveryTerms", "POST", "/api/v1/catalog/interpret-terms", "interpret_discovery_terms"], readonly ["colorlessVariants", "POST", "/api/v1/variants/colorless", "find_colorless_variants"], readonly ["variantSiblings", "GET", "/api/v1/variants/{variantId}/siblings", "list_variant_siblings"], readonly ["colors.nearestPaints", "GET", "/api/v1/colors/nearest-paints", "find_nearest_paints"], readonly ["getCatalogGeneration", "GET", "/api/v1/catalog/generation", "get_catalog_generation"], readonly ["catalogs", "GET", "/api/v1/catalogs", "list_catalog_documents"], readonly ["catalogPages", "GET", "/api/v1/catalogs/{catalogId}/pages", "list_catalog_pages"], readonly ["catalogPageRepresentation", "GET", "/api/v1/catalog-pages/{pageId}/representation", "get_catalog_page_representation"], readonly ["catalogReferences", "GET", "/api/v1/catalogs/{catalogId}/references", "list_catalog_product_references"], readonly ["samplizeCatalog", "GET", "/api/v1/catalogs/samplize/products", "samplize_catalog_products"], readonly ["catalogReferencesForVariants", "POST", "/api/v1/catalogs/references", "get_catalog_references_batch"], readonly ["catalogCollections", "GET", "/api/v1/catalogs/collections", "list_catalog_channel_collections"], readonly ["catalogDocumentAccess", "GET", "/api/v1/catalogs/documents/{documentId}", "get_catalog_document_access"], readonly ["materialBlocks", "GET", "/api/v1/materials/{variantId}/blocks", "list_material_blocks"], readonly ["listVariantAssets", "GET", "/api/v1/variants/{variantId}/assets", "list_variant_assets"], readonly ["materialDocuments", "GET", "/api/v1/materials/{variantId}/documents", "list_material_documents"], readonly ["schema", "GET", "/api/v1/schema/value-dictionaries", "list_schema_value_dictionaries"], readonly ["pairings", "GET", "/api/v1/materials/{variantId}/pairings", "get_material_pairings"], readonly ["associatedFinishes", "GET", "/api/v1/associated/finishes", "list_associated_finishes"], readonly ["associatedProducts", "GET", "/api/v1/associated/products", "list_associated_products"], readonly ["applicability", "GET", "/api/v1/applicability", "get_applicability"], readonly ["listVariants", "GET", "/api/v1/variants", "list_variants"], readonly ["listVariantFacets", "POST", "/api/v1/variants/facets", "list_variant_facets"], readonly ["searchVariants", "POST", "/api/v1/variants/search", "search_variants"], readonly ["findVariantsByColor", "GET", "/api/v1/variants/by-color", "find_variants_by_color"], readonly ["findVariantsByVector", "POST", "/api/v1/variants/by-vector", "find_variants_by_vector"], readonly ["findSampledTogether", "GET", "/api/v1/variants/sampled-together", "find_sampled_together"], readonly ["listSampledTogetherPairs", "GET", "/api/v1/variants/sampled-together/pairs", "list_sampled_together_pairs"], readonly ["resolveVariant", "POST", "/api/v1/variants/resolve", "resolve_variant"], readonly ["getVariant", "GET", "/api/v1/variants/{variantId}", "get_variant"], readonly ["resolveColor", "GET", "/api/v1/search/colors/resolve", "resolve_color_name"], readonly ["listAttributes", "GET", "/api/v1/catalog/attributes", "catalog_list_attributes"], readonly ["listEnumValues", "GET", "/api/v1/catalog/enum-values", "catalog_list_enum_values"], readonly ["categories.list", "GET", "/api/v1/categories", "list_categories"], readonly ["categories.get", "GET", "/api/v1/categories/{id}", "get_category"], readonly ["whoami", "GET", "/api/v1/whoami", "whoami"], readonly ["colors.profiles", "GET", "/api/v1/colors/profiles", "get_category_color_profiles"], readonly ["extractPalette", "POST", "/api/v1/search/palettes/extract", "extract_image_palette"], readonly ["brands", "GET", "/api/v1/brands", "list_brands"], readonly ["uploadSourceMaterial", "POST", "/api/v1/source-material", "upload_source_material"]];
 export type SdkOperationId = (typeof OPERATION_DEFINITIONS)[number][3];
 export type SdkOperation<K extends SdkOperationId = SdkOperationId> = Readonly<{
     clientMethod: (typeof OPERATION_DEFINITIONS)[number][0];

package/operations.generated.js

@@ -1,6 +1,30 @@
 // GENERATED by apps/web/scripts/generate-openapi-v1.ts. Do not edit.
 export const MATERIALGRAPH_API_VERSION = "0.8.0";
 const OPERATION_DEFINITIONS = [
+    [
+        "discoveryReference",
+        "GET",
+        "/api/v1/catalog/discovery-reference",
+        "get_discovery_reference",
+    ],
+    [
+        "interpretDiscoveryTerms",
+        "POST",
+        "/api/v1/catalog/interpret-terms",
+        "interpret_discovery_terms",
+    ],
+    [
+        "colorlessVariants",
+        "POST",
+        "/api/v1/variants/colorless",
+        "find_colorless_variants",
+    ],
+    [
+        "variantSiblings",
+        "GET",
+        "/api/v1/variants/{variantId}/siblings",
+        "list_variant_siblings",
+    ],
     [
         "colors.nearestPaints",
         "GET",
@@ -173,23 +197,5 @@ const OPERATION_DEFINITIONS = [
         "/api/v1/source-material",
         "upload_source_material",
     ],
-    [
-        "workflows.start",
-        "POST",
-        "/api/v1/workflows/{workflowId}/runs",
-        "create_public_run",
-    ],
-    [
-        "workflows.run",
-        "GET",
-        "/api/v1/workflows/{workflowId}/runs/{runId}",
-        "get_public_run",
-    ],
-    [
-        "workflows.streamRunEvents",
-        "GET",
-        "/api/v1/workflows/{workflowId}/runs/{runId}/events",
-        "list_public_run_events",
-    ],
 ];
 export const SDK_OPERATIONS = Object.freeze(OPERATION_DEFINITIONS.map(([clientMethod, method, path, operationId]) => Object.freeze({ clientMethod, method, operationId, path })));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruments/materialgraph",
-  "version": "1.3.0",
+  "version": "2.0.0",
   "type": "module",
   "exports": {
     ".": {
@@ -21,7 +21,7 @@
     }
   },
   "dependencies": {
-    "@materialinstruments/colorscope": "10.6.1"
+    "@materialinstruments/colorscope": "14.0.1"
   },
   "license": "Proprietary",
   "engines": {

package/response-schemas.generated.d.ts

@@ -1,5 +1,5 @@
 /** The API contract version the schemas were generated from. */
 export declare const RESPONSE_SCHEMA_API_VERSION = "0.8.0";
 /** Every SDK operation whose success response has a published JSON Schema. */
-export declare const RESPONSE_SCHEMA_OPERATION_IDS: readonly ["find_nearest_paints", "get_catalog_generation", "list_catalog_documents", "list_catalog_pages", "get_catalog_page_representation", "list_catalog_product_references", "samplize_catalog_products", "get_catalog_references_batch", "list_catalog_channel_collections", "get_catalog_document_access", "list_material_blocks", "list_variant_assets", "list_material_documents", "list_schema_value_dictionaries", "get_material_pairings", "list_associated_finishes", "list_associated_products", "get_applicability", "list_variants", "list_variant_facets", "search_variants", "find_variants_by_color", "find_variants_by_vector", "find_sampled_together", "list_sampled_together_pairs", "resolve_variant", "get_variant", "resolve_color_name", "catalog_list_attributes", "catalog_list_enum_values", "list_categories", "get_category", "whoami", "get_category_color_profiles", "extract_image_palette", "list_brands", "upload_source_material", "create_public_run", "get_public_run"];
+export declare const RESPONSE_SCHEMA_OPERATION_IDS: readonly ["get_discovery_reference", "interpret_discovery_terms", "find_colorless_variants", "list_variant_siblings", "find_nearest_paints", "get_catalog_generation", "list_catalog_documents", "list_catalog_pages", "get_catalog_page_representation", "list_catalog_product_references", "samplize_catalog_products", "get_catalog_references_batch", "list_catalog_channel_collections", "get_catalog_document_access", "list_material_blocks", "list_variant_assets", "list_material_documents", "list_schema_value_dictionaries", "get_material_pairings", "list_associated_finishes", "list_associated_products", "get_applicability", "list_variants", "list_variant_facets", "search_variants", "find_variants_by_color", "find_variants_by_vector", "find_sampled_together", "list_sampled_together_pairs", "resolve_variant", "get_variant", "resolve_color_name", "catalog_list_attributes", "catalog_list_enum_values", "list_categories", "get_category", "whoami", "get_category_color_profiles", "extract_image_palette", "list_brands", "upload_source_material"];
 export declare const RESPONSE_SCHEMA_CATALOG_JSON: string;