@downcity/agent 1.1.237 → 1.1.258

package/bin/session/storage/Persistence.d.ts

@@ -1,73 +0,0 @@
-/**
- * SDK Session 持久化辅助。
- *
- * 关键点（中文）
- * - 集中处理 session meta 更新时间、模型展示标签与 assistant 消息落盘。
- * - `Session` 只负责调用这些能力，不直接拼装 meta 结构。
- */
-import type { SessionRecordV1, SessionMessageRecordV1 } from "../../executor/types/SessionRecords.js";
-import type { AgentSessionConfigSnapshot } from "../../types/agent/SessionTypes.js";
-/**
- * SDK Session 元数据写入参数。
- */
-export interface TouchSessionMetadataParams {
-    /**
-     * 当前项目根目录。
-     */
-    projectRoot: string;
-    /**
-     * 当前 agent 稳定标识。
-     */
-    agentId: string;
-    /**
-     * 当前 sessionId。
-     */
-    sessionId: string;
-    /**
-     * 当前 session 内存配置快照。
-     */
-    sessionConfig: AgentSessionConfigSnapshot;
-    /** 当前 canonical Message 总数。 */
-    message_count?: number;
-    /** 当前 Message 日志文件字节数。 */
-    history_bytes?: number;
-    /** 最近一条用户可见 Message 的文本摘要。 */
-    preview_text?: string;
-}
-/**
- * Assistant 结果落盘参数。
- */
-export interface PersistSdkAssistantResultParams extends TouchSessionMetadataParams {
-    /**
-     * 追加 assistant 消息的底层执行编排器。
-     */
-    executor: {
-        append_assistant_message(params: {
-            /**
-             * 已构造好的完整消息。
-             */
-            message?: SessionRecordV1 | null;
-            /**
-             * 兜底文本内容。
-             */
-            fallbackText?: string;
-        }): Promise<void>;
-    };
-    /**
-     * 本轮执行得到的 assistant 消息。
-     *
-     * 关键点（中文）
-     * - stop/abort 且没有 assistant 内容时允许为空。
-     * - 为空时仅刷新 metadata，不写入伪造 assistant 正文。
-     */
-    assistantMessage?: SessionMessageRecordV1 | null;
-}
-/**
- * 刷新 SDK session 元数据。
- */
-export declare function touchSessionMetadata(params: TouchSessionMetadataParams): Promise<void>;
-/**
- * 持久化 assistant 结果并同步刷新 session meta。
- */
-export declare function persistSdkAssistantResult(params: PersistSdkAssistantResultParams): Promise<void>;
-//# sourceMappingURL=Persistence.d.ts.map

package/bin/session/storage/Persistence.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Persistence.d.ts","sourceRoot":"","sources":["../../../src/session/storage/Persistence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAMhF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,aAAa,EAAE,0BAA0B,CAAC;IAC1C,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,+BACf,SAAQ,0BAA0B;IAClC;;OAEG;IACH,QAAQ,EAAE;QACR,wBAAwB,CAAC,MAAM,EAAE;YAC/B;;eAEG;YACH,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;YACjC;;eAEG;YACH,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnB,CAAC;IACF;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAClD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,+BAA+B,GACtC,OAAO,CAAC,IAAI,CAAC,CASf"}

package/bin/session/storage/Persistence.js

@@ -1,63 +0,0 @@
-/**
- * SDK Session 持久化辅助。
- *
- * 关键点（中文）
- * - 集中处理 session meta 更新时间、模型展示标签与 assistant 消息落盘。
- * - `Session` 只负责调用这些能力，不直接拼装 meta 结构。
- */
-import { extractTextFromUiMessage } from "../../executor/messages/UIMessageTransformer.js";
-import { persistAssistantResult } from "../../executor/messages/AssistantResultPersistence.js";
-import { readSessionMetadata, writeSessionMetadata, } from "../../session/storage/Metadata.js";
-/**
- * 刷新 SDK session 元数据。
- */
-export async function touchSessionMetadata(params) {
-    const current = await readSessionMetadata({
-        projectRoot: params.projectRoot,
-        agentId: params.agentId,
-        sessionId: params.sessionId,
-    });
-    const next = {
-        ...current,
-        agentId: params.agentId,
-        createdAt: typeof current.createdAt === "number" ? current.createdAt : Date.now(),
-        updatedAt: Date.now(),
-        ...(params.sessionConfig.modelLabel
-            ? {
-                modelLabel: params.sessionConfig.modelLabel,
-            }
-            : {}),
-        ...(params.sessionConfig.modelId
-            ? {
-                modelId: params.sessionConfig.modelId,
-            }
-            : {}),
-        ...(typeof params.message_count === "number"
-            ? { messageCount: params.message_count }
-            : {}),
-        ...(typeof params.history_bytes === "number"
-            ? { historyBytes: params.history_bytes }
-            : {}),
-        ...(params.preview_text ? { previewText: params.preview_text } : {}),
-    };
-    await writeSessionMetadata({
-        projectRoot: params.projectRoot,
-        agentId: params.agentId,
-        sessionId: params.sessionId,
-        meta: next,
-    });
-}
-/**
- * 持久化 assistant 结果并同步刷新 session meta。
- */
-export async function persistSdkAssistantResult(params) {
-    await persistAssistantResult({
-        writer: params.executor,
-        assistantMessage: params.assistantMessage,
-        fallbackText: params.assistantMessage
-            ? extractTextFromUiMessage(params.assistantMessage)
-            : undefined,
-    });
-    await touchSessionMetadata(params);
-}
-//# sourceMappingURL=Persistence.js.map

