@theoremjs/web 0.3.4-next.375.ga2d1878 → 0.3.4-next.379.gf91c8b4

package/README.md

@@ -176,7 +176,7 @@ await chat.submit();
 ```
 
 - `getState()` returns a `ChatState`. It is a new object after each change, and the same object between changes. So you can compare it by reference, as React's `useSyncExternalStore` does.
-- `subscribe(listener)` calls the listener once for each group of changes, after the code that made them has run. It returns the function that unsubscribes.
+- `subscribe(listener)` calls the listener once for each group of changes, after the code that made them has run. It returns the function that unsubscribes. Until the first subscribe or send, the chat asks nothing of the host. Then it reads a resumed conversation that came without its `conversationView`, and answers a restored page gate as unanswered.
 - `update(options)` gives the controller your latest options, such as a new `context`, `slots`, or `pageTools`. Each turn reads the options as they are when it is sent. `conversation`, `conversationView`, and `initialText` are read only when the controller is created.
 - Each method is bound to the controller. Pass it as a callback as it is.
 

package/client/chat.d.ts

@@ -28,8 +28,8 @@ export type ChatOptions = {
     onConversationChange?: (ref: string) => void;
     /**
      * The value chosen for each of the profile's `inputs.slots`. Sent with every turn. A slot you
-     * name here is fixed to that value; one you leave out is chosen with `pickSlot`, starting at
-     * its first allowed value.
+     * name here is fixed to that value; one you leave out is the visitor's to pick (the chat's
+     * `pickSlot`), starting at its first allowed value.
      */
     slots?: Record<string, string>;
     /** Told each time the visitor picks a slot, with every slot's value. */
@@ -94,7 +94,11 @@ export type ChatUpdate<T> = T | ((prev: T) => T);
  */
 export type ChatController = {
     getState(): ChatState;
-    /** Called after each change, once per batch of changes. Returns the unsubscribe. */
+    /**
+     * Called after each change, once per batch of changes. Returns the unsubscribe. Until the first
+     * subscribe or send, the chat asks nothing of the host: a conversation resumed without its
+     * `conversationView` is read then, and a restored page gate answered then.
+     */
     subscribe(listener: () => void): () => void;
     /** The latest options. `conversation`, `conversationView` and `initialText` are read only at creation. */
     update(options: ChatOptions): void;

package/client/chat.js

@@ -91,6 +91,8 @@ class Chat {
     #delivery = null;
     #picked = {};
     #resumed = false;
+    // why: A chat no one uses yet (one React's strict mode builds and drops) asks nothing of the host.
+    #live = false;
     #defaultsFrom;
     #answeredPage = null;
     #pageToolsWarned;
@@ -124,6 +126,10 @@ class Chat {
     getState = () => this.#state;
     subscribe = (listener) => {
         this.#listeners.add(listener);
+        if (!this.#live) {
+            this.#live = true;
+            this.#settle();
+        }
         return () => this.#listeners.delete(listener);
     };
     update = (options) => {
@@ -377,11 +383,13 @@ class Chat {
     #resume(iface) {
         if (this.#resumed)
             return;
-        this.#resumed = true;
         const ref = this.#conversation;
+        const shown = this.#options.conversationView;
+        if (ref !== undefined && !shown && !this.#live)
+            return;
+        this.#resumed = true;
         if (ref === undefined || !keepsConversation(iface))
             return;
-        const shown = this.#options.conversationView;
         if (shown) {
             this.#draw(shown, this.#state.session, []);
             return;
@@ -399,6 +407,8 @@ class Chat {
      * invariant: A restored page gate cannot authorize callback execution. Only active dispatch grants do.
      */
     #answerPageGate() {
+        if (!this.#live)
+            return;
         const gated = this.#state.phase === 'gated' ? this.#state.session.gatedTool : null;
         if (gated?.gateKind !== 'page' || !gated.operationId)
             return;
@@ -613,6 +623,7 @@ class Chat {
         const { iface } = this.#options;
         if (!iface || this.#busy)
             return;
+        this.#live = true;
         const { message } = options;
         const priorDelivery = this.#delivery;
         const abort = options.turn ? new AbortController() : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theoremjs/web",
-  "version": "0.3.4-next.375.ga2d1878",
+  "version": "0.3.4-next.379.gf91c8b4",
   "description": "Theorem on the web platform, with no UI framework: Web-standard server handlers that serve a profile, and the browser client that talks to them.",
   "license": "MIT",
   "type": "module",
@@ -25,6 +25,6 @@
   },
   "peerDependencies": {
     "zod": "^4.6.5",
-    "@theoremjs/agents": "^0.3.4-next.375.ga2d1878"
+    "@theoremjs/agents": "^0.3.4-next.379.gf91c8b4"
   }
 }