@downcity/agent 1.1.79 → 1.1.81

package/bin/session/services/SessionTurnService.js

@@ -0,0 +1,137 @@
+/**
+ * SessionTurnService：本地 Session turn 编排服务。
+ *
+ * 关键点（中文）
+ * - 统一管理 prompt actor 调度、turn 执行与 Session 事件流派发。
+ * - 该服务负责把 SessionPromptRuntime 与 Executor 连接起来。
+ * - metadata、title、assistant 结果持久化等状态副作用交由 SessionStateService 处理。
+ */
+import { extractTextFromUiMessage } from "../../executor/messages/UIMessageTransformer.js";
+import { mapAgentEventToSessionEvent, mapUiMessageChunkToAgentEvent } from "../../session/SessionEventMapper.js";
+import { SessionPromptRuntime } from "../../session/runtime/SessionPromptRuntime.js";
+/**
+ * 本地 Session turn 编排服务。
+ */
+export class SessionTurnService {
+    session_id;
+    executor;
+    state_service;
+    event_hub;
+    prompt_runtime;
+    constructor(options) {
+        this.session_id = options.session_id;
+        this.executor = options.executor;
+        this.state_service = options.state_service;
+        this.event_hub = options.event_hub;
+        this.prompt_runtime = new SessionPromptRuntime({
+            sessionId: this.session_id,
+            publish: (event) => {
+                this.publish_event(event);
+            },
+            createAndPersistUserMessage: async (input) => {
+                return await this.state_service.create_and_persist_user_prompt_message(input);
+            },
+            executeTurn: async ({ turnId, promptInput, onStepMerge }) => {
+                return await this.execute_prompt_turn({
+                    turnId,
+                    promptInput,
+                    onStepMerge,
+                });
+            },
+        });
+    }
+    /**
+     * 发布一条 session 事件。
+     */
+    publish_event(event) {
+        this.event_hub.publish(event);
+    }
+    /**
+     * 订阅当前 session 的未来事件。
+     */
+    subscribe(subscriber) {
+        return this.event_hub.subscribe(subscriber);
+    }
+    /**
+     * 判断当前 turn 调度器是否活跃。
+     */
+    is_prompt_runtime_active() {
+        return this.prompt_runtime.isActive();
+    }
+    /**
+     * 追加一条新的 Session prompt。
+     */
+    async prompt(input) {
+        const query = String(input.query || "").trim();
+        if (!query) {
+            throw new Error("session.prompt requires a non-empty query");
+        }
+        await this.state_service.ensure_runnable();
+        return await this.prompt_runtime.prompt({
+            query,
+        });
+    }
+    /**
+     * 执行单轮 prompt turn。
+     */
+    async execute_prompt_turn(input) {
+        const tool_name_by_call_id = new Map();
+        const run_context = {
+            sessionId: this.session_id,
+            onStepCallback: input.onStepMerge,
+            onAssistantStepCallback: async (step) => {
+                this.publish_event({
+                    type: "assistant-step",
+                    turnId: input.turnId,
+                    text: step.text,
+                    stepIndex: step.stepIndex,
+                    ...(step.visibility ? { visibility: step.visibility } : {}),
+                });
+            },
+            onUiMessageChunkCallback: async (chunk) => {
+                if (chunk.type === "tool-input-start") {
+                    tool_name_by_call_id.set(chunk.toolCallId, chunk.toolName);
+                    return;
+                }
+                const event = mapUiMessageChunkToAgentEvent(chunk);
+                if (!event)
+                    return;
+                const resolved_event = (event.type === "tool-result" ||
+                    event.type === "tool-error") &&
+                    event.toolName === "unknown"
+                    ? {
+                        ...event,
+                        toolName: tool_name_by_call_id.get(event.toolCallId) || event.toolName,
+                    }
+                    : event;
+                if (resolved_event.type === "tool-call" ||
+                    resolved_event.type === "tool-error") {
+                    tool_name_by_call_id.set(resolved_event.toolCallId, resolved_event.toolName);
+                }
+                const session_event = mapAgentEventToSessionEvent({
+                    event: resolved_event,
+                    turnId: input.turnId,
+                });
+                if (session_event) {
+                    this.publish_event(session_event);
+                }
+            },
+            injectedUserMessages: [],
+            deferredPersistedUserMessages: [],
+            pendingAssistantFileParts: [],
+        };
+        const result = await this.executor.run({
+            query: input.promptInput.query,
+            runContext: run_context,
+        });
+        await this.state_service.persist_assistant_result(result.assistantMessage);
+        await this.state_service.persist_deferred_user_messages(result.deferredPersistedUserMessages);
+        return {
+            text: extractTextFromUiMessage(result.assistantMessage),
+            success: result.success,
+            assistantMessage: result.assistantMessage,
+            ...(result.error ? { error: result.error } : {}),
+        };
+    }
+}
+//# sourceMappingURL=SessionTurnService.js.map

