reorganize structure + add relevant base api types

Author: sid-rl

docs/api/index.rst

@@ -9,7 +9,7 @@ and asynchronous variants to match your runtime requirements.
    :maxdepth: 2
    :caption: Contents:
 
-   api/index
+   sdk/index
 
 Installation
 ------------
@@ -42,6 +42,7 @@ Asynchronous Example
 
 .. code-block:: python
 
+   import asyncio
    from runloop_api_client import AsyncRunloopSDK
 
    async def main():
@@ -51,7 +52,6 @@ Asynchronous Example
            result = await devbox.cmd.exec(command="echo 'Hello from Runloop!'")
            print(await result.stdout())
 
-   import asyncio
    asyncio.run(main())
 
 Indices and tables

docs/index.rst

@@ -0,0 +1,106 @@
+SDK Reference
+=============
+
+This section contains detailed documentation for the Runloop SDK.
+
+.. toctree::
+   :maxdepth: 2
+
+   types
+
+Synchronous SDK
+---------------
+
+Core Module
+~~~~~~~~~~~
+
+The core synchronous SDK module provides the main entry point and operation classes.
+
+.. automodule:: runloop_api_client.sdk.sync
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Resource Modules
+~~~~~~~~~~~~~~~~
+
+Synchronous resource classes for working with devboxes, blueprints, snapshots, and more.
+
+.. automodule:: runloop_api_client.sdk.devbox
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: runloop_api_client.sdk.blueprint
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: runloop_api_client.sdk.snapshot
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: runloop_api_client.sdk.storage_object
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: runloop_api_client.sdk.execution
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: runloop_api_client.sdk.execution_result
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Asynchronous SDK
+----------------
+
+Core Module
+~~~~~~~~~~~
+
+The core asynchronous SDK module provides async operation classes.
+
+.. automodule:: runloop_api_client.sdk.async_
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Resource Modules
+~~~~~~~~~~~~~~~~
+
+Asynchronous resource classes for working with devboxes, blueprints, snapshots, and more.
+
+.. automodule:: runloop_api_client.sdk.async_devbox
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: runloop_api_client.sdk.async_blueprint
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: runloop_api_client.sdk.async_snapshot
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: runloop_api_client.sdk.async_storage_object
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: runloop_api_client.sdk.async_execution
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: runloop_api_client.sdk.async_execution_result
+   :members:
+   :undoc-members:
+   :show-inheritance:
+

docs/sdk/index.rst

@@ -1,17 +1,12 @@
-TypedDict Reference
-===================
+Type Reference
+==============
 
-This page documents all TypedDict parameter types used throughout the SDK.
-These typed dictionaries define the structure of parameters passed to SDK methods.
-
-SDK TypedDicts
---------------
-
-These are the primary TypedDict classes used in SDK methods, combining multiple
-parameter types and options.
+This page documents all TypeDict parameter types used throughout the SDK.
 
 Core Request Options
-~~~~~~~~~~~~~~~~~~~~
+--------------------
+
+These TypeDicts define options for streaming, timeouts, polling, and other request configuration.
 
 .. autotypeddict:: runloop_api_client.sdk._types.ExecuteStreamingCallbacks
 
@@ -24,16 +19,27 @@ Core Request Options
 .. autotypeddict:: runloop_api_client.sdk._types.LongPollingRequestOptions
 
 Devbox Parameters
-~~~~~~~~~~~~~~~~~
+-----------------
+
+These TypeDicts define parameters for devbox creation, execution, file operations, network tunnels, and snapshots.
+
+Creation Parameters
+~~~~~~~~~~~~~~~~~~~
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxCreateParams
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxExtraCreateParams
 
+Execution Parameters
+~~~~~~~~~~~~~~~~~~~~
+
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxExecuteParams
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxExecuteAsyncParams
 
+Listing Parameters
+~~~~~~~~~~~~~~~~~~
+
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxListParams
 
 File Operation Parameters
@@ -47,8 +53,8 @@ File Operation Parameters
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxUploadFileParams
 
-Network Operation Parameters
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Network Tunnel Parameters
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxCreateTunnelParams
 
@@ -66,14 +72,18 @@ Snapshot Parameters
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDiskSnapshotUpdateParams
 
 Blueprint Parameters
-~~~~~~~~~~~~~~~~~~~~
+--------------------
+
+These TypeDicts define parameters for blueprint creation and listing.
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKBlueprintCreateParams
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKBlueprintListParams
 
 Storage Object Parameters
-~~~~~~~~~~~~~~~~~~~~~~~~~
+-------------------------
+
+These TypeDicts define parameters for storage object creation, listing, and downloading.
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKObjectCreateParams