swarm-mail 0.1.3 → 0.2.0

package/README.md

@@ -30,6 +30,8 @@
 
 Event sourcing primitives for multi-agent coordination. Local-first, no external servers.
 
+**[🌐 swarmtools.ai](https://swarmtools.ai)** | **[📖 Full Documentation](https://swarmtools.ai/docs)**
+
 ```
 ┌─────────────────────────────────────────────────────────────┐
 │                     SWARM MAIL STACK                        │
@@ -190,6 +192,8 @@ Materialized views derived from events:
 
 ## API Reference
 
+For complete API documentation, see [swarmtools.ai/docs](https://swarmtools.ai/docs).
+
 ### SwarmMailAdapter
 
 ```typescript

package/bin/daemon-cli.ts

@@ -0,0 +1,304 @@
+#!/usr/bin/env bun
+/**
+ * swarm-mail-daemon CLI
+ *
+ * Command-line interface for managing the swarm-mail pglite-server daemon.
+ *
+ * Commands:
+ *   start [options]  - Start the daemon
+ *   stop             - Stop the daemon
+ *   status           - Show daemon status
+ *
+ * @example
+ * ```bash
+ * # Start daemon on default port
+ * swarm-mail-daemon start
+ *
+ * # Start with custom port
+ * swarm-mail-daemon start --port 5555
+ *
+ * # Start with Unix socket
+ * swarm-mail-daemon start --path /tmp/swarm-mail.sock
+ *
+ * # Check status
+ * swarm-mail-daemon status
+ *
+ * # Stop daemon
+ * swarm-mail-daemon stop
+ * ```
+ */
+
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { parseArgs } from "node:util";
+import {
+	type DaemonOptions,
+	getPidFilePath,
+	healthCheck,
+	isDaemonRunning,
+	startDaemon,
+	stopDaemon,
+} from "../src/daemon";
+
+// Colors for terminal output
+const colors = {
+	reset: "\x1b[0m",
+	red: "\x1b[31m",
+	green: "\x1b[32m",
+	yellow: "\x1b[33m",
+	blue: "\x1b[34m",
+	dim: "\x1b[2m",
+	bold: "\x1b[1m",
+};
+
+function success(msg: string) {
+	console.log(`${colors.green}✓${colors.reset} ${msg}`);
+}
+
+function error(msg: string) {
+	console.error(`${colors.red}✗${colors.reset} ${msg}`);
+}
+
+function info(msg: string) {
+	console.log(`${colors.blue}ℹ${colors.reset} ${msg}`);
+}
+
+function showHelp() {
+	console.log(`
+${colors.bold}swarm-mail-daemon${colors.reset} - Manage pglite-server daemon for swarm-mail
+
+${colors.bold}USAGE${colors.reset}
+  swarm-mail-daemon <command> [options]
+
+${colors.bold}COMMANDS${colors.reset}
+  start [options]  Start the daemon
+  stop             Stop the daemon
+  status           Show daemon status
+
+${colors.bold}START OPTIONS${colors.reset}
+  --port <number>    TCP port to bind (default: 5433)
+  --host <string>    Host to bind (default: 127.0.0.1)
+  --path <string>    Unix socket path (alternative to port/host)
+  --db <string>      Database path (default: .opencode/streams or ~/.opencode/streams)
+  --project <string> Project path for PID file location
+
+${colors.bold}EXAMPLES${colors.reset}
+  # Start daemon on default port
+  swarm-mail-daemon start
+
+  # Start with custom port
+  swarm-mail-daemon start --port 5555
+
+  # Start with Unix socket
+  swarm-mail-daemon start --path /tmp/swarm-mail.sock
+
+  # Start with custom database path
+  swarm-mail-daemon start --db /custom/db/path
+
+  # Check status
+  swarm-mail-daemon status
+
+  # Stop daemon
+  swarm-mail-daemon stop
+`);
+}
+
+/**
+ * Read PID from PID file
+ */
+async function readPid(projectPath?: string): Promise<number | null> {
+	const pidFilePath = getPidFilePath(projectPath);
+	if (!existsSync(pidFilePath)) {
+		return null;
+	}
+	try {
+		const content = await readFile(pidFilePath, "utf-8");
+		const pid = Number.parseInt(content.trim(), 10);
+		if (Number.isNaN(pid) || pid <= 0) {
+			return null;
+		}
+		return pid;
+	} catch {
+		return null;
+	}
+}
+
+/**
+ * Start command handler
+ */
+async function startCommand(args: string[]): Promise<void> {
+	const { values } = parseArgs({
+		args,
+		options: {
+			port: { type: "string", short: "p" },
+			host: { type: "string", short: "h" },
+			path: { type: "string" },
+			db: { type: "string" },
+			project: { type: "string" },
+			help: { type: "boolean" },
+		},
+	});
+
+	if (values.help) {
+		showHelp();
+		return;
+	}
+
+	const options: DaemonOptions = {
+		port: values.port ? Number.parseInt(values.port, 10) : undefined,
+		host: values.host,
+		path: values.path,
+		dbPath: values.db,
+		projectPath: values.project,
+	};
+
+	try {
+		// Check if already running
+		if (await isDaemonRunning(options.projectPath)) {
+			const pid = await readPid(options.projectPath);
+			const connInfo = options.path
+				? `socket=${options.path}`
+				: `port=${options.port || 5433}`;
+			info(`Daemon already running (PID: ${pid}, ${connInfo})`);
+			return;
+		}
+
+		info("Starting daemon...");
+		const daemonInfo = await startDaemon(options);
+
+		const connInfo = daemonInfo.socketPath
+			? `socket=${daemonInfo.socketPath}`
+			: `port=${daemonInfo.port}`;
+		success(`Daemon started (PID: ${daemonInfo.pid}, ${connInfo})`);
+	} catch (err) {
+		error(
+			`Failed to start daemon: ${err instanceof Error ? err.message : String(err)}`,
+		);
+		process.exit(1);
+	}
+}
+
+/**
+ * Stop command handler
+ */
+async function stopCommand(args: string[]): Promise<void> {
+	const { values } = parseArgs({
+		args,
+		options: {
+			project: { type: "string" },
+			help: { type: "boolean" },
+		},
+	});
+
+	if (values.help) {
+		showHelp();
+		return;
+	}
+
+	try {
+		const pid = await readPid(values.project);
+
+		if (!pid || !(await isDaemonRunning(values.project))) {
+			info("Daemon is not running");
+			return;
+		}
+
+		info(`Stopping daemon (PID: ${pid})...`);
+		await stopDaemon(values.project);
+		success("Daemon stopped");
+	} catch (err) {
+		error(
+			`Failed to stop daemon: ${err instanceof Error ? err.message : String(err)}`,
+		);
+		process.exit(1);
+	}
+}
+
+/**
+ * Status command handler
+ */
+async function statusCommand(args: string[]): Promise<void> {
+	const { values } = parseArgs({
+		args,
+		options: {
+			port: { type: "string", short: "p" },
+			host: { type: "string", short: "h" },
+			path: { type: "string" },
+			project: { type: "string" },
+			help: { type: "boolean" },
+		},
+	});
+
+	if (values.help) {
+		showHelp();
+		return;
+	}
+
+	const projectPath = values.project;
+	const pid = await readPid(projectPath);
+	const running = await isDaemonRunning(projectPath);
+
+	if (!running) {
+		console.log(`${colors.bold}Status:${colors.reset} ${colors.red}Stopped${colors.reset}`);
+		console.log(`${colors.bold}PID File:${colors.reset} ${getPidFilePath(projectPath)}`);
+		return;
+	}
+
+	// Daemon is running - check health
+	const port = values.port ? Number.parseInt(values.port, 10) : 5433;
+	const host = values.host || "127.0.0.1";
+	const path = values.path;
+
+	const healthOptions = path ? { path } : { port, host };
+	const healthy = await healthCheck(healthOptions);
+
+	console.log(
+		`${colors.bold}Status:${colors.reset} ${colors.green}Running${colors.reset}`,
+	);
+	console.log(`${colors.bold}PID:${colors.reset} ${pid}`);
+	console.log(`${colors.bold}PID File:${colors.reset} ${getPidFilePath(projectPath)}`);
+
+	if (path) {
+		console.log(`${colors.bold}Socket:${colors.reset} ${path}`);
+	} else {
+		console.log(`${colors.bold}Host:${colors.reset} ${host}`);
+		console.log(`${colors.bold}Port:${colors.reset} ${port}`);
+	}
+
+	console.log(
+		`${colors.bold}Health:${colors.reset} ${healthy ? `${colors.green}OK${colors.reset}` : `${colors.red}Failed${colors.reset}`}`,
+	);
+}
+
+/**
+ * Main CLI entrypoint
+ */
+async function main() {
+	const [command, ...args] = process.argv.slice(2);
+
+	if (!command || command === "help" || command === "--help" || command === "-h") {
+		showHelp();
+		process.exit(0);
+	}
+
+	switch (command) {
+		case "start":
+			await startCommand(args);
+			break;
+		case "stop":
+			await stopCommand(args);
+			break;
+		case "status":
+			await statusCommand(args);
+			break;
+		default:
+			error(`Unknown command: ${command}`);
+			showHelp();
+			process.exit(1);
+	}
+}
+
+main().catch((err) => {
+	error(`Unexpected error: ${err instanceof Error ? err.message : String(err)}`);
+	process.exit(1);
+});

package/dist/beads/adapter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Beads Adapter - Factory for creating BeadsAdapter instances
+ *
+ * This file implements the adapter pattern for beads event sourcing,
+ * enabling dependency injection of the database.
+ *
+ * ## Design Pattern
+ * - Accept DatabaseAdapter via factory parameter
+ * - Return BeadsAdapter interface
+ * - Delegate to store.ts for event operations
+ * - Delegate to projections.ts for queries
+ * - No direct database access (all via adapter)
+ *
+ * ## Usage
+ * ```typescript
+ * import { wrapPGlite } from '@opencode/swarm-mail/pglite';
+ * import { createBeadsAdapter } from '@opencode/swarm-mail/beads';
+ *
+ * const pglite = new PGlite('./streams.db');
+ * const db = wrapPGlite(pglite);
+ * const beads = createBeadsAdapter(db, '/path/to/project');
+ *
+ * // Use the adapter
+ * await beads.createBead(projectKey, { title: "Task", type: "task", priority: 2 });
+ * const bead = await beads.getBead(projectKey, "bd-123");
+ * ```
+ */
+import type { DatabaseAdapter } from "../types/database.js";
+import type { BeadsAdapter } from "../types/beads-adapter.js";
+/**
+ * Create a BeadsAdapter instance
+ *
+ * @param db - DatabaseAdapter instance (PGLite, SQLite, PostgreSQL, etc.)
+ * @param projectKey - Project identifier (typically the project path)
+ * @returns BeadsAdapter interface
+ */
+export declare function createBeadsAdapter(db: DatabaseAdapter, projectKey: string): BeadsAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/beads/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/beads/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AA6B9D;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,eAAe,EACnB,UAAU,EAAE,MAAM,GACjB,YAAY,CAkiBd"}

package/dist/beads/blocked-cache.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Blocked Beads Cache Management
+ *
+ * Convenience re-exports for blocked cache operations.
+ * The actual implementation is in dependencies.ts to avoid circular dependencies.
+ *
+ * ## Cache Strategy
+ * - blocked_beads_cache table stores bead_id → blocker_ids[]
+ * - Rebuilt when dependencies change or bead status changes
+ * - Enables fast "ready work" queries without recursive CTEs
+ *
+ * ## Performance
+ * - Cache rebuild: <50ms for typical projects
+ * - Ready work query: 25x faster with cache (752ms → 29ms on 10K beads)
+ *
+ * Reference: steveyegge/beads/internal/storage/sqlite/blocked_cache.go
+ *
+ * @module beads/blocked-cache
+ */
+export { rebuildBeadBlockedCache, rebuildAllBlockedCaches, invalidateBlockedCache, } from "./dependencies.js";
+//# sourceMappingURL=blocked-cache.d.ts.map

package/dist/beads/blocked-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocked-cache.d.ts","sourceRoot":"","sources":["../../src/beads/blocked-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC"}

package/dist/beads/comments.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Comment Operations
+ *
+ * Comment management with threading support.
+ * Comments can have parent_id for nested discussions.
+ *
+ * Reference: steveyegge/beads/internal/storage/sqlite/comments.go
+ *
+ * @module beads/comments
+ */
+import type { DatabaseAdapter } from "../types/database.js";
+import type { BeadComment } from "../types/beads-adapter.js";
+/**
+ * Get a specific comment by ID
+ */
+export declare function getCommentById(db: DatabaseAdapter, commentId: number): Promise<BeadComment | null>;
+/**
+ * Get comment thread (comment + all replies)
+ */
+export declare function getCommentThread(db: DatabaseAdapter, rootCommentId: number): Promise<BeadComment[]>;
+//# sourceMappingURL=comments.d.ts.map

package/dist/beads/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/beads/comments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;GAEG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,eAAe,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAM7B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,eAAe,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC,CAgBxB"}

package/dist/beads/dependencies.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Dependency Graph Operations
+ *
+ * Provides dependency management with cycle detection and blocked bead tracking.
+ *
+ * ## Dependency Types
+ * - **blocks**: Hard dependency - target must be closed before source can start
+ * - **blocked-by**: Inverse of blocks (computed, not stored)
+ * - **related**: Soft relationship - doesn't affect ready state
+ * - **discovered-from**: Tracking relationship - found while working on another bead
+ *
+ * ## Cycle Prevention
+ * All dependency types are checked for cycles to maintain a DAG (Directed Acyclic Graph).
+ * This ensures:
+ * - Ready work calculation works correctly
+ * - Dependency traversal doesn't loop
+ * - Semantic clarity (no circular dependencies)
+ *
+ * Reference: steveyegge/beads/internal/storage/sqlite/dependencies.go
+ *
+ * @module beads/dependencies
+ */
+import type { DatabaseAdapter } from "../types/database.js";
+/**
+ * Check if adding a dependency would create a cycle
+ *
+ * Uses recursive CTE to traverse from dependsOnId to see if we can reach beadId.
+ * If yes, adding "beadId depends on dependsOnId" would complete a cycle.
+ */
+export declare function wouldCreateCycle(db: DatabaseAdapter, beadId: string, dependsOnId: string): Promise<boolean>;
+/**
+ * Get all open blockers for a bead (including transitive)
+ *
+ * Returns bead IDs of all beads blocking this one that aren't closed.
+ * Only considers "blocks" relationship type.
+ */
+export declare function getOpenBlockers(db: DatabaseAdapter, projectKey: string, beadId: string): Promise<string[]>;
+/**
+ * Rebuild blocked cache for a specific bead
+ *
+ * Finds all open blockers and updates the cache.
+ * If no open blockers, removes from cache (bead is unblocked).
+ */
+export declare function rebuildBeadBlockedCache(db: DatabaseAdapter, projectKey: string, beadId: string): Promise<void>;
+/**
+ * Rebuild blocked cache for all beads in a project
+ *
+ * Used after bulk operations or status changes that affect blocking.
+ */
+export declare function rebuildAllBlockedCaches(db: DatabaseAdapter, projectKey: string): Promise<void>;
+/**
+ * Invalidate blocked cache when dependencies change
+ *
+ * Marks beads as needing cache rebuild.
+ * In this simple implementation, we just rebuild immediately.
+ */
+export declare function invalidateBlockedCache(db: DatabaseAdapter, projectKey: string, beadId: string): Promise<void>;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/beads/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/beads/dependencies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5D;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,eAAe,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAwBnB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,eAAe,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,eAAe,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,eAAe,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/beads/events.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Bead Event Types - Minimal type definitions for swarm-mail
+ *
+ * These are simplified type definitions that match the bead-events from
+ * opencode-swarm-plugin but avoid cross-package TypeScript imports.
+ *
+ * The actual event schemas with Zod validation live in:
+ * packages/opencode-swarm-plugin/src/schemas/bead-events.ts
+ *
+ * This file provides just enough type information for the store to work.
+ */
+/**
+ * Base bead event (all events extend this)
+ */
+export interface BaseBeadEvent {
+    id?: number;
+    type: string;
+    project_key: string;
+    bead_id: string;
+    timestamp: number;
+    sequence?: number;
+}
+/**
+ * Union of all bead event types
+ *
+ * This matches the discriminated union in bead-events.ts but as pure TypeScript
+ */
+export type BeadEvent = BeadCreatedEvent | BeadUpdatedEvent | BeadStatusChangedEvent | BeadClosedEvent | BeadReopenedEvent | BeadDeletedEvent | BeadDependencyAddedEvent | BeadDependencyRemovedEvent | BeadLabelAddedEvent | BeadLabelRemovedEvent | BeadCommentAddedEvent | BeadCommentUpdatedEvent | BeadCommentDeletedEvent | BeadEpicChildAddedEvent | BeadEpicChildRemovedEvent | BeadEpicClosureEligibleEvent | BeadAssignedEvent | BeadWorkStartedEvent | BeadCompactedEvent;
+export interface BeadCreatedEvent extends BaseBeadEvent {
+    type: "bead_created";
+    title: string;
+    description?: string;
+    issue_type: "bug" | "feature" | "task" | "epic" | "chore";
+    priority: number;
+    parent_id?: string;
+    created_by?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface BeadUpdatedEvent extends BaseBeadEvent {
+    type: "bead_updated";
+    updated_by?: string;
+    changes: {
+        title?: {
+            old: string;
+            new: string;
+        };
+        description?: {
+            old: string;
+            new: string;
+        };
+        priority?: {
+            old: number;
+            new: number;
+        };
+    };
+}
+export interface BeadStatusChangedEvent extends BaseBeadEvent {
+    type: "bead_status_changed";
+    from_status: "open" | "in_progress" | "blocked" | "closed" | "tombstone";
+    to_status: "open" | "in_progress" | "blocked" | "closed" | "tombstone";
+    changed_by?: string;
+    reason?: string;
+}
+export interface BeadClosedEvent extends BaseBeadEvent {
+    type: "bead_closed";
+    reason: string;
+    closed_by?: string;
+    files_touched?: string[];
+    duration_ms?: number;
+}
+export interface BeadReopenedEvent extends BaseBeadEvent {
+    type: "bead_reopened";
+    reason?: string;
+    reopened_by?: string;
+}
+export interface BeadDeletedEvent extends BaseBeadEvent {
+    type: "bead_deleted";
+    reason?: string;
+    deleted_by?: string;
+}
+export interface BeadDependencyAddedEvent extends BaseBeadEvent {
+    type: "bead_dependency_added";
+    dependency: {
+        target: string;
+        type: "blocks" | "blocked-by" | "related" | "discovered-from";
+    };
+    added_by?: string;
+    reason?: string;
+}
+export interface BeadDependencyRemovedEvent extends BaseBeadEvent {
+    type: "bead_dependency_removed";
+    dependency: {
+        target: string;
+        type: "blocks" | "blocked-by" | "related" | "discovered-from";
+    };
+    removed_by?: string;
+    reason?: string;
+}
+export interface BeadLabelAddedEvent extends BaseBeadEvent {
+    type: "bead_label_added";
+    label: string;
+    added_by?: string;
+}
+export interface BeadLabelRemovedEvent extends BaseBeadEvent {
+    type: "bead_label_removed";
+    label: string;
+    removed_by?: string;
+}
+export interface BeadCommentAddedEvent extends BaseBeadEvent {
+    type: "bead_comment_added";
+    comment_id?: number;
+    author: string;
+    body: string;
+    parent_comment_id?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface BeadCommentUpdatedEvent extends BaseBeadEvent {
+    type: "bead_comment_updated";
+    comment_id: number;
+    old_body: string;
+    new_body: string;
+    updated_by: string;
+}
+export interface BeadCommentDeletedEvent extends BaseBeadEvent {
+    type: "bead_comment_deleted";
+    comment_id: number;
+    deleted_by: string;
+    reason?: string;
+}
+export interface BeadEpicChildAddedEvent extends BaseBeadEvent {
+    type: "bead_epic_child_added";
+    child_id: string;
+    child_index?: number;
+    added_by?: string;
+}
+export interface BeadEpicChildRemovedEvent extends BaseBeadEvent {
+    type: "bead_epic_child_removed";
+    child_id: string;
+    removed_by?: string;
+    reason?: string;
+}
+export interface BeadEpicClosureEligibleEvent extends BaseBeadEvent {
+    type: "bead_epic_closure_eligible";
+    child_ids: string[];
+    total_duration_ms?: number;
+    all_files_touched?: string[];
+}
+export interface BeadAssignedEvent extends BaseBeadEvent {
+    type: "bead_assigned";
+    agent_name: string;
+    task_description?: string;
+}
+export interface BeadWorkStartedEvent extends BaseBeadEvent {
+    type: "bead_work_started";
+    agent_name: string;
+    reserved_files?: string[];
+}
+export interface BeadCompactedEvent extends BaseBeadEvent {
+    type: "bead_compacted";
+    events_archived: number;
+    new_start_sequence: number;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/beads/events.d.ts.map

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