@meshagent/meshagent-agents 0.46.3 → 0.47.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [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 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;
@@ -146,6 +148,7 @@ export declare class MessagingChatClient extends BaseChatClient {
         agentName?: string;
     });
     localParticipantName(): string | undefined;
+    localParticipantId(): string | undefined;
     start(): Promise<void>;
     stop(): Promise<void>;
     private attachMessagingListeners;
@@ -171,6 +174,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

@@ -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;
         }
@@ -420,6 +431,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;
@@ -560,6 +574,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 +654,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 +807,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 +847,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 +882,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 +897,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 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;
@@ -146,6 +148,7 @@ export declare class MessagingChatClient extends BaseChatClient {
         agentName?: string;
     });
     localParticipantName(): string | undefined;
+    localParticipantId(): string | undefined;
     start(): Promise<void>;
     stop(): Promise<void>;
     private attachMessagingListeners;
@@ -171,6 +174,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/esm/chat-client.js

@@ -168,6 +168,13 @@ export class BaseChatClient extends 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);
     }
@@ -273,6 +280,10 @@ export class BaseChatClient extends ChangeEmitter {
         }
     }
     handleAgentMessage(message, { createdAt, attachment } = {}) {
+        if (message instanceof AgentClientToolCallRequested &&
+            !this.isClientToolCallForLocalParticipant(message)) {
+            return;
+        }
         if (message.type === agentConnectionStatusType) {
             this._connectionStatus = message;
         }
@@ -412,6 +423,9 @@ export 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;
@@ -551,6 +565,8 @@ export class ChatThreadSession extends 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;
@@ -629,6 +645,8 @@ export class ChatThreadSession extends 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;
@@ -780,15 +798,19 @@ export class ChatThreadSession extends ChangeEmitter {
             return;
         }
         if (message.type === agentThreadStatusType && message instanceof 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;
         }
@@ -816,21 +838,29 @@ export class ChatThreadSession extends ChangeEmitter {
     updatePendingInputsForMessage(message, createdAt) {
         const type = message.type;
         const messageId = message.messageId;
-        const sourceMessageId = sourceMessageIdFor(message);
+        const sourceMessageId = normalizedString(sourceMessageIdFor(message));
         if (type === agentThreadStartType || type === agentTurnStartType || type === agentTurnSteerType) {
             const normalizedMessageId = messageId.trim();
             if (normalizedMessageId !== "") {
+                const wasPending = this.pendingInputsById.has(normalizedMessageId);
+                const turnId = type === agentTurnStartType || type === 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 === agentThreadStartRejectedType) {
@@ -843,12 +873,14 @@ export class ChatThreadSession extends ChangeEmitter {
         }
         else if (type === agentTurnStartedType || type === agentTurnSteeredType) {
             if (sourceMessageId != null) {
+                this.resolvedInputMessageIds.add(sourceMessageId);
                 this.pendingInputsById.delete(sourceMessageId);
                 this.pendingLocalInputMessageIds.delete(sourceMessageId);
             }
         }
         else if (type === agentTurnStartRejectedType || type === agentTurnSteerRejectedType) {
             if (sourceMessageId != null) {
+                this.resolvedInputMessageIds.add(sourceMessageId);
                 this.pendingInputsById.delete(sourceMessageId);
                 this.pendingLocalInputMessageIds.delete(sourceMessageId);
             }
@@ -856,6 +888,15 @@ export class ChatThreadSession extends ChangeEmitter {
         else if (type === agentTurnEndedType || type === agentThreadClearedType) {
             this.pendingInputsById.clear();
             this.pendingLocalInputMessageIds.clear();
+            if (type === agentTurnEndedType) {
+                const turnId = normalizedString(threadMessageValue(message, "turnId"));
+                if (turnId != null)
+                    this.completedTurnIds.add(turnId);
+            }
+            else if (type === agentThreadClearedType) {
+                this.resolvedInputMessageIds.clear();
+                this.completedTurnIds.clear();
+            }
         }
     }
     appendRenderableMessage(event) {

package/dist/node/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/node/chat-client.d.ts

@@ -1,6 +1,6 @@
 import { 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;
@@ -146,6 +148,7 @@ export declare class MessagingChatClient extends BaseChatClient {
         agentName?: string;
     });
     localParticipantName(): string | undefined;
+    localParticipantId(): string | undefined;
     start(): Promise<void>;
     stop(): Promise<void>;
     private attachMessagingListeners;
@@ -171,6 +174,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/node/chat-client.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;
         }
@@ -420,6 +431,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;
@@ -560,6 +574,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 +654,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 +807,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 +847,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 +882,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 +897,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/package.json

@@ -1,10 +1,11 @@
 {
     "name": "@meshagent/meshagent-agents",
-    "version": "0.46.3",
+    "version": "0.47.0",
     "description": "Agent chat sessions and clients for Meshagent TypeScript applications.",
     "homepage": "https://github.com/meshagent/meshagent-agents-ts",
     "scripts": {
         "test": "./run-tests.sh",
+        "test:rust-process-e2e": "bash ./run-rust-process-agent-e2e.sh",
         "build": "mkdir -p dist && ./scripts/build.sh"
     },
     "author": "Timu, LLC",
@@ -47,7 +48,7 @@
         "typescript": "^5.8.2"
     },
     "dependencies": {
-        "@meshagent/meshagent": "^0.46.3",
+        "@meshagent/meshagent": "^0.47.0",
         "apache-arrow": "^21.0.0",
         "uuid": "^14.0.0"
     },