Skip to main content

Module pi

Module pi 

Source
Expand description

Pi session transcript discovery, delta ingestion, and ledger normalization (GH-577).

Pi persists its transcripts to: ~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<session-id>.jsonl (or to a custom directory when --session-dir is provided).

This module provides:

  1. find_pi_session_file: locates the session file by matching session ID in filename or header.
  2. ingest_pi_transcript_delta: cursor-based incremental ingestion into transcripts/{session_id}.jsonl and ledger/{session_id}.jsonl (normalizing tool calls and failures so digest can summarize it), plus updating state/usage.json.

Structs§

PiIngestStats
Ingestion statistics for a Pi session delta.

Functions§

find_pi_session_file
Find the Pi session JSONL file for a given session ID.
ingest_pi_transcript_delta
Ingest a Pi session transcript file incrementally into project_dir.
pi_session_dir_for_cwd
Compute the default Pi session directory for a given working directory. Encodes cwd into --<escaped_path>-- under ~/.pi/agent/sessions/, strictly matching @earendil-works/pi-coding-agent’s getDefaultSessionDirPath.