unique-toolkit 2026.30.0.dev13__tar.gz → 2026.30.0.dev14__tar.gz

{unique_toolkit-2026.30.0.dev13 → unique_toolkit-2026.30.0.dev14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-toolkit
-Version: 2026.30.0.dev13
+Version: 2026.30.0.dev14
 Summary: 
 Author: Cedric Klinkert, Martin Fadler, Sadique Sheik, Fabian Schläpfer, Pascal Hauri, Ejiroghene Oki-Peter, Rami Azouz, Ricardo Visini, Sanzio Monti
 Author-email: Cedric Klinkert <cedric.klinkert@unique.ch>, Martin Fadler <martin.fadler@unique.ch>, Sadique Sheik <sadique@unique.ch>, Fabian Schläpfer <fabian@unique.ch>, Pascal Hauri <pascal@unique.ch>, Ejiroghene Oki-Peter <oki-peter.ejiroghene@unique.ai>, Rami Azouz <rami.ext@unique.ch>, Ricardo Visini <ricardo.visini@unique.ch>, Sanzio Monti <sanzio.monti@unique.ai>

{unique_toolkit-2026.30.0.dev13 → unique_toolkit-2026.30.0.dev14}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique_toolkit"
-version = "2026.30.0.dev13"
+version = "2026.30.0.dev14"
 description = ""
 readme = "README.md"
 requires-python = ">=3.12"

{unique_toolkit-2026.30.0.dev13 → unique_toolkit-2026.30.0.dev14}/unique_toolkit/agentic/debug_info_manager/debug_info_manager.py

@@ -1,4 +1,4 @@
-from typing import Any
+from typing import Any, Required, TypedDict
 
 from unique_toolkit.agentic.tools.openai_builtin import OpenAICodeInterpreterTool
 from unique_toolkit.agentic.tools.openai_builtin.base import OpenAIBuiltInToolName
@@ -10,6 +10,24 @@ from unique_toolkit.language_model.schemas import (
 )
 
 
+class AnalyticsTool(TypedDict, total=False):
+    name: Required[str]
+    is_forced: bool
+    is_exclusive: bool
+    loop_iteration: int
+
+
+class AnalyticsSkill(TypedDict):
+    name: str
+    content_id: str
+    is_forced: bool
+
+
+class Analytics(TypedDict):
+    tools: list[AnalyticsTool]
+    skills: list[AnalyticsSkill]
+
+
 class DebugInfoManager:
     def __init__(self):
         self.debug_info = {"tools": []}
@@ -53,6 +71,50 @@ class DebugInfoManager:
     def get(self) -> dict[str, Any]:
         return self.debug_info
 
+    def add_analytics(self, skills: list[dict[str, Any]]) -> None:
+        """Add a stable 'analytics' snapshot for downstream ROI/usage reporting.
+
+        Copies the current `tools` list (with each tool's info reduced to
+        attribution fields only) plus the given `skills` list into a new
+        `analytics` key, so later appends to `debug_info["tools"]` (e.g. from
+        extract_tool_debug_info) can't leak into the frozen snapshot. Existing
+        top-level keys (`tools`, `skills`, ...) are left untouched, so this is
+        additive for any consumer already reading the old shape.
+        """
+        self.add(
+            "analytics",
+            Analytics(
+                tools=[
+                    _to_analytics_tool_entry(tool)
+                    for tool in self.debug_info.get("tools", [])
+                ],
+                skills=[
+                    AnalyticsSkill(
+                        name=skill["name"],
+                        content_id=skill["content_id"],
+                        is_forced=skill["is_forced"],
+                    )
+                    for skill in skills
+                ],
+            ),
+        )
+
+
+def _to_analytics_tool_entry(tool: dict[str, Any]) -> AnalyticsTool:
+    """Return an analytics-safe copy of a tool debug-info entry.
+
+    Keeps only name plus is_forced / is_exclusive / loop_iteration.
+    """
+    info = tool.get("info") or {}
+    analytics_tool = AnalyticsTool(name=tool["name"])
+    if "is_forced" in info:
+        analytics_tool["is_forced"] = info["is_forced"]
+    if "is_exclusive" in info:
+        analytics_tool["is_exclusive"] = info["is_exclusive"]
+    if "loop_iteration" in info:
+        analytics_tool["loop_iteration"] = info["loop_iteration"]
+    return analytics_tool
+
 
 def _extract_tool_calls_from_stream_response(
     stream_response: LanguageModelStreamResponse,