@framers/agentos 0.1.0

package/dist/core/agency/AgentCommunicationBus.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @file AgentCommunicationBus.ts
+ * @description Implementation of the AgentOS Agent Communication Bus.
+ * Provides structured messaging between agents within agencies.
+ *
+ * @module AgentOS/Agency
+ * @version 1.0.0
+ */
+import type { ILogger } from '../../logging/ILogger';
+import type { IAgentCommunicationBus, AgentMessage, AgentMessageType, AgentRequest, AgentResponse, HandoffContext, HandoffResult, MessageHandler, Unsubscribe, SubscriptionOptions, MessageTopic, DeliveryStatus, RoutingConfig, BusStatistics } from './IAgentCommunicationBus';
+/**
+ * Configuration for AgentCommunicationBus.
+ */
+export interface AgentCommunicationBusConfig {
+    /** Logger instance */
+    logger?: ILogger;
+    /** Routing configuration */
+    routingConfig?: Partial<RoutingConfig>;
+    /** Maximum messages to keep in history per agent */
+    maxHistoryPerAgent?: number;
+}
+/**
+ * Implementation of the Agent Communication Bus.
+ *
+ * Features:
+ * - Point-to-point messaging between agents
+ * - Broadcast to agencies
+ * - Request-response pattern
+ * - Topic-based pub/sub
+ * - Task handoff protocol
+ * - Message persistence and history
+ * - Delivery tracking and retries
+ *
+ * @implements {IAgentCommunicationBus}
+ */
+export declare class AgentCommunicationBus implements IAgentCommunicationBus {
+    private readonly logger?;
+    private readonly routingConfig;
+    private readonly maxHistoryPerAgent;
+    /** Agent subscriptions */
+    private readonly subscriptions;
+    /** Topic definitions */
+    private readonly topics;
+    /** Topic subscriptions */
+    private readonly topicSubscriptions;
+    /** Message history per agent */
+    private readonly messageHistory;
+    /** Delivery statuses */
+    private readonly deliveryStatuses;
+    /** Pending request-response calls */
+    private readonly pendingRequests;
+    /** Agent to agency mapping for routing */
+    private readonly agentToAgency;
+    /** Agency role mappings */
+    private readonly agencyRoles;
+    /** Statistics */
+    private stats;
+    /**
+     * Creates a new AgentCommunicationBus instance.
+     *
+     * @param config - Bus configuration
+     */
+    constructor(config?: AgentCommunicationBusConfig);
+    /**
+     * Sends a message to a specific agent.
+     */
+    sendToAgent(targetAgentId: string, message: Omit<AgentMessage, 'messageId' | 'toAgentId' | 'sentAt'>): Promise<DeliveryStatus>;
+    /**
+     * Sends a message to an agent by role.
+     */
+    sendToRole(agencyId: string, targetRoleId: string, message: Omit<AgentMessage, 'messageId' | 'toRoleId' | 'sentAt'>): Promise<DeliveryStatus>;
+    /**
+     * Broadcasts a message to all agents in an agency.
+     */
+    broadcast(agencyId: string, message: Omit<AgentMessage, 'messageId' | 'toAgentId' | 'sentAt'>): Promise<DeliveryStatus[]>;
+    /**
+     * Broadcasts to specific roles within an agency.
+     */
+    broadcastToRoles(agencyId: string, roleIds: string[], message: Omit<AgentMessage, 'messageId' | 'sentAt'>): Promise<DeliveryStatus[]>;
+    /**
+     * Sends a request and waits for a response.
+     */
+    requestResponse(targetAgentId: string, request: AgentRequest): Promise<AgentResponse>;
+    /**
+     * Initiates a structured handoff between agents.
+     */
+    handoff(fromAgentId: string, toAgentId: string, context: HandoffContext): Promise<HandoffResult>;
+    /**
+     * Subscribes an agent to receive messages.
+     */
+    subscribe(agentId: string, handler: MessageHandler, options?: SubscriptionOptions): Unsubscribe;
+    /**
+     * Unsubscribes an agent from all messages.
+     */
+    unsubscribeAll(agentId: string): void;
+    /**
+     * Creates a message topic.
+     */
+    createTopic(topic: Omit<MessageTopic, 'topicId'>): Promise<MessageTopic>;
+    /**
+     * Publishes a message to a topic.
+     */
+    publishToTopic(topicId: string, message: Omit<AgentMessage, 'messageId' | 'sentAt'>): Promise<DeliveryStatus[]>;
+    /**
+     * Subscribes an agent to a topic.
+     */
+    subscribeToTopic(agentId: string, topicId: string, handler: MessageHandler): Unsubscribe;
+    /**
+     * Gets the delivery status of a message.
+     */
+    getDeliveryStatus(messageId: string): Promise<DeliveryStatus | null>;
+    /**
+     * Acknowledges receipt of a message.
+     */
+    acknowledgeMessage(messageId: string, agentId: string): Promise<void>;
+    /**
+     * Retries delivery of a failed message.
+     */
+    retryDelivery(messageId: string): Promise<DeliveryStatus>;
+    /**
+     * Gets message bus statistics.
+     */
+    getStatistics(): BusStatistics;
+    /**
+     * Gets message history for an agent.
+     */
+    getMessageHistory(agentId: string, options?: {
+        limit?: number;
+        since?: Date;
+        types?: AgentMessageType[];
+        direction?: 'sent' | 'received' | 'both';
+    }): Promise<AgentMessage[]>;
+    /**
+     * Registers an agent with an agency for routing.
+     */
+    registerAgent(agentId: string, agencyId: string, roleId: string): void;
+    /**
+     * Unregisters an agent from routing.
+     */
+    unregisterAgent(agentId: string): void;
+    private deliverMessage;
+    private matchesSubscription;
+    private meetsMinPriority;
+    private addToHistory;
+    private getAgentsInAgency;
+    private createDeliveredStatus;
+    private createFailedDelivery;
+    private updateAvgDeliveryTime;
+}
+//# sourceMappingURL=AgentCommunicationBus.d.ts.map

package/dist/core/agency/AgentCommunicationBus.d.ts.map

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