@downcity/agent 1.1.32 → 1.1.43

package/bin/sdk/Agent.js

@@ -1,200 +0,0 @@
-/**
- * Agent SDK 本地入口。
- *
- * 关键点（中文）
- * - `Agent` 现在是实例外观层，长期运行状态下沉到 `AgentCore`。
- * - session、HTTP、RPC、runtime plugin lifecycle 都按需异步初始化。
- * - `start/stop` 是唯一公开的长期运行生命周期入口。
- */
-import { AgentCore } from "../core/AgentCore.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";
-/**
- * SDK 本地 Agent。
- */
-export class Agent {
-    core;
-    id;
-    path;
-    tools;
-    runtimePlugins;
-    plugins;
-    runtimePluginsStarted = false;
-    startPromise = null;
-    httpBinding = null;
-    rpcBinding = null;
-    constructor(options) {
-        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;
-    }
-    /**
-     * 获取或创建一个 session。
-     */
-    async session(sessionId) {
-        return await this.core.session(sessionId);
-    }
-    /**
-     * 列出当前 agent 的全部 session 元数据。
-     */
-    async sessions() {
-        return await this.core.sessions();
-    }
-    /**
-     * 确保显式注入的 runtime plugins 已启动。
-     */
-    async ensureRuntimePluginsStarted() {
-        if (this.runtimePluginsStarted)
-            return;
-        const lifecycle = await startAllPlugins(this.getContext());
-        this.runtimePluginsStarted = true;
-        for (const item of lifecycle.results) {
-            if (!item.success) {
-                this.getRuntime().logger.error(`Plugin start failed: ${item.plugin?.name || "unknown"} - ${item.error || "unknown error"}`);
-            }
-        }
-    }
-    /**
-     * 启动当前 agent 实例的长期运行能力。
-     */
-    async start(options) {
-        if (this.startPromise) {
-            return await this.startPromise;
-        }
-        this.startPromise = (async () => {
-            const shouldStartRuntimePlugins = options?.runtimePlugins !== false;
-            if (shouldStartRuntimePlugins) {
-                await this.ensureRuntimePluginsStarted();
-            }
-            const httpBinding = options?.http === false || options?.http === undefined
-                ? undefined
-                : await this.startHttp(options.http);
-            const rpcBinding = options?.rpc === true
-                ? await this.startRpc()
-                : undefined;
-            return {
-                ...(httpBinding ? { http: httpBinding } : {}),
-                ...(rpcBinding ? { rpc: rpcBinding } : {}),
-                runtimePluginsStarted: this.runtimePluginsStarted,
-            };
-        })();
-        try {
-            return await this.startPromise;
-        }
-        catch (error) {
-            this.startPromise = null;
-            throw error;
-        }
-    }
-    /**
-     * 停止当前 agent 实例的长期运行能力。
-     */
-    async stop() {
-        const runtimePluginsStarted = this.runtimePluginsStarted;
-        const rpcStarted = this.rpcBinding !== null;
-        const httpStarted = this.httpBinding !== null;
-        if (runtimePluginsStarted) {
-            await stopAllPlugins(this.getContext());
-            this.runtimePluginsStarted = false;
-        }
-        if (rpcStarted) {
-            await this.stopRpc();
-        }
-        if (httpStarted) {
-            await this.stopHttp();
-        }
-        this.startPromise = null;
-        return {
-            httpStopped: httpStarted,
-            rpcStopped: rpcStarted,
-            runtimePluginsStopped: runtimePluginsStarted,
-        };
-    }
-    /**
-     * 更新当前 SDK Agent 的静态基础指令。
-     *
-     * 关键点（中文）
-     * - instruction 不做动态变量替换。
-     * - 已创建的 session 后续 run 会读取最新 instruction blocks。
-     */
-    setInstruction(input) {
-        this.core.setInstruction(input);
-    }
-    /**
-     * 返回实例级 runtime 视图。
-     */
-    getRuntime() {
-        return this.core.getRuntime();
-    }
-    /**
-     * 返回实例级执行上下文。
-     */
-    getContext() {
-        return this.core.getContext();
-    }
-    /**
-     * 启动当前 agent 的 HTTP server。
-     */
-    async startHttp(options) {
-        if (this.httpBinding) {
-            return this.httpBinding;
-        }
-        const host = String(options?.host || "127.0.0.1").trim() || "127.0.0.1";
-        const port = typeof options?.port === "number" && Number.isInteger(options.port)
-            ? options.port
-            : 15314;
-        const server = await startServer({
-            host,
-            port,
-            core: this.core,
-        });
-        this.httpBinding = {
-            baseUrl: `http://${host}:${port}`,
-            host,
-            port,
-            server,
-        };
-        return this.httpBinding;
-    }
-    /**
-     * 停止当前 agent 的 HTTP server。
-     */
-    async stopHttp() {
-        if (!this.httpBinding)
-            return;
-        const current = this.httpBinding;
-        this.httpBinding = null;
-        await current.server.stop();
-    }
-    /**
-     * 启动当前 agent 的本地 RPC server。
-     */
-    async startRpc() {
-        if (this.rpcBinding) {
-            return this.rpcBinding;
-        }
-        const server = await startLocalRpcServer({
-            core: this.core,
-        });
-        this.rpcBinding = {
-            endpoint: server.endpoint,
-            server,
-        };
-        return this.rpcBinding;
-    }
-    /**
-     * 停止当前 agent 的本地 RPC server。
-     */
-    async stopRpc() {
-        if (!this.rpcBinding)
-            return;
-        const current = this.rpcBinding;
-        this.rpcBinding = null;
-        await current.server.stop();
-    }
-}
-//# sourceMappingURL=Agent.js.map

