@meshagent/meshagent-agents 0.43.3 → 0.44.0

package/dist/node/chat-client.js

@@ -6,12 +6,13 @@ const uuid_1 = require("uuid");
 const agent_messages_js_1 = require("./agent-messages.js");
 const change_emitter_js_1 = require("./change-emitter.js");
 class AgentMessageEvent {
-    constructor({ message, attachment }) {
+    constructor({ message, createdAt, attachment }) {
         this.message = message;
+        this.createdAt = createdAt ?? dateOrNull(message.createdAt) ?? new Date();
         this.attachment = attachment;
     }
     get payload() {
-        return this.message.toJson();
+        return { ...this.message.toJson(), created_at: this.createdAt.toISOString() };
     }
 }
 exports.AgentMessageEvent = AgentMessageEvent;
@@ -203,7 +204,7 @@ class BaseChatClient extends change_emitter_js_1.ChangeEmitter {
             this.notifyListeners();
         });
     }
-    async startThread({ messageId, message, attachments, name, backend, provider, model, voice, outputModalities, realtimeProtocol, senderName, clientToolkits, omitContent = false, }) {
+    async startThread({ messageId, message, attachments, name, backend, provider, model, voice, outputModalities, realtimeProtocol, senderName, clientToolkits, toolChoice, omitContent = false, }) {
         const resolvedMessageId = messageId == null || messageId.trim() === "" ? (0, uuid_1.v4)() : messageId.trim();
         const resolvedSenderName = this.cleanParticipantName(senderName) ?? this.localParticipantName();
         const payload = new agent_messages_js_1.StartThread({
@@ -218,6 +219,7 @@ class BaseChatClient extends change_emitter_js_1.ChangeEmitter {
             realtimeProtocol: nonEmptyTrimmed(realtimeProtocol),
             senderName: resolvedSenderName,
             clientToolkits: clientToolkits != null && clientToolkits.length > 0 ? clientToolkits : undefined,
+            toolChoice: toolChoice?.toJson(),
         });
         const completer = new meshagent_1.Completer();
         this.pendingStartRequests.set(resolvedMessageId, completer);
@@ -232,7 +234,10 @@ class BaseChatClient extends change_emitter_js_1.ChangeEmitter {
             }
             const session = this.openThread(threadPath, { load: false, drainPendingEvents: false });
             if (!omitContent) {
-                session.addAgentMessage(new AgentMessageEvent({ message: payload }));
+                session.addAgentMessage(new AgentMessageEvent({
+                    message: this.resolvedStartThreadMessage({ payload, threadPath }),
+                    createdAt: dateOrNull(payload.createdAt) ?? undefined,
+                }));
             }
             this.drainPendingSessionEvents(threadPath, session);
             return new ChatThreadStartResult({
@@ -247,6 +252,23 @@ class BaseChatClient extends change_emitter_js_1.ChangeEmitter {
             this.pendingStartRequests.delete(resolvedMessageId);
         }
     }
+    resolvedStartThreadMessage({ payload, threadPath, }) {
+        return new agent_messages_js_1.TurnStart({
+            threadId: threadPath,
+            messageId: payload.messageId,
+            senderName: payload.senderName,
+            content: payload.content,
+            backend: payload.backend,
+            provider: payload.provider,
+            model: payload.model,
+            voice: payload.voice,
+            outputModalities: payload.outputModalities,
+            instructions: payload.instructions,
+            mcp: payload.mcp,
+            clientToolkits: payload.clientToolkits,
+            toolkits: payload.toolkits,
+        });
+    }
     drainPendingSessionEvents(threadPath, session) {
         const pendingEvents = this.pendingSessionEventsByPath.get(threadPath);
         if (pendingEvents == null) {
@@ -257,16 +279,16 @@ class BaseChatClient extends change_emitter_js_1.ChangeEmitter {
             session.addAgentMessage(event);
         }
     }
-    handleAgentMessage(message, { attachment } = {}) {
+    handleAgentMessage(message, { createdAt, attachment } = {}) {
         if (message.type === agent_messages_js_1.agentConnectionStatusType) {
             this._connectionStatus = message;
             for (const session of this.sessionsByPath.values()) {
                 if (session.isOpen) {
-                    session.addAgentMessage(new AgentMessageEvent({ message, attachment }));
+                    session.addAgentMessage(new AgentMessageEvent({ message, createdAt, attachment }));
                 }
             }
         }
-        this.eventQueue.add(new AgentMessageEvent({ message, attachment }));
+        this.eventQueue.add(new AgentMessageEvent({ message, createdAt, attachment }));
         const sourceMessageId = sourceMessageIdFor(message);
         if ((message.type === agent_messages_js_1.agentThreadStartedType || message.type === agent_messages_js_1.agentThreadStartRejectedType) &&
             sourceMessageId != null &&
@@ -281,7 +303,7 @@ class BaseChatClient extends change_emitter_js_1.ChangeEmitter {
             this.notifyListeners();
             return;
         }
-        const event = new AgentMessageEvent({ message, attachment });
+        const event = new AgentMessageEvent({ message, createdAt, attachment });
         const session = this.sessionsByPath.get(threadPath);
         if (session != null) {
             session.addAgentMessage(event);
@@ -344,10 +366,15 @@ class MessagingChatClient extends BaseChatClient {
                 return;
             }
             const participant = this.agentParticipant();
-            if (participant == null || roomMessage.fromParticipantId !== participant.id) {
+            const fromSelectedAgent = participant != null && roomMessage.fromParticipantId === participant.id;
+            const fromParticipantlessThreadList = roomMessage.fromParticipantId == null && isThreadListMessage(roomMessage.message);
+            if (!fromSelectedAgent && !fromParticipantlessThreadList) {
                 return;
             }
-            this.handleAgentMessage(agent_messages_js_1.AgentMessage.fromJson(roomMessage.message), { attachment: roomMessage.attachment });
+            this.handleAgentMessage(agent_messages_js_1.AgentMessage.fromJson(roomMessage.message), {
+                createdAt: dateOrNull(roomMessage.message.created_at),
+                attachment: roomMessage.attachment,
+            });
         };
         this.room = room;
         this.agentName = agentName;
@@ -416,6 +443,12 @@ class MessagingChatClient extends BaseChatClient {
     }
 }
 exports.MessagingChatClient = MessagingChatClient;
+function isThreadListMessage(message) {
+    return message.type === agent_messages_js_1.agentThreadListedType
+        || message.type === agent_messages_js_1.agentThreadCreatedType
+        || message.type === agent_messages_js_1.agentThreadUpdatedType
+        || message.type === agent_messages_js_1.agentThreadDeletedType;
+}
 class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
     constructor({ client, threadPath }) {
         super();
@@ -463,6 +496,9 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
     async open({ load = true, sinceTurn } = {}) {
         if (this.openState) {
             if (load) {
+                if (sinceTurn == null) {
+                    this.resetReplayState();
+                }
                 const openThread = new agent_messages_js_1.OpenThread({ threadId: this.threadPath, load: true, sinceTurn });
                 this.setLoadState(this.loadingStateForOpen(openThread, sinceTurn));
                 try {
@@ -493,6 +529,17 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
             throw error;
         }
     }
+    resetReplayState() {
+        this._messages.length = 0;
+        this.messageIndexes.clear();
+        this.localAgentMessageIds.clear();
+        this.pendingLocalInputMessageIds.clear();
+        this.mergedDeltaMessageIds.clear();
+        this.pendingInputsById.clear();
+        this.lastCompletedTurnIdValue = undefined;
+        this.lastAgentMessageType = undefined;
+        this.lastAgentMessageAt = undefined;
+    }
     async close() {
         if (!this.openState) {
             return;
@@ -524,7 +571,7 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
             response,
         }));
     }
-    async sendText({ messageId, text, attachments, steer = false, turnId, backend, provider, model, voice, outputModalities, senderName, clientToolkits, }) {
+    async sendText({ messageId, text, attachments, steer = false, turnId, backend, provider, model, voice, outputModalities, senderName, clientToolkits, toolChoice, }) {
         const resolvedMessageId = messageId == null || messageId.trim() === "" ? (0, uuid_1.v4)() : messageId.trim();
         const currentModel = this.currentModelValue;
         const resolvedBackend = nonEmptyTrimmed(backend) ?? currentModel?.backend;
@@ -553,6 +600,7 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
                 voice: resolvedVoice,
                 outputModalities: resolvedOutputModalities,
                 clientToolkits: clientToolkits != null && clientToolkits.length > 0 ? clientToolkits : undefined,
+                toolChoice: toolChoice?.toJson(),
             });
         this.localAgentMessageIds.add(resolvedMessageId);
         this.pendingLocalInputMessageIds.add(resolvedMessageId);
@@ -602,9 +650,9 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
         const message = event.message;
         const type = message.type;
         this.lastAgentMessageType = type;
-        this.lastAgentMessageAt = new Date();
+        this.lastAgentMessageAt = event.createdAt;
         this.updateSessionState(message);
-        this.updatePendingInputsForMessage(message);
+        this.updatePendingInputsForMessage(message, event.createdAt);
         this.appendRenderableMessage(event);
         this.notifyListeners();
     }
@@ -670,7 +718,7 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
             }), { notify: false });
         }
     }
-    updatePendingInputsForMessage(message) {
+    updatePendingInputsForMessage(message, createdAt) {
         const type = message.type;
         const messageId = message.messageId;
         const sourceMessageId = sourceMessageIdFor(message);
@@ -684,7 +732,7 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
                     messageType: type,
                     threadPath: this.threadPath,
                     payload: message,
-                    createdAt: new Date(),
+                    createdAt,
                     awaitingAcceptance: true,
                     awaitingApplication: true,
                 }));
@@ -723,6 +771,31 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
             }
             return;
         }
