@agentica/core 0.43.3 → 0.44.0-dev.20260313

package/src/orchestrate/describe.ts

@@ -1,66 +1,66 @@
-import type OpenAI from "openai";
-
-import type { AgenticaContext } from "../context/AgenticaContext";
-import type { MicroAgenticaContext } from "../context/MicroAgenticaContext";
-import type { AgenticaDescribeEvent } from "../events";
-import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
-
-import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
-import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
-import { createDescribeEvent } from "../factory/events";
-import { decodeHistory } from "../factory/histories";
-import { reduceStreamingWithDispatch } from "../utils/ChatGptCompletionStreamingUtil";
-import { toAsyncGenerator } from "../utils/StreamUtil";
-
-export async function describe(
-  ctx: AgenticaContext | MicroAgenticaContext,
-  histories: AgenticaExecuteHistory[],
-): Promise<void> {
-  if (histories.length === 0) {
-    return;
-  }
-
-  const result = await ctx.request("describe", {
-    messages: [
-      // FUNCTION CALLING HISTORIES
-      ...histories.map(decodeHistory).flat(),
-      // SYSTEM PROMPT
-      {
-        role: "system",
-        content:
-          ctx.config?.systemPrompt?.describe?.(histories)
-          ?? AgenticaSystemPrompt.DESCRIBE,
-      },
-      // COMMON SYSTEM PROMPT
-      {
-        role: "system",
-        content: AgenticaDefaultPrompt.write(ctx.config),
-      } satisfies OpenAI.ChatCompletionSystemMessageParam,
-    ],
-  });
-
-  if (result.type === "none-stream") {
-    const message = result.value.choices?.[0]?.message.content ?? "";
-    const event: AgenticaDescribeEvent = createDescribeEvent({
-      executes: histories,
-      stream: toAsyncGenerator(message),
-      done: () => true,
-      get: () => message,
-      join: async () => message,
-    });
-    void ctx.dispatch(event).catch(() => {});
-    return;
-  }
-
-  await reduceStreamingWithDispatch(result.value, (props) => {
-    const event: AgenticaDescribeEvent = createDescribeEvent({
-      executes: histories,
-      ...props,
-    });
-    void ctx.dispatch(event).catch(() => {});
-  }, ctx.abortSignal);
-}
-
-export const ChatGptDescribeFunctionAgent = {
-  execute: describe,
-};
+import type OpenAI from "openai";
+
+import type { AgenticaContext } from "../context/AgenticaContext";
+import type { MicroAgenticaContext } from "../context/MicroAgenticaContext";
+import type { AgenticaDescribeEvent } from "../events";
+import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
+
+import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
+import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
+import { createDescribeEvent } from "../factory/events";
+import { decodeHistory } from "../factory/histories";
+import { reduceStreamingWithDispatch } from "../utils/ChatGptCompletionStreamingUtil";
+import { toAsyncGenerator } from "../utils/StreamUtil";
+
+export async function describe(
+  ctx: AgenticaContext | MicroAgenticaContext,
+  histories: AgenticaExecuteHistory[],
+): Promise<void> {
+  if (histories.length === 0) {
+    return;
+  }
+
+  const result = await ctx.request("describe", {
+    messages: [
+      // FUNCTION CALLING HISTORIES
+      ...histories.map(decodeHistory).flat(),
+      // SYSTEM PROMPT
+      {
+        role: "system",
+        content:
+          ctx.config?.systemPrompt?.describe?.(histories)
+          ?? AgenticaSystemPrompt.DESCRIBE,
+      },
+      // COMMON SYSTEM PROMPT
+      {
+        role: "system",
+        content: AgenticaDefaultPrompt.write(ctx.config),
+      } satisfies OpenAI.ChatCompletionSystemMessageParam,
+    ],
+  });
+
+  if (result.type === "none-stream") {
+    const message = result.value.choices?.[0]?.message.content ?? "";
+    const event: AgenticaDescribeEvent = createDescribeEvent({
+      executes: histories,
+      stream: toAsyncGenerator(message),
+      done: () => true,
+      get: () => message,
+      join: async () => message,
+    });
+    void ctx.dispatch(event).catch(() => {});
+    return;
+  }
+
+  await reduceStreamingWithDispatch(result.value, (props) => {
+    const event: AgenticaDescribeEvent = createDescribeEvent({
+      executes: histories,
+      ...props,
+    });
+    void ctx.dispatch(event).catch(() => {});
+  }, ctx.abortSignal);
+}
+
+export const ChatGptDescribeFunctionAgent = {
+  execute: describe,
+};

