@unisphere/genie-types 1.13.2 → 1.14.0-oauth.0

package/README.md

@@ -1,175 +1 @@
-# Unisphere - {{company-name|human-readable}} {{project-name|human-readable}}
-
-## Running The avatar
-
-The following will enable the avatar in the chat in local machine and nvq2:
-1. you can run the avatar in dev mode by using the query param `debugGenieAvatar=dev` (for qa you should use the value qa)
-2. you can also use the cmd+k - `>` and then select **Enable Avatar Mode**
-
-## Showing the debug panel for avatars
-
-It is automatically shown in avatar-dev application. 
-
-When in NVQ2, you can show the debug panel by using the query param `debugAvatarChat=true`. 
-
-## Open avatar automatically when showing the chat
-
-When in NVQ2, you can open the avatar automatically when showing the chat by using the query param `debugGenieAutoAvatar=true`. 
-
-## Develop Avatar Locally
-
-> Copy the .env file from `/unisphere/applications/avatar-dev/.env-(dev|qa)-template` to `/unisphere/applications/avatar-dev/.env` and update settings
-
-1. run `npm run dev:avatar`
-2. open the browser in http://localhost:4002/
-
-You will now use the nvq2 avatar in local development.
-
-If you would like to use the Avatar runtime, override port 8400
-
-## Develop Chat Locally
-
-> Copy the .env file from `/unisphere/applications/chat-dev/.env-template` to `/unisphere/applications/chat-dev/.env` and update settings
-
-1. run `npm run dev:chat`
-2. open the browser in http://localhost:4002/
-
-You will now use the nvq2 chat in local development.
-
-If you would like to use the Chat runtime, override port 8300
-If you would like to use the Avatar runtime, override port 8400
-
----
-
-## Overview
-
-This repository is a **Unisphere workspace** for an experience named **{{project-name|human-readable}}**.
-
-It contains everything you need to:
-- Create and publish npm / JFrog packages  
-- Bundle and version runtime artifacts  
-- Build and deploy applications  
-- Develop locally and promote changes to production  
-
-The Unisphere workspace acts as the single entry point for the entire lifecycle — from local development, through CI/CD, and all the way to production deployment.
-
-To better understand the ideas behind Unisphere and how it works, read more at:  
-https://unisphere.kaltura.com/
-
----
-
-## Prerequisites
-
-At the moment, **deploying Unisphere experiences is available only to Kaltura employees**.
-
-Before doing anything else, make sure your machine is properly configured to access:
-- Kaltura GitHub repositories  
-- Kaltura JFrog Artifactory registries  
-
-Follow the setup guide here:  
-https://unisphere.kaltura.com/docs/create/kaltura-employees/setup-machine
-
----
-
-## Add the Experience to Kaltura Github Organization
-
-Before you can deploy or activate this experience, it must be registered in Github under Kaltura Organization.
-
-This step connects your Unisphere workspace to the relevant Kaltura infrastructure and enables CI/CD, deployment, and activation flows.
-
-Follow the guide here:  
-https://unisphere.kaltura.com/docs/create/devops/create-github-repository
-
----
-
-## Create Artifacts
-
-Unisphere allows you to create and manage different types of artifacts, including:
-- Packages  
-- Runtimes  
-- Applications  
-
-Each artifact type has its own role in the ecosystem, but they all live and evolve together inside this workspace.
-
-Read more about creating artifacts here:  
-https://unisphere.kaltura.com/docs/create/overview
-
----
-
-## Deploy
-
-To deploy **packages, applications, and runtimes**, follow the deployment guide:  
-https://unisphere.kaltura.com/docs/create/devops/deploy
-
-For **applications and runtimes**, deployment is only part of the process.  
-After deployment, they must also be activated to become available in production.
-
-Activation guide:  
-https://unisphere.kaltura.com/docs/create/devops/activate
-
----
-
-## Local Development
-
-Unisphere provides a structured local development flow that mirrors production as closely as possible, while still keeping things fast and developer-friendly.
-
-This includes:
-- Local builds  
-- Watching and rebuilding artifacts  
-- Running applications in isolation or as part of a larger workspace  
-
-Read more about local development here:  
-https://unisphere.kaltura.com/docs/create/local-development
-
----
-
-## Available Commands
-
-This workspace exposes a small set of opinionated commands to help you explore, validate, and manage the experience.
-
-### Start
-Lists all available commands for each artifact in the experience, including how to build and serve runtimes, and how to spawn applications.
-
-```bash
-npm run start
-```
-
-
-### Info
-Displays information about the current workspace, including detected artifacts, configuration, and environment details.
-
-```bash
-npm run info
-```
-
-### Check
-Validates the workspace setup and verifies that all required artifacts and configurations are in place.
-
-```bash
-npm run check
-```
-
-### Reset
-Resets the workspace to a clean state. Useful when experimenting or when local state becomes inconsistent.
-
-```bash
-npm run reset
-```
-
-
----
-
-## Next Steps
-
-If this is your first time working with Unisphere, a great next step is to **create a runtime with a playground**.
-
-Follow the Hello World walkthrough here:
-[https://unisphere.kaltura.com/docs/create/overview](https://unisphere.kaltura.com/docs/create/overview)
-
-The walkthrough will guide you through:
-
-* Creating your first runtime
-* Running it locally with a playground
-* Understanding how runtimes, packages, and applications connect together
-
-This will give you a strong foundation for building and evolving the experience over time.
+# Unisphere Genie - Package Core

package/index.esm.js

@@ -267,6 +267,11 @@ const chatCustomizationSchema = {
           type: 'primitive',
           value: 'boolean',
           optional: true
+        },
+        isPreviewMode: {
+          type: 'primitive',
+          value: 'boolean',
+          optional: true
         }
       }
     },
