Upload 86 files

.gitattributes

@@ -40,3 +40,5 @@ scratch_VLM/Documentation_Scratch/Scratch[[:space:]]3.0[[:space:]]BlocK_shape_ex
 scratch_VLM/game_samples/Duck-Pocalypse.sb3 filter=lfs diff=lfs merge=lfs -text
 scratch_VLM/game_samples/Pong[[:space:]]Game.sb3 filter=lfs diff=lfs merge=lfs -text
 scratch_VLM/scratch_agent/uploads/documents/LLM_based_QA_chatbot_builder.pdf filter=lfs diff=lfs merge=lfs -text
+v2/scratch_agent/static/assets/backdrops/ef9973bcff6d4cbc558e946028ec7d23.png filter=lfs diff=lfs merge=lfs -text
+v2/scratch_agent/uploads/documents/LLM_based_QA_chatbot_builder.pdf filter=lfs diff=lfs merge=lfs -text

v2/scratch_agent/.gitignore

@@ -0,0 +1 @@
+a

v2/scratch_agent/action_node.py

@@ -0,0 +1,452 @@
+import json
+import uuid
+import logging
+from typing import Dict, Any, List
+
+# Assume GameState is a TypedDict or similar for clarity
+# from typing import TypedDict
+# class GameState(TypedDict):
+#     description: str
+#     project_json: Dict[str, Any]
+#     action_plan: Dict[str, Any]
+#     sprite_initial_positions: Dict[str, Any]
+
+# Placeholder for actual GameState in your application
+GameState = Dict[str, Any]
+
+logger = logging.getLogger(__name__)
+
+# --- Mock Agent for demonstration ---
+class MockAgent:
+    def invoke(self, payload: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Mocks an LLM agent invocation. In a real scenario, this would call your
+        actual LLM API (e.g., through LangChain, LlamaIndex, etc.).
+        """
+        user_message = payload["messages"][-1]["content"]
+        print(f"\n--- Mock Agent Received Prompt (partial) ---\n{user_message[:500]}...\n------------------------------------------")
+
+        # Simplified mock responses for demonstration purposes
+        # In a real scenario, the LLM would generate actual Scratch block JSON
+        if "Propose a high-level action flow" in user_message:
+            return {
+                "messages": [{
+                    "content": json.dumps({
+                        "action_overall_flow": {
+                            "Sprite1": {
+                                "description": "Basic movement and interaction",
+                                "plans": [
+                                    {
+                                        "event": "when flag clicked",
+                                        "logic": "forever loop: move 10 steps, if touching Edge then turn 15 degrees"
+                                    },
+                                    {
+                                        "event": "when space key pressed",
+                                        "logic": "say Hello! for 2 seconds"
+                                    }
+                                ]
+                            },
+                            "Ball": {
+                                "description": "Simple bouncing behavior",
+                                "plans": [
+                                    {
+                                        "event": "when flag clicked",
+                                        "logic": "move 5 steps, if on edge bounce"
+                                    }
+                                ]
+                            }
+                        }
+                    })
+                }]
+            }
+        elif "You are an AI assistant generating Scratch 3.0 block JSON" in user_message:
+            # This mock response is highly simplified. A real LLM would generate
+            # valid Scratch blocks based on the provided relevant catalog and plan.
+            # We're just demonstrating the *mechanism* of filtering the catalog.
+            if "Sprite1" in user_message:
+                return {
+                    "messages": [{
+                        "content": json.dumps({
+                            f"block_id_{generate_block_id()}": {
+                                "opcode": "event_whenflagclicked",
+                                "next": f"block_id_{generate_block_id()}_forever",
+                                "parent": None,
+                                "inputs": {}, "fields": {}, "shadow": False, "topLevel": True, "x": 100, "y": 100
+                            },
+                            f"block_id_{generate_block_id()}_forever": {
+                                "opcode": "control_forever",
+                                "next": None,
+                                "parent": f"block_id_{generate_block_id()}",
+                                "inputs": {
+                                    "SUBSTACK": [2, f"block_id_{generate_block_id()}_move"]
+                                }, "fields": {}, "shadow": False, "topLevel": False
+                            },
+                            f"block_id_{generate_block_id()}_move": {
+                                "opcode": "motion_movesteps",
+                                "next": f"block_id_{generate_block_id()}_if",
+                                "parent": f"block_id_{generate_block_id()}_forever",
+                                "inputs": {
+                                    "STEPS": [1, [4, "10"]]
+                                }, "fields": {}, "shadow": False, "topLevel": False
+                            },
+                             f"block_id_{generate_block_id()}_if": {
+                                "opcode": "control_if",
+                                "next": None,
+                                "parent": f"block_id_{generate_block_id()}_forever",
+                                "inputs": {
+                                    "CONDITION": [2, f"block_id_{generate_block_id()}_touching"],
+                                    "SUBSTACK": [2, f"block_id_{generate_block_id()}_turn"]
+                                }, "fields": {}, "shadow": False, "topLevel": False
+                            },
+                            f"block_id_{generate_block_id()}_touching": {
+                                "opcode": "sensing_touchingobject",
+                                "next": None,
+                                "parent": f"block_id_{generate_block_id()}_if",
+                                "inputs": {
+                                    "TOUCHINGOBJECTMENU": [1, f"block_id_{generate_block_id()}_touching_menu"]
+                                }, "fields": {}, "shadow": False, "topLevel": False
+                            },
+                            f"block_id_{generate_block_id()}_touching_menu": {
+                                "opcode": "sensing_touchingobjectmenu",
+                                "next": None,
+                                "parent": f"block_id_{generate_block_id()}_touching",
+                                "inputs": {},
+                                "fields": {"TOUCHINGOBJECTMENU": ["_edge_", None]},
+                                "shadow": True, "topLevel": False
+                            },
+                            f"block_id_{generate_block_id()}_turn": {
+                                "opcode": "motion_turnright",
+                                "next": None,
+                                "parent": f"block_id_{generate_block_id()}_if",
+                                "inputs": {
+                                    "DEGREES": [1, [4, "15"]]
+                                }, "fields": {}, "shadow": False, "topLevel": False
+                            },
+                            f"block_id_{generate_block_id()}_say": {
+                                "opcode": "looks_sayforsecs",
+                                "next": None,
+                                "parent": None, # This block would typically be part of a separate script
+                                "inputs": {
+                                    "MESSAGE": [1, [10, "Hello!"]],
+                                    "SECS": [1, [4, "2"]]
+                                }, "fields": {}, "shadow": False, "topLevel": True, "x": 300, "y": 100
+                            }
+                        })
+                    }]
+                }
+            elif "Ball" in user_message:
+                 return {
+                    "messages": [{
+                        "content": json.dumps({
+                            f"block_id_{generate_block_id()}": {
+                                "opcode": "event_whenflagclicked",
+                                "next": f"block_id_{generate_block_id()}_moveball",
+                                "parent": None,
+                                "inputs": {}, "fields": {}, "shadow": False, "topLevel": True, "x": 100, "y": 100
+                            },
+                            f"block_id_{generate_block_id()}_moveball": {
+                                "opcode": "motion_movesteps",
+                                "next": f"block_id_{generate_block_id()}_edgebounce",
+                                "parent": f"block_id_{generate_block_id()}",
+                                "inputs": {
+                                    "STEPS": [1, [4, "5"]]
+                                }, "fields": {}, "shadow": False, "topLevel": False
+                            },
+                            f"block_id_{generate_block_id()}_edgebounce": {
+                                "opcode": "motion_ifonedgebounce",
+                                "next": None,
+                                "parent": f"block_id_{generate_block_id()}_moveball",
+                                "inputs": {}, "fields": {}, "shadow": False, "topLevel": False
+                            }
+                        })
+                    }]
+                }
+        return {"messages": [{"content": "[]"}]} # Default empty response
+
+agent = MockAgent()
+
+# Helper function to generate a unique block ID
+def generate_block_id():
+    return str(uuid.uuid4())[:10].replace('-', '') # Shorten for readability, ensure uniqueness
+
+# Placeholder for your extract_json_from_llm_response function
+def extract_json_from_llm_response(response_string):
+    try:
+        # Assuming the LLM response is ONLY the JSON string within triple backticks
+        json_match = response_string.strip().replace("```json", "").replace("```", "").strip()
+        return json.loads(json_match)
+    except json.JSONDecodeError as e:
+        logger.error(f"Failed to decode JSON from LLM response: {e}")
+        logger.error(f"Raw response: {response_string}")
+        raise ValueError("Invalid JSON response from LLM")
+
+# --- GLOBAL CATALOG OF ALL SCRATCH BLOCKS ---
+# This is where you would load your block_content.json
+# For demonstration, I'm using your provided snippets and adding some common ones.
+# In a real application, you'd load this once at startup.
+ALL_SCRATCH_BLOCKS_CATALOG = {
+    "motion_movesteps": {
+        "opcode": "motion_movesteps", "next": None, "parent": None,
+        "inputs": {"STEPS": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True, "x": 464, "y": -416
+    },
+    "motion_turnright": {
+        "opcode": "motion_turnright", "next": None, "parent": None,
+        "inputs": {"DEGREES": [1, [4, "15"]]}, "fields": {}, "shadow": False, "topLevel": True, "x": 467, "y": -316
+    },
+    "motion_ifonedgebounce": {
+        "opcode": "motion_ifonedgebounce", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True, "x": 467, "y": -316
+    },
+    "event_whenflagclicked": {
+        "opcode": "event_whenflagclicked", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True, "x": 10, "y": 10
+    },
+    "event_whenkeypressed": {
+        "opcode": "event_whenkeypressed", "next": None, "parent": None,
+        "inputs": {}, "fields": {"KEY_OPTION": ["space", None]}, "shadow": False, "topLevel": True, "x": 10, "y": 10
+    },
+    "control_forever": {
+        "opcode": "control_forever", "next": None, "parent": None,
+        "inputs": {"SUBSTACK": [2, "some_id"]}, "fields": {}, "shadow": False, "topLevel": True, "x": 10, "y": 10
+    },
+    "control_if": {
+        "opcode": "control_if", "next": None, "parent": None,
+        "inputs": {"CONDITION": [2, "some_id"], "SUBSTACK": [2, "some_id_2"]}, "fields": {}, "shadow": False, "topLevel": True, "x": 10, "y": 10
+    },
+    "looks_sayforsecs": {
+        "opcode": "looks_sayforsecs", "next": None, "parent": None,
+        "inputs": {"MESSAGE": [1, [10, "Hello!"]], "SECS": [1, [4, "2"]]}, "fields": {}, "shadow": False, "topLevel": True, "x": 10, "y": 10
+    },
+    "looks_say": {
+        "opcode": "looks_say", "next": None, "parent": None,
+        "inputs": {"MESSAGE": [1, [10, "Hello!"]]}, "fields": {}, "shadow": False, "topLevel": True, "x": 10, "y": 10
+    },
+    "sensing_touchingobject": {
+        "opcode": "sensing_touchingobject", "next": None, "parent": None,
+        "inputs": {"TOUCHINGOBJECTMENU": [1, "some_id"]}, "fields": {}, "shadow": False, "topLevel": True, "x": 10, "y": 10
+    },
+    "sensing_touchingobjectmenu": {
+        "opcode": "sensing_touchingobjectmenu", "next": None, "parent": None,
+        "inputs": {}, "fields": {"TOUCHINGOBJECTMENU": ["_mouse_", None]}, "shadow": True, "topLevel": True, "x": 10, "y": 10
+    },
+    # Add more blocks from your block_content.json here...
+}
+
+# --- Heuristic-based block selection ---
+def get_relevant_blocks_for_plan(action_plan: Dict[str, Any], all_blocks_catalog: Dict[str, Any]) -> Dict[str, Any]:
+    """
+    Analyzes the natural language action plan and selects relevant Scratch blocks
+    from the comprehensive catalog. This is a heuristic approach and might need
+    to be refined based on your specific use cases and LLM capabilities.
+    """
+    relevant_opcodes = set()
+
+    # Always include common event blocks
+    relevant_opcodes.add("event_whenflagclicked")
+    relevant_opcodes.add("event_whenkeypressed") # Could be more specific if key is mentioned
+
+    # Keyword to opcode mapping (can be expanded)
+    keyword_map = {
+        "move": "motion_movesteps",
+        "steps": "motion_movesteps",
+        "turn": "motion_turnright",
+        "rotate": "motion_turnright",
+        "bounce": "motion_ifonedgebounce",
+        "edge": "motion_ifonedgebounce",
+        "forever": "control_forever",
+        "loop": "control_forever",
+        "if": "control_if",
+        "condition": "control_if",
+        "say": "looks_say",
+        "hello": "looks_say", # Simple example, might need more context
+        "touching": "sensing_touchingobject",
+        "mouse pointer": "sensing_touchingobjectmenu",
+        "edge": "sensing_touchingobjectmenu", # For touching edge
+    }
+
+    # Iterate through the action plan to find keywords
+    for sprite_name, sprite_actions in action_plan.get("action_overall_flow", {}).items():
+        for plan in sprite_actions.get("plans", []):
+            event_logic = plan.get("event", "").lower() + " " + plan.get("logic", "").lower()
+
+            # Check for direct opcode matches (if the LLM somehow outputs opcodes in its plan)
+            for opcode in all_blocks_catalog.keys():
+                if opcode in event_logic:
+                    relevant_opcodes.add(opcode)
+
+            # Check for keywords
+            for keyword, opcode in keyword_map.items():
+                if keyword in event_logic:
+                    relevant_opcodes.add(opcode)
+                    # Add associated shadow blocks if known
+                    if opcode == "sensing_touchingobject":
+                        relevant_opcodes.add("sensing_touchingobjectmenu")
+                    if opcode == "event_whenkeypressed":
+                         relevant_opcodes.add("event_whenkeypressed") # It's already there but good to be explicit
+
+    # Construct the filtered catalog
+    relevant_blocks_catalog = {
+        opcode: all_blocks_catalog[opcode]
+        for opcode in relevant_opcodes if opcode in all_blocks_catalog
+    }
+    return relevant_blocks_catalog
+
+# --- New Action Planning Node ---
+def plan_sprite_actions(state: GameState):
+    logger.info("--- Running PlanSpriteActionsNode ---")
+
+    planning_prompt = (
+        f"You are an AI assistant tasked with planning Scratch 3.0 block code for a game. "
+        f"The game description is: '{state['description']}'.\n\n"
+        f"Here are the sprites currently in the project: {', '.join(target['name'] for target in state['project_json']['targets'] if not target['isStage']) if len(state['project_json']['targets']) > 1 else 'None'}.\n"
+        f"Initial positions: {json.dumps(state.get('sprite_initial_positions', {}), indent=2)}\n\n"
+        f"Consider the main actions and interactions required for each sprite. "
+        f"Think step-by-step about what each sprite needs to *do*, *when* it needs to do it (events), "
+        f"and if any actions need to *repeat* or depend on *conditions*.\n\n"
+        f"Propose a high-level action flow for each sprite in the following JSON format. "
+        f"Do NOT generate Scratch block JSON yet. Only describe the logic using natural language or simplified pseudo-code.\n\n"
+        f"Example format:\n"
+        f"```json\n"
+        f"{{\n"
+        f"  \"action_overall_flow\": {{\n"
+        f"    \"Sprite1\": {{\n"
+        f"      \"description\": \"Main character actions\",\n"
+        f"      \"plans\": [\n"
+        f"        {{\n"
+        f"          \"event\": \"when flag clicked\",\n"
+        f"          \"logic\": \"forever loop: move 10 steps, if on edge bounce\"\n"
+        f"        }},\n"
+        f"        {{\n"
+        f"          \"event\": \"when space key pressed\",\n"
+        f"          \"logic\": \"change y by 10, wait 0.1 seconds, change y by -10\"\n"
+        f"        }}\n"
+        f"      ]\n"
+        f"    }},\n"
+        f"    \"Ball\": {{\n"
+        f"      \"description\": \"Projectile movement\",\n"
+        f"      \"plans\": [\n"
+        f"        {{\n"
+        f"          \"event\": \"when I start as a clone\",\n"
+        f"          \"logic\": \"glide 1 sec to random position, if touching Sprite1 then stop this script\"\n"
+        f"        }}\n"
+        f"      ]\n"
+        f"    }}\n"
+        f"  }}\n"
+        f"}}\n"
+        f"```\n\n"
+        f"Return ONLY the JSON object for the action overall flow."
+    )
+
+    try:
+        response = agent.invoke({"messages": [{"role": "user", "content": planning_prompt}]})
+        raw_response = response["messages"][-1].content
+        print("Raw response from LLM [PlanSpriteActionsNode]:", raw_response)
+        action_plan = extract_json_from_llm_response(raw_response)
+        logger.info("Sprite action plan generated by PlanSpriteActionsNode.")
+        return {"action_plan": action_plan}
+    except Exception as e:
+        logger.error(f"Error in PlanSpriteActionsNode: {e}")
+        raise
+
+# --- Updated Action Node Builder (to consume the plan and build blocks) ---
+def build_action_nodes(state: GameState):
+    logger.info("--- Running ActionNodeBuilder ---")
+
+    action_plan = state.get("action_plan", {})
+    if not action_plan:
+        raise ValueError("No action plan found in state. Run PlanSpriteActionsNode first.")
+
+    # Convert the Scratch project JSON to a mutable Python object
+    project_json = state["project_json"]
+    targets = project_json["targets"]
+
+    # We need a way to map sprite names to their actual target objects in project_json
+    sprite_map = {target["name"]: target for target in targets if not target["isStage"]}
+
+    # --- NEW: Get only the relevant blocks for the entire action plan ---
+    relevant_scratch_blocks_catalog = get_relevant_blocks_for_plan(action_plan, ALL_SCRATCH_BLOCKS_CATALOG)
+    logger.info(f"Filtered {len(relevant_scratch_blocks_catalog)} relevant blocks out of {len(ALL_SCRATCH_BLOCKS_CATALOG)} total.")
+
+
+    # Iterate through the planned actions for each sprite
+    for sprite_name, sprite_actions in action_plan.get("action_overall_flow", {}).items():
+        if sprite_name in sprite_map:
+            current_sprite_target = sprite_map[sprite_name]
+            # Ensure 'blocks' field exists for the sprite
+            if "blocks" not in current_sprite_target:
+                current_sprite_target["blocks"] = {}
+
+            # Generate block JSON based on the detailed action plan for this sprite
+            # This is where the LLM's role becomes crucial: translating logic to blocks
+            llm_block_generation_prompt = (
+                f"You are an AI assistant generating Scratch 3.0 block JSON based on a provided plan. "
+                f"The current sprite is '{sprite_name}'.\n"
+                f"Its planned actions are:\n"
+                f"```json\n{json.dumps(sprite_actions, indent=2)}\n```\n\n"
+                f"Here is a **curated catalog of only the most relevant Scratch 3.0 blocks** for this plan:\n"
+                f"```json\n{json.dumps(relevant_scratch_blocks_catalog, indent=2)}\n```\n\n"
+                f"Current Scratch project JSON (for context, specifically this sprite's existing blocks if any):\n"
+                f"```json\n{json.dumps(current_sprite_target, indent=2)}\n```\n\n"
+                f"**Instructions:**\n"
+                f"1.  For each planned event and its associated logic, generate the corresponding Scratch 3.0 block JSON.\n"
+                f"2.  **Generate unique block IDs** for every new block. Use a format like 'block_id_abcdef12'.\n" # Updated ID format hint
+                f"3.  Properly link blocks using `next` and `parent` fields to form execution stacks. Hat blocks (`topLevel: true`, `parent: null`).\n"
+                f"4.  Correctly fill `inputs` and `fields` based on the catalog and the plan's logic (e.g., specific values for motion, keys for events, conditions for controls).\n"
+                f"5.  For C-blocks (like `control_repeat`, `control_forever`, `control_if`), use the `SUBSTACK` input to link to the first block inside its loop/conditional.\n"
+                f"6.  If the plan involves operators (e.g., 'if touching Sprite1'), use the appropriate operator blocks from the catalog and link them correctly as `CONDITION` inputs.\n"
+                f"7.  Ensure that any shadow blocks (e.g., for dropdowns like `motion_goto_menu`, `sensing_touchingobjectmenu`) are generated with `shadow: true` and linked correctly as inputs to their parent block.\n"
+                f"8.  Return ONLY the **updated 'blocks' dictionary** for this specific sprite. Do NOT return the full project JSON. ONLY the `blocks` dictionary."
+            )
+
+            try:
+                response = agent.invoke({"messages": [{"role": "user", "content": llm_block_generation_prompt}]})
+                raw_response = response["messages"][-1].content
+                print(f"Raw response from LLM [ActionNodeBuilder - {sprite_name}]:", raw_response)
+                generated_blocks = extract_json_from_llm_response(raw_response)
+                current_sprite_target["blocks"].update(generated_blocks) # Merge new blocks
+                logger.info(f"Action blocks added for sprite '{sprite_name}' by ActionNodeBuilder.")
+            except Exception as e:
+                logger.error(f"Error generating blocks for sprite '{sprite_name}': {e}")
+                # Depending on robustness needed, you might continue or re-raise
+                raise
+
+    return {"project_json": project_json}
+
+# --- Example Usage (to demonstrate the flow) ---
+if __name__ == "__main__":
+    # Initialize a mock game state
+    initial_game_state = {
+        "description": "A simple game where a sprite moves and says hello.",
+        "project_json": {
+            "targets": [
+                {"isStage": True, "name": "Stage", "blocks": {}},
+                {"isStage": False, "name": "Sprite1", "blocks": {}},
+                {"isStage": False, "name": "Ball", "blocks": {}}
+            ]
+        },
+        "sprite_initial_positions": {}
+    }
+
+    # Step 1: Plan Sprite Actions
+    try:
+        state_after_planning = plan_sprite_actions(initial_game_state)
+        initial_game_state.update(state_after_planning)
+        print("\n--- Game State After Planning ---")
+        print(json.dumps(initial_game_state, indent=2))
+    except Exception as e:
+        print(f"Planning failed: {e}")
+        exit()
+
+    # Step 2: Build Action Nodes (Generate Blocks)
+    try:
+        state_after_building = build_action_nodes(initial_game_state)
+        initial_game_state.update(state_after_building)
+        print("\n--- Game State After Building Blocks ---")
+        # Print only the blocks for a specific sprite to keep output manageable
+        for target in initial_game_state["project_json"]["targets"]:
+            if not target["isStage"]:
+                print(f"\nBlocks for {target['name']}:")
+                print(json.dumps(target.get('blocks', {}), indent=2))
+
+    except Exception as e:
+        print(f"Building blocks failed: {e}")

v2/scratch_agent/agent.py

@@ -0,0 +1,1647 @@
+#─── Basic imports ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+import os
+import math
+import sqlite3
+import fitz  # PyMuPDF for PDF parsing
+import re
+
+from dotenv import load_dotenv
+# Load environment variables from .env file
+load_dotenv()  # This line ensures .env variables are loaded
+
+from langgraph.graph import START, StateGraph, MessagesState, END
+from langgraph.prebuilt import tools_condition
+from langgraph.prebuilt import ToolNode
+from langgraph.constants import START
+from langchain_core.tools import tool
+from langchain.schema import SystemMessage
+#from langchain.chat_models import init_chat_model
+#from langgraph.prebuilt import create_react_agent
+
+from langchain.embeddings import HuggingFaceEmbeddings
+#from langchain.vectorstores import Pinecone
+from langchain.tools.retriever import create_retriever_tool
+#import pinecone
+#from pinecone import Pinecone as PineconeClient, ServerlessSpec
+#from pinecone import Index  # the blocking‐call client constructor
+#from pinecone import Pinecone as PineconeClient, ServerlessSpec
+from langchain.embeddings import HuggingFaceEmbeddings
+from langchain_community.vectorstores.pinecone import Pinecone as LC_Pinecone
+
+# ─── Langchain Frameworks ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+#from langchain.tools import Tool
+from langchain.chat_models import ChatOpenAI
+from langchain_groq import ChatGroq
+from langchain_mistralai import ChatMistralAI
+from langchain.agents import initialize_agent, AgentType
+from langchain.schema import Document
+from langchain.chains import RetrievalQA
+from langchain.embeddings import OpenAIEmbeddings
+from langchain_community.embeddings import HuggingFaceEmbeddings
+from langchain.vectorstores import FAISS
+from langchain.text_splitter import RecursiveCharacterTextSplitter
+from langchain.prompts import PromptTemplate
+from langchain_community.document_loaders import TextLoader, PyMuPDFLoader
+from langchain_community.document_loaders.wikipedia import WikipediaLoader
+from langchain_community.document_loaders.arxiv import ArxivLoader
+from langchain_experimental.tools.python.tool import PythonREPLTool
+
+
+# ─── Memory ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+from langchain.agents import initialize_agent, AgentType
+from langchain.tools import Tool
+from typing import List, Callable
+from langchain.schema import BaseMemory, AIMessage, HumanMessage, SystemMessage
+from langchain.schema import HumanMessage, SystemMessage
+from langchain.llms.base import LLM
+from langchain.memory.chat_memory import BaseChatMemory
+from pydantic import PrivateAttr
+from langchain_core.messages import get_buffer_string
+            
+# ─── Image Processing ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+ 
+from PIL import Image
+import pytesseract
+from transformers import pipeline
+from groq import Groq
+import requests
+from io import BytesIO
+from transformers import pipeline, TrOCRProcessor, VisionEncoderDecoderModel
+import requests
+import base64
+from PIL import UnidentifiedImageError
+
+# ─── Browser var ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+from typing import List, Dict
+import json
+from io import BytesIO
+#from langchain.tools import tool  # or langchain_core.tools
+from playwright.sync_api import sync_playwright
+from duckduckgo_search import DDGS
+import time
+import random
+import logging
+from functools import lru_cache, wraps
+import requests
+from playwright.sync_api import sync_playwright
+from bs4 import BeautifulSoup
+import tenacity
+from tenacity import retry, stop_after_attempt, wait_exponential
+
+# Initialize logger
+logger = logging.getLogger(__name__)
+logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')
+
+# Additional imports for new functionality
+import pandas as pd
+from PyPDF2 import PdfReader
+import docx
+import pytesseract
+import speech_recognition as sr
+from pydub import AudioSegment
+from pytube import YouTube
+from newspaper import Article
+from langchain.document_loaders import ArxivLoader
+from langchain_community.document_loaders.youtube import YoutubeLoader, TranscriptFormat
+
+from playwright.sync_api import sync_playwright
+# Attempt to import Playwright for dynamic page rendering
+try:
+    from playwright.sync_api import sync_playwright
+    _playwright_available = True
+except ImportError:
+    _playwright_available = False
+
+# Define forbidden keywords for basic NSFW filtering
+_forbidden = ["porn", "sex", "xxx", "nude", "erotic"]
+
+# ─── LLM Setup ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+# Load OpenAI API key from environment (required for LLM and embeddings)
+
+# API Keys from .env file
+os.environ.setdefault("OPENAI_API_KEY", "<YOUR_OPENAI_KEY>")  # Set your own key or env var
+os.environ["GROQ_API_KEY"] = os.getenv("GROQ_API_KEY", "default_key_or_placeholder")
+os.environ["MISTRAL_API_KEY"] = os.getenv("MISTRAL_API_KEY", "default_key_or_placeholder")
+
+# Tavily API Key
+TAVILY_API_KEY = os.getenv("TAVILY_API_KEY", "default_key_or_placeholder")
+_forbidden = ["nsfw", "porn", "sex", "explicit"]
+_playwright_available = True  # set False to disable Playwright
+
+# Globals for RAG system
+vector_store = None
+rag_chain = None
+DB_PATH = None  # will be set when a .db is uploaded
+DOC_PATH = None  # will be set when a document is uploaded
+IMG_PATH = None  # will be set when an image is uploaded
+OTH_PATH = None  # will be set when an other file is uploaded
+
+
+# ─── LLMS ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+#llm = ChatOpenAI(model_name="gpt-3.5-turbo", streaming=True, temperature=0)
+from tenacity import retry, stop_after_attempt, wait_exponential
+
+# Import the RetryingChatGroq client
+from retry_groq import RetryingChatGroq
+
+# Use the retrying version instead
+llm = RetryingChatGroq(model="deepseek-r1-distill-llama-70b", streaming=False, temperature=0)
+#llm = ChatMistralAI(model="mistral-large-latest", streaming=True, temperature=0)
+
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+# ─────────────────────────────────────────────── Tool for multiply ──────────────────────────────────────────────────────────────────────
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+@tool(parse_docstring=True)
+def multiply(a: int, b: int) -> int:
+    """
+    Multiply two numbers.
+
+    Args:
+        a (int): The first factor.
+        b (int): The second factor.
+
+    Returns:
+        int: The product of a and b.
+    """
+    try:
+        # Direct calculation without relying on LangChain handling
+        result = a * b
+        return result
+    except Exception as e:
+        return f"Error in multiplication: {str(e)}"
+
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+# ─────────────────────────────────────────────── Tool for add ──────────────────────────────────────────────────────────────────────────
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+@tool(parse_docstring=True)
+def add(a: int, b: int) -> int:
+    """
+    Add two numbers.
+
+    Args:
+        a (int): The first factor.
+        b (int): The second factor.
+
+    Returns:
+        int: The addition of a and b.
+    """
+    try:
+        # Direct calculation without relying on LangChain handling
+        result = a + b
+        return result
+    except Exception as e:
+        return f"Error in addition: {str(e)}"
+
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+# ─────────────────────────────────────────────── Tool for subtract ──────────────────────────────────────────────────────────────────────
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+@tool(parse_docstring=True)
+def subtract(a: int, b: int) -> int:
+    """
+    Subtract two numbers.
+
+    Args:
+        a (int): The first factor.
+        b (int): The second factor.
+
+    Returns:
+        int: The subtraction of a and b.
+    """
+    try:
+        # Direct calculation without relying on LangChain handling
+        result = a - b
+        return result
+    except Exception as e:
+        return f"Error in subtraction: {str(e)}"
+
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+# ─────────────────────────────────────────────── Tool for divide ──────────────────────────────────────────────────────────────────────
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+@tool(parse_docstring=True)
+def divide(a: int, b: int) -> int:
+    """
+    Divide two numbers.
+
+    Args:
+        a (int): The numerator.
+        b (int): The denominator.
+
+    Returns:
+        float: The result of a divided by b.
+
+    Raises:
+        ValueError: If b is zero.
+    """
+    try:
+        if b == 0:
+            return "Error: Cannot divide by zero."
+        # Direct calculation without relying on LangChain handling
+        result = a / b
+        return result
+    except Exception as e:
+        return f"Error in division: {str(e)}"
+
+# ──────────────────────────────────────────────────────────────────────────────────────────────────���───────────────────────────────────────
+# ─────────────────────────────────────────────── Tool for modulus ──────────────────────────────────────────────────────────────────────
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+@tool(parse_docstring=True)
+def modulus(a: int, b: int) -> int:
+    """
+    Get the modulus (remainder) of two numbers.
+
+    Args:
+        a (int): The dividend.
+        b (int): The divisor.
+
+    Returns:
+        int: The remainder when a is divided by b.
+    """
+    try:
+        if b == 0:
+            return "Error: Cannot calculate modulus with zero divisor."
+        # Direct calculation without relying on LangChain handling
+        result = a % b
+        return result
+    except Exception as e:
+        return f"Error in modulus calculation: {str(e)}"
+
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+# ─────────────────────────────────────────────── Tool for browsing ──────────────────────────────────────────────────────────────────────
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+def with_retry(max_attempts: int = 3, backoff_base: int = 2):
+    """
+    Decorator for retrying a function with exponential backoff on exception.
+    """
+    def decorator(fn):
+        @wraps(fn)
+        def wrapper(*args, **kwargs):
+            for attempt in range(max_attempts):
+                try:
+                    return fn(*args, **kwargs)
+                except Exception as e:
+                    wait = backoff_base ** attempt + random.uniform(0, 1)
+                    logger.warning(f"{fn.__name__} failed (attempt {attempt+1}/{max_attempts}): {e}")
+                    if attempt < max_attempts - 1:
+                        time.sleep(wait)
+            logger.error(f"{fn.__name__} failed after {max_attempts} attempts.")
+            return []
+        return wrapper
+    return decorator
+
+@with_retry()
+@lru_cache(maxsize=128)
+def tavily_search(query: str, top_k: int = 3) -> List[Dict]:
+    """Call Tavily API and return a list of result dicts."""
+    if not TAVILY_API_KEY:
+        logger.info("[Tavily] No API key set. Skipping Tavily search.")
+        return []
+    url = "https://api.tavily.com/search"
+    headers = {
+        "Authorization": f"Bearer {TAVILY_API_KEY}",
+        "Content-Type": "application/json",
+    }
+    payload = {"query": query, "num_results": top_k}
+    resp = requests.post(url, headers=headers, json=payload, timeout=10)
+    resp.raise_for_status()
+    data = resp.json()
+    results = []
+    for item in data.get("results", []):
+        results.append({
+            "title": item.get("title", ""),
+            "url": item.get("url", ""),
+            "content": item.get("content", "")[:200],
+            "source": "Tavily"
+        })
+    return results
+
+@with_retry()
+@lru_cache(maxsize=128)
+def duckduckgo_search(query: str, top_k: int = 3) -> List[Dict]:
+    """Query DuckDuckGo and return up to top_k raw SERP hits."""
+    results = []
+    try:
+        with DDGS(timeout=15) as ddgs:  # Increase timeout from default
+            for hit in ddgs.text(query, safesearch="On", max_results=top_k, timeout=15):
+                results.append({
+                    "title": hit.get("title", ""),
+                    "url": hit.get("href") or hit.get("url", ""),
+                    "content": hit.get("body", ""),
+                    "source": "DuckDuckGo"
+                })
+                if len(results) >= top_k:
+                    break
+    except Exception as e:
+        logger.warning(f"DuckDuckGo search failed: {e}")
+        # Don't re-raise - just return empty results to allow fallbacks to work
+    
+    return results
+
+# Additional fallback search alternative
+def simple_google_search(query: str, top_k: int = 3) -> List[Dict]:
+    """Simplified Google search as a fallback when other methods fail."""
+    try:
+        # Encode the query
+        import urllib.parse
+        import bs4
+        
+        encoded_query = urllib.parse.quote(query)
+        url = f"https://www.google.com/search?q={encoded_query}"
+        
+        headers = {
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.110 Safari/537.36",
+            "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
+            "Accept-Language": "en-US,en;q=0.5",
+            "Referer": "https://www.google.com/",
+            "Connection": "keep-alive",
+        }
+        
+        response = requests.get(url, headers=headers, timeout=20)
+        response.raise_for_status()
+        
+        soup = bs4.BeautifulSoup(response.text, "html.parser")
+        results = []
+        
+        # Extract search results
+        for result in soup.select("div.g")[:top_k]:
+            title_elem = result.select_one("h3")
+            link_elem = result.select_one("a")
+            snippet_elem = result.select_one("div.VwiC3b")
+            
+            if title_elem and link_elem and snippet_elem and "href" in link_elem.attrs:
+                href = link_elem["href"]
+                if href.startswith("/url?q="):
+                    href = href.split("/url?q=")[1].split("&")[0]
+                
+                if href.startswith("http"):
+                    results.append({
+                        "title": title_elem.get_text(),
+                        "url": href,
+                        "content": snippet_elem.get_text(),
+                        "source": "Google"
+                    })
+        
+        return results
+    
+    except Exception as e:
+        logger.warning(f"Simple Google search failed: {e}")
+        return []
+
+def hybrid_search(query: str, top_k: int = 3) -> List[Dict]:
+    """Combine multiple search sources with fallbacks."""
+    # Try primary search methods first
+    results = []
+    
+    # Start with Tavily if API key is available
+    if TAVILY_API_KEY and TAVILY_API_KEY != "default_key_or_placeholder":
+        try:
+            tavily_results = tavily_search(query, top_k)
+            results.extend(tavily_results)
+            logger.info(f"Retrieved {len(tavily_results)} results from Tavily")
+        except Exception as e:
+            logger.warning(f"Tavily search failed: {e}")
+    
+    # If we don't have enough results, try DuckDuckGo
+    if len(results) < top_k:
+        try:
+            ddg_results = duckduckgo_search(query, top_k - len(results))
+            results.extend(ddg_results)
+            logger.info(f"Retrieved {len(ddg_results)} results from DuckDuckGo")
+        except Exception as e:
+            logger.warning(f"DuckDuckGo search failed: {e}")
+    
+    # If we still don't have enough results, try Google
+    if len(results) < top_k:
+        try:
+            google_results = simple_google_search(query, top_k - len(results))
+            results.extend(google_results)
+            logger.info(f"Retrieved {len(google_results)} results from Google")
+        except Exception as e:
+            logger.warning(f"Google search failed: {e}")
+    
+    # If all search methods failed, return a dummy result
+    if not results:
+        results.append({
+            "title": "Search Failed",
+            "url": "",
+            "content": f"Sorry, I couldn't find results for '{query}'. Please try refining your search terms or check your internet connection.",
+            "source": "No results"
+        })
+    
+    return results[:top_k]  # Ensure we only return top_k results
+
+def format_search_docs(search_docs: List[Dict]) -> Dict[str, str]:
+    """
+    Turn a list of {source, page, content} dicts into one big
+    string with <Document ...>…</Document> entries separated by `---`.
+    """
+    formatted_search_docs = "\n\n---\n\n".join(
+        [
+            f'<Document source="{doc["source"]}" page="{doc.get("page", "")}"/>\n'
+            f'{doc.get("content", "")}\n'
+            f'</Document>'
+            for doc in search_docs
+        ]
+    )
+    return {"web_results": formatted_search_docs}
+
+
+@tool(parse_docstring=True)
+def web_search(query: str, top_k: int = 3) -> Dict[str, str]:
+    """
+    Perform a hybrid web search combining multiple search engines with robust fallbacks.
+
+    Args:
+        query: The search query string to look up.
+        top_k: The maximum number of search results to return (default is 3).
+
+    Returns:
+        A dictionary mapping result indices to XML-like <Document> blocks, each containing:
+        - source: The URL of the webpage.
+        - page: Placeholder for page identifier (empty string by default).
+        - content: The first 200 words of the page text, cleaned of HTML tags.
+    """
+    try:
+        # Use our robust hybrid search to get initial results
+        search_results = hybrid_search(query, top_k)
+        results = []
+        
+        # Process each search result to get better content
+        for hit in search_results:
+            url = hit.get("url")
+            if not url:
+                continue
+                
+            # Start with the snippet from search
+            content = hit.get("content", "")
+            title = hit.get("title", "")
+            
+            # Try to scrape additional content if possible
+            try:
+                # Use a random user agent to avoid blocking
+                headers = {
+                    "User-Agent": random.choice([
+                        "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.110 Safari/537.36",
+                        "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Safari/605.1.15",
+                        "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.45 Safari/537.36",
+                        "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/97.0.4692.71 Safari/537.36 Edg/97.0.1072.62"
+                    ]),
+                    "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
+                    "Accept-Language": "en-US,en;q=0.5",
+                    "Referer": "https://www.google.com/",
+                    "DNT": "1",
+                    "Connection": "keep-alive"
+                }
+                
+                # Higher timeout for better reliability
+                resp = requests.get(url, timeout=15, headers=headers)
+                
+                # Only process if successful
+                if resp.status_code == 200:
+                    soup = BeautifulSoup(resp.text, "html.parser")
+                    
+                    # Try to find main content
+                    main_content = soup.find('main') or soup.find('article') or soup.find('div', class_='content')
+                    
+                    # If we found main content, use it
+                    if main_content:
+                        extracted_text = main_content.get_text(separator=" ", strip=True)
+                        # Take first 200 words
+                        content = " ".join(extracted_text.split()[:200])
+                    else:
+                        # Otherwise use all text
+                        all_text = soup.get_text(separator=" ", strip=True)
+                        content = " ".join(all_text.split()[:200])
+                        
+                    # Use content from page only if it's substantial
+                    if len(content) < 50:
+                        content = hit.get("content", "")[:200]
+                
+                # Random delay between 0.5-1.5 seconds to avoid rate limits
+                time.sleep(0.5 + random.random())
+                
+            except requests.exceptions.HTTPError as e:
+                logger.warning(f"HTTP error when scraping {url}: {e}")
+                # Keep the search snippet as a fallback
+            except requests.exceptions.RequestException as e:
+                logger.warning(f"Request error when scraping {url}: {e}")
+                # Keep the search snippet as a fallback
+            except Exception as e:
+                logger.warning(f"Unexpected error when scraping {url}: {e}")
+                # Keep the search snippet as a fallback
+                
+            # Filter out inappropriate content
+            if any(f in content.lower() for f in _forbidden):
+                continue
+                
+            # Add to results
+            results.append({
+                "source": url,
+                "page": "",
+                "content": content
+            })
+            
+        # Return formatted search docs
+        return format_search_docs(results[:top_k])
+    except Exception as e:
+        logger.error(f"Web search failed: {e}")
+        # Return a helpful error message
+        return format_search_docs([{
+            "source": "Error",
+            "page": "",
+            "content": f"Search failed with error: {e}. Please try again with different search terms."
+        }])
+
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+# ─────────────────────────────────────────────── Tool for File System ───────────────────────────────────────────────────────────────────
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+@tool(parse_docstring=True)
+def download_file(url: str, dest_path: str) -> str:
+    """
+    Download a file from a given URL and save it locally.
+
+    Args:
+        url: The direct URL of the file to download.
+        dest_path: The local path to save the downloaded file.
+
+    Returns:
+        The destination path where the file was saved.
+    """
+    r = requests.get(url, stream=True)
+    r.raise_for_status()
+    with open(dest_path, 'wb') as f:
+        for chunk in r.iter_content(8192):
+            f.write(chunk)
+    return dest_path
+
+@tool(parse_docstring=True)
+def process_excel_to_text(file_path: str) -> str:
+    """
+    Convert an Excel file into CSV-formatted text.
+
+    Args:
+        file_path: Path to the Excel (.xlsx) file.
+
+    Returns:
+        A string of CSV-formatted content extracted from the Excel file.
+    """
+    try:
+        # Check if file exists
+        import os
+        if not os.path.exists(file_path):
+            return f"Error: Excel file '{file_path}' does not exist."
+            
+        # Try different engines
+        engines = ['openpyxl', 'xlrd', None]
+        
+        for engine in engines:
+            try:
+                # For engine=None, pandas will try to auto-detect
+                if engine:
+                    df = pd.read_excel(file_path, engine=engine)
+                else:
+                    df = pd.read_excel(file_path)
+                return df.to_csv(index=False)
+            except Exception as e:
+                print(f"Excel engine {engine} failed: {e}")
+                last_error = e
+                continue
+        
+        # If we got here, all engines failed
+        return f"Error processing Excel file: {str(last_error)}"
+    except Exception as e:
+        return f"Error with Excel file: {str(e)}"
+    
+@tool(parse_docstring=True)
+def read_text_from_pdf(file_path: str, question: str = None) -> str:
+    """
+    Extract text from a PDF file, chunking large documents if needed.
+
+    Args:
+        file_path: Path to the PDF file.
+        question: Optional question to help retrieve relevant parts of long documents.
+
+    Returns:
+        The extracted text content, potentially chunked if the document is large.
+    """
+    try:
+        # Check if file exists
+        import os
+        if not os.path.exists(file_path):
+            return f"Error: PDF file '{file_path}' does not exist."
+            
+        reader = PdfReader(file_path)
+        full_text = "\n".join([page.extract_text() or "" for page in reader.pages])
+        
+        # If a question is provided, use retrieval to get relevant parts
+        if question and len(full_text) > 5000:  # Only chunk if text is large
+            return process_large_document(full_text, question)
+        
+        return full_text
+    except Exception as e:
+        return f"Error reading PDF: {str(e)}"
+
+@tool(parse_docstring=True)
+def read_text_from_docx(file_path: str, question: str = None) -> str:
+    """
+    Extract text from a DOCX (Word) document, chunking large documents if needed.
+
+    Args:
+        file_path: Path to the DOCX file.
+        question: Optional question to help retrieve relevant parts of long documents.
+
+    Returns:
+        The extracted text, potentially chunked if the document is large.
+    """
+    try:
+        # Check if file exists
+        import os
+        if not os.path.exists(file_path):
+            return f"Error: File '{file_path}' does not exist."
+            
+        try:
+            doc = docx.Document(file_path)
+            full_text = "\n".join([para.text for para in doc.paragraphs])
+        except Exception as docx_err:
+            # Handle "Package not found" error specifically
+            if "Package not found" in str(docx_err):
+                # Try to read raw text if possible
+                try:
+                    import zipfile
+                    from xml.etree.ElementTree import XML
+                    
+                    WORD_NAMESPACE = '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}'
+                    PARA = WORD_NAMESPACE + 'p'
+                    TEXT = WORD_NAMESPACE + 't'
+                    
+                    with zipfile.ZipFile(file_path) as docx_file:
+                        with docx_file.open('word/document.xml') as document:
+                            tree = XML(document.read())
+                            paragraphs = []
+                            for paragraph in tree.iter(PARA):
+                                texts = [node.text for node in paragraph.iter(TEXT) if node.text]
+                                if texts:
+                                    paragraphs.append(''.join(texts))
+                            full_text = '\n'.join(paragraphs)
+                except Exception as e:
+                    return f"Error reading DOCX file: {str(e)}"
+            else:
+                return f"Error reading DOCX file: {str(docx_err)}"
+        
+        # If a question is provided, use retrieval to get relevant parts
+        if question and len(full_text) > 5000:  # Only chunk if text is large
+            return process_large_document(full_text, question)
+        
+        return full_text
+    except Exception as e:
+        return f"Error reading DOCX file: {str(e)}"
+
+
+@tool(parse_docstring=True)
+def transcribe_audio(file_path: str) -> str:
+    """
+    Transcribe speech from a local audio file to text.
+
+    Args:
+        file_path: Path to the audio file.
+
+    Returns:
+        Transcribed text using Google Web Speech API.
+    """
+    try:
+        # Check if file exists
+        import os
+        if not os.path.exists(file_path):
+            return f"Error: Audio file '{file_path}' does not exist."
+            
+        # For non-WAV files, convert to WAV first
+        if not file_path.lower().endswith('.wav'):
+            try:
+                from pydub import AudioSegment
+                temp_wav = os.path.splitext(file_path)[0] + "_temp.wav"
+                audio = AudioSegment.from_file(file_path)
+                audio.export(temp_wav, format="wav")
+                file_path = temp_wav
+            except Exception as e:
+                return f"Failed to convert audio to WAV format: {str(e)}"
+                
+        recognizer = sr.Recognizer()
+        with sr.AudioFile(file_path) as src:
+            audio = recognizer.record(src)
+        return recognizer.recognize_google(audio)
+    except Exception as e:
+        if "Audio file could not be read" in str(e):
+            return f"Error: Audio format not supported. Try converting to WAV, MP3, OGG, or FLAC."
+        return f"Error transcribing audio: {str(e)}"
+
+@tool(parse_docstring=True)
+def youtube_audio_processing(youtube_url: str) -> str:
+    """
+    Download and transcribe audio from a YouTube video.
+
+    Args:
+        youtube_url: URL of the YouTube video.
+
+    Returns:
+        Transcription text extracted from the video's audio.
+    """
+    yt = YouTube(youtube_url)
+    audio_stream = yt.streams.filter(only_audio=True).first()
+    out_file = audio_stream.download(output_path='.', filename='yt_audio')
+    wav_path = 'yt_audio.wav'
+    AudioSegment.from_file(out_file).export(wav_path, format='wav')
+    return transcribe_audio(wav_path)
+
+@tool(parse_docstring=True)
+def extract_article_text(url: str, question: str = None) -> str:
+    """
+    Download and extract the main article content from a webpage, chunking large articles if needed.
+
+    Args:
+        url: The URL of the article to extract.
+        question: Optional question to help retrieve relevant parts of long articles.
+
+    Returns:
+        The article's textual content, potentially chunked if large.
+    """
+    try:
+        art = Article(url)
+        art.download()
+        art.parse()
+        full_text = art.text
+        
+        # If a question is provided, use retrieval to get relevant parts
+        if question and len(full_text) > 5000:  # Only chunk if text is large
+            return process_large_document(full_text, question)
+        
+        return full_text
+    except Exception as e:
+        return f"Error extracting article: {str(e)}"
+
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+# ───────────────────────────────────────────────────────────── Tool for ArXiv ────────────────────────────────────────────────────────────
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+
+@tool(parse_docstring=True)
+def arvix_search(query: str) -> Dict[str, str]:
+    """
+    Search for academic papers on ArXiv.
+
+    Args:
+        query: The search term to look for in ArXiv.
+
+    Returns:
+        A dictionary of up to 3 relevant paper entries in JSON format.
+    """
+    papers = ArxivLoader(query=query, load_max_docs=3).load()
+    results = []
+    for doc in papers:
+        try:
+            # Handle different metadata formats that might be returned
+            source = doc.metadata.get("source", "ArXiv")
+            doc_id = doc.metadata.get("id", doc.metadata.get("entry_id", ""))
+            result = {
+                "source": source,
+                "id": doc_id,
+                "summary": doc.page_content[:1000] if hasattr(doc, "page_content") else str(doc)[:1000],
+            }
+            results.append(result)
+        except Exception as e:
+            # Add error information as a fallback
+            results.append({
+                "source": "ArXiv Error",
+                "id": "error",
+                "summary": f"Error processing paper: {str(e)}"
+            })
+    
+    return {"arvix_results": json.dumps(results)}
+
+@tool(parse_docstring=True)
+def answer_youtube_video_question(
+    youtube_url: str,
+    question: str,
+    chunk_size_seconds: int = 30
+) -> str:
+    """
+    Answer a question based on a YouTube video's transcript.
+
+    Args:
+        youtube_url: URL of the YouTube video.
+        question: The question to be answered using video content.
+        chunk_size_seconds: Duration of each transcript chunk.
+
+    Returns:
+        The answer to the question generated from the video transcript.
+    """
+    loader = YoutubeLoader.from_youtube_url(
+        youtube_url,
+        add_video_info=True,
+        transcript_format=TranscriptFormat.CHUNKS,
+        chunk_size_seconds=chunk_size_seconds,
+    )
+    documents = loader.load()
+    embeddings = HuggingFaceEmbeddings(model_name='sentence-transformers/all-mpnet-base-v2')
+    vectorstore = FAISS.from_documents(documents, embeddings)
+    llm = RetryingChatGroq(model="deepseek-r1-distill-llama-70b", streaming=False)
+    qa_chain = RetrievalQA.from_chain_type(llm=llm, retriever=vectorstore.as_retriever())
+    return qa_chain.run(question)
+
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+# ───────────────────────────────────────────────────────────── Tool for Python REPL tool ────────────────────────────────────────────────
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+
+python_repl = PythonREPLTool()
+
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+# ───────────────────────────────────────────────────────────── Tool for Wiki ────────────────────────────────────────────────────────────
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+
+@tool(parse_docstring=True)
+def wiki_search(query: str) -> str:
+    """
+    Search Wikipedia for information on a given topic.
+
+    Args:
+        query: The search term for Wikipedia.
+
+    Returns:
+        A JSON string with up to 3 summary results.
+    """
+    # load up to top_k pages
+    pages = WikipediaLoader(query=query, load_max_docs=3).load()
+    results: List[Dict] = []
+    for doc in pages:
+        results.append({
+            "source": doc.metadata["source"],
+            "page": doc.metadata.get("page", ""),
+            "content": doc.page_content[:1000],  # truncate if you like
+        })
+    return {"wiki_results": format_search_docs(results)}
+
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+# ───────────────────────────────────── Tool for Image (understading, captioning & classification) ─────────────────────────────────────────
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+
+def _load_image(img_path: str, resize_to=(512, 512)) -> Image.Image:
+    """
+    Load, verify, convert, and resize an image.
+    Raises ValueError on failure.
+    """
+    if not img_path:
+        raise ValueError("No image path provided.")
+    try:
+        with Image.open(img_path) as img:
+            img.verify()
+        img = Image.open(img_path).convert("RGB")
+        img = img.resize(resize_to)
+        return img
+    except UnidentifiedImageError:
+        raise ValueError(f"File at {img_path} is not a valid image.")
+    except Exception as e:
+        raise ValueError(f"Failed to load image at {img_path}: {e}")
+
+def _encode_image_to_base64(img_path: str) -> str:
+    """
+    Load an image, save optimized PNG into memory, and base64‑encode it.
+    """
+    img = _load_image(img_path)
+    buffer = BytesIO()
+    img.save(buffer, format="PNG", optimize=True)
+    return base64.b64encode(buffer.getvalue()).decode("utf-8")
+
+@tool
+def image_processing(prompt: str, img_path: str) -> str:
+    """Process an image using a vision LLM, with OCR fallback.
+
+    Args:
+        prompt: Instruction or question related to the image.
+        img_path: Path to the image file.
+
+    Returns:
+        The model's response or fallback OCR result.
+    """
+    try:
+        import os
+        # Check if file exists
+        if not os.path.exists(img_path):
+            return f"Error: Image file '{img_path}' does not exist."
+            
+        try:
+            b64 = _encode_image_to_base64(img_path)
+            # Build a single markdown string with inline base64 image
+            md = f"{prompt}\n\n![](data:image/png;base64,{b64})"
+            message = HumanMessage(content=md)
+            # Use RetryingChatGroq with Llama 4 Maverick for vision
+            llm = RetryingChatGroq(model="meta-llama/llama-4-maverick-17b-128e-instruct", streaming=False, temperature=0)
+            try:
+                resp = llm.invoke([message])
+                if hasattr(resp, 'content'):
+                    return resp.content.strip()
+                elif isinstance(resp, str):
+                    return resp.strip()
+                else:
+                    # Handle dictionary or other response types
+                    return str(resp)
+            except Exception as invoke_err:
+                print(f"[LLM invoke error] {invoke_err}")
+                # Fall back to OCR
+                raise ValueError("LLM invocation failed")
+        except Exception as llama_err:
+            print(f"[LLM vision failed] {llama_err}")
+            try:
+                img = _load_image(img_path)
+                return pytesseract.image_to_string(img).strip()
+            except Exception as ocr_err:
+                print(f"[OCR fallback failed] {ocr_err}")
+                return "Unable to process the image. Please check the file and try again."
+    except Exception as e:
+        # Catch any other errors
+        print(f"[image_processing error] {e}")
+        return f"Error processing image: {str(e)}"
+
+python_repl_tool = PythonREPLTool()
+
+@tool
+def echo(text: str) -> str:
+    """Echo back the input text.
+
+    Args:
+        text: The string to be echoed.
+        
+    Returns:
+        The same text that was provided as input.
+    """
+    return text
+
+# ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────��───────────────────
+# ─────────────────────────────────────────────── Langgraph Agent ───────────────────────────────────────────────────────────────────────
+# ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+
+
+# Build graph function
+from langchain_core.tools import tool
+from langchain.chat_models import ChatOpenAI
+from langgraph.prebuilt.chat_agent_executor import create_react_agent, AgentState
+from langchain.chat_models import init_chat_model
+
+
+
+def build_graph(provider: str = "groq"):
+    """Construct and compile the multi‑agent GAIA workflow StateGraph.
+
+    This graph wires together three React‑style agents into a streamlined pipeline:
+    PerceptionAgent → ActionAgent → EvaluationAgent (with appropriate entry/exit points)
+    
+    The agents have the following responsibilities:
+    - PerceptionAgent: Handles web searches, Wikipedia, ArXiv, and image processing
+    - ActionAgent: Performs calculations, file operations, and code analysis
+    - EvaluationAgent: Reviews results and ensures the final answer is properly formatted
+
+    Args:
+        provider: The name of the LLM provider. Must be "groq".
+
+    Returns:
+        CompiledGraph: A compiled LangGraph state machine ready for invocation.
+
+    Raises:
+        ValueError: If `provider` is anything other than "groq".
+    """
+    try:
+        if provider != "groq":
+            raise ValueError("Invalid provider. Expected 'groq'.")
+        
+        # Initialize LLM
+        try:
+            logger.info("Initializing LLM with model: deepseek-r1-distill-llama-70b")
+            api_key = os.getenv("GROQ_API_KEY")
+            if not api_key or api_key == "default_key_or_placeholder":
+                logger.error("GROQ_API_KEY is not set or is using placeholder value")
+                raise ValueError("GROQ_API_KEY environment variable is not set properly. Please set a valid API key.")
+                
+            llm = RetryingChatGroq(model="deepseek-r1-distill-llama-70b", temperature=0)
+            logger.info("LLM initialized successfully")
+        except Exception as e:
+            logger.error(f"Error initializing LLM: {str(e)}")
+            raise
+        
+        # General system message for agents
+        sys_msg = SystemMessage(content="""
+        You are a general AI assistant. I will ask you a question. Report your thoughts, and finish your answer with the following template:
+
+        FINAL ANSWER: [YOUR FINAL ANSWER]
+
+        YOUR FINAL ANSWER should be a number OR as few words as possible OR a comma-separated list of numbers and/or strings.
+
+        If you are asked for a number, don't use commas or units (e.g., $, %, kg) unless specified otherwise.
+
+        If you are asked for a string, don't use articles (a, an, the), and don't use abbreviations (e.g., for states).
+
+        If you are asked for a comma-separated list, apply the above rules to each element in the list.
+                """.strip())
+                
+        # Special system message for the evaluation agent with stricter formatting requirements
+        eval_sys_msg = SystemMessage(content="""
+        You are a specialized evaluation agent. Your job is to review the work done by other agents
+        and provide a final, properly formatted answer.
+        
+        IMPORTANT: You MUST ALWAYS format your answer using this exact template:
+        
+        FINAL ANSWER: [concise answer]
+        
+        Rules for formatting the answer:
+        1. The answer must be extremely concise - use as few words as possible
+        2. For numeric answers, provide only the number without units unless units are specifically requested
+        3. For text answers, avoid articles (a, an, the) and unnecessary words
+        4. For list answers, use a comma-separated format
+        5. NEVER explain your reasoning in the FINAL ANSWER section
+        6. NEVER skip the "FINAL ANSWER:" prefix
+        
+        Example good answers:
+        FINAL ANSWER: 42
+        FINAL ANSWER: Paris
+        FINAL ANSWER: 1912, 1945, 1989
+        
+        Example bad answers (don't do these):
+        - Based on my analysis, the answer is 42.
+        - I think it's Paris because that's the capital of France.
+        - The years were 1912, 1945, and 1989.
+        
+        Remember: ALWAYS include "FINAL ANSWER:" followed by the most concise answer possible.
+        """.strip())
+                
+        # Define tools for each agent
+        logger.info("Setting up agent tools")
+        perception_tools = [web_search, wiki_search, news_article_search, arvix_search, image_processing, echo]
+        execution_tools = [
+            multiply, add, subtract, divide, modulus,
+            download_file, process_excel_to_text,
+            read_text_from_pdf, read_text_from_docx,
+            transcribe_audio, youtube_audio_processing,
+            extract_article_text, answer_youtube_video_question,
+            python_repl_tool, analyze_code, read_code_file, analyze_python_function
+        ]
+        
+        # ─────────────── Agent Creation ───────────────
+        logger.info("Creating agents")
+        try:
+            # Create agents with proper error handling
+            PerceptionAgent = create_react_agent(
+                model=llm,
+                tools=perception_tools,
+                prompt=sys_msg,
+                state_schema=AgentState,
+                name="PerceptionAgent"
+            )
+            logger.info("Created PerceptionAgent successfully")
+            
+            # Combined Planning and Execution agent for better efficiency
+            ActionAgent = create_react_agent(
+                model=llm,
+                tools=execution_tools,  # Has access to all execution tools
+                prompt=sys_msg,
+                state_schema=AgentState,
+                name="ActionAgent"
+            )
+            logger.info("Created ActionAgent successfully")
+            
+            # Evaluation agent with stricter prompt
+            EvaluationAgent = create_react_agent(
+                model=llm,
+                tools=[],  # No tools needed for evaluation
+                prompt=eval_sys_msg,  # Use the specialized evaluation prompt
+                state_schema=AgentState,
+                name="EvaluationAgent"
+            )
+            logger.info("Created EvaluationAgent successfully")
+        except Exception as e:
+            logger.error(f"Error creating agent: {str(e)}")
+            import traceback
+            logger.error(f"Traceback: {traceback.format_exc()}")
+            raise
+        
+        # Build the StateGraph
+        logger.info("Building StateGraph")
+        try:
+            builder = StateGraph(AgentState)
+            
+            # Add agent nodes first
+            builder.add_node("PerceptionAgent", PerceptionAgent)
+            builder.add_node("ActionAgent", ActionAgent)
+            builder.add_node("EvaluationAgent", EvaluationAgent)
+            
+            # Define the flow with a starting edge
+            builder.set_entry_point("PerceptionAgent")
+            
+            # Add the edges for the simpler linear flow
+            builder.add_edge("PerceptionAgent", "ActionAgent")
+            builder.add_edge("ActionAgent", "EvaluationAgent")
+            
+            # Set EvaluationAgent as the end node
+            builder.set_finish_point("EvaluationAgent")
+            
+            logger.info("Compiling StateGraph")
+            return builder.compile()
+        except Exception as e:
+            logger.error(f"Error building graph: {str(e)}")
+            import traceback
+            logger.error(f"Traceback: {traceback.format_exc()}")
+            raise
+    except Exception as e:
+        logger.error(f"Overall error in build_graph: {str(e)}")
+        import traceback
+        logger.error(f"Traceback: {traceback.format_exc()}")
+        raise
+
+def get_final_answer(text):
+    """Extract just the FINAL ANSWER from the model's response.
+    
+    Args:
+        text: The full text response from the LLM
+        
+    Returns:
+        str: The extracted answer without the "FINAL ANSWER:" prefix
+    """
+    # Log the raw text for debugging if needed
+    logger.debug(f"Extracting answer from: {text[:200]}...")
+    
+    if not text:
+        logger.warning("Empty response received")
+        return "No answer provided."
+    
+    # Method 1: Look for "FINAL ANSWER:" with most comprehensive pattern matching
+    pattern = r'(?:^|\n)FINAL ANSWER:\s*(.*?)(?:\n\s*$|$)'
+    match = re.search(pattern, text, re.DOTALL | re.IGNORECASE)
+    if match:
+        # Return just the answer part, cleaned up
+        logger.debug("Found answer using pattern 1")
+        return match.group(1).strip()
+    
+    # Method 2: Try looking for variations on the final answer format
+    for variant in ["FINAL ANSWER:", "FINAL_ANSWER:", "Final Answer:", "Answer:"]:
+        lines = text.split('\n')
+        for i, line in enumerate(reversed(lines)):
+            if variant in line:
+                # Extract everything after the variant text
+                logger.debug(f"Found answer using variant: {variant}")
+                answer = line[line.find(variant) + len(variant):].strip()
+                if answer:
+                    return answer
+                # If the answer is on the next line, return that
+                if i > 0:
+                    next_line = lines[len(lines) - i]
+                    if next_line.strip():
+                        return next_line.strip()
+    
+    # Method 3: Look for phrases that suggest an answer
+    for phrase in ["The answer is", "The result is", "We get", "Therefore,", "In conclusion,"]:
+        phrase_pos = text.find(phrase)
+        if phrase_pos != -1:
+            # Try to extract everything after the phrase until the end of the sentence
+            sentence_end = text.find(".", phrase_pos)
+            if sentence_end != -1:
+                logger.debug(f"Found answer using phrase: {phrase}")
+                return text[phrase_pos + len(phrase):sentence_end].strip()
+    
+    # Method 4: Fall back to taking the last paragraph with actual content
+    paragraphs = text.strip().split('\n\n')
+    for para in reversed(paragraphs):
+        para = para.strip()
+        if para and not para.startswith("I ") and not para.lower().startswith("to "):
+            logger.debug("Using last meaningful paragraph")
+            # If paragraph is very long, try to extract a concise answer
+            if len(para) > 100:
+                sentences = re.split(r'[.!?]', para)
+                for sentence in reversed(sentences):
+                    sent = sentence.strip()
+                    if sent and len(sent) > 5 and not sent.startswith("I "):
+                        return sent
+            return para
+    
+    # Method 5: Last resort - just return the last line with content
+    lines = text.strip().split('\n')
+    for line in reversed(lines):
+        line = line.strip()
+        if line and len(line) > 3:
+            logger.debug("Using last line with content")
+            return line
+    
+    # If everything fails, warn and return the truncated response
+    logger.warning("Could not find a properly formatted answer")
+    return text[:100] + "..." if len(text) > 100 else text
+
+# test
+if __name__ == "__main__":
+    question = "When was a picture of St. Thomas Aquinas first added to the Wikipedia page on the Principle of double effect?"
+    # Build the graph
+    graph = build_graph(provider="groq")
+    # Run the graph
+    messages = [HumanMessage(content=question)]
+    messages = graph.invoke({"messages": messages})
+    for m in messages["messages"]:
+        m.pretty_print()
+
+# ─────────────────────────────────────────────── Tool for Code Analysis ───────────────────────────────────────────────────────────────
+@tool
+def analyze_code(code_string: str) -> str:
+    """Analyze a string of code to understand its structure, functionality, and potential issues.
+
+    Args:
+        code_string: The code to analyze as a string.
+
+    Returns:
+        A structured analysis of the code including functions, classes, and key operations.
+    """
+    try:
+        import ast
+        
+        # Try to parse with Python's AST module
+        try:
+            parsed = ast.parse(code_string)
+            
+            # Extract functions and classes
+            functions = [node.name for node in ast.walk(parsed) if isinstance(node, ast.FunctionDef)]
+            classes = [node.name for node in ast.walk(parsed) if isinstance(node, ast.ClassDef)]
+            imports = [node.names[0].name for node in ast.walk(parsed) if isinstance(node, ast.Import)]
+            imports.extend([f"{node.module}.{name.name}" if node.module else name.name 
+                           for node in ast.walk(parsed) if isinstance(node, ast.ImportFrom)
+                           for name in node.names])
+            
+            # Count various node types for complexity assessment
+            num_loops = len([node for node in ast.walk(parsed) 
+                            if isinstance(node, (ast.For, ast.While))])
+            num_conditionals = len([node for node in ast.walk(parsed) 
+                                   if isinstance(node, (ast.If, ast.IfExp))])
+            
+            analysis = {
+                "language": "Python",
+                "functions": functions,
+                "classes": classes,
+                "imports": imports,
+                "complexity": {
+                    "functions": len(functions),
+                    "classes": len(classes),
+                    "loops": num_loops,
+                    "conditionals": num_conditionals
+                }
+            }
+            return str(analysis)
+        except SyntaxError:
+            # If not valid Python, try some simple pattern matching
+            if "{" in code_string and "}" in code_string:
+                if "function" in code_string or "=>" in code_string:
+                    language = "JavaScript/TypeScript"
+                elif "func" in code_string or "struct" in code_string:
+                    language = "Go or Rust"
+                elif "public" in code_string or "private" in code_string or "class" in code_string:
+                    language = "Java/C#/C++"
+                else:
+                    language = "Unknown C-like language"
+            elif "<" in code_string and ">" in code_string and ("/>" in code_string or "</"):
+                language = "HTML/XML/JSX"
+            else:
+                language = "Unknown"
+                
+            return f"Non-Python code detected ({language}). Basic code structure analysis not available."
+    except Exception as e:
+        return f"Error analyzing code: {str(e)}"
+
+@tool
+def read_code_file(file_path: str) -> str:
+    """Read a code file and return its contents with proper syntax detection.
+
+    Args:
+        file_path: Path to the code file.
+
+    Returns:
+        The file contents and detected language.
+    """
+    try:
+        # Check if file exists
+        import os
+        if not os.path.exists(file_path):
+            return f"Error: File '{file_path}' does not exist."
+            
+        with open(file_path, 'r', encoding='utf-8') as f:
+            content = f.read()
+        
+        # Try to detect language from extension
+        ext = os.path.splitext(file_path)[1].lower()
+        
+        language_map = {
+            '.py': 'Python',
+            '.js': 'JavaScript',
+            '.ts': 'TypeScript',
+            '.html': 'HTML',
+            '.css': 'CSS',
+            '.java': 'Java',
+            '.c': 'C',
+            '.cpp': 'C++',
+            '.cs': 'C#',
+            '.go': 'Go',
+            '.rs': 'Rust',
+            '.php': 'PHP',
+            '.rb': 'Ruby',
+            '.sh': 'Shell',
+            '.bat': 'Batch',
+            '.ps1': 'PowerShell',
+            '.sql': 'SQL',
+            '.json': 'JSON',
+            '.xml': 'XML',
+            '.yaml': 'YAML',
+            '.yml': 'YAML',
+        }
+        
+        language = language_map.get(ext, 'Unknown')
+        
+        return f"File content ({language}):\n\n{content}"
+    except Exception as e:
+        return f"Error reading file: {str(e)}"
+
+@tool
+def analyze_python_function(function_name: str, code_string: str) -> str:
+    """Extract and analyze a specific function from Python code.
+    
+    Args:
+        function_name: The name of the function to analyze.
+        code_string: The complete code containing the function.
+        
+    Returns:
+        Analysis of the function including parameters, return type, and docstring.
+    """
+    try:
+        import ast
+        import inspect
+        from types import CodeType, FunctionType
+        
+        # Parse the code string
+        parsed = ast.parse(code_string)
+        
+        # Find the function definition
+        function_def = None
+        for node in ast.walk(parsed):
+            if isinstance(node, ast.FunctionDef) and node.name == function_name:
+                function_def = node
+                break
+        
+        if not function_def:
+            return f"Function '{function_name}' not found in the provided code."
+        
+        # Extract parameters
+        params = []
+        for arg in function_def.args.args:
+            param_name = arg.arg
+            # Get annotation if it exists
+            if arg.annotation:
+                if isinstance(arg.annotation, ast.Name):
+                    param_type = arg.annotation.id
+                elif isinstance(arg.annotation, ast.Attribute):
+                    param_type = f"{arg.annotation.value.id}.{arg.annotation.attr}"
+                else:
+                    param_type = "complex_type"
+                params.append(f"{param_name}: {param_type}")
+            else:
+                params.append(param_name)
+        
+        # Extract return type if it exists
+        return_type = None
+        if function_def.returns:
+            if isinstance(function_def.returns, ast.Name):
+                return_type = function_def.returns.id
+            elif isinstance(function_def.returns, ast.Attribute):
+                return_type = f"{function_def.returns.value.id}.{function_def.returns.attr}"
+            else:
+                return_type = "complex_return_type"
+        
+        # Extract docstring
+        docstring = ast.get_docstring(function_def)
+        
+        # Create a summary
+        summary = {
+            "function_name": function_name,
+            "parameters": params,
+            "return_type": return_type,
+            "docstring": docstring,
+            "decorators": [d.id if isinstance(d, ast.Name) else "complex_decorator" for d in function_def.decorator_list],
+            "line_count": len(function_def.body)
+        }
+        
+        # Create a more explicit string representation that ensures key terms are included
+        result = f"Function '{function_name}' analysis:\n"
+        result += f"- Parameters: {', '.join(params)}\n"
+        result += f"- Return type: {return_type or 'None specified'}\n"
+        result += f"- Docstring: {docstring or 'None'}\n"
+        result += f"- Line count: {len(function_def.body)}"
+        
+        return result
+    except Exception as e:
+        return f"Error analyzing function: {str(e)}"
+
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+# ─────────────────────────────────────────────── Tool for News Article Retrieval ──────────────────────────────────────────────────────────────────────
+# ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+
+@tool
+def news_article_search(query: str, top_k: int = 3) -> Dict[str, str]:
+    """Search for and retrieve news articles with robust error handling for news sites.
+
+    Args:
+        query: The news topic or keywords to search for.
+        top_k: Maximum number of articles to retrieve.
+
+    Returns:
+        A dictionary with search results formatted as XML-like document entries.
+    """
+    # First, get URLs from DuckDuckGo with "news" focus
+    results = []
+    news_sources = [
+        "bbc.com", "reuters.com", "apnews.com", "nasa.gov", 
+        "space.com", "universetoday.com", "nature.com", "science.org",
+        "scientificamerican.com", "nytimes.com", "theguardian.com"
+    ]
+    
+    # Find news from reliable sources
+    try:
+        with DDGS() as ddgs:
+            search_query = f"{query} site:{' OR site:'.join(news_sources)}"
+            for hit in ddgs.text(search_query, safesearch="On", max_results=top_k*2):
+                url = hit.get("href") or hit.get("url", "")
+                if not url:
+                    continue
+                
+                # Add the search snippet first as a fallback
+                result = {
+                    "source": url,
+                    "page": "",
+                    "content": hit.get("body", "")[:250],
+                    "title": hit.get("title", "")
+                }
+                
+                # Try to get better content via a more robust method
+                try:
+                    headers = {
+                        "User-Agent": random.choice([
+                            "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.110 Safari/537.36",
+                            "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Safari/605.1.15",
+                            "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.45 Safari/537.36"
+                        ]),
+                        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
+                        "Accept-Language": "en-US,en;q=0.5",
+                        "Referer": "https://www.google.com/",
+                        "DNT": "1",
+                        "Connection": "keep-alive",
+                        "Upgrade-Insecure-Requests": "1"
+                    }
+                    
+                    # Add a short delay between requests
+                    time.sleep(1 + random.random())
+                    
+                    # Try to use newspaper3k for more reliable article extraction
+                    from newspaper import Article
+                    article = Article(url)
+                    article.download()
+                    article.parse()
+                    
+                    # If we got meaningful content, update the result
+                    if article.text and len(article.text) > 100:
+                        # Get a summary - first paragraph + some highlights
+                        paragraphs = article.text.split('\n\n')
+                        first_para = paragraphs[0] if paragraphs else ""
+                        summary = first_para[:300]
+                        if len(paragraphs) > 1:
+                            summary += "... " + paragraphs[1][:200]
+                            
+                        result["content"] = summary
+                        if article.title:
+                            result["title"] = article.title
+                
+                except Exception as article_err:
+                    logger.warning(f"Article extraction failed for {url}: {article_err}")
+                    # Fallback to simple requests-based extraction
+                    try:
+                        resp = requests.get(url, timeout=12, headers=headers)
+                        resp.raise_for_status()
+                        soup = BeautifulSoup(resp.text, "html.parser")
+                        
+                        # Try to get main content
+                        main_content = soup.find('main') or soup.find('article') or soup.find('div', class_='content')
+                        
+                        if main_content:
+                            content = " ".join(main_content.get_text(separator=" ", strip=True).split()[:250])
+                            result["content"] = content
+                    except Exception as req_err:
+                        logger.warning(f"Fallback extraction failed for {url}: {req_err}")
+                        # Keep the original snippet as fallback
+                
+                results.append(result)
+                if len(results) >= top_k:
+                    break
+    
+    except Exception as e:
+        logger.error(f"News search failed: {e}")
+        return format_search_docs([{
+            "source": "Error",
+            "page": "",
+            "content": f"Failed to retrieve news articles for '{query}': {str(e)}"
+        }])
+    
+    if not results:
+        # Fallback to regular web search
+        logger.info(f"No news results found, falling back to web_search for {query}")
+        return web_search(query, top_k)
+    
+    return format_search_docs(results[:top_k])
+
+# ───────────────────────────────────────────────────────────── Document Chunking Utilities ──────────────────────────────────────────────────────────
+def chunk_document(text: str, chunk_size: int = 1000, overlap: int = 100) -> List[str]:
+    """
+    Split a large document into smaller chunks with overlap to maintain context across chunks.
+    
+    Args:
+        text: The document text to split into chunks
+        chunk_size: Maximum size of each chunk in characters
+        overlap: Number of characters to overlap between chunks
+        
+    Returns:
+        List of text chunks
+    """
+    # If text is smaller than chunk_size, return it as is
+    if len(text) <= chunk_size:
+        return [text]
+    
+    chunks = []
+    start = 0
+    
+    while start < len(text):
+        # Get chunk with overlap
+        end = min(start + chunk_size, len(text))
+        
+        # Try to find sentence boundary for cleaner breaks
+        if end < len(text):
+            # Look for sentence endings: period, question mark, or exclamation followed by space
+            for sentence_end in ['. ', '? ', '! ']:
+                last_period = text[start:end].rfind(sentence_end)
+                if last_period != -1:
+                    end = start + last_period + 2  # +2 to include the period and space
+                    break
+        
+        # Add chunk to list
+        chunks.append(text[start:end])
+        
+        # Move start position, accounting for overlap
+        start = end - overlap if end < len(text) else len(text)
+    
+    return chunks
+
+# Document processing utility that uses chunking
+def process_large_document(text: str, question: str, llm=None) -> str:
+    """
+    Process a large document by chunking it and using retrieval to find relevant parts.
+    
+    Args:
+        text: The document text to process
+        question: The question being asked about the document
+        llm: Optional language model to use (defaults to agent's LLM)
+        
+    Returns:
+        Summarized answer based on relevant chunks
+    """
+    if not llm:
+        llm = RetryingChatGroq(model="deepseek-r1-distill-llama-70b", streaming=False, temperature=0)
+    
+    # Split document into chunks
+    chunks = chunk_document(text)
+    
+    # If document is small enough, don't bother with retrieval
+    if len(chunks) <= 1:
+        return text
+    
+    # For larger documents, create embeddings to find relevant chunks
+    try:
+        from langchain_community.embeddings import HuggingFaceEmbeddings
+        from langchain.vectorstores import FAISS
+        from langchain.schema import Document
+        
+        # Create documents with chunk content
+        documents = [Document(page_content=chunk, metadata={"chunk_id": i}) for i, chunk in enumerate(chunks)]
+        
+        # Create embeddings and vector store
+        embeddings = HuggingFaceEmbeddings(model_name="sentence-transformers/all-mpnet-base-v2")
+        vectorstore = FAISS.from_documents(documents, embeddings)
+        
+        # Get most relevant chunks
+        relevant_chunks = vectorstore.similarity_search(question, k=2)  # Get top 2 most relevant chunks
+        
+        # Join the relevant chunks
+        relevant_text = "\n\n".join([doc.page_content for doc in relevant_chunks])
+        
+        # Option 1: Return relevant chunks directly
+        return relevant_text
+        
+        # Option 2: Summarize with LLM (commented out for now)
+        # prompt = f"Using only the following information, answer the question: '{question}'\n\nInformation:\n{relevant_text}"
+        # response = llm.invoke([HumanMessage(content=prompt)])
+        # return response.content
+    
+    except Exception as e:
+        # Fall back to first chunk if retrieval fails
+        logger.warning(f"Retrieval failed: {e}. Falling back to first chunk.")
+        return chunks[0]

v2/scratch_agent/agent2.py

@@ -0,0 +1,259 @@
+import os
+from dotenv import load_dotenv
+
+from langchain_core.tools import tool
+from langgraph.prebuilt import tools_condition, ToolNode
+from langgraph.graph import START, StateGraph, MessagesState
+
+from langchain_community.tools.tavily_search import TavilySearchResults
+from langchain_community.document_loaders import WikipediaLoader, ArxivLoader
+from langchain_core.messages import SystemMessage, HumanMessage
+from langchain_community.vectorstores import FAISS 
+from langchain_huggingface import HuggingFaceEmbeddings
+from langchain_groq import ChatGroq
+from langchain.tools.retriever import create_retriever_tool
+
+"""LangGraph Agent"""
+import os
+from dotenv import load_dotenv
+from langgraph.graph import START, StateGraph, MessagesState
+from langgraph.prebuilt import tools_condition
+from langgraph.prebuilt import ToolNode
+from langchain_google_genai import ChatGoogleGenerativeAI
+from langchain_groq import ChatGroq
+from langchain_huggingface import ChatHuggingFace, HuggingFaceEndpoint, HuggingFaceEmbeddings
+from langchain_community.tools.tavily_search import TavilySearchResults
+from langchain_community.document_loaders import WikipediaLoader
+from langchain_community.document_loaders import ArxivLoader
+from langchain_community.vectorstores import SupabaseVectorStore,FAISS 
+from langchain_core.messages import SystemMessage, HumanMessage
+from langchain_core.tools import tool
+from langchain.tools.retriever import create_retriever_tool
+#from supabase.client import Client, create_client
+
+# ──────────────────────────────────────────────────────────
+# ENV
+# ──────────────────────────────────────────────────────────
+load_dotenv()
+# API Keys from .env file
+os.environ.setdefault("OPENAI_API_KEY", "<YOUR_OPENAI_KEY>")  # Set your own key or env var
+os.environ["GROQ_API_KEY"] = os.getenv("GROQ_API_KEY", "default_key_or_placeholder")
+os.environ["MISTRAL_API_KEY"] = os.getenv("MISTRAL_API_KEY", "default_key_or_placeholder")
+
+# Tavily API Key
+TAVILY_API_KEY = os.getenv("TAVILY_API_KEY", "default_key_or_placeholder")
+_forbidden = ["nsfw", "porn", "sex", "explicit"]
+_playwright_available = True  # set False to disable Playwright
+
+embeddings = HuggingFaceEmbeddings(model_name="sentence-transformers/all-mpnet-base-v2")  # dim = 768
+
+@tool
+def multiply(a: int, b: int) -> int:
+    """Multiply two numbers.
+
+    Args:
+        a: first int
+        b: second int
+    """
+    return a * b
+
+@tool
+def add(a: int, b: int) -> int:
+    """Add two numbers.
+    
+    Args:
+        a: first int
+        b: second int
+    """
+    return a + b
+
+@tool
+def subtract(a: int, b: int) -> int:
+    """Subtract two numbers.
+    
+    Args:
+        a: first int
+        b: second int
+    """
+    return a - b
+
+@tool
+def divide(a: int, b: int) -> int:
+    """Divide two numbers.
+    
+    Args:
+        a: first int
+        b: second int
+    """
+    if b == 0:
+        raise ValueError("Cannot divide by zero.")
+    return a / b
+
+@tool
+def modulus(a: int, b: int) -> int:
+    """Get the modulus of two numbers.
+    
+    Args:
+        a: first int
+        b: second int
+    """
+    return a % b
+
+@tool
+def wiki_search(query: str) -> str:
+    """Search Wikipedia for a query and return maximum 2 results.
+    
+    Args:
+        query: The search query."""
+    search_docs = WikipediaLoader(query=query, load_max_docs=2).load()
+    formatted_search_docs = "\n\n---\n\n".join(
+        [
+            f'<Document source="{doc.metadata["source"]}" page="{doc.metadata.get("page", "")}"/>\n{doc.page_content}\n</Document>'
+            for doc in search_docs
+        ])
+    return {"wiki_results": formatted_search_docs}
+
+@tool
+def web_search(query: str) -> str:
+    """Search Tavily for a query and return maximum 3 results.
+    
+    Args:
+        query: The search query."""
+    search_docs = TavilySearchResults(max_results=3).invoke(query=query)
+    formatted_search_docs = "\n\n---\n\n".join(
+        [
+            f'<Document source="{doc.metadata["source"]}" page="{doc.metadata.get("page", "")}"/>\n{doc.page_content}\n</Document>'
+            for doc in search_docs
+        ])
+    return {"web_results": formatted_search_docs}
+
+@tool
+def arvix_search(query: str) -> str:
+    """Search Arxiv for a query and return maximum 3 result.
+    
+    Args:
+        query: The search query."""
+    search_docs = ArxivLoader(query=query, load_max_docs=3).load()
+    formatted_search_docs = "\n\n---\n\n".join(
+        [
+            f'<Document source="{doc.metadata["source"]}" page="{doc.metadata.get("page", "")}"/>\n{doc.page_content[:1000]}\n</Document>'
+            for doc in search_docs
+        ])
+    return {"arvix_results": formatted_search_docs}
+
+
+
+# load the system prompt from the file
+with open("system_prompt.txt", "r", encoding="utf-8") as f:
+    system_prompt = f.read()
+
+# System message
+sys_msg = SystemMessage(content=system_prompt)
+
+# build a retriever
+embeddings = HuggingFaceEmbeddings(model_name="sentence-transformers/all-mpnet-base-v2") #  dim=768
+
+INDEX_PATH = "faiss_index"
+if os.path.exists(INDEX_PATH):
+    vector_store = FAISS.load_local(INDEX_PATH, embeddings, allow_dangerous_deserialization=True)
+else:
+    vector_store = FAISS.from_texts(["__init__"], embeddings)
+    vector_store.save_local(INDEX_PATH)
+
+create_retriever_tool = create_retriever_tool(
+    retriever=vector_store.as_retriever(),
+    name="Question Search",
+    description="A tool to retrieve similar questions from a local FAISS vector store."
+)
+
+
+
+tools = [
+    multiply,
+    add,
+    subtract,
+    divide,
+    modulus,
+    wiki_search,
+    web_search,
+    arvix_search,
+]
+
+# Build graph function
+def build_graph(provider: str = "groq"):
+    """Build the graph"""
+    # Load environment variables from .env file
+    if provider == "google":
+        # Google Gemini
+        llm = ChatGoogleGenerativeAI(model="gemini-2.0-flash", temperature=0)
+    elif provider == "groq":
+        # Groq https://console.groq.com/docs/models
+        try:
+            llm = ChatGroq(model="deepseek-r1-distill-llama-70b", temperature=0) # optional : qwen-qwq-32b gemma2-9b-it
+        except Exception as e:
+            print(f"Error initializing Groq: {str(e)}")
+            raise
+    elif provider == "huggingface":
+        # TODO: Add huggingface endpoint
+        llm = ChatHuggingFace(
+            llm=HuggingFaceEndpoint(
+                url="https://api-inference.huggingface.co/models/Meta-DeepLearning/llama-2-7b-chat-hf",
+                temperature=0,
+            ),
+        )
+    else:
+        raise ValueError("Invalid provider. Choose 'google', 'groq' or 'huggingface'.")
+    
+    # Bind tools to LLM
+    llm_with_tools = llm.bind_tools(tools)
+
+    # Node
+    def assistant(state: MessagesState):
+        """Assistant node"""
+        try:
+            if not state["messages"] or not state["messages"][-1].content:
+                raise ValueError("Empty message content")
+            return {"messages": [llm_with_tools.invoke(state["messages"])]}
+        except Exception as e:
+            print(f"Error in assistant node: {str(e)}")
+            raise
+    
+    def retriever(state: MessagesState):
+        """Retriever node"""
+        try:
+            if not state["messages"] or not state["messages"][0].content:
+                raise ValueError("Empty message content")
+            similar_question = vector_store.similarity_search(state["messages"][0].content)
+            example_msg = HumanMessage(
+                content=f"Here I provide a similar question and answer for reference: \n\n{similar_question[0].page_content}",
+            )
+            return {"messages": [sys_msg] + state["messages"] + [example_msg]}
+        except Exception as e:
+            print(f"Error in retriever node: {str(e)}")
+            raise
+
+    builder = StateGraph(MessagesState)
+    builder.add_node("retriever", retriever)
+    builder.add_node("assistant", assistant)
+    builder.add_node("tools", ToolNode(tools))
+    builder.add_edge(START, "retriever")
+    builder.add_edge("retriever", "assistant")
+    builder.add_conditional_edges(
+        "assistant",
+        tools_condition,
+    )
+    builder.add_edge("tools", "assistant")
+
+    # Compile graph
+    return builder.compile()
+
+# test
+if __name__ == "__main__":
+    question = "When was a picture of St. Thomas Aquinas first added to the Wikipedia page on the Principle of double effect?"
+    # Build the graph
+    graph = build_graph(provider="groq")
+    # Run the graph
+    messages = [HumanMessage(content=question)]
+    messages = graph.invoke({"messages": messages})
+    for m in messages["messages"]:
+        m.pretty_print()

v2/scratch_agent/all_prompts.py

@@ -0,0 +1,108 @@
+# import os 
+
+
+# SYSTEM_PROMPT = """
+# You are an expert AI assistant named GameScratchAgent, specialized in generating and modifying Scratch-VM 3.x game project JSON.
+# Your core task is to process game descriptions and existing Scratch JSON structures, then produce or update JSON segments accurately.
+# You possess deep knowledge of Scratch 3.0 project schema, informed by comprehensive reference materials. When generating or modifying the `blocks` section, pay extremely close attention to the following:
+
+# **Scratch Project JSON Schema Rules:**
+
+# 1.  **Target Structure (`project.json`'s `targets` array):**
+#     * Each object in the `targets` array represents a Stage or a Sprite.
+#     * `isStage`: A boolean indicating if the target is the Stage (`true`) or a Sprite (`false`).
+#     * `name`: The name of the Stage (e.g., `"Stage"`) or the Sprite (e.g., `"Cat"`). This property replaces `objName` found in older Scratch versions.
+#     * `variables` dictionary: This dictionary maps unique variable IDs to arrays `[variable_name, initial_value, isCloudVariable?]`.
+#         * `variable_name`: The user-defined name of the variable.
+#         * `initial_value`: The variable's initial value, which can be a number or a string.
+#         * `isCloudVariable?`: (Optional) A boolean indicating if it's a cloud variable (`true`) or a local variable (`false` or absent for regular variables).
+#         * Example: `"myVarId123": ["score", 0]`, `"cloudVarId456": ["☁ High Score", "54", true]`
+#     * `lists` dictionary: This dictionary maps unique list IDs to arrays `[list_name, [item1, item2, ...]]`.
+#         * Example: `"myListId789": ["my list", ["apple", "banana"]]`
+#     * `broadcasts` dictionary: This dictionary maps unique broadcast IDs to their names.
+#         * Example: `"myBroadcastId": "Game Over"`
+#     * `blocks` dictionary: This dictionary contains all the blocks belonging to this target. Keys are block IDs, values are block objects.
+
+# 2.  **Block Structure (within a `target`'s `blocks` dictionary):**
+#     * Every block object must have the following core properties:
+#         * [cite_start]`opcode`: A unique internal identifier for the block's specific functionality (e.g., `"motion_movesteps"`, `"event_whenflagclicked"`)[cite: 31, 18, 439, 452].
+#         * `parent`: The ID of the block directly above it in the script stack (or `null` for a top-level block).
+#         * `next`: The ID of the block directly below it in the script stack (or `null` for the end of a stack).
+#         * `inputs`: An object defining values or blocks plugged into the block's input slots. Values are **arrays**.
+#         * `fields`: An object defining dropdown menu selections or direct internal values within the block. Values are **arrays**.
+#         * `shadow`: `true` if it's a shadow block (e.g., a default number input that can be replaced by another block), `false` otherwise.
+#         * `topLevel`: `true` if it's a hat block or a standalone block (not connected to a parent), `false` otherwise.
+
+# 3.  **`inputs` Property Details (for blocks plugged into input slots):**
+#     * **Direct Block Connection (Reporter/Boolean block plugged in):**
+#         * Format: `"<INPUT_NAME>": [1, "<blockId_of_plugged_block>"]`
+#         * Example: `"CONDITION": [1, "someBooleanBlockId"]` (e.g., for an `if` block).
+#     * **Literal Value Input (Shadow block with a literal):**
+#         * Format: `"<INPUT_NAME>": [1, [<type_code>, "<value_string>"]]`
+#         * `type_code`: A numeric code representing the data type. Common codes include: `4` for number, `7` for string/text, `10` for string/message.
+#         * `value_string`: The literal value as a string.
+#         * Examples:
+#             * Number: `"STEPS": [1, [4, "10"]]` (for `move 10 steps` block).
+#             * String/Text: `"MESSAGE": [1, [7, "Hello"]]` (for `say Hello` block).
+#             * String/Message (common for text inputs): `"MESSAGE": [1, [10, "Hello!"]]` (for `say Hello! for 2 secs`).
+#     * **C-Block Substack (blocks within a loop or conditional):**
+#         * Format: `"<SUBSTACK_NAME>": [2, "<blockId_of_first_block_in_substack>"]`
+#         * Common `SUBSTACK_NAME` values are `SUBSTACK` (for `if`, `forever`, `repeat`) and `SUBSTACK2` (for `else` in `if else`).
+#         * Example: `"SUBSTACK": [2, "firstBlockInLoopId"]`
+
+# 4.  **`fields` Property Details (for dropdowns or direct internal values):**
+#     * Used for dropdown menus, variable names, list names, or other static selections directly within the block.
+#     * Format: `"<FIELD_NAME>": ["<selected_value>", null]`
+#     * Examples:
+#         * Dropdown: `"KEY_OPTION": ["space", null]` (for `when space key pressed`).
+#         * Variable Name: `"VARIABLE": ["score", null]` (for `set score to 0`).
+#         * Direction (specific motion block): `"FORWARD_BACKWARD": ["forward", null]` (for `go forward layers`).
+
+# 5.  **Unique IDs:**
+#     * All block IDs, variable IDs, and list IDs must be unique strings (e.g., "myBlock123", "myVarId456", "myListId789"). Do NOT use placeholder strings like "block_id_here".
+
+# 6.  **No Nested `blocks` Dictionary:**
+#     * The `blocks` dictionary should only appear once per `target` (sprite/stage). Do NOT nest a `blocks` dictionary inside an individual block definition. Blocks that are part of a substack are linked via the `SUBSTACK` input.
+
+# 7.  **Asset Properties (for Costumes/Sounds):**
+#     * `assetId`, `md5ext`, `bitmapResolution`, `rotationCenterX`/`rotationCenterY` should be correctly associated with costume and sound objects within the `costumes` and `sounds` arrays.
+
+# **General Principles and Important Considerations:**
+# * **Backward Compatibility:** Adhere strictly to existing Scratch 3.0 opcodes and schema to ensure backward compatibility with older projects. [cite_start]Opcodes must remain consistent to prevent previously saved projects from failing to load or behaving unexpectedly[cite: 18, 19, 25, 65].
+# * **Forgiving Inputs:** Recognize that Scratch is designed to be "forgiving in its interpretation of inputs." [cite_start]The Scratch VM handles potentially "invalid" inputs gracefully (e.g., converting a number to a string if expected, returning default values like zero or empty strings, or performing no action) rather than crashing[cite: 20, 21, 22, 38, 39, 41]. This implies that precise type matching for inputs might be handled internally by Scratch, allowing for some flexibility in how values are provided, but the agent should aim for the most common and logical type.
+# """
+
+# SYSTEM_PROMPT_JSON_CORRECTOR ="""
+# You are an assistant that outputs JSON responses strictly following the given schema.  
+# If the JSON you produce has any formatting errors, missing required fields, or invalid structure, you must identify the problems and correct them.  
+# Always return only valid JSON that fully conforms to the schema below, enclosed in triple backticks (```), without any extra text or explanation.  
+
+# If you receive an invalid or incomplete JSON response, fix it by:  
+# - Adding any missing required fields with appropriate values.  
+# - Correcting syntax errors such as missing commas, brackets, or quotes.  
+# - Ensuring the JSON structure matches the schema exactly.  
+
+# Remember: Your output must be valid JSON only, ready to be parsed without errors.
+# """
+
+# llm_query_prompt = f"""Based on the user's game description: '{state['description']}', \
+# and the current Scratch project JSON below, \
+# determine the most appropriate initial 'x' and 'y' coordinates for each sprite. \
+# Return ONLY a JSON object with a single key 'sprite_initial_positions' mapping sprite names to their {{'x': int, 'y': int}} coordinates.
+
+# The current Scratch project JSON is:
+# ```json
+# {json.dumps(state['project_json'], indent=2)}
+# ```
+
+# Example Json output:
+
+# ```json
+# {{
+#     "sprite_initial_positions": {{
+#     "Sprite1": {{"x": -160, "y": -110}},
+#     "Sprite2": {{"x": 240, "y": -135}}
+#     }}
+# }}
+# ```
+# """

v2/scratch_agent/block_function.py

@@ -0,0 +1,1147 @@
+import json
+import copy
+import re
+
+def generate_blocks_from_opcodes(opcode_counts, all_block_definitions):
+    """
+    Generates a dictionary of Scratch-like blocks based on a list of opcodes and a reference block definition.
+    It now correctly links parent and menu blocks using their generated unique keys, and handles various block categories.
+    It ensures that menu blocks are only generated as children of their respective parent blocks.
+
+    Args:
+        opcode_counts (list): An array of objects, each with an 'opcode' and 'count' property.
+                              Example: [{"opcode": "motion_gotoxy", "count": 1}]
+        all_block_definitions (dict): A comprehensive dictionary containing definitions for all block types.
+
+    Returns:
+        tuple: A tuple containing:
+            - dict: A JSON object where keys are generated block IDs and values are the block definitions.
+            - dict: The opcode_occurrences dictionary for consistent unique key generation across functions.
+    """
+    generated_blocks = {}
+    opcode_occurrences = {}  # To keep track of how many times each opcode (main or menu) has been used for unique keys
+
+    # Define explicit parent-menu relationships for linking purposes
+    # This maps main_opcode -> list of (input_field_name, menu_opcode)
+    explicit_menu_links = {
+        "motion_goto": [("TO", "motion_goto_menu")],
+        "motion_glideto": [("TO", "motion_glideto_menu")],
+        "motion_pointtowards": [("TOWARDS", "motion_pointtowards_menu")],
+        "sensing_keypressed": [("KEY_OPTION", "sensing_keyoptions")],
+        "sensing_of": [("OBJECT", "sensing_of_object_menu")],
+        "sensing_touchingobject": [("TOUCHINGOBJECTMENU", "sensing_touchingobjectmenu")],
+        "control_create_clone_of": [("CLONE_OPTION", "control_create_clone_of_menu")],
+        "sound_play": [("SOUND_MENU", "sound_sounds_menu")],
+        "sound_playuntildone": [("SOUND_MENU", "sound_sounds_menu")],
+        "looks_switchcostumeto": [("COSTUME", "looks_costume")],
+        "looks_switchbackdropto": [("BACKDROP", "looks_backdrops")],
+    }
+
+    # --- Step 1: Process explicitly requested opcodes and generate their instances and associated menus ---
+    for item in opcode_counts:
+        opcode = item.get("opcode")
+        count = item.get("count", 1)
+
+        if not opcode:
+            print("Warning: Skipping item with missing 'opcode'.")
+            continue
+
+        if opcode not in all_block_definitions:
+            print(f"Warning: Opcode '{opcode}' not found in all_block_definitions. Skipping.")
+            continue
+
+        for _ in range(count):
+            # Increment occurrence count for the current main opcode
+            opcode_occurrences[opcode] = opcode_occurrences.get(opcode, 0) + 1
+            main_block_instance_num = opcode_occurrences[opcode]
+            
+            main_block_unique_key = f"{opcode}_{main_block_instance_num}"
+            
+            # Create a deep copy of the main block definition
+            main_block_data = copy.deepcopy(all_block_definitions[opcode])
+            
+            # Set properties for a top-level main block
+            main_block_data["parent"] = None
+            main_block_data["next"] = None
+            main_block_data["topLevel"] = True
+            main_block_data["shadow"] = False # Main blocks are typically not shadows
+
+            generated_blocks[main_block_unique_key] = main_block_data
+
+            # If this main block has associated menus, generate and link them now
+            if opcode in explicit_menu_links:
+                for input_field_name, menu_opcode_type in explicit_menu_links[opcode]:
+                    if menu_opcode_type in all_block_definitions:
+                        # Increment the occurrence for the menu block type
+                        opcode_occurrences[menu_opcode_type] = opcode_occurrences.get(menu_opcode_type, 0) + 1
+                        menu_block_instance_num = opcode_occurrences[menu_opcode_type]
+
+                        menu_block_data = copy.deepcopy(all_block_definitions[menu_opcode_type])
+                        
+                        # Generate a unique key for this specific menu instance
+                        menu_unique_key = f"{menu_opcode_type}_{menu_block_instance_num}"
+                        
+                        # Set properties for a shadow menu block
+                        menu_block_data["shadow"] = True
+                        menu_block_data["topLevel"] = False
+                        menu_block_data["next"] = None
+                        menu_block_data["parent"] = main_block_unique_key # Link menu to its parent instance
+
+                        # Update the main block's input to point to this unique menu instance
+                        if input_field_name in main_block_data.get("inputs", {}) and \
+                           isinstance(main_block_data["inputs"][input_field_name], list) and \
+                           len(main_block_data["inputs"][input_field_name]) > 1 and \
+                           main_block_data["inputs"][input_field_name][0] == 1:
+                            
+                            main_block_data["inputs"][input_field_name][1] = menu_unique_key
+                        
+                        generated_blocks[menu_unique_key] = menu_block_data
+            
+    return generated_blocks, opcode_occurrences
+
+def interpret_pseudo_code_and_update_blocks(generated_blocks_json, pseudo_code, all_block_definitions, opcode_occurrences):
+    """
+    Interprets pseudo-code to update the generated Scratch blocks, replacing static values
+    with dynamic values and establishing stacking/nesting logic.
+
+    Args:
+        generated_blocks_json (dict): The JSON object of pre-generated blocks.
+        pseudo_code (str): The pseudo-code string to interpret.
+        all_block_definitions (dict): A comprehensive dictionary containing definitions for all block types.
+        opcode_occurrences (dict): A dictionary to keep track of opcode occurrences for unique key generation.
+
+    Returns:
+        dict: The updated JSON object of Scratch blocks.
+    """
+    updated_blocks = copy.deepcopy(generated_blocks_json)
+    
+    # Helper to find a block by opcode and optionally by a unique part of its key
+    def find_block_by_opcode(opcode_to_find, instance_num=None, parent_key=None):
+        for key, block in updated_blocks.items():
+            if block["opcode"] == opcode_to_find:
+                if instance_num is not None:
+                    # Check if the key ends with the instance number
+                    if key.endswith(f"_{instance_num}"):
+                        return key, block
+                elif parent_key is not None:
+                    # For menu blocks, check if their parent matches
+                    if block.get("shadow") and block.get("parent") == parent_key:
+                        return key, block
+                else:
+                    # Return the first one found if no specific instance is needed
+                    return key, block
+        return None, None
+
+    # Helper to get a unique key for a new block if needed
+    def get_unique_key(opcode_prefix):
+        count = 1
+        while f"{opcode_prefix}_{count}" in updated_blocks:
+            count += 1
+        return f"{opcode_prefix}_{count}"
+
+    lines = [line.strip() for line in pseudo_code.strip().split('\n') if line.strip()]
+
+    # Track the current script and nesting
+    current_script_head = None
+    current_parent_stack = [] # Stores (parent_block_key, indent_level, last_child_key)
+    indent_level = 0
+
+    # Create a mapping from block name patterns to their opcodes and input details
+    # Prioritize more specific patterns first
+    pseudo_code_to_opcode_map = {
+        re.compile(r"when green flag clicked"): {"opcode": "event_whenflagclicked"},
+        re.compile(r"go to x: \((.+?)\) y: \((.+?)\)"): {"opcode": "motion_gotoxy", "input_names": ["X", "Y"]},
+        re.compile(r"set \[(.+?) v\] to (.+)"): {"opcode": "data_setvariableto", "field_name": "VARIABLE", "input_name": "VALUE"},
+        re.compile(r"change \[(.+?) v\] by \((.+)\)"): {"opcode": "data_changevariableby", "field_name": "VARIABLE", "input_name": "VALUE"},
+        re.compile(r"show variable \[(.+?) v\]"): {"opcode": "data_showvariable", "field_name": "VARIABLE"},
+        re.compile(r"hide variable \[(.+?) v\]"): {"opcode": "data_hidevariable", "field_name": "VARIABLE"},
+        re.compile(r"forever"): {"opcode": "control_forever"},
+        re.compile(r"glide \((.+?)\) seconds to x: \((.+?)\) y: \((.+?)\)"): {"opcode": "motion_glidesecstoxy", "input_names": ["SECS", "X", "Y"]},
+        re.compile(r"if <\((.+)\) < \((.+)\)> then"): {"opcode": "control_if", "input_names": ["OPERAND1", "OPERAND2"], "condition_opcode": "operator_lt"},
+        re.compile(r"if <touching \[(.+?) v\]\?> then"): {"opcode": "control_if", "input_name": "TOUCHINGOBJECTMENU", "condition_opcode": "sensing_touchingobject"},
+        re.compile(r"set x to \((.+?)\)"): {"opcode": "motion_setx", "input_name": "X"},
+        re.compile(r"broadcast \[(.+?) v\]"): {"opcode": "event_broadcast", "input_name": "BROADCAST_INPUT"},
+        re.compile(r"stop \[(.+?) v\]"): {"opcode": "control_stop", "field_name": "STOP_OPTION"},
+        re.compile(r"end"): {"opcode": "end_block"}, # Special marker for script end/C-block end
+    }
+
+    # Create a reverse lookup for reporter block opcodes based on their pseudo-code representation
+    reporter_opcode_lookup = {}
+    for opcode, definition in all_block_definitions.items():
+        if definition.get("block_shape") == "Reporter Block":
+            block_name = definition.get("block_name")
+            if block_name:
+                # Remove parentheses for matching
+                clean_name = block_name.replace("(", "").replace(")", "").strip()
+                reporter_opcode_lookup[clean_name] = opcode
+                # Handle cases like "x position" vs "(x position)"
+                if clean_name not in reporter_opcode_lookup:
+                    reporter_opcode_lookup[clean_name] = opcode
+
+    # Function to create a new block instance
+    def create_block_instance(opcode, opcode_occurrences, parent_key=None, is_shadow=False, is_top_level=False):
+        # Ensure unique key generation is consistent
+        opcode_occurrences[opcode] = opcode_occurrences.get(opcode, 0) + 1
+        unique_key = f"{opcode}_{opcode_occurrences[opcode]}"
+        
+        new_block = copy.deepcopy(all_block_definitions.get(opcode, {}))
+        if not new_block:
+            print(f"Error: Definition for opcode '{opcode}' not found.")
+            return None, None
+
+        new_block["parent"] = parent_key
+        new_block["next"] = None # Will be set by stacking logic
+        new_block["topLevel"] = is_top_level
+        new_block["shadow"] = is_shadow
+
+        # Clear inputs/fields to be populated by pseudo-code parsing
+        if "inputs" in new_block:
+            new_block["inputs"] = {k: copy.deepcopy(v) for k, v in new_block["inputs"].items()} # Deep copy inputs
+            for input_name in new_block["inputs"]:
+                if isinstance(new_block["inputs"][input_name], list) and len(new_block["inputs"][input_name]) > 1:
+                    # Reset input value, keep type 1 for block reference or type 4/10 for literal
+                    if new_block["inputs"][input_name][0] == 1:
+                        new_block["inputs"][input_name][1] = None # Placeholder for linked block ID
+                    else:
+                        new_block["inputs"][input_name][1] = ["", ""] # Default empty value
+        if "fields" in new_block:
+            new_block["fields"] = {k: copy.deepcopy(v) for k, v in new_block["fields"].items()} # Deep copy fields
+            for field_name in new_block["fields"]:
+                if isinstance(new_block["fields"][field_name], list) and len(new_block["fields"][field_name]) > 0:
+                    new_block["fields"][field_name][0] = "" # Reset field value
+
+        updated_blocks[unique_key] = new_block
+        return unique_key, new_block
+
+    # Helper to parse input values
+    def parse_input_value(value_str):
+        value_str = value_str.strip()
+        # Handle numeric values (including those with + or - prefix)
+        if re.fullmatch(r"[-+]?\d+(\.\d+)?", value_str):
+            return [4, value_str] # Type 4 for number
+        # Handle string literals (e.g., "Hello!")
+        if value_str.startswith('"') and value_str.endswith('"'):
+            return [10, value_str.strip('"')] # Type 10 for string
+        # Handle variable/list names (e.g., [score v], [my list v])
+        if value_str.startswith('[') and value_str.endswith(']'):
+            var_name = value_str[1:-1].replace(' v', '').strip()
+            # For inputs that expect a variable, we might need a data_variable block
+            # For now, if it's a variable reference in an input, we'll return its name.
+            # The calling context (e.g., set variable's field vs. an input) will determine type.
+            return [12, var_name] # Custom type 12 for variable name, to be resolved later
+
+        # Handle nested reporter blocks (e.g., (x position))
+        if value_str.startswith('(') and value_str.endswith(')'):
+            inner_content = value_str[1:-1].strip()
+            # Check if it's a known reporter block
+            if inner_content in reporter_opcode_lookup:
+                return [3, reporter_opcode_lookup[inner_content]] # Type 3 for reporter block reference
+            # If not a known reporter, treat as a number or string
+            if re.fullmatch(r"[-+]?\d+(\.\d+)?", inner_content):
+                return [4, inner_content]
+            return [10, inner_content] # Default to string if not found in reporters
+        
+        # Handle boolean conditions (e.g., <(x position) < (-235)>) - these are usually handled by parent regex
+        if value_str.startswith('<') and value_str.endswith('>'):
+            inner_condition = value_str[1:-1].strip()
+            # This is typically handled by the regex that matched the 'if' block itself.
+            # If this is called for a standalone boolean, it would be a reporter.
+            for op, def_ in all_block_definitions.items():
+                if def_.get("block_shape") == "Boolean Block" and def_.get("block_name") and \
+                   def_["block_name"].replace("<", "").replace(">", "").strip() == inner_condition:
+                    return [2, op] # Type 2 for boolean block reference
+            return [10, inner_condition] # Default to string if not found
+        
+        return [10, value_str] # Default to string literal
+
+
+    # Main parsing loop
+    block_stack = [] # (block_key, indent_level, last_child_key_in_scope) for tracking nesting
+
+    for line_idx, raw_line in enumerate(lines):
+        current_line_indent = len(raw_line) - len(raw_line.lstrip())
+        line = raw_line.strip()
+
+        # Adjust block_stack based on current indent level
+        while block_stack and current_line_indent <= block_stack[-1][1]:
+            block_stack.pop()
+
+        matched_block_info = None
+        matched_values = None
+        
+        # Try to match the line against known block patterns
+        for pattern_regex, info in pseudo_code_to_opcode_map.items():
+            match = pattern_regex.match(line)
+            if match:
+                matched_block_info = info
+                matched_values = match.groups()
+                break
+        
+        if not matched_block_info:
+            print(f"Warning: Could not interpret line: '{line}'")
+            continue
+
+        opcode = matched_block_info["opcode"]
+
+        # Handle 'end' block separately as it signifies closing a C-block
+        if opcode == "end_block":
+            if block_stack:
+                block_stack.pop() # Pop the C-block parent
+            continue
+
+        parent_key = None
+        if block_stack:
+            parent_key = block_stack[-1][0] # The last block on the stack is the parent
+
+        # Create the new block instance
+        new_block_key, new_block_data = create_block_instance(
+            opcode, 
+            opcode_occurrences, 
+            parent_key=parent_key, 
+            is_top_level=(parent_key is None)
+        )
+        if not new_block_key:
+            continue
+
+        # Link to previous block in the same script/nesting level
+        if block_stack:
+            # Update the 'next' of the previous block in the current scope
+            last_child_key_in_scope = block_stack[-1][2] if len(block_stack[-1]) > 2 else None
+            if last_child_key_in_scope and last_child_key_in_scope in updated_blocks:
+                updated_blocks[last_child_key_in_scope]["next"] = new_block_key
+            
+            # Update the last child in the current scope
+            block_stack[-1] = (block_stack[-1][0], block_stack[-1][1], new_block_key)
+        
+        # Populate inputs and fields
+        if matched_values:
+            # Handle specific block types with their inputs/fields
+            if opcode == "motion_gotoxy":
+                x_val = parse_input_value(matched_values[0])
+                y_val = parse_input_value(matched_values[1])
+                new_block_data["inputs"]["X"][1] = x_val[1]
+                new_block_data["inputs"]["Y"][1] = y_val[1]
+                new_block_data["inputs"]["X"][0] = x_val[0]
+                new_block_data["inputs"]["Y"][0] = y_val[0]
+            elif opcode == "data_setvariableto":
+                var_name = matched_values[0].replace(' v', '').strip()
+                value_parsed = parse_input_value(matched_values[1])
+                new_block_data["fields"]["VARIABLE"][0] = var_name
+                # Assuming variable ID is generated elsewhere or can be looked up
+                new_block_data["fields"]["VARIABLE"][1] = f"`var_{var_name}" # Placeholder for variable ID
+                new_block_data["inputs"]["VALUE"][0] = value_parsed[0]
+                new_block_data["inputs"]["VALUE"][1] = value_parsed[1]
+            elif opcode == "data_showvariable":
+                var_name = matched_values[0].replace(' v', '').strip()
+                new_block_data["fields"]["VARIABLE"][0] = var_name
+                new_block_data["fields"]["VARIABLE"][1] = f"`var_{var_name}" # Placeholder for variable ID
+            elif opcode == "motion_glidesecstoxy":
+                secs_val = parse_input_value(matched_values[0])
+                x_val = parse_input_value(matched_values[1])
+                y_val = parse_input_value(matched_values[2])
+                new_block_data["inputs"]["SECS"][1] = secs_val[1]
+                new_block_data["inputs"]["X"][1] = x_val[1]
+                new_block_data["inputs"]["Y"][1] = y_val[1]
+                new_block_data["inputs"]["SECS"][0] = secs_val[0]
+                new_block_data["inputs"]["X"][0] = x_val[0]
+                new_block_data["inputs"]["Y"][0] = y_val[0]
+            elif opcode == "motion_setx":
+                x_val = parse_input_value(matched_values[0])
+                new_block_data["inputs"]["X"][1] = x_val[1]
+                new_block_data["inputs"]["X"][0] = x_val[0]
+            elif opcode == "control_if":
+                condition_opcode = matched_block_info["condition_opcode"]
+                
+                if condition_opcode == "operator_lt":
+                    op1_str = matched_values[0].strip()
+                    op2_str = matched_values[1].strip()
+
+                    op1_parsed = parse_input_value(op1_str)
+                    op2_parsed = parse_input_value(op2_str)
+
+                    # Create operator_lt block as a shadow input for the IF condition
+                    lt_block_key, lt_block_data = create_block_instance(
+                        "operator_lt", 
+                        opcode_occurrences, 
+                        parent_key=new_block_key, 
+                        is_shadow=True, 
+                        is_top_level=False
+                    )
+                    if lt_block_key:
+                        new_block_data["inputs"]["CONDITION"][1] = lt_block_key
+                        new_block_data["inputs"]["CONDITION"][0] = 2 # Type 2 for boolean block reference
+
+                        # Populate operator_lt inputs
+                        if op1_parsed[0] == 3: # If it's a reporter block
+                            op1_reporter_key, op1_reporter_data = create_block_instance(
+                                op1_parsed[1], # Opcode of the reporter
+                                opcode_occurrences, 
+                                parent_key=lt_block_key, 
+                                is_shadow=True, 
+                                is_top_level=False
+                            )
+                            if op1_reporter_key:
+                                lt_block_data["inputs"]["OPERAND1"][1] = op1_reporter_key
+                                lt_block_data["inputs"]["OPERAND1"][0] = 3
+                        else: # Literal value
+                            lt_block_data["inputs"]["OPERAND1"][1] = op1_parsed[1]
+                            lt_block_data["inputs"]["OPERAND1"][0] = op1_parsed[0]
+                        
+                        lt_block_data["inputs"]["OPERAND2"][1] = op2_parsed[1]
+                        lt_block_data["inputs"]["OPERAND2"][0] = op2_parsed[0]
+
+                elif condition_opcode == "sensing_touchingobject":
+                    sprite_name = matched_values[0].replace(' v', '').strip()
+                    touching_opcode = "sensing_touchingobject"
+                    
+                    touching_block_key, touching_block_data = create_block_instance(
+                        touching_opcode,
+                        opcode_occurrences, 
+                        parent_key=new_block_key,
+                        is_shadow=True,
+                        is_top_level=False
+                    )
+                    if touching_block_key:
+                        new_block_data["inputs"]["CONDITION"][1] = touching_block_key
+                        new_block_data["inputs"]["CONDITION"][0] = 2 # Type 2 for boolean block reference
+
+                        # Create the menu block for TOUCHINGOBJECTMENU
+                        menu_opcode = "sensing_touchingobjectmenu"
+                        menu_key, menu_data = create_block_instance(
+                            menu_opcode,
+                            opcode_occurrences, 
+                            parent_key=touching_block_key,
+                            is_shadow=True,
+                            is_top_level=False
+                        )
+                        if menu_key:
+                            touching_block_data["inputs"]["TOUCHINGOBJECTMENU"][1] = menu_key
+                            touching_block_data["inputs"]["TOUCHINGOBJECTMENU"][0] = 1 # Type 1 for block reference
+                            menu_data["fields"]["TOUCHINGOBJECTMENU"][0] = sprite_name
+                    else:
+                        print(f"Warning: Could not create touching object block for condition: '{line}'")
+
+
+            elif opcode == "control_forever":
+                # Forever blocks are C-blocks, so push them onto the stack
+                block_stack.append((new_block_key, current_line_indent, None)) # (parent_key, indent, last_child_key)
+            elif opcode == "control_stop":
+                option = matched_values[0].replace(' v', '').strip()
+                new_block_data["fields"]["STOP_OPTION"][0] = option
+            elif opcode == "event_broadcast":
+                message = matched_values[0].replace(' v', '').strip()
+                # For broadcast, the input is usually a string literal or a variable
+                new_block_data["inputs"]["BROADCAST_INPUT"][0] = 11 # Type 11 for broadcast input (string or variable)
+                new_block_data["inputs"]["BROADCAST_INPUT"][1] = [10, message] # Assume string literal for now
+                # A more robust solution would create a data_variable block if it's a variable.
+
+        # For C-blocks, push onto stack to track nesting
+        if all_block_definitions[opcode].get("block_shape") == "C-Block" and opcode != "control_if": # if is handled above
+             block_stack.append((new_block_key, current_line_indent, None)) # (parent_key, indent, last_child_key)
+
+
+    return updated_blocks
+
+# --- Consolidated Block Definitions from all provided JSONs ---
+all_block_definitions = {
+    # motion_block.json
+    "motion_movesteps": {
+        "opcode": "motion_movesteps", "next": None, "parent": None,
+        "inputs": {"STEPS": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 464, "y": -416
+    },
+    "motion_turnright": {
+        "opcode": "motion_turnright", "next": None, "parent": None,
+        "inputs": {"DEGREES": [1, [4, "15"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 467, "y": -316
+    },
+    "motion_turnleft": {
+        "opcode": "motion_turnleft", "next": None, "parent": None,
+        "inputs": {"DEGREES": [1, [4, "15"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 464, "y": -210
+    },
+    "motion_goto": {
+        "opcode": "motion_goto", "next": None, "parent": None,
+        "inputs": {"TO": [1, "motion_goto_menu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 465, "y": -95
+    },
+    "motion_goto_menu": {
+        "opcode": "motion_goto_menu", "next": None, "parent": "motion_goto",
+        "inputs": {}, "fields": {"TO": ["_random_", None]}, "shadow": True, "topLevel": False
+    },
+    "motion_gotoxy": {
+        "opcode": "motion_gotoxy", "next": None, "parent": None,
+        "inputs": {"X": [1, [4, "0"]], "Y": [1, [4, "0"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 468, "y": 12
+    },
+    "motion_glideto": {
+        "opcode": "motion_glideto", "next": None, "parent": None,
+        "inputs": {"SECS": [1, [4, "1"]], "TO": [1, "motion_glideto_menu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 470, "y": 129
+    },
+    "motion_glideto_menu": {
+        "opcode": "motion_glideto_menu", "next": None, "parent": "motion_glideto",
+        "inputs": {}, "fields": {"TO": ["_random_", None]}, "shadow": True, "topLevel": False
+    },
+    "motion_glidesecstoxy": {
+        "opcode": "motion_glidesecstoxy", "next": None, "parent": None,
+        "inputs": {"SECS": [1, [4, "1"]], "X": [1, [4, "0"]], "Y": [1, [4, "0"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 476, "y": 239
+    },
+    "motion_pointindirection": {
+        "opcode": "motion_pointindirection", "next": None, "parent": None,
+        "inputs": {"DIRECTION": [1, [8, "90"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 493, "y": 361
+    },
+    "motion_pointtowards": {
+        "opcode": "motion_pointtowards", "next": None, "parent": None,
+        "inputs": {"TOWARDS": [1, "motion_pointtowards_menu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 492, "y": 463
+    },
+    "motion_pointtowards_menu": {
+        "opcode": "motion_pointtowards_menu", "next": None, "parent": "motion_pointtowards",
+        "inputs": {}, "fields": {"TOWARDS": ["_mouse_", None]}, "shadow": True, "topLevel": False
+    },
+    "motion_changexby": {
+        "opcode": "motion_changexby", "next": None, "parent": None,
+        "inputs": {"DX": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 851, "y": -409
+    },
+    "motion_setx": {
+        "opcode": "motion_setx", "next": None, "parent": None,
+        "inputs": {"X": [1, [4, "0"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 864, "y": -194
+    },
+    "motion_changeyby": {
+        "opcode": "motion_changeyby", "next": None, "parent": None,
+        "inputs": {"DY": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 861, "y": -61
+    },
+    "motion_sety": {
+        "opcode": "motion_sety", "next": None, "parent": None,
+        "inputs": {"Y": [1, [4, "0"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 864, "y": 66
+    },
+    "motion_ifonedgebounce": {
+        "opcode": "motion_ifonedgebounce", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1131, "y": -397
+    },
+    "motion_setrotationstyle": {
+        "opcode": "motion_setrotationstyle", "next": None, "parent": None,
+        "inputs": {}, "fields": {"STYLE": ["left-right", None]}, "shadow": False, "topLevel": True,
+        "x": 1128, "y": -287
+    },
+    "motion_xposition": {
+        "opcode": "motion_xposition", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1193, "y": -136
+    },
+    "motion_yposition": {
+        "opcode": "motion_yposition", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1181, "y": -64
+    },
+    "motion_direction": {
+        "opcode": "motion_direction", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1188, "y": 21
+    },
+
+    # control_block.json
+    "control_wait": {
+        "opcode": "control_wait", "next": None, "parent": None,
+        "inputs": {"DURATION": [1, [5, "1"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 337, "y": 129
+    },
+    "control_repeat": {
+        "opcode": "control_repeat", "next": None, "parent": None,
+        "inputs": {"TIMES": [1, [6, "10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 348, "y": 265
+    },
+    "control_forever": {
+        "opcode": "control_forever", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 334, "y": 439
+    },
+    "control_if": {
+        "opcode": "control_if", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 331, "y": 597
+    },
+    "control_if_else": {
+        "opcode": "control_if_else", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 335, "y": 779
+    },
+    "control_wait_until": {
+        "opcode": "control_wait_until", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 676, "y": 285
+    },
+    "control_repeat_until": {
+        "opcode": "control_repeat_until", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 692, "y": 381
+    },
+    "control_stop": {
+        "opcode": "control_stop", "next": None, "parent": None,
+        "inputs": {}, "fields": {"STOP_OPTION": ["all", None]}, "shadow": False, "topLevel": True,
+        "x": 708, "y": 545, "mutation": {"tagName": "mutation", "children": [], "hasnext": "false"}
+    },
+    "control_start_as_clone": {
+        "opcode": "control_start_as_clone", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 665, "y": 672
+    },
+    "control_create_clone_of": {
+        "opcode": "control_create_clone_of", "next": None, "parent": None,
+        "inputs": {"CLONE_OPTION": [1, "control_create_clone_of_menu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 648, "y": 797
+    },
+    "control_create_clone_of_menu": {
+        "opcode": "control_create_clone_of_menu", "next": None, "parent": "control_create_clone_of",
+        "inputs": {}, "fields": {"CLONE_OPTION": ["_myself_", None]}, "shadow": True, "topLevel": False
+    },
+    "control_delete_this_clone": {
+        "opcode": "control_delete_this_clone", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 642, "y": 914
+    },
+
+    # data_block.json
+    "data_setvariableto": {
+        "opcode": "data_setvariableto", "next": None, "parent": None,
+        "inputs": {"VALUE": [1, [10, "0"]]}, "fields": {"VARIABLE": ["my variable", "`jEk@4|i[#Fk?(8x)AV.-my variable"]}, "shadow": False, "topLevel": True,
+        "x": 348, "y": 241
+    },
+    "data_changevariableby": {
+        "opcode": "data_changevariableby", "next": None, "parent": None,
+        "inputs": {"VALUE": [1, [4, "1"]]}, "fields": {"VARIABLE": ["my variable", "`jEk@4|i[#Fk?(8x)AV.-my variable"]}, "shadow": False, "topLevel": True,
+        "x": 313, "y": 363
+    },
+    "data_showvariable": {
+        "opcode": "data_showvariable", "next": None, "parent": None,
+        "inputs": {}, "fields": {"VARIABLE": ["my variable", "`jEk@4|i[#Fk?(8x)AV.-my variable"]}, "shadow": False, "topLevel": True,
+        "x": 415, "y": 473
+    },
+    "data_hidevariable": {
+        "opcode": "data_hidevariable", "next": None, "parent": None,
+        "inputs": {}, "fields": {"VARIABLE": ["my variable", "`jEk@4|i[#Fk?(8x)AV.-my variable"]}, "shadow": False, "topLevel": True,
+        "x": 319, "y": 587
+    },
+    "data_addtolist": {
+        "opcode": "data_addtolist", "next": None, "parent": None,
+        "inputs": {"ITEM": [1, [10, "thing"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 385, "y": 109
+    },
+    "data_deleteoflist": {
+        "opcode": "data_deleteoflist", "next": None, "parent": None,
+        "inputs": {"INDEX": [1, [7, "1"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 384, "y": 244
+    },
+    "data_deletealloflist": {
+        "opcode": "data_deletealloflist", "next": None, "parent": None,
+        "inputs": {}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 387, "y": 374
+    },
+    "data_insertatlist": {
+        "opcode": "data_insertatlist", "next": None, "parent": None,
+        "inputs": {"ITEM": [1, [10, "thing"]], "INDEX": [1, [7, "1"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 366, "y": 527
+    },
+    "data_replaceitemoflist": {
+        "opcode": "data_replaceitemoflist", "next": None, "parent": None,
+        "inputs": {"INDEX": [1, [7, "1"]], "ITEM": [1, [10, "thing"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 365, "y": 657
+    },
+    "data_itemoflist": {
+        "opcode": "data_itemoflist", "next": None, "parent": None,
+        "inputs": {"INDEX": [1, [7, "1"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 862, "y": 117
+    },
+    "data_itemnumoflist": {
+        "opcode": "data_itemnumoflist", "next": None, "parent": None,
+        "inputs": {"ITEM": [1, [10, "thing"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 883, "y": 238
+    },
+    "data_lengthoflist": {
+        "opcode": "data_lengthoflist", "next": None, "parent": None,
+        "inputs": {}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 876, "y": 342
+    },
+    "data_listcontainsitem": {
+        "opcode": "data_listcontainsitem", "next": None, "parent": None,
+        "inputs": {"ITEM": [1, [10, "thing"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 871, "y": 463
+    },
+    "data_showlist": {
+        "opcode": "data_showlist", "next": None, "parent": None,
+        "inputs": {}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 931, "y": 563
+    },
+    "data_hidelist": {
+        "opcode": "data_hidelist", "next": None, "parent": None,
+        "inputs": {}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 962, "y": 716
+    },
+
+    # event_block.json
+    "event_whenflagclicked": {
+        "opcode": "event_whenflagclicked", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 166, "y": -422
+    },
+    "event_whenkeypressed": {
+        "opcode": "event_whenkeypressed", "next": None, "parent": None,
+        "inputs": {}, "fields": {"KEY_OPTION": ["space", None]}, "shadow": False, "topLevel": True,
+        "x": 151, "y": -329
+    },
+    "event_whenthisspriteclicked": {
+        "opcode": "event_whenthisspriteclicked", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 156, "y": -223
+    },
+    "event_whenbackdropswitchesto": {
+        "opcode": "event_whenbackdropswitchesto", "next": None, "parent": None,
+        "inputs": {}, "fields": {"BACKDROP": ["backdrop1", None]}, "shadow": False, "topLevel": True,
+        "x": 148, "y": -101
+    },
+    "event_whengreaterthan": {
+        "opcode": "event_whengreaterthan", "next": None, "parent": None,
+        "inputs": {"VALUE": [1, [4, "10"]]}, "fields": {"WHENGREATERTHANMENU": ["LOUDNESS", None]}, "shadow": False, "topLevel": True,
+        "x": 150, "y": 10
+    },
+    "event_whenbroadcastreceived": {
+        "opcode": "event_whenbroadcastreceived", "next": None, "parent": None,
+        "inputs": {}, "fields": {"BROADCAST_OPTION": ["message1", "5O!nei;S$!c!=hCT}0:a"]}, "shadow": False, "topLevel": True,
+        "x": 141, "y": 118
+    },
+    "event_broadcast": {
+        "opcode": "event_broadcast", "next": None, "parent": None,
+        "inputs": {"BROADCAST_INPUT": [1, [11, "message1", "5O!nei;S$!c!=hCT}0:a"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 151, "y": 229
+    },
+    "event_broadcastandwait": {
+        "opcode": "event_broadcastandwait", "next": None, "parent": None,
+        "inputs": {"BROADCAST_INPUT": [1, [11, "message1", "5O!nei;S$!c!=hCT}0:a"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 157, "y": 340
+    },
+
+    # look_block.json
+    "looks_sayforsecs": {
+        "opcode": "looks_sayforsecs", "next": None, "parent": None,
+        "inputs": {"MESSAGE": [1, [10, "Hello!"]], "SECS": [1, [4, "2"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 408, "y": 91
+    },
+    "looks_say": {
+        "opcode": "looks_say", "next": None, "parent": None,
+        "inputs": {"MESSAGE": [1, [10, "Hello!"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 413, "y": 213
+    },
+    "looks_thinkforsecs": {
+        "opcode": "looks_thinkforsecs", "next": None, "parent": None,
+        "inputs": {"MESSAGE": [1, [10, "Hmm..."]], "SECS": [1, [4, "2"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 413, "y": 317
+    },
+    "looks_think": {
+        "opcode": "looks_think", "next": None, "parent": None,
+        "inputs": {"MESSAGE": [1, [10, "Hmm..."]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 412, "y": 432
+    },
+    "looks_switchcostumeto": {
+        "opcode": "looks_switchcostumeto", "next": None, "parent": None,
+        "inputs": {"COSTUME": [1, "8;bti4wv(iH9nkOacCJ|"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 411, "y": 555
+    },
+    "looks_costume": {
+        "opcode": "looks_costume", "next": None, "parent": "Q#a,6LPWHqo9-0Nu*[SV",
+        "inputs": {}, "fields": {"COSTUME": ["costume2", None]}, "shadow": True, "topLevel": False
+    },
+    "looks_nextcostume": {
+        "opcode": "looks_nextcostume", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 419, "y": 687
+    },
+    "looks_switchbackdropto": {
+        "opcode": "looks_switchbackdropto", "next": None, "parent": None,
+        "inputs": {"BACKDROP": [1, "-?yeX}29V*wd6W:unW0i"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 901, "y": 91
+    },
+    "looks_backdrops": {
+        "opcode": "looks_backdrops", "next": None, "parent": "`Wm^p~l[(IWzc1|wNv*.",
+        "inputs": {}, "fields": {"BACKDROP": ["backdrop1", None]}, "shadow": True, "topLevel": False
+    },
+    "looks_changesizeby": {
+        "opcode": "looks_changesizeby", "next": None, "parent": None,
+        "inputs": {"CHANGE": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 895, "y": 192
+    },
+    "looks_setsizeto": {
+        "opcode": "looks_setsizeto", "next": None, "parent": None,
+        "inputs": {"SIZE": [1, [4, "100"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 896, "y": 303
+    },
+    "looks_changeeffectby": {
+        "opcode": "looks_changeeffectby", "next": None, "parent": None,
+        "inputs": {"CHANGE": [1, [4, "25"]]}, "fields": {"EFFECT": ["COLOR", None]}, "shadow": False, "topLevel": True,
+        "x": 892, "y": 416
+    },
+    "looks_seteffectto": {
+        "opcode": "looks_seteffectto", "next": None, "parent": None,
+        "inputs": {"VALUE": [1, [4, "0"]]}, "fields": {"EFFECT": ["COLOR", None]}, "shadow": False, "topLevel": True,
+        "x": 902, "y": 527
+    },
+    "looks_cleargraphiceffects": {
+        "opcode": "looks_cleargraphiceffects", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 902, "y": 638
+    },
+    "looks_show": {
+        "opcode": "looks_show", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 908, "y": 758
+    },
+    "looks_hide": {
+        "opcode": "looks_hide", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 455, "y": 861
+    },
+    "looks_gotofrontback": {
+        "opcode": "looks_gotofrontback", "next": None, "parent": None,
+        "inputs": {}, "fields": {"FRONT_BACK": ["front", None]}, "shadow": False, "topLevel": True,
+        "x": 853, "y": 878
+    },
+    "looks_goforwardbackwardlayers": {
+        "opcode": "looks_goforwardbackwardlayers", "next": None, "parent": None,
+        "inputs": {"NUM": [1, [7, "1"]]}, "fields": {"FORWARD_BACKWARD": ["forward", None]}, "shadow": False, "topLevel": True,
+        "x": 851, "y": 999
+    },
+    "looks_costumenumbername": {
+        "opcode": "looks_costumenumbername", "next": None, "parent": None,
+        "inputs": {}, "fields": {"NUMBER_NAME": ["number", None]}, "shadow": False, "topLevel": True,
+        "x": 458, "y": 1007
+    },
+    "looks_backdropnumbername": {
+        "opcode": "looks_backdropnumbername", "next": None, "parent": None,
+        "inputs": {}, "fields": {"NUMBER_NAME": ["number", None]}, "shadow": False, "topLevel": True,
+        "x": 1242, "y": 753
+    },
+    "looks_size": {
+        "opcode": "looks_size", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1249, "y": 876
+    },
+
+    # operator_block.json
+    "operator_add": {
+        "opcode": "operator_add", "next": None, "parent": None,
+        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 128, "y": 153
+    },
+    "operator_subtract": {
+        "opcode": "operator_subtract", "next": None, "parent": None,
+        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 134, "y": 214
+    },
+    "operator_multiply": {
+        "opcode": "operator_multiply", "next": None, "parent": None,
+        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 134, "y": 278
+    },
+    "operator_divide": {
+        "opcode": "operator_divide", "next": None, "parent": None,
+        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 138, "y": 359
+    },
+    "operator_random": {
+        "opcode": "operator_random", "next": None, "parent": None,
+        "inputs": {"FROM": [1, [4, "1"]], "TO": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 311, "y": 157
+    },
+    "operator_gt": {
+        "opcode": "operator_gt", "next": None, "parent": None,
+        "inputs": {"OPERAND1": [1, [10, ""]], "OPERAND2": [1, [10, "50"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 348, "y": 217
+    },
+    "operator_lt": {
+        "opcode": "operator_lt", "next": None, "parent": None,
+        "inputs": {"OPERAND1": [1, [10, ""]], "OPERAND2": [1, [10, "50"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 345, "y": 286
+    },
+    "operator_equals": {
+        "opcode": "operator_equals", "next": None, "parent": None,
+        "inputs": {"OPERAND1": [1, [10, ""]], "OPERAND2": [1, [10, "50"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 345, "y": 372
+    },
+    "operator_and": {
+        "opcode": "operator_and", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 701, "y": 158
+    },
+    "operator_or": {
+        "opcode": "operator_or", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 705, "y": 222
+    },
+    "operator_not": {
+        "opcode": "operator_not", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 734, "y": 283
+    },
+    "operator_join": {
+        "opcode": "operator_join", "next": None, "parent": None,
+        "inputs": {"STRING1": [1, [10, "apple "]], "STRING2": [1, [10, "banana"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 663, "y": 378
+    },
+    "operator_letter_of": {
+        "opcode": "operator_letter_of", "next": None, "parent": None,
+        "inputs": {"LETTER": [1, [6, "1"]], "STRING": [1, [10, "apple"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 664, "y": 445
+    },
+    "operator_length": {
+        "opcode": "operator_length", "next": None, "parent": None,
+        "inputs": {"STRING": [1, [10, "apple"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 664, "y": 521
+    },
+    "operator_contains": {
+        "opcode": "operator_contains", "next": None, "parent": None,
+        "inputs": {"STRING1": [1, [10, "apple"]], "STRING2": [1, [10, "a"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 634, "y": 599
+    },
+    "operator_mod": {
+        "opcode": "operator_mod", "next": None, "parent": None,
+        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 295, "y": 594
+    },
+    "operator_round": {
+        "opcode": "operator_round", "next": None, "parent": None,
+        "inputs": {"NUM": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 307, "y": 674
+    },
+    "operator_mathop": {
+        "opcode": "operator_mathop", "next": None, "parent": None,
+        "inputs": {"NUM": [1, [4, ""]]}, "fields": {"OPERATOR": ["abs", None]}, "shadow": False, "topLevel": True,
+        "x": 280, "y": 754
+    },
+
+    # sensing_block.json
+    "sensing_touchingobject": {
+        "opcode": "sensing_touchingobject", "next": None, "parent": None,
+        "inputs": {"TOUCHINGOBJECTMENU": [1, "sensing_touchingobjectmenu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 359, "y": 116
+    },
+    "sensing_touchingobjectmenu": {
+        "opcode": "sensing_touchingobjectmenu", "next": None, "parent": "sensing_touchingobject",
+        "inputs": {}, "fields": {"TOUCHINGOBJECTMENU": ["_mouse_", None]}, "shadow": True, "topLevel": False
+    },
+    "sensing_touchingcolor": {
+        "opcode": "sensing_touchingcolor", "next": None, "parent": None,
+        "inputs": {"COLOR": [1, [9, "#55b888"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 360, "y": 188
+    },
+    "sensing_coloristouchingcolor": {
+        "opcode": "sensing_coloristouchingcolor", "next": None, "parent": None,
+        "inputs": {"COLOR": [1, [9, "#d019f2"]], "COLOR2": [1, [9, "#2b0de3"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 348, "y": 277
+    },
+    "sensing_askandwait": {
+        "opcode": "sensing_askandwait", "next": None, "parent": None,
+        "inputs": {"QUESTION": [1, [10, "What's your name?"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 338, "y": 354
+    },
+    "sensing_answer": {
+        "opcode": "sensing_answer", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 782, "y": 111
+    },
+    "sensing_keypressed": {
+        "opcode": "sensing_keypressed", "next": None, "parent": None,
+        "inputs": {"KEY_OPTION": [1, "sensing_keyoptions"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 762, "y": 207
+    },
+    "sensing_keyoptions": {
+        "opcode": "sensing_keyoptions", "next": None, "parent": "sensing_keypressed",
+        "inputs": {}, "fields": {"KEY_OPTION": ["space", None]}, "shadow": True, "topLevel": False
+    },
+    "sensing_mousedown": {
+        "opcode": "sensing_mousedown", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 822, "y": 422
+    },
+    "sensing_mousex": {
+        "opcode": "sensing_mousex", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 302, "y": 528
+    },
+    "sensing_mousey": {
+        "opcode": "sensing_mousey", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 668, "y": 547
+    },
+    "sensing_setdragmode": {
+        "opcode": "sensing_setdragmode", "next": None, "parent": None,
+        "inputs": {}, "fields": {"DRAG_MODE": ["draggable", None]}, "shadow": False, "topLevel": True,
+        "x": 950, "y": 574
+    },
+    "sensing_loudness": {
+        "opcode": "sensing_loudness", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 658, "y": 703
+    },
+    "sensing_timer": {
+        "opcode": "sensing_timer", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 459, "y": 671
+    },
+    "sensing_resettimer": {
+        "opcode": "sensing_resettimer", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 462, "y": 781
+    },
+    "sensing_of": {
+        "opcode": "sensing_of", "next": None, "parent": None,
+        "inputs": {"OBJECT": [1, "sensing_of_object_menu"]}, "fields": {"PROPERTY": ["backdrop #", None]}, "shadow": False, "topLevel": True,
+        "x": 997, "y": 754
+    },
+    "sensing_of_object_menu": {
+        "opcode": "sensing_of_object_menu", "next": None, "parent": "sensing_of",
+        "inputs": {}, "fields": {"OBJECT": ["_stage_", None]}, "shadow": True, "topLevel": False
+    },
+    "sensing_current": {
+        "opcode": "sensing_current", "next": None, "parent": None,
+        "inputs": {}, "fields": {"CURRENTMENU": ["YEAR", None]}, "shadow": False, "topLevel": True,
+        "x": 627, "y": 884
+    },
+    "sensing_dayssince2000": {
+        "opcode": "sensing_dayssince2000", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 959, "y": 903
+    },
+    "sensing_username": {
+        "opcode": "sensing_username", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 833, "y": 757
+    },
+
+    # sound_block.json
+    "sound_playuntildone": {
+        "opcode": "sound_playuntildone", "next": None, "parent": None,
+        "inputs": {"SOUND_MENU": [1, "sound_sounds_menu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 253, "y": 17
+    },
+    "sound_sounds_menu": {
+        "opcode": "sound_sounds_menu", "next": None, "parent": "sound_playuntildone and sound_play",
+        "inputs": {}, "fields": {"SOUND_MENU": ["Meow", None]}, "shadow": True, "topLevel": False
+    },
+    "sound_play": {
+        "opcode": "sound_play", "next": None, "parent": None,
+        "inputs": {"SOUND_MENU": [1, "sound_sounds_menu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 245, "y": 122
+    },
+    "sound_stopallsounds": {
+        "opcode": "sound_stopallsounds", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 253, "y": 245
+    },
+    "sound_changeeffectby": {
+        "opcode": "sound_changeeffectby", "next": None, "parent": None,
+        "inputs": {"VALUE": [1, [4, "10"]]}, "fields": {"EFFECT": ["PITCH", None]}, "shadow": False, "topLevel": True,
+        "x": 653, "y": 14
+    },
+    "sound_seteffectto": {
+        "opcode": "sound_seteffectto", "next": None, "parent": None,
+        "inputs": {"VALUE": [1, [4, "100"]]}, "fields": {"EFFECT": ["PITCH", None]}, "shadow": False, "topLevel": True,
+        "x": 653, "y": 139
+    },
+    "sound_cleareffects": {
+        "opcode": "sound_cleareffects", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 651, "y": 242
+    },
+    "sound_changevolumeby": {
+        "opcode": "sound_changevolumeby", "next": None, "parent": None,
+        "inputs": {"VOLUME": [1, [4, "-10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 645, "y": 353
+    },
+    "sound_setvolumeto": {
+        "opcode": "sound_setvolumeto", "next": None, "parent": None,
+        "inputs": {"VOLUME": [1, [4, "100"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1108, "y": 5
+    },
+    "sound_volume": {
+        "opcode": "sound_volume", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1136, "y": 123
+    },
+}
+
+# #Example input with opcodes from various categories
+# input_opcodes = [
+#     {"opcode": "sound_play", "count": 2},         # New: Sound block with menu
+#     {"opcode": "sound_playuntildone", "count": 2}, # New: Sound block with menu
+# ]
+
+# Example input with opcodes from various categories
+# input_opcodes = [
+#     {"opcode": "sound_play", "count": 2},
+#     {"opcode": "sound_playuntildone", "count": 2},
+#     {"opcode":"motion_goto","count":2},
+#     {"opcode":"motion_glideto","count":2},
+#     {"opcode":"looks_switchbackdropto","count":2},
+#     {"opcode":"looks_switchcostumeto","count":2},
+#     {"opcode":"control_create_clone_of","count":2},
+#     {"opcode":"sensing_touchingobject","count":2},
+#     {"opcode":"sensing_of","count":2},
+#     {"opcode":"sensing_keypressed","count":2},
+#     {"opcode":"motion_pointtowards","count":2},
+# ]
+
+# generated_output = generate_blocks_from_opcodes(input_opcodes, all_block_definitions)
+# print(json.dumps(generated_output, indent=2))
+
+initial_opcode_counts = [
+    {"opcode":"event_whenflagclicked","count":1},
+    {"opcode":"motion_gotoxy","count":1},
+    {"opcode":"motion_glidesecstoxy","count":1},
+    {"opcode":"motion_xposition","count":1},
+    {"opcode":"motion_setx","count":1},
+    {"opcode":"control_forever","count":1},
+    {"opcode":"control_if","count":1},
+    {"opcode":"control_stop","count":1},
+    {"opcode":"operator_lt","count":1},
+    {"opcode":"sensing_istouching","count":1},
+    {"opcode":"sensing_touchingobjectmenu","count":1}, # This will now be generated as a child of sensing_touchingobject
+    {"opcode":"event_broadcast","count":1},
+    {"opcode":"data_setvariableto","count":2},
+    {"opcode":"data_showvariable","count":2},
+]
+
+# Generate the initial blocks and get the opcode_occurrences
+generated_output_json, initial_opcode_occurrences = generate_blocks_from_opcodes(initial_opcode_counts, all_block_definitions)
+
+# Pseudo-code to interpret
+pseudo_code_input = """
+when green flag clicked
+  go to x: (240) y: (-135)
+  set [score v] to +1
+  set [speed v] to +1
+  show variable [score v]
+  show variable [speed v]
+  forever
+    glide (2) seconds to x: (-240) y: (-135)
+    if <((x position)) < (-235)> then
+      set x to (240)
+    end
+    if <touching [Sprite1 v]?> then
+      broadcast [Game Over v]
+      stop [all v]
+    end
+  end
+end
+"""
+
+# Interpret the pseudo-code and update the blocks, passing opcode_occurrences
+final_generated_blocks = interpret_pseudo_code_and_update_blocks(generated_output_json, pseudo_code_input, all_block_definitions, initial_opcode_occurrences)
+
+print(json.dumps(final_generated_blocks, indent=2))

v2/scratch_agent/block_function_v1.py

@@ -0,0 +1,759 @@
+import json
+import copy
+
+import json
+import copy
+
+def generate_blocks_from_opcodes(opcode_counts, all_block_definitions):
+    """
+    Generates a dictionary of Scratch-like blocks based on a list of opcodes and a reference block definition.
+    It now correctly links parent and menu blocks using their generated unique keys, and handles various block categories.
+    It ensures that menu blocks are only generated as children of their respective parent blocks.
+
+    Args:
+        opcode_counts (list): An array of objects, each with an 'opcode' and 'count' property.
+                              Example: [{"opcode": "motion_gotoxy", "count": 1}]
+        all_block_definitions (dict): A comprehensive dictionary containing definitions for all block types.
+
+    Returns:
+        dict: A JSON object where keys are generated block IDs and values are the block definitions.
+    """
+    generated_blocks = {}
+    opcode_occurrences = {}  # To keep track of how many times each opcode (main or menu) has been used for unique keys
+
+    # Define explicit parent-menu relationships for linking purposes
+    # This maps main_opcode -> list of (input_field_name, menu_opcode)
+    explicit_menu_links = {
+        "motion_goto": [("TO", "motion_goto_menu")],
+        "motion_glideto": [("TO", "motion_glideto_menu")],
+        "motion_pointtowards": [("TOWARDS", "motion_pointtowards_menu")],
+        "sensing_keypressed": [("KEY_OPTION", "sensing_keyoptions")],
+        "sensing_of": [("OBJECT", "sensing_of_object_menu")],
+        "sensing_touchingobject": [("TOUCHINGOBJECTMENU", "sensing_touchingobjectmenu")],
+        "control_create_clone_of": [("CLONE_OPTION", "control_create_clone_of_menu")],
+        "sound_play": [("SOUND_MENU", "sound_sounds_menu")],
+        "sound_playuntildone": [("SOUND_MENU", "sound_sounds_menu")],
+        "looks_switchcostumeto": [("COSTUME", "looks_costume")],
+        "looks_switchbackdropto": [("BACKDROP", "looks_backdrops")],
+    }
+
+    # --- Step 1: Process explicitly requested opcodes and generate their instances and associated menus ---
+    for item in opcode_counts:
+        opcode = item.get("opcode")
+        count = item.get("count", 1)
+
+        if not opcode:
+            print("Warning: Skipping item with missing 'opcode'.")
+            continue
+
+        if opcode not in all_block_definitions:
+            print(f"Warning: Opcode '{opcode}' not found in all_block_definitions. Skipping.")
+            continue
+
+        for _ in range(count):
+            # Increment occurrence count for the current main opcode
+            opcode_occurrences[opcode] = opcode_occurrences.get(opcode, 0) + 1
+            main_block_instance_num = opcode_occurrences[opcode]
+            
+            main_block_unique_key = f"{opcode}_{main_block_instance_num}"
+            
+            # Create a deep copy of the main block definition
+            main_block_data = copy.deepcopy(all_block_definitions[opcode])
+            
+            # Set properties for a top-level main block
+            main_block_data["parent"] = None
+            main_block_data["next"] = None
+            main_block_data["topLevel"] = True
+            main_block_data["shadow"] = False # Main blocks are typically not shadows
+
+            generated_blocks[main_block_unique_key] = main_block_data
+
+            # If this main block has associated menus, generate and link them now
+            if opcode in explicit_menu_links:
+                for input_field_name, menu_opcode_type in explicit_menu_links[opcode]:
+                    if menu_opcode_type in all_block_definitions:
+                        # Increment the occurrence for the menu block type
+                        opcode_occurrences[menu_opcode_type] = opcode_occurrences.get(menu_opcode_type, 0) + 1
+                        menu_block_instance_num = opcode_occurrences[menu_opcode_type]
+
+                        menu_block_data = copy.deepcopy(all_block_definitions[menu_opcode_type])
+                        
+                        # Generate a unique key for this specific menu instance
+                        menu_unique_key = f"{menu_opcode_type}_{menu_block_instance_num}"
+                        
+                        # Set properties for a shadow menu block
+                        menu_block_data["shadow"] = True
+                        menu_block_data["topLevel"] = False
+                        menu_block_data["next"] = None
+                        menu_block_data["parent"] = main_block_unique_key # Link menu to its parent instance
+
+                        # Update the main block's input to point to this unique menu instance
+                        if input_field_name in main_block_data.get("inputs", {}) and \
+                           isinstance(main_block_data["inputs"][input_field_name], list) and \
+                           len(main_block_data["inputs"][input_field_name]) > 1 and \
+                           main_block_data["inputs"][input_field_name][0] == 1:
+                            
+                            main_block_data["inputs"][input_field_name][1] = menu_unique_key
+                        
+                        generated_blocks[menu_unique_key] = menu_block_data
+            
+    return generated_blocks
+
+
+# --- Consolidated Block Definitions from all provided JSONs ---
+all_block_definitions = {
+    # motion_block.json
+    "motion_movesteps": {
+        "opcode": "motion_movesteps", "next": None, "parent": None,
+        "inputs": {"STEPS": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 464, "y": -416
+    },
+    "motion_turnright": {
+        "opcode": "motion_turnright", "next": None, "parent": None,
+        "inputs": {"DEGREES": [1, [4, "15"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 467, "y": -316
+    },
+    "motion_turnleft": {
+        "opcode": "motion_turnleft", "next": None, "parent": None,
+        "inputs": {"DEGREES": [1, [4, "15"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 464, "y": -210
+    },
+    "motion_goto": {
+        "opcode": "motion_goto", "next": None, "parent": None,
+        "inputs": {"TO": [1, "motion_goto_menu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 465, "y": -95
+    },
+    "motion_goto_menu": {
+        "opcode": "motion_goto_menu", "next": None, "parent": "motion_goto",
+        "inputs": {}, "fields": {"TO": ["_random_", None]}, "shadow": True, "topLevel": False
+    },
+    "motion_gotoxy": {
+        "opcode": "motion_gotoxy", "next": None, "parent": None,
+        "inputs": {"X": [1, [4, "0"]], "Y": [1, [4, "0"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 468, "y": 12
+    },
+    "motion_glideto": {
+        "opcode": "motion_glideto", "next": None, "parent": None,
+        "inputs": {"SECS": [1, [4, "1"]], "TO": [1, "motion_glideto_menu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 470, "y": 129
+    },
+    "motion_glideto_menu": {
+        "opcode": "motion_glideto_menu", "next": None, "parent": "motion_glideto",
+        "inputs": {}, "fields": {"TO": ["_random_", None]}, "shadow": True, "topLevel": False
+    },
+    "motion_glidesecstoxy": {
+        "opcode": "motion_glidesecstoxy", "next": None, "parent": None,
+        "inputs": {"SECS": [1, [4, "1"]], "X": [1, [4, "0"]], "Y": [1, [4, "0"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 476, "y": 239
+    },
+    "motion_pointindirection": {
+        "opcode": "motion_pointindirection", "next": None, "parent": None,
+        "inputs": {"DIRECTION": [1, [8, "90"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 493, "y": 361
+    },
+    "motion_pointtowards": {
+        "opcode": "motion_pointtowards", "next": None, "parent": None,
+        "inputs": {"TOWARDS": [1, "motion_pointtowards_menu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 492, "y": 463
+    },
+    "motion_pointtowards_menu": {
+        "opcode": "motion_pointtowards_menu", "next": None, "parent": "motion_pointtowards",
+        "inputs": {}, "fields": {"TOWARDS": ["_mouse_", None]}, "shadow": True, "topLevel": False
+    },
+    "motion_changexby": {
+        "opcode": "motion_changexby", "next": None, "parent": None,
+        "inputs": {"DX": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 851, "y": -409
+    },
+    "motion_setx": {
+        "opcode": "motion_setx", "next": None, "parent": None,
+        "inputs": {"X": [1, [4, "0"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 864, "y": -194
+    },
+    "motion_changeyby": {
+        "opcode": "motion_changeyby", "next": None, "parent": None,
+        "inputs": {"DY": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 861, "y": -61
+    },
+    "motion_sety": {
+        "opcode": "motion_sety", "next": None, "parent": None,
+        "inputs": {"Y": [1, [4, "0"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 864, "y": 66
+    },
+    "motion_ifonedgebounce": {
+        "opcode": "motion_ifonedgebounce", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1131, "y": -397
+    },
+    "motion_setrotationstyle": {
+        "opcode": "motion_setrotationstyle", "next": None, "parent": None,
+        "inputs": {}, "fields": {"STYLE": ["left-right", None]}, "shadow": False, "topLevel": True,
+        "x": 1128, "y": -287
+    },
+    "motion_xposition": {
+        "opcode": "motion_xposition", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1193, "y": -136
+    },
+    "motion_yposition": {
+        "opcode": "motion_yposition", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1181, "y": -64
+    },
+    "motion_direction": {
+        "opcode": "motion_direction", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1188, "y": 21
+    },
+
+    # control_block.json
+    "control_wait": {
+        "opcode": "control_wait", "next": None, "parent": None,
+        "inputs": {"DURATION": [1, [5, "1"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 337, "y": 129
+    },
+    "control_repeat": {
+        "opcode": "control_repeat", "next": None, "parent": None,
+        "inputs": {"TIMES": [1, [6, "10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 348, "y": 265
+    },
+    "control_forever": {
+        "opcode": "control_forever", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 334, "y": 439
+    },
+    "control_if": {
+        "opcode": "control_if", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 331, "y": 597
+    },
+    "control_if_else": {
+        "opcode": "control_if_else", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 335, "y": 779
+    },
+    "control_wait_until": {
+        "opcode": "control_wait_until", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 676, "y": 285
+    },
+    "control_repeat_until": {
+        "opcode": "control_repeat_until", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 692, "y": 381
+    },
+    "control_stop": {
+        "opcode": "control_stop", "next": None, "parent": None,
+        "inputs": {}, "fields": {"STOP_OPTION": ["all", None]}, "shadow": False, "topLevel": True,
+        "x": 708, "y": 545, "mutation": {"tagName": "mutation", "children": [], "hasnext": "false"}
+    },
+    "control_start_as_clone": {
+        "opcode": "control_start_as_clone", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 665, "y": 672
+    },
+    "control_create_clone_of": {
+        "opcode": "control_create_clone_of", "next": None, "parent": None,
+        "inputs": {"CLONE_OPTION": [1, "control_create_clone_of_menu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 648, "y": 797
+    },
+    "control_create_clone_of_menu": {
+        "opcode": "control_create_clone_of_menu", "next": None, "parent": "control_create_clone_of",
+        "inputs": {}, "fields": {"CLONE_OPTION": ["_myself_", None]}, "shadow": True, "topLevel": False
+    },
+    "control_delete_this_clone": {
+        "opcode": "control_delete_this_clone", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 642, "y": 914
+    },
+
+    # data_block.json
+    "data_setvariableto": {
+        "opcode": "data_setvariableto", "next": None, "parent": None,
+        "inputs": {"VALUE": [1, [10, "0"]]}, "fields": {"VARIABLE": ["my variable", "`jEk@4|i[#Fk?(8x)AV.-my variable"]}, "shadow": False, "topLevel": True,
+        "x": 348, "y": 241
+    },
+    "data_changevariableby": {
+        "opcode": "data_changevariableby", "next": None, "parent": None,
+        "inputs": {"VALUE": [1, [4, "1"]]}, "fields": {"VARIABLE": ["my variable", "`jEk@4|i[#Fk?(8x)AV.-my variable"]}, "shadow": False, "topLevel": True,
+        "x": 313, "y": 363
+    },
+    "data_showvariable": {
+        "opcode": "data_showvariable", "next": None, "parent": None,
+        "inputs": {}, "fields": {"VARIABLE": ["my variable", "`jEk@4|i[#Fk?(8x)AV.-my variable"]}, "shadow": False, "topLevel": True,
+        "x": 415, "y": 473
+    },
+    "data_hidevariable": {
+        "opcode": "data_hidevariable", "next": None, "parent": None,
+        "inputs": {}, "fields": {"VARIABLE": ["my variable", "`jEk@4|i[#Fk?(8x)AV.-my variable"]}, "shadow": False, "topLevel": True,
+        "x": 319, "y": 587
+    },
+    "data_addtolist": {
+        "opcode": "data_addtolist", "next": None, "parent": None,
+        "inputs": {"ITEM": [1, [10, "thing"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 385, "y": 109
+    },
+    "data_deleteoflist": {
+        "opcode": "data_deleteoflist", "next": None, "parent": None,
+        "inputs": {"INDEX": [1, [7, "1"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 384, "y": 244
+    },
+    "data_deletealloflist": {
+        "opcode": "data_deletealloflist", "next": None, "parent": None,
+        "inputs": {}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 387, "y": 374
+    },
+    "data_insertatlist": {
+        "opcode": "data_insertatlist", "next": None, "parent": None,
+        "inputs": {"ITEM": [1, [10, "thing"]], "INDEX": [1, [7, "1"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 366, "y": 527
+    },
+    "data_replaceitemoflist": {
+        "opcode": "data_replaceitemoflist", "next": None, "parent": None,
+        "inputs": {"INDEX": [1, [7, "1"]], "ITEM": [1, [10, "thing"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 365, "y": 657
+    },
+    "data_itemoflist": {
+        "opcode": "data_itemoflist", "next": None, "parent": None,
+        "inputs": {"INDEX": [1, [7, "1"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 862, "y": 117
+    },
+    "data_itemnumoflist": {
+        "opcode": "data_itemnumoflist", "next": None, "parent": None,
+        "inputs": {"ITEM": [1, [10, "thing"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 883, "y": 238
+    },
+    "data_lengthoflist": {
+        "opcode": "data_lengthoflist", "next": None, "parent": None,
+        "inputs": {}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 876, "y": 342
+    },
+    "data_listcontainsitem": {
+        "opcode": "data_listcontainsitem", "next": None, "parent": None,
+        "inputs": {"ITEM": [1, [10, "thing"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 871, "y": 463
+    },
+    "data_showlist": {
+        "opcode": "data_showlist", "next": None, "parent": None,
+        "inputs": {}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 931, "y": 563
+    },
+    "data_hidelist": {
+        "opcode": "data_hidelist", "next": None, "parent": None,
+        "inputs": {}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True,
+        "x": 962, "y": 716
+    },
+
+    # event_block.json
+    "event_whenflagclicked": {
+        "opcode": "event_whenflagclicked", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 166, "y": -422
+    },
+    "event_whenkeypressed": {
+        "opcode": "event_whenkeypressed", "next": None, "parent": None,
+        "inputs": {}, "fields": {"KEY_OPTION": ["space", None]}, "shadow": False, "topLevel": True,
+        "x": 151, "y": -329
+    },
+    "event_whenthisspriteclicked": {
+        "opcode": "event_whenthisspriteclicked", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 156, "y": -223
+    },
+    "event_whenbackdropswitchesto": {
+        "opcode": "event_whenbackdropswitchesto", "next": None, "parent": None,
+        "inputs": {}, "fields": {"BACKDROP": ["backdrop1", None]}, "shadow": False, "topLevel": True,
+        "x": 148, "y": -101
+    },
+    "event_whengreaterthan": {
+        "opcode": "event_whengreaterthan", "next": None, "parent": None,
+        "inputs": {"VALUE": [1, [4, "10"]]}, "fields": {"WHENGREATERTHANMENU": ["LOUDNESS", None]}, "shadow": False, "topLevel": True,
+        "x": 150, "y": 10
+    },
+    "event_whenbroadcastreceived": {
+        "opcode": "event_whenbroadcastreceived", "next": None, "parent": None,
+        "inputs": {}, "fields": {"BROADCAST_OPTION": ["message1", "5O!nei;S$!c!=hCT}0:a"]}, "shadow": False, "topLevel": True,
+        "x": 141, "y": 118
+    },
+    "event_broadcast": {
+        "opcode": "event_broadcast", "next": None, "parent": None,
+        "inputs": {"BROADCAST_INPUT": [1, [11, "message1", "5O!nei;S$!c!=hCT}0:a"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 151, "y": 229
+    },
+    "event_broadcastandwait": {
+        "opcode": "event_broadcastandwait", "next": None, "parent": None,
+        "inputs": {"BROADCAST_INPUT": [1, [11, "message1", "5O!nei;S$!c!=hCT}0:a"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 157, "y": 340
+    },
+
+    # look_block.json
+    "looks_sayforsecs": {
+        "opcode": "looks_sayforsecs", "next": None, "parent": None,
+        "inputs": {"MESSAGE": [1, [10, "Hello!"]], "SECS": [1, [4, "2"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 408, "y": 91
+    },
+    "looks_say": {
+        "opcode": "looks_say", "next": None, "parent": None,
+        "inputs": {"MESSAGE": [1, [10, "Hello!"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 413, "y": 213
+    },
+    "looks_thinkforsecs": {
+        "opcode": "looks_thinkforsecs", "next": None, "parent": None,
+        "inputs": {"MESSAGE": [1, [10, "Hmm..."]], "SECS": [1, [4, "2"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 413, "y": 317
+    },
+    "looks_think": {
+        "opcode": "looks_think", "next": None, "parent": None,
+        "inputs": {"MESSAGE": [1, [10, "Hmm..."]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 412, "y": 432
+    },
+    "looks_switchcostumeto": {
+        "opcode": "looks_switchcostumeto", "next": None, "parent": None,
+        "inputs": {"COSTUME": [1, "8;bti4wv(iH9nkOacCJ|"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 411, "y": 555
+    },
+    "looks_costume": {
+        "opcode": "looks_costume", "next": None, "parent": "Q#a,6LPWHqo9-0Nu*[SV",
+        "inputs": {}, "fields": {"COSTUME": ["costume2", None]}, "shadow": True, "topLevel": False
+    },
+    "looks_nextcostume": {
+        "opcode": "looks_nextcostume", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 419, "y": 687
+    },
+    "looks_switchbackdropto": {
+        "opcode": "looks_switchbackdropto", "next": None, "parent": None,
+        "inputs": {"BACKDROP": [1, "-?yeX}29V*wd6W:unW0i"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 901, "y": 91
+    },
+    "looks_backdrops": {
+        "opcode": "looks_backdrops", "next": None, "parent": "`Wm^p~l[(IWzc1|wNv*.",
+        "inputs": {}, "fields": {"BACKDROP": ["backdrop1", None]}, "shadow": True, "topLevel": False
+    },
+    "looks_changesizeby": {
+        "opcode": "looks_changesizeby", "next": None, "parent": None,
+        "inputs": {"CHANGE": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 895, "y": 192
+    },
+    "looks_setsizeto": {
+        "opcode": "looks_setsizeto", "next": None, "parent": None,
+        "inputs": {"SIZE": [1, [4, "100"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 896, "y": 303
+    },
+    "looks_changeeffectby": {
+        "opcode": "looks_changeeffectby", "next": None, "parent": None,
+        "inputs": {"CHANGE": [1, [4, "25"]]}, "fields": {"EFFECT": ["COLOR", None]}, "shadow": False, "topLevel": True,
+        "x": 892, "y": 416
+    },
+    "looks_seteffectto": {
+        "opcode": "looks_seteffectto", "next": None, "parent": None,
+        "inputs": {"VALUE": [1, [4, "0"]]}, "fields": {"EFFECT": ["COLOR", None]}, "shadow": False, "topLevel": True,
+        "x": 902, "y": 527
+    },
+    "looks_cleargraphiceffects": {
+        "opcode": "looks_cleargraphiceffects", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 902, "y": 638
+    },
+    "looks_show": {
+        "opcode": "looks_show", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 908, "y": 758
+    },
+    "looks_hide": {
+        "opcode": "looks_hide", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 455, "y": 861
+    },
+    "looks_gotofrontback": {
+        "opcode": "looks_gotofrontback", "next": None, "parent": None,
+        "inputs": {}, "fields": {"FRONT_BACK": ["front", None]}, "shadow": False, "topLevel": True,
+        "x": 853, "y": 878
+    },
+    "looks_goforwardbackwardlayers": {
+        "opcode": "looks_goforwardbackwardlayers", "next": None, "parent": None,
+        "inputs": {"NUM": [1, [7, "1"]]}, "fields": {"FORWARD_BACKWARD": ["forward", None]}, "shadow": False, "topLevel": True,
+        "x": 851, "y": 999
+    },
+    "looks_costumenumbername": {
+        "opcode": "looks_costumenumbername", "next": None, "parent": None,
+        "inputs": {}, "fields": {"NUMBER_NAME": ["number", None]}, "shadow": False, "topLevel": True,
+        "x": 458, "y": 1007
+    },
+    "looks_backdropnumbername": {
+        "opcode": "looks_backdropnumbername", "next": None, "parent": None,
+        "inputs": {}, "fields": {"NUMBER_NAME": ["number", None]}, "shadow": False, "topLevel": True,
+        "x": 1242, "y": 753
+    },
+    "looks_size": {
+        "opcode": "looks_size", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1249, "y": 876
+    },
+
+    # operator_block.json
+    "operator_add": {
+        "opcode": "operator_add", "next": None, "parent": None,
+        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 128, "y": 153
+    },
+    "operator_subtract": {
+        "opcode": "operator_subtract", "next": None, "parent": None,
+        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 134, "y": 214
+    },
+    "operator_multiply": {
+        "opcode": "operator_multiply", "next": None, "parent": None,
+        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 134, "y": 278
+    },
+    "operator_divide": {
+        "opcode": "operator_divide", "next": None, "parent": None,
+        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 138, "y": 359
+    },
+    "operator_random": {
+        "opcode": "operator_random", "next": None, "parent": None,
+        "inputs": {"FROM": [1, [4, "1"]], "TO": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 311, "y": 157
+    },
+    "operator_gt": {
+        "opcode": "operator_gt", "next": None, "parent": None,
+        "inputs": {"OPERAND1": [1, [10, ""]], "OPERAND2": [1, [10, "50"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 348, "y": 217
+    },
+    "operator_lt": {
+        "opcode": "operator_lt", "next": None, "parent": None,
+        "inputs": {"OPERAND1": [1, [10, ""]], "OPERAND2": [1, [10, "50"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 345, "y": 286
+    },
+    "operator_equals": {
+        "opcode": "operator_equals", "next": None, "parent": None,
+        "inputs": {"OPERAND1": [1, [10, ""]], "OPERAND2": [1, [10, "50"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 345, "y": 372
+    },
+    "operator_and": {
+        "opcode": "operator_and", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 701, "y": 158
+    },
+    "operator_or": {
+        "opcode": "operator_or", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 705, "y": 222
+    },
+    "operator_not": {
+        "opcode": "operator_not", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 734, "y": 283
+    },
+    "operator_join": {
+        "opcode": "operator_join", "next": None, "parent": None,
+        "inputs": {"STRING1": [1, [10, "apple "]], "STRING2": [1, [10, "banana"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 663, "y": 378
+    },
+    "operator_letter_of": {
+        "opcode": "operator_letter_of", "next": None, "parent": None,
+        "inputs": {"LETTER": [1, [6, "1"]], "STRING": [1, [10, "apple"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 664, "y": 445
+    },
+    "operator_length": {
+        "opcode": "operator_length", "next": None, "parent": None,
+        "inputs": {"STRING": [1, [10, "apple"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 664, "y": 521
+    },
+    "operator_contains": {
+        "opcode": "operator_contains", "next": None, "parent": None,
+        "inputs": {"STRING1": [1, [10, "apple"]], "STRING2": [1, [10, "a"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 634, "y": 599
+    },
+    "operator_mod": {
+        "opcode": "operator_mod", "next": None, "parent": None,
+        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 295, "y": 594
+    },
+    "operator_round": {
+        "opcode": "operator_round", "next": None, "parent": None,
+        "inputs": {"NUM": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 307, "y": 674
+    },
+    "operator_mathop": {
+        "opcode": "operator_mathop", "next": None, "parent": None,
+        "inputs": {"NUM": [1, [4, ""]]}, "fields": {"OPERATOR": ["abs", None]}, "shadow": False, "topLevel": True,
+        "x": 280, "y": 754
+    },
+
+    # sensing_block.json
+    "sensing_touchingobject": {
+        "opcode": "sensing_touchingobject", "next": None, "parent": None,
+        "inputs": {"TOUCHINGOBJECTMENU": [1, "sensing_touchingobjectmenu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 359, "y": 116
+    },
+    "sensing_touchingobjectmenu": {
+        "opcode": "sensing_touchingobjectmenu", "next": None, "parent": "sensing_touchingobject",
+        "inputs": {}, "fields": {"TOUCHINGOBJECTMENU": ["_mouse_", None]}, "shadow": True, "topLevel": False
+    },
+    "sensing_touchingcolor": {
+        "opcode": "sensing_touchingcolor", "next": None, "parent": None,
+        "inputs": {"COLOR": [1, [9, "#55b888"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 360, "y": 188
+    },
+    "sensing_coloristouchingcolor": {
+        "opcode": "sensing_coloristouchingcolor", "next": None, "parent": None,
+        "inputs": {"COLOR": [1, [9, "#d019f2"]], "COLOR2": [1, [9, "#2b0de3"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 348, "y": 277
+    },
+    "sensing_askandwait": {
+        "opcode": "sensing_askandwait", "next": None, "parent": None,
+        "inputs": {"QUESTION": [1, [10, "What's your name?"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 338, "y": 354
+    },
+    "sensing_answer": {
+        "opcode": "sensing_answer", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 782, "y": 111
+    },
+    "sensing_keypressed": {
+        "opcode": "sensing_keypressed", "next": None, "parent": None,
+        "inputs": {"KEY_OPTION": [1, "sensing_keyoptions"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 762, "y": 207
+    },
+    "sensing_keyoptions": {
+        "opcode": "sensing_keyoptions", "next": None, "parent": "sensing_keypressed",
+        "inputs": {}, "fields": {"KEY_OPTION": ["space", None]}, "shadow": True, "topLevel": False
+    },
+    "sensing_mousedown": {
+        "opcode": "sensing_mousedown", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 822, "y": 422
+    },
+    "sensing_mousex": {
+        "opcode": "sensing_mousex", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 302, "y": 528
+    },
+    "sensing_mousey": {
+        "opcode": "sensing_mousey", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 668, "y": 547
+    },
+    "sensing_setdragmode": {
+        "opcode": "sensing_setdragmode", "next": None, "parent": None,
+        "inputs": {}, "fields": {"DRAG_MODE": ["draggable", None]}, "shadow": False, "topLevel": True,
+        "x": 950, "y": 574
+    },
+    "sensing_loudness": {
+        "opcode": "sensing_loudness", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 658, "y": 703
+    },
+    "sensing_timer": {
+        "opcode": "sensing_timer", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 459, "y": 671
+    },
+    "sensing_resettimer": {
+        "opcode": "sensing_resettimer", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 462, "y": 781
+    },
+    "sensing_of": {
+        "opcode": "sensing_of", "next": None, "parent": None,
+        "inputs": {"OBJECT": [1, "sensing_of_object_menu"]}, "fields": {"PROPERTY": ["backdrop #", None]}, "shadow": False, "topLevel": True,
+        "x": 997, "y": 754
+    },
+    "sensing_of_object_menu": {
+        "opcode": "sensing_of_object_menu", "next": None, "parent": "sensing_of",
+        "inputs": {}, "fields": {"OBJECT": ["_stage_", None]}, "shadow": True, "topLevel": False
+    },
+    "sensing_current": {
+        "opcode": "sensing_current", "next": None, "parent": None,
+        "inputs": {}, "fields": {"CURRENTMENU": ["YEAR", None]}, "shadow": False, "topLevel": True,
+        "x": 627, "y": 884
+    },
+    "sensing_dayssince2000": {
+        "opcode": "sensing_dayssince2000", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 959, "y": 903
+    },
+    "sensing_username": {
+        "opcode": "sensing_username", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 833, "y": 757
+    },
+
+    # sound_block.json
+    "sound_playuntildone": {
+        "opcode": "sound_playuntildone", "next": None, "parent": None,
+        "inputs": {"SOUND_MENU": [1, "sound_sounds_menu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 253, "y": 17
+    },
+    "sound_sounds_menu": {
+        "opcode": "sound_sounds_menu", "next": None, "parent": "sound_playuntildone and sound_play",
+        "inputs": {}, "fields": {"SOUND_MENU": ["Meow", None]}, "shadow": True, "topLevel": False
+    },
+    "sound_play": {
+        "opcode": "sound_play", "next": None, "parent": None,
+        "inputs": {"SOUND_MENU": [1, "sound_sounds_menu"]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 245, "y": 122
+    },
+    "sound_stopallsounds": {
+        "opcode": "sound_stopallsounds", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 253, "y": 245
+    },
+    "sound_changeeffectby": {
+        "opcode": "sound_changeeffectby", "next": None, "parent": None,
+        "inputs": {"VALUE": [1, [4, "10"]]}, "fields": {"EFFECT": ["PITCH", None]}, "shadow": False, "topLevel": True,
+        "x": 653, "y": 14
+    },
+    "sound_seteffectto": {
+        "opcode": "sound_seteffectto", "next": None, "parent": None,
+        "inputs": {"VALUE": [1, [4, "100"]]}, "fields": {"EFFECT": ["PITCH", None]}, "shadow": False, "topLevel": True,
+        "x": 653, "y": 139
+    },
+    "sound_cleareffects": {
+        "opcode": "sound_cleareffects", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 651, "y": 242
+    },
+    "sound_changevolumeby": {
+        "opcode": "sound_changevolumeby", "next": None, "parent": None,
+        "inputs": {"VOLUME": [1, [4, "-10"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 645, "y": 353
+    },
+    "sound_setvolumeto": {
+        "opcode": "sound_setvolumeto", "next": None, "parent": None,
+        "inputs": {"VOLUME": [1, [4, "100"]]}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1108, "y": 5
+    },
+    "sound_volume": {
+        "opcode": "sound_volume", "next": None, "parent": None,
+        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True,
+        "x": 1136, "y": 123
+    },
+}
+
+# #Example input with opcodes from various categories
+# input_opcodes = [
+#     {"opcode": "sound_play", "count": 2},         # New: Sound block with menu
+#     {"opcode": "sound_playuntildone", "count": 2}, # New: Sound block with menu
+# ]
+
+# Example input with opcodes from various categories
+input_opcodes = [
+    {"opcode": "sound_play", "count": 2},
+    {"opcode": "sound_playuntildone", "count": 2},
+    {"opcode":"motion_goto","count":2},
+    {"opcode":"motion_glideto","count":2},
+    {"opcode":"looks_switchbackdropto","count":2},
+    {"opcode":"looks_switchcostumeto","count":2},
+    {"opcode":"control_create_clone_of","count":2},
+    {"opcode":"sensing_touchingobject","count":2},
+    {"opcode":"sensing_of","count":2},
+    {"opcode":"sensing_keypressed","count":2},
+    {"opcode":"motion_pointtowards","count":2},
+]
+
+generated_output = generate_blocks_from_opcodes(input_opcodes, all_block_definitions)
+print(json.dumps(generated_output, indent=2))

v2/scratch_agent/blocks.zip

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:28e1cf98ef07d0563762f629b4cf7300384743d7ae2733a11b4646d362a27571
+size 41036

v2/scratch_agent/blocks/blocks.json

@@ -0,0 +1,2221 @@
+{
+    "motion_movesteps": {
+        "opcode": "motion_movesteps",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STEPS": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 464,
+        "y": -416
+    },
+    "motion_turnright": {
+        "opcode": "motion_turnright",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DEGREES": [
+                1,
+                [
+                    4,
+                    "15"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 467,
+        "y": -316
+    },
+    "motion_turnleft": {
+        "opcode": "motion_turnleft",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DEGREES": [
+                1,
+                [
+                    4,
+                    "15"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 464,
+        "y": -210
+    },
+    "motion_goto": {
+        "opcode": "motion_goto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TO": [
+                1,
+                "@iM=Z?~GCbpC}gT7KAKY"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 465,
+        "y": -95
+    },
+    "motion_goto_menu": {
+        "opcode": "motion_goto_menu",
+        "next": null,
+        "parent": "d|J?C902/xy6tD5,|dmB",
+        "inputs": {},
+        "fields": {
+            "TO": [
+                "_random_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "motion_gotoxy": {
+        "opcode": "motion_gotoxy",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "X": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ],
+            "Y": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 468,
+        "y": 12
+    },
+    "motion_glideto": {
+        "opcode": "motion_glideto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SECS": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ],
+            "TO": [
+                1,
+                "{id to destination position}"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 470,
+        "y": 129
+    },
+    "motion_glideto_menu": {
+        "opcode": "motion_glideto_menu",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "TO": [
+                "_random_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "motion_glidesecstoxy": {
+        "opcode": "motion_glidesecstoxy",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SECS": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ],
+            "X": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ],
+            "Y": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 476,
+        "y": 239
+    },
+    "motion_pointindirection": {
+        "opcode": "motion_pointindirection",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DIRECTION": [
+                1,
+                [
+                    8,
+                    "90"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 493,
+        "y": 361
+    },
+    "motion_pointtowards": {
+        "opcode": "motion_pointtowards",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TOWARDS": [
+                1,
+                "6xQl1pPk%9E~Znhm*:ng"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 492,
+        "y": 463
+    },
+    "motion_pointtowards_menu": {
+        "opcode": "motion_pointtowards_menu",
+        "next": null,
+        "parent": "Ucm$YBs*^9GFTGXCbal@",
+        "inputs": {},
+        "fields": {
+            "TOWARDS": [
+                "_mouse_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "motion_changexby": {
+        "opcode": "motion_changexby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DX": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 851,
+        "y": -409
+    },
+    "motion_setx": {
+        "opcode": "motion_setx",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "X": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 864,
+        "y": -194
+    },
+    "motion_changeyby": {
+        "opcode": "motion_changeyby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DY": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 861,
+        "y": -61
+    },
+    "motion_sety": {
+        "opcode": "motion_sety",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "Y": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 864,
+        "y": 66
+    },
+    "motion_ifonedgebounce": {
+        "opcode": "motion_ifonedgebounce",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1131,
+        "y": -397
+    },
+    "motion_setrotationstyle": {
+        "opcode": "motion_setrotationstyle",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "STYLE": [
+                "left-right",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 1128,
+        "y": -287
+    },
+    "motion_xposition": {
+        "opcode": "motion_xposition",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1193,
+        "y": -136
+    },
+    "motion_yposition": {
+        "opcode": "motion_yposition",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1181,
+        "y": -64
+    },
+    "motion_direction": {
+        "opcode": "motion_direction",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1188,
+        "y": 21
+    },
+    "control_wait": {
+        "opcode": "control_wait",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DURATION": [
+                1,
+                [
+                    5,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 337,
+        "y": 129
+    },
+    "control_repeat": {
+        "opcode": "control_repeat",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TIMES": [
+                1,
+                [
+                    6,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 265
+    },
+    "control_forever": {
+        "opcode": "control_forever",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 334,
+        "y": 439
+    },
+    "control_if": {
+        "opcode": "control_if",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 331,
+        "y": 597
+    },
+    "control_if_else": {
+        "opcode": "control_if_else",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 335,
+        "y": 779
+    },
+    "control_wait_until": {
+        "opcode": "control_wait_until",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 676,
+        "y": 285
+    },
+    "control_repeat_until": {
+        "opcode": "control_repeat_until",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 692,
+        "y": 381
+    },
+    "control_stop": {
+        "opcode": "control_stop",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "STOP_OPTION": [
+                "all",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 708,
+        "y": 545,
+        "mutation": {
+            "tagName": "mutation",
+            "children": [],
+            "hasnext": "false"
+        }
+    },
+    "control_start_as_clone": {
+        "opcode": "control_start_as_clone",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 665,
+        "y": 672
+    },
+    "control_create_clone_of": {
+        "opcode": "control_create_clone_of",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "CLONE_OPTION": [
+                1,
+                "t))DW9(QSKB]3C/3Ou+J"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 648,
+        "y": 797
+    },
+    "control_create_clone_of_menu": {
+        "opcode": "control_create_clone_of_menu",
+        "next": null,
+        "parent": "80yo/}Cw++Z.;x[ohh|7",
+        "inputs": {},
+        "fields": {
+            "CLONE_OPTION": [
+                "_myself_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "control_delete_this_clone": {
+        "opcode": "control_delete_this_clone",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 642,
+        "y": 914
+    },
+    "event_whenflagclicked": {
+        "opcode": "event_whenflagclicked",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 166,
+        "y": -422
+    },
+    "event_whenkeypressed": {
+        "opcode": "event_whenkeypressed",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "KEY_OPTION": [
+                "space",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 151,
+        "y": -329
+    },
+    "event_whenthisspriteclicked": {
+        "opcode": "event_whenthisspriteclicked",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 156,
+        "y": -223
+    },
+    "event_whenbackdropswitchesto": {
+        "opcode": "event_whenbackdropswitchesto",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "BACKDROP": [
+                "backdrop1",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 148,
+        "y": -101
+    },
+    "event_whengreaterthan": {
+        "opcode": "event_whengreaterthan",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {
+            "WHENGREATERTHANMENU": [
+                "LOUDNESS",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 150,
+        "y": 10
+    },
+    "event_whenbroadcastreceived": {
+        "opcode": "event_whenbroadcastreceived",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "BROADCAST_OPTION": [
+                "message1",
+                "5O!nei;S$!c!=hCT}0:a"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 141,
+        "y": 118
+    },
+    "event_broadcast": {
+        "opcode": "event_broadcast",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "BROADCAST_INPUT": [
+                1,
+                [
+                    11,
+                    "message1",
+                    "5O!nei;S$!c!=hCT}0:a"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 151,
+        "y": 229
+    },
+    "event_broadcastandwait": {
+        "opcode": "event_broadcastandwait",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "BROADCAST_INPUT": [
+                1,
+                [
+                    11,
+                    "message1",
+                    "5O!nei;S$!c!=hCT}0:a"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 157,
+        "y": 340
+    },
+    "sensing_touchingobject": {
+        "opcode": "sensing_touchingobject",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TOUCHINGOBJECTMENU": [
+                1,
+                "xSKW9a+wTnM~h~So8Jc]"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 359,
+        "y": 116
+    },
+    "sensing_touchingobjectmenu": {
+        "opcode": "sensing_touchingobjectmenu",
+        "next": null,
+        "parent": "Y(n,F@BYzwd4CiN|Bh[P",
+        "inputs": {},
+        "fields": {
+            "TOUCHINGOBJECTMENU": [
+                "_mouse_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sensing_touchingcolor": {
+        "opcode": "sensing_touchingcolor",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "COLOR": [
+                1,
+                [
+                    9,
+                    "#55b888"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 360,
+        "y": 188
+    },
+    "sensing_coloristouchingcolor": {
+        "opcode": "sensing_coloristouchingcolor",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "COLOR": [
+                1,
+                [
+                    9,
+                    "#d019f2"
+                ]
+            ],
+            "COLOR2": [
+                1,
+                [
+                    9,
+                    "#2b0de3"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 277
+    },
+    "sensing_askandwait": {
+        "opcode": "sensing_askandwait",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "QUESTION": [
+                1,
+                [
+                    10,
+                    "What's your name?"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 338,
+        "y": 354
+    },
+    "sensing_answer": {
+        "opcode": "sensing_answer",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 782,
+        "y": 111
+    },
+    "sensing_keypressed": {
+        "opcode": "sensing_keypressed",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "KEY_OPTION": [
+                1,
+                "SNlf@Im$sv%.6ULi-f3i"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 762,
+        "y": 207
+    },
+    "sensing_keyoptions": {
+        "opcode": "sensing_keyoptions",
+        "next": null,
+        "parent": "7$xEUO.2hH2R6vh!$(Uj",
+        "inputs": {},
+        "fields": {
+            "KEY_OPTION": [
+                "space",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sensing_mousedown": {
+        "opcode": "sensing_mousedown",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 822,
+        "y": 422
+    },
+    "sensing_mousex": {
+        "opcode": "sensing_mousex",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 302,
+        "y": 528
+    },
+    "sensing_mousey": {
+        "opcode": "sensing_mousey",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 668,
+        "y": 547
+    },
+    "sensing_setdragmode": {
+        "opcode": "sensing_setdragmode",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "DRAG_MODE": [
+                "draggable",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 950,
+        "y": 574
+    },
+    "sensing_loudness": {
+        "opcode": "sensing_loudness",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 658,
+        "y": 703
+    },
+    "sensing_timer": {
+        "opcode": "sensing_timer",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 459,
+        "y": 671
+    },
+    "sensing_resettimer": {
+        "opcode": "sensing_resettimer",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 462,
+        "y": 781
+    },
+    "sensing_of": {
+        "opcode": "sensing_of",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OBJECT": [
+                1,
+                "t+o*y;iz,!O#aT|qM_+O"
+            ]
+        },
+        "fields": {
+            "PROPERTY": [
+                "backdrop #",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 997,
+        "y": 754
+    },
+    "sensing_of_object_menu": {
+        "opcode": "sensing_of_object_menu",
+        "next": null,
+        "parent": "[4I2wIG/tNc@LQ-;FbsB",
+        "inputs": {},
+        "fields": {
+            "OBJECT": [
+                "_stage_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sensing_current": {
+        "opcode": "sensing_current",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "CURRENTMENU": [
+                "YEAR",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 627,
+        "y": 884
+    },
+    "sensing_dayssince2000": {
+        "opcode": "sensing_dayssince2000",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 959,
+        "y": 903
+    },
+    "sensing_username": {
+        "opcode": "sensing_username",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 833,
+        "y": 757
+    },
+    "operator_add": {
+        "opcode": "operator_add",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 128,
+        "y": 153
+    },
+    "operator_subtract": {
+        "opcode": "operator_subtract",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 134,
+        "y": 214
+    },
+    "operator_multiply": {
+        "opcode": "operator_multiply",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 134,
+        "y": 278
+    },
+    "operator_divide": {
+        "opcode": "operator_divide",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 138,
+        "y": 359
+    },
+    "operator_random": {
+        "opcode": "operator_random",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "FROM": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ],
+            "TO": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 311,
+        "y": 157
+    },
+    "operator_gt": {
+        "opcode": "operator_gt",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OPERAND1": [
+                1,
+                [
+                    10,
+                    ""
+                ]
+            ],
+            "OPERAND2": [
+                1,
+                [
+                    10,
+                    "50"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 217
+    },
+    "operator_lt": {
+        "opcode": "operator_lt",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OPERAND1": [
+                1,
+                [
+                    10,
+                    ""
+                ]
+            ],
+            "OPERAND2": [
+                1,
+                [
+                    10,
+                    "50"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 345,
+        "y": 286
+    },
+    "operator_equals": {
+        "opcode": "operator_equals",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OPERAND1": [
+                1,
+                [
+                    10,
+                    ""
+                ]
+            ],
+            "OPERAND2": [
+                1,
+                [
+                    10,
+                    "50"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 345,
+        "y": 372
+    },
+    "operator_and": {
+        "opcode": "operator_and",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 701,
+        "y": 158
+    },
+    "operator_or": {
+        "opcode": "operator_or",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 705,
+        "y": 222
+    },
+    "operator_not": {
+        "opcode": "operator_not",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 734,
+        "y": 283
+    },
+    "operator_join": {
+        "opcode": "operator_join",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STRING1": [
+                1,
+                [
+                    10,
+                    "apple "
+                ]
+            ],
+            "STRING2": [
+                1,
+                [
+                    10,
+                    "banana"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 663,
+        "y": 378
+    },
+    "operator_letter_of": {
+        "opcode": "operator_letter_of",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "LETTER": [
+                1,
+                [
+                    6,
+                    "1"
+                ]
+            ],
+            "STRING": [
+                1,
+                [
+                    10,
+                    "apple"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 664,
+        "y": 445
+    },
+    "operator_length": {
+        "opcode": "operator_length",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STRING": [
+                1,
+                [
+                    10,
+                    "apple"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 664,
+        "y": 521
+    },
+    "operator_contains": {
+        "opcode": "operator_contains",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STRING1": [
+                1,
+                [
+                    10,
+                    "apple"
+                ]
+            ],
+            "STRING2": [
+                1,
+                [
+                    10,
+                    "a"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 634,
+        "y": 599
+    },
+    "operator_mod": {
+        "opcode": "operator_mod",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 295,
+        "y": 594
+    },
+    "operator_round": {
+        "opcode": "operator_round",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 307,
+        "y": 674
+    },
+    "operator_mathop": {
+        "opcode": "operator_mathop",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {
+            "OPERATOR": [
+                "abs",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 280,
+        "y": 754
+    },
+    "data_setvariableto": {
+        "opcode": "data_setvariableto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    10,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {
+            "VARIABLE": [
+                "my variable",
+                "`jEk@4|i[#Fk?(8x)AV.-my variable"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 241
+    },
+    "data_changevariableby": {
+        "opcode": "data_changevariableby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "VARIABLE": [
+                "my variable",
+                "`jEk@4|i[#Fk?(8x)AV.-my variable"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 313,
+        "y": 363
+    },
+    "data_showvariable": {
+        "opcode": "data_showvariable",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "VARIABLE": [
+                "my variable",
+                "`jEk@4|i[#Fk?(8x)AV.-my variable"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 415,
+        "y": 473
+    },
+    "data_hidevariable": {
+        "opcode": "data_hidevariable",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "VARIABLE": [
+                "my variable",
+                "`jEk@4|i[#Fk?(8x)AV.-my variable"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 319,
+        "y": 587
+    },
+    "data_addtolist": {
+        "opcode": "data_addtolist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 385,
+        "y": 109
+    },
+    "data_deleteoflist": {
+        "opcode": "data_deleteoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "INDEX": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 384,
+        "y": 244
+    },
+    "data_deletealloflist": {
+        "opcode": "data_deletealloflist",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 387,
+        "y": 374
+    },
+    "data_insertatlist": {
+        "opcode": "data_insertatlist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ],
+            "INDEX": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 366,
+        "y": 527
+    },
+    "data_replaceitemoflist": {
+        "opcode": "data_replaceitemoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "INDEX": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ],
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 365,
+        "y": 657
+    },
+    "data_itemoflist": {
+        "opcode": "data_itemoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "INDEX": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 862,
+        "y": 117
+    },
+    "data_itemnumoflist": {
+        "opcode": "data_itemnumoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 883,
+        "y": 238
+    },
+    "data_lengthoflist": {
+        "opcode": "data_lengthoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 876,
+        "y": 342
+    },
+    "data_listcontainsitem": {
+        "opcode": "data_listcontainsitem",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 871,
+        "y": 463
+    },
+    "data_showlist": {
+        "opcode": "data_showlist",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 931,
+        "y": 563
+    },
+    "data_hidelist": {
+        "opcode": "data_hidelist",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 962,
+        "y": 716
+    },
+    "sound_playuntildone": {
+        "opcode": "sound_playuntildone",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SOUND_MENU": [
+                1,
+                "4w%pR8G.yD%g-BwCj=uK"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 253,
+        "y": 17
+    },
+    "sound_sounds_menu": {
+        "opcode": "sound_sounds_menu",
+        "next": null,
+        "parent": "Pdc$U;s8e_uUfTX`}jOo",
+        "inputs": {},
+        "fields": {
+            "SOUND_MENU": [
+                "Meow",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sound_play": {
+        "opcode": "sound_play",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SOUND_MENU": [
+                1,
+                "i1U{^VHb*2`9?l}=:L)/"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 245,
+        "y": 122
+    },
+    "sound_stopallsounds": {
+        "opcode": "sound_stopallsounds",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 253,
+        "y": 245
+    },
+    "sound_changeeffectby": {
+        "opcode": "sound_changeeffectby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {
+            "EFFECT": [
+                "PITCH",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 653,
+        "y": 14
+    },
+    "sound_seteffectto": {
+        "opcode": "sound_seteffectto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "100"
+                ]
+            ]
+        },
+        "fields": {
+            "EFFECT": [
+                "PITCH",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 653,
+        "y": 139
+    },
+    "sound_cleareffects": {
+        "opcode": "sound_cleareffects",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 651,
+        "y": 242
+    },
+    "sound_changevolumeby": {
+        "opcode": "sound_changevolumeby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VOLUME": [
+                1,
+                [
+                    4,
+                    "-10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 645,
+        "y": 353
+    },
+    "sound_setvolumeto": {
+        "opcode": "sound_setvolumeto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VOLUME": [
+                1,
+                [
+                    4,
+                    "100"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1108,
+        "y": 5
+    },
+    "sound_volume": {
+        "opcode": "sound_volume",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1136,
+        "y": 123
+    },
+    "looks_sayforsecs": {
+        "opcode": "looks_sayforsecs",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "MESSAGE": [
+                1,
+                [
+                    10,
+                    "Hello!"
+                ]
+            ],
+            "SECS": [
+                1,
+                [
+                    4,
+                    "2"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 408,
+        "y": 91
+    },
+    "looks_say": {
+        "opcode": "looks_say",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "MESSAGE": [
+                1,
+                [
+                    10,
+                    "Hello!"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 413,
+        "y": 213
+    },
+    "looks_thinkforsecs": {
+        "opcode": "looks_thinkforsecs",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "MESSAGE": [
+                1,
+                [
+                    10,
+                    "Hmm..."
+                ]
+            ],
+            "SECS": [
+                1,
+                [
+                    4,
+                    "2"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 413,
+        "y": 317
+    },
+    "looks_think": {
+        "opcode": "looks_think",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "MESSAGE": [
+                1,
+                [
+                    10,
+                    "Hmm..."
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 412,
+        "y": 432
+    },
+    "looks_switchcostumeto": {
+        "opcode": "looks_switchcostumeto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "COSTUME": [
+                1,
+                "8;bti4wv(iH9nkOacCJ|"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 411,
+        "y": 555
+    },
+    "looks_costume": {
+        "opcode": "looks_costume",
+        "next": null,
+        "parent": "Q#a,6LPWHqo9-0Nu*[SV",
+        "inputs": {},
+        "fields": {
+            "COSTUME": [
+                "costume2",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "looks_nextcostume": {
+        "opcode": "looks_nextcostume",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 419,
+        "y": 687
+    },
+    "looks_switchbackdropto": {
+        "opcode": "looks_switchbackdropto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "BACKDROP": [
+                1,
+                "-?yeX}29V*wd6W:unW0i"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 901,
+        "y": 91
+    },
+    "looks_backdrops": {
+        "opcode": "looks_backdrops",
+        "next": null,
+        "parent": "`Wm^p~l[(IWzc1|wNv*.",
+        "inputs": {},
+        "fields": {
+            "BACKDROP": [
+                "backdrop1",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "looks_changesizeby": {
+        "opcode": "looks_changesizeby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "CHANGE": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 895,
+        "y": 192
+    },
+    "looks_setsizeto": {
+        "opcode": "looks_setsizeto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SIZE": [
+                1,
+                [
+                    4,
+                    "100"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 896,
+        "y": 303
+    },
+    "looks_changeeffectby": {
+        "opcode": "looks_changeeffectby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "CHANGE": [
+                1,
+                [
+                    4,
+                    "25"
+                ]
+            ]
+        },
+        "fields": {
+            "EFFECT": [
+                "COLOR",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 892,
+        "y": 416
+    },
+    "looks_seteffectto": {
+        "opcode": "looks_seteffectto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {
+            "EFFECT": [
+                "COLOR",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 902,
+        "y": 527
+    },
+    "looks_cleargraphiceffects": {
+        "opcode": "looks_cleargraphiceffects",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 902,
+        "y": 638
+    },
+    "looks_show": {
+        "opcode": "looks_show",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 908,
+        "y": 758
+    },
+    "looks_hide": {
+        "opcode": "looks_hide",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 455,
+        "y": 861
+    },
+    "looks_gotofrontback": {
+        "opcode": "looks_gotofrontback",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "FRONT_BACK": [
+                "front",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 853,
+        "y": 878
+    },
+    "looks_goforwardbackwardlayers": {
+        "opcode": "looks_goforwardbackwardlayers",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "FORWARD_BACKWARD": [
+                "forward",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 851,
+        "y": 999
+    },
+    "looks_costumenumbername": {
+        "opcode": "looks_costumenumbername",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "NUMBER_NAME": [
+                "number",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 458,
+        "y": 1007
+    },
+    "looks_backdropnumbername": {
+        "opcode": "looks_backdropnumbername",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "NUMBER_NAME": [
+                "number",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 1242,
+        "y": 753
+    },
+    "looks_size": {
+        "opcode": "looks_size",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1249,
+        "y": 876
+    }
+}

v2/scratch_agent/blocks/boolean_blocks.json

@@ -0,0 +1,281 @@
+{
+  "block_category": "Boolean Blocks",
+  "description": "Boolean blocks are hexagonal in shape. They represent conditions that evaluate to either 'true' or 'false' and are typically used as inputs for control flow blocks.",
+  "blocks": [
+    {
+      "block_name": "<() < ()>",
+      "block_type": "operator",
+      "op_code": "operator_lt",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if the first value is less than the second.",
+      "inputs": [
+        {"name": "OPERAND1", "type": "any"},
+        {"name": "OPERAND2", "type": "any"}
+      ],
+      "example_standalone": "<(score) < (10)>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(score) < (10)> then\n  say [Keep trying!]",
+          "explanation": "This script causes the sprite to say 'Keep trying!' if the 'score' variable is less than 10."
+        }
+      ]
+    },
+    {
+      "block_name": "<() = ()>",
+      "block_type": "operator",
+      "op_code": "operator_equals",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if two values are equal.",
+      "inputs": [
+        {"name": "OPERAND1", "type": "any"},
+        {"name": "OPERAND2", "type": "any"}
+      ],
+      "example_standalone": "<(answer) = (5)>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(answer) = (5)> then\n  say [Correct!]",
+          "explanation": "This script makes the sprite say 'Correct!' if the value of the 'answer' variable is exactly 5."
+        }
+      ]
+    },
+    {
+      "block_name": "<() > ()>",
+      "block_type": "operator",
+      "op_code": "operator_gt",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if the first value is greater than the second.",
+      "inputs": [
+        {"name": "OPERAND1", "type": "any"},
+        {"name": "OPERAND2", "type": "any"}
+      ],
+      "example_standalone": "<([health v]) > (0)>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <([health v]) > (0)> then\n  move (10) steps\nelse\n  stop [all v]\nend",
+          "explanation": "This script moves the sprite if its 'health' is greater than 0; otherwise, it stops all scripts."
+        }
+      ]
+    },
+    {
+      "block_name": "<<> and <>>",
+      "block_type": "operator",
+      "op_code": "operator_and",
+      "block_shape": "Boolean Block",
+      "functionality": "Returns 'true' if both provided Boolean conditions are 'true'.",
+      "inputs": [
+        {"name": "OPERAND1", "type": "boolean"},
+        {"name": "OPERAND2", "type": "boolean"}
+      ],
+      "example_standalone": "<<mouse down?> and <touching [mouse-pointer]?> >",
+      "example_with_other_blocks": [
+        {
+          "script": "if <<mouse down?> and <touching [mouse-pointer]?> > then\n  say [You're clicking me!]\nend",
+          "explanation": "This script makes the sprite say 'You're clicking me!' only if the mouse button is pressed AND the mouse pointer is touching the sprite."
+        }
+      ]
+    },
+    {
+      "block_name": "<<> or <>>",
+      "block_type": "operator",
+      "op_code": "operator_or",
+      "block_shape": "Boolean Block",
+      "functionality": "Returns 'true' if at least one of the provided Boolean conditions is 'true'.",
+      "inputs": [
+        {"name": "OPERAND1", "type": "boolean"},
+        {"name": "OPERAND2", "type": "boolean"}
+      ],
+      "example_standalone": "<<key [left arrow v] pressed?> or <key [a v] pressed?>>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <<key [left arrow v] pressed?> or <key [a v] pressed?>> then\n  change x by (-10)\nend",
+          "explanation": "This script moves the sprite left if either the left arrow key OR the 'a' key is pressed."
+        }
+      ]
+    },
+    {
+      "block_name": "<not <>>",
+      "block_type": "operator",
+      "op_code": "operator_not",
+      "block_shape": "Boolean Block",
+      "functionality": "Returns 'true' if the provided Boolean condition is 'false', and 'false' if it is 'true'.",
+      "inputs": [
+        {"name": "OPERAND", "type": "boolean"}
+      ],
+      "example_standalone": "<not <mouse down?>>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <not <touching [Sprite2 v]?>> then\n  say [I'm safe!]\nend",
+          "explanation": "This script makes the sprite say 'I'm safe!' if it is NOT touching 'Sprite2'."
+        }
+      ]
+    },
+    {
+      "block_name": "<() contains ()?>",
+      "block_type": "operator",
+      "op_code": "operator_contains",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if one string contains another string.",
+      "inputs": [
+        {"name": "STRING1", "type": "string"},
+        {"name": "STRING2", "type": "string"}
+      ],
+      "example_standalone": "<[apple v] contains [a v]?>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <[answer] contains [yes]?> then\n  say [Great!]\nend",
+          "explanation": "This script makes the sprite say 'Great!' if the 'answer' variable contains the substring 'yes'."
+        }
+      ]
+    },
+    {
+      "block_name": "<touching [edge v]?>",
+      "block_type": "Sensing",
+      "op_code": "sensing_touchingobject",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if its sprite is touching the mouse-pointer, edge, or another specified sprite.",
+      "inputs": [
+        {"name": "TOUCHINGOBJECTMENU", "type": "dropdown", "options": ["mouse-pointer", "edge", "Sprite1", "..." ]}
+      ],
+      "example_standalone": "<touching [edge v]?>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <touching [Sprite v]?> then\n   broadcast [Game Over v] \nend",
+          "explanation": "This script makes the broadcast message 'Game Over' in script if it comes into contact with the sprite."
+        },
+        {
+          "script": "if <touching [edge v]?> then\n  bounce off edge\nend",
+          "explanation": "This script makes the sprite reverse direction if it comes into contact with the edge of the stage."
+        }
+      ]
+    },
+    {
+      "block_name": "<touching color ()?>",
+      "block_type": "Sensing",
+      "op_code": "sensing_touchingcolor",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks whether its sprite is touching a specified color.",
+      "inputs": [
+        {"name": "COLOR", "type": "color"}
+      ],
+      "example_standalone": "<touching color [#FF0000]?>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <touching color [#FF0000]?> then\n  change [health v] by (-1)\nend",
+          "explanation": "This script decreases the 'health' variable by 1 if the sprite touches any red color on the stage."
+        }
+      ]
+    },
+    {
+      "block_name": "<color () is touching ()?>",
+      "block_type": "Sensing",
+      "op_code": "sensing_coloristouchingcolor",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks whether a specific color on its sprite is touching another specified color on the stage or another sprite.",
+      "inputs": [
+        {"name": "COLOR1", "type": "color"},
+        {"name": "COLOR2", "type": "color"}
+      ],
+      "example_standalone": "<color [#00FF00] is touching [#FF0000]?>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <color [#00FF00] is touching [#FF0000]?> then\n  say [Collision!]\nend",
+          "explanation": "This script makes the sprite say 'Collision!' if a green part of the sprite touches a red color elsewhere in the project."
+        }
+      ]
+    },
+    {
+      "block_name": "<key () pressed?>",
+      "block_type": "Sensing",
+      "op_code": "sensing_keypressed",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if a specified keyboard key is currently being pressed.",
+      "inputs": [
+        {"name": "KEY_OPTION", "type": "dropdown",
+        "options": [
+            "space",
+            "up arrow",
+            "down arrow",
+            "right arrow",
+            "left arrow",
+            "any",
+            "a",
+            "b",
+            "c",
+            "d",
+            "e",
+            "f",
+            "g",
+            "h",
+            "i",
+            "j",
+            "k",
+            "l",
+            "m",
+            "n",
+            "o",
+            "p",
+            "q",
+            "r",
+            "s",
+            "t",
+            "u",
+            "v",
+            "w",
+            "x",
+            "y",
+            "z",
+            "0",
+            "1",
+            "2",
+            "3",
+            "4",
+            "5",
+            "6",
+            "7",
+            "8",
+            "9"
+          ]}
+      ],
+      "example_standalone": "<key [space v] pressed?>",
+      "example_with_other_blocks": [
+        {
+          "script": "forever\n  if <key [space v] pressed?> then\n    broadcast [shoot v]\n  end\nend",
+          "explanation": "This script continuously checks if the space key is pressed and, if so, sends a 'shoot' broadcast."
+        }
+      ]
+    },
+    {
+      "block_name": "<mouse down?>",
+      "block_type": "Sensing",
+      "op_code": "sensing_mousedown",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if the computer mouse's primary button is being clicked while the cursor is over the stage.",
+      "inputs": null,
+      "example_standalone": "<mouse down?>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <mouse down?> then\n  go to mouse-pointer\nend",
+          "explanation": "This script makes the sprite follow the mouse pointer only when the mouse button is held down."
+        }
+      ]
+    },
+    {
+      "block_name": "<[my list v] contains ()?>",
+      "block_type": "Data",
+      "op_code": "data_listcontainsitem",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if a list includes a specific item.",
+      "inputs": [
+        {"name": "LIST", "type": "dropdown"},
+        {"name": "ITEM", "type": "any"}
+      ],
+      "example_standalone": "<[inventory v] contains [key]?>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <[inventory v] contains [key]?> then\n  say [You have the key!]\nend",
+          "explanation": "This script makes the sprite say 'You have the key!' if the 'inventory' list contains the item 'key'."
+        }
+      ]
+    }
+  ]
+}

v2/scratch_agent/blocks/c_blocks.json

@@ -0,0 +1,105 @@
+{
+  "block_category": "C Blocks",
+  "description": "C blocks are shaped like the letter 'C'. They are used to loop or conditionally execute blocks that are placed within their opening, managing the flow of scripts.",
+  "blocks": [
+    {
+      "block_name": "repeat ()",
+      "block_type": "Control",
+      "block_shape": "C-Block",
+      "op_code": "control_repeat",
+      "functionality": "Repeats the blocks inside it a specified number of times.",
+      "inputs": [
+        {
+          "name": "times",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "repeat (10)",
+      "example_with_other_blocks": [
+        {
+          "script": "when [space v] key pressed\n  repeat (10)\n    move (10) steps\n    wait (0.1) seconds\n  end",
+          "explanation": "This script makes the sprite move 10 steps Ten times, with a short pause after each movement on spacebar pressed."
+        },
+        {
+          "script": "when [up arrow v] key pressed\n  repeat (10)\n    change y by (10)\n    wait (0.1) seconds\n    change y by (10)\n  end",
+          "explanation": "This script makes the sprite jump, with a short pause after each movement on up arrow pressed."
+        }
+      ]
+    },
+    {
+      "block_name": "forever",
+      "block_type": "Control",
+      "block_shape": "C-Block",
+      "op_code": "control_forever",
+      "functionality": "Continuously runs the blocks inside it.",
+      "inputs": null,
+      "example_standalone": "forever",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  forever\n    move (5) steps\n    if on edge, bounce\n  end",
+          "explanation": "This script makes the sprite move endlessly and bounce off the edges of the stage, creating continuous motion."
+        }
+      ]
+    },
+    {
+      "block_name": "if <> then",
+      "block_type": "Control",
+      "block_shape": "C-Block",
+      "op_code": "control_if",
+      "functionality": "Executes the blocks inside it only if the specified boolean condition is true. [NOTE: it takes boolean blocks as input]",
+      "inputs": [
+        {
+          "name": "condition",
+          "type": "boolean"
+        }
+      ],
+      "example_standalone": "if <touching [mouse-pointer v]?> then",
+      "example_with_other_blocks": [
+        {
+          "script": "forever\n  if <touching [color (red) v]?> then\n    stop [this script v]\n  end",
+          "explanation": "This script continuously checks if the sprite is touching a red color, and if so, it stops the current script."
+        }
+      ]
+    },
+    {
+      "block_name": "if <> then else",
+      "block_type": "Control",
+      "block_shape": "C-Block",
+      "op_code": "control_if_else",
+      "functionality": "Executes one set of blocks if the specified boolean condition is true, and a different set of blocks if the condition is false. [NOTE: it takes boolean blocks as input]",
+      "inputs": [
+        {
+          "name": "condition",
+          "type": "boolean"
+        }
+      ],
+      "example_standalone": "if <score > (10)> then else",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(score) > (10)> then\n  say [You win!] for (2) seconds\nelse\n  say [Keep trying!] for (2) seconds\nend",
+          "explanation": "This script checks the 'score'. If the score is greater than 10, it says 'You win!'; otherwise, it says 'Keep trying!'."
+        }
+      ]
+    },
+    {
+      "block_name": "repeat until <>",
+      "block_type": "Control",
+      "block_shape": "C-Block",
+      "op_code": "control_repeat_until",
+      "functionality": "Repeats the blocks inside it until the specified boolean condition becomes true. [NOTE: it takes boolean blocks as input]",
+      "inputs": [
+        {
+          "name": "condition",
+          "type": "boolean"
+        }
+      ],
+      "example_standalone": "repeat until <touching [edge v]?>",
+      "example_with_other_blocks": [
+        {
+          "script": "repeat until <touching [edge v]?>\n  move (5) steps\nend",
+          "explanation": "This script makes the sprite move 5 steps repeatedly until it touches the edge of the stage."
+        }
+      ]
+    }
+  ]
+}

v2/scratch_agent/blocks/cap_blocks.json

@@ -0,0 +1,53 @@
+{
+  "block_category": "Cap Blocks",
+  "description": "Cap blocks have a notch at the top and a flat bottom. They signify the end of a script, preventing any further blocks from being placed below them, and are used to terminate scripts or specific actions.",
+  "blocks": [
+    {
+      "block_name": "stop [v]",
+      "block_type": "Control",
+      "block_shape": "Cap Block (dynamic: can be Stack)",
+      "op_code": "control_stop",
+      "functionality": "Halts all scripts, only the current script, or other scripts within the same sprite. Its shape can dynamically change based on the selected option.",
+      "inputs": [
+        {"name": "option", "type": "dropdown", "options": ["all"]}
+      ],
+      "example_standalone": "stop [all v]",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(health) = (0)> then\n  stop [all v]\nend",
+          "explanation": "This script stops all running scripts in the project if the 'health' variable reaches 0, typically signifying a game over condition. [9, 15]"
+        }
+      ]
+    },
+    {
+      "block_name": "delete this clone",
+      "block_type": "Control",
+      "block_shape": "Cap Block",
+      "op_code": "control_delete_this_clone",
+      "functionality": "Removes the clone that is executing it from the stage.",
+      "inputs":null,
+      "example_standalone": "delete this clone",
+      "example_with_other_blocks": [
+        {
+          "script": "when I start as a clone\n  wait until <touching [edge v]?>\n  delete this clone\nend",
+          "explanation": "This script, run by a clone, causes the clone to disappear from the stage once it touches the edge. [1]"
+        }
+      ]
+    },
+    {
+      "block_name": "forever",
+      "block_type": "Control",
+      "block_shape": "Cap Block",
+      "op_code": "control_forever",
+      "functionality": "Continuously runs the blocks inside it.",
+      "inputs": null,
+      "example_standalone": "forever",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  forever\n    move (5) steps\n    if on edge, bounce\n  end",
+          "explanation": "This script makes the sprite move endlessly and bounce off the edges of the stage, creating continuous motion."
+        }
+      ]
+    }
+  ]
+}

v2/scratch_agent/blocks/classwise_blocks/control_block.json

@@ -0,0 +1,168 @@
+{
+        "control_wait": {
+        "opcode": "control_wait",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DURATION": [
+                1,
+                [
+                    5,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 337,
+        "y": 129
+    },
+    "control_repeat": {
+        "opcode": "control_repeat",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TIMES": [
+                1,
+                [
+                    6,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 265
+    },
+    "control_forever": {
+        "opcode": "control_forever",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 334,
+        "y": 439
+    },
+    "control_if": {
+        "opcode": "control_if",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 331,
+        "y": 597
+    },
+    "control_if_else": {
+        "opcode": "control_if_else",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 335,
+        "y": 779
+    },
+    "control_wait_until": {
+        "opcode": "control_wait_until",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 676,
+        "y": 285
+    },
+    "control_repeat_until": {
+        "opcode": "control_repeat_until",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 692,
+        "y": 381
+    },
+    "control_stop": {
+        "opcode": "control_stop",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "STOP_OPTION": [
+                "all",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 708,
+        "y": 545,
+        "mutation": {
+            "tagName": "mutation",
+            "children": [],
+            "hasnext": "false"
+        }
+    },
+    "control_start_as_clone": {
+        "opcode": "control_start_as_clone",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 665,
+        "y": 672
+    },
+    "control_create_clone_of": {
+        "opcode": "control_create_clone_of",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "CLONE_OPTION": [
+                1,
+                "control_create_clone_of_menu"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 648,
+        "y": 797
+    },
+    "control_create_clone_of_menu": {
+        "opcode": "control_create_clone_of_menu",
+        "next": null,
+        "parent": "control_create_clone_of",
+        "inputs": {},
+        "fields": {
+            "CLONE_OPTION": [
+                "_myself_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "control_delete_this_clone": {
+        "opcode": "control_delete_this_clone",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 642,
+        "y": 914
+    }
+}

v2/scratch_agent/blocks/classwise_blocks/data_block.json

@@ -0,0 +1,328 @@
+{
+    "data_setvariableto": {
+        "opcode": "data_setvariableto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    10,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {
+            "VARIABLE": [
+                "my variable",
+                "`jEk@4|i[#Fk?(8x)AV.-my variable"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 241
+    },
+    "data_changevariableby": {
+        "opcode": "data_changevariableby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "VARIABLE": [
+                "my variable",
+                "`jEk@4|i[#Fk?(8x)AV.-my variable"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 313,
+        "y": 363
+    },
+    "data_showvariable": {
+        "opcode": "data_showvariable",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "VARIABLE": [
+                "my variable",
+                "`jEk@4|i[#Fk?(8x)AV.-my variable"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 415,
+        "y": 473
+    },
+    "data_hidevariable": {
+        "opcode": "data_hidevariable",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "VARIABLE": [
+                "my variable",
+                "`jEk@4|i[#Fk?(8x)AV.-my variable"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 319,
+        "y": 587
+    },
+    "data_addtolist": {
+        "opcode": "data_addtolist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 385,
+        "y": 109
+    },
+    "data_deleteoflist": {
+        "opcode": "data_deleteoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "INDEX": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 384,
+        "y": 244
+    },
+    "data_deletealloflist": {
+        "opcode": "data_deletealloflist",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 387,
+        "y": 374
+    },
+    "data_insertatlist": {
+        "opcode": "data_insertatlist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ],
+            "INDEX": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 366,
+        "y": 527
+    },
+    "data_replaceitemoflist": {
+        "opcode": "data_replaceitemoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "INDEX": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ],
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 365,
+        "y": 657
+    },
+    "data_itemoflist": {
+        "opcode": "data_itemoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "INDEX": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 862,
+        "y": 117
+    },
+    "data_itemnumoflist": {
+        "opcode": "data_itemnumoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 883,
+        "y": 238
+    },
+    "data_lengthoflist": {
+        "opcode": "data_lengthoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 876,
+        "y": 342
+    },
+    "data_listcontainsitem": {
+        "opcode": "data_listcontainsitem",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 871,
+        "y": 463
+    },
+    "data_showlist": {
+        "opcode": "data_showlist",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 931,
+        "y": 563
+    },
+    "data_hidelist": {
+        "opcode": "data_hidelist",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 962,
+        "y": 716
+    }
+}

v2/scratch_agent/blocks/classwise_blocks/event_block.json

@@ -0,0 +1,136 @@
+{
+    "event_whenflagclicked": {
+        "opcode": "event_whenflagclicked",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 166,
+        "y": -422
+    },
+    "event_whenkeypressed": {
+        "opcode": "event_whenkeypressed",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "KEY_OPTION": [
+                "space",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 151,
+        "y": -329
+    },
+    "event_whenthisspriteclicked": {
+        "opcode": "event_whenthisspriteclicked",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 156,
+        "y": -223
+    },
+    "event_whenbackdropswitchesto": {
+        "opcode": "event_whenbackdropswitchesto",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "BACKDROP": [
+                "backdrop1",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 148,
+        "y": -101
+    },
+    "event_whengreaterthan": {
+        "opcode": "event_whengreaterthan",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {
+            "WHENGREATERTHANMENU": [
+                "LOUDNESS",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 150,
+        "y": 10
+    },
+    "event_whenbroadcastreceived": {
+        "opcode": "event_whenbroadcastreceived",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "BROADCAST_OPTION": [
+                "message1",
+                "5O!nei;S$!c!=hCT}0:a"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 141,
+        "y": 118
+    },
+    "event_broadcast": {
+        "opcode": "event_broadcast",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "BROADCAST_INPUT": [
+                1,
+                [
+                    11,
+                    "message1",
+                    "5O!nei;S$!c!=hCT}0:a"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 151,
+        "y": 229
+    },
+    "event_broadcastandwait": {
+        "opcode": "event_broadcastandwait",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "BROADCAST_INPUT": [
+                1,
+                [
+                    11,
+                    "message1",
+                    "5O!nei;S$!c!=hCT}0:a"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 157,
+        "y": 340
+    }
+}

v2/scratch_agent/blocks/classwise_blocks/look_block.json

@@ -0,0 +1,365 @@
+{
+    "looks_sayforsecs": {
+        "opcode": "looks_sayforsecs",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "MESSAGE": [
+                1,
+                [
+                    10,
+                    "Hello!"
+                ]
+            ],
+            "SECS": [
+                1,
+                [
+                    4,
+                    "2"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 408,
+        "y": 91
+    },
+    "looks_say": {
+        "opcode": "looks_say",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "MESSAGE": [
+                1,
+                [
+                    10,
+                    "Hello!"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 413,
+        "y": 213
+    },
+    "looks_thinkforsecs": {
+        "opcode": "looks_thinkforsecs",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "MESSAGE": [
+                1,
+                [
+                    10,
+                    "Hmm..."
+                ]
+            ],
+            "SECS": [
+                1,
+                [
+                    4,
+                    "2"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 413,
+        "y": 317
+    },
+    "looks_think": {
+        "opcode": "looks_think",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "MESSAGE": [
+                1,
+                [
+                    10,
+                    "Hmm..."
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 412,
+        "y": 432
+    },
+    "looks_switchcostumeto": {
+        "opcode": "looks_switchcostumeto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "COSTUME": [
+                1,
+                "looks_costume"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 411,
+        "y": 555
+    },
+    "looks_costume": {
+        "opcode": "looks_costume",
+        "next": null,
+        "parent": "looks_switchcostumeto",
+        "inputs": {},
+        "fields": {
+            "COSTUME": [
+                "costume2",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "looks_nextcostume": {
+        "opcode": "looks_nextcostume",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 419,
+        "y": 687
+    },
+    "looks_switchbackdropto": {
+        "opcode": "looks_switchbackdropto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "BACKDROP": [
+                1,
+                "looks_backdrops"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 901,
+        "y": 91
+    },
+    "looks_backdrops": {
+        "opcode": "looks_backdrops",
+        "next": null,
+        "parent": "looks_switchbackdropto",
+        "inputs": {},
+        "fields": {
+            "BACKDROP": [
+                "backdrop1",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "looks_changesizeby": {
+        "opcode": "looks_changesizeby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "CHANGE": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 895,
+        "y": 192
+    },
+    "looks_setsizeto": {
+        "opcode": "looks_setsizeto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SIZE": [
+                1,
+                [
+                    4,
+                    "100"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 896,
+        "y": 303
+    },
+    "looks_changeeffectby": {
+        "opcode": "looks_changeeffectby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "CHANGE": [
+                1,
+                [
+                    4,
+                    "25"
+                ]
+            ]
+        },
+        "fields": {
+            "EFFECT": [
+                "COLOR",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 892,
+        "y": 416
+    },
+    "looks_seteffectto": {
+        "opcode": "looks_seteffectto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {
+            "EFFECT": [
+                "COLOR",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 902,
+        "y": 527
+    },
+    "looks_cleargraphiceffects": {
+        "opcode": "looks_cleargraphiceffects",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 902,
+        "y": 638
+    },
+    "looks_show": {
+        "opcode": "looks_show",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 908,
+        "y": 758
+    },
+    "looks_hide": {
+        "opcode": "looks_hide",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 455,
+        "y": 861
+    },
+    "looks_gotofrontback": {
+        "opcode": "looks_gotofrontback",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "FRONT_BACK": [
+                "front",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 853,
+        "y": 878
+    },
+    "looks_goforwardbackwardlayers": {
+        "opcode": "looks_goforwardbackwardlayers",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "FORWARD_BACKWARD": [
+                "forward",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 851,
+        "y": 999
+    },
+    "looks_costumenumbername": {
+        "opcode": "looks_costumenumbername",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "NUMBER_NAME": [
+                "number",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 458,
+        "y": 1007
+    },
+    "looks_backdropnumbername": {
+        "opcode": "looks_backdropnumbername",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "NUMBER_NAME": [
+                "number",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 1242,
+        "y": 753
+    },
+    "looks_size": {
+        "opcode": "looks_size",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1249,
+        "y": 876
+    }
+}

v2/scratch_agent/blocks/classwise_blocks/motion_block.json

@@ -0,0 +1,370 @@
+{
+    "motion_movesteps": {
+        "opcode": "motion_movesteps",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STEPS": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 464,
+        "y": -416
+    },
+    "motion_turnright": {
+        "opcode": "motion_turnright",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DEGREES": [
+                1,
+                [
+                    4,
+                    "15"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 467,
+        "y": -316
+    },
+    "motion_turnleft": {
+        "opcode": "motion_turnleft",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DEGREES": [
+                1,
+                [
+                    4,
+                    "15"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 464,
+        "y": -210
+    },
+    "motion_goto": {
+        "opcode": "motion_goto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TO": [
+                1,
+                "motion_goto_menu"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 465,
+        "y": -95
+    },
+    "motion_goto_menu": {
+        "opcode": "motion_goto_menu",
+        "next": null,
+        "parent": "motion_goto",
+        "inputs": {},
+        "fields": {
+            "TO": [
+                "_random_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "motion_gotoxy": {
+        "opcode": "motion_gotoxy",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "X": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ],
+            "Y": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 468,
+        "y": 12
+    },
+    "motion_glideto": {
+        "opcode": "motion_glideto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SECS": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ],
+            "TO": [
+                1,
+                "motion_glideto_menu"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 470,
+        "y": 129
+    },
+    "motion_glideto_menu": {
+        "opcode": "motion_glideto_menu",
+        "next": null,
+        "parent": "motion_glideto",
+        "inputs": {},
+        "fields": {
+            "TO": [
+                "_random_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "motion_glidesecstoxy": {
+        "opcode": "motion_glidesecstoxy",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SECS": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ],
+            "X": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ],
+            "Y": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 476,
+        "y": 239
+    },
+    "motion_pointindirection": {
+        "opcode": "motion_pointindirection",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DIRECTION": [
+                1,
+                [
+                    8,
+                    "90"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 493,
+        "y": 361
+    },
+    "motion_pointtowards": {
+        "opcode": "motion_pointtowards",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TOWARDS": [
+                1,
+                "6xQl1pPk%9E~Znhm*:ng"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 492,
+        "y": 463
+    },
+    "motion_pointtowards_menu": {
+        "opcode": "motion_pointtowards_menu",
+        "next": null,
+        "parent": "Ucm$YBs*^9GFTGXCbal@",
+        "inputs": {},
+        "fields": {
+            "TOWARDS": [
+                "_mouse_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "motion_changexby": {
+        "opcode": "motion_changexby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DX": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 851,
+        "y": -409
+    },
+    "motion_setx": {
+        "opcode": "motion_setx",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "X": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 864,
+        "y": -194
+    },
+    "motion_changeyby": {
+        "opcode": "motion_changeyby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DY": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 861,
+        "y": -61
+    },
+    "motion_sety": {
+        "opcode": "motion_sety",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "Y": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 864,
+        "y": 66
+    },
+    "motion_ifonedgebounce": {
+        "opcode": "motion_ifonedgebounce",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1131,
+        "y": -397
+    },
+    "motion_setrotationstyle": {
+        "opcode": "motion_setrotationstyle",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "STYLE": [
+                "left-right",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 1128,
+        "y": -287
+    },
+    "motion_xposition": {
+        "opcode": "motion_xposition",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1193,
+        "y": -136
+    },
+    "motion_yposition": {
+        "opcode": "motion_yposition",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1181,
+        "y": -64
+    },
+    "motion_direction": {
+        "opcode": "motion_direction",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1188,
+        "y": 21
+    }
+}

v2/scratch_agent/blocks/classwise_blocks/operator_block.json

@@ -0,0 +1,409 @@
+{
+    "operator_add": {
+        "opcode": "operator_add",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 128,
+        "y": 153
+    },
+    "operator_subtract": {
+        "opcode": "operator_subtract",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 134,
+        "y": 214
+    },
+    "operator_multiply": {
+        "opcode": "operator_multiply",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 134,
+        "y": 278
+    },
+    "operator_divide": {
+        "opcode": "operator_divide",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 138,
+        "y": 359
+    },
+    "operator_random": {
+        "opcode": "operator_random",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "FROM": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ],
+            "TO": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 311,
+        "y": 157
+    },
+    "operator_gt": {
+        "opcode": "operator_gt",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OPERAND1": [
+                1,
+                [
+                    10,
+                    ""
+                ]
+            ],
+            "OPERAND2": [
+                1,
+                [
+                    10,
+                    "50"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 217
+    },
+    "operator_lt": {
+        "opcode": "operator_lt",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OPERAND1": [
+                1,
+                [
+                    10,
+                    ""
+                ]
+            ],
+            "OPERAND2": [
+                1,
+                [
+                    10,
+                    "50"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 345,
+        "y": 286
+    },
+    "operator_equals": {
+        "opcode": "operator_equals",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OPERAND1": [
+                1,
+                [
+                    10,
+                    ""
+                ]
+            ],
+            "OPERAND2": [
+                1,
+                [
+                    10,
+                    "50"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 345,
+        "y": 372
+    },
+    "operator_and": {
+        "opcode": "operator_and",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 701,
+        "y": 158
+    },
+    "operator_or": {
+        "opcode": "operator_or",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 705,
+        "y": 222
+    },
+    "operator_not": {
+        "opcode": "operator_not",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 734,
+        "y": 283
+    },
+    "operator_join": {
+        "opcode": "operator_join",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STRING1": [
+                1,
+                [
+                    10,
+                    "apple "
+                ]
+            ],
+            "STRING2": [
+                1,
+                [
+                    10,
+                    "banana"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 663,
+        "y": 378
+    },
+    "operator_letter_of": {
+        "opcode": "operator_letter_of",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "LETTER": [
+                1,
+                [
+                    6,
+                    "1"
+                ]
+            ],
+            "STRING": [
+                1,
+                [
+                    10,
+                    "apple"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 664,
+        "y": 445
+    },
+    "operator_length": {
+        "opcode": "operator_length",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STRING": [
+                1,
+                [
+                    10,
+                    "apple"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 664,
+        "y": 521
+    },
+    "operator_contains": {
+        "opcode": "operator_contains",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STRING1": [
+                1,
+                [
+                    10,
+                    "apple"
+                ]
+            ],
+            "STRING2": [
+                1,
+                [
+                    10,
+                    "a"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 634,
+        "y": 599
+    },
+    "operator_mod": {
+        "opcode": "operator_mod",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 295,
+        "y": 594
+    },
+    "operator_round": {
+        "opcode": "operator_round",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 307,
+        "y": 674
+    },
+    "operator_mathop": {
+        "opcode": "operator_mathop",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {
+            "OPERATOR": [
+                "abs",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 280,
+        "y": 754
+    }
+}

v2/scratch_agent/blocks/classwise_blocks/sensing_block.json

@@ -0,0 +1,292 @@
+{
+    "sensing_touchingobject": {
+        "opcode": "sensing_touchingobject",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TOUCHINGOBJECTMENU": [
+                1,
+                "sensing_touchingobjectmenu"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 359,
+        "y": 116
+    },
+    "sensing_touchingobjectmenu": {
+        "opcode": "sensing_touchingobjectmenu",
+        "next": null,
+        "parent": "sensing_touchingobject",
+        "inputs": {},
+        "fields": {
+            "TOUCHINGOBJECTMENU": [
+                "_mouse_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sensing_touchingcolor": {
+        "opcode": "sensing_touchingcolor",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "COLOR": [
+                1,
+                [
+                    9,
+                    "#55b888"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 360,
+        "y": 188
+    },
+    "sensing_coloristouchingcolor": {
+        "opcode": "sensing_coloristouchingcolor",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "COLOR": [
+                1,
+                [
+                    9,
+                    "#d019f2"
+                ]
+            ],
+            "COLOR2": [
+                1,
+                [
+                    9,
+                    "#2b0de3"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 277
+    },
+    "sensing_askandwait": {
+        "opcode": "sensing_askandwait",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "QUESTION": [
+                1,
+                [
+                    10,
+                    "What's your name?"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 338,
+        "y": 354
+    },
+    "sensing_answer": {
+        "opcode": "sensing_answer",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 782,
+        "y": 111
+    },
+    "sensing_keypressed": {
+        "opcode": "sensing_keypressed",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "KEY_OPTION": [
+                1,
+                "sensing_keyoptions"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 762,
+        "y": 207
+    },
+    "sensing_keyoptions": {
+        "opcode": "sensing_keyoptions",
+        "next": null,
+        "parent": "sensing_keypressed",
+        "inputs": {},
+        "fields": {
+            "KEY_OPTION": [
+                "space",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sensing_mousedown": {
+        "opcode": "sensing_mousedown",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 822,
+        "y": 422
+    },
+    "sensing_mousex": {
+        "opcode": "sensing_mousex",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 302,
+        "y": 528
+    },
+    "sensing_mousey": {
+        "opcode": "sensing_mousey",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 668,
+        "y": 547
+    },
+    "sensing_setdragmode": {
+        "opcode": "sensing_setdragmode",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "DRAG_MODE": [
+                "draggable",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 950,
+        "y": 574
+    },
+    "sensing_loudness": {
+        "opcode": "sensing_loudness",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 658,
+        "y": 703
+    },
+    "sensing_timer": {
+        "opcode": "sensing_timer",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 459,
+        "y": 671
+    },
+    "sensing_resettimer": {
+        "opcode": "sensing_resettimer",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 462,
+        "y": 781
+    },
+    "sensing_of": {
+        "opcode": "sensing_of",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OBJECT": [
+                1,
+                "sensing_of_object_menu"
+            ]
+        },
+        "fields": {
+            "PROPERTY": [
+                "backdrop #",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 997,
+        "y": 754
+    },
+    "sensing_of_object_menu": {
+        "opcode": "sensing_of_object_menu",
+        "next": null,
+        "parent": "sensing_of",
+        "inputs": {},
+        "fields": {
+            "OBJECT": [
+                "_stage_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sensing_current": {
+        "opcode": "sensing_current",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "CURRENTMENU": [
+                "YEAR",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 627,
+        "y": 884
+    },
+    "sensing_dayssince2000": {
+        "opcode": "sensing_dayssince2000",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 959,
+        "y": 903
+    },
+    "sensing_username": {
+        "opcode": "sensing_username",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 833,
+        "y": 757
+    }
+}

v2/scratch_agent/blocks/classwise_blocks/sound_block.json

@@ -0,0 +1,167 @@
+{
+    "sound_playuntildone": {
+        "opcode": "sound_playuntildone",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SOUND_MENU": [
+                1,
+                "sound_sounds_menu"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 253,
+        "y": 17
+    },
+    "sound_sounds_menu": {
+        "opcode": "sound_sounds_menu",
+        "next": null,
+        "parent": "sound_playuntildone and sound_play",
+        "inputs": {},
+        "fields": {
+            "SOUND_MENU": [
+                "Meow",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sound_play": {
+        "opcode": "sound_play",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SOUND_MENU": [
+                1,
+                "sound_sounds_menu"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 245,
+        "y": 122
+    },
+    "sound_stopallsounds": {
+        "opcode": "sound_stopallsounds",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 253,
+        "y": 245
+    },
+    "sound_changeeffectby": {
+        "opcode": "sound_changeeffectby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {
+            "EFFECT": [
+                "PITCH",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 653,
+        "y": 14
+    },
+    "sound_seteffectto": {
+        "opcode": "sound_seteffectto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "100"
+                ]
+            ]
+        },
+        "fields": {
+            "EFFECT": [
+                "PITCH",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 653,
+        "y": 139
+    },
+    "sound_cleareffects": {
+        "opcode": "sound_cleareffects",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 651,
+        "y": 242
+    },
+    "sound_changevolumeby": {
+        "opcode": "sound_changevolumeby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VOLUME": [
+                1,
+                [
+                    4,
+                    "-10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 645,
+        "y": 353
+    },
+    "sound_setvolumeto": {
+        "opcode": "sound_setvolumeto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VOLUME": [
+                1,
+                [
+                    4,
+                    "100"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1108,
+        "y": 5
+    },
+    "sound_volume": {
+        "opcode": "sound_volume",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1136,
+        "y": 123
+    }
+}

v2/scratch_agent/blocks/hat_blocks.json

@@ -0,0 +1,217 @@
+{
+  "block_category": "Hat Blocks",
+  "description": "Hat blocks are characterized by a rounded top and a bump at the bottom. They initiate scripts, meaning they are the starting point for a sequence of interconnected blocks.",
+  "blocks": [
+    {
+      "block_name": "when green flag pressed",
+      "block_type": "Events",
+      "op_code": "event_whenflagclicked",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block initiates the script when the green flag is clicked, serving as the common starting point for most Scratch projects.",
+      "inputs": null,
+      "example_standalone": "when green flag clicked",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  go to x: (0) y: (0)\n  say [Hello!] for (2) seconds\nend",
+          "explanation": "This script makes the sprite go to the center of the stage and then say 'Hello!' for 2 seconds when the green flag is clicked."
+        }
+      ]
+    },
+    {
+      "block_name": "when () key pressed",
+      "block_type": "Events",
+      "op_code": "event_whenkeypressed",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block initiates the script when a specified keyboard key is pressed.",
+      "inputs": [
+        {
+          "name": "key",
+          "type": "dropdown",
+          "options": [
+            "space",
+            "up arrow",
+            "down arrow",
+            "right arrow",
+            "left arrow",
+            "any",
+            "a",
+            "b",
+            "c",
+            "d",
+            "e",
+            "f",
+            "g",
+            "h",
+            "i",
+            "j",
+            "k",
+            "l",
+            "m",
+            "n",
+            "o",
+            "p",
+            "q",
+            "r",
+            "s",
+            "t",
+            "u",
+            "v",
+            "w",
+            "x",
+            "y",
+            "z",
+            "0",
+            "1",
+            "2",
+            "3",
+            "4",
+            "5",
+            "6",
+            "7",
+            "8",
+            "9"
+          ]
+        }
+      ],
+      "example_standalone": "when [space v] key pressed",
+      "example_with_other_blocks": [
+        {
+          "script": "when [space v] key pressed\n  repeat (10)\n    change y by (10)\n    wait (0.1) seconds\n    change y by (-10)\n  end",
+          "explanation": "This script makes the sprite jump when the spacebar is pressed."
+        },
+        {
+          "script": "when [right arrow v] key pressed\n  point in direction (90)\n  move (10) steps\nend",
+          "explanation": "This script moves the sprite right when the right arrow key is pressed."
+        }
+      ]
+    },
+    {
+      "block_name": "when this sprite clicked",
+      "block_type": "Events",
+      "op_code": "event_whenthisspriteclicked",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block starts the script when the sprite itself is clicked.",
+      "inputs": null,
+      "example_standalone": "when this sprite clicked",
+      "example_with_other_blocks": [
+        {
+          "script": "when this sprite clicked\n  say [Ouch!] for (1) seconds\n  change [score v] by (-1)\nend",
+          "explanation": "This script makes the sprite say 'Ouch!' and decreases the score by 1 when the sprite is clicked."
+        }
+      ]
+    },
+    {
+      "block_name": "when backdrop switches to ()",
+      "block_type": "Events",
+      "op_code": "event_whenbackdropswitchesto",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block triggers the script when the stage backdrop changes to a specified backdrop.",
+      "inputs": [
+        {
+          "name": "backdrop name",
+          "type": "dropdown",
+          "options": ["backdrop1", "backdrop2", "..."]
+        }
+      ],
+      "example_standalone": "when backdrop switches to [game over v]",
+      "example_with_other_blocks": [
+        {
+          "script": "when backdrop switches to [game over v]\n  stop [all v]\nend",
+          "explanation": "This script stops all running processes when the backdrop changes to 'game over'."
+        },
+        {
+          "script": "when backdrop switches to [level completed v]\n  stop [all v]\nend",
+          "explanation": "This script stops all running processes when the backdrop changes to 'level completed'."
+        }
+      ]
+    },
+    {
+      "block_name": "when () > ()",
+      "block_type": "Events",
+      "op_code": "event_whengreaterthan",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block starts the script when a certain value (e.g., loudness from a microphone, or the timer) exceeds a defined threshold.",
+      "inputs": [
+        {
+          "name": "value type",
+          "type": "dropdown",
+          "options": [
+            "loudness",
+            "timer"
+          ]
+        },
+        {
+          "name": "threshold",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "when [loudness v] > (70)",
+      "example_with_other_blocks": [
+        {
+          "script": "when [loudness v] > (70)\n  start sound [scream v]\nend",
+          "explanation": "This script starts a 'scream' sound when the microphone loudness exceeds 70."
+        }
+      ]
+    },
+    {
+      "block_name": "when I receive ()",
+      "block_type": "Events",
+      "op_code": "event_whenbroadcastreceived",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block initiates the script upon the reception of a specific broadcast message. This mechanism facilitates indirect communication between sprites or the stage.",
+      "inputs": [
+        {
+          "name": "message name",
+          "type": "dropdown",
+          "options": ["message1", "message2", "new message..."]
+        }
+      ],
+      "example_standalone": "when I receive [start game v]",
+      "example_with_other_blocks": [
+        {
+          "script": "when I receive [start game v]\n  show\n  go to x: (0) y: (0)\nend",
+          "explanation": "This script makes the sprite visible and moves it to the center of the stage when it receives the 'start game' broadcast."
+        },
+        {
+          "script": "when I receive [game over v]\n  set score to 0\n  stop [all v]\nend",
+          "explanation": "This script stops all and resets the score on stage when it receives the 'game over' broadcast."
+        }
+      ]
+    },
+    {
+      "block_name": "When I Start as a Clone",
+      "block_type": "Control",
+      "op_code": "control_start_as_clone",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block initiates the script when a clone of the sprite is created. It defines the behavior of individual clones.",
+      "inputs": null,
+      "example_standalone": "When I Start as a Clone",
+      "example_with_other_blocks": [
+        {
+          "script": "when I start as a clone\n  go to x: (pick random -240 to 240) y: (pick random -180 to 180)\n  show\n  forever\n    move (10) steps\n    if on edge, bounce\n  end\nend",
+          "explanation": "This script makes a newly created clone appear at a random position, become visible, and then continuously move 10 steps, bouncing if it hits an edge."
+        }
+      ]
+    },
+    {
+      "block_name": "define [my custom block]",
+      "block_type": "My Blocks",
+      "op_code": "procedures_definition",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block serves as the definition header for a custom block's script. It allows users to define reusable sequences of code by specifying the block's name and any input parameters it will accept. This promotes modularity and abstraction in projects.",
+      "inputs": [
+        {
+          "name": "PROCCONTAINER",
+          "type": "block_prototype"
+        }
+      ],
+      "example_standalone": "define jump (height)",
+      "example_with_other_blocks": [
+        {
+          "script": "define jump (height)\n  change y by (height)\n  wait (0.5) seconds\n  change y by (0 - (height))\nend\n\nwhen green flag clicked\n  jump (50)\nend",
+          "explanation": "This script first defines a custom block named 'jump' that takes a numerical input 'height'. The definition outlines the actions for jumping up and then down. Later, 'jump (50)' is called to make the sprite jump 50 units."
+        }
+      ]
+    }
+  ]
+}

v2/scratch_agent/blocks/reporter_blocks.json

@@ -0,0 +1,709 @@
+{
+  "block_category": "Reporter Blocks",
+  "description": "Reporter blocks have rounded edges. Their purpose is to report values, which can be numbers or strings, and are designed to fit into input slots of other blocks.",
+  "blocks": [
+    {
+      "block_name": "(x position)",
+      "block_type": "Motion",
+      "op_code": "motion_xposition",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current X-coordinate of the sprite.[NOTE: not used in stage/backdrops]",
+      "inputs": null,
+      "example_standalone": "x position",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  say (x position) for (2) seconds\nend",
+          "explanation": "This script makes the sprite say its current X-coordinate for 2 seconds."
+        }
+      ]
+    },
+    {
+      "block_name": "(y position)",
+      "block_type": "Motion",
+      "op_code": "motion_yposition",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current Y coordinate of the sprite on the stage.[NOTE: not used in stage/backdrops]",
+      "inputs": null,
+      "example_standalone": "y position",
+      "example_with_other_blocks": [
+        {
+          "script": "set [worms v] to (y position)",
+          "explanation": "This script assigns the sprite's current Y position to the 'worms' variable."
+        }
+      ]
+    },
+    {
+      "block_name": "(direction)",
+      "block_type": "Motion",
+      "op_code": "motion_direction",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current direction of the sprite in degrees (0 = up, 90 = right, 180 = down, -90 = left).[NOTE: not used in stage/backdrops]",
+      "inputs": null,
+      "example_standalone": "direction",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  say (direction) for (2) seconds\nend",
+          "explanation": "This script makes the sprite say its current direction in degrees for 2 seconds."
+        }
+      ]
+    },
+    {
+      "block_name": "(costume ())",
+      "block_type": "Looks",
+      "op_code": "looks_costumenumbername",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current costume's number or name.",
+      "inputs": [
+        {
+          "name": "NUMBER_NAME",
+          "type": "dropdown",
+          "options": [
+            "number",
+            "name"
+          ]
+        }
+      ],
+      "example_standalone": "costume [number v]",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [I am costume ] (costume [name v])",
+          "explanation": "This script makes the sprite display its current costume name in a speech bubble."
+        }
+      ]
+    },
+    {
+      "block_name": "(size)",
+      "block_type": "Looks",
+      "op_code": "looks_size",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current size of the sprite as a percentage.",
+      "inputs": null,
+      "example_standalone": "size",
+      "example_with_other_blocks": [
+        {
+          "script": "set size to ( (size) + (10) )",
+          "explanation": "This script increases the sprite's size by 10% from its current size."
+        }
+      ]
+    },
+    {
+      "block_name": "(backdrop ())",
+      "block_type": "Looks",
+      "op_code": "looks_backdropnumbername",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current backdrop's number or name.",
+      "inputs": [
+        {
+          "name": "NUMBER_NAME",
+          "type": "dropdown",
+          "options": [
+            "number",
+            "name"
+          ]
+        }
+      ],
+      "example_standalone": "(backdrop [number v])",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [Current backdrop: ] (backdrop [name v]) for (2) seconds",
+          "explanation": "This script makes the sprite say the name of the current stage backdrop for 2 seconds."
+        }
+      ]
+    },
+    {
+      "block_name": "(volume)",
+      "block_type": "Sound",
+      "op_code": "sound_volume",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current volume level of the sprite.",
+      "inputs": null,
+      "example_standalone": "volume",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [Current volume: ] (volume)",
+          "explanation": "This script makes the sprite display its current volume level in a speech bubble."
+        }
+      ]
+    },
+    {
+      "block_name": "(distance to ())",
+      "block_type": "Sensing",
+      "op_code": "sensing_distanceto",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the distance from the current sprite to the mouse-pointer or another specified sprite.",
+      "inputs": [
+        {
+          "name": "target",
+          "type": "dropdown",
+          "options": ["mouse-pointer", "Sprite1", "Sprite2", "...", "_edge_"]
+        }
+      ],
+      "example_standalone": "distance to [mouse-pointer v]",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(distance to [Sprite2 v]) < (50)> then\n  say [Too close!]\nend",
+          "explanation": "This script makes the sprite say 'Too close!' if it is less than 50 steps away from 'Sprite2'."
+        }
+      ]
+    },
+    {
+      "block_name": "(answer)",
+      "block_type": "Sensing",
+      "op_code": "sensing_answer",
+      "block_shape": "Reporter Block",
+      "functionality": "Holds the most recent text inputted using the 'Ask () and Wait' block.",
+      "inputs": null,
+      "example_standalone": "answer",
+      "example_with_other_blocks": [
+        {
+          "script": "ask [What is your name?] and wait\n  say join [Hello ] (answer)",
+          "explanation": "This script prompts the user for their name and then uses the 'answer' block to incorporate their input into a greeting."
+        }
+      ]
+    },
+    {
+      "block_name": "(mouse x)",
+      "block_type": "Sensing",
+      "op_code": "sensing_mousex",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the mouse-pointer’s current X position on the stage.",
+      "inputs": null,
+      "example_standalone": "mouse x",
+      "example_with_other_blocks": [
+        {
+          "script": "go to x: (mouse x) y: (mouse y)",
+          "explanation": "This script makes the sprite follow the mouse pointer's X and Y coordinates."
+        }
+      ]
+    },
+    {
+      "block_name": "(mouse y)",
+      "block_type": "Sensing",
+      "op_code": "sensing_mousey",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the mouse-pointer’s current Y position on the stage.",
+      "inputs": null,
+      "example_standalone": "mouse y",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(mouse y) < (0)> then\n  say [Below center]",
+          "explanation": "This script makes the sprite say 'Below center' if the mouse pointer is in the lower half of the stage."
+        }
+      ]
+    },
+    {
+      "block_name": "(loudness)",
+      "block_type": "Sensing",
+      "op_code": "sensing_loudness",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the loudness of noise received by a microphone on a scale of 0 to 100.",
+      "inputs": null,
+      "example_standalone": "loudness",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  forever\n    if <(loudness) > (30)> then\n      start sound [pop v]\nend",
+          "explanation": "This script continuously checks the microphone loudness and plays a 'pop' sound if it exceeds 30."
+        }
+      ]
+    },
+    {
+      "block_name": "(timer)",
+      "block_type": "Sensing",
+      "op_code": "sensing_timer",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the elapsed time since Scratch was launched or the timer was reset, increasing by 1 every second.",
+      "inputs": null,
+      "example_standalone": "timer",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  reset timer\n  wait (5) seconds\n  say join [Time elapsed: ] (timer)",
+          "explanation": "This script resets the timer when the green flag is clicked, waits for 5 seconds, and then reports the elapsed time."
+        }
+      ]
+    },
+    {
+      "block_name": "(() of ())",
+      "block_type": "Sensing",
+      "op_code": "sensing_of",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports a specified value (e.g., x position, direction, costume number) of a specified sprite or the Stage to be accessed in current sprite or stage.",
+      "inputs": [
+        {
+          "name": "value to report",
+          "type": "dropdown",
+          "options": [
+            "x position",
+            "y position",
+            "direction",
+            "costume #",
+            "costume name",
+            "size",
+            "volume",
+            "backdrop #",
+            "backdrop name"
+          ]
+        },
+        {
+          "name": "sprite/stage",
+          "type": "dropdown",
+          "options": ["Stage", "Sprite1", "Sprite2", "...", "_edge_"]
+        }
+      ],
+      "example_standalone": "x position of [Sprite1 v]",
+      "example_with_other_blocks": [
+        {
+          "script": "set [other sprite X v] to ( (x position) of [Sprite2 v] )",
+          "explanation": "This script sets the 'other sprite X' variable to the current X-position of 'Sprite2'."
+        }
+      ]
+    },
+    {
+      "block_name": "(current ())",
+      "block_type": "Sensing",
+      "op_code": "sensing_current",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current local year, month, date, day of the week, hour, minutes, or seconds.",
+      "inputs": [
+        {
+          "name": "time unit",
+          "type": "dropdown",
+          "options": [
+            "year",
+            "month",
+            "date",
+            "day of week",
+            "hour",
+            "minute",
+            "second"
+          ]
+        }
+      ],
+      "example_standalone": "current [hour v]",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [The current hour is ] (current [hour v])",
+          "explanation": "This script makes the sprite say the current hour."
+        }
+      ]
+    },
+    {
+      "block_name": "(days since 2000)",
+      "block_type": "Sensing",
+      "op_code": "sensing_dayssince2000",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the number of days (and fractions of a day) since 00:00:00 UTC on January 1, 2000.",
+      "inputs": null,
+      "example_standalone": "days since 2000",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [Days passed: ] (days since 2000)",
+          "explanation": "This script makes the sprite display the number of days that have passed since January 1, 2000."
+        }
+      ]
+    },
+    {
+      "block_name": "(username)",
+      "block_type": "Sensing",
+      "op_code": "sensing_username",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the username of the user currently logged into Scratch. If no user is logged in, it reports nothing.",
+      "inputs": null,
+      "example_standalone": "username",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [Hello, ] (username)",
+          "explanation": "This script makes the sprite greet the user by their Scratch username."
+        }
+      ]
+    },
+    {
+      "block_name": "(() + ())",
+      "block_type": "operator",
+      "op_code": "operator_add",
+      "block_shape": "Reporter Block",
+      "functionality": "Adds two numerical values.",
+      "inputs": [
+        {
+          "name": "number1",
+          "type": "number"
+        },
+        {
+          "name": "number2",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "(5) + (3)",
+      "example_with_other_blocks": [
+        {
+          "script": "set [total v] to ( (number 1) + (number 2) )",
+          "explanation": "This script calculates the sum of 'number 1' and 'number 2' and stores the result in the 'total' variable."
+        }
+      ]
+    },
+    {
+      "block_name": "(() - ())",
+      "block_type": "operator",
+      "op_code": "operator_subtract",
+      "block_shape": "Reporter Block",
+      "functionality": "Subtracts the second numerical value from the first.",
+      "inputs": [
+        {
+          "name": "number1",
+          "type": "number"
+        },
+        {
+          "name": "number2",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "((10) - (4))",
+      "example_with_other_blocks": [
+        {
+          "script": "set [difference v] to ( (number 1) - (number 2) )",
+          "explanation": "This script calculates the subtraction of 'number 2' from 'number 1' and stores the result in the 'difference' variable."
+        }
+      ]
+    },
+    {
+      "block_name": "(() * ())",
+      "block_type": "operator",
+      "op_code": "operator_multiply",
+      "block_shape": "Reporter Block",
+      "functionality": "Multiplies two numerical values.",
+      "inputs": [
+        {
+          "name": "number1",
+          "type": "number"
+        },
+        {
+          "name": "number2",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "(6) * (7)",
+      "example_with_other_blocks": [
+        {
+          "script": "set [area v] to ( (length) * (width) )",
+          "explanation": "This script calculates the area by multiplying 'length' and 'width' variables and stores it in the 'area' variable."
+        }
+      ]
+    },
+    {
+      "block_name": "(() / ())",
+      "block_type": "operator",
+      "op_code": "operator_divide",
+      "block_shape": "Reporter Block",
+      "functionality": "Divides the first numerical value by the second.",
+      "inputs": [
+        {
+          "name": "number1",
+          "type": "number"
+        },
+        {
+          "name": "number2",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "((20) / (5))",
+      "example_with_other_blocks": [
+        {
+          "script": "set [average v] to ( (total score) / (number of students) )",
+          "explanation": "This script calculates the average by dividing 'total score' by 'number of students' and stores it in the 'average' variable."
+        }
+      ]
+    },
+    {
+      "block_name": "(pick random () to ())",
+      "block_type": "operator",
+      "op_code": "operator_random",
+      "block_shape": "Reporter Block",
+      "functionality": "Generates a random integer within a specified inclusive range.",
+      "inputs": [
+        {
+          "name": "min",
+          "type": "number"
+        },
+        {
+          "name": "max",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "(pick random (1) to (10))",
+      "example_with_other_blocks": [
+        {
+          "script": "go to x: (pick random -240 to 240) y: (pick random -180 to 180)",
+          "explanation": "This script moves the sprite to a random position on the stage."
+        }
+      ]
+    },
+    {
+      "block_name": "(join ()())",
+      "block_type": "operator",
+      "op_code": "operator_join",
+      "block_shape": "Reporter Block",
+      "functionality": "Concatenates two strings or values into a single string.",
+      "inputs": [
+        {
+          "name": "string1",
+          "type": "string/number"
+        },
+        {
+          "name": "string2",
+          "type": "string/number"
+        }
+      ],
+      "example_standalone": "(join [Hello ][World!])",
+      "example_with_other_blocks": [
+        {
+          "script": "say (join [Hello ][World!])",
+          "explanation": "This script makes the sprite display 'Hello World!' in a speech bubble by joining two string literals."
+        }
+      ]
+    },
+    {
+      "block_name": "letter () of ()",
+      "block_type": "operator",
+      "op_code": "operator_letterof",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the character at a specific numerical position within a string.",
+      "inputs": [
+        {
+          "name": "index",
+          "type": "number"
+        },
+        {
+          "name": "text",
+          "type": "string"
+        }
+      ],
+      "example_standalone": "(letter (1) of [apple])",
+      "example_with_other_blocks": [
+        {
+          "script": "say (letter (1) of [apple])",
+          "explanation": "This script makes the sprite display the first character of the string 'apple', which is 'a'."
+        }
+      ]
+    },
+    {
+      "block_name": "(length of ())",
+      "block_type": "operator",
+      "op_code": "operator_length",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the total number of characters in a given string.",
+      "inputs": [
+        {
+          "name": "text",
+          "type": "string"
+        }
+      ],
+      "example_standalone": "(length of [banana])",
+      "example_with_other_blocks": [
+        {
+          "script": "say (length of [banana])",
+          "explanation": "This script makes the sprite display the length of the string 'banana', which is 6."
+        }
+      ]
+    },
+    {
+      "block_name": "(() mod ())",
+      "block_type": "operator",
+      "op_code": "operator_mod",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the remainder when the first number is divided by the second.",
+      "inputs": [
+        {
+          "name": "number1",
+          "type": "number"
+        },
+        {
+          "name": "number2",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "((10) mod (3))",
+      "example_with_other_blocks": [
+        {
+          "script": "if <([number v] mod (2) = (0))> then\n  say [Even number]",
+          "explanation": "This script checks if a 'number' variable is even by checking if its remainder when divided by 2 is 0."
+        }
+      ]
+    },
+    {
+      "block_name": "(round ())",
+      "block_type": "operator",
+      "op_code": "operator_round",
+      "block_shape": "Reporter Block",
+      "functionality": "Rounds a numerical value to the nearest integer.",
+      "inputs": [
+        {
+          "name": "number",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "(round (3.7))",
+      "example_with_other_blocks": [
+        {
+          "script": "set [rounded score v] to (round (score))",
+          "explanation": "This script rounds the 'score' variable to the nearest whole number and stores it in 'rounded score'."
+        }
+      ]
+    },
+    {
+      "block_name": "(() of ())",
+      "block_type": "operator",
+      "op_code": "operator_mathop",
+      "block_shape": "Reporter Block",
+      "functionality": "Performs various mathematical functions (e.g., absolute value, square root, trigonometric functions).",
+      "inputs": [
+        {
+          "name": "function type",
+          "type": "dropdown",
+          "options": [
+            "abs",
+            "floor",
+            "ceiling",
+            "sqrt",
+            "sin",
+            "cos",
+            "tan",
+            "asin",
+            "acos",
+            "atan",
+            "ln",
+            "log",
+            "e ^",
+            "10 ^"
+          ]
+        },
+        {
+          "name": "value",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "([sqrt v] of (25))",
+      "example_with_other_blocks": [
+        {
+          "script": "set [distance v] to ([sqrt v] of ( ( (x position) * (x position) ) + ( (y position) * (y position) ) ))",
+          "explanation": "This script calculates the distance from the origin (0,0) using the Pythagorean theorem and stores it in 'distance'."
+        }
+      ]
+    },
+    {
+      "block_name": "[variable v]",
+      "block_type": "Data",
+      "op_code": "data_variable",
+      "block_shape": "Reporter Block",
+      "functionality": "Provides the current value stored in a variable.",
+      "inputs": [
+        {
+          "name": "variable name",
+          "type": "dropdown",
+          "options": ["my variable", "score", "..."]
+        }
+      ],
+      "example_standalone": "[score v]",
+      "example_with_other_blocks": [
+        {
+          "script": "say ([score v]) for (2) seconds",
+          "explanation": "This script makes the sprite say the current value of the 'score' variable for 2 seconds."
+        }
+      ]
+    },
+    {
+      "block_name": "[list v]",
+      "block_type": "Data",
+      "op_code": "data_list",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the entire content of a specified list. When clicked in the editor, it displays the list as a monitor.",
+      "inputs": [
+        {
+          "name": "list name",
+          "type": "dropdown",
+          "options": ["my list", "list2", "..."]
+        }
+      ],
+      "example_standalone": "[my list v]",
+      "example_with_other_blocks": [
+        {
+          "script": "say ([my list v]) ",
+          "explanation": "This script makes the sprite say all the contents of 'my list'."
+        }
+      ]
+    },
+    {
+      "block_name": "(item (2) of [myList v])",
+      "block_type": "Data",
+      "op_code": "data_itemoflist",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the item located at a specific position in a list.",
+      "inputs": [
+        {
+          "name": "index/option",
+          "type": "number or dropdown",
+          "options": [
+            "last",
+            "random"
+          ]
+        },
+        {
+          "name": "list name",
+          "type": "dropdown",
+          "options": ["shopping list", "my list", "..."]
+        }
+      ],
+      "example_standalone": "item (1) of [shopping list v]",
+      "example_with_other_blocks": [
+        {
+          "script": "say (item (2) of [myList v]) for 2 seconds ",
+          "explanation": "This script makes the sprite display the first item from the 'shopping list'."
+        }
+      ]
+    },
+    {
+      "block_name": "(length of [myList v])",
+      "block_type": "Data",
+      "op_code": "data_lengthoflist",
+      "block_shape": "Reporter Block",
+      "functionality": "Provides the total number of items contained in a list.",
+      "inputs": [
+        {
+          "name": "list name",
+          "type": "dropdown",
+          "options": ["my list", "shopping list", "..."]
+        }
+      ],
+      "example_standalone": "(length of [myList v])",
+      "example_with_other_blocks": [
+        {
+          "script": "say join (length of [shopping list v]) [ items in the list.]",
+          "explanation": "This script makes the sprite display the total number of items currently in the 'shopping list'."
+        }
+      ]
+    },
+    {
+      "block_name": "(item # of [Dog] in [myList v])",
+      "block_type": "Data",
+      "op_code": "data_itemnumoflist",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the index number of the first occurrence of a specified item in a list. If the item is not found, it reports 0.",
+      "inputs": [
+        {
+          "name": "item",
+          "type": "string/number"
+        },
+        {
+          "name": "list name",
+          "type": "dropdown",
+          "options": ["my list", "shopping list", "..."]
+        }
+      ],
+      "example_standalone": "(item # of [apple] in [shopping list v])",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(item # of [Dog] in [myList v])> (0)> then\n  say join [Dog found at position ] (item # of [Dog] in [my list v])",
+          "explanation": "This script checks if 'banana' is in 'my list' and, if so, reports its position."
+        }
+      ]
+    }
+  ]
+}

v2/scratch_agent/blocks/stack_blocks.json

@@ -0,0 +1,1321 @@
+{
+    "block_category": "Stack Blocks",
+    "description": "Stack blocks are the most common block shape, featuring a notch at the top and a bump at the bottom. They perform the main commands within a script and can connect both above and below them.",
+    "blocks": [
+        {
+            "block_name": "move () steps",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_movesteps",
+            "functionality": "Moves the sprite forward by the specified number of steps in the direction it is currently facing. A positive value moves it forward, and a negative value moves it backward.",
+            "inputs": [
+                {
+                    "name": "STEPS",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "move () steps",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  go to x: (0) y: (0)\n  point in direction (90)\n  move (50) steps\nend",
+                    "explanation": "This script first places the sprite at the center of the stage, points it to the right (90 degrees), and then moves it 50 steps in that direction."
+                }
+            ]
+        },
+        {
+            "block_name": "turn right () degrees",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_turnright",
+            "functionality": "Turns the sprite clockwise by the specified number of degrees.",
+            "inputs": [
+                {
+                    "name": "DEGREES",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "turn (clockwise icon) (15) degrees",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [right arrow v] key pressed\n  turn (clockwise icon) (15) degrees\nend",
+                    "explanation": "This script makes the sprite turn clockwise by 15 degrees every time the right arrow key is pressed."
+                },
+                {
+                    "script": "when green flag clicked\n  forever\n    turn (clockwise icon) (15) degrees\n    wait (0.5) seconds\n  end",
+                    "explanation": "This script makes the sprite continuously spin clockwise by 15 degrees every half second."
+                }
+            ]
+        },
+        {
+            "block_name": "turn left () degrees",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_turnleft",
+            "functionality": "Turns the sprite counter-clockwise by the specified number of degrees.",
+            "inputs": [
+                {
+                    "name": "DEGREES",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "turn (counter-clockwise icon) (15) degrees",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [left arrow v] key pressed\n  turn (counter-clockwise icon) (15) degrees\nend",
+                    "explanation": "This script makes the sprite turn counter-clockwise by 15 degrees every time the left arrow key is pressed."
+                },
+                {
+                    "script": "when green flag clicked\n  forever\n    turn (counter-clockwise icon) (15) degrees\n    wait (0.5) seconds\n  end\nend",
+                    "explanation": "This script makes the sprite continuously spin counter-clockwise by 15 degrees every half second."
+                }
+            ]
+        },
+        {
+            "block_name": "go to ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_goto",
+            "functionality": "Moves the sprite to a specified location, which can be a random position or at the mouse pointer or another to the sprite.",
+            "inputs": [
+                {
+                    "name": "TO",
+                    "type": "dropdown",
+                    "options": [
+                        "random position",
+                        "mouse-pointer",
+                        "sprite1",
+                        "..."
+                    ]
+                }
+            ],
+            "example_standalone": "go to [random position v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when this sprite clicked\n  go to [mouse-pointer v]",
+                    "explanation": "This script moves the sprite to the current position of the mouse pointer whenever the sprite is clicked."
+                },
+                {
+                    "script": "when this sprite clicked\n  go to [sprite v]",
+                    "explanation": "This script moves the sprite to the another sprite's position whenever the sprite is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "go to x: () y: ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_gotoxy",
+            "functionality": "Moves the sprite to the specified X and Y coordinates on the stage.",
+            "inputs": [
+                {
+                    "name": "X",
+                    "type": "number"
+                },
+                {
+                    "name": "Y",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "go to x: (0) y: (0)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  go to x: (120) y: (0)\n  say [Ready to start! v] for (1) seconds\nend",
+                    "explanation": "This script positions the sprite at the center of the stage at the beginning of the project and then makes it say 'Ready to start!'."
+                }
+            ]
+        },
+        {
+            "block_name": "glide () secs to ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_glideto",
+            "functionality": "Glides the sprite smoothly to a specified location (random position, mouse pointer, or another sprite) over a given number of seconds.",
+            "inputs": [
+                {
+                    "name": "SECS",
+                    "type": "number"
+                },
+                {
+                    "name": "TO",
+                    "type": "dropdown",
+                    "options": [
+                        "random position",
+                        "mouse-pointer",
+                        "sprite1",
+                        "sprite2",
+                        "..."
+                    ]
+                }
+            ],
+            "example_standalone": "glide (1) secs to ([random position v])",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  glide (1) secs to ([mouse-pointer v])\nend",
+                    "explanation": "This script makes the sprite glide smoothly to the mouse pointer's position over 1 second when the green flag is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "glide () secs to x: () y: ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_glidesecstoxy",
+            "functionality": "Glides the sprite smoothly to the specified X and Y coordinates over a given number of seconds.",
+            "inputs": [
+                {
+                    "name": "SECS",
+                    "type": "number"
+                },
+                {
+                    "name": "X",
+                    "type": "number"
+                },
+                {
+                    "name": "Y",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "glide (1) secs to x: (100) y: (50)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  glide (2) secs to x: (150) y: (-100)\n  glide (2) secs to x: (-150) y: (100)\nend",
+                    "explanation": "This script makes the sprite glide to two different points on the stage, taking 2 seconds for each movement."
+                }
+            ]
+        },
+        {
+            "block_name": "point in direction ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_pointindirection",
+            "functionality": "Sets the sprite's direction to a specified angle in degrees (0 = up, 90 = right, 180 = down, -90 = left).",
+            "inputs": [
+                {
+                    "name": "DIRECTION",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "point in direction (90)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  point in direction (0)\n  move (100) steps\nend",
+                    "explanation": "This script makes the sprite point upwards (0 degrees) and then move 100 steps in that direction."
+                }
+            ]
+        },
+        {
+            "block_name": "point towards ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_pointtowards",
+            "functionality": "Points the sprite towards the mouse pointer or another specified sprite.",
+            "inputs": [
+                {
+                    "name": "TOWARDS",
+                    "type": "dropdown",
+                    "options": [
+                        "mouse-pointer",
+                        "sprite1",
+                        "..."
+                    ]
+                }
+            ],
+            "example_standalone": "point towards [mouse-pointer v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when this sprite clicked\n  point towards [mouse-pointer v]\n  move (10) steps\nend",
+                    "explanation": "When the sprite is clicked, it will point towards the mouse pointer and then move 10 steps in that direction."
+                },
+                {
+                    "script": "when green flag clicked\n  forever\n    point towards [mouse-pointer v]\n    move (5) steps\n  end\nend",
+                    "explanation": "This script makes the sprite continuously follow the mouse pointer."
+                }
+            ]
+        },
+        {
+            "block_name": "change x by ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_changexby",
+            "functionality": "Changes the sprite's X-coordinate by the specified amount, moving it horizontally.",
+            "inputs": [
+                {
+                    "name": "DX",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "change x by (10)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [right arrow v] key pressed\n  change x by (10)\nend",
+                    "explanation": "This script moves the sprite 10 steps to the right when the right arrow key is pressed."
+                }
+            ]
+        },
+        {
+            "block_name": "set x to ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_setx",
+            "functionality": "Sets the sprite's X-coordinate to a specific value, placing it at a precise horizontal position.",
+            "inputs": [
+                {
+                    "name": "X",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "set x to (0)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  set x to (0)\n  set y to (0)\nend",
+                    "explanation": "This script centers the sprite horizontally at the start of the project."
+                }
+            ]
+        },
+        {
+            "block_name": "change y by ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_changeyby",
+            "functionality": "Changes the sprite's Y-coordinate by the specified amount, moving it vertically.",
+            "inputs": [
+                {
+                    "name": "DY",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "change y by (10)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [up arrow v] key pressed\n  change y by (10)\nend",
+                    "explanation": "This script moves the sprite 10 steps up when the up arrow key is pressed."
+                }
+            ]
+        },
+        {
+            "block_name": "set y to ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_sety",
+            "functionality": "Sets the sprite's Y-coordinate to a specific value, placing it at a precise vertical position.",
+            "inputs": [
+                {
+                    "name": "Y",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "set y to (0)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  set x to (0)\n  set y to (0)\nend",
+                    "explanation": "This script centers the sprite vertically at the start of the project."
+                }
+            ]
+        },
+        {
+            "block_name": "if on edge, bounce",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_ifonedgebounce",
+            "functionality": "Reverses the sprite's direction if it touches the edge of the stage.",
+            "inputs": null,
+            "example_standalone": "if on edge, bounce",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I receive [start moving v]\n  repeat (50)\n    move (5) steps\n    if on edge, bounce\n  end\nend",
+                    "explanation": "Upon receiving the 'start moving' broadcast, the sprite will move 5 steps repeatedly for 50 times, bouncing off edges if it touches them."
+                },
+                {
+                    "script": "when green flag clicked\n  forever\n    move (10) steps\n    if on edge, bounce\n  end\nend",
+                    "explanation": "This script makes the sprite move continuously and bounce off the edges of the stage."
+                }
+            ]
+        },
+        {
+            "block_name": "set rotation style ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_setrotationstyle",
+            "functionality": "Determines how the sprite rotates: 'left-right' (flips horizontally), 'don't rotate' (stays facing one direction), or 'all around' (rotates freely).",
+            "inputs": [
+                {
+                    "name": "STYLE",
+                    "type": "dropdown",
+                    "options": [
+                        "left-right",
+                        "don't rotate",
+                        "all around"
+                    ]
+                }
+            ],
+            "example_standalone": "set rotation style [left-right v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when backdrop switches to [game level 1 v]\n  set rotation style [all around v]\nend",
+                    "explanation": "When the backdrop changes to 'game level 1', the sprite's rotation style will be set to 'all around', allowing it to rotate freely."
+                },
+                {
+                    "script": "when green flag clicked\n  set rotation style [left-right v]\n  forever\n    move (10) steps\n    if on edge, bounce\n  end \nend",
+                    "explanation": "This script makes the sprite move horizontally and flip its costume when it hits an edge, instead of rotating."
+                }
+            ]
+        },
+        {
+            "block_name": "say () for () seconds",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_sayforsecs",
+            "functionality": "Displays a speech bubble containing specified text for a set duration.",
+            "inputs": [
+                {
+                    "name": "MESSAGE",
+                    "type": "string"
+                },
+                {
+                    "name": "SECS",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "say [Hello!] for (2) seconds",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   say [Grr] for (3) seconds\n   say [Have you seen my honey? v] for (3) seconds\nend",
+                    "explanation": "This script makes the sprite display two sequential speech bubbles with different messages and durations. First, it says 'Grr' for 3 seconds, then 'Have you seen my honey?' for another 3 seconds."
+                }
+            ]
+        },
+        {
+            "block_name": "say ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_say",
+            "functionality": "Displays a speech bubble with the specified text indefinitely until another 'say' or 'think' block is activated.",
+            "inputs": [
+                {
+                    "name": "MESSAGE",
+                    "type": "string"
+                }
+            ],
+            "example_standalone": "say [Hello! v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   say [Welcome to my game! v]\n   wait (2) seconds\n   say [] \nend",
+                    "explanation": "This script makes the sprite say 'Welcome to my game!' for 2 seconds, then clears the speech bubble."
+                }
+            ]
+        },
+        {
+            "block_name": "think () for () seconds",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_thinkforsecs",
+            "functionality": "Displays a thought bubble containing specified text for a set duration.",
+            "inputs": [
+                {
+                    "name": "MESSAGE",
+                    "type": "string"
+                },
+                {
+                    "name": "SECS",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "think [Hmm... v] for (2) seconds",
+            "example_with_other_blocks": [
+                {
+                    "script": "when this sprite clicked\n   think [What should I do? v] for (2) seconds\nend",
+                    "explanation": "This script makes the sprite display a thought bubble saying 'What should I do?' for 2 seconds when clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "think ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_think",
+            "functionality": "Displays a thought bubble with the specified text indefinitely until another 'say' or 'think' block is activated.",
+            "inputs": [
+                {
+                    "name": "MESSAGE",
+                    "type": "string"
+                }
+            ],
+            "example_standalone": "think [Got it! v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I receive [correct answer v]\n   think [That's right! v]\n   wait (1) seconds\n   think [good v] \nend",
+                    "explanation": "This script makes the sprite think 'That's right!' for 1 second when a 'correct answer' broadcast is received, then clears the thought bubble."
+                }
+            ]
+        },
+        {
+            "block_name": "switch costume to ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_switchcostumeto",
+            "functionality": "Alters the sprite's appearance to a designated costume.",
+            "inputs": [
+                {
+                    "name": "COSTUME",
+                    "type": "dropdown/number"
+                }
+            ],
+            "example_standalone": "switch costume to [costume1 v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I receive [explosion v]\n   repeat (5)\n     next costume\n   end\n   hide[costume1 v] \nend",
+                    "explanation": "This script animates an explosion by rapidly switching costumes, then hides the sprite. [3]"
+                }
+            ]
+        },
+        {
+            "block_name": "next costume",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_nextcostume",
+            "functionality": "Switches the sprite's costume to the next one in its costume list. If it's the last costume, it cycles back to the first.",
+            "inputs": null,
+            "example_standalone": "next costume",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [space v] key pressed\n  repeat (3)\n    next costume\n    wait (0.1) seconds\n  end \nend",
+                    "explanation": "When the space key is pressed, the sprite will cycle through its next three costumes with a short delay between each change."
+                },
+                {
+                    "script": "when green flag clicked\n   forever\n     next costume\n     wait (0.2) seconds\n   end \nend",
+                    "explanation": "This script continuously animates the sprite by switching to the next costume every 0.2 seconds, creating a walking or flying effect."
+                }
+            ]
+        },
+        {
+            "block_name": "switch backdrop to ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_switchbackdropto",
+            "functionality": "Changes the stage's backdrop to a specified backdrop.",
+            "inputs": [
+                {
+                    "name": "BACKDROP",
+                    "type": "dropdown/number"
+                }
+            ],
+            "example_standalone": "switch backdrop to [backdrop1 v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   switch backdrop to [start screen v]\nend ",
+                    "explanation": "This script sets the stage to a 'start screen' backdrop when the project begins."
+                }
+            ]
+        },
+        {
+            "block_name": "switch backdrop to () and wait",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_switchbackdroptowait",
+            "functionality": "Changes the stage's backdrop to a specified backdrop and pauses the script until any 'When backdrop switches to' scripts for that backdrop have finished.",
+            "inputs": [
+                {
+                    "name": "BACKDROP",
+                    "type": "dropdown/number"
+                }
+            ],
+            "example_standalone": "switch backdrop to [game over v] and wait",
+            "example_with_other_blocks": [
+                {
+                    "script": "broadcast [game over v]\n   switch backdrop to [game over v] and wait\n   stop [all v] \nend",
+                    "explanation": "This script broadcasts a 'game over' message, then changes the backdrop to 'game over' and waits for any associated scripts to finish before stopping all processes."
+                }
+            ]
+        },
+        {
+            "block_name": "next backdrop",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_nextbackdrop",
+            "functionality": "Switches the stage's backdrop to the next one in its backdrop list. If it's the last backdrop, it cycles back to the first.",
+            "inputs": null,
+            "example_standalone": "next backdrop",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [space v] key pressed\n   next backdrop\nend",
+                    "explanation": "This script changes the stage to the next backdrop in the list each time the space key is pressed."
+                }
+            ]
+        },
+        {
+            "block_name": "change size by ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_changesizeby",
+            "functionality": "Changes the sprite's size by a specified percentage. Positive values make it larger, negative values make it smaller.",
+            "inputs": [
+                {
+                    "name": "CHANGE",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "change size by (10)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   repeat (10)\n     change size by (5)\n     wait (0.1) seconds\n   end \nend ",
+                    "explanation": "This script makes the sprite gradually grow larger over 10 steps, with a short pause between each size change."
+                }
+            ]
+        },
+        {
+            "block_name": "set size to () %",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_setsizeto",
+            "functionality": "Sets the sprite's size to a specific percentage of its original size.",
+            "inputs": [
+                {
+                    "name": "SIZE",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "set size to (100) %",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   set size to (50) %\n   wait (1) seconds\n   set size to (100) %\nend ",
+                    "explanation": "This script makes the sprite shrink to half its original size at the start, waits for 1 second, then returns to its original size."
+                }
+            ]
+        },
+        {
+            "block_name": "change () effect by ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_changeeffectby",
+            "functionality": "Changes a visual effect on the sprite by a specified amount (e.g., color, fisheye, whirl, pixelate, mosaic, brightness, ghost).",
+            "inputs": [
+                {
+                    "name": "EFFECT",
+                    "type": "dropdown",
+                    "options": [
+                        "color",
+                        "fisheye",
+                        "whirl",
+                        "pixelate",
+                        "mosaic",
+                        "brightness",
+                        "ghost"
+                    ]
+                },
+                {
+                    "name": "CHANGE",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "change [color v] effect by (25)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when loudness > (10)\n  change [fisheye v] effect by (5)\nend",
+                    "explanation": "When the loudness detected by the microphone is greater than 10, the sprite's fisheye effect will increase by 5."
+                },
+                {
+                    "script": "when green flag clicked\n   forever\n     change [color v] effect by (5)\n     wait (0.1) seconds\n  end \nend",
+                    "explanation": "This script makes the sprite continuously cycle through different colors."
+                }
+            ]
+        },
+        {
+            "block_name": "set () effect to ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_seteffectto",
+            "functionality": "Sets a visual effect on the sprite to a specific value.",
+            "inputs": [
+                {
+                    "name": "EFFECT",
+                    "type": "dropdown",
+                    "options": [
+                        "color",
+                        "fisheye",
+                        "whirl",
+                        "pixelate",
+                        "mosaic",
+                        "brightness",
+                        "ghost"
+                    ]
+                },
+                {
+                    "name": "VALUE",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "set [ghost v] effect to (50)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   set [ghost v] effect to (75)\nend",
+                    "explanation": "This script makes the sprite 75% transparent at the start of the project."
+                }
+            ]
+        },
+        {
+            "block_name": "clear graphic effects",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_cleargraphiceffects",
+            "functionality": "Removes all visual effects applied to the sprite.",
+            "inputs": null,
+            "example_standalone": "clear graphic effects",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   change [color v] effect by (50)\n   wait (2) seconds\n   clear graphic effects\nend",
+                    "explanation": "This script changes the sprite's color effect, waits 2 seconds, then resets all graphic effects."
+                }
+            ]
+        },
+        {
+            "block_name": "show",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_show",
+            "functionality": "Makes the sprite visible on the stage.",
+            "inputs": null,
+            "example_standalone": "show",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   hide[start game v]\nwhen I receive [start game v]\n   show [start game v] \nend", 
+                    "explanation": "This script hides the sprite at the beginning of the project and makes it visible when a 'start game' broadcast is received."
+                }
+            ]
+        },
+        {
+            "block_name": "hide",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_hide",
+            "functionality": "Makes the sprite invisible on the stage.",
+            "inputs": null,
+            "example_standalone": "hide",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   hide \nend",
+                    "explanation": "This script hides the sprite from the stage when the green flag is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "go to () layer",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_gotofrontback",
+            "functionality": "Moves the sprite to the front-most or back-most layer of other sprites on the stage.",
+            "inputs": [
+                {
+                    "name": "FRONT_BACK",
+                    "type": "dropdown",
+                    "options": [
+                        "front",
+                        "back"
+                    ]
+                }
+            ],
+            "example_standalone": "go to [front v] layer",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   go to [front v] layer\nend",
+                    "explanation": "This script ensures the sprite is always visible on top of other sprites at the start of the project."
+                }
+            ]
+        },
+        {
+            "block_name": "go () layers",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_goforwardbackwardlayers",
+            "functionality": "Moves the sprite forward or backward a specified number of layers in relation to other sprites.",
+            "inputs": [
+                {
+                    "name": "FORWARD_BACKWARD",
+                    "type": "dropdown",
+                    "options": [
+                        "forward",
+                        "backward"
+                    ]
+                },
+                {
+                    "name": "NUM",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "go [forward v] (1) layers",
+            "example_with_other_blocks": [
+                {
+                    "script": "when this sprite clicked go [forward v] (1) layers\nend",
+                    "explanation": "This script brings the clicked sprite one layer closer to the front."
+                }
+            ]
+        },
+        {
+            "block_name": "play sound () until done",
+            "block_type": "Sound",
+            "block_shape": "Stack Block",
+            "op_code": "sound_playuntildone",
+            "functionality": "Plays a specified sound and pauses the script's execution until the sound has completed.",
+            "inputs": [
+                {
+                    "name": "sound name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "play sound [Meow v] until done",
+            "example_with_other_blocks": [
+                {
+                    "script": "when backdrop switches to [winning screen v]\n  play sound [fanfare v] until done\n  say [You won!] for (2) seconds\nend",
+                    "explanation": "When the backdrop changes to the 'winning screen', a 'fanfare' sound will play until it finishes, and then the sprite will say 'You won!' for 2 seconds."
+                },
+                {
+                    "script": "forever\n   play sound [Music v] until done \nend",
+                    "explanation": "This script creates a continuous loop for background music, playing the 'Music' sound repeatedly."
+                }
+            ]
+        },
+        {
+            "block_name": "start sound ()",
+            "block_type": "Sound",
+            "block_shape": "Stack Block",
+            "op_code": "sound_start",
+            "functionality": "Initiates playback of a specified sound without pausing the script, allowing other actions to proceed concurrently.",
+            "inputs": [
+                {
+                    "name": "sound name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "start sound [Pop v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when this sprite clicked\n   start sound [Pop v]\n   change [score v] by (1)\nend",
+                    "explanation": "This script plays a 'Pop' sound and increments the score simultaneously when the sprite is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "stop all sounds",
+            "block_type": "Sound",
+            "block_shape": "Stack Block",
+            "op_code": "sound_stopallsounds",
+            "functionality": "Stops all currently playing sounds.",
+            "inputs": null,
+            "example_standalone": "stop all sounds",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I receive [game over v]\n   stop all sounds\nend",
+                    "explanation": "This script stops any sounds currently playing when the 'game over' broadcast is received."
+                }
+            ]
+        },
+        {
+            "block_name": "change volume by ()",
+            "block_type": "Sound",
+            "block_shape": "Stack Block",
+            "op_code": "sound_changevolumeby",
+            "functionality": "Changes the project's sound volume by a specified amount.",
+            "inputs": [
+                {
+                    "name": "change",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "change volume by (-10)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [down arrow v] key pressed\n   change volume by (-5)\nend",
+                    "explanation": "This script decreases the project's volume by 5 when the down arrow key is pressed."
+                }
+            ]
+        },
+        {
+            "block_name": "set volume to () %",
+            "block_type": "Sound",
+            "block_shape": "Stack Block",
+            "op_code": "sound_setvolumeto",
+            "functionality": "Sets the sound volume to a specific percentage (0-100).",
+            "inputs": [
+                {
+                    "name": "percentage",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "set volume to (100) %",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   set volume to (50) %\nend",
+                    "explanation": "This script sets the project's volume to 50% when the green flag is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "broadcast ()",
+            "block_type": "Events",
+            "block_shape": "Stack Block",
+            "op_code": "event_broadcast",
+            "functionality": "Sends a broadcast message throughout the Scratch program, activating any 'when I receive ()' blocks that are set to listen for that message, enabling indirect communication.",
+            "inputs": [
+                {
+                    "name": "message name",
+                    "type": "string/dropdown"
+                }
+            ],
+            "example_standalone": "broadcast [start game v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "if <key [space v] pressed?> then\n  broadcast [jump v]\nend",
+                    "explanation": "This script sends a 'jump' message to other scripts or sprites when the space key is pressed."
+                }
+            ]
+        },
+        {
+            "block_name": "broadcast () and wait",
+            "block_type": "Events",
+            "block_shape": "Stack Block",
+            "op_code": "event_broadcastandwait",
+            "functionality": "Sends a broadcast message and pauses the current script until all other scripts activated by that broadcast have completed their execution, ensuring sequential coordination.",
+            "inputs": [
+                {
+                    "name": "message name",
+                    "type": "string/dropdown"
+                }
+            ],
+            "example_standalone": "broadcast [initialize sprites v] and wait",
+            "example_with_other_blocks": [
+                {
+                    "script": "broadcast [initialize sprites v] and wait\n  say [Game Started!] for (2) seconds",
+                    "explanation": "This script ensures all sprite initialization routines complete before displaying 'Game Started!' for 2 seconds."
+                }
+            ]
+        },
+        {
+            "block_name": "wait () seconds",
+            "block_type": "Control",
+            "block_shape": "Stack Block",
+            "op_code": "control_wait",
+            "functionality": "Pauses the script for a specified duration.",
+            "inputs": [
+                {
+                    "name": "seconds",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "wait (1) seconds",
+            "example_with_other_blocks": [
+                {
+                    "script": "say [Hello!] for (1) seconds\n   wait (0.5) seconds\n   say [Goodbye!] for (1) seconds",
+                    "explanation": "This script creates a timed dialogue sequence, pausing for 0.5 seconds between two speech bubbles."
+                }
+            ]
+        },
+        {
+            "block_name": "wait until <>",
+            "block_type": "Control",
+            "block_shape": "Stack Block",
+            "op_code": "control_wait_until",
+            "functionality": "Pauses the script until the specified boolean condition becomes true. [NOTE: it takes boolean blocks as input]",
+            "inputs": [
+                {
+                    "name": "condition",
+                    "type": "boolean"
+                }
+            ],
+            "example_standalone": "wait until <key [space v] pressed?>",
+            "example_with_other_blocks": [
+                {
+                    "script": "wait until <key [space v] pressed?>\n   start sound [pop v]\nend",
+                    "explanation": "This script pauses until the space key is pressed, then plays a 'pop' sound."
+                }
+            ]
+        },
+        {
+            "block_name": "stop ()",
+            "block_type": "Control",
+            "block_shape": "Stack Block",
+            "op_code": "control_stop",
+            "functionality": "Stops all scripts, this script, or other scripts in the sprite. Becomes a Cap Block if 'all' or 'this script' is selected in the dropdown menu.",
+            "inputs": [
+                {
+                    "name": "option",
+                    "type": "dropdown",
+                    "options": [
+                        "all",
+                        "this script",
+                        "other scripts in sprite"
+                    ]
+                }
+            ],
+            "example_standalone": "stop [all v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "if <score = (0)> then\n   stop [all v]\nend",
+                    "explanation": "This script stops the entire project if the 'score' variable becomes 0."
+                }
+            ]
+        },
+        {
+            "block_name": "create clone of ()",
+            "block_type": "Control",
+            "block_shape": "Stack Block",
+            "op_code": "control_create_clone_of",
+            "functionality": "Generates a copy, or clone, of a specified sprite (or 'myself' for the current sprite).",
+            "inputs": [
+                {
+                    "name": "sprite_name",
+                    "type": "dropdown",
+                    "options": [
+                        "myself",
+                        "sprite1",
+                        "..."
+                    ]
+                }
+            ],
+            "example_standalone": "create clone of [myself v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I start as a clone\n  show\n  go to random position\n  wait (2) seconds\n  delete this clone\nend",
+                    "explanation": "When a clone is created, it will show itself, go to a random position, wait for 2 seconds, and then delete itself."
+                }
+            ]
+        },
+        {
+            "block_name": "delete this clone",
+            "block_type": "Control",
+            "block_shape": "Stack Block",
+            "op_code": "control_delete_this_clone",
+            "functionality": "Deletes the clone that is currently running the script.",
+            "inputs": null,
+            "example_standalone": "delete this clone",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I start as a clone\n   wait (5) seconds\n   delete this clone\nend",
+                    "explanation": "This script makes each clone wait for 5 seconds after it's created, then deletes itself."
+                }
+            ]
+        },
+        {
+            "block_name": "set [my variable v] to ()",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_setvariableto",
+            "functionality": "Assigns a specific value (number, string, or boolean) to a variable.",
+            "inputs": [
+                {
+                    "name": "variable name",
+                    "type": "dropdown"
+                },
+                {
+                    "name": "value",
+                    "type": "any"
+                }
+            ],
+            "example_standalone": "set [score v] to (0)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  set [score v] to (0)\n  set [player name v] to [Guest]\nend",
+                    "explanation": "This script initializes the 'score' variable to 0 and the 'player name' variable to 'Guest' when the project starts."
+                }
+            ]
+        },
+        {
+            "block_name": "change [my variable v] by ()",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_changevariableby",
+            "functionality": "Increases or decreases a variable's numerical value by a specified amount.",
+            "inputs": [
+                {
+                    "name": "variable name",
+                    "type": "dropdown"
+                },
+                {
+                    "name": "value",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "change [score v] by (1)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when this sprite clicked\n  change [score v] by (1)\nend",
+                    "explanation": "This script increments the 'score' variable by 1 each time the sprite is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "add () to [my list v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_addtolist",
+            "functionality": "Appends an item to the end of a list.",
+            "inputs": [
+                {
+                    "name": "item",
+                    "type": "any"
+                },
+                {
+                    "name": "list name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "add [apple] to [shopping list v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  add [apple] to [shopping list v]\n  add [banana] to [shopping list v]\nend",
+                    "explanation": "This script adds 'apple' and 'banana' as new items to the 'shopping list' when the project starts."
+                }
+            ]
+        },
+        {
+            "block_name": "delete () of [my list v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_deleteoflist",
+            "functionality": "Removes an item from a list by its index or by selecting 'all' items.",
+            "inputs": [
+                {
+                    "name": "index/option",
+                    "type": "number/dropdown",
+                    "options": [
+                        "all",
+                        "last",
+                        "random"
+                    ]
+                },
+                {
+                    "name": "list name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "delete (1) of [my list v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  delete (all) of [my list v]\nend",
+                    "explanation": "This script clears all items from 'my list' when the green flag is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "insert () at () of [my list v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_insertatlist",
+            "functionality": "Inserts an item at a specific position within a list.",
+            "inputs": [
+                {
+                    "name": "item",
+                    "type": "any"
+                },
+                {
+                    "name": "index",
+                    "type": "number"
+                },
+                {
+                    "name": "list name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "insert [orange] at (2) of [fruits v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "insert [orange] at (2) of [fruits v]",
+                    "explanation": "This script inserts 'orange' as the second item in the 'fruits' list, shifting subsequent items."
+                }
+            ]
+        },
+        {
+            "block_name": "replace item () of [my list v] with ()",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_replaceitemoflist",
+            "functionality": "Replaces an item at a specific position in a list with a new value.",
+            "inputs": [
+                {
+                    "name": "index",
+                    "type": "number"
+                },
+                {
+                    "name": "list name",
+                    "type": "dropdown"
+                },
+                {
+                    "name": "new item",
+                    "type": "any"
+                }
+            ],
+            "example_standalone": "replace item (1) of [colors v] with [blue]",
+            "example_with_other_blocks": [
+                {
+                    "script": "replace item (1) of [colors v] with [blue]",
+                    "explanation": "This script changes the first item in the 'colors' list to 'blue'."
+                }
+            ]
+        },
+        {
+            "block_name": "show variable [my variable v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_showvariable",
+            "functionality": "Makes a variable's monitor visible on the stage.",
+            "inputs": [
+                {
+                    "name": "variable name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "show variable [score v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  show variable [score v]\nend",
+                    "explanation": "This script displays the 'score' variable on the stage when the project starts."
+                }
+            ]
+        },
+        {
+            "block_name": "hide variable [my variable v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_hidevariable",
+            "functionality": "Hides a variable's monitor from the stage.",
+            "inputs": [
+                {
+                    "name": "variable name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "hide variable [score v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I receive [game over v]\n  hide variable [score v]\nend",
+                    "explanation": "This script hides the 'score' variable when the 'game over' broadcast is received."
+                }
+            ]
+        },
+        {
+            "block_name": "show list [my list v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_showlist",
+            "functionality": "Makes a list's monitor visible on the stage.",
+            "inputs": [
+                {
+                    "name": "list name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "show list [shopping list v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  show list [shopping list v]\nend",
+                    "explanation": "This script displays the 'shopping list' on the stage when the project starts."
+                }
+            ]
+        },
+        {
+            "block_name": "hide list [my list v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_hidelist",
+            "functionality": "Hides a list's monitor from the stage.",
+            "inputs": [
+                {
+                    "name": "list name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "hide list [shopping list v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I receive [game over v]\n  hide list [shopping list v]\nend",
+                    "explanation": "This script hides the 'shopping list' when the 'game over' broadcast is received."
+                }
+            ]
+        },
+        {
+            "block_name": "Ask () and Wait",
+            "block_type": "Sensing",
+            "block_shape": "Stack Block",
+            "op_code": "sensing_askandwait",
+            "functionality": "Displays an input box with specified text at the bottom of the screen, allowing users to input text, which is stored in the 'Answer' block.",
+            "inputs": [
+                {
+                    "name": "question",
+                    "type": "text"
+                }
+            ],
+            "example_standalone": "ask [What is your name? v] and wait",
+            "example_with_other_blocks": [
+                {
+                    "script": "ask [What is your name? v] and wait\n  say join [Hello v] (answer) for (2) seconds \nend",
+                    "explanation": "This script prompts the user for their name, waits for input, then greets them using the provided answer."
+                }
+            ]
+        },
+        {
+            "block_name": "Reset Timer",
+            "block_type": "Sensing",
+            "block_shape": "Stack Block",
+            "op_code": "sensing_resettimer",
+            "functionality": "Sets the timer’s value back to 0.0.",
+            "inputs": null,
+            "example_standalone": "reset timer",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  reset timer\n  wait (5) seconds\n  say timer for (2) seconds\nend",
+                    "explanation": "This script resets the timer at the start, waits for 5 seconds, then says the current timer value."
+                }
+            ]
+        },
+        {
+            "block_name": "set drag mode [draggable v]",
+            "block_type": "Sensing",
+            "block_shape": "Stack Block",
+            "op_code": "sensing_setdragmode",
+            "functionality": "Sets whether the sprite can be dragged by the mouse on the stage.",
+            "inputs": null,
+            "fields": {
+                "DRAG_MODE": {
+                    "type": "dropdown",
+                    "options": [
+                        "draggable",
+                        "not draggable"
+                    ]
+                }
+            },
+            "example_standalone": "set drag mode [draggable v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  set drag mode [not draggable v]\nend when this sprite clicked\n  set drag mode [draggable v] \nend",
+                    "explanation": "This script makes the sprite not draggable when the project starts, but allows it to be dragged once it's clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "[my custom block]",
+            "block_type": "My Blocks",
+            "block_shape": "Stack Block",
+            "op_code": "procedures_call",
+            "functionality": "Executes the script defined by a corresponding 'define' Hat block. This block allows users to call and reuse custom code sequences by simply dragging and dropping it into their scripts, optionally providing required input values.",
+            "inputs": [
+                {
+                    "name": "argument_name_1",
+                    "type": "any"
+                },
+                {
+                    "name": "argument_name_2",
+                    "type": "any"
+                }
+            ],
+            "example_standalone": "jump (50)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  go to x: (0) y: (0)\n  jump (50)\n  wait (1) seconds\n  say [I jumped!] for (2) seconds",
+                    "explanation": "This script moves the sprite to a starting position, then calls the 'jump' custom block with an input of 50 (assuming 'jump' is a custom block that moves the sprite up and down). After the jump, the sprite says 'I jumped!'."
+                },
+                {
+                    "script": "when green flag clicked\n   hide\n   forever\n     create clone of [myself v]\n     wait (1) seconds\n   end",
+                    "explanation": "This script continuously creates new clones of the current sprite every second after the original sprite hides itself."
+                }
+            ]
+        }
+    ]
+}

v2/scratch_agent/blocks_content.json

@@ -0,0 +1,1367 @@
+{
+    "motion_movesteps": {
+        "opcode": "motion_movesteps",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STEPS": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 464,
+        "y": -416
+    },
+    "motion_turnright": {
+        "opcode": "motion_turnright",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DEGREES": [
+                1,
+                [
+                    4,
+                    "15"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 467,
+        "y": -316
+    },
+    "motion_turnleft": {
+        "opcode": "motion_turnleft",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DEGREES": [
+                1,
+                [
+                    4,
+                    "15"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 464,
+        "y": -210
+    },
+    "motion_goto": {
+        "opcode": "motion_goto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TO": [
+                1,
+                "@iM=Z?~GCbpC}gT7KAKY"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 465,
+        "y": -95
+    },
+    "motion_goto_menu": {
+        "opcode": "motion_goto_menu",
+        "next": null,
+        "parent": "d|J?C902/xy6tD5,|dmB",
+        "inputs": {},
+        "fields": {
+            "TO": [
+                "_random_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "motion_gotoxy": {
+        "opcode": "motion_gotoxy",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "X": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ],
+            "Y": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 468,
+        "y": 12
+    },
+    "motion_glideto": {
+        "opcode": "motion_glideto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SECS": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ],
+            "TO": [
+                1,
+                "{id to destination position}"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 470,
+        "y": 129
+    },
+    "motion_glideto_menu": {
+        "opcode": "motion_glideto_menu",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "TO": [
+                "_random_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "motion_glidesecstoxy": {
+        "opcode": "motion_glidesecstoxy",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SECS": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ],
+            "X": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ],
+            "Y": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 476,
+        "y": 239
+    },
+    "motion_pointindirection": {
+        "opcode": "motion_pointindirection",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DIRECTION": [
+                1,
+                [
+                    8,
+                    "90"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 493,
+        "y": 361
+    },
+    "motion_pointtowards": {
+        "opcode": "motion_pointtowards",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TOWARDS": [
+                1,
+                "6xQl1pPk%9E~Znhm*:ng"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 492,
+        "y": 463
+    },
+    "motion_pointtowards_menu": {
+        "opcode": "motion_pointtowards_menu",
+        "next": null,
+        "parent": "Ucm$YBs*^9GFTGXCbal@",
+        "inputs": {},
+        "fields": {
+            "TOWARDS": [
+                "_mouse_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "motion_changexby": {
+        "opcode": "motion_changexby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DX": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 851,
+        "y": -409
+    },
+    "motion_setx": {
+        "opcode": "motion_setx",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "X": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 864,
+        "y": -194
+    },
+    "motion_changeyby": {
+        "opcode": "motion_changeyby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DY": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 861,
+        "y": -61
+    },
+    "motion_sety": {
+        "opcode": "motion_sety",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "Y": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 864,
+        "y": 66
+    },
+    "motion_ifonedgebounce": {
+        "opcode": "motion_ifonedgebounce",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1131,
+        "y": -397
+    },
+    "motion_setrotationstyle": {
+        "opcode": "motion_setrotationstyle",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "STYLE": [
+                "left-right",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 1128,
+        "y": -287
+    },
+    "motion_xposition": {
+        "opcode": "motion_xposition",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1193,
+        "y": -136
+    },
+    "motion_yposition": {
+        "opcode": "motion_yposition",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1181,
+        "y": -64
+    },
+    "motion_direction": {
+        "opcode": "motion_direction",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1188,
+        "y": 21
+    },
+    "control_wait": {
+        "opcode": "control_wait",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DURATION": [
+                1,
+                [
+                    5,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 337,
+        "y": 129
+    },
+    "control_repeat": {
+        "opcode": "control_repeat",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TIMES": [
+                1,
+                [
+                    6,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 265
+    },
+    "control_forever": {
+        "opcode": "control_forever",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 334,
+        "y": 439
+    },
+    "control_if": {
+        "opcode": "control_if",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 331,
+        "y": 597
+    },
+    "control_if_else": {
+        "opcode": "control_if_else",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 335,
+        "y": 779
+    },
+    "control_wait_until": {
+        "opcode": "control_wait_until",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 676,
+        "y": 285
+    },
+    "control_repeat_until": {
+        "opcode": "control_repeat_until",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 692,
+        "y": 381
+    },
+    "control_stop": {
+        "opcode": "control_stop",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "STOP_OPTION": [
+                "all",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 708,
+        "y": 545,
+        "mutation": {
+            "tagName": "mutation",
+            "children": [],
+            "hasnext": "false"
+        }
+    },
+    "control_start_as_clone": {
+        "opcode": "control_start_as_clone",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 665,
+        "y": 672
+    },
+    "control_create_clone_of": {
+        "opcode": "control_create_clone_of",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "CLONE_OPTION": [
+                1,
+                "t))DW9(QSKB]3C/3Ou+J"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 648,
+        "y": 797
+    },
+    "control_create_clone_of_menu": {
+        "opcode": "control_create_clone_of_menu",
+        "next": null,
+        "parent": "80yo/}Cw++Z.;x[ohh|7",
+        "inputs": {},
+        "fields": {
+            "CLONE_OPTION": [
+                "_myself_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "control_delete_this_clone": {
+        "opcode": "control_delete_this_clone",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 642,
+        "y": 914
+    },
+    "event_whenflagclicked": {
+        "opcode": "event_whenflagclicked",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 166,
+        "y": -422
+    },
+    "event_whenkeypressed": {
+        "opcode": "event_whenkeypressed",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "KEY_OPTION": [
+                "space",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 151,
+        "y": -329
+    },
+    "event_whenthisspriteclicked": {
+        "opcode": "event_whenthisspriteclicked",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 156,
+        "y": -223
+    },
+    "event_whenbackdropswitchesto": {
+        "opcode": "event_whenbackdropswitchesto",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "BACKDROP": [
+                "backdrop1",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 148,
+        "y": -101
+    },
+    "event_whengreaterthan": {
+        "opcode": "event_whengreaterthan",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {
+            "WHENGREATERTHANMENU": [
+                "LOUDNESS",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 150,
+        "y": 10
+    },
+    "event_whenbroadcastreceived": {
+        "opcode": "event_whenbroadcastreceived",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "BROADCAST_OPTION": [
+                "message1",
+                "5O!nei;S$!c!=hCT}0:a"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 141,
+        "y": 118
+    },
+    "event_broadcast": {
+        "opcode": "event_broadcast",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "BROADCAST_INPUT": [
+                1,
+                [
+                    11,
+                    "message1",
+                    "5O!nei;S$!c!=hCT}0:a"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 151,
+        "y": 229
+    },
+    "event_broadcastandwait": {
+        "opcode": "event_broadcastandwait",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "BROADCAST_INPUT": [
+                1,
+                [
+                    11,
+                    "message1",
+                    "5O!nei;S$!c!=hCT}0:a"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 157,
+        "y": 340
+    },
+    "sensing_touchingobject": {
+        "opcode": "sensing_touchingobject",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TOUCHINGOBJECTMENU": [
+                1,
+                "xSKW9a+wTnM~h~So8Jc]"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 359,
+        "y": 116
+    },
+    "sensing_touchingobjectmenu": {
+        "opcode": "sensing_touchingobjectmenu",
+        "next": null,
+        "parent": "Y(n,F@BYzwd4CiN|Bh[P",
+        "inputs": {},
+        "fields": {
+            "TOUCHINGOBJECTMENU": [
+                "_mouse_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sensing_touchingcolor": {
+        "opcode": "sensing_touchingcolor",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "COLOR": [
+                1,
+                [
+                    9,
+                    "#55b888"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 360,
+        "y": 188
+    },
+    "sensing_coloristouchingcolor": {
+        "opcode": "sensing_coloristouchingcolor",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "COLOR": [
+                1,
+                [
+                    9,
+                    "#d019f2"
+                ]
+            ],
+            "COLOR2": [
+                1,
+                [
+                    9,
+                    "#2b0de3"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 277
+    },
+    "sensing_askandwait": {
+        "opcode": "sensing_askandwait",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "QUESTION": [
+                1,
+                [
+                    10,
+                    "What's your name?"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 338,
+        "y": 354
+    },
+    "sensing_answer": {
+        "opcode": "sensing_answer",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 782,
+        "y": 111
+    },
+    "sensing_keypressed": {
+        "opcode": "sensing_keypressed",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "KEY_OPTION": [
+                1,
+                "SNlf@Im$sv%.6ULi-f3i"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 762,
+        "y": 207
+    },
+    "sensing_keyoptions": {
+        "opcode": "sensing_keyoptions",
+        "next": null,
+        "parent": "7$xEUO.2hH2R6vh!$(Uj",
+        "inputs": {},
+        "fields": {
+            "KEY_OPTION": [
+                "space",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sensing_mousedown": {
+        "opcode": "sensing_mousedown",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 822,
+        "y": 422
+    },
+    "sensing_mousex": {
+        "opcode": "sensing_mousex",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 302,
+        "y": 528
+    },
+    "sensing_mousey": {
+        "opcode": "sensing_mousey",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 668,
+        "y": 547
+    },
+    "sensing_setdragmode": {
+        "opcode": "sensing_setdragmode",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "DRAG_MODE": [
+                "draggable",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 950,
+        "y": 574
+    },
+    "sensing_loudness": {
+        "opcode": "sensing_loudness",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 658,
+        "y": 703
+    },
+    "sensing_timer": {
+        "opcode": "sensing_timer",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 459,
+        "y": 671
+    },
+    "sensing_resettimer": {
+        "opcode": "sensing_resettimer",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 462,
+        "y": 781
+    },
+    "sensing_of": {
+        "opcode": "sensing_of",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OBJECT": [
+                1,
+                "t+o*y;iz,!O#aT|qM_+O"
+            ]
+        },
+        "fields": {
+            "PROPERTY": [
+                "backdrop #",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 997,
+        "y": 754
+    },
+    "sensing_of_object_menu": {
+        "opcode": "sensing_of_object_menu",
+        "next": null,
+        "parent": "[4I2wIG/tNc@LQ-;FbsB",
+        "inputs": {},
+        "fields": {
+            "OBJECT": [
+                "_stage_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sensing_current": {
+        "opcode": "sensing_current",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "CURRENTMENU": [
+                "YEAR",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 627,
+        "y": 884
+    },
+    "sensing_dayssince2000": {
+        "opcode": "sensing_dayssince2000",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 959,
+        "y": 903
+    },
+    "sensing_username": {
+        "opcode": "sensing_username",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 833,
+        "y": 757
+    },
+    "operator_add": {
+        "opcode": "operator_add",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 128,
+        "y": 153
+    },
+    "operator_subtract": {
+        "opcode": "operator_subtract",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 134,
+        "y": 214
+    },
+    "operator_multiply": {
+        "opcode": "operator_multiply",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 134,
+        "y": 278
+    },
+    "operator_divide": {
+        "opcode": "operator_divide",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 138,
+        "y": 359
+    },
+    "operator_random": {
+        "opcode": "operator_random",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "FROM": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ],
+            "TO": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 311,
+        "y": 157
+    },
+    "operator_gt": {
+        "opcode": "operator_gt",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OPERAND1": [
+                1,
+                [
+                    10,
+                    ""
+                ]
+            ],
+            "OPERAND2": [
+                1,
+                [
+                    10,
+                    "50"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 217
+    },
+    "operator_lt": {
+        "opcode": "operator_lt",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OPERAND1": [
+                1,
+                [
+                    10,
+                    ""
+                ]
+            ],
+            "OPERAND2": [
+                1,
+                [
+                    10,
+                    "50"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 345,
+        "y": 286
+    },
+    "operator_equals": {
+        "opcode": "operator_equals",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OPERAND1": [
+                1,
+                [
+                    10,
+                    ""
+                ]
+            ],
+            "OPERAND2": [
+                1,
+                [
+                    10,
+                    "50"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 345,
+        "y": 372
+    },
+    "operator_and": {
+        "opcode": "operator_and",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 701,
+        "y": 158
+    },
+    "operator_or": {
+        "opcode": "operator_or",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 705,
+        "y": 222
+    },
+    "operator_not": {
+        "opcode": "operator_not",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 734,
+        "y": 283
+    },
+    "operator_join": {
+        "opcode": "operator_join",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STRING1": [
+                1,
+                [
+                    10,
+                    "apple "
+                ]
+            ],
+            "STRING2": [
+                1,
+                [
+                    10,
+                    "banana"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 663,
+        "y": 378
+    },
+    "operator_letter_of": {
+        "opcode": "operator_letter_of",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "LETTER": [
+                1,
+                [
+                    6,
+                    "1"
+                ]
+            ],
+            "STRING": [
+                1,
+                [
+                    10,
+                    "apple"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 664,
+        "y": 445
+    },
+    "operator_length": {
+        "opcode": "operator_length",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STRING": [
+                1,
+                [
+                    10,
+                    "apple"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 664,
+        "y": 521
+    },
+    "operator_contains": {
+        "opcode": "operator_contains",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STRING1": [
+                1,
+                [
+                    10,
+                    "apple"
+                ]
+            ],
+            "STRING2": [
+                1,
+                [
+                    10,
+                    "a"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 634,
+        "y": 599
+    },
+    "operator_mod": {
+        "opcode": "operator_mod",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 295,
+        "y": 594
+    },
+    "operator_round": {
+        "opcode": "operator_round",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 307,
+        "y": 674
+    },
+    "operator_mathop": {
+        "opcode": "operator_mathop",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {
+            "OPERATOR": [
+                "abs",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 280,
+        "y": 754
+    }
+}

v2/scratch_agent/blocks_defination.py

@@ -0,0 +1,274 @@
+ALL_SCRATCH_BLOCKS_CATALOG = {
+    "motion_movesteps": {
+                    "opcode": "motion_movesteps",
+                    "next": null,
+                    "parent": null,
+                    "inputs": {
+                        "STEPS": [
+                            1,
+                            [
+                                4,
+                                "10"
+                            ]
+                        ]
+                    },
+                    "fields": {},
+                    "shadow": False,
+                    "topLevel": True,
+                    "x": 464,
+                    "y": -416
+                },
+    "motion_turnright": {
+        "opcode": "motion_turnright",
+        "inputs": {"DEGREES": [1, [4, "15"]]},
+        "fields": {},
+        "shadow": False
+    },
+    "motion_turnleft": {
+        "opcode": "motion_turnleft",
+        "inputs": {"DEGREES": [1, [4, "15"]]},
+        "fields": {},
+        "shadow": False
+    },
+    "motion_goto": {
+        "opcode": "motion_goto",
+        "inputs": {"TO": [1, None]}, # TO input will be filled by a menu block ID
+        "fields": {},
+        "shadow": False
+    },
+    "motion_goto_menu": { # Shadow block for motion_goto
+        "opcode": "motion_goto_menu",
+        "inputs": {},
+        "fields": {"TO": ["_random_", None]},
+        "shadow": True
+    },
+    "motion_gotoxy": {
+        "opcode": "motion_gotoxy",
+        "inputs": {"X": [1, [4, "0"]], "Y": [1, [4, "0"]]},
+        "fields": {},
+        "shadow": False
+    },
+    "motion_glideto": {
+        "opcode": "motion_glideto",
+        "inputs": {"SECS": [1, [4, "1"]], "TO": [1, None]}, # TO input will be filled by a menu block ID
+        "fields": {},
+        "shadow": False
+    },
+    "motion_glideto_menu": { # Shadow block for motion_glideto
+        "opcode": "motion_glideto_menu",
+        "inputs": {},
+        "fields": {"TO": ["_random_", None]},
+        "shadow": True
+    },
+    "motion_glidesecstoxy": {
+        "opcode": "motion_glidesecstoxy",
+        "inputs": {"SECS": [1, [4, "1"]], "X": [1, [4, "0"]], "Y": [1, [4, "0"]]},
+        "fields": {},
+        "shadow": False
+    },
+    "motion_pointindirection": {
+        "opcode": "motion_pointindirection",
+        "inputs": {"DIRECTION": [1, [8, "90"]]},
+        "fields": {},
+        "shadow": False
+    },
+    "motion_pointtowards": {
+        "opcode": "motion_pointtowards",
+        "inputs": {"TOWARDS": [1, None]}, # TOWARDS input will be filled by a menu block ID
+        "fields": {},
+        "shadow": False
+    },
+    "motion_pointtowards_menu": { # Shadow block for motion_pointtowards
+        "opcode": "motion_pointtowards_menu",
+        "inputs": {},
+        "fields": {"TOWARDS": ["_mouse_", None]},
+        "shadow": True
+    },
+    "motion_changexby": {
+        "opcode": "motion_changexby",
+        "inputs": {"DX": [1, [4, "10"]]},
+        "fields": {},
+        "shadow": False
+    },
+    "motion_setx": {
+        "opcode": "motion_setx",
+        "inputs": {"X": [1, [4, "0"]]},
+        "fields": {},
+        "shadow": False
+    },
+    "motion_changeyby": {
+        "opcode": "motion_changeyby",
+        "inputs": {"DY": [1, [4, "10"]]},
+        "fields": {},
+        "shadow": False
+    },
+    "motion_sety": {
+        "opcode": "motion_sety",
+        "inputs": {"Y": [1, [4, "0"]]},
+        "fields": {},
+        "shadow": False
+    },
+    "motion_ifonedgebounce": {
+        "opcode": "motion_ifonedgebounce",
+        "next": None, "parent": None, "inputs": {}, "fields": {}, "shadow": False
+    },
+    "motion_setrotationstyle": {
+        "opcode": "motion_setrotationstyle",
+        "inputs": {},
+        "fields": {"STYLE": ["left-right", None]},
+        "shadow": False
+    },
+    "motion_xposition": {
+        "opcode": "motion_xposition",
+        "inputs": {}, "fields": {}, "shadow": False
+    },
+    "motion_yposition": {
+        "opcode": "motion_yposition",
+        "inputs": {}, "fields": {}, "shadow": False
+    },
+    "motion_direction": {
+        "opcode": "motion_direction",
+        "inputs": {}, "fields": {}, "shadow": False
+    },
+    # Control Blocks
+    "control_wait": {
+        "opcode": "control_wait",
+        "inputs": {"DURATION": [1, [5, "1"]]},
+        "fields": {},
+        "shadow": False
+    },
+    "control_repeat": {
+        "opcode": "control_repeat",
+        "inputs": {"TIMES": [1, [6, "10"]], "SUBSTACK": [2, None]}, # SUBSTACK to be filled
+        "fields": {},
+        "shadow": False
+    },
+    "control_forever": {
+        "opcode": "control_forever",
+        "inputs": {"SUBSTACK": [2, None]}, # SUBSTACK to be filled
+        "fields": {},
+        "shadow": False
+    },
+    "control_if": {
+        "opcode": "control_if",
+        "inputs": {"CONDITION": [2, None], "SUBSTACK": [2, None]}, # CONDITION and SUBSTACK to be filled
+        "fields": {},
+        "shadow": False
+    },
+    "control_if_else": {
+        "opcode": "control_if_else",
+        "inputs": {"CONDITION": [2, None], "SUBSTACK": [2, None], "SUBSTACK2": [2, None]}, # All to be filled
+        "fields": {},
+        "shadow": False
+    },
+    "control_wait_until": {
+        "opcode": "control_wait_until",
+        "inputs": {"CONDITION": [2, None]},
+        "fields": {},
+        "shadow": False
+    },
+    "control_repeat_until": {
+        "opcode": "control_repeat_until",
+        "inputs": {"CONDITION": [2, None], "SUBSTACK": [2, None]},
+        "fields": {},
+        "shadow": False
+    },
+    "control_stop": {
+        "opcode": "control_stop",
+        "inputs": {},
+        "fields": {"STOP_OPTION": ["all", None]},
+        "shadow": False,
+        "mutation": {"tagName": "mutation", "children": [], "hasnext": "false"}
+    },
+    "control_start_as_clone": {
+        "opcode": "control_start_as_clone",
+        "inputs": {}, "fields": {}, "shadow": False
+    },
+    "control_create_clone_of": {
+        "opcode": "control_create_clone_of",
+        "inputs": {"CLONE_OPTION": [1, None]}, # CLONE_OPTION to be filled by menu block ID
+        "fields": {},
+        "shadow": False
+    },
+    "control_create_clone_of_menu": { # Shadow block for control_create_clone_of
+        "opcode": "control_create_clone_of_menu",
+        "inputs": {},
+        "fields": {"CLONE_OPTION": ["_myself_", None]},
+        "shadow": True
+    },
+    "control_delete_this_clone": {
+        "opcode": "control_delete_this_clone",
+        "inputs": {}, "fields": {}, "shadow": False
+    },
+    # Event Blocks
+    "event_whenflagclicked": {
+        "opcode": "event_whenflagclicked",
+        "inputs": {}, "fields": {}, "shadow": False
+    },
+    "event_whenkeypressed": {
+        "opcode": "event_whenkeypressed",
+        "inputs": {},
+        "fields": {"KEY_OPTION": ["space", None]},
+        "shadow": False
+    },
+    "event_whenthisspriteclicked": {
+        "opcode": "event_whenthisspriteclicked",
+        "inputs": {}, "fields": {}, "shadow": False
+    },
+    "event_whenbackdropswitchesto": {
+        "opcode": "event_whenbackdropswitchesto",
+        "inputs": {},
+        "fields": {"BACKDROP": ["backdrop1", None]},
+        "shadow": False
+    },
+    "event_whengreaterthan": {
+        "opcode": "event_whengreaterthan",
+        "inputs": {"VALUE": [1, [4, "10"]]},
+        "fields": {"WHENGREATERTHANMENU": ["LOUDNESS", None]},
+        "shadow": False
+    },
+    "event_whenbroadcastreceived": {
+        "opcode": "event_whenbroadcastreceived",
+        "inputs": {},
+        "fields": {"BROADCAST_OPTION": ["message1", None]},
+        "shadow": False
+    },
+    "event_broadcast": {
+        "opcode": "event_broadcast",
+        "inputs": {"BROADCAST_INPUT": [1, None]}, # BROADCAST_INPUT to be filled by menu or text block
+        "fields": {},
+        "shadow": False
+    },
+    "event_broadcastandwait": {
+        "opcode": "event_broadcastandwait",
+        "inputs": {"BROADCAST_INPUT": [1, None]},
+        "fields": {},
+        "shadow": False
+    },
+    # Sensing Blocks (example, can be expanded)
+    "sensing_touchingobject": {
+        "opcode": "sensing_touchingobject",
+        "inputs": {"TOUCHINGOBJECTMENU": [1, None]}, # Input for menu block ID
+        "fields": {},
+        "shadow": False
+    },
+    "sensing_touchingobjectmenu": { # Shadow block for sensing_touchingobject
+        "opcode": "sensing_touchingobjectmenu",
+        "inputs": {},
+        "fields": {"TOUCHINGOBJECTMENU": ["_mouse_", None]},
+        "shadow": True
+    },
+    # Operators (example, can be expanded)
+    "operator_add": {
+        "opcode": "operator_add",
+        "inputs": {"NUM1": [1, [4, "0"]], "NUM2": [1, [4, "0"]]},
+        "fields": {},
+        "shadow": False
+    },
+    "operator_equals": {
+        "opcode": "operator_equals",
+        "inputs": {"OPERAND1": [1, [10, ""]], "OPERAND2": [1, [10, ""]]},
+        "fields": {},
+        "shadow": False
+    }
+}

v2/scratch_agent/blocks_v1/blocks.json

@@ -0,0 +1,2221 @@
+{
+    "motion_movesteps": {
+        "opcode": "motion_movesteps",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STEPS": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 464,
+        "y": -416
+    },
+    "motion_turnright": {
+        "opcode": "motion_turnright",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DEGREES": [
+                1,
+                [
+                    4,
+                    "15"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 467,
+        "y": -316
+    },
+    "motion_turnleft": {
+        "opcode": "motion_turnleft",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DEGREES": [
+                1,
+                [
+                    4,
+                    "15"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 464,
+        "y": -210
+    },
+    "motion_goto": {
+        "opcode": "motion_goto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TO": [
+                1,
+                "@iM=Z?~GCbpC}gT7KAKY"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 465,
+        "y": -95
+    },
+    "motion_goto_menu": {
+        "opcode": "motion_goto_menu",
+        "next": null,
+        "parent": "d|J?C902/xy6tD5,|dmB",
+        "inputs": {},
+        "fields": {
+            "TO": [
+                "_random_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "motion_gotoxy": {
+        "opcode": "motion_gotoxy",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "X": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ],
+            "Y": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 468,
+        "y": 12
+    },
+    "motion_glideto": {
+        "opcode": "motion_glideto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SECS": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ],
+            "TO": [
+                1,
+                "{id to destination position}"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 470,
+        "y": 129
+    },
+    "motion_glideto_menu": {
+        "opcode": "motion_glideto_menu",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "TO": [
+                "_random_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "motion_glidesecstoxy": {
+        "opcode": "motion_glidesecstoxy",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SECS": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ],
+            "X": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ],
+            "Y": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 476,
+        "y": 239
+    },
+    "motion_pointindirection": {
+        "opcode": "motion_pointindirection",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DIRECTION": [
+                1,
+                [
+                    8,
+                    "90"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 493,
+        "y": 361
+    },
+    "motion_pointtowards": {
+        "opcode": "motion_pointtowards",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TOWARDS": [
+                1,
+                "6xQl1pPk%9E~Znhm*:ng"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 492,
+        "y": 463
+    },
+    "motion_pointtowards_menu": {
+        "opcode": "motion_pointtowards_menu",
+        "next": null,
+        "parent": "Ucm$YBs*^9GFTGXCbal@",
+        "inputs": {},
+        "fields": {
+            "TOWARDS": [
+                "_mouse_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "motion_changexby": {
+        "opcode": "motion_changexby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DX": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 851,
+        "y": -409
+    },
+    "motion_setx": {
+        "opcode": "motion_setx",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "X": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 864,
+        "y": -194
+    },
+    "motion_changeyby": {
+        "opcode": "motion_changeyby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DY": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 861,
+        "y": -61
+    },
+    "motion_sety": {
+        "opcode": "motion_sety",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "Y": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 864,
+        "y": 66
+    },
+    "motion_ifonedgebounce": {
+        "opcode": "motion_ifonedgebounce",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1131,
+        "y": -397
+    },
+    "motion_setrotationstyle": {
+        "opcode": "motion_setrotationstyle",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "STYLE": [
+                "left-right",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 1128,
+        "y": -287
+    },
+    "motion_xposition": {
+        "opcode": "motion_xposition",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1193,
+        "y": -136
+    },
+    "motion_yposition": {
+        "opcode": "motion_yposition",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1181,
+        "y": -64
+    },
+    "motion_direction": {
+        "opcode": "motion_direction",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1188,
+        "y": 21
+    },
+    "control_wait": {
+        "opcode": "control_wait",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "DURATION": [
+                1,
+                [
+                    5,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 337,
+        "y": 129
+    },
+    "control_repeat": {
+        "opcode": "control_repeat",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TIMES": [
+                1,
+                [
+                    6,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 265
+    },
+    "control_forever": {
+        "opcode": "control_forever",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 334,
+        "y": 439
+    },
+    "control_if": {
+        "opcode": "control_if",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 331,
+        "y": 597
+    },
+    "control_if_else": {
+        "opcode": "control_if_else",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 335,
+        "y": 779
+    },
+    "control_wait_until": {
+        "opcode": "control_wait_until",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 676,
+        "y": 285
+    },
+    "control_repeat_until": {
+        "opcode": "control_repeat_until",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 692,
+        "y": 381
+    },
+    "control_stop": {
+        "opcode": "control_stop",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "STOP_OPTION": [
+                "all",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 708,
+        "y": 545,
+        "mutation": {
+            "tagName": "mutation",
+            "children": [],
+            "hasnext": "false"
+        }
+    },
+    "control_start_as_clone": {
+        "opcode": "control_start_as_clone",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 665,
+        "y": 672
+    },
+    "control_create_clone_of": {
+        "opcode": "control_create_clone_of",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "CLONE_OPTION": [
+                1,
+                "t))DW9(QSKB]3C/3Ou+J"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 648,
+        "y": 797
+    },
+    "control_create_clone_of_menu": {
+        "opcode": "control_create_clone_of_menu",
+        "next": null,
+        "parent": "80yo/}Cw++Z.;x[ohh|7",
+        "inputs": {},
+        "fields": {
+            "CLONE_OPTION": [
+                "_myself_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "control_delete_this_clone": {
+        "opcode": "control_delete_this_clone",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 642,
+        "y": 914
+    },
+    "event_whenflagclicked": {
+        "opcode": "event_whenflagclicked",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 166,
+        "y": -422
+    },
+    "event_whenkeypressed": {
+        "opcode": "event_whenkeypressed",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "KEY_OPTION": [
+                "space",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 151,
+        "y": -329
+    },
+    "event_whenthisspriteclicked": {
+        "opcode": "event_whenthisspriteclicked",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 156,
+        "y": -223
+    },
+    "event_whenbackdropswitchesto": {
+        "opcode": "event_whenbackdropswitchesto",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "BACKDROP": [
+                "backdrop1",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 148,
+        "y": -101
+    },
+    "event_whengreaterthan": {
+        "opcode": "event_whengreaterthan",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {
+            "WHENGREATERTHANMENU": [
+                "LOUDNESS",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 150,
+        "y": 10
+    },
+    "event_whenbroadcastreceived": {
+        "opcode": "event_whenbroadcastreceived",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "BROADCAST_OPTION": [
+                "message1",
+                "5O!nei;S$!c!=hCT}0:a"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 141,
+        "y": 118
+    },
+    "event_broadcast": {
+        "opcode": "event_broadcast",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "BROADCAST_INPUT": [
+                1,
+                [
+                    11,
+                    "message1",
+                    "5O!nei;S$!c!=hCT}0:a"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 151,
+        "y": 229
+    },
+    "event_broadcastandwait": {
+        "opcode": "event_broadcastandwait",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "BROADCAST_INPUT": [
+                1,
+                [
+                    11,
+                    "message1",
+                    "5O!nei;S$!c!=hCT}0:a"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 157,
+        "y": 340
+    },
+    "sensing_touchingobject": {
+        "opcode": "sensing_touchingobject",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "TOUCHINGOBJECTMENU": [
+                1,
+                "xSKW9a+wTnM~h~So8Jc]"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 359,
+        "y": 116
+    },
+    "sensing_touchingobjectmenu": {
+        "opcode": "sensing_touchingobjectmenu",
+        "next": null,
+        "parent": "Y(n,F@BYzwd4CiN|Bh[P",
+        "inputs": {},
+        "fields": {
+            "TOUCHINGOBJECTMENU": [
+                "_mouse_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sensing_touchingcolor": {
+        "opcode": "sensing_touchingcolor",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "COLOR": [
+                1,
+                [
+                    9,
+                    "#55b888"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 360,
+        "y": 188
+    },
+    "sensing_coloristouchingcolor": {
+        "opcode": "sensing_coloristouchingcolor",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "COLOR": [
+                1,
+                [
+                    9,
+                    "#d019f2"
+                ]
+            ],
+            "COLOR2": [
+                1,
+                [
+                    9,
+                    "#2b0de3"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 277
+    },
+    "sensing_askandwait": {
+        "opcode": "sensing_askandwait",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "QUESTION": [
+                1,
+                [
+                    10,
+                    "What's your name?"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 338,
+        "y": 354
+    },
+    "sensing_answer": {
+        "opcode": "sensing_answer",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 782,
+        "y": 111
+    },
+    "sensing_keypressed": {
+        "opcode": "sensing_keypressed",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "KEY_OPTION": [
+                1,
+                "SNlf@Im$sv%.6ULi-f3i"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 762,
+        "y": 207
+    },
+    "sensing_keyoptions": {
+        "opcode": "sensing_keyoptions",
+        "next": null,
+        "parent": "7$xEUO.2hH2R6vh!$(Uj",
+        "inputs": {},
+        "fields": {
+            "KEY_OPTION": [
+                "space",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sensing_mousedown": {
+        "opcode": "sensing_mousedown",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 822,
+        "y": 422
+    },
+    "sensing_mousex": {
+        "opcode": "sensing_mousex",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 302,
+        "y": 528
+    },
+    "sensing_mousey": {
+        "opcode": "sensing_mousey",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 668,
+        "y": 547
+    },
+    "sensing_setdragmode": {
+        "opcode": "sensing_setdragmode",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "DRAG_MODE": [
+                "draggable",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 950,
+        "y": 574
+    },
+    "sensing_loudness": {
+        "opcode": "sensing_loudness",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 658,
+        "y": 703
+    },
+    "sensing_timer": {
+        "opcode": "sensing_timer",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 459,
+        "y": 671
+    },
+    "sensing_resettimer": {
+        "opcode": "sensing_resettimer",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 462,
+        "y": 781
+    },
+    "sensing_of": {
+        "opcode": "sensing_of",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OBJECT": [
+                1,
+                "t+o*y;iz,!O#aT|qM_+O"
+            ]
+        },
+        "fields": {
+            "PROPERTY": [
+                "backdrop #",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 997,
+        "y": 754
+    },
+    "sensing_of_object_menu": {
+        "opcode": "sensing_of_object_menu",
+        "next": null,
+        "parent": "[4I2wIG/tNc@LQ-;FbsB",
+        "inputs": {},
+        "fields": {
+            "OBJECT": [
+                "_stage_",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sensing_current": {
+        "opcode": "sensing_current",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "CURRENTMENU": [
+                "YEAR",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 627,
+        "y": 884
+    },
+    "sensing_dayssince2000": {
+        "opcode": "sensing_dayssince2000",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 959,
+        "y": 903
+    },
+    "sensing_username": {
+        "opcode": "sensing_username",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 833,
+        "y": 757
+    },
+    "operator_add": {
+        "opcode": "operator_add",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 128,
+        "y": 153
+    },
+    "operator_subtract": {
+        "opcode": "operator_subtract",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 134,
+        "y": 214
+    },
+    "operator_multiply": {
+        "opcode": "operator_multiply",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 134,
+        "y": 278
+    },
+    "operator_divide": {
+        "opcode": "operator_divide",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 138,
+        "y": 359
+    },
+    "operator_random": {
+        "opcode": "operator_random",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "FROM": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ],
+            "TO": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 311,
+        "y": 157
+    },
+    "operator_gt": {
+        "opcode": "operator_gt",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OPERAND1": [
+                1,
+                [
+                    10,
+                    ""
+                ]
+            ],
+            "OPERAND2": [
+                1,
+                [
+                    10,
+                    "50"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 217
+    },
+    "operator_lt": {
+        "opcode": "operator_lt",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OPERAND1": [
+                1,
+                [
+                    10,
+                    ""
+                ]
+            ],
+            "OPERAND2": [
+                1,
+                [
+                    10,
+                    "50"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 345,
+        "y": 286
+    },
+    "operator_equals": {
+        "opcode": "operator_equals",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "OPERAND1": [
+                1,
+                [
+                    10,
+                    ""
+                ]
+            ],
+            "OPERAND2": [
+                1,
+                [
+                    10,
+                    "50"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 345,
+        "y": 372
+    },
+    "operator_and": {
+        "opcode": "operator_and",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 701,
+        "y": 158
+    },
+    "operator_or": {
+        "opcode": "operator_or",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 705,
+        "y": 222
+    },
+    "operator_not": {
+        "opcode": "operator_not",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 734,
+        "y": 283
+    },
+    "operator_join": {
+        "opcode": "operator_join",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STRING1": [
+                1,
+                [
+                    10,
+                    "apple "
+                ]
+            ],
+            "STRING2": [
+                1,
+                [
+                    10,
+                    "banana"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 663,
+        "y": 378
+    },
+    "operator_letter_of": {
+        "opcode": "operator_letter_of",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "LETTER": [
+                1,
+                [
+                    6,
+                    "1"
+                ]
+            ],
+            "STRING": [
+                1,
+                [
+                    10,
+                    "apple"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 664,
+        "y": 445
+    },
+    "operator_length": {
+        "opcode": "operator_length",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STRING": [
+                1,
+                [
+                    10,
+                    "apple"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 664,
+        "y": 521
+    },
+    "operator_contains": {
+        "opcode": "operator_contains",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "STRING1": [
+                1,
+                [
+                    10,
+                    "apple"
+                ]
+            ],
+            "STRING2": [
+                1,
+                [
+                    10,
+                    "a"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 634,
+        "y": 599
+    },
+    "operator_mod": {
+        "opcode": "operator_mod",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM1": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ],
+            "NUM2": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 295,
+        "y": 594
+    },
+    "operator_round": {
+        "opcode": "operator_round",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 307,
+        "y": 674
+    },
+    "operator_mathop": {
+        "opcode": "operator_mathop",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM": [
+                1,
+                [
+                    4,
+                    ""
+                ]
+            ]
+        },
+        "fields": {
+            "OPERATOR": [
+                "abs",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 280,
+        "y": 754
+    },
+    "data_setvariableto": {
+        "opcode": "data_setvariableto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    10,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {
+            "VARIABLE": [
+                "my variable",
+                "`jEk@4|i[#Fk?(8x)AV.-my variable"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 348,
+        "y": 241
+    },
+    "data_changevariableby": {
+        "opcode": "data_changevariableby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "VARIABLE": [
+                "my variable",
+                "`jEk@4|i[#Fk?(8x)AV.-my variable"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 313,
+        "y": 363
+    },
+    "data_showvariable": {
+        "opcode": "data_showvariable",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "VARIABLE": [
+                "my variable",
+                "`jEk@4|i[#Fk?(8x)AV.-my variable"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 415,
+        "y": 473
+    },
+    "data_hidevariable": {
+        "opcode": "data_hidevariable",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "VARIABLE": [
+                "my variable",
+                "`jEk@4|i[#Fk?(8x)AV.-my variable"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 319,
+        "y": 587
+    },
+    "data_addtolist": {
+        "opcode": "data_addtolist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 385,
+        "y": 109
+    },
+    "data_deleteoflist": {
+        "opcode": "data_deleteoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "INDEX": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 384,
+        "y": 244
+    },
+    "data_deletealloflist": {
+        "opcode": "data_deletealloflist",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 387,
+        "y": 374
+    },
+    "data_insertatlist": {
+        "opcode": "data_insertatlist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ],
+            "INDEX": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 366,
+        "y": 527
+    },
+    "data_replaceitemoflist": {
+        "opcode": "data_replaceitemoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "INDEX": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ],
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 365,
+        "y": 657
+    },
+    "data_itemoflist": {
+        "opcode": "data_itemoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "INDEX": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 862,
+        "y": 117
+    },
+    "data_itemnumoflist": {
+        "opcode": "data_itemnumoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 883,
+        "y": 238
+    },
+    "data_lengthoflist": {
+        "opcode": "data_lengthoflist",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 876,
+        "y": 342
+    },
+    "data_listcontainsitem": {
+        "opcode": "data_listcontainsitem",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "ITEM": [
+                1,
+                [
+                    10,
+                    "thing"
+                ]
+            ]
+        },
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 871,
+        "y": 463
+    },
+    "data_showlist": {
+        "opcode": "data_showlist",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 931,
+        "y": 563
+    },
+    "data_hidelist": {
+        "opcode": "data_hidelist",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "LIST": [
+                "MY_LIST",
+                "o6`kIhtT{xWH+rX(5d,A"
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 962,
+        "y": 716
+    },
+    "sound_playuntildone": {
+        "opcode": "sound_playuntildone",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SOUND_MENU": [
+                1,
+                "4w%pR8G.yD%g-BwCj=uK"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 253,
+        "y": 17
+    },
+    "sound_sounds_menu": {
+        "opcode": "sound_sounds_menu",
+        "next": null,
+        "parent": "Pdc$U;s8e_uUfTX`}jOo",
+        "inputs": {},
+        "fields": {
+            "SOUND_MENU": [
+                "Meow",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "sound_play": {
+        "opcode": "sound_play",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SOUND_MENU": [
+                1,
+                "i1U{^VHb*2`9?l}=:L)/"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 245,
+        "y": 122
+    },
+    "sound_stopallsounds": {
+        "opcode": "sound_stopallsounds",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 253,
+        "y": 245
+    },
+    "sound_changeeffectby": {
+        "opcode": "sound_changeeffectby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {
+            "EFFECT": [
+                "PITCH",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 653,
+        "y": 14
+    },
+    "sound_seteffectto": {
+        "opcode": "sound_seteffectto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "100"
+                ]
+            ]
+        },
+        "fields": {
+            "EFFECT": [
+                "PITCH",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 653,
+        "y": 139
+    },
+    "sound_cleareffects": {
+        "opcode": "sound_cleareffects",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 651,
+        "y": 242
+    },
+    "sound_changevolumeby": {
+        "opcode": "sound_changevolumeby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VOLUME": [
+                1,
+                [
+                    4,
+                    "-10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 645,
+        "y": 353
+    },
+    "sound_setvolumeto": {
+        "opcode": "sound_setvolumeto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VOLUME": [
+                1,
+                [
+                    4,
+                    "100"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1108,
+        "y": 5
+    },
+    "sound_volume": {
+        "opcode": "sound_volume",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1136,
+        "y": 123
+    },
+    "looks_sayforsecs": {
+        "opcode": "looks_sayforsecs",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "MESSAGE": [
+                1,
+                [
+                    10,
+                    "Hello!"
+                ]
+            ],
+            "SECS": [
+                1,
+                [
+                    4,
+                    "2"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 408,
+        "y": 91
+    },
+    "looks_say": {
+        "opcode": "looks_say",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "MESSAGE": [
+                1,
+                [
+                    10,
+                    "Hello!"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 413,
+        "y": 213
+    },
+    "looks_thinkforsecs": {
+        "opcode": "looks_thinkforsecs",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "MESSAGE": [
+                1,
+                [
+                    10,
+                    "Hmm..."
+                ]
+            ],
+            "SECS": [
+                1,
+                [
+                    4,
+                    "2"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 413,
+        "y": 317
+    },
+    "looks_think": {
+        "opcode": "looks_think",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "MESSAGE": [
+                1,
+                [
+                    10,
+                    "Hmm..."
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 412,
+        "y": 432
+    },
+    "looks_switchcostumeto": {
+        "opcode": "looks_switchcostumeto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "COSTUME": [
+                1,
+                "8;bti4wv(iH9nkOacCJ|"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 411,
+        "y": 555
+    },
+    "looks_costume": {
+        "opcode": "looks_costume",
+        "next": null,
+        "parent": "Q#a,6LPWHqo9-0Nu*[SV",
+        "inputs": {},
+        "fields": {
+            "COSTUME": [
+                "costume2",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "looks_nextcostume": {
+        "opcode": "looks_nextcostume",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 419,
+        "y": 687
+    },
+    "looks_switchbackdropto": {
+        "opcode": "looks_switchbackdropto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "BACKDROP": [
+                1,
+                "-?yeX}29V*wd6W:unW0i"
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 901,
+        "y": 91
+    },
+    "looks_backdrops": {
+        "opcode": "looks_backdrops",
+        "next": null,
+        "parent": "`Wm^p~l[(IWzc1|wNv*.",
+        "inputs": {},
+        "fields": {
+            "BACKDROP": [
+                "backdrop1",
+                null
+            ]
+        },
+        "shadow": true,
+        "topLevel": false
+    },
+    "looks_changesizeby": {
+        "opcode": "looks_changesizeby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "CHANGE": [
+                1,
+                [
+                    4,
+                    "10"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 895,
+        "y": 192
+    },
+    "looks_setsizeto": {
+        "opcode": "looks_setsizeto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "SIZE": [
+                1,
+                [
+                    4,
+                    "100"
+                ]
+            ]
+        },
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 896,
+        "y": 303
+    },
+    "looks_changeeffectby": {
+        "opcode": "looks_changeeffectby",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "CHANGE": [
+                1,
+                [
+                    4,
+                    "25"
+                ]
+            ]
+        },
+        "fields": {
+            "EFFECT": [
+                "COLOR",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 892,
+        "y": 416
+    },
+    "looks_seteffectto": {
+        "opcode": "looks_seteffectto",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "VALUE": [
+                1,
+                [
+                    4,
+                    "0"
+                ]
+            ]
+        },
+        "fields": {
+            "EFFECT": [
+                "COLOR",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 902,
+        "y": 527
+    },
+    "looks_cleargraphiceffects": {
+        "opcode": "looks_cleargraphiceffects",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 902,
+        "y": 638
+    },
+    "looks_show": {
+        "opcode": "looks_show",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 908,
+        "y": 758
+    },
+    "looks_hide": {
+        "opcode": "looks_hide",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 455,
+        "y": 861
+    },
+    "looks_gotofrontback": {
+        "opcode": "looks_gotofrontback",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "FRONT_BACK": [
+                "front",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 853,
+        "y": 878
+    },
+    "looks_goforwardbackwardlayers": {
+        "opcode": "looks_goforwardbackwardlayers",
+        "next": null,
+        "parent": null,
+        "inputs": {
+            "NUM": [
+                1,
+                [
+                    7,
+                    "1"
+                ]
+            ]
+        },
+        "fields": {
+            "FORWARD_BACKWARD": [
+                "forward",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 851,
+        "y": 999
+    },
+    "looks_costumenumbername": {
+        "opcode": "looks_costumenumbername",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "NUMBER_NAME": [
+                "number",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 458,
+        "y": 1007
+    },
+    "looks_backdropnumbername": {
+        "opcode": "looks_backdropnumbername",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {
+            "NUMBER_NAME": [
+                "number",
+                null
+            ]
+        },
+        "shadow": false,
+        "topLevel": true,
+        "x": 1242,
+        "y": 753
+    },
+    "looks_size": {
+        "opcode": "looks_size",
+        "next": null,
+        "parent": null,
+        "inputs": {},
+        "fields": {},
+        "shadow": false,
+        "topLevel": true,
+        "x": 1249,
+        "y": 876
+    }
+}

v2/scratch_agent/blocks_v1/boolean_blocks.json

@@ -0,0 +1,277 @@
+{
+  "block_category": "Boolean Blocks",
+  "description": "Boolean blocks are hexagonal in shape. They represent conditions that evaluate to either 'true' or 'false' and are typically used as inputs for control flow blocks.",
+  "blocks": [
+    {
+      "block_name": "<() < ()>",
+      "block_type": "operator",
+      "op_code": "operator_lt",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if the first value is less than the second.",
+      "inputs": [
+        {"name": "OPERAND1", "type": "any"},
+        {"name": "OPERAND2", "type": "any"}
+      ],
+      "example_standalone": "<(score) < (10)>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(score) < (10)> then\n  say [Keep trying!]",
+          "explanation": "This script causes the sprite to say 'Keep trying!' if the 'score' variable is less than 10."
+        }
+      ]
+    },
+    {
+      "block_name": "<() = ()>",
+      "block_type": "operator",
+      "op_code": "operator_equals",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if two values are equal.",
+      "inputs": [
+        {"name": "OPERAND1", "type": "any"},
+        {"name": "OPERAND2", "type": "any"}
+      ],
+      "example_standalone": "<(answer) = (5)>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(answer) = (5)> then\n  say [Correct!]",
+          "explanation": "This script makes the sprite say 'Correct!' if the value of the 'answer' variable is exactly 5."
+        }
+      ]
+    },
+    {
+      "block_name": "<() > ()>",
+      "block_type": "operator",
+      "op_code": "operator_gt",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if the first value is greater than the second.",
+      "inputs": [
+        {"name": "OPERAND1", "type": "any"},
+        {"name": "OPERAND2", "type": "any"}
+      ],
+      "example_standalone": "<(health) > (0)>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(health) > (0)> then\n  move (10) steps\nelse\n  stop [all v]\nend",
+          "explanation": "This script moves the sprite if its 'health' is greater than 0; otherwise, it stops all scripts."
+        }
+      ]
+    },
+    {
+      "block_name": "<<> and <>>",
+      "block_type": "operator",
+      "op_code": "operator_and",
+      "block_shape": "Boolean Block",
+      "functionality": "Returns 'true' if both provided Boolean conditions are 'true'.",
+      "inputs": [
+        {"name": "OPERAND1", "type": "boolean"},
+        {"name": "OPERAND2", "type": "boolean"}
+      ],
+      "example_standalone": "<<mouse down?> and <touching [mouse-pointer]?> >",
+      "example_with_other_blocks": [
+        {
+          "script": "if <<mouse down?> and <touching [mouse-pointer]?> > then\n  say [You're clicking me!]\nend",
+          "explanation": "This script makes the sprite say 'You're clicking me!' only if the mouse button is pressed AND the mouse pointer is touching the sprite."
+        }
+      ]
+    },
+    {
+      "block_name": "<<> or <>>",
+      "block_type": "operator",
+      "op_code": "operator_or",
+      "block_shape": "Boolean Block",
+      "functionality": "Returns 'true' if at least one of the provided Boolean conditions is 'true'.",
+      "inputs": [
+        {"name": "OPERAND1", "type": "boolean"},
+        {"name": "OPERAND2", "type": "boolean"}
+      ],
+      "example_standalone": "<<key [left arrow v] pressed?> or <key [a v] pressed?>>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <<key [left arrow v] pressed?> or <key [a v] pressed?>> then\n  change x by (-10)\nend",
+          "explanation": "This script moves the sprite left if either the left arrow key OR the 'a' key is pressed."
+        }
+      ]
+    },
+    {
+      "block_name": "<not <>>",
+      "block_type": "operator",
+      "op_code": "operator_not",
+      "block_shape": "Boolean Block",
+      "functionality": "Returns 'true' if the provided Boolean condition is 'false', and 'false' if it is 'true'.",
+      "inputs": [
+        {"name": "OPERAND", "type": "boolean"}
+      ],
+      "example_standalone": "<not <mouse down?>>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <not <touching [Sprite2 v]?>> then\n  say [I'm safe!]\nend",
+          "explanation": "This script makes the sprite say 'I'm safe!' if it is NOT touching 'Sprite2'."
+        }
+      ]
+    },
+    {
+      "block_name": "<() contains ()?>",
+      "block_type": "operator",
+      "op_code": "operator_contains",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if one string contains another string.",
+      "inputs": [
+        {"name": "STRING1", "type": "string"},
+        {"name": "STRING2", "type": "string"}
+      ],
+      "example_standalone": "<[apple] contains [a]?>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <[answer] contains [yes]?> then\n  say [Great!]\nend",
+          "explanation": "This script makes the sprite say 'Great!' if the 'answer' variable contains the substring 'yes'."
+        }
+      ]
+    },
+    {
+      "block_name": "<touching ()?>",
+      "block_type": "Sensing",
+      "op_code": "sensing_touchingobject",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if its sprite is touching the mouse-pointer, edge, or another specified sprite.",
+      "inputs": [
+        {"name": "TOUCHINGOBJECTMENU", "type": "dropdown", "options": ["mouse-pointer", "edge", "Sprite1", "..." ]}
+      ],
+      "example_standalone": "<touching [edge v]?>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <touching [edge v]?> then\n  bounce off edge\nend",
+          "explanation": "This script makes the sprite reverse direction if it comes into contact with the edge of the stage."
+        }
+      ]
+    },
+    {
+      "block_name": "<touching color ()?>",
+      "block_type": "Sensing",
+      "op_code": "sensing_touchingcolor",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks whether its sprite is touching a specified color.",
+      "inputs": [
+        {"name": "COLOR", "type": "color"}
+      ],
+      "example_standalone": "<touching color [#FF0000]?>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <touching color [#FF0000]?> then\n  change [health v] by (-1)\nend",
+          "explanation": "This script decreases the 'health' variable by 1 if the sprite touches any red color on the stage."
+        }
+      ]
+    },
+    {
+      "block_name": "<color () is touching ()?>",
+      "block_type": "Sensing",
+      "op_code": "sensing_coloristouchingcolor",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks whether a specific color on its sprite is touching another specified color on the stage or another sprite.",
+      "inputs": [
+        {"name": "COLOR1", "type": "color"},
+        {"name": "COLOR2", "type": "color"}
+      ],
+      "example_standalone": "<color [#00FF00] is touching [#FF0000]?>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <color [#00FF00] is touching [#FF0000]?> then\n  say [Collision!]\nend",
+          "explanation": "This script makes the sprite say 'Collision!' if a green part of the sprite touches a red color elsewhere in the project."
+        }
+      ]
+    },
+    {
+      "block_name": "<key () pressed?>",
+      "block_type": "Sensing",
+      "op_code": "sensing_keypressed",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if a specified keyboard key is currently being pressed.",
+      "inputs": [
+        {"name": "KEY_OPTION", "type": "dropdown",
+        "options": [
+            "space",
+            "up arrow",
+            "down arrow",
+            "right arrow",
+            "left arrow",
+            "any",
+            "a",
+            "b",
+            "c",
+            "d",
+            "e",
+            "f",
+            "g",
+            "h",
+            "i",
+            "j",
+            "k",
+            "l",
+            "m",
+            "n",
+            "o",
+            "p",
+            "q",
+            "r",
+            "s",
+            "t",
+            "u",
+            "v",
+            "w",
+            "x",
+            "y",
+            "z",
+            "0",
+            "1",
+            "2",
+            "3",
+            "4",
+            "5",
+            "6",
+            "7",
+            "8",
+            "9"
+          ]}
+      ],
+      "example_standalone": "<key [space v] pressed?>",
+      "example_with_other_blocks": [
+        {
+          "script": "forever\n  if <key [space v] pressed?> then\n    broadcast [shoot v]\n  end\nend",
+          "explanation": "This script continuously checks if the space key is pressed and, if so, sends a 'shoot' broadcast."
+        }
+      ]
+    },
+    {
+      "block_name": "<mouse down?>",
+      "block_type": "Sensing",
+      "op_code": "sensing_mousedown",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if the computer mouse's primary button is being clicked while the cursor is over the stage.",
+      "inputs": null,
+      "example_standalone": "<mouse down?>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <mouse down?> then\n  go to mouse-pointer\nend",
+          "explanation": "This script makes the sprite follow the mouse pointer only when the mouse button is held down."
+        }
+      ]
+    },
+    {
+      "block_name": "<[my list v] contains ()?>",
+      "block_type": "Data",
+      "op_code": "data_listcontainsitem",
+      "block_shape": "Boolean Block",
+      "functionality": "Checks if a list includes a specific item.",
+      "inputs": [
+        {"name": "LIST", "type": "dropdown"},
+        {"name": "ITEM", "type": "any"}
+      ],
+      "example_standalone": "<[inventory v] contains [key]?>",
+      "example_with_other_blocks": [
+        {
+          "script": "if <[inventory v] contains [key]?> then\n  say [You have the key!]\nend",
+          "explanation": "This script makes the sprite say 'You have the key!' if the 'inventory' list contains the item 'key'."
+        }
+      ]
+    }
+  ]
+}

v2/scratch_agent/blocks_v1/c_blocks.json

@@ -0,0 +1,105 @@
+{
+  "block_category": "C Blocks",
+  "description": "C blocks are shaped like the letter 'C'. They are used to loop or conditionally execute blocks that are placed within their opening, managing the flow of scripts.",
+  "blocks": [
+    {
+      "block_name": "repeat ()",
+      "block_type": "Control",
+      "block_shape": "C-Block",
+      "op_code": "control_repeat",
+      "functionality": "Repeats the blocks inside it a specified number of times.",
+      "inputs": [
+        {
+          "name": "times",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "repeat (10)",
+      "example_with_other_blocks": [
+        {
+          "script": "when [space v] key pressed\n  repeat (10)\n    move (10) steps\n    wait (0.1) seconds\n  end",
+          "explanation": "This script makes the sprite move 10 steps Ten times, with a short pause after each movement on spacebar pressed."
+        },
+        {
+          "script": "when [up arrow v] key pressed\n  repeat (10)\n   change y by (10)\n    wait (0.1) seconds\n  change y by (10)\n end",
+          "explanation": "This script makes the sprite jump, with a short pause after each movement on up arrow pressed."
+        }
+      ]
+    },
+    {
+      "block_name": "forever",
+      "block_type": "Control",
+      "block_shape": "C-Block",
+      "op_code": "control_forever",
+      "functionality": "Continuously runs the blocks inside it.",
+      "inputs": null,
+      "example_standalone": "forever",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  forever\n    move (5) steps\n    if on edge, bounce\n  end",
+          "explanation": "This script makes the sprite move endlessly and bounce off the edges of the stage, creating continuous motion."
+        }
+      ]
+    },
+    {
+      "block_name": "if () then",
+      "block_type": "Control",
+      "block_shape": "C-Block",
+      "op_code": "control_if",
+      "functionality": "Executes the blocks inside it only if the specified boolean condition is true.",
+      "inputs": [
+        {
+          "name": "condition",
+          "type": "boolean"
+        }
+      ],
+      "example_standalone": "if <touching [mouse-pointer v]?> then",
+      "example_with_other_blocks": [
+        {
+          "script": "forever\n  if <touching [color (red) v]?> then\n    stop [this script v]\n  end",
+          "explanation": "This script continuously checks if the sprite is touching a red color, and if so, it stops the current script."
+        }
+      ]
+    },
+    {
+      "block_name": "if () then else",
+      "block_type": "Control",
+      "block_shape": "C-Block",
+      "op_code": "control_if_else",
+      "functionality": "Executes one set of blocks if the specified boolean condition is true, and a different set of blocks if the condition is false.",
+      "inputs": [
+        {
+          "name": "condition",
+          "type": "boolean"
+        }
+      ],
+      "example_standalone": "if <score > (10)> then else",
+      "example_with_other_blocks": [
+        {
+          "script": "if <score > (10)> then\n  say [You win!] for (2) seconds\nelse\n  say [Keep trying!] for (2) seconds\nend",
+          "explanation": "This script checks the 'score'. If the score is greater than 10, it says 'You win!'; otherwise, it says 'Keep trying!'."
+        }
+      ]
+    },
+    {
+      "block_name": "repeat until ()",
+      "block_type": "Control",
+      "block_shape": "C-Block",
+      "op_code": "control_repeat_until",
+      "functionality": "Repeats the blocks inside it until the specified boolean condition becomes true.",
+      "inputs": [
+        {
+          "name": "condition",
+          "type": "boolean"
+        }
+      ],
+      "example_standalone": "repeat until <touching [edge v]?>",
+      "example_with_other_blocks": [
+        {
+          "script": "repeat until <touching [edge v]?>\n  move (5) steps\nend",
+          "explanation": "This script makes the sprite move 5 steps repeatedly until it touches the edge of the stage."
+        }
+      ]
+    }
+  ]
+}

v2/scratch_agent/blocks_v1/cap_blocks.json

@@ -0,0 +1,53 @@
+{
+  "block_category": "Cap Blocks",
+  "description": "Cap blocks have a notch at the top and a flat bottom. They signify the end of a script, preventing any further blocks from being placed below them, and are used to terminate scripts or specific actions.",
+  "blocks": [
+    {
+      "block_name": "stop [v]",
+      "block_type": "Control",
+      "block_shape": "Cap Block (dynamic: can be Stack)",
+      "op_code": "control_stop",
+      "functionality": "Halts all scripts, only the current script, or other scripts within the same sprite. Its shape can dynamically change based on the selected option.",
+      "inputs": [
+        {"name": "option", "type": "dropdown", "options": ["all"]}
+      ],
+      "example_standalone": "stop [all v]",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(health) = (0)> then\n  stop [all v]\nend",
+          "explanation": "This script stops all running scripts in the project if the 'health' variable reaches 0, typically signifying a game over condition. [9, 15]"
+        }
+      ]
+    },
+    {
+      "block_name": "delete this clone",
+      "block_type": "Control",
+      "block_shape": "Cap Block",
+      "op_code": "control_delete_this_clone",
+      "functionality": "Removes the clone that is executing it from the stage.",
+      "inputs":null,
+      "example_standalone": "delete this clone",
+      "example_with_other_blocks": [
+        {
+          "script": "when I start as a clone\n  wait until <touching [edge v]?>\n  delete this clone \nend \nend",
+          "explanation": "This script, run by a clone, causes the clone to disappear from the stage once it touches the edge. [1]"
+        }
+      ]
+    },
+    {
+      "block_name": "forever",
+      "block_type": "Control",
+      "block_shape": "Cap Block",
+      "op_code": "control_forever",
+      "functionality": "Continuously runs the blocks inside it.",
+      "inputs": null,
+      "example_standalone": "forever",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  forever\n    move (5) steps\n    if on edge, bounce\n  end",
+          "explanation": "This script makes the sprite move endlessly and bounce off the edges of the stage, creating continuous motion."
+        }
+      ]
+    }
+  ]
+}

v2/scratch_agent/blocks_v1/hat_blocks.json

@@ -0,0 +1,217 @@
+{
+  "block_category": "Hat Blocks",
+  "description": "Hat blocks are characterized by a rounded top and a bump at the bottom. They initiate scripts, meaning they are the starting point for a sequence of interconnected blocks.",
+  "blocks": [
+    {
+      "block_name": "when green flag pressed",
+      "block_type": "Events",
+      "op_code": "event_whenflagclicked",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block initiates the script when the green flag is clicked, serving as the common starting point for most Scratch projects.",
+      "inputs": null,
+      "example_standalone": "when green flag clicked",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  go to x: (0) y: (0)\n  say [Hello!] for (2) seconds",
+          "explanation": "This script makes the sprite go to the center of the stage and then say 'Hello!' for 2 seconds when the green flag is clicked."
+        }
+      ]
+    },
+    {
+      "block_name": "when () key pressed",
+      "block_type": "Events",
+      "op_code": "event_whenkeypressed",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block initiates the script when a specified keyboard key is pressed.",
+      "inputs": [
+        {
+          "name": "key",
+          "type": "dropdown",
+          "options": [
+            "space",
+            "up arrow",
+            "down arrow",
+            "right arrow",
+            "left arrow",
+            "any",
+            "a",
+            "b",
+            "c",
+            "d",
+            "e",
+            "f",
+            "g",
+            "h",
+            "i",
+            "j",
+            "k",
+            "l",
+            "m",
+            "n",
+            "o",
+            "p",
+            "q",
+            "r",
+            "s",
+            "t",
+            "u",
+            "v",
+            "w",
+            "x",
+            "y",
+            "z",
+            "0",
+            "1",
+            "2",
+            "3",
+            "4",
+            "5",
+            "6",
+            "7",
+            "8",
+            "9"
+          ]
+        }
+      ],
+      "example_standalone": "when [space v] key pressed",
+      "example_with_other_blocks": [
+                {
+          "script": "when [space v] key pressed\n  repeat(10)\n change y by (10)\n wait (0.1) seconds\n change y by (-10)",
+          "explanation": "This script made jump the sprite right when the spacebar is pressed."
+        },
+        {
+          "script": "when [right arrow v] key pressed\n  point in direction (90)\n  move (10) steps",
+          "explanation": "This script moves the sprite right when the right arrow key is pressed."
+        }
+      ]
+    },
+    {
+      "block_name": "when this sprite clicked",
+      "block_type": "Events",
+      "op_code": "event_whenthisspriteclicked",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block starts the script when the sprite itself is clicked.",
+      "inputs": null,
+      "example_standalone": "when this sprite clicked",
+      "example_with_other_blocks": [
+        {
+          "script": "when this sprite clicked\n  say [Ouch!] for (1) seconds\n  change [score v] by (-1)",
+          "explanation": "This script makes the sprite say 'Ouch!' and decreases the score by 1 when the sprite is clicked."
+        }
+      ]
+    },
+    {
+      "block_name": "when backdrop switches to ()",
+      "block_type": "Events",
+      "op_code": "event_whenbackdropswitchesto",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block triggers the script when the stage backdrop changes to a specified backdrop.",
+      "inputs": [
+        {
+          "name": "backdrop name",
+          "type": "dropdown",
+          "options": ["backdrop1", "backdrop2", "..."]
+        }
+      ],
+      "example_standalone": "when backdrop switches to [game over v]",
+      "example_with_other_blocks": [
+        {
+          "script": "when backdrop switches to [game over v]\n  stop [all v]",
+          "explanation": "This script stops all running processes when the backdrop changes to 'game over'."
+        },
+        {
+          "script": "when backdrop switches to [level completed v]\n  stop [all v]",
+          "explanation": "This script stops all running processes when the backdrop changes to 'level completed'."
+        }
+      ]
+    },
+    {
+      "block_name": "when () > ()",
+      "block_type": "Events",
+      "op_code": "event_whengreaterthan",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block starts the script when a certain value (e.g., loudness from a microphone, or the timer) exceeds a defined threshold.",
+      "inputs": [
+        {
+          "name": "value type",
+          "type": "dropdown",
+          "options": [
+            "loudness",
+            "timer"
+          ]
+        },
+        {
+          "name": "threshold",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "when [loudness v] > (70)",
+      "example_with_other_blocks": [
+        {
+          "script": "when [loudness v] > (70)\n  start sound [scream v]",
+          "explanation": "This script starts a 'scream' sound when the microphone loudness exceeds 70."
+        }
+      ]
+    },
+    {
+      "block_name": "when I receive ()",
+      "block_type": "Events",
+      "op_code": "event_whenbroadcastreceived",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block initiates the script upon the reception of a specific broadcast message. This mechanism facilitates indirect communication between sprites or the stage.",
+      "inputs": [
+        {
+          "name": "message name",
+          "type": "dropdown",
+          "options": ["message1", "message2", "new message..."]
+        }
+      ],
+      "example_standalone": "when I receive [start game v]",
+      "example_with_other_blocks": [
+        {
+          "script": "when I receive [start game v]\n  show\n  go to x: (0) y: (0)",
+          "explanation": "This script makes the sprite visible and moves it to the center of the stage when it receives the 'start game' broadcast."
+        },
+        {
+          "script": "when I receive [game over v]\n set score to 0 \n stop [all v]",
+          "explanation": "This script stop all reset score on stage when it receives the 'game over' broadcast."
+        }
+      ]
+    },
+    {
+      "block_name": "When I Start as a Clone",
+      "block_type": "Control",
+      "op_code": "control_start_as_clone",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block initiates the script when a clone of the sprite is created. It defines the behavior of individual clones.",
+      "inputs": null,
+      "example_standalone": "When I Start as a Clone",
+      "example_with_other_blocks": [
+        {
+          "script": "when I start as a clone\n  go to x: (pick random -240 to 240) y: (pick random -180 to 180)\n  show\n  forever\n    move (10) steps\n    if on edge, bounce",
+          "explanation": "This script makes a newly created clone appear at a random position, become visible, and then continuously move 10 steps, bouncing if it hits an edge."
+        }
+      ]
+    },
+    {
+      "block_name": "define [my custom block]",
+      "block_type": "My Blocks",
+      "op_code": "procedures_definition",
+      "block_shape": "Hat Block",
+      "functionality": "This Hat block serves as the definition header for a custom block's script. It allows users to define reusable sequences of code by specifying the block's name and any input parameters it will accept. This promotes modularity and abstraction in projects.",
+      "inputs": [
+        {
+          "name": "PROCCONTAINER",
+          "type": "block_prototype"
+        }
+      ],
+      "example_standalone": "define jump (height)",
+      "example_with_other_blocks": [
+        {
+          "script": "define jump (height)\n  change y by (height)\n  wait (0.5) seconds\n  change y by (0 - (height))\n\nwhen green flag clicked\n  jump (50)",
+          "explanation": "This script first defines a custom block named 'jump' that takes a numerical input 'height'. The definition outlines the actions for jumping up and then down. Later, 'jump (50)' is called to make the sprite jump 50 units."
+        }
+      ]
+    }
+  ]
+}

v2/scratch_agent/blocks_v1/reporter_blocks.json

@@ -0,0 +1,709 @@
+{
+  "block_category": "Reporter Blocks",
+  "description": "Reporter blocks have rounded edges. Their purpose is to report values, which can be numbers or strings, and are designed to fit into input slots of other blocks.",
+  "blocks": [
+    {
+      "block_name": "x position",
+      "block_type": "Motion",
+      "op_code": "motion_xposition",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current X-coordinate of the sprite.[NOTE: not used in stage/backdrops]",
+      "inputs": null,
+      "example_standalone": "x position",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  say (x position) for (2) seconds",
+          "explanation": "This script makes the sprite say its current X-coordinate for 2 seconds."
+        }
+      ]
+    },
+    {
+      "block_name": "y position",
+      "block_type": "Motion",
+      "op_code": "motion_yposition",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current Y coordinate of the sprite on the stage.[NOTE: not used in stage/backdrops]",
+      "inputs": null,
+      "example_standalone": "y position",
+      "example_with_other_blocks": [
+        {
+          "script": "set [worms v] to (y position)",
+          "explanation": "This script assigns the sprite's current Y position to the 'worms' variable."
+        }
+      ]
+    },
+    {
+      "block_name": "direction",
+      "block_type": "Motion",
+      "op_code": "motion_direction",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current direction of the sprite in degrees (0 = up, 90 = right, 180 = down, -90 = left).[NOTE: not used in stage/backdrops]",
+      "inputs": null,
+      "example_standalone": "direction",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  say (direction) for (2) seconds",
+          "explanation": "This script makes the sprite say its current direction in degrees for 2 seconds."
+        }
+      ]
+    },
+    {
+      "block_name": "costume ()",
+      "block_type": "Looks",
+      "op_code": "looks_costumenumbername",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current costume's number or name.",
+      "inputs": [
+        {
+          "name": "NUMBER_NAME",
+          "type": "dropdown",
+          "options": [
+            "number",
+            "name"
+          ]
+        }
+      ],
+      "example_standalone": "costume [number v]",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [I am costume ] (costume [name v])",
+          "explanation": "This script makes the sprite display its current costume name in a speech bubble."
+        }
+      ]
+    },
+    {
+      "block_name": "size",
+      "block_type": "Looks",
+      "op_code": "looks_size",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current size of the sprite as a percentage.",
+      "inputs": null,
+      "example_standalone": "size",
+      "example_with_other_blocks": [
+        {
+          "script": "set size to ( (size) + (10) )",
+          "explanation": "This script increases the sprite's size by 10% from its current size."
+        }
+      ]
+    },
+    {
+      "block_name": "backdrop ()",
+      "block_type": "Looks",
+      "op_code": "looks_backdropnumbername",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current backdrop's number or name.",
+      "inputs": [
+        {
+          "name": "NUMBER_NAME",
+          "type": "dropdown",
+          "options": [
+            "number",
+            "name"
+          ]
+        }
+      ],
+      "example_standalone": "backdrop [number v]",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [Current backdrop: ] (backdrop [name v]) for (2) seconds",
+          "explanation": "This script makes the sprite say the name of the current stage backdrop for 2 seconds."
+        }
+      ]
+    },
+    {
+      "block_name": "volume",
+      "block_type": "Sound",
+      "op_code": "sound_volume",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current volume level of the sprite.",
+      "inputs": null,
+      "example_standalone": "volume",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [Current volume: ] (volume)",
+          "explanation": "This script makes the sprite display its current volume level in a speech bubble."
+        }
+      ]
+    },
+    {
+      "block_name": "distance to ()",
+      "block_type": "Sensing",
+      "op_code": "sensing_distanceto",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the distance from the current sprite to the mouse-pointer or another specified sprite.",
+      "inputs": [
+        {
+          "name": "target",
+          "type": "dropdown",
+          "options": ["mouse-pointer", "Sprite1", "Sprite2", "...", "_edge_"]
+        }
+      ],
+      "example_standalone": "distance to [mouse-pointer v]",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(distance to [Sprite2 v]) < (50)> then\n  say [Too close!]",
+          "explanation": "This script makes the sprite say 'Too close!' if it is less than 50 steps away from 'Sprite2'."
+        }
+      ]
+    },
+    {
+      "block_name": "answer",
+      "block_type": "Sensing",
+      "op_code": "sensing_answer",
+      "block_shape": "Reporter Block",
+      "functionality": "Holds the most recent text inputted using the 'Ask () and Wait' block.",
+      "inputs": null,
+      "example_standalone": "answer",
+      "example_with_other_blocks": [
+        {
+          "script": "ask [What is your name?] and wait\n  say join [Hello ] (answer)",
+          "explanation": "This script prompts the user for their name and then uses the 'answer' block to incorporate their input into a greeting."
+        }
+      ]
+    },
+    {
+      "block_name": "mouse x",
+      "block_type": "Sensing",
+      "op_code": "sensing_mousex",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the mouse-pointer’s current X position on the stage.",
+      "inputs": null,
+      "example_standalone": "mouse x",
+      "example_with_other_blocks": [
+        {
+          "script": "go to x: (mouse x) y: (mouse y)",
+          "explanation": "This script makes the sprite follow the mouse pointer's X and Y coordinates."
+        }
+      ]
+    },
+    {
+      "block_name": "mouse y",
+      "block_type": "Sensing",
+      "op_code": "sensing_mousey",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the mouse-pointer’s current Y position on the stage.",
+      "inputs": null,
+      "example_standalone": "mouse y",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(mouse y) < (0)> then\n  say [Below center]",
+          "explanation": "This script makes the sprite say 'Below center' if the mouse pointer is in the lower half of the stage."
+        }
+      ]
+    },
+    {
+      "block_name": "loudness",
+      "block_type": "Sensing",
+      "op_code": "sensing_loudness",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the loudness of noise received by a microphone on a scale of 0 to 100.",
+      "inputs": null,
+      "example_standalone": "loudness",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  forever\n    if <(loudness) > (30)> then\n      start sound [pop v]",
+          "explanation": "This script continuously checks the microphone loudness and plays a 'pop' sound if it exceeds 30."
+        }
+      ]
+    },
+    {
+      "block_name": "timer",
+      "block_type": "Sensing",
+      "op_code": "sensing_timer",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the elapsed time since Scratch was launched or the timer was reset, increasing by 1 every second.",
+      "inputs": null,
+      "example_standalone": "timer",
+      "example_with_other_blocks": [
+        {
+          "script": "when green flag clicked\n  reset timer\n  wait (5) seconds\n  say join [Time elapsed: ] (timer)",
+          "explanation": "This script resets the timer when the green flag is clicked, waits for 5 seconds, and then reports the elapsed time."
+        }
+      ]
+    },
+    {
+      "block_name": "() of ()",
+      "block_type": "Sensing",
+      "op_code": "sensing_of",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports a specified value (e.g., x position, direction, costume number) of a specified sprite or the Stage.",
+      "inputs": [
+        {
+          "name": "value to report",
+          "type": "dropdown",
+          "options": [
+            "x position",
+            "y position",
+            "direction",
+            "costume #",
+            "costume name",
+            "size",
+            "volume",
+            "backdrop #",
+            "backdrop name"
+          ]
+        },
+        {
+          "name": "sprite/stage",
+          "type": "dropdown",
+          "options": ["Stage", "Sprite1", "Sprite2", "...", "_edge_"]
+        }
+      ],
+      "example_standalone": "x position of [Sprite1 v]",
+      "example_with_other_blocks": [
+        {
+          "script": "set [other sprite X v] to ( (x position) of [Sprite2 v] )",
+          "explanation": "This script sets the 'other sprite X' variable to the current X-position of 'Sprite2'."
+        }
+      ]
+    },
+    {
+      "block_name": "current ()",
+      "block_type": "Sensing",
+      "op_code": "sensing_current",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the current local year, month, date, day of the week, hour, minutes, or seconds.",
+      "inputs": [
+        {
+          "name": "time unit",
+          "type": "dropdown",
+          "options": [
+            "year",
+            "month",
+            "date",
+            "day of week",
+            "hour",
+            "minute",
+            "second"
+          ]
+        }
+      ],
+      "example_standalone": "current [hour v]",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [The current hour is ] (current [hour v])",
+          "explanation": "This script makes the sprite say the current hour."
+        }
+      ]
+    },
+    {
+      "block_name": "days since 2000",
+      "block_type": "Sensing",
+      "op_code": "sensing_dayssince2000",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the number of days (and fractions of a day) since 00:00:00 UTC on January 1, 2000.",
+      "inputs": null,
+      "example_standalone": "days since 2000",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [Days passed: ] (days since 2000)",
+          "explanation": "This script makes the sprite display the number of days that have passed since January 1, 2000."
+        }
+      ]
+    },
+    {
+      "block_name": "username",
+      "block_type": "Sensing",
+      "op_code": "sensing_username",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the username of the user currently logged into Scratch. If no user is logged in, it reports nothing.",
+      "inputs": null,
+      "example_standalone": "username",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [Hello, ] (username)",
+          "explanation": "This script makes the sprite greet the user by their Scratch username."
+        }
+      ]
+    },
+    {
+      "block_name": "() + ()",
+      "block_type": "operator",
+      "op_code": "operator_add",
+      "block_shape": "Reporter Block",
+      "functionality": "Adds two numerical values.",
+      "inputs": [
+        {
+          "name": "number1",
+          "type": "number"
+        },
+        {
+          "name": "number2",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "(5) + (3)",
+      "example_with_other_blocks": [
+        {
+          "script": "set [total v] to ( (number 1) + (number 2) )",
+          "explanation": "This script calculates the sum of 'number 1' and 'number 2' and stores the result in the 'total' variable."
+        }
+      ]
+    },
+    {
+      "block_name": "() - ()",
+      "block_type": "operator",
+      "op_code": "operator_subtract",
+      "block_shape": "Reporter Block",
+      "functionality": "Subtracts the second numerical value from the first.",
+      "inputs": [
+        {
+          "name": "number1",
+          "type": "number"
+        },
+        {
+          "name": "number2",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "(10) - (4)",
+      "example_with_other_blocks": [
+        {
+          "script": "set [difference v] to ( (number 1) - (number 2) )",
+          "explanation": "This script calculates the subtraction of 'number 2' from 'number 1' and stores the result in the 'difference' variable."
+        }
+      ]
+    },
+    {
+      "block_name": "() * ()",
+      "block_type": "operator",
+      "op_code": "operator_multiply",
+      "block_shape": "Reporter Block",
+      "functionality": "Multiplies two numerical values.",
+      "inputs": [
+        {
+          "name": "number1",
+          "type": "number"
+        },
+        {
+          "name": "number2",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "(6) * (7)",
+      "example_with_other_blocks": [
+        {
+          "script": "set [area v] to ( (length) * (width) )",
+          "explanation": "This script calculates the area by multiplying 'length' and 'width' variables and stores it in the 'area' variable."
+        }
+      ]
+    },
+    {
+      "block_name": "() / ()",
+      "block_type": "operator",
+      "op_code": "operator_divide",
+      "block_shape": "Reporter Block",
+      "functionality": "Divides the first numerical value by the second.",
+      "inputs": [
+        {
+          "name": "number1",
+          "type": "number"
+        },
+        {
+          "name": "number2",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "(20) / (5)",
+      "example_with_other_blocks": [
+        {
+          "script": "set [average v] to ( (total score) / (number of students) )",
+          "explanation": "This script calculates the average by dividing 'total score' by 'number of students' and stores it in the 'average' variable."
+        }
+      ]
+    },
+    {
+      "block_name": "pick random () to ()",
+      "block_type": "operator",
+      "op_code": "operator_random",
+      "block_shape": "Reporter Block",
+      "functionality": "Generates a random integer within a specified inclusive range.",
+      "inputs": [
+        {
+          "name": "min",
+          "type": "number"
+        },
+        {
+          "name": "max",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "pick random (1) to (10)",
+      "example_with_other_blocks": [
+        {
+          "script": "go to x: (pick random -240 to 240) y: (pick random -180 to 180)",
+          "explanation": "This script moves the sprite to a random position on the stage."
+        }
+      ]
+    },
+    {
+      "block_name": "join ()()",
+      "block_type": "operator",
+      "op_code": "operator_join",
+      "block_shape": "Reporter Block",
+      "functionality": "Concatenates two strings or values into a single string.",
+      "inputs": [
+        {
+          "name": "string1",
+          "type": "string/number"
+        },
+        {
+          "name": "string2",
+          "type": "string/number"
+        }
+      ],
+      "example_standalone": "join [Hello ][World!]",
+      "example_with_other_blocks": [
+        {
+          "script": "say join [Hello ][World!]",
+          "explanation": "This script makes the sprite display 'Hello World!' in a speech bubble by joining two string literals."
+        }
+      ]
+    },
+    {
+      "block_name": "letter () of ()",
+      "block_type": "operator",
+      "op_code": "operator_letterof",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the character at a specific numerical position within a string.",
+      "inputs": [
+        {
+          "name": "index",
+          "type": "number"
+        },
+        {
+          "name": "text",
+          "type": "string"
+        }
+      ],
+      "example_standalone": "letter (1) of [apple]",
+      "example_with_other_blocks": [
+        {
+          "script": "say letter (1) of [apple]",
+          "explanation": "This script makes the sprite display the first character of the string 'apple', which is 'a'."
+        }
+      ]
+    },
+    {
+      "block_name": "length of ()",
+      "block_type": "operator",
+      "op_code": "operator_length",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the total number of characters in a given string.",
+      "inputs": [
+        {
+          "name": "text",
+          "type": "string"
+        }
+      ],
+      "example_standalone": "length of [banana]",
+      "example_with_other_blocks": [
+        {
+          "script": "say length of [banana]",
+          "explanation": "This script makes the sprite display the length of the string 'banana', which is 6."
+        }
+      ]
+    },
+    {
+      "block_name": "() mod ()",
+      "block_type": "operator",
+      "op_code": "operator_mod",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the remainder when the first number is divided by the second.",
+      "inputs": [
+        {
+          "name": "number1",
+          "type": "number"
+        },
+        {
+          "name": "number2",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "(10) mod (3)",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(number) mod (2) = (0)> then\n  say [Even number]",
+          "explanation": "This script checks if a 'number' variable is even by checking if its remainder when divided by 2 is 0."
+        }
+      ]
+    },
+    {
+      "block_name": "round ()",
+      "block_type": "operator",
+      "op_code": "operator_round",
+      "block_shape": "Reporter Block",
+      "functionality": "Rounds a numerical value to the nearest integer.",
+      "inputs": [
+        {
+          "name": "number",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "round (3.7)",
+      "example_with_other_blocks": [
+        {
+          "script": "set [rounded score v] to (round (score))",
+          "explanation": "This script rounds the 'score' variable to the nearest whole number and stores it in 'rounded score'."
+        }
+      ]
+    },
+    {
+      "block_name": "() of ()",
+      "block_type": "operator",
+      "op_code": "operator_mathop",
+      "block_shape": "Reporter Block",
+      "functionality": "Performs various mathematical functions (e.g., absolute value, square root, trigonometric functions).",
+      "inputs": [
+        {
+          "name": "function type",
+          "type": "dropdown",
+          "options": [
+            "abs",
+            "floor",
+            "ceiling",
+            "sqrt",
+            "sin",
+            "cos",
+            "tan",
+            "asin",
+            "acos",
+            "atan",
+            "ln",
+            "log",
+            "e ^",
+            "10 ^"
+          ]
+        },
+        {
+          "name": "value",
+          "type": "number"
+        }
+      ],
+      "example_standalone": "([sqrt v] of (25))",
+      "example_with_other_blocks": [
+        {
+          "script": "set [distance v] to ([sqrt v] of ( ( (x position) * (x position) ) + ( (y position) * (y position) ) ))",
+          "explanation": "This script calculates the distance from the origin (0,0) using the Pythagorean theorem and stores it in 'distance'."
+        }
+      ]
+    },
+    {
+      "block_name": "variable",
+      "block_type": "Data",
+      "op_code": "data_variable",
+      "block_shape": "Reporter Block",
+      "functionality": "Provides the current value stored in a variable.",
+      "inputs": [
+        {
+          "name": "variable name",
+          "type": "dropdown",
+          "options": ["my variable", "score", "..."]
+        }
+      ],
+      "example_standalone": "score",
+      "example_with_other_blocks": [
+        {
+          "script": "say (score) for (2) seconds",
+          "explanation": "This script makes the sprite say the current value of the 'score' variable for 2 seconds."
+        }
+      ]
+    },
+    {
+      "block_name": "list",
+      "block_type": "Data",
+      "op_code": "data_list",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the entire content of a specified list. When clicked in the editor, it displays the list as a monitor.",
+      "inputs": [
+        {
+          "name": "list name",
+          "type": "dropdown",
+          "options": ["my list", "list2", "..."]
+        }
+      ],
+      "example_standalone": "my list",
+      "example_with_other_blocks": [
+        {
+          "script": "say (my list)",
+          "explanation": "This script makes the sprite say all the contents of 'my list'."
+        }
+      ]
+    },
+    {
+      "block_name": "item () of ()",
+      "block_type": "Data",
+      "op_code": "data_itemoflist",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the item located at a specific position in a list.",
+      "inputs": [
+        {
+          "name": "index/option",
+          "type": "number or dropdown",
+          "options": [
+            "last",
+            "random"
+          ]
+        },
+        {
+          "name": "list name",
+          "type": "dropdown",
+          "options": ["shopping list", "my list", "..."]
+        }
+      ],
+      "example_standalone": "item (1) of [shopping list v]",
+      "example_with_other_blocks": [
+        {
+          "script": "say item (1) of [shopping list v]",
+          "explanation": "This script makes the sprite display the first item from the 'shopping list'."
+        }
+      ]
+    },
+    {
+      "block_name": "length of () (list)",
+      "block_type": "Data",
+      "op_code": "data_lengthoflist",
+      "block_shape": "Reporter Block",
+      "functionality": "Provides the total number of items contained in a list.",
+      "inputs": [
+        {
+          "name": "list name",
+          "type": "dropdown",
+          "options": ["my list", "shopping list", "..."]
+        }
+      ],
+      "example_standalone": "length of [my list v]",
+      "example_with_other_blocks": [
+        {
+          "script": "say join (length of [shopping list v]) [ items in the list.]",
+          "explanation": "This script makes the sprite display the total number of items currently in the 'shopping list'."
+        }
+      ]
+    },
+    {
+      "block_name": "item # of () in ()",
+      "block_type": "Data",
+      "op_code": "data_itemnumoflist",
+      "block_shape": "Reporter Block",
+      "functionality": "Reports the index number of the first occurrence of a specified item in a list. If the item is not found, it reports 0.",
+      "inputs": [
+        {
+          "name": "item",
+          "type": "string/number"
+        },
+        {
+          "name": "list name",
+          "type": "dropdown",
+          "options": ["my list", "shopping list", "..."]
+        }
+      ],
+      "example_standalone": "item # of [apple] in [shopping list v]",
+      "example_with_other_blocks": [
+        {
+          "script": "if <(item # of [banana] in [my list v]) > (0)> then\n  say join [Banana found at position ] (item # of [banana] in [my list v])",
+          "explanation": "This script checks if 'banana' is in 'my list' and, if so, reports its position."
+        }
+      ]
+    }
+  ]
+}

v2/scratch_agent/blocks_v1/stack_blocks.json

@@ -0,0 +1,1316 @@
+{
+    "block_category": "Stack Blocks",
+    "description": "Stack blocks are the most common block shape, featuring a notch at the top and a bump at the bottom. They perform the main commands within a script and can connect both above and below them.",
+    "blocks": [
+        {
+            "block_name": "move () steps",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_movesteps",
+            "functionality": "Moves the sprite forward by the specified number of steps in the direction it is currently facing. A positive value moves it forward, and a negative value moves it backward.",
+            "inputs": [
+                {
+                    "name": "STEPS",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "move () steps",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  go to x: (0) y: (0)\n  point in direction (90)\n  move (50) steps",
+                    "explanation": "This script first places the sprite at the center of the stage, points it to the right (90 degrees), and then moves it 50 steps in that direction."
+                }
+            ]
+        },
+        {
+            "block_name": "turn right () degrees",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_turnright",
+            "functionality": "Turns the sprite clockwise by the specified number of degrees.",
+            "inputs": [
+                {
+                    "name": "DEGREES",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "turn (clockwise icon) (15) degrees",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [right arrow v] key pressed\n  turn (clockwise icon) (15) degrees",
+                    "explanation": "This script makes the sprite turn clockwise by 15 degrees every time the right arrow key is pressed."
+                },
+                {
+                    "script": "when green flag clicked\n  forever\n    turn (clockwise icon) (15) degrees\n    wait (0.5) seconds\n  end",
+                    "explanation": "This script makes the sprite continuously spin clockwise by 15 degrees every half second."
+                }
+            ]
+        },
+        {
+            "block_name": "turn left () degrees",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_turnleft",
+            "functionality": "Turns the sprite counter-clockwise by the specified number of degrees.",
+            "inputs": [
+                {
+                    "name": "DEGREES",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "turn (counter-clockwise icon) (15) degrees",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [left arrow v] key pressed\n  turn (counter-clockwise icon) (15) degrees",
+                    "explanation": "This script makes the sprite turn counter-clockwise by 15 degrees every time the left arrow key is pressed."
+                },
+                {
+                    "script": "when green flag clicked\n  forever\n    turn (counter-clockwise icon) (15) degrees\n    wait (0.5) seconds\n  end",
+                    "explanation": "This script makes the sprite continuously spin counter-clockwise by 15 degrees every half second."
+                }
+            ]
+        },
+        {
+            "block_name": "go to ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_goto",
+            "functionality": "Moves the sprite to a specified location, which can be a random position, the mouse pointer, or another sprite.",
+            "inputs": [
+                {
+                    "name": "TO",
+                    "type": "dropdown",
+                    "options": [
+                        "random position",
+                        "mouse-pointer",
+                        "sprite1",
+                        "..."
+                    ]
+                }
+            ],
+            "example_standalone": "go to [random position v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when this sprite clicked\n  go to [mouse-pointer v]",
+                    "explanation": "This script moves the sprite to the current position of the mouse pointer whenever the sprite is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "go to x: () y: ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_gotoxy",
+            "functionality": "Moves the sprite to the specified X and Y coordinates on the stage.",
+            "inputs": [
+                {
+                    "name": "X",
+                    "type": "number"
+                },
+                {
+                    "name": "Y",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "go to x: (0) y: (0)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  go to x: (0) y: (0)\n  say [Ready to start!] for (1) seconds",
+                    "explanation": "This script positions the sprite at the center of the stage at the beginning of the project and then makes it say 'Ready to start!'."
+                }
+            ]
+        },
+        {
+            "block_name": "glide () secs to ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_glideto",
+            "functionality": "Glides the sprite smoothly to a specified location (random position, mouse pointer, or another sprite) over a given number of seconds.",
+            "inputs": [
+                {
+                    "name": "SECS",
+                    "type": "number"
+                },
+                {
+                    "name": "TO",
+                    "type": "dropdown",
+                    "options": [
+                        "random position",
+                        "mouse-pointer",
+                        "sprite1",
+                        "..."
+                    ]
+                }
+            ],
+            "example_standalone": "glide (1) secs to [random position v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  glide (1) secs to [mouse-pointer v]",
+                    "explanation": "This script makes the sprite glide smoothly to the mouse pointer's position over 1 second when the green flag is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "glide () secs to x: () y: ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_glidesecstoxy",
+            "functionality": "Glides the sprite smoothly to the specified X and Y coordinates over a given number of seconds.",
+            "inputs": [
+                {
+                    "name": "SECS",
+                    "type": "number"
+                },
+                {
+                    "name": "X",
+                    "type": "number"
+                },
+                {
+                    "name": "Y",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "glide (1) secs to x: (100) y: (50)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  glide (2) secs to x: (150) y: (-100)\n  glide (2) secs to x: (-150) y: (100)",
+                    "explanation": "This script makes the sprite glide to two different points on the stage, taking 2 seconds for each movement."
+                }
+            ]
+        },
+        {
+            "block_name": "point in direction ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_pointindirection",
+            "functionality": "Sets the sprite's direction to a specified angle in degrees (0 = up, 90 = right, 180 = down, -90 = left).",
+            "inputs": [
+                {
+                    "name": "DIRECTION",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "point in direction (90)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  point in direction (0)\n  move (100) steps",
+                    "explanation": "This script makes the sprite point upwards (0 degrees) and then move 100 steps in that direction."
+                }
+            ]
+        },
+        {
+            "block_name": "point towards ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_pointtowards",
+            "functionality": "Points the sprite towards the mouse pointer or another specified sprite.",
+            "inputs": [
+                {
+                    "name": "TOWARDS",
+                    "type": "dropdown",
+                    "options": [
+                        "mouse-pointer",
+                        "sprite1",
+                        "..."
+                    ]
+                }
+            ],
+            "example_standalone": "point towards [mouse-pointer v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when this sprite clicked\n  point towards [mouse-pointer v]\n  move (10) steps",
+                    "explanation": "When the sprite is clicked, it will point towards the mouse pointer and then move 10 steps in that direction."
+                },
+                {
+                    "script": "when green flag clicked\n  forever\n    point towards [mouse-pointer v]\n    move (5) steps\n  end",
+                    "explanation": "This script makes the sprite continuously follow the mouse pointer."
+                }
+            ]
+        },
+        {
+            "block_name": "change x by ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_changexby",
+            "functionality": "Changes the sprite's X-coordinate by the specified amount, moving it horizontally.",
+            "inputs": [
+                {
+                    "name": "DX",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "change x by (10)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [right arrow v] key pressed\n  change x by (10)",
+                    "explanation": "This script moves the sprite 10 steps to the right when the right arrow key is pressed."
+                }
+            ]
+        },
+        {
+            "block_name": "set x to ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_setx",
+            "functionality": "Sets the sprite's X-coordinate to a specific value, placing it at a precise horizontal position.",
+            "inputs": [
+                {
+                    "name": "X",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "set x to (0)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  set x to (0)\n  set y to (0)",
+                    "explanation": "This script centers the sprite horizontally at the start of the project."
+                }
+            ]
+        },
+        {
+            "block_name": "change y by ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_changeyby",
+            "functionality": "Changes the sprite's Y-coordinate by the specified amount, moving it vertically.",
+            "inputs": [
+                {
+                    "name": "DY",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "change y by (10)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [up arrow v] key pressed\n  change y by (10)",
+                    "explanation": "This script moves the sprite 10 steps up when the up arrow key is pressed."
+                }
+            ]
+        },
+        {
+            "block_name": "set y to ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_sety",
+            "functionality": "Sets the sprite's Y-coordinate to a specific value, placing it at a precise vertical position.",
+            "inputs": [
+                {
+                    "name": "Y",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "set y to (0)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  set x to (0)\n  set y to (0)",
+                    "explanation": "This script centers the sprite vertically at the start of the project."
+                }
+            ]
+        },
+        {
+            "block_name": "if on edge, bounce",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_ifonedgebounce",
+            "functionality": "Reverses the sprite's direction if it touches the edge of the stage.",
+            "inputs": null,
+            "example_standalone": "if on edge, bounce",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I receive [start moving v]\n  repeat (50)\n    move (5) steps\n    if on edge, bounce\n  end",
+                    "explanation": "Upon receiving the 'start moving' broadcast, the sprite will move 5 steps repeatedly for 50 times, bouncing off edges if it touches them."
+                },
+                {
+                    "script": "when green flag clicked\n  forever\n    move (10) steps\n    if on edge, bounce\n  end",
+                    "explanation": "This script makes the sprite move continuously and bounce off the edges of the stage."
+                }
+            ]
+        },
+        {
+            "block_name": "set rotation style ()",
+            "block_type": "Motion",
+            "block_shape": "Stack Block",
+            "op_code": "motion_setrotationstyle",
+            "functionality": "Determines how the sprite rotates: 'left-right' (flips horizontally), 'don't rotate' (stays facing one direction), or 'all around' (rotates freely).",
+            "inputs": [
+                {
+                    "name": "STYLE",
+                    "type": "dropdown",
+                    "options": [
+                        "left-right",
+                        "don't rotate",
+                        "all around"
+                    ]
+                }
+            ],
+            "example_standalone": "set rotation style [left-right v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when backdrop switches to [game level 1 v]\n  set rotation style [all around v]",
+                    "explanation": "When the backdrop changes to 'game level 1', the sprite's rotation style will be set to 'all around', allowing it to rotate freely."
+                },
+                {
+                    "script": "when green flag clicked\n  set rotation style [left-right v]\n  forever\n    move (10) steps\n    if on edge, bounce\n  end",
+                    "explanation": "This script makes the sprite move horizontally and flip its costume when it hits an edge, instead of rotating."
+                }
+            ]
+        },
+        {
+            "block_name": "say () for () seconds",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_sayforsecs",
+            "functionality": "Displays a speech bubble containing specified text for a set duration.",
+            "inputs": [
+                {
+                    "name": "MESSAGE",
+                    "type": "string"
+                },
+                {
+                    "name": "SECS",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "say [Hello!] for (2) seconds",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   say [Grr] for (3) seconds\n   say [Have you seen my honey?] for (3) seconds",
+                    "explanation": "This script makes the sprite display two sequential speech bubbles with different messages and durations. First, it says 'Grr' for 3 seconds, then 'Have you seen my honey?' for another 3 seconds."
+                }
+            ]
+        },
+        {
+            "block_name": "say ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_say",
+            "functionality": "Displays a speech bubble with the specified text indefinitely until another 'say' or 'think' block is activated.",
+            "inputs": [
+                {
+                    "name": "MESSAGE",
+                    "type": "string"
+                }
+            ],
+            "example_standalone": "say [Hello!]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   say [Welcome to my game!]\n   wait (2) seconds\n   say []",
+                    "explanation": "This script makes the sprite say 'Welcome to my game!' for 2 seconds, then clears the speech bubble."
+                }
+            ]
+        },
+        {
+            "block_name": "think () for () seconds",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_thinkforsecs",
+            "functionality": "Displays a thought bubble containing specified text for a set duration.",
+            "inputs": [
+                {
+                    "name": "MESSAGE",
+                    "type": "string"
+                },
+                {
+                    "name": "SECS",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "think [Hmm...] for (2) seconds",
+            "example_with_other_blocks": [
+                {
+                    "script": "when this sprite clicked\n   think [What should I do?] for (2) seconds",
+                    "explanation": "This script makes the sprite display a thought bubble saying 'What should I do?' for 2 seconds when clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "think ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_think",
+            "functionality": "Displays a thought bubble with the specified text indefinitely until another 'say' or 'think' block is activated.",
+            "inputs": [
+                {
+                    "name": "MESSAGE",
+                    "type": "string"
+                }
+            ],
+            "example_standalone": "think [Got it!]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I receive [correct answer v]\n   think [That's right!]\n   wait (1) seconds\n   think []",
+                    "explanation": "This script makes the sprite think 'That's right!' for 1 second when a 'correct answer' broadcast is received, then clears the thought bubble."
+                }
+            ]
+        },
+        {
+            "block_name": "switch costume to ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_switchcostumeto",
+            "functionality": "Alters the sprite's appearance to a designated costume.",
+            "inputs": [
+                {
+                    "name": "COSTUME",
+                    "type": "dropdown/number"
+                }
+            ],
+            "example_standalone": "switch costume to [costume1 v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I receive [explosion v]\n   repeat (5)\n     next costume\n   end\n   hide",
+                    "explanation": "This script animates an explosion by rapidly switching costumes, then hides the sprite. [3]"
+                }
+            ]
+        },
+        {
+            "block_name": "next costume",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_nextcostume",
+            "functionality": "Switches the sprite's costume to the next one in its costume list. If it's the last costume, it cycles back to the first.",
+            "inputs": null,
+            "example_standalone": "next costume",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [space v] key pressed\n  repeat (3)\n    next costume\n    wait (0.1) seconds\n  end",
+                    "explanation": "When the space key is pressed, the sprite will cycle through its next three costumes with a short delay between each change."
+                },
+                {
+                    "script": "when green flag clicked\n   forever\n     next costume\n     wait (0.2) seconds\n   end",
+                    "explanation": "This script continuously animates the sprite by switching to the next costume every 0.2 seconds, creating a walking or flying effect."
+                }
+            ]
+        },
+        {
+            "block_name": "switch backdrop to ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_switchbackdropto",
+            "functionality": "Changes the stage's backdrop to a specified backdrop.",
+            "inputs": [
+                {
+                    "name": "BACKDROP",
+                    "type": "dropdown/number"
+                }
+            ],
+            "example_standalone": "switch backdrop to [backdrop1 v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   switch backdrop to [start screen v]",
+                    "explanation": "This script sets the stage to a 'start screen' backdrop when the project begins."
+                }
+            ]
+        },
+        {
+            "block_name": "switch backdrop to () and wait",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_switchbackdroptowait",
+            "functionality": "Changes the stage's backdrop to a specified backdrop and pauses the script until any 'When backdrop switches to' scripts for that backdrop have finished.",
+            "inputs": [
+                {
+                    "name": "BACKDROP",
+                    "type": "dropdown/number"
+                }
+            ],
+            "example_standalone": "switch backdrop to [game over v] and wait",
+            "example_with_other_blocks": [
+                {
+                    "script": "broadcast [game over v]\n   switch backdrop to [game over v] and wait\n   stop [all v]",
+                    "explanation": "This script broadcasts a 'game over' message, then changes the backdrop to 'game over' and waits for any associated scripts to finish before stopping all processes."
+                }
+            ]
+        },
+        {
+            "block_name": "next backdrop",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_nextbackdrop",
+            "functionality": "Switches the stage's backdrop to the next one in its backdrop list. If it's the last backdrop, it cycles back to the first.",
+            "inputs": null,
+            "example_standalone": "next backdrop",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [space v] key pressed\n   next backdrop",
+                    "explanation": "This script changes the stage to the next backdrop in the list each time the space key is pressed."
+                }
+            ]
+        },
+        {
+            "block_name": "change size by ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_changesizeby",
+            "functionality": "Changes the sprite's size by a specified percentage. Positive values make it larger, negative values make it smaller.",
+            "inputs": [
+                {
+                    "name": "CHANGE",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "change size by (10)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   repeat (10)\n     change size by (5)\n     wait (0.1) seconds\n   end",
+                    "explanation": "This script makes the sprite gradually grow larger over 10 steps, with a short pause between each size change."
+                }
+            ]
+        },
+        {
+            "block_name": "set size to () %",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_setsizeto",
+            "functionality": "Sets the sprite's size to a specific percentage of its original size.",
+            "inputs": [
+                {
+                    "name": "SIZE",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "set size to (100) %",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   set size to (50) %\n   wait (1) seconds\n   set size to (100) %",
+                    "explanation": "This script makes the sprite shrink to half its original size at the start, waits for 1 second, then returns to its original size."
+                }
+            ]
+        },
+        {
+            "block_name": "change () effect by ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_changeeffectby",
+            "functionality": "Changes a visual effect on the sprite by a specified amount (e.g., color, fisheye, whirl, pixelate, mosaic, brightness, ghost).",
+            "inputs": [
+                {
+                    "name": "EFFECT",
+                    "type": "dropdown",
+                    "options": [
+                        "color",
+                        "fisheye",
+                        "whirl",
+                        "pixelate",
+                        "mosaic",
+                        "brightness",
+                        "ghost"
+                    ]
+                },
+                {
+                    "name": "CHANGE",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "change [color v] effect by (25)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when loudness > (10)\n  change [fisheye v] effect by (5)",
+                    "explanation": "When the loudness detected by the microphone is greater than 10, the sprite's fisheye effect will increase by 5."
+                },
+                {
+                    "script": "when green flag clicked\n   forever\n     change [color v] effect by (5)\n     wait (0.1) seconds\n   end",
+                    "explanation": "This script makes the sprite continuously cycle through different colors."
+                }
+            ]
+        },
+        {
+            "block_name": "set () effect to ()",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_seteffectto",
+            "functionality": "Sets a visual effect on the sprite to a specific value.",
+            "inputs": [
+                {
+                    "name": "EFFECT",
+                    "type": "dropdown",
+                    "options": [
+                        "color",
+                        "fisheye",
+                        "whirl",
+                        "pixelate",
+                        "mosaic",
+                        "brightness",
+                        "ghost"
+                    ]
+                },
+                {
+                    "name": "VALUE",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "set [ghost v] effect to (50)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   set [ghost v] effect to (75)",
+                    "explanation": "This script makes the sprite 75% transparent at the start of the project."
+                }
+            ]
+        },
+        {
+            "block_name": "clear graphic effects",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_cleargraphiceffects",
+            "functionality": "Removes all visual effects applied to the sprite.",
+            "inputs": null,
+            "example_standalone": "clear graphic effects",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   change [color v] effect by (50)\n   wait (2) seconds\n   clear graphic effects",
+                    "explanation": "This script changes the sprite's color effect, waits 2 seconds, then resets all graphic effects."
+                }
+            ]
+        },
+        {
+            "block_name": "show",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_show",
+            "functionality": "Makes the sprite visible on the stage.",
+            "inputs": null,
+            "example_standalone": "show",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   hide\nwhen I receive [start game v]\n   show",
+                    "explanation": "This script hides the sprite at the beginning of the project and makes it visible when a 'start game' broadcast is received."
+                }
+            ]
+        },
+        {
+            "block_name": "hide",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_hide",
+            "functionality": "Makes the sprite invisible on the stage.",
+            "inputs": null,
+            "example_standalone": "hide",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   hide",
+                    "explanation": "This script hides the sprite from the stage when the green flag is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "go to () layer",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_gotofrontback",
+            "functionality": "Moves the sprite to the front-most or back-most layer of other sprites on the stage.",
+            "inputs": [
+                {
+                    "name": "FRONT_BACK",
+                    "type": "dropdown",
+                    "options": [
+                        "front",
+                        "back"
+                    ]
+                }
+            ],
+            "example_standalone": "go to [front v] layer",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   go to [front v] layer",
+                    "explanation": "This script ensures the sprite is always visible on top of other sprites at the start of the project."
+                }
+            ]
+        },
+        {
+            "block_name": "go () layers",
+            "block_type": "Looks",
+            "block_shape": "Stack Block",
+            "op_code": "looks_goforwardbackwardlayers",
+            "functionality": "Moves the sprite forward or backward a specified number of layers in relation to other sprites.",
+            "inputs": [
+                {
+                    "name": "FORWARD_BACKWARD",
+                    "type": "dropdown",
+                    "options": [
+                        "forward",
+                        "backward"
+                    ]
+                },
+                {
+                    "name": "NUM",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "go [forward v] (1) layers",
+            "example_with_other_blocks": [
+                {
+                    "script": "when this sprite clicked go [forward v] (1) layers",
+                    "explanation": "This script brings the clicked sprite one layer closer to the front."
+                }
+            ]
+        },
+        {
+            "block_name": "play sound () until done",
+            "block_type": "Sound",
+            "block_shape": "Stack Block",
+            "op_code": "sound_playuntildone",
+            "functionality": "Plays a specified sound and pauses the script's execution until the sound has completed.",
+            "inputs": [
+                {
+                    "name": "sound name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "play sound [Meow v] until done",
+            "example_with_other_blocks": [
+                {
+                    "script": "when backdrop switches to [winning screen v]\n  play sound [fanfare v] until done\n  say [You won!] for (2) seconds",
+                    "explanation": "When the backdrop changes to the 'winning screen', a 'fanfare' sound will play until it finishes, and then the sprite will say 'You won!' for 2 seconds."
+                },
+                {
+                    "script": "forever\n   play sound [Music v] until done",
+                    "explanation": "This script creates a continuous loop for background music, playing the 'Music' sound repeatedly."
+                }
+            ]
+        },
+        {
+            "block_name": "start sound ()",
+            "block_type": "Sound",
+            "block_shape": "Stack Block",
+            "op_code": "sound_start",
+            "functionality": "Initiates playback of a specified sound without pausing the script, allowing other actions to proceed concurrently.",
+            "inputs": [
+                {
+                    "name": "sound name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "start sound [Pop v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when this sprite clicked\n   start sound [Pop v]\n   change [score v] by (1)",
+                    "explanation": "This script plays a 'Pop' sound and increments the score simultaneously when the sprite is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "stop all sounds",
+            "block_type": "Sound",
+            "block_shape": "Stack Block",
+            "op_code": "sound_stopallsounds",
+            "functionality": "Stops all currently playing sounds.",
+            "inputs": null,
+            "example_standalone": "stop all sounds",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I receive [game over v]\n   stop all sounds",
+                    "explanation": "This script stops any sounds currently playing when the 'game over' broadcast is received."
+                }
+            ]
+        },
+        {
+            "block_name": "change volume by ()",
+            "block_type": "Sound",
+            "block_shape": "Stack Block",
+            "op_code": "sound_changevolumeby",
+            "functionality": "Changes the project's sound volume by a specified amount.",
+            "inputs": [
+                {
+                    "name": "change",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "change volume by (-10)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when [down arrow v] key pressed\n   change volume by (-5)",
+                    "explanation": "This script decreases the project's volume by 5 when the down arrow key is pressed."
+                }
+            ]
+        },
+        {
+            "block_name": "set volume to () %",
+            "block_type": "Sound",
+            "block_shape": "Stack Block",
+            "op_code": "sound_setvolumeto",
+            "functionality": "Sets the sound volume to a specific percentage (0-100).",
+            "inputs": [
+                {
+                    "name": "percentage",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "set volume to (100) %",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n   set volume to (50) %",
+                    "explanation": "This script sets the project's volume to 50% when the green flag is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "broadcast ()",
+            "block_type": "Events",
+            "block_shape": "Stack Block",
+            "op_code": "event_broadcast",
+            "functionality": "Sends a broadcast message throughout the Scratch program, activating any 'when I receive ()' blocks that are set to listen for that message, enabling indirect communication.",
+            "inputs": [
+                {
+                    "name": "message name",
+                    "type": "string/dropdown"
+                }
+            ],
+            "example_standalone": "broadcast [start game v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "if <key [space v] pressed?> then\n  broadcast [jump v]\nend",
+                    "explanation": "This script sends a 'jump' message to other scripts or sprites when the space key is pressed."
+                }
+            ]
+        },
+        {
+            "block_name": "broadcast () and wait",
+            "block_type": "Events",
+            "block_shape": "Stack Block",
+            "op_code": "event_broadcastandwait",
+            "functionality": "Sends a broadcast message and pauses the current script until all other scripts activated by that broadcast have completed their execution, ensuring sequential coordination.",
+            "inputs": [
+                {
+                    "name": "message name",
+                    "type": "string/dropdown"
+                }
+            ],
+            "example_standalone": "broadcast [initialize sprites v] and wait",
+            "example_with_other_blocks": [
+                {
+                    "script": "broadcast [initialize sprites v] and wait\n  say [Game Started!] for (2) seconds",
+                    "explanation": "This script ensures all sprite initialization routines complete before displaying 'Game Started!' for 2 seconds."
+                }
+            ]
+        },
+        {
+            "block_name": "wait () seconds",
+            "block_type": "Control",
+            "block_shape": "Stack Block",
+            "op_code": "control_wait",
+            "functionality": "Pauses the script for a specified duration.",
+            "inputs": [
+                {
+                    "name": "seconds",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "wait (1) seconds",
+            "example_with_other_blocks": [
+                {
+                    "script": "say [Hello!] for (1) seconds\n   wait (0.5) seconds\n   say [Goodbye!] for (1) seconds",
+                    "explanation": "This script creates a timed dialogue sequence, pausing for 0.5 seconds between two speech bubbles."
+                }
+            ]
+        },
+        {
+            "block_name": "wait until ()",
+            "block_type": "Control",
+            "block_shape": "Stack Block",
+            "op_code": "control_wait_until",
+            "functionality": "Pauses the script until the specified boolean condition becomes true.",
+            "inputs": [
+                {
+                    "name": "condition",
+                    "type": "boolean"
+                }
+            ],
+            "example_standalone": "wait until <key [space v] pressed?>",
+            "example_with_other_blocks": [
+                {
+                    "script": "wait until <key [space v] pressed?>\n   start sound [pop v]",
+                    "explanation": "This script pauses until the space key is pressed, then plays a 'pop' sound."
+                }
+            ]
+        },
+        {
+            "block_name": "stop ()",
+            "block_type": "Control",
+            "block_shape": "Stack Block",
+            "op_code": "control_stop",
+            "functionality": "Stops all scripts, this script, or other scripts in the sprite. Becomes a Cap Block if 'all' or 'this script' is selected in the dropdown menu.",
+            "inputs": [
+                {
+                    "name": "option",
+                    "type": "dropdown",
+                    "options": [
+                        "all",
+                        "this script",
+                        "other scripts in sprite"
+                    ]
+                }
+            ],
+            "example_standalone": "stop [all v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "if <score = (0)> then\n   stop [all v]\nend",
+                    "explanation": "This script stops the entire project if the 'score' variable becomes 0."
+                }
+            ]
+        },
+        {
+            "block_name": "create clone of ()",
+            "block_type": "Control",
+            "block_shape": "Stack Block",
+            "op_code": "control_create_clone_of",
+            "functionality": "Generates a copy, or clone, of a specified sprite (or 'myself' for the current sprite).",
+            "inputs": [
+                {
+                    "name": "sprite_name",
+                    "type": "dropdown",
+                    "options": [
+                        "myself",
+                        "sprite1",
+                        "..."
+                    ]
+                }
+            ],
+            "example_standalone": "create clone of [myself v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I start as a clone\n  show\n  go to random position\n  wait (2) seconds\n  delete this clone",
+                    "explanation": "When a clone is created, it will show itself, go to a random position, wait for 2 seconds, and then delete itself."
+                }
+            ]
+        },
+        {
+            "block_name": "delete this clone",
+            "block_type": "Control",
+            "block_shape": "Stack Block",
+            "op_code": "control_delete_this_clone",
+            "functionality": "Deletes the clone that is currently running the script.",
+            "inputs": null,
+            "example_standalone": "delete this clone",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I start as a clone\n   wait (5) seconds\n   delete this clone",
+                    "explanation": "This script makes each clone wait for 5 seconds after it's created, then deletes itself."
+                }
+            ]
+        },
+        {
+            "block_name": "set [my variable v] to ()",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_setvariableto",
+            "functionality": "Assigns a specific value (number, string, or boolean) to a variable.",
+            "inputs": [
+                {
+                    "name": "variable name",
+                    "type": "dropdown"
+                },
+                {
+                    "name": "value",
+                    "type": "any"
+                }
+            ],
+            "example_standalone": "set [score v] to (0)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  set [score v] to (0)\n  set [player name v] to [Guest]",
+                    "explanation": "This script initializes the 'score' variable to 0 and the 'player name' variable to 'Guest' when the project starts."
+                }
+            ]
+        },
+        {
+            "block_name": "change [my variable v] by ()",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_changevariableby",
+            "functionality": "Increases or decreases a variable's numerical value by a specified amount.",
+            "inputs": [
+                {
+                    "name": "variable name",
+                    "type": "dropdown"
+                },
+                {
+                    "name": "value",
+                    "type": "number"
+                }
+            ],
+            "example_standalone": "change [score v] by (1)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when this sprite clicked\n  change [score v] by (1)",
+                    "explanation": "This script increments the 'score' variable by 1 each time the sprite is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "add () to [my list v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_addtolist",
+            "functionality": "Appends an item to the end of a list.",
+            "inputs": [
+                {
+                    "name": "item",
+                    "type": "any"
+                },
+                {
+                    "name": "list name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "add [apple] to [shopping list v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  add [apple] to [shopping list v]\n  add [banana] to [shopping list v]",
+                    "explanation": "This script adds 'apple' and 'banana' as new items to the 'shopping list' when the project starts."
+                }
+            ]
+        },
+        {
+            "block_name": "delete () of [my list v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_deleteoflist",
+            "functionality": "Removes an item from a list by its index or by selecting 'all' items.",
+            "inputs": [
+                {
+                    "name": "index/option",
+                    "type": "number/dropdown",
+                    "options": [
+                        "all",
+                        "last",
+                        "random"
+                    ]
+                },
+                {
+                    "name": "list name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "delete (1) of [my list v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  delete (all) of [my list v]",
+                    "explanation": "This script clears all items from 'my list' when the green flag is clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "insert () at () of [my list v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_insertatlist",
+            "functionality": "Inserts an item at a specific position within a list.",
+            "inputs": [
+                {
+                    "name": "item",
+                    "type": "any"
+                },
+                {
+                    "name": "index",
+                    "type": "number"
+                },
+                {
+                    "name": "list name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "insert [orange] at (2) of [fruits v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "insert [orange] at (2) of [fruits v]",
+                    "explanation": "This script inserts 'orange' as the second item in the 'fruits' list, shifting subsequent items."
+                }
+            ]
+        },
+        {
+            "block_name": "replace item () of [my list v] with ()",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_replaceitemoflist",
+            "functionality": "Replaces an item at a specific position in a list with a new value.",
+            "inputs": [
+                {
+                    "name": "index",
+                    "type": "number"
+                },
+                {
+                    "name": "list name",
+                    "type": "dropdown"
+                },
+                {
+                    "name": "new item",
+                    "type": "any"
+                }
+            ],
+            "example_standalone": "replace item (1) of [colors v] with [blue]",
+            "example_with_other_blocks": [
+                {
+                    "script": "replace item (1) of [colors v] with [blue]",
+                    "explanation": "This script changes the first item in the 'colors' list to 'blue'."
+                }
+            ]
+        },
+        {
+            "block_name": "show variable [my variable v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_showvariable",
+            "functionality": "Makes a variable's monitor visible on the stage.",
+            "inputs": [
+                {
+                    "name": "variable name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "show variable [score v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  show variable [score v]",
+                    "explanation": "This script displays the 'score' variable on the stage when the project starts."
+                }
+            ]
+        },
+        {
+            "block_name": "hide variable [my variable v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_hidevariable",
+            "functionality": "Hides a variable's monitor from the stage.",
+            "inputs": [
+                {
+                    "name": "variable name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "hide variable [score v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I receive [game over v]\n  hide variable [score v]",
+                    "explanation": "This script hides the 'score' variable when the 'game over' broadcast is received."
+                }
+            ]
+        },
+        {
+            "block_name": "show list [my list v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_showlist",
+            "functionality": "Makes a list's monitor visible on the stage.",
+            "inputs": [
+                {
+                    "name": "list name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "show list [shopping list v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  show list [shopping list v]",
+                    "explanation": "This script displays the 'shopping list' on the stage when the project starts."
+                }
+            ]
+        },
+        {
+            "block_name": "hide list [my list v]",
+            "block_type": "Data",
+            "block_shape": "Stack Block",
+            "op_code": "data_hidelist",
+            "functionality": "Hides a list's monitor from the stage.",
+            "inputs": [
+                {
+                    "name": "list name",
+                    "type": "dropdown"
+                }
+            ],
+            "example_standalone": "hide list [shopping list v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when I receive [game over v]\n  hide list [shopping list v]",
+                    "explanation": "This script hides the 'shopping list' when the 'game over' broadcast is received."
+                }
+            ]
+        },
+        {
+            "block_name": "Ask () and Wait",
+            "block_type": "Sensing",
+            "block_shape": "Stack Block",
+            "op_code": "sensing_askandwait",
+            "functionality": "Displays an input box with specified text at the bottom of the screen, allowing users to input text, which is stored in the 'Answer' block.",
+            "inputs": [
+                {
+                    "name": "question",
+                    "type": "text"
+                }
+            ],
+            "example_standalone": "ask [What is your name?] and wait",
+            "example_with_other_blocks": [
+                {
+                    "script": "ask [What is your name?] and wait\n  say join [Hello ] (answer) for (2) seconds",
+                    "explanation": "This script prompts the user for their name, waits for input, then greets them using the provided answer."
+                }
+            ]
+        },
+        {
+            "block_name": "Reset Timer",
+            "block_type": "Sensing",
+            "block_shape": "Stack Block",
+            "op_code": "sensing_resettimer",
+            "functionality": "Sets the timer’s value back to 0.0.",
+            "inputs": null,
+            "example_standalone": "reset timer",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  reset timer\n  wait (5) seconds\n  say timer for (2) seconds",
+                    "explanation": "This script resets the timer at the start, waits for 5 seconds, then says the current timer value."
+                }
+            ]
+        },
+        {
+            "block_name": "set drag mode [draggable v]",
+            "block_type": "Sensing",
+            "block_shape": "Stack Block",
+            "op_code": "sensing_setdragmode",
+            "functionality": "Sets whether the sprite can be dragged by the mouse on the stage.",
+            "inputs": null,
+            "fields": {
+                "DRAG_MODE": {
+                    "type": "dropdown",
+                    "options": [
+                        "draggable",
+                        "not draggable"
+                    ]
+                }
+            },
+            "example_standalone": "set drag mode [draggable v]",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  set drag mode [not draggable v]\nwhen this sprite clicked\n  set drag mode [draggable v]",
+                    "explanation": "This script makes the sprite not draggable when the project starts, but allows it to be dragged once it's clicked."
+                }
+            ]
+        },
+        {
+            "block_name": "[my custom block]",
+            "block_type": "My Blocks",
+            "block_shape": "Stack Block",
+            "op_code": "procedures_call",
+            "functionality": "Executes the script defined by a corresponding 'define' Hat block. This block allows users to call and reuse custom code sequences by simply dragging and dropping it into their scripts, optionally providing required input values.",
+            "inputs": [
+                {
+                    "name": "argument_name_1",
+                    "type": "any"
+                },
+                {
+                    "name": "argument_name_2",
+                    "type": "any"
+                }
+            ],
+            "example_standalone": "jump (50)",
+            "example_with_other_blocks": [
+                {
+                    "script": "when green flag clicked\n  go to x: (0) y: (0)\n  jump (50)\n  wait (1) seconds\n  say [I jumped!] for (2) seconds",
+                    "explanation": "This script moves the sprite to a starting position, then calls the 'jump' custom block with an input of 50 (assuming 'jump' is a custom block that moves the sprite up and down). After the jump, the sprite says 'I jumped!'."
+                },
+                {
+                    "script": "when green flag clicked\n   hide\n   forever\n     create clone of [myself v]\n     wait (1) seconds\n   end",
+                    "explanation": "This script continuously creates new clones of the current sprite every second after the original sprite hides itself."
+                }
+            ]
+        }
+    ]
+}

v2/scratch_agent/debug_combine_blocks.json

@@ -0,0 +1,419 @@
+{
+  "d": {},
+  "g": {},
+  "operator_random": {
+    "block_name": "pick random () to ()",
+    "block_type": "operator",
+    "op_code": "operator_random",
+    "block_shape": "Reporter Block",
+    "functionality": "Generates a random integer within a specified inclusive range.",
+    "inputs": {
+      "FROM": [
+        1,
+        [
+          4,
+          "1"
+        ]
+      ],
+      "TO": [
+        1,
+        [
+          4,
+          "10"
+        ]
+      ]
+    },
+    "example_standalone": "pick random (1) to (10)",
+    "example_with_other_blocks": [
+      {
+        "script": "go to x: (pick random -240 to 240) y: (pick random -180 to 180)",
+        "explanation": "This script moves the sprite to a random position on the stage."
+      }
+    ],
+    "opcode": "operator_random",
+    "next": null,
+    "parent": null,
+    "fields": {},
+    "shadow": false,
+    "topLevel": true,
+    "x": 311,
+    "y": 157
+  },
+  "control_forever": {
+    "block_name": "forever",
+    "block_type": "Control",
+    "block_shape": "C-Block",
+    "op_code": "control_forever",
+    "functionality": "Continuously runs the blocks inside it.",
+    "inputs": {},
+    "example_standalone": "forever",
+    "example_with_other_blocks": [
+      {
+        "script": "when green flag clicked\n  forever\n    move (5) steps\n    if on edge, bounce\n  end",
+        "explanation": "This script makes the sprite move endlessly and bounce off the edges of the stage, creating continuous motion."
+      }
+    ],
+    "opcode": "control_forever",
+    "next": null,
+    "parent": null,
+    "fields": {},
+    "shadow": false,
+    "topLevel": true,
+    "x": 334,
+    "y": 439
+  },
+  "operator_equals": {
+    "block_name": "<() = ()>",
+    "block_type": "operator",
+    "op_code": "operator_equals",
+    "block_shape": "Boolean Block",
+    "functionality": "Checks if two values are equal.",
+    "inputs": {
+      "OPERAND1": [
+        1,
+        [
+          10,
+          ""
+        ]
+      ],
+      "OPERAND2": [
+        1,
+        [
+          10,
+          "50"
+        ]
+      ]
+    },
+    "example_standalone": "<(answer) = (5)>",
+    "example_with_other_blocks": [
+      {
+        "script": "if <(answer) = (5)> then\n  say [Correct!]",
+        "explanation": "This script makes the sprite say 'Correct!' if the value of the 'answer' variable is exactly 5."
+      }
+    ],
+    "opcode": "operator_equals",
+    "next": null,
+    "parent": null,
+    "fields": {},
+    "shadow": false,
+    "topLevel": true,
+    "x": 345,
+    "y": 372
+  },
+  "t": {},
+  "operator_multiply": {
+    "block_name": "() * ()",
+    "block_type": "operator",
+    "op_code": "operator_multiply",
+    "block_shape": "Reporter Block",
+    "functionality": "Multiplies two numerical values.",
+    "inputs": {
+      "NUM1": [
+        1,
+        [
+          4,
+          ""
+        ]
+      ],
+      "NUM2": [
+        1,
+        [
+          4,
+          ""
+        ]
+      ]
+    },
+    "example_standalone": "(6) * (7)",
+    "example_with_other_blocks": [
+      {
+        "script": "set [area v] to ( (length) * (width) )",
+        "explanation": "This script calculates the area by multiplying 'length' and 'width' variables and stores it in the 'area' variable."
+      }
+    ],
+    "opcode": "operator_multiply",
+    "next": null,
+    "parent": null,
+    "fields": {},
+    "shadow": false,
+    "topLevel": true,
+    "x": 134,
+    "y": 278
+  },
+  "motion_turnright": {
+    "block_name": "turn right () degrees",
+    "block_type": "Motion",
+    "block_shape": "Stack Block",
+    "op_code": "motion_turnright",
+    "functionality": "Turns the sprite clockwise by the specified number of degrees.",
+    "inputs": {
+      "DEGREES": [
+        1,
+        [
+          4,
+          "15"
+        ]
+      ]
+    },
+    "example_standalone": "turn (clockwise icon) (15) degrees",
+    "example_with_other_blocks": [
+      {
+        "script": "when [right arrow v] key pressed\n  turn (clockwise icon) (15) degrees\nend",
+        "explanation": "This script makes the sprite turn clockwise by 15 degrees every time the right arrow key is pressed."
+      },
+      {
+        "script": "when green flag clicked\n  forever\n    turn (clockwise icon) (15) degrees\n    wait (0.5) seconds\n  end",
+        "explanation": "This script makes the sprite continuously spin clockwise by 15 degrees every half second."
+      }
+    ],
+    "opcode": "motion_turnright",
+    "next": null,
+    "parent": null,
+    "fields": {},
+    "shadow": false,
+    "topLevel": true,
+    "x": 467,
+    "y": -316
+  },
+  "motion_gotoxy": {
+    "block_name": "go to x: () y: ()",
+    "block_type": "Motion",
+    "block_shape": "Stack Block",
+    "op_code": "motion_gotoxy",
+    "functionality": "Moves the sprite to the specified X and Y coordinates on the stage.",
+    "inputs": {
+      "X": [
+        1,
+        [
+          4,
+          "0"
+        ]
+      ],
+      "Y": [
+        1,
+        [
+          4,
+          "0"
+        ]
+      ]
+    },
+    "example_standalone": "go to x: (0) y: (0)",
+    "example_with_other_blocks": [
+      {
+        "script": "when green flag clicked\n  go to x: (0) y: (0)\n  say [Ready to start! v] for (1) seconds\nend",
+        "explanation": "This script positions the sprite at the center of the stage at the beginning of the project and then makes it say 'Ready to start!'."
+      }
+    ],
+    "opcode": "motion_gotoxy",
+    "next": null,
+    "parent": null,
+    "fields": {},
+    "shadow": false,
+    "topLevel": true,
+    "x": 468,
+    "y": 12
+  },
+  "sensing_backdropnumbername": {},
+  "operator_mod": {
+    "block_name": "() mod ()",
+    "block_type": "operator",
+    "op_code": "operator_mod",
+    "block_shape": "Reporter Block",
+    "functionality": "Reports the remainder when the first number is divided by the second.",
+    "inputs": {
+      "NUM1": [
+        1,
+        [
+          4,
+          ""
+        ]
+      ],
+      "NUM2": [
+        1,
+        [
+          4,
+          ""
+        ]
+      ]
+    },
+    "example_standalone": "(10) mod (3)",
+    "example_with_other_blocks": [
+      {
+        "script": "if <(number) mod (2) = (0)> then\n  say [Even number]",
+        "explanation": "This script checks if a 'number' variable is even by checking if its remainder when divided by 2 is 0."
+      }
+    ],
+    "opcode": "operator_mod",
+    "next": null,
+    "parent": null,
+    "fields": {},
+    "shadow": false,
+    "topLevel": true,
+    "x": 295,
+    "y": 594
+  },
+  "_": {},
+  "sound_playuntildone": {
+    "block_name": "play sound () until done",
+    "block_type": "Sound",
+    "block_shape": "Stack Block",
+    "op_code": "sound_playuntildone",
+    "functionality": "Plays a specified sound and pauses the script's execution until the sound has completed.",
+    "inputs": {
+      "SOUND_MENU": [
+        1,
+        "4w%pR8G.yD%g-BwCj=uK"
+      ]
+    },
+    "example_standalone": "play sound [Meow v] until done",
+    "example_with_other_blocks": [
+      {
+        "script": "when backdrop switches to [winning screen v]\n  play sound [fanfare v] until done\n  say [You won!] for (2) seconds\nend",
+        "explanation": "When the backdrop changes to the 'winning screen', a 'fanfare' sound will play until it finishes, and then the sprite will say 'You won!' for 2 seconds."
+      },
+      {
+        "script": "forever\n   play sound [Music v] until done \nend",
+        "explanation": "This script creates a continuous loop for background music, playing the 'Music' sound repeatedly."
+      }
+    ],
+    "opcode": "sound_playuntildone",
+    "next": null,
+    "parent": null,
+    "fields": {},
+    "shadow": false,
+    "topLevel": true,
+    "x": 253,
+    "y": 17
+  },
+  "h": {},
+  "l": {},
+  "k": {},
+  "f": {},
+  "motion_changexby": {
+    "block_name": "change x by ()",
+    "block_type": "Motion",
+    "block_shape": "Stack Block",
+    "op_code": "motion_changexby",
+    "functionality": "Changes the sprite's X-coordinate by the specified amount, moving it horizontally.",
+    "inputs": {
+      "DX": [
+        1,
+        [
+          4,
+          "10"
+        ]
+      ]
+    },
+    "example_standalone": "change x by (10)",
+    "example_with_other_blocks": [
+      {
+        "script": "when [right arrow v] key pressed\n  change x by (10)\nend",
+        "explanation": "This script moves the sprite 10 steps to the right when the right arrow key is pressed."
+      }
+    ],
+    "opcode": "motion_changexby",
+    "next": null,
+    "parent": null,
+    "fields": {},
+    "shadow": false,
+    "topLevel": true,
+    "x": 851,
+    "y": -409
+  },
+  "data_changevariableby": {
+    "block_name": "change [my variable v] by ()",
+    "block_type": "Data",
+    "block_shape": "Stack Block",
+    "op_code": "data_changevariableby",
+    "functionality": "Increases or decreases a variable's numerical value by a specified amount.",
+    "inputs": {
+      "VALUE": [
+        1,
+        [
+          4,
+          "1"
+        ]
+      ]
+    },
+    "example_standalone": "change [score v] by (1)",
+    "example_with_other_blocks": [
+      {
+        "script": "when this sprite clicked\n  change [score v] by (1)\nend",
+        "explanation": "This script increments the 'score' variable by 1 each time the sprite is clicked."
+      }
+    ],
+    "opcode": "data_changevariableby",
+    "next": null,
+    "parent": null,
+    "fields": {
+      "VARIABLE": [
+        "my variable",
+        "`jEk@4|i[#Fk?(8x)AV.-my variable"
+      ]
+    },
+    "shadow": false,
+    "topLevel": true,
+    "x": 313,
+    "y": 363
+  },
+  "motion_setx": {
+    "block_name": "set x to ()",
+    "block_type": "Motion",
+    "block_shape": "Stack Block",
+    "op_code": "motion_setx",
+    "functionality": "Sets the sprite's X-coordinate to a specific value, placing it at a precise horizontal position.",
+    "inputs": {
+      "X": [
+        1,
+        [
+          4,
+          "0"
+        ]
+      ]
+    },
+    "example_standalone": "set x to (0)",
+    "example_with_other_blocks": [
+      {
+        "script": "when green flag clicked\n  set x to (0)\n  set y to (0)\nend",
+        "explanation": "This script centers the sprite horizontally at the start of the project."
+      }
+    ],
+    "opcode": "motion_setx",
+    "next": null,
+    "parent": null,
+    "fields": {},
+    "shadow": false,
+    "topLevel": true,
+    "x": 864,
+    "y": -194
+  },
+  "c": {},
+  "control_if": {
+    "block_name": "if () then",
+    "block_type": "Control",
+    "block_shape": "C-Block",
+    "op_code": "control_if",
+    "functionality": "Executes the blocks inside it only if the specified boolean condition is true.",
+    "inputs": {},
+    "example_standalone": "if <touching [mouse-pointer v]?> then",
+    "example_with_other_blocks": [
+      {
+        "script": "forever\n  if <touching [color (red) v]?> then\n    stop [this script v]\n  end",
+        "explanation": "This script continuously checks if the sprite is touching a red color, and if so, it stops the current script."
+      }
+    ],
+    "opcode": "control_if",
+    "next": null,
+    "parent": null,
+    "fields": {},
+    "shadow": false,
+    "topLevel": true,
+    "x": 331,
+    "y": 597
+  },
+  "v": {},
+  "a": {},
+  "w": {},
+  "e": {},
+  "i": {},
+  "n": {}
+}

v2/scratch_agent/debug_combine_state.json

@@ -0,0 +1,2070 @@
+{
+  "project_json": {
+    "targets": [
+      {
+        "isStage": true,
+        "name": "Stage",
+        "objName": "Stage",
+        "variables": {
+          "score_73fce27a": [
+            "score",
+            "0"
+          ],
+          "☁ High Score_2b744c35": [
+            "☁ High Score",
+            "0",
+            true
+          ],
+          "speed_c110710a": [
+            "speed",
+            "0"
+          ],
+          "lives_9019623c": [
+            "lives",
+            "3"
+          ],
+          "level_000d70bb": [
+            "level",
+            "1"
+          ]
+        },
+        "lists": {
+          "recent_scores_c4c10267": [
+            "recent_scores",
+            []
+          ],
+          "obstacle_speeds_b690a1ee": [
+            "obstacle_speeds",
+            []
+          ],
+          "power_ups_efcd2ef7": [
+            "power_ups",
+            []
+          ]
+        },
+        "broadcasts": {
+          "Game Over_9032e357": "Game Over",
+          "Game Start_ba9be238": "Game Start",
+          "Level Up_6e23a340": "Level Up",
+          "Power Up Collected_bd804925": "Power Up Collected"
+        },
+        "blocks": {
+          "hatBlockID": {
+            "opcode": "event_whenflagclicked",
+            "next": "switchBackdropBlockID",
+            "parent": null,
+            "shadow": false,
+            "topLevel": true,
+            "x": 0,
+            "y": 0
+          },
+          "switchBackdropBlockID": {
+            "opcode": "looks_switchbackdropto",
+            "inputs": {
+              "BACKDROP": [
+                1,
+                "blueSkyBackdropShadowID"
+              ]
+            },
+            "next": "setScoreBlockID",
+            "parent": "hatBlockID",
+            "shadow": false,
+            "topLevel": false,
+            "x": 100,
+            "y": 0
+          },
+          "blueSkyBackdropShadowID": {
+            "opcode": "looks_backdrops",
+            "fields": {
+              "BACKDROP": [
+                "Blue Sky",
+                "e7c147730f19d284bcd7b3f00af19bb6"
+              ]
+            },
+            "shadow": true,
+            "parent": "switchBackdropBlockID",
+            "topLevel": false
+          },
+          "setScoreBlockID": {
+            "opcode": "data_setvariableto",
+            "fields": {
+              "VARIABLE": [
+                "score",
+                "score_73fce27a"
+              ]
+            },
+            "inputs": {
+              "VALUE": [
+                1,
+                "zeroShadowID"
+              ]
+            },
+            "next": "showScoreBlockID",
+            "parent": "switchBackdropBlockID",
+            "shadow": false,
+            "topLevel": false,
+            "x": 100,
+            "y": 50
+          },
+          "zeroShadowID": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "0",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "setScoreBlockID",
+            "topLevel": false
+          },
+          "showScoreBlockID": {
+            "opcode": "data_showvariable",
+            "fields": {
+              "VARIABLE": [
+                "score",
+                "score_73fce27a"
+              ]
+            },
+            "next": "broadcastBlockID",
+            "parent": "setScoreBlockID",
+            "shadow": false,
+            "topLevel": false,
+            "x": 100,
+            "y": 100
+          },
+          "broadcastBlockID": {
+            "opcode": "event_broadcast",
+            "inputs": {
+              "BROADCAST_INPUT": [
+                1,
+                "gameStartBroadcastShadowID"
+              ]
+            },
+            "next": null,
+            "parent": "showScoreBlockID",
+            "shadow": false,
+            "topLevel": false,
+            "x": 100,
+            "y": 150
+          },
+          "gameStartBroadcastShadowID": {
+            "opcode": "event_broadcast_menu",
+            "fields": {
+              "BROADCAST": [
+                "Game Start",
+                "Game Start_ba9be238"
+              ]
+            },
+            "shadow": true,
+            "parent": "broadcastBlockID",
+            "topLevel": false
+          }
+        },
+        "comments": {},
+        "currentCostume": 0,
+        "costumes": [
+          {
+            "name": "Blue Sky",
+            "bitmapResolution": 1,
+            "dataFormat": "svg",
+            "assetId": "e7c147730f19d284bcd7b3f00af19bb6",
+            "md5ext": "e7c147730f19d284bcd7b3f00af19bb6.svg",
+            "rotationCenterX": 240,
+            "rotationCenterY": 180
+          }
+        ],
+        "sounds": [
+          {
+            "name": "button",
+            "dataFormat": "wav",
+            "rate": 44100,
+            "sampleCount": 0,
+            "assetId": "83a9787d4cb6f3b7632b4ddfebf74367",
+            "md5ext": "83a9787d4cb6f3b7632b4ddfebf74367.wav"
+          }
+        ],
+        "volume": 100,
+        "layerOrder": 0,
+        "tempo": 60,
+        "videoTransparency": 50,
+        "videoState": "on",
+        "textToSpeechLanguage": null
+      },
+      {
+        "isStage": false,
+        "name": "Sprite1",
+        "objName": "Sprite1",
+        "variables": {},
+        "lists": {},
+        "broadcasts": {},
+        "blocks": {
+          "hat_block_id": {
+            "opcode": "event_whenflagclicked",
+            "next": "goto_xy_block_id",
+            "parent": null,
+            "inputs": {},
+            "fields": {},
+            "shadow": false,
+            "topLevel": true,
+            "x": 0,
+            "y": 0
+          },
+          "goto_xy_block_id": {
+            "opcode": "motion_gotoxy",
+            "next": "set_lives_block_id",
+            "parent": "hat_block_id",
+            "inputs": {
+              "X": [
+                1,
+                "x_shadow_block_id"
+              ],
+              "Y": [
+                1,
+                "y_shadow_block_id"
+              ]
+            },
+            "fields": {},
+            "shadow": false,
+            "topLevel": false,
+            "x": 10,
+            "y": -50
+          },
+          "x_shadow_block_id": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "0",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "goto_xy_block_id",
+            "topLevel": false
+          },
+          "y_shadow_block_id": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "-120",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "goto_xy_block_id",
+            "topLevel": false
+          },
+          "set_lives_block_id": {
+            "opcode": "data_setvariableto",
+            "next": "set_score_block_id",
+            "parent": "goto_xy_block_id",
+            "inputs": {
+              "VARIABLE": [
+                1,
+                "lives_variable_shadow_block_id"
+              ],
+              "VALUE": [
+                1,
+                "lives_value_shadow_block_id"
+              ]
+            },
+            "fields": {},
+            "shadow": false,
+            "topLevel": false,
+            "x": 20,
+            "y": -100
+          },
+          "lives_variable_shadow_block_id": {
+            "opcode": "data_variable",
+            "fields": {
+              "VARIABLE": [
+                "lives",
+                "lives_9019623c"
+              ]
+            },
+            "shadow": true,
+            "parent": "set_lives_block_id",
+            "topLevel": false
+          },
+          "lives_value_shadow_block_id": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "3",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "set_lives_block_id",
+            "topLevel": false
+          },
+          "set_score_block_id": {
+            "opcode": "data_setvariableto",
+            "next": "show_score_block_id",
+            "parent": "set_lives_block_id",
+            "inputs": {
+              "VARIABLE": [
+                1,
+                "score_variable_shadow_block_id"
+              ],
+              "VALUE": [
+                1,
+                "score_value_shadow_block_id"
+              ]
+            },
+            "fields": {},
+            "shadow": false,
+            "topLevel": false,
+            "x": 30,
+            "y": -150
+          },
+          "score_variable_shadow_block_id": {
+            "opcode": "data_variable",
+            "fields": {
+              "VARIABLE": [
+                "score",
+                "score_73fce27a"
+              ]
+            },
+            "shadow": true,
+            "parent": "set_score_block_id",
+            "topLevel": false
+          },
+          "score_value_shadow_block_id": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "0",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "set_score_block_id",
+            "topLevel": false
+          },
+          "show_score_block_id": {
+            "opcode": "data_showvariable",
+            "next": "show_lives_block_id",
+            "parent": "set_score_block_id",
+            "inputs": {},
+            "fields": {
+              "VARIABLE": [
+                "score",
+                "score_73fce27a"
+              ]
+            },
+            "shadow": false,
+            "topLevel": false,
+            "x": 40,
+            "y": -200
+          },
+          "show_lives_block_id": {
+            "opcode": "data_showvariable",
+            "next": "broadcast_game_start_block_id",
+            "parent": "show_score_block_id",
+            "inputs": {},
+            "fields": {
+              "VARIABLE": [
+                "lives",
+                "lives_9019623c"
+              ]
+            },
+            "shadow": false,
+            "topLevel": false,
+            "x": 50,
+            "y": -250
+          },
+          "broadcast_game_start_block_id": {
+            "opcode": "event_broadcast",
+            "next": null,
+            "parent": "show_lives_block_id",
+            "inputs": {
+              "BROADCAST_INPUT": [
+                1,
+                "game_start_broadcast_shadow_block_id"
+              ]
+            },
+            "fields": {},
+            "shadow": false,
+            "topLevel": false,
+            "x": 60,
+            "y": -300
+          },
+          "game_start_broadcast_shadow_block_id": {
+            "opcode": "event_broadcast_menu",
+            "fields": {
+              "BROADCAST": [
+                "Game Start",
+                "Game Start_ba9be238"
+              ]
+            },
+            "shadow": true,
+            "parent": "broadcast_game_start_block_id",
+            "topLevel": false
+          },
+          "event_whenkeypressed_1": {
+            "opcode": "event_whenkeypressed",
+            "next": "control_forever_2",
+            "parent": null,
+            "inputs": {},
+            "fields": {
+              "KEY_OPTION": [
+                "space",
+                null
+              ]
+            },
+            "shadow": false,
+            "topLevel": true,
+            "x": 0,
+            "y": 150
+          },
+          "control_forever_2": {
+            "opcode": "control_forever",
+            "next": null,
+            "parent": "event_whenkeypressed_1",
+            "inputs": {
+              "SUBSTACK": [
+                2,
+                "sensing_keypressed_3"
+              ]
+            },
+            "shadow": false,
+            "topLevel": false,
+            "x": 10,
+            "y": -50
+          },
+          "sensing_keypressed_3": {
+            "opcode": "sensing_keypressed",
+            "next": "control_if_5",
+            "parent": "control_forever_2",
+            "inputs": {
+              "KEY": [
+                1,
+                "space_shadow_4"
+              ]
+            },
+            "shadow": false,
+            "topLevel": false,
+            "x": 20,
+            "y": -100
+          },
+          "space_shadow_4": {
+            "opcode": "sensing_keypressed_menu",
+            "fields": {
+              "KEY": [
+                "space",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "sensing_keypressed_3",
+            "topLevel": false
+          },
+          "control_if_5": {
+            "opcode": "control_if",
+            "next": "motion_changeyby_6",
+            "parent": "sensing_keypressed_3",
+            "inputs": {
+              "CONDITION": [
+                1,
+                "operator_equals_7"
+              ],
+              "SUBSTACK": [
+                2,
+                "motion_changeyby_6"
+              ]
+            },
+            "shadow": false,
+            "topLevel": false,
+            "x": 30,
+            "y": -150
+          },
+          "operator_equals_7": {
+            "opcode": "operator_equals",
+            "next": null,
+            "parent": "control_if_5",
+            "inputs": {
+              "OPERAND1": [
+                1,
+                "data_variable_8"
+              ],
+              "OPERAND2": [
+                1,
+                "literal_0_9"
+              ]
+            },
+            "shadow": false,
+            "topLevel": false,
+            "x": 40,
+            "y": -200
+          },
+          "data_variable_8": {
+            "opcode": "data_variable",
+            "fields": {
+              "VARIABLE": [
+                "lives",
+                "lives_9019623c"
+              ]
+            },
+            "shadow": true,
+            "parent": "operator_equals_7",
+            "topLevel": false
+          },
+          "literal_0_9": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "0",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "operator_equals_7",
+            "topLevel": false
+          },
+          "motion_changeyby_6": {
+            "opcode": "motion_changeyby",
+            "next": "wait_10",
+            "parent": "control_if_5",
+            "inputs": {
+              "DY": [
+                1,
+                "literal_20_11"
+              ]
+            },
+            "shadow": false,
+            "topLevel": false,
+            "x": 40,
+            "y": -200
+          },
+          "literal_20_11": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "20",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "motion_changeyby_6",
+            "topLevel": false
+          },
+          "wait_10": {
+            "opcode": "wait",
+            "next": "motion_changeyby_12",
+            "parent": "motion_changeyby_6",
+            "inputs": {
+              "DURATION": [
+                1,
+                "literal_0_1_13"
+              ]
+            },
+            "shadow": false,
+            "topLevel": false,
+            "x": 50,
+            "y": -250
+          },
+          "literal_0_1_13": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "0.1",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "wait_10",
+            "topLevel": false
+          },
+          "motion_changeyby_12": {
+            "opcode": "motion_changeyby",
+            "next": null,
+            "parent": "wait_10",
+            "inputs": {
+              "DY": [
+                1,
+                "literal_-20_14"
+              ]
+            },
+            "shadow": false,
+            "topLevel": false,
+            "x": 60,
+            "y": -300
+          },
+          "literal_-20_14": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "-20",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "motion_changeyby_12",
+            "topLevel": false
+          },
+          "event_broadcast_15": {
+            "opcode": "event_broadcast",
+            "next": "control_stop_16",
+            "parent": "control_if_5",
+            "inputs": {
+              "BROADCAST_INPUT": [
+                1,
+                "broadcast_game_over_17"
+              ]
+            },
+            "shadow": false,
+            "topLevel": false,
+            "x": 70,
+            "y": -350
+          },
+          "broadcast_game_over_17": {
+            "opcode": "event_broadcast_menu",
+            "fields": {
+              "BROADCAST": [
+                "Game Over",
+                "Game Over_9032e357"
+              ]
+            },
+            "shadow": true,
+            "parent": "event_broadcast_15",
+            "topLevel": false
+          },
+          "control_stop_16": {
+            "opcode": "control_stop",
+            "next": null,
+            "parent": "event_broadcast_15",
+            "inputs": {},
+            "fields": {
+              "STOP_OPTION": [
+                "all",
+                null
+              ]
+            },
+            "shadow": false,
+            "topLevel": false,
+            "x": 80,
+            "y": -400
+          }
+        },
+        "comments": {},
+        "currentCostume": 0,
+        "costumes": [
+          {
+            "name": "Sprite1",
+            "bitmapResolution": 1,
+            "dataFormat": "svg",
+            "assetId": "bcf454acf82e4504149f7ffe07081dbc",
+            "md5ext": "bcf454acf82e4504149f7ffe07081dbc.svg",
+            "rotationCenterX": 0,
+            "rotationCenterY": 0
+          }
+        ],
+        "sounds": [
+          {
+            "name": "meow",
+            "dataFormat": "wav",
+            "rate": 44100,
+            "sampleCount": 0,
+            "assetId": "83c36d806dc92327b9e7049a565c6bff",
+            "md5ext": "83c36d806dc92327b9e7049a565c6bff.wav"
+          }
+        ],
+        "volume": 100,
+        "layerOrder": 2,
+        "visible": true,
+        "x": 0,
+        "y": -120,
+        "size": 100,
+        "direction": 90,
+        "draggable": false,
+        "rotationStyle": "all around"
+      },
+      {
+        "isStage": false,
+        "name": "soccer ball",
+        "objName": "soccer ball",
+        "variables": {},
+        "lists": {},
+        "broadcasts": {},
+        "blocks": {
+          "event_whenflagclicked_1": {
+            "opcode": "event_whenflagclicked",
+            "next": "motion_gotoxy_2",
+            "parent": null,
+            "fields": {},
+            "shadow": false,
+            "topLevel": true,
+            "x": 0,
+            "y": 0
+          },
+          "motion_gotoxy_2": {
+            "opcode": "motion_gotoxy",
+            "inputs": {
+              "X": [
+                1,
+                "motion_gotoxy_x_3"
+              ],
+              "Y": [
+                1,
+                "motion_gotoxy_y_4"
+              ]
+            },
+            "next": "control_forever_5",
+            "parent": "event_whenflagclicked_1",
+            "fields": {},
+            "shadow": false,
+            "topLevel": false,
+            "x": 10,
+            "y": 50
+          },
+          "motion_gotoxy_x_3": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "240",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "motion_gotoxy_2",
+            "topLevel": false
+          },
+          "motion_gotoxy_y_4": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "0",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "motion_gotoxy_2",
+            "topLevel": false
+          },
+          "control_forever_5": {
+            "opcode": "control_forever",
+            "inputs": {
+              "SUBSTACK": [
+                2,
+                "motion_glidesecstoxy_6"
+              ]
+            },
+            "next": null,
+            "parent": "motion_gotoxy_2",
+            "fields": {},
+            "shadow": false,
+            "topLevel": false,
+            "x": 20,
+            "y": 100
+          },
+          "motion_glidesecstoxy_6": {
+            "opcode": "motion_glidesecstoxy",
+            "inputs": {
+              "SECS": [
+                1,
+                "motion_glidesecstoxy_secs_7"
+              ],
+              "X": [
+                1,
+                "motion_glidesecstoxy_x_8"
+              ],
+              "Y": [
+                1,
+                "motion_glidesecstoxy_y_9"
+              ]
+            },
+            "next": "control_if_10",
+            "parent": "control_forever_5",
+            "fields": {},
+            "shadow": false,
+            "topLevel": false,
+            "x": 30,
+            "y": 150
+          },
+          "motion_glidesecstoxy_secs_7": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "2",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "motion_glidesecstoxy_6",
+            "topLevel": false
+          },
+          "motion_glidesecstoxy_x_8": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "-240",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "motion_glidesecstoxy_6",
+            "topLevel": false
+          },
+          "motion_glidesecstoxy_y_9": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "0",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "motion_glidesecstoxy_6",
+            "topLevel": false
+          },
+          "control_if_10": {
+            "opcode": "control_if",
+            "inputs": {
+              "CONDITION": [
+                1,
+                "sensing_touchingobject_11"
+              ],
+              "SUBSTACK": [
+                2,
+                "control_if_12"
+              ]
+            },
+            "next": "data_changevariableby_13",
+            "parent": "motion_glidesecstoxy_6",
+            "fields": {},
+            "shadow": false,
+            "topLevel": false,
+            "x": 40,
+            "y": 200
+          },
+          "sensing_touchingobject_11": {
+            "opcode": "sensing_touchingobject",
+            "inputs": {
+              "TOUCHINGOBJECTMENU": [
+                1,
+                "sensing_touchingobject_menu_14"
+              ]
+            },
+            "next": null,
+            "parent": "control_if_10",
+            "fields": {},
+            "shadow": false,
+            "topLevel": false
+          },
+          "sensing_touchingobject_menu_14": {
+            "opcode": "sensing_touchingobjectmenu",
+            "fields": {
+              "TOUCHINGOBJECTMENU": [
+                "Sprite1",
+                "Sprite1_15"
+              ]
+            },
+            "shadow": true,
+            "parent": "sensing_touchingobject_11",
+            "topLevel": false
+          },
+          "Sprite1_15": {
+            "isStage": false,
+            "name": "Sprite1",
+            "objName": "Sprite1",
+            "variables": {},
+            "lists": {},
+            "broadcasts": {},
+            "blocks": {},
+            "comments": {},
+            "currentCostume": 0,
+            "costumes": [
+              {
+                "name": "costume1",
+                "bitmapResolution": 1,
+                "dataFormat": "svg",
+                "assetId": "89f55f38-2e0a-40d6-8e8e-45d6d167cd2c",
+                "md5ext": "89f55f38-2e0a-40d6-8e8e-45d6d167cd2c.svg",
+                "rotationCenterX": 0,
+                "rotationCenterY": 0
+              }
+            ],
+            "sounds": [],
+            "volume": 100,
+            "layerOrder": 3,
+            "visible": true,
+            "x": 0,
+            "y": 0,
+            "size": 100,
+            "direction": 90,
+            "draggable": false,
+            "rotationStyle": "all around"
+          },
+          "control_if_12": {
+            "opcode": "control_if",
+            "inputs": {
+              "CONDITION": [
+                1,
+                "operator_lt_16"
+              ],
+              "SUBSTACK": [
+                2,
+                "data_changevariableby_17"
+              ]
+            },
+            "next": "event_broadcast_20",
+            "parent": "control_if_10",
+            "fields": {},
+            "shadow": false,
+            "topLevel": false,
+            "x": 50,
+            "y": 250
+          },
+          "operator_lt_16": {
+            "opcode": "operator_lt",
+            "inputs": {
+              "OPERAND1": [
+                1,
+                "data_variable_18"
+              ],
+              "OPERAND2": [
+                1,
+                "operator_lt_operand2_19"
+              ]
+            },
+            "next": null,
+            "parent": "control_if_12",
+            "fields": {},
+            "shadow": false,
+            "topLevel": false
+          },
+          "data_variable_18": {
+            "opcode": "data_variable",
+            "fields": {
+              "VARIABLE": [
+                "lives",
+                "lives_9019623c"
+              ]
+            },
+            "shadow": true,
+            "parent": "operator_lt_16",
+            "topLevel": false
+          },
+          "operator_lt_operand2_19": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "0",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "operator_lt_16",
+            "topLevel": false
+          },
+          "data_changevariableby_17": {
+            "opcode": "data_changevariableby",
+            "inputs": {
+              "VARIABLE": [
+                1,
+                "data_changevariableby_variable_21"
+              ],
+              "VALUE": [
+                1,
+                "data_changevariableby_value_22"
+              ]
+            },
+            "next": null,
+            "parent": "control_if_12",
+            "fields": {},
+            "shadow": false,
+            "topLevel": false,
+            "x": 60,
+            "y": 300
+          },
+          "data_changevariableby_variable_21": {
+            "opcode": "data_variable",
+            "fields": {
+              "VARIABLE": [
+                "lives",
+                "lives_9019623c"
+              ]
+            },
+            "shadow": true,
+            "parent": "data_changevariableby_17",
+            "topLevel": false
+          },
+          "data_changevariableby_value_22": {
+            "opcode": "math_number",
+            "fields": {
+              "NUM": [
+                "-1",
+                null
+              ]
+            },
+            "shadow": true,
+            "parent": "data_changevariableby_17",
+            "topLevel": false
+          },
+          "event_broadcast_20": {
+            "opcode": "event_broadcast",
+            "inputs": {
+              "BROADCAST_INPUT": [
+                1,
+                "event_broadcast_menu_23"
+              ]
+            },
+            "next": "control_stop_24",
+            "parent": "control_if_12",
+            "fields": {},
+            "shadow": false,
+            "topLevel": false,
+            "x": 70,
+            "y": 350
+          },
+          "event_broadcast_menu_23": {
+            "opcode": "event_broadcast_menu",
+            "fields": {
+              "BROADCAST": [
+                "Game Over",
+                "Game Over_9032e357"
+              ]
+            },
+            "shadow": true,
+            "parent": "event_broadcast_20",
+            "topLevel": false
+          },
+          "control_stop_24": {
+            "opcode": "control_stop",
+            "inputs": {},
+            "next": null,
+            "parent": "event_broadcast_20",
+            "fields": {
+              "STOP_OPTION": [
+                "all",
+                null
+              ]
+            },
+            "shadow": false,
+            "topLevel": false,
+            "x": 80,
+            "y": 400
+          }
+        },
+        "comments": {},
+        "currentCostume": 0,
+        "costumes": [
+          {
+            "name": "soccer ball",
+            "bitmapResolution": 1,
+            "dataFormat": "svg",
+            "assetId": "5d973d7a3a8be3f3bd6e1cd0f73c32b5",
+            "md5ext": "5d973d7a3a8be3f3bd6e1cd0f73c32b5.svg",
+            "rotationCenterX": 0,
+            "rotationCenterY": 0
+          }
+        ],
+        "sounds": [],
+        "volume": 100,
+        "layerOrder": 3,
+        "visible": true,
+        "x": 130,
+        "y": 0,
+        "size": 100,
+        "direction": 90,
+        "draggable": false,
+        "rotationStyle": "all around"
+      }
+    ],
+    "monitors": [
+      {
+        "id": "monitor_123e456",
+        "opcode": "data_variable",
+        "spriteName": "Stage",
+        "params": {
+          "VARIABLE": "score"
+        },
+        "value": "0",
+        "x": 5,
+        "y": 5,
+        "visible": true,
+        "mode": "default",
+        "sliderMin": 0,
+        "sliderMax": 100,
+        "isDiscrete": true
+      },
+      {
+        "id": "monitor_987654321",
+        "opcode": "data_variable",
+        "spriteName": "Stage",
+        "params": {
+          "VARIABLE": "☁ High Score"
+        },
+        "value": "0",
+        "x": 325,
+        "y": 5,
+        "visible": true,
+        "mode": "default",
+        "sliderMin": 0,
+        "sliderMax": 100,
+        "isDiscrete": true
+      }
+    ],
+    "extensions": [],
+    "meta": {
+      "semver": "3.0.0",
+      "vm": "11.1.0",
+      "agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
+    }
+  },
+  "description": "**Game Title: Whisker Wonders - Cat Jump**\n\nIn **Whisker Wonders - Cat Jump**, you control a nimble cat named **Sprite1** as it navigates through a vibrant, obstacle-filled world set against the beautiful backdrop of a **Blue Sky**. Your goal is to guide your feline friend, **Sprite1**, through the sky, jumping over incoming obstacles to reach the highest score possible.\n\n**Gameplay Overview:**\n\n- **Objective:** Control **Sprite1** to jump over obstacles, such as a rolling **soccer ball**, to survive and accumulate points.\n- **Environment:** The game takes place on the **Stage**, which features a serene **Blue Sky** backdrop. The sky transitions through different times of day or weather conditions could be added for variety.\n- **Game Mechanics:** \n  - **Sprite1** can move left and right and jump over obstacles.\n  - The **soccer ball** obstacle moves across the screen from right to left at varying speeds, requiring precise timing for **Sprite1** to jump over.\n  - Points are awarded for each obstacle successfully jumped over.\n\n**Potential Gameplay Elements:**\n\n- **Score System:** Implement a scoring system where points are awarded for each obstacle cleared. Higher scores could unlock new costumes for **Sprite1** or background changes for the **Stage**.\n- **Power-Ups:** Introduce power-ups like temporary invincibility, increased jump height, or score multipliers that **Sprite1** can collect by jumping into them.\n- **Levels:** Design multiple levels with increasing difficulty, such as changing obstacle speeds, introducing multiple obstacles at once, or altering the **Stage**'s background to simulate different environments (e.g., night, clouds).\n- **Sound Effects and Music:** Utilize the provided sound effects (`\"meow\"`, `\"button\"`) and consider adding background music to enhance the game's atmosphere. Sound effects could be triggered for actions like jumping, collecting power-ups, or hitting an obstacle.\n\n**Objectives:**\n\n- Survive as long as possible by jumping over obstacles.\n- Achieve the highest score by clearing obstacles efficiently.\n- Unlock new content (costumes, backgrounds) through high scores or achievements.\n\n**Overall Feel:**\n\n- **Whisker Wonders - Cat Jump** aims to be a fun, challenging platformer with simple controls and progressively increasing difficulty.\n- The game's colorful graphics, coupled with engaging sound effects and music, create an inviting atmosphere for players of all ages.\n- The simplicity of the game makes it accessible, while the challenge of achieving high scores encourages replayability.\n\n**Future Enhancements:**\n\n- **User-Created Content:** Allow players to create and share their own levels or obstacle courses.\n- **Multiplayer:** Introduce a competitive mode where players can compete to achieve the highest score or survive the longest.\n- **Customization:** Enable players to customize **Sprite1**'s appearance with various costumes and accessories.\n\n**Whisker Wonders - Cat Jump** combines classic platforming elements with engaging gameplay and cute, memorable characters, making it a delightful experience for players looking for a fun challenge.",
+  "project_id": "148cec44-05b5-4562-b06e-b92c64d1ca9e",
+  "sprite_initial_positions": {},
+  "action_plan": {
+    "Sprite1": {
+      "description": "Main character (cat) actions",
+      "plans": [
+        {
+          "event": "event_whenflagclicked",
+          "logic": "go to x:0 y:-120; set lives to 3; set score to 0; show variable score; show variable lives; broadcast Game Start;",
+          "motion": [
+            "motion_gotoxy",
+            "motion_setx",
+            "motion_sety"
+          ],
+          "control": [],
+          "operator": [],
+          "sensing": [],
+          "looks": [],
+          "sounds": [],
+          "events": [
+            "event_broadcast"
+          ],
+          "data": [
+            "data_setvariableto",
+            "data_showvariable"
+          ],
+          "block_relationships": [
+            {
+              "type": "stacked",
+              "blocks": [
+                "event_whenflagclicked",
+                "motion_gotoxy",
+                "data_setvariableto",
+                "data_setvariableto",
+                "looks_showvariable",
+                "looks_showvariable",
+                "events_broadcast"
+              ]
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "motion_gotoxy",
+              "input_slot_name": "X",
+              "value": "0"
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "motion_gotoxy",
+              "input_slot_name": "Y",
+              "value": "-120"
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "data_setvariableto",
+              "input_slot_name": "VALUE",
+              "value": "3"
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "data_setvariableto",
+              "input_slot_name": "VARIABLE",
+              "value": "lives"
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "data_setvariableto",
+              "input_slot_name": "VALUE",
+              "value": "0"
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "data_setvariableto",
+              "input_slot_name": "VARIABLE",
+              "value": "score"
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "events_broadcast",
+              "input_slot_name": "BROADCAST",
+              "value": "Game Start"
+            }
+          ]
+        },
+        {
+          "event": "event_whenkeypressed",
+          "logic": "forever: if key space is pressed, then change y by 20; wait 0.1 seconds; change y by -20; if lives = 0, then broadcast Game Over; stop all;",
+          "motion": [
+            "motion_changeyby"
+          ],
+          "control": [
+            "control_forever",
+            "control_if",
+            "control_stop"
+          ],
+          "operator": [
+            "operator_equals"
+          ],
+          "sensing": [
+            "sensing_keypressed"
+          ],
+          "looks": [],
+          "sounds": [],
+          "events": [
+            "event_broadcast"
+          ],
+          "data": [
+            "data_variable"
+          ],
+          "block_relationships": [
+            {
+              "type": "stacked",
+              "blocks": [
+                "event_whenkeypressed",
+                "control_forever"
+              ]
+            },
+            {
+              "type": "nested_c_block_body",
+              "parent": "control_forever",
+              "child_opcodes": [
+                "sensing_keypressed",
+                "control_if"
+              ]
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "sensing_keypressed",
+              "input_slot_name": "KEY",
+              "value": "space"
+            },
+            {
+              "type": "stacked",
+              "blocks": [
+                "motion_changeyby",
+                "wait",
+                "motion_changeyby"
+              ]
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "motion_changeyby",
+              "input_slot_name": "DISTANCE",
+              "value": "20"
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "wait",
+              "input_slot_name": "DURATION",
+              "value": "0.1"
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "motion_changeyby",
+              "input_slot_name": "DISTANCE",
+              "value": "-20"
+            },
+            {
+              "type": "nested_c_block_body",
+              "parent": "control_if",
+              "child_opcodes": [
+                "operator_equals",
+                "data_variable"
+              ]
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "operator_equals",
+              "input_slot_name": "OPERAND1",
+              "child_opcode": "data_variable"
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "operator_equals",
+              "input_slot_name": "OPERAND2",
+              "value": "0"
+            },
+            {
+              "type": "stacked",
+              "blocks": [
+                "event_broadcast",
+                "control_stop"
+              ]
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "event_broadcast",
+              "input_slot_name": "BROADCAST",
+              "value": "Game Over"
+            }
+          ]
+        }
+      ]
+    },
+    "soccer ball": {
+      "description": "Obstacle movement and interaction",
+      "plans": [
+        {
+          "event": "event_whenflagclicked",
+          "logic": "go to x:240 y:0; forever: glide 2 seconds to x:-240 y:0; if touching Sprite1, then change lives by -1; if lives < 0, then broadcast Game Over; stop all;",
+          "motion": [
+            "motion_gotoxy",
+            "motion_glidesecstoxy"
+          ],
+          "control": [
+            "control_forever",
+            "control_if",
+            "control_stop"
+          ],
+          "operator": [
+            "operator_lt"
+          ],
+          "sensing": [
+            "sensing_touchingobject"
+          ],
+          "looks": [],
+          "sounds": [],
+          "events": [
+            "event_broadcast"
+          ],
+          "data": [
+            "data_changevariableby"
+          ],
+          "block_relationships": [
+            {
+              "type": "stacked",
+              "blocks": [
+                "event_whenflagclicked",
+                "motion_gotoxy",
+                "control_forever"
+              ]
+            },
+            {
+              "type": "nested_c_block_body",
+              "parent": "control_forever",
+              "child_opcodes": [
+                "motion_glidesecstoxy",
+                "control_if",
+                "control_if",
+                "event_broadcast",
+                "control_stop"
+              ]
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "motion_glidesecstoxy",
+              "input_slot_name": "X",
+              "value": "-240"
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "motion_glidesecstoxy",
+              "input_slot_name": "Y",
+              "value": "0"
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "motion_glidesecstoxy",
+              "input_slot_name": "SECS",
+              "value": "2"
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "control_if",
+              "input_slot_name": "CONDITION",
+              "child_opcode": "sensing_touchingobject"
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "control_if",
+              "input_slot_name": "CONDITION",
+              "child_opcode": "operator_lt"
+            },
+            {
+              "type": "nested_c_block_body",
+              "parent": "control_if",
+              "child_opcodes": [
+                "data_changevariableby"
+              ]
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "data_changevariableby",
+              "input_slot_name": "VARIABLE",
+              "value": "lives"
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "data_changevariableby",
+              "input_slot_name": "VALUE",
+              "value": "-1"
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "operator_lt",
+              "input_slot_name": "OPERAND1",
+              "value": "lives"
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "operator_lt",
+              "input_slot_name": "OPERAND2",
+              "value": "0"
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "event_broadcast",
+              "input_slot_name": "BROADCAST",
+              "value": "Game Over"
+            }
+          ]
+        }
+      ]
+    },
+    "Stage": {
+      "description": "Background and global game state management, including broadcasts, rewards, and score.",
+      "plans": [
+        {
+          "event": "event_whenflagclicked",
+          "logic": "switch backdrop to Blue Sky; set score to 0; show variable score; broadcast Game Start;",
+          "motion": [],
+          "control": [],
+          "operator": [],
+          "sensing": [],
+          "looks": [
+            "looks_switchbackdropto"
+          ],
+          "sounds": [],
+          "events": [
+            "event_broadcast"
+          ],
+          "data": [
+            "data_setvariableto",
+            "data_showvariable"
+          ],
+          "block_relationships": [
+            {
+              "type": "stacked",
+              "blocks": [
+                "event_whenflagclicked",
+                "looks_switchbackdropto",
+                "data_setvariableto",
+                "data_showvariable",
+                "event_broadcast"
+              ]
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "looks_switchbackdropto",
+              "input_slot_name": "BACKDROP",
+              "value": "Blue Sky"
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "data_setvariableto",
+              "input_slot_name": "VALUE",
+              "value": "0"
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "event_broadcast",
+              "input_slot_name": "BROADCAST",
+              "value": "Game Start"
+            }
+          ]
+        },
+        {
+          "event": "event_whenbroadcastreceived",
+          "logic": "if score > High Score, then set High Score to score; switch backdrop to congratulatory backdrop; broadcast Level Up;",
+          "motion": [],
+          "control": [
+            "control_if"
+          ],
+          "operator": [
+            "operator_gt"
+          ],
+          "sensing": [],
+          "looks": [
+            "looks_switchbackdropto"
+          ],
+          "sounds": [],
+          "events": [
+            "event_broadcast"
+          ],
+          "data": [
+            "data_setvariableto"
+          ],
+          "block_relationships": [
+            {
+              "type": "stacked",
+              "blocks": [
+                "event_whenbroadcastreceived",
+                "control_if"
+              ]
+            },
+            {
+              "type": "nested_c_block_body",
+              "parent": "control_if",
+              "child_opcodes": [
+                "operator_gt",
+                "data_setvariableto",
+                "looks_switchbackdropto",
+                "event_broadcast"
+              ]
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "operator_gt",
+              "input_slot_name": "",
+              "child_opcodes": [
+                "data_variable",
+                "data_variable"
+              ]
+            },
+            {
+              "type": "nested_literal_input",
+              "parent_opcode": "event_broadcast",
+              "input_slot_name": "BROADCAST",
+              "value": "Level Up"
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "control_if",
+              "input_slot_name": "CONDITION",
+              "child_opcode": "operator_gt"
+            },
+            {
+              "type": "nested_input",
+              "parent_opcode": "data_setvariableto",
+              "input_slot_name": "VALUE",
+              "child_opcode": "data_variable"
+            }
+          ]
+        }
+      ]
+    },
+    "action_overall_flow": {
+      "Sprite1": {
+        "description": "Main character (cat) actions",
+        "plans": [
+          {
+            "event": "event_whenflagclicked",
+            "logic": "go to x:0 y:-120; set lives to 3; set score to 0; show variable score; show variable lives; broadcast Game Start;",
+            "motion": [
+              "motion_gotoxy",
+              "motion_setx",
+              "motion_sety"
+            ],
+            "control": [],
+            "operator": [],
+            "sensing": [],
+            "looks": [],
+            "sounds": [],
+            "events": [
+              "event_broadcast"
+            ],
+            "data": [
+              "data_setvariableto",
+              "data_showvariable"
+            ],
+            "block_relationships": [
+              {
+                "type": "stacked",
+                "blocks": [
+                  "event_whenflagclicked",
+                  "motion_gotoxy",
+                  "data_setvariableto",
+                  "data_setvariableto",
+                  "looks_showvariable",
+                  "looks_showvariable",
+                  "events_broadcast"
+                ]
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "motion_gotoxy",
+                "input_slot_name": "X",
+                "value": "0"
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "motion_gotoxy",
+                "input_slot_name": "Y",
+                "value": "-120"
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "data_setvariableto",
+                "input_slot_name": "VALUE",
+                "value": "3"
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "data_setvariableto",
+                "input_slot_name": "VARIABLE",
+                "value": "lives"
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "data_setvariableto",
+                "input_slot_name": "VALUE",
+                "value": "0"
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "data_setvariableto",
+                "input_slot_name": "VARIABLE",
+                "value": "score"
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "events_broadcast",
+                "input_slot_name": "BROADCAST",
+                "value": "Game Start"
+              }
+            ]
+          },
+          {
+            "event": "event_whenkeypressed",
+            "logic": "forever: if key space is pressed, then change y by 20; wait 0.1 seconds; change y by -20; if lives = 0, then broadcast Game Over; stop all;",
+            "motion": [
+              "motion_changeyby"
+            ],
+            "control": [
+              "control_forever",
+              "control_if",
+              "control_stop"
+            ],
+            "operator": [
+              "operator_equals"
+            ],
+            "sensing": [
+              "sensing_keypressed"
+            ],
+            "looks": [],
+            "sounds": [],
+            "events": [
+              "event_broadcast"
+            ],
+            "data": [
+              "data_variable"
+            ],
+            "block_relationships": [
+              {
+                "type": "stacked",
+                "blocks": [
+                  "event_whenkeypressed",
+                  "control_forever"
+                ]
+              },
+              {
+                "type": "nested_c_block_body",
+                "parent": "control_forever",
+                "child_opcodes": [
+                  "sensing_keypressed",
+                  "control_if"
+                ]
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "sensing_keypressed",
+                "input_slot_name": "KEY",
+                "value": "space"
+              },
+              {
+                "type": "stacked",
+                "blocks": [
+                  "motion_changeyby",
+                  "wait",
+                  "motion_changeyby"
+                ]
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "motion_changeyby",
+                "input_slot_name": "DISTANCE",
+                "value": "20"
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "wait",
+                "input_slot_name": "DURATION",
+                "value": "0.1"
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "motion_changeyby",
+                "input_slot_name": "DISTANCE",
+                "value": "-20"
+              },
+              {
+                "type": "nested_c_block_body",
+                "parent": "control_if",
+                "child_opcodes": [
+                  "operator_equals",
+                  "data_variable"
+                ]
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "operator_equals",
+                "input_slot_name": "OPERAND1",
+                "child_opcode": "data_variable"
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "operator_equals",
+                "input_slot_name": "OPERAND2",
+                "value": "0"
+              },
+              {
+                "type": "stacked",
+                "blocks": [
+                  "event_broadcast",
+                  "control_stop"
+                ]
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "event_broadcast",
+                "input_slot_name": "BROADCAST",
+                "value": "Game Over"
+              }
+            ]
+          }
+        ]
+      },
+      "soccer ball": {
+        "description": "Obstacle movement and interaction",
+        "plans": [
+          {
+            "event": "event_whenflagclicked",
+            "logic": "go to x:240 y:0; forever: glide 2 seconds to x:-240 y:0; if touching Sprite1, then change lives by -1; if lives < 0, then broadcast Game Over; stop all;",
+            "motion": [
+              "motion_gotoxy",
+              "motion_glidesecstoxy"
+            ],
+            "control": [
+              "control_forever",
+              "control_if",
+              "control_stop"
+            ],
+            "operator": [
+              "operator_lt"
+            ],
+            "sensing": [
+              "sensing_touchingobject"
+            ],
+            "looks": [],
+            "sounds": [],
+            "events": [
+              "event_broadcast"
+            ],
+            "data": [
+              "data_changevariableby"
+            ],
+            "block_relationships": [
+              {
+                "type": "stacked",
+                "blocks": [
+                  "event_whenflagclicked",
+                  "motion_gotoxy",
+                  "control_forever"
+                ]
+              },
+              {
+                "type": "nested_c_block_body",
+                "parent": "control_forever",
+                "child_opcodes": [
+                  "motion_glidesecstoxy",
+                  "control_if",
+                  "control_if",
+                  "event_broadcast",
+                  "control_stop"
+                ]
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "motion_glidesecstoxy",
+                "input_slot_name": "X",
+                "value": "-240"
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "motion_glidesecstoxy",
+                "input_slot_name": "Y",
+                "value": "0"
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "motion_glidesecstoxy",
+                "input_slot_name": "SECS",
+                "value": "2"
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "control_if",
+                "input_slot_name": "CONDITION",
+                "child_opcode": "sensing_touchingobject"
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "control_if",
+                "input_slot_name": "CONDITION",
+                "child_opcode": "operator_lt"
+              },
+              {
+                "type": "nested_c_block_body",
+                "parent": "control_if",
+                "child_opcodes": [
+                  "data_changevariableby"
+                ]
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "data_changevariableby",
+                "input_slot_name": "VARIABLE",
+                "value": "lives"
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "data_changevariableby",
+                "input_slot_name": "VALUE",
+                "value": "-1"
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "operator_lt",
+                "input_slot_name": "OPERAND1",
+                "value": "lives"
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "operator_lt",
+                "input_slot_name": "OPERAND2",
+                "value": "0"
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "event_broadcast",
+                "input_slot_name": "BROADCAST",
+                "value": "Game Over"
+              }
+            ]
+          }
+        ]
+      },
+      "Stage": {
+        "description": "Background and global game state management, including broadcasts, rewards, and score.",
+        "plans": [
+          {
+            "event": "event_whenflagclicked",
+            "logic": "switch backdrop to Blue Sky; set score to 0; show variable score; broadcast Game Start;",
+            "motion": [],
+            "control": [],
+            "operator": [],
+            "sensing": [],
+            "looks": [
+              "looks_switchbackdropto"
+            ],
+            "sounds": [],
+            "events": [
+              "event_broadcast"
+            ],
+            "data": [
+              "data_setvariableto",
+              "data_showvariable"
+            ],
+            "block_relationships": [
+              {
+                "type": "stacked",
+                "blocks": [
+                  "event_whenflagclicked",
+                  "looks_switchbackdropto",
+                  "data_setvariableto",
+                  "data_showvariable",
+                  "event_broadcast"
+                ]
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "looks_switchbackdropto",
+                "input_slot_name": "BACKDROP",
+                "value": "Blue Sky"
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "data_setvariableto",
+                "input_slot_name": "VALUE",
+                "value": "0"
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "event_broadcast",
+                "input_slot_name": "BROADCAST",
+                "value": "Game Start"
+              }
+            ]
+          },
+          {
+            "event": "event_whenbroadcastreceived",
+            "logic": "if score > High Score, then set High Score to score; switch backdrop to congratulatory backdrop; broadcast Level Up;",
+            "motion": [],
+            "control": [
+              "control_if"
+            ],
+            "operator": [
+              "operator_gt"
+            ],
+            "sensing": [],
+            "looks": [
+              "looks_switchbackdropto"
+            ],
+            "sounds": [],
+            "events": [
+              "event_broadcast"
+            ],
+            "data": [
+              "data_setvariableto"
+            ],
+            "block_relationships": [
+              {
+                "type": "stacked",
+                "blocks": [
+                  "event_whenbroadcastreceived",
+                  "control_if"
+                ]
+              },
+              {
+                "type": "nested_c_block_body",
+                "parent": "control_if",
+                "child_opcodes": [
+                  "operator_gt",
+                  "data_setvariableto",
+                  "looks_switchbackdropto",
+                  "event_broadcast"
+                ]
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "operator_gt",
+                "input_slot_name": "",
+                "child_opcodes": [
+                  "data_variable",
+                  "data_variable"
+                ]
+              },
+              {
+                "type": "nested_literal_input",
+                "parent_opcode": "event_broadcast",
+                "input_slot_name": "BROADCAST",
+                "value": "Level Up"
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "control_if",
+                "input_slot_name": "CONDITION",
+                "child_opcode": "operator_gt"
+              },
+              {
+                "type": "nested_input",
+                "parent_opcode": "data_setvariableto",
+                "input_slot_name": "VALUE",
+                "child_opcode": "data_variable"
+              }
+            ]
+          }
+        ]
+      }
+    }
+  },
+  "improvement_plan": {},
+  "needs_improvement": false,
+  "plan_validation_feedback": "The game plan and block structure show a good start but have several areas needing improvement. The 'soccer ball' obstacle's movement speed is not defined, and its interaction with 'Sprite1' could be more detailed. The scoring system and high score tracking are present but lack a clear implementation of how points are awarded per obstacle cleared. The block logic for 'Sprite1' movement and jumping seems incomplete, particularly in handling edge cases and ensuring smooth gameplay. Additionally, power-ups, levels, and sound effects are mentioned but not implemented in the provided JSON.\n(Note: Max iterations reached, stopping further improvements.)",
+  "iteration_count": 0,
+  "review_block_feedback": {},
+  "declaration_plan": {
+    "declaration_plan": {
+      "variables": [
+        {
+          "name": "score",
+          "default": 0,
+          "cloud": false
+        },
+        {
+          "name": "☁ High Score",
+          "default": 0,
+          "cloud": true
+        },
+        {
+          "name": "speed",
+          "default": 0,
+          "cloud": false
+        },
+        {
+          "name": "lives",
+          "default": 3,
+          "cloud": false
+        },
+        {
+          "name": "level",
+          "default": 1,
+          "cloud": false
+        }
+      ],
+      "lists": [
+        {
+          "name": "recent_scores",
+          "default": []
+        },
+        {
+          "name": "obstacle_speeds",
+          "default": []
+        },
+        {
+          "name": "power_ups",
+          "default": []
+        }
+      ],
+      "broadcasts": [
+        "Game Over",
+        "Game Start",
+        "Level Up",
+        "Power Up Collected"
+      ],
+      "monitors": [
+        {
+          "target": "Stage",
+          "variable": "score",
+          "visible": true,
+          "opcode_hint": "data_variable"
+        },
+        {
+          "target": "Stage",
+          "variable": "☁ High Score",
+          "visible": true,
+          "opcode_hint": "data_variable"
+        },
+        {
+          "target": "Stage",
+          "reporter_name": "backdrop #",
+          "visible": false,
+          "opcode_hint": "looks_backdropnumbername",
+          "param_name": "NUMBER_NAME"
+        },
+        {
+          "target": "Stage",
+          "reporter_name": "time",
+          "visible": false,
+          "opcode_hint": "sensing_timer"
+        }
+      ]
+    }
+  }
+}

v2/scratch_agent/debug_declaration.json

@@ -0,0 +1,80 @@
+{
+  "declaration_plan": {
+    "variables": [
+      {
+        "name": "score",
+        "default": 0,
+        "cloud": false
+      },
+      {
+        "name": "☁ High Score",
+        "default": 0,
+        "cloud": true
+      },
+      {
+        "name": "speed",
+        "default": 0,
+        "cloud": false
+      },
+      {
+        "name": "health",
+        "default": 1,
+        "cloud": false
+      },
+      {
+        "name": "shieldActive",
+        "default": false,
+        "cloud": false
+      },
+      {
+        "name": "combo",
+        "default": 0,
+        "cloud": false
+      }
+    ],
+    "lists": [
+      {
+        "name": "recent_scores",
+        "default": []
+      },
+      {
+        "name": "obstacleSpeeds",
+        "default": []
+      },
+      {
+        "name": "powerUps",
+        "default": []
+      }
+    ],
+    "broadcasts": [
+      "Game Over",
+      "Game Start",
+      "Jump",
+      "Power-Up",
+      "Obstacle Spawned"
+    ],
+    "monitors": [
+      {
+        "target": "Stage",
+        "variable": "score",
+        "visible": true
+      },
+      {
+        "target": "Stage",
+        "variable": "☁ High Score",
+        "visible": true
+      },
+      {
+        "target": "Sprite1",
+        "reporter": "looks_costumenumbername",
+        "param": "number",
+        "visible": false
+      },
+      {
+        "target": "Stage",
+        "variable": "health",
+        "visible": true
+      }
+    ]
+  }
+}

v2/scratch_agent/debug_declaration_build.json

@@ -0,0 +1,222 @@
+{
+  "targets": [
+    {
+      "isStage": true,
+      "name": "Stage",
+      "objName": "Stage",
+      "variables": {
+        "7dcb660865ba476ebdaa": [
+          "score",
+          0
+        ],
+        "3c8be35cce194775a4a3": [
+          "☁ High Score",
+          0,
+          true
+        ],
+        "2f82959a49654440b68b": [
+          "speed",
+          0
+        ],
+        "64d7513596744243ab31": [
+          "health",
+          1
+        ],
+        "03e90317245140799586": [
+          "shieldActive",
+          false
+        ],
+        "4b4d2e1a6d9a4be19f3c": [
+          "combo",
+          0
+        ]
+      },
+      "lists": {
+        "41e1392f5ef542f889ba": {
+          "name": "recent_scores",
+          "contents": []
+        },
+        "3e2ffe7c93c14dd88489": {
+          "name": "obstacleSpeeds",
+          "contents": []
+        },
+        "efa4d9f299f9490789a4": {
+          "name": "powerUps",
+          "contents": []
+        }
+      },
+      "broadcasts": {
+        "c67672b23e944564a20a": "Game Over",
+        "e3634bf80cec481086b2": "Game Start",
+        "e1924b50715b4002a7eb": "Jump",
+        "8694255df85e43b894fb": "Power-Up",
+        "80356261553347a9a74b": "Obstacle Spawned"
+      },
+      "blocks": {},
+      "comments": {},
+      "currentCostume": 0,
+      "costumes": [
+        {
+          "name": "Blue sky",
+          "bitmapResolution": 1,
+          "dataFormat": "svg",
+          "assetId": "e7c147730f19d284bcd7b3f00af19bb6",
+          "md5ext": "e7c147730f19d284bcd7b3f00af19bb6.svg",
+          "rotationCenterX": 240,
+          "rotationCenterY": 180
+        }
+      ],
+      "sounds": [],
+      "volume": 100,
+      "layerOrder": 0,
+      "tempo": 60,
+      "videoTransparency": 50,
+      "videoState": "on",
+      "textToSpeechLanguage": null
+    },
+    {
+      "isStage": false,
+      "name": "Sprite1",
+      "objName": "Sprite1",
+      "variables": {},
+      "lists": {},
+      "broadcasts": {},
+      "blocks": {},
+      "comments": {},
+      "currentCostume": 0,
+      "costumes": [
+        {
+          "name": "Sprite1",
+          "bitmapResolution": 1,
+          "dataFormat": "svg",
+          "assetId": "bcf454acf82e4504149f7ffe07081dbc",
+          "md5ext": "bcf454acf82e4504149f7ffe07081dbc.svg",
+          "rotationCenterX": 0,
+          "rotationCenterY": 0
+        }
+      ],
+      "sounds": [],
+      "volume": 100,
+      "layerOrder": 2,
+      "visible": true,
+      "x": 240,
+      "y": -150,
+      "size": 100,
+      "direction": 90,
+      "draggable": false,
+      "rotationStyle": "all around"
+    },
+    {
+      "isStage": false,
+      "name": "soccer ball",
+      "objName": "soccer ball",
+      "variables": {},
+      "lists": {},
+      "broadcasts": {},
+      "blocks": {},
+      "comments": {},
+      "currentCostume": 0,
+      "costumes": [
+        {
+          "name": "soccer ball",
+          "bitmapResolution": 1,
+          "dataFormat": "svg",
+          "assetId": "0fb9be3e8397c983338cb71dc84d0b25",
+          "md5ext": "0fb9be3e8397c983338cb71dc84d0b25.svg",
+          "rotationCenterX": 0,
+          "rotationCenterY": 0
+        }
+      ],
+      "sounds": [],
+      "volume": 100,
+      "layerOrder": 3,
+      "visible": true,
+      "x": 500,
+      "y": 0,
+      "size": 100,
+      "direction": 90,
+      "draggable": false,
+      "rotationStyle": "all around"
+    }
+  ],
+  "monitors": [
+    {
+      "id": "c6146b7101d74c44bd60",
+      "mode": "default",
+      "opcode": "data_variable",
+      "params": {
+        "VARIABLE": "score"
+      },
+      "spriteName": null,
+      "value": "0",
+      "width": 0,
+      "height": 0,
+      "x": 0,
+      "y": 0,
+      "visible": true,
+      "sliderMin": 0,
+      "sliderMax": 100,
+      "isDiscrete": true
+    },
+    {
+      "id": "1603633d73134e17b5c2",
+      "mode": "default",
+      "opcode": "data_variable",
+      "params": {
+        "VARIABLE": "☁ High Score"
+      },
+      "spriteName": null,
+      "value": "0",
+      "width": 0,
+      "height": 0,
+      "x": 0,
+      "y": 0,
+      "visible": true,
+      "sliderMin": 0,
+      "sliderMax": 100,
+      "isDiscrete": true
+    },
+    {
+      "id": "f919c711bc8d40ebb6dc",
+      "mode": "default",
+      "opcode": "looks_costumenumbername",
+      "params": {
+        "number": "number"
+      },
+      "spriteName": "Sprite1",
+      "value": 0,
+      "width": 0,
+      "height": 0,
+      "x": 0,
+      "y": 0,
+      "visible": false,
+      "sliderMin": 0,
+      "sliderMax": 100,
+      "isDiscrete": true
+    },
+    {
+      "id": "7bbe5ec8cd254dafa936",
+      "mode": "default",
+      "opcode": "data_variable",
+      "params": {
+        "VARIABLE": "health"
+      },
+      "spriteName": null,
+      "value": "0",
+      "width": 0,
+      "height": 0,
+      "x": 0,
+      "y": 0,
+      "visible": true,
+      "sliderMin": 0,
+      "sliderMax": 100,
+      "isDiscrete": true
+    }
+  ],
+  "extensions": [],
+  "meta": {
+    "semver": "3.0.0",
+    "vm": "11.1.0",
+    "agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36"
+  }
+}

v2/scratch_agent/debug_declaration_builder.json

@@ -0,0 +1,327 @@
+{
+  "project_json": {
+    "targets": [
+      {
+        "isStage": true,
+        "name": "Stage",
+        "objName": "Stage",
+        "variables": {
+          "score_72ab5419": [
+            "score",
+            "0"
+          ],
+          "highScore_6ce0673b": [
+            "highScore",
+            "0",
+            true
+          ],
+          "speed_cd8f138a": [
+            "speed",
+            "5"
+          ],
+          "jumpForce_bbc24da6": [
+            "jumpForce",
+            "10"
+          ],
+          "gravity_1891d30f": [
+            "gravity",
+            "0.5"
+          ],
+          "obstacleSpeed_64bb2fef": [
+            "obstacleSpeed",
+            "3"
+          ]
+        },
+        "lists": {
+          "recent_scores_c9d81b19": [
+            "recent_scores",
+            []
+          ],
+          "obstacle_positions_a3be8d3d": [
+            "obstacle_positions",
+            []
+          ]
+        },
+        "broadcasts": {
+          "Game Over_94869dc4": "Game Over",
+          "Game Start_fa3b7008": "Game Start",
+          "Jump_1fe96dd3": "Jump",
+          "Reset Game_277b990f": "Reset Game"
+        },
+        "blocks": {},
+        "comments": {},
+        "currentCostume": 0,
+        "costumes": [
+          {
+            "name": "Blue sky",
+            "bitmapResolution": 1,
+            "dataFormat": "svg",
+            "assetId": "e7c147730f19d284bcd7b3f00af19bb6",
+            "md5ext": "e7c147730f19d284bcd7b3f00af19bb6.svg",
+            "rotationCenterX": 240,
+            "rotationCenterY": 180
+          }
+        ],
+        "sounds": [
+          {
+            "name": "button",
+            "dataFormat": "wav",
+            "rate": 44100,
+            "sampleCount": 0,
+            "assetId": "83a9787d4cb6f3b7632b4ddfebf74367",
+            "md5ext": "83a9787d4cb6f3b7632b4ddfebf74367.wav"
+          }
+        ],
+        "volume": 100,
+        "layerOrder": 0,
+        "tempo": 60,
+        "videoTransparency": 50,
+        "videoState": "on",
+        "textToSpeechLanguage": null
+      },
+      {
+        "isStage": false,
+        "name": "Sprite1",
+        "objName": "Sprite1",
+        "variables": {},
+        "lists": {},
+        "broadcasts": {},
+        "blocks": {},
+        "comments": {},
+        "currentCostume": 0,
+        "costumes": [
+          {
+            "name": "Sprite1",
+            "bitmapResolution": 1,
+            "dataFormat": "svg",
+            "assetId": "bcf454acf82e4504149f7ffe07081dbc",
+            "md5ext": "bcf454acf82e4504149f7ffe07081dbc.svg",
+            "rotationCenterX": 0,
+            "rotationCenterY": 0
+          }
+        ],
+        "sounds": [
+          {
+            "name": "meow",
+            "dataFormat": "wav",
+            "rate": 44100,
+            "sampleCount": 0,
+            "assetId": "83c36d806dc92327b9e7049a565c6bff",
+            "md5ext": "83c36d806dc92327b9e7049a565c6bff.wav"
+          }
+        ],
+        "volume": 100,
+        "layerOrder": 2,
+        "visible": true,
+        "x": -200,
+        "y": -100,
+        "size": 100,
+        "direction": 90,
+        "draggable": false,
+        "rotationStyle": "all around"
+      },
+      {
+        "isStage": false,
+        "name": "soccer ball",
+        "objName": "soccer ball",
+        "variables": {},
+        "lists": {},
+        "broadcasts": {},
+        "blocks": {},
+        "comments": {},
+        "currentCostume": 0,
+        "costumes": [
+          {
+            "name": "soccer ball",
+            "bitmapResolution": 1,
+            "dataFormat": "svg",
+            "assetId": "0fb9be3e8397c983338cb71dc84d0b25",
+            "md5ext": "0fb9be3e8397c983338cb71dc84d0b25.svg",
+            "rotationCenterX": 0,
+            "rotationCenterY": 0
+          }
+        ],
+        "sounds": [],
+        "volume": 100,
+        "layerOrder": 3,
+        "visible": true,
+        "x": 200,
+        "y": 0,
+        "size": 100,
+        "direction": 90,
+        "draggable": false,
+        "rotationStyle": "all around"
+      }
+    ],
+    "monitors": [
+      {
+        "id": "monitor_123e4567",
+        "opcode": "data_variable",
+        "spriteName": "Stage",
+        "params": {
+          "VARIABLE": "score"
+        },
+        "value": "0",
+        "visible": true,
+        "x": 5,
+        "y": 5,
+        "mode": "default",
+        "sliderMin": 0,
+        "sliderMax": 100,
+        "isDiscrete": true
+      },
+      {
+        "id": "monitor_8f4e5678",
+        "opcode": "data_variable",
+        "spriteName": "Stage",
+        "params": {
+          "VARIABLE": "highScore"
+        },
+        "value": "0",
+        "visible": true,
+        "x": 325,
+        "y": 5,
+        "mode": "default",
+        "sliderMin": 0,
+        "sliderMax": 100,
+        "isDiscrete": true
+      },
+      {
+        "id": "monitor_456e7890",
+        "opcode": "looks_costumenumbername",
+        "spriteName": "Sprite1",
+        "params": {
+          "NUMBER_NAME": "number"
+        },
+        "value": "1",
+        "visible": false,
+        "x": 5,
+        "y": 55,
+        "mode": "default",
+        "sliderMin": 0,
+        "sliderMax": 100,
+        "isDiscrete": true
+      },
+      {
+        "id": "monitor_9f4e5678",
+        "opcode": "motion_yposition",
+        "spriteName": "Sprite1",
+        "params": {},
+        "value": "0",
+        "visible": false,
+        "x": 325,
+        "y": 55,
+        "mode": "default",
+        "sliderMin": 0,
+        "sliderMax": 100,
+        "isDiscrete": true
+      }
+    ],
+    "extensions": [],
+    "meta": {
+      "semver": "3.0.0",
+      "vm": "11.1.0",
+      "agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36"
+    }
+  },
+  "description": "In \"Cat's Obstacle Dash,\" a thrilling adventure unfolds on the Scratch Stage, where a nimble cat, represented by Sprite1, must navigate through a challenging course while avoiding or jumping over obstacles. The game takes place in a vibrant blue sky, setting the stage for an exhilarating experience.\n\n**Gameplay Overview:**\n\n- The player's objective is to control the cat, guiding it through the course while avoiding collisions with moving obstacles, in this case, a soccer ball that will be programmed to move across the screen.\n- The game starts with the cat positioned at the beginning of the course. As the game progresses, the soccer ball obstacle will start moving from one side of the screen to the other, requiring the player to time their jumps carefully.\n- The cat can jump over the soccer ball by pressing a specific key, adding an element of timing and precision to the gameplay.\n\n**Game Elements and Mechanics:**\n\n- **Cat (Sprite1):** The main character that the player controls. It can move left and right and jump over obstacles.\n- **Soccer Ball:** Acts as the obstacle. It moves horizontally across the screen at a constant speed, and the player must time the cat's jump to avoid collision.\n- **Stage:** The blue sky backdrop provides a visually appealing setting for the game. \n\n**Potential Gameplay Enhancements:**\n\n- **Score System:** Implement a scoring system where players earn points for successfully jumping over the soccer ball. The score could increase with each successful jump or based on the distance covered without hitting an obstacle.\n- **Power-Ups:** Introduce power-ups or special abilities, such as increased jump height or temporary invincibility, to enhance gameplay and strategy.\n- **Level Progression:** Design multiple levels with increasing difficulty, such as faster-moving obstacles, narrower platforms, or additional obstacles.\n\n**Objectives:**\n\n- Guide the cat through the course, avoiding the soccer ball obstacle.\n- Achieve the highest score possible by successfully navigating through the course.\n\n**Overall Feel:**\n\n- The game aims to provide a fun, challenging experience that tests the player's timing and reflexes.\n- The colorful backdrop and simple yet engaging gameplay mechanics are designed to appeal to players of all ages.\n\nBy incorporating these elements, \"Cat's Obstacle Dash\" promises to deliver an engaging and entertaining Scratch game that leverages the platform's capabilities to create a dynamic and interactive experience.",
+  "project_id": "ddb6a76e-58b0-48ed-ac7a-80dcfd98126d",
+  "sprite_initial_positions": {},
+  "action_plan": {},
+  "improvement_plan": {},
+  "needs_improvement": false,
+  "plan_validation_feedback": {},
+  "iteration_count": 0,
+  "review_block_feedback": {},
+  "declaration_plan": {
+    "declaration_plan": {
+      "variables": [
+        {
+          "name": "score",
+          "default": 0,
+          "cloud": false
+        },
+        {
+          "name": "highScore",
+          "default": 0,
+          "cloud": true
+        },
+        {
+          "name": "speed",
+          "default": 5,
+          "cloud": false
+        },
+        {
+          "name": "jumpForce",
+          "default": 10,
+          "cloud": false
+        },
+        {
+          "name": "gravity",
+          "default": 0.5,
+          "cloud": false
+        },
+        {
+          "name": "obstacleSpeed",
+          "default": 3,
+          "cloud": false
+        }
+      ],
+      "lists": [
+        {
+          "name": "recent_scores",
+          "default": []
+        },
+        {
+          "name": "obstacle_positions",
+          "default": []
+        }
+      ],
+      "broadcasts": [
+        "Game Over",
+        "Game Start",
+        "Jump",
+        "Reset Game"
+      ],
+      "monitors": [
+        {
+          "target": "Stage",
+          "variable": "score",
+          "visible": true,
+          "opcode_hint": "data_variable"
+        },
+        {
+          "target": "Stage",
+          "variable": "highScore",
+          "visible": true,
+          "opcode_hint": "data_variable"
+        },
+        {
+          "target": "Sprite1",
+          "reporter_name": "costume #",
+          "visible": false,
+          "opcode_hint": "looks_costumenumbername",
+          "param_name": "NUMBER_NAME"
+        },
+        {
+          "target": "Sprite1",
+          "reporter_name": "x position",
+          "visible": false,
+          "opcode_hint": "motion_xposition"
+        },
+        {
+          "target": "Sprite1",
+          "reporter_name": "y position",
+          "visible": false,
+          "opcode_hint": "motion_yposition"
+        },
+        {
+          "target": "Soccer Ball",
+          "reporter_name": "x position",
+          "visible": false,
+          "opcode_hint": "motion_xposition"
+        }
+      ]
+    }
+  }
+}

v2/scratch_agent/debug_declaration_plan.json

@@ -0,0 +1,85 @@
+{
+  "declaration_plan": {
+    "variables": [
+      {
+        "name": "score",
+        "default": 0,
+        "cloud": false
+      },
+      {
+        "name": "☁ High Score",
+        "default": 0,
+        "cloud": true
+      },
+      {
+        "name": "speed",
+        "default": 0,
+        "cloud": false
+      },
+      {
+        "name": "lives",
+        "default": 3,
+        "cloud": false
+      },
+      {
+        "name": "level",
+        "default": 1,
+        "cloud": false
+      }
+    ],
+    "lists": [
+      {
+        "name": "recent_scores",
+        "default": []
+      },
+      {
+        "name": "obstacle_sizes",
+        "default": []
+      },
+      {
+        "name": "obstacle_speeds",
+        "default": []
+      }
+    ],
+    "broadcasts": [
+      "Game Over",
+      "Game Start",
+      "Level Up",
+      "Reset Game"
+    ],
+    "monitors": [
+      {
+        "target": "Stage",
+        "variable": "score",
+        "visible": true,
+        "opcode_hint": "data_variable"
+      },
+      {
+        "target": "Stage",
+        "variable": "☁ High Score",
+        "visible": true,
+        "opcode_hint": "data_variable"
+      },
+      {
+        "target": "Stage",
+        "variable": "lives",
+        "visible": true,
+        "opcode_hint": "data_variable"
+      },
+      {
+        "target": "Stage",
+        "reporter_name": "costume #",
+        "visible": false,
+        "opcode_hint": "looks_costumenumbername",
+        "param_name": "NUMBER_NAME"
+      },
+      {
+        "target": "Stage",
+        "reporter_name": "backdrop #",
+        "visible": false,
+        "opcode_hint": "looks_backdropnumbername",
+        "param_name": "NUMBER_NAME"
+      }
+    ]
+  }
+}

v2/scratch_agent/debug_state.json

@@ -0,0 +1,478 @@
+{
+  "project_json": {
+    "targets": [
+      {
+        "isStage": true,
+        "name": "Stage",
+        "objName": "Stage",
+        "variables": {
+          "score_9c11a348": [
+            "score",
+            "0"
+          ],
+          "☁ High Score_1da2aedb": [
+            "☁ High Score",
+            "0",
+            true
+          ],
+          "speed_d988ac30": [
+            "speed",
+            "0"
+          ],
+          "lives_45581a71": [
+            "lives",
+            "3"
+          ],
+          "level_9cef21ff": [
+            "level",
+            "1"
+          ]
+        },
+        "lists": {
+          "recent_scores_d16ebefa": [
+            "recent_scores",
+            []
+          ],
+          "obstacle_sizes_bac2d8a1": [
+            "obstacle_sizes",
+            []
+          ],
+          "obstacle_speeds_d0d95af7": [
+            "obstacle_speeds",
+            []
+          ]
+        },
+        "broadcasts": {
+          "Game Over_a59c2858": "Game Over",
+          "Game Start_98c95fc0": "Game Start",
+          "Level Up_6ff1c194": "Level Up",
+          "Reset Game_789e84e5": "Reset Game"
+        },
+        "blocks": {},
+        "comments": {},
+        "currentCostume": 0,
+        "costumes": [
+          {
+            "name": "Blue sky",
+            "bitmapResolution": 1,
+            "dataFormat": "svg",
+            "assetId": "e7c147730f19d284bcd7b3f00af19bb6",
+            "md5ext": "e7c147730f19d284bcd7b3f00af19bb6.svg",
+            "rotationCenterX": 240,
+            "rotationCenterY": 180
+          }
+        ],
+        "sounds": [
+          {
+            "name": "button",
+            "dataFormat": "wav",
+            "rate": 44100,
+            "sampleCount": 0,
+            "assetId": "83a9787d4cb6f3b7632b4ddfebf74367",
+            "md5ext": "83a9787d4cb6f3b7632b4ddfebf74367.wav"
+          }
+        ],
+        "volume": 100,
+        "layerOrder": 0,
+        "tempo": 60,
+        "videoTransparency": 50,
+        "videoState": "on",
+        "textToSpeechLanguage": null
+      },
+      {
+        "isStage": false,
+        "name": "Cat",
+        "objName": "Cat",
+        "variables": {},
+        "lists": {},
+        "broadcasts": {},
+        "blocks": {},
+        "comments": {},
+        "currentCostume": 0,
+        "costumes": [
+          {
+            "name": "Cat",
+            "bitmapResolution": 1,
+            "dataFormat": "svg",
+            "assetId": "bcf454acf82e4504149f7ffe07081dbc",
+            "md5ext": "bcf454acf82e4504149f7ffe07081dbc.svg",
+            "rotationCenterX": 0,
+            "rotationCenterY": 0
+          }
+        ],
+        "sounds": [
+          {
+            "name": "Meow",
+            "dataFormat": "wav",
+            "rate": 44100,
+            "sampleCount": 0,
+            "assetId": "83c36d806dc92327b9e7049a565c6bff",
+            "md5ext": "83c36d806dc92327b9e7049a565c6bff.wav"
+          }
+        ],
+        "volume": 100,
+        "layerOrder": 2,
+        "visible": true,
+        "x": 0,
+        "y": 0,
+        "size": 100,
+        "direction": 90,
+        "draggable": false,
+        "rotationStyle": "all around"
+      },
+      {
+        "isStage": false,
+        "name": "ball",
+        "objName": "ball",
+        "variables": {},
+        "lists": {},
+        "broadcasts": {},
+        "blocks": {},
+        "comments": {},
+        "currentCostume": 0,
+        "costumes": [
+          {
+            "name": "ball",
+            "bitmapResolution": 1,
+            "dataFormat": "svg",
+            "assetId": "5d973d7a3a8be3f3bd6e1cd0f73c32b5",
+            "md5ext": "5d973d7a3a8be3f3bd6e1cd0f73c32b5.svg",
+            "rotationCenterX": 0,
+            "rotationCenterY": 0
+          }
+        ],
+        "sounds": [],
+        "volume": 100,
+        "layerOrder": 3,
+        "visible": true,
+        "x": 130,
+        "y": 0,
+        "size": 100,
+        "direction": 90,
+        "draggable": false,
+        "rotationStyle": "all around"
+      }
+    ],
+    "monitors": [
+      {
+        "id": "monitor_123e4567",
+        "opcode": "data_variable",
+        "mode": "default",
+        "params": {
+          "VARIABLE": "score"
+        },
+        "spriteName": "Stage",
+        "value": "0",
+        "visible": true,
+        "x": 5,
+        "y": 5,
+        "sliderMin": 0,
+        "sliderMax": 100,
+        "isDiscrete": true
+      },
+      {
+        "id": "monitor_8f4e3210",
+        "opcode": "data_variable",
+        "mode": "default",
+        "params": {
+          "VARIABLE": "☁ High Score"
+        },
+        "spriteName": "Stage",
+        "value": "0",
+        "visible": true,
+        "x": 325,
+        "y": 5,
+        "sliderMin": 0,
+        "sliderMax": 100,
+        "isDiscrete": true
+      },
+      {
+        "id": "monitor_455a2312",
+        "opcode": "data_variable",
+        "mode": "default",
+        "params": {
+          "VARIABLE": "lives"
+        },
+        "spriteName": "Stage",
+        "value": "3",
+        "visible": true,
+        "x": 5,
+        "y": 55,
+        "sliderMin": 0,
+        "sliderMax": 10,
+        "isDiscrete": true
+      },
+      {
+        "id": "monitor_4d6e649d",
+        "opcode": "looks_costumenumbername",
+        "mode": "default",
+        "params": {
+          "NUMBER_NAME": "number"
+        },
+        "spriteName": "Stage",
+        "value": "1",
+        "visible": false,
+        "x": 325,
+        "y": 55,
+        "sliderMin": 0,
+        "sliderMax": 100,
+        "isDiscrete": true
+      },
+      {
+        "id": "monitor_8f5e9012",
+        "opcode": "looks_backdropnumbername",
+        "mode": "default",
+        "params": {
+          "NUMBER_NAME": "number"
+        },
+        "spriteName": "Stage",
+        "value": "1",
+        "visible": false,
+        "x": 5,
+        "y": 105,
+        "sliderMin": 0,
+        "sliderMax": 100,
+        "isDiscrete": true
+      }
+    ],
+    "extensions": [],
+    "meta": {
+      "semver": "3.0.0",
+      "vm": "11.1.0",
+      "agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
+    }
+  },
+  "description": "**Game Title: Cat's Obstacle Dash**\n\n**Overview:** In \"Cat's Obstacle Dash,\" a fast-paced and engaging game, the player controls a curious cat named Cat as it navigates through a challenging obstacle course set against the backdrop of a serene blue sky. The game's objective is to guide Cat as it jumps over incoming obstacles, represented by balls, to achieve the highest score possible.\n\n**Gameplay:**\n\n* The game starts with Cat positioned at the center of the screen, ready to begin its journey.\n* As the game progresses, balls of various sizes will start rolling from the right side of the screen towards Cat.\n* The player must time Cat's jumps perfectly to avoid colliding with the incoming balls.\n* Each successful jump over a ball earns the player points.\n* The game ends when Cat collides with a ball, and the player's final score is displayed.\n\n**Game Mechanics:**\n\n* Cat can move left and right using the arrow keys or 'a' and 'd' keys.\n* Cat can jump using the space bar or the up arrow key.\n* The jump mechanic is physics-based, allowing Cat to jump over obstacles with precision.\n* Balls will have varying speeds and sizes, increasing the challenge as the game progresses.\n\n**Visuals and Audio:**\n\n* The game features a vibrant blue sky as the background, creating a cheerful and uplifting atmosphere.\n* Cat, the protagonist, is a cute and agile sprite with a range of animations to bring its movements to life.\n* The balls are visually distinct, with different colors and sizes to add variety to the obstacles.\n* The game includes sound effects for Cat's movements, such as meowing and pouncing sounds, as well as a fun and upbeat background music.\n\n**Scoring and Progression:**\n\n* The player earns points for each successful jump over a ball.\n* As the player progresses through the game, the balls will increase in speed and size, making it more challenging to achieve high scores.\n* The game features a leaderboard to track the player's progress and compete with friends.\n\n**Overall Feel:**\n\n* \"Cat's Obstacle Dash\" is a fast-paced and engaging game that requires precision and timing to succeed.\n* The game's colorful visuals, fun sound effects, and upbeat music create a lively and entertaining atmosphere.\n* The game's objective is simple yet challenging, making it accessible to players of all ages and skill levels.\n\n**Potential Gameplay Elements:**\n\n* Power-ups: Introduce power-ups, such as a \"shield\" that protects Cat from one ball or a \"boost\" that increases Cat's jump height.\n* Obstacle variations: Add different types of obstacles, such as moving platforms or spinning blades, to increase the game's difficulty and variety.\n* Leveling system: Introduce levels with increasing difficulty, featuring different obstacle patterns and challenges.\n\nBy incorporating these elements, \"Cat's Obstacle Dash\" can become a highly engaging and addictive game that challenges players to improve their skills and compete for the highest scores.",
+  "project_id": "c2d1aa31-17c3-4886-8718-ccbd0a157145",
+  "sprite_initial_positions": {},
+  "action_plan": {
+    "Stage": {
+      "description": "Background and global game state management, including broadcasts, rewards, and score.",
+      "plans": [
+        {
+          "event": "event_whenflagclicked",
+          "logic": "when green flag clicked\n            set [score v] to 0\n            set [speed v] to 2\n            set [lives v] to 3\n            broadcast [Game Start v]",
+          "control": [],
+          "operator": [],
+          "sensing": [],
+          "looks": [],
+          "sounds": [],
+          "events": [
+            "event_broadcast"
+          ],
+          "data": [
+            "data_setvariableto"
+          ]
+        },
+        {
+          "event": "event_whenbroadcastreceived",
+          "logic": "when I receive [Game Over v]\n            if <(score) > (High Score)> then\n              set [High Score v] to (score)\n            end\n            broadcast [Reset Game v]",
+          "control": [
+            "control_if"
+          ],
+          "operator": [
+            "operator_gt"
+          ],
+          "sensing": [],
+          "looks": [],
+          "sounds": [],
+          "events": [
+            "event_broadcast"
+          ],
+          "data": [
+            "data_setvariableto"
+          ]
+        },
+        {
+          "event": "event_whenbroadcastreceived",
+          "logic": "when I receive [Reset Game v]\n            set [score v] to 0\n            set [lives v] to 3\n            set [speed v] to 2",
+          "control": [],
+          "operator": [],
+          "sensing": [],
+          "looks": [],
+          "sounds": [],
+          "events": [
+            "event_broadcast"
+          ],
+          "data": [
+            "data_setvariableto"
+          ]
+        }
+      ]
+    },
+    "Cat": {
+      "description": "Main character (cat) actions",
+      "plans": [
+        {
+          "event": "event_whenflagclicked",
+          "logic": "when green flag clicked\n            go to x: 0 y: 0",
+          "motion": [
+            "motion_gotoxy"
+          ],
+          "control": [],
+          "operator": [],
+          "sensing": [],
+          "looks": [],
+          "sounds": [],
+          "events": [],
+          "data": []
+        },
+        {
+          "event": "event_whenkeypressed",
+          "logic": "when [space v] key pressed\n            if <([y position] = 0)> then\n              change y by 10\n            end",
+          "motion": [
+            "motion_changeyby"
+          ],
+          "control": [
+            "control_if"
+          ],
+          "operator": [],
+          "sensing": [
+            "sensing_keypressed"
+          ],
+          "looks": [],
+          "sounds": [],
+          "events": [],
+          "data": []
+        },
+        {
+          "event": "event_whenbroadcastreceived",
+          "logic": "when I receive [Game Over v]\n            hide",
+          "control": [],
+          "operator": [],
+          "sensing": [],
+          "looks": [
+            "looks_hide"
+          ],
+          "sounds": [],
+          "events": [
+            "event_broadcast"
+          ],
+          "data": []
+        }
+      ]
+    },
+    "ball": {
+      "description": "Obstacle movement and interaction",
+      "plans": [
+        {
+          "event": "event_whenflagclicked",
+          "logic": "when green flag clicked\n            go to x: 240 y: -100\n            forever\n              glide 2 seconds to x: -240 y: -100\n              if <(x position) < -235> then\n                set x to 240\n              end\n              if <touching [Cat v]?> then\n                broadcast [Game Over v]\n              end\n            end",
+          "motion": [
+            "motion_gotoxy",
+            "motion_glidesecstoxy",
+            "motion_xposition",
+            "motion_setx"
+          ],
+          "control": [
+            "control_forever",
+            "control_if"
+          ],
+          "operator": [
+            "operator_lt"
+          ],
+          "sensing": [
+            "sensing_touchingobject"
+          ],
+          "looks": [],
+          "sounds": [],
+          "events": [
+            "event_broadcast"
+          ],
+          "data": []
+        }
+      ]
+    }
+  },
+  "improvement_plan": {},
+  "needs_improvement": false,
+  "plan_validation_feedback": "Max iterations reached, stopping further improvements.",
+  "iteration_count": 0,
+  "review_block_feedback": {},
+  "declaration_plan": {
+    "declaration_plan": {
+      "variables": [
+        {
+          "name": "score",
+          "default": 0,
+          "cloud": false
+        },
+        {
+          "name": "☁ High Score",
+          "default": 0,
+          "cloud": true
+        },
+        {
+          "name": "speed",
+          "default": 0,
+          "cloud": false
+        },
+        {
+          "name": "lives",
+          "default": 3,
+          "cloud": false
+        },
+        {
+          "name": "level",
+          "default": 1,
+          "cloud": false
+        }
+      ],
+      "lists": [
+        {
+          "name": "recent_scores",
+          "default": []
+        },
+        {
+          "name": "obstacle_sizes",
+          "default": []
+        },
+        {
+          "name": "obstacle_speeds",
+          "default": []
+        }
+      ],
+      "broadcasts": [
+        "Game Over",
+        "Game Start",
+        "Level Up",
+        "Reset Game"
+      ],
+      "monitors": [
+        {
+          "target": "Stage",
+          "variable": "score",
+          "visible": true,
+          "opcode_hint": "data_variable"
+        },
+        {
+          "target": "Stage",
+          "variable": "☁ High Score",
+          "visible": true,
+          "opcode_hint": "data_variable"
+        },
+        {
+          "target": "Stage",
+          "variable": "lives",
+          "visible": true,
+          "opcode_hint": "data_variable"
+        },
+        {
+          "target": "Stage",
+          "reporter_name": "costume #",
+          "visible": false,
+          "opcode_hint": "looks_costumenumbername",
+          "param_name": "NUMBER_NAME"
+        },
+        {
+          "target": "Stage",
+          "reporter_name": "backdrop #",
+          "visible": false,
+          "opcode_hint": "looks_backdropnumbername",
+          "param_name": "NUMBER_NAME"
+        }
+      ]
+    }
+  },
+  "temporary_node": {}
+}

v2/scratch_agent/errors_node.txt

@@ -0,0 +1,531 @@
+#helper function to identify the shape of block utilized by the block verifier
+def get_block_type(opcode: str) -> str:
+    """Determines the general type of a Scratch block based on its opcode."""
+    if not opcode:
+        return "unknown"
+    if opcode.startswith("event_when") or opcode == "control_start_as_clone":
+        return "hat"
+    elif opcode.startswith("control_") and ("if" in opcode or "repeat" in opcode or "forever" in opcode):
+        return "c_block"
+    elif opcode in ["operator_equals", "operator_gt", "operator_lt", "operator_and", "operator_or", "operator_not"] or \
+         (opcode.startswith("sensing_") and ("mousedown" in opcode or "keypressed" in opcode or "touching" in opcode)):
+        return "boolean"
+    elif opcode.endswith("menu"): # For dropdown shadow blocks, treat as reporter for type checking
+        return "reporter"
+    elif any(s in opcode for s in ["position", "direction", "size", "volume", "costume", "backdrop", "random", "add", "subtract", "multiply", "divide", "length", "item", "of"]):
+        # A more comprehensive check for reporters
+        return "reporter"
+    elif "stop_all" in opcode or "delete_this_clone" in opcode or "procedures_definition" in opcode:
+        return "cap"
+    # Default to stack for most command blocks if not explicitly defined
+    return ALL_SCRATCH_BLOCKS_CATALOG.get(opcode, {}).get("blockType", "stack")
+
+def filter_script_blocks(all_blocks: dict, hat_block_id: str) -> dict:
+    """
+    Filters and returns only the blocks that are part of a specific script
+    starting from the given hat_block_id, including connected reporters/shadows.
+    """
+    script_blocks = {}
+    q = [hat_block_id]
+    visited = set()
+
+    while q:
+        current_block_id = q.pop(0)
+        if current_block_id in visited:
+            continue
+        visited.add(current_block_id)
+
+        block_data = all_blocks.get(current_block_id)
+        if not block_data:
+            continue
+
+        script_blocks[current_block_id] = block_data
+
+        # Add next block in sequence (only for stack/c-blocks)
+        if get_block_type(block_data.get("opcode")) in ["stack", "c_block", "hat"]: # Hat blocks have next too!
+            next_id = block_data.get("next")
+            if next_id and next_id in all_blocks:
+                q.append(next_id)
+
+        # Add blocks connected via inputs (e.g., reporters, shadow blocks, substacks)
+        if "inputs" in block_data:
+            for input_name, input_value in block_data["inputs"].items():
+                if isinstance(input_value, list) and len(input_value) >= 2:
+                    value_or_block_id = input_value[1]
+                    if isinstance(value_or_block_id, str) and value_or_block_id in all_blocks:
+                        q.append(value_or_block_id)
+                    # For type code 3 (reporter with default value), the third element might be a connected block
+                    if len(input_value) >= 3 and isinstance(input_value[2], str) and input_value[2] in all_blocks:
+                        q.append(input_value[2])
+
+        # For C-blocks, add blocks in substacks (if present)
+        if get_block_type(block_data.get("opcode")) == "c_block":
+            for input_key, input_val in block_data.get("inputs", {}).items():
+                # Check for substack inputs (type code 2, typically starts with SUBSTACK)
+                if isinstance(input_val, list) and len(input_val) >= 2 and input_val[0] == 2 and isinstance(input_val[1], str) and input_val[1] in all_blocks:
+                    q.append(input_val[1])
+    return script_blocks
+
+
+def analyze_script_structure(
+    script_blocks: dict,
+    hat_block_id: str,
+    sprite_name: str,
+    sprite_variables: dict,
+    sprite_lists: dict,
+    sprite_broadcasts: dict,
+    sprite_custom_blocks: dict # proccode -> block_id mapping
+) -> list:
+    """
+    Analyzes the structure of a single Scratch script for common errors.
+    Returns a list of issue strings.
+    """
+    issues = []
+
+    # 1. Validate the hat block
+    hat_block = script_blocks.get(hat_block_id)
+    if not hat_block:
+        issues.append(f"Script for sprite '{sprite_name}' (hat ID: {hat_block_id}) has no hat block data.")
+        return issues # Cannot proceed without a hat block
+
+    if not hat_block.get("topLevel") or hat_block.get("parent") is not None:
+        issues.append(f"Hat block '{hat_block_id}' for sprite '{sprite_name}' is not marked as topLevel or has a parent, which is incorrect for a script start.")
+
+    # Hat blocks can and do have a 'next' connection to the first block in their script.
+    # The previous check was a false positive. Removed the explicit "should not have next" check for hat blocks.
+
+    # 2. Check all blocks within the script
+    for block_id, block_data in script_blocks.items():
+        opcode = block_data.get("opcode")
+        if not opcode:
+            issues.append(f"Block '{block_id}' for sprite '{sprite_name}' is missing an opcode.")
+            continue
+
+        # Check if opcode exists in the catalog
+        if opcode not in ALL_SCRATCH_BLOCKS_CATALOG:
+            issues.append(f"Block '{block_id}' for sprite '{sprite_name}' has unknown opcode '{opcode}'. Recommendation: Verify against Scratch 3.0 block reference.")
+
+        # Parent-Child and Next-Previous Linkage
+        parent_id = block_data.get("parent")
+        next_id = block_data.get("next")
+        current_block_type = get_block_type(opcode)
+
+        if parent_id:
+            parent_block = script_blocks.get(parent_id)
+            if not parent_block:
+                issues.append(f"Block '{block_id}' (opcode: {opcode}) for sprite '{sprite_name}' references non-existent parent '{parent_id}'.")
+            else:
+                # Validate the parent-child connection type based on block types
+                parent_block_type = get_block_type(parent_block.get("opcode"))
+
+                if parent_block_type in ["stack", "hat", "c_block"]:
+                    # If parent is a stack/hat/C-block, this block should be its 'next' or an input/substack
+                    if parent_block.get("next") == block_id:
+                        # Correct sequential connection
+                        pass
+                    else:
+                        found_as_input = False
+                        for input_name, input_value in parent_block.get("inputs", {}).items():
+                            if isinstance(input_value, list) and len(input_value) >= 2 and input_value[1] == block_id:
+                                found_as_input = True
+                                break
+                        if not found_as_input:
+                            issues.append(f"Block '{block_id}' (opcode: {opcode}) has parent '{parent_id}' but is not a sequential 'next' block nor connected via an input slot. Potential broken linkage.")
+                elif parent_block_type in ["reporter", "boolean"]:
+                    # If parent is a reporter/boolean, this block must be its child (e.g., a shadow block or another reporter)
+                    # and connected via an input.
+                    found_as_input = False
+                    for input_name, input_value in parent_block.get("inputs", {}).items():
+                        if isinstance(input_value, list) and len(input_value) >= 2 and input_value[1] == block_id:
+                            found_as_input = True
+                            break
+                    if not found_as_input:
+                         issues.append(f"Block '{block_id}' (opcode: {opcode}) has reporter/boolean parent '{parent_id}' but is not linked via an input. Potential broken linkage.")
+                else:
+                    issues.append(f"Block '{block_id}' (opcode: {opcode}) has an unexpected parent block type '{parent_block_type}' for parent '{parent_id}'.")
+        
+        # Check next linkage: only cap blocks should not have a next. Shadow blocks also shouldn't have next.
+        if next_id:
+            next_block = script_blocks.get(next_id)
+            if not next_block:
+                issues.append(f"Block '{block_id}' (opcode: {opcode}) for sprite '{sprite_name}' references non-existent next block '{next_id}'.")
+            elif next_block.get("parent") != block_id:
+                issues.append(f"Block '{block_id}' (opcode: {opcode})'s next block '{next_id}' does not link back to it via 'parent'.")
+            
+            # Cap blocks should not have 'next'
+            if current_block_type == "cap":
+                issues.append(f"Cap block '{block_id}' (opcode: {opcode}) for sprite '{sprite_name}' should not have a 'next' connection as it ends a script.")
+            # Shadow blocks should not have 'next'
+            if block_data.get("shadow"):
+                 issues.append(f"Shadow block '{block_id}' (opcode: {opcode}) for sprite '{sprite_name}' should not have a 'next' connection.")
+
+        # Input validation
+        if "inputs" in block_data:
+            for input_name, input_value in block_data["inputs"].items():
+                if not isinstance(input_value, list) or len(input_value) < 2:
+                    issues.append(f"Block '{block_id}' (opcode: {opcode}) for sprite '{sprite_name}' has malformed input '{input_name}': {input_value}.")
+                    continue
+
+                type_code = input_value[0]
+                value_or_block_id = input_value[1]
+                
+                # Check type code validity
+                if type_code not in [1, 2, 3]:
+                    issues.append(f"Block '{block_id}' (opcode: {opcode}) input '{input_name}' has invalid type code: {type_code}. Expected 1, 2, or 3.")
+
+                if isinstance(value_or_block_id, str):
+                    # It's a block ID, check if it exists and its parent link is correct
+                    connected_block = script_blocks.get(value_or_block_id)
+                    if not connected_block:
+                        issues.append(f"Block '{block_id}' (opcode: {opcode}) input '{input_name}' references non-existent block ID '{value_or_block_id}'.")
+                    elif connected_block.get("parent") != block_id:
+                        issues.append(f"Block '{block_id}' (opcode: {opcode}) input '{input_name}' connects to '{value_or_block_id}', but '{value_or_block_id}'s parent is not '{block_id}'.")
+                    
+                    connected_block_type = get_block_type(connected_block.get("opcode"))
+
+                    # Refined type code consistency checks
+                    if type_code == 2: # Block ID (substack or reporter/boolean plugged in, without shadow)
+                        if input_name.startswith("SUBSTACK"):
+                            if connected_block_type != "stack":
+                                issues.append(f"Block '{block_id}' (opcode: {opcode}) input '{input_name}' (type 2, SUBSTACK) expects a stack block, but connected block '{value_or_block_id}' is of type '{connected_block_type}'.")
+                        elif connected_block_type not in ["reporter", "boolean"]:
+                             issues.append(f"Block '{block_id}' (opcode: {opcode}) input '{input_name}' (type 2, non-SUBSTACK) expects a reporter/boolean, but connected block '{value_or_block_id}' is of type '{connected_block_type}'.")
+                    elif type_code == 1: # Literal value or shadow block ID (possibly with an attached block)
+                        if isinstance(value_or_block_id, str) and connected_block_type not in ["reporter", "boolean"] and not connected_block.get("shadow"):
+                             issues.append(f"Block '{block_id}' (opcode: {opcode}) input '{input_name}' (type 1) expects a literal or reporter/boolean/shadow, but connected block '{value_or_block_id}' is of type '{connected_block_type}' and not a shadow.")
+                    elif type_code == 3: # Shadow block ID with default value, possibly with attached block
+                         if isinstance(value_or_block_id, str) and not connected_block.get("shadow"):
+                            issues.append(f"Block '{block_id}' (opcode: {opcode}) input '{input_name}' (type 3) expects a shadow block, but connected block '{value_or_block_id}' is not a shadow.")
+
+
+                # Specific checks for C-blocks' SUBSTACK
+                if get_block_type(opcode) == "c_block" and input_name.startswith("SUBSTACK"):
+                    # For a C-block, SUBSTACK input must have type code 2 and link to a valid block ID
+                    if not (isinstance(value_or_block_id, str) and script_blocks.get(value_or_block_id) and type_code == 2):
+                        issues.append(f"C-block '{block_id}' (opcode: {opcode}) for sprite '{sprite_name}' has an invalid or missing SUBSTACK input configuration.")
+
+        # Shadow block specific checks
+        if block_data.get("shadow"):
+            if block_data.get("topLevel"):
+                issues.append(f"Shadow block '{block_id}' (opcode: {opcode}) for sprite '{sprite_name}' is incorrectly marked as topLevel.")
+            if not block_data.get("parent"):
+                issues.append(f"Shadow block '{block_id}' (opcode: {opcode}) for sprite '{sprite_name}' is missing a parent.")
+            if block_data.get("next"): # Shadow blocks should never have 'next'
+                issues.append(f"Shadow block '{block_id}' (opcode: {opcode}) for sprite '{sprite_name}' should not have a 'next' connection.")
+            
+            # Enhanced field validation for specific shadow block opcodes
+            if opcode == "math_number":
+                num_field = block_data.get("fields", {}).get("NUM")
+                if not (isinstance(num_field, list) and len(num_field) >= 1 and isinstance(num_field[0], (str, int, float))):
+                    issues.append(f"Math_number shadow block '{block_id}' has malformed 'NUM' field: {num_field}. Expected [value, ID_or_null].")
+            elif opcode == "event_broadcast_menu":
+                broadcast_field = block_data.get("fields", {}).get("BROADCAST_OPTION") # Standard field name for broadcast menu
+                if not (isinstance(broadcast_field, list) and len(broadcast_field) >= 1 and isinstance(broadcast_field[0], str) and broadcast_field[0]): # Ensure broadcast name is a non-empty string
+                    issues.append(f"Broadcast menu shadow block '{block_id}' has malformed or empty 'BROADCAST_OPTION' field: {broadcast_field}. Expected ['message name', 'ID_or_null'].")
+                if broadcast_field and len(broadcast_field) > 1 and broadcast_field[1] is None:
+                    # This indicates a 'default option' is null, which is often a problem if it's meant to be a pre-defined ID.
+                    # Flag this as a potential issue, indicating a missing default option.
+                    issues.append(f"Broadcast menu shadow block '{block_id}' has a 'BROADCAST_OPTION' field with a null default ID: {broadcast_field}. This might indicate a missing pre-defined broadcast ID.")
+            elif opcode == "sensing_touchingobjectmenu":
+                touching_field = block_data.get("fields", {}).get("TOUCHINGOBJECTMENU")
+                if not (isinstance(touching_field, list) and len(touching_field) >= 1 and isinstance(touching_field[0], str) and touching_field[0]):
+                    issues.append(f"Touching object menu shadow block '{block_id}' has malformed or empty 'TOUCHINGOBJECTMENU' field: {touching_field}. Expected ['object name', 'ID_or_null'].")
+                if touching_field and len(touching_field) > 1 and touching_field[1] is None:
+                    issues.append(f"Touching object menu shadow block '{block_id}' has a 'TOUCHINGOBJECTMENU' field with a null default ID: {touching_field}. This might indicate a missing pre-defined object ID for 'edge', 'mouse-pointer', or a sprite.")
+            # Add more specific checks for other menu-type shadow blocks if needed
+
+        # Validate references to variables, lists, and broadcasts
+        if "fields" in block_data:
+            # Variable references (data_setvariableto, data_changevariableby, data_variable)
+            if opcode in ["data_setvariableto", "data_changevariableby", "data_variable"]:
+                var_name_field = block_data["fields"].get("VARIABLE")
+                if var_name_field and isinstance(var_name_field, list) and len(var_name_field) >= 1 and isinstance(var_name_field[0], str):
+                    var_name = var_name_field[0]
+                    if var_name not in sprite_variables:
+                        issues.append(f"Block '{block_id}' (opcode: {opcode}) references non-existent variable '{var_name}'. Recommendation: Ensure '{var_name}' is defined.")
+                else:
+                    issues.append(f"Block '{block_id}' (opcode: {opcode}) has malformed 'VARIABLE' field: {var_name_field}.")
+
+            # List references (data_addtolist, data_deleteoflist, data_itemoflist, data_listcontents)
+            if opcode in ["data_addtolist", "data_deleteoflist", "data_itemoflist", "data_listcontents"]:
+                list_name_field = block_data["fields"].get("LIST")
+                if list_name_field and isinstance(list_name_field, list) and len(list_name_field) >= 1 and isinstance(list_name_field[0], str):
+                    list_name = list_name_field[0]
+                    if list_name not in sprite_lists:
+                        issues.append(f"Block '{block_id}' (opcode: {opcode}) references non-existent list '{list_name}'. Recommendation: Ensure '{list_name}' is defined.")
+                else:
+                    issues.append(f"Block '{block_id}' (opcode: {opcode}) has malformed 'LIST' field: {list_name_field}.")
+
+            # Broadcast references in 'when I receive' hat blocks
+            if opcode == "event_whenbroadcastreceived":
+                broadcast_name_field = block_data["fields"].get("BROADCAST_OPTION")
+                if broadcast_name_field and isinstance(broadcast_name_field, list) and len(broadcast_name_field) >= 1 and isinstance(broadcast_name_field[0], str):
+                    broadcast_name = broadcast_name_field[0]
+                    if broadcast_name not in sprite_broadcasts:
+                        issues.append(f"Hat block '{block_id}' (opcode: {opcode}) listens for non-existent broadcast message '{broadcast_name}'. Recommendation: Ensure '{broadcast_name}' is broadcast elsewhere.")
+                else:
+                    issues.append(f"Hat block '{block_id}' (opcode: {opcode}) has malformed 'BROADCAST_OPTION' field: {broadcast_name_field}.")
+
+        # Custom block call validation
+        if opcode == "procedures_call" and "mutation" in block_data:
+            proccode = block_data["mutation"].get("proccode")
+            if proccode and proccode not in sprite_custom_blocks:
+                issues.append(f"Custom block call '{block_id}' (proccode: {proccode}) references non-existent custom block definition. Recommendation: Define custom block '{proccode}'.")
+            if not proccode:
+                issues.append(f"Custom block call '{block_id}' is missing 'proccode' in its mutation.")
+
+        # Check for event_broadcast blocks having empty message (via malformed shadow)
+        if opcode == "event_broadcast" or opcode == "event_broadcastandwait":
+            broadcast_input = block_data.get("inputs", {}).get("BROADCAST_INPUT")
+            if broadcast_input and isinstance(broadcast_input, list) and len(broadcast_input) >= 2:
+                # If connected to a shadow block
+                if isinstance(broadcast_input[1], str) and script_blocks.get(broadcast_input[1]) and script_blocks[broadcast_input[1]].get("shadow"):
+                    shadow_block = script_blocks[broadcast_input[1]]
+                    if shadow_block.get("opcode") == "event_broadcast_menu":
+                        broadcast_field = shadow_block.get("fields", {}).get("BROADCAST_OPTION")
+                        if not (broadcast_field and isinstance(broadcast_field, list) and len(broadcast_field) >= 1 and isinstance(broadcast_field[0], str) and broadcast_field[0].strip()):
+                            issues.append(f"Broadcast block '{block_id}' uses a shadow block '{shadow_block.get('id', 'unknown')}' that has an empty or malformed broadcast message. Recommendation: Ensure the broadcast message is a non-empty string.")
+                # If connected to a literal string (less common for broadcast but possible)
+                elif isinstance(broadcast_input[1], list) and len(broadcast_input[1]) >= 2 and isinstance(broadcast_input[1][1], str) and not broadcast_input[1][1].strip():
+                    issues.append(f"Broadcast block '{block_id}' has an empty literal broadcast message. Recommendation: Provide a non-empty message.")
+            else:
+                issues.append(f"Broadcast block '{block_id}' has a missing or malformed 'BROADCAST_INPUT'. Recommendation: Ensure a valid message or shadow block is connected.")
+
+    return issues
+
+# Node 5: Verification Node
+def block_verification_node(state: dict) -> dict:
+    """
+    The block verifier check for any improvements needed through logical if-else
+    and then adds them to the improvement_plan.
+    After the improvement plan, the LLM reviewer node also checks for other
+    errors or issues, if any, and finally provides the review as feedback.
+
+    Args:
+        state (dict): The current state dictionary containing project_json, etc.
+
+    Returns:
+        dict: The updated state dictionary with verification feedback.
+    """
+    logger.info(f"--- Running BlockVerificationNode (Iteration: {state.get('iteration_count', 0)}) ---")
+
+    # Increased MAX_IMPROVEMENT_ITERATIONS to allow for more verification and improvement cycles.
+    # Set to 5 to allow multiple detection-improvement loops.
+    MAX_IMPROVEMENT_ITERATIONS = 3
+    current_iteration = state.get("iteration_count", 0)
+    project_json = state["project_json"]
+    targets = project_json["targets"]
+
+    # Initialize needs_improvement for the current run
+    state["needs_improvement"] = False
+    block_validation_feedback_overall = []
+
+    improvement_plan = {"sprite_issues": {}}
+    state["improvement_plan"] = improvement_plan # Ensure it's in state even if empty
+
+    for target in targets:
+        sprite_name = target["name"]
+        all_blocks_for_sprite = target.get("blocks", {})
+
+        # Correctly extract variables (name -> ID mapping)
+        sprite_variables = {var_data[0]: var_id for var_id, var_data in target.get("variables", {}).items()}
+        # Correctly extract lists (name -> ID mapping)
+        sprite_lists = {list_data[0]: list_id for list_id, list_data in target.get("lists", {}).items()}
+
+        # Broadcasts are typically collected from the 'event_whenbroadcastreceived' blocks
+        # and potentially from the 'event_broadcast_menu' shadow blocks.
+        sprite_broadcasts = set()
+        for block_id, block_data in all_blocks_for_sprite.items():
+            if block_data.get("opcode") == "event_whenbroadcastreceived" and "BROADCAST_OPTION" in block_data.get("fields", {}):
+                broadcast_name_field = block_data["fields"]["BROADCAST_OPTION"]
+                if isinstance(broadcast_name_field, list) and len(broadcast_name_field) >= 1 and isinstance(broadcast_name_field[0], str):
+                    sprite_broadcasts.add(broadcast_name_field[0])
+            elif block_data.get("opcode") == "event_broadcast_menu" and "BROADCAST_OPTION" in block_data.get("fields", {}) and block_data.get("shadow"):
+                broadcast_name_field = block_data["fields"]["BROADCAST_OPTION"]
+                if isinstance(broadcast_name_field, list) and len(broadcast_name_field) >= 1 and isinstance(broadcast_name_field[0], str):
+                    sprite_broadcasts.add(broadcast_name_field[0])
+
+        # Extract custom block definitions (proccodes)
+        sprite_custom_blocks = {}
+        for block_id, block_data in all_blocks_for_sprite.items():
+            if block_data.get("opcode") == "procedures_definition" and "mutation" in block_data:
+                proccode = block_data["mutation"].get("proccode")
+                if proccode:
+                    sprite_custom_blocks[proccode] = block_id
+
+        if not all_blocks_for_sprite:
+            logger.info(f"Sprite '{sprite_name}' has no blocks. Skipping verification.")
+            continue
+
+        sprite_issues = []
+        hat_block_ids = [
+            block_id for block_id, block_data in all_blocks_for_sprite.items()
+            if block_data.get("topLevel") and get_block_type(block_data.get("opcode")) == "hat"
+        ]
+
+        processed_script_blocks = set()
+
+        if not hat_block_ids:
+            sprite_issues.append("No top-level hat blocks found for this sprite. Scripts may not run automatically.")
+
+        for hat_id in hat_block_ids:
+            logger.info(f"Verifying script starting with hat block '{hat_id}' for sprite '{sprite_name}'.")
+
+            current_script_blocks = filter_script_blocks(all_blocks_for_sprite, hat_id)
+            processed_script_blocks.update(current_script_blocks.keys())
+
+            script_issues = analyze_script_structure(
+                current_script_blocks,
+                hat_id,
+                sprite_name,
+                sprite_variables,
+                sprite_lists,
+                sprite_broadcasts,
+                sprite_custom_blocks
+            )
+            if script_issues:
+                sprite_issues.append(f"Issues in script starting with '{hat_id}':")
+                sprite_issues.extend([f" - {issue}" for issue in script_issues])
+            else:
+                logger.info(f"Script starting with '{hat_id}' for sprite '{sprite_name}' passed basic verification.")
+
+        # Identify truly orphaned blocks (not top-level, not part of any script, no parent, not shadow)
+        orphaned_blocks_overall = {
+            block_id for block_id in all_blocks_for_sprite.keys()
+            if block_id not in processed_script_blocks
+            and not all_blocks_for_sprite[block_id].get("topLevel")
+            and not all_blocks_for_sprite[block_id].get("parent")
+            and not all_blocks_for_sprite[block_id].get("shadow")
+        }
+
+        if orphaned_blocks_overall:
+            sprite_issues.append(f"Found {len(orphaned_blocks_overall)} truly orphaned blocks not connected to any valid script: {', '.join(list(orphaned_blocks_overall)[:5])}{'...' if len(orphaned_blocks_overall) > 5 else ''}.")
+            # Also check for top-level blocks that are not hat blocks and are not processed
+            for block_id in all_blocks_for_sprite.keys():
+                block_data = all_blocks_for_sprite[block_id]
+                if block_data.get("topLevel") and get_block_type(block_data.get("opcode")) != "hat" and block_id not in processed_script_blocks:
+                    sprite_issues.append(f"Top-level block '{block_id}' (opcode: {block_data.get('opcode')}) is not a hat block and is not part of any script, so it will not run automatically.")
+
+
+        if sprite_issues:
+            improvement_plan["sprite_issues"][sprite_name] = sprite_issues
+            logger.warning(f"Verification found issues for sprite '{sprite_name}'.")
+            block_validation_feedback_overall.append(f"Issues for {sprite_name}:\n" + "\n".join([f"- {issue}" for issue in sprite_issues]))
+            state["needs_improvement"] = True
+            print(f"\n--- Verification Report (Issues Found for {sprite_name}) ---")
+            print(json.dumps({sprite_name: sprite_issues}, indent=2))
+        else:
+            logger.info(f"Sprite '{sprite_name}' passed all verification checks.")
+
+    # Consolidate feedback for the LLM
+    state["block_validation_feedback"] = "\n\n".join(block_validation_feedback_overall)
+
+    print(f"[OVERALL IMPROVEMENT PLAN ON ITERATION {current_iteration}]: {improvement_plan}")
+
+    if state["needs_improvement"]:
+        llm_reviewer_prompt = f"""You are an expert Scratch project reviewer. Your task is to analyze the provided \
+        structural issues found in a Scratch project's sprites and suggest improvements or \
+        further insights. Focus on clarity, accuracy, and actionable advice.
+
+        Here are the detected structural issues:
+        {json.dumps(improvement_plan['sprite_issues'], indent=2)}
+
+        Here are the block validation feedback:
+        {json.dumps(state["block_validation_feedback"], indent=2)}
+        
+
+
+        Please review these issues and provide a consolidated report with potential causes \
+        and recommendations for fixing them. If an issue is minor or expected in certain \
+        scenarios (e.g., hidden blocks for backward compatibility), please note that.
+        Structure your response as a JSON object with 'review_summary' as the key, \
+        containing a dictionary where keys are sprite names and values are lists of suggested improvements.
+        Example:
+        ```json
+        {{
+            "review_summary": {{
+            "Sprite1": [
+                "Issue: Hat block 'abc' is not topLevel. Recommendation: Ensure all scripts start with a top-level hat block that has no parent.",
+                "Issue: Block 'xyz' has unknown opcode 'motion_nonexistent'. Recommendation: Verify the opcode against the Scratch 3.0 block reference. This might be a typo or a deprecated block.",
+                "Issue: Block 'var_block_id' references non-existent variable 'myVariable'. Recommendation: Ensure all variables used in blocks are defined in the sprite's variable list."
+            ],
+            "Sprite2": [
+                "Issue: Found 3 orphaned blocks. Recommendation: Reconnect these blocks to existing scripts or remove them if no longer needed."
+            ]
+            }}
+        }}
+        ```
+        """
+        try:
+            response = agent.invoke({"messages": [{"role": "user", "content": llm_reviewer_prompt}]})
+            raw_review_response = response["messages"][-1].content
+            try:
+                state["review_block_feedback"] = extract_json_from_llm_response(raw_review_response)
+            except json.JSONDecodeError as error_json:
+                logger.error("Failed to extract JSON from LLM response. Attempting to correct the response.")
+                # Use the JSON resolver agent to fix the response
+                correction_prompt = (
+                    "Your task is to correct the provided JSON string to ensure it is **syntactically perfect and adheres strictly to JSON rules**.\n"
+                    "Carefully review the JSON for any errors, especially focusing on the reported error at:\n"
+                    f"- **Error Details**: {error_json}\n\n"
+                    "**Strict Instructions for your response:**\n"
+                    "1. **ONLY** output the corrected JSON. Do not include any other text, comments, or explanations outside the JSON.\n"
+                    "2. Ensure all property names (keys) are enclosed in **double quotes**.\n"
+                    "3. Ensure string values are correctly enclosed in **double quotes** and any internal special characters (like newlines `\\n`, tabs `\\t`, backslashes `\\\\`, or double quotes `\\`) are properly **escaped**.\n"
+                    "4. Verify that there are **no extra commas**, especially between key-value pairs or after the last element in an object or array.\n"
+                    "5. Ensure proper nesting and matching of curly braces `{}` and square brackets `[]`.\n"
+                    "6. **Crucially, remove any extraneous characters or duplicate closing braces outside the main JSON object.**\n"
+                    "7. The corrected JSON must be a **complete and valid** JSON object.\n\n"
+                    "Here is the problematic JSON string to correct:\n"
+                    "```json\n"
+                    f"{raw_review_response}\n"
+                    "```\n"
+                    "Corrected JSON:\n"
+                )
+                correction_response = agent_json_resolver.invoke({"messages": [{"role": "user", "content": correction_prompt}]})
+                print(f"[JSON CORRECTOR RESPONSE AT BLOCKVERFIER ]: {correction_response["messages"][-1].content}")
+                state["review_block_feedback"] = extract_json_from_llm_response(correction_response["messages"][-1].content)
+
+            logger.info("Agent review feedback added to the state.")
+            print("\n--- Agent Review Feedback ---")
+            print(json.dumps(state["review_block_feedback"], indent=2))
+
+        except Exception as e:
+            logger.error(f"Error invoking agent for review in BlockVerificationNode: {e}")
+            # Fallback for LLM error: populate with a general error message
+            state["review_block_feedback"] = {"review_summary": {"Overall": [f"Error during LLM review: {e}"]}}
+    else:
+        logger.info("BlockVerificationNode completed: No issues found in any sprite blocks.")
+        print("\n--- Verification Report (No Issues Found) ---")
+        state["block_validation_feedback"] = "No issues found in sprite blocks."
+        state["review_block_feedback"] = {"review_summary": {"Overall": ["No issues found in sprite blocks. All good!"]}}
+
+    # Manage iteration count based on overall needs_improvement flag
+    if state["needs_improvement"]:
+        # Increment iteration count *only if* improvements are needed for the next cycle
+        state["iteration_count"] = current_iteration + 1
+        if state["iteration_count"] >= MAX_IMPROVEMENT_ITERATIONS:
+            logger.warning(f"Max improvement iterations ({MAX_IMPROVEMENT_ITERATIONS}) reached for block verification. Forcing 'needs_improvement' to False.")
+            state["needs_improvement"] = False
+            state["block_validation_feedback"] += "\n(Note: Max iterations reached for block verification, stopping further improvements.)"
+
+            # Ensure 'Overall' key exists before attempting to append
+            if "review_summary" not in state["review_block_feedback"]:
+                state["review_block_feedback"]["review_summary"] = {}
+            if "Overall" not in state["review_block_feedback"]["review_summary"]:
+                state["review_block_feedback"]["review_summary"]["Overall"] = []
+
+            state["review_block_feedback"]["review_summary"]["Overall"].append("Max iterations reached for block verification, stopping further improvements based on this run.")
+    else:
+        # Reset if no more improvement needed for blocks, indicating successful verification
+        state["iteration_count"] = 0
+
+    logger.info(f"Block verification completed. Needs Improvement: {state['needs_improvement']}. Feedback: {state['block_validation_feedback'][:100]}...")
+    print("===========================================================================")
+    print(f"[BLOCK VERIFICATION NODE: (improvement_plan)]:{state.get("improvement_plan")}")
+    print(f"[BLOCK VERIFICATION NODE: (review_block_feedback)]:{state.get("review_block_feedback")}")
+
+    with open("debug_state.json", "w", encoding="utf-8") as f:
+        json.dump(state, f, indent=2, ensure_ascii=False)
+
+    return state