feat: add cekura_metrics_python extension for observability

ai_agents/agents/examples/voice-assistant/README.md

@@ -29,6 +29,18 @@ A comprehensive voice assistant with real-time conversation capabilities using A
 - `OPENAI_PROXY_URL` - Proxy URL for OpenAI API (optional)
 - `WEATHERAPI_API_KEY` - Weather API key for weather tool (optional)
 
+### Optional: Cekura observability
+
+The default `voice_assistant` graph includes the **`cekura_metrics`** extension. If `CEKURA_API_KEY` is not set, it stays disabled and the demo runs unchanged.
+
+When enabled, set:
+
+- `CEKURA_API_KEY` — required to POST observability payloads.
+- **`CEKURA_ASSISTANT_ID`** *or* set numeric `agent_id` in `tenapp/property.json` on the `cekura_metrics` node (the example uses `assistant_id`: `${env:CEKURA_ASSISTANT_ID|}` with `agent_id` 0).
+- `CEKURA_METRIC_IDS` — optional comma-separated Cekura metric ids.
+
+See `ten_packages/extension/cekura_metrics_python/README.md` for graph details and notes on what is and isn't captured when `main_python` is left unmodified.
+
 ## Setup
 
 ### 1. Set Environment Variables

ai_agents/agents/examples/voice-assistant/tenapp/manifest-lock.json

@@ -751,6 +751,19 @@
       ],
       "path": "../../../ten_packages/extension/message_collector2"
     },
+    {
+      "type": "extension",
+      "name": "cekura_metrics_python",
+      "version": "0.1.0",
+      "hash": "1001e0dac91508bd721de22e02a143c7d2a89767846ab09b25fb18b85cbcc8b6",
+      "dependencies": [
+        {
+          "type": "system",
+          "name": "ten_runtime_python"
+        }
+      ],
+      "path": "../../../ten_packages/extension/cekura_metrics_python"
+    },
     {
       "type": "extension",
       "name": "weatherapi_tool_python",

ai_agents/agents/examples/voice-assistant/tenapp/manifest.json

@@ -144,6 +144,9 @@
     {
       "path": "../../../ten_packages/extension/message_collector2"
     },
+    {
+      "path": "../../../ten_packages/extension/cekura_metrics_python"
+    },
     {
       "path": "../../../ten_packages/extension/weatherapi_tool_python"
     },

ai_agents/agents/examples/voice-assistant/tenapp/property.json

@@ -85,6 +85,24 @@
               "extension_group": "transcriber",
               "property": {}
             },
+            {
+              "type": "extension",
+              "name": "cekura_metrics",
+              "addon": "cekura_metrics_python",
+              "extension_group": "default",
+              "property": {
+                "api_key": "${env:CEKURA_API_KEY|}",
+                "agent_id": 0,
+                "assistant_id": "${env:CEKURA_ASSISTANT_ID|}",
+                "base_url": "https://api.cekura.ai",
+                "auto_flush": true,
+                "auto_flush_interval_ms": 5000,
+                "metric_ids": "${env:CEKURA_METRIC_IDS|}",
+                "collect_latency": true,
+                "collect_transcripts": true,
+                "collect_tool_calls": true
+              }
+            },
             {
               "type": "extension",
               "name": "weatherapi_tool_python",
@@ -181,6 +199,54 @@
                   ]
                 }
               ]
+            },
+            {
+              "extension": "cekura_metrics",
+              "cmd": [
+                {
+                  "names": [
+                    "on_user_joined",
+                    "on_user_left"
+                  ],
+                  "source": [
+                    {
+                      "extension": "agora_rtc"
+                    }
+                  ]
+                }
+              ],
+              "data": [
+                {
+                  "name": "asr_result",
+                  "source": [
+                    {
+                      "extension": "stt"
+                    }
+                  ]
+                },
+                {
+                  "name": "text_data",
+                  "source": [
+                    {
+                      "extension": "tts"
+                    }
+                  ]
+                },
+                {
+                  "name": "metrics",
+                  "source": [
+                    {
+                      "extension": "stt"
+                    },
+                    {
+                      "extension": "tts"
+                    },
+                    {
+                      "extension": "llm"
+                    }
+                  ]
+                }
+              ]
             }
           ]
         }