@instruments/materialgraph 0.25.0 → 0.27.0

package/fan-deck-types.d.ts

@@ -1,42 +0,0 @@
-/**
- * Wire types for a maker's whole range — GET `/api/v1/brands/{brandSlug}/colours`.
- *
- * The one read in the SDK that is deliberately UNPAGINATED. Family order is only
- * correct over a complete range: the greys cannot be placed against the browns
- * while holding one page of each. So the response carries the brand, and
- * `truncatedAt` appears only if a range ever exceeds the server's ceiling.
- */
-export interface FanDeckSwatch {
-    /** Opaque token. Never parse or construct one. */
-    variantId: string;
-    brand: string;
-    /** The maker's own colour name. Null when the catalogue publishes none. */
-    name: string | null;
-    /** The maker's PUBLISHED hex. This read never returns a derived colour. */
-    hex: string;
-    /** colorscope's family id, lower case (`cream`, `gray`, `blue`). */
-    family: string;
-    /** OKLab L, 0–1. The sort key within a family: light to dark. */
-    lightness: number;
-    imageUrl: string | null;
-}
-export interface FanDeckFamily {
-    family: string;
-    /** Count over the WHOLE range, computed before any truncation. */
-    count: number;
-}
-export interface BrandFanDeck {
-    /**
-     * The brand SLUGS the deck resolved to — round-trippable identifiers, not
-     * display names. The maker's name as it should be shown is on every swatch.
-     */
-    brands: string[];
-    /** Grouped by `families` order, light to dark within each family. */
-    swatches: FanDeckSwatch[];
-    families: FanDeckFamily[];
-    /**
-     * Present ONLY when the range exceeded the server ceiling. Absent means the
-     * deck is complete — absent is not zero.
-     */
-    truncatedAt?: number;
-}

package/fan-deck-types.js

@@ -1,9 +0,0 @@
-/**
- * Wire types for a maker's whole range — GET `/api/v1/brands/{brandSlug}/colours`.
- *
- * The one read in the SDK that is deliberately UNPAGINATED. Family order is only
- * correct over a complete range: the greys cannot be placed against the browns
- * while holding one page of each. So the response carries the brand, and
- * `truncatedAt` appears only if a range ever exceeds the server's ceiling.
- */
-export {};

package/match-rejection-types.d.ts

@@ -1,43 +0,0 @@
-/**
- * "Not this" on a photo match result (MG-1859). A rejection is feedback on the
- * match ranking, recorded against the response that showed the result. It is
- * never a catalogue correction; wrong facts about a product go through
- * `createCorrection`.
- */
-export interface RejectMatchResultInput {
-    /**
-     * The surface the result was shown under - `surfaces[].surface.id` on a scene
-     * match. Omit it for a result from the run-level `results` list.
-     */
-    surfaceId?: string;
-    /** The rejected result's `variantId`, verbatim. */
-    variantId: string;
-    /** Optional free text, up to 500 characters. Stored as given. */
-    reason?: string;
-}
-/** The receipt for one rejection. A repeat of the same rejection returns the original. */
-export interface MatchRejection {
-    rejectionId: string;
-    /** The match response's `attribution.responseId`. */
-    responseId: string;
-    /** Null when the result came from the run-level list. */
-    surfaceId: string | null;
-    variantId: string;
-    /** The 1-based position the match response showed this result at, within its surface. */
-    rank: number;
-    reason: string | null;
-    /** ISO-8601. */
-    rejectedAt: string;
-}
-/** One match response and every rejection recorded against it. */
-export interface MatchRejectionList {
-    responseId: string;
-    /** `stream` for a scene match, `buffered` for the single-image JSON response. */
-    lane: "buffered" | "stream";
-    /** ISO-8601 time the match response was issued. */
-    issuedAt: string;
-    /** Ranked results the response showed, across every surface - a rejection rate's denominator. */
-    resultCount: number;
-    /** Oldest first. Empty means nothing was rejected. */
-    rejections: MatchRejection[];
-}

package/match-rejection-types.js

@@ -1,7 +0,0 @@
-/**
- * "Not this" on a photo match result (MG-1859). A rejection is feedback on the
- * match ranking, recorded against the response that showed the result. It is
- * never a catalogue correction; wrong facts about a product go through
- * `createCorrection`.
- */
-export {};

package/palette-completion-types.d.ts

