@downcity/agent 1.1.408 → 1.1.437

package/bin/executor/composer/system/default/variables/VariableReplacer.d.ts

@@ -1,61 +0,0 @@
-/**
- * VariableReplacer：prompt 变量替换模块。
- *
- * 关键点（中文）
- * - 专职负责模板变量构建与文本替换。
- * - 与 message 组装解耦，便于独立复用与测试。
- */
-/**
- * Prompt 变量替换模式。
- *
- * 关键点（中文）
- * - `full`：完整替换（包含时间/地点等上下文动态变量）。
- * - `stable`：仅保留稳定替换；但 `current_year` 属于低频年度变量，仍保留真实值。
- */
-export type PromptVariableMode = "full" | "stable";
-/**
- * 替换 prompt 模板变量。
- *
- * 当前支持（中文）
- * - `{{current_time}}`
- * - `{{current_date}}`
- * - `{{current_year}}`
- * - `{{timezone}}`
- * - `{{location}}`
- * - `{{project_path}}`
- * - `{{project_root}}`
- * - `{{session_id}}`
- */
-export declare function replace_variables_in_prompts(prompt: string, options?: {
-    /**
-     * 项目路径（用于 `project_path/project_root`）。
-     */
-    projectPath?: string;
-    /**
-     * 会话 ID（用于 `session_id`）。
-     */
-    session_id?: string;
-    /**
-     * 变量替换模式（默认 full）。
-     */
-    mode?: PromptVariableMode;
-}): Promise<string>;
-/**
- * 构建每轮运行末尾的 runtime clock system prompt。
- *
- * 关键点（中文）
- * - system/static prompt 使用 stable 模式，不能直接承载每轮变化的时间。
- * - 这里在 messages 尾部补齐 `current_date/current_time/timezone`，让 chat、task、prompt 的时间语义统一。
- * - 只使用本机 runtime 时区，避免每轮为了地理位置进行网络请求。
- */
-export declare function build_runtime_clock_system_prompt(options?: {
-    /**
-     * 项目路径（用于 `project_root`）。
-     */
-    projectPath?: string;
-    /**
-     * 会话 ID（用于 `session_id`）。
-     */
-    session_id?: string;
-}): string;
-//# sourceMappingURL=VariableReplacer.d.ts.map

package/bin/executor/composer/system/default/variables/VariableReplacer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"VariableReplacer.d.ts","sourceRoot":"","sources":["../../../../../../src/executor/composer/system/default/variables/VariableReplacer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAkDnD;;;;;;;;;;;;GAYG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IACR;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B,GACA,OAAO,CAAC,MAAM,CAAC,CAajB;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,CAAC,EAAE;IAC1D;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAcT"}

package/bin/executor/composer/system/default/variables/VariableReplacer.js

@@ -1,93 +0,0 @@
-/**
- * VariableReplacer：prompt 变量替换模块。
- *
- * 关键点（中文）
- * - 专职负责模板变量构建与文本替换。
- * - 与 message 组装解耦，便于独立复用与测试。
- */
-import { resolve_prompt_geo_context } from "./GeoContext.js";
-import { render_template_variables } from "../../../../../utils/Template.js";
-import { format_date_in_timezone, format_date_time_in_timezone, format_year_in_timezone, resolve_runtime_timezone, } from "../../../../../utils/Time.js";
-async function buildPromptVariables(options) {
-    const mode = options?.mode === "stable" ? "stable" : "full";
-    const projectPath = String(options?.projectPath || "").trim() || process.cwd();
-    const safeLocalTimezone = resolve_runtime_timezone();
-    const now = new Date();
-    if (mode === "stable") {
-        return {
-            currentDate: "[See runtime clock tail message]",
-            currentTime: "[See runtime clock tail message]",
-            currentYear: format_year_in_timezone(now, safeLocalTimezone),
-            timezone: safeLocalTimezone,
-            location: "[See runtime clock tail message]",
-            projectPath,
-            project_root: projectPath,
-            session_id: "[Runtime session id]",
-        };
-    }
-    const geo = await resolve_prompt_geo_context();
-    const session_id = String(options?.session_id || "").trim() || "unknown";
-    return {
-        // 关键点（中文）：时间字段只使用本机 runtime 时区，避免代理/IP 地理推断改变 cron 与相对时间口径。
-        currentDate: format_date_in_timezone(now, safeLocalTimezone),
-        currentTime: format_date_time_in_timezone(now, safeLocalTimezone),
-        currentYear: format_year_in_timezone(now, safeLocalTimezone),
-        timezone: safeLocalTimezone,
-        location: geo.location,
-        projectPath,
-        project_root: projectPath,
-        session_id,
-    };
-}
-/**
- * 替换 prompt 模板变量。
- *
- * 当前支持（中文）
- * - `{{current_time}}`
- * - `{{current_date}}`
- * - `{{current_year}}`
- * - `{{timezone}}`
- * - `{{location}}`
- * - `{{project_path}}`
- * - `{{project_root}}`
- * - `{{session_id}}`
- */
-export async function replace_variables_in_prompts(prompt, options) {
-    if (!prompt)
-        return prompt;
-    const variables = await buildPromptVariables(options);
-    return render_template_variables(prompt, {
-        current_date: variables.currentDate,
-        current_time: variables.currentTime,
-        current_year: variables.currentYear,
-        timezone: variables.timezone,
-        location: variables.location,
-        project_path: variables.projectPath,
-        project_root: variables.project_root,
-        session_id: variables.session_id,
-    });
-}
-/**
- * 构建每轮运行末尾的 runtime clock system prompt。
- *
- * 关键点（中文）
- * - system/static prompt 使用 stable 模式，不能直接承载每轮变化的时间。
- * - 这里在 messages 尾部补齐 `current_date/current_time/timezone`，让 chat、task、prompt 的时间语义统一。
- * - 只使用本机 runtime 时区，避免每轮为了地理位置进行网络请求。
- */
-export function build_runtime_clock_system_prompt(options) {
-    const timezone = resolve_runtime_timezone();
-    const projectPath = String(options?.projectPath || "").trim() || process.cwd();
-    const session_id = String(options?.session_id || "").trim() || "unknown";
-    const now = new Date();
-    return [
-        "# Runtime Clock Context",
-        "The following fields are the authoritative time context for this run. Prefer them when resolving relative time expressions such as today, tomorrow, or a specific hour:",
-        `- current_date: ${format_date_in_timezone(now, timezone)}`,
-        `- current_time: ${format_date_time_in_timezone(now, timezone)}`,
-        `- timezone: ${timezone}`,
-        `- session_id: ${session_id}`,
-        `- project_root: ${projectPath}`,
-    ].join("\n");
-}
-//# sourceMappingURL=VariableReplacer.js.map

package/bin/executor/composer/system/default/variables/VariableReplacer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"VariableReplacer.js","sourceRoot":"","sources":["../../../../../../src/executor/composer/system/default/variables/VariableReplacer.ts"],"names":[],"mappings":"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"}

package/bin/executor/core-engine/CoreEngineMessageState.d.ts

