@poolzin/pool-bot 2026.3.16 → 2026.3.18

package/extensions/mattermost/src/runtime.ts

@@ -1,14 +1,17 @@
 import type { PluginRuntime } from "poolbot/plugin-sdk";
 
-let runtime: PluginRuntime | null = null;
+// MattermostPluginRuntime wrapper interface to avoid lint resolution issues
+interface MattermostPluginRuntime extends PluginRuntime {}
+
+let runtime: MattermostPluginRuntime | null = null;
 
 export function setMattermostRuntime(next: PluginRuntime) {
-  runtime = next;
+  runtime = next as MattermostPluginRuntime;
 }
 
 export function getMattermostRuntime(): PluginRuntime {
   if (!runtime) {
     throw new Error("Mattermost runtime not initialized");
   }
-  return runtime;
+  return runtime as PluginRuntime;
 }

package/extensions/msteams/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 setMSTeamsRuntime(next: PluginRuntime) {

package/extensions/nextcloud-talk/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 setNextcloudTalkRuntime(next: PluginRuntime) {

package/extensions/nostr/src/runtime.ts

@@ -1,6 +1,9 @@
 import type { PluginRuntime } from "poolbot/plugin-sdk";
 
-let runtime: PluginRuntime | null = null;
+// NostrPluginRuntime wrapper interface to avoid lint resolution issues
+interface NostrPluginRuntime extends PluginRuntime {}
+
+let runtime: NostrPluginRuntime | null = null;
 
 export function setNostrRuntime(next: PluginRuntime): void {
   runtime = next;
@@ -10,5 +13,5 @@ export function getNostrRuntime(): PluginRuntime {
   if (!runtime) {
     throw new Error("Nostr runtime not initialized");
   }
-  return runtime;
+  return runtime as PluginRuntime;
 }

package/extensions/ollama/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@poolbot/ollama",
+  "version": "2026.3.17",
+  "description": "Ollama provider for Pool Bot - local LLM inference",
+  "type": "module",
+  "main": "dist/index.js",
+  "dependencies": {
+    "poolbot": "workspace:*",
+    "ollama": "^0.6.3"
+  },
+  "poolbot": {
+    "extensions": ["./src/index.ts"],
+    "provider": {
+      "id": "ollama",
+      "name": "Ollama",
+      "description": "Local LLM inference with Ollama",
+      "models": ["llama3", "mistral", "codellama", "phi", "gemma"]
+    }
+  }
+}

package/extensions/ollama/poolbot.plugin.json

@@ -0,0 +1,14 @@
+{
+  "id": "ollama",
+  "name": "Ollama Provider",
+  "version": "2026.3.17",
+  "description": "Local LLM inference with Ollama",
+  "main": "dist/index.js",
+  "capabilities": ["provider", "local-llm"],
+  "commands": ["ollama.status", "ollama.models", "ollama.pull"],
+  "config": {
+    "host": "http://127.0.0.1",
+    "port": 11434,
+    "defaultModel": "llama3"
+  }
+}

package/extensions/ollama/src/index.ts

@@ -0,0 +1,95 @@
+/**
+ * Pool Bot Ollama Provider Extension
+ * 
+ * Provides local LLM inference via Ollama
+ */
+
+export default async function createPlugin(ctx: any): Promise<any> {
+  const config = ctx.config as {
+    host?: string;
+    port?: number;
+    defaultModel?: string;
+  };
+
+  const host = config.host ?? "http://127.0.0.1";
+  const port = config.port ?? 11434;
+  const baseUrl = `${host}:${port}`;
+
+  ctx.logger.info(`Ollama Provider initialized (${baseUrl})`);
+
+  ctx.cli
+    .command("ollama.status")
+    .description("Check Ollama server status")
+    .action(async () => {
+      try {
+        const res = await fetch(`${baseUrl}/api/tags`);
+        if (res.ok) {
+          const data = await res.json() as { models: Array<{ name: string }> };
+          console.log("✅ Ollama Status");
+          console.log(`   URL: ${baseUrl}`);
+          console.log(`   Models: ${data.models.length}`);
+          data.models.slice(0, 5).forEach((m) => console.log(`   - ${m.name}`));
+        } else {
+          console.log("❌ Ollama not running");
+        }
+      } catch (error) {
+        console.log("❌ Ollama connection failed");
+        console.log(`   Error: ${error instanceof Error ? error.message : error}`);
+      }
+    });
+
+  ctx.cli
+    .command("ollama.models")
+    .description("List available Ollama models")
+    .action(async () => {
+      try {
+        const res = await fetch(`${baseUrl}/api/tags`);
+        if (!res.ok) throw new Error("Ollama not running");
+        
+        const data = await res.json() as { models: Array<{ name: string; size: number }> };
+        console.log("📦 Ollama Models\n");
+        
+        for (const model of data.models) {
+          const sizeGB = (model.size / 1e9).toFixed(2);
+          console.log(`🤖 ${model.name}`);
+          console.log(`   Size: ${sizeGB} GB`);
+        }
+      } catch (error) {
+        console.error("Failed to list models:", error instanceof Error ? error.message : error);
+        process.exit(1);
+      }
+    });
+
+  ctx.cli
+    .command("ollama.pull")
+    .description("Pull an Ollama model")
+    .argument("<model>", "Model name (e.g., llama3, mistral)")
+    .action(async (modelName: string) => {
+      console.log(`📥 Pulling ${modelName}...`);
+      
+      try {
+        const res = await fetch(`${baseUrl}/api/pull`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ name: modelName }),
+        });
+        
+        if (res.ok) {
+          console.log(`✅ Model ${modelName} pulled successfully`);
+        } else {
+          const error = await res.text();
+          console.error(`❌ Failed to pull: ${error}`);
+          process.exit(1);
+        }
+      } catch (error) {
+        console.error("Failed to pull model:", error instanceof Error ? error.message : error);
+        process.exit(1);
+      }
+    });
+
+  return {
+    name: "ollama",
+    version: "2026.3.17",
+    commands: ["ollama.status", "ollama.models", "ollama.pull"],
+  };
+}

