@agentica/core 0.15.7 → 0.16.1

package/lib/events/MicroAgenticaEvent.d.ts

@@ -0,0 +1,32 @@
+import type { ILlmSchema } from "@samchon/openapi";
+import type { AgenticaCallEvent } from "./AgenticaCallEvent";
+import type { AgenticaDescribeEvent } from "./AgenticaDescribeEvent";
+import type { AgenticaExecuteEvent } from "./AgenticaExecuteEvent";
+import type { AgenticaRequestEvent } from "./AgenticaRequestEvent";
+import type { AgenticaResponseEvent } from "./AgenticaResponseEvent";
+import type { AgenticaTextEvent } from "./AgenticaTextEvent";
+import type { AgenticaValidateEvent } from "./AgenticaValidateEvent";
+/**
+ * Micro Agentica agent event.
+ *
+ * `MicroAgenticaEvent` is an union type of all possible events that
+ * can be emitted by the AI chatbot of the {@link MicroAgentica} class.
+ *
+ * You can discriminate the subtype by checking the {@link type} property.
+ *
+ * @author Samchon
+ */
+export type MicroAgenticaEvent<Model extends ILlmSchema.Model> = AgenticaCallEvent<Model> | AgenticaDescribeEvent<Model> | AgenticaExecuteEvent<Model> | AgenticaRequestEvent | AgenticaResponseEvent | AgenticaTextEvent | AgenticaValidateEvent<Model>;
+export declare namespace MicroAgenticaEvent {
+    type Type = MicroAgenticaEvent<any>["type"];
+    interface Mapper<Model extends ILlmSchema.Model> {
+        call: AgenticaCallEvent<Model>;
+        describe: AgenticaDescribeEvent<Model>;
+        execute: AgenticaExecuteEvent<Model>;
+        request: AgenticaRequestEvent;
+        response: AgenticaResponseEvent;
+        text: AgenticaTextEvent;
+        validate: AgenticaValidateEvent<Model>;
+    }
+    type Source = "call" | "describe";
+}

package/lib/{prompts/AgenticaTextPrompt.js → events/MicroAgenticaEvent.js}

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

package/lib/events/MicroAgenticaEvent.js.map

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

package/lib/factory/events.d.ts

@@ -13,7 +13,7 @@ import type { AgenticaResponseEvent } from "../events/AgenticaResponseEvent";
 import type { AgenticaSelectEvent } from "../events/AgenticaSelectEvent";
 import type { AgenticaTextEvent } from "../events/AgenticaTextEvent";
 import type { AgenticaValidateEvent } from "../events/AgenticaValidateEvent";
