agent_sessions 0.3.0 → 0.3.1

data/doc/index.csv

@@ -0,0 +1,316 @@
+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::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.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.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.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/version.rb

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

data/llm.txt

@@ -0,0 +1,177 @@
+# Module Agent::Sessions <a id="module-Agent-Sessions"></a>
+
+|  |  |
+| --- | --- |
+| **Defined in** | lib/agent/sessions.rb, lib/agent/sessions/cli.rb, lib/agent/sessions/node.rb, lib/agent/sessions/part.rb, lib/agent/sessions/audit.rb, lib/agent/sessions/check.rb, lib/agent/sessions/error.rb, lib/agent/sessions/store.rb, lib/agent/sessions/usage.rb, lib/agent/sessions/sqlite.rb, lib/agent/sessions/message.rb, lib/agent/sessions/session.rb, lib/agent/sessions/version.rb, lib/agent/sessions/location.rb, lib/agent/sessions/compaction.rb, lib/agent/sessions/readers/pi.rb, lib/agent/sessions/adapters/pi.rb, lib/agent/sessions/readers/amp.rb, lib/agent/sessions/adapters/amp.rb, lib/agent/sessions/env_override.rb, lib/agent/sessions/readers/base.rb, lib/agent/sessions/readers/grok.rb, lib/agent/sessions/readers/qwen.rb, lib/agent/sessions/adapters/base.rb, lib/agent/sessions/adapters/grok.rb, lib/agent/sessions/adapters/qwen.rb, lib/agent/sessions/readers/codex.rb, lib/agent/sessions/unknown_agent.rb, lib/agent/sessions/adapters/codex.rb, lib/agent/sessions/home_expansion.rb, lib/agent/sessions/readers/claude.rb, lib/agent/sessions/readers/gemini.rb, lib/agent/sessions/adapters/claude.rb, lib/agent/sessions/adapters/cursor.rb, lib/agent/sessions/adapters/gemini.rb, lib/agent/sessions/readers/copilot.rb, lib/agent/sessions/adapters/copilot.rb, lib/agent/sessions/readers/opencode.rb, lib/agent/sessions/unreadable_store.rb, lib/agent/sessions/adapters/opencode.rb, lib/agent/sessions/missing_dependency.rb, lib/agent/sessions/unsupported_format.rb, lib/agent/sessions/adapters/cursor_ide.rb, lib/agent/sessions/adapters/enumeration.rb |
+
+## Constants
+### `LOADER` <a id="constant-LOADER"></a> <a id="LOADER-constant"></a>
+Not documented.
+
+### `STALE_AFTER_DAYS` <a id="constant-STALE_AFTER_DAYS"></a> <a id="STALE_AFTER_DAYS-constant"></a>
+Not documented.
+
+### `VERIFIED_ON` <a id="constant-VERIFIED_ON"></a> <a id="VERIFIED_ON-constant"></a>
+The oldest verified_on among the built-in adapters. A claim about somebody
+else's software is only as current as its weakest link, so this is the honest
+answer to "when was this last known to be true".
+
+### `VERSION` <a id="constant-VERSION"></a> <a id="VERSION-constant"></a>
+Not documented.
+
+## Public Class Methods
+### `agents()` <a id="method-c-agents"></a> <a id="agents-class_method"></a>
+Not documented.
+
+### `all(env: ENV)` <a id="method-c-all"></a> <a id="all-class_method"></a>
+Not documented.
+
+### `audit(env: ENV)` <a id="method-c-audit"></a> <a id="audit-class_method"></a>
+Not documented.
+
+### `doctor(agent = nil, env: ENV, today: Date.today)` <a id="method-c-doctor"></a> <a id="doctor-class_method"></a>
+Not documented.
+
+### `for_project(dir, env: ENV, agents: nil)` <a id="method-c-for_project"></a> <a id="for_project-class_method"></a>
+One project across every agent (or the agents: subset), lazily: adapters
+earlier in the sweep satisfy `first(n)` without the later ones ever being
+asked. Within one adapter, though, laziness cannot skip non-matching sessions
+— sessions_for_project must still stat and check each candidate to know it
+does not match, so an adapter with zero matches costs a full scan of its store
+before the sweep moves on. True of the six Base-driven adapters; opencode
+pushes the filter into SQL (WHERE directory = ?) and stats nothing.
+
+Deliberately does NOT rescue MissingDependency or UnreadableStore: opencode
+without the sqlite3 gem, or with a corrupt/locked database, raises. Since
+`flat_map` is lazy, that raise surfaces only once enumeration reaches the
+failing adapter — possibly after other agents' sessions have already been
+yielded to the caller mid-iteration, and possibly not at all if `first(n)` is
+satisfied first. Silently omitting an agent's sessions is this gem's worst
+failure mode (design doc decision 11), so this method never trades a raised,
+attributable error for a quietly incomplete list. A caller that wants the
+sweep to survive one bad agent should rescue per call, e.g. by driving
+<code>agents:</code> itself and catching around each adapter; a caller who
+just wants to route around a known-bad agent can pass <code>agents:</code>
+naming every registered agent except it. The CLI (Task 10) does the former,
+turning the same exceptions into per-agent "skipped" lines instead of one
+failed sweep. Note a rescue cannot resume this enumerator: re-calling each
+after a raise re-raises from the same adapter. The only recovery is a fresh
+call with a narrower <code>agents:</code>. Adapters are resolved eagerly, so
+an unknown name in <code>agents:</code> raises here rather than mid-sweep. The
+deferral above is about DATA conditions, where the raise carries information
+about a store; a typo'd agent symbol is a programmer error knowable before any
+I/O, and `agents: [:claude, :nope]` otherwise hands back Claude's sessions and
+then crashes. Base#initialize only stores @env, so constructing all seven up
+front costs nothing, and the sweep stays lazy — first(n) still stops at the
+first matching adapter.
+
+### `installed(env: ENV)` <a id="method-c-installed"></a> <a id="installed-class_method"></a>
+Not documented.
+
+### `locate(agent, env: ENV)` <a id="method-c-locate"></a> <a id="locate-class_method"></a>
+Not documented.
+
+### `projects(agent, env: ENV)` <a id="method-c-projects"></a> <a id="projects-class_method"></a>
+Eager, unlike sessions/for_project: project_paths already reads every session
+to answer (design doc section 7 — the on-disk encodings are lossy, so the
+recorded cwd is the only reliable source), sorts, and dedupes, so a lazy
+return type here would promise a laziness the work underneath cannot honor.
+Returns a plain, already-sorted Array. Raises MissingDependency or
+UnreadableStore for opencode, as sessions does.
+
+### `read(session, **options)` <a id="method-c-read"></a> <a id="read-class_method"></a>
+Layer 3. Takes a Session (from `sessions`, `for_project`), not an agent name,
+because reading is per-session — the adapter comes from the session itself.
+Raises UnsupportedFormat for an agent with no reader yet, rather than
+returning a reader that yields nothing: "this gem cannot read that format" and
+"that session has no messages" must never look alike.
+
+include_events: true adds the agent's UI-level records to the stream where an
+adapter has them. They are excluded by default because they are bookkeeping,
+not conversation, and they outnumber real messages.
+
+### `register(adapter_class)` <a id="method-c-register"></a> <a id="register-class_method"></a>
+Re-registering a name deliberately replaces it, so a consumer can ship a
+corrected adapter for an agent whose layout moved before the gem catches up.
+- **@raise** [Error]
+
+### `registry()` <a id="method-c-registry"></a> <a id="registry-class_method"></a>
+Not documented.
+
+### `sessions(agent, env: ENV, since: nil)` <a id="method-c-sessions"></a> <a id="sessions-class_method"></a>
+Lazy: consuming N sessions stats N files, never more. `since`, when given,
+must be a Time (or anything Time#>= accepts) — comparing updated_at (always a
+Time; every adapter populates it, from mtime or store metadata) against a
+Date, Integer, or String raises ArgumentError("comparison of Time with ...
+failed"), which already names the mistake, so no extra guard is added here.
+That raise happens on enumeration, not on this call, because the filter itself
+is lazy — `sessions(:x, since: bad).first(1)` can raise from inside `first`,
+not from this line. Raises MissingDependency or UnreadableStore for opencode
+under the same conditions described on for_project below.
+
+### `unresolved_project_count(agent, env: ENV)` <a id="method-c-unresolved_project_count"></a> <a id="unresolved_project_count-class_method"></a>
+Companion to `projects`/`project_paths`, which both exclude a session whose
+project could not be resolved rather than counting it (design doc section 7) —
+so "this agent genuinely records no projects" and "this agent's project
+resolution is broken" read identically from the outside. Three of seven
+adapters can legitimately return a nil project_path (Amp threads with no
+`trees`, cursor_ide by design, pi whenever its unverified header assumption is
+wrong); this counts it for any of them, uniformly, using only the public
+`sessions` enumerator —no adapter needs to know this exists. Eager and a
+second full sweep of the store, same cost class as `projects` itself, so it is
+opt-in (called by the CLI only under `list --project`, never under plain
+`list`) rather than folded into `projects`' own return value, which is a
+documented, tested plain Array and would otherwise need a shape change to
+carry both numbers. Raises MissingDependency or UnreadableStore for opencode,
+as sessions does.
+
+### `verify(agent = nil, env: ENV)` <a id="method-c-verify"></a> <a id="verify-class_method"></a>
+Not documented.
+
+# Documentation
+
+- [doc/Agent/Sessions/Adapters.md](doc/Agent/Sessions/Adapters.md)
+- [doc/Agent/Sessions/Adapters/Amp.md](doc/Agent/Sessions/Adapters/Amp.md)
+- [doc/Agent/Sessions/Adapters/Base.md](doc/Agent/Sessions/Adapters/Base.md)
+- [doc/Agent/Sessions/Adapters/Claude.md](doc/Agent/Sessions/Adapters/Claude.md)
+- [doc/Agent/Sessions/Adapters/Codex.md](doc/Agent/Sessions/Adapters/Codex.md)
+- [doc/Agent/Sessions/Adapters/Copilot.md](doc/Agent/Sessions/Adapters/Copilot.md)
+- [doc/Agent/Sessions/Adapters/Cursor.md](doc/Agent/Sessions/Adapters/Cursor.md)
+- [doc/Agent/Sessions/Adapters/CursorIde.md](doc/Agent/Sessions/Adapters/CursorIde.md)
+- [doc/Agent/Sessions/Adapters/Enumeration.md](doc/Agent/Sessions/Adapters/Enumeration.md)
+- [doc/Agent/Sessions/Adapters/Gemini.md](doc/Agent/Sessions/Adapters/Gemini.md)
+- [doc/Agent/Sessions/Adapters/Grok.md](doc/Agent/Sessions/Adapters/Grok.md)
+- [doc/Agent/Sessions/Adapters/Opencode.md](doc/Agent/Sessions/Adapters/Opencode.md)
+- [doc/Agent/Sessions/Adapters/Pi.md](doc/Agent/Sessions/Adapters/Pi.md)
+- [doc/Agent/Sessions/Adapters/Qwen.md](doc/Agent/Sessions/Adapters/Qwen.md)
+- [doc/Agent/Sessions/Audit.md](doc/Agent/Sessions/Audit.md)
+- [doc/Agent/Sessions/Audit/Finding.md](doc/Agent/Sessions/Audit/Finding.md)
+- [doc/Agent/Sessions/CLI.md](doc/Agent/Sessions/CLI.md)
+- [doc/Agent/Sessions/Check.md](doc/Agent/Sessions/Check.md)
+- [doc/Agent/Sessions/Compaction.md](doc/Agent/Sessions/Compaction.md)
+- [doc/Agent/Sessions/EnvOverride.md](doc/Agent/Sessions/EnvOverride.md)
+- [doc/Agent/Sessions/Error.md](doc/Agent/Sessions/Error.md)
+- [doc/Agent/Sessions/HomeExpansion.md](doc/Agent/Sessions/HomeExpansion.md)
+- [doc/Agent/Sessions/Location.md](doc/Agent/Sessions/Location.md)
+- [doc/Agent/Sessions/Message.md](doc/Agent/Sessions/Message.md)
+- [doc/Agent/Sessions/MissingDependency.md](doc/Agent/Sessions/MissingDependency.md)
+- [doc/Agent/Sessions/Node.md](doc/Agent/Sessions/Node.md)
+- [doc/Agent/Sessions/Part.md](doc/Agent/Sessions/Part.md)
+- [doc/Agent/Sessions/Readers.md](doc/Agent/Sessions/Readers.md)
+- [doc/Agent/Sessions/Readers/Amp.md](doc/Agent/Sessions/Readers/Amp.md)
+- [doc/Agent/Sessions/Readers/Base.md](doc/Agent/Sessions/Readers/Base.md)
+- [doc/Agent/Sessions/Readers/Claude.md](doc/Agent/Sessions/Readers/Claude.md)
+- [doc/Agent/Sessions/Readers/Codex.md](doc/Agent/Sessions/Readers/Codex.md)
+- [doc/Agent/Sessions/Readers/Copilot.md](doc/Agent/Sessions/Readers/Copilot.md)
+- [doc/Agent/Sessions/Readers/Gemini.md](doc/Agent/Sessions/Readers/Gemini.md)
+- [doc/Agent/Sessions/Readers/Grok.md](doc/Agent/Sessions/Readers/Grok.md)
+- [doc/Agent/Sessions/Readers/Opencode.md](doc/Agent/Sessions/Readers/Opencode.md)
+- [doc/Agent/Sessions/Readers/Pi.md](doc/Agent/Sessions/Readers/Pi.md)
+- [doc/Agent/Sessions/Readers/Qwen.md](doc/Agent/Sessions/Readers/Qwen.md)
+- [doc/Agent/Sessions/Session.md](doc/Agent/Sessions/Session.md)
+- [doc/Agent/Sessions/Sqlite.md](doc/Agent/Sessions/Sqlite.md)
+- [doc/Agent/Sessions/Store.md](doc/Agent/Sessions/Store.md)
+- [doc/Agent/Sessions/UnknownAgent.md](doc/Agent/Sessions/UnknownAgent.md)
+- [doc/Agent/Sessions/UnreadableStore.md](doc/Agent/Sessions/UnreadableStore.md)
+- [doc/Agent/Sessions/UnsupportedFormat.md](doc/Agent/Sessions/UnsupportedFormat.md)
+- [doc/Agent/Sessions/Usage.md](doc/Agent/Sessions/Usage.md)