@meshagent/meshagent-ts-auth 0.47.0 → 0.47.1

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+## [0.47.1]
+- Added duplex messaging stream subscriptions and replay-state alignment in the TypeScript chat clients, bringing the NodeJS SDK in line with the new streaming model.
+- Reworked messaging and room client flow control so dispatch ordering, close behavior, and presence updates stay consistent under streaming loads.
+- Expanded stream and presence test coverage for the new messaging behavior.
+
 ## [0.47.0]
 - Improved TypeScript messaging clients so room delivery order and startup/presence behavior stay consistent.
 - Moved managed-agent client routing onto the Rust tunnel path and hardened agent chat-client event handling.

package/dist/browser/ma-auth.global.js

@@ -14693,10 +14693,10 @@ ${err.toString()}`);
             return false;
           }
         }
-        async _sendToolCallResponseChunk(messageId, toolCallId, chunk) {
+        _sendToolCallResponseChunk(messageId, toolCallId, chunk) {
           const [header, payload] = (0, utils_js_1.unpackMessage)(chunk.pack());
           try {
-            await this.client.protocol.send("room.tool_call_response_chunk", (0, utils_js_1.packMessage)({ tool_call_id: toolCallId, chunk: header }, payload.length > 0 ? payload : void 0), { id: messageId });
+            this.client.protocol.sendNowait("room.tool_call_response_chunk", (0, utils_js_1.packMessage)({ tool_call_id: toolCallId, chunk: header }, payload.length > 0 ? payload : void 0), { id: messageId });
             return true;
           } catch (error) {
             console.debug("unable to send tool call response chunk", error);
@@ -14792,10 +14792,10 @@ ${err.toString()}`);
                 return;
               for await (const chunk of output.stream) {
                 this.toolkit.validateOutputContent(tool, chunk);
-                if (!await this._sendToolCallResponseChunk(messageId, toolCallId, chunk))
+                if (!this._sendToolCallResponseChunk(messageId, toolCallId, chunk))
                   return;
               }
-              await this._sendToolCallResponseChunk(messageId, toolCallId, new response_js_1.ControlContent({ method: "close" }));
+              this._sendToolCallResponseChunk(messageId, toolCallId, new response_js_1.ControlContent({ method: "close" }));
               return;
             }
             throw new Error(`tool ${toolName} returned unsupported output`);
