@agentica/core 0.12.21 → 0.13.0

package/src/transformers/AgenticaPromptTransformer.ts

@@ -1,134 +1,156 @@
-import { ILlmSchema } from "@samchon/openapi";
+import type { ILlmSchema } from "@samchon/openapi";
 
-import { AgenticaOperation } from "../context/AgenticaOperation";
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
 import { AgenticaOperationSelection } from "../context/AgenticaOperationSelection";
-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 namespace AgenticaPromptTransformer {
-  export const transform = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-    prompt: IAgenticaPromptJson;
-  }): AgenticaPrompt<Model> => {
-    // TEXT
-    if (props.prompt.type === "text")
-      return transformText({
-        prompt: props.prompt,
-      });
-    // SELECT & CANCEL
-    else if (props.prompt.type === "select")
-      return transformSelect({
-        operations: props.operations,
-        prompt: props.prompt,
-      });
-    else if (props.prompt.type === "cancel")
-      return transformCancel({
-        operations: props.operations,
-        prompt: props.prompt,
-      });
-    // EXECUTE
-    else if (props.prompt.type === "execute")
-      return transformExecute({
-        operations: props.operations,
-        prompt: props.prompt,
-      });
-    else if (props.prompt.type === "describe")
-      return transformDescribe({
-        operations: props.operations,
-        prompt: props.prompt,
-      });
-    throw new Error("Invalid prompt type.");
-  };
+export function transform<Model extends ILlmSchema.Model>(props: {
+  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+  prompt: IAgenticaPromptJson;
+}): AgenticaPrompt<Model> {
+  // TEXT
+  if (props.prompt.type === "text") {
+    return transformText({
+      prompt: props.prompt,
+    });
+  }
+  // SELECT & CANCEL
+  else if (props.prompt.type === "select") {
+    return transformSelect({
+      operations: props.operations,
+      prompt: props.prompt,
+    });
+  }
+  else if (props.prompt.type === "cancel") {
+    return transformCancel({
+      operations: props.operations,
+      prompt: props.prompt,
+    });
+  }
+  // EXECUTE
+  else if (props.prompt.type === "execute") {
+    return transformExecute({
+      operations: props.operations,
+      prompt: props.prompt,
+    });
+  }
+  else if (props.prompt.type === "describe") {
+    return transformDescribe({
+      operations: props.operations,
+      prompt: props.prompt,
+    });
+  }
 
-  export const transformText = (props: {
-    prompt: IAgenticaPromptJson.IText;
-  }): AgenticaTextPrompt => {
-    return new AgenticaTextPrompt(props.prompt);
-  };
+  throw new Error("Invalid prompt type.");
+}
 
