Add series key metadata to callback contexts

src/core/interfaces/callbacks.py

@@ -47,6 +47,8 @@ class ProgressContext:
         percentage: Completion percentage (0.0 to 100.0)
         message: Human-readable progress message
         details: Additional context-specific details
+        key: Provider-assigned series identifier (None when not applicable)
+        folder: Optional folder metadata for display purposes only
         metadata: Extra metadata for specialized use cases
     """
     
@@ -58,6 +60,8 @@ class ProgressContext:
     percentage: float
     message: str
     details: Optional[str] = None
+    key: Optional[str] = None
+    folder: Optional[str] = None
     metadata: Dict[str, Any] = field(default_factory=dict)
     
     def to_dict(self) -> Dict[str, Any]:
@@ -71,6 +75,8 @@ class ProgressContext:
             "percentage": round(self.percentage, 2),
             "message": self.message,
             "details": self.details,
+            "key": self.key,
+            "folder": self.folder,
             "metadata": self.metadata,
         }
 
@@ -87,6 +93,8 @@ class ErrorContext:
         message: Human-readable error message
         recoverable: Whether the error is recoverable
         retry_count: Number of retry attempts made
+        key: Provider-assigned series identifier (None when not applicable)
+        folder: Optional folder metadata for display purposes only
         metadata: Additional error context
     """
     
@@ -96,6 +104,8 @@ class ErrorContext:
     message: str
     recoverable: bool = False
     retry_count: int = 0
+    key: Optional[str] = None
+    folder: Optional[str] = None
     metadata: Dict[str, Any] = field(default_factory=dict)
     
     def to_dict(self) -> Dict[str, Any]:
@@ -108,6 +118,8 @@ class ErrorContext:
             "message": self.message,
             "recoverable": self.recoverable,
             "retry_count": self.retry_count,
+            "key": self.key,
+            "folder": self.folder,
             "metadata": self.metadata,
         }
 
@@ -124,6 +136,8 @@ class CompletionContext:
         message: Human-readable completion message
         result_data: Result data from the operation
         statistics: Operation statistics (duration, items processed, etc.)
+        key: Provider-assigned series identifier (None when not applicable)
+        folder: Optional folder metadata for display purposes only
         metadata: Additional completion context
     """
     
@@ -133,6 +147,8 @@ class CompletionContext:
     message: str
     result_data: Optional[Any] = None
     statistics: Dict[str, Any] = field(default_factory=dict)
+    key: Optional[str] = None
+    folder: Optional[str] = None
     metadata: Dict[str, Any] = field(default_factory=dict)
     
     def to_dict(self) -> Dict[str, Any]:
@@ -143,6 +159,8 @@ class CompletionContext:
             "success": self.success,
             "message": self.message,
             "statistics": self.statistics,
+            "key": self.key,
+            "folder": self.folder,
             "metadata": self.metadata,
         }