@umicat/platform-sdk 0.2.0 → 0.2.1

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.1",
   "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"
   }
-}
+}