@sriinnu/kosha-discovery 0.5.0

package/dist/types.d.ts

@@ -0,0 +1,365 @@
+/**
+ * kosha-discovery (कोश) — AI Model & Provider Discovery Registry
+ *
+ * Core type definitions for the model registry system.
+ * All interfaces here are provider-agnostic; concrete discoverers
+ * map provider-specific API responses into these shapes.
+ * @module
+ */
+/** Supported model operational modes. */
+export type ModelMode = "chat" | "embedding" | "image" | "audio" | "moderation" | "rerank";
+/** Normalized transport families used by discovery consumers. */
+export type ProviderTransport = "native-http" | "openai-compatible-http" | "cloud-sdk";
+/** High-level provider origin classifications. */
+export type ProviderOrigin = "direct" | "proxy" | "local";
+/** Broad execution target for local runtimes. */
+export type ComputeTarget = "cpu" | "gpu" | "hybrid" | "unknown";
+/** Price scoring metric for cheapest-model selection. */
+export type PricingMetric = "input" | "output" | "blended";
+/** Token pricing in USD per million tokens. */
+export interface ModelPricing {
+    /** USD cost per 1 million input tokens. */
+    inputPerMillion: number;
+    /** USD cost per 1 million output tokens. */
+    outputPerMillion: number;
+    /** USD cost per 1 million cache-read tokens (optional). */
+    cacheReadPerMillion?: number;
+    /** USD cost per 1 million cache-write tokens (optional). */
+    cacheWritePerMillion?: number;
+}
+/**
+ * Local-runtime metadata surfaced for first-class local providers.
+ *
+ * Values are optional because local runtimes vary widely in what they expose.
+ * The versioned discovery schema will serialize unknown values as `null`.
+ */
+export interface LocalRuntimeMetadata {
+    /** Canonical runtime family, e.g. `"ollama"` or `"llama.cpp"`. */
+    runtimeFamily: string;
+    /** Normalized transport family used by this runtime. */
+    transport: ProviderTransport;
+    /** Best-effort tokenizer family, when exposed by the runtime. */
+    tokenizerFamily?: string;
+    /** Quantization level / format, e.g. `"Q4_K_M"` or `"F16"`. */
+    quantization?: string;
+    /** Best-effort memory footprint estimate in bytes. */
+    memoryFootprintBytes?: number;
+    /** Best-effort target device class. */
+    computeTarget?: ComputeTarget;
+    /** Whether the runtime is known to support structured outputs / grammars. */
+    supportsStructuredOutput?: boolean;
+    /** Whether the runtime is known to support token streaming. */
+    supportsStreaming?: boolean;
+}
+/**
+ * A normalized descriptor for a single AI model.
+ *
+ * Every discoverer produces `ModelCard` instances so that consumers
+ * get a uniform shape regardless of the upstream provider API.
+ * The `provider` field reflects the serving layer (e.g. "openrouter",
+ * "bedrock", "vertex"), while `originProvider` holds the original
+ * model creator (e.g. "anthropic", "openai", "google").
+ */
+export interface ModelCard {
+    /** Provider's canonical model ID (e.g. "claude-opus-4-6"). */
+    id: string;
+    /** Human-readable display name (e.g. "Claude Opus 4"). */
+    name: string;
+    /**
+     * Serving-layer provider identifier.
+     * Examples: "anthropic", "openai", "openrouter", "bedrock", "vertex".
+     */
+    provider: string;
+    /**
+     * Original model creator, distinct from the serving layer when a model
+     * is accessed through a proxy or managed service.
+     * Examples: "anthropic" when served via "openrouter" or "bedrock";
+     *           "google" when served via "vertex".
+     */
+    originProvider?: string;
+    /** Primary operational mode of the model. */
+    mode: ModelMode;
+    /** Feature flags: "chat", "vision", "function_calling", "nlu", "code", "embedding", etc. */
+    capabilities: string[];
+    /** Original free-form capability tags retained for compatibility/debugging. */
+    rawCapabilities?: string[];
+    /** Maximum context window size in tokens. */
+    contextWindow: number;
+    /** Maximum number of output tokens the model can generate. */
+    maxOutputTokens: number;
+    /** Token pricing information (filled by enrichment or API). */
+    pricing?: ModelPricing;
+    /** Output vector dimensionality (only for embedding models). */
+    dimensions?: number;
+    /** Maximum input chunk size in tokens (only for embedding models). */
+    maxInputTokens?: number;
+    /** Short alias names that resolve to this model (e.g. ["opus", "opus-4"]). */
+    aliases: string[];
+    /** Unix timestamp (ms) when this model was discovered. */
+    discoveredAt: number;
+    /** How this model entry was obtained. */
+    source: "api" | "litellm" | "local" | "manual";
+    /** AWS region for Bedrock-served models (e.g. "us-east-1"). */
+    region?: string;
+    /** GCP project ID for Vertex AI-served models (e.g. "my-gcp-project"). */
+    projectId?: string;
+    /** Local-runtime metadata for Ollama / llama.cpp style providers. */
+    localRuntime?: LocalRuntimeMetadata;
+}
+/**
+ * A model projection used for role/capability matrix views.
+ *
+ * `roles` is a union of the model's primary mode plus all declared capability
+ * flags, deduplicated and normalized for routing use-cases.
+ */
+export interface ModelRoleCard {
+    /** Provider's canonical model ID. */
+    id: string;
+    /** Human-readable display name. */
+    name: string;
+    /** Serving-layer provider slug. */
+    provider: string;
+    /** Original model creator (if different from serving provider). */
+    originProvider?: string;
+    /** Primary model mode. */
+    mode: ModelMode;
+    /** Deduplicated role/capability list (e.g. ["chat", "vision", "function_calling"]). */
+    roles: string[];
+    /** Optional pricing copied from the base model card. */
+    pricing?: ModelPricing;
+}
+/** Provider-level role matrix view used by assistants and routing clients. */
+export interface ProviderRoleInfo {
+    /** Unique provider slug. */
+    id: string;
+    /** Human-readable provider name. */
+    name: string;
+    /** Whether an auth credential was resolved for this provider. */
+    authenticated: boolean;
+    /** How credential was sourced, if available. */
+    credentialSource?: "env" | "cli" | "config" | "oauth" | "none";
+    /** Role-augmented model projections for this provider. */
+    models: ModelRoleCard[];
+}
+/** Query options for role-based model/provider views. */
+export interface RoleQueryOptions {
+    /** Restrict to one serving-layer provider. */
+    provider?: string;
+    /** Restrict by model creator/provider. */
+    originProvider?: string;
+    /** Restrict by primary mode. */
+    mode?: ModelMode;
+    /** Restrict by normalized capability tag (e.g. "vision", "embedding"). */
+    capability?: string;
+    /** Flexible role query alias (e.g. "embeddings", "image", "tool_use"). */
+    role?: string;
+}
+/** Prompt metadata for providers missing required credentials. */
+export interface ProviderCredentialPrompt {
+    /** Provider slug. */
+    providerId: string;
+    /** Provider display name. */
+    providerName: string;
+    /** Whether this provider requires credentials to discover/use models. */
+    required: boolean;
+    /** Environment variable names that satisfy the credential requirement. */
+    envVars: string[];
+    /** Human-readable prompt text suitable for assistant UX. */
+    message: string;
+}
+/** Query options for cheapest-model selection. */
+export interface CheapestModelOptions extends RoleQueryOptions {
+    /** Maximum number of ranked matches to return (default: 5). */
+    limit?: number;
+    /** Pricing comparator metric (default inferred from role/mode). */
+    priceMetric?: PricingMetric;
+    /** Weight applied to input-token price when using `blended` metric (default: 1). */
+    inputWeight?: number;
+    /** Weight applied to output-token price when using `blended` metric (default: 1). */
+    outputWeight?: number;
+    /** Include unpriced models at the end of results with undefined score. */
+    includeUnpriced?: boolean;
+}
+/** A ranked cheapest-model match with its computed score. */
+export interface CheapestModelMatch {
+    /** Ranked model candidate. */
+    model: ModelCard;
+    /** Computed cost score (undefined when model has no usable pricing). */
+    score?: number;
+    /** Metric used for scoring this result set. */
+    priceMetric: PricingMetric;
+}
+/** Full cheapest-model query response with diagnostics for callers. */
+export interface CheapestModelResult {
+    /** Ranked matches sorted by ascending score. */
+    matches: CheapestModelMatch[];
+    /** Total models matching non-price filters before pricing checks. */
+    candidates: number;
+    /** Models with usable pricing for the selected metric. */
+    pricedCandidates: number;
+    /** Matching models excluded due to missing/invalid pricing. */
+    skippedNoPricing: number;
+    /** Metric actually used to compute scores. */
+    priceMetric: PricingMetric;
+    /** Providers that are likely missing required API keys. */
+    missingCredentials: ProviderCredentialPrompt[];
+}
+/** Aggregated capability summary returned by {@link ModelRegistry.capabilities}. */
+export interface CapabilitySummary {
+    /** Normalized capability/role string (e.g. "vision", "embedding", "function_calling"). */
+    capability: string;
+    /** Number of distinct models that declare this capability. */
+    modelCount: number;
+    /** Number of unique serving-layer providers that offer this capability. */
+    providerCount: number;
+    /** List of unique provider slugs that serve models with this capability. */
+    providers: string[];
+    /** Unique model modes seen among models with this capability. */
+    modes: ModelMode[];
+    /** An example model ID for quick reference (first encountered). */
+    exampleModelId?: string;
+}
+/** Error captured when a provider's discovery fails during {@link ModelRegistry.discover}. */
+export interface DiscoveryError {
+    /** Provider slug that failed discovery. */
+    providerId: string;
+    /** Human-readable provider name. */
+    providerName: string;
+    /** Error message from the failed discovery attempt. */
+    error: string;
+    /** Unix timestamp (ms) when the error occurred. */
+    timestamp: number;
+}
+/** Detailed provider route info for a model across serving layers. */
+export interface ModelRouteInfo {
+    /** Original model card for this route. */
+    model: ModelCard;
+    /** Serving provider ID (same as `model.provider`). */
+    provider: string;
+    /** Resolved model creator/provider (origin). */
+    originProvider: string;
+    /** Base URL of the serving provider API, when known. */
+    baseUrl?: string;
+    /** Parsed model version hint (date, semantic version, or provider suffix). */
+    version?: string;
+    /** True when the model is served directly by its origin provider. */
+    isDirect: boolean;
+    /** True when this route is recommended for invocation. */
+    isPreferred: boolean;
+}
+/**
+ * Aggregated info about a single AI provider and the models it serves.
+ */
+export interface ProviderInfo {
+    /** Unique provider slug (e.g. "anthropic"). */
+    id: string;
+    /** Human-readable provider name (e.g. "Anthropic"). */
+    name: string;
+    /** Base URL for the provider's API. */
+    baseUrl: string;
+    /** Whether a valid credential was found for this provider. */
+    authenticated: boolean;
+    /** How the credential was obtained, if any. */
+    credentialSource?: "env" | "cli" | "config" | "oauth" | "none";
+    /** All models discovered from this provider. */
+    models: ModelCard[];
+    /** Unix timestamp (ms) of the last successful refresh. */
+    lastRefreshed: number;
+}
+/**
+ * Options passed to {@link ModelRegistry.discover} to control
+ * which providers are queried and how.
+ */
+export interface DiscoveryOptions {
+    /** Limit discovery to these provider IDs (default: all). */
+    providers?: string[];
+    /** Whether to scan local runtimes like Ollama / LM Studio (default: true). */
+    includeLocal?: boolean;
+    /** Per-provider HTTP timeout in milliseconds (default: 10 000). */
+    timeout?: number;
+    /** Enrich models with litellm pricing/context data (default: true). */
+    enrichWithPricing?: boolean;
+    /** Bypass the disk cache and force fresh API calls. */
+    force?: boolean;
+}
+/** Options for explicit cache-bypassing latest discovery fetches. */
+export interface LatestDiscoveryOptions extends Omit<DiscoveryOptions, "force"> {
+}
+/** Result payload returned by explicit latest discovery fetches. */
+export interface LatestDiscoveryResult {
+    /** Providers discovered during this latest fetch. */
+    providers: ProviderInfo[];
+    /** Total number of models across returned providers. */
+    modelCount: number;
+    /** Unix timestamp (ms) when discovery completed. */
+    discoveredAt: number;
+}
+/**
+ * Top-level configuration for the kosha registry.
+ */
+export interface KoshaConfig {
+    /** Directory path for the disk cache (default: ~/.kosha). */
+    cacheDir?: string;
+    /** Cache time-to-live in milliseconds (default: 86 400 000 = 24 h). */
+    cacheTtlMs?: number;
+    /** Per-provider overrides: enable/disable, explicit API keys, custom base URLs. */
+    providers?: Record<string, {
+        /** Set to false to skip this provider during discovery. */
+        enabled?: boolean;
+        /** Explicit API key — takes precedence over env / CLI sources. */
+        apiKey?: string;
+        /** Override the default API base URL for this provider. */
+        baseUrl?: string;
+    }>;
+    /** Custom user-defined alias mappings (merged on top of built-in defaults). */
+    aliases?: Record<string, string>;
+}
+/**
+ * The result of a credential lookup for a single provider.
+ */
+export interface CredentialResult {
+    /** Raw API key string, if found. */
+    apiKey?: string;
+    /** OAuth / bearer access token, if found. */
+    accessToken?: string;
+    /** How the credential was discovered. */
+    source: "env" | "cli" | "config" | "oauth" | "none";
+    /** Filesystem path the credential was read from, if applicable. */
+    path?: string;
+    /**
+     * Provider-specific metadata bag.
+     * For AWS Bedrock: `{ region: "us-east-1" }`.
+     * For GCP Vertex: `{ projectId: "my-project", region: "us-central1" }`.
+     */
+    metadata?: Record<string, string>;
+}
+/**
+ * Contract that every provider-specific discoverer must implement.
+ */
+export interface ProviderDiscoverer {
+    /** Unique provider slug (e.g. "anthropic"). */
+    readonly providerId: string;
+    /** Human-readable provider name. */
+    readonly providerName: string;
+    /** Default API base URL. */
+    readonly baseUrl: string;
+    /**
+     * Query the provider API and return normalized {@link ModelCard} instances.
+     * @param credential - Resolved credential for authentication.
+     * @param options    - Optional timeout configuration.
+     */
+    discover(credential: CredentialResult, options?: {
+        timeout?: number;
+    }): Promise<ModelCard[]>;
+}
+/**
+ * Contract for post-discovery enrichment passes (e.g. litellm pricing).
+ */
+export interface Enricher {
+    /**
+     * Augment model cards with additional data (pricing, context windows, etc.).
+     * Must return new objects — never mutate the originals.
+     */
+    enrich(models: ModelCard[]): Promise<ModelCard[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * kosha-discovery (कोश) — AI Model & Provider Discovery Registry
+ *
+ * Core type definitions for the model registry system.
+ * All interfaces here are provider-agnostic; concrete discoverers
+ * map provider-specific API responses into these shapes.
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/logo.svg

@@ -0,0 +1,81 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" width="200" height="200">
+  <defs>
+    <linearGradient id="chestGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#7C3AED"/>
+      <stop offset="100%" stop-color="#5B21B6"/>
+    </linearGradient>
+    <linearGradient id="lidGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#8B5CF6"/>
+      <stop offset="100%" stop-color="#7C3AED"/>
+    </linearGradient>
+    <linearGradient id="goldGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#FBBF24"/>
+      <stop offset="100%" stop-color="#F59E0B"/>
+    </linearGradient>
+    <filter id="glow">
+      <feGaussianBlur stdDeviation="2" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+
+  <!-- Background circle -->
+  <circle cx="100" cy="100" r="95" fill="#0F0A1A" stroke="#7C3AED" stroke-width="2" opacity="0.95"/>
+
+  <!-- Vault / Treasure chest body -->
+  <rect x="45" y="90" width="110" height="60" rx="6" ry="6" fill="url(#chestGrad)"/>
+
+  <!-- Chest lid (open, angled) -->
+  <path d="M45 90 L45 72 Q100 48 155 72 L155 90 Z" fill="url(#lidGrad)"/>
+
+  <!-- Gold clasp / lock -->
+  <rect x="90" y="85" width="20" height="14" rx="3" ry="3" fill="url(#goldGrad)"/>
+  <circle cx="100" cy="92" r="3" fill="#0F0A1A"/>
+
+  <!-- Chest bands -->
+  <line x1="45" y1="110" x2="155" y2="110" stroke="#F59E0B" stroke-width="1.5" opacity="0.6"/>
+  <line x1="45" y1="130" x2="155" y2="130" stroke="#F59E0B" stroke-width="1.5" opacity="0.6"/>
+
+  <!-- Neural network nodes emerging from chest -->
+  <!-- Central node -->
+  <circle cx="100" cy="58" r="6" fill="#F59E0B" filter="url(#glow)"/>
+
+  <!-- Left nodes -->
+  <circle cx="68" cy="42" r="4.5" fill="#A78BFA"/>
+  <circle cx="52" cy="28" r="3.5" fill="#C4B5FD"/>
+
+  <!-- Right nodes -->
+  <circle cx="132" cy="42" r="4.5" fill="#A78BFA"/>
+  <circle cx="148" cy="28" r="3.5" fill="#C4B5FD"/>
+
+  <!-- Top nodes -->
+  <circle cx="85" cy="26" r="3.5" fill="#DDD6FE"/>
+  <circle cx="115" cy="26" r="3.5" fill="#DDD6FE"/>
+  <circle cx="100" cy="18" r="4" fill="#F59E0B" opacity="0.8"/>
+
+  <!-- Neural connections -->
+  <line x1="100" y1="58" x2="68" y2="42" stroke="#A78BFA" stroke-width="1.2" opacity="0.7"/>
+  <line x1="100" y1="58" x2="132" y2="42" stroke="#A78BFA" stroke-width="1.2" opacity="0.7"/>
+  <line x1="68" y1="42" x2="52" y2="28" stroke="#C4B5FD" stroke-width="1" opacity="0.5"/>
+  <line x1="132" y1="42" x2="148" y2="28" stroke="#C4B5FD" stroke-width="1" opacity="0.5"/>
+  <line x1="68" y1="42" x2="85" y2="26" stroke="#C4B5FD" stroke-width="1" opacity="0.5"/>
+  <line x1="132" y1="42" x2="115" y2="26" stroke="#C4B5FD" stroke-width="1" opacity="0.5"/>
+  <line x1="85" y1="26" x2="100" y2="18" stroke="#DDD6FE" stroke-width="1" opacity="0.5"/>
+  <line x1="115" y1="26" x2="100" y2="18" stroke="#DDD6FE" stroke-width="1" opacity="0.5"/>
+  <line x1="52" y1="28" x2="85" y2="26" stroke="#DDD6FE" stroke-width="0.8" opacity="0.3"/>
+  <line x1="148" y1="28" x2="115" y2="26" stroke="#DDD6FE" stroke-width="0.8" opacity="0.3"/>
+
+  <!-- Provider dots inside chest glow -->
+  <circle cx="72" cy="105" r="3" fill="#F59E0B" opacity="0.7"/>
+  <circle cx="88" cy="105" r="3" fill="#F59E0B" opacity="0.5"/>
+  <circle cx="112" cy="105" r="3" fill="#F59E0B" opacity="0.5"/>
+  <circle cx="128" cy="105" r="3" fill="#F59E0B" opacity="0.7"/>
+
+  <!-- Text: Kosha -->
+  <text x="100" y="172" text-anchor="middle" font-family="'Segoe UI', system-ui, -apple-system, sans-serif" font-weight="700" font-size="22" fill="#FFFFFF" letter-spacing="2">Kosha</text>
+
+  <!-- Devanagari subtitle -->
+  <text x="100" y="190" text-anchor="middle" font-family="'Noto Sans Devanagari', 'Mangal', sans-serif" font-weight="400" font-size="12" fill="#A78BFA" letter-spacing="1">&#x0915;&#x094B;&#x0936;</text>
+</svg>

package/package.json

@@ -0,0 +1,85 @@
+{
+	"name": "@sriinnu/kosha-discovery",
+	"version": "0.5.0",
+	"description": "AI Model & Provider Discovery Registry -- kosha (कोश) treasury of models",
+	"type": "module",
+	"packageManager": "pnpm@10.33.0",
+	"license": "MIT",
+	"author": "sriinnu",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/sriinnu/kosha-discovery.git"
+	},
+	"engines": {
+		"node": ">=22"
+	},
+	"keywords": [
+		"ai",
+		"llm",
+		"model-discovery",
+		"model-registry",
+		"openai",
+		"anthropic",
+		"gemini",
+		"ollama",
+		"openrouter",
+		"bedrock",
+		"vertex-ai",
+		"ai-models",
+		"provider-discovery",
+		"model-routing",
+		"pricing",
+		"cli"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"bin": {
+		"kosha": "dist/cli.js"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./server": {
+			"types": "./dist/server.d.ts",
+			"import": "./dist/server.js"
+		},
+		"./cli": {
+			"types": "./dist/cli.d.ts",
+			"import": "./dist/cli.js"
+		}
+	},
+	"scripts": {
+		"build": "tsc -p tsconfig.json",
+		"dev": "tsc -p tsconfig.json --watch",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"clean": "rm -rf dist",
+		"start": "node dist/server.js",
+		"kosha": "node dist/cli.js",
+		"latest": "node dist/cli.js latest --json",
+		"autofetch": "node scripts/auto-fetch-latest.mjs",
+		"autofetch:once": "node scripts/auto-fetch-latest.mjs --once",
+		"prepare": "cp hooks/pre-commit .git/hooks/pre-commit 2>/dev/null && chmod +x .git/hooks/pre-commit || true"
+	},
+	"files": [
+		"dist",
+		"logo.svg",
+		"README.md",
+		"LICENSE"
+	],
+	"dependencies": {
+		"hono": "^4.12.9",
+		"@hono/node-server": "^1.19.10"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.3.14",
+		"@types/node": "^22.0.0",
+		"typescript": "^5.7.0",
+		"vitest": "^4.0.18"
+	}
+}