@poolzin/pool-bot 2026.3.22 → 2026.3.24

package/extensions/irc/src/irc-channel.ts

@@ -0,0 +1,191 @@
+/**
+ * IRC Channel Implementation
+ * Supports connecting to IRC servers, joining channels, and sending/receiving messages
+ */
+
+import IRC from "irc-framework";
+import type { Channel, ChannelMessage, ChannelPresence } from "../../../src/channels/types.js";
+
+export type IRCConfig = {
+  host: string;
+  port: number;
+  nick: string;
+  channels: string[];
+  password?: string;
+  sasl?: {
+    account: string;
+    password: string;
+  };
+  tls?: boolean;
+};
+
+export class IRCChannel implements Channel {
+  public readonly id = "irc";
+  public readonly name = "IRC";
+
+  private config: IRCConfig;
+  private client: IRC.Client;
+  private connected = false;
+  private messageCallback?: (message: ChannelMessage) => void;
+
+  constructor(config: IRCConfig) {
+    this.config = config;
+    this.client = new IRC.Client({
+      host: config.host,
+      port: config.port,
+      nick: config.nick,
+      password: config.password,
+      sasl: config.sasl ? {
+        account: config.sasl.account,
+        password: config.sasl.password,
+      } : undefined,
+      tls: config.tls,
+      auto_reconnect: true,
+      auto_reconnect_wait: 10,
+      max_reconnect_attempts: 5,
+    });
+
+    this.setupEventHandlers();
+  }
+
+  private setupEventHandlers(): void {
+    this.client.on("connect", () => {
+      this.connected = true;
+      console.log("[irc] Connected to server");
+
+      // Join configured channels
+      for (const channel of this.config.channels) {
+        this.client.join(channel);
+      }
+    });
+
+    this.client.on("disconnect", () => {
+      this.connected = false;
+      console.log("[irc] Disconnected from server");
+    });
+
+    this.client.on("message", (context) => {
+      if (this.messageCallback && context.type === "message") {
+        this.messageCallback({
+          id: `${context.target}-${Date.now()}`,
+          text: context.message,
+          from: context.nick,
+          to: context.target,
+          timestamp: Date.now(),
+          threadId: undefined,
+        });
+      }
+    });
+
+    this.client.on("notice", (context) => {
+      console.log("[irc] Notice:", context);
+    });
+
+    this.client.on("error", (error) => {
+      console.error("[irc] Error:", error);
+    });
+  }
+
+  async connect(): Promise<void> {
+    return new Promise((resolve, reject) => {
+      try {
+        this.client.connect();
+
+        const timeout = setTimeout(() => {
+          reject(new Error("IRC connection timeout"));
+        }, 30000);
+
+        this.client.once("connect", () => {
+          clearTimeout(timeout);
+          resolve();
+        });
+
+        this.client.once("error", (error) => {
+          clearTimeout(timeout);
+          reject(new Error(`IRC connection error: ${error.error}`));
+        });
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  async disconnect(): Promise<void> {
+    this.client.quit("Disconnecting");
+    this.connected = false;
+  }
+
+  async sendMessage(message: ChannelMessage): Promise<void> {
+    if (!this.connected) {
+      throw new Error("IRC channel not connected");
+    }
+
+    const target = message.to || this.config.channels[0];
+    if (!target) {
+      throw new Error("No target channel specified");
+    }
+
+    this.client.say(target, message.text);
+  }
+
+  async receiveMessages(callback: (message: ChannelMessage) => void): Promise<void> {
+    this.messageCallback = callback;
+  }
+
+  async getPresences(): Promise<ChannelPresence[]> {
+    const presences: ChannelPresence[] = [];
+
+    for (const channel of this.config.channels) {
+      try {
+        const users = await this.getChannelUsers(channel);
+        for (const user of users) {
+          presences.push({
+            channelId: channel,
+            userId: user,
+            status: "online",
+            lastSeen: Date.now(),
+          });
+        }
+      } catch {
+        // Ignore errors getting users
+      }
+    }
+
+    return presences;
+  }
+
+  private getChannelUsers(channel: string): Promise<string[]> {
+    return new Promise((resolve) => {
+      this.client.who(channel, (response) => {
+        if (response.users) {
+          resolve(response.users.map((u: any) => u.nick));
+        } else {
+          resolve([]);
+        }
+      });
+    });
+  }
+
+  getStatus(): "connected" | "disconnected" | "error" {
+    return this.connected ? "connected" : "disconnected";
+  }
+
+  async joinChannel(channel: string): Promise<void> {
+    this.client.join(channel);
+    if (!this.config.channels.includes(channel)) {
+      this.config.channels.push(channel);
+    }
+  }
+
+  async leaveChannel(channel: string): Promise<void> {
+    this.client.part(channel);
+    this.config.channels = this.config.channels.filter((c) => c !== channel);
+  }
+}
+
+/**
+ * Create IRC channel from config
+ */
+export function createIRCChannel(config: IRCConfig): IRCChannel {
+  return new IRCChannel(config);
+}

package/extensions/keyed-async-queue/node_modules/.bin/tsc

@@ -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/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"
+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/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/extensions/keyed-async-queue/node_modules/.bin/tsserver

@@ -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/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"
+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/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/extensions/keyed-async-queue/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/keyed-async-queue/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@poolbot/keyed-async-queue",
+  "version": "1.0.0",
+  "description": "Keyed async queue for concurrent task management",
+  "type": "module",
+  "main": "src/index.js",
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsc"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {
+    "poolbot": "workspace:*"
+  }
+}

package/extensions/keyed-async-queue/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * Keyed Async Queue Plugin Entry Point
+ */
+
+export { KeyedAsyncQueue, createKeyedAsyncQueue, type QueueTask, type QueueStats } from "./queue.js";
+
+// Export plugin metadata
+export const pluginInfo = {
+  id: "keyed-async-queue",
+  name: "Keyed Async Queue",
+  version: "1.0.0",
+  description: "Key-based async queue for concurrent task management",
+  author: "Pool Bot Team",
+};

package/extensions/keyed-async-queue/src/queue.test.ts

@@ -0,0 +1,135 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { KeyedAsyncQueue, createKeyedAsyncQueue } from "./queue";
+
+describe("KeyedAsyncQueue", () => {
+  let queue: KeyedAsyncQueue;
+
+  beforeEach(() => {
+    queue = createKeyedAsyncQueue();
+  });
+
+  it("enqueues and processes tasks", async () => {
+    const result = await queue.enqueue("key1", async () => "result");
+    expect(result).toBe("result");
+  });
+
+  it("processes tasks in order for same key", async () => {
+    const results: string[] = [];
+
+    const task1 = queue.enqueue("key1", async () => {
+      await new Promise((resolve) => setTimeout(resolve, 50));
+      results.push("task1");
+      return "result1";
+    });
+
+    const task2 = queue.enqueue("key1", async () => {
+      results.push("task2");
+      return "result2";
+    });
+
+    await Promise.all([task1, task2]);
+    expect(results).toEqual(["task1", "task2"]);
+  });
+
+  it("processes tasks in parallel for different keys", async () => {
+    const results: string[] = [];
+
+    const task1 = queue.enqueue("key1", async () => {
+      await new Promise((resolve) => setTimeout(resolve, 50));
+      results.push("key1");
+      return "result1";
+    });
+
+    const task2 = queue.enqueue("key2", async () => {
+      results.push("key2");
+      return "result2";
+    });
+
+    await Promise.all([task1, task2]);
+    expect(results).toEqual(["key2", "key1"]); // key2 finishes first
+  });
+
+  it("respects priority", async () => {
+    const results: string[] = [];
+
+    queue.enqueue("key1", async () => {
+      await new Promise((resolve) => setTimeout(resolve, 50));
+      results.push("low");
+      return "low";
+    }, 0);
+
+    queue.enqueue("key1", async () => {
+      results.push("high");
+      return "high";
+    }, 10);
+
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    expect(results).toEqual(["high", "low"]);
+  });
+
+  it("gets queue length", async () => {
+    queue.enqueue("key1", async () => {
+      await new Promise((resolve) => setTimeout(resolve, 100));
+    });
+
+    queue.enqueue("key1", async () => {});
+    queue.enqueue("key1", async () => {});
+
+    expect(queue.getQueueLength("key1")).toBeGreaterThanOrEqual(1);
+  });
+
+  it("clears queue for key", () => {
+    queue.enqueue("key1", async () => {});
+    queue.enqueue("key1", async () => {});
+    queue.enqueue("key2", async () => {});
+
+    const cleared = queue.clearQueue("key1");
+    expect(cleared).toBeGreaterThanOrEqual(1);
+    expect(queue.getQueueLength("key2")).toBe(1);
+  });
+
+  it("clears all queues", () => {
+    queue.enqueue("key1", async () => {});
+    queue.enqueue("key2", async () => {});
+
+    const cleared = queue.clearAll();
+    expect(cleared).toBeGreaterThanOrEqual(2);
+    expect(queue.getTotalQueueLength()).toBe(0);
+  });
+
+  it("gets statistics", async () => {
+    queue.enqueue("key1", async () => {
+      await new Promise((resolve) => setTimeout(resolve, 100));
+    });
+    queue.enqueue("key1", async () => {});
+    queue.enqueue("key2", async () => {});
+
+    const stats = queue.getStats();
+    expect(stats.total).toBeGreaterThanOrEqual(2);
+    expect(stats.byKey.key1).toBeGreaterThanOrEqual(1);
+    expect(stats.byKey.key2).toBeGreaterThanOrEqual(1);
+  });
+
+  it("handles task errors", async () => {
+    const errorTask = queue.enqueue("key1", async () => {
+      throw new Error("Task failed");
+    });
+
+    await expect(errorTask).rejects.toThrow("Task failed");
+  });
+
+  it("continues processing after error", async () => {
+    const results: string[] = [];
+
+    queue.enqueue("key1", async () => {
+      throw new Error("First failed");
+    });
+
+    await queue.enqueue("key1", async () => {
+      results.push("second");
+      return "success";
+    });
+
+    expect(results).toEqual(["second"]);
+  });
+});

package/extensions/keyed-async-queue/src/queue.ts

@@ -0,0 +1,200 @@
+/**
+ * Keyed Async Queue
+ * Manages concurrent tasks with key-based ordering
+ */
+
+export type QueueTask<T = unknown> = {
+  id: string;
+  key: string;
+  fn: () => Promise<T>;
+  priority?: number;
+  createdAt: number;
+};
+
+export type QueueStats = {
+  total: number;
+  byKey: Record<string, number>;
+  processing: number;
+  queued: number;
+};
+
+export class KeyedAsyncQueue {
+  private queues: Map<string, QueueTask[]> = new Map();
+  private processing: Map<string, boolean> = new Map();
+  private concurrency: number;
+
+  constructor(concurrency = 5) {
+    this.concurrency = concurrency;
+  }
+
+  /**
+   * Add a task to the queue
+   */
+  async enqueue<T>(key: string, fn: () => Promise<T>, priority = 0): Promise<T> {
+    const task: QueueTask<T> = {
+      id: `task_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+      key,
+      fn,
+      priority,
+      createdAt: Date.now(),
+    };
+
+    // Get or create queue for this key
+    let queue = this.queues.get(key);
+    if (!queue) {
+      queue = [];
+      this.queues.set(key, queue);
+    }
+
+    // Insert by priority (higher priority first)
+    const insertIndex = queue.findIndex((t) => t.priority < priority);
+    if (insertIndex === -1) {
+      queue.push(task);
+    } else {
+      queue.splice(insertIndex, 0, task);
+    }
+
+    // Process queue
+    return this.processQueue(key);
+  }
+
+  /**
+   * Process queue for a specific key
+   */
+  private async processQueue<T>(key: string): Promise<T> {
+    // Check if already processing for this key
+    if (this.processing.get(key)) {
+      // Wait for current processing to finish
+      return new Promise((resolve, reject) => {
+        const checkQueue = async () => {
+          const queue = this.queues.get(key);
+          if (!queue || queue.length === 0) {
+            reject(new Error("Task not found in queue"));
+            return;
+          }
+
+          const task = queue[0];
+          if (!task) {
+            reject(new Error("Task not found"));
+            return;
+          }
+
+          try {
+            const result = await task.fn();
+            queue.shift();
+            resolve(result);
+          } catch (error) {
+            queue.shift();
+            reject(error);
+          }
+        };
+
+        setTimeout(checkQueue, 10);
+      });
+    }
+
+    // Mark as processing
+    this.processing.set(key, true);
+
+    // Get next task
+    const queue = this.queues.get(key);
+    if (!queue || queue.length === 0) {
+      this.processing.set(key, false);
+      throw new Error("No tasks in queue");
+    }
+
+    const task = queue[0];
+    if (!task) {
+      this.processing.set(key, false);
+      throw new Error("Task not found");
+    }
+
+    try {
+      const result = await task.fn();
+      queue.shift();
+      return result;
+    } finally {
+      this.processing.set(key, false);
+
+      // Process next task if available
+      if (queue.length > 0) {
+        this.processQueue(key).catch(console.error);
+      }
+    }
+  }
+
+  /**
+   * Get queue length for a key
+   */
+  getQueueLength(key: string): number {
+    const queue = this.queues.get(key);
+    return queue ? queue.length : 0;
+  }
+
+  /**
+   * Get total queue length
+   */
+  getTotalQueueLength(): number {
+    let total = 0;
+    for (const queue of this.queues.values()) {
+      total += queue.length;
+    }
+    return total;
+  }
+
+  /**
+   * Clear queue for a key
+   */
+  clearQueue(key: string): number {
+    const queue = this.queues.get(key);
+    if (!queue) {
+      return 0;
+    }
+
+    const count = queue.length;
+    queue.length = 0;
+    return count;
+  }
+
+  /**
+   * Clear all queues
+   */
+  clearAll(): number {
+    let count = 0;
+    for (const queue of this.queues.values()) {
+      count += queue.length;
+    }
+    this.queues.clear();
+    this.processing.clear();
+    return count;
+  }
+
+  /**
+   * Get statistics
+   */
+  getStats(): QueueStats {
+    const stats: QueueStats = {
+      total: 0,
+      byKey: {},
+      processing: 0,
+      queued: 0,
+    };
+
+    for (const [key, queue] of this.queues.entries()) {
+      stats.byKey[key] = queue.length;
+      stats.total += queue.length;
+    }
+
+    stats.queued = stats.total;
+    stats.processing = Array.from(this.processing.values()).filter(Boolean).length;
+
+    return stats;
+  }
+}
+
+/**
+ * Create keyed async queue
+ */
+export function createKeyedAsyncQueue(concurrency?: number): KeyedAsyncQueue {
+  return new KeyedAsyncQueue(concurrency);
+}

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

@@ -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/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"
+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/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

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

@@ -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/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"
+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/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi