playkit-sdk 1.2.12 → 1.3.0

package/dist/playkit-sdk.cjs.js

@@ -1,5 +1,5 @@
 /**
- * playkit-sdk v1.2.12
+ * playkit-sdk v1.3.0
  * PlayKit SDK for JavaScript
  * @license SEE LICENSE IN LICENSE
  */
@@ -829,6 +829,15 @@ class TokenStorage {
     }
 }
 
+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
@@ -933,8 +942,8 @@ class AuthFlowManager extends EventEmitter {
     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;
@@ -1015,84 +1024,84 @@ class AuthFlowManager extends EventEmitter {
         // 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();
@@ -1127,274 +1136,274 @@ class AuthFlowManager extends EventEmitter {
             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);
     }
@@ -1415,14 +1424,14 @@ class AuthFlowManager extends EventEmitter {
                 : 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>
         `;
             }
         };
@@ -1443,7 +1452,7 @@ class AuthFlowManager extends EventEmitter {
             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);
@@ -1535,7 +1544,7 @@ class AuthFlowManager extends EventEmitter {
     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) {
@@ -1557,7 +1566,7 @@ class AuthFlowManager extends EventEmitter {
         }
         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,
@@ -1578,7 +1587,9 @@ class AuthFlowManager extends EventEmitter {
     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') {
@@ -1835,76 +1846,76 @@ class DeviceAuthFlowManager extends EventEmitter {
         // 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';
@@ -1931,18 +1942,18 @@ class DeviceAuthFlowManager extends EventEmitter {
         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';
@@ -2012,11 +2023,11 @@ class DeviceAuthFlowManager extends EventEmitter {
         // 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);
@@ -2086,9 +2097,7 @@ class DeviceAuthFlowManager extends EventEmitter {
         // 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,
@@ -2157,7 +2166,7 @@ class DeviceAuthFlowManager extends EventEmitter {
                     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') {
@@ -2285,9 +2294,7 @@ class DeviceAuthFlowManager extends EventEmitter {
         // 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,
@@ -2350,7 +2357,7 @@ class DeviceAuthFlowManager extends EventEmitter {
                     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') {
@@ -2430,6 +2437,8 @@ class AuthManager extends EventEmitter {
         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({
@@ -2538,12 +2547,27 @@ class AuthManager extends EventEmitter {
      * @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. ' +
@@ -2602,10 +2626,7 @@ class AuthManager extends EventEmitter {
         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) {
@@ -2955,9 +2976,7 @@ class AuthManager extends EventEmitter {
             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,
                 }),
@@ -3060,7 +3079,7 @@ const translations = {
  * 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;
@@ -3163,220 +3182,220 @@ class RechargeManager extends EventEmitter {
             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);
     }
@@ -3513,7 +3532,8 @@ class RechargeManager extends EventEmitter {
 /**
  * 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 {
@@ -3531,7 +3551,7 @@ class PlayerClient extends EventEmitter {
             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,
         };
     }
@@ -3546,9 +3566,7 @@ class PlayerClient extends EventEmitter {
         }
         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;
             }
@@ -3648,10 +3666,7 @@ class PlayerClient extends EventEmitter {
         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) {
@@ -3801,10 +3816,84 @@ class PlayerClient extends EventEmitter {
     }
 }
 
+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;
@@ -3822,6 +3911,7 @@ class ChatProvider {
      */
     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();
@@ -3843,10 +3933,7 @@ class ChatProvider {
         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) {
@@ -3881,6 +3968,7 @@ class ChatProvider {
      */
     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();
@@ -3902,10 +3990,7 @@ class ChatProvider {
         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) {
@@ -3942,6 +4027,7 @@ class ChatProvider {
      */
     async chatCompletionWithTools(chatConfig) {
         var _a, _b;
+        assertValidMessages(chatConfig.messages);
         const token = this.authManager.getToken();
         if (!token) {
             throw new PlayKitError('Not authenticated', 'NOT_AUTHENTICATED');
@@ -3968,10 +4054,7 @@ class ChatProvider {
         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) {
@@ -4002,6 +4085,7 @@ class ChatProvider {
      */
     async chatCompletionWithToolsStream(chatConfig) {
         var _a, _b;
+        assertValidMessages(chatConfig.messages);
         const token = this.authManager.getToken();
         if (!token) {
             throw new PlayKitError('Not authenticated', 'NOT_AUTHENTICATED');
@@ -4028,10 +4112,7 @@ class ChatProvider {
         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) {
@@ -4101,10 +4182,7 @@ class ChatProvider {
         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) {
@@ -4122,11 +4200,12 @@ class ChatProvider {
                 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) {
@@ -4145,7 +4224,8 @@ class ChatProvider {
 /**
  * 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;
@@ -4198,10 +4278,7 @@ class ImageProvider {
         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) {
@@ -4236,7 +4313,8 @@ class ImageProvider {
 /**
  * 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;
@@ -4301,10 +4379,7 @@ class TranscriptionProvider {
         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) {
@@ -4450,9 +4525,18 @@ class StreamParser {
                                 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
@@ -4551,6 +4635,18 @@ class StreamParser {
 /**
  * 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;
@@ -4600,7 +4696,7 @@ class ChatClient {
             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
@@ -4671,9 +4767,10 @@ class ChatClient {
         }
         // 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));
     }
     /**
@@ -4764,7 +4861,7 @@ class ChatClient {
             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
@@ -4828,7 +4925,7 @@ class GeneratedImageImpl {
         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();
         });
     }
@@ -4842,13 +4939,14 @@ class ImageClient {
      * 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
@@ -4857,10 +4955,11 @@ class ImageClient {
         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);
         });
     }
     /**
@@ -4979,1019 +5078,1117 @@ class TranscriptionClient {
 }
 
 /**
- * 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 =====
     /**
-     * Revert to a specific point in history
-     * @deprecated Use revertHistory() or revertChatMessages() instead
+     * Enable or disable automatic reply prediction
      */
-    revertToMessage(index) {
-        if (index >= 0 && index < this.history.length) {
-            this.history = this.history.slice(0, index + 1);
-            this.emit('history_reverted', index);
-        }
+    setGenerateReplyPrediction(enabled) {
+        this.generateReplyPrediction = enabled;
     }
     /**
-     * Append a message to history manually
+     * Set the number of predictions to generate
      */
-    appendMessage(message) {
-        this.history.push(message);
-        this.trimHistory();
+    setPredictionCount(count) {
+        this.predictionCount = Math.max(2, Math.min(6, count));
     }
     /**
-     * Alias for appendMessage (Unity SDK compatibility)
+     * 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
      */
-    appendChatMessage(role, content) {
-        if (!role || !content) {
-            this.logger.warn('Role and content cannot be empty');
-            return;
+    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 [];
         }
-        this.appendMessage({ role: role, content });
     }
     /**
-     * Trim history to max length
+     * Parse predictions from JSON array response
      */
-    trimHistory() {
-        if (this.history.length > this.maxHistoryLength) {
-            // Keep the most recent messages
-            this.history = this.history.slice(-this.maxHistoryLength);
+    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);
         }
     }
-    // ===== Save/Load =====
     /**
-     * Save the current conversation history to a serializable format.
-     * Includes characterDesign, memories, and history.
+     * Fallback: Extract predictions from text when JSON parsing fails
      */
-    saveHistory() {
-        const saveData = {
-            characterDesign: this.characterDesign,
-            memories: Array.from(this.memories.entries()).map(([name, content]) => ({ name, content })),
-            history: this.history,
-        };
-        return JSON.stringify(saveData);
+    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;
     }
     /**
-     * Load conversation history from serialized data.
-     * Restores characterDesign, memories, and history.
+     * Internal method to trigger prediction generation after NPC response
      */
-    loadHistory(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 =====
+    /**
+     * Talk to the NPC (non-streaming)
+     */
+    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.
-     */
-    clearPlayerDescription() {
-        this.playerDescription = null;
-        this.emit('playerDescriptionChanged', null);
-    }
-    // ===== NPC Tracking =====
     /**
-     * Register an NPC for context management.
-     * @param npc The NPC client to register
+     * Talk to the NPC with actions (streaming)
+     * Text streams first, action calls are returned in onComplete
      */
-    registerNpc(npc) {
-        if (!npc)
-            return;
-        if (!this.npcStates.has(npc)) {
-            this.npcStates.set(npc, {
-                lastConversationTime: new Date(),
-                isCompacted: false,
-                compactionCount: 0,
+    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;
+        }
     }
+    // ===== Action Results Reporting =====
     /**
-     * Unregister an NPC (call when NPC is destroyed/removed).
-     * @param npc The NPC client to unregister
+     * Report action results back to the conversation
+     * Call this after executing actions to let the NPC know the results
      */
-    unregisterNpc(npc) {
-        if (!npc)
-            return;
-        this.npcStates.delete(npc);
+    reportActionResults(results) {
+        for (const [callId, result] of Object.entries(results)) {
+            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
+     * Report a single action result
      */
-    recordConversation(npc) {
-        if (!npc)
-            return;
-        if (!this.npcStates.has(npc)) {
-            this.registerNpc(npc);
+    reportActionResult(callId, result) {
+        this.history.push({
+            role: 'tool',
+            tool_call_id: callId,
+            content: result,
+        });
+    }
+    /**
+     * Parse tool arguments from JSON string
+     */
+    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
@@ -6350,20 +6547,20 @@ class PlayKitSDK extends EventEmitter {
         // 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);
     }
@@ -6752,9 +6949,7 @@ class TokenValidator {
      */
     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;
         }
@@ -6784,9 +6979,7 @@ class TokenValidator {
      */
     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;
         }