scoutline 0.1.0 → 0.6.0

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

@@ -0,0 +1,371 @@
+/**
+ * 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 direct MiniMax Vision transport
+ * maintained by Scoutline itself (Phase B — critique C3). The previous
+ * SDK-backed identity (`mmx-cli-sdk@1.0.16`) pinned the bundled
+ * `mmx-cli` runtime; this release replaces it with Scoutline's
+ * maintained direct transport. Changing this value (e.g. swapping
+ * transports again) invalidates every attestation until each mapping is
+ * re-attested (DESIGN.md §17).
+ */
+export const MINIMAX_VISION_IMPLEMENTATION_ID = "scoutline-direct@0.5.0";
+/**
+ * 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart.js","sourceRoot":"","sources":["../../../../src/providers/minimax/vision-mappings/chart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,GAErB,MAAM,aAAa,CAAC;AAYrB;;;;GAIG;AACH,MAAM,YAAY,GAChB,oIAAoI,CAAC;AAEvI;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAIrB;IACF,SAAS,EAAE,OAAO;IAClB,aAAa,CAAC,OAAgB;QAC5B,MAAM,GAAG,GAAG,OAAuB,CAAC;QACpC,MAAM,QAAQ,GAA2B;YACvC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE;YACtC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE;SAC/C,CAAC;QACF,8CAA8C;QAC9C,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IACD,eAAe,CAAC,GAAY;QAC1B,OAAO,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,60 @@
+/**
+ * Stable common mapping runtime for MiniMax specialized Vision mappings
+ * (DESIGN.md §15, phases/05-specialized-vision.md P5-02).
+ *
+ * P5-03's operation-specific Modules (`vision-mappings/{op}.ts`) import
+ * shared helpers from this file. Keeping the shared prompt-composition
+ * and result-normalization logic here means a single intentional edit
+ * invalidates every mapping revision at once — exactly the contract
+ * the conformance registry enforces.
+ *
+ * Boundary rules:
+ *   - Pure helpers only. No `process.env`, no filesystem, no network,
+ *     no Provider imports.
+ *   - No operation-specific knowledge lives here; per-operation
+ *     prompts belong in each Module.
+ *   - The byte-content of this file is one of the inputs to every
+ *     generated mapping revision, so changing it intentionally
+ *     invalidates every mapping's attestation.
+ *
+ * At P5-02 the helpers below are foundational; no operation Module
+ * imports them yet. P5-03a–P5-03e will compose prompts through
+ * `composeMappingPrompt` and normalize results through
+ * `normalizeMappingResult`.
+ */
+/**
+ * A single composed prompt segment. Segments are joined with blank-line
+ * separators so each segment (intent, instruction, options) forms a
+ * distinct paragraph in the rendered prompt.
+ */
+export interface MappingPromptSegment {
+    readonly kind: "intent" | "instruction" | "option" | "constraint";
+    readonly text: string;
+}
+/**
+ * Compose a deterministic multi-paragraph prompt from segments.
+ * Trims each segment, drops empties, and joins with exactly one blank
+ * line between segments. The composed prompt is stable: identical
+ * inputs always produce byte-identical output, which makes the
+ * operation Module's revision reproducible.
+ */
+export declare function composeMappingPrompt(segments: readonly MappingPromptSegment[]): string;
+/**
+ * Normalize the MiniMax Vision `sdk.vision.describe` envelope to a
+ * nonempty text string. The characterized envelope is
+ * `{ content: string }`; any other shape, or empty content, is a
+ * malformed result.
+ *
+ * Operation Modules in P5-03 will route through this helper so that
+ * every specialized mapping applies the same result-shape contract.
+ */
+export declare function normalizeMappingResult(raw: unknown): string;
+/**
+ * Format an optional string option as a labelled prompt line, or
+ * return the empty string when the value is absent or whitespace-only.
+ * Used by operation Modules to render optional fields (programming
+ * language, diagram type, focus, context) into the prompt without
+ * duplicating the guard logic.
+ */
+export declare function formatOptionalOption(label: string, value: string | undefined): string;
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/providers/minimax/vision-mappings/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,YAAY,CAAC;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,GAAG,MAAM,CAKtF;AAMD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQ3D;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGrF"}

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

