@downcity/agent 1.1.8 → 1.1.11

package/src/host/daemon/Api.ts

@@ -4,10 +4,10 @@
  * 关键点（中文）
  * - 这里描述的是 CLI 与 agent daemon 之间的远程访问契约，不包含具体 HTTP 实现。
  * - service 等上层模块只依赖这些协议类型，不需要感知 city/daemon 的内部实现细节。
- * - 该文件属于 `main/city/daemon/*` 的协议边界，而不是通用 HTTP 类型目录。
+ * - 该文件属于 agent daemon 访问协议边界，而不是通用 HTTP 类型目录。
  */
 
-import type { JsonValue } from "@/shared/types/Json.js";
+import type { JsonValue } from "@/types/common/Json.js";
 
 /**
  * Daemon 服务端点。

package/src/host/daemon/Client.ts

@@ -15,9 +15,9 @@ import {
 import {
   formatCliBearerHeaderValue,
   resolveCliAuthToken,
-} from "@/http/auth/CliAuthStateStore.js";
-import { getDaemonMetaPath } from "@/host/daemon/Manager.js";
-import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
+} from "@/server/http/auth/CliAuthStateStore.js";
+import { getDaemonMetaPath } from "@/host/daemon/Paths.js";
+import type { JsonObject, JsonValue } from "@/types/common/Json.js";
 
 /**
  * 解析端口值。

package/src/host/daemon/Paths.ts

@@ -0,0 +1,33 @@
+/**
+ * Agent daemon 路径模块。
+ *
+ * 关键点（中文）
+ * - 这里只保留 agent 侧访问 daemon meta 所需的项目级路径。
+ * - daemon 进程启停、pid 清理、registry 同步属于 `@downcity/city`，不放在 agent 包内。
+ */
+
+import path from "node:path";
+import { getDowncityDebugDirPath } from "@/config/Paths.js";
+import {
+  DAEMON_LOG_FILENAME,
+  DAEMON_META_FILENAME,
+  DAEMON_PID_FILENAME,
+} from "@/types/daemon/Daemon.js";
+
+/**
+ * 计算 daemon pid 文件路径。
+ */
+export const getDaemonPidPath = (projectRoot: string): string =>
+  path.join(getDowncityDebugDirPath(projectRoot), DAEMON_PID_FILENAME);
+
+/**
+ * 计算 daemon 日志文件路径。
+ */
+export const getDaemonLogPath = (projectRoot: string): string =>
+  path.join(getDowncityDebugDirPath(projectRoot), DAEMON_LOG_FILENAME);
+
+/**
+ * 计算 daemon 元数据文件路径。
+ */
+export const getDaemonMetaPath = (projectRoot: string): string =>
+  path.join(getDowncityDebugDirPath(projectRoot), DAEMON_META_FILENAME);

package/src/host/daemon/ProjectSetup.ts

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

package/src/host/runtime/AgentHostRuntime.ts

@@ -2,8 +2,8 @@
  * AgentHostRuntime：装配 AgentRuntime 宿主能力。
  *
  * 关键点（中文）
- * - `main/agent/*` 负责创建这些宿主能力对象，再注入到 AgentRuntime。
- * - services / session / plugins 只消费这些对象，不再直接 import `main/*`。
+ * - agent runtime 负责创建这些宿主能力对象，再注入到 AgentRuntime。
+ * - service / session / plugin 只消费这些对象，不直接依赖具体宿主实现。
  * - 当前先收敛路径与 plugin 配置持久化两类宿主能力。
  */
 import {
@@ -18,12 +18,12 @@ import {
   getDowncitySessionDirPath,
   getDowncitySessionRootDirPath,
 } from "@/config/Paths.js";
-import { persistProjectPluginConfig } from "@/plugin/ProjectConfigStore.js";
+import { persistProjectPluginConfig } from "@/plugin/core/ProjectConfigStore.js";
 import type {
   AgentPathRuntime,
   AgentPluginConfigRuntime,
-} from "@/shared/types/AgentHost.js";
-import type { DowncityConfig } from "@/shared/types/DowncityConfig.js";
+} from "@/types/host/AgentHost.js";
+import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
 
 /**
  * 创建当前项目的路径能力集合。

package/src/host/runtime/PluginRuntime.ts

@@ -7,7 +7,7 @@
  * - agent runtime 仅作为 context provider 注册方，不再成为 plugin manager 的宿主。
  */
 
