@sparkleideas/swarm 3.0.0-alpha.7

package/src/workers/index.ts

@@ -0,0 +1,65 @@
+/**
+ * @sparkleideas/swarm/workers
+ * Worker Dispatch Module (@sparkleideas/agentic-flow@alpha compatible)
+ *
+ * Provides background worker functionality with 12 trigger types
+ * for analysis, optimization, and automation tasks.
+ *
+ * Triggers:
+ * - ultralearn: Deep pattern learning
+ * - optimize: Code/performance optimization
+ * - consolidate: Memory consolidation
+ * - predict: Predictive analysis
+ * - audit: Security/quality audit
+ * - map: Codebase mapping
+ * - preload: Context preloading
+ * - deepdive: Deep code analysis
+ * - document: Documentation generation
+ * - refactor: Code refactoring suggestions
+ * - benchmark: Performance benchmarking
+ * - testgaps: Test coverage analysis
+ *
+ * @module @sparkleideas/swarm/workers
+ * @version 3.0.0-alpha.1
+ */
+
+export {
+  WorkerDispatchService,
+  getWorkerDispatchService,
+  createWorkerDispatchService,
+  type WorkerTrigger,
+  type WorkerStatus,
+  type WorkerConfig,
+  type WorkerInstance,
+  type WorkerResult,
+  type WorkerMetrics,
+  type WorkerArtifact,
+  type DispatchOptions,
+  type TriggerDetectionResult,
+} from './worker-dispatch.js';
+
+// Re-export trigger types for convenience
+export const WORKER_TRIGGERS = [
+  'ultralearn',
+  'optimize',
+  'consolidate',
+  'predict',
+  'audit',
+  'map',
+  'preload',
+  'deepdive',
+  'document',
+  'refactor',
+  'benchmark',
+  'testgaps',
+] as const;
+
+export const WORKER_PRIORITIES = ['low', 'normal', 'high', 'critical'] as const;
+
+export const WORKER_STATUSES = [
+  'pending',
+  'running',
+  'completed',
+  'failed',
+  'cancelled',
+] as const;