-  export const transformSelect = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-    prompt: IAgenticaPromptJson.ISelect;
-  }): AgenticaSelectPrompt<Model> =>
-    new AgenticaSelectPrompt({
-      id: props.prompt.id,
-      selections: props.prompt.selections.map(
-        (select) =>
-          new AgenticaOperationSelection({
-            operation: findOperation({
-              operations: props.operations,
-              input: select.operation,
-            }),
-            reason: select.reason,
+export function transformText(props: {
+  prompt: IAgenticaPromptJson.IText;
+}): AgenticaTextPrompt {
+  return new AgenticaTextPrompt(props.prompt);
+}
+
+export function transformSelect<Model extends ILlmSchema.Model>(props: {
+  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+  prompt: IAgenticaPromptJson.ISelect;
+}): AgenticaSelectPrompt<Model> {
+  return new AgenticaSelectPrompt({
+    id: props.prompt.id,
+    selections: props.prompt.selections.map(
+      select =>
+        new AgenticaOperationSelection({
+          operation: findOperation({
+            operations: props.operations,
+            input: select.operation,
           }),
-      ),
-    });
+          reason: select.reason,
+        }),
+    ),
+  });
+}
 
-  export const transformCancel = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-    prompt: IAgenticaPromptJson.ICancel;
-  }): AgenticaCancelPrompt<Model> =>
-    new AgenticaCancelPrompt({
-      id: props.prompt.id,
-      selections: props.prompt.selections.map(
-        (select) =>
-          new AgenticaOperationSelection({
-            operation: findOperation({
-              operations: props.operations,
-              input: select.operation,
-            }),
-            reason: select.reason,
+export function transformCancel<Model extends ILlmSchema.Model>(props: {
+  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+  prompt: IAgenticaPromptJson.ICancel;
+}): AgenticaCancelPrompt<Model> {
+  return new AgenticaCancelPrompt({
+    id: props.prompt.id,
+    selections: props.prompt.selections.map(
+      select =>
+        new AgenticaOperationSelection({
+          operation: findOperation({
+            operations: props.operations,
+            input: select.operation,
           }),
-      ),
-    });
+          reason: select.reason,
+        }),
+    ),
+  });
+}
+
+export function transformExecute<Model extends ILlmSchema.Model>(props: {
+  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+  prompt: IAgenticaPromptJson.IExecute;
+}): AgenticaExecutePrompt<Model> {
+  return new AgenticaExecutePrompt({
+    id: props.prompt.id,
+    operation: findOperation({
+      operations: props.operations,
+      input: props.prompt.operation,
+    }),
+    arguments: props.prompt.arguments,
+    /**
+     * @TODO fix it
+     * The property and value have a type mismatch, but it works.
+     */
+    value: props.prompt.value as unknown as Record<string, unknown>,
+  });
+}
 
-  export const transformExecute = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-    prompt: IAgenticaPromptJson.IExecute;
-  }): AgenticaExecutePrompt<Model> =>
-    new AgenticaExecutePrompt({
-      id: props.prompt.id,
-      operation: findOperation({
+export function transformDescribe<Model extends ILlmSchema.Model>(props: {
+  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
+  prompt: IAgenticaPromptJson.IDescribe;
+}): AgenticaDescribePrompt<Model> {
+  return new AgenticaDescribePrompt({
+    text: props.prompt.text,
+    executes: props.prompt.executes.map(next =>
+      transformExecute({
         operations: props.operations,
-        input: props.prompt.operation,
+        prompt: next,
       }),
-      arguments: props.prompt.arguments,
-      value: props.prompt.value,
-    });
-
-  export const transformDescribe = <Model extends ILlmSchema.Model>(props: {
-    operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-    prompt: IAgenticaPromptJson.IDescribe;
-  }): AgenticaDescribePrompt<Model> =>
-    new AgenticaDescribePrompt({
-      text: props.prompt.text,
-      executes: props.prompt.executes.map((next) =>
-        transformExecute({
-          operations: props.operations,
-          prompt: next,
-        }),
-      ),
-    });
+    ),
+  });
 }
 
-const findOperation = <Model extends ILlmSchema.Model>(props: {
+function findOperation<Model extends ILlmSchema.Model>(props: {
   operations: Map<string, Map<string, AgenticaOperation<Model>>>;
   input: {
     controller: string;
     function: string;
   };
-}): AgenticaOperation<Model> => {
+}): AgenticaOperation<Model> {
   const found: AgenticaOperation<Model> | undefined = props.operations
     .get(props.input.controller)
     ?.get(props.input.function);
-  if (found === undefined)
+  if (found === undefined) {
     throw new Error(
       `No operation found: (controller: ${props.input.controller}, function: ${props.input.function})`,
     );
+  }
   return found;
+}
+
+export const AgenticaPromptTransformer = {
+  transform,
+  transformText,
+  transformSelect,
+  transformCancel,
+  transformExecute,
+  transformDescribe,
 };

package/lib/internal/MPSCUtil.d.ts

@@ -1,35 +0,0 @@
-export declare namespace MPSCUtil {
-    interface Output<T> {
-        consumer: ReadableStream<T>;
-        produce: (chunk: T) => void;
-        close: () => void;
-        /**
-         * Wait until the producing is finished.
-         */
-        waitClosed: () => Promise<void>;
-        /**
-         * Wait until the consuming is finished.(finished producing and consuming)
-         */
-        waitUntilEmpty: () => Promise<void>;
-        /**
-         * Check if producing is done and consuming is finished.
-         */
-        done: () => boolean;
-    }
-    const create: <T>() => Output<T>;
-    class AsyncQueue<T> {
-        private queue;
-        private resolvers;
-        private closeResolvers;
-        private emptyResolvers;
-        private closed;
-        enqueue(item: T): void;
-        dequeue(): Promise<IteratorResult<T, undefined>>;
-        isEmpty(): boolean;
-        isClosed(): boolean;
-        done(): boolean;
-        close(): void;
-        waitUntilEmpty(): Promise<void>;
-        waitClosed(): Promise<void>;
-    }
-}

package/lib/internal/MPSCUtil.js

@@ -1,105 +0,0 @@
-"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.MPSCUtil = void 0;
-var MPSCUtil;
-(function (MPSCUtil) {
-    MPSCUtil.create = () => {
-        const queue = new AsyncQueue();
-        const consumer = new ReadableStream({
-            pull(controller) {
-                return __awaiter(this, void 0, void 0, function* () {
-                    const { value, done } = yield queue.dequeue();
-                    if (done) {
-                        controller.close();
-                    }
-                    else {
-                        controller.enqueue(value);
-                    }
-                });
-            },
-        });
-        return {
-            consumer,
-            produce: (chunk) => queue.enqueue(chunk),
-            close: () => queue.close(),
-            done: () => queue.done(),
-            waitClosed: () => queue.waitClosed(),
-            waitUntilEmpty: () => queue.waitUntilEmpty(),
-        };
-    };
-    class AsyncQueue {
-        constructor() {
-            this.queue = [];
-            this.resolvers = [];
-            this.closeResolvers = [];
-            this.emptyResolvers = [];
-            this.closed = false;
-        }
-        enqueue(item) {
-            var _a;
-            this.queue.push(item);
-            if (this.resolvers.length > 0) {
-                (_a = this.resolvers.shift()) === null || _a === void 0 ? void 0 : _a({ value: this.queue.shift(), done: false });
-            }
-        }
-        dequeue() {
-            return __awaiter(this, void 0, void 0, function* () {
-                if (this.queue.length > 0) {
-                    return { value: this.queue.shift(), done: false };
-                }
-                if (this.closed) {
-                    if (this.emptyResolvers.length > 0) {
-                        this.emptyResolvers.forEach((resolve) => resolve());
-                        this.emptyResolvers = [];
-                    }
-                    return { value: undefined, done: true };
-                }
-                return new Promise((resolve) => this.resolvers.push(resolve));
-            });
-        }
-        isEmpty() {
-            return this.queue.length === 0;
-        }
-        isClosed() {
-            return this.closed;
-        }
-        done() {
-            return this.isClosed() && this.isEmpty();
-        }
-        close() {
-            var _a;
-            this.closed = true;
-            while (this.resolvers.length > 0) {
-                (_a = this.resolvers.shift()) === null || _a === void 0 ? void 0 : _a({ value: undefined, done: true });
-            }
-            this.closeResolvers.forEach((resolve) => resolve());
-        }
-        waitUntilEmpty() {
-            if (this.isEmpty()) {
-                return Promise.resolve();
-            }
-            return new Promise((resolve) => {
-                this.emptyResolvers.push(resolve);
-            });
-        }
-        waitClosed() {
-            if (this.isClosed()) {
-                return Promise.resolve();
-            }
-            return new Promise((resolve) => {
-                this.closeResolvers.push(resolve);
-            });
-        }
-    }
-    MPSCUtil.AsyncQueue = AsyncQueue;
-})(MPSCUtil || (exports.MPSCUtil = MPSCUtil = {}));
-//# sourceMappingURL=MPSCUtil.js.map

package/lib/internal/MPSCUtil.js.map

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

package/src/internal/MPSCUtil.ts

@@ -1,111 +0,0 @@
-export namespace MPSCUtil {
-  export interface Output<T> {
-    consumer: ReadableStream<T>;
-    produce: (chunk: T) => void;
-    close: () => void;
-    /**
-     * Wait until the producing is finished.
-     */
-    waitClosed: () => Promise<void>;
-    /**
-     * Wait until the consuming is finished.(finished producing and consuming)
-     */
-    waitUntilEmpty: () => Promise<void>;
-
-    /**
-     * Check if producing is done and consuming is finished.
-     */
-    done: () => boolean;
-  }
-
-  export const create = <T>(): Output<T> => {
-    const queue = new AsyncQueue<T>();
-    const consumer = new ReadableStream<T>({
-      async pull(controller) {
-        const { value, done } = await queue.dequeue();
-        if (done) {
-          controller.close();
-        } else {
-          controller.enqueue(value);
-        }
-      },
-    });
-
-    return {
-      consumer,
-      produce: (chunk: T) => queue.enqueue(chunk),
-      close: () => queue.close(),
-      done: () => queue.done(),
-      waitClosed: () => queue.waitClosed(),
-      waitUntilEmpty: () => queue.waitUntilEmpty(),
-    };
-  };
-
-  export class AsyncQueue<T> {
-    private queue: T[] = [];
-    private resolvers: ((value: IteratorResult<T, undefined>) => void)[] = [];
-    private closeResolvers: (() => void)[] = [];
-    private emptyResolvers: (() => void)[] = [];
-    private closed = false;
-
-    enqueue(item: T) {
-      this.queue.push(item);
-      if (this.resolvers.length > 0) {
-        this.resolvers.shift()?.({ value: this.queue.shift()!, done: false });
-      }
-    }
-
-    async dequeue(): Promise<IteratorResult<T, undefined>> {
-      if (this.queue.length > 0) {
-        return { value: this.queue.shift()!, done: false };
-      }
-      if (this.closed) {
-        if (this.emptyResolvers.length > 0) {
-          this.emptyResolvers.forEach((resolve) => resolve());
-          this.emptyResolvers = [];
-        }
-        return { value: undefined, done: true };
-      }
-      return new Promise((resolve) => this.resolvers.push(resolve));
-    }
-
-    isEmpty() {
-      return this.queue.length === 0;
-    }
-
-    isClosed() {
-      return this.closed;
-    }
-
-    done() {
-      return this.isClosed() && this.isEmpty();
-    }
-
-    close() {
-      this.closed = true;
-      while (this.resolvers.length > 0) {
-        this.resolvers.shift()?.({ value: undefined, done: true });
-      }
-      this.closeResolvers.forEach((resolve) => resolve());
-    }
-
-    waitUntilEmpty() {
-      if (this.isEmpty()) {
-        return Promise.resolve();
-      }
-      return new Promise<void>((resolve) => {
-        this.emptyResolvers.push(resolve);
-      });
-    }
-
-    waitClosed() {
-      if (this.isClosed()) {
-        return Promise.resolve();
-      }
-
-      return new Promise<void>((resolve) => {
-        this.closeResolvers.push(resolve);
-      });
-    }
-  }
-}