-import type { AgentContext } from "@/agent/AgentContextTypes.js";
+import type { AgentContext } from "@/runtime/AgentContextTypes.js";
 
 type AgentContextResolver = () => AgentContext;
 

package/src/index.ts

@@ -2,24 +2,27 @@
  * @downcity/agent — Agent 运行时公开 API。
  *
  * 关键点（中文）
- * - 这是 agent 包的唯一公开入口。
- * - city 包通过 `import { ... } from '@downcity/agent'` 使用代理运行时。
+ * - 这是 agent 包唯一稳定的公开入口。
+ * - 只导出 SDK、插件/服务作者 API、city 运行集成 API 与跨包协议类型。
+ * - HTTP router、sandbox runner、内部 service runner 等实现细节不从根入口暴露。
  */
 
 // SDK 入口
-export { Agent } from "./host/sdk/Agent.js";
-export { RemoteAgent } from "./host/sdk/RemoteAgent.js";
+export { Agent } from "./sdk/Agent.js";
+export { RemoteAgent } from "./sdk/RemoteAgent.js";
 export type {
   AgentOptions,
   RemoteAgentOptions,
-  AgentSessionSetInput,
   AgentSessionConfigSnapshot,
+  AgentSessionForkInput,
+  AgentSessionMetadata,
   AgentSessionRunInput,
   AgentSessionRunResult,
+  AgentSessionSetInput,
   AgentSessionStreamEvent,
-  AgentSessionMetadata,
-  AgentSessionForkInput,
-} from "./host/sdk/AgentSdkTypes.js";
+} from "./sdk/AgentSdkTypes.js";
+
+// 服务与插件作者 API
 export { BaseService } from "./service/builtins/BaseService.js";
 export { ChatService } from "./service/builtins/chat/ChatService.js";
 export { ChatChannelAccountService } from "./service/builtins/chat/accounts/ChannelAccountService.js";
@@ -31,27 +34,34 @@ export type {
   ChatServiceQqOptions,
   ChatServiceTelegramOptions,
 } from "./service/builtins/chat/ChatServiceTypes.js";
+export { authPlugin } from "./plugin/builtins/auth/Plugin.js";
+export { skillPlugin } from "./plugin/builtins/skill/Plugin.js";
+export { webPlugin } from "./plugin/builtins/web/Plugin.js";
+export { asrPlugin } from "./plugin/builtins/asr/Plugin.js";
+export { ttsPlugin } from "./plugin/builtins/tts/Plugin.js";
+export { workboardPlugin } from "./plugin/builtins/workboard/Plugin.js";
 
-// Agent 运行时
+// Agent 运行时集成
 export {
-  initAgentRuntime,
-  stopAgentHotReload,
   getAgentContext,
   getAgentRuntime,
   getAgentRuntimeBase,
+  initAgentRuntime,
+  requireAgentModel,
   setAgentRuntime,
   setAgentRuntimeBase,
-  requireAgentModel,
-} from "./agent/AgentRuntime.js";
-export type { AgentRuntime, AgentRuntimeBase } from './agent/AgentRuntimeState.js';
-
-// Agent 上下文
-export { createAgentContext } from "./agent/AgentContext.js";
-export type { AgentContext } from "./agent/AgentContextTypes.js";
+  stopAgentHotReload,
+} from "./runtime/AgentRuntime.js";
+export { createAgentContext } from "./runtime/AgentContext.js";
+export type { AgentRuntime, AgentRuntimeBase } from "./runtime/AgentRuntimeState.js";
+export type { AgentContext } from "./runtime/AgentContextTypes.js";
 
-// 会话
-export { Session } from './session/Session.js';
-export { getSessionRunScope, drainDeferredPersistedUserMessages } from "./session/SessionRunScope.js";
+// Session 与即时执行集成
+export { Session } from "./session/Session.js";
+export {
+  drainDeferredPersistedUserMessages,
+  getSessionRunScope,
+} 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";
@@ -59,172 +69,279 @@ export { transformPromptsIntoSystemMessages } from "./session/composer/system/de
 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 "./host/rpc/Server.js";
