agent_sessions 0.3.0 → 0.4.0

data/doc/index.csv

@@ -0,0 +1,330 @@
+name,type,path
+README.md,File,README.md
+CHANGELOG.md,File,CHANGELOG.md
+Agent,Module,Agent.md
+Agent::Sessions,Module,Agent/Sessions.md
+Agent::Sessions.LOADER,Constant,Agent/Sessions.md#constant-LOADER
+Agent::Sessions.STALE_AFTER_DAYS,Constant,Agent/Sessions.md#constant-STALE_AFTER_DAYS
+Agent::Sessions.VERIFIED_ON,Constant,Agent/Sessions.md#constant-VERIFIED_ON
+Agent::Sessions.VERSION,Constant,Agent/Sessions.md#constant-VERSION
+Agent::Sessions.agents,Method,Agent/Sessions.md#method-c-agents
+Agent::Sessions.all,Method,Agent/Sessions.md#method-c-all
+Agent::Sessions.audit,Method,Agent/Sessions.md#method-c-audit
+Agent::Sessions.doctor,Method,Agent/Sessions.md#method-c-doctor
+Agent::Sessions.for_project,Method,Agent/Sessions.md#method-c-for_project
+Agent::Sessions.installed,Method,Agent/Sessions.md#method-c-installed
+Agent::Sessions.locate,Method,Agent/Sessions.md#method-c-locate
+Agent::Sessions.projects,Method,Agent/Sessions.md#method-c-projects
+Agent::Sessions.read,Method,Agent/Sessions.md#method-c-read
+Agent::Sessions.register,Method,Agent/Sessions.md#method-c-register
+Agent::Sessions.registry,Method,Agent/Sessions.md#method-c-registry
+Agent::Sessions.sessions,Method,Agent/Sessions.md#method-c-sessions
+Agent::Sessions.unresolved_project_count,Method,Agent/Sessions.md#method-c-unresolved_project_count
+Agent::Sessions.verify,Method,Agent/Sessions.md#method-c-verify
+Agent::Sessions::Sqlite,Module,Agent/Sessions/Sqlite.md
+Agent::Sessions::Sqlite.escape_uri_path,Method,Agent/Sessions/Sqlite.md#method-c-escape_uri_path
+Agent::Sessions::Sqlite.open_readonly,Method,Agent/Sessions/Sqlite.md#method-c-open_readonly
+Agent::Sessions::Readers,Module,Agent/Sessions/Readers.md
+Agent::Sessions::Adapters,Module,Agent/Sessions/Adapters.md
+Agent::Sessions::HomeExpansion,Module,Agent/Sessions/HomeExpansion.md
+Agent::Sessions::Adapters::Enumeration,Module,Agent/Sessions/Adapters/Enumeration.md
+Agent::Sessions::Adapters::Enumeration.MAX_LINE_BYTES,Constant,Agent/Sessions/Adapters/Enumeration.md#constant-MAX_LINE_BYTES
+Agent::Sessions::Adapters::Enumeration.bytes_for,Method,Agent/Sessions/Adapters/Enumeration.md#method-i-bytes_for
+Agent::Sessions::Adapters::Enumeration.encode_project,Method,Agent/Sessions/Adapters/Enumeration.md#method-i-encode_project
+Agent::Sessions::Adapters::Enumeration.project_dir_name,Method,Agent/Sessions/Adapters/Enumeration.md#method-i-project_dir_name
+Agent::Sessions::Adapters::Enumeration.project_path_for,Method,Agent/Sessions/Adapters/Enumeration.md#method-i-project_path_for
+Agent::Sessions::Adapters::Enumeration.project_paths,Method,Agent/Sessions/Adapters/Enumeration.md#method-i-project_paths
+Agent::Sessions::Adapters::Enumeration.session_id_from,Method,Agent/Sessions/Adapters/Enumeration.md#method-i-session_id_from
+Agent::Sessions::Adapters::Enumeration.sessions,Method,Agent/Sessions/Adapters/Enumeration.md#method-i-sessions
+Agent::Sessions::Adapters::Enumeration.sessions_for_project,Method,Agent/Sessions/Adapters/Enumeration.md#method-i-sessions_for_project
+Agent::Sessions::Adapters::Enumeration.started_at_for,Method,Agent/Sessions/Adapters/Enumeration.md#method-i-started_at_for
+Agent::Sessions::Adapters::Enumeration.updated_at_for,Method,Agent/Sessions/Adapters/Enumeration.md#method-i-updated_at_for
+Agent::Sessions::CLI,Class,Agent/Sessions/CLI.md
+Agent::Sessions::CLI.STATUS_MARKS,Constant,Agent/Sessions/CLI.md#constant-STATUS_MARKS
+Agent::Sessions::CLI.SINCE_UNITS,Constant,Agent/Sessions/CLI.md#constant-SINCE_UNITS
+Agent::Sessions::CLI.ID_COLUMN_MAX,Constant,Agent/Sessions/CLI.md#constant-ID_COLUMN_MAX
+Agent::Sessions::CLI.GROUP_COLUMN_MAX,Constant,Agent/Sessions/CLI.md#constant-GROUP_COLUMN_MAX
+Agent::Sessions::CLI.initialize,Method,Agent/Sessions/CLI.md#method-i-initialize
+Agent::Sessions::CLI.run,Method,Agent/Sessions/CLI.md#method-i-run
+Agent::Sessions::Node,Class,Agent/Sessions/Node.md
+Agent::Sessions::Node.children,Attribute,Agent/Sessions/Node.md#attribute-i-children
+Agent::Sessions::Node.message,Attribute,Agent/Sessions/Node.md#attribute-i-message
+Agent::Sessions::Part,Class,Agent/Sessions/Part.md
+Agent::Sessions::Part.TYPES,Constant,Agent/Sessions/Part.md#constant-TYPES
+Agent::Sessions::Part.initialize,Method,Agent/Sessions/Part.md#method-i-initialize
+Agent::Sessions::Part.call_id,Attribute,Agent/Sessions/Part.md#attribute-i-call_id
+Agent::Sessions::Part.name,Attribute,Agent/Sessions/Part.md#attribute-i-name
+Agent::Sessions::Part.text,Attribute,Agent/Sessions/Part.md#attribute-i-text
+Agent::Sessions::Part.type,Attribute,Agent/Sessions/Part.md#attribute-i-type
+Agent::Sessions::Audit,Class,Agent/Sessions/Audit.md
+Agent::Sessions::Audit.SYNC_ROOTS,Constant,Agent/Sessions/Audit.md#constant-SYNC_ROOTS
+Agent::Sessions::Audit.initialize,Method,Agent/Sessions/Audit.md#method-i-initialize
+Agent::Sessions::Audit.report,Method,Agent/Sessions/Audit.md#method-i-report
+Agent::Sessions::Audit::Finding,Class,Agent/Sessions/Audit/Finding.md
+Agent::Sessions::Audit::Finding.agent,Attribute,Agent/Sessions/Audit/Finding.md#attribute-i-agent
+Agent::Sessions::Audit::Finding.bytes,Attribute,Agent/Sessions/Audit/Finding.md#attribute-i-bytes
+Agent::Sessions::Audit::Finding.kind,Attribute,Agent/Sessions/Audit/Finding.md#attribute-i-kind
+Agent::Sessions::Audit::Finding.path,Attribute,Agent/Sessions/Audit/Finding.md#attribute-i-path
+Agent::Sessions::Audit::Finding.synced_to,Attribute,Agent/Sessions/Audit/Finding.md#attribute-i-synced_to
+Agent::Sessions::Check,Class,Agent/Sessions/Check.md
+Agent::Sessions::Check.pass?,Method,Agent/Sessions/Check.md#method-i-pass-3F
+Agent::Sessions::Check.agent,Attribute,Agent/Sessions/Check.md#attribute-i-agent
+Agent::Sessions::Check.claim,Attribute,Agent/Sessions/Check.md#attribute-i-claim
+Agent::Sessions::Check.detail,Attribute,Agent/Sessions/Check.md#attribute-i-detail
+Agent::Sessions::Check.status,Attribute,Agent/Sessions/Check.md#attribute-i-status
+Agent::Sessions::Error,Class,Agent/Sessions/Error.md
+Agent::Sessions::Store,Class,Agent/Sessions/Store.md
+Agent::Sessions::Store.documented?,Method,Agent/Sessions/Store.md#method-i-documented-3F
+Agent::Sessions::Store.format,Method,Agent/Sessions/Store.md#method-i-format
+Agent::Sessions::Store.installed?,Method,Agent/Sessions/Store.md#method-i-installed-3F
+Agent::Sessions::Store.agent,Attribute,Agent/Sessions/Store.md#attribute-i-agent
+Agent::Sessions::Store.documented,Attribute,Agent/Sessions/Store.md#attribute-i-documented
+Agent::Sessions::Store.effective,Attribute,Agent/Sessions/Store.md#attribute-i-effective
+Agent::Sessions::Store.env_overrides,Attribute,Agent/Sessions/Store.md#attribute-i-env_overrides
+Agent::Sessions::Store.label,Attribute,Agent/Sessions/Store.md#attribute-i-label
+Agent::Sessions::Store.layers,Attribute,Agent/Sessions/Store.md#attribute-i-layers
+Agent::Sessions::Store.retention,Attribute,Agent/Sessions/Store.md#attribute-i-retention
+Agent::Sessions::Store.retention_source,Attribute,Agent/Sessions/Store.md#attribute-i-retention_source
+Agent::Sessions::Store.verified_on,Attribute,Agent/Sessions/Store.md#attribute-i-verified_on
+Agent::Sessions::Store.warnings,Attribute,Agent/Sessions/Store.md#attribute-i-warnings
+Agent::Sessions::Usage,Class,Agent/Sessions/Usage.md
+Agent::Sessions::Usage.+,Method,Agent/Sessions/Usage.md#method-i--2B
+Agent::Sessions::Usage.initialize,Method,Agent/Sessions/Usage.md#method-i-initialize
+Agent::Sessions::Usage.cache_creation,Attribute,Agent/Sessions/Usage.md#attribute-i-cache_creation
+Agent::Sessions::Usage.cache_read,Attribute,Agent/Sessions/Usage.md#attribute-i-cache_read
+Agent::Sessions::Usage.cost,Attribute,Agent/Sessions/Usage.md#attribute-i-cost
+Agent::Sessions::Usage.input,Attribute,Agent/Sessions/Usage.md#attribute-i-input
+Agent::Sessions::Usage.output,Attribute,Agent/Sessions/Usage.md#attribute-i-output
+Agent::Sessions::Usage.reasoning,Attribute,Agent/Sessions/Usage.md#attribute-i-reasoning
+Agent::Sessions::Message,Class,Agent/Sessions/Message.md
+Agent::Sessions::Message.ROLES,Constant,Agent/Sessions/Message.md#constant-ROLES
+Agent::Sessions::Message.initialize,Method,Agent/Sessions/Message.md#method-i-initialize
+Agent::Sessions::Message.text,Method,Agent/Sessions/Message.md#method-i-text
+Agent::Sessions::Message.at,Attribute,Agent/Sessions/Message.md#attribute-i-at
+Agent::Sessions::Message.model,Attribute,Agent/Sessions/Message.md#attribute-i-model
+Agent::Sessions::Message.parts,Attribute,Agent/Sessions/Message.md#attribute-i-parts
+Agent::Sessions::Message.raw,Attribute,Agent/Sessions/Message.md#attribute-i-raw
+Agent::Sessions::Message.role,Attribute,Agent/Sessions/Message.md#attribute-i-role
+Agent::Sessions::Message.usage,Attribute,Agent/Sessions/Message.md#attribute-i-usage
+Agent::Sessions::Session,Class,Agent/Sessions/Session.md
+Agent::Sessions::Session.UNRESOLVED,Constant,Agent/Sessions/Session.md#constant-UNRESOLVED
+Agent::Sessions::Session.initialize,Method,Agent/Sessions/Session.md#method-i-initialize
+Agent::Sessions::Session.inspect,Method,Agent/Sessions/Session.md#method-i-inspect
+Agent::Sessions::Session.project_path,Method,Agent/Sessions/Session.md#method-i-project_path
+Agent::Sessions::Session.to_h,Method,Agent/Sessions/Session.md#method-i-to_h
+Agent::Sessions::Session.uid,Method,Agent/Sessions/Session.md#method-i-uid
+Agent::Sessions::Session.agent,Attribute,Agent/Sessions/Session.md#attribute-i-agent
+Agent::Sessions::Session.bytes,Attribute,Agent/Sessions/Session.md#attribute-i-bytes
+Agent::Sessions::Session.fidelity,Attribute,Agent/Sessions/Session.md#attribute-i-fidelity
+Agent::Sessions::Session.format,Attribute,Agent/Sessions/Session.md#attribute-i-format
+Agent::Sessions::Session.id,Attribute,Agent/Sessions/Session.md#attribute-i-id
+Agent::Sessions::Session.path,Attribute,Agent/Sessions/Session.md#attribute-i-path
+Agent::Sessions::Session.started_at,Attribute,Agent/Sessions/Session.md#attribute-i-started_at
+Agent::Sessions::Session.updated_at,Attribute,Agent/Sessions/Session.md#attribute-i-updated_at
+Agent::Sessions::Location,Class,Agent/Sessions/Location.md
+Agent::Sessions::Location.enumerable?,Method,Agent/Sessions/Location.md#method-i-enumerable-3F
+Agent::Sessions::Location.exists?,Method,Agent/Sessions/Location.md#method-i-exists-3F
+Agent::Sessions::Location.files,Method,Agent/Sessions/Location.md#method-i-files
+Agent::Sessions::Location.initialize,Method,Agent/Sessions/Location.md#method-i-initialize
+Agent::Sessions::Location.format,Attribute,Agent/Sessions/Location.md#attribute-i-format
+Agent::Sessions::Location.glob,Attribute,Agent/Sessions/Location.md#attribute-i-glob
+Agent::Sessions::Location.kind,Attribute,Agent/Sessions/Location.md#attribute-i-kind
+Agent::Sessions::Location.path,Attribute,Agent/Sessions/Location.md#attribute-i-path
+Agent::Sessions::Location.single_file,Attribute,Agent/Sessions/Location.md#attribute-i-single_file
+Agent::Sessions::Compaction,Class,Agent/Sessions/Compaction.md
+Agent::Sessions::Compaction.at,Attribute,Agent/Sessions/Compaction.md#attribute-i-at
+Agent::Sessions::Compaction.raw,Attribute,Agent/Sessions/Compaction.md#attribute-i-raw
+Agent::Sessions::Compaction.replaced_count,Attribute,Agent/Sessions/Compaction.md#attribute-i-replaced_count
+Agent::Sessions::Readers::Pi,Class,Agent/Sessions/Readers/Pi.md
+Agent::Sessions::Readers::Pi.NON_MESSAGE_TYPES,Constant,Agent/Sessions/Readers/Pi.md#constant-NON_MESSAGE_TYPES
+Agent::Sessions::Readers::Pi.ROLES,Constant,Agent/Sessions/Readers/Pi.md#constant-ROLES
+Agent::Sessions::Readers::Pi.usage,Method,Agent/Sessions/Readers/Pi.md#method-i-usage
+Agent::Sessions::RoundTrip,Class,Agent/Sessions/RoundTrip.md
+Agent::Sessions::RoundTrip.at,Method,Agent/Sessions/RoundTrip.md#method-i-at
+Agent::Sessions::RoundTrip.calls,Method,Agent/Sessions/RoundTrip.md#method-i-calls
+Agent::Sessions::RoundTrip.model,Method,Agent/Sessions/RoundTrip.md#method-i-model
+Agent::Sessions::RoundTrip.parts,Method,Agent/Sessions/RoundTrip.md#method-i-parts
+Agent::Sessions::RoundTrip.roles,Method,Agent/Sessions/RoundTrip.md#method-i-roles
+Agent::Sessions::RoundTrip.index,Attribute,Agent/Sessions/RoundTrip.md#attribute-i-index
+Agent::Sessions::RoundTrip.messages,Attribute,Agent/Sessions/RoundTrip.md#attribute-i-messages
+Agent::Sessions::RoundTrip.recorded,Attribute,Agent/Sessions/RoundTrip.md#attribute-i-recorded
+Agent::Sessions::RoundTrip.usage,Attribute,Agent/Sessions/RoundTrip.md#attribute-i-usage
+Agent::Sessions::Adapters::Pi,Class,Agent/Sessions/Adapters/Pi.md
+Agent::Sessions::Adapters::Pi.FILENAME,Constant,Agent/Sessions/Adapters/Pi.md#constant-FILENAME
+Agent::Sessions::Adapters::Pi.encode_project,Method,Agent/Sessions/Adapters/Pi.md#method-i-encode_project
+Agent::Sessions::Adapters::Pi.project_path_for,Method,Agent/Sessions/Adapters/Pi.md#method-i-project_path_for
+Agent::Sessions::Adapters::Pi.session_id_from,Method,Agent/Sessions/Adapters/Pi.md#method-i-session_id_from
+Agent::Sessions::Adapters::Pi.started_at_for,Method,Agent/Sessions/Adapters/Pi.md#method-i-started_at_for
+Agent::Sessions::Adapters::Pi.warnings,Method,Agent/Sessions/Adapters/Pi.md#method-i-warnings
+Agent::Sessions::Adapters::Pi.reader_class,Method,Agent/Sessions/Adapters/Pi.md#method-c-reader_class
+Agent::Sessions::Readers::Amp,Class,Agent/Sessions/Readers/Amp.md
+Agent::Sessions::Readers::Amp.MAX_DOCUMENT_BYTES,Constant,Agent/Sessions/Readers/Amp.md#constant-MAX_DOCUMENT_BYTES
+Agent::Sessions::Readers::Amp.CONTENT_PARTS,Constant,Agent/Sessions/Readers/Amp.md#constant-CONTENT_PARTS
+Agent::Sessions::Readers::Amp.ROLES,Constant,Agent/Sessions/Readers/Amp.md#constant-ROLES
+Agent::Sessions::Readers::Amp.partial?,Method,Agent/Sessions/Readers/Amp.md#method-i-partial-3F
+Agent::Sessions::Adapters::Amp,Class,Agent/Sessions/Adapters/Amp.md
+Agent::Sessions::Adapters::Amp.project_path_for,Method,Agent/Sessions/Adapters/Amp.md#method-i-project_path_for
+Agent::Sessions::Adapters::Amp.warnings,Method,Agent/Sessions/Adapters/Amp.md#method-i-warnings
+Agent::Sessions::Adapters::Amp.reader_class,Method,Agent/Sessions/Adapters/Amp.md#method-c-reader_class
+Agent::Sessions::EnvOverride,Class,Agent/Sessions/EnvOverride.md
+Agent::Sessions::EnvOverride.active?,Method,Agent/Sessions/EnvOverride.md#method-i-active-3F
+Agent::Sessions::EnvOverride.name,Attribute,Agent/Sessions/EnvOverride.md#attribute-i-name
+Agent::Sessions::EnvOverride.value,Attribute,Agent/Sessions/EnvOverride.md#attribute-i-value
+Agent::Sessions::Readers::Base,Class,Agent/Sessions/Readers/Base.md
+Agent::Sessions::Readers::Base.MAX_RECORD_BYTES,Constant,Agent/Sessions/Readers/Base.md#constant-MAX_RECORD_BYTES
+Agent::Sessions::Readers::Base.branching?,Method,Agent/Sessions/Readers/Base.md#method-i-branching-3F
+Agent::Sessions::Readers::Base.compactions,Method,Agent/Sessions/Readers/Base.md#method-i-compactions
+Agent::Sessions::Readers::Base.each_message,Method,Agent/Sessions/Readers/Base.md#method-i-each_message
+Agent::Sessions::Readers::Base.each_round_trip,Method,Agent/Sessions/Readers/Base.md#method-i-each_round_trip
+Agent::Sessions::Readers::Base.fidelity,Method,Agent/Sessions/Readers/Base.md#method-i-fidelity
+Agent::Sessions::Readers::Base.initialize,Method,Agent/Sessions/Readers/Base.md#method-i-initialize
+Agent::Sessions::Readers::Base.messages,Method,Agent/Sessions/Readers/Base.md#method-i-messages
+Agent::Sessions::Readers::Base.partial?,Method,Agent/Sessions/Readers/Base.md#method-i-partial-3F
+Agent::Sessions::Readers::Base.round_trips,Method,Agent/Sessions/Readers/Base.md#method-i-round_trips
+Agent::Sessions::Readers::Base.round_trips_recorded?,Method,Agent/Sessions/Readers/Base.md#method-i-round_trips_recorded-3F
+Agent::Sessions::Readers::Base.tree,Method,Agent/Sessions/Readers/Base.md#method-i-tree
+Agent::Sessions::Readers::Base.usage,Method,Agent/Sessions/Readers/Base.md#method-i-usage
+Agent::Sessions::Readers::Base.warnings,Method,Agent/Sessions/Readers/Base.md#method-i-warnings
+Agent::Sessions::Readers::Base.session,Attribute,Agent/Sessions/Readers/Base.md#attribute-i-session
+Agent::Sessions::Readers::Grok,Class,Agent/Sessions/Readers/Grok.md
+Agent::Sessions::Readers::Grok.TRANSCRIPT,Constant,Agent/Sessions/Readers/Grok.md#constant-TRANSCRIPT
+Agent::Sessions::Readers::Grok.UNIFIED_LOG,Constant,Agent/Sessions/Readers/Grok.md#constant-UNIFIED_LOG
+Agent::Sessions::Readers::Grok.INFERENCE,Constant,Agent/Sessions/Readers/Grok.md#constant-INFERENCE
+Agent::Sessions::Readers::Grok.ROLES,Constant,Agent/Sessions/Readers/Grok.md#constant-ROLES
+Agent::Sessions::Readers::Grok.summary,Method,Agent/Sessions/Readers/Grok.md#method-i-summary
+Agent::Sessions::Readers::Grok.usage,Method,Agent/Sessions/Readers/Grok.md#method-i-usage
+Agent::Sessions::Readers::Qwen,Class,Agent/Sessions/Readers/Qwen.md
+Agent::Sessions::Readers::Qwen.CONTENT_PARTS,Constant,Agent/Sessions/Readers/Qwen.md#constant-CONTENT_PARTS
+Agent::Sessions::Readers::Qwen.usage,Method,Agent/Sessions/Readers/Qwen.md#method-i-usage
+Agent::Sessions::Adapters::Base,Class,Agent/Sessions/Adapters/Base.md
+Agent::Sessions::Adapters::Base.FIDELITIES,Constant,Agent/Sessions/Adapters/Base.md#constant-FIDELITIES
+Agent::Sessions::Adapters::Base.base_dir,Method,Agent/Sessions/Adapters/Base.md#method-i-base_dir
+Agent::Sessions::Adapters::Base.bytes_for,Method,Agent/Sessions/Adapters/Base.md#method-i-bytes_for
+Agent::Sessions::Adapters::Base.encode_project,Method,Agent/Sessions/Adapters/Base.md#method-i-encode_project
+Agent::Sessions::Adapters::Base.initialize,Method,Agent/Sessions/Adapters/Base.md#method-i-initialize
+Agent::Sessions::Adapters::Base.locate,Method,Agent/Sessions/Adapters/Base.md#method-i-locate
+Agent::Sessions::Adapters::Base.project_dir_name,Method,Agent/Sessions/Adapters/Base.md#method-i-project_dir_name
+Agent::Sessions::Adapters::Base.project_path_for,Method,Agent/Sessions/Adapters/Base.md#method-i-project_path_for
+Agent::Sessions::Adapters::Base.project_paths,Method,Agent/Sessions/Adapters/Base.md#method-i-project_paths
+Agent::Sessions::Adapters::Base.retention,Method,Agent/Sessions/Adapters/Base.md#method-i-retention
+Agent::Sessions::Adapters::Base.retention_source,Method,Agent/Sessions/Adapters/Base.md#method-i-retention_source
+Agent::Sessions::Adapters::Base.session_id_from,Method,Agent/Sessions/Adapters/Base.md#method-i-session_id_from
+Agent::Sessions::Adapters::Base.sessions,Method,Agent/Sessions/Adapters/Base.md#method-i-sessions
+Agent::Sessions::Adapters::Base.sessions_for_project,Method,Agent/Sessions/Adapters/Base.md#method-i-sessions_for_project
+Agent::Sessions::Adapters::Base.started_at_for,Method,Agent/Sessions/Adapters/Base.md#method-i-started_at_for
+Agent::Sessions::Adapters::Base.updated_at_for,Method,Agent/Sessions/Adapters/Base.md#method-i-updated_at_for
+Agent::Sessions::Adapters::Base.verify,Method,Agent/Sessions/Adapters/Base.md#method-i-verify
+Agent::Sessions::Adapters::Base.warnings,Method,Agent/Sessions/Adapters/Base.md#method-i-warnings
+Agent::Sessions::Adapters::Base.fidelity_value,Method,Agent/Sessions/Adapters/Base.md#method-c-fidelity_value
+Agent::Sessions::Adapters::Base.homedir_config,Method,Agent/Sessions/Adapters/Base.md#method-c-homedir_config
+Agent::Sessions::Adapters::Base.reader_class,Method,Agent/Sessions/Adapters/Base.md#method-c-reader_class
+Agent::Sessions::Adapters::Base.store_configs,Method,Agent/Sessions/Adapters/Base.md#method-c-store_configs
+Agent::Sessions::Adapters::Base.agent_name,Attribute,Agent/Sessions/Adapters/Base.md#attribute-c-agent_name
+Agent::Sessions::Adapters::Base.declared_warnings,Attribute,Agent/Sessions/Adapters/Base.md#attribute-c-declared_warnings
+Agent::Sessions::Adapters::Base.documented_value,Attribute,Agent/Sessions/Adapters/Base.md#attribute-c-documented_value
+Agent::Sessions::Adapters::Base.label_text,Attribute,Agent/Sessions/Adapters/Base.md#attribute-c-label_text
+Agent::Sessions::Adapters::Base.verified_on_date,Attribute,Agent/Sessions/Adapters/Base.md#attribute-c-verified_on_date
+Agent::Sessions::Adapters::Grok,Class,Agent/Sessions/Adapters/Grok.md
+Agent::Sessions::Adapters::Grok.bytes_for,Method,Agent/Sessions/Adapters/Grok.md#method-i-bytes_for
+Agent::Sessions::Adapters::Grok.decode_project,Method,Agent/Sessions/Adapters/Grok.md#method-i-decode_project
+Agent::Sessions::Adapters::Grok.encode_project,Method,Agent/Sessions/Adapters/Grok.md#method-i-encode_project
+Agent::Sessions::Adapters::Grok.project_dir_name,Method,Agent/Sessions/Adapters/Grok.md#method-i-project_dir_name
+Agent::Sessions::Adapters::Grok.project_path_for,Method,Agent/Sessions/Adapters/Grok.md#method-i-project_path_for
+Agent::Sessions::Adapters::Grok.session_id_from,Method,Agent/Sessions/Adapters/Grok.md#method-i-session_id_from
+Agent::Sessions::Adapters::Grok.started_at_for,Method,Agent/Sessions/Adapters/Grok.md#method-i-started_at_for
+Agent::Sessions::Adapters::Grok.updated_at_for,Method,Agent/Sessions/Adapters/Grok.md#method-i-updated_at_for
+Agent::Sessions::Adapters::Grok.warnings,Method,Agent/Sessions/Adapters/Grok.md#method-i-warnings
+Agent::Sessions::Adapters::Grok.reader_class,Method,Agent/Sessions/Adapters/Grok.md#method-c-reader_class
+Agent::Sessions::Adapters::Qwen,Class,Agent/Sessions/Adapters/Qwen.md
+Agent::Sessions::Adapters::Qwen.project_path_for,Method,Agent/Sessions/Adapters/Qwen.md#method-i-project_path_for
+Agent::Sessions::Adapters::Qwen.warnings,Method,Agent/Sessions/Adapters/Qwen.md#method-i-warnings
+Agent::Sessions::Adapters::Qwen.reader_class,Method,Agent/Sessions/Adapters/Qwen.md#method-c-reader_class
+Agent::Sessions::Readers::Codex,Class,Agent/Sessions/Readers/Codex.md
+Agent::Sessions::Readers::Codex.NON_MESSAGE_TYPES,Constant,Agent/Sessions/Readers/Codex.md#constant-NON_MESSAGE_TYPES
+Agent::Sessions::Readers::Codex.ROLES,Constant,Agent/Sessions/Readers/Codex.md#constant-ROLES
+Agent::Sessions::Readers::Codex.CONTENT_PARTS,Constant,Agent/Sessions/Readers/Codex.md#constant-CONTENT_PARTS
+Agent::Sessions::Readers::Codex.TOOL_CALLS,Constant,Agent/Sessions/Readers/Codex.md#constant-TOOL_CALLS
+Agent::Sessions::Readers::Codex.TOOL_OUTPUTS,Constant,Agent/Sessions/Readers/Codex.md#constant-TOOL_OUTPUTS
+Agent::Sessions::Readers::Codex.NON_MESSAGE_ITEMS,Constant,Agent/Sessions/Readers/Codex.md#constant-NON_MESSAGE_ITEMS
+Agent::Sessions::Readers::Codex.CALL_INPUTS,Constant,Agent/Sessions/Readers/Codex.md#constant-CALL_INPUTS
+Agent::Sessions::Readers::Codex.CALL_OUTPUTS,Constant,Agent/Sessions/Readers/Codex.md#constant-CALL_OUTPUTS
+Agent::Sessions::Readers::Codex.usage,Method,Agent/Sessions/Readers/Codex.md#method-i-usage
+Agent::Sessions::UnknownAgent,Class,Agent/Sessions/UnknownAgent.md
+Agent::Sessions::Adapters::Codex,Class,Agent/Sessions/Adapters/Codex.md
+Agent::Sessions::Adapters::Codex.FILENAME,Constant,Agent/Sessions/Adapters/Codex.md#constant-FILENAME
+Agent::Sessions::Adapters::Codex.project_path_for,Method,Agent/Sessions/Adapters/Codex.md#method-i-project_path_for
+Agent::Sessions::Adapters::Codex.session_id_from,Method,Agent/Sessions/Adapters/Codex.md#method-i-session_id_from
+Agent::Sessions::Adapters::Codex.sessions,Method,Agent/Sessions/Adapters/Codex.md#method-i-sessions
+Agent::Sessions::Adapters::Codex.started_at_for,Method,Agent/Sessions/Adapters/Codex.md#method-i-started_at_for
+Agent::Sessions::Adapters::Codex.reader_class,Method,Agent/Sessions/Adapters/Codex.md#method-c-reader_class
+Agent::Sessions::Readers::Claude,Class,Agent/Sessions/Readers/Claude.md
+Agent::Sessions::Readers::Claude.NON_MESSAGE_TYPES,Constant,Agent/Sessions/Readers/Claude.md#constant-NON_MESSAGE_TYPES
+Agent::Sessions::Readers::Claude.EVENT_TYPES,Constant,Agent/Sessions/Readers/Claude.md#constant-EVENT_TYPES
+Agent::Sessions::Readers::Claude.CONTENT_PARTS,Constant,Agent/Sessions/Readers/Claude.md#constant-CONTENT_PARTS
+Agent::Sessions::Readers::Claude.SPILL,Constant,Agent/Sessions/Readers/Claude.md#constant-SPILL
+Agent::Sessions::Readers::Claude.MAX_SPILL_BYTES,Constant,Agent/Sessions/Readers/Claude.md#constant-MAX_SPILL_BYTES
+Agent::Sessions::Readers::Claude.branching?,Method,Agent/Sessions/Readers/Claude.md#method-i-branching-3F
+Agent::Sessions::Readers::Claude.initialize,Method,Agent/Sessions/Readers/Claude.md#method-i-initialize
+Agent::Sessions::Readers::Claude.round_trips_recorded?,Method,Agent/Sessions/Readers/Claude.md#method-i-round_trips_recorded-3F
+Agent::Sessions::Readers::Claude.subagents,Method,Agent/Sessions/Readers/Claude.md#method-i-subagents
+Agent::Sessions::Readers::Claude.usage,Method,Agent/Sessions/Readers/Claude.md#method-i-usage
+Agent::Sessions::Readers::Gemini,Class,Agent/Sessions/Readers/Gemini.md
+Agent::Sessions::Readers::Gemini.MAX_DOCUMENT_BYTES,Constant,Agent/Sessions/Readers/Gemini.md#constant-MAX_DOCUMENT_BYTES
+Agent::Sessions::Readers::Gemini.ROLES,Constant,Agent/Sessions/Readers/Gemini.md#constant-ROLES
+Agent::Sessions::Readers::Gemini.header,Method,Agent/Sessions/Readers/Gemini.md#method-i-header
+Agent::Sessions::Readers::Gemini.usage,Method,Agent/Sessions/Readers/Gemini.md#method-i-usage
+Agent::Sessions::Adapters::Claude,Class,Agent/Sessions/Adapters/Claude.md
+Agent::Sessions::Adapters::Claude.DEFAULT_CLEANUP_PERIOD_DAYS,Constant,Agent/Sessions/Adapters/Claude.md#constant-DEFAULT_CLEANUP_PERIOD_DAYS
+Agent::Sessions::Adapters::Claude.bytes_for,Method,Agent/Sessions/Adapters/Claude.md#method-i-bytes_for
+Agent::Sessions::Adapters::Claude.encode_project,Method,Agent/Sessions/Adapters/Claude.md#method-i-encode_project
+Agent::Sessions::Adapters::Claude.project_path_for,Method,Agent/Sessions/Adapters/Claude.md#method-i-project_path_for
+Agent::Sessions::Adapters::Claude.retention,Method,Agent/Sessions/Adapters/Claude.md#method-i-retention
+Agent::Sessions::Adapters::Claude.retention_source,Method,Agent/Sessions/Adapters/Claude.md#method-i-retention_source
+Agent::Sessions::Adapters::Claude.warnings,Method,Agent/Sessions/Adapters/Claude.md#method-i-warnings
+Agent::Sessions::Adapters::Claude.reader_class,Method,Agent/Sessions/Adapters/Claude.md#method-c-reader_class
+Agent::Sessions::Adapters::Cursor,Class,Agent/Sessions/Adapters/Cursor.md
+Agent::Sessions::Adapters::Cursor.project_path_for,Method,Agent/Sessions/Adapters/Cursor.md#method-i-project_path_for
+Agent::Sessions::Adapters::Cursor.session_id_from,Method,Agent/Sessions/Adapters/Cursor.md#method-i-session_id_from
+Agent::Sessions::Adapters::Cursor.started_at_for,Method,Agent/Sessions/Adapters/Cursor.md#method-i-started_at_for
+Agent::Sessions::Adapters::Cursor.updated_at_for,Method,Agent/Sessions/Adapters/Cursor.md#method-i-updated_at_for
+Agent::Sessions::Adapters::Cursor.warnings,Method,Agent/Sessions/Adapters/Cursor.md#method-i-warnings
+Agent::Sessions::Adapters::Gemini,Class,Agent/Sessions/Adapters/Gemini.md
+Agent::Sessions::Adapters::Gemini.FILENAME,Constant,Agent/Sessions/Adapters/Gemini.md#constant-FILENAME
+Agent::Sessions::Adapters::Gemini.encode_project,Method,Agent/Sessions/Adapters/Gemini.md#method-i-encode_project
+Agent::Sessions::Adapters::Gemini.project_dir_name,Method,Agent/Sessions/Adapters/Gemini.md#method-i-project_dir_name
+Agent::Sessions::Adapters::Gemini.project_path_for,Method,Agent/Sessions/Adapters/Gemini.md#method-i-project_path_for
+Agent::Sessions::Adapters::Gemini.project_paths,Method,Agent/Sessions/Adapters/Gemini.md#method-i-project_paths
+Agent::Sessions::Adapters::Gemini.started_at_for,Method,Agent/Sessions/Adapters/Gemini.md#method-i-started_at_for
+Agent::Sessions::Adapters::Gemini.warnings,Method,Agent/Sessions/Adapters/Gemini.md#method-i-warnings
+Agent::Sessions::Adapters::Gemini.reader_class,Method,Agent/Sessions/Adapters/Gemini.md#method-c-reader_class
+Agent::Sessions::Readers::Copilot,Class,Agent/Sessions/Readers/Copilot.md
+Agent::Sessions::Readers::Copilot.each_message,Method,Agent/Sessions/Readers/Copilot.md#method-i-each_message
+Agent::Sessions::Readers::Copilot.usage,Method,Agent/Sessions/Readers/Copilot.md#method-i-usage
+Agent::Sessions::Adapters::Copilot,Class,Agent/Sessions/Adapters/Copilot.md
+Agent::Sessions::Adapters::Copilot.SESSION_COLUMNS,Constant,Agent/Sessions/Adapters/Copilot.md#constant-SESSION_COLUMNS
+Agent::Sessions::Adapters::Copilot.project_paths,Method,Agent/Sessions/Adapters/Copilot.md#method-i-project_paths
+Agent::Sessions::Adapters::Copilot.sessions,Method,Agent/Sessions/Adapters/Copilot.md#method-i-sessions
+Agent::Sessions::Adapters::Copilot.sessions_for_project,Method,Agent/Sessions/Adapters/Copilot.md#method-i-sessions_for_project
+Agent::Sessions::Adapters::Copilot.reader_class,Method,Agent/Sessions/Adapters/Copilot.md#method-c-reader_class
+Agent::Sessions::Readers::Opencode,Class,Agent/Sessions/Readers/Opencode.md
+Agent::Sessions::Readers::Opencode.CONTENT_PARTS,Constant,Agent/Sessions/Readers/Opencode.md#constant-CONTENT_PARTS
+Agent::Sessions::Readers::Opencode.STATE_PARTS,Constant,Agent/Sessions/Readers/Opencode.md#constant-STATE_PARTS
+Agent::Sessions::Readers::Opencode.usage,Method,Agent/Sessions/Readers/Opencode.md#method-i-usage
+Agent::Sessions::UnreadableStore,Class,Agent/Sessions/UnreadableStore.md
+Agent::Sessions::Adapters::Opencode,Class,Agent/Sessions/Adapters/Opencode.md
+Agent::Sessions::Adapters::Opencode.DATABASE_GLOB,Constant,Agent/Sessions/Adapters/Opencode.md#constant-DATABASE_GLOB
+Agent::Sessions::Adapters::Opencode.SESSION_COLUMNS,Constant,Agent/Sessions/Adapters/Opencode.md#constant-SESSION_COLUMNS
+Agent::Sessions::Adapters::Opencode.base_dir,Method,Agent/Sessions/Adapters/Opencode.md#method-i-base_dir
+Agent::Sessions::Adapters::Opencode.project_paths,Method,Agent/Sessions/Adapters/Opencode.md#method-i-project_paths
+Agent::Sessions::Adapters::Opencode.sessions,Method,Agent/Sessions/Adapters/Opencode.md#method-i-sessions
+Agent::Sessions::Adapters::Opencode.sessions_for_project,Method,Agent/Sessions/Adapters/Opencode.md#method-i-sessions_for_project
+Agent::Sessions::Adapters::Opencode.verify,Method,Agent/Sessions/Adapters/Opencode.md#method-i-verify
+Agent::Sessions::Adapters::Opencode.reader_class,Method,Agent/Sessions/Adapters/Opencode.md#method-c-reader_class
+Agent::Sessions::MissingDependency,Class,Agent/Sessions/MissingDependency.md
+Agent::Sessions::UnsupportedFormat,Class,Agent/Sessions/UnsupportedFormat.md
+Agent::Sessions::Adapters::CursorIde,Class,Agent/Sessions/Adapters/CursorIde.md
+Agent::Sessions::Adapters::CursorIde.KEY_PREFIX,Constant,Agent/Sessions/Adapters/CursorIde.md#constant-KEY_PREFIX
+Agent::Sessions::Adapters::CursorIde.project_path_for,Method,Agent/Sessions/Adapters/CursorIde.md#method-i-project_path_for
+Agent::Sessions::Adapters::CursorIde.project_paths,Method,Agent/Sessions/Adapters/CursorIde.md#method-i-project_paths
+Agent::Sessions::Adapters::CursorIde.sessions,Method,Agent/Sessions/Adapters/CursorIde.md#method-i-sessions
+Agent::Sessions::Adapters::CursorIde.sessions_for_project,Method,Agent/Sessions/Adapters/CursorIde.md#method-i-sessions_for_project

