@getbourdon/participants 0.2.3 → 0.2.4

package/dist/readers/cursor.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Cursor participant — reads Cursor's (the AI-first IDE) SQLite-backed
+ * workspace/composer state and normalizes it into L5. Port of
+ * `participants/cursor.py` + the extraction helper `participants/_cursor_sqlite.py`.
+ *
+ * Cursor stores workspace state in `state.vscdb` SQLite DBs at platform-specific
+ * paths (`~/.config/Cursor/`, `~/Library/Application Support/Cursor/`,
+ * `%APPDATA%/Cursor/`). This reader discovers those stores, reads the `ItemTable`
+ * key/value rows read-only, parses the composer/chat records into sessions +
+ * project/topic entities, and merges curated `.cursor/memory/short-index.json`
+ * entities alongside them.
+ *
+ * SQLite access: the Python oracle copies each DB (+ its `-wal`/`-shm`
+ * companions) to a tmp file and opens it read-write so SQLite folds the WAL into
+ * a consistent snapshot. The TS mirror instead leans on {@link tryOpenReadonly}
+ * (`mode=ro`), which respects SQLite locking and reads the `-wal` sidecar of a
+ * live writer — the same consistent view without the copy. Read-only,
+ * deterministic, visibility-enforced-before-emission, redaction on every native
+ * string; `healthCheck` never throws.
+ */
+import { type L5ManifestModel, type SessionModel } from "@getbourdon/l5";
+import { type AgentStore, type BourdonParticipant, type HealthStatus } from "../base.js";
+/**
+ * Platform-specific Cursor data dir (the SQLite workspace state lives here),
+ * `$CURSOR_DIR` override first. Returns null on an unrecognized platform (or
+ * Windows without `%APPDATA%`). Mirrors `default_cursor_dir`.
+ */
+export declare function defaultCursorDir(): string | null;
+/** External participant for Cursor's SQLite workspace state. */
+export declare class CursorParticipant implements BourdonParticipant {
+    agentId: string;
+    agentType: string;
+    private readonly cursorDir;
+    private readonly workspaceRoot;
+    private readonly policy;
+    /**
+     * Conventional Cursor config dir (`~/.cursor`) used by the setup wizard. The
+     * wizard probes `~/.cursor` for presence; the SQLite workspace state that
+     * `exportL5` actually reads lives at {@link defaultCursorDir}. Detection and
+     * extraction intentionally use different anchors.
+     */
+    static defaultNativePath(home?: string): string;
+    constructor(cursorDir?: string | null, workspaceRoot?: string | null);
+    get nativePath(): string;
+    discover(): AgentStore;
+    exportSessions(since?: Date, limit?: number): SessionModel[];
+    exportL5(since?: Date): L5ManifestModel;
+    healthCheck(): HealthStatus;
+    private extract;
+}