package/bin/sdk/Agent.js.map

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

package/bin/sdk/AgentSdkTypes.d.ts

@@ -1,387 +0,0 @@
-/**
- * Agent SDK 对外类型定义。
- *
- * 关键点（中文）
- * - 这里集中声明 `Agent` / `RemoteAgent` / `Session` 面向外部调用方的稳定接口。
- * - SDK 用户通过显式 `tools` / `runtimePlugins` / `plugins` 装配能力，不直接依赖内部 runtime 单例。
- * - 本地/远程 session 运行与基础落盘能力仍是 SDK 主路径。
- */
-import type { LanguageModel, Tool } from "ai";
-import type { BasePlugin } from "../plugin/core/BasePlugin.js";
-import type { Plugin } from "../plugin/types/Plugin.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";
-/**
- * 本地 Agent 构造参数。
- */
-export interface AgentOptions {
-    /**
-     * 当前 agent 的稳定标识。
-     *
-     * 关键点（中文）
-     * - 用于 `.downcity/agents/<agentId>/...` 目录分区。
-     * - 应保持稳定、可 URL 编码、尽量不要依赖展示名称。
-     */
-    id: string;
-    /**
-     * 当前 agent 绑定的项目根目录。
-     */
-    path: string;
-    /**
-     * 当前 agent 默认可用的工具集合。
-     *
-     * 关键点（中文）
-     * - tools 归属于 agent 级，而不是 session 级。
-     * - session 运行时会直接复用这份工具集合。
-     */
-    tools?: Record<string, Tool>;
-    /**
-     * 调用方显式传入的静态基础指令。
-     *
-     * 关键点（中文）
-     * - `instruction` 是稳定、缓存友好的 system 前缀，不做动态变量替换。
-     * - SDK 不主动读取 `PROFILE.md` / `SOUL.md`；这类项目文件应由 city 或调用方读取后传入。
-     * - 未传入时，SDK 会使用包内最小 core instruction 作为 fallback。
-     */
-    instruction?: string | string[];
-    /**
-     * 当前 agent 为新建 session 提供的默认模型实例。
-     *
-     * 关键点（中文）
-     * - SDK 仍不负责“选择哪个模型”，这里只接收宿主已经创建好的 `LanguageModel`。
-     * - 该模型会作为 session 首次执行前的默认注入值。
-     * - 若同时提供 `configureSession`，则先应用这里的默认模型，再允许宿主继续覆写。
-     */
-    model?: LanguageModel;
-    /**
-     * 当前 agent 显式持有的 runtime plugin 实例集合。
-     *
-     * 关键点（中文）
-     * - 这里接收已经实例化好的 runtime plugin，而不是 plugin class。
-     * - `Agent` 会在构造阶段按名称注册这些实例，并在启动时自动绑定 runtime。
-     * - v1 推荐显式传入 `new ChatPlugin(...)` 这类实例，而不是依赖包内隐式注册表。
-     */
-    runtimePlugins?: BasePlugin[];
-    /**
-     * 是否自动装配全部内建 runtime plugin。
-     *
-     * 关键点（中文）
-     * - 适合 city 这类宿主进程直接 `new Agent(...)` 的场景。
-     * - 未开启时，默认只使用显式传入的 `runtimePlugins`。
-     */
-    useBuiltinRuntimePlugins?: boolean;
-    /**
-     * 当前 agent 显式注册的 plugin 定义集合。
-     *
-     * 关键点（中文）
-     * - 这里接收完整 plugin 定义对象，而不是 plugin 名称。
-     * - `Agent` 会为当前 SDK 实例创建独立 plugin registry，避免污染全局 runtime。
-     * - 同名 plugin 会直接报错，避免 action / hook / resolve 行为被静默覆盖。
-     */
-    plugins?: Plugin[];
-    /**
-     * 是否自动装配全部内建 plugin。
-     *
-     * 关键点（中文）
-     * - 适合 city 这类宿主进程直接 `new Agent(...)` 的场景。
-     * - 未开启时，默认只使用显式传入的 `plugins`。
-     */
-    useBuiltinPlugins?: boolean;
-    /**
-     * 当前 agent 显式注入的平台能力集合。
-     *
-     * 关键点（中文）
-     * - SDK 侧若不提供，则使用最小空实现。
-     * - 推荐由宿主产品显式传入，避免 SDK 本地实例隐式依赖 city。
-     */
-    platform?: AgentPlatformRuntime;
-    /**
-     * 在 session 初始化后执行的宿主配置钩子。
-     *
-     * 关键点（中文）
-     * - SDK 不负责默认模型策略，宿主可在这里统一为 session 注入 model 等运行配置。
-     * - 若同时传入 `model`，则会先写入默认模型，再执行这里的宿主覆写逻辑。
-     * - 该钩子对每个 session 只触发一次，适合做实例级默认装配。
-     * - 触发时机可能来自显式 `agent.session()`，也可能来自该 session 的首次执行入口。
-     */
-    configureSession?: (session: Session) => Promise<void> | void;
-}
-/**
- * Agent 启动参数。
- */
-export interface AgentStartOptions {
-    /**
-     * 是否启动 HTTP 服务。
-     *
-     * 关键点（中文）
-     * - `false` 表示不启动。
-     * - 传对象时会按给定 host/port 启动。
-     * - 省略时默认不启动，避免 SDK 本地嵌入场景误开端口。
-     */
-    http?: false | AgentHttpStartOptions;
-    /**
-     * 是否启动本地 RPC 服务。
-     *
-     * 关键点（中文）
-     * - `true` 时启动主 local RPC server。
-     * - 省略或 `false` 时不启动。
-     */
-    rpc?: boolean;
-    /**
-     * 是否启动当前 agent 的 runtime plugins。
-     *
-     * 关键点（中文）
-     * - 默认 `true`。
-     * - `false` 适合只需要 session 能力、不希望启动后台能力的嵌入场景。
-     */
-    runtimePlugins?: boolean;
-}
-/**
- * Agent 停止结果快照。
- */
-export interface AgentStopResult {
-    /**
-     * 本次是否实际停止了 HTTP 服务。
-     */
-    httpStopped: boolean;
-    /**
-     * 本次是否实际停止了本地 RPC 服务。
-     */
-    rpcStopped: boolean;
-    /**
-     * 本次是否实际停止了 runtime plugins。
-     */
-    runtimePluginsStopped: boolean;
-}
-/**
- * Agent 启动后的状态快照。
- */
-export interface AgentStartResult {
-    /**
-     * 当前 agent 是否已启动 HTTP 服务。
-     */
-    http?: AgentHttpBinding;
-    /**
-     * 当前 agent 是否已启动本地 RPC 服务。
-     */
-    rpc?: AgentRpcBinding;
-    /**
-     * 当前 agent 是否已启动 runtime plugins。
-     */
-    runtimePluginsStarted: boolean;
-}
-/**
- * Agent HTTP 启动参数。
- */
-export interface AgentHttpStartOptions {
-    /**
-     * HTTP 监听主机。
-     */
-    host?: string;
-    /**
-     * HTTP 监听端口。
-     */
-    port?: number;
-}
-/**
- * Agent HTTP 绑定信息。
- */
-export interface AgentHttpBinding {
-    /**
-     * 对外访问地址。
-     */
-    baseUrl: string;
-    /**
-     * 当前 host。
-     */
-    host: string;
-    /**
-     * 当前 port。
-     */
-    port: number;
-    /**
-     * HTTP server 句柄。
-     */
-    server: ServerInstance;
-}
-/**
- * Agent RPC 绑定信息。
- */
-export interface AgentRpcBinding {
-    /**
-     * 当前本地 RPC endpoint。
-     */
-    endpoint: string;
-    /**
-     * 本地 RPC server 句柄。
-     */
-    server: LocalRpcServerHandle;
-}
-/**
- * 远程 Agent 构造参数。
- */
-export interface RemoteAgentOptions {
-    /**
-     * 远程 SDK HTTP 基础地址。
-     *
-     * 例如：`http://127.0.0.1:15314`
-     */
-    baseUrl: string;
-}
-/**
- * Session 可变配置。
- */
-export interface AgentSessionSetInput {
-    /**
-     * 当前 session 默认模型实例。
-     *
-     * 关键点（中文）
-     * - 这里接受运行中的模型实例，而不是模型 ID。
-     * - 由于模型实例通常不可序列化，落盘只保留轻量可读标签用于展示。
-     */
-    model?: LanguageModel;
-}
-/**
- * Session 当前配置快照。
- */
-export interface AgentSessionConfigSnapshot {
-    /**
-     * 当前 session 绑定的默认模型实例。
-     */
-    model?: LanguageModel;
-    /**
-     * 当前模型的轻量可读标签。
-     */
-    modelLabel?: string;
-}
-/**
- * Session system block 来源类型。
- */
-export type AgentSessionSystemBlockSource = "core" | "instruction" | "plugin" | "session";
-/**
- * Session system prompt 的单个组成块。
- */
-export interface AgentSessionSystemBlock {
-    /**
-     * 当前 block 的来源层级。
-     */
-    source: AgentSessionSystemBlockSource;
-    /**
-     * 当前 block 在来源层级内的名称。
-     *
-     * 说明（中文）
-     * - `instruction` 通常使用 `agent`。
-     * - `plugin` 使用对应 plugin 名称。
-     * - `core` 使用 `default`。
-     * - `session` 使用当前 session 上下文名称。
-     */
-    name: string;
-    /**
-     * 已归一化后的 system 文本内容。
-     *
-     * 关键点（中文）
-     * - SDK 不对 instruction 做动态变量替换。
-     * - 动态上下文应由调用方放入 user message。
-     */
-    content: string;
-}
-/**
- * 当前 session 的稳定上下文信息。
- */
-export interface AgentSessionSystemSessionInfo {
-    /**
-     * 当前 session 所属 agentId。
-     */
-    agentId: string;
-    /**
-     * 当前 session 唯一标识。
-     */
-    sessionId: string;
-    /**
-     * 当前 agent 绑定的项目根目录。
-     */
-    projectRoot: string;
-    /**
-     * 当前 session 首次创建时间。
-     *
-     * 关键点（中文）
-     * - 这是 session 初始化时落盘的稳定参考时间，按 Date/ISO 字符串对外展示。
-     * - 它不是每轮运行的当前时间，不会随着后续 turn 执行而改变。
-     */
-    createdAt: string;
-    /**
-     * 当前 session 初始化时解析到的系统时区。
-     *
-     * 关键点（中文）
-     * - 这是 session 级参考时区，随创建信息一起固定。
-     * - 它不是每轮运行重新解析的动态时区。
-     */
-    timezone: string;
-}
-/**
- * 当前 session 生效的完整 system prompt 快照。
- */
-export interface AgentSessionSystemSnapshot {
-    /**
-     * 当前 sessionId。
-     */
-    sessionId: string;
-    /**
-     * 当前 session 的稳定上下文信息。
-     *
-     * 关键点（中文）
-     * - 这里包含 session 创建时间这类稳定参考信息。
-     * - 这里不包含当前时间、轮次、用户输入等每轮变化的数据。
-     * - 每轮动态信息应由调用方放入 user message，避免破坏 instruction 缓存命中。
-     */
-    session: AgentSessionSystemSessionInfo;
-    /**
-     * 当前生效的 system blocks，按进入模型的顺序排列。
-     */
-    blocks: AgentSessionSystemBlock[];
-}
-/**
- * Session 元数据列表项。
- */
-export interface AgentSessionMetadata {
-    /**
-     * 当前 session 所属 agentId。
-     */
-    agentId: string;
-    /**
-     * 当前 session 唯一标识。
-     */
-    sessionId: string;
-    /**
-     * 当前 session 首次创建时间（ms）。
-     */
-    createdAt?: number;
-    /**
-     * 当前 session 最近一次更新时间（ms）。
-     */
-    updatedAt?: number;
-    /**
-     * 当前 session 已落盘消息数。
-     */
-    messageCount: number;
-    /**
-     * 当前 session 绑定模型的可读标签。
-     */
-    modelLabel?: string;
-}
-/**
- * Session fork 输入。
- */
-export interface AgentSessionForkInput {
-    /**
-     * 可选分叉锚点消息 ID。
-     *
-     * 关键点（中文）
-     * - 省略时复制当前 session 的完整消息历史。
-     * - 传入时复制到该消息为止（包含该消息）。
-     */
-    messageId?: string;
-}
-//# sourceMappingURL=AgentSdkTypes.d.ts.map

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

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

