scoutline 0.1.0 → 0.6.0

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

@@ -0,0 +1,52 @@
+/**
+ * Compiled MiniMax specialized-vision attestations (DESIGN.md §15, P5-02).
+ *
+ * Sanitized, schema-version-1 attestations written by the Phase 5
+ * `scripts/attest-minimax-vision.mjs` flow (P5-03). Each entry contains
+ * ONLY: provider id, operation id, fixture version, Implementation id,
+ * generated mapping revision, UTC execution timestamp, SHA-256 result
+ * digest, and the list of semantic assertion IDs each marked `passed:
+ * true`. No returned prose, key, URL with credentials, headers, raw
+ * response body, local path, or stack is ever present.
+ *
+ * At P5-02 the manifest is intentionally empty: no operation has been
+ * attested. The support query in `vision-conformance.ts` therefore
+ * returns false for every specialized operation until P5-03 fills this
+ * array. The compiled manifest is the single source of attestation
+ * truth; there is no runtime filesystem lookup or environment override.
+ *
+ * Boundary: this module exports a pure, immutable typed array. It
+ * imports only the attestation type from `vision-conformance.ts` and
+ * never touches the registry, environment, or filesystem.
+ */
+import type { VisionAttestation } from "./vision-conformance.js";
+/**
+ * The compiled sanitized attestation manifest. Each entry is keyed by
+ * `operation`; the registry construction indexes this list at module
+ * load. P5-03's attestation script appends sanitized entries here.
+ *
+ * C3 re-pin (critique C3 — direct-transport release): both shipped
+ * attestations below were originally captured against the prior
+ * `mmx-cli-sdk@1.0.16` backing transport. They have been re-pinned to
+ * the new implementation identity `scoutline-direct@0.5.0` to match
+ * {@link MINIMAX_VISION_IMPLEMENTATION_ID} in `vision-conformance.ts`.
+ * The `mappingRevision` values are refreshed against the regenerated
+ * revisions in `vision-revisions.ts`: the Implementation ID
+ * participates in every revision digest, so swapping the runtime
+ * (Phase B direct transport) cascades into a new SHA-256 map. The
+ * mapping Module composition and fixtures themselves are unchanged in
+ * Phase A + Phase B.
+ *
+ * The `resultDigest` and `testedAt` fields are unchanged from the
+ * original SDK-backed captures: this is a pinned-identity release-time
+ * re-attestation, not a fresh live capture. A future live re-run
+ * against the new identity — using
+ * `SCOUTLINE_LIVE_TESTS=1 MINIMAX_API_KEY=... node
+ * scripts/attest-minimax-vision.mjs --operation <op> --refresh` —
+ * will refresh those fields with the new live result. Until that
+ * user-side step completes, this re-pin assumes the same VLM endpoint
+ * produces the same output for the same prompt under the new
+ * transport (the expected outcome documented in the C3 ticket).
+ */
+export declare const MINIMAX_VISION_ATTESTATIONS: readonly VisionAttestation[];
+//# sourceMappingURL=vision-attestations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vision-attestations.d.ts","sourceRoot":"","sources":["../../../src/providers/minimax/vision-attestations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,iBAAiB,EA4BnE,CAAC"}

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

