@noosphere/agent-core 0.2.0-alpha.2 → 0.2.0-alpha.3

package/dist/index.d.mts

@@ -194,6 +194,23 @@ interface CommitmentSuccessEvent {
     requestStartedEvent?: RequestStartedEvent;
 }
 
+/**
+ * Connection state for EventMonitor
+ */
+type ConnectionState = 'INIT' | 'WS_CONNECTING' | 'WS_ACTIVE' | 'WS_RECONNECTING' | 'HTTP_FALLBACK';
+/**
+ * Connection configuration
+ */
+interface ConnectionConfig {
+    /** WS connection timeout in ms (default: 10000) */
+    wsConnectTimeoutMs: number;
+    /** Max WS connection retries before HTTP fallback (default: 3) */
+    wsMaxConnectRetries: number;
+    /** Delay between WS connection retries in ms (default: 5000) */
+    wsConnectRetryDelayMs: number;
+    /** Interval for WS recovery attempts when in HTTP fallback (default: 60000) */
+    wsRecoveryIntervalMs: number;
+}
 interface CheckpointData$1 {
     blockNumber: number;
     blockHash?: string;
@@ -202,6 +219,7 @@ interface CheckpointData$1 {
 interface EventMonitorOptions {
     loadCheckpoint?: () => CheckpointData$1 | undefined;
     saveCheckpoint?: (checkpoint: CheckpointData$1) => void;
+    connectionConfig?: Partial<ConnectionConfig>;
 }
 declare class EventMonitor extends EventEmitter {
     private config;
@@ -218,8 +236,48 @@ declare class EventMonitor extends EventEmitter {
     private heartbeatInterval;
     private lastEventTime;
     private checkpointCallbacks?;
+    private connectionState;
+    private connectionConfig;
+    private wsRecoveryInterval;
+    private pollingInterval;
     constructor(config: AgentConfig, routerAbi: any[], coordinatorAbi: any[], options?: EventMonitorOptions);
+    /**
+     * Get current connection state
+     */
+    getConnectionState(): ConnectionState;
+    /**
+     * Get connection mode string for health API
+     */
+    getConnectionMode(): 'websocket' | 'http_polling' | 'connecting';
     connect(): Promise<void>;
+    /**
+     * Connect via WebSocket with timeout
+     */
+    private connectWebSocketWithTimeout;
+    /**
+     * Connect via HTTP (fallback mode)
+     */
+    private connectHttp;
+    /**
+     * Initialize contract instances
+     */
+    private initializeContracts;
+    /**
+     * Start WS recovery loop when in HTTP fallback mode
+     */
+    private startWsRecoveryLoop;
+    /**
+     * Stop WS recovery loop
+     */
+    private stopWsRecoveryLoop;
+    /**
+     * Stop HTTP polling
+     */
+    private stopPolling;
+    /**
+     * Sleep helper
+     */
+    private sleep;
     start(): Promise<void>;
     private replayEvents;
     private startWebSocketListening;
@@ -609,6 +667,16 @@ declare class NoosphereAgent {
      * Get scheduler service (for advanced usage)
      */
     getScheduler(): SchedulerService;
+    /**
+     * Get current connection state
+     * @returns Connection state: 'INIT' | 'WS_CONNECTING' | 'WS_ACTIVE' | 'WS_RECONNECTING' | 'HTTP_FALLBACK'
+     */
+    getConnectionState(): string;
+    /**
+     * Get current connection mode
+     * @returns Connection mode: 'websocket' | 'http_polling' | 'connecting'
+     */
+    getConnectionMode(): 'websocket' | 'http_polling' | 'connecting';
 }
 
 /**
@@ -859,4 +927,4 @@ declare class PayloadResolver {
     deserialize(serialized: string): PayloadData;
 }
 
-export { type AgentConfig, type CheckpointData$1 as CheckpointData, type Commitment, type CommitmentSuccessCallbackEvent, type CommitmentSuccessEvent, CommitmentUtils, type ComputeDeliveredEvent, type ComputeSubscription, ConfigLoader, type ContainerConfig, type ContainerExecutionConfig, ContainerManager, type ContainerMetadata, EventMonitor, FulfillResult, NoosphereAgent, type NoosphereAgentConfig, PayloadResolver, type PayloadResolverConfig, PayloadScheme, PayloadUtils, type Payment, type ProofVerificationRequest, RequestIdUtils, type RequestStartedCallbackEvent, type RequestStartedEvent, type ResolvedPayload, type RetryableEvent, SchedulerService, type VerifierMetadata };
+export { type AgentConfig, type CheckpointData$1 as CheckpointData, type Commitment, type CommitmentSuccessCallbackEvent, type CommitmentSuccessEvent, CommitmentUtils, type ComputeDeliveredEvent, type ComputeSubscription, ConfigLoader, type ConnectionConfig, type ConnectionState, type ContainerConfig, type ContainerExecutionConfig, ContainerManager, type ContainerMetadata, EventMonitor, type EventMonitorOptions, FulfillResult, NoosphereAgent, type NoosphereAgentConfig, PayloadResolver, type PayloadResolverConfig, PayloadScheme, PayloadUtils, type Payment, type ProofVerificationRequest, RequestIdUtils, type RequestStartedCallbackEvent, type RequestStartedEvent, type ResolvedPayload, type RetryableEvent, SchedulerService, type VerifierMetadata };

package/dist/index.d.ts

@@ -194,6 +194,23 @@ interface CommitmentSuccessEvent {
     requestStartedEvent?: RequestStartedEvent;
 }
 
+/**
+ * Connection state for EventMonitor
+ */
+type ConnectionState = 'INIT' | 'WS_CONNECTING' | 'WS_ACTIVE' | 'WS_RECONNECTING' | 'HTTP_FALLBACK';
+/**
+ * Connection configuration
+ */
+interface ConnectionConfig {
+    /** WS connection timeout in ms (default: 10000) */
+    wsConnectTimeoutMs: number;
+    /** Max WS connection retries before HTTP fallback (default: 3) */
+    wsMaxConnectRetries: number;
+    /** Delay between WS connection retries in ms (default: 5000) */
+    wsConnectRetryDelayMs: number;
+    /** Interval for WS recovery attempts when in HTTP fallback (default: 60000) */
+    wsRecoveryIntervalMs: number;
+}
 interface CheckpointData$1 {
     blockNumber: number;
     blockHash?: string;
@@ -202,6 +219,7 @@ interface CheckpointData$1 {
 interface EventMonitorOptions {
     loadCheckpoint?: () => CheckpointData$1 | undefined;
     saveCheckpoint?: (checkpoint: CheckpointData$1) => void;
+    connectionConfig?: Partial<ConnectionConfig>;
 }
 declare class EventMonitor extends EventEmitter {
     private config;
@@ -218,8 +236,48 @@ declare class EventMonitor extends EventEmitter {
     private heartbeatInterval;
     private lastEventTime;
     private checkpointCallbacks?;
+    private connectionState;
+    private connectionConfig;
+    private wsRecoveryInterval;
+    private pollingInterval;
     constructor(config: AgentConfig, routerAbi: any[], coordinatorAbi: any[], options?: EventMonitorOptions);
+    /**
+     * Get current connection state
+     */
+    getConnectionState(): ConnectionState;
+    /**
+     * Get connection mode string for health API
+     */
+    getConnectionMode(): 'websocket' | 'http_polling' | 'connecting';
     connect(): Promise<void>;
+    /**
+     * Connect via WebSocket with timeout
+     */
+    private connectWebSocketWithTimeout;
+    /**
+     * Connect via HTTP (fallback mode)
+     */
+    private connectHttp;
+    /**
+     * Initialize contract instances
+     */
+    private initializeContracts;
+    /**
+     * Start WS recovery loop when in HTTP fallback mode
+     */
+    private startWsRecoveryLoop;
+    /**
+     * Stop WS recovery loop
+     */
+    private stopWsRecoveryLoop;
+    /**
+     * Stop HTTP polling
+     */
+    private stopPolling;
+    /**
+     * Sleep helper
+     */
+    private sleep;
     start(): Promise<void>;
     private replayEvents;
     private startWebSocketListening;
@@ -609,6 +667,16 @@ declare class NoosphereAgent {
      * Get scheduler service (for advanced usage)
      */
     getScheduler(): SchedulerService;
+    /**
+     * Get current connection state
+     * @returns Connection state: 'INIT' | 'WS_CONNECTING' | 'WS_ACTIVE' | 'WS_RECONNECTING' | 'HTTP_FALLBACK'
+     */
+    getConnectionState(): string;
+    /**
+     * Get current connection mode
+     * @returns Connection mode: 'websocket' | 'http_polling' | 'connecting'
+     */
+    getConnectionMode(): 'websocket' | 'http_polling' | 'connecting';
 }
 
 /**
@@ -859,4 +927,4 @@ declare class PayloadResolver {
     deserialize(serialized: string): PayloadData;
 }
 
-export { type AgentConfig, type CheckpointData$1 as CheckpointData, type Commitment, type CommitmentSuccessCallbackEvent, type CommitmentSuccessEvent, CommitmentUtils, type ComputeDeliveredEvent, type ComputeSubscription, ConfigLoader, type ContainerConfig, type ContainerExecutionConfig, ContainerManager, type ContainerMetadata, EventMonitor, FulfillResult, NoosphereAgent, type NoosphereAgentConfig, PayloadResolver, type PayloadResolverConfig, PayloadScheme, PayloadUtils, type Payment, type ProofVerificationRequest, RequestIdUtils, type RequestStartedCallbackEvent, type RequestStartedEvent, type ResolvedPayload, type RetryableEvent, SchedulerService, type VerifierMetadata };
+export { type AgentConfig, type CheckpointData$1 as CheckpointData, type Commitment, type CommitmentSuccessCallbackEvent, type CommitmentSuccessEvent, CommitmentUtils, type ComputeDeliveredEvent, type ComputeSubscription, ConfigLoader, type ConnectionConfig, type ConnectionState, type ContainerConfig, type ContainerExecutionConfig, ContainerManager, type ContainerMetadata, EventMonitor, type EventMonitorOptions, FulfillResult, NoosphereAgent, type NoosphereAgentConfig, PayloadResolver, type PayloadResolverConfig, PayloadScheme, PayloadUtils, type Payment, type ProofVerificationRequest, RequestIdUtils, type RequestStartedCallbackEvent, type RequestStartedEvent, type ResolvedPayload, type RetryableEvent, SchedulerService, type VerifierMetadata };