c0de-agent 0.0.0 → 1.1.0

package/dist/session/context.js

@@ -0,0 +1,173 @@
+import { getEntries } from './message.js';
+import { getFileSnapshots } from './snapshot.js';
+/**
+ * Drop tool messages whose id cannot be paired with an assistant tool_call,
+ * and inject synthetic tool results for orphan tool_calls (assistant 发出了
+ * tool_call 但无对应 tool result——服务重启中断场景）。
+ *
+ * OpenAI Chat 协议要求每个 role=tool 消息必须有 tool_call_id，且必须匹配
+ * 前面某条 assistant 消息的 tool_calls[].id。部分输出不规范的 provider
+ * 会产生空 id 的 tool_call/tool_result 碎片；这些碎片发回 provider 会触发
+ * "invalid tool_call_id"。这里在重建上下文时丢弃：
+ *   - assistant.toolCalls 里 id 为空的项（连带丢弃其后无法配对的 tool result）
+ *   - role=tool 但 toolCallId 为空、或找不到对应 assistant tool_call 的消息
+ * 正常（完整配对）的数据不受影响。
+ *
+ * 新增：assistant 有有效 tool_call 但后续无匹配 tool result（服务重启中断）时，
+ * 注入合成 tool result 告知模型工具被中断，而非丢弃 tool_call 让模型
+ * 盲目重试可能已产生副作用的非幂等工具。
+ */
+function sanitizeToolPairs(messages) {
+    // 收集所有有效的 assistant tool_call id（非空）
+    const validCallIds = new Set();
+    for (const m of messages) {
+        if (m.role === 'assistant' && m.toolCalls) {
+            for (const tc of m.toolCalls) {
+                if (tc.id)
+                    validCallIds.add(tc.id);
+            }
+        }
+    }
+    // 收集已有 tool result 配对的 tool_call id（用于检测孤儿 tool_call）
+    const answeredCallIds = new Set();
+    for (const m of messages) {
+        if (m.role === 'tool' && m.toolCallId && validCallIds.has(m.toolCallId)) {
+            answeredCallIds.add(m.toolCallId);
+        }
+    }
+    const result = [];
+    for (const m of messages) {
+        if (m.role === 'assistant' && m.toolCalls) {
+            // 丢弃 id 为空的 tool_call 项；若删空了则整个 toolCalls 移除
+            const filtered = m.toolCalls.filter((tc) => tc.id);
+            if (filtered.length === 0) {
+                result.push({ role: 'assistant', content: m.content });
+            }
+            else {
+                result.push({ ...m, toolCalls: filtered });
+                // 为无 result 配对的 tool_call 注入合成 result（服务中断场景）
+                for (const tc of filtered) {
+                    if (!answeredCallIds.has(tc.id)) {
+                        result.push({
+                            role: 'tool',
+                            toolCallId: tc.id,
+                            content: JSON.stringify({
+                                error: 'Tool execution was interrupted by server restart',
+                            }),
+                        });
+                    }
+                }
+            }
+            continue;
+        }
+        if (m.role === 'tool') {
+            // toolCallId 为空、或找不到对应 assistant tool_call：丢弃整条 tool 消息
+            if (!m.toolCallId || !validCallIds.has(m.toolCallId)) {
+                continue;
+            }
+        }
+        result.push(m);
+    }
+    return result;
+}
+/** Convert a stored Message to a protocol-level ChatMessage for the LLM. */
+function messageToChatMessage(msg) {
+    const textParts = msg.content
+        .filter((p) => p._tag === 'text' || p._tag === 'thinking')
+        .map((p) => (p._tag === 'thinking' ? `<think>${p.text}</think>` : p.text))
+        .join('');
+    const toolCalls = msg.content
+        .filter((p) => p._tag === 'tool_call')
+        .map((p) => ({
+        id: p.id,
+        name: p.tool,
+        arguments: JSON.stringify(p.input),
+    }));
+    const toolResultPart = msg.content.find((p) => p._tag === 'tool_result');
+    const imageParts = msg.content.filter((p) => p._tag === 'image');
+    // 含图片：构建多模态 content 数组（text 在前，image 在后）
+    if (imageParts.length > 0) {
+        const parts = [];
+        if (textParts)
+            parts.push({ type: 'text', text: textParts });
+        for (const img of imageParts) {
+            if (img._tag !== 'image')
+                continue;
+            parts.push({ type: 'image', mediaType: img.mediaType, data: img.data });
+        }
+        const multimodal = { role: msg.role, content: parts };
+        if (toolCalls.length > 0)
+            multimodal.toolCalls = toolCalls;
+        return multimodal;
+    }
+    // 无图片：保持原纯字符串逻辑（零回归）
+    const chat = {
+        role: msg.role,
+        content: textParts || (toolResultPart ? JSON.stringify(toolResultPart.output) : ''),
+    };
+    if (toolCalls.length > 0) {
+        chat.toolCalls = toolCalls;
+    }
+    if (toolResultPart && toolResultPart._tag === 'tool_result') {
+        chat.toolCallId = toolResultPart.id;
+        chat.content = JSON.stringify(toolResultPart.output);
+    }
+    return chat;
+}
+/** Convert all session entries (messages + special) to ChatMessage[] for the LLM. */
+function entriesToChatMessages(entries, snapshots) {
+    const messages = [];
+    for (const entry of entries) {
+        if (!('_tag' in entry)) {
+            messages.push(messageToChatMessage(entry));
+            continue;
+        }
+        switch (entry._tag) {
+            case 'compaction':
+            case 'squash':
+                messages.push({ role: 'system', content: `[Compacted History]\n${entry.summary}` });
+                break;
+            case 'branch_summary':
+                messages.push({ role: 'system', content: `[Branch Context]\n${entry.summary}` });
+                break;
+            case 'steering':
+                messages.push({ role: 'system', content: entry.content });
+                break;
+        }
+    }
+    return injectSnapshots(sanitizeToolPairs(messages), snapshots);
+}
+/** Inject file snapshot block after the first message (preserves cache prefix). */
+function injectSnapshots(messages, snapshots) {
+    if (snapshots.length === 0)
+        return messages;
+    // Keep only the highest-version snapshot per filePath (avoid stale duplicates).
+    const latestByPath = new Map();
+    for (const s of snapshots) {
+        const prev = latestByPath.get(s.filePath);
+        if (!prev || s.version > prev.version)
+            latestByPath.set(s.filePath, s);
+    }
+    const block = [...latestByPath.values()]
+        .map((s) => `[Cached File: ${s.filePath}]\n\`\`\`\n${s.content}\n\`\`\``)
+        .join('\n\n');
+    const snapshotMessage = {
+        role: 'system',
+        content: `[Active File Snapshots — DO NOT re-read these files]\n${block}`,
+    };
+    if (messages.length === 0)
+        return [snapshotMessage];
+    const first = messages[0];
+    if (!first)
+        return [snapshotMessage];
+    return [first, snapshotMessage, ...messages.slice(1)];
+}
+/** Get the full session context: all entries + file snapshots. */
+async function getSessionContext(handle, sessionId) {
+    const [entries, snapshots] = await Promise.all([
+        getEntries(handle, sessionId),
+        getFileSnapshots(handle, sessionId),
+    ]);
+    return { entries, snapshots };
+}
+export { entriesToChatMessages, getSessionContext, injectSnapshots, messageToChatMessage };

