scoutline 0.1.0 → 0.2.0

package/dist/providers/minimax/adapter.js

@@ -0,0 +1,443 @@
+/**
+ * MiniMax Search Adapter (DESIGN.md §5, §7, §12 — P2-04).
+ *
+ * Implements the real MiniMax Provider Descriptor with Search support
+ * on top of the transitional `mmx-cli/sdk`. The Adapter owns
+ * credentials, SDK lifecycle, Provider field mapping, and failure
+ * normalization; shared execution owns cache and retry policy.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import capability types, normalized errors, Provider identity
+ *     types, and the Adapter-local SDK client factory.
+ *   - Must NOT import `mmx-cli/sdk` directly (only sdk-client.ts does),
+ *     command presentation, output mode, or another Provider's Adapter.
+ *
+ * Field mapping (DESIGN.md §7 MiniMax mapping):
+ *   organic[].title   -> title
+ *   organic[].link    -> url
+ *   organic[].snippet -> summary
+ *   organic[].date    -> date (optional)
+ *
+ * The Adapter sends ONLY the query string to `sdk.search.query`. It
+ * NEVER sends count or unsupported controls. MiniMax rejects domain,
+ * recency, contentSize, and location controls with
+ * `UNSUPPORTED_OPTION` before SDK construction or credential access
+ * (FR-012).
+ */
+import crypto from "node:crypto";
+import { visionOperationToCapability } from "../../capabilities/vision.js";
+import { ApiError, AuthError, ConfigurationError, NetworkError, TimeoutError, UnsupportedCapabilityError, ValidationError, UnsupportedOptionError, } from "../../lib/errors.js";
+import { loadMiniMaxConfig } from "./config.js";
+import { createMiniMaxSdk } from "./sdk-client.js";
+import { resolveImageSource } from "./media.js";
+import { createMiniMaxQuotaCapability } from "./quota.js";
+import { fetchMiniMaxQuota, } from "./quota-client.js";
+import { isMiniMaxVisionOperationSupported, SPECIALIZED_VISION_OPERATION_SET, SPECIALIZED_VISION_OPERATIONS, } from "./vision-conformance.js";
+import { MINIMAX_VISION_MAPPINGS } from "./vision-mappings.generated.js";
+// ---------------------------------------------------------------------------
+// Provider-owned credential fingerprint
+// ---------------------------------------------------------------------------
+function credentialFingerprint(apiKey) {
+    return crypto.createHash("sha256").update(apiKey).digest("hex");
+}
+function resolveApiKey(env) {
+    const key = env.MINIMAX_API_KEY;
+    if (typeof key !== "string" || key.trim().length === 0) {
+        // Missing credentials are a configuration failure (exit 3), not an
+        // auth failure. AuthError (exit 1) is reserved for a credential the
+        // Provider REJECTED (Fixup A — B7). This mirrors loadMiniMaxConfig.
+        throw new ConfigurationError("MINIMAX_API_KEY environment variable is required", 'export MINIMAX_API_KEY="your-api-key"');
+    }
+    return key;
+}
+// ---------------------------------------------------------------------------
+// Validation (FR-012): reject unsupported controls before any SDK access
+// ---------------------------------------------------------------------------
+const UNSUPPORTED_CONTROLS = ["domain", "recency", "contentSize", "location"];
+function assertNoUnsupportedControls(request) {
+    const controls = request.controls;
+    if (!controls)
+        return;
+    for (const key of UNSUPPORTED_CONTROLS) {
+        if (controls[key] !== undefined) {
+            throw new UnsupportedOptionError("minimax", "search", key);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Response normalization (DESIGN.md §7 MiniMax mapping)
+// ---------------------------------------------------------------------------
+function normalizeMiniMaxSearchResults(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new ApiError("MiniMax search returned a malformed response", 500);
+    }
+    const envelope = raw;
+    if (!Array.isArray(envelope.organic)) {
+        throw new ApiError("MiniMax search returned a malformed response", 500);
+    }
+    const out = [];
+    for (const entry of envelope.organic) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+            throw new ApiError("MiniMax search returned a malformed response", 500);
+        }
+        const record = entry;
+        const title = record.title;
+        const link = record.link;
+        const snippet = record.snippet;
+        if (typeof title !== "string" || typeof link !== "string" || typeof snippet !== "string") {
+            throw new ApiError("MiniMax search returned a malformed response", 500);
+        }
+        const source = { title, url: link, summary: snippet };
+        if (typeof record.date === "string") {
+            source.date = record.date;
+        }
+        out.push(source);
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Failure normalization: stable public codes, no raw payloads (NFR-006)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a stable HTTP-style status code for retry classification.
+ * Explicit terminal client errors (404, 400, 410, 422) map to their
+ * real codes; retryable server errors (500, 502, 503, 504) map to
+ * themselves. Unknown failures default to 500 (transient). When the
+ * caller already carries a numeric status (a typed ApiError), that
+ * status is honoured directly (DESIGN.md §10).
+ */
+function inferStatusCode(lower, known) {
+    if (typeof known === "number" && Number.isFinite(known))
+        return known;
+    if (lower.includes("404") || lower.includes("not found"))
+        return 404;
+    if (lower.includes("400") || lower.includes("bad request"))
+        return 400;
+    if (lower.includes("410") || lower.includes("gone"))
+        return 410;
+    if (lower.includes("422") || lower.includes("unprocessable"))
+        return 422;
+    if (lower.includes("500") || lower.includes("internal"))
+        return 500;
+    if (lower.includes("502") || lower.includes("bad gateway"))
+        return 502;
+    if (lower.includes("503") || lower.includes("service unavailable"))
+        return 503;
+    if (lower.includes("504") || lower.includes("gateway timeout"))
+        return 504;
+    return 500;
+}
+function normalizeMiniMaxError(error) {
+    // Configuration/option/validation errors carry clean, human-authored
+    // messages and are safe to surface verbatim.
+    if (error instanceof ValidationError ||
+        error instanceof UnsupportedOptionError ||
+        error instanceof ConfigurationError) {
+        return error;
+    }
+    // Re-wrap typed transport errors with sanitized messages so a raw
+    // Provider response body embedded upstream never survives. Code +
+    // statusCode (retry signal) are preserved.
+    if (error instanceof AuthError) {
+        return new AuthError("MiniMax authentication failed");
+    }
+    if (error instanceof NetworkError) {
+        return new NetworkError("MiniMax network error");
+    }
+    if (error instanceof TimeoutError) {
+        // Fixup D: preserve the original error's duration instead of
+        // reconstructing it from an ambient process.env that may differ from
+        // the injected env. The rewrapped error carries the same duration.
+        return new TimeoutError(error.durationMs);
+    }
+    if (error instanceof ApiError) {
+        const statusCode = inferStatusCode("", error.statusCode);
+        return new ApiError("MiniMax request failed", statusCode);
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    const lower = message.toLowerCase();
+    if (lower.includes("401") ||
+        lower.includes("403") ||
+        lower.includes("unauthorized") ||
+        lower.includes("forbidden")) {
+        return new AuthError("MiniMax authentication failed");
+    }
+    if (lower.includes("timeout") || lower.includes("timed out") || lower.includes("etimedout")) {
+        return new TimeoutError(parseInt(process.env.MINIMAX_TIMEOUT || "30000", 10));
+    }
+    if (lower.includes("econnrefused") ||
+        lower.includes("econnreset") ||
+        lower.includes("network") ||
+        lower.includes("enotfound") ||
+        lower.includes("fetch failed")) {
+        return new NetworkError("MiniMax network error");
+    }
+    if (lower.includes("429") || lower.includes("rate limit")) {
+        return new ApiError("MiniMax rate limit exceeded", 429);
+    }
+    return new ApiError("MiniMax search request failed", inferStatusCode(lower));
+}
+function createMiniMaxSearchCapability(options) {
+    const { env, sdkConstructor } = options;
+    const capability = {
+        validate(request) {
+            if (!request || typeof request.query !== "string" || request.query.trim() === "") {
+                throw new ValidationError("Search query must contain at least one non-whitespace character");
+            }
+            assertNoUnsupportedControls(request);
+        },
+        cacheIdentity(request) {
+            const apiKey = resolveApiKey(env);
+            const identityRequest = {
+                query: request.query,
+            };
+            if (request.controls) {
+                identityRequest.controls = request.controls;
+            }
+            return {
+                provider: "minimax",
+                capability: "search",
+                credentialFingerprint: credentialFingerprint(apiKey),
+                request: identityRequest,
+                // MiniMax never probes legacy keys — no legacyCandidates.
+            };
+        },
+        async invoke(request) {
+            // Validate before any credential access or SDK construction.
+            capability.validate(request);
+            const config = loadMiniMaxConfig(env);
+            try {
+                const sdk = createMiniMaxSdk(config, sdkConstructor);
+                const raw = await sdk.search.query(request.query);
+                return normalizeMiniMaxSearchResults(raw);
+            }
+            catch (error) {
+                throw normalizeMiniMaxError(error);
+            }
+        },
+    };
+    return capability;
+}
+function resolveSpecializedSupportCheck(injected) {
+    if (injected)
+        return injected;
+    return (operation) => isMiniMaxVisionOperationSupported(operation);
+}
+/**
+ * Decide whether the MiniMax Adapter supports a Vision operation.
+ *
+ * `interpret-image` is supported unconditionally (the base release
+ * wires it through `sdk.vision.describe`). Specialized operations
+ * (`ui-artifact`, `extract-text`, `diagnose-error`, `diagram`,
+ * `chart`) are gated by the compiled conformance registry
+ * (DESIGN.md §15) — at P5-02 every entry is pending, so every
+ * specialized operation is unsupported here. `diff` and `video`
+ * remain Z.AI-only and are never supported by MiniMax.
+ *
+ * Pure: no Provider call, no env read, no I/O. The conformance query
+ * is a snapshot read of a frozen registry assembled at module load.
+ *
+ * `isSpecialized` is the injected support check (or the compiled
+ * registry query). Tests pass it via
+ * `dependencies.isSpecializedVisionOperationSupported`; production
+ * passes nothing and the registry query is used.
+ */
+function supportsMiniMaxVisionOperation(operation, isSpecialized) {
+    if (operation === "interpret-image")
+        return true;
+    if (SPECIALIZED_VISION_OPERATION_SET.has(operation)) {
+        return isSpecialized(operation);
+    }
+    return false;
+}
+/**
+ * Build the MiniMax Vision Capability. Maps `interpret-image` to
+ * `sdk.vision.describe`. The validated image source maps to `image`; the
+ * instruction maps to the optional `prompt`. Only a nonempty text result
+ * (extracted from the characterized `{ content }` envelope) is normalized.
+ *
+ * Specialized operations route through their operation-specific mapping
+ * Module when the support check returns true. The support decision is
+ * derived from the compiled conformance registry; tests may inject a
+ * forced-support function via `options.isSpecializedVisionOperationSupported`
+ * so the routing branch can be exercised without flipping a compiled
+ * attestation (DESIGN.md §15).
+ *
+ * Media is resolved after the configuration check; the SDK performs
+ * data-URI conversion, so the media module never reads file content.
+ * Vision never uses the response cache (FR-022); shared execution owns
+ * the retry policy.
+ */
+function createMiniMaxVisionCapability(options) {
+    const { env, sdkConstructor, isSpecializedVisionOperationSupported } = options;
+    const isSpecialized = resolveSpecializedSupportCheck(isSpecializedVisionOperationSupported);
+    const capability = {
+        supports(operation) {
+            return supportsMiniMaxVisionOperation(operation, isSpecialized);
+        },
+        async invoke(request) {
+            // Fail closed BEFORE any credential, media, or SDK access. The
+            // support decision is the single registry-driven gate; every
+            // specialized operation stays unsupported at P5-02 because every
+            // registry entry is pending.
+            if (!supportsMiniMaxVisionOperation(request.operation, isSpecialized)) {
+                throw new UnsupportedCapabilityError("minimax", visionOperationToCapability(request.operation));
+            }
+            // Configuration check (credential) before media resolution.
+            const config = loadMiniMaxConfig(env);
+            // Specialized operations compose the prompt through their mapping
+            // Module. The mapping Module is the single source of intent,
+            // option formatting, and result normalization for that operation
+            // (DESIGN.md §15). When the support gate is open but the Module is
+            // somehow missing, surface an `API_ERROR` — the routing invariant
+            // is broken only via a coding bug, never via runtime drift.
+            if (request.operation !== "interpret-image") {
+                const specializedOp = request.operation;
+                const mapping = MINIMAX_VISION_MAPPINGS[specializedOp];
+                if (!mapping) {
+                    throw new ApiError(`MiniMax vision mapping for ${specializedOp} is supported but no mapping Module is wired`, 500);
+                }
+                // Specialized requests always carry a `source`; the support gate
+                // above excludes `diff` (no `source`) and `video` (unsupported).
+                const image = resolveImageSource(request.source);
+                const prompt = mapping.composePrompt(request);
+                try {
+                    const sdk = createMiniMaxSdk(config, sdkConstructor);
+                    const raw = await sdk.vision.describe({ image, prompt });
+                    return mapping.normalizeResult(raw);
+                }
+                catch (error) {
+                    throw normalizeMiniMaxError(error);
+                }
+            }
+            const image = resolveImageSource(request.source);
+            try {
+                const sdk = createMiniMaxSdk(config, sdkConstructor);
+                const describeRequest = { image };
+                if (request.instruction && request.instruction.length > 0) {
+                    describeRequest.prompt = request.instruction;
+                }
+                const raw = await sdk.vision.describe(describeRequest);
+                return normalizeMiniMaxVisionResult(raw);
+            }
+            catch (error) {
+                throw normalizeMiniMaxError(error);
+            }
+        },
+    };
+    return capability;
+}
+/**
+ * Normalize the MiniMax vision result to a nonempty text string. The
+ * characterized `VlmResponse` envelope is `{ content: string }`; any other
+ * shape, or an empty content, is a malformed result.
+ */
+function normalizeMiniMaxVisionResult(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);
+}
+/**
+ * Build the MiniMax DiagnosticsCapability. MiniMax connectivity is
+ * probed through a raw single-attempt quota inspection
+ * ({@link fetchMiniMaxQuota}), NOT `QuotaCapability.invoke()`, because
+ * the remains endpoint authenticates without a generative request.
+ * There is NO nested retry wrapper here — shared execution owns the
+ * retry policy; this transport performs exactly one attempt.
+ */
+function createMiniMaxDiagnosticsCapability(options) {
+    const { env, ...transportDeps } = options;
+    return {
+        async invoke(diagOptions) {
+            if (!diagOptions.probe)
+                return;
+            const config = loadMiniMaxConfig(env);
+            try {
+                await fetchMiniMaxQuota(config, transportDeps);
+            }
+            catch (error) {
+                throw normalizeMiniMaxError(error);
+            }
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Descriptor factory
+// ---------------------------------------------------------------------------
+/**
+ * Build the MiniMax Provider Descriptor. The descriptor advertises the
+ * Search Capability and constructs an Adapter whose `search` Capability
+ * owns credentials, SDK lifecycle, Provider field mapping, and failure
+ * normalization. Construction is side-effect-free; the SDK is built and
+ * torn down per invocation. Tests pass `sdkConstructor`; production uses
+ * the no-argument factory which binds the pinned `mmx-cli/sdk`.
+ */
+export function createMiniMaxDescriptor(dependencies) {
+    const sdkConstructor = dependencies?.sdkConstructor;
+    const isSpecializedVisionOperationSupported = dependencies?.isSpecializedVisionOperationSupported;
+    // Direct quota transport injection (tests). Production uses the
+    // global fetch and timers resolved inside the quota client.
+    const quotaTransport = {};
+    if (dependencies?.quotaFetch) {
+        quotaTransport.fetch = dependencies.quotaFetch;
+    }
+    if (dependencies?.quotaSetTimeout) {
+        quotaTransport.setTimeout = dependencies.quotaSetTimeout;
+    }
+    if (dependencies?.quotaClearTimeout) {
+        quotaTransport.clearTimeout = dependencies.quotaClearTimeout;
+    }
+    return {
+        id: "minimax",
+        isConfigured(env) {
+            const key = env.MINIMAX_API_KEY;
+            return typeof key === "string" && /\S/.test(key);
+        },
+        capabilities() {
+            // Base capabilities always advertised by MiniMax. Specialized
+            // Vision operations (`vision.ui-artifact`, etc.) are advertised
+            // only when their conformance support check returns true
+            // (DESIGN.md §15). Production derives this from the compiled
+            // registry; tests may force specific operations into the
+            // advertised set via
+            // `dependencies.isSpecializedVisionOperationSupported` so the
+            // routing branch can be exercised without flipping attestations.
+            const caps = new Set([
+                "search",
+                "vision.interpret-image",
+                "quota",
+                "diagnostics",
+            ]);
+            const isSpecialized = resolveSpecializedSupportCheck(isSpecializedVisionOperationSupported);
+            for (const op of SPECIALIZED_VISION_OPERATIONS) {
+                if (isSpecialized(op)) {
+                    caps.add(visionOperationToCapability(op));
+                }
+            }
+            return caps;
+        },
+        create(context) {
+            const search = createMiniMaxSearchCapability({
+                env: context.env,
+                sdkConstructor,
+            });
+            const vision = createMiniMaxVisionCapability({
+                env: context.env,
+                sdkConstructor,
+                isSpecializedVisionOperationSupported,
+            });
+            const quotaOptions = { env: context.env, ...quotaTransport };
+            const quota = createMiniMaxQuotaCapability(quotaOptions);
+            const diagnostics = createMiniMaxDiagnosticsCapability({
+                env: context.env,
+                ...quotaTransport,
+            });
+            return { id: "minimax", search, vision, quota, diagnostics };
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/minimax/adapter.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,34 @@
+/**
+ * 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`.
+ *   - Must NOT read file content. The transitional MiniMax SDK performs
+ *     data-URI conversion; this module only `stat`s for existence and size
+ *     and returns the validated absolute path.
+ *
+ * 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.
+ *   - The SDK performs data-URI conversion; this module does NOT read
+ *     file content.
+ *   - 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.
+ */
+/**
+ * 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;
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAyEH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUzD"}