@downcity/agent 1.1.1

package/bin/session/composer/history/SessionHistoryComposer.d.ts

@@ -0,0 +1,156 @@
+/**
+ * SessionHistoryComposer：会话历史 Composer 抽象。
+ *
+ * 关键点（中文）
+ * - 负责“历史读写 + 运行输入准备 + 文本消息工厂”。
+ * - 不负责模型调用，不负责执行编排。
+ */
+import type { LanguageModel, Tool } from "ai";
+import type { SessionMessageV1, SessionMetadataV1 } from "../../../types/session/SessionMessages.js";
+import type { SessionSystemMessage } from "../../../types/session/SessionPrompts.js";
+import { SessionComposer } from "../../composer/SessionComposer.js";
+/**
+ * prepare 输入参数。
+ */
+export type SessionHistoryPrepareInput = {
+    /**
+     * 当前用户查询文本。
+     */
+    query: string;
+    /**
+     * 当前轮可用工具集合。
+     */
+    tools: Record<string, Tool>;
+    /**
+     * 当前轮 system messages。
+     */
+    system: SessionSystemMessage[];
+    /**
+     * 当前模型实例。
+     */
+    model: LanguageModel;
+    /**
+     * 当前重试次数（由 LocalSessionCore 递增）。
+     */
+    retryCount: number;
+};
+/**
+ * compact 输入参数。
+ */
+export type SessionHistoryCompactInput = {
+    /**
+     * 当前模型实例。
+     */
+    model: LanguageModel;
+    /**
+     * 当前轮 system messages。
+     */
+    system: SessionSystemMessage[];
+    /**
+     * 保留最近消息条数。
+     */
+    keepLastMessages: number;
+    /**
+     * 输入 token 近似上限。
+     */
+    maxInputTokensApprox: number;
+    /**
+     * compact 时是否归档旧消息。
+     */
+    archiveOnCompact: boolean;
+    /**
+     * 前段压缩比例（0-1）。
+     *
+     * 关键点（中文）
+     * - 例如 0.5 表示“优先压缩最早 50% 的 UIMessage”。
+     * - 具体切分由 history Composer 实现侧做边界校正。
+     */
+    compactRatio: number;
+};
+/**
+ * SessionHistoryComposer 抽象类。
+ */
+export declare abstract class SessionHistoryComposer extends SessionComposer {
+    /**
+     * Composer 名（由具体实现声明）。
+     */
+    abstract readonly name: string;
+    /**
+     * 当前会话 ID。
+     */
+    abstract readonly sessionId: string;
+    /**
+     * 为本轮 Session 执行准备模型输入消息。
+     */
+    abstract prepare(input: SessionHistoryPrepareInput): Promise<SessionMessageV1[]>;
+    /**
+     * 执行一次 compact（best-effort）。
+     */
+    abstract compact(input: SessionHistoryCompactInput): Promise<{
+        compacted: boolean;
+        reason?: string;
+    }>;
+    /**
+     * 追加一条消息到历史。
+     */
+    abstract append(message: SessionMessageV1): Promise<void>;
+    /**
+     * 读取完整消息历史。
+     */
+    abstract list(): Promise<SessionMessageV1[]>;
+    /**
+     * 读取消息区间 [start, end)。
+     */
+    abstract slice(start: number, end: number): Promise<SessionMessageV1[]>;
+    /**
+     * 读取消息总条数。
+     */
+    abstract size(): Promise<number>;
+    /**
+     * 读取元信息。
+     */
+    abstract meta(): Promise<Record<string, unknown>>;
+    /**
+     * 构造 user 文本消息。
+     */
+    abstract userText(input: {
+        /**
+         * 用户文本内容。
+         */
+        text: string;
+        /**
+         * 消息元信息（除 schema 字段）。
+         */
+        metadata: Omit<SessionMetadataV1, "v" | "ts"> & Partial<Pick<SessionMetadataV1, "ts">>;
+        /**
+         * 可选消息 ID（默认自动生成）。
+         */
+        id?: string;
+    }): SessionMessageV1;
+    /**
+     * 构造 assistant 文本消息。
+     */
+    abstract assistantText(input: {
+        /**
+         * 助手文本内容。
+         */
+        text: string;
+        /**
+         * 消息元信息（除 schema 字段）。
+         */
+        metadata: Omit<SessionMetadataV1, "v" | "ts"> & Partial<Pick<SessionMetadataV1, "ts">>;
+        /**
+         * 可选消息 ID（默认自动生成）。
+         */
+        id?: string;
+        /**
+         * 消息种类（普通/摘要）。
+         */
+        kind?: "normal" | "summary";
+        /**
+         * 消息来源（egress/compact）。
+         */
+        source?: "egress" | "compact";
+    }): SessionMessageV1;
+}
+//# sourceMappingURL=SessionHistoryComposer.d.ts.map

package/bin/session/composer/history/SessionHistoryComposer.d.ts.map

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