@@ -1,115 +0,0 @@
-/** Public wire types; the SDK does not load the producer corpus. */
-export type CompositionalRole = "Foundation" | "Supporting" | "Accent";
-export interface RetainedColor {
-    readonly id: string;
-    readonly hex: string;
-    readonly role?: CompositionalRole;
-    readonly paintVariantId?: string;
-}
-export interface CompletionRequest {
-    readonly inputs: readonly RetainedColor[];
-    readonly maxDistance?: number;
-    readonly limit?: number;
-    readonly white?: "published" | "perceptual";
-    readonly memberCount?: number;
-    readonly excludeHexes?: readonly string[];
-}
-export interface CompletionAssignment {
-    readonly input: RetainedColor;
-    readonly referenceIndex: number;
-    readonly referenceHex: string;
-    readonly distance: number;
-}
-export interface CompletionMember {
-    readonly hex: string;
-    readonly referenceHex: string;
-    readonly referenceIndex: number;
-    readonly inputIds: readonly string[];
-    readonly role: CompositionalRole;
-    readonly proportion: number;
-    readonly sourceRole: string | null;
-    readonly sourceRelation: string | null;
-}
-export interface PaletteCompletion {
-    readonly uses?: readonly {
-        readonly inputId: string;
-        readonly role: CompositionalRole;
-        readonly proportions: readonly number[];
-    }[];
-    readonly id: string;
-    readonly reference: {
-        readonly anchorIndex?: number | null;
-        readonly libraryId: string;
-        readonly paletteId: string;
-        readonly name: string | null;
-        readonly maker: string | null;
-        readonly intent: "joint" | "alternatives";
-        readonly provenance: "authored" | "derived" | "generated";
-    };
-    readonly assignments: readonly CompletionAssignment[];
-    readonly members: readonly CompletionMember[];
-    readonly evidenceBasis: "published-composition" | "published-pair" | "nearby-adaptation";
-    readonly proportionBasis: "sourced" | "proposed";
-    readonly worstDistance: number;
-    readonly totalDistance: number;
-}
-export type PaletteCompleteInput = CompletionRequest & {
-    sourceVersion: string;
-};
-export interface PaletteDiscoverInput {
-    sourceVersion: string;
-    character?: "warm" | "cool" | "very-light" | "light" | "dark" | "muted" | "soft" | "vivid";
-    moreLike?: string;
-    cursor?: string;
-    limit?: number;
-}
-export interface MaterializedPalette {
-    completion: PaletteCompletion;
-    samples: Array<{
-        retainedPaint?: {
-            variantId: string;
-            name: string;
-            maker: string;
-        };
-        referenceIndex: number;
-        inputIds: readonly string[];
-        hex: string;
-        product: {
-            variantId: string;
-            productId: string;
-            hex: string;
-            name: string;
-            brand: {
-                slug: string;
-                name: string;
-            };
-        } | null;
-        status: string;
-        distance: number | null;
-        units: "oklab-euclidean";
-    }>;
-}
-interface PaletteVersions {
-    sourceVersion: string;
-    corpusVersion: string;
-    algorithmVersion: string;
-    transport: "colorscope-package";
-}
-export interface PaletteCompleteResponse extends PaletteVersions {
-    results: MaterializedPalette[];
-    coverage: {
-        status: string;
-        supported: number;
-    };
-    tolerance: {
-        bound: number;
-        units: string;
-        policy: string;
-    };
-}
-export interface PaletteDiscoverResponse extends PaletteVersions {
-    results: MaterializedPalette[];
-    total: number;
-    nextCursor: string | null;
-}
-export {};

package/palette-completion-types.js

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

package/project-types.d.ts