package/bin/session/services/SessionTurnService.js.map

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

package/bin/session/services/SessionViewService.d.ts

@@ -0,0 +1,105 @@
+/**
+ * SessionViewService：本地 Session 查询与派生视图服务。
+ *
+ * 关键点（中文）
+ * - 统一管理 info/history/system/fork 这类读取型能力。
+ * - 该服务只负责拼装查询结果，不负责编排 prompt turn。
+ * - 需要写入持久化状态的地方仍委托给 SessionStateService。
+ */
+import type { JsonlSessionHistoryStore } from "../../executor/store/history/jsonl/JsonlSessionHistoryStore.js";
+import type { SessionSystemComposer } from "../../executor/composer/system/SessionSystemComposer.js";
+import type { AgentSessionForkInput, AgentSessionHistoryInput, AgentSessionHistoryPage, AgentSessionInfo, AgentSessionSystemBlock, AgentSessionSystemSnapshot } from "../../types/agent/AgentTypes.js";
+import { SessionStateService } from "../../session/services/SessionStateService.js";
+type SessionViewServiceOptions<TSession> = {
+    /**
+     * 当前 agent 稳定标识。
+     */
+    agent_id: string;
+    /**
+     * 当前项目根目录。
+     */
+    project_root: string;
+    /**
+     * 当前 session 标识。
+     */
+    session_id: string;
+    /**
+     * 当前 session 历史事实源。
+     */
+    history_store: JsonlSessionHistoryStore;
+    /**
+     * 当前 session 状态服务。
+     */
+    state_service: SessionStateService;
+    /**
+     * 判断当前 session 是否正在执行。
+     */
+    is_executing: () => boolean;
+    /**
+     * 读取 instruction system blocks。
+     */
+    get_instruction_system_blocks: () => AgentSessionSystemBlock[];
+    /**
+     * 读取受托管 plugin system blocks。
+     */
+    get_managed_plugin_system_blocks: () => Promise<AgentSessionSystemBlock[]>;
+    /**
+     * 读取显式注册 plugin system blocks。
+     */
+    get_plugin_system_blocks: () => Promise<AgentSessionSystemBlock[]>;
+    /**
+     * 可选自定义 system composer。
+     *
+     * 关键点（中文）
+     * - 仅当调用方覆盖了 system composer 时传入。
+     * - 默认 SDK system snapshot 仍保留 block 级来源信息。
+     */
+    custom_system_composer?: SessionSystemComposer;
+    /**
+     * 创建一个新的本地 Session 实例。
+     */
+    create_fork_session: (session_id: string) => Promise<{
+        session: TSession;
+        history_store: JsonlSessionHistoryStore;
+        state_service: SessionStateService;
+    }>;
+};
+/**
+ * 本地 Session 查询与派生视图服务。
+ */
+export declare class SessionViewService<TSession> {
+    private readonly agent_id;
+    private readonly project_root;
+    private readonly session_id;
+    private readonly history_store;
+    private readonly state_service;
+    private readonly is_executing;
+    private readonly get_instruction_system_blocks;
+    private readonly get_managed_plugin_system_blocks;
+    private readonly get_plugin_system_blocks;
+    private readonly custom_system_composer?;
+    private readonly create_fork_session;
+    constructor(options: SessionViewServiceOptions<TSession>);
+    /**
+     * 读取当前 session 详情。
+     */
+    get_info(): Promise<AgentSessionInfo>;
+    /**
+     * 读取当前 session 历史分页。
+     */
+    history(input?: AgentSessionHistoryInput): Promise<AgentSessionHistoryPage>;
+    /**
+     * 读取当前 session 生效的 system 快照。
+     */
+    system(): Promise<AgentSessionSystemSnapshot>;
+    private resolve_custom_system_blocks;
+    /**
+     * 从当前 session 创建一个分叉会话。
+     */
+    fork(input?: AgentSessionForkInput | string): Promise<TSession>;
+    private resolve_fork_messages;
+    private append_fork_messages;
+    private stringify_system_content;
+}
+export {};
+//# sourceMappingURL=SessionViewService.d.ts.map

