lightclawbot 1.0.0 → 1.0.1

package/dist/src/history/session-reader.js

@@ -0,0 +1,287 @@
+/**
+ * LightClaw — Session Reader
+ *
+ * 核心的历史消息读取逻辑，包含：
+ *   - readSessionHistory()          — 读取单个 session 的历史消息
+ *   - readSessionHistoryTail()      — 从文件末尾高效读取（大文件优化）
+ *   - readCronHistory()             — 读取指定 cron job 的全部运行历史
+ *   - readSessionHistoryWithCron()  — 【方案C核心】主会话 + cron 消息按时间线混合
+ *   - listSessions()                — 列出所有 session（含 cron 类型标识）
+ */
+import fs from "node:fs";
+import { resolveTranscriptPath } from "./session-store.js";
+import { isSystemInjectedUserMessage, normalizeMessage } from "./message-parser.js";
+import { listCronSessions, classifySessionKey, extractCronJobId, extractCronJobIdsFromTranscript, findCronSessionsByJobIds, } from "./cron-utils.js";
+import { loadSessionStore } from "./session-store.js";
+// ============================================================
+// 核心读取：单个 Session
+// ============================================================
+/**
+ * 读取指定 sessionKey 的历史对话消息
+ *
+ * @param sessionKey - 会话标识（与 gateway.ts 中 route.sessionKey 一致）
+ * @param opts - 选项
+ * @returns 历史消息数组（按时间正序），如果找不到 session 返回空数组
+ */
+export function readSessionHistory(sessionKey, opts) {
+    const limit = opts?.limit ?? 200;
+    const chatOnly = opts?.chatOnly ?? false;
+    const filePath = resolveTranscriptPath(sessionKey, opts?.agentId);
+    if (!filePath)
+        return [];
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        return parseTranscriptLines(raw, { limit, chatOnly });
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 读取指定 sessionKey 的历史消息（从文件末尾读取，大文件性能更好）
+ *
+ * 对于大文件（>maxBytes），不读取整个文件，而是从末尾读取指定字节数。
+ */
+export function readSessionHistoryTail(sessionKey, opts) {
+    const limit = opts?.limit ?? 200;
+    const chatOnly = opts?.chatOnly ?? false;
+    const maxBytes = opts?.maxBytes ?? 1_048_576; // 默认 1MB
+    const filePath = resolveTranscriptPath(sessionKey, opts?.agentId);
+    if (!filePath)
+        return [];
+    let fd = null;
+    try {
+        fd = fs.openSync(filePath, "r");
+        const stat = fs.fstatSync(fd);
+        const size = stat.size;
+        if (size === 0)
+            return [];
+        // 小文件直接全量读取
+        if (size <= maxBytes) {
+            fs.closeSync(fd);
+            fd = null;
+            return readSessionHistory(sessionKey, opts);
+        }
+        // 大文件从末尾读取
+        const readStart = Math.max(0, size - maxBytes);
+        const readLen = Math.min(size, maxBytes);
+        const buf = Buffer.alloc(readLen);
+        fs.readSync(fd, buf, 0, readLen, readStart);
+        const chunk = buf.toString("utf-8");
+        const lines = chunk.split(/\r?\n/).filter((l) => l.trim());
+        // 跳过第一行（可能是不完整的行）
+        if (readStart > 0 && lines.length > 0) {
+            lines.shift();
+        }
+        return parseLines(lines, { limit, chatOnly });
+    }
+    catch {
+        return [];
+    }
+    finally {
+        if (fd !== null) {
+            try {
+                fs.closeSync(fd);
+            }
+            catch { /* ignore */ }
+        }
+    }
+}
+// ============================================================
+// Cron 历史读取
+// ============================================================
+/**
+ * 读取指定 cron job 的所有运行历史（跨多个 run session）
+ *
+ * @param cronJobId - cron job UUID
+ * @param opts - 选项
+ * @returns 按时间正序排列的所有运行消息（仅 user + assistant）
+ */
+export function readCronHistory(cronJobId, opts) {
+    const limit = opts?.limit ?? 200;
+    const cronSessions = listCronSessions(opts?.agentId)
+        .filter((s) => s.cronJobId === cronJobId)
+        .sort((a, b) => (a.updatedAt ?? 0) - (b.updatedAt ?? 0)); // 时间正序
+    const allMessages = [];
+    for (const cs of cronSessions) {
+        const messages = readSessionHistory(cs.sessionKey, {
+            ...opts,
+            limit: limit - allMessages.length,
+            chatOnly: true,
+        });
+        for (const msg of messages) {
+            // cron run 的 user 消息是系统自动生成的 prompt 模板，不是用户真实输入，跳过
+            if (msg.role === "user")
+                continue;
+            msg.cronInfo = {
+                jobId: cs.cronJobId,
+                name: cs.cronName,
+                runSessionId: cs.sessionId,
+            };
+            allMessages.push(msg);
+        }
+        if (allMessages.length >= limit)
+            break;
+    }
+    return allMessages.slice(-limit);
+}
+// ============================================================
+// 核心：混合读取（基于显式关联）
+// ============================================================
+/**
+ * 读取主会话历史 + 关联的 cron 消息，按时间线合并
+ *
+ * 关联机制（精确关联，非遍历全量）：
+ *   1. 读取主会话 JSONL → 解析消息 + 同时扫描 cron 工具调用结果
+ *   2. 从 cron toolResult 中提取 cron job IDs（显式关联）
+ *   3. 用这些 job IDs 到 sessions.json 中精确匹配 cron run sessions
+ *   4. 读取关联的 cron run sessions 的消息
+ *   5. 按时间窗口过滤 + 合并排序
+ *
+ * 相比旧方案（遍历所有 cron sessions + 时间窗口近似匹配），
+ * 新方案通过主会话中的 cron 工具调用记录建立了**显式关联关系**。
+ *
+ * @param sessionKey - 主会话标识
+ * @param opts - 选项（可控制是否包含 cron、筛选特定 cron job）
+ * @returns 按时间正序排列的合并消息
+ */
+export function readSessionHistoryWithCron(sessionKey, opts) {
+    const limit = opts?.limit ?? 200;
+    const includeCron = opts?.includeCron ?? true;
+    // 1. 读取主会话消息
+    const mainMessages = readSessionHistory(sessionKey, opts);
+    if (!includeCron)
+        return mainMessages;
+    // 2. 从主会话 JSONL 中提取关联的 cron job IDs
+    //    这是关键——通过扫描主会话中 cron 工具调用的返回结果，
+    //    获取用户在这个会话中创建的所有 cron job 的 ID
+    const cronJobIds = opts?.cronJobIds ?? extractCronJobIdsFromTranscript(sessionKey, opts?.agentId);
+    if (cronJobIds.length === 0)
+        return mainMessages;
+    // 3. 用 cron job IDs 精确查找关联的 cron run sessions
+    //    不再遍历所有 cron sessions，只查找与主会话显式关联的
+    const cronSessions = findCronSessionsByJobIds(cronJobIds, opts?.agentId);
+    if (cronSessions.length === 0)
+        return mainMessages;
+    // 4. 确定时间窗口——只取主会话时间范围内的 cron 消息
+    const mainTimestamps = mainMessages
+        .map((m) => m.timestamp)
+        .filter((t) => t !== undefined);
+    const timeWindowStart = mainTimestamps.length > 0
+        ? Math.min(...mainTimestamps) - 60_000 // 往前延1分钟
+        : 0;
+    // 5. 读取 cron 消息（按时间窗口过滤）
+    const cronMessages = [];
+    const relevantSessions = cronSessions.filter((cs) => !cs.updatedAt || cs.updatedAt >= timeWindowStart);
+    for (const cs of relevantSessions) {
+        const msgs = readSessionHistory(cs.sessionKey, {
+            ...opts,
+            chatOnly: true,
+            limit: 50, // 每个 cron run 最多取 50 条
+        });
+        for (const msg of msgs) {
+            // 时间窗口过滤
+            if (msg.timestamp && msg.timestamp < timeWindowStart)
+                continue;
+            // cron run 的 user 消息是系统自动生成的 prompt 模板，不是用户真实输入，跳过
+            if (msg.role === "user")
+                continue;
+            msg.cronInfo = {
+                jobId: cs.cronJobId,
+                name: cs.cronName,
+                runSessionId: cs.sessionId,
+            };
+            cronMessages.push(msg);
+        }
+    }
+    if (cronMessages.length === 0)
+        return mainMessages;
+    // 6. 按时间合并
+    const merged = [...mainMessages, ...cronMessages]
+        .sort((a, b) => (a.timestamp ?? 0) - (b.timestamp ?? 0));
+    return merged.length > limit ? merged.slice(-limit) : merged;
+}
+// ============================================================
+// Session 列表
+// ============================================================
+/**
+ * 列出所有已知的 session（从 sessions.json 索引读取）
+ *
+ * 增强：每个条目标识会话类型（direct / cron-base / cron-run）
+ */
+export function listSessions(agentId) {
+    const store = loadSessionStore(agentId);
+    return Object.entries(store)
+        .filter(([, entry]) => entry && entry.sessionId)
+        .map(([key, entry]) => ({
+        sessionKey: key,
+        sessionId: entry.sessionId,
+        updatedAt: entry.updatedAt,
+        label: entry.label,
+        displayName: entry.displayName,
+        channel: entry.channel,
+        sessionType: classifySessionKey(key),
+        cronJobId: extractCronJobId(key) ?? undefined,
+    }))
+        .sort((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0));
+}
+// ============================================================
+// 内部工具函数
+// ============================================================
+/**
+ * 解析完整 transcript 文件内容
+ */
+function parseTranscriptLines(raw, opts) {
+    const lines = raw.split(/\r?\n/).filter((l) => l.trim());
+    return parseLines(lines, opts);
+}
+/**
+ * 解析 JSONL 行数组为 HistoryMessage[]
+ */
+function parseLines(lines, opts) {
+    const { limit, chatOnly } = opts;
+    const messages = [];
+    for (const line of lines) {
+        try {
+            const parsed = JSON.parse(line);
+            const lineType = parsed?.type;
+            // 非消息行：显式跳过已知的元数据行类型
+            if (lineType === "session" || lineType === "model_change"
+                || lineType === "thinking_level_change" || lineType === "custom") {
+                continue;
+            }
+            // compaction 标记
+            if (lineType === "compaction") {
+                if (!chatOnly) {
+                    const ts = typeof parsed.timestamp === "string" ? Date.parse(parsed.timestamp) : undefined;
+                    messages.push({
+                        role: "system",
+                        content: "── Context compacted ──",
+                        timestamp: ts && Number.isFinite(ts) ? ts : Date.now(),
+                        isCompaction: true,
+                    });
+                }
+                continue;
+            }
+            // 标准消息行
+            const msg = parsed?.message;
+            if (!msg || typeof msg !== "object")
+                continue;
+            // 过滤传输层伪装为 user 的系统注入消息
+            if (isSystemInjectedUserMessage(msg))
+                continue;
+            const normalized = normalizeMessage(msg);
+            if (!normalized)
+                continue;
+            if (chatOnly && normalized.role !== "user" && normalized.role !== "assistant")
+                continue;
+            messages.push(normalized);
+        }
+        catch {
+            // 跳过格式错误的行
+        }
+    }
+    // 只返回最后 limit 条
+    return messages.length > limit ? messages.slice(-limit) : messages;
+}
+//# sourceMappingURL=session-reader.js.map

package/dist/src/history/session-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-reader.js","sourceRoot":"","sources":["../../../src/history/session-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AASzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,IAAyB;IAC9E,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,GAAG,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,KAAK,CAAC;IAEzC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClE,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,oBAAoB,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAkB,EAClB,IAA6B;IAE7B,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,GAAG,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,KAAK,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,SAAS,CAAC,CAAC,SAAS;IAEvD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClE,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,IAAI,EAAE,GAAkB,IAAI,CAAC;IAC7B,IAAI,CAAC;QACH,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAEvB,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAE1B,YAAY;QACZ,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;YACrB,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACjB,EAAE,GAAG,IAAI,CAAC;YACV,OAAO,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,WAAW;QACX,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAE5C,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAE3D,kBAAkB;QAClB,IAAI,SAAS,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QAED,OAAO,UAAU,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC;gBAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,YAAY;AACZ,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAiB,EACjB,IAAyB;IAEzB,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,GAAG,CAAC;IACjC,MAAM,YAAY,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC;SACjD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC;SACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;IAEnE,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE;YACjD,GAAG,IAAI;YACP,KAAK,EAAE,KAAK,GAAG,WAAW,CAAC,MAAM;YACjC,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QACH,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,mDAAmD;YACnD,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAS;YAElC,GAAG,CAAC,QAAQ,GAAG;gBACb,KAAK,EAAE,EAAE,CAAC,SAAS;gBACnB,IAAI,EAAE,EAAE,CAAC,QAAQ;gBACjB,YAAY,EAAE,EAAE,CAAC,SAAS;aAC3B,CAAC;YACF,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;IACzC,CAAC;IAED,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAE/D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAkB,EAClB,IAAiC;IAEjC,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,GAAG,CAAC;IACjC,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,IAAI,CAAC;IAE9C,aAAa;IACb,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAE1D,IAAI,CAAC,WAAW;QAAE,OAAO,YAAY,CAAC;IAEtC,oCAAoC;IACpC,oCAAoC;IACpC,mCAAmC;IACnC,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,+BAA+B,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAElG,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC;IAEjD,8CAA8C;IAC9C,uCAAuC;IACvC,MAAM,YAAY,GAAG,wBAAwB,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAEzE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC;IAEnD,iCAAiC;IACjC,MAAM,cAAc,GAAG,YAAY;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;SACvB,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC;QAC/C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,GAAG,MAAM,CAAC,SAAS;QAChD,CAAC,CAAC,CAAC,CAAC;IAEN,yBAAyB;IACzB,MAAM,YAAY,GAAqB,EAAE,CAAC;IAC1C,MAAM,gBAAgB,GAAG,YAAY,CAAC,MAAM,CAC1C,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,IAAI,eAAe,CACzD,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE;YAC7C,GAAG,IAAI;YACP,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,EAAE,EAAE,uBAAuB;SACnC,CAAC,CAAC;QACH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,SAAS;YACT,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,GAAG,eAAe;gBAAE,SAAS;YAE/D,mDAAmD;YACnD,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAS;YAElC,GAAG,CAAC,QAAQ,GAAG;gBACb,KAAK,EAAE,EAAE,CAAC,SAAS;gBACnB,IAAI,EAAE,EAAE,CAAC,QAAQ;gBACjB,YAAY,EAAE,EAAE,CAAC,SAAS;aAC3B,CAAC;YACF,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC;IAEnD,WAAW;IACX,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,YAAY,CAAC;SAC9C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC;IAE3D,OAAO,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/D,CAAC;AAED,+DAA+D;AAC/D,aAAa;AACb,+DAA+D;AAE/D;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS,CAAC;SAC/C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,UAAU,EAAE,GAAG;QACf,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,kBAAkB,CAAC,GAAG,CAAC;QACpC,SAAS,EAAE,gBAAgB,CAAC,GAAG,CAAC,IAAI,SAAS;KAC9C,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,+DAA+D;AAC/D,SAAS;AACT,+DAA+D;AAE/D;;GAEG;AACH,SAAS,oBAAoB,CAC3B,GAAW,EACX,IAA0C;IAE1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACzD,OAAO,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CACjB,KAAe,EACf,IAA0C;IAE1C,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACjC,MAAM,QAAQ,GAAqB,EAAE,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,EAAE,IAAI,CAAC;YAE9B,qBAAqB;YACrB,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,cAAc;mBACpD,QAAQ,KAAK,uBAAuB,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACnE,SAAS;YACX,CAAC;YAED,gBAAgB;YAChB,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC9B,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,EAAE,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC3F,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,yBAAyB;wBAClC,SAAS,EAAE,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;wBACtD,YAAY,EAAE,IAAI;qBACnB,CAAC,CAAC;gBACL,CAAC;gBACD,SAAS;YACX,CAAC;YAED,QAAQ;YACR,MAAM,GAAG,GAAG,MAAM,EAAE,OAAO,CAAC;YAC5B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,SAAS;YAE9C,wBAAwB;YACxB,IAAI,2BAA2B,CAAC,GAA8B,CAAC;gBAAE,SAAS;YAE1E,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAA8B,CAAC,CAAC;YACpE,IAAI,CAAC,UAAU;gBAAE,SAAS;YAE1B,IAAI,QAAQ,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,IAAI,UAAU,CAAC,IAAI,KAAK,WAAW;gBAAE,SAAS;YAExF,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,WAAW;QACb,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,OAAO,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrE,CAAC"}

package/dist/src/history/session-store.d.ts

@@ -0,0 +1,38 @@
+/**
+ * LightClaw — Session Store
+ *
+ * 封装 OpenClaw sessions.json 索引的读取和路径解析逻辑。
+ * 所有 session 文件的定位都通过此模块完成。
+ *
+ * 路径解析策略（多层回退）：
+ *   1. entry.sessionFile（精确路径 / 相对路径）
+ *   2. OPENCLAW_HOME/agents/<agentId>/sessions/<sessionId>.jsonl（标准目录）
+ *   3. sessions.json 同级目录下的 <sessionId>.jsonl（离线分析场景，
+ *      如把远程服务器的 session 文件下载到本地）
+ */
+import type { SessionStoreEntry } from "./types.js";
+/** 获取 OpenClaw 数据目录 */
+export declare function resolveOpenClawHome(): string;
+/**
+ * 解析 agentId 对应的 sessions 目录
+ * 默认 agentId 为 "main"（与 OpenClaw DEFAULT_AGENT_ID 一致）
+ */
+export declare function resolveSessionsDir(agentId?: string): string;
+/**
+ * 加载 sessions.json 索引，获取 sessionKey → sessionEntry 映射
+ */
+export declare function loadSessionStore(agentId?: string): Record<string, SessionStoreEntry>;
+/**
+ * 获取 sessions.json 所在目录（用于第3层路径回退）
+ */
+export declare function getStoreDir(): string | null;
+/**
+ * 根据 sessionKey 找到对应的 .jsonl transcript 文件路径
+ *
+ * 路径解析优先级：
+ *   1. entry.sessionFile — 绝对路径 / 相对于 sessionsDir 的路径
+ *   2. sessionsDir/<sessionId>.jsonl — 标准 OPENCLAW_HOME 目录
+ *   3. storeDir/<sessionId>.jsonl — sessions.json 同级目录（离线分析场景）
+ */
+export declare function resolveTranscriptPath(sessionKey: string, agentId?: string): string | null;
+//# sourceMappingURL=session-store.d.ts.map

package/dist/src/history/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../src/history/session-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AASpD,uBAAuB;AACvB,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3D;AAcD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAgBpF;AAiBD;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAE3C;AAMD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoCzF"}

package/dist/src/history/session-store.js

@@ -0,0 +1,131 @@
+/**
+ * LightClaw — Session Store
+ *
+ * 封装 OpenClaw sessions.json 索引的读取和路径解析逻辑。
+ * 所有 session 文件的定位都通过此模块完成。
+ *
+ * 路径解析策略（多层回退）：
+ *   1. entry.sessionFile（精确路径 / 相对路径）
+ *   2. OPENCLAW_HOME/agents/<agentId>/sessions/<sessionId>.jsonl（标准目录）
+ *   3. sessions.json 同级目录下的 <sessionId>.jsonl（离线分析场景，
+ *      如把远程服务器的 session 文件下载到本地）
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+// 获取当前文件的目录
+// const currentDir = path.dirname(import.meta.url);
+// ============================================================
+// 路径解析
+// ============================================================
+/** 获取 OpenClaw 数据目录 */
+export function resolveOpenClawHome() {
+    return process.env.OPENCLAW_HOME || path.join(os.homedir(), ".openclaw");
+}
+/**
+ * 解析 agentId 对应的 sessions 目录
+ * 默认 agentId 为 "main"（与 OpenClaw DEFAULT_AGENT_ID 一致）
+ */
+export function resolveSessionsDir(agentId) {
+    const home = resolveOpenClawHome();
+    const id = agentId?.trim() || "main";
+    return path.join(home, "agents", id, "sessions");
+}
+// ============================================================
+// Session Store 加载
+// ============================================================
+/**
+ * sessions.json 的实际磁盘路径（加载成功后缓存）
+ *
+ * 用于第3层回退：当标准目录下找不到 .jsonl 文件时，
+ * 尝试在 sessions.json 所在目录查找（离线 / 下载到本地场景）。
+ */
+let _lastStoreFilePath = null;
+/**
+ * 加载 sessions.json 索引，获取 sessionKey → sessionEntry 映射
+ */
+export function loadSessionStore(agentId) {
+    const storePath = path.join(resolveSessionsDir(agentId), "sessions.json");
+    //   const storePath = path.join(currentDir, "../../sessions/sessions.json").replace("file:", "");
+    const loaded = _tryLoadStore(storePath);
+    if (loaded)
+        return loaded;
+    // 标准路径失败 → 尝试从 OPENCLAW_HOME 根下直接查找 sessions.json
+    // （兼容平铺结构）
+    const home = resolveOpenClawHome();
+    const rootStorePath = path.join(home, "sessions", "sessions.json");
+    if (rootStorePath !== storePath) {
+        const rootLoaded = _tryLoadStore(rootStorePath);
+        if (rootLoaded)
+            return rootLoaded;
+    }
+    return {};
+}
+function _tryLoadStore(storePath) {
+    try {
+        const raw = fs.readFileSync(storePath, "utf-8");
+        if (!raw.trim())
+            return null;
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            _lastStoreFilePath = storePath;
+            return parsed;
+        }
+    }
+    catch {
+        // 文件不存在或解析失败
+    }
+    return null;
+}
+/**
+ * 获取 sessions.json 所在目录（用于第3层路径回退）
+ */
+export function getStoreDir() {
+    return _lastStoreFilePath ? path.dirname(_lastStoreFilePath) : null;
+}
+// ============================================================
+// Transcript 文件路径解析
+// ============================================================
+/**
+ * 根据 sessionKey 找到对应的 .jsonl transcript 文件路径
+ *
+ * 路径解析优先级：
+ *   1. entry.sessionFile — 绝对路径 / 相对于 sessionsDir 的路径
+ *   2. sessionsDir/<sessionId>.jsonl — 标准 OPENCLAW_HOME 目录
+ *   3. storeDir/<sessionId>.jsonl — sessions.json 同级目录（离线分析场景）
+ */
+export function resolveTranscriptPath(sessionKey, agentId) {
+    const store = loadSessionStore(agentId);
+    const normalizedKey = sessionKey.trim().toLowerCase();
+    // 尝试精确匹配和 case-insensitive 匹配
+    const entry = store[sessionKey]
+        ?? store[normalizedKey]
+        ?? Object.entries(store).find(([k]) => k.toLowerCase() === normalizedKey)?.[1];
+    if (!entry?.sessionId)
+        return null;
+    const sessionsDir = resolveSessionsDir(agentId);
+    const jsonlFileName = `${entry.sessionId}.jsonl`;
+    // 第1层：使用 entry.sessionFile（精确路径）
+    if (entry.sessionFile) {
+        const sessionFilePath = path.isAbsolute(entry.sessionFile)
+            ? entry.sessionFile
+            : path.join(sessionsDir, entry.sessionFile);
+        if (fs.existsSync(sessionFilePath))
+            return sessionFilePath;
+        // sessionFile 是远程服务器的绝对路径，在本地不存在 → 继续回退
+    }
+    // 第2层：标准目录 <sessionsDir>/<sessionId>.jsonl
+    const defaultPath = path.join(sessionsDir, jsonlFileName);
+    if (fs.existsSync(defaultPath))
+        return defaultPath;
+    // 第3层：sessions.json 同级目录下查找
+    // 适用场景：用户将远程 session 文件下载到本地平铺目录
+    const storeDir = getStoreDir();
+    if (storeDir && storeDir !== sessionsDir) {
+        const siblingPath = path.join(storeDir, jsonlFileName);
+        if (fs.existsSync(siblingPath))
+            return siblingPath;
+    }
+    return null;
+}
+//# sourceMappingURL=session-store.js.map

