oagi-core 0.10.1__tar.gz → 0.10.3__tar.gz

{oagi_core-0.10.1 → oagi_core-0.10.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: oagi-core
-Version: 0.10.1
+Version: 0.10.3
 Summary: Official API of OpenAGI Foundation
 Project-URL: Homepage, https://github.com/agiopen-org/oagi
 Author-email: OpenAGI Foundation <contact@agiopen.org>

{oagi_core-0.10.1 → oagi_core-0.10.3}/metapackage/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "oagi"
-version = "0.10.1"
+version = "0.10.3"
 description = "Official API of OpenAGI Foundation (metapackage with all features)"
 readme = "README.md"
 license = "MIT"
@@ -16,7 +16,7 @@ authors = [
 requires-python = ">= 3.10"
 
 dependencies = [
-    "oagi-core[desktop,server]==0.10.1",
+    "oagi-core[desktop,server]==0.10.3",
 ]
 
 [project.urls]

{oagi_core-0.10.1 → oagi_core-0.10.3}/metapackage/uv.lock

@@ -397,33 +397,34 @@ sdist = { url = "https://files.pythonhosted.org/packages/28/fa/b2ba8229b9381e8f6
 
 [[package]]
 name = "oagi"
-version = "0.10.1"
+version = "0.10.3"
 source = { editable = "." }
 dependencies = [
     { name = "oagi-core", extra = ["desktop", "server"] },
 ]
 
 [package.metadata]
-requires-dist = [{ name = "oagi-core", extras = ["desktop", "server"], specifier = "==0.10.0" }]
+requires-dist = [{ name = "oagi-core", extras = ["desktop", "server"], specifier = "==0.10.2" }]
 
 [[package]]
 name = "oagi-core"
-version = "0.10.0"
+version = "0.10.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
     { name = "pydantic" },
     { name = "rich" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/2d/3f/6fa48d2d207051d5f3a8eedf8f7d9cd97f7463746f6578b6655511a4cf47/oagi_core-0.10.0.tar.gz", hash = "sha256:d50c6dac28eb4d395e6910bd24cf412845ffbad25c1be7a2a6a04511691470e9", size = 259893, upload-time = "2025-11-24T04:15:08.503Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/07/2f/11b7e37049b2faa1e1147a75624c024a93c32287f243c213ca96fc096452/oagi_core-0.10.2.tar.gz", hash = "sha256:2d7fb47031cdc2155ea5ea9c06b4b58c0d70091de95a36fa4dedf5d710a09862", size = 267130, upload-time = "2025-11-26T13:50:36.977Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/44/9f/582af4d42c1074fe647a3fdbdaddb0bd7b4402ac85e42ea9dcfdf7b52528/oagi_core-0.10.0-py3-none-any.whl", hash = "sha256:f7e19c744586dfb22cfcef0ddc031a457ad4605e6441198cdc6bc4f27bebbb1a", size = 83329, upload-time = "2025-11-24T04:15:07.201Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/c8/a1d95327afe6237eaf474d74ba66461e51baaf5948d458cb12be62dbf8a8/oagi_core-0.10.2-py3-none-any.whl", hash = "sha256:3b9dd3ade24a1c605d671ed7f35efcd00f729be603a63173c7f92f8177d56750", size = 87220, upload-time = "2025-11-26T13:50:35.872Z" },
 ]
 
 [package.optional-dependencies]
 desktop = [
     { name = "pillow" },
     { name = "pyautogui" },
+    { name = "pyobjc-framework-applicationservices", marker = "sys_platform == 'darwin'" },
     { name = "pyobjc-framework-quartz", marker = "sys_platform == 'darwin'" },
 ]
 server = [
@@ -741,6 +742,27 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/62/50/dc076965c96c7f0de25c0a32b7f8aa98133ed244deaeeacfc758783f1f30/pyobjc_core-12.1-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:453b191df1a4b80e756445b935491b974714456ae2cbae816840bd96f86db882", size = 712204, upload-time = "2025-11-14T09:35:24.148Z" },
 ]
 
+[[package]]
+name = "pyobjc-framework-applicationservices"
+version = "12.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pyobjc-core" },
+    { name = "pyobjc-framework-cocoa" },
+    { name = "pyobjc-framework-coretext" },
+    { name = "pyobjc-framework-quartz" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/be/6a/d4e613c8e926a5744fc47a9e9fea08384a510dc4f27d844f7ad7a2d793bd/pyobjc_framework_applicationservices-12.1.tar.gz", hash = "sha256:c06abb74f119bc27aeb41bf1aef8102c0ae1288aec1ac8665ea186a067a8945b", size = 103247, upload-time = "2025-11-14T10:08:52.18Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/52/9d/3cf36e7b08832e71f5d48ddfa1047865cf2dfc53df8c0f2a82843ea9507a/pyobjc_framework_applicationservices-12.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:c4fd1b008757182b9e2603a63c6ffa930cc412fab47294ec64260ab3f8ec695d", size = 32791, upload-time = "2025-11-14T09:36:05.576Z" },
+    { url = "https://files.pythonhosted.org/packages/17/86/d07eff705ff909a0ffa96d14fc14026e9fc9dd716233648c53dfd5056b8e/pyobjc_framework_applicationservices-12.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:bdddd492eeac6d14ff2f5bd342aba29e30dffa72a2d358c08444da22129890e2", size = 32784, upload-time = "2025-11-14T09:36:08.755Z" },
+    { url = "https://files.pythonhosted.org/packages/37/a7/55fa88def5c02732c4b747606ff1cbce6e1f890734bbd00f5596b21eaa02/pyobjc_framework_applicationservices-12.1-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:c8f6e2fb3b3e9214ab4864ef04eee18f592b46a986c86ea0113448b310520532", size = 32835, upload-time = "2025-11-14T09:36:11.855Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/21/79e42ee836f1010f5fe9e97d2817a006736bd287c15a3674c399190a2e77/pyobjc_framework_applicationservices-12.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:bd1f4dbb38234a24ae6819f5e22485cf7dd3dd4074ff3bf9a9fdb4c01a3b4a38", size = 32859, upload-time = "2025-11-14T09:36:15.208Z" },
+    { url = "https://files.pythonhosted.org/packages/66/3a/0f1d4dcf2345e875e5ea9761d5a70969e241d24089133d21f008dde596f5/pyobjc_framework_applicationservices-12.1-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:8a5d2845249b6a85ba9e320a9848468c3f8cd6f59605a9a43f406a7810eaa830", size = 33115, upload-time = "2025-11-14T09:36:18.384Z" },
+    { url = "https://files.pythonhosted.org/packages/40/44/3196b40fec68b4413c92875311f17ccf4c3ff7d2e53676f8fc18ad29bd18/pyobjc_framework_applicationservices-12.1-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:f43c9a24ad97a9121276d4d571aa04a924282c80d7291cfb3b29839c3e2013a8", size = 32997, upload-time = "2025-11-14T09:36:21.58Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/bb/dab21d2210d3ef7dd0616df7e8ea89b5d8d62444133a25f76e649a947168/pyobjc_framework_applicationservices-12.1-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:1f72e20009a4ebfd5ed5b23dc11c1528ad6b55cc63ee71952ddb2a5e5f1cb7da", size = 33238, upload-time = "2025-11-14T09:36:24.751Z" },
+]
+
 [[package]]
 name = "pyobjc-framework-cocoa"
 version = "12.1"
@@ -759,6 +781,26 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/58/27/b457b7b37089cad692c8aada90119162dfb4c4a16f513b79a8b2b022b33b/pyobjc_framework_cocoa-12.1-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:6ba1dc1bfa4da42d04e93d2363491275fb2e2be5c20790e561c8a9e09b8cf2cc", size = 388970, upload-time = "2025-11-14T09:42:53.964Z" },
 ]
 
+[[package]]
+name = "pyobjc-framework-coretext"
+version = "12.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pyobjc-core" },
+    { name = "pyobjc-framework-cocoa" },
+    { name = "pyobjc-framework-quartz" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/29/da/682c9c92a39f713bd3c56e7375fa8f1b10ad558ecb075258ab6f1cdd4a6d/pyobjc_framework_coretext-12.1.tar.gz", hash = "sha256:e0adb717738fae395dc645c9e8a10bb5f6a4277e73cba8fa2a57f3b518e71da5", size = 90124, upload-time = "2025-11-14T10:14:38.596Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/27/1c/ddecc72a672d681476c668bcedcfb8ade16383c028eac566ac7458fb91ef/pyobjc_framework_coretext-12.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:1c8315dcef6699c2953461d97117fe81402f7c29cff36d2950dacce028a362fd", size = 29987, upload-time = "2025-11-14T09:46:58.028Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/81/7b8efc41e743adfa2d74b92dec263c91bcebfb188d2a8f5eea1886a195ff/pyobjc_framework_coretext-12.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:4f6742ba5b0bb7629c345e99eff928fbfd9e9d3d667421ac1a2a43bdb7ba9833", size = 29990, upload-time = "2025-11-14T09:47:01.206Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/0f/ddf45bf0e3ba4fbdc7772de4728fd97ffc34a0b5a15e1ab1115b202fe4ae/pyobjc_framework_coretext-12.1-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:d246fa654bdbf43bae3969887d58f0b336c29b795ad55a54eb76397d0e62b93c", size = 30108, upload-time = "2025-11-14T09:47:04.228Z" },
+    { url = "https://files.pythonhosted.org/packages/20/a2/a3974e3e807c68e23a9d7db66fc38ac54f7ecd2b7a9237042006699a76e1/pyobjc_framework_coretext-12.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:7cbb2c28580e6704ce10b9a991ccd9563a22b3a75f67c36cf612544bd8b21b5f", size = 30110, upload-time = "2025-11-14T09:47:07.518Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/5d/85e059349e9cfbd57269a1f11f56747b3ff5799a3bcbd95485f363c623d8/pyobjc_framework_coretext-12.1-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:14100d1e39efb30f57869671fb6fce8d668f80c82e25e7930fb364866e5c0dab", size = 30697, upload-time = "2025-11-14T09:47:10.932Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/c3/adf9d306e9ead108167ab7a974ab7d171dbacf31c72fad63e12585f58023/pyobjc_framework_coretext-12.1-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:782a1a9617ea267c05226e9cd81a8dec529969a607fe1e037541ee1feb9524e9", size = 30095, upload-time = "2025-11-14T09:47:13.893Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/ca/6321295f47a47b0fca7de7e751ddc0ddc360413f4e506335fe9b0f0fb085/pyobjc_framework_coretext-12.1-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:7afe379c5a870fa3e66e6f65231c3c1732d9ccd2cd2a4904b2cd5178c9e3c562", size = 30702, upload-time = "2025-11-14T09:47:17.292Z" },
+]
+
 [[package]]
 name = "pyobjc-framework-quartz"
 version = "12.1"