data/exe/agent-sessions

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
-
 require "agent/sessions"
 
 exit Agent::Sessions::CLI.new(ARGV).run

data/lib/agent/sessions/adapters/cursor.rb

@@ -115,12 +115,12 @@ module Agent
             # (`@project_path_resolver = nil`) on a Session's FIRST #project_path
             # call, not before — so any Session a caller keeps without ever reading
             # project_path stays holding a live reference to the whole adapter,
-            # @meta included. `list` is exactly that caller: it never touches
+            # `@meta` included. `list` is exactly that caller: it never touches
             # project_path, so every Session it returns keeps this adapter (and
-            # whatever of @meta got populated enumerating them) alive for as long
+            # whatever of `@meta` got populated enumerating them) alive for as long
             # as the caller holds that Session array — not just for one
             # enumeration pass. All N sessions from one `sessions` call share the
-            # SAME adapter instance, so this is one retained @meta hash, not N
+            # SAME adapter instance, so this is one retained `@meta` hash, not N
             # copies of it.
             #
             # What actually keeps this acceptable is SIZE, not lifetime: measured

data/lib/agent/sessions/cli.rb

@@ -268,7 +268,7 @@ module Agent
 
         # One agent's missing dependency or unreadable store must not silently empty
         # a cross-agent listing — each skip is announced on stderr, tracked in
