@unisphere/genie-types 1.14.0 → 1.16.0

package/index.esm.js

@@ -62,7 +62,14 @@ const chatRuntimeSettingsSchema = {
     genieServerUrl: {
       type: 'primitive',
       value: 'string',
-      optional: true
+      optional: true,
+      preferDefault: true
+    },
+    agenticServerUrl: {
+      type: 'primitive',
+      value: 'string',
+      optional: true,
+      preferDefault: true
     },
     partnerId: {
       type: 'primitive',
@@ -71,7 +78,8 @@ const chatRuntimeSettingsSchema = {
     },
     ks: {
       type: 'primitive',
-      value: 'string'
+      value: 'string',
+      optional: true
     },
     kalturaServerURI: {
       type: 'primitive',
@@ -180,7 +188,8 @@ const chatRuntimePlayerPluginSettingsSchema = {
   properties: {
     ks: {
       type: 'primitive',
-      value: 'string'
+      value: 'string',
+      optional: true
     },
     schemaVersion: {
       type: 'literal',
@@ -304,6 +313,23 @@ const chatCustomizationSchema = {
       values: ['body', 'container', 'modal'],
       optional: true
     },
+    layouts: {
+      type: 'object',
+      optional: true,
+      allowUnknownProperties: true,
+      properties: {
+        avatar: {
+          type: 'primitive',
+          value: 'boolean',
+          optional: true
+        },
+        chat: {
+          type: 'primitive',
+          value: 'boolean',
+          optional: true
+        }
+      }
+    },
     initialPage: {
       type: 'object',
       optional: true,
@@ -570,6 +596,9 @@ const genieAnswerVisualSettingsSchema = {
                       }, {
                         type: 'literal',
                         value: 'DOCUMENT'
+                      }, {
+                        type: 'literal',
+                        value: 'EXTERNAL'
                       }],
                       optional: true
                     },
@@ -996,6 +1025,12 @@ const avatarRuntimeLobbyVisualSettingsSchema = {
       value: 'string',
       optional: true
     },
+    style: {
+      type: 'object',
+      properties: {},
+      allowUnknownProperties: true,
+      optional: true
+    },
     hideStartButton: {
       type: 'primitive',
       value: 'boolean',
@@ -1304,6 +1339,11 @@ const genUiComposerToolRuntimeAvatarVisualSettingsSchema = {
       value: '1',
       optional: true
     },
+    layoutHint: {
+      type: 'primitive',
+      value: 'string',
+      optional: true
+    },
     layout: {
       type: 'object',
       optional: true,
@@ -1667,6 +1707,55 @@ const genUiComponentsToolRuntimePlayerVisualSettingsSchema = {
   }
 };
 
+const genUiComponentsToolRuntimeLoginVisualSettingsSchema = {
+  type: 'object',
+  properties: {
+    schemaVersion: {
+      type: 'literal',
+      value: '1',
+      optional: true
+    },
+    title: {
+      type: 'primitive',
+      value: 'string',
+      optional: true
+    },
+    subtitle: {
+      type: 'primitive',
+      value: 'string',
+      optional: true
+    }
+  }
+};
+
+const genUiComponentsToolRuntimeQuestionsPresetsVisualSettingsSchema = {
+  type: 'object',
+  properties: {
+    schemaVersion: {
+      type: 'literal',
+      value: '1',
+      optional: true
+    },
+    questions: {
+      type: 'array',
+      optional: true,
+      items: {
+        type: 'primitive',
+        value: 'string'
+      }
+    },
+    isTranslucent: {
+      type: 'primitive',
+      value: 'boolean',
+      optional: true
+    },
+    onSelect: {
+      type: 'function',
+      optional: true
+    }
+  }
+};
+
 const ContentGalleryToolRuntimeName = 'content-gallery-tool';
 const contentGalleryToolRuntimeSettingsSchema = {
   type: 'object',
@@ -1708,7 +1797,8 @@ const clipSchema = {
     },
     entry_id: {
       type: 'primitive',
-      value: 'string'
+      value: 'string',
+      optional: true
     },
     start_time: {
       type: 'primitive',
@@ -1720,7 +1810,8 @@ const clipSchema = {
     },
     type: {
       type: 'primitive',
-      value: 'string'
+      value: 'string',
+      optional: 'nullable'
     },
     thumbnail: {
       type: 'primitive',
@@ -1808,4 +1899,4 @@ const contentGalleryToolRuntimeAvatarVisualSettingsSchema = {
   }
 };
 
-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 };
+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, genUiComponentsToolRuntimeLoginVisualSettingsSchema, genUiComponentsToolRuntimeMarkdownVisualSettingsSchema, genUiComponentsToolRuntimePlayerVisualSettingsSchema, genUiComponentsToolRuntimeQuestionsPresetsVisualSettingsSchema, 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.14.0",
+  "version": "1.16.0",
   "author": "kaltura",
   "license": "AGPL-3.0",
   "repository": {
@@ -10,7 +10,7 @@
   "types": "./src/index.d.ts",
   "dependencies": {
     "@kaltura-sdk/rtc-core": "^1.25.2",
-    "@unisphere/core": "^1.94.1",
+    "@unisphere/core": "^1.95.0",
     "@unisphere/runtime": "^1.91.0"
   },
   "module": "./index.esm.js",

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

@@ -223,6 +223,7 @@ export interface AvatarServiceType extends UnisphereService {
     } | null>;
     threadId: TinyDataStoreConsumer<string | null>;
     setThreadId(id: string | null): void;
+    isPreviewMode: TinyDataStoreConsumer<boolean>;
     connect(options?: {
         threadId?: string;
         messageId?: string;

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

@@ -37,6 +37,8 @@ export interface AvatarRuntimeLobbyVisualSettings {
     agentButtonLabel?: string;
     /** Agent variant only: size (width and height) of the card, e.g. '15rem' */
     agentSize?: string;
+    /** Inline styles applied to the root container of any variant */
+    style?: Record<string, string | number>;
     /** Hide the start conversation button (e.g. when interaction limit is exceeded) */
     hideStartButton?: boolean;
 }

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

@@ -22,6 +22,8 @@ export type AvatarRuntime = UnisphereRuntimeBaseType<AvatarRuntimeSettings> & {
     threadId: TinyDataStoreConsumer<string | null>;
     /** Set the active conversation thread ID */
     setThreadId(id: string | null): void;
+    /** Sync preview mode flag from the chat customization settings */
+    setIsPreviewMode(value: boolean): void;
 };
 /**
  * Configuration settings for the avatar runtime.

package/src/lib/chat-runtime/runtime-flavors/runtime-player-plugin-types.d.ts

@@ -46,7 +46,7 @@ export interface ChatRuntimePlayerPluginSettings {
     /** Media entry ID for the video being played */
     entryId: string;
     /** Kaltura session token for authentication */
-    ks: string;
+    ks?: string;
     /** Kaltura partner ID */
     partnerId?: string;
     /** Settings schema version */

package/src/lib/chat-runtime/runtime-flavors/runtime-types.d.ts

@@ -52,13 +52,15 @@ export interface ChatRuntime extends UnisphereRuntimeBaseType<ChatRuntimeSetting
  */
 export interface ChatRuntimeSettings {
     /** Kaltura session token for authentication */
-    ks: string;
+    ks?: string;
     /** Optional initial question to display when chat starts */
     initialQuestion?: string;
     /** Settings schema version, defaults to '1' */
     schemaVersion?: '1';
     /** Genie server URL for API requests */
     genieServerUrl?: string;
+    /** Agentic server URL for appInit */
+    agenticServerUrl?: string;
     /** Kaltura partner ID */
     partnerId?: string;
     /** Media entry ID for context-aware chat */

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

@@ -2,10 +2,10 @@ import { ValidatorSchema } from '@unisphere/core';
 export interface VideoClip {
     start_index: number;
     last_index: number;
-    entry_id: string;
+    entry_id: string | null;
     start_time: number;
     end_time: number;
-    type: string;
+    type: string | null;
     thumbnail: string | null;
     video_link: string | null;
 }

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

@@ -2,3 +2,5 @@ export * from './runtime-types';
 export * from './card-visual-types';
 export * from './markdown-visual-types';
 export * from './player-visual-types';
+export * from './login-visual-types';
+export * from './questions-presets-visual-types';

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

@@ -0,0 +1,9 @@
+import { ValidatorSchema } from '@unisphere/core';
+export interface GenUiComponentsToolRuntimeLoginVisualSettings {
+    schemaVersion?: string;
+    title?: string;
+    subtitle?: string;
+    isTranslucent?: boolean;
+    onLogin?: (username: string) => void;
+}
+export declare const genUiComponentsToolRuntimeLoginVisualSettingsSchema: ValidatorSchema;

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

@@ -0,0 +1,9 @@
+import { ValidatorSchema } from '@unisphere/core';
+export interface GenUiComponentsToolRuntimeQuestionsPresetsVisualSettings {
+    schemaVersion?: string;
+    questions?: string[];
+    isTranslucent?: boolean;
+    /** Injected at render time by the runtime — not provided by the LLM. */
+    onSelect?: (question: string) => void;
+}
+export declare const genUiComponentsToolRuntimeQuestionsPresetsVisualSettingsSchema: ValidatorSchema;

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

@@ -44,6 +44,7 @@ export interface UnisphereRuntimeConfig {
 }
 export interface GenUiComposerToolRuntimeAvatarVisualSettings {
     schemaVersion?: string;
+    layoutHint?: string;
     layout?: GridLayout;
 }
 export declare const genUiComposerToolRuntimeAvatarVisualSettingsSchema: ValidatorSchema;

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

@@ -81,6 +81,11 @@ export interface ChatCustomization {
         /** Background image configuration */
         background?: Background;
     };
+    /** Layout options for the chat interface */
+    layouts?: {
+        avatar?: boolean;
+        chat?: boolean;
+    };
 }
 /**
  * Suggested question for initial chat page.
@@ -116,4 +121,5 @@ export type Background = {
     /** Image URL */
     url: string;
 };
+export type ConfiguredCustomizationValues = Pick<ChatCustomization, 'layouts' | 'initialPage'>;
 export declare const chatCustomizationSchema: ValidatorSchema;

package/src/lib/types.d.ts

@@ -57,7 +57,7 @@ export type CardsVideoDataType = {
     /** Kaltura entry ID */
     entry_id?: string;
     /** Source type */
-    type?: 'CAPTION' | 'OCR' | 'DOCUMENT';
+    type?: 'CAPTION' | 'OCR' | 'DOCUMENT' | 'EXTERNAL';
     /** Last index */
     last_index?: number;
     /** Start index */