@meshagent/meshagent-agents 0.43.3 → 0.44.1

package/dist/node/agent-messages.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.agentToolCallStartedType = exports.agentToolCallInProgressType = exports.agentToolCallPendingType = exports.agentFileContentEndedType = exports.agentFileContentDeltaType = exports.agentFileContentStartedType = exports.agentTextContentEndedType = exports.agentTextContentDeltaType = exports.agentTextContentStartedType = exports.agentReasoningContentEndedType = exports.agentReasoningContentDeltaType = exports.agentReasoningContentStartedType = exports.agentTurnEndedType = exports.agentTurnStartedType = exports.agentTurnSteerRejectedType = exports.agentTurnSteeredType = exports.agentTurnSteerAcceptedType = exports.agentTurnInterruptedType = exports.agentTurnInterruptAcceptedType = exports.agentTurnStartRejectedType = exports.agentTurnStartAcceptedType = exports.agentThreadClearedType = exports.agentModelChangedType = exports.agentModelChangeType = exports.agentModelsResponseType = exports.agentModelsRequestType = exports.agentCapabilitiesResponseType = exports.agentCapabilitiesRequestType = exports.agentThreadDeletedType = exports.agentThreadUpdatedType = exports.agentThreadCreatedType = exports.agentThreadListedType = exports.agentThreadListType = exports.agentThreadRenameType = exports.agentThreadDeleteType = exports.agentParticipantDisconnectType = exports.agentParticipantConnectType = exports.agentThreadCloseType = exports.agentThreadOpenType = exports.agentThreadStartRejectedType = exports.agentThreadLoadedType = exports.agentThreadStartedType = exports.agentThreadStartType = exports.agentRealtimeAudioCommitType = exports.agentRealtimeAudioChunkType = exports.agentThreadClearType = exports.agentTurnInterruptType = exports.agentTurnSteerType = exports.agentTurnStartType = exports.agentRoomMessageType = void 0;
-exports.StartThread = exports.AgentLLMMessage = exports.AgentThreadMessage = exports.AgentMessage = exports.AgentContextWindowUsage = exports.AgentGeneratedAudio = exports.AgentGeneratedImage = exports.AgentToolCallLogLine = exports.AgentRealtimeConnectionInfo = exports.AgentThreadListEntry = exports.AgentProviderInfo = exports.AgentModelInfo = exports.ToolkitCapabilities = exports.ToolkitToolCapabilities = exports.AgentError = exports.AgentAudioFormat = exports.TurnToolkitConfig = exports.ClientToolkitDescription = exports.TurnMcpConfig = exports.ToolChoice = exports.agentClientToolCallResponseType = exports.agentSecretResponseType = exports.agentToolRejectType = exports.agentToolApproveType = exports.agentUsageUpdatedType = exports.agentContextCompactedType = exports.agentAudioInputSpeechEndedType = exports.agentAudioInputSpeechStartedType = exports.agentAudioTranscriptionFailedType = exports.agentAudioTranscriptionCompletedType = exports.agentAudioTranscriptionDeltaType = exports.agentAudioTranscriptionStartedType = exports.agentAudioGenerationFailedType = exports.agentAudioGenerationCompletedType = exports.agentAudioGenerationDeltaType = exports.agentAudioGenerationStartedType = exports.agentImageGenerationFailedType = exports.agentImageGenerationCompletedType = exports.agentImageGenerationPartialType = exports.agentImageGenerationStartedType = exports.agentThreadEventType = exports.agentConnectionStatusType = exports.agentThreadStatusType = exports.agentSecretRequestedType = exports.agentClientToolCallCancelledType = exports.agentClientToolCallRequestedType = exports.agentToolCallApprovalRequestedType = exports.agentToolCallEndedType = exports.agentToolCallLogDeltaType = exports.agentToolCallArgumentsDeltaType = void 0;
-exports.AgentToolCallLogDelta = exports.AgentToolCallArgumentsDelta = exports.AgentToolCallStarted = exports.AgentToolCallInProgress = exports.AgentToolCallPending = exports.AgentFileContentEnded = exports.AgentFileContentDelta = exports.AgentFileContentStarted = exports.AgentTextContentEnded = exports.AgentTextContentDelta = exports.AgentTextContentStarted = exports.AgentReasoningContentEnded = exports.AgentReasoningContentDelta = exports.AgentReasoningContentStarted = exports.ThreadStartRejected = exports.ThreadLoaded = exports.ThreadStarted = exports.TurnEnded = exports.TurnStarted = exports.TurnSteerRejected = exports.TurnSteered = exports.TurnSteerAccepted = exports.TurnInterrupted = exports.TurnInterruptAccepted = exports.TurnStartRejected = exports.TurnStartAccepted = exports.ThreadCleared = exports.AgentModelChanged = exports.ChangeModel = exports.ModelsResponse = exports.ModelsRequest = exports.CapabilitiesResponse = exports.CapabilitiesRequest = exports.ThreadDeleted = exports.ThreadUpdated = exports.ThreadCreated = exports.ThreadsListed = exports.ListThreads = exports.RenameThread = exports.DeleteThread = exports.ParticipantDisconnect = exports.ParticipantConnect = exports.CloseThread = exports.OpenThread = exports.ClearThread = exports.AgentRealtimeAudioCommit = exports.AgentRealtimeAudioChunk = exports.TurnInterrupt = exports.TurnSteer = exports.TurnStart = void 0;
-exports.AgentClientToolCallResponse = exports.AgentSecretResponse = exports.RejectAgentToolCall = exports.ApproveAgentToolCall = exports.AgentUsageUpdated = exports.AgentContextCompacted = exports.AgentAudioInputSpeechEnded = exports.AgentAudioInputSpeechStarted = exports.AgentAudioTranscriptionFailed = exports.AgentAudioTranscriptionCompleted = exports.AgentAudioTranscriptionDelta = exports.AgentAudioTranscriptionStarted = exports.AgentAudioGenerationFailed = exports.AgentAudioGenerationCompleted = exports.AgentAudioGenerationDelta = exports.AgentAudioGenerationStarted = exports.AgentImageGenerationFailed = exports.AgentImageGenerationCompleted = exports.AgentImageGenerationPartial = exports.AgentImageGenerationStarted = exports.AgentThreadEvent = exports.AgentConnectionStatus = exports.AgentThreadStatus = exports.AgentClientToolCallCancelled = exports.AgentClientToolCallRequested = exports.AgentSecretRequested = exports.AgentToolCallApprovalRequested = exports.AgentToolCallEnded = void 0;
+exports.agentToolCallPendingType = exports.agentFileContentEndedType = exports.agentFileContentDeltaType = exports.agentFileContentStartedType = exports.agentTextContentEndedType = exports.agentTextContentDeltaType = exports.agentTextContentStartedType = exports.agentReasoningContentEndedType = exports.agentReasoningContentDeltaType = exports.agentReasoningContentStartedType = exports.agentTurnEndedType = exports.agentTurnStartedType = exports.agentTurnSteerRejectedType = exports.agentTurnSteeredType = exports.agentTurnSteerAcceptedType = exports.agentTurnInterruptedType = exports.agentTurnInterruptAcceptedType = exports.agentTurnStartRejectedType = exports.agentTurnStartAcceptedType = exports.agentThreadClearedType = exports.agentModelChangedType = exports.agentModelChangeType = exports.agentModelsResponseType = exports.agentModelsRequestType = exports.agentCapabilitiesResponseType = exports.agentCapabilitiesRequestType = exports.agentThreadDeletedType = exports.agentThreadUpdatedType = exports.agentThreadCreatedType = exports.agentThreadListedType = exports.agentThreadUnwatchType = exports.agentThreadWatchType = exports.agentThreadListType = exports.agentThreadRenameType = exports.agentThreadDeleteType = exports.agentParticipantDisconnectType = exports.agentParticipantConnectType = exports.agentThreadCloseType = exports.agentThreadOpenType = exports.agentThreadStartRejectedType = exports.agentThreadLoadedType = exports.agentThreadStartedType = exports.agentThreadStartType = exports.agentRealtimeAudioCommitType = exports.agentRealtimeAudioChunkType = exports.agentThreadClearType = exports.agentTurnInterruptType = exports.agentTurnSteerType = exports.agentTurnStartType = exports.agentRoomMessageType = void 0;
+exports.AgentThreadMessage = exports.AgentMessage = exports.AgentContextWindowUsage = exports.AgentGeneratedAudio = exports.AgentGeneratedImage = exports.AgentToolCallLogLine = exports.AgentRealtimeConnectionInfo = exports.AgentThreadListEntry = exports.AgentProviderInfo = exports.AgentModelInfo = exports.ToolkitCapabilities = exports.ToolkitToolCapabilities = exports.AgentError = exports.AgentAudioFormat = exports.TurnToolkitConfig = exports.ClientToolkitDescription = exports.TurnMcpConfig = exports.ToolChoice = exports.agentClientToolCallResponseType = exports.agentSecretResponseType = exports.agentToolRejectType = exports.agentToolApproveType = exports.agentUsageUpdatedType = exports.agentContextCompactedType = exports.agentAudioInputSpeechEndedType = exports.agentAudioInputSpeechStartedType = exports.agentAudioTranscriptionFailedType = exports.agentAudioTranscriptionCompletedType = exports.agentAudioTranscriptionDeltaType = exports.agentAudioTranscriptionStartedType = exports.agentAudioGenerationFailedType = exports.agentAudioGenerationCompletedType = exports.agentAudioGenerationDeltaType = exports.agentAudioGenerationStartedType = exports.agentImageGenerationFailedType = exports.agentImageGenerationCompletedType = exports.agentImageGenerationPartialType = exports.agentImageGenerationStartedType = exports.agentThreadEventType = exports.agentConnectionStatusType = exports.agentThreadStatusType = exports.agentSecretRequestedType = exports.agentClientToolCallCancelledType = exports.agentClientToolCallRequestedType = exports.agentToolCallApprovalRequestedType = exports.agentToolCallEndedType = exports.agentToolCallLogDeltaType = exports.agentToolCallArgumentsDeltaType = exports.agentToolCallStartedType = exports.agentToolCallInProgressType = void 0;
+exports.AgentToolCallPending = exports.AgentFileContentEnded = exports.AgentFileContentDelta = exports.AgentFileContentStarted = exports.AgentTextContentEnded = exports.AgentTextContentDelta = exports.AgentTextContentStarted = exports.AgentReasoningContentEnded = exports.AgentReasoningContentDelta = exports.AgentReasoningContentStarted = exports.ThreadStartRejected = exports.ThreadLoaded = exports.ThreadStarted = exports.TurnEnded = exports.TurnStarted = exports.TurnSteerRejected = exports.TurnSteered = exports.TurnSteerAccepted = exports.TurnInterrupted = exports.TurnInterruptAccepted = exports.TurnStartRejected = exports.TurnStartAccepted = exports.ThreadCleared = exports.AgentModelChanged = exports.ChangeModel = exports.ModelsResponse = exports.ModelsRequest = exports.CapabilitiesResponse = exports.CapabilitiesRequest = exports.ThreadDeleted = exports.ThreadUpdated = exports.ThreadCreated = exports.ThreadsListed = exports.UnwatchThreads = exports.WatchThreads = exports.ListThreads = exports.RenameThread = exports.DeleteThread = exports.ParticipantDisconnect = exports.ParticipantConnect = exports.CloseThread = exports.OpenThread = exports.ClearThread = exports.AgentRealtimeAudioCommit = exports.AgentRealtimeAudioChunk = exports.TurnInterrupt = exports.TurnSteer = exports.TurnStart = exports.StartThread = exports.AgentLLMMessage = void 0;
+exports.AgentClientToolCallResponse = exports.AgentSecretResponse = exports.RejectAgentToolCall = exports.ApproveAgentToolCall = exports.AgentUsageUpdated = exports.AgentContextCompacted = exports.AgentAudioInputSpeechEnded = exports.AgentAudioInputSpeechStarted = exports.AgentAudioTranscriptionFailed = exports.AgentAudioTranscriptionCompleted = exports.AgentAudioTranscriptionDelta = exports.AgentAudioTranscriptionStarted = exports.AgentAudioGenerationFailed = exports.AgentAudioGenerationCompleted = exports.AgentAudioGenerationDelta = exports.AgentAudioGenerationStarted = exports.AgentImageGenerationFailed = exports.AgentImageGenerationCompleted = exports.AgentImageGenerationPartial = exports.AgentImageGenerationStarted = exports.AgentThreadEvent = exports.AgentConnectionStatus = exports.AgentThreadStatus = exports.AgentClientToolCallCancelled = exports.AgentClientToolCallRequested = exports.AgentSecretRequested = exports.AgentToolCallApprovalRequested = exports.AgentToolCallEnded = exports.AgentToolCallLogDelta = exports.AgentToolCallArgumentsDelta = exports.AgentToolCallStarted = exports.AgentToolCallInProgress = void 0;
 exports.agentInputContent = agentInputContent;
 const meshagent_1 = require("@meshagent/meshagent");
 const uuid_1 = require("uuid");