-export { callAgentTransport } from "./host/rpc/Transport.js";
-
-// 服务框架
-export {
-  invokeServiceAction,
-  resolveServiceAction,
-} from "./service/core/ServiceActionRunner.js";
+// Agent server 与 transport 集成
+export { startServer } from "./server/http/Server.js";
+export { startLocalRpcServer } from "./server/rpc/Server.js";
+export { callAgentTransport } from "./transport/rpc/Transport.js";
+
+// Service 运行集成
 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';
+} from "./service/schedule/Runtime.js";
 export { ServiceScheduleStore } from "./service/schedule/Store.js";
-export { runDueScheduledJobs } from "./service/schedule/Executor.js";
-export {
-  normalizeRunAtMsOrThrow,
-  parseScheduledRunAtMsOrThrow,
-  parseScheduleTimeOptionOrThrow,
-} from "./service/schedule/Time.js";
+export { parseScheduledRunAtMsOrThrow } 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 * 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/PluginLifecycle.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';
-
-// 配置
-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";
+
+// Plugin 与权限配置集成
 export {
   listChatAuthorizationRoles,
   readChatAuthorizationConfigSync,
   setChatAuthorizationUserRole,
-} from "./plugins/auth/runtime/AuthorizationConfig.js";
-export { resolveAuthorizedUserRole } from "./plugins/auth/runtime/AuthorizationPolicy.js";
-export { authPlugin } from "./plugins/auth/Plugin.js";
-export { skillPlugin } from "./plugins/skill/Plugin.js";
-export { webPlugin } from "./plugins/web/Plugin.js";
-export { asrPlugin } from "./plugins/asr/Plugin.js";
-export { ttsPlugin } from "./plugins/tts/Plugin.js";
-export { workboardPlugin } from "./plugins/workboard/Plugin.js";
-
-// Agent 项目准备
-export {
-  ensureRuntimeProjectReady,
-  ensureRuntimeExecutionBindingReady,
-} from "./host/daemon/ProjectSetup.js";
+} from "./plugin/builtins/auth/runtime/AuthorizationConfig.js";
+export { resolveAuthorizedUserRole } from "./plugin/builtins/auth/runtime/AuthorizationPolicy.js";
 export {
   buildStaticPluginAvailability,
   findBuiltinPlugin,
   findStaticPluginView,
-  listBuiltinPlugins,
   listStaticPluginViews,
-  toStaticPluginView,
-} from "./plugin/Catalog.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";
-
-// 沙箱
+} from "./plugin/core/Catalog.js";
+export { runLocalPluginAction } from "./plugin/core/LocalExecution.js";
+export { registerAllPluginsForCli } from "./plugin/core/PluginCommand.js";
+export { listBuiltinPluginRuntimeAuthPolicies } from "./plugin/core/HttpRoutes.js";
+export { persistProjectPluginConfig } from "./plugin/core/ProjectConfigStore.js";
+
+// 项目、配置与模型集成
+export { createModel } from "./model/CreateModel.js";
+export {
+  initializeAgentProject,
+  isAgentProjectInitialized,
+  listPlatformModelChoices,
+  normalizeDefaultAgentName,
+} from "./project/AgentInitializer.js";
+export type { PlatformModelChoice } from "./project/AgentInitializer.js";
+export {
+  ensureRuntimeExecutionBindingReady,
+  ensureRuntimeProjectReady,
+} from "./host/daemon/ProjectSetup.js";
+export { assertProjectExecutionTarget } from "./project/ProjectExecutionBinding.js";
+
+// 日志
+export { getLogger, logger, type Logger } from "./utils/logger/Logger.js";
+
+// 宿主端口类型
+export type {
+  AgentPathRuntime,
+  AgentPlatformRuntime,
+  AgentPluginConfigRuntime,
+} from "./types/host/AgentHost.js";
+
+// 项目协议类型
+export type {
+  AgentProjectChannel,
+  AgentProjectInitializationInput,
+  AgentProjectInitializationResult,
+} from "./project/types/AgentProject.js";
+export type { ExecutionBindingConfig } from "./types/config/ExecutionBinding.js";
+export type { StartOptions } from "./types/config/Start.js";
+
+// 配置与模型类型
+export type { DowncityConfig } from "./types/config/DowncityConfig.js";
+export type {
+  LlmConfig,
+  LlmModelConfig,
+  LlmProviderConfig,
+  LlmProviderType,
+} from "./types/config/LlmConfig.js";
+
+// JSON 基础类型
+export type { JsonObject, JsonPrimitive, JsonValue } from "./types/common/Json.js";
+
+// Platform / city 控制面协议类型
+export type {
+  ControlPlaneRuntimeMeta,
+  ControlPlaneRuntimeStatus,
+  ManagedAgentProcessView,
+  ManagedAgentRegistryEntry,
+  ManagedAgentRegistryV1,
+  PlatformAgentDirectoryInspection,
+  PlatformAgentOption,
+  PlatformAgentsResponse,
+  PlatformConfigFileStatusItem,
+  PlatformConfigStatusResponse,
+  PlatformLocalModelsResponse,
+} from "./types/platform/Platform.js";
+export type {
+  PlatformAgentChatChannelStatus,
+  PlatformAgentDaemonMeta,
+  PlatformAgentShipChatChannelsConfig,
+  PlatformAgentShipExecutionAgentConfig,
+  PlatformAgentShipExecutionConfig,
+  PlatformAgentShipJson,
+  PlatformAgentShipServicesConfig,
+  PlatformAgentShipSingleChannelConfig,
+  PlatformAgentShipStartConfig,
+} from "./types/platform/PlatformGateway.js";
+
+// Daemon / RPC 协议类型
+export {
+  DAEMON_LOG_FILENAME,
+  DAEMON_META_FILENAME,
+  DAEMON_PID_FILENAME,
+} from "./types/daemon/Daemon.js";
+export type { DaemonMeta, DaemonStaleReason } from "./types/daemon/Daemon.js";
+export type {
+  LocalRpcRequest,
+  LocalRpcResponse,
+} from "./types/rpc/LocalRpc.js";
+
+// Inline instant 协议类型
+export type {
+  InlineInstantExecutorType,
+  PlatformInlineInstantRunInput,
+  PlatformInlineInstantRunResult,
+  PlatformInlineInstantService,
+} from "./types/http/InlineInstant.js";
+
+// Plugin 作者与控制面类型
+export type {
+  Plugin,
+  PluginAction,
+  PluginActionApi,
+  PluginActionCommand,
+  PluginActionCommandInput,
+  PluginActionResult,
+  PluginActions,
+  PluginAvailability,
+  PluginConfigDefinition,
+  PluginEffectHook,
+  PluginGuardHook,
+  PluginHooks,
+  PluginHttpDefinition,
+  PluginPipelineHook,
+  PluginPort,
+  PluginResolveHook,
+  PluginRuntimeHttpRegistration,
+  PluginServiceInvokeParams,
+  PluginServiceInvokePort,
+  PluginServiceInvokeResult,
+  PluginSetupDefinition,
+  PluginSetupField,
+  PluginSetupFieldOption,
+  PluginUsageDefinition,
+  PluginUsageField,
+  PluginUsageFieldOption,
+  PluginView,
+} from "./plugin/types/Plugin.js";
+export type {
+  PluginActionResponse,
+  PluginAvailabilityResponse,
+  PluginAvailabilityView,
+  PluginCliBaseOptions,
+  PluginListResponse,
+} from "./plugin/types/PluginApi.js";
+
+// Service 作者与 CLI/control 协议类型
+export type {
+  Service,
+  ServiceAction,
+  ServiceActionApi,
+  ServiceActionCommand,
+  ServiceActionCommandInput,
+  ServiceActionResult,
+  ServiceActions,
+  ServiceCommandResult,
+  ServiceLifecycle,
+  ServiceState,
+} from "./service/types/Service.js";
+export type {
+  CreateScheduledJobInput,
+  ScheduledJobRecord,
+  ScheduledJobStatus,
+  ServiceCommandScheduleInput,
+} from "./service/types/ServiceSchedule.js";
+export type {
+  ServiceCliBaseOptions,
+  ServiceCommandResponse,
+  ServiceControlAction,
+  ServiceControlResponse,
+  ServiceListResponse,
+  ServiceStateView,
+} from "./service/types/Services.js";
+export type {
+  ServiceStateControlAction,
+  ServiceStateControlResult,
+  ServiceStateSnapshot,
+} from "./service/core/Manager.js";
+
+// Chat authorization plugin 协议类型
 export {
-  spawnShellProcess,
-  runSandboxCommand,
-} from "./sandbox/SandboxRunner.js";
+  CHAT_AUTHORIZATION_CHANNELS,
+  createDefaultChatAuthorizationRoles,
+  isChatAuthorizationChannel,
+} from "./plugin/builtins/auth/types/AuthPlugin.js";
+export type {
+  AuthObservePrincipalPayload,
+  AuthObservePrincipalResult,
+  AuthResolveUserRolePayload,
+  AuthSetUserRolePayload,
+  AuthWriteConfigPayload,
+  ChatAuthorizationCatalog,
+  ChatAuthorizationChannel,
+  ChatAuthorizationConfig,
+  ChatAuthorizationDecision,
+  ChatAuthorizationEvaluateInput,
+  ChatAuthorizationEvaluateResult,
+  ChatAuthorizationObservedChat,
+  ChatAuthorizationObservedUser,
+  ChatAuthorizationPermission,
+  ChatAuthorizationPermissionMeta,
+  ChatAuthorizationRole,
+  ChatAuthorizationSnapshot,
+  ChatAuthorizationStateFile,
+  ChatChannelAuthorizationConfig,
+} from "./plugin/builtins/auth/types/AuthPlugin.js";
+
+// Platform store 类型
+export type {
+  StoredAgentEnvEntry,
+  StoredChannelAccount,
+  StoredChannelAccountChannel,
+  StoredEnvEntry,
+  StoredEnvScope,
+  StoredGlobalEnvEntry,
+  StoredModel,
+  StoredModelProvider,
+  StoredProviderMeta,
+  UpsertAgentEnvEntryInput,
+  UpsertChannelAccountInput,
+  UpsertEnvEntryInput,
+  UpsertGlobalEnvEntryInput,
+  UpsertModelInput,
+  UpsertModelProviderInput,
+} from "./types/host/Store.js";
+
+// HTTP auth 协议类型
 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";
