swarm-mail 1.4.0 → 1.5.0

package/dist/libsql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"libsql.d.ts","sourceRoot":"","sources":["../src/libsql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,qBAAqB,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GAChB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAA;CAAE,CAuFhD;AAmGD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,eAAe,CAAC,CA0B1B"}
+{"version":3,"file":"libsql.d.ts","sourceRoot":"","sources":["../src/libsql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,qBAAqB,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GAChB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAA;CAAE,CAuFhD;AAmGD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,eAAe,CAAC,CA8B1B"}

package/dist/streams/durable-adapter.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Durable Streams Adapter
+ *
+ * Adapts swarm-mail event store to the Durable Streams protocol.
+ *
+ * Protocol: https://github.com/durable-streams/durable-streams
+ *
+ * Key features:
+ * - Offset-based resumability (refresh-safe, multi-device, multi-tab)
+ * - Long-poll and SSE modes for live tailing
+ * - Catch-up reads from any offset
+ * - CDN-friendly design for massive fan-out
+ *
+ * @see .hive/analysis/hive-cell-visualizer.md for full architecture
+ */
+import type { SwarmMailAdapter } from "../types/adapter.js";
+/**
+ * StreamEvent format for Durable Streams protocol
+ */
+export interface StreamEvent {
+    /** Event sequence number (serves as offset for resumability) */
+    offset: number;
+    /** JSON-encoded AgentEvent */
+    data: string;
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+}
+/**
+ * DurableStreamAdapter interface
+ *
+ * Provides offset-based access to the swarm-mail event store.
+ * Compatible with Durable Streams protocol.
+ */
+export interface DurableStreamAdapter {
+    /**
+     * Read events starting from offset
+     *
+     * @param offset - Start reading AFTER this sequence number (0 = from beginning)
+     * @param limit - Maximum number of events to return
+     * @returns Array of StreamEvents
+     */
+    read(offset: number, limit: number): Promise<StreamEvent[]>;
+    /**
+     * Get the latest sequence number
+     *
+     * @returns Latest sequence number (0 if no events)
+     */
+    head(): Promise<number>;
+    /**
+     * Subscribe to new events (polling-based)
+     *
+     * Polls every 100ms for new events and calls callback.
+     * Only delivers events that arrive AFTER subscription starts.
+     *
+     * @param callback - Called with each new event
+     * @returns Unsubscribe function
+     */
+    subscribe(callback: (event: StreamEvent) => void): () => void;
+}
+/**
+ * Create a DurableStreamAdapter for a specific project
+ *
+ * @param swarmMail - SwarmMailAdapter instance
+ * @param projectKey - Project key to filter events by
+ * @returns DurableStreamAdapter instance
+ *
+ * @example
+ * ```typescript
+ * const swarmMail = await createInMemorySwarmMailLibSQL("test");
+ * const adapter = createDurableStreamAdapter(swarmMail, "/path/to/project");
+ *
+ * // Read events from beginning
+ * const events = await adapter.read(0, 100);
+ *
+ * // Get latest sequence
+ * const head = await adapter.head();
+ *
+ * // Subscribe to new events
+ * const unsubscribe = adapter.subscribe((event) => {
+ *   console.log("New event:", event);
+ * });
+ * ```
+ */
+export declare function createDurableStreamAdapter(swarmMail: SwarmMailAdapter, projectKey: string): DurableStreamAdapter;
+//# sourceMappingURL=durable-adapter.d.ts.map

package/dist/streams/durable-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-adapter.d.ts","sourceRoot":"","sources":["../../src/streams/durable-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE5D;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAExB;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,gBAAgB,EAC3B,UAAU,EAAE,MAAM,GACjB,oBAAoB,CAqEtB"}

package/dist/streams/durable-server.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Durable Streams HTTP Server
+ *
+ * Exposes the Durable Streams protocol via Server-Sent Events (SSE).
+ * Built with Bun.serve() for HTTP server.
+ *
+ * Port 4483 = HIVE on phone keypad
+ *
+ * ## Endpoints
+ *
+ * GET /streams/:projectKey?offset=N&live=true
+ * - offset: Start reading from this sequence (default 0)
+ * - live: If true, keep connection open and stream new events via SSE
+ *
+ * ## SSE Format
+ *
+ * data: {json}\n\n
+ *
+ * Each event is sent as a JSON-encoded StreamEvent:
+ * { offset: number, data: string, timestamp: number }
+ */
+import type { DurableStreamAdapter } from "./durable-adapter.js";
+/**
+ * Configuration for the Durable Stream HTTP server
+ */
+export interface DurableStreamServerConfig {
+    /** Adapter for reading events */
+    adapter: DurableStreamAdapter;
+    /** Port to listen on (default 4483 - HIVE on phone keypad) */
+    port?: number;
+}
+/**
+ * Durable Stream HTTP server interface
+ */
+export interface DurableStreamServer {
+    /** Start the HTTP server */
+    start(): Promise<void>;
+    /** Stop the HTTP server and clean up subscriptions */
+    stop(): Promise<void>;
+    /** Base URL of the server */
+    url: string;
+}
+/**
+ * Creates a Durable Streams HTTP server exposing events via SSE
+ *
+ * @example
+ * ```typescript
+ * const adapter = createDurableStreamAdapter(swarmMail, "/my/project");
+ * const server = createDurableStreamServer({ adapter });
+ * await server.start();
+ * console.log(`Streaming at ${server.url}/streams/my-project`);
+ * ```
+ */
+export declare function createDurableStreamServer(config: DurableStreamServerConfig): DurableStreamServer;
+//# sourceMappingURL=durable-server.d.ts.map

package/dist/streams/durable-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-server.d.ts","sourceRoot":"","sources":["../../src/streams/durable-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAe,MAAM,sBAAsB,CAAC;AAK9E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,iCAAiC;IACjC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,sDAAsD;IACtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,mBAAmB,CAmJrB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swarm-mail",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Event sourcing primitives for multi-agent coordination. Local-first, no external servers.",
   "type": "module",
   "main": "./dist/index.js",