package/bin/session/services/SessionViewService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionViewService.d.ts","sourceRoot":"","sources":["../../../src/session/services/SessionViewService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4DAA4D,CAAC;AAC3G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AACjG,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAGhF,KAAK,yBAAyB,CAAC,QAAQ,IAAI;IACzC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,EAAE,wBAAwB,CAAC;IAExC;;OAEG;IACH,aAAa,EAAE,mBAAmB,CAAC;IAEnC;;OAEG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC;IAE5B;;OAEG;IACH,6BAA6B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAE/D;;OAEG;IACH,gCAAgC,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAE3E;;OAEG;IACH,wBAAwB,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAEnE;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,qBAAqB,CAAC;IAE/C;;OAEG;IACH,mBAAmB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;QACnD,OAAO,EAAE,QAAQ,CAAC;QAClB,aAAa,EAAE,wBAAwB,CAAC;QACxC,aAAa,EAAE,mBAAmB,CAAC;KACpC,CAAC,CAAC;CACJ,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAkB,CAAC,QAAQ;IACtC,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,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsD;IACnF,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAuE;IACrH,OAAO,CAAC,QAAQ,CAAC,gCAAgC,CAA0E;IAC3H,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAkE;IAC3G,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAwB;IAChE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6D;gBAErF,OAAO,EAAE,yBAAyB,CAAC,QAAQ,CAAC;IAexD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA2B3C;;OAEG;IACG,OAAO,CACX,KAAK,CAAC,EAAE,wBAAwB,GAC/B,OAAO,CAAC,uBAAuB,CAAC;IAYnC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,0BAA0B,CAAC;YA0BrC,4BAA4B;IAyB1C;;OAEG;IACG,IAAI,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA6BrE,OAAO,CAAC,qBAAqB;YAef,oBAAoB;IAgBlC,OAAO,CAAC,wBAAwB;CASjC"}

package/bin/session/services/SessionViewService.js

