docs: sync code blocks and generate API reference (#147)

Synced from agent-sdk ref: main

Co-authored-by: xingyaoww <38853559+xingyaoww@users.noreply.github.com>

Author: github-actions[bot]

docs.json

@@ -511,4 +511,4 @@
       "destination": "/overview/skills/public"
     }
   ]
-}
+}

sdk/guides/agent-server/docker-sandbox.mdx

@@ -272,9 +272,8 @@ llm = LLM(
     api_key=SecretStr(api_key),
 )
 
-# Create a Docker-based remote workspace with extra ports for VSCode access
-
 
+# Create a Docker-based remote workspace with extra ports for VSCode access
 def detect_platform():
     """Detects the correct Docker platform string."""
     import platform
@@ -347,7 +346,7 @@ with DockerWorkspace(
     while y != "y":
         y = input(
             "\n"
-            "Because you've enabled extra_ports=True in DockerWorkspace, "
+            "Because you've enabled extra_ports=True in DockerDevWorkspace, "
             "you can open VSCode Web to see the workspace.\n\n"
             f"VSCode URL: {vscode_url}\n\n"
             "The VSCode should have the OpenHands settings extension installed:\n"
@@ -475,6 +474,12 @@ def detect_platform():
 # Create a Docker-based remote workspace with extra ports for browser access.
 # Use `DockerWorkspace` with a pre-built image or `DockerDevWorkspace` to
 # automatically build the image on-demand.
+#    with DockerDevWorkspace(
+#        # dynamically build agent-server image
+#        base_image="nikolaik/python-nodejs:python3.12-nodejs22",
+#        host_port=8010,
+#        platform=detect_platform(),
+#    ) as workspace:
 with DockerWorkspace(
     server_image="ghcr.io/openhands/agent-server:latest-python",
     host_port=8011,
@@ -528,7 +533,7 @@ with DockerWorkspace(
         y = None
         while y != "y":
             y = input(
-                "Because you've enabled extra_ports=True in DockerWorkspace, "
+                "Because you've enabled extra_ports=True in DockerDevWorkspace, "
                 "you can open a browser tab to see the *actual* browser OpenHands "
                 "is interacting with via VNC.\n\n"
                 "Link: http://localhost:8012/vnc.html?autoconnect=1&resize=remote\n\n"

sdk/guides/agent-tom-agent.mdx

@@ -145,6 +145,10 @@ print("=" * 80)
 # conversation.send_message("Please index this conversation using sleeptime_compute")
 # conversation.run()
 # print("\nConversation indexed for user modeling!")
+
+# Report cost
+cost = llm.metrics.accumulated_cost
+print(f"EXAMPLE_COST: {cost}")
 ```
 
 ```bash Running the Example