package/dist/src/history/session-store.js.map

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

package/dist/src/history/text-processing.d.ts

@@ -0,0 +1,41 @@
+/**
+ * LightClaw — Text Processing
+ *
+ * 封装传输层元数据剥离和文件附件信息提取逻辑。
+ * 用于将 OpenClaw 注入的传输层前缀/后缀从用户消息中清除，
+ * 以及从原始消息文本中提取文件附件信息。
+ */
+import type { FileAttachmentInfo } from "./types.js";
+/**
+ * 剥离 OpenClaw 传输层注入到用户消息中的元数据前缀，提取用户真正的输入。
+ *
+ * 采用 **双层策略** 以通用应对不断变化的注入格式：
+ *
+ * **第一层 — 锚点截断（优先）：**
+ *   OpenClaw 注入的元数据遵循固定尾部结构：最后一个 `Xxx (untrusted metadata):` 块
+ *   之后即为用户真正输入。找到该锚点并截断，天然兼容前方任意 operator 前缀。
+ *
+ * **第二层 — 逐条正则剥离（后备）：**
+ *   当消息中不含 `(untrusted metadata)` 锚点时（如纯系统消息），回退到模式匹配。
+ */
+export declare function stripTransportMetadata(text: string): string;
+/**
+ * 剥离残留的传输层元数据片段。
+ *
+ * 用于：
+ *   1. 锚点截断后的残余清理
+ *   2. 不含 untrusted metadata 的消息的后备剥离
+ */
+export declare function stripResidualMetadata(text: string): string;
+/**
+ * 从用户消息文本中提取文件附件信息。
+ *
+ * 匹配 "用户发送了文件: xxx.png (3.0KB)" 格式。
+ * 以及 [media attached: .../name---uuid.ext (mime/type) | file://...] 格式。
+ */
+export declare function extractFileAttachments(text: string): FileAttachmentInfo[];
+/**
+ * 文件去重（按文件名）
+ */
+export declare function deduplicateFiles(files: FileAttachmentInfo[]): FileAttachmentInfo[];
+//# sourceMappingURL=text-processing.d.ts.map

