@downcity/agent 1.1.1 → 1.1.5

package/src/index.ts

@@ -6,26 +6,160 @@
  * - city 包通过 `import { ... } from '@downcity/agent'` 使用代理运行时。
  */
 
+// SDK 入口
+export { Agent } from "./host/sdk/Agent.js";
+export { RemoteAgent } from "./host/sdk/RemoteAgent.js";
+export type {
+  AgentOptions,
+  RemoteAgentOptions,
+  AgentSessionSetInput,
+  AgentSessionConfigSnapshot,
+  AgentSessionRunInput,
+  AgentSessionRunResult,
+  AgentSessionStreamEvent,
+  AgentSessionMetadata,
+  AgentSessionForkInput,
+} from "./host/sdk/AgentSdkTypes.js";
+export { ChatService } from "./service/builtins/chat/ChatService.js";
+export { ChatChannelAccountService } from "./service/builtins/chat/accounts/ChannelAccountService.js";
+export type { ChatChannelAccountListItem } from "./service/builtins/chat/types/ChannelAccount.js";
+export type {
+  ChatServiceChannelAccountProvider,
+  ChatServiceFeishuOptions,
+  ChatServiceOptions,
+  ChatServiceQqOptions,
+  ChatServiceTelegramOptions,
+} from "./service/builtins/chat/ChatServiceTypes.js";
+
 // Agent 运行时
-export { initAgentRuntime, stopAgentHotReload, getAgentContext, getAgentRuntime } from './agent/AgentRuntime.js';
+export {
+  initAgentRuntime,
+  stopAgentHotReload,
+  getAgentContext,
+  getAgentRuntime,
+  getAgentRuntimeBase,
+  setAgentRuntime,
+  setAgentRuntimeBase,
+  requireAgentModel,
+} from "./agent/AgentRuntime.js";
 export type { AgentRuntime, AgentRuntimeBase } from './agent/AgentRuntimeState.js';
 
 // Agent 上下文
-export type { AgentContext } from './types/agent/AgentContext.js';
+export { createAgentContext } from "./agent/AgentContext.js";
+export type { AgentContext } from "./agent/AgentContextTypes.js";
 
 // 会话
 export { Session } from './session/Session.js';
+export { getSessionRunScope, drainDeferredPersistedUserMessages } from "./session/SessionRunScope.js";
+export { JsonlSessionHistoryComposer } from "./session/composer/history/jsonl/JsonlSessionHistoryComposer.js";
+export { JsonlSessionCompactionComposer } from "./session/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
+export { SessionSystemComposer } from "./session/composer/system/SessionSystemComposer.js";
+export { transformPromptsIntoSystemMessages } from "./session/composer/system/default/PromptRenderer.js";
+export { loadStaticSystemPrompts } from "./session/composer/system/default/StaticPromptCatalog.js";
+export { LocalSessionExecutor } from "./session/executors/local/LocalSessionExecutor.js";
 
 // HTTP 服务
 export { startServer } from './http/Server.js';
+export { executeRouter } from "./http/execute/execute.js";
+export { healthRouter } from "./http/health/health.js";
+export { pluginsRouter } from "./http/plugins/plugins.js";
+export {
+  ensureServiceActionRoutesRegistered,
+  servicesRouter,
+} from "./http/services/services.js";
+export { staticRouter } from "./http/static/static.js";
+export { controlRouter } from "./http/control/ControlRouter.js";
+export { registerControlApiRoutes } from "./http/control/ControlApiRoutes.js";
+export { registerControlAuthorizationRoutes } from "./http/control/ControlAuthorizationRoutes.js";
+export { registerControlModelRoutes } from "./http/control/ModelRoutes.js";
+export { registerControlOverviewRoutes } from "./http/control/OverviewRoutes.js";
+export { registerControlSessionRoutes } from "./http/control/SessionRoutes.js";
+export { registerControlTaskRoutes } from "./http/control/TaskRoutes.js";
+export { executeBySessionId } from "./http/control/ExecuteBySession.js";
 
 // RPC
-export { startLocalRpcServer } from './rpc/Server.js';
-export { callAgentTransport } from './rpc/Transport.js';
+export { startLocalRpcServer } from "./host/rpc/Server.js";
+export { callAgentTransport } from "./host/rpc/Transport.js";
 
 // 服务框架