+  AUTH_DEFAULT_ROLE_NAMES,
+  AUTH_DEFAULT_ROLES,
+  AUTH_PERMISSION_DESCRIPTIONS,
+  AUTH_PERMISSION_KEYS,
+} from "./types/auth/AuthPermission.js";
+export type {
+  AuthDefaultRoleDefinition,
+  AuthDefaultRoleName,
+  AuthPermissionKey,
+} from "./types/auth/AuthPermission.js";
+export type { AuthRoutePolicy } from "./types/auth/AuthRoute.js";
+export type {
+  AuthIssuedToken,
+  AuthTokenSummary,
+} from "./types/auth/AuthToken.js";
+export type {
+  AuthAuditLog,
+  AuthPermission,
+  AuthPrincipal,
+  AuthRole,
+  AuthTokenRecord,
+  AuthUser,
+  AuthUserStatus,
+} from "./types/auth/AuthTypes.js";

package/src/model/CreateModel.ts

@@ -17,12 +17,12 @@ import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
 import { createXai } from "@ai-sdk/xai";
 import { createOpenRouter } from "@openrouter/ai-sdk-provider";
 import { type LanguageModel } from "ai";
-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 { readProjectExecutionBinding } from "@/agent/project/ProjectExecutionBinding.js";
-import type { AgentPlatformRuntime } from "@/shared/types/AgentHost.js";
+import { createLlmLoggingFetch } from "@/utils/logger/Fetch.js";
+import { getLogger } from "@/utils/logger/Logger.js";
+import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
+import type { LlmProviderType } from "@/types/config/LlmConfig.js";
+import { readProjectExecutionBinding } from "@/project/ProjectExecutionBinding.js";
+import type { AgentPlatformRuntime } from "@/types/host/AgentHost.js";
 
 type ModelLogContext = {
   sessionId?: string;

package/src/model/ModelManager.ts

@@ -6,7 +6,7 @@
  * - 避免命令层直接依赖硬编码常量，提升可维护性与一致性。
  */
 
-import type { LlmProviderType } from "@/shared/types/LlmConfig.js";
+import type { LlmProviderType } from "@/types/config/LlmConfig.js";
 
 /**
  * 单个模型预设定义。