@agentica/core 0.32.1 → 0.32.3-dev.1

package/lib/utils/__retry.spec.js

@@ -0,0 +1,172 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const __retry_1 = require("./__retry");
+describe("__get_retry", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe("success cases", () => {
+        it("should not retry when successful on first attempt", () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockFn = vi.fn().mockResolvedValue("success");
+            const retryFn = (0, __retry_1.__get_retry)(3);
+            const result = yield retryFn(mockFn);
+            expect(result).toBe("success");
+            expect(mockFn).toHaveBeenCalledTimes(1);
+            expect(mockFn).toHaveBeenCalledWith(undefined);
+        }));
+        it("should call exactly 2 times when successful on second attempt", () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockFn = vi.fn()
+                .mockRejectedValueOnce(new Error("First failure"))
+                .mockResolvedValue("success");
+            const retryFn = (0, __retry_1.__get_retry)(3);
+            const result = yield retryFn(mockFn);
+            expect(result).toBe("success");
+            expect(mockFn).toHaveBeenCalledTimes(2);
+            expect(mockFn).toHaveBeenNthCalledWith(1, undefined);
+            expect(mockFn).toHaveBeenNthCalledWith(2, new Error("First failure"));
+        }));
+        it("should call limit times when successful on last attempt", () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockFn = vi.fn()
+                .mockRejectedValueOnce(new Error("First failure"))
+                .mockRejectedValueOnce(new Error("Second failure"))
+                .mockResolvedValue("success");
+            const retryFn = (0, __retry_1.__get_retry)(3);
+            const result = yield retryFn(mockFn);
+            expect(result).toBe("success");
+            expect(mockFn).toHaveBeenCalledTimes(3);
+            expect(mockFn).toHaveBeenNthCalledWith(1, undefined);
+            expect(mockFn).toHaveBeenNthCalledWith(2, new Error("First failure"));
+            expect(mockFn).toHaveBeenNthCalledWith(3, new Error("Second failure"));
+        }));
+    });
+    describe("failure cases", () => {
+        it("should throw last error after limit attempts", () => __awaiter(void 0, void 0, void 0, function* () {
+            const error1 = new Error("First failure");
+            const error2 = new Error("Second failure");
+            const error3 = new Error("Third failure");
+            const mockFn = vi.fn()
+                .mockRejectedValueOnce(error1)
+                .mockRejectedValueOnce(error2)
+                .mockRejectedValueOnce(error3);
+            const retryFn = (0, __retry_1.__get_retry)(3);
+            yield expect(retryFn(mockFn)).rejects.toThrow("Third failure");
+            expect(mockFn).toHaveBeenCalledTimes(3);
+            expect(mockFn).toHaveBeenNthCalledWith(1, undefined);
+            expect(mockFn).toHaveBeenNthCalledWith(2, error1);
+            expect(mockFn).toHaveBeenNthCalledWith(3, error2);
+        }));
+        it("should throw error immediately when limit is 1", () => __awaiter(void 0, void 0, void 0, function* () {
+            const error = new Error("Immediate failure");
+            const mockFn = vi.fn().mockRejectedValue(error);
+            const retryFn = (0, __retry_1.__get_retry)(1);
+            yield expect(retryFn(mockFn)).rejects.toThrow("Immediate failure");
+            expect(mockFn).toHaveBeenCalledTimes(1);
+            expect(mockFn).toHaveBeenCalledWith(undefined);
+        }));
+    });
+    describe("prevError propagation", () => {
+        it("should pass previous error as prevError correctly", () => __awaiter(void 0, void 0, void 0, function* () {
+            const error1 = new Error("First error");
+            const error2 = new Error("Second error");
+            const mockFn = vi.fn()
+                .mockRejectedValueOnce(error1)
+                .mockRejectedValueOnce(error2)
+                .mockResolvedValue("success");
+            const retryFn = (0, __retry_1.__get_retry)(3);
+            const result = yield retryFn(mockFn);
+            expect(result).toBe("success");
+            expect(mockFn).toHaveBeenCalledTimes(3);
+            expect(mockFn).toHaveBeenNthCalledWith(1, undefined);
+            expect(mockFn).toHaveBeenNthCalledWith(2, error1);
+            expect(mockFn).toHaveBeenNthCalledWith(3, error2);
+        }));
+        it("should use initial prevError in first call when provided", () => __awaiter(void 0, void 0, void 0, function* () {
+            const initialError = new Error("Initial error");
+            const mockFn = vi.fn().mockResolvedValue("success");
+            const retryFn = (0, __retry_1.__get_retry)(3);
+            const result = yield retryFn(mockFn, initialError);
+            expect(result).toBe("success");
+            expect(mockFn).toHaveBeenCalledTimes(1);
+            expect(mockFn).toHaveBeenCalledWith(initialError);
+        }));
+    });
+    describe("different error types", () => {
+        it("should handle string errors correctly", () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockFn = vi.fn()
+                .mockRejectedValueOnce("String error")
+                .mockResolvedValue("success");
+            const retryFn = (0, __retry_1.__get_retry)(2);
+            const result = yield retryFn(mockFn);
+            expect(result).toBe("success");
+            expect(mockFn).toHaveBeenCalledTimes(2);
+            expect(mockFn).toHaveBeenNthCalledWith(2, "String error");
+        }));
+        it("should handle null errors correctly", () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockFn = vi.fn()
+                .mockRejectedValueOnce(null)
+                .mockResolvedValue("success");
+            const retryFn = (0, __retry_1.__get_retry)(2);
+            const result = yield retryFn(mockFn);
+            expect(result).toBe("success");
+            expect(mockFn).toHaveBeenCalledTimes(2);
+            expect(mockFn).toHaveBeenNthCalledWith(2, null);
+        }));
+        it("should handle undefined errors correctly", () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockFn = vi.fn()
+                .mockRejectedValueOnce(undefined)
+                .mockResolvedValue("success");
+            const retryFn = (0, __retry_1.__get_retry)(2);
+            const result = yield retryFn(mockFn);
+            expect(result).toBe("success");
+            expect(mockFn).toHaveBeenCalledTimes(2);
+            expect(mockFn).toHaveBeenNthCalledWith(2, undefined);
+        }));
+    });
+    describe("recursive call verification", () => {
+        it("should occur recursive calls in correct order", () => __awaiter(void 0, void 0, void 0, function* () {
+            const callOrder = [];
+            const mockFn = vi.fn()
+                .mockImplementationOnce(() => {
+                callOrder.push("first call");
+                throw new Error("First failure");
+            })
+                .mockImplementationOnce(() => {
+                callOrder.push("second call");
+                throw new Error("Second failure");
+            })
+                .mockImplementationOnce(() => __awaiter(void 0, void 0, void 0, function* () {
+                callOrder.push("third call");
+                return Promise.resolve("success");
+            }));
+            const retryFn = (0, __retry_1.__get_retry)(3);
+            const result = yield retryFn(mockFn);
+            expect(result).toBe("success");
+            expect(callOrder).toEqual(["first call", "second call", "third call"]);
+            expect(mockFn).toHaveBeenCalledTimes(3);
+        }));
+    });
+    describe("type safety", () => {
+        it("should handle different return types correctly", () => __awaiter(void 0, void 0, void 0, function* () {
+            const stringFn = vi.fn().mockResolvedValue("string result");
+            const numberFn = vi.fn().mockResolvedValue(42);
+            const objectFn = vi.fn().mockResolvedValue({ key: "value" });
+            const retryFn = (0, __retry_1.__get_retry)(3);
+            const stringResult = yield retryFn(stringFn);
+            const numberResult = yield retryFn(numberFn);
+            const objectResult = yield retryFn(objectFn);
+            expect(stringResult).toBe("string result");
+            expect(numberResult).toBe(42);
+            expect(objectResult).toEqual({ key: "value" });
+        }));
+    });
+});
+//# sourceMappingURL=__retry.spec.js.map

