@simfinity/constellation-ui 1.0.4 → 1.0.7

package/dist/index.cjs

@@ -43,15 +43,12 @@ var ConstellationContext = import_react.default.createContext(null);
 function ConstellationProvider({ client, children }) {
   const [sessionId, setSessionId] = (0, import_react.useState)(null);
   const [connected, setConnected] = (0, import_react.useState)(false);
-  const [audioEnabled, setAudioEnabled] = (0, import_react.useState)(false);
   const value = {
     client,
     sessionId,
     connected,
-    audioEnabled,
     setSessionId,
-    setConnected,
-    setAudioEnabled
+    setConnected
   };
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ConstellationContext.Provider, { value, children });
 }
@@ -60,11 +57,10 @@ function useConstellationClient() {
   if (!ctx) throw new Error("Must be used inside ConstellationProvider");
   return {
     supportedTools: async () => {
-      return await ctx.client.fetchAvailableTools();
+      return await ctx.client.fetchSupportedTools();
     },
-    startSession: async (audio, voice, tools = []) => {
-      await ctx.client.startSession(audio, voice, tools);
-      ctx.setAudioEnabled(audio);
+    startSession: async () => {
+      await ctx.client.startSession();
     },
     endSession: async () => {
       await ctx.client.endSession();
@@ -86,8 +82,7 @@ function useConstellationSession() {
   if (!ctx) throw new Error("Must be used inside ConstellationProvider");
   return {
     sessionId: ctx.sessionId,
-    connected: ctx.connected,
-    audioEnabled: ctx.audioEnabled
+    connected: ctx.connected
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.d.cts

@@ -25,7 +25,8 @@ import { WebClient } from '@simfinity/constellation-client';
  *   streamingEndpoint: "wss://your-stream",
  *   key: "YOUR_SECRET_KEY",
  *   llm: "openai",
- *   model: "gpt-4o-realtime-preview-2024-12-17"
+ *   model: "gpt-4o-realtime-preview-2024-12-17",
+ *   voiceEnabled: false,
  * });
  *
  * function App() {
@@ -51,16 +52,13 @@ declare function ConstellationProvider({ client, children, }: {
  *
  * IMPORTANT SESSION ORDER:
  *
- * 1) startSession(audioEnabled, voice?)
+ * 1) startSession()
  *    → Creates a persistent server-side session (REST)
  *    → A session remains alive and can be re-joined within 5 minutes of inactivity
- *    → audioEnabled makes the session capable of receiving and producing audio stream
- *    → voice is an LLM specific name of a voice e.g. for OpenAI 'alloy' is a valid value
- *    → Once a session has started, audio & voice options cannot be changed
  *
  * 2) joinSession(audioEnabled, handlers)
  *    → Opens WebSocket stream and begins event flow
- *    → audioEnabled (along with an audioEnabled session) to subscribe to audio events
+ *    → audioEnabled (along with an audioEnabled model connection) to subscribe to audio events
  *    → handlers are the callback functions to receive server events
  *
  * 3) configureSession(settings?) (optional)
@@ -82,12 +80,12 @@ declare function ConstellationProvider({ client, children, }: {
  * @returns
  * Lifecycle control methods:
  *
- * fetchAvailableTools()
+ * supportedTools()
  *   - Retrieve the list of tool names & descriptions that the server supports
  *   - Tools can be selectively added to a session at creation time
  *   - Tools included in a session are added to the model's context and available for it to use
  *
- * startSession(audioEnabled: boolean, voice?: string, tools: string[] = [])
+ * startSession()
  *   - Creates a new persistent session on the server.
  *   - Must be called before joinSession().
  *
@@ -122,8 +120,7 @@ declare function ConstellationProvider({ client, children, }: {
  *   endSession
  * } = useConstellationClient();
  *
- * await startSession(false);
- *
+ * await startSession();
  * await joinSession(false, {
  *   onStreamClosed: console.log,
  *   onTranscriptResponse: (text) => console.log(text),
@@ -143,7 +140,6 @@ declare function useConstellationClient(): any;
  * {
  *   sessionId: string | null
  *   connected: boolean
- *   audioEnabled: boolean
  * }
  *
  * sessionId
@@ -152,9 +148,6 @@ declare function useConstellationClient(): any;
  * connected
  *   - True after successful joinSession().
  *
- * audioEnabled
- *   - Reflects whether session was started in audio mode.
- *
  * @example
  * ```tsx
  * const { connected, sessionId } = useConstellationSession();

package/dist/index.d.ts

@@ -25,7 +25,8 @@ import { WebClient } from '@simfinity/constellation-client';
  *   streamingEndpoint: "wss://your-stream",
  *   key: "YOUR_SECRET_KEY",
  *   llm: "openai",
- *   model: "gpt-4o-realtime-preview-2024-12-17"
+ *   model: "gpt-4o-realtime-preview-2024-12-17",
+ *   voiceEnabled: false,
  * });
  *
  * function App() {
@@ -51,16 +52,13 @@ declare function ConstellationProvider({ client, children, }: {
  *
  * IMPORTANT SESSION ORDER:
  *
- * 1) startSession(audioEnabled, voice?)
+ * 1) startSession()
  *    → Creates a persistent server-side session (REST)
  *    → A session remains alive and can be re-joined within 5 minutes of inactivity
- *    → audioEnabled makes the session capable of receiving and producing audio stream
- *    → voice is an LLM specific name of a voice e.g. for OpenAI 'alloy' is a valid value
- *    → Once a session has started, audio & voice options cannot be changed
  *
  * 2) joinSession(audioEnabled, handlers)
  *    → Opens WebSocket stream and begins event flow
- *    → audioEnabled (along with an audioEnabled session) to subscribe to audio events
+ *    → audioEnabled (along with an audioEnabled model connection) to subscribe to audio events
  *    → handlers are the callback functions to receive server events
  *
  * 3) configureSession(settings?) (optional)
@@ -82,12 +80,12 @@ declare function ConstellationProvider({ client, children, }: {
  * @returns
  * Lifecycle control methods:
  *
- * fetchAvailableTools()
+ * supportedTools()
  *   - Retrieve the list of tool names & descriptions that the server supports
  *   - Tools can be selectively added to a session at creation time
  *   - Tools included in a session are added to the model's context and available for it to use
  *
- * startSession(audioEnabled: boolean, voice?: string, tools: string[] = [])
+ * startSession()
  *   - Creates a new persistent session on the server.
  *   - Must be called before joinSession().
  *
@@ -122,8 +120,7 @@ declare function ConstellationProvider({ client, children, }: {
  *   endSession
  * } = useConstellationClient();
  *
- * await startSession(false);
- *
+ * await startSession();
  * await joinSession(false, {
  *   onStreamClosed: console.log,
  *   onTranscriptResponse: (text) => console.log(text),
@@ -143,7 +140,6 @@ declare function useConstellationClient(): any;
  * {
  *   sessionId: string | null
  *   connected: boolean
- *   audioEnabled: boolean
  * }
  *
  * sessionId
@@ -152,9 +148,6 @@ declare function useConstellationClient(): any;
  * connected
  *   - True after successful joinSession().
  *
- * audioEnabled
- *   - Reflects whether session was started in audio mode.
- *
  * @example
  * ```tsx
  * const { connected, sessionId } = useConstellationSession();

package/dist/index.js

@@ -5,15 +5,12 @@ var ConstellationContext = React.createContext(null);
 function ConstellationProvider({ client, children }) {
   const [sessionId, setSessionId] = useState(null);
   const [connected, setConnected] = useState(false);
-  const [audioEnabled, setAudioEnabled] = useState(false);
   const value = {
     client,
     sessionId,
     connected,
-    audioEnabled,
     setSessionId,
-    setConnected,
-    setAudioEnabled
+    setConnected
   };
   return /* @__PURE__ */ jsx(ConstellationContext.Provider, { value, children });
 }
@@ -22,11 +19,10 @@ function useConstellationClient() {
   if (!ctx) throw new Error("Must be used inside ConstellationProvider");
   return {
     supportedTools: async () => {
-      return await ctx.client.fetchAvailableTools();
+      return await ctx.client.fetchSupportedTools();
     },
-    startSession: async (audio, voice, tools = []) => {
-      await ctx.client.startSession(audio, voice, tools);
-      ctx.setAudioEnabled(audio);
+    startSession: async () => {
+      await ctx.client.startSession();
     },
     endSession: async () => {
       await ctx.client.endSession();
@@ -48,8 +44,7 @@ function useConstellationSession() {
   if (!ctx) throw new Error("Must be used inside ConstellationProvider");
   return {
     sessionId: ctx.sessionId,
-    connected: ctx.connected,
-    audioEnabled: ctx.audioEnabled
+    connected: ctx.connected
   };
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simfinity/constellation-ui",
-  "version": "1.0.4",
+  "version": "1.0.7",
   "type": "module",
   "exports": {
     ".": {
@@ -25,7 +25,7 @@
   "author": "Simfinity",
   "license": "MIT",
   "dependencies": {
-    "@simfinity/constellation-client": "^1.0.9"
+    "@simfinity/constellation-client": "^1.0.11"
   },
   "devDependencies": {
     "@types/react": "^19.2.11",