@downcity/agent 1.1.10 → 1.1.12

package/bin/{host/sdk → sdk}/Session.js

@@ -7,16 +7,18 @@
  * - 内部继续复用现有 `Session` / `JsonlSessionHistoryComposer` / `LocalSessionExecutor`。
  */
 import { nanoid } from "nanoid";
-import { Session as CoreSession } from "../../session/Session.js";
-import { JsonlSessionHistoryComposer } from "../../session/composer/history/jsonl/JsonlSessionHistoryComposer.js";
-import { JsonlSessionCompactionComposer } from "../../session/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
-import { LocalSessionExecutor } from "../../session/executors/local/LocalSessionExecutor.js";
-import { resolveAssistantMessageForPersistence } from "../../service/builtins/chat/runtime/UserVisibleText.js";
-import { extractTextFromUiMessage } from "../../service/builtins/chat/runtime/UIMessageTransformer.js";
-import { SdkSessionSystemComposer } from "../../host/sdk/SdkSessionSystemComposer.js";
-import { inferModelLabel, patchSdkSessionModelLabel, readSdkSessionMetadata, writeSdkSessionMetadata, } from "../../host/sdk/SessionMetadata.js";
-import { getSdkAgentSessionArchiveDirPath, getSdkAgentSessionDirPath, } from "../../host/sdk/Paths.js";
-import { AsyncQueue } from "../../host/sdk/AsyncQueue.js";
+import { Session as CoreSession } from "../session/Session.js";
+import { JsonlSessionHistoryComposer } from "../session/composer/history/jsonl/JsonlSessionHistoryComposer.js";
+import { JsonlSessionCompactionComposer } from "../session/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
+import { LocalSessionExecutor } from "../session/executors/local/LocalSessionExecutor.js";
+import { extractTextFromUiMessage } from "../service/builtins/chat/runtime/UIMessageTransformer.js";
+import { resolveSdkSessionSystemBlocks, SdkSessionSystemComposer, } from "../sdk/SdkSessionSystemComposer.js";
+import { inferModelLabel, patchSdkSessionModelLabel, readSdkSessionMetadata, resolveSystemTimezone, writeSdkSessionMetadata, } from "../sdk/SessionMetadata.js";
+import { getSdkAgentSessionArchiveDirPath, getSdkAgentSessionDirPath, } from "../sdk/Paths.js";
+import { AsyncQueue } from "../sdk/AsyncQueue.js";
+import { pushUiMessageChunkAsSdkEvent } from "../sdk/StreamEvents.js";
+import { persistSdkAssistantResult, touchSdkSessionMetadata, } from "../sdk/SessionPersistence.js";
+import { createSdkSessionServicePort } from "../sdk/SessionServicePort.js";
 /**
  * SDK 本地 Session。
  */
