braindump 0.3.0

package/dist/core/prompt-builder.js

@@ -0,0 +1,88 @@
+import path from "node:path";
+const TARGET_HINTS = {
+    cursor: {
+        label: "Cursor (paste into Composer)",
+        footer: "Paste this into Cursor's Composer to continue.",
+    },
+    codex: {
+        label: "Codex CLI",
+        footer: "Feed this to Codex CLI with `codex resume` or paste it.",
+    },
+    "claude-code": {
+        label: "Claude Code",
+        footer: "Paste this into a new Claude Code session to continue.",
+    },
+};
+/**
+ * Builds the self-summarizing resume prompt (RESUME.md).
+ * Uses the compressed session data to generate a structured handoff document.
+ */
+export function buildResumePrompt(session, compressed, targetAgent) {
+    const projectName = session.project.name || path.basename(session.project.path);
+    const gitBranch = session.project.gitBranch || "unknown";
+    const completedList = session.task.completed.length > 0
+        ? session.task.completed.map((item) => `- ${item}`).join("\n")
+        : "- None yet";
+    const inProgressText = session.task.inProgress || "See remaining items";
+    const remainingList = session.task.remaining.length > 0
+        ? session.task.remaining.map((item) => `- ${item}`).join("\n")
+        : "- None";
+    const resumeAction = session.task.inProgress ||
+        session.task.remaining[0] ||
+        "the next logical step";
+    const targetHint = targetAgent && TARGET_HINTS[targetAgent]
+        ? TARGET_HINTS[targetAgent]
+        : null;
+    const lines = [
+        `# AgentRelay — Session Handoff`,
+        ``,
+        `> **Source:** ${session.source} | **Captured:** ${session.capturedAt}`,
+        `> **Project:** ${projectName} (${session.project.path}) | Branch: \`${gitBranch}\``,
+        ...(targetHint ? [`> **Target:** ${targetHint.label}`] : []),
+        ``,
+        `---`,
+        ``,
+        `## Instructions for Resuming Agent`,
+        ``,
+        `You are continuing a task that was started in a previous ${session.source} session.`,
+        `The previous session ended (likely due to token/rate limits).`,
+        ``,
+        `**Your job:**`,
+        `1. Read ALL the context below carefully and silently internalize it`,
+        `2. Do NOT summarize what you read back to the user`,
+        `3. Do NOT re-debate any decisions listed in "Key Decisions"`,
+        `4. Do NOT re-introduce yourself or ask if the user wants to continue`,
+        `5. Pick up EXACTLY where the previous agent left off`,
+        `6. Your first action should be to continue the in-progress work described below`,
+        ``,
+        `---`,
+        ``,
+        `## Current Task`,
+        ``,
+        `**Goal:** ${session.task.description}`,
+        ``,
+        `**Completed:**`,
+        completedList,
+        ``,
+        `**In Progress (continue this immediately):**`,
+        inProgressText,
+        ``,
+        `**Remaining:**`,
+        remainingList,
+        ``,
+        `---`,
+        ``,
+        compressed.content,
+        ``,
+        `---`,
+        ``,
+        `## Resume Now`,
+        ``,
+        `Continue the work described above. Start with ${resumeAction}.`,
+        `Do not ask for confirmation. Do not summarize. Just continue building.`,
+        ``,
+        targetHint ? targetHint.footer : "Paste into your target agent.",
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/core/prompt-builder.js.map

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

package/dist/core/registry.d.ts

@@ -0,0 +1,10 @@
+import type { AgentId, AgentMeta } from "../types/index.js";
+/**
+ * Agent metadata registry — storage paths, context windows, memory files per agent.
+ */
+export declare const AGENT_REGISTRY: Record<AgentId, AgentMeta>;
+/**
+ * Get the usable token budget for a given target.
+ */
+export declare function getUsableTokenBudget(target: AgentId | "clipboard" | "file"): number;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,CAqCrD,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,GACrC,MAAM,CAKR"}

package/dist/core/registry.js

@@ -0,0 +1,51 @@
+/**
+ * Agent metadata registry — storage paths, context windows, memory files per agent.
+ */
+export const AGENT_REGISTRY = {
+    "claude-code": {
+        id: "claude-code",
+        name: "Claude Code",
+        storagePaths: {
+            linux: "~/.claude/projects/",
+            darwin: "~/.claude/projects/",
+            win32: "~/.claude/projects/",
+        },
+        contextWindow: 200_000,
+        usableTokens: 120_000,
+        memoryFiles: ["CLAUDE.md", ".claude/CLAUDE.md"],
+    },
+    cursor: {
+        id: "cursor",
+        name: "Cursor",
+        storagePaths: {
+            linux: "~/.config/Cursor/User/workspaceStorage/",
+            darwin: "~/Library/Application Support/Cursor/User/workspaceStorage/",
+            win32: "%APPDATA%/Cursor/User/workspaceStorage/",
+        },
+        contextWindow: 64_000,
+        usableTokens: 38_000,
+        memoryFiles: [".cursorrules", ".cursor/rules/"],
+    },
+    codex: {
+        id: "codex",
+        name: "Codex CLI",
+        storagePaths: {
+            linux: "~/.codex/sessions/",
+            darwin: "~/.codex/sessions/",
+            win32: "~/.codex/sessions/",
+        },
+        contextWindow: 200_000,
+        usableTokens: 120_000,
+        memoryFiles: ["AGENTS.md", "~/.codex/AGENTS.md"],
+    },
+};
+/**
+ * Get the usable token budget for a given target.
+ */
+export function getUsableTokenBudget(target) {
+    if (target === "clipboard" || target === "file") {
+        return 19_000; // Universal safe default
+    }
+    return AGENT_REGISTRY[target].usableTokens;
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA+B;IACxD,aAAa,EAAE;QACb,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE;YACZ,KAAK,EAAE,qBAAqB;YAC5B,MAAM,EAAE,qBAAqB;YAC7B,KAAK,EAAE,qBAAqB;SAC7B;QACD,aAAa,EAAE,OAAO;QACtB,YAAY,EAAE,OAAO;QACrB,WAAW,EAAE,CAAC,WAAW,EAAE,mBAAmB,CAAC;KAChD;IACD,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE;YACZ,KAAK,EAAE,yCAAyC;YAChD,MAAM,EAAE,6DAA6D;YACrE,KAAK,EAAE,yCAAyC;SACjD;QACD,aAAa,EAAE,MAAM;QACrB,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,CAAC,cAAc,EAAE,gBAAgB,CAAC;KAChD;IACD,KAAK,EAAE;QACL,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,WAAW;QACjB,YAAY,EAAE;YACZ,KAAK,EAAE,oBAAoB;YAC3B,MAAM,EAAE,oBAAoB;YAC5B,KAAK,EAAE,oBAAoB;SAC5B;QACD,aAAa,EAAE,OAAO;QACtB,YAAY,EAAE,OAAO;QACrB,WAAW,EAAE,CAAC,WAAW,EAAE,oBAAoB,CAAC;KACjD;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAsC;IAEtC,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,CAAC,yBAAyB;IAC1C,CAAC;IACD,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC;AAC7C,CAAC"}

package/dist/core/token-estimator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Simple character-based token estimator.
+ * Heuristic: 1 token ≈ 4 characters for English text.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Check if content fits within a token budget.
+ */
+export declare function fitsInBudget(text: string, budget: number): boolean;
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/core/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../../src/core/token-estimator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAElE"}

package/dist/core/token-estimator.js

@@ -0,0 +1,14 @@
+/**
+ * Simple character-based token estimator.
+ * Heuristic: 1 token ≈ 4 characters for English text.
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Check if content fits within a token budget.
+ */
+export function fitsInBudget(text, budget) {
+    return estimateTokens(text) <= budget;
+}
+//# sourceMappingURL=token-estimator.js.map

package/dist/core/token-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.js","sourceRoot":"","sources":["../../src/core/token-estimator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAAc;IACvD,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;AACxC,CAAC"}

package/dist/core/validation.d.ts

@@ -0,0 +1,188 @@
+import { z } from "zod";
+export declare const ConversationMessageSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+        system: "system";
+        tool: "tool";
+    }>;
+    content: z.ZodString;
+    toolName: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodString>;
+    tokenCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const FileChangeSchema: z.ZodObject<{
+    path: z.ZodString;
+    changeType: z.ZodEnum<{
+        created: "created";
+        modified: "modified";
+        deleted: "deleted";
+    }>;
+    diff: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const TaskStateSchema: z.ZodObject<{
+    description: z.ZodString;
+    completed: z.ZodArray<z.ZodString>;
+    remaining: z.ZodArray<z.ZodString>;
+    inProgress: z.ZodOptional<z.ZodString>;
+    blockers: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const ProjectContextSchema: z.ZodObject<{
+    path: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    gitBranch: z.ZodOptional<z.ZodString>;
+    gitStatus: z.ZodOptional<z.ZodString>;
+    gitLog: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    structure: z.ZodOptional<z.ZodString>;
+    memoryFileContents: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CapturedSessionSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    source: z.ZodEnum<{
+        "claude-code": "claude-code";
+        cursor: "cursor";
+        codex: "codex";
+    }>;
+    capturedAt: z.ZodString;
+    sessionId: z.ZodString;
+    sessionStartedAt: z.ZodOptional<z.ZodString>;
+    project: z.ZodObject<{
+        path: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        gitBranch: z.ZodOptional<z.ZodString>;
+        gitStatus: z.ZodOptional<z.ZodString>;
+        gitLog: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        structure: z.ZodOptional<z.ZodString>;
+        memoryFileContents: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    conversation: z.ZodObject<{
+        messageCount: z.ZodNumber;
+        estimatedTokens: z.ZodNumber;
+        summary: z.ZodOptional<z.ZodString>;
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<{
+                user: "user";
+                assistant: "assistant";
+                system: "system";
+                tool: "tool";
+            }>;
+            content: z.ZodString;
+            toolName: z.ZodOptional<z.ZodString>;
+            timestamp: z.ZodOptional<z.ZodString>;
+            tokenCount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    filesChanged: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        changeType: z.ZodEnum<{
+            created: "created";
+            modified: "modified";
+            deleted: "deleted";
+        }>;
+        diff: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    decisions: z.ZodArray<z.ZodString>;
+    blockers: z.ZodArray<z.ZodString>;
+    task: z.ZodObject<{
+        description: z.ZodString;
+        completed: z.ZodArray<z.ZodString>;
+        remaining: z.ZodArray<z.ZodString>;
+        inProgress: z.ZodOptional<z.ZodString>;
+        blockers: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Validate a CapturedSession object. Throws ZodError if invalid.
+ */
+export declare function validateSession(data: unknown): {
+    version: "1.0";
+    source: "claude-code" | "cursor" | "codex";
+    capturedAt: string;
+    sessionId: string;
+    project: {
+        path: string;
+        name?: string | undefined;
+        gitBranch?: string | undefined;
+        gitStatus?: string | undefined;
+        gitLog?: string[] | undefined;
+        structure?: string | undefined;
+        memoryFileContents?: string | undefined;
+    };
+    conversation: {
+        messageCount: number;
+        estimatedTokens: number;
+        messages: {
+            role: "user" | "assistant" | "system" | "tool";
+            content: string;
+            toolName?: string | undefined;
+            timestamp?: string | undefined;
+            tokenCount?: number | undefined;
+        }[];
+        summary?: string | undefined;
+    };
+    filesChanged: {
+        path: string;
+        changeType: "created" | "modified" | "deleted";
+        diff?: string | undefined;
+        language?: string | undefined;
+    }[];
+    decisions: string[];
+    blockers: string[];
+    task: {
+        description: string;
+        completed: string[];
+        remaining: string[];
+        blockers: string[];
+        inProgress?: string | undefined;
+    };
+    sessionStartedAt?: string | undefined;
+};
+/**
+ * Safe validation - returns { success, data, error } without throwing.
+ */
+export declare function safeValidateSession(data: unknown): z.ZodSafeParseResult<{
+    version: "1.0";
+    source: "claude-code" | "cursor" | "codex";
+    capturedAt: string;
+    sessionId: string;
+    project: {
+        path: string;
+        name?: string | undefined;
+        gitBranch?: string | undefined;
+        gitStatus?: string | undefined;
+        gitLog?: string[] | undefined;
+        structure?: string | undefined;
+        memoryFileContents?: string | undefined;
+    };
+    conversation: {
+        messageCount: number;
+        estimatedTokens: number;
+        messages: {
+            role: "user" | "assistant" | "system" | "tool";
+            content: string;
+            toolName?: string | undefined;
+            timestamp?: string | undefined;
+            tokenCount?: number | undefined;
+        }[];
+        summary?: string | undefined;
+    };
+    filesChanged: {
+        path: string;
+        changeType: "created" | "modified" | "deleted";
+        diff?: string | undefined;
+        language?: string | undefined;
+    }[];
+    decisions: string[];
+    blockers: string[];
+    task: {
+        description: string;
+        completed: string[];
+        remaining: string[];
+        blockers: string[];
+        inProgress?: string | undefined;
+    };
+    sessionStartedAt?: string | undefined;
+}>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;;;;;;;;;iBAMpC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;iBAK3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;iBAM1B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;iBAQ/B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBhC,CAAC;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEhD"}

package/dist/core/validation.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+export const ConversationMessageSchema = z.object({
+    role: z.enum(["user", "assistant", "system", "tool"]),
+    content: z.string(),
+    toolName: z.string().optional(),
+    timestamp: z.string().optional(),
+    tokenCount: z.number().optional(),
+});
+export const FileChangeSchema = z.object({
+    path: z.string(),
+    changeType: z.enum(["created", "modified", "deleted"]),
+    diff: z.string().optional(),
+    language: z.string().optional(),
+});
+export const TaskStateSchema = z.object({
+    description: z.string(),
+    completed: z.array(z.string()),
+    remaining: z.array(z.string()),
+    inProgress: z.string().optional(),
+    blockers: z.array(z.string()),
+});
+export const ProjectContextSchema = z.object({
+    path: z.string(),
+    name: z.string().optional(),
+    gitBranch: z.string().optional(),
+    gitStatus: z.string().optional(),
+    gitLog: z.array(z.string()).optional(),
+    structure: z.string().optional(),
+    memoryFileContents: z.string().optional(),
+});
+export const CapturedSessionSchema = z.object({
+    version: z.literal("1.0"),
+    source: z.enum(["claude-code", "cursor", "codex"]),
+    capturedAt: z.string(),
+    sessionId: z.string(),
+    sessionStartedAt: z.string().optional(),
+    project: ProjectContextSchema,
+    conversation: z.object({
+        messageCount: z.number(),
+        estimatedTokens: z.number(),
+        summary: z.string().optional(),
+        messages: z.array(ConversationMessageSchema),
+    }),
+    filesChanged: z.array(FileChangeSchema),
+    decisions: z.array(z.string()),
+    blockers: z.array(z.string()),
+    task: TaskStateSchema,
+});
+/**
+ * Validate a CapturedSession object. Throws ZodError if invalid.
+ */
+export function validateSession(data) {
+    return CapturedSessionSchema.parse(data);
+}
+/**
+ * Safe validation - returns { success, data, error } without throwing.
+ */
+export function safeValidateSession(data) {
+    return CapturedSessionSchema.safeParse(data);
+}
+//# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

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

package/dist/core/watcher.d.ts

@@ -0,0 +1,20 @@
+import type { WatcherOptions, WatcherState } from "../types/index.js";
+/**
+ * Polling watcher for agent sessions.
+ * Uses adapter.listSessions() snapshots to detect changes and stale sessions.
+ */
+export declare class Watcher {
+    private static activeInstance;
+    private state;
+    private options;
+    private pollTimer;
+    private tracking;
+    start(options?: WatcherOptions): Promise<void>;
+    stop(): Promise<void>;
+    getState(): WatcherState | null;
+    takeSnapshot(): Promise<WatcherState>;
+    private detectAgents;
+    private emitEvent;
+    private makeSessionKey;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/core/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/core/watcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,cAAc,EACd,YAAY,EACb,MAAM,mBAAmB,CAAC;AAW3B;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAwB;IAErD,OAAO,CAAC,KAAK,CAKX;IAEF,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,QAAQ,CAA2C;IAErD,KAAK,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoClD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,QAAQ,IAAI,YAAY,GAAG,IAAI;IAIzB,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;YA4H7B,YAAY;IAe1B,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,cAAc;CAGvB"}