package/dist/session/index.d.ts

@@ -0,0 +1,10 @@
+export { archiveOriginalEntries, getArchive, getArchiveOriginalEntries, parseArchiveReference, resolveArchiveReference, searchArchives, } from './archive.js';
+export { forkSession, getBranches, getTree } from './branch.js';
+export { buildCompactionPrompt, compactSession, extractHotFiles, findSafeCutPoint, } from './compaction.js';
+export { entriesToChatMessages, getSessionContext, injectSnapshots, messageToChatMessage, } from './context.js';
+export { appendMessage, deleteEntriesByIds, deleteMessagesAfter, getEntries, getMessageCount, getMessages, insertEntry, } from './message.js';
+export { createSession, deleteSession, getLLMSegments, getSession, listSessions, migrateLegacyDetails, saveLLMSegments, segmentFingerprint, touchSession, updateSessionTitle, } from './session.js';
+export { checkFileSnapshot, getFileSnapshots, getLatestFileSnapshot, upsertFileSnapshot, } from './snapshot.js';
+export { squashRecent } from './squash.js';
+export { estimateMessageTokens, estimateTokens } from './token.js';
+export type { ArchiveRef, BranchSummaryEntry, CompactionArchive, CompactionConfig, CompactionEntry, CompactionResult, FileSnapshot, HotFile, MessageInput, SessionEntry, SessionTreeNode, SquashConfig, SquashEntry, SteeringEntry, Summarizer, } from './types.js';