-import type { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
+import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
 export declare function createInitializeEvent(): AgenticaInitializeEvent;
 export declare function createSelectEvent<Model extends ILlmSchema.Model>(props: {
     selection: AgenticaOperationSelection<Model>;
@@ -45,7 +45,7 @@ export declare function createTextEvent<Role extends "user" | "assistant">(props
     join: () => Promise<string>;
 }): AgenticaTextEvent<Role>;
 export declare function createDescribeEvent<Model extends ILlmSchema.Model>(props: {
-    executes: AgenticaExecutePrompt<Model>[];
+    executes: AgenticaExecuteHistory<Model>[];
     stream: ReadableStream<string>;
     done: () => boolean;
     get: () => string;

package/lib/factory/events.js

@@ -11,7 +11,7 @@ exports.createDescribeEvent = createDescribeEvent;
 exports.createRequestEvent = createRequestEvent;
 exports.createResponseEvent = createResponseEvent;
 const uuid_1 = require("uuid");
-const prompts_1 = require("./prompts");
+const histories_1 = require("./histories");
 /* -----------------------------------------------------------
   FUNCTION SELECTS
 ----------------------------------------------------------- */
@@ -32,7 +32,7 @@ function createSelectEvent(props) {
             type: "select",
             selection: props.selection.toJSON(),
         }),
-        toPrompt: () => (0, prompts_1.createSelectPrompt)({
+        toHistory: () => (0, histories_1.createSelectHistory)({
             id: (0, uuid_1.v4)(),
             selections: [props.selection],
         }),
@@ -95,7 +95,7 @@ function createExecuteEvent(props) {
             arguments: props.arguments,
             value: props.value,
         }),
-        toPrompt: () => (0, prompts_1.createExecutePrompt)(props),
+        toHistory: () => (0, histories_1.createExecuteHistory)(props),
     };
 }
 /* -----------------------------------------------------------
@@ -113,7 +113,7 @@ function createTextEvent(props) {
             done: props.done(),
             text: props.get(),
         }),
-        toPrompt: () => ({
+        toHistory: () => ({
             type: "text",
             role: props.role,
             text: props.get(),
@@ -137,7 +137,7 @@ function createDescribeEvent(props) {
             done: props.done(),
             text: props.get(),
         }),
-        toPrompt: () => ({
+        toHistory: () => ({
             type: "describe",
             executes: props.executes,
             text: props.get(),

package/lib/factory/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/factory/events.ts"],"names":[],"mappings":";;AA0BA,sDAQC;AAED,8CAeC;AAED,8CAWC;AAKD,0CAiBC;AAED,kDAiBC;AAED,gDAwBC;AAKD,0CA6BC;AAED,kDA6BC;AAKD,gDAWC;AAED,kDAeC;AAlOD,+BAA0B;AAkB1B,uCAAoE;AAEpE;;8DAE8D;AAC9D,SAAgB,qBAAqB;IACnC,MAAM,KAAK,GAAmC;QAC5C,IAAI,EAAE,YAAY;KACnB,CAAC;IACF,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC;AAED,SAAgB,iBAAiB,CAAiC,KAEjE;IACC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACb,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE;SACpC,CAAC;QACF,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAA,4BAAkB,EAAC;YACjC,EAAE,EAAE,IAAA,SAAE,GAAE;YACR,UAAU,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;SAC9B,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAgB,iBAAiB,CAAiC,KAEjE;IACC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACb,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE;SACpC,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;8DAE8D;AAC9D,SAAgB,eAAe,CAAiC,KAI/D;IACC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACb,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE;YACnC,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAgB,mBAAmB,CAAiC,KAInE;IACC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACb,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE;YACnC,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAiC,KAKlE;IACC,OAAO;QACL,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,QAAmB;QAC7C,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,SAAS,EAAE,KAAK,CAAC,SAA2C;QAC5D,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAY;QACzB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACb,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,QAAmB;YAC7C,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE;YACnC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;QACF,QAAQ,EAAE,GAAG,EAAE,CACb,IAAA,6BAAmB,EAAC,KAAK,CAAuC;KACnE,CAAC;AACJ,CAAC;AAED;;8DAE8D;AAC9D,SAAgB,eAAe,CAAoC,KAMlE;IACC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACb,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;YAClB,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE;SAClB,CAAC;QACF,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;YACf,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE;YACjB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;gBACb,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE;aAClB,CAAC;SACH,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAgB,mBAAmB,CAAiC,KAMnE;IACC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACb,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACzD,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;YAClB,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE;SAClB,CAAC;QACF,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;YACf,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE;YACjB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;gBACb,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACzD,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE;aAClB,CAAC;SACH,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;gEAEgE;AAChE,SAAgB,kBAAkB,CAAC,KAIlC;IACC,OAAO;QACL,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC;AAED,SAAgB,mBAAmB,CAAC,KAMnC;IACC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/factory/events.ts"],"names":[],"mappings":"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"}

package/lib/factory/histories.d.ts

@@ -0,0 +1,33 @@
+import type { ILlmSchema } from "@samchon/openapi";
+import type OpenAI from "openai";
+import type { AgenticaCancelPrompt } from "../context/AgenticaCancelPrompt";
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
+import type { AgenticaDescribeHistory } from "../histories/AgenticaDescribeHistory";
+import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
+import type { AgenticaHistory } from "../histories/AgenticaHistory";
+import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
+import type { AgenticaTextHistory } from "../histories/AgenticaTextHistory";
+export declare function decodeHistory<Model extends ILlmSchema.Model>(history: AgenticaHistory<Model>): OpenAI.ChatCompletionMessageParam[];
+export declare function createTextHistory<Role extends "assistant" | "user" = "assistant" | "user">(props: {
+    role: Role;
+    text: string;
+}): AgenticaTextHistory<Role>;
+export declare function createDescribeHistory<Model extends ILlmSchema.Model>(props: {
+    executes: AgenticaExecuteHistory<Model>[];
+    text: string;
+}): AgenticaDescribeHistory<Model>;
+export declare function createSelectHistory<Model extends ILlmSchema.Model>(props: {
+    id: string;
+    selections: AgenticaOperationSelection<Model>[];
+}): AgenticaSelectHistory<Model>;
+export declare function createCancelHistory<Model extends ILlmSchema.Model>(props: {
+    id: string;
+    selections: AgenticaOperationSelection<Model>[];
+}): AgenticaCancelPrompt<Model>;
+export declare function createExecuteHistory<Model extends ILlmSchema.Model>(props: {
+    id: string;
+    operation: AgenticaOperation<Model>;
+    arguments: Record<string, any>;
+    value: unknown;
+}): AgenticaExecuteHistory<Model>;

package/lib/factory/{prompts.js → histories.js}

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.decodePrompt = decodePrompt;
-exports.createTextPrompt = createTextPrompt;
-exports.createDescribePrompt = createDescribePrompt;
-exports.createSelectPrompt = createSelectPrompt;
-exports.createCancelPrompt = createCancelPrompt;
-exports.createExecutePrompt = createExecutePrompt;
-function decodePrompt(history) {
+exports.decodeHistory = decodeHistory;
+exports.createTextHistory = createTextHistory;
+exports.createDescribeHistory = createDescribeHistory;
+exports.createSelectHistory = createSelectHistory;
+exports.createCancelHistory = createCancelHistory;
+exports.createExecuteHistory = createExecuteHistory;
+function decodeHistory(history) {
     // NO NEED TO DECODE DESCRIBE
     if (history.type === "describe") {
         return [];
@@ -82,7 +82,7 @@ function decodePrompt(history) {
 /* -----------------------------------------------------------
   TEXT PROMPTS
 ----------------------------------------------------------- */
-function createTextPrompt(props) {
+function createTextHistory(props) {
     const prompt = {
         type: "text",
         role: props.role,
@@ -90,7 +90,7 @@ function createTextPrompt(props) {
     };
     return Object.assign(Object.assign({}, prompt), { toJSON: () => prompt });
 }
-function createDescribePrompt(props) {
+function createDescribeHistory(props) {
     return {
         type: "describe",
         text: props.text,
@@ -105,7 +105,7 @@ function createDescribePrompt(props) {
 /* -----------------------------------------------------------
   FUNCTION CALLING PROMPTS
 ----------------------------------------------------------- */
-function createSelectPrompt(props) {
+function createSelectHistory(props) {
     return {
         type: "select",
         id: props.id,
@@ -117,7 +117,7 @@ function createSelectPrompt(props) {
         }),
     };
 }
-function createCancelPrompt(props) {
+function createCancelHistory(props) {
     return {
         type: "cancel",
         id: props.id,
@@ -129,7 +129,7 @@ function createCancelPrompt(props) {
         }),
     };
 }
-function createExecutePrompt(props) {
+function createExecuteHistory(props) {
     return {
         type: "execute",
         protocol: props.operation.protocol,
@@ -147,4 +147,4 @@ function createExecutePrompt(props) {
         }),
     };
 }
-//# sourceMappingURL=prompts.js.map
+//# sourceMappingURL=histories.js.map

package/lib/factory/histories.js.map

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

package/lib/factory/index.d.ts

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

package/lib/factory/index.js

@@ -15,6 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./events"), exports);
+__exportStar(require("./histories"), exports);
 __exportStar(require("./operations"), exports);
-__exportStar(require("./prompts"), exports);
 //# sourceMappingURL=index.js.map

package/lib/factory/index.js.map

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