@agentica/core 0.44.0-dev.20260313 → 0.44.0

package/src/context/internal/isAgenticaContext.ts

@@ -1,11 +1,11 @@
-import type { AgenticaContext } from "../AgenticaContext";
-import type { MicroAgenticaContext } from "../MicroAgenticaContext";
-
-/**
- * @internal
- */
-export function isAgenticaContext(
-  ctx: AgenticaContext | MicroAgenticaContext,
-): ctx is AgenticaContext {
-  return typeof (ctx as AgenticaContext).initialize === "function";
-}
+import type { AgenticaContext } from "../AgenticaContext";
+import type { MicroAgenticaContext } from "../MicroAgenticaContext";
+
+/**
+ * @internal
+ */
+export function isAgenticaContext(
+  ctx: AgenticaContext | MicroAgenticaContext,
+): ctx is AgenticaContext {
+  return typeof (ctx as AgenticaContext).initialize === "function";
+}

package/src/errors/AgenticaJsonParseError.ts

@@ -1,52 +1,52 @@
-import type { IJsonParseResult } from "typia";
-
-import { dedent } from "@typia/utils";
-
-import { AgenticaConstant } from "../constants/AgenticaConstant";
-
-export class AgenticaJsonParseError extends Error {
-  public readonly failure: IJsonParseResult.IFailure;
-
-  public constructor(failure: IJsonParseResult.IFailure) {
-    super(
-      dedent`
-        Invalid JSON format. The parsing failed after ${AgenticaConstant.RETRY} retries.
-
-        \`\`\`json
-        ${JSON.stringify(failure, null, 2)}
-        \`\`\`
-      `,
-    );
-
-    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.failure = failure;
-  }
-
-  public get name(): "AgenticaJsonParseError" {
-    return "AgenticaJsonParseError";
-  }
-
-  public toJSON(): AgenticaJsonParseError.IJson {
-    return {
-      name: "AgenticaJsonParseError",
-      failure: this.failure,
-      message: this.message,
-    };
-  }
-}
-export namespace AgenticaJsonParseError {
-  export interface IJson {
-    name: "AgenticaJsonParseError";
-    failure: IJsonParseResult.IFailure;
-    message: string;
-  }
-}
+import type { IJsonParseResult } from "typia";
+
+import { dedent } from "@typia/utils";
+
+import { AgenticaConstant } from "../constants/AgenticaConstant";
+
+export class AgenticaJsonParseError extends Error {
+  public readonly failure: IJsonParseResult.IFailure;
+
+  public constructor(failure: IJsonParseResult.IFailure) {
+    super(
+      dedent`
+        Invalid JSON format. The parsing failed after ${AgenticaConstant.RETRY} retries.
+
+        \`\`\`json
+        ${JSON.stringify(failure, null, 2)}
+        \`\`\`
+      `,
+    );
+
+    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.failure = failure;
+  }
+
+  public get name(): "AgenticaJsonParseError" {
+    return "AgenticaJsonParseError";
+  }
+
+  public toJSON(): AgenticaJsonParseError.IJson {
+    return {
+      name: "AgenticaJsonParseError",
+      failure: this.failure,
+      message: this.message,
+    };
+  }
+}
+export namespace AgenticaJsonParseError {
+  export interface IJson {
+    name: "AgenticaJsonParseError";
+    failure: IJsonParseResult.IFailure;
+    message: string;
+  }
+}

package/src/errors/AgenticaValidationError.ts

@@ -1,49 +1,49 @@
-import type { IValidation } from "typia";
-
-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;
-  }
-}
+import type { IValidation } from "typia";
+
+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;
+  }
+}

package/src/errors/index.ts

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

package/src/events/AgenticaAssistantMessageEvent.ts

@@ -1,12 +1,12 @@
-import type { AgenticaAssistantMessageHistory } from "../histories/AgenticaAssistantMessageHistory";
-import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-
-import type { AgenticaEventBase } from "./AgenticaEventBase";
-
-export interface AgenticaAssistantMessageEvent
-  extends AgenticaEventBase<"assistantMessage"> {
-  stream: AsyncGenerator<string, undefined, undefined>;
-  join: () => Promise<string>;
-  toJSON: () => IAgenticaEventJson.IAssistantMessage;
-  toHistory: () => AgenticaAssistantMessageHistory;
-}
+import type { AgenticaAssistantMessageHistory } from "../histories/AgenticaAssistantMessageHistory";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+
+export interface AgenticaAssistantMessageEvent
+  extends AgenticaEventBase<"assistantMessage"> {
+  stream: AsyncGenerator<string, undefined, undefined>;
+  join: () => Promise<string>;
+  toJSON: () => IAgenticaEventJson.IAssistantMessage;
+  toHistory: () => AgenticaAssistantMessageHistory;
+}

