feat: add Kimi support as a first-class CLI cat

.gitignore

@@ -29,6 +29,7 @@ packages/web/public/worker-*.js
 .augment/
 .codex/
 .gemini/
+.kimi/
 .kiro/
 .trae/
 .dare/
@@ -66,6 +67,7 @@ npm-debug.log*
 pnpm-debug.log*
 
 # Lockfiles (workspace uses pnpm only)
+package-lock.json
 packages/**/package-lock.json
 
 # Test coverage
@@ -130,6 +132,9 @@ private/
 # Playwright MCP cache
 .playwright-mcp/
 
+# Local OMX runtime state
+.omx/
+
 # SQLite runtime databases (Hindsight evidence store)
 evidence.sqlite
 evidence.sqlite-shm

cat-config.json

@@ -82,6 +82,13 @@
       "lead": true,
       "available": true,
       "evaluation": "开源多模型编码猫，自带 Oh My OpenCode 多专家编排 + LSP (F105)"
+    },
+    "kimi": {
+      "family": "moonshot",
+      "roles": ["research", "writer"],
+      "lead": true,
+      "available": true,
+      "evaluation": "中文长文理解与总结强，适合中文表达、资料整理与结构化输出"
     }
   },
   "reviewPolicy": {
@@ -638,6 +645,43 @@
           }
         }
       ]
+    },
+    {
+      "id": "moonshot",
+      "catId": "kimi",
+      "name": "梵花猫",
+      "displayName": "梵花猫",
+      "avatar": "/avatars/kimi.png",
+      "color": {
+        "primary": "#4B5563",
+        "secondary": "#E5E7EB"
+      },
+      "mentionPatterns": ["@kimi", "@moonshot", "@月之暗面", "@梵花猫"],
+      "roleDescription": "中文长文本助手，擅长中文语境理解、资料整理与结构化表达",
+      "teamStrengths": "中文长文、总结归纳、资料整理",
+      "caution": null,
+      "defaultVariantId": "kimi-default",
+      "variants": [
+        {
+          "id": "kimi-default",
+          "clientId": "kimi",
+          "defaultModel": "kimi-code/kimi-for-coding",
+          "mcpSupport": true,
+          "cli": {
+            "command": "kimi",
+            "outputFormat": "stream-json",
+            "defaultArgs": ["--print", "--output-format", "stream-json"]
+          },
+          "personality": "稳健细致，擅长长文阅读和中文语境下的结构化表达",
+          "strengths": ["long-context", "chinese-writing", "summarization"],
+          "contextBudget": {
+            "maxPromptTokens": 240000,
+            "maxContextTokens": 216000,
+            "maxMessages": 200,
+            "maxContentLengthPerMsg": 10000
+          }
+        }
+      ]
     }
   ]
 }

cat-template.json

@@ -82,6 +82,13 @@
       "lead": true,
       "available": true,
       "evaluation": "开源多模型编码猫，自带 Oh My OpenCode 多专家编排 + LSP (F105)"
+    },
+    "kimi": {
+      "family": "moonshot",
+      "roles": ["research", "writer"],
+      "lead": true,
+      "available": true,
+      "evaluation": "中文长文理解与总结强，适合中文表达、资料整理与结构化输出"
     }
   },
   "reviewPolicy": {
@@ -638,6 +645,43 @@
           }
         }
       ]
+    },
+    {
+      "id": "moonshot",
+      "catId": "kimi",
+      "name": "梵花猫",
+      "displayName": "梵花猫",
+      "avatar": "/avatars/kimi.png",
+      "color": {
+        "primary": "#4B5563",
+        "secondary": "#E5E7EB"
+      },
+      "mentionPatterns": ["@kimi", "@moonshot", "@月之暗面", "@梵花猫"],
+      "roleDescription": "中文长文本助手，擅长中文语境理解、资料整理与结构化表达",
+      "teamStrengths": "中文长文、总结归纳、资料整理",
+      "caution": null,
+      "defaultVariantId": "kimi-default",
+      "variants": [
+        {
+          "id": "kimi-default",
+          "clientId": "kimi",
+          "defaultModel": "kimi-code/kimi-for-coding",
+          "mcpSupport": true,
+          "cli": {
+            "command": "kimi",
+            "outputFormat": "stream-json",
+            "defaultArgs": ["--print", "--output-format", "stream-json"]
+          },
+          "personality": "稳健细致，擅长长文阅读和中文语境下的结构化表达",
+          "strengths": ["long-context", "chinese-writing", "summarization"],
+          "contextBudget": {
+            "maxPromptTokens": 240000,
+            "maxContextTokens": 216000,
+            "maxMessages": 200,
+            "maxContentLengthPerMsg": 10000
+          }
+        }
+      ]
     }
   ]
 }