@@ -1,63 +0,0 @@
-/**
- * CoreEngine 模型消息运行态。
- *
- * 关键点（中文）
- * - CoreEngine 只维护本 Turn 后续模型 Step 需要的标准 ModelMessage。
- * - canonical SessionMessage 的持久化由 SessionMessages 独立拥有。
- */
-import type { ModelMessage } from "@downcity/type";
-import type { SessionUserMessage } from "../../types/session/SessionMessage.js";
-/**
- * CoreEngine 单轮执行期间的消息基线。
- */
-export declare class CoreEngineMessageState {
-    /**
-     * 当前模型侧消息基线。
-     */
-    private current_model_messages;
-    /**
-     * 当前项目根目录，用于解析历史中的相对路径 file part。
-     */
-    private readonly project_root?;
-    private constructor();
-    /**
-     * 基于初始模型消息创建运行态。
-     */
-    static create(params: {
-        /**
-         * 初始标准模型消息。
-         */
-        messages: ModelMessage[];
-        /**
-         * 当前项目根目录。
-         */
-        project_root?: string;
-    }): Promise<CoreEngineMessageState>;
-    /**
-     * 读取当前模型消息。
-     */
-    get model_messages(): ModelMessage[];
-    /**
-     * 把 Step 间新增的 canonical User Message 并入模型基线。
-     */
-    append_merged_user_messages(messages: SessionUserMessage[]): Promise<ModelMessage[]>;
-    /**
-     * 追加内部生成的 user nudge 消息。
-     */
-    append_user_message(message: SessionUserMessage): Promise<void>;
-    /**
-     * 追加 SDK 返回的模型 response messages。
-     */
-    append_model_messages(messages: ModelMessage[]): void;
-    /**
-     * 原子替换当前模型侧消息基线。
-     *
-     * 关键点（中文）：compact 只替换 Provider 后续可见的 ModelMessage，
-     * Session 语义消息与持久化历史仍保持完整，等待 turn 收口后再单独归档。
-     */
-    replace_model_messages(messages: ModelMessage[]): void;
-    /** 使用 Composer 重新生成的模型历史原子替换当前基线。 */
-    replace_model_history(messages: ModelMessage[]): void;
-    private append_session_messages;
-}
-//# sourceMappingURL=CoreEngineMessageState.d.ts.map

package/bin/executor/core-engine/CoreEngineMessageState.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CoreEngineMessageState.d.ts","sourceRoot":"","sources":["../../../src/executor/core-engine/CoreEngineMessageState.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAAkB,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE5F;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;IACH,OAAO,CAAC,sBAAsB,CAAiB;IAE/C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IAEvC,OAAO;IAcP;;OAEG;WACU,MAAM,CAAC,MAAM,EAAE;QAC1B;;WAEG;QACH,QAAQ,EAAE,YAAY,EAAE,CAAC;QACzB;;WAEG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAOnC;;OAEG;IACH,IAAI,cAAc,IAAI,YAAY,EAAE,CAEnC;IAED;;OAEG;IACG,2BAA2B,CAC/B,QAAQ,EAAE,kBAAkB,EAAE,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC;IAK1B;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAKrD;;;;;OAKG;IACH,sBAAsB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAItD,qCAAqC;IACrC,qBAAqB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;YAIvC,uBAAuB;CAUtC"}

package/bin/executor/core-engine/CoreEngineMessageState.js

@@ -1,81 +0,0 @@
-/**
- * CoreEngine 模型消息运行态。
- *
- * 关键点（中文）
- * - CoreEngine 只维护本 Turn 后续模型 Step 需要的标准 ModelMessage。
- * - canonical SessionMessage 的持久化由 SessionMessages 独立拥有。
- */
-import { session_messages_to_model_messages } from "../messages/SessionModelMessages.js";
-/**
- * CoreEngine 单轮执行期间的消息基线。
- */
-export class CoreEngineMessageState {
-    /**
-     * 当前模型侧消息基线。
-     */
-    current_model_messages;
-    /**
-     * 当前项目根目录，用于解析历史中的相对路径 file part。
-     */
-    project_root;
-    constructor(params) {
-        this.current_model_messages = params.model_messages;
-        this.project_root = params.project_root;
-    }
-    /**
-     * 基于初始模型消息创建运行态。
-     */
-    static async create(params) {
-        return new CoreEngineMessageState({
-            model_messages: Array.isArray(params.messages) ? [...params.messages] : [],
-            project_root: params.project_root,
-        });
-    }
-    /**
-     * 读取当前模型消息。
-     */
-    get model_messages() {
-        return this.current_model_messages;
-    }
-    /**
-     * 把 Step 间新增的 canonical User Message 并入模型基线。
-     */
-    async append_merged_user_messages(messages) {
-        if (messages.length === 0)
-            return [];
-        return await this.append_session_messages(messages);
-    }
-    /**
-     * 追加内部生成的 user nudge 消息。
-     */
-    async append_user_message(message) {
-        await this.append_session_messages([message]);
-    }
-    /**
-     * 追加 SDK 返回的模型 response messages。
-     */
-    append_model_messages(messages) {
-        if (!Array.isArray(messages) || messages.length === 0)
-            return;
-        this.current_model_messages = [...this.current_model_messages, ...messages];
-    }
-    /**
-     * 原子替换当前模型侧消息基线。
-     *
-     * 关键点（中文）：compact 只替换 Provider 后续可见的 ModelMessage，
-     * Session 语义消息与持久化历史仍保持完整，等待 turn 收口后再单独归档。
-     */
-    replace_model_messages(messages) {
-        this.current_model_messages = Array.isArray(messages) ? [...messages] : [];
-    }
-    /** 使用 Composer 重新生成的模型历史原子替换当前基线。 */
-    replace_model_history(messages) {
-        this.current_model_messages = Array.isArray(messages) ? [...messages] : [];
-    }
-    async append_session_messages(messages) {
-        const model_messages = await session_messages_to_model_messages(messages, this.project_root);
-        this.current_model_messages = [...this.current_model_messages, ...model_messages];
-        return model_messages;
-    }
-}
-//# sourceMappingURL=CoreEngineMessageState.js.map