package/extensions/sglang/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@poolbot/sglang",
+  "version": "2026.3.17",
+  "description": "SGLang provider for Pool Bot - optimized LLM inference",
+  "type": "module",
+  "main": "dist/index.js",
+  "dependencies": {
+    "poolbot": "workspace:*"
+  },
+  "poolbot": {
+    "extensions": ["./src/index.ts"],
+    "provider": {
+      "id": "sglang",
+      "name": "SGLang",
+      "description": "SGLang runtime for optimized LLM inference"
+    }
+  }
+}

package/extensions/sglang/poolbot.plugin.json

@@ -0,0 +1,13 @@
+{
+  "id": "sglang",
+  "name": "SGLang Provider",
+  "version": "2026.3.17",
+  "description": "SGLang runtime for optimized LLM inference",
+  "main": "dist/index.js",
+  "capabilities": ["provider", "optimized-inference"],
+  "commands": ["sglang.status", "sglang.models"],
+  "config": {
+    "host": "http://127.0.0.1",
+    "port": 30000
+  }
+}

package/extensions/sglang/src/index.ts

@@ -0,0 +1,62 @@
+/**
+ * Pool Bot SGLang Provider Extension
+ * 
+ * Provides SGLang runtime for optimized 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 ?? 30000;
+  const baseUrl = `${host}:${port}`;
+
+  ctx.logger.info(`SGLang Provider initialized (${baseUrl})`);
+
+  ctx.cli
+    .command("sglang.status")
+    .description("Check SGLang server status")
+    .action(async () => {
+      try {
+        const res = await fetch(`${baseUrl}/health`);
+        if (res.ok) {
+          console.log("✅ SGLang Status");
+          console.log(`   URL: ${baseUrl}`);
+          console.log(`   Status: Running`);
+        } else {
+          console.log("❌ SGLang not running");
+        }
+      } catch (error) {
+        console.log("❌ SGLang connection failed");
+        console.log(`   Error: ${error instanceof Error ? error.message : error}`);
+      }
+    });
+
+  ctx.cli
+    .command("sglang.models")
+    .description("List available SGLang models")
+    .action(async () => {
+      try {
+        const res = await fetch(`${baseUrl}/v1/models`);
+        if (!res.ok) throw new Error("SGLang not running");
+        
+        const data = await res.json() as { data: Array<{ id: string }> };
+        console.log("📦 SGLang 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);
+      }
+    });
+
+  return {
+    name: "sglang",
+    version: "2026.3.17",
+    commands: ["sglang.status", "sglang.models"],
+  };
+}

package/extensions/signal/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 setSignalRuntime(next: PluginRuntime) {

package/extensions/slack/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 setSlackRuntime(next: PluginRuntime) {

package/extensions/telegram/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 setTelegramRuntime(next: PluginRuntime) {

package/extensions/test-utils/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@poolbot/test-utils",
+  "version": "2026.3.17",
+  "description": "Pool Bot test utilities and helpers",
+  "type": "module",
+  "main": "dist/index.js",
+  "dependencies": {
+    "poolbot": "workspace:*"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.18"
+  },
+  "poolbot": {
+    "extensions": ["./src/index.ts"],
+    "testUtils": true
+  }
+}

package/extensions/test-utils/poolbot.plugin.json

@@ -0,0 +1,16 @@
+{
+  "id": "test-utils",
+  "name": "Test Utilities",
+  "version": "2026.3.17",
+  "description": "Testing utilities and helpers for Pool Bot development",
+  "main": "dist/index.js",
+  "capabilities": ["testing", "mocking"],
+  "commands": ["test.mock-config"],
+  "exports": {
+    "createMockConfig": "./dist/index.js",
+    "createMockRuntime": "./dist/index.js",
+    "waitForCondition": "./dist/index.js",
+    "createTempFile": "./dist/index.js",
+    "cleanupTempFiles": "./dist/index.js"
+  }
+}

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
+  }
+}