Merge pull request #2830 from Agenta-AI/release/v0.59.0

release/v0.59.0

Author: jp-agenta

.gitleaks.toml

@@ -11,6 +11,7 @@ paths = [
   '''^core/docs/docs/reference/api/.*\.mdx''',
   '''^docs/docs/reference/api/.*\.mdx''',
   '''^docs/.docusaurus/.*''',
+  '''^docs/build/.*''',
   # -------------------------------------------------------------- WEB ARTIFACTS
   '''^.*/\.pnpm-store/.*''',
   '''^.*/public/__env\.js$''',
@@ -24,6 +25,8 @@ regexes = [
   '''is_completion=True''',
   '''YOUR_API_KEY''',
   '''_SECRET_KEY''',
+  # ------------------------------------------------------------ PUBLIC KEYS
+  '''phc_hmVSxIjTW1REBHXgj2aw4HW9X6CXb6FzerBgP9XenC7''',
   # ----------------------------------------------------------------------------
 ]
 

api/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "api"
-version = "0.58.0"
+version = "0.59.0"
 description = "Agenta API"
 authors = [
     { name = "Mahmoud Mabrouk", email = "mahmoud@agenta.ai" },

docs/blog/entries/filtering-traces-by-annotation.mdx

@@ -0,0 +1,40 @@
+---
+title: "Filtering Traces by Annotation"
+slug: filtering-traces-by-annotation
+date: 2025-10-14
+tags: [v0.58.0]
+---
+
+import Image from "@theme/IdealImage";
+
+
+We rebuilt the filtering system in observability. We added a new dropdown with more options. Additionally, we added a new annotation filtering. You can now filter and search traces based on their annotations. This feature helps you find traces with low scores or bad feedback quickly.
+
+### New Filter Options
+
+The new dropdown is simpler and gives you more options. You can now filter by:
+- **Span status**: Find successful or failed spans
+- **Input keys**: Search for specific inputs in your spans
+- **App or environment**: Filter traces from specific apps or environments
+- **Any key within your span**: Search custom data in your trace structure
+
+<Image img={require('/static/images/changelog/changelog-filters-observability.png')} alt="Complete observability filters" style={{display: 'block', margin: '20px auto', textAlign: 'center', width: '20%'}} />
+
+### Annotation Filtering
+
+Filter traces based on evaluations and feedback:
+- **Evaluator results**: Find spans evaluated by a specific evaluator
+- **User feedback**: Search for spans with feedback like `success=True`
+
+<Image img={require('/static/images/changelog/changelog-annotation-filter.png')} alt="Annotation filtering interface" style={{display: 'block', margin: '20px auto', textAlign: 'center'}} />
+
+This feature enables powerful workflows:
+
+1. **Capture user feedback** from your application using our API ([see tutorial](/tutorials/cookbooks/capture-user-feedback))
+2. **Filter traces** to find those with bad feedback or low scores
+3. **Add them to test sets** to track problematic cases
+4. **Improve your prompts** based on real user feedback
+
+The filtering system makes it easy to turn production issues into test cases.
+
+---

docs/blog/main.mdx

@@ -10,6 +10,27 @@ import Image from "@theme/IdealImage";
 
 <section class="changelog">
 
+### [Filtering Traces by Annotation](/changelog/filtering-traces-by-annotation)
+
+_14 October 2025_
+
+**v0.58.0**
+<Image img={require('/static/images/changelog/changelog-annotation-filter.png')} alt="Annotation filtering interface" style={{display: 'block', margin: '20px auto', textAlign: 'center'}} />
+
+
+You can now filter and search traces based on their annotations. This helps you find traces with low scores or bad feedback quickly.
+
+We rebuilt the filtering system in observability with a simpler dropdown and more options. You can now filter by span status, input keys, app or environment references, and any key within your span.
+
+The new annotation filtering lets you find:
+- Spans evaluated by a specific evaluator
+- Spans with user feedback like `success=True`
+
+
+This enables powerful workflows: [capture user feedback](/tutorials/cookbooks/capture-user-feedback) from your app, filter to find traces with bad feedback, add them to test sets, and improve your prompts based on real user data.
+
+---
+
 ### [New Evaluation Results Dashboard](/changelog/new-evaluation-results-dashboard)
 
 _26 September 2025_

docs/src/data/roadmap.ts

@@ -24,6 +24,19 @@ export const shippedFeatures: ShippedFeature[] = [
     // Playground: BCFF78
     // Observability: DE74FF
     // Evaluation: 86B7FF
+    {
+        id: "filtering-by-annotation",
+        title: "Filtering Traces by Annotation",
+        description: "Filter and search for traces based on their annotations. Find traces with low scores or feedback quickly using the rebuilt filtering system.",
+        changelogPath: "/changelog/filtering-traces-by-annotation",
+        shippedAt: "2025-10-14",
+        labels: [
+            {
+                name: "Observability",
+                color: "DE74FF",
+            },
+        ],
+    },
     {
         id: "evaluation-results-dashboard",
         title: "New Evaluation Results Dashboard",
@@ -173,19 +186,7 @@ export const inProgressFeatures: PlannedFeature[] = [
             },
         ],
     },
-
     {
-        id: "filtering-by-annotation",
-        title: "Filtering Traces by Annotation",
-        description: "We are adding the ability to filter traces by annotation. This is useful for finding traces with low scores or feedback.",
-        githubUrl: "https://github.com/Agenta-AI/agenta/discussions/2729",
-        labels: [
-            {
-                name: "Observability",
-                color: "DE74FF",
-            },
-        ],
-    }, {
         id: "date-range-filtering",
         title: "Date Range Filtering in Metrics Dashboard",
         description: "We are adding the ability to filter traces by date range in the metrics dashboard.",

docs/static/images/changelog/changelog-annotation-filter.png

@@ -26,8 +26,11 @@ if ! command -v gitleaks >/dev/null 2>&1; then
     brew install gitleaks
   else
     # fallback: go install (requires Go installed)
-    go install github.com/gitleaks/gitleaks/v8@latest
+    go install github.com/zricethezav/gitleaks/v8@latest
     export PATH="$PATH:$(go env GOPATH)/bin"
+    echo "----------------------------------------------------------------------"
+    echo "⚠️⚠️ PLEASE ADD $(go env GOPATH)/bin TO YOUR PATH IN YOUR .bashrc OR .zshrc ⚠️⚠️"
+    echo "----------------------------------------------------------------------"
   fi
 fi
 

docs/static/images/changelog/changelog-filters-observability.png

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "agenta"
-version = "0.58.0"
+version = "0.59.0"
 description = "The SDK for agenta is an open-source LLMOps platform."
 readme = "README.md"
 authors = [

hooks/setup.sh

@@ -1,6 +1,6 @@
 {
     "name": "@agenta/ee",
-    "version": "0.58.0",
+    "version": "0.59.0",
     "private": true,
     "engines": {
         "node": ">=18"