@agentica/core 0.13.5 → 0.14.1

package/lib/events/AgenticaRequestEvent.js

@@ -1,22 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgenticaRequestEvent = void 0;
-const AgenticaEventBase_1 = require("./AgenticaEventBase");
-class AgenticaRequestEvent extends AgenticaEventBase_1.AgenticaEventBase {
-    constructor(props) {
-        super("request");
-        this.source = props.source;
-        this.body = props.body;
-        this.options = props.options;
-    }
-    toJSON() {
-        return {
-            type: "request",
-            source: this.source,
-            body: this.body,
-            options: this.options,
-        };
-    }
-}
-exports.AgenticaRequestEvent = AgenticaRequestEvent;
 //# sourceMappingURL=AgenticaRequestEvent.js.map

package/lib/events/AgenticaRequestEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgenticaRequestEvent.js","sourceRoot":"","sources":["../../src/events/AgenticaRequestEvent.ts"],"names":[],"mappings":";;;AAIA,2DAAwD;AAExD,MAAa,oBAAqB,SAAQ,qCAA4B;IAKpE,YAAmB,KAAkC;QACnD,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/B,CAAC;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AApBD,oDAoBC"}
+{"version":3,"file":"AgenticaRequestEvent.js","sourceRoot":"","sources":["../../src/events/AgenticaRequestEvent.ts"],"names":[],"mappings":""}

package/lib/events/AgenticaResponseEvent.d.ts

@@ -1,35 +1,25 @@
 import type OpenAI from "openai";
+import type { AgenticaEventBase } from "./AgenticaEventBase";
 import type { AgenticaEventSource } from "./AgenticaEventSource";
-import { AgenticaEventBase } from "./AgenticaEventBase";
-export declare class AgenticaResponseEvent extends AgenticaEventBase<"response"> {
-    readonly source: AgenticaEventSource;
-    readonly body: OpenAI.ChatCompletionCreateParamsStreaming;
-    readonly stream: ReadableStream<OpenAI.ChatCompletionChunk>;
-    readonly options?: OpenAI.RequestOptions | undefined;
-    readonly join: () => Promise<OpenAI.ChatCompletion>;
-    constructor(props: AgenticaResponseEvent.IProps);
-}
-export declare namespace AgenticaResponseEvent {
-    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>;
-    }
+export interface AgenticaResponseEvent extends AgenticaEventBase<"response"> {
+    /**
+     * The source agent of the response.
+     */
+    source: AgenticaEventSource;
+    /**
+     * Request body.
+     */
+    body: OpenAI.ChatCompletionCreateParamsStreaming;
+    /**
+     * The text content stream.
+     */
+    stream: ReadableStream<OpenAI.ChatCompletionChunk>;
+    /**
+     * Options for the request.
+     */
+    options?: OpenAI.RequestOptions | undefined;
+    /**
+     * Wait the completion.
+     */
+    join: () => Promise<OpenAI.ChatCompletion>;
 }

package/lib/events/AgenticaResponseEvent.js

@@ -1,16 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgenticaResponseEvent = void 0;
-const AgenticaEventBase_1 = require("./AgenticaEventBase");
-class AgenticaResponseEvent extends AgenticaEventBase_1.AgenticaEventBase {
-    constructor(props) {
-        super("response");
-        this.source = props.source;
-        this.body = props.body;
-        this.stream = props.stream;
-        this.options = props.options;
-        this.join = props.join;
-    }
-}
-exports.AgenticaResponseEvent = AgenticaResponseEvent;
 //# sourceMappingURL=AgenticaResponseEvent.js.map

package/lib/events/AgenticaResponseEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgenticaResponseEvent.js","sourceRoot":"","sources":["../../src/events/AgenticaResponseEvent.ts"],"names":[],"mappings":";;;AAGA,2DAAwD;AAExD,MAAa,qBAAsB,SAAQ,qCAA6B;IAOtE,YAAmB,KAAmC;QACpD,KAAK,CAAC,UAAU,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAfD,sDAeC"}
+{"version":3,"file":"AgenticaResponseEvent.js","sourceRoot":"","sources":["../../src/events/AgenticaResponseEvent.ts"],"names":[],"mappings":""}

package/lib/events/AgenticaSelectEvent.d.ts