packages/api/package.json

@@ -9,7 +9,7 @@
     "build": "pnpm --dir ../shared build && tsc",
     "start": "node dist/index.js",
     "test": "pnpm run build && CAT_CAFE_DISABLE_SHARED_STATE_PREFLIGHT=1 node --test --test-timeout=60000 test/*.test.js test/**/*.test.js",
-    "test:public": "pnpm run build && CAT_CAFE_DISABLE_SHARED_STATE_PREFLIGHT=1 node --test --test-concurrency=1 $(ls test/*.test.js test/**/*.test.js 2>/dev/null | grep -v 'redis-' | grep -v 'concurrent-fault-drill' | grep -v 'task-progress-store' | grep -v 'session-strategy-phase3' | grep -v 'signal-article-store' | grep -v 'persistence-fault-drill' | grep -v 'cursor-store-atomicity' | grep -v 'workflow-sop-store' | grep -v 'dare-agent-service' | grep -v 'dare-l1-acceptance' | grep -v 'codex-agent-service' | grep -v 'claude-settings-hooks\\.test' | grep -v 'game-store\\.test' | grep -v 'test/memory/' | grep -v 'cross-cat-context\\.test' | grep -v 'thread-wiring\\.test' | grep -v 'integration/wiring\\.test' | grep -v 'antigravity-cdp-client\\.test' | grep -v 'shared-state-wiring\\.test' | grep -v 'signal-fetcher-launchd' | grep -v 'reflection-capsule-m3' | grep -v 'workspace-project-context\\.test' | grep -v 'projects-setup\\.test' | grep -v 'projects-mkdir\\.test' | grep -v 'governance-status\\.test' | grep -v 'pack-integration\\.test' | grep -v 'project-setup-flow\\.test' | grep -v 'process-liveness-probe\\.test' | tr '\\n' ' ')",
+    "test:public": "pnpm run build && CAT_CAFE_DISABLE_SHARED_STATE_PREFLIGHT=1 node --test --test-concurrency=1 $(ls test/*.test.js test/**/*.test.js 2>/dev/null | grep -v 'redis-' | grep -v 'concurrent-fault-drill' | grep -v 'task-progress-store' | grep -v 'session-strategy-phase3' | grep -v 'signal-article-store' | grep -v 'persistence-fault-drill' | grep -v 'cursor-store-atomicity' | grep -v 'workflow-sop-store' | grep -v 'dare-agent-service' | grep -v 'dare-l1-acceptance' | grep -v 'codex-agent-service' | grep -v 'kimi-agent-service' | grep -v 'claude-settings-hooks\\.test' | grep -v 'game-store\\.test' | grep -v 'test/memory/' | grep -v 'cross-cat-context\\.test' | grep -v 'thread-wiring\\.test' | grep -v 'integration/wiring\\.test' | grep -v 'antigravity-cdp-client\\.test' | grep -v 'shared-state-wiring\\.test' | grep -v 'signal-fetcher-launchd' | grep -v 'reflection-capsule-m3' | grep -v 'workspace-project-context\\.test' | grep -v 'projects-setup\\.test' | grep -v 'projects-mkdir\\.test' | grep -v 'governance-status\\.test' | grep -v 'pack-integration\\.test' | grep -v 'project-setup-flow\\.test' | grep -v 'process-liveness-probe\\.test' | tr '\\n' ' ')",
     "test:antigravity-smoke": "RUN_ANTIGRAVITY_SMOKE=true pnpm run build && RUN_ANTIGRAVITY_SMOKE=true node --test test/antigravity-smoke.test.js",
     "fetch-signals": "node dist/scripts/fetch-signals.js",
     "migrate-signals": "node dist/scripts/migrate-signals.js",

