@poolzin/pool-bot 2026.3.21 → 2026.3.23

package/extensions/memory-core/node_modules/.bin/vitest

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/vitest@1.6.1_@types+node@20.19.30_@vitest+browser@4.0.18_vite@7.3.1_@types+node@25.2.3__a102e25684722dd7e16c8e55a5848dc8/node_modules/vitest/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/vitest@1.6.1_@types+node@20.19.30_@vitest+browser@4.0.18_vite@7.3.1_@types+node@25.2.3__a102e25684722dd7e16c8e55a5848dc8/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/vitest@1.6.1_@types+node@20.19.30_@vitest+browser@4.0.18_vite@7.3.1_@types+node@25.2.3__a102e25684722dd7e16c8e55a5848dc8/node_modules/vitest/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/vitest@1.6.1_@types+node@20.19.30_@vitest+browser@4.0.18_vite@7.3.1_@types+node@25.2.3__a102e25684722dd7e16c8e55a5848dc8/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../vitest/vitest.mjs" "$@"
+else
+  exec node  "$basedir/../vitest/vitest.mjs" "$@"
+fi

package/extensions/memory-core/package.json

@@ -1,17 +1,20 @@
 {
   "name": "@poolbot/memory-core",
-  "version": "2026.3.11",
+  "version": "1.0.0",
+  "description": "Core memory management for Pool Bot agents",
   "type": "module",
-  "description": "Poolbot core memory search plugin",
-  "poolbot": {
-    "extensions": [
-      "./index.ts"
-    ]
+  "main": "src/index.js",
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsc"
   },
+  "dependencies": {},
   "devDependencies": {
-    "@poolzin/pool-bot": "workspace:*"
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
   },
   "peerDependencies": {
-    "@poolzin/pool-bot": ">=2026.1.26"
+    "poolbot": "workspace:*"
   }
 }

package/extensions/memory-core/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * Memory Core Plugin Entry Point
+ */
+
+export { MemoryManager, createMemoryManager, type MemoryEntry, type MemoryQuery } from "./memory-manager.js";
+
+// Export plugin metadata
+export const pluginInfo = {
+  id: "memory-core",
+  name: "Memory Core",
+  version: "1.0.0",
+  description: "Core memory management for Pool Bot agents",
+  author: "Pool Bot Team",
+};

package/extensions/memory-core/src/memory-manager.test.ts

