@poolzin/pool-bot 2026.3.11 → 2026.3.14

package/extensions/xyops/src/client.ts

@@ -0,0 +1,157 @@
+import type {
+  XYOpsConfig,
+  XYOpsJob,
+  XYOpsSchedule,
+  XYOpsEvent,
+  XYOpsPlugin,
+  XYOpsStatus,
+} from "./types.js";
+
+export class XYOpsClient {
+  private baseUrl: string;
+  private apiKey?: string;
+  private timeout: number;
+
+  constructor(config: XYOpsConfig) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.timeout = config.timeout ?? 30000;
+  }
+
+  private async request<T>(
+    method: string,
+    path: string,
+    body?: unknown
+  ): Promise<T> {
+    const url = `${this.baseUrl}/api${path}`;
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+      Accept: "application/json",
+    };
+
+    if (this.apiKey) {
+      headers["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+
+    try {
+      const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+        signal: controller.signal,
+      });
+
+      clearTimeout(timeoutId);
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(
+          `XYOps API error: ${response.status} ${response.statusText} - ${errorText}`
+        );
+      }
+
+      // Handle empty responses
+      const contentType = response.headers.get("content-type");
+      if (!contentType?.includes("application/json")) {
+        return undefined as T;
+      }
+
+      return (await response.json()) as T;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new Error(`XYOps request timeout after ${this.timeout}ms`);
+      }
+      throw error;
+    }
+  }
+
+  // Jobs
+  async listJobs(offset = 0, limit = 50): Promise<XYOpsJob[]> {
+    return this.request<XYOpsJob[]>(
+      "GET",
+      `/jobs?offset=${offset}&limit=${limit}`
+    );
+  }
+
+  async getJob(jobId: string): Promise<XYOpsJob> {
+    return this.request<XYOpsJob>("GET", `/jobs/${jobId}`);
+  }
+
+  async createJob(
+    jobData: Omit<XYOpsJob, "id" | "created" | "modified">
+  ): Promise<XYOpsJob> {
+    return this.request<XYOpsJob>("POST", "/jobs", jobData);
+  }
+
+  async updateJob(
+    jobId: string,
+    updates: Partial<Omit<XYOpsJob, "id" | "created" | "modified">>
+  ): Promise<XYOpsJob> {
+    return this.request<XYOpsJob>("PUT", `/jobs/${jobId}`, updates);
+  }
+
+  async deleteJob(jobId: string): Promise<void> {
+    await this.request<void>("DELETE", `/jobs/${jobId}`);
+  }
+
+  async runJob(
+    jobId: string,
+    params?: Record<string, unknown>
+  ): Promise<{ eventId: string }> {
+    return this.request<{ eventId: string }>(
+      "POST",
+      `/jobs/${jobId}/run`,
+      params ? { params } : undefined
+    );
+  }
+
+  // Schedules
+  async listSchedules(jobId?: string): Promise<XYOpsSchedule[]> {
+    const query = jobId ? `?jobId=${jobId}` : "";
+    return this.request<XYOpsSchedule[]>("GET", `/schedules${query}`);
+  }
+
+  async createSchedule(
+    scheduleData: Omit<XYOpsSchedule, "id" | "created">
+  ): Promise<XYOpsSchedule> {
+    return this.request<XYOpsSchedule>("POST", "/schedules", scheduleData);
+  }
+
+  async deleteSchedule(scheduleId: string): Promise<void> {
+    await this.request<void>("DELETE", `/schedules/${scheduleId}`);
+  }
+
+  // Events
+  async listEvents(
+    jobId?: string,
+    limit = 50,
+    offset = 0
+  ): Promise<XYOpsEvent[]> {
+    const params = new URLSearchParams();
+    if (jobId) params.append("jobId", jobId);
+    params.append("limit", String(limit));
+    params.append("offset", String(offset));
+    return this.request<XYOpsEvent[]>("GET", `/events?${params.toString()}`);
+  }
+
+  async getEvent(eventId: string): Promise<XYOpsEvent> {
+    return this.request<XYOpsEvent>("GET", `/events/${eventId}`);
+  }
+
+  async abortEvent(eventId: string): Promise<void> {
+    await this.request<void>("POST", `/events/${eventId}/abort`);
+  }
+
+  // System
+  async getStatus(): Promise<XYOpsStatus> {
+    return this.request<XYOpsStatus>("GET", "/status");
+  }
+
+  async listPlugins(): Promise<XYOpsPlugin[]> {
+    return this.request<XYOpsPlugin[]>("GET", "/plugins");
+  }
+}