package/bin/session/storage/Persistence.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Persistence.js","sourceRoot":"","sources":["../../../src/session/storage/Persistence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AAMvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAE3F,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AA4DvC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAkC;IAElC,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC;QACxC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC;IACH,MAAM,IAAI,GAAyB;QACjC,GAAG,OAAO;QACV,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EACP,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;QACxE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU;YACjC,CAAC,CAAC;gBACE,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,UAAU;aAC5C;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO;YAC9B,CAAC,CAAC;gBACE,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO;aACtC;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ;YAC1C,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,aAAa,EAAE;YACxC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ;YAC1C,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,aAAa,EAAE;YACxC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC;IACF,MAAM,oBAAoB,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAuC;IAEvC,MAAM,sBAAsB,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC,QAAQ;QACvB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,YAAY,EAAE,MAAM,CAAC,gBAAgB;YACnC,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,gBAAgB,CAAC;YACnD,CAAC,CAAC,SAAS;KACd,CAAC,CAAC;IACH,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC"}

package/bin/types/agent/AgentRuntimeAssembly.d.ts

@@ -1,72 +0,0 @@
-/**
- * AgentRuntimeAssembly 类型定义。
- *
- * 关键点（中文）
- * - 这里统一描述由本地 agent 装配、再挂入 AgentRuntime 的能力。
- * - plugin runtime / session / plugin 作者 API 只能消费这些稳定能力，不应直接依赖具体宿主实现。
- * - 当前先收敛路径与 plugin 配置持久化两类高频能力。
- */
-import type { DowncityConfig } from "../../types/config/DowncityConfig.js";
-/**
- * Agent 路径能力集合。
- */
-export interface AgentPathRuntime {
-    /**
-     * 当前项目根目录。
-     */
-    projectRoot: string;
-    /**
-     * 当前 agent 的稳定标识。
-     */
-    agentId: string;
-    /**
-     * `.downcity` 根目录路径。
-     */
-    getDowncityDirPath(): string;
-    /**
-     * `.downcity/.cache` 目录路径。
-     */
-    getCacheDirPath(): string;
-    /**
-     * `.downcity/channel` 目录路径。
-     */
-    getDowncityChannelDirPath(): string;
-    /**
-     * `.downcity/channel/meta.json` 文件路径。
-     */
-    getDowncityChannelMetaPath(): string;
-    /**
-     * `.downcity/chat/<sessionId>/history.jsonl` 文件路径。
-     */
-    getDowncityChatHistoryPath(sessionId: string): string;
-    /**
-     * `.downcity/memory/MEMORY.md` 文件路径。
-     */
-    getDowncityMemoryLongTermPath(): string;
-    /**
-     * `.downcity/memory/daily` 目录路径。
-     */
-    getDowncityMemoryDailyDirPath(): string;
-    /**
-     * `.downcity/memory/daily/<date>.md` 文件路径。
-     */
-    getDowncityMemoryDailyPath(date: string): string;
-    /**
-     * `.downcity/agents/<agentId>/sessions` 根目录路径。
-     */
-    getDowncitySessionRootDirPath(): string;
-    /**
-     * `.downcity/agents/<agentId>/sessions/<sessionId>` 目录路径。
-     */
-    getDowncitySessionDirPath(sessionId: string): string;
-}
-/**
- * Plugin 配置持久化能力集合。
- */
-export interface AgentPluginConfigRuntime {
-    /**
-     * 将当前 `plugins` 配置块写回宿主配置存储。
-     */
-    persistProjectPlugins(plugins: DowncityConfig["plugins"] | undefined): Promise<string>;
-}
-//# sourceMappingURL=AgentRuntimeAssembly.d.ts.map