package/dist/session/index.js

@@ -0,0 +1,10 @@
+// Session layer: conversation persistence, branching, compaction, and context reconstruction.
+export { archiveOriginalEntries, getArchive, getArchiveOriginalEntries, parseArchiveReference, resolveArchiveReference, searchArchives, } from './archive.js';
+export { forkSession, getBranches, getTree } from './branch.js';
+export { buildCompactionPrompt, compactSession, extractHotFiles, findSafeCutPoint, } from './compaction.js';
+export { entriesToChatMessages, getSessionContext, injectSnapshots, messageToChatMessage, } from './context.js';
+export { appendMessage, deleteEntriesByIds, deleteMessagesAfter, getEntries, getMessageCount, getMessages, insertEntry, } from './message.js';
+export { createSession, deleteSession, getLLMSegments, getSession, listSessions, migrateLegacyDetails, saveLLMSegments, segmentFingerprint, touchSession, updateSessionTitle, } from './session.js';
+export { checkFileSnapshot, getFileSnapshots, getLatestFileSnapshot, upsertFileSnapshot, } from './snapshot.js';
+export { squashRecent } from './squash.js';
+export { estimateMessageTokens, estimateTokens } from './token.js';

package/dist/session/message.d.ts

@@ -0,0 +1,22 @@
+import type { DB } from '../db/client.js';
+import { sessionEntries } from '../db/schema.js';
+import type { Message } from '../shared/types/message.js';
+import type { MessageInput, SessionEntry } from './types.js';
+/** Append a message to a session. Returns the stored Message with generated id/timestamp. */
+declare function appendMessage(handle: DB, sessionId: string, input: MessageInput): Promise<Message>;
+/** Get messages for a session (tag='message' only), ordered chronologically. */
+declare function getMessages(handle: DB, sessionId: string, opts?: {
+    limit?: number;
+    offset?: number;
+}): Promise<Message[]>;
+/** Count messages in a session. */
+declare function getMessageCount(handle: DB, sessionId: string): Promise<number>;
+/** Delete all messages after the given 0-based index (keeps 0..index inclusive). */
+declare function deleteMessagesAfter(handle: DB, sessionId: string, messageIndex: number): Promise<void>;
+/** Low-level: get ALL entries (messages + special) in chronological order. */
+declare function getEntries(handle: DB, sessionId: string): Promise<SessionEntry[]>;
+/** Low-level: delete entries by id. */
+declare function deleteEntriesByIds(handle: DB, ids: string[]): Promise<void>;
+/** Low-level: insert a raw entry row (for compaction/squash/branch_summary/steering). */
+declare function insertEntry(handle: DB, values: typeof sessionEntries.$inferInsert): Promise<typeof sessionEntries.$inferSelect>;
+export { appendMessage, deleteEntriesByIds, deleteMessagesAfter, getEntries, getMessageCount, getMessages, insertEntry, };

package/dist/session/message.js