@@ -1,79 +0,0 @@
-/**
- * Wire types for the persistent Material Box project surface (`/api/v1/projects`).
- * Hand-mirrored from `@materialgraph/products/projects`' Zod contract — the SDK
- * has zero runtime dependency on `@materialgraph/*`. Kept shape-identical to the
- * server contract; the OpenAPI parity test gates method/path/operationId, and the
- * server route schemas gate the body shapes.
- *
- * THE LENS: a project is the DESIGNER'S OWN record — an append-only trail of
- * what they attached, asked, preferred and adopted. It holds no material data of
- * its own; every `variantId`, `batchId` and `runId` in it is a reference into
- * the other lenses. Read the folded collections on {@link ProjectState}; the raw
- * `events` log is there for audit, not for reconstruction.
- *
- * Every id here is OPAQUE — round-trip verbatim, never parse or construct one.
- */
-import type { BatchId, ProjectId, RunId, VariantId } from "./identifiers.js";
-/** The six governed project-event kinds. */
-export type ProjectEventKind = "batch-attached" | "run-started" | "clarifying-answer" | "pairwise-preference" | "reference-chosen" | "scheme-adopted";
-/** The frozen tuple of every project-event kind, for enumeration. */
-export declare const PROJECT_EVENT_KINDS: readonly ProjectEventKind[];
-/** One clarifying question and the designer's answer. */
-export interface ClarifyingAnswer {
-    question: string;
-    answer: string;
-}
-/** One pairwise preference; `chosenId` is `leftId` or `rightId`. All three opaque. */
-export interface PairwisePreference {
-    leftId: VariantId;
-    rightId: VariantId;
-    chosenId: VariantId;
-}
-/** One stored event; `payload` is validated to the shape of `kind`. */
-export interface ProjectEvent {
-    eventId: string;
-    kind: ProjectEventKind;
-    payload: Record<string, unknown>;
-    createdAt: string;
-}
-/** A lightweight project row for list views (no event fold). */
-export interface ProjectSummary {
-    /** Opaque — round-trip verbatim. */
-    projectId: ProjectId;
-    principalId: string;
-    name: string;
-    createdAt: string;
-    updatedAt: string;
-}
-/** A project's assembled read model — identity plus the folded event collections. */
-export interface ProjectState extends ProjectSummary {
-    /** Source-material batches attached, oldest first. Opaque. */
-    batchIds: BatchId[];
-    /** Runs started from this project, oldest first. Opaque. */
-    runIds: RunId[];
-    answers: ClarifyingAnswer[];
-    preferences: PairwisePreference[];
-    chosenReferences: string[];
-    adoptedSchemes: string[];
-    events: ProjectEvent[];
-}
-/** `GET /api/v1/projects` — the caller's projects, newest first. */
-export interface ProjectListResponse {
-    projects: ProjectSummary[];
-}
-/** `POST /api/v1/projects` request body. */
-export interface CreateProjectRequest {
-    name?: string;
-}
-/** `POST /api/v1/projects/{projectId}/events` request body. */
-export interface AppendProjectEventRequest {
-    kind: ProjectEventKind;
-    payload: Record<string, unknown>;
-}
-/** `POST /api/v1/projects/{projectId}/events` response — the appended event receipt. */
-export interface ProjectEventReceipt {
-    eventId: string;
-    projectId: ProjectId;
-    kind: ProjectEventKind;
-    createdAt: string;
-}

package/project-types.js

@@ -1,9 +0,0 @@
-/** The frozen tuple of every project-event kind, for enumeration. */
-export const PROJECT_EVENT_KINDS = Object.freeze([
-    "batch-attached",
-    "run-started",
-    "clarifying-answer",
-    "pairwise-preference",
-    "reference-chosen",
-    "scheme-adopted",
-]);

package/projects.d.ts

@@ -1,13 +0,0 @@
-import { HttpTransport } from "./http-transport.js";
-import type { AppendProjectEventRequest, CreateProjectRequest, ProjectEventReceipt, ProjectListResponse, ProjectState } from "./project-types.js";
-/** Create a project (`POST /api/v1/projects`). Requires the `mg:ingest` scope. */
-export declare function createProject(transport: HttpTransport, body?: CreateProjectRequest, signal?: AbortSignal): Promise<ProjectState>;
-/** Read a project's assembled state (`GET /api/v1/projects/{projectId}`). */
-export declare function getProject(transport: HttpTransport, projectId: string, signal?: AbortSignal): Promise<ProjectState>;
-/**
- * Append one event to a project's process trail
- * (`POST /api/v1/projects/{projectId}/events`). Requires the `mg:ingest` scope.
- */
-export declare function appendProjectEvent(transport: HttpTransport, projectId: string, body: AppendProjectEventRequest, signal?: AbortSignal): Promise<ProjectEventReceipt>;
-/** List your own projects, newest first (`GET /api/v1/projects`). */
-export declare function listProjects(transport: HttpTransport, signal?: AbortSignal): Promise<ProjectListResponse>;

package/projects.js

