@downcity/agent 1.1.14 → 1.1.17

package/src/plugin/builtins/auth/runtime/AuthorizationPolicy.ts

@@ -7,7 +7,7 @@
  */
 
 import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
-import type { AgentPlatformRuntime } from "@/types/host/AgentHost.js";
+import type { AgentPlatformRuntime } from "@/types/runtime/host/AgentHost.js";
 import type {
   ChatAuthorizationConfig,
   ChatAuthorizationChannel,

package/src/plugin/builtins/voice/Config.ts

@@ -7,7 +7,7 @@
  */
 
 import type { VoicePluginConfig } from "@/plugin/builtins/voice/types/VoicePlugin.js";
-import type { AgentPluginConfigRuntime } from "@/types/host/AgentHost.js";
+import type { AgentPluginConfigRuntime } from "@/types/runtime/host/AgentHost.js";
 import type { JsonObject, JsonValue } from "@/types/common/Json.js";
 
 /**

package/src/plugin/builtins/workboard/runtime/Collector.ts

@@ -8,7 +8,7 @@
 
 import { listTaskDefinitions } from "@/service/builtins/task/Action.js";
 import { listServiceStates } from "@/service/core/Manager.js";
-import { listControlSessionSummaries } from "@/server/http/control/SessionSummaryStore.js";
+import { listControlSessionSummaries } from "@/runtime/server/http/control/SessionSummaryStore.js";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { WorkboardSnapshot } from "@/plugin/builtins/workboard/types/Workboard.js";
 import {

package/src/plugin/builtins/workboard/runtime/Normalizer.ts

@@ -6,7 +6,7 @@
  * - 所有会泄漏上下文的字段都必须在这里截断或抽象。
  */
 
-import type { ControlSessionSummary } from "@/server/http/control/types/ControlViewData.js";
+import type { ControlSessionSummary } from "@/runtime/server/http/control/types/ControlViewData.js";
 import type { ServiceStateSnapshot } from "@/service/types/ServiceState.js";
 import type { TaskListResponse } from "@/service/builtins/task/types/TaskCommand.js";
 import type {

package/src/plugin/core/HttpRoutes.ts

@@ -9,7 +9,7 @@
 import type { Hono } from "hono";
 import { PLUGINS } from "@/plugin/core/Plugins.js";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
-import type { AuthRoutePolicy } from "@/types/auth/AuthRoute.js";
+import type { AuthRoutePolicy } from "@/types/runtime/auth/AuthRoute.js";
 
 function dedupeAuthPolicies(policies: AuthRoutePolicy[]): AuthRoutePolicy[] {
   const records = new Map<string, AuthRoutePolicy>();

package/src/plugin/core/LocalExecution.ts

@@ -15,9 +15,9 @@ import { findBuiltinPlugin, listStaticPluginViews } from "@/plugin/core/Catalog.
 import {
   createAgentPathRuntime,
   createAgentPluginConfigRuntime,
-} from "@/host/runtime/AgentHostRuntime.js";
+} from "@/runtime/host/AgentHostRuntime.js";
 import type { JsonValue } from "@/types/common/Json.js";
-import type { AgentPlatformRuntime } from "@/types/host/AgentHost.js";
+import type { AgentPlatformRuntime } from "@/types/runtime/host/AgentHost.js";
 import type {
   PluginActionResult,
   PluginAvailability,

package/src/plugin/core/PluginManager.ts

@@ -13,7 +13,7 @@ import { isPluginEnabled } from "@/plugin/core/Activation.js";
 import { HookRegistry } from "@/plugin/core/HookRegistry.js";
 import { PluginRegistry } from "@/plugin/core/PluginRegistry.js";
 import { registerBuiltinPlugins } from "@/plugin/core/Plugins.js";
-import { getPluginRuntimeContextResolver } from "@/host/runtime/PluginRuntime.js";
+import { getPluginRuntimeContextResolver } from "@/runtime/host/PluginRuntime.js";
 
 let pluginManager: PluginRegistry | null = null;
 

package/src/plugin/types/Plugin.ts

@@ -13,7 +13,7 @@ import type {
   AgentPathRuntime,
   AgentPlatformRuntime,
   AgentPluginConfigRuntime,
-} from "@/types/host/AgentHost.js";
+} from "@/types/runtime/host/AgentHost.js";
 import type {
   AgentContext,
   StructuredConfig,
@@ -21,7 +21,7 @@ import type {
 import type { Logger } from "@/utils/logger/Logger.js";
 import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
 import type { JsonObject, JsonValue } from "@/types/common/Json.js";
-import type { AuthRoutePolicy } from "@/types/auth/AuthRoute.js";
+import type { AuthRoutePolicy } from "@/types/runtime/auth/AuthRoute.js";
 
 /**
  * Plugin 命令执行上下文。

package/src/{host/runtime → runtime/host}/AgentHostRuntime.ts

@@ -22,7 +22,7 @@ import { persistProjectPluginConfig } from "@/plugin/core/ProjectConfigStore.js"
 import type {
   AgentPathRuntime,
   AgentPluginConfigRuntime,
-} from "@/types/host/AgentHost.js";
+} from "@/types/runtime/host/AgentHost.js";
 import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
 
 /**

package/src/{host → runtime/host}/daemon/Client.ts

@@ -15,8 +15,8 @@ import {
 import {
   formatCliBearerHeaderValue,
   resolveCliAuthToken,
-} from "@/server/http/auth/CliAuthStateStore.js";
-import { getDaemonMetaPath } from "@/host/daemon/Paths.js";
+} from "@/runtime/server/http/auth/CliAuthStateStore.js";
+import { getDaemonMetaPath } from "@/runtime/host/daemon/Paths.js";
 import type { JsonObject, JsonValue } from "@/types/common/Json.js";
 
 /**

package/src/{host → runtime/host}/daemon/Paths.ts

@@ -12,7 +12,7 @@ import {
   DAEMON_LOG_FILENAME,
   DAEMON_META_FILENAME,
   DAEMON_PID_FILENAME,
-} from "@/types/daemon/Daemon.js";
+} from "@/types/runtime/daemon/Daemon.js";
 
 /**
  * 计算 daemon pid 文件路径。

package/src/{host → runtime/host}/daemon/ProjectSetup.ts

@@ -9,11 +9,10 @@
 import fs from "fs-extra";
 import path from "node:path";
 import { loadDowncityConfig } from "@/config/Config.js";
-import type { AgentPlatformRuntime } from "@/types/host/AgentHost.js";
 import {
-  readProjectExecutionBinding,
   readProjectPrimaryModelId,
-} from "@/project/ProjectExecutionBinding.js";
+} from "@/config/ExecutionBinding.js";
+import type { AgentPlatformRuntime } from "@/types/runtime/host/AgentHost.js";
 import {
   getCacheDirPath,
   getLogsDirPath,

package/src/{sandbox → runtime/sandbox}/MacOsSeatbeltSandbox.ts

@@ -13,7 +13,7 @@ import fs from "fs-extra";
 import type {
   SandboxSpawnParams,
   SandboxSpawnResult,
-} from "@/sandbox/types/SandboxRuntime.js";
+} from "@/runtime/sandbox/types/SandboxRuntime.js";
 
 const DEFAULT_PATH_VALUE =
   "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin";

package/src/{sandbox → runtime/sandbox}/SandboxConfigResolver.ts

@@ -9,7 +9,7 @@
 
 import path from "node:path";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
-import type { ResolvedSandboxConfig } from "@/sandbox/types/SandboxRuntime.js";
+import type { ResolvedSandboxConfig } from "@/runtime/sandbox/types/SandboxRuntime.js";
 
 const DEFAULT_ENV_ALLOWLIST = [
   "PATH",

package/src/{sandbox → runtime/sandbox}/SandboxRunner.ts

@@ -8,9 +8,9 @@
  */
 
 import type { AgentContext } from "@/core/AgentContextTypes.js";
-import type { SandboxSpawnResult } from "@/sandbox/types/SandboxRuntime.js";
-import { resolveSandboxConfig, resolveSandboxCwd } from "@/sandbox/SandboxConfigResolver.js";
-import { spawnMacOsSeatbeltSandbox } from "@/sandbox/MacOsSeatbeltSandbox.js";
+import type { SandboxSpawnResult } from "@/runtime/sandbox/types/SandboxRuntime.js";
+import { resolveSandboxConfig, resolveSandboxCwd } from "@/runtime/sandbox/SandboxConfigResolver.js";
+import { spawnMacOsSeatbeltSandbox } from "@/runtime/sandbox/MacOsSeatbeltSandbox.js";
 
 /**
  * 启动 shell 子进程。

package/src/{sandbox → runtime/sandbox}/types/SandboxRuntime.ts

@@ -8,8 +8,8 @@
  */
 
 import type { ChildProcessWithoutNullStreams } from "node:child_process";
-import type { SandboxConfig } from "@/sandbox/types/Sandbox.js";
-import type { SandboxNetworkMode } from "@/sandbox/types/Sandbox.js";
+import type { SandboxConfig } from "@/runtime/sandbox/types/Sandbox.js";
+import type { SandboxNetworkMode } from "@/runtime/sandbox/types/Sandbox.js";
 
 /**
  * sandbox 会话状态。

package/src/{server → runtime/server}/http/Server.ts

@@ -12,14 +12,14 @@ import { cors } from "hono/cors";
 import { logger } from "hono/logger";
 import http from "node:http";
 import { logger as serverLogger } from "@/utils/logger/Logger.js";
-import { createExecuteRouter } from "@/server/http/execute/execute.js";
-import { healthRouter } from "@/server/http/health/health.js";
+import { createExecuteRouter } from "@/runtime/server/http/execute/execute.js";
+import { healthRouter } from "@/runtime/server/http/health/health.js";
 import {
   createServicesRouter,
-} from "@/server/http/services/services.js";
-import { createPluginsRouter } from "@/server/http/plugins/plugins.js";
-import { createStaticRouter } from "@/server/http/static/static.js";
-import { createControlRouter } from "@/server/http/control/ControlRouter.js";
+} from "@/runtime/server/http/services/services.js";
+import { createPluginsRouter } from "@/runtime/server/http/plugins/plugins.js";
+import { createStaticRouter } from "@/runtime/server/http/static/static.js";
+import { createControlRouter } from "@/runtime/server/http/control/ControlRouter.js";
 import {
   registerBuiltinPluginHttpRoutes,
 } from "@/plugin/core/HttpRoutes.js";

package/src/{server → runtime/server}/http/control/AuthControlService.ts

@@ -9,7 +9,7 @@
 
 import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { JsonObject } from "@/types/common/Json.js";
-import type { AuthControlPayload } from "@/server/http/control/types/AuthControl.js";
+import type { AuthControlPayload } from "@/runtime/server/http/control/types/AuthControl.js";
 import type {
   AuthSetUserRolePayload,
   AuthWriteConfigPayload,

package/src/{server → runtime/server}/http/control/ControlApiRoutes.ts

@@ -7,12 +7,12 @@
  * - 单 agent control API 统一暴露在 `/api/control/*` 下。
  */
 
-import type { ControlRouteRegistrationParams } from "@/server/http/control/types/ControlRoutes.js";
-import { registerControlAuthorizationRoutes } from "@/server/http/control/ControlAuthorizationRoutes.js";
-import { registerControlSessionRoutes } from "@/server/http/control/SessionRoutes.js";
-import { registerControlModelRoutes } from "@/server/http/control/ModelRoutes.js";
-import { registerControlOverviewRoutes } from "@/server/http/control/OverviewRoutes.js";
-import { registerControlTaskRoutes } from "@/server/http/control/TaskRoutes.js";
+import type { ControlRouteRegistrationParams } from "@/runtime/server/http/control/types/ControlRoutes.js";
+import { registerControlAuthorizationRoutes } from "@/runtime/server/http/control/ControlAuthorizationRoutes.js";
+import { registerControlSessionRoutes } from "@/runtime/server/http/control/SessionRoutes.js";
+import { registerControlModelRoutes } from "@/runtime/server/http/control/ModelRoutes.js";
+import { registerControlOverviewRoutes } from "@/runtime/server/http/control/OverviewRoutes.js";
+import { registerControlTaskRoutes } from "@/runtime/server/http/control/TaskRoutes.js";
 
 /**
  * 注册单 agent control API 路由。

package/src/{server → runtime/server}/http/control/ControlAuthorizationRoutes.ts

@@ -12,14 +12,14 @@ import {
   readAuthControlPayload,
   setAuthControlUserRole,
   writeAuthControlConfig,
-} from "@/server/http/control/AuthControlService.js";
+} from "@/runtime/server/http/control/AuthControlService.js";
 import {
   isChatAuthorizationChannel,
   type AuthSetUserRolePayload,
   type ChatAuthorizationConfig,
 } from "@/plugin/builtins/auth/types/AuthPlugin.js";
 import type { ChatAuthorizationChannel } from "@/plugin/builtins/auth/types/AuthPlugin.js";
-import { buildControlRouteAliases } from "@/server/http/control/CommonHelpers.js";
+import { buildControlRouteAliases } from "@/runtime/server/http/control/CommonHelpers.js";
 
 function normalizeChatChannel(value: unknown): ChatAuthorizationChannel | null {
   const text = String(value || "").trim().toLowerCase();

package/src/{server → runtime/server}/http/control/ControlRouter.ts

@@ -15,7 +15,7 @@
 import { Hono } from "hono";
 import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
-import { registerControlApiRoutes } from "@/server/http/control/ControlApiRoutes.js";
+import { registerControlApiRoutes } from "@/runtime/server/http/control/ControlApiRoutes.js";
 
 /**
  * control router 参数。

package/src/{server → runtime/server}/http/control/ExecuteBySession.ts

@@ -9,7 +9,7 @@
 import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { JsonObject } from "@/types/common/Json.js";
-import type { ControlSessionExecuteAttachmentInput } from "@/server/http/control/types/ControlSessionExecute.js";
+import type { ControlSessionExecuteAttachmentInput } from "@/runtime/server/http/control/types/ControlSessionExecute.js";
 import { drainDeferredPersistedUserMessages } from "@session/SessionRunScope.js";
 import { resolveChatQueueStore } from "@/service/builtins/chat/runtime/ChatQueue.js";
 import { resolveDispatchTargetByChatKey } from "@/service/builtins/chat/runtime/ChatkeySend.js";

package/src/{server → runtime/server}/http/control/ExecuteInput.ts

@@ -13,7 +13,7 @@ import { renderChatMessageFileTag } from "@/service/builtins/chat/runtime/ChatMe
 import type {
   ControlSessionExecuteAttachmentInput,
   ControlSessionExecuteAttachmentType,
-} from "@/server/http/control/types/ControlSessionExecute.js";
+} from "@/runtime/server/http/control/types/ControlSessionExecute.js";
 
 const EXECUTE_ATTACHMENT_MAX_COUNT = 8;
 const EXECUTE_ATTACHMENT_MAX_BYTES = 2 * 1024 * 1024;

package/src/{server → runtime/server}/http/control/MessageTimeline.ts

@@ -19,7 +19,7 @@ import type {
 } from "@/session/types/SessionMessages.js";
 import { pickLastSuccessfulChatSendText } from "@/service/builtins/chat/runtime/UserVisibleText.js";
 import { extractToolCallsFromUiMessage } from "@/service/builtins/chat/runtime/UIMessageTransformer.js";
-import type { ControlTimelineEvent, ControlTimelineRole } from "@/server/http/control/types/ControlViewData.js";
+import type { ControlTimelineEvent, ControlTimelineRole } from "@/runtime/server/http/control/types/ControlViewData.js";
 import { truncateText } from "./CommonHelpers.js";
 
 type AnyUiPart = UIMessagePart<Record<string, never>, Record<string, never>>;

package/src/{server → runtime/server}/http/control/ModelRoutes.ts

@@ -8,8 +8,8 @@
 
 import fs from "fs-extra";
 import { getDowncityJsonPath } from "@/config/Paths.js";
-import type { ControlRouteRegistrationParams } from "@/server/http/control/types/ControlRoutes.js";
-import { buildControlRouteAliases } from "@/server/http/control/CommonHelpers.js";
+import type { ControlRouteRegistrationParams } from "@/runtime/server/http/control/types/ControlRoutes.js";
+import { buildControlRouteAliases } from "@/runtime/server/http/control/CommonHelpers.js";
 
 /**
  * 注册模型相关路由。

package/src/{server → runtime/server}/http/control/OverviewRoutes.ts

@@ -13,7 +13,7 @@ import { listServiceStates } from "@/service/core/Manager.js";
 import { listTaskDefinitions } from "@/service/builtins/task/Action.js";
 import { buildControlRouteAliases, toLimit } from "./CommonHelpers.js";
 import { listControlSessionSummaries, readRecentLogs } from "./Helpers.js";
-import type { ControlRouteRegistrationParams } from "@/server/http/control/types/ControlRoutes.js";
+import type { ControlRouteRegistrationParams } from "@/runtime/server/http/control/types/ControlRoutes.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);

package/src/{server → runtime/server}/http/control/SessionRoutes.ts

@@ -17,8 +17,8 @@ import {
   getDowncitySessionMessagesArchivePath,
   getDowncitySessionMessagesPath,
 } from "@/config/Paths.js";
-import type { ControlSessionExecuteRequestBody } from "@/server/http/control/types/ControlSessionExecute.js";
-import type { ControlRouteRegistrationParams } from "@/server/http/control/types/ControlRoutes.js";
+import type { ControlSessionExecuteRequestBody } from "@/runtime/server/http/control/types/ControlSessionExecute.js";
+import type { ControlRouteRegistrationParams } from "@/runtime/server/http/control/types/ControlRoutes.js";
 import {
   buildControlRouteAliases,
   decodeMaybe,

package/src/{server → runtime/server}/http/control/SessionSummaryStore.ts

@@ -13,7 +13,7 @@ import {
   getDowncitySessionRootDirPath,
 } from "@/config/Paths.js";
 import { readChatMetaBySessionId } from "@/service/builtins/chat/runtime/ChatMetaStore.js";
-import type { ControlSessionSummary } from "@/server/http/control/types/ControlViewData.js";
+import type { ControlSessionSummary } from "@/runtime/server/http/control/types/ControlViewData.js";
 import { decodeMaybe, truncateText } from "./CommonHelpers.js";
 import { loadSessionMessagesFromFile, resolveUiMessagePreview } from "./MessageTimeline.js";
 

package/src/{server → runtime/server}/http/control/TaskRoutes.ts

@@ -12,7 +12,7 @@ import { getDowncityTasksDirPath } from "@/config/Paths.js";
 import { runServiceCommand } from "@/service/core/Manager.js";
 import { listTaskDefinitions } from "@/service/builtins/task/Action.js";
 import { resolveTaskIdByTitle } from "@/service/builtins/task/runtime/Store.js";
-import type { ControlRouteRegistrationParams } from "@/server/http/control/types/ControlRoutes.js";
+import type { ControlRouteRegistrationParams } from "@/runtime/server/http/control/types/ControlRoutes.js";
 import {
   buildControlRouteAliases,
   decodeMaybe,

package/src/{server → runtime/server}/http/control/TaskStore.ts

@@ -14,7 +14,7 @@ import type {
   ControlLogEntry,
   ControlTaskRunDetail,
   ControlTaskRunSummary,
-} from "@/server/http/control/types/ControlViewData.js";
+} from "@/runtime/server/http/control/types/ControlViewData.js";
 import { truncateText } from "./CommonHelpers.js";
 import { loadSessionMessagesFromFile, toUiMessageTimeline } from "./MessageTimeline.js";
 

package/src/{server → runtime/server}/rpc/Server.ts

@@ -13,8 +13,8 @@ import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { AgentCore } from "@/core/AgentCore.js";
 import type { JsonValue } from "@/types/common/Json.js";
-import type { LocalRpcRequest, LocalRpcResponse, LocalRpcServerHandle } from "@/types/rpc/LocalRpc.js";
-import type { ControlSessionExecuteRequestBody } from "@/server/http/control/types/ControlSessionExecute.js";
+import type { LocalRpcRequest, LocalRpcResponse, LocalRpcServerHandle } from "@/types/runtime/rpc/LocalRpc.js";
+import type { ControlSessionExecuteRequestBody } from "@/runtime/server/http/control/types/ControlSessionExecute.js";
 import type {
   PluginActionResponse,
   PluginAvailabilityResponse,
@@ -29,8 +29,8 @@ import type {
 import { listServiceStates, controlServiceState } from "@/service/core/ServiceStateController.js";
 import { runServiceCommand } from "@/service/core/ServiceActionRunner.js";
 import { parseServiceCommandRequestBody } from "@/service/core/ServiceCommandRequest.js";
-import { executeBySessionId } from "@/server/http/control/ExecuteBySession.js";
-import { getLocalRpcEndpoint } from "@/transport/rpc/Paths.js";
+import { executeBySessionId } from "@/runtime/server/http/control/ExecuteBySession.js";
+import { getLocalRpcEndpoint } from "@/runtime/transport/rpc/Paths.js";
 
 async function isSocketEndpointActive(endpoint: string): Promise<boolean> {
   return await new Promise<boolean>((resolve) => {

package/src/{transport → runtime/transport}/rpc/Client.ts

@@ -11,8 +11,8 @@ import { nanoid } from "nanoid";
 import type {
   DaemonJsonApiCallParams,
   DaemonJsonApiCallResult,
-} from "@/host/daemon/Api.js";
-import type { LocalRpcRequest, LocalRpcResponse } from "@/types/rpc/LocalRpc.js";
+} from "@/runtime/host/daemon/Api.js";
+import type { LocalRpcRequest, LocalRpcResponse } from "@/types/runtime/rpc/LocalRpc.js";
 import { getLocalRpcEndpoint } from "./Paths.js";
 
 const LOCAL_RPC_TIMEOUT_MS = 5_000;

package/src/{transport → runtime/transport}/rpc/Transport.ts

@@ -10,8 +10,8 @@
 import type {
   DaemonJsonApiCallParams,
   DaemonJsonApiCallResult,
-} from "@/host/daemon/Api.js";
-import { callServer } from "@/host/daemon/Client.js";
+} from "@/runtime/host/daemon/Api.js";
+import { callServer } from "@/runtime/host/daemon/Client.js";
 import { callLocalServer } from "./Client.js";
 
 /**

package/src/sdk/Agent.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - `Agent` 现在是实例外观层，长期运行状态下沉到 `AgentCore`。
  * - session、HTTP、RPC、service lifecycle 都按需异步初始化。
- * - `start/stop` 负责统一收口当前 agent 实例的生命周期。
+ * - `start/stop` 是唯一公开的长期运行生命周期入口。
  */
 
 import type { Tool } from "ai";
@@ -19,13 +19,16 @@ import type {
   AgentStartOptions,
   AgentStartResult,
   AgentStopResult,
+  AgentHttpBinding,
+  AgentHttpStartOptions,
+  AgentRpcBinding,
   AgentSessionMetadata,
 } from "@/sdk/AgentSdkTypes.js";
 import { Session } from "@/sdk/Session.js";
-import { SdkAgentHttpServer } from "@/sdk/HttpServer.js";
-import { SdkAgentRpcServer } from "@/sdk/RpcServer.js";
 import { AgentCore } from "@/core/AgentCore.js";
 import { startAllServices, stopAllServices } from "@/service/core/Manager.js";
+import { startServer } from "@/runtime/server/http/Server.js";
+import { startLocalRpcServer } from "@/runtime/server/rpc/Server.js";
 
 /**
  * SDK 本地 Agent。
@@ -35,12 +38,12 @@ export class Agent {
   readonly id: string;
   readonly path: string;
   readonly tools: Record<string, Tool>;
-  readonly http: SdkAgentHttpServer;
-  readonly rpc: SdkAgentRpcServer;
   readonly services: Map<string, BaseService>;
   readonly plugins: PluginPort;
   private servicesStarted = false;
   private startPromise: Promise<AgentStartResult> | null = null;
+  private httpBinding: AgentHttpBinding | null = null;
+  private rpcBinding: AgentRpcBinding | null = null;
 
   constructor(options: AgentOptions) {
     this.core = new AgentCore(options);
@@ -49,8 +52,6 @@ export class Agent {
     this.tools = this.core.tools;
     this.services = this.core.services;
     this.plugins = this.core.plugins;
-    this.http = new SdkAgentHttpServer(this);
-    this.rpc = new SdkAgentRpcServer(this);
   }
 
   /**
@@ -100,10 +101,10 @@ export class Agent {
       const httpBinding =
         options?.http === false || options?.http === undefined
           ? undefined
-          : await this.http.start(options.http);
+          : await this.startHttp(options.http);
       const rpcBinding =
         options?.rpc === true
-          ? await this.rpc.start()
+          ? await this.startRpc()
           : undefined;
 
       return {
@@ -125,8 +126,8 @@ export class Agent {
    */
   async stop(): Promise<AgentStopResult> {
     const servicesStarted = this.servicesStarted;
-    const rpcStarted = this.rpc.isStarted();
-    const httpStarted = this.http.isStarted();
+    const rpcStarted = this.rpcBinding !== null;
+    const httpStarted = this.httpBinding !== null;
 
     if (servicesStarted) {
       await stopAllServices(this.getContext());
@@ -134,11 +135,11 @@ export class Agent {
     }
 
     if (rpcStarted) {
-      await this.rpc.stop();
+      await this.stopRpc();
     }
 
     if (httpStarted) {
-      await this.http.stop();
+      await this.stopHttp();
     }
 
     this.startPromise = null;
@@ -174,4 +175,69 @@ export class Agent {
   getContext(): AgentContext {
     return this.core.getContext();
   }
+
+  /**
+   * 启动当前 agent 的 HTTP server。
+   */
+  private async startHttp(
+    options?: AgentHttpStartOptions,
+  ): Promise<AgentHttpBinding> {
+    if (this.httpBinding) {
+      return this.httpBinding;
+    }
+    const host = String(options?.host || "127.0.0.1").trim() || "127.0.0.1";
+    const port =
+      typeof options?.port === "number" && Number.isInteger(options.port)
+        ? options.port
+        : 15314;
+    const server = await startServer({
+      host,
+      port,
+      core: this.core,
+    });
+    this.httpBinding = {
+      baseUrl: `http://${host}:${port}`,
+      host,
+      port,
+      server,
+    };
+    return this.httpBinding;
+  }
+
+  /**
+   * 停止当前 agent 的 HTTP server。
+   */
+  private async stopHttp(): Promise<void> {
+    if (!this.httpBinding) return;
+    const current = this.httpBinding;
+    this.httpBinding = null;
+    await current.server.stop();
+  }
+
+  /**
+   * 启动当前 agent 的本地 RPC server。
+   */
+  private async startRpc(): Promise<AgentRpcBinding> {
+    if (this.rpcBinding) {
+      return this.rpcBinding;
+    }
+    const server = await startLocalRpcServer({
+      core: this.core,
+    });
+    this.rpcBinding = {
+      endpoint: server.endpoint,
+      server,
+    };
+    return this.rpcBinding;
+  }
+
+  /**
+   * 停止当前 agent 的本地 RPC server。
+   */
+  private async stopRpc(): Promise<void> {
+    if (!this.rpcBinding) return;
+    const current = this.rpcBinding;
+    this.rpcBinding = null;
+    await current.server.stop();
+  }
 }

package/src/sdk/AgentSdkTypes.ts

@@ -12,9 +12,9 @@ import type { BaseService } from "@/service/builtins/BaseService.js";
 import type { JsonValue } from "@/types/common/Json.js";
 import type { Plugin } from "@/plugin/types/Plugin.js";
 import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
-import type { AgentPlatformRuntime } from "@/types/host/AgentHost.js";
-import type { LocalRpcServerHandle } from "@/types/rpc/LocalRpc.js";
-import type { ServerInstance } from "@/server/http/Server.js";
+import type { AgentPlatformRuntime } from "@/types/runtime/host/AgentHost.js";
+import type { LocalRpcServerHandle } from "@/types/runtime/rpc/LocalRpc.js";
+import type { ServerInstance } from "@/runtime/server/http/Server.js";
 import type { Session } from "@/sdk/Session.js";
 
 /**

package/src/sdk/RemoteAgent.ts

@@ -2,7 +2,7 @@
  * RemoteAgent：远程 SDK 客户端。
  *
  * 关键点（中文）
- * - 面向已启动 `agent.http.start()` 的远程/本地 HTTP 服务。
+ * - 面向已通过 `agent.start({ http: { ... } })` 暴露出来的远程/本地 HTTP 服务。
  * - 与本地 `Agent` 尽量保持同一套 session 使用面。
  */