package/src/orchestrate/execute.ts

@@ -1,61 +1,61 @@
-import type { AgenticaContext } from "../context/AgenticaContext";
-import type { AgenticaExecuteEvent } from "../events";
-import type { IAgenticaExecutor } from "../structures/IAgenticaExecutor";
-
-import { call } from "./call";
-import { cancel } from "./cancel";
-import { describe } from "./describe";
-import { initialize } from "./initialize";
-import { select } from "./select";
-
-export function execute(executor: Partial<IAgenticaExecutor> | null) {
-  return async (ctx: AgenticaContext): Promise<void> => {
-    // FUNCTIONS ARE NOT LISTED YET
-    if (ctx.ready() === false) {
-      if (executor?.initialize !== true && typeof executor?.initialize !== "function") {
-        await ctx.initialize();
-      }
-      else {
-        await (
-          typeof executor?.initialize === "function"
-            ? executor.initialize
-            : initialize
-        )(ctx);
-        if (ctx.ready() === false) {
-          return;
-        }
-      }
-    }
-
-    // CANCEL CANDIDATE FUNCTIONS
-    if (ctx.stack.length !== 0) {
-      await (executor?.cancel ?? cancel)(ctx);
-    }
-
-    // SELECT CANDIDATE FUNCTIONS
-    await (executor?.select ?? select)(ctx);
-    if (ctx.stack.length === 0) {
-      return;
-    }
-
-    // FUNCTION CALLING LOOP
-    while (true) {
-      // EXECUTE FUNCTIONS
-      const executes: AgenticaExecuteEvent[] = await (
-        executor?.call ?? call
-      )(ctx, ctx.stack.map(s => s.operation));
-
-      // EXPLAIN RETURN VALUES
-      if (executor?.describe !== null && executor?.describe !== false) {
-        await (
-          typeof executor?.describe === "function"
-            ? executor.describe
-            : describe
-        )(ctx, executes);
-      }
-      if (executes.length === 0 || ctx.stack.length === 0) {
-        break;
-      }
-    }
-  };
-}
+import type { AgenticaContext } from "../context/AgenticaContext";
+import type { AgenticaExecuteEvent } from "../events";
+import type { IAgenticaExecutor } from "../structures/IAgenticaExecutor";
+
+import { call } from "./call";
+import { cancel } from "./cancel";
+import { describe } from "./describe";
+import { initialize } from "./initialize";
+import { select } from "./select";
+
+export function execute(executor: Partial<IAgenticaExecutor> | null) {
+  return async (ctx: AgenticaContext): Promise<void> => {
+    // FUNCTIONS ARE NOT LISTED YET
+    if (ctx.ready() === false) {
+      if (executor?.initialize !== true && typeof executor?.initialize !== "function") {
+        await ctx.initialize();
+      }
+      else {
+        await (
+          typeof executor?.initialize === "function"
+            ? executor.initialize
+            : initialize
+        )(ctx);
+        if (ctx.ready() === false) {
+          return;
+        }
+      }
+    }
+
+    // CANCEL CANDIDATE FUNCTIONS
+    if (ctx.stack.length !== 0) {
+      await (executor?.cancel ?? cancel)(ctx);
+    }
+
+    // SELECT CANDIDATE FUNCTIONS
+    await (executor?.select ?? select)(ctx);
+    if (ctx.stack.length === 0) {
+      return;
+    }
+
+    // FUNCTION CALLING LOOP
+    while (true) {
+      // EXECUTE FUNCTIONS
+      const executes: AgenticaExecuteEvent[] = await (
+        executor?.call ?? call
+      )(ctx, ctx.stack.map(s => s.operation));
+
+      // EXPLAIN RETURN VALUES
+      if (executor?.describe !== null && executor?.describe !== false) {
+        await (
+          typeof executor?.describe === "function"
+            ? executor.describe
+            : describe
+        )(ctx, executes);
+      }
+      if (executes.length === 0 || ctx.stack.length === 0) {
+        break;
+      }
+    }
+  };
+}