@@ -0,0 +1,124 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { MemoryManager, createMemoryManager } from "./memory-manager";
+
+describe("MemoryManager", () => {
+  let manager: MemoryManager;
+
+  beforeEach(() => {
+    manager = createMemoryManager();
+  });
+
+  afterEach(() => {
+    manager.destroy();
+  });
+
+  it("sets and gets memory", () => {
+    manager.set("test-key", "test-value");
+    const value = manager.get("test-key");
+    expect(value).toBe("test-value");
+  });
+
+  it("returns undefined for non-existent key", () => {
+    const value = manager.get("non-existent");
+    expect(value).toBeUndefined();
+  });
+
+  it("respects TTL", async () => {
+    manager.set("expiring-key", "value", { ttl: 100 });
+    expect(manager.get("expiring-key")).toBe("value");
+
+    await new Promise((resolve) => setTimeout(resolve, 150));
+    expect(manager.get("expiring-key")).toBeUndefined();
+  });
+
+  it("deletes by ID", () => {
+    const entry = manager.set("test-key", "value");
+    const deleted = manager.delete(entry.id);
+    expect(deleted).toBe(true);
+    expect(manager.get("test-key")).toBeUndefined();
+  });
+
+  it("deletes by key", () => {
+    manager.set("test-key", "value1");
+    manager.set("test-key", "value2");
+    const deleted = manager.delete("test-key");
+    expect(deleted).toBe(true);
+    expect(manager.get("test-key")).toBeUndefined();
+  });
+
+  it("queries by key", () => {
+    manager.set("key1", "value1");
+    manager.set("key2", "value2");
+    manager.set("key1", "value3");
+
+    const results = manager.query({ key: "key1" });
+    expect(results).toHaveLength(2);
+  });
+
+  it("queries by key prefix", () => {
+    manager.set("user:1:name", "Alice");
+    manager.set("user:1:age", "30");
+    manager.set("user:2:name", "Bob");
+
+    const results = manager.query({ keyPrefix: "user:1:" });
+    expect(results).toHaveLength(2);
+  });
+
+  it("queries by tags", () => {
+    manager.set("key1", "value1", { tags: ["important"] });
+    manager.set("key2", "value2", { tags: ["temporary"] });
+    manager.set("key3", "value3", { tags: ["important", "temporary"] });
+
+    const results = manager.query({ tags: ["important"] });
+    expect(results).toHaveLength(2);
+  });
+
+  it("excludes expired by default", async () => {
+    manager.set("expiring", "value", { ttl: 50 });
+    await new Promise((resolve) => setTimeout(resolve, 100));
+
+    const results = manager.query({ excludeExpired: true });
+    expect(results).toHaveLength(0);
+  });
+
+  it("clears all memories", () => {
+    manager.set("key1", "value1");
+    manager.set("key2", "value2");
+    manager.clear();
+
+    const stats = manager.getStats();
+    expect(stats.total).toBe(0);
+  });
+
+  it("cleans up expired memories", async () => {
+    manager.set("expiring1", "value1", { ttl: 50 });
+    manager.set("expiring2", "value2", { ttl: 50 });
+    manager.set("permanent", "value3");
+
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    const cleared = manager.cleanupExpired();
+
+    expect(cleared).toBe(2);
+    expect(manager.get("permanent")).toBe("value3");
+  });
+
+  it("gets statistics", () => {
+    manager.set("key1", "value1");
+    manager.set("key1", "value2");
+    manager.set("key2", "value3", { ttl: 1000 });
+
+    const stats = manager.getStats();
+    expect(stats.total).toBe(3);
+    expect(stats.byKey.key1).toBe(2);
+    expect(stats.byKey.key2).toBe(1);
+    expect(stats.withTTL).toBe(1);
+  });
+
+  it("returns most recent value for duplicate keys", () => {
+    manager.set("test-key", "old-value");
+    manager.set("test-key", "new-value");
+
+    const value = manager.get("test-key");
+    expect(value).toBe("new-value");
+  });
+});

package/extensions/memory-core/src/memory-manager.ts

