@sriinnu/kosha-discovery 0.6.0 → 1.0.0

package/dist/cli-cmd-query.d.ts

@@ -0,0 +1,40 @@
+/**
+ * cli-cmd-query.ts — Role, capability, and pricing query commands.
+ *
+ * Contains `cmdRoles`, `cmdCheapest`, `cmdCapabilities`, and `cmdCapable` —
+ * commands that query and filter models by roles, capabilities, and pricing.
+ *
+ * Extracted from `cli-commands.ts` to keep each module under 450 LOC.
+ *
+ * @module cli-cmd-query
+ */
+import type { ModelRegistry } from "./registry.js";
+/**
+ * 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`, `--pricing`, `--json`, `--limit`).
+ */
+export declare function cmdCapable(registry: ModelRegistry, query: string, flags: Record<string, string | boolean>): Promise<void>;
+//# sourceMappingURL=cli-cmd-query.d.ts.map

package/dist/cli-cmd-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-cmd-query.d.ts","sourceRoot":"","sources":["../src/cli-cmd-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AA0GnD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD9G;AAID;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmGjH;AAID;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BrH;AAID;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuC/H"}

package/dist/cli-cmd-query.js

@@ -0,0 +1,303 @@
+/**
+ * cli-cmd-query.ts — Role, capability, and pricing query commands.
+ *
+ * Contains `cmdRoles`, `cmdCheapest`, `cmdCapabilities`, and `cmdCapable` —
+ * commands that query and filter models by roles, capabilities, and pricing.
+ *
+ * Extracted from `cli-commands.ts` to keep each module under 450 LOC.
+ *
+ * @module cli-cmd-query
+ */
+import { BOLD, CYAN, DIM, RED, YELLOW, c, formatPrice, formatPricingTier, line, renderTable, } from "./cli-format.js";
+async function ensureDiscovered(registry) {
+    const candidate = registry;
+    if (typeof candidate.ensureDiscovered === "function") {
+        await candidate.ensureDiscovered();
+        return;
+    }
+    if (typeof candidate.isDiscovered === "function" && candidate.isDiscovered()) {
+        return;
+    }
+    if (typeof candidate.discover === "function") {
+        await candidate.discover();
+    }
+}
+function parseNumberFlag(flags, name, fallback) {
+    const raw = flags[name];
+    if (typeof raw !== "string" || raw.trim() === "") {
+        return fallback;
+    }
+    const value = Number(raw);
+    return Number.isFinite(value) ? value : fallback;
+}
+const MODEL_TABLE_COLUMNS = [
+    { header: "Provider", width: 12 },
+    { header: "Model", width: 40 },
+    { header: "Mode", width: 10 },
+    { header: "Input", width: 12 },
+    { header: "Output", width: 12 },
+];
+const PRICING_TABLE_COLUMNS = [
+    { header: "Provider", width: 12 },
+    { header: "Model", width: 34 },
+    { header: "Mode", width: 10 },
+    { header: "Tier", width: 6 },
+    { header: "$/M in", width: 8, align: "right" },
+    { header: "$/M out", width: 8, align: "right" },
+    { header: "Cache R", width: 8, align: "right" },
+    { header: "Cache W", width: 8, align: "right" },
+    { header: "Batch in", width: 8, align: "right" },
+    { header: "Batch out", width: 9, align: "right" },
+];
+function modelRow(model) {
+    return [
+        c(CYAN, model.providerId ?? model.provider ?? ""),
+        model.id ?? "",
+        model.mode ?? "",
+        formatPrice(model.inputPrice ?? undefined),
+        formatPrice(model.outputPrice ?? undefined),
+    ];
+}
+function pricingRow(model) {
+    return [
+        c(CYAN, model.provider ?? ""),
+        model.id ?? "",
+        model.mode ?? "",
+        formatPricingTier(model.pricing),
+        formatPrice(model.pricing?.inputPerMillion),
+        formatPrice(model.pricing?.outputPerMillion),
+        formatPrice(model.pricing?.cacheReadPerMillion),
+        formatPrice(model.pricing?.cacheWritePerMillion),
+        formatPrice(model.pricing?.batchInputPerMillion),
+        formatPrice(model.pricing?.batchOutputPerMillion),
+    ];
+}
+// ── roles ────────────────────────────────────────────────────────────────
+/**
+ * Show a provider -> model -> roles matrix.
+ *
+ * Useful for assistants that need to answer: "which providers/models can do X?"
+ */
+export async function cmdRoles(registry, flags) {
+    const provider = typeof flags.provider === "string" ? flags.provider : undefined;
+    const originProvider = typeof flags.origin === "string" ? flags.origin : undefined;
+    const mode = typeof flags.mode === "string" ? flags.mode : undefined;
+    const capability = typeof flags.capability === "string" ? flags.capability : undefined;
+    const role = typeof flags.role === "string" ? flags.role : undefined;
+    await ensureDiscovered(registry);
+    const providers = registry.providerRoles({ provider, originProvider, mode, capability, role });
+    if (flags.json) {
+        console.log(JSON.stringify({
+            providers,
+            count: providers.length,
+            modelCount: providers.reduce((sum, p) => sum + p.models.length, 0),
+            missingCredentials: registry.missingCredentialPrompts(providers.map((p) => p.id)),
+        }, null, 2));
+        return;
+    }
+    if (providers.length === 0) {
+        console.log(c(YELLOW, "No provider/model roles found for the given filters."));
+        return;
+    }
+    const columns = [
+        { header: "Provider", width: 12 },
+        { header: "Model", width: 40 },
+        { header: "Mode", width: 10 },
+        { header: "Roles", width: 56 },
+    ];
+    const rows = providers.flatMap((providerInfo) => providerInfo.models.map((model) => [
+        c(CYAN, providerInfo.id),
+        model.id,
+        model.mode,
+        model.roles.join(", "),
+    ]));
+    console.log(renderTable(columns, rows));
+    const missing = registry.missingCredentialPrompts(providers.map((p) => p.id));
+    if (missing.length > 0) {
+        console.log(c(DIM, "\nMissing provider credentials:"));
+        for (const prompt of missing) {
+            console.log(`  ${c(YELLOW, prompt.providerId)}: ${prompt.message}`);
+        }
+    }
+}
+// ── cheapest ─────────────────────────────────────────────────────────────
+/**
+ * Return cheapest model candidates for a requested role/capability.
+ */
+export async function cmdCheapest(registry, flags) {
+    const provider = typeof flags.provider === "string" ? flags.provider : undefined;
+    const originProvider = typeof flags.origin === "string" ? flags.origin : undefined;
+    const mode = typeof flags.mode === "string" ? flags.mode : undefined;
+    const capability = typeof flags.capability === "string" ? flags.capability : undefined;
+    const role = typeof flags.role === "string" ? flags.role : undefined;
+    const showPricing = flags.pricing === true;
+    await ensureDiscovered(registry);
+    const result = registry.cheapestModels({
+        provider,
+        originProvider,
+        mode,
+        capability,
+        role,
+        limit: parseNumberFlag(flags, "limit"),
+        priceMetric: typeof flags["price-metric"] === "string"
+            ? flags["price-metric"]
+            : undefined,
+        inputWeight: parseNumberFlag(flags, "input-weight"),
+        outputWeight: parseNumberFlag(flags, "output-weight"),
+        includeUnpriced: flags["include-unpriced"] === true,
+    });
+    if (flags.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    if (result.matches.length === 0) {
+        console.log(c(YELLOW, "No priced models found for the requested filters."));
+        if (result.missingCredentials.length > 0) {
+            console.log(c(DIM, "\nMissing provider credentials:"));
+            for (const prompt of result.missingCredentials) {
+                console.log(`  ${c(YELLOW, prompt.providerId)}: ${prompt.message}`);
+            }
+        }
+        return;
+    }
+    if (showPricing) {
+        const columns = [
+            { header: "Provider", width: 12 },
+            { header: "Model", width: 30 },
+            { header: "Metric", width: 8 },
+            { header: "Tier", width: 6 },
+            { header: "Score", width: 8, align: "right" },
+            { header: "$/M in", width: 8, align: "right" },
+            { header: "$/M out", width: 8, align: "right" },
+            { header: "Cache R", width: 8, align: "right" },
+            { header: "Cache W", width: 8, align: "right" },
+            { header: "Batch in", width: 8, align: "right" },
+            { header: "Batch out", width: 9, align: "right" },
+        ];
+        const rows = result.matches.map((match) => [
+            c(CYAN, match.model.provider),
+            match.model.id,
+            match.priceMetric,
+            formatPricingTier(match.model.pricing),
+            match.score === undefined ? "\u2014" : formatPrice(match.score),
+            formatPrice(match.model.pricing?.inputPerMillion),
+            formatPrice(match.model.pricing?.outputPerMillion),
+            formatPrice(match.model.pricing?.cacheReadPerMillion),
+            formatPrice(match.model.pricing?.cacheWritePerMillion),
+            formatPrice(match.model.pricing?.batchInputPerMillion),
+            formatPrice(match.model.pricing?.batchOutputPerMillion),
+        ]);
+        console.log(renderTable(columns, rows));
+    }
+    else {
+        const columns = [
+            { header: "Provider", width: 12 },
+            { header: "Model", width: 38 },
+            { header: "Mode", width: 10 },
+            { header: "Metric", width: 8 },
+            { header: "Score", width: 10, align: "right" },
+            { header: "$/M in", width: 8, align: "right" },
+            { header: "$/M out", width: 8, align: "right" },
+        ];
+        const rows = result.matches.map((match) => [
+            c(CYAN, match.model.provider),
+            match.model.id,
+            match.model.mode,
+            match.priceMetric,
+            match.score === undefined ? "\u2014" : formatPrice(match.score),
+            formatPrice(match.model.pricing?.inputPerMillion),
+            formatPrice(match.model.pricing?.outputPerMillion),
+        ]);
+        console.log(renderTable(columns, rows));
+    }
+    console.log(c(DIM, `\n${result.pricedCandidates}/${result.candidates} candidates had usable pricing.`));
+    if (result.missingCredentials.length > 0) {
+        console.log(c(DIM, "\nMissing provider credentials:"));
+        for (const prompt of result.missingCredentials) {
+            console.log(`  ${c(YELLOW, prompt.providerId)}: ${prompt.message}`);
+        }
+    }
+}
+// ── capabilities ─────────────────────────────────────────────────────────
+/**
+ * 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 async function cmdCapabilities(registry, flags) {
+    const provider = typeof flags.provider === "string" ? flags.provider : undefined;
+    await ensureDiscovered(registry);
+    const caps = registry.capabilities({ provider });
+    if (flags.json) {
+        console.log(JSON.stringify(caps, null, 2));
+        return;
+    }
+    if (caps.length === 0) {
+        console.log(c(YELLOW, "No capabilities found."));
+        return;
+    }
+    const columns = [
+        { header: "Capability", width: 20 },
+        { header: "Models", width: 8, align: "right" },
+        { header: "Providers", width: 10, align: "right" },
+        { header: "Example Model", width: 38 },
+    ];
+    const rows = caps.map((cap) => [
+        c(CYAN, cap.capability),
+        String(cap.modelCount),
+        String(cap.providerCount),
+        cap.exampleModelId ?? c(DIM, "\u2014"),
+    ]);
+    const totalModels = registry.models({ provider }).length;
+    console.log(renderTable(columns, rows));
+    console.log(c(DIM, `\n${caps.length} capabilities across ${totalModels} models`));
+}
+// ── capable ──────────────────────────────────────────────────────────────
+/**
+ * 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`, `--pricing`, `--json`, `--limit`).
+ */
+export async function cmdCapable(registry, query, flags) {
+    if (!query) {
+        console.error(c(RED, "Usage: kosha capable <capability>"));
+        process.exit(1);
+    }
+    const provider = typeof flags.provider === "string" ? flags.provider : undefined;
+    const originProvider = typeof flags.origin === "string" ? flags.origin : undefined;
+    const mode = typeof flags.mode === "string" ? flags.mode : undefined;
+    const limit = parseNumberFlag(flags, "limit");
+    const showPricing = flags.pricing === true;
+    await ensureDiscovered(registry);
+    const normalized = registry.normalizeRoleToken(query);
+    const allModels = registry.models({ provider, originProvider, mode });
+    let models = allModels.filter((m) => registry.modelSupportsRole(m, normalized));
+    if (limit !== undefined && limit > 0) {
+        models = models.slice(0, limit);
+    }
+    if (flags.json) {
+        console.log(JSON.stringify(models, null, 2));
+        return;
+    }
+    if (models.length === 0) {
+        console.log(c(YELLOW, `No models found with capability "${query}"${normalized !== query ? ` (normalized: "${normalized}")` : ""}`));
+        return;
+    }
+    const header = normalized !== query
+        ? `Models with capability ${c(CYAN, normalized)} ${c(DIM, `(from "${query}")`)}`
+        : `Models with capability ${c(CYAN, normalized)}`;
+    console.log(`\n${c(BOLD, header)}\n`);
+    const capableColumns = showPricing ? PRICING_TABLE_COLUMNS : MODEL_TABLE_COLUMNS;
+    const capableRowFn = showPricing ? pricingRow : modelRow;
+    console.log(renderTable(capableColumns, models.map(capableRowFn)));
+    const providerCount = new Set(models.map((m) => m.provider)).size;
+    console.log(c(DIM, line("\u2500", showPricing ? 110 : 90)));
+    console.log(`${c(BOLD, String(models.length))} models from ${c(BOLD, String(providerCount))} providers`);
+}
+//# sourceMappingURL=cli-cmd-query.js.map

package/dist/cli-cmd-query.js.map

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

package/dist/cli-commands.d.ts

@@ -5,9 +5,59 @@
  * Formatting utilities are imported from `./cli-format.js` to keep
  * presentation logic separate from command orchestration.
  *
+ * This module also serves as the barrel re-export for commands that were
+ * split into dedicated files (`cli-cmd-model.ts`, `cli-cmd-query.ts`,
+ * `cli-help.ts`) to keep each file under 450 LOC.
+ *
  * @module cli-commands
  */
+import type { ProviderInfo } from "./types.js";
 import type { ModelRegistry } from "./registry.js";
+import type { Column } from "./cli-format.js";
+/**
+ * Standard column layout reused by both `cmdList` and `cmdSearch`.
+ * Extracted to avoid duplicating the same six-column definition.
+ */
+export declare const MODEL_TABLE_COLUMNS: Column[];
+/**
+ * Return a human-readable label for a provider's credential source.
+ * Providers that need no remote auth (e.g. local Ollama) show `"none (local)"`.
+ *
+ * @param provider  The provider info object.
+ * @returns         A short label suitable for table display.
+ */
+export declare function formatCredentialSource(provider: ProviderInfo): string;
+/**
+ * Ensure the registry has at least one provider loaded.
+ *
+ * The registry's `discover()` transparently hydrates from the on-disk cache
+ * at `~/.kosha/cache` when that cache is still within TTL, and only hits
+ * provider APIs on a cold start or a stale cache. I look at the resulting
+ * `discoveredAt` timestamp to tell the user which path actually ran — the
+ * old "No cached data. Running discovery..." message was misleading because
+ * it fired on every invocation regardless of whether the cache was used.
+ *
+ * Honesty here matters: users need to trust that `kosha list` is fast
+ * because the cache exists, and that `kosha update` is the way to refresh.
+ *
+ * @param registry  The shared model registry instance.
+ */
+export declare function ensureDiscovered(registry: ModelRegistry): Promise<void>;
+/**
+ * Build a model-table row from a model card (shared by list/search).
+ * @param m  A model card object.
+ * @returns  An array of formatted cell strings.
+ */
+export declare function modelRow(m: {
+    provider: string;
+    id: string;
+    mode: string;
+    contextWindow: number;
+    pricing?: {
+        inputPerMillion: number;
+        outputPerMillion: number;
+    };
+}): string[];
 /**
  * Discover all configured providers and print a summary.
  * With `--json` the entire registry snapshot is emitted as JSON.
@@ -27,62 +77,33 @@ export declare function cmdDiscover(registry: ModelRegistry, flags: Record<strin
  */
 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`.
+ * Re-run LiteLLM enrichment on cached models without re-discovering providers.
  *
- * @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.
+ * This is the lightweight alternative to `kosha refresh` when you only need
+ * updated pricing data — no provider API calls, just a single fetch from the
+ * litellm community catalogue plus a cache + manifest update.
  *
- * @param registry  The model registry to query.
- * @param flags     CLI flags (supports `--provider`, `--json`).
+ * @param registry  The model registry with cached data.
+ * @param flags     CLI flags (supports `--json`).
  */
-export declare function cmdCapabilities(registry: ModelRegistry, flags: Record<string, string | boolean>): Promise<void>;
+export declare function cmdEnrich(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".
+ * List all known models in a formatted table.
+ * Supports filtering by `--provider`, `--origin`, `--mode`, and `--capability`.
  *
  * @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`).
