@storvia/sdk 0.2.1 → 0.3.0

package/dist/index.d.mts

@@ -20,7 +20,7 @@ type StorviaErrorCode = 'UNAUTHORIZED' | 'INSUFFICIENT_BALANCE' | 'RATE_LIMITED'
 interface ChatSendOptions {
     message: string;
     topic?: string;
-    context?: string;
+    scene_key?: string;
     stream?: boolean;
     onChunk?: (text: string) => void;
     onDone?: (id: string) => void;
@@ -32,7 +32,7 @@ interface ChatSaveOptions {
 }
 interface ChatGenerateOptions {
     topic?: string;
-    context?: string;
+    scene_key?: string;
     stream?: boolean;
     save?: boolean;
     onChunk?: (text: string) => void;
@@ -40,7 +40,7 @@ interface ChatGenerateOptions {
 }
 interface ChatRetryOptions {
     topic?: string;
-    context?: string;
+    scene_key?: string;
     stream?: boolean;
     onChunk?: (text: string) => void;
     onDone?: (id: string) => void;
@@ -162,7 +162,7 @@ declare class ChatModule {
         id: string;
     }>;
     /**
-     * 基于 topic 历史 + context 请求 AI 生成回复（无需当前轮用户输入）
+     * 基于 topic 历史 + scene_key 请求 AI 生成回复（无需当前轮用户输入）
      * 适用于群聊 NPC 回复、NPC 自动发言、弹幕生成等
      */
     generate(options: ChatGenerateOptions): Promise<ChatResponse | void>;
@@ -171,7 +171,10 @@ declare class ChatModule {
      * 适用于 AI 回复出错或不满意时重新生成
      */
     retry(options?: ChatRetryOptions): Promise<ChatResponse | void>;
-    /** 预览模式：发到 /preview 端点 */
+    /** 预览模式：发到 /preview 端点
+     *  - 创作台预览：父页面已注入 previewConfig，请求体塞 prompt_config，服务端不查库
+     *  - 本地预览 / dev：无 previewConfig，请求体塞 game_id，服务端按 hash_id 查 prompts
+     */
     private sendPreview;
 }
 
@@ -197,6 +200,14 @@ declare class CharactersModule {
     update(name: string, data: CharacterUpdateOptions): Promise<void>;
     remove(name: string): Promise<void>;
     detail(name: string): Promise<CharacterDetail>;
+    /**
+     * 调整 NPC 的重要程度（0-100，越高越不容易被挤出场景）。
+     * 预设 NPC 不可修改（固定为 100），调用会抛错。
+     * 超出范围会自动钳位到 0 或 100。
+     *
+     * 等价写法：`state.update(name, { priority: value })`
+     */
+    setPriority(name: string, value: number): Promise<void>;
 }
 
 declare class RelationshipsModule {