@agentica/core 0.25.0 → 0.26.1

package/src/json/IAgenticaHistoryJson.type.ts

@@ -0,0 +1,19 @@
+import type { AgenticaHistory } from "../histories";
+import type { Pass } from "../utils/types";
+
+import { check, checks } from "../utils/types";
+
+import type { IAgenticaHistoryJson } from "./IAgenticaHistoryJson";
+
+checks([
+  check<
+    AgenticaHistory.Type,
+    IAgenticaHistoryJson.Type,
+    Pass
+  >(),
+  check<
+    AgenticaHistory.Type,
+    keyof IAgenticaHistoryJson.Mapper,
+    Pass
+  >(),
+]);

package/src/structures/IAgenticaProps.ts

@@ -1,6 +1,8 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
+import type { AgenticaTokenUsage } from "../context/AgenticaTokenUsage";
 import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
+import type { IAgenticaTokenUsageJson } from "../json/IAgenticaTokenUsageJson";
 
 import type { IAgenticaConfig } from "./IAgenticaConfig";
 import type { IAgenticaController } from "./IAgenticaController";
@@ -67,4 +69,16 @@ export interface IAgenticaProps<Model extends ILlmSchema.Model> {
    * assign the previouis prompt histories to this property.
    */
   histories?: IAgenticaHistoryJson[];
+
+  /**
+   * Token usage information.
+   *
+   * You can start token usage tracing by assigning this property.
+   *
+   * If you assign {@link IAgenticaTokenUsageJson} value, the
+   * token usage tracing would be from the value. Otherwise you
+   * assign the {@link AgenticaTokenUsage} typed instance, the
+   * tracing would be binded to the instance.
+   */
+  tokenUsage?: IAgenticaTokenUsageJson | AgenticaTokenUsage | undefined;
 }

package/src/structures/IMicroAgenticaProps.ts

@@ -1,5 +1,7 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
+import type { AgenticaTokenUsage } from "../context/AgenticaTokenUsage";
+import type { IAgenticaTokenUsageJson } from "../json/IAgenticaTokenUsageJson";
 import type { IMicroAgenticaHistoryJson } from "../json/IMicroAgenticaHistoryJson";
 
 import type { IAgenticaController } from "./IAgenticaController";
@@ -67,4 +69,16 @@ export interface IMicroAgenticaProps<Model extends ILlmSchema.Model> {
    * assign the previouis prompt histories to this property.
    */
   histories?: IMicroAgenticaHistoryJson[];
+
+  /**
+   * Token usage information.
+   *
+   * You can start token usage tracing by assigning this property.
+   *
+   * If you assign {@link IAgenticaTokenUsageJson} value, the
+   * token usage tracing would be from the value. Otherwise you
+   * assign the {@link AgenticaTokenUsage} typed instance, the
+   * tracing would be binded to the instance.
+   */
+  tokenUsage?: IAgenticaTokenUsageJson | AgenticaTokenUsage | undefined;
 }

package/src/transformers/transformHistory.ts

@@ -8,9 +8,10 @@ import type { AgenticaDescribeHistory } from "../histories/AgenticaDescribeHisto
 import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
 import type { AgenticaHistory } from "../histories/AgenticaHistory";
 import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
+import type { AgenticaSystemMessageHistory } from "../histories/AgenticaSystemMessageHistory";
 import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
 
