unique-toolkit 2026.30.0.dev17__tar.gz → 2026.30.0.dev19__tar.gz

{unique_toolkit-2026.30.0.dev17 → unique_toolkit-2026.30.0.dev19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-toolkit
-Version: 2026.30.0.dev17
+Version: 2026.30.0.dev19
 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.dev17 → unique_toolkit-2026.30.0.dev19}/pyproject.toml

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

{unique_toolkit-2026.30.0.dev17 → unique_toolkit-2026.30.0.dev19}/unique_toolkit/agentic/debug_info_manager/debug_info_manager.py

@@ -2,6 +2,9 @@ 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
+from unique_toolkit.agentic.tools.openai_builtin.code_interpreter.postprocessors.generated_files import (
+    ArtifactsDebugInfo,
+)
 from unique_toolkit.agentic.tools.schemas import ToolCallResponse
 from unique_toolkit.agentic.tools.tool_manager import ToolManager
 from unique_toolkit.language_model.schemas import (
@@ -55,7 +58,7 @@ class Analytics(TypedDict):
 
 class DebugInfoManager:
     def __init__(self):
-        self.debug_info = {"tools": []}
+        self.debug_info: dict[str, Any] = {"tools": []}
 
     def extract_tool_debug_info(
         self,
@@ -106,6 +109,7 @@ class DebugInfoManager:
         answer_length: int = 0,
         loop_iteration_count: int = 0,
         total_time_to_answer_ms: int | None = None,
+        artifacts: ArtifactsDebugInfo | None = None,
     ) -> None:
         """Add a stable 'analytics' snapshot for downstream ROI/usage reporting.
 
@@ -121,6 +125,10 @@ class DebugInfoManager:
             _to_analytics_tool_entry(tool, tool_display_names)
             for tool in self.debug_info.get("tools", [])
         ]
+        # Artifacts are recorded at the postprocessor seam (Code Interpreter's
+        # DisplayCodeInterpreterFilesPostProcessor) into debug_info["artifacts"].
+        # Absent when no Code Interpreter ran this turn → both fields stay None,
+        # preserving the always-present, null-when-unknown contract.
         analytics = Analytics(
             tools_used=analytics_tools,
             tool_call_count=len(analytics_tools),
@@ -140,10 +148,8 @@ class DebugInfoManager:
             subagent_names_used=_unique_tool_names(analytics_tools, "is_sub_agent"),
             mcp_tool_names_used=_unique_tool_names(analytics_tools, "is_mcp"),
             total_time_to_answer_ms=total_time_to_answer_ms,
-            # Reserved placeholders — schema present so consumers can rely on the
-            # keys, populated in a follow-up step (artifacts instrumentation).
-            artifacts_created_count=None,
-            artifacts_created_filetype=None,
+            artifacts_created_count=artifacts["count"] if artifacts else None,
+            artifacts_created_filetype=artifacts["filetypes"] if artifacts else None,
         )
         self.add("analytics", analytics)
 

{unique_toolkit-2026.30.0.dev17 → unique_toolkit-2026.30.0.dev19}/unique_toolkit/agentic/postprocessor/postprocessor_manager.py

@@ -18,7 +18,7 @@ class Postprocessor(ABC):
     def get_name(self) -> str:
         return self.name
 
-    async def run(self, loop_response: LanguageModelStreamResponse) -> None:
+    async def run(self, loop_response: LanguageModelStreamResponse) -> object | None:
         raise NotImplementedError("Subclasses must implement this method.")
 
     def apply_postprocessing_to_response(
@@ -41,7 +41,9 @@ class ResponsesApiPostprocessor(ABC):
     def get_name(self) -> str:
         return self.name
 
-    async def run(self, loop_response: ResponsesLanguageModelStreamResponse) -> None:
+    async def run(
+        self, loop_response: ResponsesLanguageModelStreamResponse
+    ) -> object | None:
         raise NotImplementedError("Subclasses must implement this method.")
 
     def apply_postprocessing_to_response(
@@ -124,7 +126,7 @@ class PostprocessorManager:
     async def run_postprocessors(
         self,
         loop_response: LanguageModelStreamResponse,
-    ) -> None:
+    ) -> dict[str, object | None]:
         self._execution_times = {}
 
         task_executor = SafeTaskExecutor(
@@ -163,6 +165,12 @@ class PostprocessorManager:
                 references=loop_response.message.references,
             )
 
+        return {
+            postprocessors[i].get_name(): postprocessor_results[i].unpack()
+            for i in range(len(postprocessors))
+            if postprocessor_results[i].success
+        }
+
     def get_execution_times(self) -> dict[str, float]:
         return self._execution_times.copy()
 
@@ -170,12 +178,13 @@ class PostprocessorManager:
         self,
         loop_response: LanguageModelStreamResponse,
         postprocessor_instance: Postprocessor | ResponsesApiPostprocessor,
-    ) -> None:
+    ) -> object | None:
         start = time.perf_counter()
-        await postprocessor_instance.run(loop_response)  # pyright: ignore[reportArgumentType]  # TODO(UN-19522)
+        result = await postprocessor_instance.run(loop_response)  # pyright: ignore[reportArgumentType]  # TODO(UN-19522)
         self._execution_times[postprocessor_instance.name] = round(
             time.perf_counter() - start, 3
         )
+        return result
 
     async def remove_from_text(
         self,

{unique_toolkit-2026.30.0.dev17 → unique_toolkit-2026.30.0.dev19}/unique_toolkit/agentic/tools/openai_builtin/code_interpreter/__init__.py

@@ -6,6 +6,7 @@ from unique_toolkit.agentic.tools.openai_builtin.code_interpreter.builder import
     CodeInterpreterBuilder,
 )
 from unique_toolkit.agentic.tools.openai_builtin.code_interpreter.postprocessors import (
+    ArtifactsDebugInfo,
     DisplayCodeInterpreterFilesPostProcessor,
     DisplayCodeInterpreterFilesPostProcessorConfig,
     ShowExecutedCodePostprocessor,
@@ -26,4 +27,5 @@ __all__ = [
     "ShowExecutedCodePostprocessorConfig",
     "DisplayCodeInterpreterFilesPostProcessor",
     "DisplayCodeInterpreterFilesPostProcessorConfig",
+    "ArtifactsDebugInfo",
 ]

{unique_toolkit-2026.30.0.dev17 → unique_toolkit-2026.30.0.dev19}/unique_toolkit/agentic/tools/openai_builtin/code_interpreter/postprocessors/__init__.py

@@ -3,6 +3,7 @@ from unique_toolkit.agentic.tools.openai_builtin.code_interpreter.postprocessors
     ShowExecutedCodePostprocessorConfig,
 )
 from unique_toolkit.agentic.tools.openai_builtin.code_interpreter.postprocessors.generated_files import (
+    ArtifactsDebugInfo,
     DisplayCodeInterpreterFilesPostProcessor,
     DisplayCodeInterpreterFilesPostProcessorConfig,
 )
@@ -12,4 +13,5 @@ __all__ = [
     "ShowExecutedCodePostprocessorConfig",
     "DisplayCodeInterpreterFilesPostProcessor",
     "DisplayCodeInterpreterFilesPostProcessorConfig",
+    "ArtifactsDebugInfo",
 ]

{unique_toolkit-2026.30.0.dev17 → unique_toolkit-2026.30.0.dev19}/unique_toolkit/agentic/tools/openai_builtin/code_interpreter/postprocessors/generated_files.py

@@ -5,7 +5,7 @@ import re
 import time
 from dataclasses import dataclass
 from mimetypes import guess_type
-from typing import NamedTuple, override
+from typing import NamedTuple, TypedDict, override
 
 import httpx
 from openai import AsyncOpenAI
@@ -46,6 +46,18 @@ from unique_toolkit.short_term_memory.service import ShortTermMemoryService
 logger = logging.getLogger(__name__)
 
 
+class ArtifactsDebugInfo(TypedDict):
+    """This turn's successfully-created artifacts, for analytics.
+
+    Feeds analytics.artifacts_created_count / artifacts_created_filetype. The
+    postprocessor returns this to the orchestrator, which owns the
+    ``DebugInfoManager`` and records it.
+    """
+
+    count: int
+    filetypes: list[str]
+
+
 class _ChatLoggerAdapter(logging.LoggerAdapter[logging.Logger]):
     """LoggerAdapter that prefixes every message with ``[chat_id=…]``."""
 
@@ -382,7 +394,9 @@ class DisplayCodeInterpreterFilesPostProcessor(
         )
 
     @override
-    async def run(self, loop_response: ResponsesLanguageModelStreamResponse) -> None:
+    async def run(
+        self, loop_response: ResponsesLanguageModelStreamResponse
+    ) -> ArtifactsDebugInfo | None:
         run_t0 = time.monotonic()
         self._log.info("run() started — fetching and uploading code interpreter files")
 
@@ -480,6 +494,39 @@ class DisplayCodeInterpreterFilesPostProcessor(
             save_ms,
         )
 
+        return self._compute_artifacts_debug_info(loop_response)
+
+    def _compute_artifacts_debug_info(
+        self, loop_response: ResponsesLanguageModelStreamResponse
+    ) -> ArtifactsDebugInfo | None:
+        """Compute this turn's successfully-created artifacts.
+
+        Feeds analytics.artifacts_created_count / artifacts_created_filetype.
+
+        Returns ``None`` when the Code Interpreter did not execute this turn
+        (``code_interpreter_calls`` empty). The postprocessor is registered
+        whenever the tool is *enabled*, so ``run()`` also fires on turns where the
+        model never invoked it — returning ``None`` there keeps analytics.artifacts_*
+        as null ("did not run") rather than 0/[] ("ran, created nothing"). When it
+        did run, count is scoped to this response's ``container_files`` (not
+        ``self._content_map``, which also holds prior-message files from short-term
+        memory), successful uploads only, with a deduped, sorted set of file
+        extensions.
+        """
+        # Interpreter did not run this turn → leave artifacts null, not 0/[].
+        if not loop_response.code_interpreter_calls:
+            return None
+
+        created_filenames = {
+            cf.filename
+            for cf in loop_response.container_files
+            if self._content_map.get(cf.filename) is not None
+        }
+        return ArtifactsDebugInfo(
+            count=len(created_filenames),
+            filetypes=sorted({_artifact_filetype(name) for name in created_filenames}),
+        )
+
     @override
     def apply_postprocessing_to_response(
         self, loop_response: ResponsesLanguageModelStreamResponse
@@ -924,6 +971,14 @@ class DisplayCodeInterpreterFilesPostProcessor(
         )
 
 
+def _artifact_filetype(filename: str) -> str:
+    """Lower-cased file extension for analytics, e.g. 'chart.png' -> 'png'.
+
+    Returns '' for an extensionless filename.
+    """
+    return filename.rsplit(".", 1)[-1].lower() if "." in filename else ""
+
+
 def _get_file_type(filename: str) -> CodeInterpreterFileType:
     mime = guess_type(filename)[0] or ""
     if mime.startswith("image/"):

{unique_toolkit-2026.30.0.dev17 → unique_toolkit-2026.30.0.dev19}/unique_toolkit/app/init_logging.py

@@ -10,6 +10,7 @@ class UTCFormatter(Formatter):
 
 unique_log_config = {
     "version": 1,
+    "disable_existing_loggers": False,
     "root": {"level": "DEBUG", "handlers": ["console"]},
     "handlers": {
         "console": {
@@ -29,4 +30,5 @@ unique_log_config = {
 
 
 def init_logging(config: dict[str, Any] = unique_log_config):
-    return dictConfig(config)
+    merged_config = {**config, "disable_existing_loggers": False}
+    return dictConfig(merged_config)