@space3-npm/cybersoul-client 1.4.26 → 1.4.27

package/dist/client.d.ts

@@ -151,6 +151,12 @@ export declare class CyberSoulClient {
      * snapshot (or `null` if there was nothing to send / the request failed).
      */
     updateDynamicContext(stateUpdate: DispatcherIntent["stateUpdate"], userAnalysis?: DispatcherIntent["userAnalysis"]): Promise<PersistedDynamicContext | null>;
+    /**
+     * Restores the server-side relationship temperature to an exact absolute
+     * value. Used by chat recall, where inverse deltas are not accurate once the
+     * backend has applied dampening, caps, and stage re-evaluation.
+     */
+    restoreDynamicContextTemperature(temperatureAbsolute: number): Promise<PersistedDynamicContext | null>;
     /**
      * Gift a new outfit to the character's wardrobe inventory.
      * Returns the number of wardrobe items the backend created (the

package/dist/client.js

@@ -1519,6 +1519,41 @@ Output strictly valid JSON ONLY. No markdown, no conversational filler. Return e
     async updateDynamicContext(stateUpdate, userAnalysis) {
         return this._updateDynamicContextInternal(stateUpdate, userAnalysis);
     }
+    /**
+     * Restores the server-side relationship temperature to an exact absolute
+     * value. Used by chat recall, where inverse deltas are not accurate once the
+     * backend has applied dampening, caps, and stage re-evaluation.
+     */
+    async restoreDynamicContextTemperature(temperatureAbsolute) {
+        if (!Number.isFinite(temperatureAbsolute))
+            return null;
+        const normalizedAbsolute = Math.max(0, Math.min(100, Math.round(temperatureAbsolute * 10) / 10));
+        try {
+            const res = await this.apiFetch("/api/v1/cyber-soul/characters/dynamic-context", {
+                method: "PATCH",
+                body: JSON.stringify({ temperatureAbsolute: normalizedAbsolute }),
+            });
+            if (!res.ok)
+                return null;
+            const payload = (await res.json());
+            if (payload?.status !== "success")
+                return null;
+            if (typeof payload.dynamicContext?.temperature !== "number")
+                return null;
+            if (!Number.isFinite(payload.dynamicContext.temperature))
+                return null;
+            return {
+                temperature: payload.dynamicContext.temperature,
+                relationshipStage: typeof payload.relationshipStage === "string"
+                    ? payload.relationshipStage
+                    : undefined,
+            };
+        }
+        catch (e) {
+            console.error("restoreDynamicContextTemperature failed", e);
+            return null;
+        }
+    }
     /**
      * Gift a new outfit to the character's wardrobe inventory.
      * Returns the number of wardrobe items the backend created (the

package/package.json

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