package/bin/types/agent/AgentRuntimeAssembly.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentRuntimeAssembly.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentRuntimeAssembly.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC;IAC7B;;OAEG;IACH,eAAe,IAAI,MAAM,CAAC;IAC1B;;OAEG;IACH,yBAAyB,IAAI,MAAM,CAAC;IACpC;;OAEG;IACH,0BAA0B,IAAI,MAAM,CAAC;IACrC;;OAEG;IACH,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACtD;;OAEG;IACH,6BAA6B,IAAI,MAAM,CAAC;IACxC;;OAEG;IACH,6BAA6B,IAAI,MAAM,CAAC;IACxC;;OAEG;IACH,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACjD;;OAEG;IACH,6BAA6B,IAAI,MAAM,CAAC;IACxC;;OAEG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxF"}

package/bin/types/agent/AgentRuntimeAssembly.js

@@ -1,10 +0,0 @@
-/**
- * AgentRuntimeAssembly 类型定义。
- *
- * 关键点（中文）
- * - 这里统一描述由本地 agent 装配、再挂入 AgentRuntime 的能力。
- * - plugin runtime / session / plugin 作者 API 只能消费这些稳定能力，不应直接依赖具体宿主实现。
- * - 当前先收敛路径与 plugin 配置持久化两类高频能力。
- */
-export {};
-//# sourceMappingURL=AgentRuntimeAssembly.js.map

package/bin/types/agent/AgentRuntimeAssembly.js.map

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

package/bin/types/runtime/agent/AgentContext.d.ts