@@ -0,0 +1,145 @@
+import { and, asc, count, eq, inArray } from 'drizzle-orm';
+import { sessionEntries } from '../db/schema.js';
+import { generateId } from '../shared/index.js';
+import { touchSession } from './session.js';
+import { estimateMessageTokens } from './token.js';
+/** Convert a Date-like DB value to epoch milliseconds. */
+function toEpochMs(value) {
+    if (value instanceof Date)
+        return value.getTime();
+    if (typeof value === 'number')
+        return value;
+    return new Date(value).getTime();
+}
+/** Convert a message-tagged row to a Message. */
+function rowToMessage(row) {
+    return {
+        id: row.id,
+        sessionId: row.sessionId,
+        role: row.role,
+        content: row.content,
+        tokenCount: row.tokenCount ?? 0,
+        createdAt: toEpochMs(row.createdAt),
+    };
+}
+/** Convert any row to a SessionEntry (dispatch on tag). */
+function rowToEntry(row) {
+    if (row.tag === 'message') {
+        return rowToMessage(row);
+    }
+    const content = row.content;
+    const createdAt = toEpochMs(row.createdAt);
+    switch (row.tag) {
+        case 'compaction':
+            return {
+                _tag: 'compaction',
+                id: row.id,
+                sessionId: row.sessionId,
+                summary: content.summary,
+                originalEntryIds: content.originalEntryIds,
+                archiveId: content.archiveId,
+                tokenCount: row.tokenCount ?? 0,
+                createdAt,
+            };
+        case 'squash':
+            return {
+                _tag: 'squash',
+                id: row.id,
+                sessionId: row.sessionId,
+                summary: content.summary,
+                squashedEntryIds: content.squashedEntryIds,
+                archiveId: content.archiveId,
+                tokenCount: row.tokenCount ?? 0,
+                createdAt,
+            };
+        case 'branch_summary':
+            return {
+                _tag: 'branch_summary',
+                id: row.id,
+                sessionId: row.sessionId,
+                summary: content.summary,
+                sourceSessionId: content.sourceSessionId,
+                createdAt,
+            };
+        case 'steering':
+            return {
+                _tag: 'steering',
+                id: row.id,
+                sessionId: row.sessionId,
+                content: content.text,
+                createdAt,
+            };
+        default:
+            // Fallback: treat unknown tags as messages
+            return rowToMessage(row);
+    }
+}
+/** Append a message to a session. Returns the stored Message with generated id/timestamp. */
+async function appendMessage(handle, sessionId, input) {
+    const tokenCount = input.tokenCount ?? estimateMessageTokens(input.content);
+    const [row] = await handle.db
+        .insert(sessionEntries)
+        .values({
+        id: generateId(),
+        sessionId,
+        tag: 'message',
+        role: input.role,
+        content: input.content,
+        tokenCount,
+    })
+        .returning();
+    await touchSession(handle, sessionId);
+    if (!row)
+        throw new Error('Failed to insert message');
+    return rowToMessage(row);
+}
+/** Get messages for a session (tag='message' only), ordered chronologically. */
+async function getMessages(handle, sessionId, opts) {
+    const rows = await handle.db
+        .select()
+        .from(sessionEntries)
+        .where(and(eq(sessionEntries.sessionId, sessionId), eq(sessionEntries.tag, 'message')))
+        .orderBy(asc(sessionEntries.createdAt))
+        .limit(opts?.limit ?? 100_000)
+        .offset(opts?.offset ?? 0);
+    return rows.map(rowToMessage);
+}
+/** Count messages in a session. */
+async function getMessageCount(handle, sessionId) {
+    const [result] = await handle.db
+        .select({ value: count() })
+        .from(sessionEntries)
+        .where(and(eq(sessionEntries.sessionId, sessionId), eq(sessionEntries.tag, 'message')));
+    return result?.value ?? 0;
+}
+/** Delete all messages after the given 0-based index (keeps 0..index inclusive). */
+async function deleteMessagesAfter(handle, sessionId, messageIndex) {
+    const messages = await getMessages(handle, sessionId);
+    const toDelete = messages.slice(messageIndex + 1);
+    if (toDelete.length > 0) {
+        await handle.db.delete(sessionEntries).where(inArray(sessionEntries.id, toDelete.map((m) => m.id)));
+    }
+}
+/** Low-level: get ALL entries (messages + special) in chronological order. */
+async function getEntries(handle, sessionId) {
+    const rows = await handle.db
+        .select()
+        .from(sessionEntries)
+        .where(eq(sessionEntries.sessionId, sessionId))
+        .orderBy(asc(sessionEntries.createdAt));
+    return rows.map(rowToEntry);
+}
+/** Low-level: delete entries by id. */
+async function deleteEntriesByIds(handle, ids) {
+    if (ids.length === 0)
+        return;
+    await handle.db.delete(sessionEntries).where(inArray(sessionEntries.id, ids));
+}
+/** Low-level: insert a raw entry row (for compaction/squash/branch_summary/steering). */
+async function insertEntry(handle, values) {
+    const [row] = await handle.db.insert(sessionEntries).values(values).returning();
+    if (!row)
+        throw new Error('Failed to insert entry');
+    return row;
+}
+export { appendMessage, deleteEntriesByIds, deleteMessagesAfter, getEntries, getMessageCount, getMessages, insertEntry, };

