Expand description
Connectors for agent histories.
All connector implementations live in franken_agent_detection.
This module provides re-export stubs for backward-compatible import paths.
Modules§
- aider
- Connector for Aider session logs.
- amp
- Implementation lives in
franken_agent_detection::connectors::amp. - chatgpt
- Implementation lives in
franken_agent_detection::connectors::chatgpt. - claude_
code - Compatibility shim for the Claude Code connector.
- clawdbot
- Connector for Clawdbot session logs.
- cline
- Implementation lives in
franken_agent_detection::connectors::cline. - codex
- copilot
- Connector for GitHub Copilot Chat session logs.
- copilot_
cli - Connector for GitHub Copilot CLI (
gh copilot) event logs. - crush
- Connector for Charm’s Crush AI coding agent sessions.
- cursor
- Connector for Cursor session logs.
- factory
- Connector for Factory session logs.
- gemini
- Connector for Gemini session logs.
- hermes
- Connector for Hermes Agent session storage.
- kimi
- Connector for Kimi Code (Moonshot AI) session logs.
- openclaw
- Implementation lives in
franken_agent_detection::connectors::openclaw. - opencode
- Connector for OpenCode session logs.
- pi_
agent - Implementation lives in
franken_agent_detection::connectors::pi_agent. - qwen
- Connector for Qwen Code (Alibaba) session logs.
- vibe
- Connector for Vibe (Mistral) session logs.
Structs§
- Detection
Result - High-level detection status for a connector.
- Discovered
Source File - A file a connector is about to consume or consult while building sessions.
- Extracted
Token Usage - Extracted token usage from a single message’s raw data.
- Model
Info - Normalized model identification.
- Normalized
Conversation - Normalized conversation emitted by connectors.
- Normalized
Message - Normalized
Snippet - Origin
- Per-conversation provenance metadata.
- Path
Mapping - A single path mapping rule for rewriting paths.
- Path
Trie - Prefix trie optimized for workspace path rewriting.
- Scan
Context - Shared scan context parameters.
- Scan
Root - A root directory to scan with associated provenance.
- Workspace
Cache - Probabilistic workspace membership cache using bloom filter for fast rejection.
Enums§
- Discovered
Source Role - Connector-declared role for a file used during source reconstruction.
- Platform
- Platform hint for choosing default paths.
- Source
Kind - The kind/type of a source.
- Token
Data Source - Quality indicator for extracted token data.
Constants§
- LOCAL_
SOURCE_ ID - The default source ID for local conversations.
Traits§
- Connector
- The interface that all agent connectors implement.
Functions§
- estimate_
tokens_ from_ content - Estimate tokens from content length for agents that do not provide token data.
- extract_
claude_ code_ tokens - Extract token usage from a Claude Code message’s raw data.
- extract_
codex_ tokens - Extract token usage from a Codex message’s raw data.
- extract_
tokens_ for_ agent - Extract token usage from a message, dispatching by agent type.
- file_
modified_ since - Check if a file was modified since the given timestamp. Returns true if the file should be processed (modified since timestamp or no timestamp given).
- flatten_
content - Flatten content that may be a string or array of content blocks.
Extracts text from text blocks and tool names from
tool_useblocks. - franken_
detection_ for_ connector - Best-effort detection from franken-agent-detection for supported connectors.
- get_
connector_ factories - Get all available connector factories.
- normalize_
model - Normalize raw model strings into (family, tier, provider).
- parse_
timestamp - Parse a timestamp from either i64 milliseconds or ISO-8601 string. Returns milliseconds since Unix epoch, or None if unparseable.
- reindex_
messages - Re-assign sequential indices to messages starting from 0. Use this after filtering or sorting messages to ensure idx values are contiguous.