package/extensions/xyops/src/types.ts

@@ -0,0 +1,147 @@
+// XYOps Type Definitions
+
+export interface XYOpsConfig {
+  /** XYOps server base URL */
+  baseUrl: string;
+  /** API key for authentication */
+  apiKey?: string;
+  /** Request timeout in ms */
+  timeout?: number;
+}
+
+export interface XYOpsJob {
+  /** Unique job ID */
+  id: string;
+  /** Job title */
+  title: string;
+  /** Job category */
+  category: string;
+  /** Plugin to execute */
+  plugin: string;
+  /** Plugin parameters */
+  params: Record<string, unknown>;
+  /** Whether job is enabled */
+  enabled: boolean;
+  /** Creation timestamp */
+  created: number;
+  /** Last modified timestamp */
+  modified: number;
+}
+
+export interface XYOpsSchedule {
+  /** Unique schedule ID */
+  id: string;
+  /** Associated job ID */
+  jobId: string;
+  /** Cron expression */
+  cron: string;
+  /** Whether schedule is enabled */
+  enabled: boolean;
+  /** Creation timestamp */
+  created: number;
+}
+
+export interface XYOpsEvent {
+  /** Unique event ID */
+  id: string;
+  /** Associated job ID */
+  jobId: string;
+  /** Event status */
+  status: "pending" | "running" | "success" | "error" | "aborted";
+  /** Start timestamp */
+  startTime: number;
+  /** End timestamp (if completed) */
+  endTime?: number;
+  /** Event output/log */
+  output?: string;
+  /** Error message (if failed) */
+  error?: string;
+}
+
+export interface XYOpsPlugin {
+  /** Plugin name */
+  name: string;
+  /** Plugin title */
+  title: string;
+  /** Plugin description */
+  description?: string;
+  /** Parameter schema */
+  params?: Record<string, unknown>;
+}
+
+export interface XYOpsStatus {
+  /** Server version */
+  version: string;
+  /** Server uptime in seconds */
+  uptime: number;
+  /** Number of configured jobs */
+  jobCount: number;
+  /** Number of active schedules */
+  scheduleCount: number;
+  /** Currently running events */
+  activeEvents: number;
+}
+
+// Tool parameter types
+export interface ListJobsParams {
+  offset?: number;
+  limit?: number;
+}
+
+export interface GetJobParams {
+  jobId: string;
+}
+
+export interface CreateJobParams {
+  title: string;
+  category: string;
+  plugin: string;
+  params?: Record<string, unknown>;
+  enabled?: boolean;
+}
+
+export interface UpdateJobParams {
+  jobId: string;
+  title?: string;
+  category?: string;
+  plugin?: string;
+  params?: Record<string, unknown>;
+  enabled?: boolean;
+}
+
+export interface DeleteJobParams {
+  jobId: string;
+}
+
+export interface RunJobParams {
+  jobId: string;
+  params?: Record<string, unknown>;
+}
+
+export interface ListSchedulesParams {
+  jobId?: string;
+}
+
+export interface CreateScheduleParams {
+  jobId: string;
+  cron: string;
+  enabled?: boolean;
+}
+
+export interface DeleteScheduleParams {
+  scheduleId: string;
+}
+
+export interface ListEventsParams {
+  jobId?: string;
+  limit?: number;
+  offset?: number;
+}
+
+export interface GetEventParams {
+  eventId: string;
+}
+
+export interface AbortEventParams {
+  eventId: string;
+}

package/extensions/xyops/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+  },
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poolzin/pool-bot",
-  "version": "2026.3.11",
+  "version": "2026.3.14",
   "description": "🎱 Pool Bot - AI assistant with PLCODE integrations",
   "keywords": [],
   "license": "MIT",

package/extensions/mavalie/README.md

