JavaScript

const pria = {
    load: priasdk,                // Initialize the Pria SDK and establish middleware connection
    send: priaSend,               // Send API requests/messages to Pria
    subscribe: priaSubscribe,     // Listen for Pria responses or callback events
    unsubscribe: priaUnsubscribe, // Remove listeners or callbacks from Pria
    setVisible: priaSetVisible,   // Show or hide Pria entirely (removes from DOM view)
    isVisible: priaIsVisible,     // Check if Pria is currently visible
    isDisplayed: priaIsDisplayed, // Check if Pria UI panel is expanded
    display: priaDisplay,         // Expand or collapse the Pria UI panel
    setConvoActive: priaSetConvoActive, // Apply or remove the centered full-screen convo layout
    destroy: priaDestroy,         // Clean up and remove Pria from the page
    priaObj: priaObj,             // Backing property bag that contains current cached user identity
    isReady: priaIsReady,         // True when Pria is ready to receive messages
    isConvoReady: priaIsConvoReady, // True when real-time voice (convo) mode is authorized
    isSessionReady: priaIsSessionReady, // True when a command sent now is delivered rather than held
    isAuthRequired: priaIsAuthRequired, // True while the panel waits for the person to confirm it's them
    version: 1                    // Message-format version for compatibility checks
}

<iframe src="…" allow="microphone; autoplay"></iframe>

const request = {
    command: '<command>',
    ...arguments
}

// The learner is typing into your page instead of speaking.
pria.send({ command: 'convo.post', inputs: ['What does this chart show?'] })

// Your page steering the twin, in its own voice.
pria.send({
    command: 'convo.post',
    inputs: ['The learner just opened the Try It panel — coach them into it.'],
    role: 'system',
    respond: true,
})

pria.send({ command: 'convo.start', intro: 'Welcome back to lesson three.' })  // say this
pria.send({ command: 'convo.start', intro: false })                            // say nothing
pria.send({ command: 'convo.start' })                                          // the twin's own greeting

const handlePriaResponse = (response) => {
    console.log('Received from Pria:', response)
    // Process the response here
}

pria.subscribe(handlePriaResponse)

{
    "type": "pria-response",
    "response": {
        "command": "message.post",
        "content": {} | "",
        "isError": false,
        "type": "object"
    },
    "version": 1
}

// Hide Pria entirely (removes from DOM view)
pria.setVisible(false)

// Show Pria (makes button/UI available)
pria.setVisible(true)

// Check if Pria is currently visible
const visible = pria.isVisible()  // Returns true or false

// Expand the Pria UI panel
pria.display(true)

// Collapse to button only
pria.display(false)

// Check if UI panel is currently expanded
const expanded = pria.isDisplayed()  // Returns true or false

// Check if Pria is ready to receive messages
const ready = pria.isReady()  // Returns true or false

// Wait for Pria to be ready before sending commands
if (pria.isReady()) {
    pria.send({ command: 'assistants.list' })
}

/**
 * Check if Pria SDK is ready to receive messages
 * @returns {boolean} True if SDK is fully connected and ready
 */
function isPriaReady() {
    return window.pria && 
           typeof window.pria.isReady === 'function' && 
           window.pria.isReady();
}

// Usage
if (isPriaReady()) {
    window.pria.send({ command: 'convo.start' });
}

// Check if real-time voice mode is authorized for this user
const convoReady = pria.isConvoReady()  // Returns true or false

pria.subscribe((data) => {
    if (data?.type === 'pria-response' && data?.response?.command === 'convo.ready') {
        const authorized = data.response.content?.authorized === true;
        console.log('Voice mode authorized:', authorized);

        if (authorized) {
            // Voice is available — render your voice-first UI
        }
    }
});

// Step 1: Load SDK with UI hidden
const displayOptions = {
    fullScreen: true,
    openOnLoad: false,     // Don't open the panel yet
    noUI: true             // Hide button and panel entirely during loading
};

PriaIntegration.loadSdk(
    'https://pria.praxislxp.com',
    displayOptions,
    instanceConfig,
    userConfig
);

// Step 2: Wait for SDK to be ready, then listen for convo.ready
const timer = setInterval(() => {
    if (!window.pria?.isReady()) return;
    clearInterval(timer);

    window.pria.subscribe((data) => {
        if (data?.type !== 'pria-response') return;
        const command = data.response?.command;

        // Step 3: When convo.ready arrives and is authorized, start voice mode
        if (command === 'convo.ready' && data.response.content?.authorized) {
            // Make the widget visible
            window.pria.setVisible(true);

            // Start voice mode (optionally target a specific assistant/conversation)
            window.pria.send({
                command: 'convo.start',
                assistantId: '674e9fd3d7e18aa82eb49fda',  // optional
                selectedCourse: {                               // optional
                    course_id: 123,
                    course_name: 'Customer Onboarding'
                }
            });

            // Expand the UI panel to full screen
            window.pria.display(true);
        }

        // Step 4: When convo starts, the voice interface is live
        if (command === 'convo.start') {
            console.log('Voice mode is live');
        }
    });
}, 500);

const displayOptions = { transcripts: true }
// or, later:
pria.send({ command: 'transcripts.subscribe' })    // answer: { subscribed: true, enabled: <twin allows it> }
pria.send({ command: 'transcripts.unsubscribe' })

pria.subscribe((data) => {
    if (data?.type !== 'pria-response') return
    const { command, content } = data.response
    if (command === 'convo.transcript') {
        // content: { schema: 1, role: 'user' | 'assistant', text, final, turnId, seq, ts, reason,
        //            provider, sessionId, assistantId, confidence, startedAt, endedAt }
        upsertLine(`${content.role}:${content.turnId}`, content.text, content.final)
    } else if (command === 'convo.speech_started' || command === 'convo.speech_ended') {
        // content: { turnId } — drive a "listening…" indicator
    } else if (command === 'convo.stopped') {
        // content: { sessionId } — the call ended; close your transcript pane
    }
})

// Remove Pria completely and clean up all resources
pria.destroy()

// Destroy SDK completely
PriaIntegration.destroySdk();

// Reload SDK with configuration
PriaIntegration.reloadSdk(
    'https://pria.praxislxp.com',
    displayOptions,
    instanceConfig,
    userConfig
);

// Check if SDK is ready via wrapper
if (PriaIntegration.isReady()) {
    window.pria.send({ command: 'assistants.list' });
}

const sendMessage = async (message) => {
    try {
        const request = {
            command: 'message.post',
            inputs: [message]
        }
        
        pria.send(request)
    } catch (error) {
        console.error('Failed to send message:', error)
        // Handle error appropriately
    }
}

const handleResponse = (responseMessage) => {
    
    // Accept both normal responses and error messages
    if (responseMessage?.type !== "pria-response" && responseMessage?.type !== "pria-error") return 

    const response = responseMessage?.response 
    if (!response) return;

    if (response.isError) {
        console.error('Pria error:', response.content)
        return
    }

    // handle content as String 
    if (response.type==='string') {
        
        console.log("Response:", response.content)

    }
    // handle response as object 
    else {
        

        // handling a response from message.post
        if (response.command == "message.post"){
        
            const outputs = response.content?.outputs
            if (outputs){
                outputs.forEach(output => {
                    // Display or process each output
                    console.log(output)
                })
            }
        }
    }
}

// Unsubscribe when component unmounts or page unloads
window.addEventListener('beforeunload', () => {
    pria.unsubscribe(handlePriaResponse)
})

pria.subscribe((message) => {
    console.log('Pria message:', JSON.stringify(message, null, 2))
})