@downcity/agent 1.1.1 → 1.1.5

package/bin/host/sdk/Session.js

@@ -0,0 +1,451 @@
+/**
+ * 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 { 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";
+/**
+ * SDK 本地 Session。
+ */
+export class SdkSession {
+    id;
+    agentId;
+    projectRoot;
+    tools;
+    logger;
+    getStaticSystemPrompts;
+    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;
+        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,
+                    }),
+                    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 是否正在执行。
+     */
+    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) => {
+                        this.pushChunkEvent(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,
+        });
+        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 端口。
+     *
+     * 关键点（中文）
+     * - 这里不走 SDK `run()` 包装层，而是直接暴露底层 `CoreSession` 协议。
+     * - 这样 chat queue worker 可以复用既有 `SessionPort` 契约，不会重复补写消息。
+     */
+    getServicePort() {
+        if (this.servicePort)
+            return this.servicePort;
+        this.servicePort = {
+            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);
+                await this.touchMetadata();
+            },
+            isExecuting: () => this.coreSession.isExecuting(),
+        };
+        return this.servicePort;
+    }
+    async touchMetadata() {
+        const current = await readSdkSessionMetadata({
+            projectRoot: this.projectRoot,
+            agentId: this.agentId,
+            sessionId: this.id,
+        });
+        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({
+            projectRoot: this.projectRoot,
+            agentId: this.agentId,
+            sessionId: this.id,
+            meta: next,
+        });
+    }
+    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/host/sdk/Session.js.map

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

package/bin/host/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 "../../types/session/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/host/sdk/SessionMetadata.d.ts.map

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

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

package/bin/host/sdk/StreamEvents.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SDK Stream 事件映射辅助。
+ *
+ * 关键点（中文）
+ * - 把底层 AI SDK `UIMessageChunk` 归一到 `AgentSessionStreamEvent`。
+ * - 仅保留 SDK 当前需要的稳定事件，不把所有底层细节直接暴露出去。
+ */
+import type { UIMessageChunk } from "ai";
+import type { AgentSessionStreamEvent } from "../../host/sdk/AgentSdkTypes.js";
+/**
+ * 把单个 UI chunk 映射为 SDK stream 事件。
+ */
+export declare function mapUiMessageChunkToSdkEvent(chunk: UIMessageChunk): AgentSessionStreamEvent | null;
+//# sourceMappingURL=StreamEvents.d.ts.map