@agentica/core 0.8.3 → 0.9.0-dev.20250302

package/src/functional/createHttpLlmApplication.ts

@@ -1,63 +1,63 @@
-import {
-  HttpLlm,
-  IHttpLlmApplication,
-  OpenApi,
-  OpenApiV3,
-  OpenApiV3_1,
-  SwaggerV2,
-} from "@samchon/openapi";
-import typia, { IValidation } from "typia";
-
-/**
- * Create an HTTP LLM application instance.
- * 
- * Create an {@link IHttpLlmApplication} instance which represents
- * the LLM (Large Language Model) function calling application schema 
- * from the given Swagger/OpenAPI document and the target LLM model.
- * 
- * By the way, even though this `createHttpLlmApplication` function
- * supports every version of Swagger/OpenAPI specification, there can
- * be a type error in the given document. In that case, the function
- * will return {@link IValidation.IFailure} instance with detailed
- * type error tracing information.
- * 
- * @param props Properties to create the HTTP LLM application instance
- * @returns Validation result of the HTTP LLM application composition
- * @author Samchon
- */
-export const createHttpLlmApplication = (props: {
-  /**
-   * Target LLM model.
-   */
-  model: "chatgpt";
-
-  /**
-   * Swagger/OpenAPI document.
-   */
-  document:
-    | SwaggerV2.IDocument
-    | OpenApiV3.IDocument
-    | OpenApiV3_1.IDocument
-    | OpenApi.IDocument;
-
-  /**
-   * Options for the LLM function calling schema composition.
-   */
-  options?: Partial<IHttpLlmApplication.IOptions<"chatgpt">>;
-}): IValidation<IHttpLlmApplication<"chatgpt">> => {
-  const inspect: IValidation<
-    | SwaggerV2.IDocument
-    | OpenApiV3.IDocument
-    | OpenApiV3_1.IDocument
-    | OpenApi.IDocument
-  > = typia.validate(props.document);
-  if (inspect.success === false) return inspect;
-  return {
-    success: true,
-    data: HttpLlm.application({
-      model: props.model,
-      document: OpenApi.convert(props.document),
-      options: props.options,
-    }),
-  };
-};
+import {
+  HttpLlm,
+  IHttpLlmApplication,
+  OpenApi,
+  OpenApiV3,
+  OpenApiV3_1,
+  SwaggerV2,
+} from "@samchon/openapi";
+import typia, { IValidation } from "typia";
+
+/**
+ * Create an HTTP LLM application instance.
+ * 
+ * Create an {@link IHttpLlmApplication} instance which represents
+ * the LLM (Large Language Model) function calling application schema 
+ * from the given Swagger/OpenAPI document and the target LLM model.
+ * 
+ * By the way, even though this `createHttpLlmApplication` function
+ * supports every version of Swagger/OpenAPI specification, there can
+ * be a type error in the given document. In that case, the function
+ * will return {@link IValidation.IFailure} instance with detailed
+ * type error tracing information.
+ * 
+ * @param props Properties to create the HTTP LLM application instance
+ * @returns Validation result of the HTTP LLM application composition
+ * @author Samchon
+ */
+export const createHttpLlmApplication = (props: {
+  /**
+   * Target LLM model.
+   */
+  model: "chatgpt";
+
+  /**
+   * Swagger/OpenAPI document.
+   */
+  document:
+    | SwaggerV2.IDocument
+    | OpenApiV3.IDocument
+    | OpenApiV3_1.IDocument
+    | OpenApi.IDocument;
+
+  /**
+   * Options for the LLM function calling schema composition.
+   */
+  options?: Partial<IHttpLlmApplication.IOptions<"chatgpt">>;
+}): IValidation<IHttpLlmApplication<"chatgpt">> => {
+  const inspect: IValidation<
+    | SwaggerV2.IDocument
+    | OpenApiV3.IDocument
+    | OpenApiV3_1.IDocument
+    | OpenApi.IDocument
+  > = typia.validate(props.document);
+  if (inspect.success === false) return inspect;
+  return {
+    success: true,
+    data: HttpLlm.application({
+      model: props.model,
+      document: OpenApi.convert(props.document),
+      options: props.options,
+    }),
+  };
+};

package/src/index.ts

