@agentica/core 0.10.4 → 0.11.0

package/lib/prompts/AgenticaSelectPrompt.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticaSelectPrompt = void 0;
+const AgenticaPromptBase_1 = require("./AgenticaPromptBase");
+class AgenticaSelectPrompt extends AgenticaPromptBase_1.AgenticaPromptBase {
+    constructor(props) {
+        super("select");
+        this.id = props.id;
+        this.selections = props.selections;
+    }
+    toJSON() {
+        return {
+            type: this.type,
+            id: this.id,
+            selections: this.selections.map((s) => s.toJSON()),
+        };
+    }
+}
+exports.AgenticaSelectPrompt = AgenticaSelectPrompt;
+//# sourceMappingURL=AgenticaSelectPrompt.js.map

package/lib/prompts/AgenticaSelectPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgenticaSelectPrompt.js","sourceRoot":"","sources":["../../src/prompts/AgenticaSelectPrompt.ts"],"names":[],"mappings":";;;AAIA,6DAA0D;AAE1D,MAAa,oBAEX,SAAQ,uCAAyD;IAIjE,YAAmB,KAAyC;QAC1D,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACrC,CAAC;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACnD,CAAC;IACJ,CAAC;CACF;AAnBD,oDAmBC"}

package/lib/prompts/AgenticaTextPrompt.d.ts

@@ -0,0 +1,14 @@
+import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import { AgenticaPromptBase } from "./AgenticaPromptBase";
+export declare class AgenticaTextPrompt<Role extends "assistant" | "user" = "assistant" | "user"> extends AgenticaPromptBase<"text", IAgenticaPromptJson.IText> {
+    readonly role: Role;
+    readonly text: string;
+    constructor(props: AgenticaTextPrompt.IProps<Role>);
+    toJSON(): IAgenticaPromptJson.IText<Role>;
+}
+export declare namespace AgenticaTextPrompt {
+    interface IProps<Role extends "assistant" | "user" = "assistant" | "user"> {
+        role: Role;
+        text: string;
+    }
+}

package/lib/prompts/AgenticaTextPrompt.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticaTextPrompt = void 0;
+const AgenticaPromptBase_1 = require("./AgenticaPromptBase");
+class AgenticaTextPrompt extends AgenticaPromptBase_1.AgenticaPromptBase {
+    constructor(props) {
+        super("text");
+        this.role = props.role;
+        this.text = props.text;
+    }
+    toJSON() {
+        return {
+            type: this.type,
+            role: this.role,
+            text: this.text,
+        };
+    }
+}
+exports.AgenticaTextPrompt = AgenticaTextPrompt;
+//# sourceMappingURL=AgenticaTextPrompt.js.map

package/lib/prompts/AgenticaTextPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgenticaTextPrompt.js","sourceRoot":"","sources":["../../src/prompts/AgenticaTextPrompt.ts"],"names":[],"mappings":";;;AACA,6DAA0D;AAE1D,MAAa,kBAEX,SAAQ,uCAAqD;IAI7D,YAAmB,KAAsC;QACvD,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;IACJ,CAAC;CACF;AAnBD,gDAmBC"}

package/lib/structures/IAgenticaConfig.d.ts

@@ -1,7 +1,7 @@
 import { ILlmSchema } from "@samchon/openapi";
-import { IAgenticaContext } from "./IAgenticaContext";
+import { AgenticaContext } from "../context/AgenticaContext";
+import { AgenticaPrompt } from "../prompts/AgenticaPrompt";
 import { IAgenticaExecutor } from "./IAgenticaExecutor";
-import { IAgenticaPrompt } from "./IAgenticaPrompt";
 import { IAgenticaSystemPrompt } from "./IAgenticaSystemPrompt";
 /**
  * Configuration for Nestia Agent.
@@ -109,5 +109,5 @@ export interface IAgenticaConfig<Model extends ILlmSchema.Model> {
      * @returns Lit of prompts generated by the executor
      * @default ChatGptAgent.execute
      */
-    executor?: Partial<IAgenticaExecutor<Model>> | ((ctx: IAgenticaContext<Model>) => Promise<IAgenticaPrompt<Model>[]>);
+    executor?: Partial<IAgenticaExecutor<Model>> | ((ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>);
 }

package/lib/structures/IAgenticaExecutor.d.ts

@@ -1,6 +1,7 @@
 import { ILlmSchema } from "@samchon/openapi";