-        # @skipped_agents so the command can exit non-zero, and the rest still
+        # `@skipped_agents` so the command can exit non-zero, and the rest still
         # print. The exit code matters as much as the stderr line: `--json` is the
         # door built for a machine consumer (design doc section 12), and a machine
         # reading `[]` next to exit 0 has no way to tell "empty store" from
@@ -335,7 +335,7 @@ module Agent
         # a skip must flip the exit code even though the rest of the output still
         # printed successfully. One list, not a list plus a boolean that mirrors
         # it: two variables recording the same fact (an earlier draft had
-        # @agents_skipped alongside @skipped_agents) are one rename away from
+        # `@agents_skipped` alongside `@skipped_agents`) are one rename away from
         # silently disagreeing, which is exactly the failure mode decision 11a
         # exists to prevent.
         def exit_code_honoring_skips

data/lib/agent/sessions/message.rb

@@ -16,8 +16,6 @@ module Agent
           # session-level `usage` is where those formats answer. A nil here means
           # "not recorded on this message", never "zero tokens".
           Message = Data.define(:role, :at, :parts, :raw, :usage, :model) do
-            self::ROLES = %i[user assistant system tool unknown].freeze
-
             def initialize(role:, at:, parts:, raw:, usage: nil, model: nil)
               roles = self.class::ROLES
               raise ArgumentError, "role #{role.inspect} must be one of #{roles.join(", ")}" unless roles.include?(role)
