fix(agent): error instance for validation feedback. (#520)

Author: samchon

packages/core/src/errors/AgenticaJsonParseError.ts

@@ -0,0 +1,47 @@
+import { AgenticaConstant } from "../constants/AgenticaConstant";
+
+export class AgenticaJsonParseError extends Error {
+  public readonly arguments: string;
+  public readonly reason: string;
+
+  public constructor(props: AgenticaJsonParseError.IProps) {
+    super(`Invalid JSON format. The parsing failed after ${AgenticaConstant.RETRY} retries.`);
+
+    const proto = new.target.prototype;
+
+    // eslint-disable-next-line
+    if (Object.setPrototypeOf) { 
+      Object.setPrototypeOf(this, proto);
+    }
+    else {
+      // eslint-disable-next-line
+      (this as any).__proto__ = proto; 
+    }
+
+    this.arguments = props.arguments;
+    this.reason = props.reason;
+  }
+
+  public get name(): "AgenticaJsonParseError" {
+    return "AgenticaJsonParseError";
+  }
+
+  public toJSON(): AgenticaJsonParseError.IJson {
+    return {
+      name: "AgenticaJsonParseError",
+      message: this.message,
+      arguments: this.arguments,
+      reason: this.reason,
+    };
+  }
+}
+export namespace AgenticaJsonParseError {
+  export interface IProps {
+    arguments: string;
+    reason: string;
+  }
+  export interface IJson extends IProps {
+    name: "AgenticaJsonParseError";
+    message: string;
+  }
+}

packages/core/src/errors/AgenticaValidationError.ts

@@ -0,0 +1,49 @@
+import type { IValidation } from "@samchon/openapi";
+
+import { AgenticaConstant } from "../constants/AgenticaConstant";
+
+export class AgenticaValidationError extends Error {
+  public readonly arguments: unknown;
+  public readonly errors: IValidation.IError[];
+
+  public constructor(props: AgenticaValidationError.IProps) {
+    super(`Invalid arguments. The validation failed after ${AgenticaConstant.RETRY} retries.`);
+
+    const proto = new.target.prototype;
+
+    // eslint-disable-next-line
+    if (Object.setPrototypeOf) { 
+      Object.setPrototypeOf(this, proto);
+    }
+    else {
+      // eslint-disable-next-line
+      (this as any).__proto__ = proto; 
+    }
+
+    this.arguments = props.arguments;
+    this.errors = props.errors;
+  }
+
+  public get name(): "AgenticaValidationError" {
+    return "AgenticaValidationError";
+  }
+
+  public toJSON(): AgenticaValidationError.IJson {
+    return {
+      name: "AgenticaValidationError",
+      message: this.message,
+      arguments: this.arguments,
+      errors: this.errors,
+    };
+  }
+}
+export namespace AgenticaValidationError {
+  export interface IProps {
+    arguments: unknown;
+    errors: IValidation.IError[];
+  }
+  export interface IJson extends IProps {
+    name: "AgenticaValidationError";
+    message: string;
+  }
+}

packages/core/src/errors/index.ts

@@ -0,0 +1,2 @@
+export * from "./AgenticaJsonParseError";
+export * from "./AgenticaValidationError";

packages/core/src/index.ts

@@ -2,6 +2,7 @@ export * from "./Agentica";
 
 export * from "./constants";
 export * from "./context";
+export * from "./errors";
 export * from "./events";
 export * as factory from "./factory";
 export * from "./functional";

packages/core/src/orchestrate/call.ts

@@ -20,6 +20,8 @@ import { AgenticaConstant } from "../constants/AgenticaConstant";
 import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
 import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
 import { isAgenticaContext } from "../context/internal/isAgenticaContext";
+import { AgenticaJsonParseError } from "../errors/AgenticaJsonParseError";
+import { AgenticaValidationError } from "../errors/AgenticaValidationError";
 import { createAssistantMessageEvent, createCallEvent, createExecuteEvent, createJsonParseErrorEvent, createValidateEvent } from "../factory/events";
 import { decodeHistory, decodeUserMessageContent } from "../factory/histories";
 import { __get_retry } from "../utils/__retry";
@@ -223,11 +225,10 @@ async function correctTypeError(
       call_id: callEvent.id,
       operation: callEvent.operation,
       arguments: callEvent.arguments,
-      value: {
-        name: "ValidationError",
-        message: `Invalid arguments. The validation failed after ${AgenticaConstant.RETRY} retries.`,
+      value: new AgenticaValidationError({
+        arguments: callEvent.arguments,
         errors: validateEvent.result.errors,
-      },
+      }),
       success: false,
     }),
     operation: callEvent.operation,
@@ -283,12 +284,10 @@ async function correctJsonError(
       call_id: toolCall.id,
       operation: parseErrorEvent.operation,
       arguments: {},
-      value: {
-        name: "JsonParseError",
-        message: `Invalid JSON format. The parsing failed after ${AgenticaConstant.RETRY} retries.`,
+      value: new AgenticaJsonParseError({
         arguments: parseErrorEvent.arguments,
-        errorMessage: parseErrorEvent.errorMessage,
-      },
+        reason: parseErrorEvent.errorMessage,
+      }),
       success: false,
     }),
     operation: parseErrorEvent.operation,