@agentica/core 0.12.0 → 0.12.2-dev.20250314

package/src/events/AgenticaCallEvent.ts

@@ -1,36 +1,36 @@
-import { ILlmSchema } from "@samchon/openapi";
-
-import { AgenticaOperation } from "../context/AgenticaOperation";
-import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-import { AgenticaEventBase } from "./AgenticaEventBase";
-
-export class AgenticaCallEvent<
-  Model extends ILlmSchema.Model,
-> extends AgenticaEventBase<"call"> {
-  public readonly id: string;
-  public readonly operation: AgenticaOperation<Model>;
-  public arguments: Record<string, any>;
-
-  public constructor(props: AgenticaCallEvent.IProps<Model>) {
-    super("call");
-    this.id = props.id;
-    this.operation = props.operation;
-    this.arguments = props.arguments;
-  }
-
-  public toJSON(): IAgenticaEventJson.ICall {
-    return {
-      type: "call",
-      id: this.id,
-      operation: this.operation.toJSON(),
-      arguments: this.arguments,
-    };
-  }
-}
-export namespace AgenticaCallEvent {
-  export interface IProps<Model extends ILlmSchema.Model> {
-    id: string;
-    operation: AgenticaOperation<Model>;
-    arguments: Record<string, any>;
-  }
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { AgenticaOperation } from "../context/AgenticaOperation";
+import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+import { AgenticaEventBase } from "./AgenticaEventBase";
+
+export class AgenticaCallEvent<
+  Model extends ILlmSchema.Model,
+> extends AgenticaEventBase<"call"> {
+  public readonly id: string;
+  public readonly operation: AgenticaOperation<Model>;
+  public arguments: Record<string, any>;
+
+  public constructor(props: AgenticaCallEvent.IProps<Model>) {
+    super("call");
+    this.id = props.id;
+    this.operation = props.operation;
+    this.arguments = props.arguments;
+  }
+
+  public toJSON(): IAgenticaEventJson.ICall {
+    return {
+      type: "call",
+      id: this.id,
+      operation: this.operation.toJSON(),
+      arguments: this.arguments,
+    };
+  }
+}
+export namespace AgenticaCallEvent {
+  export interface IProps<Model extends ILlmSchema.Model> {
+    id: string;
+    operation: AgenticaOperation<Model>;
+    arguments: Record<string, any>;
+  }
+}

package/src/events/AgenticaCancelEvent.ts

@@ -1,28 +1,28 @@
-import { ILlmSchema } from "@samchon/openapi";
-
-import { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
-import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-import { AgenticaEventBase } from "./AgenticaEventBase";
-
-export class AgenticaCancelEvent<
-  Model extends ILlmSchema.Model,
-> extends AgenticaEventBase<"cancel"> {
-  public readonly selection: AgenticaOperationSelection<Model>;
-
-  public constructor(props: AgenticaCancelEvent.IProps<Model>) {
-    super("cancel");
-    this.selection = props.selection;
-  }
-
-  public toJSON(): IAgenticaEventJson.ICancel {
-    return {
-      type: "cancel",
-      selection: this.selection.toJSON(),
-    };
-  }
-}
-export namespace AgenticaCancelEvent {
-  export interface IProps<Model extends ILlmSchema.Model> {
-    selection: AgenticaOperationSelection<Model>;
-  }
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+import { AgenticaEventBase } from "./AgenticaEventBase";
+
+export class AgenticaCancelEvent<
+  Model extends ILlmSchema.Model,
+> extends AgenticaEventBase<"cancel"> {
+  public readonly selection: AgenticaOperationSelection<Model>;
+
+  public constructor(props: AgenticaCancelEvent.IProps<Model>) {
+    super("cancel");
+    this.selection = props.selection;
+  }
+
+  public toJSON(): IAgenticaEventJson.ICancel {
+    return {
+      type: "cancel",
+      selection: this.selection.toJSON(),
+    };
+  }
+}
+export namespace AgenticaCancelEvent {
+  export interface IProps<Model extends ILlmSchema.Model> {
+    selection: AgenticaOperationSelection<Model>;
+  }
+}

package/src/events/AgenticaDescribeEvent.ts

@@ -1,66 +1,66 @@
-import { ILlmSchema } from "@samchon/openapi";
-
-import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-import { AgenticaDescribePrompt } from "../prompts/AgenticaDescribePrompt";
-import { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
-import { AgenticaEventBase } from "./AgenticaEventBase";
-
-export class AgenticaDescribeEvent<
-  Model extends ILlmSchema.Model,
-> extends AgenticaEventBase<"describe"> {
-  public readonly executes: AgenticaExecutePrompt<Model>[];
-  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: AgenticaDescribeEvent.IProps<Model>) {
-    super("describe");
-    this.stream = props.stream;
-    this.executes = props.executes;
-    this.done_ = props.done;
-    this.get_ = props.get;
-    this.join_ = props.join;
-  }
-
-  public join(): Promise<string> {
-    return this.join_();
-  }
-
-  public toJSON(): IAgenticaEventJson.IDescribe {
-    return {
-      type: "describe",
-      executes: this.executes.map((e) => e.toJSON()),
-      text: this.text,
-      done: this.done,
-    };
-  }
-
-  public toPrompt(): AgenticaDescribePrompt<Model> {
-    return new AgenticaDescribePrompt({
-      executes: this.executes,
-      text: this.text,
-    });
-  }
-
-  private readonly done_: () => boolean;
-  private readonly get_: () => string;
-  private readonly join_: () => Promise<string>;
-}
-export namespace AgenticaDescribeEvent {
-  export interface IProps<Model extends ILlmSchema.Model> {
-    executes: AgenticaExecutePrompt<Model>[];
-    stream: ReadableStream<string>;
-    done: () => boolean;
-    get: () => string;
-    join: () => Promise<string>;
-  }
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+import { AgenticaDescribePrompt } from "../prompts/AgenticaDescribePrompt";
+import { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
+import { AgenticaEventBase } from "./AgenticaEventBase";
+
+export class AgenticaDescribeEvent<
+  Model extends ILlmSchema.Model,
+> extends AgenticaEventBase<"describe"> {
+  public readonly executes: AgenticaExecutePrompt<Model>[];
+  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: AgenticaDescribeEvent.IProps<Model>) {
+    super("describe");
+    this.stream = props.stream;
+    this.executes = props.executes;
+    this.done_ = props.done;
+    this.get_ = props.get;
+    this.join_ = props.join;
+  }
+
+  public join(): Promise<string> {
+    return this.join_();
+  }
+
+  public toJSON(): IAgenticaEventJson.IDescribe {
+    return {
+      type: "describe",
+      executes: this.executes.map((e) => e.toJSON()),
+      text: this.text,
+      done: this.done,
+    };
+  }
+
+  public toPrompt(): AgenticaDescribePrompt<Model> {
+    return new AgenticaDescribePrompt({
+      executes: this.executes,
+      text: this.text,
+    });
+  }
+
+  private readonly done_: () => boolean;
+  private readonly get_: () => string;
+  private readonly join_: () => Promise<string>;
+}
+export namespace AgenticaDescribeEvent {
+  export interface IProps<Model extends ILlmSchema.Model> {
+    executes: AgenticaExecutePrompt<Model>[];
+    stream: ReadableStream<string>;
+    done: () => boolean;
+    get: () => string;
+    join: () => Promise<string>;
+  }
+}

package/src/events/AgenticaEvent.ts

@@ -1,36 +1,36 @@
-import { ILlmSchema } from "@samchon/openapi";
-
-import { AgenticaCallEvent } from "./AgenticaCallEvent";
-import { AgenticaCancelEvent } from "./AgenticaCancelEvent";
-import { AgenticaDescribeEvent } from "./AgenticaDescribeEvent";
-import { AgenticaExecuteEvent } from "./AgenticaExecuteEvent";
-import { AgenticaInitializeEvent } from "./AgenticaInitializeEvent";
-import { AgenticaRequestEvent } from "./AgenticaRequestEvent";
-import { AgenticaResponseEvent } from "./AgenticaResponseEvent";
-import { AgenticaSelectEvent } from "./AgenticaSelectEvent";
-import { AgenticaTextEvent } from "./AgenticaTextEvent";
-
-export type AgenticaEvent<Model extends ILlmSchema.Model> =
-  | AgenticaCallEvent<Model>
-  | AgenticaCancelEvent<Model>
-  | AgenticaDescribeEvent<Model>
-  | AgenticaExecuteEvent<Model>
-  | AgenticaInitializeEvent
-  | AgenticaRequestEvent
-  | AgenticaResponseEvent
-  | AgenticaSelectEvent<Model>
-  | AgenticaTextEvent;
-export namespace AgenticaEvent {
-  export type Type = AgenticaEvent<any>["type"];
-  export type Mapper<Model extends ILlmSchema.Model> = {
-    call: AgenticaCallEvent<Model>;
-    cancel: AgenticaCancelEvent<Model>;
-    describe: AgenticaDescribeEvent<Model>;
-    execute: AgenticaExecuteEvent<Model>;
-    initialize: AgenticaInitializeEvent;
-    request: AgenticaRequestEvent;
-    response: AgenticaResponseEvent;
-    select: AgenticaSelectEvent<Model>;
-    text: AgenticaTextEvent;
-  };
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { AgenticaCallEvent } from "./AgenticaCallEvent";
+import { AgenticaCancelEvent } from "./AgenticaCancelEvent";
+import { AgenticaDescribeEvent } from "./AgenticaDescribeEvent";
+import { AgenticaExecuteEvent } from "./AgenticaExecuteEvent";
+import { AgenticaInitializeEvent } from "./AgenticaInitializeEvent";
+import { AgenticaRequestEvent } from "./AgenticaRequestEvent";
+import { AgenticaResponseEvent } from "./AgenticaResponseEvent";
+import { AgenticaSelectEvent } from "./AgenticaSelectEvent";
+import { AgenticaTextEvent } from "./AgenticaTextEvent";
+
+export type AgenticaEvent<Model extends ILlmSchema.Model> =
+  | AgenticaCallEvent<Model>
+  | AgenticaCancelEvent<Model>
+  | AgenticaDescribeEvent<Model>
+  | AgenticaExecuteEvent<Model>
+  | AgenticaInitializeEvent
+  | AgenticaRequestEvent
+  | AgenticaResponseEvent
+  | AgenticaSelectEvent<Model>
+  | AgenticaTextEvent;
+export namespace AgenticaEvent {
+  export type Type = AgenticaEvent<any>["type"];
+  export type Mapper<Model extends ILlmSchema.Model> = {
+    call: AgenticaCallEvent<Model>;
+    cancel: AgenticaCancelEvent<Model>;
+    describe: AgenticaDescribeEvent<Model>;
+    execute: AgenticaExecuteEvent<Model>;
+    initialize: AgenticaInitializeEvent;
+    request: AgenticaRequestEvent;
+    response: AgenticaResponseEvent;
+    select: AgenticaSelectEvent<Model>;
+    text: AgenticaTextEvent;
+  };
+}

package/src/events/AgenticaEventBase.ts

@@ -1,7 +1,7 @@
-export abstract class AgenticaEventBase<Type extends string> {
-  public readonly type: Type;
-
-  public constructor(type: Type) {
-    this.type = type;
-  }
-}
+export abstract class AgenticaEventBase<Type extends string> {
+  public readonly type: Type;
+
+  public constructor(type: Type) {
+    this.type = type;
+  }
+}

package/src/events/AgenticaEventSource.ts

@@ -1,6 +1,6 @@
-export type AgenticaEventSource =
-  | "initialize"
-  | "select"
-  | "cancel"
-  | "call"
-  | "describe";
+export type AgenticaEventSource =
+  | "initialize"
+  | "select"
+  | "cancel"
+  | "call"
+  | "describe";

package/src/events/AgenticaExecuteEvent.ts

@@ -1,50 +1,50 @@
-import { ILlmSchema } from "@samchon/openapi";
-
-import { AgenticaOperation } from "../context/AgenticaOperation";
-import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-import { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
-import { AgenticaEventBase } from "./AgenticaEventBase";
-
-export class AgenticaExecuteEvent<
-  Model extends ILlmSchema.Model,
-> extends AgenticaEventBase<"execute"> {
-  public readonly id: string;
-  public readonly operation: AgenticaOperation<Model>;
-  public readonly arguments: Record<string, any>;
-  public readonly value: any;
-
-  public constructor(props: AgenticaExecuteEvent.IProps<Model>) {
-    super("execute");
-    this.id = props.id;
-    this.operation = props.operation;
-    this.arguments = props.arguments;
-    this.value = props.value;
-  }
-
-  public toJSON(): IAgenticaEventJson.IExecute {
-    return {
-      type: "execute",
-      id: this.id,
-      operation: this.operation.toJSON(),
-      arguments: this.arguments,
-      value: this.value,
-    };
-  }
-
-  public toPrompt(): AgenticaExecutePrompt<Model> {
-    return new AgenticaExecutePrompt({
-      id: this.id,
-      operation: this.operation,
-      arguments: this.arguments,
-      value: this.value,
-    });
-  }
-}
-export namespace AgenticaExecuteEvent {
-  export interface IProps<Model extends ILlmSchema.Model> {
-    id: string;
-    operation: AgenticaOperation<Model>;
-    arguments: Record<string, any>;
-    value: any;
-  }
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+import { AgenticaOperation } from "../context/AgenticaOperation";
+import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+import { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
+import { AgenticaEventBase } from "./AgenticaEventBase";
+
+export class AgenticaExecuteEvent<
+  Model extends ILlmSchema.Model,
+> extends AgenticaEventBase<"execute"> {
+  public readonly id: string;
+  public readonly operation: AgenticaOperation<Model>;
+  public readonly arguments: Record<string, any>;
+  public readonly value: any;
+
+  public constructor(props: AgenticaExecuteEvent.IProps<Model>) {
+    super("execute");
+    this.id = props.id;
+    this.operation = props.operation;
+    this.arguments = props.arguments;
+    this.value = props.value;
+  }
+
+  public toJSON(): IAgenticaEventJson.IExecute {
+    return {
+      type: "execute",
+      id: this.id,
+      operation: this.operation.toJSON(),
+      arguments: this.arguments,
+      value: this.value,
+    };
+  }
+
+  public toPrompt(): AgenticaExecutePrompt<Model> {
+    return new AgenticaExecutePrompt({
+      id: this.id,
+      operation: this.operation,
+      arguments: this.arguments,
+      value: this.value,
+    });
+  }
+}
+export namespace AgenticaExecuteEvent {
+  export interface IProps<Model extends ILlmSchema.Model> {
+    id: string;
+    operation: AgenticaOperation<Model>;
+    arguments: Record<string, any>;
+    value: any;
+  }
+}

package/src/events/AgenticaInitializeEvent.ts

@@ -1,14 +1,14 @@
-import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-import { AgenticaEventBase } from "./AgenticaEventBase";
-
-export class AgenticaInitializeEvent extends AgenticaEventBase<"initialize"> {
-  public constructor() {
-    super("initialize");
-  }
-
-  public toJSON(): IAgenticaEventJson.IInitialize {
-    return {
-      type: "initialize",
-    };
-  }
-}
+import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+import { AgenticaEventBase } from "./AgenticaEventBase";
+
+export class AgenticaInitializeEvent extends AgenticaEventBase<"initialize"> {
+  public constructor() {
+    super("initialize");
+  }
+
+  public toJSON(): IAgenticaEventJson.IInitialize {
+    return {
+      type: "initialize",
+    };
+  }
+}

package/src/events/AgenticaRequestEvent.ts

@@ -1,45 +1,45 @@
-import OpenAI from "openai";
-
-import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-import { AgenticaEventBase } from "./AgenticaEventBase";
-import { AgenticaEventSource } from "./AgenticaEventSource";
-
-export class AgenticaRequestEvent extends AgenticaEventBase<"request"> {
-  public readonly source: AgenticaEventSource;
-  public readonly body: OpenAI.ChatCompletionCreateParamsStreaming;
-  public readonly options?: OpenAI.RequestOptions | undefined;
-
-  public constructor(props: AgenticaRequestEvent.IProps) {
-    super("request");
-    this.source = props.source;
-    this.body = props.body;
-    this.options = props.options;
-  }
-
-  public toJSON(): IAgenticaEventJson.IRequest {
-    return {
-      type: "request",
-      source: this.source,
-      body: this.body,
-      options: this.options,
-    };
-  }
-}
-export namespace AgenticaRequestEvent {
-  export interface IProps {
-    /**
-     * The source agent of the request.
-     */
-    source: AgenticaEventSource;
-
-    /**
-     * Request body.
-     */
-    body: OpenAI.ChatCompletionCreateParamsStreaming;
-
-    /**
-     * Options for the request.
-     */
-    options?: OpenAI.RequestOptions | undefined;
-  }
-}
+import OpenAI from "openai";
+
+import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+import { AgenticaEventBase } from "./AgenticaEventBase";
+import { AgenticaEventSource } from "./AgenticaEventSource";
+
+export class AgenticaRequestEvent extends AgenticaEventBase<"request"> {
+  public readonly source: AgenticaEventSource;
+  public readonly body: OpenAI.ChatCompletionCreateParamsStreaming;
+  public readonly options?: OpenAI.RequestOptions | undefined;
+
+  public constructor(props: AgenticaRequestEvent.IProps) {
+    super("request");
+    this.source = props.source;
+    this.body = props.body;
+    this.options = props.options;
+  }
+
+  public toJSON(): IAgenticaEventJson.IRequest {
+    return {
+      type: "request",
+      source: this.source,
+      body: this.body,
+      options: this.options,
+    };
+  }
+}
+export namespace AgenticaRequestEvent {
+  export interface IProps {
+    /**
+     * The source agent of the request.
+     */
+    source: AgenticaEventSource;
+
+    /**
+     * Request body.
+     */
+    body: OpenAI.ChatCompletionCreateParamsStreaming;
+
+    /**
+     * Options for the request.
+     */
+    options?: OpenAI.RequestOptions | undefined;
+  }
+}