package/dist/src/history/text-processing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-processing.d.ts","sourceRoot":"","sources":["../../../src/history/text-processing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMrD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsB3D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuC1D;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA2BzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAalF"}

package/dist/src/history/text-processing.js

@@ -0,0 +1,130 @@
+/**
+ * LightClaw — Text Processing
+ *
+ * 封装传输层元数据剥离和文件附件信息提取逻辑。
+ * 用于将 OpenClaw 注入的传输层前缀/后缀从用户消息中清除，
+ * 以及从原始消息文本中提取文件附件信息。
+ */
+// ============================================================
+// 传输元数据剥离
+// ============================================================
+/**
+ * 剥离 OpenClaw 传输层注入到用户消息中的元数据前缀，提取用户真正的输入。
+ *
+ * 采用 **双层策略** 以通用应对不断变化的注入格式：
+ *
+ * **第一层 — 锚点截断（优先）：**
+ *   OpenClaw 注入的元数据遵循固定尾部结构：最后一个 `Xxx (untrusted metadata):` 块
+ *   之后即为用户真正输入。找到该锚点并截断，天然兼容前方任意 operator 前缀。
+ *
+ * **第二层 — 逐条正则剥离（后备）：**
+ *   当消息中不含 `(untrusted metadata)` 锚点时（如纯系统消息），回退到模式匹配。
+ */
+export function stripTransportMetadata(text) {
+    if (!text)
+        return text;
+    // ── 第一层：锚点截断 ──
+    const hasUntrustedMeta = text.includes("(untrusted metadata)");
+    if (hasUntrustedMeta) {
+        const metaBlockRe = /\w[\w ]*\(untrusted metadata\):\s*```json\s*\{[^}]*\}\s*```/gs;
+        let lastEnd = -1;
+        let m;
+        while ((m = metaBlockRe.exec(text)) !== null) {
+            lastEnd = m.index + m[0].length;
+        }
+        if (lastEnd > 0 && lastEnd < text.length) {
+            const userPart = text.slice(lastEnd).replace(/^\s+/, "");
+            if (userPart) {
+                return stripResidualMetadata(userPart);
+            }
+        }
+    }
+    // ── 第二层（后备）：逐条正则剥离 ──
+    return stripResidualMetadata(text);
+}
+/**
+ * 剥离残留的传输层元数据片段。
+ *
+ * 用于：
+ *   1. 锚点截断后的残余清理
+ *   2. 不含 untrusted metadata 的消息的后备剥离
+ */
+export function stripResidualMetadata(text) {
+    if (!text)
+        return text;
+    let result = text;
+    // 移除 [media attached: ...] 行
+    result = result.replace(/^\[media attached:.*?\]\s*$/gm, "");
+    // 移除 "To send an image back, ..." 指令块
+    result = result.replace(/^To send an image back,.*?(?:Keep caption in the text body\.)\s*/gms, "");
+    // 移除 Xxx (untrusted metadata): ```json ... ``` 块
+    result = result.replace(/^\w[\w ]*\(untrusted metadata\):\s*```json\s*\{[^}]*\}\s*```\s*/gms, "");
+    // 移除 Xxx (operator configured): 后跟编号列表的块
+    result = result.replace(/^\w[\w ]*\(operator configured\):[\s\S]*?(?=\n\n(?![ \t]*\d+\.)|\n*$)/gm, "");
+    // 移除 HEARTBEAT_OK 行
+    result = result.replace(/^HEARTBEAT_OK\s*$/gm, "");
+    // 移除 System: [...] 异步任务完成回调通知行
+    result = result.replace(/^System:\s*\[.*?\].*$/gm, "");
+    // 移除内联 <file ...>...</file> 标签及其内容
+    result = result.replace(/<file\b[^>]*>.*?<\/file>/gs, "");
+    // 移除 "用户发送了文件: filename (size)" 描述文本
+    result = result.replace(/用户发送了文件:\s*.+?\s*\([^)]+\)\s*/g, "");
+    return result.trim();
+}
+// ============================================================
+// 文件附件提取
+// ============================================================
+/**
+ * 从用户消息文本中提取文件附件信息。
+ *
+ * 匹配 "用户发送了文件: xxx.png (3.0KB)" 格式。
+ * 以及 [media attached: .../name---uuid.ext (mime/type) | file://...] 格式。
+ */
+export function extractFileAttachments(text) {
+    const files = [];
+    // 从 "用户发送了文件: filename (size)" 提取
+    const userFileRe = /用户发送了文件:\s*(.+?)\s*\(([^)]+)\)/g;
+    let match;
+    while ((match = userFileRe.exec(text)) !== null) {
+        files.push({ name: match[1], size: match[2] });
+    }
+    // 从 [media attached: ...] 提取 MIME 和 URI
+    const mediaRe = /\[media attached:\s*\S+\s*\(([^)]+)\)\s*\|\s*(\S+)\s*\]/g;
+    let mediaIdx = 0;
+    while ((match = mediaRe.exec(text)) !== null) {
+        const mimeType = match[1];
+        const uri = match[2];
+        if (mediaIdx < files.length) {
+            files[mediaIdx].mimeType = mimeType;
+            files[mediaIdx].uri = uri;
+        }
+        else {
+            const uriFileName = uri.split("/").pop()?.replace(/---[0-9a-f-]+\./, ".") || "file";
+            files.push({ name: uriFileName, mimeType, uri });
+        }
+        mediaIdx++;
+    }
+    return files;
+}
+/**
+ * 文件去重（按文件名）
+ */
+export function deduplicateFiles(files) {
+    const seen = new Map();
+    for (const f of files) {
+        const existing = seen.get(f.name);
+        if (existing) {
+            if (!existing.mimeType && f.mimeType)
+                existing.mimeType = f.mimeType;
+            if (!existing.size && f.size)
+                existing.size = f.size;
+            if (!existing.uri && f.uri)
+                existing.uri = f.uri;
+        }
+        else {
+            seen.set(f.name, { ...f });
+        }
+    }
+    return [...seen.values()];
+}
+//# sourceMappingURL=text-processing.js.map

package/dist/src/history/text-processing.js.map

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