@agentica/core 0.12.0 → 0.12.2-dev.20250314

package/src/events/AgenticaResponseEvent.ts

@@ -1,48 +1,48 @@
-import OpenAI from "openai";
-
-import { AgenticaEventBase } from "./AgenticaEventBase";
-import { AgenticaEventSource } from "./AgenticaEventSource";
-
-export class AgenticaResponseEvent extends AgenticaEventBase<"response"> {
-  public readonly source: AgenticaEventSource;
-  public readonly body: OpenAI.ChatCompletionCreateParamsStreaming;
-  public readonly stream: ReadableStream<OpenAI.ChatCompletionChunk>;
-  public readonly options?: OpenAI.RequestOptions | undefined;
-  public readonly join: () => Promise<OpenAI.ChatCompletion>;
-
-  public constructor(props: AgenticaResponseEvent.IProps) {
-    super("response");
-    this.source = props.source;
-    this.body = props.body;
-    this.stream = props.stream;
-    this.options = props.options;
-    this.join = props.join;
-  }
-}
-export namespace AgenticaResponseEvent {
-  export interface IProps {
-    /**
-     * The source agent of the response.
-     */
-    source: AgenticaEventSource;
-
-    /**
-     * Request body.
-     */
-    body: OpenAI.ChatCompletionCreateParamsStreaming;
-
-    /**
-     * Options for the request.
-     */
-    options?: OpenAI.RequestOptions | undefined;
-    /**
-     * The text content stream.
-     */
-    stream: ReadableStream<OpenAI.ChatCompletionChunk>;
-
-    /**
-     * Get the description text.
-     */
-    join: () => Promise<OpenAI.ChatCompletion>;
-  }
-}
+import OpenAI from "openai";
+
+import { AgenticaEventBase } from "./AgenticaEventBase";
+import { AgenticaEventSource } from "./AgenticaEventSource";
+
+export class AgenticaResponseEvent extends AgenticaEventBase<"response"> {
+  public readonly source: AgenticaEventSource;
+  public readonly body: OpenAI.ChatCompletionCreateParamsStreaming;
+  public readonly stream: ReadableStream<OpenAI.ChatCompletionChunk>;
+  public readonly options?: OpenAI.RequestOptions | undefined;
+  public readonly join: () => Promise<OpenAI.ChatCompletion>;
+
+  public constructor(props: AgenticaResponseEvent.IProps) {
+    super("response");
+    this.source = props.source;
+    this.body = props.body;
+    this.stream = props.stream;
+    this.options = props.options;
+    this.join = props.join;
+  }
+}
+export namespace AgenticaResponseEvent {
+  export interface IProps {
+    /**
+     * The source agent of the response.
+     */
+    source: AgenticaEventSource;
+
+    /**
+     * Request body.
+     */
+    body: OpenAI.ChatCompletionCreateParamsStreaming;
+
+    /**
+     * Options for the request.
+     */
+    options?: OpenAI.RequestOptions | undefined;
+    /**
+     * The text content stream.
+     */
+    stream: ReadableStream<OpenAI.ChatCompletionChunk>;
+
+    /**
+     * Get the description text.
+     */
+    join: () => Promise<OpenAI.ChatCompletion>;
+  }
+}

package/src/events/AgenticaSelectEvent.ts

