@space3-npm/cybersoul-client 1.4.5 → 1.4.8

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { CyberSoulClientConfig, InteractParams, ProactiveParams, ProactiveResponse, OndemandEventParams, OndemandEventResponse, DispatcherIntent, InteractResponse, CharacterState, CoreMemory, UserCodex, HistoryEntry, LikedPicture, PersistedDynamicContext } from "./types.js";
+import { CyberSoulClientConfig, InteractParams, ProactiveParams, ProactiveResponse, OndemandEventParams, OndemandEventResponse, DispatcherIntent, InteractResponse, CharacterState, CoreMemory, UserCodex, HistoryEntry, LikedPicture, PersistedDynamicContext, SupportedLLMModel } from "./types.js";
 export declare class CyberSoulClient {
     private config;
     private llm;
@@ -90,6 +90,7 @@ export declare class CyberSoulClient {
         interactParams?: InteractParams;
     }): Promise<{
         imageUrl: string;
+        imageMediaId?: string;
     }>;
     /**
      * Manually synthesize voice audio outside of chat flow.
@@ -99,12 +100,21 @@ export declare class CyberSoulClient {
         interactParams?: InteractParams;
     }): Promise<{
         audioUrl: string;
+        audioMediaId?: string;
         durationSec?: number;
     }>;
     /**
      * Fetches the current dynamic context and daily state.
      */
     getState(): Promise<CharacterState>;
+    /**
+     * List the public LLM models the backend currently supports, including the
+     * `customConfigDefinition` schema for each model's `customSettings`.
+     *
+     * Use this to discover valid `provider` / `model` strings and the keys
+     * each model accepts via `llmConfig.customSettings`.
+     */
+    listSupportedLLMs(): Promise<SupportedLLMModel[]>;
     /**
      * Updates the character's relationship temperature or mood.
      * Returns the server-authoritative post-write `{ temperature, relationshipStage }`

package/dist/client.js

@@ -224,6 +224,7 @@ export class CyberSoulClient {
 Name: ${state.name}
 Demographics: Age ${state.age || "unknown"}, Gender ${state.gender || "unknown"}, Occupation ${state.occupation || "unknown"}${appearanceStr}
 Hobby: ${state.hobby || "unknown"}
+Backstory: ${state.backstory || "None"}
 Personality Traits: ${state.personality_traits || "None"}
 Communication Style: ${state.communication_style || "None"}
 Interaction Boundaries: ${state.interaction_boundaries || "None"}`);
@@ -669,7 +670,9 @@ Note: Always include "isEndTurn". If "imageParams", "voiceArgs", "triggerEvent",
             // 5. Build Final Media Calls parallel
             const mediaTasks = [];
             let finalImageUrl = undefined;
+            let finalImageMediaId = undefined;
             let finalAudioUrl = undefined;
+            let finalAudioMediaId = undefined;
             let finalDurationSec = undefined;
             // Output Event Trigger
             if (parsedIntent.triggerEvent) {
@@ -703,6 +706,7 @@ Note: Always include "isEndTurn". If "imageParams", "voiceArgs", "triggerEvent",
                 mediaTasks.push(this.generatePrimitive("image", imagePayload)
                     .then((res) => {
                     finalImageUrl = res.image_url;
+                    finalImageMediaId = res.id;
                 })
                     .catch((e) => {
                     console.error("[CyberSoulClient] Image generation failed:", e);
@@ -726,6 +730,7 @@ Note: Always include "isEndTurn". If "imageParams", "voiceArgs", "triggerEvent",
                 })
                     .then((res) => {
                     finalAudioUrl = res.audio_url;
+                    finalAudioMediaId = res.id;
                     finalDurationSec = res.duration_sec;
                 })
                     .catch((e) => {
@@ -746,7 +751,9 @@ Note: Always include "isEndTurn". If "imageParams", "voiceArgs", "triggerEvent",
                 textResponse: resolvedTextResponse || "...",
                 actionText: parsedIntent.actionText || "",
                 imageUrl: finalImageUrl,
+                imageMediaId: finalImageMediaId,
                 audioUrl: finalAudioUrl,
+                audioMediaId: finalAudioMediaId,
                 likePreviousPicture: parsedIntent.likePreviousPicture,
                 durationSec: finalDurationSec,
                 triggeredEvent: parsedIntent.triggerEvent || undefined,
@@ -984,10 +991,12 @@ You MUST output ONLY a valid JSON object matching exactly this structure:
             }
             // Handle Optional Media (Image only for proactive to save compute normally, but you can extend)
             let finalImageUrl = undefined;
+            let finalImageMediaId = undefined;
             if (parsedIntent.imageParams) {
                 try {
                     const res = await this.generatePrimitive("image", parsedIntent.imageParams);
                     finalImageUrl = res.image_url;
+                    finalImageMediaId = res.id;
                 }
                 catch (e) {
                     console.error("[CyberSoulClient] Proactive Image generation failed:", e);
@@ -999,6 +1008,7 @@ You MUST output ONLY a valid JSON object matching exactly this structure:
                 textResponse: parsedIntent.textResponse,
                 actionText: parsedIntent.actionText,
                 imageUrl: finalImageUrl,
+                imageMediaId: finalImageMediaId,
                 stateUpdate: parsedIntent.stateUpdate,
                 persistedDynamicContext,
             };
@@ -1041,6 +1051,7 @@ Output strictly valid JSON ONLY. No markdown, no conversational filler. Return e
         const res = await this.generatePrimitive("image", imageParams);
         return {
             imageUrl: res.image_url,
+            imageMediaId: res.id,
         };
     }
     /**
@@ -1079,6 +1090,7 @@ Output strictly valid JSON ONLY. No markdown, no conversational filler. Return e
         });
         return {
             audioUrl: res.audio_url,
+            audioMediaId: res.id,
             durationSec: res.duration_sec,
         };
     }
@@ -1088,6 +1100,26 @@ Output strictly valid JSON ONLY. No markdown, no conversational filler. Return e
     async getState() {
         return this.fetchRemoteState();
     }
+    /**
+     * List the public LLM models the backend currently supports, including the
+     * `customConfigDefinition` schema for each model's `customSettings`.
+     *
+     * Use this to discover valid `provider` / `model` strings and the keys
+     * each model accepts via `llmConfig.customSettings`.
+     */
+    async listSupportedLLMs() {
+        const res = await this.apiFetch("/api/v1/cyber-soul/llm-models");
+        if (!res.ok) {
+            throw new Error(`Failed to list supported LLMs: ${res.status}`);
+        }
+        const body = (await res.json());
+        if (Array.isArray(body))
+            return body;
+        if (body && typeof body === "object" && Array.isArray(body.data)) {
+            return body.data;
+        }
+        throw new Error("Unexpected response shape from /llm-models");
+    }
     /**
      * Updates the character's relationship temperature or mood.
      * Returns the server-authoritative post-write `{ temperature, relationshipStage }`

package/dist/types.d.ts

@@ -66,7 +66,9 @@ export interface ProactiveResponse {
     textResponse?: string;
     actionText?: string;
     imageUrl?: string;
+    imageMediaId?: string;
     audioUrl?: string;
+    audioMediaId?: string;
     stateUpdate?: DispatcherIntent["stateUpdate"];
     /** Server-authoritative post-write snapshot (see PersistedDynamicContext). */
     persistedDynamicContext?: PersistedDynamicContext;
