@agentica/core 0.20.0 → 0.22.0

package/src/orchestrate/call.ts

@@ -54,7 +54,7 @@ export async function call<Model extends ILlmSchema.Model>(
       // USER INPUT
       {
         role: "user",
-        content: ctx.prompt.text,
+        content: ctx.prompt.contents,
       },
       // SYSTEM PROMPT
       ...(ctx.config?.systemPrompt?.execute === null
@@ -72,13 +72,13 @@ export async function call<Model extends ILlmSchema.Model>(
           type: "function",
           function: {
             name: s.name,
-            // eslint-disable-next-line ts/no-unsafe-assignment, ts/no-unsafe-member-access
+
             description: s.function.description,
             parameters: (
               "separated" in s.function
-              // eslint-disable-next-line ts/no-unsafe-member-access
+
               && s.function.separated !== undefined
-                // eslint-disable-next-line ts/no-unsafe-member-access
+
                 ? (s.function.separated.llm
                   ?? ({
                     type: "object",
@@ -87,7 +87,7 @@ export async function call<Model extends ILlmSchema.Model>(
                     additionalProperties: false,
                     $defs: {},
                   } satisfies IChatGptSchema.IParameters))
-                // eslint-disable-next-line ts/no-unsafe-member-access
+
                 : s.function.parameters) as Record<string, any>,
           },
         }) as OpenAI.ChatCompletionTool,
@@ -181,13 +181,11 @@ export async function call<Model extends ILlmSchema.Model>(
       && choice.message.content.length !== 0
     ) {
       closures.push(async () => {
-        const value: AgenticaTextHistory = createTextHistory({
-          role: "assistant",
-          text: choice.message.content!,
-        });
+        const value: AgenticaTextHistory = createTextHistory(
+          { text: choice.message.content! },
+        );
         ctx.dispatch(
           createTextEvent({
-            role: "assistant",
             get: () => value.text,
             done: () => true,
             stream: toAsyncGenerator(value.text),
@@ -444,9 +442,9 @@ async function executeMcpOperation<Model extends ILlmSchema.Model>(
   operationArguments: Record<string, unknown>,
 ): Promise<unknown> {
   return operation.controller.client.callTool({
-    // eslint-disable-next-line ts/no-unsafe-member-access
+
     method: operation.function.name,
-    // eslint-disable-next-line ts/no-unsafe-assignment, ts/no-unsafe-member-access
+
     name: operation.function.name,
     arguments: operationArguments,
   }).then(v => v.content);
@@ -473,7 +471,7 @@ async function correct<Model extends ILlmSchema.Model>(
         // USER INPUT
         {
           role: "user",
-          content: ctx.prompt.text,
+          content: ctx.prompt.contents,
         },
         // TYPE CORRECTION
         ...(ctx.config?.systemPrompt?.execute === null
@@ -518,7 +516,7 @@ async function correct<Model extends ILlmSchema.Model>(
         type: "function",
         function: {
           name: call.operation.name,
-          // eslint-disable-next-line ts/no-unsafe-assignment, ts/no-unsafe-member-access
+
           description: call.operation.function.description,
           /**
            * @TODO fix it
@@ -526,9 +524,9 @@ async function correct<Model extends ILlmSchema.Model>(
            */
           parameters: (
             "separated" in call.operation.function
-            // eslint-disable-next-line ts/no-unsafe-member-access
+
             && call.operation.function.separated !== undefined
-            // eslint-disable-next-line ts/no-unsafe-member-access
+
               ? (call.operation.function.separated?.llm
                 ?? ({
                   $defs: {},
@@ -537,7 +535,7 @@ async function correct<Model extends ILlmSchema.Model>(
                   additionalProperties: false,
                   required: [],
                 } satisfies IChatGptSchema.IParameters))
-              // eslint-disable-next-line ts/no-unsafe-member-access
+
               : call.operation.function.parameters) as unknown as Record<string, unknown>,
         },
       },

package/src/orchestrate/cancel.ts

@@ -141,7 +141,7 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
         // USER INPUT
         {
           role: "user",
-          content: ctx.prompt.text,
+          content: ctx.prompt.contents,
         },
         // SYSTEM PROMPT
         {

package/src/orchestrate/execute.ts

@@ -17,13 +17,15 @@ export function execute<Model extends ILlmSchema.Model>(executor: Partial<IAgent
 
     // FUNCTIONS ARE NOT LISTED YET
     if (ctx.ready() === false) {
-      if (executor?.initialize === null) {
+      if (executor?.initialize !== true && typeof executor?.initialize !== "function") {
         await ctx.initialize();
       }
       else {
         histories.push(
           ...(await (
-            executor?.initialize ?? initialize
+            typeof executor?.initialize === "function"
+              ? executor.initialize
+              : initialize
           )(ctx)),
         );
         if (ctx.ready() === false) {
@@ -63,11 +65,15 @@ export function execute<Model extends ILlmSchema.Model>(executor: Partial<IAgent
       const executes: AgenticaExecuteHistory<Model>[] = prompts.filter(
         prompt => prompt.type === "execute",
       );
-      histories.push(
-        ...(await (
-          executor?.describe ?? describe
-        )(ctx, executes)),
-      );
+      if (executor?.describe !== null && executor?.describe !== false) {
+        histories.push(
+          ...(await (
+            typeof executor?.describe === "function"
+              ? executor.describe
+              : describe
+          )(ctx, executes)),
+        );
+      }
       if (executes.length === 0 || ctx.stack.length === 0) {
         break;
       }

package/src/orchestrate/initialize.ts

@@ -36,7 +36,7 @@ export async function initialize<Model extends ILlmSchema.Model>(ctx: AgenticaCo
         // USER INPUT
         {
           role: "user",
-          content: ctx.prompt.text,
+          content: ctx.prompt.contents,
         },
         {
           // SYSTEM PROMPT
@@ -108,7 +108,6 @@ export async function initialize<Model extends ILlmSchema.Model>(ctx: AgenticaCo
 
         ctx.dispatch(
           createTextEvent({
-            role: "assistant",
             stream: streamDefaultReaderToAsyncGenerator(mpsc.consumer.getReader()),
             done: () => mpsc.done(),
             get: () => textContext[choice.index]!.content,
@@ -145,10 +144,7 @@ export async function initialize<Model extends ILlmSchema.Model>(ctx: AgenticaCo
       && choice.message.content.length !== 0
     ) {
       prompts.push(
-        createTextHistory({
-          role: "assistant",
-          text: choice.message.content,
-        }),
+        createTextHistory({ text: choice.message.content }),
       );
     }
   }

package/src/orchestrate/select.ts

@@ -13,7 +13,6 @@ import type { __IChatSelectFunctionsApplication } from "../context/internal/__IC
 import type { AgenticaEvent } from "../events/AgenticaEvent";
 import type { AgenticaHistory } from "../histories/AgenticaHistory";
 import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
-import type { AgenticaTextHistory } from "../histories/AgenticaTextHistory";
 
 import { AgenticaConstant } from "../constants/AgenticaConstant";
 import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
@@ -145,7 +144,7 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
         // USER INPUT
         {
           role: "user",
-          content: ctx.prompt.text,
+          content: ctx.prompt.contents,
         },
         // SYSTEM PROMPT
         {
@@ -260,15 +259,11 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
       && choice.message.content != null
       && choice.message.content.length !== 0
     ) {
-      const text: AgenticaTextHistory = createTextHistory({
-        role: "assistant",
-        text: choice.message.content,
-      });
+      const text = createTextHistory({ text: choice.message.content });
       prompts.push(text);
 
       ctx.dispatch(
         createTextEvent({
-          role: "assistant",
           stream: toAsyncGenerator(text.text),
           join: async () => Promise.resolve(text.text),
           done: () => true,

package/src/structures/IAgenticaExecutor.ts

@@ -49,15 +49,17 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
    * conversate with the user.
    *
    * By the way, if you wanna skip the `initialize` agent, you can
-   * do it by configuring the {@link IAgenticaConfig.executor} as
-   * `null` value. In that case, the `initialize` agent will never be
-   * called, and {@link Agentica} just starts from the {@link select}
-   * agent.
+   * do it by configuring the {@link IAgenticaExecutor.initialize} as
+   * `undefined`, `false` or `null` value. In that case, the `initialize`
+   * agent will never be called, and {@link Agentica} just starts from the
+   * {@link select} agent.
    *
    * @param ctx Context of the agent
    * @returns List of prompts generated by the initializer
+   * @default false
    */
   initialize:
+    | boolean
     | null
     | ((ctx: AgenticaContext<Model>) => Promise<AgenticaHistory<Model>[]>);
 
@@ -124,14 +126,20 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
    * `Describe` agent explains the results of the function callings
    * to the user as markdown content.
    *
+   * If you configure this property as `false` or `null`, the describer
+   * agent will never be used.
+   *
    * @param ctx Context of the agent
    * @param executes List of function calling results
    * @returns List of prompts generated by the describer
    */
-  describe: (
-    ctx: AgenticaContext<Model>,
-    executes: AgenticaExecuteHistory<Model>[],
-  ) => Promise<AgenticaHistory<Model>[]>;
+  describe:
+    | boolean
+    | null
+    | ((
+      ctx: AgenticaContext<Model>,
+      executes: AgenticaExecuteHistory<Model>[],
+    ) => Promise<AgenticaHistory<Model>[]>);
 
   /**
    * Function canceler agent.

package/src/structures/IMicroAgenticaExecutor.ts

@@ -52,12 +52,18 @@ export interface IMicroAgenticaExecutor<Model extends ILlmSchema.Model> {
    * `Describe` agent explains the results of the function callings
    * to the user as markdown content.
    *
+   * If you configure this property as `false` or `null`, the describer
+   * agent never be used.
+   *
    * @param ctx Context of the agent
    * @param executes List of function calling results
    * @returns List of prompts generated by the describer
    */
-  describe: (
-    ctx: MicroAgenticaContext<Model>,
-    executes: AgenticaExecuteHistory<Model>[],
-  ) => Promise<MicroAgenticaHistory<Model>[]>;
+  describe:
+    | boolean
+    | null
+    | ((
+      ctx: MicroAgenticaContext<Model>,
+      executes: AgenticaExecuteHistory<Model>[],
+    ) => Promise<MicroAgenticaHistory<Model>[]>);
 }

package/src/transformers/AgenticaEventTransformer.ts

@@ -175,7 +175,6 @@ function transformText(props: {
   event: IAgenticaEventJson.IText;
 }): AgenticaTextEvent {
   return createTextEvent({
-    role: props.event.role,
     stream: toAsyncGenerator(props.event.text),
     done: () => true,
     get: () => props.event.text,