subscribeflow 1.8.2__tar.gz → 1.9.0__tar.gz

{subscribeflow-1.8.2 → subscribeflow-1.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: subscribeflow
-Version: 1.8.2
+Version: 1.9.0
 Summary: Python SDK for SubscribeFlow API - Email subscription management
 Project-URL: Homepage, https://subscribeflow.net
 Project-URL: Documentation, https://docs.subscribeflow.net/guides/sdk-setup

{subscribeflow-1.8.2 → subscribeflow-1.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "subscribeflow"
-version = "1.8.2"
+version = "1.9.0"
 description = "Python SDK for SubscribeFlow API - Email subscription management"
 readme = "README.md"
 license = { text = "MIT" }

{subscribeflow-1.8.2 → subscribeflow-1.9.0}/src/subscribeflow/__init__.py

@@ -47,7 +47,7 @@ from subscribeflow.models import (
     WebhookEndpoint,
 )
 
-__version__ = "1.8.1"
+__version__ = "1.8.3"
 
 __all__ = [
     # Client

{subscribeflow-1.8.2 → subscribeflow-1.9.0}/src/subscribeflow/mcp/server.py

@@ -11,6 +11,7 @@ Environment Variables:
 from __future__ import annotations
 
 import asyncio
+import json
 import logging
 import os
 from contextvars import ContextVar
@@ -148,6 +149,20 @@ def _format_template(template: Any) -> str:
     )
 
 
+def _format_template_detail(template: Any) -> str:
+    """Format a single template including its MJML and variables schema.
+
+    Kept out of ``_format_template`` so list output stays compact; the full
+    body is only needed when an agent inspects one template before updating it.
+    """
+    if template.variables_schema is None:
+        schema = "Variables schema: none"
+    else:
+        rendered = json.dumps(template.variables_schema, indent=2, ensure_ascii=False)
+        schema = f"Variables schema:\n{rendered}"
+    return f"{_format_template(template)}\n\n{schema}\n\nMJML content:\n{template.mjml_content}"
+
+
 def _format_campaign(campaign: Any) -> str:
     """Format a campaign for text output."""
     stats = ""
@@ -741,23 +756,32 @@ async def _execute_tool(client: SubscribeFlowClient, name: str, args: dict[str,
 
     if name == "get_template":
         template = await client.templates.get(args["slug"])
-        return f"Template details:\n\n{_format_template(template)}"
+        return f"Template details:\n\n{_format_template_detail(template)}"
 
     if name == "create_template":
         template = await client.templates.create(
             name=args["name"],
             subject=args["subject"],
             mjml_content=args["mjml_content"],
+            variables_schema=args.get("variables_schema"),
             category=args.get("category", "transactional"),
         )
         return f"Created template:\n\n{_format_template(template)}"
 
     if name == "update_template":
+        # The SDK drops None from the request body, so an explicit null would
+        # silently leave the stored schema in place.
+        if "variables_schema" in args and args["variables_schema"] is None:
+            return (
+                "Clearing variables_schema is not supported. "
+                "Omit the field to keep the current schema, or pass a new schema object."
+            )
         template = await client.templates.update(
             slug=args["slug"],
             name=args.get("name"),
             subject=args.get("subject"),
             mjml_content=args.get("mjml_content"),
+            variables_schema=args.get("variables_schema"),
             category=args.get("category"),
         )
         return f"Updated template:\n\n{_format_template(template)}"

{subscribeflow-1.8.2 → subscribeflow-1.9.0}/src/subscribeflow/mcp/tools.py

@@ -392,7 +392,7 @@ TEMPLATE_TOOLS = [
     ),
     Tool(
         name="get_template",
-        description="Get an email template by its slug",
+        description="Get an email template by its slug, including MJML and variables schema",
         inputSchema={
             "type": "object",
             "properties": {
@@ -422,6 +422,10 @@ TEMPLATE_TOOLS = [
                     "type": "string",
                     "description": "MJML template content",
                 },
+                "variables_schema": {
+                    "type": "object",
+                    "description": "JSON Schema describing the template variables",
+                },
                 "category": {
                     "type": "string",
                     "enum": ["transactional", "marketing"],
@@ -454,6 +458,14 @@ TEMPLATE_TOOLS = [
                     "type": "string",
                     "description": "New MJML template content",
                 },
+                "variables_schema": {
+                    "type": "object",
+                    "description": (
+                        "New JSON Schema describing the template variables. "
+                        "Replaces the stored schema; omit to leave it unchanged. "
+                        "Clearing it (null) is not supported."
+                    ),
+                },
                 "category": {
                     "type": "string",
                     "enum": ["transactional", "marketing"],