@agentica/core 0.43.3 → 0.44.0-dev.20260313-2

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 "@samchon/openapi";
-
-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;
+  }
+}

package/src/events/AgenticaInitializeEvent.ts

@@ -1,7 +1,7 @@
-import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-
-import type { AgenticaEventBase } from "./AgenticaEventBase";
-
-export interface AgenticaInitializeEvent extends AgenticaEventBase<"initialize"> {
-  toJSON: () => IAgenticaEventJson.IInitialize;
-}
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+
+export interface AgenticaInitializeEvent extends AgenticaEventBase<"initialize"> {
+  toJSON: () => IAgenticaEventJson.IInitialize;
+}

package/src/events/AgenticaJsonParseErrorEvent.ts

@@ -1,15 +1,16 @@
-import type { AgenticaOperation } from "../context/AgenticaOperation";
-
-import type { AgenticaEventBase } from "./AgenticaEventBase";
-
-export interface AgenticaJsonParseErrorEvent
-  extends AgenticaEventBase<"jsonParseError"> {
-  /**
-   * ID of the tool calling.
-   */
-  call_id: string;
-  operation: AgenticaOperation;
-  arguments: string;
-  errorMessage: string;
-  life: number;
-}
+import type { IJsonParseResult } from "typia";
+
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+
+export interface AgenticaJsonParseErrorEvent
+  extends AgenticaEventBase<"jsonParseError"> {
+  /**
+   * ID of the tool calling.
+   */
+  call_id: string;
+  operation: AgenticaOperation;
+  failure: IJsonParseResult.IFailure;
+  life: number;
+}

package/src/events/AgenticaRequestEvent.ts

@@ -1,27 +1,27 @@
-import type OpenAI from "openai";
-
-import type { AgenticaEventBase } from "./AgenticaEventBase";
-import type { AgenticaEventSource } from "./AgenticaEventSource";
-
-export type AgenticaRequestEvent =
-  | AgenticaRequestEvent.Streaming
-  | AgenticaRequestEvent.NonStreaming;
-export namespace AgenticaRequestEvent {
-  export type Streaming = Base<
-    true,
-    OpenAI.ChatCompletionCreateParamsStreaming
-  >;
-
-  export type NonStreaming = Base<
-    false,
-    OpenAI.ChatCompletionCreateParamsNonStreaming
-  >;
-
-  interface Base<Stream extends boolean, Body extends object>
-    extends AgenticaEventBase<"request"> {
-    source: AgenticaEventSource;
-    stream: Stream;
-    body: Body;
-    options?: OpenAI.RequestOptions | undefined;
-  }
-}
+import type OpenAI from "openai";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+import type { AgenticaEventSource } from "./AgenticaEventSource";
+
+export type AgenticaRequestEvent
+  = | AgenticaRequestEvent.Streaming
+    | AgenticaRequestEvent.NonStreaming;
+export namespace AgenticaRequestEvent {
+  export type Streaming = Base<
+    true,
+    OpenAI.ChatCompletionCreateParamsStreaming
+  >;
+
+  export type NonStreaming = Base<
+    false,
+    OpenAI.ChatCompletionCreateParamsNonStreaming
+  >;
+
+  interface Base<Stream extends boolean, Body extends object>
+    extends AgenticaEventBase<"request"> {
+    source: AgenticaEventSource;
+    stream: Stream;
+    body: Body;
+    options?: OpenAI.RequestOptions | undefined;
+  }
+}

package/src/events/AgenticaResponseEvent.ts