@@ -1,16 +1,10 @@
 import type { ILlmSchema } from "@samchon/openapi";
 import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
 import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-import { AgenticaSelectPrompt } from "../prompts/AgenticaSelectPrompt";
-import { AgenticaEventBase } from "./AgenticaEventBase";
-export declare class AgenticaSelectEvent<Model extends ILlmSchema.Model> extends AgenticaEventBase<"select"> {
-    readonly selection: AgenticaOperationSelection<Model>;
-    constructor(props: AgenticaSelectEvent.IProps<Model>);
-    toJSON(): IAgenticaEventJson.ISelect;
-    toPrompt(): AgenticaSelectPrompt<Model>;
-}
-export declare namespace AgenticaSelectEvent {
-    interface IProps<Model extends ILlmSchema.Model> {
-        selection: AgenticaOperationSelection<Model>;
-    }
+import type { AgenticaSelectPrompt } from "../prompts/AgenticaSelectPrompt";
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+export interface AgenticaSelectEvent<Model extends ILlmSchema.Model> extends AgenticaEventBase<"select"> {
+    selection: AgenticaOperationSelection<Model>;
+    toJSON: () => IAgenticaEventJson.ISelect;
+    toPrompt: () => AgenticaSelectPrompt<Model>;
 }

package/lib/events/AgenticaSelectEvent.js

@@ -1,26 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgenticaSelectEvent = void 0;
-const uuid_1 = require("uuid");
-const AgenticaSelectPrompt_1 = require("../prompts/AgenticaSelectPrompt");
-const AgenticaEventBase_1 = require("./AgenticaEventBase");
-class AgenticaSelectEvent extends AgenticaEventBase_1.AgenticaEventBase {
-    constructor(props) {
-        super("select");
-        this.selection = props.selection;
-    }
-    toJSON() {
-        return {
-            type: "select",
-            selection: this.selection.toJSON(),
-        };
-    }
-    toPrompt() {
-        return new AgenticaSelectPrompt_1.AgenticaSelectPrompt({
-            id: (0, uuid_1.v4)(),
-            selections: [this.selection],
-        });
-    }
-}
-exports.AgenticaSelectEvent = AgenticaSelectEvent;
 //# sourceMappingURL=AgenticaSelectEvent.js.map

package/lib/events/AgenticaSelectEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgenticaSelectEvent.js","sourceRoot":"","sources":["../../src/events/AgenticaSelectEvent.ts"],"names":[],"mappings":";;;AAIA,+BAA0B;AAC1B,0EAAuE;AACvE,2DAAwD;AAExD,MAAa,mBAEX,SAAQ,qCAA2B;IAGnC,YAAmB,KAAwC;QACzD,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IACnC,CAAC;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;SACnC,CAAC;IACJ,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,2CAAoB,CAAC;YAC9B,EAAE,EAAE,IAAA,SAAE,GAAE;YACR,UAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC;CACF;AAvBD,kDAuBC"}
+{"version":3,"file":"AgenticaSelectEvent.js","sourceRoot":"","sources":["../../src/events/AgenticaSelectEvent.ts"],"names":[],"mappings":""}

package/lib/events/AgenticaTextEvent.d.ts

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

package/lib/events/AgenticaTextEvent.js

@@ -1,55 +1,3 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgenticaTextEvent = void 0;
-const AgenticaTextPrompt_1 = require("../prompts/AgenticaTextPrompt");
-const AgenticaEventBase_1 = require("./AgenticaEventBase");
-class AgenticaTextEvent extends AgenticaEventBase_1.AgenticaEventBase {
-    get text() {
-        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.
-     */
-    get done() {
-        return this.done_();
-    }
-    constructor(props) {
-        super("text");
-        this.role = props.role;
-        this.stream = props.stream;
-        this.done_ = props.done;
-        this.get_ = props.get;
-        this.join_ = props.join;
-    }
-    join() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.join_();
-        });
-    }
-    toJSON() {
-        return {
-            type: "text",
-            role: this.role,
-            text: this.text,
-            done: this.done,
-        };
-    }
-    toPrompt() {
-        return new AgenticaTextPrompt_1.AgenticaTextPrompt({
-            role: this.role,
-            text: this.text,
-        });
-    }
-}
-exports.AgenticaTextEvent = AgenticaTextEvent;
 //# sourceMappingURL=AgenticaTextEvent.js.map

