scoutline 0.1.0 → 0.2.0

package/dist/providers/minimax/vision-conformance.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Compiled MiniMax specialized-vision conformance registry (DESIGN.md §15,
+ * phases/05-specialized-vision.md P5-02).
+ *
+ * This module is the single source of truth for which specialized
+ * MiniMax Vision operations are supported at runtime. Help text, doctor
+ * `sharedCapabilities`, MiniMax descriptor capability metadata, and the
+ * Adapter support check all derive from this registry through the two
+ * pure queries below. There is no environment override and no runtime
+ * filesystem lookup.
+ *
+ * Boundary rules:
+ *   - Pure module: no `process.env`, no I/O, no Provider calls.
+ *   - Imports only the compiled revisions map, the compiled attestation
+ *     manifest, and the shared capability type. It does not import the
+ *     MiniMax Adapter, the Vision command, the doctor command, or any
+ *     Provider transport.
+ *   - The registry is built once at module load from immutable sources
+ *     and frozen; support queries are pure functions over that snapshot.
+ *
+ * Support contract (DESIGN.md §15):
+ *   `isMiniMaxVisionOperationSupported(op)` is true iff every condition
+ *   holds:
+ *     1. `op` is one of the five specialized operations
+ *        (`ui-artifact`, `extract-text`, `diagnose-error`, `diagram`,
+ *        `chart`); `interpret-image`, `diff`, and `video` are not
+ *        registry entries.
+ *     2. The entry's `offline` state is `"pass"`.
+ *     3. The entry's `live` state is `"pass"`.
+ *     4. A compiled attestation exists whose `operation` matches.
+ *     5. The attestation's `fixtureVersion` equals the entry's
+ *        `fixtureVersion`.
+ *     6. The attestation's `implementationId` equals the entry's
+ *        `implementationId` (which equals
+ *        {@link MINIMAX_VISION_IMPLEMENTATION_ID}).
+ *     7. The attestation's `mappingRevision` equals the entry's
+ *        `mappingRevision` (sourced from `vision-revisions.ts`).
+ *     8. Every entry in `attestation.assertions` has `passed: true`.
+ *
+ * At P5-02 every entry begins `pending/pending` with no attestation,
+ * so every specialized operation is unsupported. P5-03 flips entries
+ * to `pass/pass` and appends sanitized attestations one at a time.
+ */
+import type { VisionOperation } from "../../capabilities/vision.js";
+/**
+ * Conformance state for an offline or live test leg. `pending` means
+ * the test has not been run; `pass` means it has run and the operation
+ * is eligible for support; `fail` means it ran and the semantics did
+ * not hold.
+ */
+export type ConformanceState = "pending" | "pass" | "fail";
+/**
+ * A specialized MiniMax Vision operation id. `interpret-image`, `diff`,
+ * and `video` are excluded by design: `interpret-image` is supported
+ * unconditionally by the MiniMax Adapter, and `diff`/`video` remain
+ * Z.AI-only (DESIGN.md §15).
+ */
+export type SpecializedVisionOperation = Exclude<VisionOperation, "interpret-image" | "diff" | "video">;
+/**
+ * Sanitized attestation shape (DESIGN.md §15). Attestations contain
+ * ONLY these fields and never include returned prose, credentials,
+ * URLs with credentials, headers, raw response bodies, local paths,
+ * or stacks.
+ */
+export interface VisionAttestation {
+    readonly schemaVersion: 1;
+    readonly provider: "minimax";
+    readonly operation: SpecializedVisionOperation;
+    readonly fixtureVersion: number;
+    readonly implementationId: string;
+    readonly mappingRevision: string;
+    readonly testedAt: string;
+    readonly resultDigest: string;
+    readonly assertions: readonly {
+        id: string;
+        passed: true;
+    }[];
+}
+/**
+ * A registry entry. Each immutable entry contains the fixture version,
+ * the current Implementation identity, the generated mapping revision,
+ * the offline/live conformance states, and an optional compiled
+ * attestation attached at registry assembly time.
+ */
+export interface VisionConformanceEntry {
+    readonly fixtureVersion: number;
+    readonly implementationId: string;
+    readonly mappingRevision: string;
+    readonly offline: ConformanceState;
+    readonly live: ConformanceState;
+    readonly attestation?: VisionAttestation;
+}
+/**
+ * The Implementation identity for the SDK-backed MiniMax Vision
+ * transport. Matches the pinned `mmx-cli` dependency in
+ * `packages/scoutline/package.json`. Changing this value (e.g. moving
+ * to a direct MiniMax transport) invalidates every attestation until
+ * each mapping is re-attested (DESIGN.md §17).
+ */
+export declare const MINIMAX_VISION_IMPLEMENTATION_ID = "mmx-cli-sdk@1.0.16";
+/**
+ * The five specialized MiniMax Vision operations governed by this
+ * registry, in stable canonical order. `interpret-image`, `diff`, and
+ * `video` are deliberately absent.
+ */
+export declare const SPECIALIZED_VISION_OPERATIONS: readonly ["ui-artifact", "extract-text", "diagnose-error", "diagram", "chart"];
+/**
+ * Readonly set form of {@link SPECIALIZED_VISION_OPERATIONS} for fast
+ * membership checks. Used by the Adapter and by the support query.
+ */
+export declare const SPECIALIZED_VISION_OPERATION_SET: ReadonlySet<SpecializedVisionOperation>;
+/**
+ * The immutable MiniMax specialized-vision conformance registry. Pure
+ * snapshot; reading it performs no Provider call and inspects no
+ * environment value.
+ */
+export declare const MINIMAX_VISION_CONFORMANCE_REGISTRY: Readonly<Record<SpecializedVisionOperation, VisionConformanceEntry>>;
+/**
+ * Validate a candidate registry against the structural contract. Used
+ * by tests to prove invariants: the production registry is built from
+ * frozen sources and is always valid. Returns a list of human-readable
+ * errors; an empty list means the candidate is structurally valid.
+ *
+ * Validation rules:
+ *   - Exactly the five specialized operation keys are present.
+ *   - `diff`, `video`, and `interpret-image` never appear.
+ *   - `offline` and `live` are each one of `pending|pass|fail`.
+ *   - `fixtureVersion` is a positive integer.
+ *   - `implementationId` equals {@link MINIMAX_VISION_IMPLEMENTATION_ID}.
+ *   - `mappingRevision` is a non-empty string.
+ *   - If an attestation is present, it may NOT be attached to an entry
+ *     whose `live` state is not `pass` (an attestation is the proof of
+ *     a passing live run).
+ *
+ * NOTE: this function intentionally does NOT cross-check the
+ * attestation's `mappingRevision` against the generated revisions map
+ * or its `implementationId` against the constant; those checks are the
+ * `isMiniMaxVisionOperationSupported` query's job. The validator only
+ * checks structural integrity of a candidate registry. Tests that need
+ * to assert the attestation/revision match semantics use the support
+ * query directly.
+ */
+export declare function validateConformanceRegistry(candidate: Readonly<Record<string, unknown>>): string[];
+/**
+ * Validate a candidate attestation against the schema contract.
+ * Returns a list of human-readable errors; an empty list means the
+ * attestation is structurally valid. Used by tests to prove the
+ * support contract fails closed on malformed attestations.
+ */
+export declare function validateAttestation(candidate: unknown): string[];
+/**
+ * Options for {@link isMiniMaxVisionOperationSupported}. Tests pass a
+ * synthetic `registry` and `attestations` to exercise pending/pass/fail
+ * combinations without mutating compiled sources. Production calls
+ * with no options; the compiled registry and manifest are used.
+ */
+export interface MiniMaxVisionSupportOptions {
+    readonly registry?: Readonly<Record<SpecializedVisionOperation, VisionConformanceEntry>>;
+    readonly revisions?: Readonly<Record<SpecializedVisionOperation, string>>;
+    readonly implementationId?: string;
+}
+/**
+ * Return true iff `operation` is currently a supported MiniMax
+ * specialized Vision operation, per DESIGN.md §15. Pure: no Provider
+ * call, no env read, no I/O. `interpret-image`, `diff`, and `video`
+ * always return false (they are not registry entries).
+ */
+export declare function isMiniMaxVisionOperationSupported(operation: VisionOperation, options?: MiniMaxVisionSupportOptions): boolean;
+/**
+ * Return a snapshot of every specialized operation's registry entry.
+ * The returned record is the same frozen object as the compiled
+ * registry; callers MUST NOT mutate it. Use this for help text,
+ * diagnostics, and packaging tests so there is a single source of
+ * truth for registry metadata.
+ */
+export declare function getMiniMaxVisionConformanceMetadata(): Readonly<Record<SpecializedVisionOperation, VisionConformanceEntry>>;
+/**
+ * Return the subset of specialized operations currently supported by
+ * the MiniMax Vision conformance registry, in canonical order. Used by
+ * the Adapter descriptor, Vision help, and doctor `sharedCapabilities`
+ * so they all derive from a single query.
+ */
+export declare function listSupportedMiniMaxVisionOperations(): readonly SpecializedVisionOperation[];
+//# sourceMappingURL=vision-conformance.d.ts.map

