playkit-sdk 1.2.12 → 1.3.0

package/dist/playkit-sdk.umd.js

@@ -1,13 +1,13 @@
 /**
- * playkit-sdk v1.2.12
+ * playkit-sdk v1.3.0
  * PlayKit SDK for JavaScript
  * @license SEE LICENSE IN LICENSE
  */
 (function (global, factory) {
-	typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
-	typeof define === 'function' && define.amd ? define(['exports'], factory) :
-	(global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.PlayKitSDK = {}));
-})(this, (function (exports) { 'use strict';
+	typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
+	typeof define === 'function' && define.amd ? define(factory) :
+	(global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.PlayKitSDK = factory());
+})(this, (function () { 'use strict';
 
 	function getDefaultExportFromCjs (x) {
 		return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
@@ -467,7 +467,7 @@
 	 * Log level enumeration
 	 * Lower values = higher priority
 	 */
-	exports.LogLevel = void 0;
+	var LogLevel;
 	(function (LogLevel) {
 	    /** Disable all logging */
 	    LogLevel[LogLevel["NONE"] = 0] = "NONE";
@@ -479,7 +479,7 @@
 	    LogLevel[LogLevel["INFO"] = 3] = "INFO";
 	    /** Debug level - all logs */
 	    LogLevel[LogLevel["DEBUG"] = 4] = "DEBUG";
-	})(exports.LogLevel || (exports.LogLevel = {}));
+	})(LogLevel || (LogLevel = {}));
 	/**
 	 * PlayKit Logger
 	 *
@@ -603,7 +603,7 @@
 	     * Useful for testing
 	     */
 	    static reset() {
-	        Logger.globalLevel = exports.LogLevel.WARN;
+	        Logger.globalLevel = LogLevel.WARN;
 	        Logger.consoleEnabled = true;
 	        Logger.handlers = [];
 	        Logger.instances.clear();
@@ -631,7 +631,7 @@
 	     * @param data Additional data to log
 	     */
 	    debug(message, ...data) {
-	        this.log(exports.LogLevel.DEBUG, 'debug', message, data);
+	        this.log(LogLevel.DEBUG, 'debug', message, data);
 	    }
 	    /**
 	     * Log an info message
@@ -639,7 +639,7 @@
 	     * @param data Additional data to log
 	     */
 	    info(message, ...data) {
-	        this.log(exports.LogLevel.INFO, 'info', message, data);
+	        this.log(LogLevel.INFO, 'info', message, data);
 	    }
 	    /**
 	     * Log a warning message
@@ -647,7 +647,7 @@
 	     * @param data Additional data to log
 	     */
 	    warn(message, ...data) {
-	        this.log(exports.LogLevel.WARN, 'warn', message, data);
+	        this.log(LogLevel.WARN, 'warn', message, data);
 	    }
 	    /**
 	     * Log an error message
@@ -655,7 +655,7 @@
 	     * @param data Additional data to log
 	     */
 	    error(message, ...data) {
-	        this.log(exports.LogLevel.ERROR, 'error', message, data);
+	        this.log(LogLevel.ERROR, 'error', message, data);
 	    }
 	    /**
 	     * Internal log method
@@ -713,7 +713,7 @@
 	        }
 	    }
 	}
-	Logger.globalLevel = exports.LogLevel.WARN;
+	Logger.globalLevel = LogLevel.WARN;
 	Logger.handlers = [];
 	Logger.consoleEnabled = true;
 	Logger.instances = new Map();
@@ -1176,6 +1176,15 @@
 	    }
 	}
 
+	const SDK_TYPE = 'Javascript';
+	const SDK_VERSION = '"1.3.0"';
+	function getSDKHeaders() {
+	    return {
+	        'X-SDK-Type': SDK_TYPE,
+	        'X-SDK-Version': SDK_VERSION,
+	    };
+	}
+
 	/**
 	 * Authentication Flow Manager
 	 * Manages the headless authentication flow with automatic UI
@@ -1280,8 +1289,8 @@
 	    constructor(baseURL) {
 	        super();
 	        this.currentSessionId = null;
-	        this.uiContainer = null;
-	        this.isSuccess = false;
+	        this._uiContainer = null;
+	        this._isSuccess = false;
 	        this.currentLanguage = 'en';
 	        // UI Elements
 	        this.modal = null;
@@ -1362,84 +1371,84 @@
 	        // Create modal container
 	        this.modal = document.createElement('div');
 	        this.modal.className = 'playkit-auth-modal';
-	        this.modal.innerHTML = `
-      <div class="playkit-auth-overlay"></div>
-      <div class="playkit-auth-container">
-        <!-- Identifier Panel -->
-        <div class="playkit-auth-panel" id="playkit-identifier-panel">
-          <div class="playkit-auth-header">
-            <h2>${this.t('signIn')}</h2>
-            <p>${this.t('signInSubtitle')}</p>
-          </div>
-
-          <div class="playkit-auth-toggle">
-            <label class="playkit-toggle-option">
-              <input type="radio" name="auth-type" value="email" checked>
-              <span>${this.t('email')}</span>
-            </label>
-            <label class="playkit-toggle-option">
-              <input type="radio" name="auth-type" value="phone">
-              <span>${this.t('phone')}</span>
-            </label>
-          </div>
-
-          <div class="playkit-auth-input-group">
-            <div class="playkit-input-wrapper">
-              <svg class="playkit-input-icon" id="playkit-identifier-icon" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
-                <path d="M4 4h16c1.1 0 2 .9 2 2v12c0 1.1-.9 2-2 2H4c-1.1 0-2-.9-2-2V6c0-1.1.9-2 2-2z"></path>
-                <polyline points="22,6 12,13 2,6"></polyline>
-              </svg>
-              <input
-                type="text"
-                id="playkit-identifier-input"
-                placeholder="${this.t('emailPlaceholder')}"
-                autocomplete="off"
-              >
-            </div>
-          </div>
-
-          <button class="playkit-auth-button" id="playkit-send-code-btn">
-            ${this.t('sendCode')}
-          </button>
-
-          <div class="playkit-auth-error" id="playkit-error-text"></div>
-        </div>
-
-        <!-- Verification Panel -->
-        <div class="playkit-auth-panel" id="playkit-verification-panel" style="display: none;">
-          <div class="playkit-auth-header">
-            <button class="playkit-back-button" id="playkit-back-btn">
-              <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
-                <path d="M19 12H5M12 19l-7-7 7-7"/>
-              </svg>
-            </button>
-            <h2>${this.t('enterCode')}</h2>
-            <p>${this.t('enterCodeSubtitle')} <span id="playkit-identifier-display"></span></p>
-          </div>
-
-          <div class="playkit-auth-input-group">
-            <div class="playkit-code-inputs">
-              <input type="number" maxlength="1" class="playkit-code-input" data-index="0">
-              <input type="number" maxlength="1" class="playkit-code-input" data-index="1">
-              <input type="number" maxlength="1" class="playkit-code-input" data-index="2">
-              <input type="number" maxlength="1" class="playkit-code-input" data-index="3">
-              <input type="number" maxlength="1" class="playkit-code-input" data-index="4">
-              <input type="number" maxlength="1" class="playkit-code-input" data-index="5">
-            </div>
-          </div>
-
-          <button class="playkit-auth-button" id="playkit-verify-btn">
-            ${this.t('verify')}
-          </button>
-
-          <div class="playkit-auth-error" id="playkit-verify-error-text"></div>
-        </div>
-
-        <!-- Loading Overlay -->
-        <div class="playkit-loading-overlay" id="playkit-loading-overlay" style="display: none;">
-          <div class="playkit-spinner"></div>
-        </div>
-      </div>
+	        this.modal.innerHTML = `
+      <div class="playkit-auth-overlay"></div>
+      <div class="playkit-auth-container">
+        <!-- Identifier Panel -->
+        <div class="playkit-auth-panel" id="playkit-identifier-panel">
+          <div class="playkit-auth-header">
+            <h2>${this.t('signIn')}</h2>
+            <p>${this.t('signInSubtitle')}</p>
+          </div>
+
+          <div class="playkit-auth-toggle">
+            <label class="playkit-toggle-option">
+              <input type="radio" name="auth-type" value="email" checked>
+              <span>${this.t('email')}</span>
+            </label>
+            <label class="playkit-toggle-option">
+              <input type="radio" name="auth-type" value="phone">
+              <span>${this.t('phone')}</span>
+            </label>
+          </div>
+
+          <div class="playkit-auth-input-group">
+            <div class="playkit-input-wrapper">
+              <svg class="playkit-input-icon" id="playkit-identifier-icon" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                <path d="M4 4h16c1.1 0 2 .9 2 2v12c0 1.1-.9 2-2 2H4c-1.1 0-2-.9-2-2V6c0-1.1.9-2 2-2z"></path>
+                <polyline points="22,6 12,13 2,6"></polyline>
+              </svg>
+              <input
+                type="text"
+                id="playkit-identifier-input"
+                placeholder="${this.t('emailPlaceholder')}"
+                autocomplete="off"
+              >
+            </div>
+          </div>
+
+          <button class="playkit-auth-button" id="playkit-send-code-btn">
+            ${this.t('sendCode')}
+          </button>
+
+          <div class="playkit-auth-error" id="playkit-error-text"></div>
+        </div>
+
+        <!-- Verification Panel -->
+        <div class="playkit-auth-panel" id="playkit-verification-panel" style="display: none;">
+          <div class="playkit-auth-header">
+            <button class="playkit-back-button" id="playkit-back-btn">
+              <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                <path d="M19 12H5M12 19l-7-7 7-7"/>
+              </svg>
+            </button>
+            <h2>${this.t('enterCode')}</h2>
+            <p>${this.t('enterCodeSubtitle')} <span id="playkit-identifier-display"></span></p>
+          </div>
+
+          <div class="playkit-auth-input-group">
+            <div class="playkit-code-inputs">
+              <input type="number" maxlength="1" class="playkit-code-input" data-index="0">
+              <input type="number" maxlength="1" class="playkit-code-input" data-index="1">
+              <input type="number" maxlength="1" class="playkit-code-input" data-index="2">
+              <input type="number" maxlength="1" class="playkit-code-input" data-index="3">
+              <input type="number" maxlength="1" class="playkit-code-input" data-index="4">
+              <input type="number" maxlength="1" class="playkit-code-input" data-index="5">
+            </div>
+          </div>
+
+          <button class="playkit-auth-button" id="playkit-verify-btn">
+            ${this.t('verify')}
+          </button>
+
+          <div class="playkit-auth-error" id="playkit-verify-error-text"></div>
+        </div>
+
+        <!-- Loading Overlay -->
+        <div class="playkit-loading-overlay" id="playkit-loading-overlay" style="display: none;">
+          <div class="playkit-spinner"></div>
+        </div>
+      </div>
     `;
 	        // Add styles and load VanillaOTP
 	        this.addStyles();
@@ -1474,274 +1483,274 @@
 	            return;
 	        const style = document.createElement('style');
 	        style.id = styleId;
-	        style.textContent = `
-      .playkit-auth-modal {
-        position: fixed;
-        top: 0;
-        left: 0;
-        right: 0;
-        bottom: 0;
-        z-index: 999999;
-        display: flex;
-        justify-content: center;
-        align-items: center;
-        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-      }
-
-      .playkit-auth-overlay {
-        position: absolute;
-        top: 0;
-        left: 0;
-        right: 0;
-        bottom: 0;
-        background: rgba(0, 0, 0, 0.8);
-      }
-
-      .playkit-auth-container {
-        position: relative;
-        background: #fff;
-        border: 1px solid rgba(0, 0, 0, 0.1);
-        box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.05);
-        width: 90%;
-        max-width: 320px;
-        overflow: hidden;
-      }
-
-      .playkit-auth-panel {
-        padding: 24px;
-      }
-
-      .playkit-auth-header {
-        text-align: center;
-        margin-bottom: 20px;
-        position: relative;
-      }
-
-      .playkit-auth-header h2 {
-        margin: 0 0 8px 0;
-        font-size: 14px;
-        font-weight: 600;
-        color: #171717;
-      }
-
-      .playkit-auth-header p {
-        margin: 0;
-        font-size: 14px;
-        color: #666;
-        line-height: 1.5;
-      }
-
-      .playkit-back-button {
-        position: absolute;
-        left: 0;
-        top: 0;
-        background: transparent;
-        border: none;
-        cursor: pointer;
-        padding: 4px;
-        color: #666;
-        transition: background-color 0.2s ease, color 0.2s ease;
-      }
-
-      .playkit-back-button:hover {
-        background: #f5f5f5;
-        color: #171717;
-      }
-
-      .playkit-auth-toggle {
-        display: flex;
-        background: #f5f5f5;
-        padding: 2px;
-        margin-bottom: 20px;
-        gap: 2px;
-      }
-
-      .playkit-toggle-option {
-        flex: 1;
-        display: flex;
-        justify-content: center;
-        align-items: center;
-        padding: 10px 16px;
-        cursor: pointer;
-        transition: background-color 0.2s ease;
-      }
-
-      .playkit-toggle-option input {
-        display: none;
-      }
-
-      .playkit-toggle-option span {
-        font-size: 14px;
-        font-weight: 500;
-        color: #666;
-        transition: color 0.2s ease;
-      }
-
-      .playkit-toggle-option input:checked + span {
-        color: #fff;
-      }
-
-      .playkit-toggle-option:has(input:checked) {
-        background: #171717;
-      }
-
-      .playkit-auth-input-group {
-        margin-bottom: 20px;
-      }
-
-      .playkit-input-wrapper {
-        position: relative;
-        display: flex;
-        align-items: center;
-      }
-
-      .playkit-input-icon {
-        position: absolute;
-        left: 12px;
-        color: #999;
-        pointer-events: none;
-      }
-
-      .playkit-input-wrapper input {
-        width: 100%;
-        padding: 10px 12px 10px 44px;
-        border: 1px solid #e5e7eb;
-        font-size: 14px;
-        transition: border-color 0.2s ease;
-        box-sizing: border-box;
-        background: #fff;
-      }
-
-      .playkit-input-wrapper input:hover {
-        border-color: #d4d4d4;
-      }
-
-      .playkit-input-wrapper input:focus {
-        outline: none;
-        border-color: #171717;
-      }
-
-      .playkit-code-inputs {
-        display: flex;
-        gap: 8px;
-        justify-content: center;
-      }
-
-      .playkit-code-input {
-        width: 40px !important;
-        height: 48px;
-        text-align: center;
-        font-size: 20px;
-        font-weight: 600;
-        border: 1px solid #e5e7eb !important;
-        padding: 0 !important;
-        transition: border-color 0.2s ease;
-        background: #fff;
-        -moz-appearance: textfield;
-      }
-
-      .playkit-code-input::-webkit-outer-spin-button,
-      .playkit-code-input::-webkit-inner-spin-button {
-        -webkit-appearance: none;
-        margin: 0;
-      }
-
-      .playkit-code-input:hover {
-        border-color: #d4d4d4 !important;
-      }
-
-      .playkit-code-input:focus {
-        outline: none;
-        border-color: #171717 !important;
-      }
-
-      .playkit-auth-button {
-        width: 100%;
-        padding: 10px 16px;
-        background: #171717;
-        color: white;
-        border: none;
-        font-size: 14px;
-        font-weight: 500;
-        cursor: pointer;
-        transition: background 0.2s ease;
-      }
-
-      .playkit-auth-button:hover:not(:disabled) {
-        background: #404040;
-      }
-
-      .playkit-auth-button:active:not(:disabled) {
-        background: #0a0a0a;
-      }
-
-      .playkit-auth-button:disabled {
-        background: #e5e7eb;
-        color: #999;
-        cursor: not-allowed;
-      }
-
-      .playkit-auth-error {
-        margin-top: 16px;
-        padding: 12px 16px;
-        background: #fef2f2;
-        border: 1px solid #fecaca;
-        color: #dc2626;
-        font-size: 13px;
-        text-align: left;
-        display: none;
-      }
-
-      .playkit-auth-error.show {
-        display: block;
-      }
-
-      .playkit-loading-overlay {
-        position: absolute;
-        top: 0;
-        left: 0;
-        right: 0;
-        bottom: 0;
-        background: rgba(255, 255, 255, 0.96);
-        display: flex;
-        justify-content: center;
-        align-items: center;
-      }
-
-      .playkit-spinner {
-        width: 24px;
-        height: 24px;
-        border: 2px solid #e5e7eb;
-        border-top: 2px solid #171717;
-        border-radius: 50%;
-        animation: playkit-spin 1s linear infinite;
-      }
-
-      @keyframes playkit-spin {
-        0% { transform: rotate(0deg); }
-        100% { transform: rotate(360deg); }
-      }
-
-      @media (max-width: 480px) {
-        .playkit-auth-container {
-          width: 95%;
-          max-width: none;
-        }
-
-        .playkit-auth-panel {
-          padding: 20px;
-        }
-
-        .playkit-code-input {
-          width: 36px !important;
-          height: 44px;
-          font-size: 18px;
-        }
-
-        .playkit-code-inputs {
-          gap: 6px;
-        }
-      }
+	        style.textContent = `
+      .playkit-auth-modal {
+        position: fixed;
+        top: 0;
+        left: 0;
+        right: 0;
+        bottom: 0;
+        z-index: 999999;
+        display: flex;
+        justify-content: center;
+        align-items: center;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      }
+
+      .playkit-auth-overlay {
+        position: absolute;
+        top: 0;
+        left: 0;
+        right: 0;
+        bottom: 0;
+        background: rgba(0, 0, 0, 0.8);
+      }
+
+      .playkit-auth-container {
+        position: relative;
+        background: #fff;
+        border: 1px solid rgba(0, 0, 0, 0.1);
+        box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.05);
+        width: 90%;
+        max-width: 320px;
+        overflow: hidden;
+      }
+
+      .playkit-auth-panel {
+        padding: 24px;
+      }
+
+      .playkit-auth-header {
+        text-align: center;
+        margin-bottom: 20px;
+        position: relative;
+      }
+
+      .playkit-auth-header h2 {
+        margin: 0 0 8px 0;
+        font-size: 14px;
+        font-weight: 600;
+        color: #171717;
+      }
+
+      .playkit-auth-header p {
+        margin: 0;
+        font-size: 14px;
+        color: #666;
+        line-height: 1.5;
+      }
+
+      .playkit-back-button {
+        position: absolute;
+        left: 0;
+        top: 0;
+        background: transparent;
+        border: none;
+        cursor: pointer;
+        padding: 4px;
+        color: #666;
+        transition: background-color 0.2s ease, color 0.2s ease;
+      }
+
+      .playkit-back-button:hover {
+        background: #f5f5f5;
+        color: #171717;
+      }
+
+      .playkit-auth-toggle {
+        display: flex;
+        background: #f5f5f5;
+        padding: 2px;
+        margin-bottom: 20px;
+        gap: 2px;
+      }
+
+      .playkit-toggle-option {
+        flex: 1;
+        display: flex;
+        justify-content: center;
+        align-items: center;
+        padding: 10px 16px;
+        cursor: pointer;
+        transition: background-color 0.2s ease;
+      }
+
+      .playkit-toggle-option input {
+        display: none;
+      }
+
+      .playkit-toggle-option span {
+        font-size: 14px;
+        font-weight: 500;
+        color: #666;
+        transition: color 0.2s ease;
+      }
+
+      .playkit-toggle-option input:checked + span {
+        color: #fff;
+      }
+
+      .playkit-toggle-option:has(input:checked) {
+        background: #171717;
+      }
+
+      .playkit-auth-input-group {
+        margin-bottom: 20px;
+      }
+
+      .playkit-input-wrapper {
+        position: relative;
+        display: flex;
+        align-items: center;
+      }
+
+      .playkit-input-icon {
+        position: absolute;
+        left: 12px;
+        color: #999;
+        pointer-events: none;
+      }
+
+      .playkit-input-wrapper input {
+        width: 100%;
+        padding: 10px 12px 10px 44px;
+        border: 1px solid #e5e7eb;
+        font-size: 14px;
+        transition: border-color 0.2s ease;
+        box-sizing: border-box;
+        background: #fff;
+      }
+
+      .playkit-input-wrapper input:hover {
+        border-color: #d4d4d4;
+      }
+
+      .playkit-input-wrapper input:focus {
+        outline: none;
+        border-color: #171717;
+      }
+
+      .playkit-code-inputs {
+        display: flex;
+        gap: 8px;
+        justify-content: center;
+      }
+
+      .playkit-code-input {
+        width: 40px !important;
+        height: 48px;
+        text-align: center;
+        font-size: 20px;
+        font-weight: 600;
+        border: 1px solid #e5e7eb !important;
+        padding: 0 !important;
+        transition: border-color 0.2s ease;
+        background: #fff;
+        -moz-appearance: textfield;
+      }
+
+      .playkit-code-input::-webkit-outer-spin-button,
+      .playkit-code-input::-webkit-inner-spin-button {
+        -webkit-appearance: none;
+        margin: 0;
+      }
+
+      .playkit-code-input:hover {
+        border-color: #d4d4d4 !important;
+      }
+
+      .playkit-code-input:focus {
+        outline: none;
+        border-color: #171717 !important;
+      }
+
+      .playkit-auth-button {
+        width: 100%;
+        padding: 10px 16px;
+        background: #171717;
+        color: white;
+        border: none;
+        font-size: 14px;
+        font-weight: 500;
+        cursor: pointer;
+        transition: background 0.2s ease;
+      }
+
+      .playkit-auth-button:hover:not(:disabled) {
+        background: #404040;
+      }
+
+      .playkit-auth-button:active:not(:disabled) {
+        background: #0a0a0a;
+      }
+
+      .playkit-auth-button:disabled {
+        background: #e5e7eb;
+        color: #999;
+        cursor: not-allowed;
+      }
+
+      .playkit-auth-error {
+        margin-top: 16px;
+        padding: 12px 16px;
+        background: #fef2f2;
+        border: 1px solid #fecaca;
+        color: #dc2626;
+        font-size: 13px;
+        text-align: left;
+        display: none;
+      }
+
+      .playkit-auth-error.show {
+        display: block;
+      }
+
+      .playkit-loading-overlay {
+        position: absolute;
+        top: 0;
+        left: 0;
+        right: 0;
+        bottom: 0;
+        background: rgba(255, 255, 255, 0.96);
+        display: flex;
+        justify-content: center;
+        align-items: center;
+      }
+
+      .playkit-spinner {
+        width: 24px;
+        height: 24px;
+        border: 2px solid #e5e7eb;
+        border-top: 2px solid #171717;
+        border-radius: 50%;
+        animation: playkit-spin 1s linear infinite;
+      }
+
+      @keyframes playkit-spin {
+        0% { transform: rotate(0deg); }
+        100% { transform: rotate(360deg); }
+      }
+
+      @media (max-width: 480px) {
+        .playkit-auth-container {
+          width: 95%;
+          max-width: none;
+        }
+
+        .playkit-auth-panel {
+          padding: 20px;
+        }
+
+        .playkit-code-input {
+          width: 36px !important;
+          height: 44px;
+          font-size: 18px;
+        }
+
+        .playkit-code-inputs {
+          gap: 6px;
+        }
+      }
     `;
 	        document.head.appendChild(style);
 	    }
@@ -1762,14 +1771,14 @@
 	                : this.t('phonePlaceholder');
 	            // Update icon
 	            if (isEmail) {
-	                identifierIcon.innerHTML = `
-          <path d="M4 4h16c1.1 0 2 .9 2 2v12c0 1.1-.9 2-2 2H4c-1.1 0-2-.9-2-2V6c0-1.1.9-2 2-2z"></path>
-          <polyline points="22,6 12,13 2,6"></polyline>
+	                identifierIcon.innerHTML = `
+          <path d="M4 4h16c1.1 0 2 .9 2 2v12c0 1.1-.9 2-2 2H4c-1.1 0-2-.9-2-2V6c0-1.1.9-2 2-2z"></path>
+          <polyline points="22,6 12,13 2,6"></polyline>
         `;
 	            }
 	            else {
-	                identifierIcon.innerHTML = `
-          <path d="M22 16.92v3a2 2 0 0 1-2.18 2 19.79 19.79 0 0 1-8.63-3.07 19.5 19.5 0 0 1-6-6 19.79 19.79 0 0 1-3.07-8.67A2 2 0 0 1 4.11 2h3a2 2 0 0 1 2 1.72 12.84 12.84 0 0 0 .7 2.81 2 2 0 0 1-.45 2.11L8.09 9.91a16 16 0 0 0 6 6l1.27-1.27a2 2 0 0 1 2.11-.45 12.84 12.84 0 0 0 2.81.7A2 2 0 0 1 22 16.92z"></path>
+	                identifierIcon.innerHTML = `
+          <path d="M22 16.92v3a2 2 0 0 1-2.18 2 19.79 19.79 0 0 1-8.63-3.07 19.5 19.5 0 0 1-6-6 19.79 19.79 0 0 1-3.07-8.67A2 2 0 0 1 4.11 2h3a2 2 0 0 1 2 1.72 12.84 12.84 0 0 0 .7 2.81 2 2 0 0 1-.45 2.11L8.09 9.91a16 16 0 0 0 6 6l1.27-1.27a2 2 0 0 1 2.11-.45 12.84 12.84 0 0 0 2.81.7A2 2 0 0 1 22 16.92z"></path>
         `;
 	            }
 	        };
@@ -1790,7 +1799,7 @@
 	            this.otpInstance = new window.VanillaOTP(codeInputsContainer);
 	            // Auto-submit when all 6 digits entered
 	            const codeInputs = (_d = this.modal) === null || _d === void 0 ? void 0 : _d.querySelectorAll('.playkit-code-input');
-	            codeInputs === null || codeInputs === void 0 ? void 0 : codeInputs.forEach((input, index) => {
+	            codeInputs === null || codeInputs === void 0 ? void 0 : codeInputs.forEach((input, _index) => {
 	                input.addEventListener('input', () => {
 	                    // Check if all inputs are filled
 	                    const allFilled = Array.from(codeInputs).every(inp => inp.value.length === 1);
@@ -1882,7 +1891,7 @@
 	    async sendVerificationCode(identifier, type) {
 	        const response = await fetch(`${this.baseURL}/api/auth/send-code`, {
 	            method: 'POST',
-	            headers: { 'Content-Type': 'application/json' },
+	            headers: Object.assign({ 'Content-Type': 'application/json' }, getSDKHeaders()),
 	            body: JSON.stringify({ identifier, type }),
 	        });
 	        if (!response.ok) {
@@ -1904,7 +1913,7 @@
 	        }
 	        const response = await fetch(`${this.baseURL}/api/auth/verify-code`, {
 	            method: 'POST',
-	            headers: { 'Content-Type': 'application/json' },
+	            headers: Object.assign({ 'Content-Type': 'application/json' }, getSDKHeaders()),
 	            body: JSON.stringify({
 	                sessionId: this.currentSessionId,
 	                code,
@@ -1925,7 +1934,9 @@
 	    async setDefaultAuthTypeByRegion() {
 	        var _a;
 	        try {
-	            const response = await fetch(`${this.baseURL}/api/reachability`);
+	            const response = await fetch(`${this.baseURL}/api/reachability`, {
+	                headers: Object.assign({}, getSDKHeaders()),
+	            });
 	            if (response.ok) {
 	                const data = await response.json();
 	                if (data.region === 'CN') {
@@ -2182,76 +2193,76 @@
 	        // Create modal overlay - dark bg-black/80 style
 	        const overlay = document.createElement('div');
 	        overlay.id = 'playkit-login-modal';
-	        overlay.style.cssText = `
-      position: fixed;
-      top: 0;
-      left: 0;
-      right: 0;
-      bottom: 0;
-      background: rgba(0, 0, 0, 0.8);
-      display: flex;
-      align-items: center;
-      justify-content: center;
-      z-index: 999999;
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+	        overlay.style.cssText = `
+      position: fixed;
+      top: 0;
+      left: 0;
+      right: 0;
+      bottom: 0;
+      background: rgba(0, 0, 0, 0.8);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      z-index: 999999;
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
     `;
 	        // Create modal card - square corners, shadow-xl style
 	        const card = document.createElement('div');
-	        card.style.cssText = `
-      background: #fff;
-      border: 1px solid rgba(0, 0, 0, 0.1);
-      padding: 24px;
-      max-width: 320px;
-      width: 90%;
-      box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.05);
-      text-align: center;
+	        card.style.cssText = `
+      background: #fff;
+      border: 1px solid rgba(0, 0, 0, 0.1);
+      padding: 24px;
+      max-width: 320px;
+      width: 90%;
+      box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.05);
+      text-align: center;
     `;
 	        // Subtitle / status text
 	        const subtitle = document.createElement('p');
 	        subtitle.id = 'playkit-modal-subtitle';
 	        subtitle.textContent = this.t('loginWithPlayKit');
-	        subtitle.style.cssText = `
-      margin: 0 0 20px;
-      font-size: 14px;
-      color: #666;
+	        subtitle.style.cssText = `
+      margin: 0 0 20px;
+      font-size: 14px;
+      color: #666;
     `;
 	        card.appendChild(subtitle);
 	        // Loading spinner (hidden initially)
 	        const spinner = document.createElement('div');
 	        spinner.id = 'playkit-modal-spinner';
-	        spinner.style.cssText = `
-      display: none;
-      width: 24px;
-      height: 24px;
-      margin: 0 auto 16px;
-      border: 2px solid #e5e7eb;
-      border-top-color: #171717;
-      border-radius: 50%;
-      animation: playkit-spin 1s linear infinite;
+	        spinner.style.cssText = `
+      display: none;
+      width: 24px;
+      height: 24px;
+      margin: 0 auto 16px;
+      border: 2px solid #e5e7eb;
+      border-top-color: #171717;
+      border-radius: 50%;
+      animation: playkit-spin 1s linear infinite;
     `;
 	        card.appendChild(spinner);
 	        // Add keyframes for spinner
 	        const style = document.createElement('style');
-	        style.textContent = `
-      @keyframes playkit-spin {
-        to { transform: rotate(360deg); }
-      }
+	        style.textContent = `
+      @keyframes playkit-spin {
+        to { transform: rotate(360deg); }
+      }
     `;
 	        document.head.appendChild(style);
 	        // Login button - square corners, simple dark style
 	        const loginBtn = document.createElement('button');
 	        loginBtn.id = 'playkit-modal-login-btn';
 	        loginBtn.textContent = this.t('loginToPlay');
-	        loginBtn.style.cssText = `
-      width: 100%;
-      padding: 10px 16px;
-      font-size: 14px;
-      font-weight: 500;
-      color: white;
-      background: #171717;
-      border: none;
-      cursor: pointer;
-      transition: background 0.2s ease;
+	        loginBtn.style.cssText = `
+      width: 100%;
+      padding: 10px 16px;
+      font-size: 14px;
+      font-weight: 500;
+      color: white;
+      background: #171717;
+      border: none;
+      cursor: pointer;
+      transition: background 0.2s ease;
     `;
 	        loginBtn.onmouseenter = () => {
 	            loginBtn.style.background = '#404040';
@@ -2278,18 +2289,18 @@
 	        const cancelBtn = document.createElement('button');
 	        cancelBtn.id = 'playkit-modal-cancel-btn';
 	        cancelBtn.textContent = this.t('cancel');
-	        cancelBtn.style.cssText = `
-      display: none;
-      width: 100%;
-      margin-top: 8px;
-      padding: 10px 16px;
-      font-size: 14px;
-      font-weight: 500;
-      color: #666;
-      background: transparent;
-      border: 1px solid #e5e7eb;
-      cursor: pointer;
-      transition: all 0.2s ease;
+	        cancelBtn.style.cssText = `
+      display: none;
+      width: 100%;
+      margin-top: 8px;
+      padding: 10px 16px;
+      font-size: 14px;
+      font-weight: 500;
+      color: #666;
+      background: transparent;
+      border: 1px solid #e5e7eb;
+      cursor: pointer;
+      transition: all 0.2s ease;
     `;
 	        cancelBtn.onmouseenter = () => {
 	            cancelBtn.style.background = '#f5f5f5';
@@ -2359,11 +2370,11 @@
 	        // Create error title
 	        const errorTitle = document.createElement('h3');
 	        errorTitle.textContent = this.t(titleKey);
-	        errorTitle.style.cssText = `
-      margin: 0 0 8px;
-      font-size: 14px;
-      font-weight: 600;
-      color: ${iconColor};
+	        errorTitle.style.cssText = `
+      margin: 0 0 8px;
+      font-size: 14px;
+      font-weight: 600;
+      color: ${iconColor};
     `;
 	        // Update subtitle with error description
 	        subtitle.textContent = this.t(descKey);
@@ -2433,9 +2444,7 @@
 	        // Step 1: Initiate device auth session
 	        const initResponse = await fetch(`${this.baseURL}/api/device-auth/initiate`, {
 	            method: 'POST',
-	            headers: {
-	                'Content-Type': 'application/json',
-	            },
+	            headers: Object.assign({ 'Content-Type': 'application/json' }, getSDKHeaders()),
 	            body: JSON.stringify({
 	                game_id: this.gameId,
 	                code_challenge: codeChallenge,
@@ -2504,7 +2513,7 @@
 	                    return;
 	                }
 	                try {
-	                    const pollResponse = await fetch(`${this.baseURL}/api/device-auth/poll?session_id=${encodeURIComponent(session_id)}&code_verifier=${encodeURIComponent(codeVerifier)}`);
+	                    const pollResponse = await fetch(`${this.baseURL}/api/device-auth/poll?session_id=${encodeURIComponent(session_id)}&code_verifier=${encodeURIComponent(codeVerifier)}`, { headers: Object.assign({}, getSDKHeaders()) });
 	                    const pollData = await pollResponse.json();
 	                    if (pollResponse.ok) {
 	                        if (pollData.status === 'pending') {
@@ -2632,9 +2641,7 @@
 	        // Initiate device auth session
 	        const initResponse = await fetch(`${this.baseURL}/api/device-auth/initiate`, {
 	            method: 'POST',
-	            headers: {
-	                'Content-Type': 'application/json',
-	            },
+	            headers: Object.assign({ 'Content-Type': 'application/json' }, getSDKHeaders()),
 	            body: JSON.stringify({
 	                game_id: this.gameId,
 	                code_challenge: codeChallenge,
@@ -2697,7 +2704,7 @@
 	                    return;
 	                }
 	                try {
-	                    const pollResponse = await fetch(`${this.baseURL}/api/device-auth/poll?session_id=${encodeURIComponent(sessionId)}&code_verifier=${encodeURIComponent(codeVerifier)}`);
+	                    const pollResponse = await fetch(`${this.baseURL}/api/device-auth/poll?session_id=${encodeURIComponent(sessionId)}&code_verifier=${encodeURIComponent(codeVerifier)}`, { headers: Object.assign({}, getSDKHeaders()) });
 	                    const pollData = await pollResponse.json();
 	                    if (pollResponse.ok) {
 	                        if (pollData.status === 'pending') {
@@ -2777,6 +2784,8 @@
 	        this.logger = Logger.getLogger('AuthManager');
 	        /** Shared promise for current device auth flow - allows multiple callers to await the same result */
 	        this.currentDeviceAuthFlowPromise = null;
+	        /** Shared promise for current auth flow (startAuthFlow) - allows multiple callers to await the same result */
+	        this.currentAuthFlowPromise = null;
 	        this.config = config;
 	        // Create TokenStorage with appropriate mode for server vs browser environment
 	        this.storage = new TokenStorage({
@@ -2885,12 +2894,27 @@
 	     * @deprecated 'headless' authentication is deprecated and will be removed in v2.0. Use 'device' instead.
 	     */
 	    async startAuthFlow(authMethod = 'device') {
-	        var _a, _b;
-	        if (this.authFlowManager || this.deviceAuthFlowManager) {
-	            // Already in progress
-	            this.logger.warn('Auth flow already in progress, ignoring duplicate call');
-	            return;
+	        // If a flow is already in progress, return the shared promise so all callers await the same result
+	        if (this.currentAuthFlowPromise) {
+	            this.logger.debug('Auth flow already in progress, waiting for existing flow');
+	            return this.currentAuthFlowPromise;
+	        }
+	        // Store the flow promise so subsequent calls can await the same result
+	        const flowPromise = this.executeAuthFlow(authMethod);
+	        this.currentAuthFlowPromise = flowPromise;
+	        try {
+	            return await flowPromise;
+	        }
+	        finally {
+	            this.currentAuthFlowPromise = null;
 	        }
+	    }
+	    /**
+	     * Internal method that executes the actual auth flow
+	     * @private
+	     */
+	    async executeAuthFlow(authMethod = 'device') {
+	        var _a, _b;
 	        // Deprecation warning for headless auth
 	        if (authMethod === 'headless') {
 	            this.logger.warn('"headless" authentication is deprecated and will be removed in v2.0. ' +
@@ -2949,10 +2973,7 @@
 	        try {
 	            const response = await fetch(`${this.baseURL}${JWT_EXCHANGE_ENDPOINT}`, {
 	                method: 'POST',
-	                headers: {
-	                    Authorization: `Bearer ${jwt}`,
-	                    'Content-Type': 'application/json',
-	                },
+	                headers: Object.assign({ Authorization: `Bearer ${jwt}`, 'Content-Type': 'application/json' }, getSDKHeaders()),
 	                body: JSON.stringify({ gameId: this.config.gameId }),
 	            });
 	            if (!response.ok) {
@@ -3302,9 +3323,7 @@
 	            this.logger.debug('Refreshing access token');
 	            const response = await fetch(`${this.baseURL}${TOKEN_REFRESH_ENDPOINT}`, {
 	                method: 'POST',
-	                headers: {
-	                    'Content-Type': 'application/json',
-	                },
+	                headers: Object.assign({ 'Content-Type': 'application/json' }, getSDKHeaders()),
 	                body: JSON.stringify({
 	                    refresh_token: this.authState.refreshToken,
 	                }),
@@ -3407,7 +3426,7 @@
 	 * RechargeManager handles the recharge modal UI and recharge window opening
 	 */
 	class RechargeManager extends EventEmitter {
-	    constructor(playerToken, rechargePortalUrl = 'https://playkit.ai/recharge', gameId) {
+	    constructor(playerToken, rechargePortalUrl = 'https://players.playkit.ai/recharge', gameId) {
 	        super();
 	        this.modalContainer = null;
 	        this.styleElement = null;
@@ -3510,220 +3529,220 @@
 	            return;
 	        }
 	        this.styleElement = document.createElement('style');
-	        this.styleElement.textContent = `
-      .playkit-recharge-overlay {
-        position: fixed;
-        top: 0;
-        left: 0;
-        right: 0;
-        bottom: 0;
-        background: rgba(0, 0, 0, 0.8);
-        display: flex;
-        justify-content: center;
-        align-items: center;
-        z-index: 999999;
-        animation: playkit-recharge-fadeIn 0.2s ease-out;
-        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-      }
-
-      @keyframes playkit-recharge-fadeIn {
-        from {
-          opacity: 0;
-        }
-        to {
-          opacity: 1;
-        }
-      }
-
-      .playkit-recharge-modal {
-        background: #fff;
-        border: 1px solid rgba(0, 0, 0, 0.1);
-        box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.05);
-        padding: 24px;
-        max-width: 320px;
-        width: 90%;
-        position: relative;
-        text-align: center;
-      }
-
-      .playkit-recharge-title {
-        font-size: 14px;
-        font-weight: 600;
-        color: #171717;
-        margin: 0 0 8px 0;
-        text-align: center;
-        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-      }
-
-      .playkit-recharge-message {
-        font-size: 14px;
-        color: #666;
-        margin: 0 0 20px 0;
-        text-align: center;
-        line-height: 1.5;
-        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-      }
-
-      .playkit-recharge-balance {
-        background: #f5f5f5;
-        border: 1px solid #e5e7eb;
-        padding: 16px;
-        margin: 0 0 20px 0;
-        text-align: center;
-      }
-
-      .playkit-recharge-balance-label {
-        font-size: 12px;
-        color: #666;
-        margin: 0 0 8px 0;
-        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-      }
-
-      .playkit-recharge-balance-value {
-        font-size: 24px;
-        font-weight: bold;
-        color: #171717;
-        margin: 0;
-        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-      }
-
-      .playkit-recharge-balance-unit {
-        font-size: 14px;
-        color: #666;
-        margin-left: 4px;
-      }
-
-      .playkit-recharge-buttons {
-        display: flex;
-        flex-direction: column;
-        gap: 8px;
-      }
-
-      .playkit-recharge-button {
-        width: 100%;
-        padding: 10px 16px;
-        border: none;
-        font-size: 14px;
-        font-weight: 500;
-        cursor: pointer;
-        transition: all 0.2s ease;
-        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-      }
-
-      .playkit-recharge-button-primary {
-        background: #171717;
-        color: white;
-      }
-
-      .playkit-recharge-button-primary:hover {
-        background: #404040;
-      }
-
-      .playkit-recharge-button-primary:active {
-        background: #0a0a0a;
-      }
-
-      .playkit-recharge-button-secondary {
-        background: transparent;
-        color: #666;
-        border: 1px solid #e5e7eb;
-      }
-
-      .playkit-recharge-button-secondary:hover {
-        background: #f5f5f5;
-        border-color: #d4d4d4;
-      }
-
-      .playkit-recharge-button-secondary:active {
-        background: #e5e5e5;
-      }
-
-      @media (max-width: 480px) {
-        .playkit-recharge-modal {
-          padding: 20px;
-        }
-      }
-
-      /* Daily Refresh Toast Styles */
-      .playkit-daily-refresh-toast {
-        position: fixed;
-        top: 20px;
-        right: 20px;
-        background: #fff;
-        border: 1px solid rgba(0, 0, 0, 0.1);
-        box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.1);
-        padding: 16px 20px;
-        min-width: 240px;
-        max-width: 320px;
-        z-index: 999998;
-        animation: playkit-toast-slideIn 0.3s ease-out;
-        display: flex;
-        align-items: flex-start;
-        gap: 12px;
-        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-      }
-
-      .playkit-daily-refresh-toast.hiding {
-        animation: playkit-toast-fadeOut 0.3s ease-out forwards;
-      }
-
-      @keyframes playkit-toast-slideIn {
-        from {
-          transform: translateX(100%);
-          opacity: 0;
-        }
-        to {
-          transform: translateX(0);
-          opacity: 1;
-        }
-      }
-
-      @keyframes playkit-toast-fadeOut {
-        from {
-          transform: translateX(0);
-          opacity: 1;
-        }
-        to {
-          transform: translateX(100%);
-          opacity: 0;
-        }
-      }
-
-      .playkit-toast-icon {
-        width: 24px;
-        height: 24px;
-        background: #171717;
-        border-radius: 50%;
-        display: flex;
-        align-items: center;
-        justify-content: center;
-        flex-shrink: 0;
-      }
-
-      .playkit-toast-icon svg {
-        width: 14px;
-        height: 14px;
-        color: #ffffff;
-      }
-
-      .playkit-toast-message {
-        flex: 1;
-        font-size: 14px;
-        font-weight: 500;
-        color: #171717;
-        line-height: 1.4;
-        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-      }
-
-      @media (max-width: 480px) {
-        .playkit-daily-refresh-toast {
-          top: 10px;
-          right: 10px;
-          left: 10px;
-          min-width: auto;
-          max-width: none;
-        }
-      }
+	        this.styleElement.textContent = `
+      .playkit-recharge-overlay {
+        position: fixed;
+        top: 0;
+        left: 0;
+        right: 0;
+        bottom: 0;
+        background: rgba(0, 0, 0, 0.8);
+        display: flex;
+        justify-content: center;
+        align-items: center;
+        z-index: 999999;
+        animation: playkit-recharge-fadeIn 0.2s ease-out;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      }
+
+      @keyframes playkit-recharge-fadeIn {
+        from {
+          opacity: 0;
+        }
+        to {
+          opacity: 1;
+        }
+      }
+
+      .playkit-recharge-modal {
+        background: #fff;
+        border: 1px solid rgba(0, 0, 0, 0.1);
+        box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.05);
+        padding: 24px;
+        max-width: 320px;
+        width: 90%;
+        position: relative;
+        text-align: center;
+      }
+
+      .playkit-recharge-title {
+        font-size: 14px;
+        font-weight: 600;
+        color: #171717;
+        margin: 0 0 8px 0;
+        text-align: center;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      }
+
+      .playkit-recharge-message {
+        font-size: 14px;
+        color: #666;
+        margin: 0 0 20px 0;
+        text-align: center;
+        line-height: 1.5;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      }
+
+      .playkit-recharge-balance {
+        background: #f5f5f5;
+        border: 1px solid #e5e7eb;
+        padding: 16px;
+        margin: 0 0 20px 0;
+        text-align: center;
+      }
+
+      .playkit-recharge-balance-label {
+        font-size: 12px;
+        color: #666;
+        margin: 0 0 8px 0;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      }
+
+      .playkit-recharge-balance-value {
+        font-size: 24px;
+        font-weight: bold;
+        color: #171717;
+        margin: 0;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      }
+
+      .playkit-recharge-balance-unit {
+        font-size: 14px;
+        color: #666;
+        margin-left: 4px;
+      }
+
+      .playkit-recharge-buttons {
+        display: flex;
+        flex-direction: column;
+        gap: 8px;
+      }
+
+      .playkit-recharge-button {
+        width: 100%;
+        padding: 10px 16px;
+        border: none;
+        font-size: 14px;
+        font-weight: 500;
+        cursor: pointer;
+        transition: all 0.2s ease;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      }
+
+      .playkit-recharge-button-primary {
+        background: #171717;
+        color: white;
+      }
+
+      .playkit-recharge-button-primary:hover {
+        background: #404040;
+      }
+
+      .playkit-recharge-button-primary:active {
+        background: #0a0a0a;
+      }
+
+      .playkit-recharge-button-secondary {
+        background: transparent;
+        color: #666;
+        border: 1px solid #e5e7eb;
+      }
+
+      .playkit-recharge-button-secondary:hover {
+        background: #f5f5f5;
+        border-color: #d4d4d4;
+      }
+
+      .playkit-recharge-button-secondary:active {
+        background: #e5e5e5;
+      }
+
+      @media (max-width: 480px) {
+        .playkit-recharge-modal {
+          padding: 20px;
+        }
+      }
+
+      /* Daily Refresh Toast Styles */
+      .playkit-daily-refresh-toast {
+        position: fixed;
+        top: 20px;
+        right: 20px;
+        background: #fff;
+        border: 1px solid rgba(0, 0, 0, 0.1);
+        box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.1);
+        padding: 16px 20px;
+        min-width: 240px;
+        max-width: 320px;
+        z-index: 999998;
+        animation: playkit-toast-slideIn 0.3s ease-out;
+        display: flex;
+        align-items: flex-start;
+        gap: 12px;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      }
+
+      .playkit-daily-refresh-toast.hiding {
+        animation: playkit-toast-fadeOut 0.3s ease-out forwards;
+      }
+
+      @keyframes playkit-toast-slideIn {
+        from {
+          transform: translateX(100%);
+          opacity: 0;
+        }
+        to {
+          transform: translateX(0);
+          opacity: 1;
+        }
+      }
+
+      @keyframes playkit-toast-fadeOut {
+        from {
+          transform: translateX(0);
+          opacity: 1;
+        }
+        to {
+          transform: translateX(100%);
+          opacity: 0;
+        }
+      }
+
+      .playkit-toast-icon {
+        width: 24px;
+        height: 24px;
+        background: #171717;
+        border-radius: 50%;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        flex-shrink: 0;
+      }
+
+      .playkit-toast-icon svg {
+        width: 14px;
+        height: 14px;
+        color: #ffffff;
+      }
+
+      .playkit-toast-message {
+        flex: 1;
+        font-size: 14px;
+        font-weight: 500;
+        color: #171717;
+        line-height: 1.4;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      }
+
+      @media (max-width: 480px) {
+        .playkit-daily-refresh-toast {
+          top: 10px;
+          right: 10px;
+          left: 10px;
+          min-width: auto;
+          max-width: none;
+        }
+      }
     `;
 	        document.head.appendChild(this.styleElement);
 	    }
@@ -3860,7 +3879,8 @@
 	/**
 	 * Player client for managing player information and credits
 	 */
-	const DEFAULT_BASE_URL$4 = 'https://playkit.ai';
+	// @ts-ignore - replaced at build time
+	const DEFAULT_BASE_URL$4 = "https://api.playkit.ai";
 	const PLAYER_INFO_ENDPOINT = '/api/external/player-info';
 	const SET_NICKNAME_ENDPOINT = '/api/external/set-game-player-nickname';
 	class PlayerClient extends EventEmitter {
@@ -3878,7 +3898,7 @@
 	            autoShowBalanceModal: (_a = rechargeConfig.autoShowBalanceModal) !== null && _a !== void 0 ? _a : true,
 	            balanceCheckInterval: (_b = rechargeConfig.balanceCheckInterval) !== null && _b !== void 0 ? _b : 30000,
 	            checkBalanceAfterApiCall: (_c = rechargeConfig.checkBalanceAfterApiCall) !== null && _c !== void 0 ? _c : true,
-	            rechargePortalUrl: rechargeConfig.rechargePortalUrl || 'https://playkit.ai/recharge',
+	            rechargePortalUrl: rechargeConfig.rechargePortalUrl || 'https://players.playkit.ai/recharge',
 	            showDailyRefreshToast: (_d = rechargeConfig.showDailyRefreshToast) !== null && _d !== void 0 ? _d : true,
 	        };
 	    }
@@ -3893,9 +3913,7 @@
 	        }
 	        try {
 	            // Build headers with X-Game-Id to support Global Developer Token
-	            const headers = {
-	                Authorization: `Bearer ${token}`,
-	            };
+	            const headers = Object.assign({ Authorization: `Bearer ${token}` }, getSDKHeaders());
 	            if (this.gameId) {
 	                headers['X-Game-Id'] = this.gameId;
 	            }
@@ -3995,10 +4013,7 @@
 	        try {
 	            const response = await fetch(`${this.baseURL}${SET_NICKNAME_ENDPOINT}`, {
 	                method: 'POST',
-	                headers: {
-	                    Authorization: `Bearer ${token}`,
-	                    'Content-Type': 'application/json',
-	                },
+	                headers: Object.assign({ Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' }, getSDKHeaders()),
 	                body: JSON.stringify({ nickname: trimmed }),
 	            });
 	            if (!response.ok) {
@@ -4148,10 +4163,84 @@
 	    }
 	}
 
+	const VALID_PART_TYPES = new Set([
+	    'text',
+	    'image',
+	    'image_url',
+	    'file',
+	    'audio',
+	    'input_audio',
+	]);
+	function describePart(part) {
+	    if (part === null)
+	        return 'null';
+	    if (typeof part !== 'object')
+	        return typeof part;
+	    const keys = Object.keys(part).slice(0, 5).join(',');
+	    return `{${keys}}`;
+	}
+	/**
+	 * Validate that `messages` matches the SDK's `Message[]` runtime contract before
+	 * shipping to the chat API. Throws `PlayKitError('INVALID_MESSAGES')` when a
+	 * caller has wrapped a Message[] inside one user message's `content` (the
+	 * `[{role:'user', content: [{role,...}, ...]}]` anti-pattern that bypasses the
+	 * `MessageContentPart` type at runtime).
+	 *
+	 * Does NOT auto-flatten — silently guessing system/user roles would mask bugs.
+	 */
+	function assertValidMessages(messages) {
+	    if (!Array.isArray(messages)) {
+	        throw new PlayKitError('messages must be an array of Message', 'INVALID_MESSAGES');
+	    }
+	    for (let i = 0; i < messages.length; i++) {
+	        const msg = messages[i];
+	        if (!msg || typeof msg !== 'object') {
+	            throw new PlayKitError(`messages[${i}] must be an object with {role, content}`, 'INVALID_MESSAGES');
+	        }
+	        const content = msg.content;
+	        if (typeof content === 'string' || content == null)
+	            continue;
+	        if (!Array.isArray(content)) {
+	            throw new PlayKitError(`messages[${i}].content must be a string or an array of content parts (got ${typeof content})`, 'INVALID_MESSAGES');
+	        }
+	        for (let j = 0; j < content.length; j++) {
+	            const part = content[j];
+	            if (!part || typeof part !== 'object') {
+	                throw new PlayKitError(`messages[${i}].content[${j}] must be a content part object (got ${typeof part})`, 'INVALID_MESSAGES');
+	            }
+	            const hasType = typeof part.type === 'string' && VALID_PART_TYPES.has(part.type);
+	            if (!hasType) {
+	                if ('role' in part && 'content' in part) {
+	                    throw new PlayKitError(`messages[${i}].content[${j}] is shaped like a Message (has role/content) ` +
+	                        `but content parts must be {type:'text'|'image'|'image_url'|'file'|'audio'|'input_audio',...}. ` +
+	                        `Did you mean to pass that array as messages directly? ` +
+	                        `e.g. \`messages: theArray\` instead of \`messages: [{role:'user', content: theArray}]\`. ` +
+	                        `Got part ${describePart(part)}`, 'INVALID_MESSAGES');
+	                }
+	                throw new PlayKitError(`messages[${i}].content[${j}] is missing a recognized 'type' field ` +
+	                    `(expected one of text|image|image_url|file|audio|input_audio). Got part ${describePart(part)}`, 'INVALID_MESSAGES');
+	            }
+	        }
+	    }
+	}
+
 	/**
 	 * Chat provider for HTTP communication with chat API
 	 */
-	const DEFAULT_BASE_URL$3 = 'https://playkit.ai';
+	/**
+	 * Helper to extract string from MessageContent
+	 */
+	function contentToString$1(content) {
+	    if (!content)
+	        return '';
+	    if (typeof content === 'string')
+	        return content;
+	    // For array of content parts, extract text parts
+	    const textParts = content.filter(part => part.type === 'text');
+	    return textParts.map(part => part.text).join('');
+	}
+	// @ts-ignore - replaced at build time
+	const DEFAULT_BASE_URL$3 = "https://api.playkit.ai";
 	class ChatProvider {
 	    constructor(authManager, config) {
 	        this.authManager = authManager;
@@ -4169,6 +4258,7 @@
 	     */
 	    async chatCompletion(chatConfig) {
 	        var _a;
+	        assertValidMessages(chatConfig.messages);
 	        // Ensure token is valid, auto-refresh if needed (browser mode only)
 	        await this.authManager.ensureValidToken();
 	        const token = this.authManager.getToken();
@@ -4190,10 +4280,7 @@
 	        try {
 	            const response = await fetch(`${this.baseURL}${endpoint}`, {
 	                method: 'POST',
-	                headers: {
-	                    Authorization: `Bearer ${token}`,
-	                    'Content-Type': 'application/json',
-	                },
+	                headers: Object.assign({ Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' }, getSDKHeaders()),
 	                body: JSON.stringify(requestBody),
 	            });
 	            if (!response.ok) {
@@ -4228,6 +4315,7 @@
 	     */
 	    async chatCompletionStream(chatConfig) {
 	        var _a;
+	        assertValidMessages(chatConfig.messages);
 	        // Ensure token is valid, auto-refresh if needed (browser mode only)
 	        await this.authManager.ensureValidToken();
 	        const token = this.authManager.getToken();
@@ -4249,10 +4337,7 @@
 	        try {
 	            const response = await fetch(`${this.baseURL}${endpoint}`, {
 	                method: 'POST',
-	                headers: {
-	                    Authorization: `Bearer ${token}`,
-	                    'Content-Type': 'application/json',
-	                },
+	                headers: Object.assign({ Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' }, getSDKHeaders()),
 	                body: JSON.stringify(requestBody),
 	            });
 	            if (!response.ok) {
@@ -4289,6 +4374,7 @@
 	     */
 	    async chatCompletionWithTools(chatConfig) {
 	        var _a, _b;
+	        assertValidMessages(chatConfig.messages);
 	        const token = this.authManager.getToken();
 	        if (!token) {
 	            throw new PlayKitError('Not authenticated', 'NOT_AUTHENTICATED');
@@ -4315,10 +4401,7 @@
 	        try {
 	            const response = await fetch(`${this.baseURL}${endpoint}`, {
 	                method: 'POST',
-	                headers: {
-	                    Authorization: `Bearer ${token}`,
-	                    'Content-Type': 'application/json',
-	                },
+	                headers: Object.assign({ Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' }, getSDKHeaders()),
 	                body: JSON.stringify(requestBody),
 	            });
 	            if (!response.ok) {
@@ -4349,6 +4432,7 @@
 	     */
 	    async chatCompletionWithToolsStream(chatConfig) {
 	        var _a, _b;
+	        assertValidMessages(chatConfig.messages);
 	        const token = this.authManager.getToken();
 	        if (!token) {
 	            throw new PlayKitError('Not authenticated', 'NOT_AUTHENTICATED');
@@ -4375,10 +4459,7 @@
 	        try {
 	            const response = await fetch(`${this.baseURL}${endpoint}`, {
 	                method: 'POST',
-	                headers: {
-	                    Authorization: `Bearer ${token}`,
-	                    'Content-Type': 'application/json',
-	                },
+	                headers: Object.assign({ Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' }, getSDKHeaders()),
 	                body: JSON.stringify(requestBody),
 	            });
 	            if (!response.ok) {
@@ -4448,10 +4529,7 @@
 	        try {
 	            const response = await fetch(`${this.baseURL}${endpoint}`, {
 	                method: 'POST',
-	                headers: {
-	                    Authorization: `Bearer ${token}`,
-	                    'Content-Type': 'application/json',
-	                },
+	                headers: Object.assign({ Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' }, getSDKHeaders()),
 	                body: JSON.stringify(requestBody),
 	            });
 	            if (!response.ok) {
@@ -4469,11 +4547,12 @@
 	                this.playerClient.checkBalanceAfterApiCall().catch(() => { });
 	            }
 	            // Parse the response content as JSON
-	            const content = (_a = result.choices[0]) === null || _a === void 0 ? void 0 : _a.message.content;
-	            if (!content) {
+	            const rawContent = (_a = result.choices[0]) === null || _a === void 0 ? void 0 : _a.message.content;
+	            if (!rawContent) {
 	                throw new PlayKitError('No content in response', 'NO_CONTENT');
 	            }
 	            try {
+	                const content = contentToString$1(rawContent);
 	                return JSON.parse(content);
 	            }
 	            catch (parseError) {
@@ -4492,7 +4571,8 @@
 	/**
 	 * Image generation provider for HTTP communication with image API
 	 */
-	const DEFAULT_BASE_URL$2 = 'https://playkit.ai';
+	// @ts-ignore - replaced at build time
+	const DEFAULT_BASE_URL$2 = "https://api.playkit.ai";
 	class ImageProvider {
 	    constructor(authManager, config) {
 	        this.authManager = authManager;
@@ -4545,10 +4625,7 @@
 	        try {
 	            const response = await fetch(`${this.baseURL}${endpoint}`, {
 	                method: 'POST',
-	                headers: {
-	                    Authorization: `Bearer ${token}`,
-	                    'Content-Type': 'application/json',
-	                },
+	                headers: Object.assign({ Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' }, getSDKHeaders()),
 	                body: JSON.stringify(requestBody),
 	            });
 	            if (!response.ok) {
@@ -4583,7 +4660,8 @@
 	/**
 	 * Transcription provider for HTTP communication with audio transcription API
 	 */
-	const DEFAULT_BASE_URL$1 = 'https://playkit.ai';
+	// @ts-ignore - replaced at build time
+	const DEFAULT_BASE_URL$1 = "https://api.playkit.ai";
 	class TranscriptionProvider {
 	    constructor(authManager, config) {
 	        this.authManager = authManager;
@@ -4648,10 +4726,7 @@
 	        try {
 	            const response = await fetch(`${this.baseURL}${endpoint}`, {
 	                method: 'POST',
-	                headers: {
-	                    Authorization: `Bearer ${token}`,
-	                    'Content-Type': 'application/json',
-	                },
+	                headers: Object.assign({ Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' }, getSDKHeaders()),
 	                body: JSON.stringify(requestBody),
 	            });
 	            if (!response.ok) {
@@ -4797,9 +4872,18 @@
 	                                if (text) {
 	                                    yield yield __await(text);
 	                                }
-	                                if (parsed.type === 'done' || parsed.finish_reason) {
+	                                // Stream termination events
+	                                if (parsed.type === 'done' || parsed.type === 'finish' || parsed.finish_reason) {
+	                                    return yield __await(void 0);
+	                                }
+	                                if (parsed.type === 'abort') {
+	                                    // Server-side timeout or cancellation — treat as end of stream
 	                                    return yield __await(void 0);
 	                                }
+	                                if (parsed.type === 'error') {
+	                                    // Server-side error event — throw to trigger onError callback
+	                                    throw new Error(parsed.errorText || parsed.error || 'Stream error');
+	                                }
 	                            }
 	                            catch (error) {
 	                                // If JSON parse fails, treat as plain text
@@ -4898,6 +4982,18 @@
 	/**
 	 * Chat client for AI text generation
 	 */
+	/**
+	 * Helper to extract string from MessageContent
+	 */
+	function contentToString(content) {
+	    if (!content)
+	        return '';
+	    if (typeof content === 'string')
+	        return content;
+	    // For array of content parts, extract text parts
+	    const textParts = content.filter(part => part.type === 'text');
+	    return textParts.map(part => part.text).join('');
+	}
 	class ChatClient {
 	    constructor(provider, model) {
 	        this.schemaLibrary = null;
@@ -4947,7 +5043,7 @@
 	            throw new Error('No choices in response');
 	        }
 	        return {
-	            content: choice.message.content,
+	            content: contentToString(choice.message.content),
 	            model: response.model,
 	            finishReason: choice.finish_reason,
 	            usage: response.usage
@@ -5018,9 +5114,10 @@
 	        }
 	        // Extract user message content from the last user message
 	        const lastUserMessage = [...messages].reverse().find(m => m.role === 'user');
-	        const prompt = (lastUserMessage === null || lastUserMessage === void 0 ? void 0 : lastUserMessage.content) || '';
+	        const prompt = contentToString(lastUserMessage === null || lastUserMessage === void 0 ? void 0 : lastUserMessage.content);
 	        // Build system message from messages array
-	        const systemMessage = (_a = messages.find(m => m.role === 'system')) === null || _a === void 0 ? void 0 : _a.content;
+	        const systemMessageContent = (_a = messages.find(m => m.role === 'system')) === null || _a === void 0 ? void 0 : _a.content;
+	        const systemMessage = contentToString(systemMessageContent) || undefined;
 	        return this.generateStructuredWithSchema(schemaEntry.schema, prompt, Object.assign({ schemaName, schemaDescription: schemaEntry.description, systemMessage }, options));
 	    }
 	    /**
@@ -5111,7 +5208,7 @@
 	            throw new Error('No choices in response');
 	        }
 	        return {
-	            content: choice.message.content || '',
+	            content: contentToString(choice.message.content),
 	            model: response.model,
 	            finishReason: choice.finish_reason,
 	            usage: response.usage
@@ -5175,7 +5272,7 @@
 	        return new Promise((resolve, reject) => {
 	            const img = new Image();
 	            img.onload = () => resolve(img);
-	            img.onerror = (e) => reject(new Error('Failed to load image'));
+	            img.onerror = (_e) => reject(new Error('Failed to load image'));
 	            img.src = this.toDataURL();
 	        });
 	    }
@@ -5189,13 +5286,14 @@
 	     * Generate a single image
 	     */
 	    async generateImage(config) {
+	        var _a;
 	        const imageConfig = Object.assign(Object.assign({}, config), { model: config.model || this.model, n: 1 });
 	        const response = await this.provider.generateImages(imageConfig);
 	        const imageData = response.data[0];
 	        if (!imageData || !imageData.b64_json) {
 	            throw new Error('No image data in response');
 	        }
-	        return new GeneratedImageImpl(imageData.b64_json, config.prompt, imageData.revised_prompt, config.size, imageData.b64_json_original, imageData.transparent_success);
+	        return new GeneratedImageImpl(imageData.b64_json, config.prompt, (_a = imageData.revised_prompt) !== null && _a !== void 0 ? _a : config.prompt, config.size, imageData.b64_json_original, imageData.transparent_success);
 	    }
 	    /**
 	     * Generate multiple images
@@ -5204,10 +5302,11 @@
 	        const imageConfig = Object.assign(Object.assign({}, config), { model: config.model || this.model, n: config.n || 1 });
 	        const response = await this.provider.generateImages(imageConfig);
 	        return response.data.map((imageData) => {
+	            var _a;
 	            if (!imageData.b64_json) {
 	                throw new Error('No image data in response');
 	            }
-	            return new GeneratedImageImpl(imageData.b64_json, config.prompt, imageData.revised_prompt, config.size, imageData.b64_json_original, imageData.transparent_success);
+	            return new GeneratedImageImpl(imageData.b64_json, config.prompt, (_a = imageData.revised_prompt) !== null && _a !== void 0 ? _a : config.prompt, config.size, imageData.b64_json_original, imageData.transparent_success);
 	        });
 	    }
 	    /**
@@ -5326,1019 +5425,1117 @@
 	}
 
 	/**
-	 * NPC Client for simplified conversation management
-	 * Automatically handles conversation history
+	 * Global AI Context Manager for managing NPC conversations and player context.
 	 *
-	 * Key Features:
-	 * - Call talk() for all interactions - actions are handled automatically
-	 * - Memory system for persistent NPC context
-	 * - Reply prediction for suggesting player responses
-	 * - Automatic conversation history management
+	 * Features:
+	 * - Player description management
+	 * - NPC conversation tracking
+	 * - Automatic conversation compaction (AutoCompact)
 	 */
-	class NPCClient extends EventEmitter {
-	    constructor(chatClient, config) {
-	        var _a, _b, _c;
+	/**
+	 * Global AI Context Manager
+	 * Manages NPC conversations and player context across the application
+	 */
+	class AIContextManager extends EventEmitter {
+	    constructor(config) {
+	        var _a, _b, _c, _d, _e;
 	        super();
-	        this._isTalking = false;
-	        this.logger = Logger.getLogger('NPCClient');
-	        this.chatClient = chatClient;
-	        // Support both characterDesign and legacy systemPrompt
-	        this.characterDesign = (config === null || config === void 0 ? void 0 : config.characterDesign) || (config === null || config === void 0 ? void 0 : config.systemPrompt) || 'You are a helpful assistant.';
-	        this.temperature = (_a = config === null || config === void 0 ? void 0 : config.temperature) !== null && _a !== void 0 ? _a : 0.7;
-	        this.maxHistoryLength = (config === null || config === void 0 ? void 0 : config.maxHistoryLength) || 50;
-	        this.generateReplyPrediction = (_b = config === null || config === void 0 ? void 0 : config.generateReplyPrediction) !== null && _b !== void 0 ? _b : false;
-	        this.predictionCount = Math.max(2, Math.min(6, (_c = config === null || config === void 0 ? void 0 : config.predictionCount) !== null && _c !== void 0 ? _c : 4));
-	        this.fastModel = config === null || config === void 0 ? void 0 : config.fastModel;
-	        this.history = [];
-	        this.memories = new Map();
+	        this.playerDescription = null;
+	        this.playerPrompt = null;
+	        this.playerMemories = new Map();
+	        this.npcStates = new Map();
+	        this.autoCompactTimer = null;
+	        this.chatClientFactory = null;
+	        this.logger = Logger.getLogger('AIContextManager');
+	        this.config = {
+	            enableAutoCompact: (_a = config === null || config === void 0 ? void 0 : config.enableAutoCompact) !== null && _a !== void 0 ? _a : false,
+	            autoCompactMinMessages: (_b = config === null || config === void 0 ? void 0 : config.autoCompactMinMessages) !== null && _b !== void 0 ? _b : 20,
+	            autoCompactTimeoutSeconds: (_c = config === null || config === void 0 ? void 0 : config.autoCompactTimeoutSeconds) !== null && _c !== void 0 ? _c : 300,
+	            autoCompactCheckInterval: (_d = config === null || config === void 0 ? void 0 : config.autoCompactCheckInterval) !== null && _d !== void 0 ? _d : 60000,
+	            fastModel: (_e = config === null || config === void 0 ? void 0 : config.fastModel) !== null && _e !== void 0 ? _e : '',
+	        };
+	        // Start auto-compact check if enabled
+	        if (this.config.enableAutoCompact) {
+	            this.startAutoCompactCheck();
+	        }
 	    }
-	    // ===== State Properties =====
+	    // ===== Singleton Pattern =====
 	    /**
-	     * Whether the NPC is currently processing a request
+	     * Get the singleton instance of AIContextManager
+	     * Creates a new instance if one doesn't exist
 	     */
-	    get isTalking() {
-	        return this._isTalking;
+	    static getInstance(config) {
+	        if (!AIContextManager._instance) {
+	            AIContextManager._instance = new AIContextManager(config);
+	        }
+	        return AIContextManager._instance;
 	    }
-	    // ===== Character Design & Memory System =====
 	    /**
-	     * Set the character design for the NPC.
-	     * The system prompt is composed of CharacterDesign + all Memories.
+	     * Reset the singleton instance (useful for testing)
 	     */
-	    setCharacterDesign(design) {
-	        this.characterDesign = design;
+	    static resetInstance() {
+	        if (AIContextManager._instance) {
+	            AIContextManager._instance.destroy();
+	            AIContextManager._instance = null;
+	        }
 	    }
+	    // ===== Configuration =====
 	    /**
-	     * Get the current character design
+	     * Set the chat client factory for creating chat clients for summarization
+	     * Required for compaction to work
 	     */
-	    getCharacterDesign() {
-	        return this.characterDesign;
+	    setChatClientFactory(factory) {
+	        this.chatClientFactory = factory;
 	    }
 	    /**
-	     * @deprecated Use setCharacterDesign instead.
-	     * This method is kept for backwards compatibility.
+	     * Update configuration
 	     */
-	    setSystemPrompt(prompt) {
-	        this.logger.warn('setSystemPrompt is deprecated. Use setCharacterDesign instead.');
-	        this.setCharacterDesign(prompt);
+	    setConfig(config) {
+	        const wasAutoCompactEnabled = this.config.enableAutoCompact;
+	        this.config = Object.assign(Object.assign({}, this.config), config);
+	        // Handle auto-compact state change
+	        if (config.enableAutoCompact !== undefined) {
+	            if (config.enableAutoCompact && !wasAutoCompactEnabled) {
+	                this.startAutoCompactCheck();
+	            }
+	            else if (!config.enableAutoCompact && wasAutoCompactEnabled) {
+	                this.stopAutoCompactCheck();
+	            }
+	        }
 	    }
+	    // ===== Player Description =====
 	    /**
-	     * @deprecated Use getCharacterDesign instead.
-	     * This method is kept for backwards compatibility.
+	     * Set the player's description for AI context.
+	     * Used when generating reply predictions and for NPC context.
+	     * @param description Description of the player character
 	     */
-	    getSystemPrompt() {
-	        return this.buildSystemPrompt();
+	    setPlayerDescription(description) {
+	        this.playerDescription = description;
+	        this.emit('playerDescriptionChanged', description);
 	    }
 	    /**
-	     * Set or update a memory for the NPC.
-	     * Memories are appended to the character design to form the system prompt.
+	     * Get the current player description.
+	     * @returns The player description, or null if not set
+	     */
+	    getPlayerDescription() {
+	        return this.playerDescription;
+	    }
+	    /**
+	     * Clear the player description.
+	     */
+	    clearPlayerDescription() {
+	        this.playerDescription = null;
+	        this.emit('playerDescriptionChanged', null);
+	    }
+	    // ===== Player Prompt & Memory (for Reply Prediction) =====
+	    /**
+	     * Set the player's character prompt/persona.
+	     * This defines how the player character speaks and behaves.
+	     * Used when generating reply predictions to match the player's tone.
+	     * @param prompt The player character's persona/prompt
+	     */
+	    setPlayerPrompt(prompt) {
+	        this.playerPrompt = prompt;
+	    }
+	    /**
+	     * Get the current player prompt.
+	     * @returns The player prompt, or null if not set
+	     */
+	    getPlayerPrompt() {
+	        return this.playerPrompt;
+	    }
+	    /**
+	     * Set or update a memory for the player character.
+	     * Memories are appended to the player prompt to form the full player context.
 	     * Set memoryContent to null or empty to remove the memory.
 	     * @param memoryName The name/key of the memory
 	     * @param memoryContent The content of the memory. Null or empty to remove.
 	     */
-	    setMemory(memoryName, memoryContent) {
+	    setPlayerMemory(memoryName, memoryContent) {
 	        if (!memoryName) {
 	            this.logger.warn('Memory name cannot be empty');
 	            return;
 	        }
 	        if (!memoryContent) {
 	            // Remove memory if content is null or empty
-	            if (this.memories.has(memoryName)) {
-	                this.memories.delete(memoryName);
-	                this.emit('memory_removed', memoryName);
-	            }
+	            this.playerMemories.delete(memoryName);
 	        }
 	        else {
 	            // Add or update memory
-	            this.memories.set(memoryName, memoryContent);
-	            this.emit('memory_set', memoryName, memoryContent);
+	            this.playerMemories.set(memoryName, memoryContent);
 	        }
 	    }
 	    /**
-	     * Get a specific memory by name.
+	     * Get a specific player memory by name.
 	     * @param memoryName The name of the memory to retrieve
 	     * @returns The memory content, or undefined if not found
 	     */
-	    getMemory(memoryName) {
-	        return this.memories.get(memoryName);
+	    getPlayerMemory(memoryName) {
+	        return this.playerMemories.get(memoryName);
 	    }
 	    /**
-	     * Get all memory names currently stored.
+	     * Get all player memory names currently stored.
 	     * @returns Array of memory names
 	     */
-	    getMemoryNames() {
-	        return Array.from(this.memories.keys());
+	    getPlayerMemoryNames() {
+	        return Array.from(this.playerMemories.keys());
 	    }
 	    /**
-	     * Clear all memories (but keep character design).
+	     * Clear all player memories (but keep player prompt).
 	     */
-	    clearMemories() {
-	        this.memories.clear();
-	        this.emit('memories_cleared');
+	    clearPlayerMemories() {
+	        this.playerMemories.clear();
 	    }
 	    /**
-	     * Build the complete system prompt from CharacterDesign + Memories.
+	     * Build the complete player context from PlayerPrompt + PlayerMemories.
+	     * Used by NPCClient for generating reply predictions.
+	     * @returns The combined player context string, or null if no context is set
 	     */
-	    buildSystemPrompt() {
+	    buildPlayerContext() {
 	        const parts = [];
-	        if (this.characterDesign) {
-	            parts.push(this.characterDesign);
+	        if (this.playerPrompt) {
+	            parts.push(this.playerPrompt);
 	        }
-	        if (this.memories.size > 0) {
-	            const memoryStrings = Array.from(this.memories.entries())
+	        if (this.playerMemories.size > 0) {
+	            const memoryStrings = Array.from(this.playerMemories.entries())
 	                .map(([name, content]) => `[${name}]: ${content}`);
-	            parts.push('Memories:\n' + memoryStrings.join('\n'));
+	            parts.push('Player Memories:\n' + memoryStrings.join('\n'));
+	        }
+	        if (parts.length === 0) {
+	            return null;
 	        }
 	        return parts.join('\n\n');
 	    }
-	    // ===== Reply Prediction =====
+	    // ===== NPC Tracking =====
 	    /**
-	     * Enable or disable automatic reply prediction
+	     * Register an NPC for context management.
+	     * @param npc The NPC client to register
 	     */
-	    setGenerateReplyPrediction(enabled) {
-	        this.generateReplyPrediction = enabled;
+	    registerNpc(npc) {
+	        if (!npc)
+	            return;
+	        if (!this.npcStates.has(npc)) {
+	            this.npcStates.set(npc, {
+	                lastConversationTime: new Date(),
+	                isCompacted: false,
+	                compactionCount: 0,
+	            });
+	        }
 	    }
 	    /**
-	     * Set the number of predictions to generate
+	     * Unregister an NPC (call when NPC is destroyed/removed).
+	     * @param npc The NPC client to unregister
 	     */
-	    setPredictionCount(count) {
-	        this.predictionCount = Math.max(2, Math.min(6, count));
+	    unregisterNpc(npc) {
+	        if (!npc)
+	            return;
+	        this.npcStates.delete(npc);
 	    }
 	    /**
-	     * Manually generate reply predictions based on current conversation.
-	     * Uses the fast model for quick generation.
-	     * @param count Number of predictions to generate (default: uses predictionCount property)
-	     * @returns Array of predicted player replies, or empty array on failure
+	     * Record that a conversation occurred with an NPC.
+	     * Called after each Talk() exchange.
+	     * @param npc The NPC client that had a conversation
 	     */
-	    async generateReplyPredictions(count) {
-	        var _a;
-	        const predictionNum = count !== null && count !== void 0 ? count : this.predictionCount;
-	        if (this.history.length < 2) {
-	            this.logger.info('Not enough conversation history to generate predictions');
-	            return [];
-	        }
-	        try {
-	            // Get last NPC message
-	            const lastNpcMessage = (_a = [...this.history]
-	                .reverse()
-	                .find(m => m.role === 'assistant')) === null || _a === void 0 ? void 0 : _a.content;
-	            if (!lastNpcMessage) {
-	                this.logger.info('No NPC message found to generate predictions from');
-	                return [];
-	            }
-	            // Build recent history (last 6 non-system messages)
-	            const recentHistory = this.history
-	                .filter(m => m.role !== 'system')
-	                .slice(-6)
-	                .map(m => `${m.role}: ${m.content}`);
-	            // Build prompt for prediction generation
-	            const prompt = `Based on the conversation history below, generate exactly ${predictionNum} natural and contextually appropriate responses that the player might say next.
-
-Context:
-- This is a conversation between a player and an NPC in a game
-- The NPC just said: "${lastNpcMessage}"
-
-Conversation history:
-${recentHistory.join('\n')}
-
-Requirements:
-1. Each response should be 1-2 sentences maximum
-2. Responses should be diverse in tone and intent
-3. Include a mix of questions, statements, and action-oriented responses
-4. Responses should feel natural for a player character
-
-Output ONLY a JSON array of ${predictionNum} strings, nothing else:
-["response1", "response2", "response3", "response4"]`;
-	            const result = await this.chatClient.textGeneration({
-	                messages: [{ role: 'user', content: prompt }],
-	                temperature: 0.8,
-	                model: this.fastModel,
-	            });
-	            if (!result.content) {
-	                this.logger.warn('Failed to generate predictions: empty response');
-	                return [];
-	            }
-	            // Parse JSON response
-	            const predictions = this.parsePredictionsFromJson(result.content, predictionNum);
-	            if (predictions.length > 0) {
-	                this.emit('replyPredictions', predictions);
-	            }
-	            return predictions;
-	        }
-	        catch (error) {
-	            this.logger.error('Error generating predictions:', error);
-	            return [];
+	    recordConversation(npc) {
+	        if (!npc)
+	            return;
+	        if (!this.npcStates.has(npc)) {
+	            this.registerNpc(npc);
 	        }
+	        const state = this.npcStates.get(npc);
+	        state.lastConversationTime = new Date();
+	        state.isCompacted = false; // Reset compaction flag on new conversation
 	    }
 	    /**
-	     * Parse predictions from JSON array response
+	     * Get all registered NPCs
 	     */
-	    parsePredictionsFromJson(response, expectedCount) {
-	        try {
-	            // Try to find JSON array in response
-	            const startIndex = response.indexOf('[');
-	            const endIndex = response.lastIndexOf(']');
-	            if (startIndex === -1 || endIndex === -1 || endIndex <= startIndex) {
-	                this.logger.warn('Could not find JSON array in prediction response');
-	                return this.extractPredictionsFromText(response, expectedCount);
-	            }
-	            const jsonArray = response.substring(startIndex, endIndex + 1);
-	            const parsed = JSON.parse(jsonArray);
-	            if (Array.isArray(parsed)) {
-	                return parsed
-	                    .filter(item => typeof item === 'string' && item.trim())
-	                    .slice(0, expectedCount);
-	            }
-	            return [];
-	        }
-	        catch (error) {
-	            this.logger.warn('Failed to parse predictions JSON:', error);
-	            return this.extractPredictionsFromText(response, expectedCount);
-	        }
+	    getRegisteredNpcs() {
+	        return Array.from(this.npcStates.keys());
 	    }
 	    /**
-	     * Fallback: Extract predictions from text when JSON parsing fails
+	     * Get the conversation state for an NPC
 	     */
-	    extractPredictionsFromText(response, expectedCount) {
-	        const predictions = [];
-	        const lines = response.split(/[\n\r]+/).filter(line => line.trim());
-	        for (const line of lines) {
-	            let cleaned = line.trim();
-	            // Skip empty lines and JSON brackets
-	            if (!cleaned || cleaned === '[' || cleaned === ']')
-	                continue;
-	            // Remove common prefixes like "1.", "- ", etc.
-	            if (/^\d+\./.test(cleaned)) {
-	                cleaned = cleaned.replace(/^\d+\.\s*/, '');
-	            }
-	            else if (cleaned.startsWith('- ')) {
-	                cleaned = cleaned.substring(2);
-	            }
-	            // Remove surrounding quotes
-	            if (cleaned.startsWith('"') && cleaned.endsWith('"')) {
-	                cleaned = cleaned.slice(1, -1);
-	            }
-	            // Remove trailing comma
-	            if (cleaned.endsWith(',')) {
-	                cleaned = cleaned.slice(0, -1).trim();
-	            }
-	            if (cleaned && predictions.length < expectedCount) {
-	                predictions.push(cleaned);
-	            }
-	        }
-	        return predictions;
+	    getNpcState(npc) {
+	        return this.npcStates.get(npc);
 	    }
+	    // ===== Auto Compaction =====
 	    /**
-	     * Internal method to trigger prediction generation after NPC response
+	     * Check if an NPC is eligible for compaction.
+	     * @param npc The NPC to check
+	     * @returns True if eligible for compaction
 	     */
-	    async triggerReplyPrediction() {
-	        if (!this.generateReplyPrediction)
-	            return;
-	        // Fire and forget - don't block the main response
-	        this.generateReplyPredictions().catch(err => {
-	            this.logger.error('Background prediction generation failed:', err);
-	        });
+	    isEligibleForCompaction(npc) {
+	        if (!npc)
+	            return false;
+	        const state = this.npcStates.get(npc);
+	        if (!state)
+	            return false;
+	        // Check if already compacted since last conversation
+	        if (state.isCompacted)
+	            return false;
+	        // Check message count
+	        const history = npc.getHistory();
+	        const nonSystemMessages = history.filter(m => m.role !== 'system').length;
+	        if (nonSystemMessages < this.config.autoCompactMinMessages)
+	            return false;
+	        // Check time since last conversation
+	        const timeSinceLastConversation = (Date.now() - state.lastConversationTime.getTime()) / 1000;
+	        if (timeSinceLastConversation < this.config.autoCompactTimeoutSeconds)
+	            return false;
+	        return true;
 	    }
-	    // ===== Main API - Talk Methods =====
 	    /**
-	     * Talk to the NPC (non-streaming)
+	     * Manually trigger conversation compaction for a specific NPC.
+	     * Summarizes the conversation history and stores it as a memory.
+	     * @param npc The NPC to compact
+	     * @returns True if compaction succeeded
 	     */
-	    async talk(message) {
-	        this._isTalking = true;
-	        try {
-	            // Add user message to history
-	            const userMessage = { role: 'user', content: message };
-	            this.history.push(userMessage);
-	            // Build messages array with system prompt
-	            const messages = [
-	                { role: 'system', content: this.buildSystemPrompt() },
-	                ...this.history,
-	            ];
-	            // Generate response
-	            const result = await this.chatClient.textGeneration({
-	                messages,
-	                temperature: this.temperature,
-	            });
-	            // Add assistant response to history
-	            const assistantMessage = { role: 'assistant', content: result.content };
-	            this.history.push(assistantMessage);
-	            // Trim history if needed
-	            this.trimHistory();
-	            this.emit('response', result.content);
-	            // Trigger reply prediction generation (fire and forget)
-	            this.triggerReplyPrediction();
-	            return result.content;
-	        }
-	        finally {
-	            this._isTalking = false;
+	    async compactConversation(npc) {
+	        if (!npc) {
+	            this.logger.warn('Cannot compact: NPC is null');
+	            return false;
 	        }
-	    }
-	    /**
-	     * Talk to the NPC with streaming
-	     */
-	    async talkStream(message, onChunk, onComplete) {
-	        this._isTalking = true;
-	        try {
-	            // Add user message to history
-	            const userMessage = { role: 'user', content: message };
-	            this.history.push(userMessage);
-	            // Build messages array with system prompt
-	            const messages = [
-	                { role: 'system', content: this.buildSystemPrompt() },
-	                ...this.history,
-	            ];
-	            // Generate response
-	            await this.chatClient.textGenerationStream({
-	                messages,
-	                temperature: this.temperature,
-	                onChunk,
-	                onComplete: (fullText) => {
-	                    this._isTalking = false;
-	                    // Add assistant response to history
-	                    const assistantMessage = { role: 'assistant', content: fullText };
-	                    this.history.push(assistantMessage);
-	                    // Trim history if needed
-	                    this.trimHistory();
-	                    this.emit('response', fullText);
-	                    // Trigger reply prediction generation (fire and forget)
-	                    this.triggerReplyPrediction();
-	                    if (onComplete) {
-	                        onComplete(fullText);
-	                    }
-	                },
-	            });
+	        if (!this.chatClientFactory) {
+	            this.logger.error('Cannot compact: No chat client factory set. Call setChatClientFactory() first.');
+	            return false;
 	        }
-	        catch (error) {
-	            this._isTalking = false;
-	            throw error;
+	        const history = npc.getHistory();
+	        const nonSystemMessages = history.filter(m => m.role !== 'system');
+	        if (nonSystemMessages.length < 2) {
+	            this.logger.info('Skipping compaction: not enough messages');
+	            return false;
 	        }
-	    }
-	    /**
-	     * Talk with structured output
-	     * @deprecated Use talkWithActions instead for NPC decision-making with actions
-	     */
-	    async talkStructured(message, schemaName) {
-	        this.logger.warn('talkStructured is deprecated. Use talkWithActions instead for NPC decision-making with actions.');
-	        // Add user message to history
-	        const userMessage = { role: 'user', content: message };
-	        this.history.push(userMessage);
-	        // Generate structured response
-	        const result = await this.chatClient.generateStructured({
-	            schemaName,
-	            prompt: message,
-	            messages: [{ role: 'system', content: this.buildSystemPrompt() }, ...this.history],
-	            temperature: this.temperature,
-	        });
-	        // Add a text representation to history
-	        const assistantMessage = {
-	            role: 'assistant',
-	            content: JSON.stringify(result),
-	        };
-	        this.history.push(assistantMessage);
-	        this.trimHistory();
-	        return result;
-	    }
-	    /**
-	     * Talk to the NPC with available actions (non-streaming)
-	     * @param message The message to send
-	     * @param actions List of actions the NPC can perform
-	     * @returns Response containing text and any action calls
-	     */
-	    async talkWithActions(message, actions) {
-	        this._isTalking = true;
 	        try {
-	            // Add user message to history
-	            const userMessage = { role: 'user', content: message };
-	            this.history.push(userMessage);
-	            // Convert NpcActions to ChatTools
-	            const tools = actions
-	                .filter(a => a && a.enabled !== false)
-	                .map(a => npcActionToTool(a));
-	            // Build messages array with system prompt
-	            const messages = [
-	                { role: 'system', content: this.buildSystemPrompt() },
-	                ...this.history,
-	            ];
-	            // Generate response with tools
-	            const result = await this.chatClient.textGenerationWithTools({
-	                messages,
-	                temperature: this.temperature,
-	                tools,
-	                tool_choice: 'auto',
+	            this.logger.info(`Starting compaction (${nonSystemMessages.length} messages)`);
+	            // Build conversation text for summarization
+	            const conversationText = nonSystemMessages
+	                .map(m => `${m.role}: ${m.content}`)
+	                .join('\n');
+	            // Create summarization prompt
+	            const summaryPrompt = `Summarize the following conversation concisely. Focus on:
+1. Key topics discussed
+2. Important information exchanged
+3. Any decisions or commitments made
+4. The emotional tone
+
+Keep the summary under 200 words. Write in third person.
+
+Conversation:
+${conversationText}`;
+	            // Use chat client for summarization
+	            const chatClient = this.chatClientFactory();
+	            const result = await chatClient.textGeneration({
+	                messages: [{ role: 'user', content: summaryPrompt }],
+	                temperature: 0.5,
+	                model: this.config.fastModel || undefined,
 	            });
-	            // Build response
-	            const response = {
-	                text: result.content || '',
-	                actionCalls: [],
-	                hasActions: false,
-	            };
-	            // Extract tool calls if any
-	            if (result.tool_calls) {
-	                response.actionCalls = result.tool_calls.map(tc => ({
-	                    id: tc.id,
-	                    actionName: tc.function.name,
-	                    arguments: this.parseToolArguments(tc.function.arguments),
-	                }));
-	                response.hasActions = response.actionCalls.length > 0;
-	            }
-	            // Add assistant response to history
-	            const assistantMessage = {
-	                role: 'assistant',
-	                content: response.text,
-	                tool_calls: result.tool_calls,
-	            };
-	            this.history.push(assistantMessage);
-	            this.trimHistory();
-	            this.emit('response', response.text);
-	            if (response.hasActions) {
-	                this.emit('actions', response.actionCalls);
+	            if (!result.content) {
+	                const error = 'Empty response from summarization';
+	                this.logger.error(`Compaction failed: ${error}`);
+	                this.emit('compactionFailed', npc, error);
+	                return false;
 	            }
-	            // Trigger reply prediction generation (fire and forget)
-	            this.triggerReplyPrediction();
-	            return response;
-	        }
-	        finally {
-	            this._isTalking = false;
-	        }
-	    }
-	    /**
-	     * Talk to the NPC with actions (streaming)
-	     * Text streams first, action calls are returned in onComplete
-	     */
-	    async talkWithActionsStream(message, actions, onChunk, onComplete) {
-	        this._isTalking = true;
-	        try {
-	            // Add user message to history
-	            const userMessage = { role: 'user', content: message };
-	            this.history.push(userMessage);
-	            // Convert NpcActions to ChatTools
-	            const tools = actions
-	                .filter(a => a && a.enabled !== false)
-	                .map(a => npcActionToTool(a));
-	            // Build messages array with system prompt
-	            const messages = [
-	                { role: 'system', content: this.buildSystemPrompt() },
-	                ...this.history,
-	            ];
-	            // Generate response with tools (streaming)
-	            await this.chatClient.textGenerationWithToolsStream({
-	                messages,
-	                temperature: this.temperature,
-	                tools,
-	                tool_choice: 'auto',
-	                onChunk,
-	                onComplete: (result) => {
-	                    this._isTalking = false;
-	                    // Build response
-	                    const response = {
-	                        text: result.content || '',
-	                        actionCalls: [],
-	                        hasActions: false,
-	                    };
-	                    // Extract tool calls if any
-	                    if (result.tool_calls) {
-	                        response.actionCalls = result.tool_calls.map(tc => ({
-	                            id: tc.id,
-	                            actionName: tc.function.name,
-	                            arguments: this.parseToolArguments(tc.function.arguments),
-	                        }));
-	                        response.hasActions = response.actionCalls.length > 0;
-	                    }
-	                    // Add assistant response to history
-	                    const assistantMessage = {
-	                        role: 'assistant',
-	                        content: response.text,
-	                        tool_calls: result.tool_calls,
-	                    };
-	                    this.history.push(assistantMessage);
-	                    this.trimHistory();
-	                    this.emit('response', response.text);
-	                    if (response.hasActions) {
-	                        this.emit('actions', response.actionCalls);
-	                    }
-	                    // Trigger reply prediction generation (fire and forget)
-	                    this.triggerReplyPrediction();
-	                    if (onComplete) {
-	                        onComplete(response);
-	                    }
-	                },
-	            });
+	            // Clear history and add summary as memory
+	            npc.clearHistory();
+	            npc.setMemory('PreviousConversationSummary', result.content);
+	            // Update state
+	            const state = this.npcStates.get(npc);
+	            if (state) {
+	                state.isCompacted = true;
+	                state.compactionCount++;
+	            }
+	            this.logger.info(`Compaction completed. Summary: ${result.content.substring(0, 100)}...`);
+	            this.emit('npcCompacted', npc);
+	            return true;
 	        }
 	        catch (error) {
-	            this._isTalking = false;
-	            throw error;
+	            const errorMessage = error instanceof Error ? error.message : String(error);
+	            this.logger.error(`Compaction error: ${errorMessage}`);
+	            this.emit('compactionFailed', npc, errorMessage);
+	            return false;
 	        }
 	    }
-	    // ===== Action Results Reporting =====
 	    /**
-	     * Report action results back to the conversation
-	     * Call this after executing actions to let the NPC know the results
+	     * Compact all registered NPCs that meet the eligibility criteria.
+	     * @returns Number of NPCs successfully compacted
 	     */
-	    reportActionResults(results) {
-	        for (const [callId, result] of Object.entries(results)) {
-	            this.history.push({
-	                role: 'tool',
-	                tool_call_id: callId,
-	                content: result,
-	            });
+	    async compactAllEligible() {
+	        const eligibleNpcs = Array.from(this.npcStates.keys()).filter(npc => this.isEligibleForCompaction(npc));
+	        if (eligibleNpcs.length === 0) {
+	            return 0;
+	        }
+	        this.logger.info(`Compacting ${eligibleNpcs.length} eligible NPCs`);
+	        let successCount = 0;
+	        for (const npc of eligibleNpcs) {
+	            const success = await this.compactConversation(npc);
+	            if (success)
+	                successCount++;
 	        }
+	        return successCount;
 	    }
+	    // ===== Auto Compact Timer =====
 	    /**
-	     * Report a single action result
+	     * Start the auto-compact check timer
 	     */
-	    reportActionResult(callId, result) {
-	        this.history.push({
-	            role: 'tool',
-	            tool_call_id: callId,
-	            content: result,
-	        });
+	    startAutoCompactCheck() {
+	        if (this.autoCompactTimer) {
+	            this.stopAutoCompactCheck();
+	        }
+	        this.autoCompactTimer = setInterval(() => {
+	            this.runAutoCompactCheck();
+	        }, this.config.autoCompactCheckInterval);
 	    }
 	    /**
-	     * Parse tool arguments from JSON string
+	     * Stop the auto-compact check timer
 	     */
-	    parseToolArguments(args) {
-	        try {
-	            return JSON.parse(args);
+	    stopAutoCompactCheck() {
+	        if (this.autoCompactTimer) {
+	            clearInterval(this.autoCompactTimer);
+	            this.autoCompactTimer = null;
 	        }
-	        catch (_a) {
-	            return {};
+	    }
+	    /**
+	     * Run a single auto-compact check
+	     */
+	    async runAutoCompactCheck() {
+	        if (!this.config.enableAutoCompact)
+	            return;
+	        const eligibleNpcs = Array.from(this.npcStates.keys()).filter(npc => this.isEligibleForCompaction(npc));
+	        for (const npc of eligibleNpcs) {
+	            // Fire and forget - don't block
+	            this.compactConversation(npc).catch(err => {
+	                this.logger.error('Auto-compact error:', err);
+	            });
 	        }
 	    }
-	    // ===== Conversation History Management =====
+	    // ===== Lifecycle =====
 	    /**
-	     * Get conversation history
+	     * Enable auto-compaction
 	     */
-	    getHistory() {
-	        return [...this.history];
+	    enableAutoCompact() {
+	        this.config.enableAutoCompact = true;
+	        this.startAutoCompactCheck();
 	    }
 	    /**
-	     * Get the number of messages in history
+	     * Disable auto-compaction
 	     */
-	    getHistoryLength() {
-	        return this.history.length;
+	    disableAutoCompact() {
+	        this.config.enableAutoCompact = false;
+	        this.stopAutoCompactCheck();
 	    }
 	    /**
-	     * Clear conversation history.
-	     * The character design and memories will be preserved.
+	     * Clean up resources
 	     */
-	    clearHistory() {
+	    destroy() {
+	        this.stopAutoCompactCheck();
+	        this.npcStates.clear();
+	        this.playerDescription = null;
+	        this.playerPrompt = null;
+	        this.playerMemories.clear();
+	        this.removeAllListeners();
+	    }
+	}
+	AIContextManager._instance = null;
+	/**
+	 * Default AIContextManager instance
+	 * Can be used as a global context manager
+	 */
+	const defaultContextManager = AIContextManager.getInstance();
+
+	/**
+	 * NPC Client for simplified conversation management
+	 * Automatically handles conversation history
+	 *
+	 * Key Features:
+	 * - Call talk() for all interactions - actions are handled automatically
+	 * - Memory system for persistent NPC context
+	 * - Reply prediction for suggesting player responses
+	 * - Automatic conversation history management
+	 */
+	class NPCClient extends EventEmitter {
+	    constructor(chatClient, config) {
+	        var _a, _b, _c;
+	        super();
+	        this._isTalking = false;
+	        this.logger = Logger.getLogger('NPCClient');
+	        this.chatClient = chatClient;
+	        // Support both characterDesign and legacy systemPrompt
+	        this.characterDesign = (config === null || config === void 0 ? void 0 : config.characterDesign) || (config === null || config === void 0 ? void 0 : config.systemPrompt) || 'You are a helpful assistant.';
+	        this.temperature = (_a = config === null || config === void 0 ? void 0 : config.temperature) !== null && _a !== void 0 ? _a : 0.7;
+	        this.maxHistoryLength = (config === null || config === void 0 ? void 0 : config.maxHistoryLength) || 50;
+	        this.generateReplyPrediction = (_b = config === null || config === void 0 ? void 0 : config.generateReplyPrediction) !== null && _b !== void 0 ? _b : false;
+	        this.predictionCount = Math.max(2, Math.min(6, (_c = config === null || config === void 0 ? void 0 : config.predictionCount) !== null && _c !== void 0 ? _c : 4));
+	        this.fastModel = config === null || config === void 0 ? void 0 : config.fastModel;
 	        this.history = [];
-	        this.emit('history_cleared');
+	        this.memories = new Map();
 	    }
+	    // ===== State Properties =====
 	    /**
-	     * Revert the last exchange (user message and assistant response) from history.
-	     * @returns true if reverted, false if not enough history
+	     * Whether the NPC is currently processing a request
 	     */
-	    revertHistory() {
-	        let lastAssistantIndex = -1;
-	        let lastUserIndex = -1;
-	        for (let i = this.history.length - 1; i >= 0; i--) {
-	            if (this.history[i].role === 'assistant' && lastAssistantIndex === -1) {
-	                lastAssistantIndex = i;
-	            }
-	            else if (this.history[i].role === 'user' && lastAssistantIndex !== -1 && lastUserIndex === -1) {
-	                lastUserIndex = i;
-	                break;
+	    get isTalking() {
+	        return this._isTalking;
+	    }
+	    // ===== Character Design & Memory System =====
+	    /**
+	     * Set the character design for the NPC.
+	     * The system prompt is composed of CharacterDesign + all Memories.
+	     */
+	    setCharacterDesign(design) {
+	        this.characterDesign = design;
+	    }
+	    /**
+	     * Get the current character design
+	     */
+	    getCharacterDesign() {
+	        return this.characterDesign;
+	    }
+	    /**
+	     * @deprecated Use setCharacterDesign instead.
+	     * This method is kept for backwards compatibility.
+	     */
+	    setSystemPrompt(prompt) {
+	        this.logger.warn('setSystemPrompt is deprecated. Use setCharacterDesign instead.');
+	        this.setCharacterDesign(prompt);
+	    }
+	    /**
+	     * @deprecated Use getCharacterDesign instead.
+	     * This method is kept for backwards compatibility.
+	     */
+	    getSystemPrompt() {
+	        return this.buildSystemPrompt();
+	    }
+	    /**
+	     * Set or update a memory for the NPC.
+	     * Memories are appended to the character design to form the system prompt.
+	     * Set memoryContent to null or empty to remove the memory.
+	     * @param memoryName The name/key of the memory
+	     * @param memoryContent The content of the memory. Null or empty to remove.
+	     */
+	    setMemory(memoryName, memoryContent) {
+	        if (!memoryName) {
+	            this.logger.warn('Memory name cannot be empty');
+	            return;
+	        }
+	        if (!memoryContent) {
+	            // Remove memory if content is null or empty
+	            if (this.memories.has(memoryName)) {
+	                this.memories.delete(memoryName);
+	                this.emit('memory_removed', memoryName);
 	            }
 	        }
-	        if (lastAssistantIndex !== -1 && lastUserIndex !== -1) {
-	            // Remove in reverse order to maintain indices
-	            this.history.splice(lastAssistantIndex, 1);
-	            this.history.splice(lastUserIndex, 1);
-	            this.emit('history_reverted');
-	            return true;
+	        else {
+	            // Add or update memory
+	            this.memories.set(memoryName, memoryContent);
+	            this.emit('memory_set', memoryName, memoryContent);
 	        }
-	        return false;
 	    }
 	    /**
-	     * Revert (remove) the last N chat messages from history
-	     * @param count Number of messages to remove
-	     * @returns Number of messages actually removed
+	     * Get a specific memory by name.
+	     * @param memoryName The name of the memory to retrieve
+	     * @returns The memory content, or undefined if not found
 	     */
-	    revertChatMessages(count) {
-	        if (count <= 0)
-	            return 0;
-	        const messagesToRemove = Math.min(count, this.history.length);
-	        const originalCount = this.history.length;
-	        this.history = this.history.slice(0, -messagesToRemove);
-	        const actuallyRemoved = originalCount - this.history.length;
-	        if (actuallyRemoved > 0) {
-	            this.emit('history_reverted', actuallyRemoved);
+	    getMemory(memoryName) {
+	        return this.memories.get(memoryName);
+	    }
+	    /**
+	     * Get all memory names currently stored.
+	     * @returns Array of memory names
+	     */
+	    getMemoryNames() {
+	        return Array.from(this.memories.keys());
+	    }
+	    /**
+	     * Clear all memories (but keep character design).
+	     */
+	    clearMemories() {
+	        this.memories.clear();
+	        this.emit('memories_cleared');
+	    }
+	    /**
+	     * Build the complete system prompt from CharacterDesign + Memories.
+	     */
+	    buildSystemPrompt() {
+	        const parts = [];
+	        if (this.characterDesign) {
+	            parts.push(this.characterDesign);
 	        }
-	        return actuallyRemoved;
+	        if (this.memories.size > 0) {
+	            const memoryStrings = Array.from(this.memories.entries())
+	                .map(([name, content]) => `[${name}]: ${content}`);
+	            parts.push('Memories:\n' + memoryStrings.join('\n'));
+	        }
+	        return parts.join('\n\n');
+	    }
+	    // ===== Reply Prediction =====
+	    /**
+	     * Enable or disable automatic reply prediction
+	     */
+	    setGenerateReplyPrediction(enabled) {
+	        this.generateReplyPrediction = enabled;
 	    }
 	    /**
-	     * Revert to a specific point in history
-	     * @deprecated Use revertHistory() or revertChatMessages() instead
+	     * Set the number of predictions to generate
 	     */
-	    revertToMessage(index) {
-	        if (index >= 0 && index < this.history.length) {
-	            this.history = this.history.slice(0, index + 1);
-	            this.emit('history_reverted', index);
-	        }
+	    setPredictionCount(count) {
+	        this.predictionCount = Math.max(2, Math.min(6, count));
 	    }
 	    /**
-	     * Append a message to history manually
+	     * Manually generate reply predictions based on current conversation.
+	     * Uses the fast model for quick generation.
+	     * @param tempPrompt Optional temporary prompt to influence the prediction style/tone
+	     * @param count Number of predictions to generate (default: uses predictionCount property)
+	     * @returns Array of predicted player replies, or empty array on failure
 	     */
-	    appendMessage(message) {
-	        this.history.push(message);
-	        this.trimHistory();
+	    async generateReplyPredictions(tempPrompt, count) {
+	        var _a;
+	        const predictionNum = count !== null && count !== void 0 ? count : this.predictionCount;
+	        if (this.history.length < 2) {
+	            this.logger.info('Not enough conversation history to generate predictions');
+	            return [];
+	        }
+	        try {
+	            // Get last NPC message
+	            const lastNpcMessage = (_a = [...this.history]
+	                .reverse()
+	                .find(m => m.role === 'assistant')) === null || _a === void 0 ? void 0 : _a.content;
+	            if (!lastNpcMessage) {
+	                this.logger.info('No NPC message found to generate predictions from');
+	                return [];
+	            }
+	            // Build recent history (last 6 non-system messages)
+	            const recentHistory = this.history
+	                .filter(m => m.role !== 'system')
+	                .slice(-6)
+	                .map(m => `${m.role}: ${m.content}`);
+	            // Get player context from AIContextManager
+	            const contextManager = AIContextManager.getInstance();
+	            const playerContext = contextManager.buildPlayerContext();
+	            // Build player character section
+	            let playerCharacterSection = '';
+	            if (playerContext || tempPrompt) {
+	                playerCharacterSection = '\nPlayer Character:\n';
+	                if (playerContext) {
+	                    playerCharacterSection += playerContext + '\n';
+	                }
+	                if (tempPrompt) {
+	                    playerCharacterSection += `Additional guidance: ${tempPrompt}\n`;
+	                }
+	            }
+	            // Build prompt for prediction generation
+	            const prompt = `Based on the conversation history below, generate exactly ${predictionNum} natural and contextually appropriate responses that the player might say next.
+
+Context:
+- This is a conversation between a player and an NPC in a game
+- The NPC just said: "${lastNpcMessage}"
+${playerCharacterSection}
+Conversation history:
+${recentHistory.join('\n')}
+
+Requirements:
+1. Each response should be 1-2 sentences maximum
+2. Responses should be diverse in tone and intent
+3. Include a mix of questions, statements, and action-oriented responses
+4. Responses should feel natural for the player character${playerContext || tempPrompt ? ' and match their personality/tone' : ''}
+
+Output ONLY a JSON array of ${predictionNum} strings, nothing else:
+["response1", "response2", "response3", "response4"]`;
+	            const result = await this.chatClient.textGeneration({
+	                messages: [{ role: 'user', content: prompt }],
+	                temperature: 0.8,
+	                model: this.fastModel,
+	            });
+	            if (!result.content) {
+	                this.logger.warn('Failed to generate predictions: empty response');
+	                return [];
+	            }
+	            // Parse JSON response
+	            const predictions = this.parsePredictionsFromJson(result.content, predictionNum);
+	            if (predictions.length > 0) {
+	                this.emit('replyPredictions', predictions);
+	            }
+	            return predictions;
+	        }
+	        catch (error) {
+	            this.logger.error('Error generating predictions:', error);
+	            return [];
+	        }
 	    }
 	    /**
-	     * Alias for appendMessage (Unity SDK compatibility)
+	     * Parse predictions from JSON array response
 	     */
-	    appendChatMessage(role, content) {
-	        if (!role || !content) {
-	            this.logger.warn('Role and content cannot be empty');
-	            return;
+	    parsePredictionsFromJson(response, expectedCount) {
+	        try {
+	            // Try to find JSON array in response
+	            const startIndex = response.indexOf('[');
+	            const endIndex = response.lastIndexOf(']');
+	            if (startIndex === -1 || endIndex === -1 || endIndex <= startIndex) {
+	                this.logger.warn('Could not find JSON array in prediction response');
+	                return this.extractPredictionsFromText(response, expectedCount);
+	            }
+	            const jsonArray = response.substring(startIndex, endIndex + 1);
+	            const parsed = JSON.parse(jsonArray);
+	            if (Array.isArray(parsed)) {
+	                return parsed
+	                    .filter(item => typeof item === 'string' && item.trim())
+	                    .slice(0, expectedCount);
+	            }
+	            return [];
+	        }
+	        catch (error) {
+	            this.logger.warn('Failed to parse predictions JSON:', error);
+	            return this.extractPredictionsFromText(response, expectedCount);
 	        }
-	        this.appendMessage({ role: role, content });
 	    }
 	    /**
-	     * Trim history to max length
+	     * Fallback: Extract predictions from text when JSON parsing fails
 	     */
-	    trimHistory() {
-	        if (this.history.length > this.maxHistoryLength) {
-	            // Keep the most recent messages
-	            this.history = this.history.slice(-this.maxHistoryLength);
+	    extractPredictionsFromText(response, expectedCount) {
+	        const predictions = [];
+	        const lines = response.split(/[\n\r]+/).filter(line => line.trim());
+	        for (const line of lines) {
+	            let cleaned = line.trim();
+	            // Skip empty lines and JSON brackets
+	            if (!cleaned || cleaned === '[' || cleaned === ']')
+	                continue;
+	            // Remove common prefixes like "1.", "- ", etc.
+	            if (/^\d+\./.test(cleaned)) {
+	                cleaned = cleaned.replace(/^\d+\.\s*/, '');
+	            }
+	            else if (cleaned.startsWith('- ')) {
+	                cleaned = cleaned.substring(2);
+	            }
+	            // Remove surrounding quotes
+	            if (cleaned.startsWith('"') && cleaned.endsWith('"')) {
+	                cleaned = cleaned.slice(1, -1);
+	            }
+	            // Remove trailing comma
+	            if (cleaned.endsWith(',')) {
+	                cleaned = cleaned.slice(0, -1).trim();
+	            }
+	            if (cleaned && predictions.length < expectedCount) {
+	                predictions.push(cleaned);
+	            }
 	        }
+	        return predictions;
 	    }
-	    // ===== Save/Load =====
 	    /**
-	     * Save the current conversation history to a serializable format.
-	     * Includes characterDesign, memories, and history.
+	     * Internal method to trigger prediction generation after NPC response
 	     */
-	    saveHistory() {
-	        const saveData = {
-	            characterDesign: this.characterDesign,
-	            memories: Array.from(this.memories.entries()).map(([name, content]) => ({ name, content })),
-	            history: this.history,
-	        };
-	        return JSON.stringify(saveData);
+	    async triggerReplyPrediction() {
+	        if (!this.generateReplyPrediction)
+	            return;
+	        // Fire and forget - don't block the main response
+	        this.generateReplyPredictions().catch(err => {
+	            this.logger.error('Background prediction generation failed:', err);
+	        });
 	    }
+	    // ===== Main API - Talk Methods =====
 	    /**
-	     * Load conversation history from serialized data.
-	     * Restores characterDesign, memories, and history.
+	     * Talk to the NPC (non-streaming)
 	     */
-	    loadHistory(saveData) {
+	    async talk(message) {
+	        this._isTalking = true;
 	        try {
-	            const data = JSON.parse(saveData);
-	            // Load character design (with backwards compatibility for old systemPrompt field)
-	            this.characterDesign = data.characterDesign || data.systemPrompt || this.characterDesign;
-	            // Load memories
-	            this.memories.clear();
-	            if (data.memories && Array.isArray(data.memories)) {
-	                for (const memory of data.memories) {
-	                    if (memory.name && memory.content) {
-	                        this.memories.set(memory.name, memory.content);
-	                    }
-	                }
-	            }
-	            // Load history (skip system messages as they'll be rebuilt from characterDesign + memories)
-	            this.history = (data.history || []).filter(m => m.role !== 'system');
-	            this.emit('history_loaded');
-	            return true;
-	        }
-	        catch (error) {
-	            this.logger.error('Failed to load history:', error);
-	            return false;
+	            // Add user message to history
+	            const userMessage = { role: 'user', content: message };
+	            this.history.push(userMessage);
+	            // Build messages array with system prompt
+	            const messages = [
+	                { role: 'system', content: this.buildSystemPrompt() },
+	                ...this.history,
+	            ];
+	            // Generate response
+	            const result = await this.chatClient.textGeneration({
+	                messages,
+	                temperature: this.temperature,
+	            });
+	            // Add assistant response to history
+	            const assistantMessage = { role: 'assistant', content: result.content };
+	            this.history.push(assistantMessage);
+	            // Trim history if needed
+	            this.trimHistory();
+	            this.emit('response', result.content);
+	            // Trigger reply prediction generation (fire and forget)
+	            this.triggerReplyPrediction();
+	            return result.content;
 	        }
-	    }
-	}
-
-	/**
-	 * Global AI Context Manager for managing NPC conversations and player context.
-	 *
-	 * Features:
-	 * - Player description management
-	 * - NPC conversation tracking
-	 * - Automatic conversation compaction (AutoCompact)
-	 */
-	/**
-	 * Global AI Context Manager
-	 * Manages NPC conversations and player context across the application
-	 */
-	class AIContextManager extends EventEmitter {
-	    constructor(config) {
-	        var _a, _b, _c, _d, _e;
-	        super();
-	        this.playerDescription = null;
-	        this.npcStates = new Map();
-	        this.autoCompactTimer = null;
-	        this.chatClientFactory = null;
-	        this.logger = Logger.getLogger('AIContextManager');
-	        this.config = {
-	            enableAutoCompact: (_a = config === null || config === void 0 ? void 0 : config.enableAutoCompact) !== null && _a !== void 0 ? _a : false,
-	            autoCompactMinMessages: (_b = config === null || config === void 0 ? void 0 : config.autoCompactMinMessages) !== null && _b !== void 0 ? _b : 20,
-	            autoCompactTimeoutSeconds: (_c = config === null || config === void 0 ? void 0 : config.autoCompactTimeoutSeconds) !== null && _c !== void 0 ? _c : 300,
-	            autoCompactCheckInterval: (_d = config === null || config === void 0 ? void 0 : config.autoCompactCheckInterval) !== null && _d !== void 0 ? _d : 60000,
-	            fastModel: (_e = config === null || config === void 0 ? void 0 : config.fastModel) !== null && _e !== void 0 ? _e : '',
-	        };
-	        // Start auto-compact check if enabled
-	        if (this.config.enableAutoCompact) {
-	            this.startAutoCompactCheck();
+	        finally {
+	            this._isTalking = false;
 	        }
 	    }
-	    // ===== Singleton Pattern =====
 	    /**
-	     * Get the singleton instance of AIContextManager
-	     * Creates a new instance if one doesn't exist
+	     * Talk to the NPC with streaming
 	     */
-	    static getInstance(config) {
-	        if (!AIContextManager._instance) {
-	            AIContextManager._instance = new AIContextManager(config);
+	    async talkStream(message, onChunk, onComplete) {
+	        this._isTalking = true;
+	        try {
+	            // Add user message to history
+	            const userMessage = { role: 'user', content: message };
+	            this.history.push(userMessage);
+	            // Build messages array with system prompt
+	            const messages = [
+	                { role: 'system', content: this.buildSystemPrompt() },
+	                ...this.history,
+	            ];
+	            // Generate response
+	            await this.chatClient.textGenerationStream({
+	                messages,
+	                temperature: this.temperature,
+	                onChunk,
+	                onComplete: (fullText) => {
+	                    this._isTalking = false;
+	                    // Add assistant response to history
+	                    const assistantMessage = { role: 'assistant', content: fullText };
+	                    this.history.push(assistantMessage);
+	                    // Trim history if needed
+	                    this.trimHistory();
+	                    this.emit('response', fullText);
+	                    // Trigger reply prediction generation (fire and forget)
+	                    this.triggerReplyPrediction();
+	                    if (onComplete) {
+	                        onComplete(fullText);
+	                    }
+	                },
+	            });
 	        }
-	        return AIContextManager._instance;
-	    }
-	    /**
-	     * Reset the singleton instance (useful for testing)
-	     */
-	    static resetInstance() {
-	        if (AIContextManager._instance) {
-	            AIContextManager._instance.destroy();
-	            AIContextManager._instance = null;
+	        catch (error) {
+	            this._isTalking = false;
+	            throw error;
 	        }
 	    }
-	    // ===== Configuration =====
 	    /**
-	     * Set the chat client factory for creating chat clients for summarization
-	     * Required for compaction to work
+	     * Talk with structured output
+	     * @deprecated Use talkWithActions instead for NPC decision-making with actions
 	     */
-	    setChatClientFactory(factory) {
-	        this.chatClientFactory = factory;
+	    async talkStructured(message, schemaName) {
+	        this.logger.warn('talkStructured is deprecated. Use talkWithActions instead for NPC decision-making with actions.');
+	        // Add user message to history
+	        const userMessage = { role: 'user', content: message };
+	        this.history.push(userMessage);
+	        // Generate structured response
+	        const result = await this.chatClient.generateStructured({
+	            schemaName,
+	            prompt: message,
+	            messages: [{ role: 'system', content: this.buildSystemPrompt() }, ...this.history],
+	            temperature: this.temperature,
+	        });
+	        // Add a text representation to history
+	        const assistantMessage = {
+	            role: 'assistant',
+	            content: JSON.stringify(result),
+	        };
+	        this.history.push(assistantMessage);
+	        this.trimHistory();
+	        return result;
 	    }
 	    /**
-	     * Update configuration
+	     * Talk to the NPC with available actions (non-streaming)
+	     * @param message The message to send
+	     * @param actions List of actions the NPC can perform
+	     * @returns Response containing text and any action calls
 	     */
-	    setConfig(config) {
-	        const wasAutoCompactEnabled = this.config.enableAutoCompact;
-	        this.config = Object.assign(Object.assign({}, this.config), config);
-	        // Handle auto-compact state change
-	        if (config.enableAutoCompact !== undefined) {
-	            if (config.enableAutoCompact && !wasAutoCompactEnabled) {
-	                this.startAutoCompactCheck();
+	    async talkWithActions(message, actions) {
+	        this._isTalking = true;
+	        try {
+	            // Add user message to history
+	            const userMessage = { role: 'user', content: message };
+	            this.history.push(userMessage);
+	            // Convert NpcActions to ChatTools
+	            const tools = actions
+	                .filter(a => a && a.enabled !== false)
+	                .map(a => npcActionToTool(a));
+	            // Build messages array with system prompt
+	            const messages = [
+	                { role: 'system', content: this.buildSystemPrompt() },
+	                ...this.history,
+	            ];
+	            // Generate response with tools
+	            const result = await this.chatClient.textGenerationWithTools({
+	                messages,
+	                temperature: this.temperature,
+	                tools,
+	                tool_choice: 'auto',
+	            });
+	            // Build response
+	            const response = {
+	                text: result.content || '',
+	                actionCalls: [],
+	                hasActions: false,
+	            };
+	            // Extract tool calls if any
+	            if (result.tool_calls) {
+	                response.actionCalls = result.tool_calls.map(tc => ({
+	                    id: tc.id,
+	                    actionName: tc.function.name,
+	                    arguments: this.parseToolArguments(tc.function.arguments),
+	                }));
+	                response.hasActions = response.actionCalls.length > 0;
 	            }
-	            else if (!config.enableAutoCompact && wasAutoCompactEnabled) {
-	                this.stopAutoCompactCheck();
+	            // Add assistant response to history
+	            const assistantMessage = {
+	                role: 'assistant',
+	                content: response.text,
+	                tool_calls: result.tool_calls,
+	            };
+	            this.history.push(assistantMessage);
+	            this.trimHistory();
+	            this.emit('response', response.text);
+	            if (response.hasActions) {
+	                this.emit('actions', response.actionCalls);
 	            }
+	            // Trigger reply prediction generation (fire and forget)
+	            this.triggerReplyPrediction();
+	            return response;
+	        }
+	        finally {
+	            this._isTalking = false;
 	        }
-	    }
-	    // ===== Player Description =====
-	    /**
-	     * Set the player's description for AI context.
-	     * Used when generating reply predictions and for NPC context.
-	     * @param description Description of the player character
-	     */
-	    setPlayerDescription(description) {
-	        this.playerDescription = description;
-	        this.emit('playerDescriptionChanged', description);
-	    }
-	    /**
-	     * Get the current player description.
-	     * @returns The player description, or null if not set
-	     */
-	    getPlayerDescription() {
-	        return this.playerDescription;
 	    }
 	    /**
-	     * Clear the player description.
+	     * Talk to the NPC with actions (streaming)
+	     * Text streams first, action calls are returned in onComplete
 	     */
-	    clearPlayerDescription() {
-	        this.playerDescription = null;
-	        this.emit('playerDescriptionChanged', null);
+	    async talkWithActionsStream(message, actions, onChunk, onComplete) {
+	        this._isTalking = true;
+	        try {
+	            // Add user message to history
+	            const userMessage = { role: 'user', content: message };
+	            this.history.push(userMessage);
+	            // Convert NpcActions to ChatTools
+	            const tools = actions
+	                .filter(a => a && a.enabled !== false)
+	                .map(a => npcActionToTool(a));
+	            // Build messages array with system prompt
+	            const messages = [
+	                { role: 'system', content: this.buildSystemPrompt() },
+	                ...this.history,
+	            ];
+	            // Generate response with tools (streaming)
+	            await this.chatClient.textGenerationWithToolsStream({
+	                messages,
+	                temperature: this.temperature,
+	                tools,
+	                tool_choice: 'auto',
+	                onChunk,
+	                onComplete: (result) => {
+	                    this._isTalking = false;
+	                    // Build response
+	                    const response = {
+	                        text: result.content || '',
+	                        actionCalls: [],
+	                        hasActions: false,
+	                    };
+	                    // Extract tool calls if any
+	                    if (result.tool_calls) {
+	                        response.actionCalls = result.tool_calls.map(tc => ({
+	                            id: tc.id,
+	                            actionName: tc.function.name,
+	                            arguments: this.parseToolArguments(tc.function.arguments),
+	                        }));
+	                        response.hasActions = response.actionCalls.length > 0;
+	                    }
+	                    // Add assistant response to history
+	                    const assistantMessage = {
+	                        role: 'assistant',
+	                        content: response.text,
+	                        tool_calls: result.tool_calls,
+	                    };
+	                    this.history.push(assistantMessage);
+	                    this.trimHistory();
+	                    this.emit('response', response.text);
+	                    if (response.hasActions) {
+	                        this.emit('actions', response.actionCalls);
+	                    }
+	                    // Trigger reply prediction generation (fire and forget)
+	                    this.triggerReplyPrediction();
+	                    if (onComplete) {
+	                        onComplete(response);
+	                    }
+	                },
+	            });
+	        }
+	        catch (error) {
+	            this._isTalking = false;
+	            throw error;
+	        }
 	    }
-	    // ===== NPC Tracking =====
+	    // ===== Action Results Reporting =====
 	    /**
-	     * Register an NPC for context management.
-	     * @param npc The NPC client to register
+	     * Report action results back to the conversation
+	     * Call this after executing actions to let the NPC know the results
 	     */
-	    registerNpc(npc) {
-	        if (!npc)
-	            return;
-	        if (!this.npcStates.has(npc)) {
-	            this.npcStates.set(npc, {
-	                lastConversationTime: new Date(),
-	                isCompacted: false,
-	                compactionCount: 0,
+	    reportActionResults(results) {
+	        for (const [callId, result] of Object.entries(results)) {
+	            this.history.push({
+	                role: 'tool',
+	                tool_call_id: callId,
+	                content: result,
 	            });
 	        }
 	    }
 	    /**
-	     * Unregister an NPC (call when NPC is destroyed/removed).
-	     * @param npc The NPC client to unregister
+	     * Report a single action result
 	     */
-	    unregisterNpc(npc) {
-	        if (!npc)
-	            return;
-	        this.npcStates.delete(npc);
+	    reportActionResult(callId, result) {
+	        this.history.push({
+	            role: 'tool',
+	            tool_call_id: callId,
+	            content: result,
+	        });
 	    }
 	    /**
-	     * Record that a conversation occurred with an NPC.
-	     * Called after each Talk() exchange.
-	     * @param npc The NPC client that had a conversation
+	     * Parse tool arguments from JSON string
 	     */
-	    recordConversation(npc) {
-	        if (!npc)
-	            return;
-	        if (!this.npcStates.has(npc)) {
-	            this.registerNpc(npc);
+	    parseToolArguments(args) {
+	        try {
+	            return JSON.parse(args);
+	        }
+	        catch (_a) {
+	            return {};
 	        }
-	        const state = this.npcStates.get(npc);
-	        state.lastConversationTime = new Date();
-	        state.isCompacted = false; // Reset compaction flag on new conversation
 	    }
+	    // ===== Conversation History Management =====
 	    /**
-	     * Get all registered NPCs
+	     * Get conversation history
 	     */
-	    getRegisteredNpcs() {
-	        return Array.from(this.npcStates.keys());
+	    getHistory() {
+	        return [...this.history];
 	    }
 	    /**
-	     * Get the conversation state for an NPC
+	     * Get the number of messages in history
 	     */
-	    getNpcState(npc) {
-	        return this.npcStates.get(npc);
+	    getHistoryLength() {
+	        return this.history.length;
 	    }
-	    // ===== Auto Compaction =====
 	    /**
-	     * Check if an NPC is eligible for compaction.
-	     * @param npc The NPC to check
-	     * @returns True if eligible for compaction
+	     * Clear conversation history.
+	     * The character design and memories will be preserved.
 	     */
-	    isEligibleForCompaction(npc) {
-	        if (!npc)
-	            return false;
-	        const state = this.npcStates.get(npc);
-	        if (!state)
-	            return false;
-	        // Check if already compacted since last conversation
-	        if (state.isCompacted)
-	            return false;
-	        // Check message count
-	        const history = npc.getHistory();
-	        const nonSystemMessages = history.filter(m => m.role !== 'system').length;
-	        if (nonSystemMessages < this.config.autoCompactMinMessages)
-	            return false;
-	        // Check time since last conversation
-	        const timeSinceLastConversation = (Date.now() - state.lastConversationTime.getTime()) / 1000;
-	        if (timeSinceLastConversation < this.config.autoCompactTimeoutSeconds)
-	            return false;
-	        return true;
+	    clearHistory() {
+	        this.history = [];
+	        this.emit('history_cleared');
 	    }
 	    /**
-	     * Manually trigger conversation compaction for a specific NPC.
-	     * Summarizes the conversation history and stores it as a memory.
-	     * @param npc The NPC to compact
-	     * @returns True if compaction succeeded
+	     * Revert the last exchange (user message and assistant response) from history.
+	     * @returns true if reverted, false if not enough history
 	     */
-	    async compactConversation(npc) {
-	        if (!npc) {
-	            this.logger.warn('Cannot compact: NPC is null');
-	            return false;
-	        }
-	        if (!this.chatClientFactory) {
-	            this.logger.error('Cannot compact: No chat client factory set. Call setChatClientFactory() first.');
-	            return false;
-	        }
-	        const history = npc.getHistory();
-	        const nonSystemMessages = history.filter(m => m.role !== 'system');
-	        if (nonSystemMessages.length < 2) {
-	            this.logger.info('Skipping compaction: not enough messages');
-	            return false;
-	        }
-	        try {
-	            this.logger.info(`Starting compaction (${nonSystemMessages.length} messages)`);
-	            // Build conversation text for summarization
-	            const conversationText = nonSystemMessages
-	                .map(m => `${m.role}: ${m.content}`)
-	                .join('\n');
-	            // Create summarization prompt
-	            const summaryPrompt = `Summarize the following conversation concisely. Focus on:
-1. Key topics discussed
-2. Important information exchanged
-3. Any decisions or commitments made
-4. The emotional tone
-
-Keep the summary under 200 words. Write in third person.
-
-Conversation:
-${conversationText}`;
-	            // Use chat client for summarization
-	            const chatClient = this.chatClientFactory();
-	            const result = await chatClient.textGeneration({
-	                messages: [{ role: 'user', content: summaryPrompt }],
-	                temperature: 0.5,
-	                model: this.config.fastModel || undefined,
-	            });
-	            if (!result.content) {
-	                const error = 'Empty response from summarization';
-	                this.logger.error(`Compaction failed: ${error}`);
-	                this.emit('compactionFailed', npc, error);
-	                return false;
+	    revertHistory() {
+	        let lastAssistantIndex = -1;
+	        let lastUserIndex = -1;
+	        for (let i = this.history.length - 1; i >= 0; i--) {
+	            if (this.history[i].role === 'assistant' && lastAssistantIndex === -1) {
+	                lastAssistantIndex = i;
 	            }
-	            // Clear history and add summary as memory
-	            npc.clearHistory();
-	            npc.setMemory('PreviousConversationSummary', result.content);
-	            // Update state
-	            const state = this.npcStates.get(npc);
-	            if (state) {
-	                state.isCompacted = true;
-	                state.compactionCount++;
+	            else if (this.history[i].role === 'user' && lastAssistantIndex !== -1 && lastUserIndex === -1) {
+	                lastUserIndex = i;
+	                break;
 	            }
-	            this.logger.info(`Compaction completed. Summary: ${result.content.substring(0, 100)}...`);
-	            this.emit('npcCompacted', npc);
-	            return true;
 	        }
-	        catch (error) {
-	            const errorMessage = error instanceof Error ? error.message : String(error);
-	            this.logger.error(`Compaction error: ${errorMessage}`);
-	            this.emit('compactionFailed', npc, errorMessage);
-	            return false;
+	        if (lastAssistantIndex !== -1 && lastUserIndex !== -1) {
+	            // Remove in reverse order to maintain indices
+	            this.history.splice(lastAssistantIndex, 1);
+	            this.history.splice(lastUserIndex, 1);
+	            this.emit('history_reverted');
+	            return true;
 	        }
+	        return false;
 	    }
 	    /**
-	     * Compact all registered NPCs that meet the eligibility criteria.
-	     * @returns Number of NPCs successfully compacted
+	     * Revert (remove) the last N chat messages from history
+	     * @param count Number of messages to remove
+	     * @returns Number of messages actually removed
 	     */
-	    async compactAllEligible() {
-	        const eligibleNpcs = Array.from(this.npcStates.keys()).filter(npc => this.isEligibleForCompaction(npc));
-	        if (eligibleNpcs.length === 0) {
+	    revertChatMessages(count) {
+	        if (count <= 0)
 	            return 0;
+	        const messagesToRemove = Math.min(count, this.history.length);
+	        const originalCount = this.history.length;
+	        this.history = this.history.slice(0, -messagesToRemove);
+	        const actuallyRemoved = originalCount - this.history.length;
+	        if (actuallyRemoved > 0) {
+	            this.emit('history_reverted', actuallyRemoved);
 	        }
-	        this.logger.info(`Compacting ${eligibleNpcs.length} eligible NPCs`);
-	        let successCount = 0;
-	        for (const npc of eligibleNpcs) {
-	            const success = await this.compactConversation(npc);
-	            if (success)
-	                successCount++;
-	        }
-	        return successCount;
+	        return actuallyRemoved;
 	    }
-	    // ===== Auto Compact Timer =====
 	    /**
-	     * Start the auto-compact check timer
+	     * Revert to a specific point in history
+	     * @deprecated Use revertHistory() or revertChatMessages() instead
 	     */
-	    startAutoCompactCheck() {
-	        if (this.autoCompactTimer) {
-	            this.stopAutoCompactCheck();
+	    revertToMessage(index) {
+	        if (index >= 0 && index < this.history.length) {
+	            this.history = this.history.slice(0, index + 1);
+	            this.emit('history_reverted', index);
 	        }
-	        this.autoCompactTimer = setInterval(() => {
-	            this.runAutoCompactCheck();
-	        }, this.config.autoCompactCheckInterval);
 	    }
 	    /**
-	     * Stop the auto-compact check timer
+	     * Append a message to history manually
 	     */
-	    stopAutoCompactCheck() {
-	        if (this.autoCompactTimer) {
-	            clearInterval(this.autoCompactTimer);
-	            this.autoCompactTimer = null;
-	        }
+	    appendMessage(message) {
+	        this.history.push(message);
+	        this.trimHistory();
 	    }
 	    /**
-	     * Run a single auto-compact check
+	     * Alias for appendMessage (Unity SDK compatibility)
 	     */
-	    async runAutoCompactCheck() {
-	        if (!this.config.enableAutoCompact)
+	    appendChatMessage(role, content) {
+	        if (!role || !content) {
+	            this.logger.warn('Role and content cannot be empty');
 	            return;
-	        const eligibleNpcs = Array.from(this.npcStates.keys()).filter(npc => this.isEligibleForCompaction(npc));
-	        for (const npc of eligibleNpcs) {
-	            // Fire and forget - don't block
-	            this.compactConversation(npc).catch(err => {
-	                this.logger.error('Auto-compact error:', err);
-	            });
 	        }
+	        this.appendMessage({ role: role, content });
 	    }
-	    // ===== Lifecycle =====
 	    /**
-	     * Enable auto-compaction
+	     * Trim history to max length
 	     */
-	    enableAutoCompact() {
-	        this.config.enableAutoCompact = true;
-	        this.startAutoCompactCheck();
+	    trimHistory() {
+	        if (this.history.length > this.maxHistoryLength) {
+	            // Keep the most recent messages
+	            this.history = this.history.slice(-this.maxHistoryLength);
+	        }
 	    }
+	    // ===== Save/Load =====
 	    /**
-	     * Disable auto-compaction
+	     * Save the current conversation history to a serializable format.
+	     * Includes characterDesign, memories, and history.
 	     */
-	    disableAutoCompact() {
-	        this.config.enableAutoCompact = false;
-	        this.stopAutoCompactCheck();
+	    saveHistory() {
+	        const saveData = {
+	            characterDesign: this.characterDesign,
+	            memories: Array.from(this.memories.entries()).map(([name, content]) => ({ name, content })),
+	            history: this.history,
+	        };
+	        return JSON.stringify(saveData);
 	    }
 	    /**
-	     * Clean up resources
+	     * Load conversation history from serialized data.
+	     * Restores characterDesign, memories, and history.
 	     */
-	    destroy() {
-	        this.stopAutoCompactCheck();
-	        this.npcStates.clear();
-	        this.playerDescription = null;
-	        this.removeAllListeners();
+	    loadHistory(saveData) {
+	        try {
+	            const data = JSON.parse(saveData);
+	            // Load character design (with backwards compatibility for old systemPrompt field)
+	            this.characterDesign = data.characterDesign || data.systemPrompt || this.characterDesign;
+	            // Load memories
+	            this.memories.clear();
+	            if (data.memories && Array.isArray(data.memories)) {
+	                for (const memory of data.memories) {
+	                    if (memory.name && memory.content) {
+	                        this.memories.set(memory.name, memory.content);
+	                    }
+	                }
+	            }
+	            // Load history (skip system messages as they'll be rebuilt from characterDesign + memories)
+	            this.history = (data.history || []).filter(m => m.role !== 'system');
+	            this.emit('history_loaded');
+	            return true;
+	        }
+	        catch (error) {
+	            this.logger.error('Failed to load history:', error);
+	            return false;
+	        }
 	    }
 	}
-	AIContextManager._instance = null;
-	/**
-	 * Default AIContextManager instance
-	 * Can be used as a global context manager
-	 */
-	const defaultContextManager = AIContextManager.getInstance();
 
 	/**
 	 * Schema Library for managing JSON schemas for AI structured output generation
@@ -6697,20 +6894,20 @@ ${conversationText}`;
 	        // Create indicator element
 	        this.devTokenIndicator = document.createElement('div');
 	        this.devTokenIndicator.textContent = 'DeveloperToken';
-	        this.devTokenIndicator.style.cssText = `
-      position: fixed;
-      top: 10px;
-      left: 10px;
-      background-color: #dc2626;
-      color: white;
-      padding: 4px 12px;
-      border-radius: 4px;
-      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-      font-size: 12px;
-      font-weight: 600;
-      z-index: 999999;
-      pointer-events: none;
-      box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);
+	        this.devTokenIndicator.style.cssText = `
+      position: fixed;
+      top: 10px;
+      left: 10px;
+      background-color: #dc2626;
+      color: white;
+      padding: 4px 12px;
+      border-radius: 4px;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+      font-size: 12px;
+      font-weight: 600;
+      z-index: 999999;
+      pointer-events: none;
+      box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);
     `;
 	        document.body.appendChild(this.devTokenIndicator);
 	    }
@@ -6873,7 +7070,7 @@ ${conversationText}`;
 	     */
 	    setDebug(enabled) {
 	        this.config.debug = enabled;
-	        Logger.setGlobalLevel(enabled ? exports.LogLevel.DEBUG : exports.LogLevel.WARN);
+	        Logger.setGlobalLevel(enabled ? LogLevel.DEBUG : LogLevel.WARN);
 	    }
 	    /**
 	     * Configure the logging system
@@ -6895,7 +7092,7 @@ ${conversationText}`;
 	    initializeLogging(config) {
 	        // Handle legacy debug option for backwards compatibility
 	        if (config.debug !== undefined && config.logging === undefined) {
-	            Logger.setGlobalLevel(config.debug ? exports.LogLevel.DEBUG : exports.LogLevel.WARN);
+	            Logger.setGlobalLevel(config.debug ? LogLevel.DEBUG : LogLevel.WARN);
 	        }
 	        // Apply new logging config
 	        if (config.logging) {
@@ -7099,9 +7296,7 @@ ${conversationText}`;
 	     */
 	    async validateToken(token, gameId) {
 	        var _a, _b;
-	        const headers = {
-	            'Authorization': `Bearer ${token}`,
-	        };
+	        const headers = Object.assign({ 'Authorization': `Bearer ${token}` }, getSDKHeaders());
 	        if (gameId) {
 	            headers['X-Game-Id'] = gameId;
 	        }
@@ -7131,9 +7326,7 @@ ${conversationText}`;
 	     */
 	    async verifyToken(token, gameId) {
 	        var _a, _b;
-	        const headers = {
-	            'Authorization': `Bearer ${token}`,
-	        };
+	        const headers = Object.assign({ 'Authorization': `Bearer ${token}` }, getSDKHeaders());
 	        if (gameId) {
 	            headers['X-Game-Id'] = gameId;
 	        }
@@ -7196,36 +7389,61 @@ ${conversationText}`;
 	 */
 	const defaultTokenValidator = new TokenValidator();
 
-	exports.AIContextManager = AIContextManager;
-	exports.AuthFlowManager = AuthFlowManager;
-	exports.AuthManager = AuthManager;
-	exports.BrowserStorage = BrowserStorage;
-	exports.BufferLogHandler = BufferLogHandler;
-	exports.CallbackLogHandler = CallbackLogHandler;
-	exports.ChatClient = ChatClient;
-	exports.DeviceAuthFlowManager = DeviceAuthFlowManager;
-	exports.ImageClient = ImageClient;
-	exports.Logger = Logger;
-	exports.MemoryStorage = MemoryStorage;
-	exports.NPCClient = NPCClient;
-	exports.PlayKitSDK = PlayKitSDK;
-	exports.PlayerClient = PlayerClient;
-	exports.RechargeManager = RechargeManager;
-	exports.SchemaLibrary = SchemaLibrary;
-	exports.StreamParser = StreamParser;
-	exports.TokenStorage = TokenStorage;
-	exports.TokenValidator = TokenValidator;
-	exports.TranscriptionClient = TranscriptionClient;
-	exports.createMultimodalMessage = createMultimodalMessage;
-	exports.createStorage = createStorage;
-	exports.createTextMessage = createTextMessage;
-	exports.default = PlayKitSDK;
-	exports.defaultContextManager = defaultContextManager;
-	exports.defaultSchemaLibrary = defaultSchemaLibrary;
-	exports.defaultTokenValidator = defaultTokenValidator;
-	exports.isLocalStorageAvailable = isLocalStorageAvailable;
-
-	Object.defineProperty(exports, '__esModule', { value: true });
+	/**
+	 * PlayKit SDK for JavaScript
+	 * AI integration for web-based games
+	 */
+	// Main SDK
+
+	var namespace = /*#__PURE__*/Object.freeze({
+		__proto__: null,
+		AIContextManager: AIContextManager,
+		AuthFlowManager: AuthFlowManager,
+		AuthManager: AuthManager,
+		BrowserStorage: BrowserStorage,
+		BufferLogHandler: BufferLogHandler,
+		CallbackLogHandler: CallbackLogHandler,
+		ChatClient: ChatClient,
+		DeviceAuthFlowManager: DeviceAuthFlowManager,
+		ImageClient: ImageClient,
+		get LogLevel () { return LogLevel; },
+		Logger: Logger,
+		MemoryStorage: MemoryStorage,
+		NPCClient: NPCClient,
+		PlayKitSDK: PlayKitSDK,
+		PlayerClient: PlayerClient,
+		RechargeManager: RechargeManager,
+		SchemaLibrary: SchemaLibrary,
+		StreamParser: StreamParser,
+		TokenStorage: TokenStorage,
+		TokenValidator: TokenValidator,
+		TranscriptionClient: TranscriptionClient,
+		createMultimodalMessage: createMultimodalMessage,
+		createStorage: createStorage,
+		createTextMessage: createTextMessage,
+		default: PlayKitSDK,
+		defaultContextManager: defaultContextManager,
+		defaultSchemaLibrary: defaultSchemaLibrary,
+		defaultTokenValidator: defaultTokenValidator,
+		isLocalStorageAvailable: isLocalStorageAvailable
+	});
+
+	/**
+	 * UMD bundle entry.
+	 *
+	 * Goal: make `window.PlayKitSDK` directly the constructor class while still
+	 * exposing every named export as a property on it.
+	 *
+	 * Result:
+	 *   new window.PlayKitSDK(cfg)              // recommended
+	 *   new window.PlayKitSDK.PlayKitSDK(cfg)   // legacy v1.x form, still works
+	 *   window.PlayKitSDK.ChatClient            // named exports preserved
+	 */
+	Object.assign(PlayKitSDK, namespace);
+	PlayKitSDK.PlayKitSDK = PlayKitSDK;
+	PlayKitSDK.default = PlayKitSDK;
+
+	return PlayKitSDK;
 
 }));
 //# sourceMappingURL=playkit-sdk.umd.js.map