-export { startAllServices, stopAllServices, runServiceCommand } from './service/Manager.js';
-export { startServiceScheduleRuntime, stopServiceScheduleRuntime } from './service/schedule/Runtime.js';
+export {
+  invokeServiceAction,
+  resolveServiceAction,
+} from "./service/core/ServiceActionRunner.js";
+export { listRegisteredServices } from "./service/core/ServiceClassRegistry.js";
+export {
+  controlServiceState,
+  getServiceRootCommandNames,
+  getStaticServices,
+  isServiceRunning,
+  listServiceStates,
+  registerAllServicesForServer,
+  runServiceCommand,
+  startAllServices,
+  stopAllServices,
+} from "./service/core/Manager.js";
+export type {
+  ServiceStateControlAction,
+  ServiceStateControlResult,
+  ServiceStateSnapshot,
+} from "./service/core/Manager.js";
+export {
+  startServiceScheduleRuntime,
+  stopServiceScheduleRuntime,
+} from './service/schedule/Runtime.js';
+export { runDueScheduledJobs } from "./service/schedule/Executor.js";
+export { ServiceScheduleStore } from "./service/schedule/Store.js";
+export { scheduledJobsTable } from "./service/schedule/Schema.js";
+export {
+  normalizeRunAtMsOrThrow,
+  parseScheduledRunAtMsOrThrow,
+  parseScheduleTimeOptionOrThrow,
+} from "./service/schedule/Time.js";
+export {
+  pickLastSuccessfulChatSendText,
+  resolveAssistantMessageForPersistence,
+} from "./service/builtins/chat/runtime/UserVisibleText.js";
+export { logger, getLogger, type Logger } from "./shared/utils/logger/Logger.js";
+export { PlatformStore, withPlatformStore } from "./shared/utils/store/index.js";
+export { ensurePlatformStoreSchema } from "./shared/utils/store/StoreSchema.js";
+export {
+  nowIso,
+  normalizeNonEmptyText,
+  optionalTrimmedText,
+  type PlatformDrizzleDb,
+  type PlatformStoreContext,
+} from "./shared/utils/store/StoreShared.js";
+
+// 共享协议类型与控制面常量
+export * from "./shared/types/AgentHost.js";
+export * from "./shared/types/AgentProject.js";
+export * from "./shared/types/AuthPlugin.js";
+export * from "./shared/types/Platform.js";
+export * from "./shared/types/PlatformGateway.js";
+export * from "./shared/types/Daemon.js";
+export * from "./shared/types/DowncityConfig.js";
+export * from "./shared/types/ExecutionBinding.js";
+export * from "./shared/types/InlineInstant.js";
+export * from "./shared/types/Json.js";
+export * from "./shared/types/LlmConfig.js";
+export * from "./shared/types/LocalRpc.js";
+export * from "./shared/types/Plugin.js";
+export type {
+  PluginCliBaseOptions,
+  PluginActionResponse,
+  PluginAvailabilityResponse,
+  PluginAvailabilityView,
+  PluginListResponse,
+} from "./shared/types/PluginApi.js";
+export * from "./shared/types/Service.js";
+export * from "./shared/types/ServiceSchedule.js";
+export * from "./shared/types/Services.js";
+export * from "./shared/types/Start.js";
+export * from "./shared/types/Store.js";
+export * from "./shared/types/auth/AuthPermission.js";
+export * from "./shared/types/auth/AuthRoute.js";
+export * from "./shared/types/auth/AuthToken.js";
+export * from "./shared/types/auth/AuthTypes.js";
 
 // 模型
 export { createModel } from './model/CreateModel.js';
@@ -34,4 +168,66 @@ export { createModel } from './model/CreateModel.js';
 export { loadDowncityConfig, loadGlobalEnvFromStore, loadAgentEnvSnapshot } from './config/Config.js';
 export { getDowncityJsonPath } from './config/Paths.js';
 