package/src/workers/worker-dispatch.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Worker Dispatch Service
+ *
+ * Implements the 12 background worker triggers from @sparkleideas/agentic-flow@alpha:
+ * - ultralearn: Deep knowledge acquisition
+ * - optimize: Performance optimization
+ * - consolidate: Memory consolidation
+ * - predict: Predictive preloading
+ * - audit: Security analysis
+ * - map: Codebase mapping
+ * - preload: Resource preloading
+ * - deepdive: Deep code analysis
+ * - document: Auto-documentation
+ * - refactor: Refactoring suggestions
+ * - benchmark: Performance benchmarks
+ * - testgaps: Test coverage analysis
+ *
+ * Performance Targets:
+ * - Trigger Detection: <5ms
+ * - Worker Spawn: <50ms
+ * - Max Concurrent: 10 workers (configurable)
+ *
+ * @module v3/swarm/workers/worker-dispatch
+ */
+import { EventEmitter } from 'events';
+/**
+ * Worker trigger types (matching @sparkleideas/agentic-flow@alpha)
+ */
+export type WorkerTrigger = 'ultralearn' | 'optimize' | 'consolidate' | 'predict' | 'audit' | 'map' | 'preload' | 'deepdive' | 'document' | 'refactor' | 'benchmark' | 'testgaps';
+/**
+ * Worker status
+ */
+export type WorkerStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+/**
+ * Worker configuration
+ */
+export interface WorkerConfig {
+    /** Maximum concurrent workers */
+    maxConcurrent: number;
+    /** Default timeout in milliseconds */
+    defaultTimeout: number;
+    /** Memory limit per worker in MB */
+    memoryLimit: number;
+    /** Enable auto-dispatch based on context */
+    autoDispatch: boolean;
+    /** Priority queue for workers */
+    priorityQueue: boolean;
+}
+/**
+ * Worker instance
+ */
+export interface WorkerInstance {
+    id: string;
+    trigger: WorkerTrigger;
+    context: string;
+    sessionId: string;
+    status: WorkerStatus;
+    progress: number;
+    phase: string;
+    startedAt: Date;
+    completedAt?: Date;
+    result?: WorkerResult;
+    error?: Error;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Worker result
+ */
+export interface WorkerResult {
+    success: boolean;
+    data?: unknown;
+    artifacts?: WorkerArtifact[];
+    metrics?: WorkerMetrics;
+    summary?: string;
+}
+/**
+ * Worker artifact
+ */
+export interface WorkerArtifact {
+    type: 'file' | 'data' | 'report' | 'suggestion';
+    name: string;
+    content: string | Buffer | Record<string, unknown>;
+    size?: number;
+}
+/**
+ * Worker metrics
+ */
+export interface WorkerMetrics {
+    duration: number;
+    tokensUsed?: number;
+    filesProcessed?: number;
+    itemsAnalyzed?: number;
+    memoryUsed?: number;
+}
+/**
+ * Trigger detection result
+ */
+export interface TriggerDetectionResult {
+    detected: boolean;
+    triggers: WorkerTrigger[];
+    confidence: number;
+    context?: string;
+}
+/**
+ * Worker dispatch options
+ */
+export interface DispatchOptions {
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    timeout?: number;
+    context?: Record<string, unknown>;
+    callback?: (worker: WorkerInstance) => void;
+}
+/**
+ * Trigger configurations
+ */
+declare const TRIGGER_CONFIGS: Record<WorkerTrigger, {
+    description: string;
+    priority: 'low' | 'normal' | 'high' | 'critical';
+    estimatedDuration: number;
+    capabilities: string[];
+}>;
+/**
+ * Worker Dispatch Service
+ *
+ * Manages background workers for various analysis and optimization tasks.
+ */
+export declare class WorkerDispatchService extends EventEmitter {
+    private config;
+    private workers;
+    private queue;
+    private running;
+    private idCounter;
+    constructor(config?: Partial<WorkerConfig>);
+    /**
+     * Dispatch a worker for the given trigger
+     *
+     * @param trigger - Worker trigger type
+     * @param context - Context string (e.g., file path, topic)
+     * @param sessionId - Session identifier
+     * @param options - Dispatch options
+     * @returns Worker ID
+     */
+    dispatch(trigger: WorkerTrigger, context: string, sessionId: string, options?: DispatchOptions): Promise<string>;
+    /**
+     * Detect triggers in a prompt/context
+     *
+     * @param text - Text to analyze
+     * @returns Detection result
+     */
+    detectTriggers(text: string): TriggerDetectionResult;
+    /**
+     * Get worker status
+     *
+     * @param workerId - Worker ID
+     * @returns Worker instance or undefined
+     */
+    getWorker(workerId: string): WorkerInstance | undefined;
+    /**
+     * Get all workers for a session
+     *
+     * @param sessionId - Session ID
+     * @returns Worker instances
+     */
+    getSessionWorkers(sessionId: string): WorkerInstance[];
+    /**
+     * Cancel a worker
+     *
+     * @param workerId - Worker ID
+     * @returns Success status
+     */
+    cancel(workerId: string): Promise<boolean>;
+    /**
+     * Get available triggers
+     *
+     * @returns Trigger configurations
+     */
+    getTriggers(): typeof TRIGGER_CONFIGS;
+    /**
+     * Get worker statistics
+     */
+    getStats(): {
+        total: number;
+        pending: number;
+        running: number;
+        completed: number;
+        failed: number;
+        cancelled: number;
+    };
+    /**
+     * Get context for prompt injection
+     *
+     * @param sessionId - Session ID
+     * @returns Context string for injection
+     */
+    getContextForInjection(sessionId: string): string;
+    /**
+     * Process the worker queue
+     */
+    private processQueue;
+    /**
+     * Execute a worker
+     */
+    private executeWorker;
+    /**
+     * Execute worker based on trigger type
+     */
+    private executeWorkerByTrigger;
+    private executeUltralearn;
+    private executeOptimize;
+    private executeConsolidate;
+    private executePredict;
+    private executeAudit;
+    private executeMap;
+    private executePreload;
+    private executeDeepdive;
+    private executeDocument;
+    private executeRefactor;
+    private executeBenchmark;
+    private executeTestgaps;
+    private generateWorkerId;
+    private getPriorityValue;
+    private updateProgress;
+    private processWorkPhase;
+}
+/**
+ * Get the worker dispatch service singleton
+ */
+export declare function getWorkerDispatchService(config?: Partial<WorkerConfig>): WorkerDispatchService;
+/**
+ * Create a new worker dispatch service
+ */
+export declare function createWorkerDispatchService(config?: Partial<WorkerConfig>): WorkerDispatchService;
+export default WorkerDispatchService;
+//# sourceMappingURL=worker-dispatch.d.ts.map

package/src/workers/worker-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-dispatch.d.ts","sourceRoot":"","sources":["worker-dispatch.ts"],"names":[],"mappings":"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"}