fix(kimi-code): inject built-in catalog at release time

Author: 7Sageer

.changeset/connect-model-catalog.md

@@ -4,6 +4,4 @@
 "@moonshot-ai/kimi-code": minor
 ---
 
-Add a `/connect` command that configures a provider and model from a model catalog. By default it reads the catalog from models.dev and fills in model metadata (context window, output limit, and capabilities) automatically, so models no longer need to be written by hand in config. Pass `--url` to point at a custom catalog endpoint that uses the same format. When connecting an Anthropic-compatible provider whose catalog base URL already includes a version segment, the request path no longer duplicates that segment, so connections that previously failed with a not-found error now succeed.
-
-When the network is unavailable, the CLI falls back to a pruned catalog snapshot that is inlined at build time, so the `/connect` command can still be used offline.
+Add a `/connect` command that configures a provider and model from a model catalog. By default it reads from a pruned catalog snapshot bundled with the CLI, so the command works offline and is not gated by models.dev availability. Model metadata (context window, output limit, and capabilities) is filled in automatically, so models no longer need to be written by hand in config. Pass `--refresh` to fetch the latest catalog from models.dev (falling back to the bundled snapshot on failure), or `--url` to point at a custom catalog endpoint that uses the same format. When connecting an Anthropic-compatible provider whose catalog base URL already includes a version segment, the request path no longer duplicates that segment, so connections that previously failed with a not-found error now succeed.

.github/workflows/_native-build.yml

@@ -77,6 +77,14 @@ jobs:
           certificate-p12: ${{ secrets.APPLE_CERTIFICATE_P12 }}
           certificate-password: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
 
+      - name: Generate built-in catalog (release artifacts)
+        if: inputs.sign-macos
+        shell: bash
+        run: |
+          CATALOG_FILE="$RUNNER_TEMP/kimi-code-built-in-catalog.json"
+          node apps/kimi-code/scripts/update-catalog.mjs --out "$CATALOG_FILE"
+          echo "KIMI_CODE_BUILT_IN_CATALOG_FILE=$CATALOG_FILE" >> "$GITHUB_ENV"
+
       - name: Build native executable (release profile, macOS signed)
         if: runner.os == 'macOS' && inputs.sign-macos
         run: pnpm --filter @moonshot-ai/kimi-code run build:native:release

.github/workflows/release.yml

@@ -41,6 +41,13 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
+      - name: Generate Kimi Code built-in catalog
+        shell: bash
+        run: |
+          CATALOG_FILE="$RUNNER_TEMP/kimi-code-built-in-catalog.json"
+          node apps/kimi-code/scripts/update-catalog.mjs --out "$CATALOG_FILE"
+          echo "KIMI_CODE_BUILT_IN_CATALOG_FILE=$CATALOG_FILE" >> "$GITHUB_ENV"
+
       - name: Build packages
         run: pnpm build
 

apps/kimi-code/package.json

