@instruments/materialgraph 0.36.0 → 0.37.1

package/by-spec-types.d.ts

@@ -1,5 +1,4 @@
 import type { ValueResolution } from "./catalog-discovery-types.js";
-import type { VerdictCitation } from "./citation-types.js";
 /**
  * The six states a verdict cell can report — and what each licenses you to say.
  *
@@ -58,7 +57,6 @@ export type BySpecVerdictCell = {
      *  - `basis_unmet` — the value's source is weaker than the criterion demanded.
      */
     trustGap: "below_confidence" | "basis_unmet" | null;
-    citation?: VerdictCitation;
 };
 /**
  * A match's full report card: every cell, the rolled-up grade, weakest confidence.

package/client.d.ts

@@ -2,7 +2,6 @@ import type { ApplicabilityOptions, AssociatedOptions } from "./association-type
 import type { BrandsOptions } from "./brand-types.js";
 import { CatalogueClient } from "./catalogue-client.js";
 import { CategoriesClient } from "./categories-client.js";
-import type { ResolvedVerdictCitation } from "./citation-types.js";
 import type { MaterialGraphClientOptions } from "./client-config.js";
 import { ColorsClient } from "./colors-client.js";
 import type { RateLimit } from "./errors.js";
@@ -184,7 +183,8 @@ export declare class MaterialGraphClient extends CatalogueClient {
      * to narrow or widen the same search; page with this method's own cursor,
      * which `listVariants()` refuses. A phrase with several meanings is
      * answered with one and listed in `choices`; send its `handle` with an
-     * alternative's `group` and `id` in `selections` to switch it. A query that
+     * alternative's `group` and `id` in `selections` to switch it, or its
+     * `text` in `leaveOut` to drop the condition. A query that
      * applies nothing returns no items, never the whole catalogue; a preference
      * alone still ranks it.
      */
@@ -265,6 +265,4 @@ export declare class MaterialGraphClient extends CatalogueClient {
      * `mg:source` scope, which a `source`, `ingest` or `admin` key carries.
      */
     uploadSourceMaterial(input: UploadSourceMaterialInput, signal?: AbortSignal): Promise<SourceMaterialBatchReceipt>;
-    /** Follow a verdict cell's citation handle to its canonical claim source. */
-    citation(citationId: string, signal?: AbortSignal): Promise<ResolvedVerdictCitation>;
 }

package/client.js

@@ -262,7 +262,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * to narrow or widen the same search; page with this method's own cursor,
      * which `listVariants()` refuses. A phrase with several meanings is
      * answered with one and listed in `choices`; send its `handle` with an
-     * alternative's `group` and `id` in `selections` to switch it. A query that
+     * alternative's `group` and `id` in `selections` to switch it, or its
+     * `text` in `leaveOut` to drop the condition. A query that
      * applies nothing returns no items, never the whole catalogue; a preference
      * alone still ranks it.
      */
