@sriinnu/kosha-discovery 0.5.0

package/dist/discovery-contract.js

@@ -0,0 +1,115 @@
+/**
+ * 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
+ */
+/** Stable schema version exposed to Chitragupta and other daemon consumers. */
+export const DISCOVERY_SCHEMA_VERSION = 1;
+/** Stable role definitions shipped with the v1 schema. */
+export const DISCOVERY_ROLE_DEFINITIONS = [
+    {
+        roleId: "chat",
+        requiredCapabilities: ["chat"],
+        preferredCapabilities: ["streaming"],
+        suitabilityHint: "General conversational generation.",
+    },
+    {
+        roleId: "tool_use",
+        requiredCapabilities: ["chat", "function_calling"],
+        preferredCapabilities: ["structured_output"],
+        suitabilityHint: "Best for agent loops and tool invocation.",
+    },
+    {
+        roleId: "embeddings",
+        requiredCapabilities: ["embeddings"],
+        preferredCapabilities: ["cheap_inference", "low_latency"],
+        suitabilityHint: "Vectorization and semantic retrieval.",
+    },
+    {
+        roleId: "vision",
+        requiredCapabilities: ["chat", "vision"],
+        preferredCapabilities: ["streaming"],
+        suitabilityHint: "Multimodal prompts with image understanding.",
+    },
+    {
+        roleId: "rerank",
+        requiredCapabilities: ["rerank"],
+        preferredCapabilities: ["low_latency"],
+        suitabilityHint: "Document or passage reranking pipelines.",
+    },
+    {
+        roleId: "local_exec",
+        requiredCapabilities: ["local_exec"],
+        preferredCapabilities: ["low_latency", "cheap_inference"],
+        suitabilityHint: "Local-first inference on the current machine.",
+    },
+];
+const CODE_PATTERNS = ["code", "coder", "codellama", "codestral", "starcoder"];
+const REASONING_PATTERNS = ["reason", "deep-research", "deep_research", "o1", "o3", "o4"];
+const LOW_LATENCY_PROVIDER_IDS = new Set(["groq", "cerebras", "ollama", "llama.cpp"]);
+/**
+ * Build a stable composite key for a model route.
+ */
+export function makeModelKey(model, descriptor) {
+    return `${descriptor.canonicalProviderId}:${model.id}`;
+}
+/**
+ * Return the raw capability list that a discoverer originally emitted.
+ */
+export function rawCapabilitiesForModel(model) {
+    return [...new Set((model.rawCapabilities ?? model.capabilities).map((capability) => capability.trim()))].sort();
+}
+/**
+ * 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 function trustedCapabilitiesForModel(model, descriptor) {
+    const caps = new Set();
+    const rawCaps = rawCapabilitiesForModel(model).map((capability) => capability.toLowerCase().replace(/[\s-]+/g, "_"));
+    const lowerId = model.id.toLowerCase();
+    if (model.mode === "chat" || rawCaps.includes("chat"))
+        caps.add("chat");
+    if (model.mode === "embedding" || rawCaps.includes("embedding") || rawCaps.includes("embeddings"))
+        caps.add("embeddings");
+    if (rawCaps.includes("function_calling"))
+        caps.add("function_calling");
+    if (rawCaps.includes("vision"))
+        caps.add("vision");
+    if (rawCaps.includes("rerank") || lowerId.includes("rerank"))
+        caps.add("rerank");
+    if (descriptor.isLocal)
+        caps.add("local_exec");
+    // Chat-capable providers almost universally expose streaming, so I surface it
+    // when the model is chat-oriented or the local runtime explicitly advertises it.
+    if (model.localRuntime?.supportsStreaming === true || model.mode === "chat")
+        caps.add("streaming");
+    if (model.localRuntime?.supportsStructuredOutput === true)
+        caps.add("structured_output");
+    if ((model.contextWindow ?? 0) >= 100_000)
+        caps.add("long_context");
+    if (rawCaps.includes("code") || CODE_PATTERNS.some((pattern) => lowerId.includes(pattern)))
+        caps.add("code_generation");
+    if (rawCaps.includes("nlu") || REASONING_PATTERNS.some((pattern) => lowerId.includes(pattern)))
+        caps.add("reasoning");
+    if (LOW_LATENCY_PROVIDER_IDS.has(descriptor.canonicalProviderId) || descriptor.isLocal)
+        caps.add("low_latency");
+    if (descriptor.isLocal || isCheapPricing(model.pricing))
+        caps.add("cheap_inference");
+    return [...caps].sort();
+}
+/**
+ * Return stable role definitions for the v1 snapshot.
+ */
+export function discoveryRoles() {
+    return [...DISCOVERY_ROLE_DEFINITIONS];
+}
+function isCheapPricing(pricing) {
+    if (!pricing)
+        return false;
+    return pricing.inputPerMillion <= 1 && pricing.outputPerMillion <= 4;
+}
+//# sourceMappingURL=discovery-contract.js.map

