scoutline 0.1.0 → 0.6.0

package/dist/providers/minimax/media.js

@@ -0,0 +1,232 @@
+/**
+ * MiniMax Provider Media Module (DESIGN.md §9 — P3-02).
+ *
+ * Owns MiniMax-local image media facts: accepted extensions, size limit,
+ * existence check, and absolute-path resolution. Commands pass raw
+ * path-or-URL strings; this module is the single owner of every
+ * Provider-specific media decision for MiniMax images.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import normalized errors from `lib/errors.ts` and the shared
+ *     `ProviderQuotaFetch` port from `providers/types.ts` (HTTP-source
+ *     image fetch only).
+ *   - Content reads happen here, in the Adapter-local media Module,
+ *     since the SDK no longer performs data-URI conversion. The Module
+ *     owns every MiniMax image fact: accepted extensions, size limit,
+ *     existence check, absolute-path resolution, MIME detection, and
+ *     base64 conversion.
+ *
+ * Media rules (DESIGN.md §9 MiniMax Transitional SDK):
+ *   - Local image: JPG, JPEG, PNG, WebP (case-insensitive), at most 50 MiB.
+ *   - HTTP(S) source is accepted.
+ *   - Local source becomes an absolute path after validation.
+ *   - `convertToDataUri` performs data-URI conversion for HTTP sources
+ *     (fetched bytes) and local paths (read bytes); `data:` URIs pass
+ *     through unchanged.
+ *   - No MiniMax video media module exists in this scope.
+ *   - Missing local file rejects with `FILE_ERROR`.
+ *   - Non-HTTP URL-like strings and unsupported extensions reject with
+ *     `VALIDATION_ERROR` and Provider-specific supported-format help.
+ */
+import * as fs from "node:fs";
+import { readFile } from "node:fs/promises";
+import * as path from "node:path";
+import { ApiError, FileError, NetworkError, TimeoutError, ValidationError, } from "../../lib/errors.js";
+// ---------------------------------------------------------------------------
+// MiniMax media limits (DESIGN.md §9)
+// ---------------------------------------------------------------------------
+const MINIMAX_IMAGE_EXTENSIONS = [".jpg", ".jpeg", ".png", ".webp"];
+const MINIMAX_MAX_IMAGE_BYTES = 50 * 1024 * 1024; // 50 MiB
+const MINIMAX_IMAGE_FORMAT_HELP = "Supported MiniMax image formats: JPG, JPEG, PNG, WebP (max 50 MiB)";
+/**
+ * HTTP image-fetch timeout in milliseconds (DESIGN.md §9, critique G2).
+ * Matches the SDK's effective default (`config.timeout * 1000`,
+ * `config.timeout = 300` → 30 s). Local files are NOT bound by this
+ * timeout — already validated synchronously by `resolveImageSource`
+ * via `fs.statSync`, so a slow disk read is not a real risk here.
+ */
+export const MINIMAX_IMAGE_FETCH_TIMEOUT_MS = 30000;
+/**
+ * Local-file extension → MIME mapping for `convertToDataUri` (critique
+ * G1). Mirrors the SDK's `IMAGE_MIME_TYPES` table at
+ * `mmx-cli/dist/sdk.mjs:1581-1586` exactly. The extension has already
+ * been validated against `MINIMAX_IMAGE_EXTENSIONS` by
+ * `resolveImageSource`, so a missing entry is not expected at this
+ * layer (we still fall back to `image/jpeg` defensively, matching SDK).
+ */
+export const MINIMAX_IMAGE_MIME_BY_EXTENSION = {
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".png": "image/png",
+    ".webp": "image/webp",
+};
+// ---------------------------------------------------------------------------
+// Source classification
+// ---------------------------------------------------------------------------
+/**
+ * A leading `<scheme>://` that is NOT `http(s)://` (e.g. `ftp://`, `file://`)
+ * is a URL-like string MiniMax cannot consume. It is rejected up front with
+ * `VALIDATION_ERROR` rather than falling through to a misleading local-file
+ * `FILE_ERROR`.
+ */
+const URL_SCHEME_PATTERN = /^[a-z][a-z0-9+.-]*:\/\//i;
+function classifySource(source) {
+    if (source.startsWith("http://") || source.startsWith("https://")) {
+        return "http";
+    }
+    if (URL_SCHEME_PATTERN.test(source)) {
+        return "unsupported-url";
+    }
+    return "local";
+}
+// ---------------------------------------------------------------------------
+// Local media validation (existence + size + extension; never reads content)
+// ---------------------------------------------------------------------------
+function validateLocalImage(source) {
+    const resolved = path.resolve(source);
+    if (!fs.existsSync(resolved)) {
+        throw new FileError(`File not found: ${source}`, "Check the file path is correct");
+    }
+    const stats = fs.statSync(resolved);
+    if (stats.size > MINIMAX_MAX_IMAGE_BYTES) {
+        throw new ValidationError(`File exceeds the ${(MINIMAX_MAX_IMAGE_BYTES / 1024 / 1024).toFixed(0)} MiB limit ` +
+            `(${(stats.size / 1024 / 1024).toFixed(2)} MiB)`, MINIMAX_IMAGE_FORMAT_HELP);
+    }
+    const ext = path.extname(resolved).toLowerCase();
+    if (!MINIMAX_IMAGE_EXTENSIONS.includes(ext)) {
+        throw new ValidationError(`Unsupported media format: ${ext || "(no extension)"}`, MINIMAX_IMAGE_FORMAT_HELP);
+    }
+    return resolved;
+}
+// ---------------------------------------------------------------------------
+// Public resolver
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a MiniMax image source into the value the MiniMax SDK consumes.
+ * For a local file, validates existence, size (≤ 50 MiB), and extension
+ * (JPG/JPEG/PNG/WebP) and returns the absolute path (the SDK performs
+ * data-URI conversion from this path). For an HTTP(S) URL, returns the URL
+ * unchanged without touching the local filesystem.
+ */
+export function resolveImageSource(source) {
+    const kind = classifySource(source);
+    if (kind === "http")
+        return source;
+    if (kind === "unsupported-url") {
+        throw new ValidationError(`Unsupported source scheme for MiniMax vision`, "Use an HTTP(S) URL or a local file path");
+    }
+    return validateLocalImage(source);
+}
+// ---------------------------------------------------------------------------
+// MIME detection from HTTP Content-Type (critique G1)
+// ---------------------------------------------------------------------------
+/**
+ * Map an HTTP `Content-Type` header to a MiniMax image MIME.
+ *
+ * Rules (mirror SDK behaviour at `sdk.mjs:1601-1602`, critique G1):
+ *   - Missing/null → `image/jpeg` (SDK default).
+ *   - Strip `;`-introduced parameters, then trim and lowercase.
+ *   - Match `image/jpeg` or `image/jpg` → `image/jpeg`.
+ *   - Match `image/png` → `image/png`.
+ *   - Match `image/webp` → `image/webp`.
+ *   - Anything else (e.g. `application/octet-stream`, an unrecognised
+ *     vendor type) → `image/jpeg` (SDK default).
+ */
+function detectMimeFromContentType(contentType) {
+    if (!contentType)
+        return "image/jpeg";
+    const base = contentType.split(";")[0].trim().toLowerCase();
+    if (base === "image/jpeg" || base === "image/jpg")
+        return "image/jpeg";
+    if (base === "image/png")
+        return "image/png";
+    if (base === "image/webp")
+        return "image/webp";
+    return "image/jpeg";
+}
+/**
+ * Convert a MiniMax image source into the `data:<mime>;base64,...` form
+ * the MiniMax VLM endpoint consumes. Three branches:
+ *
+ *   1. `data:` prefix → returned unchanged.
+ *   2. `http(s)://` → bytes fetched via injected `fetch` with an
+ *      `AbortController` timed out by `MINIMAX_IMAGE_FETCH_TIMEOUT_MS`,
+ *      MIME detected via `detectMimeFromContentType`, base64-encoded.
+ *      The 50 MiB cap (`MINIMAX_MAX_IMAGE_BYTES`) is enforced on the
+ *      fetched byte length.
+ *   3. Local path → bytes read via `node:fs/promises`, MIME from
+ *      `MINIMAX_IMAGE_MIME_BY_EXTENSION`. The path has already been
+ *      validated (existence, size, extension) by `resolveImageSource`,
+ *      so this branch trusts the prior validation.
+ *
+ * The HTTP branch mirrors the abort/timeout + injected-fetch +
+ * injected-setTimeout pattern from `quota-client.ts` so the same test
+ * fixtures drive both transports.
+ */
+export async function convertToDataUri(source, deps = {}) {
+    // 1. data: passthrough.
+    if (source.startsWith("data:")) {
+        return source;
+    }
+    // 2. http(s):// fetch.
+    if (source.startsWith("http://") || source.startsWith("https://")) {
+        return await fetchHttpImageAsDataUri(source, deps);
+    }
+    // 3. Local path — extension already validated by resolveImageSource.
+    return await readLocalImageAsDataUri(source);
+}
+async function fetchHttpImageAsDataUri(source, deps) {
+    const f = deps.fetch ?? fetch;
+    const setT = deps.setTimeout ?? setTimeout;
+    const clearT = deps.clearTimeout ?? clearTimeout;
+    const timeoutMs = MINIMAX_IMAGE_FETCH_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timeoutId = setT(() => controller.abort(), timeoutMs);
+    try {
+        const res = await f(source, {
+            method: "GET",
+            signal: controller.signal,
+        });
+        clearT(timeoutId);
+        if (!res.ok) {
+            await res.text().catch(() => { });
+            throw new ApiError(`Failed to download image: HTTP ${res.status}`, res.status);
+        }
+        const contentType = res.headers.get("content-type");
+        const mime = detectMimeFromContentType(contentType);
+        const buf = await res.arrayBuffer();
+        if (buf.byteLength > MINIMAX_MAX_IMAGE_BYTES) {
+            throw new ValidationError(`Image too large (${(buf.byteLength / 1024 / 1024).toFixed(2)} MiB). ` +
+                `Maximum is ${(MINIMAX_MAX_IMAGE_BYTES / 1024 / 1024).toFixed(0)} MiB.`, MINIMAX_IMAGE_FORMAT_HELP);
+        }
+        return `data:${mime};base64,${Buffer.from(buf).toString("base64")}`;
+    }
+    catch (err) {
+        clearT(timeoutId);
+        if (err instanceof ValidationError || err instanceof ApiError)
+            throw err;
+        if (err instanceof Error) {
+            if (err.name === "AbortError") {
+                throw new TimeoutError(timeoutMs);
+            }
+            const lower = err.message.toLowerCase();
+            if (lower.includes("fetch") ||
+                lower.includes("econnrefused") ||
+                lower.includes("econnreset") ||
+                lower.includes("enotfound") ||
+                lower.includes("network")) {
+                throw new NetworkError("MiniMax image fetch network error");
+            }
+        }
+        throw err;
+    }
+}
+async function readLocalImageAsDataUri(source) {
+    const ext = path.extname(source).toLowerCase();
+    // Extension was validated by resolveImageSource; the fallback matches
+    // SDK behaviour if an unknown extension ever reaches this branch.
+    const mime = MINIMAX_IMAGE_MIME_BY_EXTENSION[ext] ?? "image/jpeg";
+    const data = await readFile(source);
+    return `data:${mime};base64,${data.toString("base64")}`;
+}
+//# sourceMappingURL=media.js.map