package/dist/session/session.d.ts

@@ -0,0 +1,37 @@
+import type { DB } from '../db/client.js';
+import { sessions } from '../db/schema.js';
+import type { LLMSegment } from '../shared/types/agent.js';
+import type { ChatTool } from '../shared/types/llm.js';
+import type { LastRun, Session } from '../shared/types/message.js';
+/** Convert a DB row (with Date timestamps) to the shared Session type (with number timestamps). */
+export declare function rowToSession(row: typeof sessions.$inferSelect): Session;
+/** Create a new root session. */
+declare function createSession(handle: DB, title: string, projectId?: string, agentType?: string): Promise<Session>;
+/** Get a session by id, or null if not found. */
+declare function getSession(handle: DB, id: string): Promise<Session | null>;
+/** List all sessions. */
+declare function listSessions(handle: DB): Promise<Session[]>;
+/** Delete a session (cascades to entries, archives, snapshots via FK). */
+declare function deleteSession(handle: DB, id: string): Promise<void>;
+/** Update a session's title. */
+declare function updateSessionTitle(handle: DB, id: string, title: string): Promise<void>;
+/** Bump updatedAt to now (used after appending messages). */
+declare function touchSession(handle: DB, id: string): Promise<void>;
+/** 规格化工具集并计算前缀指纹。tools 顺序不影响指纹（按 name 排序）。 */
+export declare function segmentFingerprint(systemPrompt: string, tools: ChatTool[]): string;
+/**
+ * 将旧 metadata.llmDetails 迁移为单个 legacy segment。
+ * - 无 llmDetails 或已有 segments → 原样返回。
+ * - 否则取首条的 systemPrompt/tools 作为段首快照，所有旧 detail 转为 calls，
+ *   responseText 从 responseChunks 的 text 块拼接提取。
+ * 幂等：迁移后 llmDetails 字段被移除，不会重复迁移。
+ */
+export declare function migrateLegacyDetails(meta: Record<string, unknown>): Record<string, unknown>;
+/** 读取会话 metadata.segments（读取时顺带迁移旧 llmDetails）。 */
+export declare function getLLMSegments(handle: DB, id: string): Promise<LLMSegment[]>;
+/** 全量替换会话 metadata.segments（每轮 loop 结束写入；段数据轻量）。 */
+export declare function saveLLMSegments(handle: DB, id: string, segments: LLMSegment[]): Promise<void>;
+/** 更新会话 metadata.lastRun（agent run 开始/结束时写入；重启后检测中断用）。 */
+declare function updateSessionLastRun(handle: DB, id: string, lastRun: LastRun): Promise<void>;
+declare function listSessionsByProject(handle: DB, projectId: string): Promise<Session[]>;
+export { createSession, deleteSession, getSession, listSessions, listSessionsByProject, touchSession, updateSessionLastRun, updateSessionTitle, };

package/dist/session/session.js