+        if (message.type === agent_messages_js_1.agentToolCallEndedType) {
+            const itemId = normalizedString(message.itemId);
+            if (itemId != null) {
+                this.upsertItemMessage(`tool_call:${itemId}`, event);
+            }
+            else if (message.error != null) {
+                this.appendMessage(event);
+            }
+            return;
+        }
+        if (message.type === agent_messages_js_1.agentToolCallPendingType || message.type === agent_messages_js_1.agentToolCallInProgressType || message.type === agent_messages_js_1.agentToolCallStartedType) {
+            const itemId = normalizedString(message.itemId);
+            if (itemId != null) {
+                this.upsertItemMessage(`tool_call:${itemId}`, event);
+            }
+            return;
+        }
+        if (message.type === agent_messages_js_1.agentSecretRequestedType) {
+            this.appendMessage(event);
+            return;
+        }
+        if (message.type === agent_messages_js_1.agentModelChangedType) {
+            this.appendMessage(event);
+            return;
+        }
         if (message.type === agent_messages_js_1.agentThreadStartType || message.type === agent_messages_js_1.agentTurnStartType || message.type === agent_messages_js_1.agentTurnSteerType) {
             if (agentInputText(message.content).trim() !== "") {
                 this.appendMessage(event);
@@ -738,6 +811,18 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
             if (agentInputText(message.content).trim() !== "") {
                 this.appendMessage(event, { beforePendingLocalInputs: true });
             }
+            else {
+                this.appendMessage(event);
+            }
+            return;
+        }
+        if (message.type === agent_messages_js_1.agentTurnStartedType ||
+            message.type === agent_messages_js_1.agentTurnSteeredType ||
+            message.type === agent_messages_js_1.agentTurnStartRejectedType ||
+            message.type === agent_messages_js_1.agentTurnSteerRejectedType ||
+            message.type === agent_messages_js_1.agentTurnInterruptAcceptedType ||
+            message.type === agent_messages_js_1.agentTurnInterruptedType) {
+            this.appendMessage(event);
             return;
         }
         if (isMergeableDelta(message)) {
@@ -751,6 +836,10 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
             }
             return;
         }