package/bin/executor/core-engine/CoreEngineMessageState.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CoreEngineMessageState.js","sourceRoot":"","sources":["../../../src/executor/core-engine/CoreEngineMessageState.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,kCAAkC,EAAE,MAAM,4CAA4C,CAAC;AAGhG;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACjC;;OAEG;IACK,sBAAsB,CAAiB;IAE/C;;OAEG;IACc,YAAY,CAAU;IAEvC,YAAoB,MASnB;QACC,IAAI,CAAC,sBAAsB,GAAG,MAAM,CAAC,cAAc,CAAC;QACpD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MASnB;QACC,OAAO,IAAI,sBAAsB,CAAC;YAChC,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;YAC1E,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,sBAAsB,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,2BAA2B,CAC/B,QAA8B;QAE9B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACrC,OAAO,MAAM,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,OAA2B;QACnD,MAAM,IAAI,CAAC,uBAAuB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,QAAwB;QAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC9D,IAAI,CAAC,sBAAsB,GAAG,CAAC,GAAG,IAAI,CAAC,sBAAsB,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;OAKG;IACH,sBAAsB,CAAC,QAAwB;QAC7C,IAAI,CAAC,sBAAsB,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,CAAC;IAED,qCAAqC;IACrC,qBAAqB,CAAC,QAAwB;QAC5C,IAAI,CAAC,sBAAsB,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,CAAC;IAEO,KAAK,CAAC,uBAAuB,CACnC,QAA0B;QAE1B,MAAM,cAAc,GAAG,MAAM,kCAAkC,CAC7D,QAAQ,EACR,IAAI,CAAC,YAAY,CAClB,CAAC;QACF,IAAI,CAAC,sBAAsB,GAAG,CAAC,GAAG,IAAI,CAAC,sBAAsB,EAAE,GAAG,cAAc,CAAC,CAAC;QAClF,OAAO,cAAc,CAAC;IACxB,CAAC;CACF"}

package/bin/group/GroupDispatchSession.d.ts

