@downcity/agent 1.1.12 → 1.1.14

package/src/{runtime/AgentRuntimeTypes.ts → core/AgentCoreTypes.ts}

@@ -1,10 +1,10 @@
 /**
- * AgentRuntime 类型定义。
+ * AgentCore 运行时类型定义。
  *
  * 关键点（中文）
- * - 这里表达的是“当前 agent 进程的长期运行状态”。
- * - 它不是抽象 host，也不是一次执行上下文。
- * - Session / Service / Plugin 这些长期对象都应从这里挂出。
+ * - 这里表达的是单个 `AgentCore` 实例持有的长期运行状态。
+ * - 它不再依赖 `runtime/*` 兼容层，而是作为实例级主类型来源。
+ * - Session / Service / Plugin 这些长期对象都从这里挂出。
  */
 
 import type { LanguageModel } from "ai";
@@ -16,10 +16,10 @@ import type {
   AgentPluginConfigRuntime,
 } from "@/types/host/AgentHost.js";
 import type { BaseService } from "@/service/builtins/BaseService.js";
-import type { Session } from "@session/Session.js";
+import type { Executor } from "@session/Executor.js";
 
 /**
- * AgentRuntime 启动早期的基础状态。
+ * AgentCore 启动早期的基础状态。
  */
 export interface AgentRuntimeBase {
   /**
@@ -65,7 +65,7 @@ export interface AgentRuntimeBase {
 }
 
 /**
- * Agent 进程完整运行状态。
+ * AgentCore 完整运行状态。
  */
 export interface AgentRuntime extends AgentRuntimeBase {
   /**
@@ -73,9 +73,9 @@ export interface AgentRuntime extends AgentRuntimeBase {
    */
   model?: LanguageModel;
   /**
-   * 读取指定 sessionId 对应的 Session 实例。
+   * 读取指定 sessionId 对应的内部 Executor 实例。
    */
-  getSession(sessionId: string): Session;
+  getSession(sessionId: string): Executor;
   /**
    * 返回当前执行中的 sessionId 列表。
    */

package/src/host/runtime/PluginRuntime.ts

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

package/src/index.ts

@@ -9,9 +9,17 @@
 
 // SDK 入口
 export { Agent } from "./sdk/Agent.js";
+export { Session } from "./sdk/Session.js";
 export { RemoteAgent } from "./sdk/RemoteAgent.js";
+export { AgentCore } from "./core/AgentCore.js";
 export type {
   AgentOptions,
+  AgentHttpBinding,
+  AgentHttpStartOptions,
+  AgentRpcBinding,
+  AgentStartOptions,
+  AgentStartResult,
+  AgentStopResult,
   RemoteAgentOptions,
   AgentSessionConfigSnapshot,
   AgentSessionForkInput,
@@ -25,6 +33,19 @@ export type {
   AgentSessionSystemSessionInfo,
   AgentSessionSystemSnapshot,
 } from "./sdk/AgentSdkTypes.js";
+export type {
+  AgentRuntime as AgentCoreRuntime,
+  AgentRuntimeBase as AgentCoreRuntimeBase,
+} from "./core/AgentCoreTypes.js";
+export type {
+  AgentContext as AgentContext,
+  AgentContext as AgentCoreContext,
+  ChatRuntimePort,
+  InvokeServicePort,
+  SessionCollectionPort,
+  SessionPort,
+  StructuredConfig,
+} from "./core/AgentContextTypes.js";
 
 // 服务与插件作者 API
 export { BaseService } from "./service/builtins/BaseService.js";
@@ -45,23 +66,8 @@ 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 运行时集成
-export {
-  getAgentContext,
-  getAgentRuntime,
-  getAgentRuntimeBase,
-  initAgentRuntime,
-  requireAgentModel,
-  setAgentRuntime,
-  setAgentRuntimeBase,
-  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";
-
 // Session 与即时执行集成
-export { Session } from "./session/Session.js";
+export { Executor } from "./session/Executor.js";
 export {
   drainDeferredPersistedUserMessages,
   getSessionRunScope,
@@ -70,8 +76,10 @@ export { JsonlSessionHistoryComposer } from "./session/composer/history/jsonl/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";
+export {
+  loadStaticSystemPrompts,
+  StaticPromptCatalog,
+} from "./session/composer/system/default/StaticPromptCatalog.js";
 
 // Agent server 与 transport 集成
 export { startServer } from "./server/http/Server.js";
@@ -84,10 +92,6 @@ export {
   startAllServices,
   stopAllServices,
 } from "./service/core/Manager.js";
-export {
-  startServiceScheduleRuntime,
-  stopServiceScheduleRuntime,
-} from "./service/schedule/Runtime.js";
 export { ServiceScheduleStore } from "./service/schedule/Store.js";
 export { parseScheduledRunAtMsOrThrow } from "./service/schedule/Time.js";
 export {
@@ -247,7 +251,6 @@ export type {
 export type {
   Service,
   ServiceAction,
-  ServiceActionApi,
   ServiceActionCommand,
   ServiceActionCommandInput,
   ServiceActionResult,

package/src/plugin/builtins/asr/InboundAugment.ts

@@ -6,7 +6,7 @@
  * - 转写失败不阻塞主链路，保持 best-effort。
  */
 
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { ChatInboundAugmentInput } from "@/service/builtins/chat/types/ChatPlugin.js";
 import type { JsonValue } from "@/types/common/Json.js";
 import { transcribeWithVoiceDependency } from "@/plugin/builtins/asr/Dependency.js";

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

@@ -6,7 +6,7 @@
  * - 授权核心模型为 role / permission / binding。
  */
 
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type {
   ChatAuthorizationConfig,
   ChatAuthorizationChannel,

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

@@ -14,7 +14,7 @@ import type {
   ChatAuthorizationSnapshot,
   ChatAuthorizationStateFile,
 } from "@/plugin/builtins/auth/types/AuthPlugin.js";
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { ChatDispatchChannel } from "@/service/builtins/chat/types/ChatDispatcher.js";
 
 function getAuthorizationStatePath(rootPath: string): string {

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

@@ -6,7 +6,7 @@
  * - 转写失败不阻塞主链路，保持 best-effort。
  */
 
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { ChatInboundAugmentInput } from "@/service/builtins/chat/types/ChatPlugin.js";
 import type { JsonValue } from "@/types/common/Json.js";
 import { transcribeWithVoiceDependency } from "@/plugin/builtins/voice/Dependency.js";

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

@@ -9,7 +9,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 type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { WorkboardSnapshot } from "@/plugin/builtins/workboard/types/Workboard.js";
 import {
   buildIdleActivity,
@@ -36,7 +36,7 @@ export async function collectWorkboardSnapshot(
     limit: WORKBOARD_RECENT_LIMIT + Math.max(executingSessionIds.size, 1),
     executingSessionIds,
   });
-  const services = listServiceStates();
+  const services = listServiceStates({ context });
   const taskResult = await listTaskDefinitions({ projectRoot: context.rootPath });
   const degradedCount = services.filter((item) => item.state !== "running").length;
 

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

@@ -15,7 +15,7 @@ import type {
   WorkboardSignalItem,
   WorkboardSummary,
 } from "@/plugin/builtins/workboard/types/Workboard.js";
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 
 function toIsoString(timestamp?: number): string {
   if (!timestamp || !Number.isFinite(timestamp)) {

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

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

package/src/plugin/core/Activation.ts

@@ -7,8 +7,8 @@
  */
 
 import type { Plugin } from "@/plugin/types/Plugin.js";
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
-import type { AgentRuntimeBase } from "@/runtime/AgentRuntimeTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
+import type { AgentRuntimeBase } from "@/core/AgentCoreTypes.js";
 
 /**
  * 读取当前 city 配置下的 plugin 启用态。

package/src/plugin/core/HookRegistry.ts

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

package/src/plugin/core/HttpRoutes.ts

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

package/src/plugin/core/LocalExecution.ts

@@ -16,8 +16,8 @@ import {
   createAgentPathRuntime,
   createAgentPluginConfigRuntime,
 } from "@/host/runtime/AgentHostRuntime.js";
-import { getAgentRuntimeBase } from "@/runtime/AgentRuntimeState.js";
 import type { JsonValue } from "@/types/common/Json.js";
+import type { AgentPlatformRuntime } from "@/types/host/AgentHost.js";
 import type {
   PluginActionResult,
   PluginAvailability,
@@ -25,6 +25,22 @@ import type {
   PluginView,
 } from "@/plugin/types/Plugin.js";
 
+function createLocalFallbackPlatformRuntime(): AgentPlatformRuntime {
+  return {
+    getGlobalEnv: () => ({}),
+    getAgentEnv: () => ({}),
+    listModels: () => [],
+    listProviders: async () => [],
+    getModel: () => null,
+    getChannelAccount: () => null,
+    readChatAuthorizationConfig: () => ({ roles: {}, channels: {} }),
+    writeChatAuthorizationConfig: async (_projectRoot: string, nextConfig: unknown) =>
+      nextConfig as never,
+    setChatAuthorizationUserRole: async () => ({ roles: {}, channels: {} }),
+    isPluginEnabled: (pluginName: string) => pluginName === "auth",
+  };
+}
+
 /**
  * 创建本地 plugin 命令上下文。
  */
@@ -39,25 +55,10 @@ export function createLocalPluginCommandContext(projectRoot: string): PluginComm
 
   defaultLogger.bindProjectRoot(rootPath);
 
-  const platform = (() => {
-    try {
-      return getAgentRuntimeBase().platform;
-    } catch {
-      return {
-        getGlobalEnv: () => ({}),
-        getAgentEnv: () => ({}),
-        listModels: () => [],
-        listProviders: async () => [],
-        getModel: () => null,
-        getChannelAccount: () => null,
-        readChatAuthorizationConfig: () => ({ roles: {}, channels: {} }),
-        writeChatAuthorizationConfig: async (_projectRoot: string, nextConfig: unknown) =>
-          nextConfig as never,
-        setChatAuthorizationUserRole: async () => ({ roles: {}, channels: {} }),
-        isPluginEnabled: (pluginName: string) => pluginName === "auth",
-      };
-    }
-  })();
+  // 关键点（中文）
+  // - 本地 plugin CLI 入口不应隐式依赖 agent 进程级 runtime。
+  // - 这里只提供最小宿主能力，保证离线/未启动 agent 的场景也能稳定执行。
+  const platform = createLocalFallbackPlatformRuntime();
 
   return {
     cwd: rootPath,

package/src/plugin/core/PluginRegistry.ts

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

package/src/plugin/types/Plugin.ts

@@ -17,7 +17,7 @@ import type {
 import type {
   AgentContext,
   StructuredConfig,
-} from "@/runtime/AgentContextTypes.js";
+} from "@/core/AgentContextTypes.js";
 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";

package/src/sandbox/SandboxConfigResolver.ts

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

package/src/sandbox/SandboxRunner.ts

@@ -7,7 +7,7 @@
  * - shell 命令不再允许回退到宿主机普通子进程执行。
  */
 
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+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";