@@ -1,46 +0,0 @@
-/**
- * The persistent-project namespace of the SDK. Thin wrappers over the shared
- * {@link HttpTransport} for the `/api/v1/projects` surface: create a project,
- * read its assembled state, append process-trail events, and list your own.
- * Box's proxy routes are thin wrappers over exactly these calls.
- */
-import { MaterialGraphError } from "./errors.js";
-import { HttpTransport } from "./http-transport.js";
-import { findSdkOperation } from "./operations.js";
-function projectOperation(operationId) {
-    const match = findSdkOperation(operationId);
-    if (!match)
-        throw MaterialGraphError.unexpected(`Unknown SDK operation: ${operationId}`);
-    return match;
-}
-/** Create a project (`POST /api/v1/projects`). Requires the `mg:ingest` scope. */
-export function createProject(transport, body = {}, signal) {
-    return transport.requestJson(projectOperation("create_box_project"), {
-        body,
-        signal,
-    });
-}
-/** Read a project's assembled state (`GET /api/v1/projects/{projectId}`). */
-export function getProject(transport, projectId, signal) {
-    return transport.requestJson(projectOperation("get_box_project"), {
-        pathParams: { projectId },
-        signal,
-    });
-}
-/**
- * Append one event to a project's process trail
- * (`POST /api/v1/projects/{projectId}/events`). Requires the `mg:ingest` scope.
- */
-export function appendProjectEvent(transport, projectId, body, signal) {
-    return transport.requestJson(projectOperation("append_box_project_event"), {
-        body,
-        pathParams: { projectId },
-        signal,
-    });
-}
-/** List your own projects, newest first (`GET /api/v1/projects`). */
-export function listProjects(transport, signal) {
-    return transport.requestJson(projectOperation("list_box_projects"), {
-        signal,
-    });
-}

package/render-assets-types.d.ts

@@ -1,65 +0,0 @@
-import type { VariantId } from "./identifiers.js";
-export type RenderAssetChannelRole = "base-color" | "normal" | "roughness" | "metalness" | "height" | "ambient-occlusion";
-export type RenderAssetSourceBasis = "catalog_feed" | "declared" | "derived";
-export type RenderAssetUnavailableReason = "no_accepted_appearance" | "pending" | "withheld" | "rejected" | "superseded" | "variant_inactive" | "delivery_unverified" | "integrity_error";
-export interface RenderAssetFreshness {
-    revision: string;
-    updatedAt: string | null;
-    checkedAt: string | null;
-}
-export interface RenderAssetChannel {
-    role: RenderAssetChannelRole;
-    url: string;
-    sha256: string;
-    byteSize: number;
-    mimeType: "image/png";
-    width: number;
-    height: number;
-    bitDepth: 8 | 16;
-    colorSpace: "srgb" | "linear";
-}
-export interface MaterialRenderAssetsAvailable {
-    schemaVersion: "pbr-render-assets/v1";
-    variantId: VariantId;
-    status: "available";
-    setId: string;
-    state: "accepted";
-    sourceBasis: "derived";
-    fidelity: "unassessed";
-    acceptance: {
-        id: string;
-        verificationDecisionId: string;
-        acceptedAt: string;
-        checkVersion: string;
-        qa: {
-            status: "passed";
-            checkCount: number;
-        };
-        checkCount: number;
-    };
-    physicalRepeat: {
-        uMm: number;
-        vMm: number;
-        basis: "declared" | "measured";
-    };
-    tiling: {
-        u: boolean;
-        v: boolean;
-    };
-    normalConvention: "opengl" | "directx";
-    heightAmplitudeMm?: number;
-    channels: RenderAssetChannel[];
-    supersedesSetIds: string[];
-    freshness: RenderAssetFreshness;
-}
-export interface MaterialRenderAssetsUnavailable {
-    schemaVersion: "pbr-render-assets/v1";
-    variantId: VariantId;
-    status: "unavailable";
-    setId: string | null;
-    state: "pending" | "withheld" | "rejected" | "superseded" | "accepted" | null;
-    sourceBasis: RenderAssetSourceBasis | null;
-    reasonCodes: RenderAssetUnavailableReason[];
-    freshness: RenderAssetFreshness;
-}
-export type MaterialRenderAssets = MaterialRenderAssetsAvailable | MaterialRenderAssetsUnavailable;

package/render-assets-types.js

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

package/run-events.d.ts