@@ -32,5 +30,6 @@ module Agent
               parts.select { |part| part.type == :text }.map(&:text).join
             end
           end
+          Message::ROLES = %i[user assistant system tool unknown].freeze
   end
 end

data/lib/agent/sessions/part.rb

@@ -11,8 +11,6 @@ module Agent
           # neither — its URL or payload stays in raw, because normalizing an image
           # would mean deciding whether to load it, and reading is stat-cheap by design.
           Part = Data.define(:type, :text, :name, :call_id) do
-            self::TYPES = %i[text thinking tool_use tool_result image unknown].freeze
-
             def initialize(type:, text: nil, name: nil, call_id: nil)
               types = self.class::TYPES
               raise ArgumentError, "part type #{type.inspect} must be one of #{types.join(", ")}" unless types.include?(type)
@@ -20,5 +18,6 @@ module Agent
               super
             end
           end
+          Part::TYPES = %i[text thinking tool_use tool_result image unknown].freeze
   end
 end

data/lib/agent/sessions/readers/base.rb

@@ -60,6 +60,75 @@ module Agent
             # `each_message` is what a 2.6 GB file requires.
             def messages = each_message.to_a
 
+            # Streams, exactly as each_message does. A group is a RUN of
+            # neighbouring records sharing one round-trip id, not every record
+            # sharing that id wherever it sits in the file — collecting scattered
+            # records cannot stream, and rule 3 says no code path here may assume
+            # a file fits in memory.
+            #
+            # So an id that reappears after its run closed opens a NEW round trip
+            # rather than reopening the old one. That is ORDINARY for Claude, not
+            # an anomaly: Claude Code writes each tool_result immediately after
+            # the tool_use it answers, while every content block of the one API
+            # response keeps the same message.id, so a response making two tool
+            # calls has its records split by the result in between. Measured over
+            # the 60 most recent real Claude transcripts on this machine
+            # (2026-09-10): 3,315 distinct message.ids, 261 of them (7.9%) split
+            # across more than one run, in 33 of the 60 files; 759 of the splits
+            # are a tool_result record, 66 a last-prompt, 12 a file-history-delta.
+            #
+            # Hence the warning fires only where NOTHING answered a tool between
+            # the two runs — the case that is genuinely unexplained and would mean
+            # the format drifted. Warning on the benign split would put four or
+            # five lines under every real session's loop view, which teaches a
+            # caller that these warnings are noise.
+            def each_round_trip
+              return enum_for(:each_round_trip) unless block_given?
+
+              open_messages = []
+              open_id       = nil
+              closed_ids    = {}
+              answers_seen  = 0
+              index         = 0
+
+              each_message do |message|
+                id = round_trip_id_for(message.raw)
+
+                if id && id == open_id
+                  open_messages << message
+                  answers_seen += 1 if answers_a_tool?(message)
+                  next
+                end
+
+                if open_messages.any?
+                  index += 1
+                  yield build_round_trip(index, open_messages, open_id)
+                end
+                # What this id's run closed at, counted in tool answers seen so
+                # far. Comparing that count against the count now is what
+                # separates "a tool result split one response" from "this id came
+                # back for a reason nothing here explains".
+                closed_ids[open_id] = answers_seen if open_id
+
+                if id && closed_ids[id] == answers_seen
+                  warn_about("round-trip id #{id} reappears after its run closed with no tool answered " \
+                             "in between; grouped as a new round trip")
+                end
+
+                open_messages = [message]
+                open_id       = id
+                answers_seen += 1 if answers_a_tool?(message)
+              end
+
+              yield build_round_trip(index + 1, open_messages, open_id) if open_messages.any?
+            end
+
+            def round_trips = each_round_trip.to_a
+
+            # False here: most stores are an append-only list of records and no
+            # format names which of them belong to one model response.
+            def round_trips_recorded? = false
+
             # Whether this agent records which turn each turn followed. False here:
             # most stores are an append-only list and a tree would have to be invented.
             def branching? = false
