@sriinnu/kosha-discovery 0.5.0

package/dist/cache.js.map

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

package/dist/cli-commands.d.ts

@@ -0,0 +1,142 @@
+/**
+ * cli-commands.ts — Command implementations for the kosha CLI.
+ *
+ * Each exported `cmd*` function corresponds to a top-level CLI sub-command.
+ * Formatting utilities are imported from `./cli-format.js` to keep
+ * presentation logic separate from command orchestration.
+ *
+ * @module cli-commands
+ */
+import type { ModelRegistry } from "./registry.js";
+/**
+ * Discover all configured providers and print a summary.
+ * With `--json` the entire registry snapshot is emitted as JSON.
+ *
+ * @param registry  The model registry to discover into.
+ * @param flags     CLI flags (supports `--json`).
+ */
+export declare function cmdDiscover(registry: ModelRegistry, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * Fetch the latest provider/model details by forcing live discovery.
+ *
+ * Unlike regular list/search commands, this bypasses cache and always
+ * performs a fresh discovery pass (plus LiteLLM enrichment).
+ *
+ * @param registry  The model registry to discover into.
+ * @param flags     CLI flags (supports `--provider`, `--json`).
+ */
+export declare function cmdLatest(registry: ModelRegistry, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * List all known models in a formatted table.
+ * Supports filtering by `--provider`, `--origin`, `--mode`, and `--capability`.
+ *
+ * @param registry  The model registry to query.
+ * @param flags     CLI flags (supports `--provider`, `--origin`, `--mode`, `--capability`, `--json`).
+ */
+export declare function cmdList(registry: ModelRegistry, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * Show a provider -> model -> roles matrix.
+ *
+ * Useful for assistants that need to answer: "which providers/models can do X?"
+ */
+export declare function cmdRoles(registry: ModelRegistry, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * Return cheapest model candidates for a requested role/capability.
+ */
+export declare function cmdCheapest(registry: ModelRegistry, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * Show an aggregated capability overview across all discovered models.
+ * Each row shows a capability, how many models/providers support it,
+ * and an example model ID for quick reference.
+ *
+ * @param registry  The model registry to query.
+ * @param flags     CLI flags (supports `--provider`, `--json`).
+ */
+export declare function cmdCapabilities(registry: ModelRegistry, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * Show models that support a given capability/role.
+ * Normalizes the query so aliases work: "embeddings", "stt", "tools", "vision".
+ *
+ * @param registry  The model registry to query.
+ * @param query     The capability query (e.g. "vision", "embeddings", "tools").
+ * @param flags     CLI flags (supports `--provider`, `--origin`, `--json`, `--limit`).
+ */
+export declare function cmdCapable(registry: ModelRegistry, query: string, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * Search for models whose id, name, or aliases contain the query string.
+ * Case-insensitive substring matching. Optionally pre-filtered by `--origin`.
+ *
+ * @param registry  The model registry to search.
+ * @param query     The search term (substring).
+ * @param flags     CLI flags (supports `--origin`, `--json`).
+ */
+export declare function cmdSearch(registry: ModelRegistry, query: string, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * Show detailed information for a single model identified by id or alias.
+ *
+ * If an exact match is not found, falls back to fuzzy substring search.
+ * Single fuzzy match is shown automatically; multiple matches produce a
+ * disambiguation list (capped at 5 suggestions).
+ *
+ * @param registry   The model registry to look up.
+ * @param idOrAlias  A model id, display name, or alias.
+ * @param flags      CLI flags (supports `--json`).
+ */
+export declare function cmdModel(registry: ModelRegistry, idOrAlias: string, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * List all known providers with their authentication status and model counts.
+ *
+ * @param registry  The model registry to query.
+ * @param flags     CLI flags (supports `--json`).
+ */
+export declare function cmdProviders(registry: ModelRegistry, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * Resolve a model alias to its canonical provider ID.
+ * Unknown aliases are returned as-is with a yellow warning.
+ *
+ * @param registry  The model registry containing alias mappings.
+ * @param alias     The alias string to resolve.
+ * @param flags     CLI flags (supports `--json`).
+ */
+export declare function cmdResolve(registry: ModelRegistry, alias: string, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * Show every provider route through which a model can be accessed.
+ *
+ * A "route" is a serving-layer entry whose normalized model ID matches the
+ * given identifier. Output includes direct/preferred markers, origin provider,
+ * model version hint, and serving base URL.
+ *
+ * Pricing columns show `—` when data is unavailable.
+ *
+ * @param registry   The model registry to query.
+ * @param modelId    Canonical model ID or alias to look up.
+ * @param flags      CLI flags (supports `--json`).
+ */
+export declare function cmdRoutes(registry: ModelRegistry, modelId: string, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * Force a full re-discovery of all providers, bypassing the cache.
+ *
+ * @param registry  The model registry to refresh.
+ * @param flags     CLI flags (supports `--json`).
+ */
+export declare function cmdRefresh(registry: ModelRegistry, flags: Record<string, string | boolean>): Promise<void>;
+/**
+ * Start the HTTP API server on the given port.
+ * The server module is loaded via dynamic import to avoid pulling in Hono
+ * for purely CLI-based usage.
+ *
+ * @param flags  CLI flags (supports `--port <number>`, default `3000`).
+ */
+export declare function cmdServe(flags: Record<string, string | boolean>): Promise<void>;
+/** Print the full CLI usage / help text to stdout. */
+export declare function showHelp(): void;
+/** Print the CLI version string to stdout. */
+export declare function showVersion(): void;
+/**
+ * Display a branded splash screen when `kosha` is invoked with no arguments.
+ *
+ * Shows the Kosha logo, tagline, version, and quick-start commands.
+ * Uses MAGENTA branding with a clean, minimal layout.
+ */
+export declare function showSplash(): void;
+//# sourceMappingURL=cli-commands.d.ts.map

package/dist/cli-commands.d.ts.map

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