{oagi_core-0.10.1 → oagi_core-0.10.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "oagi-core"
-version = "0.10.1"
+version = "0.10.3"
 description = "Official API of OpenAGI Foundation"
 readme = "README.md"
 license = { file = "LICENSE" }

{oagi_core-0.10.1 → oagi_core-0.10.3}/src/oagi/agent/default.py

@@ -6,9 +6,16 @@
 #  Licensed under the MIT License.
 # -----------------------------------------------------------------------------
 
+import asyncio
 import logging
 
 from .. import AsyncActor
+from ..constants import (
+    DEFAULT_MAX_STEPS,
+    DEFAULT_STEP_DELAY,
+    DEFAULT_TEMPERATURE,
+    MODEL_ACTOR,
+)
 from ..types import (
     ActionEvent,
     AsyncActionHandler,
@@ -35,10 +42,11 @@ class AsyncDefaultAgent:
         self,
         api_key: str | None = None,
         base_url: str | None = None,
-        model: str = "lux-actor-1",
-        max_steps: int = 20,
-        temperature: float | None = 0.5,
+        model: str = MODEL_ACTOR,
+        max_steps: int = DEFAULT_MAX_STEPS,
+        temperature: float | None = DEFAULT_TEMPERATURE,
         step_observer: AsyncObserver | None = None,
+        step_delay: float = DEFAULT_STEP_DELAY,
     ):
         self.api_key = api_key
         self.base_url = base_url
@@ -46,6 +54,7 @@ class AsyncDefaultAgent:
         self.max_steps = max_steps
         self.temperature = temperature
         self.step_observer = step_observer
+        self.step_delay = step_delay
 
     async def execute(
         self,
@@ -113,6 +122,10 @@ class AsyncDefaultAgent:
                             )
                         )
 