@@ -117,6 +186,32 @@ module Agent
             def node_id_for(_record) = nil
             def parent_id_for(_record) = nil
 
+            # nil means "this format records no round-trip id". Same shape of
+            # hook as node_id_for/parent_id_for: an agent says WHERE its id
+            # lives, never how the grouping is assembled.
+            def round_trip_id_for(_record) = nil
+
+            # Whether this message is a tool answering a call. Used only to tell a
+            # benign split of one response's records from an unexplained one.
+            def answers_a_tool?(message) = message.parts.any? { |part| part.type == :tool_result }
+
+            def build_round_trip(index, messages, id)
+              RoundTrip.new(index: index, messages: messages, usage: usage_for(messages), recorded: !id.nil?)
+            end
+
+            # NEVER a sum. Claude repeats one API response's usage byte-for-byte
+            # on each record of that response (94 of 124 message ids in one real
+            # transcript), so summing the group would report roughly double what
+            # the vendor billed.
+            def usage_for(messages)
+              found = messages.filter_map(&:usage)
+              return nil if found.empty?
+              return found.first if found.uniq.size == 1
+
+              warn_about("round trip records disagree on usage; reporting the first")
+              found.first
+            end
+
             # Two passes over one session. The first records every uuid-bearing
             # record's parent and which of them became messages; the second links
             # each message to the nearest ANCESTOR that is also a message.

