refactor: complete v1→v2 migration — retire agent-core, unify on agent-core-v2

Remove the v1 engine (packages/agent-core, kaos, acp-adapter, rust-engine,
experimental-v2) and finish the v2 migration across the monorepo:

- node-sdk: rewire tests off deleted v1 internals onto config-local/legacy
  copies and agent-core-v2 subpaths; drop orphaned v1-internal tests; fix
  MCP fixture paths and build:dts pipeline (kaos residue, i18n d.ts)
- CLI: run-prompt unified on the v2 native runner; restore the
  @moonshot-ai/kimi-agent dependency required by SEA packaging; fix
  apiKey leakage in provider --json (sanitize output)
- agent-core-v2: restore goal-turn trimming regression in the SDK's
  legacy copy (system_trigger/goal_continuation boundary), EXIF
  display-space dimensions for native sniff, wire v1.6 with
  toolCallDisplays so replay restores diff/todo previews, jimp TS
  fallback for image compression when the native addon is unavailable
- kimi-agent: load the platform-suffixed native addon in dev (glob
  instead of fixed name); rust-loop workspace index stays unwired (planned)
- i18n: translate 135 remaining hardcoded strings across 5 modules;
  fix locale-key coverage checks and the t-call coverage script
- tests: fix 166 pre-existing failures (Windows path/process semantics,
  stale assertions, snapshots, platform skips); repair docs build
  (js-yaml/gray-matter conflict, unclosed HTML in a review doc) and
  kimi-inspect build (missing i18n-shared dep, FetchLike typing)

Validation: typecheck/lint clean, full test suite green across all
packages and apps; SEA exe builds and runs.

Author: 7723qqq

.deploy-staging/package.json

@@ -83,7 +83,6 @@
     "node-pty": "^1.1.0"
   },
   "devDependencies": {
-    "@moonshot-ai/acp-adapter": "workspace:^",
     "@moonshot-ai/agent-core": "workspace:^",
     "@moonshot-ai/agent-core-v2": "workspace:^",
     "@moonshot-ai/kap-server": "workspace:^",

.oxlintrc.json

@@ -117,6 +117,18 @@
         "import/extensions": "off"
       }
     },
