braindump 0.3.0

package/dist/core/watcher.js

@@ -0,0 +1,208 @@
+import { getAdapter } from "../adapters/index.js";
+const DEFAULT_INTERVAL_MS = 30_000;
+const ALL_AGENTS = ["claude-code", "cursor", "codex"];
+/**
+ * Polling watcher for agent sessions.
+ * Uses adapter.listSessions() snapshots to detect changes and stale sessions.
+ */
+export class Watcher {
+    static activeInstance = null;
+    state = {
+        timestamp: new Date().toISOString(),
+        agents: [],
+        activeSessions: {},
+        running: false,
+    };
+    options = {};
+    pollTimer = null;
+    tracking = new Map();
+    async start(options = {}) {
+        if (this.state.running) {
+            return;
+        }
+        if (Watcher.activeInstance && Watcher.activeInstance !== this) {
+            throw new Error("Watcher is already running in this process");
+        }
+        const agents = options.agents && options.agents.length > 0
+            ? [...options.agents]
+            : await this.detectAgents();
+        this.options = {
+            ...options,
+            agents,
+            interval: options.interval ?? DEFAULT_INTERVAL_MS,
+        };
+        this.state = {
+            timestamp: new Date().toISOString(),
+            agents,
+            activeSessions: {},
+            running: true,
+        };
+        Watcher.activeInstance = this;
+        await this.takeSnapshot();
+        const interval = this.options.interval ?? DEFAULT_INTERVAL_MS;
+        this.pollTimer = setInterval(() => {
+            void this.takeSnapshot();
+        }, interval);
+    }
+    async stop() {
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        this.state = {
+            ...this.state,
+            timestamp: new Date().toISOString(),
+            running: false,
+        };
+        this.tracking.clear();
+        if (Watcher.activeInstance === this) {
+            Watcher.activeInstance = null;
+        }
+    }
+    getState() {
+        return this.state;
+    }
+    async takeSnapshot() {
+        const now = new Date().toISOString();
+        const agents = this.state.agents;
+        const activeSessions = {};
+        const seenKeys = new Set();
+        let emittedEventCount = 0;
+        for (const agentId of agents) {
+            const adapter = getAdapter(agentId);
+            let sessions = [];
+            try {
+                sessions = await adapter.listSessions(this.options.projectPath);
+            }
+            catch {
+                continue;
+            }
+            for (const session of sessions) {
+                const sessionId = session.id;
+                const sessionKey = this.makeSessionKey(agentId, sessionId);
+                seenKeys.add(sessionKey);
+                const messageCount = session.messageCount ?? 0;
+                const previous = this.state.activeSessions[sessionKey];
+                const tracking = this.tracking.get(sessionKey) ?? {
+                    unchangedIntervals: 0,
+                    hadGrowth: false,
+                    rateLimitEmitted: false,
+                };
+                activeSessions[sessionKey] = {
+                    messageCount,
+                    lastCheckedAt: now,
+                    lastChangedAt: previous?.lastChangedAt,
+                };
+                if (!previous) {
+                    activeSessions[sessionKey].lastChangedAt = now;
+                    tracking.unchangedIntervals = 0;
+                    tracking.hadGrowth = false;
+                    tracking.rateLimitEmitted = false;
+                    emittedEventCount += this.emitEvent({
+                        type: "new-session",
+                        agentId,
+                        sessionId,
+                        timestamp: now,
+                        details: `Detected new session ${sessionId}`,
+                    });
+                }
+                else if (messageCount > previous.messageCount) {
+                    activeSessions[sessionKey].lastChangedAt = now;
+                    tracking.unchangedIntervals = 0;
+                    tracking.hadGrowth = true;
+                    tracking.rateLimitEmitted = false;
+                    emittedEventCount += this.emitEvent({
+                        type: "session-update",
+                        agentId,
+                        sessionId,
+                        timestamp: now,
+                        details: `Message count ${previous.messageCount} -> ${messageCount}`,
+                    });
+                }
+                else if (messageCount === previous.messageCount) {
+                    tracking.unchangedIntervals += 1;
+                    activeSessions[sessionKey].lastChangedAt = previous.lastChangedAt;
+                    // Heuristic rate-limit signal: stale after growth across 2+ checks.
+                    if (tracking.unchangedIntervals >= 2 &&
+                        messageCount > 0 &&
+                        tracking.hadGrowth &&
+                        !tracking.rateLimitEmitted) {
+                        tracking.rateLimitEmitted = true;
+                        emittedEventCount += this.emitEvent({
+                            type: "rate-limit",
+                            agentId,
+                            sessionId,
+                            timestamp: now,
+                            details: "Session stale for 2+ polls after prior growth",
+                        });
+                    }
+                }
+                else {
+                    activeSessions[sessionKey].lastChangedAt = now;
+                    tracking.unchangedIntervals = 0;
+                    tracking.hadGrowth = false;
+                    tracking.rateLimitEmitted = false;
+                    emittedEventCount += this.emitEvent({
+                        type: "session-update",
+                        agentId,
+                        sessionId,
+                        timestamp: now,
+                        details: `Message count decreased ${previous.messageCount} -> ${messageCount}`,
+                    });
+                }
+                this.tracking.set(sessionKey, tracking);
+            }
+        }
+        for (const existingKey of Object.keys(this.state.activeSessions)) {
+            if (!seenKeys.has(existingKey)) {
+                this.tracking.delete(existingKey);
+            }
+        }
+        this.state = {
+            timestamp: now,
+            agents,
+            activeSessions,
+            running: this.state.running,
+        };
+        if (emittedEventCount === 0 && agents.length > 0) {
+            this.emitEvent({
+                type: "idle",
+                agentId: agents[0],
+                timestamp: now,
+                details: "No session changes detected",
+            });
+        }
+        return this.state;
+    }
+    async detectAgents() {
+        const detected = [];
+        for (const agentId of ALL_AGENTS) {
+            try {
+                const adapter = getAdapter(agentId);
+                if (await adapter.detect()) {
+                    detected.push(agentId);
+                }
+            }
+            catch {
+                // Skip failing adapters.
+            }
+        }
+        return detected;
+    }
+    emitEvent(event) {
+        if (!this.options.onEvent) {
+            return 0;
+        }
+        try {
+            this.options.onEvent(event);
+            return 1;
+        }
+        catch {
+            return 0;
+        }
+    }
+    makeSessionKey(agentId, sessionId) {
+        return `${agentId}:${sessionId}`;
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/core/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/core/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AASlD,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,MAAM,UAAU,GAAc,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAQjE;;;GAGG;AACH,MAAM,OAAO,OAAO;IACV,MAAM,CAAC,cAAc,GAAmB,IAAI,CAAC;IAE7C,KAAK,GAAiB;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE,EAAE;QACV,cAAc,EAAE,EAAE;QAClB,OAAO,EAAE,KAAK;KACf,CAAC;IAEM,OAAO,GAAmB,EAAE,CAAC;IAC7B,SAAS,GAA0C,IAAI,CAAC;IACxD,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IAE3D,KAAK,CAAC,KAAK,CAAC,UAA0B,EAAE;QACtC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YACzC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;YACrB,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAEhC,IAAI,CAAC,OAAO,GAAG;YACb,GAAG,OAAO;YACV,MAAM;YACN,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,mBAAmB;SAClD,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG;YACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM;YACN,cAAc,EAAE,EAAE;YAClB,OAAO,EAAE,IAAI;SACd,CAAC;QAEF,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;QAC9B,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,mBAAmB,CAAC;QAC9D,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAChC,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;QAC3B,CAAC,EAAE,QAAQ,CAAC,CAAC;IACf,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QAED,IAAI,CAAC,KAAK,GAAG;YACX,GAAG,IAAI,CAAC,KAAK;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE,KAAK;SACf,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEtB,IAAI,OAAO,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACpC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;QAChC,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAEjC,MAAM,cAAc,GAAmC,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAE1B,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,QAAQ,GAAkB,EAAE,CAAC;YAEjC,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAClE,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC;gBAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;gBAC3D,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAEzB,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC;gBAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;gBACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI;oBAChD,kBAAkB,EAAE,CAAC;oBACrB,SAAS,EAAE,KAAK;oBAChB,gBAAgB,EAAE,KAAK;iBACxB,CAAC;gBAEF,cAAc,CAAC,UAAU,CAAC,GAAG;oBAC3B,YAAY;oBACZ,aAAa,EAAE,GAAG;oBAClB,aAAa,EAAE,QAAQ,EAAE,aAAa;iBACvC,CAAC;gBAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,cAAc,CAAC,UAAU,CAAC,CAAC,aAAa,GAAG,GAAG,CAAC;oBAC/C,QAAQ,CAAC,kBAAkB,GAAG,CAAC,CAAC;oBAChC,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC;oBAC3B,QAAQ,CAAC,gBAAgB,GAAG,KAAK,CAAC;oBAClC,iBAAiB,IAAI,IAAI,CAAC,SAAS,CAAC;wBAClC,IAAI,EAAE,aAAa;wBACnB,OAAO;wBACP,SAAS;wBACT,SAAS,EAAE,GAAG;wBACd,OAAO,EAAE,wBAAwB,SAAS,EAAE;qBAC7C,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,YAAY,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC;oBAChD,cAAc,CAAC,UAAU,CAAC,CAAC,aAAa,GAAG,GAAG,CAAC;oBAC/C,QAAQ,CAAC,kBAAkB,GAAG,CAAC,CAAC;oBAChC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;oBAC1B,QAAQ,CAAC,gBAAgB,GAAG,KAAK,CAAC;oBAClC,iBAAiB,IAAI,IAAI,CAAC,SAAS,CAAC;wBAClC,IAAI,EAAE,gBAAgB;wBACtB,OAAO;wBACP,SAAS;wBACT,SAAS,EAAE,GAAG;wBACd,OAAO,EAAE,iBAAiB,QAAQ,CAAC,YAAY,OAAO,YAAY,EAAE;qBACrE,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,YAAY,KAAK,QAAQ,CAAC,YAAY,EAAE,CAAC;oBAClD,QAAQ,CAAC,kBAAkB,IAAI,CAAC,CAAC;oBACjC,cAAc,CAAC,UAAU,CAAC,CAAC,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC;oBAElE,oEAAoE;oBACpE,IACE,QAAQ,CAAC,kBAAkB,IAAI,CAAC;wBAChC,YAAY,GAAG,CAAC;wBAChB,QAAQ,CAAC,SAAS;wBAClB,CAAC,QAAQ,CAAC,gBAAgB,EAC1B,CAAC;wBACD,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC;wBACjC,iBAAiB,IAAI,IAAI,CAAC,SAAS,CAAC;4BAClC,IAAI,EAAE,YAAY;4BAClB,OAAO;4BACP,SAAS;4BACT,SAAS,EAAE,GAAG;4BACd,OAAO,EAAE,+CAA+C;yBACzD,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,cAAc,CAAC,UAAU,CAAC,CAAC,aAAa,GAAG,GAAG,CAAC;oBAC/C,QAAQ,CAAC,kBAAkB,GAAG,CAAC,CAAC;oBAChC,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC;oBAC3B,QAAQ,CAAC,gBAAgB,GAAG,KAAK,CAAC;oBAClC,iBAAiB,IAAI,IAAI,CAAC,SAAS,CAAC;wBAClC,IAAI,EAAE,gBAAgB;wBACtB,OAAO;wBACP,SAAS;wBACT,SAAS,EAAE,GAAG;wBACd,OAAO,EAAE,2BAA2B,QAAQ,CAAC,YAAY,OAAO,YAAY,EAAE;qBAC/E,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,GAAG;YACX,SAAS,EAAE,GAAG;YACd,MAAM;YACN,cAAc;YACd,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;SAC5B,CAAC;QAEF,IAAI,iBAAiB,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;gBAClB,SAAS,EAAE,GAAG;gBACd,OAAO,EAAE,6BAA6B;aACvC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;gBACpC,IAAI,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC3B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,yBAAyB;YAC3B,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,SAAS,CAAC,KAAmB;QACnC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,OAAgB,EAAE,SAAiB;QACxD,OAAO,GAAG,OAAO,IAAI,SAAS,EAAE,CAAC;IACnC,CAAC"}

package/dist/providers/clipboard-provider.d.ts

@@ -0,0 +1,8 @@
+import type { ResumeProvider, ProviderOptions } from "../types/index.js";
+/**
+ * Copies the resume prompt to the system clipboard.
+ */
+export declare class ClipboardProvider implements ResumeProvider {
+    deliver(content: string, options?: ProviderOptions): Promise<void>;
+}
+//# sourceMappingURL=clipboard-provider.d.ts.map

package/dist/providers/clipboard-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard-provider.d.ts","sourceRoot":"","sources":["../../src/providers/clipboard-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;GAEG;AACH,qBAAa,iBAAkB,YAAW,cAAc;IAChD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAUzE"}

package/dist/providers/clipboard-provider.js

@@ -0,0 +1,15 @@
+import clipboard from "clipboardy";
+/**
+ * Copies the resume prompt to the system clipboard.
+ */
+export class ClipboardProvider {
+    async deliver(content, options) {
+        try {
+            await clipboard.write(content);
+        }
+        catch (error) {
+            console.warn("Clipboard not available — skipping clipboard copy.", error instanceof Error ? error.message : error);
+        }
+    }
+}
+//# sourceMappingURL=clipboard-provider.js.map

package/dist/providers/clipboard-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard-provider.js","sourceRoot":"","sources":["../../src/providers/clipboard-provider.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,YAAY,CAAC;AAGnC;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,OAAyB;QACtD,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CACV,oDAAoD,EACpD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/providers/file-provider.d.ts

@@ -0,0 +1,8 @@
+import type { ResumeProvider, ProviderOptions } from "../types/index.js";
+/**
+ * Writes the resume prompt to .handoff/RESUME.md in the project directory.
+ */
+export declare class FileProvider implements ResumeProvider {
+    deliver(content: string, options?: ProviderOptions): Promise<void>;
+}
+//# sourceMappingURL=file-provider.d.ts.map

package/dist/providers/file-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-provider.d.ts","sourceRoot":"","sources":["../../src/providers/file-provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;GAEG;AACH,qBAAa,YAAa,YAAW,cAAc;IAC3C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAMzE"}

package/dist/providers/file-provider.js

@@ -0,0 +1,14 @@
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Writes the resume prompt to .handoff/RESUME.md in the project directory.
+ */
+export class FileProvider {
+    async deliver(content, options) {
+        const projectPath = options?.projectPath ?? process.cwd();
+        const handoffDir = path.join(projectPath, ".handoff");
+        fs.mkdirSync(handoffDir, { recursive: true });
+        fs.writeFileSync(path.join(handoffDir, "RESUME.md"), content, "utf-8");
+    }
+}
+//# sourceMappingURL=file-provider.js.map

package/dist/providers/file-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-provider.js","sourceRoot":"","sources":["../../src/providers/file-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;GAEG;AACH,MAAM,OAAO,YAAY;IACvB,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,OAAyB;QACtD,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACtD,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/providers/index.d.ts

@@ -0,0 +1,9 @@
+import type { ResumeProvider, AgentId } from "../types/index.js";
+import { FileProvider } from "./file-provider.js";
+import { ClipboardProvider } from "./clipboard-provider.js";
+/**
+ * Get the appropriate provider(s) for a given target.
+ */
+export declare function getProviders(target: AgentId | "clipboard" | "file"): ResumeProvider[];
+export { FileProvider, ClipboardProvider };
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,GACrC,cAAc,EAAE,CAUlB;AAED,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,18 @@
+import { FileProvider } from "./file-provider.js";
+import { ClipboardProvider } from "./clipboard-provider.js";
+/**
+ * Get the appropriate provider(s) for a given target.
+ */
+export function getProviders(target) {
+    switch (target) {
+        case "file":
+            return [new FileProvider()];
+        case "clipboard":
+            return [new ClipboardProvider()];
+        default:
+            // Agent ID target — use both file and clipboard (belt and suspenders)
+            return [new FileProvider(), new ClipboardProvider()];
+    }
+}
+export { FileProvider, ClipboardProvider };
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAsC;IAEtC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;QAC9B,KAAK,WAAW;YACd,OAAO,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;QACnC;YACE,sEAAsE;YACtE,OAAO,CAAC,IAAI,YAAY,EAAE,EAAE,IAAI,iBAAiB,EAAE,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,132 @@
+export interface CapturedSession {
+    version: "1.0";
+    source: AgentId;
+    capturedAt: string;
+    sessionId: string;
+    sessionStartedAt?: string;
+    project: ProjectContext;
+    conversation: Conversation;
+    filesChanged: FileChange[];
+    decisions: string[];
+    blockers: string[];
+    task: TaskState;
+}
+export interface ProjectContext {
+    path: string;
+    name?: string;
+    gitBranch?: string;
+    gitStatus?: string;
+    gitLog?: string[];
+    structure?: string;
+    memoryFileContents?: string;
+}
+export interface Conversation {
+    messageCount: number;
+    estimatedTokens: number;
+    summary?: string;
+    messages: ConversationMessage[];
+}
+export interface ConversationMessage {
+    role: "user" | "assistant" | "system" | "tool";
+    content: string;
+    toolName?: string;
+    timestamp?: string;
+    tokenCount?: number;
+}
+export interface FileChange {
+    path: string;
+    changeType: "created" | "modified" | "deleted";
+    diff?: string;
+    language?: string;
+}
+export interface TaskState {
+    description: string;
+    completed: string[];
+    remaining: string[];
+    inProgress?: string;
+    blockers: string[];
+}
+export type AgentId = "claude-code" | "cursor" | "codex";
+export interface SessionInfo {
+    id: string;
+    startedAt?: string;
+    lastActiveAt?: string;
+    messageCount?: number;
+    projectPath?: string;
+    preview?: string;
+}
+export interface AgentAdapter {
+    agentId: AgentId;
+    detect(): Promise<boolean>;
+    listSessions(projectPath?: string): Promise<SessionInfo[]>;
+    capture(sessionId: string): Promise<CapturedSession>;
+    captureLatest(projectPath?: string): Promise<CapturedSession>;
+}
+export interface CompressionOptions {
+    targetTokens?: number;
+    targetAgent?: AgentId | "clipboard" | "file";
+}
+export interface CompressionResult {
+    content: string;
+    totalTokens: number;
+    includedLayers: string[];
+    droppedLayers: string[];
+}
+export interface PriorityLayer {
+    name: string;
+    priority: number;
+    content: string;
+    tokens: number;
+}
+export interface ResumeProvider {
+    deliver(content: string, options?: ProviderOptions): Promise<void>;
+}
+export interface ProviderOptions {
+    projectPath?: string;
+    targetAgent?: AgentId;
+}
+export interface WatcherEvent {
+    type: "session-update" | "new-session" | "rate-limit" | "idle";
+    agentId: AgentId;
+    sessionId?: string;
+    timestamp: string;
+    details?: string;
+}
+export interface WatcherOptions {
+    agents?: AgentId[];
+    interval?: number;
+    projectPath?: string;
+    onEvent?: (event: WatcherEvent) => void;
+}
+export interface WatcherState {
+    timestamp: string;
+    agents: AgentId[];
+    activeSessions: Record<string, {
+        messageCount: number;
+        lastCheckedAt: string;
+        lastChangedAt?: string;
+    }>;
+    running: boolean;
+}
+export interface HandoffOptions {
+    source?: AgentId;
+    target?: AgentId | "clipboard" | "file";
+    session?: string;
+    project?: string;
+    tokens?: number;
+}
+export interface DetectResult {
+    agentId: AgentId;
+    detected: boolean;
+    path: string;
+    sessionCount?: number;
+}
+export interface AgentMeta {
+    id: AgentId;
+    name: string;
+    storagePaths: Record<string, string>;
+    contextWindow: number;
+    usableTokens: number;
+    memoryFiles: string[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+// === Portable Session Format ===
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,kCAAkC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "braindump",
+  "version": "0.3.0",
+  "description": "A CLI tool that captures your AI coding agent session and generates a portable resume prompt so you can seamlessly continue in a different agent.",
+  "type": "module",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "braindump": "dist/cli/index.js",
+    "agentrelay": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli/index.ts",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "handoff",
+    "claude",
+    "cursor",
+    "codex",
+    "cli",
+    "context",
+    "session",
+    "relay",
+    "braindump"
+  ],
+  "author": "Prateek Choudhary <prtkworks@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Kushalwho/agentrelay.git"
+  },
+  "homepage": "https://github.com/Kushalwho/agentrelay#readme",
+  "bugs": {
+    "url": "https://github.com/Kushalwho/agentrelay/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.0.0",
+    "chalk": "^5.3.0",
+    "clipboardy": "^4.0.0",
+    "commander": "^12.0.0",
+    "glob": "^11.0.0",
+    "ora": "^8.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^20.0.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.3.0"
+  }
+}