@agentica/core 0.11.0 → 0.12.0

package/lib/transformers/AgenticaPromptTransformer.js

@@ -73,7 +73,7 @@ var AgenticaPromptTransformer;
     });
     AgenticaPromptTransformer.transformDescribe = (props) => new AgenticaDescribePrompt_1.AgenticaDescribePrompt({
         text: props.prompt.text,
-        executes: props.prompt.executions.map((next) => AgenticaPromptTransformer.transformExecute({
+        executes: props.prompt.executes.map((next) => AgenticaPromptTransformer.transformExecute({
             operations: props.operations,
             prompt: next,
         })),

package/lib/transformers/AgenticaPromptTransformer.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgenticaPromptTransformer.js","sourceRoot":"","sources":["../../src/transformers/AgenticaPromptTransformer.ts"],"names":[],"mappings":";;;AAGA,sFAAmF;AAEnF,0EAAuE;AACvE,8EAA2E;AAC3E,4EAAyE;AAEzE,0EAAuE;AACvE,sEAAmE;AAEnE,IAAiB,yBAAyB,CAwGzC;AAxGD,WAAiB,yBAAyB;IAC3B,mCAAS,GAAG,CAAiC,KAGzD,EAAyB,EAAE;QAC1B,OAAO;QACP,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;YAC9B,OAAO,0BAAA,aAAa,CAAC;gBACnB,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,kBAAkB;aACb,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ;YACrC,OAAO,0BAAA,eAAe,CAAC;gBACrB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;aACA,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ;YACrC,OAAO,0BAAA,eAAe,CAAC;gBACrB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,UAAU;aACL,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS;YACtC,OAAO,0BAAA,gBAAgB,CAAC;gBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;aACA,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU;YACvC,OAAO,0BAAA,iBAAiB,CAAC;gBACvB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC,CAAC;IAEW,uCAAa,GAAG,CAAC,KAE7B,EAAsB,EAAE;QACvB,OAAO,IAAI,uCAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC,CAAC;IAEW,yCAAe,GAAG,CAAiC,KAG/D,EAA+B,EAAE,CAChC,IAAI,2CAAoB,CAAC;QACvB,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;QACnB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CACrC,CAAC,MAAM,EAAE,EAAE,CACT,IAAI,uDAA0B,CAAC;YAC7B,SAAS,EAAE,aAAa,CAAC;gBACvB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,KAAK,EAAE,MAAM,CAAC,SAAS;aACxB,CAAC;YACF,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CACL;KACF,CAAC,CAAC;IAEQ,yCAAe,GAAG,CAAiC,KAG/D,EAA+B,EAAE,CAChC,IAAI,2CAAoB,CAAC;QACvB,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;QACnB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CACrC,CAAC,MAAM,EAAE,EAAE,CACT,IAAI,uDAA0B,CAAC;YAC7B,SAAS,EAAE,aAAa,CAAC;gBACvB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,KAAK,EAAE,MAAM,CAAC,SAAS;aACxB,CAAC;YACF,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CACL;KACF,CAAC,CAAC;IAEQ,0CAAgB,GAAG,CAAiC,KAGhE,EAAgC,EAAE,CACjC,IAAI,6CAAqB,CAAC;QACxB,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;QACnB,SAAS,EAAE,aAAa,CAAC;YACvB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;SAC9B,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;QACjC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK;KAC1B,CAAC,CAAC;IAEQ,2CAAiB,GAAG,CAAiC,KAGjE,EAAiC,EAAE,CAClC,IAAI,+CAAsB,CAAC;QACzB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;QACvB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC7C,0BAAA,gBAAgB,CAAC;YACf,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM,EAAE,IAAI;SACb,CAAC,CACH;KACF,CAAC,CAAC;AACP,CAAC,EAxGgB,yBAAyB,yCAAzB,yBAAyB,QAwGzC;AAED,MAAM,aAAa,GAAG,CAAiC,KAMtD,EAA4B,EAAE;;IAC7B,MAAM,KAAK,GAAyC,MAAA,KAAK,CAAC,UAAU;SACjE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,0CAC1B,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS;QACrB,MAAM,IAAI,KAAK,CACb,oCAAoC,KAAK,CAAC,KAAK,CAAC,UAAU,eAAe,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CACjG,CAAC;IACJ,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}
+{"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.11.0",
+  "version": "0.12.0",
   "main": "lib/index.js",
   "description": "Agentic AI Library specialized in LLM Function Calling",
   "scripts": {

package/src/chatgpt/ChatGptDescribeFunctionAgent.ts

@@ -64,7 +64,7 @@ export namespace ChatGptDescribeFunctionAgent {
             continue;
           }
 
-          const { consumer, produce, close, waitClose, done } =
+          const { consumer, produce, close, waitClosed, waitUntilEmpty, done } =
             MPSCUtil.create<string>();
 
           describeContext[choice.index] = {
@@ -72,7 +72,8 @@ export namespace ChatGptDescribeFunctionAgent {
             consumer,
             produce,
             close,
-            waitClose,
+            waitClosed,
+            waitUntilEmpty,
             done,
           };
           produce(choice.delta.content);
@@ -84,7 +85,7 @@ export namespace ChatGptDescribeFunctionAgent {
               done,
               get: () => describeContext[choice.index]?.content ?? "",
               join: async () => {
-                await waitClose();
+                await waitClosed();
                 return describeContext[choice.index]!.content;
               },
             }),

package/src/context/internal/AgenticaTokenUsageAggregator.ts

@@ -1,11 +1,11 @@
 import { CompletionUsage } from "openai/resources";
-import { Primitive } from "typia";
 
+import { IAgenticaTokenUsageJson } from "../../json/IAgenticaTokenUsageJson";
 import { AgenticaTokenUsage } from "../AgenticaTokenUsage";
 
 export namespace AgenticaTokenUsageAggregator {
   export const aggregate = (props: {
-    kind: Exclude<keyof Primitive<AgenticaTokenUsage>, "aggregate">;
+    kind: Exclude<keyof IAgenticaTokenUsageJson, "aggregate">;
     completionUsage: CompletionUsage;
     usage: AgenticaTokenUsage;
   }): void => {

package/src/events/AgenticaDescribeEvent.ts

@@ -13,6 +13,11 @@ export class AgenticaDescribeEvent<
   public get text(): string {
     return this.get_();
   }
+
+  /**
+   * Check if the join method can return a response immediately.
+   * Returns true if the response is ready to be returned by the join method.
+   */
   public get done(): boolean {
     return this.done_();
   }

package/src/events/AgenticaTextEvent.ts

@@ -8,6 +8,11 @@ export class AgenticaTextEvent extends AgenticaEventBase<"text"> {
   public get text(): string {
     return this.get_();
   }
+
+  /**
+   * Check if the join method can return a response immediately.
+   * Returns true if the response is ready to be returned by the join method.
+   */
   public get done(): boolean {
     return this.done_();
   }

package/src/functional/assertHttpLlmApplication.ts

@@ -0,0 +1,55 @@
+import {
+  HttpLlm,
+  IHttpLlmApplication,
+  ILlmSchema,
+  OpenApi,
+  OpenApiV3,
+  OpenApiV3_1,
+  SwaggerV2,
+} from "@samchon/openapi";
+import typia from "typia";
+
+/**
+ * Create an HTTP LLM application instance with type assertion.
+ *
+ * Create an {@link IHttpLlmApplication} instance which represents
+ * the LLM (Large Language Model) function calling application schema
+ * from the given Swagger/OpenAPI document and the target LLM model.
+ *
+ * By the way, even though this `assertHttpLlmApplication` function
+ * supports every version of Swagger/OpenAPI specification, there can
+ * be a type error in the given document. In that case, the function
+ * will throw an error with detailed type error tracing information.
+ *
+ * @param props Properties to create the HTTP LLM application instance
+ * @returns  HTTP LLM application instance
+ * @throws {@link TypeGuardError} when the given document is invalid
+ * @author Samchon
+ */
+export const assertHttpLlmApplication = <
+  Model extends ILlmSchema.Model,
+>(props: {
+  /**
+   * Target LLM model.
+   */
+  model: Model;
+
+  /**
+   * Swagger/OpenAPI document.
+   */
+  document:
+    | SwaggerV2.IDocument
+    | OpenApiV3.IDocument
+    | OpenApiV3_1.IDocument
+    | OpenApi.IDocument;
+
+  /**
+   * Options for the LLM function calling schema composition.
+   */
+  options?: Partial<IHttpLlmApplication.IOptions<Model>>;
+}): IHttpLlmApplication<Model> =>
+  HttpLlm.application({
+    model: props.model,
+    document: OpenApi.convert(typia.assert(props.document)),
+    options: props.options,
+  });

package/src/functional/{createHttpLlmApplication.ts → validateHttpLlmApplication.ts}

@@ -1,6 +1,7 @@
 import {
   HttpLlm,
   IHttpLlmApplication,
+  ILlmSchema,
   OpenApi,
   OpenApiV3,
   OpenApiV3_1,
@@ -9,27 +10,29 @@ import {
 import typia, { IValidation } from "typia";
 
 /**
- * Create an HTTP LLM application instance.
- * 
+ * Create an HTTP LLM application instance with type validation.
+ *
  * Create an {@link IHttpLlmApplication} instance which represents
- * the LLM (Large Language Model) function calling application schema 
+ * the LLM (Large Language Model) function calling application schema
  * from the given Swagger/OpenAPI document and the target LLM model.
- * 
- * By the way, even though this `createHttpLlmApplication` function
+ *
+ * By the way, even though this `validateHttpLlmApplication` function
  * supports every version of Swagger/OpenAPI specification, there can
  * be a type error in the given document. In that case, the function
  * will return {@link IValidation.IFailure} instance with detailed
  * type error tracing information.
- * 
+ *
  * @param props Properties to create the HTTP LLM application instance
  * @returns Validation result of the HTTP LLM application composition
  * @author Samchon
  */
-export const createHttpLlmApplication = (props: {
+export const validateHttpLlmApplication = <
+  Model extends ILlmSchema.Model,
+>(props: {
   /**
    * Target LLM model.
    */
-  model: "chatgpt";
+  model: Model;
 
   /**
    * Swagger/OpenAPI document.
@@ -43,8 +46,8 @@ export const createHttpLlmApplication = (props: {
   /**
    * Options for the LLM function calling schema composition.
    */
-  options?: Partial<IHttpLlmApplication.IOptions<"chatgpt">>;
-}): IValidation<IHttpLlmApplication<"chatgpt">> => {
+  options?: Partial<IHttpLlmApplication.IOptions<Model>>;
+}): IValidation<IHttpLlmApplication<Model>> => {
   const inspect: IValidation<
     | SwaggerV2.IDocument
     | OpenApiV3.IDocument

package/src/index.ts

@@ -39,5 +39,6 @@ export * from "./events/AgenticaSelectEvent";
 export * from "./events/AgenticaTextEvent";
 
 // FACADE CLASS
-export * from "./functional/createHttpLlmApplication";
+export * from "./functional/assertHttpLlmApplication";
+export * from "./functional/validateHttpLlmApplication";
 export * from "./Agentica";

package/src/internal/MPSCUtil.ts

@@ -3,7 +3,18 @@ export namespace MPSCUtil {
     consumer: ReadableStream<T>;
     produce: (chunk: T) => void;
     close: () => void;
-    waitClose: () => Promise<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;
   }
 
@@ -19,12 +30,14 @@ export namespace MPSCUtil {
         }
       },
     });
+
     return {
       consumer,
       produce: (chunk: T) => queue.enqueue(chunk),
       close: () => queue.close(),
       done: () => queue.done(),
-      waitClose: () => queue.waitClose(),
+      waitClosed: () => queue.waitClosed(),
+      waitUntilEmpty: () => queue.waitUntilEmpty(),
     };
   };
 
@@ -32,7 +45,7 @@ export namespace MPSCUtil {
     private queue: T[] = [];
     private resolvers: ((value: IteratorResult<T, undefined>) => void)[] = [];
     private closeResolvers: (() => void)[] = [];
-
+    private emptyResolvers: (() => void)[] = [];
     private closed = false;
 
     enqueue(item: T) {
@@ -46,14 +59,28 @@ export namespace MPSCUtil {
       if (this.queue.length > 0) {
         return { value: this.queue.shift()!, done: false };
       }
-      if (this.closed) return { value: undefined, done: true };
+      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));
     }
 
-    done() {
+    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) {
@@ -62,8 +89,17 @@ export namespace MPSCUtil {
       this.closeResolvers.forEach((resolve) => resolve());
     }
 
-    waitClose() {
-      if (this.closed) {
+    waitUntilEmpty() {
+      if (this.isEmpty()) {
+        return Promise.resolve();
+      }
+      return new Promise<void>((resolve) => {
+        this.emptyResolvers.push(resolve);
+      });
+    }
+
+    waitClosed() {
+      if (this.isClosed()) {
         return Promise.resolve();
       }
 

package/src/json/IAgenticaPromptJson.ts

@@ -96,7 +96,7 @@ export namespace IAgenticaPromptJson {
      *
      * This prompt describes the return value of them.
      */
-    executions: IExecute[];
+    executes: IExecute[];
 
     /**
      * Description text.

package/src/prompts/AgenticaDescribePrompt.ts

@@ -28,7 +28,7 @@ export class AgenticaDescribePrompt<
   public toJSON(): IAgenticaPromptJson.IDescribe {
     return {
       type: this.type,
-      executions: this.executes.map((e) => e.toJSON()),
+      executes: this.executes.map((e) => e.toJSON()),
       text: this.text,
     };
   }

package/src/structures/IAgenticaConfig.ts

@@ -22,6 +22,33 @@ import { IAgenticaSystemPrompt } from "./IAgenticaSystemPrompt";
  * @author Samchon
  */
 export interface IAgenticaConfig<Model extends ILlmSchema.Model> {
+  /**
+   * Agent executor.
+   *
+   * Executor function of Agentic AI's iteration plan to internal agents
+   * running by the {@link Agentica.conversate} function.
+   *
+   * If you want to customize the agent execution plan, you can do it
+   * by assigning you logic function of entire or partial to this property.
+   * When customizing it, it would better to reference the
+   * {@link ChatGptAgent.execute} function.
+   *
+   * @param ctx Context of the agent
+   * @returns Lit of prompts generated by the executor
+   * @default ChatGptAgent.execute
+   */
+  executor?:
+    | Partial<IAgenticaExecutor<Model>>
+    | ((ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>);
+
+  /**
+   * System prompt messages.
+   *
+   * System prompt messages if you want to customize the system prompt
+   * messages for each situation.
+   */
+  systemPrompt?: IAgenticaSystemPrompt<Model>;
+
   /**
    * Locale of the A.I. chatbot.
    *
@@ -93,31 +120,4 @@ export interface IAgenticaConfig<Model extends ILlmSchema.Model> {
    * @default true
    */
   eliticism?: boolean;
-
-  /**
-   * System prompt messages.
-   *
-   * System prompt messages if you want to customize the system prompt
-   * messages for each situation.
-   */
-  systemPrompt?: IAgenticaSystemPrompt<Model>;
-
-  /**
-   * Agent executor.
-   *
-   * Executor function of Agentic AI's iteration plan to internal agents
-   * running by the {@link Agentica.conversate} function.
-   *
-   * If you want to customize the agent execution plan, you can do it
-   * by assigning you logic function of entire or partial to this property.
-   * When customizing it, it would better to reference the
-   * {@link ChatGptAgent.execute} function.
-   *
-   * @param ctx Context of the agent
-   * @returns Lit of prompts generated by the executor
-   * @default ChatGptAgent.execute
-   */
-  executor?:
-    | Partial<IAgenticaExecutor<Model>>
-    | ((ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>);
 }

package/src/structures/IAgenticaController.ts

@@ -30,7 +30,7 @@ export namespace IAgenticaController {
   /**
    * HTTP controller.
    *
-   * You can make it by {@link createHttpLlmApplication} function with
+   * You can make it by {@link validateHttpLlmApplication} function with
    * the Swagger or OpenAPI document.
    */
   export interface IHttp<Model extends ILlmSchema.Model>

package/src/structures/IAgenticaProps.ts

@@ -55,7 +55,7 @@ export interface IAgenticaProps<Model extends ILlmSchema.Model> {
    * - `locale`: your system's locale and timezone
    * - `timezone`: your system's timezone
    * - `systemPrompt`: default prompts written in markdown
-   *   - https://github.com/samchon/nestia/tree/master/packages/agent/prompts
+   *   - https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts
    */
   config?: IAgenticaConfig<Model>;
 

package/src/structures/IAgenticaSystemPrompt.ts

@@ -18,7 +18,7 @@ import { IAgenticaConfig } from "./IAgenticaConfig";
  * would be used which are written in the below directory as markdown
  * documents.
  *
- * - https://github.com/samchon/nestia/tree/master/packages/agent/prompts
+ * - https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts
  *
  * @author Samchon
  */
@@ -28,7 +28,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    *
    * @param config Configuration of the agent
    * @returns The common system prompt
-   * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/common.md
+   * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/common.md
    */
   common?: (config?: IAgenticaConfig<Model> | undefined) => string;
 
@@ -46,7 +46,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    *
    * @param histories Histories of the previous prompts
    * @returns initialize system prompt
-   * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/initialize.md
+   * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/initialize.md
    */
   initialize?: (histories: AgenticaPrompt<Model>[]) => string;
 
@@ -67,7 +67,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    *
    * @param histories Histories of the previous prompts
    * @returns select system promopt
-   * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/select.md
+   * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/select.md
    */
   select?: (histories: AgenticaPrompt<Model>[]) => string;
 
@@ -84,7 +84,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    *
    * @param histories Histories of the previous prompts
    * @returns cancel system prompt
-   * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/cancel.md
+   * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/cancel.md
    */
   cancel?: (histories: AgenticaPrompt<Model>[]) => string;
 
@@ -102,7 +102,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    *
    * @param histories Histories of the previous prompts
    * @returns execute system prompt
-   * https://github.com/samchon/nestia/blob/master/packages/agent/prompts/execute.md
+   * https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/execute.md
    */
   execute?: (histories: AgenticaPrompt<Model>[]) => string;
 
@@ -119,7 +119,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    *
    * @param histories Histories of the previous prompts
    * @returns describe system prompt
-   * @default https://github.com/samchon/nestia/blob/master/packages/agent/prompts/describe.md
+   * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/describe.md
    */
   describe?: (histories: AgenticaExecutePrompt<Model>[]) => string;
 }

package/src/transformers/AgenticaPromptTransformer.ts

@@ -107,7 +107,7 @@ export namespace AgenticaPromptTransformer {
   }): AgenticaDescribePrompt<Model> =>
     new AgenticaDescribePrompt({
       text: props.prompt.text,
-      executes: props.prompt.executions.map((next) =>
+      executes: props.prompt.executes.map((next) =>
         transformExecute({
           operations: props.operations,
           prompt: next,