@@ -26,12 +28,14 @@ export class SdkSession {
     projectRoot;
     tools;
     logger;
-    getStaticSystemPrompts;
-    getServiceSystemPrompts;
-    getPluginSystemPrompts;
+    getInstructionSystemBlocks;
+    getServiceSystemBlocks;
+    getPluginSystemBlocks;
     historyComposer;
     coreSession;
     sessionConfig = {};
+    createdAt = Date.now();
+    timezone = resolveSystemTimezone();
     initializePromise = null;
     servicePort = null;
     constructor(options) {
@@ -40,9 +44,9 @@ export class SdkSession {
         this.projectRoot = String(options.projectRoot || "").trim();
         this.tools = options.tools;
         this.logger = options.logger;
-        this.getStaticSystemPrompts = options.getStaticSystemPrompts;
-        this.getServiceSystemPrompts = options.getServiceSystemPrompts;
-        this.getPluginSystemPrompts = options.getPluginSystemPrompts;
+        this.getInstructionSystemBlocks = options.getInstructionSystemBlocks;
+        this.getServiceSystemBlocks = options.getServiceSystemBlocks;
+        this.getPluginSystemBlocks = options.getPluginSystemBlocks;
         if (!this.id) {
             throw new Error("SdkSession requires a non-empty sessionId");
         }
@@ -79,10 +83,13 @@ export class SdkSession {
                     historyComposer,
                     compactionComposer: new JsonlSessionCompactionComposer(),
                     systemComposer: new SdkSessionSystemComposer({
+                        agentId: this.agentId,
                         projectRoot: this.projectRoot,
-                        getStaticSystemPrompts: this.getStaticSystemPrompts,
-                        getServiceSystemPrompts: this.getServiceSystemPrompts,
-                        getPluginSystemPrompts: this.getPluginSystemPrompts,
+                        getSessionCreatedAt: () => this.createdAt,
+                        getSessionTimezone: () => this.timezone,
+                        getInstructionSystemBlocks: this.getInstructionSystemBlocks,
+                        getServiceSystemBlocks: this.getServiceSystemBlocks,
+                        getPluginSystemBlocks: this.getPluginSystemBlocks,
                     }),
                     getTools: () => this.tools,
                 });
@@ -102,6 +109,10 @@ export class SdkSession {
                 agentId: this.agentId,
                 sessionId: this.id,
             });
+            const createdAt = typeof metadata.createdAt === "number" ? metadata.createdAt : Date.now();
+            const timezone = typeof metadata.timezone === "string" && metadata.timezone.trim()
+                ? metadata.timezone.trim()
+                : resolveSystemTimezone();
             await writeSdkSessionMetadata({
                 projectRoot: this.projectRoot,
                 agentId: this.agentId,
@@ -109,9 +120,12 @@ export class SdkSession {
                 meta: {
                     ...metadata,
                     agentId: this.agentId,
-                    createdAt: typeof metadata.createdAt === "number" ? metadata.createdAt : Date.now(),
+                    createdAt,
+                    timezone,
                 },
             });
+            this.createdAt = createdAt;
+            this.timezone = timezone;
             this.sessionConfig = {
                 ...(metadata.sdkConfig?.modelLabel
                     ? { modelLabel: metadata.sdkConfig.modelLabel }
@@ -169,6 +183,37 @@ export class SdkSession {
     async history() {
         return await this.historyComposer.list();
     }
+    /**
+     * 读取当前 session 生效的 system prompt 文本集合。
+     *
+     * 关键点（中文）
+     * - 返回内容与实际 run 时使用的 SDK system composer 同源。
+     * - 包含 instruction/core、显式注入 service system、显式注册 plugin system 与 session 上下文。
+     * - 返回结构化快照，不把 system prompt 写入会话历史。
+     */
+    async system() {
+        const blocks = await resolveSdkSessionSystemBlocks({
+            agentId: this.agentId,
+            projectRoot: this.projectRoot,
+            sessionId: this.id,
+            createdAt: this.createdAt,
+            timezone: this.timezone,
+            getInstructionSystemBlocks: this.getInstructionSystemBlocks,
+            getServiceSystemBlocks: this.getServiceSystemBlocks,
+            getPluginSystemBlocks: this.getPluginSystemBlocks,
+        });
+        return {
+            sessionId: this.id,
+            session: {
+                agentId: this.agentId,
+                sessionId: this.id,
+                projectRoot: this.projectRoot,
+                createdAt: new Date(this.createdAt).toISOString(),
+                timezone: this.timezone,
+            },
+            blocks,
+        };
+    }
     /**
      * 返回当前 session 是否正在执行。
      */
@@ -217,7 +262,11 @@ export class SdkSession {
                 const result = await this.coreSession.run({
                     query,
                     onUiMessageChunkCallback: async (chunk) => {
-                        this.pushChunkEvent(queue, chunk, toolNameByCallId);
+                        pushUiMessageChunkAsSdkEvent({
+                            queue,
+                            chunk,
+                            toolNameByCallId,
+                        });
                     },
                 });
                 await this.persistAssistantResult(result.assistantMessage);
@@ -258,9 +307,9 @@ export class SdkSession {
             sessionId: `fork-${Date.now()}-${nanoid(8)}`,
             tools: this.tools,
             logger: this.logger,
-            getStaticSystemPrompts: this.getStaticSystemPrompts,
-            getServiceSystemPrompts: this.getServiceSystemPrompts,
-            getPluginSystemPrompts: this.getPluginSystemPrompts,
+            getInstructionSystemBlocks: this.getInstructionSystemBlocks,
+            getServiceSystemBlocks: this.getServiceSystemBlocks,
+            getPluginSystemBlocks: this.getPluginSystemBlocks,
         });
         await forked.initialize();
         if (this.sessionConfig.model) {
@@ -295,165 +344,37 @@ export class SdkSession {
     }
     /**
      * 返回供 chat service 使用的 session 端口。
-     *
-     * 关键点（中文）
-     * - 这里不走 SDK `run()` 包装层，而是直接暴露底层 `CoreSession` 协议。
-     * - 这样 chat queue worker 可以复用既有 `SessionPort` 契约，不会重复补写消息。
      */
     getServicePort() {
         if (this.servicePort)
             return this.servicePort;
-        this.servicePort = {
+        this.servicePort = createSdkSessionServicePort({
             sessionId: this.id,
-            getExecutor: () => this.coreSession.getExecutor(),
-            getHistoryComposer: () => this.historyComposer,
-            run: async (params) => {
-                return await this.coreSession.run(params);
-            },
-            clearExecutor: () => {
-                this.coreSession.clearExecutor();
-            },
-            afterSessionUpdatedAsync: async () => {
-                await this.coreSession.afterSessionUpdatedAsync();
-            },
-            appendUserMessage: async (params) => {
-                await this.coreSession.appendUserMessage(params);
-                await this.touchMetadata();
-            },
-            appendAssistantMessage: async (params) => {
-                await this.coreSession.appendAssistantMessage(params);
+            coreSession: this.coreSession,
+            historyComposer: this.historyComposer,
+            touchMetadata: async () => {
                 await this.touchMetadata();
             },
-            isExecuting: () => this.coreSession.isExecuting(),
-        };
+        });
         return this.servicePort;
     }
     async touchMetadata() {
-        const current = await readSdkSessionMetadata({
+        await touchSdkSessionMetadata({
             projectRoot: this.projectRoot,
             agentId: this.agentId,
             sessionId: this.id,
+            sessionConfig: this.sessionConfig,
         });
-        const next = {
-            ...current,
-            agentId: this.agentId,
-            createdAt: typeof current.createdAt === "number" ? current.createdAt : Date.now(),
-            updatedAt: Date.now(),
-            ...(this.sessionConfig.modelLabel
-                ? {
-                    sdkConfig: {
-                        ...(current.sdkConfig || {}),
-                        modelLabel: this.sessionConfig.modelLabel,
-                    },
-                }
-                : {}),
-        };
-        await writeSdkSessionMetadata({
+    }
+    async persistAssistantResult(assistantMessage) {
+        await persistSdkAssistantResult({
             projectRoot: this.projectRoot,
             agentId: this.agentId,
             sessionId: this.id,
-            meta: next,
+            sessionConfig: this.sessionConfig,
+            coreSession: this.coreSession,
+            assistantMessage,
         });
     }
-    async persistAssistantResult(assistantMessage) {
-        const persisted = resolveAssistantMessageForPersistence(assistantMessage);
-        await this.coreSession.appendAssistantMessage({
-            ...(persisted ? { message: persisted } : {}),
-            fallbackText: extractTextFromUiMessage(assistantMessage),
-        });
-        await this.touchMetadata();
-    }
-    pushChunkEvent(queue, chunk, toolNameByCallId) {
-        switch (chunk.type) {
-            case "text-delta":
-                queue.push({
-                    type: "text-delta",
-                    text: chunk.delta,
-                });
-                return;
-            case "reasoning-delta":
-                queue.push({
-                    type: "reasoning-delta",
-                    text: chunk.delta,
-                });
-                return;
-            case "tool-input-start":
-                toolNameByCallId.set(chunk.toolCallId, chunk.toolName);
-                return;
-            case "tool-input-available":
-                toolNameByCallId.set(chunk.toolCallId, chunk.toolName);
-                queue.push({
-                    type: "tool-call",
-                    toolCallId: chunk.toolCallId,
-                    toolName: chunk.toolName,
-                    args: this.toJsonValue(chunk.input),
-                });
-                return;
-            case "tool-output-available":
-                queue.push({
-                    type: "tool-result",
-                    toolCallId: chunk.toolCallId,
-                    toolName: toolNameByCallId.get(chunk.toolCallId) || "unknown",
-                    result: this.toJsonValue(chunk.output),
-                });
-                return;
-            case "tool-output-error":
-                queue.push({
-                    type: "tool-error",
-                    toolCallId: chunk.toolCallId,
-                    toolName: toolNameByCallId.get(chunk.toolCallId) || "unknown",
-                    error: chunk.errorText,
-                });
-                return;
-            case "tool-input-error":
-                toolNameByCallId.set(chunk.toolCallId, chunk.toolName);
-                queue.push({
-                    type: "tool-error",
-                    toolCallId: chunk.toolCallId,
-                    toolName: chunk.toolName,
-                    error: chunk.errorText,
-                });
-                return;
-            case "error":
-                queue.push({
-                    type: "error",
-                    error: chunk.errorText,
-                });
-                return;
-            case "abort":
-                queue.push({
-                    type: "error",
-                    error: String(chunk.reason || "stream aborted"),
-                });
-                return;
-            case "finish":
-                queue.push({
-                    type: "finish",
-                    ...(typeof chunk.finishReason === "string"
-                        ? { finishReason: chunk.finishReason }
-                        : {}),
-                });
-                return;
-            default:
-                return;
-        }
-    }
-    toJsonValue(value) {
-        if (value === undefined)
-            return null;
-        if (value === null)
-            return null;
-        if (typeof value === "string" ||
-            typeof value === "number" ||
-            typeof value === "boolean") {
-            return value;
-        }
-        try {
-            return JSON.parse(JSON.stringify(value));
-        }
-        catch {
-            return String(value);
-        }
-    }
 }
 //# sourceMappingURL=Session.js.map

package/bin/sdk/Session.js.map

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

package/bin/{host/sdk → sdk}/SessionMetadata.d.ts

@@ -6,7 +6,7 @@
  * - 仅处理轻量配置摘要与索引信息，不负责消息 JSONL 的读写。
  */
 import type { LanguageModel } from "ai";
-import type { SessionHistoryMetaV1 } from "../../session/types/SessionHistoryMeta.js";
+import type { SessionHistoryMetaV1 } from "../session/types/SessionHistoryMeta.js";
 type ReadSessionMetadataInput = {
     /**
      * 项目根目录。
@@ -21,6 +21,10 @@ type ReadSessionMetadataInput = {
      */
     sessionId: string;
 };
+/**
+ * 读取当前系统时区。
+ */
+export declare function resolveSystemTimezone(): string;
 /**
  * 从模型实例推导轻量可读标签。
  */

package/bin/sdk/SessionMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMetadata.d.ts","sourceRoot":"","sources":["../../src/sdk/SessionMetadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,uCAAuC,CAAC;AAG/C,KAAK,wBAAwB,GAAG;IAC9B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAOF;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAK9C;AAOD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,GAAG,SAAS,GAC/B,MAAM,GAAG,SAAS,CAmBpB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAuD/B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,wBAAwB,GAAG;IAChC;;OAEG;IACH,IAAI,EAAE,oBAAoB,CAAC;CAC5B,GACA,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,wBAAwB,GAAG;IAChC;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,GACA,OAAO,CAAC,oBAAoB,CAAC,CAwB/B"}

package/bin/{host/sdk → sdk}/SessionMetadata.js

@@ -6,11 +6,24 @@
  * - 仅处理轻量配置摘要与索引信息，不负责消息 JSONL 的读写。
  */
 import fs from "fs-extra";
-import { getSdkAgentSessionMetaPath } from "../../host/sdk/Paths.js";
+import { getSdkAgentSessionMetaPath } from "../sdk/Paths.js";
 function normalizeModelLabel(input) {
     const label = typeof input === "string" ? input.trim() : "";
     return label || undefined;
 }
+/**
+ * 读取当前系统时区。
+ */
+export function resolveSystemTimezone() {
+    const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    return typeof timezone === "string" && timezone.trim()
+        ? timezone.trim()
+        : "UTC";
+}
+function normalizeTimezone(input) {
+    const timezone = typeof input === "string" ? input.trim() : "";
+    return timezone || undefined;
+}
 /**
  * 从模型实例推导轻量可读标签。
  */
@@ -49,6 +62,7 @@ export async function readSdkSessionMetadata(input) {
             createdAt: typeof raw.createdAt === "number" && Number.isFinite(raw.createdAt)
                 ? raw.createdAt
                 : Date.now(),
+            timezone: normalizeTimezone(raw.timezone) || resolveSystemTimezone(),
             updatedAt: typeof raw.updatedAt === "number" && Number.isFinite(raw.updatedAt)
                 ? raw.updatedAt
                 : 0,
@@ -82,6 +96,7 @@ export async function readSdkSessionMetadata(input) {
             sessionId: input.sessionId,
             agentId: input.agentId,
             createdAt: Date.now(),
+            timezone: resolveSystemTimezone(),
             updatedAt: 0,
             pinnedSkillIds: [],
         };
@@ -105,6 +120,7 @@ export async function patchSdkSessionModelLabel(input) {
         ...current,
         agentId: input.agentId,
         createdAt: typeof current.createdAt === "number" ? current.createdAt : Date.now(),
+        timezone: normalizeTimezone(current.timezone) || resolveSystemTimezone(),
         updatedAt: Date.now(),
         ...(modelLabel
             ? {

package/bin/sdk/SessionMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMetadata.js","sourceRoot":"","sources":["../../src/sdk/SessionMetadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAM1B,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAmB5D,SAAS,mBAAmB,CAAC,KAAc;IACzC,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,OAAO,KAAK,IAAI,SAAS,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC;IAClE,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE;QACpD,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE;QACjB,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,OAAO,QAAQ,IAAI,SAAS,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAgC;IAEhC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,UAAU,GAAG;QACjB,MAAM,CAAC,OAAO;QACd,MAAM,CAAC,KAAK;QACZ,MAAM,CAAC,EAAE;QACT,MAAM,CAAC,IAAI;QACX,MAAM,CAAC,KAAK;KACb,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IACD,MAAM,eAAe,GACnB,KAAK,CAAC,WAAW,IAAI,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,QAAQ;QAC7D,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE;QAC/B,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,eAAe,IAAI,kBAAkB,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAA+B;IAE/B,MAAM,QAAQ,GAAG,0BAA0B,CACzC,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,SAAS,CAChB,CAAC;IACF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAkC,CAAC;QAC3E,OAAO;YACL,CAAC,EAAE,CAAC;YACJ,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EACP,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;gBACjE,CAAC,CAAC,GAAG,CAAC,SAAS;gBACf,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAChB,QAAQ,EAAE,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,qBAAqB,EAAE;YACpE,SAAS,EACP,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;gBACjE,CAAC,CAAC,GAAG,CAAC,SAAS;gBACf,CAAC,CAAC,CAAC;YACP,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;gBAC/C,CAAC,CAAC,GAAG,CAAC,cAAc;qBACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;qBAC5D,MAAM,CAAC,OAAO,CAAC;gBACpB,CAAC,CAAC,EAAE;YACN,GAAG,CAAC,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,IAAI,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE;gBACnE,CAAC,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE;gBAC7C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,GAAG,CAAC,gBAAgB,KAAK,QAAQ;gBAC5C,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC;gBACnC,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,EAAE;gBAC5C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,GAAG,CAAC,oBAAoB,KAAK,QAAQ;gBAChD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAC;gBACvC,CAAC,CAAC,EAAE,oBAAoB,EAAE,GAAG,CAAC,oBAAoB,EAAE;gBACpD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC;gBAC3E,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE;gBACpC,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;gBACpD,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAsC,EAAE;gBAC3D,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,CAAC,EAAE,CAAC;YACJ,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,QAAQ,EAAE,qBAAqB,EAAE;YACjC,SAAS,EAAE,CAAC;YACZ,cAAc,EAAE,EAAE;SACnB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAKC;IAED,MAAM,QAAQ,GAAG,0BAA0B,CACzC,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,SAAS,CAChB,CAAC;IACF,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAKC;IAED,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,IAAI,GAAyB;QACjC,GAAG,OAAO;QACV,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EACP,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;QACxE,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,qBAAqB,EAAE;QACxE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,GAAG,CAAC,UAAU;YACZ,CAAC,CAAC;gBACE,SAAS,EAAE;oBACT,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;oBAC5B,UAAU;iBACX;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,MAAM,uBAAuB,CAAC;QAC5B,GAAG,KAAK;QACR,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/bin/sdk/SessionPersistence.d.ts

@@ -0,0 +1,63 @@
+/**
+ * SDK Session 持久化辅助。
+ *
+ * 关键点（中文）
+ * - 集中处理 session meta 更新时间、模型展示标签与 assistant 消息落盘。
+ * - `SdkSession` 只负责调用这些能力，不直接拼装 meta 结构。
+ */
+import type { SessionMessageV1 } from "../session/types/SessionMessages.js";
+import type { AgentSessionConfigSnapshot } from "../sdk/AgentSdkTypes.js";
+/**
+ * SDK Session 元数据写入参数。
+ */
+export interface TouchSdkSessionMetadataParams {
+    /**
+     * 当前项目根目录。
+     */
+    projectRoot: string;
+    /**
+     * 当前 agent 稳定标识。
+     */
+    agentId: string;
+    /**
+     * 当前 sessionId。
+     */
+    sessionId: string;
+    /**
+     * 当前 session 内存配置快照。
+     */
+    sessionConfig: AgentSessionConfigSnapshot;
+}
+/**
+ * Assistant 结果落盘参数。
+ */
+export interface PersistSdkAssistantResultParams extends TouchSdkSessionMetadataParams {
+    /**
+     * 追加 assistant 消息的底层 session 端口。
+     */
+    coreSession: {
+        appendAssistantMessage(params: {
+            /**
+             * 已构造好的完整消息。
+             */
+            message?: SessionMessageV1 | null;
+            /**
+             * 兜底文本内容。
+             */
+            fallbackText?: string;
+        }): Promise<void>;
+    };
+    /**
+     * 本轮执行得到的 assistant 消息。
+     */
+    assistantMessage: SessionMessageV1;
+}
+/**
+ * 刷新 SDK session 元数据。
+ */
+export declare function touchSdkSessionMetadata(params: TouchSdkSessionMetadataParams): Promise<void>;
+/**
+ * 持久化 assistant 结果并同步刷新 session meta。
+ */
+export declare function persistSdkAssistantResult(params: PersistSdkAssistantResultParams): Promise<void>;
+//# sourceMappingURL=SessionPersistence.d.ts.map

package/bin/sdk/SessionPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionPersistence.d.ts","sourceRoot":"","sources":["../../src/sdk/SessionPersistence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAMzE;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;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;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,+BACf,SAAQ,6BAA6B;IACrC;;OAEG;IACH,WAAW,EAAE;QACX,sBAAsB,CAAC,MAAM,EAAE;YAC7B;;eAEG;YACH,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;YAClC;;eAEG;YACH,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnB,CAAC;IACF;;OAEG;IACH,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,6BAA6B,GACpC,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,+BAA+B,GACtC,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/bin/sdk/SessionPersistence.js

@@ -0,0 +1,52 @@
+/**
+ * SDK Session 持久化辅助。
+ *
+ * 关键点（中文）
+ * - 集中处理 session meta 更新时间、模型展示标签与 assistant 消息落盘。
+ * - `SdkSession` 只负责调用这些能力，不直接拼装 meta 结构。
+ */
+import { resolveAssistantMessageForPersistence } from "../service/builtins/chat/runtime/UserVisibleText.js";
+import { extractTextFromUiMessage } from "../service/builtins/chat/runtime/UIMessageTransformer.js";
+import { readSdkSessionMetadata, writeSdkSessionMetadata, } from "../sdk/SessionMetadata.js";
+/**
+ * 刷新 SDK session 元数据。
+ */
+export async function touchSdkSessionMetadata(params) {
+    const current = await readSdkSessionMetadata({
+        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
+            ? {
+                sdkConfig: {
+                    ...(current.sdkConfig || {}),
+                    modelLabel: params.sessionConfig.modelLabel,
+                },
+            }
+            : {}),
+    };
+    await writeSdkSessionMetadata({
+        projectRoot: params.projectRoot,
+        agentId: params.agentId,
+        sessionId: params.sessionId,
+        meta: next,
+    });
+}
+/**
+ * 持久化 assistant 结果并同步刷新 session meta。
+ */
+export async function persistSdkAssistantResult(params) {
+    const persisted = resolveAssistantMessageForPersistence(params.assistantMessage);
+    await params.coreSession.appendAssistantMessage({
+        ...(persisted ? { message: persisted } : {}),
+        fallbackText: extractTextFromUiMessage(params.assistantMessage),
+    });
+    await touchSdkSessionMetadata(params);
+}
+//# sourceMappingURL=SessionPersistence.js.map

package/bin/sdk/SessionPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionPersistence.js","sourceRoot":"","sources":["../../src/sdk/SessionPersistence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,qCAAqC,EAAE,MAAM,oDAAoD,CAAC;AAC3G,OAAO,EAAE,wBAAwB,EAAE,MAAM,yDAAyD,CAAC;AAInG,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAkDlC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAqC;IAErC,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC;QAC3C,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,SAAS,EAAE;oBACT,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;oBAC5B,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,UAAU;iBAC5C;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,MAAM,uBAAuB,CAAC;QAC5B,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,SAAS,GAAG,qCAAqC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACjF,MAAM,MAAM,CAAC,WAAW,CAAC,sBAAsB,CAAC;QAC9C,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,YAAY,EAAE,wBAAwB,CAAC,MAAM,CAAC,gBAAgB,CAAC;KAChE,CAAC,CAAC;IACH,MAAM,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/bin/sdk/SessionServicePort.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SDK Session service 端口构造器。
+ *
+ * 关键点（中文）
+ * - 把 SDK 本地 session 适配成 chat service 依赖的 `SessionPort`。
+ * - service 侧直接复用底层 `CoreSession` 协议，避免 SDK `run()` 包装层重复补写消息。
+ */
+import type { SessionPort } from "../runtime/AgentContextTypes.js";
+/**
+ * 构造 SDK SessionPort 的参数。
+ */
+export interface CreateSdkSessionServicePortParams {
+    /**
+     * 当前 sessionId。
+     */
+    sessionId: string;
+    /**
+     * 底层 session 实例。
+     */
+    coreSession: Omit<SessionPort, "sessionId" | "getHistoryComposer">;
+    /**
+     * 当前 session 历史持久化端口。
+     */
+    historyComposer: ReturnType<SessionPort["getHistoryComposer"]>;
+    /**
+     * session 更新后需要同步执行的持久化回调。
+     */
+    touchMetadata: () => Promise<void>;
+}
+/**
+ * 创建供 service 使用的 session 端口。
+ */
+export declare function createSdkSessionServicePort(params: CreateSdkSessionServicePortParams): SessionPort;
+//# sourceMappingURL=SessionServicePort.d.ts.map

package/bin/sdk/SessionServicePort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionServicePort.d.ts","sourceRoot":"","sources":["../../src/sdk/SessionServicePort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,oBAAoB,CAAC,CAAC;IACnE;;OAEG;IACH,eAAe,EAAE,UAAU,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC/D;;OAEG;IACH,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,iCAAiC,GACxC,WAAW,CAwBb"}

package/bin/sdk/SessionServicePort.js

@@ -0,0 +1,36 @@
+/**
+ * SDK Session service 端口构造器。
+ *
+ * 关键点（中文）
+ * - 把 SDK 本地 session 适配成 chat service 依赖的 `SessionPort`。
+ * - service 侧直接复用底层 `CoreSession` 协议，避免 SDK `run()` 包装层重复补写消息。
+ */
+/**
+ * 创建供 service 使用的 session 端口。
+ */
+export function createSdkSessionServicePort(params) {
+    return {
+        sessionId: params.sessionId,
+        getExecutor: () => params.coreSession.getExecutor(),
+        getHistoryComposer: () => params.historyComposer,
+        run: async (runParams) => {
+            return await params.coreSession.run(runParams);
+        },
+        clearExecutor: () => {
+            params.coreSession.clearExecutor();
+        },
+        afterSessionUpdatedAsync: async () => {
+            await params.coreSession.afterSessionUpdatedAsync();
+        },
+        appendUserMessage: async (messageParams) => {
+            await params.coreSession.appendUserMessage(messageParams);
+            await params.touchMetadata();
+        },
+        appendAssistantMessage: async (messageParams) => {
+            await params.coreSession.appendAssistantMessage(messageParams);
+            await params.touchMetadata();
+        },
+        isExecuting: () => params.coreSession.isExecuting(),
+    };
+}
+//# sourceMappingURL=SessionServicePort.js.map

package/bin/sdk/SessionServicePort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionServicePort.js","sourceRoot":"","sources":["../../src/sdk/SessionServicePort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0BH;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAyC;IAEzC,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE;QACnD,kBAAkB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe;QAChD,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YACvB,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,CAAC;QACD,aAAa,EAAE,GAAG,EAAE;YAClB,MAAM,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;QACrC,CAAC;QACD,wBAAwB,EAAE,KAAK,IAAI,EAAE;YACnC,MAAM,MAAM,CAAC,WAAW,CAAC,wBAAwB,EAAE,CAAC;QACtD,CAAC;QACD,iBAAiB,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;YACzC,MAAM,MAAM,CAAC,WAAW,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;YAC1D,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAC/B,CAAC;QACD,sBAAsB,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;YAC9C,MAAM,MAAM,CAAC,WAAW,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;YAC/D,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAC/B,CAAC;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE;KACpD,CAAC;AACJ,CAAC"}