@simfinity/constellation-client 1.0.7 → 1.0.9

package/dist/index.cjs

@@ -31,26 +31,62 @@ var WebClient = class {
     this.sessionId = null;
     this.config = config;
   }
+  /**
+   * Retrieve the list of available tools:
+   * Tools, or functions, can be exposed to & added to the model's context, allowing it
+   * to use them during the session as part of its response creation process. In order to add
+   * a tool to the session context, it must be listed (by name) at session creation time
+   * (see startSession(...) function)
+   *
+   * @remarks
+   * Tools are remote functions exposed by MCP servers and integrated by the constellation server
+   *
+   * @exception
+   * This method throws new Error(...) if unable to execute successfully for any reason.
+   */
+  async fetchAvailableTools() {
+    const response = await fetch(`${this.config.sessionEndpoint}/available_tools`, {
+      method: "GET",
+      headers: {
+        "Authorization": `Bearer ${this.config.key}`,
+        "Content-Type": "application/json",
+        "Accept": "application/json"
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`Could not fetch the list of available tools
+[${response.status}:${response.statusText}]`);
+    }
+    try {
+      const result = await response.json();
+      return result != null ? result : [];
+    } catch (error) {
+      throw `Failed to read session create response: ${error}`;
+    }
+  }
   /**
    * Start a persistent chat room on the server, allowing for re-connection,
    * when the streaming connection is lost. Once a session was started it must
    * be closed to release the context on server side. See endSession().
    *
    * @remarks
-   * A session MUST exist to connect the stream.
+   * A session MUST exist first in order to connect the stream next.
    *
-   * @param instructions to the model, added to its context. This is the "system" input instructions.
-   * @param audio whether to allow audio streaming or text-only
+   * @param audioEnabled whether this session can receive & produce audio as well as text
+   * @param voiceName LLM specific voice name e.g. with OpenAI this could be 'alloy'
+   * @param tools a list of tool names to be included in this session. These must be matching the
+   *              names returned by 'fetchAvailableTools()'.
    *
    * @exception
    * This method throws new Error(...) if unable to execute successfully for any reason.
-   *
-   * @example
-   * ```TypeScript
-   * await startSession("You are useful assistant", true)
-   * ```
    */
-  async startSession(instructions = "", audio = false) {
+  async startSession(audioEnabled, voiceName, tools = []) {
+    const prepareBody = {
+      llmProvider: this.config.llm,
+      audioEnabled,
+      voiceName,
+      includeTools: tools
+    };
     const response = await fetch(`${this.config.sessionEndpoint}/prepare_session`, {
       method: "POST",
       headers: {
@@ -58,11 +94,7 @@ var WebClient = class {
         "Content-Type": "application/json",
         "Accept": "application/json"
       },
-      body: JSON.stringify({
-        llmProvider: this.config.llm,
-        systemPrompt: instructions,
-        audio
-      })
+      body: JSON.stringify(prepareBody)
     });
     if (!response.ok) {
       throw new Error(`Could not create a new chat session
@@ -116,7 +148,7 @@ var WebClient = class {
    * This method not only opens a websocket connection with the server but also initiates a
    * handshake, where the server explicitly acknowledges and accepts the client connection.
    *
-   * @param audio for a session that created with audio capabilities, allows this streaming to include audio
+   * @param audio for an audio-enabled session, request this streaming connection to include audio events
    * @param handlers callback functions to handle every possible communication events coming from the server
    *
    * @exception
@@ -125,7 +157,7 @@ var WebClient = class {
    * @example
    * ```TypeScript
    * // Open an audio connection: in this example we choose to handle only audio data, and ignore text.
-   * await connect(true, {
+   * await joinSession(true, {
    *     onStreamClosed: (reason: string) => { console.log("Stream connection lost"); },
    *     onAudioResponseStart: () => { console.log("The model is talking"); },
    *     onAudioResponseChunk: (audioChunk: string) => { audioPlayer.enqueue(audioChunk); },
@@ -187,7 +219,7 @@ var WebClient = class {
     this.ws = ws;
   }
   /**
-   * With an opened streaming connection: send a "system" update of the session settings.
+   * Once a session is joined: send a "system" update of the session settings.
    * Allows to change some behavioral parameters like the temperature or system instructions.
    * This does not trigger a model response.
    *
@@ -195,16 +227,16 @@ var WebClient = class {
    * With openai for example, this triggers (pseudo-code):
    * webSocket.send({ type: "session.update", session: { ... }})
    *
-   * @param settings complete definition of the settings. Same values must be re-provided for unchanged parameters.
+   * @param settings new system settings to apply. Omitted values will remain unchanged
    *
    * @exception
    * This method throws new Error(...) if unable to execute successfully for any reason.
    */
-  async configureSession(settings) {
+  configureSession(settings) {
     this.send("session.configure", settings);
   }
   /**
-   * With an opened streaming connection: send a text input message to the LLM. This will trigger a
+   * Once a session is joined: send a text input message to the LLM. This will trigger a
    * text response as well as an audio response if the session was opened with audio mode active.
    *
    * @remarks
@@ -221,7 +253,7 @@ var WebClient = class {
     this.send("text.input.message", { text });
   }
   /**
-   * With an opened streaming connection: send a chunk of raw audio data to the LLM.
+   * Once a session is joined: send a chunk of raw audio data to the LLM.
    * Audio data chunks do not systematically & immediately trigger a model response:
    * They get accumulated by the model to form a single input message, until:
    * - commitAudioChunksSent is called, which flushes the accumulated audio and triggers a response
@@ -240,8 +272,8 @@ var WebClient = class {
     this.send("audio.input.append", { audioData: chunk });
   }
   /**
-   * With an opened streaming connection: triggers the processing of the accumulated audio data since
-   * the last model response. This effectively flushes the audio buffer and triggers a new model response.
+   * Once a session is joined: triggers the processing of the accumulated audio data since
+   * the last model response. This effectively flushes the audio buffer and triggers a model response.
    *
    * @remarks
    * With openai for example, this triggers (pseudo-code):
@@ -279,14 +311,22 @@ var WebClient = class {
       ws.onopen = () => {
         const eventSubs = audio ? [0 /* Text */, 1 /* Audio */] : [0 /* Text */];
         ws.send(JSON.stringify({
-          type: "connection.request",
-          data: { subscription: eventSubs }
+          type: "connection.initiate",
+          data: {
+            subscription: eventSubs,
+            settings: {
+              audio: true,
+              voice: "alloy",
+              temperature: 0.8,
+              instructions: ""
+            }
+          }
         }));
       };
       ws.onmessage = (event) => {
         try {
           const data = JSON.parse(event.data);
-          if (data.type === "connection.accepted")
+          if (data.type === "connection.initiated")
             resolve(true);
           else
             reject(new Error(`Received unexpected event: ${data.type}`));

package/dist/index.d.cts

@@ -31,17 +31,13 @@ interface WebClientConfig {
 }
 /**
  * System settings influencing the model behavior:
- * @audio: to activate voice conversation
- * @voice: depending on the LLM solution, this is the voice name to be used in audio
  * @temperature: LLM creativity factor in 0-1 range
  * @instructions: system instructions giving context, rules and directions to guide the LLM behavior
  * @maxResponseToken: 1-4096 value, maximum number of token used for a single response. Undefined means unlimited.
  */
-interface SessionSettings {
-    audio: boolean;
-    voice: string;
-    temperature: number;
-    instructions: string;
+interface SessionConfig {
+    temperature?: number;
+    instructions?: string;
     maxResponseToken?: number;
 }
 /**
@@ -66,7 +62,7 @@ interface SessionSettings {
  */
 interface EventHandlers {
     onStreamClosed: (reason: string) => void;
-    onSessionConfigured?: (settings: SessionSettings) => void;
+    onSessionConfigured?: (settings: SessionConfig) => void;
     onAudioResponseStart?: () => void;
     onAudioResponseChunk?: (audioChunk: string) => void;
     onAudioResponseEnd?: () => void;
@@ -74,6 +70,16 @@ interface EventHandlers {
     onTranscriptResponse?: (transcript: string) => void;
     onTechnicalError?: (error: string) => void;
 }
+/**
+ * Description of an available tool that can be added to a session context.
+ * Tools included in the session context can be used by the AI model during the session.
+ * Tools (or functions) can be many things, for example a calendar manager, allowing
+ * the model to manage the user's schedule.
+ */
+interface ToolDescription {
+    name: string;
+    description: string;
+}
 /**
  * This class is a code wrapper to integrate the Simfinity constellation server.
  * The constellation server is a proxy managing streaming sessions with third party LLMs.
@@ -87,26 +93,37 @@ declare class WebClient {
     private ws;
     private sessionId;
     constructor(config: WebClientConfig);
+    /**
+     * Retrieve the list of available tools:
+     * Tools, or functions, can be exposed to & added to the model's context, allowing it
+     * to use them during the session as part of its response creation process. In order to add
+     * a tool to the session context, it must be listed (by name) at session creation time
+     * (see startSession(...) function)
+     *
+     * @remarks
+     * Tools are remote functions exposed by MCP servers and integrated by the constellation server
+     *
+     * @exception
+     * This method throws new Error(...) if unable to execute successfully for any reason.
+     */
+    fetchAvailableTools(): Promise<ToolDescription[]>;
     /**
      * Start a persistent chat room on the server, allowing for re-connection,
      * when the streaming connection is lost. Once a session was started it must
      * be closed to release the context on server side. See endSession().
      *
      * @remarks
-     * A session MUST exist to connect the stream.
+     * A session MUST exist first in order to connect the stream next.
      *
-     * @param instructions to the model, added to its context. This is the "system" input instructions.
-     * @param audio whether to allow audio streaming or text-only
+     * @param audioEnabled whether this session can receive & produce audio as well as text
+     * @param voiceName LLM specific voice name e.g. with OpenAI this could be 'alloy'
+     * @param tools a list of tool names to be included in this session. These must be matching the
+     *              names returned by 'fetchAvailableTools()'.
      *
      * @exception
      * This method throws new Error(...) if unable to execute successfully for any reason.
-     *
-     * @example
-     * ```TypeScript
-     * await startSession("You are useful assistant", true)
-     * ```
      */
-    startSession(instructions?: string, audio?: boolean): Promise<void>;
+    startSession(audioEnabled: boolean, voiceName?: string, tools?: string[]): Promise<void>;
     /**
      * Close an opened, persistent chat room, effectively killing the streaming as well if still opened.
      * If there is no active session, this method does nothing.
@@ -128,7 +145,7 @@ declare class WebClient {
      * This method not only opens a websocket connection with the server but also initiates a
      * handshake, where the server explicitly acknowledges and accepts the client connection.
      *
-     * @param audio for a session that created with audio capabilities, allows this streaming to include audio
+     * @param audio for an audio-enabled session, request this streaming connection to include audio events
      * @param handlers callback functions to handle every possible communication events coming from the server
      *
      * @exception
@@ -137,7 +154,7 @@ declare class WebClient {
      * @example
      * ```TypeScript
      * // Open an audio connection: in this example we choose to handle only audio data, and ignore text.
-     * await connect(true, {
+     * await joinSession(true, {
      *     onStreamClosed: (reason: string) => { console.log("Stream connection lost"); },
      *     onAudioResponseStart: () => { console.log("The model is talking"); },
      *     onAudioResponseChunk: (audioChunk: string) => { audioPlayer.enqueue(audioChunk); },
@@ -147,7 +164,7 @@ declare class WebClient {
      */
     joinSession(audio: boolean | undefined, handlers: EventHandlers): Promise<void>;
     /**
-     * With an opened streaming connection: send a "system" update of the session settings.
+     * Once a session is joined: send a "system" update of the session settings.
      * Allows to change some behavioral parameters like the temperature or system instructions.
      * This does not trigger a model response.
      *
@@ -155,14 +172,14 @@ declare class WebClient {
      * With openai for example, this triggers (pseudo-code):
      * webSocket.send({ type: "session.update", session: { ... }})
      *
-     * @param settings complete definition of the settings. Same values must be re-provided for unchanged parameters.
+     * @param settings new system settings to apply. Omitted values will remain unchanged
      *
      * @exception
      * This method throws new Error(...) if unable to execute successfully for any reason.
      */
-    configureSession(settings: SessionSettings): Promise<void>;
+    configureSession(settings: SessionConfig): void;
     /**
-     * With an opened streaming connection: send a text input message to the LLM. This will trigger a
+     * Once a session is joined: send a text input message to the LLM. This will trigger a
      * text response as well as an audio response if the session was opened with audio mode active.
      *
      * @remarks
@@ -177,7 +194,7 @@ declare class WebClient {
      */
     sendText(text: string): void;
     /**
-     * With an opened streaming connection: send a chunk of raw audio data to the LLM.
+     * Once a session is joined: send a chunk of raw audio data to the LLM.
      * Audio data chunks do not systematically & immediately trigger a model response:
      * They get accumulated by the model to form a single input message, until:
      * - commitAudioChunksSent is called, which flushes the accumulated audio and triggers a response
@@ -194,8 +211,8 @@ declare class WebClient {
      */
     sendAudioChunk(chunk: string): void;
     /**
-     * With an opened streaming connection: triggers the processing of the accumulated audio data since
-     * the last model response. This effectively flushes the audio buffer and triggers a new model response.
+     * Once a session is joined: triggers the processing of the accumulated audio data since
+     * the last model response. This effectively flushes the audio buffer and triggers a model response.
      *
      * @remarks
      * With openai for example, this triggers (pseudo-code):
@@ -215,4 +232,4 @@ declare class WebClient {
     private send;
 }
 
-export { type EventHandlers, type LlmType, type SessionSettings, WebClient, type WebClientConfig };
+export { type EventHandlers, type LlmType, type SessionConfig, type ToolDescription, WebClient, type WebClientConfig };

package/dist/index.d.ts

@@ -31,17 +31,13 @@ interface WebClientConfig {
 }
 /**
  * System settings influencing the model behavior:
- * @audio: to activate voice conversation
- * @voice: depending on the LLM solution, this is the voice name to be used in audio
  * @temperature: LLM creativity factor in 0-1 range
  * @instructions: system instructions giving context, rules and directions to guide the LLM behavior
  * @maxResponseToken: 1-4096 value, maximum number of token used for a single response. Undefined means unlimited.
  */
-interface SessionSettings {
-    audio: boolean;
-    voice: string;
-    temperature: number;
-    instructions: string;
+interface SessionConfig {
+    temperature?: number;
+    instructions?: string;
     maxResponseToken?: number;
 }
 /**
@@ -66,7 +62,7 @@ interface SessionSettings {
  */
 interface EventHandlers {
     onStreamClosed: (reason: string) => void;
-    onSessionConfigured?: (settings: SessionSettings) => void;
+    onSessionConfigured?: (settings: SessionConfig) => void;
     onAudioResponseStart?: () => void;
     onAudioResponseChunk?: (audioChunk: string) => void;
     onAudioResponseEnd?: () => void;
@@ -74,6 +70,16 @@ interface EventHandlers {
     onTranscriptResponse?: (transcript: string) => void;
     onTechnicalError?: (error: string) => void;
 }
+/**
+ * Description of an available tool that can be added to a session context.
+ * Tools included in the session context can be used by the AI model during the session.
+ * Tools (or functions) can be many things, for example a calendar manager, allowing
+ * the model to manage the user's schedule.
+ */
+interface ToolDescription {
+    name: string;
+    description: string;
+}
 /**
  * This class is a code wrapper to integrate the Simfinity constellation server.
  * The constellation server is a proxy managing streaming sessions with third party LLMs.
@@ -87,26 +93,37 @@ declare class WebClient {
     private ws;
     private sessionId;
     constructor(config: WebClientConfig);
+    /**
+     * Retrieve the list of available tools:
+     * Tools, or functions, can be exposed to & added to the model's context, allowing it
+     * to use them during the session as part of its response creation process. In order to add
+     * a tool to the session context, it must be listed (by name) at session creation time
+     * (see startSession(...) function)
+     *
+     * @remarks
+     * Tools are remote functions exposed by MCP servers and integrated by the constellation server
+     *
+     * @exception
+     * This method throws new Error(...) if unable to execute successfully for any reason.
+     */
+    fetchAvailableTools(): Promise<ToolDescription[]>;
     /**
      * Start a persistent chat room on the server, allowing for re-connection,
      * when the streaming connection is lost. Once a session was started it must
      * be closed to release the context on server side. See endSession().
      *
      * @remarks
-     * A session MUST exist to connect the stream.
+     * A session MUST exist first in order to connect the stream next.
      *
-     * @param instructions to the model, added to its context. This is the "system" input instructions.
-     * @param audio whether to allow audio streaming or text-only
+     * @param audioEnabled whether this session can receive & produce audio as well as text
+     * @param voiceName LLM specific voice name e.g. with OpenAI this could be 'alloy'
+     * @param tools a list of tool names to be included in this session. These must be matching the
+     *              names returned by 'fetchAvailableTools()'.
      *
      * @exception
      * This method throws new Error(...) if unable to execute successfully for any reason.
-     *
-     * @example
-     * ```TypeScript
-     * await startSession("You are useful assistant", true)
-     * ```
      */
-    startSession(instructions?: string, audio?: boolean): Promise<void>;
+    startSession(audioEnabled: boolean, voiceName?: string, tools?: string[]): Promise<void>;
     /**
      * Close an opened, persistent chat room, effectively killing the streaming as well if still opened.
      * If there is no active session, this method does nothing.
@@ -128,7 +145,7 @@ declare class WebClient {
      * This method not only opens a websocket connection with the server but also initiates a
      * handshake, where the server explicitly acknowledges and accepts the client connection.
      *
-     * @param audio for a session that created with audio capabilities, allows this streaming to include audio
+     * @param audio for an audio-enabled session, request this streaming connection to include audio events
      * @param handlers callback functions to handle every possible communication events coming from the server
      *
      * @exception
@@ -137,7 +154,7 @@ declare class WebClient {
      * @example
      * ```TypeScript
      * // Open an audio connection: in this example we choose to handle only audio data, and ignore text.
-     * await connect(true, {
+     * await joinSession(true, {
      *     onStreamClosed: (reason: string) => { console.log("Stream connection lost"); },
      *     onAudioResponseStart: () => { console.log("The model is talking"); },
      *     onAudioResponseChunk: (audioChunk: string) => { audioPlayer.enqueue(audioChunk); },
@@ -147,7 +164,7 @@ declare class WebClient {
      */
     joinSession(audio: boolean | undefined, handlers: EventHandlers): Promise<void>;
     /**
-     * With an opened streaming connection: send a "system" update of the session settings.
+     * Once a session is joined: send a "system" update of the session settings.
      * Allows to change some behavioral parameters like the temperature or system instructions.
      * This does not trigger a model response.
      *
@@ -155,14 +172,14 @@ declare class WebClient {
      * With openai for example, this triggers (pseudo-code):
      * webSocket.send({ type: "session.update", session: { ... }})
      *
-     * @param settings complete definition of the settings. Same values must be re-provided for unchanged parameters.
+     * @param settings new system settings to apply. Omitted values will remain unchanged
      *
      * @exception
      * This method throws new Error(...) if unable to execute successfully for any reason.
      */
-    configureSession(settings: SessionSettings): Promise<void>;
+    configureSession(settings: SessionConfig): void;
     /**
-     * With an opened streaming connection: send a text input message to the LLM. This will trigger a
+     * Once a session is joined: send a text input message to the LLM. This will trigger a
      * text response as well as an audio response if the session was opened with audio mode active.
      *
      * @remarks
@@ -177,7 +194,7 @@ declare class WebClient {
      */
     sendText(text: string): void;
     /**
-     * With an opened streaming connection: send a chunk of raw audio data to the LLM.
+     * Once a session is joined: send a chunk of raw audio data to the LLM.
      * Audio data chunks do not systematically & immediately trigger a model response:
      * They get accumulated by the model to form a single input message, until:
      * - commitAudioChunksSent is called, which flushes the accumulated audio and triggers a response
@@ -194,8 +211,8 @@ declare class WebClient {
      */
     sendAudioChunk(chunk: string): void;
     /**
-     * With an opened streaming connection: triggers the processing of the accumulated audio data since
-     * the last model response. This effectively flushes the audio buffer and triggers a new model response.
+     * Once a session is joined: triggers the processing of the accumulated audio data since
+     * the last model response. This effectively flushes the audio buffer and triggers a model response.
      *
      * @remarks
      * With openai for example, this triggers (pseudo-code):
@@ -215,4 +232,4 @@ declare class WebClient {
     private send;
 }
 
-export { type EventHandlers, type LlmType, type SessionSettings, WebClient, type WebClientConfig };
+export { type EventHandlers, type LlmType, type SessionConfig, type ToolDescription, WebClient, type WebClientConfig };

package/dist/index.js

@@ -5,26 +5,62 @@ var WebClient = class {
     this.sessionId = null;
     this.config = config;
   }
+  /**
+   * Retrieve the list of available tools:
+   * Tools, or functions, can be exposed to & added to the model's context, allowing it
+   * to use them during the session as part of its response creation process. In order to add
+   * a tool to the session context, it must be listed (by name) at session creation time
+   * (see startSession(...) function)
+   *
+   * @remarks
+   * Tools are remote functions exposed by MCP servers and integrated by the constellation server
+   *
+   * @exception
+   * This method throws new Error(...) if unable to execute successfully for any reason.
+   */
+  async fetchAvailableTools() {
+    const response = await fetch(`${this.config.sessionEndpoint}/available_tools`, {
+      method: "GET",
+      headers: {
+        "Authorization": `Bearer ${this.config.key}`,
+        "Content-Type": "application/json",
+        "Accept": "application/json"
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`Could not fetch the list of available tools
+[${response.status}:${response.statusText}]`);
+    }
+    try {
+      const result = await response.json();
+      return result != null ? result : [];
+    } catch (error) {
+      throw `Failed to read session create response: ${error}`;
+    }
+  }
   /**
    * Start a persistent chat room on the server, allowing for re-connection,
    * when the streaming connection is lost. Once a session was started it must
    * be closed to release the context on server side. See endSession().
    *
    * @remarks
-   * A session MUST exist to connect the stream.
+   * A session MUST exist first in order to connect the stream next.
    *
-   * @param instructions to the model, added to its context. This is the "system" input instructions.
-   * @param audio whether to allow audio streaming or text-only
+   * @param audioEnabled whether this session can receive & produce audio as well as text
+   * @param voiceName LLM specific voice name e.g. with OpenAI this could be 'alloy'
+   * @param tools a list of tool names to be included in this session. These must be matching the
+   *              names returned by 'fetchAvailableTools()'.
    *
    * @exception
    * This method throws new Error(...) if unable to execute successfully for any reason.
-   *
-   * @example
-   * ```TypeScript
-   * await startSession("You are useful assistant", true)
-   * ```
    */
-  async startSession(instructions = "", audio = false) {
+  async startSession(audioEnabled, voiceName, tools = []) {
+    const prepareBody = {
+      llmProvider: this.config.llm,
+      audioEnabled,
+      voiceName,
+      includeTools: tools
+    };
     const response = await fetch(`${this.config.sessionEndpoint}/prepare_session`, {
       method: "POST",
       headers: {
@@ -32,11 +68,7 @@ var WebClient = class {
         "Content-Type": "application/json",
         "Accept": "application/json"
       },
-      body: JSON.stringify({
-        llmProvider: this.config.llm,
-        systemPrompt: instructions,
-        audio
-      })
+      body: JSON.stringify(prepareBody)
     });
     if (!response.ok) {
       throw new Error(`Could not create a new chat session
@@ -90,7 +122,7 @@ var WebClient = class {
    * This method not only opens a websocket connection with the server but also initiates a
    * handshake, where the server explicitly acknowledges and accepts the client connection.
    *
-   * @param audio for a session that created with audio capabilities, allows this streaming to include audio
+   * @param audio for an audio-enabled session, request this streaming connection to include audio events
    * @param handlers callback functions to handle every possible communication events coming from the server
    *
    * @exception
@@ -99,7 +131,7 @@ var WebClient = class {
    * @example
    * ```TypeScript
    * // Open an audio connection: in this example we choose to handle only audio data, and ignore text.
-   * await connect(true, {
+   * await joinSession(true, {
    *     onStreamClosed: (reason: string) => { console.log("Stream connection lost"); },
    *     onAudioResponseStart: () => { console.log("The model is talking"); },
    *     onAudioResponseChunk: (audioChunk: string) => { audioPlayer.enqueue(audioChunk); },
@@ -161,7 +193,7 @@ var WebClient = class {
     this.ws = ws;
   }
   /**
-   * With an opened streaming connection: send a "system" update of the session settings.
+   * Once a session is joined: send a "system" update of the session settings.
    * Allows to change some behavioral parameters like the temperature or system instructions.
    * This does not trigger a model response.
    *
@@ -169,16 +201,16 @@ var WebClient = class {
    * With openai for example, this triggers (pseudo-code):
    * webSocket.send({ type: "session.update", session: { ... }})
    *
-   * @param settings complete definition of the settings. Same values must be re-provided for unchanged parameters.
+   * @param settings new system settings to apply. Omitted values will remain unchanged
    *
    * @exception
    * This method throws new Error(...) if unable to execute successfully for any reason.
    */
-  async configureSession(settings) {
+  configureSession(settings) {
     this.send("session.configure", settings);
   }
   /**
-   * With an opened streaming connection: send a text input message to the LLM. This will trigger a
+   * Once a session is joined: send a text input message to the LLM. This will trigger a
    * text response as well as an audio response if the session was opened with audio mode active.
    *
    * @remarks
@@ -195,7 +227,7 @@ var WebClient = class {
     this.send("text.input.message", { text });
   }
   /**
-   * With an opened streaming connection: send a chunk of raw audio data to the LLM.
+   * Once a session is joined: send a chunk of raw audio data to the LLM.
    * Audio data chunks do not systematically & immediately trigger a model response:
    * They get accumulated by the model to form a single input message, until:
    * - commitAudioChunksSent is called, which flushes the accumulated audio and triggers a response
@@ -214,8 +246,8 @@ var WebClient = class {
     this.send("audio.input.append", { audioData: chunk });
   }
   /**
-   * With an opened streaming connection: triggers the processing of the accumulated audio data since
-   * the last model response. This effectively flushes the audio buffer and triggers a new model response.
+   * Once a session is joined: triggers the processing of the accumulated audio data since
+   * the last model response. This effectively flushes the audio buffer and triggers a model response.
    *
    * @remarks
    * With openai for example, this triggers (pseudo-code):
@@ -253,14 +285,22 @@ var WebClient = class {
       ws.onopen = () => {
         const eventSubs = audio ? [0 /* Text */, 1 /* Audio */] : [0 /* Text */];
         ws.send(JSON.stringify({
-          type: "connection.request",
-          data: { subscription: eventSubs }
+          type: "connection.initiate",
+          data: {
+            subscription: eventSubs,
+            settings: {
+              audio: true,
+              voice: "alloy",
+              temperature: 0.8,
+              instructions: ""
+            }
+          }
         }));
       };
       ws.onmessage = (event) => {
         try {
           const data = JSON.parse(event.data);
-          if (data.type === "connection.accepted")
+          if (data.type === "connection.initiated")
             resolve(true);
           else
             reject(new Error(`Received unexpected event: ${data.type}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simfinity/constellation-client",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "type": "module",
   "exports": {
     ".": {