@framers/agentos 0.1.0

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

@@ -0,0 +1,469 @@
+/**
+ * @file IAgentCommunicationBus.ts
+ * @description Interface for inter-agent communication within AgentOS agencies.
+ * Enables GMIs to send messages, broadcast to agencies, and coordinate tasks.
+ *
+ * Supports multiple communication patterns:
+ * - Point-to-point messaging
+ * - Broadcast to agency
+ * - Request-response
+ * - Task delegation and handoff
+ * - Pub/sub for topics
+ *
+ * @module AgentOS/Agency
+ * @version 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const bus = new AgentCommunicationBus(logger);
+ *
+ * // Subscribe to messages
+ * const unsubscribe = bus.subscribe('agent-1', (message) => {
+ *   console.log('Received:', message);
+ * });
+ *
+ * // Send a message
+ * await bus.sendToAgent('agent-2', {
+ *   type: 'task_delegation',
+ *   content: 'Please analyze this data',
+ *   metadata: { priority: 'high' },
+ * });
+ *
+ * // Request-response
+ * const response = await bus.requestResponse('agent-3', {
+ *   type: 'question',
+ *   content: 'What is your analysis?',
+ * });
+ * ```
+ */
+/**
+ * Types of messages that can be sent between agents.
+ */
+export type AgentMessageType = 'task_delegation' | 'status_update' | 'question' | 'answer' | 'finding' | 'decision' | 'critique' | 'handoff' | 'acknowledgment' | 'error' | 'broadcast' | 'heartbeat';
+/**
+ * Priority levels for messages.
+ */
+export type MessagePriority = 'low' | 'normal' | 'high' | 'urgent';
+/**
+ * A message sent between agents.
+ */
+export interface AgentMessage {
+    /** Unique message identifier */
+    messageId: string;
+    /** Type of message */
+    type: AgentMessageType;
+    /** Sender agent ID */
+    fromAgentId: string;
+    /** Sender's role in the agency */
+    fromRoleId?: string;
+    /** Target agent ID (null for broadcasts) */
+    toAgentId?: string;
+    /** Target role (for role-based routing) */
+    toRoleId?: string;
+    /** Agency context */
+    agencyId?: string;
+    /** Message content */
+    content: string | Record<string, unknown>;
+    /** Message priority */
+    priority: MessagePriority;
+    /** Timestamp when sent */
+    sentAt: Date;
+    /** Expiration time for time-sensitive messages */
+    expiresAt?: Date;
+    /** If this is a reply, the original message ID */
+    inReplyTo?: string;
+    /** Thread/conversation ID for related messages */
+    threadId?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Whether delivery confirmation is required */
+    requiresAck?: boolean;
+}
+/**
+ * A request expecting a response.
+ */
+export interface AgentRequest extends Omit<AgentMessage, 'type'> {
+    /** Request type (subset of message types) */
+    type: 'question' | 'task_delegation' | 'critique';
+    /** Timeout for response in ms */
+    timeoutMs?: number;
+}
+/**
+ * Response to an agent request.
+ */
+export interface AgentResponse {
+    /** Response identifier */
+    responseId: string;
+    /** Original request ID */
+    requestId: string;
+    /** Responding agent ID */
+    fromAgentId: string;
+    /** Response status */
+    status: 'success' | 'error' | 'timeout' | 'rejected';
+    /** Response content */
+    content: unknown;
+    /** Error details if status is 'error' */
+    error?: string;
+    /** Timestamp */
+    respondedAt: Date;
+}
+/**
+ * Context for task handoff between agents.
+ */
+export interface HandoffContext {
+    /** Task being handed off */
+    taskId: string;
+    /** Task description */
+    taskDescription: string;
+    /** Current progress (0-1) */
+    progress: number;
+    /** Work completed so far */
+    completedWork: string[];
+    /** Remaining work items */
+    remainingWork: string[];
+    /** Relevant context/data */
+    context: Record<string, unknown>;
+    /** Reason for handoff */
+    reason: 'completion' | 'escalation' | 'specialization' | 'capacity' | 'timeout';
+    /** Instructions for receiving agent */
+    instructions?: string;
+    /** Deadline if any */
+    deadline?: Date;
+}
+/**
+ * Result of a handoff operation.
+ */
+export interface HandoffResult {
+    /** Whether handoff was accepted */
+    accepted: boolean;
+    /** New owner agent ID */
+    newOwnerId?: string;
+    /** New owner role */
+    newOwnerRoleId?: string;
+    /** Rejection reason if not accepted */
+    rejectionReason?: string;
+    /** Acknowledgment message */
+    acknowledgment?: string;
+    /** Timestamp */
+    handoffAt: Date;
+}
+/**
+ * Handler function for incoming messages.
+ */
+export type MessageHandler = (message: AgentMessage) => void | Promise<void>;
+/**
+ * Function to unsubscribe from messages.
+ */
+export type Unsubscribe = () => void;
+/**
+ * Subscription options.
+ */
+export interface SubscriptionOptions {
+    /** Filter by message types */
+    messageTypes?: AgentMessageType[];
+    /** Filter by sender role */
+    fromRoles?: string[];
+    /** Filter by priority */
+    minPriority?: MessagePriority;
+    /** Only messages in specific thread */
+    threadId?: string;
+}
+/**
+ * A topic for publish/subscribe messaging.
+ */
+export interface MessageTopic {
+    /** Topic identifier */
+    topicId: string;
+    /** Topic name */
+    name: string;
+    /** Topic description */
+    description?: string;
+    /** Agency scope (null for global) */
+    agencyId?: string;
+    /** Allowed publisher roles */
+    publisherRoles?: string[];
+    /** Allowed subscriber roles */
+    subscriberRoles?: string[];
+}
+/**
+ * Delivery status for a message.
+ */
+export interface DeliveryStatus {
+    /** Message ID */
+    messageId: string;
+    /** Target agent */
+    targetAgentId: string;
+    /** Delivery status */
+    status: 'pending' | 'delivered' | 'acknowledged' | 'failed' | 'expired';
+    /** Delivery timestamp */
+    deliveredAt?: Date;
+    /** Acknowledgment timestamp */
+    acknowledgedAt?: Date;
+    /** Failure reason */
+    failureReason?: string;
+    /** Retry count */
+    retryCount: number;
+}
+/**
+ * Message routing configuration.
+ */
+export interface RoutingConfig {
+    /** Enable role-based routing */
+    enableRoleRouting: boolean;
+    /** Enable load balancing across agents with same role */
+    enableLoadBalancing: boolean;
+    /** Default message TTL in ms */
+    defaultTtlMs: number;
+    /** Maximum retries for failed delivery */
+    maxRetries: number;
+    /** Retry delay in ms */
+    retryDelayMs: number;
+}
+/**
+ * Statistics about message bus activity.
+ */
+export interface BusStatistics {
+    /** Total messages sent */
+    totalMessagesSent: number;
+    /** Total messages delivered */
+    totalMessagesDelivered: number;
+    /** Total messages failed */
+    totalMessagesFailed: number;
+    /** Messages by type */
+    messagesByType: Record<AgentMessageType, number>;
+    /** Active subscriptions */
+    activeSubscriptions: number;
+    /** Average delivery time in ms */
+    avgDeliveryTimeMs: number;
+    /** Messages in queue */
+    queueDepth: number;
+}
+/**
+ * Interface for the AgentOS Agent Communication Bus.
+ *
+ * The Communication Bus enables structured messaging between agents
+ * within an agency, supporting various communication patterns:
+ *
+ * - **Point-to-Point**: Direct messages between two agents
+ * - **Broadcast**: Messages to all agents in an agency
+ * - **Request-Response**: Synchronous-style communication
+ * - **Pub/Sub**: Topic-based messaging
+ * - **Handoff**: Structured task transfer between agents
+ *
+ * @example
+ * ```typescript
+ * // Initialize bus
+ * const bus = new AgentCommunicationBus({ logger, routingConfig });
+ *
+ * // Agent subscribes to messages
+ * bus.subscribe('analyst-gmi', async (msg) => {
+ *   if (msg.type === 'task_delegation') {
+ *     const result = await analyzeData(msg.content);
+ *     await bus.sendToAgent(msg.fromAgentId, {
+ *       type: 'answer',
+ *       content: result,
+ *       inReplyTo: msg.messageId,
+ *     });
+ *   }
+ * });
+ *
+ * // Coordinator delegates task
+ * await bus.sendToAgent('analyst-gmi', {
+ *   type: 'task_delegation',
+ *   content: { data: [...], instructions: 'Analyze trends' },
+ *   priority: 'high',
+ * });
+ * ```
+ */
+export interface IAgentCommunicationBus {
+    /**
+     * Sends a message to a specific agent.
+     *
+     * @param targetAgentId - Target agent identifier
+     * @param message - Message to send (without routing fields)
+     * @returns Delivery status
+     *
+     * @example
+     * ```typescript
+     * await bus.sendToAgent('researcher-gmi', {
+     *   type: 'question',
+     *   content: 'What did you find about topic X?',
+     *   priority: 'normal',
+     * });
+     * ```
+     */
+    sendToAgent(targetAgentId: string, message: Omit<AgentMessage, 'messageId' | 'toAgentId' | 'sentAt'>): Promise<DeliveryStatus>;
+    /**
+     * Sends a message to an agent by role.
+     * If multiple agents have the role, uses load balancing.
+     *
+     * @param agencyId - Agency context
+     * @param targetRoleId - Target role identifier
+     * @param message - Message to send
+     * @returns Delivery status
+     */
+    sendToRole(agencyId: string, targetRoleId: string, message: Omit<AgentMessage, 'messageId' | 'toRoleId' | 'sentAt'>): Promise<DeliveryStatus>;
+    /**
+     * Broadcasts a message to all agents in an agency.
+     *
+     * @param agencyId - Target agency
+     * @param message - Message to broadcast
+     * @returns Array of delivery statuses
+     *
+     * @example
+     * ```typescript
+     * await bus.broadcast('agency-123', {
+     *   type: 'broadcast',
+     *   content: 'Meeting in 5 minutes',
+     *   priority: 'high',
+     * });
+     * ```
+     */
+    broadcast(agencyId: string, message: Omit<AgentMessage, 'messageId' | 'toAgentId' | 'sentAt'>): Promise<DeliveryStatus[]>;
+    /**
+     * Broadcasts to specific roles within an agency.
+     *
+     * @param agencyId - Target agency
+     * @param roleIds - Target roles
+     * @param message - Message to broadcast
+     * @returns Array of delivery statuses
+     */
+    broadcastToRoles(agencyId: string, roleIds: string[], message: Omit<AgentMessage, 'messageId' | 'sentAt'>): Promise<DeliveryStatus[]>;
+    /**
+     * Sends a request and waits for a response.
+     * Implements request-response pattern over async messaging.
+     *
+     * @param targetAgentId - Target agent
+     * @param request - Request message
+     * @returns Response from target agent
+     *
+     * @example
+     * ```typescript
+     * const response = await bus.requestResponse('expert-gmi', {
+     *   type: 'question',
+     *   content: 'What is the optimal approach?',
+     *   fromAgentId: 'coordinator-gmi',
+     *   timeoutMs: 30000,
+     * });
+     * if (response.status === 'success') {
+     *   console.log('Answer:', response.content);
+     * }
+     * ```
+     */
+    requestResponse(targetAgentId: string, request: AgentRequest): Promise<AgentResponse>;
+    /**
+     * Initiates a structured handoff between agents.
+     * Used for transferring task ownership with full context.
+     *
+     * @param fromAgentId - Current owner
+     * @param toAgentId - New owner
+     * @param context - Handoff context
+     * @returns Handoff result
+     *
+     * @example
+     * ```typescript
+     * const result = await bus.handoff('analyst-gmi', 'reviewer-gmi', {
+     *   taskId: 'analysis-task-1',
+     *   taskDescription: 'Data analysis for Q4 report',
+     *   progress: 0.8,
+     *   completedWork: ['Data collection', 'Initial analysis'],
+     *   remainingWork: ['Final review', 'Report generation'],
+     *   context: { findings: [...] },
+     *   reason: 'completion',
+     * });
+     * ```
+     */
+    handoff(fromAgentId: string, toAgentId: string, context: HandoffContext): Promise<HandoffResult>;
+    /**
+     * Subscribes an agent to receive messages.
+     *
+     * @param agentId - Agent to subscribe
+     * @param handler - Message handler function
+     * @param options - Subscription filter options
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * const unsub = bus.subscribe('worker-gmi', async (msg) => {
+     *   console.log('Received:', msg.type, msg.content);
+     * }, {
+     *   messageTypes: ['task_delegation', 'question'],
+     *   minPriority: 'normal',
+     * });
+     *
+     * // Later: unsub();
+     * ```
+     */
+    subscribe(agentId: string, handler: MessageHandler, options?: SubscriptionOptions): Unsubscribe;
+    /**
+     * Unsubscribes an agent from all messages.
+     *
+     * @param agentId - Agent to unsubscribe
+     */
+    unsubscribeAll(agentId: string): void;
+    /**
+     * Creates a message topic.
+     *
+     * @param topic - Topic configuration
+     * @returns Created topic
+     */
+    createTopic(topic: Omit<MessageTopic, 'topicId'>): Promise<MessageTopic>;
+    /**
+     * Publishes a message to a topic.
+     *
+     * @param topicId - Topic identifier
+     * @param message - Message to publish
+     * @returns Delivery statuses for all subscribers
+     */
+    publishToTopic(topicId: string, message: Omit<AgentMessage, 'messageId' | 'sentAt'>): Promise<DeliveryStatus[]>;
+    /**
+     * Subscribes an agent to a topic.
+     *
+     * @param agentId - Agent to subscribe
+     * @param topicId - Topic identifier
+     * @param handler - Message handler
+     * @returns Unsubscribe function
+     */
+    subscribeToTopic(agentId: string, topicId: string, handler: MessageHandler): Unsubscribe;
+    /**
+     * Gets the delivery status of a message.
+     *
+     * @param messageId - Message identifier
+     * @returns Delivery status or null if not found
+     */
+    getDeliveryStatus(messageId: string): Promise<DeliveryStatus | null>;
+    /**
+     * Acknowledges receipt of a message.
+     *
+     * @param messageId - Message to acknowledge
+     * @param agentId - Acknowledging agent
+     */
+    acknowledgeMessage(messageId: string, agentId: string): Promise<void>;
+    /**
+     * Retries delivery of a failed message.
+     *
+     * @param messageId - Message to retry
+     * @returns New delivery status
+     */
+    retryDelivery(messageId: string): Promise<DeliveryStatus>;
+    /**
+     * Gets message bus statistics.
+     *
+     * @returns Current bus statistics
+     */
+    getStatistics(): BusStatistics;
+    /**
+     * Gets message history for an agent.
+     *
+     * @param agentId - Agent identifier
+     * @param options - Query options
+     * @returns Message history
+     */
+    getMessageHistory(agentId: string, options?: {
+        limit?: number;
+        since?: Date;
+        types?: AgentMessageType[];
+        direction?: 'sent' | 'received' | 'both';
+    }): Promise<AgentMessage[]>;
+}
+//# sourceMappingURL=IAgentCommunicationBus.d.ts.map

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

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

