@agentica/core 0.29.5 → 0.30.0

package/src/orchestrate/initialize.ts

@@ -9,7 +9,7 @@ import type { AgenticaAssistantMessageEvent } from "../events/AgenticaAssistantM
 
 import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
 import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
-import { creatAssistantMessageEvent } from "../factory/events";
+import { createAssistantMessageEvent } from "../factory/events";
 import { decodeHistory, decodeUserMessageContent } from "../factory/histories";
 import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
 import { MPSC } from "../utils/MPSC";
@@ -106,7 +106,7 @@ export async function initialize<Model extends ILlmSchema.Model>(ctx: AgenticaCo
         };
         mpsc.produce(choice.delta.content);
 
-        const event: AgenticaAssistantMessageEvent = creatAssistantMessageEvent({
+        const event: AgenticaAssistantMessageEvent = createAssistantMessageEvent({
           stream: streamDefaultReaderToAsyncGenerator(mpsc.consumer.getReader()),
           done: () => mpsc.done(),
           get: () => textContext[choice.index]!.content,

package/src/orchestrate/select.ts

@@ -15,7 +15,7 @@ import type { AgenticaEvent } from "../events/AgenticaEvent";
 import { AgenticaConstant } from "../constants/AgenticaConstant";
 import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
 import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
-import { creatAssistantMessageEvent } from "../factory/events";
+import { createAssistantMessageEvent } from "../factory/events";
 import { decodeHistory, decodeUserMessageContent } from "../factory/histories";
 import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
 import { StreamUtil, toAsyncGenerator } from "../utils/StreamUtil";
@@ -237,7 +237,7 @@ async function step<Model extends ILlmSchema.Model>(
       && choice.message.content != null
       && choice.message.content.length !== 0
     ) {
-      const event: AgenticaAssistantMessageEvent = creatAssistantMessageEvent({
+      const event: AgenticaAssistantMessageEvent = createAssistantMessageEvent({
         stream: toAsyncGenerator(choice.message.content),
         join: async () => Promise.resolve(choice.message.content!),
         done: () => true,

package/src/structures/IAgenticaSystemPrompt.ts

@@ -1,5 +1,6 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
+import type { AgenticaJsonParseErrorEvent } from "../events";
 import type { AgenticaValidateEvent } from "../events/AgenticaValidateEvent";
 import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
 import type { AgenticaHistory } from "../histories/AgenticaHistory";
@@ -174,6 +175,37 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    */
   validate?: (events: AgenticaValidateEvent<Model>[]) => string;
 
+  /**
+   * JSON parsing error system prompt.
+   *
+   * When the AI generates function arguments with invalid JSON syntax
+   * that cannot be parsed by `JSON.parse()`, this prompt provides system
+   * instructions for handling the parsing error and requesting corrected
+   * function calls.
+   *
+   * This specialized prompt enables the AI to:
+   * - Understand that the function call arguments contained malformed JSON
+   * - Receive the specific error message from `JSON.parse()`
+   * - Get guidance on common JSON syntax issues (trailing commas, quote problems, etc.)
+   * - Retry the function call with properly formatted JSON arguments
+   *
+   * The JSON parse error prompt acts as an immediate correction mechanism
+   * when function calling fails at the JSON parsing stage, before any
+   * schema validation occurs. This ensures that basic JSON syntax compliance
+   * is maintained for all function calls.
+   *
+   * Key features include:
+   * - Direct error message reporting from `JSON.parse()`
+   * - Clear identification of the problematic function call
+   * - Specific guidance on JSON syntax requirements
+   * - Immediate retry instruction without additional processing
+   *
+   * @param event The JSON parse error event containing the malformed arguments and error details
+   * @returns JSON parse error system prompt
+   * @default Built-in JSON parse error prompt optimized for syntax correction
+   */
+  jsonParseError?: (event: AgenticaJsonParseErrorEvent<Model>) => string;
+
   /**
    * Describe system prompt.
    *

package/src/structures/IMicroAgenticaSystemPrompt.ts

@@ -1,5 +1,6 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
+import type { AgenticaJsonParseErrorEvent } from "../events/AgenticaJsonParseErrorEvent";
 import type { AgenticaValidateEvent } from "../events/AgenticaValidateEvent";
 import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
 import type { MicroAgenticaHistory } from "../histories/MicroAgenticaHistory";
@@ -107,6 +108,37 @@ export interface IMicroAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    */
   validate?: (events: AgenticaValidateEvent<Model>[]) => string;
 
+  /**
+   * JSON parsing error system prompt.
+   *
+   * When the AI generates function arguments with invalid JSON syntax
+   * that cannot be parsed by `JSON.parse()`, this prompt provides system
+   * instructions for handling the parsing error and requesting corrected
+   * function calls.
+   *
+   * This specialized prompt enables the AI to:
+   * - Understand that the function call arguments contained malformed JSON
+   * - Receive the specific error message from `JSON.parse()`
+   * - Get guidance on common JSON syntax issues (trailing commas, quote problems, etc.)
+   * - Retry the function call with properly formatted JSON arguments
+   *
+   * The JSON parse error prompt acts as an immediate correction mechanism
+   * when function calling fails at the JSON parsing stage, before any
+   * schema validation occurs. This ensures that basic JSON syntax compliance
+   * is maintained for all function calls.
+   *
+   * Key features include:
+   * - Direct error message reporting from `JSON.parse()`
+   * - Clear identification of the problematic function call
+   * - Specific guidance on JSON syntax requirements
+   * - Immediate retry instruction without additional processing
+   *
+   * @param event The JSON parse error event containing the malformed arguments and error details
+   * @returns JSON parse error system prompt
+   * @default Built-in JSON parse error prompt optimized for syntax correction
+   */
+  jsonParseError?: (event: AgenticaJsonParseErrorEvent<Model>) => string;
+
   /**
    * Describe system prompt.
    *