@poolzin/pool-bot 2026.3.17 → 2026.3.18

package/extensions/test-utils/src/index.ts

@@ -0,0 +1,220 @@
+/**
+ * Pool Bot Test Utilities
+ * 
+ * Provides testing utilities and helpers for Pool Bot development
+ */
+
+import type { PoolBotConfig } from "poolbot/config/config.js";
+import type { PluginRuntime } from "poolbot/plugins/runtime/types.js";
+
+/**
+ * Create a mock Pool Bot config for testing
+ */
+export function createMockConfig(overrides?: Partial<PoolBotConfig>): PoolBotConfig {
+  return {
+    models: {
+      primary: "gpt-4o",
+    },
+    agents: {
+      list: [],
+    },
+    channels: {},
+    gateway: {
+      port: 18789,
+      host: "127.0.0.1",
+    },
+    ...overrides,
+  } as PoolBotConfig;
+}
+
+/**
+ * Create a mock Plugin Runtime for testing
+ */
+export function createMockRuntime(): PluginRuntime {
+  return {
+    version: "test",
+    config: {
+      loadConfig: async () => createMockConfig(),
+      writeConfigFile: async () => {},
+    },
+    system: {
+      enqueueSystemEvent: async () => {},
+      runCommandWithTimeout: async () => ({ stdout: "", stderr: "", exitCode: 0 }),
+      formatNativeDependencyHint: () => "",
+    },
+    media: {
+      loadWebMedia: async () => ({ buffer: Buffer.from([]) }),
+      detectMime: async () => "application/octet-stream",
+      mediaKindFromMime: () => "unknown" as any,
+      isVoiceCompatibleAudio: () => false,
+      getImageMetadata: async () => ({ width: 0, height: 0 }),
+      resizeToJpeg: async () => Buffer.from([]),
+    },
+    tts: {
+      textToSpeechTelephony: async () => ({ audioPath: "" }),
+    },
+    tools: {
+      createMemoryGetTool: () => ({} as any),
+      createMemorySearchTool: () => ({} as any),
+      registerMemoryCli: () => {},
+    },
+    channel: {
+      text: {
+        chunkByNewline: () => [],
+        chunkMarkdownText: () => [],
+        chunkMarkdownTextWithMode: () => [],
+        chunkText: () => [],
+        chunkTextWithMode: () => [],
+        resolveChunkMode: () => "markdown" as const,
+        resolveTextChunkLimit: () => 4000,
+        hasControlCommand: () => false,
+        resolveMarkdownTableMode: () => "convert" as const,
+        convertMarkdownTables: () => "",
+      },
+      reply: {
+        dispatchReplyWithBufferedBlockDispatcher: async () => {},
+        createReplyDispatcherWithTyping: () => ({} as any),
+        resolveEffectiveMessagesConfig: () => ({} as any),
+        resolveHumanDelayConfig: () => ({} as any),
+        dispatchReplyFromConfig: async () => {},
+        finalizeInboundContext: async () => ({} as any),
+        formatAgentEnvelope: () => "",
+        formatInboundEnvelope: () => "",
+        resolveEnvelopeFormatOptions: () => ({} as any),
+      },
+      routing: {
+        resolveAgentRoute: async () => null,
+      },
+      pairing: {
+        buildPairingReply: () => "",
+        readAllowFromStore: async () => [],
+        upsertPairingRequest: async () => {},
+      },
+      identity: {
+        resolveEffectiveMessagesConfig: () => ({} as any),
+        resolveHumanDelayConfig: () => ({} as any),
+      },
+      lifecycle: {
+        enqueueSystemEvent: async () => {},
+      },
+      gateway: {
+        call: async () => ({} as any),
+      },
+      security: {
+        checkDmPolicy: async () => "allow" as const,
+      },
+      mentions: {
+        buildMentionRegexes: () => [],
+        matchesMentionPatterns: () => false,
+        matchesMentionWithExplicit: () => false,
+      },
+      reactions: {
+        shouldAckReaction: () => false,
+        removeAckReactionAfterReply: async () => {},
+      },
+      group: {
+        resolveChannelGroupPolicy: () => "mention" as const,
+        resolveChannelGroupRequireMention: () => true,
+      },
+      debounce: {
+        createInboundDebouncer: () => ({} as any),
+        resolveInboundDebounceMs: () => 0,
+      },
+      gating: {
+        resolveCommandAuthorizedFromAuthorizers: async () => false,
+      },
+    },
+    logging: {
+      debug: () => {},
+      info: () => {},
+      warn: () => {},
+      error: () => {},
+    },
+    state: {
+      getStateDir: () => "/tmp/poolbot-test",
+    },
+    logger: {
+      debug: () => {},
+      info: () => {},
+      warn: () => {},
+      error: () => {},
+    },
+  } as PluginRuntime;
+}
+
+/**
+ * Test helper: wait for a condition to be true
+ */
+export async function waitForCondition(
+  condition: () => boolean | Promise<boolean>,
+  timeoutMs: number = 5000,
+  intervalMs: number = 100,
+): Promise<void> {
+  const start = Date.now();
+  
+  while (Date.now() - start < timeoutMs) {
+    const result = await condition();
+    if (result) return;
+    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+  }
+  
+  throw new Error(`Condition not met within ${timeoutMs}ms`);
+}
+
+/**
+ * Test helper: create a temporary file
+ */
+export async function createTempFile(content: string, extension: string = ".txt"): Promise<string> {
+  const fs = await import("node:fs/promises");
+  const path = await import("node:path");
+  const os = await import("node:os");
+  
+  const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "poolbot-test-"));
+  const filePath = path.join(tmpDir, `test${extension}`);
+  await fs.writeFile(filePath, content, "utf-8");
+  
+  return filePath;
+}
+
+/**
+ * Test helper: cleanup temporary files
+ */
+export async function cleanupTempFiles(...paths: string[]): Promise<void> {
+  const fs = await import("node:fs/promises");
+  
+  for (const p of paths) {
+    try {
+      await fs.rm(p, { recursive: true, force: true });
+    } catch {
+      // Ignore cleanup errors
+    }
+  }
+}
+
+// Export CLI command for test utilities
+export default async function createPlugin(ctx: any): Promise<any> {
+  ctx.logger.info("Test Utils initialized");
+
+  ctx.cli
+    .command("test.mock-config")
+    .description("Generate a mock config for testing")
+    .option("-o, --output <file>", "Output file path")
+    .action(async (options?: { output?: string }) => {
+      const config = createMockConfig();
+      const json = JSON.stringify(config, null, 2);
+      
+      if (options?.output) {
+        const fs = await import("node:fs/promises");
+        await fs.writeFile(options.output, json, "utf-8");
+        console.log(`✅ Mock config written to ${options.output}`);
+      } else {
+        console.log(json);
+      }
+    });
+
+  return {
+    name: "test-utils",
+    version: "2026.3.17",
+    commands: ["test.mock-config"],
+  };
+}