package/bin/session/composer/history/SessionHistoryComposer.js

@@ -0,0 +1,14 @@
+/**
+ * SessionHistoryComposer：会话历史 Composer 抽象。
+ *
+ * 关键点（中文）
+ * - 负责“历史读写 + 运行输入准备 + 文本消息工厂”。
+ * - 不负责模型调用，不负责执行编排。
+ */
+import { SessionComposer } from "../../composer/SessionComposer.js";
+/**
+ * SessionHistoryComposer 抽象类。
+ */
+export class SessionHistoryComposer extends SessionComposer {
+}
+//# sourceMappingURL=SessionHistoryComposer.js.map

package/bin/session/composer/history/SessionHistoryComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionHistoryComposer.js","sourceRoot":"","sources":["../../../../src/session/composer/history/SessionHistoryComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAuEvE;;GAEG;AACH,MAAM,OAAgB,sBAAuB,SAAQ,eAAe;CAyGnE"}

package/bin/session/composer/history/SessionHistoryWriter.d.ts

@@ -0,0 +1,56 @@
+/**
+ * SessionHistoryWriter：单个 Session 的消息写入器。
+ *
+ * 关键点（中文）
+ * - 只负责当前 session 的 user / assistant 消息补写。
+ * - 只依赖当前 session 的 history Composer，不感知其他 session。
+ * - 会话更新后的通知也收在这里，避免把写入细节散到 Session 主类里。
+ */
+import type { JsonObject } from "../../../shared/types/Json.js";
+import type { SessionMessageV1 } from "../../../types/session/SessionMessages.js";
+import type { SessionHistoryComposer } from "../../composer/history/SessionHistoryComposer.js";
+type SessionHistoryWriterOptions = {
+    /**
+     * 当前 session 标识。
+     */
+    sessionId: string;
+    /**
+     * 获取当前 session 对应的 history Composer。
+     */
+    getHistoryComposer: () => SessionHistoryComposer;
+    /**
+     * session 更新后的异步回调。
+     */
+    runAfterSessionUpdated?: (sessionId: string) => Promise<void>;
+};
+/**
+ * SessionHistoryWriter：单 session 写入器。
+ */
+export declare class SessionHistoryWriter {
+    private readonly sessionId;
+    private readonly getHistoryComposer;
+    private readonly runAfterSessionUpdated?;
+    constructor(options: SessionHistoryWriterOptions);
+    /**
+     * 触发 session 更新后的异步回调。
+     */
+    afterSessionUpdatedAsync(): Promise<void>;
+    /**
+     * 追加一条 user 消息。
+     */
+    appendUserMessage(params: {
+        message?: SessionMessageV1 | null;
+        text?: string;
+        extra?: JsonObject;
+    }): Promise<void>;
+    /**
+     * 追加一条 assistant 消息。
+     */
+    appendAssistantMessage(params: {
+        message?: SessionMessageV1 | null;
+        fallbackText?: string;
+        extra?: JsonObject;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=SessionHistoryWriter.d.ts.map

package/bin/session/composer/history/SessionHistoryWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionHistoryWriter.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/history/SessionHistoryWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qDAAqD,CAAC;AAElG,KAAK,2BAA2B,GAAG;IACjC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;IAEjD;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D,CAAC;AAEF;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoD;IACvF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAwD;gBAEpF,OAAO,EAAE,2BAA2B;IAShD;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/C;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC9B,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BjB;;OAEG;IACG,sBAAsB,CAAC,MAAM,EAAE;QACnC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;CA4BlB"}

package/bin/session/composer/history/SessionHistoryWriter.js

@@ -0,0 +1,95 @@
+/**
+ * SessionHistoryWriter：单个 Session 的消息写入器。
+ *
+ * 关键点（中文）
+ * - 只负责当前 session 的 user / assistant 消息补写。
+ * - 只依赖当前 session 的 history Composer，不感知其他 session。
+ * - 会话更新后的通知也收在这里，避免把写入细节散到 Session 主类里。
+ */
+/**
+ * SessionHistoryWriter：单 session 写入器。
+ */
+export class SessionHistoryWriter {
+    sessionId;
+    getHistoryComposer;
+    runAfterSessionUpdated;
+    constructor(options) {
+        this.sessionId = String(options.sessionId || "").trim();
+        this.getHistoryComposer = options.getHistoryComposer;
+        this.runAfterSessionUpdated = options.runAfterSessionUpdated;
+        if (!this.sessionId) {
+            throw new Error("SessionHistoryWriter requires a non-empty sessionId");
+        }
+    }
+    /**
+     * 触发 session 更新后的异步回调。
+     */
+    async afterSessionUpdatedAsync() {
+        if (!this.runAfterSessionUpdated)
+            return;
+        try {
+            await this.runAfterSessionUpdated(this.sessionId);
+        }
+        catch {
+            // ignore
+        }
+    }
+    /**
+     * 追加一条 user 消息。
+     */
+    async appendUserMessage(params) {
+        try {
+            const historyComposer = this.getHistoryComposer();
+            if (params.message && typeof params.message === "object") {
+                await historyComposer.append(params.message);
+                void this.afterSessionUpdatedAsync();
+                return;
+            }
+            const fallbackText = String(params.text || "").trim();
+            if (!fallbackText)
+                return;
+            const message = historyComposer.userText({
+                text: fallbackText,
+                metadata: {
+                    sessionId: this.sessionId,
+                    extra: params.extra,
+                },
+            });
+            await historyComposer.append(message);
+            void this.afterSessionUpdatedAsync();
+        }
+        catch {
+            // ignore
+        }
+    }
+    /**
+     * 追加一条 assistant 消息。
+     */
+    async appendAssistantMessage(params) {
+        try {
+            const historyComposer = this.getHistoryComposer();
+            if (params.message && typeof params.message === "object") {
+                await historyComposer.append(params.message);
+                void this.afterSessionUpdatedAsync();
+                return;
+            }
+            const fallbackText = String(params.fallbackText || "").trim();
+            if (!fallbackText)
+                return;
+            await historyComposer.append(historyComposer.assistantText({
+                text: fallbackText,
+                metadata: {
+                    sessionId: this.sessionId,
+                    extra: params.extra,
+                },
+                kind: "normal",
+                source: "egress",
+            }));
+            void this.afterSessionUpdatedAsync();
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+//# sourceMappingURL=SessionHistoryWriter.js.map

package/bin/session/composer/history/SessionHistoryWriter.js.map

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

package/bin/session/composer/history/jsonl/JsonlSessionHistoryComposer.d.ts

@@ -0,0 +1,67 @@
+/**
+ * JsonlSessionHistoryComposer：基于 JSONL 的 session history Composer 实现。
+ *
+ * 关键点（中文）
+ * - 以 `.downcity/session/<sessionId>/messages/messages.jsonl` 为事实源。
+ * - append 与 compact 共用同一把文件锁，避免并发覆盖。
+ * - 对 Session 执行层暴露统一的 SessionHistoryComposer 接口。
+ */
+import type { SessionMessageV1, SessionMetadataV1 } from "../../../../types/session/SessionMessages.js";
+import type { SessionHistoryPathOverrides } from "../../../../types/session/SessionHistoryPaths.js";
+import { SessionHistoryComposer, type SessionHistoryCompactInput, type SessionHistoryPrepareInput } from "../../../composer/history/SessionHistoryComposer.js";
+type JsonlSessionHistoryComposerOptions = {
+    rootPath: string;
+    sessionId?: string;
+    paths?: SessionHistoryPathOverrides;
+};
+export declare class JsonlSessionHistoryComposer extends SessionHistoryComposer {
+    readonly name = "jsonl_history_store";
+    readonly sessionId: string;
+    private readonly rootPath;
+    private readonly overrideSessionDirPath?;
+    private readonly overrideMessagesDirPath?;
+    private readonly overrideMessagesFilePath?;
+    private readonly overrideMetaFilePath?;
+    private readonly overrideArchiveDirPath?;
+    constructor(options: JsonlSessionHistoryComposerOptions);
+    private readOptionalPath;
+    private getMessagesDirPath;
+    private getMessagesFilePath;
+    private getMetaFilePath;
+    private getArchiveDirPath;
+    private getLockFilePath;
+    private ensureLayout;
+    private normalizePinnedSkillIds;
+    private readMetaUnsafe;
+    private writeMetaUnsafe;
+    private withWriteLock;
+    private normalizeSystem;
+    private normalizeTools;
+    private readUserSessionMessageText;
+    private hasTrailingUserQuery;
+    private sanitizeMessages;
+    compact(input: SessionHistoryCompactInput): Promise<{
+        compacted: boolean;
+        reason?: string;
+    }>;
+    prepare(input: SessionHistoryPrepareInput): Promise<SessionMessageV1[]>;
+    append(message: SessionMessageV1): Promise<void>;
+    list(): Promise<SessionMessageV1[]>;
+    slice(start: number, end: number): Promise<SessionMessageV1[]>;
+    size(): Promise<number>;
+    meta(): Promise<Record<string, unknown>>;
+    userText(input: {
+        text: string;
+        metadata: Omit<SessionMetadataV1, "v" | "ts"> & Partial<Pick<SessionMetadataV1, "ts">>;
+        id?: string;
+    }): SessionMessageV1;
+    assistantText(input: {
+        text: string;
+        metadata: Omit<SessionMetadataV1, "v" | "ts"> & Partial<Pick<SessionMetadataV1, "ts">>;
+        id?: string;
+        kind?: "normal" | "summary";
+        source?: "egress" | "compact";
+    }): SessionMessageV1;
+}
+export {};
+//# sourceMappingURL=JsonlSessionHistoryComposer.d.ts.map

package/bin/session/composer/history/jsonl/JsonlSessionHistoryComposer.d.ts.map

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