@agentica/core 0.44.1 → 0.45.0-dev.20260426

package/lib/index.mjs

@@ -287,11 +287,49 @@ const AgenticaOperationComposer = {
     compose
 };
 
+function isRecord(value) {
+    return value != null && typeof value === "object" && Array.isArray(value) === false;
+}
+
+function collect(source) {
+    if (isRecord(source) === false) {
+        return undefined;
+    }
+    const output = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (key.startsWith("reasoning") && value !== undefined) {
+            output[key] = value;
+        }
+    }
+    return Object.keys(output).length === 0 ? undefined : output;
+}
+
+function assign(message, payload) {
+    const collected = collect(payload);
+    if (collected === undefined) {
+        return message;
+    }
+    return {
+        ...message,
+        ...collected
+    };
+}
+
+function assignFrom(message, source) {
+    return assign(message, collect(source));
+}
+
+const ChatGptAssistantMessageUtil = {
+    assign,
+    assignFrom,
+    collect
+};
+
 function decodeHistory(history) {
     if (history.type === "describe") {
         return [];
     } else if (history.type === "select" || history.type === "cancel") {
-        return [ {
+        return [ ChatGptAssistantMessageUtil.assign({
             role: "assistant",
             tool_calls: [ {
                 type: "function",
@@ -306,13 +344,13 @@ function decodeHistory(history) {
                     })
                 }
             } ]
-        }, {
+        }, history.assistant), {
             role: "tool",
             tool_call_id: history.id,
             content: ""
         } ];
     } else if (history.type === "execute") {
-        return [ {
+        return [ ChatGptAssistantMessageUtil.assign({
             role: "assistant",
             tool_calls: [ {
                 type: "function",
@@ -322,7 +360,7 @@ function decodeHistory(history) {
                     arguments: JSON.stringify(history.arguments)
                 }
             } ]
-        }, {
+        }, history.assistant), {
             role: "tool",
             tool_call_id: history.id,
             content: JSON.stringify({
@@ -467,11 +505,13 @@ function createSelectHistory(props) {
         id: props.id,
         selection: props.selection,
         created_at: props.created_at,
+        assistant: props.assistant,
         toJSON: () => ({
             type: "select",
             id: props.id,
             created_at: props.created_at,
-            selection: props.selection.toJSON()
+            selection: props.selection.toJSON(),
+            assistant: props.assistant
         })
     };
 }
@@ -482,11 +522,13 @@ function createCancelHistory(props) {
         id: props.id,
         created_at: props.created_at,
         selection: props.selection,
+        assistant: props.assistant,
         toJSON: () => ({
             type: "cancel",
             id: props.id,
             created_at: props.created_at,
-            selection: props.selection.toJSON()
+            selection: props.selection.toJSON(),
+            assistant: props.assistant
         })
     };
 }
@@ -501,6 +543,7 @@ function createExecuteHistory(props) {
         arguments: props.arguments,
         value: props.value,
         success: props.success,
+        assistant: props.assistant,
         toJSON: () => ({
             type: "execute",
             id: props.id,
@@ -509,7 +552,8 @@ function createExecuteHistory(props) {
             operation: props.operation.toJSON(),
             arguments: props.arguments,
             value: props.value,
-            success: props.success
+            success: props.success,
+            assistant: props.assistant
         })
     };
 }
@@ -536,16 +580,19 @@ function createSelectEvent(props) {
         id,
         created_at,
         selection: props.selection,
+        assistant: props.assistant,
         toJSON: () => ({
             type: "select",
             id,
             created_at,
-            selection: props.selection.toJSON()
+            selection: props.selection.toJSON(),
+            assistant: props.assistant
         }),
         toHistory: () => createSelectHistory({
             id,
             created_at,
-            selection: props.selection
+            selection: props.selection,
+            assistant: props.assistant
         })
     };
 }
@@ -558,11 +605,13 @@ function createCancelEvent(props) {
         id,
         created_at,
         selection: props.selection,
+        assistant: props.assistant,
         toJSON: () => ({
             type: "cancel",
             id,
             created_at,
-            selection: props.selection.toJSON()
+            selection: props.selection.toJSON(),
+            assistant: props.assistant
         })
     };
 }
@@ -575,12 +624,14 @@ function createCallEvent(props) {
         created_at,
         operation: props.operation,
         arguments: props.arguments,
+        assistant: props.assistant,
         toJSON: () => ({
             type: "call",
             id: props.id,
             created_at,
             operation: props.operation.toJSON(),
-            arguments: props.arguments
+            arguments: props.arguments,
+            assistant: props.assistant
         })
     };
 }
@@ -635,6 +686,7 @@ function createExecuteEvent(props) {
         arguments: props.arguments,
         value: props.value,
         success: props.success,
+        assistant: props.assistant,
         toJSON: () => ({
             type: "execute",
             id,
@@ -644,7 +696,8 @@ function createExecuteEvent(props) {
             operation: props.operation.toJSON(),
             arguments: props.arguments,
             value: props.value,
-            success: props.success
+            success: props.success,
+            assistant: props.assistant
         }),
         toHistory: () => createExecuteHistory({
             id,
@@ -996,7 +1049,7 @@ function accumulate(origin, chunk) {
             index: choice.index,
             finish_reason: choice.finish_reason ?? null,
             logprobs: choice.logprobs ?? null,
-            message: {
+            message: ChatGptAssistantMessageUtil.assignFrom({
                 tool_calls: choice.delta.tool_calls !== undefined ? choice.delta.tool_calls.reduce((acc, cur) => {
                     acc[cur.index] = {
                         id: cur.id ?? "",
@@ -1010,11 +1063,8 @@ function accumulate(origin, chunk) {
                 }, []) : undefined,
                 content: choice.delta.content ?? null,
                 refusal: choice.delta.refusal ?? null,
-                role: "assistant",
-                ...{
-                    reasoning: choice.delta.reasoning ?? null
-                }
-            }
+                role: "assistant"
+            }, choice.delta)
         };
     });
     const usage = (() => {
@@ -1080,13 +1130,7 @@ function mergeChoice(acc, cur) {
             acc.message.refusal += cur.delta.refusal;
         }
     }
-    if (cur.delta.reasoning != null) {
-        if (acc.message.reasoning == null) {
-            acc.message.reasoning = cur.delta.reasoning;
-        } else {
-            acc.message.reasoning += cur.delta.reasoning;
-        }
-    }
+    mergeAssistantMessagePayload(acc.message, cur.delta);
     if (cur.delta.tool_calls != null) {
         (_a = acc.message).tool_calls ?? (_a.tool_calls = []);
         const toolCalls = acc.message.tool_calls;
@@ -1118,6 +1162,23 @@ function mergeToolCalls(acc, cur) {
     return acc;
 }
 
+function mergeAssistantMessagePayload(message, delta) {
+    const target = message;
+    const source = delta;
+    for (const [key, value] of Object.entries(source)) {
+        if (key.startsWith("reasoning") === false || value === undefined) {
+            continue;
+        }
+        if (typeof value === "string") {
+            target[key] = typeof target[key] === "string" ? `${target[key]}${value}` : value;
+        } else if (Array.isArray(value)) {
+            target[key] = [ ...Array.isArray(target[key]) ? target[key] : [], ...value ];
+        } else {
+            target[key] = value;
+        }
+    }
+}
+
 const ChatGptCompletionMessageUtil = {
     transformCompletionChunk,
     accumulate,
@@ -1412,7 +1473,7 @@ function createOperationSelection(props) {
     };
 }
 
-function cancelFunctionFromContext(ctx, reference) {
+function cancelFunctionFromContext(ctx, reference, reasoning) {
     const index = ctx.stack.findIndex(item => item.operation.name === reference.name);
     if (index === -1) {
         return;
@@ -1423,7 +1484,8 @@ function cancelFunctionFromContext(ctx, reference) {
         selection: createOperationSelection({
             operation: item.operation,
             reason: reference.reason
-        })
+        }),
+        assistant: reasoning?.assistant
     });
     void ctx.dispatch(event).catch(() => {});
 }
@@ -1491,13 +1553,17 @@ async function call(ctx, operations) {
     const executes = [];
     const retry = ctx.config?.retry ?? AgenticaConstant.RETRY;
     for (const choice of completion.choices ?? []) {
+        const assistant = ChatGptAssistantMessageUtil.collect(choice.message);
+        const reasoning = assistant === undefined ? undefined : {
+            assistant
+        };
         for (const tc of choice.message.tool_calls ?? []) {
             if (tc.type === "function") {
                 const operation = operations.find(s => s.name === tc.function.name);
                 if (operation === undefined) {
                     continue;
                 }
-                const event = await predicate(ctx, operation, tc, [], retry);
+                const event = await predicate(ctx, operation, tc, reasoning, [], retry);
                 await ctx.dispatch(event);
                 executes.push(event);
                 if (isAgenticaContext(ctx)) {
@@ -1512,11 +1578,11 @@ async function call(ctx, operations) {
     return executes;
 }
 
-async function predicate(ctx, operation, toolCall, previousValidationErrors, life) {
-    const call = parseArguments(operation, toolCall, life);
+async function predicate(ctx, operation, toolCall, reasoning, previousValidationErrors, life) {
+    const call = parseArguments(operation, toolCall, reasoning, life);
     await ctx.dispatch(call);
     if (call.type === "jsonParseError") {
-        return correctJsonError(ctx, toolCall, call, previousValidationErrors, life - 1);
+        return correctJsonError(ctx, toolCall, reasoning, call, previousValidationErrors, life - 1);
     }
     const check = operation.function.validate(call.arguments);
     if (check.success === false) {
@@ -1542,12 +1608,14 @@ async function correctTypeError(ctx, callEvent, validateEvent, previousValidatio
                 arguments: callEvent.arguments,
                 errors: validateEvent.result.errors
             }),
-            success: false
+            success: false,
+            assistant: callEvent.assistant
         }),
         operation: callEvent.operation,
         toolCall: {
             id: callEvent.id,
             arguments: JSON.stringify(callEvent.arguments),
+            assistant: callEvent.assistant,
             result: [ "🚨 VALIDATION FAILURE: Your function arguments do not conform to the required schema.", "", "The validation errors below represent computed absolute truth from rigorous type validation.", "Each error is marked with ❌ comments showing the exact location, expected type, and actual value.", "", "You must fix ALL errors to achieve 100% schema compliance.", "", LlmJson.stringify(validateEvent.result) ].join("\n")
         },
         systemPrompt: ctx.config?.systemPrompt?.validate?.(previousValidationErrors.slice(0, -1)) ?? [ AgenticaSystemPrompt.VALIDATE, ...previousValidationErrors.length > 1 ? [ "", AgenticaSystemPrompt.VALIDATE_REPEATED.replace("${{HISTORICAL_ERRORS}}", previousValidationErrors.slice(0, -1).map((ve, i) => [ `### ${i + 1}. Previous Validation Error`, "", LlmJson.stringify(ve.result) ].join("\n")).join("\n\n")) ] : [] ].join("\n"),
@@ -1556,19 +1624,21 @@ async function correctTypeError(ctx, callEvent, validateEvent, previousValidatio
     });
 }
 
-async function correctJsonError(ctx, toolCall, parseErrorEvent, previousValidationErrors, life) {
+async function correctJsonError(ctx, toolCall, reasoning, parseErrorEvent, previousValidationErrors, life) {
     return correctError(ctx, {
         giveUp: () => createExecuteEvent({
             call_id: toolCall.id,
             operation: parseErrorEvent.operation,
             arguments: {},
             value: new AgenticaJsonParseError(parseErrorEvent.failure),
-            success: false
+            success: false,
+            assistant: reasoning?.assistant
         }),
         operation: parseErrorEvent.operation,
         toolCall: {
             id: parseErrorEvent.id,
             arguments: parseErrorEvent.failure.input,
+            assistant: reasoning?.assistant,
             result: dedent`
         Invalid JSON format.
 
@@ -1593,7 +1663,7 @@ async function correctJsonError(ctx, toolCall, parseErrorEvent, previousValidati
     });
 }
 
-function parseArguments(operation, toolCall, life) {
+function parseArguments(operation, toolCall, reasoning, life) {
     const result = operation.function.parse(toolCall.function.arguments);
     if (result.success === false) {
         return createJsonParseErrorEvent({
@@ -1606,7 +1676,8 @@ function parseArguments(operation, toolCall, life) {
     return createCallEvent({
         id: toolCall.id,
         operation,
-        arguments: result.data
+        arguments: result.data,
+        assistant: reasoning?.assistant
     });
 }
 
@@ -1621,7 +1692,7 @@ async function correctError(ctx, props) {
         }, {
             role: "system",
             content: ctx.config?.systemPrompt?.execute?.(ctx.histories) ?? AgenticaSystemPrompt.EXECUTE
-        }, {
+        }, ChatGptAssistantMessageUtil.assign({
             role: "assistant",
             tool_calls: [ {
                 type: "function",
@@ -1631,7 +1702,7 @@ async function correctError(ctx, props) {
                     arguments: props.toolCall.arguments
                 }
             } ]
-        }, {
+        }, props.toolCall.assistant), {
             role: "tool",
             content: props.toolCall.result,
             tool_call_id: props.toolCall.id
@@ -1658,14 +1729,18 @@ async function correctError(ctx, props) {
         }
         return ChatGptCompletionMessageUtil.merge(await StreamUtil.readAll(result.value));
     })();
-    const toolCall = completion.choices?.[0]?.message.tool_calls?.filter(tc => tc.type === "function").find(s => s.function.name === props.operation.name);
+    const choice = completion.choices?.[0];
+    const toolCall = choice?.message.tool_calls?.filter(tc => tc.type === "function").find(s => s.function.name === props.operation.name);
     if (toolCall === undefined) {
         return correctError(ctx, {
             ...props,
             life: props.life - 1
         });
     }
-    return predicate(ctx, props.operation, toolCall, props.previousValidationErrors, props.life);
+    const assistant = choice === undefined ? undefined : ChatGptAssistantMessageUtil.collect(choice.message);
+    return predicate(ctx, props.operation, toolCall, assistant === undefined ? undefined : {
+        assistant
+    }, props.previousValidationErrors, props.life);
 }
 
 async function executeFunction(call, operation) {
@@ -1691,7 +1766,8 @@ async function executeFunction(call, operation) {
             operation: call.operation,
             arguments: call.arguments,
             value,
-            success: true
+            success: true,
+            assistant: call.assistant
         });
     } catch (error) {
         return createExecuteEvent({
@@ -1704,7 +1780,8 @@ async function executeFunction(call, operation) {
                 message: error.message,
                 stack: error.stack
             } : error,
-            success: false
+            success: false,
+            assistant: call.assistant
         });
     }
 }
@@ -1937,6 +2014,7 @@ async function step$1(ctx, operations, retry, failures) {
         }
     }
     for (const choice of completion.choices ?? []) {
+        const assistant = ChatGptAssistantMessageUtil.collect(choice.message);
         if (choice.message.tool_calls != null) {
             for (const tc of choice.message.tool_calls) {
                 if (tc.type !== "function") {
@@ -1957,7 +2035,9 @@ async function step$1(ctx, operations, retry, failures) {
                     continue;
                 }
                 for (const reference of input.functions) {
-                    cancelFunctionFromContext(ctx, reference);
+                    cancelFunctionFromContext(ctx, reference, assistant === undefined ? undefined : {
+                        assistant
+                    });
                 }
             }
         }
@@ -2118,7 +2198,7 @@ async function initialize(ctx) {
     }
 }
 
-function selectFunctionFromContext(ctx, reference) {
+function selectFunctionFromContext(ctx, reference, reasoning) {
     const operation = ctx.operations.flat.get(reference.name);
     if (operation === undefined) {
         return;
@@ -2129,7 +2209,8 @@ function selectFunctionFromContext(ctx, reference) {
     });
     ctx.stack.push(selection);
     const event = createSelectEvent({
-        selection
+        selection,
+        assistant: reasoning?.assistant
     });
     void ctx.dispatch(event).catch(() => {});
 }
@@ -2370,6 +2451,7 @@ async function step(ctx, operations, retry, failures) {
         }
     }
     for (const choice of completion.choices ?? []) {
+        const assistant = ChatGptAssistantMessageUtil.collect(choice.message);
         if (choice.message.tool_calls != null) {
             for (const tc of choice.message.tool_calls) {
                 if (tc.type !== "function") {
@@ -2390,7 +2472,9 @@ async function step(ctx, operations, retry, failures) {
                     continue;
                 }
                 for (const reference of input.functions) {
-                    selectFunctionFromContext(ctx, reference);
+                    selectFunctionFromContext(ctx, reference, assistant === undefined ? undefined : {
+                        assistant
+                    });
                 }
             }
         }
@@ -2506,7 +2590,8 @@ function transformSelect(props) {
                 input: props.history.selection.operation
             }),
             reason: props.history.selection.reason
-        })
+        }),
+        assistant: props.history.assistant
     });
 }
 
@@ -2520,7 +2605,8 @@ function transformCancel(props) {
                 input: props.history.selection.operation
             }),
             reason: props.history.selection.reason
-        })
+        }),
+        assistant: props.history.assistant
     });
 }
 
@@ -2534,7 +2620,8 @@ function transformExecute(props) {
         }),
         arguments: props.history.arguments,
         value: props.history.value,
-        success: props.history.success
+        success: props.history.success,
+        assistant: props.history.assistant
     });
 }