deeptutor-visualize 1.7.0__py3-none-any.whl

deeptutor/visualizers/tool.py

@@ -0,0 +1,150 @@
+"""Agent-loop submission tool for validated visualization envelopes."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from deeptutor.core.context import UnifiedContext
+from deeptutor.core.tool_protocol import BaseTool, ToolDefinition, ToolParameter, ToolResult
+
+from .protocol import (
+    REQUESTED_VISUALIZER_KEY,
+    VISUALIZATION_RESULT_KEY,
+    RendererRef,
+    VisualizationEnvelope,
+    VisualizationInteraction,
+    VisualizationPayload,
+    VisualizationPresentation,
+)
+from .registry import VisualizerRegistry, get_visualizer_registry
+
+
+class SubmitVisualizationTool(BaseTool):
+    """The only commit point from the chat loop into the canvas protocol."""
+
+    def get_definition(self) -> ToolDefinition:
+        return ToolDefinition(
+            name="submit_visualization",
+            description=(
+                "Validate and submit one complete visualization to DeepTutor's canvas. "
+                "Call this after choosing an installed visualizer and generating its exact "
+                "payload. If validation fails, repair the payload and call again."
+            ),
+            parameters=[
+                ToolParameter(
+                    name="visualizer",
+                    type="string",
+                    description=(
+                        "Installed visualization type to render. Use one exact id "
+                        "from the visualization protocol in the system prompt."
+                    ),
+                ),
+                ToolParameter(
+                    name="payload",
+                    type="string",
+                    description=(
+                        "Complete raw payload in the selected type's declared format. "
+                        "Do not wrap it in Markdown fences."
+                    ),
+                ),
+                ToolParameter(name="title", type="string", description="Short title."),
+                ToolParameter(
+                    name="description",
+                    type="string",
+                    description="One sentence explaining what to explore or notice.",
+                ),
+                ToolParameter(
+                    name="alt_text",
+                    type="string",
+                    description="Accessible description of the important visual content.",
+                ),
+            ],
+        )
+
+    async def execute(self, **kwargs: Any) -> ToolResult:
+        context = kwargs.get("_visualize_context")
+        if not isinstance(context, UnifiedContext):
+            return ToolResult(content="Visualization context is unavailable.", success=False)
+        registry = kwargs.get("_visualizer_registry")
+        if not isinstance(registry, VisualizerRegistry):
+            registry = get_visualizer_registry()
+
+        visualizer_id = str(kwargs.get("visualizer") or "").strip().lower()
+        requested = (
+            str(
+                kwargs.get("_requested_visualizer")
+                or context.metadata.get(REQUESTED_VISUALIZER_KEY)
+                or "auto"
+            )
+            .strip()
+            .lower()
+        )
+        if requested != "auto" and visualizer_id != requested:
+            return ToolResult(
+                content=(
+                    f"The user fixed the visualization type to '{requested}', but the "
+                    f"submission used '{visualizer_id}'. Regenerate it as '{requested}'."
+                ),
+                success=False,
+            )
+        plugin = registry.get(visualizer_id)
+        if plugin is None or not plugin.manifest.agentic:
+            available = ", ".join(item.manifest.id for item in registry.agentic())
+            return ToolResult(
+                content=f"Visualizer '{visualizer_id}' is unavailable. Available: {available}",
+                success=False,
+            )
+
+        ok, data, error = plugin.validate_payload(str(kwargs.get("payload") or ""))
+        if not ok:
+            return ToolResult(
+                content=(
+                    f"{plugin.manifest.display_name} payload validation failed: {error}. "
+                    "Repair the concrete issue and submit the complete payload again."
+                ),
+                success=False,
+                metadata={"visualizer": visualizer_id, "validation_error": error},
+            )
+
+        entry_url = ""
+        if plugin.manifest.render_target == "iframe":
+            entry_url = (
+                f"/api/visualizers/{plugin.manifest.id}/assets/{plugin.manifest.renderer_entry}"
+            )
+        envelope = VisualizationEnvelope(
+            render_type=plugin.manifest.id,
+            renderer=RendererRef(
+                id=plugin.manifest.id,
+                version=plugin.manifest.version,
+                target=plugin.manifest.render_target,
+                native_renderer=plugin.manifest.native_renderer,
+                entry_url=entry_url,
+            ),
+            payload=VisualizationPayload(format=plugin.manifest.payload_format, data=data),
+            presentation=VisualizationPresentation(
+                title=str(kwargs.get("title") or "").strip()[:160],
+                description=str(kwargs.get("description") or "").strip()[:1000],
+                alt_text=str(kwargs.get("alt_text") or "").strip()[:2000],
+            ),
+            interaction=VisualizationInteraction(
+                events=["prompt", "resize"] if plugin.manifest.render_target == "iframe" else [],
+            ),
+            fallback={"renderer": "svg"} if visualizer_id != "svg" else {},
+        )
+        context.metadata[VISUALIZATION_RESULT_KEY] = envelope.model_dump(mode="json")
+        return ToolResult(
+            content=(
+                f"Visualization accepted as {visualizer_id}. The canvas payload is committed. "
+                "Finish without repeating the payload."
+            ),
+            metadata={
+                "visualizer": visualizer_id,
+                "schema_version": envelope.schema_version,
+                "visualization_submitted": True,
+            },
+        )
+
+
+VISUALIZER_TOOL_TYPES: tuple[type[BaseTool], ...] = (SubmitVisualizationTool,)
+
+__all__ = ["SubmitVisualizationTool", "VISUALIZER_TOOL_TYPES"]

deeptutor_visualize-1.7.0.dist-info/METADATA

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: deeptutor-visualize
+Version: 1.7.0
+Summary: DeepTutor visualize module
+Requires-Python: <3.15,>=3.11
+Requires-Dist: deeptutor==1.7.0

deeptutor_visualize-1.7.0.dist-info/RECORD

@@ -0,0 +1,30 @@
+deeptutor/agents/visualize/__init__.py,sha256=hgFc67Db_sGGPEzL_hKrtKzJdWnFJv0Pm2yHCNgEDwM,111
+deeptutor/agents/visualize/capability.py,sha256=ywnNj0HkSHft0uMVg_fDIpU8pMqgZOTRr_hQ22RN6DI,24367
+deeptutor/agents/visualize/models.py,sha256=oYBcLQ5LKpwiDbFEKrBL5X11WqJywHfD-WLzueZiu78,4127
+deeptutor/agents/visualize/pipeline.py,sha256=6a5he396SfhD2fQokCuskjkEm_bWJYcSL6rSC50ffRM,2566
+deeptutor/agents/visualize/utils.py,sha256=jiSJEOsHuL0tXzlUqL31pMjfFTcx7p35lTwN5yxvqtM,7641
+deeptutor/agents/visualize/agents/__init__.py,sha256=4abGfLiEp1bPdGLUZcJo6_DwBmdE1uK4nbZ1LCIeZRI,273
+deeptutor/agents/visualize/agents/analysis_agent.py,sha256=7ahORxHmEZMSyagys2FYOaTerblNZ8s2AYTSXij3dCE,4123
+deeptutor/agents/visualize/agents/code_generator_agent.py,sha256=MuiuIOQ69hMOUsrflfqcxBwnpK83910CMzYCl_qP8g0,4761
+deeptutor/agents/visualize/agents/review_agent.py,sha256=d4IcG7Kae2eu2N9Gc4Xp1540xU7i-p6-2muSiTWv1D4,2540
+deeptutor/agents/visualize/prompts/en/analysis_agent.yaml,sha256=4dJECXu8OnokZ7Gi90carJPOwH7ilx_qBp0NTaHfooI,6621
+deeptutor/agents/visualize/prompts/en/code_generator_agent.yaml,sha256=TBM9PJlVDOCvmBsMgIEcxEYUx0HdpAJZOBL17RaypzY,10791
+deeptutor/agents/visualize/prompts/en/review_agent.yaml,sha256=KMwfsWNXebxqFFqysQwpBKxbzutHWq-r3a-cnArIFjU,1292
+deeptutor/agents/visualize/prompts/en/visualize.yaml,sha256=bGOGEgS9FOSIVimoDSw1ZijPW_9V8yJWKkevSSkSSIs,1523
+deeptutor/agents/visualize/prompts/zh/analysis_agent.yaml,sha256=k6-UBslQSpsS8sLPMMjpzFmJ8EdwJhqo1riqBgFBzyM,6497
+deeptutor/agents/visualize/prompts/zh/code_generator_agent.yaml,sha256=lc_0a87O3sd95eeGwouVG9LaHkxJLsuJMDolG69YaiE,10472
+deeptutor/agents/visualize/prompts/zh/review_agent.yaml,sha256=iIHk5-Tsx-s9e_eNx6bDLsGo8I7qy3KsjGM9MrAAN1E,1254
+deeptutor/agents/visualize/prompts/zh/visualize.yaml,sha256=okdn4tGDJ0T6T_kqzrzIO8CUxMvdtQ8pY9rwp7K7GCI,1448
+deeptutor/api/routers/visualizers.py,sha256=QsfCfQrnB9I4J6xMEbyT0lRQNpF2VswSFzDknxkM47A,5014
+deeptutor/visualizers/README.md,sha256=v_bIkyj-DGDzXc3Q5IngvZvuwuRjpzj3CnPeYk97GS0,2092
+deeptutor/visualizers/__init__.py,sha256=xe93oZOF4hHymbTSyBgFLgyhn1zeR5ChC9ZMVmh8XmE,508
+deeptutor/visualizers/builtin.py,sha256=WV8QwxpyXfTa-rUQG8wT0H5im5GlV_h6MYGVHkKPBR4,15659
+deeptutor/visualizers/loop_capability.py,sha256=q15sAs7dKdQQTMJyXV9u324L_7uWRTTpC-78G8X61S0,5119
+deeptutor/visualizers/protocol.py,sha256=OZLX03JXfHeMDXiA4mp82m5k2zy1-U1X0aQZTRs7liE,7949
+deeptutor/visualizers/registry.py,sha256=z2TBoc4yruYX7Iy_IB7Gw_4v53rwjzH9-7UgHy7assI,6390
+deeptutor/visualizers/store.py,sha256=fcvZ_RC7Av4RG8A8-ZcKPLAuIIQlCJEbaTqTvfjk2RA,11135
+deeptutor/visualizers/tool.py,sha256=YyaYD64-g7ffZGfKNIXh4KnF1hOnIO1Xalf1BVzbgB0,6163
+deeptutor_visualize-1.7.0.dist-info/METADATA,sha256=bJpoH4hV__xz-zM51UqvxkPiqsF19eFImv8daLdyzXY,161
+deeptutor_visualize-1.7.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+deeptutor_visualize-1.7.0.dist-info/top_level.txt,sha256=hnSHUG_vphMnHpT-DbMqcemCKadJ24laFGAWlovG2xM,10
+deeptutor_visualize-1.7.0.dist-info/RECORD,,

deeptutor_visualize-1.7.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

deeptutor_visualize-1.7.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+deeptutor