From 5b3083be66e263c2a1021639951b8b06b3274002 Mon Sep 17 00:00:00 2001
From: Felix <24791380+vcfgv@users.noreply.github.com>
Date: Wed, 3 Dec 2025 15:19:12 +0800
Subject: [PATCH] feat: enhance SECFilingResult representation for better
 clarity

---
 python/valuecell/agents/research_agent/schemas.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/python/valuecell/agents/research_agent/schemas.py b/python/valuecell/agents/research_agent/schemas.py
index adc07da9a..7f8c9f605 100644
--- a/python/valuecell/agents/research_agent/schemas.py
+++ b/python/valuecell/agents/research_agent/schemas.py
@@ -16,6 +16,14 @@ class SECFilingResult:
     path: Path
     metadata: SECFilingMetadata
 
+    def __repr__(self) -> str:
+        meta = self.metadata
+        return (
+            f"Fetched SEC Filing '{self.name}' for {meta.company} "
+            f"(type: {meta.doc_type}, period: {meta.period_of_report}, filed: {meta.filing_date}) "
+            f"located at {self.path}"
+        )
+
 
 @dataclass
 class AShareFilingMetadata: