chore(api): improve descriptions (#341)

Author: stainless-app[bot]

src/finch/types/introspection.py

@@ -39,9 +39,8 @@ class Introspection(BaseModel):
     connection_type: Literal["provider", "finch"]
     """The type of the connection associated with the token.
 
-    `provider` - connection to an external provider
-
-    `finch` - finch-generated data.
+    - `provider` - connection to an external provider
+    - `finch` - finch-generated data.
     """
 
     manual: bool

src/finch/types/shared/operation_support_matrix.py

@@ -10,53 +10,45 @@
 
 class OperationSupportMatrix(BaseModel):
     create: Optional[OperationSupport] = None
-    """- `supported`: This operation is supported by both the provider and Finch
-
+    """
+    - `supported`: This operation is supported by both the provider and Finch
     - `not_supported_by_finch`: This operation is not supported by Finch but
       supported by the provider
-
     - `not_supported_by_provider`: This operation is not supported by the provider,
       so Finch cannot support
-
     - `client_access_only`: This behavior is supported by the provider, but only
       available to the client and not to Finch
     """
 
     delete: Optional[OperationSupport] = None
-    """- `supported`: This operation is supported by both the provider and Finch
-
+    """
+    - `supported`: This operation is supported by both the provider and Finch
     - `not_supported_by_finch`: This operation is not supported by Finch but
       supported by the provider
-
     - `not_supported_by_provider`: This operation is not supported by the provider,
       so Finch cannot support
-
     - `client_access_only`: This behavior is supported by the provider, but only
       available to the client and not to Finch
     """
 
     read: Optional[OperationSupport] = None
-    """- `supported`: This operation is supported by both the provider and Finch
-
+    """
+    - `supported`: This operation is supported by both the provider and Finch
     - `not_supported_by_finch`: This operation is not supported by Finch but
       supported by the provider
-
     - `not_supported_by_provider`: This operation is not supported by the provider,
       so Finch cannot support
-
     - `client_access_only`: This behavior is supported by the provider, but only
       available to the client and not to Finch
     """
 
     update: Optional[OperationSupport] = None
-    """- `supported`: This operation is supported by both the provider and Finch
-
+    """
+    - `supported`: This operation is supported by both the provider and Finch
     - `not_supported_by_finch`: This operation is not supported by Finch but
       supported by the provider
-
     - `not_supported_by_provider`: This operation is not supported by the provider,
       so Finch cannot support
-
     - `client_access_only`: This behavior is supported by the provider, but only
       available to the client and not to Finch
     """