@simfinity/constellation-ui 1.0.2 → 1.0.3

package/dist/index.cjs

@@ -59,8 +59,11 @@ function useConstellationClient() {
   const ctx = (0, import_react.useContext)(ConstellationContext);
   if (!ctx) throw new Error("Must be used inside ConstellationProvider");
   return {
-    startSession: async (audio, voice) => {
-      await ctx.client.startSession(audio, voice);
+    fetchAvailableTools: async () => {
+      return await ctx.client.fetchAvailableTools();
+    },
+    startSession: async (audio, voice, tools = []) => {
+      await ctx.client.startSession(audio, voice, tools);
       ctx.setAudioEnabled(audio);
     },
     endSession: async () => {

package/dist/index.d.cts

@@ -12,8 +12,7 @@ import { WebClient } from '@simfinity/constellation-client';
  *  - useConstellationClient()
  *  - useConstellationSession()
  *
- * @param client A pre-configured WebClient instance from
- *               "@simfinity/constellation-client".
+ * @param client A pre-configured WebClient instance from "@simfinity/constellation-client".
  * @param children The DOM descendant components
  *
  * @example
@@ -83,7 +82,12 @@ declare function ConstellationProvider({ client, children, }: {
  * @returns
  * Lifecycle control methods:
  *
- * startSession(audioEnabled: boolean, voice?: string)
+ * fetchAvailableTools()
+ *   - 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[] = [])
  *   - Creates a new persistent session on the server.
  *   - Must be called before joinSession().
  *

package/dist/index.d.ts

@@ -12,8 +12,7 @@ import { WebClient } from '@simfinity/constellation-client';
  *  - useConstellationClient()
  *  - useConstellationSession()
  *
- * @param client A pre-configured WebClient instance from
- *               "@simfinity/constellation-client".
+ * @param client A pre-configured WebClient instance from "@simfinity/constellation-client".
  * @param children The DOM descendant components
  *
  * @example
@@ -83,7 +82,12 @@ declare function ConstellationProvider({ client, children, }: {
  * @returns
  * Lifecycle control methods:
  *
- * startSession(audioEnabled: boolean, voice?: string)
+ * fetchAvailableTools()
+ *   - 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[] = [])
  *   - Creates a new persistent session on the server.
  *   - Must be called before joinSession().
  *

package/dist/index.js

@@ -21,8 +21,11 @@ function useConstellationClient() {
   const ctx = useContext(ConstellationContext);
   if (!ctx) throw new Error("Must be used inside ConstellationProvider");
   return {
-    startSession: async (audio, voice) => {
-      await ctx.client.startSession(audio, voice);
+    fetchAvailableTools: async () => {
+      return await ctx.client.fetchAvailableTools();
+    },
+    startSession: async (audio, voice, tools = []) => {
+      await ctx.client.startSession(audio, voice, tools);
       ctx.setAudioEnabled(audio);
     },
     endSession: async () => {

package/package.json

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