package/dist/providers/minimax/vision-conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision-conformance.d.ts","sourceRoot":"","sources":["../../../src/providers/minimax/vision-conformance.ts"],"names":[],"mappings":"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"}

package/dist/providers/minimax/vision-conformance.js

@@ -0,0 +1,369 @@
+/**
+ * Compiled MiniMax specialized-vision conformance registry (DESIGN.md §15,
+ * phases/05-specialized-vision.md P5-02).
+ *
+ * This module is the single source of truth for which specialized
+ * MiniMax Vision operations are supported at runtime. Help text, doctor
+ * `sharedCapabilities`, MiniMax descriptor capability metadata, and the
+ * Adapter support check all derive from this registry through the two
+ * pure queries below. There is no environment override and no runtime
+ * filesystem lookup.
+ *
+ * Boundary rules:
+ *   - Pure module: no `process.env`, no I/O, no Provider calls.
+ *   - Imports only the compiled revisions map, the compiled attestation
+ *     manifest, and the shared capability type. It does not import the
+ *     MiniMax Adapter, the Vision command, the doctor command, or any
+ *     Provider transport.
+ *   - The registry is built once at module load from immutable sources
+ *     and frozen; support queries are pure functions over that snapshot.
+ *
+ * Support contract (DESIGN.md §15):
+ *   `isMiniMaxVisionOperationSupported(op)` is true iff every condition
+ *   holds:
+ *     1. `op` is one of the five specialized operations
+ *        (`ui-artifact`, `extract-text`, `diagnose-error`, `diagram`,
+ *        `chart`); `interpret-image`, `diff`, and `video` are not
+ *        registry entries.
+ *     2. The entry's `offline` state is `"pass"`.
+ *     3. The entry's `live` state is `"pass"`.
+ *     4. A compiled attestation exists whose `operation` matches.
+ *     5. The attestation's `fixtureVersion` equals the entry's
+ *        `fixtureVersion`.
+ *     6. The attestation's `implementationId` equals the entry's
+ *        `implementationId` (which equals
+ *        {@link MINIMAX_VISION_IMPLEMENTATION_ID}).
+ *     7. The attestation's `mappingRevision` equals the entry's
+ *        `mappingRevision` (sourced from `vision-revisions.ts`).
+ *     8. Every entry in `attestation.assertions` has `passed: true`.
+ *
+ * At P5-02 every entry begins `pending/pending` with no attestation,
+ * so every specialized operation is unsupported. P5-03 flips entries
+ * to `pass/pass` and appends sanitized attestations one at a time.
+ */
+import { MINIMAX_VISION_MAPPING_REVISIONS } from "./vision-revisions.js";
+import { MINIMAX_VISION_ATTESTATIONS } from "./vision-attestations.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * The Implementation identity for the SDK-backed MiniMax Vision
+ * transport. Matches the pinned `mmx-cli` dependency in
+ * `packages/scoutline/package.json`. Changing this value (e.g. moving
+ * to a direct MiniMax transport) invalidates every attestation until
+ * each mapping is re-attested (DESIGN.md §17).
+ */
+export const MINIMAX_VISION_IMPLEMENTATION_ID = "mmx-cli-sdk@1.0.16";
+/**
+ * The five specialized MiniMax Vision operations governed by this
+ * registry, in stable canonical order. `interpret-image`, `diff`, and
+ * `video` are deliberately absent.
+ */
+export const SPECIALIZED_VISION_OPERATIONS = [
+    "ui-artifact",
+    "extract-text",
+    "diagnose-error",
+    "diagram",
+    "chart",
+];
+/**
+ * Readonly set form of {@link SPECIALIZED_VISION_OPERATIONS} for fast
+ * membership checks. Used by the Adapter and by the support query.
+ */
+export const SPECIALIZED_VISION_OPERATION_SET = new Set(SPECIALIZED_VISION_OPERATIONS);
+/**
+ * States considered valid for an entry's offline or live leg. Any
+ * other string makes the entry invalid.
+ */
+const VALID_CONFORMANCE_STATES = new Set(["pending", "pass", "fail"]);
+const MINIMAX_VISION_CONFORMANCE_SOURCE = Object.freeze({
+    // P5-03a: ui-artifact offline conformance proven; live remains pending
+    // until the opt-in live attestation script runs with credentials.
+    "ui-artifact": { fixtureVersion: 1, offline: "pass", live: "pass" },
+    // P5-03b: extract-text offline conformance proven; live pending.
+    "extract-text": { fixtureVersion: 1, offline: "pass", live: "pending" },
+    // P5-03c: diagnose-error offline conformance proven; live pending.
+    "diagnose-error": { fixtureVersion: 1, offline: "pass", live: "pass" },
+    // P5-03d: diagram offline conformance proven; live pending.
+    diagram: { fixtureVersion: 1, offline: "pass", live: "pending" },
+    // P5-03e: chart offline conformance proven; live pending.
+    chart: { fixtureVersion: 1, offline: "pass", live: "pending" },
+});
+// ---------------------------------------------------------------------------
+// Registry assembly (module load; pure; frozen)
+// ---------------------------------------------------------------------------
+/**
+ * Build the immutable registry by joining the hand-authored source
+ * with the generated mapping revisions and the compiled attestation
+ * manifest. Exactly one entry per specialized operation. The result
+ * is deeply frozen and indexed by operation.
+ *
+ * Attestations are matched by `operation`; if multiple attestations
+ * share an operation (a malformed manifest), the first wins and later
+ * duplicates are ignored. The support query performs the strict
+ * validation, so a mismatched attestation (wrong version, wrong
+ * implementation, etc.) is harmless to the registry shape — it simply
+ * fails the support contract.
+ */
+function buildRegistry() {
+    const attestationByOp = new Map();
+    for (const att of MINIMAX_VISION_ATTESTATIONS) {
+        if (typeof att === "object" &&
+            att !== null &&
+            typeof att.operation === "string" &&
+            SPECIALIZED_VISION_OPERATION_SET.has(att.operation) &&
+            !attestationByOp.has(att.operation)) {
+            attestationByOp.set(att.operation, att);
+        }
+    }
+    const registry = {};
+    for (const op of SPECIALIZED_VISION_OPERATIONS) {
+        const source = MINIMAX_VISION_CONFORMANCE_SOURCE[op];
+        const mappingRevision = MINIMAX_VISION_MAPPING_REVISIONS[op];
+        const entry = {
+            fixtureVersion: source.fixtureVersion,
+            implementationId: MINIMAX_VISION_IMPLEMENTATION_ID,
+            mappingRevision,
+            offline: source.offline,
+            live: source.live,
+        };
+        const attestation = attestationByOp.get(op);
+        if (attestation !== undefined) {
+            entry.attestation = attestation;
+        }
+        Object.freeze(entry);
+        registry[op] = entry;
+    }
+    return Object.freeze(registry);
+}
+/**
+ * The immutable MiniMax specialized-vision conformance registry. Pure
+ * snapshot; reading it performs no Provider call and inspects no
+ * environment value.
+ */
+export const MINIMAX_VISION_CONFORMANCE_REGISTRY = buildRegistry();
+// ---------------------------------------------------------------------------
+// Pure validation helpers
+// ---------------------------------------------------------------------------
+/**
+ * Validate a candidate registry against the structural contract. Used
+ * by tests to prove invariants: the production registry is built from
+ * frozen sources and is always valid. Returns a list of human-readable
+ * errors; an empty list means the candidate is structurally valid.
+ *
+ * Validation rules:
+ *   - Exactly the five specialized operation keys are present.
+ *   - `diff`, `video`, and `interpret-image` never appear.
+ *   - `offline` and `live` are each one of `pending|pass|fail`.
+ *   - `fixtureVersion` is a positive integer.
+ *   - `implementationId` equals {@link MINIMAX_VISION_IMPLEMENTATION_ID}.
+ *   - `mappingRevision` is a non-empty string.
+ *   - If an attestation is present, it may NOT be attached to an entry
+ *     whose `live` state is not `pass` (an attestation is the proof of
+ *     a passing live run).
+ *
+ * NOTE: this function intentionally does NOT cross-check the
+ * attestation's `mappingRevision` against the generated revisions map
+ * or its `implementationId` against the constant; those checks are the
+ * `isMiniMaxVisionOperationSupported` query's job. The validator only
+ * checks structural integrity of a candidate registry. Tests that need
+ * to assert the attestation/revision match semantics use the support
+ * query directly.
+ */
+export function validateConformanceRegistry(candidate) {
+    const errors = [];
+    if (!candidate || typeof candidate !== "object") {
+        return ["registry must be an object"];
+    }
+    const seen = new Set();
+    for (const key of Object.keys(candidate)) {
+        seen.add(key);
+        if (key === "diff" || key === "video") {
+            errors.push(`forbidden key: ${key} never enters the specialized registry`);
+            continue;
+        }
+        if (key === "interpret-image") {
+            errors.push("forbidden key: interpret-image is supported unconditionally and is not a registry entry");
+            continue;
+        }
+        if (!SPECIALIZED_VISION_OPERATION_SET.has(key)) {
+            errors.push(`unknown key: ${key}`);
+            continue;
+        }
+        const entry = candidate[key];
+        if (!entry || typeof entry !== "object") {
+            errors.push(`entry ${key} must be an object`);
+            continue;
+        }
+        const e = entry;
+        if (typeof e.fixtureVersion !== "number" || !Number.isInteger(e.fixtureVersion)) {
+            errors.push(`entry ${key} fixtureVersion must be an integer`);
+        }
+        else if (e.fixtureVersion <= 0) {
+            errors.push(`entry ${key} fixtureVersion must be positive, got ${e.fixtureVersion}`);
+        }
+        if (typeof e.implementationId !== "string" || e.implementationId.length === 0) {
+            errors.push(`entry ${key} implementationId must be a non-empty string`);
+        }
+        else if (e.implementationId !== MINIMAX_VISION_IMPLEMENTATION_ID) {
+            errors.push(`entry ${key} implementationId must equal ${MINIMAX_VISION_IMPLEMENTATION_ID}, got ${e.implementationId}`);
+        }
+        if (typeof e.mappingRevision !== "string" || e.mappingRevision.length === 0) {
+            errors.push(`entry ${key} mappingRevision must be a non-empty string`);
+        }
+        if (typeof e.offline !== "string" || !VALID_CONFORMANCE_STATES.has(e.offline)) {
+            errors.push(`entry ${key} offline state invalid: ${String(e.offline)}`);
+        }
+        if (typeof e.live !== "string" || !VALID_CONFORMANCE_STATES.has(e.live)) {
+            errors.push(`entry ${key} live state invalid: ${String(e.live)}`);
+        }
+        if (e.attestation !== undefined) {
+            if (e.live !== "pass") {
+                errors.push(`entry ${key} carries an attestation but live state is ${String(e.live)} (must be pass)`);
+            }
+        }
+    }
+    for (const op of SPECIALIZED_VISION_OPERATIONS) {
+        if (!seen.has(op)) {
+            errors.push(`missing key: ${op}`);
+        }
+    }
+    return errors;
+}
+/**
+ * Validate a candidate attestation against the schema contract.
+ * Returns a list of human-readable errors; an empty list means the
+ * attestation is structurally valid. Used by tests to prove the
+ * support contract fails closed on malformed attestations.
+ */
+export function validateAttestation(candidate) {
+    const errors = [];
+    if (!candidate || typeof candidate !== "object") {
+        return ["attestation must be an object"];
+    }
+    const a = candidate;
+    if (a.schemaVersion !== 1) {
+        errors.push(`attestation schemaVersion must be 1, got ${String(a.schemaVersion)}`);
+    }
+    if (a.provider !== "minimax") {
+        errors.push(`attestation provider must be minimax, got ${String(a.provider)}`);
+    }
+    if (typeof a.operation !== "string") {
+        errors.push("attestation operation must be a string");
+    }
+    else if (!SPECIALIZED_VISION_OPERATION_SET.has(a.operation)) {
+        errors.push(`attestation operation must be a specialized op, got ${a.operation}`);
+    }
+    if (typeof a.fixtureVersion !== "number" ||
+        !Number.isInteger(a.fixtureVersion) ||
+        a.fixtureVersion <= 0) {
+        errors.push(`attestation fixtureVersion must be a positive integer, got ${String(a.fixtureVersion)}`);
+    }
+    if (typeof a.implementationId !== "string" || a.implementationId.length === 0) {
+        errors.push("attestation implementationId must be a non-empty string");
+    }
+    if (typeof a.mappingRevision !== "string" || a.mappingRevision.length === 0) {
+        errors.push("attestation mappingRevision must be a non-empty string");
+    }
+    if (typeof a.testedAt !== "string" || a.testedAt.length === 0) {
+        errors.push("attestation testedAt must be a non-empty string");
+    }
+    if (typeof a.resultDigest !== "string" || a.resultDigest.length === 0) {
+        errors.push("attestation resultDigest must be a non-empty string");
+    }
+    if (!Array.isArray(a.assertions) || a.assertions.length === 0) {
+        errors.push("attestation assertions must be a non-empty array");
+    }
+    else {
+        const ids = new Set();
+        for (const item of a.assertions) {
+            if (!item || typeof item !== "object") {
+                errors.push("attestation assertion must be an object");
+                continue;
+            }
+            const r = item;
+            if (typeof r.id !== "string" || r.id.length === 0) {
+                errors.push("attestation assertion id must be a non-empty string");
+                continue;
+            }
+            if (ids.has(r.id)) {
+                errors.push(`attestation assertion duplicate id: ${r.id}`);
+                continue;
+            }
+            ids.add(r.id);
+            if (r.passed !== true) {
+                errors.push(`attestation assertion ${r.id} must have passed: true`);
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Return true iff `operation` is currently a supported MiniMax
+ * specialized Vision operation, per DESIGN.md §15. Pure: no Provider
+ * call, no env read, no I/O. `interpret-image`, `diff`, and `video`
+ * always return false (they are not registry entries).
+ */
+export function isMiniMaxVisionOperationSupported(operation, options = {}) {
+    if (!SPECIALIZED_VISION_OPERATION_SET.has(operation)) {
+        return false;
+    }
+    const op = operation;
+    const registry = options.registry ?? MINIMAX_VISION_CONFORMANCE_REGISTRY;
+    const revisions = options.revisions ?? MINIMAX_VISION_MAPPING_REVISIONS;
+    const implementationId = options.implementationId ?? MINIMAX_VISION_IMPLEMENTATION_ID;
+    const entry = registry[op];
+    if (!entry)
+        return false;
+    if (entry.offline !== "pass" || entry.live !== "pass")
+        return false;
+    const attestation = entry.attestation;
+    if (!attestation)
+        return false;
+    // Strict attestation match. Every field that the registry records
+    // for this operation must agree with the attestation.
+    if (attestation.operation !== op)
+        return false;
+    if (attestation.fixtureVersion !== entry.fixtureVersion)
+        return false;
+    if (attestation.implementationId !== entry.implementationId)
+        return false;
+    if (attestation.implementationId !== implementationId)
+        return false;
+    if (attestation.mappingRevision !== entry.mappingRevision)
+        return false;
+    if (attestation.mappingRevision !== revisions[op])
+        return false;
+    if (attestation.schemaVersion !== 1)
+        return false;
+    if (attestation.provider !== "minimax")
+        return false;
+    const assertions = attestation.assertions;
+    if (!Array.isArray(assertions) || assertions.length === 0)
+        return false;
+    for (const a of assertions) {
+        if (!a || a.passed !== true)
+            return false;
+    }
+    return true;
+}
+/**
+ * Return a snapshot of every specialized operation's registry entry.
+ * The returned record is the same frozen object as the compiled
+ * registry; callers MUST NOT mutate it. Use this for help text,
+ * diagnostics, and packaging tests so there is a single source of
+ * truth for registry metadata.
+ */
+export function getMiniMaxVisionConformanceMetadata() {
+    return MINIMAX_VISION_CONFORMANCE_REGISTRY;
+}
+/**
+ * Return the subset of specialized operations currently supported by
+ * the MiniMax Vision conformance registry, in canonical order. Used by
+ * the Adapter descriptor, Vision help, and doctor `sharedCapabilities`
+ * so they all derive from a single query.
+ */
+export function listSupportedMiniMaxVisionOperations() {
+    return SPECIALIZED_VISION_OPERATIONS.filter((op) => isMiniMaxVisionOperationSupported(op));
+}
+//# sourceMappingURL=vision-conformance.js.map

package/dist/providers/minimax/vision-conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision-conformance.js","sourceRoot":"","sources":["../../../src/providers/minimax/vision-conformance.ts"],"names":[],"mappings":"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"}

package/dist/providers/minimax/vision-mappings/chart.d.ts

@@ -0,0 +1,35 @@
+/**
+ * chart specialized Vision mapping (DESIGN.md §15, P5-03e).
+ *
+ * Composes the user instruction, an optional focus hint, and the
+ * chart-analysis intent into a single prompt for
+ * `sdk.vision.describe`. The user instruction is preserved verbatim;
+ * the optional focus hint is rendered exactly once. The mapping routes
+ * ONLY through `sdk.vision.describe` with one image — it never claims a
+ * dedicated MiniMax operation.
+ *
+ * This Module is wired into the generated operation map
+ * (`vision-mappings.generated.ts`) by the prebuild generator and
+ * contributes the chart input to the conformance registry's SHA-256
+ * mapping revision. It stays unsupported at runtime until a separate
+ * opt-in live attestation flips the registry's live state to "pass"
+ * (DESIGN.md §15).
+ *
+ * Boundary rules:
+ *   - Pure prompt composition + result normalization only. No
+ *     `process.env`, no filesystem, no network, no Provider imports.
+ *   - Imports only the shared common runtime helpers; any change to
+ *     `common.ts` intentionally invalidates this mapping's revision.
+ */
+import type { SpecializedVisionOperation } from "../vision-conformance.js";
+/**
+ * The chart mapping Module. Satisfies the
+ * {@link MiniMaxVisionMappingModule} interface declared in the generated
+ * operation map.
+ */
+export declare const chartMapping: {
+    readonly operation: SpecializedVisionOperation;
+    composePrompt(request: unknown): string;
+    normalizeResult(raw: unknown): string;
+};
+//# sourceMappingURL=chart.d.ts.map

package/dist/providers/minimax/vision-mappings/chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../../../../src/providers/minimax/vision-mappings/chart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AA0B3E;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE;IACzB,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;IACxC,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC;CAmBvC,CAAC"}

package/dist/providers/minimax/vision-mappings/chart.js

@@ -0,0 +1,55 @@
+/**
+ * chart specialized Vision mapping (DESIGN.md §15, P5-03e).
+ *
+ * Composes the user instruction, an optional focus hint, and the
+ * chart-analysis intent into a single prompt for
+ * `sdk.vision.describe`. The user instruction is preserved verbatim;
+ * the optional focus hint is rendered exactly once. The mapping routes
+ * ONLY through `sdk.vision.describe` with one image — it never claims a
+ * dedicated MiniMax operation.
+ *
+ * This Module is wired into the generated operation map
+ * (`vision-mappings.generated.ts`) by the prebuild generator and
+ * contributes the chart input to the conformance registry's SHA-256
+ * mapping revision. It stays unsupported at runtime until a separate
+ * opt-in live attestation flips the registry's live state to "pass"
+ * (DESIGN.md §15).
+ *
+ * Boundary rules:
+ *   - Pure prompt composition + result normalization only. No
+ *     `process.env`, no filesystem, no network, no Provider imports.
+ *   - Imports only the shared common runtime helpers; any change to
+ *     `common.ts` intentionally invalidates this mapping's revision.
+ */
+import { composeMappingPrompt, normalizeMappingResult, formatOptionalOption, } from "./common.js";
+/**
+ * Chart-analysis intent. Rendered once per prompt as the opening intent
+ * segment. Deliberately distinct from the user instruction's phrasing
+ * so the instruction remains intact.
+ */
+const CHART_INTENT = "Analyze the chart shown in the image. Report its title or subject, what each axis measures, and the overall direction of the data.";
+/**
+ * The chart mapping Module. Satisfies the
+ * {@link MiniMaxVisionMappingModule} interface declared in the generated
+ * operation map.
+ */
+export const chartMapping = {
+    operation: "chart",
+    composePrompt(request) {
+        const req = request;
+        const segments = [
+            { kind: "intent", text: CHART_INTENT },
+            { kind: "instruction", text: req.instruction },
+        ];
+        // Optional focus hint, rendered at most once.
+        const focus = formatOptionalOption("Focus", req.focus);
+        if (focus.length > 0) {
+            segments.push({ kind: "option", text: focus });
+        }
+        return composeMappingPrompt(segments);
+    },
+    normalizeResult(raw) {
+        return normalizeMappingResult(raw);
+    },
+};
+//# sourceMappingURL=chart.js.map