@@ -1,106 +0,0 @@
-import type { RunEvent } from "./run-types.js";
-/**
- * Typed payloads for the composition Run event family — the friction fix flagged
- * by the MG-443 walk. These narrow the loose {@link RunEvent.payloadJson} so
- * consumers (the Box console) can render phase progress, the parsed programme,
- * and the criteria-correction UI without re-typing each payload at the call
- * site.
- *
- * Both wire generations are covered: the CURRENT `composition.*` strings the
- * server emits today, and the LEGACY `material-box.*` strings kept for read-side
- * dual-read compatibility. Shapes mirror
- * `packages/mastra/src/workflow/composition/events.ts` and the
- * `reviewCriteriaSuspendPayloadSchema` in `@materialgraph/products` — expressed
- * as standalone TS types (no cross-package import; the SDK is publishable).
- */
-import type { OpenEnum } from "./types.js";
-export declare const COMPOSITION_PHASE_EVENT_TYPES: readonly ["composition.phase", "material-box.phase"];
-export declare const COMPOSITION_PROGRAMME_EVENT_TYPES: readonly ["composition.programme", "material-box.brief"];
-export declare const COMPOSITION_REVIEW_CRITERIA_EVENT_TYPES: readonly ["composition.review-criteria", "material-box.review-criteria"];
-export type CompositionPhaseEventType = (typeof COMPOSITION_PHASE_EVENT_TYPES)[number];
-export type CompositionProgrammeEventType = (typeof COMPOSITION_PROGRAMME_EVENT_TYPES)[number];
-export type CompositionReviewCriteriaEventType = (typeof COMPOSITION_REVIEW_CRITERIA_EVENT_TYPES)[number];
-/** Payload of a `composition.phase` / `material-box.phase` progress event. */
-export interface CompositionPhasePayload {
-    workflow: OpenEnum<"parse-material-brief" | "compose-material-schemes">;
-    phase: string;
-    label: string;
-    state: OpenEnum<"started" | "completed" | "failed">;
-    /** Additive narration (file names, error messages); absent on older events. */
-    detail?: string;
-    /** Additive tallies (slot/candidate/scheme counts); absent on older events. */
-    counts?: Record<string, number>;
-}
-/**
- * Payload of a `composition.programme` / `material-box.brief` event. The current
- * generation carries `programme`; the legacy generation carried `brief`. Both
- * are read structurally (the parsed programme document).
- */
-export interface CompositionProgrammePayload {
-    programme?: unknown;
-    brief?: unknown;
-}
-/** One unresolved brief phrase offered for human correction at the review step. */
-export interface CompositionReviewCriteriaSuggestion {
-    attributeId: string;
-    name: string;
-    term?: string;
-    score: number;
-}
-/** Exact UTF-16 passage retained from the brief; no page coordinate is implied. */
-export interface CompositionBriefCriterionSourceRef {
-    sourceId: string;
-    quote: string;
-    textRange: {
-        start: number;
-        end: number;
-        unit: "utf16";
-    };
-}
-export interface CompositionReviewCriteriaUnresolved {
-    slotId: string;
-    /** Unresolved negative language requires an explicit review decision. */
-    polarity?: "exclusion";
-    raw: string;
-    sourceRefs?: CompositionBriefCriterionSourceRef[];
-    /**
-     * Ranked corrections, best first. MG-994: every one of these is an attribute
-     * the slot's own category holds accepted values for, so accepting the top
-     * suggestion can never leave the slot unfillable.
-     */
-    suggestions: CompositionReviewCriteriaSuggestion[];
-    /**
-     * MG-994: attribute ids ranked for this phrase and then withheld — the slot's
-     * category holds no accepted value for them. ABSENT when nothing was withheld
-     * (absent means nothing was removed, not that nothing could be).
-     */
-    withheld?: string[];
-}
-/**
- * Payload of a `composition.review-criteria` / `material-box.review-criteria`
- * suspend event — the correction grammar the Box review step renders.
- */
-export interface CompositionReviewCriteriaPayload {
-    unresolved: CompositionReviewCriteriaUnresolved[];
-}
-export interface CompositionPhaseEvent extends RunEvent {
-    type: CompositionPhaseEventType;
-    payloadJson: CompositionPhasePayload;
-}
-export interface CompositionProgrammeEvent extends RunEvent {
-    type: CompositionProgrammeEventType;
-    payloadJson: CompositionProgrammePayload;
-}
-export interface CompositionReviewCriteriaEvent extends RunEvent {
-    type: CompositionReviewCriteriaEventType;
-    payloadJson: CompositionReviewCriteriaPayload;
-}
-/** The discriminated union of all composition Run events. */
-export type CompositionEvent = CompositionPhaseEvent | CompositionProgrammeEvent | CompositionReviewCriteriaEvent;
-/**
- * Narrow a {@link RunEvent} to the composition family by its `type`, returning
- * `null` for lifecycle events (`queued`, `running`, `succeeded`, …) and any
- * unknown type. Narrowing is by the discriminating `type` only — payloads are
- * trusted structurally per the tolerant-parsing contract, never re-validated.
- */
-export declare function parseRunEvent(event: RunEvent): CompositionEvent | null;

