swarm-mail 0.1.4 → 0.2.0

package/dist/pglite.d.ts

@@ -33,10 +33,35 @@ import type { DatabaseAdapter, SwarmMailAdapter } from "./types";
  */
 export declare function wrapPGlite(pglite: PGlite): DatabaseAdapter;
 /**
- * Get database path (project-local or global fallback)
+ * Generate a short hash for a project path
  *
- * Prefers project-local .opencode/streams
- * Falls back to global ~/.opencode/streams
+ * Uses SHA256 and takes first 8 characters for uniqueness.
+ *
+ * @param projectPath - Project root path
+ * @returns 8-character hash string
+ */
+export declare function hashProjectPath(projectPath: string): string;
+/**
+ * Get a human-readable project identifier with hash suffix
+ *
+ * Format: `opencode-<project-name>-<hash>`
+ * Example: `opencode-my-project-a1b2c3d4`
+ *
+ * @param projectPath - Project root path
+ * @returns Directory name for the project's temp storage
+ */
+export declare function getProjectTempDirName(projectPath: string): string;
+/**
+ * Get database path in $TMPDIR (ephemeral storage)
+ *
+ * Streams data is ephemeral coordination state - messages, reservations,
+ * agent registrations. It's safe to lose on reboot since:
+ * - Beads are git-synced separately in .beads/
+ * - Semantic memory is in ~/.opencode/memory/
+ * - Agents re-register on session start
+ *
+ * Path format: `$TMPDIR/opencode-<project-name>-<hash>/streams`
+ * Falls back to global `$TMPDIR/opencode-global/streams` if no project path.
  *
  * @param projectPath - Optional project root path
  * @returns Absolute path to database directory
@@ -48,19 +73,59 @@ export declare function getDatabasePath(projectPath?: string): string;
  * Uses singleton pattern - one instance per database path.
  * Safe to call multiple times for the same project.
  *
+ * **Socket Mode (SWARM_MAIL_SOCKET=true):**
+ * - Checks if daemon is running, starts if needed
+ * - Validates health before connecting
+ * - Falls back to embedded PGLite on any failure
+ *
+ * **Embedded Mode (default):**
+ * - Uses embedded PGLite database
+ * - No daemon required
+ *
  * @param projectPath - Optional project root path (defaults to global)
  * @returns SwarmMailAdapter instance
  *
  * @example
  * ```typescript
- * // Project-local database
+ * // Project-local database (embedded or socket based on env)
  * const swarmMail = await getSwarmMail('/path/to/project');
  *
  * // Global database (shared across all projects)
  * const swarmMail = await getSwarmMail();
+ *
+ * // Explicit socket mode
+ * process.env.SWARM_MAIL_SOCKET = 'true';
+ * const swarmMail = await getSwarmMail('/path/to/project');
  * ```
  */
 export declare function getSwarmMail(projectPath?: string): Promise<SwarmMailAdapter>;
