@downcity/agent 1.1.32 → 1.1.43

package/bin/session/SessionSystemBuilder.js

@@ -0,0 +1,147 @@
+/**
+ * SDK Session 默认 system composer。
+ *
+ * 关键点（中文）
+ * - 面向 `Agent` SDK 的本地会话执行场景。
+ * - 注入调用方显式传入的静态 instruction、受托管 plugin system 与显式注册 plugin system。
+ * - SDK 不在 system 中注入动态变量；动态上下文应由调用方放入 user message。
+ */
+import { getSessionRunScope } from "../executor/SessionRunScope.js";
+function normalizeSystemBlocks(blocks) {
+    if (!Array.isArray(blocks))
+        return [];
+    return blocks
+        .map((block) => {
+        const content = String(block?.content || "").trim();
+        if (!content)
+            return null;
+        const source = block.source;
+        if (source !== "core" &&
+            source !== "instruction" &&
+            source !== "plugin" &&
+            source !== "session") {
+            return null;
+        }
+        return {
+            source,
+            name: String(block.name || source).trim() || source,
+            content,
+        };
+    })
+        .filter((block) => Boolean(block));
+}
+function createSessionInfo(params) {
+    const createdAt = Number.isFinite(params.createdAt) ? params.createdAt : 0;
+    return {
+        agentId: String(params.agentId || "").trim(),
+        sessionId: String(params.sessionId || "").trim(),
+        projectRoot: String(params.projectRoot || "").trim(),
+        createdAt: new Date(createdAt).toISOString(),
+        timezone: String(params.timezone || "").trim() || "UTC",
+    };
+}
+function createSessionSystemBlock(session) {
+    const content = [
+        "当前会话上下文：",
+        `你正在服务 agent "${session.agentId}" 的 session "${session.sessionId}"。`,
+        `当前项目根目录是 "${session.projectRoot}"。`,
+        `本会话创建于 ${session.createdAt}，参考时区是 ${session.timezone}。`,
+        "这个创建时间是当前会话的稳定参考时间，不代表每轮运行时的当前时间。",
+        "如果用户消息中提供了新的当前时间、相对时间或其他动态上下文，应优先使用用户消息中的动态信息。",
+    ].join("\n");
+    return {
+        source: "session",
+        name: "context",
+        content,
+    };
+}
+/**
+ * 解析 SDK session 当前生效的 system blocks。
+ */
+export async function buildSessionSystemBlocks(params) {
+    const agentId = String(params.agentId || "").trim();
+    const projectRoot = String(params.projectRoot || "").trim();
+    const sessionId = String(params.sessionId || "").trim();
+    const createdAt = Number(params.createdAt || 0);
+    const timezone = String(params.timezone || "").trim();
+    if (!agentId) {
+        throw new Error("buildSessionSystemBlocks requires a non-empty agentId");
+    }
+    if (!projectRoot) {
+        throw new Error("buildSessionSystemBlocks requires a non-empty projectRoot");
+    }
+    if (!sessionId) {
+        throw new Error("buildSessionSystemBlocks requires a non-empty sessionId");
+    }
+    if (!Number.isFinite(createdAt) || createdAt <= 0) {
+        throw new Error("buildSessionSystemBlocks requires a valid createdAt");
+    }
+    if (!timezone) {
+        throw new Error("buildSessionSystemBlocks requires a non-empty timezone");
+    }
+    return [
+        ...normalizeSystemBlocks(params.getInstructionSystemBlocks()),
+        ...normalizeSystemBlocks(await params.getManagedPluginSystemBlocks()),
+        ...normalizeSystemBlocks(await params.getPluginSystemBlocks()),
+        // session block 放在最后，尽量保留前缀 system blocks 的跨 session 缓存命中。
+        createSessionSystemBlock(createSessionInfo({ agentId, projectRoot, sessionId, createdAt, timezone })),
+    ];
+}
+/**
+ * 解析 SDK session 当前生效的 system messages。
+ */
+export async function buildSessionSystemMessages(params) {
+    const blocks = await buildSessionSystemBlocks(params);
+    return blocks.map((block) => ({
+        role: "system",
+        content: block.content,
+    }));
+}
+/**
+ * SDK Session system composer 实现。
+ */
+export class SessionSystemBuilder {
+    name = "sdk_prompt_system";
+    agentId;
+    projectRoot;
+    getSessionCreatedAt;
+    getSessionTimezone;
+    getInstructionSystemBlocks;
+    getManagedPluginSystemBlocks;
+    getPluginSystemBlocks;
+    constructor(options) {
+        this.agentId = String(options.agentId || "").trim();
+        this.projectRoot = String(options.projectRoot || "").trim();
+        this.getSessionCreatedAt = options.getSessionCreatedAt;
+        this.getSessionTimezone = options.getSessionTimezone;
+        this.getInstructionSystemBlocks = options.getInstructionSystemBlocks;
+        this.getManagedPluginSystemBlocks = options.getManagedPluginSystemBlocks;
+        this.getPluginSystemBlocks = options.getPluginSystemBlocks;
+        if (!this.agentId) {
+            throw new Error("SessionSystemBuilder requires a non-empty agentId");
+        }
+        if (!this.projectRoot) {
+            throw new Error("SessionSystemBuilder requires a non-empty projectRoot");
+        }
+    }
+    /**
+     * 解析本轮 SDK session system messages。
+     */
+    async resolve() {
+        const sessionId = String(getSessionRunScope()?.sessionId || "").trim();
+        if (!sessionId) {
+            throw new Error("SessionSystemBuilder.resolve requires a non-empty sessionId");
+        }
+        return await buildSessionSystemMessages({
+            agentId: this.agentId,
+            projectRoot: this.projectRoot,
+            sessionId,
+            createdAt: this.getSessionCreatedAt(),
+            timezone: this.getSessionTimezone(),
+            getInstructionSystemBlocks: this.getInstructionSystemBlocks,
+            getManagedPluginSystemBlocks: this.getManagedPluginSystemBlocks,
+            getPluginSystemBlocks: this.getPluginSystemBlocks,
+        });
+    }
+}
+//# sourceMappingURL=SessionSystemBuilder.js.map