package/dist/core/agency/IAgentCommunicationBus.js

@@ -0,0 +1,40 @@
+/**
+ * @file IAgentCommunicationBus.ts
+ * @description Interface for inter-agent communication within AgentOS agencies.
+ * Enables GMIs to send messages, broadcast to agencies, and coordinate tasks.
+ *
+ * Supports multiple communication patterns:
+ * - Point-to-point messaging
+ * - Broadcast to agency
+ * - Request-response
+ * - Task delegation and handoff
+ * - Pub/sub for topics
+ *
+ * @module AgentOS/Agency
+ * @version 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const bus = new AgentCommunicationBus(logger);
+ *
+ * // Subscribe to messages
+ * const unsubscribe = bus.subscribe('agent-1', (message) => {
+ *   console.log('Received:', message);
+ * });
+ *
+ * // Send a message
+ * await bus.sendToAgent('agent-2', {
+ *   type: 'task_delegation',
+ *   content: 'Please analyze this data',
+ *   metadata: { priority: 'high' },
+ * });
+ *
+ * // Request-response
+ * const response = await bus.requestResponse('agent-3', {
+ *   type: 'question',
+ *   content: 'What is your analysis?',
+ * });
+ * ```
+ */
+export {};
+//# sourceMappingURL=IAgentCommunicationBus.js.map