package/lib/events/AgenticaTextEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgenticaTextEvent.js","sourceRoot":"","sources":["../../src/events/AgenticaTextEvent.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,sEAAmE;AACnE,2DAAwD;AAExD,MAAa,iBAAkB,SAAQ,qCAAyB;IAG9D,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,YAAmB,KAA+B;QAChD,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAE3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;IAC1B,CAAC;IAEY,IAAI;;YACf,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;KAAA;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;IACJ,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,uCAAkB,CAAC;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;CAKF;AAhDD,8CAgDC"}
+{"version":3,"file":"AgenticaTextEvent.js","sourceRoot":"","sources":["../../src/events/AgenticaTextEvent.ts"],"names":[],"mappings":""}

package/lib/events/AgenticaValidateEvent.d.ts

@@ -0,0 +1,25 @@
+import type { ILlmSchema } from "@samchon/openapi";
+import type { IValidation } from "typia";
+import type { AgenticaEventBase } from "./AgenticaEventBase";
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+/**
+ * Event of a validation feedback.
+ *
+ * @author Samchon
+ */
+export interface AgenticaValidateEvent<Model extends ILlmSchema.Model> extends AgenticaEventBase<"validate"> {
+    /**
+     * ID of the tool calling.
+     */
+    id: string;
+    /**
+     * Target operation to call.
+     */
+    operation: AgenticaOperation<Model>;
+    /**
+     * Validation result as a failure.
+     */
+    result: IValidation.IFailure;
+    toJSON: () => IAgenticaEventJson.IValidate;
+}

package/lib/events/AgenticaValidateEvent.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=AgenticaValidateEvent.js.map

package/lib/events/AgenticaValidateEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgenticaValidateEvent.js","sourceRoot":"","sources":["../../src/events/AgenticaValidateEvent.ts"],"names":[],"mappings":""}

package/lib/factory/events.d.ts