package/dist/providers/minimax/media.js.map

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

package/dist/providers/minimax/quota-client.d.ts

@@ -0,0 +1,44 @@
+/**
+ * MiniMax Quota Client — Adapter-local direct transport (DESIGN.md §12, P4-02).
+ *
+ * The pinned `mmx-cli/sdk` 1.0.16 does not preserve an arbitrary
+ * configured host for quota. This Module performs ONE direct GET against
+ * `<baseUrl>/v1/api/openplatform/coding_plan/remains` with an
+ * `Authorization: Bearer <apiKey>` header so `MINIMAX_BASE_URL` is
+ * authoritative for quota. There is NO internal retry — shared execution
+ * owns retry policy. Fetch and timer are injectable for tests.
+ *
+ * Phase A (A2): the previously named `MiniMaxQuotaClientDeps` is now an
+ * alias for the unified `MiniMaxTransportDeps` declared in
+ * `./coding-plan-client.ts`. Same four fields — rename, not superset —
+ * so existing imports and call sites keep working unchanged.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import Adapter-local config and normalized errors.
+ *   - Must NOT import `mmx-cli/sdk`, command presentation, or another
+ *     Provider's Adapter.
+ */
+import type { MiniMaxConfig } from "./config.js";
+import type { ProviderQuotaFetch } from "../types.js";
+import type { MiniMaxTransportDeps } from "./coding-plan-client.js";
+/** Injectable fetch signature (shared duck-typed port). */
+export type MiniMaxQuotaFetch = ProviderQuotaFetch;
+/** Fetch response shape this transport consumes. */
+export type MiniMaxQuotaFetchResponse = Awaited<ReturnType<MiniMaxQuotaFetch>>;
+/**
+ * Renamed alias for {@link MiniMaxTransportDeps} (Phase A — A2). The
+ * two type names describe the same shape; the unified name wins at
+ * the new `coding-plan-client.ts`, this name is preserved here so
+ * existing imports keep resolving.
+ */
+export type MiniMaxQuotaClientDeps = MiniMaxTransportDeps;
+/** Raw MiniMax quota response shape (remains endpoint). */
+export interface MiniMaxRawQuotaResponse {
+    model_remains?: unknown[];
+}
+/**
+ * Perform ONE GET against the MiniMax remains endpoint. No retry; no
+ * response body in public errors. Returns the parsed JSON body.
+ */
+export declare function fetchMiniMaxQuota(config: MiniMaxConfig, deps?: MiniMaxQuotaClientDeps): Promise<MiniMaxRawQuotaResponse>;
+//# sourceMappingURL=quota-client.d.ts.map