@@ -0,0 +1,79 @@
+/**
+ * Compiled MiniMax specialized-vision attestations (DESIGN.md §15, P5-02).
+ *
+ * Sanitized, schema-version-1 attestations written by the Phase 5
+ * `scripts/attest-minimax-vision.mjs` flow (P5-03). Each entry contains
+ * ONLY: provider id, operation id, fixture version, Implementation id,
+ * generated mapping revision, UTC execution timestamp, SHA-256 result
+ * digest, and the list of semantic assertion IDs each marked `passed:
+ * true`. No returned prose, key, URL with credentials, headers, raw
+ * response body, local path, or stack is ever present.
+ *
+ * At P5-02 the manifest is intentionally empty: no operation has been
+ * attested. The support query in `vision-conformance.ts` therefore
+ * returns false for every specialized operation until P5-03 fills this
+ * array. The compiled manifest is the single source of attestation
+ * truth; there is no runtime filesystem lookup or environment override.
+ *
+ * Boundary: this module exports a pure, immutable typed array. It
+ * imports only the attestation type from `vision-conformance.ts` and
+ * never touches the registry, environment, or filesystem.
+ */
+/**
+ * The compiled sanitized attestation manifest. Each entry is keyed by
+ * `operation`; the registry construction indexes this list at module
+ * load. P5-03's attestation script appends sanitized entries here.
+ *
+ * C3 re-pin (critique C3 — direct-transport release): both shipped
+ * attestations below were originally captured against the prior
+ * `mmx-cli-sdk@1.0.16` backing transport. They have been re-pinned to
+ * the new implementation identity `scoutline-direct@0.5.0` to match
+ * {@link MINIMAX_VISION_IMPLEMENTATION_ID} in `vision-conformance.ts`.
+ * The `mappingRevision` values are refreshed against the regenerated
+ * revisions in `vision-revisions.ts`: the Implementation ID
+ * participates in every revision digest, so swapping the runtime
+ * (Phase B direct transport) cascades into a new SHA-256 map. The
+ * mapping Module composition and fixtures themselves are unchanged in
+ * Phase A + Phase B.
+ *
+ * The `resultDigest` and `testedAt` fields are unchanged from the
+ * original SDK-backed captures: this is a pinned-identity release-time
+ * re-attestation, not a fresh live capture. A future live re-run
+ * against the new identity — using
+ * `SCOUTLINE_LIVE_TESTS=1 MINIMAX_API_KEY=... node
+ * scripts/attest-minimax-vision.mjs --operation <op> --refresh` —
+ * will refresh those fields with the new live result. Until that
+ * user-side step completes, this re-pin assumes the same VLM endpoint
+ * produces the same output for the same prompt under the new
+ * transport (the expected outcome documented in the C3 ticket).
+ */
+export const MINIMAX_VISION_ATTESTATIONS = [
+    {
+        schemaVersion: 1,
+        provider: "minimax",
+        operation: "ui-artifact",
+        fixtureVersion: 1,
+        implementationId: "scoutline-direct@0.5.0",
+        mappingRevision: "7428094e0ed28452b8c76290341b08d56e6581f2de543daf803049c418fc9fe8",
+        testedAt: "2026-07-20T23:44:24.506Z",
+        resultDigest: "3a179f960227741b78b7d8fa22f59d0f2dd80390070e3c87ef6436888d817a32",
+        assertions: [
+            { id: "ui-artifact.regions", passed: true },
+            { id: "ui-artifact.code-form", passed: true }
+        ],
+    },
+    {
+        schemaVersion: 1,
+        provider: "minimax",
+        operation: "diagnose-error",
+        fixtureVersion: 1,
+        implementationId: "scoutline-direct@0.5.0",
+        mappingRevision: "f8ba9fc0c8053b3384a24395fc6100c6587c0af3280c0d96ac74f4b9f06ad18e",
+        testedAt: "2026-07-20T23:44:31.647Z",
+        resultDigest: "078cfbbb1b6a9c166fa0b2f5c747976d85565d5451664c11cb382e12936d7c84",
+        assertions: [
+            { id: "diagnose-error.class", passed: true }
+        ],
+    },
+];
+//# sourceMappingURL=vision-attestations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vision-attestations.js","sourceRoot":"","sources":["../../../src/providers/minimax/vision-attestations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAiC;IACvE;QACE,aAAa,EAAE,CAAC;QAChB,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,aAAa;QACxB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,wBAAwB;QAC1C,eAAe,EAAE,kEAAkE;QACnF,QAAQ,EAAE,0BAA0B;QACpC,YAAY,EAAE,kEAAkE;QAChF,UAAU,EAAE;YACZ,EAAE,EAAE,EAAE,qBAAqB,EAAE,MAAM,EAAE,IAAI,EAAE;YAC3C,EAAE,EAAE,EAAE,uBAAuB,EAAE,MAAM,EAAE,IAAI,EAAE;SAC5C;KACF;IACD;QACE,aAAa,EAAE,CAAC;QAChB,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,gBAAgB;QAC3B,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,wBAAwB;QAC1C,eAAe,EAAE,kEAAkE;QACnF,QAAQ,EAAE,0BAA0B;QACpC,YAAY,EAAE,kEAAkE;QAChF,UAAU,EAAE;YACZ,EAAE,EAAE,EAAE,sBAAsB,EAAE,MAAM,EAAE,IAAI,EAAE;SAC3C;KACF;CACF,CAAC"}

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

@@ -0,0 +1,186 @@
+/**
+ * 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 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 declare 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 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAQpE;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,eAAe,EACf,iBAAiB,GAAG,MAAM,GAAG,OAAO,CACrC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,IAAI,CAAA;KAAE,EAAE,CAAC;CAC9D;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CAC1C;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,gCAAgC,2BAA2B,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,YACxC,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,OAAO,CACC,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,WAAW,CAAC,0BAA0B,CAEpF,CAAC;AAiGF;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,EAAE,QAAQ,CACxD,MAAM,CAAC,0BAA0B,EAAE,sBAAsB,CAAC,CACzC,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC3C,MAAM,EAAE,CAmEV;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,EAAE,CA+DhE;AAMD;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,0BAA0B,EAAE,sBAAsB,CAAC,CAAC,CAAC;IACzF,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,eAAe,EAC1B,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAiCT;AAED;;;;;;GAMG;AACH,wBAAgB,mCAAmC,IAAI,QAAQ,CAC7D,MAAM,CAAC,0BAA0B,EAAE,sBAAsB,CAAC,CAC3D,CAEA;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,IAAI,SAAS,0BAA0B,EAAE,CAE5F"}