+                # Wait after actions before next screenshot
+                if self.step_delay > 0:
+                    await asyncio.sleep(self.step_delay)
+
                 # Check if task is complete
                 if step.stop:
                     logger.info(f"Task completed successfully after {step_num} steps")

{oagi_core-0.10.1 → oagi_core-0.10.3}/src/oagi/agent/factories.py

@@ -6,6 +6,16 @@
 #  Licensed under the MIT License.
 # -----------------------------------------------------------------------------
 from oagi.agent.tasker import TaskerAgent
+from oagi.constants import (
+    DEFAULT_MAX_STEPS,
+    DEFAULT_MAX_STEPS_TASKER,
+    DEFAULT_MAX_STEPS_THINKER,
+    DEFAULT_REFLECTION_INTERVAL_TASKER,
+    DEFAULT_STEP_DELAY,
+    DEFAULT_TEMPERATURE_LOW,
+    MODEL_ACTOR,
+    MODEL_THINKER,
+)
 from oagi.types import AsyncStepObserver
 
 from .default import AsyncDefaultAgent
@@ -17,10 +27,11 @@ from .registry import async_agent_register
 def create_default_agent(
     api_key: str | None = None,
     base_url: str | None = None,
-    model: str = "lux-actor-1",
-    max_steps: int = 20,
-    temperature: float = 0.1,
+    model: str = MODEL_ACTOR,
+    max_steps: int = DEFAULT_MAX_STEPS,
+    temperature: float = DEFAULT_TEMPERATURE_LOW,
     step_observer: AsyncStepObserver | None = None,
+    step_delay: float = DEFAULT_STEP_DELAY,
 ) -> AsyncAgent:
     return AsyncDefaultAgent(
         api_key=api_key,
@@ -29,6 +40,7 @@ def create_default_agent(
         max_steps=max_steps,
         temperature=temperature,
         step_observer=step_observer,
+        step_delay=step_delay,
     )
 
 
@@ -36,10 +48,11 @@ def create_default_agent(
 def create_thinker_agent(
     api_key: str | None = None,
     base_url: str | None = None,
-    model: str = "lux-thinker-1",
-    max_steps: int = 100,
-    temperature: float = 0.1,
+    model: str = MODEL_THINKER,
+    max_steps: int = DEFAULT_MAX_STEPS_THINKER,
+    temperature: float = DEFAULT_TEMPERATURE_LOW,
     step_observer: AsyncStepObserver | None = None,
+    step_delay: float = DEFAULT_STEP_DELAY,
 ) -> AsyncAgent:
     return AsyncDefaultAgent(
         api_key=api_key,
@@ -48,6 +61,7 @@ def create_thinker_agent(
         max_steps=max_steps,
         temperature=temperature,
         step_observer=step_observer,
+        step_delay=step_delay,
     )
 
 
@@ -55,11 +69,12 @@ def create_thinker_agent(
 def create_planner_agent(
     api_key: str | None = None,
     base_url: str | None = None,
-    model: str = "lux-actor-1",
-    max_steps: int = 30,
-    temperature: float = 0.1,
-    reflection_interval: int = 20,
+    model: str = MODEL_ACTOR,
+    max_steps: int = DEFAULT_MAX_STEPS_TASKER,
+    temperature: float = DEFAULT_TEMPERATURE_LOW,
+    reflection_interval: int = DEFAULT_REFLECTION_INTERVAL_TASKER,
     step_observer: AsyncStepObserver | None = None,
+    step_delay: float = DEFAULT_STEP_DELAY,
 ) -> AsyncAgent:
     tasker = TaskerAgent(
         api_key=api_key,
@@ -69,6 +84,7 @@ def create_planner_agent(
         temperature=temperature,
         reflection_interval=reflection_interval,
         step_observer=step_observer,
+        step_delay=step_delay,
     )
     # tasker.set_task()
     return tasker

oagi_core-0.10.3/src/oagi/agent/observer/exporters.py

@@ -0,0 +1,336 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+
+import base64
+import json
+from pathlib import Path
+
+from ...types import (
+    Action,
+    ActionEvent,
+    ActionType,
+    ImageEvent,
+    LogEvent,
+    ObserverEvent,
+    PlanEvent,
+    SplitEvent,
+    StepEvent,
+    parse_coords,
+    parse_drag_coords,
+    parse_scroll,
+)
+
+
+def _parse_action_coords(action: Action) -> dict | None:
+    """Parse coordinates from action argument for cursor indicators.
+
+    Returns:
+        Dict with coordinates based on action type, or None if not applicable.
+        - Click types: {"type": "click", "x": int, "y": int}
+        - Drag: {"type": "drag", "x1": int, "y1": int, "x2": int, "y2": int}
+        - Scroll: {"type": "scroll", "x": int, "y": int, "direction": str}
+    """
+    arg = action.argument.strip("()")
+
+    match action.type:
+        case (
+            ActionType.CLICK
+            | ActionType.LEFT_DOUBLE
+            | ActionType.LEFT_TRIPLE
+            | ActionType.RIGHT_SINGLE
+        ):
+            coords = parse_coords(arg)
+            if coords:
+                return {"type": "click", "x": coords[0], "y": coords[1]}
+        case ActionType.DRAG:
+            coords = parse_drag_coords(arg)
+            if coords:
+                return {
+                    "type": "drag",
+                    "x1": coords[0],
+                    "y1": coords[1],
+                    "x2": coords[2],
+                    "y2": coords[3],
+                }
+        case ActionType.SCROLL:
+            result = parse_scroll(arg)
+            if result:
+                return {
+                    "type": "scroll",
+                    "x": result[0],
+                    "y": result[1],
+                    "direction": result[2],
+                }
+    return None
+
+
+def export_to_markdown(
+    events: list[ObserverEvent],
+    path: str,
+    images_dir: str | None = None,
+) -> None:
+    """Export events to a Markdown file.
+
+    Args:
+        events: List of events to export.
+        path: Path to the output Markdown file.
+        images_dir: Directory to save images. If None, images are not saved.
+    """
+    output_path = Path(path)
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+
+    if images_dir:
+        images_path = Path(images_dir)
+        images_path.mkdir(parents=True, exist_ok=True)
+
+    lines: list[str] = ["# Agent Execution Report\n"]
+    image_counter = 0
+
+    for event in events:
+        timestamp = event.timestamp.strftime("%H:%M:%S")
+
+        match event:
+            case StepEvent():
+                lines.append(f"\n## Step {event.step_num}\n")
+                lines.append(f"**Time:** {timestamp}\n")
+
+                if isinstance(event.image, bytes):
+                    if images_dir:
+                        image_counter += 1
+                        image_filename = f"step_{event.step_num}.png"
+                        image_path = Path(images_dir) / image_filename
+                        image_path.write_bytes(event.image)
+                        rel_path = Path(images_dir).name / Path(image_filename)
+                        lines.append(f"\n![Step {event.step_num}]({rel_path})\n")
+                    else:
+                        lines.append(
+                            f"\n*[Screenshot captured - {len(event.image)} bytes]*\n"
+                        )
+                elif isinstance(event.image, str):
+                    lines.append(f"\n**Screenshot URL:** {event.image}\n")
+
+                if event.step.reason:
+                    lines.append(f"\n**Reasoning:**\n> {event.step.reason}\n")
+
+                if event.step.actions:
+                    lines.append("\n**Planned Actions:**\n")
+                    for action in event.step.actions:
+                        count_str = (
+                            f" (x{action.count})"
+                            if action.count and action.count > 1
+                            else ""
+                        )
+                        lines.append(
+                            f"- `{action.type.value}`: {action.argument}{count_str}\n"
+                        )
+
+                if event.step.stop:
+                    lines.append("\n**Status:** Task Complete\n")
+
+            case ActionEvent():
+                lines.append(f"\n### Actions Executed ({timestamp})\n")
+                if event.error:
+                    lines.append(f"\n**Error:** {event.error}\n")
+                else:
+                    lines.append("\n**Result:** Success\n")
+
+            case LogEvent():
+                lines.append(f"\n> **Log ({timestamp}):** {event.message}\n")
+
+            case SplitEvent():
+                if event.label:
+                    lines.append(f"\n---\n\n### {event.label}\n")
+                else:
+                    lines.append("\n---\n")
+
+            case ImageEvent():
+                pass
+
+            case PlanEvent():
+                phase_titles = {
+                    "initial": "Initial Planning",
+                    "reflection": "Reflection",
+                    "summary": "Summary",
+                }
+                phase_title = phase_titles.get(event.phase, event.phase.capitalize())
+                lines.append(f"\n### {phase_title} ({timestamp})\n")
+
+                if event.image:
+                    if isinstance(event.image, bytes):
+                        if images_dir:
+                            image_counter += 1
+                            image_filename = f"plan_{event.phase}_{image_counter}.png"
+                            image_path = Path(images_dir) / image_filename
+                            image_path.write_bytes(event.image)
+                            rel_path = Path(images_dir).name / Path(image_filename)
+                            lines.append(f"\n![{phase_title}]({rel_path})\n")
+                        else:
+                            lines.append(
+                                f"\n*[Screenshot captured - {len(event.image)} bytes]*\n"
+                            )
+                    elif isinstance(event.image, str):
+                        lines.append(f"\n**Screenshot URL:** {event.image}\n")
+
+                if event.reasoning:
+                    lines.append(f"\n**Reasoning:**\n> {event.reasoning}\n")
+
+                if event.result:
+                    lines.append(f"\n**Result:** {event.result}\n")
+
+    output_path.write_text("".join(lines))
+
+
+def _convert_events_for_html(events: list[ObserverEvent]) -> list[dict]:
+    """Convert events to JSON-serializable format for HTML template."""
+    result = []
+
+    for event in events:
+        timestamp = event.timestamp.strftime("%H:%M:%S")
+
+        match event:
+            case StepEvent():
+                # Collect action coordinates for cursor indicators
+                action_coords = []
+                actions_list = []
+                if event.step.actions:
+                    for action in event.step.actions:
+                        coords = _parse_action_coords(action)
+                        if coords:
+                            action_coords.append(coords)
+                        actions_list.append(
+                            {
+                                "type": action.type.value,
+                                "argument": action.argument,
+                                "count": action.count or 1,
+                            }
+                        )
+
+                # Handle image
+                image_data = None
+                if isinstance(event.image, bytes):
+                    image_data = base64.b64encode(event.image).decode("utf-8")
+                elif isinstance(event.image, str):
+                    image_data = event.image
+
+                result.append(
+                    {
+                        "event_type": "step",
+                        "timestamp": timestamp,
+                        "step_num": event.step_num,
+                        "image": image_data,
+                        "action_coords": action_coords,
+                        "reason": event.step.reason,
+                        "actions": actions_list,
+                        "stop": event.step.stop,
+                    }
+                )
+
+            case ActionEvent():
+                result.append(
+                    {
+                        "event_type": "action",
+                        "timestamp": timestamp,
+                        "error": event.error,
+                    }
+                )
+
+            case LogEvent():
+                result.append(
+                    {
+                        "event_type": "log",
+                        "timestamp": timestamp,
+                        "message": event.message,
+                    }
+                )
+
+            case SplitEvent():
+                result.append(
+                    {
+                        "event_type": "split",
+                        "timestamp": timestamp,
+                        "label": event.label,
+                    }
+                )
+
+            case ImageEvent():
+                pass
+
+            case PlanEvent():
+                image_data = None
+                if isinstance(event.image, bytes):
+                    image_data = base64.b64encode(event.image).decode("utf-8")
+                elif isinstance(event.image, str):
+                    image_data = event.image
+
+                result.append(
+                    {
+                        "event_type": "plan",
+                        "timestamp": timestamp,
+                        "phase": event.phase,
+                        "image": image_data,
+                        "reasoning": event.reasoning,
+                        "result": event.result,
+                    }
+                )
+
+    return result
+
+
+def export_to_html(events: list[ObserverEvent], path: str) -> None:
+    """Export events to a self-contained HTML file.
+
+    Args:
+        events: List of events to export.
+        path: Path to the output HTML file.
+    """
+    output_path = Path(path)
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Load template
+    template_path = Path(__file__).parent / "report_template.html"
+    template = template_path.read_text()
+
+    # Convert events to JSON
+    events_data = _convert_events_for_html(events)
+    events_json = json.dumps(events_data)
+
+    # Replace placeholder
+    html_content = template.replace("{EVENTS_DATA}", events_json)
+
+    output_path.write_text(html_content)
+
+
+def export_to_json(events: list[ObserverEvent], path: str) -> None:
+    """Export events to a JSON file.
+
+    Args:
+        events: List of events to export.
+        path: Path to the output JSON file.
+    """
+    output_path = Path(path)
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Convert events to JSON-serializable format
+    json_events = []
+    for event in events:
+        # Handle bytes images before model_dump to avoid UTF-8 decode error
+        if isinstance(event, (StepEvent, ImageEvent, PlanEvent)) and isinstance(
+            getattr(event, "image", None), bytes
+        ):
+            # Dump without json mode first, then handle bytes manually
+            event_dict = event.model_dump()
+            event_dict["image"] = base64.b64encode(event.image).decode("utf-8")
+            event_dict["image_encoding"] = "base64"
+            # Convert datetime to string
+            if "timestamp" in event_dict:
+                event_dict["timestamp"] = event_dict["timestamp"].isoformat()
+        else:
+            event_dict = event.model_dump(mode="json")
+        json_events.append(event_dict)
+
+    output_path.write_text(json.dumps(json_events, indent=2, default=str))