package/dist/discovery-contract.js.map

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

package/dist/discovery-routes.d.ts

@@ -0,0 +1,14 @@
+/**
+ * kosha-discovery — Additive v1 discovery HTTP routes.
+ *
+ * I keep the daemon-oriented routes separate from the legacy REST surface so
+ * the old API can stay stable while Chitragupta moves to the new contract.
+ * @module
+ */
+import type { Hono } from "hono";
+import type { ModelRegistry } from "./registry.js";
+/**
+ * Register additive discovery-plane routes on the existing Hono app.
+ */
+export declare function registerDiscoveryRoutes(app: Hono, registry: ModelRegistry): void;
+//# sourceMappingURL=discovery-routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-routes.d.ts","sourceRoot":"","sources":["../src/discovery-routes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CA6BhF"}

package/dist/discovery-routes.js

@@ -0,0 +1,98 @@
+/**
+ * kosha-discovery — Additive v1 discovery HTTP routes.
+ *
+ * I keep the daemon-oriented routes separate from the legacy REST surface so
+ * the old API can stay stable while Chitragupta moves to the new contract.
+ * @module
+ */
+/**
+ * Register additive discovery-plane routes on the existing Hono app.
+ */
+export function registerDiscoveryRoutes(app, registry) {
+    app.get("/api/discovery", (ctx) => {
+        return ctx.json(registry.discoverySnapshot());
+    });
+    app.get("/api/discovery/delta", (ctx) => {
+        const sinceCursor = ctx.req.query("sinceCursor") ?? ctx.req.query("changedSince") ?? null;
+        return ctx.json(registry.discoveryDelta({ sinceCursor }));
+    });
+    app.get("/api/discovery/cheapest", (ctx) => {
+        return ctx.json(readBindingQuery(registry, ctx.req.query.bind(ctx.req)));
+    });
+    app.get("/api/discovery/binding", (ctx) => {
+        return ctx.json(registry.executionBindingHints(readBindingQueryInput(ctx.req.query.bind(ctx.req))));
+    });
+    app.get("/api/discovery/watch", (ctx) => {
+        const sinceCursor = ctx.req.query("sinceCursor") ?? ctx.req.query("changedSince") ?? null;
+        const stream = streamDiscoveryEvents(registry, sinceCursor, ctx.req.raw.signal);
+        return new Response(stream, {
+            headers: {
+                "content-type": "text/event-stream",
+                "cache-control": "no-cache, no-transform",
+                connection: "keep-alive",
+            },
+        });
+    });
+}
+function readBindingQuery(registry, query) {
+    return registry.cheapestCandidates(readBindingQueryInput(query));
+}
+function readBindingQueryInput(query) {
+    return {
+        role: query("role") ?? undefined,
+        capability: query("capability") ?? undefined,
+        provider: query("provider") ?? undefined,
+        originProvider: query("originProvider") ?? undefined,
+        mode: query("mode") ?? undefined,
+        limit: parseNumber(query("limit")),
+        priceMetric: query("priceMetric") ?? undefined,
+        preferLocalProviders: parseBoolean(query("preferLocalProviders")),
+        allowCrossProvider: parseBoolean(query("allowCrossProvider")),
+    };
+}
+function parseBoolean(value) {
+    if (value === undefined)
+        return undefined;
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    return undefined;
+}
+function parseNumber(value) {
+    if (!value)
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function streamDiscoveryEvents(registry, sinceCursor, signal) {
+    const encoder = new TextEncoder();
+    const iterator = registry.watchDiscovery({ sinceCursor });
+    return new ReadableStream({
+        async start(controller) {
+            const abort = async () => {
+                await iterator.return?.();
+                controller.close();
+            };
+            signal.addEventListener("abort", abort, { once: true });
+            try {
+                for await (const delta of iterator) {
+                    const payload = `event: delta\ndata: ${JSON.stringify(delta)}\n\n`;
+                    controller.enqueue(encoder.encode(payload));
+                }
+            }
+            catch (error) {
+                const payload = `event: error\ndata: ${JSON.stringify({ message: error instanceof Error ? error.message : String(error) })}\n\n`;
+                controller.enqueue(encoder.encode(payload));
+                controller.close();
+            }
+            finally {
+                signal.removeEventListener("abort", abort);
+            }
+        },
+        async cancel() {
+            await iterator.return?.();
+        },
+    });
+}
+//# sourceMappingURL=discovery-routes.js.map

package/dist/discovery-routes.js.map

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

package/dist/enrichment/index.d.ts

@@ -0,0 +1,2 @@
+export { LiteLLMEnricher } from "./litellm.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/enrichment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enrichment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/enrichment/index.js

@@ -0,0 +1,2 @@
+export { LiteLLMEnricher } from "./litellm.js";
+//# sourceMappingURL=index.js.map

package/dist/enrichment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/enrichment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/enrichment/litellm.d.ts

@@ -0,0 +1,52 @@
+/**
+ * kosha-discovery — LiteLLM community data enrichment.
+ *
+ * Fetches the community-maintained litellm model catalogue from GitHub
+ * and uses it to fill in pricing, context window sizes, and capability
+ * flags on already-discovered {@link ModelCard} objects.
+ * @module
+ */
+import type { Enricher, ModelCard } from "../types.js";
+/**
+ * Enriches ModelCard data with pricing, context-window sizes, and capability
+ * flags sourced from the litellm community-maintained model catalogue.
+ *
+ * @see https://github.com/BerriAI/litellm
+ */
+export declare class LiteLLMEnricher implements Enricher {
+    private data;
+    private readonly url;
+    /** Fetch and cache the litellm pricing JSON. Safe to call multiple times. */
+    load(): Promise<void>;
+    /**
+     * Enrich an array of ModelCards with litellm data.
+     *
+     * - Only fills in **missing** fields — never overwrites API-sourced data.
+     * - Returns new ModelCard objects (immutable pattern).
+     * - Models not found in litellm are returned unchanged.
+     */
+    enrich(models: ModelCard[]): Promise<ModelCard[]>;
+    private enrichOne;
+    /**
+     * Look up a model in the litellm pricing catalogue using a tiered set of
+     * key strategies. Later strategies use `originProvider` to handle models
+     * whose IDs are namespaced differently by the serving layer (e.g. a Bedrock
+     * model whose `id` is `"anthropic.claude-opus-4-6-…"` but whose
+     * `originProvider` is `"anthropic"`).
+     *
+     * Lookup order:
+     *   1. Exact `id` match
+     *   2. `{provider}/{id}` format
+     *   3. `{originProvider}/{id}` (when originProvider differs from provider)
+     *   4. `{originProvider}/{normalizedId}` — strips prefix/date suffixes
+     *   5. Lowercase exact `id` match
+     *   6. Lowercase `{provider}/{id}`
+     *   7. Lowercase `{originProvider}/{normalizedId}`
+     */
+    private lookupModel;
+    /** Convert litellm per-token costs to per-million pricing. */
+    private extractPricing;
+    /** Map litellm mode strings to our ModelMode type. */
+    private mapMode;
+}
+//# sourceMappingURL=litellm.d.ts.map

package/dist/enrichment/litellm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"litellm.d.ts","sourceRoot":"","sources":["../../src/enrichment/litellm.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAA2B,MAAM,aAAa,CAAC;AA4BhF;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC/C,OAAO,CAAC,IAAI,CAAkD;IAC9D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAC2E;IAE/F,6EAA6E;IACvE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IASvD,OAAO,CAAC,SAAS;IAiEjB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,WAAW;IA6CnB,8DAA8D;IAC9D,OAAO,CAAC,cAAc;IAoBtB,sDAAsD;IACtD,OAAO,CAAC,OAAO;CAkBf"}

package/dist/enrichment/litellm.js

@@ -0,0 +1,205 @@
+/**
+ * kosha-discovery — LiteLLM community data enrichment.
+ *
+ * Fetches the community-maintained litellm model catalogue from GitHub
+ * and uses it to fill in pricing, context window sizes, and capability
+ * flags on already-discovered {@link ModelCard} objects.
+ * @module
+ */
+import { normalizeModelId } from "../normalize.js";
+import { assertCleanPayload } from "../security.js";
+/**
+ * Multiplier to convert litellm's per-token costs into our standard
+ * per-million-token pricing.  litellm stores costs as cost-per-single-token,
+ * so we multiply by 1 000 000 to get the per-million figure.
+ */
+const PER_MILLION = 1_000_000;
+/**
+ * Enriches ModelCard data with pricing, context-window sizes, and capability
+ * flags sourced from the litellm community-maintained model catalogue.
+ *
+ * @see https://github.com/BerriAI/litellm
+ */
+export class LiteLLMEnricher {
+    data = null;
+    url = "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json";
+    /** Fetch and cache the litellm pricing JSON. Safe to call multiple times. */
+    async load() {
+        if (this.data)
+            return;
+        const response = await fetch(this.url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch litellm data: ${response.status} ${response.statusText}`);
+        }
+        const raw = (await response.json());
+        assertCleanPayload(raw, "litellm");
+        this.data = raw;
+    }
+    /**
+     * Enrich an array of ModelCards with litellm data.
+     *
+     * - Only fills in **missing** fields — never overwrites API-sourced data.
+     * - Returns new ModelCard objects (immutable pattern).
+     * - Models not found in litellm are returned unchanged.
+     */
+    async enrich(models) {
+        await this.load();
+        return models.map((model) => this.enrichOne(model));
+    }
+    // ---------------------------------------------------------------------------
+    // Private
+    // ---------------------------------------------------------------------------
+    enrichOne(model) {
+        const entry = this.lookupModel(model);
+        if (!entry)
+            return { ...model };
+        const enriched = { ...model };
+        // Pricing — only when the model has no pricing yet
+        if (!enriched.pricing) {
+            const pricing = this.extractPricing(entry);
+            if (pricing) {
+                enriched.pricing = pricing;
+            }
+        }
+        // Context window — only when unset (0)
+        if (enriched.contextWindow === 0 && entry.max_input_tokens) {
+            enriched.contextWindow = entry.max_input_tokens;
+        }
+        // Max output tokens — only when unset (0)
+        if (enriched.maxOutputTokens === 0) {
+            if (entry.max_output_tokens) {
+                enriched.maxOutputTokens = entry.max_output_tokens;
+            }
+            else if (entry.max_tokens) {
+                enriched.maxOutputTokens = entry.max_tokens;
+            }
+        }
+        // Max input tokens — only when missing
+        if (enriched.maxInputTokens === undefined && entry.max_input_tokens) {
+            enriched.maxInputTokens = entry.max_input_tokens;
+        }
+        // Embedding dimensions — only when missing
+        if (enriched.dimensions === undefined && entry.output_vector_size) {
+            enriched.dimensions = entry.output_vector_size;
+        }
+        // Mode — only when we have litellm mode info and the current mode might be wrong
+        if (entry.mode) {
+            const litellmMode = this.mapMode(entry.mode);
+            if (litellmMode && enriched.mode !== litellmMode) {
+                // Only override if the model currently has a generic "chat" mode
+                // and litellm has more specific info (e.g. "embedding")
+                if (enriched.mode === "chat" && litellmMode !== "chat") {
+                    enriched.mode = litellmMode;
+                }
+            }
+        }
+        // Capabilities — add missing ones from litellm flags
+        enriched.capabilities = [...enriched.capabilities];
+        if (entry.supports_vision && !enriched.capabilities.includes("vision")) {
+            enriched.capabilities.push("vision");
+        }
+        if (entry.supports_function_calling && !enriched.capabilities.includes("function_calling")) {
+            enriched.capabilities.push("function_calling");
+        }
+        if (entry.supports_prompt_caching && !enriched.capabilities.includes("prompt_caching")) {
+            enriched.capabilities.push("prompt_caching");
+        }
+        return enriched;
+    }
+    /**
+     * Look up a model in the litellm pricing catalogue using a tiered set of
+     * key strategies. Later strategies use `originProvider` to handle models
+     * whose IDs are namespaced differently by the serving layer (e.g. a Bedrock
+     * model whose `id` is `"anthropic.claude-opus-4-6-…"` but whose
+     * `originProvider` is `"anthropic"`).
+     *
+     * Lookup order:
+     *   1. Exact `id` match
+     *   2. `{provider}/{id}` format
+     *   3. `{originProvider}/{id}` (when originProvider differs from provider)
+     *   4. `{originProvider}/{normalizedId}` — strips prefix/date suffixes
+     *   5. Lowercase exact `id` match
+     *   6. Lowercase `{provider}/{id}`
+     *   7. Lowercase `{originProvider}/{normalizedId}`
+     */
+    lookupModel(model) {
+        if (!this.data)
+            return undefined;
+        const { id, provider, originProvider } = model;
+        // 1. Exact match
+        if (this.data[id])
+            return this.data[id];
+        // 2. provider/id format
+        const prefixed = `${provider}/${id}`;
+        if (this.data[prefixed])
+            return this.data[prefixed];
+        // 3. originProvider/id — useful when the serving layer prefixes IDs
+        //    differently (e.g. bedrock → anthropic).
+        if (originProvider && originProvider !== provider) {
+            const originPrefixed = `${originProvider}/${id}`;
+            if (this.data[originPrefixed])
+                return this.data[originPrefixed];
+        }
+        // 4. originProvider/normalizedId — strips date suffixes and provider
+        //    namespace segments so "anthropic.claude-opus-4-6-20250514-v1:0"
+        //    resolves to "anthropic/claude-opus-4-6".
+        const normalizedId = normalizeModelId(id);
+        if (originProvider) {
+            const originNormPrefixed = `${originProvider}/${normalizedId}`;
+            if (this.data[originNormPrefixed])
+                return this.data[originNormPrefixed];
+        }
+        // 5. Lowercase exact match
+        const lower = id.toLowerCase();
+        if (this.data[lower])
+            return this.data[lower];
+        // 6. Lowercase provider/id
+        const lowerPrefixed = `${provider}/${lower}`;
+        if (this.data[lowerPrefixed])
+            return this.data[lowerPrefixed];
+        // 7. Lowercase originProvider/normalizedId
+        if (originProvider) {
+            const lowerOriginNorm = `${originProvider}/${normalizedId.toLowerCase()}`;
+            if (this.data[lowerOriginNorm])
+                return this.data[lowerOriginNorm];
+        }
+        return undefined;
+    }
+    /** Convert litellm per-token costs to per-million pricing. */
+    extractPricing(entry) {
+        if (entry.input_cost_per_token === undefined && entry.output_cost_per_token === undefined) {
+            return undefined;
+        }
+        const pricing = {
+            inputPerMillion: (entry.input_cost_per_token ?? 0) * PER_MILLION,
+            outputPerMillion: (entry.output_cost_per_token ?? 0) * PER_MILLION,
+        };
+        if (entry.cache_read_input_token_cost !== undefined) {
+            pricing.cacheReadPerMillion = entry.cache_read_input_token_cost * PER_MILLION;
+        }
+        if (entry.cache_creation_input_token_cost !== undefined) {
+            pricing.cacheWritePerMillion = entry.cache_creation_input_token_cost * PER_MILLION;
+        }
+        return pricing;
+    }
+    /** Map litellm mode strings to our ModelMode type. */
+    mapMode(mode) {
+        switch (mode) {
+            case "chat":
+            case "completion":
+                return "chat";
+            case "embedding":
+                return "embedding";
+            case "image_generation":
+                return "image";
+            case "audio_transcription":
+            case "audio_speech":
+                return "audio";
+            case "moderation":
+                return "moderation";
+            default:
+                return undefined;
+        }
+    }
+}
+//# sourceMappingURL=litellm.js.map

package/dist/enrichment/litellm.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * kosha-discovery — Public API barrel export.
+ *
+ * Re-exports every public class, type, and factory function so that
+ * consumers can import from a single `"kosha-discovery"` entry point.
+ * @module
+ */
+export { ModelRegistry } from "./registry.js";
+export { AliasResolver, DEFAULT_ALIASES } from "./aliases.js";
+export { KoshaCache } from "./cache.js";
+export { DISCOVERY_SCHEMA_VERSION, discoveryRoles, makeModelKey, rawCapabilitiesForModel, trustedCapabilitiesForModel, } from "./discovery-contract.js";
+export type { DiscoveryBindingHintsV1, DiscoveryBindingQuery, DiscoveryChangeV1, DiscoveryCheapestCandidateV1, DiscoveryCheapestResultV1, DiscoveryCredentialPrompt, DiscoveryDeltaV1, DiscoveryHealthRecord, DiscoveryModelV1, DiscoveryProviderV1, DiscoveryRoleDefinition, DiscoverySnapshotV1, TrustedCapability, } from "./discovery-contract.js";
+export { extractModelVersion, extractOriginProvider, normalizeModelId } from "./normalize.js";
+export { getProviderDescriptor, isLocalProvider, listProviderDescriptors, normalizeProviderId, PROVIDER_CATALOG, } from "./provider-catalog.js";
+export type { ProviderDescriptor } from "./provider-catalog.js";
+export type { ComputeTarget, LocalRuntimeMetadata, ModelCard, ProviderInfo, ProviderRoleInfo, DiscoveryError, DiscoveryOptions, KoshaConfig, LatestDiscoveryOptions, LatestDiscoveryResult, ModelMode, ModelPricing, ModelRoleCard, RoleQueryOptions, CheapestModelOptions, CheapestModelMatch, CheapestModelResult, ProviderCredentialPrompt, PricingMetric, ModelRouteInfo, CapabilitySummary, CredentialResult, ProviderDiscoverer, Enricher, ProviderOrigin, ProviderTransport, } from "./types.js";
+/**
+ * Convenience factory: creates a ModelRegistry and runs discovery in one call.
+ *
+ * Automatically loads config from `~/.kosharc.json` and `kosha.config.json`
+ * (if they exist) before applying any explicit overrides.
+ *
+ * @example
+ * ```ts
+ * const kosha = await createKosha();
+ * const models = kosha.models({ mode: "chat" });
+ * ```
+ */
+export declare function createKosha(config?: import("./types.js").KoshaConfig): Promise<import("./registry.js").ModelRegistry>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EACN,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,2BAA2B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACX,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EACN,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,GAChB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EACX,aAAa,EACb,oBAAoB,EACpB,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,sBAAsB,EACtB,qBAAqB,EACrB,SAAS,EACT,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,iBAAiB,GACjB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,YAAY,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,eAAe,EAAE,aAAa,CAAC,CAM3H"}

package/dist/index.js

@@ -0,0 +1,33 @@
+/**
+ * kosha-discovery — Public API barrel export.
+ *
+ * Re-exports every public class, type, and factory function so that
+ * consumers can import from a single `"kosha-discovery"` entry point.
+ * @module
+ */
+export { ModelRegistry } from "./registry.js";
+export { AliasResolver, DEFAULT_ALIASES } from "./aliases.js";
+export { KoshaCache } from "./cache.js";
+export { DISCOVERY_SCHEMA_VERSION, discoveryRoles, makeModelKey, rawCapabilitiesForModel, trustedCapabilitiesForModel, } from "./discovery-contract.js";
+export { extractModelVersion, extractOriginProvider, normalizeModelId } from "./normalize.js";
+export { getProviderDescriptor, isLocalProvider, listProviderDescriptors, normalizeProviderId, PROVIDER_CATALOG, } from "./provider-catalog.js";
+/**
+ * Convenience factory: creates a ModelRegistry and runs discovery in one call.
+ *
+ * Automatically loads config from `~/.kosharc.json` and `kosha.config.json`
+ * (if they exist) before applying any explicit overrides.
+ *
+ * @example
+ * ```ts
+ * const kosha = await createKosha();
+ * const models = kosha.models({ mode: "chat" });
+ * ```
+ */
+export async function createKosha(config) {
+    const { ModelRegistry: Registry } = await import("./registry.js");
+    const merged = await Registry.loadConfigFile(config);
+    const registry = new Registry(merged);
+    await registry.discover();
+    return registry;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EACN,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,2BAA2B,GAC3B,MAAM,yBAAyB,CAAC;AAgBjC,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EACN,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,GAChB,MAAM,uBAAuB,CAAC;AA+B/B;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAyC;IAC1E,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC1B,OAAO,QAAQ,CAAC;AACjB,CAAC"}