@downcity/agent 1.1.237 → 1.1.258

package/bin/session/SessionQueue.js

@@ -0,0 +1,60 @@
+/**
+ * Session FIFO 输入队列。
+ *
+ * 只负责保存和按顺序取出 Prompt/Command，不执行命令，也不持有 active Turn。
+ */
+/** 单个 Session 的进程内 FIFO。 */
+export class SessionQueue {
+    items = [];
+    /** 追加 Prompt 并返回等待 Turn Handle 的 Promise。 */
+    enqueue_prompt(input) {
+        const deferred_handle = create_deferred();
+        this.items.push({ type: "prompt", input, deferred_handle });
+        return deferred_handle.promise;
+    }
+    /** 追加明确的领域命令。 */
+    enqueue_command(command) {
+        this.items.push(command);
+    }
+    /** 当前队列是否包含 Prompt。 */
+    has_prompt() {
+        return this.items.some((item) => item.type === "prompt");
+    }
+    /** 当前队列是否包含 Command。 */
+    has_command() {
+        return this.items.some((item) => item.type !== "prompt");
+    }
+    /** 取出第一条 Prompt，以及它之前按顺序排队的命令。 */
+    take_next_prompt() {
+        const prompt_index = this.items.findIndex((item) => item.type === "prompt");
+        if (prompt_index < 0)
+            return null;
+        const commands = this.items.splice(0, prompt_index);
+        const prompt = this.items.shift();
+        return prompt?.type === "prompt" ? { commands, prompt } : null;
+    }
+    /** 取出当前全部输入，供下一个 Step 检查点按顺序提交。 */
+    drain() {
+        return this.items.splice(0, this.items.length);
+    }
+    /** 把尚未处理的输入恢复到队列头部。 */
+    restore_front(items) {
+        this.items.unshift(...items);
+    }
+    /** 取消全部排队 Prompt，同时保留等待下一 Step 的命令。 */
+    cancel_prompts() {
+        const prompts = this.items.filter((item) => item.type === "prompt");
+        const commands = this.items.filter((item) => item.type !== "prompt");
+        this.items.splice(0, this.items.length, ...commands);
+        return prompts;
+    }
+}
+/** 创建最小 Promise 控制器。 */
+function create_deferred() {
+    let resolve;
+    const promise = new Promise((next) => {
+        resolve = next;
+    });
+    return { promise, resolve };
+}
+//# sourceMappingURL=SessionQueue.js.map

package/bin/session/SessionQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionQueue.js","sourceRoot":"","sources":["../../src/session/SessionQueue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,4BAA4B;AAC5B,MAAM,OAAO,YAAY;IACN,KAAK,GAAuB,EAAE,CAAC;IAEhD,6CAA6C;IAC7C,cAAc,CAAC,KAA8B;QAC3C,MAAM,eAAe,GAAG,eAAe,EAA0B,CAAC;QAClE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;QAC5D,OAAO,eAAe,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,iBAAiB;IACjB,eAAe,CAAC,OAA4B;QAC1C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,uBAAuB;IACvB,UAAU;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,wBAAwB;IACxB,WAAW;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,kCAAkC;IAClC,gBAAgB;QAMd,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC5E,IAAI,YAAY,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAA0B,CAAC;QAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAClC,OAAO,MAAM,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,CAAC;IAED,mCAAmC;IACnC,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,uBAAuB;IACvB,aAAa,CAAC,KAAyB;QACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,uCAAuC;IACvC,cAAc;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAC/B,CAAC,IAAI,EAA+B,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAC9D,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAChC,CAAC,IAAI,EAA+B,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAC9D,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,wBAAwB;AACxB,SAAS,eAAe;IACtB,IAAI,OAA4B,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,IAAI,EAAE,EAAE;QACtC,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/bin/session/SessionState.d.ts