+        if (message.type === agent_messages_js_1.agentUsageUpdatedType) {
+            this.appendMessage(event);
+            return;
+        }
         if (message instanceof agent_messages_js_1.AgentClientToolCallRequested) {
             this.appendMessage(event);
         }
@@ -803,7 +892,7 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
         const existing = this._messages[existingIndex].message;
         const merged = mergeDeltaMessage(existing, message);
         if (merged != null) {
-            this._messages[existingIndex] = new AgentMessageEvent({ message: merged, attachment: event.attachment });
+            this._messages[existingIndex] = new AgentMessageEvent({ message: merged, createdAt: event.createdAt, attachment: event.attachment });
         }
     }
     indexMessagesFrom(start) {
@@ -968,6 +1057,16 @@ function normalizedString(value) {
     const normalized = value?.trim();
     return normalized == null || normalized === "" ? undefined : normalized;
 }
+function dateOrNull(value) {
+    if (value instanceof Date && !Number.isNaN(value.getTime())) {
+        return value;
+    }
+    if (typeof value !== "string" || value.trim() === "") {
+        return undefined;
+    }
+    const parsed = new Date(value);
+    return Number.isNaN(parsed.getTime()) ? undefined : parsed;
+}
 function nonEmptyTrimmed(value) {
     const normalized = value?.trim();
     return normalized == null || normalized === "" ? undefined : normalized;

package/dist/node/thread-storage.js

@@ -313,10 +313,12 @@ class AgentThreadStorageRepository extends ThreadStorageRepository {
                 this.handleEvent(next.value);
             }
         })();
-        await new Promise((resolve) => {
+        const ready = new Promise((resolve) => {
             this.pendingOpen = { resolve };
-            void this.requestList();
         });
+        await this.chatClient.sendAgentMessage(new agent_messages_js_1.WatchThreads(), { ignoreOffline: true });
+        await this.requestList();
+        await ready;
     }
     async close() {
         this.closed = true;
@@ -325,6 +327,7 @@ class AgentThreadStorageRepository extends ThreadStorageRepository {
         this.pendingListMessageId = undefined;
         this.pendingOpen?.resolve();
         this.pendingOpen = undefined;
+        await this.chatClient.sendAgentMessage(new agent_messages_js_1.UnwatchThreads(), { ignoreOffline: true }).catch(() => undefined);
     }
     entries() {
         return [...this.entriesByPath.values()];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@meshagent/meshagent-agents",
-    "version": "0.43.3",
+    "version": "0.44.0",
     "description": "Agent chat sessions and clients for Meshagent TypeScript applications.",
     "homepage": "https://github.com/meshagent/meshagent-agents-ts",
     "scripts": {
@@ -47,7 +47,7 @@
         "typescript": "^5.8.2"
     },
     "dependencies": {
-        "@meshagent/meshagent": "^0.43.3",
+        "@meshagent/meshagent": "^0.44.0",
         "apache-arrow": "^21.0.0",
         "uuid": "^14.0.0"
     },