playkit-sdk 1.2.12 → 1.3.0

package/dist/playkit-sdk.d.ts

@@ -657,10 +657,12 @@ interface ChatCompletionResponse {
  * Streaming chunk formats
  */
 interface StreamChunk {
-    type: 'text-delta' | 'done' | 'error';
+    type: 'text-delta' | 'done' | 'finish' | 'abort' | 'error';
     id?: string;
     delta?: string;
     error?: string;
+    errorText?: string;
+    reason?: string;
 }
 /**
  * NPC Action parameter types
@@ -1069,6 +1071,8 @@ declare class AuthManager extends EventEmitter {
     private logger;
     /** Shared promise for current device auth flow - allows multiple callers to await the same result */
     private currentDeviceAuthFlowPromise;
+    /** Shared promise for current auth flow (startAuthFlow) - allows multiple callers to await the same result */
+    private currentAuthFlowPromise;
     constructor(config: SDKConfig);
     /**
      * Initialize authentication
@@ -1081,6 +1085,11 @@ declare class AuthManager extends EventEmitter {
      * @deprecated 'headless' authentication is deprecated and will be removed in v2.0. Use 'device' instead.
      */
     startAuthFlow(authMethod?: 'device' | 'headless'): Promise<void>;
+    /**
+     * Internal method that executes the actual auth flow
+     * @private
+     */
+    private executeAuthFlow;
     /**
      * Exchange JWT for player token
      */
@@ -1254,7 +1263,7 @@ interface RechargeConfig {
     checkBalanceAfterApiCall?: boolean;
     /**
      * Base URL for the recharge portal
-     * @default 'https://playkit.ai/recharge'
+     * @default 'https://players.playkit.ai/recharge'
      */
     rechargePortalUrl?: string;
     /**
@@ -2027,10 +2036,11 @@ declare class NPCClient extends EventEmitter {
     /**
      * 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
      */
-    generateReplyPredictions(count?: number): Promise<string[]>;
+    generateReplyPredictions(tempPrompt?: string, count?: number): Promise<string[]>;
     /**
      * Parse predictions from JSON array response
      */
@@ -2188,6 +2198,8 @@ declare class AIContextManager extends EventEmitter<AIContextManagerEvents> {
     private static _instance;
     private config;
     private playerDescription;
+    private playerPrompt;
+    private playerMemories;
     private npcStates;
     private autoCompactTimer;
     private chatClientFactory;
@@ -2226,6 +2238,47 @@ declare class AIContextManager extends EventEmitter<AIContextManagerEvents> {
      * Clear the player description.
      */
     clearPlayerDescription(): void;
+    /**
+     * 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: string | null): void;
+    /**
+     * Get the current player prompt.
+     * @returns The player prompt, or null if not set
+     */
+    getPlayerPrompt(): string | null;
+    /**
+     * 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.
+     */
+    setPlayerMemory(memoryName: string, memoryContent: string | null): void;
+    /**
+     * 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
+     */
+    getPlayerMemory(memoryName: string): string | undefined;
+    /**
+     * Get all player memory names currently stored.
+     * @returns Array of memory names
+     */
+    getPlayerMemoryNames(): string[];
+    /**
+     * Clear all player memories (but keep player prompt).
+     */
+    clearPlayerMemories(): void;
+    /**
+     * 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
+     */
+    buildPlayerContext(): string | null;
     /**
      * Register an NPC for context management.
      * @param npc The NPC client to register
@@ -2675,8 +2728,8 @@ declare class TokenStorage {
 declare class AuthFlowManager extends EventEmitter {
     private baseURL;
     private currentSessionId;
-    private uiContainer;
-    private isSuccess;
+    private _uiContainer;
+    private _isSuccess;
     private currentLanguage;
     private modal;
     private identifierPanel;
@@ -2896,5 +2949,13 @@ declare class TokenValidator {
  */
 declare const defaultTokenValidator: TokenValidator;
 
+declare global {
+    interface Window {
+        PlayKitSDK: typeof PlayKitSDK & {
+            PlayKitSDK: typeof PlayKitSDK;
+        };
+    }
+}
+
 export { AIContextManager, AuthFlowManager, AuthManager, BrowserStorage, BufferLogHandler, CallbackLogHandler, ChatClient, DeviceAuthFlowManager, ImageClient, LogLevel, Logger, MemoryStorage, NPCClient, PlayKitError, PlayKitSDK, PlayerClient, RechargeManager, SchemaLibrary, StreamParser, TokenStorage, TokenValidator, TranscriptionClient, createMultimodalMessage, createStorage, createTextMessage, PlayKitSDK as default, defaultContextManager, defaultSchemaLibrary, defaultTokenValidator, isLocalStorageAvailable };
 export type { AIContextManagerConfig, AIContextManagerEvents, APIResult, AudioContentPart, AuthState, ChatCompletionResponse, ChatConfig, ChatResult, ChatStreamConfig, ChatWithToolsConfig, ChatWithToolsStreamConfig, ConversationSaveData, DeveloperTokenFallbackConfig, DeviceAuthFlowOptions, DeviceAuthInitResult, DeviceAuthResult, GameInfo, GeneratedImage, IStorage, ImageContentPart, ImageGenerationConfig, ImageGenerationResponse, ImageInput, ImageSize, LogConfig, LogEntry, LogHandler, MemoryEntry, Message, MessageContent, MessageContentPart, MessageRole, NPCConfig, PlayerInfo, RechargeConfig, RechargeEvents, RechargeModalOptions, SDKConfig, SDKMode, SchemaEntry, SetNicknameRequest, SetNicknameResponse, StreamChunk, StructuredGenerationConfig, StructuredOutputConfig, StructuredResult, TextContentPart, TokenRefreshResult, TokenScope, TokenStorageOptions, TokenValidatorOptions, TokenVerificationResult, TranscriptionConfig, TranscriptionOptions, TranscriptionResult, TranscriptionSegment, ValidatedPlayerInfo };