@umicat/platform-sdk 0.2.0 → 0.2.2

package/dist/ai/AiModule.js

@@ -62,7 +62,23 @@ export class Npc {
         this.history = [];
     }
     async say(playerLine, opts) {
-        this.history.push({ from: 'player', text: playerLine });
+        /**
+         * The conversation this turn BELONGS to, captured before the await.
+         *
+         * `reset()` points `this.history` at a new array. Reading the field again
+         * after the round trip therefore appends this answer to whatever
+         * conversation is current when it lands — so a game that was reset while
+         * an answer was in flight starts its next conversation with the previous
+         * one's last sentence already in the model's context. Invisible to the
+         * player, since the game has moved on and will not display it, and fully
+         * present to the model, which carries on from it.
+         *
+         * Bound here, a turn that outlives its conversation writes into an array
+         * nothing reads again, which is what "forget the conversation" has to
+         * mean for a turn already in the air.
+         */
+        const history = this.history;
+        history.push({ from: 'player', text: playerLine });
         const res = await this.ai.act({
             playbook: this.config.playbook,
             persona: {
@@ -73,10 +89,10 @@ export class Npc {
             },
             actions: this.config.actions,
             observation: opts?.observation,
-            history: this.history,
+            history,
         });
         if (res.ok && res.say)
-            this.history.push({ from: 'npc', text: res.say });
+            history.push({ from: 'npc', text: res.say });
         return res;
     }
     /** Record a world event the NPC should be aware of next turn (no LLM call). */

package/dist/protocol.d.ts

@@ -202,6 +202,20 @@ export interface AiActSuccess {
 export interface AiActFailure {
     ok: false;
     reason: AiReason;
+    /**
+     * The platform's own sentence about why, when it has one worth reading.
+     *
+     * Set by the host for a deliberate 4xx the backend explained — today that
+     * is overwhelmingly `UNAVAILABLE` from a 403 because the game has not
+     * declared the `ai` capability in its Settings. It exists because the
+     * reason codes are for the GAME to branch on, and none of them can tell a
+     * creator what to go and fix.
+     *
+     * Human-readable, English, written by the platform for the person holding
+     * the device — not localized, not a stable identifier, and never something
+     * to branch on. Show it when you have nothing better to say.
+     */
+    detail?: string;
 }
 export type AiActResult = AiActSuccess | AiActFailure;
 export interface AiCompleteParams {
@@ -225,6 +239,8 @@ export interface AiCompleteSuccess {
 export interface AiCompleteFailure {
     ok: false;
     reason: AiReason;
+    /** As `AiActFailure.detail`. */
+    detail?: string;
 }
 export type AiCompleteResult = AiCompleteSuccess | AiCompleteFailure;
 export interface RealtimeGetTokenParams {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umicat/platform-sdk",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Umicat's platform layer, independent of any rendering engine: identity, cloud saves, shared game data, multiplayer, runtime AI, voice and scripted dialogue. Consumed by @umicat/phaser-sdk and @umicat/three-sdk alike.",
   "type": "module",
   "main": "dist/index.js",
@@ -45,4 +45,4 @@
     "type": "git",
     "url": "umicat-platform-sdk"
   }
-}
+}