@@ -44,6 +44,7 @@
   },
   "scripts": {
     "build": "tsdown",
+    "catalog:update": "node scripts/update-catalog.mjs --out dist/built-in-catalog.json",
     "smoke": "node scripts/smoke.mjs",
     "build:native:js": "node scripts/native/01-bundle.mjs",
     "build:native:sea": "node scripts/native/build.mjs --profile=local",

apps/kimi-code/scripts/built-in-catalog.mjs

@@ -0,0 +1,10 @@
+import { readFileSync } from 'node:fs';
+
+export const BUILT_IN_CATALOG_ENV = 'KIMI_CODE_BUILT_IN_CATALOG_FILE';
+export const BUILT_IN_CATALOG_DEFINE = '__KIMI_CODE_BUILT_IN_CATALOG__';
+
+export function builtInCatalogDefine(env = process.env) {
+  const file = env[BUILT_IN_CATALOG_ENV];
+  if (file === undefined || file.length === 0) return 'undefined';
+  return JSON.stringify(readFileSync(file, 'utf-8'));
+}

apps/kimi-code/scripts/native/build.mjs

@@ -1,10 +1,14 @@
+import { resolve } from 'node:path';
 import { parseArgs } from 'node:util';
 
 import { runBundleStep } from './01-bundle.mjs';
 import { runInjectStep } from './03-inject.mjs';
 import { runSeaBlobStep } from './02-sea-blob.mjs';
 import { runSignStep } from './04-sign.mjs';
 import { runVerifyStep } from './05-verify.mjs';
+import { run } from './exec.mjs';
+import { appRoot, nativeIntermediatesDir } from './paths.mjs';
+import { BUILT_IN_CATALOG_ENV } from '../built-in-catalog.mjs';
 
 const { values } = parseArgs({
   options: {
@@ -31,6 +35,12 @@ function ensureNodeVersion() {
 ensureNodeVersion();
 console.log(`==> Native build (profile=${profile})`);
 
+if (profile === 'release' && process.env[BUILT_IN_CATALOG_ENV] === undefined) {
+  const catalogPath = resolve(nativeIntermediatesDir(), 'built-in-catalog.json');
+  await run(process.execPath, [resolve(appRoot, 'scripts/update-catalog.mjs'), '--out', catalogPath]);
+  process.env[BUILT_IN_CATALOG_ENV] = catalogPath;
+}
+
 await runBundleStep();
 await runSeaBlobStep();
 await runInjectStep();

apps/kimi-code/scripts/update-catalog.mjs

@@ -1,21 +1,34 @@
 #!/usr/bin/env node
 /**
- * Fetches models.dev/api.json, strips fields not needed by kimi-code,
- * and writes the result into src/built-in-catalog.ts as a TS constant.
+ * Fetches models.dev/api.json, strips fields not needed by kimi-code, and
+ * writes the result as raw JSON for release builds to inline.
  *
- * Run before release builds so the CLI ships an offline-capable catalog.
+ * This script intentionally does not write into src/. The source tree keeps a
+ * placeholder so the generated catalog is not committed.
  */
 
-import { writeFileSync } from "node:fs";
-import { resolve } from "node:path";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
 
 const scriptDir = import.meta.dirname;
-const outFile = resolve(scriptDir, "../src/built-in-catalog.ts");
+const outFile = resolveOutputFile(process.argv.slice(2));
 const modelsUrl = process.env.MODELS_DEV_URL || "https://models.dev/api.json";
 
 const KEEP_PROVIDER = new Set(["id", "name", "api", "env", "npm", "type", "models"]);
 const KEEP_MODEL = new Set(["id", "name", "family", "limit", "tool_call", "reasoning", "modalities"]);
 
+function resolveOutputFile(args) {
+  const index = args.indexOf("--out");
+  if (index !== -1) {
+    const value = args[index + 1];
+    if (value === undefined || value.length === 0) {
+      throw new Error("Missing value for --out");
+    }
+    return resolve(process.cwd(), value);
+  }
+  return resolve(scriptDir, "../dist/built-in-catalog.json");
+}
+
 function stripModel(model) {
   if (typeof model !== "object" || model === null) return undefined;
   const result = {};
@@ -63,10 +76,8 @@ async function fetchCatalog(url) {
 async function main() {
   console.log(`Fetching ${modelsUrl} ...`);
   const json = await fetchCatalog(modelsUrl);
-  const content = `// Auto-generated by scripts/update-catalog.mjs. Do not edit manually.
-export const BUILT_IN_CATALOG_JSON: string | undefined = ${JSON.stringify(json)};
-`;
-  writeFileSync(outFile, content, "utf-8");
+  mkdirSync(dirname(outFile), { recursive: true });
+  writeFileSync(outFile, json, "utf-8");
   console.log(`Wrote ${outFile} (${(json.length / 1024).toFixed(0)} KB JSON)`);
 }
 

apps/kimi-code/src/built-in-catalog.ts

@@ -5065,40 +5065,54 @@ export class KimiTUI {
   // (context size, capabilities) comes from the catalog, so users do not
   // hand-write it.
   private async handleConnectCommand(args: string): Promise<void> {
-    const { url, allowBuiltInFallback } = resolveConnectCatalogRequest(args);
-
-    const controller = new AbortController();
-    const cancel = (): void => {
-      controller.abort();
-    };
-    this.cancelInFlight = cancel;
+    const { url, preferBuiltIn, allowBuiltInFallback } = resolveConnectCatalogRequest(args);
 
     let catalog: Catalog | undefined;
-    const spinner = this.showLoginProgressSpinner(`Fetching catalog from ${url}`);
-    try {
-      catalog = await fetchCatalog(url, controller.signal);
-      spinner.stop({ ok: true, label: 'Catalog loaded.' });
-    } catch (error) {
-      if (controller.signal.aborted) {
-        spinner.stop({ ok: false, label: 'Aborted.' });
-      } else {
-        const hint = error instanceof CatalogFetchError ? ` (HTTP ${error.status})` : '';
-        if (!allowBuiltInFallback) {
-          spinner.stop({ ok: false, label: 'Failed to load catalog.' });
-          this.showError(`Failed to fetch catalog${hint}: ${formatErrorMessage(error)}`);
+
+    // Default path: serve the bundled catalog so /connect works without a
+    // live network and is not gated by models.dev availability. The source
+    // placeholder is undefined in dev builds, so dev falls through to fetch.
+    if (preferBuiltIn) {
+      const builtIn = loadBuiltInCatalog(BUILT_IN_CATALOG_JSON);
+      if (builtIn !== undefined) {
+        this.showStatus('Loaded built-in catalog. Run /connect --refresh for the latest.');
+        catalog = builtIn;
+      }
+    }
+
+    if (catalog === undefined) {
+      const controller = new AbortController();
+      const cancel = (): void => {
+        controller.abort();
+      };
+      this.cancelInFlight = cancel;
+
+      const spinner = this.showLoginProgressSpinner(`Fetching catalog from ${url}`);
+      try {
+        catalog = await fetchCatalog(url, controller.signal);
+        spinner.stop({ ok: true, label: 'Catalog loaded.' });
+      } catch (error) {
+        if (controller.signal.aborted) {
+          spinner.stop({ ok: false, label: 'Aborted.' });
         } else {
-          const fallback = loadBuiltInCatalog(BUILT_IN_CATALOG_JSON);
-          if (fallback !== undefined) {
-            spinner.stop({ ok: true, label: 'Using built-in catalog (offline mode).' });
-            catalog = fallback;
-          } else {
+          const hint = error instanceof CatalogFetchError ? ` (HTTP ${error.status})` : '';
+          if (!allowBuiltInFallback) {
             spinner.stop({ ok: false, label: 'Failed to load catalog.' });
             this.showError(`Failed to fetch catalog${hint}: ${formatErrorMessage(error)}`);
+          } else {
+            const fallback = loadBuiltInCatalog(BUILT_IN_CATALOG_JSON);
+            if (fallback !== undefined) {
+              spinner.stop({ ok: true, label: 'Using built-in catalog (offline mode).' });
+              catalog = fallback;
+            } else {
+              spinner.stop({ ok: false, label: 'Failed to load catalog.' });
+              this.showError(`Failed to fetch catalog${hint}: ${formatErrorMessage(error)}`);
+            }
           }
         }
+      } finally {
+        if (this.cancelInFlight === cancel) this.cancelInFlight = undefined;
       }
-    } finally {
-      if (this.cancelInFlight === cancel) this.cancelInFlight = undefined;
     }
 
     if (catalog === undefined) return;

apps/kimi-code/src/tui/kimi-tui.ts

@@ -1,10 +1,12 @@
 import { DEFAULT_CATALOG_URL } from '@moonshot-ai/kimi-code-sdk';
 
 const CATALOG_URL_FLAG_RE = /--url(?:=|\s+)(\S+)/;
+const REFRESH_FLAG_RE = /(?:^|\s)--refresh(?=\s|$)/;
 const BARE_HTTP_URL_RE = /^https?:\/\/\S+$/;
 
 export interface ConnectCatalogRequest {
   readonly url: string;
+  readonly preferBuiltIn: boolean;
   readonly allowBuiltInFallback: boolean;
 }
 
@@ -14,8 +16,18 @@ export function resolveConnectCatalogRequest(args: string): ConnectCatalogReques
   const bareUrl = BARE_HTTP_URL_RE.test(trimmed) ? trimmed : undefined;
   const explicitUrl = urlMatch?.[1] ?? bareUrl;
 
+  if (explicitUrl !== undefined) {
+    return {
+      url: explicitUrl,
+      preferBuiltIn: false,
+      allowBuiltInFallback: false,
+    };
+  }
+
+  const refreshRequested = REFRESH_FLAG_RE.test(trimmed);
   return {
-    url: explicitUrl ?? DEFAULT_CATALOG_URL,
-    allowBuiltInFallback: explicitUrl === undefined,
+    url: DEFAULT_CATALOG_URL,
+    preferBuiltIn: !refreshRequested,
+    allowBuiltInFallback: true,
   };
 }