@sriinnu/kosha-discovery 0.5.0

package/dist/normalize.d.ts

@@ -0,0 +1,64 @@
+/**
+ * kosha-discovery (कोश) — Model ID normalization utilities.
+ *
+ * Provides functions to extract the originating model creator from a
+ * compound model ID and to strip provider prefixes / version suffixes
+ * so that IDs from different serving layers can be compared uniformly.
+ * @module
+ */
+/**
+ * Extract the origin provider (model creator) from a model ID.
+ *
+ * The function first attempts to resolve a slash-separated namespace prefix
+ * (e.g. `"anthropic/claude-opus-4-6"` → `"anthropic"`).  When no prefix is
+ * present it falls back to a set of well-known ID patterns.
+ *
+ * @param modelId - Raw model identifier as returned by a provider API.
+ * @returns Canonical origin-provider slug, or `undefined` when the creator
+ *          cannot be determined.
+ *
+ * @example
+ * extractOriginProvider("anthropic/claude-opus-4-6") // "anthropic"
+ * extractOriginProvider("openai/gpt-4o")             // "openai"
+ * extractOriginProvider("google/gemini-2.5-pro")     // "google"
+ * extractOriginProvider("meta-llama/llama-3.3-70b")  // "meta"
+ * extractOriginProvider("claude-opus-4-6")           // "anthropic"
+ * extractOriginProvider("gpt-4o")                    // "openai"
+ * extractOriginProvider("gemini-2.5-pro")            // "google"
+ * extractOriginProvider("unknown-model")             // undefined
+ */
+export declare function extractOriginProvider(modelId: string): string | undefined;
+/**
+ * Normalise a model ID by stripping provider prefixes and version suffixes
+ * so that the same underlying model — served from different providers or
+ * released with different date stamps — yields the same base ID for
+ * deduplication or alias matching.
+ *
+ * Transformations applied (in order):
+ * 1. Strip everything up to and including the first `/` (provider prefix).
+ * 2. Strip calendar-version suffixes of the form `-YYYY-MM-DD` or `-YYYYMMDD`.
+ * 3. Strip the `:latest` tag used by Ollama.
+ *
+ * @param modelId - Raw model identifier (possibly namespaced / versioned).
+ * @returns Cleaned base model ID ready for deduplication comparisons.
+ *
+ * @example
+ * normalizeModelId("anthropic/claude-opus-4-6")          // "claude-opus-4-6"
+ * normalizeModelId("openai/gpt-4o-2024-11-20")           // "gpt-4o"
+ * normalizeModelId("meta-llama/llama-3.3-70b-instruct")  // "llama-3.3-70b-instruct"
+ * normalizeModelId("claude-opus-4-6")                    // "claude-opus-4-6"
+ * normalizeModelId("llama3.3:latest")                    // "llama3.3"
+ */
+export declare function normalizeModelId(modelId: string): string;
+/**
+ * Extract a best-effort model version hint from an identifier.
+ *
+ * Supported patterns (in priority order):
+ * 1. Provider suffix versions like `-v1:0` (Bedrock style)
+ * 2. Date suffixes `YYYY-MM-DD` or `YYYYMMDD`
+ * 3. Semantic fragments like `gpt-5.3-codex` -> `5.3`
+ *
+ * Returns `undefined` when no clear version-like segment is detected.
+ */
+export declare function extractModelVersion(modelId: string): string | undefined;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6CH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAqBzE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoBxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA+BvE"}

package/dist/normalize.js