data/lib/agent/sessions/readers/claude.rb

@@ -52,6 +52,8 @@ module Agent
             # trustworthy enough to build a tree from.
             def branching? = true
 
+            def round_trips_recorded? = true
+
             def initialize(session, resolve_spills: true, **rest)
               super(session, **rest)
               @resolve_spills = resolve_spills
@@ -112,6 +114,14 @@ module Agent
             def node_id_for(record) = record["uuid"]
             def parent_id_for(record) = record["parentUuid"]
 
+            # message.id is the id Anthropic's API gives one response; Claude
+            # Code writes one record PER CONTENT BLOCK, all repeating it. The
+            # reader already dedups session usage by exactly this id (usage,
+            # above), so the fact is known and only needs exposing. A record
+            # with no message.id (a user turn, an event) yields nil and becomes
+            # its own assumed round trip.
+            def round_trip_id_for(record) = record.dig("message", "id")
+
             def message_for(record, line_number)
               type = record["type"]
               return nil if NON_MESSAGE_TYPES.include?(type)

data/lib/agent/sessions/round_trip.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Agent
+  module Sessions
+          # One model response, grouped from however many records a format split it
+          # across. Claude Code writes one record PER CONTENT BLOCK of an API
+          # response: in one real transcript on this machine, 260 assistant records
+          # share only 124 message.id values, so a caller counting records over-
+          # counts what the session actually did by roughly two to one. A round
+          # trip is the unit that actually happened.
+          #
+          # `recorded` is the load-bearing field. False means this group was
+          # ASSUMED — the format names no round-trip id, so grouping fell back to
+          # one message per round trip — never "this session has none". Same rule
+          # tree()/branching? already enforce for parent links: "not recorded"
+          # must never read as "recorded and empty".
+          #
+          # A round trip deliberately carries NO tool results: a result can arrive
+          # long after its call, and grouping streams one record at a time, so
+          # pairing a call with its eventual result is a separate, eager layer
+          # (Agent::Sessions::Loop, landing next) rather than this one's job.
+          RoundTrip = Data.define(:index, :messages, :usage, :recorded) do
+            # Every part of every message, in file order.
+            def parts = messages.flat_map(&:parts)
+
+            # The :tool_use parts only, [] when this round trip asked for no tool.
+            def calls = parts.select { |part| part.type == :tool_use }
+
+            # The distinct roles in this group, in first-seen order.
+            def roles = messages.map(&:role).uniq
+
+            # The first recorded Time among the messages, or nil when none carried one.
+            def at = messages.filter_map(&:at).first
+
+            # The first recorded model String, or nil.
+            def model = messages.filter_map(&:model).first
+          end
+  end
+end

data/lib/agent/sessions/version.rb

@@ -2,6 +2,6 @@
 
 module Agent
   module Sessions
-    VERSION = "0.3.0"
+    VERSION = "0.4.0"
   end
 end