@@ -0,0 +1,144 @@
+import { eq } from 'drizzle-orm';
+import { sessions } from '../db/schema.js';
+import { generateId } from '../shared/index.js';
+/** Convert a DB row (with Date timestamps) to the shared Session type (with number timestamps). */
+export function rowToSession(row) {
+    const created = row.createdAt instanceof Date ? row.createdAt.getTime() : new Date(row.createdAt).getTime();
+    const updated = row.updatedAt instanceof Date ? row.updatedAt.getTime() : new Date(row.updatedAt).getTime();
+    return {
+        id: row.id,
+        title: row.title,
+        parentId: row.parentId,
+        projectId: row.projectId,
+        branchPoint: row.branchPoint,
+        metadata: (row.metadata ?? {}),
+        agentType: row.agentType ?? null,
+        worktreePath: row.worktreePath ?? null,
+        createdAt: created,
+        updatedAt: updated,
+    };
+}
+/** Create a new root session. */
+async function createSession(handle, title, projectId, agentType) {
+    const [row] = await handle.db
+        .insert(sessions)
+        .values({ title, projectId: projectId ?? null, agentType: agentType ?? null })
+        .returning();
+    if (!row)
+        throw new Error('Failed to insert session');
+    return rowToSession(row);
+}
+/** Get a session by id, or null if not found. */
+async function getSession(handle, id) {
+    const [row] = await handle.db.select().from(sessions).where(eq(sessions.id, id));
+    return row ? rowToSession(row) : null;
+}
+/** List all sessions. */
+async function listSessions(handle) {
+    const rows = await handle.db.select().from(sessions);
+    return rows.map(rowToSession);
+}
+/** Delete a session (cascades to entries, archives, snapshots via FK). */
+async function deleteSession(handle, id) {
+    await handle.db.delete(sessions).where(eq(sessions.id, id));
+}
+/** Update a session's title. */
+async function updateSessionTitle(handle, id, title) {
+    await handle.db.update(sessions).set({ title, updatedAt: new Date() }).where(eq(sessions.id, id));
+}
+/** Bump updatedAt to now (used after appending messages). */
+async function touchSession(handle, id) {
+    await handle.db.update(sessions).set({ updatedAt: new Date() }).where(eq(sessions.id, id));
+}
+/** 规格化工具集并计算前缀指纹。tools 顺序不影响指纹（按 name 排序）。 */
+export function segmentFingerprint(systemPrompt, tools) {
+    const norm = JSON.stringify({
+        systemPrompt,
+        tools: [...tools]
+            .map((t) => ({ name: t.name, description: t.description, parameters: t.parameters }))
+            .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0)),
+    });
+    let h = 5381;
+    for (let i = 0; i < norm.length; i++)
+        h = ((h << 5) + h + norm.charCodeAt(i)) | 0;
+    return (h >>> 0).toString(16);
+}
+/**
+ * 将旧 metadata.llmDetails 迁移为单个 legacy segment。
+ * - 无 llmDetails 或已有 segments → 原样返回。
+ * - 否则取首条的 systemPrompt/tools 作为段首快照，所有旧 detail 转为 calls，
+ *   responseText 从 responseChunks 的 text 块拼接提取。
+ * 幂等：迁移后 llmDetails 字段被移除，不会重复迁移。
+ */
+export function migrateLegacyDetails(meta) {
+    if (meta.segments !== undefined)
+        return meta;
+    const legacy = meta.llmDetails;
+    if (!Array.isArray(legacy) || legacy.length === 0)
+        return meta;
+    const first = legacy[0];
+    const segment = {
+        id: generateId(),
+        fingerprint: segmentFingerprint(first.systemPrompt, first.tools ?? []),
+        provider: first.provider,
+        model: first.model,
+        systemPrompt: first.systemPrompt,
+        tools: first.tools ?? [],
+        startedAt: first.timestamp,
+        trigger: 'initial',
+        ...(first.contextWindow !== undefined ? { contextWindow: first.contextWindow } : {}),
+        calls: legacy.map((d) => {
+            const detail = d;
+            return {
+                id: detail.id,
+                timestamp: detail.timestamp,
+                usage: detail.usage,
+                latency: detail.latency,
+                cost: detail.cost,
+                ...(detail.thinking ? { thinking: detail.thinking } : {}),
+                responseText: (detail.responseChunks ?? [])
+                    .map((c) => (c._tag === 'text' && typeof c.text === 'string' ? c.text : ''))
+                    .join(''),
+            };
+        }),
+    };
+    const { llmDetails: _omit, ...rest } = meta;
+    return { ...rest, segments: [segment] };
+}
+/** 读取会话 metadata.segments（读取时顺带迁移旧 llmDetails）。 */
+export async function getLLMSegments(handle, id) {
+    const [row] = await handle.db.select().from(sessions).where(eq(sessions.id, id));
+    if (!row)
+        return [];
+    const meta = migrateLegacyDetails((row.metadata ?? {}));
+    return meta.segments ?? [];
+}
+/** 全量替换会话 metadata.segments（每轮 loop 结束写入；段数据轻量）。 */
+export async function saveLLMSegments(handle, id, segments) {
+    const [row] = await handle.db.select().from(sessions).where(eq(sessions.id, id));
+    if (!row)
+        return;
+    const meta = migrateLegacyDetails((row.metadata ?? {}));
+    const { segments: _omit, ...rest } = meta;
+    const next = { ...rest, segments };
+    await handle.db
+        .update(sessions)
+        .set({ metadata: next, updatedAt: new Date() })
+        .where(eq(sessions.id, id));
+}
+/** 更新会话 metadata.lastRun（agent run 开始/结束时写入；重启后检测中断用）。 */
+async function updateSessionLastRun(handle, id, lastRun) {
+    const [row] = await handle.db.select().from(sessions).where(eq(sessions.id, id));
+    if (!row)
+        return;
+    const meta = (row.metadata ?? {});
+    await handle.db
+        .update(sessions)
+        .set({ metadata: { ...meta, lastRun }, updatedAt: new Date() })
+        .where(eq(sessions.id, id));
+}
+async function listSessionsByProject(handle, projectId) {
+    const rows = await handle.db.select().from(sessions).where(eq(sessions.projectId, projectId));
+    return rows.map(rowToSession);
+}
+export { createSession, deleteSession, getSession, listSessions, listSessionsByProject, touchSession, updateSessionLastRun, updateSessionTitle, };

