@lidia.poet/sdk 0.2.1 → 0.3.1

package/README.md

@@ -5,7 +5,7 @@ A comprehensive TypeScript SDK for the Lidia API, providing type-safe access to
 ## Installation
 
 ```bash
-npm install @lidia/sdk
+npm install @lidia.poet/sdk
 ```
 
 ## Quick Start

package/dist/LidiaSDK.d.ts

@@ -1,4 +1,5 @@
 import { LidiaClient } from './client/LidiaClient';
+import { LidiaWebSocket, LidiaWebSocketConfig } from './client/LidiaWebSocket';
 import { LidiaConfig } from './types/config';
 import { LoginCredentials, AuthTokens } from './types/auth';
 import { AuthorizationService } from './services/AuthorizationService';
@@ -37,8 +38,11 @@ export declare class LidiaSDK {
     readonly users: UserService;
     readonly webSearches: WebSearchService;
     readonly workflows: WorkflowService;
+    /** WebSocket client for real-time events (available after connectWebSocket()) */
+    ws: LidiaWebSocket | null;
+    private mergedConfig;
     private authInitPromise?;
-    constructor(config: LidiaConfig);
+    constructor(config?: LidiaConfig);
     private shouldInitializeAuth;
     private mergeConfigWithEnv;
     private initializeAuthentication;
@@ -58,5 +62,12 @@ export declare class LidiaSDK {
     updateConfig(config: Partial<LidiaConfig>): void;
     /** Get the underlying HTTP client for advanced usage */
     getClient(): LidiaClient;
+    /**
+     * Connect to Lidia WebSocket for real-time events (streaming messages, document updates, etc.).
+     * Requires authentication (call login() or waitForAuthentication() first).
+     */
+    connectWebSocket(options?: Partial<Pick<LidiaWebSocketConfig, 'pingInterval' | 'reconnectDelay' | 'maxReconnectAttempts'>>): LidiaWebSocket;
+    /** Disconnect WebSocket */
+    disconnectWebSocket(): void;
 }
 //# sourceMappingURL=LidiaSDK.d.ts.map

package/dist/LidiaSDK.d.ts.map

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

package/dist/client/LidiaWebSocket.d.ts

@@ -0,0 +1,62 @@
+import { LidiaWsEvent, LidiaWsEventMap, LidiaWsAction } from '../types/ws';
+type WsListener<T> = (event: T) => void;
+type WsState = 'disconnected' | 'connecting' | 'connected';
+export interface LidiaWebSocketConfig {
+    /** WebSocket endpoint URL (wss://ws.lidiatech.ai) */
+    wsUrl: string;
+    /** JWT access token for authentication */
+    accessToken: string;
+    /** Enable debug logging */
+    debug?: boolean | undefined;
+    /** Ping interval in ms (default: 30000) */
+    pingInterval?: number | undefined;
+    /** Reconnect delay in ms (default: 2000) */
+    reconnectDelay?: number | undefined;
+    /** Max reconnect attempts (default: 10, 0 = disabled) */
+    maxReconnectAttempts?: number | undefined;
+}
+export declare class LidiaWebSocket {
+    private ws;
+    private config;
+    private state;
+    private pingTimer;
+    private reconnectTimer;
+    private reconnectAttempts;
+    private intentionalClose;
+    private listeners;
+    private wildcardListeners;
+    constructor(config: LidiaWebSocketConfig);
+    /** Current connection state */
+    getState(): WsState;
+    /** Connect to the WebSocket server */
+    connect(): void;
+    /** Disconnect from the WebSocket server */
+    disconnect(): void;
+    /** Update the access token (e.g. after refresh) */
+    updateToken(accessToken: string): void;
+    /** Subscribe to a specific event type */
+    on<A extends LidiaWsAction>(action: A, listener: WsListener<LidiaWsEventMap[A]>): () => void;
+    /** Subscribe to all events */
+    onAny(listener: WsListener<LidiaWsEvent>): () => void;
+    /** Subscribe to internal lifecycle events */
+    onState(event: '_connected' | '_disconnected' | '_error', listener: () => void): () => void;
+    /**
+     * Wait for a specific event matching a filter.
+     * Resolves with the first matching event, or rejects on timeout.
+     */
+    waitFor<A extends LidiaWsAction>(action: A, filter?: (event: LidiaWsEventMap[A]) => boolean, timeoutMs?: number): Promise<LidiaWsEventMap[A]>;
+    /**
+     * Collect streaming delta events for a specific message into an AsyncGenerator.
+     * Yields each delta text chunk and returns the full accumulated text.
+     */
+    streamMessage(conversationId: string, messageId: string, timeoutMs?: number): AsyncGenerator<string, string, undefined>;
+    private handleMessage;
+    private emit;
+    private startPing;
+    private stopPing;
+    private cleanup;
+    private scheduleReconnect;
+    private log;
+}
+export {};
+//# sourceMappingURL=LidiaWebSocket.d.ts.map

package/dist/client/LidiaWebSocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LidiaWebSocket.d.ts","sourceRoot":"","sources":["../../src/client/LidiaWebSocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3E,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AACxC,KAAK,OAAO,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,yDAAyD;IACzD,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAWD,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAAS;IAGjC,OAAO,CAAC,SAAS,CAA2C;IAC5D,OAAO,CAAC,iBAAiB,CAAuC;gBAEpD,MAAM,EAAE,oBAAoB;IAWxC,+BAA+B;IAC/B,QAAQ,IAAI,OAAO;IAInB,sCAAsC;IACtC,OAAO,IAAI,IAAI;IAyCf,2CAA2C;IAC3C,UAAU,IAAI,IAAI;IAYlB,mDAAmD;IACnD,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAUtC,yCAAyC;IACzC,EAAE,CAAC,CAAC,SAAS,aAAa,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAW5F,8BAA8B;IAC9B,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,YAAY,CAAC,GAAG,MAAM,IAAI;IAOrD,6CAA6C;IAC7C,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,eAAe,GAAG,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAY3F;;;OAGG;IACH,OAAO,CAAC,CAAC,SAAS,aAAa,EAC7B,MAAM,EAAE,CAAC,EACT,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,OAAO,EAC/C,SAAS,SAAS,GACjB,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAiB9B;;;OAGG;IACI,aAAa,CAClB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,SAAS,SAAU,GAClB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;IA6F5C,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,GAAG;CAKZ"}

package/dist/index.d.ts

@@ -7,6 +7,8 @@
  */
 export { LidiaSDK } from './LidiaSDK';
 export { LidiaClient } from './client/LidiaClient';
+export { LidiaWebSocket } from './client/LidiaWebSocket';
+export type { LidiaWebSocketConfig } from './client/LidiaWebSocket';
 export { LidiaConfig } from './types/config';
 export { AuthorizationService } from './services/AuthorizationService';
 export { CaseService } from './services/CaseService';
@@ -41,6 +43,7 @@ export * from './types/smartAnswer';
 export * from './types/user';
 export * from './types/webSearch';
 export * from './types/workflow';
+export * from './types/ws';
 export { LidiaError } from './errors/LidiaError';
 export { NetworkError } from './errors/NetworkError';
 export { ValidationError } from './errors/ValidationError';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAGpE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.esm.js

@@ -282,6 +282,312 @@ var LidiaClient = class {
   }
 };
 
