Version to 1.15.2. Various logging bumps. Add tool_metrics hook. Agent sdk docs.

Author: monoxgas

.hooks/generate_docs.py

@@ -27,8 +27,16 @@ def convert_span(self, el: t.Any, text: str, parent_tags: t.Any) -> t.Any:  # no
     def convert_div(self, el: t.Any, text: str, parent_tags: t.Any) -> t.Any:
         if "doc-md-description" in el.get("class", []):
             return text.strip()
+
         return super().convert_div(el, text, parent_tags)
 
+    # Replace any header tags inside docstrings with bolded text
+    def convert_hN(self, n: int, el: t.Any, text: str, parent_tags: t.Any) -> t.Any:  # noqa: N802
+        if "doc-contents" in el.parent.get("class", []):
+            return f"**{text.strip()}**"
+
+        return super().convert_hN(n, el, text, parent_tags)
+
     # Map mkdocstrings details classes to Mintlify callouts
     def convert_details(self, el: t.Any, text: str, parent_tags: t.Any) -> t.Any:  # noqa: ARG002
         classes = el.get("class", [])
@@ -120,6 +128,10 @@ def generate_docs_for_module(
         module_data = self.handler.collect(module_path, options)
         html = self.handler.render(module_data, options)
 
+        if "When to Use This Tool" in html:
+            with open("debug.html", "w", encoding="utf-8") as f:
+                f.write(html)
+
         return str(
             CustomMarkdownConverter(
                 code_language="python",

docs/docs.json

@@ -17,7 +17,11 @@
     "groups": [
       {
         "group": "Getting Started",
-        "pages": ["intro", "install", "config"]
+        "pages": [
+          "intro",
+          "install",
+          "config"
+        ]
       },
       {
         "group": "Example Agents",
@@ -88,37 +92,46 @@
       },
       {
         "group": "Migrations",
-        "pages": ["migrations/v1"]
+        "pages": [
+          "migrations/v1"
+        ]
       },
       {
         "group": "SDK",
         "pages": [
           {
             "group": "Core",
             "pages": [
-              "strikes/sdk/main",
-              "strikes/sdk/task",
-              "strikes/sdk/api"
+              "sdk/main",
+              "sdk/task",
+              "sdk/api"
+            ]
+          },
+          {
+            "group": "Agents",
+            "pages": [
+              "sdk/agent",
+              "sdk/agent_tools"
             ]
           },
           {
             "group": "Data and Processing",
             "pages": [
-              "strikes/sdk/data_types",
-              "strikes/sdk/serialization",
-              "strikes/sdk/artifact",
-              "strikes/sdk/transforms",
-              "strikes/sdk/optimization"
+              "sdk/data_types",
+              "sdk/serialization",
+              "sdk/artifact",
+              "sdk/transforms",
+              "sdk/optimization"
             ]
           },
           {
             "group": "Evaluation and Integrations",
             "pages": [
-              "strikes/sdk/eval",
-              "strikes/sdk/metrics",
-              "strikes/sdk/scorers",
-              "strikes/sdk/integrations",
-              "strikes/sdk/airt"
+              "sdk/eval",
+              "sdk/metrics",
+              "sdk/scorers",
+              "sdk/integrations",
+              "sdk/airt"
             ]
           }
         ]
@@ -153,4 +166,4 @@
       "linkedin": "https://linkedin.com/company/dreadnode"
     }
   }
-}
+}