@@ -1,97 +0,0 @@
-# Mavalie Plugin for PoolBot
-
-Plugin template válido para PoolBot.
-
-## Estrutura
-
-```
-extensions/mavalie/
-├── package.json          # Manifest do plugin
-├── src/
-│   └── index.ts         # Entry point
-└── README.md            # Esta documentação
-```
-
-## Instalação
-
-1. **Build do plugin:**
-   ```bash
-   cd extensions/mavalie
-   npm install
-   npm run build  # ou pnpm build
-   ```
-
-2. **Ativação no PoolBot:**
-   O plugin é carregado automaticamente pelo PoolBot quando:
-   - O diretório está em `extensions/mavalie/`
-   - O `package.json` tem a seção `poolbot.extensions` configurada
-   - O entry point (`dist/index.js`) existe
-
-## Configuração
-
-O plugin usa `emptyPluginConfigSchema()`, ou seja, não requer configuração.
-
-Para adicionar configurações, substitua por:
-
-```typescript
-import { z } from "zod";
-
-const configSchema = z.object({
-  apiKey: z.string().optional(),
-  endpoint: z.string().url().default("https://api.mavalie.com"),
-});
-```
-
-## Desenvolvimento
-
-### Padrões de Plugin
-
-O PoolBot suporta 4 tipos de extensões:
-
-1. **Provider** - Adiciona novos modelos LLM
-2. **Channel** - Adiciona canais de comunicação (Discord, Slack, etc)
-3. **Tool** - Adiciona ferramentas para agentes
-4. **Hook** - Intercepta eventos do ciclo de vida
-
-### Exemplo: Registrando um Provider
-
-```typescript
-api.registerProvider({
-  id: "mavalie",
-  label: "Mavalie AI",
-  auth: [{
-    id: "api-key",
-    kind: "apiKey",
-    run: async (ctx) => {
-      const key = await ctx.prompter.password({
-        message: "Mavalie API Key:"
-      });
-      return {
-        profiles: [{
-          profileId: "mavalie:default",
-          credential: { type: "apiKey", key: String(key) }
-        }]
-      };
-    }
-  }]
-});
-```
-
-## Troubleshooting
-
-### "plugin manifest not found"
-- Verifique se `package.json` existe e tem `poolbot.extensions`
-- Verifique se o caminho em `extensions` aponta para o arquivo correto
-
-### "extension entry escapes package directory"
-- O entry point deve estar dentro do diretório do plugin
-- Use `./dist/index.js` (não `./src/index.ts` para produção)
-
-### Erros de TypeScript "Cannot find module 'poolbot/plugin-sdk'"
-- Normal durante desenvolvimento - o alias só resolve após build
-- O build do PoolBot principal resolve essas dependências
-
-## Referências
-
-- [Plugin SDK Documentation](../../docs/refactor/plugin-sdk.md)
-- [Exemplos de Plugins](../discord/, ../slack/, etc.)

package/extensions/mavalie/package.json

@@ -1,15 +0,0 @@
-{
-  "name": "@poolbot/mavalie",
-  "version": "2026.3.11",
-  "type": "module",
-  "description": "Mavalie plugin for PoolBot - custom integration",
-  "poolbot": {
-    "extensions": [
-      "./src/index.ts"
-    ]
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "poolbot": "workspace:*"
-  }
-}

package/extensions/mavalie/src/index.ts

@@ -1,62 +0,0 @@
-import { emptyPluginConfigSchema } from "poolbot/plugin-sdk";
-
-/**
- * Mavalie Plugin for PoolBot
- * 
- * Template mínimo válido de plugin para PoolBot.
- * Este plugin registra um provider customizado que pode ser expandido
- * conforme necessidades específicas.
- */
-
-const mavaliePlugin = {
-  id: "mavalie",
-  name: "Mavalie",
-  description: "Custom Mavalie integration for PoolBot",
-  configSchema: emptyPluginConfigSchema(),
-  
-  register(api) {
-    // Log de registro do plugin
-    api.runtime?.log?.("Mavalie plugin registered");
-    
-    // TODO: Adicione aqui o registro de:
-    // - Providers (modelos customizados)
-    // - Canais (integrações de mensageria)
-    // - Ferramentas (tools para agentes)
-    // - Hooks (eventos do ciclo de vida)
-    
-    // Exemplo de registro de provider (descomente e adapte):
-    /*
-    api.registerProvider({
-      id: "mavalie",
-      label: "Mavalie Provider",
-      docsPath: "/providers/models",
-      auth: [
-        {
-          id: "api-key",
-          label: "API Key",
-          kind: "apiKey",
-          run: async (ctx) => {
-            const key = await ctx.prompter.password({
-              message: "Enter your Mavalie API key:",
-            });
-            return {
-              profiles: [
-                {
-                  profileId: "mavalie:default",
-                  credential: {
-                    type: "apiKey",
-                    provider: "mavalie",
-                    key: String(key),
-                  },
-                },
-              ],
-            };
-          },
-        },
-      ],
-    });
-    */
-  },
-};
-
-export default mavaliePlugin;