swarm-mail 0.1.0 → 0.1.3

package/README.md

@@ -1,5 +1,33 @@
 # swarm-mail
 
+```
+                                _.------._
+                               .'   .--.   '.        🐝
+                              /   .'    '.   \    🐝
+                             |   /   __   \   |      🐝
+       🐝                    |  |   (  )   |  |  🐝
+            🐝    _  _       |  |   |__|   |  |
+                 ( \/ )       \  '.      .'  /    🐝
+       🐝    ____/    \____    '.  '----'  .'
+           /    \    /    \     '-._____.-'           🐝
+          /  ()  \  /  ()  \
+         |   /\   ||   /\   |     ███████╗██╗    ██╗ █████╗ ██████╗ ███╗   ███╗
+         |  /__\  ||  /__\  |     ██╔════╝██║    ██║██╔══██╗██╔══██╗████╗ ████║
+          \      /  \      /      ███████╗██║ █╗ ██║███████║██████╔╝██╔████╔██║
+       🐝  '----'    '----'       ╚════██║██║███╗██║██╔══██║██╔══██╗██║╚██╔╝██║
+                                  ███████║╚███╔███╔╝██║  ██║██║  ██║██║ ╚═╝ ██║
+             🐝                   ╚══════╝ ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝
+                    🐝
+       🐝                         ███╗   ███╗ █████╗ ██╗██╗
+                                  ████╗ ████║██╔══██╗██║██║         🐝
+            🐝                    ██╔████╔██║███████║██║██║
+                                  ██║╚██╔╝██║██╔══██║██║██║    🐝
+       🐝        🐝               ██║ ╚═╝ ██║██║  ██║██║███████╗
+                                  ╚═╝     ╚═╝╚═╝  ╚═╝╚═╝╚══════╝       🐝
+                 🐝
+                             ⚡ Actor-Model Primitives for Agent Coordination ⚡
+```
+
 Event sourcing primitives for multi-agent coordination. Local-first, no external servers.
 
 ```

package/dist/adapter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SwarmMail Adapter - Factory for creating SwarmMailAdapter instances
+ *
+ * This file implements the adapter pattern for swarm-mail, enabling
+ * dependency injection of the database instead of singleton access.
+ *
+ * ## Design Pattern
+ * - Accept DatabaseAdapter via factory parameter
+ * - Return SwarmMailAdapter interface
+ * - Delegate to internal implementation functions
+ * - No direct database access (all via adapter)
+ *
+ * ## Usage
+ * ```typescript
+ * import { createPGLiteAdapter } from '@opencode/swarm-mail/adapters/pglite';
+ * import { createSwarmMailAdapter } from '@opencode/swarm-mail';
+ *
+ * const dbAdapter = createPGLiteAdapter({ path: './streams.db' });
+ * const swarmMail = createSwarmMailAdapter(dbAdapter, '/path/to/project');
+ *
+ * // Use the adapter
+ * await swarmMail.appendEvent(event);
+ * const messages = await swarmMail.getInbox('agent-name', { limit: 5 });
+ * ```
+ */
+import type { DatabaseAdapter } from "./types/database";
+import type { SwarmMailAdapter } from "./types/adapter";
+/**
+ * Create a SwarmMailAdapter instance
+ *
+ * @param db - DatabaseAdapter instance (PGLite, SQLite, PostgreSQL, etc.)
+ * @param projectKey - Project identifier (typically the project path)
+ * @returns SwarmMailAdapter interface
+ */
+export declare function createSwarmMailAdapter(db: DatabaseAdapter, projectKey: string): SwarmMailAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAgCxD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,eAAe,EACnB,UAAU,EAAE,MAAM,GACjB,gBAAgB,CA4OlB"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Swarm Mail - Actor-model primitives for multi-agent coordination
+ *
+ * ## Simple API (PGLite convenience layer)
+ * ```typescript
+ * import { getSwarmMail } from '@opencode/swarm-mail';
+ * const swarmMail = await getSwarmMail('/path/to/project');
+ * ```
+ *
+ * ## Advanced API (database-agnostic adapter)
+ * ```typescript
+ * import { createSwarmMailAdapter } from '@opencode/swarm-mail';
+ * const db = createCustomDbAdapter({ path: './custom.db' });
+ * const swarmMail = createSwarmMailAdapter(db, '/path/to/project');
+ * ```
+ */
+export declare const SWARM_MAIL_VERSION = "0.1.0";
+export { createSwarmMailAdapter } from "./adapter";
+export type { DatabaseAdapter, SwarmMailAdapter, EventStoreAdapter, AgentAdapter, MessagingAdapter, ReservationAdapter, SchemaAdapter, ReadEventsOptions, InboxOptions, Message, Reservation, Conflict, } from "./types";
+export { getSwarmMail, createInMemorySwarmMail, closeSwarmMail, closeAllSwarmMail, getDatabasePath, PGlite, } from "./pglite";
+export * from "./streams";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAM1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,WAAW,EACX,QAAQ,GACT,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,MAAM,GACP,MAAM,UAAU,CAAC;AAMlB,cAAc,WAAW,CAAC"}