@@ -0,0 +1,65 @@
+import type { ILlmSchema, IValidation } from "@samchon/openapi";
+import type OpenAI from "openai";
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { AgenticaCallEvent } from "../events/AgenticaCallEvent";
+import type { AgenticaCancelEvent } from "../events/AgenticaCancelEvent";
+import type { AgenticaDescribeEvent } from "../events/AgenticaDescribeEvent";
+import type { AgenticaEventSource } from "../events/AgenticaEventSource";
+import type { AgenticaInitializeEvent } from "../events/AgenticaInitializeEvent";
+import type { AgenticaRequestEvent } from "../events/AgenticaRequestEvent";
+import type { AgenticaResponseEvent } from "../events/AgenticaResponseEvent";
+import type { AgenticaTextEvent } from "../events/AgenticaTextEvent";
+import type { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
+import type { AgenticaExecuteEvent } from "../events/AgenticaExecuteEvent";
+import type { AgenticaSelectEvent } from "../events/AgenticaSelectEvent";
+import type { AgenticaValidateEvent } from "../events/AgenticaValidateEvent";
+export declare function createInitializeEvent(): AgenticaInitializeEvent;
+export declare function createSelectEvent<Model extends ILlmSchema.Model>(props: {
+    selection: AgenticaOperationSelection<Model>;
+}): AgenticaSelectEvent<Model>;
+export declare function createCancelEvent<Model extends ILlmSchema.Model>(props: {
+    selection: AgenticaOperationSelection<Model>;
+}): AgenticaCancelEvent<Model>;
+export declare function createCallEvent<Model extends ILlmSchema.Model>(props: {
+    id: string;
+    operation: AgenticaOperation<Model>;
+    arguments: Record<string, any>;
+}): AgenticaCallEvent<Model>;
+export declare function createValidateEvent<Model extends ILlmSchema.Model>(props: {
+    id: string;
+    operation: AgenticaOperation<Model>;
+    result: IValidation.IFailure;
+}): AgenticaValidateEvent<Model>;
+export declare function createExecuteEvent<Model extends ILlmSchema.Model>(props: {
+    id: string;
+    operation: AgenticaOperation<Model>;
+    arguments: Record<string, unknown>;
+    value: unknown;
+}): AgenticaExecuteEvent<Model>;
+export declare function createTextEvent<Role extends "user" | "assistant">(props: {
+    role: Role;
+    stream: ReadableStream<string>;
+    done: () => boolean;
+    get: () => string;
+    join: () => Promise<string>;
+}): AgenticaTextEvent<Role>;
+export declare function createDescribeEvent<Model extends ILlmSchema.Model>(props: {
+    executes: AgenticaExecutePrompt<Model>[];
+    stream: ReadableStream<string>;
+    done: () => boolean;
+    get: () => string;
+    join: () => Promise<string>;
+}): AgenticaDescribeEvent<Model>;
+export declare function createRequestEvent(props: {
+    source: AgenticaEventSource;
+    body: OpenAI.ChatCompletionCreateParamsStreaming;
+    options?: OpenAI.RequestOptions | undefined;
+}): AgenticaRequestEvent;
+export declare function createResponseEvent(props: {
+    source: AgenticaEventSource;
+    body: OpenAI.ChatCompletionCreateParamsStreaming;
+    options?: OpenAI.RequestOptions | undefined;
+    stream: ReadableStream<OpenAI.ChatCompletionChunk>;
+    join: () => Promise<OpenAI.ChatCompletion>;
+}): AgenticaResponseEvent;

package/lib/factory/events.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInitializeEvent = createInitializeEvent;
+exports.createSelectEvent = createSelectEvent;
+exports.createCancelEvent = createCancelEvent;
+exports.createCallEvent = createCallEvent;
+exports.createValidateEvent = createValidateEvent;
+exports.createExecuteEvent = createExecuteEvent;
+exports.createTextEvent = createTextEvent;
+exports.createDescribeEvent = createDescribeEvent;
+exports.createRequestEvent = createRequestEvent;
+exports.createResponseEvent = createResponseEvent;
+const uuid_1 = require("uuid");
+const prompts_1 = require("./prompts");
+/* -----------------------------------------------------------
+    FUNCTION SELECTS
+  ----------------------------------------------------------- */
+function createInitializeEvent() {
+    const event = {
+        type: "initialize",
+    };
+    return {
+        type: event.type,
+        toJSON: () => event,
+    };
+}
+function createSelectEvent(props) {
+    return {
+        type: "select",
+        selection: props.selection,
+        toJSON: () => ({
+            type: "select",
+            selection: props.selection.toJSON(),
+        }),
+        toPrompt: () => (0, prompts_1.createSelectPrompt)({
+            id: (0, uuid_1.v4)(),
+            selections: [props.selection],
+        }),
+    };
+}
+function createCancelEvent(props) {
+    return {
+        type: "cancel",
+        selection: props.selection,
+        toJSON: () => ({
+            type: "cancel",
+            selection: props.selection.toJSON(),
+        }),
+    };
+}
+/* -----------------------------------------------------------
+    FUNCTION CALLS
+  ----------------------------------------------------------- */
+function createCallEvent(props) {
+    return {
+        type: "call",
+        id: props.id,
+        operation: props.operation,
+        arguments: props.arguments,
+        toJSON: () => ({
+            type: "call",
+            id: props.id,
+            operation: props.operation.toJSON(),
+            arguments: props.arguments,
+        }),
+    };
+}
+function createValidateEvent(props) {
+    return {
+        type: "validate",
+        id: props.id,
+        operation: props.operation,
+        result: props.result,
+        toJSON: () => ({
+            type: "validate",
+            id: props.id,
+            operation: props.operation.toJSON(),
+            result: props.result,
+        }),
+    };
+}
+function createExecuteEvent(props) {
+    return {
+        type: "execute",
+        protocol: props.operation.protocol,
+        id: props.id,
+        operation: props.operation,
+        arguments: props.arguments,
+        value: props.value,
+        toJSON: () => ({
+            type: "execute",
+            protocol: props.operation.protocol,
+            id: props.id,
+            operation: props.operation.toJSON(),
+            arguments: props.arguments,
+            value: props.value,
+        }),
+        toPrompt: () => (0, prompts_1.createExecutePrompt)(props),
+    };
+}
+/* -----------------------------------------------------------
+    TEXT STEAMING
+  ----------------------------------------------------------- */
+function createTextEvent(props) {
+    return {
+        type: "text",
+        role: props.role,
+        stream: props.stream,
+        join: props.join,
+        toJSON: () => ({
+            type: "text",
+            role: props.role,
+            done: props.done(),
+            text: props.get(),
+        }),
+        toPrompt: () => ({
+            type: "text",
+            role: props.role,
+            text: props.get(),
+            toJSON: () => ({
+                type: "text",
+                role: props.role,
+                text: props.get(),
+            }),
+        }),
+    };
+}
+function createDescribeEvent(props) {
+    return {
+        type: "describe",
+        executes: props.executes,
+        stream: props.stream,
+        join: props.join,
+        toJSON: () => ({
+            type: "describe",
+            executes: props.executes.map(execute => execute.toJSON()),
+            done: props.done(),
+            text: props.get(),
+        }),
+        toPrompt: () => ({
+            type: "describe",
+            executes: props.executes,
+            text: props.get(),
+            toJSON: () => ({
+                type: "describe",
+                executes: props.executes.map(execute => execute.toJSON()),
+                text: props.get(),
+            }),
+        }),
+    };
+}
+/* -----------------------------------------------------------
+    API REQUESTS
+  ----------------------------------------------------------- */
+function createRequestEvent(props) {
+    return {
+        type: "request",
+        source: props.source,
+        body: props.body,
+        options: props.options,
+    };
+}
+function createResponseEvent(props) {
+    return {
+        type: "response",
+        source: props.source,
+        body: props.body,
+        options: props.options,
+        stream: props.stream,
+        join: props.join,
+    };
+}
+//# sourceMappingURL=events.js.map

package/lib/factory/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/factory/events.ts"],"names":[],"mappings":"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"}

package/lib/factory/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./events";
+export * from "./operations";
+export * from "./prompts";

package/lib/factory/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./events"), exports);
+__exportStar(require("./operations"), exports);
+__exportStar(require("./prompts"), exports);
+//# sourceMappingURL=index.js.map

package/lib/factory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/factory/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,+CAA6B;AAC7B,4CAA0B"}

package/lib/factory/operations.d.ts

@@ -0,0 +1,7 @@
+import type { ILlmSchema } from "@samchon/openapi";
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+export declare function createOperationSelection<Model extends ILlmSchema.Model>(props: {
+    operation: AgenticaOperation<Model>;
+    reason: string;
+}): AgenticaOperationSelection<Model>;

package/lib/factory/operations.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOperationSelection = createOperationSelection;
+function createOperationSelection(props) {
+    return {
+        operation: props.operation,
+        reason: props.reason,
+        toJSON: () => ({
+            operation: props.operation.toJSON(),
+            reason: props.reason,
+        }),
+    };
+}
+//# sourceMappingURL=operations.js.map

package/lib/factory/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/factory/operations.ts"],"names":[],"mappings":";;AAIA,4DAYC;AAZD,SAAgB,wBAAwB,CAAiC,KAGxE;IACC,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACb,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE;YACnC,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;KACH,CAAC;AACJ,CAAC"}

package/lib/factory/prompts.d.ts

@@ -0,0 +1,30 @@
+import type { ILlmSchema } from "@samchon/openapi";
+import type { AgenticaTextPrompt } from "../prompts/AgenticaTextPrompt";
+import type { AgenticaDescribePrompt } from "../prompts/AgenticaDescribePrompt";
+import type { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { AgenticaSelectPrompt } from "../prompts/AgenticaSelectPrompt";
+import type { AgenticaCancelPrompt } from "../context/AgenticaCancelPrompt";
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+export declare function createTextPrompt<Role extends "assistant" | "user" = "assistant" | "user">(props: {
+    role: Role;
+    text: string;
+}): AgenticaTextPrompt<Role>;
+export declare function createDescribePrompt<Model extends ILlmSchema.Model>(props: {
+    executes: AgenticaExecutePrompt<Model>[];
+    text: string;
+}): AgenticaDescribePrompt<Model>;
+export declare function createSelectPrompt<Model extends ILlmSchema.Model>(props: {
+    id: string;
+    selections: AgenticaOperationSelection<Model>[];
+}): AgenticaSelectPrompt<Model>;
+export declare function createCancelPrompt<Model extends ILlmSchema.Model>(props: {
+    id: string;
+    selections: AgenticaOperationSelection<Model>[];
+}): AgenticaCancelPrompt<Model>;
+export declare function createExecutePrompt<Model extends ILlmSchema.Model>(props: {
+    id: string;
+    operation: AgenticaOperation<Model>;
+    arguments: Record<string, any>;
+    value: unknown;
+}): AgenticaExecutePrompt<Model>;