@vinaverse/client 0.1.0-alpha.7 → 0.1.0-alpha.9

package/README.md

@@ -128,7 +128,9 @@ History's "Continue" is `continue(key, conversationId)`: the key goes on with th
 is said as `ended` (your backend throws `AgentRefusal('ended', { code })` on a 404 or 410). A session must have an id
 and a secret, and `wss://` and `https://` addresses whatever transport you supply (a wrapper adding headers or logging
 still gets only secure ones). `insecureAddresses: { realtime, turns }` allows plaintext for one leg: dangerous, for mocks
-and local development only, and the runtime warns outside `__DEV__` (through `onWarning`, your logger, else `console.warn`).
+and local development only, and the runtime warns outside `__DEV__` (through `onWarning(message, { code })`, your
+logger, else `console.warn`; `code` is `insecure_addresses`, `callback_threw` with the `callback` that threw, or
+`events_dropped`).
 A UI binding reads the key's conversation with `peek(key)`, which ends nothing (a render must not): one past its
 session's end is ended when it is next shown, and `subscribe` then tells the binding to read the next one. One no view
 shows ends at its session's end while the app's timers run, and on `sweep()` (the React Native parts call it when the

package/dist/agent/index.cjs

@@ -2594,7 +2594,8 @@ function warnInsecure(insecure, warn) {
   if (!(insecure.realtime || insecure.turns)) return;
   if (globalThis.__DEV__ === true) return;
   warn(
-    "@vinaverse/client/agent: insecureAddresses lets sessions use plaintext ws:// or http:// addresses. For mocks and local development only."
+    "@vinaverse/client/agent: insecureAddresses lets sessions use plaintext ws:// or http:// addresses. For mocks and local development only.",
+    { code: "insecure_addresses" }
   );
 }
 var OPEN_KEPT_MS = 24 * 36e5;
@@ -2615,6 +2616,16 @@ function createAgentRuntime(options) {
   const listeners = /* @__PURE__ */ new Set();
   let status = null;
   let reading = null;
+  const NO_STATUS = {
+    status: null,
+    reading: false,
+    failed: false
+  };
+  let statusState = NO_STATUS;
+  const setStatusState = (next) => {
+    statusState = { status: status?.value ?? null, ...next };
+    changed();
+  };
   let sessionName = null;
   let generation = 0;
   const keyOf = (key) => agentKey(key, options.agent ?? null);
@@ -2635,7 +2646,8 @@ function createAgentRuntime(options) {
       call();
     } catch (error) {
       warn(
-        `@vinaverse/client/agent: the app's ${what} threw (${error instanceof Error ? error.message : String(error)}); the conversation went on.`
+        `@vinaverse/client/agent: the app's ${what} threw (${error instanceof Error ? error.message : String(error)}); the conversation went on.`,
+        { code: "callback_threw", callback: what }
       );
     }
   };
@@ -2678,7 +2690,8 @@ function createAgentRuntime(options) {
       waiting.shift();
       if (!dropping)
         warn(
-          "@vinaverse/client/agent: the analytics salt is still being read from storage; the oldest events are dropped."
+          "@vinaverse/client/agent: the analytics salt is still being read from storage; the oldest events are dropped.",
+          { code: "events_dropped" }
         );
       dropping = true;
     }
@@ -2792,6 +2805,7 @@ function createAgentRuntime(options) {
     sessionName = null;
     status = null;
     reading = null;
+    statusState = NO_STATUS;
     changed();
     const pairs = [];
     await Promise.all([
@@ -3095,18 +3109,23 @@ function createAgentRuntime(options) {
           if (asked !== generation) return value;
           reading = null;
           status = { value, at: clock.now() };
-          changed();
+          setStatusState({ reading: false, failed: false });
           return value;
         },
         (error) => {
-          if (asked === generation) reading = null;
+          if (asked === generation) {
+            reading = null;
+            setStatusState({ reading: false, failed: true });
+          }
           throw error;
         }
       );
       reading = read;
+      setStatusState({ reading: true, failed: statusState.failed });
       return read;
     },
     getStatus: () => status?.value ?? null,
+    getStatusState: () => statusState,
     getName: () => sessionName ?? status?.value.displayName ?? null,
     subscribe(listener) {
       listeners.add(listener);