@@ -1,36 +0,0 @@
-/**
- * GroupDispatchSession：单个 GroupSession 独享的持久化调度执行边界。
- *
- * 本对象统一拥有调度队列、当前模型取消信号和调度 Turn 状态。调度策略只负责决策，
- * 不再自行拥有跨 GroupSession 的运行状态或停止语义。
- */
-import type { GroupDispatchSessionDataStore, GroupDispatchSessionInput, GroupDispatchSessionOptions, GroupDispatchSessionResult } from "../types/group/GroupDispatchSession.js";
-/** 主动停止 Dispatch Session 时使用的内部错误。 */
-export declare class GroupDispatchStoppedError extends Error {
-    constructor();
-}
-/** GroupSession 私有的调度 Session。 */
-export declare class GroupDispatchSession {
-    private readonly dispatch_strategy;
-    private store?;
-    private queue_tail;
-    private active_abort_controller?;
-    private stopping;
-    private disposed;
-    constructor(options: GroupDispatchSessionOptions);
-    /** 绑定持久化视图，并把进程中断留下的运行态明确收口为 stopped。 */
-    initialize(store: GroupDispatchSessionDataStore): Promise<this>;
-    /** 按提交顺序执行一次调度，并在返回前持久化最终决定。 */
-    decide(input: GroupDispatchSessionInput): Promise<GroupDispatchSessionResult>;
-    /** 中断当前模型调用，并让尚未开始的调度 Turn 按队列顺序收口。 */
-    stop(): Promise<void>;
-    /** 永久释放当前 Dispatch Session。 */
-    dispose(): Promise<void>;
-    /** 执行队首调度 Turn，确保成功、失败和停止都形成持久化终态。 */
-    private execute_turn;
-    /** 提交没有 decision 的失败或停止终态。 */
-    private persist_terminal_turn;
-    private require_store;
-    private assert_available;
-}
-//# sourceMappingURL=GroupDispatchSession.d.ts.map

package/bin/group/GroupDispatchSession.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"GroupDispatchSession.d.ts","sourceRoot":"","sources":["../../src/group/GroupDispatchSession.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAE3B,MAAM,uCAAuC,CAAC;AAE/C,sCAAsC;AACtC,qBAAa,yBAA0B,SAAQ,KAAK;;CAKnD;AAED,kCAAkC;AAClC,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmD;IACrF,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,uBAAuB,CAAC,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,2BAA2B;IAIhD,yCAAyC;IACnC,UAAU,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBrE,gCAAgC;IAChC,MAAM,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAsB7E,uCAAuC;IACjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,+BAA+B;IACzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,sCAAsC;YACxB,YAAY;IAmD1B,8BAA8B;YAChB,qBAAqB;IAanC,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,gBAAgB;CAIzB"}

package/bin/group/GroupDispatchSession.js.map

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

package/bin/internal/AgentRuntime.d.ts

@@ -1,43 +0,0 @@
-/**
- * Agent 内部运行时协议。
- *
- * 这些函数只供 City、transport 与 Agent 自身使用。它们承载 Agent 与
- * Workspace 的运行时关系，但不把执行作用域提升为 Agent 的公开领域 API。
- */
-import { Agent } from "../agent/Agent.js";
-import { WorkspaceEntry } from "../agent/WorkspaceEntry.js";
-import type { WorkspaceBase } from "@downcity/workspace";
-import type { City } from "../city/index.js";
-import type { Embassy } from "@downcity/federation";
-import type { StorageProvider, StorageScope } from "@downcity/workspace";
-import type { AgentStorage } from "../types/agent/AgentStorage.js";
-export declare function initialize_agent_runtime(agent: Agent): void;
-export declare function attach_agent_city(agent: Agent, city: City): void;
-/** 将 City 提供的底层 Storage 注入 Agent；该函数只在组合根调用。 */
-export declare function attach_agent_storage(agent: Agent, storage_provider: StorageProvider): void;
-/** 标记 Agent 已经创建或恢复过无 City 的 Session。 */
-export declare function mark_agent_session_started(agent: Agent): void;
-export declare function detach_agent_city(agent: Agent, city: City): void;
-export declare function agent_is_in_city(agent: Agent): boolean;
-/** 返回 City 注入的窄 Embassy 能力。 */
-export declare function agent_embassy(agent: Agent): Embassy | undefined;
-/** 由 Agent 释放自身时通知所属 City。 */
-export declare function release_agent_from_city(agent: Agent): void;
-/** 返回 Agent 解释出的业务存储作用域。 */
-export declare function agent_storage_scope(agent: Agent): StorageScope;
-/** 返回指定 Agent Plugin 的底层数据作用域。 */
-export declare function plugin_storage_scope(agent: Agent, plugin_id: string): StorageScope;
-/** 获取或创建 Agent 唯一的 Session 存储。 */
-export declare function get_agent_storage(agent: Agent): AgentStorage;
-/** 启动 Agent 唯一的 ActionSchedule 轮询器；重复调用共享同一个启动 Promise。 */
-export declare function ensure_agent_action_schedule(agent: Agent): void;
-/** 停止 Agent 级后台资源并释放 Agent 级 Store。 */
-export declare function dispose_agent_runtime(agent: Agent): Promise<void>;
-/** 返回 Agent 已装配的唯一存储；未装配时返回 null。 */
-export declare function agent_storage(agent: Agent): AgentStorage | null;
-export declare function create_workspace_entry(agent: Agent, workspace: WorkspaceBase): WorkspaceEntry;
-export declare function get_workspace_entry(agent: Agent, workspace_id_input: string): WorkspaceEntry | null;
-export declare function list_workspace_entries(agent: Agent): readonly WorkspaceEntry[];
-export declare function release_workspace_entry(agent: Agent, workspace_id: string, entry: WorkspaceEntry): void;
-export declare function clear_agent_runtime(agent: Agent): void;
-//# sourceMappingURL=AgentRuntime.d.ts.map

