@agentica/core 0.27.3 → 0.28.0

package/src/constants/AgenticaDefaultPrompt.ts

@@ -1,5 +1,7 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
+import { is_node } from "tstl";
+
 import type { IAgenticaConfig } from "../structures/IAgenticaConfig";
 import type { IMicroAgenticaConfig } from "../structures/IMicroAgenticaConfig";
 import type { IMicroAgenticaSystemPrompt } from "../structures/IMicroAgenticaSystemPrompt";
@@ -8,30 +10,11 @@ import { Singleton } from "../utils/Singleton";
 
 import { AgenticaSystemPrompt } from "./AgenticaSystemPrompt";
 
-/**
- * @TODO maybe this code will rewrite
- */
-const isNode = new Singleton(() => {
-  const isObject = (obj: any) => typeof obj === "object" && obj !== null;
-  return (
-    // eslint-disable-next-line no-restricted-globals
-    typeof global === "object"
-    // eslint-disable-next-line no-restricted-globals
-    && isObject(global)
-    // eslint-disable-next-line node/prefer-global/process, no-restricted-globals
-    && isObject(global.process)
-    // eslint-disable-next-line node/prefer-global/process, no-restricted-globals
-    && isObject(global.process.versions)
-    // eslint-disable-next-line node/prefer-global/process, no-restricted-globals
-    && typeof global.process.versions.node !== "undefined"
-  );
-});
-
 /**
  * @TODO maybe replace `process` property for lint pass
  */
 const getLocale = new Singleton(() =>
-  isNode.get()
+  is_node()
     // eslint-disable-next-line node/prefer-global/process
     ? (process.env.LANG?.split(".")[0] ?? "en-US")
     : navigator.language,

package/src/context/AgenticaContext.ts

@@ -115,7 +115,7 @@ export interface AgenticaContext<Model extends ILlmSchema.Model> {
    *
    * @param event Event to deliver
    */
-  dispatch: (event: AgenticaEvent<Model>) => Promise<void>;
+  dispatch: (event: AgenticaEvent<Model>) => void;
 
   /**
    * Request to the OpenAI server.

package/src/context/MicroAgenticaContext.ts

@@ -75,11 +75,11 @@ export interface MicroAgenticaContext<Model extends ILlmSchema.Model> {
    * Dispatch event.
    *
    * Dispatch event so that the agent can be handle the event
-   * through the {@link Agentica.on} function.
+   * through the {@link MicroAgentica.on} function.
    *
    * @param event Event to deliver
    */
-  dispatch: (event: MicroAgenticaEvent<Model>) => Promise<void>;
+  dispatch: (event: MicroAgenticaEvent<Model>) => void;
 
   /**
    * Request to the OpenAI server.

package/src/context/internal/AgenticaOperationComposer.spec.ts

@@ -87,7 +87,6 @@ async function createMockMcpController(name: string, functions: IMcpLlmFunction<
 
 describe("a AgenticaOperationComposer", () => {
   beforeAll(async () => {
-    // eslint-disable-next-line ts/no-unsafe-call
     const server = await createServer({
       name: "calculator",
       version: "1.0.0",
@@ -97,7 +96,7 @@ describe("a AgenticaOperationComposer", () => {
 
     await Promise.all([
       client.connect(clientTransport),
-      // eslint-disable-next-line ts/no-unsafe-call
+
       server.connect(serverTransport),
     ]);
   });

package/src/events/AgenticaEventBase.ts

@@ -1,6 +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">;
 }

package/src/factory/events.ts

@@ -21,17 +21,25 @@ import type { AgenticaUserMessageContent } from "../histories";
 import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
 import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
 
-import { createExecuteHistory, createSelectHistory, createUserMessageHistory } from "./histories";
+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,
   };
 }
@@ -39,16 +47,23 @@ export function createInitializeEvent(): AgenticaInitializeEvent {
 export function createSelectEvent<Model extends ILlmSchema.Model>(props: {
   selection: AgenticaOperationSelection<Model>;
 }): AgenticaSelectEvent<Model> {
+  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: v4(),
-      selections: [props.selection],
+      id,
+      created_at,
+      selection: props.selection,
     }),
   };
 }
@@ -56,11 +71,17 @@ export function createSelectEvent<Model extends ILlmSchema.Model>(props: {
 export function createCancelEvent<Model extends ILlmSchema.Model>(props: {
   selection: AgenticaOperationSelection<Model>;
 }): AgenticaCancelEvent<Model> {
+  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(),
     }),
   };
@@ -74,14 +95,17 @@ export function createCallEvent<Model extends ILlmSchema.Model>(props: {
   operation: AgenticaOperation<Model>;
   arguments: Record<string, any>;
 }): AgenticaCallEvent<Model> {
+  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,
     }),
@@ -93,14 +117,17 @@ export function createValidateEvent<Model extends ILlmSchema.Model>(props: {
   operation: AgenticaOperation<Model>;
   result: IValidation.IFailure;
 }): AgenticaValidateEvent<Model> {
+  const created_at: string = new Date().toISOString();
   return {
     type: "validate",
     id: props.id,
+    created_at,
     operation: props.operation,
     result: props.result,
     toJSON: () => ({
       type: "validate",
       id: props.id,
+      created_at,
       operation: props.operation.toJSON(),
       result: props.result,
     }),
@@ -108,28 +135,35 @@ export function createValidateEvent<Model extends ILlmSchema.Model>(props: {
 }
 
 export function createExecuteEvent<Model extends ILlmSchema.Model>(props: {
-  id: string;
   operation: AgenticaOperation<Model>;
   arguments: Record<string, unknown>;
   value: unknown;
 }): AgenticaExecuteEvent<Model> {
+  const id: string = v4();
+  const created_at: string = new Date().toISOString();
   return {
     type: "execute",
+    id,
+    created_at,
     protocol: props.operation.protocol as "class",
-    id: props.id,
     operation: props.operation as AgenticaOperation.Class<Model>,
     arguments: props.arguments,
     value: props.value as any,
     toJSON: () => ({
       type: "execute",
+      id,
+      created_at,
       protocol: props.operation.protocol as "class",
-      id: props.id,
       operation: props.operation.toJSON(),
       arguments: props.arguments,
       value: props.value,
     }),
     toHistory: () =>
-      createExecuteHistory(props) as AgenticaExecuteHistory.Class<Model>,
+      createExecuteHistory({
+        id,
+        created_at,
+        ...props,
+      }) as AgenticaExecuteHistory.Class<Model>,
   };
 }
 
@@ -139,39 +173,57 @@ export function createExecuteEvent<Model extends ILlmSchema.Model>(props: {
 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 creatAssistantEvent(props: {
+export function creatAssistantMessageEvent(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(),
       }),
     }),
@@ -185,23 +237,33 @@ export function createDescribeEvent<Model extends ILlmSchema.Model>(props: {
   get: () => string;
   join: () => Promise<string>;
 }): AgenticaDescribeEvent<Model> {
+  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(),
       }),
@@ -217,8 +279,12 @@ export function createRequestEvent(props: {
   body: OpenAI.ChatCompletionCreateParamsStreaming;
   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,
     body: props.body,
     options: props.options,
@@ -232,8 +298,12 @@ export function createResponseEvent(props: {
   stream: AsyncGenerator<OpenAI.ChatCompletionChunk, undefined, undefined>;
   join: () => Promise<OpenAI.ChatCompletion>;
 }): AgenticaResponseEvent {
+  const id: string = v4();
+  const created_at: string = new Date().toISOString();
   return {
     type: "response",
+    id,
+    created_at,
     source: props.source,
     body: props.body,
     options: props.options,

package/src/factory/histories.ts

@@ -1,5 +1,6 @@
 import type { IHttpResponse, ILlmSchema } from "@samchon/openapi";
 import type OpenAI from "openai";
+import type { tags } from "typia";
 
 import type { AgenticaOperation } from "../context/AgenticaOperation";
 import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
@@ -33,10 +34,10 @@ export function decodeHistory<Model extends ILlmSchema.Model>(history: AgenticaH
             function: {
               name: `${history.type}Functions`,
               arguments: JSON.stringify({
-                functions: history.selections.map(s => ({
-                  name: s.operation.function.name,
-                  reason: s.reason,
-                })),
+                function: {
+                  name: history.selection.operation.name,
+                  reason: history.selection.reason,
+                },
               }),
             },
           },
@@ -178,13 +179,19 @@ export function decodeUserMessageContent(content: AgenticaUserMessageContent): O
  * @internal
  */
 export function createUserMessageHistory(props: {
+  id: string;
+  created_at: string & tags.Format<"date-time">;
   contents: Array<AgenticaUserMessageContent>;
 }): AgenticaUserMessageHistory {
   return {
     type: "userMessage",
+    id: props.id,
+    created_at: props.created_at,
     contents: props.contents,
     toJSON: () => ({
       type: "userMessage",
+      id: props.id,
+      created_at: props.created_at,
       contents: props.contents,
     }),
   };
@@ -197,10 +204,14 @@ export function createUserMessageHistory(props: {
  * @internal
  */
 export function createAssistantMessageHistory(props: {
+  id: string;
+  created_at: string & tags.Format<"date-time">;
   text: string;
 }): AgenticaAssistantMessageHistory {
   const prompt: IAgenticaHistoryJson.IAssistantMessage = {
     type: "assistantMessage",
+    id: props.id,
+    created_at: props.created_at,
     text: props.text,
   };
   return {
@@ -213,10 +224,14 @@ export function createAssistantMessageHistory(props: {
  * @internal
  */
 export function createSystemMessageHistory(props: {
+  id: string;
+  created_at: string & tags.Format<"date-time">;
   text: string;
 }): AgenticaSystemMessageHistory {
   const prompt: IAgenticaHistoryJson.ISystemMessage = {
     type: "systemMessage",
+    id: props.id,
+    created_at: props.created_at,
     text: props.text,
   };
   return {
@@ -229,15 +244,21 @@ export function createSystemMessageHistory(props: {
  * @internal
  */
 export function createDescribeHistory<Model extends ILlmSchema.Model>(props: {
+  id: string;
+  created_at: string & tags.Format<"date-time">;
   executes: AgenticaExecuteHistory<Model>[];
   text: string;
 }): AgenticaDescribeHistory<Model> {
   return {
     type: "describe",
+    id: props.id,
+    created_at: props.created_at,
     text: props.text,
     executes: props.executes,
     toJSON: () => ({
       type: "describe",
+      id: props.id,
+      created_at: props.created_at,
       text: props.text,
       executes: props.executes.map(execute => execute.toJSON()),
     }),
@@ -252,16 +273,19 @@ export function createDescribeHistory<Model extends ILlmSchema.Model>(props: {
  */
 export function createSelectHistory<Model extends ILlmSchema.Model>(props: {
   id: string;
-  selections: AgenticaOperationSelection<Model>[];
+  created_at: string & tags.Format<"date-time">;
+  selection: AgenticaOperationSelection<Model>;
 }): AgenticaSelectHistory<Model> {
   return {
     type: "select",
     id: props.id,
-    selections: props.selections,
+    selection: props.selection,
+    created_at: props.created_at,
     toJSON: () => ({
       type: "select",
       id: props.id,
-      selections: props.selections.map(selection => selection.toJSON()),
+      created_at: props.created_at,
+      selection: props.selection.toJSON(),
     }),
   };
 }
@@ -271,16 +295,19 @@ export function createSelectHistory<Model extends ILlmSchema.Model>(props: {
  */
 export function createCancelHistory<Model extends ILlmSchema.Model>(props: {
   id: string;
-  selections: AgenticaOperationSelection<Model>[];
+  created_at: string & tags.Format<"date-time">;
+  selection: AgenticaOperationSelection<Model>;
 }): AgenticaCancelHistory<Model> {
   return {
     type: "cancel",
     id: props.id,
-    selections: props.selections,
+    created_at: props.created_at,
+    selection: props.selection,
     toJSON: () => ({
       type: "cancel",
       id: props.id,
-      selections: props.selections.map(selection => selection.toJSON()),
+      created_at: props.created_at,
+      selection: props.selection.toJSON(),
     }),
   };
 }
@@ -292,6 +319,7 @@ export function createExecuteHistory<
   Model extends ILlmSchema.Model,
 >(props: {
   id: string;
+  created_at: string & tags.Format<"date-time">;
   operation: AgenticaOperation<Model>;
   arguments: Record<string, any>;
   value: unknown;
@@ -300,13 +328,15 @@ export function createExecuteHistory<
     type: "execute",
     protocol: props.operation.protocol as "class",
     id: props.id,
+    created_at: props.created_at,
     operation: props.operation as AgenticaOperation.Class<Model>,
     arguments: props.arguments,
     value: props.value,
     toJSON: () => ({
       type: "execute",
-      protocol: props.operation.protocol,
       id: props.id,
+      created_at: props.created_at,
+      protocol: props.operation.protocol,
       operation: props.operation.toJSON(),
       arguments: props.arguments,
       value: props.value,

package/src/histories/AgenticaCancelHistory.ts

@@ -8,6 +8,5 @@ import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
 export interface AgenticaCancelHistory<
   Model extends ILlmSchema.Model,
 > extends AgenticaHistoryBase<"cancel", IAgenticaHistoryJson.ICancel> {
-  id: string;
-  selections: AgenticaOperationSelection<Model>[];
+  selection: AgenticaOperationSelection<Model>;
 }

package/src/histories/AgenticaExecuteHistory.ts

@@ -31,11 +31,6 @@ export namespace AgenticaExecuteHistory {
     Operation extends AgenticaOperation<any>,
     Value,
   > extends AgenticaHistoryBase<"execute", IAgenticaHistoryJson.IExecute> {
-    /**
-     * ID of the LLM tool call result.
-     */
-    id: string;
-
     /**
      * Protocol of the operation.
      */

package/src/histories/AgenticaHistoryBase.ts

@@ -1,3 +1,5 @@
+import type { tags } from "typia";
+
 /**
  * Base type for all histories in Agentica.
  *
@@ -14,10 +16,20 @@ export interface AgenticaHistoryBase<
   Type extends string,
   Json extends { type: Type },
 > {
+  /**
+   * Primary key of the history.
+   */
+  id: string;
+
   /**
    * Discriminator type.
    */
   type: Type;
 
+  /**
+   * Creation timestamp of the history.
+   */
+  created_at: string & tags.Format<"date-time">;
+
   toJSON: () => Json;
 }

package/src/histories/AgenticaSelectHistory.ts

@@ -8,6 +8,5 @@ import type { AgenticaHistoryBase } from "./AgenticaHistoryBase";
 export interface AgenticaSelectHistory<
   Model extends ILlmSchema.Model,
 > extends AgenticaHistoryBase<"select", IAgenticaHistoryJson.ISelect> {
-  id: string;
-  selections: AgenticaOperationSelection<Model>[];
+  selection: AgenticaOperationSelection<Model>;
 }

package/src/json/IAgenticaEventJson.ts

@@ -1,5 +1,5 @@
 import type OpenAI from "openai";
-import type { IValidation } from "typia";
+import type { IValidation, tags } from "typia";
 
 import type { AgenticaEventSource } from "../events/AgenticaEventSource";
 import type { AgenticaUserMessageContent } from "../histories";
@@ -214,9 +214,19 @@ export namespace IAgenticaEventJson {
   }
 
   interface IBase<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/json/IAgenticaHistoryJson.ts

@@ -1,3 +1,5 @@
+import type { tags } from "typia";
+
 import type { AgenticaUserMessageContent } from "../histories";
 
 import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
@@ -77,15 +79,10 @@ export namespace IAgenticaHistoryJson {
    * Selection prompt about candidate functions to call.
    */
   export interface ISelect extends IBase<"select"> {
-    /**
-     * ID of the LLM tool call result.
-     */
-    id: string;
-
     /**
      * Operations that have been selected.
      */
-    selections: IAgenticaOperationSelectionJson[];
+    selection: IAgenticaOperationSelectionJson;
   }
 
   /**
@@ -94,15 +91,10 @@ export namespace IAgenticaHistoryJson {
    * Cancellation prompt about the candidate functions to be discarded.
    */
   export interface ICancel extends IBase<"cancel"> {
-    /**
-     * ID of the LLM tool call result.
-     */
-    id: string;
-
     /**
      * Operations that have been cancelled.
      */
-    selections: IAgenticaOperationSelectionJson[];
+    selection: IAgenticaOperationSelectionJson;
   }
 
   /**
@@ -111,11 +103,6 @@ export namespace IAgenticaHistoryJson {
    * Execution prompt about the LLM function calling.
    */
   export interface IExecute extends IBase<"execute"> {
-    /**
-     * ID of the LLM tool call result.
-     */
-    id: string;
-
     /**
      * Target operation to call.
      */
@@ -152,9 +139,19 @@ export namespace IAgenticaHistoryJson {
   }
 
   interface IBase<Type extends string> {
+    /**
+     * Primary key of the history.
+     */
+    id: string;
+
     /**
      * Discriminator type.
      */
     type: Type;
+
+    /**
+     * Creation timestamp of the history.
+     */
+    created_at: string & tags.Format<"date-time">;
   }
 }