package/src/orchestrate/index.ts

@@ -1,6 +1,6 @@
-export * from "./call";
-export * from "./cancel";
-export * from "./describe";
-export * from "./execute";
-export * from "./initialize";
-export * from "./select";
+export * from "./call";
+export * from "./cancel";
+export * from "./describe";
+export * from "./execute";
+export * from "./initialize";
+export * from "./select";

package/src/orchestrate/initialize.ts

@@ -1,102 +1,102 @@
-import type { ILlmFunction } from "@samchon/openapi";
-import type OpenAI from "openai";
-
-import typia from "typia";
-
-import type { AgenticaContext } from "../context/AgenticaContext";
-import type { __IChatInitialApplication } from "../context/internal/__IChatInitialApplication";
-import type { AgenticaAssistantMessageEvent } from "../events/AgenticaAssistantMessageEvent";
-
-import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
-import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
-import { createAssistantMessageEvent } from "../factory/events";
-import { decodeHistory, decodeUserMessageContent } from "../factory/histories";
-import { reduceStreamingWithDispatch } from "../utils/ChatGptCompletionStreamingUtil";
-import { toAsyncGenerator } from "../utils/StreamUtil";
-
-const FUNCTION: ILlmFunction = typia.llm.application<
-  __IChatInitialApplication
->().functions[0]!;
-
-export async function initialize(ctx: AgenticaContext): Promise<void> {
-  // ----
-  // EXECUTE CHATGPT API
-  // ----
-  const result = await ctx.request("initialize", {
-    messages: [
-      // PREVIOUS HISTORIES
-      ...ctx.histories.map(decodeHistory).flat(),
-      // USER INPUT
-      {
-        role: "user",
-        content: ctx.prompt.contents.map(decodeUserMessageContent),
-      },
-      // SYSTEM PROMPT
-      {
-        role: "system",
-        content:
-          ctx.config?.systemPrompt?.initialize?.(ctx.histories)
-          ?? AgenticaSystemPrompt.INITIALIZE,
-      },
-      // COMMON SYSTEM PROMPT
-      {
-        role: "system",
-        content: AgenticaDefaultPrompt.write(ctx.config),
-      } satisfies OpenAI.ChatCompletionSystemMessageParam,
-    ],
-    // GETTER FUNCTION
-    tools: [
-      {
-        type: "function",
-        function: {
-          name: FUNCTION.name,
-          description: FUNCTION.description,
-          /**
-           * @TODO fix it
-           * The property and value have a type mismatch, but it works.
-           */
-          parameters: FUNCTION.parameters as unknown as Record<string, unknown>,
-        },
-      },
-    ],
-    tool_choice: "auto",
-    // parallel_tool_calls: false,
-  });
-
-  if (result.type === "none-stream") {
-    const message = result.value.choices?.[0]?.message.content ?? "";
-    const event = createAssistantMessageEvent({
-      stream: toAsyncGenerator(message),
-      done: () => true,
-      get: () => message,
-      join: async () => message,
-    });
-    void ctx.dispatch(event).catch(() => {});
-    return;
-  }
-
-  const completion = await reduceStreamingWithDispatch(result.value, (props) => {
-    const event: AgenticaAssistantMessageEvent = createAssistantMessageEvent(props);
-    void ctx.dispatch(event).catch(() => {});
-  }, ctx.abortSignal);
-
-  if (completion === null) {
-    throw new Error("No completion received");
-  }
-
-  // ----
-  // PROCESS COMPLETION
-  // ----
-  if (
-    completion.choices?.some(
-      c =>
-        c.message.tool_calls != null
-        && c.message.tool_calls.some(
-          tc =>
-            tc.type === "function" && tc.function.name === FUNCTION.name,
-        ),
-    )
-  ) {
-    await ctx.initialize();
-  }
-}
+import type OpenAI from "openai";
+import type { ILlmFunction } from "typia";
+
+import typia from "typia";
+
+import type { AgenticaContext } from "../context/AgenticaContext";
+import type { __IChatInitialApplication } from "../context/internal/__IChatInitialApplication";
+import type { AgenticaAssistantMessageEvent } from "../events/AgenticaAssistantMessageEvent";
+
+import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
+import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
+import { createAssistantMessageEvent } from "../factory/events";
+import { decodeHistory, decodeUserMessageContent } from "../factory/histories";
+import { reduceStreamingWithDispatch } from "../utils/ChatGptCompletionStreamingUtil";
+import { toAsyncGenerator } from "../utils/StreamUtil";
+
+const FUNCTION: ILlmFunction = typia.llm.application<
+  __IChatInitialApplication
+>().functions[0]!;
+
+export async function initialize(ctx: AgenticaContext): Promise<void> {
+  // ----
+  // EXECUTE CHATGPT API
+  // ----
+  const result = await ctx.request("initialize", {
+    messages: [
+      // PREVIOUS HISTORIES
+      ...ctx.histories.map(decodeHistory).flat(),
+      // USER INPUT
+      {
+        role: "user",
+        content: ctx.prompt.contents.map(decodeUserMessageContent),
+      },
+      // SYSTEM PROMPT
+      {
+        role: "system",
+        content:
+          ctx.config?.systemPrompt?.initialize?.(ctx.histories)
+          ?? AgenticaSystemPrompt.INITIALIZE,
+      },
+      // COMMON SYSTEM PROMPT
+      {
+        role: "system",
+        content: AgenticaDefaultPrompt.write(ctx.config),
+      } satisfies OpenAI.ChatCompletionSystemMessageParam,
+    ],
+    // GETTER FUNCTION
+    tools: [
+      {
+        type: "function",
+        function: {
+          name: FUNCTION.name,
+          description: FUNCTION.description,
+          /**
+           * @TODO fix it
+           * The property and value have a type mismatch, but it works.
+           */
+          parameters: FUNCTION.parameters as unknown as Record<string, unknown>,
+        },
+      },
+    ],
+    tool_choice: "auto",
+    // parallel_tool_calls: false,
+  });
+
+  if (result.type === "none-stream") {
+    const message = result.value.choices?.[0]?.message.content ?? "";
+    const event = createAssistantMessageEvent({
+      stream: toAsyncGenerator(message),
+      done: () => true,
+      get: () => message,
+      join: async () => message,
+    });
+    void ctx.dispatch(event).catch(() => {});
+    return;
+  }
+
+  const completion = await reduceStreamingWithDispatch(result.value, (props) => {
+    const event: AgenticaAssistantMessageEvent = createAssistantMessageEvent(props);
+    void ctx.dispatch(event).catch(() => {});
+  }, ctx.abortSignal);
+
+  if (completion === null) {
+    throw new Error("No completion received");
+  }
+
+  // ----
+  // PROCESS COMPLETION
+  // ----
+  if (
+    completion.choices?.some(
+      c =>
+        c.message.tool_calls != null
+        && c.message.tool_calls.some(
+          tc =>
+            tc.type === "function" && tc.function.name === FUNCTION.name,
+        ),
+    )
+  ) {
+    await ctx.initialize();
+  }
+}

