@instruments/materialgraph 0.25.0 → 0.26.0

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/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>;
-}

package/schedule-references-client.js

@@ -1,26 +0,0 @@
-import { resolveOperation } from "./operations.js";
-/** Schedule-owned preferences, independent of an issued document's revision. */
-export class ScheduleReferencesClient {
-    #transport;
-    constructor(transport) {
-        this.#transport = transport;
-    }
-    /** Read the latest saved preference for each reference. Empty means no decisions yet. */
-    list(scheduleId, signal) {
-        return this.#transport.requestJson(resolveOperation("list_schedule_reference_feedback"), {
-            pathParams: { scheduleId },
-            signal,
-        });
-    }
-    /**
-     * 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, referenceId, input, signal) {
-        return this.#transport.requestJson(resolveOperation("put_schedule_reference_feedback"), {
-            pathParams: { scheduleId, referenceId },
-            body: input,
-            signal,
-        });
-    }
-}

package/schedule-types.d.ts

@@ -1,261 +0,0 @@
-import type { VerdictCitation } from "./citation-types.js";
-/**
- * Finish-schedule wire types (MG-616) — the hand-mirror of
- * `@materialgraph/products/schemes/finish-schedule`. Kept in their own module
- * rather than `types.ts`, which sits at its source-size baseline.
- *
- * A finish schedule is a completed compose scheme rendered as ONE ROW PER SLOT:
- * the shape a specifier issues. The contract that makes it trustworthy is that
- * every row carries the IDENTICAL, fixed column set, and every attribute cell
- * states its own verification alongside its value. An unknown is an explicit
- * `missing` cell with a null value — never a blank that reads as complete.
- *
- * ABSENT IS NOT FALSE, enforced structurally: because the column set is fixed,
- * "we do not know" has to be SAID rather than omitted. Read
- * {@link FinishScheduleCell.state} before printing `value`.
- *
- * MG-1351 added the schedule's organising principle: every row carries an
- * {@link FinishScheduleRow.code} L-code under a numbered section, rows arrive in
- * READING order, slots with nothing specified are served as
- * {@link FinishSchedule.openSlots}, and a row may carry or-equal
- * {@link FinishScheduleAlternate}s. Read `alternates` with
- * {@link FinishSchedule.alternatesResolved}: an empty list means either "we did
- * not ask" or "there is none", and those are different claims.
- */
-import type { RunId, SchemeId, SlotId, VariantId } from "./identifiers.js";
-/** One schedule column: the attribute and its header text. */
-export interface FinishScheduleColumn {
-    attributeId: string;
-    /** The registry presentation label. */
-    label: string;
-}
-/**
- * The six verification states a schedule cell can report, mirroring the shared
- * verdict contract. On this public surface a `proposed` (pending-review) value
- * is projected to `missing`, so it can never be told apart from a value that
- * never existed.
- */
-export type FinishScheduleCellState = "matched" | "deviated" | "failed" | "unverified" | "missing" | "not_evaluated";
-/**
- * One attribute cell of one row: the value AND how far it can be trusted.
- *
- * Columns the Run's criteria evaluated carry the real verdict state. Columns
- * backfilled from the catalogue (nothing in the brief asked about them) only
- * ever read `matched` or `missing`: they assert presence-with-trust, not that
- * the brief was met.
- */
-export interface FinishScheduleCell {
-    attributeId: string;
-    label: string;
-    /** The display value, or null when unknown. */
-    value: string | null;
-    state: FinishScheduleCellState;
-    confidence: number | null;
-    sourceBasis: string | null;
-    /** Omitted when the exact current claim has no supporting source. */
-    citation?: VerdictCitation;
-}
-/**
- * The rolled-up grade for one row, from its EVALUATED criterion cells only.
- * `meets_all` is all-green on the required cells; `close` means something
- * deviated, went unverified or was missing — never round it up to a pass;
- * `hard_no` means a required cell failed on a real value.
- */
-export type FinishScheduleGrade = "meets_all" | "close" | "hard_no";
-/** Exact retained brief passage behind a schedule criterion. */
-export interface FinishScheduleCriterionSourceRef {
-    sourceId: string;
-    quote: string;
-    textRange: {
-        start: number;
-        end: number;
-        unit: "utf16";
-    };
-}
-/** Brief criterion carried into the issued row, including explicit exclusions. */
-export type FinishScheduleCriterion = {
-    kind: "attribute" | "attribute-presence" | "attribute-exclusion" | "attribute-numeric" | "unresolved";
-    raw: string;
-    attributeId?: string;
-    term?: string;
-    comparator?: "at-least" | "at-most";
-    value?: number;
-    unit?: string;
-    polarity?: "exclusion";
-    coverageNote?: string;
-    suggestion?: {
-        attributeId: string;
-        term?: string;
-    };
-    sourceRefs?: FinishScheduleCriterionSourceRef[];
-};
-/** One numbered section of the schedule, and the heading it prints. */
-export interface FinishScheduleSection {
-    /** The hundreds block, e.g. `100`. Also the base of every line number in it. */
-    code: number;
-    name: string;
-}
-/**
- * What MaterialGraph claims about an alternate — and never more than it can
- * support. None of the three means "interchangeable": accepting an alternate is
- * a specification decision, and this API does not make it.
- *
- * `or_equal` matched the specified material's equivalence signature with every
- * supporting value above its confidence floor. `or_equal_unverified` matched the
- * same signature on values that did not clear it. `successor` is the brand's own
- * declared replacement, from a reviewed relationship rather than a spec match —
- * its verdict cells are `not_evaluated` by construction.
- */
-export type FinishScheduleAlternateStance = "or_equal" | "or_equal_unverified" | "successor";
-/** One criterion of the equivalence signature an alternate was matched on. */
-export interface FinishScheduleAlternateCriterion {
-    role: "primary_material" | "performance";
-    attributeId: string;
-    term: string;
-}
-/**
- * Why an alternate is on the row. Every field is evidence, not adjective — a
- * substitute presented without its basis looks like a decision when it is a
- * lookup, so this is never absent from an alternate.
- */
-export interface FinishScheduleAlternateBasis {
-    /** The SPECIFIED variant this alternate was graded against. Opaque. */
-    specifiedVariantId: VariantId;
-    /** The product-type form the signature was projected in; null for a successor. */
-    form: string | null;
-    /** The criteria that matched. Empty for a successor: nothing was matched. */
-    signature: FinishScheduleAlternateCriterion[];
-    /** The seed-relative report card, projected exactly as row cells are. */
-    verdict: {
-        cells: FinishScheduleCell[];
-        grade: FinishScheduleGrade;
-        minConfidence: number | null;
-    };
-}
-/** One or-equal line sitting beneath the specified line it answers. */
-export interface FinishScheduleAlternate {
-    stance: FinishScheduleAlternateStance;
-    /** Opaque — round-trip verbatim into the material lenses. */
-    variantId: VariantId;
-    brand: string;
-    product: string;
-    variant: string;
-    /**
-     * The colourway, when the catalogue names one. Carried separately because a
-     * substitute's `variant` is frequently the product name repeated, and a line
-     * that cannot name the colour has not named a material.
-     */
-    colour: string | null;
-    imageUrl: string | null;
-    hex: string | null;
-    recordUrl: string;
-    /**
-     * Further colourways of this same product that also cleared the signature and
-     * were collapsed into this line. A COUNTED collapse: `0` means this product
-     * offered exactly one match, never that the count is unknown.
-     */
-    otherColourways: number;
-    basis: FinishScheduleAlternateBasis;
-}
-/** A slot holding a code with nothing specified against it yet. */
-export interface FinishScheduleOpenSlot {
-    code: string;
-    sectionCode: number;
-    sectionName: string;
-    line: number;
-    slotId: SlotId;
-    slotName: string;
-    space: string | null;
-    /**
-     * Why this line is blank, in words — or `null` when nothing measured a reason.
-     *
-     * `null` is NOT "nothing was found". It means no diagnosis was recorded for
-     * this slot, most often because it was never searched, and it must not be
-     * rendered as a search that came back empty.
-     */
-    reason: string | null;
-}
-/** One row: one slot, one specified material, fully graded. */
-export interface FinishScheduleRow {
-    /** Criteria carried from the programme; absent on older schedule artifacts. */
-    criteria?: FinishScheduleCriterion[];
-    requiredCriteria?: FinishScheduleCriterion[];
-    preferredCriteria?: FinishScheduleCriterion[];
-    /**
-     * The printed line reference, e.g. `L-101` — how a drawing, an RFI or a
-     * substitution request names this line. Allocated from the Run's PROGRAMME
-     * rather than its picks, so recomposing the scheme, varying it, or accepting a
-     * substitution renumbers nothing.
-     */
-    code: string;
-    /** The hundreds block this line sits in, e.g. `100`. */
-    sectionCode: number;
-    sectionName: string;
-    /** The 1-based line within its (space, section) group. */
-    line: number;
-    slotId: SlotId;
-    slotName: string;
-    /** The space NAME, or null for a spaceless slot. */
-    space: string | null;
-    element: string | null;
-    /** True when the designer pinned this pick rather than the engine choosing it. */
-    anchored: boolean;
-    brand: string;
-    product: string;
-    variant: string;
-    /** Opaque — round-trip verbatim into the material lenses. */
-    variantId: VariantId;
-    /** Relative path to the public material record (`/materials/{variantId}`). */
-    recordUrl: string;
-    imageUrl: string | null;
-    hex: string | null;
-    /** Always the full, identically-ordered column set. */
-    attributes: FinishScheduleCell[];
-    fitNotes: string[];
-    grade: FinishScheduleGrade;
-    /**
-     * Or-equal alternates for this line. An empty array is AMBIGUOUS on its own —
-     * read it with {@link FinishSchedule.alternatesResolved}.
-     */
-    alternates: FinishScheduleAlternate[];
-}
-/** A whole composed scheme as an issuable finish schedule. */
-export interface FinishSchedule {
-    runId: RunId;
-    schemeId: SchemeId;
-    title: string;
-    /** The compose contract version stamped on the Run, or `"unknown"`. */
-    composeVersion: string;
-    /** ISO timestamp the export was compiled at. */
-    generatedAt: string;
-    /** The stable column order every row's `attributes` array follows. */
-    columns: FinishScheduleColumn[];
-    /**
-     * The section table to group by, in schedule order. A section may carry no
-     * rows: three are reserved so their conventional numbers are held rather than
-     * reused, and any section can simply be unspecified in this scheme.
-     */
-    sections: FinishScheduleSection[];
-    /** In READING order — space, then section, then line. Not pick order. */
-    rows: FinishScheduleRow[];
-    /**
-     * Slots holding a code with nothing specified against them. Served explicitly
-     * because a schedule that omitted them would read as complete.
-     */
-    openSlots: FinishScheduleOpenSlot[];
-    /**
-     * Whether the or-equal lookup RAN. When false, no row's empty `alternates`
-     * may be read as "no alternate exists".
-     */
-    alternatesResolved: boolean;
-}
-/** `GET /api/v1/runs/{runId}/schedule`. */
-export interface FinishScheduleResponse {
-    schedule: FinishSchedule;
-}
-/** Options for {@link getRunSchedule}. */
-export interface GetRunScheduleOptions {
-    /** Which composed scheme to export; defaults to the Run's first scheme. Opaque. */
-    schemeId?: SchemeId;
-    signal?: AbortSignal;
-}

package/schedule-types.js

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