-import { createAssistantMessageHistory, createCancelHistory, createDescribeHistory, createExecuteHistory, createSelectHistory, createUserMessageHistory } from "../factory/histories";
+import { createAssistantMessageHistory, createCancelHistory, createDescribeHistory, createExecuteHistory, createSelectHistory, createSystemMessageHistory, createUserMessageHistory } from "../factory/histories";
 import { createOperationSelection } from "../factory/operations";
 
 /**
@@ -32,6 +33,12 @@ export function transformHistory<Model extends ILlmSchema.Model>(props: {
       history: props.history,
     });
   }
+  // SYSTEM
+  else if (props.history.type === "systemMessage") {
+    return transformSystemMessage({
+      history: props.history,
+    });
+  }
   // SELECT & CANCEL
   else if (props.history.type === "select") {
     return transformSelect({
@@ -64,6 +71,12 @@ function transformAssistantMessage(props: {
   return createAssistantMessageHistory(props.history);
 }
 
+function transformSystemMessage(props: {
+  history: IAgenticaHistoryJson.ISystemMessage;
+}): AgenticaSystemMessageHistory {
+  return createSystemMessageHistory(props.history);
+}
+
 function transformUserMessage(props: {
   history: IAgenticaHistoryJson.IUserMessage;
 }): AgenticaUserMessageHistory {

package/src/utils/types.ts

@@ -0,0 +1,50 @@
+/**
+ * from ts-toolbelt repository
+ * https://github.com/millsp/ts-toolbelt/blob/master/sources/Test.ts
+ */
+
+type Equals<A1, A2> = (<A>() => A extends A2 ? 1 : 0) extends <
+  A,
+>() => A extends A1 ? 1 : 0
+  ? 1
+  : 0;
+
+type Boolean = 0 | 1;
+/**
+ * Test should pass
+ */
+export type Pass = 1;
+
+/**
+ * Test should fail
+ */
+export type Fail = 0;
+
+/**
+ * Check or test the validity of a type
+ * @param debug to debug with parameter hints (`ctrl+p`, `ctrl+shift+space`)
+ * @example
+ * ```ts
+ * // see in `tst` folder
+ * ```
+ */
+export function check<Type, Expect, Outcome extends Boolean>(
+  debug?: Type,
+): Equals<Equals<Type, Expect>, Outcome> {
+  if (debug !== undefined) {
+    // eslint-disable-next-line no-console
+    console.log(debug);
+  }
+
+  return 1 as Equals<Equals<Type, Expect>, Outcome>;
+}
+
+/**
+ * Validates a batch of [[check]]
+ * @param _checks a batch of [[check]]
+ * @example
+ * ```ts
+ * // see in `tst` folder
+ * ```
+ */
+export function checks(_checks: 1[]): void { }

package/lib/transformers/transformEvent.js

@@ -1,198 +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.transformEvent = transformEvent;
-exports.transformCall = transformCall;
-const events_1 = require("../factory/events");
-const operations_1 = require("../factory/operations");
-const StreamUtil_1 = require("../utils/StreamUtil");
-/**
- * @internal
- */
-function transformEvent(props) {
-    if (props.event.type === "call") {
-        return transformCall({
-            operations: props.operations,
-            event: props.event,
-        });
-    }
-    else if (props.event.type === "cancel") {
-        return transformCancel({
-            operations: props.operations,
-            event: props.event,
-        });
-    }
-    else if (props.event.type === "describe") {
-        return transformDescribe({
-            operations: props.operations,
-            event: props.event,
-        });
-    }
-    else if (props.event.type === "execute") {
-        return transformExecute({
-            operations: props.operations,
-            event: props.event,
-        });
-    }
-    else if (props.event.type === "initialize") {
-        return transformInitialize();
-    }
-    else if (props.event.type === "request") {
-        return transformRequest({
-            event: props.event,
-        });
-    }
-    else if (props.event.type === "select") {
-        return transformSelect({
-            operations: props.operations,
-            event: props.event,
-        });
-    }
-    else if (props.event.type === "assistantMessage") {
-        return transformAssistantMessage({
-            event: props.event,
-        });
-    }
-    else if (props.event.type === "userMessage") {
-        return transformUserMessage({
-            event: props.event,
-        });
-    }
-    return transformValidateEvent({
-        operations: props.operations,
-        event: props.event,
-    });
-}
-/**
- * @internal
- */
-function transformCall(props) {
-    return (0, events_1.createCallEvent)({
-        id: props.event.id,
-        operation: findOperation({
-            operations: props.operations,
-            input: props.event.operation,
-        }),
-        arguments: props.event.arguments,
-    });
-}
-/**
- * @internal
- */
-function transformCancel(props) {
-    return (0, events_1.createCancelEvent)({
-        selection: (0, operations_1.createOperationSelection)({
-            operation: findOperation({
-                operations: props.operations,
-                input: props.event.selection.operation,
-            }),
-            reason: props.event.selection.reason,
-        }),
-    });
-}
-/**
- * @internal
- */
-function transformDescribe(props) {
-    return (0, events_1.createDescribeEvent)({
-        executes: props.event.executes.map(next => transformExecute({
-            operations: props.operations,
-            event: next,
-        })),
-        stream: (0, StreamUtil_1.toAsyncGenerator)(props.event.text),
-        done: () => true,
-        get: () => props.event.text,
-        join: () => __awaiter(this, void 0, void 0, function* () { return props.event.text; }),
-    });
-}
-/**
- * @internal
- */
-function transformExecute(props) {
-    return (0, events_1.createExecuteEvent)({
-        id: props.event.id,
-        operation: findOperation({
-            operations: props.operations,
-            input: props.event.operation,
-        }),
-        arguments: props.event.arguments,
-        value: props.event.value,
-    });
-}
-/**
- * @internal
- */
-function transformInitialize() {
-    return (0, events_1.createInitializeEvent)();
-}
-/**
- * @internal
- */
-function transformRequest(props) {
-    return (0, events_1.createRequestEvent)(props.event);
-}
-/**
- * @internal
- */
-function transformSelect(props) {
-    return (0, events_1.createSelectEvent)({
-        selection: (0, operations_1.createOperationSelection)({
-            operation: findOperation({
-                operations: props.operations,
-                input: props.event.selection.operation,
-            }),
-            reason: props.event.selection.reason,
-        }),
-    });
-}
-/**
- * @internal
- */
-function transformAssistantMessage(props) {
-    return (0, events_1.creatAssistantEvent)({
-        stream: (0, StreamUtil_1.toAsyncGenerator)(props.event.text),
-        done: () => true,
-        get: () => props.event.text,
-        join: () => __awaiter(this, void 0, void 0, function* () { return props.event.text; }),
-    });
-}
-/**
- * @internal
- */
-function transformUserMessage(props) {
-    return (0, events_1.createUserMessageEvent)(props.event);
-}
-/**
- * @internal
- */
-function transformValidateEvent(props) {
-    return (0, events_1.createValidateEvent)({
-        id: props.event.id,
-        operation: findOperation({
-            operations: props.operations,
-            input: props.event.operation,
-        }),
-        result: props.event.result,
-    });
-}
-/**
- * @internal
- */
-function 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=transformEvent.js.map

