claude-flow-novice 1.6.1 → 1.6.2

package/.claude-flow-novice/dist/src/coordination/v2/messaging/channels/dependency-channel.js

@@ -0,0 +1,355 @@
+/**
+ * Agent Coordination V2 - Dependency Channel
+ *
+ * Specialized channel for dependency request and resolution messages.
+ * Integrates with Phase 2 dependency graph to coordinate task dependencies
+ * across agents.
+ *
+ * @module coordination/v2/messaging/channels/dependency-channel
+ */ import { DependencyNodeStatus } from '../../core/dependency-node.js';
+import { MessagePriority } from '../../core/message.js';
+/**
+ * Dependency channel validation error.
+ */ export class DependencyChannelError extends Error {
+    constructor(message){
+        super(message);
+        this.name = 'DependencyChannelError';
+    }
+}
+/**
+ * Dependency Channel Implementation.
+ *
+ * Specialized messaging channel for dependency coordination with:
+ * - Type-safe dependency request/resolution payloads
+ * - Integration with Phase 2 dependency graph
+ * - Request/reply pattern for dependency resolution
+ * - Automatic priority assignment based on dependency criticality
+ * - Timeout handling for dependency requests
+ *
+ * @example
+ * ```typescript
+ * const depChannel = new DependencyChannel(messageBroker);
+ *
+ * // Request dependency resolution
+ * await depChannel.publishDependencyRequest({
+ *   requesterId: 'agent-1',
+ *   taskId: 'task-2',
+ *   dependencyId: 'task-1',
+ *   timeout: 30000
+ * });
+ *
+ * // Publish dependency resolution
+ * await depChannel.publishDependencyResolution({
+ *   dependencyId: 'task-1',
+ *   providerId: 'agent-0',
+ *   status: DependencyNodeStatus.COMPLETED,
+ *   result: { data: 'completed' }
+ * });
+ * ```
+ */ export class DependencyChannel {
+    /** Base topic for all dependency messages */ static BASE_TOPIC = 'dependency';
+    /** Topic for dependency requests */ static REQUEST_TOPIC = 'dependency.request';
+    /** Topic for dependency resolutions */ static RESOLUTION_TOPIC = 'dependency.resolution';
+    /** Topic for dependency failures */ static FAILURE_TOPIC = 'dependency.failure';
+    broker;
+    /**
+   * Creates a new dependency channel instance.
+   *
+   * @param broker - Message broker for publishing/subscribing
+   */ constructor(broker){
+        if (!broker) {
+            throw new DependencyChannelError('Message broker is required');
+        }
+        this.broker = broker;
+    }
+    // ============================================
+    // Publishing - Dependency Requests
+    // ============================================
+    /**
+   * Publishes a dependency request.
+   *
+   * @param config - Dependency request configuration
+   * @returns Promise resolving to published message
+   * @throws {DependencyChannelError} If validation fails
+   *
+   * @example
+   * ```typescript
+   * await depChannel.publishDependencyRequest({
+   *   requesterId: 'agent-1',
+   *   taskId: 'task-2',
+   *   dependencyId: 'task-1',
+   *   timeout: 30000
+   * });
+   * ```
+   */ async publishDependencyRequest(config) {
+        this.validateDependencyRequest(config);
+        const payload = {
+            requesterId: config.requesterId,
+            taskId: config.taskId,
+            dependencyId: config.dependencyId,
+            timeout: config.timeout,
+            timestamp: Date.now(),
+            metadata: config.metadata
+        };
+        const topic = `${DependencyChannel.REQUEST_TOPIC}.${config.dependencyId}`;
+        const messageConfig = {
+            topic,
+            payload,
+            priority: MessagePriority.NORMAL,
+            senderId: config.requesterId,
+            metadata: {
+                channel: 'dependency',
+                type: 'request',
+                dependencyId: config.dependencyId
+            }
+        };
+        return this.broker.publish(messageConfig);
+    }
+    // ============================================
+    // Publishing - Dependency Resolutions
+    // ============================================
+    /**
+   * Publishes a dependency resolution.
+   *
+   * @param config - Dependency resolution configuration
+   * @returns Promise resolving to published message
+   * @throws {DependencyChannelError} If validation fails
+   *
+   * @example
+   * ```typescript
+   * await depChannel.publishDependencyResolution({
+   *   dependencyId: 'task-1',
+   *   providerId: 'agent-0',
+   *   status: DependencyNodeStatus.COMPLETED,
+   *   result: { output: 'success' }
+   * });
+   * ```
+   */ async publishDependencyResolution(config) {
+        this.validateDependencyResolution(config);
+        const payload = {
+            dependencyId: config.dependencyId,
+            providerId: config.providerId,
+            status: config.status,
+            result: config.result,
+            timestamp: Date.now(),
+            metadata: config.metadata
+        };
+        const topic = `${DependencyChannel.RESOLUTION_TOPIC}.${config.dependencyId}`;
+        const messageConfig = {
+            topic,
+            payload,
+            priority: MessagePriority.HIGH,
+            senderId: config.providerId,
+            metadata: {
+                channel: 'dependency',
+                type: 'resolution',
+                dependencyId: config.dependencyId,
+                status: config.status
+            }
+        };
+        return this.broker.publish(messageConfig);
+    }
+    // ============================================
+    // Publishing - Dependency Failures
+    // ============================================
+    /**
+   * Publishes a dependency failure.
+   *
+   * @param config - Dependency failure configuration
+   * @returns Promise resolving to published message
+   * @throws {DependencyChannelError} If validation fails
+   *
+   * @example
+   * ```typescript
+   * await depChannel.publishDependencyFailure({
+   *   dependencyId: 'task-1',
+   *   taskId: 'task-1',
+   *   reason: 'Execution timeout',
+   *   error: new Error('Task timed out after 60s')
+   * });
+   * ```
+   */ async publishDependencyFailure(config) {
+        this.validateDependencyFailure(config);
+        const payload = {
+            dependencyId: config.dependencyId,
+            taskId: config.taskId,
+            reason: config.reason,
+            error: config.error,
+            timestamp: Date.now(),
+            metadata: config.metadata
+        };
+        const topic = `${DependencyChannel.FAILURE_TOPIC}.${config.dependencyId}`;
+        const messageConfig = {
+            topic,
+            payload,
+            priority: MessagePriority.CRITICAL,
+            metadata: {
+                channel: 'dependency',
+                type: 'failure',
+                dependencyId: config.dependencyId
+            }
+        };
+        return this.broker.publish(messageConfig);
+    }
+    // ============================================
+    // Subscribing
+    // ============================================
+    /**
+   * Subscribes to dependency requests for a specific dependency.
+   *
+   * @param dependencyId - Dependency ID to monitor
+   * @param handler - Callback function for requests
+   * @returns Subscription handle
+   *
+   * @example
+   * ```typescript
+   * const sub = await depChannel.subscribeToDependencyRequests('task-1', async (payload) => {
+   *   console.log(`Dependency requested by ${payload.requesterId}`);
+   * });
+   * ```
+   */ async subscribeToDependencyRequests(dependencyId, handler) {
+        this.validateId(dependencyId, 'Dependency ID');
+        return this.broker.subscribe({
+            topic: `${DependencyChannel.REQUEST_TOPIC}.${dependencyId}`,
+            handler: async (message)=>{
+                await handler(message.payload);
+            }
+        });
+    }
+    /**
+   * Subscribes to all dependency requests.
+   *
+   * @param handler - Callback function for requests
+   * @returns Subscription handle
+   */ async subscribeToAllRequests(handler) {
+        return this.broker.subscribe({
+            topic: `${DependencyChannel.REQUEST_TOPIC}.*`,
+            handler: async (message)=>{
+                await handler(message.payload);
+            }
+        });
+    }
+    /**
+   * Subscribes to dependency resolutions for a specific dependency.
+   *
+   * @param dependencyId - Dependency ID to monitor
+   * @param handler - Callback function for resolutions
+   * @returns Subscription handle
+   *
+   * @example
+   * ```typescript
+   * const sub = await depChannel.subscribeToDependencyResolutions('task-1', async (payload) => {
+   *   console.log(`Dependency resolved with status: ${payload.status}`);
+   * });
+   * ```
+   */ async subscribeToDependencyResolutions(dependencyId, handler) {
+        this.validateId(dependencyId, 'Dependency ID');
+        return this.broker.subscribe({
+            topic: `${DependencyChannel.RESOLUTION_TOPIC}.${dependencyId}`,
+            handler: async (message)=>{
+                await handler(message.payload);
+            }
+        });
+    }
+    /**
+   * Subscribes to all dependency resolutions.
+   *
+   * @param handler - Callback function for resolutions
+   * @returns Subscription handle
+   */ async subscribeToAllResolutions(handler) {
+        return this.broker.subscribe({
+            topic: `${DependencyChannel.RESOLUTION_TOPIC}.*`,
+            handler: async (message)=>{
+                await handler(message.payload);
+            }
+        });
+    }
+    /**
+   * Subscribes to dependency failures.
+   *
+   * @param handler - Callback function for failures
+   * @returns Subscription handle
+   *
+   * @example
+   * ```typescript
+   * const sub = await depChannel.subscribeToFailures(async (payload) => {
+   *   console.error(`Dependency ${payload.dependencyId} failed: ${payload.reason}`);
+   * });
+   * ```
+   */ async subscribeToFailures(handler) {
+        return this.broker.subscribe({
+            topic: `${DependencyChannel.FAILURE_TOPIC}.*`,
+            handler: async (message)=>{
+                await handler(message.payload);
+            }
+        });
+    }
+    // ============================================
+    // Validation
+    // ============================================
+    /**
+   * Validates dependency request configuration.
+   */ validateDependencyRequest(config) {
+        this.validateId(config.requesterId, 'Requester ID');
+        this.validateId(config.taskId, 'Task ID');
+        this.validateId(config.dependencyId, 'Dependency ID');
+        if (config.timeout !== undefined) {
+            if (typeof config.timeout !== 'number' || config.timeout <= 0) {
+                throw new DependencyChannelError('Timeout must be a positive number');
+            }
+        }
+    }
+    /**
+   * Validates dependency resolution configuration.
+   */ validateDependencyResolution(config) {
+        this.validateId(config.dependencyId, 'Dependency ID');
+        this.validateId(config.providerId, 'Provider ID');
+        if (!Object.values(DependencyNodeStatus).includes(config.status)) {
+            throw new DependencyChannelError(`Invalid status: ${config.status}`);
+        }
+    }
+    /**
+   * Validates dependency failure configuration.
+   */ validateDependencyFailure(config) {
+        this.validateId(config.dependencyId, 'Dependency ID');
+        this.validateId(config.taskId, 'Task ID');
+        if (!config.reason || typeof config.reason !== 'string') {
+            throw new DependencyChannelError('Failure reason must be a non-empty string');
+        }
+    }
+    /**
+   * Validates an ID field.
+   */ validateId(id, fieldName) {
+        if (!id || typeof id !== 'string') {
+            throw new DependencyChannelError(`${fieldName} must be a non-empty string`);
+        }
+        if (id.length > 256) {
+            throw new DependencyChannelError(`${fieldName} exceeds 256 characters`);
+        }
+    }
+    // ============================================
+    // Utility Methods
+    // ============================================
+    /**
+   * Gets the base topic for all dependency messages.
+   */ static getBaseTopic() {
+        return DependencyChannel.BASE_TOPIC;
+    }
+    /**
+   * Gets the topic for dependency requests.
+   */ static getRequestTopic() {
+        return DependencyChannel.REQUEST_TOPIC;
+    }
+    /**
+   * Gets the topic for dependency resolutions.
+   */ static getResolutionTopic() {
+        return DependencyChannel.RESOLUTION_TOPIC;
+    }
+    /**
+   * Gets the topic for dependency failures.
+   */ static getFailureTopic() {
+        return DependencyChannel.FAILURE_TOPIC;
+    }
+}
+
+//# sourceMappingURL=dependency-channel.js.map

package/.claude-flow-novice/dist/src/coordination/v2/messaging/channels/dependency-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../src/coordination/v2/messaging/channels/dependency-channel.ts"],"names":["DependencyNodeStatus","MessagePriority","DependencyChannelError","Error","message","name","DependencyChannel","BASE_TOPIC","REQUEST_TOPIC","RESOLUTION_TOPIC","FAILURE_TOPIC","broker","publishDependencyRequest","config","validateDependencyRequest","payload","requesterId","taskId","dependencyId","timeout","timestamp","Date","now","metadata","topic","messageConfig","priority","NORMAL","senderId","channel","type","publish","publishDependencyResolution","validateDependencyResolution","providerId","status","result","HIGH","publishDependencyFailure","validateDependencyFailure","reason","error","CRITICAL","subscribeToDependencyRequests","handler","validateId","subscribe","subscribeToAllRequests","subscribeToDependencyResolutions","subscribeToAllResolutions","subscribeToFailures","undefined","Object","values","includes","id","fieldName","length","getBaseTopic","getRequestTopic","getResolutionTopic","getFailureTopic"],"mappings":"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"}