@@ -1,37 +1,37 @@
-import { ILlmSchema } from "@samchon/openapi";
-import { v4 } from "uuid";
-
-import { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
-import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-import { AgenticaSelectPrompt } from "../prompts/AgenticaSelectPrompt";
-import { AgenticaEventBase } from "./AgenticaEventBase";
-
-export class AgenticaSelectEvent<
-  Model extends ILlmSchema.Model,
-> extends AgenticaEventBase<"select"> {
-  public readonly selection: AgenticaOperationSelection<Model>;
-
-  public constructor(props: AgenticaSelectEvent.IProps<Model>) {
-    super("select");
-    this.selection = props.selection;
-  }
-
-  public toJSON(): IAgenticaEventJson.ISelect {
-    return {
-      type: "select",
-      selection: this.selection.toJSON(),
-    };
-  }
-
-  public toPrompt(): AgenticaSelectPrompt<Model> {
-    return new AgenticaSelectPrompt({
-      id: v4(),
-      selections: [this.selection],
-    });
-  }
-}
-export namespace AgenticaSelectEvent {
-  export interface IProps<Model extends ILlmSchema.Model> {
-    selection: AgenticaOperationSelection<Model>;
-  }
-}
+import { ILlmSchema } from "@samchon/openapi";
+import { v4 } from "uuid";
+
+import { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+import { AgenticaSelectPrompt } from "../prompts/AgenticaSelectPrompt";
+import { AgenticaEventBase } from "./AgenticaEventBase";
+
+export class AgenticaSelectEvent<
+  Model extends ILlmSchema.Model,
+> extends AgenticaEventBase<"select"> {
+  public readonly selection: AgenticaOperationSelection<Model>;
+
+  public constructor(props: AgenticaSelectEvent.IProps<Model>) {
+    super("select");
+    this.selection = props.selection;
+  }
+
+  public toJSON(): IAgenticaEventJson.ISelect {
+    return {
+      type: "select",
+      selection: this.selection.toJSON(),
+    };
+  }
+
+  public toPrompt(): AgenticaSelectPrompt<Model> {
+    return new AgenticaSelectPrompt({
+      id: v4(),
+      selections: [this.selection],
+    });
+  }
+}
+export namespace AgenticaSelectEvent {
+  export interface IProps<Model extends ILlmSchema.Model> {
+    selection: AgenticaOperationSelection<Model>;
+  }
+}

package/src/events/AgenticaTextEvent.ts

@@ -1,62 +1,62 @@
-import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-import { AgenticaTextPrompt } from "../prompts/AgenticaTextPrompt";
-import { AgenticaEventBase } from "./AgenticaEventBase";
-
-export class AgenticaTextEvent extends AgenticaEventBase<"text"> {
-  public readonly role: "assistant" | "user";
-  public readonly stream: ReadableStream<string>;
-  public get text(): string {
-    return this.get_();
-  }
-
-  /**
-   * Check if the join method can return a response immediately.
-   * Returns true if the response is ready to be returned by the join method.
-   */
-  public get done(): boolean {
-    return this.done_();
-  }
-
-  public constructor(props: AgenticaTextEvent.IProps) {
-    super("text");
-    this.role = props.role;
-    this.stream = props.stream;
-
-    this.done_ = props.done;
-    this.get_ = props.get;
-    this.join_ = props.join;
-  }
-
-  public join(): Promise<string> {
-    return this.join_();
-  }
-
-  public toJSON(): IAgenticaEventJson.IText {
-    return {
-      type: "text",
-      role: this.role,
-      text: this.text,
-      done: this.done,
-    };
-  }
-
-  public toPrompt(): AgenticaTextPrompt {
-    return new AgenticaTextPrompt({
-      role: this.role,
-      text: this.text,
-    });
-  }
-
-  private readonly done_: () => boolean;
-  private readonly get_: () => string;
-  private readonly join_: () => Promise<string>;
-}
-export namespace AgenticaTextEvent {
-  export interface IProps {
-    role: "assistant" | "user";
-    stream: ReadableStream<string>;
-    done: () => boolean;
-    get: () => string;
-    join: () => Promise<string>;
-  }
-}
+import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+import { AgenticaTextPrompt } from "../prompts/AgenticaTextPrompt";
+import { AgenticaEventBase } from "./AgenticaEventBase";
+
+export class AgenticaTextEvent extends AgenticaEventBase<"text"> {
+  public readonly role: "assistant" | "user";
+  public readonly stream: ReadableStream<string>;
+  public get text(): string {
+    return this.get_();
+  }
+
+  /**
+   * Check if the join method can return a response immediately.
+   * Returns true if the response is ready to be returned by the join method.
+   */
+  public get done(): boolean {
+    return this.done_();
+  }
+
+  public constructor(props: AgenticaTextEvent.IProps) {
+    super("text");
+    this.role = props.role;
+    this.stream = props.stream;
+
+    this.done_ = props.done;
+    this.get_ = props.get;
+    this.join_ = props.join;
+  }
+
+  public join(): Promise<string> {
+    return this.join_();
+  }
+
+  public toJSON(): IAgenticaEventJson.IText {
+    return {
+      type: "text",
+      role: this.role,
+      text: this.text,
+      done: this.done,
+    };
+  }
+
+  public toPrompt(): AgenticaTextPrompt {
+    return new AgenticaTextPrompt({
+      role: this.role,
+      text: this.text,
+    });
+  }
+
+  private readonly done_: () => boolean;
+  private readonly get_: () => string;
+  private readonly join_: () => Promise<string>;
+}
+export namespace AgenticaTextEvent {
+  export interface IProps {
+    role: "assistant" | "user";
+    stream: ReadableStream<string>;
+    done: () => boolean;
+    get: () => string;
+    join: () => Promise<string>;
+  }
+}

package/src/functional/assertHttpLlmApplication.ts

@@ -1,55 +1,55 @@
-import {
-  HttpLlm,
-  IHttpLlmApplication,
-  ILlmSchema,
-  OpenApi,
-  OpenApiV3,
-  OpenApiV3_1,
-  SwaggerV2,
-} from "@samchon/openapi";
-import typia from "typia";
-
-/**
- * Create an HTTP LLM application instance with type assertion.
- *
- * 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 `assertHttpLlmApplication` function
- * supports every version of Swagger/OpenAPI specification, there can
- * be a type error in the given document. In that case, the function
- * will throw an error with detailed type error tracing information.
- *
- * @param props Properties to create the HTTP LLM application instance
- * @returns  HTTP LLM application instance
- * @throws {@link TypeGuardError} when the given document is invalid
- * @author Samchon
- */
-export const assertHttpLlmApplication = <
-  Model extends ILlmSchema.Model,
->(props: {
-  /**
-   * Target LLM model.
-   */
-  model: Model;
-
-  /**
-   * 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<Model>>;
-}): IHttpLlmApplication<Model> =>
-  HttpLlm.application({
-    model: props.model,
-    document: OpenApi.convert(typia.assert(props.document)),
-    options: props.options,
-  });
+import {
+  HttpLlm,
+  IHttpLlmApplication,
+  ILlmSchema,
+  OpenApi,
+  OpenApiV3,
+  OpenApiV3_1,
+  SwaggerV2,
+} from "@samchon/openapi";
+import typia from "typia";
+
+/**
+ * Create an HTTP LLM application instance with type assertion.
+ *
+ * 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 `assertHttpLlmApplication` function
+ * supports every version of Swagger/OpenAPI specification, there can
+ * be a type error in the given document. In that case, the function
+ * will throw an error with detailed type error tracing information.
+ *
+ * @param props Properties to create the HTTP LLM application instance
+ * @returns  HTTP LLM application instance
+ * @throws {@link TypeGuardError} when the given document is invalid
+ * @author Samchon
+ */
+export const assertHttpLlmApplication = <
+  Model extends ILlmSchema.Model,
+>(props: {
+  /**
+   * Target LLM model.
+   */
+  model: Model;
+
+  /**
+   * 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<Model>>;
+}): IHttpLlmApplication<Model> =>
+  HttpLlm.application({
+    model: props.model,
+    document: OpenApi.convert(typia.assert(props.document)),
+    options: props.options,
+  });

package/src/functional/validateHttpLlmApplication.ts

@@ -1,66 +1,66 @@
-import {
-  HttpLlm,
-  IHttpLlmApplication,
-  ILlmSchema,
-  OpenApi,
-  OpenApiV3,
-  OpenApiV3_1,
-  SwaggerV2,
-} from "@samchon/openapi";
-import typia, { IValidation } from "typia";
-
-/**
- * Create an HTTP LLM application instance with type validation.
- *
- * 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 `validateHttpLlmApplication` 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 validateHttpLlmApplication = <
-  Model extends ILlmSchema.Model,
->(props: {
-  /**
-   * Target LLM model.
-   */
-  model: Model;
-
-  /**
-   * 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<Model>>;
-}): IValidation<IHttpLlmApplication<Model>> => {
-  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,
+  ILlmSchema,
+  OpenApi,
+  OpenApiV3,
+  OpenApiV3_1,
+  SwaggerV2,
+} from "@samchon/openapi";
+import typia, { IValidation } from "typia";
+
+/**
+ * Create an HTTP LLM application instance with type validation.
+ *
+ * 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 `validateHttpLlmApplication` 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 validateHttpLlmApplication = <
+  Model extends ILlmSchema.Model,
+>(props: {
+  /**
+   * Target LLM model.
+   */
+  model: Model;
+
+  /**
+   * 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<Model>>;
+}): IValidation<IHttpLlmApplication<Model>> => {
+  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,44 +1,44 @@
-// STRUCTURES
-export * from "./structures/IAgenticaConfig";
-export * from "./structures/IAgenticaController";
-export * from "./structures/IAgenticaExecutor";
-export * from "./structures/IAgenticaProps";
-export * from "./structures/IAgenticaVendor";
-export * from "./structures/IAgenticaSystemPrompt";
-
-export * from "./json/IAgenticaEventJson";
-export * from "./json/IAgenticaOperationJson";
-export * from "./json/IAgenticaOperationSelectionJson";
-export * from "./json/IAgenticaPromptJson";
-export * from "./json/IAgenticaTokenUsageJson";
-
-// CONTEXT
-export * from "./context/AgenticaContext";
-export * from "./context/AgenticaOperation";
-export * from "./context/AgenticaOperationCollection";
-export * from "./context/AgenticaOperationSelection";
-export * from "./context/AgenticaTokenUsage";
-
-export * from "./prompts/AgenticaPrompt";
-export * from "./prompts/AgenticaCancelPrompt";
-export * from "./prompts/AgenticaDescribePrompt";
-export * from "./prompts/AgenticaExecutePrompt";
-export * from "./prompts/AgenticaSelectPrompt";
-export * from "./prompts/AgenticaTextPrompt";
-
-// EVENTS
-export * from "./events/AgenticaEvent";
-export * from "./events/AgenticaCallEvent";
-export * from "./events/AgenticaCancelEvent";
-export * from "./events/AgenticaDescribeEvent";
-export * from "./events/AgenticaEventSource";
-export * from "./events/AgenticaExecuteEvent";
-export * from "./events/AgenticaRequestEvent";
-export * from "./events/AgenticaResponseEvent";
-export * from "./events/AgenticaSelectEvent";
-export * from "./events/AgenticaTextEvent";
-
-// FACADE CLASS
-export * from "./functional/assertHttpLlmApplication";
-export * from "./functional/validateHttpLlmApplication";
-export * from "./Agentica";
+// STRUCTURES
+export * from "./structures/IAgenticaConfig";
+export * from "./structures/IAgenticaController";
+export * from "./structures/IAgenticaExecutor";
+export * from "./structures/IAgenticaProps";
+export * from "./structures/IAgenticaVendor";
+export * from "./structures/IAgenticaSystemPrompt";
+
+export * from "./json/IAgenticaEventJson";
+export * from "./json/IAgenticaOperationJson";
+export * from "./json/IAgenticaOperationSelectionJson";
+export * from "./json/IAgenticaPromptJson";
+export * from "./json/IAgenticaTokenUsageJson";
+
+// CONTEXT
+export * from "./context/AgenticaContext";
+export * from "./context/AgenticaOperation";
+export * from "./context/AgenticaOperationCollection";
+export * from "./context/AgenticaOperationSelection";
+export * from "./context/AgenticaTokenUsage";
+
+export * from "./prompts/AgenticaPrompt";
+export * from "./prompts/AgenticaCancelPrompt";
+export * from "./prompts/AgenticaDescribePrompt";
+export * from "./prompts/AgenticaExecutePrompt";
+export * from "./prompts/AgenticaSelectPrompt";
+export * from "./prompts/AgenticaTextPrompt";
+
+// EVENTS
+export * from "./events/AgenticaEvent";
+export * from "./events/AgenticaCallEvent";
+export * from "./events/AgenticaCancelEvent";
+export * from "./events/AgenticaDescribeEvent";
+export * from "./events/AgenticaEventSource";
+export * from "./events/AgenticaExecuteEvent";
+export * from "./events/AgenticaRequestEvent";
+export * from "./events/AgenticaResponseEvent";
+export * from "./events/AgenticaSelectEvent";
+export * from "./events/AgenticaTextEvent";
+
+// FACADE CLASS
+export * from "./functional/assertHttpLlmApplication";
+export * from "./functional/validateHttpLlmApplication";
+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;
+}