@downcity/agent 1.1.32 → 1.1.35

package/src/runtime/server/http/sdk/SessionRoutes.ts

@@ -8,7 +8,10 @@
  */
 
 import { Hono } from "hono";
-import type { AgentCore } from "@/core/AgentCore.js";
+import type {
+  AgentListSessionsInput,
+  AgentSessionCollection,
+} from "@/sdk/AgentSdkTypes.js";
 import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js";
 import type { AgentSessionEvent } from "@/types/sdk/AgentSessionEvent.js";
 
@@ -22,14 +25,20 @@ const SDK_EVENTS_READY_FRAME = {
  */
 export function registerSdkSessionRoutes(
   app: Hono,
-  core: Pick<AgentCore, "session" | "sessions">,
+  sessionCollection: AgentSessionCollection,
 ): void {
   app.get("/api/sdk/sessions", async (c) => {
     try {
-      const sessions = await core.sessions();
+      const input: AgentListSessionsInput = {
+        ...(c.req.query("limit") ? { limit: Number(c.req.query("limit")) } : {}),
+        ...(c.req.query("cursor") ? { cursor: c.req.query("cursor") } : {}),
+        ...(c.req.query("query") ? { query: c.req.query("query") } : {}),
+      };
+      const page = await sessionCollection.listSessions(input);
       return c.json({
         success: true,
-        sessions,
+        page,
+        sessions: page.items,
       });
     } catch (error) {
       return c.json(
@@ -47,11 +56,34 @@ export function registerSdkSessionRoutes(
       const body = (await c.req.json().catch(() => ({}))) as {
         sessionId?: unknown;
       };
-      const rawSessionId = String(body.sessionId || "").trim();
-      const session = await core.session(rawSessionId || undefined);
+      const session = await sessionCollection.createSession({
+        ...(body.sessionId ? { sessionId: String(body.sessionId).trim() } : {}),
+      });
+      return c.json({
+        success: true,
+        session: await session.getInfo(),
+      });
+    } catch (error) {
+      return c.json(
+        {
+          success: false,
+          error: error instanceof Error ? error.message : String(error),
+        },
+        500,
+      );
+    }
+  });
+
+  app.get("/api/sdk/sessions/:sessionId", async (c) => {
+    try {
+      const sessionId = String(c.req.param("sessionId") || "").trim();
+      if (!sessionId) {
+        return c.json({ success: false, error: "Missing sessionId" }, 400);
+      }
+      const session = await sessionCollection.getSession(sessionId);
       return c.json({
         success: true,
-        session: await session.toMetadata(),
+        session: await session.getInfo(),
       });
     } catch (error) {
       return c.json(
@@ -71,7 +103,7 @@ export function registerSdkSessionRoutes(
         return c.json({ success: false, error: "Missing sessionId" }, 400);
       }
       const body = (await c.req.json()) as AgentSessionPromptInput;
-      const session = await core.session(sessionId);
+      const session = await sessionCollection.getSession(sessionId);
       const turn = await session.prompt(body);
       return c.json({
         success: true,
@@ -97,7 +129,7 @@ export function registerSdkSessionRoutes(
     }
 
     try {
-      const session = await core.session(sessionId);
+      const session = await sessionCollection.getSession(sessionId);
       const encoder = new TextEncoder();
       const requestSignal = c.req.raw.signal;
 
@@ -158,16 +190,52 @@ export function registerSdkSessionRoutes(
     }
   });
 
+  app.get("/api/sdk/sessions/:sessionId/history", async (c) => {
+    try {
+      const sessionId = String(c.req.param("sessionId") || "").trim();
+      if (!sessionId) {
+        return c.json({ success: false, error: "Missing sessionId" }, 400);
+      }
+      const session = await sessionCollection.getSession(sessionId);
+      const history = await session.history({
+        ...(c.req.query("limit") ? { limit: Number(c.req.query("limit")) } : {}),
+        ...(c.req.query("cursor") ? { cursor: c.req.query("cursor") } : {}),
+        ...(c.req.query("order")
+          ? { order: c.req.query("order") as "asc" | "desc" }
+          : {}),
+        ...(c.req.query("view")
+          ? { view: c.req.query("view") as "message" | "timeline" }
+          : {}),
+      });
+      return c.json({
+        success: true,
+        history,
+      });
+    } catch (error) {
+      return c.json(
+        {
+          success: false,
+          error: error instanceof Error ? error.message : String(error),
+        },
+        500,
+      );
+    }
+  });
+
   app.get("/api/sdk/sessions/:sessionId/messages", async (c) => {
     try {
       const sessionId = String(c.req.param("sessionId") || "").trim();
       if (!sessionId) {
         return c.json({ success: false, error: "Missing sessionId" }, 400);
       }
-      const session = await core.session(sessionId);
+      const session = await sessionCollection.getSession(sessionId);
+      const history = await session.history({
+        view: "message",
+      });
       return c.json({
         success: true,
-        messages: await session.history(),
+        messages: history.items,
+        history,
       });
     } catch (error) {
       return c.json(
@@ -186,7 +254,7 @@ export function registerSdkSessionRoutes(
       if (!sessionId) {
         return c.json({ success: false, error: "Missing sessionId" }, 400);
       }
-      const session = await core.session(sessionId);
+      const session = await sessionCollection.getSession(sessionId);
       return c.json({
         success: true,
         system: await session.system(),
@@ -211,13 +279,13 @@ export function registerSdkSessionRoutes(
       const body = (await c.req.json().catch(() => ({}))) as {
         messageId?: unknown;
       };
-      const session = await core.session(sessionId);
+      const session = await sessionCollection.getSession(sessionId);
       const forked = await session.fork(
         String(body.messageId || "").trim() || undefined,
       );
       return c.json({
         success: true,
-        session: await forked.toMetadata(),
+        session: await forked.getInfo(),
       });
     } catch (error) {
       return c.json(

package/src/runtime/server/rpc/Server.ts

@@ -11,20 +11,19 @@ import net, { type Server } from "node:net";
 import path from "node:path";
 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/runtime/rpc/LocalRpc.js";
 import type { ControlSessionExecuteRequestBody } from "@/runtime/server/http/control/types/ControlSessionExecute.js";
 import type {
   PluginActionResponse,
   PluginAvailabilityResponse,
-  PluginListResponse,
+  PluginCatalogResponse,
 } from "@/plugin/types/PluginApi.js";
 import type {
   PluginControlAction,
   PluginCommandResponse,
   PluginControlResponse,
-  PluginListResponse as RuntimePluginListResponse,
+  PluginStateListResponse,
 } from "@/plugin/types/Plugins.js";
 import { listPluginStates, controlPluginState } from "@/plugin/core/PluginStateController.js";
 import { runPluginCommand } from "@/plugin/core/PluginActionRunner.js";
@@ -253,9 +252,9 @@ async function dispatchRequest(params: {
   const { request } = params;
   if (
     request.method === "GET" &&
-    request.path === "/api/plugins/runtime/list"
+    request.path === "/api/plugins/list"
   ) {
-    const payload: RuntimePluginListResponse = {
+    const payload: PluginStateListResponse = {
       success: true,
       plugins: listPluginStates({ context: params.context }),
     };
@@ -263,7 +262,7 @@ async function dispatchRequest(params: {
   }
   if (
     request.method === "POST" &&
-    request.path === "/api/plugins/runtime/control"
+    request.path === "/api/plugins/control"
   ) {
     return await handlePluginControl({
       requestId: request.requestId,
@@ -273,7 +272,7 @@ async function dispatchRequest(params: {
   }
   if (
     request.method === "POST" &&
-    request.path === "/api/plugins/runtime/command"
+    request.path === "/api/plugins/command"
   ) {
     return await handlePluginCommand({
       requestId: request.requestId,
@@ -281,8 +280,8 @@ async function dispatchRequest(params: {
       context: params.context,
     });
   }
-  if (request.method === "GET" && request.path === "/api/plugins/list") {
-    const payload: PluginListResponse = {
+  if (request.method === "GET" && request.path === "/api/plugins/catalog") {
+    const payload: PluginCatalogResponse = {
       success: true,
       plugins: params.context.plugins.list(),
     };
@@ -377,23 +376,17 @@ function bindConnectionHandler(params: {
  * 启动本地 RPC server。
  */
 export async function startLocalRpcServer(params: {
-  context?: AgentContext;
-  runtime?: AgentRuntime;
-  core?: Pick<AgentCore, "getContext" | "getRuntime">;
+  context: AgentContext;
+  runtime: AgentRuntime;
 }): Promise<LocalRpcServerHandle> {
-  const context = params.context || params.core?.getContext();
-  if (!context) {
-    throw new Error("startLocalRpcServer requires a context or core");
-  }
-  const runtime = params.runtime || params.core?.getRuntime();
-  const endpoint = getLocalRpcEndpoint(context.rootPath);
+  const endpoint = getLocalRpcEndpoint(params.context.rootPath);
   await ensureEndpointReady(endpoint);
 
   const server = net.createServer();
   bindConnectionHandler({
     server,
-    context,
-    runtime,
+    context: params.context,
+    runtime: params.runtime,
   });
 
   await new Promise<void>((resolve, reject) => {

package/src/sdk/Agent.ts

@@ -3,18 +3,20 @@
  *
  * 关键点（中文）
  * - `Agent` 现在是实例外观层，长期运行状态下沉到 `AgentCore`。
- * - session、HTTP、RPC、runtime plugin lifecycle 都按需异步初始化。
+ * - session、HTTP、RPC、plugin lifecycle 都按需异步初始化。
  * - `start/stop` 是唯一公开的长期运行生命周期入口。
  */
 
 import type { Tool } from "ai";
-import type { BasePlugin } from "@/plugin/core/BasePlugin.js";
-import type { AgentContext } from "@/core/AgentContextTypes.js";
-import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
 import type {
   PluginPort,
 } from "@/plugin/types/Plugin.js";
+import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
+import type { Logger } from "@/utils/logger/Logger.js";
 import type {
+  AgentSession,
+  AgentCreateSessionInput,
+  AgentListSessionsInput,
   AgentOptions,
   AgentStartOptions,
   AgentStartResult,
@@ -22,9 +24,9 @@ import type {
   AgentHttpBinding,
   AgentHttpStartOptions,
   AgentRpcBinding,
-  AgentSessionMetadata,
+  AgentSessionCollection,
+  AgentSessionSummaryPage,
 } from "@/sdk/AgentSdkTypes.js";
-import { Session } from "@/sdk/Session.js";
 import { AgentCore } from "@/core/AgentCore.js";
 import { startAllPlugins, stopAllPlugins } from "@/plugin/core/Manager.js";
 import { startServer } from "@/runtime/server/http/Server.js";
@@ -34,50 +36,63 @@ import { startLocalRpcServer } from "@/runtime/server/rpc/Server.js";
  * SDK 本地 Agent。
  */
 export class Agent {
-  readonly core: AgentCore;
+  private readonly core: AgentCore;
   readonly id: string;
   readonly path: string;
   readonly tools: Record<string, Tool>;
-  readonly runtimePlugins: Map<string, BasePlugin>;
   readonly plugins: PluginPort;
-  private runtimePluginsStarted = false;
+  private pluginsStarted = false;
   private startPromise: Promise<AgentStartResult> | null = null;
   private httpBinding: AgentHttpBinding | null = null;
   private rpcBinding: AgentRpcBinding | null = null;
+  private readonly sessionCollection: AgentSessionCollection;
 
   constructor(options: AgentOptions) {
     this.core = new AgentCore(options);
     this.id = this.core.id;
     this.path = this.core.path;
     this.tools = this.core.tools;
-    this.runtimePlugins = this.core.runtimePlugins;
     this.plugins = this.core.plugins;
+    this.sessionCollection = {
+      createSession: async (input) => await this.core.createSession(input),
+      getSession: async (sessionId) => await this.core.getSession(sessionId),
+      listSessions: async (input) => await this.core.listSessions(input),
+    };
+  }
+
+  /**
+   * 新建一个 session。
+   */
+  async createSession(input?: AgentCreateSessionInput): Promise<AgentSession> {
+    return await this.core.createSession(input);
   }
 
   /**
-   * 获取或创建一个 session。
+   * 获取一个已存在的 session。
    */
-  async session(sessionId?: string): Promise<Session> {
-    return await this.core.session(sessionId);
+  async getSession(sessionId: string): Promise<AgentSession> {
+    return await this.core.getSession(sessionId);
   }
 
   /**
-   * 列出当前 agent 的全部 session 元数据。
+   * 列出当前 agent 的 session 摘要页。
    */
-  async sessions(): Promise<AgentSessionMetadata[]> {
-    return await this.core.sessions();
+  async listSessions(
+    input?: AgentListSessionsInput,
+  ): Promise<AgentSessionSummaryPage> {
+    return await this.core.listSessions(input);
   }
 
   /**
-   * 确保显式注入的 runtime plugins 已启动。
+   * 确保当前 plugins 已启动。
    */
-  async ensureRuntimePluginsStarted(): Promise<void> {
-    if (this.runtimePluginsStarted) return;
-    const lifecycle = await startAllPlugins(this.getContext());
-    this.runtimePluginsStarted = true;
+  private async ensurePluginsStarted(): Promise<void> {
+    if (this.pluginsStarted) return;
+    const lifecycle = await startAllPlugins(this.core.getContext());
+    this.pluginsStarted = true;
     for (const item of lifecycle.results) {
       if (!item.success) {
-        this.getRuntime().logger.error(
+        this.core.getLogger().error(
           `Plugin start failed: ${item.plugin?.name || "unknown"} - ${item.error || "unknown error"}`,
         );
       }
@@ -92,10 +107,10 @@ export class Agent {
       return await this.startPromise;
     }
     this.startPromise = (async () => {
-      const shouldStartRuntimePlugins = options?.runtimePlugins !== false;
+      const shouldStartPlugins = options?.plugins !== false;
 
-      if (shouldStartRuntimePlugins) {
-        await this.ensureRuntimePluginsStarted();
+      if (shouldStartPlugins) {
+        await this.ensurePluginsStarted();
       }
 
       const httpBinding =
@@ -110,7 +125,7 @@ export class Agent {
       return {
         ...(httpBinding ? { http: httpBinding } : {}),
         ...(rpcBinding ? { rpc: rpcBinding } : {}),
-        runtimePluginsStarted: this.runtimePluginsStarted,
+        pluginsStarted: this.pluginsStarted,
       };
     })();
     try {
@@ -125,13 +140,13 @@ export class Agent {
    * 停止当前 agent 实例的长期运行能力。
    */
   async stop(): Promise<AgentStopResult> {
-    const runtimePluginsStarted = this.runtimePluginsStarted;
+    const pluginsStarted = this.pluginsStarted;
     const rpcStarted = this.rpcBinding !== null;
     const httpStarted = this.httpBinding !== null;
 
-    if (runtimePluginsStarted) {
-      await stopAllPlugins(this.getContext());
-      this.runtimePluginsStarted = false;
+    if (pluginsStarted) {
+      await stopAllPlugins(this.core.getContext());
+      this.pluginsStarted = false;
     }
 
     if (rpcStarted) {
@@ -147,7 +162,7 @@ export class Agent {
     return {
       httpStopped: httpStarted,
       rpcStopped: rpcStarted,
-      runtimePluginsStopped: runtimePluginsStarted,
+      pluginsStopped: pluginsStarted,
     };
   }
 
@@ -163,17 +178,17 @@ export class Agent {
   }
 
   /**
-   * 返回实例级 runtime 视图。
+   * 返回当前项目根目录解析后的配置快照。
    */
-  getRuntime(): AgentRuntime {
-    return this.core.getRuntime();
+  getConfig(): DowncityConfig {
+    return this.core.getConfig();
   }
 
   /**
-   * 返回实例级执行上下文。
+   * 返回当前 agent 绑定的统一日志器。
    */
-  getContext(): AgentContext {
-    return this.core.getContext();
+  getLogger(): Logger {
+    return this.core.getLogger();
   }
 
   /**
@@ -193,7 +208,9 @@ export class Agent {
     const server = await startServer({
       host,
       port,
-      core: this.core,
+      getAgentRuntime: () => this.core.getRuntime(),
+      getAgentContext: () => this.core.getContext(),
+      sessionCollection: this.sessionCollection,
     });
     this.httpBinding = {
       baseUrl: `http://${host}:${port}`,
@@ -222,7 +239,8 @@ export class Agent {
       return this.rpcBinding;
     }
     const server = await startLocalRpcServer({
-      core: this.core,
+      context: this.core.getContext(),
+      runtime: this.core.getRuntime(),
     });
     this.rpcBinding = {
       endpoint: server.endpoint,