/**
 * PluginContext：Agent 向 Plugin 投影的稳定能力视图。
 *
 * 边界说明（中文）
 * - Plugin 只依赖本接口，不持有 Agent、City 实例，也不参与 Session 内核编排。
 * - 动态状态通过只读 getter 暴露，保证 Workspace env 与 instruction 始终来自唯一状态源。
 */
import type { AgentSessionCollection } from "../agent/AgentSessionCollection.js";
import type { AgentPlugins } from "./PluginRuntime.js";
import type { FileSystem, WorkspaceShell } from "@downcity/workspace";
import type { Logger } from "../../utils/logger/Logger.js";
import type { PluginWebServices } from "./PluginServices.js";
import type { Embassy } from "@downcity/federation";
/** Agent 向 Plugin 开放的最小、稳定运行时能力。 */
export interface PluginContext {
    /** 当前 Agent 的稳定标识。 */
    readonly agent_id: string;
    /** 当前 Workspace 的稳定标识。 */
    readonly workspace_id: string;
    /** 当前 Workspace 的绝对根目录。 */
    readonly workspace_path: string;
    /** 当前 Plugin 在 Agent 内的运行时私有数据根路径。 */
    readonly data_path: string;
    /** 当前 Workspace 的统一文件能力。 */
    readonly files: FileSystem;
    /** 当前 Plugin 运行时私有数据目录的统一文件能力。 */
    readonly data_files: FileSystem;
    /** 当前 Workspace 显式挂载的 Shell；未启用时为空。 */
    readonly shell?: WorkspaceShell;
    /** 当前 Agent 在当前 Workspace 执行上下文中使用的统一日志器。 */
    readonly logger: Logger;
    /** 当前 Agent 持有的 Web 搜索与文档能力。 */
    readonly web?: PluginWebServices;
    /** City 注入的 Embassy 能力；Agent 未加入 City 时为空。 */
    readonly embassy?: Embassy;
    /** 当前 Agent 的 Session 集合入口。 */
    readonly sessions: AgentSessionCollection;
    /** 当前 Agent 唯一的 Plugin 调用与注册入口。 */
    readonly plugins: AgentPlugins;
    /** 当前 Workspace 已配置环境变量的只读快照。 */
    readonly workspace_env: Readonly<Record<string, string>>;
    /** 当前 Agent 已配置静态指令的只读快照。 */
    readonly instructions: readonly string[];
}
//# sourceMappingURL=PluginContext.d.ts.map