+ * @param flags     CLI flags (supports `--provider`, `--origin`, `--mode`, `--capability`, `--pricing`, `--json`).
  */
-export declare function cmdCapable(registry: ModelRegistry, query: string, flags: Record<string, string | boolean>): Promise<void>;
+export declare function cmdList(registry: ModelRegistry, 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`).
+ * @param flags     CLI flags (supports `--origin`, `--pricing`, `--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.
  *
@@ -90,29 +111,6 @@ export declare function cmdModel(registry: ModelRegistry, idOrAlias: string, fla
  * @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.
  *
@@ -128,15 +126,7 @@ export declare function cmdRefresh(registry: ModelRegistry, flags: Record<string
  * @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;
+export { cmdModel, cmdResolve, cmdRoutes } from "./cli-cmd-model.js";
+export { cmdRoles, cmdCheapest, cmdCapabilities, cmdCapable } from "./cli-cmd-query.js";
+export { showHelp, showVersion, showSplash } from "./cli-help.js";
 //# sourceMappingURL=cli-commands.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cli-commands.d.ts","sourceRoot":"","sources":["../src/cli-commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-commands.d.ts","sourceRoot":"","sources":["../src/cli-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAMnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAM9C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,EAOvC,CAAC;AAmBF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAKrE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B7E;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,EAAE,CAO5K;AAqDD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjH;AAID;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB/G;AAID;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B/G;AAID;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB7G;AAID;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB9H;AAID;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBlH;AAID;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhH;AAID;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrF;AAMD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}