@instruments/materialgraph 1.4.0 → 2.1.0

package/catalog-client.d.ts

@@ -1,8 +1,7 @@
-import type { CatalogDocumentList, CatalogPageListResult, CatalogProductReferenceReadResult, CatalogChannelCollectionsResponse, CatalogCollectionsOptions, CatalogDocumentAccessResult, CatalogPageRepresentationReadResult, CatalogReferenceBatchResponse } from "./catalog-types.js";
+import type { CatalogDocumentList, CatalogPageListResult, CatalogProductReferenceReadResult, CatalogDocumentAccessResult, CatalogPageRepresentationReadResult, CatalogReferenceBatchResponse } from "./catalog-types.js";
 import type { HttpTransport } from "./http-transport.js";
 import type { VariantId } from "./identifiers.js";
 import type { ResolveVariantInput, ResolveVariantOutput } from "./resolve-variant-types.js";
-import type { SamplizeCatalogOptions, SamplizeCatalogPage } from "./samplize-catalog-types.js";
 /** Catalog publication operations inherited by the public SDK client. */
 export declare class CatalogClient {
     #private;
@@ -20,8 +19,6 @@ export declare class CatalogClient {
      * never a guess. The submitted URL is never persisted.
      */
     resolveVariant(input: ResolveVariantInput, signal?: AbortSignal): Promise<ResolveVariantOutput>;
-    /** Complete version-pinned Samplize paint corpus; stock never limits eligibility. */
-    samplizeCatalog(options?: SamplizeCatalogOptions, signal?: AbortSignal): Promise<SamplizeCatalogPage>;
     /**
      * Read exact, verified brand-publication page relationships for variants.
      * Missing evidence stays explicit; this operation never guesses a page from
@@ -30,8 +27,6 @@ export declare class CatalogClient {
     catalogReferencesForVariants(input: {
         variantIds: VariantId[];
     }, signal?: AbortSignal): Promise<CatalogReferenceBatchResponse>;
-    /** List product collections with governed catalog-channel membership. */
-    catalogCollections(options?: CatalogCollectionsOptions, signal?: AbortSignal): Promise<CatalogChannelCollectionsResponse>;
     /** List immutable catalog documents retained from verified source material. */
     catalogs(signal?: AbortSignal): Promise<CatalogDocumentList>;
     /** List stable one-based page identities and their representation status. */

package/catalog-client.js

@@ -20,10 +20,6 @@ export class CatalogClient {
     async resolveVariant(input, signal) {
         return await this.#transport.requestJson(resolveOperation("resolve_variant"), { body: input, signal });
     }
-    /** Complete version-pinned Samplize paint corpus; stock never limits eligibility. */
-    async samplizeCatalog(options = {}, signal) {
-        return await this.#transport.requestJson(resolveOperation("samplize_catalog_products"), { query: { ...options }, signal });
-    }
     /**
      * Read exact, verified brand-publication page relationships for variants.
      * Missing evidence stays explicit; this operation never guesses a page from
@@ -32,17 +28,6 @@ export class CatalogClient {
     async catalogReferencesForVariants(input, signal) {
         return await this.#transport.requestJson(resolveOperation("get_catalog_references_batch"), { body: input, signal });
     }
-    /** List product collections with governed catalog-channel membership. */
-    async catalogCollections(options = {}, signal) {
-        return await this.#transport.requestJson(resolveOperation("list_catalog_channel_collections"), {
-            query: {
-                limit: options.limit,
-                offset: options.offset,
-                sampleLimit: options.sampleLimit,
-            },
-            signal,
-        });
-    }
     /** List immutable catalog documents retained from verified source material. */
     async catalogs(signal) {
         return await this.#transport.requestJson(resolveOperation("list_catalog_documents"), { signal });

package/catalog-types.d.ts

@@ -125,49 +125,6 @@ export type CatalogReferenceBatchResponse = {
         upstreamFailure: number;
     };
 };
-/** Bounds for the flat catalog-channel collection shelf. */
-export type CatalogCollectionsOptions = {
-    limit?: number;
-    offset?: number;
-    sampleLimit?: number;
-};
-/** One representative product image carried by a catalog collection. */
-export type CatalogCollectionSampleProduct = {
-    imageUrl: string | null;
-    hex?: string | null;
-    productId: string;
-    productName: string;
-    variantId: string;
-    variantName: string | null;
-};
-/** A product collection whose variants have governed catalog membership. */
-export type CatalogChannelCollection = {
-    id: string;
-    slug: string;
-    name: string;
-    homepageUrl: string | null;
-    productCount: number;
-    variantCount: number;
-    sampleProducts: CatalogCollectionSampleProduct[];
-};
-/** The flat, paginated catalog-channel collection read model. */
-export type CatalogChannelCollectionsResponse = {
-    collections: CatalogChannelCollection[];
-    channel: {
-        token: "catalog";
-        basis: "governed_variant_membership";
-    };
-    counts: {
-        basis: "exact_current_channel_membership";
-    };
-    pagination: {
-        count: number;
-        total: number;
-        limit: number;
-        offset: number;
-        hasMore: boolean;
-    };
-};
 export type CatalogDocumentAccess = {
     documentId: string;
     contentType: "application/pdf";

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

@@ -16,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";
 /**
@@ -41,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}
@@ -89,14 +87,6 @@ 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. */

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;

package/colors-client.d.ts

@@ -35,7 +35,7 @@ export type ColorsTransport = {
 export declare class ColorsClient {
     #private;
     constructor(transport: ColorsTransport);
-    /** Nearest Samplize catalog paints for up to twelve hexes, deduplicated in input order. */
+    /** Nearest paint colors for up to twelve hexes, deduplicated in input order; `searchCatalogSubset` narrows the paint colors. */
     nearestPaints(params: NearestPaintsParams, signal?: AbortSignal): Promise<NearestPaintsOutput>;
     /**
      * THE QUESTION: "what colors does this CATEGORY come in?" - the

package/colors-client.js

@@ -3,9 +3,13 @@ export class ColorsClient {
     constructor(transport) {
         this.#transport = transport;
     }
-    /** Nearest Samplize catalog paints for up to twelve hexes, deduplicated in input order. */
+    /** Nearest paint colors for up to twelve hexes, deduplicated in input order; `searchCatalogSubset` narrows the paint colors. */
     async nearestPaints(params, signal) {
-        return await this.#transport.get("find_nearest_paints", { hex: params.hexes, limit: params.limit }, signal);
+        return await this.#transport.get("find_nearest_paints", {
+            hex: params.hexes,
+            limit: params.limit,
+            searchCatalogSubset: params.searchCatalogSubset,
+        }, signal);
     }
     /**
      * THE QUESTION: "what colors does this CATEGORY come in?" - the

package/find-sampled-together-types.d.ts

@@ -15,8 +15,6 @@ export type SampledTogetherProjectType = "Workplace" | "Residential" | "Institut
 export type FindSampledTogetherInput = {
     /** Optional row fields: image adds imageUrl, color adds swatches. */
     include?: ("image" | "color")[];
-    /** Ops and audit switch: leave sample cards in. Default false. */
-    includeSamplingArtifacts?: boolean;
     /** Materials to return, default 20, at most 100. */
     limit?: number;
     /** Names to resolve when you hold no ids. Misses come back unresolved. */

package/get-variant-types.d.ts

@@ -57,7 +57,7 @@ export type GetVariantOutput = {
     }[];
     attributes: Record<string, {
         value: unknown;
-        valueSource: "brand" | "material_bank" | "samplize" | "measured" | "manual" | null;
+        valueSource: "brand" | "material_bank" | "measured" | "manual" | null;
         wording: string | null;
         level: "variant" | "product" | "brand";
     }>;

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,5 +1,7 @@
 export type { DiscoveryReference, DiscoveryTerms, InterpretDiscoveryTermsInput, ColorlessVariantsResult, VariantSibling, } from "./discovery-context-types.js";
 export { MaterialGraphClient, DEFAULT_BASE_URL } from "./client.js";
+export { PICK_JOB_MAX_LENGTH, SCHEME_BUNDLE_MAX_PICKS, SCHEME_BUNDLE_MIN_PICKS, } from "./scheme-bundle-types.js";
+export type { SchemeBundle, SchemeBundlePick } from "./scheme-bundle-types.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";
 export type { ListVariantFacetsInput, VariantFacetValue, CategoricalVariantFacet, BooleanVariantFacet, NumericVariantFacet, VariantFacet, ListVariantFacetsOutput, } from "./list-variant-facets-types.js";
@@ -14,14 +16,13 @@ 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";
 export type { ResolveVariantInput, ResolveVariantSubject, ResolveVariantEvidence, ResolveVariantReceipt, ResolveVariantUnresolvedReason, ResolveVariantOutput, } from "./resolve-variant-types.js";
-export type { CatalogReference, CatalogReferenceAbsenceReason, CatalogReferencePublication, CatalogReferenceResult, CatalogReferenceBatchResponse, CatalogCollectionsOptions, CatalogCollectionSampleProduct, CatalogChannelCollection, CatalogChannelCollectionsResponse, CatalogDocumentAccess, CatalogDocumentAccessResult, CatalogDocument, CatalogEdition, CatalogAvailableReceipt, CatalogFailureReceipt, UnavailableCatalogDocument, CatalogPublication, CatalogDocumentList, CatalogProductReferenceList, CatalogProductReferenceUnavailable, CatalogProductReferenceReadResult, CatalogPageRequiredArtifact, CatalogPageAvailableArtifact, CatalogPage, CatalogPageListResult, CatalogPageRepresentationReadResult, } from "./catalog-types.js";
+export type { CatalogReference, CatalogReferenceAbsenceReason, CatalogReferencePublication, CatalogReferenceResult, CatalogReferenceBatchResponse, CatalogDocumentAccess, CatalogDocumentAccessResult, CatalogDocument, CatalogEdition, CatalogAvailableReceipt, CatalogFailureReceipt, UnavailableCatalogDocument, CatalogPublication, CatalogDocumentList, CatalogProductReferenceList, CatalogProductReferenceUnavailable, CatalogProductReferenceReadResult, CatalogPageRequiredArtifact, CatalogPageAvailableArtifact, CatalogPage, CatalogPageListResult, CatalogPageRepresentationReadResult, } from "./catalog-types.js";
 export { CategoriesClient } from "./categories-client.js";
 export type { CategoryRef, CategoryKind, CategoryMatch, CategoryItem, CategoriesPageInfo, CategoriesListInput, CategoriesListResult, CategoryConcept, CategoryProductCategory, CategoriesGetResult, } from "./category-types.js";
 export { ColorsClient } from "./colors-client.js";
@@ -32,5 +33,4 @@ export type { BrandsOptions, BrandItem, ListBrandsPage, } from "./brand-types.js
 export type { VariantAssetAvailability, VariantImageRole, VariantImagePresentation, VariantDocumentType, VariantAssetKind, VariantAssetItem, VariantDocumentCoverageState, VariantAssetPageInfo, ListVariantAssetsOptions, VariantAssetPage, MaterialDocumentStatus, MaterialDocumentCoverageState, MaterialDocumentScope, MaterialDocumentSource, MaterialDocumentProjectionItem, MaterialDocumentCoverageSource, MaterialDocumentCoverage, MaterialDocumentCoverageSummary, MaterialDocumentPageOptions, MaterialDocumentPage, } from "./material-asset-types.js";
 export type { MaterialCoverageStatus, MaterialBlockStatus, MaterialBlockFieldStatus, MaterialBlockFieldValue, MaterialBlockProjectionField, MaterialBlockProjectionItem, MaterialBlockProjection, VariantColorPalette, } from "./material-block-types.js";
 export type { SchemaResource, SCHEMA_RESOURCE_OPERATION_IDS, SchemaResourceRequest, SchemaLifecycle, SchemaExternalMapping, SchemaMatchStrength, SchemaValueDictionaryTerm, SchemaValueDictionaryItem, SchemaResourceItemMap, SchemaResourceResponse, } from "./schema-resource-types.js";
-export type { SamplizePublicationSource, SamplizeLrvObservation, SamplizeDemand, SamplizeCollectionMembership, SamplizeCatalogOptions, SamplizeCatalogPage, SamplizeCatalogProduct, SamplizeHexObservation, } from "./samplize-catalog-types.js";
 export type { NearestPaintsParams, NearestPaintCard, NearestPaintsHexResult, NearestPaintsOutput, } from "./nearest-paints-types.js";

package/index.js

@@ -1,7 +1,7 @@
 export { MaterialGraphClient, DEFAULT_BASE_URL } from "./client.js";
+export { PICK_JOB_MAX_LENGTH, SCHEME_BUNDLE_MAX_PICKS, SCHEME_BUNDLE_MIN_PICKS, } from "./scheme-bundle-types.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/nearest-paints-types.d.ts

@@ -1,6 +1,8 @@
+import type { SearchCatalogSubset } from "./search-catalog-subset-types.js";
 export type NearestPaintsParams = {
     hexes: string[];
     limit?: number;
+    searchCatalogSubset?: SearchCatalogSubset;
 };
 export type NearestPaintCard = {
     variantId: string;

package/operation-responses.d.ts

@@ -1,7 +1,7 @@
 /** Response types belong to operation ids, never a caller-selected generic. */
 import type { ApplicabilityResponse, DeclaredAssociationsResponse } from "./association-types.js";
 import type { ListBrandsPage } from "./brand-types.js";
-import type { CatalogDocumentList, CatalogPageListResult, CatalogProductReferenceReadResult, CatalogChannelCollectionsResponse, CatalogDocumentAccessResult, CatalogPageRepresentationReadResult, CatalogReferenceBatchResponse } from "./catalog-types.js";
+import type { CatalogDocumentList, CatalogPageListResult, CatalogProductReferenceReadResult, 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";
@@ -17,10 +17,9 @@ 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;
@@ -33,7 +32,6 @@ export type OperationResponses = {
     };
     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;
@@ -46,7 +44,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;
@@ -54,7 +51,6 @@ export type OperationResponses = {
     list_catalog_documents: CatalogDocumentList;
     list_catalog_pages: CatalogPageListResult;
     list_catalog_product_references: CatalogProductReferenceReadResult;
-    list_catalog_channel_collections: CatalogChannelCollectionsResponse;
     list_categories: CategoriesListResult;
     list_material_blocks: MaterialBlockProjection;
     list_material_documents: MaterialDocumentPage;
@@ -64,7 +60,6 @@ export type OperationResponses = {
     list_variants: ListVariantsOutput;
     resolve_color_name: ResolveColorResponse;
     resolve_variant: ResolveVariantOutput;
-    samplize_catalog_products: SamplizeCatalogPage;
     search_variants: SearchVariantsOutput;
     upload_source_material: SourceMaterialBatchReceipt;
     whoami: WhoamiResponse;

package/operations.generated.d.ts

@@ -1,5 +1,5 @@
 export declare const MATERIALGRAPH_API_VERSION = "0.8.0";
-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"], 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 ["catalogReferencesForVariants", "POST", "/api/v1/catalogs/references", "get_catalog_references_batch"], 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

@@ -56,24 +56,12 @@ const OPERATION_DEFINITIONS = [
         "/api/v1/catalogs/{catalogId}/references",
         "list_catalog_product_references",
     ],
-    [
-        "samplizeCatalog",
-        "GET",
-        "/api/v1/catalogs/samplize/products",
-        "samplize_catalog_products",
-    ],
     [
         "catalogReferencesForVariants",
         "POST",
         "/api/v1/catalogs/references",
         "get_catalog_references_batch",
     ],
-    [
-        "catalogCollections",
-        "GET",
-        "/api/v1/catalogs/collections",
-        "list_catalog_channel_collections",
-    ],
     [
         "catalogDocumentAccess",
         "GET",
@@ -197,23 +185,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.4.0",
+  "version": "2.1.0",
   "type": "module",
   "exports": {
     ".": {
@@ -11,17 +11,13 @@
       "types": "./webmcp.d.ts",
       "import": "./webmcp.js"
     },
-    "./samplize-colorvec": {
-      "types": "./samplize-colorvec.d.ts",
-      "import": "./samplize-colorvec.js"
-    },
     "./response-schemas": {
       "types": "./response-schemas.d.ts",
       "import": "./response-schemas.js"
     }
   },
   "dependencies": {
-    "@materialinstruments/colorscope": "10.6.1"
+    "@materialinstruments/colorscope": "14.0.1"
   },
   "license": "Proprietary",
   "engines": {

package/resolve-color-types.d.ts

@@ -26,12 +26,6 @@ export type ResolveColorCatalogVariant = {
     };
     /** Whether the variant is in the requested scope; null when none was asked for. */
     inScope: boolean | null;
-    /**
-     * True when the stored brand is Samplize, a sampling channel, and the listing
-     * is not Samplize's own: the color is another brand's, so `brand` is not who
-     * made it. The variant is still the right one for the name.
-     */
-    parentageSuspect: boolean;
 };
 /**
  * Whether the named paint is a variant in the catalog. Exact, global, and

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 ["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", "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", "get_catalog_references_batch", "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;