perso-interactive-sdk-web 1.3.4 → 1.4.0

package/dist/server/index.d.ts

@@ -1,3 +1,168 @@
+type CreateSessionIdBody = {
+    using_stf_webrtc: boolean;
+    model_style: string;
+    prompt: string;
+    document?: string;
+    background_image?: string;
+    mcp_servers?: Array<string>;
+    padding_left?: number;
+    padding_top?: number;
+    padding_height?: number;
+    llm_type?: string;
+    tts_type?: string;
+    stt_type?: string;
+    text_normalization_config?: string;
+    text_normalization_locale?: string | null;
+    stt_text_normalization_config?: string;
+    stt_text_normalization_locale?: string | null;
+};
+/**
+ * Requests a new session creation ID by POSTing the desired runtime options to
+ * the Perso backend (`/api/v1/session/`).
+ *
+ * @overload Creates a session from a SessionTemplate ID. Internally calls
+ * `getSessionTemplate` to resolve the template and maps it to the request body.
+ * @param apiServer Perso API server URL.
+ * @param apiKey API key used for authentication.
+ * @param sessionTemplateId SessionTemplate ID to resolve configuration from.
+ * @returns Session ID returned by the server.
+ * @throws {Error} If the template's `model_style.platform_type` is not `"webrtc"`.
+ * @throws {ApiError} If the template ID is invalid or API call fails.
+ */
+declare function createSessionId(apiServer: string, apiKey: string, sessionTemplateId: string): Promise<string>;
+/**
+ * @overload Creates a session from explicit runtime options.
+ * @param apiServer Perso API server URL.
+ * @param apiKey API key used for authentication.
+ * @param params Runtime options for the session.
+ * @returns Session ID returned by the server.
+ */
+declare function createSessionId(apiServer: string, apiKey: string, params: CreateSessionIdBody): Promise<string>;
+/**
+ * Retrieves the intro message for a specific prompt.
+ * @param apiServer Perso API server URL.
+ * @param apiKey API key used for authentication.
+ * @param promptId The prompt ID to fetch intro message for.
+ * @returns The intro message string.
+ */
+declare const getIntroMessage: (apiServer: string, apiKey: string, promptId: string) => Promise<string>;
+
+declare class ApiError extends Error {
+    errorCode: number;
+    code: string;
+    detail: string;
+    attr?: string | undefined;
+    constructor(errorCode: number, code: string, detail: string, attr?: string | undefined);
+}
+
+interface Prompt {
+    prompt_id: string;
+    name: string;
+    description?: string;
+    system_prompt: string;
+    require_document?: boolean;
+    intro_message?: string;
+}
+interface SessionCapability {
+    name: SessionCapabilityName;
+    description?: string | null;
+}
+interface Document {
+    document_id: string;
+    title: string;
+    file: string;
+    description?: string;
+    search_count?: number;
+    ef_search?: number | null;
+    processed: boolean;
+    processed_v2: boolean;
+    created_at: string;
+    updated_at: string;
+}
+interface LLMType {
+    name: string;
+    service?: string;
+}
+interface TTSType {
+    name: string;
+    streamable?: boolean;
+    service: string;
+    model?: string | null;
+    voice?: string | null;
+    voice_settings?: unknown | null;
+    style?: string | null;
+    voice_extra_data?: unknown | null;
+}
+interface STTType {
+    name: string;
+    service: string;
+    options?: unknown | null;
+}
+interface TextNormalizationConfig {
+    textnormalizationconfig_id: string;
+    name: string;
+    created_at: string;
+}
+interface ModelStyleConfig {
+    modelstyleconfig_id: string;
+    key: string;
+    value: string;
+}
+interface AIHumanModelFile {
+    name: string;
+    file?: string | null;
+}
+interface ModelStyle {
+    name: string;
+    model: string;
+    model_file?: string | null;
+    model_files: AIHumanModelFile[];
+    style: string;
+    file?: string | null;
+    platform_type?: string;
+    configs: ModelStyleConfig[];
+}
+interface BackgroundImage {
+    backgroundimage_id: string;
+    title: string;
+    image: string;
+    created_at: string;
+}
+interface MCPServer {
+    mcpserver_id: string;
+    name: string;
+    description?: string;
+    url: string;
+    transport_protocol?: string;
+    server_timeout_sec?: number;
+    extra_data?: unknown | null;
+}
+interface SessionTemplate {
+    sessiontemplate_id: string;
+    name: string;
+    description: string | null;
+    prompt: Prompt;
+    capability: SessionCapability[];
+    document: Document | null;
+    llm_type: LLMType;
+    tts_type: TTSType;
+    stt_type: STTType;
+    text_normalization_config?: TextNormalizationConfig | null;
+    text_normalization_locale?: string | null;
+    stt_text_normalization_config?: TextNormalizationConfig | null;
+    stt_text_normalization_locale?: string | null;
+    model_style: ModelStyle;
+    background_image: BackgroundImage | null;
+    agent: string | null;
+    padding_left: number | null;
+    padding_top: number | null;
+    padding_height: number | null;
+    extra_data: unknown | null;
+    mcp_servers?: MCPServer[];
+    created_at: string;
+    last_used_at: string | null;
+}
+
 declare enum SessionCapabilityName {
     LLM = "LLM",
     TTS = "TTS",
@@ -294,162 +459,73 @@ declare class PersoUtil {
     static parseJson(response: Response): Promise<any>;
 }
 
-interface Prompt {
-    prompt_id: string;
-    name: string;
-    description?: string;
-    system_prompt: string;
-    require_document?: boolean;
-    intro_message?: string;
-}
-interface SessionCapability {
-    name: SessionCapabilityName;
-    description?: string | null;
-}
-interface Document {
-    document_id: string;
-    title: string;
-    file: string;
-    description?: string;
-    search_count?: number;
-    ef_search?: number | null;
-    processed: boolean;
-    processed_v2: boolean;
-    created_at: string;
-    updated_at: string;
-}
-interface LLMType {
-    name: string;
-    service?: string;
-}
-interface TTSType {
-    name: string;
-    streamable?: boolean;
-    service: string;
-    model?: string | null;
-    voice?: string | null;
-    voice_settings?: unknown | null;
-    style?: string | null;
-    voice_extra_data?: unknown | null;
-}
-interface STTType {
-    name: string;
-    service: string;
-    options?: unknown | null;
-}
-interface TextNormalizationConfig {
-    textnormalizationconfig_id: string;
-    name: string;
-    created_at: string;
-}
-interface ModelStyleConfig {
-    modelstyleconfig_id: string;
-    key: string;
-    value: string;
-}
-interface AIHumanModelFile {
-    name: string;
-    file?: string | null;
-}
-interface ModelStyle {
-    name: string;
-    model: string;
-    model_file?: string | null;
-    model_files: AIHumanModelFile[];
-    style: string;
-    file?: string | null;
-    platform_type?: string;
-    configs: ModelStyleConfig[];
-}
-interface BackgroundImage {
-    backgroundimage_id: string;
-    title: string;
-    image: string;
-    created_at: string;
-}
-interface MCPServer {
-    mcpserver_id: string;
-    name: string;
-    description?: string;
-    url: string;
-    transport_protocol?: string;
-    server_timeout_sec?: number;
-    extra_data?: unknown | null;
-}
-interface SessionTemplate {
-    sessiontemplate_id: string;
-    name: string;
-    description: string | null;
-    prompt: Prompt;
-    capability: SessionCapability[];
-    document: Document | null;
-    llm_type: LLMType;
-    tts_type: TTSType;
-    stt_type: STTType;
-    text_normalization_config?: TextNormalizationConfig | null;
-    text_normalization_locale?: string | null;
-    model_style: ModelStyle;
-    background_image: BackgroundImage | null;
-    agent: string | null;
-    padding_left: number | null;
-    padding_top: number | null;
-    padding_height: number | null;
-    extra_data: unknown | null;
-    mcp_servers?: MCPServer[];
-    created_at: string;
-    last_used_at: string | null;
-}
-
-type CreateSessionIdBody = {
-    using_stf_webrtc: boolean;
-    model_style: string;
-    prompt: string;
-    document?: string;
-    background_image?: string;
-    mcp_servers?: Array<string>;
-    padding_left?: number;
-    padding_top?: number;
-    padding_height?: number;
-    llm_type?: string;
-    tts_type?: string;
-    stt_type?: string;
-    text_normalization_config?: string;
-    text_normalization_locale?: string | null;
-};
 /**
- * Requests a new session creation ID by POSTing the desired runtime options to
- * the Perso backend (`/api/v1/session/`).
- *
- * @overload Creates a session from a SessionTemplate ID. Internally calls
- * `getSessionTemplate` to resolve the template and maps it to the request body.
+ * Retrieves the list of available LLM providers from the API.
  * @param apiServer Perso API server URL.
  * @param apiKey API key used for authentication.
- * @param sessionTemplateId SessionTemplate ID to resolve configuration from.
- * @returns Session ID returned by the server.
- * @throws {Error} If the template's `model_style.platform_type` is not `"webrtc"`.
- * @throws {ApiError} If the template ID is invalid or API call fails.
+ * @returns Promise resolving with LLM metadata.
  */
-declare function createSessionId(apiServer: string, apiKey: string, sessionTemplateId: string): Promise<string>;
+declare function getLLMs(apiServer: string, apiKey: string): Promise<any>;
 /**
- * @overload Creates a session from explicit runtime options.
+ * Retrieves available TTS providers.
  * @param apiServer Perso API server URL.
  * @param apiKey API key used for authentication.
- * @param params Runtime options for the session.
- * @returns Session ID returned by the server.
  */
-declare function createSessionId(apiServer: string, apiKey: string, params: CreateSessionIdBody): Promise<string>;
+declare function getTTSs(apiServer: string, apiKey: string): Promise<any>;
 /**
- * Retrieves the intro message for a specific prompt.
+ * Retrieves available STT providers.
  * @param apiServer Perso API server URL.
  * @param apiKey API key used for authentication.
- * @param promptId The prompt ID to fetch intro message for.
- * @returns The intro message string.
  */
+declare function getSTTs(apiServer: string, apiKey: string): Promise<any>;
+/**
+ * Fetches avatar model styles.
+ * @param apiServer Perso API server URL.
+ * @param apiKey API key used for authentication.
+ */
+declare function getModelStyles(apiServer: string, apiKey: string): Promise<any>;
+/**
+ * Fetches preset background images.
+ * @param apiServer Perso API server URL.
+ * @param apiKey API key used for authentication.
+ */
+declare function getBackgroundImages(apiServer: string, apiKey: string): Promise<any>;
+/**
+ * Returns predefined prompt templates.
+ * @param apiServer Perso API server URL.
+ * @param apiKey API key used for authentication.
+ */
+declare function getPrompts(apiServer: string, apiKey: string): Promise<any>;
+/**
+ * Returns supporting document metadata usable by the session.
+ * @param apiServer Perso API server URL.
+ * @param apiKey API key used for authentication.
+ */
+declare function getDocuments(apiServer: string, apiKey: string): Promise<any>;
+/**
+ * Lists MCP server identifiers configured for the tenant.
+ * @param apiServer Perso API server URL.
+ * @param apiKey API key used for authentication.
+ */
+declare function getMcpServers(apiServer: string, apiKey: string): Promise<any>;
+/**
+ * Retrieves available text normalization options.
+ * @param apiServer Perso API server URL.
+ * @param apiKey API key used for authentication.
+ */
+declare function getTextNormalizations(apiServer: string, apiKey: string): Promise<any>;
+/**
+ * Downloads the ruleset data file for a Text Normalization Config.
+ * Returns a pre-signed Blob Storage URL for the CSV file.
+ * @param apiServer Perso API server URL.
+ * @param apiKey API key used for authentication.
+ * @param configId Text Normalization Config ID.
+ */
+declare function getTextNormalization(apiServer: string, apiKey: string, configId: string): Promise<TextNormalizationDownload>;
 /**
  * Retrieves the list of session templates.
  * @param apiServer Perso API server URL.
  * @param apiKey API key used for authentication.
- * @returns {Promise<SessionTemplate[]>} Array of available session templates.
  */
 declare function getSessionTemplates(apiServer: string, apiKey: string): Promise<SessionTemplate[]>;
 /**
@@ -457,19 +533,46 @@ declare function getSessionTemplates(apiServer: string, apiKey: string): Promise
  * @param apiServer Perso API server URL.
  * @param apiKey API key used for authentication.
  * @param sessionTemplateId Session Template ID.
- * @returns {Promise<SessionTemplate>} The matching session template.
- * @throws {ApiError} If the template ID is invalid or API call fails.
  */
 declare function getSessionTemplate(apiServer: string, apiKey: string, sessionTemplateId: string): Promise<SessionTemplate>;
-declare const getIntroMessage: (apiServer: string, apiKey: string, promptId: string) => Promise<string>;
-
-declare class ApiError extends Error {
-    errorCode: number;
-    code: string;
-    detail: string;
-    attr?: string | undefined;
-    constructor(errorCode: number, code: string, detail: string, attr?: string | undefined);
-}
+/**
+ * Convenience helper that fetches every dropdown-friendly resource needed to
+ * build a Perso session configuration screen in one call chain.
+ * @param apiServer Perso API server URL.
+ * @param apiKey API key used for authentication.
+ * @returns Object containing arrays for LLMs, TTS/STT types, model styles, etc.
+ */
+declare function getAllSettings(apiServer: string, apiKey: string): Promise<{
+    llms: any;
+    ttsTypes: any;
+    sttTypes: any;
+    modelStyles: any;
+    backgroundImages: any;
+    prompts: any;
+    documents: any;
+    mcpServers: any;
+    textNormalizations: any;
+}>;
+/**
+ * Sends text to the TTS API and returns Base64-encoded audio.
+ * @param apiServer Perso API server URL.
+ * @param params Session ID and text to synthesize.
+ * @returns Object with Base64 audio string.
+ */
+declare function makeTTS(apiServer: string, params: {
+    sessionId: string;
+    text: string;
+    locale?: string;
+    output_format?: string;
+}): Promise<{
+    audio: string;
+}>;
+/**
+ * Retrieves metadata for an existing session.
+ * @param apiServer Perso API server URL.
+ * @param sessionId Session id to inspect.
+ */
+declare function getSessionInfo(apiServer: string, sessionId: string): Promise<any>;
 
-export { ApiError, PersoUtil as PersoUtilServer, createSessionId, getIntroMessage, getSessionTemplate, getSessionTemplates };
+export { ApiError, PersoUtil as PersoUtilServer, createSessionId, getAllSettings, getBackgroundImages, getDocuments, getIntroMessage, getLLMs, getMcpServers, getModelStyles, getPrompts, getSTTs, getSessionInfo, getSessionTemplate, getSessionTemplates, getTTSs, getTextNormalization, getTextNormalizations, makeTTS };
 export type { SessionTemplate };

package/dist/server/index.js

@@ -1 +1 @@
-class t extends Error{errorCode;code;detail;attr;constructor(t,e,s,a){let i;i=null!=a?`${t}:${a}_${s}`:`${t}:${s}`,super(i),this.errorCode=t,this.code=e,this.detail=s,this.attr=a}}var e,s;!function(t){t.LLM="LLM",t.TTS="TTS",t.STT="STT",t.STF_ONPREMISE="STF_ONPREMISE",t.STF_WEBRTC="STF_WEBRTC"}(e||(e={})),function(t){t.SESSION_START="SESSION_START",t.SESSION_DURING="SESSION_DURING",t.SESSION_LOG="SESSION_LOG",t.SESSION_END="SESSION_END",t.SESSION_ERROR="SESSION_ERROR",t.SESSION_TTS="SESSION_TTS",t.SESSION_STT="SESSION_STT",t.SESSION_LLM="SESSION_LLM"}(s||(s={}));class a{static async getLLMs(t,e){const s=fetch(`${t}/api/v1/settings/llm_type/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),a=await s;return await this.parseJson(a)}static async getModelStyles(t,e){const s=fetch(`${t}/api/v1/settings/modelstyle/?platform_type=webrtc`,{headers:{"PersoLive-APIKey":e},method:"GET"}),a=await s;return await this.parseJson(a)}static async getBackgroundImages(t,e){const s=fetch(`${t}/api/v1/background_image/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),a=await s;return await this.parseJson(a)}static async getTTSs(t,e){const s=fetch(`${t}/api/v1/settings/tts_type/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),a=await s;return await this.parseJson(a)}static async getSTTs(t,e){const s=fetch(`${t}/api/v1/settings/stt_type/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),a=await s;return await this.parseJson(a)}static async makeTTS(t,{sessionId:e,text:s,locale:a,output_format:i}){const o={text:s};a&&(o.locale=a),i&&(o.output_format=i);const n=await fetch(`${t}/api/v1/session/${e}/tts/`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(o)});return await this.parseJson(n)}static async getPrompts(t,e){const s=fetch(`${t}/api/v1/prompt/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),a=await s;return await this.parseJson(a)}static async getDocuments(t,e){const s=fetch(`${t}/api/v1/document/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),a=await s;return await this.parseJson(a)}static async getTextNormalizations(t,e){const s=fetch(`${t}/api/v1/settings/text_normalization_config/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),a=await s;return await this.parseJson(a)}static async downloadTextNormalization(t,e,s){const a=await fetch(`${t}/api/v1/settings/text_normalization_config/${s}/download/`,{headers:{"PersoLive-APIKey":e},method:"GET"});return await this.parseJson(a)}static async getSessionTemplates(t,e){const s=await fetch(`${t}/api/v1/session_template/`,{headers:{"PersoLive-APIKey":e},method:"GET"});return await this.parseJson(s)}static async getSessionTemplate(t,e,s){const a=await fetch(`${t}/api/v1/session_template/${s}/`,{headers:{"PersoLive-APIKey":e},method:"GET"});return await this.parseJson(a)}static async getMcpServers(t,e){const s=fetch(`${t}/api/v1/settings/mcp_type/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),a=await s;return await this.parseJson(a)}static async getSessionInfo(t,e){const s=fetch(`${t}/api/v1/session/${e}/`,{method:"GET"}),a=await s;return await this.parseJson(a)}static async sessionEvent(t,e,s,a=""){const i=await fetch(`${t}/api/v1/session/${e}/event/create/`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({detail:a,event:s})});await this.parseJson(i)}static async makeSTT(t,e,s,a){const i=new FormData;i.append("audio",s),a&&i.append("language",a);const o=await fetch(`${t}/api/v1/session/${e}/stt/`,{method:"POST",body:i});return await this.parseJson(o)}static async makeLLM(e,s,a,i){const o=await fetch(`${e}/api/v1/session/${s}/llm/v2/`,{body:JSON.stringify(a),headers:{"Content-Type":"application/json"},method:"POST",signal:i});if(!o.ok){const e=await o.json(),s=e.errors?.[0]??{code:"UNKNOWN_ERROR",detail:`Server returned status ${o.status} with no error details`,attr:null};throw new t(o.status,s.code,s.detail,s.attr)}return o.body.getReader()}static async getIceServers(t,e){const s=await fetch(`${t}/api/v1/session/${e}/ice-servers/`,{method:"GET"});return(await this.parseJson(s)).ice_servers}static async exchangeSDP(t,e,s){const a=await fetch(`${t}/api/v1/session/${e}/exchange/`,{body:JSON.stringify({client_sdp:s}),headers:{"Content-Type":"application/json"},method:"POST"});return(await this.parseJson(a)).server_sdp}static async parseJson(e){const s=await e.json();if(e.ok)return s;{const a=s.errors?.[0]??{code:"UNKNOWN_ERROR",detail:`Server returned status ${e.status} with no error details`,attr:null};throw new t(e.status,a.code,a.detail,a.attr)}}}async function i(t,s,i){let o;if("string"==typeof i){const n=await a.getSessionTemplate(t,s,i);if("webrtc"!==n.model_style.platform_type)throw new Error(`SessionTemplate "${i}" uses platform_type "${n.model_style.platform_type}", but only "webrtc" is supported`);o=function(t){const s=e=>t.capability.some(t=>t.name===e);return{using_stf_webrtc:s(e.STF_WEBRTC),model_style:t.model_style.name,prompt:t.prompt.prompt_id,document:t.document?.document_id,background_image:t.background_image?.backgroundimage_id,mcp_servers:t.mcp_servers?.length?t.mcp_servers?.map(t=>t.mcpserver_id):void 0,llm_type:s(e.LLM)?t.llm_type.name:void 0,tts_type:s(e.TTS)?t.tts_type.name:void 0,stt_type:s(e.STT)?t.stt_type.name:void 0,text_normalization_config:t.text_normalization_config?.textnormalizationconfig_id,text_normalization_locale:t.text_normalization_locale,padding_left:t.padding_left??void 0,padding_top:t.padding_top??void 0,padding_height:t.padding_height??void 0}}(n)}else o=i;const n={capability:[],...o};o.using_stf_webrtc&&n.capability.push("STF_WEBRTC"),o?.llm_type&&(n.capability.push("LLM"),n.llm_type=o.llm_type),o?.tts_type&&(n.capability.push("TTS"),n.tts_type=o.tts_type),o?.stt_type&&(n.capability.push("STT"),n.stt_type=o.stt_type);const r=await fetch(`${t}/api/v1/session/`,{body:JSON.stringify(n),headers:{"PersoLive-APIKey":s,"Content-Type":"application/json"},method:"POST"});return(await a.parseJson(r)).session_id}async function o(t,e){return await a.getSessionTemplates(t,e)}async function n(t,e,s){return await a.getSessionTemplate(t,e,s)}const r=async(e,s,i)=>{try{const t=(await a.getPrompts(e,s)).find(t=>t.prompt_id===i);if(!t)throw new Error(`Prompt (${i}) not found`,{cause:404});return t.intro_message}catch(e){if(e instanceof t)throw new Error(e.detail,{cause:e.errorCode??500});throw e}};export{t as ApiError,a as PersoUtilServer,i as createSessionId,r as getIntroMessage,n as getSessionTemplate,o as getSessionTemplates};
+class t extends Error{errorCode;code;detail;attr;constructor(t,e,a,s){let n;n=null!=s?`${t}:${s}_${a}`:`${t}:${a}`,super(n),this.errorCode=t,this.code=e,this.detail=a,this.attr=s}}var e,a;!function(t){t.LLM="LLM",t.TTS="TTS",t.STT="STT",t.STF_ONPREMISE="STF_ONPREMISE",t.STF_WEBRTC="STF_WEBRTC"}(e||(e={})),function(t){t.SESSION_START="SESSION_START",t.SESSION_DURING="SESSION_DURING",t.SESSION_LOG="SESSION_LOG",t.SESSION_END="SESSION_END",t.SESSION_ERROR="SESSION_ERROR",t.SESSION_TTS="SESSION_TTS",t.SESSION_STT="SESSION_STT",t.SESSION_LLM="SESSION_LLM"}(a||(a={}));class s{static async getLLMs(t,e){const a=fetch(`${t}/api/v1/settings/llm_type/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),s=await a;return await this.parseJson(s)}static async getModelStyles(t,e){const a=fetch(`${t}/api/v1/settings/modelstyle/?platform_type=webrtc`,{headers:{"PersoLive-APIKey":e},method:"GET"}),s=await a;return await this.parseJson(s)}static async getBackgroundImages(t,e){const a=fetch(`${t}/api/v1/background_image/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),s=await a;return await this.parseJson(s)}static async getTTSs(t,e){const a=fetch(`${t}/api/v1/settings/tts_type/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),s=await a;return await this.parseJson(s)}static async getSTTs(t,e){const a=fetch(`${t}/api/v1/settings/stt_type/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),s=await a;return await this.parseJson(s)}static async makeTTS(t,{sessionId:e,text:a,locale:s,output_format:n}){const i={text:a};s&&(i.locale=s),n&&(i.output_format=n);const o=await fetch(`${t}/api/v1/session/${e}/tts/`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(i)});return await this.parseJson(o)}static async getPrompts(t,e){const a=fetch(`${t}/api/v1/prompt/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),s=await a;return await this.parseJson(s)}static async getDocuments(t,e){const a=fetch(`${t}/api/v1/document/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),s=await a;return await this.parseJson(s)}static async getTextNormalizations(t,e){const a=fetch(`${t}/api/v1/settings/text_normalization_config/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),s=await a;return await this.parseJson(s)}static async downloadTextNormalization(t,e,a){const s=await fetch(`${t}/api/v1/settings/text_normalization_config/${a}/download/`,{headers:{"PersoLive-APIKey":e},method:"GET"});return await this.parseJson(s)}static async getSessionTemplates(t,e){const a=await fetch(`${t}/api/v1/session_template/`,{headers:{"PersoLive-APIKey":e},method:"GET"});return await this.parseJson(a)}static async getSessionTemplate(t,e,a){const s=await fetch(`${t}/api/v1/session_template/${a}/`,{headers:{"PersoLive-APIKey":e},method:"GET"});return await this.parseJson(s)}static async getMcpServers(t,e){const a=fetch(`${t}/api/v1/settings/mcp_type/`,{headers:{"PersoLive-APIKey":e},method:"GET"}),s=await a;return await this.parseJson(s)}static async getSessionInfo(t,e){const a=fetch(`${t}/api/v1/session/${e}/`,{method:"GET"}),s=await a;return await this.parseJson(s)}static async sessionEvent(t,e,a,s=""){const n=await fetch(`${t}/api/v1/session/${e}/event/create/`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({detail:s,event:a})});await this.parseJson(n)}static async makeSTT(t,e,a,s){const n=new FormData;n.append("audio",a),s&&n.append("language",s);const i=await fetch(`${t}/api/v1/session/${e}/stt/`,{method:"POST",body:n});return await this.parseJson(i)}static async makeLLM(e,a,s,n){const i=await fetch(`${e}/api/v1/session/${a}/llm/v2/`,{body:JSON.stringify(s),headers:{"Content-Type":"application/json"},method:"POST",signal:n});if(!i.ok){const e=await i.json(),a=e.errors?.[0]??{code:"UNKNOWN_ERROR",detail:`Server returned status ${i.status} with no error details`,attr:null};throw new t(i.status,a.code,a.detail,a.attr)}return i.body.getReader()}static async getIceServers(t,e){const a=await fetch(`${t}/api/v1/session/${e}/ice-servers/`,{method:"GET"});return(await this.parseJson(a)).ice_servers}static async exchangeSDP(t,e,a){const s=await fetch(`${t}/api/v1/session/${e}/exchange/`,{body:JSON.stringify({client_sdp:a}),headers:{"Content-Type":"application/json"},method:"POST"});return(await this.parseJson(s)).server_sdp}static async parseJson(e){const a=await e.json();if(e.ok)return a;{const s=a.errors?.[0]??{code:"UNKNOWN_ERROR",detail:`Server returned status ${e.status} with no error details`,attr:null};throw new t(e.status,s.code,s.detail,s.attr)}}}async function n(t,e){return await s.getLLMs(t,e)}async function i(t,e){return await s.getTTSs(t,e)}async function o(t,e){return await s.getSTTs(t,e)}async function r(t,e){return await s.getModelStyles(t,e)}async function c(t,e){return await s.getBackgroundImages(t,e)}async function p(t,e){return await s.getPrompts(t,e)}async function d(t,e){return await s.getDocuments(t,e)}async function l(t,e){return await s.getMcpServers(t,e)}async function m(t,e){return await s.getTextNormalizations(t,e)}async function y(t,e,a){return await s.downloadTextNormalization(t,e,a)}async function _(t,e){return await s.getSessionTemplates(t,e)}async function S(t,e,a){return await s.getSessionTemplate(t,e,a)}async function u(t,e){const[a,s,y,_,S,u,h,T,g]=await Promise.all([n(t,e),i(t,e),o(t,e),r(t,e),c(t,e),p(t,e),d(t,e),l(t,e),m(t,e).catch(()=>[])]);return{llms:a,ttsTypes:s,sttTypes:y,modelStyles:_,backgroundImages:S,prompts:u,documents:h,mcpServers:T,textNormalizations:g}}async function h(t,e){return await s.makeTTS(t,e)}async function T(t,e){return await s.getSessionInfo(t,e)}async function g(t,a,n){let i;if("string"==typeof n){const o=await s.getSessionTemplate(t,a,n);if("webrtc"!==o.model_style.platform_type)throw new Error(`SessionTemplate "${n}" uses platform_type "${o.model_style.platform_type}", but only "webrtc" is supported`);i=function(t){const a=e=>t.capability.some(t=>t.name===e);return{using_stf_webrtc:a(e.STF_WEBRTC),model_style:t.model_style.name,prompt:t.prompt.prompt_id,document:t.document?.document_id,background_image:t.background_image?.backgroundimage_id,mcp_servers:t.mcp_servers?.length?t.mcp_servers?.map(t=>t.mcpserver_id):void 0,llm_type:a(e.LLM)?t.llm_type.name:void 0,tts_type:a(e.TTS)?t.tts_type.name:void 0,stt_type:a(e.STT)?t.stt_type.name:void 0,text_normalization_config:t.text_normalization_config?.textnormalizationconfig_id,text_normalization_locale:t.text_normalization_locale,stt_text_normalization_config:t.stt_text_normalization_config?.textnormalizationconfig_id,stt_text_normalization_locale:t.stt_text_normalization_locale,padding_left:t.padding_left??void 0,padding_top:t.padding_top??void 0,padding_height:t.padding_height??void 0}}(o)}else i=n;const o={capability:[],...i};i.using_stf_webrtc&&o.capability.push("STF_WEBRTC"),i?.llm_type&&(o.capability.push("LLM"),o.llm_type=i.llm_type),i?.tts_type&&(o.capability.push("TTS"),o.tts_type=i.tts_type),i?.stt_type&&(o.capability.push("STT"),o.stt_type=i.stt_type);const r=await fetch(`${t}/api/v1/session/`,{body:JSON.stringify(o),headers:{"PersoLive-APIKey":a,"Content-Type":"application/json"},method:"POST"});return(await s.parseJson(r)).session_id}const w=async(e,a,n)=>{try{const t=(await s.getPrompts(e,a)).find(t=>t.prompt_id===n);if(!t)throw new Error(`Prompt (${n}) not found`,{cause:404});return t.intro_message}catch(e){if(e instanceof t)throw new Error(e.detail,{cause:e.errorCode??500});throw e}};export{t as ApiError,s as PersoUtilServer,g as createSessionId,u as getAllSettings,c as getBackgroundImages,d as getDocuments,w as getIntroMessage,n as getLLMs,l as getMcpServers,r as getModelStyles,p as getPrompts,o as getSTTs,T as getSessionInfo,S as getSessionTemplate,_ as getSessionTemplates,i as getTTSs,y as getTextNormalization,m as getTextNormalizations,h as makeTTS};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "perso-interactive-sdk-web",
-	"version": "1.3.4",
+	"version": "1.4.0",
 	"description": "Perso Interactive Web SDK - WebRTC-based real-time interactive AI avatar sessions",
 	"type": "module",
 	"private": false,