Methods

All methods (except on / off) return this — the SDK instance — making them chainable.

EPIS.mountChat()

EPIS.mountChat(selector: string, options?: Partial<EpisBoxConfig>): this

Mounts the full EPIS Chat UI into the element matching selector. The mounted iframe connects to embed.pastpaperlm.com/embed/chat. What the mount includes:

Full conversation UI with streaming AI responses
File attachment support — images, PDFs (via Cloudinary pipeline)
“Authenticate with PastpaperLM” flow if no active session
Session persistence across page reloads (token in iframe’s localStorage)
Past paper retrieval — free 4-year window for all users

Calling mountChat() on a selector that is already mounted logs a warning and does nothing. To remount with different options, call unmount(selector) first.

Parameters:

string

required

A CSS selector string (e.g. '#epis-chat', '.epis-container'). The SDK calls document.querySelector(selector) internally.

Partial<EpisBoxConfig>

Per-mount overrides for theme, locale, model, or persona. These are merged on top of the config passed to init().

EPIS.mountChat('#epis-chat');

// With per-mount theme override
EPIS.mountChat('#epis-chat', { theme: { primary: '#E32E78' } });

EPIS.updateTheme()

EPIS.updateTheme(theme: EpisBoxConfig['theme']): this

Pushes a live theme update to every currently mounted instance without unmounting or remounting them — no flicker, no lost conversation state. Use this to keep EPIS in sync when your own app’s light/dark toggle (or any other theme change) happens after init(). Accepts the same shape as config.theme passed to init(), including preset.

// Sync EPIS whenever your own app's theme toggle fires
function onAppThemeToggle(isDark) {
  EPIS.updateTheme({
    preset: 'auraspace',
    mode: isDark ? 'dark' : 'light',
    background: isDark ? '#090e0e' : '#f5fbfa',
    surface: isDark ? '#121c1b' : '#ffffff',
    text: isDark ? '#e8f8f7' : '#0d1f1e',
  });
}

Mounted iframes must have already sent their ready event before an update is delivered — calling this immediately after mountChat() on the very first paint may be a no-op. In practice this is never an issue for toggles fired later by user interaction.

EPIS.unmount()

EPIS.unmount(selector: string): this

Removes the EpisBox mount at selector. Destroys the iframe, cleans up internal event listeners, and marks the selector as available for remounting.

// Remove a specific mount
EPIS.unmount('#epis-chat');

// Then remount with different config
EPIS.mountChat('#epis-chat', { theme: { preset: 'light' } });

EPIS.unmountAll()

EPIS.unmountAll(): this

Removes all active mounts and resets the SDK to its pre-init() state. After calling this, you must call EPIS.init() again before mounting.

EPIS.unmountAll();

// Reinitialize with new config (e.g. after user changes theme preference)
EPIS.init({ clientId: 'your-client-id', theme: { preset: 'light' } })
    .mountChat('#epis-chat');

EPIS.on()

EPIS.on(event: EpisBoxEvent, callback: (payload: any) => void): this

Register an event listener. Returns this for chaining. See the Events reference for all event names and payload shapes.

EPIS.on('auth', function (data) {
  console.log('User signed in:', data.user.name);
});

EPIS.off()

EPIS.off(event: EpisBoxEvent, callback: (payload: any) => void): this

Remove a specific event listener. The callback reference must be the same function passed to on().

function onAuth(data) {
  showWelcome(data.user.name);
}

EPIS.on('auth', onAuth);

// Later — remove it
EPIS.off('auth', onAuth);

EPIS.VERSION

EPIS.VERSION: string  // e.g. '1.0.0'

Read-only. The current SDK version string.

console.log('EpisBox SDK:', EPIS.VERSION);

EPIS.THEMES

EPIS.THEMES: Record<string, EpisBoxTheme>

Read-only object containing the full config for every named preset ('dark', 'light', 'auraspace', 'minimal'). Useful for building a theme picker or for debugging.

console.log(EPIS.THEMES.auraspace);
// { primary: '#3dd6c8', secondary: '#4ba3f5', font: 'Poppins', ... }

Chaining example

EPIS
  .init({
    clientId: 'your-client-id',
    theme: { preset: 'dark', primary: '#E32E78' }
  })
  .mountChat('#epis-chat')
  .on('auth',    user  => updateHeader(user.name))
  .on('message', msg   => logAnalytics(msg.sessionId))
  .on('error',   err   => reportError(err.code));

Get Started

Frameworks

SDK Reference

Theming

More

EPIS.mountChat()

EPIS.updateTheme()

EPIS.unmount()

EPIS.unmountAll()

EPIS.on()

EPIS.off()

EPIS.VERSION

EPIS.THEMES

Chaining example

​EPIS.mountChat()

​EPIS.updateTheme()

​EPIS.unmount()

​EPIS.unmountAll()

​EPIS.on()

​EPIS.off()

​EPIS.VERSION

​EPIS.THEMES

​Chaining example

EPIS.mountChat()

EPIS.updateTheme()

EPIS.unmount()

EPIS.unmountAll()

EPIS.on()

EPIS.off()

EPIS.VERSION

EPIS.THEMES

Chaining example