@agentica/core 0.27.3 → 0.28.0

package/lib/index.mjs

@@ -1,8 +1,10 @@
-import "typia";
+import { is_node, Semaphore } from "tstl";
 
 import { v4 } from "uuid";
 
-import { HttpLlm, ChatGptTypeChecker, LlmTypeCheckerV3_1, OpenApi, McpLlm } from "@samchon/openapi";
+import "typia";
+
+import { ChatGptTypeChecker, LlmTypeCheckerV3_1, HttpLlm, OpenApi, McpLlm } from "@samchon/openapi";
 
 import * as __typia_transform__validateReport from "typia/lib/internal/_validateReport.js";
 
@@ -289,10 +291,10 @@ function decodeHistory(history) {
                 function: {
                     name: `${history.type}Functions`,
                     arguments: JSON.stringify({
-                        functions: history.selections.map((s => ({
-                            name: s.operation.function.name,
-                            reason: s.reason
-                        })))
+                        function: {
+                            name: history.selection.operation.name,
+                            reason: history.selection.reason
+                        }
                     })
                 }
             } ]
@@ -396,9 +398,13 @@ function decodeUserMessageContent(content) {
 function createUserMessageHistory(props) {
     return {
         type: "userMessage",
+        id: props.id,
+        created_at: props.created_at,
         contents: props.contents,
         toJSON: () => ({
             type: "userMessage",
+            id: props.id,
+            created_at: props.created_at,
             contents: props.contents
         })
     };
@@ -407,6 +413,8 @@ function createUserMessageHistory(props) {
 function createAssistantMessageHistory(props) {
     const prompt = {
         type: "assistantMessage",
+        id: props.id,
+        created_at: props.created_at,
         text: props.text
     };
     return {
@@ -418,6 +426,8 @@ function createAssistantMessageHistory(props) {
 function createSystemMessageHistory(props) {
     const prompt = {
         type: "systemMessage",
+        id: props.id,
+        created_at: props.created_at,
         text: props.text
     };
     return {
@@ -429,10 +439,14 @@ function createSystemMessageHistory(props) {
 function createDescribeHistory(props) {
     return {
         type: "describe",
+        id: props.id,
+        created_at: props.created_at,
         text: props.text,
         executes: props.executes,
         toJSON: () => ({
             type: "describe",
+            id: props.id,
+            created_at: props.created_at,
             text: props.text,
             executes: props.executes.map((execute => execute.toJSON()))
         })
@@ -443,11 +457,13 @@ function createSelectHistory(props) {
     return {
         type: "select",
         id: props.id,
-        selections: props.selections,
+        selection: props.selection,
+        created_at: props.created_at,
         toJSON: () => ({
             type: "select",
             id: props.id,
-            selections: props.selections.map((selection => selection.toJSON()))
+            created_at: props.created_at,
+            selection: props.selection.toJSON()
         })
     };
 }
@@ -456,11 +472,13 @@ function createCancelHistory(props) {
     return {
         type: "cancel",
         id: props.id,
-        selections: props.selections,
+        created_at: props.created_at,
+        selection: props.selection,
         toJSON: () => ({
             type: "cancel",
             id: props.id,
-            selections: props.selections.map((selection => selection.toJSON()))
+            created_at: props.created_at,
+            selection: props.selection.toJSON()
         })
     };
 }
@@ -470,13 +488,15 @@ function createExecuteHistory(props) {
         type: "execute",
         protocol: props.operation.protocol,
         id: props.id,
+        created_at: props.created_at,
         operation: props.operation,
         arguments: props.arguments,
         value: props.value,
         toJSON: () => ({
             type: "execute",
-            protocol: props.operation.protocol,
             id: props.id,
+            created_at: props.created_at,
+            protocol: props.operation.protocol,
             operation: props.operation.toJSON(),
             arguments: props.arguments,
             value: props.value
@@ -486,49 +506,69 @@ function createExecuteHistory(props) {
 
 function createInitializeEvent() {
     const event = {
-        type: "initialize"
+        id: v4(),
+        type: "initialize",
+        created_at: (new Date).toISOString()
     };
     return {
+        id: event.id,
         type: event.type,
+        created_at: event.created_at,
         toJSON: () => event
     };
 }
 
 function createSelectEvent(props) {
+    const id = v4();
+    const created_at = (new Date).toISOString();
     return {
         type: "select",
+        id,
+        created_at,
         selection: props.selection,
         toJSON: () => ({
             type: "select",
+            id,
+            created_at,
             selection: props.selection.toJSON()
         }),
         toHistory: () => createSelectHistory({
-            id: v4(),
-            selections: [ props.selection ]
+            id,
+            created_at,
+            selection: props.selection
         })
     };
 }
 
 function createCancelEvent(props) {
+    const id = v4();
+    const created_at = (new Date).toISOString();
     return {
         type: "cancel",
+        id,
+        created_at,
         selection: props.selection,
         toJSON: () => ({
             type: "cancel",
+            id,
+            created_at,
             selection: props.selection.toJSON()
         })
     };
 }
 
 function createCallEvent(props) {
+    const created_at = (new Date).toISOString();
     return {
         type: "call",
         id: props.id,
+        created_at,
         operation: props.operation,
         arguments: props.arguments,
         toJSON: () => ({
             type: "call",
             id: props.id,
+            created_at,
             operation: props.operation.toJSON(),
             arguments: props.arguments
         })
@@ -536,14 +576,17 @@ function createCallEvent(props) {
 }
 
 function createValidateEvent(props) {
+    const created_at = (new Date).toISOString();
     return {
         type: "validate",
         id: props.id,
+        created_at,
         operation: props.operation,
         result: props.result,
         toJSON: () => ({
             type: "validate",
             id: props.id,
+            created_at,
             operation: props.operation.toJSON(),
             result: props.result
         })
@@ -551,54 +594,80 @@ function createValidateEvent(props) {
 }
 
 function createExecuteEvent(props) {
+    const id = v4();
+    const created_at = (new Date).toISOString();
     return {
         type: "execute",
+        id,
+        created_at,
         protocol: props.operation.protocol,
-        id: props.id,
         operation: props.operation,
         arguments: props.arguments,
         value: props.value,
         toJSON: () => ({
             type: "execute",
+            id,
+            created_at,
             protocol: props.operation.protocol,
-            id: props.id,
             operation: props.operation.toJSON(),
             arguments: props.arguments,
             value: props.value
         }),
-        toHistory: () => createExecuteHistory(props)
+        toHistory: () => createExecuteHistory({
+            id,
+            created_at,
+            ...props
+        })
     };
 }
 
 function createUserMessageEvent(props) {
+    const id = v4();
+    const created_at = (new Date).toISOString();
     return {
         type: "userMessage",
+        id,
+        created_at,
         contents: props.contents,
         toJSON: () => ({
             type: "userMessage",
+            id,
+            created_at,
             contents: props.contents
         }),
         toHistory: () => createUserMessageHistory({
+            id,
+            created_at,
             contents: props.contents
         })
     };
 }
 
-function creatAssistantEvent(props) {
+function creatAssistantMessageEvent(props) {
+    const id = v4();
+    const created_at = (new Date).toISOString();
     return {
         type: "assistantMessage",
+        id,
+        created_at,
         stream: props.stream,
         join: props.join,
         toJSON: () => ({
             type: "assistantMessage",
+            id,
+            created_at,
             done: props.done(),
             text: props.get()
         }),
         toHistory: () => ({
             type: "assistantMessage",
+            id,
+            created_at,
             text: props.get(),
             toJSON: () => ({
                 type: "assistantMessage",
+                id,
+                created_at,
                 text: props.get()
             })
         })
@@ -606,23 +675,33 @@ function creatAssistantEvent(props) {
 }
 
 function createDescribeEvent(props) {
+    const id = v4();
+    const created_at = (new Date).toISOString();
     return {
         type: "describe",
+        id,
+        created_at,
         executes: props.executes,
         stream: props.stream,
         join: props.join,
         toJSON: () => ({
             type: "describe",
+            id,
+            created_at,
             executes: props.executes.map((execute => execute.toJSON())),
             done: props.done(),
             text: props.get()
         }),
         toHistory: () => ({
             type: "describe",
+            id,
+            created_at,
             executes: props.executes,
             text: props.get(),
             toJSON: () => ({
                 type: "describe",
+                id,
+                created_at,
                 executes: props.executes.map((execute => execute.toJSON())),
                 text: props.get()
             })
@@ -631,8 +710,12 @@ function createDescribeEvent(props) {
 }
 
 function createRequestEvent(props) {
+    const id = v4();
+    const created_at = (new Date).toISOString();
     return {
         type: "request",
+        id,
+        created_at,
         source: props.source,
         body: props.body,
         options: props.options
@@ -640,8 +723,12 @@ function createRequestEvent(props) {
 }
 
 function createResponseEvent(props) {
+    const id = v4();
+    const created_at = (new Date).toISOString();
     return {
         type: "response",
+        id,
+        created_at,
         source: props.source,
         body: props.body,
         options: props.options,
@@ -650,42 +737,6 @@ function createResponseEvent(props) {
     };
 }
 
-function createOperationSelection(props) {
-    return {
-        operation: props.operation,
-        reason: props.reason,
-        toJSON: () => ({
-            operation: props.operation.toJSON(),
-            reason: props.reason
-        })
-    };
-}
-
-var index$2 = Object.freeze({
-    __proto__: null,
-    creatAssistantEvent,
-    createAssistantMessageHistory,
-    createCallEvent,
-    createCancelEvent,
-    createCancelHistory,
-    createDescribeEvent,
-    createDescribeHistory,
-    createExecuteEvent,
-    createExecuteHistory,
-    createInitializeEvent,
-    createOperationSelection,
-    createRequestEvent,
-    createResponseEvent,
-    createSelectEvent,
-    createSelectHistory,
-    createSystemMessageHistory,
-    createUserMessageEvent,
-    createUserMessageHistory,
-    createValidateEvent,
-    decodeHistory,
-    decodeUserMessageContent
-});
-
 var AgenticaConstant;
 
 (function(AgenticaConstant) {
@@ -717,12 +768,7 @@ const AgenticaSystemPrompt = {
     SELECT: "You are a helpful assistant for selecting functions to call.\n\nUse the supplied tools to select some functions of `getApiFunctions()` returned.\n\nWhen selecting functions to call, pay attention to the relationship between functions. In particular, check the prerequisites between each function.\n\nIf you can't find any proper function to select, just type your own message. By the way, when typing your own message, please consider the user's language locale code. If your message is different with the user's language, please translate it to the user's."
 };
 
-const isNode = new Singleton((() => {
-    const isObject = obj => typeof obj === "object" && obj !== null;
-    return typeof global === "object" && isObject(global) && isObject(global.process) && isObject(global.process.versions) && typeof global.process.versions.node !== "undefined";
-}));
-
-const getLocale = new Singleton((() => isNode.get() ? process.env.LANG?.split(".")[0] ?? "en-US" : navigator.language));
+const getLocale = new Singleton((() => is_node() ? process.env.LANG?.split(".")[0] ?? "en-US" : navigator.language));
 
 const getTimezone = new Singleton((() => Intl.DateTimeFormat().resolvedOptions().timeZone));
 
@@ -801,7 +847,7 @@ function transformCompletionChunk(source) {
     const str = source instanceof Uint8Array ? ByteArrayUtil.toUtf8(source) : source;
     const result = JSON.parse(str);
     const valid = (() => {
-        const _io0 = input => "string" === typeof input.id && (Array.isArray(input.choices) && input.choices.every((elem => "object" === typeof elem && null !== elem && _io1(elem)))) && "number" === typeof input.created && "string" === typeof input.model && "chat.completion.chunk" === input.object && (null === input.service_tier || undefined === input.service_tier || "scale" === input.service_tier || "default" === input.service_tier) && (undefined === input.system_fingerprint || "string" === typeof input.system_fingerprint) && (null === input.usage || undefined === input.usage || "object" === typeof input.usage && null !== input.usage && _io9(input.usage));
+        const _io0 = input => "string" === typeof input.id && (Array.isArray(input.choices) && input.choices.every((elem => "object" === typeof elem && null !== elem && _io1(elem)))) && "number" === typeof input.created && "string" === typeof input.model && "chat.completion.chunk" === input.object && (null === input.service_tier || undefined === input.service_tier || "auto" === input.service_tier || "default" === input.service_tier || "flex" === input.service_tier) && (undefined === input.system_fingerprint || "string" === typeof input.system_fingerprint) && (null === input.usage || undefined === input.usage || "object" === typeof input.usage && null !== input.usage && _io9(input.usage));
         const _io1 = input => "object" === typeof input.delta && null !== input.delta && false === Array.isArray(input.delta) && _io2(input.delta) && (null === input.finish_reason || "length" === input.finish_reason || "function_call" === input.finish_reason || "stop" === input.finish_reason || "tool_calls" === input.finish_reason || "content_filter" === input.finish_reason) && "number" === typeof input.index && (null === input.logprobs || undefined === input.logprobs || "object" === typeof input.logprobs && null !== input.logprobs && _io6(input.logprobs));
         const _io2 = input => (null === input.content || undefined === input.content || "string" === typeof input.content) && (undefined === input.function_call || "object" === typeof input.function_call && null !== input.function_call && false === Array.isArray(input.function_call) && _io3(input.function_call)) && (null === input.refusal || undefined === input.refusal || "string" === typeof input.refusal) && (undefined === input.role || "user" === input.role || "developer" === input.role || "system" === input.role || "assistant" === input.role || "tool" === input.role) && (undefined === input.tool_calls || Array.isArray(input.tool_calls) && input.tool_calls.every((elem => "object" === typeof elem && null !== elem && _io4(elem))));
         const _io3 = input => (undefined === input.arguments || "string" === typeof input.arguments) && (undefined === input.name || "string" === typeof input.name);
@@ -845,9 +891,9 @@ function transformCompletionChunk(source) {
             path: _path + ".object",
             expected: '"chat.completion.chunk"',
             value: input.object
-        }), null === input.service_tier || undefined === input.service_tier || "scale" === input.service_tier || "default" === input.service_tier || _report(_exceptionable, {
+        }), null === input.service_tier || undefined === input.service_tier || "auto" === input.service_tier || "default" === input.service_tier || "flex" === input.service_tier || _report(_exceptionable, {
             path: _path + ".service_tier",
-            expected: '("default" | "scale" | null | undefined)',
+            expected: '("auto" | "default" | "flex" | null | undefined)',
             value: input.service_tier
         }), undefined === input.system_fingerprint || "string" === typeof input.system_fingerprint || _report(_exceptionable, {
             path: _path + ".system_fingerprint",
@@ -1343,20 +1389,31 @@ const StreamUtil = {
     transform
 };
 
-function cancelFunction(ctx, reference) {
+function createOperationSelection(props) {
+    return {
+        operation: props.operation,
+        reason: props.reason,
+        toJSON: () => ({
+            operation: props.operation.toJSON(),
+            reason: props.reason
+        })
+    };
+}
+
+function cancelFunctionFromContext(ctx, reference) {
     const index = ctx.stack.findIndex((item => item.operation.name === reference.name));
     if (index === -1) {
-        return null;
+        return;
     }
     const item = ctx.stack[index];
     ctx.stack.splice(index, 1);
-    ctx.dispatch(createCancelEvent({
+    const event = createCancelEvent({
         selection: createOperationSelection({
             operation: item.operation,
             reason: reference.reason
         })
-    })).catch((() => {}));
-    return item;
+    });
+    ctx.dispatch(event);
 }
 
 async function call(ctx, operations) {
@@ -1388,9 +1445,9 @@ async function call(ctx, operations) {
         tool_choice: "auto",
         parallel_tool_calls: false
     });
-    const closures = [];
     const chunks = await StreamUtil.readAll(completionStream);
     const completion = ChatGptCompletionMessageUtil.merge(chunks);
+    const executes = [];
     for (const choice of completion.choices) {
         for (const tc of choice.message.tool_calls ?? []) {
             if (tc.type === "function") {
@@ -1398,59 +1455,41 @@ async function call(ctx, operations) {
                 if (operation === undefined) {
                     continue;
                 }
-                closures.push((async () => {
-                    const call = createCallEvent({
-                        id: tc.id,
-                        operation,
-                        arguments: JSON.parse(tc.function.arguments)
-                    });
-                    if (call.operation.protocol === "http") {
-                        fillHttpArguments({
-                            operation: call.operation,
-                            arguments: call.arguments
-                        });
-                    }
-                    await ctx.dispatch(call);
-                    const execute = await propagate(ctx, call, 0);
-                    ctx.dispatch(createExecuteEvent({
-                        id: call.id,
+                const call = createCallEvent({
+                    id: tc.id,
+                    operation,
+                    arguments: JSON.parse(tc.function.arguments)
+                });
+                if (call.operation.protocol === "http") {
+                    fillHttpArguments({
                         operation: call.operation,
-                        arguments: execute.arguments,
-                        value: execute.value
-                    })).catch((() => {}));
-                    if (isAgenticaContext(ctx)) {
-                        cancelFunction(ctx, {
-                            name: call.operation.name,
-                            reason: "completed"
-                        });
-                        return [ execute, createCancelHistory({
-                            id: call.id,
-                            selections: [ createOperationSelection({
-                                operation: call.operation,
-                                reason: "complete"
-                            }) ]
-                        }) ];
-                    }
-                    return [ execute ];
-                }));
+                        arguments: call.arguments
+                    });
+                }
+                ctx.dispatch(call);
+                const exec = await propagate(ctx, call, 0);
+                ctx.dispatch(exec);
+                executes.push(exec);
+                if (isAgenticaContext(ctx)) {
+                    cancelFunctionFromContext(ctx, {
+                        name: call.operation.name,
+                        reason: "completed"
+                    });
+                }
             }
         }
         if (choice.message.role === "assistant" && choice.message.content != null && choice.message.content.length !== 0) {
-            closures.push((async () => {
-                const value = createAssistantMessageHistory({
-                    text: choice.message.content
-                });
-                ctx.dispatch(creatAssistantEvent({
-                    get: () => value.text,
-                    done: () => true,
-                    stream: toAsyncGenerator(value.text),
-                    join: async () => Promise.resolve(value.text)
-                })).catch((() => {}));
-                return [ value ];
-            }));
+            const text = choice.message.content;
+            const event = creatAssistantMessageEvent({
+                get: () => text,
+                done: () => true,
+                stream: toAsyncGenerator(text),
+                join: async () => Promise.resolve(text)
+            });
+            ctx.dispatch(event);
         }
     }
-    return (await Promise.all(closures.map((async fn => fn())))).flat();
+    return executes;
 }
 
 async function propagate(ctx, call, retry) {
@@ -1500,7 +1539,7 @@ async function propagateHttp(props) {
             id: props.call.id,
             operation: props.operation,
             result: check
-        })).catch((() => {}));
+        }));
         if (props.retry++ < (props.ctx.config?.retry ?? AgenticaConstant.RETRY)) {
             const trial = await correct(props.ctx, props.call, props.retry, check.errors);
             if (trial !== null) {
@@ -1511,16 +1550,14 @@ async function propagateHttp(props) {
     try {
         const response = await executeHttpOperation(props.operation, props.call.arguments);
         const success = ((response.status === 400 || response.status === 404 || response.status === 422) && props.retry++ < (props.ctx.config?.retry ?? AgenticaConstant.RETRY) && typeof response.body) === false;
-        return (success === false ? await correct(props.ctx, props.call, props.retry, response.body) : null) ?? createExecuteHistory({
+        return (success === false ? await correct(props.ctx, props.call, props.retry, response.body) : null) ?? createExecuteEvent({
             operation: props.call.operation,
-            id: props.call.id,
             arguments: props.call.arguments,
             value: response
         });
     } catch (error) {
-        return createExecuteHistory({
+        return createExecuteEvent({
             operation: props.call.operation,
-            id: props.call.id,
             arguments: props.call.arguments,
             value: {
                 status: 500,
@@ -1542,9 +1579,8 @@ async function propagateClass(props) {
             id: props.call.id,
             operation: props.call.operation,
             result: check
-        })).catch((() => {}));
-        return (props.retry++ < (props.ctx.config?.retry ?? AgenticaConstant.RETRY) ? await correct(props.ctx, props.call, props.retry, check.errors) : null) ?? createExecuteHistory({
-            id: props.call.id,
+        }));
+        return (props.retry++ < (props.ctx.config?.retry ?? AgenticaConstant.RETRY) ? await correct(props.ctx, props.call, props.retry, check.errors) : null) ?? createExecuteEvent({
             operation: props.call.operation,
             arguments: props.call.arguments,
             value: {
@@ -1556,15 +1592,13 @@ async function propagateClass(props) {
     }
     try {
         const value = await executeClassOperation(props.operation, props.call.arguments);
-        return createExecuteHistory({
-            id: props.call.id,
+        return createExecuteEvent({
             operation: props.call.operation,
             arguments: props.call.arguments,
             value
         });
     } catch (error) {
-        return createExecuteHistory({
-            id: props.call.id,
+        return createExecuteEvent({
             operation: props.call.operation,
             arguments: props.call.arguments,
             value: error instanceof Error ? {
@@ -1579,15 +1613,13 @@ async function propagateClass(props) {
 async function propagateMcp(props) {
     try {
         const value = await executeMcpOperation(props.operation, props.call.arguments);
-        return createExecuteHistory({
-            id: props.call.id,
+        return createExecuteEvent({
             operation: props.call.operation,
             arguments: props.call.arguments,
             value
         });
     } catch (error) {
-        return createExecuteHistory({
-            id: props.call.id,
+        return createExecuteEvent({
             operation: props.call.operation,
             arguments: props.call.arguments,
             value: error instanceof Error ? {
@@ -1820,32 +1852,20 @@ async function cancel(ctx) {
     }
     const stacks = ctx.operations.divided.map((() => []));
     const events = [];
-    const prompts = await Promise.all(ctx.operations.divided.map((async (operations, i) => step$1({
+    await Promise.all(ctx.operations.divided.map((async (operations, i) => step$1({
         ...ctx,
         stack: stacks[i],
-        dispatch: async e => {
+        dispatch: e => {
             events.push(e);
+            return e;
         }
     }, operations, 0))));
-    if (stacks.every((s => s.length === 0))) {
-        return prompts[0];
-    } else if ((ctx.config?.eliticism ?? AgenticaConstant.ELITICISM) === true) {
+    if ((ctx.config?.eliticism ?? AgenticaConstant.ELITICISM) === true && stacks.some((s => s.length !== 0))) {
         return step$1(ctx, stacks.flat().map((s => ctx.operations.group.get(s.operation.controller.name).get(s.operation.function.name))), 0);
+    } else {
+        const cancelled = events.filter((e => e.type === "cancel"));
+        (cancelled.length !== 0 ? cancelled : events).forEach(ctx.dispatch);
     }
-    const collection = createCancelHistory({
-        id: v4(),
-        selections: []
-    });
-    for (const e of events) {
-        if (e.type === "select") {
-            collection.selections.push(e.selection);
-            cancelFunction(ctx, {
-                name: e.selection.operation.name,
-                reason: e.selection.reason
-            });
-        }
-    }
-    return [ collection ];
 }
 
 async function step$1(ctx, operations, retry, failures) {
@@ -1982,14 +2002,12 @@ async function step$1(ctx, operations, retry, failures) {
             return step$1(ctx, operations, retry, failures);
         }
     }
-    const prompts = [];
     for (const choice of completion.choices) {
         if (choice.message.tool_calls != null) {
             for (const tc of choice.message.tool_calls) {
                 if (tc.type !== "function") {
                     continue;
-                }
-                if (tc.function.name !== "cancelFunctions") {
+                } else if (tc.function.name !== "cancelFunctions") {
                     continue;
                 }
                 const input = (() => {
@@ -2004,23 +2022,12 @@ async function step$1(ctx, operations, retry, failures) {
                 if (input === null) {
                     continue;
                 }
-                const collection = createCancelHistory({
-                    id: tc.id,
-                    selections: []
-                });
                 for (const reference of input.functions) {
-                    const operation = cancelFunction(ctx, reference);
-                    if (operation !== null) {
-                        collection.selections.push(operation);
-                    }
-                }
-                if (collection.selections.length !== 0) {
-                    prompts.push(collection);
+                    cancelFunctionFromContext(ctx, reference);
                 }
             }
         }
     }
-    return prompts;
 }
 
 function emendMessages$1(failures) {
@@ -2167,7 +2174,7 @@ class MPSC {
 
 async function describe(ctx, histories) {
     if (histories.length === 0) {
-        return [];
+        return;
     }
     const completionStream = await ctx.request("describe", {
         messages: [ {
@@ -2179,7 +2186,7 @@ async function describe(ctx, histories) {
         } ]
     });
     const describeContext = [];
-    const completion = await StreamUtil.reduce(completionStream, (async (accPromise, chunk) => {
+    await StreamUtil.reduce(completionStream, (async (accPromise, chunk) => {
         const acc = await accPromise;
         const registerContext = choices => {
             for (const choice of choices) {
@@ -2201,7 +2208,7 @@ async function describe(ctx, histories) {
                     mpsc
                 };
                 mpsc.produce(choice.delta.content);
-                ctx.dispatch(createDescribeEvent({
+                const event = createDescribeEvent({
                     executes: histories,
                     stream: streamDefaultReaderToAsyncGenerator(mpsc.consumer.getReader()),
                     done: () => mpsc.done(),
@@ -2210,7 +2217,8 @@ async function describe(ctx, histories) {
                         await mpsc.waitClosed();
                         return describeContext[choice.index].content;
                     }
-                })).catch((() => {}));
+                });
+                ctx.dispatch(event);
             }
         };
         if (acc.object === "chat.completion.chunk") {
@@ -2220,14 +2228,6 @@ async function describe(ctx, histories) {
         registerContext(chunk.choices);
         return ChatGptCompletionMessageUtil.accumulate(acc, chunk);
     }));
-    if (completion == null) {
-        throw new Error("No completion received");
-    }
-    const descriptions = completion.choices.map((choice => choice.message.role === "assistant" ? choice.message.content : null)).filter((str => str !== null)).map((content => createDescribeHistory({
-        executes: histories,
-        text: content
-    })));
-    return descriptions;
 }
 
 const ChatGptDescribeFunctionAgent = {
@@ -3918,7 +3918,7 @@ async function initialize(ctx) {
                     mpsc
                 };
                 mpsc.produce(choice.delta.content);
-                ctx.dispatch(creatAssistantEvent({
+                const event = creatAssistantMessageEvent({
                     stream: streamDefaultReaderToAsyncGenerator(mpsc.consumer.getReader()),
                     done: () => mpsc.done(),
                     get: () => textContext[choice.index].content,
@@ -3926,7 +3926,8 @@ async function initialize(ctx) {
                         await mpsc.waitClosed();
                         return textContext[choice.index].content;
                     }
-                })).catch((() => {}));
+                });
+                ctx.dispatch(event);
             }
         };
         if (acc.object === "chat.completion.chunk") {
@@ -3939,34 +3940,25 @@ async function initialize(ctx) {
     if (completion === null) {
         throw new Error("No completion received");
     }
-    const prompts = [];
-    for (const choice of completion.choices) {
-        if (choice.message.role === "assistant" && choice.message.content != null && choice.message.content.length !== 0) {
-            prompts.push(createAssistantMessageHistory({
-                text: choice.message.content
-            }));
-        }
-    }
     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();
     }
-    return prompts;
 }
 
-async function selectFunction(ctx, reference) {
+function selectFunctionFromContext(ctx, reference) {
     const operation = ctx.operations.flat.get(reference.name);
     if (operation === undefined) {
-        return null;
+        return;
     }
     const selection = createOperationSelection({
         operation,
         reason: reference.reason
     });
     ctx.stack.push(selection);
-    ctx.dispatch(createSelectEvent({
+    const event = createSelectEvent({
         selection
-    })).catch((() => {}));
-    return operation;
+    });
+    ctx.dispatch(event);
 }
 
 const CONTAINER = {
@@ -4074,32 +4066,20 @@ async function select(ctx) {
     }
     const stacks = ctx.operations.divided.map((() => []));
     const events = [];
-    const prompts = await Promise.all(ctx.operations.divided.map((async (operations, i) => step({
+    await Promise.all(ctx.operations.divided.map((async (operations, i) => step({
         ...ctx,
         stack: stacks[i],
-        dispatch: async e => {
+        dispatch: e => {
             events.push(e);
+            return e;
         }
     }, operations, 0))));
-    if (stacks.every((s => s.length === 0))) {
-        return prompts[0];
-    } else if ((ctx.config?.eliticism ?? AgenticaConstant.ELITICISM) === true) {
+    if ((ctx.config?.eliticism ?? AgenticaConstant.ELITICISM) === true && stacks.some((s => s.length !== 0))) {
         return step(ctx, stacks.flat().map((s => ctx.operations.group.get(s.operation.controller.name).get(s.operation.function.name))), 0);
+    } else {
+        const selected = events.filter((e => e.type === "select"));
+        (selected.length !== 0 ? selected : events).forEach(ctx.dispatch);
     }
-    const collection = createSelectHistory({
-        id: v4(),
-        selections: []
-    });
-    for (const e of events) {
-        if (e.type === "select") {
-            collection.selections.push(e.selection);
-            await selectFunction(ctx, {
-                name: e.selection.operation.name,
-                reason: e.selection.reason
-            });
-        }
-    }
-    return [ collection ];
 }
 
 async function step(ctx, operations, retry, failures) {
@@ -4236,14 +4216,12 @@ async function step(ctx, operations, retry, failures) {
             return step(ctx, operations, retry, failures);
         }
     }
-    const prompts = [];
     for (const choice of completion.choices) {
         if (choice.message.tool_calls != null) {
             for (const tc of choice.message.tool_calls) {
                 if (tc.type !== "function") {
                     continue;
-                }
-                if (tc.function.name !== "selectFunctions") {
+                } else if (tc.function.name !== "selectFunctions") {
                     continue;
                 }
                 const input = (() => {
@@ -4258,39 +4236,21 @@ async function step(ctx, operations, retry, failures) {
                 if (input === null) {
                     continue;
                 }
-                const collection = createSelectHistory({
-                    id: tc.id,
-                    selections: []
-                });
                 for (const reference of input.functions) {
-                    const operation = await selectFunction(ctx, reference);
-                    if (operation === null) {
-                        continue;
-                    }
-                    collection.selections.push(createOperationSelection({
-                        operation,
-                        reason: reference.reason
-                    }));
-                }
-                if (collection.selections.length !== 0) {
-                    prompts.push(collection);
+                    selectFunctionFromContext(ctx, reference);
                 }
             }
         }
         if (choice.message.role === "assistant" && choice.message.content != null && choice.message.content.length !== 0) {
-            const text = createAssistantMessageHistory({
-                text: choice.message.content
-            });
-            prompts.push(text);
-            ctx.dispatch(creatAssistantEvent({
-                stream: toAsyncGenerator(text.text),
-                join: async () => Promise.resolve(text.text),
+            const event = creatAssistantMessageEvent({
+                stream: toAsyncGenerator(choice.message.content),
+                join: async () => Promise.resolve(choice.message.content),
                 done: () => true,
-                get: () => text.text
-            })).catch((() => {}));
+                get: () => choice.message.content
+            });
+            ctx.dispatch(event);
         }
     }
-    return prompts;
 }
 
 function emendMessages(failures) {
@@ -4316,36 +4276,32 @@ function emendMessages(failures) {
 
 function execute(executor) {
     return async ctx => {
-        const histories = [];
         if (ctx.ready() === false) {
             if (executor?.initialize !== true && typeof executor?.initialize !== "function") {
                 await ctx.initialize();
             } else {
-                histories.push(...await (typeof executor?.initialize === "function" ? executor.initialize : initialize)(ctx));
+                await (typeof executor?.initialize === "function" ? executor.initialize : initialize)(ctx);
                 if (ctx.ready() === false) {
-                    return histories;
+                    return;
                 }
             }
         }
         if (ctx.stack.length !== 0) {
-            histories.push(...await (executor?.cancel ?? cancel)(ctx));
+            await (executor?.cancel ?? cancel)(ctx);
         }
-        histories.push(...await (executor?.select ?? select)(ctx));
+        await (executor?.select ?? select)(ctx);
         if (ctx.stack.length === 0) {
-            return histories;
+            return;
         }
         while (true) {
-            const prompts = await (executor?.call ?? call)(ctx, ctx.stack.map((s => s.operation)));
-            histories.push(...prompts);
-            const executes = prompts.filter((prompt => prompt.type === "execute"));
+            const executes = await (executor?.call ?? call)(ctx, ctx.stack.map((s => s.operation)));
             if (executor?.describe !== null && executor?.describe !== false) {
-                histories.push(...await (typeof executor?.describe === "function" ? executor.describe : describe)(ctx, executes));
+                await (typeof executor?.describe === "function" ? executor.describe : describe)(ctx, executes);
             }
             if (executes.length === 0 || ctx.stack.length === 0) {
                 break;
             }
         }
-        return histories;
     };
 }
 
@@ -4399,32 +4355,35 @@ function transformUserMessage(props) {
 function transformSelect(props) {
     return createSelectHistory({
         id: props.history.id,
-        selections: props.history.selections.map((select => createOperationSelection({
+        created_at: props.history.created_at,
+        selection: createOperationSelection({
             operation: findOperation({
                 operations: props.operations,
-                input: select.operation
+                input: props.history.selection.operation
             }),
-            reason: select.reason
-        })))
+            reason: props.history.selection.reason
+        })
     });
 }
 
 function transformCancel(props) {
     return createCancelHistory({
         id: props.history.id,
-        selections: props.history.selections.map((select => createOperationSelection({
+        created_at: props.history.created_at,
+        selection: createOperationSelection({
             operation: findOperation({
                 operations: props.operations,
-                input: select.operation
+                input: props.history.selection.operation
             }),
-            reason: select.reason
-        })))
+            reason: props.history.selection.reason
+        })
     });
 }
 
 function transformExecute(props) {
     return createExecuteHistory({
         id: props.history.id,
+        created_at: props.history.created_at,
         operation: findOperation({
             operations: props.operations,
             input: props.history.operation
@@ -4436,6 +4395,8 @@ function transformExecute(props) {
 
 function transformDescribe(props) {
     return createDescribeHistory({
+        id: props.history.id,
+        created_at: props.history.created_at,
         text: props.history.text,
         executes: props.history.executes.map((next => transformExecute({
             operations: props.operations,
@@ -4465,9 +4426,10 @@ class Agentica {
             operations: this.operations_.group,
             history: input
         })));
+        this.executor_ = typeof props.config?.executor === "function" ? props.config.executor : execute(props.config?.executor ?? null);
+        this.semaphore_ = props.vendor.semaphore != null ? typeof props.vendor.semaphore === "object" ? props.vendor.semaphore : new Semaphore(props.vendor.semaphore) : null;
         this.token_usage_ = this.props.tokenUsage !== undefined ? this.props.tokenUsage instanceof AgenticaTokenUsage ? this.props.tokenUsage : new AgenticaTokenUsage(this.props.tokenUsage) : AgenticaTokenUsage.zero();
         this.ready_ = false;
-        this.executor_ = typeof props.config?.executor === "function" ? props.config.executor : execute(props.config?.executor ?? null);
     }
     clone() {
         return new Agentica({
@@ -4476,22 +4438,36 @@ class Agentica {
         });
     }
     async conversate(content, options = {}) {
-        const prompt = createUserMessageHistory({
+        const historyGetters = [];
+        const dispatch = event => {
+            this.dispatch(event).catch((() => {}));
+            if ("toHistory" in event) {
+                if ("join" in event) {
+                    historyGetters.push((async () => {
+                        await event.join();
+                        return event.toHistory();
+                    }));
+                } else {
+                    historyGetters.push((async () => event.toHistory()));
+                }
+            }
+        };
+        const prompt = createUserMessageEvent({
             contents: Array.isArray(content) ? content : typeof content === "string" ? [ {
                 type: "text",
                 text: content
             } ] : [ content ]
         });
-        this.dispatch(createUserMessageEvent({
-            contents: prompt.contents
-        })).catch((() => {}));
-        const newbie = await this.executor_(this.getContext({
-            prompt,
+        dispatch(prompt);
+        await this.executor_(this.getContext({
+            dispatch,
+            prompt: prompt.toHistory(),
             abortSignal: options.abortSignal,
             usage: this.token_usage_
         }));
-        this.histories_.push(prompt, ...newbie);
-        return [ prompt, ...newbie ];
+        const completed = await Promise.all(historyGetters.map((async h => h())));
+        this.histories_.push(...completed);
+        return completed;
     }
     getConfig() {
         return this.props.config;
@@ -4512,7 +4488,58 @@ class Agentica {
         return this.token_usage_;
     }
     getContext(props) {
-        const dispatch = async event => this.dispatch(event);
+        const request = async (source, body) => {
+            const event = createRequestEvent({
+                source,
+                body: {
+                    ...body,
+                    model: this.props.vendor.model,
+                    stream: true,
+                    stream_options: {
+                        include_usage: true
+                    }
+                },
+                options: {
+                    ...this.props.vendor.options,
+                    signal: props.abortSignal
+                }
+            });
+            props.dispatch(event);
+            const completion = await this.props.vendor.api.chat.completions.create(event.body, event.options);
+            const [streamForEvent, temporaryStream] = StreamUtil.transform(completion.toReadableStream(), (value => ChatGptCompletionMessageUtil.transformCompletionChunk(value))).tee();
+            const [streamForAggregate, streamForReturn] = temporaryStream.tee();
+            (async () => {
+                const reader = streamForAggregate.getReader();
+                while (true) {
+                    const chunk = await reader.read();
+                    if (chunk.done) {
+                        break;
+                    }
+                    if (chunk.value.usage != null) {
+                        AgenticaTokenUsageAggregator.aggregate({
+                            kind: source,
+                            completionUsage: chunk.value.usage,
+                            usage: props.usage
+                        });
+                    }
+                }
+            })().catch((() => {}));
+            const [streamForStream, streamForJoin] = streamForEvent.tee();
+            props.dispatch({
+                id: v4(),
+                type: "response",
+                source,
+                stream: streamDefaultReaderToAsyncGenerator(streamForStream.getReader()),
+                body: event.body,
+                options: event.options,
+                join: async () => {
+                    const chunks = await StreamUtil.readAll(streamForJoin);
+                    return ChatGptCompletionMessageUtil.merge(chunks);
+                },
+                created_at: (new Date).toISOString()
+            });
+            return streamForReturn;
+        };
         return {
             operations: this.operations_,
             config: this.props.config,
@@ -4521,60 +4548,18 @@ class Agentica {
             ready: () => this.ready_,
             prompt: props.prompt,
             abortSignal: props.abortSignal,
-            dispatch: async event => this.dispatch(event),
-            request: async (source, body) => {
-                const event = createRequestEvent({
-                    source,
-                    body: {
-                        ...body,
-                        model: this.props.vendor.model,
-                        stream: true,
-                        stream_options: {
-                            include_usage: true
-                        }
-                    },
-                    options: {
-                        ...this.props.vendor.options,
-                        signal: props.abortSignal
-                    }
-                });
-                await dispatch(event);
-                const completion = await this.props.vendor.api.chat.completions.create(event.body, event.options);
-                const [streamForEvent, temporaryStream] = StreamUtil.transform(completion.toReadableStream(), (value => ChatGptCompletionMessageUtil.transformCompletionChunk(value))).tee();
-                const [streamForAggregate, streamForReturn] = temporaryStream.tee();
-                (async () => {
-                    const reader = streamForAggregate.getReader();
-                    while (true) {
-                        const chunk = await reader.read();
-                        if (chunk.done) {
-                            break;
-                        }
-                        if (chunk.value.usage != null) {
-                            AgenticaTokenUsageAggregator.aggregate({
-                                kind: source,
-                                completionUsage: chunk.value.usage,
-                                usage: props.usage
-                            });
-                        }
-                    }
-                })().catch((() => {}));
-                const [streamForStream, streamForJoin] = streamForEvent.tee();
-                await dispatch({
-                    type: "response",
-                    source,
-                    stream: streamDefaultReaderToAsyncGenerator(streamForStream.getReader()),
-                    body: event.body,
-                    options: event.options,
-                    join: async () => {
-                        const chunks = await StreamUtil.readAll(streamForJoin);
-                        return ChatGptCompletionMessageUtil.merge(chunks);
-                    }
-                });
-                return streamForReturn;
+            dispatch: props.dispatch,
+            request: this.semaphore_ === null ? request : async (source, body) => {
+                await this.semaphore_.acquire();
+                try {
+                    return await request(source, body);
+                } finally {
+                    void this.semaphore_.release().catch((() => {}));
+                }
             },
             initialize: async () => {
                 this.ready_ = true;
-                await dispatch(createInitializeEvent());
+                props.dispatch(createInitializeEvent());
             }
         };
     }
@@ -4604,6 +4589,31 @@ class Agentica {
     }
 }
 
+var index$2 = Object.freeze({
+    __proto__: null,
+    creatAssistantMessageEvent,
+    createAssistantMessageHistory,
+    createCallEvent,
+    createCancelEvent,
+    createCancelHistory,
+    createDescribeEvent,
+    createDescribeHistory,
+    createExecuteEvent,
+    createExecuteHistory,
+    createInitializeEvent,
+    createOperationSelection,
+    createRequestEvent,
+    createResponseEvent,
+    createSelectEvent,
+    createSelectHistory,
+    createSystemMessageHistory,
+    createUserMessageEvent,
+    createUserMessageHistory,
+    createValidateEvent,
+    decodeHistory,
+    decodeUserMessageContent
+});
+
 function assertHttpController(props) {
     const document = OpenApi.convert((() => {
         const _io0 = input => null !== input.swagger && undefined !== input.swagger && ("2.0" === input.swagger || "string" === typeof input.swagger && RegExp(/^2\.0\.[+-]?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?$/).test(input.swagger)) && (undefined === input.info || "object" === typeof input.info && null !== input.info && _io1(input.info)) && (undefined === input.host || "string" === typeof input.host) && (undefined === input.basePath || "string" === typeof input.basePath) && (undefined === input.consumes || Array.isArray(input.consumes) && input.consumes.every((elem => "string" === typeof elem))) && (undefined === input.produces || Array.isArray(input.produces) && input.produces.every((elem => "string" === typeof elem))) && (undefined === input.definitions || "object" === typeof input.definitions && null !== input.definitions && false === Array.isArray(input.definitions) && _io4(input.definitions)) && (undefined === input.parameters || "object" === typeof input.parameters && null !== input.parameters && false === Array.isArray(input.parameters) && _io16(input.parameters)) && (undefined === input.responses || "object" === typeof input.responses && null !== input.responses && false === Array.isArray(input.responses) && _io29(input.responses)) && (undefined === input.securityDefinitions || "object" === typeof input.securityDefinitions && null !== input.securityDefinitions && false === Array.isArray(input.securityDefinitions) && _io31(input.securityDefinitions)) && (undefined === input.security || Array.isArray(input.security) && input.security.every((elem => "object" === typeof elem && null !== elem && false === Array.isArray(elem) && _io39(elem)))) && (undefined === input.paths || "object" === typeof input.paths && null !== input.paths && false === Array.isArray(input.paths) && _io40(input.paths)) && (undefined === input.tags || Array.isArray(input.tags) && input.tags.every((elem => "object" === typeof elem && null !== elem && _io47(elem))));
@@ -43280,6 +43290,7 @@ class MicroAgentica {
         })));
         this.token_usage_ = this.props.tokenUsage !== undefined ? this.props.tokenUsage instanceof AgenticaTokenUsage ? this.props.tokenUsage : new AgenticaTokenUsage(this.props.tokenUsage) : AgenticaTokenUsage.zero();
         this.listeners_ = new Map;
+        this.semaphore_ = props.vendor.semaphore != null ? typeof props.vendor.semaphore === "object" ? props.vendor.semaphore : new Semaphore(props.vendor.semaphore) : null;
     }
     clone() {
         return new MicroAgentica({
@@ -43288,26 +43299,39 @@ class MicroAgentica {
         });
     }
     async conversate(content) {
-        const talk = createUserMessageHistory({
+        const histories = [];
+        const dispatch = event => {
+            this.dispatch(event).catch((() => {}));
+            if ("toHistory" in event) {
+                if ("join" in event) {
+                    histories.push((async () => {
+                        await event.join();
+                        return event.toHistory();
+                    }));
+                } else {
+                    histories.push((async () => event.toHistory()));
+                }
+            }
+        };
+        const prompt = createUserMessageEvent({
             contents: Array.isArray(content) ? content : typeof content === "string" ? [ {
                 type: "text",
                 text: content
             } ] : [ content ]
         });
-        this.dispatch(createUserMessageEvent({
-            contents: talk.contents
-        })).catch((() => {}));
+        dispatch(prompt);
         const ctx = this.getContext({
-            prompt: talk,
+            prompt,
+            dispatch,
             usage: this.token_usage_
         });
-        const histories = await call(ctx, this.operations_.array);
-        const executes = histories.filter((p => p.type === "execute"));
-        if (executes.length && ctx.config?.executor?.describe !== null && ctx.config?.executor?.describe !== false) {
-            histories.push(...await describe(ctx, executes));
+        const executes = await call(ctx, this.operations_.array);
+        if (executes.length) {
+            await describe(ctx, executes);
         }
-        this.histories_.push(talk, ...histories);
-        return histories;
+        const completed = await Promise.all(histories.map((async h => h())));
+        this.histories_.push(...completed);
+        return completed;
     }
     getConfig() {
         return this.props.config;
@@ -43328,59 +43352,68 @@ class MicroAgentica {
         return this.token_usage_;
     }
     getContext(props) {
-        const dispatch = this.dispatch.bind(this);
+        const request = async (source, body) => {
+            const event = createRequestEvent({
+                source,
+                body: {
+                    ...body,
+                    model: this.props.vendor.model,
+                    stream: true,
+                    stream_options: {
+                        include_usage: true
+                    }
+                },
+                options: this.props.vendor.options
+            });
+            props.dispatch(event);
+            const completion = await this.props.vendor.api.chat.completions.create(event.body, event.options);
+            const [streamForEvent, temporaryStream] = StreamUtil.transform(completion.toReadableStream(), (value => ChatGptCompletionMessageUtil.transformCompletionChunk(value))).tee();
+            const [streamForAggregate, streamForReturn] = temporaryStream.tee();
+            void (async () => {
+                const reader = streamForAggregate.getReader();
+                while (true) {
+                    const chunk = await reader.read();
+                    if (chunk.done) {
+                        break;
+                    }
+                    if (chunk.value.usage != null) {
+                        AgenticaTokenUsageAggregator.aggregate({
+                            kind: source,
+                            completionUsage: chunk.value.usage,
+                            usage: props.usage
+                        });
+                    }
+                }
+            })().catch((() => {}));
+            const [streamForStream, streamForJoin] = streamForEvent.tee();
+            props.dispatch({
+                id: v4(),
+                type: "response",
+                source,
+                stream: streamDefaultReaderToAsyncGenerator(streamForStream.getReader()),
+                body: event.body,
+                options: event.options,
+                join: async () => {
+                    const chunks = await StreamUtil.readAll(streamForJoin);
+                    return ChatGptCompletionMessageUtil.merge(chunks);
+                },
+                created_at: (new Date).toISOString()
+            });
+            return streamForReturn;
+        };
         return {
             operations: this.operations_,
             config: this.props.config,
             histories: this.histories_,
             prompt: props.prompt,
-            dispatch,
-            request: async (source, body) => {
-                const event = createRequestEvent({
-                    source,
-                    body: {
-                        ...body,
-                        model: this.props.vendor.model,
-                        stream: true,
-                        stream_options: {
-                            include_usage: true
-                        }
-                    },
-                    options: this.props.vendor.options
-                });
-                await dispatch(event);
-                const completion = await this.props.vendor.api.chat.completions.create(event.body, event.options);
-                const [streamForEvent, temporaryStream] = StreamUtil.transform(completion.toReadableStream(), (value => ChatGptCompletionMessageUtil.transformCompletionChunk(value))).tee();
-                const [streamForAggregate, streamForReturn] = temporaryStream.tee();
-                void (async () => {
-                    const reader = streamForAggregate.getReader();
-                    while (true) {
-                        const chunk = await reader.read();
-                        if (chunk.done) {
-                            break;
-                        }
-                        if (chunk.value.usage != null) {
-                            AgenticaTokenUsageAggregator.aggregate({
-                                kind: source,
-                                completionUsage: chunk.value.usage,
-                                usage: props.usage
-                            });
-                        }
-                    }
-                })();
-                const [streamForStream, streamForJoin] = streamForEvent.tee();
-                await dispatch({
-                    type: "response",
-                    source,
-                    stream: streamDefaultReaderToAsyncGenerator(streamForStream.getReader()),
-                    body: event.body,
-                    options: event.options,
-                    join: async () => {
-                        const chunks = await StreamUtil.readAll(streamForJoin);
-                        return ChatGptCompletionMessageUtil.merge(chunks);
-                    }
-                });
-                return streamForReturn;
+            dispatch: props.dispatch,
+            request: this.semaphore_ === null ? request : async (source, body) => {
+                await this.semaphore_.acquire();
+                try {
+                    return await request(source, body);
+                } finally {
+                    void this.semaphore_.release().catch((() => {}));
+                }
             }
         };
     }