@agentica/core 0.45.0-dev.20260426 → 0.45.1

package/lib/index.mjs

@@ -1083,12 +1083,12 @@ function accumulate(origin, chunk) {
     };
 }
 
-function merge(chunks) {
+function mergeChunks(chunks) {
     const firstChunk = chunks[0];
     if (firstChunk === undefined) {
         throw new Error("No chunks received");
     }
-    const result = chunks.reduce(accumulate, {
+    return chunks.reduce(accumulate, {
         id: firstChunk.id,
         choices: [],
         created: firstChunk.created,
@@ -1098,14 +1098,21 @@ function merge(chunks) {
         service_tier: firstChunk.service_tier,
         system_fingerprint: firstChunk.system_fingerprint
     });
-    result.choices?.forEach(choice => {
+}
+
+function fixEmptyToolArguments(completion) {
+    completion.choices?.forEach(choice => {
         choice.message.tool_calls?.filter(tc => tc.type === "function").forEach(toolCall => {
             if (toolCall.function.arguments === "") {
                 toolCall.function.arguments = "{}";
             }
         });
     });
-    return result;
+    return completion;
+}
+
+function merge(chunks) {
+    return fixEmptyToolArguments(mergeChunks(chunks));
 }
 
 function mergeChoice(acc, cur) {
@@ -1183,6 +1190,8 @@ const ChatGptCompletionMessageUtil = {
     transformCompletionChunk,
     accumulate,
     merge,
+    mergeChunks,
+    fixEmptyToolArguments,
     mergeChoice,
     mergeToolCalls
 };
@@ -1435,7 +1444,7 @@ async function reduceStreamingWithDispatch(stream, eventProcessor, abortSignal)
         };
         if (acc.object === "chat.completion.chunk") {
             registerContext([ acc, chunk ].flatMap(v => v.choices ?? []));
-            return ChatGptCompletionMessageUtil.merge([ acc, chunk ]);
+            return ChatGptCompletionMessageUtil.mergeChunks([ acc, chunk ]);
         }
         registerContext(chunk.choices ?? []);
         return ChatGptCompletionMessageUtil.accumulate(acc, chunk);
@@ -1459,7 +1468,7 @@ async function reduceStreamingWithDispatch(stream, eventProcessor, abortSignal)
         });
         return completion;
     }
-    return nullableCompletion;
+    return ChatGptCompletionMessageUtil.fixEmptyToolArguments(nullableCompletion);
 }
 
 function createOperationSelection(props) {
@@ -1998,14 +2007,38 @@ async function step$1(ctx, operations, retry, failures) {
                 if (tc.type !== "function" || tc.function.name !== "cancelFunctions") {
                     continue;
                 }
-                const input = FUNCTION$2.parse(tc.function.arguments);
-                const validation = FUNCTION$2.validate(input);
+                const parsed = FUNCTION$2.parse(tc.function.arguments);
+                if (parsed.success === false) {
+                    failures.push({
+                        kind: "parse",
+                        id: tc.id,
+                        name: tc.function.name,
+                        failure: parsed
+                    });
+                    continue;
+                }
+                const validation = FUNCTION$2.validate(parsed.data);
                 if (validation.success === false) {
                     failures.push({
+                        kind: "validation",
                         id: tc.id,
                         name: tc.function.name,
                         validation
                     });
+                    continue;
+                }
+                const referenceErrors = validateFunctionExistence$1(ctx, validation.data);
+                if (referenceErrors.length > 0) {
+                    failures.push({
+                        kind: "validation",
+                        id: tc.id,
+                        name: tc.function.name,
+                        validation: {
+                            success: false,
+                            data: validation.data,
+                            errors: referenceErrors
+                        }
+                    });
                 }
             }
         }
@@ -2022,19 +2055,12 @@ async function step$1(ctx, operations, retry, failures) {
                 } else if (tc.function.name !== "cancelFunctions") {
                     continue;
                 }
-                const input = (() => {
-                    const _io0 = input => Array.isArray(input.functions) && input.functions.every(elem => "object" === typeof elem && null !== elem && _io1(elem));
-                    const _io1 = input => "string" === typeof input.reason && "string" === typeof input.name;
-                    const __is = input => "object" === typeof input && null !== input && _io0(input);
-                    return input => {
-                        input = JSON.parse(input);
-                        return __is(input) ? input : null;
-                    };
-                })()(tc.function.arguments);
-                if (input === null) {
+                const parsed = FUNCTION$2.parse(tc.function.arguments);
+                const validation = FUNCTION$2.validate(parsed.data);
+                if (validation.success === false) {
                     continue;
                 }
-                for (const reference of input.functions) {
+                for (const reference of validation.data.functions) {
                     cancelFunctionFromContext(ctx, reference, assistant === undefined ? undefined : {
                         assistant
                     });
@@ -2052,19 +2078,46 @@ function emendMessages$1(failures) {
             id: f.id,
             function: {
                 name: f.name,
-                arguments: JSON.stringify(f.validation.data)
+                arguments: f.kind === "parse" ? f.failure.input : JSON.stringify(f.validation.data)
             }
         } ]
     }, {
         role: "tool",
-        content: JSON.stringify(f.validation.errors),
-        tool_call_id: f.id
+        tool_call_id: f.id,
+        content: f.kind === "parse" ? dedent`
+              Invalid JSON format.
+
+              Here is the detailed parsing failure information,
+              including error messages and their locations within the input:
+
+              \`\`\`json
+              ${JSON.stringify(f.failure.errors)}
+              \`\`\`
+
+              And here is the partially parsed data that was successfully
+              extracted before the error occurred:
+
+              \`\`\`json
+              ${JSON.stringify(f.failure.data)}
+              \`\`\`
+            ` : [ "🚨 VALIDATION FAILURE: Your function arguments do not conform to the required schema.", "", "Each error below is computed absolute truth from rigorous type validation.", "You must fix ALL errors to achieve 100% schema compliance.", "", LlmJson.stringify(f.validation) ].join("\n")
     }, {
         role: "system",
-        content: [ "You A.I. assistant has composed wrong typed arguments.", "", "Correct it at the next function calling." ].join("\n")
+        content: f.kind === "parse" ? AgenticaSystemPrompt.JSON_PARSE_ERROR.replace("${{FAILURE}}", JSON.stringify(f.failure)) : AgenticaSystemPrompt.VALIDATE
     } ]).flat();
 }
 
