veadk-python 0.2.9__py3-none-any.whl → 0.2.11__py3-none-any.whl

veadk/tracing/telemetry/exporters/apmplus_exporter.py

@@ -17,8 +17,10 @@ from dataclasses import dataclass
 from typing import Any
 
 from google.adk.agents.invocation_context import InvocationContext
+from google.adk.events import Event
 from google.adk.models.llm_request import LlmRequest
 from google.adk.models.llm_response import LlmResponse
+from google.adk.tools import BaseTool
 from opentelemetry import metrics, trace
 from opentelemetry import metrics as metrics_api
 from opentelemetry.exporter.otlp.proto.grpc.metric_exporter import OTLPMetricExporter
@@ -124,6 +126,12 @@ class Meters:
         "gen_ai.chat_completions.streaming_time_per_output_token"
     )
 
+    # apmplus metrics
+    # span duration
+    APMPLUS_SPAN_LATENCY = "apmplus_span_latency"
+    # tool token usage
+    APMPLUS_TOOL_TOKEN_USAGE = "apmplus_tool_token_usage"
+
 
 class MeterUploader:
     def __init__(
@@ -195,7 +203,21 @@ class MeterUploader:
             explicit_bucket_boundaries_advisory=_GEN_AI_SERVER_TIME_PER_OUTPUT_TOKEN_BUCKETS,
         )
 
-    def record(
+        # apmplus metrics for veadk dashboard
+        self.apmplus_span_latency = self.meter.create_histogram(
+            name=Meters.APMPLUS_SPAN_LATENCY,
+            description="Latency of span",
+            unit="s",
+            explicit_bucket_boundaries_advisory=_GEN_AI_CLIENT_OPERATION_DURATION_BUCKETS,
+        )
+        self.apmplus_tool_token_usage = self.meter.create_histogram(
+            name=Meters.APMPLUS_TOOL_TOKEN_USAGE,
+            description="Token consumption of APMPlus tool token",
+            unit="count",
+            explicit_bucket_boundaries_advisory=_GEN_AI_CLIENT_TOKEN_USAGE_BUCKETS,
+        )
+
+    def record_call_llm(
         self,
         invocation_context: InvocationContext,
         event_id: str,
@@ -205,7 +227,8 @@ class MeterUploader:
         attributes = {
             "gen_ai_system": "volcengine",
             "gen_ai_response_model": llm_request.model,
-            "gen_ai_operation_name": "chat_completions",
+            "gen_ai_operation_name": "chat",
+            "gen_ai_operation_type": "llm",
             "stream": "false",
             "server_address": "api.volcengine.com",
         }  # required by Volcengine APMPlus
@@ -267,6 +290,63 @@ class MeterUploader:
             #         time_per_output_token, attributes=attributes
             #     )
 
+            # add span name attribute
+            span = trace.get_current_span()
+            if not span:
+                return
+
+            # record span latency
+            if hasattr(span, "start_time") and self.apmplus_span_latency:
+                # span 耗时
+                duration = (time.time_ns() - span.start_time) / 1e9  # type: ignore
+                self.apmplus_span_latency.record(duration, attributes=attributes)
+
+    def record_tool_call(
+        self,
+        tool: BaseTool,
+        args: dict[str, Any],
+        function_response_event: Event,
+    ):
+        logger.debug(f"Record tool call work in progress. Tool: {tool.name}")
+        span = trace.get_current_span()
+        if not span:
+            return
+        operation_type = "tool"
+        operation_name = tool.name
+        operation_backend = ""
+        if tool.custom_metadata:
+            operation_backend = tool.custom_metadata.get("backend", "")
+
+        attributes = {
+            "gen_ai_operation_name": operation_name,
+            "gen_ai_operation_type": operation_type,
+            "gen_ai_operation_backend": operation_backend,
+        }
+
+        if hasattr(span, "start_time") and self.apmplus_span_latency:
+            # span 耗时
+            duration = (time.time_ns() - span.start_time) / 1e9  # type: ignore
+            self.apmplus_span_latency.record(duration, attributes=attributes)
+
+        if self.apmplus_tool_token_usage and hasattr(span, "attributes"):
+            tool_input = span.attributes["gen_ai.tool.input"]
+            tool_token_usage_input = (
+                len(tool_input) / 4
+            )  # tool token 数量，使用文本长度/4
+            input_tool_token_attributes = {**attributes, "token_type": "input"}
+            self.apmplus_tool_token_usage.record(
+                tool_token_usage_input, attributes=input_tool_token_attributes
+            )
+
+            tool_output = span.attributes["gen_ai.tool.output"]
+            tool_token_usage_output = (
+                len(tool_output) / 4
+            )  # tool token 数量，使用文本长度/4
+            output_tool_token_attributes = {**attributes, "token_type": "output"}
+            self.apmplus_tool_token_usage.record(
+                tool_token_usage_output, attributes=output_tool_token_attributes
+            )
+
 
 class APMPlusExporterConfig(BaseModel):
     endpoint: str = Field(

veadk/tracing/telemetry/exporters/inmemory_exporter.py

@@ -79,14 +79,20 @@ class _InMemorySpanProcessor(export.SimpleSpanProcessor):
     def on_start(self, span, parent_context) -> None:
         if span.name.startswith("invocation"):
             span.set_attribute("gen_ai.operation.name", "chain")
+            span.set_attribute("gen_ai.span.kind", "workflow")
             span.set_attribute("gen_ai.usage.total_tokens", 0)
-
             ctx = set_value("invocation_span_instance", span, context=parent_context)
+            # suppress instrumentation for llm to avoid auto instrument from apmplus, such as openai
+            ctx = set_value(
+                "suppress_language_model_instrumentation", True, context=ctx
+            )
+
             token = attach(ctx)  # mount context on `invocation` root span in Google ADK
             setattr(span, "_invocation_token", token)  # for later detach
 
-        if span.name.startswith("agent_run"):
+        if span.name.startswith("agent_run") or span.name.startswith("invoke_agent"):
             span.set_attribute("gen_ai.operation.name", "agent")
+            span.set_attribute("gen_ai.span.kind", "agent")
 
             ctx = set_value("agent_run_span_instance", span, context=parent_context)
             token = attach(ctx)

veadk/tracing/telemetry/telemetry.py

@@ -30,11 +30,14 @@ from veadk.tracing.telemetry.attributes.extractors.types import (
     ToolAttributesParams,
 )
 from veadk.utils.logger import get_logger
+from veadk.utils.misc import safe_json_serialize
 
 logger = get_logger(__name__)
 
+meter_uploader = None
 
-def _upload_metrics(
+
+def _upload_call_llm_metrics(
     invocation_context: InvocationContext,
     event_id: str,
     llm_request: LlmRequest,
@@ -47,11 +50,27 @@ def _upload_metrics(
         for tracer in tracers:
             for exporter in getattr(tracer, "exporters", []):
                 if getattr(exporter, "meter_uploader", None):
-                    exporter.meter_uploader.record(
+                    global meter_uploader
+                    meter_uploader = exporter.meter_uploader
+                    exporter.meter_uploader.record_call_llm(
                         invocation_context, event_id, llm_request, llm_response
                     )
 
 
+def _upload_tool_call_metrics(
+    tool: BaseTool,
+    args: dict[str, Any],
+    function_response_event: Event,
+):
+    global meter_uploader
+    if meter_uploader:
+        meter_uploader.record_tool_call(tool, args, function_response_event)
+    else:
+        logger.warning(
+            "Meter uploader is not initialized yet. Skip recording tool call metrics."
+        )
+
+
 def _set_agent_input_attribute(
     span: Span, invocation_context: InvocationContext
 ) -> None:
@@ -73,6 +92,11 @@ def _set_agent_input_attribute(
 
     user_content = invocation_context.user_content
     if user_content and user_content.parts:
+        # set gen_ai.input attribute required by APMPlus
+        span.set_attribute(
+            "gen_ai.input",
+            safe_json_serialize(user_content.model_dump(exclude_none=True)),
+        )
         span.add_event(
             "gen_ai.user.message",
             {
@@ -110,6 +134,11 @@ def _set_agent_input_attribute(
 def _set_agent_output_attribute(span: Span, llm_response: LlmResponse) -> None:
     content = llm_response.content
     if content and content.parts:
+        # set gen_ai.output attribute required by APMPlus
+        span.set_attribute(
+            "gen_ai.output", safe_json_serialize(content.model_dump(exclude_none=True))
+        )
+
         for idx, part in enumerate(content.parts):
             if part.text:
                 span.add_event(
@@ -155,10 +184,15 @@ def set_common_attributes_on_model_span(
                 current_step_token_usage + int(prev_total_token_usage)  # type: ignore
             )  # we can ignore this warning, cause we manually set the attribute to int before
             invocation_span.set_attribute(
-                "gen_ai.usage.total_tokens", accumulated_total_token_usage
+                # record input/output token usage?
+                "gen_ai.usage.total_tokens",
+                accumulated_total_token_usage,
             )
 
-        if agent_run_span and agent_run_span.name.startswith("agent_run"):
+        if agent_run_span and (
+            agent_run_span.name.startswith("agent_run")
+            or agent_run_span.name.startswith("invoke_agent")
+        ):
             _set_agent_input_attribute(agent_run_span, invocation_context)
             _set_agent_output_attribute(agent_run_span, llm_response)
             for attr_name, attr_extractor in common_attributes.items():
@@ -203,6 +237,8 @@ def trace_tool_call(
         response: ExtractorResponse = attr_extractor(params)
         ExtractorResponse.update_span(span, attr_name, response)
 
+    _upload_tool_call_metrics(tool, args, function_response_event)
+
 
 def trace_call_llm(
     invocation_context: InvocationContext,
@@ -252,7 +288,7 @@ def trace_call_llm(
         response: ExtractorResponse = attr_extractor(params)
         ExtractorResponse.update_span(span, attr_name, response)
 
-    _upload_metrics(invocation_context, event_id, llm_request, llm_response)
+    _upload_call_llm_metrics(invocation_context, event_id, llm_request, llm_response)
 
 
 # Do not modify this function

veadk/utils/misc.py

@@ -36,18 +36,14 @@ def formatted_timestamp() -> str:
     return time.strftime("%Y%m%d%H%M%S", time.localtime())
 
 
-def read_png_to_bytes(png_path: str) -> bytes:
-    # Determine whether it is a local file or a network file
-    if png_path.startswith(("http://", "https://")):
-        # Network file: Download via URL and return bytes
-        response = requests.get(png_path)
-        response.raise_for_status()  # Check if the HTTP request is successful
+def read_file_to_bytes(file_path: str) -> bytes:
+    if file_path.startswith(("http://", "https://")):
+        response = requests.get(file_path)
+        response.raise_for_status()
         return response.content
     else:
-        # Local file
-        with open(png_path, "rb") as f:
-            data = f.read()
-    return data
+        with open(file_path, "rb") as f:
+            return f.read()
 
 
 def load_module_from_file(module_name: str, file_path: str) -> types.ModuleType:

veadk/utils/volcengine_sign.py

@@ -144,6 +144,8 @@ def request(method, date, query, header, ak, sk, action, body):
         )
     )
     header = {**header, **sign_result}
+    if "X-Security-Token" in header and header["X-Security-Token"] == "":
+        del header["X-Security-Token"]
     # header = {**header, **{"X-Security-Token": SessionToken}}
     # 第六步：将 Signature 签名写入 HTTP Header 中，并发送 HTTP 请求。
     r = requests.request(

veadk/version.py

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

{veadk_python-0.2.9.dist-info → veadk_python-0.2.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: veadk-python
-Version: 0.2.9
+Version: 0.2.11
 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
@@ -218,7 +218,7 @@ Requires-Dist: opentelemetry-exporter-otlp>=1.35.0
 Requires-Dist: opentelemetry-instrumentation-logging>=0.56b0
 Requires-Dist: wrapt>=1.17.2
 Requires-Dist: openai<1.100
-Requires-Dist: volcengine-python-sdk>=4.0.3
+Requires-Dist: volcengine-python-sdk>=4.0.18
 Requires-Dist: volcengine>=1.0.193
 Requires-Dist: agent-pilot-sdk>=0.1.2
 Requires-Dist: fastmcp>=2.11.3
@@ -231,16 +231,17 @@ Requires-Dist: llama-index-vector-stores-opensearch>=0.6.1
 Requires-Dist: psycopg2-binary>=2.9.10
 Requires-Dist: pymysql>=1.1.1
 Requires-Dist: opensearch-py==2.8.0
+Requires-Dist: filetype>=1.2.0
 Provides-Extra: extensions
 Requires-Dist: redis>=5.0; extra == "extensions"
 Requires-Dist: tos>=2.8.4; extra == "extensions"
 Requires-Dist: llama-index-vector-stores-redis>=0.6.1; extra == "extensions"
-Requires-Dist: mcp-server-vikingdb-memory; extra == "extensions"
 Provides-Extra: database
 Requires-Dist: redis>=5.0; extra == "database"
 Requires-Dist: pymysql>=1.1.1; extra == "database"
 Requires-Dist: volcengine>=1.0.193; extra == "database"
 Requires-Dist: tos>=2.8.4; extra == "database"
+Requires-Dist: mem0ai==0.1.118; extra == "database"
 Provides-Extra: eval
 Requires-Dist: prometheus-client>=0.22.1; extra == "eval"
 Requires-Dist: deepeval>=3.2.6; extra == "eval"

{veadk_python-0.2.9.dist-info → veadk_python-0.2.11.dist-info}/RECORD

@@ -1,14 +1,14 @@
 veadk/__init__.py,sha256=9l1lyb9ifhHQeetmIBWZnIdwUCVyMyz1EnKsKz8BBG8,1135
-veadk/agent.py,sha256=pgGHfAPwPJGSVU922H26d6cEzvi9tnxWTTiFZ_Yrnww,10835
-veadk/agent_builder.py,sha256=ilFsXFeF7kao1NPJkC-temVH4Osf_AGsXu71urdh9kc,3021
+veadk/agent.py,sha256=4ijmzPXvY9iAx4s2NqBzwJ0VEYSWiUezeP2OvQFO9ek,11108
+veadk/agent_builder.py,sha256=HI7mRrUZ72_7i-jVzNDx1anTZHy7UxX7jr2Drxxx6j8,3031
 veadk/config.py,sha256=Ezl9Lna9iriC_Uf7m1ZXTWzylLyd7YspUFAQqh94Ong,3203
-veadk/consts.py,sha256=H63v4CLzFoRKwyOIuCiyC__FbZGofPfJkUx_YK_P-tI,2442
-veadk/runner.py,sha256=rntJEPwTZgRkGSIDdqftuUiUc3ph5hcP9lwjOdRFk-0,13525
+veadk/consts.py,sha256=LTl4NQYJf7C8EvconGa96NRschzZZmmOqxlEikJe2Nk,2831
+veadk/runner.py,sha256=_DGNwX-t3sHJFJvHs-rRHXbjCZza8I_zU8AN3Fw5nRY,14217
 veadk/types.py,sha256=zOOzG-QJy-MkzHeicWJzy2_L5U4ERrWziPubIUEbd8c,1656
-veadk/version.py,sha256=p0IyHWs5FV0Gt5cgCGziZ4AqfgelEeZ_ZsZJMRpQ4WI,653
+veadk/version.py,sha256=lWn0jlNA7mzOxPAG6V2hGLZtLsCq9qTpu_I9qSsNO6k,654
 veadk/a2a/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/a2a/agent_card.py,sha256=lhtgW1acMpxYUdULHEZwVFXOi6Xh4lNkf4S7QIhbFFI,1525
-veadk/a2a/remote_ve_agent.py,sha256=vjV28Bs8ax21Xu_u4p8g11tlxfbyFMuHw-AA1Q74kNg,1261
+veadk/a2a/remote_ve_agent.py,sha256=L2nzT8PlDI-lLtcaTJqk-D2Uvw9beKl8OEUqp-8qCbA,3510
 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
@@ -19,27 +19,29 @@ 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=qSE0ysgLqxep00oSlF7cZ8pO5pWWcelJbwdq098fPFI,2470
+veadk/auth/veauth/ark_veauth.py,sha256=K3n5nI8R-PtL5TssiX5CFOSdsUQagTOpVvjC9OoyiFA,2279
 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/vesearch_veauth.py,sha256=rgup3VBbRSLligrsDFOEwpneq1BEtFwf9xpgNFWHKqc,2008
 veadk/cli/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
-veadk/cli/cli.py,sha256=YsNaQAPAOvU0V1Qq4LD3GpbzIWrA82msLgcbhRUPI5s,1289
+veadk/cli/cli.py,sha256=lT2VGY8Mn-_eLO5ifsF7vKTW-qgiCJFDve5nc8N_YuQ,1343
 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_web.py,sha256=r6UTtkrbHXMIbJERcFhMndH7K1BfIAqQ-as74oy_HV0,6142
+veadk/cli/cli_web.py,sha256=20VwLxsLf060Gca31Pw3NH5KX9W88sIvgiPECDvY6_4,6246
 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/configs/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/configs/database_configs.py,sha256=oOqPlpyCR2QmGZ3fxm3t-UoeXK4T3ux7nw6rDevhxNE,2916
-veadk/configs/model_configs.py,sha256=Ts88m4wSXCWNr96Y92CRCey3GaOM4hGR6U1oLfOYedY,2378
+veadk/configs/model_configs.py,sha256=izAbuM7i2GgOBsGNr3MEs574KTHMOIP3Vm5tlN7STOg,2378
 veadk/configs/tool_configs.py,sha256=1BR7-D7mIHug8gI1SEN6_1bUfhXAl1JTZRfvGdfqg0c,1453
 veadk/configs/tracing_configs.py,sha256=bwfi4JjKvdTjEwbaSVOdnWetcA72vgPiaF5odUlI9gI,3489
 veadk/evaluation/__init__.py,sha256=Pwnv6x-QaQQiv4J_QNnR-Asl7wN0laF92EX9n0Sll1U,713
@@ -52,6 +54,7 @@ veadk/evaluation/adk_evaluator/adk_evaluator.py,sha256=xHoATLG61Ox9xEwyw3wWuGkVs
 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/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
 veadk/integrations/ve_apig/ve_apig_utils.py,sha256=9eL7vu51PyPAZNoBMpoaDjWRatvqbY_Bb1BaBsjz-V8,10766
@@ -102,9 +105,11 @@ veadk/integrations/ve_tls/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxP
 veadk/integrations/ve_tls/utils.py,sha256=DmWS37gSuKsUgiqlLyk1obfAAZZnEpkemQuoTDxAEG4,3769
 veadk/integrations/ve_tls/ve_tls.py,sha256=zO8rSX0CqxcjKjosXI90ykNFO6dhpsIsPa9uZGrf50s,7253
 veadk/integrations/ve_tos/ve_tos.py,sha256=yjc3h6JH2MM_8InE42YqjZupu5pcfFwHAMqPhr3x544,25186
+veadk/integrations/ve_viking_db_memory/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
+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=3tovdz19eImnIBf88wsuW0J_dGMcOoAuYYg1gEW3dMQ,6058
+veadk/knowledgebase/knowledgebase.py,sha256=gfHBxmfAGTFc1y13PMpB455G3YW0qE1zHjiUPM9iS3s,5642
 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
@@ -112,21 +117,21 @@ veadk/knowledgebase/backends/opensearch_backend.py,sha256=4oChkqd25RvL460p1-D7no
 veadk/knowledgebase/backends/redis_backend.py,sha256=pc-T_QicyAmOp6KbMz0V8iIL1ZlKCKQpdNB9SkaNqm8,5226
 veadk/knowledgebase/backends/utils.py,sha256=GOIuOFIJqruIk5Imx4F7ou5qKTUmg_gWJoLYi1kkopQ,2661
 veadk/knowledgebase/backends/vikingdb_knowledge_backend.py,sha256=hVSfAc17wzEoEKlPa7x3ekCcApFgDzY7x6ceBDxd9mw,18126
-veadk/memory/__init__.py,sha256=hKFQm9GUvH7b2Jbqs2l2JqUsFNqbblftVFEYRhjGOSM,1253
-veadk/memory/long_term_memory.py,sha256=3gL9Z_sCvYDCm0GSTLOjkA-paH_TE9G0x-tb5UYEdnw,8779
-veadk/memory/short_term_memory.py,sha256=XL8gSwsEXLWm_opYwviLpxcKsh0dGwLqTuOCAS6YQcI,4790
+veadk/memory/__init__.py,sha256=GRIoRqapS2gUtRMB9JZvodU29PwMxFe2KDjPnVpqib0,1252
+veadk/memory/long_term_memory.py,sha256=YE5DH9qyJwlA7t0smwV4J90wnUBYVR6MRXHg1qsqKNU,7423
+veadk/memory/short_term_memory.py,sha256=MLR2Op_l_Zr-ZKCJ7pyNhe_OzPG06Zcb8pt8qA_zrFY,4922
 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=PuLhqc7LhMzhkQSrz8Zotk-D7WmzjHdUlaWEjsrL470,1181
-veadk/memory/long_term_memory_backends/in_memory_backend.py,sha256=h0GNiZTtqpbWucaZ-L0NEhPgi_ntPoA6GPg3qqcH5uo,2672
-veadk/memory/long_term_memory_backends/mem0_backend.py,sha256=S0ZfJ_MlvGDFaOERNZBIfJd6wkyoP9_JXeh1VeKJkYs,4344
-veadk/memory/long_term_memory_backends/opensearch_backend.py,sha256=xcXeCakgf3FUcLfATajLhIT9u0kEi8craJhG9xLKvPg,4394
-veadk/memory/long_term_memory_backends/redis_backend.py,sha256=WJLKAjTLDKORAS6y5e2JaEfduLlIbrj4RThQat-0Cw0,4632
-veadk/memory/long_term_memory_backends/vikingdb_memory_backend.py,sha256=Xfq9-fZDZg15Sbfq14Dr7dctUm2N8eN3rBgJ5j4dNdA,4999
+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/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=QSSy6edP9zWrKTUcnZ8MsPhCcQJmL0IJzGeLxuY0BGo,5781
 veadk/memory/short_term_memory_backends/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/memory/short_term_memory_backends/base_backend.py,sha256=5AtnWuFE_TYpTAlAKnm2xglf4AT3iXmU9QSF7LkO1BA,1053
 veadk/memory/short_term_memory_backends/mysql_backend.py,sha256=_m-yuB7X-pPvs93-W8ZswDIkIpYpCFMRRdt9D5SZzn8,1513
-veadk/memory/short_term_memory_backends/postgresql_backend.py,sha256=NfqiaudsR0MjGhlDhcxQ24BwBhuvpbv-k5zNCzv4vK0,1594
+veadk/memory/short_term_memory_backends/postgresql_backend.py,sha256=AyCuQMSbnvKYIXRm0KhyuLOz0NDHF6p8y3U31OHciUk,1644
 veadk/memory/short_term_memory_backends/sqlite_backend.py,sha256=lXcCXRjn7m_sfoGI7VyGhYV3wdNZ38tnn0RcDxt2jx0,1522
 veadk/prompts/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/prompts/agent_default_prompt.py,sha256=hijfMeZt0TYDVB9WEVwcazuuhm8z0Xdlzht1CfyYPLE,1380
@@ -135,18 +140,19 @@ veadk/prompts/prompt_memory_processor.py,sha256=7RF12ixz13FQ-1H7xDM3EHcMtMRDh7UI
 veadk/prompts/prompt_optimization.py,sha256=RIHX0bcpBRfG6--0tGH67CQ063KiAoVJO145PVztujI,4164
 veadk/tools/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/tools/demo_tools.py,sha256=Gu3sxygcYVS2cv3WqUOl-Gq4JhMlDAktoCHOFT0gbFQ,2216
-veadk/tools/load_knowledgebase_tool.py,sha256=GgR-MwDskB1qV30tiTDVSGbM5z6qrrEyiyo7g_IhNKw,4262
+veadk/tools/load_knowledgebase_tool.py,sha256=UUTv0Za9GkEXAkl1SXmyq0HGCKGvSlH_f8Ok6O6e52M,4704
 veadk/tools/builtin_tools/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
-veadk/tools/builtin_tools/generate_image.py,sha256=KSfrgsAMAJSiXPCvkB6Razl7TTj6SKG8jk5gYv1NLqU,15040
-veadk/tools/builtin_tools/image_edit.py,sha256=nPzEZXad9F2FuC_qmlyGrGwsNU3kcYblRZH4p8dx_BU,10600
-veadk/tools/builtin_tools/image_generate.py,sha256=68kFkrRSoVV7PrSf9nUaL0CitFSkFAdc7rVnKwI9Ceo,10334
+veadk/tools/builtin_tools/generate_image.py,sha256=BksUf1sEFDzOkDAPOlmtfALKGAtVSfbMC_WY33uCyaM,16701
+veadk/tools/builtin_tools/image_edit.py,sha256=Nv9nAbW_0zovR_lyZe2A3PIN6Dlifm5jN8PTWRULf9M,10926
+veadk/tools/builtin_tools/image_generate.py,sha256=PCnq16qj28UsauShLmVSSnC91HQMWC0rhFdSfPR0Ko4,10671
 veadk/tools/builtin_tools/lark.py,sha256=b2IWsN8fZFh9aweSGznaOqA30TCOLpVjNCDNa1LHZl4,2046
 veadk/tools/builtin_tools/las.py,sha256=rgKfnK5GsHVbmkp-rc7rtCvWg-yYNxMjeV0ayCyRpjM,913
+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/vesearch.py,sha256=prPP0w6lYeIEPwuZdmV00RAzaW4MeH8lYtK-NluaXtU,1748
-veadk/tools/builtin_tools/video_generate.py,sha256=6MhpskXeeFi7KP0NjZFfyVDFMFb1_iHqLCzxyjQ6sH0,14527
+veadk/tools/builtin_tools/video_generate.py,sha256=8uozyhmg203vpI2mXSkSji79WFZ2B0IzFMLTIGVzc2M,14778
 veadk/tools/builtin_tools/web_scraper.py,sha256=iVnxWVf2mVgOnEOeQ6Bg5ATYN-g1ZPCTK6VJm710be0,2408
-veadk/tools/builtin_tools/web_search.py,sha256=0wSjkihVNF_uYqCBv_1NBVhfvDTrZtFRK8WJwvDiUL0,5794
+veadk/tools/builtin_tools/web_search.py,sha256=1DtdhlcxolzIvx2TyqvUNWk60BHMuLkcru8Wlw3XBtQ,6016
 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
@@ -155,27 +161,27 @@ veadk/tracing/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/tracing/base_tracer.py,sha256=AQQopQ81Y1dGt3BF1iT8el5iSJC7HH5NrW9sU9R92v8,1098
 veadk/tracing/telemetry/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
 veadk/tracing/telemetry/opentelemetry_tracer.py,sha256=FTuJxewyB6D9Cag3X22SfBMw1aSotohBUK_qpgYTVk8,7768
-veadk/tracing/telemetry/telemetry.py,sha256=kiPBnkp7VwO0YcY_fwfd8oPbJGWUyP-AluBFVT8-I0I,9849
+veadk/tracing/telemetry/telemetry.py,sha256=qM7Y9UlxTk78Z8inigtDZEoSSsUCY7b1nOmTWfVQ1mA,11033
 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=pJ84vyipzmZC4w23nwqIzNG_xEO-z3eGTHvW7V8_uYY,25776
-veadk/tracing/telemetry/attributes/extractors/tool_attributes_extractors.py,sha256=FjhSn69yfk7kdgEql7ne9PeIOnxEItMS06RqGMqIMAQ,2722
+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/exporters/__init__.py,sha256=pkSabKw7_ai4NOo56pXKL40EcaxIDh6HYxPXOY7qWbo,634
-veadk/tracing/telemetry/exporters/apmplus_exporter.py,sha256=nemvdz9nigHf3VvMEhK8E61YudJz7Fj11Jw5_jazWfI,10924
+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=laE9Fz2cx327dRc6gthmC7IGJIGa6fWSWPbMrYlDfGo,4568
+veadk/tracing/telemetry/exporters/inmemory_exporter.py,sha256=wgcXpoPqi-JQirMeqLMdVKvg1u42UYXt1cN7LpyXcFA,4952
 veadk/tracing/telemetry/exporters/tls_exporter.py,sha256=YODDfqZJKq3SiuDqxjERuJoOAuGErurjl_zFZr8TiGg,2674
 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=F-EP-12eh7PHRz2rDCvdG29Kj2DmKoBc9Hik9_RwMpo,5147
+veadk/utils/misc.py,sha256=ghEqrqoDfKrW9ZD3IB0bwcfyyB0gRWN2yEP9eRxQ4nE,4953
 veadk/utils/patches.py,sha256=dcHdlJ8IciyMjDuMy6-_6McUqJYyLz0yHmJ0xH8lWOw,2752
-veadk/utils/volcengine_sign.py,sha256=KJ5-2wRNd7RloxiI47NiwDnVh3VvGYHjRLgaTpovBbU,6623
-veadk_python-0.2.9.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-veadk_python-0.2.9.dist-info/METADATA,sha256=3CnJ4iKJ8aqpHsOo0zGTJ1KH2Tf8jAkoEhM6YfLyf9k,18408
-veadk_python-0.2.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-veadk_python-0.2.9.dist-info/entry_points.txt,sha256=-g28D6dNV-2UvAiRP9VF0oOVSDSJ5zlLUIZ34ArAqF8,46
-veadk_python-0.2.9.dist-info/top_level.txt,sha256=Qqi3ycJ4anKiZWBXtUBIy8zK9ZuXJsFa05oFq8O8qqY,6
-veadk_python-0.2.9.dist-info/RECORD,,
+veadk/utils/volcengine_sign.py,sha256=3xn6ca2OAg_AFyP2dqFTSioqkeDel_BoKURUtCcO-EQ,6736
+veadk_python-0.2.11.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+veadk_python-0.2.11.dist-info/METADATA,sha256=efOOpg8g2B2DWlBQ9xJhvMRHCkCWmQaX1njAolmkHiw,18428
+veadk_python-0.2.11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+veadk_python-0.2.11.dist-info/entry_points.txt,sha256=-g28D6dNV-2UvAiRP9VF0oOVSDSJ5zlLUIZ34ArAqF8,46
+veadk_python-0.2.11.dist-info/top_level.txt,sha256=Qqi3ycJ4anKiZWBXtUBIy8zK9ZuXJsFa05oFq8O8qqY,6
+veadk_python-0.2.11.dist-info/RECORD,,