@agentica/core 0.12.21 → 0.13.0

package/src/json/IAgenticaEventJson.ts

@@ -1,9 +1,9 @@
-import OpenAI from "openai";
+import type OpenAI from "openai";
 
-import { AgenticaEventSource } from "../events/AgenticaEventSource";
-import { IAgenticaOperationJson } from "./IAgenticaOperationJson";
-import { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelectionJson";
-import { IAgenticaPromptJson } from "./IAgenticaPromptJson";
+import type { AgenticaEventSource } from "../events/AgenticaEventSource";
+import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
+import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelectionJson";
+import type { IAgenticaPromptJson } from "./IAgenticaPromptJson";
 
 /**
  * Nestia A.I. chatbot event.
@@ -25,7 +25,7 @@ export type IAgenticaEventJson =
   | IAgenticaEventJson.IText;
 export namespace IAgenticaEventJson {
   export type Type = IAgenticaEventJson["type"];
-  export type Mapper = {
+  export interface Mapper {
     initialize: IInitialize;
     select: ISelect;
     cancel: ICancel;
@@ -34,12 +34,11 @@ export namespace IAgenticaEventJson {
     describe: IDescribe;
     text: IText;
     request: IRequest;
-  };
+  }
 
   /**
    * Event of initializing the chatbot.
    */
-  // eslint-disable-next-line @typescript-eslint/no-empty-object-type
   export interface IInitialize extends IBase<"initialize"> {}
 
   /**

package/src/json/IAgenticaOperationSelectionJson.ts

@@ -1,4 +1,4 @@
-import { IAgenticaOperationJson } from "./IAgenticaOperationJson";
+import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
 
 /**
  * Nestia agent operation selection.

package/src/json/IAgenticaPromptJson.ts

@@ -1,5 +1,5 @@
-import { IAgenticaOperationJson } from "./IAgenticaOperationJson";
-import { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelectionJson";
+import type { IAgenticaOperationJson } from "./IAgenticaOperationJson";
+import type { IAgenticaOperationSelectionJson } from "./IAgenticaOperationSelectionJson";
 
 /**
  * Nestia A.I. chatbot prompt.

package/src/prompts/AgenticaCancelPrompt.ts

@@ -1,7 +1,7 @@
-import { ILlmSchema } from "@samchon/openapi";
+import type { ILlmSchema } from "@samchon/openapi";
 
-import { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
-import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
 import { AgenticaPromptBase } from "./AgenticaPromptBase";
 
 export class AgenticaCancelPrompt<
@@ -20,7 +20,7 @@ export class AgenticaCancelPrompt<
     return {
       type: this.type,
       id: this.id,
-      selections: this.selections.map((s) => s.toJSON()),
+      selections: this.selections.map(s => s.toJSON()),
     };
   }
 }

package/src/prompts/AgenticaDescribePrompt.ts

@@ -1,7 +1,7 @@
-import { ILlmSchema } from "@samchon/openapi";
+import type { ILlmSchema } from "@samchon/openapi";
 
-import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
-import { AgenticaExecutePrompt } from "./AgenticaExecutePrompt";
+import type { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import type { AgenticaExecutePrompt } from "./AgenticaExecutePrompt";
 import { AgenticaPromptBase } from "./AgenticaPromptBase";
 
 export class AgenticaDescribePrompt<
@@ -28,7 +28,7 @@ export class AgenticaDescribePrompt<
   public toJSON(): IAgenticaPromptJson.IDescribe {
     return {
       type: this.type,
-      executes: this.executes.map((e) => e.toJSON()),
+      executes: this.executes.map(e => e.toJSON()),
       text: this.text,
     };
   }

package/src/prompts/AgenticaExecutePrompt.ts

@@ -1,7 +1,7 @@
-import { IHttpResponse, ILlmSchema } from "@samchon/openapi";
+import type { IHttpResponse, ILlmSchema } from "@samchon/openapi";
 
-import { AgenticaOperation } from "../context/AgenticaOperation";
-import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
 import { AgenticaPromptBase } from "./AgenticaPromptBase";
 
 export class AgenticaExecutePrompt<
@@ -14,8 +14,9 @@ export class AgenticaExecutePrompt<
     : Protocol extends "class"
       ? AgenticaOperation.Class<Model>
       : AgenticaOperation<Model>;
-  public readonly arguments: Record<string, any>;
-  public readonly value: Protocol extends "http" ? IHttpResponse : any;
+
+  public readonly arguments: Record<string, unknown>;
+  public readonly value: Protocol extends "http" ? IHttpResponse : unknown;
 
   public constructor(props: AgenticaExecutePrompt.IProps<Model, Protocol>) {
     super("execute");

package/src/prompts/AgenticaPrompt.ts

@@ -1,10 +1,10 @@
-import { ILlmSchema } from "@samchon/openapi";
+import type { ILlmSchema } from "@samchon/openapi";
 
-import { AgenticaCancelPrompt } from "../context/AgenticaCancelPrompt";
-import { AgenticaDescribePrompt } from "./AgenticaDescribePrompt";
-import { AgenticaExecutePrompt } from "./AgenticaExecutePrompt";
-import { AgenticaSelectPrompt } from "./AgenticaSelectPrompt";
-import { AgenticaTextPrompt } from "./AgenticaTextPrompt";
+import type { AgenticaCancelPrompt } from "../context/AgenticaCancelPrompt";
+import type { AgenticaDescribePrompt } from "./AgenticaDescribePrompt";
+import type { AgenticaExecutePrompt } from "./AgenticaExecutePrompt";
+import type { AgenticaSelectPrompt } from "./AgenticaSelectPrompt";
+import type { AgenticaTextPrompt } from "./AgenticaTextPrompt";
 
 export type AgenticaPrompt<Model extends ILlmSchema.Model> =
   | AgenticaCancelPrompt<Model>

package/src/prompts/AgenticaSelectPrompt.ts

@@ -1,7 +1,7 @@
-import { ILlmSchema } from "@samchon/openapi";
+import type { ILlmSchema } from "@samchon/openapi";
 
-import { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
-import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
 import { AgenticaPromptBase } from "./AgenticaPromptBase";
 
 export class AgenticaSelectPrompt<
@@ -20,7 +20,7 @@ export class AgenticaSelectPrompt<
     return {
       type: this.type,
       id: this.id,
-      selections: this.selections.map((s) => s.toJSON()),
+      selections: this.selections.map(s => s.toJSON()),
     };
   }
 }

package/src/prompts/AgenticaTextPrompt.ts

@@ -1,4 +1,4 @@
-import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import type { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
 import { AgenticaPromptBase } from "./AgenticaPromptBase";
 
 export class AgenticaTextPrompt<

package/src/structures/IAgenticaConfig.ts

@@ -1,9 +1,9 @@
-import { ILlmSchema } from "@samchon/openapi";
+import type { ILlmSchema } from "@samchon/openapi";
 
-import { AgenticaContext } from "../context/AgenticaContext";
-import { AgenticaPrompt } from "../prompts/AgenticaPrompt";
-import { IAgenticaExecutor } from "./IAgenticaExecutor";
-import { IAgenticaSystemPrompt } from "./IAgenticaSystemPrompt";
+import type { AgenticaContext } from "../context/AgenticaContext";
+import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
+import type { IAgenticaExecutor } from "./IAgenticaExecutor";
+import type { IAgenticaSystemPrompt } from "./IAgenticaSystemPrompt";
 
 /**
  * Configuration for Nestia Agent.

package/src/structures/IAgenticaController.ts

@@ -1,4 +1,4 @@
-import {
+import type {
   IHttpConnection,
   IHttpLlmApplication,
   IHttpLlmFunction,
@@ -97,21 +97,21 @@ export namespace IAgenticaController {
     execute:
       | object
       | ((props: {
-          /**
-           * Target application schema.
-           */
-          application: ILlmApplication<Model>;
+        /**
+         * Target application schema.
+         */
+        application: ILlmApplication<Model>;
 
-          /**
-           * Target function schema.
-           */
-          function: ILlmFunction<Model>;
+        /**
+         * Target function schema.
+         */
+        function: ILlmFunction<Model>;
 
-          /**
-           * Arguments of the function calling.
-           */
-          arguments: object;
-        }) => Promise<unknown>);
+        /**
+         * Arguments of the function calling.
+         */
+        arguments: object;
+      }) => Promise<unknown>);
   }
 
   interface IBase<Protocol, Application> {

package/src/structures/IAgenticaExecutor.ts

@@ -1,8 +1,8 @@
-import { ILlmSchema } from "@samchon/openapi";
+import type { ILlmSchema } from "@samchon/openapi";
 
-import { AgenticaContext } from "../context/AgenticaContext";
-import { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
-import { AgenticaPrompt } from "../prompts/AgenticaPrompt";
+import type { AgenticaContext } from "../context/AgenticaContext";
+import type { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
+import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
 
 /**
  * Executor of the Agentic AI.

package/src/structures/IAgenticaProps.ts

@@ -1,9 +1,9 @@
-import { ILlmSchema } from "@samchon/openapi";
+import type { ILlmSchema } from "@samchon/openapi";
 
-import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
-import { IAgenticaConfig } from "./IAgenticaConfig";
-import { IAgenticaController } from "./IAgenticaController";
-import { IAgenticaVendor } from "./IAgenticaVendor";
+import type { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import type { IAgenticaConfig } from "./IAgenticaConfig";
+import type { IAgenticaController } from "./IAgenticaController";
+import type { IAgenticaVendor } from "./IAgenticaVendor";
 
 /**
  * Properties of the Nestia Agent.

package/src/structures/IAgenticaSystemPrompt.ts

@@ -1,8 +1,8 @@
-import { ILlmSchema } from "@samchon/openapi";
+import type { ILlmSchema } from "@samchon/openapi";
 
-import { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
-import { AgenticaPrompt } from "../prompts/AgenticaPrompt";
-import { IAgenticaConfig } from "./IAgenticaConfig";
+import type { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
+import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
+import type { IAgenticaConfig } from "./IAgenticaConfig";
 
 /**
  * System prompt collection of the A.I. chatbot.

package/src/structures/IAgenticaVendor.ts

@@ -1,4 +1,4 @@
-import OpenAI from "openai";
+import type OpenAI from "openai";
 
 /**
  * LLM service vendor for Nestia Chat.

package/src/transformers/AgenticaEventTransformer.ts

@@ -1,165 +1,198 @@
-import { ILlmSchema } from "@samchon/openapi";
+import type { ILlmSchema } from "@samchon/openapi";
 
-import { AgenticaOperation } from "../context/AgenticaOperation";
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { AgenticaEvent } from "../events/AgenticaEvent";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
 import { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
 import { AgenticaCallEvent } from "../events/AgenticaCallEvent";
 import { AgenticaCancelEvent } from "../events/AgenticaCancelEvent";
 import { AgenticaDescribeEvent } from "../events/AgenticaDescribeEvent";
-import { AgenticaEvent } from "../events/AgenticaEvent";
 import { AgenticaExecuteEvent } from "../events/AgenticaExecuteEvent";
 import { AgenticaInitializeEvent } from "../events/AgenticaInitializeEvent";
 import { AgenticaRequestEvent } from "../events/AgenticaRequestEvent";
 import { AgenticaSelectEvent } from "../events/AgenticaSelectEvent";
 import { AgenticaTextEvent } from "../events/AgenticaTextEvent";
 import { StreamUtil } from "../internal/StreamUtil";
-import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
 
-export namespace AgenticaEventTransformer {
-  export const transform = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-    event: IAgenticaEventJson;
-  }): AgenticaEvent<Model> => {
-    if (props.event.type === "call")
-      return transformCall({
-        operations: props.operations,
-        event: props.event,
-      });
-    else if (props.event.type === "cancel")
-      return transformCancel({
-        operations: props.operations,
-        event: props.event,
-      });
-    else if (props.event.type === "describe")
-      return transformDescribe({
-        operations: props.operations,
-        event: props.event,
-      });
-    else if (props.event.type === "execute")
-      return transformExecute({
-        operations: props.operations,
-        event: props.event,
-      });
-    else if (props.event.type === "initialize") return transformInitialize();
-    else if (props.event.type === "request")
-      return transformRequest({
-        event: props.event,
-      });
-    else if (props.event.type === "select")
-      return transformSelect({
-        operations: props.operations,
-        event: props.event,
-      });
-    else if (props.event.type === "text")
-      return transformText({
-        event: props.event,
-      });
-    else throw new Error("Unknown event type");
+function findOperation<Model extends ILlmSchema.Model>(props: {
+  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+  input: {
+    controller: string;
+    function: string;
   };
+}): AgenticaOperation<Model> {
+  const found: AgenticaOperation<Model> | undefined = props.operations
+    .get(props.input.controller)
+    ?.get(props.input.function);
+  if (found === undefined) {
+    throw new Error(
+      `No operation found: (controller: ${props.input.controller}, function: ${props.input.function})`,
+    );
+  }
+  return found;
+}
 
-  export const transformCall = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-    event: IAgenticaEventJson.ICall;
-  }): AgenticaCallEvent<Model> =>
-    new AgenticaCallEvent({
-      id: props.event.id,
-      operation: findOperation({
-        operations: props.operations,
-        input: props.event.operation,
-      }),
-      arguments: props.event.arguments,
+export function transform<Model extends ILlmSchema.Model>(props: {
+  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+  event: IAgenticaEventJson;
+}): AgenticaEvent<Model> {
+  if (props.event.type === "call") {
+    return transformCall({
+      operations: props.operations,
+      event: props.event,
     });
-
-  export const transformCancel = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-    event: IAgenticaEventJson.ICancel;
-  }): AgenticaCancelEvent<Model> =>
-    new AgenticaCancelEvent({
-      selection: new AgenticaOperationSelection({
-        operation: findOperation({
-          operations: props.operations,
-          input: props.event.selection.operation,
-        }),
-        reason: props.event.selection.reason,
-      }),
+  }
+  else if (props.event.type === "cancel") {
+    return transformCancel({
+      operations: props.operations,
+      event: props.event,
     });
-
-  export const transformDescribe = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-    event: IAgenticaEventJson.IDescribe;
-  }): AgenticaDescribeEvent<Model> =>
-    new AgenticaDescribeEvent({
-      executes: props.event.executes.map((next) =>
-        transformExecute({
-          operations: props.operations,
-          event: next,
-        }),
-      ),
-      stream: StreamUtil.to(props.event.text),
-      done: () => true,
-      get: () => props.event.text,
-      join: async () => props.event.text,
+  }
+  else if (props.event.type === "describe") {
+    return transformDescribe({
+      operations: props.operations,
+      event: props.event,
     });
+  }
+  else if (props.event.type === "execute") {
+    return transformExecute({
+      operations: props.operations,
+      event: props.event,
+    });
+  }
+  else if (props.event.type === "initialize") {
+    return transformInitialize();
+  }
+  else if (props.event.type === "request") {
+    return transformRequest({
+      event: props.event,
+    });
+  }
+  else if (props.event.type === "select") {
+    return transformSelect({
+      operations: props.operations,
+      event: props.event,
+    });
+  }
+  else if (props.event.type === "text") {
+    return transformText({
+      event: props.event,
+    });
+  }
+  else { throw new Error("Unknown event type"); }
+}
+
+export function transformCall<Model extends ILlmSchema.Model>(props: {
+  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+  event: IAgenticaEventJson.ICall;
+}): AgenticaCallEvent<Model> {
+  return new AgenticaCallEvent({
+    id: props.event.id,
+    operation: findOperation({
+      operations: props.operations,
+      input: props.event.operation,
+    }),
+    arguments: props.event.arguments,
+  });
+}
 
-  export const transformExecute = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-    event: IAgenticaEventJson.IExecute;
-  }): AgenticaExecuteEvent<Model> =>
-    new AgenticaExecuteEvent({
-      id: props.event.id,
+export function transformCancel<Model extends ILlmSchema.Model>(props: {
+  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+  event: IAgenticaEventJson.ICancel;
+}): AgenticaCancelEvent<Model> {
+  return new AgenticaCancelEvent({
+    selection: new AgenticaOperationSelection({
       operation: findOperation({
         operations: props.operations,
-        input: props.event.operation,
+        input: props.event.selection.operation,
       }),
-      arguments: props.event.arguments,
-      value: props.event.value,
-    });
+      reason: props.event.selection.reason,
+    }),
+  });
+}
 
-  export const transformInitialize = (): AgenticaInitializeEvent =>
-    new AgenticaInitializeEvent();
+export function transformDescribe<Model extends ILlmSchema.Model>(props: {
+  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+  event: IAgenticaEventJson.IDescribe;
+}): AgenticaDescribeEvent<Model> {
+  return new AgenticaDescribeEvent({
+    executes: props.event.executes.map(next =>
+      transformExecute({
+        operations: props.operations,
+        event: next,
+      }),
+    ),
+    stream: StreamUtil.to(props.event.text),
+    done: () => true,
+    get: () => props.event.text,
+    join: async () => props.event.text,
+  });
+}
 
-  export const transformRequest = (props: {
-    event: IAgenticaEventJson.IRequest;
-  }): AgenticaRequestEvent => new AgenticaRequestEvent(props.event);
+export function transformExecute<Model extends ILlmSchema.Model>(props: {
+  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+  event: IAgenticaEventJson.IExecute;
+}): AgenticaExecuteEvent<Model> {
+  return new AgenticaExecuteEvent({
+    id: props.event.id,
+    operation: findOperation({
+      operations: props.operations,
+      input: props.event.operation,
+    }),
+    /**
+     * @TODO remove `as`
+     */
+    arguments: props.event.arguments as Record<string, any>,
+    value: props.event.value,
+  });
+}
 
