Merge branch 'main' into copilot/rebase-onto-latest-main

Author: ralf0131

.github/workflows/loongsuite_lint_0.yml

@@ -70,6 +70,25 @@ jobs:
       - name: Run tests
         run: tox -c tox-loongsuite.ini -e lint-loongsuite-instrumentation-dashscope
 
+  lint-loongsuite-instrumentation-claude-agent-sdk:
+    name: LoongSuite loongsuite-instrumentation-claude-agent-sdk
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -c tox-loongsuite.ini -e lint-loongsuite-instrumentation-claude-agent-sdk
+
   lint-loongsuite-instrumentation-mem0:
     name: LoongSuite loongsuite-instrumentation-mem0
     runs-on: ubuntu-latest

.github/workflows/loongsuite_test_0.yml

@@ -374,6 +374,158 @@ jobs:
       - name: Run tests
         run: tox -c tox-loongsuite.ini -e py313-test-loongsuite-instrumentation-dashscope-latest -- -ra
 
+  py310-test-loongsuite-instrumentation-claude-agent-sdk-oldest_ubuntu-latest:
+    name: LoongSuite loongsuite-instrumentation-claude-agent-sdk-oldest 3.10 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -c tox-loongsuite.ini -e py310-test-loongsuite-instrumentation-claude-agent-sdk-oldest -- -ra
+
+  py310-test-loongsuite-instrumentation-claude-agent-sdk-latest_ubuntu-latest:
+    name: LoongSuite loongsuite-instrumentation-claude-agent-sdk-latest 3.10 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -c tox-loongsuite.ini -e py310-test-loongsuite-instrumentation-claude-agent-sdk-latest -- -ra
+
+  py311-test-loongsuite-instrumentation-claude-agent-sdk-oldest_ubuntu-latest:
+    name: LoongSuite loongsuite-instrumentation-claude-agent-sdk-oldest 3.11 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -c tox-loongsuite.ini -e py311-test-loongsuite-instrumentation-claude-agent-sdk-oldest -- -ra
+
+  py311-test-loongsuite-instrumentation-claude-agent-sdk-latest_ubuntu-latest:
+    name: LoongSuite loongsuite-instrumentation-claude-agent-sdk-latest 3.11 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -c tox-loongsuite.ini -e py311-test-loongsuite-instrumentation-claude-agent-sdk-latest -- -ra
+
+  py312-test-loongsuite-instrumentation-claude-agent-sdk-oldest_ubuntu-latest:
+    name: LoongSuite loongsuite-instrumentation-claude-agent-sdk-oldest 3.12 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -c tox-loongsuite.ini -e py312-test-loongsuite-instrumentation-claude-agent-sdk-oldest -- -ra
+
+  py312-test-loongsuite-instrumentation-claude-agent-sdk-latest_ubuntu-latest:
+    name: LoongSuite loongsuite-instrumentation-claude-agent-sdk-latest 3.12 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -c tox-loongsuite.ini -e py312-test-loongsuite-instrumentation-claude-agent-sdk-latest -- -ra
+
+  py313-test-loongsuite-instrumentation-claude-agent-sdk-oldest_ubuntu-latest:
+    name: LoongSuite loongsuite-instrumentation-claude-agent-sdk-oldest 3.13 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -c tox-loongsuite.ini -e py313-test-loongsuite-instrumentation-claude-agent-sdk-oldest -- -ra
+
+  py313-test-loongsuite-instrumentation-claude-agent-sdk-latest_ubuntu-latest:
+    name: LoongSuite loongsuite-instrumentation-claude-agent-sdk-latest 3.13 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -c tox-loongsuite.ini -e py313-test-loongsuite-instrumentation-claude-agent-sdk-latest -- -ra
+
   py310-test-loongsuite-instrumentation-mem0-oldest_ubuntu-latest:
     name: LoongSuite loongsuite-instrumentation-mem0-oldest 3.10 Ubuntu
     runs-on: ubuntu-latest

.gitignore

@@ -59,8 +59,13 @@ _build/
 .mypy_cache/
 target
 
+# pyright local config
+pyrightconfig.json
+
 # Benchmark result files
 *-benchmark.json
 
 # LoongSuite Extension
-.cursor/
+.cursor/
+upload/
+upload_*_test/

CHANGELOG-loongsuite.md

