veadk-python 0.2.16__py3-none-any.whl → 0.2.17__py3-none-any.whl

veadk/tracing/telemetry/opentelemetry_tracer.py

@@ -40,10 +40,58 @@ logger = get_logger(__name__)
 def _update_resource_attributions(
     provider: TracerProvider, resource_attributes: dict
 ) -> None:
+    """Update the resource attributes of a TracerProvider instance.
+
+    This function merges new resource attributes with the existing ones in the
+    provider, allowing dynamic configuration of telemetry metadata.
+
+    Args:
+        provider: The TracerProvider instance to update
+        resource_attributes: Dictionary of attributes to merge with existing resources
+    """
     provider._resource = provider._resource.merge(Resource.create(resource_attributes))
 
 
 class OpentelemetryTracer(BaseModel, BaseTracer):
+    """OpenTelemetry-based tracer implementation for comprehensive agent observability.
+
+    This class provides a complete tracing solution using OpenTelemetry standards,
+    supporting multiple exporters for different observability platforms. It captures
+    detailed execution traces including LLM calls, tool invocations, and agent workflow
+    patterns for debugging and performance analysis.
+
+    Key Features:
+    - Multi-exporter support (APMPlus, in-memory, custom exporters)
+    - Thread-safe span processing with configurable limits
+    - Local trace dumping with JSON serialization
+    - Resource attribute management for metadata enrichment
+    - Force flush capabilities for immediate data export
+
+    Architecture:
+    The tracer initializes a global TracerProvider with custom span processors for
+    each configured exporter. It maintains an internal in-memory exporter for local
+    operations while supporting external observability platforms simultaneously.
+
+    Attributes:
+        name: Identifier for this tracer instance, used in file naming and logging
+        exporters: List of exporter instances for sending trace data to different backends
+
+    Examples:
+        Basic usage with APMPlus exporter:
+        ```python
+        exporters = [
+            CozeloopExporter(),
+            APMPlusExporter(),
+            TLSExporter(),
+        ]
+        tracer = OpentelemetryTracer(exporters=exporters)
+        ```
+
+    Note:
+        - InMemoryExporter cannot be explicitly added to exporters list
+        - Span limits are set to 4096 attributes for comprehensive data capture
+    """
+
     model_config = ConfigDict(arbitrary_types_allowed=True)
 
     name: str = Field(
@@ -60,12 +108,31 @@ class OpentelemetryTracer(BaseModel, BaseTracer):
     @field_validator("exporters")
     @classmethod
     def forbid_inmemory_exporter(cls, v: list[BaseExporter]) -> list[BaseExporter]:
+        """Validate that InMemoryExporter is not explicitly added to exporters list.
+
+        InMemoryExporter is automatically managed internally and should not be
+        included in the user-provided exporters list to avoid conflicts.
+
+        Args:
+            v: List of exporter instances to validate
+
+        Returns:
+            list[BaseExporter]: The validated list of exporters
+
+        Raises:
+            ValueError: If InMemoryExporter is found in the exporters list
+        """
         for e in v:
             if isinstance(e, InMemoryExporter):
                 raise ValueError("InMemoryExporter is not allowed in exporters list")
         return v
 
     def model_post_init(self, context: Any) -> None:
+        """Initialize the tracer after model construction.
+
+        This method performs post-initialization setup including Google ADK
+        telemetry patching and global tracer provider configuration.
+        """
         # Replace Google ADK tracing funcs
         # `trace_call_llm` and `trace_tool_call`
         patch_google_adk_telemetry()
@@ -78,6 +145,12 @@ class OpentelemetryTracer(BaseModel, BaseTracer):
         self._init_global_tracer_provider()
 
     def _init_global_tracer_provider(self) -> None:
+        """Initialize the global OpenTelemetry tracer provider with configured exporters.
+
+        This method sets up the global tracer provider, configures span processors
+        for each exporter, and ensures proper resource attribution. It also handles
+        duplicate exporter detection and in-memory span collection setup.
+        """
         # set provider anyway, then get global provider
         trace_api.set_tracer_provider(
             trace_sdk.TracerProvider(
@@ -143,10 +216,21 @@ class OpentelemetryTracer(BaseModel, BaseTracer):
 
     @property
     def trace_file_path(self) -> str:
+        """Get the file path of the most recent trace dump.
+
+        Returns:
+            str: Full path to the trace file, or placeholder if not yet dumped
+        """
         return self._trace_file_path
 
     @property
     def trace_id(self) -> str:
+        """Get the current trace ID in hexadecimal format.
+
+        Returns:
+            str: Hexadecimal representation of the current trace ID, or
+                placeholder string if trace ID cannot be retrieved
+        """
         try:
             trace_id = hex(int(self._inmemory_exporter._exporter.trace_id))[2:]  # type: ignore
             return trace_id
@@ -155,7 +239,12 @@ class OpentelemetryTracer(BaseModel, BaseTracer):
             return self._trace_id
 
     def force_export(self) -> None:
-        """Force to export spans in all processors."""
+        """Force immediate export of all pending spans across all processors.
+
+        This method triggers force_flush on all configured span processors,
+        ensuring that buffered span data is immediately sent to exporters.
+        Includes a small delay between flushes to prevent overwhelming exporters.
+        """
         for processor in self._processors:
             time.sleep(0.05)
             processor.force_flush()
@@ -167,6 +256,27 @@ class OpentelemetryTracer(BaseModel, BaseTracer):
         session_id: str = "unknown_session_id",
         path: str = get_temp_dir(),
     ) -> str:
+        """Dump collected trace data to a local JSON file.
+
+        This method exports all spans associated with the current session to a
+        structured JSON file for offline analysis. The file includes span metadata,
+        timing information, attributes, and parent-child relationships.
+
+        Args:
+            user_id: User identifier for trace organization and file naming
+            session_id: Session identifier for filtering and organizing spans
+            path: Directory path for the output file. Defaults to system temp directory
+
+        Returns:
+            str: Full path to the created trace file, or empty string if export fails
+
+        Note:
+            - Forces export of all pending spans before dumping
+            - Filters spans by session_id for relevant data only
+            - File format is structured JSON with span details and relationships
+            - Supports non-ASCII characters for international content
+        """
+
         def _build_trace_file_path(path: str, user_id: str, session_id: str) -> str:
             return f"{path}/{self.name}_{user_id}_{session_id}_{self.trace_id}.json"
 

veadk/tracing/telemetry/telemetry.py

@@ -43,6 +43,17 @@ def _upload_call_llm_metrics(
     llm_request: LlmRequest,
     llm_response: LlmResponse,
 ) -> None:
+    """Upload LLM call metrics to configured meter uploaders.
+
+    This function extracts meter uploaders from agent tracers and records
+    LLM call metrics including token usage, latency, and request/response details.
+
+    Args:
+        invocation_context: Context containing agent, session, and user information
+        event_id: Unique identifier for this LLM call event
+        llm_request: The request sent to the language model
+        llm_response: The response received from the language model
+    """
     from veadk.agent import Agent
 
     if isinstance(invocation_context.agent, Agent):
@@ -62,6 +73,19 @@ def _upload_tool_call_metrics(
     args: dict[str, Any],
     function_response_event: Event,
 ):
+    """Upload tool call metrics to the global meter uploader.
+
+    Records tool execution metrics including function name, arguments,
+    execution time, and response details for observability and debugging.
+
+    Args:
+        tool: The tool instance that was executed
+        args: Arguments passed to the tool function
+        function_response_event: Event containing the tool's response data
+
+    Note:
+        - Requires global meter_uploader to be initialized
+    """
     global meter_uploader
     if meter_uploader:
         meter_uploader.record_tool_call(tool, args, function_response_event)
@@ -74,8 +98,21 @@ def _upload_tool_call_metrics(
 def _set_agent_input_attribute(
     span: Span, invocation_context: InvocationContext
 ) -> None:
-    # We only save the original user input as the agent input
-    # hence once the `agent.input` has been set, we don't overwrite it
+    """Set agent input attributes and events on the given span.
+
+    This function captures the original user input and adds it as span attributes
+    and events in OpenTelemetry format. It handles both text and image content
+    while avoiding duplicate entries for the same input.
+
+    Args:
+        span: The OpenTelemetry span to annotate with input data
+        invocation_context: Context containing user input and session information
+
+    Note:
+        - Only sets input once per span to avoid duplication
+        - Supports multimodal content (text and images)
+        - Follows gen_ai attribute conventions
+    """
     event_names = [event.name for event in span.events]
     if "gen_ai.user.message" in event_names:
         return
@@ -132,6 +169,19 @@ def _set_agent_input_attribute(
 
 
 def _set_agent_output_attribute(span: Span, llm_response: LlmResponse) -> None:
+    """Set agent output attributes and events on the given span.
+
+    Captures the LLM response content and adds it as span attributes and events
+    in OpenTelemetry format for tracing and observability purposes.
+
+    Args:
+        span: The OpenTelemetry span to annotate with output data
+        llm_response: The language model response containing generated content
+
+    Note:
+        - Follows gen_ai attribute conventions
+        - Handles multipart responses with proper indexing
+    """
     content = llm_response.content
     if content and content.parts:
         # set gen_ai.output attribute required by APMPlus
@@ -156,6 +206,24 @@ def set_common_attributes_on_model_span(
     current_span: _Span,
     **kwargs,
 ) -> None:
+    """Set common attributes on model-related spans including invocation and agent run spans.
+
+    This function applies standardized attributes across multiple span types to ensure
+    consistent telemetry data. It handles token usage accumulation, input/output
+    annotation, and hierarchical span attribute propagation.
+
+    Key Operations:
+    - Sets agent input/output on invocation and agent run spans
+    - Accumulates token usage across multiple LLM calls
+    - Applies common attributes from the ATTRIBUTES mapping
+    - Handles span hierarchy and context propagation
+
+    Args:
+        invocation_context: Context containing agent, session, and user information
+        llm_response: The language model response with usage metadata
+        current_span: The current OpenTelemetry span being processed
+        **kwargs: Additional keyword arguments for attribute extraction
+    """
     common_attributes = ATTRIBUTES.get("common", {})
     try:
         invocation_span: Span = get_value("invocation_span_instance")  # type: ignore
@@ -207,6 +275,14 @@ def set_common_attributes_on_model_span(
 
 
 def set_common_attributes_on_tool_span(current_span: _Span) -> None:
+    """Set common attributes on tool execution spans.
+
+    Propagates common attributes from the parent invocation span to tool spans
+    to maintain consistent context across the execution trace hierarchy.
+
+    Args:
+        current_span: The tool execution span to annotate with common attributes
+    """
     common_attributes = ATTRIBUTES.get("common", {})
 
     invocation_span: Span = get_value("invocation_span_instance")  # type: ignore
@@ -226,6 +302,25 @@ def trace_tool_call(
     args: dict[str, Any],
     function_response_event: Event,
 ) -> None:
+    """Trace a tool function call with comprehensive telemetry data.
+
+    This function is the main entry point for tool call tracing, capturing
+    execution details, arguments, responses, and performance metrics for
+    debugging and observability purposes.
+
+    Tracing Data Captured:
+    - Tool name and function signature
+    - Input arguments and parameter values
+    - Execution timing and performance metrics
+    - Response data and return values
+    - Error information if execution fails
+    - Common context attributes (user, session, agent)
+
+    Args:
+        tool: The tool instance being executed
+        args: Dictionary of arguments passed to the tool function
+        function_response_event: Event containing the tool's execution response
+    """
     span = trace.get_current_span()
 
     set_common_attributes_on_tool_span(current_span=span)  # type: ignore
@@ -246,6 +341,27 @@ def trace_call_llm(
     llm_request: LlmRequest,
     llm_response: LlmResponse,
 ) -> None:
+    """Trace a language model call with comprehensive telemetry data.
+
+    This function is the main entry point for LLM call tracing, capturing
+    request/response details, token usage, timing, and context information
+    for cost tracking, performance analysis, and debugging.
+
+    Tracing Data Captured:
+    - Model name and provider information
+    - Request parameters and prompt content
+    - Response content and metadata
+    - Token usage (input, output, total)
+    - Execution timing and latency
+    - Context information (user, session, agent)
+    - Error information if the call fails
+
+    Args:
+        invocation_context: Context containing agent, session, and user information
+        event_id: Unique identifier for this LLM call event
+        llm_request: The request object sent to the language model
+        llm_response: The response object received from the language model
+    """
     span: Span = trace.get_current_span()  # type: ignore
 
     from veadk.agent import Agent

veadk/version.py

@@ -12,4 +12,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-VERSION = "0.2.16"
+VERSION = "0.2.17"

{veadk_python-0.2.16.dist-info → veadk_python-0.2.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: veadk-python
-Version: 0.2.16
+Version: 0.2.17
 Summary: Volcengine agent development kit, integrations with Volcengine cloud services.
 Author-email: Yaozheng Fang <fangyozheng@gmail.com>, Guodong Li <cu.eric.lee@gmail.com>, Zhi Han <sliverydayday@gmail.com>, Meng Wang <mengwangwm@gmail.com>
 License:                                  Apache License

{veadk_python-0.2.16.dist-info → veadk_python-0.2.17.dist-info}/RECORD

@@ -1,61 +1,62 @@
 veadk/__init__.py,sha256=9l1lyb9ifhHQeetmIBWZnIdwUCVyMyz1EnKsKz8BBG8,1135
-veadk/agent.py,sha256=YmT6Iu5UKro8S13URuDq9LIoP9ZQKZWuK2SA1AA_Fwo,12809
+veadk/agent.py,sha256=O2EMA5_KcviqkT6bebpMbNNRLpztOFX5fmDDLbjMRgs,15018
 veadk/agent_builder.py,sha256=HI7mRrUZ72_7i-jVzNDx1anTZHy7UxX7jr2Drxxx6j8,3031
 veadk/config.py,sha256=pirKse9MH9RQmgepM41vgVg9_22t2aa_6i-yuTipnxk,3578
 veadk/consts.py,sha256=8FcwnvKxQM50r8HDQxnhI-Ml_mjyfYdkGDxbyPBrW5Q,2679
-veadk/runner.py,sha256=_DGNwX-t3sHJFJvHs-rRHXbjCZza8I_zU8AN3Fw5nRY,14217
+veadk/runner.py,sha256=6oXLcHKK5_bbfj2M5NT30DB4QVt_uIXtgMFi2HykNb8,29486
 veadk/types.py,sha256=zOOzG-QJy-MkzHeicWJzy2_L5U4ERrWziPubIUEbd8c,1656
-veadk/version.py,sha256=714odtak2c78LIi25wI3LP8hoXdf3L5pSNhC12OA6V0,654
+veadk/version.py,sha256=SNAZbadGRMJVunmX0uubBirEHTevEZEPl_h8axnAf4E,654
 veadk/a2a/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/a2a/agent_card.py,sha256=lhtgW1acMpxYUdULHEZwVFXOi6Xh4lNkf4S7QIhbFFI,1525
-veadk/a2a/remote_ve_agent.py,sha256=L2nzT8PlDI-lLtcaTJqk-D2Uvw9beKl8OEUqp-8qCbA,3510
+veadk/a2a/remote_ve_agent.py,sha256=M0a8CIPmwiogZjcjBG3qhPRsP_jquQoixHYH5tcDD9M,6106
 veadk/a2a/ve_a2a_server.py,sha256=U1RVRx_GAfLw2nCacy80O8wC67MfCTXn5x-dCfKCYXg,2492
 veadk/a2a/ve_agent_executor.py,sha256=PSF5akKxVosLOXQ_Kb75PO8u1Lrm2Zj6OnRT5-U6VE8,2646
 veadk/a2a/ve_task_store.py,sha256=rxwQ-j7Ffe4LnLwpKbweQk4ofwMQx9UL6k3zaDrFIXg,1234
-veadk/agents/loop_agent.py,sha256=iGLG86HeIFicmJc9jauSPr974CjywGlmWjtfjU6CO44,2025
-veadk/agents/parallel_agent.py,sha256=XmobJHMONvsFyaaDSlnaPW9DbtHkX84X9Kvky1Ns04M,2266
-veadk/agents/sequential_agent.py,sha256=5sG-m0BqC3mU73Vx-PmG-4ags76J0iIvP70SiHaozao,2061
+veadk/agents/loop_agent.py,sha256=GNnbcXPqpf1znmArlkNAoNshLYuv0xYzl15ctpsSenI,2851
+veadk/agents/parallel_agent.py,sha256=Db020GXwLfllyQAlxYzvOmDzRNeT6WduQSEJ5PkM3L4,3064
+veadk/agents/sequential_agent.py,sha256=suotuWjDI6LGTxXSsFGSRVs5pl0NFD0-FoB86zatlUo,2839
 veadk/auth/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/auth/base_auth.py,sha256=Iwp6QAuFrJNxqXSolXkIRlK8krS0FjQKpx_fVjF-2b8,789
 veadk/auth/veauth/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
-veadk/auth/veauth/apmplus_veauth.py,sha256=zuUg8fEdvYCFUBNN5VrpSQo8IcA_L02bvTy5qVllZWM,2052
-veadk/auth/veauth/ark_veauth.py,sha256=K3n5nI8R-PtL5TssiX5CFOSdsUQagTOpVvjC9OoyiFA,2279
+veadk/auth/veauth/apmplus_veauth.py,sha256=pZb-6ILfyRdOtq6w9vGVzjA2oUyh1dUE5dTwG8jN5CU,1970
+veadk/auth/veauth/ark_veauth.py,sha256=4t9JEWws9rt4UfbdT75g9YFx0iyluagU0jEVbaAtHSU,2363
 veadk/auth/veauth/base_veauth.py,sha256=y8H_1a_gldt6hDHGBjYDc4xI7IhguNxMGONt_kx5Snc,1519
 veadk/auth/veauth/cozeloop_veauth.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/auth/veauth/opensearch_veauth.py,sha256=nJ8n3Ru4uyTM4yZx4OvmnzLmjbP66kU7hyFjD3_ZbAM,2580
 veadk/auth/veauth/postgresql_veauth.py,sha256=oxi9KH78qc-36yQI90aqO24cCuGdFt3HBApxAf8czEA,2580
 veadk/auth/veauth/prompt_pilot_veauth.py,sha256=cls1LK2Un4cOMfHdaAqRhDHIXuk7cTuAThojEF5tHKo,1913
-veadk/auth/veauth/utils.py,sha256=cVEKWQZeX5fzx3JLB1odv59D8lhOAF1Pb3rsgO6evmM,2152
+veadk/auth/veauth/utils.py,sha256=XCDznHfxXHirJOW-9iFkqgzcejgZm0qOfunTJ0BGxmQ,2500
 veadk/auth/veauth/vesearch_veauth.py,sha256=rgup3VBbRSLligrsDFOEwpneq1BEtFwf9xpgNFWHKqc,2008
+veadk/auth/veauth/viking_mem0_veauth.py,sha256=V8Jhr6M3CB2V41oe5KoMozgHFAERC3TJ9U87K-FgBtk,2922
 veadk/cli/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
-veadk/cli/cli.py,sha256=Iti595PE0g_R04njivyl0_fgNlPEYhCP-9j9ZkN80vQ,1496
-veadk/cli/cli_create.py,sha256=CSDGMSEgWVo87_mTlbCP_J1u2h-29QuYJhB07_PrD44,3302
-veadk/cli/cli_deploy.py,sha256=-P4PmXLGByypXGksshBT7BQ0U42hIvlHibXd_k4YfhQ,5328
-veadk/cli/cli_eval.py,sha256=TVSraCTyTxo_pLu5fhtk3TiZUOZkN3G2BLam1ybFXBc,5446
-veadk/cli/cli_init.py,sha256=f2A3RwUj9pApmUTl6FHmMwTTwyKl83pkvZRorTgl-XM,3982
-veadk/cli/cli_kb.py,sha256=SmLz3g6o2LiPa6WzkdyAOExuboHkpAIrN-4qaH4rxn8,1962
-veadk/cli/cli_pipeline.py,sha256=6FV4WyoapFPAy_P3dzrRm07m6aGjrtLiY4aCFT7CEHs,7510
-veadk/cli/cli_prompt.py,sha256=atw6O3zkjD1tOsFOOg7rs9HbS4exwaNe_Pces6CoyFY,2582
-veadk/cli/cli_uploadevalset.py,sha256=RdelvbXEBalXGxHnPJ-8ZQ1PRiex39328yhAWgZ5mAI,4342
-veadk/cli/cli_web.py,sha256=B8VQVqEH05XoJYYcGT9FKBHItQ1Wd6BhWuNZv9_1YEA,3992
+veadk/cli/cli.py,sha256=BvOgNsn8zub_ya4XV5tgbEf_YBHb3W_cmCtf-uXb6vw,1697
+veadk/cli/cli_create.py,sha256=9L4pmDFMJ0f501EhCrTAL0mSZHVEdb_e0rlqUpfGXrM,6165
+veadk/cli/cli_deploy.py,sha256=TppjVwlm4wbapw25jgorlvMOObEHDyZahnJEsGuxLF0,7311
+veadk/cli/cli_eval.py,sha256=VZWdQkdKIbL7g2fLGgK8IRyw_GhSfrtEpNUFfWh8kEU,8653
+veadk/cli/cli_init.py,sha256=7KcGkdt7nZuih-QbanO7pG-n-PsyB5PAqZFwVCf7uPg,6138
+veadk/cli/cli_kb.py,sha256=8o0faQrx_wT38-cDBz1jRT2Qh1jskqGQaNKaB69MU88,4207
+veadk/cli/cli_pipeline.py,sha256=M4nFjeyMaQRglZY5V5-IJQM2WoKMXq0olPC8khhnpkc,11384
+veadk/cli/cli_prompt.py,sha256=tJgWWWcIL8ieCS_W5EIjI20VSZ637ZpKSLAXuf9Va8I,3268
+veadk/cli/cli_uploadevalset.py,sha256=OgQfLEZ8uLyt4oRR6_30nvy1vELWkNagc_8sl5tEmsY,5243
+veadk/cli/cli_web.py,sha256=d_0O97Ikh92deBki93Q6-XvmwQDP5ZKg_3ZBSUA8kNM,5236
 veadk/cloud/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
-veadk/cloud/cloud_agent_engine.py,sha256=u-v-kkAhRgZY1r82CQRwfkYnj0n7ft8qIW_r-yhnMSI,8461
-veadk/cloud/cloud_app.py,sha256=2bmEf7RH1Kwz8HLZ0aY3pVn0R8xi1T7kcGRTRyaWawY,8746
+veadk/cloud/cloud_agent_engine.py,sha256=qqSwqh5GBGA6Z-0fKzCHqVDzSGHYVcvoClphalOwo8s,13018
+veadk/cloud/cloud_app.py,sha256=fTtIjZWLOZiRsZfl-lLNuFAtt1zeaNlxm2a7mJslgns,15760
 veadk/configs/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
-veadk/configs/database_configs.py,sha256=oOqPlpyCR2QmGZ3fxm3t-UoeXK4T3ux7nw6rDevhxNE,2916
-veadk/configs/model_configs.py,sha256=izAbuM7i2GgOBsGNr3MEs574KTHMOIP3Vm5tlN7STOg,2378
+veadk/configs/database_configs.py,sha256=HB2mcEf98YZl1blYy4cENS0vJw8eq4QIJCCBFoQUzZk,2968
+veadk/configs/model_configs.py,sha256=1Fx_sDpbGsnUqhZtVOBqf6bAn4F6dGVBMQf3DPGsByU,2498
 veadk/configs/tool_configs.py,sha256=1BR7-D7mIHug8gI1SEN6_1bUfhXAl1JTZRfvGdfqg0c,1453
-veadk/configs/tracing_configs.py,sha256=bwfi4JjKvdTjEwbaSVOdnWetcA72vgPiaF5odUlI9gI,3489
+veadk/configs/tracing_configs.py,sha256=IhHtEKryqh6xh4ZIqhENeuK41J7Ko-ZmoU_xrgSCKIE,3491
 veadk/evaluation/__init__.py,sha256=Pwnv6x-QaQQiv4J_QNnR-Asl7wN0laF92EX9n0Sll1U,713
-veadk/evaluation/base_evaluator.py,sha256=FYv_OQcBbYdODnpuY4QW_DF_HKuUfby-mL3_dhazxt0,15247
-veadk/evaluation/eval_set_file_loader.py,sha256=AkKZpLXKdHve6SLDl4HJDRbBsTBXFyFgC8iykscJOf4,1130
-veadk/evaluation/eval_set_recorder.py,sha256=B2Pq6htd_4965uMQFUSxtBOh6WwXJGUSk_2dwk1nxzU,3167
-veadk/evaluation/types.py,sha256=YxRkPBGpUtZuP7lsnXEpCoU4_HqY2DeCdjMXk7ZPgEE,954
+veadk/evaluation/base_evaluator.py,sha256=S9kB184J-qLXKeZnhGYv_njFzqtf4-QvCJDFLwNJixA,21798
+veadk/evaluation/eval_set_file_loader.py,sha256=KDFj9D-1wU6_xwUPBjn1EpC-CbEuMuVkx0pP5EeS8hQ,1678
+veadk/evaluation/eval_set_recorder.py,sha256=QYkTIId6i0fr65LkSMmUp4bLPErug6tkM2-HjW_G_KE,5068
+veadk/evaluation/types.py,sha256=Nh4DQx1f7a8Tbr1zHGWJzr1qI0dFimhtsE_u6jbwGa0,2023
 veadk/evaluation/adk_evaluator/__init__.py,sha256=t_vAjCiA6PD7oIWJ9qx_vWnvbytN_Ha5Jfs3ZWjdzyY,703
-veadk/evaluation/adk_evaluator/adk_evaluator.py,sha256=xHoATLG61Ox9xEwyw3wWuGkVskRki18DtE33qnY4H2Y,11026
+veadk/evaluation/adk_evaluator/adk_evaluator.py,sha256=de3VJMedwVOt6LzzVUxrGjSJMAsqHf0V2pOmKOTf0JQ,12911
 veadk/evaluation/deepeval_evaluator/__init__.py,sha256=lLGtRvWhwDy4u7hmtZxZbPmdMzM58pSjEwEF34NqW-4,718
-veadk/evaluation/deepeval_evaluator/deepeval_evaluator.py,sha256=cI2XdJVzGfFdJPOmT5NCYJdLourtgtf4KqKTlUMvYWA,8870
-veadk/evaluation/utils/prometheus.py,sha256=6i_HuGqqh3cRDwjZCtk4i37iN_IGqRg0YJRQMSp1kaU,3836
+veadk/evaluation/deepeval_evaluator/deepeval_evaluator.py,sha256=tnawft5bNWmfMLHlkrM_QCKXf3bWNvtWBdh_p37EGpU,13137
+veadk/evaluation/utils/prometheus.py,sha256=R_hsB_G3IM6n5sCfL0-QtGLJ-6z_ZR-eh0U92ROmHao,6415
 veadk/integrations/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/integrations/ve_apig/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/integrations/ve_apig/ve_apig.py,sha256=B4yPiNTGeXKFdji8RHWrCKmv0RomhfbCKgHM3IhaziU,8931
@@ -111,22 +112,22 @@ veadk/integrations/ve_viking_db_memory/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL4
 veadk/integrations/ve_viking_db_memory/ve_viking_db_memory.py,sha256=gX5asox3VDra6o1BIg7AickPec0-Vj8_lgZ1zz5ue5Y,10165
 veadk/knowledgebase/__init__.py,sha256=k-5WM0DAqNq94Dg64Rl12ozoS1BnE9i-MY_ZOR2s2CQ,705
 veadk/knowledgebase/entry.py,sha256=j6VsXRAyjZryIFntnoNfjbH8fsD9_fDSjoHIL5h0Y1U,917
-veadk/knowledgebase/knowledgebase.py,sha256=gfHBxmfAGTFc1y13PMpB455G3YW0qE1zHjiUPM9iS3s,5642
+veadk/knowledgebase/knowledgebase.py,sha256=KV7gzJ7nnGEVx0E4pf_X3xpXcKyNu9Gz19y9caE-U4g,10828
 veadk/knowledgebase/backends/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
-veadk/knowledgebase/backends/base_backend.py,sha256=gqkJNIASc-ZrJ2e4enIeUvI9CWucCn2OZX-bb5hyTPw,2104
-veadk/knowledgebase/backends/in_memory_backend.py,sha256=uC4_LCkjp9DFQzTgTKzEr6yw1hcNUpZ0h7WSR0fpifc,3332
-veadk/knowledgebase/backends/opensearch_backend.py,sha256=4oChkqd25RvL460p1-D7noxQIoZVlD03aB61pKREqNw,4953
-veadk/knowledgebase/backends/redis_backend.py,sha256=pc-T_QicyAmOp6KbMz0V8iIL1ZlKCKQpdNB9SkaNqm8,5226
+veadk/knowledgebase/backends/base_backend.py,sha256=VTI2xN5S963UfX8QrgJkd52LmCNT3tsBaDP7MefBL7U,2369
+veadk/knowledgebase/backends/in_memory_backend.py,sha256=juBlqKhlsHl0W9FHnV0j3hJo-Ix5ossPvkG0xEtbX4Q,3662
+veadk/knowledgebase/backends/opensearch_backend.py,sha256=ZSOb3UrEMnSiMl79kGbyCO-uX3aIoFh1sak8hBn2aT8,5723
+veadk/knowledgebase/backends/redis_backend.py,sha256=vgkEbqXoMEkGVS-eUHglmBPPEizHvRisHkHEUmDJX4w,5970
 veadk/knowledgebase/backends/utils.py,sha256=383La0fsmPcbJEpGWk54EP8p8QO1SP_ThqJPmRWa5Rs,2705
-veadk/knowledgebase/backends/vikingdb_knowledge_backend.py,sha256=khk33XDDdeK1tb84lHtTAjtuZQLmubZFo3shyd70YLs,19245
+veadk/knowledgebase/backends/vikingdb_knowledge_backend.py,sha256=nVzj-oMxZZ3R5XWOKy_ILxyV2Vs4FeoxczRqr-UA8RQ,20500
 veadk/memory/__init__.py,sha256=GRIoRqapS2gUtRMB9JZvodU29PwMxFe2KDjPnVpqib0,1252
-veadk/memory/long_term_memory.py,sha256=122uacyNsKkUIfsc5Vru8lMGsJKE0A7JJqddLaxX-ls,7838
-veadk/memory/short_term_memory.py,sha256=MLR2Op_l_Zr-ZKCJ7pyNhe_OzPG06Zcb8pt8qA_zrFY,4922
+veadk/memory/long_term_memory.py,sha256=VFuRhUBz9-XiSh2miZsGy2jOFy_mO7-0UKOCt99OvxU,13214
+veadk/memory/short_term_memory.py,sha256=JxrIsYlX7DiyIxj5_gDenTzyBWZsAnRZaMl38euPZQw,9093
 veadk/memory/short_term_memory_processor.py,sha256=vqmYSUNFGXEogJ8ZxIAhSSrv66LGT8eEHCzxF9h07LA,3276
 veadk/memory/long_term_memory_backends/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/memory/long_term_memory_backends/base_backend.py,sha256=FDBBUCLEfe8bxkpra1FFGieZZFT_YC8B3kdHx9pKgwo,1223
 veadk/memory/long_term_memory_backends/in_memory_backend.py,sha256=0IKRqstS3Rtm8ePf55XpfLhIjomIGep3SwwlUZ4PFvY,2714
-veadk/memory/long_term_memory_backends/mem0_backend.py,sha256=sj6OxMHA4oG6kuzTMK5zsGEIIa0-ESPrRYv6dR3KI8E,4869
+veadk/memory/long_term_memory_backends/mem0_backend.py,sha256=5F2DVhQk4q8MexpYXQdamYreD2exiNaXzeu8BMYFpzc,5409
 veadk/memory/long_term_memory_backends/opensearch_backend.py,sha256=u5odPUv0fchH3IsZNTH0-nNpdW4KwkWojRQi3cn52Wo,4567
 veadk/memory/long_term_memory_backends/redis_backend.py,sha256=0XX21AJA4UwEqrteXdgOr5WAfuo31wK1fMLUtXMssfg,5262
 veadk/memory/long_term_memory_backends/vikingdb_memory_backend.py,sha256=TfAtQXiJ-iZLRKPTBMakQTwRoHdDsN0l2R5udNFJatY,6683
@@ -149,42 +150,43 @@ veadk/tools/builtin_tools/image_edit.py,sha256=KslsuabBchAYR3ZrWSO5viEe5ORUAe0GI
 veadk/tools/builtin_tools/image_generate.py,sha256=frBUYEmizq6B4cRIUTfWKpLF2RywposJf-hZ8kkZvV8,18075
 veadk/tools/builtin_tools/lark.py,sha256=b2IWsN8fZFh9aweSGznaOqA30TCOLpVjNCDNa1LHZl4,2046
 veadk/tools/builtin_tools/las.py,sha256=rgKfnK5GsHVbmkp-rc7rtCvWg-yYNxMjeV0ayCyRpjM,913
+veadk/tools/builtin_tools/llm_shield.py,sha256=ErT7FcweH855D36zpx98ppbwLRA-uUx_u06HdxZ-Tgc,14396
 veadk/tools/builtin_tools/load_knowledgebase.py,sha256=Xqtq25DL720goRegCVmmkpH2Ye2VWLcrF5ncC37gK_Y,3427
-veadk/tools/builtin_tools/mcp_router.py,sha256=l3xcIHAHQ0AGCZG3mYyhwM0btqEMDe4TY2S-UYUM8M0,883
-veadk/tools/builtin_tools/run_code.py,sha256=aPfhXepk0-JJDslcAOs07OW0JNr4YAQ8fh6ZpmNUHLs,2888
+veadk/tools/builtin_tools/mcp_router.py,sha256=Sn32NhtCxMWMKSVWaNStXL28oPz5fzDkR1xsf-vfTUk,1061
+veadk/tools/builtin_tools/run_code.py,sha256=ay9L9YmbNGdhowof85dZx-uqXL8nbL9NQfHtYvMVYjI,3730
 veadk/tools/builtin_tools/vesearch.py,sha256=prPP0w6lYeIEPwuZdmV00RAzaW4MeH8lYtK-NluaXtU,1748
 veadk/tools/builtin_tools/video_generate.py,sha256=hlvwoLESUV8vOPiNFVNPF0ithWqH7N5c6ElMvyI-lBM,16101
 veadk/tools/builtin_tools/web_scraper.py,sha256=iVnxWVf2mVgOnEOeQ6Bg5ATYN-g1ZPCTK6VJm710be0,2408
-veadk/tools/builtin_tools/web_search.py,sha256=1DtdhlcxolzIvx2TyqvUNWk60BHMuLkcru8Wlw3XBtQ,6016
+veadk/tools/builtin_tools/web_search.py,sha256=ba5UMZIAQl-BTvjty2zEwroNWAnIeWOiuR8W1DJd_oQ,2739
 veadk/tools/sandbox/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/tools/sandbox/browser_sandbox.py,sha256=2YxGM8BIQ1uCY73FDfkWWq72cOCFbp6YLsXIqRWEoSM,1172
 veadk/tools/sandbox/code_sandbox.py,sha256=iOB7XxJxbckmnXOOUwzQ5t_0Tq1IA3JITEywKB6t7oM,1244
 veadk/tools/sandbox/computer_sandbox.py,sha256=e0d3pwaxBbLLihK-rFv2tUU7bmAwPTvSphr2fC9bJBo,1150
 veadk/tracing/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
-veadk/tracing/base_tracer.py,sha256=AQQopQ81Y1dGt3BF1iT8el5iSJC7HH5NrW9sU9R92v8,1098
+veadk/tracing/base_tracer.py,sha256=6jAPOm1rQyAmCIvvegaytm2BYHL5cbhP3pOenaLdBVM,2246
 veadk/tracing/telemetry/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
-veadk/tracing/telemetry/opentelemetry_tracer.py,sha256=4T9KxoSLbhzk1psErHwz2cWXHAMJcNzl9OXj_iCkcPs,7851
-veadk/tracing/telemetry/telemetry.py,sha256=qM7Y9UlxTk78Z8inigtDZEoSSsUCY7b1nOmTWfVQ1mA,11033
+veadk/tracing/telemetry/opentelemetry_tracer.py,sha256=J6ZlwpUHJa5i8bQFepOWicp7JHB2KYSUEkwlGTQafQo,12522
+veadk/tracing/telemetry/telemetry.py,sha256=MeMQLHlYOdAW8F2OCatoVxWeCK5I_Vkg4KutLb6wrbk,15870
 veadk/tracing/telemetry/attributes/attributes.py,sha256=t08vbKenendKdlUrs3Q94p5F8TZEjh-oewBE5ABWDsE,1074
-veadk/tracing/telemetry/attributes/extractors/common_attributes_extractors.py,sha256=AcJEw9RFQskK0l9rii7BZJPJa-peHJtrWt8Ge0R5fLU,2753
-veadk/tracing/telemetry/attributes/extractors/llm_attributes_extractors.py,sha256=Zb8hf_Jvp9OT6g2v_5dRssk9XJJSow_DOd9lhBMCfMo,25964
-veadk/tracing/telemetry/attributes/extractors/tool_attributes_extractors.py,sha256=taCVwXY1W8P0N5mZJish2yro0OMG1R_DUgUPu7YFNKQ,3044
-veadk/tracing/telemetry/attributes/extractors/types.py,sha256=ggyB2I42B6I5YqymqF7s8znFFu1rp887E6Gq4gXSEJ8,3077
+veadk/tracing/telemetry/attributes/extractors/common_attributes_extractors.py,sha256=L2Xtj5A5SMW_wBjSSUpM5-vA81pOHXqie8-r8FBS35A,6062
+veadk/tracing/telemetry/attributes/extractors/llm_attributes_extractors.py,sha256=p48ak28tQV2-Wi5xvgRocgGV1r_bhGPIF9nPqypKlS0,34681
+veadk/tracing/telemetry/attributes/extractors/tool_attributes_extractors.py,sha256=7KtjmbqfcG6MvwIb0d7DFpP4f9Lg8v53_cyAnGCnZzU,5479
+veadk/tracing/telemetry/attributes/extractors/types.py,sha256=ZIxX6u0Evp5a7Lxy1fkmmZY4CHYhF12EDjVdFabW-_k,6867
 veadk/tracing/telemetry/exporters/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
-veadk/tracing/telemetry/exporters/apmplus_exporter.py,sha256=i_bFp4IvsTkRNQn0ZGSlDYF1e9tSYE_Y7aRKefkBbXk,14156
-veadk/tracing/telemetry/exporters/base_exporter.py,sha256=uwYhOI2xP8JDjYc99S2zolYSzjh7lgwHT0T8O4XB5Po,1184
-veadk/tracing/telemetry/exporters/cozeloop_exporter.py,sha256=khDCU_fMB5mPDgzGSRmxmD8K66GSvW1J4DcdLorYWWc,2498
-veadk/tracing/telemetry/exporters/inmemory_exporter.py,sha256=wgcXpoPqi-JQirMeqLMdVKvg1u42UYXt1cN7LpyXcFA,4952
-veadk/tracing/telemetry/exporters/tls_exporter.py,sha256=YODDfqZJKq3SiuDqxjERuJoOAuGErurjl_zFZr8TiGg,2674
+veadk/tracing/telemetry/exporters/apmplus_exporter.py,sha256=WELMQxuxbNQ3LYkJvTEfdFlUBYId3rZ8tWzHIlmMJMA,21038
+veadk/tracing/telemetry/exporters/base_exporter.py,sha256=RR5Q_6K_SB6RC11GF6xOaR1HFn0LjqeBlf9557PAhEw,1538
+veadk/tracing/telemetry/exporters/cozeloop_exporter.py,sha256=oR6egen8SRm4PvyloGMsabni_-ejRVoA3lcdASNqoA4,4969
+veadk/tracing/telemetry/exporters/inmemory_exporter.py,sha256=fpURcnfgZKak9fVbzXMghKrVFRm-K1ZY2eO9PMZm5Ao,9697
+veadk/tracing/telemetry/exporters/tls_exporter.py,sha256=03OkGJg-i3DzZp4u7CyPuZ0h7rLt6oYbLqR4PUDxkeQ,5398
 veadk/utils/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/utils/logger.py,sha256=e4swzeXa-qZ1U2-TDBtfKOurzy4_6t4qPJR9yngNfVg,1605
 veadk/utils/mcp_utils.py,sha256=aET7pX3LXmRe2-Jh7_xRvxrVyl1dN7uPAUk16luwMlQ,1525
 veadk/utils/misc.py,sha256=wtAKfTFXWhBeQWQYxsrW0KuI63bdDxQag0izKJvkW-E,5172
 veadk/utils/patches.py,sha256=dcHdlJ8IciyMjDuMy6-_6McUqJYyLz0yHmJ0xH8lWOw,2752
 veadk/utils/volcengine_sign.py,sha256=3xn6ca2OAg_AFyP2dqFTSioqkeDel_BoKURUtCcO-EQ,6736
-veadk_python-0.2.16.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-veadk_python-0.2.16.dist-info/METADATA,sha256=LsRvQPbx3f1I8TOQdCqCRIX3FqgE5xu2iDCYP2NyoiI,18428
-veadk_python-0.2.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-veadk_python-0.2.16.dist-info/entry_points.txt,sha256=-g28D6dNV-2UvAiRP9VF0oOVSDSJ5zlLUIZ34ArAqF8,46
-veadk_python-0.2.16.dist-info/top_level.txt,sha256=Qqi3ycJ4anKiZWBXtUBIy8zK9ZuXJsFa05oFq8O8qqY,6
-veadk_python-0.2.16.dist-info/RECORD,,
+veadk_python-0.2.17.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+veadk_python-0.2.17.dist-info/METADATA,sha256=5-uodNWlKzdrTR7XzW6hvCslXr7mqSSJ7pyoMY30QVc,18428
+veadk_python-0.2.17.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+veadk_python-0.2.17.dist-info/entry_points.txt,sha256=-g28D6dNV-2UvAiRP9VF0oOVSDSJ5zlLUIZ34ArAqF8,46
+veadk_python-0.2.17.dist-info/top_level.txt,sha256=Qqi3ycJ4anKiZWBXtUBIy8zK9ZuXJsFa05oFq8O8qqY,6
+veadk_python-0.2.17.dist-info/RECORD,,