@downcity/agent 1.1.25 → 1.1.35

package/bin/sdk/Agent.js

@@ -3,11 +3,11 @@
  *
  * 关键点（中文）
  * - `Agent` 现在是实例外观层，长期运行状态下沉到 `AgentCore`。
- * - session、HTTP、RPC、service lifecycle 都按需异步初始化。
+ * - session、HTTP、RPC、plugin lifecycle 都按需异步初始化。
  * - `start/stop` 是唯一公开的长期运行生命周期入口。
  */
 import { AgentCore } from "../core/AgentCore.js";
-import { startAllServices, stopAllServices } from "../service/core/Manager.js";
+import { startAllPlugins, stopAllPlugins } from "../plugin/core/Manager.js";
 import { startServer } from "../runtime/server/http/Server.js";
 import { startLocalRpcServer } from "../runtime/server/rpc/Server.js";
 /**
@@ -18,43 +18,53 @@ export class Agent {
     id;
     path;
     tools;
-    services;
     plugins;
-    servicesStarted = false;
+    pluginsStarted = false;
     startPromise = null;
     httpBinding = null;
     rpcBinding = null;
+    sessionCollection;
     constructor(options) {
         this.core = new AgentCore(options);
         this.id = this.core.id;
         this.path = this.core.path;
         this.tools = this.core.tools;
-        this.services = this.core.services;
         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) {
+        return await this.core.createSession(input);
     }
     /**
-     * 获取或创建一个 session。
+     * 获取一个已存在的 session。
      */