@@ -0,0 +1,186 @@
+/**
+ * Memory Manager Plugin
+ * Core memory management for Pool Bot agents
+ */
+
+export type MemoryEntry = {
+  id: string;
+  key: string;
+  value: unknown;
+  ttl?: number; // Time to live in ms
+  createdAt: number;
+  expiresAt?: number;
+  tags?: string[];
+};
+
+export type MemoryQuery = {
+  key?: string;
+  keyPrefix?: string;
+  tags?: string[];
+  excludeExpired?: boolean;
+};
+
+export class MemoryManager {
+  private memories: Map<string, MemoryEntry> = new Map();
+  private cleanupInterval?: NodeJS.Timeout;
+
+  constructor(cleanupIntervalMs = 60000) {
+    // Start cleanup interval
+    this.cleanupInterval = setInterval(() => this.cleanupExpired(), cleanupIntervalMs);
+  }
+
+  /**
+   * Set a memory entry
+   */
+  set(key: string, value: unknown, options?: { ttl?: number; tags?: string[] }): MemoryEntry {
+    const id = `mem_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    const createdAt = Date.now();
+    const expiresAt = options?.ttl ? createdAt + options.ttl : undefined;
+
+    const entry: MemoryEntry = {
+      id,
+      key,
+      value,
+      ttl: options?.ttl,
+      createdAt,
+      expiresAt,
+      tags: options?.tags,
+    };
+
+    this.memories.set(id, entry);
+    return entry;
+  }
+
+  /**
+   * Get a memory entry by key
+   */
+  get<T = unknown>(key: string): T | undefined {
+    const entries = Array.from(this.memories.values()).filter((e) => e.key === key);
+    if (entries.length === 0) {
+      return undefined;
+    }
+
+    // Return most recent
+    const latest = entries.sort((a, b) => b.createdAt - a.createdAt)[0];
+
+    // Check expiration
+    if (latest.expiresAt && latest.expiresAt < Date.now()) {
+      this.delete(latest.id);
+      return undefined;
+    }
+
+    return latest.value as T;
+  }
+
+  /**
+   * Delete a memory entry
+   */
+  delete(idOrKey: string): boolean {
+    // Try by ID first
+    if (this.memories.has(idOrKey)) {
+      return this.memories.delete(idOrKey);
+    }
+
+    // Try by key
+    const entries = Array.from(this.memories.values()).filter((e) => e.key === idOrKey);
+    for (const entry of entries) {
+      this.memories.delete(entry.id);
+    }
+
+    return entries.length > 0;
+  }
+
+  /**
+   * Query memories
+   */
+  query(query: MemoryQuery): MemoryEntry[] {
+    let results = Array.from(this.memories.values());
+
+    // Filter by key
+    if (query.key) {
+      results = results.filter((e) => e.key === query.key);
+    }
+
+    // Filter by key prefix
+    if (query.keyPrefix) {
+      results = results.filter((e) => e.key.startsWith(query.keyPrefix));
+    }
+
+    // Filter by tags
+    if (query.tags && query.tags.length > 0) {
+      results = results.filter((e) => e.tags?.some((t) => query.tags?.includes(t)));
+    }
+
+    // Exclude expired
+    if (query.excludeExpired !== false) {
+      const now = Date.now();
+      results = results.filter((e) => !e.expiresAt || e.expiresAt > now);
+    }
+
+    return results;
+  }
+
+  /**
+   * Clear all memories
+   */
+  clear(): void {
+    this.memories.clear();
+  }
+
+  /**
+   * Cleanup expired memories
+   */
+  cleanupExpired(): number {
+    const now = Date.now();
+    let cleared = 0;
+
+    for (const [id, entry] of this.memories.entries()) {
+      if (entry.expiresAt && entry.expiresAt < now) {
+        this.memories.delete(id);
+        cleared++;
+      }
+    }
+
+    return cleared;
+  }
+
+  /**
+   * Get statistics
+   */
+  getStats(): {
+    total: number;
+    byKey: Record<string, number>;
+    expired: number;
+    withTTL: number;
+  } {
+    const entries = Array.from(this.memories.values());
+    const now = Date.now();
+
+    return {
+      total: entries.length,
+      byKey: entries.reduce((acc, e) => {
+        acc[e.key] = (acc[e.key] || 0) + 1;
+        return acc;
+      }, {} as Record<string, number>),
+      expired: entries.filter((e) => e.expiresAt && e.expiresAt < now).length,
+      withTTL: entries.filter((e) => e.ttl).length,
+    };
+  }
+
+  /**
+   * Destroy the memory manager
+   */
+  destroy(): void {
+    if (this.cleanupInterval) {
+      clearInterval(this.cleanupInterval);
+    }
+    this.clear();
+  }
+}
+
+/**
+ * Create memory manager instance
+ */
+export function createMemoryManager(cleanupIntervalMs?: number): MemoryManager {
+  return new MemoryManager(cleanupIntervalMs);
+}

package/extensions/nostr/node_modules/.bin/tsc

@@ -15,7 +15,7 @@ else
   export NODE_PATH="/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/typescript@5.9.3/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/tsc" "$@"
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
 else
-  exec node  "$basedir/../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/tsc" "$@"
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
 fi

package/extensions/nostr/node_modules/.bin/tsserver

@@ -15,7 +15,7 @@ else
   export NODE_PATH="/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/typescript@5.9.3/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/tsserver" "$@"
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
 else
-  exec node  "$basedir/../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/tsserver" "$@"
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
 fi

package/extensions/nostr/node_modules/.bin/vitest

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/vitest@1.6.1_@types+node@20.19.30_@vitest+browser@4.0.18_vite@7.3.1_@types+node@25.2.3__a102e25684722dd7e16c8e55a5848dc8/node_modules/vitest/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/vitest@1.6.1_@types+node@20.19.30_@vitest+browser@4.0.18_vite@7.3.1_@types+node@25.2.3__a102e25684722dd7e16c8e55a5848dc8/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/vitest@1.6.1_@types+node@20.19.30_@vitest+browser@4.0.18_vite@7.3.1_@types+node@25.2.3__a102e25684722dd7e16c8e55a5848dc8/node_modules/vitest/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/vitest@1.6.1_@types+node@20.19.30_@vitest+browser@4.0.18_vite@7.3.1_@types+node@25.2.3__a102e25684722dd7e16c8e55a5848dc8/node_modules:/Users/pool/Documents/GitHub/pool-bot/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../vitest/vitest.mjs" "$@"
+else
+  exec node  "$basedir/../vitest/vitest.mjs" "$@"
+fi

package/extensions/nostr/package.json

@@ -1,31 +1,22 @@
 {
   "name": "@poolbot/nostr",
-  "version": "2026.3.11",
+  "version": "1.0.0",
+  "description": "Nostr channel extension for Pool Bot",
   "type": "module",
-  "description": "Poolbot Nostr channel plugin for NIP-04 encrypted DMs",
-  "poolbot": {
-    "extensions": [
-      "./index.ts"
-    ],
-    "channel": {
-      "id": "nostr",
-      "label": "Nostr",
-      "selectionLabel": "Nostr (NIP-04 DMs)",
-      "docsPath": "/channels/nostr",
-      "docsLabel": "nostr",
-      "blurb": "Decentralized protocol; encrypted DMs via NIP-04.",
-      "order": 55,
-      "quickstartAllowFrom": true
-    },
-    "install": {
-      "npmSpec": "@poolbot/nostr",
-      "localPath": "extensions/nostr",
-      "defaultChoice": "npm"
-    }
+  "main": "src/index.js",
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsc"
   },
   "dependencies": {
-    "poolbot": "workspace:*",
-    "nostr-tools": "^2.20.0",
-    "zod": "^4.3.6"
+    "nostr-tools": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {
+    "poolbot": "workspace:*"
   }
 }

package/extensions/nostr/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * Nostr Channel Extension Entry Point
+ */
+
+export { NostrChannel, createNostrChannel, type NostrConfig } from "./nostr-channel.js";
+
+// Export channel metadata
+export const channelInfo = {
+  id: "nostr",
+  name: "Nostr",
+  version: "1.0.0",
+  description: "Nostr integration for Pool Bot",
+  author: "Pool Bot Team",
+};

package/extensions/nostr/src/nostr-channel.test.ts

@@ -0,0 +1,55 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { NostrChannel, createNostrChannel } from "./nostr-channel";
+
+describe("NostrChannel", () => {
+  const mockConfig = {
+    relays: ["wss://relay.damus.io", "wss://nos.lol"],
+  };
+
+  let channel: NostrChannel;
+
+  beforeEach(() => {
+    channel = createNostrChannel(mockConfig);
+  });
+
+  it("creates channel with correct id", () => {
+    expect(channel.id).toBe("nostr");
+    expect(channel.name).toBe("Nostr");
+  });
+
+  it("generates keypair if not provided", () => {
+    expect(channel.getPublicKey()).toBeDefined();
+    expect(channel.getPublicKey().length).toBe(64);
+  });
+
+  it("uses provided public key", () => {
+    const configWithKey = {
+      ...mockConfig,
+      publicKey: "abc123",
+    };
+    const channel2 = createNostrChannel(configWithKey);
+    expect(channel2.getPublicKey()).toBe("abc123");
+  });
+
+  it("starts disconnected", () => {
+    expect(channel.getStatus()).toBe("disconnected");
+  });
+
+  it("returns presence with public key", async () => {
+    const presences = await channel.getPresences();
+    expect(presences.length).toBe(1);
+    expect(presences[0].userId).toBe(channel.getPublicKey());
+  });
+
+  it("throws error when sending while disconnected", async () => {
+    await expect(
+      channel.sendMessage({ text: "test", id: "1" }),
+    ).rejects.toThrow("not connected");
+  });
+
+  it("throws error sending DM without private key", async () => {
+    await expect(
+      channel.sendDirectMessage("recipient", "message"),
+    ).rejects.toThrow("without private key");
+  });
+});