Skip to main content

Module transcript

Module transcript 

Source
Expand description

Transcript projection and presentation implementation.

Structs§

ChatEntry
PlanLine
TerminalOutputRecord
What one client-run terminal produced, as hel recorded it when the child was reaped. exit_code and signal mirror ACP TerminalExitStatus; both are None when the terminal was released before a status was observed.
ToolCallPresentation
Bounded presentation metadata derived from an ACP tool call.
TranscriptItem
TranscriptSource
Handle on the transcript item an entry was derived from. Unchanged items keep the same Arc from one projection to the next, so a pointer comparison replaces re-reading the item and re-parsing its JSON.

Enums§

ChatRole
PlanStatus
ToolStatus
The ACP tool states needed to keep a compact tool block visually useful.
ToolSummarySourceKind
Where a tool’s compact presentation source came from.
TranscriptBody
The current value of one logical transcript item. ACP structures whose schemas can grow are kept as JSON values, while logical item identity and lifecycle remain controller-owned and stable.
TranscriptRole
What produced a transcript item, as a stable wire name.

Constants§

HARNESS_TURN_ITEM_PREFIX
HARNESS_TURN_TEXT
Marks the point where the harness resumed work with no prompt in flight.
SESSION_RESTART_ITEM_PREFIX
SESSION_RESTART_TEXT
TOOL_SUMMARY_VERSION
Parser-rule version stored with cached tool summaries.

Functions§

apply_runtime_event_to_entries
Apply the transcript-visible part of one persisted runtime event. Returns the event again when it only configures the session surface, which is the chat view’s business rather than the transcript’s.
apply_session_update_to_entries
Apply the transcript-visible part of one ACP session update. Returns the update again when it changes the session surface rather than the transcript, so the chat view handles those without decoding twice.
compact_tool_call_for_retention
Reduce a tool call to what a reader still needs, once a verified checkpoint holds the whole of it.
content_block_text
materialized_chunks_text
materialized_content_text
materialized_tool_call_presentation
Use cached presentation data when it was produced by current parser rules, otherwise rebuild it from the complete stored call. This lets parser fixes repair existing transcripts while current summaries remain cheap to load.
materialized_tool_diffstats
plan_status
sanitize_terminal_text
Remove terminal controls while preserving user-visible whitespace.
terminal_output_detail
One terminal’s output followed by how it ended.
tool_call_presentation
Compute the stable presentation metadata for one complete ACP call.
tool_call_update_changes_presentation
Whether a partial update changes inputs used to derive the tool summary.
tool_content_details
tool_diff_paths
tool_location_details
tool_status
transcript_item_role
transcript_item_text
One transcript item flattened to the text a reader would see.
update_tool_call_presentation
Apply the presentation-relevant portion of a partial ACP update to cached metadata. ACP updates replace only fields that are present, so a title update must not erase a summary selected from an earlier raw command.