@@ -0,0 +1,166 @@
+/**
+ * kosha-discovery (कोश) — Model ID normalization utilities.
+ *
+ * Provides functions to extract the originating model creator from a
+ * compound model ID and to strip provider prefixes / version suffixes
+ * so that IDs from different serving layers can be compared uniformly.
+ * @module
+ */
+/**
+ * Maps slash-separated namespace prefixes found in compound model IDs
+ * (e.g. "anthropic/claude-opus-4-6") to canonical origin-provider slugs.
+ *
+ * Providers that use their own namespace directly keep that name; those
+ * with unusual namespaces (e.g. "meta-llama") are mapped to a shorter slug.
+ */
+const PREFIX_TO_ORIGIN = {
+    anthropic: "anthropic",
+    openai: "openai",
+    google: "google",
+    "meta-llama": "meta",
+    meta: "meta",
+    mistralai: "mistral",
+    mistral: "mistral",
+    cohere: "cohere",
+    deepseek: "deepseek",
+    qwen: "qwen",
+    "01-ai": "01-ai",
+    "x-ai": "xai",
+    xai: "xai",
+    amazon: "amazon",
+    "amazon-nova": "amazon",
+};
+/**
+ * Ordered list of [regex, originProvider] pairs for models whose IDs
+ * do not contain a slash prefix but still have a recognisable pattern.
+ * Evaluated in order; the first match wins.
+ */
+const PATTERN_TO_ORIGIN = [
+    [/^claude-/i, "anthropic"],
+    [/^gpt-|^o[1-9](?:-|$)|^chatgpt-/i, "openai"],
+    [/^dall-e/i, "openai"],
+    [/^whisper|^tts-/i, "openai"],
+    [/^gemini-/i, "google"],
+    [/^llama/i, "meta"],
+    [/^mistral|^codestral|^pixtral/i, "mistral"],
+    [/^command-/i, "cohere"],
+    [/^deepseek/i, "deepseek"],
+    [/^qwen/i, "qwen"],
+];
+/**
+ * Extract the origin provider (model creator) from a model ID.
+ *
+ * The function first attempts to resolve a slash-separated namespace prefix
+ * (e.g. `"anthropic/claude-opus-4-6"` → `"anthropic"`).  When no prefix is
+ * present it falls back to a set of well-known ID patterns.
+ *
+ * @param modelId - Raw model identifier as returned by a provider API.
+ * @returns Canonical origin-provider slug, or `undefined` when the creator
+ *          cannot be determined.
+ *
+ * @example
+ * extractOriginProvider("anthropic/claude-opus-4-6") // "anthropic"
+ * extractOriginProvider("openai/gpt-4o")             // "openai"
+ * extractOriginProvider("google/gemini-2.5-pro")     // "google"
+ * extractOriginProvider("meta-llama/llama-3.3-70b")  // "meta"
+ * extractOriginProvider("claude-opus-4-6")           // "anthropic"
+ * extractOriginProvider("gpt-4o")                    // "openai"
+ * extractOriginProvider("gemini-2.5-pro")            // "google"
+ * extractOriginProvider("unknown-model")             // undefined
+ */
+export function extractOriginProvider(modelId) {
+    if (!modelId)
+        return undefined;
+    // Check slash-separated prefix first.
+    const slashIdx = modelId.indexOf("/");
+    if (slashIdx !== -1) {
+        const prefix = modelId.slice(0, slashIdx).toLowerCase();
+        if (Object.prototype.hasOwnProperty.call(PREFIX_TO_ORIGIN, prefix)) {
+            return PREFIX_TO_ORIGIN[prefix];
+        }
+    }
+    // Fall back to known ID patterns (no prefix present).
+    const bare = slashIdx !== -1 ? modelId.slice(slashIdx + 1) : modelId;
+    for (const [pattern, origin] of PATTERN_TO_ORIGIN) {
+        if (pattern.test(bare)) {
+            return origin;
+        }
+    }
+    return undefined;
+}
+/**
+ * Normalise a model ID by stripping provider prefixes and version suffixes
+ * so that the same underlying model — served from different providers or
+ * released with different date stamps — yields the same base ID for
+ * deduplication or alias matching.
+ *
+ * Transformations applied (in order):
+ * 1. Strip everything up to and including the first `/` (provider prefix).
+ * 2. Strip calendar-version suffixes of the form `-YYYY-MM-DD` or `-YYYYMMDD`.
+ * 3. Strip the `:latest` tag used by Ollama.
+ *
+ * @param modelId - Raw model identifier (possibly namespaced / versioned).
+ * @returns Cleaned base model ID ready for deduplication comparisons.
+ *
+ * @example
+ * normalizeModelId("anthropic/claude-opus-4-6")          // "claude-opus-4-6"
+ * normalizeModelId("openai/gpt-4o-2024-11-20")           // "gpt-4o"
+ * normalizeModelId("meta-llama/llama-3.3-70b-instruct")  // "llama-3.3-70b-instruct"
+ * normalizeModelId("claude-opus-4-6")                    // "claude-opus-4-6"
+ * normalizeModelId("llama3.3:latest")                    // "llama3.3"
+ */
+export function normalizeModelId(modelId) {
+    if (!modelId)
+        return modelId;
+    // 1. Strip provider prefix (everything up to and including the first '/').
+    const slashIdx = modelId.indexOf("/");
+    let id = slashIdx !== -1 ? modelId.slice(slashIdx + 1) : modelId;
+    // 2a. Strip ISO-style date suffixes: -YYYY-MM-DD (e.g. -2024-11-20).
+    id = id.replace(/-\d{4}-\d{2}-\d{2}$/, "");
+    // 2b. Strip compact date suffixes: -YYYYMMDD (e.g. -20241120).
+    id = id.replace(/-\d{8}$/, "");
+    // 3. Strip Ollama :latest (and any other colon-tag).
+    const colonIdx = id.indexOf(":");
+    if (colonIdx !== -1) {
+        id = id.slice(0, colonIdx);
+    }
+    return id;
+}
+/**
+ * Extract a best-effort model version hint from an identifier.
+ *
+ * Supported patterns (in priority order):
+ * 1. Provider suffix versions like `-v1:0` (Bedrock style)
+ * 2. Date suffixes `YYYY-MM-DD` or `YYYYMMDD`
+ * 3. Semantic fragments like `gpt-5.3-codex` -> `5.3`
+ *
+ * Returns `undefined` when no clear version-like segment is detected.
+ */
+export function extractModelVersion(modelId) {
+    if (!modelId)
+        return undefined;
+    const slashIdx = modelId.indexOf("/");
+    const id = slashIdx !== -1 ? modelId.slice(slashIdx + 1) : modelId;
+    // Bedrock/provider style suffixes, e.g. "...-v1:0"
+    const providerSuffix = id.match(/-(v\d+(?::\d+)?)$/i);
+    if (providerSuffix) {
+        return providerSuffix[1];
+    }
+    // ISO date suffixes: ...-2024-11-20
+    const isoDate = id.match(/-(\d{4}-\d{2}-\d{2})$/);
+    if (isoDate) {
+        return isoDate[1];
+    }
+    // Compact date suffixes: ...-20251001
+    const compactDate = id.match(/-(\d{8})$/);
+    if (compactDate) {
+        return compactDate[1];
+    }
+    // Semantic version fragments like gpt-5.3-codex or model-v2.1
+    const semverFragment = id.match(/(?:^|[-_])v?(\d+\.\d+(?:\.\d+)?)(?=$|[-_])/i);
+    if (semverFragment) {
+        return semverFragment[1];
+    }
+    return undefined;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

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

package/dist/provider-catalog.d.ts

@@ -0,0 +1,62 @@
+/**
+ * kosha-discovery — Canonical provider catalog.
+ *
+ * I keep provider identity, aliases, transport, credential requirements,
+ * and default base URLs in one place so discovery, credentials, and the
+ * versioned schema do not drift apart.
+ * @module
+ */
+import type { KoshaConfig, ProviderOrigin, ProviderTransport } from "./types.js";
+/**
+ * Stable provider descriptor used by normalization and v1 schema emission.
+ */
+export interface ProviderDescriptor {
+    /** Canonical provider ID exposed to discovery consumers. */
+    providerId: string;
+    /** Stable canonical ID; repeated for clarity in external schemas. */
+    canonicalProviderId: string;
+    /** Provider aliases accepted in config and queries. */
+    aliases: string[];
+    /** Human-friendly display name. */
+    name: string;
+    /** High-level origin classification. */
+    origin: ProviderOrigin;
+    /** True when the runtime is local to the machine. */
+    isLocal: boolean;
+    /** Transport family exposed by the provider. */
+    transport: ProviderTransport;
+    /** Default base URL used by the built-in discoverer. */
+    defaultBaseUrl: string;
+    /** Whether the provider normally requires credentials. */
+    credentialRequired: boolean;
+    /** Environment variables that satisfy the provider credential requirement. */
+    credentialEnvVars: string[];
+}
+/**
+ * Canonical provider catalog.
+ *
+ * I keep this intentionally compact. When a provider alias is accepted,
+ * it must resolve here first before discovery or config lookup proceeds.
+ */
+export declare const PROVIDER_CATALOG: readonly ProviderDescriptor[];
+/**
+ * Return the canonical provider ID for a possibly-aliased identifier.
+ */
+export declare function normalizeProviderId(providerId: string | undefined): string | undefined;
+/**
+ * Resolve a provider descriptor from a canonical ID or alias.
+ */
+export declare function getProviderDescriptor(providerId: string | undefined): ProviderDescriptor | undefined;
+/**
+ * Return every known provider descriptor in catalog order.
+ */
+export declare function listProviderDescriptors(): ProviderDescriptor[];
+/**
+ * Read provider config using canonical IDs and accepted aliases.
+ */
+export declare function getProviderConfig(config: KoshaConfig | undefined, providerId: string | undefined): NonNullable<KoshaConfig["providers"]>[string] | undefined;
+/**
+ * True when the provider is a local runtime.
+ */
+export declare function isLocalProvider(providerId: string | undefined): boolean;
+//# sourceMappingURL=provider-catalog.d.ts.map

package/dist/provider-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-catalog.d.ts","sourceRoot":"","sources":["../src/provider-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,MAAM,EAAE,cAAc,CAAC;IACvB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,SAAS,EAAE,iBAAiB,CAAC;IAC7B,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,kBAAkB,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,kBAAkB,EAyQhD,CAAC;AAWX;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGtF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,kBAAkB,GAAG,SAAS,CAGpG;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,kBAAkB,EAAE,CAE9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC5B,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,CAW3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEvE"}

package/dist/provider-catalog.js

@@ -0,0 +1,331 @@
+/**
+ * kosha-discovery — Canonical provider catalog.
+ *
+ * I keep provider identity, aliases, transport, credential requirements,
+ * and default base URLs in one place so discovery, credentials, and the
+ * versioned schema do not drift apart.
+ * @module
+ */
+/**
+ * Canonical provider catalog.
+ *
+ * I keep this intentionally compact. When a provider alias is accepted,
+ * it must resolve here first before discovery or config lookup proceeds.
+ */
+export const PROVIDER_CATALOG = [
+    {
+        providerId: "anthropic",
+        canonicalProviderId: "anthropic",
+        aliases: [],
+        name: "Anthropic",
+        origin: "direct",
+        isLocal: false,
+        transport: "native-http",
+        defaultBaseUrl: "https://api.anthropic.com",
+        credentialRequired: true,
+        credentialEnvVars: ["ANTHROPIC_API_KEY"],
+    },
+    {
+        providerId: "openai",
+        canonicalProviderId: "openai",
+        aliases: [],
+        name: "OpenAI",
+        origin: "direct",
+        isLocal: false,
+        transport: "native-http",
+        defaultBaseUrl: "https://api.openai.com",
+        credentialRequired: true,
+        credentialEnvVars: ["OPENAI_API_KEY"],
+    },
+    {
+        providerId: "google",
+        canonicalProviderId: "google",
+        aliases: ["gemini"],
+        name: "Google",
+        origin: "direct",
+        isLocal: false,
+        transport: "native-http",
+        defaultBaseUrl: "https://generativelanguage.googleapis.com",
+        credentialRequired: true,
+        credentialEnvVars: ["GOOGLE_API_KEY", "GEMINI_API_KEY"],
+    },
+    {
+        providerId: "openrouter",
+        canonicalProviderId: "openrouter",
+        aliases: [],
+        name: "OpenRouter",
+        origin: "proxy",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://openrouter.ai/api/v1",
+        credentialRequired: false,
+        credentialEnvVars: ["OPENROUTER_API_KEY"],
+    },
+    {
+        providerId: "ollama",
+        canonicalProviderId: "ollama",
+        aliases: [],
+        name: "Ollama",
+        origin: "local",
+        isLocal: true,
+        transport: "native-http",
+        defaultBaseUrl: "http://localhost:11434",
+        credentialRequired: false,
+        credentialEnvVars: [],
+    },
+    {
+        providerId: "llama.cpp",
+        canonicalProviderId: "llama.cpp",
+        aliases: ["llama-cpp", "llamacpp"],
+        name: "llama.cpp",
+        origin: "local",
+        isLocal: true,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "http://127.0.0.1:8080",
+        credentialRequired: false,
+        credentialEnvVars: [],
+    },
+    {
+        providerId: "bedrock",
+        canonicalProviderId: "bedrock",
+        aliases: ["aws-bedrock"],
+        name: "AWS Bedrock",
+        origin: "proxy",
+        isLocal: false,
+        transport: "cloud-sdk",
+        defaultBaseUrl: "https://bedrock-runtime.amazonaws.com",
+        credentialRequired: true,
+        credentialEnvVars: ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY"],
+    },
+    {
+        providerId: "vertex",
+        canonicalProviderId: "vertex",
+        aliases: ["vertex-ai"],
+        name: "Vertex AI",
+        origin: "proxy",
+        isLocal: false,
+        transport: "cloud-sdk",
+        defaultBaseUrl: "https://aiplatform.googleapis.com",
+        credentialRequired: true,
+        credentialEnvVars: ["GOOGLE_APPLICATION_CREDENTIALS", "GOOGLE_CLOUD_PROJECT"],
+    },
+    {
+        providerId: "nvidia",
+        canonicalProviderId: "nvidia",
+        aliases: [],
+        name: "NVIDIA NIM",
+        origin: "proxy",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://integrate.api.nvidia.com/v1",
+        credentialRequired: true,
+        credentialEnvVars: ["NVIDIA_API_KEY"],
+    },
+    {
+        providerId: "together",
+        canonicalProviderId: "together",
+        aliases: ["together-ai"],
+        name: "Together AI",
+        origin: "proxy",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://api.together.xyz/v1",
+        credentialRequired: true,
+        credentialEnvVars: ["TOGETHER_API_KEY"],
+    },
+    {
+        providerId: "fireworks",
+        canonicalProviderId: "fireworks",
+        aliases: ["fireworks-ai"],
+        name: "Fireworks AI",
+        origin: "proxy",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://api.fireworks.ai/inference/v1",
+        credentialRequired: true,
+        credentialEnvVars: ["FIREWORKS_API_KEY"],
+    },
+    {
+        providerId: "groq",
+        canonicalProviderId: "groq",
+        aliases: [],
+        name: "Groq",
+        origin: "proxy",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://api.groq.com/openai/v1",
+        credentialRequired: true,
+        credentialEnvVars: ["GROQ_API_KEY"],
+    },
+    {
+        providerId: "mistral",
+        canonicalProviderId: "mistral",
+        aliases: ["mistral-ai"],
+        name: "Mistral",
+        origin: "direct",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://api.mistral.ai/v1",
+        credentialRequired: true,
+        credentialEnvVars: ["MISTRAL_API_KEY"],
+    },
+    {
+        providerId: "deepinfra",
+        canonicalProviderId: "deepinfra",
+        aliases: ["deep-infra"],
+        name: "DeepInfra",
+        origin: "proxy",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://api.deepinfra.com/v1/openai",
+        credentialRequired: true,
+        credentialEnvVars: ["DEEPINFRA_API_KEY"],
+    },
+    {
+        providerId: "cohere",
+        canonicalProviderId: "cohere",
+        aliases: [],
+        name: "Cohere",
+        origin: "direct",
+        isLocal: false,
+        transport: "native-http",
+        defaultBaseUrl: "https://api.cohere.com",
+        credentialRequired: true,
+        credentialEnvVars: ["CO_API_KEY"],
+    },
+    {
+        providerId: "cerebras",
+        canonicalProviderId: "cerebras",
+        aliases: [],
+        name: "Cerebras",
+        origin: "direct",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://api.cerebras.ai/v1",
+        credentialRequired: true,
+        credentialEnvVars: ["CEREBRAS_API_KEY"],
+    },
+    {
+        providerId: "perplexity",
+        canonicalProviderId: "perplexity",
+        aliases: [],
+        name: "Perplexity",
+        origin: "proxy",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://api.perplexity.ai",
+        credentialRequired: true,
+        credentialEnvVars: ["PERPLEXITY_API_KEY"],
+    },
+    {
+        providerId: "deepseek",
+        canonicalProviderId: "deepseek",
+        aliases: [],
+        name: "DeepSeek",
+        origin: "direct",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://api.deepseek.com",
+        credentialRequired: true,
+        credentialEnvVars: ["DEEPSEEK_API_KEY"],
+    },
+    {
+        providerId: "moonshot",
+        canonicalProviderId: "moonshot",
+        aliases: ["kimi"],
+        name: "Moonshot (Kimi)",
+        origin: "direct",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://api.moonshot.cn",
+        credentialRequired: true,
+        credentialEnvVars: ["MOONSHOT_API_KEY", "KIMI_API_KEY"],
+    },
+    {
+        providerId: "glm",
+        canonicalProviderId: "glm",
+        aliases: ["zhipu", "bigmodel"],
+        name: "GLM (Zhipu)",
+        origin: "direct",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://open.bigmodel.cn/api/paas/v4",
+        credentialRequired: true,
+        credentialEnvVars: ["GLM_API_KEY", "ZHIPUAI_API_KEY"],
+    },
+    {
+        providerId: "zai",
+        canonicalProviderId: "zai",
+        aliases: ["z-ai", "z.ai"],
+        name: "Z.AI",
+        origin: "direct",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://api.z.ai/api/paas/v4",
+        credentialRequired: true,
+        credentialEnvVars: ["ZAI_API_KEY"],
+    },
+    {
+        providerId: "minimax",
+        canonicalProviderId: "minimax",
+        aliases: [],
+        name: "MiniMax",
+        origin: "direct",
+        isLocal: false,
+        transport: "openai-compatible-http",
+        defaultBaseUrl: "https://api.minimax.io",
+        credentialRequired: true,
+        credentialEnvVars: ["MINIMAX_API_KEY"],
+    },
+];
+const PROVIDER_LOOKUP = new Map();
+for (const descriptor of PROVIDER_CATALOG) {
+    PROVIDER_LOOKUP.set(descriptor.providerId, descriptor);
+    PROVIDER_LOOKUP.set(descriptor.canonicalProviderId, descriptor);
+    for (const alias of descriptor.aliases) {
+        PROVIDER_LOOKUP.set(alias, descriptor);
+    }
+}
+/**
+ * Return the canonical provider ID for a possibly-aliased identifier.
+ */
+export function normalizeProviderId(providerId) {
+    if (!providerId)
+        return undefined;
+    return PROVIDER_LOOKUP.get(providerId)?.canonicalProviderId ?? providerId;
+}
+/**
+ * Resolve a provider descriptor from a canonical ID or alias.
+ */
+export function getProviderDescriptor(providerId) {
+    if (!providerId)
+        return undefined;
+    return PROVIDER_LOOKUP.get(providerId);
+}
+/**
+ * Return every known provider descriptor in catalog order.
+ */
+export function listProviderDescriptors() {
+    return [...PROVIDER_CATALOG];
+}
+/**
+ * Read provider config using canonical IDs and accepted aliases.
+ */
+export function getProviderConfig(config, providerId) {
+    if (!config?.providers || !providerId)
+        return undefined;
+    const descriptor = getProviderDescriptor(providerId);
+    if (!descriptor) {
+        return config.providers[providerId];
+    }
+    return config.providers[descriptor.providerId] ??
+        config.providers[descriptor.canonicalProviderId] ??
+        descriptor.aliases.map((alias) => config.providers?.[alias]).find(Boolean);
+}
+/**
+ * True when the provider is a local runtime.
+ */
+export function isLocalProvider(providerId) {
+    return getProviderDescriptor(providerId)?.isLocal ?? false;
+}
+//# sourceMappingURL=provider-catalog.js.map

package/dist/provider-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-catalog.js","sourceRoot":"","sources":["../src/provider-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8BH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAkC;IAC9D;QACC,UAAU,EAAE,WAAW;QACvB,mBAAmB,EAAE,WAAW;QAChC,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,aAAa;QACxB,cAAc,EAAE,2BAA2B;QAC3C,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,mBAAmB,CAAC;KACxC;IACD;QACC,UAAU,EAAE,QAAQ;QACpB,mBAAmB,EAAE,QAAQ;QAC7B,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,aAAa;QACxB,cAAc,EAAE,wBAAwB;QACxC,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,gBAAgB,CAAC;KACrC;IACD;QACC,UAAU,EAAE,QAAQ;QACpB,mBAAmB,EAAE,QAAQ;QAC7B,OAAO,EAAE,CAAC,QAAQ,CAAC;QACnB,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,aAAa;QACxB,cAAc,EAAE,2CAA2C;QAC3D,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;KACvD;IACD;QACC,UAAU,EAAE,YAAY;QACxB,mBAAmB,EAAE,YAAY;QACjC,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,8BAA8B;QAC9C,kBAAkB,EAAE,KAAK;QACzB,iBAAiB,EAAE,CAAC,oBAAoB,CAAC;KACzC;IACD;QACC,UAAU,EAAE,QAAQ;QACpB,mBAAmB,EAAE,QAAQ;QAC7B,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,aAAa;QACxB,cAAc,EAAE,wBAAwB;QACxC,kBAAkB,EAAE,KAAK;QACzB,iBAAiB,EAAE,EAAE;KACrB;IACD;QACC,UAAU,EAAE,WAAW;QACvB,mBAAmB,EAAE,WAAW;QAChC,OAAO,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;QAClC,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,uBAAuB;QACvC,kBAAkB,EAAE,KAAK;QACzB,iBAAiB,EAAE,EAAE;KACrB;IACD;QACC,UAAU,EAAE,SAAS;QACrB,mBAAmB,EAAE,SAAS;QAC9B,OAAO,EAAE,CAAC,aAAa,CAAC;QACxB,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,WAAW;QACtB,cAAc,EAAE,uCAAuC;QACvD,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,mBAAmB,EAAE,uBAAuB,CAAC;KACjE;IACD;QACC,UAAU,EAAE,QAAQ;QACpB,mBAAmB,EAAE,QAAQ;QAC7B,OAAO,EAAE,CAAC,WAAW,CAAC;QACtB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,WAAW;QACtB,cAAc,EAAE,mCAAmC;QACnD,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,gCAAgC,EAAE,sBAAsB,CAAC;KAC7E;IACD;QACC,UAAU,EAAE,QAAQ;QACpB,mBAAmB,EAAE,QAAQ;QAC7B,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,qCAAqC;QACrD,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,gBAAgB,CAAC;KACrC;IACD;QACC,UAAU,EAAE,UAAU;QACtB,mBAAmB,EAAE,UAAU;QAC/B,OAAO,EAAE,CAAC,aAAa,CAAC;QACxB,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,6BAA6B;QAC7C,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,kBAAkB,CAAC;KACvC;IACD;QACC,UAAU,EAAE,WAAW;QACvB,mBAAmB,EAAE,WAAW;QAChC,OAAO,EAAE,CAAC,cAAc,CAAC;QACzB,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,uCAAuC;QACvD,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,mBAAmB,CAAC;KACxC;IACD;QACC,UAAU,EAAE,MAAM;QAClB,mBAAmB,EAAE,MAAM;QAC3B,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,gCAAgC;QAChD,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,cAAc,CAAC;KACnC;IACD;QACC,UAAU,EAAE,SAAS;QACrB,mBAAmB,EAAE,SAAS;QAC9B,OAAO,EAAE,CAAC,YAAY,CAAC;QACvB,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,2BAA2B;QAC3C,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,iBAAiB,CAAC;KACtC;IACD;QACC,UAAU,EAAE,WAAW;QACvB,mBAAmB,EAAE,WAAW;QAChC,OAAO,EAAE,CAAC,YAAY,CAAC;QACvB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,qCAAqC;QACrD,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,mBAAmB,CAAC;KACxC;IACD;QACC,UAAU,EAAE,QAAQ;QACpB,mBAAmB,EAAE,QAAQ;QAC7B,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,aAAa;QACxB,cAAc,EAAE,wBAAwB;QACxC,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,YAAY,CAAC;KACjC;IACD;QACC,UAAU,EAAE,UAAU;QACtB,mBAAmB,EAAE,UAAU;QAC/B,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,4BAA4B;QAC5C,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,kBAAkB,CAAC;KACvC;IACD;QACC,UAAU,EAAE,YAAY;QACxB,mBAAmB,EAAE,YAAY;QACjC,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,2BAA2B;QAC3C,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,oBAAoB,CAAC;KACzC;IACD;QACC,UAAU,EAAE,UAAU;QACtB,mBAAmB,EAAE,UAAU;QAC/B,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,0BAA0B;QAC1C,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,kBAAkB,CAAC;KACvC;IACD;QACC,UAAU,EAAE,UAAU;QACtB,mBAAmB,EAAE,UAAU;QAC/B,OAAO,EAAE,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,yBAAyB;QACzC,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,kBAAkB,EAAE,cAAc,CAAC;KACvD;IACD;QACC,UAAU,EAAE,KAAK;QACjB,mBAAmB,EAAE,KAAK;QAC1B,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC;QAC9B,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,sCAAsC;QACtD,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,aAAa,EAAE,iBAAiB,CAAC;KACrD;IACD;QACC,UAAU,EAAE,KAAK;QACjB,mBAAmB,EAAE,KAAK;QAC1B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACzB,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,8BAA8B;QAC9C,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,aAAa,CAAC;KAClC;IACD;QACC,UAAU,EAAE,SAAS;QACrB,mBAAmB,EAAE,SAAS;QAC9B,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,wBAAwB;QACxC,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,CAAC,iBAAiB,CAAC;KACtC;CACQ,CAAC;AAEX,MAAM,eAAe,GAAG,IAAI,GAAG,EAA8B,CAAC;AAC9D,KAAK,MAAM,UAAU,IAAI,gBAAgB,EAAE,CAAC;IAC3C,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACvD,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;IAChE,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACxC,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAA8B;IACjE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,mBAAmB,IAAI,UAAU,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAA8B;IACnE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACtC,OAAO,CAAC,GAAG,gBAAgB,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAChC,MAA+B,EAC/B,UAA8B;IAE9B,IAAI,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAExD,MAAM,UAAU,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,mBAAmB,CAAC;QAChD,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAA8B;IAC7D,OAAO,qBAAqB,CAAC,UAAU,CAAC,EAAE,OAAO,IAAI,KAAK,CAAC;AAC5D,CAAC"}

package/dist/registry-delta.d.ts

@@ -0,0 +1,17 @@
+/**
+ * kosha-discovery — Snapshot diff helpers for the discovery plane.
+ *
+ * I keep delta construction separate so the snapshot/health file stays small
+ * and the diff semantics remain easy to test in isolation.
+ * @module
+ */
+import type { DiscoveryChangeV1, DiscoveryDeltaV1, DiscoverySnapshotV1 } from "./discovery-contract.js";
+/**
+ * Expand a snapshot into full upsert changes for bootstrap consumers.
+ */
+export declare function fullSnapshotChanges(snapshot: DiscoverySnapshotV1): DiscoveryChangeV1[];
+/**
+ * Diff two snapshots into a single delta batch.
+ */
+export declare function diffSnapshots(previous: DiscoverySnapshotV1, next: DiscoverySnapshotV1): DiscoveryDeltaV1;
+//# sourceMappingURL=registry-delta.d.ts.map

package/dist/registry-delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-delta.d.ts","sourceRoot":"","sources":["../src/registry-delta.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACX,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,iBAAiB,EAAE,CA2BtF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE,mBAAmB,GACvB,gBAAgB,CAsBlB"}