@@ -116,7 +118,9 @@ export interface InteractResponse {
     textResponse: string;
     actionText?: string;
     imageUrl?: string;
+    imageMediaId?: string;
     audioUrl?: string;
+    audioMediaId?: string;
     likePreviousPicture?: boolean;
     durationSec?: number;
     triggeredEvent?: {
@@ -252,6 +256,7 @@ export interface CharacterState {
     appearance?: string;
     interaction_boundaries?: string;
     communication_style?: string;
+    backstory?: string;
     user_codex?: UserCodex;
 }
 export interface BaseLLMProvider {
@@ -303,6 +308,20 @@ export interface IVoiceModel {
     isPublic: boolean;
     pointsPerGeneration: number;
 }
+/**
+ * Public LLM model entry returned by `GET /api/v1/cyber-soul/llm-models`.
+ *
+ * - `provider` is the value to pass as `llmConfig.provider`.
+ * - `name` is the value to pass as `llmConfig.model`.
+ * - `customConfigDefinition` describes the keys (and their constraints) that
+ *   the model accepts via `llmConfig.customSettings`.
+ */
+export interface SupportedLLMModel {
+    id: string;
+    name: string;
+    provider: string;
+    customConfigDefinition: IModelCustomConfigField[];
+}
 export interface ICharacterProfile {
     id: string;
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@space3-npm/cybersoul-client",
-  "version": "1.4.5",
+  "version": "1.4.8",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",