@@ -1,306 +0,0 @@
-/**
- * Agent 执行上下文类型定义。
- *
- * 职责说明（中文）
- * - 这里定义 plugin runtime、plugin、prompt system 共用的统一执行上下文。
- * - `AgentContext` 是一个 class，表达"当前一次执行可见的能力面"，不是宿主状态本体。
- * - 同一 agent 实例全程共享同一个 context；plugin、session、executor 都基于它读写状态。
- */
-import type { LanguageModel } from "ai";
-import type { Logger } from "../../../utils/logger/Logger.js";
-import type { AgentPathRuntime, AgentPluginConfigRuntime } from "../../../types/agent/AgentRuntimeAssembly.js";
-import type { DowncityConfig } from "../../../types/config/DowncityConfig.js";
-import type { JsonValue } from "../../../types/common/Json.js";
-import type { AgentPlugins } from "../../../types/plugin/PluginRuntime.js";
-import type { Plugin } from "../../../types/plugin/PluginDefinition.js";
-import type { SessionMetadataV1, SessionRecordV1 } from "../../../executor/types/SessionRecords.js";
-import type { SessionRunInput, SessionRunResult } from "../../../executor/types/SessionRun.js";
-import type { SessionHistoryStore } from "../../../executor/store/history/SessionHistoryStore.js";
-import type { AgentSessionPromptInput } from "../../../types/sdk/AgentSessionPrompt.js";
-import type { AgentSessionStopResult } from "../../../types/sdk/AgentSessionStop.js";
-import type { SessionMutationSubscriber, SessionMutationUnsubscribe } from "../../../types/session/SessionMutation.js";
-import type { SessionApprovalRuntimeEvent } from "../../../types/session/SessionApproval.js";
-import type { AgentSessionTurnHandle } from "../../../types/sdk/AgentSessionTurn.js";
-/**
- * 跨 plugin runtime 调用参数。
- */
-export interface InvokePluginParams {
-    /**
-     * 目标 plugin 名称。
-     */
-    plugin: string;
-    /**
-     * 目标 action 名称。
-     */
-    action: string;
-    /**
-     * 调用时附带的结构化 payload。
-     */
-    payload?: JsonValue;
-}
-/**
- * 跨 plugin runtime 调用结果。
- */
-export interface InvokePluginResult {
-    /**
-     * 调用是否成功。
-     */
-    success: boolean;
-    /**
-     * 成功时返回的数据载荷。
-     */
-    data?: JsonValue;
-    /**
-     * 失败时的错误信息。
-     */
-    error?: string;
-}
-/**
- * 跨 plugin runtime 调用端口。
- */
-export interface InvokePluginPort {
-    /**
-     * 调用指定 plugin action。
-     */
-    invoke(params: InvokePluginParams): Promise<InvokePluginResult>;
-}
-/**
- * 单个 Session 执行端口。
- */
-export interface SessionExecutorPort {
-    /**
-     * 执行一次 session run。
-     */
-    run(params: SessionRunInput): Promise<SessionRunResult>;
-    /**
-     * 请求取消当前正在执行的 turn。
-     *
-     * 关键点（中文）
-     * - 返回 `true` 表示已发出取消请求。
-     * - 返回 `false` 表示当前没有可取消的执行。
-     */
-    stop(): boolean;
-}
-/**
- * 单个 Session 实例端口。
- */
-export interface SessionPort {
-    /**
-     * 当前 session 标识。
-     */
-    readonly sessionId: string;
-    /**
-     * 获取当前 session 的执行端口。
-     */
-    getExecutor(): SessionExecutorPort;
-    /**
-     * 获取当前 session 的持久化端口。
-     */
-    getHistoryStore(): SessionHistoryStore;
-    /**
-     * 向当前 session actor 追加一条新的 prompt。
-     *
-     * 关键点（中文）
-     * - 这是面向 SDK / transport 的统一交互输入入口。
-     * - 返回值只有在当前输入被绑定到某个 turn 后才会兑现。
-     */
-    prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
-    /**
-     * 停止当前 turn，并取消尚未被吸收的排队 prompt。
-     */
-    stop(): Promise<AgentSessionStopResult>;
-    /**
-     * 订阅当前 session 后续产生的 future 事件。
-     *
-     * 关键点（中文）
-     * - 只广播订阅之后产生的事件。
-     * - 当前 Message snapshot 通过公开 SDK `session.messages()` 读取。
-     */
-    subscribe(subscriber: SessionMutationSubscriber): SessionMutationUnsubscribe;
-    /**
-     * 发布一条 session runtime 事件。
-     *
-     * 关键点（中文）
-     * - plugin runtime 用它把审批、外部进度等非模型 chunk 事件推送给订阅方。
-     * - 历史消息持久化仍由 append_user_message / append_assistant_message 负责。
-     */
-    publishEvent(event: SessionApprovalRuntimeEvent): Promise<void>;
-    /**
-     * 追加一条 user 消息。
-     */
-    append_user_message(params: {
-        /**
-         * 已构造好的完整消息。
-         */
-        message?: SessionRecordV1 | null;
-        /**
-         * 兜底文本内容。
-         */
-        text?: string;
-        /**
-         * 附加元数据。
-         */
-        extra?: SessionMetadataV1["extra"];
-    }): Promise<void>;
-    /**
-     * 追加一条 assistant 消息。
-     */
-    append_assistant_message(params: {
-        /**
-         * 已构造好的完整消息。
-         */
-        message?: SessionRecordV1 | null;
-        /**
-         * 兜底文本内容。
-         */
-        fallbackText?: string;
-        /**
-         * 附加元数据。
-         */
-        extra?: SessionMetadataV1["extra"];
-    }): Promise<void>;
-    /**
-     * 返回当前 session 是否正在执行。
-     */
-    isExecuting(): boolean;
-}
-/**
- * Session 集合入口。
- */
-export interface SessionCollectionPort {
-    /**
-     * 获取指定 sessionId 对应的 Session 实例。
-     */
-    get(sessionId: string): SessionPort;
-    /**
-     * 返回当前所有执行中的 sessionId。
-     */
-    listExecutingSessionIds(): string[];
-    /**
-     * 返回当前执行中的 session 数量。
-     */
-    getExecutingSessionCount(): number;
-    /**
-     * 解析指定 session 当前绑定的模型实例。
-     *
-     * 关键点（中文）
-     * - 模型归属于 session，而不是 agent 全局运行时。
-     * - 这里会触发 session 初始化/宿主配置，适合 task 等后台链路按 session 读取模型。
-     */
-    resolveModel(sessionId: string): Promise<LanguageModel | undefined>;
-}
-/**
- * AgentContext 构造参数。
- *
- * 关键点（中文）
- * - 装配方负责把 session / plugins 等上层依赖注入进来。
- * - `env` 必须传入 agent 持有的 mutable 共享对象引用，不要在这里克隆。
- */
-export interface AgentContextOptions {
-    /** 当前命令工作目录。 */
-    cwd: string;
-    /** 当前项目根目录。 */
-    rootPath: string;
-    /** 统一日志器。 */
-    logger: Logger;
-    /** 当前运行时已解析配置。 */
-    config: DowncityConfig;
-    /**
-     * 当前 agent env 共享对象引用。
-     *
-     * 关键点（中文）
-     * - 必须是 Agent 持有的同一个 mutable 引用，不要克隆后再传入。
-     * - Session step 内优先读取队列已经提交的 effective env。
-     */
-    env: Record<string, string>;
-    /** 当前生效的 system 文本集合。 */
-    systems: string[];
-    /** 当前可见的路径能力集合。 */
-    paths: AgentPathRuntime;
-    /** 当前可见的 plugin 配置持久化能力集合。 */
-    pluginConfig: AgentPluginConfigRuntime;
-    /** 当前 agent 持有的插件实例集合。 */
-    pluginInstances: Map<string, Plugin>;
-    /** Session 能力入口。 */
-    session: SessionCollectionPort;
-    /** Plugin 调用入口。 */
-    plugins: AgentPlugins;
-}
-/**
- * 统一执行上下文。
- *
- * 关键点（中文）
- * - 字段全部 readonly，构造一次后语义稳定，避免 plugin 误改。
- * - `env` 引用 agent 级共享 mutable 对象，`...ctx.env` / `ctx.env.FOO` 直接可用。
- * - `invoke` 是构造期组装的 plugin 调用端口，对外仍以 `InvokePluginPort` 形态暴露。
- */
-export declare class AgentContext {
-    /** 当前命令工作目录。 */
-    readonly cwd: string;
-    /** 当前项目根目录。 */
-    readonly rootPath: string;
-    /** 统一日志器。 */
-    readonly logger: Logger;
-    /** 当前运行时已解析配置。 */
-    readonly config: DowncityConfig;
-    /** 当前 Agent configured env 共享对象。 */
-    private readonly configured_env;
-    /** 当前 Agent configured system 文本。 */
-    private readonly configured_systems;
-    /** 当前可见的路径能力集合。 */
-    readonly paths: AgentPathRuntime;
-    /** 当前可见的 plugin 配置持久化能力集合。 */
-    readonly pluginConfig: AgentPluginConfigRuntime;
-    /** 当前 agent 持有的插件实例集合。 */
-    readonly pluginInstances: Map<string, Plugin>;
-    /** Session 能力入口。 */
-    readonly session: SessionCollectionPort;
-    /** Plugin 调用入口。 */
-    readonly plugins: AgentPlugins;
-    /** 跨 plugin runtime 调用主入口。 */
-    readonly invoke: InvokePluginPort;
-    constructor(options: AgentContextOptions);
-    /**
-     * 读取当前调用链可见的 Agent env。
-     *
-     * 关键点（中文）
-     * - Session step 内优先返回统一输入队列已经提交的 effective env。
-     * - Session 运行外返回 Agent 配置 API 最近一次成功写入的 configured env。
-     */
-    get env(): Record<string, string>;
-    /**
-     * 读取当前调用链可见的 Agent instruction。
-     */
-    get systems(): string[];
-    /**
-     * 读取指定 sessionId 对应的 session 端口。
-     *
-     * 关键点（中文）
-     * - 返回值是统一的 `SessionPort`，而不是裸 `Executor`。
-     * - 这样 HTTP / plugin runtime / chat queue / contact 等入口都能复用同一层会话装配与执行兜底。
-     */
-    getSession(sessionId: string): SessionPort;
-    /**
-     * 返回当前执行中的 sessionId 列表。
-     */
-    listExecutingSessionIds(): string[];
-    /**
-     * 返回当前执行中的 session 数量。
-     */
-    getExecutingSessionCount(): number;
-    /**
-     * 跨 plugin runtime 调用 action 的内部实现。
-     *
-     * 关键点（中文）
-     * - 统一把 `runAction` 的成功/失败结果归一化为 `InvokePluginResult`。
-     * - 这里替代了原 `createAgentContext` 工厂里的胶水匿名函数。
-     */
-    private invoke_plugin_action;
-}
-/**
- * 允许 optional 字段的结构化配置对象。
- */
-export type StructuredConfig = {
-    [key: string]: JsonValue | undefined;
-};
-//# sourceMappingURL=AgentContext.d.ts.map