package/bin/sdk/AgentSdkTypes.js

@@ -1,10 +0,0 @@
-/**
- * Agent SDK 对外类型定义。
- *
- * 关键点（中文）
- * - 这里集中声明 `Agent` / `RemoteAgent` / `Session` 面向外部调用方的稳定接口。
- * - SDK 用户通过显式 `tools` / `runtimePlugins` / `plugins` 装配能力，不直接依赖内部 runtime 单例。
- * - 本地/远程 session 运行与基础落盘能力仍是 SDK 主路径。
- */
-export {};
-//# sourceMappingURL=AgentSdkTypes.js.map

package/bin/sdk/AgentSdkTypes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentSdkTypes.js","sourceRoot":"","sources":["../../src/sdk/AgentSdkTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/sdk/RemoteAgent.d.ts

@@ -1,77 +0,0 @@
-/**
- * RemoteAgent：远程 SDK 客户端。
- *
- * 关键点（中文）
- * - 面向已通过 `agent.start({ http: { ... } })` 暴露出来的远程/本地 HTTP 服务。
- * - 与本地 `Session` 保持同一套 Session actor 使用面：`prompt()` + `subscribe()`。
- * - `RemoteAgent` 只负责 transport 与本地 turn handle 合成，不重复实现第二套会话编排器。
- */
-import type { AgentSessionMetadata, AgentSessionSetInput, AgentSessionSystemSnapshot, RemoteAgentOptions } from "../sdk/AgentSdkTypes.js";
-import type { SessionMessageV1 } from "../session/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";
-/**
- * 远程 Session 客户端。
- */
-declare class RemoteSession {
-    readonly id: string;
-    private readonly baseUrl;
-    private readonly eventHub;
-    private readonly turnsById;
-    private readonly completedTurnIds;
-    private eventPumpConnectPromise;
-    private eventPumpAbortController;
-    private eventPumpRunning;
-    private eventSubscriberCount;
-    constructor(baseUrl: string, sessionId: string);
-    /**
-     * 远程 session 当前不支持直接注入本地模型实例。
-     */
-    set(_input: AgentSessionSetInput): Promise<void>;
-    /**
-     * 向当前远程 session 追加一条新的 prompt。
-     */
-    prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
-    /**
-     * 订阅当前远程 session 的 future 事件。
-     */
-    subscribe(subscriber: AgentSessionSubscriber): AgentSessionUnsubscribe;
-    /**
-     * 读取远程消息历史。
-     */
-    history(): Promise<SessionMessageV1[]>;
-    /**
-     * 读取远程 session 当前生效的 system prompt 快照。
-     */
-    system(): Promise<AgentSessionSystemSnapshot>;
-    /**
-     * 分叉远程 session。
-     */
-    fork(messageId?: string): Promise<RemoteSession>;
-    private ensureEventPump;
-    private consumeEventConnection;
-    private handleEventLine;
-    private handleEvent;
-    private ensureTurnLifecycle;
-    private failPendingTurns;
-    private rememberCompletedTurn;
-    private maybeStopEventPump;
-}
-/**
- * RemoteAgent：远程 Agent 客户端。
- */
-export declare class RemoteAgent {
-    private readonly baseUrl;
-    constructor(options: RemoteAgentOptions);
-    /**
-     * 获取或创建一个远程 session。
-     */
-    session(sessionId?: string): Promise<RemoteSession>;
-    /**
-     * 列出远程 agent 的全部 session 元数据。
-     */
-    sessions(): Promise<AgentSessionMetadata[]>;
-}
-export {};
-//# sourceMappingURL=RemoteAgent.d.ts.map