package/src/events/AgenticaCallEvent.ts

@@ -1,27 +1,27 @@
-import type { AgenticaOperation } from "../context/AgenticaOperation";
-import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-
-import type { AgenticaEventBase } from "./AgenticaEventBase";
-
-/**
- * Event of a function calling.
- *
- * @author Samchon
- */
-export interface AgenticaCallEvent extends AgenticaEventBase<"call"> {
-  /**
-   * Target operation to call.
-   */
-  operation: AgenticaOperation;
-
-  /**
-   * Arguments of the function calling.
-   *
-   * If you modify this {@link arguments} property, it actually modifies
-   * the backend server's request. Therefore, be careful when you're
-   * trying to modify this property.
-   */
-  arguments: Record<string, any>;
-
-  toJSON: () => IAgenticaEventJson.ICall;
-}
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+
+/**
+ * Event of a function calling.
+ *
+ * @author Samchon
+ */
+export interface AgenticaCallEvent extends AgenticaEventBase<"call"> {
+  /**
+   * Target operation to call.
+   */
+  operation: AgenticaOperation;
+
+  /**
+   * Arguments of the function calling.
+   *
+   * If you modify this {@link arguments} property, it actually modifies
+   * the backend server's request. Therefore, be careful when you're
+   * trying to modify this property.
+   */
+  arguments: Record<string, any>;
+
+  toJSON: () => IAgenticaEventJson.ICall;
+}

package/src/events/AgenticaCancelEvent.ts

@@ -1,9 +1,9 @@
-import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
-import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-
-import type { AgenticaEventBase } from "./AgenticaEventBase";
-
-export interface AgenticaCancelEvent extends AgenticaEventBase<"cancel"> {
-  selection: AgenticaOperationSelection;
-  toJSON: () => IAgenticaEventJson.ICancel;
-}
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+
+export interface AgenticaCancelEvent extends AgenticaEventBase<"cancel"> {
+  selection: AgenticaOperationSelection;
+  toJSON: () => IAgenticaEventJson.ICancel;
+}

package/src/events/AgenticaDescribeEvent.ts

@@ -1,14 +1,14 @@
-import type { AgenticaDescribeHistory } from "../histories/AgenticaDescribeHistory";
-import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
-import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-
-import type { AgenticaEventBase } from "./AgenticaEventBase";
-
-export interface AgenticaDescribeEvent extends AgenticaEventBase<"describe"> {
-  executes: AgenticaExecuteHistory[];
-  stream: AsyncGenerator<string, undefined, undefined>;
-
-  join: () => Promise<string>;
-  toJSON: () => IAgenticaEventJson.IDescribe;
-  toHistory: () => AgenticaDescribeHistory;
-}
+import type { AgenticaDescribeHistory } from "../histories/AgenticaDescribeHistory";
+import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+
+export interface AgenticaDescribeEvent extends AgenticaEventBase<"describe"> {
+  executes: AgenticaExecuteHistory[];
+  stream: AsyncGenerator<string, undefined, undefined>;
+
+  join: () => Promise<string>;
+  toJSON: () => IAgenticaEventJson.IDescribe;
+  toHistory: () => AgenticaDescribeHistory;
+}

package/src/events/AgenticaEvent.ts

