scoutline 0.1.0 → 0.6.0

package/dist/providers/minimax/coding-plan-client.d.ts

@@ -0,0 +1,60 @@
+/**
+ * MiniMax Coding Plan direct transport (DESIGN.md §12, P4-02).
+ *
+ * The pinned `mmx-cli/sdk` 1.0.16 does not preserve an arbitrary
+ * configured host for the Coding Plan endpoints. This module performs
+ * direct POSTs against the two `/v1/coding_plan/*` endpoints with an
+ * `Authorization: Bearer <apiKey>` header so `MINIMAX_BASE_URL` is
+ * authoritative. There is NO internal retry — shared execution owns
+ * retry policy. Fetch and timer are injectable for tests.
+ *
+ * Mirrors `providers/minimax/quota-client.ts` line-for-line in
+ * structure; that module is the canon direct-transport pattern. The
+ * `MiniMaxTransportDeps` shape is the renamed `MiniMaxQuotaClientDeps`
+ * (same four fields — rename, not superset).
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import Adapter-local config and normalized errors.
+ *   - May import `ProviderQuotaFetch` from `providers/types.ts`.
+ *   - Must NOT import `mmx-cli/sdk`, command presentation, or another
+ *     Provider's Adapter.
+ *   - Must NOT perform field normalization — the Adapter owns that.
+ */
+import type { MiniMaxConfig } from "./config.js";
+import type { ProviderQuotaFetch } from "../types.js";
+/** Injectable transport dependencies (renamed from `MiniMaxQuotaClientDeps`). */
+export interface MiniMaxTransportDeps {
+    readonly fetch?: ProviderQuotaFetch;
+    readonly setTimeout?: typeof setTimeout;
+    readonly clearTimeout?: typeof clearTimeout;
+    readonly env?: NodeJS.ProcessEnv;
+}
+/** Raw MiniMax search response shape (search endpoint). */
+export interface MiniMaxRawSearchResponse {
+    organic?: unknown[];
+    related_searches?: unknown[];
+    base_resp?: unknown;
+}
+/** Raw MiniMax VLM response shape (vision-language endpoint). */
+export interface MiniMaxRawVlmResponse {
+    content?: unknown;
+    base_resp?: unknown;
+}
+/**
+ * Perform ONE POST against the MiniMax Coding Plan search endpoint. No
+ * retry; no response body in public errors. Returns the parsed JSON
+ * body (raw; the Adapter post-processes into normalized search
+ * sources).
+ */
+export declare function fetchMiniMaxSearch(config: MiniMaxConfig, query: string, deps?: MiniMaxTransportDeps): Promise<MiniMaxRawSearchResponse>;
+/**
+ * Perform ONE POST against the MiniMax Coding Plan VLM endpoint. No
+ * retry; no response body in public errors. Returns the parsed JSON
+ * body (raw; the Adapter post-processes the content field).
+ *
+ * `image` is the pre-resolved data URI produced by the Adapter's
+ * `convertToDataUri` step. The transport does NOT perform any
+ * data-URI conversion.
+ */
+export declare function fetchMiniMaxVlm(config: MiniMaxConfig, image: string, prompt: string, deps?: MiniMaxTransportDeps): Promise<MiniMaxRawVlmResponse>;
+//# sourceMappingURL=coding-plan-client.d.ts.map

package/dist/providers/minimax/coding-plan-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-plan-client.d.ts","sourceRoot":"","sources":["../../../src/providers/minimax/coding-plan-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAatD,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,YAAY,CAAC;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC;AAED,2DAA2D;AAC3D,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,iEAAiE;AACjE,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAoLD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAQnC;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAQhC"}

package/dist/providers/minimax/coding-plan-client.js

@@ -0,0 +1,204 @@
+/**
+ * MiniMax Coding Plan direct transport (DESIGN.md §12, P4-02).
+ *
+ * The pinned `mmx-cli/sdk` 1.0.16 does not preserve an arbitrary
+ * configured host for the Coding Plan endpoints. This module performs
+ * direct POSTs against the two `/v1/coding_plan/*` endpoints with an
+ * `Authorization: Bearer <apiKey>` header so `MINIMAX_BASE_URL` is
+ * authoritative. There is NO internal retry — shared execution owns
+ * retry policy. Fetch and timer are injectable for tests.
+ *
+ * Mirrors `providers/minimax/quota-client.ts` line-for-line in
+ * structure; that module is the canon direct-transport pattern. The
+ * `MiniMaxTransportDeps` shape is the renamed `MiniMaxQuotaClientDeps`
+ * (same four fields — rename, not superset).
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import Adapter-local config and normalized errors.
+ *   - May import `ProviderQuotaFetch` from `providers/types.ts`.
+ *   - Must NOT import `mmx-cli/sdk`, command presentation, or another
+ *     Provider's Adapter.
+ *   - Must NOT perform field normalization — the Adapter owns that.
+ */
+import { createRequire } from "node:module";
+import { ApiError, AuthError, NetworkError, QuotaError, TimeoutError, } from "../../lib/errors.js";
+const require = createRequire(import.meta.url);
+const { version: VERSION } = require("../../../package.json");
+const SEARCH_PATH = "/v1/coding_plan/search";
+const VLM_PATH = "/v1/coding_plan/vlm";
+const DEFAULT_TIMEOUT_MS = 30000;
+const MM_API_SOURCE = "Scoutline";
+const USER_AGENT = `scoutline/${VERSION}`;
+const TIMEOUT_HELP_TEXT = "Try again or increase timeout with MINIMAX_TIMEOUT env var";
+function resolveTimeoutMs(env) {
+    const raw = parseInt(env.MINIMAX_TIMEOUT || String(DEFAULT_TIMEOUT_MS), 10);
+    return Number.isFinite(raw) && raw > 0 ? raw : DEFAULT_TIMEOUT_MS;
+}
+/**
+ * Layer 1 — HTTP-status mapping. Runs BEFORE the body is parsed; on a
+ * non-200 response we discard the body and throw a typed error.
+ *
+ * `timeoutMs` is forwarded so 408/504 can throw `TimeoutError`
+ * carrying the configured duration (and the `MINIMAX_TIMEOUT` help
+ * text). The transport never embeds credential material in any
+ * error message.
+ */
+function mapStatusError(status, timeoutMs) {
+    if (status === 401 || status === 403) {
+        return new AuthError("MiniMax authentication failed", "MINIMAX_API_KEY");
+    }
+    if (status === 408 || status === 504) {
+        return new TimeoutError(timeoutMs, TIMEOUT_HELP_TEXT);
+    }
+    if (status === 429) {
+        return new ApiError("MiniMax rate limit exceeded", 429);
+    }
+    if (status === 400 || status === 404 || status === 410 || status === 422) {
+        return new ApiError("MiniMax request failed", status);
+    }
+    if (status >= 500) {
+        return new ApiError("MiniMax request failed", status);
+    }
+    return new ApiError("MiniMax request failed", status);
+}
+/**
+ * Layer 2 — `base_resp.status_code` mapping. Runs ONLY when HTTP 200
+ * AND body parses as JSON. If body is missing `base_resp`, the body
+ * is treated as malformed and a 500-status `ApiError` is thrown.
+ */
+function mapBaseRespError(statusCode) {
+    if (statusCode === 0 || statusCode === undefined || statusCode === null) {
+        // status_code === 0 is success; undefined/null are also treated as
+        // "no business error" so a missing-but-present `base_resp` with no
+        // status_code field doesn't break the success path. The malformed
+        // branch handles the missing-`base_resp`-entirely case.
+        return null;
+    }
+    if (typeof statusCode !== "number" || !Number.isFinite(statusCode)) {
+        return new ApiError("MiniMax returned a malformed response", 500);
+    }
+    if (statusCode === 1002 || statusCode === 1039) {
+        return new ApiError("MiniMax content filter rejected the request", 400);
+    }
+    if (statusCode === 1004) {
+        return new AuthError("MiniMax authentication failed", "MINIMAX_API_KEY");
+    }
+    if (statusCode === 1028 || statusCode === 1030) {
+        return new QuotaError();
+    }
+    if (statusCode === 2038) {
+        return new ApiError("MiniMax account requires real-name verification. Visit https://platform.minimaxi.com/user-center/basic-information to resolve.", 403);
+    }
+    if (statusCode === 2061) {
+        return new ApiError("MiniMax model not available on current Token Plan", 403);
+    }
+    return new ApiError("MiniMax request failed", 500);
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function getBaseRespStatusCode(body) {
+    if (!isPlainObject(body)) {
+        return { statusCode: undefined, malformed: true };
+    }
+    const baseResp = body.base_resp;
+    if (baseResp === undefined) {
+        return { statusCode: undefined, malformed: true };
+    }
+    if (!isPlainObject(baseResp)) {
+        return { statusCode: undefined, malformed: true };
+    }
+    return { statusCode: baseResp.status_code, malformed: false };
+}
+function normalizeTransportError(err, timeoutMs) {
+    if (err instanceof AuthError ||
+        err instanceof ApiError ||
+        err instanceof QuotaError ||
+        err instanceof TimeoutError) {
+        return err;
+    }
+    if (err instanceof Error) {
+        if (err.name === "AbortError") {
+            return new TimeoutError(timeoutMs, TIMEOUT_HELP_TEXT);
+        }
+        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 network error");
+        }
+    }
+    return new ApiError("MiniMax request failed", 500);
+}
+async function postCodingPlanJson(config, path, body, deps, endpointLabel) {
+    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}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setT(() => controller.abort(), timeoutMs);
+    try {
+        const res = await f(url, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${config.apiKey}`,
+                "Content-Type": "application/json",
+                "MM-API-Source": MM_API_SOURCE,
+                "User-Agent": USER_AGENT,
+            },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        clearT(timeoutId);
+        if (!res.ok) {
+            await res.text().catch(() => { });
+            throw mapStatusError(res.status, timeoutMs);
+        }
+        let parsed;
+        try {
+            parsed = await res.json();
+        }
+        catch {
+            throw new ApiError(`MiniMax ${endpointLabel} returned a malformed response`, 500);
+        }
+        const { statusCode, malformed } = getBaseRespStatusCode(parsed);
+        if (malformed) {
+            throw new ApiError(`MiniMax ${endpointLabel} returned a malformed response`, 500);
+        }
+        const mapped = mapBaseRespError(statusCode);
+        if (mapped) {
+            throw mapped;
+        }
+        return parsed;
+    }
+    catch (err) {
+        clearT(timeoutId);
+        throw normalizeTransportError(err, timeoutMs);
+    }
+}
+/**
+ * Perform ONE POST against the MiniMax Coding Plan search endpoint. No
+ * retry; no response body in public errors. Returns the parsed JSON
+ * body (raw; the Adapter post-processes into normalized search
+ * sources).
+ */
+export async function fetchMiniMaxSearch(config, query, deps = {}) {
+    return postCodingPlanJson(config, SEARCH_PATH, { q: query }, deps, "search");
+}
+/**
+ * Perform ONE POST against the MiniMax Coding Plan VLM endpoint. No
+ * retry; no response body in public errors. Returns the parsed JSON
+ * body (raw; the Adapter post-processes the content field).
+ *
+ * `image` is the pre-resolved data URI produced by the Adapter's
+ * `convertToDataUri` step. The transport does NOT perform any
+ * data-URI conversion.
+ */
+export async function fetchMiniMaxVlm(config, image, prompt, deps = {}) {
+    return postCodingPlanJson(config, VLM_PATH, { prompt, image_url: image }, deps, "vlm");
+}
+//# sourceMappingURL=coding-plan-client.js.map

package/dist/providers/minimax/coding-plan-client.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * MiniMax Adapter-local configuration (DESIGN.md §12 — P2-04).
+ *
+ * Reads MiniMax credentials and endpoints from the injected environment.
+ * This module is the Adapter-local companion to the SDK client; MiniMax
+ * environment names intentionally do NOT appear in shared `lib/config.ts`
+ * (that module remains Z.AI-only). No credential is persisted or read
+ * from shared configuration.
+ *
+ * Resolution rules:
+ *   - `MINIMAX_API_KEY`: required, non-empty after trim. Whitespace-only
+ *     is invalid, not absent.
+ *   - `MINIMAX_REGION`: optional; undefined defaults to `global`. An
+ *     empty value is invalid, not absent. Must be exactly `global` or
+ *     `cn`.
+ *   - Region URLs: `global` -> `https://api.minimax.io`,
+ *     `cn` -> `https://api.minimaxi.com`.
+ *   - `MINIMAX_BASE_URL`: optional override; must be an absolute HTTPS
+ *     URL. An empty value is invalid. Exactly one trailing slash is
+ *     removed. Overrides the region URL for every SDK operation.
+ */
+export interface MiniMaxConfig {
+    readonly apiKey: string;
+    readonly region: "global" | "cn";
+    readonly baseUrl: string;
+}
+/**
+ * Load and validate MiniMax configuration from the injected environment.
+ * Throws a normalized {@link ConfigurationError} for any invalid value.
+ */
+export declare function loadMiniMaxConfig(env: NodeJS.ProcessEnv): MiniMaxConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/providers/minimax/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAYD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,aAAa,CAyDvE"}

package/dist/providers/minimax/config.js

@@ -0,0 +1,84 @@
+/**
+ * MiniMax Adapter-local configuration (DESIGN.md §12 — P2-04).
+ *
+ * Reads MiniMax credentials and endpoints from the injected environment.
+ * This module is the Adapter-local companion to the SDK client; MiniMax
+ * environment names intentionally do NOT appear in shared `lib/config.ts`
+ * (that module remains Z.AI-only). No credential is persisted or read
+ * from shared configuration.
+ *
+ * Resolution rules:
+ *   - `MINIMAX_API_KEY`: required, non-empty after trim. Whitespace-only
+ *     is invalid, not absent.
+ *   - `MINIMAX_REGION`: optional; undefined defaults to `global`. An
+ *     empty value is invalid, not absent. Must be exactly `global` or
+ *     `cn`.
+ *   - Region URLs: `global` -> `https://api.minimax.io`,
+ *     `cn` -> `https://api.minimaxi.com`.
+ *   - `MINIMAX_BASE_URL`: optional override; must be an absolute HTTPS
+ *     URL. An empty value is invalid. Exactly one trailing slash is
+ *     removed. Overrides the region URL for every SDK operation.
+ */
+import { ConfigurationError } from "../../lib/errors.js";
+const REGION_BASE_URLS = {
+    global: "https://api.minimax.io",
+    cn: "https://api.minimaxi.com",
+};
+const MISSING_KEY_HELP = 'export MINIMAX_API_KEY="your-api-key"';
+const REGION_HELP = "Accepted MINIMAX_REGION values: global, cn";
+const BASE_URL_HELP = "MINIMAX_BASE_URL must be an absolute HTTPS URL (e.g. https://api.minimax.io)";
+/**
+ * Load and validate MiniMax configuration from the injected environment.
+ * Throws a normalized {@link ConfigurationError} for any invalid value.
+ */
+export function loadMiniMaxConfig(env) {
+    const apiKey = env.MINIMAX_API_KEY;
+    if (typeof apiKey !== "string" || apiKey.trim().length === 0) {
+        throw new ConfigurationError("MINIMAX_API_KEY environment variable is required", MISSING_KEY_HELP);
+    }
+    const regionRaw = env.MINIMAX_REGION;
+    let region;
+    if (regionRaw === undefined) {
+        region = "global";
+    }
+    else if (regionRaw.trim() === "") {
+        throw new ConfigurationError('MINIMAX_REGION must be "global" or "cn"', REGION_HELP);
+    }
+    else if (regionRaw !== "global" && regionRaw !== "cn") {
+        throw new ConfigurationError(`Unknown MINIMAX_REGION "${regionRaw}"`, REGION_HELP);
+    }
+    else {
+        region = regionRaw;
+    }
+    const baseUrlRaw = env.MINIMAX_BASE_URL;
+    let baseUrl;
+    if (baseUrlRaw === undefined) {
+        baseUrl = REGION_BASE_URLS[region];
+    }
+    else if (baseUrlRaw.trim() === "") {
+        throw new ConfigurationError("MINIMAX_BASE_URL must not be empty", BASE_URL_HELP);
+    }
+    else if (!/^https:\/\//i.test(baseUrlRaw)) {
+        throw new ConfigurationError(`MINIMAX_BASE_URL must be an absolute HTTPS URL (got "${baseUrlRaw}")`, BASE_URL_HELP);
+    }
+    else {
+        // Fixup C — W1: reject scheme-only URLs (no host). The previous
+        // accept-and-normalize path turned `https://` into `https:/`, which
+        // is not a valid URL and breaks SDK construction. Parse the URL and
+        // require a non-empty host.
+        let parsed;
+        try {
+            parsed = new URL(baseUrlRaw);
+        }
+        catch {
+            throw new ConfigurationError(`MINIMAX_BASE_URL must be an absolute HTTPS URL with a host (got "${baseUrlRaw}")`, BASE_URL_HELP);
+        }
+        if (parsed.host.length === 0) {
+            throw new ConfigurationError(`MINIMAX_BASE_URL must include a host (got "${baseUrlRaw}")`, BASE_URL_HELP);
+        }
+        // Remove exactly one trailing slash so the SDK receives a clean base.
+        baseUrl = baseUrlRaw.replace(/\/$/, "");
+    }
+    return { apiKey, region, baseUrl };
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/providers/minimax/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAQzD,MAAM,gBAAgB,GAAG;IACvB,MAAM,EAAE,wBAAwB;IAChC,EAAE,EAAE,0BAA0B;CACtB,CAAC;AAEX,MAAM,gBAAgB,GAAG,uCAAuC,CAAC;AACjE,MAAM,WAAW,GAAG,4CAA4C,CAAC;AACjE,MAAM,aAAa,GACjB,8EAA8E,CAAC;AAEjF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAsB;IACtD,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC;IACnC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,kBAAkB,CAC1B,kDAAkD,EAClD,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,cAAc,CAAC;IACrC,IAAI,MAAuB,CAAC;IAC5B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,GAAG,QAAQ,CAAC;IACpB,CAAC;SAAM,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnC,MAAM,IAAI,kBAAkB,CAAC,yCAAyC,EAAE,WAAW,CAAC,CAAC;IACvF,CAAC;SAAM,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACxD,MAAM,IAAI,kBAAkB,CAAC,2BAA2B,SAAS,GAAG,EAAE,WAAW,CAAC,CAAC;IACrF,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,CAAC,gBAAgB,CAAC;IACxC,IAAI,OAAe,CAAC;IACpB,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;SAAM,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,kBAAkB,CAAC,oCAAoC,EAAE,aAAa,CAAC,CAAC;IACpF,CAAC;SAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,kBAAkB,CAC1B,wDAAwD,UAAU,IAAI,EACtE,aAAa,CACd,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,gEAAgE;QAChE,oEAAoE;QACpE,oEAAoE;QACpE,4BAA4B;QAC5B,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,kBAAkB,CAC1B,oEAAoE,UAAU,IAAI,EAClF,aAAa,CACd,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,kBAAkB,CAC1B,8CAA8C,UAAU,IAAI,EAC5D,aAAa,CACd,CAAC;QACJ,CAAC;QACD,sEAAsE;QACtE,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,88 @@
+/**
+ * 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 type { ProviderImageFetch } from "../types.js";
+/**
+ * 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 declare 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 declare const MINIMAX_IMAGE_MIME_BY_EXTENSION: Readonly<Record<string, string>>;
+/**
+ * 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 declare function resolveImageSource(source: string): string;
+/**
+ * Injectable dependencies for `convertToDataUri`. Fetch and timer
+ * injection mirror the `MiniMaxQuotaClientDeps` pattern in
+ * `quota-client.ts` so a unit test can drive the HTTP branch
+ * deterministically without real network I/O.
+ */
+export interface ConvertToDataUriDeps {
+    readonly fetch?: ProviderImageFetch;
+    readonly setTimeout?: typeof setTimeout;
+    readonly clearTimeout?: typeof clearTimeout;
+}
+/**
+ * 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 declare function convertToDataUri(source: string, deps?: ConvertToDataUriDeps): Promise<string>;
+//# sourceMappingURL=media.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../src/providers/minimax/media.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAaH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAatD;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,QAAQ,CAAC;AAEpD;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK5E,CAAC;AAyDF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUzD;AA+BD;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,YAAY,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAajB"}