Flatten API reference into single file using pydoc-markdown

- Replace custom AST-based generator with pydoc-markdown library
- Generate single sdk/api/index.mdx with all API documentation (7214 lines)
- Remove 11 separate module MDX files (agent, conversation, llm, etc.)
- Update docs.json to reference only sdk/api/index
- Install pydoc-markdown in workflow for doc generation
- Uses pydoc-markdown's native markdown output with Mintlify frontmatter
- No external dependencies needed at runtime (pydoc-markdown installed in CI)

Author: openhands-agent

.github/scripts/generate_api_docs.py

@@ -55,6 +55,10 @@ jobs:
         with:
           python-version: '3.11'
 
+      - name: Install pydoc-markdown
+        run: |
+          pip install pydoc-markdown
+
       - name: Generate API documentation
         env:
           AGENT_SDK_PATH: ${{ github.workspace }}/agent-sdk

.github/workflows/sync-api-reference.yml

@@ -265,18 +265,7 @@
           {
             "group": "API Reference",
             "pages": [
-              "sdk/api/index",
-              "sdk/api/agent",
-              "sdk/api/conversation",
-              "sdk/api/llm",
-              "sdk/api/tool",
-              "sdk/api/workspace",
-              "sdk/api/mcp",
-              "sdk/api/event",
-              "sdk/api/context",
-              "sdk/api/security",
-              "sdk/api/io",
-              "sdk/api/git"
+              "sdk/api/index"
             ]
           }
         ]
@@ -447,4 +436,4 @@
       "destination": "/openhands/usage/troubleshooting/feedback"
     }
   ]
-}
+}