@@ -1,19 +1,19 @@
-// TYPES
-export * from "./structures/IAgenticaConfig";
-export * from "./structures/IAgenticaContext";
-export * from "./structures/IAgenticaController";
-export * from "./structures/IAgenticaEvent";
-export * from "./structures/IAgenticaExecutor";
-export * from "./structures/IAgenticaOperation";
-export * from "./structures/IAgenticaOperationCollection";
-export * from "./structures/IAgenticaOperationSelection";
-export * from "./structures/IAgenticaPrompt";
-export * from "./structures/IAgenticaProps";
-export * from "./structures/IAgenticaProvider";
-export * from "./structures/IAgenticaSystemPrompt";
-export * from "./structures/IAgenticaTokenUsage";
-export * from "./typings/AgenticaSource";
-
-// FACADE CLASS
-export * from "./functional/createHttpLlmApplication";
-export * from "./Agentica";
+// TYPES
+export * from "./structures/IAgenticaConfig";
+export * from "./structures/IAgenticaContext";
+export * from "./structures/IAgenticaController";
+export * from "./structures/IAgenticaEvent";
+export * from "./structures/IAgenticaExecutor";
+export * from "./structures/IAgenticaOperation";
+export * from "./structures/IAgenticaOperationCollection";
+export * from "./structures/IAgenticaOperationSelection";
+export * from "./structures/IAgenticaPrompt";
+export * from "./structures/IAgenticaProps";
+export * from "./structures/IAgenticaProvider";
+export * from "./structures/IAgenticaSystemPrompt";
+export * from "./structures/IAgenticaTokenUsage";
+export * from "./typings/AgenticaSource";
+
+// FACADE CLASS
+export * from "./functional/createHttpLlmApplication";
+export * from "./Agentica";

package/src/internal/AgenticaConstant.ts

@@ -1,4 +1,4 @@
-export namespace AgenticaConstant {
-  export const RETRY = 3;
-  export const ELITICISM = true;
-}
+export namespace AgenticaConstant {
+  export const RETRY = 3;
+  export const ELITICISM = true;
+}

package/src/internal/AgenticaDefaultPrompt.ts

@@ -1,39 +1,43 @@
-import { IAgenticaConfig } from "../structures/IAgenticaConfig";
-import { AgenticaSystemPrompt } from "./AgenticaSystemPrompt";
-import { Singleton } from "./Singleton";
-
-export namespace AgenticaDefaultPrompt {
-  export const write = (config?: IAgenticaConfig): string => {
-    if (config?.systemPrompt?.common)
-      return config?.systemPrompt?.common(config);
-
-    const locale: string = config?.locale ?? getLocale.get();
-    const timezone: string = config?.timezone ?? getTimezone.get();
-
-    return AgenticaSystemPrompt.COMMON.replace("${locale}", locale).replace(
-      "${timezone}",
-      timezone,
-    );
-  };
-}
-
-const getLocale = new Singleton(() =>
-  isNode.get()
-    ? (process.env.LANG?.split(".")[0] ?? "en-US")
-    : navigator.language,
-);
-
-const getTimezone = new Singleton(
-  () => Intl.DateTimeFormat().resolvedOptions().timeZone,
-);
-
-const isNode = new Singleton(() => {
-  const isObject = (obj: any) => typeof obj === "object" && obj !== null;
-  return (
-    typeof global === "object" &&
-    isObject(global) &&
-    isObject(global.process) &&
-    isObject(global.process.versions) &&
-    typeof global.process.versions.node !== "undefined"
-  );
-});
+import { ILlmSchema } from "@samchon/openapi";
+
+import { IAgenticaConfig } from "../structures/IAgenticaConfig";
+import { AgenticaSystemPrompt } from "./AgenticaSystemPrompt";
+import { Singleton } from "./Singleton";
+
+export namespace AgenticaDefaultPrompt {
+  export const write = <Model extends ILlmSchema.Model>(
+    config?: IAgenticaConfig<Model>,
+  ): string => {
+    if (config?.systemPrompt?.common)
+      return config?.systemPrompt?.common(config);
+
+    const locale: string = config?.locale ?? getLocale.get();
+    const timezone: string = config?.timezone ?? getTimezone.get();
+
+    return AgenticaSystemPrompt.COMMON.replace("${locale}", locale).replace(
+      "${timezone}",
+      timezone,
+    );
+  };
+}
+
+const getLocale = new Singleton(() =>
+  isNode.get()
+    ? (process.env.LANG?.split(".")[0] ?? "en-US")
+    : navigator.language,
+);
+
+const getTimezone = new Singleton(
+  () => Intl.DateTimeFormat().resolvedOptions().timeZone,
+);
+
+const isNode = new Singleton(() => {
+  const isObject = (obj: any) => typeof obj === "object" && obj !== null;
+  return (
+    typeof global === "object" &&
+    isObject(global) &&
+    isObject(global.process) &&
+    isObject(global.process.versions) &&
+    typeof global.process.versions.node !== "undefined"
+  );
+});

