@sparkleideas/swarm 3.0.0-alpha.7

package/src/domain/entities/task.js

@@ -0,0 +1,261 @@
+/**
+ * Task Entity - Domain Layer
+ *
+ * Core domain entity representing a task in the swarm.
+ * Tasks are units of work assigned to agents.
+ *
+ * @module v3/swarm/domain/entities
+ */
+import { randomUUID } from 'crypto';
+/**
+ * Task - Entity
+ *
+ * Represents a unit of work with lifecycle management,
+ * dependency tracking, and result storage.
+ */
+export class Task {
+    _id;
+    _title;
+    _description;
+    _type;
+    _priority;
+    _status;
+    _assignedAgentId;
+    _dependencies;
+    _metadata;
+    _input;
+    _output;
+    _error;
+    _retryCount;
+    _maxRetries;
+    _timeout;
+    _createdAt;
+    _startedAt;
+    _completedAt;
+    constructor(props) {
+        const now = new Date();
+        this._id = props.id ?? randomUUID();
+        this._title = props.title;
+        this._description = props.description;
+        this._type = props.type;
+        this._priority = props.priority ?? 'normal';
+        this._status = props.status ?? 'pending';
+        this._assignedAgentId = props.assignedAgentId;
+        this._dependencies = new Set(props.dependencies ?? []);
+        this._metadata = props.metadata ?? {};
+        this._input = props.input;
+        this._output = props.output;
+        this._error = props.error;
+        this._retryCount = props.retryCount ?? 0;
+        this._maxRetries = props.maxRetries ?? 3;
+        this._timeout = props.timeout ?? 300000; // 5 minutes default
+        this._createdAt = props.createdAt ?? now;
+        this._startedAt = props.startedAt;
+        this._completedAt = props.completedAt;
+    }
+    static create(props) {
+        return new Task(props);
+    }
+    static fromPersistence(props) {
+        return new Task(props);
+    }
+    // Getters
+    get id() {
+        return this._id;
+    }
+    get title() {
+        return this._title;
+    }
+    get description() {
+        return this._description;
+    }
+    get type() {
+        return this._type;
+    }
+    get priority() {
+        return this._priority;
+    }
+    get status() {
+        return this._status;
+    }
+    get assignedAgentId() {
+        return this._assignedAgentId;
+    }
+    get dependencies() {
+        return Array.from(this._dependencies);
+    }
+    get metadata() {
+        return { ...this._metadata };
+    }
+    get input() {
+        return this._input;
+    }
+    get output() {
+        return this._output;
+    }
+    get error() {
+        return this._error;
+    }
+    get retryCount() {
+        return this._retryCount;
+    }
+    get maxRetries() {
+        return this._maxRetries;
+    }
+    get timeout() {
+        return this._timeout;
+    }
+    get createdAt() {
+        return new Date(this._createdAt);
+    }
+    get startedAt() {
+        return this._startedAt ? new Date(this._startedAt) : undefined;
+    }
+    get completedAt() {
+        return this._completedAt ? new Date(this._completedAt) : undefined;
+    }
+    // ============================================================================
+    // Business Logic
+    // ============================================================================
+    /**
+     * Queue the task for execution
+     */
+    queue() {
+        if (this._status !== 'pending') {
+            throw new Error('Can only queue pending tasks');
+        }
+        this._status = 'queued';
+    }
+    /**
+     * Assign task to an agent
+     */
+    assign(agentId) {
+        if (this._status !== 'queued' && this._status !== 'pending') {
+            throw new Error('Can only assign queued or pending tasks');
+        }
+        this._assignedAgentId = agentId;
+        this._status = 'assigned';
+    }
+    /**
+     * Start task execution
+     */
+    start() {
+        if (this._status !== 'assigned') {
+            throw new Error('Can only start assigned tasks');
+        }
+        this._status = 'running';
+        this._startedAt = new Date();
+    }
+    /**
+     * Complete the task successfully
+     */
+    complete(output) {
+        if (this._status !== 'running') {
+            throw new Error('Can only complete running tasks');
+        }
+        this._status = 'completed';
+        this._output = output;
+        this._completedAt = new Date();
+    }
+    /**
+     * Mark task as failed
+     */
+    fail(error) {
+        if (this._status !== 'running' && this._status !== 'assigned') {
+            throw new Error('Can only fail running or assigned tasks');
+        }
+        this._error = error;
+        this._retryCount++;
+        if (this._retryCount >= this._maxRetries) {
+            this._status = 'failed';
+            this._completedAt = new Date();
+        }
+        else {
+            // Reset for retry
+            this._status = 'queued';
+            this._assignedAgentId = undefined;
+        }
+    }
+    /**
+     * Cancel the task
+     */
+    cancel() {
+        if (this._status === 'completed' || this._status === 'failed') {
+            throw new Error('Cannot cancel finished tasks');
+        }
+        this._status = 'cancelled';
+        this._completedAt = new Date();
+    }
+    /**
+     * Check if all dependencies are satisfied
+     */
+    areDependenciesSatisfied(completedTaskIds) {
+        for (const depId of this._dependencies) {
+            if (!completedTaskIds.has(depId)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Check if task can be retried
+     */
+    canRetry() {
+        return this._retryCount < this._maxRetries;
+    }
+    /**
+     * Get execution duration in milliseconds
+     */
+    getExecutionDuration() {
+        if (!this._startedAt)
+            return null;
+        const endTime = this._completedAt ?? new Date();
+        return endTime.getTime() - this._startedAt.getTime();
+    }
+    /**
+     * Check if task is timed out
+     */
+    isTimedOut() {
+        if (this._status !== 'running' || !this._startedAt)
+            return false;
+        return Date.now() - this._startedAt.getTime() > this._timeout;
+    }
+    /**
+     * Priority comparison (for sorting)
+     */
+    comparePriority(other) {
+        const priorityOrder = {
+            critical: 0,
+            high: 1,
+            normal: 2,
+            low: 3,
+        };
+        return priorityOrder[this._priority] - priorityOrder[other.priority];
+    }
+    toPersistence() {
+        return {
+            id: this._id,
+            title: this._title,
+            description: this._description,
+            type: this._type,
+            priority: this._priority,
+            status: this._status,
+            assignedAgentId: this._assignedAgentId,
+            dependencies: Array.from(this._dependencies),
+            metadata: this._metadata,
+            input: this._input,
+            output: this._output,
+            error: this._error,
+            retryCount: this._retryCount,
+            maxRetries: this._maxRetries,
+            timeout: this._timeout,
+            createdAt: this._createdAt.toISOString(),
+            startedAt: this._startedAt?.toISOString(),
+            completedAt: this._completedAt?.toISOString(),
+        };
+    }
+    toJSON() {
+        return this.toPersistence();
+    }
+}
+//# sourceMappingURL=task.js.map

package/src/domain/entities/task.js.map

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

package/src/domain/entities/task.ts

@@ -0,0 +1,319 @@
+/**
+ * Task Entity - Domain Layer
+ *
+ * Core domain entity representing a task in the swarm.
+ * Tasks are units of work assigned to agents.
+ *
+ * @module v3/swarm/domain/entities
+ */
+
+import { randomUUID } from 'crypto';
+
+/**
+ * Task status types
+ */
+export type TaskStatus =
+  | 'pending'
+  | 'queued'
+  | 'assigned'
+  | 'running'
+  | 'completed'
+  | 'failed'
+  | 'cancelled';
+
+/**
+ * Task priority levels
+ */
+export type TaskPriority = 'critical' | 'high' | 'normal' | 'low';
+
+/**
+ * Task properties
+ */
+export interface TaskProps {
+  id?: string;
+  title: string;
+  description: string;
+  type: string;
+  priority?: TaskPriority;
+  status?: TaskStatus;
+  assignedAgentId?: string;
+  dependencies?: string[];
+  metadata?: Record<string, unknown>;
+  input?: unknown;
+  output?: unknown;
+  error?: string;
+  retryCount?: number;
+  maxRetries?: number;
+  timeout?: number;
+  createdAt?: Date;
+  startedAt?: Date;
+  completedAt?: Date;
+}
+
+/**
+ * Task - Entity
+ *
+ * Represents a unit of work with lifecycle management,
+ * dependency tracking, and result storage.
+ */
+export class Task {
+  private _id: string;
+  private _title: string;
+  private _description: string;
+  private _type: string;
+  private _priority: TaskPriority;
+  private _status: TaskStatus;
+  private _assignedAgentId?: string;
+  private _dependencies: Set<string>;
+  private _metadata: Record<string, unknown>;
+  private _input?: unknown;
+  private _output?: unknown;
+  private _error?: string;
+  private _retryCount: number;
+  private _maxRetries: number;
+  private _timeout: number;
+  private _createdAt: Date;
+  private _startedAt?: Date;
+  private _completedAt?: Date;
+
+  private constructor(props: TaskProps) {
+    const now = new Date();
+    this._id = props.id ?? randomUUID();
+    this._title = props.title;
+    this._description = props.description;
+    this._type = props.type;
+    this._priority = props.priority ?? 'normal';
+    this._status = props.status ?? 'pending';
+    this._assignedAgentId = props.assignedAgentId;
+    this._dependencies = new Set(props.dependencies ?? []);
+    this._metadata = props.metadata ?? {};
+    this._input = props.input;
+    this._output = props.output;
+    this._error = props.error;
+    this._retryCount = props.retryCount ?? 0;
+    this._maxRetries = props.maxRetries ?? 3;
+    this._timeout = props.timeout ?? 300000; // 5 minutes default
+    this._createdAt = props.createdAt ?? now;
+    this._startedAt = props.startedAt;
+    this._completedAt = props.completedAt;
+  }
+
+  static create(props: TaskProps): Task {
+    return new Task(props);
+  }
+
+  static fromPersistence(props: TaskProps): Task {
+    return new Task(props);
+  }
+
+  // Getters
+  get id(): string {
+    return this._id;
+  }
+  get title(): string {
+    return this._title;
+  }
+  get description(): string {
+    return this._description;
+  }
+  get type(): string {
+    return this._type;
+  }
+  get priority(): TaskPriority {
+    return this._priority;
+  }
+  get status(): TaskStatus {
+    return this._status;
+  }
+  get assignedAgentId(): string | undefined {
+    return this._assignedAgentId;
+  }
+  get dependencies(): string[] {
+    return Array.from(this._dependencies);
+  }
+  get metadata(): Record<string, unknown> {
+    return { ...this._metadata };
+  }
+  get input(): unknown {
+    return this._input;
+  }
+  get output(): unknown {
+    return this._output;
+  }
+  get error(): string | undefined {
+    return this._error;
+  }
+  get retryCount(): number {
+    return this._retryCount;
+  }
+  get maxRetries(): number {
+    return this._maxRetries;
+  }
+  get timeout(): number {
+    return this._timeout;
+  }
+  get createdAt(): Date {
+    return new Date(this._createdAt);
+  }
+  get startedAt(): Date | undefined {
+    return this._startedAt ? new Date(this._startedAt) : undefined;
+  }
+  get completedAt(): Date | undefined {
+    return this._completedAt ? new Date(this._completedAt) : undefined;
+  }
+
+  // ============================================================================
+  // Business Logic
+  // ============================================================================
+
+  /**
+   * Queue the task for execution
+   */
+  queue(): void {
+    if (this._status !== 'pending') {
+      throw new Error('Can only queue pending tasks');
+    }
+    this._status = 'queued';
+  }
+
+  /**
+   * Assign task to an agent
+   */
+  assign(agentId: string): void {
+    if (this._status !== 'queued' && this._status !== 'pending') {
+      throw new Error('Can only assign queued or pending tasks');
+    }
+    this._assignedAgentId = agentId;
+    this._status = 'assigned';
+  }
+
+  /**
+   * Start task execution
+   */
+  start(): void {
+    if (this._status !== 'assigned') {
+      throw new Error('Can only start assigned tasks');
+    }
+    this._status = 'running';
+    this._startedAt = new Date();
+  }
+
+  /**
+   * Complete the task successfully
+   */
+  complete(output?: unknown): void {
+    if (this._status !== 'running') {
+      throw new Error('Can only complete running tasks');
+    }
+    this._status = 'completed';
+    this._output = output;
+    this._completedAt = new Date();
+  }
+
+  /**
+   * Mark task as failed
+   */
+  fail(error: string): void {
+    if (this._status !== 'running' && this._status !== 'assigned') {
+      throw new Error('Can only fail running or assigned tasks');
+    }
+    this._error = error;
+    this._retryCount++;
+
+    if (this._retryCount >= this._maxRetries) {
+      this._status = 'failed';
+      this._completedAt = new Date();
+    } else {
+      // Reset for retry
+      this._status = 'queued';
+      this._assignedAgentId = undefined;
+    }
+  }
+
+  /**
+   * Cancel the task
+   */
+  cancel(): void {
+    if (this._status === 'completed' || this._status === 'failed') {
+      throw new Error('Cannot cancel finished tasks');
+    }
+    this._status = 'cancelled';
+    this._completedAt = new Date();
+  }
+
+  /**
+   * Check if all dependencies are satisfied
+   */
+  areDependenciesSatisfied(completedTaskIds: Set<string>): boolean {
+    for (const depId of this._dependencies) {
+      if (!completedTaskIds.has(depId)) {
+        return false;
+      }
+    }
+    return true;
+  }
+
+  /**
+   * Check if task can be retried
+   */
+  canRetry(): boolean {
+    return this._retryCount < this._maxRetries;
+  }
+
+  /**
+   * Get execution duration in milliseconds
+   */
+  getExecutionDuration(): number | null {
+    if (!this._startedAt) return null;
+    const endTime = this._completedAt ?? new Date();
+    return endTime.getTime() - this._startedAt.getTime();
+  }
+
+  /**
+   * Check if task is timed out
+   */
+  isTimedOut(): boolean {
+    if (this._status !== 'running' || !this._startedAt) return false;
+    return Date.now() - this._startedAt.getTime() > this._timeout;
+  }
+
+  /**
+   * Priority comparison (for sorting)
+   */
+  comparePriority(other: Task): number {
+    const priorityOrder: Record<TaskPriority, number> = {
+      critical: 0,
+      high: 1,
+      normal: 2,
+      low: 3,
+    };
+    return priorityOrder[this._priority] - priorityOrder[other.priority];
+  }
+
+  toPersistence(): Record<string, unknown> {
+    return {
+      id: this._id,
+      title: this._title,
+      description: this._description,
+      type: this._type,
+      priority: this._priority,
+      status: this._status,
+      assignedAgentId: this._assignedAgentId,
+      dependencies: Array.from(this._dependencies),
+      metadata: this._metadata,
+      input: this._input,
+      output: this._output,
+      error: this._error,
+      retryCount: this._retryCount,
+      maxRetries: this._maxRetries,
+      timeout: this._timeout,
+      createdAt: this._createdAt.toISOString(),
+      startedAt: this._startedAt?.toISOString(),
+      completedAt: this._completedAt?.toISOString(),
+    };
+  }
+
+  toJSON(): Record<string, unknown> {
+    return this.toPersistence();
+  }
+}

package/src/domain/index.ts

@@ -0,0 +1,41 @@
+/**
+ * Swarm Domain Layer - Public Exports
+ *
+ * @module v3/swarm/domain
+ */
+
+// Entities
+export {
+  Agent,
+  type AgentStatus,
+  type AgentRole,
+  type AgentProps,
+} from './entities/agent.js';
+
+export {
+  Task,
+  type TaskStatus,
+  type TaskPriority,
+  type TaskProps,
+} from './entities/task.js';
+
+// Repository Interfaces
+export {
+  type IAgentRepository,
+  type AgentQueryOptions,
+  type AgentStatistics,
+} from './repositories/agent-repository.interface.js';
+
+export {
+  type ITaskRepository,
+  type TaskQueryOptions,
+  type TaskStatistics,
+} from './repositories/task-repository.interface.js';
+
+// Domain Services
+export {
+  CoordinationService,
+  type LoadBalancingStrategy,
+  type TaskAssignmentResult,
+  type SwarmHealth,
+} from './services/coordination-service.js';

package/src/domain/repositories/agent-repository.interface.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Agent Repository Interface - Domain Layer
+ *
+ * Defines the contract for agent persistence.
+ *
+ * @module v3/swarm/domain/repositories
+ */
+import { Agent, AgentStatus, AgentRole } from '../entities/agent.js';
+/**
+ * Agent query options
+ */
+export interface AgentQueryOptions {
+    status?: AgentStatus;
+    role?: AgentRole;
+    domain?: string;
+    parentId?: string;
+    capability?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Agent statistics
+ */
+export interface AgentStatistics {
+    total: number;
+    byStatus: Record<AgentStatus, number>;
+    byRole: Record<string, number>;
+    byDomain: Record<string, number>;
+    totalTasksCompleted: number;
+    averageUtilization: number;
+}
+/**
+ * Agent Repository Interface
+ */
+export interface IAgentRepository {
+    save(agent: Agent): Promise<void>;
+    findById(id: string): Promise<Agent | null>;
+    findByName(name: string): Promise<Agent | null>;
+    delete(id: string): Promise<boolean>;
+    exists(id: string): Promise<boolean>;
+    saveMany(agents: Agent[]): Promise<void>;
+    findByIds(ids: string[]): Promise<Agent[]>;
+    deleteMany(ids: string[]): Promise<number>;
+    findAll(options?: AgentQueryOptions): Promise<Agent[]>;
+    findByStatus(status: AgentStatus): Promise<Agent[]>;
+    findByRole(role: AgentRole): Promise<Agent[]>;
+    findByDomain(domain: string): Promise<Agent[]>;
+    findByParent(parentId: string): Promise<Agent[]>;
+    findByCapability(capability: string): Promise<Agent[]>;
+    findAvailable(): Promise<Agent[]>;
+    getStatistics(): Promise<AgentStatistics>;
+    count(options?: AgentQueryOptions): Promise<number>;
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=agent-repository.interface.d.ts.map

package/src/domain/repositories/agent-repository.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-repository.interface.d.ts","sourceRoot":"","sources":["agent-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE/B,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC5C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGrC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAG3C,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACvD,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACpD,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACjD,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACvD,aAAa,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAGlC,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1C,KAAK,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAGpD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/src/domain/repositories/agent-repository.interface.js

@@ -0,0 +1,9 @@
+/**
+ * Agent Repository Interface - Domain Layer
+ *
+ * Defines the contract for agent persistence.
+ *
+ * @module v3/swarm/domain/repositories
+ */
+export {};
+//# sourceMappingURL=agent-repository.interface.js.map