scoutline 0.1.0 → 0.2.0

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

@@ -0,0 +1,22 @@
+/**
+ * GENERATED FILE — DO NOT EDIT BY HAND.
+ *
+ * Regenerate with: `node scripts/generate-minimax-vision-revisions.mjs`.
+ * The prebuild step in `packages/scoutline/package.json` runs the
+ * generator before `tsc`, so this file is always fresh when the
+ * TypeScript compiler runs.
+ *
+ * Each value is a SHA-256 digest covering the Implementation ID
+ * (`mmx-cli-sdk@1.0.16`), the stable common mapping runtime
+ * (`vision-mappings/common.ts`), only that operation's mapping Module
+ * under `vision-mappings/`, the fixture image bytes, the canonical
+ * request fields, and the exact required assertion IDs. Adding another
+ * operation does not change an existing operation's revision; changing
+ * the common runtime intentionally changes every revision.
+ *
+ * Operations without a mapping Module carry the placeholder
+ * `"pending-no-mapping-module"` until P5-03 creates their Module.
+ */
+import type { SpecializedVisionOperation } from "./vision-conformance.js";
+export declare const MINIMAX_VISION_MAPPING_REVISIONS: Readonly<Record<SpecializedVisionOperation, string>>;
+//# sourceMappingURL=vision-revisions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vision-revisions.d.ts","sourceRoot":"","sources":["../../../src/providers/minimax/vision-revisions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAE1E,eAAO,MAAM,gCAAgC,EAAE,QAAQ,CACrD,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAO1C,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * GENERATED FILE — DO NOT EDIT BY HAND.
+ *
+ * Regenerate with: `node scripts/generate-minimax-vision-revisions.mjs`.
+ * The prebuild step in `packages/scoutline/package.json` runs the
+ * generator before `tsc`, so this file is always fresh when the
+ * TypeScript compiler runs.
+ *
+ * Each value is a SHA-256 digest covering the Implementation ID
+ * (`mmx-cli-sdk@1.0.16`), the stable common mapping runtime
+ * (`vision-mappings/common.ts`), only that operation's mapping Module
+ * under `vision-mappings/`, the fixture image bytes, the canonical
+ * request fields, and the exact required assertion IDs. Adding another
+ * operation does not change an existing operation's revision; changing
+ * the common runtime intentionally changes every revision.
+ *
+ * Operations without a mapping Module carry the placeholder
+ * `"pending-no-mapping-module"` until P5-03 creates their Module.
+ */
+export const MINIMAX_VISION_MAPPING_REVISIONS = Object.freeze({
+    "ui-artifact": "f359d5cda2f0f6fc7b8b1308a8842ede7a09b8c5517c46e205a46881afeb5290",
+    "extract-text": "78758cfc03e282c2609eb4e05fab392be62d9b6d38c8911bf245f74206ccbf0e",
+    "diagnose-error": "f83d602a6177041d131cb05b4164e0529b04154a5651e042cea66f566d94d893",
+    "diagram": "0828b3e3c60a1f207dcd8ce4f83cf4855fef45f24436870b53a380065487e5d5",
+    "chart": "b930eac3e997e20c481abbaff4e756dced7a82a085bba770ec57ea34690c2259",
+});
+//# sourceMappingURL=vision-revisions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vision-revisions.js","sourceRoot":"","sources":["../../../src/providers/minimax/vision-revisions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,MAAM,CAAC,MAAM,gCAAgC,GAEzC,MAAM,CAAC,MAAM,CAAC;IAChB,aAAa,EAAE,kEAAkE;IACjF,cAAc,EAAE,kEAAkE;IAClF,gBAAgB,EAAE,kEAAkE;IACpF,SAAS,EAAE,kEAAkE;IAC7E,OAAO,EAAE,kEAAkE;CAC5E,CAAC,CAAC"}