package/lib/utils/__retry.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"__retry.spec.js","sourceRoot":"","sources":["../../src/utils/__retry.spec.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentica/core",
-  "version": "0.32.1",
+  "version": "0.32.3-dev.1",
   "description": "Agentic AI Library specialized in LLM Function Calling",
   "author": "Wrtn Technologies",
   "license": "MIT",

package/src/orchestrate/call.ts

@@ -23,9 +23,11 @@ import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
 import { isAgenticaContext } from "../context/internal/isAgenticaContext";
 import { createAssistantMessageEvent, createCallEvent, createExecuteEvent, createJsonParseErrorEvent, createValidateEvent } from "../factory/events";
 import { decodeHistory, decodeUserMessageContent } from "../factory/histories";
-import { MPSC } from "../utils";
+import { __get_retry } from "../utils/__retry";
+import { AssistantMessageEmptyError, AssistantMessageEmptyWithReasoningError } from "../utils/AssistantMessageEmptyError";
 import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
-import { streamDefaultReaderToAsyncGenerator, StreamUtil, toAsyncGenerator } from "../utils/StreamUtil";
+import { reduceStreamingWithDispatch } from "../utils/ChatGptCompletionStreamingUtil";
+import { StreamUtil, toAsyncGenerator } from "../utils/StreamUtil";
 
 import { cancelFunctionFromContext } from "./internal/cancelFunctionFromContext";
 
@@ -33,131 +35,103 @@ export async function call<Model extends ILlmSchema.Model>(
   ctx: AgenticaContext<Model> | MicroAgenticaContext<Model>,
   operations: AgenticaOperation<Model>[],
 ): Promise<AgenticaExecuteEvent<Model>[]> {
-  const stream: ReadableStream<OpenAI.ChatCompletionChunk> = await ctx.request("call", {
-    messages: [
-      // COMMON SYSTEM PROMPT
-      {
-        role: "system",
-        content: AgenticaDefaultPrompt.write(ctx.config),
-      } satisfies OpenAI.ChatCompletionSystemMessageParam,
-      // PREVIOUS HISTORIES
-      ...ctx.histories.map(decodeHistory).flat(),
-      // USER INPUT
-      {
-        role: "user",
-        content: ctx.prompt.contents.map(decodeUserMessageContent),
-      },
-      // SYSTEM PROMPT
-      ...(ctx.config?.systemPrompt?.execute === null
-        ? []
-        : [{
-          role: "system",
-          content: ctx.config?.systemPrompt?.execute?.(ctx.histories as MicroAgenticaHistory<Model>[])
-            ?? AgenticaSystemPrompt.EXECUTE,
-        } satisfies OpenAI.ChatCompletionSystemMessageParam]),
-    ],
-    // STACKED FUNCTIONS
-    tools: operations.map(
-      s =>
-        ({
-          type: "function",
-          function: {
-            name: s.name,
-
-            description: s.function.description,
-            parameters: (
-              (
-                "separated" in s.function
-                && s.function.separated !== undefined
-              )
-                ? (s.function.separated.llm
-                  ?? ({
-                    type: "object",
-                    properties: {},
-                    required: [],
-                    additionalProperties: false,
-                    $defs: {},
-                  } satisfies IChatGptSchema.IParameters))
-
-                : s.function.parameters) as Record<string, any>,
-          },
-        }) as OpenAI.ChatCompletionTool,
-    ),
-    tool_choice: "auto",
-    // parallel_tool_calls: false,
-  });
-
-  const selectContext: ({
-    content: string;
-    mpsc: MPSC<string>;
-  })[] = [];
-  const nullableCompletion = await StreamUtil.reduce<OpenAI.ChatCompletionChunk, Promise<OpenAI.ChatCompletion>>(stream, async (accPromise, chunk) => {
-    const acc = await accPromise;
-
-    const registerContext = (
-      choices: OpenAI.ChatCompletionChunk.Choice[],
-    ) => {
-      for (const choice of choices) {
-        /**
-         * @TODO fix it
-         * Sometimes, the complete message arrives along with a finish reason.
-         */
-        if (choice.finish_reason != null) {
-          selectContext[choice.index]?.mpsc.close();
-          continue;
-        }
+  const _retryFn = __get_retry(ctx.config?.retry ?? AgenticaConstant.RETRY);
+  const retryFn = async (fn: (prevError?: unknown) => Promise<OpenAI.ChatCompletion>) => {
+    return _retryFn(fn).catch((e) => {
+      if (e instanceof AssistantMessageEmptyError) {
+        return Symbol("emptyAssistantMessage");
+      }
+      throw e;
+    });
+  };
 
-        if (choice.delta.content == null || choice.delta.content === "") {
-          continue;
-        }
+  const completion = await retryFn(async (prevError) => {
+    const stream: ReadableStream<OpenAI.ChatCompletionChunk> = await ctx.request("call", {
+      messages: [
+        // COMMON SYSTEM PROMPT
+        {
+          role: "system",
+          content: AgenticaDefaultPrompt.write(ctx.config),
+        } satisfies OpenAI.ChatCompletionSystemMessageParam,
+        // PREVIOUS HISTORIES
+        ...ctx.histories.map(decodeHistory).flat(),
+        // USER INPUT
+        {
+          role: "user",
+          content: ctx.prompt.contents.map(decodeUserMessageContent),
+        },
+        ...(prevError instanceof AssistantMessageEmptyWithReasoningError ? [
+          {
+            role: "assistant",
+            content: prevError.reasoning,
+          } satisfies OpenAI.ChatCompletionMessageParam,
+        ] : []),
+        // SYSTEM PROMPT
+        ...(ctx.config?.systemPrompt?.execute === null
+          ? []
+          : [{
+            role: "system",
+            content: ctx.config?.systemPrompt?.execute?.(ctx.histories as MicroAgenticaHistory<Model>[])
+              ?? AgenticaSystemPrompt.EXECUTE,
+          } satisfies OpenAI.ChatCompletionSystemMessageParam]),
+      ],
+      // STACKED FUNCTIONS
+      tools: operations.map(
+        s =>
+          ({
+            type: "function",
+            function: {
+              name: s.name,
 
-        if (selectContext[choice.index] != null) {
-          selectContext[choice.index]!.content += choice.delta.content;
-          selectContext[choice.index]!.mpsc.produce(choice.delta.content);
-          continue;
-        }
+              description: s.function.description,
+              parameters: (
+                (
+                  "separated" in s.function
+                  && s.function.separated !== undefined
+                )
+                  ? (s.function.separated.llm
+                    ?? ({
+                      type: "object",
+                      properties: {},
+                      required: [],
+                      additionalProperties: false,
+                      $defs: {},
+                    } satisfies IChatGptSchema.IParameters))
 
-        const mpsc = new MPSC<string>();
+                  : s.function.parameters) as Record<string, any>,
+            },
+          }) as OpenAI.ChatCompletionTool,
+      ),
+      tool_choice: "auto",
+      // parallel_tool_calls: false,
+    });
 
-        selectContext[choice.index] = {
-          content: choice.delta.content,
-          mpsc,
-        };
-        mpsc.produce(choice.delta.content);
+    const completion = await reduceStreamingWithDispatch(stream, (props) => {
+      const event: AgenticaAssistantMessageEvent = createAssistantMessageEvent(props);
+      ctx.dispatch(event);
+    });
 
-        const event: AgenticaAssistantMessageEvent = createAssistantMessageEvent({
-          stream: streamDefaultReaderToAsyncGenerator(mpsc.consumer.getReader()),
-          done: () => mpsc.done(),
-          get: () => selectContext[choice.index]?.content ?? "",
-          join: async () => {
-            await mpsc.waitClosed();
-            return selectContext[choice.index]!.content;
-          },
-        });
-        ctx.dispatch(event);
+    const allAssistantMessagesEmpty = completion.choices.every(v => v.message.tool_calls == null && v.message.content === "");
+    if (allAssistantMessagesEmpty) {
+      const firstChoice = completion.choices.at(0);
+      if ((firstChoice?.message as { reasoning?: string })?.reasoning != null) {
+        throw new AssistantMessageEmptyWithReasoningError((firstChoice?.message as { reasoning?: string })?.reasoning ?? "");
       }
-    };
-    if (acc.object === "chat.completion.chunk") {
-      registerContext([acc, chunk].flatMap(v => v.choices));
-      return ChatGptCompletionMessageUtil.merge([acc, chunk]);
+      throw new AssistantMessageEmptyError();
     }
-    registerContext(chunk.choices);
-    return ChatGptCompletionMessageUtil.accumulate(acc, chunk);
+    return completion;
   });
-  const completion = nullableCompletion!;
-  const emptyAssistantMessages = completion.choices.filter(v => v.message.tool_calls == null && v.message.content === "");
-  if(emptyAssistantMessages.length > 0) {
-    emptyAssistantMessages.forEach(v => {
+
+  if (typeof completion === "symbol") {
     const event: AgenticaAssistantMessageEvent = createAssistantMessageEvent({
-      stream: toAsyncGenerator(v.message.content ?? ""),
+      stream: toAsyncGenerator(""),
       done: () => true,
-      get: () => v.message.content ?? "",
+      get: () => "",
       join: async () => {
-        return v.message.content ?? "";
+        return "";
       },
-      });
-      ctx.dispatch(event);
     });
+    ctx.dispatch(event);
     return [];
   }
 

package/src/orchestrate/describe.ts

@@ -10,9 +10,7 @@ import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
 import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
 import { createDescribeEvent } from "../factory/events";
 import { decodeHistory } from "../factory/histories";
-import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
-import { MPSC } from "../utils/MPSC";
-import { streamDefaultReaderToAsyncGenerator, StreamUtil } from "../utils/StreamUtil";
+import { reduceStreamingWithDispatch } from "../utils/ChatGptCompletionStreamingUtil";
 
 export async function describe<Model extends ILlmSchema.Model>(
   ctx: AgenticaContext<Model> | MicroAgenticaContext<Model>,
@@ -41,68 +39,12 @@ export async function describe<Model extends ILlmSchema.Model>(
     ],
   });
 
-  const describeContext: ({
-    content: string;
-    mpsc: MPSC<string>;
-  })[] = [];
-
-  await StreamUtil.reduce<
-    OpenAI.ChatCompletionChunk,
-    Promise<OpenAI.ChatCompletion>
-  >(completionStream, async (accPromise, chunk) => {
-    const acc = await accPromise;
-    const registerContext = (
-      choices: OpenAI.ChatCompletionChunk.Choice[],
-    ) => {
-      for (const choice of choices) {
-        /**
-         * @TODO fix it
-         * Sometimes, the complete message arrives along with a finish reason.
-         */
-        if (choice.finish_reason != null) {
-          describeContext[choice.index]!.mpsc.close();
-          continue;
-        }
-
-        if (choice.delta.content == null) {
-          continue;
-        }
-
-        if (describeContext[choice.index] != null) {
-          describeContext[choice.index]!.content += choice.delta.content;
-          describeContext[choice.index]!.mpsc.produce(choice.delta.content);
-          continue;
-        }
-
-        const mpsc = new MPSC<string>();
-
-        describeContext[choice.index] = {
-          content: choice.delta.content,
-          mpsc,
-        };
-        mpsc.produce(choice.delta.content);
-
-        const event: AgenticaDescribeEvent<Model> = createDescribeEvent({
-          executes: histories,
-          stream: streamDefaultReaderToAsyncGenerator(mpsc.consumer.getReader()),
-          done: () => mpsc.done(),
-          get: () => describeContext[choice.index]?.content ?? "",
-          join: async () => {
-            await mpsc.waitClosed();
-            return describeContext[choice.index]!.content;
-          },
-        });
-        ctx.dispatch(event);
-      }
-    };
-
-    if (acc.object === "chat.completion.chunk") {
-      registerContext([acc, chunk].flatMap(v => v.choices));
-      return ChatGptCompletionMessageUtil.merge([acc, chunk]);
-    }
-
-    registerContext(chunk.choices);
-    return ChatGptCompletionMessageUtil.accumulate(acc, chunk);
+  await reduceStreamingWithDispatch(completionStream, (props) => {
+    const event: AgenticaDescribeEvent<Model> = createDescribeEvent({
+      executes: histories,
+      ...props,
+    });
+    ctx.dispatch(event);
   });
 }
 

package/src/orchestrate/initialize.ts

@@ -11,9 +11,7 @@ import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
 import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
 import { createAssistantMessageEvent } from "../factory/events";
 import { decodeHistory, decodeUserMessageContent } from "../factory/histories";
-import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
-import { MPSC } from "../utils/MPSC";
-import { streamDefaultReaderToAsyncGenerator, StreamUtil } from "../utils/StreamUtil";
+import { reduceStreamingWithDispatch } from "../utils/ChatGptCompletionStreamingUtil";
 
 const FUNCTION: ILlmFunction<"chatgpt"> = typia.llm.application<
   __IChatInitialApplication,
@@ -65,67 +63,9 @@ export async function initialize<Model extends ILlmSchema.Model>(ctx: AgenticaCo
     // parallel_tool_calls: false,
   });
 
-  const textContext: ({
-    content: string;
-    mpsc: MPSC<string>;
-  })[] = [];
-
-  const completion = await StreamUtil.reduce<
-    OpenAI.ChatCompletionChunk,
-    Promise<OpenAI.ChatCompletion>
-  >(completionStream, async (accPromise, chunk) => {
-    const acc = await accPromise;
-    const registerContext = (
-      choices: OpenAI.ChatCompletionChunk.Choice[],
-    ) => {
-      for (const choice of choices) {
-        /**
-         * @TODO fix it
-         * Sometimes, the complete message arrives along with a finish reason.
-         */
-        if (choice.finish_reason != null) {
-          textContext[choice.index]?.mpsc.close();
-          continue;
-        }
-
-        if (choice.delta.content == null || choice.delta.content.length === 0) {
-          continue;
-        }
-
-        if (textContext[choice.index] != null) {
-          textContext[choice.index]!.content += choice.delta.content;
-          textContext[choice.index]!.mpsc.produce(choice.delta.content);
-          continue;
-        }
-
-        const mpsc = new MPSC<string>();
-
-        textContext[choice.index] = {
-          content: choice.delta.content,
-          mpsc,
-        };
-        mpsc.produce(choice.delta.content);
-
-        const event: AgenticaAssistantMessageEvent = createAssistantMessageEvent({
-          stream: streamDefaultReaderToAsyncGenerator(mpsc.consumer.getReader()),
-          done: () => mpsc.done(),
-          get: () => textContext[choice.index]!.content,
-          join: async () => {
-            await mpsc.waitClosed();
-            return textContext[choice.index]!.content;
-          },
-        });
-        ctx.dispatch(event);
-      }
-    };
-
-    if (acc.object === "chat.completion.chunk") {
-      registerContext([acc, chunk].flatMap(v => v.choices));
-      return ChatGptCompletionMessageUtil.merge([acc, chunk]);
-    }
-
-    registerContext(chunk.choices);
-    return ChatGptCompletionMessageUtil.accumulate(acc, chunk);
+  const completion = await reduceStreamingWithDispatch(completionStream, (props) => {
+    const event: AgenticaAssistantMessageEvent = createAssistantMessageEvent(props);
+    ctx.dispatch(event);
   });
 
   if (completion === null) {