-import { IAgenticaContext } from "./IAgenticaContext";
-import { IAgenticaPrompt } from "./IAgenticaPrompt";
+import { AgenticaContext } from "../context/AgenticaContext";
+import { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
+import { AgenticaPrompt } from "../prompts/AgenticaPrompt";
 /**
  * Executor of the Agentic AI.
  *
@@ -34,7 +35,7 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
      *
      * And if the `initialize` agent judges the user's conversation
      * implies to call some function, the `initialize` agent will
-     * call the {@link IAgenticaContext.initialize} function, and
+     * call the {@link AgenticaContext.initialize} function, and
      * inform every functions enrolled in the {@link IAgenticaController}
      * to the AI agent. And then, the `initialize` agent will not never
      * be called again, and let {@link Agentica} to go to the next
@@ -53,13 +54,13 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
      * @param ctx Context of the agent
      * @returns List of prompts generated by the initializer
      */
-    initialize: null | ((ctx: IAgenticaContext<Model>) => Promise<IAgenticaPrompt<Model>[]>);
+    initialize: null | ((ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>);
     /**
      * Function selector agent.
      *
      * `Select` agent finds candidate functions to call from the
      * conversation context with the user. And the candidate functions
-     * would be enrolled to the {@link IAgenticaContext.stack}, and the
+     * would be enrolled to the {@link AgenticaContext.stack}, and the
      * next {@link call} agent will perform the LLM (Large Language Model)
      * function calling.
      *
@@ -81,13 +82,13 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
      * @param ctx Context of the agent
      * @returns List of prompts generated by the selector
      */
-    select: (ctx: IAgenticaContext<Model>) => Promise<IAgenticaPrompt<Model>[]>;
+    select: (ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>;
     /**
      * Function caller agent.
      *
      * `Call` agent performs the LLM (Large Language Model) function
      * calling from the candidate functions enrolled in the
-     * {@link IAgenticaContext.stack}. And the scope of function calling
+     * {@link AgenticaContext.stack}. And the scope of function calling
      * is, not only just arguments filling, but also actual executing
      * the function and returning the result.
      *
@@ -107,7 +108,7 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
      *          agent is the most general topic which can be universally
      *          applied to all domain fields.
      */
-    call: (ctx: IAgenticaContext<Model>) => Promise<IAgenticaPrompt<Model>[]>;
+    call: (ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>;
     /**
      * Describer agent of the function calling result.
      *
@@ -118,12 +119,12 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
      * @param executes List of function calling results
      * @returns List of prompts generated by the describer
      */
-    describe: (ctx: IAgenticaContext<Model>, executes: IAgenticaPrompt.IExecute<Model>[]) => Promise<IAgenticaPrompt<Model>[]>;
+    describe: (ctx: AgenticaContext<Model>, executes: AgenticaExecutePrompt<Model>[]) => Promise<AgenticaPrompt<Model>[]>;
     /**
      * Function canceler agent.
      *
      * `Cancel` agent erases the candidate functions from the
-     * {@link IAgenticaContext.stack} by analyzing the conversation
+     * {@link AgenticaContext.stack} by analyzing the conversation
      * context with the user.
      *
      * For reference, the first reason of the cancelation is explicit
@@ -141,5 +142,5 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
      * @param ctx Context of the agent
      * @returns List of prompts generated by the canceler
      */
-    cancel: (ctx: IAgenticaContext<Model>) => Promise<IAgenticaPrompt<Model>[]>;
+    cancel: (ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>;
 }

package/lib/structures/IAgenticaProps.d.ts

@@ -1,8 +1,7 @@
 import { ILlmSchema } from "@samchon/openapi";
-import { Primitive } from "typia";
+import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
 import { IAgenticaConfig } from "./IAgenticaConfig";
 import { IAgenticaController } from "./IAgenticaController";
-import { IAgenticaPrompt } from "./IAgenticaPrompt";
 import { IAgenticaVendor } from "./IAgenticaVendor";
 /**
  * Properties of the Nestia Agent.
@@ -60,5 +59,5 @@ export interface IAgenticaProps<Model extends ILlmSchema.Model> {
      * If you're starting the conversation from an existing session,
      * assign the previouis prompt histories to this property.
      */
-    histories?: Primitive<IAgenticaPrompt<Model>>[];
+    histories?: IAgenticaPromptJson[];
 }

package/lib/structures/IAgenticaSystemPrompt.d.ts

@@ -1,6 +1,7 @@
 import { ILlmSchema } from "@samchon/openapi";
+import { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
+import { AgenticaPrompt } from "../prompts/AgenticaPrompt";
 import { IAgenticaConfig } from "./IAgenticaConfig";
-import { IAgenticaPrompt } from "./IAgenticaPrompt";
 /**
  * System prompt collection of the A.I. chatbot.
  *
@@ -38,13 +39,13 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
      *
      * In that case, the `initialize` system prompt would be used. You can
      * customize the `initialize` system prompt by assigning this function
-     * with the given {@link IAgenticaPrompt histories} parameter.
+     * with the given {@link AgenticaPrompt histories} parameter.
      *
      * @param histories Histories of the previous prompts
      * @returns initialize system prompt
      * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/initialize.md
      */
-    initialize?: (histories: IAgenticaPrompt<Model>[]) => string;
+    initialize?: (histories: AgenticaPrompt<Model>[]) => string;
     /**
      * Select system prompt.
      *
@@ -54,7 +55,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
      *
      * In that case, this `select` system prompt would be used. You can
      * customize it by assigning this function with the given
-     * {@link IAgenticaPrompt histories} parameter.
+     * {@link AgenticaPrompt histories} parameter.
      *
      * Note that, the `"select"` means only the function selection. It does
      * not contain the filling argument or executing the function. It
@@ -64,7 +65,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
      * @returns select system promopt
      * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/select.md
      */
-    select?: (histories: IAgenticaPrompt<Model>[]) => string;
+    select?: (histories: AgenticaPrompt<Model>[]) => string;
     /**
      * Cancel system prompt.
      *
@@ -74,13 +75,13 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
      *
      * In that case, this `cancel` system prompt would be used. You can
      * customize it by assigning this function with the given
-     * {@link IAgenticaPrompt histories} parameter.
+     * {@link AgenticaPrompt histories} parameter.
      *
      * @param histories Histories of the previous prompts
      * @returns cancel system prompt
      * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/cancel.md
      */
-    cancel?: (histories: IAgenticaPrompt<Model>[]) => string;
+    cancel?: (histories: AgenticaPrompt<Model>[]) => string;
     /**
      * Execute system prompt.
      *
@@ -91,13 +92,13 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
      *
      * In that case, this `execute` system prompt would be used. You can
      * customize it by assigning this function with the given
-     * {@link IAgenticaPrompt histories} parameter.
+     * {@link AgenticaPrompt histories} parameter.
      *
      * @param histories Histories of the previous prompts
      * @returns execute system prompt
      * https://github.com/samchon/nestia/blob/master/packages/agent/prompts/execute.md
      */
-    execute?: (histories: IAgenticaPrompt<Model>[]) => string;
+    execute?: (histories: AgenticaPrompt<Model>[]) => string;
     /**
      * Describe system prompt.
      *
@@ -107,11 +108,11 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
      *
      * In that case, this `describe` system prompt would be used. You can
      * customize it by assigning this function with the given
-     * {@link IAgenticaPrompt histories} parameter.
+     * {@link AgenticaPrompt histories} parameter.
      *
      * @param histories Histories of the previous prompts
      * @returns describe system prompt
      * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/describe.md
      */
-    describe?: (histories: IAgenticaPrompt.IExecute<Model>[]) => string;
+    describe?: (histories: AgenticaExecutePrompt<Model>[]) => string;
 }

package/lib/transformers/AgenticaEventTransformer.d.ts

@@ -0,0 +1,45 @@
+import { ILlmSchema } from "@samchon/openapi";
+import { AgenticaOperation } from "../context/AgenticaOperation";
+import { AgenticaCallEvent } from "../events/AgenticaCallEvent";
+import { AgenticaCancelEvent } from "../events/AgenticaCancelEvent";
+import { AgenticaDescribeEvent } from "../events/AgenticaDescribeEvent";
+import { AgenticaEvent } from "../events/AgenticaEvent";
+import { AgenticaExecuteEvent } from "../events/AgenticaExecuteEvent";
+import { AgenticaInitializeEvent } from "../events/AgenticaInitializeEvent";
+import { AgenticaRequestEvent } from "../events/AgenticaRequestEvent";
+import { AgenticaSelectEvent } from "../events/AgenticaSelectEvent";
+import { AgenticaTextEvent } from "../events/AgenticaTextEvent";
+import { IAgenticaEventJson } from "../json/IAgenticaEventJson";
+export declare namespace AgenticaEventTransformer {
+    const transform: <Model extends ILlmSchema.Model>(props: {
+        operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+        event: IAgenticaEventJson;
+    }) => AgenticaEvent<Model>;
+    const transformCall: <Model extends ILlmSchema.Model>(props: {
+        operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+        event: IAgenticaEventJson.ICall;
+    }) => AgenticaCallEvent<Model>;
+    const transformCancel: <Model extends ILlmSchema.Model>(props: {
+        operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+        event: IAgenticaEventJson.ICancel;
+    }) => AgenticaCancelEvent<Model>;
+    const transformDescribe: <Model extends ILlmSchema.Model>(props: {
+        operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+        event: IAgenticaEventJson.IDescribe;
+    }) => AgenticaDescribeEvent<Model>;
+    const transformExecute: <Model extends ILlmSchema.Model>(props: {
+        operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+        event: IAgenticaEventJson.IExecute;
+    }) => AgenticaExecuteEvent<Model>;
+    const transformInitialize: () => AgenticaInitializeEvent;
+    const transformRequest: (props: {
+        event: IAgenticaEventJson.IRequest;
+    }) => AgenticaRequestEvent;
+    const transformSelect: <Model extends ILlmSchema.Model>(props: {
+        operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+        event: IAgenticaEventJson.ISelect;
+    }) => AgenticaSelectEvent<Model>;
+    const transformText: (props: {
+        event: IAgenticaEventJson.IText;
+    }) => AgenticaTextEvent;
+}

package/lib/transformers/AgenticaEventTransformer.js

@@ -0,0 +1,127 @@
+"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.AgenticaEventTransformer = void 0;
+const AgenticaOperationSelection_1 = require("../context/AgenticaOperationSelection");
+const AgenticaCallEvent_1 = require("../events/AgenticaCallEvent");
+const AgenticaCancelEvent_1 = require("../events/AgenticaCancelEvent");
+const AgenticaDescribeEvent_1 = require("../events/AgenticaDescribeEvent");
+const AgenticaExecuteEvent_1 = require("../events/AgenticaExecuteEvent");
+const AgenticaInitializeEvent_1 = require("../events/AgenticaInitializeEvent");
+const AgenticaRequestEvent_1 = require("../events/AgenticaRequestEvent");
+const AgenticaSelectEvent_1 = require("../events/AgenticaSelectEvent");
+const AgenticaTextEvent_1 = require("../events/AgenticaTextEvent");
+const StreamUtil_1 = require("../internal/StreamUtil");
+var AgenticaEventTransformer;
+(function (AgenticaEventTransformer) {
+    AgenticaEventTransformer.transform = (props) => {
+        if (props.event.type === "call")
+            return AgenticaEventTransformer.transformCall({
+                operations: props.operations,
+                event: props.event,
+            });
+        else if (props.event.type === "cancel")
+            return AgenticaEventTransformer.transformCancel({
+                operations: props.operations,
+                event: props.event,
+            });
+        else if (props.event.type === "describe")
+            return AgenticaEventTransformer.transformDescribe({
+                operations: props.operations,
+                event: props.event,
+            });
+        else if (props.event.type === "execute")
+            return AgenticaEventTransformer.transformExecute({
+                operations: props.operations,
+                event: props.event,
+            });
+        else if (props.event.type === "initialize")
+            return AgenticaEventTransformer.transformInitialize();
+        else if (props.event.type === "request")
+            return AgenticaEventTransformer.transformRequest({
+                event: props.event,
+            });
+        else if (props.event.type === "select")
+            return AgenticaEventTransformer.transformSelect({
+                operations: props.operations,
+                event: props.event,
+            });
+        else if (props.event.type === "text")
+            return AgenticaEventTransformer.transformText({
+                event: props.event,
+            });
+        else
+            throw new Error("Unknown event type");
+    };
+    AgenticaEventTransformer.transformCall = (props) => new AgenticaCallEvent_1.AgenticaCallEvent({
+        id: props.event.id,
+        operation: findOperation({
+            operations: props.operations,
+            input: props.event.operation,
+        }),
+        arguments: props.event.arguments,
+    });
+    AgenticaEventTransformer.transformCancel = (props) => new AgenticaCancelEvent_1.AgenticaCancelEvent({
+        selection: new AgenticaOperationSelection_1.AgenticaOperationSelection({
+            operation: findOperation({
+                operations: props.operations,
+                input: props.event.selection.operation,
+            }),
+            reason: props.event.selection.reason,
+        }),
+    });
+    AgenticaEventTransformer.transformDescribe = (props) => new AgenticaDescribeEvent_1.AgenticaDescribeEvent({
+        executes: props.event.executes.map((next) => AgenticaEventTransformer.transformExecute({
+            operations: props.operations,
+            event: next,
+        })),
+        stream: StreamUtil_1.StreamUtil.to(props.event.text),
+        done: () => true,
+        get: () => props.event.text,
+        join: () => __awaiter(this, void 0, void 0, function* () { return props.event.text; }),
+    });
+    AgenticaEventTransformer.transformExecute = (props) => new AgenticaExecuteEvent_1.AgenticaExecuteEvent({
+        id: props.event.id,
+        operation: findOperation({
+            operations: props.operations,
+            input: props.event.operation,
+        }),
+        arguments: props.event.arguments,
+        value: props.event.value,
+    });
+    AgenticaEventTransformer.transformInitialize = () => new AgenticaInitializeEvent_1.AgenticaInitializeEvent();
+    AgenticaEventTransformer.transformRequest = (props) => new AgenticaRequestEvent_1.AgenticaRequestEvent(props.event);
+    AgenticaEventTransformer.transformSelect = (props) => new AgenticaSelectEvent_1.AgenticaSelectEvent({
+        selection: new AgenticaOperationSelection_1.AgenticaOperationSelection({
+            operation: findOperation({
+                operations: props.operations,
+                input: props.event.selection.operation,
+            }),
+            reason: props.event.selection.reason,
+        }),
+    });
+    AgenticaEventTransformer.transformText = (props) => new AgenticaTextEvent_1.AgenticaTextEvent({
+        role: props.event.role,
+        stream: StreamUtil_1.StreamUtil.to(props.event.text),
+        done: () => true,
+        get: () => props.event.text,
+        join: () => __awaiter(this, void 0, void 0, function* () { return props.event.text; }),
+    });
+})(AgenticaEventTransformer || (exports.AgenticaEventTransformer = AgenticaEventTransformer = {}));
+const findOperation = (props) => {
+    var _a;
+    const found = (_a = props.operations
+        .get(props.input.controller)) === null || _a === void 0 ? void 0 : _a.get(props.input.function);
+    if (found === undefined)
+        throw new Error(`No operation found: (controller: ${props.input.controller}, function: ${props.input.function})`);
+    return found;
+};
+//# sourceMappingURL=AgenticaEventTransformer.js.map

package/lib/transformers/AgenticaEventTransformer.js.map

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

package/lib/transformers/AgenticaPromptTransformer.d.ts

@@ -0,0 +1,34 @@
+import { ILlmSchema } from "@samchon/openapi";
+import { AgenticaOperation } from "../context/AgenticaOperation";
+import { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import { AgenticaCancelPrompt } from "../prompts/AgenticaCancelPrompt";
+import { AgenticaDescribePrompt } from "../prompts/AgenticaDescribePrompt";
+import { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
+import { AgenticaPrompt } from "../prompts/AgenticaPrompt";
+import { AgenticaSelectPrompt } from "../prompts/AgenticaSelectPrompt";
+import { AgenticaTextPrompt } from "../prompts/AgenticaTextPrompt";
+export declare namespace AgenticaPromptTransformer {
+    const transform: <Model extends ILlmSchema.Model>(props: {
+        operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+        prompt: IAgenticaPromptJson;
+    }) => AgenticaPrompt<Model>;
+    const transformText: (props: {
+        prompt: IAgenticaPromptJson.IText;
+    }) => AgenticaTextPrompt;
+    const transformSelect: <Model extends ILlmSchema.Model>(props: {
+        operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+        prompt: IAgenticaPromptJson.ISelect;
+    }) => AgenticaSelectPrompt<Model>;
+    const transformCancel: <Model extends ILlmSchema.Model>(props: {
+        operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+        prompt: IAgenticaPromptJson.ICancel;
+    }) => AgenticaCancelPrompt<Model>;
+    const transformExecute: <Model extends ILlmSchema.Model>(props: {
+        operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+        prompt: IAgenticaPromptJson.IExecute;
+    }) => AgenticaExecutePrompt<Model>;
+    const transformDescribe: <Model extends ILlmSchema.Model>(props: {
+        operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+        prompt: IAgenticaPromptJson.IDescribe;
+    }) => AgenticaDescribePrompt<Model>;
+}

package/lib/transformers/AgenticaPromptTransformer.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticaPromptTransformer = void 0;
+const AgenticaOperationSelection_1 = require("../context/AgenticaOperationSelection");
+const AgenticaCancelPrompt_1 = require("../prompts/AgenticaCancelPrompt");
+const AgenticaDescribePrompt_1 = require("../prompts/AgenticaDescribePrompt");
+const AgenticaExecutePrompt_1 = require("../prompts/AgenticaExecutePrompt");
+const AgenticaSelectPrompt_1 = require("../prompts/AgenticaSelectPrompt");
+const AgenticaTextPrompt_1 = require("../prompts/AgenticaTextPrompt");
+var AgenticaPromptTransformer;
+(function (AgenticaPromptTransformer) {
+    AgenticaPromptTransformer.transform = (props) => {
+        // TEXT
+        if (props.prompt.type === "text")
+            return AgenticaPromptTransformer.transformText({
+                prompt: props.prompt,
+            });
+        // SELECT & CANCEL
+        else if (props.prompt.type === "select")
+            return AgenticaPromptTransformer.transformSelect({
+                operations: props.operations,
+                prompt: props.prompt,
+            });
+        else if (props.prompt.type === "cancel")
+            return AgenticaPromptTransformer.transformCancel({
+                operations: props.operations,
+                prompt: props.prompt,
+            });
+        // EXECUTE
+        else if (props.prompt.type === "execute")
+            return AgenticaPromptTransformer.transformExecute({
+                operations: props.operations,
+                prompt: props.prompt,
+            });
+        else if (props.prompt.type === "describe")
+            return AgenticaPromptTransformer.transformDescribe({
+                operations: props.operations,
+                prompt: props.prompt,
+            });
+        throw new Error("Invalid prompt type.");
+    };
+    AgenticaPromptTransformer.transformText = (props) => {
+        return new AgenticaTextPrompt_1.AgenticaTextPrompt(props.prompt);
+    };
+    AgenticaPromptTransformer.transformSelect = (props) => new AgenticaSelectPrompt_1.AgenticaSelectPrompt({
+        id: props.prompt.id,
+        selections: props.prompt.selections.map((select) => new AgenticaOperationSelection_1.AgenticaOperationSelection({
+            operation: findOperation({
+                operations: props.operations,
+                input: select.operation,
+            }),
+            reason: select.reason,
+        })),
+    });
+    AgenticaPromptTransformer.transformCancel = (props) => new AgenticaCancelPrompt_1.AgenticaCancelPrompt({
+        id: props.prompt.id,
+        selections: props.prompt.selections.map((select) => new AgenticaOperationSelection_1.AgenticaOperationSelection({
+            operation: findOperation({
+                operations: props.operations,
+                input: select.operation,
+            }),
+            reason: select.reason,
+        })),
+    });
+    AgenticaPromptTransformer.transformExecute = (props) => new AgenticaExecutePrompt_1.AgenticaExecutePrompt({
+        id: props.prompt.id,
+        operation: findOperation({
+            operations: props.operations,
+            input: props.prompt.operation,
+        }),
+        arguments: props.prompt.arguments,
+        value: props.prompt.value,
+    });
+    AgenticaPromptTransformer.transformDescribe = (props) => new AgenticaDescribePrompt_1.AgenticaDescribePrompt({
+        text: props.prompt.text,
+        executes: props.prompt.executions.map((next) => AgenticaPromptTransformer.transformExecute({
+            operations: props.operations,
+            prompt: next,
+        })),
+    });
+})(AgenticaPromptTransformer || (exports.AgenticaPromptTransformer = AgenticaPromptTransformer = {}));
+const findOperation = (props) => {
+    var _a;
+    const found = (_a = props.operations
+        .get(props.input.controller)) === null || _a === void 0 ? void 0 : _a.get(props.input.function);
+    if (found === undefined)
+        throw new Error(`No operation found: (controller: ${props.input.controller}, function: ${props.input.function})`);
+    return found;
+};
+//# sourceMappingURL=AgenticaPromptTransformer.js.map

package/lib/transformers/AgenticaPromptTransformer.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentica/core",
-  "version": "0.10.4",
+  "version": "0.11.0",
   "main": "lib/index.js",
   "description": "Agentic AI Library specialized in LLM Function Calling",
   "scripts": {