package/dist/providers/registry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Static Provider Registry (DESIGN.md §5, P2-05).
+ *
+ * The production registry is a static list of the two real Search
+ * Provider Descriptors, in the fixed order [zai, minimax]. It performs
+ * NO dynamic imports, accepts no package names, file paths, or
+ * externally supplied factories. Tests inject descriptor lists through
+ * the explicit optional parameters of {@link getProviderDescriptor} and
+ * {@link getConfiguredProviderDescriptors}; production uses the static
+ * built-in list by default.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - Imports the real Adapter Modules (`providers/zai/adapter.js`,
+ *     `providers/minimax/adapter.js`), NOT the P2-01 stubs in `types.ts`.
+ *   - Must NOT import command Modules, shared execution, or transport.
+ */
+import type { ProviderDescriptor, ProviderId } from "./types.js";
+/**
+ * Built-in Provider Descriptors in canonical order. Each Descriptor is
+ * constructed once at module load with its production (no-argument)
+ * factory; the Adapters bind their real transports lazily, only inside
+ * Capability invocation.
+ */
+export declare const BUILT_IN_PROVIDER_DESCRIPTORS: readonly ProviderDescriptor[];
+/**
+ * Look up a built-in Descriptor by ID. The optional `descriptors`
+ * parameter lets tests inject doubles; production defaults to the
+ * static built-in list.
+ */
+export declare function getProviderDescriptor(id: ProviderId, descriptors?: readonly ProviderDescriptor[]): ProviderDescriptor;
+/**
+ * Return the built-in Descriptors that are configured for the given
+ * environment. Pure metadata; no Adapter is constructed.
+ */
+export declare function getConfiguredProviderDescriptors(env: NodeJS.ProcessEnv, descriptors?: readonly ProviderDescriptor[]): readonly ProviderDescriptor[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMjE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,kBAAkB,EAGtE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,UAAU,EACd,WAAW,GAAE,SAAS,kBAAkB,EAAkC,GACzE,kBAAkB,CAEpB;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,WAAW,GAAE,SAAS,kBAAkB,EAAkC,GACzE,SAAS,kBAAkB,EAAE,CAE/B"}

package/dist/providers/registry.js

@@ -0,0 +1,45 @@
+/**
+ * Static Provider Registry (DESIGN.md §5, P2-05).
+ *
+ * The production registry is a static list of the two real Search
+ * Provider Descriptors, in the fixed order [zai, minimax]. It performs
+ * NO dynamic imports, accepts no package names, file paths, or
+ * externally supplied factories. Tests inject descriptor lists through
+ * the explicit optional parameters of {@link getProviderDescriptor} and
+ * {@link getConfiguredProviderDescriptors}; production uses the static
+ * built-in list by default.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - Imports the real Adapter Modules (`providers/zai/adapter.js`,
+ *     `providers/minimax/adapter.js`), NOT the P2-01 stubs in `types.ts`.
+ *   - Must NOT import command Modules, shared execution, or transport.
+ */
+import { createZaiDescriptor } from "./zai/adapter.js";
+import { createMiniMaxDescriptor } from "./minimax/adapter.js";
+import { getProviderDescriptor as lookupProviderDescriptor, getConfiguredProviderDescriptors as lookupConfigured, } from "./types.js";
+/**
+ * Built-in Provider Descriptors in canonical order. Each Descriptor is
+ * constructed once at module load with its production (no-argument)
+ * factory; the Adapters bind their real transports lazily, only inside
+ * Capability invocation.
+ */
+export const BUILT_IN_PROVIDER_DESCRIPTORS = [
+    createZaiDescriptor(),
+    createMiniMaxDescriptor(),
+];
+/**
+ * Look up a built-in Descriptor by ID. The optional `descriptors`
+ * parameter lets tests inject doubles; production defaults to the
+ * static built-in list.
+ */
+export function getProviderDescriptor(id, descriptors = BUILT_IN_PROVIDER_DESCRIPTORS) {
+    return lookupProviderDescriptor(id, descriptors);
+}
+/**
+ * Return the built-in Descriptors that are configured for the given
+ * environment. Pure metadata; no Adapter is constructed.
+ */
+export function getConfiguredProviderDescriptors(env, descriptors = BUILT_IN_PROVIDER_DESCRIPTORS) {
+    return lookupConfigured(env, descriptors);
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EACL,qBAAqB,IAAI,wBAAwB,EACjD,gCAAgC,IAAI,gBAAgB,GACrD,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAkC;IAC1E,mBAAmB,EAAE;IACrB,uBAAuB,EAAE;CAC1B,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,EAAc,EACd,WAAW,GAAkC,6BAA6B;IAE1E,OAAO,wBAAwB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,GAAsB,EACtB,WAAW,GAAkC,6BAA6B;IAE1E,OAAO,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC"}

package/dist/providers/selection.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Provider Selection (DESIGN.md §6, PRD FR-001 through FR-005).
+ *
+ * Pure resolution of a Provider ID from explicit and environment input.
+ * No credentials participate; no Adapter is constructed.
+ *
+ * Precedence:
+ *   1. explicit option (trimmed, lowercased)
+ *   2. SCOUTLINE_PROVIDER environment variable (trimmed, lowercased)
+ *   3. compatibility default `zai`
+ *
+ * An explicitly empty Provider is present and invalid; it must NOT fall
+ * through to the environment or default. Unknown values are invalid in
+ * both explicit and environment positions.
+ *
+ * Only Search, Vision, quota, and diagnostics call this module.
+ * Z.AI-only command families (Reader, repository exploration, raw
+ * tools, Code Mode) remove the global flag during parsing and never
+ * resolve or validate it.
+ */
+import type { ProviderId } from "./types.js";
+export { getProviderDescriptor, getConfiguredProviderDescriptors } from "./types.js";
+/**
+ * Parse and validate a Provider ID. Trims and lowercases the input.
+ * Empty and unknown values throw `ValidationError` whose `help` lists
+ * the accepted IDs.
+ */
+export declare function parseProviderId(value: string): ProviderId;
+/**
+ * Resolve the effective Provider ID with explicit precedence over
+ * environment over the compatibility default. An explicitly empty
+ * value (including whitespace) is treated as present and invalid; it
+ * throws `ValidationError` before consulting the environment.
+ *
+ * `env` defaults to `process.env` for production callers; tests pass
+ * an explicit object so they do not touch process globals.
+ *
+ * FR-003: provider selection is NEVER inferred from available
+ * credentials. The default branch always returns `"zai"`; whether the
+ * effective Provider is configured is a question for the caller (which
+ * throws `ConfigurationError`, exit 3), not for selection.
+ */
+export declare function resolveProviderId(explicitProvider: string | undefined, env?: NodeJS.ProcessEnv): ProviderId;
+//# sourceMappingURL=selection.d.ts.map

package/dist/providers/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/providers/selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,OAAO,EAAE,qBAAqB,EAAE,gCAAgC,EAAE,MAAM,YAAY,CAAC;AAiBrF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAezD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,UAAU,CAkBZ"}

package/dist/providers/selection.js

@@ -0,0 +1,85 @@
+/**
+ * Provider Selection (DESIGN.md §6, PRD FR-001 through FR-005).
+ *
+ * Pure resolution of a Provider ID from explicit and environment input.
+ * No credentials participate; no Adapter is constructed.
+ *
+ * Precedence:
+ *   1. explicit option (trimmed, lowercased)
+ *   2. SCOUTLINE_PROVIDER environment variable (trimmed, lowercased)
+ *   3. compatibility default `zai`
+ *
+ * An explicitly empty Provider is present and invalid; it must NOT fall
+ * through to the environment or default. Unknown values are invalid in
+ * both explicit and environment positions.
+ *
+ * Only Search, Vision, quota, and diagnostics call this module.
+ * Z.AI-only command families (Reader, repository exploration, raw
+ * tools, Code Mode) remove the global flag during parsing and never
+ * resolve or validate it.
+ */
+import { PROVIDER_IDS } from "./types.js";
+import { ValidationError } from "../lib/errors.js";
+// Re-export descriptor helpers at the selection boundary so command
+// Modules need only a single import.
+export { getProviderDescriptor, getConfiguredProviderDescriptors } from "./types.js";
+/**
+ * Accepted Provider IDs shown in the help message when validation fails.
+ */
+const ACCEPTED_IDS_HELP = `Accepted provider IDs: ${PROVIDER_IDS.join(", ")}.`;
+/**
+ * Trim and lowercase a Provider candidate. Returns `null` when the
+ * trimmed value is empty so callers can distinguish "absent" from
+ * "invalid".
+ */
+function normalize(raw) {
+    const trimmed = raw.trim().toLowerCase();
+    return trimmed.length === 0 ? null : trimmed;
+}
+/**
+ * Parse and validate a Provider ID. Trims and lowercases the input.
+ * Empty and unknown values throw `ValidationError` whose `help` lists
+ * the accepted IDs.
+ */
+export function parseProviderId(value) {
+    const normalized = normalize(value);
+    if (normalized === null) {
+        throw new ValidationError(`Provider ID must not be empty. ${ACCEPTED_IDS_HELP}`, ACCEPTED_IDS_HELP);
+    }
+    if (!PROVIDER_IDS.includes(normalized)) {
+        throw new ValidationError(`Unknown provider "${normalized}". ${ACCEPTED_IDS_HELP}`, ACCEPTED_IDS_HELP);
+    }
+    return normalized;
+}
+/**
+ * Resolve the effective Provider ID with explicit precedence over
+ * environment over the compatibility default. An explicitly empty
+ * value (including whitespace) is treated as present and invalid; it
+ * throws `ValidationError` before consulting the environment.
+ *
+ * `env` defaults to `process.env` for production callers; tests pass
+ * an explicit object so they do not touch process globals.
+ *
+ * FR-003: provider selection is NEVER inferred from available
+ * credentials. The default branch always returns `"zai"`; whether the
+ * effective Provider is configured is a question for the caller (which
+ * throws `ConfigurationError`, exit 3), not for selection.
+ */
+export function resolveProviderId(explicitProvider, env = process.env) {
+    // 1. Explicit option — present (including empty) and invalid if empty/unknown.
+    if (explicitProvider !== undefined) {
+        return parseProviderId(explicitProvider);
+    }
+    // 2. Environment variable. An empty value here means "explicitly empty":
+    //    present, invalid, and must not fall through to the default.
+    const envValue = env.SCOUTLINE_PROVIDER;
+    if (envValue !== undefined) {
+        return parseProviderId(envValue);
+    }
+    // 3. Compatibility default. No credentials, descriptors, or
+    //    configuration participate (FR-003). The "is the effective
+    //    Provider configured?" check lives in the dispatch caller, which
+    //    surfaces a missing credential as ConfigurationError (exit 3).
+    return "zai";
+}
+//# sourceMappingURL=selection.js.map

package/dist/providers/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/providers/selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,oEAAoE;AACpE,qCAAqC;AACrC,OAAO,EAAE,qBAAqB,EAAE,gCAAgC,EAAE,MAAM,YAAY,CAAC;AAErF;;GAEG;AACH,MAAM,iBAAiB,GAAG,0BAA0B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAE/E;;;;GAIG;AACH,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,eAAe,CACvB,kCAAkC,iBAAiB,EAAE,EACrD,iBAAiB,CAClB,CAAC;IACJ,CAAC;IACD,IAAI,CAAE,YAAkC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,eAAe,CACvB,qBAAqB,UAAU,MAAM,iBAAiB,EAAE,EACxD,iBAAiB,CAClB,CAAC;IACJ,CAAC;IACD,OAAO,UAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAC/B,gBAAoC,EACpC,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,+EAA+E;IAC/E,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAC3C,CAAC;IAED,yEAAyE;IACzE,iEAAiE;IACjE,MAAM,QAAQ,GAAG,GAAG,CAAC,kBAAkB,CAAC;IACxC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,4DAA4D;IAC5D,+DAA+D;IAC/D,qEAAqE;IACrE,mEAAmE;IACnE,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/providers/types.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Provider Types (DESIGN.md §5, PRD FR-001, FR-004, NFR-004, NFR-010).
+ *
+ * This module defines the static shape of a Provider: a stable ID, the
+ * set of Capabilities it advertises, and a factory that produces an
+ * Adapter bound to a Provider context. No transport, no I/O, no
+ * credential reads occur outside Capability invocation.
+ *
+ * Phase 2 (P2-01) declares only the Search Capability; Phase 3 (P3-01)
+ * adds the `vision?: VisionCapability` slot on `ProviderAdapter` and
+ * declares the matching descriptor metadata. Quota and diagnostics
+ * attach to the `ProviderAdapter` interface in later phases. The
+ * `ProviderCapability` union already enumerates them so descriptor
+ * metadata stays forward-compatible.
+ *
+ * `BUILT_IN_PROVIDER_DESCRIPTORS` is intentionally empty in this stub
+ * file; the production registry waits for P2-05, after both real
+ * Search Adapters exist. Selection functions and tests operate on
+ * explicit descriptor lists through `getProviderDescriptor` and
+ * `getConfiguredProviderDescriptors`.
+ */
+import type { SearchCapability } from "../capabilities/search.js";
+import type { VisionCapability } from "../capabilities/vision.js";
+import type { QuotaCapability } from "../capabilities/quota.js";
+import type { DiagnosticsCapability } from "../capabilities/diagnostics.js";
+/**
+ * Built-in Provider IDs. Adding a new Provider is a Phase 2+ decision;
+ * new entries must come with a real Adapter and conformance coverage.
+ */
+export declare const PROVIDER_IDS: readonly ["zai", "minimax"];
+export type ProviderId = (typeof PROVIDER_IDS)[number];
+/**
+ * The set of Capability names a Provider may advertise. Phase 2
+ * declares the full union so descriptor metadata stays forward-compatible
+ * with Phase 3+ Adapters, but only `search` is wired into the
+ * `ProviderAdapter` shape today.
+ */
+export type ProviderCapability = "search" | "vision.interpret-image" | "vision.ui-artifact" | "vision.extract-text" | "vision.diagnose-error" | "vision.diagram" | "vision.chart" | "vision.diff" | "vision.video" | "quota" | "diagnostics";
+/**
+ * Injected Provider context. Adapters capture but do not immediately
+ * inspect this; credential resolution and transport construction happen
+ * only inside Capability invocation after validation.
+ */
+export interface ProviderContext {
+    readonly env: NodeJS.ProcessEnv;
+}
+/**
+ * Provider Adapter contract (Phase 3 shape). Each Capability that the
+ * Provider supports becomes a property on this interface. Phase 4 adds
+ * `quota?: QuotaCapability` and `diagnostics?: DiagnosticsCapability`.
+ */
+export interface ProviderAdapter {
+    readonly id: ProviderId;
+    readonly search?: SearchCapability;
+    readonly vision?: VisionCapability;
+    readonly quota?: QuotaCapability;
+    readonly diagnostics?: DiagnosticsCapability;
+}
+/**
+ * Provider Descriptor. `capabilities()` and `isConfigured()` construct
+ * no Adapter or transport. `create()` is side-effect-free: it captures
+ * the injected environment but shall not read credentials, inspect
+ * media, construct a transport, or perform I/O. Credential resolution
+ * and transport construction are allowed only inside Capability
+ * invocation after validation.
+ */
+export interface ProviderDescriptor {
+    readonly id: ProviderId;
+    isConfigured(env: NodeJS.ProcessEnv): boolean;
+    capabilities(): ReadonlySet<ProviderCapability>;
+    create(context: ProviderContext): ProviderAdapter;
+}
+/**
+ * Built-in Provider registry. Phase 2 leaves this empty; P2-05 wires
+ * the real Z.AI and MiniMax descriptors once both Adapters exist. Tests
+ * inject descriptor lists explicitly through `getProviderDescriptor` and
+ * `getConfiguredProviderDescriptors`; the production registry is static
+ * and never accepts package names, file paths, or dynamic imports.
+ */
+export declare const BUILT_IN_PROVIDER_DESCRIPTORS: readonly ProviderDescriptor[];
+/**
+ * Look up a descriptor by ID. Throws when the ID is unknown. The
+ * optional `descriptors` parameter lets tests inject doubles; production
+ * uses the static built-in list.
+ */
+export declare function getProviderDescriptor(id: ProviderId, descriptors?: readonly ProviderDescriptor[]): ProviderDescriptor;
+/**
+ * Return the descriptors that are configured for the given environment.
+ * Configuration is purely metadata-driven and never constructs an
+ * Adapter.
+ */
+export declare function getConfiguredProviderDescriptors(env: NodeJS.ProcessEnv, descriptors?: readonly ProviderDescriptor[]): readonly ProviderDescriptor[];
+/**
+ * Narrow UTCP client surface used by Adapters. Production code passes
+ * `UtcpClient.create()` factories wrapped to this shape; tests inject
+ * doubles with the same surface.
+ */
+export interface UtcpClientPort {
+    registerManual(template: unknown): Promise<{
+        success: boolean;
+        errors: string[];
+    }>;
+    getTools(): Promise<unknown[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+}
+/**
+ * Z.AI MCP client options. `utcpFactory` is the existing P0-02 injection
+ * seam; `noCache` and `disableRetry` arrive in P2-03 so Adapters can
+ * hand policy to shared execution.
+ */
+export interface ZaiMcpClientOptions {
+    readonly enableVision?: boolean;
+    readonly noCache?: boolean;
+    readonly disableRetry?: boolean;
+    readonly utcpFactory?: () => Promise<UtcpClientPort>;
+}
+/**
+ * Legacy Z.AI search parameters as accepted by `ZaiMcpClient.webSearch`.
+ * Preserved by the Adapter so legacy cache keys remain reconstructible.
+ */
+export interface LegacyZaiSearchParams {
+    query: string;
+    count?: number;
+    domainFilter?: string;
+    recencyFilter?: "oneDay" | "oneWeek" | "oneMonth" | "oneYear" | "noLimit";
+    contentSize?: "medium" | "high";
+    location?: "cn" | "us";
+}
+/** Result envelope produced by `ZaiMcpClient.webSearch`. */
+export interface WebSearchResult {
+    refer: string;
+    title: string;
+    link: string;
+    media: string;
+    content: string;
+    icon: string;
+    publish_date?: string;
+}
+/**
+ * Legacy direct Z.AI search client surface used while P2-03 ships. P2-03
+ * replaces this with a real Adapter; P2-05 removes it.
+ */
+export interface LegacySearchClientPort {
+    webSearch(params: LegacyZaiSearchParams): Promise<WebSearchResult[]>;
+    close(): Promise<void>;
+}
+/**
+ * Injectable fetch response for quota transports (duck-typed). The
+ * injected fetch returns this minimal shape so tests pass a plain object
+ * without depending on the DOM `Response` type.
+ */
+export interface ProviderQuotaFetchResponse {
+    readonly ok: boolean;
+    readonly status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}
+export type ProviderQuotaFetch = (input: string | URL, init: Record<string, unknown>) => Promise<ProviderQuotaFetchResponse>;
+/** Dependencies the Phase 2 Search wiring would inject into the registry. */
+export interface SearchDependencies {
+    clientFactory(options: ZaiMcpClientOptions): LegacySearchClientPort;
+}
+/**
+ * Narrow surface a Z.AI Search Adapter uses from `ZaiMcpClient`. The
+ * Adapter only invokes raw tools; cache and retry policy live in shared
+ * execution. `listTools` is the tool-discovery surface the Z.AI
+ * diagnostics capability probes (DESIGN.md §14).
+ */
+export interface ZaiAdapterClientPort {
+    callToolRaw<T>(name: string, args: Record<string, unknown>): Promise<T>;
+    listTools(): Promise<unknown[]>;
+    close(): Promise<void>;
+}
+/** Dependencies the Z.AI Search Adapter accepts through injection. */
+export interface ZaiAdapterDependencies {
+    clientFactory(options: ZaiMcpClientOptions): ZaiAdapterClientPort;
+    /** Optional Z.AI quota-monitor transport injection (tests). */
+    readonly quotaFetch?: ProviderQuotaFetch;
+    readonly quotaSetTimeout?: typeof setTimeout;
+    readonly quotaClearTimeout?: typeof clearTimeout;
+}
+/**
+ * Dependencies the MiniMax Adapter accepts. `sdkConstructor` is the
+ * only escape hatch tests need; production never passes it.
+ */
+export interface MiniMaxAdapterDependencies {
+    readonly sdkConstructor?: MiniMaxSdkConstructor;
+    /** Optional MiniMax direct quota transport injection (tests). */
+    readonly quotaFetch?: ProviderQuotaFetch;
+    readonly quotaSetTimeout?: typeof setTimeout;
+    readonly quotaClearTimeout?: typeof clearTimeout;
+    /**
+     * Optional injection point for the specialized-vision support check
+     * (`MiniMaxAdapterDependencies.isSpecializedVisionOperationSupported`).
+     * Production never sets this; tests pass a forced-support function so
+     * the routing branch can be exercised deterministically without
+     * flipping a compiled registry attestation. When omitted, the Adapter
+     * delegates to the compiled conformance registry query.
+     */
+    readonly isSpecializedVisionOperationSupported?: (operation: import("./minimax/vision-conformance.js").SpecializedVisionOperation) => boolean;
+}
+/**
+ * MiniMax SDK constructor type. Kept here so Adapter Modules do not
+ * import `mmx-cli/sdk` directly; only `providers/minimax/sdk-client.ts`
+ * references the implementation.
+ */
+export interface MiniMaxSdkConstructor {
+    new (options: {
+        apiKey: string;
+        region: "global" | "cn";
+        baseUrl: string;
+    }): MiniMaxSdkPort;
+}
+/** Narrow MiniMax SDK surface used by the Adapter. */
+export interface MiniMaxSdkPort {
+    search: {
+        query(query: string): Promise<unknown>;
+    };
+    vision: {
+        describe(request: {
+            image: string;
+            prompt?: string;
+        }): Promise<unknown>;
+    };
+}
+/**
+ * Build the Z.AI Provider Descriptor. Phase 2 returns a stub that
+ * advertises the search Capability; P2-03 supplies the real Adapter.
+ * P3-01 extends the capability set with every current Vision operation
+ * so descriptor metadata advertises the Capability before any Adapter
+ * is constructed; the real `vision` slot arrives in P3-03.
+ *
+ * The stub keeps the Provider registerable from day one while the
+ * Search Adapter is implemented in P2-03. Throwing inside `create()`
+ * surfaces the unfinished Adapter during testing rather than silently
+ * failing later.
+ */
+export declare function createZaiDescriptor(dependencies?: ZaiAdapterDependencies): ProviderDescriptor;
+/**
+ * Build the MiniMax Provider Descriptor. Phase 2 returns a stub that
+ * advertises the search Capability; P2-04 supplies the real Adapter.
+ * P3-01 advertises the general `vision.interpret-image` Capability
+ * while leaving every specialized operation out until Phase 5
+ * attests individual specialized mappings.
+ */
+export declare function createMiniMaxDescriptor(dependencies?: MiniMaxAdapterDependencies): ProviderDescriptor;
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAM5E;;;GAGG;AACH,eAAO,MAAM,YAAY,YAAI,KAAK,EAAE,SAAS,CAAU,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,wBAAwB,GACxB,oBAAoB,GACpB,qBAAqB,GACrB,uBAAuB,GACvB,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,cAAc,GACd,OAAO,GACP,aAAa,CAAC;AAMlB;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC;CAC9C;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC;IAC9C,YAAY,IAAI,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAChD,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAAC;CACnD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,kBAAkB,EAAO,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,UAAU,EACd,WAAW,CAAC,EAAE,SAAS,kBAAkB,EAAE,GAC1C,kBAAkB,CAOpB;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,WAAW,CAAC,EAAE,SAAS,kBAAkB,EAAE,GAC1C,SAAS,kBAAkB,EAAE,CAG/B;AAMD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;QACzC,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;IACH,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;CACtD;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1E,WAAW,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,KAAK,EAAE,MAAM,GAAG,GAAG,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,0BAA0B,CAAC,CAAC;AAEzC,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,sBAAsB,CAAC;CACrE;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxE,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB,CAAC;IAClE,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,UAAU,CAAC;IAC7C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,YAAY,CAAC;CAClD;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,iEAAiE;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,UAAU,CAAC;IAC7C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,YAAY,CAAC;IACjD;;;;;;;OAOG;IACH,QAAQ,CAAC,qCAAqC,CAAC,EAAE,CAC/C,SAAS,EAAE,OAAO,iCAAiC,EAAE,0BAA0B,KAC5E,OAAO,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC;CAC7F;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QACN,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACxC,CAAC;IACF,MAAM,EAAE;QACN,QAAQ,CAAC,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACzE,CAAC;CACH;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAEjC,YAAY,CAAC,EAAE,sBAAsB,GACpC,kBAAkB,CAyBpB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAErC,YAAY,CAAC,EAAE,0BAA0B,GACxC,kBAAkB,CAcpB"}