package/extensions/tlon/src/runtime.ts

@@ -1,5 +1,6 @@
 import type { PluginRuntime } from "poolbot/plugin-sdk";
 
+// oxlint-disable-next-line typescript-eslint/no-redundant-type-constituents
 let runtime: PluginRuntime | null = null;
 
 export function setTlonRuntime(next: PluginRuntime) {

package/extensions/twitch/src/runtime.ts

@@ -1,5 +1,6 @@
 import type { PluginRuntime } from "poolbot/plugin-sdk";
 
+// oxlint-disable-next-line typescript-eslint/no-redundant-type-constituents
 let runtime: PluginRuntime | null = null;
 
 export function setTwitchRuntime(next: PluginRuntime) {

package/extensions/vllm/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@poolbot/vllm",
+  "version": "2026.3.17",
+  "description": "vLLM provider for Pool Bot - high-throughput LLM inference",
+  "type": "module",
+  "main": "dist/index.js",
+  "dependencies": {
+    "poolbot": "workspace:*"
+  },
+  "poolbot": {
+    "extensions": ["./src/index.ts"],
+    "provider": {
+      "id": "vllm",
+      "name": "vLLM",
+      "description": "vLLM for high-throughput LLM inference",
+      "models": ["llama", "mistral", "qwen", "yi"]
+    }
+  }
+}

package/extensions/vllm/poolbot.plugin.json

@@ -0,0 +1,13 @@
+{
+  "id": "vllm",
+  "name": "vLLM Provider",
+  "version": "2026.3.17",
+  "description": "vLLM for high-throughput LLM inference",
+  "main": "dist/index.js",
+  "capabilities": ["provider", "high-throughput"],
+  "commands": ["vllm.status", "vllm.models", "vllm.generate"],
+  "config": {
+    "host": "http://127.0.0.1",
+    "port": 8000
+  }
+}

package/extensions/vllm/src/index.ts

@@ -0,0 +1,90 @@
+/**
+ * Pool Bot vLLM Provider Extension
+ * 
+ * Provides vLLM runtime for high-throughput LLM inference
+ */
+
+export default async function createPlugin(ctx: any): Promise<any> {
+  const config = ctx.config as {
+    host?: string;
+    port?: number;
+  };
+
+  const host = config.host ?? "http://127.0.0.1";
+  const port = config.port ?? 8000;
+  const baseUrl = `${host}:${port}`;
+
+  ctx.logger.info(`vLLM Provider initialized (${baseUrl})`);
+
+  ctx.cli
+    .command("vllm.status")
+    .description("Check vLLM server status")
+    .action(async () => {
+      try {
+        const res = await fetch(`${baseUrl}/health`);
+        if (res.ok) {
+          console.log("✅ vLLM Status");
+          console.log(`   URL: ${baseUrl}`);
+          console.log(`   Status: Running`);
+        } else {
+          console.log("❌ vLLM not running");
+        }
+      } catch (error) {
+        console.log("❌ vLLM connection failed");
+        console.log(`   Error: ${error instanceof Error ? error.message : error}`);
+      }
+    });
+
+  ctx.cli
+    .command("vllm.models")
+    .description("List available vLLM models")
+    .action(async () => {
+      try {
+        const res = await fetch(`${baseUrl}/v1/models`);
+        if (!res.ok) throw new Error("vLLM not running");
+        
+        const data = await res.json() as { data: Array<{ id: string }> };
+        console.log("📦 vLLM Models\n");
+        
+        for (const model of data.data) {
+          console.log(`🤖 ${model.id}`);
+        }
+      } catch (error) {
+        console.error("Failed to list models:", error instanceof Error ? error.message : error);
+      }
+    });
+
+  ctx.cli
+    .command("vllm.generate")
+    .description("Generate text with vLLM")
+    .argument("<prompt>", "Input prompt")
+    .option("-m, --model <model>", "Model to use")
+    .option("-t, --max-tokens <number>", "Max tokens to generate", "256")
+    .action(async (prompt: string, options?: { model?: string; maxTokens?: string }) => {
+      try {
+        const res = await fetch(`${baseUrl}/v1/completions`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            model: options?.model ?? "llama",
+            prompt,
+            max_tokens: parseInt(options?.maxTokens ?? "256"),
+          }),
+        });
+        
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        
+        const data = await res.json() as { choices: Array<{ text: string }> };
+        console.log(data.choices[0]?.text ?? "No response");
+      } catch (error) {
+        console.error("Generation failed:", error instanceof Error ? error.message : error);
+        process.exit(1);
+      }
+    });
+
+  return {
+    name: "vllm",
+    version: "2026.3.17",
+    commands: ["vllm.status", "vllm.models", "vllm.generate"],
+  };
+}