package/dist/core/agency/IAgentCommunicationBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAgentCommunicationBus.js","sourceRoot":"","sources":["../../../src/core/agency/IAgentCommunicationBus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG"}

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

@@ -0,0 +1,18 @@
+/**
+ * @file index.ts
+ * @description Agency module exports - multi-GMI collective management.
+ *
+ * The Agency module provides infrastructure for multi-agent collaboration:
+ * - AgencyRegistry: Manages agency sessions and GMI seats
+ * - AgencyMemoryManager: Shared RAG memory for cross-GMI context
+ * - AgentCommunicationBus: Inter-agent messaging and coordination
+ *
+ * @module AgentOS/Agency
+ */
+export type { AgencySeatState, AgencySeatHistoryEntry, AgencyMemoryConfig, AgencyMemoryRetentionPolicy, AgencyMemoryScopingConfig, AgencySession, AgencyUpsertArgs, AgencySeatRegistrationArgs, AgencyMemoryOperationResult, AgencyMemoryQueryOptions, } from './AgencyTypes';
+export { AgencyRegistry } from './AgencyRegistry';
+export { AgencyMemoryManager } from './AgencyMemoryManager';
+export type { AgencyMemoryIngestInput, AgencyMemoryChunk, AgencyMemoryQueryResult, AgencyMemoryStats, } from './AgencyMemoryManager';
+export { AgentCommunicationBus, type AgentCommunicationBusConfig } from './AgentCommunicationBus';
+export type { IAgentCommunicationBus, AgentMessage, AgentMessageType, AgentRequest, AgentResponse, HandoffContext, HandoffResult, MessageHandler, Unsubscribe, SubscriptionOptions, MessageTopic, DeliveryStatus, RoutingConfig, BusStatistics, MessagePriority, } from './IAgentCommunicationBus';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/agency/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,yBAAyB,EACzB,aAAa,EACb,gBAAgB,EAChB,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,qBAAqB,EAAE,KAAK,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAClG,YAAY,EACV,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,0BAA0B,CAAC"}

package/dist/core/agency/index.js

@@ -0,0 +1,18 @@
+/**
+ * @file index.ts
+ * @description Agency module exports - multi-GMI collective management.
+ *
+ * The Agency module provides infrastructure for multi-agent collaboration:
+ * - AgencyRegistry: Manages agency sessions and GMI seats
+ * - AgencyMemoryManager: Shared RAG memory for cross-GMI context
+ * - AgentCommunicationBus: Inter-agent messaging and coordination
+ *
+ * @module AgentOS/Agency
+ */
+// Registry
+export { AgencyRegistry } from './AgencyRegistry.js';
+// Memory Manager
+export { AgencyMemoryManager } from './AgencyMemoryManager.js';
+// Communication Bus
+export { AgentCommunicationBus } from './AgentCommunicationBus.js';
+//# sourceMappingURL=index.js.map

package/dist/core/agency/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/agency/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,iBAAiB;AACjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAQ5D,oBAAoB;AACpB,OAAO,EAAE,qBAAqB,EAAoC,MAAM,yBAAyB,CAAC"}