package/bin/types/runtime/agent/AgentContext.d.ts.map

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

package/bin/types/runtime/agent/AgentContext.js

@@ -1,128 +0,0 @@
-/**
- * Agent 执行上下文类型定义。
- *
- * 职责说明（中文）
- * - 这里定义 plugin runtime、plugin、prompt system 共用的统一执行上下文。
- * - `AgentContext` 是一个 class，表达"当前一次执行可见的能力面"，不是宿主状态本体。
- * - 同一 agent 实例全程共享同一个 context；plugin、session、executor 都基于它读写状态。
- */
-import { getSessionRunContext } from "../../../executor/SessionRunScope.js";
-/**
- * 统一执行上下文。
- *
- * 关键点（中文）
- * - 字段全部 readonly，构造一次后语义稳定，避免 plugin 误改。
- * - `env` 引用 agent 级共享 mutable 对象，`...ctx.env` / `ctx.env.FOO` 直接可用。
- * - `invoke` 是构造期组装的 plugin 调用端口，对外仍以 `InvokePluginPort` 形态暴露。
- */
-export class AgentContext {
-    /** 当前命令工作目录。 */
-    cwd;
-    /** 当前项目根目录。 */
-    rootPath;
-    /** 统一日志器。 */
-    logger;
-    /** 当前运行时已解析配置。 */
-    config;
-    /** 当前 Agent configured env 共享对象。 */
-    configured_env;
-    /** 当前 Agent configured system 文本。 */
-    configured_systems;
-    /** 当前可见的路径能力集合。 */
-    paths;
-    /** 当前可见的 plugin 配置持久化能力集合。 */
-    pluginConfig;
-    /** 当前 agent 持有的插件实例集合。 */
-    pluginInstances;
-    /** Session 能力入口。 */
-    session;
-    /** Plugin 调用入口。 */
-    plugins;
-    /** 跨 plugin runtime 调用主入口。 */
-    invoke;
-    constructor(options) {
-        this.cwd = options.cwd;
-        this.rootPath = options.rootPath;
-        this.logger = options.logger;
-        this.config = options.config;
-        this.configured_env = options.env;
-        this.configured_systems = options.systems;
-        this.paths = options.paths;
-        this.pluginConfig = options.pluginConfig;
-        this.pluginInstances = options.pluginInstances;
-        this.session = options.session;
-        this.plugins = options.plugins;
-        this.invoke = {
-            invoke: (params) => this.invoke_plugin_action(params),
-        };
-    }
-    /**
-     * 读取当前调用链可见的 Agent env。
-     *
-     * 关键点（中文）
-     * - Session step 内优先返回统一输入队列已经提交的 effective env。
-     * - Session 运行外返回 Agent 配置 API 最近一次成功写入的 configured env。
-     */
-    get env() {
-        const effective_env = getSessionRunContext()?.agentEnv;
-        return effective_env
-            ? { ...effective_env }
-            : this.configured_env;
-    }
-    /**
-     * 读取当前调用链可见的 Agent instruction。
-     */
-    get systems() {
-        const effective_systems = getSessionRunContext()?.agentSystems;
-        return effective_systems
-            ? [...effective_systems]
-            : this.configured_systems;
-    }
-    /**
-     * 读取指定 sessionId 对应的 session 端口。
-     *
-     * 关键点（中文）
-     * - 返回值是统一的 `SessionPort`，而不是裸 `Executor`。
-     * - 这样 HTTP / plugin runtime / chat queue / contact 等入口都能复用同一层会话装配与执行兜底。
-     */
-    getSession(sessionId) {
-        return this.session.get(sessionId);
-    }
-    /**
-     * 返回当前执行中的 sessionId 列表。
-     */
-    listExecutingSessionIds() {
-        return this.session.listExecutingSessionIds();
-    }
-    /**
-     * 返回当前执行中的 session 数量。
-     */
-    getExecutingSessionCount() {
-        return this.session.getExecutingSessionCount();
-    }
-    /**
-     * 跨 plugin runtime 调用 action 的内部实现。
-     *
-     * 关键点（中文）
-     * - 统一把 `runAction` 的成功/失败结果归一化为 `InvokePluginResult`。
-     * - 这里替代了原 `createAgentContext` 工厂里的胶水匿名函数。
-     */
-    async invoke_plugin_action(params) {
-        const result = await this.plugins.runAction({
-            plugin: params.plugin,
-            action: params.action,
-            ...(params.payload !== undefined ? { payload: params.payload } : {}),
-        });
-        if (!result.success) {
-            return {
-                success: false,
-                error: result.error || result.message || "plugin action failed",
-            };
-        }
-        return {
-            success: true,
-            ...(result.data !== undefined ? { data: result.data } : {}),
-        };
-    }
-}
-//# sourceMappingURL=AgentContext.js.map