@downcity/agent 1.1.13 → 1.1.14

package/bin/sandbox/SandboxConfigResolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxConfigResolver.d.ts","sourceRoot":"","sources":["../../src/sandbox/SandboxConfigResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AA0B/E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAM9E;AAwCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,qBAAqB,CAqBjF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;CACvB,GAAG,MAAM,CAUT"}
+{"version":3,"file":"SandboxConfigResolver.d.ts","sourceRoot":"","sources":["../../src/sandbox/SandboxConfigResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AA0B/E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAM9E;AAwCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,qBAAqB,CAqBjF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;CACvB,GAAG,MAAM,CAUT"}

package/bin/sandbox/SandboxRunner.d.ts

@@ -6,7 +6,7 @@
  * - 当前版本只接入 macOS seatbelt backend。
  * - shell 命令不再允许回退到宿主机普通子进程执行。
  */
-import type { AgentContext } from "../runtime/AgentContextTypes.js";
+import type { AgentContext } from "../core/AgentContextTypes.js";
 import type { SandboxSpawnResult } from "../sandbox/types/SandboxRuntime.js";
 /**
  * 启动 shell 子进程。

package/bin/sandbox/SandboxRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxRunner.d.ts","sourceRoot":"","sources":["../../src/sandbox/SandboxRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAI5E;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC;CAC5B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkB9B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC;CAC5B,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;CAC3B,CAAC,CAiCD"}
+{"version":3,"file":"SandboxRunner.d.ts","sourceRoot":"","sources":["../../src/sandbox/SandboxRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAI5E;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC;CAC5B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkB9B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC;CAC5B,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;CAC3B,CAAC,CAiCD"}

package/bin/sdk/Agent.d.ts

@@ -2,21 +2,25 @@
  * Agent SDK 本地入口。
  *
  * 关键点（中文）
- * - `new Agent({ id, path, instruction, tools, services, plugins })` 只做同步装配，不在构造阶段启动任何 I/O。
+ * - `Agent` 现在是实例外观层，长期运行状态下沉到 `AgentCore`。
  * - session、HTTP、RPC、service lifecycle 都按需异步初始化。
- * - SDK Agent 通过最小 `AgentContext` 适配层复用现有 service/plugin/chat 运行协议，而不是重复实现一套执行链。
+ * - `start/stop` 负责统一收口当前 agent 实例的生命周期。
  */
 import type { Tool } from "ai";
 import type { BaseService } from "../service/builtins/BaseService.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 { AgentOptions, AgentSessionMetadata } from "../sdk/AgentSdkTypes.js";
+import type { AgentOptions, AgentStartOptions, AgentStartResult, AgentStopResult, AgentSessionMetadata } from "../sdk/AgentSdkTypes.js";
 import { Session } from "../sdk/Session.js";
 import { SdkAgentHttpServer } from "../sdk/HttpServer.js";
 import { SdkAgentRpcServer } from "../sdk/RpcServer.js";
+import { AgentCore } from "../core/AgentCore.js";
 /**
  * SDK 本地 Agent。
  */
 export declare class Agent {
+    readonly core: AgentCore;
     readonly id: string;
     readonly path: string;
     readonly tools: Record<string, Tool>;
@@ -24,16 +28,8 @@ export declare class Agent {
     readonly rpc: SdkAgentRpcServer;
     readonly services: Map<string, BaseService>;
     readonly plugins: PluginPort;
-    private readonly logger;
-    private readonly sessionsById;
-    private readonly runtime;
-    private readonly serviceContext;
-    private readonly pluginRegistry;
-    private readonly pluginSystemProviders;
-    private readonly config;
-    private readonly platform;
-    private instruction;
-    private servicesStartPromise;
+    private servicesStarted;
+    private startPromise;
     constructor(options: AgentOptions);
     /**
      * 获取或创建一个 session。
@@ -47,6 +43,14 @@ export declare class Agent {
      * 确保显式注入的 services 已启动。
      */
     ensureServicesStarted(): Promise<void>;
+    /**
+     * 启动当前 agent 实例的长期运行能力。
+     */
+    start(options?: AgentStartOptions): Promise<AgentStartResult>;
+    /**
+     * 停止当前 agent 实例的长期运行能力。
+     */
+    stop(): Promise<AgentStopResult>;
     /**
      * 更新当前 SDK Agent 的静态基础指令。
      *
@@ -55,15 +59,13 @@ export declare class Agent {
      * - 已创建的 session 后续 run 会读取最新 instruction blocks。
      */
     setInstruction(input: string | string[]): void;
-    private loadConfig;
-    private createServiceMap;
-    private createPluginRegistry;
-    private createPluginPort;
-    private loadInstructionSystemBlocks;
-    private loadPluginSystemBlocks;
-    private loadServiceSystemBlocks;
-    private createRuntime;
-    private createServiceContext;
-    private getOrCreateSession;
+    /**
+     * 返回实例级 runtime 视图。
+     */
+    getRuntime(): AgentRuntime;
+    /**
+     * 返回实例级执行上下文。
+     */
+    getContext(): AgentContext;
 }
 //# sourceMappingURL=Agent.d.ts.map

package/bin/sdk/Agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../src/sdk/Agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAMrE,OAAO,KAAK,EAGV,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EAErB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AA0EvD;;GAEG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8B;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAe;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,oBAAoB,CAA8B;gBAE9C,OAAO,EAAE,YAAY;IAiCjC;;OAEG;IACG,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMnD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAqBjD;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5C;;;;;;OAMG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAI9C,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,2BAA2B;YAIrB,sBAAsB;YAwBtB,uBAAuB;IAmBrC,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,oBAAoB;IAiF5B,OAAO,CAAC,kBAAkB;CAmB3B"}
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../src/sdk/Agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACV,UAAU,EACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD;;GAEG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAA0C;gBAElD,OAAO,EAAE,YAAY;IAWjC;;OAEG;IACG,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAIjD;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5C;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkCnE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IA2BtC;;;;;;OAMG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAI9C;;OAEG;IACH,UAAU,IAAI,YAAY;IAI1B;;OAEG;IACH,UAAU,IAAI,YAAY;CAG3B"}

package/bin/sdk/Agent.js

@@ -2,83 +2,19 @@
  * Agent SDK 本地入口。
  *
  * 关键点（中文）
- * - `new Agent({ id, path, instruction, tools, services, plugins })` 只做同步装配，不在构造阶段启动任何 I/O。
+ * - `Agent` 现在是实例外观层，长期运行状态下沉到 `AgentCore`。
  * - session、HTTP、RPC、service lifecycle 都按需异步初始化。
- * - SDK Agent 通过最小 `AgentContext` 适配层复用现有 service/plugin/chat 运行协议，而不是重复实现一套执行链。
+ * - `start/stop` 负责统一收口当前 agent 实例的生命周期。
  */
-import fs from "fs-extra";
-import { nanoid } from "nanoid";
-import { Logger } from "../utils/logger/Logger.js";
-import { Session } from "../sdk/Session.js";
-import { DEFAULT_SHIP_PROMPTS } from "../session/composer/system/default/SystemDomain.js";
-import { getSdkAgentSessionsRootDirPath } from "../sdk/Paths.js";
 import { SdkAgentHttpServer } from "../sdk/HttpServer.js";
 import { SdkAgentRpcServer } from "../sdk/RpcServer.js";
-import { createAgentPathRuntime, createAgentPluginConfigRuntime, } from "../host/runtime/AgentHostRuntime.js";
-import { loadDowncityConfig } from "../config/Config.js";
-import { appendExecSessionMessage } from "../service/builtins/chat/runtime/ChatIngressStore.js";
-import { readChatMetaBySessionId } from "../service/builtins/chat/runtime/ChatMetaStore.js";
-import { resolveChatQueueStore } from "../service/builtins/chat/runtime/ChatQueueStore.js";
-import { HookRegistry } from "../plugin/core/HookRegistry.js";
-import { PluginRegistry } from "../plugin/core/PluginRegistry.js";
-import { isPluginEnabled } from "../plugin/core/Activation.js";
-const EMPTY_SDK_PLATFORM = {
-    getGlobalEnv: () => ({}),
-    getAgentEnv: () => ({}),
-    listModels: () => [],
-    listProviders: async () => [],
-    getModel: () => null,
-    getChannelAccount: () => null,
-    readChatAuthorizationConfig: () => ({
-        roles: {},
-        channels: {},
-    }),
-    writeChatAuthorizationConfig: async (_projectRoot, nextConfig) => nextConfig,
-    setChatAuthorizationUserRole: async () => ({
-        roles: {},
-        channels: {},
-    }),
-    isPluginEnabled: (pluginName) => pluginName === "auth",
-};
-function createFallbackSdkConfig(agentId) {
-    return {
-        name: agentId,
-        version: "0.0.0",
-    };
-}
-function normalizeInstructionInput(input) {
-    const items = Array.isArray(input) ? input : typeof input === "string" ? [input] : [];
-    return items
-        .map((item) => String(item || "").trim())
-        .filter((item) => item.length > 0);
-}
-function createCoreInstructionContent(projectRoot) {
-    const currentYear = String(new Date().getFullYear());
-    return DEFAULT_SHIP_PROMPTS
-        .replaceAll("{{project_path}}", projectRoot)
-        .replaceAll("{{project_root}}", projectRoot)
-        .replaceAll("{{current_year}}", currentYear);
-}
-function createInstructionSystemBlocks(instruction, projectRoot) {
-    if (instruction.length === 0) {
-        return [
-            {
-                source: "core",
-                name: "default",
-                content: createCoreInstructionContent(projectRoot),
-            },
-        ];
-    }
-    return instruction.map((content, index) => ({
-        source: "instruction",
-        name: instruction.length === 1 ? "agent" : `agent:${index + 1}`,
-        content,
-    }));
-}
+import { AgentCore } from "../core/AgentCore.js";
+import { startAllServices, stopAllServices } from "../service/core/Manager.js";
 /**
  * SDK 本地 Agent。
  */
 export class Agent {
+    core;
     id;
     path;
     tools;
@@ -86,44 +22,15 @@ export class Agent {
     rpc;
     services;
     plugins;
-    logger;
-    sessionsById = new Map();
-    runtime;
-    serviceContext;
-    pluginRegistry;
-    pluginSystemProviders;
-    config;
-    platform;
-    instruction;
-    servicesStartPromise = null;
+    servicesStarted = false;
+    startPromise = null;
     constructor(options) {
-        this.id = String(options.id || "").trim();
-        this.path = String(options.path || "").trim();
-        this.tools = options.tools && typeof options.tools === "object"
-            ? { ...options.tools }
-            : {};
-        if (!this.id) {
-            throw new Error("Agent requires a non-empty id");
-        }
-        if (!this.path) {
-            throw new Error("Agent requires a non-empty path");
-        }
-        this.logger = new Logger();
-        this.logger.bindProjectRoot(this.path);
-        this.platform = options.platform || EMPTY_SDK_PLATFORM;
-        this.instruction = normalizeInstructionInput(options.instruction);
-        this.config = this.loadConfig();
-        this.services = this.createServiceMap(options.services || []);
-        this.runtime = this.createRuntime();
-        for (const service of this.services.values()) {
-            service.bindAgent(this.runtime);
-        }
-        this.pluginSystemProviders = Array.isArray(options.plugins)
-            ? [...options.plugins]
-            : [];
-        this.pluginRegistry = this.createPluginRegistry(this.pluginSystemProviders);
-        this.plugins = this.createPluginPort();
-        this.serviceContext = this.createServiceContext();
+        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.http = new SdkAgentHttpServer(this);
         this.rpc = new SdkAgentRpcServer(this);
     }
@@ -131,291 +38,105 @@ export class Agent {
      * 获取或创建一个 session。
      */
     async session(sessionId) {
-        const session = this.getOrCreateSession(sessionId);
-        await session.initialize();
-        return session;
+        return await this.core.session(sessionId);
     }
     /**
      * 列出当前 agent 的全部 session 元数据。
      */
     async sessions() {
-        const rootDir = getSdkAgentSessionsRootDirPath(this.path, this.id);
-        if (!(await fs.pathExists(rootDir)))
-            return [];
-        const entries = await fs.readdir(rootDir, { withFileTypes: true });
-        const items = [];
-        for (const entry of entries) {
-            if (!entry.isDirectory())
-                continue;
-            let sessionId = "";
-            try {
-                sessionId = decodeURIComponent(entry.name);
-            }
-            catch {
-                sessionId = entry.name;
-            }
-            if (!sessionId)
-                continue;
-            const session = await this.session(sessionId);
-            items.push(await session.toMetadata());
-        }
-        items.sort((a, b) => (b.updatedAt || 0) - (a.updatedAt || 0));
-        return items;
+        return await this.core.sessions();
     }
     /**
      * 确保显式注入的 services 已启动。
      */
     async ensureServicesStarted() {
-        if (this.servicesStartPromise) {
-            await this.servicesStartPromise;
+        if (this.servicesStarted)
             return;
-        }
-        this.servicesStartPromise = (async () => {
-            for (const service of this.services.values()) {
-                await service.lifecycle?.start?.(this.serviceContext);
+        const lifecycle = await startAllServices(this.getContext());
+        this.servicesStarted = 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"}`);
             }
-        })();
-        await this.servicesStartPromise;
+        }
     }
     /**
-     * 更新当前 SDK Agent 的静态基础指令。
-     *
-     * 关键点（中文）
-     * - instruction 不做动态变量替换。
-     * - 已创建的 session 后续 run 会读取最新 instruction blocks。
+     * 启动当前 agent 实例的长期运行能力。
      */
-    setInstruction(input) {
-        this.instruction = normalizeInstructionInput(input);
-    }
-    loadConfig() {
+    async start(options) {
+        if (this.startPromise) {
+            return await this.startPromise;
+        }
+        this.startPromise = (async () => {
+            const shouldStartServices = options?.services !== false;
+            if (shouldStartServices) {
+                await this.ensureServicesStarted();
+            }
+            const httpBinding = options?.http === false || options?.http === undefined
+                ? undefined
+                : await this.http.start(options.http);
+            const rpcBinding = options?.rpc === true
+                ? await this.rpc.start()
+                : undefined;
+            return {
+                ...(httpBinding ? { http: httpBinding } : {}),
+                ...(rpcBinding ? { rpc: rpcBinding } : {}),
+                servicesStarted: this.servicesStarted,
+            };
+        })();
         try {
-            return loadDowncityConfig(this.path, {
-                projectEnv: {},
-                agentEnv: {},
-                globalEnv: {},
-            });
+            return await this.startPromise;
         }
-        catch {
-            return createFallbackSdkConfig(this.id);
+        catch (error) {
+            this.startPromise = null;
+            throw error;
         }
     }
-    createServiceMap(input) {
-        const services = new Map();
-        for (const service of input) {
-            const name = String(service?.name || "").trim();
-            if (!name) {
-                throw new Error("Agent received a service without a valid name");
-            }
-            if (services.has(name)) {
-                throw new Error(`Duplicate service registration: ${name}`);
-            }
-            services.set(name, service);
+    /**
+     * 停止当前 agent 实例的长期运行能力。
+     */
+    async stop() {
+        const servicesStarted = this.servicesStarted;
+        const rpcStarted = this.rpc.isStarted();
+        const httpStarted = this.http.isStarted();
+        if (servicesStarted) {
+            await stopAllServices(this.getContext());
+            this.servicesStarted = false;
         }
-        return services;
-    }
-    createPluginRegistry(input) {
-        let pluginRegistryRef = null;
-        const hookRegistry = new HookRegistry({
-            contextResolver: () => this.serviceContext,
-            pluginEnabledChecker: (pluginName) => {
-                const plugin = pluginRegistryRef?.get(pluginName);
-                return plugin ? isPluginEnabled({ plugin, context: this.serviceContext }) : false;
-            },
-        });
-        const registry = new PluginRegistry({
-            contextResolver: () => this.serviceContext,
-            hookRegistry,
-        });
-        pluginRegistryRef = registry;
-        for (const plugin of input) {
-            registry.register(plugin);
+        if (rpcStarted) {
+            await this.rpc.stop();
         }
-        return registry;
-    }
-    createPluginPort() {
+        if (httpStarted) {
+            await this.http.stop();
+        }
+        this.startPromise = null;
         return {
-            list: () => this.pluginRegistry.list(),
-            availability: async (pluginName) => await this.pluginRegistry.availability(pluginName),
-            runAction: async (params) => await this.pluginRegistry.runAction(params),
-            pipeline: async (pointName, value) => await this.pluginRegistry.pipeline(pointName, value),
-            guard: async (pointName, value) => {
-                await this.pluginRegistry.guard(pointName, value);
-            },
-            effect: async (pointName, value) => {
-                await this.pluginRegistry.effect(pointName, value);
-            },
-            resolve: async (pointName, value) => await this.pluginRegistry.resolve(pointName, value),
+            httpStopped: httpStarted,
+            rpcStopped: rpcStarted,
+            servicesStopped: servicesStarted,
         };
     }
-    loadInstructionSystemBlocks() {
-        return createInstructionSystemBlocks(this.instruction, this.path);
-    }
-    async loadPluginSystemBlocks() {
-        const out = [];
-        for (const plugin of this.pluginSystemProviders) {
-            if (typeof plugin.system !== "function")
-                continue;
-            try {
-                if (!isPluginEnabled({ plugin, context: this.serviceContext }))
-                    continue;
-                if (typeof plugin.availability === "function") {
-                    const availability = await plugin.availability(this.serviceContext);
-                    if (!availability.available)
-                        continue;
-                }
-                const text = String(await plugin.system(this.serviceContext)).trim();
-                if (!text)
-                    continue;
-                out.push({
-                    source: "plugin",
-                    name: plugin.name,
-                    content: text,
-                });
-            }
-            catch {
-                // 单个 plugin system 失败不应阻断 SDK session 主链路。
-            }
-        }
-        return out;
-    }
-    async loadServiceSystemBlocks() {
-        const out = [];
-        for (const service of this.services.values()) {
-            if (typeof service.system !== "function")
-                continue;
-            try {
-                const text = String(await service.system(this.serviceContext)).trim();
-                if (!text)
-                    continue;
-                out.push({
-                    source: "service",
-                    name: service.name,
-                    content: text,
-                });
-            }
-            catch {
-                // 单个 service system 失败不应阻断 SDK session 主链路。
-            }
-        }
-        return out;
-    }
-    createRuntime() {
-        const runtime = {
-            cwd: this.path,
-            rootPath: this.path,
-            logger: this.logger,
-            config: this.config,
-            env: {},
-            globalEnv: {},
-            systems: this.instruction,
-            paths: createAgentPathRuntime(this.path),
-            pluginConfig: createAgentPluginConfigRuntime(this.path),
-            platform: this.platform,
-            model: undefined,
-            getSession: (sessionId) => {
-                return this.getOrCreateSession(sessionId).getServicePort();
-            },
-            listExecutingSessionIds: () => [...this.sessionsById.values()]
-                .filter((session) => session.isExecuting())
-                .map((session) => session.id),
-            getExecutingSessionCount: () => [...this.sessionsById.values()].filter((session) => session.isExecuting()).length,
-            services: this.services,
-        };
-        return runtime;
+    /**
+     * 更新当前 SDK Agent 的静态基础指令。
+     *
+     * 关键点（中文）
+     * - instruction 不做动态变量替换。
+     * - 已创建的 session 后续 run 会读取最新 instruction blocks。
+     */
+    setInstruction(input) {
+        this.core.setInstruction(input);
     }
-    createServiceContext() {
-        let context;
-        context = {
-            agent: this.runtime,
-            cwd: this.path,
-            rootPath: this.path,
-            logger: this.logger,
-            config: this.config,
-            env: {},
-            globalEnv: {},
-            systems: this.instruction,
-            paths: this.runtime.paths,
-            pluginConfig: this.runtime.pluginConfig,
-            platform: this.platform,
-            session: {
-                get: (sessionId) => this.getOrCreateSession(sessionId).getServicePort(),
-                listExecutingSessionIds: () => this.runtime.listExecutingSessionIds(),
-                getExecutingSessionCount: () => this.runtime.getExecutingSessionCount(),
-            },
-            invoke: {
-                invoke: async (params) => {
-                    const serviceName = String(params.service || "").trim();
-                    const actionName = String(params.action || "").trim();
-                    const service = this.services.get(serviceName);
-                    if (!service) {
-                        return {
-                            success: false,
-                            error: `Unknown service: ${serviceName}`,
-                        };
-                    }
-                    const action = service.actions[actionName];
-                    if (!action) {
-                        return {
-                            success: false,
-                            error: `Unknown action: ${serviceName}.${actionName}`,
-                        };
-                    }
-                    const result = await action.execute({
-                        context,
-                        payload: params.payload ?? null,
-                        serviceName,
-                        actionName,
-                    });
-                    if (!result.success) {
-                        return {
-                            success: false,
-                            ...(result.error ? { error: result.error } : {}),
-                        };
-                    }
-                    return {
-                        success: true,
-                        ...(result.data !== undefined ? { data: result.data } : {}),
-                    };
-                },
-            },
-            chat: {
-                readMetaBySessionId: async (sessionId) => {
-                    return await readChatMetaBySessionId({
-                        context,
-                        sessionId,
-                    });
-                },
-                appendExecSessionMessage: async (params) => {
-                    await appendExecSessionMessage({
-                        context,
-                        sessionId: params.sessionId,
-                        text: params.text,
-                        extra: params.extra,
-                    });
-                },
-                enqueue: (params) => resolveChatQueueStore(context).enqueue(params),
-            },
-            plugins: this.plugins,
-        };
-        return context;
+    /**
+     * 返回实例级 runtime 视图。
+     */
+    getRuntime() {
+        return this.core.getRuntime();
     }
-    getOrCreateSession(sessionId) {
-        const resolvedSessionId = String(sessionId || "").trim() || `session-${Date.now()}-${nanoid(8)}`;
-        const cached = this.sessionsById.get(resolvedSessionId);
-        if (cached)
-            return cached;
-        const created = new Session({
-            agentId: this.id,
-            projectRoot: this.path,
-            sessionId: resolvedSessionId,
-            tools: this.tools,
-            logger: this.logger,
-            getInstructionSystemBlocks: () => this.loadInstructionSystemBlocks(),
-            getServiceSystemBlocks: () => this.loadServiceSystemBlocks(),
-            getPluginSystemBlocks: () => this.loadPluginSystemBlocks(),
-        });
-        this.sessionsById.set(resolvedSessionId, created);
-        return created;
+    /**
+     * 返回实例级执行上下文。
+     */
+    getContext() {
+        return this.core.getContext();
     }
 }
 //# sourceMappingURL=Agent.js.map