/**
 * SDK Session 浏览辅助。
 *
 * 关键点（中文）
 * - 统一负责 session 列表摘要、session 详情与 history 分页的投影逻辑。
 * - session title 允许为空；浏览层不会再从首条 user message 推导 fallback title。
 * - 面向 SDK / RemoteAgent / downcity gateway route 复用，避免在多个入口重复拼列表与分页语义。
 * - 这里不持有运行态状态；执行状态等动态信息通过调用参数显式注入。
 */
import type { AgentListSessionsInput, AgentSessionInfo, AgentSessionSummaryPage } from "../../types/agent/SessionTypes.js";
import type { SessionRecordV1 } from "../../executor/types/SessionRecords.js";
import type { SessionHistoryMetaV1 } from "../../executor/types/SessionHistoryMeta.js";
import type { FileSystem } from "../../types/workspace/FileSystem.js";
type SessionBrowseBaseInput = {
    /**
     * 当前项目根目录。
     */
    project_root: string;
    /**
     * 当前 agent_id。
     */
    agent_id: string;
    /**
     * 当前 session_id。
     */
    session_id: string;
    /**
     * 当前 session 已读取到的 metadata。
     */
    metadata: SessionHistoryMetaV1;
    /**
     * 当前 session 已读取到的完整消息。
     *
     * 说明（中文）：列表查询已有 metadata 摘要时可省略，详情查询仍传完整记录。
     */
    messages?: SessionRecordV1[];
    /**
     * 当前 session 是否正在执行。
     */
    executing?: boolean;
};
/**
 * 读取指定 JSONL 消息文件。
 */
export declare function load_session_messages_from_path(filePath: string, files: FileSystem): Promise<SessionRecordV1[]>;
/**
 * 基于 metadata + messages 构建 SDK session 详情。
 */
export declare function build_session_info(input: SessionBrowseBaseInput): AgentSessionInfo;
/**
 * 列出指定 agent 的 session 摘要页。
 */
export declare function list_agent_session_summary_page(params: {
    project_root: string;
    agent_id: string;
    input?: AgentListSessionsInput;
    executingSessionIds?: Set<string>;
    files: FileSystem;
}): Promise<AgentSessionSummaryPage>;
/**
 * 列出指定 agent 的已归档 session 摘要页。
 */
export declare function list_archived_agent_session_summary_page(params: {
    project_root: string;
    agent_id: string;
    input?: AgentListSessionsInput;
    files: FileSystem;
}): Promise<AgentSessionSummaryPage>;
export {};
//# sourceMappingURL=Browse.d.ts.map