@@ -730,6 +735,22 @@ const sourcesToolRuntimeGenieAnswerVisualSettingsSchema = {
               value: 'boolean'
             }
           }
+        }, {
+          type: 'object',
+          properties: {
+            type: {
+              type: 'literal',
+              value: 'web'
+            },
+            title: {
+              type: 'primitive',
+              value: 'string'
+            },
+            url: {
+              type: 'primitive',
+              value: 'string'
+            }
+          }
         }]
       }
     }
@@ -799,6 +820,11 @@ const avatarRuntimeSettingsSchema = {
       value: 'boolean',
       optional: true
     },
+    castMode: {
+      type: 'primitive',
+      value: 'string',
+      optional: true
+    },
     kaltura: {
       type: 'object',
       properties: {
@@ -969,6 +995,11 @@ const avatarRuntimeLobbyVisualSettingsSchema = {
       type: 'primitive',
       value: 'string',
       optional: true
+    },
+    hideStartButton: {
+      type: 'primitive',
+      value: 'boolean',
+      optional: true
     }
   }
 };
@@ -1178,7 +1209,7 @@ const kalturaVideoPlayerToolRuntimeSettingsSchema = {
   }
 };
 
-const kalturaVideoPlayerToolRuntimeGenieAnswerVisualSettingsSchema = {
+const kalturaVideoPlayerToolRuntimeAvatarVisualSettingsSchema = {
   type: 'object',
   properties: {
     id: {
@@ -1201,7 +1232,7 @@ const gtcAgendaToolRuntimeSettingsSchema = {
   }
 };
 
-const gtcAgendaToolRuntimeGenieAnswerVisualSettingsSchema = {
+const gtcAgendaToolRuntimeAvatarVisualSettingsSchema = {
   type: 'object',
   properties: {
     id: {
@@ -1224,7 +1255,7 @@ const gtcAgendaListToolRuntimeSettingsSchema = {
   }
 };
 
-const gtcAgendaListToolRuntimeGenieAnswerVisualSettingsSchema = {
+const gtcAgendaListToolRuntimeAvatarVisualSettingsSchema = {
   type: 'object',
   properties: {
     schemaVersion: {
@@ -1247,4 +1278,534 @@ const gtcAgendaListToolRuntimeGenieAnswerVisualSettingsSchema = {
   }
 };
 
-export { AdminDemoRuntimeName, AdminRuntimeName, AgentUnavailabilityReasons, AnswerModelEnum, AnswerTypeEnum, ApplicationRuntimeName, AvatarConnectionStatus, AvatarRuntimeName, AvatarStatus, ChatRuntimeName, DeviceType, DisconnectReasons, FlashcardsToolRuntimeName, FollowupsToolRuntimeName, GtcAgendaListToolRuntimeName, GtcAgendaToolRuntimeName, KalturaVideoPlayerToolRuntimeName, Nvidia2026EventToolRuntimeName, SourcesToolRuntimeName, SummaryToolRuntimeName, adminDemoRuntimeSettingsSchema, adminRuntimeSettingsSchema, applicationRuntimeSettingsSchema, avatarRuntimeAgentVisualSettingsSchema, avatarRuntimeChatVisualSettingsSchema, avatarRuntimeContainedVisualSettingsSchema, avatarRuntimeLobbyVisualSettingsSchema, avatarRuntimeSettingsSchema, bannerVisualSettingsSchema, blockVisualContextSchema, chatCustomizationSchema, chatRuntimePlayerPluginSettingsSchema, chatRuntimeSettingsSchema, flashcardsToolRuntimeSettingsSchema, followupsToolRuntimeAvatarVisualSettingsSchema, followupsToolRuntimeGenieAnswerVisualSettingsSchema, followupsToolRuntimeSettingsSchema, genieAnswerVisualSettingsSchema, getSourceUrlSchema, gtcAgendaListToolRuntimeGenieAnswerVisualSettingsSchema, gtcAgendaListToolRuntimeSettingsSchema, gtcAgendaToolRuntimeGenieAnswerVisualSettingsSchema, gtcAgendaToolRuntimeSettingsSchema, integrationsSchema, isAvatarConnectionProxyInternalType, kalturaVideoPlayerToolRuntimeGenieAnswerVisualSettingsSchema, kalturaVideoPlayerToolRuntimeSettingsSchema, nvidia2026EventToolRuntimeSettingsSchema, pageVisualSettingsSchema, popupVisualSettingsSchema, shareUrlSchema, sourcesToolRuntimeGenieAnswerVisualSettingsSchema, sourcesToolRuntimeSettingsSchema, summaryToolRuntimeGenieAnswerVisualSettingsSchema, summaryToolRuntimeSettingsSchema, widgetName };
+const GenUiComposerToolRuntimeName = 'gen-ui-composer-tool';
+const genUiComposerToolRuntimeSettingsSchema = {
+  type: 'object',
+  properties: {
+    schemaVersion: {
+      type: 'literal',
+      value: '1',
+      optional: true
+    },
+    baseVisualSettings: {
+      type: 'object',
+      optional: true,
+      properties: {},
+      allowUnknownProperties: true
+    }
+  }
+};
+
+const genUiComposerToolRuntimeAvatarVisualSettingsSchema = {
+  type: 'object',
+  properties: {
+    schemaVersion: {
+      type: 'literal',
+      value: '1',
+      optional: true
+    },
+    layout: {
+      type: 'object',
+      optional: true,
+      properties: {
+        type: {
+          type: 'literal',
+          value: 'cssGrid'
+        },
+        gridTemplateAreas: {
+          type: 'primitive',
+          value: 'string',
+          optional: true
+        },
+        gridTemplateRows: {
+          type: 'primitive',
+          value: 'string',
+          optional: true
+        },
+        gridTemplateColumns: {
+          type: 'primitive',
+          value: 'string',
+          optional: true
+        },
+        gap: {
+          type: 'primitive',
+          value: 'string',
+          optional: true
+        },
+        cells: {
+          type: 'array',
+          optional: true,
+          items: {
+            type: 'object',
+            properties: {
+              id: {
+                type: 'primitive',
+                value: 'string'
+              },
+              name: {
+                type: 'primitive',
+                value: 'string',
+                optional: true
+              },
+              width: {
+                type: 'object',
+                optional: true,
+                properties: {
+                  type: {
+                    type: 'enum',
+                    values: ['fill', 'fit', 'fixed', 'percentage', 'custom']
+                  },
+                  value: {
+                    type: 'primitive',
+                    value: 'string',
+                    optional: true
+                  }
+                }
+              },
+              rowSpan: {
+                type: 'primitive',
+                value: 'number',
+                optional: true
+              },
+              visual: {
+                type: 'object',
+                optional: true,
+                properties: {
+                  widgetName: {
+                    type: 'primitive',
+                    value: 'string'
+                  },
+                  runtimeName: {
+                    type: 'primitive',
+                    value: 'string'
+                  },
+                  visualType: {
+                    type: 'primitive',
+                    value: 'string'
+                  },
+                  visualSettings: {
+                    type: 'object',
+                    properties: {},
+                    optional: true,
+                    allowUnknownProperties: true
+                  }
+                }
+              },
+              runtime: {
+                type: 'object',
+                optional: true,
+                properties: {
+                  widgetName: {
+                    type: 'primitive',
+                    value: 'string'
+                  },
+                  runtimeName: {
+                    type: 'primitive',
+                    value: 'string'
+                  },
+                  runtimeSettings: {
+                    type: 'object',
+                    properties: {},
+                    allowUnknownProperties: true
+                  }
+                }
+              },
+              style: {
+                type: 'object',
+                properties: {},
+                optional: true,
+                allowUnknownProperties: true
+              }
+            }
+          }
+        },
+        rows: {
+          type: 'array',
+          optional: true,
+          items: {
+            type: 'object',
+            properties: {
+              id: {
+                type: 'primitive',
+                value: 'string'
+              },
+              height: {
+                type: 'object',
+                properties: {
+                  type: {
+                    type: 'enum',
+                    values: ['auto', 'fixed', 'fill', 'percentage']
+                  },
+                  value: {
+                    type: 'primitive',
+                    value: 'number',
+                    optional: true
+                  }
+                }
+              },
+              columns: {
+                type: 'primitive',
+                value: 'string'
+              },
+              cells: {
+                type: 'array',
+                items: {
+                  type: 'object',
+                  properties: {
+                    id: {
+                      type: 'primitive',
+                      value: 'string'
+                    },
+                    name: {
+                      type: 'primitive',
+                      value: 'string',
+                      optional: true
+                    },
+                    width: {
+                      type: 'object',
+                      optional: true,
+                      properties: {
+                        type: {
+                          type: 'enum',
+                          values: ['fill', 'fit', 'fixed', 'percentage', 'custom']
+                        },
+                        value: {
+                          type: 'primitive',
+                          value: 'string',
+                          optional: true
+                        }
+                      }
+                    },
+                    rowSpan: {
+                      type: 'primitive',
+                      value: 'number',
+                      optional: true
+                    },
+                    visual: {
+                      type: 'object',
+                      properties: {
+                        widgetName: {
+                          type: 'primitive',
+                          value: 'string'
+                        },
+                        runtimeName: {
+                          type: 'primitive',
+                          value: 'string'
+                        },
+                        visualType: {
+                          type: 'primitive',
+                          value: 'string'
+                        },
+                        visualSettings: {
+                          type: 'object',
+                          properties: {},
+                          optional: true,
+                          allowUnknownProperties: true
+                        }
+                      }
+                    },
+                    runtime: {
+                      type: 'object',
+                      optional: true,
+                      properties: {
+                        widgetName: {
+                          type: 'primitive',
+                          value: 'string'
+                        },
+                        runtimeName: {
+                          type: 'primitive',
+                          value: 'string'
+                        },
+                        runtimeSettings: {
+                          type: 'object',
+                          properties: {},
+                          allowUnknownProperties: true
+                        }
+                      }
+                    },
+                    style: {
+                      type: 'object',
+                      properties: {},
+                      optional: true,
+                      allowUnknownProperties: true
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+};
+
+const GenUiComponentsToolRuntimeName = 'gen-ui-components-tool';
+const genUiComponentsToolRuntimeSettingsSchema = {
+  type: 'object',
+  properties: {
+    schemaVersion: {
+      type: 'literal',
+      value: '1',
+      optional: true
+    },
+    baseVisualSettings: {
+      type: 'object',
+      optional: true,
+      properties: {},
+      allowUnknownProperties: true
+    }
+  }
+};
+
+const genUiComponentsToolRuntimeCardVisualSettingsSchema = {
+  type: 'object',
+  properties: {
+    schemaVersion: {
+      type: 'literal',
+      value: '1',
+      optional: true
+    },
+    title: {
+      type: 'primitive',
+      value: 'string',
+      optional: true
+    },
+    body: {
+      type: 'primitive',
+      value: 'string',
+      optional: true
+    },
+    loading: {
+      type: 'primitive',
+      value: 'boolean',
+      optional: true
+    },
+    isTranslucent: {
+      type: 'primitive',
+      value: 'boolean',
+      optional: true
+    },
+    action: {
+      type: 'object',
+      optional: true,
+      allowUnknownProperties: true,
+      properties: {
+        label: {
+          type: 'primitive',
+          value: 'string'
+        }
+      }
+    },
+    media: {
+      type: 'object',
+      optional: true,
+      allowUnknownProperties: true,
+      properties: {
+        type: {
+          type: 'enum',
+          values: ['image', 'video', 'kaltura']
+        }
+      }
+    }
+  }
+};
+
+const genUiComponentsToolRuntimeMarkdownVisualSettingsSchema = {
+  type: 'object',
+  properties: {
+    schemaVersion: {
+      type: 'literal',
+      value: '1',
+      optional: true
+    },
+    content: {
+      type: 'primitive',
+      value: 'string'
+    },
+    isTranslucent: {
+      type: 'primitive',
+      value: 'boolean',
+      optional: true
+    }
+  }
+};
+
+const genUiComponentsToolRuntimePlayerVisualSettingsSchema = {
+  type: 'object',
+  properties: {
+    schemaVersion: {
+      type: 'literal',
+      value: '1',
+      optional: true
+    },
+    title: {
+      type: 'primitive',
+      value: 'string',
+      optional: true
+    },
+    loading: {
+      type: 'primitive',
+      value: 'boolean',
+      optional: true
+    },
+    isTranslucent: {
+      type: 'primitive',
+      value: 'boolean',
+      optional: true
+    },
+    source: {
+      type: 'object',
+      allowUnknownProperties: true,
+      properties: {
+        type: {
+          type: 'enum',
+          values: ['native', 'kaltura']
+        }
+      }
+    }
+  }
+};
+
+const ContentGalleryToolRuntimeName = 'content-gallery-tool';
+const contentGalleryToolRuntimeSettingsSchema = {
+  type: 'object',
+  properties: {
+    schemaVersion: {
+      type: 'literal',
+      value: '1',
+      optional: true
+    },
+    kalturaServerURI: {
+      type: 'primitive',
+      value: 'string'
+    },
+    partnerId: {
+      type: 'primitive',
+      value: 'string'
+    },
+    uiConfId: {
+      type: 'primitive',
+      value: 'string'
+    },
+    ks: {
+      type: 'primitive',
+      value: 'string'
+    }
+  }
+};
+
+const clipSchema = {
+  type: 'object',
+  properties: {
+    start_index: {
+      type: 'primitive',
+      value: 'number'
+    },
+    last_index: {
+      type: 'primitive',
+      value: 'number'
+    },
+    entry_id: {
+      type: 'primitive',
+      value: 'string'
+    },
+    start_time: {
+      type: 'primitive',
+      value: 'number'
+    },
+    end_time: {
+      type: 'primitive',
+      value: 'number'
+    },
+    type: {
+      type: 'primitive',
+      value: 'string'
+    },
+    thumbnail: {
+      type: 'primitive',
+      value: 'string',
+      optional: 'nullable'
+    },
+    video_link: {
+      type: 'primitive',
+      value: 'string',
+      optional: 'nullable'
+    }
+  }
+};
+const videoSlideSchema = {
+  type: 'object',
+  properties: {
+    slide_type: {
+      type: 'literal',
+      value: 'video'
+    },
+    text: {
+      type: 'primitive',
+      value: 'string',
+      optional: 'nullable'
+    },
+    citation: {
+      type: 'object',
+      properties: {
+        clips: {
+          type: 'array',
+          items: clipSchema
+        }
+      }
+    }
+  }
+};
+const textSlideSchema = {
+  type: 'object',
+  properties: {
+    slide_type: {
+      type: 'literal',
+      value: 'text'
+    },
+    text: {
+      type: 'primitive',
+      value: 'string'
+    },
+    citation: {
+      type: 'any',
+      optional: 'nullable'
+    }
+  }
+};
+const slideSchema = {
+  type: 'or',
+  properties: [videoSlideSchema, textSlideSchema]
+};
+const contentGalleryToolRuntimeAvatarVisualSettingsSchema = {
+  type: 'object',
+  properties: {
+    schemaVersion: {
+      type: 'literal',
+      value: '1',
+      optional: true
+    },
+    slides: {
+      type: 'array',
+      items: slideSchema
+    },
+    autoplay: {
+      type: 'primitive',
+      value: 'boolean',
+      optional: true
+    },
+    slideDuration: {
+      type: 'primitive',
+      value: 'number',
+      optional: true
+    },
+    loop: {
+      type: 'primitive',
+      value: 'boolean',
+      optional: true
+    }
+  }
+};
+
+export { AdminDemoRuntimeName, AdminRuntimeName, AgentUnavailabilityReasons, AnswerModelEnum, AnswerTypeEnum, ApplicationRuntimeName, AvatarConnectionStatus, AvatarRuntimeName, AvatarStatus, ChatRuntimeName, ContentGalleryToolRuntimeName, DeviceType, DisconnectReasons, FlashcardsToolRuntimeName, FollowupsToolRuntimeName, GenUiComponentsToolRuntimeName, GenUiComposerToolRuntimeName, GtcAgendaListToolRuntimeName, GtcAgendaToolRuntimeName, KalturaVideoPlayerToolRuntimeName, Nvidia2026EventToolRuntimeName, SourcesToolRuntimeName, SummaryToolRuntimeName, adminDemoRuntimeSettingsSchema, adminRuntimeSettingsSchema, applicationRuntimeSettingsSchema, avatarRuntimeAgentVisualSettingsSchema, avatarRuntimeChatVisualSettingsSchema, avatarRuntimeContainedVisualSettingsSchema, avatarRuntimeLobbyVisualSettingsSchema, avatarRuntimeSettingsSchema, bannerVisualSettingsSchema, blockVisualContextSchema, chatCustomizationSchema, chatRuntimePlayerPluginSettingsSchema, chatRuntimeSettingsSchema, contentGalleryToolRuntimeAvatarVisualSettingsSchema, contentGalleryToolRuntimeSettingsSchema, flashcardsToolRuntimeSettingsSchema, followupsToolRuntimeAvatarVisualSettingsSchema, followupsToolRuntimeGenieAnswerVisualSettingsSchema, followupsToolRuntimeSettingsSchema, genUiComponentsToolRuntimeCardVisualSettingsSchema, genUiComponentsToolRuntimeMarkdownVisualSettingsSchema, genUiComponentsToolRuntimePlayerVisualSettingsSchema, genUiComponentsToolRuntimeSettingsSchema, genUiComposerToolRuntimeAvatarVisualSettingsSchema, genUiComposerToolRuntimeSettingsSchema, genieAnswerVisualSettingsSchema, getSourceUrlSchema, gtcAgendaListToolRuntimeAvatarVisualSettingsSchema, gtcAgendaListToolRuntimeSettingsSchema, gtcAgendaToolRuntimeAvatarVisualSettingsSchema, gtcAgendaToolRuntimeSettingsSchema, integrationsSchema, isAvatarConnectionProxyInternalType, kalturaVideoPlayerToolRuntimeAvatarVisualSettingsSchema, kalturaVideoPlayerToolRuntimeSettingsSchema, nvidia2026EventToolRuntimeSettingsSchema, pageVisualSettingsSchema, popupVisualSettingsSchema, shareUrlSchema, sourcesToolRuntimeGenieAnswerVisualSettingsSchema, sourcesToolRuntimeSettingsSchema, summaryToolRuntimeGenieAnswerVisualSettingsSchema, summaryToolRuntimeSettingsSchema, widgetName };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unisphere/genie-types",
-  "version": "1.13.2",
+  "version": "1.14.0-oauth.0",
   "author": "kaltura",
   "license": "AGPL-3.0",
   "repository": {
@@ -9,7 +9,7 @@
   },
   "types": "./src/index.d.ts",
   "dependencies": {
-    "@kaltura-corp/unisphere-rtc-core": "^1.22.1",
+    "@kaltura-sdk/rtc-core": "^1.25.2",
     "@unisphere/core": "^1.94.1",
     "@unisphere/runtime": "^1.91.0"
   },

package/src/index.d.ts

@@ -14,3 +14,6 @@ export * from './lib/nvidia-2026-event-tool-runtime';
 export * from './lib/kaltura-video-player-tool-runtime';
 export * from './lib/gtc-agenda-tool-runtime';
 export * from './lib/gtc-agenda-list-tool-runtime';
+export * from './lib/gen-ui-composer-tool-runtime';
+export * from './lib/gen-ui-components-tool-runtime';
+export * from './lib/content-gallery-tool-runtime';

package/src/lib/avatar-runtime/avatar-service-types.d.ts

@@ -1,6 +1,6 @@
 import { UnisphereService } from '@unisphere/runtime';
 import { TinyDataStoreConsumer } from '@unisphere/core';
-import { DeviceEnumerationResult } from '@kaltura-corp/unisphere-rtc-core';
+import { DeviceEnumerationResult } from '@kaltura-sdk/rtc-core';
 /**
  * Avatar service configuration.
  */
@@ -101,7 +101,7 @@ export type AgentData = {
  * Represents tool content displayed within avatar experiences, with different
  * states for loading, ready, and error conditions.
  */
-export type AvatarContentData = {
+export type AvatarContentData<TSettings = any> = {
     /** Unique content identifier */
     id: string;
     /** Associated thread ID */
@@ -120,7 +120,7 @@ export type AvatarContentData = {
     /** Content status: loading or ready */
     status: 'loading' | 'ready';
     /** Tool settings configuration */
-    settings: any;
+    settings: TSettings;
     /** Optional thread ID */
     threadId?: string;
 } | {
@@ -239,4 +239,6 @@ export interface AvatarServiceType extends UnisphereService {
     askViaText(text: string): void;
     changeDevice(deviceType: DeviceType, deviceId: string): Promise<boolean>;
     toggleMuteAudio(muted: boolean): Promise<void>;
+    joinSTV(containerId: string, sessionId: string, stvUrl: string, onConnected: () => void): Promise<void>;
+    leaveSTV(): void;
 }

package/src/lib/avatar-runtime/lobby-visual-types.d.ts

@@ -37,5 +37,7 @@ export interface AvatarRuntimeLobbyVisualSettings {
     agentButtonLabel?: string;
     /** Agent variant only: size (width and height) of the card, e.g. '15rem' */
     agentSize?: string;
+    /** Hide the start conversation button (e.g. when interaction limit is exceeded) */
+    hideStartButton?: boolean;
 }
 export declare const avatarRuntimeLobbyVisualSettingsSchema: ValidatorSchema;

package/src/lib/avatar-runtime/runtime-types.d.ts

@@ -84,6 +84,8 @@ export interface AvatarRuntimeSettings {
     agentMode?: boolean;
     /** Enable audio noise reduction for clearer audio */
     noiseReductionEnabled?: boolean;
+    /** STV cast mode for avatar streaming ('webrtc' | 'rtmp') */
+    castMode?: string;
     /** Kaltura service integration settings */
     kaltura: {
         /** Kaltura session token for authentication */

package/src/lib/content-gallery-tool-runtime/avatar-visual-types.d.ts

@@ -0,0 +1,32 @@
+import { ValidatorSchema } from '@unisphere/core';
+export interface VideoClip {
+    start_index: number;
+    last_index: number;
+    entry_id: string;
+    start_time: number;
+    end_time: number;
+    type: string;
+    thumbnail: string | null;
+    video_link: string | null;
+}
+export interface VideoSlide {
+    slide_type: 'video';
+    text: string | null;
+    citation: {
+        clips: VideoClip[];
+    };
+}
+export interface TextSlide {
+    slide_type: 'text';
+    text: string;
+    citation: null;
+}
+export type Slide = VideoSlide | TextSlide;
+export interface ContentGalleryToolRuntimeAvatarVisualSettings {
+    schemaVersion?: string;
+    slides: Slide[];
+    autoplay?: boolean;
+    slideDuration?: number;
+    loop?: boolean;
+}
+export declare const contentGalleryToolRuntimeAvatarVisualSettingsSchema: ValidatorSchema;

package/src/lib/content-gallery-tool-runtime/index.d.ts

@@ -0,0 +1,2 @@
+export * from './runtime-types';
+export * from './avatar-visual-types';

package/src/lib/content-gallery-tool-runtime/runtime-types.d.ts

@@ -0,0 +1,20 @@
+import { ValidatorSchema } from '@unisphere/core';
+import { UnisphereRuntimeBaseType } from '@unisphere/runtime';
+import { widgetName } from '../widget-types';
+export declare const ContentGalleryToolRuntimeName: "content-gallery-tool";
+export type ContentGalleryToolRuntime = UnisphereRuntimeBaseType<ContentGalleryToolRuntimeSettings> & {
+    readonly widgetName: typeof widgetName;
+    readonly runtimeName: typeof ContentGalleryToolRuntimeName;
+};
+export interface ContentGalleryToolRuntimeSettings {
+    schemaVersion?: string;
+    /** Kaltura server URI */
+    kalturaServerURI: string;
+    /** Kaltura partner ID */
+    partnerId: string;
+    /** UI configuration ID */
+    uiConfId: string;
+    /** Kaltura session token for authentication */
+    ks: string;
+}
+export declare const contentGalleryToolRuntimeSettingsSchema: ValidatorSchema;

package/src/lib/gen-ui-components-tool-runtime/card-visual-types.d.ts

@@ -0,0 +1,39 @@
+/// <reference types="react" />
+import { ValidatorSchema } from '@unisphere/core';
+export interface CardAction {
+    label: string;
+    icon?: React.ReactNode;
+    onClick: React.MouseEventHandler<HTMLButtonElement>;
+}
+export type CardMedia = {
+    type: 'image';
+    src: string;
+    alt: string;
+    placement?: 'left' | 'right';
+} | {
+    type: 'video';
+    src: string;
+    placement?: 'left' | 'right';
+    startTime?: number;
+    endTime?: number;
+} | {
+    type: 'kaltura';
+    entryId: string;
+    kalturaServerURI?: string;
+    partnerId?: string;
+    uiConfId?: string;
+    ks?: string;
+    placement?: 'left' | 'right';
+    startTime?: number;
+    endTime?: number;
+};
+export interface GenUiComponentsToolRuntimeCardVisualSettings {
+    schemaVersion?: string;
+    title?: string;
+    body?: string;
+    action?: CardAction;
+    media?: CardMedia;
+    loading?: boolean;
+    isTranslucent?: boolean;
+}
+export declare const genUiComponentsToolRuntimeCardVisualSettingsSchema: ValidatorSchema;

package/src/lib/gen-ui-components-tool-runtime/index.d.ts

@@ -0,0 +1,4 @@
+export * from './runtime-types';
+export * from './card-visual-types';
+export * from './markdown-visual-types';
+export * from './player-visual-types';

package/src/lib/gen-ui-components-tool-runtime/markdown-visual-types.d.ts

@@ -0,0 +1,7 @@
+import { ValidatorSchema } from '@unisphere/core';
+export interface GenUiComponentsToolRuntimeMarkdownVisualSettings {
+    schemaVersion?: string;
+    content: string;
+    isTranslucent?: boolean;
+}
+export declare const genUiComponentsToolRuntimeMarkdownVisualSettingsSchema: ValidatorSchema;

package/src/lib/gen-ui-components-tool-runtime/player-visual-types.d.ts

@@ -0,0 +1,25 @@
+import { ValidatorSchema } from '@unisphere/core';
+export type PlayerSource = {
+    type: 'native';
+    src: string;
+    poster?: string;
+    startTime?: number;
+    endTime?: number;
+} | {
+    type: 'kaltura';
+    entryId: string;
+    kalturaServerURI?: string;
+    partnerId?: string;
+    uiConfId?: string;
+    ks?: string;
+    startTime?: number;
+    endTime?: number;
+};
+export interface GenUiComponentsToolRuntimePlayerVisualSettings {
+    schemaVersion?: string;
+    source: PlayerSource;
+    title?: string;
+    loading?: boolean;
+    isTranslucent?: boolean;
+}
+export declare const genUiComponentsToolRuntimePlayerVisualSettingsSchema: ValidatorSchema;

package/src/lib/gen-ui-components-tool-runtime/runtime-types.d.ts

@@ -0,0 +1,13 @@
+import { ValidatorSchema } from '@unisphere/core';
+import { UnisphereRuntimeBaseType } from '@unisphere/runtime';
+import { widgetName } from '../widget-types';
+export declare const GenUiComponentsToolRuntimeName: "gen-ui-components-tool";
+export type GenUiComponentsToolRuntime = UnisphereRuntimeBaseType<GenUiComponentsToolRuntimeSettings> & {
+    readonly widgetName: typeof widgetName;
+    readonly runtimeName: typeof GenUiComponentsToolRuntimeName;
+};
+export interface GenUiComponentsToolRuntimeSettings {
+    schemaVersion?: string;
+    baseVisualSettings?: Record<string, unknown>;
+}
+export declare const genUiComponentsToolRuntimeSettingsSchema: ValidatorSchema;

package/src/lib/gen-ui-composer-tool-runtime/avatar-visual-types.d.ts

@@ -0,0 +1,49 @@
+import { ValidatorSchema } from '@unisphere/core';
+export interface RowHeight {
+    type: 'auto' | 'fixed' | 'fill' | 'percentage';
+    value?: number;
+}
+export interface CellWidth {
+    type: 'fill' | 'fit' | 'fixed' | 'percentage' | 'custom';
+    value?: string;
+}
+export interface GridRow {
+    id: string;
+    height: RowHeight;
+    columns: string;
+    cells: GridCell[];
+}
+export interface GridLayout {
+    type: 'cssGrid';
+    gridTemplateAreas?: string;
+    gridTemplateRows?: string;
+    gridTemplateColumns?: string;
+    gap?: string;
+    cells?: GridCell[];
+    rows?: GridRow[];
+}
+export interface GridCell {
+    id: string;
+    name?: string;
+    width?: CellWidth;
+    rowSpan?: number;
+    visual?: UnisphereVisualConfig;
+    runtime?: UnisphereRuntimeConfig;
+    style?: Record<string, unknown>;
+}
+export interface UnisphereVisualConfig {
+    widgetName: string;
+    runtimeName: string;
+    visualType: string;
+    visualSettings?: Record<string, unknown>;
+}
+export interface UnisphereRuntimeConfig {
+    widgetName: string;
+    runtimeName: string;
+    runtimeSettings: Record<string, unknown>;
+}
+export interface GenUiComposerToolRuntimeAvatarVisualSettings {
+    schemaVersion?: string;
+    layout?: GridLayout;
+}
+export declare const genUiComposerToolRuntimeAvatarVisualSettingsSchema: ValidatorSchema;

package/src/lib/gen-ui-composer-tool-runtime/index.d.ts

@@ -0,0 +1,2 @@
+export * from './runtime-types';
+export * from './avatar-visual-types';

package/src/lib/gen-ui-composer-tool-runtime/runtime-types.d.ts

@@ -0,0 +1,13 @@
+import { ValidatorSchema } from '@unisphere/core';
+import { UnisphereRuntimeBaseType } from '@unisphere/runtime';
+import { widgetName } from '../widget-types';
+export declare const GenUiComposerToolRuntimeName: "gen-ui-composer-tool";
+export type GenUiComposerToolRuntime = UnisphereRuntimeBaseType<GenUiComposerToolRuntimeSettings> & {
+    readonly widgetName: typeof widgetName;
+    readonly runtimeName: typeof GenUiComposerToolRuntimeName;
+};
+export interface GenUiComposerToolRuntimeSettings {
+    schemaVersion?: string;
+    baseVisualSettings?: Record<string, unknown>;
+}
+export declare const genUiComposerToolRuntimeSettingsSchema: ValidatorSchema;

package/src/lib/gtc-agenda-list-tool-runtime/genie-answer-visual-types.d.ts

@@ -4,7 +4,7 @@ import { ValidatorSchema } from '@unisphere/core';
  *
  * @example
  * ```typescript
- * const visualSettings: GtcAgendaListToolRuntimeGenieAnswerVisualSettings = {
+ * const visualSettings: GtcAgendaListToolRuntimeAvatarVisualSettings = {
  *   sessions: [
  *     { id: 'session_123' },
  *     { id: 'session_456' }
@@ -12,7 +12,7 @@ import { ValidatorSchema } from '@unisphere/core';
  * };
  * ```
  */
-export interface GtcAgendaListToolRuntimeGenieAnswerVisualSettings {
+export interface GtcAgendaListToolRuntimeAvatarVisualSettings {
     /** Settings schema version */
     schemaVersion?: string;
     /** Array of session identifiers to display */
@@ -20,4 +20,4 @@ export interface GtcAgendaListToolRuntimeGenieAnswerVisualSettings {
         id: string;
     }[];
 }
-export declare const gtcAgendaListToolRuntimeGenieAnswerVisualSettingsSchema: ValidatorSchema;
+export declare const gtcAgendaListToolRuntimeAvatarVisualSettingsSchema: ValidatorSchema;

package/src/lib/gtc-agenda-tool-runtime/genie-answer-visual-types.d.ts

@@ -4,13 +4,13 @@ import { ValidatorSchema } from '@unisphere/core';
  *
  * @example
  * ```typescript
- * const visualSettings: GtcAgendaToolRuntimeGenieAnswerVisualSettings = {
+ * const visualSettings: GtcAgendaToolRuntimeAvatarVisualSettings = {
  *   id: 'session_123'
  * };
  * ```
  */
-export interface GtcAgendaToolRuntimeGenieAnswerVisualSettings {
+export interface GtcAgendaToolRuntimeAvatarVisualSettings {
     /** Unique identifier for the agenda session */
     id: string;
 }
-export declare const gtcAgendaToolRuntimeGenieAnswerVisualSettingsSchema: ValidatorSchema;
+export declare const gtcAgendaToolRuntimeAvatarVisualSettingsSchema: ValidatorSchema;

package/src/lib/kaltura-video-player-tool-runtime/genie-answer-visual-types.d.ts

@@ -4,13 +4,13 @@ import { ValidatorSchema } from '@unisphere/core';
  *
  * @example
  * ```typescript
- * const visualSettings: KalturaVideoPlayerToolRuntimeGenieAnswerVisualSettings = {
+ * const visualSettings: KalturaVideoPlayerToolRuntimeAvatarVisualSettings = {
  *   id: 'player_123'
  * };
  * ```
  */
-export interface KalturaVideoPlayerToolRuntimeGenieAnswerVisualSettings {
+export interface KalturaVideoPlayerToolRuntimeAvatarVisualSettings {
     /** Unique identifier for the player instance */
     id: string;
 }
-export declare const kalturaVideoPlayerToolRuntimeGenieAnswerVisualSettingsSchema: ValidatorSchema;
+export declare const kalturaVideoPlayerToolRuntimeAvatarVisualSettingsSchema: ValidatorSchema;

package/src/lib/shared/chat-customizations-types.d.ts

@@ -4,6 +4,7 @@ import { AnswerTypeEnum } from '../types';
 /**
  * Chat UI customization options.
  *
+ *
  * @example
  * Basic customization:
  * ```typescript
@@ -55,6 +56,8 @@ export interface ChatCustomization {
     general?: {
         /** Use external player for media playback instead of embedded */
         useExternalPlayer?: boolean;
+        /** Indicates genie is embedded inside Kaltura Studio (preview mode) */
+        isPreviewMode?: boolean;
     };
     /** New conversation thread settings */
     newThread?: {

package/src/lib/types.d.ts

@@ -18,9 +18,17 @@ export type DocumentSourceItemType = SourceItemBaseType & {
     duration?: number | null;
 };
 /**
- * Union type for source items (video or document).
+ * Web page source item.
  */
-export type SourcesItemType = VideoSourceItemType | DocumentSourceItemType;
+export type WebSourceItemType = {
+    type: 'web';
+    title: string;
+    url: string;
+};
+/**
+ * Union type for source items (video, document, or web page).
+ */
+export type SourcesItemType = VideoSourceItemType | DocumentSourceItemType | WebSourceItemType;
 /**
  * Status values for Unisphere tools.
  */