@@ -0,0 +1,184 @@
+/**
+ * SessionViewService：本地 Session 查询与派生视图服务。
+ *
+ * 关键点（中文）
+ * - 统一管理 info/history/system/fork 这类读取型能力。
+ * - 该服务只负责拼装查询结果，不负责编排 prompt turn。
+ * - 需要写入持久化状态的地方仍委托给 SessionStateService。
+ */
+import { nanoid } from "nanoid";
+import { buildSessionHistoryPage, buildSessionInfo, ensureSessionTitle, readSessionMetadata, } from "../../session/index.js";
+import { buildSessionSystemBlocks } from "../../session/SessionSystemBuilder.js";
+/**
+ * 本地 Session 查询与派生视图服务。
+ */
+export class SessionViewService {
+    agent_id;
+    project_root;
+    session_id;
+    history_store;
+    state_service;
+    is_executing;
+    get_instruction_system_blocks;
+    get_managed_plugin_system_blocks;
+    get_plugin_system_blocks;
+    custom_system_composer;
+    create_fork_session;
+    constructor(options) {
+        this.agent_id = options.agent_id;
+        this.project_root = options.project_root;
+        this.session_id = options.session_id;
+        this.history_store = options.history_store;
+        this.state_service = options.state_service;
+        this.is_executing = options.is_executing;
+        this.get_instruction_system_blocks = options.get_instruction_system_blocks;
+        this.get_managed_plugin_system_blocks =
+            options.get_managed_plugin_system_blocks;
+        this.get_plugin_system_blocks = options.get_plugin_system_blocks;
+        this.custom_system_composer = options.custom_system_composer;
+        this.create_fork_session = options.create_fork_session;
+    }
+    /**
+     * 读取当前 session 详情。
+     */
+    async get_info() {
+        const [metadata, messages] = await Promise.all([
+            readSessionMetadata({
+                projectRoot: this.project_root,
+                agentId: this.agent_id,
+                sessionId: this.session_id,
+            }),
+            this.history_store.list(),
+        ]);
+        const metadata_with_title = metadata.title
+            ? metadata
+            : await ensureSessionTitle({
+                projectRoot: this.project_root,
+                agentId: this.agent_id,
+                sessionId: this.session_id,
+                messages,
+            });
+        return buildSessionInfo({
+            projectRoot: this.project_root,
+            agentId: this.agent_id,
+            sessionId: this.session_id,
+            metadata: metadata_with_title,
+            messages,
+            executing: this.is_executing(),
+        });
+    }
+    /**
+     * 读取当前 session 历史分页。
+     */
+    async history(input) {
+        const [session, messages] = await Promise.all([
+            this.get_info(),
+            this.history_store.list(),
+        ]);
+        return buildSessionHistoryPage({
+            session,
+            messages,
+            input,
+        });
+    }
+    /**
+     * 读取当前 session 生效的 system 快照。
+     */
+    async system() {
+        const blocks = this.custom_system_composer
+            ? await this.resolve_custom_system_blocks(this.custom_system_composer)
+            : await buildSessionSystemBlocks({
+                agentId: this.agent_id,
+                projectRoot: this.project_root,
+                sessionId: this.session_id,
+                createdAt: this.state_service.get_created_at(),
+                timezone: this.state_service.get_timezone(),
+                getInstructionSystemBlocks: this.get_instruction_system_blocks,
+                getManagedPluginSystemBlocks: this.get_managed_plugin_system_blocks,
+                getPluginSystemBlocks: this.get_plugin_system_blocks,
+            });
+        return {
+            sessionId: this.session_id,
+            session: {
+                agentId: this.agent_id,
+                sessionId: this.session_id,
+                projectRoot: this.project_root,
+                createdAt: new Date(this.state_service.get_created_at()).toISOString(),
+                timezone: this.state_service.get_timezone(),
+            },
+            blocks,
+        };
+    }
+    async resolve_custom_system_blocks(composer) {
+        const run_context = {
+            sessionId: this.session_id,
+            injectedUserMessages: [],
+            deferredPersistedUserMessages: [],
+            pendingAssistantFileParts: [],
+        };
+        const messages = await composer.resolve(run_context);
+        const blocks = [];
+        messages.forEach((message, index) => {
+            const content = this.stringify_system_content(message.content);
+            if (!content)
+                return;
+            blocks.push({
+                source: "session",
+                name: `${composer.name || "custom_system"}:${index + 1}`,
+                content,
+            });
+        });
+        return blocks;
+    }
+    /**
+     * 从当前 session 创建一个分叉会话。
+     */
+    async fork(input) {
+        const message_id = typeof input === "string"
+            ? String(input || "").trim() || undefined
+            : String(input?.messageId || "").trim() || undefined;
+        const messages = await this.history_store.list();
+        const fork_messages = !message_id
+            ? messages
+            : this.resolve_fork_messages(messages, message_id);
+        const forked_bundle = await this.create_fork_session(`fork-${Date.now()}-${nanoid(8)}`);
+        const forked = forked_bundle.session;
+        const session_config = this.state_service.get_config();
+        if (session_config.model) {
+            await forked.set({
+                model: session_config.model,
+            });
+        }
+        await this.append_fork_messages(forked_bundle, fork_messages);
+        return forked;
+    }
+    resolve_fork_messages(messages, message_id) {
+        const target_index = messages.findIndex((message) => String(message.id || "").trim() === message_id);
+        if (target_index < 0) {
+            throw new Error(`Cannot fork session "${this.session_id}": messageId "${message_id}" not found.`);
+        }
+        return messages.slice(0, target_index + 1);
+    }
+    async append_fork_messages(forked_bundle, messages) {
+        for (const message of messages) {
+            await forked_bundle.history_store.append(message);
+        }
+        await forked_bundle.state_service.ensure_title_from_history({
+            generate: true,
+        });
+        await forked_bundle.state_service.touch_metadata();
+    }
+    stringify_system_content(content) {
+        if (typeof content === "string")
+            return content.trim();
+        if (content === null || content === undefined)
+            return "";
+        try {
+            return JSON.stringify(content);
+        }
+        catch {
+            return String(content || "").trim();
+        }
+    }
+}
+//# sourceMappingURL=SessionViewService.js.map