package/run-events.js

@@ -1,32 +0,0 @@
-// ── Wire event-type strings (both generations) ───────────────────────────────
-export const COMPOSITION_PHASE_EVENT_TYPES = [
-    "composition.phase",
-    "material-box.phase",
-];
-export const COMPOSITION_PROGRAMME_EVENT_TYPES = [
-    "composition.programme",
-    "material-box.brief",
-];
-export const COMPOSITION_REVIEW_CRITERIA_EVENT_TYPES = [
-    "composition.review-criteria",
-    "material-box.review-criteria",
-];
-const includesType = (types, type) => types.includes(type);
-/**
- * Narrow a {@link RunEvent} to the composition family by its `type`, returning
- * `null` for lifecycle events (`queued`, `running`, `succeeded`, …) and any
- * unknown type. Narrowing is by the discriminating `type` only — payloads are
- * trusted structurally per the tolerant-parsing contract, never re-validated.
- */
-export function parseRunEvent(event) {
-    if (includesType(COMPOSITION_PHASE_EVENT_TYPES, event.type)) {
-        return event;
-    }
-    if (includesType(COMPOSITION_PROGRAMME_EVENT_TYPES, event.type)) {
-        return event;
-    }
-    if (includesType(COMPOSITION_REVIEW_CRITERIA_EVENT_TYPES, event.type)) {
-        return event;
-    }
-    return null;
-}

package/schedule-reference-types.d.ts

@@ -1,46 +0,0 @@
-/** A personal preference; diminished references stay on the research board. */
-export type ScheduleReferenceInfluence = "kept" | "diminished";
-export interface PutScheduleReferenceFeedback {
-    /** Reuse unchanged after an uncertain response; a different command needs a new id. */
-    requestId: string;
-    /** The version last read for this reference, or zero before its first decision. */
-    expectedFeedbackVersion: number;
-    sourceRunId: string;
-    influence: ScheduleReferenceInfluence;
-}
-export type ScheduleReferenceSource = {
-    kind: "image";
-    laneId: string;
-    imageRef: string;
-    sourceName: string;
-    sourceDomain: string;
-    url: string | null;
-    caption: string;
-} | {
-    kind: "web";
-    domain: string;
-    url: string;
-    statement: string;
-    implication: string;
-};
-/** Immutable receipt for one decision, including the exact research frame it came from. */
-export interface ScheduleReferenceFeedback {
-    eventId: string;
-    scheduleId: string;
-    referenceId: string;
-    version: number;
-    requestId: string;
-    sourceRunId: string;
-    sourceEventSequence: number;
-    source: ScheduleReferenceSource;
-    scope: {
-        kind: "project";
-    };
-    originalVerdict: "kept" | "set-aside";
-    influence: ScheduleReferenceInfluence;
-    decidedByPrincipalId: string;
-    decidedAt: string;
-}
-export interface ScheduleReferenceFeedbackList {
-    items: ScheduleReferenceFeedback[];
-}

package/schedule-reference-types.js

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

package/schedule-references-client.d.ts

@@ -1,14 +0,0 @@
-import type { HttpTransport } from "./http-transport.js";
-import type { PutScheduleReferenceFeedback, ScheduleReferenceFeedback, ScheduleReferenceFeedbackList } from "./schedule-reference-types.js";
-/** Schedule-owned preferences, independent of an issued document's revision. */
-export declare class ScheduleReferencesClient {
-    #private;
-    constructor(transport: HttpTransport);
-    /** Read the latest saved preference for each reference. Empty means no decisions yet. */
-    list(scheduleId: string, signal?: AbortSignal): Promise<ScheduleReferenceFeedbackList>;
-    /**
-     * Save or reverse a preference. An exact request replay returns its original receipt;
-     * it does not undo newer decisions. A stale reference version raises a 409.
-     */
-    put(scheduleId: string, referenceId: string, input: PutScheduleReferenceFeedback, signal?: AbortSignal): Promise<ScheduleReferenceFeedback>;
-}