package/dist/providers/minimax/quota-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-client.d.ts","sourceRoot":"","sources":["../../../src/providers/minimax/quota-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAKpE,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAEnD,oDAAoD;AACpD,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAE1D,2DAA2D;AAC3D,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B;AAkCD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA0BlC"}

package/dist/providers/minimax/quota-client.js

@@ -0,0 +1,83 @@
+/**
+ * MiniMax Quota Client — Adapter-local direct transport (DESIGN.md §12, P4-02).
+ *
+ * The pinned `mmx-cli/sdk` 1.0.16 does not preserve an arbitrary
+ * configured host for quota. This Module performs ONE direct GET against
+ * `<baseUrl>/v1/api/openplatform/coding_plan/remains` with an
+ * `Authorization: Bearer <apiKey>` header so `MINIMAX_BASE_URL` is
+ * authoritative for quota. There is NO internal retry — shared execution
+ * owns retry policy. Fetch and timer are injectable for tests.
+ *
+ * Phase A (A2): the previously named `MiniMaxQuotaClientDeps` is now an
+ * alias for the unified `MiniMaxTransportDeps` declared in
+ * `./coding-plan-client.ts`. Same four fields — rename, not superset —
+ * so existing imports and call sites keep working unchanged.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import Adapter-local config and normalized errors.
+ *   - Must NOT import `mmx-cli/sdk`, command presentation, or another
+ *     Provider's Adapter.
+ */
+import { ApiError, AuthError, NetworkError, TimeoutError } from "../../lib/errors.js";
+const QUOTA_PATH = "/v1/api/openplatform/coding_plan/remains";
+const DEFAULT_TIMEOUT_MS = 30000;
+function resolveTimeoutMs(env) {
+    const raw = parseInt(env.MINIMAX_TIMEOUT || String(DEFAULT_TIMEOUT_MS), 10);
+    return Number.isFinite(raw) && raw > 0 ? raw : DEFAULT_TIMEOUT_MS;
+}
+function mapStatusError(status) {
+    if (status === 401 || status === 403) {
+        return new AuthError("MiniMax quota API authentication failed");
+    }
+    return new ApiError("MiniMax quota API request failed", status);
+}
+function normalizeTransportError(err, timeoutMs) {
+    if (err instanceof AuthError || err instanceof ApiError)
+        return err;
+    if (err instanceof Error) {
+        if (err.name === "AbortError") {
+            return new TimeoutError(timeoutMs);
+        }
+        const lower = err.message.toLowerCase();
+        if (lower.includes("fetch") ||
+            lower.includes("econnrefused") ||
+            lower.includes("econnreset") ||
+            lower.includes("enotfound") ||
+            lower.includes("network")) {
+            return new NetworkError("MiniMax quota network error");
+        }
+    }
+    return new ApiError("MiniMax quota request failed", 500);
+}
+/**
+ * Perform ONE GET against the MiniMax remains endpoint. No retry; no
+ * response body in public errors. Returns the parsed JSON body.
+ */
+export async function fetchMiniMaxQuota(config, deps = {}) {
+    const f = deps.fetch ?? fetch;
+    const setT = deps.setTimeout ?? setTimeout;
+    const clearT = deps.clearTimeout ?? clearTimeout;
+    const env = deps.env ?? process.env;
+    const timeoutMs = resolveTimeoutMs(env);
+    const url = `${config.baseUrl}${QUOTA_PATH}`;
+    const controller = new AbortController();
+    const timeoutId = setT(() => controller.abort(), timeoutMs);
+    try {
+        const res = await f(url, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${config.apiKey}` },
+            signal: controller.signal,
+        });
+        clearT(timeoutId);
+        if (!res.ok) {
+            await res.text().catch(() => { });
+            throw mapStatusError(res.status);
+        }
+        return (await res.json());
+    }
+    catch (err) {
+        clearT(timeoutId);
+        throw normalizeTransportError(err, timeoutMs);
+    }
+}
+//# sourceMappingURL=quota-client.js.map

package/dist/providers/minimax/quota-client.js.map

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

package/dist/providers/minimax/quota.d.ts

@@ -0,0 +1,48 @@
+/**
+ * MiniMax Quota Capability (DESIGN.md §12, §13, P4-02).
+ *
+ * Maps the MiniMax remains-endpoint response into the normalized
+ * Provider-quota Interface. The normalizer is pure; the capability
+ * factory owns configuration resolution, the single direct transport
+ * attempt, and failure normalization. Shared execution owns retry.
+ *
+ * MiniMax mapping (DESIGN.md §13):
+ *   - Each `model_remains` entry -> one category named by nonempty
+ *     `model_name`, unit `requests`, sorted ascending by name.
+ *   - Current counts + remaining percent; optional weekly counts +
+ *     remaining percent.
+ *   - `end_time` / `weekly_end_time` (epoch ms) -> ISO `resetsAt`.
+ *   - Only characterized 1.0.16 fields are read: model name, counts,
+ *     remaining percentages, reset timestamps. Status and boost fields
+ *     are not interpreted.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import the quota capability contract, Adapter-local config,
+ *     Adapter-local quota client, and normalized errors.
+ *   - Must NOT import `mmx-cli/sdk`, command presentation, or another
+ *     Provider's Adapter.
+ */
+import type { ProviderQuotaSuccess, QuotaCapability } from "../../capabilities/quota.js";
+import { type MiniMaxQuotaClientDeps } from "./quota-client.js";
+/**
+ * Normalize a raw MiniMax remains payload into the shared Interface.
+ * Throws `QUOTA_ERROR` (via {@link buildQuotaWindow}) when an entry has
+ * neither a valid percentage nor valid counts.
+ */
+export declare function normalizeMiniMaxQuota(raw: unknown): ProviderQuotaSuccess;
+/**
+ * Options for the MiniMax QuotaCapability. Configuration is loaded from
+ * `env`; transport dependencies (`fetch`, timer) are injectable for
+ * deterministic tests.
+ */
+export interface MiniMaxQuotaCapabilityOptions extends MiniMaxQuotaClientDeps {
+    readonly env: NodeJS.ProcessEnv;
+}
+/**
+ * Build the MiniMax QuotaCapability. `invoke` loads Adapter-local
+ * config, performs one direct remains-endpoint attempt, and normalizes
+ * the response. Shared execution wraps this in the retry policy; quota
+ * never uses the response cache and never routes through the SDK.
+ */
+export declare function createMiniMaxQuotaCapability(options: MiniMaxQuotaCapabilityOptions): QuotaCapability;
+//# sourceMappingURL=quota.d.ts.map

package/dist/providers/minimax/quota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../../../src/providers/minimax/quota.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EAEhB,MAAM,6BAA6B,CAAC;AAUrC,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,mBAAmB,CAAC;AAiC3B;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CAkDxE;AAmBD;;;;GAIG;AACH,MAAM,WAAW,6BAA8B,SAAQ,sBAAsB;IAC3E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,GACrC,eAAe,CAajB"}

package/dist/providers/minimax/quota.js

@@ -0,0 +1,120 @@
+/**
+ * MiniMax Quota Capability (DESIGN.md §12, §13, P4-02).
+ *
+ * Maps the MiniMax remains-endpoint response into the normalized
+ * Provider-quota Interface. The normalizer is pure; the capability
+ * factory owns configuration resolution, the single direct transport
+ * attempt, and failure normalization. Shared execution owns retry.
+ *
+ * MiniMax mapping (DESIGN.md §13):
+ *   - Each `model_remains` entry -> one category named by nonempty
+ *     `model_name`, unit `requests`, sorted ascending by name.
+ *   - Current counts + remaining percent; optional weekly counts +
+ *     remaining percent.
+ *   - `end_time` / `weekly_end_time` (epoch ms) -> ISO `resetsAt`.
+ *   - Only characterized 1.0.16 fields are read: model name, counts,
+ *     remaining percentages, reset timestamps. Status and boost fields
+ *     are not interpreted.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import the quota capability contract, Adapter-local config,
+ *     Adapter-local quota client, and normalized errors.
+ *   - Must NOT import `mmx-cli/sdk`, command presentation, or another
+ *     Provider's Adapter.
+ */
+import { buildQuotaWindow } from "../../capabilities/quota.js";
+import { ApiError, AuthError, ConfigurationError, NetworkError, TimeoutError, } from "../../lib/errors.js";
+import { loadMiniMaxConfig } from "./config.js";
+import { fetchMiniMaxQuota, } from "./quota-client.js";
+function readNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function readNonemptyString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value : undefined;
+}
+// ---------------------------------------------------------------------------
+// Normalizer
+// ---------------------------------------------------------------------------
+/**
+ * Normalize a raw MiniMax remains payload into the shared Interface.
+ * Throws `QUOTA_ERROR` (via {@link buildQuotaWindow}) when an entry has
+ * neither a valid percentage nor valid counts.
+ */
+export function normalizeMiniMaxQuota(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new ApiError("MiniMax quota returned a malformed response", 500);
+    }
+    const response = raw;
+    const entries = response.model_remains;
+    if (!Array.isArray(entries)) {
+        throw new ApiError("MiniMax quota returned a malformed response", 500);
+    }
+    const categories = [];
+    for (const entry of entries) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+            throw new ApiError("MiniMax quota returned a malformed response", 500);
+        }
+        const record = entry;
+        const name = readNonemptyString(record.model_name);
+        if (!name) {
+            throw new ApiError("MiniMax quota returned a malformed response", 500);
+        }
+        const current = buildQuotaWindow({
+            used: readNumber(record.current_interval_usage_count),
+            limit: readNumber(record.current_interval_total_count),
+            explicitRemainingPercent: readNumber(record.current_interval_remaining_percent),
+            resetsAtEpochMs: readNumber(record.end_time),
+        });
+        const category = { name, unit: "requests", current };
+        const hasWeekly = readNumber(record.current_weekly_usage_count) !== undefined ||
+            readNumber(record.current_weekly_total_count) !== undefined ||
+            readNumber(record.current_weekly_remaining_percent) !== undefined ||
+            readNumber(record.weekly_end_time) !== undefined;
+        if (hasWeekly) {
+            category.weekly = buildQuotaWindow({
+                used: readNumber(record.current_weekly_usage_count),
+                limit: readNumber(record.current_weekly_total_count),
+                explicitRemainingPercent: readNumber(record.current_weekly_remaining_percent),
+                resetsAtEpochMs: readNumber(record.weekly_end_time),
+            });
+        }
+        categories.push(category);
+    }
+    categories.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    return { provider: "minimax", status: "ok", categories };
+}
+// ---------------------------------------------------------------------------
+// Capability factory
+// ---------------------------------------------------------------------------
+function normalizeMiniMaxQuotaError(error) {
+    if (error instanceof AuthError ||
+        error instanceof ApiError ||
+        error instanceof NetworkError ||
+        error instanceof TimeoutError ||
+        error instanceof ConfigurationError) {
+        return error;
+    }
+    return new ApiError("MiniMax quota request failed", 500);
+}
+/**
+ * Build the MiniMax QuotaCapability. `invoke` loads Adapter-local
+ * config, performs one direct remains-endpoint attempt, and normalizes
+ * the response. Shared execution wraps this in the retry policy; quota
+ * never uses the response cache and never routes through the SDK.
+ */
+export function createMiniMaxQuotaCapability(options) {
+    const { env, ...transportDeps } = options;
+    return {
+        async invoke() {
+            const config = loadMiniMaxConfig(env);
+            try {
+                const raw = await fetchMiniMaxQuota(config, transportDeps);
+                return normalizeMiniMaxQuota(raw);
+            }
+            catch (error) {
+                throw normalizeMiniMaxQuotaError(error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=quota.js.map

package/dist/providers/minimax/quota.js.map

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

package/dist/providers/minimax/sdk-client.d.ts

@@ -0,0 +1,29 @@
+/**
+ * MiniMax SDK client factory (DESIGN.md §12 — P2-04).
+ *
+ * This is the ONLY module that imports `mmx-cli/sdk`. The Adapter and
+ * registry consume {@link createMiniMaxSdk} plus the injectable
+ * {@link MiniMaxSdkConstructor} / {@link MiniMaxSdkPort} types declared
+ * in `providers/types.ts`, so the transitional SDK never leaks past
+ * this boundary.
+ *
+ * The characterized SDK reads its own config directory during
+ * construction (it calls `getConfigDir()`, which honours
+ * `MMX_CONFIG_DIR`). To prevent the SDK from touching the user's real
+ * `~/.mmx` state, the factory temporarily points `MMX_CONFIG_DIR` at a
+ * unique nonexistent path for the synchronous construction call only,
+ * then restores the prior value in `finally`. The temporary directory
+ * is NEVER created on disk.
+ */
+import type { MiniMaxSdkConstructor, MiniMaxSdkPort } from "../types.js";
+/**
+ * Construct a MiniMax SDK port. The optional `constructor` lets tests
+ * inject a fake; production omits it and uses the pinned `mmx-cli/sdk`
+ * implementation.
+ */
+export declare function createMiniMaxSdk(options: {
+    apiKey: string;
+    region: "global" | "cn";
+    baseUrl: string;
+}, constructor?: MiniMaxSdkConstructor): MiniMaxSdkPort;
+//# sourceMappingURL=sdk-client.d.ts.map

package/dist/providers/minimax/sdk-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-client.d.ts","sourceRoot":"","sources":["../../../src/providers/minimax/sdk-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIzE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACrE,WAAW,CAAC,EAAE,qBAAqB,GAClC,cAAc,CAoBhB"}

package/dist/providers/minimax/sdk-client.js

@@ -0,0 +1,50 @@
+/**
+ * MiniMax SDK client factory (DESIGN.md §12 — P2-04).
+ *
+ * This is the ONLY module that imports `mmx-cli/sdk`. The Adapter and
+ * registry consume {@link createMiniMaxSdk} plus the injectable
+ * {@link MiniMaxSdkConstructor} / {@link MiniMaxSdkPort} types declared
+ * in `providers/types.ts`, so the transitional SDK never leaks past
+ * this boundary.
+ *
+ * The characterized SDK reads its own config directory during
+ * construction (it calls `getConfigDir()`, which honours
+ * `MMX_CONFIG_DIR`). To prevent the SDK from touching the user's real
+ * `~/.mmx` state, the factory temporarily points `MMX_CONFIG_DIR` at a
+ * unique nonexistent path for the synchronous construction call only,
+ * then restores the prior value in `finally`. The temporary directory
+ * is NEVER created on disk.
+ */
+import { randomUUID } from "node:crypto";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { MiniMaxSDK } from "mmx-cli/sdk";
+const MMX_CONFIG_DIR = "MMX_CONFIG_DIR";
+/**
+ * Construct a MiniMax SDK port. The optional `constructor` lets tests
+ * inject a fake; production omits it and uses the pinned `mmx-cli/sdk`
+ * implementation.
+ */
+export function createMiniMaxSdk(options, constructor) {
+    const Ctor = constructor ?? MiniMaxSDK;
+    const hadPrev = Object.prototype.hasOwnProperty.call(process.env, MMX_CONFIG_DIR);
+    const prev = process.env[MMX_CONFIG_DIR];
+    // A unique nonexistent path. It is deliberately never created.
+    const temporaryDir = path.join(tmpdir(), `scoutline-minimax-${randomUUID()}`);
+    process.env[MMX_CONFIG_DIR] = temporaryDir;
+    try {
+        // Construction is synchronous and reads MMX_CONFIG_DIR via the
+        // SDK's getConfigDir(). The async search/vision calls happen
+        // after this block, with the original env already restored.
+        return new Ctor(options);
+    }
+    finally {
+        if (hadPrev) {
+            process.env[MMX_CONFIG_DIR] = prev;
+        }
+        else {
+            delete process.env[MMX_CONFIG_DIR];
+        }
+    }
+}
+//# sourceMappingURL=sdk-client.js.map

package/dist/providers/minimax/sdk-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-client.js","sourceRoot":"","sources":["../../../src/providers/minimax/sdk-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAqE,EACrE,WAAmC;IAEnC,MAAM,IAAI,GAAG,WAAW,IAAK,UAA+C,CAAC;IAE7E,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACzC,+DAA+D;IAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,qBAAqB,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9E,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,YAAY,CAAC;IAC3C,IAAI,CAAC;QACH,+DAA+D;QAC/D,6DAA6D;QAC7D,4DAA4D;QAC5D,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;AACH,CAAC"}