package/src/orchestrate/internal/cancelFunctionFromContext.ts

@@ -1,33 +1,33 @@
-import type { AgenticaContext } from "../../context/AgenticaContext";
-import type { AgenticaOperationSelection } from "../../context/AgenticaOperationSelection";
-import type { __IChatFunctionReference } from "../../context/internal/__IChatFunctionReference";
-import type { AgenticaCancelEvent } from "../../events";
-
-import { createCancelEvent } from "../../factory/events";
-import { createOperationSelection } from "../../factory/operations";
-
-/**
- * @internal
- */
-export function cancelFunctionFromContext(
-  ctx: AgenticaContext,
-  reference: __IChatFunctionReference,
-): void {
-  const index: number = ctx.stack.findIndex(
-    item => item.operation.name === reference.name,
-  );
-  if (index === -1) {
-    return;
-  }
-
-  const item: AgenticaOperationSelection = ctx.stack[index]!;
-  ctx.stack.splice(index, 1);
-
-  const event: AgenticaCancelEvent = createCancelEvent({
-    selection: createOperationSelection({
-      operation: item.operation,
-      reason: reference.reason,
-    }),
-  });
-  void ctx.dispatch(event).catch(() => {});
-}
+import type { AgenticaContext } from "../../context/AgenticaContext";
+import type { AgenticaOperationSelection } from "../../context/AgenticaOperationSelection";
+import type { __IChatFunctionReference } from "../../context/internal/__IChatFunctionReference";
+import type { AgenticaCancelEvent } from "../../events";
+
+import { createCancelEvent } from "../../factory/events";
+import { createOperationSelection } from "../../factory/operations";
+
+/**
+ * @internal
+ */
+export function cancelFunctionFromContext(
+  ctx: AgenticaContext,
+  reference: __IChatFunctionReference,
+): void {
+  const index: number = ctx.stack.findIndex(
+    item => item.operation.name === reference.name,
+  );
+  if (index === -1) {
+    return;
+  }
+
+  const item: AgenticaOperationSelection = ctx.stack[index]!;
+  ctx.stack.splice(index, 1);
+
+  const event: AgenticaCancelEvent = createCancelEvent({
+    selection: createOperationSelection({
+      operation: item.operation,
+      reason: reference.reason,
+    }),
+  });
+  void ctx.dispatch(event).catch(() => {});
+}