@@ -14805,9 +14805,9 @@ ${err.toString()}`);
               return;
             }
             if (!(error instanceof InvalidToolDataException)) {
-              await this._sendToolCallResponseChunk(messageId, toolCallId, new response_js_1.ErrorContent({ text: String(error) }));
+              this._sendToolCallResponseChunk(messageId, toolCallId, new response_js_1.ErrorContent({ text: String(error) }));
             }
-            await this._sendToolCallResponseChunk(messageId, toolCallId, new response_js_1.ControlContent({
+            this._sendToolCallResponseChunk(messageId, toolCallId, new response_js_1.ControlContent({
               method: "close",
               statusCode: error instanceof InvalidToolDataException ? response_js_1.ControlCloseStatus.INVALID_DATA : void 0,
               message: error instanceof InvalidToolDataException ? error.message : void 0
@@ -42002,6 +42002,9 @@ ${newlined}
         addRoomGrant(roomName) {
           this.grants.push(new ParticipantGrant({ name: "room", scope: roomName }));
         }
+        addSiteGrant(roomName) {
+          this.grants.push(new ParticipantGrant({ name: "site", scope: roomName }));
+        }
         addApiGrant(grant) {
           for (const existingGrant of this.grants) {
             if (existingGrant.name === "api") {
@@ -43496,7 +43499,7 @@ ${newlined}
           }
           const parsedResource = this.parseAccessResource(data.resource);
           const parsedSubject = this.parseAccessSubject(data.subject);
-          const parsedDirectRoles = Array.isArray(data.direct_roles) ? data.direct_roles.filter((item) => item === "member" || item === "viewer" || item === "operator" || item === "developer" || item === "admin" || item === "room_creator" || item === "room_inventory" || item === "room_manager" || item === "session_inventory" || item === "agent_creator" || item === "agent_inventory" || item === "agent_manager" || item === "repository_creator" || item === "repository_inventory" || item === "repository_manager" || item === "feed_creator" || item === "feed_inventory" || item === "feed_manager" || item === "oauth_client_creator" || item === "oauth_client_inventory" || item === "oauth_client_manager" || item === "api_key_creator" || item === "api_key_inventory" || item === "api_key_manager" || item === "service_creator" || item === "service_inventory" || item === "service_manager" || item === "service_account_creator" || item === "service_account_inventory" || item === "service_account_manager" || item === "participant_token_creator" || item === "mailbox_creator" || item === "mailbox_inventory" || item === "mailbox_manager" || item === "route_creator" || item === "route_inventory" || item === "route_manager" || item === "scheduled_task_creator" || item === "scheduled_task_inventory" || item === "scheduled_task_manager" || item === "feed_subscription_creator" || item === "feed_subscription_inventory" || item === "feed_subscription_manager" || item === "llm_logger_creator" || item === "llm_logger_inventory" || item === "llm_logger_manager" || item === "llm_proxy_user" || item === "usage_reporter" || item === "billing_manager" || item === "group_manager" || item === "reader" || item === "subscriber" || item === "publisher" || item === "manager" || item === "list") : [];
+          const parsedDirectRoles = Array.isArray(data.direct_roles) ? data.direct_roles.filter((item) => item === "member" || item === "site_user" || item === "viewer" || item === "operator" || item === "developer" || item === "admin" || item === "room_creator" || item === "room_inventory" || item === "room_manager" || item === "session_inventory" || item === "agent_creator" || item === "agent_inventory" || item === "agent_manager" || item === "repository_creator" || item === "repository_inventory" || item === "repository_manager" || item === "feed_creator" || item === "feed_inventory" || item === "feed_manager" || item === "oauth_client_creator" || item === "oauth_client_inventory" || item === "oauth_client_manager" || item === "api_key_creator" || item === "api_key_inventory" || item === "api_key_manager" || item === "service_creator" || item === "service_inventory" || item === "service_manager" || item === "service_account_creator" || item === "service_account_inventory" || item === "service_account_manager" || item === "participant_token_creator" || item === "mailbox_creator" || item === "mailbox_inventory" || item === "mailbox_manager" || item === "route_creator" || item === "route_inventory" || item === "route_manager" || item === "scheduled_task_creator" || item === "scheduled_task_inventory" || item === "scheduled_task_manager" || item === "feed_subscription_creator" || item === "feed_subscription_inventory" || item === "feed_subscription_manager" || item === "llm_logger_creator" || item === "llm_logger_inventory" || item === "llm_logger_manager" || item === "llm_proxy_user" || item === "usage_reporter" || item === "billing_manager" || item === "group_manager" || item === "reader" || item === "subscriber" || item === "publisher" || item === "manager" || item === "list") : [];
           const room = {
             id: parsedResource.id,
             name: parsedResource.name ?? parsedResource.id,
@@ -44899,7 +44902,7 @@ ${newlined}
     "../meshagent-ts/dist/browser/messaging-client.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
-      exports.MessagingClient = void 0;
+      exports.MessagingClient = exports.MessagingStream = void 0;
       var completer_js_1 = require_completer();
       var event_emitter_js_1 = require_event_emitter();
       var participant_js_1 = require_participant();
@@ -44921,6 +44924,247 @@ ${newlined}
         }
         return globalScope.btoa(binary);
       }
+      function base64ToBytes(value) {
+        if (globalScope.Buffer != null) {
+          return new Uint8Array(globalScope.Buffer.from(value, "base64"));
+        }
+        const atob2 = globalThis.atob;
+        if (atob2 == null) {
+          throw new Error("base64 decoding is not available in this runtime");
+        }
+        const binary = atob2(value);
+        return Uint8Array.from(binary, (character) => character.charCodeAt(0));
+      }
+      var MessagingStreamInput = class {
+        constructor() {
+          this.items = [];
+          this.signal = null;
+          this.active = null;
+          this.closed = false;
+          this.error = null;
+        }
+        enqueue(content, { wait = false } = {}) {
+          if (this.closed) {
+            return Promise.reject(this.error ?? new room_server_client_js_1.RoomServerException("the messaging stream is closed"));
+          }
+          const sent = wait ? new completer_js_1.Completer() : void 0;
+          this.items.push({ content, sent });
+          this.signal?.resolve();
+          this.signal = null;
+          return sent?.fut ?? Promise.resolve();
+        }
+        close(error = new room_server_client_js_1.RoomServerException("the messaging stream is closed")) {
+          if (this.closed) {
+            return;
+          }
+          this.closed = true;
+          this.error = error;
+          this.active?.sent?.reject(error);
+          this.active = null;
+          for (const item of this.items.splice(0)) {
+            item.sent?.reject(error);
+          }
+          this.signal?.resolve();
+          this.signal = null;
+        }
+        fail(error) {
+          this.close(error);
+        }
+        async *stream() {
+          try {
+            while (true) {
+              while (this.items.length === 0 && !this.closed) {
+                this.signal ?? (this.signal = new completer_js_1.Completer());
+                await this.signal.fut;
+              }
+              const item = this.items.shift();
+              if (item == null) {
+                return;
+              }
+              this.active = item;
+              yield item.content;
+              item.sent?.resolve();
+              this.active = null;
+            }
+          } finally {
+            if (this.active != null && this.closed) {
+              this.active.sent?.reject(this.error ?? new room_server_client_js_1.RoomServerException("the messaging stream is closed"));
+              this.active = null;
+            }
+          }
+        }
+      };
+      var MessagingStream = class {
+        constructor({ streamId, remoteParticipantId, input, output, inputClosed, onClosed }) {
+          this.events = [];
+          this.eventSignal = null;
+          this.state = "accepted";
+          this.streamId = streamId;
+          this.remoteParticipantId = remoteParticipantId;
+          this.input = input;
+          this.output = output;
+          this.inputDone = Promise.resolve(inputClosed).catch((error) => {
+            this.input.fail(error);
+            this.push({
+              kind: "closed",
+              streamId: this.streamId,
+              reason: "error",
+              message: error instanceof Error ? error.message : String(error)
+            });
+            void this.output.return?.();
+            this.finish();
+          });
+          this.onClosed = onClosed;
+          void this.consumeOutput();
+        }
+        get closed() {
+          return this.state === "terminal";
+        }
+        push(event) {
+          if (this.state !== "accepted") {
+            return;
+          }
+          this.events.push(event);
+          this.eventSignal?.resolve();
+          this.eventSignal = null;
+        }
+        finish() {
+          if (this.state === "terminal") {
+            return;
+          }
+          this.state = "terminal";
+          this.input.close();
+          this.eventSignal?.resolve();
+          this.eventSignal = null;
+          void this.inputDone.finally(this.onClosed);
+        }
+        async consumeOutput() {
+          try {
+            while (true) {
+              const next = await this.output.next();
+              if (next.done) {
+                return;
+              }
+              if (next.value instanceof response_js_1.ControlContent && next.value.method === "close") {
+                this.push({
+                  kind: "client_disconnected",
+                  streamId: this.streamId,
+                  participantId: this.remoteParticipantId
+                });
+                return;
+              }
+              if (!(next.value instanceof response_js_1.JsonContent)) {
+                throw new room_server_client_js_1.RoomServerException("unexpected chunk from messaging.stream");
+              }
+              const value = next.value.json;
+              const kind = value["kind"];
+              if (kind === "message") {
+                const type = value["type"];
+                const message2 = value["message"];
+                if (typeof type !== "string" || typeof message2 !== "object" || message2 == null || Array.isArray(message2)) {
+                  throw new room_server_client_js_1.RoomServerException("invalid message chunk from messaging.stream");
+                }
+                const encodedAttachment = value["attachment_base64"];
+                this.push({
+                  kind: "message",
+                  message: new room_event_js_1.RoomMessage({
+                    fromParticipantId: this.remoteParticipantId,
+                    type,
+                    message: message2,
+                    attachment: typeof encodedAttachment === "string" && encodedAttachment !== "" ? base64ToBytes(encodedAttachment) : void 0
+                  })
+                });
+              } else if (kind === "client_disconnected" && typeof value["participant_id"] === "string") {
+                this.push({
+                  kind,
+                  streamId: this.streamId,
+                  participantId: value["participant_id"]
+                });
+                return;
+              } else if (kind === "closed") {
+                this.push({
+                  kind,
+                  streamId: this.streamId,
+                  reason: typeof value["reason"] === "string" ? value["reason"] : "closed",
+                  message: typeof value["message"] === "string" ? value["message"] : void 0
+                });
+                return;
+              } else {
+                throw new room_server_client_js_1.RoomServerException("unexpected chunk from messaging.stream");
+              }
+            }
+          } catch (error) {
+            this.input.fail(error);
+            this.push({
+              kind: "closed",
+              streamId: this.streamId,
+              reason: "error",
+              message: error instanceof Error ? error.message : String(error)
+            });
+          } finally {
+            this.finish();
+          }
+        }
+        content({ type, message: message2, attachment }) {
+          return new response_js_1.JsonContent({
+            json: {
+              type,
+              message_json: JSON.stringify(message2),
+              ...attachment == null ? {} : { attachment_base64: bytesToBase64(attachment) }
+            }
+          });
+        }
+        sendMessageNowait(params) {
+          if (this.state !== "accepted") {
+            throw new room_server_client_js_1.RoomServerException("the messaging stream is closed");
+          }
+          void this.input.enqueue(this.content(params));
+        }
+        async sendMessage(params) {
+          if (this.state !== "accepted") {
+            throw new room_server_client_js_1.RoomServerException("the messaging stream is closed");
+          }
+          await this.input.enqueue(this.content(params), { wait: true });
+        }
+        async close() {
+          if (this.state === "terminal") {
+            await this.inputDone;
+            return;
+          }
+          this.input.close();
+          try {
+            await this.inputDone;
+          } finally {
+            await this.output.return?.();
+            this.finish();
+          }
+        }
+        clientDisconnected(participantId) {
+          if (this.state === "terminal") {
+            return;
+          }
+          this.push({
+            kind: "client_disconnected",
+            streamId: this.streamId,
+            participantId
+          });
+          this.finish();
+        }
+        async *[Symbol.asyncIterator]() {
+          while (true) {
+            while (this.events.length === 0 && this.state !== "terminal") {
+              this.eventSignal ?? (this.eventSignal = new completer_js_1.Completer());
+              await this.eventSignal.fut;
+            }
+            const event = this.events.shift();
+            if (event == null) {
+              return;
+            }
+            yield event;
+          }
+        }
+      };
+      exports.MessagingStream = MessagingStream;
       var MessagingClient = class extends event_emitter_js_1.EventEmitter {
         constructor({ room }) {
           super();
@@ -44930,6 +45174,7 @@ ${newlined}
           this._messageQueued = null;
           this._sendTask = null;
           this._sendOperations = /* @__PURE__ */ new Set();
+          this._streams = /* @__PURE__ */ new Set();
           this._messageQueueClosed = false;
           this._desiredEnabled = false;
           this._online = false;
@@ -44995,6 +45240,7 @@ ${newlined}
             await sendTask;
           }
           await Promise.all(this._sendOperations);
+          await Promise.all([...this._streams].map(async (stream) => stream.close()));
           this._desiredEnabled = false;
           this._clearCurrentConnectionState();
         }
@@ -45058,6 +45304,9 @@ ${newlined}
           }
         }
         _onRoomDisconnect({ reason: _reason }) {
+          for (const stream of [...this._streams]) {
+            stream.clientDisconnected(this.client.localParticipant?.id ?? stream.remoteParticipantId);
+          }
           this._clearCurrentConnectionState();
         }
         _onRoomReconnect() {
@@ -45246,6 +45495,46 @@ ${newlined}
             throw error;
           }
         }
+        async stream({ to, type, message: message2, attachment }) {
+          const input = new MessagingStreamInput();
+          void input.enqueue(new response_js_1.JsonContent({
+            json: {
+              to_participant_id: to.id,
+              type,
+              message_json: JSON.stringify(message2),
+              ...attachment == null ? {} : { attachment_base64: bytesToBase64(attachment) }
+            }
+          }));
+          const outputResult = await this.client.invokeToolCall({
+            toolkit: "messaging",
+            tool: "stream",
+            input: input.stream(),
+            streamInput: true
+          });
+          if (outputResult.kind !== "stream") {
+            input.close();
+            throw new room_server_client_js_1.RoomServerException("unexpected return type from messaging.stream");
+          }
+          const outputIterable = outputResult.stream;
+          const output = outputIterable[Symbol.asyncIterator]();
+          const accepted = await output.next();
+          if (accepted.done || !(accepted.value instanceof response_js_1.JsonContent) || accepted.value.json["kind"] !== "accepted" || typeof accepted.value.json["stream_id"] !== "string") {
+            input.close();
+            await output.return?.();
+            throw new room_server_client_js_1.RoomServerException("messaging.stream did not acknowledge acceptance");
+          }
+          let stream;
+          stream = new MessagingStream({
+            streamId: accepted.value.json["stream_id"],
+            remoteParticipantId: to.id,
+            input,
+            output,
+            inputClosed: outputResult.inputClosed,
+            onClosed: () => this._streams.delete(stream)
+          });
+          this._streams.add(stream);
+          return stream;
+        }
         getParticipants() {
           return this.remoteParticipants;
         }
@@ -45339,6 +45628,9 @@ ${newlined}
           this._wakeMessageQueue();
           this._drainQueuedMessages({ error });
           this._desiredEnabled = false;
+          for (const stream of [...this._streams]) {
+            stream.clientDisconnected(this.client.localParticipant?.id ?? stream.remoteParticipantId);
+          }
           this._clearCurrentConnectionState();
           this.client.protocol.removeHandler("messaging.send", this._messageHandler);
           super.dispose();
@@ -48913,6 +49205,11 @@ ${newlined}
           this._sendLocalAttributesNowait(attributes);
         }
         async sendRequest(type, request, data, afterSend) {
+          const response = this._dispatchRequest(type, request, data);
+          afterSend?.();
+          return await response;
+        }
+        _dispatchRequest(type, request, data) {
           this._raiseIfTerminal();
           if (this._entered && !this._connected && !this._allowDisconnectedRequests) {
             throw this._disconnectedError({ baseMessage: "room connection is disconnected" });
@@ -48921,9 +49218,8 @@ ${newlined}
           const completer = new completer_js_1.Completer();
           this._pendingRequests.set(requestId, completer);
           try {
-            await this._protocolInstance.send(type, (0, utils_js_1.packMessage)(request, data), requestId);
-            afterSend?.();
-            return await completer.fut;
+            this._protocolInstance.sendNowait(type, (0, utils_js_1.packMessage)(request, data), { id: requestId });
+            return completer.fut;
           } catch (error) {
             this._pendingRequests.delete(requestId);
             throw error;
@@ -49022,7 +49318,6 @@ ${newlined}
           let requestTask;
           if (params.streamInput === true) {
             request["arguments"] = { type: "control", method: "open" };
-            requestTask = this._streamInvokeToolRequestChunks(toolCallId, params.input);
           } else {
             const input = params.input;
             const packed = input.pack();
@@ -49038,9 +49333,14 @@ ${newlined}
           if (params.onBehalfOfId != null) {
             request["on_behalf_of_id"] = params.onBehalfOfId;
           }
+          const responseRequest = this._dispatchRequest("room.invoke_tool", request, requestData);
+          params.afterSend?.();
+          if (params.streamInput === true) {
+            requestTask = this._streamInvokeToolRequestChunks(toolCallId, params.input);
+          }
           try {
             const response = await Promise.race([
-              this.sendRequest("room.invoke_tool", request, requestData, params.afterSend),
+              responseRequest,
               preOpenError.fut
             ]);
             this._toolCallPreOpenErrors.delete(toolCallId);
@@ -49094,9 +49394,10 @@ ${newlined}
           if (params.onBehalfOfId != null) {
             request["on_behalf_of_id"] = params.onBehalfOfId;
           }
+          const responseRequest = this._dispatchRequest("room.invoke_tool", request);
           const requestTask = this._streamInvokeToolRequestChunks(toolCallId, params.input);
           try {
-            const response = await this.sendRequest("room.invoke_tool", request);
+            const response = await responseRequest;
             await requestTask;
             if (response instanceof response_js_1.ControlContent && response.method === "open") {
               throw new room_server_client_js_1.RoomServerException(`unexpected return type from ${params.toolkit}.${params.tool}`);
@@ -49126,6 +49427,7 @@ ${newlined}
           if (params.onBehalfOfId != null) {
             request["on_behalf_of_id"] = params.onBehalfOfId;
           }
+          const responseRequest = this._dispatchRequest("room.invoke_tool", request);
           const requestTask = this._streamInvokeToolRequestChunks(toolCallId, params.input);
           void requestTask.catch((error) => {
             const stream = this._toolCallStreams.get(toolCallId);
@@ -49139,7 +49441,7 @@ ${newlined}
           let response;
           try {
             response = await Promise.race([
-              this.sendRequest("room.invoke_tool", request),
+              responseRequest,
               preOpenError.fut
             ]);
           } catch (error) {
@@ -49160,23 +49462,26 @@ ${newlined}
             }
           };
         }
-        async _sendToolCallRequestChunk(toolCallId, chunk) {
+        _dispatchToolCallRequestChunk(toolCallId, chunk) {
+          this._raiseIfTerminal();
+          if (this._entered && !this._connected && !this._allowDisconnectedRequests) {
+            throw this._disconnectedError({ baseMessage: "room connection is disconnected" });
+          }
           const packed = chunk.pack();
           const request = {
             tool_call_id: toolCallId,
             chunk: JSON.parse((0, utils_js_1.splitMessageHeader)(packed))
           };
           const payload = (0, utils_js_1.splitMessagePayload)(packed);
-          await this.sendRequest("room.tool_call_request_chunk", request, payload.length > 0 ? payload : void 0);
+          this._protocolInstance.sendNowait("room.tool_call_request_chunk", (0, utils_js_1.packMessage)(request, payload.length > 0 ? payload : void 0));
         }
         async _streamInvokeToolRequestChunks(toolCallId, input) {
-          await Promise.resolve();
           try {
             for await (const item of input) {
-              await this._sendToolCallRequestChunk(toolCallId, item);
+              this._dispatchToolCallRequestChunk(toolCallId, item);
             }
           } finally {
-            await this._sendToolCallRequestChunk(toolCallId, new response_js_1.ControlContent({ method: "close" }));
+            this._dispatchToolCallRequestChunk(toolCallId, new response_js_1.ControlContent({ method: "close" }));
           }
         }
         _decodeToolCallContent(params) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@meshagent/meshagent-ts-auth",
-    "version": "0.47.0",
+    "version": "0.47.1",
     "description": "Meshagent Typescript Auth",
     "homepage": "https://github.com/meshagent/meshagent-ts-auth",
     "scripts": {
@@ -39,7 +39,7 @@
         "CHANGELOG.md"
     ],
     "dependencies": {
-        "@meshagent/meshagent": "^0.47.0",
+        "@meshagent/meshagent": "^0.47.1",
         "typescript": "^5.8.3"
     },
     "devDependencies": {