Foundation work for one-step debugger in Workflows

docs/workflows/blocks.md

@@ -88,7 +88,6 @@ hide:
 <p class="card block-card" data-url="stability_ai_inpainting" data-name="Stability AI Inpainting" data-desc="Uses segmentation masks to inpaint objects into image" data-labels="MODEL, APACHE-2.0" data-author="dummy"></p>
 <p class="card block-card" data-url="detections_stabilizer" data-name="Detections Stabilizer" data-desc="Apply smoothing algorithm to reduce noise and flickering across video frames" data-labels="TRANSFORMATION, APACHE-2.0" data-author="dummy"></p>
 <p class="card block-card" data-url="stitch_images" data-name="Stitch Images" data-desc="Stitch two images by common parts." data-labels="TRANSFORMATION, APACHE-2.0" data-author="dummy"></p>
-<p class="card block-card" data-url="stitch_ocr_detections" data-name="Stitch OCR Detections" data-desc="Combines OCR detection results into a coherent text string by organizing detections spatially." data-labels="TRANSFORMATION, APACHE-2.0" data-author="dummy"></p>
 <p class="card block-card" data-url="template_matching" data-name="Template Matching" data-desc="Looks for instances of template in specific image" data-labels="CLASSICAL_COMPUTER_VISION, APACHE-2.0" data-author="dummy"></p>
 <p class="card block-card" data-url="timeinzone" data-name="Time in zone" data-desc="Track duration of time spent by objects in zone" data-labels="ANALYTICS, APACHE-2.0" data-author="dummy"></p>
 <p class="card block-card" data-url="triangle_visualization" data-name="Triangle Visualization" data-desc="Draws triangle markers on an image at specific coordinates based on provided detections." data-labels="VISUALIZATION, APACHE-2.0" data-author="dummy"></p>

docs/workflows/blocks_bundling.md

@@ -108,6 +108,65 @@ REGISTERED_INITIALIZERS = {
 }
 ```
 
+## Serializers and deserializers for *Kinds*
+
+Support for custom serializers and deserializers was introduced in Execution Engine `v1.3.0`.
+From that version onward it is possible to point custom functions that 
+Execution Engine should use to serialize and deserialize any *[kind](/workflows/kinds/)*.
+
+Deserializers will determine how to decode inputs send through the wire 
+into internal data representation used by blocks. Serializers, on the other hand, 
+are useful when Workflow results are to be send through the wire.
+
+Below you may find example on how to add serializer and deserializer 
+for arbitrary kind. The code should be placed in main `__init__.py` of
+your plugin:
+
+```python
+from typing import Any
+
+def serialize_kind(value: Any) -> Any:
+  # place here the code that will be used to
+  # transform internal Workflows data representation into 
+  # the external one (that can be sent through the wire in JSON, using
+  # default JSON encoder for Python).
+  pass
+
+
+def deserialize_kind(parameter_name: str, value: Any) -> Any:
+  # place here the code that will be used to decode 
+  # data sent through the wire into the Execution Engine
+  # and transform it into proper internal Workflows data representation
+  # which is understood by the blocks.
+  pass
+
+
+KINDS_SERIALIZERS = {
+    "name_of_the_kind": serialize_kind,
+}
+KINDS_DESERIALIZERS = {
+    "name_of_the_kind": deserialize_kind,
+}
+```
+
+### Tips And Tricks
+
+* Each serializer must be a function taking the value to serialize
+and returning serialized value (accepted by default Python JSON encoder)
+
+* Each deserializer must be a function accepting two parameters - name of 
+Workflow input to be deserialized and the value to be deserialized - the goal 
+of the function is to align input data with expected internal representation
+
+* *Kinds* from `roboflow_core` plugin already have reasonable serializers and 
+deserializers
+
+* If you do not like the way how data is serialized in `roboflow_core` plugin, 
+feel free to alter the serialization methods for *kinds*, simply registering
+the function in your plugin and loading it to the Execution Engine - the 
+serializer/deserializer defined as the last one will be in use. 
+
+
 ## Enabling plugin in your Workflows ecosystem
 
 To load a plugin you must: