@vinaverse/client 0.1.0-alpha.11 → 0.1.0-alpha.12

package/README.md

@@ -183,7 +183,9 @@ against the session it was given in; a reply restored from the device or a resum
 `{ screen: 'other' }`, no entity); revisions only grow across a conversation's sessions (`placeRevision` on the
 session request), a `context_conflict` (409, with `current_revision`) sends the newest place once more above it, only while the session
 and the person are the same, then says `moved`,
-and a telling lands only on the session it was told to. `onEvent` also says `message_sent`, `reply_completed` and
+and a telling lands only on the session it was told to. One update is in flight per conversation: a place told meanwhile
+(`show` and `tell` in one move, rapid moves) waits, only the newest, and goes next; a refusal that is no conflict is said
+through `onWarning` (`context_refused`) in development builds. `onEvent` also says `message_sent`, `reply_completed` and
 `card_shown` (never the words), its `key` is a salted SHA-256 hash of the conversation's key (`hashKey`), never the person's id: stable per install
 (the salt is kept at `<persistenceKey>:salt` in your storage, a new one after `erase()`), and
 `session_opened` says where the chat was opened from (`entryPoint`: `launcher`, `ask`, `deep_link`, or your own).

package/dist/agent/index.cjs

@@ -2590,6 +2590,7 @@ var samePlace = (a, b) => a?.screen === b?.screen && (a?.entity?.type ?? null) =
 function usable(session, insecure) {
   return typeof session.id === "string" && session.id !== "" && (insecure.realtime === true || /^wss:\/\//i.test(session.realtime_url ?? "")) && (insecure.turns === true || /^https:\/\//i.test(session.turns_url ?? "")) && Boolean(session.client_secret);
 }
+var devBuild = () => globalThis.__DEV__ === true;
 function warnInsecure(insecure, warn) {
   if (!(insecure.realtime || insecure.turns)) return;
   if (globalThis.__DEV__ === true) return;
@@ -2908,6 +2909,8 @@ function createAgentRuntime(options) {
       place: null,
       told: null,
       revision: 0,
+      telling: false,
+      queued: false,
       entryPoint: null,
       expiresAt: null,
       shown: 0,
@@ -2942,26 +2945,55 @@ function createAgentRuntime(options) {
     update(entry, { moved });
     const updateContext = backend.updateContext?.bind(backend);
     if (!moved || !updateContext || sessionId === null) return;
+    if (entry.telling) {
+      entry.queued = true;
+      return;
+    }
+    entry.telling = true;
     const asked = generation;
     const current2 = () => asked === generation && live.get(entry.key) === entry && entry.state.sessionId === sessionId;
+    const settle = () => {
+      entry.telling = false;
+      if (!entry.queued) return;
+      entry.queued = false;
+      if (asked === generation && live.get(entry.key) === entry)
+        tell(entry, {});
+    };
     const send = (again) => {
       const place = entry.place;
       const revision = ++entry.revision;
-      updateContext(sessionId, place ?? CLEARED, revision).then(
+      let told;
+      try {
+        told = updateContext(sessionId, place ?? CLEARED, revision);
+      } catch (error) {
+        told = Promise.reject(error);
+      }
+      told.then(
         () => {
-          if (!current2() || entry.revision !== revision) return;
-          entry.told = place;
-          update(entry, { moved: !samePlace(entry.told, entry.place) });
-          emit({ type: "context_updated", key: entry.key, sessionId });
+          if (current2() && entry.revision === revision) {
+            entry.told = place;
+            update(entry, { moved: !samePlace(entry.told, entry.place) });
+            emit({ type: "context_updated", key: entry.key, sessionId });
+          }
+          settle();
         },
         (error) => {
           const theirs = field(error, "currentRevision");
           const conflict = field(error, "outcome") === "context_conflict" || field(error, "reason") === "conflict";
-          if (!conflict || again || !current2() || entry.revision !== revision)
+          if (conflict && !again && current2() && entry.revision === revision) {
+            if (typeof theirs === "number" && theirs >= entry.revision)
+              entry.revision = theirs;
+            send(true);
             return;
-          if (typeof theirs === "number" && theirs >= entry.revision)
-            entry.revision = theirs;
-          send(true);
+          }
+          if (!conflict && devBuild()) {
+            const status2 = field(error, "status");
+            warn(
+              `@vinaverse/client/agent: updateContext was refused${typeof status2 === "number" ? ` (${status2})` : ""}: ${error instanceof Error ? error.message : String(error)}. The new place is offered as a question instead.`,
+              { code: "context_refused" }
+            );
+          }
+          settle();
         }
       );
     };