+/**
+ * Get SwarmMail instance using socket adapter (explicit socket mode)
+ *
+ * Always uses socket connection to pglite-server daemon.
+ * Auto-starts daemon if not running, validates health before connecting.
+ *
+ * **Port/Path Resolution:**
+ * - Checks SWARM_MAIL_SOCKET_PATH env var for Unix socket
+ * - Falls back to TCP on SWARM_MAIL_SOCKET_PORT (default: 5433)
+ * - Host defaults to 127.0.0.1
+ *
+ * @param projectPath - Optional project root path
+ * @returns SwarmMailAdapter instance using socket connection
+ * @throws Error if daemon fails to start or health check fails
+ *
+ * @example
+ * ```typescript
+ * // Unix socket (preferred)
+ * process.env.SWARM_MAIL_SOCKET_PATH = '/tmp/swarm-mail.sock';
+ * const swarmMail = await getSwarmMailSocket('/path/to/project');
+ *
+ * // TCP socket
+ * process.env.SWARM_MAIL_SOCKET_PORT = '5433';
+ * const swarmMail = await getSwarmMailSocket('/path/to/project');
+ * ```
+ */
+export declare function getSwarmMailSocket(projectPath?: string): Promise<SwarmMailAdapter>;
 /**
  * Create in-memory SwarmMail instance (for testing)
  *

package/dist/pglite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pglite.d.ts","sourceRoot":"","sources":["../src/pglite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAKjE;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAQ1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAa5D;AAYD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAa3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,SAAS,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAM3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKvD;AAGD,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"pglite.d.ts","sourceRoot":"","sources":["../src/pglite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAQjE;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAQ1D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQjE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB5D;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,YAAY,CAChC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CA+B3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAS3B;AA0DD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,SAAS,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAM3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAUvD;AAGD,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/socket-adapter.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Socket Adapter - postgres.js wrapper for DatabaseAdapter interface
+ *
+ * Wraps postgres.js client to match DatabaseAdapter interface, supporting both
+ * TCP (host/port) and Unix socket (path) connections.
+ *
+ * ## Usage
+ * ```typescript
+ * // TCP connection
+ * const sql = postgres({ host: '127.0.0.1', port: 5432 });
+ * const db = wrapPostgres(sql);
+ *
+ * // Unix socket connection
+ * const sql = postgres({ path: '/tmp/pglite.sock' });
+ * const db = wrapPostgres(sql);
+ *
+ * // Factory function
+ * const db = await createSocketAdapter({ path: '/tmp/pglite.sock' });
+ * ```
+ */
+import postgres from "postgres";
+import type { DatabaseAdapter } from "./types";
+/**
+ * Options for socket adapter creation
+ */
+export interface SocketAdapterOptions {
+    /** Unix socket path */
+    path?: string;
+    /** TCP host */
+    host?: string;
+    /** TCP port */
+    port?: number;
+    /** Connection timeout in seconds */
+    timeout?: number;
+    /** Maximum number of connections */
+    max?: number;
+}
+/**
+ * Wrap postgres.js client to match DatabaseAdapter interface
+ *
+ * postgres.js uses tagged template literals for queries, but DatabaseAdapter
+ * uses (sql, params) signature. This adapter bridges the difference.
+ *
+ * @param sql - postgres.js client instance
+ * @returns DatabaseAdapter compatible wrapper
+ *
+ * @example
+ * ```typescript
+ * const sql = postgres({ path: '/tmp/pglite.sock' });
+ * const db = wrapPostgres(sql);
+ * const result = await db.query<{ id: number }>(
+ *   "SELECT id FROM agents WHERE name = $1",
+ *   ["BlueLake"]
+ * );
+ * ```
+ */
+export declare function wrapPostgres(sql: postgres.Sql<Record<string, unknown>>): DatabaseAdapter;
+/**
+ * Create socket adapter with connection validation
+ *
+ * Factory function that creates postgres.js client and wraps it.
+ * Validates connection before returning adapter.
+ *
+ * @param options - Socket connection options (path OR host/port)
+ * @returns DatabaseAdapter instance
+ * @throws Error if connection fails or invalid options
+ *
+ * @example
+ * ```typescript
+ * // Unix socket
+ * const db = await createSocketAdapter({ path: '/tmp/pglite.sock' });
+ *
+ * // TCP connection
+ * const db = await createSocketAdapter({ host: '127.0.0.1', port: 5432 });
+ * ```
+ */
+export declare function createSocketAdapter(options: SocketAdapterOptions): Promise<DatabaseAdapter>;
+//# sourceMappingURL=socket-adapter.d.ts.map

package/dist/socket-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-adapter.d.ts","sourceRoot":"","sources":["../src/socket-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAC3B,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACxC,eAAe,CA8BjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAuC1B"}

package/dist/streams/effect/ask.integration-test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Ask Pattern Integration Tests
+ *
+ * Tests request/response communication between agents using
+ * DurableMailbox + DurableDeferred pattern.
+ */
+export {};
+//# sourceMappingURL=ask.integration-test.d.ts.map

package/dist/streams/effect/ask.integration-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.integration-test.d.ts","sourceRoot":"","sources":["../../../src/streams/effect/ask.integration-test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/streams/effect/cursor.integration-test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cursor.integration-test.d.ts.map

