@bluefly/openstandardagents 0.2.9 → 0.3.0

package/dist/transports/sse.js

@@ -0,0 +1,309 @@
+/**
+ * Server-Sent Events (SSE) Transport Implementation
+ * Unidirectional server-to-client event streaming for OSSA agents
+ */
+import { EventEmitter } from 'events';
+/**
+ * SSE Transport
+ * Provides unidirectional server-to-client event streaming
+ */
+export class SSETransport extends EventEmitter {
+    eventSource = null;
+    config;
+    reconnectAttempt = 0;
+    lastEventId;
+    eventHandlers = new Map();
+    constructor(config) {
+        super();
+        this.config = {
+            url: config.url,
+            auth: config.auth || {},
+            channels: config.channels || [],
+            lastEventId: config.lastEventId,
+            withCredentials: config.withCredentials ?? true,
+            reconnect: {
+                enabled: config.reconnect?.enabled ?? true,
+                maxAttempts: config.reconnect?.maxAttempts || 10,
+                retryTime: config.reconnect?.retryTime || 3000,
+            },
+        };
+        this.lastEventId = config.lastEventId;
+    }
+    /**
+     * Connect to SSE endpoint
+     */
+    async connect() {
+        return new Promise((resolve, reject) => {
+            try {
+                const url = this.buildConnectionUrl();
+                // Note: EventSource doesn't support custom headers in browsers
+                // For bearer auth, need server-side proxy or use cookie/query param
+                const options = {
+                    withCredentials: this.config.withCredentials,
+                };
+                this.eventSource = new EventSource(url, options);
+                this.eventSource.onopen = () => {
+                    this.onOpen();
+                    resolve();
+                };
+                this.eventSource.onerror = (error) => {
+                    this.onError(error);
+                    if (this.reconnectAttempt === 0) {
+                        reject(error);
+                    }
+                };
+                // Register default message handler
+                this.eventSource.onmessage = (event) => {
+                    this.onMessage(event);
+                };
+                // Register custom event handlers
+                this.registerEventHandlers();
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Disconnect from SSE endpoint
+     */
+    async disconnect() {
+        if (this.eventSource) {
+            // Remove all event listeners
+            this.eventHandlers.forEach((handler, eventType) => {
+                this.eventSource.removeEventListener(eventType, handler);
+            });
+            this.eventHandlers.clear();
+            this.eventSource.close();
+            this.eventSource = null;
+        }
+        this.reconnectAttempt = 0;
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        return this.eventSource?.readyState === EventSource.OPEN;
+    }
+    /**
+     * Get connection state
+     */
+    getState() {
+        if (!this.eventSource) {
+            return 'CLOSED';
+        }
+        switch (this.eventSource.readyState) {
+            case EventSource.CONNECTING:
+                return 'CONNECTING';
+            case EventSource.OPEN:
+                return 'OPEN';
+            case EventSource.CLOSED:
+                return 'CLOSED';
+            default:
+                return 'CLOSED';
+        }
+    }
+    /**
+     * Build connection URL with auth and parameters
+     */
+    buildConnectionUrl() {
+        const url = new URL(this.config.url);
+        // Add channels if specified
+        if (this.config.channels && this.config.channels.length > 0) {
+            url.searchParams.set('channels', this.config.channels.join(','));
+        }
+        // Add query token if specified
+        if (this.config.auth?.type === 'query' && this.config.auth?.token) {
+            url.searchParams.set('token', this.config.auth.token);
+        }
+        return url.toString();
+    }
+    /**
+     * Register custom event handlers for different event types
+     */
+    registerEventHandlers() {
+        const eventTypes = ['message', 'status', 'capability_response', 'error'];
+        eventTypes.forEach((eventType) => {
+            const handler = (event) => {
+                this.handleTypedEvent(eventType, event);
+            };
+            this.eventHandlers.set(eventType, handler);
+            this.eventSource.addEventListener(eventType, handler);
+        });
+    }
+    /**
+     * Handle connection open
+     */
+    onOpen() {
+        this.reconnectAttempt = 0;
+        this.emit('connected');
+    }
+    /**
+     * Handle connection error
+     */
+    onError(error) {
+        this.emit('error', error);
+        if (this.eventSource?.readyState === EventSource.CLOSED) {
+            this.emit('disconnected');
+            if (this.config.reconnect?.enabled &&
+                this.reconnectAttempt < (this.config.reconnect?.maxAttempts || 10)) {
+                this.reconnectAttempt++;
+                this.emit('reconnecting', this.reconnectAttempt);
+            }
+        }
+    }
+    /**
+     * Handle default message event
+     */
+    onMessage(event) {
+        try {
+            const data = JSON.parse(event.data);
+            this.updateLastEventId(event.lastEventId);
+            this.emit('message', data);
+            this.emit('*', data);
+        }
+        catch (error) {
+            this.emit('error', new Error(`Failed to parse message: ${error}`));
+        }
+    }
+    /**
+     * Handle typed event
+     */
+    handleTypedEvent(eventType, event) {
+        try {
+            const data = JSON.parse(event.data);
+            this.updateLastEventId(event.lastEventId);
+            switch (eventType) {
+                case 'status':
+                    this.emit('status', data);
+                    break;
+                case 'capability_response':
+                    this.emit('capability_response', data);
+                    // Emit completion event if final
+                    if (data.metadata.final) {
+                        this.emit('capability_complete', data);
+                    }
+                    break;
+                case 'error':
+                    this.emit('error', data.payload);
+                    break;
+                default:
+                    this.emit(eventType, data);
+            }
+            this.emit('*', data);
+        }
+        catch (error) {
+            this.emit('error', new Error(`Failed to parse ${eventType} event: ${error}`));
+        }
+    }
+    /**
+     * Update last event ID for reconnection
+     */
+    updateLastEventId(lastEventId) {
+        if (lastEventId) {
+            this.lastEventId = lastEventId;
+        }
+    }
+    /**
+     * Get last event ID
+     */
+    getLastEventId() {
+        return this.lastEventId;
+    }
+}
+/**
+ * SSE Stream Client
+ * High-level client for streaming capability responses
+ */
+export class SSEStreamClient {
+    transport = null;
+    baseUrl;
+    auth;
+    constructor(baseUrl, auth) {
+        this.baseUrl = baseUrl;
+        this.auth = auth;
+    }
+    /**
+     * Invoke capability with streaming response
+     */
+    async invokeStreamingCapability(capability, input, options) {
+        // Step 1: POST to capability endpoint to initiate streaming
+        const response = await fetch(`${this.baseUrl}/capabilities/${capability}/invoke`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(this.auth?.type === 'bearer' && this.auth.token
+                    ? { Authorization: `Bearer ${this.auth.token}` }
+                    : {}),
+            },
+            body: JSON.stringify({
+                input,
+                options: {
+                    timeout_seconds: options?.timeout,
+                    priority: options?.priority,
+                },
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to invoke capability: ${response.statusText}`);
+        }
+        const result = await response.json();
+        const { streamId, streamUrl } = result;
+        // Step 2: Connect to SSE stream
+        return new Promise((resolve, reject) => {
+            this.transport = new SSETransport({
+                url: streamUrl,
+                auth: this.auth,
+            });
+            const timeout = setTimeout(() => {
+                this.transport?.disconnect();
+                reject(new Error('Capability timeout'));
+            }, options?.timeout || 30000);
+            this.transport.on('capability_response', (event) => {
+                // Emit progress updates
+                if (options?.onProgress) {
+                    options.onProgress(event);
+                }
+                // Handle final result
+                if (event.metadata.final) {
+                    clearTimeout(timeout);
+                    this.transport?.disconnect();
+                    resolve(event.payload.result);
+                }
+            });
+            this.transport.on('error', (error) => {
+                clearTimeout(timeout);
+                this.transport?.disconnect();
+                reject(error);
+            });
+            this.transport.connect().catch(reject);
+        });
+    }
+    /**
+     * Subscribe to event channels
+     */
+    async subscribe(channels, handler) {
+        const transport = new SSETransport({
+            url: `${this.baseUrl}/events`,
+            channels,
+            auth: this.auth,
+        });
+        transport.on('*', handler);
+        await transport.connect();
+        return transport;
+    }
+    /**
+     * Subscribe to agent status updates
+     */
+    async subscribeToStatus(handler) {
+        const transport = new SSETransport({
+            url: `${this.baseUrl}/events`,
+            channels: ['agent.status'],
+            auth: this.auth,
+        });
+        transport.on('status', handler);
+        await transport.connect();
+        return transport;
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/transports/sse.js.map

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

package/dist/transports/webrtc.d.ts

@@ -0,0 +1,183 @@
+/**
+ * WebRTC Transport Implementation
+ * Peer-to-peer communication for OSSA agents
+ */
+import { EventEmitter } from 'events';
+/**
+ * WebRTC message types
+ */
+export type WebRTCMessageType = 'message' | 'capability_call' | 'capability_response' | 'status' | 'error' | 'heartbeat';
+/**
+ * Message metadata
+ */
+export interface WebRTCMessageMetadata {
+    agentId: string;
+    channelId?: string;
+    correlationId?: string;
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    ttl?: number;
+    chunked?: {
+        chunkIndex: number;
+        totalChunks: number;
+        messageId: string;
+    };
+}
+/**
+ * Base WebRTC message structure
+ */
+export interface WebRTCMessage<T = unknown> {
+    type: WebRTCMessageType;
+    id: string;
+    timestamp: string;
+    payload: T;
+    metadata: WebRTCMessageMetadata;
+}
+/**
+ * Signaling message types
+ */
+export type SignalingMessageType = 'offer' | 'answer' | 'ice-candidate' | 'error';
+/**
+ * Signaling message
+ */
+export interface SignalingMessage {
+    type: SignalingMessageType;
+    from: string;
+    to: string;
+    sessionId?: string;
+    sdp?: string;
+    candidate?: RTCIceCandidateInit;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Data channel configuration
+ */
+export interface DataChannelConfig {
+    label: string;
+    ordered?: boolean;
+    maxPacketLifeTime?: number;
+    maxRetransmits?: number;
+    protocol?: string;
+    negotiated?: boolean;
+    id?: number;
+}
+/**
+ * WebRTC transport configuration
+ */
+export interface WebRTCTransportConfig {
+    agentId: string;
+    remoteAgentId: string;
+    iceServers?: RTCIceServer[];
+    signaling: EventEmitter;
+    channels?: DataChannelConfig[];
+    chunkSize?: number;
+    heartbeatInterval?: number;
+}
+/**
+ * WebRTC Transport
+ * Provides peer-to-peer communication between agents
+ */
+export declare class WebRTCTransport extends EventEmitter {
+    private peerConnection;
+    private dataChannels;
+    private config;
+    private heartbeatTimer?;
+    private chunks;
+    private pendingResponses;
+    constructor(config: WebRTCTransportConfig);
+    /**
+     * Initialize as offerer (create connection and send offer)
+     */
+    createOffer(): Promise<void>;
+    /**
+     * Handle incoming offer and create answer
+     */
+    handleOffer(sdp: string): Promise<void>;
+    /**
+     * Handle incoming answer
+     */
+    handleAnswer(sdp: string): Promise<void>;
+    /**
+     * Add ICE candidate
+     */
+    addIceCandidate(candidate: RTCIceCandidateInit): Promise<void>;
+    /**
+     * Close connection
+     */
+    close(): Promise<void>;
+    /**
+     * Send message on specified channel
+     */
+    send<T>(channelLabel: string, type: WebRTCMessageType, payload: T, options?: {
+        correlationId?: string;
+        priority?: 'low' | 'normal' | 'high' | 'critical';
+        ttl?: number;
+    }): Promise<void>;
+    /**
+     * Invoke capability on remote agent
+     */
+    invokeCapability<TInput, TOutput>(capability: string, input: TInput, options?: {
+        channel?: string;
+        timeout?: number;
+    }): Promise<TOutput>;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get connection state
+     */
+    getConnectionState(): RTCPeerConnectionState | 'closed';
+    /**
+     * Create peer connection
+     */
+    private createPeerConnection;
+    /**
+     * Create data channels
+     */
+    private createDataChannels;
+    /**
+     * Setup data channel event handlers
+     */
+    private setupDataChannel;
+    /**
+     * Handle incoming message
+     */
+    private handleMessage;
+    /**
+     * Process complete message
+     */
+    private processMessage;
+    /**
+     * Send chunked message
+     */
+    private sendChunked;
+    /**
+     * Handle chunked message
+     */
+    private handleChunkedMessage;
+    /**
+     * Setup signaling handlers
+     */
+    private setupSignalingHandlers;
+    /**
+     * Start heartbeat
+     */
+    private startHeartbeat;
+    /**
+     * Stop heartbeat
+     */
+    private stopHeartbeat;
+}
+/**
+ * Simple in-memory signaling server for testing/local use
+ */
+export declare class InMemorySignalingServer extends EventEmitter {
+    private agents;
+    registerAgent(agentId: string): EventEmitter;
+    unregisterAgent(agentId: string): void;
+    clear(): void;
+}
+//# sourceMappingURL=webrtc.d.ts.map

package/dist/transports/webrtc.d.ts.map

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