packages/api/src/config/account-resolver.ts

@@ -10,7 +10,7 @@ import { readCredential } from './credentials.js';
 
 // ── Types surviving from provider-profiles.types.ts (F136 Phase 4d) ──
 
-export type BuiltinAccountClient = Extract<ClientId, 'anthropic' | 'openai' | 'google' | 'dare' | 'opencode'>;
+export type BuiltinAccountClient = Extract<ClientId, 'anthropic' | 'openai' | 'google' | 'kimi' | 'dare' | 'opencode'>;
 export type ProviderProfileKind = 'builtin' | 'api_key';
 
 export interface RuntimeProviderProfile {
@@ -37,6 +37,7 @@ export function resolveBuiltinClientForProvider(provider: ClientId): BuiltinAcco
     case 'anthropic':
     case 'openai':
     case 'google':
+    case 'kimi':
     case 'dare':
     case 'opencode':
       return provider;
@@ -51,6 +52,7 @@ const LEGACY_BUILTIN_IDS: Record<BuiltinAccountClient, string> = {
   anthropic: 'claude',
   openai: 'codex',
   google: 'gemini',
+  kimi: 'kimi',
   dare: 'dare',
   opencode: 'opencode',
 };
@@ -82,6 +84,8 @@ const BUILTIN_ACCOUNT_MAP: Record<string, { client: BuiltinAccountClient; protoc
   builtin_openai: { client: 'openai', protocol: 'openai' },
   gemini: { client: 'google', protocol: 'google' },
   builtin_google: { client: 'google', protocol: 'google' },
+  kimi: { client: 'kimi', protocol: 'kimi' },
+  builtin_kimi: { client: 'kimi', protocol: 'kimi' },
   dare: { client: 'dare', protocol: 'openai' },
   builtin_dare: { client: 'dare', protocol: 'openai' },
   opencode: { client: 'opencode', protocol: 'anthropic' },
@@ -188,6 +192,7 @@ function normalizeToClient(clientOrProtocol: string): BuiltinAccountClient | nul
     case 'anthropic':
     case 'openai':
     case 'google':
+    case 'kimi':
     case 'dare':
     case 'opencode':
       return clientOrProtocol;

packages/api/src/config/capabilities/capability-orchestrator.ts

@@ -19,9 +19,11 @@ import {
   readClaudeMcpConfig,
   readCodexMcpConfig,
   readGeminiMcpConfig,
+  readKimiMcpConfig,
   writeClaudeMcpConfig,
   writeCodexMcpConfig,
   writeGeminiMcpConfig,
+  writeKimiMcpConfig,
 } from './mcp-config-adapters.js';
 
 // ────────── Constants ──────────
@@ -104,6 +106,7 @@ const PROVIDER_WRITERS = {
   anthropic: writeClaudeMcpConfig,
   openai: writeCodexMcpConfig,
   google: writeGeminiMcpConfig,
+  kimi: writeKimiMcpConfig,
 } as const;
 
 /** Check if a descriptor has a usable transport (stdio command, local resolver, or streamableHttp URL). */
@@ -353,20 +356,22 @@ export interface DiscoveryPaths {
   claudeConfig: string; // e.g. <projectRoot>/.mcp.json
   codexConfig: string; // e.g. <projectRoot>/.codex/config.toml
   geminiConfig: string; // e.g. <projectRoot>/.gemini/settings.json
+  kimiConfig: string; // e.g. <projectRoot>/.kimi/mcp.json
 }
 
 /**
  * Discover external MCP servers from all 3 CLI configs.
  * Merges by name; if same name appears in multiple, first wins.
  */
 export async function discoverExternalMcpServers(paths: DiscoveryPaths): Promise<McpServerDescriptor[]> {
-  const [claude, codex, gemini] = await Promise.all([
+  const [claude, codex, gemini, kimi] = await Promise.all([
     readClaudeMcpConfig(paths.claudeConfig),
     readCodexMcpConfig(paths.codexConfig),
     readGeminiMcpConfig(paths.geminiConfig),
+    readKimiMcpConfig(paths.kimiConfig),
   ]);
   return deduplicateDiscoveredMcpServers(
-    [...claude, ...codex, ...gemini]
+    [...claude, ...codex, ...gemini, ...kimi]
       .filter((server) => hasUsableTransport(server))
       .map((server) => ({ ...server, source: 'external' as const })),
   );
@@ -608,10 +613,11 @@ export interface CliConfigPaths {
   anthropic: string; // e.g. <projectRoot>/.mcp.json
   openai: string; // e.g. <projectRoot>/.codex/config.toml
   google: string; // e.g. <projectRoot>/.gemini/settings.json
+  kimi: string; // e.g. <projectRoot>/.kimi/mcp.json
 }
 
 /** Providers that support streamableHttp transport (URL-based MCP). */
-const STREAMABLE_HTTP_PROVIDERS = new Set(['anthropic']);
+const STREAMABLE_HTTP_PROVIDERS = new Set(['anthropic', 'kimi']);
 
 /**
  * Resolve effective MCP servers for a specific cat.

packages/api/src/config/capabilities/mcp-config-adapters.ts

@@ -6,6 +6,7 @@
  * Claude:  .mcp.json        — { mcpServers: { name: { command, args, env } } }
  * Codex:   .codex/config.toml — [mcp_servers.<name>] command/args/env/enabled
  * Gemini:  .gemini/settings.json — { mcpServers: { name: { command, args, env, cwd } } }
+ * Kimi:    .kimi/mcp.json       — { mcpServers: { name: { url|command, args, env, headers } } }
  */
 
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
@@ -20,6 +21,13 @@ const GEMINI_CAT_CAFE_ENV_PLACEHOLDERS: Readonly<Record<string, string>> = {
   CAT_CAFE_USER_ID: '${CAT_CAFE_USER_ID}',
   CAT_CAFE_SIGNAL_USER: '${CAT_CAFE_SIGNAL_USER}',
 };
+const KIMI_CAT_CAFE_ENV_PLACEHOLDERS: Readonly<Record<string, string>> = {
+  CAT_CAFE_API_URL: '${CAT_CAFE_API_URL}',
+  CAT_CAFE_INVOCATION_ID: '${CAT_CAFE_INVOCATION_ID}',
+  CAT_CAFE_CALLBACK_TOKEN: '${CAT_CAFE_CALLBACK_TOKEN}',
+  CAT_CAFE_USER_ID: '${CAT_CAFE_USER_ID}',
+  CAT_CAFE_SIGNAL_USER: '${CAT_CAFE_SIGNAL_USER}',
+};
 
 function isCatCafeServer(name: string): boolean {
   return name === 'cat-cafe' || name.startsWith('cat-cafe-');
@@ -33,6 +41,14 @@ function ensureGeminiCatCafeEnv(name: string, env?: Record<string, string>): Rec
   };
 }
 
+function ensureKimiCatCafeEnv(name: string, env?: Record<string, string>): Record<string, string> | undefined {
+  if (!isCatCafeServer(name)) return env;
+  return {
+    ...KIMI_CAT_CAFE_ENV_PLACEHOLDERS,
+    ...(env ?? {}),
+  };
+}
+
 // ────────── Readers ──────────
 
 /** Read Claude .mcp.json → McpServerDescriptor[] */
@@ -87,6 +103,22 @@ export async function readGeminiMcpConfig(filePath: string): Promise<McpServerDe
   );
 }
 
+/** Read Kimi .kimi/mcp.json → McpServerDescriptor[] */
+export async function readKimiMcpConfig(filePath: string): Promise<McpServerDescriptor[]> {
+  const raw = await safeReadFile(filePath);
+  if (!raw) return [];
+
+  const data = safeJsonParse(raw);
+  if (!data) return [];
+
+  const servers = data.mcpServers;
+  if (!servers || typeof servers !== 'object') return [];
+
+  return Object.entries(servers as Record<string, Record<string, unknown>>).map(([name, cfg]) =>
+    toDescriptor(name, cfg, true),
+  );
+}
+
 // ────────── Writers ──────────
 
 /** Write McpServerDescriptor[] → Claude .mcp.json (merge: preserves user's non-managed servers) */
@@ -273,9 +305,64 @@ export async function cleanStaleClaudeProjectOverrides(
   return cleaned;
 }
 
+/** Write McpServerDescriptor[] → Kimi .kimi/mcp.json (merge: preserves user's non-managed servers) */
+export async function writeKimiMcpConfig(filePath: string, servers: McpServerDescriptor[]): Promise<void> {
+  const raw = await safeReadFile(filePath);
+  let existing: Record<string, unknown> = {};
+  if (raw) {
+    const parsed = safeJsonParse(raw);
+    if (parsed) existing = parsed;
+  }
+
+  const existingMcp: Record<string, unknown> =
+    existing.mcpServers && typeof existing.mcpServers === 'object'
+      ? { ...(existing.mcpServers as Record<string, unknown>) }
+      : {};
+
+  for (const s of servers) {
+    if (!s.enabled) {
+      delete existingMcp[s.name];
+      continue;
+    }
+    if (s.transport === 'streamableHttp') {
+      if (!s.url?.trim()) {
+        delete existingMcp[s.name];
+        continue;
+      }
+      const entry: Record<string, unknown> = { url: s.url };
+      if (s.headers && Object.keys(s.headers).length > 0) entry.headers = s.headers;
+      existingMcp[s.name] = entry;
+      continue;
+    }
+    if (!s.command || s.command.trim().length === 0) {
+      delete existingMcp[s.name];
+      continue;
+    }
+    const entry: Record<string, unknown> = { command: s.command, args: s.args };
+    const env = ensureKimiCatCafeEnv(s.name, s.env);
+    if (env && Object.keys(env).length > 0) entry.env = env;
+    if (s.workingDir) entry.cwd = s.workingDir;
+    existingMcp[s.name] = entry;
+  }
+
+  for (const [name, value] of Object.entries(existingMcp)) {
+    if (!isCatCafeServer(name)) continue;
+    if (!value || typeof value !== 'object' || Array.isArray(value)) continue;
+    const cfg = value as Record<string, unknown>;
+    const currentEnv = toStringRecord(cfg.env);
+    cfg.env = ensureKimiCatCafeEnv(name, currentEnv);
+    existingMcp[name] = cfg;
+  }
+
+  existing.mcpServers = existingMcp;
+  await ensureDir(filePath);
+  await writeFile(filePath, `${JSON.stringify(existing, null, 2)}\n`, 'utf-8');
+}
+
 // ────────── Helpers ──────────
 
-async function safeReadFile(filePath: string): Promise<string | null> {
+async function safeReadFile(filePath?: string): Promise<string | null> {
+  if (!filePath) return null;
   try {
     return await readFile(filePath, 'utf-8');
   } catch {
@@ -308,7 +395,8 @@ function toStringRecord(val: unknown): Record<string, string> | undefined {
 }
 
 function toDescriptor(name: string, cfg: Record<string, unknown>, enabled: boolean): McpServerDescriptor {
-  const isHttp = cfg.type === 'streamableHttp' || cfg.type === 'http';
+  const isHttp =
+    cfg.type === 'streamableHttp' || cfg.type === 'http' || (typeof cfg.url === 'string' && cfg.url.length > 0);
   const desc: McpServerDescriptor = {
     name,
     command: typeof cfg.command === 'string' ? cfg.command : '',

packages/api/src/config/cat-catalog-store.ts

@@ -32,7 +32,7 @@ function writeFileAtomic(filePath: string, content: string): void {
 }
 
 /** F340 P5: ClientId values — used to detect old `provider` field holding a clientId. */
-const CLIENT_ID_VALUES = new Set(['anthropic', 'openai', 'google', 'dare', 'antigravity', 'opencode', 'a2a']);
+const CLIENT_ID_VALUES = new Set(['anthropic', 'openai', 'google', 'kimi', 'dare', 'antigravity', 'opencode', 'a2a']);
 
 function collectCatIds(config: CatCafeConfig): Set<string> {
   const catIds = new Set<string>();