package/bin/session/SessionSystemBuilder.js.map

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

package/bin/session/browse/Browse.d.ts

@@ -0,0 +1,76 @@
+/**
+ * SDK Session 浏览辅助。
+ *
+ * 关键点（中文）
+ * - 统一负责 session 列表摘要、session 详情与 history 分页的只读投影逻辑。
+ * - 面向 SDK / RemoteAgent / HTTP route 复用，避免在多个入口重复拼列表与分页语义。
+ * - 这里不持有运行态状态；执行状态等动态信息通过调用参数显式注入。
+ */
+import type { AgentListSessionsInput, AgentSessionHistoryInput, AgentSessionHistoryPage, AgentSessionInfo, AgentSessionSummaryPage, AgentSessionTimelineEvent } from "../../types/agent/AgentTypes.js";
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+import type { SessionHistoryMetaV1 } from "../../executor/types/SessionHistoryMeta.js";
+type SessionBrowseBaseInput = {
+    /**
+     * 当前项目根目录。
+     */
+    projectRoot: string;
+    /**
+     * 当前 agentId。
+     */
+    agentId: string;
+    /**
+     * 当前 sessionId。
+     */
+    sessionId: string;
+    /**
+     * 当前 session 已读取到的 metadata。
+     */
+    metadata: SessionHistoryMetaV1;
+    /**
+     * 当前 session 已读取到的完整消息。
+     */
+    messages: SessionMessageV1[];
+    /**
+     * 当前 session 是否正在执行。
+     */
+    executing?: boolean;
+};
+/**
+ * 解析单条 session 消息的用户可见预览文本。
+ */
+export declare function resolveSessionMessagePreview(message: SessionMessageV1): string;
+/**
+ * 推导当前 session 的可读标题。
+ */
+export declare function resolveSessionTitle(messages: SessionMessageV1[]): string | undefined;
+/**
+ * 把单条 session message 展平成时间线事件。
+ */
+export declare function toSessionTimelineEvents(message: SessionMessageV1): AgentSessionTimelineEvent[];
+/**
+ * 读取指定 JSONL 消息文件。
+ */
+export declare function loadSessionMessagesFromPath(filePath: string): Promise<SessionMessageV1[]>;
+/**
+ * 基于 metadata + messages 构建 SDK session 详情。
+ */
+export declare function buildSessionInfo(input: SessionBrowseBaseInput): AgentSessionInfo;
+/**
+ * 基于完整消息列表构建 session history 分页结果。
+ */
+export declare function buildSessionHistoryPage(params: {
+    session: AgentSessionInfo;
+    messages: SessionMessageV1[];
+    input?: AgentSessionHistoryInput;
+}): AgentSessionHistoryPage;
+/**
+ * 列出指定 agent 的 session 摘要页。
+ */
+export declare function listAgentSessionSummaryPage(params: {
+    projectRoot: string;
+    agentId: string;
+    input?: AgentListSessionsInput;
+    executingSessionIds?: Set<string>;
+}): Promise<AgentSessionSummaryPage>;
+export {};
+//# sourceMappingURL=Browse.d.ts.map