@@ -1,32 +1,32 @@
-import type OpenAI from "openai";
-
-import type { AgenticaEventBase } from "./AgenticaEventBase";
-import type { AgenticaEventSource } from "./AgenticaEventSource";
-
-export type AgenticaResponseEvent =
-  | AgenticaResponseEvent.Streaming
-  | AgenticaResponseEvent.NonStreaming;
-export namespace AgenticaResponseEvent {
-  export type Streaming = Base<
-    true,
-    OpenAI.ChatCompletionCreateParamsStreaming,
-    AsyncGenerator<OpenAI.ChatCompletionChunk, undefined, undefined>
-  >;
-
-  export type NonStreaming = Base<
-    false,
-    OpenAI.ChatCompletionCreateParamsNonStreaming,
-    OpenAI.ChatCompletion
-  >;
-
-  interface Base<Stream extends boolean, Body extends object, Completion extends object>
-    extends AgenticaEventBase<"response"> {
-    source: AgenticaEventSource;
-    request_id: string;
-    stream: Stream;
-    body: Body;
-    completion: Completion;
-    options?: OpenAI.RequestOptions | undefined;
-    join: () => Promise<OpenAI.ChatCompletion>;
-  }
-}
+import type OpenAI from "openai";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+import type { AgenticaEventSource } from "./AgenticaEventSource";
+
+export type AgenticaResponseEvent
+  = | AgenticaResponseEvent.Streaming
+    | AgenticaResponseEvent.NonStreaming;
+export namespace AgenticaResponseEvent {
+  export type Streaming = Base<
+    true,
+    OpenAI.ChatCompletionCreateParamsStreaming,
+    AsyncGenerator<OpenAI.ChatCompletionChunk, undefined, undefined>
+  >;
+
+  export type NonStreaming = Base<
+    false,
+    OpenAI.ChatCompletionCreateParamsNonStreaming,
+    OpenAI.ChatCompletion
+  >;
+
+  interface Base<Stream extends boolean, Body extends object, Completion extends object>
+    extends AgenticaEventBase<"response"> {
+    source: AgenticaEventSource;
+    request_id: string;
+    stream: Stream;
+    body: Body;
+    completion: Completion;
+    options?: OpenAI.RequestOptions | undefined;
+    join: () => Promise<OpenAI.ChatCompletion>;
+  }
+}

package/src/events/AgenticaSelectEvent.ts

@@ -1,11 +1,11 @@
-import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
-import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
-import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-
-import type { AgenticaEventBase } from "./AgenticaEventBase";
-
-export interface AgenticaSelectEvent extends AgenticaEventBase<"select"> {
-  selection: AgenticaOperationSelection;
-  toJSON: () => IAgenticaEventJson.ISelect;
-  toHistory: () => AgenticaSelectHistory;
-}
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+
+export interface AgenticaSelectEvent extends AgenticaEventBase<"select"> {
+  selection: AgenticaOperationSelection;
+  toJSON: () => IAgenticaEventJson.ISelect;
+  toHistory: () => AgenticaSelectHistory;
+}

package/src/events/AgenticaUserMessageEvent.ts

@@ -1,12 +1,12 @@
-import type { AgenticaUserMessageContent } from "../histories";
-import type { AgenticaUserMessageHistory } from "../histories/AgenticaUserMessageHistory";
-import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-
-import type { AgenticaEventBase } from "./AgenticaEventBase";
-
-export interface AgenticaUserMessageEvent
-  extends AgenticaEventBase<"userMessage"> {
-  contents: Array<AgenticaUserMessageContent>;
-  toJSON: () => IAgenticaEventJson.IUserMessage;
-  toHistory: () => AgenticaUserMessageHistory;
-}
+import type { AgenticaUserMessageContent } from "../histories";
+import type { AgenticaUserMessageHistory } from "../histories/AgenticaUserMessageHistory";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+
+export interface AgenticaUserMessageEvent
+  extends AgenticaEventBase<"userMessage"> {
+  contents: Array<AgenticaUserMessageContent>;
+  toJSON: () => IAgenticaEventJson.IUserMessage;
+  toHistory: () => AgenticaUserMessageHistory;
+}

package/src/events/AgenticaValidateEvent.ts

@@ -1,32 +1,32 @@
-import type { IValidation } from "typia";
-
-import type { AgenticaOperation } from "../context/AgenticaOperation";
-import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-
-import type { AgenticaEventBase } from "./AgenticaEventBase";
-
-/**
- * Event of a validation feedback.
- *
- * @author Samchon
- */
-export interface AgenticaValidateEvent extends AgenticaEventBase<"validate"> {
-  /**
-   * ID of the tool calling.
-   */
-  call_id: string;
-
-  /**
-   * Target operation to call.
-   */
-  operation: AgenticaOperation;
-
-  /**
-   * Validation result as a failure.
-   */
-  result: IValidation.IFailure;
-
-  life: number;
-
-  toJSON: () => IAgenticaEventJson.IValidate;
-}
+import type { IValidation } from "typia";
+
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+
+/**
+ * Event of a validation feedback.
+ *
+ * @author Samchon
+ */
+export interface AgenticaValidateEvent extends AgenticaEventBase<"validate"> {
+  /**
+   * ID of the tool calling.
+   */
+  call_id: string;
+
+  /**
+   * Target operation to call.
+   */
+  operation: AgenticaOperation;
+
+  /**
+   * Validation result as a failure.
+   */
+  result: IValidation.IFailure;
+
+  life: number;
+
+  toJSON: () => IAgenticaEventJson.IValidate;
+}