package/dist/session/shake.d.ts

@@ -0,0 +1,66 @@
+import type { Message } from '../shared/types/message.js';
+export interface ShakeConfig {
+    /** 保护最近 N token 的上下文不被 shake。 */
+    protectTokens: number;
+    /** 总节省 token < minSavings 时不 shake（preview 路径用）。 */
+    minSavings: number;
+    /** fenced/XML block 的最小 token 阈值。 */
+    fenceMinTokens: number;
+    /** 受保护的工具名列表（其 tool_result 不被 shake）。 */
+    protectedTools: string[];
+}
+/** Auto-shake 默认配置：保护活跃尾部，保守阈值。 */
+export declare const DEFAULT_SHAKE_CONFIG: ShakeConfig;
+export type ShakeRegion = {
+    kind: 'toolResult';
+    id: string;
+    messageId: string;
+    messageIndex: number;
+    partIndex: number;
+    tokens: number;
+    originalText: string;
+    label: string;
+    /** tool_call_id（tool_result part.id），前端用于跨消息合并后匹配渲染块。 */
+    toolCallId: string;
+} | {
+    kind: 'block';
+    id: string;
+    messageId: string;
+    messageIndex: number;
+    partIndex: number;
+    start: number;
+    end: number;
+    tokens: number;
+    originalText: string;
+    label: string;
+};
+/** API 返回给前端的区域视图。 */
+export type ShakeRegionView = {
+    id: string;
+    kind: 'toolResult' | 'block';
+    messageId: string;
+    messageIndex: number;
+    partIndex: number;
+    tokens: number;
+    label: string;
+    preview: string;
+    placeholder: string;
+    isAfterProtectWindow: boolean;
+    /** tool_result 的 tool_call_id（仅 toolResult 类别），前端跨消息合并后匹配渲染块。 */
+    toolCallId?: string;
+};
+/**
+ * 定位 fenced 代码块和顶层 XML 元素 span。返回字符偏移 [start, end) 数组，
+ * 覆盖完整块（含围栏/标签行，不含尾换行）。围栏内抑制 XML 检测。
+ * 未闭合围栏/标签不产生 range（保守策略）。
+ */
+export declare function scanTextForBlockRanges(text: string): Array<{
+    start: number;
+    end: number;
+}>;
+/** 收集可 shake 的区域。纯函数，不修改输入。 */
+export declare function collectShakeRegions(messages: Message[], config: ShakeConfig): ShakeRegion[];
+/** 原位替换选中区域。返回新数组，不修改原数组。 */
+export declare function applyShakeRegions(messages: Message[], regions: ShakeRegion[]): Message[];
+/** 区域转 API 视图。protectWindow 窗口内的标记 isAfterProtectWindow=false。 */
+export declare function toRegionViews(regions: ShakeRegion[], config: ShakeConfig, messages: Message[]): ShakeRegionView[];