-    async session(sessionId) {
-        return await this.core.session(sessionId);
+    async getSession(sessionId) {
+        return await this.core.getSession(sessionId);
     }
     /**
-     * 列出当前 agent 的全部 session 元数据。
+     * 列出当前 agent 的 session 摘要页。
      */
-    async sessions() {
-        return await this.core.sessions();
+    async listSessions(input) {
+        return await this.core.listSessions(input);
     }
     /**
-     * 确保显式注入的 services 已启动。
+     * 确保当前 plugins 已启动。
      */
-    async ensureServicesStarted() {
-        if (this.servicesStarted)
+    async ensurePluginsStarted() {
+        if (this.pluginsStarted)
             return;
-        const lifecycle = await startAllServices(this.getContext());
-        this.servicesStarted = true;
+        const lifecycle = await startAllPlugins(this.core.getContext());
+        this.pluginsStarted = true;
         for (const item of lifecycle.results) {
             if (!item.success) {
-                this.getRuntime().logger.error(`Service start failed: ${item.service?.name || "unknown"} - ${item.error || "unknown error"}`);
+                this.core.getLogger().error(`Plugin start failed: ${item.plugin?.name || "unknown"} - ${item.error || "unknown error"}`);
             }
         }
     }
@@ -66,9 +76,9 @@ export class Agent {
             return await this.startPromise;
         }
         this.startPromise = (async () => {
-            const shouldStartServices = options?.services !== false;
-            if (shouldStartServices) {
-                await this.ensureServicesStarted();
+            const shouldStartPlugins = options?.plugins !== false;
+            if (shouldStartPlugins) {
+                await this.ensurePluginsStarted();
             }
             const httpBinding = options?.http === false || options?.http === undefined
                 ? undefined
@@ -79,7 +89,7 @@ export class Agent {
             return {
                 ...(httpBinding ? { http: httpBinding } : {}),
                 ...(rpcBinding ? { rpc: rpcBinding } : {}),
-                servicesStarted: this.servicesStarted,
+                pluginsStarted: this.pluginsStarted,
             };
         })();
         try {
@@ -94,12 +104,12 @@ export class Agent {
      * 停止当前 agent 实例的长期运行能力。
      */
     async stop() {
-        const servicesStarted = this.servicesStarted;
+        const pluginsStarted = this.pluginsStarted;
         const rpcStarted = this.rpcBinding !== null;
         const httpStarted = this.httpBinding !== null;
-        if (servicesStarted) {
-            await stopAllServices(this.getContext());
-            this.servicesStarted = false;
+        if (pluginsStarted) {
+            await stopAllPlugins(this.core.getContext());
+            this.pluginsStarted = false;
         }
         if (rpcStarted) {
             await this.stopRpc();
@@ -111,7 +121,7 @@ export class Agent {
         return {
             httpStopped: httpStarted,
             rpcStopped: rpcStarted,
-            servicesStopped: servicesStarted,
+            pluginsStopped: pluginsStarted,
         };
     }
     /**
@@ -125,16 +135,16 @@ export class Agent {
         this.core.setInstruction(input);
     }
     /**
-     * 返回实例级 runtime 视图。
+     * 返回当前项目根目录解析后的配置快照。
      */
-    getRuntime() {
-        return this.core.getRuntime();
+    getConfig() {
+        return this.core.getConfig();
     }
     /**
-     * 返回实例级执行上下文。
+     * 返回当前 agent 绑定的统一日志器。
      */
-    getContext() {
-        return this.core.getContext();
+    getLogger() {
+        return this.core.getLogger();
     }
     /**
      * 启动当前 agent 的 HTTP server。
@@ -150,7 +160,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}`,
@@ -178,7 +190,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,

package/bin/sdk/Agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"Agent.js","sourceRoot":"","sources":["../../src/sdk/Agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Agent.js","sourceRoot":"","sources":["../../src/sdk/Agent.ts"],"names":[],"mappings":"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"}

package/bin/sdk/AgentSdkTypes.d.ts

@@ -3,16 +3,22 @@
  *
  * 关键点（中文）
  * - 这里集中声明 `Agent` / `RemoteAgent` / `Session` 面向外部调用方的稳定接口。
- * - SDK 用户通过显式 `tools` / `services` / `plugins` 装配能力，不直接依赖内部 runtime 单例。
+ * - SDK 用户通过显式 `tools` / `plugins` 装配能力，不直接依赖内部 runtime 单例。
  * - 本地/远程 session 运行与基础落盘能力仍是 SDK 主路径。
  */
 import type { LanguageModel, Tool } from "ai";
-import type { BaseService } from "../service/builtins/BaseService.js";
-import type { Plugin } from "../plugin/types/Plugin.js";
+import type { BasePlugin } from "../plugin/core/BasePlugin.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";
+import type { SessionMessageV1 } from "../executor/types/SessionMessages.js";
+import type { AgentSessionSubscriber, AgentSessionUnsubscribe } from "../types/sdk/AgentSessionEvent.js";
+import type { AgentSessionPromptInput } from "../types/sdk/AgentSessionPrompt.js";
+import type { AgentSessionTurnHandle } from "../types/sdk/AgentSessionTurn.js";
+/**
+ * SDK Agent 插件装配模式。
+ */
+export type AgentMode = "preset" | "custom";
 /**
  * 本地 Agent 构造参数。
  */
@@ -56,39 +62,23 @@ export interface AgentOptions {
      */
     model?: LanguageModel;
     /**
-     * 当前 agent 显式持有的 service 实例集合。
-     *
-     * 关键点（中文）
-     * - 这里接收已经实例化好的 service，而不是 service class。
-     * - `Agent` 会在构造阶段按名称注册这些实例，并在启动时自动绑定 runtime。
-     * - v1 推荐显式传入 `new ChatService(...)` 这类实例，而不是依赖包内隐式注册表。
-     */
-    services?: BaseService[];
-    /**
-     * 是否自动装配全部内建 service。
+     * 当前 agent 的插件装配模式。
      *
      * 关键点（中文）
-     * - 适合 city 这类宿主进程直接 `new Agent(...)` 的场景。
-     * - 未开启时，默认只使用显式传入的 `services`。
+     * - `preset` 会自动装配内建插件集合。
+     * - `custom` 只使用显式传入的 `plugins`。
+     * - 默认值为 `custom`，避免本地嵌入场景隐式打开额外能力。
      */
-    useBuiltinServices?: boolean;
+    mode?: AgentMode;
     /**
-     * 当前 agent 显式注册的 plugin 定义集合。
+     * 当前 agent 显式持有的插件实例集合。
      *
      * 关键点（中文）
-     * - 这里接收完整 plugin 定义对象，而不是 plugin 名称。
-     * - `Agent` 会为当前 SDK 实例创建独立 plugin registry，避免污染全局 runtime。
+     * - 这里接收已经实例化好的 `BasePlugin` 对象，而不是 plugin class。
+     * - `Agent` 会在构造阶段按名称注册这些实例，并自动绑定到当前 runtime。
      * - 同名 plugin 会直接报错，避免 action / hook / resolve 行为被静默覆盖。
      */
-    plugins?: Plugin[];
-    /**
-     * 是否自动装配全部内建 plugin。
-     *
-     * 关键点（中文）
-     * - 适合 city 这类宿主进程直接 `new Agent(...)` 的场景。
-     * - 未开启时，默认只使用显式传入的 `plugins`。
-     */
-    useBuiltinPlugins?: boolean;
+    plugins?: BasePlugin[];
     /**
      * 当前 agent 显式注入的平台能力集合。
      *
@@ -104,9 +94,9 @@ export interface AgentOptions {
      * - SDK 不负责默认模型策略，宿主可在这里统一为 session 注入 model 等运行配置。
      * - 若同时传入 `model`，则会先写入默认模型，再执行这里的宿主覆写逻辑。
      * - 该钩子对每个 session 只触发一次，适合做实例级默认装配。
-     * - 触发时机可能来自显式 `agent.session()`，也可能来自该 session 的首次执行入口。
+     * - 触发时机可能来自显式 `agent.createSession()` / `agent.getSession()`，也可能来自该 session 的首次执行入口。
      */
-    configureSession?: (session: Session) => Promise<void> | void;
+    configureSession?: (session: AgentSession) => Promise<void> | void;
 }
 /**
  * Agent 启动参数。
@@ -130,13 +120,13 @@ export interface AgentStartOptions {
      */
     rpc?: boolean;
     /**
-     * 是否启动当前 agent 的 services。
+     * 是否启动当前 agent 的 plugins。
      *
      * 关键点（中文）
      * - 默认 `true`。
      * - `false` 适合只需要 session 能力、不希望启动后台能力的嵌入场景。
      */
-    services?: boolean;
+    plugins?: boolean;
 }
 /**
  * Agent 停止结果快照。
@@ -151,9 +141,9 @@ export interface AgentStopResult {
      */
     rpcStopped: boolean;
     /**
-     * 本次是否实际停止了 services。
+     * 本次是否实际停止了 plugins。
      */
-    servicesStopped: boolean;
+    pluginsStopped: boolean;
 }
 /**
  * Agent 启动后的状态快照。
@@ -168,9 +158,9 @@ export interface AgentStartResult {
      */
     rpc?: AgentRpcBinding;
     /**
-     * 当前 agent 是否已启动 services。
+     * 当前 agent 是否已启动 plugins。
      */
-    servicesStarted: boolean;
+    pluginsStarted: boolean;
 }
 /**
  * Agent HTTP 启动参数。
@@ -230,6 +220,49 @@ export interface RemoteAgentOptions {
      */
     baseUrl: string;
 }
+/**
+ * 新建 session 的输入参数。
+ */
+export interface AgentCreateSessionInput {
+    /**
+     * 可选显式 sessionId。
+     *
+     * 关键点（中文）
+     * - 传入时表达“创建意图”。
+     * - 若该 session 已存在，SDK 应直接报错，而不是静默复用。
+     * - 省略时由 SDK 自动生成稳定且不可推导的 sessionId。
+     */
+    sessionId?: string;
+}
+/**
+ * Session 列表查询输入。
+ */
+export interface AgentListSessionsInput {
+    /**
+     * 当前页返回上限。
+     *
+     * 说明（中文）
+     * - 省略时由 SDK 使用默认值。
+     * - 建议宿主 UI 明确传入，避免在大量 session 下拉取过多数据。
+     */
+    limit?: number;
+    /**
+     * 分页游标。
+     *
+     * 说明（中文）
+     * - 当前使用 SDK 自身生成的透明字符串游标。
+     * - 调用方只负责透传，不应自行解析其内部格式。
+     */
+    cursor?: string;
+    /**
+     * 关键词过滤。
+     *
+     * 说明（中文）
+     * - 推荐用于匹配 `sessionId`、标题与预览文本。
+     * - 属于轻量包含匹配，不承诺复杂搜索语义。
+     */
+    query?: string;
+}
 /**
  * Session 可变配置。
  */
@@ -256,10 +289,53 @@ export interface AgentSessionConfigSnapshot {
      */
     modelLabel?: string;
 }
+/**
+ * Session 历史视图类型。
+ */
+export type AgentSessionHistoryView = "message" | "timeline";
+/**
+ * Session 时间线事件。
+ */
+export interface AgentSessionTimelineEvent {
+    /**
+     * 当前事件唯一标识。
+     */
+    id: string;
+    /**
+     * 当前事件角色。
+     *
+     * 说明（中文）
+     * - `tool-call` / `tool-result` 用于把 assistant 内部工具过程平铺给 UI。
+     */
+    role: "user" | "assistant" | "tool-call" | "tool-result";
+    /**
+     * 事件时间戳（毫秒）。
+     */
+    ts?: number;
+    /**
+     * 事件所属消息种类。
+     */
+    kind?: string;
+    /**
+     * 事件来源。
+     */
+    source?: string;
+    /**
+     * 当前事件展示文本。
+     */
+    text: string;
+    /**
+     * 当前事件对应工具名称。
+     *
+     * 说明（中文）
+     * - 仅 `tool-call` / `tool-result` 这类事件通常会携带该字段。
+     */
+    toolName?: string;
+}
 /**
  * Session system block 来源类型。
  */
-export type AgentSessionSystemBlockSource = "core" | "instruction" | "service" | "plugin" | "session";
+export type AgentSessionSystemBlockSource = "core" | "instruction" | "plugin" | "session";
 /**
  * Session system prompt 的单个组成块。
  */
@@ -273,7 +349,7 @@ export interface AgentSessionSystemBlock {
      *
      * 说明（中文）
      * - `instruction` 通常使用 `agent`。
-     * - `service` / `plugin` 使用对应 service/plugin 名称。
+     * - `plugin` 使用对应 plugin 名称。
      * - `core` 使用 `default`。
      * - `session` 使用当前 session 上下文名称。
      */
@@ -343,9 +419,9 @@ export interface AgentSessionSystemSnapshot {
     blocks: AgentSessionSystemBlock[];
 }
 /**
- * Session 元数据列表项。
+ * Session 摘要。
  */
-export interface AgentSessionMetadata {
+export interface AgentSessionSummary {
     /**
      * 当前 session 所属 agentId。
      */
@@ -354,6 +430,22 @@ export interface AgentSessionMetadata {
      * 当前 session 唯一标识。
      */
     sessionId: string;
+    /**
+     * 当前 session 可读标题。
+     *
+     * 说明（中文）
+     * - 当前 SDK 不要求标题一定存在。
+     * - 若调用方需要展示列表标题，可优先使用这里；为空时再回退到 `sessionId`。
+     */
+    title?: string;
+    /**
+     * 当前 session 的最近预览文本。
+     *
+     * 说明（中文）
+     * - 通常来自最后一条用户可见消息的裁剪文本。
+     * - 适合用于侧边栏、列表卡片或 session picker。
+     */
+    previewText?: string;
     /**
      * 当前 session 首次创建时间（ms）。
      */
@@ -370,6 +462,110 @@ export interface AgentSessionMetadata {
      * 当前 session 绑定模型的可读标签。
      */
     modelLabel?: string;
+    /**
+     * 当前 session 是否处于执行中。
+     */
+    executing?: boolean;
+}
+/**
+ * Session 详情。
+ */
+export interface AgentSessionInfo extends AgentSessionSummary {
+    /**
+     * 当前 session 初始化时记录的时区。
+     */
+    timezone?: string;
+}
+/**
+ * Session 摘要分页结果。
+ */
+export interface AgentSessionSummaryPage {
+    /**
+     * 当前页 session 摘要列表。
+     */
+    items: AgentSessionSummary[];
+    /**
+     * 当前页所对应的总条数。
+     *
+     * 说明（中文）
+     * - 这里表示过滤后的总数，不是仅当前页数量。
+     * - 对分页 UI、结果统计和空态判断更友好。
+     */
+    total: number;
+    /**
+     * 下一页游标。
+     */
+    nextCursor?: string;
+    /**
+     * 是否仍有更多结果。
+     */
+    hasMore: boolean;
+}
+/**
+ * Session 历史读取输入。
+ */
+export interface AgentSessionHistoryInput {
+    /**
+     * 当前页返回上限。
+     */
+    limit?: number;
+    /**
+     * 分页游标。
+     */
+    cursor?: string;
+    /**
+     * 返回顺序。
+     *
+     * 说明（中文）
+     * - `asc`：从旧到新
+     * - `desc`：从新到旧
+     */
+    order?: "asc" | "desc";
+    /**
+     * 返回视图类型。
+     *
+     * 说明（中文）
+     * - `message`：原始 session 消息
+     * - `timeline`：适合直接渲染 UI 的平铺事件
+     */
+    view?: AgentSessionHistoryView;
+}
+/**
+ * Session 历史分页结果。
+ */
+export interface AgentSessionHistoryPage {
+    /**
+     * 当前读取所对应的 session 信息。
+     */
+    session: AgentSessionInfo;
+    /**
+     * 当前页实际返回视图。
+     */
+    view: AgentSessionHistoryView;
+    /**
+     * 当前页数据列表。
+     *
+     * 说明（中文）
+     * - `view=message` 时返回 `SessionMessageV1[]`
+     * - `view=timeline` 时返回 `AgentSessionTimelineEvent[]`
+     */
+    items: SessionMessageV1[] | AgentSessionTimelineEvent[];
+    /**
+     * 过滤前后的总条数。
+     *
+     * 说明（中文）
+     * - 对 `view=message` 表示消息条数。
+     * - 对 `view=timeline` 表示时间线事件条数。
+     */
+    total: number;
+    /**
+     * 下一页游标。
+     */
+    nextCursor?: string;
+    /**
+     * 是否仍有更多数据。
+     */
+    hasMore: boolean;
 }
 /**
  * Session fork 输入。
@@ -384,4 +580,80 @@ export interface AgentSessionForkInput {
      */
     messageId?: string;
 }
+/**
+ * SDK Session 集合绑定。
+ */
+export interface AgentSessionCollection {
+    /**
+     * 新建一个 session。
+     */
+    createSession(input?: AgentCreateSessionInput): Promise<AgentSession>;
+    /**
+     * 获取一个已存在的 session。
+     */
+    getSession(sessionId: string): Promise<AgentSession>;
+    /**
+     * 列出当前 agent 的 session 摘要页。
+     */
+    listSessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
+}
+/**
+ * Session actor 公共能力。
+ */
+export interface AgentSessionActor {
+    /**
+     * 当前 session 稳定标识。
+     */
+    readonly id: string;
+    /**
+     * 读取当前 session 详情。
+     */
+    getInfo(): Promise<AgentSessionInfo>;
+    /**
+     * 追加一条新的 prompt。
+     */
+    prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
+    /**
+     * 订阅当前 session 的未来事件。
+     */
+    subscribe(subscriber: AgentSessionSubscriber): AgentSessionUnsubscribe;
+    /**
+     * 读取当前 session 历史分页。
+     */
+    history(input?: AgentSessionHistoryInput): Promise<AgentSessionHistoryPage>;
+    /**
+     * 读取当前 session 生效的 system 快照。
+     */
+    system(): Promise<AgentSessionSystemSnapshot>;
+}
+/**
+ * 本地 Agent 返回的公开 session 接口。
+ */
+export interface AgentSession extends AgentSessionActor {
+    /**
+     * 当前 session 所属 agentId。
+     */
+    readonly agentId: string;
+    /**
+     * 当前 session 配置快照。
+     */
+    readonly config: AgentSessionConfigSnapshot;
+    /**
+     * 写入当前 session 默认配置。
+     */
+    set(input: AgentSessionSetInput): Promise<void>;
+    /**
+     * 从当前 session 创建一个分叉会话。
+     */
+    fork(input?: AgentSessionForkInput | string): Promise<AgentSession>;
+}
+/**
+ * 远程 Agent 返回的公开 session 接口。
+ */
+export interface RemoteAgentSession extends AgentSessionActor {
+    /**
+     * 从当前远程 session 创建一个分叉会话。
+     */
+    fork(input?: AgentSessionForkInput | string): Promise<RemoteAgentSession>;
+}
 //# sourceMappingURL=AgentSdkTypes.d.ts.map