@poolzin/pool-bot 2026.3.13 → 2026.3.15

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.13",
+  "version": "2026.3.15",
   "description": "🎱 Pool Bot - AI assistant with PLCODE integrations",
   "keywords": [],
   "license": "MIT",