@@ -13,15 +13,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
-- `loongsuite-instrumentation-google-adk`: Add initial support for Google Agent Development Kit (ADK) ([#71](https://github.com/alibaba/loongsuite-python-agent/pull/71))
-
+- `loongsuite-instrumentation-agno`: fix aresponse missing await and double wrapped() calls in stream methods
+  ([#107](https://github.com/alibaba/loongsuite-python-agent/pull/107))
+- `loongsuite-instrumentation-mem0`: fix unittest
+  ([#98](https://github.com/alibaba/loongsuite-python-agent/pull/98))
 - `loongsuite-instrumentation-mem0`: use memory handler
   ([#89](https://github.com/alibaba/loongsuite-python-agent/pull/89))
-
 - Add `from __future__ import annotations` to fix Python 3.9 compatibility for union type syntax (`X | Y`)
   ([#80](https://github.com/alibaba/loongsuite-python-agent/pull/80))
 
 # Added
 
+- `loongsuite-instrumentation-google-adk`: Add initial support for Google Agent Development Kit (ADK) 
+  ([#71](https://github.com/alibaba/loongsuite-python-agent/pull/71))
+- `loongsuite-instrumentation-mem0`: add hook extension
+  ([#95](https://github.com/alibaba/loongsuite-python-agent/pull/95))  
 - `loongsuite-instrumentation-mem0`: add support for mem0
   ([#67](https://github.com/alibaba/loongsuite-python-agent/pull/67))

README.md

@@ -15,11 +15,11 @@ Loongsuite Python Agent is also a customized distribution of upstream [OTel Pyth
 The implementation follows the latest GenAI [semantic conventions](https://github.com/open-telemetry/semantic-conventions).
 
 ## Supported AI Frameworks and components
-* [AgentScope](https://github.com/agentscope-ai/agentscope): [Guide](instrumentation-genai/opentelemetry-instrumentation-agentscope/README.md)
-* [Dify](https://github.com/langgenius/dify): [Guide](instrumentation-genai/opentelemetry-instrumentation-dify/README.md)
+* [AgentScope](https://github.com/agentscope-ai/agentscope): [Guide](instrumentation-loongsuite/loongsuite-instrumentation-agentscope/README.md)
+* [Dify](https://github.com/langgenius/dify): [Guide](instrumentation-loongsuite/loongsuite-instrumentation-dify/README.md)
 * [LangChain](https://github.com/langchain-ai/langchain): [Guide](instrumentation-genai/opentelemetry-instrumentation-langchain/README.md)
 * [MCP Client](https://github.com/modelcontextprotocol/python-sdk)
-* [Agno](https://github.com/agno-agi/agno): [Guide](instrumentation-genai/opentelemetry-instrumentation-agno/README.md)
+* [Agno](https://github.com/agno-agi/agno): [Guide](instrumentation-loongsuite/loongsuite-instrumentation-agno/README.md)
 * [OpenAI](https://github.com/openai/openai-python): [Guide](instrumentation-genai/opentelemetry-instrumentation-openai-v2/README.rst)
 
 ## Quick start
@@ -41,7 +41,7 @@ pip install agentscope
 #AgentScopeInstrumentor
 git clone https://github.com/alibaba/loongsuite-python-agent.git
 cd loongsuite-python-agent
-pip install ./instrumentation-genai/opentelemetry-instrumentation-agentscope
+pip install ./instrumentation-loongsuite/loongsuite-instrumentation-agentscope
 ```
 
 ### RUN
@@ -144,7 +144,7 @@ If everything is working correctly, you should see logs similar to th
 }
 ```
 
-### Forwarding OTLP Data to Jaeger via LoongCollector
+### (Optional) Forwarding OTLP Data to Jaeger via LoongCollector
 
 #### Launch Jaeger
 
@@ -221,6 +221,60 @@ Access the Jaeger UI to view the collected trace data. You should no
 
 ![image.png](docs/_assets/img/quickstart-results.png)
 
+### Using AgentScope Studio to View Tracing Data
+
+[AgentScope Studio](https://github.com/agentscope-ai/agentscope-studio) provides a web-based interface for visualizing and analyzing tracing data from AgentScope applications.
+
+#### Installation
+
+Install AgentScope Studio:
+
+```shell
+pip install agentscope-studio
+```
+
+#### Launch AgentScope Studio
+
+Start the AgentScope Studio server:
+
+```shell
+as_studio
+```
+
+AgentScope Studio will start and display the OTLP endpoint URL (typically `http://127.0.0.1:31415`).
+
+#### Export AgentScope Data to AgentScope Studio
+
+Configure your AgentScope application to export telemetry data to AgentScope Studio using OTLP. Use the endpoint URL displayed by AgentScope Studio when it starts:
+
+```shell
+loongsuite-instrument \
+    --traces_exporter otlp \
+    --metrics_exporter otlp \
+    --exporter_otlp_protocol http/protobuf \
+    --exporter_otlp_endpoint http://127.0.0.1:31415 \
+    --service_name demo \
+    python demo.py
+```
+
+Alternatively, you can use environment variables:
+
+```shell
+export OTEL_SERVICE_NAME=demo
+export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
+export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://127.0.0.1:31415
+export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://127.0.0.1:31415
+
+loongsuite-instrument \
+    --traces_exporter otlp \
+    --metrics_exporter otlp \
+    python demo.py
+```
+
+The web interface will display the collected traces and metrics, allowing you to view and analyze the tracing data from your AgentScope applications.
+
+For more details, please refer to the [AgentScope Studio documentation](https://github.com/agentscope-ai/agentscope-studio).
+
 ## Community
 
 We are looking forward to your feedback and suggestions. You can join

instrumentation-genai/opentelemetry-instrumentation-vertexai/tests/requirements.oldest.txt

@@ -69,7 +69,7 @@ opentelemetry-api==1.37
 opentelemetry-sdk==1.37
 opentelemetry-semantic-conventions==0.58b0
 opentelemetry-instrumentation==0.58b0
-opentelemetry-util-genai[upload]==0.2b0
+-e util/opentelemetry-util-genai[upload]  # LoongSuite Extension: use local version with ensure_ascii=False
 fsspec==2025.9.0
 
 -e instrumentation-genai/opentelemetry-instrumentation-vertexai[instruments]

instrumentation-genai/opentelemetry-instrumentation-vertexai/tests/test_function_calling_experimental.py

@@ -135,6 +135,7 @@ def test_tool_events(
     spans = span_exporter.get_finished_spans()
     assert len(spans) == 1
     assert spans[0].name == "chat gemini-2.5-pro"
+    # fmt: off  # LoongSuite Extension: preserve non-ASCII characters in test expectation
     assert dict(spans[0].attributes) == {
         "gen_ai.operation.name": "chat",
         "gen_ai.request.model": "gemini-2.5-pro",
@@ -145,8 +146,9 @@ def test_tool_events(
         "server.address": "us-central1-aiplatform.googleapis.com",
         "server.port": 443,
         "gen_ai.input.messages": '[{"role":"user","parts":[{"content":"Get weather details in New Delhi and San Francisco?","type":"text"}]},{"role":"model","parts":[{"arguments":{"location":"New Delhi"},"name":"get_current_weather","id":"get_current_weather_0","type":"tool_call"},{"arguments":{"location":"San Francisco"},"name":"get_current_weather","id":"get_current_weather_1","type":"tool_call"}]},{"role":"user","parts":[{"response":{"content":"{\\"temperature\\": 35, \\"unit\\": \\"C\\"}"},"id":"get_current_weather_0","type":"tool_call_response"},{"response":{"content":"{\\"temperature\\": 25, \\"unit\\": \\"C\\"}"},"id":"get_current_weather_1","type":"tool_call_response"}]}]',
-        "gen_ai.output.messages": '[{"role":"model","parts":[{"content":"The current temperature in New Delhi is 35\\u00b0C, and in San Francisco, it is 25\\u00b0C.","type":"text"}],"finish_reason":"stop"}]',
+        "gen_ai.output.messages": '[{"role":"model","parts":[{"content":"The current temperature in New Delhi is 35°C, and in San Francisco, it is 25°C.","type":"text"}],"finish_reason":"stop"}]',
     }
+    # fmt: on
     logs = log_exporter.get_finished_logs()
     assert len(logs) == 1
     log = logs[0].log_record

instrumentation-loongsuite/loongsuite-instrumentation-agentscope/CHANGELOG.md

@@ -7,6 +7,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+### Fixed
+- Fix LLM message content capture in spans ([#91](https://github.com/alibaba/loongsuite-python-agent/pull/91))
+
 ### Breaking Changes
 - **Minimum AgentScope version requirement**: Only supports AgentScope 1.0.0 and above. Previous 0.x versions are not supported.
 

instrumentation-loongsuite/loongsuite-instrumentation-agentscope/README.md

@@ -20,6 +20,9 @@ pip install agentscope
 
 # Install this instrumentation
 pip install ./instrumentation-loongsuite/loongsuite-instrumentation-agentscope
+
+# Note: This instrumentation uses ExtendedTelemetryHandler from opentelemetry-util-genai
+pip install ./util/opentelemetry-util-genai
 ```
 
 ## Usage
@@ -67,6 +70,9 @@ opentelemetry-instrument python your_app.py
 Control message content capture using environment variables:
 
 ```bash
+# Enable experimental GenAI semantic conventions
+export OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental
+
 # Capture content in spans only
 export OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=SPAN_ONLY
 
@@ -90,13 +96,13 @@ export OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=NO_CONTENT
 ## Visualization
 
 Export telemetry data to:
-- [Aliyun XTrace](https://www.aliyun.com/product/xtrace)
+- [Alibaba Cloud Managed Service for OpenTelemetry](https://www.aliyun.com/product/xtrace)
 - [AgentScope Studio](https://github.com/agentscope-ai/agentscope-studio)
 - Any OpenTelemetry-compatible backend (Jaeger, Zipkin, etc.)
 
 ## Examples
 
-See the [examples directory](../../examples/) for complete usage examples.
+See the [main README](https://github.com/alibaba/loongsuite-python-agent/blob/main/README.md) for complete usage examples.
 
 ## License