@downcity/agent 1.1.8 → 1.1.11

package/bin/sdk/Session.js

@@ -0,0 +1,358 @@
+/**
+ * SDK 本地 Session 封装。
+ *
+ * 关键点（中文）
+ * - 面向 `new Agent(...)` 的本地会话使用场景。
+ * - 统一收口消息落盘、默认模型配置、run/stream/fork 等高层 API。
+ * - 内部继续复用现有 `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 { extractTextFromUiMessage } from "../service/builtins/chat/runtime/UIMessageTransformer.js";
+import { SdkSessionSystemComposer } from "../sdk/SdkSessionSystemComposer.js";
+import { resolveSdkSessionSystemMessages } from "../sdk/SdkSessionSystemComposer.js";
+import { inferModelLabel, patchSdkSessionModelLabel, readSdkSessionMetadata, 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。
+ */
+export class SdkSession {
+    id;
+    agentId;
+    projectRoot;
+    tools;
+    logger;
+    getStaticSystemPrompts;
+    getServiceSystemPrompts;
+    getPluginSystemPrompts;
+    historyComposer;
+    coreSession;
+    sessionConfig = {};
+    initializePromise = null;
+    servicePort = null;
+    constructor(options) {
+        this.id = String(options.sessionId || "").trim();
+        this.agentId = String(options.agentId || "").trim();
+        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;
+        if (!this.id) {
+            throw new Error("SdkSession requires a non-empty sessionId");
+        }
+        if (!this.agentId) {
+            throw new Error("SdkSession requires a non-empty agentId");
+        }
+        if (!this.projectRoot) {
+            throw new Error("SdkSession requires a non-empty projectRoot");
+        }
+        const sessionDirPath = getSdkAgentSessionDirPath(this.projectRoot, this.agentId, this.id);
+        const messagesDirPath = `${sessionDirPath}/messages`;
+        this.historyComposer = new JsonlSessionHistoryComposer({
+            rootPath: this.projectRoot,
+            sessionId: this.id,
+            paths: {
+                sessionDirPath,
+                messagesDirPath,
+                messagesFilePath: `${messagesDirPath}/messages.jsonl`,
+                metaFilePath: `${messagesDirPath}/meta.json`,
+                archiveDirPath: getSdkAgentSessionArchiveDirPath(this.projectRoot, this.agentId, this.id),
+            },
+        });
+        this.coreSession = new CoreSession({
+            sessionId: this.id,
+            historyComposer: this.historyComposer,
+            createExecutor: (historyComposer) => {
+                const model = this.sessionConfig.model;
+                if (!model) {
+                    throw new Error(`Session "${this.id}" has no model configured. Call session.set({ model }) first.`);
+                }
+                return new LocalSessionExecutor({
+                    model,
+                    logger: this.logger,
+                    historyComposer,
+                    compactionComposer: new JsonlSessionCompactionComposer(),
+                    systemComposer: new SdkSessionSystemComposer({
+                        projectRoot: this.projectRoot,
+                        getStaticSystemPrompts: this.getStaticSystemPrompts,
+                        getServiceSystemPrompts: this.getServiceSystemPrompts,
+                        getPluginSystemPrompts: this.getPluginSystemPrompts,
+                    }),
+                    getTools: () => this.tools,
+                });
+            },
+        });
+    }
+    /**
+     * 初始化当前 session 的 meta 信息与内存配置。
+     */
+    async initialize() {
+        if (this.initializePromise) {
+            return await this.initializePromise;
+        }
+        this.initializePromise = (async () => {
+            const metadata = await readSdkSessionMetadata({
+                projectRoot: this.projectRoot,
+                agentId: this.agentId,
+                sessionId: this.id,
+            });
+            await writeSdkSessionMetadata({
+                projectRoot: this.projectRoot,
+                agentId: this.agentId,
+                sessionId: this.id,
+                meta: {
+                    ...metadata,
+                    agentId: this.agentId,
+                    createdAt: typeof metadata.createdAt === "number" ? metadata.createdAt : Date.now(),
+                },
+            });
+            this.sessionConfig = {
+                ...(metadata.sdkConfig?.modelLabel
+                    ? { modelLabel: metadata.sdkConfig.modelLabel }
+                    : {}),
+            };
+            return this;
+        })();
+        return await this.initializePromise;
+    }
+    /**
+     * 读取当前 session 配置快照。
+     */
+    get config() {
+        return {
+            ...this.sessionConfig,
+        };
+    }
+    /**
+     * 写入当前 session 默认配置。
+     */
+    async set(input) {
+        if (input.model) {
+            this.sessionConfig.model = input.model;
+            this.sessionConfig.modelLabel = inferModelLabel(input.model);
+            this.coreSession.clearExecutor();
+        }
+        await patchSdkSessionModelLabel({
+            projectRoot: this.projectRoot,
+            agentId: this.agentId,
+            sessionId: this.id,
+            model: this.sessionConfig.model,
+        });
+    }
+    /**
+     * 追加一条 user 文本消息。
+     */
+    async appendUserMessage(input) {
+        await this.coreSession.appendUserMessage({
+            text: String(input.text || "").trim(),
+        });
+        await this.touchMetadata();
+    }
+    /**
+     * 追加一条 assistant 文本消息。
+     */
+    async appendAssistantMessage(input) {
+        await this.coreSession.appendAssistantMessage({
+            fallbackText: String(input.text || "").trim(),
+        });
+        await this.touchMetadata();
+    }
+    /**
+     * 读取完整消息历史。
+     */
+    async history() {
+        return await this.historyComposer.list();
+    }
+    /**
+     * 读取当前 session 生效的 system prompt 文本集合。
+     *
+     * 关键点（中文）
+     * - 返回内容与实际 run 时使用的 SDK system composer 同源。
+     * - 包含静态 system、显式注入 service system、显式注册 plugin system 与 runtime clock。
+     * - 这里只返回文本数组，不把 system prompt 写入会话历史。
+     */
+    async system() {
+        const messages = await resolveSdkSessionSystemMessages({
+            projectRoot: this.projectRoot,
+            sessionId: this.id,
+            getStaticSystemPrompts: this.getStaticSystemPrompts,
+            getServiceSystemPrompts: this.getServiceSystemPrompts,
+            getPluginSystemPrompts: this.getPluginSystemPrompts,
+        });
+        return messages
+            .map((message) => String(message.content || ""))
+            .filter((content) => content.trim().length > 0);
+    }
+    /**
+     * 返回当前 session 是否正在执行。
+     */
+    isExecuting() {
+        return this.coreSession.isExecuting();
+    }
+    /**
+     * 清理当前 session 的执行器缓存。
+     */
+    clearExecutor() {
+        this.coreSession.clearExecutor();
+    }
+    /**
+     * 执行一轮非流式请求。
+     */
+    async run(input) {
+        const query = String(input.query || "").trim();
+        if (!query) {
+            throw new Error("session.run requires a non-empty query");
+        }
+        await this.appendUserMessage({ text: query });
+        const result = await this.coreSession.run({
+            query,
+        });
+        await this.persistAssistantResult(result.assistantMessage);
+        return {
+            success: result.success,
+            ...(result.error ? { error: result.error } : {}),
+            text: extractTextFromUiMessage(result.assistantMessage),
+            assistantMessage: result.assistantMessage,
+        };
+    }
+    /**
+     * 执行一轮流式请求。
+     */
+    async *stream(input) {
+        const query = String(input.query || "").trim();
+        if (!query) {
+            throw new Error("session.stream requires a non-empty query");
+        }
+        const queue = new AsyncQueue();
+        const toolNameByCallId = new Map();
+        await this.appendUserMessage({ text: query });
+        const runPromise = (async () => {
+            try {
+                const result = await this.coreSession.run({
+                    query,
+                    onUiMessageChunkCallback: async (chunk) => {
+                        pushUiMessageChunkAsSdkEvent({
+                            queue,
+                            chunk,
+                            toolNameByCallId,
+                        });
+                    },
+                });
+                await this.persistAssistantResult(result.assistantMessage);
+            }
+            catch (error) {
+                queue.push({
+                    type: "error",
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            finally {
+                queue.close();
+            }
+        })();
+        for await (const event of queue) {
+            yield event;
+        }
+        await runPromise;
+    }
+    /**
+     * 从当前 session 创建一个分叉会话。
+     */
+    async fork(input) {
+        const messageId = String(input || "").trim() || undefined;
+        const messages = await this.historyComposer.list();
+        const forkMessages = !messageId
+            ? messages
+            : (() => {
+                const targetIndex = messages.findIndex((message) => String(message.id || "").trim() === messageId);
+                if (targetIndex < 0) {
+                    throw new Error(`Cannot fork session "${this.id}": messageId "${messageId}" not found.`);
+                }
+                return messages.slice(0, targetIndex + 1);
+            })();
+        const forked = new SdkSession({
+            agentId: this.agentId,
+            projectRoot: this.projectRoot,
+            sessionId: `fork-${Date.now()}-${nanoid(8)}`,
+            tools: this.tools,
+            logger: this.logger,
+            getStaticSystemPrompts: this.getStaticSystemPrompts,
+            getServiceSystemPrompts: this.getServiceSystemPrompts,
+            getPluginSystemPrompts: this.getPluginSystemPrompts,
+        });
+        await forked.initialize();
+        if (this.sessionConfig.model) {
+            await forked.set({
+                model: this.sessionConfig.model,
+            });
+        }
+        for (const message of forkMessages) {
+            await forked.historyComposer.append(message);
+        }
+        await forked.touchMetadata();
+        return forked;
+    }
+    /**
+     * 生成当前 session 的元数据快照。
+     */
+    async toMetadata() {
+        const meta = await readSdkSessionMetadata({
+            projectRoot: this.projectRoot,
+            agentId: this.agentId,
+            sessionId: this.id,
+        });
+        const messageCount = await this.historyComposer.size();
+        return {
+            agentId: this.agentId,
+            sessionId: this.id,
+            messageCount,
+            ...(typeof meta.createdAt === "number" ? { createdAt: meta.createdAt } : {}),
+            ...(typeof meta.updatedAt === "number" ? { updatedAt: meta.updatedAt } : {}),
+            ...(meta.sdkConfig?.modelLabel ? { modelLabel: meta.sdkConfig.modelLabel } : {}),
+        };
+    }
+    /**
+     * 返回供 chat service 使用的 session 端口。
+     */
+    getServicePort() {
+        if (this.servicePort)
+            return this.servicePort;
+        this.servicePort = createSdkSessionServicePort({
+            sessionId: this.id,
+            coreSession: this.coreSession,
+            historyComposer: this.historyComposer,
+            touchMetadata: async () => {
+                await this.touchMetadata();
+            },
+        });
+        return this.servicePort;
+    }
+    async touchMetadata() {
+        await touchSdkSessionMetadata({
+            projectRoot: this.projectRoot,
+            agentId: this.agentId,
+            sessionId: this.id,
+            sessionConfig: this.sessionConfig,
+        });
+    }
+    async persistAssistantResult(assistantMessage) {
+        await persistSdkAssistantResult({
+            projectRoot: this.projectRoot,
+            agentId: this.agentId,
+            sessionId: this.id,
+            sessionConfig: this.sessionConfig,
+            coreSession: this.coreSession,
+            assistantMessage,
+        });
+    }
+}
+//# 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":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gEAAgE,CAAC;AAC7G,OAAO,EAAE,8BAA8B,EAAE,MAAM,sEAAsE,CAAC;AACtH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yDAAyD,CAAC;AAWnG,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AA+C1E;;GAEG;AACH,MAAM,OAAO,UAAU;IACZ,EAAE,CAAS;IACX,OAAO,CAAS;IAER,WAAW,CAAS;IACpB,KAAK,CAAuB;IAC5B,MAAM,CAA8B;IACpC,sBAAsB,CAA8C;IACpE,uBAAuB,CAA+C;IACtE,sBAAsB,CAA8C;IACpE,eAAe,CAA8B;IAC7C,WAAW,CAAc;IAClC,aAAa,GAA+B,EAAE,CAAC;IAC/C,iBAAiB,GAAyB,IAAI,CAAC;IAC/C,WAAW,GAAuB,IAAI,CAAC;IAE/C,YAAY,OAA0B;QACpC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;QAC7D,IAAI,CAAC,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;QAC/D,IAAI,CAAC,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,cAAc,GAAG,yBAAyB,CAC9C,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,EAAE,CACR,CAAC;QACF,MAAM,eAAe,GAAG,GAAG,cAAc,WAAW,CAAC;QACrD,IAAI,CAAC,eAAe,GAAG,IAAI,2BAA2B,CAAC;YACrD,QAAQ,EAAE,IAAI,CAAC,WAAW;YAC1B,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,KAAK,EAAE;gBACL,cAAc;gBACd,eAAe;gBACf,gBAAgB,EAAE,GAAG,eAAe,iBAAiB;gBACrD,YAAY,EAAE,GAAG,eAAe,YAAY;gBAC5C,cAAc,EAAE,gCAAgC,CAC9C,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,EAAE,CACR;aACF;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC;YACjC,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,cAAc,EAAE,CAAC,eAAe,EAAE,EAAE;gBAClC,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;gBACvC,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,IAAI,KAAK,CACb,YAAY,IAAI,CAAC,EAAE,+DAA+D,CACnF,CAAC;gBACJ,CAAC;gBACD,OAAO,IAAI,oBAAoB,CAAC;oBAC9B,KAAK;oBACL,MAAM,EAAE,IAAI,CAAC,MAAe;oBAC5B,eAAe;oBACf,kBAAkB,EAAE,IAAI,8BAA8B,EAAE;oBACxD,cAAc,EAAE,IAAI,wBAAwB,CAAC;wBAC3C,WAAW,EAAE,IAAI,CAAC,WAAW;wBAC7B,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;wBACnD,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;wBACrD,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;qBACpD,CAAC;oBACF,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK;iBAC3B,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,iBAAiB,GAAG,CAAC,KAAK,IAAI,EAAE;YACnC,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC;gBAC5C,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,IAAI,CAAC,EAAE;aACnB,CAAC,CAAC;YACH,MAAM,uBAAuB,CAAC;gBAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,IAAI,CAAC,EAAE;gBAClB,IAAI,EAAE;oBACJ,GAAG,QAAQ;oBACX,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,SAAS,EACP,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;iBAC3E;aACF,CAAC,CAAC;YACH,IAAI,CAAC,aAAa,GAAG;gBACnB,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU;oBAChC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE;oBAC/C,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO;YACL,GAAG,IAAI,CAAC,aAAa;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,KAA2B;QACnC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,aAAa,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YACvC,IAAI,CAAC,aAAa,CAAC,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7D,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;QACnC,CAAC;QACD,MAAM,yBAAyB,CAAC;YAC9B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK;SAChC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAKvB;QACC,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC;YACvC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;SACtC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,sBAAsB,CAAC,KAK5B;QACC,MAAM,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC;YAC5C,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;SAC9C,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,QAAQ,GAAG,MAAM,+BAA+B,CAAC;YACrD,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;YACnD,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;YACrD,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;SACpD,CAAC,CAAC;QACH,OAAO,QAAQ;aACZ,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;aAC/C,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,KAA2B;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;YACxC,KAAK;SACN,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC3D,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,IAAI,EAAE,wBAAwB,CAAC,MAAM,CAAC,gBAAgB,CAAC;YACvD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;SAC1C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,CAAC,MAAM,CACX,KAA2B;QAE3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,UAAU,EAA2B,CAAC;QACxD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;QACnD,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAE9C,MAAM,UAAU,GAAG,CAAC,KAAK,IAAI,EAAE;YAC7B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;oBACxC,KAAK;oBACL,wBAAwB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;wBACxC,4BAA4B,CAAC;4BAC3B,KAAK;4BACL,KAAK;4BACL,gBAAgB;yBACjB,CAAC,CAAC;oBACL,CAAC;iBACF,CAAC,CAAC;gBACH,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC7D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CAAC,CAAC;YACL,CAAC;oBAAS,CAAC;gBACT,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAChC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,UAAU,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,KAA0C;QACnD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QACnD,MAAM,YAAY,GAChB,CAAC,SAAS;YACR,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,CAAC,GAAG,EAAE;gBACJ,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CACpC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,SAAS,CAC3D,CAAC;gBACF,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;oBACpB,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,CAAC,EAAE,iBAAiB,SAAS,cAAc,CACxE,CAAC;gBACJ,CAAC;gBACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC;YAC5C,CAAC,CAAC,EAAE,CAAC;QAEX,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;YAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE;YAC5C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;YACnD,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;YACrD,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;SACpD,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;YAC7B,MAAM,MAAM,CAAC,GAAG,CAAC;gBACf,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK;aAChC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACnC,MAAM,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC;YACxC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,EAAE;SACnB,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QACvD,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,YAAY;YACZ,GAAG,CAAC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,GAAG,CAAC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,2BAA2B,CAAC;YAC7C,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,aAAa,EAAE,KAAK,IAAI,EAAE;gBACxB,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC7B,CAAC;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,MAAM,uBAAuB,CAAC;YAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAClC,gBAAkC;QAElC,MAAM,yBAAyB,CAAC;YAC9B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,gBAAgB;SACjB,CAAC,CAAC;IACL,CAAC;CACF"}

package/bin/sdk/SessionMetadata.d.ts

@@ -0,0 +1,51 @@
+/**
+ * SDK Session 元数据辅助。
+ *
+ * 关键点（中文）
+ * - 统一负责 `.downcity/agents/<agentId>/sessions/<sessionId>/messages/meta.json` 的 SDK 字段读写。
+ * - 仅处理轻量配置摘要与索引信息，不负责消息 JSONL 的读写。
+ */
+import type { LanguageModel } from "ai";
+import type { SessionHistoryMetaV1 } from "../session/types/SessionHistoryMeta.js";
+type ReadSessionMetadataInput = {
+    /**
+     * 项目根目录。
+     */
+    projectRoot: string;
+    /**
+     * 当前 agentId。
+     */
+    agentId: string;
+    /**
+     * 当前 sessionId。
+     */
+    sessionId: string;
+};
+/**
+ * 从模型实例推导轻量可读标签。
+ */
+export declare function inferModelLabel(model: LanguageModel | undefined): string | undefined;
+/**
+ * 读取当前 session 的 meta.json。
+ */
+export declare function readSdkSessionMetadata(input: ReadSessionMetadataInput): Promise<SessionHistoryMetaV1>;
+/**
+ * 写回当前 session 的 meta.json。
+ */
+export declare function writeSdkSessionMetadata(input: ReadSessionMetadataInput & {
+    /**
+     * 下一份 meta 数据。
+     */
+    meta: SessionHistoryMetaV1;
+}): Promise<void>;
+/**
+ * 更新当前 session 的 SDK 配置摘要。
+ */
+export declare function patchSdkSessionModelLabel(input: ReadSessionMetadataInput & {
+    /**
+     * 当前模型实例。
+     */
+    model?: LanguageModel;
+}): Promise<SessionHistoryMetaV1>;
+export {};
+//# sourceMappingURL=SessionMetadata.d.ts.map

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,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,CAqD/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,CAuB/B"}

package/bin/sdk/SessionMetadata.js

@@ -0,0 +1,124 @@
+/**
+ * SDK Session 元数据辅助。
+ *
+ * 关键点（中文）
+ * - 统一负责 `.downcity/agents/<agentId>/sessions/<sessionId>/messages/meta.json` 的 SDK 字段读写。
+ * - 仅处理轻量配置摘要与索引信息，不负责消息 JSONL 的读写。
+ */
+import fs from "fs-extra";
+import { getSdkAgentSessionMetaPath } from "../sdk/Paths.js";
+function normalizeModelLabel(input) {
+    const label = typeof input === "string" ? input.trim() : "";
+    return label || undefined;
+}
+/**
+ * 从模型实例推导轻量可读标签。
+ */
+export function inferModelLabel(model) {
+    if (!model || typeof model !== "object")
+        return undefined;
+    const record = model;
+    const candidates = [
+        record.modelId,
+        record.model,
+        record.id,
+        record.name,
+        record.label,
+    ];
+    for (const candidate of candidates) {
+        const text = normalizeModelLabel(candidate);
+        if (text)
+            return text;
+    }
+    const constructorName = model.constructor && typeof model.constructor.name === "string"
+        ? model.constructor.name.trim()
+        : "";
+    return constructorName || "configured-model";
+}
+/**
+ * 读取当前 session 的 meta.json。
+ */
+export async function readSdkSessionMetadata(input) {
+    const filePath = getSdkAgentSessionMetaPath(input.projectRoot, input.agentId, input.sessionId);
+    try {
+        const raw = (await fs.readJson(filePath));
+        return {
+            v: 1,
+            sessionId: input.sessionId,
+            agentId: input.agentId,
+            createdAt: typeof raw.createdAt === "number" && Number.isFinite(raw.createdAt)
+                ? raw.createdAt
+                : Date.now(),
+            updatedAt: typeof raw.updatedAt === "number" && Number.isFinite(raw.updatedAt)
+                ? raw.updatedAt
+                : 0,
+            pinnedSkillIds: Array.isArray(raw.pinnedSkillIds)
+                ? raw.pinnedSkillIds
+                    .map((item) => (typeof item === "string" ? item.trim() : ""))
+                    .filter(Boolean)
+                : [],
+            ...(typeof raw.lastArchiveId === "string" && raw.lastArchiveId.trim()
+                ? { lastArchiveId: raw.lastArchiveId.trim() }
+                : {}),
+            ...(typeof raw.keepLastMessages === "number" &&
+                Number.isFinite(raw.keepLastMessages)
+                ? { keepLastMessages: raw.keepLastMessages }
+                : {}),
+            ...(typeof raw.maxInputTokensApprox === "number" &&
+                Number.isFinite(raw.maxInputTokensApprox)
+                ? { maxInputTokensApprox: raw.maxInputTokensApprox }
+                : {}),
+            ...(typeof raw.compactRatio === "number" && Number.isFinite(raw.compactRatio)
+                ? { compactRatio: raw.compactRatio }
+                : {}),
+            ...(raw.sdkConfig && typeof raw.sdkConfig === "object"
+                ? { sdkConfig: raw.sdkConfig }
+                : {}),
+        };
+    }
+    catch {
+        return {
+            v: 1,
+            sessionId: input.sessionId,
+            agentId: input.agentId,
+            createdAt: Date.now(),
+            updatedAt: 0,
+            pinnedSkillIds: [],
+        };
+    }
+}
+/**
+ * 写回当前 session 的 meta.json。
+ */
+export async function writeSdkSessionMetadata(input) {
+    const filePath = getSdkAgentSessionMetaPath(input.projectRoot, input.agentId, input.sessionId);
+    await fs.ensureFile(filePath);
+    await fs.writeJson(filePath, input.meta, { spaces: 2 });
+}
+/**
+ * 更新当前 session 的 SDK 配置摘要。
+ */
+export async function patchSdkSessionModelLabel(input) {
+    const current = await readSdkSessionMetadata(input);
+    const modelLabel = inferModelLabel(input.model);
+    const next = {
+        ...current,
+        agentId: input.agentId,
+        createdAt: typeof current.createdAt === "number" ? current.createdAt : Date.now(),
+        updatedAt: Date.now(),
+        ...(modelLabel
+            ? {
+                sdkConfig: {
+                    ...(current.sdkConfig || {}),
+                    modelLabel,
+                },
+            }
+            : {}),
+    };
+    await writeSdkSessionMetadata({
+        ...input,
+        meta: next,
+    });
+    return next;
+}
+//# sourceMappingURL=SessionMetadata.js.map

package/bin/sdk/SessionMetadata.js.map

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

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"}