feat: adds support for IUM

Author: jpvajda

src/packages/AgentLiveClient.ts

@@ -140,6 +140,17 @@ export class AgentLiveClient extends AbstractLiveClient {
     this.send(JSON.stringify({ type: "InjectAgentMessage", content }));
   }
 
+  /**
+   * Send a text-based message to the agent as if it came from the user.
+   * This allows you to inject user messages into the conversation for the agent to respond to.
+   * @example "Hello! Can you hear me?"
+   * @example "What's the weather like today?"
+   * @param content - The specific phrase or statement the agent should respond to.
+   */
+  public injectUserMessage(content: string): void {
+    this.send(JSON.stringify({ type: "InjectUserMessage", content }));
+  }
+
   /**
    * Respond to a function call request.
    * @param response  - The response to the function call request.

tests/unit/live-client-message-handling.test.ts

@@ -536,5 +536,33 @@ describe("Unit Tests - Live Client Message Handling", () => {
 
       expect(mockConnection.send).toHaveBeenCalledWith(JSON.stringify({ type: "KeepAlive" }));
     });
+
+    it("should send injectUserMessage correctly", () => {
+      const content = "Hello! Can you hear me?";
+      client.injectUserMessage(content);
+
+      expect(mockConnection.send).toHaveBeenCalledWith(
+        JSON.stringify({ type: "InjectUserMessage", content })
+      );
+    });
+
+    it("should send injectUserMessage with different content types", () => {
+      const testCases = [
+        "What's the weather like today?",
+        "Simple greeting",
+        "Multi-line\nmessage content",
+        "", // Edge case: empty string
+      ];
+
+      testCases.forEach((content) => {
+        jest.clearAllMocks(); // Reset mock between test cases
+
+        client.injectUserMessage(content);
+
+        expect(mockConnection.send).toHaveBeenCalledWith(
+          JSON.stringify({ type: "InjectUserMessage", content })
+        );
+      });
+    });
   });
 });