package/bin/internal/AgentRuntime.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentRuntime.d.ts","sourceRoot":"","sources":["../../src/internal/AgentRuntime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAsBlE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAK3D;AAQD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAYhE;AAED,gDAAgD;AAChD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,eAAe,GAAG,IAAI,CAW1F;AAED,yCAAyC;AACzC,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAG7D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAMhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEtD;AAED,+BAA+B;AAC/B,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,CAE/D;AAED,8BAA8B;AAC9B,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAE1D;AAED,4BAA4B;AAC5B,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAE9D;AAED,kCAAkC;AAClC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAOlF;AAED,kCAAkC;AAClC,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,GACX,YAAY,CAgBd;AAED,2DAA2D;AAC3D,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAqB/D;AAED,uCAAuC;AACvC,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvE;AAED,qCAAqC;AACrC,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,IAAI,CAE/D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,GAAG,cAAc,CA0B7F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAEnG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,cAAc,EAAE,CAE9E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAQvG;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAEtD"}

package/bin/internal/AgentRuntime.js

@@ -1,179 +0,0 @@
-import { WorkspaceEntry } from "../agent/WorkspaceEntry.js";
-import { MemoryStorageProvider } from "@downcity/workspace";
-import { LocalSessionStore } from "../workspace/store/LocalSessionStore.js";
-import { start_action_schedule_runtime, } from "../plugin/core/ActionScheduleRuntime.js";
-const runtime_states = new WeakMap();
-/** 未加入 City 的 Workspace 只允许一个 Agent 建立执行作用域。 */
-const unbound_workspace_owners = new WeakMap();
-export function initialize_agent_runtime(agent) {
-    runtime_states.set(agent, {
-        workspaces_by_id: new Map(),
-        storage_provider: new MemoryStorageProvider(),
-    });
-}
-function runtime_state(agent) {
-    const state = runtime_states.get(agent);
-    if (!state)
-        throw new Error(`Agent "${agent.id}" runtime is not initialized`);
-    return state;
-}
-export function attach_agent_city(agent, city) {
-    const state = runtime_state(agent);
-    if (state.memory_session_started) {
-        throw new Error(`Agent "${agent.id}" already created Session data without City; join City before creating Sessions`);
-    }
-    if (state.bound_city && state.bound_city !== city) {
-        throw new Error(`Agent "${agent.id}" already belongs to another City`);
-    }
-    state.bound_city = city;
-    state.embassy = city.embassy;
-}
-/** 将 City 提供的底层 Storage 注入 Agent；该函数只在组合根调用。 */
-export function attach_agent_storage(agent, storage_provider) {
-    const state = runtime_state(agent);
-    if (state.memory_session_started) {
-        throw new Error(`Agent "${agent.id}" already created Session data without City; join City before creating Sessions`);
-    }
-    if (state.agent_storage) {
-        throw new Error(`Agent "${agent.id}" storage is already initialized`);
-    }
-    state.storage_provider = storage_provider;
-}
-/** 标记 Agent 已经创建或恢复过无 City 的 Session。 */
-export function mark_agent_session_started(agent) {
-    const state = runtime_state(agent);
-    if (!state.bound_city)
-        state.memory_session_started = true;
-}
-export function detach_agent_city(agent, city) {
-    const state = runtime_state(agent);
-    if (state.bound_city === city) {
-        state.bound_city = undefined;
-        state.embassy = undefined;
-    }
-}
-export function agent_is_in_city(agent) {
-    return Boolean(runtime_state(agent).bound_city);
-}
-/** 返回 City 注入的窄 Embassy 能力。 */
-export function agent_embassy(agent) {
-    return runtime_state(agent).embassy;
-}
-/** 由 Agent 释放自身时通知所属 City。 */
-export function release_agent_from_city(agent) {
-    runtime_state(agent).bound_city?.release_agent(agent);
-}
-/** 返回 Agent 解释出的业务存储作用域。 */
-export function agent_storage_scope(agent) {
-    return runtime_state(agent).storage_provider.open_scope(["agents", agent.id]);
-}
-/** 返回指定 Agent Plugin 的底层数据作用域。 */
-export function plugin_storage_scope(agent, plugin_id) {
-    return runtime_state(agent).storage_provider.open_scope([
-        "agents",
-        agent.id,
-        "plugins",
-        plugin_id,
-    ]);
-}
-/** 获取或创建 Agent 唯一的 Session 存储。 */
-export function get_agent_storage(agent) {
-    const state = runtime_state(agent);
-    if (state.agent_storage)
-        return state.agent_storage;
-    const scope = state.storage_provider.open_scope(["agents", agent.id]);
-    const files = scope.files;
-    const storage = {
-        root_path: scope.root_path,
-        files,
-        sessions: new LocalSessionStore({
-            files,
-            storage_root_path: scope.root_path,
-            agent_id: agent.id,
-        }),
-    };
-    state.agent_storage = storage;
-    return storage;
-}
-/** 启动 Agent 唯一的 ActionSchedule 轮询器；重复调用共享同一个启动 Promise。 */
-export function ensure_agent_action_schedule(agent) {
-    const state = runtime_state(agent);
-    if (state.action_schedule || state.action_schedule_promise)
-        return;
-    const storage = state.agent_storage;
-    if (!storage)
-        return;
-    state.action_schedule_promise = (async () => {
-        await agent.ensure_ready();
-        const handle = await start_action_schedule_runtime(agent.id, storage, agent.get_logger(), (workspace_id) => {
-            const state = runtime_state(agent);
-            if (workspace_id)
-                return state.workspaces_by_id.get(workspace_id)?.get_context() || null;
-            return state.workspaces_by_id.values().next().value?.get_context() || null;
-        });
-        state.action_schedule = handle;
-    })().catch((error) => {
-        agent.get_logger().error(`ActionSchedule start failed: ${String(error)}`);
-    });
-}
-/** 停止 Agent 级后台资源并释放 Agent 级 Store。 */
-export async function dispose_agent_runtime(agent) {
-    const state = runtime_state(agent);
-    await state.action_schedule_promise?.catch(() => undefined);
-    state.action_schedule?.stop();
-    state.action_schedule = undefined;
-    state.action_schedule_promise = undefined;
-    await state.agent_storage?.sessions.dispose();
-    state.agent_storage = undefined;
-}
-/** 返回 Agent 已装配的唯一存储；未装配时返回 null。 */
-export function agent_storage(agent) {
-    return runtime_state(agent).agent_storage ?? null;
-}
-export function create_workspace_entry(agent, workspace) {
-    const state = runtime_state(agent);
-    const workspace_id = String(workspace?.id || "").trim();
-    if (!workspace_id)
-        throw new Error("Agent sessions require a Workspace with a stable id");
-    const city = state.bound_city;
-    if (city && city.get_workspace(workspace_id) !== workspace) {
-        throw new Error(`Workspace "${workspace_id}" does not belong to the Agent City`);
-    }
-    if (!city) {
-        const owner = unbound_workspace_owners.get(workspace);
-        if (owner && owner !== agent) {
-            throw new Error(`Workspace "${workspace_id}" already bound to another scope`);
-        }
-        unbound_workspace_owners.set(workspace, agent);
-    }
-    const existing = state.workspaces_by_id.get(workspace_id);
-    if (existing) {
-        if (existing.workspace !== workspace) {
-            throw new Error(`Agent already entered Workspace "${workspace_id}" with another instance`);
-        }
-        return existing;
-    }
-    const entry = new WorkspaceEntry({ agent, workspace });
-    state.workspaces_by_id.set(workspace_id, entry);
-    ensure_agent_action_schedule(agent);
-    return entry;
-}
-export function get_workspace_entry(agent, workspace_id_input) {
-    return runtime_state(agent).workspaces_by_id.get(String(workspace_id_input || "").trim()) ?? null;
-}
-export function list_workspace_entries(agent) {
-    return [...runtime_state(agent).workspaces_by_id.values()];
-}
-export function release_workspace_entry(agent, workspace_id, entry) {
-    const state = runtime_state(agent);
-    if (state.workspaces_by_id.get(workspace_id) === entry) {
-        state.workspaces_by_id.delete(workspace_id);
-        if (!state.bound_city && unbound_workspace_owners.get(entry.workspace) === agent) {
-            unbound_workspace_owners.delete(entry.workspace);
-        }
-    }
-}
-export function clear_agent_runtime(agent) {
-    runtime_states.delete(agent);
-}
-//# sourceMappingURL=AgentRuntime.js.map