package/dist/streams/effect/cursor.integration-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.integration-test.d.ts","sourceRoot":"","sources":["../../../src/streams/effect/cursor.integration-test.ts"],"names":[],"mappings":""}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streams/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAW9C;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAQZ;AASD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAYZ;AAwBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB5D;AA2DD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BvE;AAqED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CASvD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvE;AAwHD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAkBD;AAuCD,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streams/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAY9C;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAQZ;AASD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAYZ;AAwBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB5D;AA2DD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BvE;AAuFD;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CASvD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvE;AAwHD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAkBD;AAuCD,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/dist/streams/leader-election.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Leader Election for PGLite Multi-Process Access
+ *
+ * PGLite is single-connection only. When multiple processes (e.g., swarm workers)
+ * try to initialize PGLite at the same database path, they corrupt each other.
+ *
+ * This module implements file-based leader election:
+ * 1. Acquire exclusive lock on .opencode/streams.lock before PGLite init
+ * 2. If lock acquired → proceed with initialization
+ * 3. If lock fails → wait and retry (another process is initializing)
+ * 4. Release lock after initialization (PGLite handles its own internal locking)
+ *
+ * The lock is only held during initialization, not during normal operation.
+ * This prevents the WASM corruption that occurs when multiple instances
+ * try to create/open the same database files simultaneously.
+ *
+ * @see https://pglite.dev/docs/multi-tab-worker for browser equivalent
+ */
+/**
+ * Get the lock file path for a database path
+ */
+export declare function getLockFilePath(dbPath: string): string;
+/**
+ * Acquire exclusive lock for database initialization
+ *
+ * @param dbPath - Path to the database directory
+ * @returns Release function to call when done
+ * @throws Error if lock cannot be acquired within timeout
+ */
+export declare function acquireInitLock(dbPath: string): Promise<() => Promise<void>>;
+/**
+ * Check if the database is currently being initialized by another process
+ *
+ * @param dbPath - Path to the database directory
+ * @returns true if lock is held (initialization in progress)
+ */
+export declare function isInitializationInProgress(dbPath: string): Promise<boolean>;
+/**
+ * Force release a stale lock (use with caution)
+ *
+ * @param dbPath - Path to the database directory
+ */
+export declare function forceReleaseLock(dbPath: string): Promise<void>;
+//# sourceMappingURL=leader-election.d.ts.map

package/dist/streams/leader-election.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leader-election.d.ts","sourceRoot":"","sources":["../../src/streams/leader-election.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAkBH;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAeD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA2C9B;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYpE"}

package/dist/streams/store.integration-test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.integration-test.d.ts.map

package/dist/streams/store.integration-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.integration-test.d.ts","sourceRoot":"","sources":["../../src/streams/store.integration-test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "swarm-mail",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "Event sourcing primitives for multi-agent coordination. Local-first, no external servers.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "swarm-mail-daemon": "./bin/daemon-cli.ts"
+  },
   "files": [
     "dist",
+    "bin",
     "README.md"
   ],
   "exports": {
@@ -22,21 +26,27 @@
   "author": "Joel Hooks",
   "license": "MIT",
   "scripts": {
-    "build": "bun build ./src/index.ts --outdir ./dist --target node --external @electric-sql/pglite && tsc",
-    "test": "vitest run --exclude '**/*.integration.test.ts'",
-    "test:integration": "vitest run --include '**/*.integration.test.ts' --testTimeout 60000",
-    "test:all": "vitest run --testTimeout 60000",
+    "build": "bun build ./src/index.ts --outdir ./dist --target node --external @electric-sql/pglite --external postgres && tsc",
+    "test": "bun test src/streams/ --timeout 60000",
+    "test:beads": "bun test src/beads/ --timeout 60000",
+    "test:integration": "vitest run src/streams/**/*.integration-test.ts --testTimeout 60000",
+    "test:all": "bun test src/ --timeout 60000",
     "typecheck": "tsc --noEmit",
     "publish:pkg": "npm publish --access public --provenance"
   },
   "dependencies": {
     "@electric-sql/pglite": "0.3.14",
+    "@electric-sql/pglite-socket": "^0.0.19",
     "effect": "^3.19.12",
     "minimatch": "^10.1.1",
     "nanoid": "^5.1.6",
+    "postgres": "^3.4.7",
+    "proper-lockfile": "^4.1.2",
     "zod": "4.1.8"
   },
   "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@types/proper-lockfile": "^4.1.4",
     "bun-types": "^1.3.4",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"