Merge branch 'main' of https://github.com/wrtnlabs/agentica

Author: samchon

packages/core/prompts/execute.md

@@ -18,9 +18,10 @@ ${{ERROR_MESSAGE}}
 - Function execution cannot proceed
 
 ### Required Action:
-- **Retry the function call** with **valid JSON format**
-- Fix the JSON syntax error indicated above
-- Ensure proper JSON structure in the `arguments` field
+- Review the error message above and determine whether the JSON is recoverable
+- If the syntax error is minor (e.g. trailing comma, missing quote), fix it and retry
+- If the JSON is severely malformed or structurally broken, **discard the previous output entirely** and reconstruct the `arguments` from scratch based on the function's parameter schema
+- Do not attempt to patch heavily corrupted JSON — rebuilding from zero is faster and more reliable
 
 ### Common JSON Syntax Requirements:
 - Use double quotes for all keys and string values
@@ -29,4 +30,4 @@ ${{ERROR_MESSAGE}}
 - Use lowercase `null` for null values
 - Properly escape special characters in strings
 
-**Please correct the JSON format and retry the function call immediately.**
+**Retry the function call immediately with valid JSON.**

packages/core/prompts/json_parse_error.md

@@ -50,11 +50,6 @@ export async function call(
   const completion = await retryFn(async (prevError) => {
     const result = await ctx.request("call", {
       messages: [
-        // COMMON SYSTEM PROMPT
-        {
-          role: "system",
-          content: AgenticaDefaultPrompt.write(ctx.config),
-        } satisfies OpenAI.ChatCompletionSystemMessageParam,
         // PREVIOUS HISTORIES
         ...ctx.histories.map(decodeHistory).flat(),
         // USER INPUT
@@ -78,6 +73,11 @@ export async function call(
             content: ctx.config?.systemPrompt?.execute?.(ctx.histories as MicroAgenticaHistory[])
               ?? AgenticaSystemPrompt.EXECUTE,
           } satisfies OpenAI.ChatCompletionSystemMessageParam]),
+        // COMMON SYSTEM PROMPT
+        {
+          role: "system",
+          content: AgenticaDefaultPrompt.write(ctx.config),
+        } satisfies OpenAI.ChatCompletionSystemMessageParam,
       ],
       // STACKED FUNCTIONS
       tools: operations.map(
@@ -357,11 +357,6 @@ async function correctError(
 
   const result = await ctx.request("call", {
     messages: [
-      // COMMON SYSTEM PROMPT
-      {
-        role: "system",
-        content: AgenticaDefaultPrompt.write(ctx.config),
-      } satisfies OpenAI.ChatCompletionSystemMessageParam,
       // PREVIOUS HISTORIES
       ...ctx.histories.map(decodeHistory).flat(),
       // USER INPUT
@@ -398,6 +393,11 @@ async function correctError(
         role: "system",
         content: props.systemPrompt,
       },
+      // COMMON SYSTEM PROMPT
+      {
+        role: "system",
+        content: AgenticaDefaultPrompt.write(ctx.config),
+      } satisfies OpenAI.ChatCompletionSystemMessageParam,
     ],
     // STACK FUNCTIONS
     tools: [

packages/core/prompts/validate.md

@@ -97,11 +97,6 @@ async function step(
   // ----
   const result = await ctx.request("cancel", {
     messages: [
-      // COMMON SYSTEM PROMPT
-      {
-        role: "system",
-        content: AgenticaDefaultPrompt.write(ctx.config),
-      } satisfies OpenAI.ChatCompletionSystemMessageParam,
       // CANDIDATE FUNCTIONS
       {
         role: "assistant",
@@ -149,6 +144,10 @@ async function step(
       },
       // TYPE CORRECTIONS
       ...emendMessages(failures ?? []),
+      {
+        role: "system",
+        content: AgenticaDefaultPrompt.write(ctx.config),
+      },
     ],
     // STACK FUNCTIONS
     tools: [{

packages/core/src/orchestrate/call.ts

@@ -22,11 +22,6 @@ export async function describe(
 
   const result = await ctx.request("describe", {
     messages: [
-      // COMMON SYSTEM PROMPT
-      {
-        role: "system",
-        content: AgenticaDefaultPrompt.write(ctx.config),
-      } satisfies OpenAI.ChatCompletionSystemMessageParam,
       // FUNCTION CALLING HISTORIES
       ...histories.map(decodeHistory).flat(),
       // SYSTEM PROMPT
@@ -36,6 +31,11 @@ export async function describe(
           ctx.config?.systemPrompt?.describe?.(histories)
           ?? AgenticaSystemPrompt.DESCRIBE,
       },
+      // COMMON SYSTEM PROMPT
+      {
+        role: "system",
+        content: AgenticaDefaultPrompt.write(ctx.config),
+      } satisfies OpenAI.ChatCompletionSystemMessageParam,
     ],
   });
 

packages/core/src/orchestrate/cancel.ts

@@ -24,25 +24,25 @@ export async function initialize(ctx: AgenticaContext): Promise<void> {
   // ----
   const result = await ctx.request("initialize", {
     messages: [
-      // COMMON SYSTEM PROMPT
-      {
-        role: "system",
-        content: AgenticaDefaultPrompt.write(ctx.config),
-      } satisfies OpenAI.ChatCompletionSystemMessageParam,
       // PREVIOUS HISTORIES
       ...ctx.histories.map(decodeHistory).flat(),
       // USER INPUT
       {
         role: "user",
         content: ctx.prompt.contents.map(decodeUserMessageContent),
       },
+      // SYSTEM PROMPT
       {
-        // SYSTEM PROMPT
         role: "system",
         content:
           ctx.config?.systemPrompt?.initialize?.(ctx.histories)
           ?? AgenticaSystemPrompt.INITIALIZE,
       },
+      // COMMON SYSTEM PROMPT
+      {
+        role: "system",
+        content: AgenticaDefaultPrompt.write(ctx.config),
+      } satisfies OpenAI.ChatCompletionSystemMessageParam,
     ],
     // GETTER FUNCTION
     tools: [

packages/core/src/orchestrate/describe.ts

@@ -110,11 +110,7 @@ async function step(
   const completion = await retryFn(async (prevError) => {
     const result = await ctx.request("select", {
       messages: [
-        // COMMON SYSTEM PROMPT
-        {
-          role: "system",
-          content: AgenticaDefaultPrompt.write(ctx.config),
-        } satisfies OpenAI.ChatCompletionSystemMessageParam,
+
         // CANDIDATE FUNCTIONS
         {
           role: "assistant",
@@ -171,6 +167,11 @@ async function step(
         },
         // TYPE CORRECTIONS
         ...emendMessages(failures ?? []),
+        // COMMON SYSTEM PROMPT
+        {
+          role: "system",
+          content: AgenticaDefaultPrompt.write(ctx.config),
+        } satisfies OpenAI.ChatCompletionSystemMessageParam,
       ],
       // STACK FUNCTIONS
       tools: [{

packages/core/src/orchestrate/initialize.ts

@@ -22,10 +22,6 @@ export async function selectFunction(props: {
   const { ctx, toolList, prevFailures = [], restRetry = 5 } = props;
   const selectCompletion = await ctx.request("select", {
     messages: [
-      {
-        role: "system",
-        content: AgenticaDefaultPrompt.write(ctx.config),
-      },
       {
         role: "assistant",
         tool_calls: [
@@ -60,6 +56,10 @@ export async function selectFunction(props: {
         `,
       },
       ...emendMessages(prevFailures),
+      {
+        role: "system",
+        content: AgenticaDefaultPrompt.write(ctx.config),
+      },
     ],
     tool_choice: {
       type: "function",