package/bin/session/browse/Browse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Browse.d.ts","sourceRoot":"","sources":["../../../src/session/browse/Browse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EAEvB,gBAAgB,EAEhB,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAkBnF,KAAK,sBAAsB,GAAG;IAC5B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,oBAAoB,CAAC;IAE/B;;OAEG;IACH,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AA2FF;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAQ9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,GAAG,SAAS,CASpF;AAgDD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,gBAAgB,GACxB,yBAAyB,EAAE,CA+E7B;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgB7B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,sBAAsB,GAC5B,gBAAgB,CA4BlB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC,GAAG,uBAAuB,CAqC1B;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACnC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA8EnC"}

package/bin/session/browse/Browse.js

@@ -0,0 +1,418 @@
+/**
+ * SDK Session 浏览辅助。
+ *
+ * 关键点（中文）
+ * - 统一负责 session 列表摘要、session 详情与 history 分页的只读投影逻辑。
+ * - 面向 SDK / RemoteAgent / HTTP route 复用，避免在多个入口重复拼列表与分页语义。
+ * - 这里不持有运行态状态；执行状态等动态信息通过调用参数显式注入。
+ */
+import fs from "fs-extra";
+import { getToolName, isTextUIPart, isToolUIPart, } from "ai";
+import { pickLastSuccessfulChatSendText } from "../../executor/messages/UserVisibleText.js";
+import { getSdkAgentSessionMessagesPath } from "../../session/storage/Paths.js";
+import { getSdkAgentSessionsRootDirPath } from "../../session/storage/Paths.js";
+import { readSessionMetadata } from "../../session/storage/Metadata.js";
+function decodeMaybe(input) {
+    try {
+        return decodeURIComponent(input);
+    }
+    catch {
+        return input;
+    }
+}
+function normalizeLimit(input, fallback, max) {
+    const value = typeof input === "number" && Number.isFinite(input)
+        ? input
+        : typeof input === "string" && input.trim()
+            ? Number(input)
+            : NaN;
+    if (!Number.isFinite(value))
+        return fallback;
+    return Math.max(1, Math.min(max, Math.floor(value)));
+}
+function truncateText(input, maxChars) {
+    const value = String(input || "").trim();
+    if (!value)
+        return "";
+    if (value.length <= maxChars)
+        return value;
+    return `${value.slice(0, Math.max(0, maxChars - 1)).trimEnd()}…`;
+}
+function normalizeCursor(input) {
+    const raw = String(input || "").trim();
+    if (!raw)
+        return 0;
+    const value = Number(raw);
+    if (!Number.isFinite(value) || value < 0)
+        return 0;
+    return Math.floor(value);
+}
+function encodeCursor(offset) {
+    if (!Number.isFinite(offset) || offset <= 0)
+        return undefined;
+    return String(Math.floor(offset));
+}
+function stringifyForDisplay(input, maxChars = 2400) {
+    if (input === undefined)
+        return "";
+    if (input === null)
+        return "null";
+    if (typeof input === "string") {
+        const value = input.trim();
+        if (!value)
+            return "";
+        try {
+            const parsed = JSON.parse(value);
+            return truncateText(JSON.stringify(parsed, null, 2), maxChars);
+        }
+        catch {
+            return truncateText(value, maxChars);
+        }
+    }
+    if (typeof input === "number" || typeof input === "boolean") {
+        return truncateText(String(input), maxChars);
+    }
+    try {
+        return truncateText(JSON.stringify(input, null, 2), maxChars);
+    }
+    catch {
+        return truncateText(String(input), maxChars);
+    }
+}
+function extractMessageText(parts) {
+    if (!Array.isArray(parts))
+        return "";
+    const texts = [];
+    for (const part of parts) {
+        if (!part || typeof part !== "object")
+            continue;
+        const textPart = part;
+        if (textPart.type !== "text" || typeof textPart.text !== "string")
+            continue;
+        const text = textPart.text.trim();
+        if (!text)
+            continue;
+        texts.push(text);
+    }
+    return texts.join("\n").trim();
+}
+function extractAssistantToolSummary(message) {
+    if (!Array.isArray(message.parts))
+        return "";
+    const toolNames = new Set();
+    for (const part of message.parts) {
+        if (!part || typeof part !== "object")
+            continue;
+        if (!isToolUIPart(part))
+            continue;
+        const toolName = String(getToolName(part) || "").trim();
+        if (toolName)
+            toolNames.add(toolName);
+    }
+    if (toolNames.size === 0)
+        return "";
+    return `[tool] ${Array.from(toolNames).join(", ")}`;
+}
+/**
+ * 解析单条 session 消息的用户可见预览文本。
+ */
+export function resolveSessionMessagePreview(message) {
+    const plainText = extractMessageText(message.parts);
+    if (plainText)
+        return plainText;
+    if (message.role !== "assistant")
+        return "";
+    const userVisible = pickLastSuccessfulChatSendText(message).trim();
+    if (userVisible)
+        return userVisible;
+    return extractAssistantToolSummary(message);
+}
+/**
+ * 推导当前 session 的可读标题。
+ */
+export function resolveSessionTitle(messages) {
+    for (const message of messages) {
+        if (message.role !== "user")
+            continue;
+        const preview = resolveSessionMessagePreview(message);
+        if (!preview)
+            continue;
+        return truncateText(preview, 80);
+    }
+    const fallback = messages[0] ? resolveSessionMessagePreview(messages[0]) : "";
+    return fallback ? truncateText(fallback, 80) : undefined;
+}
+function resolveToolName(part, aiToolName) {
+    const fromAi = String(aiToolName || "").trim();
+    if (fromAi)
+        return fromAi;
+    const rawType = typeof part.type === "string" ? part.type.trim() : "";
+    if (rawType.startsWith("tool-"))
+        return rawType.slice("tool-".length);
+    return "unknown_tool";
+}
+function extractToolCallInput(part) {
+    return part.input ?? undefined;
+}
+function extractToolResultOutput(part) {
+    const state = typeof part.state === "string" ? part.state.trim() : "";
+    if (state === "output-available")
+        return part.output;
+    if (state === "output-error") {
+        return { error: part.errorText ?? part.error ?? "tool_error" };
+    }
+    if (state === "output-denied") {
+        return {
+            error: "tool_denied",
+            reason: part.approval?.reason ?? "",
+        };
+    }
+    return undefined;
+}
+function toTimelineEvent(params) {
+    const metadata = (params.message.metadata || null);
+    return {
+        id: `${String(params.message.id || "")}:${params.sequence}`,
+        role: params.role,
+        ...(typeof metadata?.ts === "number" ? { ts: metadata.ts } : {}),
+        ...(typeof metadata?.kind === "string" ? { kind: metadata.kind } : {}),
+        ...(typeof metadata?.source === "string" ? { source: metadata.source } : {}),
+        text: params.text,
+        ...(params.toolName ? { toolName: params.toolName } : {}),
+    };
+}
+/**
+ * 把单条 session message 展平成时间线事件。
+ */
+export function toSessionTimelineEvents(message) {
+    if (message.role !== "assistant") {
+        return [
+            toTimelineEvent({
+                message,
+                role: message.role === "user" ? "user" : "assistant",
+                text: resolveSessionMessagePreview(message),
+                sequence: 0,
+            }),
+        ];
+    }
+    const parts = Array.isArray(message.parts)
+        ? message.parts
+        : [];
+    const events = [];
+    let sequence = 0;
+    for (const part of parts) {
+        if (!part || typeof part !== "object")
+            continue;
+        const partObject = part;
+        if (isTextUIPart(part)) {
+            const text = String(part.text || "").trim();
+            if (!text)
+                continue;
+            events.push(toTimelineEvent({
+                message,
+                role: "assistant",
+                text,
+                sequence,
+            }));
+            sequence += 1;
+            continue;
+        }
+        if (isToolUIPart(part)) {
+            const toolName = resolveToolName(partObject, String(getToolName(part) || ""));
+            const inputText = stringifyForDisplay(extractToolCallInput(partObject));
+            events.push(toTimelineEvent({
+                message,
+                role: "tool-call",
+                text: inputText || "(empty)",
+                sequence,
+                toolName,
+            }));
+            sequence += 1;
+            const output = extractToolResultOutput(partObject);
+            if (output !== undefined) {
+                events.push(toTimelineEvent({
+                    message,
+                    role: "tool-result",
+                    text: stringifyForDisplay(output) || "(empty)",
+                    sequence,
+                    toolName,
+                }));
+                sequence += 1;
+            }
+        }
+    }
+    if (events.length === 0) {
+        events.push(toTimelineEvent({
+            message,
+            role: "assistant",
+            text: resolveSessionMessagePreview(message),
+            sequence: 0,
+        }));
+    }
+    return events;
+}
+/**
+ * 读取指定 JSONL 消息文件。
+ */
+export async function loadSessionMessagesFromPath(filePath) {
+    if (!(await fs.pathExists(filePath)))
+        return [];
+    const raw = await fs.readFile(filePath, "utf-8");
+    const lines = raw.split("\n").filter(Boolean);
+    const messages = [];
+    for (const line of lines) {
+        try {
+            const parsed = JSON.parse(line);
+            if (!parsed || typeof parsed !== "object")
+                continue;
+            if (parsed.role !== "user" && parsed.role !== "assistant")
+                continue;
+            messages.push(parsed);
+        }
+        catch {
+            // 关键点（中文）：单行损坏不影响整个 session 的可读性。
+        }
+    }
+    return messages;
+}
+/**
+ * 基于 metadata + messages 构建 SDK session 详情。
+ */
+export function buildSessionInfo(input) {
+    const previewText = input.messages.length > 0
+        ? truncateText(resolveSessionMessagePreview(input.messages[input.messages.length - 1]), 180)
+        : undefined;
+    const title = resolveSessionTitle(input.messages);
+    return {
+        agentId: input.agentId,
+        sessionId: input.sessionId,
+        ...(title ? { title } : {}),
+        ...(previewText ? { previewText } : {}),
+        messageCount: input.messages.length,
+        ...(typeof input.metadata.createdAt === "number"
+            ? { createdAt: input.metadata.createdAt }
+            : {}),
+        ...(typeof input.metadata.updatedAt === "number"
+            ? { updatedAt: input.metadata.updatedAt }
+            : {}),
+        ...(input.metadata.sdkConfig?.modelLabel
+            ? { modelLabel: input.metadata.sdkConfig.modelLabel }
+            : {}),
+        ...(typeof input.metadata.timezone === "string" && input.metadata.timezone.trim()
+            ? { timezone: input.metadata.timezone.trim() }
+            : {}),
+        ...(input.executing ? { executing: true } : {}),
+    };
+}
+/**
+ * 基于完整消息列表构建 session history 分页结果。
+ */
+export function buildSessionHistoryPage(params) {
+    const view = params.input?.view || "message";
+    const order = params.input?.order || "asc";
+    const limit = normalizeLimit(params.input?.limit, 50, 500);
+    const cursor = normalizeCursor(params.input?.cursor);
+    if (view === "timeline") {
+        const allEvents = params.messages.flatMap((message) => toSessionTimelineEvents(message));
+        const orderedEvents = order === "desc" ? [...allEvents].reverse() : allEvents;
+        const pageItems = orderedEvents.slice(cursor, cursor + limit);
+        const nextOffset = cursor + pageItems.length;
+        return {
+            session: params.session,
+            view,
+            items: pageItems,
+            total: orderedEvents.length,
+            ...(nextOffset < orderedEvents.length
+                ? { nextCursor: encodeCursor(nextOffset) }
+                : {}),
+            hasMore: nextOffset < orderedEvents.length,
+        };
+    }
+    const orderedMessages = order === "desc" ? [...params.messages].reverse() : [...params.messages];
+    const pageItems = orderedMessages.slice(cursor, cursor + limit);
+    const nextOffset = cursor + pageItems.length;
+    return {
+        session: params.session,
+        view,
+        items: pageItems,
+        total: orderedMessages.length,
+        ...(nextOffset < orderedMessages.length
+            ? { nextCursor: encodeCursor(nextOffset) }
+            : {}),
+        hasMore: nextOffset < orderedMessages.length,
+    };
+}
+/**
+ * 列出指定 agent 的 session 摘要页。
+ */
+export async function listAgentSessionSummaryPage(params) {
+    const limit = normalizeLimit(params.input?.limit, 50, 500);
+    const cursor = normalizeCursor(params.input?.cursor);
+    const query = String(params.input?.query || "").trim().toLowerCase();
+    const sessionsRoot = getSdkAgentSessionsRootDirPath(params.projectRoot, params.agentId);
+    if (!(await fs.pathExists(sessionsRoot))) {
+        return {
+            items: [],
+            total: 0,
+            hasMore: false,
+        };
+    }
+    const entries = await fs.readdir(sessionsRoot, { withFileTypes: true });
+    const summaries = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const sessionId = decodeMaybe(entry.name);
+        if (!sessionId)
+            continue;
+        const metadata = await readSessionMetadata({
+            projectRoot: params.projectRoot,
+            agentId: params.agentId,
+            sessionId,
+        });
+        const messages = await loadSessionMessagesFromPath(getSdkAgentSessionMessagesPath(params.projectRoot, params.agentId, sessionId));
+        const info = buildSessionInfo({
+            projectRoot: params.projectRoot,
+            agentId: params.agentId,
+            sessionId,
+            metadata,
+            messages,
+            executing: params.executingSessionIds?.has(sessionId),
+        });
+        const summary = {
+            agentId: info.agentId,
+            sessionId: info.sessionId,
+            ...(info.title ? { title: info.title } : {}),
+            ...(info.previewText ? { previewText: info.previewText } : {}),
+            messageCount: info.messageCount,
+            ...(typeof info.createdAt === "number" ? { createdAt: info.createdAt } : {}),
+            ...(typeof info.updatedAt === "number" ? { updatedAt: info.updatedAt } : {}),
+            ...(info.modelLabel ? { modelLabel: info.modelLabel } : {}),
+            ...(info.executing ? { executing: true } : {}),
+        };
+        if (query) {
+            const haystack = [
+                summary.sessionId,
+                summary.title || "",
+                summary.previewText || "",
+            ]
+                .join("\n")
+                .toLowerCase();
+            if (!haystack.includes(query))
+                continue;
+        }
+        summaries.push(summary);
+    }
+    summaries.sort((left, right) => (right.updatedAt || 0) - (left.updatedAt || 0));
+    const items = summaries.slice(cursor, cursor + limit);
+    const nextOffset = cursor + items.length;
+    return {
+        items,
+        total: summaries.length,
+        ...(nextOffset < summaries.length
+            ? { nextCursor: encodeCursor(nextOffset) }
+            : {}),
+        hasMore: nextOffset < summaries.length,
+    };
+}
+//# sourceMappingURL=Browse.js.map