package/lib/transformers/transformEvent.js.map

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

package/src/transformers/transformEvent.ts

@@ -1,248 +0,0 @@
-import type { ILlmSchema } from "@samchon/openapi";
-
-import type { AgenticaOperation } from "../context/AgenticaOperation";
-import type { AgenticaUserMessageEvent, AgenticaValidateEvent } from "../events";
-import type { AgenticaAssistantMessageEvent } from "../events/AgenticaAssistantMessageEvent";
-import type { AgenticaCallEvent } from "../events/AgenticaCallEvent";
-import type { AgenticaCancelEvent } from "../events/AgenticaCancelEvent";
-import type { AgenticaDescribeEvent } from "../events/AgenticaDescribeEvent";
-import type { AgenticaEvent } from "../events/AgenticaEvent";
-import type { AgenticaExecuteEvent } from "../events/AgenticaExecuteEvent";
-import type { AgenticaInitializeEvent } from "../events/AgenticaInitializeEvent";
-import type { AgenticaRequestEvent } from "../events/AgenticaRequestEvent";
-import type { AgenticaSelectEvent } from "../events/AgenticaSelectEvent";
-import type { IAgenticaEventJson } from "../json/IAgenticaEventJson";
-
-import { creatAssistantEvent, createCallEvent, createCancelEvent, createDescribeEvent, createExecuteEvent, createInitializeEvent, createRequestEvent, createSelectEvent, createUserMessageEvent, createValidateEvent } from "../factory/events";
-import { createOperationSelection } from "../factory/operations";
-import { toAsyncGenerator } from "../utils/StreamUtil";
-
-/**
- * @internal
- */
-export function transformEvent<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-  event: IAgenticaEventJson;
-}): AgenticaEvent<Model> {
-  if (props.event.type === "call") {
-    return transformCall({
-      operations: props.operations,
-      event: props.event,
-    });
-  }
-  else if (props.event.type === "cancel") {
-    return transformCancel({
-      operations: props.operations,
-      event: props.event,
-    });
-  }
-  else if (props.event.type === "describe") {
-    return transformDescribe({
-      operations: props.operations,
-      event: props.event,
-    });
-  }
-  else if (props.event.type === "execute") {
-    return transformExecute({
-      operations: props.operations,
-      event: props.event,
-    });
-  }
-  else if (props.event.type === "initialize") {
-    return transformInitialize();
-  }
-  else if (props.event.type === "request") {
-    return transformRequest({
-      event: props.event,
-    });
-  }
-  else if (props.event.type === "select") {
-    return transformSelect({
-      operations: props.operations,
-      event: props.event,
-    });
-  }
-  else if (props.event.type === "assistantMessage") {
-    return transformAssistantMessage({
-      event: props.event,
-    });
-  }
-  else if (props.event.type === "userMessage") {
-    return transformUserMessage({
-      event: props.event,
-    });
-  }
-  return transformValidateEvent({
-    operations: props.operations,
-    event: props.event,
-  });
-}
-
-/**
- * @internal
- */
-export function transformCall<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-  event: IAgenticaEventJson.ICall;
-}): AgenticaCallEvent<Model> {
-  return createCallEvent({
-    id: props.event.id,
-    operation: findOperation({
-      operations: props.operations,
-      input: props.event.operation,
-    }),
-    arguments: props.event.arguments,
-  });
-}
-
-/**
- * @internal
- */
-function transformCancel<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-  event: IAgenticaEventJson.ICancel;
-}): AgenticaCancelEvent<Model> {
-  return createCancelEvent({
-    selection: createOperationSelection({
-      operation: findOperation({
-        operations: props.operations,
-        input: props.event.selection.operation,
-      }),
-      reason: props.event.selection.reason,
-    }),
-  });
-}
-
-/**
- * @internal
- */
-function transformDescribe<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-  event: IAgenticaEventJson.IDescribe;
-}): AgenticaDescribeEvent<Model> {
-  return createDescribeEvent({
-    executes: props.event.executes.map(next =>
-      transformExecute({
-        operations: props.operations,
-        event: next,
-      }),
-    ),
-    stream: toAsyncGenerator(props.event.text),
-    done: () => true,
-    get: () => props.event.text,
-    join: async () => props.event.text,
-  });
-}
-
-/**
- * @internal
- */
-function transformExecute<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-  event: IAgenticaEventJson.IExecute;
-}): AgenticaExecuteEvent<Model> {
-  return createExecuteEvent({
-    id: props.event.id,
-    operation: findOperation({
-      operations: props.operations,
-      input: props.event.operation,
-    }),
-    arguments: props.event.arguments,
-    value: props.event.value,
-  });
-}
-
-/**
- * @internal
- */
-function transformInitialize(): AgenticaInitializeEvent {
-  return createInitializeEvent();
-}
-
-/**
- * @internal
- */
-function transformRequest(props: {
-  event: IAgenticaEventJson.IRequest;
-}): AgenticaRequestEvent {
-  return createRequestEvent(props.event);
-}
-
-/**
- * @internal
- */
-function transformSelect<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-  event: IAgenticaEventJson.ISelect;
-}): AgenticaSelectEvent<Model> {
-  return createSelectEvent({
-    selection: createOperationSelection({
-      operation: findOperation({
-        operations: props.operations,
-        input: props.event.selection.operation,
-      }),
-      reason: props.event.selection.reason,
-    }),
-  });
-}
-
-/**
- * @internal
- */
-function transformAssistantMessage(props: {
-  event: IAgenticaEventJson.IAssistantMessage;
-}): AgenticaAssistantMessageEvent {
-  return creatAssistantEvent({
-    stream: toAsyncGenerator(props.event.text),
-    done: () => true,
-    get: () => props.event.text,
-    join: async () => props.event.text,
-  });
-}
-
-/**
- * @internal
- */
-function transformUserMessage(props: {
-  event: IAgenticaEventJson.IUserMessage;
-}): AgenticaUserMessageEvent {
-  return createUserMessageEvent(props.event);
-}
-
-/**
- * @internal
- */
-function transformValidateEvent<Model extends ILlmSchema.Model>(props: {
-  event: IAgenticaEventJson.IValidate;
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-}): AgenticaValidateEvent<Model> {
-  return createValidateEvent({
-    id: props.event.id,
-    operation: findOperation({
-      operations: props.operations,
-      input: props.event.operation,
-    }),
-    result: props.event.result,
-  });
-}
-
-/**
- * @internal
- */
-function findOperation<Model extends ILlmSchema.Model>(props: {
-  operations: Map<string, Map<string, AgenticaOperation<Model>>>;
-  input: {
-    controller: string;
-    function: string;
-  };
-}): AgenticaOperation<Model> {
-  const found: AgenticaOperation<Model> | undefined = props.operations
-    .get(props.input.controller)
-    ?.get(props.input.function);
-  if (found === undefined) {
-    throw new Error(
-      `No operation found: (controller: ${props.input.controller}, function: ${props.input.function})`,
-    );
-  }
-  return found;
-}