+    {
+      "files": [
+        "packages/agent-core-v2/src/app/workflow/**/*.ts"
+      ],
+      "rules": {
+        // `?raw` imports of the builtin .js workflow scripts: oxlint resolves
+        // the specifier as a module and reports `default`/`extensions` errors
+        // that do not apply to raw string imports.
+        "import/default": "off",
+        "import/extensions": "off"
+      }
+    },
     {
       "files": ["packages/kosong/src/providers/**/*.ts"],
 
@@ -159,6 +171,9 @@
         "eslint/no-unused-vars": "off",
         "eslint/no-unsafe-optional-chaining": "off",
         "jest/valid-expect": "off",
+        // Tests legitimately throw non-Error values to verify defensive
+        // catch-all handlers (e.g. safelyCallListener).
+        "typescript/only-throw-error": "off",
         "unicorn/no-useless-spread": "off",
         "import/no-cycle": "off",
         "typescript/no-meaningless-void-operator": "off",

AGENTS.md

@@ -78,7 +78,7 @@ apps/
 
 #### `apps/kimi-code` — CLI / TUI Application
 
-The main application. Consumes core capabilities through `@moonshot-ai/kimi-code-sdk` and must **not** depend directly on `@moonshot-ai/agent-core`. When writing or modifying its terminal UI, use the `write-tui` skill (`.agents/skills/write-tui/SKILL.md`).
+The main application. Consumes core capabilities through `@moonshot-ai/kimi-code-sdk` and must **not** depend directly on `@moonshot-ai/agent-core-v2` outside the `cli/v2` runner. When writing or modifying its terminal UI, use the `write-tui` skill (`.agents/skills/write-tui/SKILL.md`).
 
 **Source layout:**
 
@@ -154,7 +154,6 @@ packages/
   klient/            — Client SDK (contract-driven facade over agent-core-v2)
   kap-server/        — Kimi Code local server (REST + WebSocket)
   server/            — Legacy local REST + WebSocket server
-  acp-adapter/       — Agent Client Protocol adapter (public package)
   node-sdk/          — Public TypeScript SDK (@moonshot-ai/kimi-code-sdk)
   protocol/          — Shared REST + WS protocol schemas (Zod types)
   transcript/        — Isomorphic transcript rendering data layer
@@ -457,7 +456,7 @@ Two dependencies are deliberately removed: `ssh2@1.17.0>cpu-features` and `ssh2@
 
 ## Experimental Features
 
-- Gate a not-yet-public feature behind an experimental flag. Add the flag to the registry at `packages/agent-core/src/flags/registry.ts`, then check it with `flags.enabled('my-feature')`.
+- Gate a not-yet-public feature behind an experimental flag. Add the flag to the registry at `packages/agent-core-v2/src/app/flag/flagRegistry.ts`, then check it with `flags.enabled('my-feature')`.
 - Flags are env-driven and default off:
   - `KIMI_CODE_EXPERIMENTAL_<NAME>` toggles one
   - `KIMI_CODE_EXPERIMENTAL_FLAG` enables all

apps/kimi-code/package.json

@@ -84,12 +84,10 @@
     "node-pty": "^1.1.0"
   },
   "devDependencies": {
-    "@moonshot-ai/acp-adapter": "workspace:^",
     "@moonshot-ai/acp-server": "workspace:^",
     "@moonshot-ai/agent-core-v2": "workspace:^",
     "@moonshot-ai/i18n-shared": "workspace:^",
     "@moonshot-ai/kap-server": "workspace:^",
-    "@moonshot-ai/kimi-agent": "workspace:^",
     "@moonshot-ai/kimi-code-oauth": "workspace:^",
     "@moonshot-ai/kimi-code-sdk": "workspace:^",
     "@moonshot-ai/kimi-telemetry": "workspace:^",
@@ -113,5 +111,8 @@
   },
   "engines": {
     "node": ">=22.19.0"
+  },
+  "dependencies": {
+    "@moonshot-ai/kimi-agent": "workspace:^"
   }
 }

apps/kimi-code/src/cli/experimental-v2.ts

@@ -1,6 +1,8 @@
 export type UIMode = 'shell' | 'print';
 export type PromptOutputFormat = 'text' | 'stream-json';
 
+import { t } from '#/i18n';
+
 /** Environment variable that sets the default `-p` output format (flag wins). */
 export const OUTPUT_FORMAT_ENV = 'KIMI_MODEL_OUTPUT_FORMAT';
 
@@ -68,28 +70,28 @@ export function validateOptions(
   const prompt = opts.prompt;
   const promptMode = prompt !== undefined;
   if (promptMode && prompt.trim().length === 0) {
-    throw new OptionConflictError('Prompt cannot be empty.');
+    throw new OptionConflictError(t('cli.errors.promptEmpty'));
   }
   if (opts.model !== undefined && opts.model.trim().length === 0) {
-    throw new OptionConflictError('Model cannot be empty.');
+    throw new OptionConflictError(t('cli.errors.modelEmpty'));
   }
   if (!promptMode && opts.outputFormat !== undefined) {
-    throw new OptionConflictError('Output format is only supported in prompt mode.');
+    throw new OptionConflictError(t('cli.errors.outputFormatPromptOnly'));
   }
   if (promptMode && opts.yolo) {
-    throw new OptionConflictError('Cannot combine --prompt with --yolo.');
+    throw new OptionConflictError(t('cli.errors.cannotCombinePromptAndYolo'));
   }
   if (promptMode && opts.auto) {
-    throw new OptionConflictError('Cannot combine --prompt with --auto.');
+    throw new OptionConflictError(t('cli.errors.cannotCombinePromptAndAuto'));
   }
   if (promptMode && opts.plan) {
-    throw new OptionConflictError('Cannot combine --prompt with --plan.');
+    throw new OptionConflictError(t('cli.errors.cannotCombinePromptAndPlan'));
   }
   if (opts.agent !== undefined && opts.agent.trim().length === 0) {
     throw new OptionConflictError('Agent cannot be empty.');
   }
   if (opts.agentFiles.length > 1) {
-    throw new OptionConflictError('--agent-file may only be specified once.');
+    throw new OptionConflictError(t('cli.errors.agentFileOnlyOnce'));
   }
   if (opts.agentFiles.some((file) => file.trim().length === 0)) {
     throw new OptionConflictError('Agent file path cannot be empty.');
@@ -106,13 +108,13 @@ export function validateOptions(
     );
   }
   if (promptMode && opts.session === '') {
-    throw new OptionConflictError('Cannot use --session without an id in prompt mode.');
+    throw new OptionConflictError(t('cli.errors.sessionWithoutIdInPromptMode'));
   }
   if (opts.continue && opts.session !== undefined) {
-    throw new OptionConflictError('Cannot combine --continue, --session.');
+    throw new OptionConflictError(t('cli.errors.cannotCombineContinueAndSession'));
   }
   if (opts.yolo && opts.auto) {
-    throw new OptionConflictError('Cannot combine --yolo with --auto.');
+    throw new OptionConflictError(t('cli.errors.cannotCombineYoloAndAuto'));
   }
   // Validate `KIMI_MODEL_OUTPUT_FORMAT` eagerly in prompt mode so a typo fails
   // fast through the friendly `error:` path instead of mid-run.

apps/kimi-code/src/cli/options.ts

@@ -1,13 +1,11 @@
 /**
  * Minimal harness/session surface consumed by `kimi -p` (print mode).
  *
- * `run-prompt.ts` only needs a small subset of the SDK `KimiHarness` / `Session`
- * API. Coding the print-mode driver against these narrow interfaces — instead of
- * the concrete SDK classes — lets the same driver run on either the legacy
- * engine (`createKimiHarness`) or the default agent-core-v2 engine
- * (`createPromptHarnessV2`, selected unless `KIMI_CODE_LEGACY_FLAG` is truthy).
- * Both the legacy `KimiHarness` / `Session` and the v2 harness structurally
- * satisfy these interfaces, so no adapter wrappers are needed on the legacy path.
+ * The v2 print driver (`cli/v2/run-v2-print.ts`) talks to agent-core-v2's
+ * native DI services directly, so the print-mode path no longer goes through a
+ * `PromptHarness`-shaped SDK session. This module keeps the type-level view of
+ * that surface for reference; new print-mode code should target the native
+ * `ISessionScopeHandle` / `IAgentScopeHandle` interfaces instead.
  */
 
 import type {