@@ -1,59 +1,59 @@
-import type { AgenticaAssistantMessageEvent } from "./AgenticaAssistantMessageEvent";
-import type { AgenticaCallEvent } from "./AgenticaCallEvent";
-import type { AgenticaCancelEvent } from "./AgenticaCancelEvent";
-import type { AgenticaDescribeEvent } from "./AgenticaDescribeEvent";
-import type { AgenticaExecuteEvent } from "./AgenticaExecuteEvent";
-import type { AgenticaInitializeEvent } from "./AgenticaInitializeEvent";
-import type { AgenticaJsonParseErrorEvent } from "./AgenticaJsonParseErrorEvent";
-import type { AgenticaRequestEvent } from "./AgenticaRequestEvent";
-import type { AgenticaResponseEvent } from "./AgenticaResponseEvent";
-import type { AgenticaSelectEvent } from "./AgenticaSelectEvent";
-import type { AgenticaUserMessageEvent } from "./AgenticaUserMessageEvent";
-import type { AgenticaValidateEvent } from "./AgenticaValidateEvent";
-
-/**
- * Agentica agent event.
- *
- * `AgenticaEvent` is an union type of all possible events that can
- * be emitted by the AI chatbot of the {@link Agentica} class.
- *
- * You can discriminate the subtype by checking the {@link type} property.
- *
- * @author Samchon
- */
-export type AgenticaEvent
-  = | AgenticaUserMessageEvent
-    | AgenticaAssistantMessageEvent
-    | AgenticaInitializeEvent
-    | AgenticaSelectEvent
-    | AgenticaCallEvent
-    | AgenticaCancelEvent
-    | AgenticaExecuteEvent
-    | AgenticaDescribeEvent
-    | AgenticaValidateEvent
-    | AgenticaJsonParseErrorEvent
-    | AgenticaRequestEvent
-    | AgenticaResponseEvent;
-export namespace AgenticaEvent {
-  export type Type = AgenticaEvent["type"];
-  export interface Mapper {
-    userMessage: AgenticaUserMessageEvent;
-    assistantMessage: AgenticaAssistantMessageEvent;
-    select: AgenticaSelectEvent;
-    initialize: AgenticaInitializeEvent;
-    call: AgenticaCallEvent;
-    cancel: AgenticaCancelEvent;
-    execute: AgenticaExecuteEvent;
-    describe: AgenticaDescribeEvent;
-    validate: AgenticaValidateEvent;
-    jsonParseError: AgenticaJsonParseErrorEvent;
-    request: AgenticaRequestEvent;
-    response: AgenticaResponseEvent;
-  }
-  export type Source
-    = | "initialize"
-      | "select"
-      | "cancel"
-      | "call"
-      | "describe";
-}
+import type { AgenticaAssistantMessageEvent } from "./AgenticaAssistantMessageEvent";
+import type { AgenticaCallEvent } from "./AgenticaCallEvent";
+import type { AgenticaCancelEvent } from "./AgenticaCancelEvent";
+import type { AgenticaDescribeEvent } from "./AgenticaDescribeEvent";
+import type { AgenticaExecuteEvent } from "./AgenticaExecuteEvent";
+import type { AgenticaInitializeEvent } from "./AgenticaInitializeEvent";
+import type { AgenticaJsonParseErrorEvent } from "./AgenticaJsonParseErrorEvent";
+import type { AgenticaRequestEvent } from "./AgenticaRequestEvent";
+import type { AgenticaResponseEvent } from "./AgenticaResponseEvent";
+import type { AgenticaSelectEvent } from "./AgenticaSelectEvent";
+import type { AgenticaUserMessageEvent } from "./AgenticaUserMessageEvent";
+import type { AgenticaValidateEvent } from "./AgenticaValidateEvent";
+
+/**
+ * Agentica agent event.
+ *
+ * `AgenticaEvent` is an union type of all possible events that can
+ * be emitted by the AI chatbot of the {@link Agentica} class.
+ *
+ * You can discriminate the subtype by checking the {@link type} property.
+ *
+ * @author Samchon
+ */
+export type AgenticaEvent
+  = | AgenticaUserMessageEvent
+    | AgenticaAssistantMessageEvent
+    | AgenticaInitializeEvent
+    | AgenticaSelectEvent
+    | AgenticaCallEvent
+    | AgenticaCancelEvent
+    | AgenticaExecuteEvent
+    | AgenticaDescribeEvent
+    | AgenticaValidateEvent
+    | AgenticaJsonParseErrorEvent
+    | AgenticaRequestEvent
+    | AgenticaResponseEvent;
+export namespace AgenticaEvent {
+  export type Type = AgenticaEvent["type"];
+  export interface Mapper {
+    userMessage: AgenticaUserMessageEvent;
+    assistantMessage: AgenticaAssistantMessageEvent;
+    select: AgenticaSelectEvent;
+    initialize: AgenticaInitializeEvent;
+    call: AgenticaCallEvent;
+    cancel: AgenticaCancelEvent;
+    execute: AgenticaExecuteEvent;
+    describe: AgenticaDescribeEvent;
+    validate: AgenticaValidateEvent;
+    jsonParseError: AgenticaJsonParseErrorEvent;
+    request: AgenticaRequestEvent;
+    response: AgenticaResponseEvent;
+  }
+  export type Source
+    = | "initialize"
+      | "select"
+      | "cancel"
+      | "call"
+      | "describe";
+}

package/src/events/AgenticaEvent.type.ts

