@sriinnu/kosha-discovery 0.5.0

package/dist/discovery/vertex.js

@@ -0,0 +1,371 @@
+/**
+ * kosha-discovery — Google Vertex AI provider discoverer.
+ *
+ * Resolution strategy (in order):
+ * 1. REST API with Application Default Credentials (ADC)
+ * 2. gcloud CLI fallback (`gcloud ai models list`)
+ * 3. Static fallback list of known Vertex AI models
+ *
+ * Credentials: Uses the Google ADC chain —
+ *   ~/.config/gcloud/application_default_credentials.json,
+ *   GOOGLE_APPLICATION_CREDENTIALS env var, or the GCP metadata server.
+ * @module
+ */
+import { execFileSync, execSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { assertSafeShellArg } from "../shell-safe.js";
+import { assertCleanPayload } from "../security.js";
+import { BaseDiscoverer } from "./base.js";
+// ---------------------------------------------------------------------------
+// VertexDiscoverer
+// ---------------------------------------------------------------------------
+/**
+ * Discovers models available through Google Vertex AI.
+ *
+ * Works without an explicit API key: access tokens are resolved via the
+ * standard ADC chain, so it behaves correctly in local dev environments
+ * (after `gcloud auth application-default login`) and on GCP VMs (metadata
+ * server).  When the REST API is unavailable it falls back to the gcloud CLI,
+ * and when that is missing it returns a curated static list so callers always
+ * receive useful results.
+ */
+export class VertexDiscoverer extends BaseDiscoverer {
+    providerId = "vertex";
+    providerName = "Google Vertex AI";
+    /** Template string — region is substituted per-request. */
+    baseUrl = "https://{region}-aiplatform.googleapis.com";
+    /**
+     * Discover models from Vertex AI using a three-tier fallback strategy:
+     *   1. Vertex AI REST API (requires an ADC access token + project ID)
+     *   2. `gcloud ai models list` CLI
+     *   3. Curated static list
+     *
+     * @param credential - Credential bag; `accessToken` is used when present.
+     *   `metadata.projectId` and `metadata.region` take precedence over env vars.
+     * @param options    - Optional timeout in ms (default 10 000).
+     */
+    async discover(credential, options) {
+        // Project ID resolution: credential → env vars → gcloud config
+        let projectId = credential.metadata?.projectId ??
+            process.env.GOOGLE_CLOUD_PROJECT ??
+            process.env.GCLOUD_PROJECT;
+        if (!projectId) {
+            projectId = this.resolveProjectFromCli();
+        }
+        // Region resolution: credential → env var → default
+        const region = credential.metadata?.region ?? process.env.GOOGLE_CLOUD_REGION ?? "us-central1";
+        // Attempt 1: REST API
+        try {
+            const cards = await this.discoverViaApi(credential, projectId, region, options);
+            if (cards.length > 0)
+                return cards;
+        }
+        catch {
+            // Fall through to CLI
+        }
+        // Attempt 2: gcloud CLI
+        if (projectId) {
+            try {
+                const cards = await this.discoverViaCli(projectId, region);
+                if (cards.length > 0)
+                    return cards;
+            }
+            catch {
+                // Fall through to static list
+            }
+        }
+        // Attempt 3: Static fallback
+        return this.staticFallback(region, projectId);
+    }
+    // -------------------------------------------------------------------------
+    // Private: REST API
+    // -------------------------------------------------------------------------
+    /**
+     * Fetch models from the Vertex AI Publisher Models REST endpoint.
+     *
+     * URL: `https://{region}-aiplatform.googleapis.com/v1/projects/{project}/
+     *       locations/{region}/publishers/google/models`
+     *
+     * @param credential - Used to obtain a Bearer token via {@link getAccessToken}.
+     * @param projectId  - GCP project ID (required for the REST path).
+     * @param region     - GCP region (e.g. "us-central1").
+     * @param options    - Optional timeout override.
+     */
+    async discoverViaApi(credential, projectId, region, options) {
+        if (!projectId)
+            throw new Error("Vertex AI: project ID is required for the REST API");
+        assertSafeShellArg(projectId, "projectId");
+        assertSafeShellArg(region, "region");
+        const token = await this.getAccessToken(credential);
+        if (!token)
+            throw new Error("Vertex AI: could not obtain an access token");
+        const host = `https://${region}-aiplatform.googleapis.com`;
+        const url = `${host}/v1/projects/${projectId}/locations/${region}/publishers/google/models`;
+        const headers = {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        };
+        const response = await this.fetchJSON(url, headers, this.validateTimeout(options?.timeout));
+        const rawModels = response.publisherModels ?? response.models ?? [];
+        return rawModels.map((m) => this.toModelCard(m, region, projectId));
+    }
+    // -------------------------------------------------------------------------
+    // Private: ADC token resolution
+    // -------------------------------------------------------------------------
+    /**
+     * Resolve a Google OAuth2 access token using the ADC chain:
+     *   1. `credential.accessToken` — already resolved upstream
+     *   2. ADC JSON file containing `access_token` (service account / workload identity)
+     *   3. ADC JSON file with `refresh_token` — exchange via Google OAuth endpoint
+     *   4. `gcloud auth print-access-token` CLI fallback
+     *
+     * Returns `undefined` when no token can be obtained.
+     *
+     * @param credential - The credential bag from the discovery pipeline.
+     */
+    async getAccessToken(credential) {
+        // 1. Token already present in credential
+        if (credential.accessToken)
+            return credential.accessToken;
+        // 2 & 3. Try the ADC credentials file
+        const adcPath = process.env.GOOGLE_APPLICATION_CREDENTIALS ??
+            join(homedir(), ".config", "gcloud", "application_default_credentials.json");
+        try {
+            const adc = JSON.parse(readFileSync(adcPath, "utf8"));
+            // 2a. Pre-issued access token (rare, but valid for some service accounts)
+            if (adc.access_token)
+                return adc.access_token;
+            // 2b. Refresh-token flow (typical after `gcloud auth application-default login`)
+            if (adc.refresh_token && adc.client_id && adc.client_secret) {
+                return await this.exchangeRefreshToken(adc.client_id, adc.client_secret, adc.refresh_token);
+            }
+        }
+        catch (err) {
+            if (err instanceof SyntaxError) {
+                console.warn(`Vertex AI: ADC file has invalid JSON: ${adcPath}`);
+            }
+            // ENOENT or other read errors — continue to CLI fallback
+        }
+        // 4. gcloud CLI fallback
+        return this.tokenFromGcloudCli();
+    }
+    /**
+     * Exchange a refresh token for a short-lived access token via Google OAuth2.
+     *
+     * @param clientId     - OAuth2 client ID from the ADC file.
+     * @param clientSecret - OAuth2 client secret from the ADC file.
+     * @param refreshToken - Refresh token from the ADC file.
+     */
+    async exchangeRefreshToken(clientId, clientSecret, refreshToken) {
+        const body = new URLSearchParams({
+            client_id: clientId,
+            client_secret: clientSecret,
+            refresh_token: refreshToken,
+            grant_type: "refresh_token",
+        });
+        try {
+            const res = await fetch("https://oauth2.googleapis.com/token", {
+                method: "POST",
+                headers: { "Content-Type": "application/x-www-form-urlencoded" },
+                body: body.toString(),
+            });
+            if (!res.ok)
+                return undefined;
+            const data = (await res.json());
+            return data.access_token;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Obtain an access token by calling `gcloud auth print-access-token`.
+     * Returns `undefined` when the CLI is not installed or the command fails.
+     */
+    tokenFromGcloudCli() {
+        try {
+            const out = execSync("gcloud auth print-access-token", {
+                stdio: ["pipe", "pipe", "pipe"],
+                timeout: 8_000,
+            })
+                .toString()
+                .trim();
+            return out.length > 0 ? out : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Private: gcloud CLI model discovery
+    // -------------------------------------------------------------------------
+    /**
+     * Discover models by executing `gcloud ai models list` and parsing JSON output.
+     *
+     * @param projectId - GCP project ID passed as `--project`.
+     * @param region    - GCP region passed as `--region`.
+     */
+    async discoverViaCli(projectId, region) {
+        try {
+            assertSafeShellArg(projectId, "projectId");
+            assertSafeShellArg(region, "region");
+            const raw = execFileSync("gcloud", ["ai", "models", "list", `--project=${projectId}`, `--region=${region}`, "--format=json"], { stdio: ["pipe", "pipe", "pipe"], timeout: 15_000 }).toString();
+            const models = JSON.parse(raw);
+            assertCleanPayload(models, "Vertex AI gcloud CLI");
+            if (!Array.isArray(models))
+                return [];
+            return models.map((m) => this.gcloudModelToCard(m, region, projectId));
+        }
+        catch (err) {
+            if (err instanceof SyntaxError) {
+                console.warn(`Vertex AI: gcloud CLI returned invalid JSON for region ${region}`);
+            }
+            return [];
+        }
+    }
+    /**
+     * Resolve a GCP project ID from the active `gcloud` configuration.
+     * Returns `undefined` when the CLI is unavailable or unconfigured.
+     */
+    resolveProjectFromCli() {
+        try {
+            const out = execSync("gcloud config get-value project", {
+                stdio: ["pipe", "pipe", "pipe"],
+                timeout: 5_000,
+            })
+                .toString()
+                .trim();
+            // gcloud prints "(unset)" when no project is configured
+            return out && out !== "(unset)" ? out : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Private: static fallback
+    // -------------------------------------------------------------------------
+    /**
+     * Return a curated list of well-known Vertex AI models (Feb 2026).
+     *
+     * Used when neither the REST API nor the gcloud CLI is accessible.
+     * All entries carry `source: "manual"` so consumers can distinguish them
+     * from live API data.
+     *
+     * @param region    - Propagated to each card's `region` field.
+     * @param projectId - Propagated to each card's `projectId` field (may be undefined).
+     */
+    staticFallback(region, projectId) {
+        const base = { provider: "vertex", originProvider: "google", region, projectId, source: "manual" };
+        const geminiChat = (id, name, ctx, out) => this.makeCard({ ...base, id, name, mode: "chat", capabilities: ["chat", "vision", "function_calling", "code", "nlu"], contextWindow: ctx, maxOutputTokens: out });
+        return [
+            geminiChat("gemini-2.5-pro-preview-05-06", "Gemini 2.5 Pro Preview", 1_048_576, 65_536),
+            geminiChat("gemini-2.5-flash-preview-04-17", "Gemini 2.5 Flash Preview", 1_048_576, 8_192),
+            geminiChat("gemini-2.0-flash", "Gemini 2.0 Flash", 1_048_576, 8_192),
+            this.makeCard({ ...base, id: "text-embedding-005", name: "Text Embedding 005", mode: "embedding", capabilities: ["embedding"], contextWindow: 2_048, maxOutputTokens: 0 }),
+            this.makeCard({ ...base, id: "imagen-3.0-generate-002", name: "Imagen 3.0", mode: "image", capabilities: ["image_generation"], contextWindow: 0, maxOutputTokens: 0 }),
+        ];
+    }
+    // -------------------------------------------------------------------------
+    // Private: model → ModelCard converters
+    // -------------------------------------------------------------------------
+    /**
+     * Convert a Vertex AI REST API model object to a {@link ModelCard}.
+     *
+     * The `name` field is a full resource path such as
+     * `publishers/google/models/gemini-2.5-pro`; the prefix is stripped to
+     * obtain the bare model ID used in API calls.
+     *
+     * @param model     - Raw Vertex API model entry.
+     * @param region    - Region the model was fetched from.
+     * @param projectId - GCP project ID.
+     */
+    toModelCard(model, region, projectId) {
+        const id = model.name.replace(/^.*\/models\//, "");
+        const actions = model.supportedActions ?? [];
+        return this.makeCard({
+            id,
+            name: model.displayName ?? id,
+            provider: "vertex",
+            originProvider: "google",
+            mode: this.inferMode(id, actions),
+            capabilities: this.inferCapabilities(id, actions),
+            contextWindow: 0,
+            maxOutputTokens: 0,
+            region,
+            projectId,
+            source: "api",
+        });
+    }
+    /**
+     * Convert a `gcloud ai models list` JSON entry to a {@link ModelCard}.
+     *
+     * gcloud returns full resource names such as
+     * `projects/{p}/locations/{r}/models/{id}` — we take only the last segment.
+     *
+     * @param model     - Raw gcloud JSON model entry.
+     * @param region    - Region used for the gcloud query.
+     * @param projectId - GCP project ID.
+     */
+    gcloudModelToCard(model, region, projectId) {
+        const id = model.name.split("/").pop() ?? model.name;
+        return this.makeCard({
+            id,
+            name: model.displayName ?? id,
+            provider: "vertex",
+            originProvider: "google",
+            mode: this.inferMode(id, []),
+            capabilities: this.inferCapabilities(id, []),
+            contextWindow: 0,
+            maxOutputTokens: 0,
+            region,
+            projectId,
+            source: "manual",
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Private: capability / mode inference
+    // -------------------------------------------------------------------------
+    /**
+     * Determine the primary {@link ModelMode} from a model ID and its
+     * supported actions list.
+     *
+     * @param id      - Bare model ID.
+     * @param actions - `supportedActions` array from the API response.
+     */
+    inferMode(id, actions) {
+        const lower = id.toLowerCase();
+        if (actions.includes("embedContent") || lower.includes("embedding") || lower.includes("embed"))
+            return "embedding";
+        if (lower.includes("imagen") || lower.includes("image"))
+            return "image";
+        return "chat";
+    }
+    /**
+     * Infer capability flags from a model ID and its supported actions.
+     *
+     * Gemini pro/flash/ultra variants receive vision + function_calling because
+     * all modern Gemini editions support multimodal input and tool use.
+     *
+     * @param id      - Bare model ID.
+     * @param actions - `supportedActions` from the API response.
+     */
+    inferCapabilities(id, actions) {
+        const lower = id.toLowerCase();
+        if (actions.includes("embedContent") || lower.includes("embedding") || lower.includes("embed"))
+            return ["embedding"];
+        if (lower.includes("imagen") || lower.includes("image"))
+            return ["image_generation"];
+        if (lower.includes("gemini")) {
+            const caps = ["chat", "code", "nlu"];
+            if (lower.includes("pro") || lower.includes("flash") || lower.includes("ultra")) {
+                caps.push("vision", "function_calling");
+            }
+            return caps;
+        }
+        return ["chat"];
+    }
+}
+//# sourceMappingURL=vertex.js.map

package/dist/discovery/vertex.js.map

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

package/dist/discovery/zai.d.ts

@@ -0,0 +1,17 @@
+/**
+ * kosha-discovery — Z.AI provider discoverer.
+ *
+ * Z.AI exposes an OpenAI-compatible API surface.
+ * @module
+ */
+import type { OpenAICompatibleModel, ModelClassification } from "./openai-compatible.js";
+import { OpenAICompatibleDiscoverer } from "./openai-compatible.js";
+export declare class ZAIDiscoverer extends OpenAICompatibleDiscoverer {
+    readonly providerId = "zai";
+    readonly providerName = "Z.AI";
+    readonly baseUrl = "https://api.z.ai/api/paas/v4";
+    protected modelListEndpoints(): string[];
+    protected isRelevantModel(model: OpenAICompatibleModel): boolean;
+    protected classifyModel(model: OpenAICompatibleModel): ModelClassification;
+}
+//# sourceMappingURL=zai.d.ts.map

package/dist/discovery/zai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zai.d.ts","sourceRoot":"","sources":["../../src/discovery/zai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEpE,qBAAa,aAAc,SAAQ,0BAA0B;IAC5D,QAAQ,CAAC,UAAU,SAAS;IAC5B,QAAQ,CAAC,YAAY,UAAU;IAC/B,QAAQ,CAAC,OAAO,kCAAkC;IAElD,SAAS,CAAC,kBAAkB,IAAI,MAAM,EAAE;IAOxC,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO;IAIhE,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,qBAAqB,GAAG,mBAAmB;CA6B1E"}

package/dist/discovery/zai.js

@@ -0,0 +1,51 @@
+/**
+ * kosha-discovery — Z.AI provider discoverer.
+ *
+ * Z.AI exposes an OpenAI-compatible API surface.
+ * @module
+ */
+import { OpenAICompatibleDiscoverer } from "./openai-compatible.js";
+export class ZAIDiscoverer extends OpenAICompatibleDiscoverer {
+    providerId = "zai";
+    providerName = "Z.AI";
+    baseUrl = "https://api.z.ai/api/paas/v4";
+    modelListEndpoints() {
+        return [
+            `${this.baseUrl}/models`,
+            `${this.baseUrl}/v1/models`,
+        ];
+    }
+    isRelevantModel(model) {
+        return !model.id.startsWith("ft:");
+    }
+    classifyModel(model) {
+        const lower = model.id.toLowerCase();
+        if (this.looksLikeEmbedding(lower) || lower.includes("embedding")) {
+            return {
+                originProvider: "zai",
+                mode: "embedding",
+                capabilities: ["embedding"],
+                contextWindow: model.context_window,
+                maxOutputTokens: model.max_output_tokens,
+                maxInputTokens: model.max_input_tokens,
+                dimensions: model.output_vector_size,
+            };
+        }
+        const capabilities = ["chat", "function_calling"];
+        if (this.looksLikeVision(lower))
+            capabilities.push("vision");
+        if (this.looksLikeCode(lower))
+            capabilities.push("code");
+        if (lower.includes("reason") || lower.includes("thinking"))
+            capabilities.push("nlu");
+        return {
+            originProvider: "zai",
+            mode: "chat",
+            capabilities,
+            contextWindow: model.context_window,
+            maxOutputTokens: model.max_output_tokens,
+            maxInputTokens: model.max_input_tokens,
+        };
+    }
+}
+//# sourceMappingURL=zai.js.map

package/dist/discovery/zai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zai.js","sourceRoot":"","sources":["../../src/discovery/zai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEpE,MAAM,OAAO,aAAc,SAAQ,0BAA0B;IACnD,UAAU,GAAG,KAAK,CAAC;IACnB,YAAY,GAAG,MAAM,CAAC;IACtB,OAAO,GAAG,8BAA8B,CAAC;IAExC,kBAAkB;QAC3B,OAAO;YACN,GAAG,IAAI,CAAC,OAAO,SAAS;YACxB,GAAG,IAAI,CAAC,OAAO,YAAY;SAC3B,CAAC;IACH,CAAC;IAES,eAAe,CAAC,KAA4B;QACrD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAES,aAAa,CAAC,KAA4B;QACnD,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,IAAI,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACnE,OAAO;gBACN,cAAc,EAAE,KAAK;gBACrB,IAAI,EAAE,WAAW;gBACjB,YAAY,EAAE,CAAC,WAAW,CAAC;gBAC3B,aAAa,EAAE,KAAK,CAAC,cAAc;gBACnC,eAAe,EAAE,KAAK,CAAC,iBAAiB;gBACxC,cAAc,EAAE,KAAK,CAAC,gBAAgB;gBACtC,UAAU,EAAE,KAAK,CAAC,kBAAkB;aACpC,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YAAE,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;YAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAErF,OAAO;YACN,cAAc,EAAE,KAAK;YACrB,IAAI,EAAE,MAAM;YACZ,YAAY;YACZ,aAAa,EAAE,KAAK,CAAC,cAAc;YACnC,eAAe,EAAE,KAAK,CAAC,iBAAiB;YACxC,cAAc,EAAE,KAAK,CAAC,gBAAgB;SACtC,CAAC;IACH,CAAC;CACD"}

package/dist/discovery-contract.d.ts

@@ -0,0 +1,186 @@
+/**
+ * kosha-discovery — Versioned discovery contract helpers.
+ *
+ * I keep the v1 schema, trusted capability taxonomy, and lightweight
+ * heuristics here so the registry can stay focused on orchestration.
+ * @module
+ */
+import type { ModelCard, ModelPricing } from "./types.js";
+import type { ProviderDescriptor } from "./provider-catalog.js";
+/** Stable schema version exposed to Chitragupta and other daemon consumers. */
+export declare const DISCOVERY_SCHEMA_VERSION = 1;
+/** Trusted capability taxonomy surfaced by the v1 discovery contract. */
+export type TrustedCapability = "chat" | "function_calling" | "embeddings" | "vision" | "rerank" | "structured_output" | "streaming" | "long_context" | "local_exec" | "code_generation" | "reasoning" | "low_latency" | "cheap_inference";
+/** Normalized role hints exposed by the v1 schema. */
+export interface DiscoveryRoleDefinition {
+    /** Stable role identifier. */
+    roleId: string;
+    /** Capabilities required for the role to be viable. */
+    requiredCapabilities: TrustedCapability[];
+    /** Capabilities that improve suitability but are not mandatory. */
+    preferredCapabilities: TrustedCapability[];
+    /** Short human-readable hint for consumers. */
+    suitabilityHint: string;
+}
+/** Credential prompt shape exposed in the v1 schema. */
+export interface DiscoveryCredentialPrompt {
+    providerId: string;
+    providerName: string;
+    required: boolean;
+    envVars: string[];
+    message: string;
+}
+/** Stable provider shape emitted by the v1 discovery snapshot. */
+export interface DiscoveryProviderV1 {
+    providerId: string;
+    canonicalProviderId: string;
+    aliases: string[];
+    name: string;
+    origin: string;
+    isLocal: boolean;
+    transport: string;
+    authenticated: boolean;
+    credentialSource: string | null;
+    credentialsPresent: boolean;
+    credentialsRequired: boolean;
+    credentialEnvVars: string[];
+    modelCount: number;
+    lastRefreshed: number | null;
+    baseUrl: string;
+}
+/** Stable model shape emitted by the v1 discovery snapshot. */
+export interface DiscoveryModelV1 {
+    key: string;
+    modelId: string;
+    name: string;
+    providerId: string;
+    canonicalProviderId: string;
+    originProviderId: string;
+    mode: string;
+    capabilities: TrustedCapability[];
+    rawCapabilities: string[];
+    contextWindow: number | null;
+    maxOutputTokens: number | null;
+    pricing: ModelPricing | null;
+    dimensions: number | null;
+    maxInputTokens: number | null;
+    discoveredAt: number;
+    source: string;
+    aliases: string[];
+    region: string | null;
+    projectId: string | null;
+    runtimeFamily: string | null;
+    tokenizerFamily: string | null;
+    quantization: string | null;
+    memoryFootprintBytes: number | null;
+    computeTarget: string | null;
+    supportsStructuredOutput: boolean | null;
+    supportsStreaming: boolean | null;
+}
+/** Normalized provider health exposed by the v1 discovery snapshot. */
+export interface DiscoveryHealthRecord {
+    providerId: string;
+    state: "healthy" | "degraded" | "down" | "auth_error" | "throttled" | "unknown";
+    failureCount: number;
+    lastError: string | null;
+    lastSuccessAt: number | null;
+    lastFailureAt: number | null;
+    latencyClass: "low" | "medium" | "high" | "timeout" | "unknown";
+    timeoutRate: number;
+    rateLimitState: "ok" | "throttled" | "unknown";
+    circuitState: "closed" | "open" | "half-open";
+}
+/** Full v1 discovery snapshot. */
+export interface DiscoverySnapshotV1 {
+    schemaVersion: number;
+    discoveredAt: number | null;
+    cursor: string;
+    providers: DiscoveryProviderV1[];
+    models: DiscoveryModelV1[];
+    roles: DiscoveryRoleDefinition[];
+    health: DiscoveryHealthRecord[];
+    credentialPrompts: DiscoveryCredentialPrompt[];
+}
+/** Entity kinds that can appear in a delta stream. */
+export type DiscoveryChangeEntity = "provider" | "model" | "health" | "credential_prompt";
+/** Individual change item inside a delta batch. */
+export interface DiscoveryChangeV1 {
+    entity: DiscoveryChangeEntity;
+    action: "upsert" | "remove";
+    key: string;
+    value: DiscoveryProviderV1 | DiscoveryModelV1 | DiscoveryHealthRecord | DiscoveryCredentialPrompt | null;
+}
+/** Aggregate delta response used by polling and live watch. */
+export interface DiscoveryDeltaV1 {
+    schemaVersion: number;
+    sinceCursor: string | null;
+    cursor: string;
+    changedAt: number | null;
+    resetRequired: boolean;
+    changes: DiscoveryChangeV1[];
+}
+/** Stable cheapest-candidate match used by the v1 debug/library surface. */
+export interface DiscoveryCheapestCandidateV1 {
+    modelId: string;
+    providerId: string;
+    canonicalProviderId: string;
+    score: number | null;
+    priceMetric: string;
+    capabilities: TrustedCapability[];
+}
+/** Cheapest-candidate response for a normalized query. */
+export interface DiscoveryCheapestResultV1 {
+    schemaVersion: number;
+    query: Record<string, string | number | boolean | null>;
+    candidates: number;
+    pricedCandidates: number;
+    skippedNoPricing: number;
+    priceMetric: string;
+    matches: DiscoveryCheapestCandidateV1[];
+}
+/** Binding query used by the additive v1 selection-hints surface. */
+export interface DiscoveryBindingQuery {
+    role?: string;
+    capability?: string;
+    provider?: string;
+    originProvider?: string;
+    mode?: string;
+    limit?: number;
+    priceMetric?: string;
+    preferLocalProviders?: boolean;
+    allowCrossProvider?: boolean;
+}
+/** Query-scoped discovery hints used to build Chitragupta bindings. */
+export interface DiscoveryBindingHintsV1 {
+    schemaVersion: number;
+    query: Record<string, string | number | boolean | null>;
+    selectedModelId: string | null;
+    selectedProviderId: string | null;
+    candidateModelIds: string[];
+    preferredModelIds: string[];
+    preferredProviderIds: string[];
+    preferLocalProviders: boolean;
+    allowCrossProvider: boolean;
+}
+/** Stable role definitions shipped with the v1 schema. */
+export declare const DISCOVERY_ROLE_DEFINITIONS: readonly DiscoveryRoleDefinition[];
+/**
+ * Build a stable composite key for a model route.
+ */
+export declare function makeModelKey(model: Pick<ModelCard, "provider" | "id">, descriptor: ProviderDescriptor): string;
+/**
+ * Return the raw capability list that a discoverer originally emitted.
+ */
+export declare function rawCapabilitiesForModel(model: ModelCard): string[];
+/**
+ * Normalize free-form model metadata into the trusted capability taxonomy.
+ *
+ * I keep the heuristics intentionally conservative. When I cannot infer a
+ * capability with reasonable confidence, I leave it out of the trusted set.
+ */
+export declare function trustedCapabilitiesForModel(model: ModelCard, descriptor: ProviderDescriptor): TrustedCapability[];
+/**
+ * Return stable role definitions for the v1 snapshot.
+ */
+export declare function discoveryRoles(): DiscoveryRoleDefinition[];
+//# sourceMappingURL=discovery-contract.d.ts.map

package/dist/discovery-contract.d.ts.map

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