@meshagent/meshagent-agents 0.46.4 → 0.47.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
-## [0.46.4]
-- Stability
+## [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.
+- Added a `test:rust-process-e2e` entry point for the agents-ts package and expanded live chat/process-agent coverage.
+- Finished aligning CLI pagination behavior across feeds, rooms, mailboxes, scheduled tasks, and shared helpers.
 
 ## [0.46.3]
 - `LivekitProtocolChannel.sendData` now clones outgoing `Uint8Array` payloads before publishing, avoiding shared-buffer mutation issues.

package/README.md

@@ -204,3 +204,27 @@ npm test
 ```
 
 The build emits ESM, Node CommonJS, and browser CommonJS outputs under `dist/`.
+
+An external E2E harness can validate interoperability with a Rust process agent by
+starting that agent in a room, then supplying its room participant credentials:
+
+```bash
+MESHAGENT_TOKEN=... \
+MESHAGENT_ROOM=... \
+TEST_AGENT_NAME=... \
+MESHAGENT_API_URL=... \
+npm run test:rust-process-e2e
+```
+
+The runner owns only the TypeScript client. The harness remains responsible for
+starting and stopping the Rust process agent named by `TEST_AGENT_NAME`. It must
+also supply either `MESHAGENT_API_URL` (preferred for the Rust harness) or
+`MESHAGENT_ROOM_URL`, so the client does not silently connect to production.
+
+From this repository, the preferred full interoperability check starts the
+Rust server and process agent, runs both the Dart and TypeScript suites, and
+stops the fixture automatically:
+
+```bash
+rust/meshagent-server-e2e/run-cross-language-e2e.sh
+```

package/dist/browser/agent-messages.js

@@ -747,26 +747,16 @@ function makeMessageClass({ type, base = "message", fields = [], }) {
                 params.model = stringOrNull(json.model);
             }
             for (const field of fields) {
-                if (field.required) {
-                    if (field.from != null) {
-                        params[field.prop] = field.from(json[field.json], json);
+                if (!hasOwn(json, field.json)) {
+                    if (field.required) {
+                        if (field.from != null) {
+                            field.from(undefined, json);
+                        }
+                        throw new TypeError(`missing required field '${field.json}'`);
                     }
-                    else if (typeof json[field.json] === "string") {
-                        params[field.prop] = requiredString(json, field.json);
-                    }
-                    else if (typeof json[field.json] === "number") {
-                        params[field.prop] = json[field.json];
-                    }
-                    else {
-                        params[field.prop] = requiredMap(json, field.json);
-                    }
-                }
-                else if (hasOwn(json, field.json)) {
-                    params[field.prop] = field.from != null ? field.from(json[field.json], json) : json[field.json];
-                }
-                else if (field.default != null) {
-                    params[field.prop] = field.default(json);
+                    continue;
                 }
+                params[field.prop] = json[field.json];
             }
             return new this(params);
         }
@@ -990,10 +980,10 @@ exports.AgentToolCallLogDelta = makeMessageClass({ type: exports.agentToolCallLo
 exports.AgentToolCallEnded = makeMessageClass({ type: exports.agentToolCallEndedType, base: "llm", fields: [...contentPart, { prop: "namespace", json: "namespace", from: (value) => stringOrNull(value) ?? "meshagent", default: () => "meshagent", always: true }, s("callId"), s("toolkit"), s("tool"), { prop: "result", json: "result", from: contentOrNull, to: contentHeader }, obj("error", "error", AgentError.fromJson)] });
 exports.AgentToolCallApprovalRequested = makeMessageClass({ type: exports.agentToolCallApprovalRequestedType, base: "llm", fields: toolState.filter((field) => field.prop !== "argumentBytes") });
 exports.AgentSecretRequested = makeMessageClass({ type: exports.agentSecretRequestedType, base: "llm", fields: [...contentPart, s("requestId", "request_id", true), s("name", "name", true), s("scope")] });
-exports.AgentClientToolCallRequested = makeMessageClass({ type: exports.agentClientToolCallRequestedType, base: "llm", fields: [...contentPart, s("requestId", "request_id", true), s("toolkit", "toolkit", true), s("tool", "tool", true), m("arguments", "arguments", true)] });
-exports.AgentClientToolCallCancelled = makeMessageClass({ type: exports.agentClientToolCallCancelledType, base: "llm", fields: [...contentPart, s("requestId", "request_id", true), s("reason")] });
+exports.AgentClientToolCallRequested = makeMessageClass({ type: exports.agentClientToolCallRequestedType, base: "llm", fields: [...contentPart, s("requestId", "request_id", true), s("targetParticipantId"), s("toolkit", "toolkit", true), s("tool", "tool", true), m("arguments", "arguments", true)] });
+exports.AgentClientToolCallCancelled = makeMessageClass({ type: exports.agentClientToolCallCancelledType, base: "llm", fields: [...contentPart, s("requestId", "request_id", true), s("targetParticipantId"), s("reason")] });
 exports.AgentThreadStatus = makeMessageClass({ type: exports.agentThreadStatusType, base: "thread", fields: [s("status"), s("mode"), s("startedAt"), s("turnId"), s("pendingItemId"), i("totalBytes"), i("linesAdded"), i("linesRemoved")] });
-exports.AgentConnectionStatus = makeMessageClass({ type: exports.agentConnectionStatusType, fields: [s("status", "status", true), s("message"), s("reason"), n("retryInSeconds")] });
+exports.AgentConnectionStatus = makeMessageClass({ type: exports.agentConnectionStatusType, fields: [s("status", "status", true), s("message"), s("reason"), n("retryInSeconds"), s("participantId")] });
 exports.AgentThreadEvent = makeMessageClass({ type: exports.agentThreadEventType, base: "llm", fields: [m("event", "event", true)] });
 exports.AgentImageGenerationStarted = makeMessageClass({ type: exports.agentImageGenerationStartedType, base: "llm", fields: imageGeneration });
 exports.AgentImageGenerationPartial = makeMessageClass({ type: exports.agentImageGenerationPartialType, base: "llm", fields: [...imageGeneration, obj("image", "image", AgentGeneratedImage.fromJson), i("partialIndex")] });

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

@@ -1,6 +1,6 @@
-import { RemoteParticipant } from "@meshagent/meshagent";
+import { MessagingStream, RemoteParticipant } from "@meshagent/meshagent";
 import type { RoomClient, Content } from "@meshagent/meshagent";
-import { AgentMessage, AgentModelChanged, AgentThreadStatus, ModelsResponse, ToolChoice, AgentConnectionStatus } from "./agent-messages.js";
+import { AgentMessage, AgentModelChanged, AgentThreadStatus, ModelsResponse, ToolChoice, AgentConnectionStatus, AgentClientToolCallRequested } from "./agent-messages.js";
 import type { AgentPayload, JsonMap, ClientToolkitDescription } from "./agent-messages.js";
 import { ChangeEmitter } from "./change-emitter.js";
 export declare class AgentMessageEvent {
@@ -90,6 +90,8 @@ export declare abstract class BaseChatClient extends ChangeEmitter {
     stop(): Promise<void>;
     agentParticipant(): RemoteParticipant | null;
     localParticipantName(): string | undefined;
+    localParticipantId(): string | undefined;
+    isClientToolCallForLocalParticipant(request: InstanceType<typeof AgentClientToolCallRequested>): boolean;
     protected cleanParticipantName(value: string | undefined): string | undefined;
     openThread(threadPath: string, { load, sinceTurn, reloadIfOpen, drainPendingEvents, }?: {
         load?: boolean;
@@ -131,7 +133,30 @@ export declare abstract class BaseChatClient extends ChangeEmitter {
     }): void;
     removeThreadSession(threadPath: string): void;
 }
-export declare class MessagingChatClient extends BaseChatClient {
+export declare const messagingChatThreadSubscribeType = "meshagent.chat.thread.subscribe";
+export declare const messagingChatThreadListSubscribeType = "meshagent.chat.thread_list.subscribe";
+export declare class ThreadSubscribe {
+    readonly threadId: string;
+    readonly stream: MessagingStream;
+    constructor({ threadId, stream }: {
+        threadId: string;
+        stream: MessagingStream;
+    });
+    get closed(): boolean;
+    send(message: AgentMessage, { attachment }?: {
+        attachment?: Uint8Array;
+    }): Promise<void>;
+    close(): Promise<void>;
+}
+export declare class ThreadListSubscribe {
+    readonly stream: MessagingStream;
+    constructor({ stream }: {
+        stream: MessagingStream;
+    });
+    get closed(): boolean;
+    close(): Promise<void>;
+}
+export declare class BaseMessagingChatClient extends BaseChatClient {
     readonly room: RoomClient;
     readonly agentName?: string;
     private readonly pendingParticipantWaits;
@@ -146,6 +171,7 @@ export declare class MessagingChatClient extends BaseChatClient {
         agentName?: string;
     });
     localParticipantName(): string | undefined;
+    localParticipantId(): string | undefined;
     start(): Promise<void>;
     stop(): Promise<void>;
     private attachMessagingListeners;
@@ -164,6 +190,17 @@ export declare class MessagingChatClient extends BaseChatClient {
     private reopenOpenSessions;
     private readonly onMessagingMessage;
 }
+export declare class MessagingChatClient extends BaseMessagingChatClient {
+    private readonly threadSubscriptions;
+    private threadListSubscription?;
+    private readonly streamTasks;
+    stop(): Promise<void>;
+    private supportsThreadSubscriptions;
+    private trackStream;
+    sendAgentMessage(message: AgentMessage, { attachment }?: {
+        attachment?: Uint8Array;
+    }): Promise<void>;
+}
 export declare class ChatThreadSession extends ChangeEmitter {
     private readonly client;
     readonly threadPath: string;
@@ -171,6 +208,8 @@ export declare class ChatThreadSession extends ChangeEmitter {
     private readonly messageIndexes;
     private readonly localAgentMessageIds;
     private readonly pendingLocalInputMessageIds;
+    private readonly resolvedInputMessageIds;
+    private readonly completedTurnIds;
     private readonly mergedDeltaMessageIds;
     private readonly pendingInputsById;
     private openState;

package/dist/browser/chat-client.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChatThreadSession = exports.MessagingChatClient = exports.BaseChatClient = exports.ChatThreadStartResult = exports.ChatThreadSessionLoadState = exports.ChatThreadSessionLoadPhase = exports.PendingAgentInput = exports.AgentMessageEvent = void 0;
+exports.ChatThreadSession = exports.MessagingChatClient = exports.BaseMessagingChatClient = exports.ThreadListSubscribe = exports.ThreadSubscribe = exports.messagingChatThreadListSubscribeType = exports.messagingChatThreadSubscribeType = exports.BaseChatClient = exports.ChatThreadStartResult = exports.ChatThreadSessionLoadState = exports.ChatThreadSessionLoadPhase = exports.PendingAgentInput = exports.AgentMessageEvent = void 0;
 const meshagent_1 = require("@meshagent/meshagent");
 const uuid_1 = require("uuid");
 const agent_messages_js_1 = require("./agent-messages.js");
@@ -175,6 +175,13 @@ class BaseChatClient extends change_emitter_js_1.ChangeEmitter {
     localParticipantName() {
         return undefined;
     }
+    localParticipantId() {
+        return undefined;
+    }
+    isClientToolCallForLocalParticipant(request) {
+        const targetParticipantId = request.targetParticipantId?.trim();
+        return targetParticipantId == null || targetParticipantId === "" || targetParticipantId === this.localParticipantId();
+    }
     cleanParticipantName(value) {
         return nonEmptyTrimmed(value);
     }
@@ -280,6 +287,10 @@ class BaseChatClient extends change_emitter_js_1.ChangeEmitter {
         }
     }
     handleAgentMessage(message, { createdAt, attachment } = {}) {
+        if (message instanceof agent_messages_js_1.AgentClientToolCallRequested &&
+            !this.isClientToolCallForLocalParticipant(message)) {
+            return;
+        }
         if (message.type === agent_messages_js_1.agentConnectionStatusType) {
             this._connectionStatus = message;
         }
@@ -332,7 +343,41 @@ class BaseChatClient extends change_emitter_js_1.ChangeEmitter {
     }
 }
 exports.BaseChatClient = BaseChatClient;
-class MessagingChatClient extends BaseChatClient {
+exports.messagingChatThreadSubscribeType = "meshagent.chat.thread.subscribe";
+exports.messagingChatThreadListSubscribeType = "meshagent.chat.thread_list.subscribe";
+class ThreadSubscribe {
+    constructor({ threadId, stream }) {
+        this.threadId = threadId;
+        this.stream = stream;
+    }
+    get closed() {
+        return this.stream.closed;
+    }
+    async send(message, { attachment } = {}) {
+        await this.stream.sendMessage({
+            type: agent_messages_js_1.agentRoomMessageType,
+            message: message.toJson(),
+            attachment,
+        });
+    }
+    async close() {
+        await this.stream.close();
+    }
+}
+exports.ThreadSubscribe = ThreadSubscribe;
+class ThreadListSubscribe {
+    constructor({ stream }) {
+        this.stream = stream;
+    }
+    get closed() {
+        return this.stream.closed;
+    }
+    async close() {
+        await this.stream.close();
+    }
+}
+exports.ThreadListSubscribe = ThreadListSubscribe;
+class BaseMessagingChatClient extends BaseChatClient {
     constructor({ room, agentName }) {
         super();
         this.pendingParticipantWaits = new Map();
@@ -420,6 +465,9 @@ class MessagingChatClient extends BaseChatClient {
         const name = this.room.localParticipant?.getAttribute("name");
         return typeof name === "string" ? this.cleanParticipantName(name) : undefined;
     }
+    localParticipantId() {
+        return this.room.localParticipant?.id;
+    }
     async start() {
         if (this.started) {
             return;
@@ -546,6 +594,123 @@ class MessagingChatClient extends BaseChatClient {
         }
     }
 }
+exports.BaseMessagingChatClient = BaseMessagingChatClient;
+class MessagingChatClient extends BaseMessagingChatClient {
+    constructor() {
+        super(...arguments);
+        this.threadSubscriptions = new Map();
+        this.streamTasks = new Set();
+    }
+    async stop() {
+        const subscriptions = [
+            ...this.threadSubscriptions.values(),
+        ];
+        if (this.threadListSubscription != null) {
+            subscriptions.push(this.threadListSubscription);
+        }
+        this.threadSubscriptions.clear();
+        this.threadListSubscription = undefined;
+        await Promise.all(subscriptions.map(async (subscription) => subscription.close()));
+        await Promise.all(this.streamTasks);
+        await super.stop();
+    }
+    supportsThreadSubscriptions(participant) {
+        return participant.getAttribute("supports_messaging_streams") === true;
+    }
+    trackStream(subscription) {
+        const task = (async () => {
+            try {
+                for await (const event of subscription.stream) {
+                    if (event.kind !== "message" || event.message.type !== agent_messages_js_1.agentRoomMessageType) {
+                        continue;
+                    }
+                    const raw = event.message.message;
+                    if (typeof raw["type"] !== "string") {
+                        continue;
+                    }
+                    this.handleAgentMessage(agent_messages_js_1.AgentMessage.fromJson(raw), {
+                        createdAt: dateOrNull(raw["created_at"]),
+                        attachment: event.message.attachment,
+                    });
+                }
+            }
+            finally {
+                if (subscription instanceof ThreadSubscribe) {
+                    if (this.threadSubscriptions.get(subscription.threadId) === subscription) {
+                        this.threadSubscriptions.delete(subscription.threadId);
+                    }
+                }
+                else if (this.threadListSubscription === subscription) {
+                    this.threadListSubscription = undefined;
+                }
+            }
+        })();
+        this.streamTasks.add(task);
+        void task.finally(() => this.streamTasks.delete(task));
+    }
+    async sendAgentMessage(message, { attachment } = {}) {
+        await this.start();
+        const participant = this.agentParticipant();
+        if (participant == null) {
+            throw new Error("Agent messaging participant is not available.");
+        }
+        if (!this.supportsThreadSubscriptions(participant)) {
+            await super.sendAgentMessage(message, { attachment });
+            return;
+        }
+        if (message.type === agent_messages_js_1.agentThreadOpenType) {
+            const previous = this.threadSubscriptions.get(message.threadId);
+            if (previous != null) {
+                await previous.close();
+            }
+            const stream = await this.room.messaging.stream({
+                to: participant,
+                type: exports.messagingChatThreadSubscribeType,
+                message: message.toJson(),
+                attachment,
+            });
+            const subscription = new ThreadSubscribe({ threadId: message.threadId, stream });
+            this.threadSubscriptions.set(message.threadId, subscription);
+            this.trackStream(subscription);
+            return;
+        }
+        if (message.type === agent_messages_js_1.agentThreadCloseType) {
+            const subscription = this.threadSubscriptions.get(message.threadId);
+            if (subscription != null) {
+                this.threadSubscriptions.delete(message.threadId);
+                await subscription.close();
+                return;
+            }
+        }
+        if (message.type === agent_messages_js_1.agentThreadWatchType) {
+            await this.threadListSubscription?.close();
+            const stream = await this.room.messaging.stream({
+                to: participant,
+                type: exports.messagingChatThreadListSubscribeType,
+                message: message.toJson(),
+                attachment,
+            });
+            const subscription = new ThreadListSubscribe({ stream });
+            this.threadListSubscription = subscription;
+            this.trackStream(subscription);
+            return;
+        }
+        if (message.type === agent_messages_js_1.agentThreadUnwatchType && this.threadListSubscription != null) {
+            const subscription = this.threadListSubscription;
+            this.threadListSubscription = undefined;
+            await subscription.close();
+            return;
+        }
+        if ("threadId" in message && typeof message.threadId === "string") {
+            const subscription = this.threadSubscriptions.get(message.threadId);
+            if (subscription != null) {
+                await subscription.send(message, { attachment });
+                return;
+            }
+        }
+        await super.sendAgentMessage(message, { attachment });
+    }
+}
 exports.MessagingChatClient = MessagingChatClient;
 function isThreadListMessage(message) {
     return message.type === agent_messages_js_1.agentThreadListedType
@@ -560,6 +725,8 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
         this.messageIndexes = new Map();
         this.localAgentMessageIds = new Set();
         this.pendingLocalInputMessageIds = new Set();
+        this.resolvedInputMessageIds = new Set();
+        this.completedTurnIds = new Set();
         this.mergedDeltaMessageIds = new Set();
         this.pendingInputsById = new Map();
         this.openState = false;
@@ -638,6 +805,8 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
         this.messageIndexes.clear();
         this.localAgentMessageIds.clear();
         this.pendingLocalInputMessageIds.clear();
+        this.resolvedInputMessageIds.clear();
+        this.completedTurnIds.clear();
         this.mergedDeltaMessageIds.clear();
         this.pendingInputsById.clear();
         this.lastCompletedTurnIdValue = undefined;
@@ -789,15 +958,19 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
             return;
         }
         if (message.type === agent_messages_js_1.agentThreadStatusType && message instanceof agent_messages_js_1.AgentThreadStatus) {
-            this.threadStatusValue = message;
             const mode = normalizedString(message.mode);
             const status = normalizedString(message.status);
             const turnId = normalizedString(message.turnId);
-            if (status != null && mode === "steerable" && turnId != null) {
-                this.activeTurnIdValue = turnId;
+            if (status == null) {
+                this.threadStatusValue = undefined;
+                if (turnId != null && this.activeTurnIdValue === turnId) {
+                    this.activeTurnIdValue = undefined;
+                }
+                return;
             }
-            else if (status == null && turnId != null && this.activeTurnIdValue === turnId) {
-                this.activeTurnIdValue = undefined;
+            this.threadStatusValue = message;
+            if (mode === "steerable" && turnId != null) {
+                this.activeTurnIdValue = turnId;
             }
             return;
         }
@@ -825,21 +998,29 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
     updatePendingInputsForMessage(message, createdAt) {
         const type = message.type;
         const messageId = message.messageId;
-        const sourceMessageId = sourceMessageIdFor(message);
+        const sourceMessageId = normalizedString(sourceMessageIdFor(message));
         if (type === agent_messages_js_1.agentThreadStartType || type === agent_messages_js_1.agentTurnStartType || type === agent_messages_js_1.agentTurnSteerType) {
             const normalizedMessageId = messageId.trim();
             if (normalizedMessageId !== "") {
+                const wasPending = this.pendingInputsById.has(normalizedMessageId);
+                const turnId = type === agent_messages_js_1.agentTurnStartType || type === agent_messages_js_1.agentTurnSteerType
+                    ? normalizedString(threadMessageValue(message, "turnId"))
+                    : undefined;
+                const wasAlreadyResolved = !wasPending && (this.resolvedInputMessageIds.has(normalizedMessageId) ||
+                    (turnId != null && this.completedTurnIds.has(turnId)));
                 this.localAgentMessageIds.add(normalizedMessageId);
                 this.pendingLocalInputMessageIds.add(normalizedMessageId);
-                this.markPending(new PendingAgentInput({
-                    messageId: normalizedMessageId,
-                    messageType: type,
-                    threadPath: this.threadPath,
-                    payload: message,
-                    createdAt,
-                    awaitingAcceptance: true,
-                    awaitingApplication: true,
-                }));
+                if (!wasAlreadyResolved) {
+                    this.markPending(new PendingAgentInput({
+                        messageId: normalizedMessageId,
+                        messageType: type,
+                        threadPath: this.threadPath,
+                        payload: message,
+                        createdAt,
+                        awaitingAcceptance: true,
+                        awaitingApplication: true,
+                    }));
+                }
             }
         }
         else if (type === agent_messages_js_1.agentThreadStartRejectedType) {
@@ -852,12 +1033,14 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
         }
         else if (type === agent_messages_js_1.agentTurnStartedType || type === agent_messages_js_1.agentTurnSteeredType) {
             if (sourceMessageId != null) {
+                this.resolvedInputMessageIds.add(sourceMessageId);
                 this.pendingInputsById.delete(sourceMessageId);
                 this.pendingLocalInputMessageIds.delete(sourceMessageId);
             }
         }
         else if (type === agent_messages_js_1.agentTurnStartRejectedType || type === agent_messages_js_1.agentTurnSteerRejectedType) {
             if (sourceMessageId != null) {
+                this.resolvedInputMessageIds.add(sourceMessageId);
                 this.pendingInputsById.delete(sourceMessageId);
                 this.pendingLocalInputMessageIds.delete(sourceMessageId);
             }
@@ -865,6 +1048,15 @@ class ChatThreadSession extends change_emitter_js_1.ChangeEmitter {
         else if (type === agent_messages_js_1.agentTurnEndedType || type === agent_messages_js_1.agentThreadClearedType) {
             this.pendingInputsById.clear();
             this.pendingLocalInputMessageIds.clear();
+            if (type === agent_messages_js_1.agentTurnEndedType) {
+                const turnId = normalizedString(threadMessageValue(message, "turnId"));
+                if (turnId != null)
+                    this.completedTurnIds.add(turnId);
+            }
+            else if (type === agent_messages_js_1.agentThreadClearedType) {
+                this.resolvedInputMessageIds.clear();
+                this.completedTurnIds.clear();
+            }
         }
     }
     appendRenderableMessage(event) {

package/dist/esm/agent-messages.js

@@ -721,26 +721,16 @@ function makeMessageClass({ type, base = "message", fields = [], }) {
                 params.model = stringOrNull(json.model);
             }
             for (const field of fields) {
-                if (field.required) {
-                    if (field.from != null) {
-                        params[field.prop] = field.from(json[field.json], json);
+                if (!hasOwn(json, field.json)) {
+                    if (field.required) {
+                        if (field.from != null) {
+                            field.from(undefined, json);
+                        }
+                        throw new TypeError(`missing required field '${field.json}'`);
                     }
-                    else if (typeof json[field.json] === "string") {
-                        params[field.prop] = requiredString(json, field.json);
-                    }
-                    else if (typeof json[field.json] === "number") {
-                        params[field.prop] = json[field.json];
-                    }
-                    else {
-                        params[field.prop] = requiredMap(json, field.json);
-                    }
-                }
-                else if (hasOwn(json, field.json)) {
-                    params[field.prop] = field.from != null ? field.from(json[field.json], json) : json[field.json];
-                }
-                else if (field.default != null) {
-                    params[field.prop] = field.default(json);
+                    continue;
                 }
+                params[field.prop] = json[field.json];
             }
             return new this(params);
         }
@@ -964,10 +954,10 @@ export const AgentToolCallLogDelta = makeMessageClass({ type: agentToolCallLogDe
 export const AgentToolCallEnded = makeMessageClass({ type: agentToolCallEndedType, base: "llm", fields: [...contentPart, { prop: "namespace", json: "namespace", from: (value) => stringOrNull(value) ?? "meshagent", default: () => "meshagent", always: true }, s("callId"), s("toolkit"), s("tool"), { prop: "result", json: "result", from: contentOrNull, to: contentHeader }, obj("error", "error", AgentError.fromJson)] });
 export const AgentToolCallApprovalRequested = makeMessageClass({ type: agentToolCallApprovalRequestedType, base: "llm", fields: toolState.filter((field) => field.prop !== "argumentBytes") });
 export const AgentSecretRequested = makeMessageClass({ type: agentSecretRequestedType, base: "llm", fields: [...contentPart, s("requestId", "request_id", true), s("name", "name", true), s("scope")] });
-export const AgentClientToolCallRequested = makeMessageClass({ type: agentClientToolCallRequestedType, base: "llm", fields: [...contentPart, s("requestId", "request_id", true), s("toolkit", "toolkit", true), s("tool", "tool", true), m("arguments", "arguments", true)] });
-export const AgentClientToolCallCancelled = makeMessageClass({ type: agentClientToolCallCancelledType, base: "llm", fields: [...contentPart, s("requestId", "request_id", true), s("reason")] });
+export const AgentClientToolCallRequested = makeMessageClass({ type: agentClientToolCallRequestedType, base: "llm", fields: [...contentPart, s("requestId", "request_id", true), s("targetParticipantId"), s("toolkit", "toolkit", true), s("tool", "tool", true), m("arguments", "arguments", true)] });
+export const AgentClientToolCallCancelled = makeMessageClass({ type: agentClientToolCallCancelledType, base: "llm", fields: [...contentPart, s("requestId", "request_id", true), s("targetParticipantId"), s("reason")] });
 export const AgentThreadStatus = makeMessageClass({ type: agentThreadStatusType, base: "thread", fields: [s("status"), s("mode"), s("startedAt"), s("turnId"), s("pendingItemId"), i("totalBytes"), i("linesAdded"), i("linesRemoved")] });
-export const AgentConnectionStatus = makeMessageClass({ type: agentConnectionStatusType, fields: [s("status", "status", true), s("message"), s("reason"), n("retryInSeconds")] });
+export const AgentConnectionStatus = makeMessageClass({ type: agentConnectionStatusType, fields: [s("status", "status", true), s("message"), s("reason"), n("retryInSeconds"), s("participantId")] });
 export const AgentThreadEvent = makeMessageClass({ type: agentThreadEventType, base: "llm", fields: [m("event", "event", true)] });
 export const AgentImageGenerationStarted = makeMessageClass({ type: agentImageGenerationStartedType, base: "llm", fields: imageGeneration });
 export const AgentImageGenerationPartial = makeMessageClass({ type: agentImageGenerationPartialType, base: "llm", fields: [...imageGeneration, obj("image", "image", AgentGeneratedImage.fromJson), i("partialIndex")] });

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

@@ -1,6 +1,6 @@
-import { RemoteParticipant } from "@meshagent/meshagent";
+import { MessagingStream, RemoteParticipant } from "@meshagent/meshagent";
 import type { RoomClient, Content } from "@meshagent/meshagent";
-import { AgentMessage, AgentModelChanged, AgentThreadStatus, ModelsResponse, ToolChoice, AgentConnectionStatus } from "./agent-messages.js";
+import { AgentMessage, AgentModelChanged, AgentThreadStatus, ModelsResponse, ToolChoice, AgentConnectionStatus, AgentClientToolCallRequested } from "./agent-messages.js";
 import type { AgentPayload, JsonMap, ClientToolkitDescription } from "./agent-messages.js";
 import { ChangeEmitter } from "./change-emitter.js";
 export declare class AgentMessageEvent {
@@ -90,6 +90,8 @@ export declare abstract class BaseChatClient extends ChangeEmitter {
     stop(): Promise<void>;
     agentParticipant(): RemoteParticipant | null;
     localParticipantName(): string | undefined;
+    localParticipantId(): string | undefined;
+    isClientToolCallForLocalParticipant(request: InstanceType<typeof AgentClientToolCallRequested>): boolean;
     protected cleanParticipantName(value: string | undefined): string | undefined;
     openThread(threadPath: string, { load, sinceTurn, reloadIfOpen, drainPendingEvents, }?: {
         load?: boolean;
@@ -131,7 +133,30 @@ export declare abstract class BaseChatClient extends ChangeEmitter {
     }): void;
     removeThreadSession(threadPath: string): void;
 }
-export declare class MessagingChatClient extends BaseChatClient {
+export declare const messagingChatThreadSubscribeType = "meshagent.chat.thread.subscribe";
+export declare const messagingChatThreadListSubscribeType = "meshagent.chat.thread_list.subscribe";
+export declare class ThreadSubscribe {
+    readonly threadId: string;
+    readonly stream: MessagingStream;
+    constructor({ threadId, stream }: {
+        threadId: string;
+        stream: MessagingStream;
+    });
+    get closed(): boolean;
+    send(message: AgentMessage, { attachment }?: {
+        attachment?: Uint8Array;
+    }): Promise<void>;
+    close(): Promise<void>;
+}
+export declare class ThreadListSubscribe {
+    readonly stream: MessagingStream;
+    constructor({ stream }: {
+        stream: MessagingStream;
+    });
+    get closed(): boolean;
+    close(): Promise<void>;
+}
+export declare class BaseMessagingChatClient extends BaseChatClient {
     readonly room: RoomClient;
     readonly agentName?: string;
     private readonly pendingParticipantWaits;
@@ -146,6 +171,7 @@ export declare class MessagingChatClient extends BaseChatClient {
         agentName?: string;
     });
     localParticipantName(): string | undefined;
+    localParticipantId(): string | undefined;
     start(): Promise<void>;
     stop(): Promise<void>;
     private attachMessagingListeners;
@@ -164,6 +190,17 @@ export declare class MessagingChatClient extends BaseChatClient {
     private reopenOpenSessions;
     private readonly onMessagingMessage;
 }
+export declare class MessagingChatClient extends BaseMessagingChatClient {
+    private readonly threadSubscriptions;
+    private threadListSubscription?;
+    private readonly streamTasks;
+    stop(): Promise<void>;
+    private supportsThreadSubscriptions;
+    private trackStream;
+    sendAgentMessage(message: AgentMessage, { attachment }?: {
+        attachment?: Uint8Array;
+    }): Promise<void>;
+}
 export declare class ChatThreadSession extends ChangeEmitter {
     private readonly client;
     readonly threadPath: string;
@@ -171,6 +208,8 @@ export declare class ChatThreadSession extends ChangeEmitter {
     private readonly messageIndexes;
     private readonly localAgentMessageIds;
     private readonly pendingLocalInputMessageIds;
+    private readonly resolvedInputMessageIds;
+    private readonly completedTurnIds;
     private readonly mergedDeltaMessageIds;
     private readonly pendingInputsById;
     private openState;