@instruments/materialgraph 0.24.0 → 0.26.0

package/client.js

@@ -1,28 +1,26 @@
-import { CatalogueClient } from "./catalogue-client.js";
-import { DEFAULT_BASE_URL, MAX_BATCH_IDS } from "./client-config.js";
-import { MaterialGraphError } from "./errors.js";
-import { HttpTransport } from "./http-transport.js";
-// Aliased to `operation` — the local name every call site here already used.
-import { resolveOperation as operation, } from "./operations.js";
-import { cancelRun, capabilities as capabilitiesRun, createRun, drainRunEvents, getRun, getRunSchedule, getSourceMaterialBatch as getSourceMaterialBatchCall, listRuns, resumeRun, streamRunEvents, uploadSourceMaterial, } from "./runs.js";
-import { ScheduleReferencesClient } from "./schedule-references-client.js";
-// Re-exported whole so `index.ts` and every existing importer keep their path.
-export * from "./client-config.js";
-import { browseQuery, createBrowseNamespace, } from "./client-browse.js";
-import { createExplorationNamespace, } from "./client-exploration.js";
-import { createSourceMaterialCommentsNamespace, } from "./client-source-material-comments.js";
 import * as assoc from "./associations-client.js";
 import { brandColourDeck, brandProfile, listBrands } from "./brands-client.js";
+import { CatalogueClient } from "./catalogue-client.js";
+import { browseQuery, createBrowseNamespace } from "./client-browse.js";
+import { DEFAULT_BASE_URL, MAX_BATCH_IDS } from "./client-config.js";
+import { createExplorationNamespace } from "./client-exploration.js";
+import { createSourceMaterialCommentsNamespace } from "./client-source-material-comments.js";
 import { colourFacets as colourFacetsCall, resolveAttribute as resolveAttributeCall, resolveAttributeValue as resolveAttributeValueCall, resolveColour as resolveColourCall, suggest as suggestCall, suggestColour as suggestColourCall, } from "./client-vocabulary.js";
 import { CodesClient } from "./codes-client.js";
 import { ColoursClient } from "./colours-client.js";
 import { slotPools as slotPoolsCall, varyScheme as varySchemeCall, } from "./composition-client.js";
 import { coordinate as coordinateCall } from "./coordinate-client.js";
+import { MaterialGraphError } from "./errors.js";
+import { HttpTransport } from "./http-transport.js";
 import { matchStream as matchStreamCall } from "./match-stream.js";
 import { materialAssets as materialAssetsCall, materialRenderAssets as materialRenderAssetsCall, materialBlocks as materialBlocksCall, materialDocuments as materialDocumentsCall, } from "./material-resources-client.js";
-import { appendProjectEvent as appendProjectEventCall, createProject as createProjectCall, getProject as getProjectCall, listProjects as listProjectsCall, } from "./projects.js";
+// Aliased to `operation` — the local name every call site here already used.
+import { resolveOperation as operation } from "./operations.js";
 import { resolvePhrasesRequest as resolvePhrases, searchVocabularyRequest, } from "./resolve-client.js";
+import { cancelRun, capabilities as capabilitiesRun, createRun, drainRunEvents, getRun, getSourceMaterialBatch as getSourceMaterialBatchCall, listRuns, resumeRun, streamRunEvents, uploadSourceMaterial, } from "./runs.js";
 import { SCHEMA_RESOURCE_OPERATION_IDS } from "./schema-resource-types.js";
