/**
 * SDK Session 元数据辅助。
 *
 * 关键点（中文）
 * - 统一负责 `.downcity/agents/<agent_id>/sessions/<session_id>/messages/meta.json` 的规范化读取。
 * - 仅处理轻量配置摘要与索引信息，不负责消息 JSONL 的读写。
 */
import type { SessionHistoryMetaV1 } from "../../executor/types/SessionHistoryMeta.js";
import type { FileSystem } from "../../types/workspace/FileSystem.js";
/**
 * 归一化 session 标题。
 */
export declare function normalize_session_title(input: unknown): string | undefined;
/**
 * 读取当前系统时区。
 */
export declare function resolve_system_timezone(): string;
/**
 * 从指定路径读取 session meta.json。
 *
 * 关键点（中文）
 * - 供归档 session 等需要脱离默认 `sessions/` 目录的场景复用。
 * - 路径本身不做校验，调用方需保证可访问。
 */
export declare function read_session_metadata_from_path(input: {
    /** meta.json 文件路径。 */
    filePath: string;
    /** 当前 session_id。 */
    session_id: string;
    /** 当前 agent_id。 */
    agent_id: string;
    /** 当前 Workspace 的统一文件能力。 */
    files: FileSystem;
}): Promise<SessionHistoryMetaV1>;
/** 将未知 Metadata 内容规范化为当前 Session 的稳定结构。 */
export declare function normalize_session_metadata(raw: Partial<SessionHistoryMetaV1>, session_id: string, agent_id: string): SessionHistoryMetaV1;
//# sourceMappingURL=Metadata.d.ts.map