@tangle-network/sandbox 0.11.1-develop.20260718200351.2f5db96 → 0.11.1

package/dist/session-gateway/index.d.ts

@@ -40,24 +40,16 @@ interface ReplayOptions {
   lastEventId?: string;
   /** Execution ID to replay events for */
   executionId?: string;
-  /** Actual runtime session ID used to scope replayed agent events */
+  /** Session ID context for replay */
   sessionId?: string;
 }
-interface SubscriptionDenial {
-  channel: string;
-  reason: string;
-}
-interface SubscriptionAcknowledgement {
-  channels: string[];
-  denied?: SubscriptionDenial[];
-}
 /**
  * Base fields present on all server messages.
  */
 interface ServerMessageBase {
   id?: string;
   timestamp?: number;
-  /** Monotonic per-session sequence number for consumers to detect gaps. */
+  /** Monotonic sequence number for gap detection (per session) */
   seq?: number;
 }
 /**
@@ -68,11 +60,12 @@ type ServerMessage = (ServerMessageBase & {
   messageType?: string;
   data: {
     sessionId: string;
-    hydratedCount?: number;
   };
 }) | (ServerMessageBase & {
   type: "subscribed";
-  data: SubscriptionAcknowledgement;
+  data: {
+    channels: string[];
+  };
 }) | (ServerMessageBase & {
   type: "unsubscribed";
   data: {
@@ -93,19 +86,6 @@ type ServerMessage = (ServerMessageBase & {
     sandboxId: string;
     error?: string;
   };
-}) | (ServerMessageBase & {
-  type: "runtime.reconnecting";
-  data: {
-    sandboxId: string;
-    attempt: number;
-    delayMs: number;
-  };
-}) | (ServerMessageBase & {
-  type: "runtime.removed";
-  data: {
-    sandboxId: string;
-    reason: string;
-  };
 }) | (ServerMessageBase & {
   type: "runtime.not_found";
   data: {
@@ -142,7 +122,7 @@ type ServerMessage = (ServerMessageBase & {
 }) | (ServerMessageBase & {
   type: "agent.event";
   channel: string;
-  data: unknown; /** @deprecated The server emits `seq`; retained for older deployments. */
+  data: unknown;
   sequenceId?: number;
 }) | (ServerMessageBase & {
   type: "replay.start";
@@ -176,20 +156,6 @@ type ServerMessage = (ServerMessageBase & {
     totalDropped: number; /** Hint that client should request a replay */
     suggestReplay: boolean;
   };
-}) | (ServerMessageBase & {
-  type: "terminal.input.error";
-  data: {
-    terminalId: string;
-    code: string;
-    message: string;
-  };
-}) | (ServerMessageBase & {
-  type: `project.${string}`;
-  channel?: string;
-  data: unknown;
-}) | (ServerMessageBase & {
-  type: "heartbeat";
-  data?: unknown;
 });
 interface PortEventData {
   type: "opened" | "closed";
@@ -197,30 +163,6 @@ interface PortEventData {
   protocol: string;
   processName?: string;
 }
-/**
- * Inbound WebSocket frame before normalization. The server may emit a
- * legacy `messageType` discriminant instead of `type`, and may carry a
- * top-level `channel` plus arbitrary extra fields. `handleMessage`
- * normalizes a `RawWireMessage` into a `ServerMessage` before dispatch:
- * `type` and `data` are mutable here because normalization rewrites them.
- */
-interface RawWireMessage {
-  type?: string;
-  messageType?: string;
-  channel?: string;
-  data?: unknown;
-  id?: string;
-  message?: string;
-  code?: string;
-  timestamp?: number;
-  seq?: number;
-  sequenceId?: number;
-  [key: string]: unknown;
-}
-/** Every inbound frame after legacy names and sequence fields are normalized. */
-interface NormalizedServerMessage extends RawWireMessage {
-  type: string;
-}
 /**
  * Connection state for the WebSocket client.
  */
@@ -273,8 +215,6 @@ interface TokenRefreshResult {
  * Event handlers for session gateway events.
  */
 interface SessionGatewayEventHandlers {
-  /** Called after internal processing for every non-duplicate normalized frame. */
-  onMessage?: (message: NormalizedServerMessage) => void;
   onConnect?: (sessionId: string) => void;
   onDisconnect?: (code: number, reason: string) => void;
   onReconnect?: () => void;
@@ -297,7 +237,7 @@ interface SessionGatewayEventHandlers {
   }) => void;
   onPortOpened?: (port: number, protocol: string, processName?: string) => void;
   onPortClosed?: (port: number) => void;
-  onAgentEvent?: (channel: string, data: unknown, seq?: number) => void;
+  onAgentEvent?: (channel: string, data: unknown, sequenceId?: number) => void;
   onError?: (message: string, code?: string) => void;
   onStateChange?: (state: ConnectionState) => void;
   onMetricsChange?: (metrics: ConnectionMetrics) => void;
@@ -330,11 +270,11 @@ interface SessionGatewayClientConfig {
   token: string;
   /** Callback to refresh the token when it's about to expire */
   onTokenRefresh?: () => Promise<TokenRefreshResult>;
-  /** Browser session ID embedded in the session-scoped read token */
+  /** Session ID to connect to */
   sessionId: string;
   /** Transport mode (default: "websocket") */
   transport?: TransportMode;
-  /** Additional channels to subscribe to; server-authorized channels are used by default. */
+  /** Channels to subscribe to (default: ["*"]) */
   channels?: string[];
   /** Auto-reconnect on disconnect (default: true) */
   autoReconnect?: boolean;
@@ -362,8 +302,6 @@ interface SessionGatewayClientConfig {
   replayStorageKeyPrefix?: string;
   /** Number of latency samples to track for averaging (default: 10) */
   latencyHistorySize?: number;
-  /** Maximum wait for `connection.established` (default: 10000 ms) */
-  connectionEstablishmentTimeoutMs?: number;
   /** Event handlers */
   handlers?: SessionGatewayEventHandlers;
 }
@@ -397,13 +335,11 @@ declare class SessionGatewayClient {
   private ws;
   private readonly config;
   private readonly handlers;
-  private readonly replayStateStore;
-  private readonly tokenRefresher;
   private currentToken;
+  private isRefreshingToken;
   private state;
   private connectedAt;
   private hasConnectedBefore;
-  private connectionEstablishedForSocket;
   private lastPingAt;
   private lastPongAt;
   private lastPingSentAt;
@@ -417,7 +353,6 @@ declare class SessionGatewayClient {
   private pingInterval;
   private pongTimeout;
   private pendingCallbacks;
-  private readonly connectionWaiters;
   private messageIdCounter;
   private processedEventIds;
   private pingLatencyHistory;
@@ -452,7 +387,7 @@ declare class SessionGatewayClient {
   /**
    * Request replay of events since a timestamp.
    */
-  replay(since: number): Promise<void>;
+  replay(since: number): void;
   /**
    * Send terminal input via WebSocket.
    */
@@ -488,18 +423,14 @@ declare class SessionGatewayClient {
   getToken(): string;
   private setState;
   private handleOpen;
-  private handleConnectionEstablished;
   private handleClose;
-  private handleError;
-  private closeBeforeEstablishment;
   private handleMessage;
   private handlePong;
   private dispatchMessage;
-  private deliverMessage;
   private trackExecutionContext;
+  private handleTokenExpiring;
   private send;
   private sendWithResponse;
-  private waitForConnectionEstablished;
   private restoreSubscriptions;
   private startPingInterval;
   private stopPingInterval;
@@ -514,4 +445,4 @@ declare class SessionGatewayClient {
   private saveReplayState;
 }
 //#endregion
-export { type ClientMessage, type ConnectionMetrics, type ConnectionQuality, type ConnectionState, INITIAL_METRICS, type NormalizedServerMessage, type PortEventData, type ReplayOptions, type ReplayState, type ReplayStateStorage, type ServerMessage, SessionGatewayClient, type SessionGatewayClientConfig, type SessionGatewayEventHandlers, type SessionGatewayStats, type SubscriptionAcknowledgement, type SubscriptionDenial, type TokenRefreshResult, type TransportMode, calculateConnectionQuality };
+export { type ClientMessage, type ConnectionMetrics, type ConnectionQuality, type ConnectionState, INITIAL_METRICS, type PortEventData, type ReplayOptions, type ReplayState, type ReplayStateStorage, type ServerMessage, SessionGatewayClient, type SessionGatewayClientConfig, type SessionGatewayEventHandlers, type SessionGatewayStats, type TokenRefreshResult, type TransportMode, calculateConnectionQuality };