-  export const transformSelect = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-    event: IAgenticaEventJson.ISelect;
-  }): AgenticaSelectEvent<Model> =>
-    new AgenticaSelectEvent({
-      selection: new AgenticaOperationSelection({
-        operation: findOperation({
-          operations: props.operations,
-          input: props.event.selection.operation,
-        }),
-        reason: props.event.selection.reason,
-      }),
-    });
+export function transformInitialize(): AgenticaInitializeEvent {
+  return new AgenticaInitializeEvent();
+}
 
-  export const transformText = (props: {
-    event: IAgenticaEventJson.IText;
-  }): AgenticaTextEvent =>
-    new AgenticaTextEvent({
-      role: props.event.role,
-      stream: StreamUtil.to(props.event.text),
-      done: () => true,
-      get: () => props.event.text,
-      join: async () => props.event.text,
-    });
+export function transformRequest(props: {
+  event: IAgenticaEventJson.IRequest;
+}): AgenticaRequestEvent {
+  return new AgenticaRequestEvent(props.event);
 }
 
-const findOperation = <Model extends ILlmSchema.Model>(props: {
+export function transformSelect<Model extends ILlmSchema.Model>(props: {
   operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-  input: {
-    controller: string;
-    function: string;
-  };
-}): AgenticaOperation<Model> => {
-  const found: AgenticaOperation<Model> | undefined = props.operations
-    .get(props.input.controller)
-    ?.get(props.input.function);
-  if (found === undefined)
-    throw new Error(
-      `No operation found: (controller: ${props.input.controller}, function: ${props.input.function})`,
-    );
-  return found;
+  event: IAgenticaEventJson.ISelect;
+}): AgenticaSelectEvent<Model> {
+  return new AgenticaSelectEvent({
+    selection: new AgenticaOperationSelection({
+      operation: findOperation({
+        operations: props.operations,
+        input: props.event.selection.operation,
+      }),
+      reason: props.event.selection.reason,
+    }),
+  });
+}
+
+export function transformText(props: {
+  event: IAgenticaEventJson.IText;
+}): AgenticaTextEvent {
+  return new AgenticaTextEvent({
+    role: props.event.role,
+    stream: StreamUtil.to(props.event.text),
+    done: () => true,
+    get: () => props.event.text,
+    join: async () => props.event.text,
+  });
+}
+
+export const AgenticaEventTransformer = {
+  transform,
+  transformCall,
+  transformCancel,
+  transformDescribe,
+  transformExecute,
+  transformInitialize,
+  transformRequest,
+  transformSelect,
+  transformText,
+  findOperation,
 };