+function validateFunctionExistence$1(ctx, data) {
+    const cancellable = ctx.stack.map(s => s.operation.name);
+    const expected = cancellable.length === 0 ? "never" : cancellable.map(name => JSON.stringify(name)).join(" | ");
+    return data.functions.flatMap((reference, i) => cancellable.includes(reference.name) ? [] : [ {
+        path: `$input.functions[${i}].name`,
+        expected,
+        value: reference.name,
+        description: cancellable.length === 0 ? `Function "${reference.name}" cannot be cancelled because no function is currently selected.` : `Function "${reference.name}" is not in the current selection, so it cannot be cancelled.`
+    } ]);
+}
+
 async function describe(ctx, histories) {
     if (histories.length === 0) {
         return;
@@ -2435,14 +2488,38 @@ async function step(ctx, operations, retry, failures) {
                 if (tc.type !== "function" || tc.function.name !== "selectFunctions") {
                     continue;
                 }
-                const input = FUNCTION.parse(tc.function.arguments);
-                const validation = FUNCTION.validate(input);
+                const parsed = FUNCTION.parse(tc.function.arguments);
+                if (parsed.success === false) {
+                    failures.push({
+                        kind: "parse",
+                        id: tc.id,
+                        name: tc.function.name,
+                        failure: parsed
+                    });
+                    continue;
+                }
+                const validation = FUNCTION.validate(parsed.data);
                 if (validation.success === false) {
                     failures.push({
+                        kind: "validation",
                         id: tc.id,
                         name: tc.function.name,
                         validation
                     });
+                    continue;
+                }
+                const referenceErrors = validateFunctionExistence(ctx, operations, validation.data);
+                if (referenceErrors.length > 0) {
+                    failures.push({
+                        kind: "validation",
+                        id: tc.id,
+                        name: tc.function.name,
+                        validation: {
+                            success: false,
+                            data: validation.data,
+                            errors: referenceErrors
+                        }
+                    });
                 }
             }
         }
@@ -2459,19 +2536,12 @@ async function step(ctx, operations, retry, failures) {
                 } else if (tc.function.name !== "selectFunctions") {
                     continue;
                 }
-                const input = (() => {
-                    const _io0 = input => Array.isArray(input.functions) && input.functions.every(elem => "object" === typeof elem && null !== elem && _io1(elem));
-                    const _io1 = input => "string" === typeof input.reason && "string" === typeof input.name;
-                    const __is = input => "object" === typeof input && null !== input && _io0(input);
-                    return input => {
-                        input = JSON.parse(input);
-                        return __is(input) ? input : null;
-                    };
-                })()(tc.function.arguments);
-                if (input === null) {
+                const parsed = FUNCTION.parse(tc.function.arguments);
+                const validation = FUNCTION.validate(parsed.data);
+                if (validation.success === false) {
                     continue;
                 }
-                for (const reference of input.functions) {
+                for (const reference of validation.data.functions) {
                     selectFunctionFromContext(ctx, reference, assistant === undefined ? undefined : {
                         assistant
                     });
@@ -2489,19 +2559,45 @@ function emendMessages(failures) {
             id: f.id,
             function: {
                 name: f.name,
-                arguments: JSON.stringify(f.validation.data)
+                arguments: f.kind === "parse" ? f.failure.input : JSON.stringify(f.validation.data)
             }
         } ]
     }, {
         role: "tool",
-        content: JSON.stringify(f.validation.errors),
-        tool_call_id: f.id
+        tool_call_id: f.id,
+        content: f.kind === "parse" ? dedent`
+              Invalid JSON format.
+
+              Here is the detailed parsing failure information,
+              including error messages and their locations within the input:
+
+              \`\`\`json
+              ${JSON.stringify(f.failure.errors)}
+              \`\`\`
+
+              And here is the partially parsed data that was successfully
+              extracted before the error occurred:
+
+              \`\`\`json
+              ${JSON.stringify(f.failure.data)}
+              \`\`\`
+            ` : [ "🚨 VALIDATION FAILURE: Your function arguments do not conform to the required schema.", "", "Each error below is computed absolute truth from rigorous type validation.", "You must fix ALL errors to achieve 100% schema compliance.", "", LlmJson.stringify(f.validation) ].join("\n")
     }, {
         role: "system",
-        content: [ "You A.I. assistant has composed wrong typed arguments.", "", "Correct it at the next function calling." ].join("\n")
+        content: f.kind === "parse" ? AgenticaSystemPrompt.JSON_PARSE_ERROR.replace("${{FAILURE}}", JSON.stringify(f.failure)) : AgenticaSystemPrompt.VALIDATE
     } ]).flat();
 }
 
+function validateFunctionExistence(ctx, candidates, data) {
+    const expected = candidates.map(op => JSON.stringify(op.name)).join(" | ");
+    return data.functions.flatMap((reference, i) => ctx.operations.flat.has(reference.name) ? [] : [ {
+        path: `$input.functions[${i}].name`,
+        expected,
+        value: reference.name,
+        description: [ `Function "${reference.name}" does not exist.`, "Select only from the functions provided by getApiFunctions()." ].join(" ")
+    } ]);
+}
+
 function execute(executor) {
     return async ctx => {
         if (ctx.ready() === false) {