perso-interactive-sdk-web 1.3.4 → 1.5.0

package/dist/server/index.d.ts

@@ -1,3 +1,173 @@
+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 {SessionCreationError} When the API returns an error during session creation.
+ * @throws {DoesNotExistError} When the server response `code` is `'does_not_exist'` (subclass of `SessionCreationError`).
+ * @throws {NotInOrganizationError} When the server response `code` is `'not_in_organization'` (subclass of `SessionCreationError`).
+ */
+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>;
+
+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;
+}
+/**
+ * Response from POST /api/v1/session/{session_id}/stt/.
+ * Mirrors STTResponse in the OpenAPI schema. All three fields are required;
+ * `normalized_text` may be empty or equal to `text` when the session has no
+ * STT text-normalization config configured.
+ */
+interface STTResponse {
+    text: string;
+    locale: string;
+    normalized_text: string;
+}
+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",
@@ -255,14 +425,17 @@ declare class PersoUtil {
      * @param sessionId Session ID for the current session
      * @param audioFile Audio file (WAV format)
      * @param language Optional language code (e.g., 'ko', 'en')
-     * @returns JSON response containing the transcribed text
+     * @returns STTResponse with transcription, locale, and normalized text.
      * {
-     *   "text": string
+     *   "text": string,
+     *   "locale": string,
+     *   "normalized_text": string
      * }
+     *
+     * `normalized_text` may be empty or equal to `text` when the session has
+     * no STT text-normalization config attached.
      */
-    static makeSTT(apiServer: string, sessionId: string, audioFile: File, language?: string): Promise<{
-        text: string;
-    }>;
+    static makeSTT(apiServer: string, sessionId: string, audioFile: File, language?: string): Promise<STTResponse>;
     /**
      * Initiates an LLM streaming request and returns the response body reader.
      * @param apiServer Perso Interactive API Server
@@ -294,162 +467,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,11 +541,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>;
+/**
+ * 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>;
 
 declare class ApiError extends Error {
     errorCode: number;
@@ -470,6 +589,41 @@ declare class ApiError extends Error {
     attr?: string | undefined;
     constructor(errorCode: number, code: string, detail: string, attr?: string | undefined);
 }
+/**
+ * Domain error thrown by `createSessionId()` (and the `getSessionTemplate`
+ * path) when the underlying API returns an `ApiError`. The raw
+ * `errorCode`, `code`, `detail`, and `attr` fields are preserved as-is —
+ * callers inspect them to decide how to react (e.g. treat
+ * `code === 'invalid'` with a "not found" detail as feature-unavailable
+ * per LIV-1681).
+ *
+ * Extends `ApiError`, so existing `instanceof ApiError` branches keep
+ * working.
+ */
+declare class SessionCreationError extends ApiError {
+    constructor(source: ApiError);
+}
+/**
+ * Session creation failed because a referenced resource does not exist.
+ * Triggered when the server returns `code === 'does_not_exist'` — for
+ * example, a `prompt_id` that has been deleted or never existed. The
+ * `attr` field, when present, identifies which input field referenced
+ * the missing resource (e.g. `'prompt'`).
+ */
+declare class DoesNotExistError extends SessionCreationError {
+    constructor(source: ApiError);
+}
+/**
+ * Session creation failed because a referenced resource is not assigned
+ * to the caller's organization. Triggered when the server returns
+ * `code === 'not_in_organization'` — for example, an LLM/TTS/STT type
+ * that exists in the platform catalog but is not enabled for this
+ * organization. The `attr` field, when present, identifies which input
+ * field referenced the unavailable resource.
+ */
+declare class NotInOrganizationError extends SessionCreationError {
+    constructor(source: ApiError);
+}
 
-export { ApiError, PersoUtil as PersoUtilServer, createSessionId, getIntroMessage, getSessionTemplate, getSessionTemplates };
-export type { SessionTemplate };
+export { ApiError, DoesNotExistError, NotInOrganizationError, PersoUtil as PersoUtilServer, SessionCreationError, createSessionId, getAllSettings, getBackgroundImages, getDocuments, getIntroMessage, getLLMs, getMcpServers, getModelStyles, getPrompts, getSTTs, getSessionInfo, getSessionTemplate, getSessionTemplates, getTTSs, getTextNormalization, getTextNormalizations, makeTTS };
+export type { STTResponse, 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,s,a){let n;n=null!=a?`${t}:${a}_${s}`:`${t}:${s}`,super(n),this.errorCode=t,this.code=e,this.detail=s,this.attr=a}}class e extends t{constructor(t){super(t.errorCode,t.code,t.detail,t.attr),this.name="SessionCreationError"}}class s extends e{constructor(t){super(t),this.name="DoesNotExistError"}}class a extends e{constructor(t){super(t),this.name="NotInOrganizationError"}}var n,i;!function(t){t.LLM="LLM",t.TTS="TTS",t.STT="STT",t.STF_ONPREMISE="STF_ONPREMISE",t.STF_WEBRTC="STF_WEBRTC"}(n||(n={})),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"}(i||(i={}));class o{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:n}){const i={text:s};a&&(i.locale=a),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 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 n=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(n)}static async makeSTT(t,e,s,a){const n=new FormData;n.append("audio",s),a&&n.append("language",a);const i=await fetch(`${t}/api/v1/session/${e}/stt/`,{method:"POST",body:n});return await this.parseJson(i)}static async makeLLM(e,s,a,n){const i=await fetch(`${e}/api/v1/session/${s}/llm/v2/`,{body:JSON.stringify(a),headers:{"Content-Type":"application/json"},method:"POST",signal:n});if(!i.ok){const e=await i.json(),s=e.errors?.[0]??{code:"UNKNOWN_ERROR",detail:`Server returned status ${i.status} with no error details`,attr:null};throw new t(i.status,s.code,s.detail,s.attr)}return i.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 r(i,r,c){try{let t;if("string"==typeof c){const e=await o.getSessionTemplate(i,r,c);if("webrtc"!==e.model_style.platform_type)throw new Error(`SessionTemplate "${c}" uses platform_type "${e.model_style.platform_type}", but only "webrtc" is supported`);t=function(t){const e=e=>t.capability.some(t=>t.name===e);return{using_stf_webrtc:e(n.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:e(n.LLM)?t.llm_type.name:void 0,tts_type:e(n.TTS)?t.tts_type.name:void 0,stt_type:e(n.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}}(e)}else t=c;const e={capability:[],...t};t.using_stf_webrtc&&e.capability.push("STF_WEBRTC"),t?.llm_type&&(e.capability.push("LLM"),e.llm_type=t.llm_type),t?.tts_type&&(e.capability.push("TTS"),e.tts_type=t.tts_type),t?.stt_type&&(e.capability.push("STT"),e.stt_type=t.stt_type);const s=await fetch(`${i}/api/v1/session/`,{body:JSON.stringify(e),headers:{"PersoLive-APIKey":r,"Content-Type":"application/json"},method:"POST"});return(await o.parseJson(s)).session_id}catch(n){throw function(n){if(n instanceof e)return n;if(n instanceof t)switch(n.code){case"does_not_exist":return new s(n);case"not_in_organization":return new a(n);default:return new e(n)}return n}(n)}}const c=async(e,s,a)=>{try{const t=(await o.getPrompts(e,s)).find(t=>t.prompt_id===a);if(!t)throw new Error(`Prompt (${a}) 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}};async function p(t,e){return await o.getLLMs(t,e)}async function d(t,e){return await o.getTTSs(t,e)}async function l(t,e){return await o.getSTTs(t,e)}async function u(t,e){return await o.getModelStyles(t,e)}async function m(t,e){return await o.getBackgroundImages(t,e)}async function _(t,e){return await o.getPrompts(t,e)}async function y(t,e){return await o.getDocuments(t,e)}async function S(t,e){return await o.getMcpServers(t,e)}async function h(t,e){return await o.getTextNormalizations(t,e)}async function T(t,e,s){return await o.downloadTextNormalization(t,e,s)}async function w(t,e){return await o.getSessionTemplates(t,e)}async function g(t,e,s){return await o.getSessionTemplate(t,e,s)}async function f(t,e){const[s,a,n,i,o,r,c,T,w]=await Promise.all([p(t,e),d(t,e),l(t,e),u(t,e),m(t,e),_(t,e),y(t,e),S(t,e),h(t,e).catch(()=>[])]);return{llms:s,ttsTypes:a,sttTypes:n,modelStyles:i,backgroundImages:o,prompts:r,documents:c,mcpServers:T,textNormalizations:w}}async function v(t,e){return await o.makeTTS(t,e)}async function E(t,e){return await o.getSessionInfo(t,e)}export{t as ApiError,s as DoesNotExistError,a as NotInOrganizationError,o as PersoUtilServer,e as SessionCreationError,r as createSessionId,f as getAllSettings,m as getBackgroundImages,y as getDocuments,c as getIntroMessage,p as getLLMs,S as getMcpServers,u as getModelStyles,_ as getPrompts,l as getSTTs,E as getSessionInfo,g as getSessionTemplate,w as getSessionTemplates,d as getTTSs,T as getTextNormalization,h as getTextNormalizations,v as makeTTS};

package/package.json

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