unique-toolkit 2026.30.0.dev3__tar.gz → 2026.30.0.dev5__tar.gz

{unique_toolkit-2026.30.0.dev3 → unique_toolkit-2026.30.0.dev5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-toolkit
-Version: 2026.30.0.dev3
+Version: 2026.30.0.dev5
 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>
@@ -16,7 +16,7 @@ Requires-Dist: sseclient>=0.0.27,<0.0.28
 Requires-Dist: openai>=1.105.0,<3
 Requires-Dist: platformdirs>=4.0.0,<5
 Requires-Dist: pillow>=12.1.1
-Requires-Dist: unique-sdk>=2026.30.0.dev0,<2026.30.0rc0
+Requires-Dist: unique-sdk>=2026.30.0.dev1,<2026.30.0rc0
 Requires-Dist: jambo>=0.1.2,<0.2
 Requires-Dist: jinja2>=3.1.6,<4
 Requires-Dist: docxtpl>=0.20.1,<0.21

{unique_toolkit-2026.30.0.dev3 → unique_toolkit-2026.30.0.dev5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique_toolkit"
-version = "2026.30.0.dev3"
+version = "2026.30.0.dev5"
 description = ""
 readme = "README.md"
 requires-python = ">=3.12"
@@ -28,7 +28,7 @@ dependencies = [
     "openai>=1.105.0,<3",
     "platformdirs>=4.0.0,<5",
     "pillow>=12.1.1",
-    "unique-sdk>=2026.30.0.dev0,<2026.30.0rc0",
+    "unique-sdk>=2026.30.0.dev1,<2026.30.0rc0",
     "jambo>=0.1.2,<0.2",
     "jinja2>=3.1.6,<4",
     "docxtpl>=0.20.1,<0.21",

{unique_toolkit-2026.30.0.dev3 → unique_toolkit-2026.30.0.dev5}/unique_toolkit/agentic/tools/config.py

@@ -1,4 +1,5 @@
 import logging
+from collections.abc import Sequence
 from enum import StrEnum
 from typing import Annotated, Any, Generic
 
@@ -98,6 +99,16 @@ class ToolBuildConfig(BaseModel, Generic[T]):
 
     is_enabled: bool = Field(default=True)
 
+    config_error: str | None = Field(
+        default=None,
+        exclude=True,
+        description=(
+            "Set when this tool's stored configuration failed to resolve and was "
+            "demoted to a disabled BaseToolConfig fallback. None for tools that are "
+            "valid, including tools that are deliberately disabled."
+        ),
+    )
+
     @model_validator(mode="before")
     def initialize_config_based_on_tool_name(
         cls,
@@ -115,6 +126,16 @@ class ToolBuildConfig(BaseModel, Generic[T]):
         if not isinstance(value, dict):
             return value
 
+        # config_error must only ever be set by this validator's own demotion
+        # path below. Since this is a plain field on a model with
+        # populate_by_name + a camelCase alias generator, an externally
+        # supplied config_error/configError (e.g. a stray key on a stored
+        # payload) would otherwise pass straight through untouched on every
+        # non-demotion return path and make a perfectly healthy tool look
+        # misconfigured to collect_tool_configuration_errors.
+        value.pop("config_error", None)
+        value.pop("configError", None)
+
         is_mcp_tool = _is_mcp_tool_payload(value)
         mcp_configuration = value.get("configuration", {})
 
@@ -168,8 +189,23 @@ class ToolBuildConfig(BaseModel, Generic[T]):
             )
             value["is_enabled"] = False
             value["isEnabled"] = False
+            value["config_error"] = f"Tool '{tool_name}' has invalid configuration."
             _ensure_base_tool_config(value)
             return value
 
         value["configuration"] = config
         return value
+
+
+def collect_tool_configuration_errors(
+    tools: Sequence["ToolBuildConfig[Any]"],
+) -> list[str]:
+    """Return the config_error message for every tool demoted due to an invalid config.
+
+    `initialize_config_based_on_tool_name` never raises: a tool whose stored
+    configuration is invalid is silently disabled with a BaseToolConfig fallback so
+    that one broken tool cannot take down the whole space. Callers that need to
+    surface these failures instead of ignoring them (e.g. to fail a chat request the
+    way an invalid configuration used to) can use this helper to recover the list.
+    """
+    return [tool.config_error for tool in tools if tool.config_error]

{unique_toolkit-2026.30.0.dev3 → unique_toolkit-2026.30.0.dev5}/unique_toolkit/agentic/tools/mcp/tool_wrapper.py

@@ -89,13 +89,14 @@ class MCPToolWrapper(Tool[MCPToolConfig]):
     def tool_description_for_system_prompt(self) -> str:
         """Return tool description for system prompt"""
         # Not using jinja here to keep it simple and not import new packages.
-        description = (
-            f"**MCP Server**: {self._mcp_server.name}\n"
-            f"**Tool Name**: {self.name}\n"
-            f"{self._mcp_tool.system_prompt}"
-        )
-
-        return description
+        lines = [
+            f"**MCP Server**: {self._mcp_server.name}",
+            f"**Tool Name**: {self.name}",
+        ]
+        if self._mcp_tool.system_prompt:
+            lines.append(self._mcp_tool.system_prompt)
+
+        return "\n".join(lines)
 
     def tool_description_for_user_prompt(self) -> str:
         return self._mcp_tool.user_prompt or ""

{unique_toolkit-2026.30.0.dev3 → unique_toolkit-2026.30.0.dev5}/unique_toolkit/app/__init__.py

@@ -40,6 +40,9 @@ from .schemas import (
 from .schemas import (
     EventUserMessage as EventUserMessage,
 )
+from .schemas import (
+    McpReferenceMapping as McpReferenceMapping,
+)
 from .schemas import (
     McpServer as McpServer,
 )

{unique_toolkit-2026.30.0.dev3 → unique_toolkit-2026.30.0.dev5}/unique_toolkit/app/schemas.py

@@ -89,6 +89,45 @@ class BaseEvent(BaseModel, Generic[FilterOptionsT]):
 ###
 
 
+class McpReferenceMapping(BaseModel):
+    """Optional per-tool rule for destructuring a list-returning MCP result into
+    individual citation references. A Unique-specific override; when unset the
+    generic citation heuristic is used. Paths are dotted (dict keys and numeric
+    list indices), e.g. ``"issues"`` or ``"fields.summary"``.
+    """
+
+    model_config = model_config
+
+    list_path: Optional[str] = Field(
+        default=None,
+        description="Dotted path to the array of records, e.g. 'issues' or 'result.items'.",
+    )
+    title_path: Optional[str] = Field(
+        default=None,
+        description="Dotted path to each record's title, e.g. 'key' or 'fields.summary'.",
+    )
+    title_template: Optional[str] = Field(
+        default=None,
+        description="Optional title template with {dotted.path} tokens, e.g. '{key} — {fields.summary}'. Takes precedence over title_path.",
+    )
+    details_path: Optional[str] = Field(
+        default=None,
+        description="Optional dotted path to a details line for each record.",
+    )
+    title_from_text: Optional[bool] = Field(
+        default=None,
+        description="Title from the leading text line instead of a field/template: for a single plain-text document (e.g. a fetched Markdown doc) or each plain-text item of a list.",
+    )
+    title_text_path: Optional[str] = Field(
+        default=None,
+        description="When titling a list of objects from text, the dotted path to the text field within each item (e.g. 'content'); leave unset when each list item is itself a plain string.",
+    )
+    title_max_chars: Optional[int] = Field(
+        default=None,
+        description="Max length of the title derived via title_from_text (default 120).",
+    )
+
+
 class McpTool(BaseModel):
     model_config = model_config
 
@@ -117,6 +156,10 @@ class McpTool(BaseModel):
         default=None,
         description="An optional tool format information. This is a Unique specific field.",
     )
+    reference_mapping: Optional[McpReferenceMapping] = Field(
+        default=None,
+        description="Optional rule for destructuring a list-returning result into individual citation references. This is a Unique specific field.",
+    )
     is_connected: bool = Field(
         description="Whether the tool is connected to the MCP server. This is a Unique specific field.",
     )