@agentica/core 0.43.2 → 0.44.0-dev.20260313

package/src/factory/events.ts

@@ -1,359 +1,357 @@
-import type { IValidation } from "@samchon/openapi";
-import type OpenAI from "openai";
-
-import { v4 } from "uuid";
-
-import type { AgenticaOperation } from "../context/AgenticaOperation";
-import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
-import type { AgenticaJsonParseErrorEvent } from "../events";
-import type { AgenticaAssistantMessageEvent } from "../events/AgenticaAssistantMessageEvent";
-import type { AgenticaCallEvent } from "../events/AgenticaCallEvent";
-import type { AgenticaCancelEvent } from "../events/AgenticaCancelEvent";
-import type { AgenticaDescribeEvent } from "../events/AgenticaDescribeEvent";
-import type { AgenticaEventSource } from "../events/AgenticaEventSource";
-import type { AgenticaExecuteEvent } from "../events/AgenticaExecuteEvent";
-import type { AgenticaInitializeEvent } from "../events/AgenticaInitializeEvent";
-import type { AgenticaRequestEvent } from "../events/AgenticaRequestEvent";
-import type { AgenticaResponseEvent } from "../events/AgenticaResponseEvent";
-import type { AgenticaSelectEvent } from "../events/AgenticaSelectEvent";
-import type { AgenticaUserMessageEvent } from "../events/AgenticaUserMessageEvent";
-import type { AgenticaValidateEvent } from "../events/AgenticaValidateEvent";
-import type { AgenticaUserMessageContent } from "../histories";
-import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
-import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-
-import {
-  createExecuteHistory,
-  createSelectHistory,
-  createUserMessageHistory,
-} from "./histories";
-
-/* -----------------------------------------------------------
-  FUNCTION SELECTS
------------------------------------------------------------ */
-export function createInitializeEvent(): AgenticaInitializeEvent {
-  const event: IAgenticaEventJson.IInitialize = {
-    id: v4(),
-    type: "initialize",
-    created_at: new Date().toISOString(),
-  };
-  return {
-    id: event.id,
-    type: event.type,
-    created_at: event.created_at,
-    toJSON: () => event,
-  };
-}
-
-export function createSelectEvent(props: {
-  selection: AgenticaOperationSelection;
-}): AgenticaSelectEvent {
-  const id: string = v4();
-  const created_at: string = new Date().toISOString();
-  return {
-    type: "select",
-    id,
-    created_at,
-    selection: props.selection,
-    toJSON: () => ({
-      type: "select",
-      id,
-      created_at,
-      selection: props.selection.toJSON(),
-    }),
-    toHistory: () => createSelectHistory({
-      id,
-      created_at,
-      selection: props.selection,
-    }),
-  };
-}
-
-export function createCancelEvent(props: {
-  selection: AgenticaOperationSelection;
-}): AgenticaCancelEvent {
-  const id: string = v4();
-  const created_at: string = new Date().toISOString();
-  return {
-    type: "cancel",
-    id,
-    created_at,
-    selection: props.selection,
-    toJSON: () => ({
-      type: "cancel",
-      id,
-      created_at,
-      selection: props.selection.toJSON(),
-    }),
-  };
-}
-
-/* -----------------------------------------------------------
-  FUNCTION CALLS
------------------------------------------------------------ */
-export function createCallEvent(props: {
-  id: string;
-  operation: AgenticaOperation;
-  arguments: Record<string, any>;
-}): AgenticaCallEvent {
-  const created_at: string = new Date().toISOString();
-  return {
-    type: "call",
-    id: props.id,
-    created_at,
-    operation: props.operation,
-    arguments: props.arguments,
-    toJSON: () => ({
-      type: "call",
-      id: props.id,
-      created_at,
-      operation: props.operation.toJSON(),
-      arguments: props.arguments,
-    }),
-  };
-}
-
-export function createJsonParseErrorEvent(props: {
-  call_id: string;
-  operation: AgenticaOperation;
-  arguments: string;
-  errorMessage: string;
-  life: number;
-}): AgenticaJsonParseErrorEvent {
-  const id: string = v4();
-  const created_at: string = new Date().toISOString();
-  return {
-    type: "jsonParseError",
-    id,
-    call_id: props.call_id,
-    created_at,
-    operation: props.operation,
-    arguments: props.arguments,
-    errorMessage: props.errorMessage,
-    life: props.life,
-  };
-}
-
-export function createValidateEvent(props: {
-  call_id: string;
-  operation: AgenticaOperation;
-  result: IValidation.IFailure;
-  life: number;
-}): AgenticaValidateEvent {
-  const id: string = v4();
-  const created_at: string = new Date().toISOString();
-  return {
-    type: "validate",
-    id,
-    call_id: props.call_id,
-    created_at,
-    operation: props.operation,
-    result: props.result,
-    life: props.life,
-    toJSON: () => ({
-      type: "validate",
-      id,
-      call_id: props.call_id,
-      created_at,
-      operation: props.operation.toJSON(),
-      result: props.result,
-      life: props.life,
-    }),
-  };
-}
-
-export function createExecuteEvent(props: {
-  call_id: string;
-  operation: AgenticaOperation;
-  arguments: Record<string, unknown>;
-  value: unknown;
-  success: boolean;
-}): AgenticaExecuteEvent {
-  const id: string = v4();
-  const created_at: string = new Date().toISOString();
-  return {
-    type: "execute",
-    id,
-    created_at,
-    call_id: props.call_id,
-    protocol: props.operation.protocol as "class",
-    operation: props.operation as AgenticaOperation.Class,
-    arguments: props.arguments,
-    value: props.value as any,
-    success: props.success,
-    toJSON: () => ({
-      type: "execute",
-      id,
-      created_at,
-      call_id: props.call_id,
-      protocol: props.operation.protocol as "class",
-      operation: props.operation.toJSON(),
-      arguments: props.arguments,
-      value: props.value,
-      success: props.success,
-    }),
-    toHistory: () =>
-      createExecuteHistory({
-        id,
-        created_at,
-        ...props,
-      }) as AgenticaExecuteHistory.Class,
-  };
-}
-
-/* -----------------------------------------------------------
-  CONTENTS
------------------------------------------------------------ */
-export function createUserMessageEvent(props: {
-  contents: Array<AgenticaUserMessageContent>;
-}): AgenticaUserMessageEvent {
-  const id: string = v4();
-  const created_at: string = new Date().toISOString();
-  return {
-    type: "userMessage",
-    id,
-    created_at,
-    contents: props.contents,
-    toJSON: () => ({
-      type: "userMessage",
-      id,
-      created_at,
-      contents: props.contents,
-    }),
-    toHistory: () => createUserMessageHistory({
-      id,
-      created_at,
-      contents: props.contents,
-    }),
-  };
-}
-
-export function createAssistantMessageEvent(props: {
-  stream: AsyncGenerator<string, undefined, undefined>;
-  done: () => boolean;
-  get: () => string;
-  join: () => Promise<string>;
-}): AgenticaAssistantMessageEvent {
-  const id: string = v4();
-  const created_at: string = new Date().toISOString();
-  return {
-    type: "assistantMessage",
-    id,
-    created_at,
-    stream: props.stream,
-    join: props.join,
-    toJSON: () => ({
-      type: "assistantMessage",
-      id,
-      created_at,
-      done: props.done(),
-      text: props.get(),
-    }),
-    toHistory: () => ({
-      type: "assistantMessage",
-      id,
-      created_at,
-      text: props.get(),
-      toJSON: () => ({
-        type: "assistantMessage",
-        id,
-        created_at,
-        text: props.get(),
-      }),
-    }),
-  };
-}
-
-export function createDescribeEvent(props: {
-  executes: AgenticaExecuteHistory[];
-  stream: AsyncGenerator<string, undefined, undefined>;
-  done: () => boolean;
-  get: () => string;
-  join: () => Promise<string>;
-}): AgenticaDescribeEvent {
-  const id: string = v4();
-  const created_at: string = new Date().toISOString();
-  return {
-    type: "describe",
-    id,
-    created_at,
-    executes: props.executes,
-    stream: props.stream,
-    join: props.join,
-    toJSON: () => ({
-      type: "describe",
-      id,
-      created_at,
-      executes: props.executes.map(execute => execute.toJSON()),
-      done: props.done(),
-      text: props.get(),
-    }),
-    toHistory: () => ({
-      type: "describe",
-      id,
-      created_at,
-      executes: props.executes,
-      text: props.get(),
-      toJSON: () => ({
-        type: "describe",
-        id,
-        created_at,
-        executes: props.executes.map(execute => execute.toJSON()),
-        text: props.get(),
-      }),
-    }),
-  };
-}
-
-/* -----------------------------------------------------------
-  API REQUESTS
------------------------------------------------------------ */
-export function createRequestEvent<Stream extends boolean>(props: {
-  source: AgenticaEventSource;
-  stream: Stream;
-  body: Stream extends true
-    ? OpenAI.ChatCompletionCreateParamsStreaming
-    : OpenAI.ChatCompletionCreateParamsNonStreaming;
-  options?: OpenAI.RequestOptions | undefined;
-}): AgenticaRequestEvent {
-  const id: string = v4();
-  const created_at: string = new Date().toISOString();
-  return {
-    type: "request",
-    id,
-    created_at,
-    source: props.source,
-    stream: props.stream as false,
-    body: props.body as OpenAI.ChatCompletionCreateParamsNonStreaming,
-    options: props.options,
-  };
-}
-
-export function createResponseEvent<Stream extends boolean>(props: {
-  request_id: string;
-  source: AgenticaEventSource;
-  stream: Stream;
-  body: Stream extends true
-    ? OpenAI.ChatCompletionCreateParamsStreaming
-    : OpenAI.ChatCompletionCreateParamsNonStreaming;
-  options?: OpenAI.RequestOptions | undefined;
-  completion: Stream extends true
-    ? AsyncGenerator<OpenAI.ChatCompletionChunk, undefined, undefined>
-    : OpenAI.ChatCompletion;
-  join: () => Promise<OpenAI.ChatCompletion>;
-}): AgenticaResponseEvent {
-  const id: string = v4();
-  const created_at: string = new Date().toISOString();
-  return {
-    type: "response",
-    id,
-    request_id: props.request_id,
-    created_at,
-    source: props.source,
-    stream: props.stream as false,
-    body: props.body as OpenAI.ChatCompletionCreateParamsNonStreaming,
-    completion: props.completion as OpenAI.ChatCompletion,
-    options: props.options,
-    join: props.join,
-  };
-}
+import type { IJsonParseResult, IValidation } from "@typia/interface";
+import type OpenAI from "openai";
+
+import { v4 } from "uuid";
+
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { AgenticaJsonParseErrorEvent } from "../events";
+import type { AgenticaAssistantMessageEvent } from "../events/AgenticaAssistantMessageEvent";
+import type { AgenticaCallEvent } from "../events/AgenticaCallEvent";
+import type { AgenticaCancelEvent } from "../events/AgenticaCancelEvent";
+import type { AgenticaDescribeEvent } from "../events/AgenticaDescribeEvent";
+import type { AgenticaEventSource } from "../events/AgenticaEventSource";
+import type { AgenticaExecuteEvent } from "../events/AgenticaExecuteEvent";
+import type { AgenticaInitializeEvent } from "../events/AgenticaInitializeEvent";
+import type { AgenticaRequestEvent } from "../events/AgenticaRequestEvent";
+import type { AgenticaResponseEvent } from "../events/AgenticaResponseEvent";
+import type { AgenticaSelectEvent } from "../events/AgenticaSelectEvent";
+import type { AgenticaUserMessageEvent } from "../events/AgenticaUserMessageEvent";
+import type { AgenticaValidateEvent } from "../events/AgenticaValidateEvent";
+import type { AgenticaUserMessageContent } from "../histories";
+import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+
+import {
+  createExecuteHistory,
+  createSelectHistory,
+  createUserMessageHistory,
+} from "./histories";
+
+/* -----------------------------------------------------------
+  FUNCTION SELECTS
+----------------------------------------------------------- */
+export function createInitializeEvent(): AgenticaInitializeEvent {
+  const event: IAgenticaEventJson.IInitialize = {
+    id: v4(),
+    type: "initialize",
+    created_at: new Date().toISOString(),
+  };
+  return {
+    id: event.id,
+    type: event.type,
+    created_at: event.created_at,
+    toJSON: () => event,
+  };
+}
+
+export function createSelectEvent(props: {
+  selection: AgenticaOperationSelection;
+}): AgenticaSelectEvent {
+  const id: string = v4();
+  const created_at: string = new Date().toISOString();
+  return {
+    type: "select",
+    id,
+    created_at,
+    selection: props.selection,
+    toJSON: () => ({
+      type: "select",
+      id,
+      created_at,
+      selection: props.selection.toJSON(),
+    }),
+    toHistory: () => createSelectHistory({
+      id,
+      created_at,
+      selection: props.selection,
+    }),
+  };
+}
+
+export function createCancelEvent(props: {
+  selection: AgenticaOperationSelection;
+}): AgenticaCancelEvent {
+  const id: string = v4();
+  const created_at: string = new Date().toISOString();
+  return {
+    type: "cancel",
+    id,
+    created_at,
+    selection: props.selection,
+    toJSON: () => ({
+      type: "cancel",
+      id,
+      created_at,
+      selection: props.selection.toJSON(),
+    }),
+  };
+}
+
+/* -----------------------------------------------------------
+  FUNCTION CALLS
+----------------------------------------------------------- */
+export function createCallEvent(props: {
+  id: string;
+  operation: AgenticaOperation;
+  arguments: Record<string, any>;
+}): AgenticaCallEvent {
+  const created_at: string = new Date().toISOString();
+  return {
+    type: "call",
+    id: props.id,
+    created_at,
+    operation: props.operation,
+    arguments: props.arguments,
+    toJSON: () => ({
+      type: "call",
+      id: props.id,
+      created_at,
+      operation: props.operation.toJSON(),
+      arguments: props.arguments,
+    }),
+  };
+}
+
+export function createJsonParseErrorEvent(props: {
+  call_id: string;
+  operation: AgenticaOperation;
+  failure: IJsonParseResult.IFailure;
+  life: number;
+}): AgenticaJsonParseErrorEvent {
+  const id: string = v4();
+  const created_at: string = new Date().toISOString();
+  return {
+    type: "jsonParseError",
+    id,
+    call_id: props.call_id,
+    created_at,
+    operation: props.operation,
+    failure: props.failure,
+    life: props.life,
+  };
+}
+
+export function createValidateEvent(props: {
+  call_id: string;
+  operation: AgenticaOperation;
+  result: IValidation.IFailure;
+  life: number;
+}): AgenticaValidateEvent {
+  const id: string = v4();
+  const created_at: string = new Date().toISOString();
+  return {
+    type: "validate",
+    id,
+    call_id: props.call_id,
+    created_at,
+    operation: props.operation,
+    result: props.result,
+    life: props.life,
+    toJSON: () => ({
+      type: "validate",
+      id,
+      call_id: props.call_id,
+      created_at,
+      operation: props.operation.toJSON(),
+      result: props.result,
+      life: props.life,
+    }),
+  };
+}
+
+export function createExecuteEvent(props: {
+  call_id: string;
+  operation: AgenticaOperation;
+  arguments: Record<string, unknown>;
+  value: unknown;
+  success: boolean;
+}): AgenticaExecuteEvent {
+  const id: string = v4();
+  const created_at: string = new Date().toISOString();
+  return {
+    type: "execute",
+    id,
+    created_at,
+    call_id: props.call_id,
+    protocol: props.operation.protocol as "class",
+    operation: props.operation as AgenticaOperation.Class,
+    arguments: props.arguments,
+    value: props.value as any,
+    success: props.success,
+    toJSON: () => ({
+      type: "execute",
+      id,
+      created_at,
+      call_id: props.call_id,
+      protocol: props.operation.protocol as "class",
+      operation: props.operation.toJSON(),
+      arguments: props.arguments,
+      value: props.value,
+      success: props.success,
+    }),
+    toHistory: () =>
+      createExecuteHistory({
+        id,
+        created_at,
+        ...props,
+      }) as AgenticaExecuteHistory.Class,
+  };
+}
+
+/* -----------------------------------------------------------
+  CONTENTS
+----------------------------------------------------------- */
+export function createUserMessageEvent(props: {
+  contents: Array<AgenticaUserMessageContent>;
+}): AgenticaUserMessageEvent {
+  const id: string = v4();
+  const created_at: string = new Date().toISOString();
+  return {
+    type: "userMessage",
+    id,
+    created_at,
+    contents: props.contents,
+    toJSON: () => ({
+      type: "userMessage",
+      id,
+      created_at,
+      contents: props.contents,
+    }),
+    toHistory: () => createUserMessageHistory({
+      id,
+      created_at,
+      contents: props.contents,
+    }),
+  };
+}
+
+export function createAssistantMessageEvent(props: {
+  stream: AsyncGenerator<string, undefined, undefined>;
+  done: () => boolean;
+  get: () => string;
+  join: () => Promise<string>;
+}): AgenticaAssistantMessageEvent {
+  const id: string = v4();
+  const created_at: string = new Date().toISOString();
+  return {
+    type: "assistantMessage",
+    id,
+    created_at,
+    stream: props.stream,
+    join: props.join,
+    toJSON: () => ({
+      type: "assistantMessage",
+      id,
+      created_at,
+      done: props.done(),
+      text: props.get(),
+    }),
+    toHistory: () => ({
+      type: "assistantMessage",
+      id,
+      created_at,
+      text: props.get(),
+      toJSON: () => ({
+        type: "assistantMessage",
+        id,
+        created_at,
+        text: props.get(),
+      }),
+    }),
+  };
+}
+
+export function createDescribeEvent(props: {
+  executes: AgenticaExecuteHistory[];
+  stream: AsyncGenerator<string, undefined, undefined>;
+  done: () => boolean;
+  get: () => string;
+  join: () => Promise<string>;
+}): AgenticaDescribeEvent {
+  const id: string = v4();
+  const created_at: string = new Date().toISOString();
+  return {
+    type: "describe",
+    id,
+    created_at,
+    executes: props.executes,
+    stream: props.stream,
+    join: props.join,
+    toJSON: () => ({
+      type: "describe",
+      id,
+      created_at,
+      executes: props.executes.map(execute => execute.toJSON()),
+      done: props.done(),
+      text: props.get(),
+    }),
+    toHistory: () => ({
+      type: "describe",
+      id,
+      created_at,
+      executes: props.executes,
+      text: props.get(),
+      toJSON: () => ({
+        type: "describe",
+        id,
+        created_at,
+        executes: props.executes.map(execute => execute.toJSON()),
+        text: props.get(),
+      }),
+    }),
+  };
+}
+
+/* -----------------------------------------------------------
+  API REQUESTS
+----------------------------------------------------------- */
+export function createRequestEvent<Stream extends boolean>(props: {
+  source: AgenticaEventSource;
+  stream: Stream;
+  body: Stream extends true
+    ? OpenAI.ChatCompletionCreateParamsStreaming
+    : OpenAI.ChatCompletionCreateParamsNonStreaming;
+  options?: OpenAI.RequestOptions | undefined;
+}): AgenticaRequestEvent {
+  const id: string = v4();
+  const created_at: string = new Date().toISOString();
+  return {
+    type: "request",
+    id,
+    created_at,
+    source: props.source,
+    stream: props.stream as false,
+    body: props.body as OpenAI.ChatCompletionCreateParamsNonStreaming,
+    options: props.options,
+  };
+}
+
+export function createResponseEvent<Stream extends boolean>(props: {
+  request_id: string;
+  source: AgenticaEventSource;
+  stream: Stream;
+  body: Stream extends true
+    ? OpenAI.ChatCompletionCreateParamsStreaming
+    : OpenAI.ChatCompletionCreateParamsNonStreaming;
+  options?: OpenAI.RequestOptions | undefined;
+  completion: Stream extends true
+    ? AsyncGenerator<OpenAI.ChatCompletionChunk, undefined, undefined>
+    : OpenAI.ChatCompletion;
+  join: () => Promise<OpenAI.ChatCompletion>;
+}): AgenticaResponseEvent {
+  const id: string = v4();
+  const created_at: string = new Date().toISOString();
+  return {
+    type: "response",
+    id,
+    request_id: props.request_id,
+    created_at,
+    source: props.source,
+    stream: props.stream as false,
+    body: props.body as OpenAI.ChatCompletionCreateParamsNonStreaming,
+    completion: props.completion as OpenAI.ChatCompletion,
+    options: props.options,
+    join: props.join,
+  };
+}