+// Agent 项目初始化
+export {
+  normalizeDefaultAgentName,
+  listPlatformModelChoices,
+  isAgentProjectInitialized,
+  initializeAgentProject,
+} from "./agent/project/AgentInitializer.js";
+export type { PlatformModelChoice } from "./agent/project/AgentInitializer.js";
+export {
+  readProjectExecutionBinding,
+  readProjectPrimaryModelId,
+  hasProjectExecutionTarget,
+  assertProjectExecutionTarget,
+} from "./agent/project/ProjectExecutionBinding.js";
+export {
+  listChatAuthorizationRoles,
+  readChatAuthorizationConfigSync,
+  setChatAuthorizationUserRole,
+} from "./plugins/auth/runtime/AuthorizationConfig.js";
+export { resolveAuthorizedUserRole } from "./plugins/auth/runtime/AuthorizationPolicy.js";
+
+// Agent 项目准备
+export {
+  ensureRuntimeProjectReady,
+  ensureRuntimeExecutionBindingReady,
+} from "./host/daemon/ProjectSetup.js";
+export {
+  buildStaticPluginAvailability,
+  findBuiltinPlugin,
+  findStaticPluginView,
+  listBuiltinPlugins,
+  listStaticPluginViews,
+  toStaticPluginView,
+} from "./plugin/Catalog.js";
+export { setCityPluginEnabled, isCityPluginEnabled } from "./plugin/Lifecycle.js";
+export { runLocalPluginAction, listLocalPlugins, getLocalPluginAvailability } from "./plugin/LocalExecution.js";
+export { registerAllPluginsForCli } from "./plugin/PluginCommand.js";
+export { listBuiltinPluginRuntimeAuthPolicies } from "./plugin/HttpRoutes.js";
+export { persistProjectPluginConfig } from "./plugin/ProjectConfigStore.js";
+
 // 沙箱
+export {
+  spawnShellProcess,
+  runSandboxCommand,
+} from "./sandbox/SandboxRunner.js";
+export {
+  resolveSandboxConfig,
+  resolveSandboxCwd,
+} from "./sandbox/SandboxConfigResolver.js";
+export { spawnMacOsSeatbeltSandbox } from "./sandbox/MacOsSeatbeltSandbox.js";
+export type {
+  SandboxSessionStatus,
+  SandboxSessionSnapshot,
+  SandboxOutputChunk,
+  SandboxExecRequest,
+  SandboxStartRequest,
+  SandboxReadRequest,
+  SandboxWriteRequest,
+  SandboxWaitRequest,
+  ResolvedSandboxConfig,
+  SandboxSpawnParams,
+  SandboxSpawnResult,
+} from "./types/sandbox/SandboxRuntime.js";

package/src/model/CreateModel.ts

@@ -3,7 +3,7 @@
  *
  * 设计目标（中文，关键点）
  * - 这是“核心能力”，不应该依赖 server/RuntimeContext（避免隐式初始化时序）。
- * - `execution.type=api` 时，从 console 全局 `llm.models` / `llm.providers` 解析最终模型。
+ * - `execution.type=api` 时，从平台全局 `llm.models` / `llm.providers` 解析最终模型。
  * - 当前只有 `api` 执行模式。
  */
 
@@ -21,7 +21,7 @@ import { createLlmLoggingFetch } from "@shared/utils/logger/Fetch.js";
 import { getLogger } from "@shared/utils/logger/Logger.js";
 import type { DowncityConfig } from "@/shared/types/DowncityConfig.js";
 import type { LlmProviderType } from "@/shared/types/LlmConfig.js";