package/src/orchestrate/internal/selectFunctionFromContext.ts

@@ -1,34 +1,34 @@
-import type { AgenticaContext } from "../../context/AgenticaContext";
-import type { AgenticaOperation } from "../../context/AgenticaOperation";
-import type { AgenticaOperationSelection } from "../../context/AgenticaOperationSelection";
-import type { __IChatFunctionReference } from "../../context/internal/__IChatFunctionReference";
-import type { AgenticaSelectEvent } from "../../events/AgenticaSelectEvent";
-
-import { createSelectEvent } from "../../factory/events";
-import { createOperationSelection } from "../../factory/operations";
-
-/**
- * @internal
- */
-export function selectFunctionFromContext(
-  ctx: AgenticaContext,
-  reference: __IChatFunctionReference,
-): void {
-  const operation: AgenticaOperation | undefined
-    = ctx.operations.flat.get(reference.name);
-  if (operation === undefined) {
-    return;
-  }
-
-  const selection: AgenticaOperationSelection
-    = createOperationSelection({
-      operation,
-      reason: reference.reason,
-    });
-  ctx.stack.push(selection);
-
-  const event: AgenticaSelectEvent = createSelectEvent({
-    selection,
-  });
-  void ctx.dispatch(event).catch(() => {});
-}
+import type { AgenticaContext } from "../../context/AgenticaContext";
+import type { AgenticaOperation } from "../../context/AgenticaOperation";
+import type { AgenticaOperationSelection } from "../../context/AgenticaOperationSelection";
+import type { __IChatFunctionReference } from "../../context/internal/__IChatFunctionReference";
+import type { AgenticaSelectEvent } from "../../events/AgenticaSelectEvent";
+
+import { createSelectEvent } from "../../factory/events";
+import { createOperationSelection } from "../../factory/operations";
+
+/**
+ * @internal
+ */
+export function selectFunctionFromContext(
+  ctx: AgenticaContext,
+  reference: __IChatFunctionReference,
+): void {
+  const operation: AgenticaOperation | undefined
+    = ctx.operations.flat.get(reference.name);
+  if (operation === undefined) {
+    return;
+  }
+
+  const selection: AgenticaOperationSelection
+    = createOperationSelection({
+      operation,
+      reason: reference.reason,
+    });
+  ctx.stack.push(selection);
+
+  const event: AgenticaSelectEvent = createSelectEvent({
+    selection,
+  });
+  void ctx.dispatch(event).catch(() => {});
+}