Module session 

Structs

SessionMeta

会话元数据（用于会话列表展示）

SessionMetaFile

session.json 元数据文件内容（持久化到 sessions/<id>/session.json）

SessionPaths

Session 目录布局抽象。

Functions

append_event_to_path

向任意路径的 JSONL 文件 append 一条事件（append-only；用于 teammate/subagent 独立 transcript）。

append_session_event

追加一个事件到 session JSONL 文件（append-only，POSIX 下原子安全）

append_session_op

追加一条操作审计记录到 ops.jsonl（append-only，与 append_session_event 同模式）

delete_session

删除指定 session 目录

find_latest_session_id

查找最近修改的 session ID（用于 –continue）

generate_session_id

生成会话 ID（时间戳微秒 + 进程 ID，无需外部依赖）

list_sessions

列出所有会话的元数据，按更新时间倒序

load_display_session

从 display.jsonl replay 出 display 消息列表。

load_session

从 JSONL 文件 replay 出消息列表（供 resume 等功能使用）

load_session_meta_file

加载 session.json 元数据（不存在返回 None）

load_session_ops

读取 session 的所有操作审计记录

read_transcript_with_timestamps

从 JSONL 文件按出现顺序读取 (ChatMessage, timestamp_ms) 列表。

save_session_meta_file

保存 session.json 元数据

session_file_path

获取单个 session 的 JSONL 文件路径（兼容别名，指向新布局主文件）

sessions_dir

获取 sessions 目录: ~/.jdata/agent/data/sessions/

write_session_metrics

将 SessionMetrics 写入 sessions//metrics.json（覆盖写，JSON pretty）