package/bin/session/services/SessionViewService.js.map

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

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

@@ -9,6 +9,15 @@ import type { Tool } from "ai";
 import type { BasePlugin } from "../../plugin/core/BasePlugin.js";
 import type { AgentModel } from "../../model/CityModelAdapter.js";
 import type { RpcServerInstance } from "../../rpc/Server.js";
+import type { AgentManagedSession, SessionOptions } from "../../types/session/SessionOptions.js";
+/**
+ * Agent 可使用的 Session 类。
+ *
+ * 关键点（中文）
+ * - 传 class，而不是传实例，保证 Agent 可以按 sessionId 创建多个 session。
+ * - 自定义类可继承默认 `Session`，并在构造函数里注入自己的 Composer。
+ */
+export type AgentSessionConstructor = new (options: SessionOptions) => AgentManagedSession;
 /**
  * 本地 Agent 构造参数。
  */
@@ -59,6 +68,15 @@ export interface AgentOptions {
      * - SDK 不再自动注入任何 built-in plugin；需要的能力都应由宿主显式传入。
      */
     plugins?: BasePlugin[];
+    /**
+     * 当前 agent 使用的本地 Session 类。
+     *
+     * 关键点（中文）
+     * - Agent 只负责用这个类创建/恢复 session，不感知具体 Composer 策略。
+     * - 如果需要自定义 Composer，请在自定义 Session 类内部传给 `super({ composers })`。
+     * - 该能力仅适用于本地 `Agent`。
+     */
+    Session?: AgentSessionConstructor;
     /**
      * 当前 agent 的显式环境变量覆盖项。
      *

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

@@ -1 +1 @@
-{"version":3,"file":"AgentOptions.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentOptions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE7B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IAEvB;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,KAAK,GAAG,oBAAoB,CAAC;IAEnC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,yBAAyB;IACzB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,8BAA8B;IAC9B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,MAAM,EAAE,iBAAiB,CAAC;CAC3B"}
+{"version":3,"file":"AgentOptions.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentOptions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,mCAAmC,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,KACpC,OAAO,EAAE,cAAc,KACpB,mBAAmB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE7B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IAEvB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAElC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,KAAK,GAAG,oBAAoB,CAAC;IAEnC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,yBAAyB;IACzB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,8BAA8B;IAC9B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,MAAM,EAAE,iBAAiB,CAAC;CAC3B"}

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

@@ -7,7 +7,9 @@
  * - 这里不承载具体字段定义，避免单文件继续膨胀。
  */
 export type { AgentModel } from "../../model/CityModelAdapter.js";
-export type { AgentOptions, AgentRpcBinding, AgentRpcStartOptions, AgentStartOptions, AgentStartResult, AgentStopResult, } from "../../types/agent/AgentOptions.js";
+export type { SessionComposerFactoryContext, SessionComposerInput, SessionComposerOptions, } from "../../types/session/SessionComposerOptions.js";
+export type { AgentManagedSession, SessionOptions, } from "../../types/session/SessionOptions.js";
+export type { AgentOptions, AgentRpcBinding, AgentRpcStartOptions, AgentSessionConstructor, AgentStartOptions, AgentStartResult, AgentStopResult, } from "../../types/agent/AgentOptions.js";
 export type { RemoteAgentOptions } from "../../types/agent/RemoteAgentOptions.js";
 export type { AgentCreateSessionInput, AgentListSessionsInput, AgentSessionConfigSnapshot, AgentSessionForkInput, AgentSessionHistoryInput, AgentSessionHistoryPage, AgentSessionHistoryView, AgentSessionInfo, AgentSessionSetInput, AgentSessionSummary, AgentSessionSummaryPage, AgentSessionSystemBlock, AgentSessionSystemBlockSource, AgentSessionSystemSessionInfo, AgentSessionSystemSnapshot, AgentSessionTimelineEvent, } from "../../types/agent/SessionTypes.js";
 export type { AgentSession, AgentSessionActor, AgentSessionCollection, RemoteAgentSession, } from "../../types/agent/SessionActor.js";

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

@@ -1 +1 @@
-{"version":3,"file":"AgentTypes.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EACV,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"AgentTypes.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EACV,6BAA6B,EAC7B,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,2CAA2C,CAAC;AACnD,YAAY,EACV,mBAAmB,EACnB,cAAc,GACf,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EACV,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC"}

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

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

package/bin/types/executor/SessionRunContext.d.ts

@@ -0,0 +1,66 @@
+/**
+ * SessionRunContext：单次 session run 的显式运行上下文。
+ *
+ * 关键点（中文）
+ * - 这里承载本轮执行过程中需要在多个组件间透传的运行期数据。
+ * - 业务侧上下文优先通过该对象显式传递，避免分散读取隐式全局状态。
+ * - tool 深层回调等无法直接传参的场景，才通过 run scope 间接读取这个对象。
+ */
+import type { SessionAssistantStepCallback, SessionUiMessageChunkCallback } from "../../executor/types/SessionRun.js";
+import type { SessionUserMessageV1 } from "../../executor/types/SessionMessages.js";
+import type { FileUIPart } from "ai";
+/**
+ * 单次 session run 的运行上下文。
+ */
+export interface SessionRunContext {
+    /**
+     * 当前执行所属的 session 标识。
+     */
+    sessionId: string;
+    /**
+     * step 边界合并回调。
+     *
+     * 关键点（中文）
+     * - 由 Session actor 在 turn 运行期间注入。
+     * - 用于把运行中追加的 user 消息并入下一 step。
+     */
+    onStepCallback?: () => Promise<SessionUserMessageV1[]>;
+    /**
+     * assistant step 完成回调。
+     *
+     * 关键点（中文）
+     * - 用于把中间 step 文本或 reasoning 事件回传给 Session 事件流。
+     */
+    onAssistantStepCallback?: SessionAssistantStepCallback;
+    /**
+     * UI stream chunk 回调。
+     *
+     * 关键点（中文）
+     * - 用于把底层模型 UI chunk 旁路输出到订阅流或 transport。
+     */
+    onUiMessageChunkCallback?: SessionUiMessageChunkCallback;
+    /**
+     * 本轮运行中待并入下一 step 的 user 消息。
+     *
+     * 关键点（中文）
+     * - 主要由 tool runtime 在当前 turn 内动态注入。
+     * - 这些消息只影响当前执行，不会自动持久化。
+     */
+    injectedUserMessages: SessionUserMessageV1[];
+    /**
+     * 本轮运行结束后待写入长期历史的 user 消息。
+     *
+     * 关键点（中文）
+     * - 为保证时间线顺序稳定，这些消息会在 assistant 结果落盘之后统一持久化。
+     */
+    deferredPersistedUserMessages: SessionUserMessageV1[];
+    /**
+     * 本轮运行结束前待并入最终 assistant 消息的 file parts。
+     *
+     * 关键点（中文）
+     * - 用于 tool/plugin 在执行期产生图片、文件等最终输出。
+     * - 这些 part 不依赖模型把 tool result 再复述一遍，直接落入 assistant UIMessage。
+     */
+    pendingAssistantFileParts: FileUIPart[];
+}
+//# sourceMappingURL=SessionRunContext.d.ts.map

package/bin/types/executor/SessionRunContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionRunContext.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionRunContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAEvD;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,4BAA4B,CAAC;IAEvD;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,6BAA6B,CAAC;IAEzD;;;;;;OAMG;IACH,oBAAoB,EAAE,oBAAoB,EAAE,CAAC;IAE7C;;;;;OAKG;IACH,6BAA6B,EAAE,oBAAoB,EAAE,CAAC;IAEtD;;;;;;OAMG;IACH,yBAAyB,EAAE,UAAU,EAAE,CAAC;CACzC"}

package/bin/types/executor/SessionRunContext.js

@@ -0,0 +1,10 @@
+/**
+ * SessionRunContext：单次 session run 的显式运行上下文。
+ *
+ * 关键点（中文）
+ * - 这里承载本轮执行过程中需要在多个组件间透传的运行期数据。
+ * - 业务侧上下文优先通过该对象显式传递，避免分散读取隐式全局状态。
+ * - tool 深层回调等无法直接传参的场景，才通过 run scope 间接读取这个对象。
+ */
+export {};
+//# sourceMappingURL=SessionRunContext.js.map

package/bin/types/executor/SessionRunContext.js.map

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