@downcity/city 1.1.39 → 1.1.47

package/src/cli/shared/ManagedPluginRemote.ts

@@ -6,7 +6,6 @@
  * - 这里不负责命令注册，只负责 transport 调用与结果输出。
  */
 
-import { callAgentTransport } from "@downcity/agent";
 import { printResult } from "@/utils/cli/CliOutput.js";
 import type {
   PluginCliBaseOptions,
@@ -20,6 +19,7 @@ import {
   resolvePluginProjectRoot,
   validateAgentProjectRoot,
 } from "./PluginTargetSupport.js";
+import { callServer } from "@/process/daemon/Client.js";
 
 const PLUGIN_COMMAND_TIMEOUT_MS = 120_000;
 
@@ -52,7 +52,7 @@ export async function runManagedPluginListCommand(options: PluginCliBaseOptions)
     });
     return;
   }
-  const remote = await callAgentTransport<PluginStateListResponse>({
+  const remote = await callServer<PluginStateListResponse>({
     projectRoot,
     path: "/api/plugins/list",
     method: "GET",
@@ -117,7 +117,7 @@ export async function runManagedPluginControlCommand(params: {
     });
     return;
   }
-  const remote = await callAgentTransport<PluginControlResponse>({
+  const remote = await callServer<PluginControlResponse>({
     projectRoot,
     path: "/api/plugins/control",
     method: "POST",
@@ -187,7 +187,7 @@ export async function runManagedPluginCommandBridge(params: {
     });
     return;
   }
-  const remote = await callAgentTransport<PluginCommandResponse>({
+  const remote = await callServer<PluginCommandResponse>({
     projectRoot,
     path: "/api/plugins/command",
     method: "POST",

package/src/cli/shared/PluginTargetSupport.ts

@@ -14,7 +14,7 @@ import { getProfileMdPath, getDowncityJsonPath } from "@/config/Paths.js";
 import { listManagedAgentEntries } from "@/process/registry/CityRegistry.js";
 import { isCityRunning } from "@/process/registry/CityRuntime.js";
 import type { JsonValue } from "@downcity/agent";
-import { parsePort, resolveAgentName } from "./IndexSupport.js";
+import { parsePort, resolveAgentId } from "./IndexSupport.js";
 import { CliError } from "./CliError.js";
 import type { ActionScheduleJobStatus } from "@downcity/agent";
 import type { PluginCliBaseOptions } from "@downcity/agent";
@@ -126,13 +126,13 @@ export function resolveProjectRoot(pathInput?: string): string {
 }
 
 /**
- * 通过 agent 名称解析 projectRoot。
+ * 通过 agent id 解析 projectRoot。
  */
-export async function resolveProjectRootByAgentName(agentName: string): Promise<{
+export async function resolveProjectRootByAgentId(agentId: string): Promise<{
   projectRoot?: string;
   error?: string;
 }> {
-  const target = String(agentName || "").trim().toLowerCase();
+  const target = String(agentId || "").trim().toLowerCase();
   if (!target) {
     return { error: "--agent requires a non-empty value" };
   }
@@ -144,18 +144,18 @@ export async function resolveProjectRootByAgentName(agentName: string): Promise<
     .filter((root, index, all) => all.indexOf(root) === index)
     .filter((root) => {
       const byDirName = path.basename(root).toLowerCase() === target;
-      const byShipName = resolveAgentName(root).toLowerCase() === target;
-      return byDirName || byShipName;
+      const byProjectId = resolveAgentId(root).toLowerCase() === target;
+      return byDirName || byProjectId;
     });
 
   if (matchedRoots.length === 0) {
     return {
-      error: `Agent not found in managed agent registry: ${agentName}. Run "city agent list" to inspect names.`,
+      error: `Agent not found in managed agent registry: ${agentId}. Run "city agent list" to inspect ids.`,
     };
   }
   if (matchedRoots.length > 1) {
     return {
-      error: `Agent name is ambiguous: ${agentName}. Matched paths: ${matchedRoots.join(", ")}`,
+      error: `Agent id is ambiguous: ${agentId}. Matched paths: ${matchedRoots.join(", ")}`,
     };
   }
 
@@ -171,18 +171,18 @@ export async function resolvePluginProjectRoot(options: PluginCliBaseOptions): P
 }> {
   const explicitAgent = String(options.agent || "").trim();
   if (explicitAgent) {
-    return resolveProjectRootByAgentName(explicitAgent);
+    return resolveProjectRootByAgentId(explicitAgent);
   }
 
   const rawPath = String(options.path || ".").trim() || ".";
   // 关键点（中文）：在 agent shell 中，未显式传 --agent 且 path 走默认值时，
-  // 优先使用注入的 DC_AGENT_NAME 走 registry 解析，确保多 agent 下目标稳定。
+  // 优先使用注入的 DC_AGENT_ID 走 registry 解析，确保多 agent 下目标稳定。
   if (rawPath === ".") {
-    const envAgentName = String(process.env.DC_AGENT_NAME || "").trim();
-    if (envAgentName) {
-      const byName = await resolveProjectRootByAgentName(envAgentName);
-      if (byName.projectRoot) {
-        return byName;
+    const envAgentId = String(process.env.DC_AGENT_ID || "").trim();
+    if (envAgentId) {
+      const byId = await resolveProjectRootByAgentId(envAgentId);
+      if (byId.projectRoot) {
+        return byId;
       }
     }
   }
@@ -213,7 +213,7 @@ export async function resolvePluginScheduleProjectRoot(options: PluginCliBaseOpt
 }> {
   const explicitAgent = String(options.agent || "").trim();
   if (explicitAgent) {
-    return resolveProjectRootByAgentName(explicitAgent);
+    return resolveProjectRootByAgentId(explicitAgent);
   }
   return {
     projectRoot: resolveProjectRoot(options.path),
@@ -257,10 +257,10 @@ export function parseCommandPayload(raw?: string): JsonValue | undefined {
 export function addPluginTargetOptions(command: Command): Command {
   return command
     .option("--path <path>", "项目根目录（默认当前目录）", ".")
-    .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+    .option("--agent <id>", "agent id（从 managed agent registry 解析）")
     .option("--host <host>", "Server host（覆盖自动解析）")
     .option("--port <port>", "Server port（覆盖自动解析）", parsePort)
-    .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
+    .option("--token <token>", "覆盖 Bearer Token（按 HTTP daemon 调用时可选）")
     .option("--json [enabled]", "以 JSON 输出", parseBoolean, true);
 }
 
@@ -270,6 +270,6 @@ export function addPluginTargetOptions(command: Command): Command {
 export function addPluginScheduleOptions(command: Command): Command {
   return command
     .option("--path <path>", "项目根目录（默认当前目录）", ".")
-    .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+    .option("--agent <id>", "agent id（从 managed agent registry 解析）")
     .option("--json [enabled]", "以 JSON 输出", parseBoolean, true);
 }

package/src/cli/shared/Plugins.ts

@@ -621,10 +621,10 @@ export function registerPluginsCommand(program: Command): void {
     .command("status <pluginName>")
     .description("按 agent 目标查看托管 plugin 运行状态")
     .option("--path <path>", "项目根目录（默认当前目录）", ".")
-    .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+    .option("--agent <id>", "agent id（从 managed agent registry 解析）")
     .option("--host <host>", "Server host（覆盖自动解析）")
     .option("--port <port>", "Server port（覆盖自动解析）", parsePort)
-    .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
+    .option("--token <token>", "覆盖 Bearer Token（按 HTTP daemon 调用时可选）")
     .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
     .action(async (pluginName: string, opts: PluginCliBaseOptions) => {
       await runManagedPluginControlCommand({
@@ -638,10 +638,10 @@ export function registerPluginsCommand(program: Command): void {
     .command("start <pluginName>")
     .description("按 agent 目标启动托管 plugin")
     .option("--path <path>", "项目根目录（默认当前目录）", ".")
-    .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+    .option("--agent <id>", "agent id（从 managed agent registry 解析）")
     .option("--host <host>", "Server host（覆盖自动解析）")
     .option("--port <port>", "Server port（覆盖自动解析）", parsePort)
-    .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
+    .option("--token <token>", "覆盖 Bearer Token（按 HTTP daemon 调用时可选）")
     .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
     .action(async (pluginName: string, opts: PluginCliBaseOptions) => {
       await runManagedPluginControlCommand({
@@ -655,10 +655,10 @@ export function registerPluginsCommand(program: Command): void {
     .command("stop <pluginName>")
     .description("按 agent 目标停止托管 plugin")
     .option("--path <path>", "项目根目录（默认当前目录）", ".")
-    .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+    .option("--agent <id>", "agent id（从 managed agent registry 解析）")
     .option("--host <host>", "Server host（覆盖自动解析）")
     .option("--port <port>", "Server port（覆盖自动解析）", parsePort)
-    .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
+    .option("--token <token>", "覆盖 Bearer Token（按 HTTP daemon 调用时可选）")
     .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
     .action(async (pluginName: string, opts: PluginCliBaseOptions) => {
       await runManagedPluginControlCommand({
@@ -672,10 +672,10 @@ export function registerPluginsCommand(program: Command): void {
     .command("restart <pluginName>")
     .description("按 agent 目标重启托管 plugin")
     .option("--path <path>", "项目根目录（默认当前目录）", ".")
-    .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+    .option("--agent <id>", "agent id（从 managed agent registry 解析）")
     .option("--host <host>", "Server host（覆盖自动解析）")
     .option("--port <port>", "Server port（覆盖自动解析）", parsePort)
-    .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
+    .option("--token <token>", "覆盖 Bearer Token（按 HTTP daemon 调用时可选）")
     .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
     .action(async (pluginName: string, opts: PluginCliBaseOptions) => {
       await runManagedPluginControlCommand({
@@ -690,10 +690,10 @@ export function registerPluginsCommand(program: Command): void {
     .description("按 agent 目标转发托管 plugin command")
     .option("--payload <json>", "可选 payload（JSON 字符串或普通字符串）")
     .option("--path <path>", "项目根目录（默认当前目录）", ".")
-    .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+    .option("--agent <id>", "agent id（从 managed agent registry 解析）")
     .option("--host <host>", "Server host（覆盖自动解析）")
     .option("--port <port>", "Server port（覆盖自动解析）", parsePort)
-    .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
+    .option("--token <token>", "覆盖 Bearer Token（按 HTTP daemon 调用时可选）")
     .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
     .action(async (
       pluginName: string,

package/src/cli/shared/PublicHostEnv.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - `city start` 时自动探测公网 IPv4，并写入平台 Env 的 `DOWNCITY_PUBLIC_HOST`。
  * - 若部署环境已经注入 `DOWNCITY_PUBLIC_URL/HOST`，绝不覆盖。
- * - 写入平台 Env 后，后续 agent daemon 启动会通过 `context.globalEnv` 读取到该值。
+ * - 写入平台 Env 后，后续 city 宿主会在启动 Agent/模型运行时前显式读取并传入。
  */
 
 import { PlatformStore } from "@/platform/store/index.js";
@@ -50,7 +50,7 @@ async function resolvePublicIpv4FromNetwork(): Promise<string | null> {
 function readGlobalEnvFromStore(): Record<string, string> {
   const store = new PlatformStore();
   try {
-    return store.getGlobalEnvMapSync();
+    return store.getEnvMapSync();
   } catch {
     return {};
   } finally {

package/src/cli/shared/Terminal.ts

@@ -0,0 +1,24 @@
+/**
+ * City terminal 命令装配模块。
+ *
+ * 关键点（中文）
+ * - `city terminal` 承接原独立 manager 的交互式管理入口。
+ * - 这里仅负责把 terminal 挂到 city CLI 命令树，具体状态机仍在 terminal 模块内部。
+ */
+
+import type { Command } from "commander";
+import { runTerminalApp } from "@/terminal/app.js";
+import { createVersionBanner } from "./IndexSupport.js";
+
+/**
+ * 注册 `city terminal` 命令。
+ */
+export function registerTerminalCommand(program: Command, version: string): void {
+  program
+    .command("terminal [action]")
+    .description("打开 Downcity 服务终端（管理 infra/services server 与用户会话）")
+    .helpOption("--help", "display help for command")
+    .action(createVersionBanner(version, async (action?: string) => {
+      await runTerminalApp(action ? [action] : []);
+    }));
+}

package/src/config/DowncitySchema.ts

@@ -12,9 +12,8 @@ export const DOWNCITY_JSON_SCHEMA: JsonObject = {
       description:
         "JSON Schema reference for editor/IDE validation (e.g. ./.downcity/schema/downcity.schema.json).",
     },
-    name: { type: "string" },
+    id: { type: "string" },
     version: { type: "string" },
-    description: { type: "string" },
     start: {
       type: "object",
       additionalProperties: true,
@@ -29,70 +28,15 @@ export const DOWNCITY_JSON_SCHEMA: JsonObject = {
       properties: {
         type: {
           type: "string",
-          enum: ["api", "acp", "local"],
+          enum: ["api"],
         },
         modelId: {
           type: "string",
           description:
             "API 执行模式下绑定的平台全局模型 ID。",
         },
-        agent: {
-          type: "object",
-          additionalProperties: true,
-          properties: {
-            type: {
-              type: "string",
-              enum: ["codex", "claude", "kimi"],
-            },
-            command: { type: "string" },
-            args: {
-              type: "array",
-              items: { type: "string" },
-            },
-            env: {
-              type: "object",
-              additionalProperties: { type: "string" },
-            },
-          },
-          required: ["type"],
-        },
-        local: {
-          type: "null",
-          description:
-            "本地执行模式不再从 execution.local 读取配置；请改为使用 plugins.lmp。",
-        },
       },
-      required: ["type"],
-      allOf: [
-        {
-          if: {
-            properties: {
-              type: { const: "api" },
-            },
-          },
-          then: {
-            required: ["modelId"],
-          },
-        },
-        {
-          if: {
-            properties: {
-              type: { const: "acp" },
-            },
-          },
-          then: {
-            required: ["agent"],
-          },
-        },
-        {
-          if: {
-            properties: {
-              type: { const: "local" },
-            },
-          },
-          then: true,
-        },
-      ],
+      required: ["type", "modelId"],
     },
     sandbox: {
       type: "object",
@@ -256,44 +200,6 @@ export const DOWNCITY_JSON_SCHEMA: JsonObject = {
             },
           },
         },
-        lmp: {
-          type: "object",
-          additionalProperties: true,
-          properties: {
-            provider: {
-              type: "string",
-              enum: ["llama"],
-            },
-            model: {
-              type: "string",
-              description:
-                "当前激活的本地模型文件名或绝对路径；相对路径默认相对 plugins.lmp.modelsDir。",
-            },
-            modelsDir: {
-              type: "string",
-              description: "本地模型目录，默认 ~/.models。",
-            },
-            command: {
-              type: "string",
-              description: "llama-server 可执行命令，默认 llama-server。",
-            },
-            args: {
-              type: "array",
-              items: { type: "string" },
-            },
-            host: { type: "string" },
-            port: { type: "integer", minimum: 1, maximum: 65535 },
-            contextSize: { type: "integer", minimum: 512, maximum: 1048576 },
-            gpuLayers: { type: "integer", minimum: -1, maximum: 65535 },
-            autoStart: { type: "boolean" },
-            installedModels: {
-              type: "array",
-              items: {
-                type: "string",
-              },
-            },
-          },
-        },
       },
     },
     llm: {
@@ -351,21 +257,5 @@ export const DOWNCITY_JSON_SCHEMA: JsonObject = {
       },
       required: ["providers", "models"],
     },
-    context: {
-      type: "object",
-      additionalProperties: true,
-      properties: {
-        messages: {
-          type: "object",
-          additionalProperties: true,
-          properties: {
-            keepLastMessages: { type: "integer", minimum: 6, maximum: 5000 },
-            maxInputTokensApprox: { type: "integer", minimum: 2000, maximum: 200000 },
-            archiveOnCompact: { type: "boolean" },
-            compactRatio: { type: "number", minimum: 0.1, maximum: 0.9 },
-          },
-        },
-      },
-    },
   },
 };

package/src/config/Paths.ts

@@ -15,16 +15,12 @@ import path from "path";
  * - 统一使用大写文件名：`PROFILE.md`。
  * - 与 SOUL 一起作为静态 prompt 入口。
  */
-export const PROFILE_MD_FILE_CANDIDATES = ["PROFILE.md"] as const;
+const PROFILE_MD_FILE_CANDIDATES = ["PROFILE.md"] as const;
 
 export function getProfileMdPath(cwd: string): string {
   return path.join(cwd, PROFILE_MD_FILE_CANDIDATES[0]);
 }
 
-export function getProfileMdCandidatePaths(cwd: string): string[] {
-  return PROFILE_MD_FILE_CANDIDATES.map((filename) => path.join(cwd, filename));
-}
-
 /**
  * SOUL.md 候选文件名（按优先级从高到低）。
  *
@@ -32,16 +28,12 @@ export function getProfileMdCandidatePaths(cwd: string): string[] {
  * - 统一使用大写文件名：`SOUL.md`。
  * - 统一由 Paths 模块暴露，避免调用方散落硬编码。
  */
-export const SOUL_MD_FILE_CANDIDATES = ["SOUL.md"] as const;
+const SOUL_MD_FILE_CANDIDATES = ["SOUL.md"] as const;
 
 export function getSoulMdPath(cwd: string): string {
   return path.join(cwd, SOUL_MD_FILE_CANDIDATES[0]);
 }
 
-export function getSoulMdCandidatePaths(cwd: string): string[] {
-  return SOUL_MD_FILE_CANDIDATES.map((filename) => path.join(cwd, filename));
-}
-
 export function getDowncityJsonPath(cwd: string): string {
   return path.join(cwd, "downcity.json");
 }
@@ -54,37 +46,21 @@ export function getDowncitySchemaPath(cwd: string): string {
   return path.join(getDowncityDirPath(cwd), "schema", "downcity.schema.json");
 }
 
-export function getDowncityConfigDirPath(cwd: string): string {
-  return path.join(getDowncityDirPath(cwd), "config");
-}
-
-export function getLogsDirPath(cwd: string): string {
-  return path.join(getDowncityDirPath(cwd), "logs");
-}
-
 export function getCacheDirPath(cwd: string): string {
   return path.join(getDowncityDirPath(cwd), ".cache");
 }
 
-export function getDowncityProfileDirPath(cwd: string): string {
+function getDowncityProfileDirPath(cwd: string): string {
   return path.join(getDowncityDirPath(cwd), "profile");
 }
 
-export function getDowncityProfilePrimaryPath(cwd: string): string {
-  return path.join(getDowncityProfileDirPath(cwd), "Primary.md");
-}
-
-export function getDowncityProfileOtherPath(cwd: string): string {
-  return path.join(getDowncityProfileDirPath(cwd), "other.md");
-}
-
 /**
  * Memory 根目录（V2）。
  *
  * 关键点（中文）
  * - `.downcity/memory` 为跨会话记忆目录。
  */
-export function getDowncityMemoryDirPath(cwd: string): string {
+function getDowncityMemoryDirPath(cwd: string): string {
   return path.join(getDowncityDirPath(cwd), "memory");
 }
 
@@ -116,19 +92,11 @@ export function getDowncityMemoryDailyPath(cwd: string, date: string): string {
  * 关键点（中文）
  * - 调度任务属于项目 runtime 本地状态，因此放在项目 `.downcity/` 下。
  */
-export function getDowncityScheduleDbPath(cwd: string): string {
-  return path.join(getDowncityDirPath(cwd), "schedule.jsonl");
-}
-
-export function getDowncityDataDirPath(cwd: string): string {
-  return path.join(getDowncityDirPath(cwd), "data");
-}
-
-export function getDowncityAgentsRootDirPath(cwd: string): string {
+function getDowncityAgentsRootDirPath(cwd: string): string {
   return path.join(getDowncityDirPath(cwd), "agents");
 }
 
-export function getDowncityAgentDirPath(cwd: string, agentId: string): string {
+function getDowncityAgentDirPath(cwd: string, agentId: string): string {
   return path.join(
     getDowncityAgentsRootDirPath(cwd),
     encodeURIComponent(String(agentId || "").trim()),
@@ -168,29 +136,7 @@ export function getDowncitySessionMessagesDirPath(
   return path.join(getDowncitySessionDirPath(cwd, agentId, sessionId), "messages");
 }
 
-export function getDowncitySessionMessagesPath(
-  cwd: string,
-  agentId: string,
-  sessionId: string,
-): string {
-  return path.join(
-    getDowncitySessionMessagesDirPath(cwd, agentId, sessionId),
-    "messages.jsonl",
-  );
-}
-
-export function getDowncitySessionHistoryMetaPath(
-  cwd: string,
-  agentId: string,
-  sessionId: string,
-): string {
-  return path.join(
-    getDowncitySessionMessagesDirPath(cwd, agentId, sessionId),
-    "meta.json",
-  );
-}
-
-export function getDowncitySessionMessagesArchiveDirPath(
+function getDowncitySessionMessagesArchiveDirPath(
   cwd: string,
   agentId: string,
   sessionId: string,
@@ -201,26 +147,6 @@ export function getDowncitySessionMessagesArchiveDirPath(
   );
 }
 
-export function getDowncitySessionMessagesArchivePath(
-  cwd: string,
-  agentId: string,
-  sessionId: string,
-  archiveId: string,
-): string {
-  return path.join(
-    getDowncitySessionMessagesArchiveDirPath(cwd, agentId, sessionId),
-    `${encodeURIComponent(String(archiveId || "").trim())}.json`,
-  );
-}
-
-export function getDowncityPublicDirPath(cwd: string): string {
-  return path.join(getDowncityDirPath(cwd), "public");
-}
-
-export function getDowncityTasksDirPath(cwd: string): string {
-  return path.join(getDowncityDirPath(cwd), "task");
-}
-
 export function getDowncityDebugDirPath(cwd: string): string {
   return path.join(getDowncityDirPath(cwd), ".debug");
 }
@@ -232,7 +158,7 @@ export function getDowncityDebugDirPath(cwd: string): string {
  * - 该目录存放 `sessionId -> chat` 的最近映射快照
  * - 与 core session messages 分离，避免把平台路由细节耦合进 core
  */
-export function getDowncityChatDirPath(cwd: string): string {
+function getDowncityChatDirPath(cwd: string): string {
   return path.join(getDowncityDirPath(cwd), "chat");
 }
 
@@ -257,17 +183,10 @@ export function getDowncityChannelMetaPath(cwd: string): string {
   return path.join(getDowncityChannelDirPath(cwd), "meta.json");
 }
 
-export function getDowncityChatMetaDirPath(cwd: string): string {
+function getDowncityChatMetaDirPath(cwd: string): string {
   return path.join(getDowncityChatDirPath(cwd), "meta");
 }
 
-export function getDowncityChatMetaPath(cwd: string, sessionId: string): string {
-  return path.join(
-    getDowncityChatMetaDirPath(cwd),
-    `${encodeURIComponent(String(sessionId || "").trim())}.json`,
-  );
-}
-
 /**
  * Chat 会话目录（按 sessionId 组织）。
  *

package/src/control/ControlGateway.ts

@@ -306,13 +306,13 @@ export class ControlGateway {
   }
 
   private async initializeAgentProject(projectRoot: string, initialization: {
-    agentName?: unknown;
+    id?: unknown;
     modelId?: unknown;
     forceOverwriteShipJson?: unknown;
   }): Promise<AgentProjectInitializationResult> {
     return initializePlatformAgentProject({
       projectRoot,
-      agentName: initialization.agentName,
+      id: initialization.id,
       modelId: initialization.modelId,
       forceOverwriteShipJson: initialization.forceOverwriteShipJson,
     });
@@ -321,7 +321,7 @@ export class ControlGateway {
   private async startAgentByProjectRoot(projectRoot: string, options?: {
     initializeIfNeeded?: boolean;
     initialization?: {
-      agentName?: unknown;
+      id?: unknown;
       modelId?: unknown;
       forceOverwriteShipJson?: unknown;
     };