package/extensions/whatsapp/src/runtime.ts

@@ -1,5 +1,6 @@
 import type { PluginRuntime } from "poolbot/plugin-sdk";
 
+// oxlint-disable-next-line typescript-eslint/no-redundant-type-constituents
 let runtime: PluginRuntime | null = null;
 
 export function setWhatsAppRuntime(next: PluginRuntime) {

package/extensions/zalo/src/runtime.ts

@@ -1,5 +1,6 @@
 import type { PluginRuntime } from "poolbot/plugin-sdk";
 
+// oxlint-disable-next-line typescript-eslint/no-redundant-type-constituents
 let runtime: PluginRuntime | null = null;
 
 export function setZaloRuntime(next: PluginRuntime): void {

package/extensions/zalouser/src/runtime.ts

@@ -1,5 +1,6 @@
 import type { PluginRuntime } from "poolbot/plugin-sdk";
 
+// oxlint-disable-next-line typescript-eslint/no-redundant-type-constituents
 let runtime: PluginRuntime | null = null;
 
 export function setZalouserRuntime(next: PluginRuntime): void {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poolzin/pool-bot",
-  "version": "2026.3.17",
+  "version": "2026.3.18",
   "description": "🎱 Pool Bot - AI assistant with PLCODE integrations",
   "keywords": [],
   "license": "MIT",
@@ -24,8 +24,82 @@
   "main": "dist/index.js",
   "exports": {
     ".": "./dist/index.js",
-    "./plugin-sdk": "./dist/plugin-sdk/index.js",
-    "./plugin-sdk/*": "./dist/plugin-sdk/*",
+    "./plugin-sdk": {
+      "types": "./dist/plugin-sdk/index.d.ts",
+      "default": "./dist/plugin-sdk/index.js"
+    },
+    "./plugin-sdk/account-id": {
+      "types": "./dist/plugin-sdk/account-id.d.ts",
+      "default": "./dist/plugin-sdk/account-id.js"
+    },
+    "./plugin-sdk/agent-media-payload": {
+      "types": "./dist/plugin-sdk/agent-media-payload.d.ts",
+      "default": "./dist/plugin-sdk/agent-media-payload.js"
+    },
+    "./plugin-sdk/allow-from": {
+      "types": "./dist/plugin-sdk/allow-from.d.ts",
+      "default": "./dist/plugin-sdk/allow-from.js"
+    },
+    "./plugin-sdk/command-auth": {
+      "types": "./dist/plugin-sdk/command-auth.d.ts",
+      "default": "./dist/plugin-sdk/command-auth.js"
+    },
+    "./plugin-sdk/config-paths": {
+      "types": "./dist/plugin-sdk/config-paths.d.ts",
+      "default": "./dist/plugin-sdk/config-paths.js"
+    },
+    "./plugin-sdk/file-lock": {
+      "types": "./dist/plugin-sdk/file-lock.d.ts",
+      "default": "./dist/plugin-sdk/file-lock.js"
+    },
+    "./plugin-sdk/json-store": {
+      "types": "./dist/plugin-sdk/json-store.d.ts",
+      "default": "./dist/plugin-sdk/json-store.js"
+    },
+    "./plugin-sdk/keyed-async-queue": {
+      "types": "./dist/plugin-sdk/keyed-async-queue.d.ts",
+      "default": "./dist/plugin-sdk/keyed-async-queue.js"
+    },
+    "./plugin-sdk/onboarding": {
+      "types": "./dist/plugin-sdk/onboarding.d.ts",
+      "default": "./dist/plugin-sdk/onboarding.js"
+    },
+    "./plugin-sdk/provider-auth-result": {
+      "types": "./dist/plugin-sdk/provider-auth-result.d.ts",
+      "default": "./dist/plugin-sdk/provider-auth-result.js"
+    },
+    "./plugin-sdk/slack-message-actions": {
+      "types": "./dist/plugin-sdk/slack-message-actions.d.ts",
+      "default": "./dist/plugin-sdk/slack-message-actions.js"
+    },
+    "./plugin-sdk/status-helpers": {
+      "types": "./dist/plugin-sdk/status-helpers.d.ts",
+      "default": "./dist/plugin-sdk/status-helpers.js"
+    },
+    "./plugin-sdk/temp-path": {
+      "types": "./dist/plugin-sdk/temp-path.d.ts",
+      "default": "./dist/plugin-sdk/temp-path.js"
+    },
+    "./plugin-sdk/text-chunking": {
+      "types": "./dist/plugin-sdk/text-chunking.d.ts",
+      "default": "./dist/plugin-sdk/text-chunking.js"
+    },
+    "./plugin-sdk/tool-send": {
+      "types": "./dist/plugin-sdk/tool-send.d.ts",
+      "default": "./dist/plugin-sdk/tool-send.js"
+    },
+    "./plugin-sdk/webhook-path": {
+      "types": "./dist/plugin-sdk/webhook-path.d.ts",
+      "default": "./dist/plugin-sdk/webhook-path.js"
+    },
+    "./plugin-sdk/webhook-targets": {
+      "types": "./dist/plugin-sdk/webhook-targets.d.ts",
+      "default": "./dist/plugin-sdk/webhook-targets.js"
+    },
+    "./plugin-sdk/windows-spawn": {
+      "types": "./dist/plugin-sdk/windows-spawn.d.ts",
+      "default": "./dist/plugin-sdk/windows-spawn.js"
+    },
     "./cli-entry": "./dist/entry.js"
   },
   "scripts": {