@storvia/sdk 0.6.1 → 0.7.0

package/dist/index.d.mts

@@ -385,13 +385,6 @@ interface State {
     dormant: DormantState;
 }
 
-interface GameSettings {
-    temperature: number;
-    replyLength: string;
-    replyLanguage: string;
-    playerNote: string;
-}
-
 declare class ChatModule {
     private http;
     private getGameId;
@@ -399,9 +392,8 @@ declare class ChatModule {
     private getModelId;
     private isPreview;
     private previewConfig?;
-    private getSettings?;
     private getModelName?;
-    constructor(http: HttpClient, getGameId: () => string, getConversationId: () => string, getModelId: () => string, isPreview?: boolean, previewConfig?: Record<string, unknown>, getSettings?: () => GameSettings | null | undefined, getModelName?: () => string | undefined);
+    constructor(http: HttpClient, getGameId: () => string, getConversationId: () => string, getModelId: () => string, isPreview?: boolean, previewConfig?: Record<string, unknown>, getModelName?: () => string | undefined);
     /** 构造 http 层的元信息（用于 debug 日志标题显示） */
     private reqMeta;
     /** 更新预览配置（由父页面 postMessage 触发） */
@@ -691,10 +683,11 @@ declare class MemoryModule {
 interface DevConfig {
     apiKey: string;
     gameId: string;
+    /** 本地预览/dev：指定初始模型的展示名（display name）。不传则用第一个可用模型。 */
+    model?: string;
 }
 declare class StorviaSDK {
     private http;
-    private settingsSheet;
     private baseUrl;
     private gameId;
     private conversationId;
@@ -716,18 +709,18 @@ declare class StorviaSDK {
     state: StateModule;
     memory: MemoryModule;
     init(): Promise<void>;
+    /**
+     * 监听宿主运行时下发的模型切换（envelope 'set-model'）。
+     * 正式模式用：宿主已接管模型选择，用户在宿主 FAB 改模型时实时同步到 SDK。
+     * （预览模式的 set-model 在 listenForPreviewMessages 内单独处理。）
+     */
+    private listenForModelChange;
     /**
      * 监听父页面 token 刷新（envelope 'token-update'）。
      * Supabase JWT 默认 1h 过期，父页面 session 自动刷新后转发新 token 进来，
      * 否则 SDK 会一直用旧 token 请求被服务端 401。
      */
     private listenForTokenUpdate;
-    /**
-     * 用户在 SDK 内置选择器里切换模型时统一入口：
-     * 更新内部 modelId，并把选择回传给宿主（主站/App），实现双向同步与持久化。
-     * dev 模式没有 bus（无父页面），此时仅更新本地。
-     */
-    private handleLocalModelChange;
     /** 监听父页面发来的预览模式动态更新（envelope 'config-update' / 'set-model'） */
     private listenForPreviewMessages;
     /**
@@ -739,13 +732,8 @@ declare class StorviaSDK {
     private fetchPreviewSnapshot;
     /** 重新拉 snapshot 并把结果灌进每个 module 的 mem（用于 update-config 后同步） */
     private refreshPreviewSnapshot;
-    /** 保存设置到后端 */
-    private saveSettings;
-    /** 同步最新游戏设定到当前存档 */
-    syncSettings(): Promise<void>;
     private fetchModels;
     private authenticate;
-    private getSavedModelId;
     initDev(devConfig: DevConfig): Promise<void>;
     getAssets(type: 'avatar' | 'icon', category?: string): Promise<AssetItem[]>;
 }
@@ -793,6 +781,12 @@ interface InitPayload {
      * 待主站 / App 全部升级后改为必填，以彻底消除 /auth 端选错存档的漂移。
      */
     conversationId?: string;
+    /**
+     * 宿主（主站/App）已选中的模型 UUID。宿主已接管模型选择 → 正式模式优先用它，
+     * 盖过 SDK 自己的 localStorage / 列表首项。随 init 一起下发，避免「init 后单独发 set-model」
+     * 在 SDK 注册监听前到达而丢失的竞态。运行时切换仍走 envelope 'set-model'。
+     */
+    selectedModelId?: string;
     debug?: boolean;
 }
 interface PreviewConfig {