Interface CursorStore

Abstraction for persisting the event feed cursor between restarts.

interface CursorStore {
    getCursor(): Promise<string | null>;
    setCursor(cursor: string): Promise<void>;
    clearCursor(): Promise<void>;
}

Implemented by

Index

Methods

getCursor setCursor clearCursor

Methods

getCursor

getCursor(): Promise<string | null>
Returns Promise<string | null>
- Defined in src/lib/registry/cursor-store.ts:8

setCursor

setCursor(cursor: string): Promise<void>
Parameters
- cursor: string
Returns Promise<void>
- Defined in src/lib/registry/cursor-store.ts:9

clearCursor

clearCursor(): Promise<void>
Remove the persisted cursor. Used by sync engines on RETENTION_EXPIRED recovery — the agent no longer holds events for our cursor, so we re-bootstrap and want subsequent getCursor() calls to return null.

Implementations may delete the underlying storage (file) or store a sentinel value, as long as getCursor() returns null afterward.

Returns Promise<void>
- Defined in src/lib/registry/cursor-store.ts:18