@@ -0,0 +1,70 @@
+/**
+ * SessionState：本地 Session 配置与 Metadata 状态。
+ *
+ * 关键点（中文）
+ * - 统一管理本地 Session 的初始化、配置、标题与 metadata。
+ * - Message 持久化统一交给 `SessionMessages`，这里仅读取 Message 快照更新 metadata。
+ * - 不负责 Turn 编排、Message 创建或 Action 生命周期。
+ */
+import type { AgentSessionConfigSnapshot, AgentSessionSetInput } from "../types/agent/SessionTypes.js";
+import type { SessionModelQueueCommand } from "../types/session/SessionQueue.js";
+import type { SessionConfiguredCommandResult, SessionSetOptions, SessionStateOptions } from "../types/session/SessionState.js";
+/**
+ * 本地 Session 配置与 Metadata 状态管理器。
+ */
+export declare class SessionState {
+    private readonly agent_id;
+    private readonly project_root;
+    private readonly session_id;
+    private readonly messages;
+    private readonly state;
+    private readonly logger;
+    private readonly ensure_configured_hook?;
+    private readonly get_model;
+    private readonly publish_event;
+    constructor(options: SessionStateOptions);
+    /**
+     * 读取当前 session 配置快照。
+     */
+    get_config(): AgentSessionConfigSnapshot;
+    /**
+     * 读取当前 session 创建时间。
+     */
+    get_created_at(): number;
+    /**
+     * 读取当前 session 参考时区。
+     */
+    get_timezone(): string;
+    /**
+     * 初始化当前 session metadata 与内存快照。
+     */
+    initialize(): Promise<void>;
+    /**
+     * 在执行前确保当前 session 已完成初始化与宿主装配。
+     */
+    ensure_ready_for_execution(): Promise<void>;
+    /**
+     * 在 prompt 执行前确保当前 session 已可运行。
+     */
+    ensure_runnable(): Promise<void>;
+    /**
+     * 写入当前 session 配置。
+     */
+    set(input: AgentSessionSetInput, options?: SessionSetOptions): Promise<SessionConfiguredCommandResult>;
+    /** 在 Session Step 检查点提交模型配置。 */
+    apply_model_command(command: SessionModelQueueCommand): Promise<void>;
+    /**
+     * 仅刷新当前 session metadata。
+     */
+    touch_metadata(): Promise<void>;
+    /**
+     * 确保当前 session 已持久化 title。
+     */
+    ensure_title_from_history(input?: {
+        /**
+         * 是否允许调用模型生成标题。
+         */
+        generate?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=SessionState.d.ts.map

package/bin/session/SessionState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionState.d.ts","sourceRoot":"","sources":["../../src/session/SessionState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,KAAK,EACV,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAMhF,OAAO,KAAK,EACV,8BAA8B,EAC9B,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAEzC;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAgD;IACxF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;gBAEzD,OAAO,EAAE,mBAAmB;IAYxC;;OAEG;IACH,UAAU,IAAI,0BAA0B;IAMxC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCjC;;OAEG;IACG,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtC;;OAEG;IACG,GAAG,CACP,KAAK,EAAE,oBAAoB,EAC3B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,8BAA8B,CAAC;IA6D1C,gCAAgC;IAC1B,mBAAmB,CACvB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC;IAMhB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBrC;;OAEG;IACG,yBAAyB,CAAC,KAAK,CAAC,EAAE;QACtC;;WAEG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;CAuClB"}

package/bin/session/SessionState.js

@@ -0,0 +1,267 @@
+/**
+ * SessionState：本地 Session 配置与 Metadata 状态。
+ *
+ * 关键点（中文）
+ * - 统一管理本地 Session 的初始化、配置、标题与 metadata。
+ * - Message 持久化统一交给 `SessionMessages`，这里仅读取 Message 快照更新 metadata。
+ * - 不负责 Turn 编排、Message 创建或 Action 生命周期。
+ */
+import { inferAgentModelLabel, read_agent_model_context_window, } from "../agent/AgentModel.js";
+import { patchSessionModelLabel, readSessionMetadata, resolveSystemTimezone, writeSessionMetadata, } from "../session/storage/Metadata.js";
+import { touchSessionMetadata } from "../session/storage/Metadata.js";
+import { ensureSessionTitle } from "../session/SessionTitle.js";
+import { generateId } from "../utils/Id.js";
+import { to_executor_history } from "../session/messages/SessionMessageCodec.js";
+/**
+ * 本地 Session 配置与 Metadata 状态管理器。
+ */
+export class SessionState {
+    agent_id;
+    project_root;
+    session_id;
+    messages;
+    state;
+    logger;
+    ensure_configured_hook;
+    get_model;
+    publish_event;
+    constructor(options) {
+        this.agent_id = options.agent_id;
+        this.project_root = options.project_root;
+        this.session_id = options.session_id;
+        this.messages = options.messages;
+        this.state = options.state;
+        this.logger = options.logger;
+        this.ensure_configured_hook = options.ensure_configured_hook;
+        this.get_model = options.get_model;
+        this.publish_event = options.publish_event;
+    }
+    /**
+     * 读取当前 session 配置快照。
+     */
+    get_config() {
+        return {
+            ...this.state.session_config,
+        };
+    }
+    /**
+     * 读取当前 session 创建时间。
+     */
+    get_created_at() {
+        return this.state.created_at;
+    }
+    /**
+     * 读取当前 session 参考时区。
+     */
+    get_timezone() {
+        return this.state.timezone;
+    }
+    /**
+     * 初始化当前 session metadata 与内存快照。
+     */
+    async initialize() {
+        if (this.state.initialize_promise) {
+            await this.state.initialize_promise;
+            return;
+        }
+        this.state.initialize_promise = (async () => {
+            const metadata = await readSessionMetadata({
+                projectRoot: this.project_root,
+                agentId: this.agent_id,
+                sessionId: this.session_id,
+            });
+            const created_at = typeof metadata.createdAt === "number" ? metadata.createdAt : Date.now();
+            const timezone = typeof metadata.timezone === "string" && metadata.timezone.trim()
+                ? metadata.timezone.trim()
+                : resolveSystemTimezone();
+            await writeSessionMetadata({
+                projectRoot: this.project_root,
+                agentId: this.agent_id,
+                sessionId: this.session_id,
+                meta: {
+                    ...metadata,
+                    agentId: this.agent_id,
+                    createdAt: created_at,
+                    timezone,
+                },
+            });
+            this.state.created_at = created_at;
+            this.state.timezone = timezone;
+            this.state.session_config = {};
+            this.state.effective_session_config = {
+                ...this.state.session_config,
+            };
+        })();
+        await this.state.initialize_promise;
+    }
+    /**
+     * 在执行前确保当前 session 已完成初始化与宿主装配。
+     */
+    async ensure_ready_for_execution() {
+        await this.initialize();
+        if (this.state.ensure_configured_promise) {
+            await this.state.ensure_configured_promise;
+            return;
+        }
+        this.state.ensure_configured_promise = (async () => {
+            if (!this.ensure_configured_hook)
+                return;
+            await this.ensure_configured_hook();
+        })();
+        try {
+            await this.state.ensure_configured_promise;
+        }
+        catch (error) {
+            this.state.ensure_configured_promise = null;
+            throw error;
+        }
+    }
+    /**
+     * 在 prompt 执行前确保当前 session 已可运行。
+     */
+    async ensure_runnable() {
+        await this.ensure_ready_for_execution();
+        if (!this.get_model()) {
+            throw new Error("requires a configured model.");
+        }
+    }
+    /**
+     * 写入当前 session 配置。
+     */
+    async set(input, options) {
+        const should_emit_action = options?.emit_action !== false;
+        const previous_model_label = this.state.session_config.modelLabel;
+        const next_model = input.model;
+        const next_model_label = next_model
+            ? inferAgentModelLabel(next_model)
+            : undefined;
+        const previous_model_name = String(previous_model_label || "").trim();
+        const next_model_name = String(next_model_label || "").trim();
+        const should_emit_model_switch_action = Boolean(next_model &&
+            should_emit_action &&
+            this.state.session_config.model &&
+            previous_model_name &&
+            next_model_name &&
+            previous_model_name !== next_model_name);
+        const action_id = `model-switching:${this.session_id}:${Date.now()}:${generateId()}`;
+        const next_config = {
+            ...this.state.session_config,
+        };
+        if (next_model) {
+            next_config.model = next_model;
+            next_config.modelLabel = next_model_label;
+            next_config.model_context_window =
+                read_agent_model_context_window(next_model);
+        }
+        await patchSessionModelLabel({
+            projectRoot: this.project_root,
+            agentId: this.agent_id,
+            sessionId: this.session_id,
+            model: next_config.model,
+        });
+        this.state.session_config = next_config;
+        if (options?.emit_action === false) {
+            await this.apply_model_command({
+                type: "session_model",
+                command_id: generateId(),
+                config: next_config,
+            });
+            return {};
+        }
+        return {
+            command: {
+                type: "session_model",
+                command_id: generateId(),
+                config: next_config,
+                ...(should_emit_model_switch_action
+                    ? {
+                        action_id,
+                        action_title: `Session model switched from ${previous_model_name} to ${next_model_name}`,
+                    }
+                    : {}),
+            },
+        };
+    }
+    /** 在 Session Step 检查点提交模型配置。 */
+    async apply_model_command(command) {
+        this.state.effective_session_config = {
+            ...command.config,
+        };
+    }
+    /**
+     * 仅刷新当前 session metadata。
+     */
+    async touch_metadata() {
+        const stats = await this.messages.storage_stats();
+        const preview_text = resolve_message_preview(stats.latest_message || undefined).slice(0, 180);
+        await touchSessionMetadata({
+            projectRoot: this.project_root,
+            agentId: this.agent_id,
+            sessionId: this.session_id,
+            sessionConfig: this.state.session_config,
+            message_count: stats.message_count,
+            history_bytes: stats.history_bytes,
+            ...(preview_text ? { preview_text } : {}),
+        });
+    }
+    /**
+     * 确保当前 session 已持久化 title。
+     */
+    async ensure_title_from_history(input) {
+        const messages = to_executor_history(this.session_id, await this.messages.context_snapshot());
+        const before_metadata = await readSessionMetadata({
+            projectRoot: this.project_root,
+            agentId: this.agent_id,
+            sessionId: this.session_id,
+        });
+        const before_title = String(before_metadata.title || "").trim();
+        const next_metadata = await ensureSessionTitle({
+            projectRoot: this.project_root,
+            agentId: this.agent_id,
+            sessionId: this.session_id,
+            messages,
+            ...(input?.generate
+                ? {
+                    model: this.get_model(),
+                }
+                : {}),
+            ...(this.state.session_config.modelLabel
+                ? { modelLabel: this.state.session_config.modelLabel }
+                : {}),
+            logger: this.logger,
+            generate: input?.generate === true,
+        });
+        const next_title = String(next_metadata.title || "").trim();
+        if (!next_title || next_title === before_title)
+            return;
+        this.publish_event({
+            mutation_id: generateId(),
+            variant: "session",
+            type: "title",
+            session_id: this.session_id,
+            created_at: Date.now(),
+            title: next_title,
+        });
+    }
+}
+function resolve_message_preview(message) {
+    if (!message)
+        return "";
+    if (message.type === "user") {
+        return message.parts
+            .flatMap((part) => part.type === "text" ? [part.text] : [])
+            .join("")
+            .trim();
+    }
+    if (message.type === "assistant") {
+        return message.parts
+            .flatMap((part) => part.type === "text" ? [part.text] : [])
+            .join("")
+            .trim();
+    }
+    if (message.type === "action") {
+        return [message.title, message.description].filter(Boolean).join("\n");
+    }
+    return message.message.trim();
+}
+//# sourceMappingURL=SessionState.js.map

package/bin/session/SessionState.js.map

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

package/bin/session/SessionSystem.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SDK Session 默认 system block 组装逻辑。
+ *
+ * 关键点（中文）
+ * - 面向 `Agent` SDK 的本地会话执行场景。
+ * - 注入调用方显式传入的静态 instruction、受托管 plugin system 与显式注册 plugin system。
+ * - SDK 不在 system 中注入动态变量；动态上下文应由调用方放入 user message。
+ */
+import type { AgentSessionSystemBlock } from "../types/agent/SessionTypes.js";
+import type { BuildSessionSystemBlocksInput } from "../types/session/SessionSystem.js";
+/**
+ * 解析 SDK session 当前生效的 system blocks。
+ */
+export declare function build_session_system_blocks(input: BuildSessionSystemBlocksInput): Promise<AgentSessionSystemBlock[]>;
+//# sourceMappingURL=SessionSystem.d.ts.map

package/bin/session/SessionSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionSystem.d.ts","sourceRoot":"","sources":["../../src/session/SessionSystem.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AA8DtF;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAoCpC"}

package/bin/session/SessionSystem.js

@@ -0,0 +1,95 @@
+/**
+ * SDK Session 默认 system block 组装逻辑。
+ *
+ * 关键点（中文）
+ * - 面向 `Agent` SDK 的本地会话执行场景。
+ * - 注入调用方显式传入的静态 instruction、受托管 plugin system 与显式注册 plugin system。
+ * - SDK 不在 system 中注入动态变量；动态上下文应由调用方放入 user message。
+ */
+function normalize_system_blocks(blocks) {
+    if (!Array.isArray(blocks))
+        return [];
+    return blocks
+        .map((block) => {
+        const content = String(block?.content || "").trim();
+        if (!content)
+            return null;
+        const source = block.source;
+        if (source !== "core" &&
+            source !== "instruction" &&
+            source !== "plugin" &&
+            source !== "session") {
+            return null;
+        }
+        return {
+            source,
+            name: String(block.name || source).trim() || source,
+            content,
+        };
+    })
+        .filter((block) => Boolean(block));
+}
+function create_session_info(input) {
+    const created_at = Number.isFinite(input.created_at) ? input.created_at : 0;
+    return {
+        agentId: String(input.agent_id || "").trim(),
+        sessionId: String(input.session_id || "").trim(),
+        projectRoot: String(input.project_root || "").trim(),
+        createdAt: new Date(created_at).toISOString(),
+        timezone: String(input.timezone || "").trim() || "UTC",
+    };
+}
+function create_session_system_block(session) {
+    const content = [
+        "当前会话上下文：",
+        `你正在服务 agent "${session.agentId}" 的 session "${session.sessionId}"。`,
+        `当前项目根目录是 "${session.projectRoot}"。`,
+        `本会话创建于 ${session.createdAt}，参考时区是 ${session.timezone}。`,
+        "这个创建时间是当前会话的稳定参考时间，不代表每轮运行时的当前时间。",
+        "如果用户消息中提供了新的当前时间、相对时间或其他动态上下文，应优先使用用户消息中的动态信息。",
+    ].join("\n");
+    return {
+        source: "session",
+        name: "context",
+        content,
+    };
+}
+/**
+ * 解析 SDK session 当前生效的 system blocks。
+ */
+export async function build_session_system_blocks(input) {
+    const agent_id = String(input.agent_id || "").trim();
+    const project_root = String(input.project_root || "").trim();
+    const session_id = String(input.session_id || "").trim();
+    const created_at = Number(input.created_at || 0);
+    const timezone = String(input.timezone || "").trim();
+    if (!agent_id) {
+        throw new Error("build_session_system_blocks requires a non-empty agent_id");
+    }
+    if (!project_root) {
+        throw new Error("build_session_system_blocks requires a non-empty project_root");
+    }
+    if (!session_id) {
+        throw new Error("build_session_system_blocks requires a non-empty session_id");
+    }
+    if (!Number.isFinite(created_at) || created_at <= 0) {
+        throw new Error("build_session_system_blocks requires a valid created_at");
+    }
+    if (!timezone) {
+        throw new Error("build_session_system_blocks requires a non-empty timezone");
+    }
+    return [
+        ...normalize_system_blocks(input.get_instruction_system_blocks()),
+        ...normalize_system_blocks(await input.get_managed_plugin_system_blocks()),
+        ...normalize_system_blocks(await input.get_plugin_system_blocks()),
+        // session block 放在最后，尽量保留前缀 system blocks 的跨 session 缓存命中。
+        create_session_system_block(create_session_info({
+            agent_id,
+            project_root,
+            session_id,
+            created_at,
+            timezone,
+        })),
+    ];
+}
+//# sourceMappingURL=SessionSystem.js.map

package/bin/session/SessionSystem.js.map

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

package/bin/session/SessionTurn.d.ts

@@ -0,0 +1,84 @@
+/**
+ * SessionTurn：Session 输入队列与 Turn 生命周期的唯一所有者。
+ *
+ * 关键点（中文）
+ * - `prompt()` 是唯一输入入口，内部决定并入当前 turn 还是排到下一 turn。
+ * - 不把调度逻辑塞进 Executor；Executor 继续只负责单次执行。
+ * - 这里不暴露历史或消息模型，只编排 prompt 队列与 turn 生命周期。
+ */
+import type { AgentSessionPromptInput } from "../types/sdk/AgentSessionPrompt.js";
+import type { AgentSessionStopResult } from "../types/sdk/AgentSessionStop.js";
+import type { SessionQueueCommand } from "../types/session/SessionQueue.js";
+import type { AgentSessionTurnHandle } from "../types/sdk/AgentSessionTurn.js";
+import type { SessionTurnOptions } from "../types/session/SessionTurn.js";
+/**
+ * Session 输入队列与 Turn 编排器。
+ */
+export declare class SessionTurn {
+    private readonly session_id;
+    private readonly project_root;
+    private readonly executor;
+    private readonly state;
+    private readonly messages;
+    private readonly events;
+    private readonly approvals;
+    private readonly apply_command;
+    private readonly queue;
+    private processing_promise;
+    private active_turn;
+    private active_run_context;
+    private request_active_history_reload;
+    constructor(options: SessionTurnOptions);
+    /**
+     * 追加一条新的 prompt。
+     */
+    prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
+    /**
+     * 把一次已成功创建的 command 加入统一输入队列。
+     */
+    enqueue_command(command: SessionQueueCommand): void;
+    /** 把显式历史压缩加入统一输入队列。 */
+    compact(): Promise<void>;
+    /**
+     * 判断是否存在等待并入下一 Session step 的 prompt。
+     */
+    has_pending_prompt(): boolean;
+    /**
+     * 判断是否存在等待在下一 Session step 检查点执行的 command。
+     */
+    has_pending_command(): boolean;
+    /**
+     * 返回当前 actor prompt 调度器是否仍处于活跃态。
+     *
+     * 说明（中文）
+     * - 只要还有排队 prompt，或处理循环尚未结束，就视为活跃。
+     * - Session 会用它阻止内部 direct execution 与 actor 模式并发混用。
+     */
+    is_active(): boolean;
+    /**
+     * 停止当前 turn，并取消尚未被吸收的排队 prompt。
+     */
+    stop(): AgentSessionStopResult;
+    private ensure_processing;
+    private process_loop;
+    private cancel_queued_prompts;
+    /**
+     * 在下一 Session step 检查点按入队顺序提交配置并持久化 steer。
+     */
+    private drain_queued_inputs;
+    /**
+     * 执行一组已经从统一队列截取的 command。
+     */
+    private execute_commands;
+    /** 在 Step 检查点解释并提交一条领域命令。 */
+    private execute_queue_command;
+    /** 执行一个 Turn 内的模型与 Tool Step Loop。 */
+    private execute_prompt_turn;
+    /** 为 Turn 开始前的 compact 命令创建最小运行上下文。 */
+    private create_compaction_run_context;
+    /** 持久化本轮 User 输入，并同步刷新标题与 metadata。 */
+    private persist_prompt_message;
+    /** 持久化 Executor Action，并同步刷新 Session metadata。 */
+    private persist_action_event;
+}
+//# sourceMappingURL=SessionTurn.d.ts.map

package/bin/session/SessionTurn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTurn.d.ts","sourceRoot":"","sources":["../../src/session/SessionTurn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,iCAAiC,CAAC;AAgBzC,OAAO,KAAK,EAGV,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AAMxC;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsC;IACpE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,kBAAkB,CAAkC;IAC5D,OAAO,CAAC,6BAA6B,CAA6B;gBAEtD,OAAO,EAAE,kBAAkB;IAiBvC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAU7E;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAInD,uBAAuB;IACjB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;;;;;OAMG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,IAAI,IAAI,sBAAsB;IAyB9B,OAAO,CAAC,iBAAiB;YAUX,YAAY;IA+G1B,OAAO,CAAC,qBAAqB;IA2C7B;;OAEG;YACW,mBAAmB;IAoCjC;;OAEG;YACW,gBAAgB;IAc9B,6BAA6B;YACf,qBAAqB;IAoCnC,sCAAsC;YACxB,mBAAmB;IA2JjC,uCAAuC;IACvC,OAAO,CAAC,6BAA6B;IAcrC,uCAAuC;YACzB,sBAAsB;IAgBpC,kDAAkD;YACpC,oBAAoB;CAMnC"}