@danhachuel/thunderbolt 0.5.18 → 0.5.20

package/hermes_ui/canva_mcp_workflow.py

@@ -27,7 +27,7 @@ def _payload(result: Mapping[str, Any]) -> Any:
 
 def _items(value: Any) -> list[dict[str, Any]]:
     if isinstance(value, Mapping):
-        for key in ("items", "designs", "results"):
+        for key in ("items", "designs", "results", "candidates"):
             if isinstance(value.get(key), list):
                 return [dict(item) for item in value[key] if isinstance(item, Mapping)]
         for key in ("data", "result", "response"):
@@ -38,6 +38,25 @@ def _items(value: Any) -> list[dict[str, Any]]:
     return []
 
 
+def _first_named_id(value: Any, keys: tuple[str, ...]) -> str:
+    """Find an ID by field name without treating unrelated nested IDs as matches."""
+    if isinstance(value, Mapping):
+        for key in keys:
+            candidate = str(value.get(key) or "").strip()
+            if candidate:
+                return candidate
+        for child in value.values():
+            found = _first_named_id(child, keys)
+            if found:
+                return found
+    elif isinstance(value, list):
+        for child in value:
+            found = _first_named_id(child, keys)
+            if found:
+                return found
+    return ""
+
+
 def _design_id(value: Any) -> str:
     """Extract a Canva design identifier from REST/MCP result variants."""
     if isinstance(value, Mapping):
@@ -99,6 +118,22 @@ def _first_text_element(value: Any, *, text_context: bool = False) -> str:
     return ""
 
 
+def _has_richtext(value: Any) -> bool:
+    """Return whether a Canva payload contains at least one richtext item."""
+    if isinstance(value, Mapping):
+        for key, child in value.items():
+            if str(key).lower() in {"richtexts", "rich_texts", "text_elements", "textelements"}:
+                if isinstance(child, list) and any(isinstance(item, Mapping) for item in child):
+                    return True
+                if isinstance(child, Mapping) and child:
+                    return True
+            if _has_richtext(child):
+                return True
+    elif isinstance(value, list):
+        return any(_has_richtext(child) for child in value)
+    return False
+
+
 def _first_page(value: Any) -> tuple[str, list[dict[str, Any]]]:
     pages: list[dict[str, Any]] = []
     if isinstance(value, Mapping) and isinstance(value.get("pages"), list):
@@ -132,17 +167,61 @@ def run_direct_canva_thumbnail(
         candidates = _items(result)
         if not candidates:
             raise CanvaMCPError("Canva não encontrou designs para as palavras-chave da thumbnail.")
-        selected = next((candidate for candidate in candidates if _design_id(candidate)), candidates[0])
-        design_id = _design_id(selected)
-        if not design_id:
+        candidates = [candidate for candidate in candidates if _design_id(candidate)]
+        if not candidates:
             raise CanvaMCPError("A pesquisa Canva devolveu um design sem ID.")
 
         get_name = "get-design-content" if "get-design-content" in available else "get_design_content"
-        content = _payload(client.call(get_name, {
-            "design_id": design_id,
-            "content_types": ["richtexts"],
-            "user_intent": "Inspect the selected Canva design before applying the thumbnail edit.",
-        }))
+        selected = None
+        content: Any = {}
+        for candidate in candidates:
+            candidate_id = _design_id(candidate)
+            candidate_content = _payload(client.call(get_name, {
+                "design_id": candidate_id,
+                "content_types": ["richtexts"],
+                "user_intent": "Inspect the selected Canva design before applying the thumbnail edit.",
+            }))
+            if _has_richtext(candidate_content):
+                selected = candidate
+                content = candidate_content
+                break
+        if selected is None:
+            generate_name = "generate-design" if "generate-design" in available else "generate_design"
+            create_name = "create-design-from-candidate" if "create-design-from-candidate" in available else "create_design_from_candidate"
+            if generate_name not in available or create_name not in available:
+                raise CanvaMCPError("Os designs Canva encontrados não têm elementos de texto editáveis e esta sessão MCP não disponibiliza geração de design.")
+            blueprint_text = str(blueprint.get("content") or "")[:5000]
+            generated = _payload(client.call(generate_name, {
+                "design_type": "youtube_thumbnail",
+                "query": (
+                    "Create one editable YouTube thumbnail in 16:9 format for this topic: "
+                    f"{title}. Context: {topic}. Thumbnail prompt: {prompt[:1200]}. "
+                    "Use clearly editable headline text boxes, a strong background, readable text "
+                    "background shapes, relevant icons, depth/effects, and high-contrast lettering. "
+                    "Follow these local Thumbnail Blueprint rules: " + blueprint_text
+                ),
+                "user_intent": "Create an editable YouTube thumbnail with text boxes and visual elements when searched designs are not editable.",
+            }))
+            job_id = _first_named_id(generated, ("job_id", "jobId"))
+            generated_candidates = _items(generated)
+            candidate_id = _first_named_id(generated_candidates[0] if generated_candidates else {}, ("candidate_id", "candidateId"))
+            if not job_id or not candidate_id:
+                raise CanvaMCPError("Canva não devolveu um candidato editável para a thumbnail.")
+            created = _payload(client.call(create_name, {
+                "job_id": job_id,
+                "candidate_id": candidate_id,
+                "user_intent": "Create the selected editable YouTube thumbnail candidate in the user's Canva account.",
+            }))
+            design_id = _design_id(created)
+            if not design_id:
+                raise CanvaMCPError("Canva não devolveu o ID do design gerado.")
+            selected = {"id": design_id}
+            content = _payload(client.call(get_name, {
+                "design_id": design_id,
+                "content_types": ["richtexts"],
+                "user_intent": "Inspect the generated editable thumbnail before applying the final lettering.",
+            }))
+        design_id = _design_id(selected)
         start_name = "start-editing-transaction" if "start-editing-transaction" in available else "start_editing_transaction"
         started = _payload(client.call(start_name, {
             "design_id": design_id,
@@ -154,6 +233,12 @@ def run_direct_canva_thumbnail(
         page_id, pages = _first_page(started)
         element_id = _first_text_element(started) or _first_text_element(content)
         if not element_id:
+            cancel_name = "cancel-editing-transaction" if "cancel-editing-transaction" in available else "cancel_editing_transaction"
+            if cancel_name in available:
+                client.call(cancel_name, {
+                    "transaction_id": transaction_id,
+                    "user_intent": "Discard the Canva editing transaction because no editable text element was returned.",
+                })
             raise CanvaMCPError("O design Canva não devolveu um elemento de texto editável.")
         perform_name = "perform-editing-operations" if "perform-editing-operations" in available else "perform_editing_operations"
         operations = [{"type": "replace_text", "element_id": element_id, "text": title[:255]}]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.5.18",
+  "version": "0.5.20",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "license": "MIT",
   "main": "scripts/cli.mjs",