feat(agent): add executor evidence output contract

src/main/java/com/superbiz/agent/hook/VerifierInputHook.java

@@ -5,6 +5,8 @@ import com.alibaba.cloud.ai.graph.agent.hook.HookPosition;
 import com.alibaba.cloud.ai.graph.agent.hook.HookPositions;
 import com.alibaba.cloud.ai.graph.agent.hook.messages.AgentCommand;
 import com.alibaba.cloud.ai.graph.agent.hook.messages.MessagesModelHook;
+import com.fasterxml.jackson.core.type.TypeReference;
+import com.fasterxml.jackson.databind.JsonNode;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.superbiz.agent.service.ToolTraceSummaryService;
 import com.superbiz.agent.util.SessionContextHolder;
@@ -27,6 +29,8 @@ public class VerifierInputHook extends MessagesModelHook {
 
     private final ToolTraceSummaryService toolTraceSummaryService;
     private final ObjectMapper objectMapper = new ObjectMapper();
+    private static final TypeReference<Map<String, Object>> MAP_TYPE = new TypeReference<>() {
+    };
 
     public VerifierInputHook(ToolTraceSummaryService toolTraceSummaryService) {
         this.toolTraceSummaryService = toolTraceSummaryService;
@@ -48,6 +52,10 @@ public class VerifierInputHook extends MessagesModelHook {
                 executorFinalAnswer = extractLastAssistantText(previousMessages);
             }
 
+            ExecutorOutputParseResult parseResult = parseExecutorOutput(executorFinalAnswer);
+            VerifierContextHolder.setExecutorStructuredOutput(parseResult.structuredOutput());
+            VerifierContextHolder.setExecutorOutputParseStatus(parseResult.status());
+
             List<Map<String, Object>> toolTraceSummary =
                     toolTraceSummaryService.buildVerifierTraceSummary(sessionId, executorFinalAnswer);
             VerifierContextHolder.setToolTraceSummary(toolTraceSummary);
@@ -55,6 +63,8 @@ public class VerifierInputHook extends MessagesModelHook {
             Map<String, Object> verifierInput = new LinkedHashMap<>();
             verifierInput.put("original_query", VerifierContextHolder.getOriginalQuery());
             verifierInput.put("executor_final_answer", executorFinalAnswer);
+            verifierInput.put("executor_structured_output", parseResult.structuredOutput());
+            verifierInput.put("executor_output_parse_status", parseResult.status());
             verifierInput.put("tool_trace_summary", toolTraceSummary);
             verifierInput.put("retry_context", VerifierContextHolder.getRetryContext());
 
@@ -66,6 +76,59 @@ public class VerifierInputHook extends MessagesModelHook {
         }
     }
 
+    private ExecutorOutputParseResult parseExecutorOutput(String executorFinalAnswer) {
+        if (executorFinalAnswer == null || executorFinalAnswer.isBlank()) {
+            return new ExecutorOutputParseResult(null, status("missing", "executor_final_answer is blank"));
+        }
+
+        String sanitized = sanitizeJsonPayload(executorFinalAnswer);
+        if (!looksJsonLike(sanitized)) {
+            return new ExecutorOutputParseResult(null, status("missing", "executor output is not JSON"));
+        }
+
+        try {
+            JsonNode root = objectMapper.readTree(sanitized);
+            if (!root.isObject() || !root.path("claims").isArray()) {
+                return new ExecutorOutputParseResult(null, status("malformed",
+                        "executor output JSON does not match evidence-attribution contract"));
+            }
+            Map<String, Object> structuredOutput = objectMapper.convertValue(root, MAP_TYPE);
+            return new ExecutorOutputParseResult(structuredOutput, status("valid", "parsed executor evidence contract"));
+        } catch (Exception e) {
+            log.debug("Failed to parse executor structured output", e);
+            return new ExecutorOutputParseResult(null, status("malformed", e.getMessage()));
+        }
+    }
+
+    private String sanitizeJsonPayload(String raw) {
+        String trimmed = raw.trim();
+        int fenceStart = trimmed.indexOf("```");
+        if (fenceStart >= 0) {
+            int firstNewline = trimmed.indexOf('\n', fenceStart);
+            int lastFence = trimmed.indexOf("```", firstNewline + 1);
+            if (firstNewline >= 0 && lastFence > firstNewline) {
+                return trimmed.substring(firstNewline + 1, lastFence).trim();
+            }
+        }
+        int objectStart = trimmed.indexOf('{');
+        int objectEnd = trimmed.lastIndexOf('}');
+        if (objectStart >= 0 && objectEnd > objectStart) {
+            return trimmed.substring(objectStart, objectEnd + 1).trim();
+        }
+        return trimmed;
+    }
+
+    private boolean looksJsonLike(String text) {
+        return text.startsWith("{") && text.endsWith("}");
+    }
+
+    private Map<String, Object> status(String status, String detail) {
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("status", status);
+        result.put("detail", detail == null ? "" : detail);
+        return result;
+    }
+
     private String extractLastAssistantText(List<Message> previousMessages) {
         for (int i = previousMessages.size() - 1; i >= 0; i--) {
             if (previousMessages.get(i) instanceof AssistantMessage assistantMessage) {
@@ -102,4 +165,10 @@ public class VerifierInputHook extends MessagesModelHook {
         }
         return message.toString();
     }
+
+    private record ExecutorOutputParseResult(
+            Map<String, Object> structuredOutput,
+            Map<String, Object> status
+    ) {
+    }
 }