package/bin/internal/AgentRuntime.js.map

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

package/bin/internal/GroupRuntime.d.ts

@@ -1,17 +0,0 @@
-/** Group 内部运行时：连接 Group 与 City 提供的底层 Storage。 */
-import type { Group } from "../group/Group.js";
-import type { GroupSessionStore } from "../types/group/GroupSessionStore.js";
-import type { StorageProvider } from "@downcity/workspace";
-/** 初始化 Group 内部运行时，并默认使用内存 Storage。 */
-export declare function initialize_group_runtime(group: Group): void;
-/** 将 City 提供的 Storage 绑定到 Group。 */
-export declare function attach_group_storage(group: Group, storage_provider: StorageProvider, owner?: object): void;
-/** 解除 Group 与 City Storage 的绑定，允许主体重新装配到其他 City。 */
-export declare function detach_group_storage(group: Group, owner?: object): Promise<void>;
-/** 获取 Group 的 GroupSession 持久化 Store。 */
-export declare function get_group_session_store(group: Group): GroupSessionStore;
-/** 标记 Group 已经创建或恢复过一个 GroupSession。 */
-export declare function mark_group_session_started(group: Group): void;
-/** 释放 Group 的 Store 运行时引用。 */
-export declare function dispose_group_runtime(group: Group): Promise<void>;
-//# sourceMappingURL=GroupRuntime.d.ts.map

package/bin/internal/GroupRuntime.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"GroupRuntime.d.ts","sourceRoot":"","sources":["../../src/internal/GroupRuntime.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAmB3D,uCAAuC;AACvC,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAE3D;AAED,oCAAoC;AACpC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAc1G;AAED,oDAAoD;AACpD,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtF;AAED,yCAAyC;AACzC,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,iBAAiB,CAUvE;AAED,wCAAwC;AACxC,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAK7D;AAED,8BAA8B;AAC9B,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE"}