@@ -25,6 +25,8 @@ exports.agentParticipantDisconnectType = "meshagent.agent.participant.disconnect
 exports.agentThreadDeleteType = "meshagent.agent.thread.delete";
 exports.agentThreadRenameType = "meshagent.agent.thread.rename";
 exports.agentThreadListType = "meshagent.agent.thread.list";
+exports.agentThreadWatchType = "meshagent.agent.thread.watch";
+exports.agentThreadUnwatchType = "meshagent.agent.thread.unwatch";
 exports.agentThreadListedType = "meshagent.agent.thread.listed";
 exports.agentThreadCreatedType = "meshagent.agent.thread.created";
 exports.agentThreadUpdatedType = "meshagent.agent.thread.updated";
@@ -654,16 +656,18 @@ function omitUndefined(value) {
     return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
 }
 class AgentMessage {
-    constructor({ type, messageId, message_id, senderName, sender_name }) {
+    constructor({ type, messageId, message_id, senderName, sender_name, createdAt, created_at }) {
         this.type = String(type);
         const resolvedMessageId = stringOrNull(messageId ?? message_id)?.trim();
         this.messageId = resolvedMessageId == null || resolvedMessageId.length === 0 ? (0, uuid_1.v4)() : resolvedMessageId;
         this.senderName = stringOrNull(senderName ?? sender_name);
+        this.createdAt = stringOrNull(createdAt ?? created_at) ?? new Date().toISOString();
     }
     toJson() {
         return {
             type: this.type,
             message_id: this.messageId,
+            created_at: this.createdAt,
             ...(this.senderName != null ? { sender_name: this.senderName } : {}),
         };
     }
@@ -730,6 +734,7 @@ function makeMessageClass({ type, base = "message", fields = [], }) {
             const params = {
                 messageId: stringOrNull(json.message_id),
                 senderName: stringOrNull(json.sender_name),
+                createdAt: stringOrNull(json.created_at),
             };
             if (base !== "message") {
                 params.threadId = requiredString(json, "thread_id");
@@ -940,6 +945,8 @@ exports.ParticipantDisconnect = makeMessageClass({ type: exports.agentParticipan
 exports.DeleteThread = makeMessageClass({ type: exports.agentThreadDeleteType, base: "thread" });
 exports.RenameThread = makeMessageClass({ type: exports.agentThreadRenameType, base: "thread", fields: [s("name", "name", true)] });
 exports.ListThreads = makeMessageClass({ type: exports.agentThreadListType, fields: [{ prop: "limit", json: "limit", from: (value) => intOrNull(value) ?? 200, default: () => 200, always: true }, { prop: "offset", json: "offset", from: (value) => intOrNull(value) ?? 0, default: () => 0, always: true }] });
+exports.WatchThreads = makeMessageClass({ type: exports.agentThreadWatchType });
+exports.UnwatchThreads = makeMessageClass({ type: exports.agentThreadUnwatchType });
 exports.ThreadsListed = makeMessageClass({ type: exports.agentThreadListedType, fields: [s("sourceMessageId", "source_message_id", true), objList("threads", "threads", AgentThreadListEntry.fromJson, true), i("total"), i("offset"), i("limit")] });
 exports.ThreadCreated = makeMessageClass({ type: exports.agentThreadCreatedType, fields: [obj("thread", "thread", AgentThreadListEntry.fromJson, true)] });
 exports.ThreadUpdated = makeMessageClass({ type: exports.agentThreadUpdatedType, fields: [obj("thread", "thread", AgentThreadListEntry.fromJson, true)] });

package/dist/node/chat-client.d.ts

@@ -1,13 +1,15 @@
 import { RemoteParticipant } from "@meshagent/meshagent";
 import type { RoomClient, Content } from "@meshagent/meshagent";
-import { AgentMessage, AgentModelChanged, AgentThreadStatus, ModelsResponse, AgentConnectionStatus } from "./agent-messages.js";
+import { AgentMessage, AgentModelChanged, AgentThreadStatus, ModelsResponse, ToolChoice, AgentConnectionStatus } from "./agent-messages.js";
 import type { AgentPayload, JsonMap, ClientToolkitDescription } from "./agent-messages.js";
 import { ChangeEmitter } from "./change-emitter.js";
 export declare class AgentMessageEvent {
     readonly message: AgentMessage;
+    readonly createdAt: Date;
     readonly attachment?: Uint8Array;
-    constructor({ message, attachment }: {
+    constructor({ message, createdAt, attachment }: {
         message: AgentMessage;
+        createdAt?: Date;
         attachment?: Uint8Array;
     });
     get payload(): AgentPayload;
@@ -96,7 +98,7 @@ export declare abstract class BaseChatClient extends ChangeEmitter {
         drainPendingEvents?: boolean;
     }): ChatThreadSession;
     private openSession;
-    startThread({ messageId, message, attachments, name, backend, provider, model, voice, outputModalities, realtimeProtocol, senderName, clientToolkits, omitContent, }: {
+    startThread({ messageId, message, attachments, name, backend, provider, model, voice, outputModalities, realtimeProtocol, senderName, clientToolkits, toolChoice, omitContent, }: {
         messageId?: string;
         message: string;
         attachments: string[];
@@ -109,14 +111,17 @@ export declare abstract class BaseChatClient extends ChangeEmitter {
         realtimeProtocol?: string;
         senderName?: string;
         clientToolkits?: ClientToolkitDescription[];
+        toolChoice?: ToolChoice;
         omitContent?: boolean;
     }): Promise<ChatThreadStartResult>;
+    private resolvedStartThreadMessage;
     abstract sendAgentMessage(message: AgentMessage, options?: {
         attachment?: Uint8Array;
         ignoreOffline?: boolean;
     }): Promise<void>;
     private drainPendingSessionEvents;
-    handleAgentMessage(message: AgentMessage, { attachment }?: {
+    handleAgentMessage(message: AgentMessage, { createdAt, attachment }?: {
+        createdAt?: Date;
         attachment?: Uint8Array;
     }): void;
     emitConnectionStatus({ status, message, reason, retryDelay, }: {
@@ -132,6 +137,11 @@ export declare class MessagingChatClient extends BaseChatClient {
     readonly agentName?: string;
     private readonly pendingParticipantWaits;
     private started;
+    private agentParticipantId?;
+    private hasConnected;
+    private waitingForParticipant;
+    private roomAbortController?;
+    private messagingListenersAttached;
     constructor({ room, agentName }: {
         room: RoomClient;
         agentName?: string;
@@ -139,6 +149,8 @@ export declare class MessagingChatClient extends BaseChatClient {
     localParticipantName(): string | undefined;
     start(): Promise<void>;
     stop(): Promise<void>;
+    private attachMessagingListeners;
+    private detachMessagingListeners;
     agentParticipant(): RemoteParticipant | null;
     waitForAgentParticipant({ waitKey }?: {
         waitKey?: string;
@@ -148,6 +160,10 @@ export declare class MessagingChatClient extends BaseChatClient {
         ignoreOffline?: boolean;
     }): Promise<void>;
     private readonly onMessagingChanged;
+    private readonly onMessagingParticipantChanged;
+    private readonly onMessagingParticipantRemoved;
+    private startRoomStatusListener;
+    private reopenOpenSessions;
     private readonly onMessagingMessage;
 }
 export declare class ChatThreadSession extends ChangeEmitter {
@@ -186,6 +202,7 @@ export declare class ChatThreadSession extends ChangeEmitter {
         load?: boolean;
         sinceTurn?: string;
     }): Promise<void>;
+    private resetReplayState;
     close(): Promise<void>;
     requestModels({ ignoreOffline }?: {
         ignoreOffline?: boolean;
@@ -202,7 +219,7 @@ export declare class ChatThreadSession extends ChangeEmitter {
         requestId: string;
         response: Content;
     }): Promise<void>;
-    sendText({ messageId, text, attachments, steer, turnId, backend, provider, model, voice, outputModalities, senderName, clientToolkits, }: {
+    sendText({ messageId, text, attachments, steer, turnId, backend, provider, model, voice, outputModalities, senderName, clientToolkits, toolChoice, }: {
         messageId?: string;
         text: string;
         attachments: string[];
@@ -215,6 +232,7 @@ export declare class ChatThreadSession extends ChangeEmitter {
         outputModalities?: string[];
         senderName?: string;
         clientToolkits?: ClientToolkitDescription[];
+        toolChoice?: ToolChoice;
     }): Promise<string>;
     sendRealtimeAudioChunk({ chunk, format }: {
         chunk: Uint8Array;

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,11 @@ 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 }));
-                }
-            }
         }
-        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 +298,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);
@@ -302,11 +319,6 @@ class BaseChatClient extends change_emitter_js_1.ChangeEmitter {
         });
         this._connectionStatus = event;
         this.eventQueue.add(new AgentMessageEvent({ message: event }));
-        for (const session of this.sessionsByPath.values()) {
-            if (session.isOpen) {
-                session.addAgentMessage(new AgentMessageEvent({ message: event }));
-            }
-        }
         this.notifyListeners();
     }
     removeThreadSession(threadPath) {
@@ -325,10 +337,50 @@ class MessagingChatClient extends BaseChatClient {
         super();
         this.pendingParticipantWaits = new Map();
         this.started = false;
+        this.hasConnected = false;
+        this.waitingForParticipant = false;
+        this.messagingListenersAttached = false;
         this.onMessagingChanged = () => {
             const participant = this.agentParticipant();
+            const participantId = participant?.id;
+            if (participantId !== this.agentParticipantId) {
+                if (participantId == null) {
+                    if (this.agentParticipantId != null) {
+                        this.waitingForParticipant = true;
+                        this.emitConnectionStatus({
+                            status: "disconnected",
+                            message: "Agent messaging disconnected",
+                            reason: "participant_disconnected",
+                        });
+                        this.emitConnectionStatus({
+                            status: "reconnecting",
+                            message: "Waiting for agent messaging",
+                            reason: "participant_disconnected",
+                        });
+                    }
+                    else if (this.started && this.waitingForParticipant) {
+                        this.emitConnectionStatus({
+                            status: "reconnecting",
+                            message: "Waiting for agent messaging",
+                            reason: "participant_offline",
+                        });
+                    }
+                }
+                else {
+                    const status = this.hasConnected ? "reconnected" : "connected";
+                    this.hasConnected = true;
+                    this.waitingForParticipant = false;
+                    this.emitConnectionStatus({
+                        status,
+                        message: status === "reconnected" ? "Agent messaging reconnected" : "Agent messaging connected",
+                    });
+                    if (status === "reconnected") {
+                        void this.reopenOpenSessions();
+                    }
+                }
+                this.agentParticipantId = participantId;
+            }
             if (participant != null) {
-                this.emitConnectionStatus({ status: "connected", message: "Agent messaging connected" });
                 for (const wait of this.pendingParticipantWaits.values()) {
                     if (!wait.completed) {
                         wait.complete(participant);
@@ -337,6 +389,12 @@ class MessagingChatClient extends BaseChatClient {
             }
             this.notifyListeners();
         };
+        this.onMessagingParticipantChanged = () => {
+            this.onMessagingChanged();
+        };
+        this.onMessagingParticipantRemoved = () => {
+            this.onMessagingChanged();
+        };
         this.onMessagingMessage = (event) => {
             this.onMessagingChanged();
             const roomMessage = agentRoomMessageFromEvent(event);
@@ -344,14 +402,19 @@ 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;
-        this.room.messaging.addListener("message", this.onMessagingMessage);
+        this.attachMessagingListeners();
     }
     localParticipantName() {
         const name = this.room.localParticipant?.getAttribute("name");
@@ -362,12 +425,18 @@ class MessagingChatClient extends BaseChatClient {
             return;
         }
         this.started = true;
+        this.attachMessagingListeners();
         this.room.messaging.start();
-        this.room.messaging.enable();
+        this.startRoomStatusListener();
+        await this.room.messaging.enable();
+        this.waitingForParticipant = true;
+        this.onMessagingChanged();
     }
     async stop() {
         this.started = false;
-        this.room.messaging.removeListener("message", this.onMessagingMessage);
+        this.roomAbortController?.abort();
+        this.roomAbortController = undefined;
+        this.detachMessagingListeners();
         for (const wait of this.pendingParticipantWaits.values()) {
             if (!wait.completed) {
                 wait.completeError(new Error("Chat client stopped while waiting for an agent participant."));
@@ -375,12 +444,35 @@ class MessagingChatClient extends BaseChatClient {
         }
         this.pendingParticipantWaits.clear();
     }
+    attachMessagingListeners() {
+        if (this.messagingListenersAttached) {
+            return;
+        }
+        this.room.messaging.addListener("message", this.onMessagingMessage);
+        this.room.messaging.addListener("participant_added", this.onMessagingParticipantChanged);
+        this.room.messaging.addListener("participant_removed", this.onMessagingParticipantRemoved);
+        this.room.messaging.addListener("messaging_enabled", this.onMessagingParticipantChanged);
+        this.messagingListenersAttached = true;
+    }
+    detachMessagingListeners() {
+        if (!this.messagingListenersAttached) {
+            return;
+        }
+        this.room.messaging.removeListener("messaging_enabled", this.onMessagingParticipantChanged);
+        this.room.messaging.removeListener("participant_removed", this.onMessagingParticipantRemoved);
+        this.room.messaging.removeListener("participant_added", this.onMessagingParticipantChanged);
+        this.room.messaging.removeListener("message", this.onMessagingMessage);
+        this.messagingListenersAttached = false;
+    }
     agentParticipant() {
         const normalizedAgentName = this.agentName?.trim();
         for (const participant of this.room.messaging.remoteParticipants) {
             if (normalizedAgentName != null && normalizedAgentName !== "" && participant.getAttribute("name") !== normalizedAgentName) {
                 continue;
             }
+            if (normalizedAgentName != null && normalizedAgentName !== "") {
+                return participant;
+            }
             if (participant.getAttribute("supports_agent_messages") === true) {
                 return participant;
             }
@@ -405,7 +497,13 @@ class MessagingChatClient extends BaseChatClient {
     }
     async sendAgentMessage(message, { attachment, ignoreOffline = false } = {}) {
         await this.start();
-        const participant = this.agentParticipant() ?? await this.waitForAgentParticipant({ waitKey: message.messageId });
+        let participant = this.agentParticipant();
+        if (participant == null) {
+            if (ignoreOffline) {
+                return;
+            }
+            participant = await this.waitForAgentParticipant({ waitKey: message.messageId });
+        }
         await this.room.messaging.sendMessage({
             to: participant,
             type: agent_messages_js_1.agentRoomMessageType,
@@ -414,8 +512,51 @@ class MessagingChatClient extends BaseChatClient {
             ignoreOffline,
         });
     }
+    startRoomStatusListener() {
+        if (this.roomAbortController != null) {
+            return;
+        }
+        const controller = new AbortController();
+        this.roomAbortController = controller;
+        void (async () => {
+            for await (const event of this.room.listen({ abortSignal: controller.signal })) {
+                if (controller.signal.aborted || event.name !== "room.status") {
+                    continue;
+                }
+                const status = String(event.status ?? "").trim().toLowerCase();
+                const message = String(event.message ?? "").trim();
+                if (status === "connected" || status === "ready" || status === "reconnected") {
+                    this.waitingForParticipant = true;
+                    this.onMessagingChanged();
+                }
+                else if (status === "disconnected" || status === "reconnecting" || status === "connecting") {
+                    this.agentParticipantId = undefined;
+                    this.waitingForParticipant = true;
+                    this.emitConnectionStatus({
+                        status: status === "disconnected" ? "disconnected" : "reconnecting",
+                        message: message !== "" ? message : status === "disconnected" ? "Agent messaging disconnected" : "Waiting for agent messaging",
+                        reason: message !== "" ? message : undefined,
+                    });
+                }
+            }
+        })().catch(() => undefined);
+    }
+    async reopenOpenSessions() {
+        for (const session of this.sessions) {
+            if (!session.isOpen) {
+                continue;
+            }
+            await session.open({ load: true, sinceTurn: session.lastCompletedTurnId });
+        }
+    }
 }
 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 +604,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 +637,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 +679,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 +708,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 +758,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 +826,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 +840,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 +879,31 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
             }
             return;
         }
+        if (message.type === agent_messages_js_1.agentToolCallEndedType) {
+            const itemId = message.error == null ? undefined : 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 +919,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 +944,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 +1000,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 +1165,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.d.ts

@@ -93,6 +93,7 @@ export declare class AgentThreadStorageRepository extends ThreadStorageRepositor
     renameThread(threadPath: string, name: string): Promise<void>;
     private requestList;
     private handleEvent;
+    private reconnectWatch;
     private handleThreadsListed;
     private upsertThread;
     private entryFromAgentThread;