@@ -378,8 +379,4 @@ export class MaterialGraphClient extends CatalogueClient {
     async uploadSourceMaterial(input, signal) {
         return await uploadSourceMaterial(this.#transport, input, signal);
     }
-    /** Follow a verdict cell's citation handle to its canonical claim source. */
-    async citation(citationId, signal) {
-        return await this.#get("get_verdict_citation", undefined, signal, { citationId });
-    }
 }

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

@@ -2,9 +2,9 @@
  * @module find-sampled-together-types
  * @description Hand-maintained mirror of `find_sampled_together`'s (MG-2332) input and
  * output wire shapes. The source of truth is
- * `packages/products/src/cospec/schema.ts` (`findSampledTogetherInputSchema`,
+ * `packages/sampling/src/schema.ts` (`findSampledTogetherInputSchema`,
  * `findSampledTogetherResultSchema`). This SDK has no RUNTIME dependency on
- * `@materialgraph/products` (it's a devDependency only, for the parity tests in
+ * `@materialgraph/sampling` (it's a devDependency only, for the parity tests in
  * `__tests__/`), so the shapes are copied here rather than imported.
  * `contract-parity.test.ts` keeps this mirror honest against the server types,
  * the project-type list included.

package/find-sampled-together-types.js

@@ -2,9 +2,9 @@
  * @module find-sampled-together-types
  * @description Hand-maintained mirror of `find_sampled_together`'s (MG-2332) input and
  * output wire shapes. The source of truth is
- * `packages/products/src/cospec/schema.ts` (`findSampledTogetherInputSchema`,
+ * `packages/sampling/src/schema.ts` (`findSampledTogetherInputSchema`,
  * `findSampledTogetherResultSchema`). This SDK has no RUNTIME dependency on
- * `@materialgraph/products` (it's a devDependency only, for the parity tests in
+ * `@materialgraph/sampling` (it's a devDependency only, for the parity tests in
  * `__tests__/`), so the shapes are copied here rather than imported.
  * `contract-parity.test.ts` keeps this mirror honest against the server types,
  * the project-type list included.

package/find-variants-by-color-types.d.ts

@@ -3,11 +3,11 @@ import type { ImageReferenceInput } from "./image-reference-types.js";
  * @module find-variants-by-color-types
  * @description Hand-maintained mirror of `find_variants_by_color`'s
  * (MG-2217/MG-2230/MG-2247/MG-2328) input and output wire shapes. The source
- * of truth is `packages/products/src/search/find-variants-by-color.ts` —
+ * of truth is `packages/search/src/find-variants-by-color.ts` —
  * `rerank`'s `reference.candidates`/`reference.seed` still mirror
  * `compare-color-similarity.ts`'s own seed shape, but its `matches[]` card
  * is the same shape CONTAINS/PALETTE use, not a copy of that module's result.
- * This SDK has no RUNTIME dependency on `@materialgraph/products` (it's a
+ * This SDK has no RUNTIME dependency on `@materialgraph/search` (it's a
  * devDependency only, for the parity tests in `__tests__/`), so the shapes
  * are copied here rather than imported. `contract-parity.test.ts` keeps this
  * mirror honest against the server types.

package/find-variants-by-vector-types.d.ts

@@ -2,8 +2,8 @@
  * @module find-variants-by-vector-types
  * @description Hand-maintained mirror of `find_variants_by_vector`'s
  * (MG-2231) input and output wire shapes. The source of truth is
- * `packages/products/src/vector-discovery/find-variants-by-vector.ts`; this
- * SDK has no runtime dependency on `@materialgraph/products`, so the shapes
+ * `packages/search/src/vector-discovery/find-variants-by-vector.ts`; this
+ * SDK has no runtime dependency on `@materialgraph/search`, so the shapes
  * are copied here and `contract-parity.test.ts` keeps them honest.
  */
 import type { ImageReferenceInput } from "./image-reference-types.js";

package/get-variant-types.d.ts

@@ -2,8 +2,8 @@
  * @module get-variant-types
  * @description Hand-maintained mirror of `get_variant`'s (MG-2251) input and
  * output wire shapes. The source of truth is
- * `packages/products/src/variants/get-variant.ts`, but this SDK has no RUNTIME
- * dependency on `@materialgraph/products`, so the shapes are copied here and
+ * `packages/catalog/src/variants/get-variant.ts`, but this SDK has no RUNTIME
+ * dependency on `@materialgraph/catalog`, so the shapes are copied here and
  * `__tests__/contract-parity.test.ts` keeps the mirror honest against the
  * server types.
  */

package/get-variant-types.js

@@ -2,8 +2,8 @@
  * @module get-variant-types
  * @description Hand-maintained mirror of `get_variant`'s (MG-2251) input and
  * output wire shapes. The source of truth is
- * `packages/products/src/variants/get-variant.ts`, but this SDK has no RUNTIME
- * dependency on `@materialgraph/products`, so the shapes are copied here and
+ * `packages/catalog/src/variants/get-variant.ts`, but this SDK has no RUNTIME
+ * dependency on `@materialgraph/catalog`, so the shapes are copied here and
  * `__tests__/contract-parity.test.ts` keeps the mirror honest against the
  * server types.
  */

package/image-reference-types.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module image-reference-types
  * @description The one image-reference shape the vector-discovery lenses
- * share (`@materialgraph/products/vector-discovery/image-reference`'s
+ * share (`@materialgraph/search/vector-discovery/image-reference`'s
  * `imageReferenceInputSchema`): a catalogue asset, an upload, a public URL,
  * or an existing variant's own image. Exactly one field is set per call; the
  * server refuses more than one.

package/index.d.ts

@@ -15,7 +15,6 @@ export type { SdkOperation, SdkOperationId } from "./operations.js";
 export type * from "./identifiers.js";
 export { TERMINAL_RUN_EVENT_TYPES } from "./run-types.js";
 export type * from "./run-types.js";
-export type * from "./citation-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 * from "./types.js";

package/list-enum-values-types.d.ts

@@ -2,8 +2,8 @@
  * @module list-enum-values-types
  * @description Hand-maintained mirror of `list_enum_values`'s (MG-2225) input
  * and output wire shapes. The source of truth is
- * `packages/products/src/materials/list-enum-values.ts`; this SDK has no
- * runtime dependency on `@materialgraph/products`, so the shapes are copied
+ * `packages/search/src/browse/list-enum-values.ts`; this SDK has no
+ * runtime dependency on `@materialgraph/search`, so the shapes are copied
  * here and `contract-parity.test.ts` keeps them honest.
  */
 import type { OpenEnum } from "./types.js";

package/list-variant-facets-types.d.ts

@@ -3,9 +3,9 @@ import type { FilterGroups } from "./list-variants-types.js";
  * @module list-variant-facets-types
  * @description Hand-maintained mirror of `list_variant_facets`'s (MG-2294)
  * input and output wire shapes. The source of truth is
- * `packages/products/src/variants/list-variant-facets.ts` (the input) and
+ * `packages/search/src/variants/list-variant-facets.ts` (the input) and
  * `list-variant-facets-contract.ts` (the output); this SDK has no runtime
- * dependency on `@materialgraph/products`, so the shapes are copied here and
+ * dependency on `@materialgraph/search`, so the shapes are copied here and
  * `contract-parity.test.ts` keeps them honest.
  */
 import type { SearchCatalogueSubset } from "./search-catalogue-subset-types.js";

package/list-variants-types.d.ts

@@ -2,9 +2,9 @@
  * @module list-variants-types
  * @description Hand-maintained mirror of `list_variants`'s (MG-2222) input and
  * output wire shapes. The source of truth is
- * `packages/products/src/variants/variant-conditions.ts` (the filter grammar)
- * and `packages/products/src/variants/list-variants-contract.ts` (the output),
- * but this SDK has no RUNTIME dependency on `@materialgraph/products` (it's a
+ * `packages/search/src/variants/variant-conditions.ts` (the filter grammar)
+ * and `packages/search/src/variants/list-variants-contract.ts` (the output),
+ * but this SDK has no RUNTIME dependency on `@materialgraph/search` (it's a
  * devDependency only, for the parity tests in `__tests__/`), so the shapes are
  * copied here rather than imported. `contract-parity.test.ts` keeps this
  * mirror honest against the server types.

package/list-variants-types.js

@@ -2,9 +2,9 @@
  * @module list-variants-types
  * @description Hand-maintained mirror of `list_variants`'s (MG-2222) input and
  * output wire shapes. The source of truth is
- * `packages/products/src/variants/variant-conditions.ts` (the filter grammar)
- * and `packages/products/src/variants/list-variants-contract.ts` (the output),
- * but this SDK has no RUNTIME dependency on `@materialgraph/products` (it's a
+ * `packages/search/src/variants/variant-conditions.ts` (the filter grammar)
+ * and `packages/search/src/variants/list-variants-contract.ts` (the output),
+ * but this SDK has no RUNTIME dependency on `@materialgraph/search` (it's a
  * devDependency only, for the parity tests in `__tests__/`), so the shapes are
  * copied here rather than imported. `contract-parity.test.ts` keeps this
  * mirror honest against the server types.

package/operations.d.ts

@@ -1,5 +1,5 @@
 export declare const MATERIALGRAPH_API_VERSION = "0.8.0";
-declare const OPERATION_DEFINITIONS: readonly [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 ["samplizeCatalogue", "GET", "/api/v1/catalogues/samplize/products", "samplize_catalogue_products"], readonly ["catalogueReferences", "POST", "/api/v1/catalogues/references", "get_catalogue_references_batch"], readonly ["catalogueCollections", "GET", "/api/v1/catalogues/collections", "list_catalogue_channel_collections"], readonly ["catalogueDocumentAccess", "GET", "/api/v1/catalogues/documents/{documentId}", "get_catalogue_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", "POST", "/api/v1/variants/by-color", "find_variants_by_color"], readonly ["findVariantsByVector", "POST", "/api/v1/variants/by-vector", "find_variants_by_vector"], readonly ["findSampledTogether", "POST", "/api/v1/variants/sampled-together", "find_sampled_together"], 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 ["citation", "GET", "/api/v1/citations/{citationId}", "get_verdict_citation"], readonly ["workflows.streamRunEvents", "GET", "/api/v1/workflows/{workflowId}/runs/{runId}/events", "list_public_run_events"]];
+declare const OPERATION_DEFINITIONS: readonly [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 ["samplizeCatalogue", "GET", "/api/v1/catalogues/samplize/products", "samplize_catalogue_products"], readonly ["catalogueReferences", "POST", "/api/v1/catalogues/references", "get_catalogue_references_batch"], readonly ["catalogueCollections", "GET", "/api/v1/catalogues/collections", "list_catalogue_channel_collections"], readonly ["catalogueDocumentAccess", "GET", "/api/v1/catalogues/documents/{documentId}", "get_catalogue_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", "POST", "/api/v1/variants/by-color", "find_variants_by_color"], readonly ["findVariantsByVector", "POST", "/api/v1/variants/by-vector", "find_variants_by_vector"], readonly ["findSampledTogether", "POST", "/api/v1/variants/sampled-together", "find_sampled_together"], 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"]];
 export type SdkOperationId = (typeof OPERATION_DEFINITIONS)[number][3];
 export type SdkOperation = Readonly<{
     clientMethod: (typeof OPERATION_DEFINITIONS)[number][0];

package/operations.js

@@ -167,7 +167,6 @@ const OPERATION_DEFINITIONS = [
         "/api/v1/workflows/{workflowId}/runs/{runId}",
         "get_public_run",
     ],
-    ["citation", "GET", "/api/v1/citations/{citationId}", "get_verdict_citation"],
     [
         "workflows.streamRunEvents",
         "GET",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruments/materialgraph",
-  "version": "0.36.0",
+  "version": "0.37.1",
   "type": "module",
   "exports": {
     ".": {

package/resolve-variant-types.d.ts

@@ -3,7 +3,7 @@
  * `resolve_variant` contract).
  *
  * These intentionally mirror the domain-owned Zod contract
- * (`@materialgraph/products/identify-contract`) rather than importing it: the
+ * (`@materialgraph/catalog/identify-contract`) rather than importing it: the
  * published SDK must carry no workspace package dependency.
  */
 /**

package/resolve-variant-types.js

@@ -3,7 +3,7 @@
  * `resolve_variant` contract).
  *
  * These intentionally mirror the domain-owned Zod contract
- * (`@materialgraph/products/identify-contract`) rather than importing it: the
+ * (`@materialgraph/catalog/identify-contract`) rather than importing it: the
  * published SDK must carry no workspace package dependency.
  */
 export {};

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 ["list_catalog_documents", "list_catalog_pages", "get_catalog_page_representation", "list_catalog_product_references", "samplize_catalogue_products", "get_catalogue_references_batch", "list_catalogue_channel_collections", "get_catalogue_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", "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", "get_verdict_citation"];
+export declare const RESPONSE_SCHEMA_OPERATION_IDS: readonly ["list_catalog_documents", "list_catalog_pages", "get_catalog_page_representation", "list_catalog_product_references", "samplize_catalogue_products", "get_catalogue_references_batch", "list_catalogue_channel_collections", "get_catalogue_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", "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_CATALOGUE_JSON: string;