-import { ConsoleStore } from "@shared/utils/store/index.js";
+import { PlatformStore } from "@shared/utils/store/index.js";
 import { readProjectExecutionBinding } from "@/agent/project/ProjectExecutionBinding.js";
 
 type ModelLogContext = {
@@ -143,13 +143,13 @@ function normalizeProviderType(value: unknown): LlmProviderType | null {
  *
  * 解析策略（中文）
  * 1) 读取 `execution`，确认是 `api` 模式。
- * `api`：定位 console 全局 `llm.models[modelId]` 与 `llm.providers[providerKey]`。
+ * `api`：定位平台全局 `llm.models[modelId]` 与 `llm.providers[providerKey]`。
  * 创建带日志拦截的 fetch，并按 provider type 分发到 SDK 工厂。
  */
 export async function createModel(input: {
   config: DowncityConfig;
   getSessionRunScope?: () => ModelLogContext | undefined;
-  store?: ConsoleStore;
+  store?: PlatformStore;
   projectRoot?: string;
 }): Promise<LanguageModel> {
   const logger = getLogger();
@@ -174,7 +174,7 @@ export async function createModel(input: {
 
   const primaryModelId = execution.modelId;
 
-  const store = input.store || new ConsoleStore();
+  const store = input.store || new PlatformStore();
   const resolved = await store.getResolvedModel(primaryModelId);
   if (!input.store) {
     store.close();
@@ -321,12 +321,28 @@ export async function createModel(input: {
     return openRouterProvider(resolvedModel);
   }
 
-  // OpenAI-compatible providers（中文）：
-  // - openai / deepseek 统一走 OpenAI SDK（Responses/Completions 由 SDK 自适配）。
-  const openaiCompatibleProvider = createOpenAI({
+  if (providerType === "deepseek") {
+    // 关键点（中文）：
+    // - DeepSeek 提供的是 OpenAI-compatible chat/completions 接口，不支持
+    //   `createOpenAI()` 默认语言模型走的 `/responses` 路径。
+    // - 若继续使用 `createOpenAI()`，请求会落到
+    //   `https://api.deepseek.com/v1/responses` 并直接返回 404。
+    const deepseekCompatibleProvider = createOpenAICompatible({
+      name: providerKey,
+      baseURL: resolvedBaseUrl || "https://api.deepseek.com/v1",
+      apiKey: resolvedApiKey,
+      fetch: loggingFetch as typeof fetch,
+    });
+    return deepseekCompatibleProvider(resolvedModel);
+  }
+
+  // OpenAI 官方 provider（中文）：
+  // - 只在真正的 OpenAI provider 下使用 `createOpenAI()`。
+  // - 该 SDK 默认语言模型使用 Responses API，适配官方 OpenAI 路径。
+  const openaiProvider = createOpenAI({
     apiKey: resolvedApiKey,
     baseURL: resolvedBaseUrl,
     fetch: loggingFetch as typeof fetch,
   });
-  return openaiCompatibleProvider(resolvedModel);
+  return openaiProvider(resolvedModel);
 }

package/src/plugin/HookRegistry.ts

@@ -13,7 +13,7 @@ import type {
   PluginPipelineHook,
   PluginResolveHook,
 } from "@/shared/types/Plugin.js";
-import type { AgentContext } from "@/types/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContextTypes.js";
 
 type ContextResolver = () => AgentContext;
 type PluginEnabledChecker = (pluginName: string, context: AgentContext) => boolean;

package/src/plugin/HttpRoutes.ts

@@ -8,7 +8,7 @@
 
 import type { Hono } from "hono";
 import { PLUGINS } from "@/plugin/Plugins.js";
-import type { AgentContext } from "@/types/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContextTypes.js";
 import type { AuthRoutePolicy } from "@/shared/types/auth/AuthRoute.js";
 
 function dedupeAuthPolicies(policies: AuthRoutePolicy[]): AuthRoutePolicy[] {

package/src/plugin/Lifecycle.ts

@@ -3,11 +3,11 @@
  *
  * 关键点（中文）
  * - Plugin enable/disable 属于 city 级全局配置，不再写入 agent `downcity.json`。
- * - 当前实现把 lifecycle 配置存入 ConsoleStore 的统一 JSON 设置。
+ * - 当前实现把 lifecycle 配置存入 PlatformStore 的统一 JSON 设置。
  * - 默认策略：除显式关闭外，内建 plugin 视为启用。
  */
 
-import { ConsoleStore } from "@/shared/utils/store/index.js";
+import { PlatformStore } from "@/shared/utils/store/index.js";
 import type {
   CityPluginLifecycleConfig,
   CityPluginLifecycleItem,
@@ -43,7 +43,7 @@ function normalizeLifecycleConfig(input: unknown): CityPluginLifecycleConfig {
  * 读取当前 city 级 plugin lifecycle 配置。
  */
 export function readCityPluginLifecycleConfig(): CityPluginLifecycleConfig {
-  const store = new ConsoleStore();
+  const store = new PlatformStore();
   try {
     return normalizeLifecycleConfig(
       store.getSecureSettingJsonSync<CityPluginLifecycleConfig>(
@@ -62,7 +62,7 @@ export function writeCityPluginLifecycleConfig(
   value: CityPluginLifecycleConfig,
 ): CityPluginLifecycleConfig {
   const normalized = normalizeLifecycleConfig(value);
-  const store = new ConsoleStore();
+  const store = new PlatformStore();
   try {
     store.setSecureSettingJsonSync(PLUGIN_LIFECYCLE_SETTING_KEY, normalized);
     return normalized;

package/src/plugin/LocalExecution.ts

@@ -15,7 +15,7 @@ import { findBuiltinPlugin, listStaticPluginViews } from "@/plugin/Catalog.js";
 import {
   createAgentPathRuntime,
   createAgentPluginConfigRuntime,
-} from "@/runtime/AgentHostRuntime.js";
+} from "@/host/runtime/AgentHostRuntime.js";
 import type { JsonValue } from "@/shared/types/Json.js";
 import type {
   PluginActionResult,

package/src/plugin/PluginManager.ts

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

package/src/plugin/PluginRegistry.ts

@@ -14,7 +14,7 @@ import type {
   PluginAvailability,
   PluginView,
 } from "@/shared/types/Plugin.js";
-import type { AgentContext } from "@/types/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContextTypes.js";
 import type { JsonValue } from "@/shared/types/Json.js";
 
 type ContextResolver = () => AgentContext;

package/src/plugin/ProjectConfigStore.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - 新插件体系的用户配置统一写回项目 `downcity.json`。
  * - 这里只负责 `plugins` 配置域，避免把执行期合并态整包落盘。
- * - 这样既能保证重启后配置仍然生效，也能避免把 console 全局配置误写进项目文件。
+ * - 这样既能保证重启后配置仍然生效，也能避免把平台全局配置误写进项目文件。
  */
 
 import fs from "node:fs/promises";

package/src/plugins/asr/Plugin.ts

@@ -12,7 +12,7 @@ import type { ChatInboundAugmentInput } from "@/shared/types/ChatPlugin.js";
 import type { VoicePluginConfig } from "@/shared/types/VoicePlugin.js";
 import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
 import type { AgentPluginConfigRuntime } from "@/shared/types/AgentHost.js";
-import { CHAT_PLUGIN_POINTS } from "@services/chat/runtime/PluginPoints.js";
+import { CHAT_PLUGIN_POINTS } from "@/service/builtins/chat/runtime/PluginPoints.js";
 import { isPluginEnabled } from "@/plugin/Activation.js";
 import { setCityPluginEnabled } from "@/plugin/Lifecycle.js";
 import {

package/src/plugins/auth/Plugin.ts

@@ -9,7 +9,7 @@
 
 import type { Plugin } from "@/shared/types/Plugin.js";
 import type { JsonValue } from "@/shared/types/Json.js";
-import { CHAT_PLUGIN_POINTS } from "@services/chat/runtime/PluginPoints.js";
+import { CHAT_PLUGIN_POINTS } from "@/service/builtins/chat/runtime/PluginPoints.js";
 import {
   AUTH_ACTIONS,
   type AuthObservePrincipalPayload,
@@ -32,7 +32,7 @@ import {
   readAuthorizationSnapshot,
   recordObservedAuthorizationPrincipal,
 } from "@/plugins/auth/runtime/AuthorizationStore.js";
-import type { ChatDispatchChannel } from "@services/chat/types/ChatDispatcher.js";
+import type { ChatDispatchChannel } from "@/service/builtins/chat/types/ChatDispatcher.js";
 
 function toChannel(value: unknown): ChatDispatchChannel | null {
   const text = String(value || "").trim().toLowerCase();

package/src/plugins/auth/runtime/AuthorizationConfig.ts

@@ -6,7 +6,7 @@
  * - 授权核心模型为 role / permission / binding。
  */
 
-import type { AgentContext } from "@/types/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContextTypes.js";
 import type {
   ChatAuthorizationConfig,
   ChatAuthorizationChannel,
@@ -19,7 +19,7 @@ import {
   CHAT_AUTHORIZATION_PERMISSIONS,
   createDefaultChatAuthorizationRoles,
 } from "@/shared/types/AuthPlugin.js";
-import { ConsoleStore } from "@/shared/utils/store/index.js";
+import { PlatformStore } from "@/shared/utils/store/index.js";
 
 const CHAT_AUTHORIZATION_STORE_KEY = "chat_authorization";
 const CHANNELS: ChatAuthorizationChannel[] = [...CHAT_AUTHORIZATION_CHANNELS];
@@ -142,7 +142,7 @@ function cloneAuthorizationConfig(
 function readAuthorizationConfigFromStoreSync(projectRoot: string): ChatAuthorizationConfig {
   const normalizedProjectRoot = normalizeText(projectRoot);
   if (!normalizedProjectRoot) return normalizeAuthorizationConfig({});
-  const store = new ConsoleStore();
+  const store = new PlatformStore();
   try {
     return normalizeAuthorizationConfig(
       store.getAgentSecureSettingJsonSync<ChatAuthorizationConfig>(
@@ -163,7 +163,7 @@ async function writeAuthorizationConfigToStore(params: {
 }): Promise<void> {
   const normalizedProjectRoot = normalizeText(params.projectRoot);
   if (!normalizedProjectRoot) throw new Error("projectRoot is required");
-  const store = new ConsoleStore();
+  const store = new PlatformStore();
   try {
     await store.setAgentSecureSettingJson(
       normalizedProjectRoot,

package/src/plugins/auth/runtime/AuthorizationStore.ts

@@ -14,8 +14,8 @@ import type {
   ChatAuthorizationSnapshot,
   ChatAuthorizationStateFile,
 } from "@/shared/types/AuthPlugin.js";
-import type { AgentContext } from "@/types/agent/AgentContext.js";
-import type { ChatDispatchChannel } from "@services/chat/types/ChatDispatcher.js";
+import type { AgentContext } from "@/agent/AgentContextTypes.js";
+import type { ChatDispatchChannel } from "@/service/builtins/chat/types/ChatDispatcher.js";
 import { readChatAuthorizationConfigSync } from "@/plugins/auth/runtime/AuthorizationConfig.js";
 
 function getAuthorizationStatePath(rootPath: string): string {

package/src/plugins/tts/runtime/Synthesizer.ts

@@ -13,7 +13,7 @@ import fs from "fs-extra";
 import type { TtsPluginConfig, TtsSynthesizeInput } from "@/shared/types/TtsPlugin.js";
 import type { TtsAudioFormat, TtsModelId } from "@/shared/types/Tts.js";
 import type { PluginCommandContext } from "@/shared/types/Plugin.js";
-import { renderChatMessageFileTag } from "@/services/chat/runtime/ChatMessageMarkup.js";
+import { renderChatMessageFileTag } from "@/service/builtins/chat/runtime/ChatMessageMarkup.js";
 import { getTtsModelCatalogItem, resolveTtsModelId } from "@/plugins/tts/runtime/Catalog.js";
 import { resolveTtsModelsRootDir } from "@/plugins/tts/runtime/Paths.js";
 

package/src/plugins/voice/Plugin.ts

@@ -12,7 +12,7 @@ import type { ChatInboundAugmentInput } from "@/shared/types/ChatPlugin.js";
 import type { VoicePluginConfig } from "@/shared/types/VoicePlugin.js";
 import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
 import type { AgentPluginConfigRuntime } from "@/shared/types/AgentHost.js";
-import { CHAT_PLUGIN_POINTS } from "@services/chat/runtime/PluginPoints.js";
+import { CHAT_PLUGIN_POINTS } from "@/service/builtins/chat/runtime/PluginPoints.js";
 import {
   listVoiceModels,
   resolveVoicePluginModelId,

package/src/plugins/workboard/runtime/Collector.ts

@@ -6,10 +6,10 @@
  * - 内部仍聚合 session、task、service 三类运行事实，但最终只输出对外安全的模糊状态。
  */
 
-import { listTaskDefinitions } from "@services/task/Action.js";
-import { listServiceStates } from "@/service/Manager.js";
-import { listDashboardSessionSummaries } from "@/http/dashboard/SessionSummaryStore.js";
-import type { AgentContext } from "@/types/agent/AgentContext.js";
+import { listTaskDefinitions } from "@/service/builtins/task/Action.js";
+import { listServiceStates } from "@/service/core/Manager.js";
+import { listControlSessionSummaries } from "@/http/control/SessionSummaryStore.js";
+import type { AgentContext } from "@/agent/AgentContextTypes.js";
 import type { WorkboardSnapshot } from "@/plugins/workboard/types/Workboard.js";
 import {
   buildIdleActivity,
@@ -30,7 +30,7 @@ export async function collectWorkboardSnapshot(
 ): Promise<WorkboardSnapshot> {
   const collectedAt = new Date().toISOString();
   const executingSessionIds = new Set(context.session.listExecutingSessionIds());
-  const sessions = await listDashboardSessionSummaries({
+  const sessions = await listControlSessionSummaries({
     projectRoot: context.rootPath,
     executionContext: context,
     limit: WORKBOARD_RECENT_LIMIT + Math.max(executingSessionIds.size, 1),

package/src/plugins/workboard/runtime/Normalizer.ts

@@ -6,16 +6,16 @@
  * - 所有会泄漏上下文的字段都必须在这里截断或抽象。
  */
 
-import type { DashboardSessionSummary } from "@/shared/types/DashboardData.js";
+import type { ControlSessionSummary } from "@/shared/types/ControlViewData.js";
 import type { ServiceStateSnapshot } from "@/shared/types/ServiceState.js";
-import type { TaskListResponse } from "@services/task/types/TaskCommand.js";
+import type { TaskListResponse } from "@/service/builtins/task/types/TaskCommand.js";
 import type {
   WorkboardActivityItem,
   WorkboardAgentSummary,
   WorkboardSignalItem,
   WorkboardSummary,
 } from "@/plugins/workboard/types/Workboard.js";
-import type { AgentContext } from "@/types/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContextTypes.js";
 
 function toIsoString(timestamp?: number): string {
   if (!timestamp || !Number.isFinite(timestamp)) {
@@ -59,7 +59,7 @@ function buildMomentum(params: { currentCount: number; recentCount: number }): s
   return "安静";
 }
 
-function buildRunningSummary(item: DashboardSessionSummary): string {
+function buildRunningSummary(item: ControlSessionSummary): string {
   const messageCount = typeof item.messageCount === "number" ? item.messageCount : 0;
   if (messageCount >= 24) return "正在延展一段较长的工作脉络，并持续生成新的内容。";
   if (messageCount >= 8) return "正在承接连续输入，逐步形成新的阶段结果。";
@@ -67,7 +67,7 @@ function buildRunningSummary(item: DashboardSessionSummary): string {
   return "当前处于活跃展开之中。";
 }
 
-function buildRecentSummary(item: DashboardSessionSummary, index: number): string {
+function buildRecentSummary(item: ControlSessionSummary, index: number): string {
   const messageCount = typeof item.messageCount === "number" ? item.messageCount : 0;
   if (index === 0 && messageCount > 0) return "刚刚完成一段新的展开，正在短暂停留。";
   if (messageCount >= 12) return "近期完成了一次较长的内容延展。";
@@ -103,7 +103,7 @@ export function toWorkboardAgentSummary(params: {
  * 将运行中的 session 映射为对外安全活动项。
  */
 export function toRunningActivity(params: {
-  item: DashboardSessionSummary;
+  item: ControlSessionSummary;
   index: number;
 }): WorkboardActivityItem {
   const title = params.index === 0 ? "当前主线" : `当前并行线 ${params.index + 1}`;
@@ -123,7 +123,7 @@ export function toRunningActivity(params: {
  * 将近期 session 映射为对外安全活动项。
  */
 export function toRecentActivity(params: {
-  item: DashboardSessionSummary;
+  item: ControlSessionSummary;
   index: number;
 }): WorkboardActivityItem {
   const title = params.index === 0 ? "最近一次更新" : `近期片段 ${params.index + 1}`;

package/src/plugins/workboard/runtime/Store.ts

@@ -6,7 +6,7 @@
  * - route 与 action 共享同一份快照，确保 workboard 展示一致。
  */
 
-import type { AgentContext } from "@/types/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContextTypes.js";
 import type { WorkboardSnapshot } from "@/plugins/workboard/types/Workboard.js";
 import { collectWorkboardSnapshot } from "@/plugins/workboard/runtime/Collector.js";
 

package/src/sandbox/SandboxConfigResolver.ts

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

package/src/sandbox/SandboxRunner.ts

@@ -7,7 +7,7 @@
  * - shell 命令不再允许回退到宿主机普通子进程执行。
  */
 
-import type { AgentContext } from "@/types/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContextTypes.js";
 import type { SandboxSpawnResult } from "@/types/sandbox/SandboxRuntime.js";
 import { resolveSandboxConfig, resolveSandboxCwd } from "@/sandbox/SandboxConfigResolver.js";
 import { spawnMacOsSeatbeltSandbox } from "@/sandbox/MacOsSeatbeltSandbox.js";