@@ -0,0 +1,75 @@
+/**
+ * Stable common mapping runtime for MiniMax specialized Vision mappings
+ * (DESIGN.md §15, phases/05-specialized-vision.md P5-02).
+ *
+ * P5-03's operation-specific Modules (`vision-mappings/{op}.ts`) import
+ * shared helpers from this file. Keeping the shared prompt-composition
+ * and result-normalization logic here means a single intentional edit
+ * invalidates every mapping revision at once — exactly the contract
+ * the conformance registry enforces.
+ *
+ * Boundary rules:
+ *   - Pure helpers only. No `process.env`, no filesystem, no network,
+ *     no Provider imports.
+ *   - No operation-specific knowledge lives here; per-operation
+ *     prompts belong in each Module.
+ *   - The byte-content of this file is one of the inputs to every
+ *     generated mapping revision, so changing it intentionally
+ *     invalidates every mapping's attestation.
+ *
+ * At P5-02 the helpers below are foundational; no operation Module
+ * imports them yet. P5-03a–P5-03e will compose prompts through
+ * `composeMappingPrompt` and normalize results through
+ * `normalizeMappingResult`.
+ */
+import { ApiError } from "../../../lib/errors.js";
+/**
+ * Compose a deterministic multi-paragraph prompt from segments.
+ * Trims each segment, drops empties, and joins with exactly one blank
+ * line between segments. The composed prompt is stable: identical
+ * inputs always produce byte-identical output, which makes the
+ * operation Module's revision reproducible.
+ */
+export function composeMappingPrompt(segments) {
+    const cleaned = segments
+        .map((s) => (typeof s?.text === "string" ? s.text.trim() : ""))
+        .filter((text) => text.length > 0);
+    return cleaned.join("\n\n");
+}
+// ---------------------------------------------------------------------------
+// Result normalization
+// ---------------------------------------------------------------------------
+/**
+ * Normalize the MiniMax Vision `sdk.vision.describe` envelope to a
+ * nonempty text string. The characterized envelope is
+ * `{ content: string }`; any other shape, or empty content, is a
+ * malformed result.
+ *
+ * Operation Modules in P5-03 will route through this helper so that
+ * every specialized mapping applies the same result-shape contract.
+ */
+export function normalizeMappingResult(raw) {
+    if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+        const record = raw;
+        if (typeof record.content === "string" && record.content.trim().length > 0) {
+            return record.content;
+        }
+    }
+    throw new ApiError("MiniMax vision returned a malformed response", 500);
+}
+// ---------------------------------------------------------------------------
+// Option formatting
+// ---------------------------------------------------------------------------
+/**
+ * Format an optional string option as a labelled prompt line, or
+ * return the empty string when the value is absent or whitespace-only.
+ * Used by operation Modules to render optional fields (programming
+ * language, diagram type, focus, context) into the prompt without
+ * duplicating the guard logic.
+ */
+export function formatOptionalOption(label, value) {
+    if (typeof value !== "string" || value.trim().length === 0)
+        return "";
+    return `${label}: ${value.trim()}`;
+}
+//# sourceMappingURL=common.js.map

package/dist/providers/minimax/vision-mappings/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/providers/minimax/vision-mappings/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAgBlD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAyC;IAC5E,MAAM,OAAO,GAAG,QAAQ;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC9D,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,GAA4B,CAAC;QAC5C,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3E,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,QAAQ,CAAC,8CAA8C,EAAE,GAAG,CAAC,CAAC;AAC1E,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,KAAyB;IAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACtE,OAAO,GAAG,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;AACrC,CAAC"}