package/src/internal/AgenticaOperationComposer.ts

@@ -1,82 +1,87 @@
-import { IAgenticaConfig } from "../structures/IAgenticaConfig";
-import { IAgenticaController } from "../structures/IAgenticaController";
-import { IAgenticaOperation } from "../structures/IAgenticaOperation";
-import { IAgenticaOperationCollection } from "../structures/IAgenticaOperationCollection";
-import { __map_take } from "./__map_take";
-
-export namespace AgenticaOperationComposer {
-  export const compose = (props: {
-    controllers: IAgenticaController[];
-    config?: IAgenticaConfig | undefined;
-  }): IAgenticaOperationCollection => {
-    const unique: boolean =
-      props.controllers.length === 1 ||
-      (() => {
-        const names: string[] = props.controllers
-          .map((controller) =>
-            controller.application.functions.map((func) => func.name),
-          )
-          .flat();
-        return new Set(names).size === names.length;
-      })();
-    const naming = (func: string, ci: number) =>
-      unique ? func : `_${ci}_${func}`;
-
-    const array: IAgenticaOperation[] = props.controllers
-      .map((controller, ci) =>
-        controller.protocol === "http"
-          ? controller.application.functions.map(
-              (func) =>
-                ({
-                  protocol: "http",
-                  controller,
-                  function: func,
-                  name: naming(func.name, ci),
-                }) satisfies IAgenticaOperation.IHttp,
-            )
-          : controller.application.functions.map(
-              (func) =>
-                ({
-                  protocol: "class",
-                  controller,
-                  function: func,
-                  name: naming(func.name, ci),
-                }) satisfies IAgenticaOperation.IClass,
-            ),
-      )
-      .flat();
-    const divided: IAgenticaOperation[][] | undefined =
-      !!props.config?.capacity && array.length > props.config.capacity
-        ? divideOperations({
-            array,
-            capacity: props.config.capacity,
-          })
-        : undefined;
-
-    const flat: Map<string, IAgenticaOperation> = new Map();
-    const group: Map<string, Map<string, IAgenticaOperation>> = new Map();
-    for (const item of array) {
-      flat.set(item.name, item);
-      __map_take(group, item.controller.name, () => new Map()).set(
-        item.name,
-        item,
-      );
-    }
-    return {
-      array,
-      divided,
-      flat,
-      group,
-    };
-  };
-
-  const divideOperations = (props: {
-    array: IAgenticaOperation[];
-    capacity: number;
-  }): IAgenticaOperation[][] => {
-    const size: number = Math.ceil(props.array.length / props.capacity);
-    const capacity: number = Math.ceil(props.array.length / size);
-    const replica: IAgenticaOperation[] = props.array.slice();
-    return new Array(size).fill(0).map(() => replica.splice(0, capacity));
-  };
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { IAgenticaConfig } from "../structures/IAgenticaConfig";
+import { IAgenticaController } from "../structures/IAgenticaController";
+import { IAgenticaOperation } from "../structures/IAgenticaOperation";
+import { IAgenticaOperationCollection } from "../structures/IAgenticaOperationCollection";
+import { __map_take } from "./__map_take";
+
+export namespace AgenticaOperationComposer {
+  export const compose = <Model extends ILlmSchema.Model>(props: {
+    controllers: IAgenticaController<Model>[];
+    config?: IAgenticaConfig<Model> | undefined;
+  }): IAgenticaOperationCollection<Model> => {
+    const unique: boolean =
+      props.controllers.length === 1 ||
+      (() => {
+        const names: string[] = props.controllers
+          .map((controller) =>
+            controller.application.functions.map((func) => func.name),
+          )
+          .flat();
+        return new Set(names).size === names.length;
+      })();
+    const naming = (func: string, ci: number) =>
+      unique ? func : `_${ci}_${func}`;
+
+    const array: IAgenticaOperation<Model>[] = props.controllers
+      .map((controller, ci) =>
+        controller.protocol === "http"
+          ? controller.application.functions.map(
+              (func) =>
+                ({
+                  protocol: "http",
+                  controller: controller,
+                  function: func,
+                  name: naming(func.name, ci),
+                }) satisfies IAgenticaOperation.IHttp<Model>,
+            )
+          : controller.application.functions.map(
+              (func) =>
+                ({
+                  protocol: "class",
+                  controller,
+                  function: func,
+                  name: naming(func.name, ci),
+                }) satisfies IAgenticaOperation.IClass<Model>,
+            ),
+      )
+      .flat();
+    const divided: IAgenticaOperation<Model>[][] | undefined =
+      !!props.config?.capacity && array.length > props.config.capacity
+        ? divideOperations({
+            array,
+            capacity: props.config.capacity,
+          })
+        : undefined;
+
+    const flat: Map<string, IAgenticaOperation<Model>> = new Map();
+    const group: Map<
+      string,
+      Map<string, IAgenticaOperation<Model>>
+    > = new Map();
+    for (const item of array) {
+      flat.set(item.name, item);
+      __map_take(group, item.controller.name, () => new Map()).set(
+        item.name,
+        item,
+      );
+    }
+    return {
+      array,
+      divided,
+      flat,
+      group,
+    };
+  };
+
+  const divideOperations = <Model extends ILlmSchema.Model>(props: {
+    array: IAgenticaOperation<Model>[];
+    capacity: number;
+  }): IAgenticaOperation<Model>[][] => {
+    const size: number = Math.ceil(props.array.length / props.capacity);
+    const capacity: number = Math.ceil(props.array.length / size);
+    const replica: IAgenticaOperation<Model>[] = props.array.slice();
+    return new Array(size).fill(0).map(() => replica.splice(0, capacity));
+  };
+}

package/src/internal/AgenticaPromptFactory.ts

@@ -1,30 +1,32 @@
-import { IAgenticaOperationSelection } from "../structures/IAgenticaOperationSelection";
-import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
-
-export namespace AgenticaPromptFactory {
-  export const execute = (
-    props: Omit<IAgenticaPrompt.IExecute, "toJSON">,
-  ): IAgenticaPrompt.IExecute =>
-    ({
-      ...props,
-      toJSON: () =>
-        ({
-          ...props,
-          controller: props.controller.name,
-          function: props.function.name,
-        }) as any,
-    }) as IAgenticaPrompt.IExecute;
-
-  export const selection = (
-    props: Omit<IAgenticaOperationSelection, "toJSON">,
-  ): IAgenticaOperationSelection =>
-    ({
-      ...props,
-      toJSON: () =>
-        ({
-          ...props,
-          controller: props.controller.name,
-          function: props.function.name,
-        }) as any,
-    }) as IAgenticaOperationSelection;
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { IAgenticaOperationSelection } from "../structures/IAgenticaOperationSelection";
+import { IAgenticaPrompt } from "../structures/IAgenticaPrompt";
+
+export namespace AgenticaPromptFactory {
+  export const execute = <Model extends ILlmSchema.Model>(
+    props: Omit<IAgenticaPrompt.IExecute<Model>, "toJSON">,
+  ): IAgenticaPrompt.IExecute<Model> =>
+    ({
+      ...props,
+      toJSON: () =>
+        ({
+          ...props,
+          controller: props.controller.name,
+          function: props.function.name,
+        }) as any,
+    }) as IAgenticaPrompt.IExecute<Model>;
+
+  export const selection = <Model extends ILlmSchema.Model>(
+    props: Omit<IAgenticaOperationSelection<Model>, "toJSON">,
+  ): IAgenticaOperationSelection<Model> =>
+    ({
+      ...props,
+      toJSON: () =>
+        ({
+          ...props,
+          controller: props.controller.name,
+          function: props.function.name,
+        }) as any,
+    }) as IAgenticaOperationSelection<Model>;
+}