+// Re-exported whole so `index.ts` and every existing importer keep their path.
+export * from "./client-config.js";
 /**
  * The MaterialGraph client — every lens on the graph, on one object.
  *
@@ -59,7 +57,6 @@ import { SCHEMA_RESOURCE_OPERATION_IDS } from "./schema-resource-types.js";
  * `./identifiers.ts`), absent is not false, and a page is not a corpus.
  */
 export class MaterialGraphClient extends CatalogueClient {
-    scheduleReferences;
     baseUrl;
     /**
      * THE QUESTION: "show me everything in this category / this brand, in a plain
@@ -123,15 +120,14 @@ export class MaterialGraphClient extends CatalogueClient {
         super(transport);
         this.#transport = transport;
         this.baseUrl = transport.baseUrl;
-        this.scheduleReferences = new ScheduleReferencesClient(transport);
-        this.browse = createBrowseNamespace((params, signal) => this.#get("search_browse_by_colour", browseQuery(params), signal));
+        this.browse = createBrowseNamespace(async (params, signal) => await this.#get("search_browse_by_colour", browseQuery(params), signal));
         this.codes = new CodesClient({
-            get: (operationId, query, signal) => this.#get(operationId, query, signal),
-            post: (operationId, body, signal) => this.#post(operationId, body, signal),
+            get: async (operationId, query, signal) => await this.#get(operationId, query, signal),
+            post: async (operationId, body, signal) => await this.#post(operationId, body, signal),
         });
         this.colours = new ColoursClient({
-            get: (operationId, query, signal) => this.#get(operationId, query, signal),
-            post: (operationId, body, signal) => this.#post(operationId, body, signal),
+            get: async (operationId, query, signal) => await this.#get(operationId, query, signal),
+            post: async (operationId, body, signal) => await this.#post(operationId, body, signal),
         });
         this.exploration = createExplorationNamespace(this.#transport);
         this.sourceMaterialComments = createSourceMaterialCommentsNamespace(this.#transport);
@@ -139,18 +135,18 @@ export class MaterialGraphClient extends CatalogueClient {
     get lastRateLimit() {
         return this.#transport.lastRateLimit;
     }
-    #get(operationId, query, signal, pathParams) {
-        return this.#transport.requestJson(operation(operationId), {
+    async #get(operationId, query, signal, pathParams) {
+        return await this.#transport.requestJson(operation(operationId), {
+            pathParams,
             query,
             signal,
-            pathParams,
         });
     }
-    #post(operationId, body, signal, pathParams) {
-        return this.#transport.requestJson(operation(operationId), {
+    async #post(operationId, body, signal, pathParams) {
+        return await this.#transport.requestJson(operation(operationId), {
             body,
-            signal,
             pathParams,
+            signal,
         });
     }
     /**
@@ -168,12 +164,12 @@ export class MaterialGraphClient extends CatalogueClient {
      * specification gates onto ranked colour/visual/lexical/seed search. Build
      * them with `certificationProgramme`, `specTerm`, or `hasSpec`.
      */
-    search(input, signal) {
-        return this.#post("search_materials_post", input, signal);
+    async search(input, signal) {
+        return await this.#post("search_materials_post", input, signal);
     }
     /** Whole materials ask → inspectable meanings and complete safe search requests. */
-    planQuery(query, signal) {
-        return this.#post("plan_material_query", { query }, signal);
+    async planQuery(query, signal) {
+        return await this.#post("plan_material_query", { query }, signal);
     }
     /**
      * The same question as {@link MaterialGraphClient.search}; the difference is
@@ -181,8 +177,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * a URL. `filters`, `preferences`, `verdicts`, image bytes and `weights` have
      * no query-string form, so anything using those must go through `search`.
      */
-    searchGet(params, signal) {
-        return this.#get("search_materials_get", { ...params }, signal);
+    async searchGet(params, signal) {
+        return await this.#get("search_materials_get", { ...params }, signal);
     }
     /**
      * THE QUESTION: "what materials are in this PHOTO?" — Material Match classifies
@@ -197,8 +193,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * `droppedBelowFloor` before reporting an empty result: "nothing was good
      * enough" and "nothing was found" are different answers.
      */
-    match(input, signal) {
-        return this.#post("match_material", input, signal);
+    async match(input, signal) {
+        return await this.#post("match_material", input, signal);
     }
     /**
      * Material Match as a PROGRESSIVE stream — the same POST
@@ -238,21 +234,21 @@ export class MaterialGraphClient extends CatalogueClient {
      * Report matches as visual likeness, never a stated colour specification.
      * `family` gates to ONE colorscope family (a gated page can be short); `brand` gates to named brands — one brand's nearest colour to another's.
      */
-    byColour(params, signal) {
-        return this.#get("search_by_colour", {
-            q: params.q,
-            hex: params.hex,
-            colour: params.colour,
-            l: params.l,
+    async byColour(params, signal) {
+        return await this.#get("search_by_colour", {
             a: params.a,
             b: params.b,
-            category: params.category,
             brand: params.brand,
-            family: params.family,
-            order: params.order,
-            maxColourDistance: params.maxColourDistance,
+            category: params.category,
+            colour: params.colour,
             corpusScope: params.corpusScope,
+            family: params.family,
+            hex: params.hex,
+            l: params.l,
             limit: params.limit,
+            maxColourDistance: params.maxColourDistance,
+            order: params.order,
+            q: params.q,
         }, signal);
     }
     // ── Materials ──────────────────────────────────────────────────────────────
@@ -269,8 +265,8 @@ export class MaterialGraphClient extends CatalogueClient {
      *
      * @param variantId Opaque — pass back exactly what you were given.
      */
-    material(variantId, options, signal) {
-        return this.#get("get_material", options?.includeSiblings ? { include: "siblings" } : undefined, signal, { variantId });
+    async material(variantId, options, signal) {
+        return await this.#get("get_material", options?.includeSiblings ? { include: "siblings" } : undefined, signal, { variantId });
     }
     /**
      * THE QUESTION: "what other colourways and finishes does this product come in?"
@@ -279,20 +275,20 @@ export class MaterialGraphClient extends CatalogueClient {
      * Instead use {@link MaterialGraphClient.pairings} for a DIFFERENT product that
      * goes with this one, and `search({ similarTo })` for one that LOOKS like it.
      */
-    siblings(variantId, signal) {
-        return this.#get("get_material_siblings", undefined, signal, { variantId });
+    async siblings(variantId, signal) {
+        return await this.#get("get_material_siblings", undefined, signal, { variantId });
     }
-    materialBlocks(variantId, signal) {
-        return materialBlocksCall(this.#transport, variantId, signal);
+    async materialBlocks(variantId, signal) {
+        return await materialBlocksCall(this.#transport, variantId, signal);
     }
-    materialAssets(variantId, signal) {
-        return materialAssetsCall(this.#transport, variantId, signal);
+    async materialAssets(variantId, signal) {
+        return await materialAssetsCall(this.#transport, variantId, signal);
     }
-    materialRenderAssets(variantId, signal) {
-        return materialRenderAssetsCall(this.#transport, variantId, signal);
+    async materialRenderAssets(variantId, signal) {
+        return await materialRenderAssetsCall(this.#transport, variantId, signal);
     }
-    materialDocuments(variantId, options, signal) {
-        return materialDocumentsCall(this.#transport, variantId, options, signal);
+    async materialDocuments(variantId, options, signal) {
+        return await materialDocumentsCall(this.#transport, variantId, options, signal);
     }
     /**
      * THE QUESTION: "what does the schema DEFINE?" — the governed static registry.
@@ -301,8 +297,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * what the corpus actually holds and {@link MaterialGraphClient.glossary} to
      * explain one term.
      */
-    schema(resource, signal) {
-        return this.#get(SCHEMA_RESOURCE_OPERATION_IDS[resource], undefined, signal);
+    async schema(resource, signal) {
+        return await this.#get(SCHEMA_RESOURCE_OPERATION_IDS[resource], undefined, signal);
     }
     /**
      * THE QUESTION: "what goes WITH this material?" — the companionship rail, hung
@@ -318,78 +314,78 @@ export class MaterialGraphClient extends CatalogueClient {
      * look-alike). Only `cospec` supports "sampled together". `cospecCount` tells
      * you how much of the rail is real order evidence.
      */
-    pairings(variantId, options, signal) {
-        return this.#get("get_material_pairings", { ...options }, signal, {
+    async pairings(variantId, options, signal) {
+        return await this.#get("get_material_pairings", { ...options }, signal, {
             variantId,
         });
     }
     /** Find bounded, exact-spec substitutes for one opaque variant id. */
-    findSubstitutes(variantId, options = {}, signal) {
-        return this.#post("find_material_substitutes", options, signal, { variantId });
+    async findSubstitutes(variantId, options = {}, signal) {
+        return await this.#post("find_material_substitutes", options, signal, { variantId });
     }
     /** "What finishes does the manufacturer declare for THIS product?" — {@link declaredFinishes}. */
-    associatedFinishes(variantId, options, signal) {
-        return assoc.declaredFinishes(this.#transport, variantId, options, signal);
+    async associatedFinishes(variantId, options, signal) {
+        return await assoc.declaredFinishes(this.#transport, variantId, options, signal);
     }
     /** "What products does the manufacturer declare THIS finish for?" — {@link declaredProducts}. */
-    associatedProducts(variantId, options, signal) {
-        return assoc.declaredProducts(this.#transport, variantId, options, signal);
+    async associatedProducts(variantId, options, signal) {
+        return await assoc.declaredProducts(this.#transport, variantId, options, signal);
     }
-    applicability(options, signal) {
-        return assoc.applicability(this.#transport, options, signal);
+    async applicability(options, signal) {
+        return await assoc.applicability(this.#transport, options, signal);
     }
-    materials(ids, options, signal) {
+    async materials(ids, options, signal) {
         if (ids.length > MAX_BATCH_IDS) {
             throw MaterialGraphError.unexpected(`MaterialGraphClient.materials(): at most ${MAX_BATCH_IDS} ids per call, received ${ids.length}. Split into multiple batches.`);
         }
-        return this.#post("get_materials_batch_post", {
+        return await this.#post("get_materials_batch_post", {
+            idKind: options?.idKind ?? "variantId",
             ids,
             view: options?.view ?? "tile",
-            idKind: options?.idKind ?? "variantId",
         }, signal);
     }
-    materialsCached(ids, options, signal) {
+    async materialsCached(ids, options, signal) {
         if (ids.length > MAX_BATCH_IDS) {
             throw MaterialGraphError.unexpected(`MaterialGraphClient.materialsCached(): at most ${MAX_BATCH_IDS} ids per call, received ${ids.length}. Split into multiple batches.`);
         }
-        return this.#get("get_materials_batch_get", {
+        return await this.#get("get_materials_batch_get", {
+            idKind: options?.idKind ?? "variantId",
             ids: ids.join(","),
             view: options?.view ?? "tile",
-            idKind: options?.idKind ?? "variantId",
         }, signal);
     }
     /** Vocabulary families and counts; use `colours.profiles()` for a material palette. */
-    colourFacets(signal) {
-        return colourFacetsCall(this.#transport, signal);
+    async colourFacets(signal) {
+        return await colourFacetsCall(this.#transport, signal);
     }
     /** Resolve a colour name to its hex, and the named paint's catalogue variant. */
-    resolveColour(name, signal, options) {
-        return resolveColourCall(this.#transport, name, signal, options);
+    async resolveColour(name, signal, options) {
+        return await resolveColourCall(this.#transport, name, signal, options);
     }
     /** Ranked colour-name typeahead (GET `/api/v1/search/colours/suggest`). */
-    suggestColour(q, options, signal) {
-        return suggestColourCall(this.#transport, q, options, signal);
+    async suggestColour(q, options, signal) {
+        return await suggestColourCall(this.#transport, q, options, signal);
     }
     /** Entity typeahead. Navigate using the selected `refId`; use `search()` for materials. */
-    suggest(q, options, signal) {
-        return suggestCall(this.#transport, q, options, signal);
+    async suggest(q, options, signal) {
+        return await suggestCall(this.#transport, q, options, signal);
     }
     // ── Catalog ──────────────────────────────────────────────────────────────────
     /** Resolve free text to a canonical attribute id. */
-    resolveAttribute(q, options, signal) {
-        return resolveAttributeCall(this.#transport, q, options, signal);
+    async resolveAttribute(q, options, signal) {
+        return await resolveAttributeCall(this.#transport, q, options, signal);
     }
     /** Resolve a value under a canonical attribute id; inspect `recommendedAction` for ambiguity. */
-    resolveAttributeValue(attributeId, query, options, signal) {
-        return resolveAttributeValueCall(this.#transport, attributeId, query, options, signal);
+    async resolveAttributeValue(attributeId, query, options, signal) {
+        return await resolveAttributeValueCall(this.#transport, attributeId, query, options, signal);
     }
     /** "Is this phrase an attribute or a value?" — see {@link searchVocabularyRequest}. */
-    searchVocabulary(query, options, signal) {
-        return searchVocabularyRequest(this.#transport, query, options, signal);
+    async searchVocabulary(query, options, signal) {
+        return await searchVocabularyRequest(this.#transport, query, options, signal);
     }
     /** "I have words — what do they mean, and what stands behind them?" — see {@link resolvePhrases}. */
-    resolve(phrases, scope) {
-        return resolvePhrases(this.#transport, phrases, scope);
+    async resolve(phrases, scope) {
+        return await resolvePhrases(this.#transport, phrases, scope);
     }
     /**
      * THE QUESTION: "which materials, from ANYONE, are ASTM E84 Class A AND
@@ -413,8 +409,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * { min: 60 })`; bounds are inclusive, at least one is required, and a
      * non-numeric stored value is excluded rather than read as zero.
      */
-    bySpec(spec, options, signal) {
-        return this.#get("catalog_by_spec", {
+    async bySpec(spec, options, signal) {
+        return await this.#get("catalog_by_spec", {
             spec: Array.isArray(spec) ? spec : [spec],
             ...(options?.ranges?.length ? { specRange: options.ranges } : {}),
             limit: options?.limit,
@@ -427,29 +423,29 @@ export class MaterialGraphClient extends CatalogueClient {
      * (`search({ category })`, `colours.profiles()`,
      * {@link MaterialGraphClient.applicableSpecs}). Discover, never hand-write.
      */
-    taxonomy(signal) {
-        return this.#get("get_category_taxonomy", undefined, signal);
+    async taxonomy(signal) {
+        return await this.#get("get_category_taxonomy", undefined, signal);
     }
     /**
      * Exact current primary-type status counts by retained source category path.
      * `comparisonThreshold` is a reporting cutoff only: it never promotes a
      * proposal into an accepted category.
      */
-    productTypeCoverage(options, signal) {
-        return this.#get("get_product_type_status_coverage", options, signal);
+    async productTypeCoverage(options, signal) {
+        return await this.#get("get_product_type_status_coverage", options, signal);
     }
     /**
      * THE QUESTION: "what is this key allowed to do?" Check `scopes` before
      * offering a capability: the write surfaces need `mg:ingest` / `mg:compose`,
      * and `mg:admin` unlocks extra evidence fields.
      */
-    whoami(signal) {
-        return this.#get("whoami", undefined, signal);
+    async whoami(signal) {
+        return await this.#get("whoami", undefined, signal);
     }
     // ── Pairings / demand ────────────────────────────────────────────────────────
     /** What completes a scheme already part-chosen. See {@link coordinateCall}. */
-    coordinate(input, signal) {
-        return coordinateCall(this.#transport, input, signal);
+    async coordinate(input, signal) {
+        return await coordinateCall(this.#transport, input, signal);
     }
     /**
      * THE QUESTION: "how much is this material actually specified, and what gets
@@ -460,8 +456,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * {@link MaterialGraphClient.pairings} for a presentable rail. A null `demand`
      * means UNREAD, never zero. Provide EXACTLY ONE of `variantId` or `material`.
      */
-    demand(params, signal) {
-        return this.#get("get_material_demand", { variantId: params.variantId, material: params.material }, signal);
+    async demand(params, signal) {
+        return await this.#get("get_material_demand", { material: params.material, variantId: params.variantId }, signal);
     }
     /**
      * THE QUESTION: "for each of these picks I already hold, how much momentum does
@@ -490,8 +486,8 @@ export class MaterialGraphClient extends CatalogueClient {
      *   (r) => r.state === "available" && r.momentum.state === "rising",
      * );
      */
-    demandBatch(input, signal) {
-        return this.#post("get_demand_batch", input, signal);
+    async demandBatch(input, signal) {
+        return await this.#post("get_demand_batch", input, signal);
     }
     // ── Codes (advisory building-code compliance) ────────────────────────────────
     /**
@@ -503,8 +499,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * `mg.codes.advisory()` in new code, and start at `mg.codes.context()` to
      * discover every accepted context value. `unverified` is not a pass.
      */
-    codeAdvisory(input, signal) {
-        return this.codes.advisory(input, signal);
+    async codeAdvisory(input, signal) {
+        return await this.codes.advisory(input, signal);
     }
     // ── Colour helpers (extract) ─────────────────────────────────────────────────
     /**
@@ -514,8 +510,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * {@link MaterialGraphClient.byColour}. Instead use
      * {@link MaterialGraphClient.match} for the MATERIALS in the photo.
      */
-    extractPalette(input, signal) {
-        return this.#post("extract_image_palette", input, signal);
+    async extractPalette(input, signal) {
+        return await this.#post("extract_image_palette", input, signal);
     }
     // ── Catalog (facets / applicable specs / glossary) ───────────────────────────
     /**
@@ -536,8 +532,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * numeric specs (e.g. `slip_resistance_dcof`, a 0–1 DCOF range) are NOT
      * token-facetable and do not appear here — read those per-attribute.
      */
-    specificationFacets(signal) {
-        return this.#get("list_spec_facets", undefined, signal);
+    async specificationFacets(signal) {
+        return await this.#get("list_spec_facets", undefined, signal);
     }
     /**
      * List the live value distribution for ONE canonical attribute (GET
@@ -546,8 +542,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * {@link specificationFacets} — e.g. every certification programme on record,
      * or every fire classification and how many variants carry each.
      */
-    attributeValues(attributeId, signal) {
-        return this.#get("list_attribute_values", undefined, signal, {
+    async attributeValues(attributeId, signal) {
+        return await this.#get("list_attribute_values", undefined, signal, {
             attributeId,
         });
     }
@@ -559,8 +555,8 @@ export class MaterialGraphClient extends CatalogueClient {
      *
      * @param key A canonical taxonomy key from {@link MaterialGraphClient.taxonomy}.
      */
-    applicableSpecs(key, signal) {
-        return this.#get("get_applicable_specs", undefined, signal, { key });
+    async applicableSpecs(key, signal) {
+        return await this.#get("get_applicable_specs", undefined, signal, { key });
     }
     /**
      * THE QUESTION: "what does 'DCOF' MEAN?" — one term explained, for a human.
@@ -568,21 +564,21 @@ export class MaterialGraphClient extends CatalogueClient {
      * {@link MaterialGraphClient.searchVocabulary} to FIND a token and
      * {@link MaterialGraphClient.attributeValues} for the values it takes.
      */
-    glossary(term, signal) {
-        return this.#get("explain_material_term", undefined, signal, { term });
+    async glossary(term, signal) {
+        return await this.#get("explain_material_term", undefined, signal, { term });
     }
     // ── Brands ───────────────────────────────────────────────────────────────────
     /** "Whose catalogs are in here, and how big is each?" — {@link listBrands}. */
-    brands(options = {}, signal) {
-        return listBrands(this.#transport, options, signal);
+    async brands(options = {}, signal) {
+        return await listBrands(this.#transport, options, signal);
     }
     /** "Who is this brand, and what do they claim?" — {@link brandProfile}. */
-    brand(brandSlug, options, signal) {
-        return brandProfile(this.#transport, brandSlug, options, signal);
+    async brand(brandSlug, options, signal) {
+        return await brandProfile(this.#transport, brandSlug, options, signal);
     }
     /** "This maker's whole range, the way a fan deck reads" — {@link brandColourDeck}. */
-    brandColourDeck(brandSlug, signal) {
-        return brandColourDeck(this.#transport, brandSlug, signal);
+    async brandColourDeck(brandSlug, signal) {
+        return await brandColourDeck(this.#transport, brandSlug, signal);
     }
     // ── Runs (the hosted agentic surface) ────────────────────────────────────────
     /**
@@ -591,8 +587,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * text/markdown, and images — the server classifies each) or the legacy
      * `{ brief, references }` shape. Requires the `mg:ingest` scope.
      */
-    uploadSourceMaterial(input, signal) {
-        return uploadSourceMaterial(this.#transport, input, signal);
+    async uploadSourceMaterial(input, signal) {
+        return await uploadSourceMaterial(this.#transport, input, signal);
     }
     /**
      * Read back an uploaded batch (GET `/api/v1/source-material/{batchId}`): every
@@ -602,8 +598,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * immediately. A batch you do not own raises the same 404 as one that does not
      * exist. Requires the `mg:compose` scope.
      */
-    sourceMaterialBatch(batchId, signal) {
-        return getSourceMaterialBatchCall(this.#transport, batchId, signal);
+    async sourceMaterialBatch(batchId, signal) {
+        return await getSourceMaterialBatchCall(this.#transport, batchId, signal);
     }
     /**
      * THE QUESTION: "what can the hosted agentic surface be asked to DO?" Start
@@ -611,8 +607,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * live input/output schemas, scopes and side-effect class, so nothing about a
      * Run need be hardcoded.
      */
-    capabilities(signal) {
-        return capabilitiesRun(this.#transport, signal);
+    async capabilities(signal) {
+        return await capabilitiesRun(this.#transport, signal);
     }
     /**
      * THE QUESTION: "do a whole job for me" — the ASYNC lens. Everything else here
@@ -623,8 +619,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * {@link MaterialGraphClient.capabilities}. Pass `idempotencyKey` so a retry
      * replays rather than duplicates.
      */
-    createRun(body, signal) {
-        return createRun(this.#transport, body, signal);
+    async createRun(body, signal) {
+        return await createRun(this.#transport, body, signal);
     }
     /**
      * THE QUESTION: "where has this Run got to?" — the caller-owned, redacted
@@ -632,8 +628,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * when a human is waiting. `suspended` is not a failure — it means the Run is
      * asking you something (see {@link MaterialGraphClient.resumeRun}).
      */
-    run(runId, signal) {
-        return getRun(this.#transport, runId, signal);
+    async run(runId, signal) {
+        return await getRun(this.#transport, runId, signal);
     }
     /**
      * THE QUESTION: "which Runs are mine?" — your own Runs, newest first, paged
@@ -644,22 +640,12 @@ export class MaterialGraphClient extends CatalogueClient {
      * Only your own Runs are ever returned. Page by following `nextCursor` until
      * it is ABSENT — a full page is not the signal to stop.
      */
-    listRuns(options) {
-        return listRuns(this.#transport, options);
-    }
-    /**
-     * Export a completed compose Run's scheme as a finish schedule — one row per
-     * slot, every attribute value carrying its source and verification state
-     * (GET `/api/v1/runs/{runId}/schedule`). Unknown values are explicit
-     * `missing` cells, never blanks. The `.xlsx` form is a direct-URL download:
-     * `GET /api/v1/runs/{runId}/schedule.xlsx` with the same bearer key.
-     */
-    runSchedule(runId, options) {
-        return getRunSchedule(this.#transport, runId, options);
+    async listRuns(options) {
+        return await listRuns(this.#transport, options);
     }
     /** Follow a verdict cell's citation handle to its canonical claim source. */
-    citation(citationId, signal) {
-        return this.#get("get_verdict_citation", undefined, signal, { citationId });
+    async citation(citationId, signal) {
+        return await this.#get("get_verdict_citation", undefined, signal, { citationId });
     }
     /**
      * Resume a suspended Run (POST `/api/v1/runs/{runId}/resume`).
@@ -668,24 +654,24 @@ export class MaterialGraphClient extends CatalogueClient {
      * {@link ResumeRunOptions}, whose `stepId` guards against resuming a step the
      * run has already moved past — the API answers 409 on a mismatch (MG-608).
      */
-    resumeRun(runId, resumeData, signalOrOptions) {
-        return resumeRun(this.#transport, runId, resumeData, signalOrOptions);
+    async resumeRun(runId, resumeData, signalOrOptions) {
+        return await resumeRun(this.#transport, runId, resumeData, signalOrOptions);
     }
     /**
      * THE QUESTION: "stop this Run." Requests DURABLE cancellation — the Run
      * acknowledges and unwinds; the call returning does not mean it has stopped.
      * Poll {@link MaterialGraphClient.run} for the terminal state.
      */
-    cancelRun(runId, signal) {
-        return cancelRun(this.#transport, runId, signal);
+    async cancelRun(runId, signal) {
+        return await cancelRun(this.#transport, runId, signal);
     }
     /** Option B from a composed Run, along one axis. See {@link varySchemeCall}. */
-    varyScheme(body, signal) {
-        return varySchemeCall(this.#transport, body, signal);
+    async varyScheme(body, signal) {
+        return await varySchemeCall(this.#transport, body, signal);
     }
     /** Ranked candidate pools for up to 24 slots. See {@link slotPoolsCall}. */
-    slotPools(body, signal) {
-        return slotPoolsCall(this.#transport, body, signal);
+    async slotPools(body, signal) {
+        return await slotPoolsCall(this.#transport, body, signal);
     }
     /**
      * Stream ordered Run events as an async iterator (GET
@@ -695,42 +681,11 @@ export class MaterialGraphClient extends CatalogueClient {
     streamRunEvents(runId, options) {
         return streamRunEvents(this.#transport, runId, options);
     }
-    // ── Projects (the persistent Material Box entity) ────────────────────────────
-    /**
-     * Create a persistent project owned by the caller (POST `/api/v1/projects`).
-     * Returns the freshly assembled state (an empty event log). Requires the
-     * `mg:ingest` scope.
-     */
-    createProject(body = {}, signal) {
-        return createProjectCall(this.#transport, body, signal);
-    }
-    /**
-     * THE QUESTION: "what has happened on this project?" — the append-only event log
-     * FOLDED into a read model, plus the raw `events`. Read the folded collections;
-     * the log is there for audit.
-     */
-    getProject(projectId, signal) {
-        return getProjectCall(this.#transport, projectId, signal);
-    }
-    /**
-     * Append one event to a project's append-only process trail (POST
-     * `/api/v1/projects/{projectId}/events`). Requires the `mg:ingest` scope.
-     */
-    appendProjectEvent(projectId, body, signal) {
-        return appendProjectEventCall(this.#transport, projectId, body, signal);
-    }
-    /**
-     * THE QUESTION: "what Boxes do I have?" Scoped to the authenticated principal —
-     * another key's projects are invisible, not forbidden.
-     */
-    listProjects(signal) {
-        return listProjectsCall(this.#transport, signal);
-    }
     /**
      * Collect Run events until a terminal event, the deadline, or the stream ends
      * — the bounded events-log pattern (a single pass over {@link streamRunEvents}).
      */
-    drainRunEvents(runId, options) {
-        return drainRunEvents(this.#transport, runId, options);
+    async drainRunEvents(runId, options) {
+        return await drainRunEvents(this.#transport, runId, options);
     }
 }

package/codes-client.d.ts

@@ -27,10 +27,10 @@ import type { CodeAdvisoryInput, CodeAdvisoryResponse, CodeContextRequest, CodeC
 import type { QueryParams } from "./http-transport.js";
 import type { SdkOperationId } from "./operations.js";
 /** The client's own request primitives, handed down so this file owns no transport. */
-export interface CodesTransport {
+export type CodesTransport = {
     get<T>(operationId: SdkOperationId, query?: QueryParams, signal?: AbortSignal): Promise<T>;
     post<T>(operationId: SdkOperationId, body: unknown, signal?: AbortSignal): Promise<T>;
-}
+};
 export declare class CodesClient {
     #private;
     constructor(transport: CodesTransport);