+// src/client/LidiaWebSocket.ts
+var LidiaWebSocket = class {
+  constructor(config) {
+    this.ws = null;
+    this.state = "disconnected";
+    this.pingTimer = null;
+    this.reconnectTimer = null;
+    this.reconnectAttempts = 0;
+    this.intentionalClose = false;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    this.listeners = /* @__PURE__ */ new Map();
+    this.wildcardListeners = /* @__PURE__ */ new Set();
+    this.config = {
+      wsUrl: config.wsUrl,
+      accessToken: config.accessToken,
+      debug: config.debug ?? false,
+      pingInterval: config.pingInterval ?? 3e4,
+      reconnectDelay: config.reconnectDelay ?? 2e3,
+      maxReconnectAttempts: config.maxReconnectAttempts ?? 10
+    };
+  }
+  /** Current connection state */
+  getState() {
+    return this.state;
+  }
+  /** Connect to the WebSocket server */
+  connect() {
+    if (this.state !== "disconnected") return;
+    this.intentionalClose = false;
+    this.state = "connecting";
+    this.log("Connecting to", this.config.wsUrl);
+    this.ws = new WebSocket(this.config.wsUrl, [
+      "Authorization",
+      this.config.accessToken
+    ]);
+    this.ws.onopen = () => {
+      this.state = "connected";
+      this.reconnectAttempts = 0;
+      this.startPing();
+      this.log("Connected");
+      this.emit("_connected", {});
+    };
+    this.ws.onmessage = (event) => {
+      this.handleMessage(event);
+    };
+    this.ws.onclose = () => {
+      this.cleanup();
+      this.log("Disconnected");
+      this.emit("_disconnected", {});
+      if (!this.intentionalClose) {
+        this.scheduleReconnect();
+      }
+    };
+    this.ws.onerror = (error) => {
+      this.log("WebSocket error", error);
+      this.emit("_error", { error });
+    };
+  }
+  /** Disconnect from the WebSocket server */
+  disconnect() {
+    this.intentionalClose = true;
+    this.cleanup();
+    if (this.ws) {
+      this.ws.close();
+      this.ws = null;
+    }
+    this.state = "disconnected";
+  }
+  /** Update the access token (e.g. after refresh) */
+  updateToken(accessToken) {
+    this.config.accessToken = accessToken;
+    if (this.state === "connected") {
+      this.disconnect();
+      this.connect();
+    }
+  }
+  /** Subscribe to a specific event type */
+  on(action, listener) {
+    if (!this.listeners.has(action)) {
+      this.listeners.set(action, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(action).add(listener);
+    return () => {
+      var _a;
+      (_a = this.listeners.get(action)) == null ? void 0 : _a.delete(listener);
+    };
+  }
+  /** Subscribe to all events */
+  onAny(listener) {
+    this.wildcardListeners.add(listener);
+    return () => {
+      this.wildcardListeners.delete(listener);
+    };
+  }
+  /** Subscribe to internal lifecycle events */
+  onState(event, listener) {
+    const wrappedListener = listener;
+    if (!this.listeners.has(event)) {
+      this.listeners.set(event, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(event).add(wrappedListener);
+    return () => {
+      var _a;
+      (_a = this.listeners.get(event)) == null ? void 0 : _a.delete(wrappedListener);
+    };
+  }
+  /**
+   * Wait for a specific event matching a filter.
+   * Resolves with the first matching event, or rejects on timeout.
+   */
+  waitFor(action, filter, timeoutMs = 6e4) {
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        unsub();
+        reject(new Error(`Timeout waiting for event "${action}"`));
+      }, timeoutMs);
+      const unsub = this.on(action, (event) => {
+        if (!filter || filter(event)) {
+          clearTimeout(timer);
+          unsub();
+          resolve(event);
+        }
+      });
+    });
+  }
+  /**
+   * Collect streaming delta events for a specific message into an AsyncGenerator.
+   * Yields each delta text chunk and returns the full accumulated text.
+   */
+  async *streamMessage(conversationId, messageId, timeoutMs = 12e4) {
+    let accumulated = "";
+    let done = false;
+    let error = null;
+    const chunks = [];
+    let resolve = null;
+    const onChunk = () => {
+      if (resolve) {
+        resolve();
+        resolve = null;
+      }
+    };
+    const matchesMessage = (e) => e.conversationId === conversationId && e.messageId === messageId;
+    const unsubs = [
+      this.on("streaming.message.delta", (e) => {
+        if (matchesMessage(e)) {
+          chunks.push(e.eventText);
+          onChunk();
+        }
+      }),
+      this.on("streaming.message.stop", (e) => {
+        if (matchesMessage(e)) {
+          done = true;
+          onChunk();
+        }
+      }),
+      this.on("streaming.message.error", (e) => {
+        if (matchesMessage(e)) {
+          error = e.error;
+          done = true;
+          onChunk();
+        }
+      }),
+      this.on("streaming.smart_answer.delta", (e) => {
+        if (matchesMessage(e)) {
+          chunks.push(e.eventText);
+          onChunk();
+        }
+      }),
+      this.on("streaming.smart_answer.stop", (e) => {
+        if (matchesMessage(e)) {
+          done = true;
+          onChunk();
+        }
+      }),
+      this.on("streaming.smart_answer.error", (e) => {
+        if (matchesMessage(e)) {
+          error = e.eventText;
+          done = true;
+          onChunk();
+        }
+      }),
+      this.on("streaming.legal_search.message_delta", (e) => {
+        if (matchesMessage(e)) {
+          chunks.push(e.eventText);
+          onChunk();
+        }
+      }),
+      this.on("streaming.legal_search.stop", (e) => {
+        if (matchesMessage(e)) {
+          done = true;
+          onChunk();
+        }
+      }),
+      this.on("streaming.legal_search.error", (e) => {
+        if (matchesMessage(e)) {
+          done = true;
+          error = "Legal search error";
+          onChunk();
+        }
+      }),
+      this.on("conversation.message.new", (e) => {
+        if (matchesMessage(e)) {
+          done = true;
+          onChunk();
+        }
+      })
+    ];
+    const timeout = setTimeout(() => {
+      error = "Stream timeout";
+      done = true;
+      onChunk();
+    }, timeoutMs);
+    try {
+      while (!done) {
+        if (chunks.length === 0) {
+          await new Promise((r) => {
+            resolve = r;
+          });
+        }
+        while (chunks.length > 0) {
+          const chunk = chunks.shift();
+          accumulated += chunk;
+          yield chunk;
+        }
+      }
+      if (error) {
+        throw new Error(error);
+      }
+      return accumulated;
+    } finally {
+      clearTimeout(timeout);
+      unsubs.forEach((unsub) => unsub());
+    }
+  }
+  // ── Private ──────────────────────────────────────────────
+  handleMessage(event) {
+    let data;
+    try {
+      data = JSON.parse(String(event.data));
+    } catch {
+      this.log("Failed to parse WS message:", event.data);
+      return;
+    }
+    if (!data.action) return;
+    this.log("Event:", data.action);
+    const actionListeners = this.listeners.get(data.action);
+    if (actionListeners) {
+      for (const listener of actionListeners) {
+        listener(data);
+      }
+    }
+    for (const listener of this.wildcardListeners) {
+      listener(data);
+    }
+  }
+  emit(action, event) {
+    const actionListeners = this.listeners.get(action);
+    if (actionListeners) {
+      for (const listener of actionListeners) {
+        listener(event);
+      }
+    }
+  }
+  startPing() {
+    this.stopPing();
+    this.pingTimer = setInterval(() => {
+      var _a;
+      if (((_a = this.ws) == null ? void 0 : _a.readyState) === WebSocket.OPEN) {
+        this.ws.send(JSON.stringify({ action: "ping" }));
+      }
+    }, this.config.pingInterval);
+  }
+  stopPing() {
+    if (this.pingTimer) {
+      clearInterval(this.pingTimer);
+      this.pingTimer = null;
+    }
+  }
+  cleanup() {
+    this.stopPing();
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
+  }
+  scheduleReconnect() {
+    if (this.config.maxReconnectAttempts === 0) return;
+    if (this.reconnectAttempts >= this.config.maxReconnectAttempts) {
+      this.log("Max reconnect attempts reached");
+      return;
+    }
+    this.reconnectAttempts++;
+    const delay = this.config.reconnectDelay * Math.pow(2, this.reconnectAttempts - 1);
+    this.log(`Reconnecting in ${delay}ms (attempt ${this.reconnectAttempts}/${this.config.maxReconnectAttempts})`);
+    this.reconnectTimer = setTimeout(() => {
+      this.state = "disconnected";
+      this.connect();
+    }, delay);
+  }
+  log(...args) {
+    if (this.config.debug) {
+      console.log("[Lidia WS]", ...args);
+    }
+  }
+};
+
 // src/services/AuthorizationService.ts
 var AuthorizationService = class {
   // Refresh 5 minutes before expiry
@@ -875,6 +1181,11 @@ var LegisratioService = class {
 var MessageService = class {
   constructor(client) {
     this.client = client;
+    this.ws = null;
+  }
+  /** Inject WebSocket reference (called by LidiaSDK) */
+  setWebSocket(ws) {
+    this.ws = ws;
   }
   /** List messages with pagination */
   async find(params) {
@@ -909,10 +1220,45 @@ var MessageService = class {
   async getUrlRegistry(id, urlRegistryKey) {
     return this.client.get(`/messages/${id}/url-registry/${urlRegistryKey}`);
   }
+  /** Get message status (lightweight polling endpoint) */
+  async getStatus(id) {
+    return this.client.get(`/messages/${id}/status`);
+  }
   /** Export a specific message */
   async export(id, exportType, exportMedium) {
     return this.client.post(`/messages/${id}/export/${exportType}/${exportMedium}`);
   }
+  /**
+   * Create a message and stream the response via WebSocket.
+   * Yields each text chunk as it arrives. The return value is the full accumulated text.
+   *
+   * Requires an active WebSocket connection (sdk.connectWebSocket()).
+   *
+   * @example
+   * ```ts
+   * await sdk.connectWebSocket();
+   * const stream = sdk.messages.createAndStream({
+   *   conversationId: 'conv-123',
+   *   conversationType: 'smartAnswer',
+   *   message: 'What are the key terms?',
+   *   relevantDocumentIds: ['doc-1'],
+   * });
+   *
+   * for await (const chunk of stream) {
+   *   process.stdout.write(chunk);
+   * }
+   * ```
+   */
+  async *createAndStream(data, timeoutMs = 12e4) {
+    if (!this.ws) {
+      throw new Error(
+        "WebSocket not connected. Call sdk.connectWebSocket() before using createAndStream()."
+      );
+    }
+    const message = await this.create(data);
+    yield* this.ws.streamMessage(data.conversationId, message.id, timeoutMs);
+    return "";
+  }
 };
 
 // src/services/NotificationService.ts
@@ -1112,16 +1458,19 @@ var WorkflowService = class {
 var ENVIRONMENT_PRESETS = {
   ["Production" /* PRODUCTION */]: {
     baseUrl: "https://api.lidiatech.ai",
+    wsUrl: "wss://ws.lidiatech.ai",
     region: "eu-central-1",
     clientId: "10lnfbvtu9lrg1ujeemf2uk0sa"
   },
   ["Development" /* DEVELOPMENT */]: {
     baseUrl: "https://api.dev.lidiatech.ai",
+    wsUrl: "wss://ws.dev.lidiatech.ai",
     region: "eu-west-1",
     clientId: "4uep6n7bmk8o1b7hs7e5ts7u9"
   },
   ["Staging" /* STAGING */]: {
     baseUrl: "https://api.staging.lidiatech.ai",
+    wsUrl: "wss://ws.staging.lidiatech.ai",
     region: "eu-west-1",
     clientId: "5og664h80v1tv1md0fsgtmln2u"
   }
@@ -1154,8 +1503,10 @@ function isNodeEnvironment() {
 
 // src/LidiaSDK.ts
 var LidiaSDK = class {
-  constructor(config) {
-    const mergedConfig = this.mergeConfigWithEnv(config);
+  constructor(config = {}) {
+    /** WebSocket client for real-time events (available after connectWebSocket()) */
+    this.ws = null;
+    const mergedConfig = this.mergedConfig = this.mergeConfigWithEnv(config);
     this.client = new LidiaClient(mergedConfig);
     this.cases = new CaseService(this.client);
     this.conversations = new ConversationService(this.client);
@@ -1218,6 +1569,13 @@ var LidiaSDK = class {
         }
       }
     }
+    if (!mergedConfig.wsUrl) {
+      if (isNodeEnvironment()) {
+        mergedConfig.wsUrl = process.env["LIDIA_WS_URL"] ?? preset.wsUrl;
+      } else {
+        mergedConfig.wsUrl = preset.wsUrl;
+      }
+    }
     if (!mergedConfig.baseUrl) {
       mergedConfig.baseUrl = preset.baseUrl;
     }
@@ -1293,6 +1651,39 @@ var LidiaSDK = class {
   getClient() {
     return this.client;
   }
+  /**
+   * Connect to Lidia WebSocket for real-time events (streaming messages, document updates, etc.).
+   * Requires authentication (call login() or waitForAuthentication() first).
+   */
+  connectWebSocket(options) {
+    const tokens = this.getAuthTokens();
+    if (!(tokens == null ? void 0 : tokens.accessToken)) {
+      throw new Error("Cannot connect WebSocket: not authenticated. Call login() or waitForAuthentication() first.");
+    }
+    const wsUrl = this.mergedConfig.wsUrl;
+    if (!wsUrl) {
+      throw new Error("WebSocket URL not configured. Set wsUrl in config or LIDIA_WS_URL env var.");
+    }
+    if (this.ws) {
+      this.ws.disconnect();
+    }
+    this.ws = new LidiaWebSocket({
+      wsUrl,
+      accessToken: tokens.accessToken,
+      debug: this.mergedConfig.debug,
+      ...options
+    });
+    this.messages.setWebSocket(this.ws);
+    this.ws.connect();
+    return this.ws;
+  }
+  /** Disconnect WebSocket */
+  disconnectWebSocket() {
+    if (this.ws) {
+      this.ws.disconnect();
+      this.ws = null;
+    }
+  }
 };
 
 // src/types/case.ts
@@ -1366,6 +1757,8 @@ var MessageSenderType = /* @__PURE__ */ ((MessageSenderType2) => {
 })(MessageSenderType || {});
 var MessageStatus = /* @__PURE__ */ ((MessageStatus2) => {
   MessageStatus2["PROCESSING"] = "PROCESSING";
+  MessageStatus2["STREAMING"] = "STREAMING";
+  MessageStatus2["LOADING_SOURCES"] = "LOADING_SOURCES";
   MessageStatus2["DONE"] = "DONE";
   MessageStatus2["FAILED"] = "FAILED";
   MessageStatus2["CANCELED"] = "CANCELED";
@@ -1446,6 +1839,7 @@ export {
   LidiaClient,
   LidiaError,
   LidiaSDK,
+  LidiaWebSocket,
   MessageSenderType,
   MessageService,
   MessageStatus,