@@ -1,19 +1,19 @@
-import type { AgenticaHistory } from "../histories";
-import type { Pass } from "../utils/types";
-
-import { check, checks } from "../utils/types";
-
-import type { AgenticaEvent } from "./AgenticaEvent";
-
-checks([
-  check<
-    Exclude<AgenticaHistory.Type, "systemMessage"> extends AgenticaEvent.Type ? true : false,
-    true,
-    Pass
-  >(),
-  check<
-    Exclude<AgenticaHistory.Type, "systemMessage"> extends keyof AgenticaEvent.Mapper ? true : false,
-    true,
-    Pass
-  >(),
-]);
+import type { AgenticaHistory } from "../histories";
+import type { Pass } from "../utils/types";
+
+import { check, checks } from "../utils/types";
+
+import type { AgenticaEvent } from "./AgenticaEvent";
+
+checks([
+  check<
+    Exclude<AgenticaHistory.Type, "systemMessage"> extends AgenticaEvent.Type ? true : false,
+    true,
+    Pass
+  >(),
+  check<
+    Exclude<AgenticaHistory.Type, "systemMessage"> extends keyof AgenticaEvent.Mapper ? true : false,
+    true,
+    Pass
+  >(),
+]);

package/src/events/AgenticaEventBase.ts

@@ -1,18 +1,18 @@
-import type { tags } from "typia";
-
-export interface AgenticaEventBase<Type extends string> {
-  /**
-   * Primary key of the event.
-   */
-  id: string;
-
-  /**
-   * Discriminator type.
-   */
-  type: Type;
-
-  /**
-   * Creation timestamp of the event.
-   */
-  created_at: string & tags.Format<"date-time">;
-}
+import type { tags } from "typia";
+
+export interface AgenticaEventBase<Type extends string> {
+  /**
+   * Primary key of the event.
+   */
+  id: string;
+
+  /**
+   * Discriminator type.
+   */
+  type: Type;
+
+  /**
+   * Creation timestamp of the event.
+   */
+  created_at: string & tags.Format<"date-time">;
+}

package/src/events/AgenticaEventSource.ts

@@ -1,6 +1,6 @@
-export type AgenticaEventSource
-  = | "initialize"
-    | "select"
-    | "cancel"
-    | "call"
-    | "describe";
+export type AgenticaEventSource
+  = | "initialize"
+    | "select"
+    | "cancel"
+    | "call"
+    | "describe";

package/src/events/AgenticaExecuteEvent.ts

@@ -1,45 +1,45 @@
-import type { IHttpResponse } from "@typia/interface";
-
-import type { AgenticaOperation } from "../context/AgenticaOperation";
-import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
-import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-
-import type { AgenticaEventBase } from "./AgenticaEventBase";
-
-export type AgenticaExecuteEvent
-  = | AgenticaExecuteEvent.Class
-    | AgenticaExecuteEvent.Protocol;
-export namespace AgenticaExecuteEvent {
-  export interface Class
-    extends Base<
-      "class",
-      AgenticaOperation.Class,
-      AgenticaExecuteHistory.Class,
-      unknown
-    > {}
-
-  export interface Protocol
-    extends Base<
-      "http",
-      AgenticaOperation.Http,
-      AgenticaExecuteHistory.Http,
-      IHttpResponse
-    > {}
-
-  interface Base<
-    Protocol extends "http" | "class",
-    Operation extends AgenticaOperation,
-    History extends AgenticaExecuteHistory,
-    Value,
-  > extends AgenticaEventBase<"execute"> {
-    protocol: Protocol;
-    call_id: string;
-    operation: Operation;
-    arguments: Record<string, unknown>;
-    value: Value;
-    success: boolean;
-
-    toJSON: () => IAgenticaEventJson.IExecute;
-    toHistory: () => History;
-  }
-}
+import type { IHttpResponse } from "@typia/interface";
+
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+
+export type AgenticaExecuteEvent
+  = | AgenticaExecuteEvent.Class
+    | AgenticaExecuteEvent.Protocol;
+export namespace AgenticaExecuteEvent {
+  export interface Class
+    extends Base<
+      "class",
+      AgenticaOperation.Class,
+      AgenticaExecuteHistory.Class,
+      unknown
+    > {}
+
+  export interface Protocol
+    extends Base<
+      "http",
+      AgenticaOperation.Http,
+      AgenticaExecuteHistory.Http,
+      IHttpResponse
+    > {}
+
+  interface Base<
+    Protocol extends "http" | "class",
+    Operation extends AgenticaOperation,
+    History extends AgenticaExecuteHistory,
+    Value,
+  > extends AgenticaEventBase<"execute"> {
+    protocol: Protocol;
+    call_id: string;
+    operation: Operation;
+    arguments: Record<string, unknown>;
+    value: Value;
+    success: boolean;
+
+    toJSON: () => IAgenticaEventJson.IExecute;
+    toHistory: () => History;
+  }
+}