Interface: ImportCursorPosition

Makaio Framework / ai-adapters-core / ImportCursorPosition

Interface: ImportCursorPosition

Defined in: ../../../adapters/core/src/log-importer/types.ts:112

Cursor position for tracking import progress within a file.

Used to resume import from the last successfully processed position after restarts, avoiding duplicate event emission.

Remarks

Cursors track byte offsets rather than line numbers for efficiency and to handle partial lines correctly. The lastModified timestamp enables detection of file truncation/rotation.

See

LogImporter - Uses cursors for incremental import

Properties

bytesRead

bytesRead: number

Defined in: ../../../adapters/core/src/log-importer/types.ts:117

Number of bytes successfully read and processed

filePath

filePath: string

Defined in: ../../../adapters/core/src/log-importer/types.ts:114

Absolute path to the log file being tracked

lastModified

lastModified: string

Defined in: ../../../adapters/core/src/log-importer/types.ts:120

ISO 8601 timestamp of file’s last modification when cursor was saved

sessionContext?

optional sessionContext?: object & object

Defined in: ../../../adapters/core/src/log-importer/types.ts:126

Session context for incremental imports (persisted on first read). Contains adapter-specific state needed to resume processing mid-session.

Type Declaration

cwd

cwd: string | null

Working directory (null if unknown, e.g., some external imports)

model

model: string | null

Model identifier (null if unknown, e.g., some external imports)

Type Declaration

adapterSessionId

adapterSessionId: string

Adapter’s native session identifier

sessionEvent

sessionEvent: NormalizedEvent

Session discovered event (emitted once at session start)

startedEvent

startedEvent: NormalizedEvent

Agent started event (emitted once at session start)

state

state: JsonObject

Serialized adapter-specific state for resumption